From f2a664953c353527a7e13ab871aafb7e6316a1d3 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Wed, 26 Jan 2022 21:33:27 -0800
Subject: [PATCH 001/743] Assume IPv6 is public address

* Fixes #1629
---
 plexpy/helpers.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/plexpy/helpers.py b/plexpy/helpers.py
index cd4bf921..6cd28a36 100644
--- a/plexpy/helpers.py
+++ b/plexpy/helpers.py
@@ -705,7 +705,7 @@ def sanitize(obj):
 
 def is_public_ip(host):
     ip = is_valid_ip(get_ip(host))
-    if ip and ip.iptype() == 'PUBLIC':
+    if ip and (ip.iptype() == 'PUBLIC' or ip.version() == 6):
         return True
     return False
 

From 2145f1e2728c20b31cb3587e2ae810f86ab389bc Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Wed, 26 Jan 2022 22:26:25 -0800
Subject: [PATCH 002/743] Check for local IPv6 addresses

---
 plexpy/helpers.py | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/plexpy/helpers.py b/plexpy/helpers.py
index 6cd28a36..fb4afb80 100644
--- a/plexpy/helpers.py
+++ b/plexpy/helpers.py
@@ -705,7 +705,11 @@ def sanitize(obj):
 
 def is_public_ip(host):
     ip = is_valid_ip(get_ip(host))
-    if ip and (ip.iptype() == 'PUBLIC' or ip.version() == 6):
+    ip_version = ip.version()
+    ip_type = ip.iptype()
+    if ip and ip_type != 'LOOPBACK' and (
+            ip_version == 4 and ip_type == 'PUBLIC' or
+            ip_version == 6 and 'LOCAL' not in ip_type):
         return True
     return False
 

From 96025c839d7b67d831cca15f0bb2dfc0ca6aa0e3 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 27 Jan 2022 10:52:07 -0800
Subject: [PATCH 003/743] Separate out plex.direct IP address log filter

---
 plexpy/logger.py | 23 ++++++++++++++++++++---
 1 file changed, 20 insertions(+), 3 deletions(-)

diff --git a/plexpy/logger.py b/plexpy/logger.py
index e09ad52d..53f18662 100644
--- a/plexpy/logger.py
+++ b/plexpy/logger.py
@@ -191,15 +191,31 @@ class PublicIPFilter(RegexFilter):
     Log filter for public IP addresses
     """
     REGEX = re.compile(
-        r'(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)[.-]){3}'
+        r'(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)[.]){3}'
         r'(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)'
         r'(?!\d*-[a-z0-9]{6})'
     )
 
+    def replace(self, text, ip):
+        if helpers.is_public_ip(ip):
+            return text.replace(ip, '.'.join(['***'] * 4))
+        return text
+
+
+class PlexDirectIPFilter(RegexFilter):
+    """
+    Log filter for IP addresses in plex.direct URL
+    """
+    REGEX = re.compile(
+        r'(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)[-]){3}'
+        r'(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)'
+        r'(?!\d*-[a-z0-9]{6})'
+        r'(?=\.[a-z0-9]+\.plex\.direct)'
+    )
+
     def replace(self, text, ip):
         if helpers.is_public_ip(ip.replace('-', '.')):
-            partition = '-' if '-' in ip else '.'
-            return text.replace(ip, partition.join(['***'] * 4))
+            return text.replace(ip, '-'.join(['***'] * 4))
         return text
 
 
@@ -321,6 +337,7 @@ def initLogger(console=False, log_dir=False, verbose=False):
             handler.addFilter(UsernameFilter())
             handler.addFilter(BlacklistFilter())
             handler.addFilter(PublicIPFilter())
+            handler.addFilter(PlexDirectIPFilter())
             handler.addFilter(EmailFilter())
             handler.addFilter(PlexTokenFilter())
 

From b9f04ac71ae8a67e1fc37534cc8d1cf85d8af38b Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 30 Jan 2022 16:50:23 -0800
Subject: [PATCH 004/743] Default Telegram to MarkdownV2 when HTML disabled

---
 plexpy/notifiers.py | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/plexpy/notifiers.py b/plexpy/notifiers.py
index aaf74ddf..cff735cf 100644
--- a/plexpy/notifiers.py
+++ b/plexpy/notifiers.py
@@ -3869,7 +3869,7 @@ class TELEGRAM(Notifier):
                        'chat_id': '',
                        'disable_web_preview': 0,
                        'silent_notification': 0,
-                       'html_support': 1,
+                       'html_support': 0,
                        'incl_subject': 1,
                        'incl_poster': 0
                        }
@@ -3884,6 +3884,8 @@ class TELEGRAM(Notifier):
 
         if self.config['html_support']:
             data['parse_mode'] = 'HTML'
+        else:
+            data['parse_mode'] = 'MarkdownV2'
 
         if self.config['incl_poster'] and kwargs.get('parameters'):
             # Grab formatted metadata
@@ -3963,7 +3965,7 @@ class TELEGRAM(Notifier):
                          {'label': 'Enable HTML Support',
                           'value': self.config['html_support'],
                           'name': 'telegram_html_support',
-                          'description': 'Style your messages using these HTML tags: b, i, a[href], code, pre.',
+                          'description': 'Enable to style your messages using HTML. Disable to use Markdown instead.',
                           'input_type': 'checkbox'
                           },
                          {'label': 'Disable Web Page Previews',

From fe388e903d05e9d8aeee4db6d6b9b2ac99f2cf55 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 30 Jan 2022 17:26:08 -0800
Subject: [PATCH 005/743] Fix export download not including images

---
 plexpy/exporter.py | 13 ++++++-------
 1 file changed, 6 insertions(+), 7 deletions(-)

diff --git a/plexpy/exporter.py b/plexpy/exporter.py
index 1feb8a04..196b15f0 100644
--- a/plexpy/exporter.py
+++ b/plexpy/exporter.py
@@ -1928,14 +1928,13 @@ class Export(object):
         self.file_size += os.path.getsize(filepath)
 
     def _exported_images(self, title):
-        images_dirpath = get_export_dirpath(self.directory, images_directory=title)
+        dirpath = get_export_dirpath(self.directory)
 
-        if os.path.exists(images_dirpath):
-            for f in os.listdir(images_dirpath):
-                if f.endswith('.thumb.jpg'):
-                    self.exported_thumb = True
-                elif f.endswith('.art.jpg'):
-                    self.exported_art = True
+        for root, dirs, files in os.walk(dirpath):
+            if any(f.endswith('.thumb.jpg') for f in files):
+                self.exported_thumb = True
+            elif any(f.endswith('.art.jpg') for f in files):
+                self.exported_art = True
 
     def _media_type(self, obj):
         return 'photoalbum' if self.is_photoalbum(obj) else obj.type

From 636d2fe43e370667afa47793067180d50dc699a8 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 31 Jan 2022 15:04:41 -0800
Subject: [PATCH 006/743] Add disc number notification parameter

---
 plexpy/common.py               | 2 ++
 plexpy/notification_handler.py | 7 +++++++
 2 files changed, 9 insertions(+)

diff --git a/plexpy/common.py b/plexpy/common.py
index 4d59f713..1312d98f 100644
--- a/plexpy/common.py
+++ b/plexpy/common.py
@@ -502,6 +502,8 @@ NOTIFICATION_PARAMETERS = [
              {'name': 'Season Number 00', 'type': 'int', 'value': 'season_num00', 'description': 'The two digit season number.', 'example': 'e.g. 01, or 01-03'},
              {'name': 'Episode Number', 'type': 'int', 'value': 'episode_num', 'description': 'The episode number.', 'example': 'e.g. 6, or 6-10'},
              {'name': 'Episode Number 00', 'type': 'int', 'value': 'episode_num00', 'description': 'The two digit episode number.', 'example': 'e.g. 06, or 06-10'},
+             {'name': 'Disc Number', 'type': 'int', 'value': 'disc_num', 'description': 'The disc number.', 'example': 'e.g. 2'},
+             {'name': 'Disc Number 00', 'type': 'int', 'value': 'disc_num00', 'description': 'The two digit disc number.', 'example': 'e.g. 02'},
              {'name': 'Track Number', 'type': 'int', 'value': 'track_num', 'description': 'The track number.', 'example': 'e.g. 4, or 4-10'},
              {'name': 'Track Number 00', 'type': 'int', 'value': 'track_num00', 'description': 'The two digit track number.', 'example': 'e.g. 04, or 04-10'},
              {'name': 'Season Count', 'type': 'int', 'value': 'season_count', 'description': 'The number of seasons in a grouped recently added notification.'},
diff --git a/plexpy/notification_handler.py b/plexpy/notification_handler.py
index adf3d103..9a662e2c 100644
--- a/plexpy/notification_handler.py
+++ b/plexpy/notification_handler.py
@@ -841,6 +841,7 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
         season_num, season_num00 = num, num00
 
         episode_num, episode_num00 = '', ''
+        disc_num, disc_num00 = '', ''
         track_num, track_num00 = '', ''
 
         child_count = len(child_num)
@@ -864,6 +865,8 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
         episode_num, episode_num00 = num, num00
         track_num, track_num00 = num, num00
 
+        disc_num, disc_num00 = '', ''
+
         child_count = 1
         grandchild_count = len(grandchild_num)
 
@@ -878,6 +881,8 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
         season_num00 = str(notify_params['parent_media_index']).zfill(2)
         episode_num = str(notify_params['media_index']).zfill(1)
         episode_num00 = str(notify_params['media_index']).zfill(2)
+        disc_num = str(notify_params['parent_media_index']).zfill(1)
+        disc_num00 = str(notify_params['parent_media_index']).zfill(2)
         track_num = str(notify_params['media_index']).zfill(1)
         track_num00 = str(notify_params['media_index']).zfill(2)
         child_count = 1
@@ -1046,6 +1051,8 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
         'season_num00': season_num00,
         'episode_num': episode_num,
         'episode_num00': episode_num00,
+        'disc_num': disc_num,
+        'disc_num00': disc_num00,
         'track_num': track_num,
         'track_num00': track_num00,
         'season_count': child_count,

From e33767de9b527e365125cb695a3a018b031e4e5a Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 1 Feb 2022 22:06:53 -0800
Subject: [PATCH 007/743] Fix updating section_id when updating metadata

---
 plexpy/datafactory.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/plexpy/datafactory.py b/plexpy/datafactory.py
index daf57c56..3b337f75 100644
--- a/plexpy/datafactory.py
+++ b/plexpy/datafactory.py
@@ -1910,7 +1910,7 @@ class DataFactory(object):
             monitor_db = database.MonitorDatabase()
 
             query = 'UPDATE session_history SET section_id = ? WHERE rating_key = ?'
-            args = [metadata['section_id'], old_rating_key]
+            args = [metadata['section_id'], new_rating_key]
             monitor_db.action(query=query, args=args)
 
             # Update the session_history_metadata table

From cba746920aa7c16193daeb4bfc2cc44680bc7bce Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 3 Feb 2022 12:22:14 -0800
Subject: [PATCH 008/743] Add Telegram channel ID to config label and
 description

---
 plexpy/notifiers.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/plexpy/notifiers.py b/plexpy/notifiers.py
index cff735cf..5eae6b55 100644
--- a/plexpy/notifiers.py
+++ b/plexpy/notifiers.py
@@ -3941,10 +3941,10 @@ class TELEGRAM(Notifier):
                                          ' on Telegram to get one.',
                           'input_type': 'token'
                           },
-                         {'label': 'Telegram Chat ID, Group ID, or Channel Username',
+                         {'label': 'Telegram Chat ID, Group ID, or Channel ID/Username',
                           'value': self.config['chat_id'],
                           'name': 'telegram_chat_id',
-                          'description': 'Your Telegram Chat ID, Group ID, or @channelusername. '
+                          'description': 'Your Telegram Chat ID, Group ID, Channel ID or @channelusername. '
                                          'Contact <a href="' + helpers.anon_url('https://telegram.me/myidbot') +
                                          '" target="_blank">@myidbot</a>'
                                          ' on Telegram to get an ID.',

From c3d09d34f828679c4d937aed074e9db1c7085548 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 6 Feb 2022 23:18:53 -0800
Subject: [PATCH 009/743] Prevent rating_key collisions when updating metadata

---
 data/interfaces/default/update_metadata.html |   5 +-
 plexpy/datafactory.py                        | 132 ++++++++++++++++---
 plexpy/webserve.py                           |   7 +-
 3 files changed, 120 insertions(+), 24 deletions(-)

diff --git a/data/interfaces/default/update_metadata.html b/data/interfaces/default/update_metadata.html
index fe962e1b..59b35fd0 100644
--- a/data/interfaces/default/update_metadata.html
+++ b/data/interfaces/default/update_metadata.html
@@ -233,8 +233,9 @@ DOCUMENTATION :: END
                 data: {
                     old_rating_key: '${query["rating_key"]}',
                     new_rating_key: new_rating_key,
-                    media_type: '${query["media_type"]}'
-                    },
+                    media_type: '${query["media_type"]}',
+                    single_update: true
+                },
                 async: true,
                 success: function (data) {
                     window.location.href = new_href;
diff --git a/plexpy/datafactory.py b/plexpy/datafactory.py
index 3b337f75..7d906b9d 100644
--- a/plexpy/datafactory.py
+++ b/plexpy/datafactory.py
@@ -44,6 +44,13 @@ else:
     from plexpy import pmsconnect
     from plexpy import session
 
+# Temporarily store update_metadata row ids in memory to prevent rating_key collisions
+_UPDATE_METADATA_IDS = {
+    'grandparent_rating_key_ids': set(),
+    'parent_rating_key_ids': set(),
+    'rating_key_ids': set()
+}
+
 
 class DataFactory(object):
     """
@@ -1831,7 +1838,7 @@ class DataFactory(object):
 
         return key_list
 
-    def update_metadata(self, old_key_list='', new_key_list='', media_type=''):
+    def update_metadata(self, old_key_list='', new_key_list='', media_type='', single_update=False):
         pms_connect = pmsconnect.PmsConnect()
         monitor_db = database.MonitorDatabase()
 
@@ -1853,6 +1860,15 @@ class DataFactory(object):
 
         if mapping:
             logger.info("Tautulli DataFactory :: Updating metadata in the database.")
+
+            global _UPDATE_METADATA_IDS
+            if single_update:
+                _UPDATE_METADATA_IDS = {
+                    'grandparent_rating_key_ids': set(),
+                    'parent_rating_key_ids': set(),
+                    'rating_key_ids': set()
+                }
+
             for old_key, new_key in mapping.items():
                 metadata = pms_connect.get_metadata_details(new_key)
 
@@ -1862,31 +1878,107 @@ class DataFactory(object):
 
                     if metadata['media_type'] == 'show' or metadata['media_type'] == 'artist':
                         # check grandparent_rating_key (2 tables)
-                        monitor_db.action('UPDATE session_history SET grandparent_rating_key = ? WHERE grandparent_rating_key = ?',
-                                          [new_key, old_key])
-                        monitor_db.action('UPDATE session_history_metadata SET grandparent_rating_key = ? WHERE grandparent_rating_key = ?',
-                                          [new_key, old_key])
+                        query = (
+                            'SELECT id FROM session_history '
+                            'WHERE grandparent_rating_key = ? '
+                        )
+                        args = [old_key]
+
+                        if _UPDATE_METADATA_IDS['grandparent_rating_key_ids']:
+                            query += (
+                                'AND id NOT IN (%s)' % ','.join(_UPDATE_METADATA_IDS['grandparent_rating_key_ids'])
+                            )
+
+                        ids = [str(row['id']) for row in monitor_db.select(query, args)]
+                        if ids:
+                            _UPDATE_METADATA_IDS['grandparent_rating_key_ids'].update(ids)
+                        else:
+                            continue
+
+                        monitor_db.action(
+                            'UPDATE session_history SET grandparent_rating_key = ? '
+                            'WHERE id IN (%s)' % ','.join(ids),
+                            [new_key]
+                        )
+                        monitor_db.action(
+                            'UPDATE session_history_metadata SET grandparent_rating_key = ? '
+                            'WHERE id IN (%s)' % ','.join(ids),
+                            [new_key]
+                        )
+
                     elif metadata['media_type'] == 'season' or metadata['media_type'] == 'album':
                         # check parent_rating_key (2 tables)
-                        monitor_db.action('UPDATE session_history SET parent_rating_key = ? WHERE parent_rating_key = ?',
-                                          [new_key, old_key])
-                        monitor_db.action('UPDATE session_history_metadata SET parent_rating_key = ? WHERE parent_rating_key = ?',
-                                          [new_key, old_key])
+                        query = (
+                            'SELECT id FROM session_history '
+                            'WHERE parent_rating_key = ? '
+                        )
+                        args = [old_key]
+
+                        if _UPDATE_METADATA_IDS['parent_rating_key_ids']:
+                            query += (
+                                'AND id NOT IN (%s)' % ','.join(_UPDATE_METADATA_IDS['parent_rating_key_ids'])
+                            )
+
+                        ids = [str(row['id']) for row in monitor_db.select(query, args)]
+                        if ids:
+                            _UPDATE_METADATA_IDS['parent_rating_key_ids'].update(ids)
+                        else:
+                            continue
+
+                        monitor_db.action(
+                            'UPDATE session_history SET parent_rating_key = ? '
+                            'WHERE id IN (%s)' % ','.join(ids),
+                            [new_key]
+                        )
+                        monitor_db.action(
+                            'UPDATE session_history_metadata SET parent_rating_key = ? '
+                            'WHERE id IN (%s)' % ','.join(ids),
+                            [new_key]
+                        )
+
                     else:
                         # check rating_key (2 tables)
-                        monitor_db.action('UPDATE session_history SET rating_key = ? WHERE rating_key = ?',
-                                          [new_key, old_key])
-                        monitor_db.action('UPDATE session_history_media_info SET rating_key = ? WHERE rating_key = ?',
-                                          [new_key, old_key])
+                        query = (
+                            'SELECT id FROM session_history '
+                            'WHERE rating_key = ? '
+                        )
+                        args = [old_key]
+
+                        if _UPDATE_METADATA_IDS['rating_key_ids']:
+                            query += (
+                                'AND id NOT IN (%s)' % ','.join(_UPDATE_METADATA_IDS['rating_key_ids'])
+                            )
+
+                        ids = [str(row['id']) for row in monitor_db.select(query, args)]
+                        if ids:
+                            _UPDATE_METADATA_IDS['rating_key_ids'].update(ids)
+                        else:
+                            continue
+
+                        monitor_db.action(
+                            'UPDATE session_history SET rating_key = ? '
+                            'WHERE id IN (%s)' % ','.join(ids),
+                            [new_key]
+                        )
+                        monitor_db.action(
+                            'UPDATE session_history_media_info SET rating_key = ? '
+                            'WHERE id IN (%s)' % ','.join(ids),
+                            [new_key]
+                        )
+                        monitor_db.action(
+                            'INSERT INTO update_metadata (rating_key_id) '
+                            'VALUES %s' % ','.join(['(?)'] * len(ids)),
+                            ids
+                        )
 
                         # update session_history_metadata table
-                        self.update_metadata_details(old_key, new_key, metadata)
+                        self.update_metadata_details(old_key, new_key, metadata, ids)
 
             return 'Updated metadata in database.'
         else:
             return 'Unable to update metadata in database. No changes were made.'
 
-    def update_metadata_details(self, old_rating_key='', new_rating_key='', metadata=None):
+    def update_metadata_details(self, old_rating_key='', new_rating_key='', metadata=None, ids=None):
 
         if metadata:
             # Create full_title
@@ -1909,8 +2001,9 @@ class DataFactory(object):
 
             monitor_db = database.MonitorDatabase()
 
-            query = 'UPDATE session_history SET section_id = ? WHERE rating_key = ?'
-            args = [metadata['section_id'], new_rating_key]
+            query = 'UPDATE session_history SET section_id = ? ' \
+                    'WHERE id IN (%s)' % ','.join(ids)
+            args = [metadata['section_id']]
             monitor_db.action(query=query, args=args)
 
             # Update the session_history_metadata table
@@ -1922,7 +2015,7 @@ class DataFactory(object):
                     'added_at = ?, updated_at = ?, last_viewed_at = ?, content_rating = ?, summary = ?, ' \
                     'tagline = ?, rating = ?, duration = ?, guid = ?, directors = ?, writers = ?, actors = ?, ' \
                     'genres = ?, studio = ?, labels = ? ' \
-                    'WHERE rating_key = ?'
+                    'WHERE id IN (%s)' % ','.join(ids)
 
             args = [metadata['rating_key'], metadata['parent_rating_key'], metadata['grandparent_rating_key'],
                     metadata['title'], metadata['parent_title'], metadata['grandparent_title'],
@@ -1932,8 +2025,7 @@ class DataFactory(object):
                     metadata['year'], metadata['originally_available_at'], metadata['added_at'], metadata['updated_at'],
                     metadata['last_viewed_at'], metadata['content_rating'], metadata['summary'], metadata['tagline'],
                     metadata['rating'], metadata['duration'], metadata['guid'], directors, writers, actors, genres,
-                    metadata['studio'], labels,
-                    old_rating_key]
+                    metadata['studio'], labels]
 
             monitor_db.action(query=query, args=args)
 
diff --git a/plexpy/webserve.py b/plexpy/webserve.py
index 7a30cfb4..dd6e66a4 100644
--- a/plexpy/webserve.py
+++ b/plexpy/webserve.py
@@ -5145,7 +5145,7 @@ class WebInterface(object):
     @cherrypy.tools.json_out()
     @requireAuth(member_of("admin"))
     @addtoapi()
-    def update_metadata_details(self, old_rating_key, new_rating_key, media_type, **kwargs):
+    def update_metadata_details(self, old_rating_key, new_rating_key, media_type, single_update=False, **kwargs):
         """ Update the metadata in the Tautulli database by matching rating keys.
             Also updates all parents or children of the media item if it is a show/season/episode
             or artist/album/track.
@@ -5163,6 +5163,8 @@ class WebInterface(object):
                 None
             ```
         """
+        single_update = helpers.bool_true(single_update)
+
         if new_rating_key:
             data_factory = datafactory.DataFactory()
             pms_connect = pmsconnect.PmsConnect()
@@ -5172,7 +5174,8 @@ class WebInterface(object):
 
             result = data_factory.update_metadata(old_key_list=old_key_list,
                                                   new_key_list=new_key_list,
-                                                  media_type=media_type)
+                                                  media_type=media_type,
+                                                  single_update=single_update)
 
         if result:
             return {'message': result}

From 8e6f8d7735271d48995674b6b7ed0fb8f0b53957 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 7 Feb 2022 09:12:07 -0800
Subject: [PATCH 010/743] Remove unnecessary insert statement

---
 plexpy/datafactory.py | 17 +++--------------
 1 file changed, 3 insertions(+), 14 deletions(-)

diff --git a/plexpy/datafactory.py b/plexpy/datafactory.py
index 7d906b9d..82b8a193 100644
--- a/plexpy/datafactory.py
+++ b/plexpy/datafactory.py
@@ -1885,9 +1885,7 @@ class DataFactory(object):
                         args = [old_key]
 
                         if _UPDATE_METADATA_IDS['grandparent_rating_key_ids']:
-                            query += (
-                                'AND id NOT IN (%s)' % ','.join(_UPDATE_METADATA_IDS['grandparent_rating_key_ids'])
-                            )
+                            query += 'AND id NOT IN (%s)' % ','.join(_UPDATE_METADATA_IDS['grandparent_rating_key_ids'])
 
                         ids = [str(row['id']) for row in monitor_db.select(query, args)]
                         if ids:
@@ -1915,9 +1913,7 @@ class DataFactory(object):
                         args = [old_key]
 
                         if _UPDATE_METADATA_IDS['parent_rating_key_ids']:
-                            query += (
-                                'AND id NOT IN (%s)' % ','.join(_UPDATE_METADATA_IDS['parent_rating_key_ids'])
-                            )
+                            query += 'AND id NOT IN (%s)' % ','.join(_UPDATE_METADATA_IDS['parent_rating_key_ids'])
 
                         ids = [str(row['id']) for row in monitor_db.select(query, args)]
                         if ids:
@@ -1945,9 +1941,7 @@ class DataFactory(object):
                         args = [old_key]
 
                         if _UPDATE_METADATA_IDS['rating_key_ids']:
-                            query += (
-                                'AND id NOT IN (%s)' % ','.join(_UPDATE_METADATA_IDS['rating_key_ids'])
-                            )
+                            query += 'AND id NOT IN (%s)' % ','.join(_UPDATE_METADATA_IDS['rating_key_ids'])
 
                         ids = [str(row['id']) for row in monitor_db.select(query, args)]
                         if ids:
@@ -1965,11 +1959,6 @@ class DataFactory(object):
                             'WHERE id IN (%s)' % ','.join(ids),
                             [new_key]
                         )
-                        monitor_db.action(
-                            'INSERT INTO update_metadata (rating_key_id) '
-                            'VALUES %s' % ','.join(['(?)'] * len(ids)),
-                            ids
-                        )
 
                         # update session_history_metadata table
                         self.update_metadata_details(old_key, new_key, metadata, ids)

From 2d9e109f97177d7794481f691a8e6d5c00d85dd9 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 7 Feb 2022 21:57:11 -0800
Subject: [PATCH 011/743] Bump arrow from 1.2.1 to 1.2.2 (#1630)

* Bump arrow from 1.2.1 to 1.2.2

Bumps [arrow](https://github.com/arrow-py/arrow) from 1.2.1 to 1.2.2.
- [Release notes](https://github.com/arrow-py/arrow/releases)
- [Changelog](https://github.com/arrow-py/arrow/blob/master/CHANGELOG.rst)
- [Commits](https://github.com/arrow-py/arrow/compare/1.2.1...1.2.2)

---
updated-dependencies:
- dependency-name: arrow
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

* Update arrow==1.2.2

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/arrow/_version.py    |    2 +-
 lib/arrow/arrow.py       |    4 +-
 lib/arrow/constants.py   |   19 +
 lib/arrow/locales.py     |  159 ++-
 lib/typing_extensions.py | 2009 ++++++++++++++------------------------
 requirements.txt         |    2 +-
 6 files changed, 891 insertions(+), 1304 deletions(-)

diff --git a/lib/arrow/_version.py b/lib/arrow/_version.py
index a955fdae..bc86c944 100644
--- a/lib/arrow/_version.py
+++ b/lib/arrow/_version.py
@@ -1 +1 @@
-__version__ = "1.2.1"
+__version__ = "1.2.2"
diff --git a/lib/arrow/arrow.py b/lib/arrow/arrow.py
index fef66c10..21b0347f 100644
--- a/lib/arrow/arrow.py
+++ b/lib/arrow/arrow.py
@@ -759,7 +759,7 @@ class Arrow:
             >>> start = datetime(2013, 5, 5, 12, 30)
             >>> end = datetime(2013, 5, 5, 17, 15)
             >>> for r in arrow.Arrow.interval('hour', start, end, 2):
-            ...     print r
+            ...     print(r)
             ...
             (<Arrow [2013-05-05T12:00:00+00:00]>, <Arrow [2013-05-05T13:59:59.999999+00:00]>)
             (<Arrow [2013-05-05T14:00:00+00:00]>, <Arrow [2013-05-05T15:59:59.999999+00:00]>)
@@ -1384,7 +1384,7 @@ class Arrow:
                 search_string = search_string.format(r"\d+")
 
                 # Create search pattern and find within string
-                pattern = re.compile(fr"{search_string}")
+                pattern = re.compile(fr"(^|\b|\d){search_string}")
                 match = pattern.search(input_string)
 
                 # If there is no match continue to next iteration
diff --git a/lib/arrow/constants.py b/lib/arrow/constants.py
index e41ffa5d..1189d07c 100644
--- a/lib/arrow/constants.py
+++ b/lib/arrow/constants.py
@@ -73,7 +73,20 @@ DEHUMANIZE_LOCALES = {
     "zh-hk",
     "nl",
     "nl-nl",
+    "be",
+    "be-by",
+    "pl",
+    "pl-pl",
+    "ru",
+    "ru-ru",
     "af",
+    "bg",
+    "bg-bg",
+    "ua",
+    "uk",
+    "uk-ua",
+    "mk",
+    "mk-mk",
     "de",
     "de-de",
     "de-ch",
@@ -97,6 +110,10 @@ DEHUMANIZE_LOCALES = {
     "da-dk",
     "ml",
     "hi",
+    "cs",
+    "cs-cz",
+    "sk",
+    "sk-sk",
     "fa",
     "fa-ir",
     "mr",
@@ -145,4 +162,6 @@ DEHUMANIZE_LOCALES = {
     "ta-lk",
     "ur",
     "ur-pk",
+    "kk",
+    "kk-kz",
 }
diff --git a/lib/arrow/locales.py b/lib/arrow/locales.py
index d6d5c486..b7fb0d32 100644
--- a/lib/arrow/locales.py
+++ b/lib/arrow/locales.py
@@ -46,7 +46,7 @@ _TimeFrameElements = Union[
 ]
 
 
-_locale_map: Dict[str, Type["Locale"]] = dict()
+_locale_map: Dict[str, Type["Locale"]] = {}
 
 
 def get_locale(name: str) -> "Locale":
@@ -172,7 +172,16 @@ class Locale:
         humanized = " ".join(parts)
 
         if not only_distance:
-            humanized = self._format_relative(humanized, *timeframes[-1])
+            # Needed to determine the correct relative string to use
+            timeframe_value = 0
+
+            for _unit_name, unit_value in timeframes:
+                if trunc(unit_value) != 0:
+                    timeframe_value = trunc(unit_value)
+                    break
+
+            # Note it doesn't matter the timeframe unit we use on the call, only the value
+            humanized = self._format_relative(humanized, "seconds", timeframe_value)
 
         return humanized
 
@@ -951,7 +960,7 @@ class ChineseCNLocale(Locale):
 
     timeframes = {
         "now": "刚才",
-        "second": "一秒",
+        "second": "1秒",
         "seconds": "{0}秒",
         "minute": "1分钟",
         "minutes": "{0}分钟",
@@ -959,7 +968,7 @@ class ChineseCNLocale(Locale):
         "hours": "{0}小时",
         "day": "1天",
         "days": "{0}天",
-        "week": "一周",
+        "week": "1周",
         "weeks": "{0}周",
         "month": "1个月",
         "months": "{0}个月",
@@ -1487,8 +1496,12 @@ class RussianLocale(SlavicBaseLocale):
 
     timeframes: ClassVar[Mapping[TimeFrameLiteral, Union[str, Mapping[str, str]]]] = {
         "now": "сейчас",
-        "second": "Второй",
-        "seconds": "{0} несколько секунд",
+        "second": "секунда",
+        "seconds": {
+            "singular": "{0} секунду",
+            "dual": "{0} секунды",
+            "plural": "{0} секунд",
+        },
         "minute": "минуту",
         "minutes": {
             "singular": "{0} минуту",
@@ -1511,6 +1524,12 @@ class RussianLocale(SlavicBaseLocale):
             "dual": "{0} месяца",
             "plural": "{0} месяцев",
         },
+        "quarter": "квартал",
+        "quarters": {
+            "singular": "{0} квартал",
+            "dual": "{0} квартала",
+            "plural": "{0} кварталов",
+        },
         "year": "год",
         "years": {"singular": "{0} год", "dual": "{0} года", "plural": "{0} лет"},
     }
@@ -2037,6 +2056,8 @@ class NorwegianLocale(Locale):
         "hours": "{0} timer",
         "day": "en dag",
         "days": "{0} dager",
+        "week": "en uke",
+        "weeks": "{0} uker",
         "month": "en måned",
         "months": "{0} måneder",
         "year": "ett år",
@@ -2086,6 +2107,9 @@ class NorwegianLocale(Locale):
     ]
     day_abbreviations = ["", "ma", "ti", "on", "to", "fr", "lø", "sø"]
 
+    def _ordinal_number(self, n: int) -> str:
+        return f"{n}."
+
 
 class NewNorwegianLocale(Locale):
 
@@ -2104,7 +2128,9 @@ class NewNorwegianLocale(Locale):
         "hours": "{0} timar",
         "day": "ein dag",
         "days": "{0} dagar",
-        "month": "en månad",
+        "week": "ei veke",
+        "weeks": "{0} veker",
+        "month": "ein månad",
         "months": "{0} månader",
         "year": "eitt år",
         "years": "{0} år",
@@ -2153,6 +2179,9 @@ class NewNorwegianLocale(Locale):
     ]
     day_abbreviations = ["", "må", "ty", "on", "to", "fr", "la", "su"]
 
+    def _ordinal_number(self, n: int) -> str:
+        return f"{n}."
+
 
 class PortugueseLocale(Locale):
     names = ["pt", "pt-pt"]
@@ -3048,44 +3077,51 @@ class CzechLocale(Locale):
 
     timeframes: ClassVar[Mapping[TimeFrameLiteral, Union[str, Mapping[str, str]]]] = {
         "now": "Teď",
-        "second": {"past": "vteřina", "future": "vteřina", "zero": "vteřina"},
+        "second": {"past": "vteřina", "future": "vteřina"},
         "seconds": {
+            "zero": "vteřina",
             "past": "{0} sekundami",
             "future-singular": "{0} sekundy",
             "future-paucal": "{0} sekund",
         },
-        "minute": {"past": "minutou", "future": "minutu", "zero": "{0} minut"},
+        "minute": {"past": "minutou", "future": "minutu"},
         "minutes": {
+            "zero": "{0} minut",
             "past": "{0} minutami",
             "future-singular": "{0} minuty",
             "future-paucal": "{0} minut",
         },
-        "hour": {"past": "hodinou", "future": "hodinu", "zero": "{0} hodin"},
+        "hour": {"past": "hodinou", "future": "hodinu"},
         "hours": {
+            "zero": "{0} hodin",
             "past": "{0} hodinami",
             "future-singular": "{0} hodiny",
             "future-paucal": "{0} hodin",
         },
-        "day": {"past": "dnem", "future": "den", "zero": "{0} dnů"},
+        "day": {"past": "dnem", "future": "den"},
         "days": {
+            "zero": "{0} dnů",
             "past": "{0} dny",
             "future-singular": "{0} dny",
             "future-paucal": "{0} dnů",
         },
-        "week": {"past": "týdnem", "future": "týden", "zero": "{0} týdnů"},
+        "week": {"past": "týdnem", "future": "týden"},
         "weeks": {
+            "zero": "{0} týdnů",
             "past": "{0} týdny",
             "future-singular": "{0} týdny",
             "future-paucal": "{0} týdnů",
         },
-        "month": {"past": "měsícem", "future": "měsíc", "zero": "{0} měsíců"},
+        "month": {"past": "měsícem", "future": "měsíc"},
         "months": {
+            "zero": "{0} měsíců",
             "past": "{0} měsíci",
             "future-singular": "{0} měsíce",
             "future-paucal": "{0} měsíců",
         },
-        "year": {"past": "rokem", "future": "rok", "zero": "{0} let"},
+        "year": {"past": "rokem", "future": "rok"},
         "years": {
+            "zero": "{0} let",
             "past": "{0} lety",
             "future-singular": "{0} roky",
             "future-paucal": "{0} let",
@@ -3171,44 +3207,51 @@ class SlovakLocale(Locale):
 
     timeframes: ClassVar[Mapping[TimeFrameLiteral, Union[str, Mapping[str, str]]]] = {
         "now": "Teraz",
-        "second": {"past": "sekundou", "future": "sekundu", "zero": "{0} sekúnd"},
+        "second": {"past": "sekundou", "future": "sekundu"},
         "seconds": {
+            "zero": "{0} sekúnd",
             "past": "{0} sekundami",
             "future-singular": "{0} sekundy",
             "future-paucal": "{0} sekúnd",
         },
-        "minute": {"past": "minútou", "future": "minútu", "zero": "{0} minút"},
+        "minute": {"past": "minútou", "future": "minútu"},
         "minutes": {
+            "zero": "{0} minút",
             "past": "{0} minútami",
             "future-singular": "{0} minúty",
             "future-paucal": "{0} minút",
         },
-        "hour": {"past": "hodinou", "future": "hodinu", "zero": "{0} hodín"},
+        "hour": {"past": "hodinou", "future": "hodinu"},
         "hours": {
+            "zero": "{0} hodín",
             "past": "{0} hodinami",
             "future-singular": "{0} hodiny",
             "future-paucal": "{0} hodín",
         },
-        "day": {"past": "dňom", "future": "deň", "zero": "{0} dní"},
+        "day": {"past": "dňom", "future": "deň"},
         "days": {
+            "zero": "{0} dní",
             "past": "{0} dňami",
             "future-singular": "{0} dni",
             "future-paucal": "{0} dní",
         },
-        "week": {"past": "týždňom", "future": "týždeň", "zero": "{0} týždňov"},
+        "week": {"past": "týždňom", "future": "týždeň"},
         "weeks": {
+            "zero": "{0} týždňov",
             "past": "{0} týždňami",
             "future-singular": "{0} týždne",
             "future-paucal": "{0} týždňov",
         },
-        "month": {"past": "mesiacom", "future": "mesiac", "zero": "{0} mesiacov"},
+        "month": {"past": "mesiacom", "future": "mesiac"},
         "months": {
+            "zero": "{0} mesiacov",
             "past": "{0} mesiacmi",
             "future-singular": "{0} mesiace",
             "future-paucal": "{0} mesiacov",
         },
-        "year": {"past": "rokom", "future": "rok", "zero": "{0} rokov"},
+        "year": {"past": "rokom", "future": "rok"},
         "years": {
+            "zero": "{0} rokov",
             "past": "{0} rokmi",
             "future-singular": "{0} roky",
             "future-paucal": "{0} rokov",
@@ -4229,8 +4272,12 @@ class IndonesianLocale(Locale):
         "hours": "{0} jam",
         "day": "1 hari",
         "days": "{0} hari",
+        "week": "1 minggu",
+        "weeks": "{0} minggu",
         "month": "1 bulan",
         "months": "{0} bulan",
+        "quarter": "1 kuartal",
+        "quarters": "{0} kuartal",
         "year": "1 tahun",
         "years": "{0} tahun",
     }
@@ -5706,7 +5753,7 @@ class SinhalaLocale(Locale):
     }
     # Sinhala: the general format to describe timeframe is different from past and future,
     # so we do not copy the original timeframes dictionary
-    timeframes_only_distance = dict()
+    timeframes_only_distance = {}
     timeframes_only_distance["second"] = "තත්පරයක්"
     timeframes_only_distance["seconds"] = "තත්පර {0}"
     timeframes_only_distance["minute"] = "මිනිත්තුවක්"
@@ -5895,3 +5942,71 @@ class UrduLocale(Locale):
         "ہفتہ",
         "اتوار",
     ]
+
+
+class KazakhLocale(Locale):
+
+    names = ["kk", "kk-kz"]
+
+    past = "{0} бұрын"
+    future = "{0} кейін"
+    timeframes = {
+        "now": "қазір",
+        "second": "бір секунд",
+        "seconds": "{0} секунд",
+        "minute": "бір минут",
+        "minutes": "{0} минут",
+        "hour": "бір сағат",
+        "hours": "{0} сағат",
+        "day": "бір күн",
+        "days": "{0} күн",
+        "week": "бір апта",
+        "weeks": "{0} апта",
+        "month": "бір ай",
+        "months": "{0} ай",
+        "year": "бір жыл",
+        "years": "{0} жыл",
+    }
+
+    month_names = [
+        "",
+        "Қаңтар",
+        "Ақпан",
+        "Наурыз",
+        "Сәуір",
+        "Мамыр",
+        "Маусым",
+        "Шілде",
+        "Тамыз",
+        "Қыркүйек",
+        "Қазан",
+        "Қараша",
+        "Желтоқсан",
+    ]
+    month_abbreviations = [
+        "",
+        "Қан",
+        "Ақп",
+        "Нау",
+        "Сәу",
+        "Мам",
+        "Мау",
+        "Шіл",
+        "Там",
+        "Қыр",
+        "Қаз",
+        "Қар",
+        "Жел",
+    ]
+
+    day_names = [
+        "",
+        "Дүйсембі",
+        "Сейсенбі",
+        "Сәрсенбі",
+        "Бейсенбі",
+        "Жұма",
+        "Сенбі",
+        "Жексенбі",
+    ]
+    day_abbreviations = ["", "Дс", "Сс", "Ср", "Бс", "Жм", "Сб", "Жс"]
diff --git a/lib/typing_extensions.py b/lib/typing_extensions.py
index 95bb8735..9f1c7aa3 100644
--- a/lib/typing_extensions.py
+++ b/lib/typing_extensions.py
@@ -1,50 +1,20 @@
 import abc
 import collections
-import contextlib
+import collections.abc
+import operator
 import sys
 import typing
-import collections.abc as collections_abc
-import operator
-
-# These are used by Protocol implementation
-# We use internal typing helpers here, but this significantly reduces
-# code duplication. (Also this is only until Protocol is in typing.)
-from typing import Generic, Callable, TypeVar, Tuple
 
 # After PEP 560, internal typing API was substantially reworked.
 # This is especially important for Protocol class which uses internal APIs
-# quite extensivelly.
+# quite extensively.
 PEP_560 = sys.version_info[:3] >= (3, 7, 0)
 
 if PEP_560:
-    GenericMeta = TypingMeta = type
-    from typing import _GenericAlias
+    GenericMeta = type
 else:
-    from typing import GenericMeta, TypingMeta
-OLD_GENERICS = False
-try:
-    from typing import _type_vars, _next_in_mro, _type_check
-except ImportError:
-    OLD_GENERICS = True
-try:
-    from typing import _subs_tree  # noqa
-    SUBS_TREE = True
-except ImportError:
-    SUBS_TREE = False
-try:
-    from typing import _tp_cache
-except ImportError:
-    def _tp_cache(x):
-        return x
-try:
-    from typing import _TypingEllipsis, _TypingEmpty
-except ImportError:
-    class _TypingEllipsis:
-        pass
-
-    class _TypingEmpty:
-        pass
-
+    # 3.6
+    from typing import GenericMeta, _type_vars  # noqa
 
 # The two functions below are copies of typing internal helpers.
 # They are needed by _ProtocolMeta
@@ -60,56 +30,12 @@ def _no_slots_copy(dct):
 
 def _check_generic(cls, parameters):
     if not cls.__parameters__:
-        raise TypeError("%s is not a generic class" % repr(cls))
+        raise TypeError(f"{cls} is not a generic class")
     alen = len(parameters)
     elen = len(cls.__parameters__)
     if alen != elen:
-        raise TypeError("Too %s parameters for %s; actual %s, expected %s" %
-                        ("many" if alen > elen else "few", repr(cls), alen, elen))
-
-
-if hasattr(typing, '_generic_new'):
-    _generic_new = typing._generic_new
-else:
-    # Note: The '_generic_new(...)' function is used as a part of the
-    # process of creating a generic type and was added to the typing module
-    # as of Python 3.5.3.
-    #
-    # We've defined '_generic_new(...)' below to exactly match the behavior
-    # implemented in older versions of 'typing' bundled with Python 3.5.0 to
-    # 3.5.2. This helps eliminate redundancy when defining collection types
-    # like 'Deque' later.
-    #
-    # See https://github.com/python/typing/pull/308 for more details -- in
-    # particular, compare and contrast the definition of types like
-    # 'typing.List' before and after the merge.
-
-    def _generic_new(base_cls, cls, *args, **kwargs):
-        return base_cls.__new__(cls, *args, **kwargs)
-
-# See https://github.com/python/typing/pull/439
-if hasattr(typing, '_geqv'):
-    from typing import _geqv
-    _geqv_defined = True
-else:
-    _geqv = None
-    _geqv_defined = False
-
-if sys.version_info[:2] >= (3, 6):
-    import _collections_abc
-    _check_methods_in_mro = _collections_abc._check_methods
-else:
-    def _check_methods_in_mro(C, *methods):
-        mro = C.__mro__
-        for method in methods:
-            for B in mro:
-                if method in B.__dict__:
-                    if B.__dict__[method] is None:
-                        return NotImplemented
-                    break
-            else:
-                return NotImplemented
-        return True
+        raise TypeError(f"Too {'many' if alen > elen else 'few'} arguments for {cls};"
+                        f" actual {alen}, expected {elen}")
 
 
 # Please keep __all__ alphabetized within each category.
@@ -119,18 +45,17 @@ __all__ = [
     'Concatenate',
     'Final',
     'ParamSpec',
+    'Self',
     'Type',
 
     # ABCs (from collections.abc).
-    # The following are added depending on presence
-    # of their non-generic counterparts in stdlib:
-    # 'Awaitable',
-    # 'AsyncIterator',
-    # 'AsyncIterable',
-    # 'Coroutine',
-    # 'AsyncGenerator',
-    # 'AsyncContextManager',
-    # 'ChainMap',
+    'Awaitable',
+    'AsyncIterator',
+    'AsyncIterable',
+    'Coroutine',
+    'AsyncGenerator',
+    'AsyncContextManager',
+    'ChainMap',
 
     # Concrete collection types.
     'ContextManager',
@@ -144,38 +69,29 @@ __all__ = [
     'SupportsIndex',
 
     # One-off things.
+    'Annotated',
     'final',
     'IntVar',
     'Literal',
     'NewType',
     'overload',
+    'Protocol',
+    'runtime',
+    'runtime_checkable',
     'Text',
     'TypeAlias',
     'TypeGuard',
     'TYPE_CHECKING',
 ]
 
-# Annotated relies on substitution trees of pep 560. It will not work for
-# versions of typing older than 3.5.3
-HAVE_ANNOTATED = PEP_560 or SUBS_TREE
-
 if PEP_560:
     __all__.extend(["get_args", "get_origin", "get_type_hints"])
 
-if HAVE_ANNOTATED:
-    __all__.append("Annotated")
-
-# Protocols are hard to backport to the original version of typing 3.5.0
-HAVE_PROTOCOLS = sys.version_info[:3] != (3, 5, 0)
-
-if HAVE_PROTOCOLS:
-    __all__.extend(['Protocol', 'runtime', 'runtime_checkable'])
-
-
-# TODO
+# 3.6.2+
 if hasattr(typing, 'NoReturn'):
     NoReturn = typing.NoReturn
-elif hasattr(typing, '_FinalTypingBase'):
+# 3.6.0-3.6.1
+else:
     class _NoReturn(typing._FinalTypingBase, _root=True):
         """Special type indicating functions that never return.
         Example::
@@ -197,32 +113,6 @@ elif hasattr(typing, '_FinalTypingBase'):
             raise TypeError("NoReturn cannot be used with issubclass().")
 
     NoReturn = _NoReturn(_root=True)
-else:
-    class _NoReturnMeta(typing.TypingMeta):
-        """Metaclass for NoReturn"""
-        def __new__(cls, name, bases, namespace, _root=False):
-            return super().__new__(cls, name, bases, namespace, _root=_root)
-
-        def __instancecheck__(self, obj):
-            raise TypeError("NoReturn cannot be used with isinstance().")
-
-        def __subclasscheck__(self, cls):
-            raise TypeError("NoReturn cannot be used with issubclass().")
-
-    class NoReturn(typing.Final, metaclass=_NoReturnMeta, _root=True):
-        """Special type indicating functions that never return.
-        Example::
-
-          from typing import NoReturn
-
-          def stop() -> NoReturn:
-              raise Exception('no way')
-
-        This type is invalid in other positions, e.g., ``List[NoReturn]``
-        will fail in static type checkers.
-        """
-        __slots__ = ()
-
 
 # Some unconstrained type variables.  These are used by the container types.
 # (These are not for export.)
@@ -230,142 +120,15 @@ T = typing.TypeVar('T')  # Any type.
 KT = typing.TypeVar('KT')  # Key type.
 VT = typing.TypeVar('VT')  # Value type.
 T_co = typing.TypeVar('T_co', covariant=True)  # Any type covariant containers.
-V_co = typing.TypeVar('V_co', covariant=True)  # Any type covariant containers.
-VT_co = typing.TypeVar('VT_co', covariant=True)  # Value type covariant containers.
 T_contra = typing.TypeVar('T_contra', contravariant=True)  # Ditto contravariant.
 
-
-if hasattr(typing, 'ClassVar'):
-    ClassVar = typing.ClassVar
-elif hasattr(typing, '_FinalTypingBase'):
-    class _ClassVar(typing._FinalTypingBase, _root=True):
-        """Special type construct to mark class variables.
-
-        An annotation wrapped in ClassVar indicates that a given
-        attribute is intended to be used as a class variable and
-        should not be set on instances of that class. Usage::
-
-          class Starship:
-              stats: ClassVar[Dict[str, int]] = {} # class variable
-              damage: int = 10                     # instance variable
-
-        ClassVar accepts only types and cannot be further subscribed.
-
-        Note that ClassVar is not a class itself, and should not
-        be used with isinstance() or issubclass().
-        """
-
-        __slots__ = ('__type__',)
-
-        def __init__(self, tp=None, **kwds):
-            self.__type__ = tp
-
-        def __getitem__(self, item):
-            cls = type(self)
-            if self.__type__ is None:
-                return cls(typing._type_check(item,
-                           '{} accepts only single type.'.format(cls.__name__[1:])),
-                           _root=True)
-            raise TypeError('{} cannot be further subscripted'
-                            .format(cls.__name__[1:]))
-
-        def _eval_type(self, globalns, localns):
-            new_tp = typing._eval_type(self.__type__, globalns, localns)
-            if new_tp == self.__type__:
-                return self
-            return type(self)(new_tp, _root=True)
-
-        def __repr__(self):
-            r = super().__repr__()
-            if self.__type__ is not None:
-                r += '[{}]'.format(typing._type_repr(self.__type__))
-            return r
-
-        def __hash__(self):
-            return hash((type(self).__name__, self.__type__))
-
-        def __eq__(self, other):
-            if not isinstance(other, _ClassVar):
-                return NotImplemented
-            if self.__type__ is not None:
-                return self.__type__ == other.__type__
-            return self is other
-
-    ClassVar = _ClassVar(_root=True)
-else:
-    class _ClassVarMeta(typing.TypingMeta):
-        """Metaclass for ClassVar"""
-
-        def __new__(cls, name, bases, namespace, tp=None, _root=False):
-            self = super().__new__(cls, name, bases, namespace, _root=_root)
-            if tp is not None:
-                self.__type__ = tp
-            return self
-
-        def __instancecheck__(self, obj):
-            raise TypeError("ClassVar cannot be used with isinstance().")
-
-        def __subclasscheck__(self, cls):
-            raise TypeError("ClassVar cannot be used with issubclass().")
-
-        def __getitem__(self, item):
-            cls = type(self)
-            if self.__type__ is not None:
-                raise TypeError('{} cannot be further subscripted'
-                                .format(cls.__name__[1:]))
-
-            param = typing._type_check(
-                item,
-                '{} accepts only single type.'.format(cls.__name__[1:]))
-            return cls(self.__name__, self.__bases__,
-                       dict(self.__dict__), tp=param, _root=True)
-
-        def _eval_type(self, globalns, localns):
-            new_tp = typing._eval_type(self.__type__, globalns, localns)
-            if new_tp == self.__type__:
-                return self
-            return type(self)(self.__name__, self.__bases__,
-                              dict(self.__dict__), tp=self.__type__,
-                              _root=True)
-
-        def __repr__(self):
-            r = super().__repr__()
-            if self.__type__ is not None:
-                r += '[{}]'.format(typing._type_repr(self.__type__))
-            return r
-
-        def __hash__(self):
-            return hash((type(self).__name__, self.__type__))
-
-        def __eq__(self, other):
-            if not isinstance(other, ClassVar):
-                return NotImplemented
-            if self.__type__ is not None:
-                return self.__type__ == other.__type__
-            return self is other
-
-    class ClassVar(typing.Final, metaclass=_ClassVarMeta, _root=True):
-        """Special type construct to mark class variables.
-
-        An annotation wrapped in ClassVar indicates that a given
-        attribute is intended to be used as a class variable and
-        should not be set on instances of that class. Usage::
-
-          class Starship:
-              stats: ClassVar[Dict[str, int]] = {} # class variable
-              damage: int = 10                     # instance variable
-
-        ClassVar accepts only types and cannot be further subscribed.
-
-        Note that ClassVar is not a class itself, and should not
-        be used with isinstance() or issubclass().
-        """
-
-        __type__ = None
+ClassVar = typing.ClassVar
 
 # On older versions of typing there is an internal class named "Final".
+# 3.8+
 if hasattr(typing, 'Final') and sys.version_info[:2] >= (3, 7):
     Final = typing.Final
+# 3.7
 elif sys.version_info[:2] >= (3, 7):
     class _FinalForm(typing._SpecialForm, _root=True):
 
@@ -374,8 +137,8 @@ elif sys.version_info[:2] >= (3, 7):
 
         def __getitem__(self, parameters):
             item = typing._type_check(parameters,
-                                      '{} accepts only single type'.format(self._name))
-            return _GenericAlias(self, (item,))
+                                      f'{self._name} accepts only single type')
+            return typing._GenericAlias(self, (item,))
 
     Final = _FinalForm('Final',
                        doc="""A special typing construct to indicate that a name
@@ -391,7 +154,8 @@ elif sys.version_info[:2] >= (3, 7):
                                TIMEOUT = 1  # Error reported by type checker
 
                        There is no runtime checking of these properties.""")
-elif hasattr(typing, '_FinalTypingBase'):
+# 3.6
+else:
     class _Final(typing._FinalTypingBase, _root=True):
         """A special typing construct to indicate that a name
         cannot be re-assigned or overridden in a subclass.
@@ -417,10 +181,9 @@ elif hasattr(typing, '_FinalTypingBase'):
             cls = type(self)
             if self.__type__ is None:
                 return cls(typing._type_check(item,
-                           '{} accepts only single type.'.format(cls.__name__[1:])),
+                           f'{cls.__name__[1:]} accepts only single type.'),
                            _root=True)
-            raise TypeError('{} cannot be further subscripted'
-                            .format(cls.__name__[1:]))
+            raise TypeError(f'{cls.__name__[1:]} cannot be further subscripted')
 
         def _eval_type(self, globalns, localns):
             new_tp = typing._eval_type(self.__type__, globalns, localns)
@@ -431,7 +194,7 @@ elif hasattr(typing, '_FinalTypingBase'):
         def __repr__(self):
             r = super().__repr__()
             if self.__type__ is not None:
-                r += '[{}]'.format(typing._type_repr(self.__type__))
+                r += f'[{typing._type_repr(self.__type__)}]'
             return r
 
         def __hash__(self):
@@ -445,79 +208,12 @@ elif hasattr(typing, '_FinalTypingBase'):
             return self is other
 
     Final = _Final(_root=True)
-else:
-    class _FinalMeta(typing.TypingMeta):
-        """Metaclass for Final"""
-
-        def __new__(cls, name, bases, namespace, tp=None, _root=False):
-            self = super().__new__(cls, name, bases, namespace, _root=_root)
-            if tp is not None:
-                self.__type__ = tp
-            return self
-
-        def __instancecheck__(self, obj):
-            raise TypeError("Final cannot be used with isinstance().")
-
-        def __subclasscheck__(self, cls):
-            raise TypeError("Final cannot be used with issubclass().")
-
-        def __getitem__(self, item):
-            cls = type(self)
-            if self.__type__ is not None:
-                raise TypeError('{} cannot be further subscripted'
-                                .format(cls.__name__[1:]))
-
-            param = typing._type_check(
-                item,
-                '{} accepts only single type.'.format(cls.__name__[1:]))
-            return cls(self.__name__, self.__bases__,
-                       dict(self.__dict__), tp=param, _root=True)
-
-        def _eval_type(self, globalns, localns):
-            new_tp = typing._eval_type(self.__type__, globalns, localns)
-            if new_tp == self.__type__:
-                return self
-            return type(self)(self.__name__, self.__bases__,
-                              dict(self.__dict__), tp=self.__type__,
-                              _root=True)
-
-        def __repr__(self):
-            r = super().__repr__()
-            if self.__type__ is not None:
-                r += '[{}]'.format(typing._type_repr(self.__type__))
-            return r
-
-        def __hash__(self):
-            return hash((type(self).__name__, self.__type__))
-
-        def __eq__(self, other):
-            if not isinstance(other, Final):
-                return NotImplemented
-            if self.__type__ is not None:
-                return self.__type__ == other.__type__
-            return self is other
-
-    class Final(typing.Final, metaclass=_FinalMeta, _root=True):
-        """A special typing construct to indicate that a name
-        cannot be re-assigned or overridden in a subclass.
-        For example:
-
-            MAX_SIZE: Final = 9000
-            MAX_SIZE += 1  # Error reported by type checker
-
-            class Connection:
-                TIMEOUT: Final[int] = 10
-            class FastConnector(Connection):
-                TIMEOUT = 1  # Error reported by type checker
-
-        There is no runtime checking of these properties.
-        """
-
-        __type__ = None
 
 
+# 3.8+
 if hasattr(typing, 'final'):
     final = typing.final
+# 3.6-3.7
 else:
     def final(f):
         """This decorator can be used to indicate to type checkers that
@@ -543,11 +239,13 @@ else:
 
 
 def IntVar(name):
-    return TypeVar(name)
+    return typing.TypeVar(name)
 
 
+# 3.8+:
 if hasattr(typing, 'Literal'):
     Literal = typing.Literal
+# 3.7:
 elif sys.version_info[:2] >= (3, 7):
     class _LiteralForm(typing._SpecialForm, _root=True):
 
@@ -555,7 +253,7 @@ elif sys.version_info[:2] >= (3, 7):
             return 'typing_extensions.' + self._name
 
         def __getitem__(self, parameters):
-            return _GenericAlias(self, parameters)
+            return typing._GenericAlias(self, parameters)
 
     Literal = _LiteralForm('Literal',
                            doc="""A type that can be used to indicate to type checkers
@@ -570,7 +268,8 @@ elif sys.version_info[:2] >= (3, 7):
                            Literal[...] cannot be subclassed. There is no runtime
                            checking verifying that the parameter is actually a value
                            instead of a type.""")
-elif hasattr(typing, '_FinalTypingBase'):
+# 3.6:
+else:
     class _Literal(typing._FinalTypingBase, _root=True):
         """A type that can be used to indicate to type checkers that the
         corresponding value has a value literally equivalent to the
@@ -596,8 +295,7 @@ elif hasattr(typing, '_FinalTypingBase'):
                 if not isinstance(values, tuple):
                     values = (values,)
                 return cls(values, _root=True)
-            raise TypeError('{} cannot be further subscripted'
-                            .format(cls.__name__[1:]))
+            raise TypeError(f'{cls.__name__[1:]} cannot be further subscripted')
 
         def _eval_type(self, globalns, localns):
             return self
@@ -605,7 +303,7 @@ elif hasattr(typing, '_FinalTypingBase'):
         def __repr__(self):
             r = super().__repr__()
             if self.__values__ is not None:
-                r += '[{}]'.format(', '.join(map(typing._type_repr, self.__values__)))
+                r += f'[{", ".join(map(typing._type_repr, self.__values__))}]'
             return r
 
         def __hash__(self):
@@ -619,161 +317,18 @@ elif hasattr(typing, '_FinalTypingBase'):
             return self is other
 
     Literal = _Literal(_root=True)
-else:
-    class _LiteralMeta(typing.TypingMeta):
-        """Metaclass for Literal"""
-
-        def __new__(cls, name, bases, namespace, values=None, _root=False):
-            self = super().__new__(cls, name, bases, namespace, _root=_root)
-            if values is not None:
-                self.__values__ = values
-            return self
-
-        def __instancecheck__(self, obj):
-            raise TypeError("Literal cannot be used with isinstance().")
-
-        def __subclasscheck__(self, cls):
-            raise TypeError("Literal cannot be used with issubclass().")
-
-        def __getitem__(self, item):
-            cls = type(self)
-            if self.__values__ is not None:
-                raise TypeError('{} cannot be further subscripted'
-                                .format(cls.__name__[1:]))
-
-            if not isinstance(item, tuple):
-                item = (item,)
-            return cls(self.__name__, self.__bases__,
-                       dict(self.__dict__), values=item, _root=True)
-
-        def _eval_type(self, globalns, localns):
-            return self
-
-        def __repr__(self):
-            r = super().__repr__()
-            if self.__values__ is not None:
-                r += '[{}]'.format(', '.join(map(typing._type_repr, self.__values__)))
-            return r
-
-        def __hash__(self):
-            return hash((type(self).__name__, self.__values__))
-
-        def __eq__(self, other):
-            if not isinstance(other, Literal):
-                return NotImplemented
-            if self.__values__ is not None:
-                return self.__values__ == other.__values__
-            return self is other
-
-    class Literal(typing.Final, metaclass=_LiteralMeta, _root=True):
-        """A type that can be used to indicate to type checkers that the
-        corresponding value has a value literally equivalent to the
-        provided parameter. For example:
-
-            var: Literal[4] = 4
-
-        The type checker understands that 'var' is literally equal to the
-        value 4 and no other value.
-
-        Literal[...] cannot be subclassed. There is no runtime checking
-        verifying that the parameter is actually a value instead of a type.
-        """
-
-        __values__ = None
 
 
-def _overload_dummy(*args, **kwds):
-    """Helper for @overload to raise when called."""
-    raise NotImplementedError(
-        "You should not call an overloaded function. "
-        "A series of @overload-decorated functions "
-        "outside a stub module should always be followed "
-        "by an implementation that is not @overload-ed.")
-
-
-def overload(func):
-    """Decorator for overloaded functions/methods.
-
-    In a stub file, place two or more stub definitions for the same
-    function in a row, each decorated with @overload.  For example:
-
-      @overload
-      def utf8(value: None) -> None: ...
-      @overload
-      def utf8(value: bytes) -> bytes: ...
-      @overload
-      def utf8(value: str) -> bytes: ...
-
-    In a non-stub file (i.e. a regular .py file), do the same but
-    follow it with an implementation.  The implementation should *not*
-    be decorated with @overload.  For example:
-
-      @overload
-      def utf8(value: None) -> None: ...
-      @overload
-      def utf8(value: bytes) -> bytes: ...
-      @overload
-      def utf8(value: str) -> bytes: ...
-      def utf8(value):
-          # implementation goes here
-    """
-    return _overload_dummy
+_overload_dummy = typing._overload_dummy  # noqa
+overload = typing.overload
 
 
 # This is not a real generic class.  Don't use outside annotations.
-if hasattr(typing, 'Type'):
-    Type = typing.Type
-else:
-    # Internal type variable used for Type[].
-    CT_co = typing.TypeVar('CT_co', covariant=True, bound=type)
-
-    class Type(typing.Generic[CT_co], extra=type):
-        """A special construct usable to annotate class objects.
-
-        For example, suppose we have the following classes::
-
-          class User: ...  # Abstract base for User classes
-          class BasicUser(User): ...
-          class ProUser(User): ...
-          class TeamUser(User): ...
-
-        And a function that takes a class argument that's a subclass of
-        User and returns an instance of the corresponding class::
-
-          U = TypeVar('U', bound=User)
-          def new_user(user_class: Type[U]) -> U:
-              user = user_class()
-              # (Here we could write the user object to a database)
-              return user
-          joe = new_user(BasicUser)
-
-        At this point the type checker knows that joe has type BasicUser.
-        """
-
-        __slots__ = ()
-
+Type = typing.Type
 
 # Various ABCs mimicking those in collections.abc.
 # A few are simply re-exported for completeness.
 
-def _define_guard(type_name):
-    """
-    Returns True if the given type isn't defined in typing but
-    is defined in collections_abc.
-
-    Adds the type to __all__ if the collection is found in either
-    typing or collection_abc.
-    """
-    if hasattr(typing, type_name):
-        __all__.append(type_name)
-        globals()[type_name] = getattr(typing, type_name)
-        return False
-    elif hasattr(collections_abc, type_name):
-        __all__.append(type_name)
-        return True
-    else:
-        return False
-
 
 class _ExtensionsGenericMeta(GenericMeta):
     def __subclasscheck__(self, subclass):
@@ -782,12 +337,11 @@ class _ExtensionsGenericMeta(GenericMeta):
         between collections, typing, and typing_extensions on older
         versions of Python, see https://github.com/python/typing/issues/501.
         """
-        if sys.version_info[:3] >= (3, 5, 3) or sys.version_info[:3] < (3, 5, 0):
-            if self.__origin__ is not None:
-                if sys._getframe(1).f_globals['__name__'] not in ['abc', 'functools']:
-                    raise TypeError("Parameterized generics cannot be used with class "
-                                    "or instance checks")
-                return False
+        if self.__origin__ is not None:
+            if sys._getframe(1).f_globals['__name__'] not in ['abc', 'functools']:
+                raise TypeError("Parameterized generics cannot be used with class "
+                                "or instance checks")
+            return False
         if not self.__extra__:
             return super().__subclasscheck__(subclass)
         res = self.__extra__.__subclasshook__(subclass)
@@ -803,45 +357,15 @@ class _ExtensionsGenericMeta(GenericMeta):
         return False
 
 
-if _define_guard('Awaitable'):
-    class Awaitable(typing.Generic[T_co], metaclass=_ExtensionsGenericMeta,
-                    extra=collections_abc.Awaitable):
-        __slots__ = ()
-
-
-if _define_guard('Coroutine'):
-    class Coroutine(Awaitable[V_co], typing.Generic[T_co, T_contra, V_co],
-                    metaclass=_ExtensionsGenericMeta,
-                    extra=collections_abc.Coroutine):
-        __slots__ = ()
-
-
-if _define_guard('AsyncIterable'):
-    class AsyncIterable(typing.Generic[T_co],
-                        metaclass=_ExtensionsGenericMeta,
-                        extra=collections_abc.AsyncIterable):
-        __slots__ = ()
-
-
-if _define_guard('AsyncIterator'):
-    class AsyncIterator(AsyncIterable[T_co],
-                        metaclass=_ExtensionsGenericMeta,
-                        extra=collections_abc.AsyncIterator):
-        __slots__ = ()
-
+Awaitable = typing.Awaitable
+Coroutine = typing.Coroutine
+AsyncIterable = typing.AsyncIterable
+AsyncIterator = typing.AsyncIterator
 
+# 3.6.1+
 if hasattr(typing, 'Deque'):
     Deque = typing.Deque
-elif _geqv_defined:
-    class Deque(collections.deque, typing.MutableSequence[T],
-                metaclass=_ExtensionsGenericMeta,
-                extra=collections.deque):
-        __slots__ = ()
-
-        def __new__(cls, *args, **kwds):
-            if _geqv(cls, Deque):
-                return collections.deque(*args, **kwds)
-            return _generic_new(collections.deque, cls, *args, **kwds)
+# 3.6.0
 else:
     class Deque(collections.deque, typing.MutableSequence[T],
                 metaclass=_ExtensionsGenericMeta,
@@ -851,114 +375,41 @@ else:
         def __new__(cls, *args, **kwds):
             if cls._gorg is Deque:
                 return collections.deque(*args, **kwds)
-            return _generic_new(collections.deque, cls, *args, **kwds)
+            return typing._generic_new(collections.deque, cls, *args, **kwds)
 
-
-if hasattr(typing, 'ContextManager'):
-    ContextManager = typing.ContextManager
-elif hasattr(contextlib, 'AbstractContextManager'):
-    class ContextManager(typing.Generic[T_co],
-                         metaclass=_ExtensionsGenericMeta,
-                         extra=contextlib.AbstractContextManager):
-        __slots__ = ()
+ContextManager = typing.ContextManager
+# 3.6.2+
+if hasattr(typing, 'AsyncContextManager'):
+    AsyncContextManager = typing.AsyncContextManager
+# 3.6.0-3.6.1
 else:
-    class ContextManager(typing.Generic[T_co]):
+    from _collections_abc import _check_methods as _check_methods_in_mro  # noqa
+
+    class AsyncContextManager(typing.Generic[T_co]):
         __slots__ = ()
 
-        def __enter__(self):
+        async def __aenter__(self):
             return self
 
         @abc.abstractmethod
-        def __exit__(self, exc_type, exc_value, traceback):
+        async def __aexit__(self, exc_type, exc_value, traceback):
             return None
 
         @classmethod
         def __subclasshook__(cls, C):
-            if cls is ContextManager:
-                # In Python 3.6+, it is possible to set a method to None to
-                # explicitly indicate that the class does not implement an ABC
-                # (https://bugs.python.org/issue25958), but we do not support
-                # that pattern here because this fallback class is only used
-                # in Python 3.5 and earlier.
-                if (any("__enter__" in B.__dict__ for B in C.__mro__) and
-                    any("__exit__" in B.__dict__ for B in C.__mro__)):
-                    return True
+            if cls is AsyncContextManager:
+                return _check_methods_in_mro(C, "__aenter__", "__aexit__")
             return NotImplemented
 
+DefaultDict = typing.DefaultDict
 
-if hasattr(typing, 'AsyncContextManager'):
-    AsyncContextManager = typing.AsyncContextManager
-    __all__.append('AsyncContextManager')
-elif hasattr(contextlib, 'AbstractAsyncContextManager'):
-    class AsyncContextManager(typing.Generic[T_co],
-                              metaclass=_ExtensionsGenericMeta,
-                              extra=contextlib.AbstractAsyncContextManager):
-        __slots__ = ()
-
-    __all__.append('AsyncContextManager')
-elif sys.version_info[:2] >= (3, 5):
-    exec("""
-class AsyncContextManager(typing.Generic[T_co]):
-    __slots__ = ()
-
-    async def __aenter__(self):
-        return self
-
-    @abc.abstractmethod
-    async def __aexit__(self, exc_type, exc_value, traceback):
-        return None
-
-    @classmethod
-    def __subclasshook__(cls, C):
-        if cls is AsyncContextManager:
-            return _check_methods_in_mro(C, "__aenter__", "__aexit__")
-        return NotImplemented
-
-__all__.append('AsyncContextManager')
-""")
-
-
-if hasattr(typing, 'DefaultDict'):
-    DefaultDict = typing.DefaultDict
-elif _geqv_defined:
-    class DefaultDict(collections.defaultdict, typing.MutableMapping[KT, VT],
-                      metaclass=_ExtensionsGenericMeta,
-                      extra=collections.defaultdict):
-
-        __slots__ = ()
-
-        def __new__(cls, *args, **kwds):
-            if _geqv(cls, DefaultDict):
-                return collections.defaultdict(*args, **kwds)
-            return _generic_new(collections.defaultdict, cls, *args, **kwds)
-else:
-    class DefaultDict(collections.defaultdict, typing.MutableMapping[KT, VT],
-                      metaclass=_ExtensionsGenericMeta,
-                      extra=collections.defaultdict):
-
-        __slots__ = ()
-
-        def __new__(cls, *args, **kwds):
-            if cls._gorg is DefaultDict:
-                return collections.defaultdict(*args, **kwds)
-            return _generic_new(collections.defaultdict, cls, *args, **kwds)
-
-
+# 3.7.2+
 if hasattr(typing, 'OrderedDict'):
     OrderedDict = typing.OrderedDict
+# 3.7.0-3.7.2
 elif (3, 7, 0) <= sys.version_info[:3] < (3, 7, 2):
     OrderedDict = typing._alias(collections.OrderedDict, (KT, VT))
-elif _geqv_defined:
-    class OrderedDict(collections.OrderedDict, typing.MutableMapping[KT, VT],
-                      metaclass=_ExtensionsGenericMeta,
-                      extra=collections.OrderedDict):
-
-        __slots__ = ()
-
-        def __new__(cls, *args, **kwds):
-            if _geqv(cls, OrderedDict):
-                return collections.OrderedDict(*args, **kwds)
-            return _generic_new(collections.OrderedDict, cls, *args, **kwds)
+# 3.6
 else:
     class OrderedDict(collections.OrderedDict, typing.MutableMapping[KT, VT],
                       metaclass=_ExtensionsGenericMeta,
@@ -969,44 +420,12 @@ else:
         def __new__(cls, *args, **kwds):
             if cls._gorg is OrderedDict:
                 return collections.OrderedDict(*args, **kwds)
-            return _generic_new(collections.OrderedDict, cls, *args, **kwds)
-
+            return typing._generic_new(collections.OrderedDict, cls, *args, **kwds)
 
+# 3.6.2+
 if hasattr(typing, 'Counter'):
     Counter = typing.Counter
-elif (3, 5, 0) <= sys.version_info[:3] <= (3, 5, 1):
-    assert _geqv_defined
-    _TInt = typing.TypeVar('_TInt')
-
-    class _CounterMeta(typing.GenericMeta):
-        """Metaclass for Counter"""
-        def __getitem__(self, item):
-            return super().__getitem__((item, int))
-
-    class Counter(collections.Counter,
-                  typing.Dict[T, int],
-                  metaclass=_CounterMeta,
-                  extra=collections.Counter):
-
-        __slots__ = ()
-
-        def __new__(cls, *args, **kwds):
-            if _geqv(cls, Counter):
-                return collections.Counter(*args, **kwds)
-            return _generic_new(collections.Counter, cls, *args, **kwds)
-
-elif _geqv_defined:
-    class Counter(collections.Counter,
-                  typing.Dict[T, int],
-                  metaclass=_ExtensionsGenericMeta, extra=collections.Counter):
-
-        __slots__ = ()
-
-        def __new__(cls, *args, **kwds):
-            if _geqv(cls, Counter):
-                return collections.Counter(*args, **kwds)
-            return _generic_new(collections.Counter, cls, *args, **kwds)
-
+# 3.6.0-3.6.1
 else:
     class Counter(collections.Counter,
                   typing.Dict[T, int],
@@ -1017,88 +436,36 @@ else:
         def __new__(cls, *args, **kwds):
             if cls._gorg is Counter:
                 return collections.Counter(*args, **kwds)
-            return _generic_new(collections.Counter, cls, *args, **kwds)
-
+            return typing._generic_new(collections.Counter, cls, *args, **kwds)
 
+# 3.6.1+
 if hasattr(typing, 'ChainMap'):
     ChainMap = typing.ChainMap
-    __all__.append('ChainMap')
 elif hasattr(collections, 'ChainMap'):
-    # ChainMap only exists in 3.3+
-    if _geqv_defined:
-        class ChainMap(collections.ChainMap, typing.MutableMapping[KT, VT],
-                       metaclass=_ExtensionsGenericMeta,
-                       extra=collections.ChainMap):
+    class ChainMap(collections.ChainMap, typing.MutableMapping[KT, VT],
+                   metaclass=_ExtensionsGenericMeta,
+                   extra=collections.ChainMap):
 
-            __slots__ = ()
-
-            def __new__(cls, *args, **kwds):
-                if _geqv(cls, ChainMap):
-                    return collections.ChainMap(*args, **kwds)
-                return _generic_new(collections.ChainMap, cls, *args, **kwds)
-    else:
-        class ChainMap(collections.ChainMap, typing.MutableMapping[KT, VT],
-                       metaclass=_ExtensionsGenericMeta,
-                       extra=collections.ChainMap):
-
-            __slots__ = ()
-
-            def __new__(cls, *args, **kwds):
-                if cls._gorg is ChainMap:
-                    return collections.ChainMap(*args, **kwds)
-                return _generic_new(collections.ChainMap, cls, *args, **kwds)
-
-    __all__.append('ChainMap')
-
-
-if _define_guard('AsyncGenerator'):
-    class AsyncGenerator(AsyncIterator[T_co], typing.Generic[T_co, T_contra],
-                         metaclass=_ExtensionsGenericMeta,
-                         extra=collections_abc.AsyncGenerator):
         __slots__ = ()
 
+        def __new__(cls, *args, **kwds):
+            if cls._gorg is ChainMap:
+                return collections.ChainMap(*args, **kwds)
+            return typing._generic_new(collections.ChainMap, cls, *args, **kwds)
 
-if hasattr(typing, 'NewType'):
-    NewType = typing.NewType
+# 3.6.1+
+if hasattr(typing, 'AsyncGenerator'):
+    AsyncGenerator = typing.AsyncGenerator
+# 3.6.0
 else:
-    def NewType(name, tp):
-        """NewType creates simple unique types with almost zero
-        runtime overhead. NewType(name, tp) is considered a subtype of tp
-        by static type checkers. At runtime, NewType(name, tp) returns
-        a dummy function that simply returns its argument. Usage::
+    class AsyncGenerator(AsyncIterator[T_co], typing.Generic[T_co, T_contra],
+                         metaclass=_ExtensionsGenericMeta,
+                         extra=collections.abc.AsyncGenerator):
+        __slots__ = ()
 
-            UserId = NewType('UserId', int)
-
-            def name_by_id(user_id: UserId) -> str:
-                ...
-
-            UserId('user')          # Fails type check
-
-            name_by_id(42)          # Fails type check
-            name_by_id(UserId(42))  # OK
-
-            num = UserId(5) + 1     # type: int
-        """
-
-        def new_type(x):
-            return x
-
-        new_type.__name__ = name
-        new_type.__supertype__ = tp
-        return new_type
-
-
-if hasattr(typing, 'Text'):
-    Text = typing.Text
-else:
-    Text = str
-
-
-if hasattr(typing, 'TYPE_CHECKING'):
-    TYPE_CHECKING = typing.TYPE_CHECKING
-else:
-    # Constant that's True when type checking, but False here.
-    TYPE_CHECKING = False
+NewType = typing.NewType
+Text = typing.Text
+TYPE_CHECKING = typing.TYPE_CHECKING
 
 
 def _gorg(cls):
@@ -1111,16 +478,6 @@ def _gorg(cls):
     return cls
 
 
-if OLD_GENERICS:
-    def _next_in_mro(cls):  # noqa
-        """This function exists for compatibility with old typing versions."""
-        next_in_mro = object
-        for i, c in enumerate(cls.__mro__[:-1]):
-            if isinstance(c, GenericMeta) and _gorg(c) is Generic:
-                next_in_mro = cls.__mro__[i + 1]
-        return next_in_mro
-
-
 _PROTO_WHITELIST = ['Callable', 'Awaitable',
                     'Iterable', 'Iterator', 'AsyncIterable', 'AsyncIterator',
                     'Hashable', 'Sized', 'Container', 'Collection', 'Reversible',
@@ -1150,9 +507,196 @@ def _is_callable_members_only(cls):
     return all(callable(getattr(cls, attr, None)) for attr in _get_protocol_attrs(cls))
 
 
+# 3.8+
 if hasattr(typing, 'Protocol'):
     Protocol = typing.Protocol
-elif HAVE_PROTOCOLS and not PEP_560:
+# 3.7
+elif PEP_560:
+    from typing import _collect_type_vars  # noqa
+
+    def _no_init(self, *args, **kwargs):
+        if type(self)._is_protocol:
+            raise TypeError('Protocols cannot be instantiated')
+
+    class _ProtocolMeta(abc.ABCMeta):
+        # This metaclass is a bit unfortunate and exists only because of the lack
+        # of __instancehook__.
+        def __instancecheck__(cls, instance):
+            # We need this method for situations where attributes are
+            # assigned in __init__.
+            if ((not getattr(cls, '_is_protocol', False) or
+                 _is_callable_members_only(cls)) and
+                    issubclass(instance.__class__, cls)):
+                return True
+            if cls._is_protocol:
+                if all(hasattr(instance, attr) and
+                       (not callable(getattr(cls, attr, None)) or
+                        getattr(instance, attr) is not None)
+                       for attr in _get_protocol_attrs(cls)):
+                    return True
+            return super().__instancecheck__(instance)
+
+    class Protocol(metaclass=_ProtocolMeta):
+        # There is quite a lot of overlapping code with typing.Generic.
+        # Unfortunately it is hard to avoid this while these live in two different
+        # modules. The duplicated code will be removed when Protocol is moved to typing.
+        """Base class for protocol classes. Protocol classes are defined as::
+
+            class Proto(Protocol):
+                def meth(self) -> int:
+                    ...
+
+        Such classes are primarily used with static type checkers that recognize
+        structural subtyping (static duck-typing), for example::
+
+            class C:
+                def meth(self) -> int:
+                    return 0
+
+            def func(x: Proto) -> int:
+                return x.meth()
+
+            func(C())  # Passes static type check
+
+        See PEP 544 for details. Protocol classes decorated with
+        @typing_extensions.runtime act as simple-minded runtime protocol that checks
+        only the presence of given attributes, ignoring their type signatures.
+
+        Protocol classes can be generic, they are defined as::
+
+            class GenProto(Protocol[T]):
+                def meth(self) -> T:
+                    ...
+        """
+        __slots__ = ()
+        _is_protocol = True
+
+        def __new__(cls, *args, **kwds):
+            if cls is Protocol:
+                raise TypeError("Type Protocol cannot be instantiated; "
+                                "it can only be used as a base class")
+            return super().__new__(cls)
+
+        @typing._tp_cache
+        def __class_getitem__(cls, params):
+            if not isinstance(params, tuple):
+                params = (params,)
+            if not params and cls is not typing.Tuple:
+                raise TypeError(
+                    f"Parameter list to {cls.__qualname__}[...] cannot be empty")
+            msg = "Parameters to generic types must be types."
+            params = tuple(typing._type_check(p, msg) for p in params)  # noqa
+            if cls is Protocol:
+                # Generic can only be subscripted with unique type variables.
+                if not all(isinstance(p, typing.TypeVar) for p in params):
+                    i = 0
+                    while isinstance(params[i], typing.TypeVar):
+                        i += 1
+                    raise TypeError(
+                        "Parameters to Protocol[...] must all be type variables."
+                        f" Parameter {i + 1} is {params[i]}")
+                if len(set(params)) != len(params):
+                    raise TypeError(
+                        "Parameters to Protocol[...] must all be unique")
+            else:
+                # Subscripting a regular Generic subclass.
+                _check_generic(cls, params)
+            return typing._GenericAlias(cls, params)
+
+        def __init_subclass__(cls, *args, **kwargs):
+            tvars = []
+            if '__orig_bases__' in cls.__dict__:
+                error = typing.Generic in cls.__orig_bases__
+            else:
+                error = typing.Generic in cls.__bases__
+            if error:
+                raise TypeError("Cannot inherit from plain Generic")
+            if '__orig_bases__' in cls.__dict__:
+                tvars = _collect_type_vars(cls.__orig_bases__)
+                # Look for Generic[T1, ..., Tn] or Protocol[T1, ..., Tn].
+                # If found, tvars must be a subset of it.
+                # If not found, tvars is it.
+                # Also check for and reject plain Generic,
+                # and reject multiple Generic[...] and/or Protocol[...].
+                gvars = None
+                for base in cls.__orig_bases__:
+                    if (isinstance(base, typing._GenericAlias) and
+                            base.__origin__ in (typing.Generic, Protocol)):
+                        # for error messages
+                        the_base = base.__origin__.__name__
+                        if gvars is not None:
+                            raise TypeError(
+                                "Cannot inherit from Generic[...]"
+                                " and/or Protocol[...] multiple types.")
+                        gvars = base.__parameters__
+                if gvars is None:
+                    gvars = tvars
+                else:
+                    tvarset = set(tvars)
+                    gvarset = set(gvars)
+                    if not tvarset <= gvarset:
+                        s_vars = ', '.join(str(t) for t in tvars if t not in gvarset)
+                        s_args = ', '.join(str(g) for g in gvars)
+                        raise TypeError(f"Some type variables ({s_vars}) are"
+                                        f" not listed in {the_base}[{s_args}]")
+                    tvars = gvars
+            cls.__parameters__ = tuple(tvars)
+
+            # Determine if this is a protocol or a concrete subclass.
+            if not cls.__dict__.get('_is_protocol', None):
+                cls._is_protocol = any(b is Protocol for b in cls.__bases__)
+
+            # Set (or override) the protocol subclass hook.
+            def _proto_hook(other):
+                if not cls.__dict__.get('_is_protocol', None):
+                    return NotImplemented
+                if not getattr(cls, '_is_runtime_protocol', False):
+                    if sys._getframe(2).f_globals['__name__'] in ['abc', 'functools']:
+                        return NotImplemented
+                    raise TypeError("Instance and class checks can only be used with"
+                                    " @runtime protocols")
+                if not _is_callable_members_only(cls):
+                    if sys._getframe(2).f_globals['__name__'] in ['abc', 'functools']:
+                        return NotImplemented
+                    raise TypeError("Protocols with non-method members"
+                                    " don't support issubclass()")
+                if not isinstance(other, type):
+                    # Same error as for issubclass(1, int)
+                    raise TypeError('issubclass() arg 1 must be a class')
+                for attr in _get_protocol_attrs(cls):
+                    for base in other.__mro__:
+                        if attr in base.__dict__:
+                            if base.__dict__[attr] is None:
+                                return NotImplemented
+                            break
+                        annotations = getattr(base, '__annotations__', {})
+                        if (isinstance(annotations, typing.Mapping) and
+                                attr in annotations and
+                                isinstance(other, _ProtocolMeta) and
+                                other._is_protocol):
+                            break
+                    else:
+                        return NotImplemented
+                return True
+            if '__subclasshook__' not in cls.__dict__:
+                cls.__subclasshook__ = _proto_hook
+
+            # We have nothing more to do for non-protocols.
+            if not cls._is_protocol:
+                return
+
+            # Check consistency of bases.
+            for base in cls.__bases__:
+                if not (base in (object, typing.Generic) or
+                        base.__module__ == 'collections.abc' and
+                        base.__name__ in _PROTO_WHITELIST or
+                        isinstance(base, _ProtocolMeta) and base._is_protocol):
+                    raise TypeError('Protocols can only inherit from other'
+                                    f' protocols, got {repr(base)}')
+            cls.__init__ = _no_init
+# 3.6
+else:
+    from typing import _next_in_mro, _type_check  # noqa
 
     def _no_init(self, *args, **kwargs):
         if type(self)._is_protocol:
@@ -1164,71 +708,69 @@ elif HAVE_PROTOCOLS and not PEP_560:
         This exists so Protocol classes can be generic without deriving
         from Generic.
         """
-        if not OLD_GENERICS:
-            def __new__(cls, name, bases, namespace,
-                        tvars=None, args=None, origin=None, extra=None, orig_bases=None):
-                # This is just a version copied from GenericMeta.__new__ that
-                # includes "Protocol" special treatment. (Comments removed for brevity.)
-                assert extra is None  # Protocols should not have extra
-                if tvars is not None:
-                    assert origin is not None
-                    assert all(isinstance(t, TypeVar) for t in tvars), tvars
-                else:
-                    tvars = _type_vars(bases)
-                    gvars = None
-                    for base in bases:
-                        if base is Generic:
-                            raise TypeError("Cannot inherit from plain Generic")
-                        if (isinstance(base, GenericMeta) and
-                                base.__origin__ in (Generic, Protocol)):
-                            if gvars is not None:
-                                raise TypeError(
-                                    "Cannot inherit from Generic[...] or"
-                                    " Protocol[...] multiple times.")
-                            gvars = base.__parameters__
-                    if gvars is None:
-                        gvars = tvars
-                    else:
-                        tvarset = set(tvars)
-                        gvarset = set(gvars)
-                        if not tvarset <= gvarset:
+        def __new__(cls, name, bases, namespace,
+                    tvars=None, args=None, origin=None, extra=None, orig_bases=None):
+            # This is just a version copied from GenericMeta.__new__ that
+            # includes "Protocol" special treatment. (Comments removed for brevity.)
+            assert extra is None  # Protocols should not have extra
+            if tvars is not None:
+                assert origin is not None
+                assert all(isinstance(t, typing.TypeVar) for t in tvars), tvars
+            else:
+                tvars = _type_vars(bases)
+                gvars = None
+                for base in bases:
+                    if base is typing.Generic:
+                        raise TypeError("Cannot inherit from plain Generic")
+                    if (isinstance(base, GenericMeta) and
+                            base.__origin__ in (typing.Generic, Protocol)):
+                        if gvars is not None:
                             raise TypeError(
-                                "Some type variables (%s) "
-                                "are not listed in %s[%s]" %
-                                (", ".join(str(t) for t in tvars if t not in gvarset),
-                                 "Generic" if any(b.__origin__ is Generic
-                                                  for b in bases) else "Protocol",
-                                 ", ".join(str(g) for g in gvars)))
-                        tvars = gvars
+                                "Cannot inherit from Generic[...] or"
+                                " Protocol[...] multiple times.")
+                        gvars = base.__parameters__
+                if gvars is None:
+                    gvars = tvars
+                else:
+                    tvarset = set(tvars)
+                    gvarset = set(gvars)
+                    if not tvarset <= gvarset:
+                        s_vars = ", ".join(str(t) for t in tvars if t not in gvarset)
+                        s_args = ", ".join(str(g) for g in gvars)
+                        cls_name = "Generic" if any(b.__origin__ is typing.Generic
+                                                    for b in bases) else "Protocol"
+                        raise TypeError(f"Some type variables ({s_vars}) are"
+                                        f" not listed in {cls_name}[{s_args}]")
+                    tvars = gvars
 
-                initial_bases = bases
-                if (extra is not None and type(extra) is abc.ABCMeta and
-                        extra not in bases):
-                    bases = (extra,) + bases
-                bases = tuple(_gorg(b) if isinstance(b, GenericMeta) else b
-                              for b in bases)
-                if any(isinstance(b, GenericMeta) and b is not Generic for b in bases):
-                    bases = tuple(b for b in bases if b is not Generic)
-                namespace.update({'__origin__': origin, '__extra__': extra})
-                self = super(GenericMeta, cls).__new__(cls, name, bases, namespace,
-                                                       _root=True)
-                super(GenericMeta, self).__setattr__('_gorg',
-                                                     self if not origin else
-                                                     _gorg(origin))
-                self.__parameters__ = tvars
-                self.__args__ = tuple(... if a is _TypingEllipsis else
-                                      () if a is _TypingEmpty else
-                                      a for a in args) if args else None
-                self.__next_in_mro__ = _next_in_mro(self)
-                if orig_bases is None:
-                    self.__orig_bases__ = initial_bases
-                elif origin is not None:
-                    self._abc_registry = origin._abc_registry
-                    self._abc_cache = origin._abc_cache
-                if hasattr(self, '_subs_tree'):
-                    self.__tree_hash__ = (hash(self._subs_tree()) if origin else
-                                          super(GenericMeta, self).__hash__())
-                return self
+            initial_bases = bases
+            if (extra is not None and type(extra) is abc.ABCMeta and
+                    extra not in bases):
+                bases = (extra,) + bases
+            bases = tuple(_gorg(b) if isinstance(b, GenericMeta) else b
+                          for b in bases)
+            if any(isinstance(b, GenericMeta) and b is not typing.Generic for b in bases):
+                bases = tuple(b for b in bases if b is not typing.Generic)
+            namespace.update({'__origin__': origin, '__extra__': extra})
+            self = super(GenericMeta, cls).__new__(cls, name, bases, namespace,
+                                                   _root=True)
+            super(GenericMeta, self).__setattr__('_gorg',
+                                                 self if not origin else
+                                                 _gorg(origin))
+            self.__parameters__ = tvars
+            self.__args__ = tuple(... if a is typing._TypingEllipsis else
+                                  () if a is typing._TypingEmpty else
+                                  a for a in args) if args else None
+            self.__next_in_mro__ = _next_in_mro(self)
+            if orig_bases is None:
+                self.__orig_bases__ = initial_bases
+            elif origin is not None:
+                self._abc_registry = origin._abc_registry
+                self._abc_cache = origin._abc_cache
+            if hasattr(self, '_subs_tree'):
+                self.__tree_hash__ = (hash(self._subs_tree()) if origin else
+                                      super(GenericMeta, self).__hash__())
+            return self
 
         def __init__(cls, *args, **kwargs):
             super().__init__(*args, **kwargs)
@@ -1239,14 +781,14 @@ elif HAVE_PROTOCOLS and not PEP_560:
                                        for b in cls.__bases__)
             if cls._is_protocol:
                 for base in cls.__mro__[1:]:
-                    if not (base in (object, Generic) or
+                    if not (base in (object, typing.Generic) or
                             base.__module__ == 'collections.abc' and
                             base.__name__ in _PROTO_WHITELIST or
-                            isinstance(base, TypingMeta) and base._is_protocol or
+                            isinstance(base, typing.TypingMeta) and base._is_protocol or
                             isinstance(base, GenericMeta) and
-                            base.__origin__ is Generic):
-                        raise TypeError('Protocols can only inherit from other'
-                                        ' protocols, got %r' % base)
+                            base.__origin__ is typing.Generic):
+                        raise TypeError(f'Protocols can only inherit from other'
+                                        f' protocols, got {repr(base)}')
 
                 cls.__init__ = _no_init
 
@@ -1313,47 +855,45 @@ elif HAVE_PROTOCOLS and not PEP_560:
                                 " don't support issubclass()")
             return super(GenericMeta, self).__subclasscheck__(cls)
 
-        if not OLD_GENERICS:
-            @_tp_cache
-            def __getitem__(self, params):
-                # We also need to copy this from GenericMeta.__getitem__ to get
-                # special treatment of "Protocol". (Comments removed for brevity.)
-                if not isinstance(params, tuple):
-                    params = (params,)
-                if not params and _gorg(self) is not Tuple:
+        @typing._tp_cache
+        def __getitem__(self, params):
+            # We also need to copy this from GenericMeta.__getitem__ to get
+            # special treatment of "Protocol". (Comments removed for brevity.)
+            if not isinstance(params, tuple):
+                params = (params,)
+            if not params and _gorg(self) is not typing.Tuple:
+                raise TypeError(
+                    f"Parameter list to {self.__qualname__}[...] cannot be empty")
+            msg = "Parameters to generic types must be types."
+            params = tuple(_type_check(p, msg) for p in params)
+            if self in (typing.Generic, Protocol):
+                if not all(isinstance(p, typing.TypeVar) for p in params):
                     raise TypeError(
-                        "Parameter list to %s[...] cannot be empty" % self.__qualname__)
-                msg = "Parameters to generic types must be types."
-                params = tuple(_type_check(p, msg) for p in params)
-                if self in (Generic, Protocol):
-                    if not all(isinstance(p, TypeVar) for p in params):
-                        raise TypeError(
-                            "Parameters to %r[...] must all be type variables" % self)
-                    if len(set(params)) != len(params):
-                        raise TypeError(
-                            "Parameters to %r[...] must all be unique" % self)
-                    tvars = params
-                    args = params
-                elif self in (Tuple, Callable):
-                    tvars = _type_vars(params)
-                    args = params
-                elif self.__origin__ in (Generic, Protocol):
-                    raise TypeError("Cannot subscript already-subscripted %s" %
-                                    repr(self))
-                else:
-                    _check_generic(self, params)
-                    tvars = _type_vars(params)
-                    args = params
+                        f"Parameters to {repr(self)}[...] must all be type variables")
+                if len(set(params)) != len(params):
+                    raise TypeError(
+                        f"Parameters to {repr(self)}[...] must all be unique")
+                tvars = params
+                args = params
+            elif self in (typing.Tuple, typing.Callable):
+                tvars = _type_vars(params)
+                args = params
+            elif self.__origin__ in (typing.Generic, Protocol):
+                raise TypeError(f"Cannot subscript already-subscripted {repr(self)}")
+            else:
+                _check_generic(self, params)
+                tvars = _type_vars(params)
+                args = params
 
-                prepend = (self,) if self.__origin__ is None else ()
-                return self.__class__(self.__name__,
-                                      prepend + self.__bases__,
-                                      _no_slots_copy(self.__dict__),
-                                      tvars=tvars,
-                                      args=args,
-                                      origin=self,
-                                      extra=self.__extra__,
-                                      orig_bases=self.__orig_bases__)
+            prepend = (self,) if self.__origin__ is None else ()
+            return self.__class__(self.__name__,
+                                  prepend + self.__bases__,
+                                  _no_slots_copy(self.__dict__),
+                                  tvars=tvars,
+                                  args=args,
+                                  origin=self,
+                                  extra=self.__extra__,
+                                  orig_bases=self.__orig_bases__)
 
     class Protocol(metaclass=_ProtocolMeta):
         """Base class for protocol classes. Protocol classes are defined as::
@@ -1380,7 +920,7 @@ elif HAVE_PROTOCOLS and not PEP_560:
 
         Protocol classes can be generic, they are defined as::
 
-          class GenProto({bases}):
+          class GenProto(Protocol[T]):
               def meth(self) -> T:
                   ...
         """
@@ -1391,203 +931,14 @@ elif HAVE_PROTOCOLS and not PEP_560:
             if _gorg(cls) is Protocol:
                 raise TypeError("Type Protocol cannot be instantiated; "
                                 "it can be used only as a base class")
-            if OLD_GENERICS:
-                return _generic_new(_next_in_mro(cls), cls, *args, **kwds)
-            return _generic_new(cls.__next_in_mro__, cls, *args, **kwds)
-    if Protocol.__doc__ is not None:
-        Protocol.__doc__ = Protocol.__doc__.format(bases="Protocol, Generic[T]" if
-                                                   OLD_GENERICS else "Protocol[T]")
-
-
-elif PEP_560:
-    from typing import _type_check, _collect_type_vars  # noqa
-
-    def _no_init(self, *args, **kwargs):
-        if type(self)._is_protocol:
-            raise TypeError('Protocols cannot be instantiated')
-
-    class _ProtocolMeta(abc.ABCMeta):
-        # This metaclass is a bit unfortunate and exists only because of the lack
-        # of __instancehook__.
-        def __instancecheck__(cls, instance):
-            # We need this method for situations where attributes are
-            # assigned in __init__.
-            if ((not getattr(cls, '_is_protocol', False) or
-                    _is_callable_members_only(cls)) and
-                    issubclass(instance.__class__, cls)):
-                return True
-            if cls._is_protocol:
-                if all(hasattr(instance, attr) and
-                        (not callable(getattr(cls, attr, None)) or
-                         getattr(instance, attr) is not None)
-                        for attr in _get_protocol_attrs(cls)):
-                    return True
-            return super().__instancecheck__(instance)
-
-    class Protocol(metaclass=_ProtocolMeta):
-        # There is quite a lot of overlapping code with typing.Generic.
-        # Unfortunately it is hard to avoid this while these live in two different
-        # modules. The duplicated code will be removed when Protocol is moved to typing.
-        """Base class for protocol classes. Protocol classes are defined as::
-
-            class Proto(Protocol):
-                def meth(self) -> int:
-                    ...
-
-        Such classes are primarily used with static type checkers that recognize
-        structural subtyping (static duck-typing), for example::
-
-            class C:
-                def meth(self) -> int:
-                    return 0
-
-            def func(x: Proto) -> int:
-                return x.meth()
-
-            func(C())  # Passes static type check
-
-        See PEP 544 for details. Protocol classes decorated with
-        @typing_extensions.runtime act as simple-minded runtime protocol that checks
-        only the presence of given attributes, ignoring their type signatures.
-
-        Protocol classes can be generic, they are defined as::
-
-            class GenProto(Protocol[T]):
-                def meth(self) -> T:
-                    ...
-        """
-        __slots__ = ()
-        _is_protocol = True
-
-        def __new__(cls, *args, **kwds):
-            if cls is Protocol:
-                raise TypeError("Type Protocol cannot be instantiated; "
-                                "it can only be used as a base class")
-            return super().__new__(cls)
-
-        @_tp_cache
-        def __class_getitem__(cls, params):
-            if not isinstance(params, tuple):
-                params = (params,)
-            if not params and cls is not Tuple:
-                raise TypeError(
-                    "Parameter list to {}[...] cannot be empty".format(cls.__qualname__))
-            msg = "Parameters to generic types must be types."
-            params = tuple(_type_check(p, msg) for p in params)
-            if cls is Protocol:
-                # Generic can only be subscripted with unique type variables.
-                if not all(isinstance(p, TypeVar) for p in params):
-                    i = 0
-                    while isinstance(params[i], TypeVar):
-                        i += 1
-                    raise TypeError(
-                        "Parameters to Protocol[...] must all be type variables."
-                        " Parameter {} is {}".format(i + 1, params[i]))
-                if len(set(params)) != len(params):
-                    raise TypeError(
-                        "Parameters to Protocol[...] must all be unique")
-            else:
-                # Subscripting a regular Generic subclass.
-                _check_generic(cls, params)
-            return _GenericAlias(cls, params)
-
-        def __init_subclass__(cls, *args, **kwargs):
-            tvars = []
-            if '__orig_bases__' in cls.__dict__:
-                error = Generic in cls.__orig_bases__
-            else:
-                error = Generic in cls.__bases__
-            if error:
-                raise TypeError("Cannot inherit from plain Generic")
-            if '__orig_bases__' in cls.__dict__:
-                tvars = _collect_type_vars(cls.__orig_bases__)
-                # Look for Generic[T1, ..., Tn] or Protocol[T1, ..., Tn].
-                # If found, tvars must be a subset of it.
-                # If not found, tvars is it.
-                # Also check for and reject plain Generic,
-                # and reject multiple Generic[...] and/or Protocol[...].
-                gvars = None
-                for base in cls.__orig_bases__:
-                    if (isinstance(base, _GenericAlias) and
-                            base.__origin__ in (Generic, Protocol)):
-                        # for error messages
-                        the_base = 'Generic' if base.__origin__ is Generic else 'Protocol'
-                        if gvars is not None:
-                            raise TypeError(
-                                "Cannot inherit from Generic[...]"
-                                " and/or Protocol[...] multiple types.")
-                        gvars = base.__parameters__
-                if gvars is None:
-                    gvars = tvars
-                else:
-                    tvarset = set(tvars)
-                    gvarset = set(gvars)
-                    if not tvarset <= gvarset:
-                        s_vars = ', '.join(str(t) for t in tvars if t not in gvarset)
-                        s_args = ', '.join(str(g) for g in gvars)
-                        raise TypeError("Some type variables ({}) are"
-                                        " not listed in {}[{}]".format(s_vars,
-                                                                       the_base, s_args))
-                    tvars = gvars
-            cls.__parameters__ = tuple(tvars)
-
-            # Determine if this is a protocol or a concrete subclass.
-            if not cls.__dict__.get('_is_protocol', None):
-                cls._is_protocol = any(b is Protocol for b in cls.__bases__)
-
-            # Set (or override) the protocol subclass hook.
-            def _proto_hook(other):
-                if not cls.__dict__.get('_is_protocol', None):
-                    return NotImplemented
-                if not getattr(cls, '_is_runtime_protocol', False):
-                    if sys._getframe(2).f_globals['__name__'] in ['abc', 'functools']:
-                        return NotImplemented
-                    raise TypeError("Instance and class checks can only be used with"
-                                    " @runtime protocols")
-                if not _is_callable_members_only(cls):
-                    if sys._getframe(2).f_globals['__name__'] in ['abc', 'functools']:
-                        return NotImplemented
-                    raise TypeError("Protocols with non-method members"
-                                    " don't support issubclass()")
-                if not isinstance(other, type):
-                    # Same error as for issubclass(1, int)
-                    raise TypeError('issubclass() arg 1 must be a class')
-                for attr in _get_protocol_attrs(cls):
-                    for base in other.__mro__:
-                        if attr in base.__dict__:
-                            if base.__dict__[attr] is None:
-                                return NotImplemented
-                            break
-                        annotations = getattr(base, '__annotations__', {})
-                        if (isinstance(annotations, typing.Mapping) and
-                                attr in annotations and
-                                isinstance(other, _ProtocolMeta) and
-                                other._is_protocol):
-                            break
-                    else:
-                        return NotImplemented
-                return True
-            if '__subclasshook__' not in cls.__dict__:
-                cls.__subclasshook__ = _proto_hook
-
-            # We have nothing more to do for non-protocols.
-            if not cls._is_protocol:
-                return
-
-            # Check consistency of bases.
-            for base in cls.__bases__:
-                if not (base in (object, Generic) or
-                        base.__module__ == 'collections.abc' and
-                        base.__name__ in _PROTO_WHITELIST or
-                        isinstance(base, _ProtocolMeta) and base._is_protocol):
-                    raise TypeError('Protocols can only inherit from other'
-                                    ' protocols, got %r' % base)
-            cls.__init__ = _no_init
+            return typing._generic_new(cls.__next_in_mro__, cls, *args, **kwds)
 
 
+# 3.8+
 if hasattr(typing, 'runtime_checkable'):
     runtime_checkable = typing.runtime_checkable
-elif HAVE_PROTOCOLS:
+# 3.6-3.7
+else:
     def runtime_checkable(cls):
         """Mark a protocol class as a runtime protocol, so that it
         can be used with isinstance() and issubclass(). Raise TypeError
@@ -1598,19 +949,20 @@ elif HAVE_PROTOCOLS:
         """
         if not isinstance(cls, _ProtocolMeta) or not cls._is_protocol:
             raise TypeError('@runtime_checkable can be only applied to protocol classes,'
-                            ' got %r' % cls)
+                            f' got {cls!r}')
         cls._is_runtime_protocol = True
         return cls
 
 
-if HAVE_PROTOCOLS:
-    # Exists for backwards compatibility.
-    runtime = runtime_checkable
+# Exists for backwards compatibility.
+runtime = runtime_checkable
 
 
+# 3.8+
 if hasattr(typing, 'SupportsIndex'):
     SupportsIndex = typing.SupportsIndex
-elif HAVE_PROTOCOLS:
+# 3.6-3.7
+else:
     @runtime_checkable
     class SupportsIndex(Protocol):
         __slots__ = ()
@@ -1665,8 +1017,8 @@ else:
                 fields, = args  # allow the "_fields" keyword be passed
             except ValueError:
                 raise TypeError('TypedDict.__new__() takes from 2 to 3 '
-                                'positional arguments but {} '
-                                'were given'.format(len(args) + 2))
+                                f'positional arguments but {len(args) + 2} '
+                                'were given')
         elif '_fields' in kwargs and len(kwargs) == 1:
             fields = kwargs.pop('_fields')
             import warnings
@@ -1695,10 +1047,7 @@ else:
 
     class _TypedDictMeta(type):
         def __init__(cls, name, bases, ns, total=True):
-            # In Python 3.4 and 3.5 the __init__ method also needs to support the
-            # keyword arguments.
-            # See https://www.python.org/dev/peps/pep-0487/#implementation-details
-            super(_TypedDictMeta, cls).__init__(name, bases, ns)
+            super().__init__(name, bases, ns)
 
         def __new__(cls, name, bases, ns, total=True):
             # Create new typed dict class object.
@@ -1708,7 +1057,7 @@ else:
             # Subclasses and instances of TypedDict return actual dictionaries
             # via _dict_new.
             ns['__new__'] = _typeddict_new if name == 'TypedDict' else _dict_new
-            tp_dict = super(_TypedDictMeta, cls).__new__(cls, name, (dict,), ns)
+            tp_dict = super().__new__(cls, name, (dict,), ns)
 
             annotations = {}
             own_annotations = ns.get('__annotations__', {})
@@ -1780,6 +1129,7 @@ if hasattr(typing, 'Annotated'):
     # Not exported and not a public API, but needed for get_origin() and get_args()
     # to work.
     _AnnotatedAlias = typing._AnnotatedAlias
+# 3.7-3.8
 elif PEP_560:
     class _AnnotatedAlias(typing._GenericAlias, _root=True):
         """Runtime representation of an annotated type.
@@ -1802,10 +1152,8 @@ elif PEP_560:
             return _AnnotatedAlias(new_type, self.__metadata__)
 
         def __repr__(self):
-            return "typing_extensions.Annotated[{}, {}]".format(
-                typing._type_repr(self.__origin__),
-                ", ".join(repr(a) for a in self.__metadata__)
-            )
+            return (f"typing_extensions.Annotated[{typing._type_repr(self.__origin__)}, "
+                    f"{', '.join(repr(a) for a in self.__metadata__)}]")
 
         def __reduce__(self):
             return operator.getitem, (
@@ -1860,7 +1208,7 @@ elif PEP_560:
         def __new__(cls, *args, **kwargs):
             raise TypeError("Type Annotated cannot be instantiated.")
 
-        @_tp_cache
+        @typing._tp_cache
         def __class_getitem__(cls, params):
             if not isinstance(params, tuple) or len(params) < 2:
                 raise TypeError("Annotated[...] should be used "
@@ -1873,7 +1221,7 @@ elif PEP_560:
 
         def __init_subclass__(cls, *args, **kwargs):
             raise TypeError(
-                "Cannot subclass {}.Annotated".format(cls.__module__)
+                f"Cannot subclass {cls.__module__}.Annotated"
             )
 
     def _strip_annotations(t):
@@ -1925,8 +1273,8 @@ elif PEP_560:
         if include_extras:
             return hint
         return {k: _strip_annotations(t) for k, t in hint.items()}
-
-elif HAVE_ANNOTATED:
+# 3.6
+else:
 
     def _is_dunder(name):
         """Returns True if name is a __dunder_variable_name__."""
@@ -1955,7 +1303,7 @@ elif HAVE_ANNOTATED:
             else:
                 tp_repr = origin[0]._tree_repr(origin)
             metadata_reprs = ", ".join(repr(arg) for arg in metadata)
-            return '%s[%s, %s]' % (cls, tp_repr, metadata_reprs)
+            return f'{cls}[{tp_repr}, {metadata_reprs}]'
 
         def _subs_tree(self, tvars=None, args=None):  # noqa
             if self is Annotated:
@@ -1981,7 +1329,7 @@ elif HAVE_ANNOTATED:
             else:
                 return tree
 
-        @_tp_cache
+        @typing._tp_cache
         def __getitem__(self, params):
             if not isinstance(params, tuple):
                 params = (params,)
@@ -2067,23 +1415,23 @@ elif HAVE_ANNOTATED:
         """
 
 # Python 3.8 has get_origin() and get_args() but those implementations aren't
-# Annotated-aware, so we can't use those, only Python 3.9 versions will do.
-# Similarly, Python 3.9's implementation doesn't support ParamSpecArgs and
-# ParamSpecKwargs.
+# Annotated-aware, so we can't use those. Python 3.9's versions don't support
+# ParamSpecArgs and ParamSpecKwargs, so only Python 3.10's versions will do.
 if sys.version_info[:2] >= (3, 10):
     get_origin = typing.get_origin
     get_args = typing.get_args
+# 3.7-3.9
 elif PEP_560:
     try:
         # 3.9+
         from typing import _BaseGenericAlias
     except ImportError:
-        _BaseGenericAlias = _GenericAlias
+        _BaseGenericAlias = typing._GenericAlias
     try:
         # 3.9+
         from typing import GenericAlias
     except ImportError:
-        GenericAlias = _GenericAlias
+        GenericAlias = typing._GenericAlias
 
     def get_origin(tp):
         """Get the unsubscripted version of a type.
@@ -2102,11 +1450,11 @@ elif PEP_560:
         """
         if isinstance(tp, _AnnotatedAlias):
             return Annotated
-        if isinstance(tp, (_GenericAlias, GenericAlias, _BaseGenericAlias,
+        if isinstance(tp, (typing._GenericAlias, GenericAlias, _BaseGenericAlias,
                            ParamSpecArgs, ParamSpecKwargs)):
             return tp.__origin__
-        if tp is Generic:
-            return Generic
+        if tp is typing.Generic:
+            return typing.Generic
         return None
 
     def get_args(tp):
@@ -2122,7 +1470,7 @@ elif PEP_560:
         """
         if isinstance(tp, _AnnotatedAlias):
             return (tp.__origin__,) + tp.__metadata__
-        if isinstance(tp, (_GenericAlias, GenericAlias)):
+        if isinstance(tp, (typing._GenericAlias, GenericAlias)):
             if getattr(tp, "_special", False):
                 return ()
             res = tp.__args__
@@ -2132,8 +1480,10 @@ elif PEP_560:
         return ()
 
 
+# 3.10+
 if hasattr(typing, 'TypeAlias'):
     TypeAlias = typing.TypeAlias
+# 3.9
 elif sys.version_info[:2] >= (3, 9):
     class _TypeAliasForm(typing._SpecialForm, _root=True):
         def __repr__(self):
@@ -2151,8 +1501,8 @@ elif sys.version_info[:2] >= (3, 9):
 
         It's invalid when used anywhere except as in the example above.
         """
-        raise TypeError("{} is not subscriptable".format(self))
-
+        raise TypeError(f"{self} is not subscriptable")
+# 3.7-3.8
 elif sys.version_info[:2] >= (3, 7):
     class _TypeAliasForm(typing._SpecialForm, _root=True):
         def __repr__(self):
@@ -2169,8 +1519,8 @@ elif sys.version_info[:2] >= (3, 7):
 
                                It's invalid when used anywhere except as in the example
                                above.""")
-
-elif hasattr(typing, '_FinalTypingBase'):
+# 3.6
+else:
     class _TypeAliasMeta(typing.TypingMeta):
         """Metaclass for TypeAlias"""
 
@@ -2200,37 +1550,13 @@ elif hasattr(typing, '_FinalTypingBase'):
             return 'typing_extensions.TypeAlias'
 
     TypeAlias = _TypeAliasBase(_root=True)
-else:
-    class _TypeAliasMeta(typing.TypingMeta):
-        """Metaclass for TypeAlias"""
-
-        def __instancecheck__(self, obj):
-            raise TypeError("TypeAlias cannot be used with isinstance().")
-
-        def __subclasscheck__(self, cls):
-            raise TypeError("TypeAlias cannot be used with issubclass().")
-
-        def __call__(self, *args, **kwargs):
-            raise TypeError("Cannot instantiate TypeAlias")
-
-    class TypeAlias(metaclass=_TypeAliasMeta, _root=True):
-        """Special marker indicating that an assignment should
-        be recognized as a proper type alias definition by type
-        checkers.
-
-        For example::
-
-            Predicate: TypeAlias = Callable[..., bool]
-
-        It's invalid when used anywhere except as in the example above.
-        """
-        __slots__ = ()
 
 
 # Python 3.10+ has PEP 612
 if hasattr(typing, 'ParamSpecArgs'):
     ParamSpecArgs = typing.ParamSpecArgs
     ParamSpecKwargs = typing.ParamSpecKwargs
+# 3.6-3.9
 else:
     class _Immutable:
         """Mixin to indicate that object should not be copied."""
@@ -2258,7 +1584,7 @@ else:
             self.__origin__ = origin
 
         def __repr__(self):
-            return "{}.args".format(self.__origin__.__name__)
+            return f"{self.__origin__.__name__}.args"
 
     class ParamSpecKwargs(_Immutable):
         """The kwargs for a ParamSpec object.
@@ -2276,10 +1602,12 @@ else:
             self.__origin__ = origin
 
         def __repr__(self):
-            return "{}.kwargs".format(self.__origin__.__name__)
+            return f"{self.__origin__.__name__}.kwargs"
 
+# 3.10+
 if hasattr(typing, 'ParamSpec'):
     ParamSpec = typing.ParamSpec
+# 3.6-3.9
 else:
 
     # Inherits from list as a workaround for Callable checks in Python < 3.9.2.
@@ -2331,7 +1659,7 @@ else:
         """
 
         # Trick Generic __parameters__.
-        __class__ = TypeVar
+        __class__ = typing.TypeVar
 
         @property
         def args(self):
@@ -2382,61 +1710,60 @@ else:
             pass
 
         if not PEP_560:
-            # Only needed in 3.6 and lower.
+            # Only needed in 3.6.
             def _get_type_vars(self, tvars):
                 if self not in tvars:
                     tvars.append(self)
 
 
-# Inherits from list as a workaround for Callable checks in Python < 3.9.2.
-class _ConcatenateGenericAlias(list):
+# 3.6-3.9
+if not hasattr(typing, 'Concatenate'):
+    # Inherits from list as a workaround for Callable checks in Python < 3.9.2.
+    class _ConcatenateGenericAlias(list):
 
-    # Trick Generic into looking into this for __parameters__.
-    if PEP_560:
-        __class__ = typing._GenericAlias
-    elif sys.version_info[:3] == (3, 5, 2):
-        __class__ = typing.TypingMeta
-    else:
-        __class__ = typing._TypingBase
+        # Trick Generic into looking into this for __parameters__.
+        if PEP_560:
+            __class__ = typing._GenericAlias
+        else:
+            __class__ = typing._TypingBase
 
-    # Flag in 3.8.
-    _special = False
-    # Attribute in 3.6 and earlier.
-    if sys.version_info[:3] == (3, 5, 2):
-        _gorg = typing.GenericMeta
-    else:
+        # Flag in 3.8.
+        _special = False
+        # Attribute in 3.6 and earlier.
         _gorg = typing.Generic
 
-    def __init__(self, origin, args):
-        super().__init__(args)
-        self.__origin__ = origin
-        self.__args__ = args
+        def __init__(self, origin, args):
+            super().__init__(args)
+            self.__origin__ = origin
+            self.__args__ = args
 
-    def __repr__(self):
-        _type_repr = typing._type_repr
-        return '{origin}[{args}]' \
-               .format(origin=_type_repr(self.__origin__),
-                       args=', '.join(_type_repr(arg) for arg in self.__args__))
+        def __repr__(self):
+            _type_repr = typing._type_repr
+            return (f'{_type_repr(self.__origin__)}'
+                    f'[{", ".join(_type_repr(arg) for arg in self.__args__)}]')
 
-    def __hash__(self):
-        return hash((self.__origin__, self.__args__))
+        def __hash__(self):
+            return hash((self.__origin__, self.__args__))
 
-    # Hack to get typing._type_check to pass in Generic.
-    def __call__(self, *args, **kwargs):
-        pass
+        # Hack to get typing._type_check to pass in Generic.
+        def __call__(self, *args, **kwargs):
+            pass
 
-    @property
-    def __parameters__(self):
-        return tuple(tp for tp in self.__args__ if isinstance(tp, (TypeVar, ParamSpec)))
+        @property
+        def __parameters__(self):
+            return tuple(
+                tp for tp in self.__args__ if isinstance(tp, (typing.TypeVar, ParamSpec))
+            )
 
-    if not PEP_560:
-        # Only required in 3.6 and lower.
-        def _get_type_vars(self, tvars):
-            if self.__origin__ and self.__parameters__:
-                typing._get_type_vars(self.__parameters__, tvars)
+        if not PEP_560:
+            # Only required in 3.6.
+            def _get_type_vars(self, tvars):
+                if self.__origin__ and self.__parameters__:
+                    typing._get_type_vars(self.__parameters__, tvars)
 
 
-@_tp_cache
+# 3.6-3.9
+@typing._tp_cache
 def _concatenate_getitem(self, parameters):
     if parameters == ():
         raise TypeError("Cannot take a Concatenate of no types.")
@@ -2450,9 +1777,11 @@ def _concatenate_getitem(self, parameters):
     return _ConcatenateGenericAlias(self, parameters)
 
 
+# 3.10+
 if hasattr(typing, 'Concatenate'):
     Concatenate = typing.Concatenate
     _ConcatenateGenericAlias = typing._ConcatenateGenericAlias # noqa
+# 3.9
 elif sys.version_info[:2] >= (3, 9):
     @_TypeAliasForm
     def Concatenate(self, parameters):
@@ -2467,7 +1796,7 @@ elif sys.version_info[:2] >= (3, 9):
         See PEP 612 for detailed information.
         """
         return _concatenate_getitem(self, parameters)
-
+# 3.7-8
 elif sys.version_info[:2] >= (3, 7):
     class _ConcatenateForm(typing._SpecialForm, _root=True):
         def __repr__(self):
@@ -2488,8 +1817,8 @@ elif sys.version_info[:2] >= (3, 7):
 
         See PEP 612 for detailed information.
         """)
-
-elif hasattr(typing, '_FinalTypingBase'):
+# 3.6
+else:
     class _ConcatenateAliasMeta(typing.TypingMeta):
         """Metaclass for Concatenate."""
 
@@ -2524,38 +1853,11 @@ elif hasattr(typing, '_FinalTypingBase'):
             return _concatenate_getitem(self, parameters)
 
     Concatenate = _ConcatenateAliasBase(_root=True)
-# For 3.5.0 - 3.5.2
-else:
-    class _ConcatenateAliasMeta(typing.TypingMeta):
-        """Metaclass for Concatenate."""
-
-        def __instancecheck__(self, obj):
-            raise TypeError("TypeAlias cannot be used with isinstance().")
-
-        def __subclasscheck__(self, cls):
-            raise TypeError("TypeAlias cannot be used with issubclass().")
-
-        def __call__(self, *args, **kwargs):
-            raise TypeError("Cannot instantiate TypeAlias")
-
-        def __getitem__(self, parameters):
-            return _concatenate_getitem(self, parameters)
-
-    class Concatenate(metaclass=_ConcatenateAliasMeta, _root=True):
-        """Used in conjunction with ``ParamSpec`` and ``Callable`` to represent a
-        higher order function which adds, removes or transforms parameters of a
-        callable.
-
-        For example::
-
-           Callable[Concatenate[int, P], int]
-
-        See PEP 612 for detailed information.
-        """
-        __slots__ = ()
 
+# 3.10+
 if hasattr(typing, 'TypeGuard'):
     TypeGuard = typing.TypeGuard
+# 3.9
 elif sys.version_info[:2] >= (3, 9):
     class _TypeGuardForm(typing._SpecialForm, _root=True):
         def __repr__(self):
@@ -2605,9 +1907,9 @@ elif sys.version_info[:2] >= (3, 9):
         ``TypeGuard`` also works with type variables.  For more information, see
         PEP 647 (User-Defined Type Guards).
         """
-        item = typing._type_check(parameters, '{} accepts only single type.'.format(self))
-        return _GenericAlias(self, (item,))
-
+        item = typing._type_check(parameters, f'{self} accepts only single type.')
+        return typing._GenericAlias(self, (item,))
+# 3.7-3.8
 elif sys.version_info[:2] >= (3, 7):
     class _TypeGuardForm(typing._SpecialForm, _root=True):
 
@@ -2616,8 +1918,8 @@ elif sys.version_info[:2] >= (3, 7):
 
         def __getitem__(self, parameters):
             item = typing._type_check(parameters,
-                                      '{} accepts only a single type'.format(self._name))
-            return _GenericAlias(self, (item,))
+                                      f'{self._name} accepts only a single type')
+            return typing._GenericAlias(self, (item,))
 
     TypeGuard = _TypeGuardForm(
         'TypeGuard',
@@ -2663,7 +1965,8 @@ elif sys.version_info[:2] >= (3, 7):
         ``TypeGuard`` also works with type variables.  For more information, see
         PEP 647 (User-Defined Type Guards).
         """)
-elif hasattr(typing, '_FinalTypingBase'):
+# 3.6
+else:
     class _TypeGuard(typing._FinalTypingBase, _root=True):
         """Special typing form used to annotate the return type of a user-defined
         type guard function.  ``TypeGuard`` only accepts a single type argument.
@@ -2717,7 +2020,221 @@ elif hasattr(typing, '_FinalTypingBase'):
             cls = type(self)
             if self.__type__ is None:
                 return cls(typing._type_check(item,
-                           '{} accepts only a single type.'.format(cls.__name__[1:])),
+                           f'{cls.__name__[1:]} accepts only a single type.'),
+                           _root=True)
+            raise TypeError(f'{cls.__name__[1:]} cannot be further subscripted')
+
+        def _eval_type(self, globalns, localns):
+            new_tp = typing._eval_type(self.__type__, globalns, localns)
+            if new_tp == self.__type__:
+                return self
+            return type(self)(new_tp, _root=True)
+
+        def __repr__(self):
+            r = super().__repr__()
+            if self.__type__ is not None:
+                r += f'[{typing._type_repr(self.__type__)}]'
+            return r
+
+        def __hash__(self):
+            return hash((type(self).__name__, self.__type__))
+
+        def __eq__(self, other):
+            if not isinstance(other, _TypeGuard):
+                return NotImplemented
+            if self.__type__ is not None:
+                return self.__type__ == other.__type__
+            return self is other
+
+    TypeGuard = _TypeGuard(_root=True)
+
+if hasattr(typing, "Self"):
+    Self = typing.Self
+elif sys.version_info[:2] >= (3, 7):
+    # Vendored from cpython typing._SpecialFrom
+    class _SpecialForm(typing._Final, _root=True):
+        __slots__ = ('_name', '__doc__', '_getitem')
+
+        def __init__(self, getitem):
+            self._getitem = getitem
+            self._name = getitem.__name__
+            self.__doc__ = getitem.__doc__
+
+        def __getattr__(self, item):
+            if item in {'__name__', '__qualname__'}:
+                return self._name
+
+            raise AttributeError(item)
+
+        def __mro_entries__(self, bases):
+            raise TypeError(f"Cannot subclass {self!r}")
+
+        def __repr__(self):
+            return f'typing_extensions.{self._name}'
+
+        def __reduce__(self):
+            return self._name
+
+        def __call__(self, *args, **kwds):
+            raise TypeError(f"Cannot instantiate {self!r}")
+
+        def __or__(self, other):
+            return typing.Union[self, other]
+
+        def __ror__(self, other):
+            return typing.Union[other, self]
+
+        def __instancecheck__(self, obj):
+            raise TypeError(f"{self} cannot be used with isinstance()")
+
+        def __subclasscheck__(self, cls):
+            raise TypeError(f"{self} cannot be used with issubclass()")
+
+        @typing._tp_cache
+        def __getitem__(self, parameters):
+            return self._getitem(self, parameters)
+
+    @_SpecialForm
+    def Self(self, params):
+        """Used to spell the type of "self" in classes.
+
+        Example::
+
+          from typing import Self
+
+          class ReturnsSelf:
+              def parse(self, data: bytes) -> Self:
+                  ...
+                  return self
+
+        """
+
+        raise TypeError(f"{self} is not subscriptable")
+else:
+    class _Self(typing._FinalTypingBase, _root=True):
+        """Used to spell the type of "self" in classes.
+
+        Example::
+
+          from typing import Self
+
+          class ReturnsSelf:
+              def parse(self, data: bytes) -> Self:
+                  ...
+                  return self
+
+        """
+
+        __slots__ = ()
+
+        def __instancecheck__(self, obj):
+            raise TypeError(f"{self} cannot be used with isinstance().")
+
+        def __subclasscheck__(self, cls):
+            raise TypeError(f"{self} cannot be used with issubclass().")
+
+    Self = _Self(_root=True)
+
+
+if hasattr(typing, 'Required'):
+    Required = typing.Required
+    NotRequired = typing.NotRequired
+elif sys.version_info[:2] >= (3, 9):
+    class _ExtensionsSpecialForm(typing._SpecialForm, _root=True):
+        def __repr__(self):
+            return 'typing_extensions.' + self._name
+
+    @_ExtensionsSpecialForm
+    def Required(self, parameters):
+        """A special typing construct to mark a key of a total=False TypedDict
+        as required. For example:
+
+            class Movie(TypedDict, total=False):
+                title: Required[str]
+                year: int
+
+            m = Movie(
+                title='The Matrix',  # typechecker error if key is omitted
+                year=1999,
+            )
+
+        There is no runtime checking that a required key is actually provided
+        when instantiating a related TypedDict.
+        """
+        item = typing._type_check(parameters, f'{self._name} accepts only single type')
+        return typing._GenericAlias(self, (item,))
+
+    @_ExtensionsSpecialForm
+    def NotRequired(self, parameters):
+        """A special typing construct to mark a key of a TypedDict as
+        potentially missing. For example:
+
+            class Movie(TypedDict):
+                title: str
+                year: NotRequired[int]
+
+            m = Movie(
+                title='The Matrix',  # typechecker error if key is omitted
+                year=1999,
+            )
+        """
+        item = typing._type_check(parameters, f'{self._name} accepts only single type')
+        return typing._GenericAlias(self, (item,))
+
+elif sys.version_info[:2] >= (3, 7):
+    class _RequiredForm(typing._SpecialForm, _root=True):
+        def __repr__(self):
+            return 'typing_extensions.' + self._name
+
+        def __getitem__(self, parameters):
+            item = typing._type_check(parameters,
+                                      '{} accepts only single type'.format(self._name))
+            return typing._GenericAlias(self, (item,))
+
+    Required = _RequiredForm(
+        'Required',
+        doc="""A special typing construct to mark a key of a total=False TypedDict
+        as required. For example:
+
+            class Movie(TypedDict, total=False):
+                title: Required[str]
+                year: int
+
+            m = Movie(
+                title='The Matrix',  # typechecker error if key is omitted
+                year=1999,
+            )
+
+        There is no runtime checking that a required key is actually provided
+        when instantiating a related TypedDict.
+        """)
+    NotRequired = _RequiredForm(
+        'NotRequired',
+        doc="""A special typing construct to mark a key of a TypedDict as
+        potentially missing. For example:
+
+            class Movie(TypedDict):
+                title: str
+                year: NotRequired[int]
+
+            m = Movie(
+                title='The Matrix',  # typechecker error if key is omitted
+                year=1999,
+            )
+        """)
+else:
+    # NOTE: Modeled after _Final's implementation when _FinalTypingBase available
+    class _MaybeRequired(typing._FinalTypingBase, _root=True):
+        __slots__ = ('__type__',)
+
+        def __init__(self, tp=None, **kwds):
+            self.__type__ = tp
+
+        def __getitem__(self, item):
+            cls = type(self)
+            if self.__type__ is None:
+                return cls(typing._type_check(item,
+                           '{} accepts only single type.'.format(cls.__name__[1:])),
                            _root=True)
             raise TypeError('{} cannot be further subscripted'
                             .format(cls.__name__[1:]))
@@ -2738,106 +2255,42 @@ elif hasattr(typing, '_FinalTypingBase'):
             return hash((type(self).__name__, self.__type__))
 
         def __eq__(self, other):
-            if not isinstance(other, _TypeGuard):
+            if not isinstance(other, type(self)):
                 return NotImplemented
             if self.__type__ is not None:
                 return self.__type__ == other.__type__
             return self is other
 
-    TypeGuard = _TypeGuard(_root=True)
-else:
-    class _TypeGuardMeta(typing.TypingMeta):
-        """Metaclass for TypeGuard"""
+    class _Required(_MaybeRequired, _root=True):
+        """A special typing construct to mark a key of a total=False TypedDict
+        as required. For example:
 
-        def __new__(cls, name, bases, namespace, tp=None, _root=False):
-            self = super().__new__(cls, name, bases, namespace, _root=_root)
-            if tp is not None:
-                self.__type__ = tp
-            return self
+            class Movie(TypedDict, total=False):
+                title: Required[str]
+                year: int
 
-        def __instancecheck__(self, obj):
-            raise TypeError("TypeGuard cannot be used with isinstance().")
+            m = Movie(
+                title='The Matrix',  # typechecker error if key is omitted
+                year=1999,
+            )
 
-        def __subclasscheck__(self, cls):
-            raise TypeError("TypeGuard cannot be used with issubclass().")
-
-        def __getitem__(self, item):
-            cls = type(self)
-            if self.__type__ is not None:
-                raise TypeError('{} cannot be further subscripted'
-                                .format(cls.__name__[1:]))
-
-            param = typing._type_check(
-                item,
-                '{} accepts only single type.'.format(cls.__name__[1:]))
-            return cls(self.__name__, self.__bases__,
-                       dict(self.__dict__), tp=param, _root=True)
-
-        def _eval_type(self, globalns, localns):
-            new_tp = typing._eval_type(self.__type__, globalns, localns)
-            if new_tp == self.__type__:
-                return self
-            return type(self)(self.__name__, self.__bases__,
-                              dict(self.__dict__), tp=self.__type__,
-                              _root=True)
-
-        def __repr__(self):
-            r = super().__repr__()
-            if self.__type__ is not None:
-                r += '[{}]'.format(typing._type_repr(self.__type__))
-            return r
-
-        def __hash__(self):
-            return hash((type(self).__name__, self.__type__))
-
-        def __eq__(self, other):
-            if not hasattr(other, "__type__"):
-                return NotImplemented
-            if self.__type__ is not None:
-                return self.__type__ == other.__type__
-            return self is other
-
-    class TypeGuard(typing.Final, metaclass=_TypeGuardMeta, _root=True):
-        """Special typing form used to annotate the return type of a user-defined
-        type guard function.  ``TypeGuard`` only accepts a single type argument.
-        At runtime, functions marked this way should return a boolean.
-
-        ``TypeGuard`` aims to benefit *type narrowing* -- a technique used by static
-        type checkers to determine a more precise type of an expression within a
-        program's code flow.  Usually type narrowing is done by analyzing
-        conditional code flow and applying the narrowing to a block of code.  The
-        conditional expression here is sometimes referred to as a "type guard".
-
-        Sometimes it would be convenient to use a user-defined boolean function
-        as a type guard.  Such a function should use ``TypeGuard[...]`` as its
-        return type to alert static type checkers to this intention.
-
-        Using  ``-> TypeGuard`` tells the static type checker that for a given
-        function:
-
-        1. The return value is a boolean.
-        2. If the return value is ``True``, the type of its argument
-        is the type inside ``TypeGuard``.
-
-        For example::
-
-            def is_str(val: Union[str, float]):
-                # "isinstance" type guard
-                if isinstance(val, str):
-                    # Type of ``val`` is narrowed to ``str``
-                    ...
-                else:
-                    # Else, type of ``val`` is narrowed to ``float``.
-                    ...
-
-        Strict type narrowing is not enforced -- ``TypeB`` need not be a narrower
-        form of ``TypeA`` (it can even be a wider form) and this may lead to
-        type-unsafe results.  The main reason is to allow for things like
-        narrowing ``List[object]`` to ``List[str]`` even though the latter is not
-        a subtype of the former, since ``List`` is invariant.  The responsibility of
-        writing type-safe type guards is left to the user.
-
-        ``TypeGuard`` also works with type variables.  For more information, see
-        PEP 647 (User-Defined Type Guards).
+        There is no runtime checking that a required key is actually provided
+        when instantiating a related TypedDict.
         """
-        __type__ = None
+
+    class _NotRequired(_MaybeRequired, _root=True):
+        """A special typing construct to mark a key of a TypedDict as
+        potentially missing. For example:
+
+            class Movie(TypedDict):
+                title: str
+                year: NotRequired[int]
+
+            m = Movie(
+                title='The Matrix',  # typechecker error if key is omitted
+                year=1999,
+            )
+        """
+
+    Required = _Required(_root=True)
+    NotRequired = _NotRequired(_root=True)
diff --git a/requirements.txt b/requirements.txt
index d9f84441..d8f17a52 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,6 +1,6 @@
 appdirs==1.4.4
 apscheduler==3.8.0
-arrow==1.2.1
+arrow==1.2.2
 backports.csv==1.0.7
 backports.functools-lru-cache==1.6.4
 backports.zoneinfo==0.2.1

From 5523d4ba88d4b4a51f704958269b4d04081aa11b Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 7 Feb 2022 21:57:29 -0800
Subject: [PATCH 012/743] Bump httpagentparser from 1.9.1 to 1.9.2 (#1631)

* Bump httpagentparser from 1.9.1 to 1.9.2

Bumps [httpagentparser](https://github.com/shon/httpagentparser) from 1.9.1 to 1.9.2.
- [Release notes](https://github.com/shon/httpagentparser/releases)
- [Commits](https://github.com/shon/httpagentparser/commits)

---
updated-dependencies:
- dependency-name: httpagentparser
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

* Update httpagentparser==1.9.2

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/httpagentparser/__init__.py | 37 +++++++++++++++++++++++++++------
 requirements.txt                |  2 +-
 2 files changed, 32 insertions(+), 7 deletions(-)

diff --git a/lib/httpagentparser/__init__.py b/lib/httpagentparser/__init__.py
index 9bac5148..0e30e617 100644
--- a/lib/httpagentparser/__init__.py
+++ b/lib/httpagentparser/__init__.py
@@ -8,7 +8,7 @@ Tries to
     * assist python web apps to detect clients.
 """
 
-__version__ = '1.9.1'
+__version__ = '1.9.2'
 
 
 class DetectorsHub(dict):
@@ -671,11 +671,21 @@ def detect(agent, fill_none=False):
     return result
 
 
-def simple_detect(agent):
+UNKNOWN_OS_NAME = 'Unknown OS'
+UNKNOWN_BROWSER_NAME = 'Unknown Browser'
+
+
+def simple_detect_tuple(agent, parsed_agent=None):
     """
-    -> (os, browser) # tuple of strings
+    @params:
+        agent::str
+        parsed_agent::dict
+            The result of detect, used to save calculations
+
+    @return:
+        (os_name, os_version, browser_name, browser_version)::Tuple(str)
     """
-    result = detect(agent)
+    result = parsed_agent or detect(agent)
     os_list = []
     if 'flavor' in result:
         os_list.append(result['flavor']['name'])
@@ -684,11 +694,26 @@ def simple_detect(agent):
     if 'os' in result:
         os_list.append(result['os']['name'])
 
-    os = os_list and " ".join(os_list) or "Unknown OS"
+    os = os_list and " ".join(os_list) or UNKNOWN_OS_NAME
     os_version = os_list and (result.get('flavor') and result['flavor'].get('version')) or \
         (result.get('dist') and result['dist'].get('version')) or (result.get('os') and result['os'].get('version')) or ""
-    browser = 'browser' in result and result['browser'].get('name') or 'Unknown Browser'
+    browser = 'browser' in result and result['browser'].get('name') or UNKNOWN_BROWSER_NAME
     browser_version = 'browser' in result and result['browser'].get('version') or ""
+
+    return os, os_version, browser, browser_version
+
+
+def simple_detect(agent, parsed_agent=None):
+    """
+    @params:
+        agent::str
+        parsed_agent::dict
+            The result of detect, used to save calculations
+
+    @return:
+        (os_name_version, browser_name_version)::Tuple(str)
+    """
+    os, os_version, browser, browser_version = simple_detect_tuple(agent, parsed_agent=parsed_agent)
     if browser_version:
         browser = " ".join((browser, browser_version))
     if os_version:
diff --git a/requirements.txt b/requirements.txt
index d8f17a52..6388dc9f 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -16,7 +16,7 @@ facebook-sdk==3.1.0
 future==0.18.2
 gntp==1.0.3
 html5lib==1.1
-httpagentparser==1.9.1
+httpagentparser==1.9.2
 idna==3.3
 importlib-resources==5.4.0
 git+https://github.com/Tautulli/ipwhois.git@master#egg=ipwhois

From 61960aa7449d53a0c4e64c505c0c258523614bc0 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 7 Feb 2022 21:57:50 -0800
Subject: [PATCH 013/743] Bump requests-oauthlib from 1.3.0 to 1.3.1 (#1636)

* Bump requests-oauthlib from 1.3.0 to 1.3.1

Bumps [requests-oauthlib](https://github.com/requests/requests-oauthlib) from 1.3.0 to 1.3.1.
- [Release notes](https://github.com/requests/requests-oauthlib/releases)
- [Changelog](https://github.com/requests/requests-oauthlib/blob/master/HISTORY.rst)
- [Commits](https://github.com/requests/requests-oauthlib/compare/v1.3.0...v1.3.1)

---
updated-dependencies:
- dependency-name: requests-oauthlib
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

* Update requests-oauthlib==1.3.1

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/charset_normalizer/api.py                 | 103 +++++++++++------
 lib/charset_normalizer/constant.py            |   3 +
 lib/charset_normalizer/version.py             |   2 +-
 lib/oauthlib/__init__.py                      |   2 +-
 lib/oauthlib/oauth2/__init__.py               |   1 +
 lib/oauthlib/oauth2/rfc6749/clients/base.py   | 109 +++++++++++++++++-
 .../oauth2/rfc6749/clients/web_application.py |  25 +++-
 .../oauth2/rfc6749/endpoints/metadata.py      |   3 +-
 lib/oauthlib/oauth2/rfc6749/errors.py         |   7 +-
 .../rfc6749/grant_types/authorization_code.py |  21 ++++
 .../rfc6749/grant_types/refresh_token.py      |   2 +-
 lib/oauthlib/oauth2/rfc6749/parameters.py     |  20 +++-
 .../oauth2/rfc6749/request_validator.py       |  25 ++++
 lib/oauthlib/oauth2/rfc8628/__init__.py       |  10 ++
 .../oauth2/rfc8628/clients/__init__.py        |   8 ++
 lib/oauthlib/oauth2/rfc8628/clients/device.py |  94 +++++++++++++++
 .../connect/core/grant_types/__init__.py      |   1 +
 .../connect/core/grant_types/refresh_token.py |  34 ++++++
 .../openid/connect/core/request_validator.py  |  12 ++
 lib/requests_oauthlib/__init__.py             |   2 +-
 .../compliance_fixes/__init__.py              |   2 +-
 .../compliance_fixes/ebay.py                  |  23 ++++
 .../compliance_fixes/linkedin.py              |  21 ----
 lib/requests_oauthlib/oauth1_session.py       |   2 +-
 lib/requests_oauthlib/oauth2_session.py       |   6 +
 requirements.txt                              |   3 +-
 26 files changed, 464 insertions(+), 77 deletions(-)
 create mode 100644 lib/oauthlib/oauth2/rfc8628/__init__.py
 create mode 100644 lib/oauthlib/oauth2/rfc8628/clients/__init__.py
 create mode 100644 lib/oauthlib/oauth2/rfc8628/clients/device.py
 create mode 100644 lib/oauthlib/openid/connect/core/grant_types/refresh_token.py
 create mode 100644 lib/requests_oauthlib/compliance_fixes/ebay.py
 delete mode 100644 lib/requests_oauthlib/compliance_fixes/linkedin.py

diff --git a/lib/charset_normalizer/api.py b/lib/charset_normalizer/api.py
index b3e198a7..bdc8ed98 100644
--- a/lib/charset_normalizer/api.py
+++ b/lib/charset_normalizer/api.py
@@ -13,7 +13,7 @@ from .cd import (
     mb_encoding_languages,
     merge_coherence_ratios,
 )
-from .constant import IANA_SUPPORTED, TOO_BIG_SEQUENCE, TOO_SMALL_SEQUENCE
+from .constant import IANA_SUPPORTED, TOO_BIG_SEQUENCE, TOO_SMALL_SEQUENCE, TRACE
 from .md import mess_ratio
 from .models import CharsetMatch, CharsetMatches
 from .utils import (
@@ -25,6 +25,8 @@ from .utils import (
     should_strip_sig_or_bom,
 )
 
+# Will most likely be controversial
+# logging.addLevelName(TRACE, "TRACE")
 logger = logging.getLogger("charset_normalizer")
 explain_handler = logging.StreamHandler()
 explain_handler.setFormatter(
@@ -70,19 +72,20 @@ def from_bytes(
     if explain:
         previous_logger_level = logger.level  # type: int
         logger.addHandler(explain_handler)
-        logger.setLevel(logging.DEBUG)
+        logger.setLevel(TRACE)
 
     length = len(sequences)  # type: int
 
     if length == 0:
-        logger.warning("Encoding detection on empty bytes, assuming utf_8 intention.")
+        logger.debug("Encoding detection on empty bytes, assuming utf_8 intention.")
         if explain:
             logger.removeHandler(explain_handler)
             logger.setLevel(previous_logger_level or logging.WARNING)
         return CharsetMatches([CharsetMatch(sequences, "utf_8", 0.0, False, [], "")])
 
     if cp_isolation is not None:
-        logger.debug(
+        logger.log(
+            TRACE,
             "cp_isolation is set. use this flag for debugging purpose. "
             "limited list of encoding allowed : %s.",
             ", ".join(cp_isolation),
@@ -92,7 +95,8 @@ def from_bytes(
         cp_isolation = []
 
     if cp_exclusion is not None:
-        logger.debug(
+        logger.log(
+            TRACE,
             "cp_exclusion is set. use this flag for debugging purpose. "
             "limited list of encoding excluded : %s.",
             ", ".join(cp_exclusion),
@@ -102,7 +106,8 @@ def from_bytes(
         cp_exclusion = []
 
     if length <= (chunk_size * steps):
-        logger.debug(
+        logger.log(
+            TRACE,
             "override steps (%i) and chunk_size (%i) as content does not fit (%i byte(s) given) parameters.",
             steps,
             chunk_size,
@@ -118,16 +123,18 @@ def from_bytes(
     is_too_large_sequence = len(sequences) >= TOO_BIG_SEQUENCE  # type: bool
 
     if is_too_small_sequence:
-        logger.warning(
+        logger.log(
+            TRACE,
             "Trying to detect encoding from a tiny portion of ({}) byte(s).".format(
                 length
-            )
+            ),
         )
     elif is_too_large_sequence:
-        logger.info(
+        logger.log(
+            TRACE,
             "Using lazy str decoding because the payload is quite large, ({}) byte(s).".format(
                 length
-            )
+            ),
         )
 
     prioritized_encodings = []  # type: List[str]
@@ -138,7 +145,8 @@ def from_bytes(
 
     if specified_encoding is not None:
         prioritized_encodings.append(specified_encoding)
-        logger.info(
+        logger.log(
+            TRACE,
             "Detected declarative mark in sequence. Priority +1 given for %s.",
             specified_encoding,
         )
@@ -157,7 +165,8 @@ def from_bytes(
 
     if sig_encoding is not None:
         prioritized_encodings.append(sig_encoding)
-        logger.info(
+        logger.log(
+            TRACE,
             "Detected a SIG or BOM mark on first %i byte(s). Priority +1 given for %s.",
             len(sig_payload),
             sig_encoding,
@@ -188,7 +197,8 @@ def from_bytes(
         )  # type: bool
 
         if encoding_iana in {"utf_16", "utf_32"} and not bom_or_sig_available:
-            logger.debug(
+            logger.log(
+                TRACE,
                 "Encoding %s wont be tested as-is because it require a BOM. Will try some sub-encoder LE/BE.",
                 encoding_iana,
             )
@@ -197,8 +207,10 @@ def from_bytes(
         try:
             is_multi_byte_decoder = is_multi_byte_encoding(encoding_iana)  # type: bool
         except (ModuleNotFoundError, ImportError):
-            logger.debug(
-                "Encoding %s does not provide an IncrementalDecoder", encoding_iana
+            logger.log(
+                TRACE,
+                "Encoding %s does not provide an IncrementalDecoder",
+                encoding_iana,
             )
             continue
 
@@ -219,7 +231,8 @@ def from_bytes(
                 )
         except (UnicodeDecodeError, LookupError) as e:
             if not isinstance(e, LookupError):
-                logger.debug(
+                logger.log(
+                    TRACE,
                     "Code page %s does not fit given bytes sequence at ALL. %s",
                     encoding_iana,
                     str(e),
@@ -235,7 +248,8 @@ def from_bytes(
                 break
 
         if similar_soft_failure_test:
-            logger.debug(
+            logger.log(
+                TRACE,
                 "%s is deemed too similar to code page %s and was consider unsuited already. Continuing!",
                 encoding_iana,
                 encoding_soft_failed,
@@ -255,7 +269,8 @@ def from_bytes(
         )  # type: bool
 
         if multi_byte_bonus:
-            logger.debug(
+            logger.log(
+                TRACE,
                 "Code page %s is a multi byte encoding table and it appear that at least one character "
                 "was encoded using n-bytes.",
                 encoding_iana,
@@ -285,7 +300,8 @@ def from_bytes(
                     errors="ignore" if is_multi_byte_decoder else "strict",
                 )  # type: str
             except UnicodeDecodeError as e:  # Lazy str loading may have missed something there
-                logger.debug(
+                logger.log(
+                    TRACE,
                     "LazyStr Loading: After MD chunk decode, code page %s does not fit given bytes sequence at ALL. %s",
                     encoding_iana,
                     str(e),
@@ -337,7 +353,8 @@ def from_bytes(
             try:
                 sequences[int(50e3) :].decode(encoding_iana, errors="strict")
             except UnicodeDecodeError as e:
-                logger.debug(
+                logger.log(
+                    TRACE,
                     "LazyStr Loading: After final lookup, code page %s does not fit given bytes sequence at ALL. %s",
                     encoding_iana,
                     str(e),
@@ -350,7 +367,8 @@ def from_bytes(
         )  # type: float
         if mean_mess_ratio >= threshold or early_stop_count >= max_chunk_gave_up:
             tested_but_soft_failure.append(encoding_iana)
-            logger.info(
+            logger.log(
+                TRACE,
                 "%s was excluded because of initial chaos probing. Gave up %i time(s). "
                 "Computed mean chaos is %f %%.",
                 encoding_iana,
@@ -373,7 +391,8 @@ def from_bytes(
                     fallback_u8 = fallback_entry
             continue
 
-        logger.info(
+        logger.log(
+            TRACE,
             "%s passed initial chaos probing. Mean measured chaos is %f %%",
             encoding_iana,
             round(mean_mess_ratio * 100, ndigits=3),
@@ -385,10 +404,11 @@ def from_bytes(
             target_languages = mb_encoding_languages(encoding_iana)
 
         if target_languages:
-            logger.debug(
+            logger.log(
+                TRACE,
                 "{} should target any language(s) of {}".format(
                     encoding_iana, str(target_languages)
-                )
+                ),
             )
 
         cd_ratios = []
@@ -406,10 +426,11 @@ def from_bytes(
         cd_ratios_merged = merge_coherence_ratios(cd_ratios)
 
         if cd_ratios_merged:
-            logger.info(
+            logger.log(
+                TRACE,
                 "We detected language {} using {}".format(
                     cd_ratios_merged, encoding_iana
-                )
+                ),
             )
 
         results.append(
@@ -427,8 +448,8 @@ def from_bytes(
             encoding_iana in [specified_encoding, "ascii", "utf_8"]
             and mean_mess_ratio < 0.1
         ):
-            logger.info(
-                "%s is most likely the one. Stopping the process.", encoding_iana
+            logger.debug(
+                "Encoding detection: %s is most likely the one.", encoding_iana
             )
             if explain:
                 logger.removeHandler(explain_handler)
@@ -436,8 +457,9 @@ def from_bytes(
             return CharsetMatches([results[encoding_iana]])
 
         if encoding_iana == sig_encoding:
-            logger.info(
-                "%s is most likely the one as we detected a BOM or SIG within the beginning of the sequence.",
+            logger.debug(
+                "Encoding detection: %s is most likely the one as we detected a BOM or SIG within "
+                "the beginning of the sequence.",
                 encoding_iana,
             )
             if explain:
@@ -447,13 +469,15 @@ def from_bytes(
 
     if len(results) == 0:
         if fallback_u8 or fallback_ascii or fallback_specified:
-            logger.debug(
-                "Nothing got out of the detection process. Using ASCII/UTF-8/Specified fallback."
+            logger.log(
+                TRACE,
+                "Nothing got out of the detection process. Using ASCII/UTF-8/Specified fallback.",
             )
 
         if fallback_specified:
             logger.debug(
-                "%s will be used as a fallback match", fallback_specified.encoding
+                "Encoding detection: %s will be used as a fallback match",
+                fallback_specified.encoding,
             )
             results.append(fallback_specified)
         elif (
@@ -465,12 +489,21 @@ def from_bytes(
             )
             or (fallback_u8 is not None)
         ):
-            logger.warning("utf_8 will be used as a fallback match")
+            logger.debug("Encoding detection: utf_8 will be used as a fallback match")
             results.append(fallback_u8)
         elif fallback_ascii:
-            logger.warning("ascii will be used as a fallback match")
+            logger.debug("Encoding detection: ascii will be used as a fallback match")
             results.append(fallback_ascii)
 
+    if results:
+        logger.debug(
+            "Encoding detection: Found %s as plausible (best-candidate) for content. With %i alternatives.",
+            results.best().encoding,  # type: ignore
+            len(results) - 1,
+        )
+    else:
+        logger.debug("Encoding detection: Unable to determine any suitable charset.")
+
     if explain:
         logger.removeHandler(explain_handler)
         logger.setLevel(previous_logger_level)
diff --git a/lib/charset_normalizer/constant.py b/lib/charset_normalizer/constant.py
index 3d5d6457..c32f5cf2 100644
--- a/lib/charset_normalizer/constant.py
+++ b/lib/charset_normalizer/constant.py
@@ -498,3 +498,6 @@ ZH_NAMES = {"big5", "cp950", "big5hkscs", "hz"}  # type: Set[str]
 NOT_PRINTABLE_PATTERN = re_compile(r"[0-9\W\n\r\t]+")
 
 LANGUAGE_SUPPORTED_COUNT = len(FREQUENCIES)  # type: int
+
+# Logging LEVEL bellow DEBUG
+TRACE = 5  # type: int
diff --git a/lib/charset_normalizer/version.py b/lib/charset_normalizer/version.py
index a8d66597..69bf0503 100644
--- a/lib/charset_normalizer/version.py
+++ b/lib/charset_normalizer/version.py
@@ -2,5 +2,5 @@
 Expose version
 """
 
-__version__ = "2.0.10"
+__version__ = "2.0.11"
 VERSION = __version__.split(".")
diff --git a/lib/oauthlib/__init__.py b/lib/oauthlib/__init__.py
index a94cf941..5dbffc96 100644
--- a/lib/oauthlib/__init__.py
+++ b/lib/oauthlib/__init__.py
@@ -12,7 +12,7 @@ import logging
 from logging import NullHandler
 
 __author__ = 'The OAuthlib Community'
-__version__ = '3.1.1'
+__version__ = '3.2.0'
 
 logging.getLogger('oauthlib').addHandler(NullHandler())
 
diff --git a/lib/oauthlib/oauth2/__init__.py b/lib/oauthlib/oauth2/__init__.py
index a6e1cccd..deefb1af 100644
--- a/lib/oauthlib/oauth2/__init__.py
+++ b/lib/oauthlib/oauth2/__init__.py
@@ -33,3 +33,4 @@ from .rfc6749.grant_types import (
 from .rfc6749.request_validator import RequestValidator
 from .rfc6749.tokens import BearerToken, OAuth2Token
 from .rfc6749.utils import is_secure_transport
+from .rfc8628.clients import DeviceClient
diff --git a/lib/oauthlib/oauth2/rfc6749/clients/base.py b/lib/oauthlib/oauth2/rfc6749/clients/base.py
index 88065ab3..bb4c1338 100644
--- a/lib/oauthlib/oauth2/rfc6749/clients/base.py
+++ b/lib/oauthlib/oauth2/rfc6749/clients/base.py
@@ -8,6 +8,10 @@ for consuming OAuth 2.0 RFC6749.
 """
 import time
 import warnings
+import secrets
+import re
+import hashlib
+import base64
 
 from oauthlib.common import generate_token
 from oauthlib.oauth2.rfc6749 import tokens
@@ -61,6 +65,9 @@ class Client:
                  state=None,
                  redirect_url=None,
                  state_generator=generate_token,
+                 code_verifier=None,
+                 code_challenge=None,
+                 code_challenge_method=None,
                  **kwargs):
         """Initialize a client with commonly used attributes.
 
@@ -99,6 +106,15 @@ class Client:
 
         :param state_generator: A no argument state generation callable. Defaults
         to :py:meth:`oauthlib.common.generate_token`.
+
+        :param code_verifier: PKCE parameter. A cryptographically random string that is used to correlate the
+        authorization request to the token request.
+
+        :param code_challenge: PKCE parameter. A challenge derived from the code verifier that is sent in the
+        authorization request, to be verified against later.
+
+        :param code_challenge_method: PKCE parameter. A method that was used to derive code challenge.
+        Defaults to "plain" if not present in the request.
         """
 
         self.client_id = client_id
@@ -113,6 +129,9 @@ class Client:
         self.state_generator = state_generator
         self.state = state
         self.redirect_url = redirect_url
+        self.code_verifier = code_verifier
+        self.code_challenge = code_challenge
+        self.code_challenge_method = code_challenge_method
         self.code = None
         self.expires_in = None
         self._expires_at = None
@@ -471,6 +490,91 @@ class Client:
             raise ValueError("Invalid token placement.")
         return uri, headers, body
 
+    def create_code_verifier(self, length):
+        """Create PKCE **code_verifier** used in computing **code_challenge**. 
+
+           :param length: REQUIRED. The length of the code_verifier.
+
+            The client first creates a code verifier, "code_verifier", for each
+            OAuth 2.0 [RFC6749] Authorization Request, in the following manner:
+
+            code_verifier = high-entropy cryptographic random STRING using the
+            unreserved characters [A-Z] / [a-z] / [0-9] / "-" / "." / "_" / "~"
+            from Section 2.3 of [RFC3986], with a minimum length of 43 characters
+            and a maximum length of 128 characters.
+            
+            .. _`Section 4.1`: https://tools.ietf.org/html/rfc7636#section-4.1
+        """
+        code_verifier = None
+
+        if not length >= 43:
+            raise ValueError("Length must be greater than or equal to 43")
+
+        if not length <= 128:
+            raise ValueError("Length must be less than or equal to 128")
+
+        allowed_characters = re.compile('^[A-Zaa-z0-9-._~]')
+        code_verifier = secrets.token_urlsafe(length)
+
+        if not re.search(allowed_characters, code_verifier):
+            raise ValueError("code_verifier contains invalid characters")
+
+        self.code_verifier = code_verifier
+
+        return code_verifier
+
+    def create_code_challenge(self, code_verifier, code_challenge_method=None):
+        """Create PKCE **code_challenge** derived from the  **code_verifier**.
+
+           :param code_verifier: REQUIRED. The **code_verifier** generated from create_code_verifier().
+           :param code_challenge_method: OPTIONAL. The method used to derive the **code_challenge**. Acceptable
+                values include "S256". DEFAULT is "plain".
+
+
+            The client then creates a code challenge derived from the code
+               verifier by using one of the following transformations on the code
+               verifier:
+
+               plain
+                  code_challenge = code_verifier
+
+               S256
+                  code_challenge = BASE64URL-ENCODE(SHA256(ASCII(code_verifier)))
+
+               If the client is capable of using "S256", it MUST use "S256", as
+               "S256" is Mandatory To Implement (MTI) on the server.  Clients are
+               permitted to use "plain" only if they cannot support "S256" for some
+               technical reason and know via out-of-band configuration that the
+               server supports "plain".
+
+               The plain transformation is for compatibility with existing
+               deployments and for constrained environments that can't use the S256
+               transformation.
+
+            .. _`Section 4.2`: https://tools.ietf.org/html/rfc7636#section-4.2
+        """
+        code_challenge = None
+
+        if code_verifier == None:
+            raise ValueError("Invalid code_verifier")
+
+        if code_challenge_method == None:
+            code_challenge_method = "plain"
+            self.code_challenge_method = code_challenge_method
+            code_challenge = code_verifier
+            self.code_challenge = code_challenge
+
+        if code_challenge_method == "S256":
+            h = hashlib.sha256()
+            h.update(code_verifier.encode(encoding='ascii'))
+            sha256_val = h.digest()
+            code_challenge = bytes.decode(base64.urlsafe_b64encode(sha256_val))
+            # replace '+' with '-', '/' with '_', and remove trailing '='
+            code_challenge = code_challenge.replace("+", "-").replace("/", "_").replace("=", "")
+            self.code_challenge = code_challenge
+
+        return code_challenge
+
     def _add_mac_token(self, uri, http_method='GET', body=None,
                        headers=None, token_placement=AUTH_HEADER, ext=None, **kwargs):
         """Add a MAC token to the request authorization header.
@@ -513,7 +617,10 @@ class Client:
             self._expires_at = time.time() + int(self.expires_in)
 
         if 'expires_at' in response:
-            self._expires_at = int(response.get('expires_at'))
+            try:
+                self._expires_at = int(response.get('expires_at'))
+            except:
+                self._expires_at = None
 
         if 'mac_key' in response:
             self.mac_key = response.get('mac_key')
diff --git a/lib/oauthlib/oauth2/rfc6749/clients/web_application.py b/lib/oauthlib/oauth2/rfc6749/clients/web_application.py
index a1f3db1d..1d3b2b5b 100644
--- a/lib/oauthlib/oauth2/rfc6749/clients/web_application.py
+++ b/lib/oauthlib/oauth2/rfc6749/clients/web_application.py
@@ -41,7 +41,7 @@ class WebApplicationClient(Client):
         self.code = code
 
     def prepare_request_uri(self, uri, redirect_uri=None, scope=None,
-                            state=None, **kwargs):
+                            state=None, code_challenge=None, code_challenge_method='plain', **kwargs):
         """Prepare the authorization code request URI
 
         The client constructs the request URI by adding the following
@@ -62,6 +62,13 @@ class WebApplicationClient(Client):
                         to the client.  The parameter SHOULD be used for preventing
                         cross-site request forgery as described in `Section 10.12`_.
 
+        :param code_challenge: OPTIONAL. PKCE parameter. REQUIRED if PKCE is enforced. 
+                        A challenge derived from the code_verifier that is sent in the 
+                        authorization request, to be verified against later.
+
+        :param code_challenge_method: OPTIONAL. PKCE parameter. A method that was used to derive code challenge.
+                                      Defaults to "plain" if not present in the request.
+
         :param kwargs:  Extra arguments to include in the request URI.
 
         In addition to supplied parameters, OAuthLib will append the ``client_id``
@@ -76,6 +83,10 @@ class WebApplicationClient(Client):
             'https://example.com?client_id=your_id&response_type=code&redirect_uri=https%3A%2F%2Fa.b%2Fcallback'
             >>> client.prepare_request_uri('https://example.com', scope=['profile', 'pictures'])
             'https://example.com?client_id=your_id&response_type=code&scope=profile+pictures'
+            >>> client.prepare_request_uri('https://example.com', code_challenge='kjasBS523KdkAILD2k78NdcJSk2k3KHG6')
+            'https://example.com?client_id=your_id&response_type=code&code_challenge=kjasBS523KdkAILD2k78NdcJSk2k3KHG6'
+            >>> client.prepare_request_uri('https://example.com', code_challenge_method='S256')
+            'https://example.com?client_id=your_id&response_type=code&code_challenge_method=S256'
             >>> client.prepare_request_uri('https://example.com', foo='bar')
             'https://example.com?client_id=your_id&response_type=code&foo=bar'
 
@@ -87,10 +98,11 @@ class WebApplicationClient(Client):
         """
         scope = self.scope if scope is None else scope
         return prepare_grant_uri(uri, self.client_id, 'code',
-                                 redirect_uri=redirect_uri, scope=scope, state=state, **kwargs)
+                                 redirect_uri=redirect_uri, scope=scope, state=state, code_challenge=code_challenge,
+                                 code_challenge_method=code_challenge_method, **kwargs)
 
     def prepare_request_body(self, code=None, redirect_uri=None, body='',
-                             include_client_id=True, **kwargs):
+                             include_client_id=True, code_verifier=None, **kwargs):
         """Prepare the access token request body.
 
         The client makes a request to the token endpoint by adding the
@@ -113,6 +125,9 @@ class WebApplicationClient(Client):
                                   authorization server as described in `Section 3.2.1`_.
         :type include_client_id: Boolean
 
+        :param code_verifier: OPTIONAL. A cryptographically random string that is used to correlate the
+                                        authorization request to the token request.
+
         :param kwargs: Extra parameters to include in the token request.
 
         In addition OAuthLib will add the ``grant_type`` parameter set to
@@ -127,6 +142,8 @@ class WebApplicationClient(Client):
             >>> client = WebApplicationClient('your_id')
             >>> client.prepare_request_body(code='sh35ksdf09sf')
             'grant_type=authorization_code&code=sh35ksdf09sf'
+            >>> client.prepare_request_body(code_verifier='KB46DCKJ873NCGXK5GD682NHDKK34GR')
+            'grant_type=authorization_code&code_verifier=KB46DCKJ873NCGXK5GD682NHDKK34GR'
             >>> client.prepare_request_body(code='sh35ksdf09sf', foo='bar')
             'grant_type=authorization_code&code=sh35ksdf09sf&foo=bar'
 
@@ -154,7 +171,7 @@ class WebApplicationClient(Client):
         kwargs['client_id'] = self.client_id
         kwargs['include_client_id'] = include_client_id
         return prepare_token_request(self.grant_type, code=code, body=body,
-                                     redirect_uri=redirect_uri, **kwargs)
+                                     redirect_uri=redirect_uri, code_verifier=code_verifier, **kwargs)
 
     def parse_request_uri_response(self, uri, state=None):
         """Parse the URI query for code and state.
diff --git a/lib/oauthlib/oauth2/rfc6749/endpoints/metadata.py b/lib/oauthlib/oauth2/rfc6749/endpoints/metadata.py
index 81ee1def..d43a8247 100644
--- a/lib/oauthlib/oauth2/rfc6749/endpoints/metadata.py
+++ b/lib/oauthlib/oauth2/rfc6749/endpoints/metadata.py
@@ -54,7 +54,8 @@ class MetadataEndpoint(BaseEndpoint):
         """Create metadata response
         """
         headers = {
-            'Content-Type': 'application/json'
+            'Content-Type': 'application/json',
+            'Access-Control-Allow-Origin': '*',
         }
         return headers, json.dumps(self.claims), 200
 
diff --git a/lib/oauthlib/oauth2/rfc6749/errors.py b/lib/oauthlib/oauth2/rfc6749/errors.py
index b01e247b..da24feab 100644
--- a/lib/oauthlib/oauth2/rfc6749/errors.py
+++ b/lib/oauthlib/oauth2/rfc6749/errors.py
@@ -103,15 +103,12 @@ class OAuth2Error(Exception):
             value "Bearer".  This scheme MUST be followed by one or more
             auth-param values.
             """
-            authvalues = [
-                "Bearer",
-                'error="{}"'.format(self.error)
-            ]
+            authvalues = ['error="{}"'.format(self.error)]
             if self.description:
                 authvalues.append('error_description="{}"'.format(self.description))
             if self.uri:
                 authvalues.append('error_uri="{}"'.format(self.uri))
-            return {"WWW-Authenticate": ", ".join(authvalues)}
+            return {"WWW-Authenticate": "Bearer " + ", ".join(authvalues)}
         return {}
 
 
diff --git a/lib/oauthlib/oauth2/rfc6749/grant_types/authorization_code.py b/lib/oauthlib/oauth2/rfc6749/grant_types/authorization_code.py
index bf42d889..b799823e 100644
--- a/lib/oauthlib/oauth2/rfc6749/grant_types/authorization_code.py
+++ b/lib/oauthlib/oauth2/rfc6749/grant_types/authorization_code.py
@@ -10,6 +10,7 @@ import logging
 from oauthlib import common
 
 from .. import errors
+from ..utils import is_secure_transport
 from .base import GrantTypeBase
 
 log = logging.getLogger(__name__)
@@ -272,6 +273,8 @@ class AuthorizationCodeGrant(GrantTypeBase):
         grant = self.create_authorization_code(request)
         for modifier in self._code_modifiers:
             grant = modifier(grant, token_handler, request)
+        if 'access_token' in grant:
+            self.request_validator.save_token(grant, request)
         log.debug('Saving grant %r for %r.', grant, request)
         self.request_validator.save_authorization_code(
             request.client_id, grant, request)
@@ -310,6 +313,7 @@ class AuthorizationCodeGrant(GrantTypeBase):
         self.request_validator.save_token(token, request)
         self.request_validator.invalidate_authorization_code(
             request.client_id, request.code, request)
+        headers.update(self._create_cors_headers(request))
         return headers, json.dumps(token), 200
 
     def validate_authorization_request(self, request):
@@ -543,3 +547,20 @@ class AuthorizationCodeGrant(GrantTypeBase):
         if challenge_method in self._code_challenge_methods:
             return self._code_challenge_methods[challenge_method](verifier, challenge)
         raise NotImplementedError('Unknown challenge_method %s' % challenge_method)
+
+    def _create_cors_headers(self, request):
+        """If CORS is allowed, create the appropriate headers."""
+        if 'origin' not in request.headers:
+            return {}
+
+        origin = request.headers['origin']
+        if not is_secure_transport(origin):
+            log.debug('Origin "%s" is not HTTPS, CORS not allowed.', origin)
+            return {}
+        elif not self.request_validator.is_origin_allowed(
+            request.client_id, origin, request):
+            log.debug('Invalid origin "%s", CORS not allowed.', origin)
+            return {}
+        else:
+            log.debug('Valid origin "%s", injecting CORS headers.', origin)
+            return {'Access-Control-Allow-Origin': origin}
diff --git a/lib/oauthlib/oauth2/rfc6749/grant_types/refresh_token.py b/lib/oauthlib/oauth2/rfc6749/grant_types/refresh_token.py
index 8698a3d5..f801de4a 100644
--- a/lib/oauthlib/oauth2/rfc6749/grant_types/refresh_token.py
+++ b/lib/oauthlib/oauth2/rfc6749/grant_types/refresh_token.py
@@ -63,7 +63,7 @@ class RefreshTokenGrant(GrantTypeBase):
                                            refresh_token=self.issue_new_refresh_tokens)
 
         for modifier in self._token_modifiers:
-            token = modifier(token)
+            token = modifier(token, token_handler, request)
 
         self.request_validator.save_token(token, request)
 
diff --git a/lib/oauthlib/oauth2/rfc6749/parameters.py b/lib/oauthlib/oauth2/rfc6749/parameters.py
index f07b8bd2..44738bb4 100644
--- a/lib/oauthlib/oauth2/rfc6749/parameters.py
+++ b/lib/oauthlib/oauth2/rfc6749/parameters.py
@@ -23,7 +23,7 @@ from .utils import is_secure_transport, list_to_scope, scope_to_list
 
 
 def prepare_grant_uri(uri, client_id, response_type, redirect_uri=None,
-                      scope=None, state=None, **kwargs):
+                      scope=None, state=None, code_challenge=None, code_challenge_method='plain', **kwargs):
     """Prepare the authorization grant request URI.
 
     The client constructs the request URI by adding the following
@@ -45,6 +45,11 @@ def prepare_grant_uri(uri, client_id, response_type, redirect_uri=None,
                   back to the client.  The parameter SHOULD be used for
                   preventing cross-site request forgery as described in
                   `Section 10.12`_.
+    :param code_challenge: PKCE paramater. A challenge derived from the 
+                           code_verifier that is sent in the authorization 
+                           request, to be verified against later.
+    :param code_challenge_method: PKCE parameter. A method that was used to derive the 
+                                  code_challenge. Defaults to "plain" if not present in the request.
     :param kwargs: Extra arguments to embed in the grant/authorization URL.
 
     An example of an authorization code grant authorization URL:
@@ -52,6 +57,7 @@ def prepare_grant_uri(uri, client_id, response_type, redirect_uri=None,
     .. code-block:: http
 
         GET /authorize?response_type=code&client_id=s6BhdRkqt3&state=xyz
+            &code_challenge=kjasBS523KdkAILD2k78NdcJSk2k3KHG6&code_challenge_method=S256
             &redirect_uri=https%3A%2F%2Fclient%2Eexample%2Ecom%2Fcb HTTP/1.1
         Host: server.example.com
 
@@ -73,6 +79,9 @@ def prepare_grant_uri(uri, client_id, response_type, redirect_uri=None,
         params.append(('scope', list_to_scope(scope)))
     if state:
         params.append(('state', state))
+    if code_challenge is not None:
+        params.append(('code_challenge', code_challenge))
+        params.append(('code_challenge_method', code_challenge_method))
 
     for k in kwargs:
         if kwargs[k]:
@@ -81,7 +90,7 @@ def prepare_grant_uri(uri, client_id, response_type, redirect_uri=None,
     return add_params_to_uri(uri, params)
 
 
-def prepare_token_request(grant_type, body='', include_client_id=True, **kwargs):
+def prepare_token_request(grant_type, body='', include_client_id=True, code_verifier=None, **kwargs):
     """Prepare the access token request.
 
     The client makes a request to the token endpoint by adding the
@@ -116,6 +125,9 @@ def prepare_token_request(grant_type, body='', include_client_id=True, **kwargs)
                          authorization request as described in
                          `Section 4.1.1`_, and their values MUST be identical. *
 
+    :param code_verifier: PKCE parameter. A cryptographically random string that is used to correlate the
+                          authorization request to the token request.
+
     :param kwargs: Extra arguments to embed in the request body.
 
     Parameters marked with a `*` above are not explicit arguments in the
@@ -142,6 +154,10 @@ def prepare_token_request(grant_type, body='', include_client_id=True, **kwargs)
         if client_id is not None:
             params.append(('client_id', client_id))
 
+    # use code_verifier if code_challenge was passed in the authorization request
+    if code_verifier is not None:
+        params.append(('code_verifier', code_verifier))
+
     # the kwargs iteration below only supports including boolean truth (truthy)
     # values, but some servers may require an empty string for `client_secret`
     client_secret = kwargs.pop('client_secret', None)
diff --git a/lib/oauthlib/oauth2/rfc6749/request_validator.py b/lib/oauthlib/oauth2/rfc6749/request_validator.py
index 817d594b..610a708d 100644
--- a/lib/oauthlib/oauth2/rfc6749/request_validator.py
+++ b/lib/oauthlib/oauth2/rfc6749/request_validator.py
@@ -649,3 +649,28 @@ class RequestValidator:
 
         """
         raise NotImplementedError('Subclasses must implement this method.')
+
+    def is_origin_allowed(self, client_id, origin, request, *args, **kwargs):
+        """Indicate if the given origin is allowed to access the token endpoint
+        via Cross-Origin Resource Sharing (CORS).  CORS is used by browser-based
+        clients, such as Single-Page Applications, to perform the Authorization
+        Code Grant.
+
+        (Note:  If performing Authorization Code Grant via a public client such
+        as a browser, you should use PKCE as well.)
+
+        If this method returns true, the appropriate CORS headers will be added
+        to the response.  By default this method always returns False, meaning
+        CORS is disabled.
+
+        :param client_id: Unicode client identifier.
+        :param redirect_uri: Unicode origin.
+        :param request: OAuthlib request.
+        :type request: oauthlib.common.Request
+        :rtype: bool
+
+        Method is used by:
+            - Authorization Code Grant
+
+        """
+        return False
diff --git a/lib/oauthlib/oauth2/rfc8628/__init__.py b/lib/oauthlib/oauth2/rfc8628/__init__.py
new file mode 100644
index 00000000..531929dc
--- /dev/null
+++ b/lib/oauthlib/oauth2/rfc8628/__init__.py
@@ -0,0 +1,10 @@
+"""
+oauthlib.oauth2.rfc8628
+~~~~~~~~~~~~~~~~~~~~~~~
+
+This module is an implementation of various logic needed
+for consuming and providing OAuth 2.0 Device Authorization RFC8628.
+"""
+import logging
+
+log = logging.getLogger(__name__)
diff --git a/lib/oauthlib/oauth2/rfc8628/clients/__init__.py b/lib/oauthlib/oauth2/rfc8628/clients/__init__.py
new file mode 100644
index 00000000..130b52e3
--- /dev/null
+++ b/lib/oauthlib/oauth2/rfc8628/clients/__init__.py
@@ -0,0 +1,8 @@
+"""
+oauthlib.oauth2.rfc8628
+~~~~~~~~~~~~~~~~~~~~~~~
+
+This module is an implementation of various logic needed
+for consuming OAuth 2.0 Device Authorization RFC8628.
+"""
+from .device import DeviceClient
diff --git a/lib/oauthlib/oauth2/rfc8628/clients/device.py b/lib/oauthlib/oauth2/rfc8628/clients/device.py
new file mode 100644
index 00000000..95c4f5a2
--- /dev/null
+++ b/lib/oauthlib/oauth2/rfc8628/clients/device.py
@@ -0,0 +1,94 @@
+"""
+oauthlib.oauth2.rfc8628
+~~~~~~~~~~~~~~~~~~~~~~~
+
+This module is an implementation of various logic needed
+for consuming and providing OAuth 2.0 Device Authorization RFC8628.
+"""
+
+from oauthlib.oauth2 import BackendApplicationClient, Client
+from oauthlib.oauth2.rfc6749.errors import InsecureTransportError
+from oauthlib.oauth2.rfc6749.parameters import prepare_token_request
+from oauthlib.oauth2.rfc6749.utils import is_secure_transport, list_to_scope
+from oauthlib.common import add_params_to_uri
+
+
+class DeviceClient(Client):
+
+    """A public client utilizing the device authorization workflow.
+
+    The client can request an access token using a device code and
+    a public client id associated with the device code as defined
+    in RFC8628.
+
+    The device authorization grant type can be used to obtain both
+    access tokens and refresh tokens and is intended to be used in
+    a scenario where the device being authorized does not have a
+    user interface that is suitable for performing authentication.
+    """
+
+    grant_type = 'urn:ietf:params:oauth:grant-type:device_code'
+
+    def __init__(self, client_id, **kwargs):
+        super().__init__(client_id, **kwargs)
+        self.client_secret = kwargs.get('client_secret')
+
+    def prepare_request_uri(self, uri, scope=None, **kwargs):
+        if not is_secure_transport(uri):
+            raise InsecureTransportError()
+
+        scope = self.scope if scope is None else scope
+        params = [(('client_id', self.client_id)), (('grant_type', self.grant_type))]
+
+        if self.client_secret is not None:
+            params.append(('client_secret', self.client_secret))
+
+        if scope:
+            params.append(('scope', list_to_scope(scope)))
+
+        for k in kwargs:
+            if kwargs[k]:
+                params.append((str(k), kwargs[k]))
+
+        return add_params_to_uri(uri, params)
+
+    def prepare_request_body(self, device_code, body='', scope=None,
+                             include_client_id=False, **kwargs):
+        """Add device_code to request body
+
+        The client makes a request to the token endpoint by adding the
+        device_code as a parameter using the
+        "application/x-www-form-urlencoded" format to the HTTP request
+        body.
+
+        :param body: Existing request body (URL encoded string) to embed parameters
+                     into. This may contain extra paramters. Default ''.
+        :param scope:   The scope of the access request as described by
+                        `Section 3.3`_.
+
+        :param include_client_id: `True` to send the `client_id` in the
+                                  body of the upstream request. This is required
+                                  if the client is not authenticating with the
+                                  authorization server as described in
+                                  `Section 3.2.1`_. False otherwise (default).
+        :type include_client_id: Boolean
+
+        :param kwargs:  Extra credentials to include in the token request.
+
+        The prepared body will include all provided device_code as well as
+        the ``grant_type`` parameter set to
+        ``urn:ietf:params:oauth:grant-type:device_code``::
+
+            >>> from oauthlib.oauth2 import DeviceClient
+            >>> client = DeviceClient('your_id', 'your_code')
+            >>> client.prepare_request_body(scope=['hello', 'world'])
+            'grant_type=urn:ietf:params:oauth:grant-type:device_code&scope=hello+world'
+
+        .. _`Section 3.4`: https://datatracker.ietf.org/doc/html/rfc8628#section-3.4
+        """
+
+        kwargs['client_id'] = self.client_id
+        kwargs['include_client_id'] = include_client_id
+        scope = self.scope if scope is None else scope
+        return prepare_token_request(self.grant_type, body=body, device_code=device_code,
+                                     scope=scope, **kwargs)
diff --git a/lib/oauthlib/openid/connect/core/grant_types/__init__.py b/lib/oauthlib/openid/connect/core/grant_types/__init__.py
index 887a5850..8dad5f60 100644
--- a/lib/oauthlib/openid/connect/core/grant_types/__init__.py
+++ b/lib/oauthlib/openid/connect/core/grant_types/__init__.py
@@ -10,3 +10,4 @@ from .dispatchers import (
 )
 from .hybrid import HybridGrant
 from .implicit import ImplicitGrant
+from .refresh_token import RefreshTokenGrant
diff --git a/lib/oauthlib/openid/connect/core/grant_types/refresh_token.py b/lib/oauthlib/openid/connect/core/grant_types/refresh_token.py
new file mode 100644
index 00000000..43e4499c
--- /dev/null
+++ b/lib/oauthlib/openid/connect/core/grant_types/refresh_token.py
@@ -0,0 +1,34 @@
+"""
+oauthlib.openid.connect.core.grant_types
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+"""
+import logging
+
+from oauthlib.oauth2.rfc6749.grant_types.refresh_token import (
+    RefreshTokenGrant as OAuth2RefreshTokenGrant,
+)
+
+from .base import GrantTypeBase
+
+log = logging.getLogger(__name__)
+
+
+class RefreshTokenGrant(GrantTypeBase):
+
+    def __init__(self, request_validator=None, **kwargs):
+        self.proxy_target = OAuth2RefreshTokenGrant(
+            request_validator=request_validator, **kwargs)
+        self.register_token_modifier(self.add_id_token)
+
+    def add_id_token(self, token, token_handler, request):
+        """
+        Construct an initial version of id_token, and let the
+        request_validator sign or encrypt it.
+
+        The authorization_code version of this method is used to
+        retrieve the nonce accordingly to the code storage.
+        """
+        if not self.request_validator.refresh_id_token(request):
+            return token
+
+        return super().add_id_token(token, token_handler, request)
diff --git a/lib/oauthlib/openid/connect/core/request_validator.py b/lib/oauthlib/openid/connect/core/request_validator.py
index e8f334b0..47c4cd94 100644
--- a/lib/oauthlib/openid/connect/core/request_validator.py
+++ b/lib/oauthlib/openid/connect/core/request_validator.py
@@ -306,3 +306,15 @@ class RequestValidator(OAuth2RequestValidator):
         Method is used by:
             UserInfoEndpoint
         """
+
+    def refresh_id_token(self, request):
+        """Whether the id token should be refreshed. Default, True
+
+        :param request: OAuthlib request.
+        :type request: oauthlib.common.Request
+        :rtype: True or False
+
+        Method is used by:
+            RefreshTokenGrant
+        """
+        return True
diff --git a/lib/requests_oauthlib/__init__.py b/lib/requests_oauthlib/__init__.py
index a4e03a4e..0d3e49f9 100644
--- a/lib/requests_oauthlib/__init__.py
+++ b/lib/requests_oauthlib/__init__.py
@@ -5,7 +5,7 @@ from .oauth1_session import OAuth1Session
 from .oauth2_auth import OAuth2
 from .oauth2_session import OAuth2Session, TokenUpdated
 
-__version__ = "1.3.0"
+__version__ = "1.3.1"
 
 import requests
 
diff --git a/lib/requests_oauthlib/compliance_fixes/__init__.py b/lib/requests_oauthlib/compliance_fixes/__init__.py
index 02fa5120..0e8e3ac8 100644
--- a/lib/requests_oauthlib/compliance_fixes/__init__.py
+++ b/lib/requests_oauthlib/compliance_fixes/__init__.py
@@ -2,9 +2,9 @@ from __future__ import absolute_import
 
 from .facebook import facebook_compliance_fix
 from .fitbit import fitbit_compliance_fix
-from .linkedin import linkedin_compliance_fix
 from .slack import slack_compliance_fix
 from .instagram import instagram_compliance_fix
 from .mailchimp import mailchimp_compliance_fix
 from .weibo import weibo_compliance_fix
 from .plentymarkets import plentymarkets_compliance_fix
+from .ebay import ebay_compliance_fix
diff --git a/lib/requests_oauthlib/compliance_fixes/ebay.py b/lib/requests_oauthlib/compliance_fixes/ebay.py
new file mode 100644
index 00000000..4aa423b3
--- /dev/null
+++ b/lib/requests_oauthlib/compliance_fixes/ebay.py
@@ -0,0 +1,23 @@
+import json
+from oauthlib.common import to_unicode
+
+
+def ebay_compliance_fix(session):
+    def _compliance_fix(response):
+        token = json.loads(response.text)
+
+        # eBay responds with non-compliant token types.
+        # https://developer.ebay.com/api-docs/static/oauth-client-credentials-grant.html
+        # https://developer.ebay.com/api-docs/static/oauth-auth-code-grant-request.html
+        # Modify these to be "Bearer".
+        if token.get("token_type") in ["Application Access Token", "User Access Token"]:
+            token["token_type"] = "Bearer"
+            fixed_token = json.dumps(token)
+            response._content = to_unicode(fixed_token).encode("utf-8")
+
+        return response
+
+    session.register_compliance_hook("access_token_response", _compliance_fix)
+    session.register_compliance_hook("refresh_token_response", _compliance_fix)
+
+    return session
diff --git a/lib/requests_oauthlib/compliance_fixes/linkedin.py b/lib/requests_oauthlib/compliance_fixes/linkedin.py
deleted file mode 100644
index cd5b4ace..00000000
--- a/lib/requests_oauthlib/compliance_fixes/linkedin.py
+++ /dev/null
@@ -1,21 +0,0 @@
-from json import loads, dumps
-
-from oauthlib.common import add_params_to_uri, to_unicode
-
-
-def linkedin_compliance_fix(session):
-    def _missing_token_type(r):
-        token = loads(r.text)
-        token["token_type"] = "Bearer"
-        r._content = to_unicode(dumps(token)).encode("UTF-8")
-        return r
-
-    def _non_compliant_param_name(url, headers, data):
-        token = [("oauth2_access_token", session.access_token)]
-        url = add_params_to_uri(url, token)
-        return url, headers, data
-
-    session._client.default_token_placement = "query"
-    session.register_compliance_hook("access_token_response", _missing_token_type)
-    session.register_compliance_hook("protected_request", _non_compliant_param_name)
-    return session
diff --git a/lib/requests_oauthlib/oauth1_session.py b/lib/requests_oauthlib/oauth1_session.py
index aa17f28f..88f2853c 100644
--- a/lib/requests_oauthlib/oauth1_session.py
+++ b/lib/requests_oauthlib/oauth1_session.py
@@ -268,7 +268,7 @@ class OAuth1Session(requests.Session):
         :param url: The request token endpoint URL.
         :param realm: A list of realms to request access to.
         :param \*\*request_kwargs: Optional arguments passed to ''post''
-        function in ''requests.Session''
+            function in ''requests.Session''
         :returns: The response in dict format.
 
         Note that a previously set callback_uri will be reset for your
diff --git a/lib/requests_oauthlib/oauth2_session.py b/lib/requests_oauthlib/oauth2_session.py
index eea4ac6f..db446808 100644
--- a/lib/requests_oauthlib/oauth2_session.py
+++ b/lib/requests_oauthlib/oauth2_session.py
@@ -189,6 +189,7 @@ class OAuth2Session(requests.Session):
         proxies=None,
         include_client_id=None,
         client_secret=None,
+        cert=None,
         **kwargs
     ):
         """Generic method for fetching an access token from the token endpoint.
@@ -229,6 +230,10 @@ class OAuth2Session(requests.Session):
                               `auth` tuple. If the value is `None`, it will be
                               omitted from the request, however if the value is
                               an empty string, an empty string will be sent.
+        :param cert: Client certificate to send for OAuth 2.0 Mutual-TLS Client
+                     Authentication (draft-ietf-oauth-mtls). Can either be the
+                     path of a file containing the private key and certificate or
+                     a tuple of two filenames for certificate and key.
         :param kwargs: Extra parameters to include in the token request.
         :return: A token dict
         """
@@ -341,6 +346,7 @@ class OAuth2Session(requests.Session):
             auth=auth,
             verify=verify,
             proxies=proxies,
+            cert=cert,
             **request_kwargs
         )
 
diff --git a/requirements.txt b/requirements.txt
index 6388dc9f..25a4ecf8 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -24,7 +24,6 @@ IPy==1.01
 Mako==1.1.6
 MarkupSafe==2.0.1
 musicbrainzngs==0.7.1
-oauthlib==3.1.1
 packaging==21.3
 paho-mqtt==1.6.1
 plexapi==4.9.1
@@ -36,7 +35,7 @@ python-dateutil==2.8.2
 python-twitter==3.5
 pytz==2021.3
 requests==2.27.1
-requests-oauthlib==1.3.0
+requests-oauthlib==1.3.1
 rumps==0.3.0; platform_system == "Darwin"
 simplejson==3.17.6
 six==1.16.0

From 9c3d7005845f4de7a2df373e6f4ae552a749e899 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 7 Feb 2022 21:58:10 -0800
Subject: [PATCH 014/743] Bump tempora from 5.0.0 to 5.0.1 (#1642)

Bumps [tempora](https://github.com/jaraco/tempora) from 5.0.0 to 5.0.1.
- [Release notes](https://github.com/jaraco/tempora/releases)
- [Changelog](https://github.com/jaraco/tempora/blob/main/CHANGES.rst)
- [Commits](https://github.com/jaraco/tempora/compare/v5.0.0...v5.0.1)

---
updated-dependencies:
- dependency-name: tempora
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

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

[skip ci]
---
 requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements.txt b/requirements.txt
index 25a4ecf8..5ec7d931 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -40,7 +40,7 @@ rumps==0.3.0; platform_system == "Darwin"
 simplejson==3.17.6
 six==1.16.0
 soupsieve==2.3.1
-tempora==5.0.0
+tempora==5.0.1
 tokenize-rt==4.2.1
 tzdata==2021.5
 tzlocal==2.1  # apscheduler==3.8.0 requires tzlocal~=2.0

From 44e65952f9fa969ceccf7102a40019ae4f933b75 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 7 Feb 2022 21:58:28 -0800
Subject: [PATCH 015/743] Bump cloudinary from 1.28.1 to 1.29.0 (#1643)

* Bump cloudinary from 1.28.1 to 1.29.0

Bumps [cloudinary](https://github.com/cloudinary/pycloudinary) from 1.28.1 to 1.29.0.
- [Release notes](https://github.com/cloudinary/pycloudinary/releases)
- [Changelog](https://github.com/cloudinary/pycloudinary/blob/master/CHANGELOG.md)
- [Commits](https://github.com/cloudinary/pycloudinary/compare/1.28.1...1.29.0)

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

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

* Update cloudinary==1.29.0

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/cloudinary/__init__.py                    |   2 +-
 .../api_client/tcp_keep_alive_manager.py      | 119 ++++++++++++++++++
 lib/cloudinary/uploader.py                    |  32 ++++-
 lib/cloudinary/utils.py                       |  15 ++-
 requirements.txt                              |   2 +-
 5 files changed, 163 insertions(+), 7 deletions(-)
 create mode 100644 lib/cloudinary/api_client/tcp_keep_alive_manager.py

diff --git a/lib/cloudinary/__init__.py b/lib/cloudinary/__init__.py
index 56e7b5b7..5e315049 100644
--- a/lib/cloudinary/__init__.py
+++ b/lib/cloudinary/__init__.py
@@ -38,7 +38,7 @@ CL_BLANK = "data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAA
 URI_SCHEME = "cloudinary"
 API_VERSION = "v1_1"
 
-VERSION = "1.28.1"
+VERSION = "1.29.0"
 
 USER_AGENT = "CloudinaryPython/{} (Python {})".format(VERSION, python_version())
 """ :const: USER_AGENT """
diff --git a/lib/cloudinary/api_client/tcp_keep_alive_manager.py b/lib/cloudinary/api_client/tcp_keep_alive_manager.py
new file mode 100644
index 00000000..b2c7b75f
--- /dev/null
+++ b/lib/cloudinary/api_client/tcp_keep_alive_manager.py
@@ -0,0 +1,119 @@
+import socket
+import sys
+
+from urllib3 import HTTPSConnectionPool, HTTPConnectionPool, PoolManager, ProxyManager
+
+# Inspired by:
+# https://github.com/finbourne/lusid-sdk-python/blob/b813882e4f1777ea78670a03a7596486639e6f40/sdk/lusid/tcp/tcp_keep_alive_probes.py
+
+# The content to send on Mac OS in the TCP Keep Alive probe
+TCP_KEEPALIVE = 0x10
+# The maximum time to keep the connection idle before sending probes
+TCP_KEEP_IDLE = 60
+# The interval between probes
+TCP_KEEPALIVE_INTERVAL = 60
+# The maximum number of failed probes before terminating the connection
+TCP_KEEP_CNT = 3
+
+
+class TCPKeepAliveValidationMethods:
+    """
+    This class contains a single method whose sole purpose is to set up TCP Keep Alive probes on the socket for a
+    connection. This is necessary for long-running requests which will be silently terminated by the AWS Network Load
+    Balancer which kills a connection if it is idle for more than 350 seconds.
+    """
+
+    @staticmethod
+    def adjust_connection_socket(conn, protocol="https"):
+        """
+        Adjusts the socket settings so that the client sends a TCP keep alive probe over the connection. This is only
+        applied where possible, if the ability to set the socket options is not available, for example using Anaconda,
+        then the settings will be left as is.
+        :param conn: The connection to update the socket settings for
+        :param str protocol: The protocol of the connection
+        :return: None
+        """
+
+        if protocol == "http":
+            # It isn't clear how to set this up over HTTP, it seems to differ from HTTPs
+            return
+
+        # TCP Keep Alive Probes for different platforms
+        platform = sys.platform
+        # TCP Keep Alive Probes for Linux
+        if (platform == 'linux' and hasattr(conn.sock, "setsockopt") and hasattr(socket, "SO_KEEPALIVE") and
+                hasattr(socket, "TCP_KEEPIDLE") and hasattr(socket, "TCP_KEEPINTVL") and hasattr(socket,
+                                                                                                 "TCP_KEEPCNT")):
+            conn.sock.setsockopt(socket.SOL_SOCKET, socket.SO_KEEPALIVE, 1)
+            conn.sock.setsockopt(socket.IPPROTO_TCP, socket.TCP_KEEPIDLE, TCP_KEEP_IDLE)
+            conn.sock.setsockopt(socket.IPPROTO_TCP, socket.TCP_KEEPINTVL, TCP_KEEPALIVE_INTERVAL)
+            conn.sock.setsockopt(socket.IPPROTO_TCP, socket.TCP_KEEPCNT, TCP_KEEP_CNT)
+
+        # TCP Keep Alive Probes for Windows OS
+        elif platform == 'win32' and hasattr(socket, "SIO_KEEPALIVE_VALS") and getattr(conn.sock, "ioctl",
+                                                                                       None) is not None:
+            conn.sock.ioctl(socket.SIO_KEEPALIVE_VALS, (1, TCP_KEEP_IDLE * 1000, TCP_KEEPALIVE_INTERVAL * 1000))
+
+        # TCP Keep Alive Probes for Mac OS
+        elif platform == 'darwin' and getattr(conn.sock, "setsockopt", None) is not None:
+            conn.sock.setsockopt(socket.SOL_SOCKET, socket.SO_KEEPALIVE, 1)
+            conn.sock.setsockopt(socket.IPPROTO_TCP, TCP_KEEPALIVE, TCP_KEEPALIVE_INTERVAL)
+
+
+class TCPKeepAliveHTTPSConnectionPool(HTTPSConnectionPool):
+    """
+    This class overrides the _validate_conn method in the HTTPSConnectionPool class. This is the entry point to use
+    for modifying the socket as it is called after the socket is created and before the request is made.
+    """
+
+    def _validate_conn(self, conn):
+        """
+        Called right before a request is made, after the socket is created.
+        """
+        # Call the method on the base class
+        super(TCPKeepAliveHTTPSConnectionPool, self)._validate_conn(conn)
+
+        # Set up TCP Keep Alive probes, this is the only line added to this function
+        TCPKeepAliveValidationMethods.adjust_connection_socket(conn, "https")
+
+
+class TCPKeepAliveHTTPConnectionPool(HTTPConnectionPool):
+    """
+    This class overrides the _validate_conn method in the HTTPSConnectionPool class. This is the entry point to use
+    for modifying the socket as it is called after the socket is created and before the request is made.
+    In the base class this method is passed completely.
+    """
+
+    def _validate_conn(self, conn):
+        """
+        Called right before a request is made, after the socket is created.
+        """
+        # Call the method on the base class
+        super(TCPKeepAliveHTTPConnectionPool, self)._validate_conn(conn)
+
+        # Set up TCP Keep Alive probes, this is the only line added to this function
+        TCPKeepAliveValidationMethods.adjust_connection_socket(conn, "http")
+
+
+class TCPKeepAlivePoolManager(PoolManager):
+    """
+    This Pool Manager has only had the pool_classes_by_scheme variable changed. This now points at the TCPKeepAlive
+    connection pools rather than the default connection pools.
+    """
+
+    def __init__(self, num_pools=10, headers=None, **connection_pool_kw):
+        super(TCPKeepAlivePoolManager, self).__init__(num_pools=num_pools, headers=headers, **connection_pool_kw)
+        self.pool_classes_by_scheme = {"http": TCPKeepAliveHTTPConnectionPool, "https": TCPKeepAliveHTTPSConnectionPool}
+
+
+class TCPKeepAliveProxyManager(ProxyManager):
+    """
+    This Proxy Manager has only had the pool_classes_by_scheme variable changed. This now points at the TCPKeepAlive
+    connection pools rather than the default connection pools.
+    """
+
+    def __init__(self, proxy_url, num_pools=10, headers=None, proxy_headers=None, **connection_pool_kw):
+        super(TCPKeepAliveProxyManager, self).__init__(proxy_url=proxy_url, num_pools=num_pools, headers=headers,
+                                                       proxy_headers=proxy_headers,
+                                                       **connection_pool_kw)
+        self.pool_classes_by_scheme = {"http": TCPKeepAliveHTTPConnectionPool, "https": TCPKeepAliveHTTPSConnectionPool}
diff --git a/lib/cloudinary/uploader.py b/lib/cloudinary/uploader.py
index 3b1c63b3..3b118142 100644
--- a/lib/cloudinary/uploader.py
+++ b/lib/cloudinary/uploader.py
@@ -277,18 +277,48 @@ def explode(public_id, **options):
     return call_api("explode", params, **options)
 
 
-# options may include 'exclusive' (boolean) which causes clearing this tag from all other resources
 def add_tag(tag, public_ids=None, **options):
+    """
+    Adds a single tag or a list of tags or a comma-separated tags to the assets.
+
+    :param tag:         The tag or tags to assign. Can specify multiple tags in a single string,
+                        separated by commas - "t1,t2,t3" or list of tags - ["t1","t2","t3"].
+    :param public_ids:  A list of public IDs (up to 1000).
+    :param options:     Configuration options may include 'exclusive' (boolean) which causes
+                        clearing this tag from all other assets.
+
+    :return:            Dictionary with a list of public IDs that were updated.
+    """
     exclusive = options.pop("exclusive", None)
     command = "set_exclusive" if exclusive else "add"
     return call_tags_api(tag, command, public_ids, **options)
 
 
 def remove_tag(tag, public_ids=None, **options):
+    """
+    Removes a single tag or a list of tags or a comma-separated tags from the assets.
+
+    :param tag:         The tag or tags to assign. Can specify multiple tags in a single string,
+                        separated by commas - "t1,t2,t3" or list of tags - ["t1","t2","t3"].
+    :param public_ids:  A list of public IDs (up to 1000).
+    :param options:     Additional options.
+
+    :return:            Dictionary with a list of public IDs that were updated.
+    """
     return call_tags_api(tag, "remove", public_ids, **options)
 
 
 def replace_tag(tag, public_ids=None, **options):
+    """
+    Replaces all existing tags with a single tag or a list of tags or a comma-separated tags of the assets.
+
+    :param tag:         The tag or tags to assign. Can specify multiple tags in a single string,
+                        separated by commas - "t1,t2,t3" or list of tags - ["t1","t2","t3"].
+    :param public_ids:  A list of public IDs (up to 1000).
+    :param options:     Additional options.
+
+    :return:            Dictionary with a list of public IDs that were updated.
+    """
     return call_tags_api(tag, "replace", public_ids, **options)
 
 
diff --git a/lib/cloudinary/utils.py b/lib/cloudinary/utils.py
index f936b845..1fade15b 100644
--- a/lib/cloudinary/utils.py
+++ b/lib/cloudinary/utils.py
@@ -17,11 +17,12 @@ from fractions import Fraction
 from numbers import Number
 
 import six.moves.urllib.parse
-from six import iteritems, string_types
+from six import iteritems
 from urllib3 import ProxyManager, PoolManager
 
 import cloudinary
 from cloudinary import auth_token
+from cloudinary.api_client.tcp_keep_alive_manager import TCPKeepAlivePoolManager, TCPKeepAliveProxyManager
 from cloudinary.compat import PY3, to_bytes, to_bytearray, to_string, string_types, urlparse
 
 VAR_NAME_RE = r'(\$\([a-zA-Z]\w+\))'
@@ -1509,7 +1510,7 @@ def verify_notification_signature(body, timestamp, signature, valid_for=7200, al
 
 def get_http_connector(conf, options):
     """
-    Used to create http connector, depends on api_proxy configuration parameter
+    Used to create http connector, depends on api_proxy and disable_tcp_keep_alive configuration parameters.
 
     :param conf: configuration object
     :param options: additional options
@@ -1517,10 +1518,16 @@ def get_http_connector(conf, options):
     :return: ProxyManager if api_proxy is set, otherwise PoolManager object
     """
     if conf.api_proxy:
-        return ProxyManager(conf.api_proxy, **options)
-    else:
+        if conf.disable_tcp_keep_alive:
+            return ProxyManager(conf.api_proxy, **options)
+
+        return TCPKeepAliveProxyManager(conf.api_proxy, **options)
+
+    if conf.disable_tcp_keep_alive:
         return PoolManager(**options)
 
+    return TCPKeepAlivePoolManager(**options)
+
 
 def encode_list(obj):
     if isinstance(obj, list):
diff --git a/requirements.txt b/requirements.txt
index 5ec7d931..ed3dc9c5 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -9,7 +9,7 @@ bleach==4.1.0
 certifi==2021.10.8
 cheroot==8.6.0
 cherrypy==18.6.1
-cloudinary==1.28.1
+cloudinary==1.29.0
 distro==1.6.0
 dnspython==2.2.0
 facebook-sdk==3.1.0

From 9a9c98d0a0e95d80fe27ddf02ecdc19cfdc96f95 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 7 Feb 2022 21:58:50 -0800
Subject: [PATCH 016/743] Bump plexapi from 4.9.1 to 4.9.2 (#1647)

* Bump plexapi from 4.9.1 to 4.9.2

Bumps [plexapi](https://github.com/pkkid/python-plexapi) from 4.9.1 to 4.9.2.
- [Release notes](https://github.com/pkkid/python-plexapi/releases)
- [Commits](https://github.com/pkkid/python-plexapi/compare/4.9.1...4.9.2)

---
updated-dependencies:
- dependency-name: plexapi
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

* Update plexapi==4.9.2

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
---
 lib/plexapi/audio.py | 2 +-
 lib/plexapi/const.py | 2 +-
 requirements.txt     | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/lib/plexapi/audio.py b/lib/plexapi/audio.py
index 60b119d9..bef951d8 100644
--- a/lib/plexapi/audio.py
+++ b/lib/plexapi/audio.py
@@ -177,7 +177,7 @@ class Artist(Audio, AdvancedSettingsMixin, ArtMixin, PosterMixin, RatingMixin, S
 
     def albums(self, **kwargs):
         """ Returns a list of :class:`~plexapi.audio.Album` objects by the artist. """
-        key = '/library/metadata/%s/children' % self.ratingKey
+        key = f"/library/sections/{self.librarySectionID}/all?artist.id={self.ratingKey}&type=9"
         return self.fetchItems(key, Album, **kwargs)
 
     def track(self, title=None, album=None, track=None):
diff --git a/lib/plexapi/const.py b/lib/plexapi/const.py
index dc8b5693..72ad282f 100644
--- a/lib/plexapi/const.py
+++ b/lib/plexapi/const.py
@@ -4,6 +4,6 @@
 # Library version
 MAJOR_VERSION = 4
 MINOR_VERSION = 9
-PATCH_VERSION = 1
+PATCH_VERSION = 2
 __short_version__ = f"{MAJOR_VERSION}.{MINOR_VERSION}"
 __version__ = f"{__short_version__}.{PATCH_VERSION}"
diff --git a/requirements.txt b/requirements.txt
index ed3dc9c5..9c3cc11a 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -26,7 +26,7 @@ MarkupSafe==2.0.1
 musicbrainzngs==0.7.1
 packaging==21.3
 paho-mqtt==1.6.1
-plexapi==4.9.1
+plexapi==4.9.2
 portend==3.1.0
 profilehooks==1.12.0
 PyJWT==2.3.0

From 8170244812fc89edfc8ae6c66d91f9824af7bedf Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 7 Feb 2022 22:21:23 -0800
Subject: [PATCH 017/743] Bump pyopenssl from 21.0.0 to 22.0.0 (#1638)

Bumps [pyopenssl](https://github.com/pyca/pyopenssl) from 21.0.0 to 22.0.0.
- [Release notes](https://github.com/pyca/pyopenssl/releases)
- [Changelog](https://github.com/pyca/pyopenssl/blob/main/CHANGELOG.rst)
- [Commits](https://github.com/pyca/pyopenssl/compare/21.0.0...22.0.0)

---
updated-dependencies:
- dependency-name: pyopenssl
  dependency-type: direct:production
  update-type: version-update:semver-major
...

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

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

[skip ci]
---
 package/requirements-package.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index 58a47c02..2c1cc15f 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -1,7 +1,7 @@
 apscheduler==3.8.0
 importlib-resources==5.4.0
 pyinstaller==4.8
-pyopenssl==21.0.0
+pyopenssl==22.0.0
 pycryptodomex==3.13.0
 
 pyobjc-framework-Cocoa==8.2; platform_system == "Darwin"

From 922ab07ff1185c1fefb8cd2635f3ca0ee741f1ee Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 7 Feb 2022 22:22:00 -0800
Subject: [PATCH 018/743] Bump pycryptodomex from 3.13.0 to 3.14.1 (#1646)

Bumps [pycryptodomex](https://github.com/Legrandin/pycryptodome) from 3.13.0 to 3.14.1.
- [Release notes](https://github.com/Legrandin/pycryptodome/releases)
- [Changelog](https://github.com/Legrandin/pycryptodome/blob/master/Changelog.rst)
- [Commits](https://github.com/Legrandin/pycryptodome/compare/v3.13.0...v3.14.1)

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

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

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

[skip ci]
---
 package/requirements-package.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index 2c1cc15f..8ff19236 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -2,7 +2,7 @@ apscheduler==3.8.0
 importlib-resources==5.4.0
 pyinstaller==4.8
 pyopenssl==22.0.0
-pycryptodomex==3.13.0
+pycryptodomex==3.14.1
 
 pyobjc-framework-Cocoa==8.2; platform_system == "Darwin"
 pyobjc-core==8.2; platform_system == "Darwin"

From 97ef7c49816242207776cc9a521c1f2805e89bc2 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 7 Feb 2022 22:23:02 -0800
Subject: [PATCH 019/743] Bump pyinstaller from 4.8 to 4.9 (#1644)

Bumps [pyinstaller](https://github.com/pyinstaller/pyinstaller) from 4.8 to 4.9.
- [Release notes](https://github.com/pyinstaller/pyinstaller/releases)
- [Changelog](https://github.com/pyinstaller/pyinstaller/blob/v4.9/doc/CHANGES.rst)
- [Commits](https://github.com/pyinstaller/pyinstaller/compare/v4.8...v4.9)

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

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

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 package/requirements-package.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index 8ff19236..0a291e78 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -1,6 +1,6 @@
 apscheduler==3.8.0
 importlib-resources==5.4.0
-pyinstaller==4.8
+pyinstaller==4.9
 pyopenssl==22.0.0
 pycryptodomex==3.14.1
 

From 31aa9965d130402bb4bb8aeb36cdbcde68f23963 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 7 Feb 2022 22:46:25 -0800
Subject: [PATCH 020/743] Fix screen rotation in PWA

* Fixes #1633
---
 data/interfaces/default/base.html                    | 2 +-
 data/interfaces/default/images/favicon/manifest.json | 3 +--
 data/interfaces/default/login.html                   | 2 +-
 data/interfaces/default/welcome.html                 | 2 +-
 4 files changed, 4 insertions(+), 5 deletions(-)

diff --git a/data/interfaces/default/base.html b/data/interfaces/default/base.html
index 2fcb36c3..5e8d4447 100644
--- a/data/interfaces/default/base.html
+++ b/data/interfaces/default/base.html
@@ -30,7 +30,7 @@
 
     <!-- ICONS -->
     <!-- Android -->
-    <link rel="manifest" href="${http_root}images/favicon/manifest.json?v=2.6.0" crossorigin="use-credentials">
+    <link rel="manifest" href="${http_root}images/favicon/manifest.json?v=2.9.0" crossorigin="use-credentials">
     <meta name="theme-color" content="#282a2d">
     <!-- Apple -->
     <link rel="apple-touch-icon" sizes="180x180" href="${http_root}images/favicon/apple-touch-icon.png?v=2.6.0">
diff --git a/data/interfaces/default/images/favicon/manifest.json b/data/interfaces/default/images/favicon/manifest.json
index cf995208..7ed483cc 100644
--- a/data/interfaces/default/images/favicon/manifest.json
+++ b/data/interfaces/default/images/favicon/manifest.json
@@ -18,6 +18,5 @@
     ],
     "theme_color": "#282a2d",
     "background_color": "#282a2d",
-    "display": "standalone",
-    "orientation": "any"
+    "display": "standalone"
 }
\ No newline at end of file
diff --git a/data/interfaces/default/login.html b/data/interfaces/default/login.html
index 71a355d4..63b48deb 100644
--- a/data/interfaces/default/login.html
+++ b/data/interfaces/default/login.html
@@ -24,7 +24,7 @@
 
     <!-- ICONS -->
     <!-- Android -->
-    <link rel="manifest" href="${http_root}images/favicon/manifest.json?v=2.6.0" crossorigin="use-credentials">
+    <link rel="manifest" href="${http_root}images/favicon/manifest.json?v=2.9.0" crossorigin="use-credentials">
     <meta name="theme-color" content="#282a2d">
     <!-- Apple -->
     <link rel="apple-touch-icon" sizes="180x180" href="${http_root}images/favicon/apple-touch-icon.png?v=2.6.0">
diff --git a/data/interfaces/default/welcome.html b/data/interfaces/default/welcome.html
index 7c406e79..8f220da7 100644
--- a/data/interfaces/default/welcome.html
+++ b/data/interfaces/default/welcome.html
@@ -27,7 +27,7 @@
 
     <!-- ICONS -->
     <!-- Android -->
-    <link rel="manifest" href="${http_root}images/favicon/manifest.json?v=2.6.0" crossorigin="use-credentials">
+    <link rel="manifest" href="${http_root}images/favicon/manifest.json?v=2.9.0" crossorigin="use-credentials">
     <meta name="theme-color" content="#282a2d">
     <!-- Apple -->
     <link rel="apple-touch-icon" sizes="180x180" href="${http_root}images/favicon/apple-touch-icon.png?v=2.6.0">

From 17800df0aa823e9ade07b479df0369a7a2a5f674 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 7 Feb 2022 22:59:20 -0800
Subject: [PATCH 021/743] v2.9.0

---
 CHANGELOG.md      | 10 +++++++++-
 plexpy/version.py |  4 ++--
 2 files changed, 11 insertions(+), 3 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 59ff7ab1..a62f6980 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,8 +2,15 @@
 
 ## v2.9.0-beta (2022-01-25)
 
+* Notification:
+  * New: Added track disc number notification parameter. 
+  * Change: Default Telegram messages to MarkdownV2 when HTML is disabled. (#1635)
+* Exporter:
+  * Fix: Images not being included in export zip file download.
 * UI:
   * Fix: Favicon missing from the newsletter authentication page.
+  * Fix: IPv6 details not being shown in IP address modal. (#1629)
+  * Fix: PWA not respecting device rotation settings. (#1633)
   * New: Added intermediary login page to the Plex XML shortcuts.
   * New: Added setting to mask usernames in logs (enabled by default).
   * New: Added location, secure connection, and Plex Relay details to IP address modal.
@@ -12,9 +19,10 @@
 * API:
   * New: Added get_tautulli_info API command.
   * New: Added location, secure, and relayed to get_history API response.
-  * Change: Null pms_token and jwt_token in the response of the get_settings API command.
+  * Change: Null pms_token and jwt_token in the response of the get_settings API command. (#1616)
 * Other:
   * Fix: Better validation of config when saving settings.
+  * Fix: Correct section_id and prevent rating_key collisions when updating metadata. (#1640)
   * Change: Proxy Plex token check and Plex downloads json through the Tautulli server.
   * Change: Remove tokens from downloaded database and config files.
   * Change: Do not import pms_token or jwt_secret when importing a config file.
diff --git a/plexpy/version.py b/plexpy/version.py
index cef5088a..f70608b8 100644
--- a/plexpy/version.py
+++ b/plexpy/version.py
@@ -17,5 +17,5 @@
 
 from __future__ import unicode_literals
 
-PLEXPY_BRANCH = "beta"
-PLEXPY_RELEASE_VERSION = "v2.9.0-beta"
+PLEXPY_BRANCH = "master"
+PLEXPY_RELEASE_VERSION = "v2.9.0"

From e970a260a1e93f04d7532f8e75f31af33c29dbbb Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 7 Feb 2022 23:18:18 -0800
Subject: [PATCH 022/743] v2.9.1

---
 CHANGELOG.md      | 8 +++++++-
 plexpy/version.py | 2 +-
 2 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index a62f6980..4bd29a91 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,6 +1,12 @@
 # Changelog
 
-## v2.9.0-beta (2022-01-25)
+## v2.9.1 (2022-02-07)
+
+* Other:
+  * Fix: Incorrect changelog version number and date.
+
+
+## v2.9.0 (2022-02-07)
 
 * Notification:
   * New: Added track disc number notification parameter. 
diff --git a/plexpy/version.py b/plexpy/version.py
index f70608b8..5a6de435 100644
--- a/plexpy/version.py
+++ b/plexpy/version.py
@@ -18,4 +18,4 @@
 from __future__ import unicode_literals
 
 PLEXPY_BRANCH = "master"
-PLEXPY_RELEASE_VERSION = "v2.9.0"
+PLEXPY_RELEASE_VERSION = "v2.9.1"

From 088bbd3bb635541a36247a740ecc59e183995297 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 7 Feb 2022 23:36:03 -0800
Subject: [PATCH 023/743] Skip Local user when masking logs

---
 plexpy/logger.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/plexpy/logger.py b/plexpy/logger.py
index 53f18662..dd2e581a 100644
--- a/plexpy/logger.py
+++ b/plexpy/logger.py
@@ -127,6 +127,9 @@ class UsernameFilter(logging.Filter):
             username = item['username']
             friendly_name = item['friendly_name']
 
+            if username == 'Local':
+                continue
+
             try:
                 record.msg = self.replace(record.msg, username)
                 record.msg = self.replace(record.msg, friendly_name)

From 32ef43fe6e5f91c5012df1cb180870723105e1ad Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 30 Jan 2022 16:50:23 -0800
Subject: [PATCH 024/743] Revert "Default Telegram to MarkdownV2 when HTML
 disabled"

This reverts commit b9f04ac71ae8a67e1fc37534cc8d1cf85d8af38b.

Ref #1635
---
 plexpy/notifiers.py | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/plexpy/notifiers.py b/plexpy/notifiers.py
index 5eae6b55..1c8bf0fb 100644
--- a/plexpy/notifiers.py
+++ b/plexpy/notifiers.py
@@ -3869,7 +3869,7 @@ class TELEGRAM(Notifier):
                        'chat_id': '',
                        'disable_web_preview': 0,
                        'silent_notification': 0,
-                       'html_support': 0,
+                       'html_support': 1,
                        'incl_subject': 1,
                        'incl_poster': 0
                        }
@@ -3884,8 +3884,6 @@ class TELEGRAM(Notifier):
 
         if self.config['html_support']:
             data['parse_mode'] = 'HTML'
-        else:
-            data['parse_mode'] = 'MarkdownV2'
 
         if self.config['incl_poster'] and kwargs.get('parameters'):
             # Grab formatted metadata
@@ -3965,7 +3963,7 @@ class TELEGRAM(Notifier):
                          {'label': 'Enable HTML Support',
                           'value': self.config['html_support'],
                           'name': 'telegram_html_support',
-                          'description': 'Enable to style your messages using HTML. Disable to use Markdown instead.',
+                          'description': 'Style your messages using these HTML tags: b, i, a[href], code, pre.',
                           'input_type': 'checkbox'
                           },
                          {'label': 'Disable Web Page Previews',

From 6d092b4984fda97b6e250cc5a9c4c88eb0827339 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 8 Feb 2022 10:29:06 -0800
Subject: [PATCH 025/743] Add additional Telegram HTML tags

---
 plexpy/notification_handler.py | 16 ++++++++++------
 plexpy/notifiers.py            |  4 +++-
 2 files changed, 13 insertions(+), 7 deletions(-)

diff --git a/plexpy/notification_handler.py b/plexpy/notification_handler.py
index 9a662e2c..b8a4b902 100644
--- a/plexpy/notification_handler.py
+++ b/plexpy/notification_handler.py
@@ -1375,12 +1375,16 @@ def strip_tag(data, agent_id=None):
         data = bleach.clean(data, tags=whitelist.keys(), attributes=whitelist, strip=True)
 
     elif agent_id == 13:
-        # Allow tags b, i, code, pre, a[href] for Telegram
-        whitelist = {'b': [],
-                     'i': [],
-                     'code': [],
-                     'pre': [],
-                     'a': ['href']}
+        # Allow tags for Telegram
+        # https://core.telegram.org/bots/api#html-style
+        whitelist = {'b': [], 'strong': [],
+                     'i': [], 'em': [],
+                     'u': [], 'ins': [],
+                     's': [], 'strike': [], 'del': [],
+                     'span': ['class'], 'tg-spoiler': [],
+                     'a': ['href'],
+                     'code': ['class'],
+                     'pre': []}
         data = bleach.clean(data, tags=whitelist.keys(), attributes=whitelist, strip=True)
 
     elif agent_id in (10, 14, 20, 25):
diff --git a/plexpy/notifiers.py b/plexpy/notifiers.py
index 1c8bf0fb..42df413d 100644
--- a/plexpy/notifiers.py
+++ b/plexpy/notifiers.py
@@ -3963,7 +3963,9 @@ class TELEGRAM(Notifier):
                          {'label': 'Enable HTML Support',
                           'value': self.config['html_support'],
                           'name': 'telegram_html_support',
-                          'description': 'Style your messages using these HTML tags: b, i, a[href], code, pre.',
+                          'description': 'Enable to style your messages using these HTML tags:<br>'
+                                         'b, strong, i, em, u, ins, s, strike, del, span[class], '
+                                         'tg-spoiler, a[href], code[class], pre',
                           'input_type': 'checkbox'
                           },
                          {'label': 'Disable Web Page Previews',

From b73aa888c29d02b5fecded624a88752e3a3343b6 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 8 Feb 2022 10:35:23 -0800
Subject: [PATCH 026/743] v2.9.2

---
 CHANGELOG.md      | 9 +++++++++
 plexpy/version.py | 2 +-
 2 files changed, 10 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 4bd29a91..cc596ffe 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,14 @@
 # Changelog
 
+## v2.9.2 (2022-02-08)
+
+* Notification:
+  * New: Added support for additional Telegram HTML tags.
+  * Removed: Revert Telegram defaulting to MarkdownV2 and only support HTML. (#1635)
+* Other:
+  * Fix: The Local user being masked in the logs.
+
+
 ## v2.9.1 (2022-02-07)
 
 * Other:
diff --git a/plexpy/version.py b/plexpy/version.py
index 5a6de435..06a18a93 100644
--- a/plexpy/version.py
+++ b/plexpy/version.py
@@ -18,4 +18,4 @@
 from __future__ import unicode_literals
 
 PLEXPY_BRANCH = "master"
-PLEXPY_RELEASE_VERSION = "v2.9.1"
+PLEXPY_RELEASE_VERSION = "v2.9.2"

From 51d701521ad48834d149efa6cefac28217a02a5c Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Wed, 9 Feb 2022 09:22:13 -0800
Subject: [PATCH 027/743] Fix username logger blacklist preventing Tautulli
 from starting

---
 plexpy/logger.py | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/plexpy/logger.py b/plexpy/logger.py
index dd2e581a..cf7fb294 100644
--- a/plexpy/logger.py
+++ b/plexpy/logger.py
@@ -123,7 +123,12 @@ class UsernameFilter(logging.Filter):
         if not plexpy.CONFIG.LOG_BLACKLIST_USERNAMES:
             return True
 
-        for item in users.Users().get_users():
+        if not plexpy._INITIALIZED:
+            return True
+
+        items = users.Users().get_users() or []
+
+        for item in items:
             username = item['username']
             friendly_name = item['friendly_name']
 

From 3eef2b7f21a83542f36fdbb9065c7ceafc72ee69 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Wed, 9 Feb 2022 09:22:50 -0800
Subject: [PATCH 028/743] Fix missing first run complete flag causing setup
 wizard loop

---
 data/interfaces/default/welcome.html | 1 +
 plexpy/config.py                     | 1 +
 2 files changed, 2 insertions(+)

diff --git a/data/interfaces/default/welcome.html b/data/interfaces/default/welcome.html
index 8f220da7..a6a6d04f 100644
--- a/data/interfaces/default/welcome.html
+++ b/data/interfaces/default/welcome.html
@@ -239,6 +239,7 @@
                         <input type="checkbox" name="refresh_libraries_on_startup" id="refresh_libraries_on_startup" value="1" checked>
                         <input type="checkbox" name="check_github" id="check_github" value="1" checked>
                         <input type="checkbox" name="log_blacklist" id="log_blacklist" value="1" checked>
+                        <input type="checkbox" name="log_blacklist_usernames" id="log_blacklist" value="1" checked>
                         <input type="checkbox" name="cache_images" id="cache_images" value="1" checked>
                         <input type="checkbox" name="notify_group_recently_added_grandparent" id="notify_group_recently_added_grandparent" value="1" checked>
                         <input type="checkbox" name="notify_group_recently_added_parent" id="notify_group_recently_added_parent" value="1" checked>
diff --git a/plexpy/config.py b/plexpy/config.py
index c296d628..7c8f95c4 100644
--- a/plexpy/config.py
+++ b/plexpy/config.py
@@ -307,6 +307,7 @@ CHECKED_SETTINGS = [
     'CACHE_IMAGES',
     'CHECK_GITHUB',
     'ENABLE_HTTPS',
+    'FIRST_RUN_COMPLETE',
     'GET_FILE_SIZES',
     'GROUP_HISTORY_TABLES',
     'HISTORY_TABLE_ACTIVITY',

From ee43f001e4810b8c6858d0fb5eca60d8b692f906 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Wed, 9 Feb 2022 09:30:19 -0800
Subject: [PATCH 029/743] v2.9.3

---
 CHANGELOG.md      | 8 ++++++++
 plexpy/version.py | 2 +-
 2 files changed, 9 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index cc596ffe..ad366b9d 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,13 @@
 # Changelog
 
+## v2.9.3 (2022-02-09)
+
+* UI:
+  * Fix: Setup wizard looping.
+* Other:
+  * Fix: Logger username masking preventing Tautulli from starting on new installs.
+
+
 ## v2.9.2 (2022-02-08)
 
 * Notification:
diff --git a/plexpy/version.py b/plexpy/version.py
index 06a18a93..503793d6 100644
--- a/plexpy/version.py
+++ b/plexpy/version.py
@@ -18,4 +18,4 @@
 from __future__ import unicode_literals
 
 PLEXPY_BRANCH = "master"
-PLEXPY_RELEASE_VERSION = "v2.9.2"
+PLEXPY_RELEASE_VERSION = "v2.9.3"

From 40dc6e08efca39a0ad0c4f9a99c5f3df2d204336 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 12 Feb 2022 17:59:14 -0800
Subject: [PATCH 030/743] Fix first_run_complete config flag

---
 data/interfaces/default/welcome.html | 1 -
 plexpy/config.py                     | 1 -
 plexpy/webserve.py                   | 4 ++++
 3 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/data/interfaces/default/welcome.html b/data/interfaces/default/welcome.html
index a6a6d04f..ed44eac3 100644
--- a/data/interfaces/default/welcome.html
+++ b/data/interfaces/default/welcome.html
@@ -244,7 +244,6 @@
                         <input type="checkbox" name="notify_group_recently_added_grandparent" id="notify_group_recently_added_grandparent" value="1" checked>
                         <input type="checkbox" name="notify_group_recently_added_parent" id="notify_group_recently_added_parent" value="1" checked>
                         <input type="checkbox" name="server_changed" id="server_changed" value="1" checked>
-                        <input type="checkbox" name="first_run_complete" id="first_run_complete" value="1" checked>
                         <input type="text" name="home_stats_cards" id="home_stats_cards" value="first_run_wizard">
                         <input type="text" name="home_library_cards" id="home_library_cards" value="first_run_wizard">
                     </div>
diff --git a/plexpy/config.py b/plexpy/config.py
index 7c8f95c4..c296d628 100644
--- a/plexpy/config.py
+++ b/plexpy/config.py
@@ -307,7 +307,6 @@ CHECKED_SETTINGS = [
     'CACHE_IMAGES',
     'CHECK_GITHUB',
     'ENABLE_HTTPS',
-    'FIRST_RUN_COMPLETE',
     'GET_FILE_SIZES',
     'GROUP_HISTORY_TABLES',
     'HISTORY_TABLE_ACTIVITY',
diff --git a/plexpy/webserve.py b/plexpy/webserve.py
index dd6e66a4..24c47361 100644
--- a/plexpy/webserve.py
+++ b/plexpy/webserve.py
@@ -3261,6 +3261,10 @@ class WebInterface(object):
 
         all_settings = config.SETTINGS + config.CHECKED_SETTINGS
         kwargs = {k: v for k, v in kwargs.items() if k.upper() in all_settings}
+
+        if first_run:
+            kwargs['first_run_complete'] = 1
+
         plexpy.CONFIG.process_kwargs(kwargs)
 
         # Write the config

From 636806ae17db835cb6af9c07f72aeb37c85e5ff0 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 12 Feb 2022 18:05:17 -0800
Subject: [PATCH 031/743] Fix Tautulli starting multiple instances on Windows

---
 plexpy/windows.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/plexpy/windows.py b/plexpy/windows.py
index 5b9519b3..3f94b9f0 100644
--- a/plexpy/windows.py
+++ b/plexpy/windows.py
@@ -154,7 +154,7 @@ def set_startup():
     else:
         args = [exe, plexpy.FULL_PATH] + run_args
 
-    registry_key_name = '{}_{}'.format(common.PRODUCT, plexpy.CONFIG.PMS_UUID)
+    registry_key_name = common.PRODUCT
 
     cmd = ' '.join(cmd_quote(arg) for arg in args).replace('python.exe', 'pythonw.exe').replace("'", '"')
 
@@ -162,14 +162,14 @@ def set_startup():
         # Rename old Tautulli registry key
         try:
             registry_key = winreg.OpenKey(winreg.HKEY_CURRENT_USER, startup_reg_path, 0, winreg.KEY_ALL_ACCESS)
-            winreg.QueryValueEx(registry_key, common.PRODUCT)
+            winreg.QueryValueEx(registry_key, '{}_{}'.format(common.PRODUCT, plexpy.CONFIG.PMS_UUID))
             reg_value_exists = True
         except WindowsError:
             reg_value_exists = False
 
         if reg_value_exists:
             try:
-                winreg.DeleteValue(registry_key, common.PRODUCT)
+                winreg.DeleteValue(registry_key, '{}_{}'.format(common.PRODUCT, plexpy.CONFIG.PMS_UUID))
                 winreg.CloseKey(registry_key)
             except WindowsError:
                 pass

From b4600c8306e65aa408e248628b0a3d12b0ce0720 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 12 Feb 2022 18:56:08 -0800
Subject: [PATCH 032/743] Bump config version to set first_run_complete flag

---
 plexpy/config.py | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/plexpy/config.py b/plexpy/config.py
index c296d628..8f08a5b0 100644
--- a/plexpy/config.py
+++ b/plexpy/config.py
@@ -698,3 +698,9 @@ class Config(object):
             self.HTTP_HASHED_PASSWORD = 1
 
             self.CONFIG_VERSION = 20
+
+        if self.CONFIG_VERSION == 20:
+            if self.PMS_UUID:
+                self.FIRST_RUN_COMPLETE = 1
+
+            self.CONFIG_VERSION = 21

From cfd1bf445f7f5332b9183d98ea8893f325c5ca92 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 12 Feb 2022 19:17:01 -0800
Subject: [PATCH 033/743] v2.9.4

---
 CHANGELOG.md      | 8 ++++++++
 plexpy/version.py | 2 +-
 2 files changed, 9 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index ad366b9d..0cb03f75 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,13 @@
 # Changelog
 
+## v2.9.4 (2022-02-12)
+
+* UI:
+  * Fix: Setup wizard appearing when restarting after saving settings.
+* Other:
+  * Fix: Stop Tautulli from starting multiple instances on Windows after a clean reinstall. Check the startup items in Windows Task Manager if it is still occurring.
+
+
 ## v2.9.3 (2022-02-09)
 
 * UI:
diff --git a/plexpy/version.py b/plexpy/version.py
index 503793d6..bb6feecc 100644
--- a/plexpy/version.py
+++ b/plexpy/version.py
@@ -18,4 +18,4 @@
 from __future__ import unicode_literals
 
 PLEXPY_BRANCH = "master"
-PLEXPY_RELEASE_VERSION = "v2.9.3"
+PLEXPY_RELEASE_VERSION = "v2.9.4"

From 6d84d1b4c94d904de435daa7467f0c43675dcb0c Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 13 Feb 2022 11:59:06 -0800
Subject: [PATCH 034/743] Improve calculation for transcode progress bar

---
 data/interfaces/default/current_activity_instance.html | 5 +++--
 data/interfaces/default/index.html                     | 6 ++++--
 plexpy/pmsconnect.py                                   | 6 ++++++
 3 files changed, 13 insertions(+), 4 deletions(-)

diff --git a/data/interfaces/default/current_activity_instance.html b/data/interfaces/default/current_activity_instance.html
index e64f2dd7..6cd017e3 100644
--- a/data/interfaces/default/current_activity_instance.html
+++ b/data/interfaces/default/current_activity_instance.html
@@ -62,7 +62,7 @@ DOCUMENTATION :: END
 % if session is not None:
 <%
     from collections import defaultdict
-    from plexpy.helpers import cast_to_int, page, short_season
+    from plexpy.helpers import cast_to_int, get_percent, page, short_season
     from plexpy.common import VIDEO_RESOLUTION_OVERRIDES, AUDIO_CODEC_OVERRIDES, EXTRA_TYPES
     import plexpy
 %>
@@ -392,7 +392,8 @@ DOCUMENTATION :: END
                 % if data['live']:
                 <div id="progress-bar-${sk}" class="progress-bar" style="width: 100%" data-state="live" data-toggle="tooltip" title="Stream Progress Live">Live</div>
                 % else:
-                <div id="buffer-bar-${sk}" class="buffer-bar" style="width: ${data['transcode_progress']}%" data-toggle="tooltip" title="Transcoder Progress ${data['transcode_progress']}%">${data['transcode_progress']}%</div>
+                <%  transcode_progress = get_percent(data['transcode_max_offset_available'] * 1000, data['duration']) or data['transcode_progress'] %>
+                <div id="buffer-bar-${sk}" class="buffer-bar" style="width: ${transcode_progress}%" data-toggle="tooltip" title="Transcoder Progress ${transcode_progress}%">${transcode_progress}%</div>
                 <div id="progress-bar-${sk}" class="progress-bar" style="width: ${data['progress_percent']}%" data-last_view_offset="${data['view_offset']}" data-view_offset="${data['view_offset']}" data-stream_duration="${data['stream_duration']}" data-state="${data['state']}" data-toggle="tooltip" title="Stream Progress ${data['progress_percent']}%">${data['progress_percent']}%</div>
                 % endif
             </div>
diff --git a/data/interfaces/default/index.html b/data/interfaces/default/index.html
index 11f9ddf3..652af7c6 100644
--- a/data/interfaces/default/index.html
+++ b/data/interfaces/default/index.html
@@ -590,8 +590,10 @@
                         }
 
                         // Update the progress bars
-                        $('#buffer-bar-' + key).css({width: parseInt(s.transcode_progress) + '%'}).html(s.transcode_progress + '%')
-                            .attr('data-original-title', 'Transcoder Progress ' + s.transcode_progress + '%');
+                        var duration = parseInt(s.duration);
+                        var transcode_progress = duration ? Math.round(s.transcode_max_offset_available * 1000 / duration * 100) : s.transcode_progress;
+                        $('#buffer-bar-' + key).css({width: parseInt(transcode_progress) + '%'}).html(transcode_progress + '%')
+                            .attr('data-original-title', 'Transcoder Progress ' + transcode_progress + '%');
                         if (s.live !== 1) {
                             var progress_bar = $('#progress-bar-' + key);
                             progress_bar.data('state', s.state);
diff --git a/plexpy/pmsconnect.py b/plexpy/pmsconnect.py
index fc89def6..94b0fdeb 100644
--- a/plexpy/pmsconnect.py
+++ b/plexpy/pmsconnect.py
@@ -1734,6 +1734,8 @@ class PmsConnect(object):
 
             transcode_progress = helpers.get_xml_attr(transcode_info, 'progress')
             transcode_speed = helpers.get_xml_attr(transcode_info, 'speed')
+            transcode_min_offset = helpers.get_xml_attr(transcode_info, 'minOffsetAvailable')
+            transcode_max_offset = helpers.get_xml_attr(transcode_info, 'maxOffsetAvailable')
 
             transcode_details = {'transcode_key': helpers.get_xml_attr(transcode_info, 'key'),
                                  'transcode_throttled': int(helpers.get_xml_attr(transcode_info, 'throttled') == '1'),
@@ -1746,6 +1748,8 @@ class PmsConnect(object):
                                  'transcode_height': helpers.get_xml_attr(transcode_info, 'height'),  # Blank but keep backwards compatibility
                                  'transcode_container': helpers.get_xml_attr(transcode_info, 'container'),
                                  'transcode_protocol': helpers.get_xml_attr(transcode_info, 'protocol'),
+                                 'transcode_min_offset_available': int(round(helpers.cast_to_float(transcode_min_offset), 0)),
+                                 'transcode_max_offset_available': int(round(helpers.cast_to_float(transcode_max_offset), 0)),
                                  'transcode_hw_requested': int(helpers.get_xml_attr(transcode_info, 'transcodeHwRequested') == '1'),
                                  'transcode_hw_decode': helpers.get_xml_attr(transcode_info, 'transcodeHwDecoding'),
                                  'transcode_hw_decode_title': helpers.get_xml_attr(transcode_info, 'transcodeHwDecodingTitle'),
@@ -1771,6 +1775,8 @@ class PmsConnect(object):
                                  'transcode_height': '',
                                  'transcode_container': '',
                                  'transcode_protocol': '',
+                                 'transcode_min_offset_available': 0,
+                                 'transcode_max_offset_available': 0,
                                  'transcode_hw_requested': 0,
                                  'transcode_hw_decode': '',
                                  'transcode_hw_decode_title': '',

From ec363b2ef3f18ec45a66f2c7dd8863179c84ef77 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 13 Feb 2022 12:17:57 -0800
Subject: [PATCH 035/743] Add transcode offset keys to get_activity API docs

---
 plexpy/webserve.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/plexpy/webserve.py b/plexpy/webserve.py
index 24c47361..62069cc9 100644
--- a/plexpy/webserve.py
+++ b/plexpy/webserve.py
@@ -5893,6 +5893,8 @@ class WebInterface(object):
                              "transcode_hw_full_pipeline": 0,
                              "transcode_hw_requested": 0,
                              "transcode_key": "",
+                             "transcode_max_offset_available": 0,
+                             "transcode_min_offset_available": 0,
                              "transcode_progress": 0,
                              "transcode_protocol": "",
                              "transcode_speed": "",

From 3c48ea49f375f069bc62b649f481c093a600f5b5 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 18 Feb 2022 23:27:02 -0800
Subject: [PATCH 036/743] Retrieve season summary and fallback to show summary

* Fixes #1657
---
 plexpy/pmsconnect.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/plexpy/pmsconnect.py b/plexpy/pmsconnect.py
index 94b0fdeb..2bdd4370 100644
--- a/plexpy/pmsconnect.py
+++ b/plexpy/pmsconnect.py
@@ -870,7 +870,7 @@ class PmsConnect(object):
                         'parent_media_index': helpers.get_xml_attr(metadata_main, 'parentIndex'),
                         'studio': show_details.get('studio', ''),
                         'content_rating': show_details.get('content_rating', ''),
-                        'summary': show_details.get('summary', ''),
+                        'summary': helpers.get_xml_attr(metadata_main, 'summary') or show_details.get('summary', ''),
                         'tagline': helpers.get_xml_attr(metadata_main, 'tagline'),
                         'rating': helpers.get_xml_attr(metadata_main, 'rating'),
                         'rating_image': helpers.get_xml_attr(metadata_main, 'ratingImage'),

From d657a609ffa3c99b074a7d86399037157469fcca Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 19 Feb 2022 16:37:03 -0800
Subject: [PATCH 037/743] Reschedule tasks after changing backup interval

* Fixes #1662
---
 plexpy/webserve.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/plexpy/webserve.py b/plexpy/webserve.py
index 62069cc9..76a4d600 100644
--- a/plexpy/webserve.py
+++ b/plexpy/webserve.py
@@ -3205,7 +3205,8 @@ class WebInterface(object):
                 kwargs.get('refresh_users_interval') != str(plexpy.CONFIG.REFRESH_USERS_INTERVAL) or \
                 kwargs.get('pms_update_check_interval') != str(plexpy.CONFIG.PMS_UPDATE_CHECK_INTERVAL) or \
                 kwargs.get('monitor_pms_updates') != plexpy.CONFIG.MONITOR_PMS_UPDATES or \
-                kwargs.get('pms_url_manual') != plexpy.CONFIG.PMS_URL_MANUAL:
+                kwargs.get('pms_url_manual') != plexpy.CONFIG.PMS_URL_MANUAL or \
+                kwargs.get('backup_interval') != str(plexpy.CONFIG.BACKUP_INTERVAL):
             reschedule = True
 
         # If we change the SSL setting for PMS or PMS remote setting, make sure we grab the new url.

From 297620f4a903e0363a53aa3b1ccdf8d6a287c875 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 21 Feb 2022 09:42:50 -0800
Subject: [PATCH 038/743] Reorder db migrations

---
 plexpy/__init__.py | 100 ++++++++++++++++++++++-----------------------
 1 file changed, 50 insertions(+), 50 deletions(-)

diff --git a/plexpy/__init__.py b/plexpy/__init__.py
index 151cabe7..7d5fb00d 100644
--- a/plexpy/__init__.py
+++ b/plexpy/__init__.py
@@ -1443,56 +1443,6 @@ def dbcheck():
     except sqlite3.OperationalError:
         logger.warn("Unable to capitalize Windows platform values in session_history table.")
 
-    # Upgrade session_history table from earlier versions
-    try:
-        c_db.execute('SELECT section_id FROM session_history')
-    except sqlite3.OperationalError:
-        logger.debug("Altering database. Updating database table session_history.")
-        c_db.execute(
-            'ALTER TABLE session_history ADD COLUMN section_id INTEGER'
-        )
-        c_db.execute(
-            'UPDATE session_history SET section_id = ('
-            'SELECT section_id FROM session_history_metadata '
-            'WHERE session_history_metadata.id = session_history.id)'
-        )
-        c_db.execute(
-            'CREATE TABLE IF NOT EXISTS session_history_metadata_temp (id INTEGER PRIMARY KEY, '
-            'rating_key INTEGER, parent_rating_key INTEGER, grandparent_rating_key INTEGER, '
-            'title TEXT, parent_title TEXT, grandparent_title TEXT, original_title TEXT, full_title TEXT, '
-            'media_index INTEGER, parent_media_index INTEGER, '
-            'thumb TEXT, parent_thumb TEXT, grandparent_thumb TEXT, '
-            'art TEXT, media_type TEXT, year INTEGER, originally_available_at TEXT, added_at INTEGER, updated_at INTEGER, '
-            'last_viewed_at INTEGER, content_rating TEXT, summary TEXT, tagline TEXT, rating TEXT, '
-            'duration INTEGER DEFAULT 0, guid TEXT, directors TEXT, writers TEXT, actors TEXT, genres TEXT, studio TEXT, '
-            'labels TEXT, live INTEGER DEFAULT 0, channel_call_sign TEXT, channel_identifier TEXT, channel_thumb TEXT)'
-        )
-        c_db.execute(
-            'INSERT INTO session_history_metadata_temp (id, rating_key, parent_rating_key, grandparent_rating_key, '
-            'title, parent_title, grandparent_title, original_title, full_title, '
-            'media_index, parent_media_index, '
-            'thumb, parent_thumb, grandparent_thumb, '
-            'art, media_type, year, originally_available_at, added_at, updated_at, '
-            'last_viewed_at, content_rating, summary, tagline, rating, '
-            'duration, guid, directors, writers, actors, genres, studio, '
-            'labels, live, channel_call_sign, channel_identifier, channel_thumb) '
-            'SELECT id, rating_key, parent_rating_key, grandparent_rating_key, '
-            'title, parent_title, grandparent_title, original_title, full_title, '
-            'media_index, parent_media_index, '
-            'thumb, parent_thumb, grandparent_thumb, '
-            'art, media_type, year, originally_available_at, added_at, updated_at, '
-            'last_viewed_at, content_rating, summary, tagline, rating, '
-            'duration, guid, directors, writers, actors, genres, studio, '
-            'labels, live, channel_call_sign, channel_identifier, channel_thumb '
-            'FROM session_history_metadata'
-        )
-        c_db.execute(
-            'DROP TABLE session_history_metadata'
-        )
-        c_db.execute(
-            'ALTER TABLE session_history_metadata_temp RENAME TO session_history_metadata'
-        )
-
     # Upgrade session_history_metadata table from earlier versions
     try:
         c_db.execute('SELECT full_title FROM session_history_metadata')
@@ -1816,6 +1766,56 @@ def dbcheck():
             'ALTER TABLE session_history_media_info ADD COLUMN stream_audio_language_code TEXT'
         ) 
     
+    # Upgrade session_history table from earlier versions
+    try:
+        c_db.execute('SELECT section_id FROM session_history')
+    except sqlite3.OperationalError:
+        logger.debug("Altering database. Updating database table session_history.")
+        c_db.execute(
+            'ALTER TABLE session_history ADD COLUMN section_id INTEGER'
+        )
+        c_db.execute(
+            'UPDATE session_history SET section_id = ('
+            'SELECT section_id FROM session_history_metadata '
+            'WHERE session_history_metadata.id = session_history.id)'
+        )
+        c_db.execute(
+            'CREATE TABLE IF NOT EXISTS session_history_metadata_temp (id INTEGER PRIMARY KEY, '
+            'rating_key INTEGER, parent_rating_key INTEGER, grandparent_rating_key INTEGER, '
+            'title TEXT, parent_title TEXT, grandparent_title TEXT, original_title TEXT, full_title TEXT, '
+            'media_index INTEGER, parent_media_index INTEGER, '
+            'thumb TEXT, parent_thumb TEXT, grandparent_thumb TEXT, '
+            'art TEXT, media_type TEXT, year INTEGER, originally_available_at TEXT, added_at INTEGER, updated_at INTEGER, '
+            'last_viewed_at INTEGER, content_rating TEXT, summary TEXT, tagline TEXT, rating TEXT, '
+            'duration INTEGER DEFAULT 0, guid TEXT, directors TEXT, writers TEXT, actors TEXT, genres TEXT, studio TEXT, '
+            'labels TEXT, live INTEGER DEFAULT 0, channel_call_sign TEXT, channel_identifier TEXT, channel_thumb TEXT)'
+        )
+        c_db.execute(
+            'INSERT INTO session_history_metadata_temp (id, rating_key, parent_rating_key, grandparent_rating_key, '
+            'title, parent_title, grandparent_title, original_title, full_title, '
+            'media_index, parent_media_index, '
+            'thumb, parent_thumb, grandparent_thumb, '
+            'art, media_type, year, originally_available_at, added_at, updated_at, '
+            'last_viewed_at, content_rating, summary, tagline, rating, '
+            'duration, guid, directors, writers, actors, genres, studio, '
+            'labels, live, channel_call_sign, channel_identifier, channel_thumb) '
+            'SELECT id, rating_key, parent_rating_key, grandparent_rating_key, '
+            'title, parent_title, grandparent_title, original_title, full_title, '
+            'media_index, parent_media_index, '
+            'thumb, parent_thumb, grandparent_thumb, '
+            'art, media_type, year, originally_available_at, added_at, updated_at, '
+            'last_viewed_at, content_rating, summary, tagline, rating, '
+            'duration, guid, directors, writers, actors, genres, studio, '
+            'labels, live, channel_call_sign, channel_identifier, channel_thumb '
+            'FROM session_history_metadata'
+        )
+        c_db.execute(
+            'DROP TABLE session_history_metadata'
+        )
+        c_db.execute(
+            'ALTER TABLE session_history_metadata_temp RENAME TO session_history_metadata'
+        )
+
     # Upgrade users table from earlier versions
     try:
         c_db.execute('SELECT do_notify FROM users')

From 74cd49416293fa586ab327a97d175cca86a26b4c Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 21 Feb 2022 12:14:14 -0800
Subject: [PATCH 039/743] Pass media_type when retrieving show and artist
 children for newsletter

* Fix different album types not shown on newsletter. (#1559)
---
 plexpy/newsletters.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/plexpy/newsletters.py b/plexpy/newsletters.py
index d3910942..03513f1e 100644
--- a/plexpy/newsletters.py
+++ b/plexpy/newsletters.py
@@ -752,7 +752,7 @@ class RecentlyAdded(Newsletter):
                     continue
 
                 show_metadata = pms_connect.get_metadata_details(show_rating_key, media_info=False)
-                children = pms_connect.get_item_children(show_rating_key, get_grandchildren=True)
+                children = pms_connect.get_item_children(show_rating_key, media_type=media_type, get_grandchildren=True)
                 filtered_children = [i for i in children['children_list']
                                      if self.start_time < helpers.cast_to_int(i['added_at']) < self.end_time]
                 filtered_children.sort(key=lambda x: helpers.cast_to_int(x['parent_media_index']))
@@ -802,7 +802,7 @@ class RecentlyAdded(Newsletter):
                     continue
 
                 artist_metadata = pms_connect.get_metadata_details(artist_rating_key, media_info=False)
-                children = pms_connect.get_item_children(artist_rating_key)
+                children = pms_connect.get_item_children(artist_rating_key, media_type=media_type)
                 filtered_children = [i for i in children['children_list']
                                      if self.start_time < helpers.cast_to_int(i['added_at']) < self.end_time]
                 filtered_children.sort(key=lambda x: x['added_at'])

From bd9fe54fd7b0dec86499b31975bb7c15eb70d42d Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 24 Feb 2022 19:11:30 -0800
Subject: [PATCH 040/743] Enable dynamic anonymous redirect by default in setup
 wizard

---
 data/interfaces/default/welcome.html | 3 ++-
 plexpy/config.py                     | 6 ++++++
 2 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/data/interfaces/default/welcome.html b/data/interfaces/default/welcome.html
index ed44eac3..adb77e45 100644
--- a/data/interfaces/default/welcome.html
+++ b/data/interfaces/default/welcome.html
@@ -239,7 +239,8 @@
                         <input type="checkbox" name="refresh_libraries_on_startup" id="refresh_libraries_on_startup" value="1" checked>
                         <input type="checkbox" name="check_github" id="check_github" value="1" checked>
                         <input type="checkbox" name="log_blacklist" id="log_blacklist" value="1" checked>
-                        <input type="checkbox" name="log_blacklist_usernames" id="log_blacklist" value="1" checked>
+                        <input type="checkbox" name="log_blacklist_usernames" id="log_blacklist_usernames" value="1" checked>
+                        <input type="checkbox" name="anon_redirect_dynamic" id="anon_redirect_dynamic" value="1" checked>
                         <input type="checkbox" name="cache_images" id="cache_images" value="1" checked>
                         <input type="checkbox" name="notify_group_recently_added_grandparent" id="notify_group_recently_added_grandparent" value="1" checked>
                         <input type="checkbox" name="notify_group_recently_added_parent" id="notify_group_recently_added_parent" value="1" checked>
diff --git a/plexpy/config.py b/plexpy/config.py
index 8f08a5b0..6f36f55e 100644
--- a/plexpy/config.py
+++ b/plexpy/config.py
@@ -704,3 +704,9 @@ class Config(object):
                 self.FIRST_RUN_COMPLETE = 1
 
             self.CONFIG_VERSION = 21
+
+        if self.CONFIG_VERSION == 21:
+            if not self.ANON_REDIRECT_DYNAMIC and not self.ANON_REDIRECT:
+                self.ANON_REDIRECT_DYNAMIC = 1
+
+            self.CONFIG_VERSION = 22

From 84a14c0f2587f02460ad78ee8cb180bc94c100a1 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 27 Feb 2022 16:50:29 -0800
Subject: [PATCH 041/743] Colour active filter buttons

---
 data/interfaces/default/css/tautulli.css |  7 +++++++
 data/interfaces/default/graphs.html      |  4 ++--
 data/interfaces/default/history.html     | 14 +++++++-------
 data/interfaces/default/index.html       | 14 +++++++-------
 data/interfaces/default/info.html        |  6 +++---
 data/interfaces/default/library.html     |  6 +++---
 data/interfaces/default/user.html        | 14 +++++++-------
 7 files changed, 36 insertions(+), 29 deletions(-)

diff --git a/data/interfaces/default/css/tautulli.css b/data/interfaces/default/css/tautulli.css
index 136644e2..514975c3 100644
--- a/data/interfaces/default/css/tautulli.css
+++ b/data/interfaces/default/css/tautulli.css
@@ -680,6 +680,13 @@ textarea.form-control:focus {
 .btn-form:focus {
     color: #eee;
 }
+.btn-filter.active,
+.btn-filter.active.focus {
+  background-color: #b7800a !important;
+}
+.btn-filter.active:hover {
+  background-color: #896007 !important;
+}
 .form-control-feedback {
     color: #E5A00D;
     margin: 5px 40px 5px 0;
diff --git a/data/interfaces/default/graphs.html b/data/interfaces/default/graphs.html
index 4dea9b6f..2e71bd76 100644
--- a/data/interfaces/default/graphs.html
+++ b/data/interfaces/default/graphs.html
@@ -21,10 +21,10 @@
                 </label>
             </div>
             <div class="btn-group" style="margin-right: 2px;" data-toggle="buttons" id="yaxis-selection">
-                <label class="btn btn-dark">
+                <label class="btn btn-dark btn-filter">
                     <input type="radio" name="yaxis-options" id="yaxis-plays" value="plays" autocomplete="off"> Play Count
                 </label>
-                <label class="btn btn-dark">
+                <label class="btn btn-dark btn-filter">
                     <input type="radio" name="yaxis-options" id="yaxis-duration" value="duration" autocomplete="off"> Play Duration
                 </label>
             </div>
diff --git a/data/interfaces/default/history.html b/data/interfaces/default/history.html
index 01317027..cf15c87f 100644
--- a/data/interfaces/default/history.html
+++ b/data/interfaces/default/history.html
@@ -39,27 +39,27 @@
             </div>
             % endif
             <div class="btn-group" data-toggle="buttons" id="media_type-selection">
-                <label class="btn btn-dark">
+                <label class="btn btn-dark btn-filter">
                     <input type="checkbox" name="media_type-filter" id="history-media_type-movie" value="movie" autocomplete="off"><i class="fa fa-film"></i> Movies
                 </label>
-                <label class="btn btn-dark">
+                <label class="btn btn-dark btn-filter">
                     <input type="checkbox" name="media_type-filter" id="history-media_type-episode" value="episode" autocomplete="off"><i class="fa fa-television"></i> TV Shows
                 </label>
-                <label class="btn btn-dark">
+                <label class="btn btn-dark btn-filter">
                     <input type="checkbox" name="media_type-filter" id="history-media_type-track" value="track" autocomplete="off"><i class="fa fa-music"></i> Music
                 </label>
-                <label class="btn btn-dark">
+                <label class="btn btn-dark btn-filter">
                     <input type="checkbox" name="media_type-filter" id="history-media_type-live" value="live" autocomplete="off"><i class="fa fa-broadcast-tower"></i> Live TV
                 </label>
             </div>
             <div class="btn-group" data-toggle="buttons" id="transcode_decision-selection">
-                <label class="btn btn-dark">
+                <label class="btn btn-dark btn-filter">
                     <input type="checkbox" name="transcode_decision-filter" id="history-transcode_decision-direct_play" value="direct play" autocomplete="off"><i class="fa fa-play-circle"></i> Direct Play
                 </label>
-                <label class="btn btn-dark">
+                <label class="btn btn-dark btn-filter">
                     <input type="checkbox" name="transcode_decision-filter" id="history-transcode_decision-copy" value="copy" autocomplete="off"><i class="fa fa-stream"></i> Direct Stream
                 </label>
-                <label class="btn btn-dark">
+                <label class="btn btn-dark btn-filter">
                     <input type="checkbox" name="transcode_decision-filter" id="history-transcode_decision-transcode" value="transcode" autocomplete="off"><i class="fa fa-server"></i> Transcode
                 </label>
             </div>
diff --git a/data/interfaces/default/index.html b/data/interfaces/default/index.html
index 652af7c6..47b0d87d 100644
--- a/data/interfaces/default/index.html
+++ b/data/interfaces/default/index.html
@@ -42,10 +42,10 @@
                 <h3 class="pull-left">Watch Statistics</h3>
                 <div class="button-bar">
                     <div class="btn-group pull-left" data-toggle="buttons" id="watch-stats-toggles" style="margin-right: 3px">
-                        <label class="btn btn-dark">
+                        <label class="btn btn-dark btn-filter">
                             <input type="radio" class="watched-stats-toggle" name="watched-stats-type" id="watched-stats-plays" value="plays" autocomplete="off"> Play Count
                         </label>
-                        <label class="btn btn-dark">
+                        <label class="btn btn-dark btn-filter">
                             <input type="radio" class="watched-stats-toggle" name="watched-stats-type" id="watched-stats-duration" value="duration" autocomplete="off"> Play Duration
                         </label>
                     </div>
@@ -100,19 +100,19 @@
                 </ul>
                 <div class="button-bar">
                     <div class="btn-group pull-left" data-toggle="buttons" id="recently-added-toggles" style="margin-right: 3px">
-                        <label class="btn btn-dark" id="recently-added-label-all">
+                        <label class="btn btn-dark btn-filter" id="recently-added-label-all">
                             <input type="radio" name="recently-added-toggle" id="recently-added-toggle-all" value="all" autocomplete="off"> All
                         </label>
-                        <label class="btn btn-dark" id="recently-added-label-movies">
+                        <label class="btn btn-dark btn-filter" id="recently-added-label-movies">
                             <input type="radio" name="recently-added-toggle" id="recently-added-toggle-movie" value="movie" autocomplete="off"> Movies
                         </label>
-                        <label class="btn btn-dark" id="recently-added-label-tv">
+                        <label class="btn btn-dark btn-filter" id="recently-added-label-tv">
                             <input type="radio" name="recently-added-toggle" id="recently-added-toggle-show" value="show" autocomplete="off"> TV Shows
                         </label>
-                        <label class="btn btn-dark" id="recently-added-label-music">
+                        <label class="btn btn-dark btn-filter" id="recently-added-label-music">
                             <input type="radio" name="recently-added-toggle" id="recently-added-toggle-artist" value="artist" autocomplete="off"> Music
                         </label>
-                        <label class="btn btn-dark" id="recently-added-label-other_video">
+                        <label class="btn btn-dark btn-filter" id="recently-added-label-other_video">
                             <input type="radio" name="recently-added-toggle" id="recently-added-toggle-other_video" value="other_video" autocomplete="off"> Videos
                         </label>
                     </div>
diff --git a/data/interfaces/default/info.html b/data/interfaces/default/info.html
index 80ae1dfb..0b69d508 100644
--- a/data/interfaces/default/info.html
+++ b/data/interfaces/default/info.html
@@ -649,13 +649,13 @@ DOCUMENTATION :: END
                                             </div>
                                             % endif
                                             <div class="btn-group" data-toggle="buttons" id="transcode_decision-selection">
-                                                <label class="btn btn-dark">
+                                                <label class="btn btn-dark btn-filter">
                                                     <input type="checkbox" name="transcode_decision-filter" id="history-transcode_decision-direct_play" value="direct play" autocomplete="off"><i class="fa fa-play-circle"></i> Direct Play
                                                 </label>
-                                                <label class="btn btn-dark">
+                                                <label class="btn btn-dark btn-filter">
                                                     <input type="checkbox" name="transcode_decision-filter" id="history-transcode_decision-direct_stream" value="copy" autocomplete="off"><i class="fa fa-stream"></i> Direct Stream
                                                 </label>
-                                                <label class="btn btn-dark">
+                                                <label class="btn btn-dark btn-filter">
                                                     <input type="checkbox" name="transcode_decision-filter" id="history-transcode_decision-transcode" value="transcode" autocomplete="off"><i class="fa fa-server"></i> Transcode
                                                 </label>
                                             </div>
diff --git a/data/interfaces/default/library.html b/data/interfaces/default/library.html
index b1ce22c4..59de6497 100644
--- a/data/interfaces/default/library.html
+++ b/data/interfaces/default/library.html
@@ -217,13 +217,13 @@ DOCUMENTATION :: END
                                             </div>
                                             % endif
                                             <div class="btn-group" data-toggle="buttons" id="transcode_decision-selection">
-                                                <label class="btn btn-dark">
+                                                <label class="btn btn-dark btn-filter">
                                                     <input type="checkbox" name="transcode_decision-filter" id="history-transcode_decision-direct_play" value="direct play" autocomplete="off"><i class="fa fa-play-circle"></i> Direct Play
                                                 </label>
-                                                <label class="btn btn-dark">
+                                                <label class="btn btn-dark btn-filter">
                                                     <input type="checkbox" name="transcode_decision-filter" id="history-transcode_decision-direct_stream" value="copy" autocomplete="off"><i class="fa fa-stream"></i> Direct Stream
                                                 </label>
-                                                <label class="btn btn-dark">
+                                                <label class="btn btn-dark btn-filter">
                                                     <input type="checkbox" name="transcode_decision-filter" id="history-transcode_decision-transcode" value="transcode" autocomplete="off"><i class="fa fa-server"></i> Transcode
                                                 </label>
                                             </div>
diff --git a/data/interfaces/default/user.html b/data/interfaces/default/user.html
index 36beca13..501c68ca 100644
--- a/data/interfaces/default/user.html
+++ b/data/interfaces/default/user.html
@@ -167,27 +167,27 @@ DOCUMENTATION :: END
                                             </div>
                                             % endif
                                             <div class="btn-group" data-toggle="buttons" id="media_type-selection">
-                                                <label class="btn btn-dark">
+                                                <label class="btn btn-dark btn-filter">
                                                     <input type="checkbox" name="media_type-filter" id="history-media_type-movie" value="movie" autocomplete="off"><i class="fa fa-film"></i> Movies
                                                 </label>
-                                                <label class="btn btn-dark">
+                                                <label class="btn btn-dark btn-filter">
                                                     <input type="checkbox" name="media_type-filter" id="history-media_type-episode" value="episode" autocomplete="off"><i class="fa fa-television"></i> TV Shows
                                                 </label>
-                                                <label class="btn btn-dark">
+                                                <label class="btn btn-dark btn-filter">
                                                     <input type="checkbox" name="media_type-filter" id="history-media_type-track" value="track" autocomplete="off"><i class="fa fa-music"></i> Music
                                                 </label>
-                                                <label class="btn btn-dark">
+                                                <label class="btn btn-dark btn-filter">
                                                     <input type="checkbox" name="media_type-filter" id="history-media_type-live" value="live" autocomplete="off"><i class="fa fa-broadcast-tower"></i> Live TV
                                                 </label>
                                             </div>
                                             <div class="btn-group" data-toggle="buttons" id="transcode_decision-selection">
-                                                <label class="btn btn-dark">
+                                                <label class="btn btn-dark btn-filter">
                                                     <input type="checkbox" name="transcode_decision-filter" id="history-transcode_decision-direct_play" value="direct play" autocomplete="off"><i class="fa fa-play-circle"></i> Direct Play
                                                 </label>
-                                                <label class="btn btn-dark">
+                                                <label class="btn btn-dark btn-filter">
                                                     <input type="checkbox" name="transcode_decision-filter" id="history-transcode_decision-direct_stream" value="copy" autocomplete="off"><i class="fa fa-stream"></i> Direct Stream
                                                 </label>
-                                                <label class="btn btn-dark">
+                                                <label class="btn btn-dark btn-filter">
                                                     <input type="checkbox" name="transcode_decision-filter" id="history-transcode_decision-transcode" value="transcode" autocomplete="off"><i class="fa fa-server"></i> Transcode
                                                 </label>
                                             </div>

From 35aca11feb213d59b416f009af139eaee8298d3a Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 27 Feb 2022 17:03:11 -0800
Subject: [PATCH 042/743] Escape characters in username log filter

* Remove filter for friendly names
---
 data/interfaces/default/settings.html | 2 +-
 plexpy/logger.py                      | 7 ++-----
 2 files changed, 3 insertions(+), 6 deletions(-)

diff --git a/data/interfaces/default/settings.html b/data/interfaces/default/settings.html
index adda3782..3d6ab932 100644
--- a/data/interfaces/default/settings.html
+++ b/data/interfaces/default/settings.html
@@ -164,7 +164,7 @@
                                 <input type="checkbox" id="log_blacklist_usernames" name="log_blacklist_usernames" value="1" ${config['log_blacklist_usernames']}> Mask Usernames in Logs
                             </label>
                             <p class="help-block">
-                                Enable to mask Plex usernames and Tautulli friendly names with asterisks (*) in the logs.<br />
+                                Enable to mask Plex usernames with asterisks (*) in the logs.<br />
                                 Note: Only logs from the time this setting is enabled will be masked.
                             </p>
                         </div>
diff --git a/plexpy/logger.py b/plexpy/logger.py
index cf7fb294..bda5c4cc 100644
--- a/plexpy/logger.py
+++ b/plexpy/logger.py
@@ -130,20 +130,17 @@ class UsernameFilter(logging.Filter):
 
         for item in items:
             username = item['username']
-            friendly_name = item['friendly_name']
 
-            if username == 'Local':
+            if username.lower() in ('local', 'guest'):
                 continue
 
             try:
                 record.msg = self.replace(record.msg, username)
-                record.msg = self.replace(record.msg, friendly_name)
 
                 args = []
                 for arg in record.args:
                     if isinstance(arg, str):
                         arg = self.replace(arg, username)
-                        arg = self.replace(arg, friendly_name)
                     args.append(arg)
                 record.args = tuple(args)
             except:
@@ -154,7 +151,7 @@ class UsernameFilter(logging.Filter):
     @staticmethod
     def replace(text, match):
         mask = match[:2] + 8 * '*' + match[-1]
-        return re.sub(r'\b{}\b'.format(match), mask, text, flags=re.IGNORECASE)
+        return re.sub(re.escape(match), mask, text, flags=re.IGNORECASE)
 
 
 class RegexFilter(logging.Filter):

From 50d90d16bfd64e4a88f2cbb475da95ced52bce3e Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 11 Mar 2022 20:18:10 -0800
Subject: [PATCH 043/743] Update App Store link to specify iphone

---
 data/interfaces/default/settings.html | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/data/interfaces/default/settings.html b/data/interfaces/default/settings.html
index 3d6ab932..a6a95cb0 100644
--- a/data/interfaces/default/settings.html
+++ b/data/interfaces/default/settings.html
@@ -1582,7 +1582,7 @@
                                 Get the Tautulli Remote app on
                                 <a href="${anon_url('https://play.google.com/store/apps/details?id=com.tautulli.tautulli_remote')}" target="_blank" rel="noreferrer">Google Play</a>
                                 or the
-                                <a href="${anon_url('https://apps.apple.com/us/app/tautulli-remote/id1570909086')}" target="_blank" rel="noreferrer">App Store</a>
+                                <a href="${anon_url('https://apps.apple.com/us/app/tautulli-remote/id1570909086?platform=iphone')}" target="_blank" rel="noreferrer">App Store</a>
                                 to access Tautulli from your mobile device.
                                 <br />
                             </p>
@@ -1591,7 +1591,7 @@
                                     <a href="${anon_url('https://play.google.com/store/apps/details?id=com.tautulli.tautulli_remote')}" target="_blank" rel="noreferrer"><img alt="Get it on Google Play" src="images/google-play-badge.svg" /></a>
                                 </span>
                                 <span class="app-badge">
-                                    <a href="${anon_url('https://apps.apple.com/us/app/tautulli-remote/id1570909086')}" target="_blank" rel="noreferrer"><img alt="Download on the App Store" src="images/app-store-badge.svg" /></a>
+                                    <a href="${anon_url('https://apps.apple.com/us/app/tautulli-remote/id1570909086?platform=iphone')}" target="_blank" rel="noreferrer"><img alt="Download on the App Store" src="images/app-store-badge.svg" /></a>
                                 </span>
                                 <span class="app-badge">
                                     <small>Google Play and the Google Play logo are trademarks of Google LLC.</small>

From eb1d724417604bc30d9ead66a1e2df4cc435965d Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Wed, 16 Mar 2022 16:59:58 -0700
Subject: [PATCH 044/743] Add Tautulli to X-Plex-Device-Name header

---
 data/interfaces/default/js/script.js | 2 +-
 plexpy/http_handler.py               | 3 ++-
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/data/interfaces/default/js/script.js b/data/interfaces/default/js/script.js
index 14e12b06..2df5daeb 100644
--- a/data/interfaces/default/js/script.js
+++ b/data/interfaces/default/js/script.js
@@ -619,7 +619,7 @@ function getPlexHeaders(clientID) {
         'X-Plex-Platform-Version': p.version,
         'X-Plex-Model': 'Plex OAuth',
         'X-Plex-Device': p.os,
-        'X-Plex-Device-Name': p.name,
+        'X-Plex-Device-Name': p.name + ' (Tautulli)',
         'X-Plex-Device-Screen-Resolution': window.screen.width + 'x' + window.screen.height,
         'X-Plex-Language': 'en'
     };
diff --git a/plexpy/http_handler.py b/plexpy/http_handler.py
index 6672e050..974b9ce4 100644
--- a/plexpy/http_handler.py
+++ b/plexpy/http_handler.py
@@ -60,7 +60,8 @@ class HTTPHandler(object):
                 'X-Plex-Platform-Version': plexpy.common.PLATFORM_RELEASE,
                 'X-Plex-Device': '{} {}'.format(plexpy.common.PLATFORM,
                                                 plexpy.common.PLATFORM_RELEASE),
-                'X-Plex-Device-Name': plexpy.common.PLATFORM_DEVICE_NAME
+                'X-Plex-Device-Name': '{} ({})'.format(plexpy.common.PLATFORM_DEVICE_NAME,
+                                                       plexpy.common.PRODUCT)
             }
 
         self.token = token

From 87389320fbbc059b49635ce85325e23db3b56fa4 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 18 Mar 2022 15:49:44 -0700
Subject: [PATCH 045/743] Fix live tv filter in history query

* Fixes #1691
---
 plexpy/datafactory.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/plexpy/datafactory.py b/plexpy/datafactory.py
index 82b8a193..c05224a2 100644
--- a/plexpy/datafactory.py
+++ b/plexpy/datafactory.py
@@ -112,7 +112,7 @@ class DataFactory(object):
             'secure',
             'relayed',
             'session_history.media_type',
-            '(CASE WHEN session_history_metadata.live = 1 THEN "live" ELSE session_history.media_type END) \
+            '(CASE WHEN session_history_metadata.live = 1 THEN \'live\' ELSE session_history.media_type END) \
              AS media_type_live',
             'session_history_metadata.rating_key',
             'session_history_metadata.parent_rating_key',
@@ -170,7 +170,7 @@ class DataFactory(object):
                 'secure',
                 'relayed',
                 'media_type',
-                '(CASE WHEN live = 1 THEN "live" ELSE media_type END) AS media_type_live',
+                '(CASE WHEN live = 1 THEN \'live\' ELSE media_type END) AS media_type_live',
                 'rating_key',
                 'parent_rating_key',
                 'grandparent_rating_key',

From 9c8e8b435161647b70824e13934104880deafdd9 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 26 Mar 2022 14:57:44 -0700
Subject: [PATCH 046/743] Simplify default settings in setup wizard

---
 data/interfaces/default/welcome.html | 18 ------------------
 plexpy/config.py                     | 10 +---------
 plexpy/datafactory.py                |  3 ---
 plexpy/libraries.py                  | 10 +++-------
 plexpy/webserve.py                   | 24 ++++++++++--------------
 5 files changed, 14 insertions(+), 51 deletions(-)

diff --git a/data/interfaces/default/welcome.html b/data/interfaces/default/welcome.html
index adb77e45..33cd290c 100644
--- a/data/interfaces/default/welcome.html
+++ b/data/interfaces/default/welcome.html
@@ -229,24 +229,6 @@
                     <!-- Required fields but hidden -->
                     <div style="display: none;">
                         <input type="checkbox" name="first_run" id="first_run" value="1" checked>
-                        <input type="checkbox" name="group_history_tables" id="group_history_tables" value="1" checked>
-                        <input type="checkbox" name="history_table_activity" id="history_table_activity" value="1" checked>
-                        <input type="checkbox" name="sys_tray_icon" id="sys_tray_icon" value="1" checked>
-                        <input type="checkbox" name="launch_startup" id="launch_startup" value="1" checked>
-                        <input type="checkbox" name="launch_browser" id="launch_browser" value="1" checked>
-                        <input type="checkbox" name="api_enabled" id="api_enabled" value="1" checked>
-                        <input type="checkbox" name="refresh_users_on_startup" id="refresh_users_on_startup" value="1" checked>
-                        <input type="checkbox" name="refresh_libraries_on_startup" id="refresh_libraries_on_startup" value="1" checked>
-                        <input type="checkbox" name="check_github" id="check_github" value="1" checked>
-                        <input type="checkbox" name="log_blacklist" id="log_blacklist" value="1" checked>
-                        <input type="checkbox" name="log_blacklist_usernames" id="log_blacklist_usernames" value="1" checked>
-                        <input type="checkbox" name="anon_redirect_dynamic" id="anon_redirect_dynamic" value="1" checked>
-                        <input type="checkbox" name="cache_images" id="cache_images" value="1" checked>
-                        <input type="checkbox" name="notify_group_recently_added_grandparent" id="notify_group_recently_added_grandparent" value="1" checked>
-                        <input type="checkbox" name="notify_group_recently_added_parent" id="notify_group_recently_added_parent" value="1" checked>
-                        <input type="checkbox" name="server_changed" id="server_changed" value="1" checked>
-                        <input type="text" name="home_stats_cards" id="home_stats_cards" value="first_run_wizard">
-                        <input type="text" name="home_library_cards" id="home_library_cards" value="first_run_wizard">
                     </div>
 
                 </div>
diff --git a/plexpy/config.py b/plexpy/config.py
index 6f36f55e..42a1ce8a 100644
--- a/plexpy/config.py
+++ b/plexpy/config.py
@@ -116,7 +116,7 @@ _CONFIG_DEFINITIONS = {
     'GROUP_HISTORY_TABLES': (int, 'General', 1),
     'HISTORY_TABLE_ACTIVITY': (int, 'General', 1),
     'HOME_SECTIONS': (list, 'General', ['current_activity', 'watch_stats', 'library_stats', 'recently_added']),
-    'HOME_LIBRARY_CARDS': (list, 'General', ['first_run']),
+    'HOME_LIBRARY_CARDS': (list, 'General', []),
     'HOME_STATS_CARDS': (list, 'General', ['top_movies', 'popular_movies', 'top_tv', 'popular_tv', 'top_music',
         'popular_music', 'last_watched', 'top_libraries', 'top_users', 'top_platforms', 'most_concurrent']),
     'HOME_REFRESH_INTERVAL': (int, 'General', 10),
@@ -601,14 +601,6 @@ class Config(object):
             self.CONFIG_VERSION = 4
 
         if self.CONFIG_VERSION == 4:
-            if not len(self.HOME_STATS_CARDS) and 'watch_stats' in self.HOME_SECTIONS:
-                home_sections = self.HOME_SECTIONS
-                home_sections.remove('watch_stats')
-                self.HOME_SECTIONS = home_sections
-            if not len(self.HOME_LIBRARY_CARDS) and 'library_stats' in self.HOME_SECTIONS:
-                home_sections = self.HOME_SECTIONS
-                home_sections.remove('library_stats')
-                self.HOME_SECTIONS = home_sections
 
             self.CONFIG_VERSION = 5
 
diff --git a/plexpy/datafactory.py b/plexpy/datafactory.py
index c05224a2..031c125c 100644
--- a/plexpy/datafactory.py
+++ b/plexpy/datafactory.py
@@ -988,9 +988,6 @@ class DataFactory(object):
         if session.get_session_shared_libraries():
             library_cards = session.get_session_shared_libraries()
 
-        if 'first_run_wizard' in library_cards:
-            return None
-
         library_stats = []
 
         try:
diff --git a/plexpy/libraries.py b/plexpy/libraries.py
index 985ec0f7..011f8201 100644
--- a/plexpy/libraries.py
+++ b/plexpy/libraries.py
@@ -99,13 +99,9 @@ def refresh_libraries():
                 'section_id NOT IN ({})'.format(', '.join(['?'] * len(section_ids)))
         monitor_db.action(query=query, args=[plexpy.CONFIG.PMS_IDENTIFIER] + section_ids)
 
-        if plexpy.CONFIG.HOME_LIBRARY_CARDS == ['first_run_wizard']:
-            plexpy.CONFIG.__setattr__('HOME_LIBRARY_CARDS', library_keys)
-            plexpy.CONFIG.write()
-        else:
-            new_keys = plexpy.CONFIG.HOME_LIBRARY_CARDS + new_keys
-            plexpy.CONFIG.__setattr__('HOME_LIBRARY_CARDS', new_keys)
-            plexpy.CONFIG.write()
+        new_keys = plexpy.CONFIG.HOME_LIBRARY_CARDS + new_keys
+        plexpy.CONFIG.__setattr__('HOME_LIBRARY_CARDS', new_keys)
+        plexpy.CONFIG.write()
 
         logger.info("Tautulli Libraries :: Libraries list refreshed.")
         return True
diff --git a/plexpy/webserve.py b/plexpy/webserve.py
index 76a4d600..63952807 100644
--- a/plexpy/webserve.py
+++ b/plexpy/webserve.py
@@ -3171,14 +3171,16 @@ class WebInterface(object):
         # First run from the setup wizard
         if kwargs.pop('first_run', None):
             first_run = True
+            server_changed = True
 
-        for checked_config in config.CHECKED_SETTINGS:
-            checked_config = checked_config.lower()
-            if checked_config not in kwargs:
-                # checked items should be zero or one. if they were not sent then the item was not checked
-                kwargs[checked_config] = 0
-            else:
-                kwargs[checked_config] = 1
+        if not first_run:
+            for checked_config in config.CHECKED_SETTINGS:
+                checked_config = checked_config.lower()
+                if checked_config not in kwargs:
+                    # checked items should be zero or one. if they were not sent then the item was not checked
+                    kwargs[checked_config] = 0
+                else:
+                    kwargs[checked_config] = 1
 
         # If http password exists in config, do not overwrite when blank value received
         if kwargs.get('http_password') == '    ':
@@ -3237,9 +3239,6 @@ class WebInterface(object):
                     del kwargs[k]
             kwargs['home_stats_cards'] = kwargs['home_stats_cards'].split(',')
 
-            if kwargs['home_stats_cards'] == ['first_run_wizard']:
-                kwargs['home_stats_cards'] = plexpy.CONFIG.HOME_STATS_CARDS
-
         # Remove config with 'hlcard-' prefix and change home_library_cards to list
         if kwargs.get('home_library_cards'):
             for k in list(kwargs.keys()):
@@ -3247,11 +3246,8 @@ class WebInterface(object):
                     del kwargs[k]
             kwargs['home_library_cards'] = kwargs['home_library_cards'].split(',')
 
-            if kwargs['home_library_cards'] == ['first_run_wizard']:
-                refresh_libraries = True
-
         # If we change the server, make sure we grab the new url and refresh libraries and users lists.
-        if kwargs.pop('server_changed', None):
+        if kwargs.pop('server_changed', None) or server_changed:
             server_changed = True
             refresh_users = True
             refresh_libraries = True

From 9a4ca69590bacbbc5ec0076e078b9e38aea85e35 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 26 Mar 2022 15:11:20 -0700
Subject: [PATCH 047/743] v2.9.5

---
 CHANGELOG.md      | 21 +++++++++++++++++++++
 plexpy/version.py |  2 +-
 2 files changed, 22 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 0cb03f75..afffb6f2 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,26 @@
 # Changelog
 
+## v2.9.5 (2022-03-26)
+
+* Note:
+  * Updated Snap packages are currently unavailable due to an upstream issue.
+* Activity:
+  * Change: Improve calculation for transcode progress bar percentage on the activity cards.
+* History:
+  * Fix: Live TV history filter not working. (#1691) 
+* Newsletter:
+  * Fix: Newsletter not showing different album types. (#1559) 
+* UI:
+  * Fix: Display season summary on the media info page if available with a fallback to show summary. (#1657)
+  * Change: Colour active filter buttons to improve contrast. (#1663)
+* API:
+  * New: Added transcode offset keys to get_activity command.
+* Other:
+  * Fix: Reschedule backup task after changing backup interval. (#1662)
+  * Fix: Dynamic anonymous redirect setting not being enabled by default after the setup wizard.
+  * Fix: Usernames with special characters not being filtered in the logs.
+
+
 ## v2.9.4 (2022-02-12)
 
 * UI:
diff --git a/plexpy/version.py b/plexpy/version.py
index bb6feecc..854f96d2 100644
--- a/plexpy/version.py
+++ b/plexpy/version.py
@@ -18,4 +18,4 @@
 from __future__ import unicode_literals
 
 PLEXPY_BRANCH = "master"
-PLEXPY_RELEASE_VERSION = "v2.9.4"
+PLEXPY_RELEASE_VERSION = "v2.9.5"

From 5d84587ee26b992bb66ab85d759e0b13a33b203f Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 26 Mar 2022 15:40:28 -0700
Subject: [PATCH 048/743] Fix validating Plex login in setup wizard

* Fixes #1697
---
 data/interfaces/default/welcome.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/data/interfaces/default/welcome.html b/data/interfaces/default/welcome.html
index 33cd290c..c1e043cc 100644
--- a/data/interfaces/default/welcome.html
+++ b/data/interfaces/default/welcome.html
@@ -291,7 +291,7 @@
         var valid_pms_token = el.val();
         var retValue = {};
 
-        if (valid_pms_token === 0) {
+        if (valid_pms_token !== "1") {
             retValue.status = false;
             retValue.msg = "Please authenticate.";
             $("#pms-token-status").html('<i class="fa fa-exclamation-circle"></i> Please authenticate.');

From 944a231e5bda3a7f9978f61f45937a6c7da572b6 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 26 Mar 2022 15:47:17 -0700
Subject: [PATCH 049/743] Change websocket header to a dict

---
 plexpy/web_socket.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/plexpy/web_socket.py b/plexpy/web_socket.py
index 5fc034a4..de4bb3cd 100644
--- a/plexpy/web_socket.py
+++ b/plexpy/web_socket.py
@@ -1,4 +1,4 @@
-# -*- coding: utf-8 -*-
+# -*- coding: utf-8 -*-
 
 # This file is part of Tautulli.
 #
@@ -178,9 +178,9 @@ def run():
 
     # Set authentication token (if one is available)
     if plexpy.CONFIG.PMS_TOKEN:
-        header = ["X-Plex-Token: %s" % plexpy.CONFIG.PMS_TOKEN]
+        header = {"X-Plex-Token": plexpy.CONFIG.PMS_TOKEN}
     else:
-        header = []
+        header = None
 
     global ws_shutdown
     ws_shutdown = False

From 3cd98457c26916bcbc703169d70a19683dd95256 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 26 Mar 2022 15:47:53 -0700
Subject: [PATCH 050/743] Apply PMS_TIMEOUT setting to websocket connection

---
 plexpy/web_socket.py | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/plexpy/web_socket.py b/plexpy/web_socket.py
index de4bb3cd..b70d4b6e 100644
--- a/plexpy/web_socket.py
+++ b/plexpy/web_socket.py
@@ -1,4 +1,4 @@
-# -*- coding: utf-8 -*-
+# -*- coding: utf-8 -*-
 
 # This file is part of Tautulli.
 #
@@ -182,6 +182,8 @@ def run():
     else:
         header = None
 
+    timeout = plexpy.CONFIG.PMS_TIMEOUT
+
     global ws_shutdown
     ws_shutdown = False
     reconnects = 0
@@ -189,7 +191,7 @@ def run():
     # Try an open the websocket connection
     logger.info("Tautulli WebSocket :: Opening %swebsocket." % secure)
     try:
-        plexpy.WEBSOCKET = create_connection(uri, header=header, sslopt=sslopt)
+        plexpy.WEBSOCKET = create_connection(uri, timeout=timeout, header=header, sslopt=sslopt)
         logger.info("Tautulli WebSocket :: Ready")
         plexpy.WS_CONNECTED = True
     except (websocket.WebSocketException, IOError, Exception) as e:
@@ -222,7 +224,7 @@ def run():
                 logger.warn("Tautulli WebSocket :: Reconnection attempt %s." % str(reconnects))
 
                 try:
-                    plexpy.WEBSOCKET = create_connection(uri, header=header, sslopt=sslopt)
+                    plexpy.WEBSOCKET = create_connection(uri, timeout=timeout, header=header, sslopt=sslopt)
                     logger.info("Tautulli WebSocket :: Ready")
                     plexpy.WS_CONNECTED = True
                 except (websocket.WebSocketException, IOError, Exception) as e:

From 5c06accca0fcc4b99963cfac90c763c969b88bea Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 1 Apr 2022 10:19:41 -0700
Subject: [PATCH 051/743] Mask emails and longer usernames first

---
 plexpy/logger.py | 8 ++++++--
 plexpy/users.py  | 2 +-
 2 files changed, 7 insertions(+), 3 deletions(-)

diff --git a/plexpy/logger.py b/plexpy/logger.py
index bda5c4cc..5a1c0f0f 100644
--- a/plexpy/logger.py
+++ b/plexpy/logger.py
@@ -126,7 +126,11 @@ class UsernameFilter(logging.Filter):
         if not plexpy._INITIALIZED:
             return True
 
-        items = users.Users().get_users() or []
+        items = sorted(
+            users.Users().get_users(),
+            key=lambda x: len(x['username']),
+            reverse=True
+        )
 
         for item in items:
             username = item['username']
@@ -339,11 +343,11 @@ def initLogger(console=False, log_dir=False, verbose=False):
                        logger_plex_websocket.handlers + \
                        cherrypy.log.error_log.handlers
         for handler in log_handlers:
-            handler.addFilter(UsernameFilter())
             handler.addFilter(BlacklistFilter())
             handler.addFilter(PublicIPFilter())
             handler.addFilter(PlexDirectIPFilter())
             handler.addFilter(EmailFilter())
+            handler.addFilter(UsernameFilter())
             handler.addFilter(PlexTokenFilter())
 
     # Install exception hooks
diff --git a/plexpy/users.py b/plexpy/users.py
index dbb064bf..571b565f 100644
--- a/plexpy/users.py
+++ b/plexpy/users.py
@@ -668,7 +668,7 @@ class Users(object):
             result = monitor_db.select(query=query)
         except Exception as e:
             logger.warn("Tautulli Users :: Unable to execute database query for get_users: %s." % e)
-            return None
+            return []
 
         users = []
         for item in result:

From b737ab96b4e6045ac3b418b5b2fe98e6cee416fc Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 1 Apr 2022 21:08:10 -0700
Subject: [PATCH 052/743] Change include summary option for Discord and Slack
 for all media types

---
 plexpy/notifiers.py | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/plexpy/notifiers.py b/plexpy/notifiers.py
index 42df413d..7c9627f0 100644
--- a/plexpy/notifiers.py
+++ b/plexpy/notifiers.py
@@ -1084,7 +1084,7 @@ class DISCORD(Notifier):
             else:
                 attachment['image'] = {'url': poster_url}
 
-            if self.config['incl_description'] or pretty_metadata.media_type in ('artist', 'album', 'track'):
+            if self.config['incl_description']:
                 attachment['description'] = description[:2045] + (description[2045:] and '...')
 
             fields = []
@@ -1153,10 +1153,10 @@ class DISCORD(Notifier):
                                          'must be enabled under the 3rd Party APIs settings tab.',
                           'input_type': 'checkbox'
                           },
-                         {'label': 'Include Plot Summaries',
+                         {'label': 'Include Summary',
                           'value': self.config['incl_description'],
                           'name': 'discord_incl_description',
-                          'description': 'Include a plot summary for movies and TV shows on the info card.',
+                          'description': 'Include a summary for the media on the info card.',
                           'input_type': 'checkbox'
                           },
                          {'label': 'Include Link to Plex Web',
@@ -2298,10 +2298,10 @@ class MICROSOFTTEAMS(Notifier):
                                          'must be enabled under the 3rd Party APIs settings tab.',
                           'input_type': 'checkbox'
                           },
-                         {'label': 'Include Plot Summaries',
+                         {'label': 'Include Summary',
                           'value': self.config['incl_description'],
                           'name': 'microsoftteams_incl_description',
-                          'description': 'Include a plot summary for movies and TV shows on the info card.',
+                          'description': 'Include a summary for the media on the info card.',
                           'input_type': 'checkbox'
                           },
                          {'label': 'Include Link to Plex Web',
@@ -3548,7 +3548,7 @@ class SLACK(Notifier):
             else:
                 attachment['image_url'] = poster_url
 
-            if self.config['incl_description'] or pretty_metadata.media_type in ('artist', 'album', 'track'):
+            if self.config['incl_description']:
                 attachment['text'] = description
 
             fields = []
@@ -3616,10 +3616,10 @@ class SLACK(Notifier):
                                          'must be enabled under the 3rd Party APIs settings tab.',
                           'input_type': 'checkbox'
                           },
-                         {'label': 'Include Plot Summaries',
+                         {'label': 'Include Summary',
                           'value': self.config['incl_description'],
                           'name': 'slack_incl_description',
-                          'description': 'Include a plot summary for movies and TV shows on the info card.',
+                          'description': 'Include a summary for the media on the info card.',
                           'input_type': 'checkbox'
                           },
                          {'label': 'Include Link to Plex Web',

From 73b94782f9ca939cd0c7daa60fd6233808615250 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 1 Apr 2022 21:31:06 -0700
Subject: [PATCH 053/743] Add hidden username and email columns to users table

---
 data/interfaces/default/js/tables/users.js | 36 ++++++++++++++++++----
 data/interfaces/default/users.html         |  2 ++
 plexpy/users.py                            |  2 ++
 plexpy/webserve.py                         |  2 ++
 4 files changed, 36 insertions(+), 6 deletions(-)

diff --git a/data/interfaces/default/js/tables/users.js b/data/interfaces/default/js/tables/users.js
index 82caf116..67230361 100644
--- a/data/interfaces/default/js/tables/users.js
+++ b/data/interfaces/default/js/tables/users.js
@@ -90,6 +90,30 @@ users_list_table_options = {
         },
         {
             "targets": [3],
+            "data": "username",
+            "createdCell": function (td, cellData, rowData, row, col) {
+                if (cellData !== null && cellData !== '') {
+                    $(td).html(cellData);
+                }
+            },
+            "visible": false,
+            "width": "10%",
+            "className": "no-wrap"
+        },
+        {
+            "targets": [4],
+            "data": "email",
+            "createdCell": function (td, cellData, rowData, row, col) {
+                if (cellData !== null && cellData !== '') {
+                    $(td).html(cellData);
+                }
+            },
+            "visible": false,
+            "width": "10%",
+            "className": "no-wrap"
+        },
+        {
+            "targets": [5],
             "data": "last_seen",
             "createdCell": function (td, cellData, rowData, row, col) {
                 if (cellData !== null && cellData !== '') {
@@ -103,7 +127,7 @@ users_list_table_options = {
             "className": "no-wrap"
         },
         {
-            "targets": [4],
+            "targets": [6],
             "data": "ip_address",
             "createdCell": function (td, cellData, rowData, row, col) {
                 if (cellData) {
@@ -121,7 +145,7 @@ users_list_table_options = {
             "className": "no-wrap modal-control-ip"
         },
         {
-            "targets": [5],
+            "targets": [7],
             "data": "platform",
             "createdCell": function (td, cellData, rowData, row, col) {
                 if (cellData !== null && cellData !== '') {
@@ -134,7 +158,7 @@ users_list_table_options = {
             "className": "no-wrap modal-control"
         },
         {
-            "targets": [6],
+            "targets": [8],
             "data":"player",
             "createdCell": function (td, cellData, rowData, row, col) {
                 if (cellData !== null && cellData !== '') {
@@ -155,7 +179,7 @@ users_list_table_options = {
             "className": "no-wrap modal-control"
         },
         {
-            "targets": [7],
+            "targets": [9],
             "data":"last_played",
             "createdCell": function (td, cellData, rowData, row, col) {
                 if (cellData !== null && cellData !== '') {
@@ -196,7 +220,7 @@ users_list_table_options = {
             "className": "datatable-wrap"
         },
         {
-            "targets": [8],
+            "targets": [10],
             "data": "plays",
             "createdCell": function (td, cellData, rowData, row, col) {
                 if (cellData !== null && cellData !== '') {
@@ -208,7 +232,7 @@ users_list_table_options = {
             "className": "no-wrap"
         },
         {
-            "targets": [9],
+            "targets": [11],
             "data": "duration",
             "createdCell": function (td, cellData, rowData, row, col) {
                 if (cellData !== null && cellData !== '') {
diff --git a/data/interfaces/default/users.html b/data/interfaces/default/users.html
index 495a8056..37a0faa0 100644
--- a/data/interfaces/default/users.html
+++ b/data/interfaces/default/users.html
@@ -33,6 +33,8 @@
                 <th align="left" id="edit_row">Edit</th>
                 <th align="right" id="avatar"></th>
                 <th align="left" id="friendly_name">User</th>
+                <th align="left" id="username">Username</th>
+                <th align="left" id="email">Email</th>
                 <th align="left" id="last_seen">Last Streamed</th>
                 <th align="left" id="last_known_ip">Last Known IP</th>
                 <th align="left" id="last_platform">Last Platform</th>
diff --git a/plexpy/users.py b/plexpy/users.py
index 571b565f..c79b62d5 100644
--- a/plexpy/users.py
+++ b/plexpy/users.py
@@ -127,6 +127,7 @@ class Users(object):
                    'users.username',
                    '(CASE WHEN users.friendly_name IS NULL OR TRIM(users.friendly_name) = "" \
                     THEN users.username ELSE users.friendly_name END) AS friendly_name',
+                   'users.email',
                    'users.thumb AS user_thumb',
                    'users.custom_avatar_url AS custom_thumb',
                    'COUNT(DISTINCT %s) AS plays' % group_by,
@@ -202,6 +203,7 @@ class Users(object):
                    'user_id': item['user_id'],
                    'username': item['username'],
                    'friendly_name': item['friendly_name'],
+                   'email': item['email'],
                    'user_thumb': user_thumb,
                    'plays': item['plays'],
                    'duration': item['duration'],
diff --git a/plexpy/webserve.py b/plexpy/webserve.py
index 63952807..a7358ec7 100644
--- a/plexpy/webserve.py
+++ b/plexpy/webserve.py
@@ -1305,6 +1305,8 @@ class WebInterface(object):
             # TODO: Find some one way to automatically get the columns
             dt_columns = [("user_thumb", False, False),
                           ("friendly_name", True, True),
+                          ("username", True, True),
+                          ("email", True, True),
                           ("last_seen", True, False),
                           ("ip_address", True, True),
                           ("platform", True, True),

From e996c4b375c00e797d3608c10ce59be1eb846757 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 4 Apr 2022 21:06:25 -0700
Subject: [PATCH 054/743] Change default update check interval to hours instead
 of minutes

---
 plexpy/config.py | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/plexpy/config.py b/plexpy/config.py
index 42a1ce8a..724e1a08 100644
--- a/plexpy/config.py
+++ b/plexpy/config.py
@@ -91,7 +91,7 @@ _CONFIG_DEFINITIONS = {
     'CACHE_SIZEMB': (int, 'Advanced', 32),
     'CHECK_DOCKER_MOUNT': (int, 'Advanced', 1),
     'CHECK_GITHUB': (int, 'General', 1),
-    'CHECK_GITHUB_INTERVAL': (int, 'General', 360),
+    'CHECK_GITHUB_INTERVAL': (int, 'General', 6),
     'CHECK_GITHUB_ON_STARTUP': (int, 'General', 1),
     'CHECK_GITHUB_CACHE_SECONDS': (int, 'Advanced', 3600),
     'CLEANUP_FILES': (int, 'General', 0),
@@ -676,10 +676,11 @@ class Config(object):
             self.CONFIG_VERSION = 18
 
         if self.CONFIG_VERSION == 18:
-            self.CHECK_GITHUB_INTERVAL = (
-                    int(self.CHECK_GITHUB_INTERVAL // 60)
-                    + (self.CHECK_GITHUB_INTERVAL % 60 > 0)
-            )
+            if self.CHECK_GITHUB_INTERVAL > 24:
+                self.CHECK_GITHUB_INTERVAL = (
+                        int(self.CHECK_GITHUB_INTERVAL // 60)
+                        + (self.CHECK_GITHUB_INTERVAL % 60 > 0)
+                )
 
             self.CONFIG_VERSION = 19
 

From aa6592eec7c28f7cbd27545d6f098a8445accbd8 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 8 Apr 2022 20:00:48 -0700
Subject: [PATCH 055/743] Fix importing Plex usernames

* Fixes #1710
* Also import the user title (Full Name)
---
 plexpy/__init__.py | 14 ++++++++++++--
 plexpy/plextv.py   |  4 +++-
 plexpy/users.py    |  4 ++++
 3 files changed, 19 insertions(+), 3 deletions(-)

diff --git a/plexpy/__init__.py b/plexpy/__init__.py
index 7d5fb00d..a7313b49 100644
--- a/plexpy/__init__.py
+++ b/plexpy/__init__.py
@@ -714,8 +714,9 @@ def dbcheck():
     c_db.execute(
         'CREATE TABLE IF NOT EXISTS users (id INTEGER PRIMARY KEY AUTOINCREMENT, '
         'user_id INTEGER DEFAULT NULL UNIQUE, username TEXT NOT NULL, friendly_name TEXT, '
-        'thumb TEXT, custom_avatar_url TEXT, email TEXT, is_active INTEGER DEFAULT 1, is_admin INTEGER DEFAULT 0, '
-        'is_home_user INTEGER DEFAULT NULL, is_allow_sync INTEGER DEFAULT NULL, is_restricted INTEGER DEFAULT NULL, '
+        'thumb TEXT, custom_avatar_url TEXT, title TEXT, email TEXT, '
+        'is_active INTEGER DEFAULT 1, is_admin INTEGER DEFAULT 0, is_home_user INTEGER DEFAULT NULL, '
+        'is_allow_sync INTEGER DEFAULT NULL, is_restricted INTEGER DEFAULT NULL, '
         'do_notify INTEGER DEFAULT 1, keep_history INTEGER DEFAULT 1, deleted_user INTEGER DEFAULT 0, '
         'allow_guest INTEGER DEFAULT 0, user_token TEXT, server_token TEXT, shared_libraries TEXT, '
         'filter_all TEXT, filter_movies TEXT, filter_tv TEXT, filter_music TEXT, filter_photos TEXT)'
@@ -1909,6 +1910,15 @@ def dbcheck():
             'ALTER TABLE users ADD COLUMN is_active INTEGER DEFAULT 1'
         )
 
+    # Upgrade users table from earlier versions
+    try:
+        c_db.execute('SELECT title FROM users')
+    except sqlite3.OperationalError:
+        logger.debug("Altering database. Updating database table users.")
+        c_db.execute(
+            'ALTER TABLE users ADD COLUMN title TEXT'
+        )
+
     # Upgrade notify_log table from earlier versions
     try:
         c_db.execute('SELECT poster_url FROM notify_log')
diff --git a/plexpy/plextv.py b/plexpy/plextv.py
index d95f8d16..1cb53dd5 100644
--- a/plexpy/plextv.py
+++ b/plexpy/plextv.py
@@ -357,6 +357,7 @@ class PlexTV(object):
         for a in xml_head:
             own_details = {"user_id": helpers.get_xml_attr(a, 'id'),
                            "username": helpers.get_xml_attr(a, 'username'),
+                           "title": helpers.get_xml_attr(a, 'title'),
                            "thumb": helpers.get_xml_attr(a, 'thumb'),
                            "email": helpers.get_xml_attr(a, 'email'),
                            "is_active": 1,
@@ -384,7 +385,8 @@ class PlexTV(object):
 
         for a in xml_head:
             friend = {"user_id": helpers.get_xml_attr(a, 'id'),
-                      "username": helpers.get_xml_attr(a, 'title'),
+                      "username": helpers.get_xml_attr(a, 'username'),
+                      "title": helpers.get_xml_attr(a, 'title'),
                       "thumb": helpers.get_xml_attr(a, 'thumb'),
                       "email": helpers.get_xml_attr(a, 'email'),
                       "is_active": 1,
diff --git a/plexpy/users.py b/plexpy/users.py
index c79b62d5..81276e08 100644
--- a/plexpy/users.py
+++ b/plexpy/users.py
@@ -84,6 +84,10 @@ def refresh_users():
                 else:
                     item['custom_avatar_url'] = item['thumb']
 
+            # Check if title is the same as the username
+            if item['title'] == item['username']:
+                item['title'] = None
+
             monitor_db.upsert('users', key_dict=keys_dict, value_dict=item)
 
         query = 'UPDATE users SET is_active = 0 WHERE user_id NOT IN ({})'.format(', '.join(['?'] * len(user_ids)))

From 4862aee9a111c843138472c8b47cd5edb133b1ff Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 8 Apr 2022 20:02:53 -0700
Subject: [PATCH 056/743] Add hidden user title (Full Name) column to users
 table

---
 data/interfaces/default/js/tables/users.js | 26 ++++++++++++++++------
 data/interfaces/default/users.html         |  1 +
 plexpy/users.py                            |  2 ++
 plexpy/webserve.py                         |  4 ++++
 4 files changed, 26 insertions(+), 7 deletions(-)

diff --git a/data/interfaces/default/js/tables/users.js b/data/interfaces/default/js/tables/users.js
index 67230361..1b0793c8 100644
--- a/data/interfaces/default/js/tables/users.js
+++ b/data/interfaces/default/js/tables/users.js
@@ -102,7 +102,7 @@ users_list_table_options = {
         },
         {
             "targets": [4],
-            "data": "email",
+            "data": "title",
             "createdCell": function (td, cellData, rowData, row, col) {
                 if (cellData !== null && cellData !== '') {
                     $(td).html(cellData);
@@ -114,6 +114,18 @@ users_list_table_options = {
         },
         {
             "targets": [5],
+            "data": "email",
+            "createdCell": function (td, cellData, rowData, row, col) {
+                if (cellData !== null && cellData !== '') {
+                    $(td).html(cellData);
+                }
+            },
+            "visible": false,
+            "width": "10%",
+            "className": "no-wrap"
+        },
+        {
+            "targets": [6],
             "data": "last_seen",
             "createdCell": function (td, cellData, rowData, row, col) {
                 if (cellData !== null && cellData !== '') {
@@ -127,7 +139,7 @@ users_list_table_options = {
             "className": "no-wrap"
         },
         {
-            "targets": [6],
+            "targets": [7],
             "data": "ip_address",
             "createdCell": function (td, cellData, rowData, row, col) {
                 if (cellData) {
@@ -145,7 +157,7 @@ users_list_table_options = {
             "className": "no-wrap modal-control-ip"
         },
         {
-            "targets": [7],
+            "targets": [8],
             "data": "platform",
             "createdCell": function (td, cellData, rowData, row, col) {
                 if (cellData !== null && cellData !== '') {
@@ -158,7 +170,7 @@ users_list_table_options = {
             "className": "no-wrap modal-control"
         },
         {
-            "targets": [8],
+            "targets": [9],
             "data":"player",
             "createdCell": function (td, cellData, rowData, row, col) {
                 if (cellData !== null && cellData !== '') {
@@ -179,7 +191,7 @@ users_list_table_options = {
             "className": "no-wrap modal-control"
         },
         {
-            "targets": [9],
+            "targets": [10],
             "data":"last_played",
             "createdCell": function (td, cellData, rowData, row, col) {
                 if (cellData !== null && cellData !== '') {
@@ -220,7 +232,7 @@ users_list_table_options = {
             "className": "datatable-wrap"
         },
         {
-            "targets": [10],
+            "targets": [11],
             "data": "plays",
             "createdCell": function (td, cellData, rowData, row, col) {
                 if (cellData !== null && cellData !== '') {
@@ -232,7 +244,7 @@ users_list_table_options = {
             "className": "no-wrap"
         },
         {
-            "targets": [11],
+            "targets": [12],
             "data": "duration",
             "createdCell": function (td, cellData, rowData, row, col) {
                 if (cellData !== null && cellData !== '') {
diff --git a/data/interfaces/default/users.html b/data/interfaces/default/users.html
index 37a0faa0..d7dd84e8 100644
--- a/data/interfaces/default/users.html
+++ b/data/interfaces/default/users.html
@@ -34,6 +34,7 @@
                 <th align="right" id="avatar"></th>
                 <th align="left" id="friendly_name">User</th>
                 <th align="left" id="username">Username</th>
+                <th align="left" id="title">Full Name</th>
                 <th align="left" id="email">Email</th>
                 <th align="left" id="last_seen">Last Streamed</th>
                 <th align="left" id="last_known_ip">Last Known IP</th>
diff --git a/plexpy/users.py b/plexpy/users.py
index 81276e08..f434ae6f 100644
--- a/plexpy/users.py
+++ b/plexpy/users.py
@@ -131,6 +131,7 @@ class Users(object):
                    'users.username',
                    '(CASE WHEN users.friendly_name IS NULL OR TRIM(users.friendly_name) = "" \
                     THEN users.username ELSE users.friendly_name END) AS friendly_name',
+                   'users.title',
                    'users.email',
                    'users.thumb AS user_thumb',
                    'users.custom_avatar_url AS custom_thumb',
@@ -207,6 +208,7 @@ class Users(object):
                    'user_id': item['user_id'],
                    'username': item['username'],
                    'friendly_name': item['friendly_name'],
+                   'title': item['title'],
                    'email': item['email'],
                    'user_thumb': user_thumb,
                    'plays': item['plays'],
diff --git a/plexpy/webserve.py b/plexpy/webserve.py
index a7358ec7..6c8a1ad6 100644
--- a/plexpy/webserve.py
+++ b/plexpy/webserve.py
@@ -1268,6 +1268,9 @@ class WebInterface(object):
                           "do_notify": "Checked",
                           "duration": 2998290,
                           "friendly_name": "Jon Snow",
+                          "username": "LordCommanderSnow",
+                          "title": "Jon Snow",
+                          "email": "Jon.Snow.1337@CastleBlack.com",
                           "guid": "com.plexapp.agents.thetvdb://121361/6/1?lang=en",
                           "history_row_id": 1121,
                           "ip_address": "xxx.xxx.xxx.xxx",
@@ -1306,6 +1309,7 @@ class WebInterface(object):
             dt_columns = [("user_thumb", False, False),
                           ("friendly_name", True, True),
                           ("username", True, True),
+                          ("title", True, True),
                           ("email", True, True),
                           ("last_seen", True, False),
                           ("ip_address", True, True),

From a2fac2b11c9a372c1a09932b04556fca2301592d Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 9 Apr 2022 17:52:17 -0700
Subject: [PATCH 057/743] Improve display of dynamic range on activity cards

* Ref #1654. Thanks @herby2212.
---
 .../default/current_activity_instance.html    |  7 ++-
 data/interfaces/default/index.html            |  4 +-
 plexpy/helpers.py                             |  2 +-
 plexpy/pmsconnect.py                          | 57 +++++++++++++------
 plexpy/webserve.py                            |  1 +
 5 files changed, 49 insertions(+), 22 deletions(-)

diff --git a/data/interfaces/default/current_activity_instance.html b/data/interfaces/default/current_activity_instance.html
index 6cd017e3..e9838b8a 100644
--- a/data/interfaces/default/current_activity_instance.html
+++ b/data/interfaces/default/current_activity_instance.html
@@ -231,11 +231,14 @@ DOCUMENTATION :: END
                                 <div class="sub-value" id="video_decision-${sk}">
                                     % if data['media_type'] in ('movie', 'episode', 'clip') and data['stream_video_decision']:
                                         <%
-                                            if data['video_dynamic_range'] == 'HDR':
+                                            if data['video_dynamic_range'] != 'SDR':
                                                 video_dynamic_range = ' ' + data['video_dynamic_range']
+                                            else:
+                                                video_dynamic_range = ''
+                                            if data['stream_video_dynamic_range'] != 'SDR' or video_dynamic_range:
                                                 stream_video_dynamic_range = ' ' + data['stream_video_dynamic_range']
                                             else:
-                                                video_dynamic_range = stream_video_dynamic_range = ''
+                                                stream_video_dynamic_range = ''
                                         %>
                                         % if data['stream_video_decision'] == 'transcode':
                                         <%
diff --git a/data/interfaces/default/index.html b/data/interfaces/default/index.html
index 47b0d87d..715996c1 100644
--- a/data/interfaces/default/index.html
+++ b/data/interfaces/default/index.html
@@ -483,8 +483,8 @@
 
                         var video_decision = '';
                         if (['movie', 'episode', 'clip'].indexOf(s.media_type) > -1 && s.stream_video_decision) {
-                            var v_bd =  (s.video_dynamic_range === 'HDR') ? ' ' + s.video_dynamic_range : '';
-                            var sv_bd =  (s.video_dynamic_range === 'HDR') ? ' ' + s.stream_video_dynamic_range : '';
+                            var v_bd =  (s.video_dynamic_range !== 'SDR') ? ' ' + s.video_dynamic_range : '';
+                            var sv_bd =  (s.stream_video_dynamic_range !== 'SDR' || v_bd) ? ' ' + s.stream_video_dynamic_range : '';
                             var v_res= '';
                             switch (s.video_resolution.toLowerCase()) {
                                 case 'sd':
diff --git a/plexpy/helpers.py b/plexpy/helpers.py
index fb4afb80..d5ef887f 100644
--- a/plexpy/helpers.py
+++ b/plexpy/helpers.py
@@ -1545,7 +1545,7 @@ def is_hdr(bit_depth, color_space):
 
 
 def version_to_tuple(version):
-    return tuple(cast_to_int(v) for v in version.strip('v').split('.'))
+    return tuple(cast_to_int(v) for v in version.strip('v').replace('-', '.').split('.'))
 
 
 # https://stackoverflow.com/a/1855118
diff --git a/plexpy/pmsconnect.py b/plexpy/pmsconnect.py
index 2bdd4370..a993f6af 100644
--- a/plexpy/pmsconnect.py
+++ b/plexpy/pmsconnect.py
@@ -1401,6 +1401,7 @@ class PmsConnect(object):
                                             'video_color_range': helpers.get_xml_attr(stream, 'colorRange'),
                                             'video_color_space': helpers.get_xml_attr(stream, 'colorSpace'),
                                             'video_color_trc': helpers.get_xml_attr(stream, 'colorTrc'),
+                                            'video_dynamic_range': self.get_dynamic_range(stream),
                                             'video_frame_rate': helpers.get_xml_attr(stream, 'frameRate'),
                                             'video_ref_frames': helpers.get_xml_attr(stream, 'refFrames'),
                                             'video_height': helpers.get_xml_attr(stream, 'height'),
@@ -1857,6 +1858,7 @@ class PmsConnect(object):
                              'stream_video_color_space': helpers.get_xml_attr(video_stream_info, 'colorSpace'),
                              'stream_video_color_trc': helpers.get_xml_attr(video_stream_info, 'colorTrc'),
                              'stream_video_codec_level': helpers.get_xml_attr(video_stream_info, 'level'),
+                             'stream_video_dynamic_range': self.get_dynamic_range(video_stream_info),
                              'stream_video_ref_frames': helpers.get_xml_attr(video_stream_info, 'refFrames'),
                              'stream_video_language': helpers.get_xml_attr(video_stream_info, 'language'),
                              'stream_video_language_code': helpers.get_xml_attr(video_stream_info, 'languageCode'),
@@ -1872,6 +1874,7 @@ class PmsConnect(object):
                              'stream_video_color_space': '',
                              'stream_video_color_trc': '',
                              'stream_video_codec_level': '',
+                             'stream_video_dynamic_range': '',
                              'stream_video_ref_frames': '',
                              'stream_video_language': '',
                              'stream_video_language_code': '',
@@ -2064,6 +2067,7 @@ class PmsConnect(object):
                                     'video_color_range': '',
                                     'video_color_space': '',
                                     'video_color_trc': '',
+                                    'video_dynamic_range': '',
                                     'video_frame_rate': '',
                                     'video_ref_frames': '',
                                     'video_height': '',
@@ -2152,23 +2156,6 @@ class PmsConnect(object):
                 stream_details['stream_video_resolution'],
                 stream_details['stream_video_resolution'] + (video_details['stream_video_scan_type'][:1] or 'p'))
 
-            if helpers.cast_to_int(source_video_details.get('video_bit_depth')) > 8 \
-                    and source_video_details.get('video_color_space') == 'bt2020nc':
-                stream_details['video_dynamic_range'] = 'HDR'
-            else:
-                stream_details['video_dynamic_range'] = 'SDR'
-
-            if stream_details['video_dynamic_range'] == 'HDR' \
-                    and video_details['stream_video_decision'] != 'transcode' \
-                    or helpers.cast_to_int(video_details['stream_video_bit_depth']) > 8 \
-                    and video_details['stream_video_color_space'] == 'bt2020nc':
-                stream_details['stream_video_dynamic_range'] = 'HDR'
-            else:
-                stream_details['stream_video_dynamic_range'] = 'SDR'
-        else:
-            stream_details['video_dynamic_range'] = ''
-            stream_details['stream_video_dynamic_range'] = ''
-
         # Get the quality profile
         if media_type in ('movie', 'episode', 'clip') and 'stream_bitrate' in stream_details:
             if sync_id:
@@ -3182,3 +3169,39 @@ class PmsConnect(object):
                 return 'public'
 
         return plexpy.CONFIG.PMS_UPDATE_CHANNEL
+
+    @staticmethod
+    def get_dynamic_range(stream):
+        extended_display_title = helpers.get_xml_attr(stream, 'extendedDisplayTitle')
+        bit_depth = helpers.cast_to_int(helpers.get_xml_attr(stream, 'bitDepth'))
+        color_space = helpers.get_xml_attr(stream, 'colorSpace')
+        DOVI_profile = helpers.get_xml_attr(stream, 'DOVIProfile')
+
+        HDR = bool(bit_depth > 8 and 'bt2020' in color_space)
+        DV = bool(DOVI_profile)
+
+        if not HDR and not DV:
+            return 'SDR'
+
+        video_dynamic_range = []
+
+        # HDR details got introduced with PMS version 1.25.6.5545
+        if helpers.version_to_tuple(plexpy.CONFIG.PMS_VERSION) >= helpers.version_to_tuple('1.25.6.5545'):
+            if 'Dolby Vision' in extended_display_title:
+                video_dynamic_range.append('Dolby Vision')
+            if 'HLG' in extended_display_title:
+                video_dynamic_range.append('HLG')
+            if 'HDR10' in extended_display_title:
+                video_dynamic_range.append('HDR10')
+            elif 'HDR' in extended_display_title:
+                video_dynamic_range.append('HDR')
+        else:
+            if DV:
+                video_dynamic_range.append('Dolby Vision')
+            elif HDR:
+                # Exact HDR version needs PMS version 1.25.6.5545 or newer
+                video_dynamic_range.append('HDR')
+
+        if not video_dynamic_range:
+            return 'SDR'
+        return '/'.join(video_dynamic_range)
diff --git a/plexpy/webserve.py b/plexpy/webserve.py
index 6c8a1ad6..ecf42b47 100644
--- a/plexpy/webserve.py
+++ b/plexpy/webserve.py
@@ -5349,6 +5349,7 @@ class WebInterface(object):
                                              "video_color_range": "tv",
                                              "video_color_space": "bt709",
                                              "video_color_trc": "",
+                                             "video_dynamic_range": "SDR",
                                              "video_frame_rate": "23.976",
                                              "video_height": "1078",
                                              "video_language": "",

From 1ce292a0b6d3dbb8abfc15856abc722962611ac8 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 10 Apr 2022 15:40:57 -0700
Subject: [PATCH 058/743] Only build snap on amd64, arm64, armhf

---
 snap/snapcraft.yaml | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/snap/snapcraft.yaml b/snap/snapcraft.yaml
index 31dcf29c..5cdeeeb9 100644
--- a/snap/snapcraft.yaml
+++ b/snap/snapcraft.yaml
@@ -10,6 +10,11 @@ description: >
 base: core18
 confinement: strict
 
+architectures:
+  - build-on: amd64
+  - build-on: arm64
+  - build-on: armhf
+
 parts:
   tautulli:
     plugin: dump

From dd389b0f943d1e2bdb586cc440bc6b5f1e657b54 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 10 Apr 2022 15:48:32 -0700
Subject: [PATCH 059/743] v2.9.6

---
 CHANGELOG.md      | 14 ++++++++++++++
 plexpy/version.py |  2 +-
 2 files changed, 15 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index afffb6f2..4c8ba49a 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,19 @@
 # Changelog
 
+## v2.9.6 (2022-04-10)
+
+* Activity:
+  * New: Improved display of dynamic range on the activity cards. (Thanks @herby2212)
+* Notifications:
+  * Change: Make include summary option apply to all media types for Discord and Slack notifications.
+* UI:
+  * Fix: Validating Plex login in the setup wizard. (#1697)
+  * New: Added hidden username, email, and full name columns to users table. 
+* Other:
+  * Fix: Apply pms_timeout setting to websocket connection.
+  * Fix: Importing of Plex username instead of the full name. (#1710)
+
+
 ## v2.9.5 (2022-03-26)
 
 * Note:
diff --git a/plexpy/version.py b/plexpy/version.py
index 854f96d2..88024d9c 100644
--- a/plexpy/version.py
+++ b/plexpy/version.py
@@ -18,4 +18,4 @@
 from __future__ import unicode_literals
 
 PLEXPY_BRANCH = "master"
-PLEXPY_RELEASE_VERSION = "v2.9.5"
+PLEXPY_RELEASE_VERSION = "v2.9.6"

From a9860fe62a20adf29bce5440cd9eb73b9d0fadc1 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 11 Apr 2022 15:10:53 -0700
Subject: [PATCH 060/743] Fix managed users no username

---
 plexpy/users.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/plexpy/users.py b/plexpy/users.py
index f434ae6f..b7f467e2 100644
--- a/plexpy/users.py
+++ b/plexpy/users.py
@@ -88,6 +88,10 @@ def refresh_users():
             if item['title'] == item['username']:
                 item['title'] = None
 
+            # Check if username is blank (Managed Users)
+            if not item['username']:
+                item['username'] = item['title']
+
             monitor_db.upsert('users', key_dict=keys_dict, value_dict=item)
 
         query = 'UPDATE users SET is_active = 0 WHERE user_id NOT IN ({})'.format(', '.join(['?'] * len(user_ids)))

From b0950abdd9baf8cfa4edd7549e85401e48529fc1 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 11 Apr 2022 15:26:25 -0700
Subject: [PATCH 061/743] v2.9.7

---
 CHANGELOG.md      | 6 ++++++
 plexpy/version.py | 2 +-
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 4c8ba49a..9c8c3c69 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,11 @@
 # Changelog
 
+## v2.9.7 (2022-04-11)
+
+* UI:
+  * Fix: Managed user missing the username in the Users table. 
+
+
 ## v2.9.6 (2022-04-10)
 
 * Activity:
diff --git a/plexpy/version.py b/plexpy/version.py
index 88024d9c..db1a06eb 100644
--- a/plexpy/version.py
+++ b/plexpy/version.py
@@ -18,4 +18,4 @@
 from __future__ import unicode_literals
 
 PLEXPY_BRANCH = "master"
-PLEXPY_RELEASE_VERSION = "v2.9.6"
+PLEXPY_RELEASE_VERSION = "v2.9.7"

From d4002b2e2ba0b91675619b608f05d8f782784b00 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 12 Apr 2022 12:43:12 -0700
Subject: [PATCH 062/743] Change values to int instead of "Checked" in users
 and libraries table

* get_users_table: allow_guest, do_notify, keep_history
* get_libraries_table: do_notify, do_notify_created, keep_history
---
 data/interfaces/default/js/tables/libraries.js |  2 +-
 data/interfaces/default/js/tables/users.js     |  4 ++--
 plexpy/libraries.py                            |  6 +++---
 plexpy/users.py                                |  6 +++---
 plexpy/webserve.py                             | 12 ++++++------
 5 files changed, 15 insertions(+), 15 deletions(-)

diff --git a/data/interfaces/default/js/tables/libraries.js b/data/interfaces/default/js/tables/libraries.js
index a7e703a2..b3e702a0 100644
--- a/data/interfaces/default/js/tables/libraries.js
+++ b/data/interfaces/default/js/tables/libraries.js
@@ -33,7 +33,7 @@ libraries_list_table_options = {
                 $(td).html('<div class="edit-library-toggles">' +
                     '<button class="btn btn-xs btn-warning delete-library" data-id="' + rowData['row_id'] + '" data-toggle="button"><i class="fa fa-trash-o fa-fw"></i> Delete</button>&nbsp' +
                     '<button class="btn btn-xs btn-warning purge-library" data-id="' + rowData['row_id'] + '" data-toggle="button"><i class="fa fa-eraser fa-fw"></i> Purge</button>&nbsp&nbsp&nbsp' +
-                    '<input type="checkbox" id="keep_history-' + rowData['section_id'] + '" name="keep_history" value="1" ' + rowData['keep_history'] + '><label class="edit-tooltip" for="keep_history-' + rowData['section_id'] + '" data-toggle="tooltip" title="Toggle History"><i class="fa fa-history fa-lg fa-fw"></i></label>&nbsp' +
+                    '<input type="checkbox" id="keep_history-' + rowData['section_id'] + '" name="keep_history" value="1" ' + (rowData['keep_history'] ? 'checked' : '') + '><label class="edit-tooltip" for="keep_history-' + rowData['section_id'] + '" data-toggle="tooltip" title="Toggle History"><i class="fa fa-history fa-lg fa-fw"></i></label>&nbsp' +
                     '</div>');
             },
             "width": "7%",
diff --git a/data/interfaces/default/js/tables/users.js b/data/interfaces/default/js/tables/users.js
index 1b0793c8..524ee09a 100644
--- a/data/interfaces/default/js/tables/users.js
+++ b/data/interfaces/default/js/tables/users.js
@@ -50,8 +50,8 @@ users_list_table_options = {
                 $(td).html('<div class="edit-user-toggles">' + 
                     '<button class="btn btn-xs btn-warning delete-user" data-id="' + rowData['row_id'] + '" data-toggle="button"><i class="fa fa-trash-o fa-fw"></i> Delete</button>&nbsp' +
                     '<button class="btn btn-xs btn-warning purge-user" data-id="' + rowData['row_id'] + '" data-toggle="button"><i class="fa fa-eraser fa-fw"></i> Purge</button>&nbsp&nbsp&nbsp' +
-                    '<input type="checkbox" id="keep_history-' + rowData['user_id'] + '" name="keep_history" value="1" ' + rowData['keep_history'] + '><label class="edit-tooltip" for="keep_history-' + rowData['user_id'] + '" data-toggle="tooltip" title="Toggle History"><i class="fa fa-history fa-lg fa-fw"></i></label>&nbsp' +
-                    '<input type="checkbox" id="allow_guest-' + rowData['user_id'] + '" name="allow_guest" value="1" ' + rowData['allow_guest'] + '><label class="edit-tooltip" for="allow_guest-' + rowData['user_id'] + '" data-toggle="tooltip" title="Toggle Guest Access"><i class="fa fa-unlock-alt fa-lg fa-fw"></i></label>&nbsp' +
+                    '<input type="checkbox" id="keep_history-' + rowData['user_id'] + '" name="keep_history" value="1" ' + (rowData['keep_history'] ? 'checked' : '') + '><label class="edit-tooltip" for="keep_history-' + rowData['user_id'] + '" data-toggle="tooltip" title="Toggle History"><i class="fa fa-history fa-lg fa-fw"></i></label>&nbsp' +
+                    '<input type="checkbox" id="allow_guest-' + rowData['user_id'] + '" name="allow_guest" value="1" ' + (rowData['allow_guest'] ? 'checked' : '') + '><label class="edit-tooltip" for="allow_guest-' + rowData['user_id'] + '" data-toggle="tooltip" title="Toggle Guest Access"><i class="fa fa-unlock-alt fa-lg fa-fw"></i></label>&nbsp' +
                     '</div>');
             },
             "width": "7%",
diff --git a/plexpy/libraries.py b/plexpy/libraries.py
index 011f8201..0b0f16bb 100644
--- a/plexpy/libraries.py
+++ b/plexpy/libraries.py
@@ -432,9 +432,9 @@ class Libraries(object):
                    'live': item['live'],
                    'originally_available_at': item['originally_available_at'],
                    'guid': item['guid'],
-                   'do_notify': helpers.checked(item['do_notify']),
-                   'do_notify_created': helpers.checked(item['do_notify_created']),
-                   'keep_history': helpers.checked(item['keep_history']),
+                   'do_notify': item['do_notify'],
+                   'do_notify_created': item['do_notify_created'],
+                   'keep_history': item['keep_history'],
                    'is_active': item['is_active']
                    }
 
diff --git a/plexpy/users.py b/plexpy/users.py
index b7f467e2..a0095573 100644
--- a/plexpy/users.py
+++ b/plexpy/users.py
@@ -234,9 +234,9 @@ class Users(object):
                    'originally_available_at': item['originally_available_at'],
                    'guid': item['guid'],
                    'transcode_decision': item['transcode_decision'],
-                   'do_notify': helpers.checked(item['do_notify']),
-                   'keep_history': helpers.checked(item['keep_history']),
-                   'allow_guest': helpers.checked(item['allow_guest']),
+                   'do_notify': item['do_notify'],
+                   'keep_history': item['keep_history'],
+                   'allow_guest': item['allow_guest'],
                    'is_active': item['is_active']
                    }
 
diff --git a/plexpy/webserve.py b/plexpy/webserve.py
index ecf42b47..7e386af4 100644
--- a/plexpy/webserve.py
+++ b/plexpy/webserve.py
@@ -495,13 +495,13 @@ class WebInterface(object):
                         [{"child_count": 3745,
                           "content_rating": "TV-MA",
                           "count": 62,
-                          "do_notify": "Checked",
-                          "do_notify_created": "Checked",
+                          "do_notify": 1,
+                          "do_notify_created": 1,
                           "duration": 1578037,
                           "guid": "com.plexapp.agents.thetvdb://121361/6/1?lang=en",
                           "histroy_row_id": 1128,
                           "is_active": 1,
-                          "keep_history": "Checked",
+                          "keep_history": 1,
                           "labels": [],
                           "last_accessed": 1462693216,
                           "last_played": "Game of Thrones - The Red Woman",
@@ -1264,8 +1264,8 @@ class WebInterface(object):
                      "recordsTotal": 10,
                      "recordsFiltered": 10,
                      "data":
-                        [{"allow_guest": "Checked",
-                          "do_notify": "Checked",
+                        [{"allow_guest": 1,
+                          "do_notify": 1,
                           "duration": 2998290,
                           "friendly_name": "Jon Snow",
                           "username": "LordCommanderSnow",
@@ -1275,7 +1275,7 @@ class WebInterface(object):
                           "history_row_id": 1121,
                           "ip_address": "xxx.xxx.xxx.xxx",
                           "is_active": 1,
-                          "keep_history": "Checked",
+                          "keep_history": 1,
                           "last_played": "Game of Thrones - The Red Woman",
                           "last_seen": 1462591869,
                           "live": 0,

From ab24116b1b6b3e32979ad1ab9c08f3c21c47e1c7 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 12 Apr 2022 13:28:13 -0700
Subject: [PATCH 063/743] Fix get_users_table API docs

---
 plexpy/webserve.py | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/plexpy/webserve.py b/plexpy/webserve.py
index 7e386af4..925bf49b 100644
--- a/plexpy/webserve.py
+++ b/plexpy/webserve.py
@@ -1267,10 +1267,8 @@ class WebInterface(object):
                         [{"allow_guest": 1,
                           "do_notify": 1,
                           "duration": 2998290,
-                          "friendly_name": "Jon Snow",
-                          "username": "LordCommanderSnow",
-                          "title": "Jon Snow",
                           "email": "Jon.Snow.1337@CastleBlack.com",
+                          "friendly_name": "Jon Snow",
                           "guid": "com.plexapp.agents.thetvdb://121361/6/1?lang=en",
                           "history_row_id": 1121,
                           "ip_address": "xxx.xxx.xxx.xxx",
@@ -1290,6 +1288,7 @@ class WebInterface(object):
                           "rating_key": 153037,
                           "row_id": 1,
                           "thumb": "/library/metadata/153036/thumb/1462175062",
+                          "title": "Jon Snow",
                           "transcode_decision": "transcode",
                           "user_id": 133788,
                           "user_thumb": "https://plex.tv/users/568gwwoib5t98a3a/avatar",

From addf9ea3246a518ea416cfcd666326c6da0b8958 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 12 Apr 2022 18:38:36 -0700
Subject: [PATCH 064/743] Update jaraco.classes==3.2.1

[skip ci]
---
 lib/jaraco/classes/__init__.py | 0
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 lib/jaraco/classes/__init__.py

diff --git a/lib/jaraco/classes/__init__.py b/lib/jaraco/classes/__init__.py
new file mode 100644
index 00000000..e69de29b

From 3e8ef3c1b40f6d996dc5f051c81d8c8a4f9346f5 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 12 Apr 2022 18:38:55 -0700
Subject: [PATCH 065/743] Update jaraco.collections==3.5.1

[skip ci]
---
 lib/jaraco/collections.py | 21 +++++++++++++++++----
 1 file changed, 17 insertions(+), 4 deletions(-)

diff --git a/lib/jaraco/collections.py b/lib/jaraco/collections.py
index cfbb7c0a..8323db78 100644
--- a/lib/jaraco/collections.py
+++ b/lib/jaraco/collections.py
@@ -573,12 +573,16 @@ class DictStack(list, collections.abc.Mapping):
     2
     >>> stack['c']
     2
+    >>> len(stack)
+    3
     >>> stack.push(dict(a=3))
     >>> stack['a']
     3
     >>> set(stack.keys()) == set(['a', 'b', 'c'])
     True
-    >>> dict(**stack) == dict(a=3, c=2, b=2)
+    >>> set(stack.items()) == set([('a', 3), ('b', 2), ('c', 2)])
+    True
+    >>> dict(**stack) == dict(stack) == dict(a=3, c=2, b=2)
     True
     >>> d = stack.pop()
     >>> stack['a']
@@ -587,19 +591,28 @@ class DictStack(list, collections.abc.Mapping):
     >>> stack['a']
     1
     >>> stack.get('b', None)
+    >>> 'c' in stack
+    True
     """
 
-    def keys(self):
-        return list(set(itertools.chain.from_iterable(c.keys() for c in self)))
+    def __iter__(self):
+        dicts = list.__iter__(self)
+        return iter(set(itertools.chain.from_iterable(c.keys() for c in dicts)))
 
     def __getitem__(self, key):
-        for scope in reversed(self):
+        for scope in reversed(tuple(list.__iter__(self))):
             if key in scope:
                 return scope[key]
         raise KeyError(key)
 
     push = list.append
 
+    def __contains__(self, other):
+        return collections.abc.Mapping.__contains__(self, other)
+
+    def __len__(self):
+        return len(list(iter(self)))
+
 
 class BijectiveMap(dict):
     """

From d5afac41045677b29a028d05d51e1d430deca3d9 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 12 Apr 2022 18:39:16 -0700
Subject: [PATCH 066/743] Add jaraco.context==4.1.1

[skip ci]
---
 lib/jaraco/context.py | 213 ++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 213 insertions(+)
 create mode 100644 lib/jaraco/context.py

diff --git a/lib/jaraco/context.py b/lib/jaraco/context.py
new file mode 100644
index 00000000..87a4e3dc
--- /dev/null
+++ b/lib/jaraco/context.py
@@ -0,0 +1,213 @@
+import os
+import subprocess
+import contextlib
+import functools
+import tempfile
+import shutil
+import operator
+
+
+@contextlib.contextmanager
+def pushd(dir):
+    orig = os.getcwd()
+    os.chdir(dir)
+    try:
+        yield dir
+    finally:
+        os.chdir(orig)
+
+
+@contextlib.contextmanager
+def tarball_context(url, target_dir=None, runner=None, pushd=pushd):
+    """
+    Get a tarball, extract it, change to that directory, yield, then
+    clean up.
+    `runner` is the function to invoke commands.
+    `pushd` is a context manager for changing the directory.
+    """
+    if target_dir is None:
+        target_dir = os.path.basename(url).replace('.tar.gz', '').replace('.tgz', '')
+    if runner is None:
+        runner = functools.partial(subprocess.check_call, shell=True)
+    # In the tar command, use --strip-components=1 to strip the first path and
+    #  then
+    #  use -C to cause the files to be extracted to {target_dir}. This ensures
+    #  that we always know where the files were extracted.
+    runner('mkdir {target_dir}'.format(**vars()))
+    try:
+        getter = 'wget {url} -O -'
+        extract = 'tar x{compression} --strip-components=1 -C {target_dir}'
+        cmd = ' | '.join((getter, extract))
+        runner(cmd.format(compression=infer_compression(url), **vars()))
+        with pushd(target_dir):
+            yield target_dir
+    finally:
+        runner('rm -Rf {target_dir}'.format(**vars()))
+
+
+def infer_compression(url):
+    """
+    Given a URL or filename, infer the compression code for tar.
+    """
+    # cheat and just assume it's the last two characters
+    compression_indicator = url[-2:]
+    mapping = dict(gz='z', bz='j', xz='J')
+    # Assume 'z' (gzip) if no match
+    return mapping.get(compression_indicator, 'z')
+
+
+@contextlib.contextmanager
+def temp_dir(remover=shutil.rmtree):
+    """
+    Create a temporary directory context. Pass a custom remover
+    to override the removal behavior.
+    """
+    temp_dir = tempfile.mkdtemp()
+    try:
+        yield temp_dir
+    finally:
+        remover(temp_dir)
+
+
+@contextlib.contextmanager
+def repo_context(url, branch=None, quiet=True, dest_ctx=temp_dir):
+    """
+    Check out the repo indicated by url.
+
+    If dest_ctx is supplied, it should be a context manager
+    to yield the target directory for the check out.
+    """
+    exe = 'git' if 'git' in url else 'hg'
+    with dest_ctx() as repo_dir:
+        cmd = [exe, 'clone', url, repo_dir]
+        if branch:
+            cmd.extend(['--branch', branch])
+        devnull = open(os.path.devnull, 'w')
+        stdout = devnull if quiet else None
+        subprocess.check_call(cmd, stdout=stdout)
+        yield repo_dir
+
+
+@contextlib.contextmanager
+def null():
+    yield
+
+
+class ExceptionTrap:
+    """
+    A context manager that will catch certain exceptions and provide an
+    indication they occurred.
+
+    >>> with ExceptionTrap() as trap:
+    ...     raise Exception()
+    >>> bool(trap)
+    True
+
+    >>> with ExceptionTrap() as trap:
+    ...     pass
+    >>> bool(trap)
+    False
+
+    >>> with ExceptionTrap(ValueError) as trap:
+    ...     raise ValueError("1 + 1 is not 3")
+    >>> bool(trap)
+    True
+
+    >>> with ExceptionTrap(ValueError) as trap:
+    ...     raise Exception()
+    Traceback (most recent call last):
+    ...
+    Exception
+
+    >>> bool(trap)
+    False
+    """
+
+    exc_info = None, None, None
+
+    def __init__(self, exceptions=(Exception,)):
+        self.exceptions = exceptions
+
+    def __enter__(self):
+        return self
+
+    @property
+    def type(self):
+        return self.exc_info[0]
+
+    @property
+    def value(self):
+        return self.exc_info[1]
+
+    @property
+    def tb(self):
+        return self.exc_info[2]
+
+    def __exit__(self, *exc_info):
+        type = exc_info[0]
+        matches = type and issubclass(type, self.exceptions)
+        if matches:
+            self.exc_info = exc_info
+        return matches
+
+    def __bool__(self):
+        return bool(self.type)
+
+    def raises(self, func, *, _test=bool):
+        """
+        Wrap func and replace the result with the truth
+        value of the trap (True if an exception occurred).
+
+        First, give the decorator an alias to support Python 3.8
+        Syntax.
+
+        >>> raises = ExceptionTrap(ValueError).raises
+
+        Now decorate a function that always fails.
+
+        >>> @raises
+        ... def fail():
+        ...     raise ValueError('failed')
+        >>> fail()
+        True
+        """
+
+        @functools.wraps(func)
+        def wrapper(*args, **kwargs):
+            with ExceptionTrap(self.exceptions) as trap:
+                func(*args, **kwargs)
+            return _test(trap)
+
+        return wrapper
+
+    def passes(self, func):
+        """
+        Wrap func and replace the result with the truth
+        value of the trap (True if no exception).
+
+        First, give the decorator an alias to support Python 3.8
+        Syntax.
+
+        >>> passes = ExceptionTrap(ValueError).passes
+
+        Now decorate a function that always fails.
+
+        >>> @passes
+        ... def fail():
+        ...     raise ValueError('failed')
+
+        >>> fail()
+        False
+        """
+        return self.raises(func, _test=operator.not_)
+
+
+class suppress(contextlib.suppress, contextlib.ContextDecorator):
+    """
+    A version of contextlib.suppress with decorator support.
+
+    >>> @suppress(KeyError)
+    ... def key_error():
+    ...     {}['']
+    >>> key_error()
+    """

From c54c811eec967e127b3e5eed980ca6e304541629 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 12 Apr 2022 18:39:30 -0700
Subject: [PATCH 067/743] Update jaraco.text==3.7.0

[skip ci]
---
 lib/jaraco/text/__init__.py | 105 ++++++++++++++++++++++++++++++------
 1 file changed, 88 insertions(+), 17 deletions(-)

diff --git a/lib/jaraco/text/__init__.py b/lib/jaraco/text/__init__.py
index 95e20b40..5f75519a 100644
--- a/lib/jaraco/text/__init__.py
+++ b/lib/jaraco/text/__init__.py
@@ -4,11 +4,12 @@ import textwrap
 import functools
 
 try:
-    from importlib import resources  # type: ignore
+    from importlib.resources import files  # type: ignore
 except ImportError:  # pragma: nocover
-    import importlib_resources as resources  # type: ignore
+    from importlib_resources import files  # type: ignore
 
 from jaraco.functools import compose, method_cache
+from jaraco.context import ExceptionTrap
 
 
 def substitution(old, new):
@@ -109,7 +110,7 @@ class FoldedCase(str):
         return hash(self.lower())
 
     def __contains__(self, other):
-        return super(FoldedCase, self).lower().__contains__(other.lower())
+        return super().lower().__contains__(other.lower())
 
     def in_(self, other):
         "Does self appear in other?"
@@ -118,7 +119,7 @@ class FoldedCase(str):
     # cache lower since it's likely to be called frequently.
     @method_cache
     def lower(self):
-        return super(FoldedCase, self).lower()
+        return super().lower()
 
     def index(self, sub):
         return self.lower().index(sub.lower())
@@ -128,6 +129,11 @@ class FoldedCase(str):
         return pattern.split(self, maxsplit)
 
 
+# Python 3.8 compatibility
+_unicode_trap = ExceptionTrap(UnicodeDecodeError)
+
+
+@_unicode_trap.passes
 def is_decodable(value):
     r"""
     Return True if the supplied value is decodable (using the default
@@ -138,14 +144,7 @@ def is_decodable(value):
     >>> is_decodable(b'\x32')
     True
     """
-    # TODO: This code could be expressed more consisely and directly
-    # with a jaraco.context.ExceptionTrap, but that adds an unfortunate
-    # long dependency tree, so for now, use boolean literals.
-    try:
-        value.decode()
-    except UnicodeDecodeError:
-        return False
-    return True
+    value.decode()
 
 
 def is_binary(value):
@@ -225,7 +224,7 @@ def unwrap(s):
     return '\n'.join(cleaned)
 
 
-lorem_ipsum = resources.read_text(__name__, 'Lorem ipsum.txt')  # type: ignore
+lorem_ipsum: str = files(__name__).joinpath('Lorem ipsum.txt').read_text()
 
 
 class Splitter(object):
@@ -370,10 +369,6 @@ class WordSet(tuple):
             result = WordSet(result)
         return result
 
-    # for compatibility with Python 2
-    def __getslice__(self, i, j):  # pragma: nocover
-        return self.__getitem__(slice(i, j))
-
     @classmethod
     def parse(cls, identifier):
         matches = cls._pattern.finditer(identifier)
@@ -527,3 +522,79 @@ def normalize_newlines(text):
     newlines = ['\r\n', '\r', '\n', '\u0085', '\u2028', '\u2029']
     pattern = '|'.join(newlines)
     return re.sub(pattern, '\n', text)
+
+
+def _nonblank(str):
+    return str and not str.startswith('#')
+
+
+@functools.singledispatch
+def yield_lines(iterable):
+    r"""
+    Yield valid lines of a string or iterable.
+
+    >>> list(yield_lines(''))
+    []
+    >>> list(yield_lines(['foo', 'bar']))
+    ['foo', 'bar']
+    >>> list(yield_lines('foo\nbar'))
+    ['foo', 'bar']
+    >>> list(yield_lines('\nfoo\n#bar\nbaz #comment'))
+    ['foo', 'baz #comment']
+    >>> list(yield_lines(['foo\nbar', 'baz', 'bing\n\n\n']))
+    ['foo', 'bar', 'baz', 'bing']
+    """
+    return itertools.chain.from_iterable(map(yield_lines, iterable))
+
+
+@yield_lines.register(str)
+def _(text):
+    return filter(_nonblank, map(str.strip, text.splitlines()))
+
+
+def drop_comment(line):
+    """
+    Drop comments.
+
+    >>> drop_comment('foo # bar')
+    'foo'
+
+    A hash without a space may be in a URL.
+
+    >>> drop_comment('http://example.com/foo#bar')
+    'http://example.com/foo#bar'
+    """
+    return line.partition(' #')[0]
+
+
+def join_continuation(lines):
+    r"""
+    Join lines continued by a trailing backslash.
+
+    >>> list(join_continuation(['foo \\', 'bar', 'baz']))
+    ['foobar', 'baz']
+    >>> list(join_continuation(['foo \\', 'bar', 'baz']))
+    ['foobar', 'baz']
+    >>> list(join_continuation(['foo \\', 'bar \\', 'baz']))
+    ['foobarbaz']
+
+    Not sure why, but...
+    The character preceeding the backslash is also elided.
+
+    >>> list(join_continuation(['goo\\', 'dly']))
+    ['godly']
+
+    A terrible idea, but...
+    If no line is available to continue, suppress the lines.
+
+    >>> list(join_continuation(['foo', 'bar\\', 'baz\\']))
+    ['foo']
+    """
+    lines = iter(lines)
+    for item in lines:
+        while item.endswith('\\'):
+            try:
+                item = item[:-2].strip() + next(lines)
+            except StopIteration:
+                return
+        yield item

From fa52d99691e9c85a00f0d508b36deb92534449b6 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 12 Apr 2022 18:42:48 -0700
Subject: [PATCH 068/743] Bump importlib-resources from 5.4.0 to 5.6.0 (#1699)

* Bump importlib-resources from 5.4.0 to 5.6.0

Bumps [importlib-resources](https://github.com/python/importlib_resources) from 5.4.0 to 5.6.0.
- [Release notes](https://github.com/python/importlib_resources/releases)
- [Changelog](https://github.com/python/importlib_resources/blob/main/CHANGES.rst)
- [Commits](https://github.com/python/importlib_resources/compare/v5.4.0...v5.6.0)

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

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

* Update importlib-resources==5.6.0

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/importlib_resources/_compat.py           | 10 +++++++
 lib/importlib_resources/abc.py               | 28 +++++++++++---------
 lib/importlib_resources/tests/update-zips.py |  2 +-
 package/requirements-package.txt             |  2 +-
 requirements.txt                             |  2 +-
 5 files changed, 29 insertions(+), 15 deletions(-)

diff --git a/lib/importlib_resources/_compat.py b/lib/importlib_resources/_compat.py
index 61e48d47..8d7ade08 100644
--- a/lib/importlib_resources/_compat.py
+++ b/lib/importlib_resources/_compat.py
@@ -1,9 +1,12 @@
 # flake8: noqa
 
 import abc
+import os
 import sys
 import pathlib
 from contextlib import suppress
+from typing import Union
+
 
 if sys.version_info >= (3, 10):
     from zipfile import Path as ZipPath  # type: ignore
@@ -96,3 +99,10 @@ def wrap_spec(package):
     from . import _adapters
 
     return _adapters.SpecLoaderAdapter(package.__spec__, TraversableResourcesLoader)
+
+
+if sys.version_info >= (3, 9):
+    StrPath = Union[str, os.PathLike[str]]
+else:
+    # PathLike is only subscriptable at runtime in 3.9+
+    StrPath = Union[str, "os.PathLike[str]"]
diff --git a/lib/importlib_resources/abc.py b/lib/importlib_resources/abc.py
index d39dc1ad..a2b0af62 100644
--- a/lib/importlib_resources/abc.py
+++ b/lib/importlib_resources/abc.py
@@ -1,7 +1,11 @@
 import abc
-from typing import BinaryIO, Iterable, Text
+import io
+from typing import Any, BinaryIO, Iterable, Iterator, NoReturn, Text, Optional
 
-from ._compat import runtime_checkable, Protocol
+from ._compat import runtime_checkable, Protocol, StrPath
+
+
+__all__ = ["ResourceReader", "Traversable", "TraversableResources"]
 
 
 class ResourceReader(metaclass=abc.ABCMeta):
@@ -54,19 +58,19 @@ class Traversable(Protocol):
     """
 
     @abc.abstractmethod
-    def iterdir(self):
+    def iterdir(self) -> Iterator["Traversable"]:
         """
         Yield Traversable objects in self
         """
 
-    def read_bytes(self):
+    def read_bytes(self) -> bytes:
         """
         Read contents of self as bytes
         """
         with self.open('rb') as strm:
             return strm.read()
 
-    def read_text(self, encoding=None):
+    def read_text(self, encoding: Optional[str] = None) -> str:
         """
         Read contents of self as text
         """
@@ -86,12 +90,12 @@ class Traversable(Protocol):
         """
 
     @abc.abstractmethod
-    def joinpath(self, child):
+    def joinpath(self, child: StrPath) -> "Traversable":
         """
         Return Traversable child in self
         """
 
-    def __truediv__(self, child):
+    def __truediv__(self, child: StrPath) -> "Traversable":
         """
         Return Traversable child in self
         """
@@ -121,17 +125,17 @@ class TraversableResources(ResourceReader):
     """
 
     @abc.abstractmethod
-    def files(self):
+    def files(self) -> "Traversable":
         """Return a Traversable object for the loaded package."""
 
-    def open_resource(self, resource):
+    def open_resource(self, resource: StrPath) -> io.BufferedReader:
         return self.files().joinpath(resource).open('rb')
 
-    def resource_path(self, resource):
+    def resource_path(self, resource: Any) -> NoReturn:
         raise FileNotFoundError(resource)
 
-    def is_resource(self, path):
+    def is_resource(self, path: StrPath) -> bool:
         return self.files().joinpath(path).is_file()
 
-    def contents(self):
+    def contents(self) -> Iterator[str]:
         return (item.name for item in self.files().iterdir())
diff --git a/lib/importlib_resources/tests/update-zips.py b/lib/importlib_resources/tests/update-zips.py
index 9ef0224c..231334aa 100644
--- a/lib/importlib_resources/tests/update-zips.py
+++ b/lib/importlib_resources/tests/update-zips.py
@@ -42,7 +42,7 @@ def generate(suffix):
 
 def walk(datapath):
     for dirpath, dirnames, filenames in os.walk(datapath):
-        with contextlib.suppress(KeyError):
+        with contextlib.suppress(ValueError):
             dirnames.remove('__pycache__')
         for filename in filenames:
             res = pathlib.Path(dirpath) / filename
diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index 0a291e78..c7d7245e 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -1,5 +1,5 @@
 apscheduler==3.8.0
-importlib-resources==5.4.0
+importlib-resources==5.6.0
 pyinstaller==4.9
 pyopenssl==22.0.0
 pycryptodomex==3.14.1
diff --git a/requirements.txt b/requirements.txt
index 9c3cc11a..c4fe538f 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -18,7 +18,7 @@ gntp==1.0.3
 html5lib==1.1
 httpagentparser==1.9.2
 idna==3.3
-importlib-resources==5.4.0
+importlib-resources==5.6.0
 git+https://github.com/Tautulli/ipwhois.git@master#egg=ipwhois
 IPy==1.01
 Mako==1.1.6

From dd59a79005fe0e5e2e6592074503af319374fa62 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 12 Apr 2022 18:42:59 -0700
Subject: [PATCH 069/743] Bump zipp from 3.7.0 to 3.8.0 (#1706)

* Bump zipp from 3.7.0 to 3.8.0

Bumps [zipp](https://github.com/jaraco/zipp) from 3.7.0 to 3.8.0.
- [Release notes](https://github.com/jaraco/zipp/releases)
- [Changelog](https://github.com/jaraco/zipp/blob/main/CHANGES.rst)
- [Commits](https://github.com/jaraco/zipp/compare/v3.7.0...v3.8.0)

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

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

* Update zipp==3.8.0

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/zipp.py      | 23 +++--------------------
 requirements.txt |  2 +-
 2 files changed, 4 insertions(+), 21 deletions(-)

diff --git a/lib/zipp.py b/lib/zipp.py
index 26b723c1..52c82a0e 100644
--- a/lib/zipp.py
+++ b/lib/zipp.py
@@ -3,14 +3,8 @@ import posixpath
 import zipfile
 import itertools
 import contextlib
-import sys
 import pathlib
 
-if sys.version_info < (3, 7):
-    from collections import OrderedDict
-else:
-    OrderedDict = dict
-
 
 __all__ = ['Path']
 
@@ -56,7 +50,7 @@ def _ancestry(path):
         path, tail = posixpath.split(path)
 
 
-_dedupe = OrderedDict.fromkeys
+_dedupe = dict.fromkeys
 """Deduplicate an iterable in original order"""
 
 
@@ -107,7 +101,7 @@ class CompleteDirs(zipfile.ZipFile):
             return source
 
         if not isinstance(source, zipfile.ZipFile):
-            return cls(_pathlib_compat(source))
+            return cls(source)
 
         # Only allow for FastLookup when supplied zipfile is read-only
         if 'r' not in source.mode:
@@ -136,17 +130,6 @@ class FastLookup(CompleteDirs):
         return self.__lookup
 
 
-def _pathlib_compat(path):
-    """
-    For path-like objects, convert to a filename for compatibility
-    on Python 3.6.1 and earlier.
-    """
-    try:
-        return path.__fspath__()
-    except AttributeError:
-        return str(path)
-
-
 class Path:
     """
     A pathlib-compatible interface for zip files.
@@ -314,7 +297,7 @@ class Path:
         return self.__repr.format(self=self)
 
     def joinpath(self, *other):
-        next = posixpath.join(self.at, *map(_pathlib_compat, other))
+        next = posixpath.join(self.at, *other)
         return self._next(self.root.resolve_dir(next))
 
     __truediv__ = joinpath
diff --git a/requirements.txt b/requirements.txt
index c4fe538f..0810ddc5 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -48,7 +48,7 @@ urllib3==1.26.8
 webencodings==0.5.1
 websocket-client==1.2.3
 xmltodict==0.12.0
-zipp==3.7.0
+zipp==3.8.0
 
 # configobj==5.1.0
 # sgmllib3k==1.0.0

From 1371cfa889dad3c5fbe2f16fcd852403d416d838 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 14 Apr 2022 20:54:07 -0700
Subject: [PATCH 070/743] Trigger on_stop notification after successful db
 write

* Prevent race condition from querying the db using the notification trigger
---
 plexpy/activity_handler.py | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/plexpy/activity_handler.py b/plexpy/activity_handler.py
index a45a2cd4..07d0f8e3 100644
--- a/plexpy/activity_handler.py
+++ b/plexpy/activity_handler.py
@@ -164,13 +164,13 @@ class ActivityHandler(object):
             # Retrieve the session data from our temp table
             db_session = ap.get_session_by_key(session_key=self.get_session_key())
 
-            plexpy.NOTIFY_QUEUE.put({'stream_data': db_session.copy(), 'notify_action': 'on_stop'})
-
             # Write it to the history table
             monitor_proc = activity_processor.ActivityProcessor()
             row_id = monitor_proc.write_session_history(session=db_session)
 
             if row_id:
+                plexpy.NOTIFY_QUEUE.put({'stream_data': db_session.copy(), 'notify_action': 'on_stop'})
+
                 schedule_callback('session_key-{}'.format(self.get_session_key()), remove_job=True)
 
                 # Remove the session from our temp session table
@@ -604,6 +604,8 @@ def force_stop_stream(session_key, title, user):
     row_id = ap.write_session_history(session=session)
 
     if row_id:
+        plexpy.NOTIFY_QUEUE.put({'stream_data': session.copy(), 'notify_action': 'on_stop'})
+
         # If session is written to the database successfully, remove the session from the session table
         logger.info("Tautulli ActivityHandler :: Removing stale stream with sessionKey %s ratingKey %s from session queue"
                     % (session['session_key'], session['rating_key']))

From df54df5e65ac6c2f133bd3ee15bc575bb46d64d6 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 26 Apr 2022 11:02:07 -0700
Subject: [PATCH 071/743] Set PlexAPI log level to debug

---
 plexpy/__init__.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/plexpy/__init__.py b/plexpy/__init__.py
index a7313b49..de453c0a 100644
--- a/plexpy/__init__.py
+++ b/plexpy/__init__.py
@@ -1,4 +1,4 @@
-# This file is part of Tautulli.
+# This file is part of Tautulli.
 #
 #  Tautulli is free software: you can redistribute it and/or modify
 #  it under the terms of the GNU General Public License as published by
@@ -217,6 +217,7 @@ def initialize(config_file):
         if not PYTHON2:
             os.environ['PLEXAPI_CONFIG_PATH'] = os.path.join(DATA_DIR, 'plexapi.config.ini')
             os.environ['PLEXAPI_LOG_PATH'] = os.path.join(CONFIG.LOG_DIR, 'plexapi.log')
+            os.environ['PLEXAPI_LOG_LEVEL'] = 'DEBUG'
             plex.initialize_plexapi()
 
         if DOCKER:

From 1f7ddd4d0193c3097b4422880f0a985722fa3505 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 12 May 2022 13:08:29 -0700
Subject: [PATCH 072/743] Disable PlexAPI auto-reloading when fetching
 collections/playlists

---
 plexpy/libraries.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/plexpy/libraries.py b/plexpy/libraries.py
index 0b0f16bb..8a51eec1 100644
--- a/plexpy/libraries.py
+++ b/plexpy/libraries.py
@@ -155,6 +155,8 @@ def get_collections(section_id=None):
 
     collections_list = []
     for collection in collections:
+        collection._autoReload = False
+
         collection_mode = collection.collectionMode
         if collection_mode is None:
             collection_mode = -1
@@ -254,6 +256,8 @@ def get_playlists(section_id=None, user_id=None):
 
     playlists_list = []
     for playlist in playlists:
+        playlist._autoReload = False
+
         playlist_dict = {
             'addedAt': helpers.datetime_to_iso(playlist.addedAt),
             'composite': playlist.composite,

From f08687b960b2e0f302655c50268cc2f54b6d207d Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 12 May 2022 13:10:57 -0700
Subject: [PATCH 073/743] Fix Dolby Vision detection

* Plex renamed "Dolby Vision" to "DoVi" in the display title.
---
 plexpy/pmsconnect.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/plexpy/pmsconnect.py b/plexpy/pmsconnect.py
index a993f6af..de1f88ef 100644
--- a/plexpy/pmsconnect.py
+++ b/plexpy/pmsconnect.py
@@ -3187,7 +3187,7 @@ class PmsConnect(object):
 
         # HDR details got introduced with PMS version 1.25.6.5545
         if helpers.version_to_tuple(plexpy.CONFIG.PMS_VERSION) >= helpers.version_to_tuple('1.25.6.5545'):
-            if 'Dolby Vision' in extended_display_title:
+            if 'Dolby Vision' in extended_display_title or 'DoVi' in extended_display_title:
                 video_dynamic_range.append('Dolby Vision')
             if 'HLG' in extended_display_title:
                 video_dynamic_range.append('HLG')

From 942e09e59eea782525057c65428d34701093c67e Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 16 May 2022 20:32:27 -0700
Subject: [PATCH 074/743] Bump distro from 1.6.0 to 1.7.0 (#1658)

* Bump distro from 1.6.0 to 1.7.0

Bumps [distro](https://github.com/python-distro/distro) from 1.6.0 to 1.7.0.
- [Release notes](https://github.com/python-distro/distro/releases)
- [Changelog](https://github.com/python-distro/distro/blob/master/CHANGELOG.md)
- [Commits](https://github.com/python-distro/distro/compare/v1.6.0...v1.7.0)

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

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

* Update distro==1.7.0

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/distro/__init__.py |   54 ++
 lib/distro/__main__.py |    4 +
 lib/distro/distro.py   | 1374 ++++++++++++++++++++++++++++++++++++++++
 lib/distro/py.typed    |    0
 requirements.txt       |    2 +-
 5 files changed, 1433 insertions(+), 1 deletion(-)
 create mode 100644 lib/distro/__init__.py
 create mode 100644 lib/distro/__main__.py
 create mode 100644 lib/distro/distro.py
 create mode 100644 lib/distro/py.typed

diff --git a/lib/distro/__init__.py b/lib/distro/__init__.py
new file mode 100644
index 00000000..7686fe85
--- /dev/null
+++ b/lib/distro/__init__.py
@@ -0,0 +1,54 @@
+from .distro import (
+    NORMALIZED_DISTRO_ID,
+    NORMALIZED_LSB_ID,
+    NORMALIZED_OS_ID,
+    LinuxDistribution,
+    __version__,
+    build_number,
+    codename,
+    distro_release_attr,
+    distro_release_info,
+    id,
+    info,
+    like,
+    linux_distribution,
+    lsb_release_attr,
+    lsb_release_info,
+    major_version,
+    minor_version,
+    name,
+    os_release_attr,
+    os_release_info,
+    uname_attr,
+    uname_info,
+    version,
+    version_parts,
+)
+
+__all__ = [
+    "NORMALIZED_DISTRO_ID",
+    "NORMALIZED_LSB_ID",
+    "NORMALIZED_OS_ID",
+    "LinuxDistribution",
+    "build_number",
+    "codename",
+    "distro_release_attr",
+    "distro_release_info",
+    "id",
+    "info",
+    "like",
+    "linux_distribution",
+    "lsb_release_attr",
+    "lsb_release_info",
+    "major_version",
+    "minor_version",
+    "name",
+    "os_release_attr",
+    "os_release_info",
+    "uname_attr",
+    "uname_info",
+    "version",
+    "version_parts",
+]
+
+__version__ = __version__
diff --git a/lib/distro/__main__.py b/lib/distro/__main__.py
new file mode 100644
index 00000000..0c01d5b0
--- /dev/null
+++ b/lib/distro/__main__.py
@@ -0,0 +1,4 @@
+from .distro import main
+
+if __name__ == "__main__":
+    main()
diff --git a/lib/distro/distro.py b/lib/distro/distro.py
new file mode 100644
index 00000000..49066ae8
--- /dev/null
+++ b/lib/distro/distro.py
@@ -0,0 +1,1374 @@
+#!/usr/bin/env python
+# Copyright 2015,2016,2017 Nir Cohen
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""
+The ``distro`` package (``distro`` stands for Linux Distribution) provides
+information about the Linux distribution it runs on, such as a reliable
+machine-readable distro ID, or version information.
+
+It is the recommended replacement for Python's original
+:py:func:`platform.linux_distribution` function, but it provides much more
+functionality. An alternative implementation became necessary because Python
+3.5 deprecated this function, and Python 3.8 removed it altogether. Its
+predecessor function :py:func:`platform.dist` was already deprecated since
+Python 2.6 and removed in Python 3.8. Still, there are many cases in which
+access to OS distribution information is needed. See `Python issue 1322
+<https://bugs.python.org/issue1322>`_ for more information.
+"""
+
+import argparse
+import json
+import logging
+import os
+import re
+import shlex
+import subprocess
+import sys
+import warnings
+from typing import (
+    Any,
+    Callable,
+    Dict,
+    Iterable,
+    Optional,
+    Sequence,
+    TextIO,
+    Tuple,
+    Type,
+)
+
+try:
+    from typing import TypedDict
+except ImportError:
+    # Python 3.7
+    TypedDict = dict
+
+__version__ = "1.7.0"
+
+
+class VersionDict(TypedDict):
+    major: str
+    minor: str
+    build_number: str
+
+
+class InfoDict(TypedDict):
+    id: str
+    version: str
+    version_parts: VersionDict
+    like: str
+    codename: str
+
+
+_UNIXCONFDIR = os.environ.get("UNIXCONFDIR", "/etc")
+_UNIXUSRLIBDIR = os.environ.get("UNIXUSRLIBDIR", "/usr/lib")
+_OS_RELEASE_BASENAME = "os-release"
+
+#: Translation table for normalizing the "ID" attribute defined in os-release
+#: files, for use by the :func:`distro.id` method.
+#:
+#: * Key: Value as defined in the os-release file, translated to lower case,
+#:   with blanks translated to underscores.
+#:
+#: * Value: Normalized value.
+NORMALIZED_OS_ID = {
+    "ol": "oracle",  # Oracle Linux
+    "opensuse-leap": "opensuse",  # Newer versions of OpenSuSE report as opensuse-leap
+}
+
+#: Translation table for normalizing the "Distributor ID" attribute returned by
+#: the lsb_release command, for use by the :func:`distro.id` method.
+#:
+#: * Key: Value as returned by the lsb_release command, translated to lower
+#:   case, with blanks translated to underscores.
+#:
+#: * Value: Normalized value.
+NORMALIZED_LSB_ID = {
+    "enterpriseenterpriseas": "oracle",  # Oracle Enterprise Linux 4
+    "enterpriseenterpriseserver": "oracle",  # Oracle Linux 5
+    "redhatenterpriseworkstation": "rhel",  # RHEL 6, 7 Workstation
+    "redhatenterpriseserver": "rhel",  # RHEL 6, 7 Server
+    "redhatenterprisecomputenode": "rhel",  # RHEL 6 ComputeNode
+}
+
+#: Translation table for normalizing the distro ID derived from the file name
+#: of distro release files, for use by the :func:`distro.id` method.
+#:
+#: * Key: Value as derived from the file name of a distro release file,
+#:   translated to lower case, with blanks translated to underscores.
+#:
+#: * Value: Normalized value.
+NORMALIZED_DISTRO_ID = {
+    "redhat": "rhel",  # RHEL 6.x, 7.x
+}
+
+# Pattern for content of distro release file (reversed)
+_DISTRO_RELEASE_CONTENT_REVERSED_PATTERN = re.compile(
+    r"(?:[^)]*\)(.*)\()? *(?:STL )?([\d.+\-a-z]*\d) *(?:esaeler *)?(.+)"
+)
+
+# Pattern for base file name of distro release file
+_DISTRO_RELEASE_BASENAME_PATTERN = re.compile(r"(\w+)[-_](release|version)$")
+
+# Base file names to be ignored when searching for distro release file
+_DISTRO_RELEASE_IGNORE_BASENAMES = (
+    "debian_version",
+    "lsb-release",
+    "oem-release",
+    _OS_RELEASE_BASENAME,
+    "system-release",
+    "plesk-release",
+    "iredmail-release",
+)
+
+
+def linux_distribution(full_distribution_name: bool = True) -> Tuple[str, str, str]:
+    """
+    .. deprecated:: 1.6.0
+
+        :func:`distro.linux_distribution()` is deprecated. It should only be
+        used as a compatibility shim with Python's
+        :py:func:`platform.linux_distribution()`. Please use :func:`distro.id`,
+        :func:`distro.version` and :func:`distro.name` instead.
+
+    Return information about the current OS distribution as a tuple
+    ``(id_name, version, codename)`` with items as follows:
+
+    * ``id_name``:  If *full_distribution_name* is false, the result of
+      :func:`distro.id`. Otherwise, the result of :func:`distro.name`.
+
+    * ``version``:  The result of :func:`distro.version`.
+
+    * ``codename``:  The extra item (usually in parentheses) after the
+      os-release version number, or the result of :func:`distro.codename`.
+
+    The interface of this function is compatible with the original
+    :py:func:`platform.linux_distribution` function, supporting a subset of
+    its parameters.
+
+    The data it returns may not exactly be the same, because it uses more data
+    sources than the original function, and that may lead to different data if
+    the OS distribution is not consistent across multiple data sources it
+    provides (there are indeed such distributions ...).
+
+    Another reason for differences is the fact that the :func:`distro.id`
+    method normalizes the distro ID string to a reliable machine-readable value
+    for a number of popular OS distributions.
+    """
+    warnings.warn(
+        "distro.linux_distribution() is deprecated. It should only be used as a "
+        "compatibility shim with Python's platform.linux_distribution(). Please use "
+        "distro.id(), distro.version() and distro.name() instead.",
+        DeprecationWarning,
+        stacklevel=2,
+    )
+    return _distro.linux_distribution(full_distribution_name)
+
+
+def id() -> str:
+    """
+    Return the distro ID of the current distribution, as a
+    machine-readable string.
+
+    For a number of OS distributions, the returned distro ID value is
+    *reliable*, in the sense that it is documented and that it does not change
+    across releases of the distribution.
+
+    This package maintains the following reliable distro ID values:
+
+    ==============  =========================================
+    Distro ID       Distribution
+    ==============  =========================================
+    "ubuntu"        Ubuntu
+    "debian"        Debian
+    "rhel"          RedHat Enterprise Linux
+    "centos"        CentOS
+    "fedora"        Fedora
+    "sles"          SUSE Linux Enterprise Server
+    "opensuse"      openSUSE
+    "amzn"          Amazon Linux
+    "arch"          Arch Linux
+    "cloudlinux"    CloudLinux OS
+    "exherbo"       Exherbo Linux
+    "gentoo"        GenToo Linux
+    "ibm_powerkvm"  IBM PowerKVM
+    "kvmibm"        KVM for IBM z Systems
+    "linuxmint"     Linux Mint
+    "mageia"        Mageia
+    "mandriva"      Mandriva Linux
+    "parallels"     Parallels
+    "pidora"        Pidora
+    "raspbian"      Raspbian
+    "oracle"        Oracle Linux (and Oracle Enterprise Linux)
+    "scientific"    Scientific Linux
+    "slackware"     Slackware
+    "xenserver"     XenServer
+    "openbsd"       OpenBSD
+    "netbsd"        NetBSD
+    "freebsd"       FreeBSD
+    "midnightbsd"   MidnightBSD
+    "rocky"         Rocky Linux
+    "aix"           AIX
+    ==============  =========================================
+
+    If you have a need to get distros for reliable IDs added into this set,
+    or if you find that the :func:`distro.id` function returns a different
+    distro ID for one of the listed distros, please create an issue in the
+    `distro issue tracker`_.
+
+    **Lookup hierarchy and transformations:**
+
+    First, the ID is obtained from the following sources, in the specified
+    order. The first available and non-empty value is used:
+
+    * the value of the "ID" attribute of the os-release file,
+
+    * the value of the "Distributor ID" attribute returned by the lsb_release
+      command,
+
+    * the first part of the file name of the distro release file,
+
+    The so determined ID value then passes the following transformations,
+    before it is returned by this method:
+
+    * it is translated to lower case,
+
+    * blanks (which should not be there anyway) are translated to underscores,
+
+    * a normalization of the ID is performed, based upon
+      `normalization tables`_. The purpose of this normalization is to ensure
+      that the ID is as reliable as possible, even across incompatible changes
+      in the OS distributions. A common reason for an incompatible change is
+      the addition of an os-release file, or the addition of the lsb_release
+      command, with ID values that differ from what was previously determined
+      from the distro release file name.
+    """
+    return _distro.id()
+
+
+def name(pretty: bool = False) -> str:
+    """
+    Return the name of the current OS distribution, as a human-readable
+    string.
+
+    If *pretty* is false, the name is returned without version or codename.
+    (e.g. "CentOS Linux")
+
+    If *pretty* is true, the version and codename are appended.
+    (e.g. "CentOS Linux 7.1.1503 (Core)")
+
+    **Lookup hierarchy:**
+
+    The name is obtained from the following sources, in the specified order.
+    The first available and non-empty value is used:
+
+    * If *pretty* is false:
+
+      - the value of the "NAME" attribute of the os-release file,
+
+      - the value of the "Distributor ID" attribute returned by the lsb_release
+        command,
+
+      - the value of the "<name>" field of the distro release file.
+
+    * If *pretty* is true:
+
+      - the value of the "PRETTY_NAME" attribute of the os-release file,
+
+      - the value of the "Description" attribute returned by the lsb_release
+        command,
+
+      - the value of the "<name>" field of the distro release file, appended
+        with the value of the pretty version ("<version_id>" and "<codename>"
+        fields) of the distro release file, if available.
+    """
+    return _distro.name(pretty)
+
+
+def version(pretty: bool = False, best: bool = False) -> str:
+    """
+    Return the version of the current OS distribution, as a human-readable
+    string.
+
+    If *pretty* is false, the version is returned without codename (e.g.
+    "7.0").
+
+    If *pretty* is true, the codename in parenthesis is appended, if the
+    codename is non-empty (e.g. "7.0 (Maipo)").
+
+    Some distributions provide version numbers with different precisions in
+    the different sources of distribution information. Examining the different
+    sources in a fixed priority order does not always yield the most precise
+    version (e.g. for Debian 8.2, or CentOS 7.1).
+
+    Some other distributions may not provide this kind of information. In these
+    cases, an empty string would be returned. This behavior can be observed
+    with rolling releases distributions (e.g. Arch Linux).
+
+    The *best* parameter can be used to control the approach for the returned
+    version:
+
+    If *best* is false, the first non-empty version number in priority order of
+    the examined sources is returned.
+
+    If *best* is true, the most precise version number out of all examined
+    sources is returned.
+
+    **Lookup hierarchy:**
+
+    In all cases, the version number is obtained from the following sources.
+    If *best* is false, this order represents the priority order:
+
+    * the value of the "VERSION_ID" attribute of the os-release file,
+    * the value of the "Release" attribute returned by the lsb_release
+      command,
+    * the version number parsed from the "<version_id>" field of the first line
+      of the distro release file,
+    * the version number parsed from the "PRETTY_NAME" attribute of the
+      os-release file, if it follows the format of the distro release files.
+    * the version number parsed from the "Description" attribute returned by
+      the lsb_release command, if it follows the format of the distro release
+      files.
+    """
+    return _distro.version(pretty, best)
+
+
+def version_parts(best: bool = False) -> Tuple[str, str, str]:
+    """
+    Return the version of the current OS distribution as a tuple
+    ``(major, minor, build_number)`` with items as follows:
+
+    * ``major``:  The result of :func:`distro.major_version`.
+
+    * ``minor``:  The result of :func:`distro.minor_version`.
+
+    * ``build_number``:  The result of :func:`distro.build_number`.
+
+    For a description of the *best* parameter, see the :func:`distro.version`
+    method.
+    """
+    return _distro.version_parts(best)
+
+
+def major_version(best: bool = False) -> str:
+    """
+    Return the major version of the current OS distribution, as a string,
+    if provided.
+    Otherwise, the empty string is returned. The major version is the first
+    part of the dot-separated version string.
+
+    For a description of the *best* parameter, see the :func:`distro.version`
+    method.
+    """
+    return _distro.major_version(best)
+
+
+def minor_version(best: bool = False) -> str:
+    """
+    Return the minor version of the current OS distribution, as a string,
+    if provided.
+    Otherwise, the empty string is returned. The minor version is the second
+    part of the dot-separated version string.
+
+    For a description of the *best* parameter, see the :func:`distro.version`
+    method.
+    """
+    return _distro.minor_version(best)
+
+
+def build_number(best: bool = False) -> str:
+    """
+    Return the build number of the current OS distribution, as a string,
+    if provided.
+    Otherwise, the empty string is returned. The build number is the third part
+    of the dot-separated version string.
+
+    For a description of the *best* parameter, see the :func:`distro.version`
+    method.
+    """
+    return _distro.build_number(best)
+
+
+def like() -> str:
+    """
+    Return a space-separated list of distro IDs of distributions that are
+    closely related to the current OS distribution in regards to packaging
+    and programming interfaces, for example distributions the current
+    distribution is a derivative from.
+
+    **Lookup hierarchy:**
+
+    This information item is only provided by the os-release file.
+    For details, see the description of the "ID_LIKE" attribute in the
+    `os-release man page
+    <http://www.freedesktop.org/software/systemd/man/os-release.html>`_.
+    """
+    return _distro.like()
+
+
+def codename() -> str:
+    """
+    Return the codename for the release of the current OS distribution,
+    as a string.
+
+    If the distribution does not have a codename, an empty string is returned.
+
+    Note that the returned codename is not always really a codename. For
+    example, openSUSE returns "x86_64". This function does not handle such
+    cases in any special way and just returns the string it finds, if any.
+
+    **Lookup hierarchy:**
+
+    * the codename within the "VERSION" attribute of the os-release file, if
+      provided,
+
+    * the value of the "Codename" attribute returned by the lsb_release
+      command,
+
+    * the value of the "<codename>" field of the distro release file.
+    """
+    return _distro.codename()
+
+
+def info(pretty: bool = False, best: bool = False) -> InfoDict:
+    """
+    Return certain machine-readable information items about the current OS
+    distribution in a dictionary, as shown in the following example:
+
+    .. sourcecode:: python
+
+        {
+            'id': 'rhel',
+            'version': '7.0',
+            'version_parts': {
+                'major': '7',
+                'minor': '0',
+                'build_number': ''
+            },
+            'like': 'fedora',
+            'codename': 'Maipo'
+        }
+
+    The dictionary structure and keys are always the same, regardless of which
+    information items are available in the underlying data sources. The values
+    for the various keys are as follows:
+
+    * ``id``:  The result of :func:`distro.id`.
+
+    * ``version``:  The result of :func:`distro.version`.
+
+    * ``version_parts -> major``:  The result of :func:`distro.major_version`.
+
+    * ``version_parts -> minor``:  The result of :func:`distro.minor_version`.
+
+    * ``version_parts -> build_number``:  The result of
+      :func:`distro.build_number`.
+
+    * ``like``:  The result of :func:`distro.like`.
+
+    * ``codename``:  The result of :func:`distro.codename`.
+
+    For a description of the *pretty* and *best* parameters, see the
+    :func:`distro.version` method.
+    """
+    return _distro.info(pretty, best)
+
+
+def os_release_info() -> Dict[str, str]:
+    """
+    Return a dictionary containing key-value pairs for the information items
+    from the os-release file data source of the current OS distribution.
+
+    See `os-release file`_ for details about these information items.
+    """
+    return _distro.os_release_info()
+
+
+def lsb_release_info() -> Dict[str, str]:
+    """
+    Return a dictionary containing key-value pairs for the information items
+    from the lsb_release command data source of the current OS distribution.
+
+    See `lsb_release command output`_ for details about these information
+    items.
+    """
+    return _distro.lsb_release_info()
+
+
+def distro_release_info() -> Dict[str, str]:
+    """
+    Return a dictionary containing key-value pairs for the information items
+    from the distro release file data source of the current OS distribution.
+
+    See `distro release file`_ for details about these information items.
+    """
+    return _distro.distro_release_info()
+
+
+def uname_info() -> Dict[str, str]:
+    """
+    Return a dictionary containing key-value pairs for the information items
+    from the distro release file data source of the current OS distribution.
+    """
+    return _distro.uname_info()
+
+
+def os_release_attr(attribute: str) -> str:
+    """
+    Return a single named information item from the os-release file data source
+    of the current OS distribution.
+
+    Parameters:
+
+    * ``attribute`` (string): Key of the information item.
+
+    Returns:
+
+    * (string): Value of the information item, if the item exists.
+      The empty string, if the item does not exist.
+
+    See `os-release file`_ for details about these information items.
+    """
+    return _distro.os_release_attr(attribute)
+
+
+def lsb_release_attr(attribute: str) -> str:
+    """
+    Return a single named information item from the lsb_release command output
+    data source of the current OS distribution.
+
+    Parameters:
+
+    * ``attribute`` (string): Key of the information item.
+
+    Returns:
+
+    * (string): Value of the information item, if the item exists.
+      The empty string, if the item does not exist.
+
+    See `lsb_release command output`_ for details about these information
+    items.
+    """
+    return _distro.lsb_release_attr(attribute)
+
+
+def distro_release_attr(attribute: str) -> str:
+    """
+    Return a single named information item from the distro release file
+    data source of the current OS distribution.
+
+    Parameters:
+
+    * ``attribute`` (string): Key of the information item.
+
+    Returns:
+
+    * (string): Value of the information item, if the item exists.
+      The empty string, if the item does not exist.
+
+    See `distro release file`_ for details about these information items.
+    """
+    return _distro.distro_release_attr(attribute)
+
+
+def uname_attr(attribute: str) -> str:
+    """
+    Return a single named information item from the distro release file
+    data source of the current OS distribution.
+
+    Parameters:
+
+    * ``attribute`` (string): Key of the information item.
+
+    Returns:
+
+    * (string): Value of the information item, if the item exists.
+                The empty string, if the item does not exist.
+    """
+    return _distro.uname_attr(attribute)
+
+
+try:
+    from functools import cached_property
+except ImportError:
+    # Python < 3.8
+    class cached_property:  # type: ignore
+        """A version of @property which caches the value.  On access, it calls the
+        underlying function and sets the value in `__dict__` so future accesses
+        will not re-call the property.
+        """
+
+        def __init__(self, f: Callable[[Any], Any]) -> None:
+            self._fname = f.__name__
+            self._f = f
+
+        def __get__(self, obj: Any, owner: Type[Any]) -> Any:
+            assert obj is not None, f"call {self._fname} on an instance"
+            ret = obj.__dict__[self._fname] = self._f(obj)
+            return ret
+
+
+class LinuxDistribution:
+    """
+    Provides information about a OS distribution.
+
+    This package creates a private module-global instance of this class with
+    default initialization arguments, that is used by the
+    `consolidated accessor functions`_ and `single source accessor functions`_.
+    By using default initialization arguments, that module-global instance
+    returns data about the current OS distribution (i.e. the distro this
+    package runs on).
+
+    Normally, it is not necessary to create additional instances of this class.
+    However, in situations where control is needed over the exact data sources
+    that are used, instances of this class can be created with a specific
+    distro release file, or a specific os-release file, or without invoking the
+    lsb_release command.
+    """
+
+    def __init__(
+        self,
+        include_lsb: Optional[bool] = None,
+        os_release_file: str = "",
+        distro_release_file: str = "",
+        include_uname: Optional[bool] = None,
+        root_dir: Optional[str] = None,
+        include_oslevel: Optional[bool] = None,
+    ) -> None:
+        """
+        The initialization method of this class gathers information from the
+        available data sources, and stores that in private instance attributes.
+        Subsequent access to the information items uses these private instance
+        attributes, so that the data sources are read only once.
+
+        Parameters:
+
+        * ``include_lsb`` (bool): Controls whether the
+          `lsb_release command output`_ is included as a data source.
+
+          If the lsb_release command is not available in the program execution
+          path, the data source for the lsb_release command will be empty.
+
+        * ``os_release_file`` (string): The path name of the
+          `os-release file`_ that is to be used as a data source.
+
+          An empty string (the default) will cause the default path name to
+          be used (see `os-release file`_ for details).
+
+          If the specified or defaulted os-release file does not exist, the
+          data source for the os-release file will be empty.
+
+        * ``distro_release_file`` (string): The path name of the
+          `distro release file`_ that is to be used as a data source.
+
+          An empty string (the default) will cause a default search algorithm
+          to be used (see `distro release file`_ for details).
+
+          If the specified distro release file does not exist, or if no default
+          distro release file can be found, the data source for the distro
+          release file will be empty.
+
+        * ``include_uname`` (bool): Controls whether uname command output is
+          included as a data source. If the uname command is not available in
+          the program execution path the data source for the uname command will
+          be empty.
+
+        * ``root_dir`` (string): The absolute path to the root directory to use
+          to find distro-related information files. Note that ``include_*``
+          parameters must not be enabled in combination with ``root_dir``.
+
+        * ``include_oslevel`` (bool): Controls whether (AIX) oslevel command
+          output is included as a data source. If the oslevel command is not
+          available in the program execution path the data source will be
+          empty.
+
+        Public instance attributes:
+
+        * ``os_release_file`` (string): The path name of the
+          `os-release file`_ that is actually used as a data source. The
+          empty string if no distro release file is used as a data source.
+
+        * ``distro_release_file`` (string): The path name of the
+          `distro release file`_ that is actually used as a data source. The
+          empty string if no distro release file is used as a data source.
+
+        * ``include_lsb`` (bool): The result of the ``include_lsb`` parameter.
+          This controls whether the lsb information will be loaded.
+
+        * ``include_uname`` (bool): The result of the ``include_uname``
+          parameter. This controls whether the uname information will
+          be loaded.
+
+        * ``include_oslevel`` (bool): The result of the ``include_oslevel``
+          parameter. This controls whether (AIX) oslevel information will be
+          loaded.
+
+        * ``root_dir`` (string): The result of the ``root_dir`` parameter.
+          The absolute path to the root directory to use to find distro-related
+          information files.
+
+        Raises:
+
+        * :py:exc:`ValueError`: Initialization parameters combination is not
+           supported.
+
+        * :py:exc:`OSError`: Some I/O issue with an os-release file or distro
+          release file.
+
+        * :py:exc:`UnicodeError`: A data source has unexpected characters or
+          uses an unexpected encoding.
+        """
+        self.root_dir = root_dir
+        self.etc_dir = os.path.join(root_dir, "etc") if root_dir else _UNIXCONFDIR
+        self.usr_lib_dir = (
+            os.path.join(root_dir, "usr/lib") if root_dir else _UNIXUSRLIBDIR
+        )
+
+        if os_release_file:
+            self.os_release_file = os_release_file
+        else:
+            etc_dir_os_release_file = os.path.join(self.etc_dir, _OS_RELEASE_BASENAME)
+            usr_lib_os_release_file = os.path.join(
+                self.usr_lib_dir, _OS_RELEASE_BASENAME
+            )
+
+            # NOTE: The idea is to respect order **and** have it set
+            #       at all times for API backwards compatibility.
+            if os.path.isfile(etc_dir_os_release_file) or not os.path.isfile(
+                usr_lib_os_release_file
+            ):
+                self.os_release_file = etc_dir_os_release_file
+            else:
+                self.os_release_file = usr_lib_os_release_file
+
+        self.distro_release_file = distro_release_file or ""  # updated later
+
+        is_root_dir_defined = root_dir is not None
+        if is_root_dir_defined and (include_lsb or include_uname or include_oslevel):
+            raise ValueError(
+                "Including subprocess data sources from specific root_dir is disallowed"
+                " to prevent false information"
+            )
+        self.include_lsb = (
+            include_lsb if include_lsb is not None else not is_root_dir_defined
+        )
+        self.include_uname = (
+            include_uname if include_uname is not None else not is_root_dir_defined
+        )
+        self.include_oslevel = (
+            include_oslevel if include_oslevel is not None else not is_root_dir_defined
+        )
+
+    def __repr__(self) -> str:
+        """Return repr of all info"""
+        return (
+            "LinuxDistribution("
+            "os_release_file={self.os_release_file!r}, "
+            "distro_release_file={self.distro_release_file!r}, "
+            "include_lsb={self.include_lsb!r}, "
+            "include_uname={self.include_uname!r}, "
+            "include_oslevel={self.include_oslevel!r}, "
+            "root_dir={self.root_dir!r}, "
+            "_os_release_info={self._os_release_info!r}, "
+            "_lsb_release_info={self._lsb_release_info!r}, "
+            "_distro_release_info={self._distro_release_info!r}, "
+            "_uname_info={self._uname_info!r}, "
+            "_oslevel_info={self._oslevel_info!r})".format(self=self)
+        )
+
+    def linux_distribution(
+        self, full_distribution_name: bool = True
+    ) -> Tuple[str, str, str]:
+        """
+        Return information about the OS distribution that is compatible
+        with Python's :func:`platform.linux_distribution`, supporting a subset
+        of its parameters.
+
+        For details, see :func:`distro.linux_distribution`.
+        """
+        return (
+            self.name() if full_distribution_name else self.id(),
+            self.version(),
+            self._os_release_info.get("release_codename") or self.codename(),
+        )
+
+    def id(self) -> str:
+        """Return the distro ID of the OS distribution, as a string.
+
+        For details, see :func:`distro.id`.
+        """
+
+        def normalize(distro_id: str, table: Dict[str, str]) -> str:
+            distro_id = distro_id.lower().replace(" ", "_")
+            return table.get(distro_id, distro_id)
+
+        distro_id = self.os_release_attr("id")
+        if distro_id:
+            return normalize(distro_id, NORMALIZED_OS_ID)
+
+        distro_id = self.lsb_release_attr("distributor_id")
+        if distro_id:
+            return normalize(distro_id, NORMALIZED_LSB_ID)
+
+        distro_id = self.distro_release_attr("id")
+        if distro_id:
+            return normalize(distro_id, NORMALIZED_DISTRO_ID)
+
+        distro_id = self.uname_attr("id")
+        if distro_id:
+            return normalize(distro_id, NORMALIZED_DISTRO_ID)
+
+        return ""
+
+    def name(self, pretty: bool = False) -> str:
+        """
+        Return the name of the OS distribution, as a string.
+
+        For details, see :func:`distro.name`.
+        """
+        name = (
+            self.os_release_attr("name")
+            or self.lsb_release_attr("distributor_id")
+            or self.distro_release_attr("name")
+            or self.uname_attr("name")
+        )
+        if pretty:
+            name = self.os_release_attr("pretty_name") or self.lsb_release_attr(
+                "description"
+            )
+            if not name:
+                name = self.distro_release_attr("name") or self.uname_attr("name")
+                version = self.version(pretty=True)
+                if version:
+                    name = f"{name} {version}"
+        return name or ""
+
+    def version(self, pretty: bool = False, best: bool = False) -> str:
+        """
+        Return the version of the OS distribution, as a string.
+
+        For details, see :func:`distro.version`.
+        """
+        versions = [
+            self.os_release_attr("version_id"),
+            self.lsb_release_attr("release"),
+            self.distro_release_attr("version_id"),
+            self._parse_distro_release_content(self.os_release_attr("pretty_name")).get(
+                "version_id", ""
+            ),
+            self._parse_distro_release_content(
+                self.lsb_release_attr("description")
+            ).get("version_id", ""),
+            self.uname_attr("release"),
+        ]
+        if self.uname_attr("id").startswith("aix"):
+            # On AIX platforms, prefer oslevel command output.
+            versions.insert(0, self.oslevel_info())
+        version = ""
+        if best:
+            # This algorithm uses the last version in priority order that has
+            # the best precision. If the versions are not in conflict, that
+            # does not matter; otherwise, using the last one instead of the
+            # first one might be considered a surprise.
+            for v in versions:
+                if v.count(".") > version.count(".") or version == "":
+                    version = v
+        else:
+            for v in versions:
+                if v != "":
+                    version = v
+                    break
+        if pretty and version and self.codename():
+            version = f"{version} ({self.codename()})"
+        return version
+
+    def version_parts(self, best: bool = False) -> Tuple[str, str, str]:
+        """
+        Return the version of the OS distribution, as a tuple of version
+        numbers.
+
+        For details, see :func:`distro.version_parts`.
+        """
+        version_str = self.version(best=best)
+        if version_str:
+            version_regex = re.compile(r"(\d+)\.?(\d+)?\.?(\d+)?")
+            matches = version_regex.match(version_str)
+            if matches:
+                major, minor, build_number = matches.groups()
+                return major, minor or "", build_number or ""
+        return "", "", ""
+
+    def major_version(self, best: bool = False) -> str:
+        """
+        Return the major version number of the current distribution.
+
+        For details, see :func:`distro.major_version`.
+        """
+        return self.version_parts(best)[0]
+
+    def minor_version(self, best: bool = False) -> str:
+        """
+        Return the minor version number of the current distribution.
+
+        For details, see :func:`distro.minor_version`.
+        """
+        return self.version_parts(best)[1]
+
+    def build_number(self, best: bool = False) -> str:
+        """
+        Return the build number of the current distribution.
+
+        For details, see :func:`distro.build_number`.
+        """
+        return self.version_parts(best)[2]
+
+    def like(self) -> str:
+        """
+        Return the IDs of distributions that are like the OS distribution.
+
+        For details, see :func:`distro.like`.
+        """
+        return self.os_release_attr("id_like") or ""
+
+    def codename(self) -> str:
+        """
+        Return the codename of the OS distribution.
+
+        For details, see :func:`distro.codename`.
+        """
+        try:
+            # Handle os_release specially since distros might purposefully set
+            # this to empty string to have no codename
+            return self._os_release_info["codename"]
+        except KeyError:
+            return (
+                self.lsb_release_attr("codename")
+                or self.distro_release_attr("codename")
+                or ""
+            )
+
+    def info(self, pretty: bool = False, best: bool = False) -> InfoDict:
+        """
+        Return certain machine-readable information about the OS
+        distribution.
+
+        For details, see :func:`distro.info`.
+        """
+        return dict(
+            id=self.id(),
+            version=self.version(pretty, best),
+            version_parts=dict(
+                major=self.major_version(best),
+                minor=self.minor_version(best),
+                build_number=self.build_number(best),
+            ),
+            like=self.like(),
+            codename=self.codename(),
+        )
+
+    def os_release_info(self) -> Dict[str, str]:
+        """
+        Return a dictionary containing key-value pairs for the information
+        items from the os-release file data source of the OS distribution.
+
+        For details, see :func:`distro.os_release_info`.
+        """
+        return self._os_release_info
+
+    def lsb_release_info(self) -> Dict[str, str]:
+        """
+        Return a dictionary containing key-value pairs for the information
+        items from the lsb_release command data source of the OS
+        distribution.
+
+        For details, see :func:`distro.lsb_release_info`.
+        """
+        return self._lsb_release_info
+
+    def distro_release_info(self) -> Dict[str, str]:
+        """
+        Return a dictionary containing key-value pairs for the information
+        items from the distro release file data source of the OS
+        distribution.
+
+        For details, see :func:`distro.distro_release_info`.
+        """
+        return self._distro_release_info
+
+    def uname_info(self) -> Dict[str, str]:
+        """
+        Return a dictionary containing key-value pairs for the information
+        items from the uname command data source of the OS distribution.
+
+        For details, see :func:`distro.uname_info`.
+        """
+        return self._uname_info
+
+    def oslevel_info(self) -> str:
+        """
+        Return AIX' oslevel command output.
+        """
+        return self._oslevel_info
+
+    def os_release_attr(self, attribute: str) -> str:
+        """
+        Return a single named information item from the os-release file data
+        source of the OS distribution.
+
+        For details, see :func:`distro.os_release_attr`.
+        """
+        return self._os_release_info.get(attribute, "")
+
+    def lsb_release_attr(self, attribute: str) -> str:
+        """
+        Return a single named information item from the lsb_release command
+        output data source of the OS distribution.
+
+        For details, see :func:`distro.lsb_release_attr`.
+        """
+        return self._lsb_release_info.get(attribute, "")
+
+    def distro_release_attr(self, attribute: str) -> str:
+        """
+        Return a single named information item from the distro release file
+        data source of the OS distribution.
+
+        For details, see :func:`distro.distro_release_attr`.
+        """
+        return self._distro_release_info.get(attribute, "")
+
+    def uname_attr(self, attribute: str) -> str:
+        """
+        Return a single named information item from the uname command
+        output data source of the OS distribution.
+
+        For details, see :func:`distro.uname_attr`.
+        """
+        return self._uname_info.get(attribute, "")
+
+    @cached_property
+    def _os_release_info(self) -> Dict[str, str]:
+        """
+        Get the information items from the specified os-release file.
+
+        Returns:
+            A dictionary containing all information items.
+        """
+        if os.path.isfile(self.os_release_file):
+            with open(self.os_release_file, encoding="utf-8") as release_file:
+                return self._parse_os_release_content(release_file)
+        return {}
+
+    @staticmethod
+    def _parse_os_release_content(lines: TextIO) -> Dict[str, str]:
+        """
+        Parse the lines of an os-release file.
+
+        Parameters:
+
+        * lines: Iterable through the lines in the os-release file.
+                 Each line must be a unicode string or a UTF-8 encoded byte
+                 string.
+
+        Returns:
+            A dictionary containing all information items.
+        """
+        props = {}
+        lexer = shlex.shlex(lines, posix=True)
+        lexer.whitespace_split = True
+
+        tokens = list(lexer)
+        for token in tokens:
+            # At this point, all shell-like parsing has been done (i.e.
+            # comments processed, quotes and backslash escape sequences
+            # processed, multi-line values assembled, trailing newlines
+            # stripped, etc.), so the tokens are now either:
+            # * variable assignments: var=value
+            # * commands or their arguments (not allowed in os-release)
+            # Ignore any tokens that are not variable assignments
+            if "=" in token:
+                k, v = token.split("=", 1)
+                props[k.lower()] = v
+
+        if "version" in props:
+            # extract release codename (if any) from version attribute
+            match = re.search(r"\((\D+)\)|,\s*(\D+)", props["version"])
+            if match:
+                release_codename = match.group(1) or match.group(2)
+                props["codename"] = props["release_codename"] = release_codename
+
+        if "version_codename" in props:
+            # os-release added a version_codename field.  Use that in
+            # preference to anything else Note that some distros purposefully
+            # do not have code names.  They should be setting
+            # version_codename=""
+            props["codename"] = props["version_codename"]
+        elif "ubuntu_codename" in props:
+            # Same as above but a non-standard field name used on older Ubuntus
+            props["codename"] = props["ubuntu_codename"]
+
+        return props
+
+    @cached_property
+    def _lsb_release_info(self) -> Dict[str, str]:
+        """
+        Get the information items from the lsb_release command output.
+
+        Returns:
+            A dictionary containing all information items.
+        """
+        if not self.include_lsb:
+            return {}
+        try:
+            cmd = ("lsb_release", "-a")
+            stdout = subprocess.check_output(cmd, stderr=subprocess.DEVNULL)
+        # Command not found or lsb_release returned error
+        except (OSError, subprocess.CalledProcessError):
+            return {}
+        content = self._to_str(stdout).splitlines()
+        return self._parse_lsb_release_content(content)
+
+    @staticmethod
+    def _parse_lsb_release_content(lines: Iterable[str]) -> Dict[str, str]:
+        """
+        Parse the output of the lsb_release command.
+
+        Parameters:
+
+        * lines: Iterable through the lines of the lsb_release output.
+                 Each line must be a unicode string or a UTF-8 encoded byte
+                 string.
+
+        Returns:
+            A dictionary containing all information items.
+        """
+        props = {}
+        for line in lines:
+            kv = line.strip("\n").split(":", 1)
+            if len(kv) != 2:
+                # Ignore lines without colon.
+                continue
+            k, v = kv
+            props.update({k.replace(" ", "_").lower(): v.strip()})
+        return props
+
+    @cached_property
+    def _uname_info(self) -> Dict[str, str]:
+        if not self.include_uname:
+            return {}
+        try:
+            cmd = ("uname", "-rs")
+            stdout = subprocess.check_output(cmd, stderr=subprocess.DEVNULL)
+        except OSError:
+            return {}
+        content = self._to_str(stdout).splitlines()
+        return self._parse_uname_content(content)
+
+    @cached_property
+    def _oslevel_info(self) -> str:
+        if not self.include_oslevel:
+            return ""
+        try:
+            stdout = subprocess.check_output("oslevel", stderr=subprocess.DEVNULL)
+        except (OSError, subprocess.CalledProcessError):
+            return ""
+        return self._to_str(stdout).strip()
+
+    @staticmethod
+    def _parse_uname_content(lines: Sequence[str]) -> Dict[str, str]:
+        if not lines:
+            return {}
+        props = {}
+        match = re.search(r"^([^\s]+)\s+([\d\.]+)", lines[0].strip())
+        if match:
+            name, version = match.groups()
+
+            # This is to prevent the Linux kernel version from
+            # appearing as the 'best' version on otherwise
+            # identifiable distributions.
+            if name == "Linux":
+                return {}
+            props["id"] = name.lower()
+            props["name"] = name
+            props["release"] = version
+        return props
+
+    @staticmethod
+    def _to_str(bytestring: bytes) -> str:
+        encoding = sys.getfilesystemencoding()
+        return bytestring.decode(encoding)
+
+    @cached_property
+    def _distro_release_info(self) -> Dict[str, str]:
+        """
+        Get the information items from the specified distro release file.
+
+        Returns:
+            A dictionary containing all information items.
+        """
+        if self.distro_release_file:
+            # If it was specified, we use it and parse what we can, even if
+            # its file name or content does not match the expected pattern.
+            distro_info = self._parse_distro_release_file(self.distro_release_file)
+            basename = os.path.basename(self.distro_release_file)
+            # The file name pattern for user-specified distro release files
+            # is somewhat more tolerant (compared to when searching for the
+            # file), because we want to use what was specified as best as
+            # possible.
+            match = _DISTRO_RELEASE_BASENAME_PATTERN.match(basename)
+            if "name" in distro_info and "cloudlinux" in distro_info["name"].lower():
+                distro_info["id"] = "cloudlinux"
+            elif match:
+                distro_info["id"] = match.group(1)
+            return distro_info
+        else:
+            try:
+                basenames = os.listdir(self.etc_dir)
+                # We sort for repeatability in cases where there are multiple
+                # distro specific files; e.g. CentOS, Oracle, Enterprise all
+                # containing `redhat-release` on top of their own.
+                basenames.sort()
+            except OSError:
+                # This may occur when /etc is not readable but we can't be
+                # sure about the *-release files. Check common entries of
+                # /etc for information. If they turn out to not be there the
+                # error is handled in `_parse_distro_release_file()`.
+                basenames = [
+                    "SuSE-release",
+                    "arch-release",
+                    "base-release",
+                    "centos-release",
+                    "fedora-release",
+                    "gentoo-release",
+                    "mageia-release",
+                    "mandrake-release",
+                    "mandriva-release",
+                    "mandrivalinux-release",
+                    "manjaro-release",
+                    "oracle-release",
+                    "redhat-release",
+                    "rocky-release",
+                    "sl-release",
+                    "slackware-version",
+                ]
+            for basename in basenames:
+                if basename in _DISTRO_RELEASE_IGNORE_BASENAMES:
+                    continue
+                match = _DISTRO_RELEASE_BASENAME_PATTERN.match(basename)
+                if match:
+                    filepath = os.path.join(self.etc_dir, basename)
+                    distro_info = self._parse_distro_release_file(filepath)
+                    if "name" in distro_info:
+                        # The name is always present if the pattern matches
+                        self.distro_release_file = filepath
+                        distro_info["id"] = match.group(1)
+                        if "cloudlinux" in distro_info["name"].lower():
+                            distro_info["id"] = "cloudlinux"
+                        return distro_info
+            return {}
+
+    def _parse_distro_release_file(self, filepath: str) -> Dict[str, str]:
+        """
+        Parse a distro release file.
+
+        Parameters:
+
+        * filepath: Path name of the distro release file.
+
+        Returns:
+            A dictionary containing all information items.
+        """
+        try:
+            with open(filepath, encoding="utf-8") as fp:
+                # Only parse the first line. For instance, on SLES there
+                # are multiple lines. We don't want them...
+                return self._parse_distro_release_content(fp.readline())
+        except OSError:
+            # Ignore not being able to read a specific, seemingly version
+            # related file.
+            # See https://github.com/python-distro/distro/issues/162
+            return {}
+
+    @staticmethod
+    def _parse_distro_release_content(line: str) -> Dict[str, str]:
+        """
+        Parse a line from a distro release file.
+
+        Parameters:
+        * line: Line from the distro release file. Must be a unicode string
+                or a UTF-8 encoded byte string.
+
+        Returns:
+            A dictionary containing all information items.
+        """
+        matches = _DISTRO_RELEASE_CONTENT_REVERSED_PATTERN.match(line.strip()[::-1])
+        distro_info = {}
+        if matches:
+            # regexp ensures non-None
+            distro_info["name"] = matches.group(3)[::-1]
+            if matches.group(2):
+                distro_info["version_id"] = matches.group(2)[::-1]
+            if matches.group(1):
+                distro_info["codename"] = matches.group(1)[::-1]
+        elif line:
+            distro_info["name"] = line.strip()
+        return distro_info
+
+
+_distro = LinuxDistribution()
+
+
+def main() -> None:
+    logger = logging.getLogger(__name__)
+    logger.setLevel(logging.DEBUG)
+    logger.addHandler(logging.StreamHandler(sys.stdout))
+
+    parser = argparse.ArgumentParser(description="OS distro info tool")
+    parser.add_argument(
+        "--json", "-j", help="Output in machine readable format", action="store_true"
+    )
+
+    parser.add_argument(
+        "--root-dir",
+        "-r",
+        type=str,
+        dest="root_dir",
+        help="Path to the root filesystem directory (defaults to /)",
+    )
+
+    args = parser.parse_args()
+
+    if args.root_dir:
+        dist = LinuxDistribution(
+            include_lsb=False,
+            include_uname=False,
+            include_oslevel=False,
+            root_dir=args.root_dir,
+        )
+    else:
+        dist = _distro
+
+    if args.json:
+        logger.info(json.dumps(dist.info(), indent=4, sort_keys=True))
+    else:
+        logger.info("Name: %s", dist.name(pretty=True))
+        distribution_version = dist.version(pretty=True)
+        logger.info("Version: %s", distribution_version)
+        distribution_codename = dist.codename()
+        logger.info("Codename: %s", distribution_codename)
+
+
+if __name__ == "__main__":
+    main()
diff --git a/lib/distro/py.typed b/lib/distro/py.typed
new file mode 100644
index 00000000..e69de29b
diff --git a/requirements.txt b/requirements.txt
index 0810ddc5..d433889a 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -10,7 +10,7 @@ certifi==2021.10.8
 cheroot==8.6.0
 cherrypy==18.6.1
 cloudinary==1.29.0
-distro==1.6.0
+distro==1.7.0
 dnspython==2.2.0
 facebook-sdk==3.1.0
 future==0.18.2

From 54c9214b039ae929e00d8b47287e92e6f7c065db Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 16 May 2022 20:32:37 -0700
Subject: [PATCH 075/743] 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/apscheduler/jobstores/mongodb.py      |   4 +-
 lib/apscheduler/schedulers/base.py        |   5 +-
 lib/apscheduler/schedulers/qt.py          |  11 +-
 lib/apscheduler/triggers/cron/__init__.py |   7 +-
 lib/apscheduler/triggers/interval.py      |   6 +-
 lib/apscheduler/util.py                   |  23 +-
 lib/pytz/__init__.py                      |   4 +-
 lib/pytz/zoneinfo/America/Punta_Arenas    | Bin 1902 -> 1902 bytes
 lib/pytz/zoneinfo/America/Santiago        | Bin 2529 -> 2529 bytes
 lib/pytz/zoneinfo/Asia/Gaza               | Bin 2422 -> 2422 bytes
 lib/pytz/zoneinfo/Asia/Hebron             | Bin 2450 -> 2450 bytes
 lib/pytz/zoneinfo/Chile/Continental       | Bin 2529 -> 2529 bytes
 lib/pytz/zoneinfo/Europe/Kiev             | Bin 2088 -> 2120 bytes
 lib/pytz/zoneinfo/Europe/Simferopol       | Bin 1453 -> 1469 bytes
 lib/pytz/zoneinfo/Europe/Uzhgorod         | Bin 2050 -> 2066 bytes
 lib/pytz/zoneinfo/Europe/Zaporozhye       | Bin 2106 -> 2138 bytes
 lib/pytz/zoneinfo/Pacific/Fiji            | Bin 1077 -> 1049 bytes
 lib/pytz/zoneinfo/leapseconds             |   8 +-
 lib/pytz/zoneinfo/tzdata.zi               |  38 +--
 lib/pytz_deprecation_shim/__init__.py     |  34 +++
 lib/pytz_deprecation_shim/_common.py      |  13 +
 lib/pytz_deprecation_shim/_compat.py      |  15 ++
 lib/pytz_deprecation_shim/_compat_py2.py  |  43 ++++
 lib/pytz_deprecation_shim/_compat_py3.py  |  58 +++++
 lib/pytz_deprecation_shim/_exceptions.py  |  75 ++++++
 lib/pytz_deprecation_shim/_impl.py        | 296 ++++++++++++++++++++++
 lib/pytz_deprecation_shim/helpers.py      |  90 +++++++
 lib/tzdata/__init__.py                    |   4 +-
 lib/tzdata/zoneinfo/America/Punta_Arenas  | Bin 1209 -> 1209 bytes
 lib/tzdata/zoneinfo/America/Santiago      | Bin 1282 -> 1282 bytes
 lib/tzdata/zoneinfo/Asia/Gaza             | Bin 1230 -> 1240 bytes
 lib/tzdata/zoneinfo/Asia/Hebron           | Bin 1248 -> 1258 bytes
 lib/tzdata/zoneinfo/Chile/Continental     | Bin 1282 -> 1282 bytes
 lib/tzdata/zoneinfo/Europe/Kiev           | Bin 549 -> 558 bytes
 lib/tzdata/zoneinfo/Europe/Simferopol     | Bin 865 -> 865 bytes
 lib/tzdata/zoneinfo/Europe/Uzhgorod       | Bin 530 -> 539 bytes
 lib/tzdata/zoneinfo/Europe/Zaporozhye     | Bin 560 -> 569 bytes
 lib/tzdata/zoneinfo/leapseconds           |   8 +-
 lib/tzdata/zoneinfo/tzdata.zi             |  34 +--
 lib/tzlocal/__init__.py                   |  14 +-
 lib/tzlocal/unix.py                       | 219 +++++++++-------
 lib/tzlocal/utils.py                      |  94 ++++++-
 lib/tzlocal/win32.py                      | 119 +++++----
 lib/tzlocal/windows_tz.py                 |  20 +-
 package/requirements-package.txt          |   2 +-
 requirements.txt                          |   8 +-
 46 files changed, 1029 insertions(+), 223 deletions(-)
 create mode 100644 lib/pytz_deprecation_shim/__init__.py
 create mode 100644 lib/pytz_deprecation_shim/_common.py
 create mode 100644 lib/pytz_deprecation_shim/_compat.py
 create mode 100644 lib/pytz_deprecation_shim/_compat_py2.py
 create mode 100644 lib/pytz_deprecation_shim/_compat_py3.py
 create mode 100644 lib/pytz_deprecation_shim/_exceptions.py
 create mode 100644 lib/pytz_deprecation_shim/_impl.py
 create mode 100644 lib/pytz_deprecation_shim/helpers.py

diff --git a/lib/apscheduler/jobstores/mongodb.py b/lib/apscheduler/jobstores/mongodb.py
index ea3097dd..5a00f941 100644
--- a/lib/apscheduler/jobstores/mongodb.py
+++ b/lib/apscheduler/jobstores/mongodb.py
@@ -106,7 +106,7 @@ class MongoDBJobStore(BaseJobStore):
             raise JobLookupError(job_id)
 
     def remove_all_jobs(self):
-        self.collection.remove()
+        self.collection.delete_many({})
 
     def shutdown(self):
         self.client.close()
@@ -133,7 +133,7 @@ class MongoDBJobStore(BaseJobStore):
 
         # Remove all the jobs we failed to restore
         if failed_job_ids:
-            self.collection.remove({'_id': {'$in': failed_job_ids}})
+            self.collection.delete_many({'_id': {'$in': failed_job_ids}})
 
         return jobs
 
diff --git a/lib/apscheduler/schedulers/base.py b/lib/apscheduler/schedulers/base.py
index 3dfb7437..444de8ef 100644
--- a/lib/apscheduler/schedulers/base.py
+++ b/lib/apscheduler/schedulers/base.py
@@ -191,12 +191,11 @@ class BaseScheduler(six.with_metaclass(ABCMeta)):
         self.state = STATE_STOPPED
 
         # Shut down all executors
-        with self._executors_lock:
+        with self._executors_lock, self._jobstores_lock:
             for executor in six.itervalues(self._executors):
                 executor.shutdown(wait)
 
-        # Shut down all job stores
-        with self._jobstores_lock:
+            # Shut down all job stores
             for jobstore in six.itervalues(self._jobstores):
                 jobstore.shutdown()
 
diff --git a/lib/apscheduler/schedulers/qt.py b/lib/apscheduler/schedulers/qt.py
index dda77d79..600f6e67 100644
--- a/lib/apscheduler/schedulers/qt.py
+++ b/lib/apscheduler/schedulers/qt.py
@@ -9,13 +9,16 @@ except (ImportError, RuntimeError):  # pragma: nocover
         from PyQt4.QtCore import QObject, QTimer
     except ImportError:
         try:
-            from PySide2.QtCore import QObject, QTimer  # noqa
+            from PySide6.QtCore import QObject, QTimer  # noqa
         except ImportError:
             try:
-                from PySide.QtCore import QObject, QTimer  # noqa
+                from PySide2.QtCore import QObject, QTimer  # noqa
             except ImportError:
-                raise ImportError('QtScheduler requires either PyQt5, PyQt4, PySide2 '
-                                  'or PySide installed')
+                try:
+                    from PySide.QtCore import QObject, QTimer  # noqa
+                except ImportError:
+                    raise ImportError('QtScheduler requires either PyQt5, PyQt4, PySide6, PySide2 '
+                                      'or PySide installed')
 
 
 class QtScheduler(BaseScheduler):
diff --git a/lib/apscheduler/triggers/cron/__init__.py b/lib/apscheduler/triggers/cron/__init__.py
index fec6e3b5..b5389dd2 100644
--- a/lib/apscheduler/triggers/cron/__init__.py
+++ b/lib/apscheduler/triggers/cron/__init__.py
@@ -6,7 +6,8 @@ import six
 from apscheduler.triggers.base import BaseTrigger
 from apscheduler.triggers.cron.fields import (
     BaseField, MonthField, WeekField, DayOfMonthField, DayOfWeekField, DEFAULT_VALUES)
-from apscheduler.util import datetime_ceil, convert_to_datetime, datetime_repr, astimezone
+from apscheduler.util import (
+    datetime_ceil, convert_to_datetime, datetime_repr, astimezone, localize, normalize)
 
 
 class CronTrigger(BaseTrigger):
@@ -143,7 +144,7 @@ class CronTrigger(BaseTrigger):
                     i += 1
 
         difference = datetime(**values) - dateval.replace(tzinfo=None)
-        return self.timezone.normalize(dateval + difference), fieldnum
+        return normalize(dateval + difference), fieldnum
 
     def _set_field_value(self, dateval, fieldnum, new_value):
         values = {}
@@ -156,7 +157,7 @@ class CronTrigger(BaseTrigger):
                 else:
                     values[field.name] = new_value
 
-        return self.timezone.localize(datetime(**values))
+        return localize(datetime(**values), self.timezone)
 
     def get_next_fire_time(self, previous_fire_time, now):
         if previous_fire_time:
diff --git a/lib/apscheduler/triggers/interval.py b/lib/apscheduler/triggers/interval.py
index 61094aa1..b0e2dbdd 100644
--- a/lib/apscheduler/triggers/interval.py
+++ b/lib/apscheduler/triggers/interval.py
@@ -4,7 +4,9 @@ from math import ceil
 from tzlocal import get_localzone
 
 from apscheduler.triggers.base import BaseTrigger
-from apscheduler.util import convert_to_datetime, timedelta_seconds, datetime_repr, astimezone
+from apscheduler.util import (
+    convert_to_datetime, normalize, timedelta_seconds, datetime_repr,
+    astimezone)
 
 
 class IntervalTrigger(BaseTrigger):
@@ -63,7 +65,7 @@ class IntervalTrigger(BaseTrigger):
             next_fire_time = self._apply_jitter(next_fire_time, self.jitter, now)
 
         if not self.end_date or next_fire_time <= self.end_date:
-            return self.timezone.normalize(next_fire_time)
+            return normalize(next_fire_time)
 
     def __getstate__(self):
         return {
diff --git a/lib/apscheduler/util.py b/lib/apscheduler/util.py
index 1e643bff..d929a482 100644
--- a/lib/apscheduler/util.py
+++ b/lib/apscheduler/util.py
@@ -34,7 +34,7 @@ except ImportError:
 __all__ = ('asint', 'asbool', 'astimezone', 'convert_to_datetime', 'datetime_to_utc_timestamp',
            'utc_timestamp_to_datetime', 'timedelta_seconds', 'datetime_ceil', 'get_callable_name',
            'obj_to_ref', 'ref_to_obj', 'maybe_ref', 'repr_escape', 'check_callable_args',
-           'TIMEOUT_MAX')
+           'normalize', 'localize', 'TIMEOUT_MAX')
 
 
 class _Undefined(object):
@@ -90,9 +90,7 @@ def astimezone(obj):
     if isinstance(obj, six.string_types):
         return timezone(obj)
     if isinstance(obj, tzinfo):
-        if not hasattr(obj, 'localize') or not hasattr(obj, 'normalize'):
-            raise TypeError('Only timezones from the pytz library are supported')
-        if obj.zone == 'local':
+        if obj.tzname(None) == 'local':
             raise ValueError(
                 'Unable to determine the name of the local timezone -- you must explicitly '
                 'specify the name of the local timezone. Please refrain from using timezones like '
@@ -162,11 +160,7 @@ def convert_to_datetime(input, tz, arg_name):
     if isinstance(tz, six.string_types):
         tz = timezone(tz)
 
-    try:
-        return tz.localize(datetime_, is_dst=None)
-    except AttributeError:
-        raise TypeError(
-            'Only pytz timezones are supported (need the localize() and normalize() methods)')
+    return localize(datetime_, tz)
 
 
 def datetime_to_utc_timestamp(timeval):
@@ -431,3 +425,14 @@ def iscoroutinefunction_partial(f):
     # The asyncio version of iscoroutinefunction includes testing for @coroutine
     # decorations vs. the inspect version which does not.
     return iscoroutinefunction(f)
+
+
+def normalize(dt):
+    return datetime.fromtimestamp(dt.timestamp(), dt.tzinfo)
+
+
+def localize(dt, tzinfo):
+    if hasattr(tzinfo, 'localize'):
+        return tzinfo.localize(dt)
+
+    return normalize(dt.replace(tzinfo=tzinfo))
diff --git a/lib/pytz/__init__.py b/lib/pytz/__init__.py
index 6ef4366b..900e8caa 100644
--- a/lib/pytz/__init__.py
+++ b/lib/pytz/__init__.py
@@ -22,8 +22,8 @@ from pytz.tzfile import build_tzinfo
 
 
 # The IANA (nee Olson) database is updated several times a year.
-OLSON_VERSION = '2021c'
-VERSION = '2021.3'  # pip compatible version number.
+OLSON_VERSION = '2022a'
+VERSION = '2022.1'  # pip compatible version number.
 __version__ = VERSION
 
 OLSEN_VERSION = OLSON_VERSION  # Old releases had this misspelling
diff --git a/lib/pytz/zoneinfo/America/Punta_Arenas b/lib/pytz/zoneinfo/America/Punta_Arenas
index a5a8af52c2f26baf6f85a1786f69593491ad5195..13bd1d9a7755df59c009b4c4e5fbe44257e7ab51 100644
GIT binary patch
delta 88
zcmaFI_l|FZv7qbhn5O~rYaSh4$WVA-LtOdMjV@M9jJqe-GqozZ{s#h(JctIV0ns3J
ZAR450vnum9X0T!}4lWyA17ka5E&yJ$E=d3Y

delta 88
zcmaFI_l|FZv7p=Rn5O~rYaSh2$WVA-LtOc>jV@M9jJqb+GqozZ{RaY&JctIV0ns3J
ZAR450vnum9X0T!}4lWyA17ka5E&yM&E=>Rc

diff --git a/lib/pytz/zoneinfo/America/Santiago b/lib/pytz/zoneinfo/America/Santiago
index 816a0428188d99f437004312ee73c3860ee0f54f..aa2906063f3bb2be42e800c208c6a4453a610031 100644
GIT binary patch
delta 99
zcmaDT{7`s;v7qbhn5O~rYaSh4$WVA-LtOdMjV|2G?7JBl{{P>*dvX|at>)4HK+tdC
f?h2woszEeJ2Z#pg0?{CyoBuEuv%<BOab^Pmz|lFr

delta 99
zcmaDT{7`s;v7p=Rn5O~rYaSh2$WVA-LtOc>jV|2G?7J8k{{P>*YjPNKt>&@+K+tdC
f?gpYkszEeJ2Z#pg0?{CyoBuEuv%<BOab^Pm!Phy#

diff --git a/lib/pytz/zoneinfo/Asia/Gaza b/lib/pytz/zoneinfo/Asia/Gaza
index a4ca1c6e028f91977916e3ab1f45d5be135eea02..266981aaf2e79f5ab7f494c21b785b3531c0bc59 100644
GIT binary patch
delta 431
zcmW;Iy-PxI6o>I^7F@!jYzv~j#8ix+rNO0!h}K*VS>4{WcTsP3hlm2(T5^^^aFHDP
z16+a@mxh{7TSG(;In+?U=bq)WexK6`cfyT8m*<Yi^30WHmi}aAG^eZ6ud-&B#Tjmi
z^OlwMpIg~@Sdh(^3)!m0WxG|??B$T;s^_}ne9P{cqkD^kx}TZTgV>iIrpEPX;7Rk5
zS;>FiYauiyg?2@Y?;$BQTy-Bm<hXJpC-t_R7E99YmG9&_ZT~jC;B$~QmN^z7tB_^L
zI%FZT($_3S)*_3M)yQ&WJyL*FASLLLW3)&@vXC?+4@pEaeN8Ho>uZvcY$P4YM_z!u
e0eOX?$KoB$wA~lzpGrjL<FRNmnw&^X_WlE7?vVQc

delta 431
zcmW;IJ1j$C7>DuJAsR_Z8k<XE6QM=Updl<G7GW>R8|u`xZq=OLoTaguEX0P`grt*=
zL~LS24BpKoCTD3RzUO?)?;HQm>&N`qZMeZJXLWIWRF>xFG~L}L%VWdpG$%FF*{+$d
z4qd7Hy885|YaegAe)XvvkH4~c_@LR#SJ`qdbh~;dJG1w)n?94h#JS`qE3)5KmHfb|
z=6@V<qa}4;rls(`pv9X$DLqeU`D98f*FAdR_G+VdWa)7#Qm=W|yTzK2c`QO!A<K|;
z$U<agpjnEnMHVBgk>$vGqyVWvO3)*R4@pQCl7{3ViAZLkNkwu4O)`>=q$Byr36L`&
cr!X{yI7clNiH2M4k^Y&X!MGi_6LzxYA58?5rT_o{

diff --git a/lib/pytz/zoneinfo/Asia/Hebron b/lib/pytz/zoneinfo/Asia/Hebron
index 1a206a70c7da285a55cf3790e116e633fbd0a14a..0078bf01c3db4a013a599ca995fbb72b81460a47 100644
GIT binary patch
delta 430
zcmW;Ize@sf7{~GBFvyUoZVRHl#8ix+rJ<#Uh}Ncutgc^LS&4et4G{(2q)W~c1T9iS
ze}GHS;?mOev_wNh5G_H}_kGXuT0ifn?$n)j)b_m*S(ynmyZk4sqj_DMev$Rwnz+Lq
zao=*X@pC1c4~w$(d@kG9DcR|?G<V@hzICR%?zilny1KtKsD<pj9wfi?aCTge2A;GS
zpOfO}y_RBQQtCFf{2r4^+f(oHLynu5QoZTQNx32szjiBkf&Cg`iDiy8$RcDFvJ6>=
zEDSX(k)_C5WHGWDS&pnn3Xlr)NikaFAW29Tl7{3ViJ>MFNewl*NHUU*q$Byr3y?P$
ddMsYi2<+cRAv)AQm5wi@l8H<rGm)O``v=EDkbnRH

delta 430
zcmW;Iy)Q#y7>4oYs7NJ9)aE0xHA0J=K||U_#3K9wBu}VQpGDCe+B!>Ps-<0sO~oc8
zCL4*^#7JWBOiW^8ktW{jyvy$$@9U|AE8**q<rOkIpBR;e*%?jsbj#w{usTg~O?P!@
z`m<A){(g1&v92p`uey5iu4@lJvVM54ne!LfaB8|)x|OZzJISU_Wjl5zJL5&!Z7WG`
z;6!uZj<_v(b)P3??`ux?ulgkal+?oUgcdJ*^}vm2&^v0-o3iy0WJ$n0)*y?JRmd`A
z9kS5ZtVEU~YmvpsYGgUG9w|U7&?AKpIY<(cg`^>QNTRRFL{fcCE|QF7Bk4#!asuQG
dhQ<J=sFtmIH5+PgwMY7=h6bZ{)Q;Kl=6|#Llq&!L

diff --git a/lib/pytz/zoneinfo/Chile/Continental b/lib/pytz/zoneinfo/Chile/Continental
index 816a0428188d99f437004312ee73c3860ee0f54f..aa2906063f3bb2be42e800c208c6a4453a610031 100644
GIT binary patch
delta 99
zcmaDT{7`s;v7qbhn5O~rYaSh4$WVA-LtOdMjV|2G?7JBl{{P>*dvX|at>)4HK+tdC
f?h2woszEeJ2Z#pg0?{CyoBuEuv%<BOab^Pmz|lFr

delta 99
zcmaDT{7`s;v7p=Rn5O~rYaSh2$WVA-LtOc>jV|2G?7J8k{{P>*YjPNKt>&@+K+tdC
f?gpYkszEeJ2Z#pg0?{CyoBuEuv%<BOab^Pm!Phy#

diff --git a/lib/pytz/zoneinfo/Europe/Kiev b/lib/pytz/zoneinfo/Europe/Kiev
index 9337c9ea27c0a61b1082f4be37cfb0f9484cf5e2..52efea88065b220e44fd876de3bf3090fe62cc79 100644
GIT binary patch
delta 430
zcmZ1>a6({$xFA0R0|N+yKqV0KPt>SXzRJ;{b>wG*_Lf%-I!kUh=uSD)px3guLBC{O
zgF(vt2E*9X3>%MRFvfE8z#uOl)#2m@b{8=j1qKcV1}y_dSq26Kd-6GUeHKPW28PLO
z%qo~(m~74b(HZCmke@*Q0MQ`7fM}3^Ks3ltAR6Q^5DoGhhz9u&M1%aeIiF<<(;)EV
HUv_N(G=W0U

delta 396
zcmX>hutH#hxF9bB0|N+yKqV0KPSmJWzVaqP>&W>4?JegLbe3!k(4Dd&L9b<UfPTrI
z2?i-^Cm6=w6xetqgE5wg3k<n=XaOfrV0YotGGLTtV31K@;F$c1U4OC|vkIn*Cwnu0
zbOt&Z<OPtkK{UweAR6R+5DoGIhz5BBM1#BnqCwsP(I78vu4mc8M1McYa%ckpcrQL*

diff --git a/lib/pytz/zoneinfo/Europe/Simferopol b/lib/pytz/zoneinfo/Europe/Simferopol
index 432e8315bc9dfa74080467f9e08073d9fdcc833a..29107a07cb2e192f0c33889e726e6fbddd2cb867 100644
GIT binary patch
delta 273
zcmZ3>y_b7}xS#+70|N+yfHx2eOw=e9zRJ;{b>wG*_Lf%-I!kUh=uSD)Fmc0CU2ZOJ
zE_P;iW=;+sUP6#>GB>L$i;MyT$7DZN7j{M<U|?jJtjDB=Y31ZprkBb<J3(#$*$bjU
mc7te;{U93ThRub{xr`LJLKf-@ka<u5bQJ@aZ?LznF&6-UdMZ8u

delta 259
zcmdnXy_S1|xFA0R0|N+yfHx5HPt+(CzVaqP>&W>4?JegLbe3!k(4Dd&Vd93Px=dV5
zT<py3%$ywDJcJ<cWMNj<$#JYstPG5d42+Y_nA9-snw-n@QW<C&$a0W{AR1&Thz3~<
gqCu8#u4K+-B+q(ju=OB=paAF^1}@)VZ(U<902{t2r~m)}

diff --git a/lib/pytz/zoneinfo/Europe/Uzhgorod b/lib/pytz/zoneinfo/Europe/Uzhgorod
index 66ae8d69e3f86cfdd8d90a9b1d094d807f75f27a..0eb21501d9241268b7e5593c81bd02272b77c9cb 100644
GIT binary patch
delta 414
zcmZn?m?SVkT#%Q6fdPa;paO__Cu)=`U*%}fI`XqYd&{c^oh7#$bf=tY&}-S-pkK1C
z!60RRgJJAxhK&a@8Kby3A&{Gg+Hi6zyS;#n0)r?61BBEvV3eG^j$NIV5eOJ2e`8X{
zboyj1=9kVuw}bowazBU$`2j?O`~jjtegV-S|A1(apFlLoUmzOfx6NTJTbTyXb2r$v
E0B}z~<^TWy

delta 398
zcmbOv&?GQHT#$!>fdPa;paO__CTf%_UwM<Db>w`2_Lg%AI!iVN=uX*?pw}`vK)+<q
z1cQ{d6AWW-3T!-($r#1K34~nSG=P(H+3mTs3>YOD7-SR}L?`cIS7&BmWSsnuNg310
zlZ}{PIs@Gd@&m}-AR6R$5Djuahz9uqM1%YRqCtKE(IEeTXpo;a$FXc>8URndVAlcw
DC`vv8

diff --git a/lib/pytz/zoneinfo/Europe/Zaporozhye b/lib/pytz/zoneinfo/Europe/Zaporozhye
index e42edfc8506b9b99362b36d90c8b8c4db67d50d8..f0406c12a6b519347d6a7c091424da9d0f241236 100644
GIT binary patch
delta 408
zcmdlba7$o<xFA0R0|N+yKot=4Pt>SYzRJ;{b>wG*_Lf%-I!kUh=uSD)px3guLBC{O
zgF(vt2E*9X3>!~mF~)H7Kp`(5)#2m`?0!593^ED~Tnr3a28{BP@39-QFfuYQOy*@)
z!F2azC+45dK!<}o0&+Zv26+HPgFFGEK^_6oAkTnkkcU7t$WtI1<gv|lEZdj{%4hr>
F+5qwkK=c3r

delta 372
zcmca5uuEWqxF9bB0|N+yKot=4PSmJXzVaqP>&W>4?JegLbe3!k(4Dd&L9b<UfPTrI
z2?i-^Cm6=w6xetoi!p|a2?V)$XaOfLVE3E+i`{UtEVBxxD<=mr|8xdA6Xa}=Q$aMy
oxgZ+kWDpH<Hi!l}9Ylki528U{0MQ_CZ0=*(#zY@~=yPZT05JAFjsO4v

diff --git a/lib/pytz/zoneinfo/Pacific/Fiji b/lib/pytz/zoneinfo/Pacific/Fiji
index e71691ee932809771920778c699c27e32ce99207..af07ac8faecad5ceddcff91412539c8c3648fa0a 100644
GIT binary patch
delta 37
scmdnWF_UA0GNau@m70kw4o=QybYirdypHk9=1okFj6kmZWDyoc00V*y#Q*>R

delta 57
zcmbQqv6W+jGNZ#pl^XWM{v!_(A6=d}|Ip;?%!-p67=hxGmoR?e21zgg0Z?-DWF|L8
HptKVJt~D1-

diff --git a/lib/pytz/zoneinfo/leapseconds b/lib/pytz/zoneinfo/leapseconds
index 834b96ea..ffa5eb80 100644
--- a/lib/pytz/zoneinfo/leapseconds
+++ b/lib/pytz/zoneinfo/leapseconds
@@ -72,11 +72,11 @@ Leap	2016	Dec	31	23:59:60	+	S
 # Any additional leap seconds will come after this.
 # This Expires line is commented out for now,
 # so that pre-2020a zic implementations do not reject this file.
-#Expires 2022	Jun	28	00:00:00
+#Expires 2022	Dec	28	00:00:00
 
 # POSIX timestamps for the data in this file:
 #updated 1467936000 (2016-07-08 00:00:00 UTC)
-#expires 1656374400 (2022-06-28 00:00:00 UTC)
+#expires 1672185600 (2022-12-28 00:00:00 UTC)
 
-#	Updated through IERS Bulletin C62
-#	File expires on:  28 June 2022
+#	Updated through IERS Bulletin C63
+#	File expires on:  28 December 2022
diff --git a/lib/pytz/zoneinfo/tzdata.zi b/lib/pytz/zoneinfo/tzdata.zi
index e16ab09f..e21fc920 100644
--- a/lib/pytz/zoneinfo/tzdata.zi
+++ b/lib/pytz/zoneinfo/tzdata.zi
@@ -1111,8 +1111,10 @@ R P 2016 2018 - Mar Sa>=24 1 1 S
 R P 2016 2018 - O Sa>=24 1 0 -
 R P 2019 o - Mar 29 0 1 S
 R P 2019 o - O Sa>=24 0 0 -
-R P 2020 ma - Mar Sa>=24 0 1 S
-R P 2020 ma - O Sa>=24 1 0 -
+R P 2020 2021 - Mar Sa>=24 0 1 S
+R P 2020 o - O 24 1 0 -
+R P 2021 ma - O F>=23 1 0 -
+R P 2022 ma - Mar Su>=25 0 1 S
 Z Asia/Gaza 2:17:52 - LMT 1900 O
 2 Z EET/EEST 1948 May 15
 2 K EE%sT 1967 Jun 5
@@ -1418,10 +1420,11 @@ R FJ 2011 o - Mar Su>=1 3 0 -
 R FJ 2012 2013 - Ja Su>=18 3 0 -
 R FJ 2014 o - Ja Su>=18 2 0 -
 R FJ 2014 2018 - N Su>=1 2 1 -
-R FJ 2015 ma - Ja Su>=12 3 0 -
+R FJ 2015 2021 - Ja Su>=12 3 0 -
 R FJ 2019 o - N Su>=8 2 1 -
 R FJ 2020 o - D 20 2 1 -
-R FJ 2021 ma - N Su>=8 2 1 -
+R FJ 2022 ma - N Su>=8 2 1 -
+R FJ 2023 ma - Ja Su>=12 3 0 -
 Z Pacific/Fiji 11:55:44 - LMT 1915 O 26
 12 FJ +12/+13
 Z Pacific/Gambier -8:59:48 - LMT 1912 O
@@ -2429,8 +2432,8 @@ Z Europe/Simferopol 2:16:24 - LMT 1880
 1 c CE%sT 1944 Ap 13
 3 R MSK/MSD 1990
 3 - MSK 1990 Jul 1 2
-2 - EET 1992
-2 e EE%sT 1994 May
+2 - EET 1992 Mar 20
+2 c EE%sT 1994 May
 3 e MSK/MSD 1996 Mar 31 0s
 3 1 MSD 1996 O 27 3s
 3 R MSK/MSD 1997
@@ -2785,7 +2788,7 @@ Z Europe/Kiev 2:2:4 - LMT 1880
 1 c CE%sT 1943 N 6
 3 R MSK/MSD 1990 Jul 1 2
 2 1 EEST 1991 S 29 3
-2 e EE%sT 1995
+2 c EE%sT 1996 May 13
 2 E EE%sT
 Z Europe/Uzhgorod 1:29:12 - LMT 1890 O
 1 - CET 1940
@@ -2795,8 +2798,8 @@ Z Europe/Uzhgorod 1:29:12 - LMT 1890 O
 3 R MSK/MSD 1990
 3 - MSK 1990 Jul 1 2
 1 - CET 1991 Mar 31 3
-2 - EET 1992
-2 e EE%sT 1995
+2 - EET 1992 Mar 20
+2 c EE%sT 1996 May 13
 2 E EE%sT
 Z Europe/Zaporozhye 2:20:40 - LMT 1880
 2:20 - +0220 1924 May 2
@@ -2804,7 +2807,8 @@ Z Europe/Zaporozhye 2:20:40 - LMT 1880
 3 - MSK 1941 Au 25
 1 c CE%sT 1943 O 25
 3 R MSK/MSD 1991 Mar 31 2
-2 e EE%sT 1995
+2 e EE%sT 1992 Mar 20
+2 c EE%sT 1996 May 13
 2 E EE%sT
 R u 1918 1919 - Mar lastSu 2 1 D
 R u 1918 1919 - O lastSu 2 0 S
@@ -4086,12 +4090,12 @@ R x 2016 2018 - May Su>=9 3u 0 -
 R x 2016 2018 - Au Su>=9 4u 1 -
 R x 2019 ma - Ap Su>=2 3u 0 -
 R x 2019 ma - S Su>=2 4u 1 -
-Z America/Santiago -4:42:46 - LMT 1890
--4:42:46 - SMT 1910 Ja 10
+Z America/Santiago -4:42:45 - LMT 1890
+-4:42:45 - SMT 1910 Ja 10
 -5 - -05 1916 Jul
--4:42:46 - SMT 1918 S 10
+-4:42:45 - SMT 1918 S 10
 -4 - -04 1919 Jul
--4:42:46 - SMT 1927 S
+-4:42:45 - SMT 1927 S
 -5 x -05/-04 1932 S
 -4 - -04 1942 Jun
 -5 - -05 1942 Au
@@ -4101,11 +4105,11 @@ Z America/Santiago -4:42:46 - LMT 1890
 -5 - -05 1947 May 21 23
 -4 x -04/-03
 Z America/Punta_Arenas -4:43:40 - LMT 1890
--4:42:46 - SMT 1910 Ja 10
+-4:42:45 - SMT 1910 Ja 10
 -5 - -05 1916 Jul
--4:42:46 - SMT 1918 S 10
+-4:42:45 - SMT 1918 S 10
 -4 - -04 1919 Jul
--4:42:46 - SMT 1927 S
+-4:42:45 - SMT 1927 S
 -5 x -05/-04 1932 S
 -4 - -04 1942 Jun
 -5 - -05 1942 Au
diff --git a/lib/pytz_deprecation_shim/__init__.py b/lib/pytz_deprecation_shim/__init__.py
new file mode 100644
index 00000000..8b451620
--- /dev/null
+++ b/lib/pytz_deprecation_shim/__init__.py
@@ -0,0 +1,34 @@
+__all__ = [
+    "AmbiguousTimeError",
+    "NonExistentTimeError",
+    "InvalidTimeError",
+    "UnknownTimeZoneError",
+    "PytzUsageWarning",
+    "FixedOffset",
+    "UTC",
+    "utc",
+    "build_tzinfo",
+    "timezone",
+    "fixed_offset_timezone",
+    "wrap_zone",
+]
+
+from . import helpers
+from ._exceptions import (
+    AmbiguousTimeError,
+    InvalidTimeError,
+    NonExistentTimeError,
+    PytzUsageWarning,
+    UnknownTimeZoneError,
+)
+from ._impl import (
+    UTC,
+    build_tzinfo,
+    fixed_offset_timezone,
+    timezone,
+    wrap_zone,
+)
+
+# Compatibility aliases
+utc = UTC
+FixedOffset = fixed_offset_timezone
diff --git a/lib/pytz_deprecation_shim/_common.py b/lib/pytz_deprecation_shim/_common.py
new file mode 100644
index 00000000..ace322e9
--- /dev/null
+++ b/lib/pytz_deprecation_shim/_common.py
@@ -0,0 +1,13 @@
+import sys
+
+_PYTZ_IMPORTED = False
+
+
+def pytz_imported():
+    """Detects whether or not pytz has been imported without importing pytz."""
+    global _PYTZ_IMPORTED
+
+    if not _PYTZ_IMPORTED and "pytz" in sys.modules:
+        _PYTZ_IMPORTED = True
+
+    return _PYTZ_IMPORTED
diff --git a/lib/pytz_deprecation_shim/_compat.py b/lib/pytz_deprecation_shim/_compat.py
new file mode 100644
index 00000000..5b734592
--- /dev/null
+++ b/lib/pytz_deprecation_shim/_compat.py
@@ -0,0 +1,15 @@
+import sys
+
+if sys.version_info[0] == 2:
+    from . import _compat_py2 as _compat_impl
+else:
+    from . import _compat_py3 as _compat_impl
+
+UTC = _compat_impl.UTC
+get_timezone = _compat_impl.get_timezone
+get_timezone_file = _compat_impl.get_timezone_file
+get_fixed_offset_zone = _compat_impl.get_fixed_offset_zone
+is_ambiguous = _compat_impl.is_ambiguous
+is_imaginary = _compat_impl.is_imaginary
+enfold = _compat_impl.enfold
+get_fold = _compat_impl.get_fold
diff --git a/lib/pytz_deprecation_shim/_compat_py2.py b/lib/pytz_deprecation_shim/_compat_py2.py
new file mode 100644
index 00000000..f473d267
--- /dev/null
+++ b/lib/pytz_deprecation_shim/_compat_py2.py
@@ -0,0 +1,43 @@
+from datetime import timedelta
+
+from dateutil import tz
+
+UTC = tz.UTC
+
+
+def get_timezone(key):
+    if not key:
+        raise KeyError("Unknown time zone: %s" % key)
+
+    try:
+        rv = tz.gettz(key)
+    except Exception:
+        rv = None
+
+    if rv is None or not isinstance(rv, (tz.tzutc, tz.tzfile)):
+        raise KeyError("Unknown time zone: %s" % key)
+
+    return rv
+
+
+def get_timezone_file(f, key=None):
+    return tz.tzfile(f)
+
+
+def get_fixed_offset_zone(offset):
+    return tz.tzoffset(None, timedelta(minutes=offset))
+
+
+def is_ambiguous(dt):
+    return tz.datetime_ambiguous(dt)
+
+
+def is_imaginary(dt):
+    return not tz.datetime_exists(dt)
+
+
+enfold = tz.enfold
+
+
+def get_fold(dt):
+    return getattr(dt, "fold", 0)
diff --git a/lib/pytz_deprecation_shim/_compat_py3.py b/lib/pytz_deprecation_shim/_compat_py3.py
new file mode 100644
index 00000000..8881abac
--- /dev/null
+++ b/lib/pytz_deprecation_shim/_compat_py3.py
@@ -0,0 +1,58 @@
+# Note: This file could use Python 3-only syntax, but at the moment this breaks
+# the coverage job on Python 2. Until we make it so that coverage can ignore
+# this file only on Python 2, we'll have to stick to 2/3-compatible syntax.
+try:
+    import zoneinfo
+except ImportError:
+    from backports import zoneinfo
+
+import datetime
+
+UTC = datetime.timezone.utc
+
+
+def get_timezone(key):
+    try:
+        return zoneinfo.ZoneInfo(key)
+    except (ValueError, OSError):
+        # TODO: Use `from e` when this file can use Python 3 syntax
+        raise KeyError(key)
+
+
+def get_timezone_file(f, key=None):
+    return zoneinfo.ZoneInfo.from_file(f, key=key)
+
+
+def get_fixed_offset_zone(offset):
+    return datetime.timezone(datetime.timedelta(minutes=offset))
+
+
+def is_imaginary(dt):
+    dt_rt = dt.astimezone(UTC).astimezone(dt.tzinfo)
+
+    return not (dt == dt_rt)
+
+
+def is_ambiguous(dt):
+    if is_imaginary(dt):
+        return False
+
+    wall_0 = dt
+    wall_1 = dt.replace(fold=not dt.fold)
+
+    # Ambiguous datetimes can only exist if the offset changes, so we don't
+    # actually have to check whether dst() or tzname() are different.
+    same_offset = wall_0.utcoffset() == wall_1.utcoffset()
+
+    return not same_offset
+
+
+def enfold(dt, fold=1):
+    if dt.fold != fold:
+        return dt.replace(fold=fold)
+    else:
+        return dt
+
+
+def get_fold(dt):
+    return dt.fold
diff --git a/lib/pytz_deprecation_shim/_exceptions.py b/lib/pytz_deprecation_shim/_exceptions.py
new file mode 100644
index 00000000..58d7af0a
--- /dev/null
+++ b/lib/pytz_deprecation_shim/_exceptions.py
@@ -0,0 +1,75 @@
+from ._common import pytz_imported
+
+
+class PytzUsageWarning(RuntimeWarning):
+    """Warning raised when accessing features specific to ``pytz``'s interface.
+
+    This warning is used to direct users of ``pytz``-specific features like the
+    ``localize`` and ``normalize`` methods towards using the standard
+    ``tzinfo`` interface, so that these shims can be replaced with one of the
+    underlying libraries they are wrapping.
+    """
+
+
+class UnknownTimeZoneError(KeyError):
+    """Raised when no time zone is found for a specified key."""
+
+
+class InvalidTimeError(Exception):
+    """The base class for exceptions related to folds and gaps."""
+
+
+class AmbiguousTimeError(InvalidTimeError):
+    """Exception raised when ``is_dst=None`` for an ambiguous time (fold)."""
+
+
+class NonExistentTimeError(InvalidTimeError):
+    """Exception raised when ``is_dst=None`` for a non-existent time (gap)."""
+
+
+PYTZ_BASE_ERROR_MAPPING = {}
+
+
+def _make_pytz_derived_errors(
+    InvalidTimeError_=InvalidTimeError,
+    AmbiguousTimeError_=AmbiguousTimeError,
+    NonExistentTimeError_=NonExistentTimeError,
+    UnknownTimeZoneError_=UnknownTimeZoneError,
+):
+    if PYTZ_BASE_ERROR_MAPPING or not pytz_imported():
+        return
+
+    import pytz
+
+    class InvalidTimeError(InvalidTimeError_, pytz.InvalidTimeError):
+        pass
+
+    class AmbiguousTimeError(AmbiguousTimeError_, pytz.AmbiguousTimeError):
+        pass
+
+    class NonExistentTimeError(
+        NonExistentTimeError_, pytz.NonExistentTimeError
+    ):
+        pass
+
+    class UnknownTimeZoneError(
+        UnknownTimeZoneError_, pytz.UnknownTimeZoneError
+    ):
+        pass
+
+    PYTZ_BASE_ERROR_MAPPING.update(
+        {
+            InvalidTimeError_: InvalidTimeError,
+            AmbiguousTimeError_: AmbiguousTimeError,
+            NonExistentTimeError_: NonExistentTimeError,
+            UnknownTimeZoneError_: UnknownTimeZoneError,
+        }
+    )
+
+
+def get_exception(exc_type, msg):
+    _make_pytz_derived_errors()
+
+    out_exc_type = PYTZ_BASE_ERROR_MAPPING.get(exc_type, exc_type)
+
+    return out_exc_type(msg)
diff --git a/lib/pytz_deprecation_shim/_impl.py b/lib/pytz_deprecation_shim/_impl.py
new file mode 100644
index 00000000..54430479
--- /dev/null
+++ b/lib/pytz_deprecation_shim/_impl.py
@@ -0,0 +1,296 @@
+# -*- coding: utf-8 -*-
+import warnings
+from datetime import tzinfo
+
+from . import _compat
+from ._exceptions import (
+    AmbiguousTimeError,
+    NonExistentTimeError,
+    PytzUsageWarning,
+    UnknownTimeZoneError,
+    get_exception,
+)
+
+IS_DST_SENTINEL = object()
+KEY_SENTINEL = object()
+
+
+def timezone(key, _cache={}):
+    """Builds an IANA database time zone shim.
+
+    This is the equivalent of ``pytz.timezone``.
+
+    :param key:
+        A valid key from the IANA time zone database.
+
+    :raises UnknownTimeZoneError:
+        If an unknown value is passed, this will raise an exception that can be
+        caught by :exc:`pytz_deprecation_shim.UnknownTimeZoneError` or
+        ``pytz.UnknownTimeZoneError``. Like
+        :exc:`zoneinfo.ZoneInfoNotFoundError`, both of those are subclasses of
+        :exc:`KeyError`.
+    """
+    instance = _cache.get(key, None)
+    if instance is None:
+        if len(key) == 3 and key.lower() == "utc":
+            instance = _cache.setdefault(key, UTC)
+        else:
+            try:
+                zone = _compat.get_timezone(key)
+            except KeyError:
+                raise get_exception(UnknownTimeZoneError, key)
+            instance = _cache.setdefault(key, wrap_zone(zone, key=key))
+
+    return instance
+
+
+def fixed_offset_timezone(offset, _cache={}):
+    """Builds a fixed offset time zone shim.
+
+    This is the equivalent of ``pytz.FixedOffset``. An alias is available as
+    ``pytz_deprecation_shim.FixedOffset`` as well.
+
+    :param offset:
+        A fixed offset from UTC, in minutes. This must be in the range ``-1439
+        <= offset <= 1439``.
+
+    :raises ValueError:
+        For offsets whose absolute value is greater than or equal to 24 hours.
+
+    :return:
+        A shim time zone.
+    """
+    if not (-1440 < offset < 1440):
+        raise ValueError("absolute offset is too large", offset)
+
+    instance = _cache.get(offset, None)
+    if instance is None:
+        if offset == 0:
+            instance = _cache.setdefault(offset, UTC)
+        else:
+            zone = _compat.get_fixed_offset_zone(offset)
+            instance = _cache.setdefault(offset, wrap_zone(zone, key=None))
+
+    return instance
+
+
+def build_tzinfo(zone, fp):
+    """Builds a shim object from a TZif file.
+
+    This is a shim for ``pytz.build_tzinfo``. Given a value to use as the zone
+    IANA key and a file-like object containing a valid TZif file (i.e.
+    conforming to :rfc:`8536`), this builds a time zone object and wraps it in
+    a shim class.
+
+    The argument names are chosen to match those in ``pytz.build_tzinfo``.
+
+    :param zone:
+        A string to be used as the time zone object's IANA key.
+
+    :param fp:
+        A readable file-like object emitting bytes, pointing to a valid TZif
+        file.
+
+    :return:
+        A shim time zone.
+    """
+    zone_file = _compat.get_timezone_file(fp)
+
+    return wrap_zone(zone_file, key=zone)
+
+
+def wrap_zone(tz, key=KEY_SENTINEL, _cache={}):
+    """Wrap an existing time zone object in a shim class.
+
+    This is likely to be useful if you would like to work internally with
+    non-``pytz`` zones, but you expose an interface to callers relying on
+    ``pytz``'s interface. It may also be useful for passing non-``pytz`` zones
+    to libraries expecting to use ``pytz``'s interface.
+
+    :param tz:
+        A :pep:`495`-compatible time zone, such as those provided by
+        :mod:`dateutil.tz` or :mod:`zoneinfo`.
+
+    :param key:
+        The value for the IANA time zone key. This is optional for ``zoneinfo``
+        zones, but required for ``dateutil.tz`` zones.
+
+    :return:
+        A shim time zone.
+    """
+    if key is KEY_SENTINEL:
+        key = getattr(tz, "key", KEY_SENTINEL)
+
+    if key is KEY_SENTINEL:
+        raise TypeError(
+            "The `key` argument is required when wrapping zones that do not "
+            + "have a `key` attribute."
+        )
+
+    instance = _cache.get((id(tz), key), None)
+    if instance is None:
+        instance = _cache.setdefault((id(tz), key), _PytzShimTimezone(tz, key))
+
+    return instance
+
+
+class _PytzShimTimezone(tzinfo):
+    # Add instance variables for _zone and _key because this will make error
+    # reporting with partially-initialized _BasePytzShimTimezone objects
+    # work better.
+    _zone = None
+    _key = None
+
+    def __init__(self, zone, key):
+        self._key = key
+        self._zone = zone
+
+    def utcoffset(self, dt):
+        return self._zone.utcoffset(dt)
+
+    def dst(self, dt):
+        return self._zone.dst(dt)
+
+    def tzname(self, dt):
+        return self._zone.tzname(dt)
+
+    def fromutc(self, dt):
+        # The default fromutc implementation only works if tzinfo is "self"
+        dt_base = dt.replace(tzinfo=self._zone)
+        dt_out = self._zone.fromutc(dt_base)
+
+        return dt_out.replace(tzinfo=self)
+
+    def __str__(self):
+        if self._key is not None:
+            return str(self._key)
+        else:
+            return repr(self)
+
+    def __repr__(self):
+        return "%s(%s, %s)" % (
+            self.__class__.__name__,
+            repr(self._zone),
+            repr(self._key),
+        )
+
+    def unwrap_shim(self):
+        """Returns the underlying class that the shim is a wrapper for.
+
+        This is a shim-specific method equivalent to
+        :func:`pytz_deprecation_shim.helpers.upgrade_tzinfo`. It is provided as
+        a method to allow end-users to upgrade shim timezones without requiring
+        an explicit dependency on ``pytz_deprecation_shim``, e.g.:
+
+        .. code-block:: python
+
+            if getattr(tz, "unwrap_shim", None) is None:
+                tz = tz.unwrap_shim()
+        """
+        return self._zone
+
+    @property
+    def zone(self):
+        warnings.warn(
+            "The zone attribute is specific to pytz's interface; "
+            + "please migrate to a new time zone provider. "
+            + "For more details on how to do so, see %s"
+            % PYTZ_MIGRATION_GUIDE_URL,
+            PytzUsageWarning,
+            stacklevel=2,
+        )
+
+        return self._key
+
+    def localize(self, dt, is_dst=IS_DST_SENTINEL):
+        warnings.warn(
+            "The localize method is no longer necessary, as this "
+            + "time zone supports the fold attribute (PEP 495). "
+            + "For more details on migrating to a PEP 495-compliant "
+            + "implementation, see %s" % PYTZ_MIGRATION_GUIDE_URL,
+            PytzUsageWarning,
+            stacklevel=2,
+        )
+
+        if dt.tzinfo is not None:
+            raise ValueError("Not naive datetime (tzinfo is already set)")
+
+        dt_out = dt.replace(tzinfo=self)
+
+        if is_dst is IS_DST_SENTINEL:
+            return dt_out
+
+        dt_ambiguous = _compat.is_ambiguous(dt_out)
+        dt_imaginary = (
+            _compat.is_imaginary(dt_out) if not dt_ambiguous else False
+        )
+
+        if is_dst is None:
+            if dt_imaginary:
+                raise get_exception(
+                    NonExistentTimeError, dt.replace(tzinfo=None)
+                )
+
+            if dt_ambiguous:
+                raise get_exception(AmbiguousTimeError, dt.replace(tzinfo=None))
+
+        elif dt_ambiguous or dt_imaginary:
+            # Start by normalizing the folds; dt_out may have fold=0 or fold=1,
+            # but we need to know the DST offset on both sides anyway, so we
+            # will get one datetime representing each side of the fold, then
+            # decide which one we're going to return.
+            if _compat.get_fold(dt_out):
+                dt_enfolded = dt_out
+                dt_out = _compat.enfold(dt_out, fold=0)
+            else:
+                dt_enfolded = _compat.enfold(dt_out, fold=1)
+
+            # Now we want to decide whether the fold=0 or fold=1 represents
+            # what pytz would return for `is_dst=True`
+            enfolded_dst = bool(dt_enfolded.dst())
+            if bool(dt_out.dst()) == enfolded_dst:
+                # If this is not a transition between standard time and
+                # daylight saving time, pytz will consider the larger offset
+                # the DST offset.
+                enfolded_dst = dt_enfolded.utcoffset() > dt_out.utcoffset()
+
+            # The default we've established is that dt_out is fold=0; swap it
+            # for the fold=1 datetime if is_dst == True and the enfolded side
+            # is DST or if is_dst == False and the enfolded side is *not* DST.
+            if is_dst == enfolded_dst:
+                dt_out = dt_enfolded
+
+        return dt_out
+
+    def normalize(self, dt):
+        warnings.warn(
+            "The normalize method is no longer necessary, as this "
+            + "time zone supports the fold attribute (PEP 495). "
+            + "For more details on migrating to a PEP 495-compliant "
+            + "implementation, see %s" % PYTZ_MIGRATION_GUIDE_URL,
+            PytzUsageWarning,
+            stacklevel=2,
+        )
+
+        if dt.tzinfo is None:
+            raise ValueError("Naive time - no tzinfo set")
+
+        if dt.tzinfo is self:
+            return dt
+
+        return dt.astimezone(self)
+
+    def __copy__(self):
+        return self
+
+    def __deepcopy__(self, memo=None):
+        return self
+
+    def __reduce__(self):
+        return wrap_zone, (self._zone, self._key)
+
+
+UTC = wrap_zone(_compat.UTC, "UTC")
+PYTZ_MIGRATION_GUIDE_URL = (
+    "https://pytz-deprecation-shim.readthedocs.io/en/latest/migration.html"
+)
diff --git a/lib/pytz_deprecation_shim/helpers.py b/lib/pytz_deprecation_shim/helpers.py
new file mode 100644
index 00000000..6b05b130
--- /dev/null
+++ b/lib/pytz_deprecation_shim/helpers.py
@@ -0,0 +1,90 @@
+"""
+This module contains helper functions to ease the transition from ``pytz`` to
+another :pep:`495`-compatible library.
+"""
+from . import _common, _compat
+from ._impl import _PytzShimTimezone
+
+_PYTZ_BASE_CLASSES = None
+
+
+def is_pytz_zone(tz):
+    """Check if a time zone is a ``pytz`` time zone.
+
+    This will only import ``pytz`` if it has already been imported, and does
+    not rely on the existence of the ``localize`` or ``normalize`` methods
+    (since the shim classes also have these methods, but are not ``pytz``
+    zones).
+    """
+
+    # If pytz is not in sys.modules, then we will assume the time zone is not a
+    # pytz zone. It is possible that someone has manipulated sys.modules to
+    # remove pytz, but that's the kind of thing that causes all kinds of other
+    # problems anyway, so we'll call that an unsupported configuration.
+    if not _common.pytz_imported():
+        return False
+
+    if _PYTZ_BASE_CLASSES is None:
+        _populate_pytz_base_classes()
+
+    return isinstance(tz, _PYTZ_BASE_CLASSES)
+
+
+def upgrade_tzinfo(tz):
+    """Convert a ``pytz`` or shim timezone into its modern equivalent.
+
+    The shim classes are thin wrappers around :mod:`zoneinfo` or
+    :mod:`dateutil.tz` implementations of the :class:`datetime.tzinfo` base
+    class. This function removes the shim and returns the underlying "upgraded"
+    time zone.
+
+    When passed a ``pytz`` zone (not a shim), this returns the non-``pytz``
+    equivalent. This may fail if ``pytz`` is using a data source incompatible
+    with the upgraded provider's data source, or if the ``pytz`` zone was built
+    from a file rather than an IANA key.
+
+    When passed an object that is not a shim or a ``pytz`` zone, this returns
+    the original object.
+
+    :param tz:
+        A :class:`datetime.tzinfo` object.
+
+    :raises KeyError:
+        If a ``pytz`` zone is passed to the function with no equivalent in the
+        :pep:`495`-compatible library's version of the Olson database.
+
+    :return:
+        A :pep:`495`-compatible equivalent of any ``pytz`` or shim
+        class, or the original object.
+    """
+    if isinstance(tz, _PytzShimTimezone):
+        return tz._zone
+
+    if is_pytz_zone(tz):
+        if tz.zone is None:
+            # This is a fixed offset zone
+            offset = tz.utcoffset(None)
+            offset_minutes = offset.total_seconds() / 60
+
+            return _compat.get_fixed_offset_zone(offset_minutes)
+
+        if tz.zone == "UTC":
+            return _compat.UTC
+
+        return _compat.get_timezone(tz.zone)
+
+    return tz
+
+
+def _populate_pytz_base_classes():
+    import pytz
+    from pytz.tzinfo import BaseTzInfo
+
+    base_classes = (BaseTzInfo, pytz._FixedOffset)
+
+    # In releases prior to 2018.4, pytz.UTC was not a subclass of BaseTzInfo
+    if not isinstance(pytz.UTC, BaseTzInfo):  # pragma: nocover
+        base_classes = base_classes + (type(pytz.UTC),)
+
+    global _PYTZ_BASE_CLASSES
+    _PYTZ_BASE_CLASSES = base_classes
diff --git a/lib/tzdata/__init__.py b/lib/tzdata/__init__.py
index 07c7b3a2..7e6440bb 100644
--- a/lib/tzdata/__init__.py
+++ b/lib/tzdata/__init__.py
@@ -1,6 +1,6 @@
 # IANA versions like 2020a are not valid PEP 440 identifiers; the recommended
 # way to translate the version is to use YYYY.n where `n` is a 0-based index.
-__version__ = "2021.5"
+__version__ = "2022.1"
 
 # This exposes the original IANA version number.
-IANA_VERSION = "2021e"
+IANA_VERSION = "2022a"
diff --git a/lib/tzdata/zoneinfo/America/Punta_Arenas b/lib/tzdata/zoneinfo/America/Punta_Arenas
index 5c9a20b947f3763da250afdf005bc7f0136ad537..c04210406f7bd23172481db68ae2f7f9dcd8e9d2 100644
GIT binary patch
delta 50
ycmdnVxs!83o}%l2AebHVGyp`;uX%J7L@#70JOH9M#FZc2*#DN9arfj}78?LbULYR;

delta 50
ycmdnVxs!83o}$}-AebHVGyp`;uX%I~L@#70JOH9M#FZc0*#DN9ao6Np78?Lbsvsc%

diff --git a/lib/tzdata/zoneinfo/America/Santiago b/lib/tzdata/zoneinfo/America/Santiago
index 8d6032264b656186dc23df35402b1be0079fd670..cde8dbbf049e1bbeabf3bc757828aa1884e673c6 100644
GIT binary patch
delta 64
zcmZqTYT}xZrg`)~5cC_kyMpN1F;4?P^!%DfVDW_vg$F?V4RPg1H}=c2u<vGI`2T<J
J?#Y{3`~gD+C~yD(

delta 64
zcmZqTYT}xZrg`i?5cC_kyMgH0F;4?P^!%DfVDW_vg$F?V4RPhiHulT1u<v4E`2T<J
JuF0EO`~gFeC~^P*

diff --git a/lib/tzdata/zoneinfo/Asia/Gaza b/lib/tzdata/zoneinfo/Asia/Gaza
index ccc57c9ce120253b6c08e503bd53cfa0cd1aae69..effc4df50f5329f56b8d357e9c117cca031fed62 100644
GIT binary patch
delta 54
zcmX@dd4qF87-QMS@D0oy3_y@rEt@b|kVRs00t?q<O_pFrrpYxdu6*W3I=+SmdM0`%
I`bMT)0GbUA761SM

delta 38
ucmcb?d5&{J7-Q+i@D0q91z8j(>$8MTZe?-hHL=j~H8jvO)ic#M<N^Tn77CXD

diff --git a/lib/tzdata/zoneinfo/Asia/Hebron b/lib/tzdata/zoneinfo/Asia/Hebron
index 906d8d5cbaa60f1540a5e91739a68f79a2f2e238..aa52bd263c4852f465d8bff4ccea233775486a54 100644
GIT binary patch
delta 54
zcmaFB`HFKw7-Pl8@B_>o3_y@rEt@b|kws#10Snh;OO{YZrpbLQu6*W3I=+SmdM0`%
I`bMT)0IN?8kN^Mx

delta 38
ucmaFG`G9jm7-RXy@B_?~6<HJ}+p~mEp3dURYht0}YiOWns%NTi$OQoZfC~Wt

diff --git a/lib/tzdata/zoneinfo/Chile/Continental b/lib/tzdata/zoneinfo/Chile/Continental
index 8d6032264b656186dc23df35402b1be0079fd670..cde8dbbf049e1bbeabf3bc757828aa1884e673c6 100644
GIT binary patch
delta 64
zcmZqTYT}xZrg`)~5cC_kyMpN1F;4?P^!%DfVDW_vg$F?V4RPg1H}=c2u<vGI`2T<J
J?#Y{3`~gD+C~yD(

delta 64
zcmZqTYT}xZrg`i?5cC_kyMgH0F;4?P^!%DfVDW_vg$F?V4RPhiHulT1u<v4E`2T<J
JuF0EO`~gFeC~^P*

diff --git a/lib/tzdata/zoneinfo/Europe/Kiev b/lib/tzdata/zoneinfo/Europe/Kiev
index 8f83cefbcc116a4f5e6c57cb3bf372ef623a06a4..4e026859fdee32dd3f77a25274c5ccbebe0ee554 100644
GIT binary patch
delta 96
zcmZ3=vW{g!7^C{c@ULE1IT{#%K<mg)Fs;4i6`0mpavMzRPB{an^;-6VY5kIQVA>#M
aKA1L)J<R|DMnzjD_c5w7GELsfSO5S)d>Q`$

delta 86
zcmZ3-vXo^)7^B+6@UKo+-Xt&pf!2}p0U%m?%ee#)t+Qk!n6Eo!1DLPZG8xR*FWEBz
WByW(i7EBw)-kdy*QGN10#sUCG#TYXH

diff --git a/lib/tzdata/zoneinfo/Europe/Simferopol b/lib/tzdata/zoneinfo/Europe/Simferopol
index 88a6f3bdb4691ace47a6d670899a9d049ef5a123..40d23c029a647297b4901286652d2db5407d32dd 100644
GIT binary patch
delta 48
tcmaFJ_K<CZ3#0N?js^xG&^q!HOlxm>1*UbD+y>LSQ_eJOPG|hZ2mo;X4?+L{

delta 48
vcmaFJ_K<CZ3#0OtHwg?tpmpSY0EpJ!axMWx>nzy_=Ic(`kgz$O@fRZics&l;

diff --git a/lib/tzdata/zoneinfo/Europe/Uzhgorod b/lib/tzdata/zoneinfo/Europe/Uzhgorod
index a5755685e390bd5ad54402ee61b1319e9a66296e..d4c35914191fa2dd7a3e07105af0d4494681badb 100644
GIT binary patch
delta 96
zcmbQlGMi;W7^B+6@V8!9IT{#%K<mg)Fs;4i6`0mpavMzRPB{an^;-6VY5kIQVA>#M
aKA1L)J<R|DMnzjDw=t?QvQA#Zm<9kZ^clAR

delta 86
zcmbQuGKpnE7^CXM@V8D^-Xt&pf!2}p0U%m?%ee#)t+Qk!n6Eo!1DLPZG8xR*FWEBz
WByW(i7EBw)-kjXWs5W^kV;TTB78mFM

diff --git a/lib/tzdata/zoneinfo/Europe/Zaporozhye b/lib/tzdata/zoneinfo/Europe/Zaporozhye
index 4ea8dae45a6fb896ef39939fa24c168b5351c574..71819a5adde17f48dc381d917a7327f04becaa43 100644
GIT binary patch
delta 96
zcmdnMvXf;(7^B9-@V{PHIT{#%K<mg)Fs;4i6`0mpavMzRPB{an^;-6VY5kIQVA>#M
aKA1L)J<R|DMnzjDPh-?zWSYE>u?PT78yYeI

delta 86
zcmdnVvVmnn7^C{c@V`!1-Xt&pf!2}p0U%m?%ee#)t+Qk!n6Eo!1DLPZG8xR*FWEBz
WByW(i7EBw)-kdy-QDgFP#v%Yx92jN*

diff --git a/lib/tzdata/zoneinfo/leapseconds b/lib/tzdata/zoneinfo/leapseconds
index 834b96ea..ffa5eb80 100644
--- a/lib/tzdata/zoneinfo/leapseconds
+++ b/lib/tzdata/zoneinfo/leapseconds
@@ -72,11 +72,11 @@ Leap	2016	Dec	31	23:59:60	+	S
 # Any additional leap seconds will come after this.
 # This Expires line is commented out for now,
 # so that pre-2020a zic implementations do not reject this file.
-#Expires 2022	Jun	28	00:00:00
+#Expires 2022	Dec	28	00:00:00
 
 # POSIX timestamps for the data in this file:
 #updated 1467936000 (2016-07-08 00:00:00 UTC)
-#expires 1656374400 (2022-06-28 00:00:00 UTC)
+#expires 1672185600 (2022-12-28 00:00:00 UTC)
 
-#	Updated through IERS Bulletin C62
-#	File expires on:  28 June 2022
+#	Updated through IERS Bulletin C63
+#	File expires on:  28 December 2022
diff --git a/lib/tzdata/zoneinfo/tzdata.zi b/lib/tzdata/zoneinfo/tzdata.zi
index 1948c725..c38197ea 100644
--- a/lib/tzdata/zoneinfo/tzdata.zi
+++ b/lib/tzdata/zoneinfo/tzdata.zi
@@ -1,4 +1,4 @@
-# version 2021e
+# version 2022a
 # This zic input file is in the public domain.
 R d 1916 o - Jun 14 23s 1 S
 R d 1916 1919 - O Su>=1 23s 0 -
@@ -1111,9 +1111,10 @@ R P 2016 2018 - Mar Sa>=24 1 1 S
 R P 2016 2018 - O Sa>=24 1 0 -
 R P 2019 o - Mar 29 0 1 S
 R P 2019 o - O Sa>=24 0 0 -
-R P 2020 ma - Mar Sa>=24 0 1 S
+R P 2020 2021 - Mar Sa>=24 0 1 S
 R P 2020 o - O 24 1 0 -
-R P 2021 ma - O lastF 1 0 -
+R P 2021 ma - O F>=23 1 0 -
+R P 2022 ma - Mar Su>=25 0 1 S
 Z Asia/Gaza 2:17:52 - LMT 1900 O
 2 Z EET/EEST 1948 May 15
 2 K EE%sT 1967 Jun 5
@@ -2431,8 +2432,8 @@ Z Europe/Simferopol 2:16:24 - LMT 1880
 1 c CE%sT 1944 Ap 13
 3 R MSK/MSD 1990
 3 - MSK 1990 Jul 1 2
-2 - EET 1992
-2 e EE%sT 1994 May
+2 - EET 1992 Mar 20
+2 c EE%sT 1994 May
 3 e MSK/MSD 1996 Mar 31 0s
 3 1 MSD 1996 O 27 3s
 3 R MSK/MSD 1997
@@ -2787,7 +2788,7 @@ Z Europe/Kiev 2:2:4 - LMT 1880
 1 c CE%sT 1943 N 6
 3 R MSK/MSD 1990 Jul 1 2
 2 1 EEST 1991 S 29 3
-2 e EE%sT 1995
+2 c EE%sT 1996 May 13
 2 E EE%sT
 Z Europe/Uzhgorod 1:29:12 - LMT 1890 O
 1 - CET 1940
@@ -2797,8 +2798,8 @@ Z Europe/Uzhgorod 1:29:12 - LMT 1890 O
 3 R MSK/MSD 1990
 3 - MSK 1990 Jul 1 2
 1 - CET 1991 Mar 31 3
-2 - EET 1992
-2 e EE%sT 1995
+2 - EET 1992 Mar 20
+2 c EE%sT 1996 May 13
 2 E EE%sT
 Z Europe/Zaporozhye 2:20:40 - LMT 1880
 2:20 - +0220 1924 May 2
@@ -2806,7 +2807,8 @@ Z Europe/Zaporozhye 2:20:40 - LMT 1880
 3 - MSK 1941 Au 25
 1 c CE%sT 1943 O 25
 3 R MSK/MSD 1991 Mar 31 2
-2 e EE%sT 1995
+2 e EE%sT 1992 Mar 20
+2 c EE%sT 1996 May 13
 2 E EE%sT
 R u 1918 1919 - Mar lastSu 2 1 D
 R u 1918 1919 - O lastSu 2 0 S
@@ -4088,12 +4090,12 @@ R x 2016 2018 - May Su>=9 3u 0 -
 R x 2016 2018 - Au Su>=9 4u 1 -
 R x 2019 ma - Ap Su>=2 3u 0 -
 R x 2019 ma - S Su>=2 4u 1 -
-Z America/Santiago -4:42:46 - LMT 1890
--4:42:46 - SMT 1910 Ja 10
+Z America/Santiago -4:42:45 - LMT 1890
+-4:42:45 - SMT 1910 Ja 10
 -5 - -05 1916 Jul
--4:42:46 - SMT 1918 S 10
+-4:42:45 - SMT 1918 S 10
 -4 - -04 1919 Jul
--4:42:46 - SMT 1927 S
+-4:42:45 - SMT 1927 S
 -5 x -05/-04 1932 S
 -4 - -04 1942 Jun
 -5 - -05 1942 Au
@@ -4103,11 +4105,11 @@ Z America/Santiago -4:42:46 - LMT 1890
 -5 - -05 1947 May 21 23
 -4 x -04/-03
 Z America/Punta_Arenas -4:43:40 - LMT 1890
--4:42:46 - SMT 1910 Ja 10
+-4:42:45 - SMT 1910 Ja 10
 -5 - -05 1916 Jul
--4:42:46 - SMT 1918 S 10
+-4:42:45 - SMT 1918 S 10
 -4 - -04 1919 Jul
--4:42:46 - SMT 1927 S
+-4:42:45 - SMT 1927 S
 -5 x -05/-04 1932 S
 -4 - -04 1942 Jun
 -5 - -05 1942 Au
diff --git a/lib/tzlocal/__init__.py b/lib/tzlocal/__init__.py
index c8196d66..98ed04fd 100644
--- a/lib/tzlocal/__init__.py
+++ b/lib/tzlocal/__init__.py
@@ -1,5 +1,13 @@
 import sys
-if sys.platform == 'win32':
-    from tzlocal.win32 import get_localzone, reload_localzone
+
+if sys.platform == "win32":
+    from tzlocal.win32 import (
+        get_localzone,
+        get_localzone_name,
+        reload_localzone,
+    )  # pragma: no cover
 else:
-    from tzlocal.unix import get_localzone, reload_localzone
+    from tzlocal.unix import get_localzone, get_localzone_name, reload_localzone
+
+
+__all__ = ["get_localzone", "get_localzone_name", "reload_localzone"]
diff --git a/lib/tzlocal/unix.py b/lib/tzlocal/unix.py
index 8574965a..eaf96d92 100644
--- a/lib/tzlocal/unix.py
+++ b/lib/tzlocal/unix.py
@@ -1,97 +1,75 @@
 import os
-import pytz
 import re
+import sys
 import warnings
+from datetime import timezone
+import pytz_deprecation_shim as pds
 
 from tzlocal import utils
 
+if sys.version_info >= (3, 9):
+    from zoneinfo import ZoneInfo  # pragma: no cover
+else:
+    from backports.zoneinfo import ZoneInfo  # pragma: no cover
+
 _cache_tz = None
+_cache_tz_name = None
 
 
-def _tz_from_env(tzenv):
-    if tzenv[0] == ':':
-        tzenv = tzenv[1:]
-
-    # TZ specifies a file
-    if os.path.isabs(tzenv) and os.path.exists(tzenv):
-        with open(tzenv, 'rb') as tzfile:
-            return pytz.tzfile.build_tzinfo('local', tzfile)
-
-    # TZ specifies a zoneinfo zone.
-    try:
-        tz = pytz.timezone(tzenv)
-        # That worked, so we return this:
-        return tz
-    except pytz.UnknownTimeZoneError:
-        raise pytz.UnknownTimeZoneError(
-            "tzlocal() does not support non-zoneinfo timezones like %s. \n"
-            "Please use a timezone in the form of Continent/City")
-
-
-def _try_tz_from_env():
-    tzenv = os.environ.get('TZ')
-    if tzenv:
-        try:
-            return _tz_from_env(tzenv)
-        except pytz.UnknownTimeZoneError:
-            pass
-
-
-def _get_localzone(_root='/'):
+def _get_localzone_name(_root="/"):
     """Tries to find the local timezone configuration.
 
-    This method prefers finding the timezone name and passing that to pytz,
-    over passing in the localtime file, as in the later case the zoneinfo
-    name is unknown.
+    This method finds the timezone name, if it can, or it returns None.
 
     The parameter _root makes the function look for files like /etc/localtime
     beneath the _root directory. This is primarily used by the tests.
     In normal usage you call the function without parameters."""
 
-    tzenv = _try_tz_from_env()
+    # First try the ENV setting.
+    tzenv = utils._tz_name_from_env()
     if tzenv:
         return tzenv
 
     # Are we under Termux on Android?
-    if os.path.exists('/system/bin/getprop'):
+    if os.path.exists(os.path.join(_root, "system/bin/getprop")):
         import subprocess
-        androidtz = subprocess.check_output(['getprop', 'persist.sys.timezone']).strip().decode()
-        return pytz.timezone(androidtz)
+
+        androidtz = (
+            subprocess.check_output(["getprop", "persist.sys.timezone"])
+            .strip()
+            .decode()
+        )
+        return androidtz
 
     # Now look for distribution specific configuration files
     # that contain the timezone name.
-    for configfile in ('etc/timezone', 'var/db/zoneinfo'):
+
+    # Stick all of them in a dict, to compare later.
+    found_configs = {}
+
+    for configfile in ("etc/timezone", "var/db/zoneinfo"):
         tzpath = os.path.join(_root, configfile)
         try:
-            with open(tzpath, 'rb') as tzfile:
+            with open(tzpath, "rt") as tzfile:
                 data = tzfile.read()
 
-                # Issue #3 was that /etc/timezone was a zoneinfo file.
-                # That's a misconfiguration, but we need to handle it gracefully:
-                if data[:5] == b'TZif2':
-                    continue
-
-                etctz = data.strip().decode()
+                etctz = data.strip('/ \t\r\n')
                 if not etctz:
                     # Empty file, skip
                     continue
-                for etctz in data.decode().splitlines():
+                for etctz in etctz.splitlines():
                     # Get rid of host definitions and comments:
-                    if ' ' in etctz:
-                        etctz, dummy = etctz.split(' ', 1)
-                    if '#' in etctz:
-                        etctz, dummy = etctz.split('#', 1)
+                    if " " in etctz:
+                        etctz, dummy = etctz.split(" ", 1)
+                    if "#" in etctz:
+                        etctz, dummy = etctz.split("#", 1)
                     if not etctz:
                         continue
-                    tz = pytz.timezone(etctz.replace(' ', '_'))
-                    if _root == '/':
-                        # We are using a file in etc to name the timezone.
-                        # Verify that the timezone specified there is actually used:
-                        utils.assert_tz_offset(tz)
-                    return tz
 
-        except IOError:
-            # File doesn't exist or is a directory
+                    found_configs[tzpath] = etctz.replace(" ", "_")
+
+        except (IOError, UnicodeDecodeError):
+            # File doesn't exist or is a directory, or it's a binary file.
             continue
 
     # CentOS has a ZONE setting in /etc/sysconfig/clock,
@@ -99,14 +77,14 @@ def _get_localzone(_root='/'):
     # Gentoo has a TIMEZONE setting in /etc/conf.d/clock
     # We look through these files for a timezone:
 
-    zone_re = re.compile(r'\s*ZONE\s*=\s*\"')
-    timezone_re = re.compile(r'\s*TIMEZONE\s*=\s*\"')
-    end_re = re.compile('\"')
+    zone_re = re.compile(r"\s*ZONE\s*=\s*\"")
+    timezone_re = re.compile(r"\s*TIMEZONE\s*=\s*\"")
+    end_re = re.compile('"')
 
-    for filename in ('etc/sysconfig/clock', 'etc/conf.d/clock'):
+    for filename in ("etc/sysconfig/clock", "etc/conf.d/clock"):
         tzpath = os.path.join(_root, filename)
         try:
-            with open(tzpath, 'rt') as tzfile:
+            with open(tzpath, "rt") as tzfile:
                 data = tzfile.readlines()
 
             for line in data:
@@ -118,48 +96,108 @@ def _get_localzone(_root='/'):
                 if match is not None:
                     # Some setting existed
                     line = line[match.end():]
-                    etctz = line[:end_re.search(line).start()]
+                    etctz = line[: end_re.search(line).start()]
 
                     # We found a timezone
-                    tz = pytz.timezone(etctz.replace(' ', '_'))
-                    if _root == '/':
-                        # We are using a file in etc to name the timezone.
-                        # Verify that the timezone specified there is actually used:
-                        utils.assert_tz_offset(tz)
-                    return tz
+                    found_configs[tzpath] = etctz.replace(" ", "_")
 
-        except IOError:
-            # File doesn't exist or is a directory
+        except (IOError, UnicodeDecodeError):
+            # UnicodeDecode handles when clock is symlink to /etc/localtime
             continue
 
     # systemd distributions use symlinks that include the zone name,
     # see manpage of localtime(5) and timedatectl(1)
-    tzpath = os.path.join(_root, 'etc/localtime')
+    tzpath = os.path.join(_root, "etc/localtime")
     if os.path.exists(tzpath) and os.path.islink(tzpath):
-        tzpath = os.path.realpath(tzpath)
-        start = tzpath.find("/")+1
+        etctz = realtzpath = os.path.realpath(tzpath)
+        start = etctz.find("/") + 1
         while start != 0:
-            tzpath = tzpath[start:]
+            etctz = etctz[start:]
             try:
-                return pytz.timezone(tzpath)
-            except pytz.UnknownTimeZoneError:
+                pds.timezone(etctz)
+                tzinfo = f"{tzpath} is a symlink to"
+                found_configs[tzinfo] = etctz.replace(" ", "_")
+            except pds.UnknownTimeZoneError:
                 pass
-            start = tzpath.find("/")+1
+            start = etctz.find("/") + 1
 
-    # No explicit setting existed. Use localtime
-    for filename in ('etc/localtime', 'usr/local/etc/localtime'):
-        tzpath = os.path.join(_root, filename)
+    if len(found_configs) > 0:
+        # We found some explicit config of some sort!
+        if len(found_configs) > 1:
+            # Uh-oh, multiple configs. See if they match:
+            unique_tzs = set()
+            zoneinfo = os.path.join(_root, "usr", "share", "zoneinfo")
+            directory_depth = len(zoneinfo.split(os.path.sep))
 
-        if not os.path.exists(tzpath):
-            continue
-        with open(tzpath, 'rb') as tzfile:
-            return pytz.tzfile.build_tzinfo('local', tzfile)
+            for tzname in found_configs.values():
+                # Look them up in /usr/share/zoneinfo, and find what they
+                # really point to:
+                path = os.path.realpath(os.path.join(zoneinfo, *tzname.split("/")))
+                real_zone_name = "/".join(path.split(os.path.sep)[directory_depth:])
+                unique_tzs.add(real_zone_name)
+
+            if len(unique_tzs) != 1:
+                message = "Multiple conflicting time zone configurations found:\n"
+                for key, value in found_configs.items():
+                    message += f"{key}: {value}\n"
+                message += "Fix the configuration, or set the time zone in a TZ environment variable.\n"
+                raise utils.ZoneInfoNotFoundError(message)
+
+        # We found exactly one config! Use it.
+        return list(found_configs.values())[0]
+
+
+def _get_localzone(_root="/"):
+    """Creates a timezone object from the timezone name.
+
+    If there is no timezone config, it will try to create a file from the
+    localtime timezone, and if there isn't one, it will default to UTC.
+
+    The parameter _root makes the function look for files like /etc/localtime
+    beneath the _root directory. This is primarily used by the tests.
+    In normal usage you call the function without parameters."""
+
+    # First try the ENV setting.
+    tzenv = utils._tz_from_env()
+    if tzenv:
+        return tzenv
+
+    tzname = _get_localzone_name(_root)
+    if tzname is None:
+        # No explicit setting existed. Use localtime
+        for filename in ("etc/localtime", "usr/local/etc/localtime"):
+            tzpath = os.path.join(_root, filename)
+
+            if not os.path.exists(tzpath):
+                continue
+            with open(tzpath, "rb") as tzfile:
+                tz = pds.wrap_zone(ZoneInfo.from_file(tzfile, key="local"))
+                break
+        else:
+            warnings.warn("Can not find any timezone configuration, defaulting to UTC.")
+            tz = timezone.utc
+    else:
+        tz = pds.timezone(tzname)
+
+    if _root == "/":
+        # We are using a file in etc to name the timezone.
+        # Verify that the timezone specified there is actually used:
+        utils.assert_tz_offset(tz)
+    return tz
+
+
+def get_localzone_name():
+    """Get the computers configured local timezone name, if any."""
+    global _cache_tz_name
+    if _cache_tz_name is None:
+        _cache_tz_name = _get_localzone_name()
+
+    return _cache_tz_name
 
-    warnings.warn('Can not find any timezone configuration, defaulting to UTC.')
-    return pytz.utc
 
 def get_localzone():
     """Get the computers configured local timezone, if any."""
+
     global _cache_tz
     if _cache_tz is None:
         _cache_tz = _get_localzone()
@@ -169,6 +207,9 @@ def get_localzone():
 
 def reload_localzone():
     """Reload the cached localzone. You need to call this if the timezone has changed."""
+    global _cache_tz_name
     global _cache_tz
+    _cache_tz_name = _get_localzone_name()
     _cache_tz = _get_localzone()
+
     return _cache_tz
diff --git a/lib/tzlocal/utils.py b/lib/tzlocal/utils.py
index 5a677990..d1026b32 100644
--- a/lib/tzlocal/utils.py
+++ b/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
diff --git a/lib/tzlocal/win32.py b/lib/tzlocal/win32.py
index fcc42a23..720ab2b7 100644
--- a/lib/tzlocal/win32.py
+++ b/lib/tzlocal/win32.py
@@ -1,32 +1,53 @@
+from datetime import datetime
+import pytz_deprecation_shim as pds
+
 try:
     import _winreg as winreg
 except ImportError:
     import winreg
 
-import pytz
-
 from tzlocal.windows_tz import win_tz
 from tzlocal import utils
 
 _cache_tz = None
+_cache_tz_name = None
 
 
 def valuestodict(key):
     """Convert a registry key's values to a dictionary."""
-    dict = {}
+    result = {}
     size = winreg.QueryInfoKey(key)[1]
     for i in range(size):
         data = winreg.EnumValue(key, i)
-        dict[data[0]] = data[1]
-    return dict
+        result[data[0]] = data[1]
+    return result
 
 
-def get_localzone_name():
+def _get_dst_info(tz):
+    # Find the offset for when it doesn't have DST:
+    dst_offset = std_offset = None
+    has_dst = False
+    year = datetime.now().year
+    for dt in (datetime(year, 1, 1), datetime(year, 6, 1)):
+        if tz.dst(dt).total_seconds() == 0.0:
+            # OK, no DST during winter, get this offset
+            std_offset = tz.utcoffset(dt).total_seconds()
+        else:
+            has_dst = True
+
+    return has_dst, std_offset, dst_offset
+
+
+def _get_localzone_name():
     # Windows is special. It has unique time zone names (in several
     # meanings of the word) available, but unfortunately, they can be
     # translated to the language of the operating system, so we need to
     # do a backwards lookup, by going through all time zones and see which
     # one matches.
+    tzenv = utils._tz_name_from_env()
+    if tzenv:
+        return tzenv
+
     handle = winreg.ConnectRegistry(None, winreg.HKEY_LOCAL_MACHINE)
 
     TZLOCALKEYNAME = r"SYSTEM\CurrentControlSet\Control\TimeZoneInformation"
@@ -34,44 +55,16 @@ def get_localzone_name():
     keyvalues = valuestodict(localtz)
     localtz.Close()
 
-    if 'TimeZoneKeyName' in keyvalues:
-        # Windows 7 (and Vista?)
+    if "TimeZoneKeyName" in keyvalues:
+        # Windows 7 and later
 
         # For some reason this returns a string with loads of NUL bytes at
         # least on some systems. I don't know if this is a bug somewhere, I
         # just work around it.
-        tzkeyname = keyvalues['TimeZoneKeyName'].split('\x00', 1)[0]
+        tzkeyname = keyvalues["TimeZoneKeyName"].split("\x00", 1)[0]
     else:
-        # Windows 2000 or XP
-
-        # This is the localized name:
-        tzwin = keyvalues['StandardName']
-
-        # Open the list of timezones to look up the real name:
-        TZKEYNAME = r"SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones"
-        tzkey = winreg.OpenKey(handle, TZKEYNAME)
-
-        # Now, match this value to Time Zone information
-        tzkeyname = None
-        for i in range(winreg.QueryInfoKey(tzkey)[0]):
-            subkey = winreg.EnumKey(tzkey, i)
-            sub = winreg.OpenKey(tzkey, subkey)
-            data = valuestodict(sub)
-            sub.Close()
-            try:
-                if data['Std'] == tzwin:
-                    tzkeyname = subkey
-                    break
-            except KeyError:
-                # This timezone didn't have proper configuration.
-                # Ignore it.
-                pass
-
-        tzkey.Close()
-        handle.Close()
-
-    if tzkeyname is None:
-        raise LookupError('Can not find Windows timezone configuration')
+        # Don't support XP any longer
+        raise LookupError("Can not find Windows timezone configuration")
 
     timezone = win_tz.get(tzkeyname)
     if timezone is None:
@@ -81,24 +74,64 @@ def get_localzone_name():
 
     # Return what we have.
     if timezone is None:
-        raise pytz.UnknownTimeZoneError('Can not find timezone ' + tzkeyname)
+        raise utils.ZoneInfoNotFoundError(tzkeyname)
+
+    if keyvalues.get("DynamicDaylightTimeDisabled", 0) == 1:
+        # DST is disabled, so don't return the timezone name,
+        # instead return Etc/GMT+offset
+
+        tz = pds.timezone(timezone)
+        has_dst, std_offset, dst_offset = _get_dst_info(tz)
+        if not has_dst:
+            # The DST is turned off in the windows configuration,
+            # but this timezone doesn't have DST so it doesn't matter
+            return timezone
+
+        if std_offset is None:
+            raise utils.ZoneInfoNotFoundError(
+                f"{tzkeyname} claims to not have a non-DST time!?")
+
+        if std_offset % 3600:
+            # I can't convert this to an hourly offset
+            raise utils.ZoneInfoNotFoundError(
+                f"tzlocal can't support disabling DST in the {timezone} zone.")
+
+        # This has whole hours as offset, return it as Etc/GMT
+        return f"Etc/GMT{-std_offset//3600:+.0f}"
 
     return timezone
 
 
+def get_localzone_name():
+    """Get the zoneinfo timezone name that matches the Windows-configured timezone."""
+    global _cache_tz_name
+    if _cache_tz_name is None:
+        _cache_tz_name = _get_localzone_name()
+
+    return _cache_tz_name
+
+
 def get_localzone():
     """Returns the zoneinfo-based tzinfo object that matches the Windows-configured timezone."""
+
     global _cache_tz
     if _cache_tz is None:
-        _cache_tz = pytz.timezone(get_localzone_name())
+        _cache_tz = pds.timezone(get_localzone_name())
+
+    if not utils._tz_name_from_env():
+        # If the timezone does NOT come from a TZ environment variable,
+        # verify that it's correct. If it's from the environment,
+        # we accept it, this is so you can run tests with different timezones.
+        utils.assert_tz_offset(_cache_tz)
 
-    utils.assert_tz_offset(_cache_tz)
     return _cache_tz
 
 
 def reload_localzone():
     """Reload the cached localzone. You need to call this if the timezone has changed."""
     global _cache_tz
-    _cache_tz = pytz.timezone(get_localzone_name())
+    global _cache_tz_name
+    _cache_tz_name = _get_localzone_name()
+    _cache_tz = pds.timezone(_cache_tz_name)
     utils.assert_tz_offset(_cache_tz)
     return _cache_tz
diff --git a/lib/tzlocal/windows_tz.py b/lib/tzlocal/windows_tz.py
index 86ba807d..0d285037 100644
--- a/lib/tzlocal/windows_tz.py
+++ b/lib/tzlocal/windows_tz.py
@@ -104,6 +104,7 @@ win_tz = {'AUS Central Standard Time': 'Australia/Darwin',
  'Saratov Standard Time': 'Europe/Saratov',
  'Singapore Standard Time': 'Asia/Singapore',
  'South Africa Standard Time': 'Africa/Johannesburg',
+ 'South Sudan Standard Time': 'Africa/Juba',
  'Sri Lanka Standard Time': 'Asia/Colombo',
  'Sudan Standard Time': 'Africa/Khartoum',
  'Syria Standard Time': 'Asia/Damascus',
@@ -118,7 +119,7 @@ win_tz = {'AUS Central Standard Time': 'Australia/Darwin',
  'Turks And Caicos Standard Time': 'America/Grand_Turk',
  'US Eastern Standard Time': 'America/Indianapolis',
  'US Mountain Standard Time': 'America/Phoenix',
- 'UTC': 'Etc/GMT',
+ 'UTC': 'Etc/UTC',
  'UTC+12': 'Etc/GMT-12',
  'UTC+13': 'Etc/GMT-13',
  'UTC-02': 'Etc/GMT+2',
@@ -136,7 +137,8 @@ win_tz = {'AUS Central Standard Time': 'Australia/Darwin',
  'West Asia Standard Time': 'Asia/Tashkent',
  'West Bank Standard Time': 'Asia/Hebron',
  'West Pacific Standard Time': 'Pacific/Port_Moresby',
- 'Yakutsk Standard Time': 'Asia/Yakutsk'}
+ 'Yakutsk Standard Time': 'Asia/Yakutsk',
+ 'Yukon Standard Time': 'America/Whitehorse'}
 
 # Old name for the win_tz variable:
 tz_names = win_tz
@@ -166,7 +168,7 @@ tz_win = {'Africa/Abidjan': 'Greenwich Standard Time',
  'Africa/Gaborone': 'South Africa Standard Time',
  'Africa/Harare': 'South Africa Standard Time',
  'Africa/Johannesburg': 'South Africa Standard Time',
- 'Africa/Juba': 'E. Africa Standard Time',
+ 'Africa/Juba': 'South Sudan Standard Time',
  'Africa/Kampala': 'E. Africa Standard Time',
  'Africa/Khartoum': 'Sudan Standard Time',
  'Africa/Kigali': 'South Africa Standard Time',
@@ -234,8 +236,8 @@ tz_win = {'Africa/Abidjan': 'Greenwich Standard Time',
  'America/Creston': 'US Mountain Standard Time',
  'America/Cuiaba': 'Central Brazilian Standard Time',
  'America/Curacao': 'SA Western Standard Time',
- 'America/Danmarkshavn': 'UTC',
- 'America/Dawson': 'Pacific Standard Time',
+ 'America/Danmarkshavn': 'Greenwich Standard Time',
+ 'America/Dawson': 'Yukon Standard Time',
  'America/Dawson_Creek': 'US Mountain Standard Time',
  'America/Denver': 'Mountain Standard Time',
  'America/Detroit': 'Eastern Standard Time',
@@ -345,14 +347,14 @@ tz_win = {'Africa/Abidjan': 'Greenwich Standard Time',
  'America/Tortola': 'SA Western Standard Time',
  'America/Vancouver': 'Pacific Standard Time',
  'America/Virgin': 'SA Western Standard Time',
- 'America/Whitehorse': 'Pacific Standard Time',
+ 'America/Whitehorse': 'Yukon Standard Time',
  'America/Winnipeg': 'Central Standard Time',
  'America/Yakutat': 'Alaskan Standard Time',
  'America/Yellowknife': 'Mountain Standard Time',
- 'Antarctica/Casey': 'Singapore Standard Time',
+ 'Antarctica/Casey': 'Central Pacific Standard Time',
  'Antarctica/Davis': 'SE Asia Standard Time',
  'Antarctica/DumontDUrville': 'West Pacific Standard Time',
- 'Antarctica/Macquarie': 'Central Pacific Standard Time',
+ 'Antarctica/Macquarie': 'Tasmania Standard Time',
  'Antarctica/Mawson': 'West Asia Standard Time',
  'Antarctica/McMurdo': 'New Zealand Standard Time',
  'Antarctica/Palmer': 'SA Eastern Standard Time',
@@ -501,7 +503,7 @@ tz_win = {'Africa/Abidjan': 'Greenwich Standard Time',
  'Canada/Newfoundland': 'Newfoundland Standard Time',
  'Canada/Pacific': 'Pacific Standard Time',
  'Canada/Saskatchewan': 'Canada Central Standard Time',
- 'Canada/Yukon': 'Pacific Standard Time',
+ 'Canada/Yukon': 'Yukon Standard Time',
  'Chile/Continental': 'Pacific SA Standard Time',
  'Chile/EasterIsland': 'Easter Island Standard Time',
  'Cuba': 'Cuba Standard Time',
diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index c7d7245e..5acd462f 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -1,4 +1,4 @@
-apscheduler==3.8.0
+apscheduler==3.9.1
 importlib-resources==5.6.0
 pyinstaller==4.9
 pyopenssl==22.0.0
diff --git a/requirements.txt b/requirements.txt
index d433889a..12ec6726 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,5 +1,5 @@
 appdirs==1.4.4
-apscheduler==3.8.0
+apscheduler==3.9.1
 arrow==1.2.2
 backports.csv==1.0.7
 backports.functools-lru-cache==1.6.4
@@ -33,7 +33,7 @@ PyJWT==2.3.0
 pyparsing==3.0.7
 python-dateutil==2.8.2
 python-twitter==3.5
-pytz==2021.3
+pytz==2022.1
 requests==2.27.1
 requests-oauthlib==1.3.1
 rumps==0.3.0; platform_system == "Darwin"
@@ -42,8 +42,8 @@ six==1.16.0
 soupsieve==2.3.1
 tempora==5.0.1
 tokenize-rt==4.2.1
-tzdata==2021.5
-tzlocal==2.1  # apscheduler==3.8.0 requires tzlocal~=2.0
+tzdata==2022.1
+tzlocal==4.2
 urllib3==1.26.8
 webencodings==0.5.1
 websocket-client==1.2.3

From aa0c58ef0e92915c88803f9f5ac533485a893832 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 16 May 2022 20:33:29 -0700
Subject: [PATCH 076/743] Bump dnspython from 2.2.0 to 2.2.1 (#1679)

* Bump dnspython from 2.2.0 to 2.2.1

Bumps [dnspython](https://github.com/rthalley/dnspython) from 2.2.0 to 2.2.1.
- [Release notes](https://github.com/rthalley/dnspython/releases)
- [Changelog](https://github.com/rthalley/dnspython/blob/master/doc/whatsnew.rst)
- [Commits](https://github.com/rthalley/dnspython/compare/v2.2.0...v2.2.1)

---
updated-dependencies:
- dependency-name: dnspython
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

* Update dnspython==2.2.1

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/dns/_immutable_attr.py      |  2 +-
 lib/dns/asyncquery.pyi          |  6 +++---
 lib/dns/dnssec.py               |  2 +-
 lib/dns/exception.py            |  2 +-
 lib/dns/exception.pyi           |  2 ++
 lib/dns/message.py              |  2 +-
 lib/dns/query.py                |  4 ++--
 lib/dns/rdata.py                |  2 +-
 lib/dns/rdataset.py             |  2 +-
 lib/dns/rdtypes/ANY/TKEY.py     |  2 +-
 lib/dns/rdtypes/ANY/__init__.py |  4 ++++
 lib/dns/rdtypes/svcbbase.py     |  2 +-
 lib/dns/rdtypes/txtbase.pyi     |  8 +++++++-
 lib/dns/renderer.py             |  4 ++--
 lib/dns/resolver.py             | 10 +++++-----
 lib/dns/resolver.pyi            |  7 ++++++-
 lib/dns/tokenizer.py            |  7 ++++++-
 lib/dns/transaction.py          | 13 +++++++++++--
 lib/dns/tsigkeyring.py          |  1 +
 lib/dns/version.py              |  2 +-
 lib/dns/versioned.py            |  2 +-
 lib/dns/zone.py                 | 30 ++++++++++++++++++++++++++++--
 requirements.txt                |  2 +-
 23 files changed, 88 insertions(+), 30 deletions(-)

diff --git a/lib/dns/_immutable_attr.py b/lib/dns/_immutable_attr.py
index f7b9f8b0..4d89be90 100644
--- a/lib/dns/_immutable_attr.py
+++ b/lib/dns/_immutable_attr.py
@@ -49,7 +49,7 @@ def _immutable_init(f):
             f(*args, **kwargs)
         finally:
             if not previous:
-                # If we started the initialzation, establish immutability
+                # If we started the initialization, establish immutability
                 # by removing the attribute that allows mutation
                 object.__delattr__(args[0], '_immutable_init')
     nf.__signature__ = inspect.signature(f)
diff --git a/lib/dns/asyncquery.pyi b/lib/dns/asyncquery.pyi
index 21ef60dd..a03434c2 100644
--- a/lib/dns/asyncquery.pyi
+++ b/lib/dns/asyncquery.pyi
@@ -19,7 +19,7 @@ async def udp(q : message.Message, where : str,
               one_rr_per_rrset : Optional[bool] = False,
               ignore_trailing : Optional[bool] = False,
               sock : Optional[asyncbackend.DatagramSocket] = None,
-              backend : Optional[asyncbackend.Backend]) -> message.Message:
+              backend : Optional[asyncbackend.Backend] = None) -> message.Message:
     pass
 
 async def tcp(q : message.Message, where : str, timeout : float = None, port=53,
@@ -28,7 +28,7 @@ async def tcp(q : message.Message, where : str, timeout : float = None, port=53,
         one_rr_per_rrset : Optional[bool] = False,
         ignore_trailing : Optional[bool] = False,
         sock : Optional[asyncbackend.StreamSocket] = None,
-        backend : Optional[asyncbackend.Backend]) -> message.Message:
+        backend : Optional[asyncbackend.Backend] = None) -> message.Message:
     pass
 
 async def tls(q : message.Message, where : str,
@@ -37,7 +37,7 @@ async def tls(q : message.Message, where : str,
               one_rr_per_rrset : Optional[bool] = False,
               ignore_trailing : Optional[bool] = False,
               sock : Optional[asyncbackend.StreamSocket] = None,
-              backend : Optional[asyncbackend.Backend],
+              backend : Optional[asyncbackend.Backend] = None,
               ssl_context: Optional[ssl.SSLContext] = None,
               server_hostname: Optional[str] = None) -> message.Message:
     pass
diff --git a/lib/dns/dnssec.py b/lib/dns/dnssec.py
index 6e9946f4..dee4e618 100644
--- a/lib/dns/dnssec.py
+++ b/lib/dns/dnssec.py
@@ -108,7 +108,7 @@ def key_id(key):
         return total & 0xffff
 
 class DSDigest(dns.enum.IntEnum):
-    """DNSSEC Delgation Signer Digest Algorithm"""
+    """DNSSEC Delegation Signer Digest Algorithm"""
 
     SHA1 = 1
     SHA256 = 2
diff --git a/lib/dns/exception.py b/lib/dns/exception.py
index 93923734..08393821 100644
--- a/lib/dns/exception.py
+++ b/lib/dns/exception.py
@@ -125,7 +125,7 @@ class TooBig(DNSException):
 class Timeout(DNSException):
     """The DNS operation timed out."""
     supp_kwargs = {'timeout'}
-    fmt = "The DNS operation timed out after {timeout} seconds"
+    fmt = "The DNS operation timed out after {timeout:.3f} seconds"
 
 
 class ExceptionWrapper:
diff --git a/lib/dns/exception.pyi b/lib/dns/exception.pyi
index b29bfbea..dc571264 100644
--- a/lib/dns/exception.pyi
+++ b/lib/dns/exception.pyi
@@ -8,3 +8,5 @@ class DNSException(Exception):
 class SyntaxError(DNSException): ...
 class FormError(DNSException): ...
 class Timeout(DNSException): ...
+class TooBig(DNSException): ...
+class UnexpectedEnd(SyntaxError): ...
diff --git a/lib/dns/message.py b/lib/dns/message.py
index 1e67a17b..c2751a90 100644
--- a/lib/dns/message.py
+++ b/lib/dns/message.py
@@ -509,7 +509,7 @@ class Message:
         expected to return a key.
 
         *keyname*, a ``dns.name.Name``, ``str`` or ``None``, the name of
-        thes TSIG key to use; defaults to ``None``.  If *keyring* is a
+        this TSIG key to use; defaults to ``None``.  If *keyring* is a
         ``dict``, the key must be defined in it.  If *keyring* is a
         ``dns.tsig.Key``, this is ignored.
 
diff --git a/lib/dns/query.py b/lib/dns/query.py
index fbf76d8b..6d924b5f 100644
--- a/lib/dns/query.py
+++ b/lib/dns/query.py
@@ -1085,10 +1085,10 @@ def inbound_xfr(where, txn_manager, query=None,
 
     *udp_mode*, a ``dns.query.UDPMode``, determines how UDP is used
     for IXFRs.  The default is ``dns.UDPMode.NEVER``, i.e. only use
-    TCP.  Other possibilites are ``dns.UDPMode.TRY_FIRST``, which
+    TCP.  Other possibilities are ``dns.UDPMode.TRY_FIRST``, which
     means "try UDP but fallback to TCP if needed", and
     ``dns.UDPMode.ONLY``, which means "try UDP and raise
-    ``dns.xfr.UseTCP`` if it does not succeeed.
+    ``dns.xfr.UseTCP`` if it does not succeed.
 
     Raises on errors.
     """
diff --git a/lib/dns/rdata.py b/lib/dns/rdata.py
index 624063e0..6b5b5c5a 100644
--- a/lib/dns/rdata.py
+++ b/lib/dns/rdata.py
@@ -557,7 +557,7 @@ class GenericRdata(Rdata):
             raise dns.exception.SyntaxError(
                 r'generic rdata does not start with \#')
         length = tok.get_int()
-        hex = tok.concatenate_remaining_identifiers().encode()
+        hex = tok.concatenate_remaining_identifiers(True).encode()
         data = binascii.unhexlify(hex)
         if len(data) != length:
             raise dns.exception.SyntaxError(
diff --git a/lib/dns/rdataset.py b/lib/dns/rdataset.py
index e69ee232..579bc964 100644
--- a/lib/dns/rdataset.py
+++ b/lib/dns/rdataset.py
@@ -312,7 +312,7 @@ class Rdataset(dns.set.Set):
     def processing_order(self):
         """Return rdatas in a valid processing order according to the type's
         specification.  For example, MX records are in preference order from
-        lowest to highest preferences, with items of the same perference
+        lowest to highest preferences, with items of the same preference
         shuffled.
 
         For types that do not define a processing order, the rdatas are
diff --git a/lib/dns/rdtypes/ANY/TKEY.py b/lib/dns/rdtypes/ANY/TKEY.py
index f8c47372..861fc4e3 100644
--- a/lib/dns/rdtypes/ANY/TKEY.py
+++ b/lib/dns/rdtypes/ANY/TKEY.py
@@ -63,7 +63,7 @@ class TKEY(dns.rdata.Rdata):
         error = tok.get_uint16()
         key_b64 = tok.get_string().encode()
         key = base64.b64decode(key_b64)
-        other_b64 = tok.concatenate_remaining_identifiers().encode()
+        other_b64 = tok.concatenate_remaining_identifiers(True).encode()
         other = base64.b64decode(other_b64)
 
         return cls(rdclass, rdtype, algorithm, inception, expiration, mode,
diff --git a/lib/dns/rdtypes/ANY/__init__.py b/lib/dns/rdtypes/ANY/__init__.py
index 6c56baff..2cadcde3 100644
--- a/lib/dns/rdtypes/ANY/__init__.py
+++ b/lib/dns/rdtypes/ANY/__init__.py
@@ -37,8 +37,12 @@ __all__ = [
     'HINFO',
     'HIP',
     'ISDN',
+    'L32',
+    'L64',
     'LOC',
+    'LP',
     'MX',
+    'NID',
     'NINFO',
     'NS',
     'NSEC',
diff --git a/lib/dns/rdtypes/svcbbase.py b/lib/dns/rdtypes/svcbbase.py
index 09d7a52b..3362571c 100644
--- a/lib/dns/rdtypes/svcbbase.py
+++ b/lib/dns/rdtypes/svcbbase.py
@@ -435,7 +435,7 @@ class SVCBBase(dns.rdata.Rdata):
             if not isinstance(v, Param) and v is not None:
                 raise ValueError("not a Param")
         self.params = dns.immutable.Dict(params)
-        # Make sure any paramater listed as mandatory is present in the
+        # Make sure any parameter listed as mandatory is present in the
         # record.
         mandatory = params.get(ParamKey.MANDATORY)
         if mandatory:
diff --git a/lib/dns/rdtypes/txtbase.pyi b/lib/dns/rdtypes/txtbase.pyi
index af447d50..f8d5df98 100644
--- a/lib/dns/rdtypes/txtbase.pyi
+++ b/lib/dns/rdtypes/txtbase.pyi
@@ -1,6 +1,12 @@
+import typing
 from .. import rdata
 
 class TXTBase(rdata.Rdata):
-    ...
+    strings: typing.Tuple[bytes, ...]
+
+    def __init__(self, rdclass: int, rdtype: int, strings: typing.Iterable[bytes]) -> None:
+        ...
+    def to_text(self, origin: typing.Any, relativize: bool, **kw: typing.Any) -> str:
+        ...
 class TXT(TXTBase):
     ...
diff --git a/lib/dns/renderer.py b/lib/dns/renderer.py
index 72f0f7a8..4e4391cd 100644
--- a/lib/dns/renderer.py
+++ b/lib/dns/renderer.py
@@ -49,8 +49,8 @@ class Renderer:
         r.add_rrset(dns.renderer.ANSWER, rrset_2)
         r.add_rrset(dns.renderer.AUTHORITY, ns_rrset)
         r.add_edns(0, 0, 4096)
-        r.add_rrset(dns.renderer.ADDTIONAL, ad_rrset_1)
-        r.add_rrset(dns.renderer.ADDTIONAL, ad_rrset_2)
+        r.add_rrset(dns.renderer.ADDITIONAL, ad_rrset_1)
+        r.add_rrset(dns.renderer.ADDITIONAL, ad_rrset_2)
         r.write_header()
         r.add_tsig(keyname, secret, 300, 1, 0, '', request_mac)
         wire = r.get_wire()
diff --git a/lib/dns/resolver.py b/lib/dns/resolver.py
index 166f8492..7da7a613 100644
--- a/lib/dns/resolver.py
+++ b/lib/dns/resolver.py
@@ -145,7 +145,7 @@ class LifetimeTimeout(dns.exception.Timeout):
     """The resolution lifetime expired."""
 
     msg = "The resolution lifetime expired."
-    fmt = "%s after {timeout} seconds: {errors}" % msg[:-1]
+    fmt = "%s after {timeout:.3f} seconds: {errors}" % msg[:-1]
     supp_kwargs = {'timeout', 'errors'}
 
     def _fmt_kwargs(self, **kwargs):
@@ -1018,7 +1018,7 @@ class Resolver(BaseResolver):
         *source_port*, an ``int``, the port from which to send the message.
 
         *lifetime*, a ``float``, how many seconds a query should run
-         before timing out.
+        before timing out.
 
         *search*, a ``bool`` or ``None``, determines whether the
         search list configured in the system's resolver configuration
@@ -1101,7 +1101,7 @@ class Resolver(BaseResolver):
         """Query nameservers to find the answer to the question.
 
         This method calls resolve() with ``search=True``, and is
-        provided for backwards compatbility with prior versions of
+        provided for backwards compatibility with prior versions of
         dnspython.  See the documentation for the resolve() method for
         further details.
         """
@@ -1200,7 +1200,7 @@ def query(qname, rdtype=dns.rdatatype.A, rdclass=dns.rdataclass.IN,
     """Query nameservers to find the answer to the question.
 
     This method calls resolve() with ``search=True``, and is
-    provided for backwards compatbility with prior versions of
+    provided for backwards compatibility with prior versions of
     dnspython.  See the documentation for the resolve() method for
     further details.
     """
@@ -1253,7 +1253,7 @@ def zone_for_name(name, rdclass=dns.rdataclass.IN, tcp=False, resolver=None,
     root servers in your network and they are misconfigured.)
 
     Raises ``dns.resolver.LifetimeTimeout`` if the answer could not be
-    found in the alotted lifetime.
+    found in the allotted lifetime.
 
     Returns a ``dns.name.Name``.
     """
diff --git a/lib/dns/resolver.pyi b/lib/dns/resolver.pyi
index 6da21f12..348df4da 100644
--- a/lib/dns/resolver.pyi
+++ b/lib/dns/resolver.pyi
@@ -25,7 +25,7 @@ def query(qname : str, rdtype : Union[int,str] = 0,
           tcp=False, source=None, raise_on_no_answer=True,
           source_port=0, lifetime : Optional[float]=None):
     ...
-def resolve_address(self, ipaddr: str, *args: Any, **kwargs: Optional[Dict]):
+def resolve_address(ipaddr: str, *args: Any, **kwargs: Optional[Dict]):
     ...
 class LRUCache:
     def __init__(self, max_size=1000):
@@ -59,3 +59,8 @@ class Resolver:
               raise_on_no_answer=True, source_port : int = 0,
               lifetime : Optional[float]=None):
         ...
+default_resolver: typing.Optional[Resolver]
+def reset_default_resolver() -> None:
+    ...
+def get_default_resolver() -> Resolver:
+    ...
diff --git a/lib/dns/tokenizer.py b/lib/dns/tokenizer.py
index 7ddc7a96..cb6a6302 100644
--- a/lib/dns/tokenizer.py
+++ b/lib/dns/tokenizer.py
@@ -600,9 +600,12 @@ class Tokenizer:
                 break
         return tokens
 
-    def concatenate_remaining_identifiers(self):
+    def concatenate_remaining_identifiers(self, allow_empty=False):
         """Read the remaining tokens on the line, which should be identifiers.
 
+        Raises dns.exception.SyntaxError if there are no remaining tokens,
+        unless `allow_empty=True` is given.
+
         Raises dns.exception.SyntaxError if a token is seen that is not an
         identifier.
 
@@ -618,6 +621,8 @@ class Tokenizer:
             if not token.is_identifier():
                 raise dns.exception.SyntaxError
             s += token.value
+        if not (allow_empty or s):
+            raise dns.exception.SyntaxError('expecting another identifier')
         return s
 
     def as_name(self, token, origin=None, relativize=False, relativize_to=None):
diff --git a/lib/dns/transaction.py b/lib/dns/transaction.py
index ae7417ed..d7254924 100644
--- a/lib/dns/transaction.py
+++ b/lib/dns/transaction.py
@@ -389,7 +389,7 @@ class Transaction:
             if rdataset.rdclass != self.manager.get_class():
                 raise ValueError(f'{method} has objects of wrong RdataClass')
             if rdataset.rdtype == dns.rdatatype.SOA:
-                (_, _, origin) = self.manager.origin_information()
+                (_, _, origin) = self._origin_information()
                 if name != origin:
                     raise ValueError(f'{method} has non-origin SOA')
             self._raise_if_not_empty(method, args)
@@ -560,7 +560,7 @@ class Transaction:
         *commit*, a bool.  If ``True``, commit the transaction, otherwise
         roll it back.
 
-        If committing adn the commit fails, then roll back and raise an
+        If committing and the commit fails, then roll back and raise an
         exception.
         """
         raise NotImplementedError  # pragma: no cover
@@ -585,3 +585,12 @@ class Transaction:
         Returns a node or ``None``.
         """
         raise NotImplementedError  # pragma: no cover
+
+    #
+    # Low-level API with a default implementation, in case a subclass needs
+    # to override.
+    #
+
+    def _origin_information(self):
+        # This is only used by _add()
+        return self.manager.origin_information()
diff --git a/lib/dns/tsigkeyring.py b/lib/dns/tsigkeyring.py
index 47a1f79f..788581c9 100644
--- a/lib/dns/tsigkeyring.py
+++ b/lib/dns/tsigkeyring.py
@@ -20,6 +20,7 @@
 import base64
 
 import dns.name
+import dns.tsig
 
 
 def from_text(textring):
diff --git a/lib/dns/version.py b/lib/dns/version.py
index 745a5c7f..65017872 100644
--- a/lib/dns/version.py
+++ b/lib/dns/version.py
@@ -22,7 +22,7 @@ MAJOR = 2
 #: MINOR
 MINOR = 2
 #: MICRO
-MICRO = 0
+MICRO = 1
 #: RELEASELEVEL
 RELEASELEVEL = 0x0f
 #: SERIAL
diff --git a/lib/dns/versioned.py b/lib/dns/versioned.py
index 42f2c814..8b6c275f 100644
--- a/lib/dns/versioned.py
+++ b/lib/dns/versioned.py
@@ -131,7 +131,7 @@ class Zone(dns.zone.Zone):
             #
             # We only wake one sleeper at a time, so it's important
             # that no event waiter can exit this method (e.g. via
-            # cancelation) without returning a transaction or waking
+            # cancellation) without returning a transaction or waking
             # someone else up.
             #
             # This is not a problem with Threading module threads as
diff --git a/lib/dns/zone.py b/lib/dns/zone.py
index 2e731446..5a649404 100644
--- a/lib/dns/zone.py
+++ b/lib/dns/zone.py
@@ -183,6 +183,11 @@ class Zone(dns.transaction.TransactionManager):
                     "name parameter must be a subdomain of the zone origin")
             if self.relativize:
                 name = name.relativize(self.origin)
+        elif not self.relativize:
+            # We have a relative name in a non-relative zone, so derelativize.
+            if self.origin is None:
+                raise KeyError('no zone origin is defined')
+            name = name.derelativize(self.origin)
         return name
 
     def __getitem__(self, key):
@@ -870,11 +875,20 @@ class Version:
 
     def _validate_name(self, name):
         if name.is_absolute():
-            if not name.is_subdomain(self.zone.origin):
+            if self.origin is None:
+                # This should probably never happen as other code (e.g.
+                # _rr_line) will notice the lack of an origin before us, but
+                # we check just in case!
+                raise KeyError('no zone origin is defined')
+            if not name.is_subdomain(self.origin):
                 raise KeyError("name is not a subdomain of the zone origin")
             if self.zone.relativize:
-                # XXXRTH should it be an error if self.origin is still None?
                 name = name.relativize(self.origin)
+        elif not self.zone.relativize:
+            # We have a relative name in a non-relative zone, so derelativize.
+            if self.origin is None:
+                raise KeyError('no zone origin is defined')
+            name = name.derelativize(self.origin)
         return name
 
     def get_node(self, name):
@@ -1030,6 +1044,18 @@ class Transaction(dns.transaction.Transaction):
     def _get_node(self, name):
         return self.version.get_node(name)
 
+    def _origin_information(self):
+        (absolute, relativize, effective) = self.manager.origin_information()
+        if absolute is None and self.version.origin is not None:
+            # No origin has been committed yet, but we've learned one as part of
+            # this txn.  Use it.
+            absolute = self.version.origin
+            if relativize:
+                effective = dns.name.empty
+            else:
+                effective = absolute
+        return (absolute, relativize, effective)
+
 
 def from_text(text, origin=None, rdclass=dns.rdataclass.IN,
               relativize=True, zone_factory=Zone, filename=None,
diff --git a/requirements.txt b/requirements.txt
index 12ec6726..1861eeaa 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -11,7 +11,7 @@ cheroot==8.6.0
 cherrypy==18.6.1
 cloudinary==1.29.0
 distro==1.7.0
-dnspython==2.2.0
+dnspython==2.2.1
 facebook-sdk==3.1.0
 future==0.18.2
 gntp==1.0.3

From 238afb47943f84a81c373e63bb90eb860852a6b5 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 16 May 2022 20:33:50 -0700
Subject: [PATCH 077/743] Bump mako from 1.1.6 to 1.2.0 (#1684)

* Bump mako from 1.1.6 to 1.2.0

Bumps [mako](https://github.com/sqlalchemy/mako) from 1.1.6 to 1.2.0.
- [Release notes](https://github.com/sqlalchemy/mako/releases)
- [Changelog](https://github.com/sqlalchemy/mako/blob/main/CHANGES)
- [Commits](https://github.com/sqlalchemy/mako/commits)

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

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

* Update mako==1.2.0

* Update MarkupSafe==2.1.1

* Add importlib-metadata==4.11.3

* 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/importlib_metadata/__init__.py     | 1075 ++++++++++++++++++++++++
 lib/importlib_metadata/_adapters.py    |   68 ++
 lib/importlib_metadata/_collections.py |   30 +
 lib/importlib_metadata/_compat.py      |   71 ++
 lib/importlib_metadata/_functools.py   |  104 +++
 lib/importlib_metadata/_itertools.py   |   73 ++
 lib/importlib_metadata/_meta.py        |   48 ++
 lib/importlib_metadata/_text.py        |   99 +++
 lib/importlib_metadata/py.typed        |    0
 lib/mako/__init__.py                   |    4 +-
 lib/mako/_ast_util.py                  |   13 +-
 lib/mako/ast.py                        |   29 +-
 lib/mako/cache.py                      |    9 +-
 lib/mako/cmd.py                        |    9 +-
 lib/mako/codegen.py                    |   58 +-
 lib/mako/compat.py                     |  141 +---
 lib/mako/exceptions.py                 |   37 +-
 lib/mako/ext/autohandler.py            |    2 +-
 lib/mako/ext/babelplugin.py            |   11 +-
 lib/mako/ext/beaker_cache.py           |    4 +-
 lib/mako/ext/extract.py                |   22 +-
 lib/mako/ext/linguaplugin.py           |   36 +-
 lib/mako/ext/preprocessors.py          |    2 +-
 lib/mako/ext/pygmentplugin.py          |   19 +-
 lib/mako/ext/turbogears.py             |    6 +-
 lib/mako/filters.py                    |   96 +--
 lib/mako/lexer.py                      |  232 +++--
 lib/mako/lookup.py                     |   58 +-
 lib/mako/parsetree.py                  |  117 ++-
 lib/mako/pygen.py                      |   42 +-
 lib/mako/pyparser.py                   |   82 +-
 lib/mako/runtime.py                    |   90 +-
 lib/mako/template.py                   |  119 +--
 lib/mako/testing/__init__.py           |    0
 lib/mako/testing/_config.py            |  128 +++
 lib/mako/testing/assertions.py         |  167 ++++
 lib/mako/testing/config.py             |   17 +
 lib/mako/testing/exclusions.py         |   80 ++
 lib/mako/testing/fixtures.py           |  109 +++
 lib/mako/testing/helpers.py            |   67 ++
 lib/mako/util.py                       |   60 +-
 lib/markupsafe/__init__.py             |   25 +-
 lib/markupsafe/_native.py              |   12 -
 lib/markupsafe/_speedups.c             |  320 +++++++
 requirements.txt                       |    5 +-
 45 files changed, 2948 insertions(+), 848 deletions(-)
 create mode 100644 lib/importlib_metadata/__init__.py
 create mode 100644 lib/importlib_metadata/_adapters.py
 create mode 100644 lib/importlib_metadata/_collections.py
 create mode 100644 lib/importlib_metadata/_compat.py
 create mode 100644 lib/importlib_metadata/_functools.py
 create mode 100644 lib/importlib_metadata/_itertools.py
 create mode 100644 lib/importlib_metadata/_meta.py
 create mode 100644 lib/importlib_metadata/_text.py
 create mode 100644 lib/importlib_metadata/py.typed
 create mode 100644 lib/mako/testing/__init__.py
 create mode 100644 lib/mako/testing/_config.py
 create mode 100644 lib/mako/testing/assertions.py
 create mode 100644 lib/mako/testing/config.py
 create mode 100644 lib/mako/testing/exclusions.py
 create mode 100644 lib/mako/testing/fixtures.py
 create mode 100644 lib/mako/testing/helpers.py
 create mode 100644 lib/markupsafe/_speedups.c

diff --git a/lib/importlib_metadata/__init__.py b/lib/importlib_metadata/__init__.py
new file mode 100644
index 00000000..5ac8be23
--- /dev/null
+++ b/lib/importlib_metadata/__init__.py
@@ -0,0 +1,1075 @@
+import os
+import re
+import abc
+import csv
+import sys
+import zipp
+import email
+import pathlib
+import operator
+import textwrap
+import warnings
+import functools
+import itertools
+import posixpath
+import collections
+
+from . import _adapters, _meta
+from ._collections import FreezableDefaultDict, Pair
+from ._compat import (
+    NullFinder,
+    install,
+    pypy_partial,
+)
+from ._functools import method_cache, pass_none
+from ._itertools import always_iterable, unique_everseen
+from ._meta import PackageMetadata, SimplePath
+
+from contextlib import suppress
+from importlib import import_module
+from importlib.abc import MetaPathFinder
+from itertools import starmap
+from typing import List, Mapping, Optional, Union
+
+
+__all__ = [
+    'Distribution',
+    'DistributionFinder',
+    'PackageMetadata',
+    'PackageNotFoundError',
+    'distribution',
+    'distributions',
+    'entry_points',
+    'files',
+    'metadata',
+    'packages_distributions',
+    'requires',
+    'version',
+]
+
+
+class PackageNotFoundError(ModuleNotFoundError):
+    """The package was not found."""
+
+    def __str__(self):
+        return f"No package metadata was found for {self.name}"
+
+    @property
+    def name(self):
+        (name,) = self.args
+        return name
+
+
+class Sectioned:
+    """
+    A simple entry point config parser for performance
+
+    >>> for item in Sectioned.read(Sectioned._sample):
+    ...     print(item)
+    Pair(name='sec1', value='# comments ignored')
+    Pair(name='sec1', value='a = 1')
+    Pair(name='sec1', value='b = 2')
+    Pair(name='sec2', value='a = 2')
+
+    >>> res = Sectioned.section_pairs(Sectioned._sample)
+    >>> item = next(res)
+    >>> item.name
+    'sec1'
+    >>> item.value
+    Pair(name='a', value='1')
+    >>> item = next(res)
+    >>> item.value
+    Pair(name='b', value='2')
+    >>> item = next(res)
+    >>> item.name
+    'sec2'
+    >>> item.value
+    Pair(name='a', value='2')
+    >>> list(res)
+    []
+    """
+
+    _sample = textwrap.dedent(
+        """
+        [sec1]
+        # comments ignored
+        a = 1
+        b = 2
+
+        [sec2]
+        a = 2
+        """
+    ).lstrip()
+
+    @classmethod
+    def section_pairs(cls, text):
+        return (
+            section._replace(value=Pair.parse(section.value))
+            for section in cls.read(text, filter_=cls.valid)
+            if section.name is not None
+        )
+
+    @staticmethod
+    def read(text, filter_=None):
+        lines = filter(filter_, map(str.strip, text.splitlines()))
+        name = None
+        for value in lines:
+            section_match = value.startswith('[') and value.endswith(']')
+            if section_match:
+                name = value.strip('[]')
+                continue
+            yield Pair(name, value)
+
+    @staticmethod
+    def valid(line):
+        return line and not line.startswith('#')
+
+
+class DeprecatedTuple:
+    """
+    Provide subscript item access for backward compatibility.
+
+    >>> recwarn = getfixture('recwarn')
+    >>> ep = EntryPoint(name='name', value='value', group='group')
+    >>> ep[:]
+    ('name', 'value', 'group')
+    >>> ep[0]
+    'name'
+    >>> len(recwarn)
+    1
+    """
+
+    _warn = functools.partial(
+        warnings.warn,
+        "EntryPoint tuple interface is deprecated. Access members by name.",
+        DeprecationWarning,
+        stacklevel=pypy_partial(2),
+    )
+
+    def __getitem__(self, item):
+        self._warn()
+        return self._key()[item]
+
+
+class EntryPoint(DeprecatedTuple):
+    """An entry point as defined by Python packaging conventions.
+
+    See `the packaging docs on entry points
+    <https://packaging.python.org/specifications/entry-points/>`_
+    for more information.
+
+    >>> ep = EntryPoint(
+    ...     name=None, group=None, value='package.module:attr [extra1, extra2]')
+    >>> ep.module
+    'package.module'
+    >>> ep.attr
+    'attr'
+    >>> ep.extras
+    ['extra1', 'extra2']
+    """
+
+    pattern = re.compile(
+        r'(?P<module>[\w.]+)\s*'
+        r'(:\s*(?P<attr>[\w.]+)\s*)?'
+        r'((?P<extras>\[.*\])\s*)?$'
+    )
+    """
+    A regular expression describing the syntax for an entry point,
+    which might look like:
+
+        - module
+        - package.module
+        - package.module:attribute
+        - package.module:object.attribute
+        - package.module:attr [extra1, extra2]
+
+    Other combinations are possible as well.
+
+    The expression is lenient about whitespace around the ':',
+    following the attr, and following any extras.
+    """
+
+    dist: Optional['Distribution'] = None
+
+    def __init__(self, name, value, group):
+        vars(self).update(name=name, value=value, group=group)
+
+    def load(self):
+        """Load the entry point from its definition. If only a module
+        is indicated by the value, return that module. Otherwise,
+        return the named object.
+        """
+        match = self.pattern.match(self.value)
+        module = import_module(match.group('module'))
+        attrs = filter(None, (match.group('attr') or '').split('.'))
+        return functools.reduce(getattr, attrs, module)
+
+    @property
+    def module(self):
+        match = self.pattern.match(self.value)
+        return match.group('module')
+
+    @property
+    def attr(self):
+        match = self.pattern.match(self.value)
+        return match.group('attr')
+
+    @property
+    def extras(self):
+        match = self.pattern.match(self.value)
+        return re.findall(r'\w+', match.group('extras') or '')
+
+    def _for(self, dist):
+        vars(self).update(dist=dist)
+        return self
+
+    def __iter__(self):
+        """
+        Supply iter so one may construct dicts of EntryPoints by name.
+        """
+        msg = (
+            "Construction of dict of EntryPoints is deprecated in "
+            "favor of EntryPoints."
+        )
+        warnings.warn(msg, DeprecationWarning)
+        return iter((self.name, self))
+
+    def matches(self, **params):
+        """
+        EntryPoint matches the given parameters.
+
+        >>> ep = EntryPoint(group='foo', name='bar', value='bing:bong [extra1, extra2]')
+        >>> ep.matches(group='foo')
+        True
+        >>> ep.matches(name='bar', value='bing:bong [extra1, extra2]')
+        True
+        >>> ep.matches(group='foo', name='other')
+        False
+        >>> ep.matches()
+        True
+        >>> ep.matches(extras=['extra1', 'extra2'])
+        True
+        >>> ep.matches(module='bing')
+        True
+        >>> ep.matches(attr='bong')
+        True
+        """
+        attrs = (getattr(self, param) for param in params)
+        return all(map(operator.eq, params.values(), attrs))
+
+    def _key(self):
+        return self.name, self.value, self.group
+
+    def __lt__(self, other):
+        return self._key() < other._key()
+
+    def __eq__(self, other):
+        return self._key() == other._key()
+
+    def __setattr__(self, name, value):
+        raise AttributeError("EntryPoint objects are immutable.")
+
+    def __repr__(self):
+        return (
+            f'EntryPoint(name={self.name!r}, value={self.value!r}, '
+            f'group={self.group!r})'
+        )
+
+    def __hash__(self):
+        return hash(self._key())
+
+
+class DeprecatedList(list):
+    """
+    Allow an otherwise immutable object to implement mutability
+    for compatibility.
+
+    >>> recwarn = getfixture('recwarn')
+    >>> dl = DeprecatedList(range(3))
+    >>> dl[0] = 1
+    >>> dl.append(3)
+    >>> del dl[3]
+    >>> dl.reverse()
+    >>> dl.sort()
+    >>> dl.extend([4])
+    >>> dl.pop(-1)
+    4
+    >>> dl.remove(1)
+    >>> dl += [5]
+    >>> dl + [6]
+    [1, 2, 5, 6]
+    >>> dl + (6,)
+    [1, 2, 5, 6]
+    >>> dl.insert(0, 0)
+    >>> dl
+    [0, 1, 2, 5]
+    >>> dl == [0, 1, 2, 5]
+    True
+    >>> dl == (0, 1, 2, 5)
+    True
+    >>> len(recwarn)
+    1
+    """
+
+    __slots__ = ()
+
+    _warn = functools.partial(
+        warnings.warn,
+        "EntryPoints list interface is deprecated. Cast to list if needed.",
+        DeprecationWarning,
+        stacklevel=pypy_partial(2),
+    )
+
+    def _wrap_deprecated_method(method_name: str):  # type: ignore
+        def wrapped(self, *args, **kwargs):
+            self._warn()
+            return getattr(super(), method_name)(*args, **kwargs)
+
+        return method_name, wrapped
+
+    locals().update(
+        map(
+            _wrap_deprecated_method,
+            '__setitem__ __delitem__ append reverse extend pop remove '
+            '__iadd__ insert sort'.split(),
+        )
+    )
+
+    def __add__(self, other):
+        if not isinstance(other, tuple):
+            self._warn()
+            other = tuple(other)
+        return self.__class__(tuple(self) + other)
+
+    def __eq__(self, other):
+        if not isinstance(other, tuple):
+            self._warn()
+            other = tuple(other)
+
+        return tuple(self).__eq__(other)
+
+
+class EntryPoints(DeprecatedList):
+    """
+    An immutable collection of selectable EntryPoint objects.
+    """
+
+    __slots__ = ()
+
+    def __getitem__(self, name):  # -> EntryPoint:
+        """
+        Get the EntryPoint in self matching name.
+        """
+        if isinstance(name, int):
+            warnings.warn(
+                "Accessing entry points by index is deprecated. "
+                "Cast to tuple if needed.",
+                DeprecationWarning,
+                stacklevel=2,
+            )
+            return super().__getitem__(name)
+        try:
+            return next(iter(self.select(name=name)))
+        except StopIteration:
+            raise KeyError(name)
+
+    def select(self, **params):
+        """
+        Select entry points from self that match the
+        given parameters (typically group and/or name).
+        """
+        return EntryPoints(ep for ep in self if ep.matches(**params))
+
+    @property
+    def names(self):
+        """
+        Return the set of all names of all entry points.
+        """
+        return {ep.name for ep in self}
+
+    @property
+    def groups(self):
+        """
+        Return the set of all groups of all entry points.
+
+        For coverage while SelectableGroups is present.
+        >>> EntryPoints().groups
+        set()
+        """
+        return {ep.group for ep in self}
+
+    @classmethod
+    def _from_text_for(cls, text, dist):
+        return cls(ep._for(dist) for ep in cls._from_text(text))
+
+    @staticmethod
+    def _from_text(text):
+        return (
+            EntryPoint(name=item.value.name, value=item.value.value, group=item.name)
+            for item in Sectioned.section_pairs(text or '')
+        )
+
+
+class Deprecated:
+    """
+    Compatibility add-in for mapping to indicate that
+    mapping behavior is deprecated.
+
+    >>> recwarn = getfixture('recwarn')
+    >>> class DeprecatedDict(Deprecated, dict): pass
+    >>> dd = DeprecatedDict(foo='bar')
+    >>> dd.get('baz', None)
+    >>> dd['foo']
+    'bar'
+    >>> list(dd)
+    ['foo']
+    >>> list(dd.keys())
+    ['foo']
+    >>> 'foo' in dd
+    True
+    >>> list(dd.values())
+    ['bar']
+    >>> len(recwarn)
+    1
+    """
+
+    _warn = functools.partial(
+        warnings.warn,
+        "SelectableGroups dict interface is deprecated. Use select.",
+        DeprecationWarning,
+        stacklevel=pypy_partial(2),
+    )
+
+    def __getitem__(self, name):
+        self._warn()
+        return super().__getitem__(name)
+
+    def get(self, name, default=None):
+        self._warn()
+        return super().get(name, default)
+
+    def __iter__(self):
+        self._warn()
+        return super().__iter__()
+
+    def __contains__(self, *args):
+        self._warn()
+        return super().__contains__(*args)
+
+    def keys(self):
+        self._warn()
+        return super().keys()
+
+    def values(self):
+        self._warn()
+        return super().values()
+
+
+class SelectableGroups(Deprecated, dict):
+    """
+    A backward- and forward-compatible result from
+    entry_points that fully implements the dict interface.
+    """
+
+    @classmethod
+    def load(cls, eps):
+        by_group = operator.attrgetter('group')
+        ordered = sorted(eps, key=by_group)
+        grouped = itertools.groupby(ordered, by_group)
+        return cls((group, EntryPoints(eps)) for group, eps in grouped)
+
+    @property
+    def _all(self):
+        """
+        Reconstruct a list of all entrypoints from the groups.
+        """
+        groups = super(Deprecated, self).values()
+        return EntryPoints(itertools.chain.from_iterable(groups))
+
+    @property
+    def groups(self):
+        return self._all.groups
+
+    @property
+    def names(self):
+        """
+        for coverage:
+        >>> SelectableGroups().names
+        set()
+        """
+        return self._all.names
+
+    def select(self, **params):
+        if not params:
+            return self
+        return self._all.select(**params)
+
+
+class PackagePath(pathlib.PurePosixPath):
+    """A reference to a path in a package"""
+
+    def read_text(self, encoding='utf-8'):
+        with self.locate().open(encoding=encoding) as stream:
+            return stream.read()
+
+    def read_binary(self):
+        with self.locate().open('rb') as stream:
+            return stream.read()
+
+    def locate(self):
+        """Return a path-like object for this path"""
+        return self.dist.locate_file(self)
+
+
+class FileHash:
+    def __init__(self, spec):
+        self.mode, _, self.value = spec.partition('=')
+
+    def __repr__(self):
+        return f'<FileHash mode: {self.mode} value: {self.value}>'
+
+
+class Distribution:
+    """A Python distribution package."""
+
+    @abc.abstractmethod
+    def read_text(self, filename):
+        """Attempt to load metadata file given by the name.
+
+        :param filename: The name of the file in the distribution info.
+        :return: The text if found, otherwise None.
+        """
+
+    @abc.abstractmethod
+    def locate_file(self, path):
+        """
+        Given a path to a file in this distribution, return a path
+        to it.
+        """
+
+    @classmethod
+    def from_name(cls, name):
+        """Return the Distribution for the given package name.
+
+        :param name: The name of the distribution package to search for.
+        :return: The Distribution instance (or subclass thereof) for the named
+            package, if found.
+        :raises PackageNotFoundError: When the named package's distribution
+            metadata cannot be found.
+        """
+        for resolver in cls._discover_resolvers():
+            dists = resolver(DistributionFinder.Context(name=name))
+            dist = next(iter(dists), None)
+            if dist is not None:
+                return dist
+        else:
+            raise PackageNotFoundError(name)
+
+    @classmethod
+    def discover(cls, **kwargs):
+        """Return an iterable of Distribution objects for all packages.
+
+        Pass a ``context`` or pass keyword arguments for constructing
+        a context.
+
+        :context: A ``DistributionFinder.Context`` object.
+        :return: Iterable of Distribution objects for all packages.
+        """
+        context = kwargs.pop('context', None)
+        if context and kwargs:
+            raise ValueError("cannot accept context and kwargs")
+        context = context or DistributionFinder.Context(**kwargs)
+        return itertools.chain.from_iterable(
+            resolver(context) for resolver in cls._discover_resolvers()
+        )
+
+    @staticmethod
+    def at(path):
+        """Return a Distribution for the indicated metadata path
+
+        :param path: a string or path-like object
+        :return: a concrete Distribution instance for the path
+        """
+        return PathDistribution(pathlib.Path(path))
+
+    @staticmethod
+    def _discover_resolvers():
+        """Search the meta_path for resolvers."""
+        declared = (
+            getattr(finder, 'find_distributions', None) for finder in sys.meta_path
+        )
+        return filter(None, declared)
+
+    @property
+    def metadata(self) -> _meta.PackageMetadata:
+        """Return the parsed metadata for this Distribution.
+
+        The returned object will have keys that name the various bits of
+        metadata.  See PEP 566 for details.
+        """
+        text = (
+            self.read_text('METADATA')
+            or self.read_text('PKG-INFO')
+            # This last clause is here to support old egg-info files.  Its
+            # effect is to just end up using the PathDistribution's self._path
+            # (which points to the egg-info file) attribute unchanged.
+            or self.read_text('')
+        )
+        return _adapters.Message(email.message_from_string(text))
+
+    @property
+    def name(self):
+        """Return the 'Name' metadata for the distribution package."""
+        return self.metadata['Name']
+
+    @property
+    def _normalized_name(self):
+        """Return a normalized version of the name."""
+        return Prepared.normalize(self.name)
+
+    @property
+    def version(self):
+        """Return the 'Version' metadata for the distribution package."""
+        return self.metadata['Version']
+
+    @property
+    def entry_points(self):
+        return EntryPoints._from_text_for(self.read_text('entry_points.txt'), self)
+
+    @property
+    def files(self):
+        """Files in this distribution.
+
+        :return: List of PackagePath for this distribution or None
+
+        Result is `None` if the metadata file that enumerates files
+        (i.e. RECORD for dist-info or SOURCES.txt for egg-info) is
+        missing.
+        Result may be empty if the metadata exists but is empty.
+        """
+
+        def make_file(name, hash=None, size_str=None):
+            result = PackagePath(name)
+            result.hash = FileHash(hash) if hash else None
+            result.size = int(size_str) if size_str else None
+            result.dist = self
+            return result
+
+        @pass_none
+        def make_files(lines):
+            return list(starmap(make_file, csv.reader(lines)))
+
+        return make_files(self._read_files_distinfo() or self._read_files_egginfo())
+
+    def _read_files_distinfo(self):
+        """
+        Read the lines of RECORD
+        """
+        text = self.read_text('RECORD')
+        return text and text.splitlines()
+
+    def _read_files_egginfo(self):
+        """
+        SOURCES.txt might contain literal commas, so wrap each line
+        in quotes.
+        """
+        text = self.read_text('SOURCES.txt')
+        return text and map('"{}"'.format, text.splitlines())
+
+    @property
+    def requires(self):
+        """Generated requirements specified for this Distribution"""
+        reqs = self._read_dist_info_reqs() or self._read_egg_info_reqs()
+        return reqs and list(reqs)
+
+    def _read_dist_info_reqs(self):
+        return self.metadata.get_all('Requires-Dist')
+
+    def _read_egg_info_reqs(self):
+        source = self.read_text('requires.txt')
+        return pass_none(self._deps_from_requires_text)(source)
+
+    @classmethod
+    def _deps_from_requires_text(cls, source):
+        return cls._convert_egg_info_reqs_to_simple_reqs(Sectioned.read(source))
+
+    @staticmethod
+    def _convert_egg_info_reqs_to_simple_reqs(sections):
+        """
+        Historically, setuptools would solicit and store 'extra'
+        requirements, including those with environment markers,
+        in separate sections. More modern tools expect each
+        dependency to be defined separately, with any relevant
+        extras and environment markers attached directly to that
+        requirement. This method converts the former to the
+        latter. See _test_deps_from_requires_text for an example.
+        """
+
+        def make_condition(name):
+            return name and f'extra == "{name}"'
+
+        def quoted_marker(section):
+            section = section or ''
+            extra, sep, markers = section.partition(':')
+            if extra and markers:
+                markers = f'({markers})'
+            conditions = list(filter(None, [markers, make_condition(extra)]))
+            return '; ' + ' and '.join(conditions) if conditions else ''
+
+        def url_req_space(req):
+            """
+            PEP 508 requires a space between the url_spec and the quoted_marker.
+            Ref python/importlib_metadata#357.
+            """
+            # '@' is uniquely indicative of a url_req.
+            return ' ' * ('@' in req)
+
+        for section in sections:
+            space = url_req_space(section.value)
+            yield section.value + space + quoted_marker(section.name)
+
+
+class DistributionFinder(MetaPathFinder):
+    """
+    A MetaPathFinder capable of discovering installed distributions.
+    """
+
+    class Context:
+        """
+        Keyword arguments presented by the caller to
+        ``distributions()`` or ``Distribution.discover()``
+        to narrow the scope of a search for distributions
+        in all DistributionFinders.
+
+        Each DistributionFinder may expect any parameters
+        and should attempt to honor the canonical
+        parameters defined below when appropriate.
+        """
+
+        name = None
+        """
+        Specific name for which a distribution finder should match.
+        A name of ``None`` matches all distributions.
+        """
+
+        def __init__(self, **kwargs):
+            vars(self).update(kwargs)
+
+        @property
+        def path(self):
+            """
+            The sequence of directory path that a distribution finder
+            should search.
+
+            Typically refers to Python installed package paths such as
+            "site-packages" directories and defaults to ``sys.path``.
+            """
+            return vars(self).get('path', sys.path)
+
+    @abc.abstractmethod
+    def find_distributions(self, context=Context()):
+        """
+        Find distributions.
+
+        Return an iterable of all Distribution instances capable of
+        loading the metadata for packages matching the ``context``,
+        a DistributionFinder.Context instance.
+        """
+
+
+class FastPath:
+    """
+    Micro-optimized class for searching a path for
+    children.
+
+    >>> FastPath('').children()
+    ['...']
+    """
+
+    @functools.lru_cache()  # type: ignore
+    def __new__(cls, root):
+        return super().__new__(cls)
+
+    def __init__(self, root):
+        self.root = root
+
+    def joinpath(self, child):
+        return pathlib.Path(self.root, child)
+
+    def children(self):
+        with suppress(Exception):
+            return os.listdir(self.root or '.')
+        with suppress(Exception):
+            return self.zip_children()
+        return []
+
+    def zip_children(self):
+        zip_path = zipp.Path(self.root)
+        names = zip_path.root.namelist()
+        self.joinpath = zip_path.joinpath
+
+        return dict.fromkeys(child.split(posixpath.sep, 1)[0] for child in names)
+
+    def search(self, name):
+        return self.lookup(self.mtime).search(name)
+
+    @property
+    def mtime(self):
+        with suppress(OSError):
+            return os.stat(self.root).st_mtime
+        self.lookup.cache_clear()
+
+    @method_cache
+    def lookup(self, mtime):
+        return Lookup(self)
+
+
+class Lookup:
+    def __init__(self, path: FastPath):
+        base = os.path.basename(path.root).lower()
+        base_is_egg = base.endswith(".egg")
+        self.infos = FreezableDefaultDict(list)
+        self.eggs = FreezableDefaultDict(list)
+
+        for child in path.children():
+            low = child.lower()
+            if low.endswith((".dist-info", ".egg-info")):
+                # rpartition is faster than splitext and suitable for this purpose.
+                name = low.rpartition(".")[0].partition("-")[0]
+                normalized = Prepared.normalize(name)
+                self.infos[normalized].append(path.joinpath(child))
+            elif base_is_egg and low == "egg-info":
+                name = base.rpartition(".")[0].partition("-")[0]
+                legacy_normalized = Prepared.legacy_normalize(name)
+                self.eggs[legacy_normalized].append(path.joinpath(child))
+
+        self.infos.freeze()
+        self.eggs.freeze()
+
+    def search(self, prepared):
+        infos = (
+            self.infos[prepared.normalized]
+            if prepared
+            else itertools.chain.from_iterable(self.infos.values())
+        )
+        eggs = (
+            self.eggs[prepared.legacy_normalized]
+            if prepared
+            else itertools.chain.from_iterable(self.eggs.values())
+        )
+        return itertools.chain(infos, eggs)
+
+
+class Prepared:
+    """
+    A prepared search for metadata on a possibly-named package.
+    """
+
+    normalized = None
+    legacy_normalized = None
+
+    def __init__(self, name):
+        self.name = name
+        if name is None:
+            return
+        self.normalized = self.normalize(name)
+        self.legacy_normalized = self.legacy_normalize(name)
+
+    @staticmethod
+    def normalize(name):
+        """
+        PEP 503 normalization plus dashes as underscores.
+        """
+        return re.sub(r"[-_.]+", "-", name).lower().replace('-', '_')
+
+    @staticmethod
+    def legacy_normalize(name):
+        """
+        Normalize the package name as found in the convention in
+        older packaging tools versions and specs.
+        """
+        return name.lower().replace('-', '_')
+
+    def __bool__(self):
+        return bool(self.name)
+
+
+@install
+class MetadataPathFinder(NullFinder, DistributionFinder):
+    """A degenerate finder for distribution packages on the file system.
+
+    This finder supplies only a find_distributions() method for versions
+    of Python that do not have a PathFinder find_distributions().
+    """
+
+    def find_distributions(self, context=DistributionFinder.Context()):
+        """
+        Find distributions.
+
+        Return an iterable of all Distribution instances capable of
+        loading the metadata for packages matching ``context.name``
+        (or all names if ``None`` indicated) along the paths in the list
+        of directories ``context.path``.
+        """
+        found = self._search_paths(context.name, context.path)
+        return map(PathDistribution, found)
+
+    @classmethod
+    def _search_paths(cls, name, paths):
+        """Find metadata directories in paths heuristically."""
+        prepared = Prepared(name)
+        return itertools.chain.from_iterable(
+            path.search(prepared) for path in map(FastPath, paths)
+        )
+
+    def invalidate_caches(cls):
+        FastPath.__new__.cache_clear()
+
+
+class PathDistribution(Distribution):
+    def __init__(self, path: SimplePath):
+        """Construct a distribution.
+
+        :param path: SimplePath indicating the metadata directory.
+        """
+        self._path = path
+
+    def read_text(self, filename):
+        with suppress(
+            FileNotFoundError,
+            IsADirectoryError,
+            KeyError,
+            NotADirectoryError,
+            PermissionError,
+        ):
+            return self._path.joinpath(filename).read_text(encoding='utf-8')
+
+    read_text.__doc__ = Distribution.read_text.__doc__
+
+    def locate_file(self, path):
+        return self._path.parent / path
+
+    @property
+    def _normalized_name(self):
+        """
+        Performance optimization: where possible, resolve the
+        normalized name from the file system path.
+        """
+        stem = os.path.basename(str(self._path))
+        return self._name_from_stem(stem) or super()._normalized_name
+
+    def _name_from_stem(self, stem):
+        name, ext = os.path.splitext(stem)
+        if ext not in ('.dist-info', '.egg-info'):
+            return
+        name, sep, rest = stem.partition('-')
+        return name
+
+
+def distribution(distribution_name):
+    """Get the ``Distribution`` instance for the named package.
+
+    :param distribution_name: The name of the distribution package as a string.
+    :return: A ``Distribution`` instance (or subclass thereof).
+    """
+    return Distribution.from_name(distribution_name)
+
+
+def distributions(**kwargs):
+    """Get all ``Distribution`` instances in the current environment.
+
+    :return: An iterable of ``Distribution`` instances.
+    """
+    return Distribution.discover(**kwargs)
+
+
+def metadata(distribution_name) -> _meta.PackageMetadata:
+    """Get the metadata for the named package.
+
+    :param distribution_name: The name of the distribution package to query.
+    :return: A PackageMetadata containing the parsed metadata.
+    """
+    return Distribution.from_name(distribution_name).metadata
+
+
+def version(distribution_name):
+    """Get the version string for the named package.
+
+    :param distribution_name: The name of the distribution package to query.
+    :return: The version string for the package as defined in the package's
+        "Version" metadata key.
+    """
+    return distribution(distribution_name).version
+
+
+def entry_points(**params) -> Union[EntryPoints, SelectableGroups]:
+    """Return EntryPoint objects for all installed packages.
+
+    Pass selection parameters (group or name) to filter the
+    result to entry points matching those properties (see
+    EntryPoints.select()).
+
+    For compatibility, returns ``SelectableGroups`` object unless
+    selection parameters are supplied. In the future, this function
+    will return ``EntryPoints`` instead of ``SelectableGroups``
+    even when no selection parameters are supplied.
+
+    For maximum future compatibility, pass selection parameters
+    or invoke ``.select`` with parameters on the result.
+
+    :return: EntryPoints or SelectableGroups for all installed packages.
+    """
+    norm_name = operator.attrgetter('_normalized_name')
+    unique = functools.partial(unique_everseen, key=norm_name)
+    eps = itertools.chain.from_iterable(
+        dist.entry_points for dist in unique(distributions())
+    )
+    return SelectableGroups.load(eps).select(**params)
+
+
+def files(distribution_name):
+    """Return a list of files for the named package.
+
+    :param distribution_name: The name of the distribution package to query.
+    :return: List of files composing the distribution.
+    """
+    return distribution(distribution_name).files
+
+
+def requires(distribution_name):
+    """
+    Return a list of requirements for the named package.
+
+    :return: An iterator of requirements, suitable for
+        packaging.requirement.Requirement.
+    """
+    return distribution(distribution_name).requires
+
+
+def packages_distributions() -> Mapping[str, List[str]]:
+    """
+    Return a mapping of top-level packages to their
+    distributions.
+
+    >>> import collections.abc
+    >>> pkgs = packages_distributions()
+    >>> all(isinstance(dist, collections.abc.Sequence) for dist in pkgs.values())
+    True
+    """
+    pkg_to_dist = collections.defaultdict(list)
+    for dist in distributions():
+        for pkg in _top_level_declared(dist) or _top_level_inferred(dist):
+            pkg_to_dist[pkg].append(dist.metadata['Name'])
+    return dict(pkg_to_dist)
+
+
+def _top_level_declared(dist):
+    return (dist.read_text('top_level.txt') or '').split()
+
+
+def _top_level_inferred(dist):
+    return {
+        f.parts[0] if len(f.parts) > 1 else f.with_suffix('').name
+        for f in always_iterable(dist.files)
+        if f.suffix == ".py"
+    }
diff --git a/lib/importlib_metadata/_adapters.py b/lib/importlib_metadata/_adapters.py
new file mode 100644
index 00000000..aa460d3e
--- /dev/null
+++ b/lib/importlib_metadata/_adapters.py
@@ -0,0 +1,68 @@
+import re
+import textwrap
+import email.message
+
+from ._text import FoldedCase
+
+
+class Message(email.message.Message):
+    multiple_use_keys = set(
+        map(
+            FoldedCase,
+            [
+                'Classifier',
+                'Obsoletes-Dist',
+                'Platform',
+                'Project-URL',
+                'Provides-Dist',
+                'Provides-Extra',
+                'Requires-Dist',
+                'Requires-External',
+                'Supported-Platform',
+                'Dynamic',
+            ],
+        )
+    )
+    """
+    Keys that may be indicated multiple times per PEP 566.
+    """
+
+    def __new__(cls, orig: email.message.Message):
+        res = super().__new__(cls)
+        vars(res).update(vars(orig))
+        return res
+
+    def __init__(self, *args, **kwargs):
+        self._headers = self._repair_headers()
+
+    # suppress spurious error from mypy
+    def __iter__(self):
+        return super().__iter__()
+
+    def _repair_headers(self):
+        def redent(value):
+            "Correct for RFC822 indentation"
+            if not value or '\n' not in value:
+                return value
+            return textwrap.dedent(' ' * 8 + value)
+
+        headers = [(key, redent(value)) for key, value in vars(self)['_headers']]
+        if self._payload:
+            headers.append(('Description', self.get_payload()))
+        return headers
+
+    @property
+    def json(self):
+        """
+        Convert PackageMetadata to a JSON-compatible format
+        per PEP 0566.
+        """
+
+        def transform(key):
+            value = self.get_all(key) if key in self.multiple_use_keys else self[key]
+            if key == 'Keywords':
+                value = re.split(r'\s+', value)
+            tk = key.lower().replace('-', '_')
+            return tk, value
+
+        return dict(map(transform, map(FoldedCase, self)))
diff --git a/lib/importlib_metadata/_collections.py b/lib/importlib_metadata/_collections.py
new file mode 100644
index 00000000..cf0954e1
--- /dev/null
+++ b/lib/importlib_metadata/_collections.py
@@ -0,0 +1,30 @@
+import collections
+
+
+# from jaraco.collections 3.3
+class FreezableDefaultDict(collections.defaultdict):
+    """
+    Often it is desirable to prevent the mutation of
+    a default dict after its initial construction, such
+    as to prevent mutation during iteration.
+
+    >>> dd = FreezableDefaultDict(list)
+    >>> dd[0].append('1')
+    >>> dd.freeze()
+    >>> dd[1]
+    []
+    >>> len(dd)
+    1
+    """
+
+    def __missing__(self, key):
+        return getattr(self, '_frozen', super().__missing__)(key)
+
+    def freeze(self):
+        self._frozen = lambda key: self.default_factory()
+
+
+class Pair(collections.namedtuple('Pair', 'name value')):
+    @classmethod
+    def parse(cls, text):
+        return cls(*map(str.strip, text.split("=", 1)))
diff --git a/lib/importlib_metadata/_compat.py b/lib/importlib_metadata/_compat.py
new file mode 100644
index 00000000..8fe4e4e3
--- /dev/null
+++ b/lib/importlib_metadata/_compat.py
@@ -0,0 +1,71 @@
+import sys
+import platform
+
+
+__all__ = ['install', 'NullFinder', 'Protocol']
+
+
+try:
+    from typing import Protocol
+except ImportError:  # pragma: no cover
+    from typing_extensions import Protocol  # type: ignore
+
+
+def install(cls):
+    """
+    Class decorator for installation on sys.meta_path.
+
+    Adds the backport DistributionFinder to sys.meta_path and
+    attempts to disable the finder functionality of the stdlib
+    DistributionFinder.
+    """
+    sys.meta_path.append(cls())
+    disable_stdlib_finder()
+    return cls
+
+
+def disable_stdlib_finder():
+    """
+    Give the backport primacy for discovering path-based distributions
+    by monkey-patching the stdlib O_O.
+
+    See #91 for more background for rationale on this sketchy
+    behavior.
+    """
+
+    def matches(finder):
+        return getattr(
+            finder, '__module__', None
+        ) == '_frozen_importlib_external' and hasattr(finder, 'find_distributions')
+
+    for finder in filter(matches, sys.meta_path):  # pragma: nocover
+        del finder.find_distributions
+
+
+class NullFinder:
+    """
+    A "Finder" (aka "MetaClassFinder") that never finds any modules,
+    but may find distributions.
+    """
+
+    @staticmethod
+    def find_spec(*args, **kwargs):
+        return None
+
+    # In Python 2, the import system requires finders
+    # to have a find_module() method, but this usage
+    # is deprecated in Python 3 in favor of find_spec().
+    # For the purposes of this finder (i.e. being present
+    # on sys.meta_path but having no other import
+    # system functionality), the two methods are identical.
+    find_module = find_spec
+
+
+def pypy_partial(val):
+    """
+    Adjust for variable stacklevel on partial under PyPy.
+
+    Workaround for #327.
+    """
+    is_pypy = platform.python_implementation() == 'PyPy'
+    return val + is_pypy
diff --git a/lib/importlib_metadata/_functools.py b/lib/importlib_metadata/_functools.py
new file mode 100644
index 00000000..71f66bd0
--- /dev/null
+++ b/lib/importlib_metadata/_functools.py
@@ -0,0 +1,104 @@
+import types
+import functools
+
+
+# from jaraco.functools 3.3
+def method_cache(method, cache_wrapper=None):
+    """
+    Wrap lru_cache to support storing the cache data in the object instances.
+
+    Abstracts the common paradigm where the method explicitly saves an
+    underscore-prefixed protected property on first call and returns that
+    subsequently.
+
+    >>> class MyClass:
+    ...     calls = 0
+    ...
+    ...     @method_cache
+    ...     def method(self, value):
+    ...         self.calls += 1
+    ...         return value
+
+    >>> a = MyClass()
+    >>> a.method(3)
+    3
+    >>> for x in range(75):
+    ...     res = a.method(x)
+    >>> a.calls
+    75
+
+    Note that the apparent behavior will be exactly like that of lru_cache
+    except that the cache is stored on each instance, so values in one
+    instance will not flush values from another, and when an instance is
+    deleted, so are the cached values for that instance.
+
+    >>> b = MyClass()
+    >>> for x in range(35):
+    ...     res = b.method(x)
+    >>> b.calls
+    35
+    >>> a.method(0)
+    0
+    >>> a.calls
+    75
+
+    Note that if method had been decorated with ``functools.lru_cache()``,
+    a.calls would have been 76 (due to the cached value of 0 having been
+    flushed by the 'b' instance).
+
+    Clear the cache with ``.cache_clear()``
+
+    >>> a.method.cache_clear()
+
+    Same for a method that hasn't yet been called.
+
+    >>> c = MyClass()
+    >>> c.method.cache_clear()
+
+    Another cache wrapper may be supplied:
+
+    >>> cache = functools.lru_cache(maxsize=2)
+    >>> MyClass.method2 = method_cache(lambda self: 3, cache_wrapper=cache)
+    >>> a = MyClass()
+    >>> a.method2()
+    3
+
+    Caution - do not subsequently wrap the method with another decorator, such
+    as ``@property``, which changes the semantics of the function.
+
+    See also
+    http://code.activestate.com/recipes/577452-a-memoize-decorator-for-instance-methods/
+    for another implementation and additional justification.
+    """
+    cache_wrapper = cache_wrapper or functools.lru_cache()
+
+    def wrapper(self, *args, **kwargs):
+        # it's the first call, replace the method with a cached, bound method
+        bound_method = types.MethodType(method, self)
+        cached_method = cache_wrapper(bound_method)
+        setattr(self, method.__name__, cached_method)
+        return cached_method(*args, **kwargs)
+
+    # Support cache clear even before cache has been created.
+    wrapper.cache_clear = lambda: None
+
+    return wrapper
+
+
+# From jaraco.functools 3.3
+def pass_none(func):
+    """
+    Wrap func so it's not called if its first param is None
+
+    >>> print_text = pass_none(print)
+    >>> print_text('text')
+    text
+    >>> print_text(None)
+    """
+
+    @functools.wraps(func)
+    def wrapper(param, *args, **kwargs):
+        if param is not None:
+            return func(param, *args, **kwargs)
+
+    return wrapper
diff --git a/lib/importlib_metadata/_itertools.py b/lib/importlib_metadata/_itertools.py
new file mode 100644
index 00000000..d4ca9b91
--- /dev/null
+++ b/lib/importlib_metadata/_itertools.py
@@ -0,0 +1,73 @@
+from itertools import filterfalse
+
+
+def unique_everseen(iterable, key=None):
+    "List unique elements, preserving order. Remember all elements ever seen."
+    # unique_everseen('AAAABBBCCDAABBB') --> A B C D
+    # unique_everseen('ABBCcAD', str.lower) --> A B C D
+    seen = set()
+    seen_add = seen.add
+    if key is None:
+        for element in filterfalse(seen.__contains__, iterable):
+            seen_add(element)
+            yield element
+    else:
+        for element in iterable:
+            k = key(element)
+            if k not in seen:
+                seen_add(k)
+                yield element
+
+
+# copied from more_itertools 8.8
+def always_iterable(obj, base_type=(str, bytes)):
+    """If *obj* is iterable, return an iterator over its items::
+
+        >>> obj = (1, 2, 3)
+        >>> list(always_iterable(obj))
+        [1, 2, 3]
+
+    If *obj* is not iterable, return a one-item iterable containing *obj*::
+
+        >>> obj = 1
+        >>> list(always_iterable(obj))
+        [1]
+
+    If *obj* is ``None``, return an empty iterable:
+
+        >>> obj = None
+        >>> list(always_iterable(None))
+        []
+
+    By default, binary and text strings are not considered iterable::
+
+        >>> obj = 'foo'
+        >>> list(always_iterable(obj))
+        ['foo']
+
+    If *base_type* is set, objects for which ``isinstance(obj, base_type)``
+    returns ``True`` won't be considered iterable.
+
+        >>> obj = {'a': 1}
+        >>> list(always_iterable(obj))  # Iterate over the dict's keys
+        ['a']
+        >>> list(always_iterable(obj, base_type=dict))  # Treat dicts as a unit
+        [{'a': 1}]
+
+    Set *base_type* to ``None`` to avoid any special handling and treat objects
+    Python considers iterable as iterable:
+
+        >>> obj = 'foo'
+        >>> list(always_iterable(obj, base_type=None))
+        ['f', 'o', 'o']
+    """
+    if obj is None:
+        return iter(())
+
+    if (base_type is not None) and isinstance(obj, base_type):
+        return iter((obj,))
+
+    try:
+        return iter(obj)
+    except TypeError:
+        return iter((obj,))
diff --git a/lib/importlib_metadata/_meta.py b/lib/importlib_metadata/_meta.py
new file mode 100644
index 00000000..37ee43e6
--- /dev/null
+++ b/lib/importlib_metadata/_meta.py
@@ -0,0 +1,48 @@
+from ._compat import Protocol
+from typing import Any, Dict, Iterator, List, TypeVar, Union
+
+
+_T = TypeVar("_T")
+
+
+class PackageMetadata(Protocol):
+    def __len__(self) -> int:
+        ...  # pragma: no cover
+
+    def __contains__(self, item: str) -> bool:
+        ...  # pragma: no cover
+
+    def __getitem__(self, key: str) -> str:
+        ...  # pragma: no cover
+
+    def __iter__(self) -> Iterator[str]:
+        ...  # pragma: no cover
+
+    def get_all(self, name: str, failobj: _T = ...) -> Union[List[Any], _T]:
+        """
+        Return all values associated with a possibly multi-valued key.
+        """
+
+    @property
+    def json(self) -> Dict[str, Union[str, List[str]]]:
+        """
+        A JSON-compatible form of the metadata.
+        """
+
+
+class SimplePath(Protocol):
+    """
+    A minimal subset of pathlib.Path required by PathDistribution.
+    """
+
+    def joinpath(self) -> 'SimplePath':
+        ...  # pragma: no cover
+
+    def __truediv__(self) -> 'SimplePath':
+        ...  # pragma: no cover
+
+    def parent(self) -> 'SimplePath':
+        ...  # pragma: no cover
+
+    def read_text(self) -> str:
+        ...  # pragma: no cover
diff --git a/lib/importlib_metadata/_text.py b/lib/importlib_metadata/_text.py
new file mode 100644
index 00000000..c88cfbb2
--- /dev/null
+++ b/lib/importlib_metadata/_text.py
@@ -0,0 +1,99 @@
+import re
+
+from ._functools import method_cache
+
+
+# from jaraco.text 3.5
+class FoldedCase(str):
+    """
+    A case insensitive string class; behaves just like str
+    except compares equal when the only variation is case.
+
+    >>> s = FoldedCase('hello world')
+
+    >>> s == 'Hello World'
+    True
+
+    >>> 'Hello World' == s
+    True
+
+    >>> s != 'Hello World'
+    False
+
+    >>> s.index('O')
+    4
+
+    >>> s.split('O')
+    ['hell', ' w', 'rld']
+
+    >>> sorted(map(FoldedCase, ['GAMMA', 'alpha', 'Beta']))
+    ['alpha', 'Beta', 'GAMMA']
+
+    Sequence membership is straightforward.
+
+    >>> "Hello World" in [s]
+    True
+    >>> s in ["Hello World"]
+    True
+
+    You may test for set inclusion, but candidate and elements
+    must both be folded.
+
+    >>> FoldedCase("Hello World") in {s}
+    True
+    >>> s in {FoldedCase("Hello World")}
+    True
+
+    String inclusion works as long as the FoldedCase object
+    is on the right.
+
+    >>> "hello" in FoldedCase("Hello World")
+    True
+
+    But not if the FoldedCase object is on the left:
+
+    >>> FoldedCase('hello') in 'Hello World'
+    False
+
+    In that case, use in_:
+
+    >>> FoldedCase('hello').in_('Hello World')
+    True
+
+    >>> FoldedCase('hello') > FoldedCase('Hello')
+    False
+    """
+
+    def __lt__(self, other):
+        return self.lower() < other.lower()
+
+    def __gt__(self, other):
+        return self.lower() > other.lower()
+
+    def __eq__(self, other):
+        return self.lower() == other.lower()
+
+    def __ne__(self, other):
+        return self.lower() != other.lower()
+
+    def __hash__(self):
+        return hash(self.lower())
+
+    def __contains__(self, other):
+        return super().lower().__contains__(other.lower())
+
+    def in_(self, other):
+        "Does self appear in other?"
+        return self in FoldedCase(other)
+
+    # cache lower since it's likely to be called frequently.
+    @method_cache
+    def lower(self):
+        return super().lower()
+
+    def index(self, sub):
+        return self.lower().index(sub.lower())
+
+    def split(self, splitter=' ', maxsplit=0):
+        pattern = re.compile(re.escape(splitter), re.I)
+        return pattern.split(self, maxsplit)
diff --git a/lib/importlib_metadata/py.typed b/lib/importlib_metadata/py.typed
new file mode 100644
index 00000000..e69de29b
diff --git a/lib/mako/__init__.py b/lib/mako/__init__.py
index df2ae480..5ae55011 100644
--- a/lib/mako/__init__.py
+++ b/lib/mako/__init__.py
@@ -1,8 +1,8 @@
 # mako/__init__.py
-# Copyright 2006-2020 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2021 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
 
 
-__version__ = "1.1.6"
+__version__ = "1.2.0"
diff --git a/lib/mako/_ast_util.py b/lib/mako/_ast_util.py
index bdcdbf69..b8615335 100644
--- a/lib/mako/_ast_util.py
+++ b/lib/mako/_ast_util.py
@@ -1,5 +1,5 @@
 # mako/_ast_util.py
-# Copyright 2006-2020 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2021 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
@@ -47,7 +47,6 @@ from _ast import Sub
 from _ast import UAdd
 from _ast import USub
 
-from mako.compat import arg_stringname
 
 BOOLOP_SYMBOLS = {And: "and", Or: "or"}
 
@@ -94,9 +93,7 @@ def parse(expr, filename="<unknown>", mode="exec"):
 
 def iter_fields(node):
     """Iterate over all fields of a node, only yielding existing fields."""
-    # CPython 2.5 compat
-    if not hasattr(node, "_fields") or not node._fields:
-        return
+
     for field in node._fields:
         try:
             yield field, getattr(node, field)
@@ -104,7 +101,7 @@ def iter_fields(node):
             pass
 
 
-class NodeVisitor(object):
+class NodeVisitor:
 
     """
     Walks the abstract syntax tree and call visitor functions for every node
@@ -266,10 +263,10 @@ class SourceGenerator(NodeVisitor):
                 self.visit(default)
         if node.vararg is not None:
             write_comma()
-            self.write("*" + arg_stringname(node.vararg))
+            self.write("*" + node.vararg.arg)
         if node.kwarg is not None:
             write_comma()
-            self.write("**" + arg_stringname(node.kwarg))
+            self.write("**" + node.kwarg.arg)
 
     def decorators(self, node):
         for decorator in node.decorator_list:
diff --git a/lib/mako/ast.py b/lib/mako/ast.py
index cfae2806..f879e8b4 100644
--- a/lib/mako/ast.py
+++ b/lib/mako/ast.py
@@ -1,5 +1,5 @@
 # mako/ast.py
-# Copyright 2006-2020 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2021 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
@@ -9,12 +9,11 @@ code, as well as generating Python from AST nodes"""
 
 import re
 
-from mako import compat
 from mako import exceptions
 from mako import pyparser
 
 
-class PythonCode(object):
+class PythonCode:
 
     """represents information about a string containing Python code"""
 
@@ -39,7 +38,7 @@ class PythonCode(object):
         # - AST is less likely to break with version changes
         # (for example, the behavior of co_names changed a little bit
         # in python version 2.5)
-        if isinstance(code, compat.string_types):
+        if isinstance(code, str):
             expr = pyparser.parse(code.lstrip(), "exec", **exception_kwargs)
         else:
             expr = code
@@ -48,7 +47,7 @@ class PythonCode(object):
         f.visit(expr)
 
 
-class ArgumentList(object):
+class ArgumentList:
 
     """parses a fragment of code as a comma-separated list of expressions"""
 
@@ -57,7 +56,7 @@ class ArgumentList(object):
         self.args = []
         self.declared_identifiers = set()
         self.undeclared_identifiers = set()
-        if isinstance(code, compat.string_types):
+        if isinstance(code, str):
             if re.match(r"\S", code) and not re.match(r",\s*$", code):
                 # if theres text and no trailing comma, insure its parsed
                 # as a tuple by adding a trailing comma
@@ -88,7 +87,7 @@ class PythonFragment(PythonCode):
         if not m:
             raise exceptions.CompileException(
                 "Fragment '%s' is not a partial control statement" % code,
-                **exception_kwargs
+                **exception_kwargs,
             )
         if m.group(3):
             code = code[: m.start(3)]
@@ -97,7 +96,7 @@ class PythonFragment(PythonCode):
             code = code + "pass"
         elif keyword == "try":
             code = code + "pass\nexcept:pass"
-        elif keyword == "elif" or keyword == "else":
+        elif keyword in ["elif", "else"]:
             code = "if False:pass\n" + code + "pass"
         elif keyword == "except":
             code = "try:pass\n" + code + "pass"
@@ -106,12 +105,12 @@ class PythonFragment(PythonCode):
         else:
             raise exceptions.CompileException(
                 "Unsupported control keyword: '%s'" % keyword,
-                **exception_kwargs
+                **exception_kwargs,
             )
-        super(PythonFragment, self).__init__(code, **exception_kwargs)
+        super().__init__(code, **exception_kwargs)
 
 
-class FunctionDecl(object):
+class FunctionDecl:
 
     """function declaration"""
 
@@ -124,13 +123,13 @@ class FunctionDecl(object):
         if not hasattr(self, "funcname"):
             raise exceptions.CompileException(
                 "Code '%s' is not a function declaration" % code,
-                **exception_kwargs
+                **exception_kwargs,
             )
         if not allow_kwargs and self.kwargs:
             raise exceptions.CompileException(
                 "'**%s' keyword argument not allowed here"
                 % self.kwargnames[-1],
-                **exception_kwargs
+                **exception_kwargs,
             )
 
     def get_argument_expressions(self, as_call=False):
@@ -200,6 +199,4 @@ class FunctionArgs(FunctionDecl):
     """the argument portion of a function declaration"""
 
     def __init__(self, code, **kwargs):
-        super(FunctionArgs, self).__init__(
-            "def ANON(%s):pass" % code, **kwargs
-        )
+        super().__init__("def ANON(%s):pass" % code, **kwargs)
diff --git a/lib/mako/cache.py b/lib/mako/cache.py
index 26aa93ee..d77be271 100644
--- a/lib/mako/cache.py
+++ b/lib/mako/cache.py
@@ -1,10 +1,9 @@
 # mako/cache.py
-# Copyright 2006-2020 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2021 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
 
-from mako import compat
 from mako import util
 
 _cache_plugins = util.PluginLoader("mako.cache")
@@ -13,7 +12,7 @@ register_plugin = _cache_plugins.register
 register_plugin("beaker", "mako.ext.beaker_cache", "BeakerCacheImpl")
 
 
-class Cache(object):
+class Cache:
 
     """Represents a data content cache made available to the module
     space of a specific :class:`.Template` object.
@@ -66,7 +65,7 @@ class Cache(object):
     def __init__(self, template, *args):
         # check for a stale template calling the
         # constructor
-        if isinstance(template, compat.string_types) and args:
+        if isinstance(template, str) and args:
             return
         self.template = template
         self.id = template.module.__name__
@@ -181,7 +180,7 @@ class Cache(object):
         return tmpl_kw
 
 
-class CacheImpl(object):
+class CacheImpl:
 
     """Provide a cache implementation for use by :class:`.Cache`."""
 
diff --git a/lib/mako/cmd.py b/lib/mako/cmd.py
index c0f2c754..7592fb27 100755
--- a/lib/mako/cmd.py
+++ b/lib/mako/cmd.py
@@ -1,10 +1,9 @@
 # mako/cmd.py
-# Copyright 2006-2020 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2021 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
 from argparse import ArgumentParser
-import io
 from os.path import dirname
 from os.path import isfile
 import sys
@@ -85,16 +84,14 @@ def cmdline(argv=None):
         except:
             _exit()
 
-    kw = dict([varsplit(var) for var in options.var])
+    kw = dict(varsplit(var) for var in options.var)
     try:
         rendered = template.render(**kw)
     except:
         _exit()
     else:
         if output_file:
-            io.open(output_file, "wt", encoding=output_encoding).write(
-                rendered
-            )
+            open(output_file, "wt", encoding=output_encoding).write(rendered)
         else:
             sys.stdout.write(rendered)
 
diff --git a/lib/mako/codegen.py b/lib/mako/codegen.py
index a9ae55b8..c897f0ff 100644
--- a/lib/mako/codegen.py
+++ b/lib/mako/codegen.py
@@ -1,5 +1,5 @@
 # mako/codegen.py
-# Copyright 2006-2020 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2021 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
@@ -12,7 +12,6 @@ import re
 import time
 
 from mako import ast
-from mako import compat
 from mako import exceptions
 from mako import filters
 from mako import parsetree
@@ -25,8 +24,8 @@ MAGIC_NUMBER = 10
 # names which are hardwired into the
 # template and are not accessed via the
 # context itself
-TOPLEVEL_DECLARED = set(["UNDEFINED", "STOP_RENDERING"])
-RESERVED_NAMES = set(["context", "loop"]).union(TOPLEVEL_DECLARED)
+TOPLEVEL_DECLARED = {"UNDEFINED", "STOP_RENDERING"}
+RESERVED_NAMES = {"context", "loop"}.union(TOPLEVEL_DECLARED)
 
 
 def compile(  # noqa
@@ -39,20 +38,12 @@ def compile(  # noqa
     future_imports=None,
     source_encoding=None,
     generate_magic_comment=True,
-    disable_unicode=False,
     strict_undefined=False,
     enable_loop=True,
     reserved_names=frozenset(),
 ):
     """Generate module source code given a parsetree node,
-      uri, and optional source filename"""
-
-    # if on Py2K, push the "source_encoding" string to be
-    # a bytestring itself, as we will be embedding it into
-    # the generated source and we don't want to coerce the
-    # result into a unicode object, in "disable_unicode" mode
-    if not compat.py3k and isinstance(source_encoding, compat.text_type):
-        source_encoding = source_encoding.encode(source_encoding)
+    uri, and optional source filename"""
 
     buf = util.FastEncodingBuffer()
 
@@ -68,7 +59,6 @@ def compile(  # noqa
             future_imports,
             source_encoding,
             generate_magic_comment,
-            disable_unicode,
             strict_undefined,
             enable_loop,
             reserved_names,
@@ -78,7 +68,7 @@ def compile(  # noqa
     return buf.getvalue()
 
 
-class _CompileContext(object):
+class _CompileContext:
     def __init__(
         self,
         uri,
@@ -89,7 +79,6 @@ class _CompileContext(object):
         future_imports,
         source_encoding,
         generate_magic_comment,
-        disable_unicode,
         strict_undefined,
         enable_loop,
         reserved_names,
@@ -102,16 +91,15 @@ class _CompileContext(object):
         self.future_imports = future_imports
         self.source_encoding = source_encoding
         self.generate_magic_comment = generate_magic_comment
-        self.disable_unicode = disable_unicode
         self.strict_undefined = strict_undefined
         self.enable_loop = enable_loop
         self.reserved_names = reserved_names
 
 
-class _GenerateRenderMethod(object):
+class _GenerateRenderMethod:
 
     """A template visitor object which generates the
-       full module source for a template.
+    full module source for a template.
 
     """
 
@@ -196,7 +184,7 @@ class _GenerateRenderMethod(object):
 
         self.compiler.pagetag = None
 
-        class FindTopLevel(object):
+        class FindTopLevel:
             def visitInheritTag(s, node):
                 inherit.append(node)
 
@@ -392,7 +380,7 @@ class _GenerateRenderMethod(object):
                 identifiers = self.compiler.identifiers.branch(node)
                 self.in_def = True
 
-                class NSDefVisitor(object):
+                class NSDefVisitor:
                     def visitDefTag(s, node):
                         s.visitDefOrBase(node)
 
@@ -404,7 +392,7 @@ class _GenerateRenderMethod(object):
                             raise exceptions.CompileException(
                                 "Can't put anonymous blocks inside "
                                 "<%namespace>",
-                                **node.exception_kwargs
+                                **node.exception_kwargs,
                             )
                         self.write_inline_def(node, identifiers, nested=False)
                         export.append(node.funcname)
@@ -481,7 +469,7 @@ class _GenerateRenderMethod(object):
         """
 
         # collection of all defs available to us in this scope
-        comp_idents = dict([(c.funcname, c) for c in identifiers.defs])
+        comp_idents = {c.funcname: c for c in identifiers.defs}
         to_write = set()
 
         # write "context.get()" for all variables we are going to
@@ -714,7 +702,7 @@ class _GenerateRenderMethod(object):
         toplevel=False,
     ):
         """write a post-function decorator to replace a rendering
-            callable with a cached version of itself."""
+        callable with a cached version of itself."""
 
         self.printer.writeline("__M_%s = %s" % (name, name))
         cachekey = node_or_pagetag.parsed_attributes.get(
@@ -794,8 +782,6 @@ class _GenerateRenderMethod(object):
         def locate_encode(name):
             if re.match(r"decode\..+", name):
                 return "filters." + name
-            elif self.compiler.disable_unicode:
-                return filters.NON_UNICODE_ESCAPES.get(name, name)
             else:
                 return filters.DEFAULT_ESCAPES.get(name, name)
 
@@ -859,11 +845,11 @@ class _GenerateRenderMethod(object):
             #          and end control lines, and
             #    3) any control line with no content other than comments
             if not children or (
-                compat.all(
+                all(
                     isinstance(c, (parsetree.Comment, parsetree.ControlLine))
                     for c in children
                 )
-                and compat.all(
+                and all(
                     (node.is_ternary(c.keyword) or c.isend)
                     for c in children
                     if isinstance(c, parsetree.ControlLine)
@@ -969,7 +955,7 @@ class _GenerateRenderMethod(object):
 
         self.identifier_stack.append(body_identifiers)
 
-        class DefVisitor(object):
+        class DefVisitor:
             def visitDefTag(s, node):
                 s.visitDefOrBase(node)
 
@@ -1025,7 +1011,7 @@ class _GenerateRenderMethod(object):
         )
 
 
-class _Identifiers(object):
+class _Identifiers:
 
     """tracks the status of identifier names as template code is rendered."""
 
@@ -1098,7 +1084,7 @@ class _Identifiers(object):
 
     def branch(self, node, **kwargs):
         """create a new Identifiers for a new Node, with
-          this Identifiers as the parent."""
+        this Identifiers as the parent."""
 
         return _Identifiers(self.compiler, node, self, **kwargs)
 
@@ -1123,7 +1109,7 @@ class _Identifiers(object):
 
     def check_declared(self, node):
         """update the state of this Identifiers with the undeclared
-            and declared identifiers of the given node."""
+        and declared identifiers of the given node."""
 
         for ident in node.undeclared_identifiers():
             if ident != "context" and ident not in self.declared.union(
@@ -1170,7 +1156,7 @@ class _Identifiers(object):
             raise exceptions.CompileException(
                 "%%def or %%block named '%s' already "
                 "exists in this template." % node.funcname,
-                **node.exception_kwargs
+                **node.exception_kwargs,
             )
 
     def visitDefTag(self, node):
@@ -1200,7 +1186,7 @@ class _Identifiers(object):
                 raise exceptions.CompileException(
                     "Named block '%s' not allowed inside of def '%s'"
                     % (node.name, self.node.name),
-                    **node.exception_kwargs
+                    **node.exception_kwargs,
                 )
             elif isinstance(
                 self.node, (parsetree.CallTag, parsetree.CallNamespaceTag)
@@ -1208,7 +1194,7 @@ class _Identifiers(object):
                 raise exceptions.CompileException(
                     "Named block '%s' not allowed inside of <%%call> tag"
                     % (node.name,),
-                    **node.exception_kwargs
+                    **node.exception_kwargs,
                 )
 
         for ident in node.undeclared_identifiers():
@@ -1293,7 +1279,7 @@ def mangle_mako_loop(node, printer):
     return text
 
 
-class LoopVariable(object):
+class LoopVariable:
 
     """A node visitor which looks for the name 'loop' within undeclared
     identifiers."""
diff --git a/lib/mako/compat.py b/lib/mako/compat.py
index 06bb8d99..68bc03b1 100644
--- a/lib/mako/compat.py
+++ b/lib/mako/compat.py
@@ -1,19 +1,17 @@
 # mako/compat.py
-# Copyright 2006-2020 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2021 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
 
 import collections
+from importlib import util
 import inspect
 import sys
 
-py3k = sys.version_info >= (3, 0)
-py2k = sys.version_info < (3,)
-py27 = sys.version_info >= (2, 7)
-jython = sys.platform.startswith("java")
 win32 = sys.platform.startswith("win")
 pypy = hasattr(sys, "pypy_version_info")
+py38 = sys.version_info >= (3, 8)
 
 ArgSpec = collections.namedtuple(
     "ArgSpec", ["args", "varargs", "keywords", "defaults"]
@@ -26,15 +24,15 @@ def inspect_getargspec(func):
     if inspect.ismethod(func):
         func = func.__func__
     if not inspect.isfunction(func):
-        raise TypeError("{!r} is not a Python function".format(func))
+        raise TypeError(f"{func!r} is not a Python function")
 
     co = func.__code__
     if not inspect.iscode(co):
-        raise TypeError("{!r} is not a code object".format(co))
+        raise TypeError(f"{co!r} is not a code object")
 
     nargs = co.co_argcount
     names = co.co_varnames
-    nkwargs = co.co_kwonlyargcount if py3k else 0
+    nkwargs = co.co_kwonlyargcount
     args = list(names[:nargs])
 
     nargs += nkwargs
@@ -49,129 +47,30 @@ def inspect_getargspec(func):
     return ArgSpec(args, varargs, varkw, func.__defaults__)
 
 
-if py3k:
-    from io import StringIO
-    import builtins as compat_builtins
-    from urllib.parse import quote_plus, unquote_plus
-    from html.entities import codepoint2name, name2codepoint
-
-    string_types = (str,)
-    binary_type = bytes
-    text_type = str
-
-    from io import BytesIO as byte_buffer
-
-    def u(s):
-        return s
-
-    def b(s):
-        return s.encode("latin-1")
-
-    def octal(lit):
-        return eval("0o" + lit)
-
-
-else:
-    import __builtin__ as compat_builtins  # noqa
-
-    try:
-        from cStringIO import StringIO
-    except:
-        from StringIO import StringIO
-
-    byte_buffer = StringIO
-
-    from urllib import quote_plus, unquote_plus  # noqa
-    from htmlentitydefs import codepoint2name, name2codepoint  # noqa
-
-    string_types = (basestring,)  # noqa
-    binary_type = str
-    text_type = unicode  # noqa
-
-    def u(s):
-        return unicode(s, "utf-8")  # noqa
-
-    def b(s):
-        return s
-
-    def octal(lit):
-        return eval("0" + lit)
-
-
-if py3k:
-    from importlib import machinery, util
-
-    if hasattr(util, 'module_from_spec'):
-        # Python 3.5+
-        def load_module(module_id, path):
-            spec = util.spec_from_file_location(module_id, path)
-            module = util.module_from_spec(spec)
-            spec.loader.exec_module(module)
-            return module
-    else:
-        def load_module(module_id, path):
-            module = machinery.SourceFileLoader(module_id, path).load_module()
-            del sys.modules[module_id]
-            return module
-
-else:
-    import imp
-
-    def load_module(module_id, path):
-        fp = open(path, "rb")
-        try:
-            module = imp.load_source(module_id, path, fp)
-            del sys.modules[module_id]
-            return module
-        finally:
-            fp.close()
-
-
-if py3k:
-
-    def reraise(tp, value, tb=None, cause=None):
-        if cause is not None:
-            value.__cause__ = cause
-        if value.__traceback__ is not tb:
-            raise value.with_traceback(tb)
-        raise value
-
-
-else:
-    exec(
-        "def reraise(tp, value, tb=None, cause=None):\n"
-        "    raise tp, value, tb\n"
-    )
+def load_module(module_id, path):
+    spec = util.spec_from_file_location(module_id, path)
+    module = util.module_from_spec(spec)
+    spec.loader.exec_module(module)
+    return module
 
 
 def exception_as():
     return sys.exc_info()[1]
 
 
-all = all  # noqa
-
-
 def exception_name(exc):
     return exc.__class__.__name__
 
 
-################################################
-# cross-compatible metaclass implementation
-# Copyright (c) 2010-2012 Benjamin Peterson
-def with_metaclass(meta, base=object):
-    """Create a base class with a metaclass."""
-    return meta("%sBase" % meta.__name__, (base,), {})
+if py38:
+    from importlib import metadata as importlib_metadata
+else:
+    import importlib_metadata  # noqa
 
 
-################################################
-
-
-def arg_stringname(func_arg):
-    """Gets the string name of a kwarg or vararg
-    In Python3.4 a function's args are
-    of _ast.arg type not _ast.name
-    """
-    if hasattr(func_arg, "arg"):
-        return func_arg.arg
+def importlib_metadata_get(group):
+    ep = importlib_metadata.entry_points()
+    if hasattr(ep, "select"):
+        return ep.select(group=group)
     else:
-        return str(func_arg)
+        return ep.get(group, ())
diff --git a/lib/mako/exceptions.py b/lib/mako/exceptions.py
index ea7b20db..a0a5feca 100644
--- a/lib/mako/exceptions.py
+++ b/lib/mako/exceptions.py
@@ -1,5 +1,5 @@
 # mako/exceptions.py
-# Copyright 2006-2020 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2021 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
@@ -68,7 +68,7 @@ class TopLevelLookupException(TemplateLookupException):
     pass
 
 
-class RichTraceback(object):
+class RichTraceback:
 
     """Pull the current exception from the ``sys`` traceback and extracts
     Mako-specific template information.
@@ -106,7 +106,7 @@ class RichTraceback(object):
     def _init_message(self):
         """Find a unicode representation of self.error"""
         try:
-            self.message = compat.text_type(self.error)
+            self.message = str(self.error)
         except UnicodeError:
             try:
                 self.message = str(self.error)
@@ -114,8 +114,8 @@ class RichTraceback(object):
                 # Fallback to args as neither unicode nor
                 # str(Exception(u'\xe6')) work in Python < 2.6
                 self.message = self.error.args[0]
-        if not isinstance(self.message, compat.text_type):
-            self.message = compat.text_type(self.message, "ascii", "replace")
+        if not isinstance(self.message, str):
+            self.message = str(self.message, "ascii", "replace")
 
     def _get_reformatted_records(self, records):
         for rec in records:
@@ -139,8 +139,7 @@ class RichTraceback(object):
 
     @property
     def reverse_traceback(self):
-        """Return the same data as traceback, except in reverse order.
-        """
+        """Return the same data as traceback, except in reverse order."""
 
         return list(self._get_reformatted_records(self.reverse_records))
 
@@ -170,17 +169,6 @@ class RichTraceback(object):
                     )
                 except KeyError:
                     # A normal .py file (not a Template)
-                    if not compat.py3k:
-                        try:
-                            fp = open(filename, "rb")
-                            encoding = util.parse_encoding(fp)
-                            fp.close()
-                        except IOError:
-                            encoding = None
-                        if encoding:
-                            line = line.decode(encoding)
-                        else:
-                            line = line.decode("ascii", "replace")
                     new_trcback.append(
                         (
                             filename,
@@ -236,13 +224,12 @@ class RichTraceback(object):
                 if new_trcback:
                     try:
                         # A normal .py file (not a Template)
-                        fp = open(new_trcback[-1][0], "rb")
-                        encoding = util.parse_encoding(fp)
-                        if compat.py3k and not encoding:
-                            encoding = "utf-8"
-                        fp.seek(0)
-                        self.source = fp.read()
-                        fp.close()
+                        with open(new_trcback[-1][0], "rb") as fp:
+                            encoding = util.parse_encoding(fp)
+                            if not encoding:
+                                encoding = "utf-8"
+                            fp.seek(0)
+                            self.source = fp.read()
                         if encoding:
                             self.source = self.source.decode(encoding)
                     except IOError:
diff --git a/lib/mako/ext/autohandler.py b/lib/mako/ext/autohandler.py
index 8b1324ef..e8fdac89 100644
--- a/lib/mako/ext/autohandler.py
+++ b/lib/mako/ext/autohandler.py
@@ -1,5 +1,5 @@
 # ext/autohandler.py
-# Copyright 2006-2020 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2021 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
diff --git a/lib/mako/ext/babelplugin.py b/lib/mako/ext/babelplugin.py
index 76bbc5b0..f015ec25 100644
--- a/lib/mako/ext/babelplugin.py
+++ b/lib/mako/ext/babelplugin.py
@@ -1,10 +1,10 @@
 # ext/babelplugin.py
-# Copyright 2006-2020 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2021 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
 
-"""gettext message extraction via Babel: http://babel.edgewall.org/"""
+"""gettext message extraction via Babel: https://pypi.org/project/Babel/"""
 from babel.messages.extract import extract_python
 
 from mako.ext.extract import MessageExtractor
@@ -15,12 +15,12 @@ class BabelMakoExtractor(MessageExtractor):
         self.keywords = keywords
         self.options = options
         self.config = {
-            "comment-tags": u" ".join(comment_tags),
+            "comment-tags": " ".join(comment_tags),
             "encoding": options.get(
                 "input_encoding", options.get("encoding", None)
             ),
         }
-        super(BabelMakoExtractor, self).__init__()
+        super().__init__()
 
     def __call__(self, fileobj):
         return self.process_file(fileobj)
@@ -54,5 +54,4 @@ def extract(fileobj, keywords, comment_tags, options):
     :rtype: ``iterator``
     """
     extractor = BabelMakoExtractor(keywords, comment_tags, options)
-    for message in extractor(fileobj):
-        yield message
+    yield from extractor(fileobj)
diff --git a/lib/mako/ext/beaker_cache.py b/lib/mako/ext/beaker_cache.py
index f65ce43a..a40b09cf 100644
--- a/lib/mako/ext/beaker_cache.py
+++ b/lib/mako/ext/beaker_cache.py
@@ -1,5 +1,5 @@
 # ext/beaker_cache.py
-# Copyright 2006-2020 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2021 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
@@ -40,7 +40,7 @@ class BeakerCacheImpl(CacheImpl):
                 _beaker_cache = cache.template.cache_args["manager"]
             else:
                 _beaker_cache = beaker_cache.CacheManager()
-        super(BeakerCacheImpl, self).__init__(cache)
+        super().__init__(cache)
 
     def _get_cache(self, **kw):
         expiretime = kw.pop("timeout", None)
diff --git a/lib/mako/ext/extract.py b/lib/mako/ext/extract.py
index ad2348a5..74d067d8 100644
--- a/lib/mako/ext/extract.py
+++ b/lib/mako/ext/extract.py
@@ -1,23 +1,25 @@
 # ext/extract.py
-# Copyright 2006-2020 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2021 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
 
+from io import BytesIO
+from io import StringIO
 import re
 
-from mako import compat
 from mako import lexer
 from mako import parsetree
 
 
-class MessageExtractor(object):
+class MessageExtractor:
+    use_bytes = True
+
     def process_file(self, fileobj):
         template_node = lexer.Lexer(
             fileobj.read(), input_encoding=self.config["encoding"]
         ).parse()
-        for extracted in self.extract_nodes(template_node.get_children()):
-            yield extracted
+        yield from self.extract_nodes(template_node.get_children())
 
     def extract_nodes(self, nodes):
         translator_comments = []
@@ -90,7 +92,7 @@ class MessageExtractor(object):
                 comment[1] for comment in translator_comments
             ]
 
-            if isinstance(code, compat.text_type):
+            if isinstance(code, str) and self.use_bytes:
                 code = code.encode(input_encoding, "backslashreplace")
 
             used_translator_comments = False
@@ -99,7 +101,10 @@ class MessageExtractor(object):
             # input string of the input is non-ascii)
             # Also, because we added it, we have to subtract one from
             # node.lineno
-            code = compat.byte_buffer(compat.b("\n") + code)
+            if self.use_bytes:
+                code = BytesIO(b"\n" + code)
+            else:
+                code = StringIO("\n" + code)
 
             for message in self.process_python(
                 code, node.lineno - 1, translator_strings
@@ -112,8 +117,7 @@ class MessageExtractor(object):
             in_translator_comments = False
 
             if child_nodes:
-                for extracted in self.extract_nodes(child_nodes):
-                    yield extracted
+                yield from self.extract_nodes(child_nodes)
 
     @staticmethod
     def _split_comment(lineno, comment):
diff --git a/lib/mako/ext/linguaplugin.py b/lib/mako/ext/linguaplugin.py
index c40fa748..4cce6262 100644
--- a/lib/mako/ext/linguaplugin.py
+++ b/lib/mako/ext/linguaplugin.py
@@ -1,23 +1,23 @@
 # ext/linguaplugin.py
-# Copyright 2006-2020 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2021 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
 
+import contextlib
 import io
 
 from lingua.extractors import Extractor
 from lingua.extractors import get_extractor
 from lingua.extractors import Message
 
-from mako import compat
 from mako.ext.extract import MessageExtractor
 
 
 class LinguaMakoExtractor(Extractor, MessageExtractor):
-
     """Mako templates"""
 
+    use_bytes = False
     extensions = [".mako"]
     default_config = {"encoding": "utf-8", "comment-tags": ""}
 
@@ -26,29 +26,21 @@ class LinguaMakoExtractor(Extractor, MessageExtractor):
         self.filename = filename
         self.python_extractor = get_extractor("x.py")
         if fileobj is None:
-            fileobj = open(filename, "rb")
-            must_close = True
+            ctx = open(filename, "r")
         else:
-            must_close = False
-        try:
-            for message in self.process_file(fileobj):
-                yield message
-        finally:
-            if must_close:
-                fileobj.close()
+            ctx = contextlib.nullcontext(fileobj)
+        with ctx as file_:
+            yield from self.process_file(file_)
 
     def process_python(self, code, code_lineno, translator_strings):
         source = code.getvalue().strip()
-        if source.endswith(compat.b(":")):
-            if source in (
-                compat.b("try:"),
-                compat.b("else:"),
-            ) or source.startswith(compat.b("except")):
-                source = compat.b("")  # Ignore try/except and else
-            elif source.startswith(compat.b("elif")):
+        if source.endswith(":"):
+            if source in ("try:", "else:") or source.startswith("except"):
+                source = ""  # Ignore try/except and else
+            elif source.startswith("elif"):
                 source = source[2:]  # Replace "elif" with "if"
-            source += compat.b("pass")
-        code = io.BytesIO(source)
+            source += "pass"
+        code = io.StringIO(source)
         for msg in self.python_extractor(
             self.filename, self.options, code, code_lineno - 1
         ):
@@ -58,7 +50,7 @@ class LinguaMakoExtractor(Extractor, MessageExtractor):
                     msg.msgid,
                     msg.msgid_plural,
                     msg.flags,
-                    compat.u(" ").join(translator_strings + [msg.comment]),
+                    " ".join(translator_strings + [msg.comment]),
                     msg.tcomment,
                     msg.location,
                 )
diff --git a/lib/mako/ext/preprocessors.py b/lib/mako/ext/preprocessors.py
index 9cc06214..6855eeb4 100644
--- a/lib/mako/ext/preprocessors.py
+++ b/lib/mako/ext/preprocessors.py
@@ -1,5 +1,5 @@
 # ext/preprocessors.py
-# Copyright 2006-2020 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2021 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
diff --git a/lib/mako/ext/pygmentplugin.py b/lib/mako/ext/pygmentplugin.py
index 943a67a4..38d6a71b 100644
--- a/lib/mako/ext/pygmentplugin.py
+++ b/lib/mako/ext/pygmentplugin.py
@@ -1,5 +1,5 @@
 # ext/pygmentplugin.py
-# Copyright 2006-2020 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2021 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
@@ -25,8 +25,6 @@ from pygments.token import Other
 from pygments.token import String
 from pygments.token import Text
 
-from mako import compat
-
 
 class MakoLexer(RegexLexer):
     name = "Mako"
@@ -108,7 +106,7 @@ class MakoHtmlLexer(DelegatingLexer):
     aliases = ["html+mako"]
 
     def __init__(self, **options):
-        super(MakoHtmlLexer, self).__init__(HtmlLexer, MakoLexer, **options)
+        super().__init__(HtmlLexer, MakoLexer, **options)
 
 
 class MakoXmlLexer(DelegatingLexer):
@@ -116,7 +114,7 @@ class MakoXmlLexer(DelegatingLexer):
     aliases = ["xml+mako"]
 
     def __init__(self, **options):
-        super(MakoXmlLexer, self).__init__(XmlLexer, MakoLexer, **options)
+        super().__init__(XmlLexer, MakoLexer, **options)
 
 
 class MakoJavascriptLexer(DelegatingLexer):
@@ -124,9 +122,7 @@ class MakoJavascriptLexer(DelegatingLexer):
     aliases = ["js+mako", "javascript+mako"]
 
     def __init__(self, **options):
-        super(MakoJavascriptLexer, self).__init__(
-            JavascriptLexer, MakoLexer, **options
-        )
+        super().__init__(JavascriptLexer, MakoLexer, **options)
 
 
 class MakoCssLexer(DelegatingLexer):
@@ -134,7 +130,7 @@ class MakoCssLexer(DelegatingLexer):
     aliases = ["css+mako"]
 
     def __init__(self, **options):
-        super(MakoCssLexer, self).__init__(CssLexer, MakoLexer, **options)
+        super().__init__(CssLexer, MakoLexer, **options)
 
 
 pygments_html_formatter = HtmlFormatter(
@@ -144,10 +140,7 @@ pygments_html_formatter = HtmlFormatter(
 
 def syntax_highlight(filename="", language=None):
     mako_lexer = MakoLexer()
-    if compat.py3k:
-        python_lexer = Python3Lexer()
-    else:
-        python_lexer = PythonLexer()
+    python_lexer = Python3Lexer()
     if filename.startswith("memory:") or language == "mako":
         return lambda string: highlight(
             string, mako_lexer, pygments_html_formatter
diff --git a/lib/mako/ext/turbogears.py b/lib/mako/ext/turbogears.py
index 722a6b4b..413d9f74 100644
--- a/lib/mako/ext/turbogears.py
+++ b/lib/mako/ext/turbogears.py
@@ -1,5 +1,5 @@
 # ext/turbogears.py
-# Copyright 2006-2020 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2021 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
@@ -9,7 +9,7 @@ from mako.lookup import TemplateLookup
 from mako.template import Template
 
 
-class TGPlugin(object):
+class TGPlugin:
 
     """TurboGears compatible Template Plugin."""
 
@@ -51,7 +51,7 @@ class TGPlugin(object):
     def render(
         self, info, format="html", fragment=False, template=None  # noqa
     ):
-        if isinstance(template, compat.string_types):
+        if isinstance(template, str):
             template = self.load_template(template)
 
         # Load extra vars func if provided
diff --git a/lib/mako/filters.py b/lib/mako/filters.py
index 0ae33ff4..26edd8ee 100644
--- a/lib/mako/filters.py
+++ b/lib/mako/filters.py
@@ -1,18 +1,19 @@
 # mako/filters.py
-# Copyright 2006-2020 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2021 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
 
 
 import codecs
+from html.entities import codepoint2name
+from html.entities import name2codepoint
 import re
+from urllib.parse import quote_plus
 
-from mako import compat
-from mako.compat import codepoint2name
-from mako.compat import name2codepoint
-from mako.compat import quote_plus
-from mako.compat import unquote_plus
+import markupsafe
+
+html_escape = markupsafe.escape
 
 xml_escapes = {
     "&": "&amp;",
@@ -22,27 +23,6 @@ xml_escapes = {
     "'": "&#39;",  # also &apos; in html-only
 }
 
-# XXX: &quot; is valid in HTML and XML
-#      &apos; is not valid HTML, but is valid XML
-
-
-def legacy_html_escape(s):
-    """legacy HTML escape for non-unicode mode."""
-    s = s.replace("&", "&amp;")
-    s = s.replace(">", "&gt;")
-    s = s.replace("<", "&lt;")
-    s = s.replace('"', "&#34;")
-    s = s.replace("'", "&#39;")
-    return s
-
-
-try:
-    import markupsafe
-
-    html_escape = markupsafe.escape
-except ImportError:
-    html_escape = legacy_html_escape
-
 
 def xml_escape(string):
     return re.sub(r'([&<"\'>])', lambda m: xml_escapes[m.group()], string)
@@ -54,31 +34,19 @@ def url_escape(string):
     return quote_plus(string)
 
 
-def legacy_url_escape(string):
-    # convert into a list of octets
-    return quote_plus(string)
-
-
-def url_unescape(string):
-    text = unquote_plus(string)
-    if not is_ascii_str(text):
-        text = text.decode("utf8")
-    return text
-
-
 def trim(string):
     return string.strip()
 
 
-class Decode(object):
+class Decode:
     def __getattr__(self, key):
         def decode(x):
-            if isinstance(x, compat.text_type):
+            if isinstance(x, str):
                 return x
-            elif not isinstance(x, compat.binary_type):
+            elif not isinstance(x, bytes):
                 return decode(str(x))
             else:
-                return compat.text_type(x, encoding=key)
+                return str(x, encoding=key)
 
         return decode
 
@@ -86,24 +54,11 @@ class Decode(object):
 decode = Decode()
 
 
-_ASCII_re = re.compile(r"\A[\x00-\x7f]*\Z")
-
-
-def is_ascii_str(text):
-    return isinstance(text, str) and _ASCII_re.match(text)
-
-
-################################################################
-
-
-class XMLEntityEscaper(object):
+class XMLEntityEscaper:
     def __init__(self, codepoint2name, name2codepoint):
-        self.codepoint2entity = dict(
-            [
-                (c, compat.text_type("&%s;" % n))
-                for c, n in codepoint2name.items()
-            ]
-        )
+        self.codepoint2entity = {
+            c: str("&%s;" % n) for c, n in codepoint2name.items()
+        }
         self.name2codepoint = name2codepoint
 
     def escape_entities(self, text):
@@ -111,7 +66,7 @@ class XMLEntityEscaper(object):
 
         Only characters corresponding to a named entity are replaced.
         """
-        return compat.text_type(text).translate(self.codepoint2entity)
+        return str(text).translate(self.codepoint2entity)
 
     def __escape(self, m):
         codepoint = ord(m.group())
@@ -131,9 +86,7 @@ class XMLEntityEscaper(object):
 
         The return value is guaranteed to be ASCII.
         """
-        return self.__escapable.sub(
-            self.__escape, compat.text_type(text)
-        ).encode("ascii")
+        return self.__escapable.sub(self.__escape, str(text)).encode("ascii")
 
     # XXX: This regexp will not match all valid XML entity names__.
     # (It punts on details involving involving CombiningChars and Extenders.)
@@ -183,37 +136,28 @@ def htmlentityreplace_errors(ex):
     characters with HTML entities, or, if no HTML entity exists for
     the character, XML character references::
 
-        >>> u'The cost was \u20ac12.'.encode('latin1', 'htmlentityreplace')
+        >>> 'The cost was \u20ac12.'.encode('latin1', 'htmlentityreplace')
         'The cost was &euro;12.'
     """
     if isinstance(ex, UnicodeEncodeError):
         # Handle encoding errors
         bad_text = ex.object[ex.start : ex.end]
         text = _html_entities_escaper.escape(bad_text)
-        return (compat.text_type(text), ex.end)
+        return (str(text), ex.end)
     raise ex
 
 
 codecs.register_error("htmlentityreplace", htmlentityreplace_errors)
 
 
-# TODO: options to make this dynamic per-compilation will be added in a later
-# release
 DEFAULT_ESCAPES = {
     "x": "filters.xml_escape",
     "h": "filters.html_escape",
     "u": "filters.url_escape",
     "trim": "filters.trim",
     "entity": "filters.html_entities_escape",
-    "unicode": "unicode",
+    "unicode": "str",
     "decode": "decode",
     "str": "str",
     "n": "n",
 }
-
-if compat.py3k:
-    DEFAULT_ESCAPES.update({"unicode": "str"})
-
-NON_UNICODE_ESCAPES = DEFAULT_ESCAPES.copy()
-NON_UNICODE_ESCAPES["h"] = "filters.legacy_html_escape"
-NON_UNICODE_ESCAPES["u"] = "filters.legacy_url_escape"
diff --git a/lib/mako/lexer.py b/lib/mako/lexer.py
index bbf0c3a5..527c4b51 100644
--- a/lib/mako/lexer.py
+++ b/lib/mako/lexer.py
@@ -1,5 +1,5 @@
 # mako/lexer.py
-# Copyright 2006-2020 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2021 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
@@ -9,7 +9,6 @@
 import codecs
 import re
 
-from mako import compat
 from mako import exceptions
 from mako import parsetree
 from mako.pygen import adjust_whitespace
@@ -17,14 +16,9 @@ from mako.pygen import adjust_whitespace
 _regexp_cache = {}
 
 
-class Lexer(object):
+class Lexer:
     def __init__(
-        self,
-        text,
-        filename=None,
-        disable_unicode=False,
-        input_encoding=None,
-        preprocessor=None,
+        self, text, filename=None, input_encoding=None, preprocessor=None
     ):
         self.text = text
         self.filename = filename
@@ -36,14 +30,8 @@ class Lexer(object):
         self.tag = []
         self.control_line = []
         self.ternary_stack = []
-        self.disable_unicode = disable_unicode
         self.encoding = input_encoding
 
-        if compat.py3k and disable_unicode:
-            raise exceptions.UnsupportedError(
-                "Mako for Python 3 does not " "support disabling Unicode"
-            )
-
         if preprocessor is None:
             self.preprocessor = []
         elif not hasattr(preprocessor, "__iter__"):
@@ -66,10 +54,7 @@ class Lexer(object):
         try:
             reg = _regexp_cache[(regexp, flags)]
         except KeyError:
-            if flags:
-                reg = re.compile(regexp, flags)
-            else:
-                reg = re.compile(regexp)
+            reg = re.compile(regexp, flags) if flags else re.compile(regexp)
             _regexp_cache[(regexp, flags)] = reg
 
         return self.match_reg(reg)
@@ -87,10 +72,7 @@ class Lexer(object):
         match = reg.match(self.text, self.match_position)
         if match:
             (start, end) = match.span()
-            if end == start:
-                self.match_position = end + 1
-            else:
-                self.match_position = end
+            self.match_position = end + 1 if end == start else end
             self.matched_lineno = self.lineno
             lines = re.findall(r"\n", self.text[mp : self.match_position])
             cp = mp - 1
@@ -98,10 +80,6 @@ class Lexer(object):
                 cp -= 1
             self.matched_charpos = mp - cp
             self.lineno += len(lines)
-            # print "MATCHED:", match.group(0), "LINE START:",
-            # self.matched_lineno, "LINE END:", self.lineno
-        # print "MATCH:", regexp, "\n", self.text[mp : mp + 15], \
-        #          (match and "TRUE" or "FALSE")
         return match
 
     def parse_until_text(self, watch_nesting, *text):
@@ -161,12 +139,15 @@ class Lexer(object):
         if self.control_line:
             control_frame = self.control_line[-1]
             control_frame.nodes.append(node)
-            if not (
-                isinstance(node, parsetree.ControlLine)
-                and control_frame.is_ternary(node.keyword)
+            if (
+                not (
+                    isinstance(node, parsetree.ControlLine)
+                    and control_frame.is_ternary(node.keyword)
+                )
+                and self.ternary_stack
+                and self.ternary_stack[-1]
             ):
-                if self.ternary_stack and self.ternary_stack[-1]:
-                    self.ternary_stack[-1][-1].nodes.append(node)
+                self.ternary_stack[-1][-1].nodes.append(node)
         if isinstance(node, parsetree.Tag):
             if len(self.tag):
                 node.parent = self.tag[-1]
@@ -188,18 +169,18 @@ class Lexer(object):
                 raise exceptions.SyntaxException(
                     "Keyword '%s' not a legal ternary for keyword '%s'"
                     % (node.keyword, self.control_line[-1].keyword),
-                    **self.exception_kwargs
+                    **self.exception_kwargs,
                 )
 
     _coding_re = re.compile(r"#.*coding[:=]\s*([-\w.]+).*\r?\n")
 
     def decode_raw_stream(self, text, decode_raw, known_encoding, filename):
         """given string/unicode or bytes/string, determine encoding
-           from magic encoding comment, return body as unicode
-           or raw if decode_raw=False
+        from magic encoding comment, return body as unicode
+        or raw if decode_raw=False
 
         """
-        if isinstance(text, compat.text_type):
+        if isinstance(text, str):
             m = self._coding_re.match(text)
             encoding = m and m.group(1) or known_encoding or "utf-8"
             return encoding, text
@@ -219,11 +200,7 @@ class Lexer(object):
                 )
         else:
             m = self._coding_re.match(text.decode("utf-8", "ignore"))
-            if m:
-                parsed_encoding = m.group(1)
-            else:
-                parsed_encoding = known_encoding or "utf-8"
-
+            parsed_encoding = m.group(1) if m else known_encoding or "utf-8"
         if decode_raw:
             try:
                 text = text.decode(parsed_encoding)
@@ -241,7 +218,7 @@ class Lexer(object):
 
     def parse(self):
         self.encoding, self.text = self.decode_raw_stream(
-            self.text, not self.disable_unicode, self.encoding, self.filename
+            self.text, True, self.encoding, self.filename
         )
 
         for preproc in self.preprocessor:
@@ -276,12 +253,13 @@ class Lexer(object):
 
             if self.match_position > self.textlength:
                 break
-            raise exceptions.CompileException("assertion failed")
+            # TODO: no coverage here
+            raise exceptions.MakoException("assertion failed")
 
         if len(self.tag):
             raise exceptions.SyntaxException(
                 "Unclosed tag: <%%%s>" % self.tag[-1].keyword,
-                **self.exception_kwargs
+                **self.exception_kwargs,
             )
         if len(self.control_line):
             raise exceptions.SyntaxException(
@@ -312,35 +290,34 @@ class Lexer(object):
             re.I | re.S | re.X,
         )
 
-        if match:
-            keyword, attr, isend = match.groups()
-            self.keyword = keyword
-            attributes = {}
-            if attr:
-                for att in re.findall(
-                    r"\s*(\w+)\s*=\s*(?:'([^']*)'|\"([^\"]*)\")", attr
-                ):
-                    key, val1, val2 = att
-                    text = val1 or val2
-                    text = text.replace("\r\n", "\n")
-                    attributes[key] = text
-            self.append_node(parsetree.Tag, keyword, attributes)
-            if isend:
-                self.tag.pop()
-            else:
-                if keyword == "text":
-                    match = self.match(r"(.*?)(?=\</%text>)", re.S)
-                    if not match:
-                        raise exceptions.SyntaxException(
-                            "Unclosed tag: <%%%s>" % self.tag[-1].keyword,
-                            **self.exception_kwargs
-                        )
-                    self.append_node(parsetree.Text, match.group(1))
-                    return self.match_tag_end()
-            return True
-        else:
+        if not match:
             return False
 
+        keyword, attr, isend = match.groups()
+        self.keyword = keyword
+        attributes = {}
+        if attr:
+            for att in re.findall(
+                r"\s*(\w+)\s*=\s*(?:'([^']*)'|\"([^\"]*)\")", attr
+            ):
+                key, val1, val2 = att
+                text = val1 or val2
+                text = text.replace("\r\n", "\n")
+                attributes[key] = text
+        self.append_node(parsetree.Tag, keyword, attributes)
+        if isend:
+            self.tag.pop()
+        elif keyword == "text":
+            match = self.match(r"(.*?)(?=\</%text>)", re.S)
+            if not match:
+                raise exceptions.SyntaxException(
+                    "Unclosed tag: <%%%s>" % self.tag[-1].keyword,
+                    **self.exception_kwargs,
+                )
+            self.append_node(parsetree.Text, match.group(1))
+            return self.match_tag_end()
+        return True
+
     def match_tag_end(self):
         match = self.match(r"\</%[\t ]*(.+?)[\t ]*>")
         if match:
@@ -348,13 +325,13 @@ class Lexer(object):
                 raise exceptions.SyntaxException(
                     "Closing tag without opening tag: </%%%s>"
                     % match.group(1),
-                    **self.exception_kwargs
+                    **self.exception_kwargs,
                 )
             elif self.tag[-1].keyword != match.group(1):
                 raise exceptions.SyntaxException(
                     "Closing tag </%%%s> does not match tag: <%%%s>"
                     % (match.group(1), self.tag[-1].keyword),
-                    **self.exception_kwargs
+                    **self.exception_kwargs,
                 )
             self.tag.pop()
             return True
@@ -363,15 +340,15 @@ class Lexer(object):
 
     def match_end(self):
         match = self.match(r"\Z", re.S)
-        if match:
-            string = match.group()
-            if string:
-                return string
-            else:
-                return True
-        else:
+        if not match:
             return False
 
+        string = match.group()
+        if string:
+            return string
+        else:
+            return True
+
     def match_text(self):
         match = self.match(
             r"""
@@ -422,64 +399,63 @@ class Lexer(object):
 
     def match_expression(self):
         match = self.match(r"\${")
-        if match:
-            line, pos = self.matched_lineno, self.matched_charpos
-            text, end = self.parse_until_text(True, r"\|", r"}")
-            if end == "|":
-                escapes, end = self.parse_until_text(True, r"}")
-            else:
-                escapes = ""
-            text = text.replace("\r\n", "\n")
-            self.append_node(
-                parsetree.Expression,
-                text,
-                escapes.strip(),
-                lineno=line,
-                pos=pos,
-            )
-            return True
-        else:
+        if not match:
             return False
 
+        line, pos = self.matched_lineno, self.matched_charpos
+        text, end = self.parse_until_text(True, r"\|", r"}")
+        if end == "|":
+            escapes, end = self.parse_until_text(True, r"}")
+        else:
+            escapes = ""
+        text = text.replace("\r\n", "\n")
+        self.append_node(
+            parsetree.Expression,
+            text,
+            escapes.strip(),
+            lineno=line,
+            pos=pos,
+        )
+        return True
+
     def match_control_line(self):
         match = self.match(
             r"(?<=^)[\t ]*(%(?!%)|##)[\t ]*((?:(?:\\\r?\n)|[^\r\n])*)"
             r"(?:\r?\n|\Z)",
             re.M,
         )
-        if match:
-            operator = match.group(1)
-            text = match.group(2)
-            if operator == "%":
-                m2 = re.match(r"(end)?(\w+)\s*(.*)", text)
-                if not m2:
-                    raise exceptions.SyntaxException(
-                        "Invalid control line: '%s'" % text,
-                        **self.exception_kwargs
-                    )
-                isend, keyword = m2.group(1, 2)
-                isend = isend is not None
-
-                if isend:
-                    if not len(self.control_line):
-                        raise exceptions.SyntaxException(
-                            "No starting keyword '%s' for '%s'"
-                            % (keyword, text),
-                            **self.exception_kwargs
-                        )
-                    elif self.control_line[-1].keyword != keyword:
-                        raise exceptions.SyntaxException(
-                            "Keyword '%s' doesn't match keyword '%s'"
-                            % (text, self.control_line[-1].keyword),
-                            **self.exception_kwargs
-                        )
-                self.append_node(parsetree.ControlLine, keyword, isend, text)
-            else:
-                self.append_node(parsetree.Comment, text)
-            return True
-        else:
+        if not match:
             return False
 
+        operator = match.group(1)
+        text = match.group(2)
+        if operator == "%":
+            m2 = re.match(r"(end)?(\w+)\s*(.*)", text)
+            if not m2:
+                raise exceptions.SyntaxException(
+                    "Invalid control line: '%s'" % text,
+                    **self.exception_kwargs,
+                )
+            isend, keyword = m2.group(1, 2)
+            isend = isend is not None
+
+            if isend:
+                if not len(self.control_line):
+                    raise exceptions.SyntaxException(
+                        "No starting keyword '%s' for '%s'" % (keyword, text),
+                        **self.exception_kwargs,
+                    )
+                elif self.control_line[-1].keyword != keyword:
+                    raise exceptions.SyntaxException(
+                        "Keyword '%s' doesn't match keyword '%s'"
+                        % (text, self.control_line[-1].keyword),
+                        **self.exception_kwargs,
+                    )
+            self.append_node(parsetree.ControlLine, keyword, isend, text)
+        else:
+            self.append_node(parsetree.Comment, text)
+        return True
+
     def match_comment(self):
         """matches the multiline version of a comment"""
         match = self.match(r"<%doc>(.*?)</%doc>", re.S)
diff --git a/lib/mako/lookup.py b/lib/mako/lookup.py
index 476326d4..7afe242b 100644
--- a/lib/mako/lookup.py
+++ b/lib/mako/lookup.py
@@ -1,5 +1,5 @@
 # mako/lookup.py
-# Copyright 2006-2020 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2021 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
@@ -8,18 +8,14 @@ import os
 import posixpath
 import re
 import stat
+import threading
 
 from mako import exceptions
 from mako import util
 from mako.template import Template
 
-try:
-    import threading
-except:
-    import dummy_threading as threading
 
-
-class TemplateCollection(object):
+class TemplateCollection:
 
     """Represent a collection of :class:`.Template` objects,
     identifiable via URI.
@@ -34,7 +30,7 @@ class TemplateCollection(object):
     :class:`.TemplateCollection` is an abstract class,
     with the usual default implementation being :class:`.TemplateLookup`.
 
-     """
+    """
 
     def has_template(self, uri):
         """Return ``True`` if this :class:`.TemplateLookup` is
@@ -68,7 +64,7 @@ class TemplateCollection(object):
 
     def filename_to_uri(self, uri, filename):
         """Convert the given ``filename`` to a URI relative to
-           this :class:`.TemplateCollection`."""
+        this :class:`.TemplateCollection`."""
 
         return uri
 
@@ -161,8 +157,6 @@ class TemplateLookup(TemplateCollection):
         collection_size=-1,
         format_exceptions=False,
         error_handler=None,
-        disable_unicode=False,
-        bytestring_passthrough=False,
         output_encoding=None,
         encoding_errors="strict",
         cache_args=None,
@@ -207,8 +201,6 @@ class TemplateLookup(TemplateCollection):
             "format_exceptions": format_exceptions,
             "error_handler": error_handler,
             "include_error_handler": include_error_handler,
-            "disable_unicode": disable_unicode,
-            "bytestring_passthrough": bytestring_passthrough,
             "output_encoding": output_encoding,
             "cache_impl": cache_impl,
             "encoding_errors": encoding_errors,
@@ -249,7 +241,7 @@ class TemplateLookup(TemplateCollection):
                 return self._check(uri, self._collection[uri])
             else:
                 return self._collection[uri]
-        except KeyError:
+        except KeyError as e:
             u = re.sub(r"^\/+", "", uri)
             for dir_ in self.directories:
                 # make sure the path seperators are posix - os.altsep is empty
@@ -260,8 +252,8 @@ class TemplateLookup(TemplateCollection):
                     return self._load(srcfile, uri)
             else:
                 raise exceptions.TopLevelLookupException(
-                    "Cant locate template for uri %r" % uri
-                )
+                    "Can't locate template for uri %r" % uri
+                ) from e
 
     def adjust_uri(self, uri, relativeto):
         """Adjust the given ``uri`` based on the given relative URI."""
@@ -270,20 +262,19 @@ class TemplateLookup(TemplateCollection):
         if key in self._uri_cache:
             return self._uri_cache[key]
 
-        if uri[0] != "/":
-            if relativeto is not None:
-                v = self._uri_cache[key] = posixpath.join(
-                    posixpath.dirname(relativeto), uri
-                )
-            else:
-                v = self._uri_cache[key] = "/" + uri
-        else:
+        if uri[0] == "/":
             v = self._uri_cache[key] = uri
+        elif relativeto is not None:
+            v = self._uri_cache[key] = posixpath.join(
+                posixpath.dirname(relativeto), uri
+            )
+        else:
+            v = self._uri_cache[key] = "/" + uri
         return v
 
     def filename_to_uri(self, filename):
         """Convert the given ``filename`` to a URI relative to
-           this :class:`.TemplateCollection`."""
+        this :class:`.TemplateCollection`."""
 
         try:
             return self._uri_cache[filename]
@@ -294,7 +285,7 @@ class TemplateLookup(TemplateCollection):
 
     def _relativeize(self, filename):
         """Return the portion of a filename that is 'relative'
-           to the directories in this lookup.
+        to the directories in this lookup.
 
         """
 
@@ -324,7 +315,7 @@ class TemplateLookup(TemplateCollection):
                     filename=posixpath.normpath(filename),
                     lookup=self,
                     module_filename=module_filename,
-                    **self.template_args
+                    **self.template_args,
                 )
                 return template
             except:
@@ -342,16 +333,15 @@ class TemplateLookup(TemplateCollection):
 
         try:
             template_stat = os.stat(template.filename)
-            if template.module._modified_time < template_stat[stat.ST_MTIME]:
-                self._collection.pop(uri, None)
-                return self._load(template.filename, uri)
-            else:
+            if template.module._modified_time >= template_stat[stat.ST_MTIME]:
                 return template
-        except OSError:
+            self._collection.pop(uri, None)
+            return self._load(template.filename, uri)
+        except OSError as e:
             self._collection.pop(uri, None)
             raise exceptions.TemplateLookupException(
-                "Cant locate template for uri %r" % uri
-            )
+                "Can't locate template for uri %r" % uri
+            ) from e
 
     def put_string(self, uri, text):
         """Place a new :class:`.Template` object into this
diff --git a/lib/mako/parsetree.py b/lib/mako/parsetree.py
index 801e48a7..2135769f 100644
--- a/lib/mako/parsetree.py
+++ b/lib/mako/parsetree.py
@@ -1,5 +1,5 @@
 # mako/parsetree.py
-# Copyright 2006-2020 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2021 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
@@ -9,13 +9,12 @@
 import re
 
 from mako import ast
-from mako import compat
 from mako import exceptions
 from mako import filters
 from mako import util
 
 
-class Node(object):
+class Node:
 
     """base class for a Node in the parse tree."""
 
@@ -51,7 +50,7 @@ class TemplateNode(Node):
     """a 'container' node that stores the overall collection of nodes."""
 
     def __init__(self, filename):
-        super(TemplateNode, self).__init__("", 0, 0, filename)
+        super().__init__("", 0, 0, filename)
         self.nodes = []
         self.page_attributes = {}
 
@@ -80,7 +79,7 @@ class ControlLine(Node):
     has_loop_context = False
 
     def __init__(self, keyword, isend, text, **kwargs):
-        super(ControlLine, self).__init__(**kwargs)
+        super().__init__(**kwargs)
         self.text = text
         self.keyword = keyword
         self.isend = isend
@@ -107,11 +106,13 @@ class ControlLine(Node):
         """return true if the given keyword is a ternary keyword
         for this ControlLine"""
 
-        return keyword in {
-            "if": set(["else", "elif"]),
-            "try": set(["except", "finally"]),
-            "for": set(["else"]),
-        }.get(self.keyword, [])
+        cases = {
+            "if": {"else", "elif"},
+            "try": {"except", "finally"},
+            "for": {"else"},
+        }
+
+        return keyword in cases.get(self.keyword, set())
 
     def __repr__(self):
         return "ControlLine(%r, %r, %r, %r)" % (
@@ -123,11 +124,10 @@ class ControlLine(Node):
 
 
 class Text(Node):
-
     """defines plain text in the template."""
 
     def __init__(self, content, **kwargs):
-        super(Text, self).__init__(**kwargs)
+        super().__init__(**kwargs)
         self.content = content
 
     def __repr__(self):
@@ -135,7 +135,6 @@ class Text(Node):
 
 
 class Code(Node):
-
     """defines a Python code block, either inline or module level.
 
     e.g.::
@@ -153,7 +152,7 @@ class Code(Node):
     """
 
     def __init__(self, text, ismodule, **kwargs):
-        super(Code, self).__init__(**kwargs)
+        super().__init__(**kwargs)
         self.text = text
         self.ismodule = ismodule
         self.code = ast.PythonCode(text, **self.exception_kwargs)
@@ -173,7 +172,6 @@ class Code(Node):
 
 
 class Comment(Node):
-
     """defines a comment line.
 
     # this is a comment
@@ -181,7 +179,7 @@ class Comment(Node):
     """
 
     def __init__(self, text, **kwargs):
-        super(Comment, self).__init__(**kwargs)
+        super().__init__(**kwargs)
         self.text = text
 
     def __repr__(self):
@@ -189,7 +187,6 @@ class Comment(Node):
 
 
 class Expression(Node):
-
     """defines an inline expression.
 
     ${x+y}
@@ -197,7 +194,7 @@ class Expression(Node):
     """
 
     def __init__(self, text, escapes, **kwargs):
-        super(Expression, self).__init__(**kwargs)
+        super().__init__(**kwargs)
         self.text = text
         self.escapes = escapes
         self.escapes_code = ast.ArgumentList(escapes, **self.exception_kwargs)
@@ -210,7 +207,7 @@ class Expression(Node):
         # TODO: make the "filter" shortcut list configurable at parse/gen time
         return self.code.undeclared_identifiers.union(
             self.escapes_code.undeclared_identifiers.difference(
-                set(filters.DEFAULT_ESCAPES.keys())
+                filters.DEFAULT_ESCAPES
             )
         ).difference(self.code.declared_identifiers)
 
@@ -223,7 +220,6 @@ class Expression(Node):
 
 
 class _TagMeta(type):
-
     """metaclass to allow Tag to produce a subclass according to
     its keyword"""
 
@@ -232,7 +228,7 @@ class _TagMeta(type):
     def __init__(cls, clsname, bases, dict_):
         if getattr(cls, "__keyword__", None) is not None:
             cls._classmap[cls.__keyword__] = cls
-        super(_TagMeta, cls).__init__(clsname, bases, dict_)
+        super().__init__(clsname, bases, dict_)
 
     def __call__(cls, keyword, attributes, **kwargs):
         if ":" in keyword:
@@ -254,7 +250,7 @@ class _TagMeta(type):
         return type.__call__(cls, keyword, attributes, **kwargs)
 
 
-class Tag(compat.with_metaclass(_TagMeta, Node)):
+class Tag(Node, metaclass=_TagMeta):
     """abstract base class for tags.
 
     e.g.::
@@ -276,7 +272,7 @@ class Tag(compat.with_metaclass(_TagMeta, Node)):
         expressions,
         nonexpressions,
         required,
-        **kwargs
+        **kwargs,
     ):
         r"""construct a new Tag instance.
 
@@ -297,17 +293,20 @@ class Tag(compat.with_metaclass(_TagMeta, Node)):
          other arguments passed to the Node superclass (lineno, pos)
 
         """
-        super(Tag, self).__init__(**kwargs)
+        super().__init__(**kwargs)
         self.keyword = keyword
         self.attributes = attributes
         self._parse_attributes(expressions, nonexpressions)
         missing = [r for r in required if r not in self.parsed_attributes]
         if len(missing):
             raise exceptions.CompileException(
-                "Missing attribute(s): %s"
-                % ",".join([repr(m) for m in missing]),
-                **self.exception_kwargs
+                (
+                    "Missing attribute(s): %s"
+                    % ",".join(repr(m) for m in missing)
+                ),
+                **self.exception_kwargs,
             )
+
         self.parent = None
         self.nodes = []
 
@@ -339,23 +338,22 @@ class Tag(compat.with_metaclass(_TagMeta, Node)):
                             code.undeclared_identifiers
                         )
                         expr.append("(%s)" % m.group(1))
-                    else:
-                        if x:
-                            expr.append(repr(x))
+                    elif x:
+                        expr.append(repr(x))
                 self.parsed_attributes[key] = " + ".join(expr) or repr("")
             elif key in nonexpressions:
                 if re.search(r"\${.+?}", self.attributes[key]):
                     raise exceptions.CompileException(
-                        "Attibute '%s' in tag '%s' does not allow embedded "
+                        "Attribute '%s' in tag '%s' does not allow embedded "
                         "expressions" % (key, self.keyword),
-                        **self.exception_kwargs
+                        **self.exception_kwargs,
                     )
                 self.parsed_attributes[key] = repr(self.attributes[key])
             else:
                 raise exceptions.CompileException(
                     "Invalid attribute for tag '%s': '%s'"
                     % (self.keyword, key),
-                    **self.exception_kwargs
+                    **self.exception_kwargs,
                 )
         self.expression_undeclared_identifiers = undeclared_identifiers
 
@@ -379,13 +377,13 @@ class IncludeTag(Tag):
     __keyword__ = "include"
 
     def __init__(self, keyword, attributes, **kwargs):
-        super(IncludeTag, self).__init__(
+        super().__init__(
             keyword,
             attributes,
             ("file", "import", "args"),
             (),
             ("file",),
-            **kwargs
+            **kwargs,
         )
         self.page_args = ast.PythonCode(
             "__DUMMY(%s)" % attributes.get("args", ""), **self.exception_kwargs
@@ -396,24 +394,22 @@ class IncludeTag(Tag):
 
     def undeclared_identifiers(self):
         identifiers = self.page_args.undeclared_identifiers.difference(
-            set(["__DUMMY"])
+            {"__DUMMY"}
         ).difference(self.page_args.declared_identifiers)
-        return identifiers.union(
-            super(IncludeTag, self).undeclared_identifiers()
-        )
+        return identifiers.union(super().undeclared_identifiers())
 
 
 class NamespaceTag(Tag):
     __keyword__ = "namespace"
 
     def __init__(self, keyword, attributes, **kwargs):
-        super(NamespaceTag, self).__init__(
+        super().__init__(
             keyword,
             attributes,
             ("file",),
             ("name", "inheritable", "import", "module"),
             (),
-            **kwargs
+            **kwargs,
         )
 
         self.name = attributes.get("name", "__anon_%s" % hex(abs(id(self))))
@@ -421,12 +417,12 @@ class NamespaceTag(Tag):
             raise exceptions.CompileException(
                 "'name' and/or 'import' attributes are required "
                 "for <%namespace>",
-                **self.exception_kwargs
+                **self.exception_kwargs,
             )
         if "file" in attributes and "module" in attributes:
             raise exceptions.CompileException(
                 "<%namespace> may only have one of 'file' or 'module'",
-                **self.exception_kwargs
+                **self.exception_kwargs,
             )
 
     def declared_identifiers(self):
@@ -437,9 +433,7 @@ class TextTag(Tag):
     __keyword__ = "text"
 
     def __init__(self, keyword, attributes, **kwargs):
-        super(TextTag, self).__init__(
-            keyword, attributes, (), ("filter"), (), **kwargs
-        )
+        super().__init__(keyword, attributes, (), ("filter"), (), **kwargs)
         self.filter_args = ast.ArgumentList(
             attributes.get("filter", ""), **self.exception_kwargs
         )
@@ -458,13 +452,13 @@ class DefTag(Tag):
             c for c in attributes if c.startswith("cache_")
         ]
 
-        super(DefTag, self).__init__(
+        super().__init__(
             keyword,
             attributes,
             expressions,
             ("name", "filter", "decorator"),
             ("name",),
-            **kwargs
+            **kwargs,
         )
         name = attributes["name"]
         if re.match(r"^[\w_]+$", name):
@@ -521,19 +515,19 @@ class BlockTag(Tag):
             c for c in attributes if c.startswith("cache_")
         ]
 
-        super(BlockTag, self).__init__(
+        super().__init__(
             keyword,
             attributes,
             expressions,
             ("name", "filter", "decorator"),
             (),
-            **kwargs
+            **kwargs,
         )
         name = attributes.get("name")
         if name and not re.match(r"^[\w_]+$", name):
             raise exceptions.CompileException(
                 "%block may not specify an argument signature",
-                **self.exception_kwargs
+                **self.exception_kwargs,
             )
         if not name and attributes.get("args", None):
             raise exceptions.CompileException(
@@ -577,7 +571,7 @@ class CallTag(Tag):
     __keyword__ = "call"
 
     def __init__(self, keyword, attributes, **kwargs):
-        super(CallTag, self).__init__(
+        super().__init__(
             keyword, attributes, ("args"), ("expr",), ("expr",), **kwargs
         )
         self.expression = attributes["expr"]
@@ -597,26 +591,25 @@ class CallTag(Tag):
 
 class CallNamespaceTag(Tag):
     def __init__(self, namespace, defname, attributes, **kwargs):
-        super(CallNamespaceTag, self).__init__(
+        super().__init__(
             namespace + ":" + defname,
             attributes,
             tuple(attributes.keys()) + ("args",),
             (),
             (),
-            **kwargs
+            **kwargs,
         )
 
         self.expression = "%s.%s(%s)" % (
             namespace,
             defname,
             ",".join(
-                [
-                    "%s=%s" % (k, v)
-                    for k, v in self.parsed_attributes.items()
-                    if k != "args"
-                ]
+                "%s=%s" % (k, v)
+                for k, v in self.parsed_attributes.items()
+                if k != "args"
             ),
         )
+
         self.code = ast.PythonCode(self.expression, **self.exception_kwargs)
         self.body_decl = ast.FunctionArgs(
             attributes.get("args", ""), **self.exception_kwargs
@@ -635,7 +628,7 @@ class InheritTag(Tag):
     __keyword__ = "inherit"
 
     def __init__(self, keyword, attributes, **kwargs):
-        super(InheritTag, self).__init__(
+        super().__init__(
             keyword, attributes, ("file",), (), ("file",), **kwargs
         )
 
@@ -651,9 +644,7 @@ class PageTag(Tag):
             "enable_loop",
         ] + [c for c in attributes if c.startswith("cache_")]
 
-        super(PageTag, self).__init__(
-            keyword, attributes, expressions, (), (), **kwargs
-        )
+        super().__init__(keyword, attributes, expressions, (), (), **kwargs)
         self.body_decl = ast.FunctionArgs(
             attributes.get("args", ""), **self.exception_kwargs
         )
diff --git a/lib/mako/pygen.py b/lib/mako/pygen.py
index 947721f1..46b0b52f 100644
--- a/lib/mako/pygen.py
+++ b/lib/mako/pygen.py
@@ -1,5 +1,5 @@
 # mako/pygen.py
-# Copyright 2006-2020 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2021 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
@@ -11,7 +11,7 @@ import re
 from mako import exceptions
 
 
-class PythonPrinter(object):
+class PythonPrinter:
     def __init__(self, stream):
         # indentation counter
         self.indent = 0
@@ -96,18 +96,19 @@ class PythonPrinter(object):
         is_comment = line and len(line) and line[0] == "#"
 
         # see if this line should decrease the indentation level
-        if not is_comment and (not hastext or self._is_unindentor(line)):
-
-            if self.indent > 0:
-                self.indent -= 1
-                # if the indent_detail stack is empty, the user
-                # probably put extra closures - the resulting
-                # module wont compile.
-                if len(self.indent_detail) == 0:
-                    raise exceptions.SyntaxException(
-                        "Too many whitespace closures"
-                    )
-                self.indent_detail.pop()
+        if (
+            not is_comment
+            and (not hastext or self._is_unindentor(line))
+            and self.indent > 0
+        ):
+            self.indent -= 1
+            # if the indent_detail stack is empty, the user
+            # probably put extra closures - the resulting
+            # module wont compile.
+            if len(self.indent_detail) == 0:
+                # TODO: no coverage here
+                raise exceptions.MakoException("Too many whitespace closures")
+            self.indent_detail.pop()
 
         if line is None:
             return
@@ -167,13 +168,10 @@ class PythonPrinter(object):
         # if the current line doesnt have one of the "unindentor" keywords,
         # return False
         match = re.match(r"^\s*(else|elif|except|finally).*\:", line)
-        if not match:
-            return False
-
-        # whitespace matches up, we have a compound indentor,
+        # if True, whitespace matches up, we have a compound indentor,
         # and this line has an unindentor, this
         # is probably good enough
-        return True
+        return bool(match)
 
         # should we decide that its not good enough, heres
         # more stuff to check.
@@ -218,11 +216,7 @@ class PythonPrinter(object):
 
         current_state = self.backslashed or self.triplequoted
 
-        if re.search(r"\\$", line):
-            self.backslashed = True
-        else:
-            self.backslashed = False
-
+        self.backslashed = bool(re.search(r"\\$", line))
         triples = len(re.findall(r"\"\"\"|\'\'\'", line))
         if triples == 1 or triples % 2 != 0:
             self.triplequoted = not self.triplequoted
diff --git a/lib/mako/pyparser.py b/lib/mako/pyparser.py
index b16672d6..5c55505b 100644
--- a/lib/mako/pyparser.py
+++ b/lib/mako/pyparser.py
@@ -1,5 +1,5 @@
 # mako/pyparser.py
-# Copyright 2006-2020 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2021 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
@@ -18,22 +18,13 @@ from mako import _ast_util
 from mako import compat
 from mako import exceptions
 from mako import util
-from mako.compat import arg_stringname
 
-if compat.py3k:
-    # words that cannot be assigned to (notably
-    # smaller than the total keys in __builtins__)
-    reserved = set(["True", "False", "None", "print"])
+# words that cannot be assigned to (notably
+# smaller than the total keys in __builtins__)
+reserved = {"True", "False", "None", "print"}
 
-    # the "id" attribute on a function node
-    arg_id = operator.attrgetter("arg")
-else:
-    # words that cannot be assigned to (notably
-    # smaller than the total keys in __builtins__)
-    reserved = set(["True", "False", "None"])
-
-    # the "id" attribute on a function node
-    arg_id = operator.attrgetter("id")
+# the "id" attribute on a function node
+arg_id = operator.attrgetter("arg")
 
 util.restore__ast(_ast)
 
@@ -43,7 +34,7 @@ def parse(code, mode="exec", **exception_kwargs):
 
     try:
         return _ast_util.parse(code, "<unknown>", mode)
-    except Exception:
+    except Exception as e:
         raise exceptions.SyntaxException(
             "(%s) %s (%r)"
             % (
@@ -51,8 +42,8 @@ def parse(code, mode="exec", **exception_kwargs):
                 compat.exception_as(),
                 code[0:50],
             ),
-            **exception_kwargs
-        )
+            **exception_kwargs,
+        ) from e
 
 
 class FindIdentifiers(_ast_util.NodeVisitor):
@@ -85,18 +76,13 @@ class FindIdentifiers(_ast_util.NodeVisitor):
             self.visit(n)
         self.in_assign_targets = in_a
 
-    if compat.py3k:
-
-        # ExceptHandler is in Python 2, but this block only works in
-        # Python 3 (and is required there)
-
-        def visit_ExceptHandler(self, node):
-            if node.name is not None:
-                self._add_declared(node.name)
-            if node.type is not None:
-                self.visit(node.type)
-            for statement in node.body:
-                self.visit(statement)
+    def visit_ExceptHandler(self, node):
+        if node.name is not None:
+            self._add_declared(node.name)
+        if node.type is not None:
+            self.visit(node.type)
+        for statement in node.body:
+            self.visit(statement)
 
     def visit_Lambda(self, node, *args):
         self._visit_function(node, True)
@@ -108,8 +94,7 @@ class FindIdentifiers(_ast_util.NodeVisitor):
     def _expand_tuples(self, args):
         for arg in args:
             if isinstance(arg, _ast.Tuple):
-                for n in arg.elts:
-                    yield n
+                yield from arg.elts
             else:
                 yield arg
 
@@ -170,15 +155,15 @@ class FindIdentifiers(_ast_util.NodeVisitor):
         for name in node.names:
             if name.asname is not None:
                 self._add_declared(name.asname)
+            elif name.name == "*":
+                raise exceptions.CompileException(
+                    "'import *' is not supported, since all identifier "
+                    "names must be explicitly declared.  Please use the "
+                    "form 'from <modulename> import <name1>, <name2>, "
+                    "...' instead.",
+                    **self.exception_kwargs,
+                )
             else:
-                if name.name == "*":
-                    raise exceptions.CompileException(
-                        "'import *' is not supported, since all identifier "
-                        "names must be explicitly declared.  Please use the "
-                        "form 'from <modulename> import <name1>, <name2>, "
-                        "...' instead.",
-                        **self.exception_kwargs
-                    )
                 self._add_declared(name.name)
 
 
@@ -213,27 +198,20 @@ class ParseFunc(_ast_util.NodeVisitor):
 
         argnames = [arg_id(arg) for arg in node.args.args]
         if node.args.vararg:
-            argnames.append(arg_stringname(node.args.vararg))
+            argnames.append(node.args.vararg.arg)
 
-        if compat.py2k:
-            # kw-only args don't exist in Python 2
-            kwargnames = []
-        else:
-            kwargnames = [arg_id(arg) for arg in node.args.kwonlyargs]
+        kwargnames = [arg_id(arg) for arg in node.args.kwonlyargs]
         if node.args.kwarg:
-            kwargnames.append(arg_stringname(node.args.kwarg))
+            kwargnames.append(node.args.kwarg.arg)
         self.listener.argnames = argnames
         self.listener.defaults = node.args.defaults  # ast
         self.listener.kwargnames = kwargnames
-        if compat.py2k:
-            self.listener.kwdefaults = []
-        else:
-            self.listener.kwdefaults = node.args.kw_defaults
+        self.listener.kwdefaults = node.args.kw_defaults
         self.listener.varargs = node.args.vararg
         self.listener.kwargs = node.args.kwarg
 
 
-class ExpressionGenerator(object):
+class ExpressionGenerator:
     def __init__(self, astnode):
         self.generator = _ast_util.SourceGenerator(" " * 4)
         self.generator.visit(astnode)
diff --git a/lib/mako/runtime.py b/lib/mako/runtime.py
index 465908e6..6d7fa684 100644
--- a/lib/mako/runtime.py
+++ b/lib/mako/runtime.py
@@ -7,16 +7,16 @@
 """provides runtime services for templates, including Context,
 Namespace, and various helper functions."""
 
+import builtins
 import functools
 import sys
 
 from mako import compat
 from mako import exceptions
 from mako import util
-from mako.compat import compat_builtins
 
 
-class Context(object):
+class Context:
 
     """Provides runtime namespace, output buffer, and various
     callstacks for templates.
@@ -24,7 +24,7 @@ class Context(object):
     See :ref:`runtime_toplevel` for detail on the usage of
     :class:`.Context`.
 
-     """
+    """
 
     def __init__(self, buffer, **data):
         self._buffer_stack = [buffer]
@@ -103,7 +103,7 @@ class Context(object):
         if key in self._data:
             return self._data[key]
         else:
-            return compat_builtins.__dict__[key]
+            return builtins.__dict__[key]
 
     def _push_writer(self):
         """push a capturing buffer onto this Context and return
@@ -135,7 +135,7 @@ class Context(object):
     def get(self, key, default=None):
         """Return a value from this :class:`.Context`."""
 
-        return self._data.get(key, compat_builtins.__dict__.get(key, default))
+        return self._data.get(key, builtins.__dict__.get(key, default))
 
     def write(self, string):
         """Write a string to this :class:`.Context` object's
@@ -216,7 +216,7 @@ class CallerStack(list):
         self.nextcaller = self.pop()
 
 
-class Undefined(object):
+class Undefined:
 
     """Represents an undefined value in a template.
 
@@ -240,7 +240,7 @@ UNDEFINED = Undefined()
 STOP_RENDERING = ""
 
 
-class LoopStack(object):
+class LoopStack:
 
     """a stack for LoopContexts that implements the context manager protocol
     to automatically pop off the top of the stack on context exit
@@ -280,7 +280,7 @@ class LoopStack(object):
         return iter(self._top)
 
 
-class LoopContext(object):
+class LoopContext:
 
     """A magic loop variable.
     Automatically accessible in any ``% for`` block.
@@ -339,14 +339,13 @@ class LoopContext(object):
         return bool(self.index % 2)
 
     def cycle(self, *values):
-        """Cycle through values as the loop progresses.
-        """
+        """Cycle through values as the loop progresses."""
         if not values:
             raise ValueError("You must provide values to cycle through")
         return values[self.index % len(values)]
 
 
-class _NSAttr(object):
+class _NSAttr:
     def __init__(self, parent):
         self.__parent = parent
 
@@ -360,22 +359,22 @@ class _NSAttr(object):
         raise AttributeError(key)
 
 
-class Namespace(object):
+class Namespace:
 
     """Provides access to collections of rendering methods, which
-      can be local, from other templates, or from imported modules.
+    can be local, from other templates, or from imported modules.
 
-      To access a particular rendering method referenced by a
-      :class:`.Namespace`, use plain attribute access:
+    To access a particular rendering method referenced by a
+    :class:`.Namespace`, use plain attribute access:
 
-      .. sourcecode:: mako
+    .. sourcecode:: mako
 
-        ${some_namespace.foo(x, y, z)}
+      ${some_namespace.foo(x, y, z)}
 
-      :class:`.Namespace` also contains several built-in attributes
-      described here.
+    :class:`.Namespace` also contains several built-in attributes
+    described here.
 
-      """
+    """
 
     def __init__(
         self,
@@ -390,7 +389,7 @@ class Namespace(object):
         self.context = context
         self.inherits = inherits
         if callables is not None:
-            self.callables = dict([(c.__name__, c) for c in callables])
+            self.callables = {c.__name__: c for c in callables}
 
     callables = ()
 
@@ -482,15 +481,14 @@ class Namespace(object):
         key = (self, uri)
         if key in self.context.namespaces:
             return self.context.namespaces[key]
-        else:
-            ns = TemplateNamespace(
-                uri,
-                self.context._copy(),
-                templateuri=uri,
-                calling_uri=self._templateuri,
-            )
-            self.context.namespaces[key] = ns
-            return ns
+        ns = TemplateNamespace(
+            uri,
+            self.context._copy(),
+            templateuri=uri,
+            calling_uri=self._templateuri,
+        )
+        self.context.namespaces[key] = ns
+        return ns
 
     def get_template(self, uri):
         """Return a :class:`.Template` from the given ``uri``.
@@ -574,7 +572,7 @@ class TemplateNamespace(Namespace):
         self.context = context
         self.inherits = inherits
         if callables is not None:
-            self.callables = dict([(c.__name__, c) for c in callables])
+            self.callables = {c.__name__: c for c in callables}
 
         if templateuri is not None:
             self.template = _lookup_template(context, templateuri, calling_uri)
@@ -666,7 +664,7 @@ class ModuleNamespace(Namespace):
         self.context = context
         self.inherits = inherits
         if callables is not None:
-            self.callables = dict([(c.__name__, c) for c in callables])
+            self.callables = {c.__name__: c for c in callables}
 
         mod = __import__(module)
         for token in module.split(".")[1:]:
@@ -790,7 +788,7 @@ def _include_file(context, uri, calling_uri, **kwargs):
         except Exception:
             result = template.include_error_handler(ctx, compat.exception_as())
             if not result:
-                compat.reraise(*sys.exc_info())
+                raise
     else:
         callable_(ctx, **kwargs)
 
@@ -837,8 +835,10 @@ def _lookup_template(context, uri, relativeto):
     uri = lookup.adjust_uri(uri, relativeto)
     try:
         return lookup.get_template(uri)
-    except exceptions.TopLevelLookupException:
-        raise exceptions.TemplateLookupException(str(compat.exception_as()))
+    except exceptions.TopLevelLookupException as e:
+        raise exceptions.TemplateLookupException(
+            str(compat.exception_as())
+        ) from e
 
 
 def _populate_self_namespace(context, template, self_ns=None):
@@ -862,14 +862,10 @@ def _render(template, callable_, args, data, as_unicode=False):
     output of the given template and template callable."""
 
     if as_unicode:
-        buf = util.FastEncodingBuffer(as_unicode=True)
-    elif template.bytestring_passthrough:
-        buf = compat.StringIO()
+        buf = util.FastEncodingBuffer()
     else:
         buf = util.FastEncodingBuffer(
-            as_unicode=as_unicode,
-            encoding=template.output_encoding,
-            errors=template.encoding_errors,
+            encoding=template.output_encoding, errors=template.encoding_errors
         )
     context = Context(buf, **data)
     context._outputting_as_unicode = as_unicode
@@ -880,7 +876,7 @@ def _render(template, callable_, args, data, as_unicode=False):
         callable_,
         context,
         *args,
-        **_kwargs_for_callable(callable_, data)
+        **_kwargs_for_callable(callable_, data),
     )
     return context._pop_buffer().getvalue()
 
@@ -951,13 +947,15 @@ def _render_error(template, context, error):
     if template.error_handler:
         result = template.error_handler(context, error)
         if not result:
-            compat.reraise(*sys.exc_info())
+            tp, value, tb = sys.exc_info()
+            if value and tb:
+                raise value.with_traceback(tb)
+            else:
+                raise error
     else:
         error_template = exceptions.html_error_template()
         if context._outputting_as_unicode:
-            context._buffer_stack[:] = [
-                util.FastEncodingBuffer(as_unicode=True)
-            ]
+            context._buffer_stack[:] = [util.FastEncodingBuffer()]
         else:
             context._buffer_stack[:] = [
                 util.FastEncodingBuffer(
diff --git a/lib/mako/template.py b/lib/mako/template.py
index 5ed23204..bbbe73cb 100644
--- a/lib/mako/template.py
+++ b/lib/mako/template.py
@@ -1,5 +1,5 @@
 # mako/template.py
-# Copyright 2006-2020 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2021 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
@@ -25,7 +25,7 @@ from mako import util
 from mako.lexer import Lexer
 
 
-class Template(object):
+class Template:
 
     r"""Represents a compiled template.
 
@@ -53,17 +53,6 @@ class Template(object):
      of return-valued ``%def``\ s "opt out" of that filtering via
      passing special attributes or objects.
 
-    :param bytestring_passthrough: When ``True``, and ``output_encoding`` is
-     set to ``None``, and :meth:`.Template.render` is used to render,
-     the `StringIO` or `cStringIO` buffer will be used instead of the
-     default "fast" buffer.   This allows raw bytestrings in the
-     output stream, such as in expressions, to pass straight
-     through to the buffer.  This flag is forced
-     to ``True`` if ``disable_unicode`` is also configured.
-
-     .. versionadded:: 0.4
-        Added to provide the same behavior as that of the previous series.
-
     :param cache_args: Dictionary of cache configuration arguments that
      will be passed to the :class:`.CacheImpl`.   See :ref:`caching_toplevel`.
 
@@ -94,9 +83,6 @@ class Template(object):
     :param default_filters: List of string filter names that will
      be applied to all expressions.  See :ref:`filtering_default_filters`.
 
-    :param disable_unicode: Disables all awareness of Python Unicode
-     objects.  See :ref:`unicode_disabled`.
-
     :param enable_loop: When ``True``, enable the ``loop`` context variable.
      This can be set to ``False`` to support templates that may
      be making usage of the name "``loop``".   Individual templates can
@@ -255,9 +241,7 @@ class Template(object):
         cache_url=None,
         module_filename=None,
         input_encoding=None,
-        disable_unicode=False,
         module_writer=None,
-        bytestring_passthrough=False,
         default_filters=None,
         buffer_filters=(),
         strict_undefined=False,
@@ -294,26 +278,12 @@ class Template(object):
         self.input_encoding = input_encoding
         self.output_encoding = output_encoding
         self.encoding_errors = encoding_errors
-        self.disable_unicode = disable_unicode
-        self.bytestring_passthrough = bytestring_passthrough or disable_unicode
         self.enable_loop = enable_loop
         self.strict_undefined = strict_undefined
         self.module_writer = module_writer
 
-        if compat.py3k and disable_unicode:
-            raise exceptions.UnsupportedError(
-                "Mako for Python 3 does not " "support disabling Unicode"
-            )
-        elif output_encoding and disable_unicode:
-            raise exceptions.UnsupportedError(
-                "output_encoding must be set to "
-                "None when disable_unicode is used."
-            )
         if default_filters is None:
-            if compat.py3k or self.disable_unicode:
-                self.default_filters = ["str"]
-            else:
-                self.default_filters = ["unicode"]
+            self.default_filters = ["str"]
         else:
             self.default_filters = default_filters
         self.buffer_filters = buffer_filters
@@ -387,11 +357,7 @@ class Template(object):
     ):
         self.cache_impl = cache_impl
         self.cache_enabled = cache_enabled
-        if cache_args:
-            self.cache_args = cache_args
-        else:
-            self.cache_args = {}
-
+        self.cache_args = cache_args or {}
         # transfer deprecated cache_* args
         if cache_type:
             self.cache_args["type"] = cache_type
@@ -463,7 +429,7 @@ class Template(object):
 
         If the template specifies an output encoding, the string
         will be encoded accordingly, else the output is raw (raw
-        output uses `cStringIO` and can't handle multibyte
+        output uses `StringIO` and can't handle multibyte
         characters). A :class:`.Context` object is created corresponding
         to the given data. Arguments that are explicitly declared
         by this template's internal rendering method are also
@@ -517,17 +483,17 @@ class ModuleTemplate(Template):
 
     """A Template which is constructed given an existing Python module.
 
-       e.g.::
+    e.g.::
 
-            t = Template("this is a template")
-            f = file("mymodule.py", "w")
-            f.write(t.code)
-            f.close()
+         t = Template("this is a template")
+         f = file("mymodule.py", "w")
+         f.write(t.code)
+         f.close()
 
-            import mymodule
+         import mymodule
 
-            t = ModuleTemplate(mymodule)
-            print(t.render())
+         t = ModuleTemplate(mymodule)
+         print(t.render())
 
     """
 
@@ -541,8 +507,6 @@ class ModuleTemplate(Template):
         template_source=None,
         output_encoding=None,
         encoding_errors="strict",
-        disable_unicode=False,
-        bytestring_passthrough=False,
         format_exceptions=False,
         error_handler=None,
         lookup=None,
@@ -559,20 +523,8 @@ class ModuleTemplate(Template):
         self.input_encoding = module._source_encoding
         self.output_encoding = output_encoding
         self.encoding_errors = encoding_errors
-        self.disable_unicode = disable_unicode
-        self.bytestring_passthrough = bytestring_passthrough or disable_unicode
         self.enable_loop = module._enable_loop
 
-        if compat.py3k and disable_unicode:
-            raise exceptions.UnsupportedError(
-                "Mako for Python 3 does not " "support disabling Unicode"
-            )
-        elif output_encoding and disable_unicode:
-            raise exceptions.UnsupportedError(
-                "output_encoding must be set to "
-                "None when disable_unicode is used."
-            )
-
         self.module = module
         self.filename = template_filename
         ModuleInfo(
@@ -616,19 +568,18 @@ class DefTemplate(Template):
         self.include_error_handler = parent.include_error_handler
         self.enable_loop = parent.enable_loop
         self.lookup = parent.lookup
-        self.bytestring_passthrough = parent.bytestring_passthrough
 
     def get_def(self, name):
         return self.parent.get_def(name)
 
 
-class ModuleInfo(object):
+class ModuleInfo:
 
     """Stores information about a module currently loaded into
     memory, provides reverse lookups of template source, module
     source code based on a module's identifier.
 
-     """
+    """
 
     _modules = weakref.WeakValueDictionary()
 
@@ -658,9 +609,9 @@ class ModuleInfo(object):
             r"__M_BEGIN_METADATA(.+?)__M_END_METADATA", module_source, re.S
         ).group(1)
         source_map = json.loads(source_map)
-        source_map["line_map"] = dict(
-            (int(k), int(v)) for k, v in source_map["line_map"].items()
-        )
+        source_map["line_map"] = {
+            int(k): int(v) for k, v in source_map["line_map"].items()
+        }
         if full_line_map:
             f_line_map = source_map["full_line_map"] = []
             line_map = source_map["line_map"]
@@ -681,28 +632,25 @@ class ModuleInfo(object):
 
     @property
     def source(self):
-        if self.template_source is not None:
-            if self.module._source_encoding and not isinstance(
-                self.template_source, compat.text_type
-            ):
-                return self.template_source.decode(
-                    self.module._source_encoding
-                )
-            else:
-                return self.template_source
-        else:
+        if self.template_source is None:
             data = util.read_file(self.template_filename)
             if self.module._source_encoding:
                 return data.decode(self.module._source_encoding)
             else:
                 return data
 
+        elif self.module._source_encoding and not isinstance(
+            self.template_source, str
+        ):
+            return self.template_source.decode(self.module._source_encoding)
+        else:
+            return self.template_source
+
 
 def _compile(template, text, filename, generate_magic_comment):
     lexer = template.lexer_cls(
         text,
         filename,
-        disable_unicode=template.disable_unicode,
         input_encoding=template.input_encoding,
         preprocessor=template.preprocessor,
     )
@@ -717,7 +665,6 @@ def _compile(template, text, filename, generate_magic_comment):
         future_imports=template.future_imports,
         source_encoding=lexer.encoding,
         generate_magic_comment=generate_magic_comment,
-        disable_unicode=template.disable_unicode,
         strict_undefined=template.strict_undefined,
         enable_loop=template.enable_loop,
         reserved_names=template.reserved_names,
@@ -728,15 +675,10 @@ def _compile(template, text, filename, generate_magic_comment):
 def _compile_text(template, text, filename):
     identifier = template.module_id
     source, lexer = _compile(
-        template,
-        text,
-        filename,
-        generate_magic_comment=template.disable_unicode,
+        template, text, filename, generate_magic_comment=False
     )
 
     cid = identifier
-    if not compat.py3k and isinstance(cid, compat.text_type):
-        cid = cid.encode()
     module = types.ModuleType(cid)
     code = compile(source, cid, "exec")
 
@@ -750,7 +692,7 @@ def _compile_module_file(template, text, filename, outputpath, module_writer):
         template, text, filename, generate_magic_comment=True
     )
 
-    if isinstance(source, compat.text_type):
+    if isinstance(source, str):
         source = source.encode(lexer.encoding or "ascii")
 
     if module_writer:
@@ -767,10 +709,7 @@ def _compile_module_file(template, text, filename, outputpath, module_writer):
 
 
 def _get_module_info_from_callable(callable_):
-    if compat.py3k:
-        return _get_module_info(callable_.__globals__["__name__"])
-    else:
-        return _get_module_info(callable_.func_globals["__name__"])
+    return _get_module_info(callable_.__globals__["__name__"])
 
 
 def _get_module_info(filename):
diff --git a/lib/mako/testing/__init__.py b/lib/mako/testing/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/lib/mako/testing/_config.py b/lib/mako/testing/_config.py
new file mode 100644
index 00000000..4ee3d0a6
--- /dev/null
+++ b/lib/mako/testing/_config.py
@@ -0,0 +1,128 @@
+import configparser
+import dataclasses
+from dataclasses import dataclass
+from pathlib import Path
+from typing import Callable
+from typing import ClassVar
+from typing import Optional
+from typing import Union
+
+from .helpers import make_path
+
+
+class ConfigError(BaseException):
+    pass
+
+
+class MissingConfig(ConfigError):
+    pass
+
+
+class MissingConfigSection(ConfigError):
+    pass
+
+
+class MissingConfigItem(ConfigError):
+    pass
+
+
+class ConfigValueTypeError(ConfigError):
+    pass
+
+
+class _GetterDispatch:
+    def __init__(self, initialdata, default_getter: Callable):
+        self.default_getter = default_getter
+        self.data = initialdata
+
+    def get_fn_for_type(self, type_):
+        return self.data.get(type_, self.default_getter)
+
+    def get_typed_value(self, type_, name):
+        get_fn = self.get_fn_for_type(type_)
+        return get_fn(name)
+
+
+def _parse_cfg_file(filespec: Union[Path, str]):
+    cfg = configparser.ConfigParser()
+    try:
+        filepath = make_path(filespec, check_exists=True)
+    except FileNotFoundError as e:
+        raise MissingConfig(f"No config file found at {filespec}") from e
+    else:
+        with open(filepath, encoding="utf-8") as f:
+            cfg.read_file(f)
+        return cfg
+
+
+def _build_getter(cfg_obj, cfg_section, method, converter=None):
+    def caller(option, **kwargs):
+        try:
+            rv = getattr(cfg_obj, method)(cfg_section, option, **kwargs)
+        except configparser.NoSectionError as nse:
+            raise MissingConfigSection(
+                f"No config section named {cfg_section}"
+            ) from nse
+        except configparser.NoOptionError as noe:
+            raise MissingConfigItem(f"No config item for {option}") from noe
+        except ValueError as ve:
+            # ConfigParser.getboolean, .getint, .getfloat raise ValueError
+            # on bad types
+            raise ConfigValueTypeError(
+                f"Wrong value type for {option}"
+            ) from ve
+        else:
+            if converter:
+                try:
+                    rv = converter(rv)
+                except Exception as e:
+                    raise ConfigValueTypeError(
+                        f"Wrong value type for {option}"
+                    ) from e
+            return rv
+
+    return caller
+
+
+def _build_getter_dispatch(cfg_obj, cfg_section, converters=None):
+    converters = converters or {}
+
+    default_getter = _build_getter(cfg_obj, cfg_section, "get")
+
+    # support ConfigParser builtins
+    getters = {
+        int: _build_getter(cfg_obj, cfg_section, "getint"),
+        bool: _build_getter(cfg_obj, cfg_section, "getboolean"),
+        float: _build_getter(cfg_obj, cfg_section, "getfloat"),
+        str: default_getter,
+    }
+
+    # use ConfigParser.get and convert value
+    getters.update(
+        {
+            type_: _build_getter(
+                cfg_obj, cfg_section, "get", converter=converter_fn
+            )
+            for type_, converter_fn in converters.items()
+        }
+    )
+
+    return _GetterDispatch(getters, default_getter)
+
+
+@dataclass
+class ReadsCfg:
+    section_header: ClassVar[str]
+    converters: ClassVar[Optional[dict]] = None
+
+    @classmethod
+    def from_cfg_file(cls, filespec: Union[Path, str]):
+        cfg = _parse_cfg_file(filespec)
+        dispatch = _build_getter_dispatch(
+            cfg, cls.section_header, converters=cls.converters
+        )
+        kwargs = {
+            field.name: dispatch.get_typed_value(field.type, field.name)
+            for field in dataclasses.fields(cls)
+        }
+        return cls(**kwargs)
diff --git a/lib/mako/testing/assertions.py b/lib/mako/testing/assertions.py
new file mode 100644
index 00000000..14ea6352
--- /dev/null
+++ b/lib/mako/testing/assertions.py
@@ -0,0 +1,167 @@
+import contextlib
+import re
+import sys
+
+
+def eq_(a, b, msg=None):
+    """Assert a == b, with repr messaging on failure."""
+    assert a == b, msg or "%r != %r" % (a, b)
+
+
+def ne_(a, b, msg=None):
+    """Assert a != b, with repr messaging on failure."""
+    assert a != b, msg or "%r == %r" % (a, b)
+
+
+def in_(a, b, msg=None):
+    """Assert a in b, with repr messaging on failure."""
+    assert a in b, msg or "%r not in %r" % (a, b)
+
+
+def not_in(a, b, msg=None):
+    """Assert a in not b, with repr messaging on failure."""
+    assert a not in b, msg or "%r is in %r" % (a, b)
+
+
+def _assert_proper_exception_context(exception):
+    """assert that any exception we're catching does not have a __context__
+    without a __cause__, and that __suppress_context__ is never set.
+
+    Python 3 will report nested as exceptions as "during the handling of
+    error X, error Y occurred". That's not what we want to do. We want
+    these exceptions in a cause chain.
+
+    """
+
+    if (
+        exception.__context__ is not exception.__cause__
+        and not exception.__suppress_context__
+    ):
+        assert False, (
+            "Exception %r was correctly raised but did not set a cause, "
+            "within context %r as its cause."
+            % (exception, exception.__context__)
+        )
+
+
+def _assert_proper_cause_cls(exception, cause_cls):
+    """assert that any exception we're catching does not have a __context__
+    without a __cause__, and that __suppress_context__ is never set.
+
+    Python 3 will report nested as exceptions as "during the handling of
+    error X, error Y occurred". That's not what we want to do. We want
+    these exceptions in a cause chain.
+
+    """
+    assert isinstance(exception.__cause__, cause_cls), (
+        "Exception %r was correctly raised but has cause %r, which does not "
+        "have the expected cause type %r."
+        % (exception, exception.__cause__, cause_cls)
+    )
+
+
+def assert_raises(except_cls, callable_, *args, **kw):
+    return _assert_raises(except_cls, callable_, args, kw)
+
+
+def assert_raises_with_proper_context(except_cls, callable_, *args, **kw):
+    return _assert_raises(except_cls, callable_, args, kw, check_context=True)
+
+
+def assert_raises_with_given_cause(
+    except_cls, cause_cls, callable_, *args, **kw
+):
+    return _assert_raises(except_cls, callable_, args, kw, cause_cls=cause_cls)
+
+
+def assert_raises_message(except_cls, msg, callable_, *args, **kwargs):
+    return _assert_raises(except_cls, callable_, args, kwargs, msg=msg)
+
+
+def assert_raises_message_with_proper_context(
+    except_cls, msg, callable_, *args, **kwargs
+):
+    return _assert_raises(
+        except_cls, callable_, args, kwargs, msg=msg, check_context=True
+    )
+
+
+def assert_raises_message_with_given_cause(
+    except_cls, msg, cause_cls, callable_, *args, **kwargs
+):
+    return _assert_raises(
+        except_cls, callable_, args, kwargs, msg=msg, cause_cls=cause_cls
+    )
+
+
+def _assert_raises(
+    except_cls,
+    callable_,
+    args,
+    kwargs,
+    msg=None,
+    check_context=False,
+    cause_cls=None,
+):
+
+    with _expect_raises(except_cls, msg, check_context, cause_cls) as ec:
+        callable_(*args, **kwargs)
+    return ec.error
+
+
+class _ErrorContainer:
+    error = None
+
+
+@contextlib.contextmanager
+def _expect_raises(except_cls, msg=None, check_context=False, cause_cls=None):
+    ec = _ErrorContainer()
+    if check_context:
+        are_we_already_in_a_traceback = sys.exc_info()[0]
+    try:
+        yield ec
+        success = False
+    except except_cls as err:
+        ec.error = err
+        success = True
+        if msg is not None:
+            # I'm often pdbing here, and "err" above isn't
+            # in scope, so assign the string explicitly
+            error_as_string = str(err)
+            assert re.search(msg, error_as_string, re.UNICODE), "%r !~ %s" % (
+                msg,
+                error_as_string,
+            )
+        if cause_cls is not None:
+            _assert_proper_cause_cls(err, cause_cls)
+        if check_context and not are_we_already_in_a_traceback:
+            _assert_proper_exception_context(err)
+        print(str(err).encode("utf-8"))
+
+    # it's generally a good idea to not carry traceback objects outside
+    # of the except: block, but in this case especially we seem to have
+    # hit some bug in either python 3.10.0b2 or greenlet or both which
+    # this seems to fix:
+    # https://github.com/python-greenlet/greenlet/issues/242
+    del ec
+
+    # assert outside the block so it works for AssertionError too !
+    assert success, "Callable did not raise an exception"
+
+
+def expect_raises(except_cls, check_context=False):
+    return _expect_raises(except_cls, check_context=check_context)
+
+
+def expect_raises_message(except_cls, msg, check_context=False):
+    return _expect_raises(except_cls, msg=msg, check_context=check_context)
+
+
+def expect_raises_with_proper_context(except_cls, check_context=True):
+    return _expect_raises(except_cls, check_context=check_context)
+
+
+def expect_raises_message_with_proper_context(
+    except_cls, msg, check_context=True
+):
+    return _expect_raises(except_cls, msg=msg, check_context=check_context)
diff --git a/lib/mako/testing/config.py b/lib/mako/testing/config.py
new file mode 100644
index 00000000..b77d0c08
--- /dev/null
+++ b/lib/mako/testing/config.py
@@ -0,0 +1,17 @@
+from dataclasses import dataclass
+from pathlib import Path
+
+from ._config import ReadsCfg
+from .helpers import make_path
+
+
+@dataclass
+class Config(ReadsCfg):
+    module_base: Path
+    template_base: Path
+
+    section_header = "mako_testing"
+    converters = {Path: make_path}
+
+
+config = Config.from_cfg_file("./setup.cfg")
diff --git a/lib/mako/testing/exclusions.py b/lib/mako/testing/exclusions.py
new file mode 100644
index 00000000..37b2d14a
--- /dev/null
+++ b/lib/mako/testing/exclusions.py
@@ -0,0 +1,80 @@
+import pytest
+
+from mako.ext.beaker_cache import has_beaker
+from mako.util import update_wrapper
+
+
+try:
+    import babel.messages.extract as babel
+except ImportError:
+    babel = None
+
+
+try:
+    import lingua
+except ImportError:
+    lingua = None
+
+
+try:
+    import dogpile.cache  # noqa
+except ImportError:
+    has_dogpile_cache = False
+else:
+    has_dogpile_cache = True
+
+
+requires_beaker = pytest.mark.skipif(
+    not has_beaker, reason="Beaker is required for these tests."
+)
+
+
+requires_babel = pytest.mark.skipif(
+    babel is None, reason="babel not installed: skipping babelplugin test"
+)
+
+
+requires_lingua = pytest.mark.skipif(
+    lingua is None, reason="lingua not installed: skipping linguaplugin test"
+)
+
+
+requires_dogpile_cache = pytest.mark.skipif(
+    not has_dogpile_cache,
+    reason="dogpile.cache is required to run these tests",
+)
+
+
+def _pygments_version():
+    try:
+        import pygments
+
+        version = pygments.__version__
+    except:
+        version = "0"
+    return version
+
+
+requires_pygments_14 = pytest.mark.skipif(
+    _pygments_version() < "1.4", reason="Requires pygments 1.4 or greater"
+)
+
+
+# def requires_pygments_14(fn):
+
+#     return skip_if(
+#         lambda: version < "1.4", "Requires pygments 1.4 or greater"
+#     )(fn)
+
+
+def requires_no_pygments_exceptions(fn):
+    def go(*arg, **kw):
+        from mako import exceptions
+
+        exceptions._install_fallback()
+        try:
+            return fn(*arg, **kw)
+        finally:
+            exceptions._install_highlighting()
+
+    return update_wrapper(go, fn)
diff --git a/lib/mako/testing/fixtures.py b/lib/mako/testing/fixtures.py
new file mode 100644
index 00000000..c9379c0c
--- /dev/null
+++ b/lib/mako/testing/fixtures.py
@@ -0,0 +1,109 @@
+import os
+
+from mako.cache import CacheImpl
+from mako.cache import register_plugin
+from mako.template import Template
+from .assertions import eq_
+from .config import config
+
+
+class TemplateTest:
+    def _file_template(self, filename, **kw):
+        filepath = self._file_path(filename)
+        return Template(
+            uri=filename,
+            filename=filepath,
+            module_directory=config.module_base,
+            **kw,
+        )
+
+    def _file_path(self, filename):
+        name, ext = os.path.splitext(filename)
+        py3k_path = os.path.join(config.template_base, name + "_py3k" + ext)
+        if os.path.exists(py3k_path):
+            return py3k_path
+
+        return os.path.join(config.template_base, filename)
+
+    def _do_file_test(
+        self,
+        filename,
+        expected,
+        filters=None,
+        unicode_=True,
+        template_args=None,
+        **kw,
+    ):
+        t1 = self._file_template(filename, **kw)
+        self._do_test(
+            t1,
+            expected,
+            filters=filters,
+            unicode_=unicode_,
+            template_args=template_args,
+        )
+
+    def _do_memory_test(
+        self,
+        source,
+        expected,
+        filters=None,
+        unicode_=True,
+        template_args=None,
+        **kw,
+    ):
+        t1 = Template(text=source, **kw)
+        self._do_test(
+            t1,
+            expected,
+            filters=filters,
+            unicode_=unicode_,
+            template_args=template_args,
+        )
+
+    def _do_test(
+        self,
+        template,
+        expected,
+        filters=None,
+        template_args=None,
+        unicode_=True,
+    ):
+        if template_args is None:
+            template_args = {}
+        if unicode_:
+            output = template.render_unicode(**template_args)
+        else:
+            output = template.render(**template_args)
+
+        if filters:
+            output = filters(output)
+        eq_(output, expected)
+
+
+class PlainCacheImpl(CacheImpl):
+    """Simple memory cache impl so that tests which
+    use caching can run without beaker."""
+
+    def __init__(self, cache):
+        self.cache = cache
+        self.data = {}
+
+    def get_or_create(self, key, creation_function, **kw):
+        if key in self.data:
+            return self.data[key]
+        else:
+            self.data[key] = data = creation_function(**kw)
+            return data
+
+    def put(self, key, value, **kw):
+        self.data[key] = value
+
+    def get(self, key, **kw):
+        return self.data[key]
+
+    def invalidate(self, key, **kw):
+        del self.data[key]
+
+
+register_plugin("plain", __name__, "PlainCacheImpl")
diff --git a/lib/mako/testing/helpers.py b/lib/mako/testing/helpers.py
new file mode 100644
index 00000000..77cca367
--- /dev/null
+++ b/lib/mako/testing/helpers.py
@@ -0,0 +1,67 @@
+import contextlib
+import pathlib
+from pathlib import Path
+import re
+import time
+from typing import Union
+from unittest import mock
+
+
+def flatten_result(result):
+    return re.sub(r"[\s\r\n]+", " ", result).strip()
+
+
+def result_lines(result):
+    return [
+        x.strip()
+        for x in re.split(r"\r?\n", re.sub(r" +", " ", result))
+        if x.strip() != ""
+    ]
+
+
+def make_path(
+    filespec: Union[Path, str],
+    make_absolute: bool = True,
+    check_exists: bool = False,
+) -> Path:
+    path = Path(filespec)
+    if make_absolute:
+        path = path.resolve(strict=check_exists)
+    if check_exists and (not path.exists()):
+        raise FileNotFoundError(f"No file or directory at {filespec}")
+    return path
+
+
+def _unlink_path(path, missing_ok=False):
+    # Replicate 3.8+ functionality in 3.7
+    cm = contextlib.nullcontext()
+    if missing_ok:
+        cm = contextlib.suppress(FileNotFoundError)
+
+    with cm:
+        path.unlink()
+
+
+def replace_file_with_dir(pathspec):
+    path = pathlib.Path(pathspec)
+    _unlink_path(path, missing_ok=True)
+    path.mkdir(exist_ok=True)
+    return path
+
+
+def file_with_template_code(filespec):
+    with open(filespec, "w") as f:
+        f.write(
+            """
+i am an artificial template just for you
+"""
+        )
+    return filespec
+
+
+@contextlib.contextmanager
+def rewind_compile_time(hours=1):
+    rewound = time.time() - (hours * 3_600)
+    with mock.patch("mako.codegen.time") as codegen_time:
+        codegen_time.time.return_value = rewound
+        yield
diff --git a/lib/mako/util.py b/lib/mako/util.py
index 16e3c726..74c8b9eb 100644
--- a/lib/mako/util.py
+++ b/lib/mako/util.py
@@ -1,10 +1,8 @@
 # mako/util.py
-# Copyright 2006-2020 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2021 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
-from __future__ import absolute_import
-
 from ast import parse
 import codecs
 import collections
@@ -13,7 +11,7 @@ import os
 import re
 import timeit
 
-from mako import compat
+from .compat import importlib_metadata_get
 
 
 def update_wrapper(decorated, fn):
@@ -22,7 +20,7 @@ def update_wrapper(decorated, fn):
     return decorated
 
 
-class PluginLoader(object):
+class PluginLoader:
     def __init__(self, group):
         self.group = group
         self.impls = {}
@@ -30,18 +28,17 @@ class PluginLoader(object):
     def load(self, name):
         if name in self.impls:
             return self.impls[name]()
-        else:
-            import pkg_resources
 
-            for impl in pkg_resources.iter_entry_points(self.group, name):
+        for impl in importlib_metadata_get(self.group):
+            if impl.name == name:
                 self.impls[name] = impl.load
                 return impl.load()
-            else:
-                from mako import exceptions
 
-                raise exceptions.RuntimeException(
-                    "Can't load plugin %s %s" % (self.group, name)
-                )
+        from mako import exceptions
+
+        raise exceptions.RuntimeException(
+            "Can't load plugin %s %s" % (self.group, name)
+        )
 
     def register(self, name, modulepath, objname):
         def load():
@@ -61,7 +58,7 @@ def verify_directory(dir_):
     while not os.path.exists(dir_):
         try:
             tries += 1
-            os.makedirs(dir_, compat.octal("0775"))
+            os.makedirs(dir_, 0o755)
         except:
             if tries > 5:
                 raise
@@ -76,7 +73,7 @@ def to_list(x, default=None):
         return x
 
 
-class memoized_property(object):
+class memoized_property:
 
     """A read-only @property that is only evaluated once."""
 
@@ -92,7 +89,7 @@ class memoized_property(object):
         return result
 
 
-class memoized_instancemethod(object):
+class memoized_instancemethod:
 
     """Decorate a method memoize its return value.
 
@@ -140,19 +137,15 @@ class SetLikeDict(dict):
         return x
 
 
-class FastEncodingBuffer(object):
+class FastEncodingBuffer:
 
     """a very rudimentary buffer that is faster than StringIO,
-    but doesn't crash on unicode data like cStringIO."""
+    and supports unicode data."""
 
-    def __init__(self, encoding=None, errors="strict", as_unicode=False):
+    def __init__(self, encoding=None, errors="strict"):
         self.data = collections.deque()
         self.encoding = encoding
-        if as_unicode:
-            self.delim = compat.u("")
-        else:
-            self.delim = ""
-        self.as_unicode = as_unicode
+        self.delim = ""
         self.errors = errors
         self.write = self.data.append
 
@@ -179,7 +172,7 @@ class LRUCache(dict):
     is inexact.
     """
 
-    class _Item(object):
+    class _Item:
         def __init__(self, key, value):
             self.key = key
             self.value = value
@@ -203,9 +196,8 @@ class LRUCache(dict):
     def setdefault(self, key, value):
         if key in self:
             return self[key]
-        else:
-            self[key] = value
-            return value
+        self[key] = value
+        return value
 
     def __setitem__(self, key, value):
         item = dict.get(self, key)
@@ -295,7 +287,7 @@ def sorted_dict_repr(d):
     """
     keys = list(d.keys())
     keys.sort()
-    return "{" + ", ".join(["%r: %r" % (k, d[k]) for k in keys]) + "}"
+    return "{" + ", ".join("%r: %r" % (k, d[k]) for k in keys) + "}"
 
 
 def restore__ast(_ast):
@@ -308,7 +300,7 @@ def restore__ast(_ast):
     m = compile(
         """\
 def foo(): pass
-class Bar(object): pass
+class Bar: pass
 if False: pass
 baz = 'mako'
 1 + 2 - 3 * 4 / 5
@@ -380,12 +372,8 @@ mako in baz not in mako""",
 
 
 def read_file(path, mode="rb"):
-    fp = open(path, mode)
-    try:
-        data = fp.read()
-        return data
-    finally:
-        fp.close()
+    with open(path, mode) as fp:
+        return fp.read()
 
 
 def read_python_file(path):
diff --git a/lib/markupsafe/__init__.py b/lib/markupsafe/__init__.py
index d331ac36..0f1c4f46 100644
--- a/lib/markupsafe/__init__.py
+++ b/lib/markupsafe/__init__.py
@@ -11,9 +11,10 @@ if t.TYPE_CHECKING:
             pass
 
 
-__version__ = "2.0.1"
+__version__ = "2.1.1"
 
-_striptags_re = re.compile(r"(<!--.*?-->|<[^>]*>)")
+_strip_comments_re = re.compile(r"<!--.*?-->")
+_strip_tags_re = re.compile(r"<.*?>")
 
 
 def _simple_escaping_wrapper(name: str) -> t.Callable[..., "Markup"]:
@@ -92,19 +93,24 @@ class Markup(str):
 
         return NotImplemented
 
-    def __mul__(self, num: int) -> "Markup":
+    def __mul__(self, num: "te.SupportsIndex") -> "Markup":
         if isinstance(num, int):
             return self.__class__(super().__mul__(num))
 
-        return NotImplemented  # type: ignore
+        return NotImplemented
 
     __rmul__ = __mul__
 
     def __mod__(self, arg: t.Any) -> "Markup":
         if isinstance(arg, tuple):
+            # a tuple of arguments, each wrapped
             arg = tuple(_MarkupEscapeHelper(x, self.escape) for x in arg)
-        else:
+        elif hasattr(type(arg), "__getitem__") and not isinstance(arg, str):
+            # a mapping of arguments, wrapped
             arg = _MarkupEscapeHelper(arg, self.escape)
+        else:
+            # a single argument, wrapped with the helper and a tuple
+            arg = (_MarkupEscapeHelper(arg, self.escape),)
 
         return self.__class__(super().__mod__(arg))
 
@@ -153,8 +159,11 @@ class Markup(str):
         >>> Markup("Main &raquo;\t<em>About</em>").striptags()
         'Main » About'
         """
-        stripped = " ".join(_striptags_re.sub("", self).split())
-        return Markup(stripped).unescape()
+        # Use two regexes to avoid ambiguous matches.
+        value = _strip_comments_re.sub("", self)
+        value = _strip_tags_re.sub("", value)
+        value = " ".join(value.split())
+        return Markup(value).unescape()
 
     @classmethod
     def escape(cls, s: t.Any) -> "Markup":
@@ -280,9 +289,7 @@ try:
     from ._speedups import escape as escape
     from ._speedups import escape_silent as escape_silent
     from ._speedups import soft_str as soft_str
-    from ._speedups import soft_unicode
 except ImportError:
     from ._native import escape as escape
     from ._native import escape_silent as escape_silent  # noqa: F401
     from ._native import soft_str as soft_str  # noqa: F401
-    from ._native import soft_unicode  # noqa: F401
diff --git a/lib/markupsafe/_native.py b/lib/markupsafe/_native.py
index 6f7eb7a8..8117b271 100644
--- a/lib/markupsafe/_native.py
+++ b/lib/markupsafe/_native.py
@@ -61,15 +61,3 @@ def soft_str(s: t.Any) -> str:
         return str(s)
 
     return s
-
-
-def soft_unicode(s: t.Any) -> str:
-    import warnings
-
-    warnings.warn(
-        "'soft_unicode' has been renamed to 'soft_str'. The old name"
-        " will be removed in MarkupSafe 2.1.",
-        DeprecationWarning,
-        stacklevel=2,
-    )
-    return soft_str(s)
diff --git a/lib/markupsafe/_speedups.c b/lib/markupsafe/_speedups.c
new file mode 100644
index 00000000..3c463fb8
--- /dev/null
+++ b/lib/markupsafe/_speedups.c
@@ -0,0 +1,320 @@
+#include <Python.h>
+
+static PyObject* markup;
+
+static int
+init_constants(void)
+{
+	PyObject *module;
+
+	/* import markup type so that we can mark the return value */
+	module = PyImport_ImportModule("markupsafe");
+	if (!module)
+		return 0;
+	markup = PyObject_GetAttrString(module, "Markup");
+	Py_DECREF(module);
+
+	return 1;
+}
+
+#define GET_DELTA(inp, inp_end, delta) \
+	while (inp < inp_end) { \
+		switch (*inp++) { \
+		case '"': \
+		case '\'': \
+		case '&': \
+			delta += 4; \
+			break; \
+		case '<': \
+		case '>': \
+			delta += 3; \
+			break; \
+		} \
+	}
+
+#define DO_ESCAPE(inp, inp_end, outp) \
+	{ \
+		Py_ssize_t ncopy = 0; \
+		while (inp < inp_end) { \
+			switch (*inp) { \
+			case '"': \
+				memcpy(outp, inp-ncopy, sizeof(*outp)*ncopy); \
+				outp += ncopy; ncopy = 0; \
+				*outp++ = '&'; \
+				*outp++ = '#'; \
+				*outp++ = '3'; \
+				*outp++ = '4'; \
+				*outp++ = ';'; \
+				break; \
+			case '\'': \
+				memcpy(outp, inp-ncopy, sizeof(*outp)*ncopy); \
+				outp += ncopy; ncopy = 0; \
+				*outp++ = '&'; \
+				*outp++ = '#'; \
+				*outp++ = '3'; \
+				*outp++ = '9'; \
+				*outp++ = ';'; \
+				break; \
+			case '&': \
+				memcpy(outp, inp-ncopy, sizeof(*outp)*ncopy); \
+				outp += ncopy; ncopy = 0; \
+				*outp++ = '&'; \
+				*outp++ = 'a'; \
+				*outp++ = 'm'; \
+				*outp++ = 'p'; \
+				*outp++ = ';'; \
+				break; \
+			case '<': \
+				memcpy(outp, inp-ncopy, sizeof(*outp)*ncopy); \
+				outp += ncopy; ncopy = 0; \
+				*outp++ = '&'; \
+				*outp++ = 'l'; \
+				*outp++ = 't'; \
+				*outp++ = ';'; \
+				break; \
+			case '>': \
+				memcpy(outp, inp-ncopy, sizeof(*outp)*ncopy); \
+				outp += ncopy; ncopy = 0; \
+				*outp++ = '&'; \
+				*outp++ = 'g'; \
+				*outp++ = 't'; \
+				*outp++ = ';'; \
+				break; \
+			default: \
+				ncopy++; \
+			} \
+			inp++; \
+		} \
+		memcpy(outp, inp-ncopy, sizeof(*outp)*ncopy); \
+	}
+
+static PyObject*
+escape_unicode_kind1(PyUnicodeObject *in)
+{
+	Py_UCS1 *inp = PyUnicode_1BYTE_DATA(in);
+	Py_UCS1 *inp_end = inp + PyUnicode_GET_LENGTH(in);
+	Py_UCS1 *outp;
+	PyObject *out;
+	Py_ssize_t delta = 0;
+
+	GET_DELTA(inp, inp_end, delta);
+	if (!delta) {
+		Py_INCREF(in);
+		return (PyObject*)in;
+	}
+
+	out = PyUnicode_New(PyUnicode_GET_LENGTH(in) + delta,
+						PyUnicode_IS_ASCII(in) ? 127 : 255);
+	if (!out)
+		return NULL;
+
+	inp = PyUnicode_1BYTE_DATA(in);
+	outp = PyUnicode_1BYTE_DATA(out);
+	DO_ESCAPE(inp, inp_end, outp);
+	return out;
+}
+
+static PyObject*
+escape_unicode_kind2(PyUnicodeObject *in)
+{
+	Py_UCS2 *inp = PyUnicode_2BYTE_DATA(in);
+	Py_UCS2 *inp_end = inp + PyUnicode_GET_LENGTH(in);
+	Py_UCS2 *outp;
+	PyObject *out;
+	Py_ssize_t delta = 0;
+
+	GET_DELTA(inp, inp_end, delta);
+	if (!delta) {
+		Py_INCREF(in);
+		return (PyObject*)in;
+	}
+
+	out = PyUnicode_New(PyUnicode_GET_LENGTH(in) + delta, 65535);
+	if (!out)
+		return NULL;
+
+	inp = PyUnicode_2BYTE_DATA(in);
+	outp = PyUnicode_2BYTE_DATA(out);
+	DO_ESCAPE(inp, inp_end, outp);
+	return out;
+}
+
+
+static PyObject*
+escape_unicode_kind4(PyUnicodeObject *in)
+{
+	Py_UCS4 *inp = PyUnicode_4BYTE_DATA(in);
+	Py_UCS4 *inp_end = inp + PyUnicode_GET_LENGTH(in);
+	Py_UCS4 *outp;
+	PyObject *out;
+	Py_ssize_t delta = 0;
+
+	GET_DELTA(inp, inp_end, delta);
+	if (!delta) {
+		Py_INCREF(in);
+		return (PyObject*)in;
+	}
+
+	out = PyUnicode_New(PyUnicode_GET_LENGTH(in) + delta, 1114111);
+	if (!out)
+		return NULL;
+
+	inp = PyUnicode_4BYTE_DATA(in);
+	outp = PyUnicode_4BYTE_DATA(out);
+	DO_ESCAPE(inp, inp_end, outp);
+	return out;
+}
+
+static PyObject*
+escape_unicode(PyUnicodeObject *in)
+{
+	if (PyUnicode_READY(in))
+		return NULL;
+
+	switch (PyUnicode_KIND(in)) {
+	case PyUnicode_1BYTE_KIND:
+		return escape_unicode_kind1(in);
+	case PyUnicode_2BYTE_KIND:
+		return escape_unicode_kind2(in);
+	case PyUnicode_4BYTE_KIND:
+		return escape_unicode_kind4(in);
+	}
+	assert(0);  /* shouldn't happen */
+	return NULL;
+}
+
+static PyObject*
+escape(PyObject *self, PyObject *text)
+{
+	static PyObject *id_html;
+	PyObject *s = NULL, *rv = NULL, *html;
+
+	if (id_html == NULL) {
+		id_html = PyUnicode_InternFromString("__html__");
+		if (id_html == NULL) {
+			return NULL;
+		}
+	}
+
+	/* we don't have to escape integers, bools or floats */
+	if (PyLong_CheckExact(text) ||
+		PyFloat_CheckExact(text) || PyBool_Check(text) ||
+		text == Py_None)
+		return PyObject_CallFunctionObjArgs(markup, text, NULL);
+
+	/* if the object has an __html__ method that performs the escaping */
+	html = PyObject_GetAttr(text ,id_html);
+	if (html) {
+		s = PyObject_CallObject(html, NULL);
+		Py_DECREF(html);
+		if (s == NULL) {
+			return NULL;
+		}
+		/* Convert to Markup object */
+		rv = PyObject_CallFunctionObjArgs(markup, (PyObject*)s, NULL);
+		Py_DECREF(s);
+		return rv;
+	}
+
+	/* otherwise make the object unicode if it isn't, then escape */
+	PyErr_Clear();
+	if (!PyUnicode_Check(text)) {
+		PyObject *unicode = PyObject_Str(text);
+		if (!unicode)
+			return NULL;
+		s = escape_unicode((PyUnicodeObject*)unicode);
+		Py_DECREF(unicode);
+	}
+	else
+		s = escape_unicode((PyUnicodeObject*)text);
+
+	/* convert the unicode string into a markup object. */
+	rv = PyObject_CallFunctionObjArgs(markup, (PyObject*)s, NULL);
+	Py_DECREF(s);
+	return rv;
+}
+
+
+static PyObject*
+escape_silent(PyObject *self, PyObject *text)
+{
+	if (text != Py_None)
+		return escape(self, text);
+	return PyObject_CallFunctionObjArgs(markup, NULL);
+}
+
+
+static PyObject*
+soft_str(PyObject *self, PyObject *s)
+{
+	if (!PyUnicode_Check(s))
+		return PyObject_Str(s);
+	Py_INCREF(s);
+	return s;
+}
+
+
+static PyMethodDef module_methods[] = {
+	{
+		"escape",
+		(PyCFunction)escape,
+		METH_O,
+		"Replace the characters ``&``, ``<``, ``>``, ``'``, and ``\"`` in"
+		" the string with HTML-safe sequences. Use this if you need to display"
+		" text that might contain such characters in HTML.\n\n"
+		"If the object has an ``__html__`` method, it is called and the"
+		" return value is assumed to already be safe for HTML.\n\n"
+		":param s: An object to be converted to a string and escaped.\n"
+		":return: A :class:`Markup` string with the escaped text.\n"
+	},
+	{
+		"escape_silent",
+		(PyCFunction)escape_silent,
+		METH_O,
+		"Like :func:`escape` but treats ``None`` as the empty string."
+		" Useful with optional values, as otherwise you get the string"
+		" ``'None'`` when the value is ``None``.\n\n"
+		">>> escape(None)\n"
+		"Markup('None')\n"
+		">>> escape_silent(None)\n"
+		"Markup('')\n"
+	},
+	{
+		"soft_str",
+		(PyCFunction)soft_str,
+		METH_O,
+		"Convert an object to a string if it isn't already. This preserves"
+		" a :class:`Markup` string rather than converting it back to a basic"
+		" string, so it will still be marked as safe and won't be escaped"
+		" again.\n\n"
+		">>> value = escape(\"<User 1>\")\n"
+		">>> value\n"
+		"Markup('&lt;User 1&gt;')\n"
+		">>> escape(str(value))\n"
+		"Markup('&amp;lt;User 1&amp;gt;')\n"
+		">>> escape(soft_str(value))\n"
+		"Markup('&lt;User 1&gt;')\n"
+	},
+	{NULL, NULL, 0, NULL}  /* Sentinel */
+};
+
+static struct PyModuleDef module_definition = {
+	PyModuleDef_HEAD_INIT,
+	"markupsafe._speedups",
+	NULL,
+	-1,
+	module_methods,
+	NULL,
+	NULL,
+	NULL,
+	NULL
+};
+
+PyMODINIT_FUNC
+PyInit__speedups(void)
+{
+	if (!init_constants())
+		return NULL;
+
+	return PyModule_Create(&module_definition);
+}
diff --git a/requirements.txt b/requirements.txt
index 1861eeaa..58fe21b6 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -18,11 +18,12 @@ gntp==1.0.3
 html5lib==1.1
 httpagentparser==1.9.2
 idna==3.3
+importlib-metadata==4.11.3
 importlib-resources==5.6.0
 git+https://github.com/Tautulli/ipwhois.git@master#egg=ipwhois
 IPy==1.01
-Mako==1.1.6
-MarkupSafe==2.0.1
+Mako==1.2.0
+MarkupSafe==2.1.1
 musicbrainzngs==0.7.1
 packaging==21.3
 paho-mqtt==1.6.1

From 67baf9a2602b1b0b77455fc1de291f99a589f069 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 16 May 2022 20:35:58 -0700
Subject: [PATCH 078/743] Bump urllib3 from 1.26.8 to 1.26.9 (#1688)

* Bump urllib3 from 1.26.8 to 1.26.9

Bumps [urllib3](https://github.com/urllib3/urllib3) from 1.26.8 to 1.26.9.
- [Release notes](https://github.com/urllib3/urllib3/releases)
- [Changelog](https://github.com/urllib3/urllib3/blob/1.26.9/CHANGES.rst)
- [Commits](https://github.com/urllib3/urllib3/compare/1.26.8...1.26.9)

---
updated-dependencies:
- dependency-name: urllib3
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

* Update urllib3==1.26.9

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/urllib3/_version.py                |  2 +-
 lib/urllib3/connection.py              |  6 ++----
 lib/urllib3/poolmanager.py             |  1 +
 lib/urllib3/response.py                |  5 ++++-
 lib/urllib3/util/request.py            |  5 ++++-
 lib/urllib3/util/ssl_match_hostname.py | 10 ++++------
 requirements.txt                       |  2 +-
 7 files changed, 17 insertions(+), 14 deletions(-)

diff --git a/lib/urllib3/_version.py b/lib/urllib3/_version.py
index fa8979d7..d905b697 100644
--- a/lib/urllib3/_version.py
+++ b/lib/urllib3/_version.py
@@ -1,2 +1,2 @@
 # This file is protected via CODEOWNERS
-__version__ = "1.26.8"
+__version__ = "1.26.9"
diff --git a/lib/urllib3/connection.py b/lib/urllib3/connection.py
index 4d92ac6d..7bf395bd 100644
--- a/lib/urllib3/connection.py
+++ b/lib/urllib3/connection.py
@@ -355,17 +355,15 @@ class HTTPSConnection(HTTPConnection):
 
     def connect(self):
         # Add certificate verification
-        conn = self._new_conn()
+        self.sock = conn = self._new_conn()
         hostname = self.host
         tls_in_tls = False
 
         if self._is_using_tunnel():
             if self.tls_in_tls_required:
-                conn = self._connect_tls_proxy(hostname, conn)
+                self.sock = conn = self._connect_tls_proxy(hostname, conn)
                 tls_in_tls = True
 
-            self.sock = conn
-
             # Calls self._set_hostport(), so self.host is
             # self._tunnel_host below.
             self._tunnel()
diff --git a/lib/urllib3/poolmanager.py b/lib/urllib3/poolmanager.py
index 3a31a285..ca4ec341 100644
--- a/lib/urllib3/poolmanager.py
+++ b/lib/urllib3/poolmanager.py
@@ -34,6 +34,7 @@ SSL_KEYWORDS = (
     "ca_cert_dir",
     "ssl_context",
     "key_password",
+    "server_hostname",
 )
 
 # All known keyword arguments that could be provided to the pool manager, its
diff --git a/lib/urllib3/response.py b/lib/urllib3/response.py
index 38693f4f..fdb50ddb 100644
--- a/lib/urllib3/response.py
+++ b/lib/urllib3/response.py
@@ -8,7 +8,10 @@ from socket import error as SocketError
 from socket import timeout as SocketTimeout
 
 try:
-    import brotli
+    try:
+        import brotlicffi as brotli
+    except ImportError:
+        import brotli
 except ImportError:
     brotli = None
 
diff --git a/lib/urllib3/util/request.py b/lib/urllib3/util/request.py
index 25103383..b574b081 100644
--- a/lib/urllib3/util/request.py
+++ b/lib/urllib3/util/request.py
@@ -14,7 +14,10 @@ SKIPPABLE_HEADERS = frozenset(["accept-encoding", "host", "user-agent"])
 
 ACCEPT_ENCODING = "gzip,deflate"
 try:
-    import brotli as _unused_module_brotli  # noqa: F401
+    try:
+        import brotlicffi as _unused_module_brotli  # noqa: F401
+    except ImportError:
+        import brotli as _unused_module_brotli  # noqa: F401
 except ImportError:
     pass
 else:
diff --git a/lib/urllib3/util/ssl_match_hostname.py b/lib/urllib3/util/ssl_match_hostname.py
index a4b4a569..1dd950c4 100644
--- a/lib/urllib3/util/ssl_match_hostname.py
+++ b/lib/urllib3/util/ssl_match_hostname.py
@@ -112,11 +112,9 @@ def match_hostname(cert, hostname):
     try:
         # Divergence from upstream: ipaddress can't handle byte str
         host_ip = ipaddress.ip_address(_to_unicode(hostname))
-    except ValueError:
-        # Not an IP address (common case)
-        host_ip = None
-    except UnicodeError:
-        # Divergence from upstream: Have to deal with ipaddress not taking
+    except (UnicodeError, ValueError):
+        # ValueError: Not an IP address (common case)
+        # UnicodeError: Divergence from upstream: Have to deal with ipaddress not taking
         # byte strings.  addresses should be all ascii, so we consider it not
         # an ipaddress in this case
         host_ip = None
@@ -124,7 +122,7 @@ def match_hostname(cert, hostname):
         # Divergence from upstream: Make ipaddress library optional
         if ipaddress is None:
             host_ip = None
-        else:
+        else:  # Defensive
             raise
     dnsnames = []
     san = cert.get("subjectAltName", ())
diff --git a/requirements.txt b/requirements.txt
index 58fe21b6..99f8033e 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -45,7 +45,7 @@ tempora==5.0.1
 tokenize-rt==4.2.1
 tzdata==2022.1
 tzlocal==4.2
-urllib3==1.26.8
+urllib3==1.26.9
 webencodings==0.5.1
 websocket-client==1.2.3
 xmltodict==0.12.0

From d510e0f60079c7a256d0fac551c381ef2e82a477 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 16 May 2022 20:40:13 -0700
Subject: [PATCH 079/743] Bump websocket-client from 1.2.3 to 1.3.2 (#1700)

* Bump websocket-client from 1.2.3 to 1.3.2

Bumps [websocket-client](https://github.com/websocket-client/websocket-client) from 1.2.3 to 1.3.2.
- [Release notes](https://github.com/websocket-client/websocket-client/releases)
- [Changelog](https://github.com/websocket-client/websocket-client/blob/master/ChangeLog)
- [Commits](https://github.com/websocket-client/websocket-client/compare/v1.2.3...v1.3.2)

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

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

* Update websocket-client==1.3.2

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/websocket/__init__.py             |  4 +-
 lib/websocket/_abnf.py                | 47 +++++++++---------
 lib/websocket/_app.py                 | 57 ++++++++++++++--------
 lib/websocket/_cookiejar.py           |  7 +--
 lib/websocket/_core.py                | 47 ++++++++----------
 lib/websocket/_exceptions.py          |  6 +--
 lib/websocket/_handshake.py           | 13 +++--
 lib/websocket/_http.py                | 10 ++--
 lib/websocket/_logging.py             |  7 +--
 lib/websocket/_socket.py              | 23 ++++-----
 lib/websocket/_ssl_compat.py          |  2 +-
 lib/websocket/_url.py                 | 16 +++----
 lib/websocket/_utils.py               |  2 +-
 lib/websocket/_wsdump.py              |  4 +-
 lib/websocket/tests/data/header03.txt |  1 +
 lib/websocket/tests/test_abnf.py      | 10 ++--
 lib/websocket/tests/test_app.py       | 69 +++++++++++++++++++++++----
 lib/websocket/tests/test_cookiejar.py |  9 ++--
 lib/websocket/tests/test_http.py      | 20 ++++----
 lib/websocket/tests/test_url.py       | 66 ++++++++++++-------------
 lib/websocket/tests/test_websocket.py | 34 +++++++------
 requirements.txt                      |  2 +-
 22 files changed, 251 insertions(+), 205 deletions(-)

diff --git a/lib/websocket/__init__.py b/lib/websocket/__init__.py
index 05aae2bd..a5a39502 100644
--- a/lib/websocket/__init__.py
+++ b/lib/websocket/__init__.py
@@ -2,7 +2,7 @@
 __init__.py
 websocket - WebSocket client library for Python
 
-Copyright 2021 engn33r
+Copyright 2022 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
@@ -23,4 +23,4 @@ from ._exceptions import *
 from ._logging import *
 from ._socket import *
 
-__version__ = "1.2.3"
+__version__ = "1.3.2"
diff --git a/lib/websocket/_abnf.py b/lib/websocket/_abnf.py
index e9909ff6..2e5ad97c 100644
--- a/lib/websocket/_abnf.py
+++ b/lib/websocket/_abnf.py
@@ -1,12 +1,17 @@
-"""
+import array
+import os
+import struct
+import sys
 
-"""
+from ._exceptions import *
+from ._utils import validate_utf8
+from threading import Lock
 
 """
 _abnf.py
 websocket - WebSocket client library for Python
 
-Copyright 2021 engn33r
+Copyright 2022 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
@@ -20,14 +25,6 @@ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.
 """
-import array
-import os
-import struct
-import sys
-
-from ._exceptions import *
-from ._utils import validate_utf8
-from threading import Lock
 
 try:
     # If wsaccel is available, use compiled routines to mask data.
@@ -79,6 +76,8 @@ STATUS_POLICY_VIOLATION = 1008
 STATUS_MESSAGE_TOO_BIG = 1009
 STATUS_INVALID_EXTENSION = 1010
 STATUS_UNEXPECTED_CONDITION = 1011
+STATUS_SERVICE_RESTART = 1012
+STATUS_TRY_AGAIN_LATER = 1013
 STATUS_BAD_GATEWAY = 1014
 STATUS_TLS_HANDSHAKE_ERROR = 1015
 
@@ -92,6 +91,8 @@ VALID_CLOSE_STATUS = (
     STATUS_MESSAGE_TOO_BIG,
     STATUS_INVALID_EXTENSION,
     STATUS_UNEXPECTED_CONDITION,
+    STATUS_SERVICE_RESTART,
+    STATUS_TRY_AGAIN_LATER,
     STATUS_BAD_GATEWAY,
 )
 
@@ -146,7 +147,7 @@ class ABNF:
         self.data = data
         self.get_mask_key = os.urandom
 
-    def validate(self, skip_utf8_validation=False):
+    def validate(self, skip_utf8_validation=False) -> None:
         """
         Validate the ABNF frame.
 
@@ -174,13 +175,13 @@ class ABNF:
 
             code = 256 * self.data[0] + self.data[1]
             if not self._is_valid_close_status(code):
-                raise WebSocketProtocolException("Invalid close opcode.")
+                raise WebSocketProtocolException("Invalid close opcode %r", code)
 
     @staticmethod
-    def _is_valid_close_status(code):
+    def _is_valid_close_status(code: int) -> bool:
         return code in VALID_CLOSE_STATUS or (3000 <= code < 5000)
 
-    def __str__(self):
+    def __str__(self) -> str:
         return "fin=" + str(self.fin) \
             + " opcode=" + str(self.opcode) \
             + " data=" + str(self.data)
@@ -206,7 +207,7 @@ class ABNF:
         # mask must be set if send data from client
         return ABNF(fin, 0, 0, 0, opcode, 1, data)
 
-    def format(self):
+    def format(self) -> bytes:
         """
         Format this object to string(byte array) to send data to server.
         """
@@ -251,9 +252,9 @@ class ABNF:
 
         Parameters
         ----------
-        mask_key: <type>
-            4 byte string.
-        data: <type>
+        mask_key: bytes or str
+            4 byte mask.
+        data: bytes or str
             data to mask/unmask.
         """
         if data is None:
@@ -286,7 +287,7 @@ class frame_buffer:
         self.length = None
         self.mask = None
 
-    def has_received_header(self):
+    def has_received_header(self) -> bool:
         return self.header is None
 
     def recv_header(self):
@@ -308,7 +309,7 @@ class frame_buffer:
             return False
         return self.header[frame_buffer._HEADER_MASK_INDEX]
 
-    def has_received_length(self):
+    def has_received_length(self) -> bool:
         return self.length is None
 
     def recv_length(self):
@@ -323,7 +324,7 @@ class frame_buffer:
         else:
             self.length = length_bits
 
-    def has_received_mask(self):
+    def has_received_mask(self) -> bool:
         return self.mask is None
 
     def recv_mask(self):
@@ -360,7 +361,7 @@ class frame_buffer:
 
         return frame
 
-    def recv_strict(self, bufsize):
+    def recv_strict(self, bufsize: int) -> bytes:
         shortage = bufsize - sum(map(len, self.recv_buffer))
         while shortage > 0:
             # Limit buffer size that we pass to socket.recv() to avoid
diff --git a/lib/websocket/_app.py b/lib/websocket/_app.py
index 1afd3d20..da49ec78 100644
--- a/lib/websocket/_app.py
+++ b/lib/websocket/_app.py
@@ -1,12 +1,18 @@
-"""
-
-"""
+import selectors
+import sys
+import threading
+import time
+import traceback
+from ._abnf import ABNF
+from ._core import WebSocket, getdefaulttimeout
+from ._exceptions import *
+from . import _logging
 
 """
 _app.py
 websocket - WebSocket client library for Python
 
-Copyright 2021 engn33r
+Copyright 2022 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
@@ -20,16 +26,6 @@ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.
 """
-import selectors
-import sys
-import threading
-import time
-import traceback
-from ._abnf import ABNF
-from ._core import WebSocket, getdefaulttimeout
-from ._exceptions import *
-from . import _logging
-
 
 __all__ = ["WebSocketApp"]
 
@@ -86,6 +82,20 @@ class SSLDispatcher:
             return r[0][0]
 
 
+class WrappedDispatcher:
+    """
+    WrappedDispatcher
+    """
+    def __init__(self, app, ping_timeout, dispatcher):
+        self.app = app
+        self.ping_timeout = ping_timeout
+        self.dispatcher = dispatcher
+
+    def read(self, sock, read_callback, check_callback):
+        self.dispatcher.read(sock, read_callback)
+        self.ping_timeout and self.dispatcher.timeout(self.ping_timeout, check_callback)
+
+
 class WebSocketApp:
     """
     Higher level of APIs are provided. The interface is like JavaScript WebSocket object.
@@ -97,7 +107,8 @@ class WebSocketApp:
                  on_cont_message=None,
                  keep_running=True, get_mask_key=None, cookie=None,
                  subprotocols=None,
-                 on_data=None):
+                 on_data=None,
+                 socket=None):
         """
         WebSocketApp initialization
 
@@ -153,6 +164,8 @@ class WebSocketApp:
             Cookie value.
         subprotocols: list
             List of available sub protocols. Default is None.
+        socket: socket
+            Pre-initialized stream socket.
         """
         self.url = url
         self.header = header if header is not None else []
@@ -172,6 +185,7 @@ class WebSocketApp:
         self.last_ping_tm = 0
         self.last_pong_tm = 0
         self.subprotocols = subprotocols
+        self.prepared_socket = socket
 
     def send(self, data, opcode=ABNF.OPCODE_TEXT):
         """
@@ -258,7 +272,8 @@ class WebSocketApp:
         Returns
         -------
         teardown: bool
-            False if caught KeyboardInterrupt, True if other exception was raised during a loop
+            False if the `WebSocketApp` is closed or caught KeyboardInterrupt,
+            True if any other exception was raised during a loop.
         """
 
         if ping_timeout is not None and ping_timeout <= 0:
@@ -315,9 +330,8 @@ class WebSocketApp:
                 http_proxy_port=http_proxy_port, http_no_proxy=http_no_proxy,
                 http_proxy_auth=http_proxy_auth, subprotocols=self.subprotocols,
                 host=host, origin=origin, suppress_origin=suppress_origin,
-                proxy_type=proxy_type)
-            if not dispatcher:
-                dispatcher = self.create_dispatcher(ping_timeout)
+                proxy_type=proxy_type, socket=self.prepared_socket)
+            dispatcher = self.create_dispatcher(ping_timeout, dispatcher)
 
             self._callback(self.on_open)
 
@@ -367,6 +381,7 @@ class WebSocketApp:
                 return True
 
             dispatcher.read(self.sock.sock, read, check)
+            return False
         except (Exception, KeyboardInterrupt, SystemExit) as e:
             self._callback(self.on_error, e)
             if isinstance(e, SystemExit):
@@ -375,7 +390,9 @@ class WebSocketApp:
             teardown()
             return not isinstance(e, KeyboardInterrupt)
 
-    def create_dispatcher(self, ping_timeout):
+    def create_dispatcher(self, ping_timeout, dispatcher=None):
+        if dispatcher:  # If custom dispatcher is set, use WrappedDispatcher
+            return WrappedDispatcher(self, ping_timeout, dispatcher)
         timeout = ping_timeout or 10
         if self.sock.is_ssl():
             return SSLDispatcher(self, timeout)
diff --git a/lib/websocket/_cookiejar.py b/lib/websocket/_cookiejar.py
index 87853834..5476d1d4 100644
--- a/lib/websocket/_cookiejar.py
+++ b/lib/websocket/_cookiejar.py
@@ -1,12 +1,10 @@
-"""
-
-"""
+import http.cookies
 
 """
 _cookiejar.py
 websocket - WebSocket client library for Python
 
-Copyright 2021 engn33r
+Copyright 2022 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
@@ -20,7 +18,6 @@ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.
 """
-import http.cookies
 
 
 class SimpleCookieJar:
diff --git a/lib/websocket/_core.py b/lib/websocket/_core.py
index e26c8b11..c36b7800 100644
--- a/lib/websocket/_core.py
+++ b/lib/websocket/_core.py
@@ -1,27 +1,3 @@
-"""
-_core.py
-====================================
-WebSocket Python client
-"""
-
-"""
-_core.py
-websocket - WebSocket client library for Python
-
-Copyright 2021 engn33r
-
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
-
-    http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.
-"""
 import socket
 import struct
 import threading
@@ -37,6 +13,25 @@ from ._socket import *
 from ._ssl_compat import *
 from ._utils import *
 
+"""
+_core.py
+websocket - WebSocket client library for Python
+
+Copyright 2022 engn33r
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+"""
+
 __all__ = ['WebSocket', 'create_connection']
 
 
@@ -250,14 +245,14 @@ class WebSocket:
                                    options.pop('socket', None))
 
         try:
-            self.handshake_response = handshake(self.sock, *addrs, **options)
+            self.handshake_response = handshake(self.sock, url, *addrs, **options)
             for attempt in range(options.pop('redirect_limit', 3)):
                 if self.handshake_response.status in SUPPORTED_REDIRECT_STATUSES:
                     url = self.handshake_response.headers['location']
                     self.sock.close()
                     self.sock, addrs = connect(url, self.sock_opt, proxy_info(**options),
                                                options.pop('socket', None))
-                    self.handshake_response = handshake(self.sock, *addrs, **options)
+                    self.handshake_response = handshake(self.sock, url, *addrs, **options)
             self.connected = True
         except:
             if self.sock:
diff --git a/lib/websocket/_exceptions.py b/lib/websocket/_exceptions.py
index b92b1f40..811d5945 100644
--- a/lib/websocket/_exceptions.py
+++ b/lib/websocket/_exceptions.py
@@ -1,12 +1,8 @@
-"""
-Define WebSocket exceptions
-"""
-
 """
 _exceptions.py
 websocket - WebSocket client library for Python
 
-Copyright 2021 engn33r
+Copyright 2022 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
diff --git a/lib/websocket/_handshake.py b/lib/websocket/_handshake.py
index f9dabb57..f032c4b5 100644
--- a/lib/websocket/_handshake.py
+++ b/lib/websocket/_handshake.py
@@ -2,7 +2,7 @@
 _handshake.py
 websocket - WebSocket client library for Python
 
-Copyright 2021 engn33r
+Copyright 2022 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
@@ -47,8 +47,8 @@ class handshake_response:
         CookieJar.add(headers.get("set-cookie"))
 
 
-def handshake(sock, hostname, port, resource, **options):
-    headers, key = _get_handshake_headers(resource, hostname, port, options)
+def handshake(sock, url, hostname, port, resource, **options):
+    headers, key = _get_handshake_headers(resource, url, hostname, port, options)
 
     header_str = "\r\n".join(headers)
     send(sock, header_str)
@@ -72,7 +72,7 @@ def _pack_hostname(hostname):
     return hostname
 
 
-def _get_handshake_headers(resource, host, port, options):
+def _get_handshake_headers(resource, url, host, port, options):
     headers = [
         "GET %s HTTP/1.1" % resource,
         "Upgrade: websocket"
@@ -86,9 +86,14 @@ def _get_handshake_headers(resource, host, port, options):
     else:
         headers.append("Host: %s" % hostport)
 
+    # scheme indicates whether http or https is used in Origin
+    # The same approach is used in parse_url of _url.py to set default port
+    scheme, url = url.split(":", 1)
     if "suppress_origin" not in options or not options["suppress_origin"]:
         if "origin" in options and options["origin"] is not None:
             headers.append("Origin: %s" % options["origin"])
+        elif scheme == "wss":
+            headers.append("Origin: https://%s" % hostport)
         else:
             headers.append("Origin: http://%s" % hostport)
 
diff --git a/lib/websocket/_http.py b/lib/websocket/_http.py
index 603fa00f..04f32f5a 100644
--- a/lib/websocket/_http.py
+++ b/lib/websocket/_http.py
@@ -2,7 +2,7 @@
 _http.py
 websocket - WebSocket client library for Python
 
-Copyright 2021 engn33r
+Copyright 2022 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
@@ -186,12 +186,10 @@ def _open_socket(addrinfo_list, sockopt, timeout):
             except socket.error as error:
                 error.remote_ip = str(address[0])
                 try:
-                    eConnRefused = (errno.ECONNREFUSED, errno.WSAECONNREFUSED)
+                    eConnRefused = (errno.ECONNREFUSED, errno.WSAECONNREFUSED, errno.ENETUNREACH)
                 except:
-                    eConnRefused = (errno.ECONNREFUSED, )
-                if error.errno == errno.EINTR:
-                    continue
-                elif error.errno in eConnRefused:
+                    eConnRefused = (errno.ECONNREFUSED, errno.ENETUNREACH)
+                if error.errno in eConnRefused:
                     err = error
                     continue
                 else:
diff --git a/lib/websocket/_logging.py b/lib/websocket/_logging.py
index 480d43b0..df690dcc 100644
--- a/lib/websocket/_logging.py
+++ b/lib/websocket/_logging.py
@@ -1,12 +1,10 @@
-"""
-
-"""
+import logging
 
 """
 _logging.py
 websocket - WebSocket client library for Python
 
-Copyright 2021 engn33r
+Copyright 2022 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
@@ -20,7 +18,6 @@ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.
 """
-import logging
 
 _logger = logging.getLogger('websocket')
 try:
diff --git a/lib/websocket/_socket.py b/lib/websocket/_socket.py
index 4d9cc097..54e63997 100644
--- a/lib/websocket/_socket.py
+++ b/lib/websocket/_socket.py
@@ -1,12 +1,16 @@
-"""
+import errno
+import selectors
+import socket
 
-"""
+from ._exceptions import *
+from ._ssl_compat import *
+from ._utils import *
 
 """
 _socket.py
 websocket - WebSocket client library for Python
 
-Copyright 2021 engn33r
+Copyright 2022 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
@@ -20,13 +24,6 @@ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.
 """
-import errno
-import selectors
-import socket
-
-from ._exceptions import *
-from ._ssl_compat import *
-from ._utils import *
 
 DEFAULT_SOCKET_OPTION = [(socket.SOL_TCP, socket.TCP_NODELAY, 1)]
 if hasattr(socket, "SO_KEEPALIVE"):
@@ -92,9 +89,7 @@ def recv(sock, bufsize):
             pass
         except socket.error as exc:
             error_code = extract_error_code(exc)
-            if error_code is None:
-                raise
-            if error_code != errno.EAGAIN or error_code != errno.EWOULDBLOCK:
+            if error_code != errno.EAGAIN and error_code != errno.EWOULDBLOCK:
                 raise
 
         sel = selectors.DefaultSelector()
@@ -111,6 +106,8 @@ def recv(sock, bufsize):
             bytes_ = sock.recv(bufsize)
         else:
             bytes_ = _recv()
+    except TimeoutError:
+        raise WebSocketTimeoutException("Connection timed out")
     except socket.timeout as e:
         message = extract_err_message(e)
         raise WebSocketTimeoutException(message)
diff --git a/lib/websocket/_ssl_compat.py b/lib/websocket/_ssl_compat.py
index f4af524e..e2278401 100644
--- a/lib/websocket/_ssl_compat.py
+++ b/lib/websocket/_ssl_compat.py
@@ -2,7 +2,7 @@
 _ssl_compat.py
 websocket - WebSocket client library for Python
 
-Copyright 2021 engn33r
+Copyright 2022 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
diff --git a/lib/websocket/_url.py b/lib/websocket/_url.py
index f2a55019..2d3d2653 100644
--- a/lib/websocket/_url.py
+++ b/lib/websocket/_url.py
@@ -1,11 +1,14 @@
-"""
+import os
+import socket
+import struct
+
+from urllib.parse import unquote, urlparse
 
-"""
 """
 _url.py
 websocket - WebSocket client library for Python
 
-Copyright 2021 engn33r
+Copyright 2022 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
@@ -20,13 +23,6 @@ See the License for the specific language governing permissions and
 limitations under the License.
 """
 
-import os
-import socket
-import struct
-
-from urllib.parse import unquote, urlparse
-
-
 __all__ = ["parse_url", "get_proxy_info"]
 
 
diff --git a/lib/websocket/_utils.py b/lib/websocket/_utils.py
index 21fc437c..fdcf345b 100644
--- a/lib/websocket/_utils.py
+++ b/lib/websocket/_utils.py
@@ -2,7 +2,7 @@
 _url.py
 websocket - WebSocket client library for Python
 
-Copyright 2021 engn33r
+Copyright 2022 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
diff --git a/lib/websocket/_wsdump.py b/lib/websocket/_wsdump.py
index 4d15f413..860ac342 100644
--- a/lib/websocket/_wsdump.py
+++ b/lib/websocket/_wsdump.py
@@ -4,7 +4,7 @@
 wsdump.py
 websocket - WebSocket client library for Python
 
-Copyright 2021 engn33r
+Copyright 2022 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
@@ -64,7 +64,7 @@ class VAction(argparse.Action):
 def parse_args():
     parser = argparse.ArgumentParser(description="WebSocket Simple Dump Tool")
     parser.add_argument("url", metavar="ws_url",
-                        help="websocket url. ex. ws://echo.websocket.org/")
+                        help="websocket url. ex. ws://echo.websocket.events/")
     parser.add_argument("-p", "--proxy",
                         help="proxy url. ex. http://127.0.0.1:8080")
     parser.add_argument("-v", "--verbose", default=0, nargs='?', action=VAction,
diff --git a/lib/websocket/tests/data/header03.txt b/lib/websocket/tests/data/header03.txt
index 030e13a8..1a81dc70 100644
--- a/lib/websocket/tests/data/header03.txt
+++ b/lib/websocket/tests/data/header03.txt
@@ -3,5 +3,6 @@ Connection: Upgrade, Keep-Alive
 Upgrade: WebSocket
 Sec-WebSocket-Accept: Kxep+hNu9n51529fGidYu7a3wO0=
 Set-Cookie: Token=ABCDE
+Set-Cookie: Token=FGHIJ
 some_header: something
 
diff --git a/lib/websocket/tests/test_abnf.py b/lib/websocket/tests/test_abnf.py
index 7f156dc9..7c9d89d8 100644
--- a/lib/websocket/tests/test_abnf.py
+++ b/lib/websocket/tests/test_abnf.py
@@ -1,10 +1,14 @@
 # -*- coding: utf-8 -*-
 #
+import websocket as ws
+from websocket._abnf import *
+import unittest
+
 """
 test_abnf.py
 websocket - WebSocket client library for Python
 
-Copyright 2021 engn33r
+Copyright 2022 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
@@ -19,10 +23,6 @@ See the License for the specific language governing permissions and
 limitations under the License.
 """
 
-import websocket as ws
-from websocket._abnf import *
-import unittest
-
 
 class ABNFTest(unittest.TestCase):
 
diff --git a/lib/websocket/tests/test_app.py b/lib/websocket/tests/test_app.py
index cd1146b3..ac2a7dd5 100644
--- a/lib/websocket/tests/test_app.py
+++ b/lib/websocket/tests/test_app.py
@@ -1,10 +1,17 @@
 # -*- coding: utf-8 -*-
 #
+import os
+import os.path
+import threading
+import websocket as ws
+import ssl
+import unittest
+
 """
 test_app.py
 websocket - WebSocket client library for Python
 
-Copyright 2021 engn33r
+Copyright 2022 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
@@ -19,12 +26,6 @@ See the License for the specific language governing permissions and
 limitations under the License.
 """
 
-import os
-import os.path
-import websocket as ws
-import ssl
-import unittest
-
 # Skip test to access the internet unless TEST_WITH_INTERNET == 1
 TEST_WITH_INTERNET = os.environ.get('TEST_WITH_INTERNET', '0') == '1'
 # Skip tests relying on local websockets server unless LOCAL_WS_SERVER_PORT != -1
@@ -45,11 +46,13 @@ class WebSocketAppTest(unittest.TestCase):
         WebSocketAppTest.keep_running_open = WebSocketAppTest.NotSetYet()
         WebSocketAppTest.keep_running_close = WebSocketAppTest.NotSetYet()
         WebSocketAppTest.get_mask_key_id = WebSocketAppTest.NotSetYet()
+        WebSocketAppTest.on_error_data = WebSocketAppTest.NotSetYet()
 
     def tearDown(self):
         WebSocketAppTest.keep_running_open = WebSocketAppTest.NotSetYet()
         WebSocketAppTest.keep_running_close = WebSocketAppTest.NotSetYet()
         WebSocketAppTest.get_mask_key_id = WebSocketAppTest.NotSetYet()
+        WebSocketAppTest.on_error_data = WebSocketAppTest.NotSetYet()
 
     @unittest.skipUnless(TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled")
     def testKeepRunning(self):
@@ -77,6 +80,54 @@ class WebSocketAppTest(unittest.TestCase):
         app = ws.WebSocketApp('ws://127.0.0.1:' + LOCAL_WS_SERVER_PORT, on_open=on_open, on_close=on_close, on_message=on_message)
         app.run_forever()
 
+    @unittest.skipUnless(TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled")
+    def testRunForeverDispatcher(self):
+        """ A WebSocketApp should keep running as long as its self.keep_running
+        is not False (in the boolean context).
+        """
+
+        def on_open(self, *args, **kwargs):
+            """ Send a message, receive, and send one more
+            """
+            self.send("hello!")
+            self.recv()
+            self.send("goodbye!")
+
+        def on_message(wsapp, message):
+            print(message)
+            self.close()
+
+        app = ws.WebSocketApp('ws://127.0.0.1:' + LOCAL_WS_SERVER_PORT, on_open=on_open, on_message=on_message)
+        app.run_forever(dispatcher="Dispatcher")
+
+    @unittest.skipUnless(TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled")
+    def testRunForeverTeardownCleanExit(self):
+        """ The WebSocketApp.run_forever() method should return `False` when the application ends gracefully.
+        """
+        app = ws.WebSocketApp('ws://127.0.0.1:' + LOCAL_WS_SERVER_PORT)
+        threading.Timer(interval=0.2, function=app.close).start()
+        teardown = app.run_forever()
+        self.assertEqual(teardown, False)
+
+    @unittest.skipUnless(TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled")
+    def testRunForeverTeardownExceptionalExit(self):
+        """ The WebSocketApp.run_forever() method should return `True` when the application ends with an exception.
+        It should also invoke the `on_error` callback before exiting.
+        """
+
+        def break_it():
+            # Deliberately break the WebSocketApp by closing the inner socket.
+            app.sock.close()
+
+        def on_error(_, err):
+            WebSocketAppTest.on_error_data = str(err)
+
+        app = ws.WebSocketApp('ws://127.0.0.1:' + LOCAL_WS_SERVER_PORT, on_error=on_error)
+        threading.Timer(interval=0.2, function=break_it).start()
+        teardown = app.run_forever(ping_timeout=0.1)
+        self.assertEqual(teardown, True)
+        self.assertTrue(len(WebSocketAppTest.on_error_data) > 0)
+
     @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled")
     def testSockMaskKey(self):
         """ A WebSocketApp should forward the received mask_key function down
@@ -86,7 +137,7 @@ class WebSocketAppTest(unittest.TestCase):
         def my_mask_key_func():
             return "\x00\x00\x00\x00"
 
-        app = ws.WebSocketApp('wss://stream.meetup.com/2/rsvps', get_mask_key=my_mask_key_func)
+        app = ws.WebSocketApp('wss://api-pub.bitfinex.com/ws/1', get_mask_key=my_mask_key_func)
 
         # if numpy is installed, this assertion fail
         # Note: We can't use 'is' for comparing the functions directly, need to use 'id'.
@@ -136,7 +187,7 @@ class WebSocketAppTest(unittest.TestCase):
     def testOpcodeBinary(self):
         """ Test WebSocketApp binary opcode
         """
-
+        # The lack of wss:// in the URL below is on purpose
         app = ws.WebSocketApp('streaming.vn.teslamotors.com/streaming/')
         app.run_forever(ping_interval=2, ping_timeout=1, ping_payload="Ping payload")
 
diff --git a/lib/websocket/tests/test_cookiejar.py b/lib/websocket/tests/test_cookiejar.py
index 5bf1fcae..559b2e00 100644
--- a/lib/websocket/tests/test_cookiejar.py
+++ b/lib/websocket/tests/test_cookiejar.py
@@ -1,12 +1,11 @@
-"""
-
-"""
+import unittest
+from websocket._cookiejar import SimpleCookieJar
 
 """
 test_cookiejar.py
 websocket - WebSocket client library for Python
 
-Copyright 2021 engn33r
+Copyright 2022 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
@@ -20,8 +19,6 @@ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.
 """
-import unittest
-from websocket._cookiejar import SimpleCookieJar
 
 
 class CookieJarTest(unittest.TestCase):
diff --git a/lib/websocket/tests/test_http.py b/lib/websocket/tests/test_http.py
index fda467d7..649e0fe6 100644
--- a/lib/websocket/tests/test_http.py
+++ b/lib/websocket/tests/test_http.py
@@ -1,10 +1,19 @@
 # -*- coding: utf-8 -*-
 #
+import os
+import os.path
+import websocket as ws
+from websocket._http import proxy_info, read_headers, _start_proxied_socket, _tunnel, _get_addrinfo_list, connect
+import unittest
+import ssl
+import websocket
+import socket
+
 """
 test_http.py
 websocket - WebSocket client library for Python
 
-Copyright 2021 engn33r
+Copyright 2022 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
@@ -19,15 +28,6 @@ See the License for the specific language governing permissions and
 limitations under the License.
 """
 
-import os
-import os.path
-import websocket as ws
-from websocket._http import proxy_info, read_headers, _start_proxied_socket, _tunnel, _get_addrinfo_list, connect
-import unittest
-import ssl
-import websocket
-import socket
-
 try:
     from python_socks._errors import ProxyError, ProxyTimeoutError, ProxyConnectionError
 except:
diff --git a/lib/websocket/tests/test_url.py b/lib/websocket/tests/test_url.py
index ad3a3b1b..7e155fd1 100644
--- a/lib/websocket/tests/test_url.py
+++ b/lib/websocket/tests/test_url.py
@@ -1,10 +1,14 @@
 # -*- coding: utf-8 -*-
 #
+import os
+import unittest
+from websocket._url import get_proxy_info, parse_url, _is_address_in_network, _is_no_proxy_host
+
 """
 test_url.py
 websocket - WebSocket client library for Python
 
-Copyright 2021 engn33r
+Copyright 2022 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
@@ -19,10 +23,6 @@ See the License for the specific language governing permissions and
 limitations under the License.
 """
 
-import os
-import unittest
-from websocket._url import get_proxy_info, parse_url, _is_address_in_network, _is_no_proxy_host
-
 
 class UrlTest(unittest.TestCase):
 
@@ -209,73 +209,73 @@ class ProxyInfoTest(unittest.TestCase):
             del os.environ["no_proxy"]
 
     def testProxyFromArgs(self):
-        self.assertEqual(get_proxy_info("echo.websocket.org", False, proxy_host="localhost"), ("localhost", 0, None))
-        self.assertEqual(get_proxy_info("echo.websocket.org", False, proxy_host="localhost", proxy_port=3128),
+        self.assertEqual(get_proxy_info("echo.websocket.events", False, proxy_host="localhost"), ("localhost", 0, None))
+        self.assertEqual(get_proxy_info("echo.websocket.events", False, proxy_host="localhost", proxy_port=3128),
                          ("localhost", 3128, None))
-        self.assertEqual(get_proxy_info("echo.websocket.org", True, proxy_host="localhost"), ("localhost", 0, None))
-        self.assertEqual(get_proxy_info("echo.websocket.org", True, proxy_host="localhost", proxy_port=3128),
+        self.assertEqual(get_proxy_info("echo.websocket.events", True, proxy_host="localhost"), ("localhost", 0, None))
+        self.assertEqual(get_proxy_info("echo.websocket.events", True, proxy_host="localhost", proxy_port=3128),
                          ("localhost", 3128, None))
 
-        self.assertEqual(get_proxy_info("echo.websocket.org", False, proxy_host="localhost", proxy_auth=("a", "b")),
+        self.assertEqual(get_proxy_info("echo.websocket.events", False, proxy_host="localhost", proxy_auth=("a", "b")),
                          ("localhost", 0, ("a", "b")))
         self.assertEqual(
-            get_proxy_info("echo.websocket.org", False, proxy_host="localhost", proxy_port=3128, proxy_auth=("a", "b")),
+            get_proxy_info("echo.websocket.events", False, proxy_host="localhost", proxy_port=3128, proxy_auth=("a", "b")),
             ("localhost", 3128, ("a", "b")))
-        self.assertEqual(get_proxy_info("echo.websocket.org", True, proxy_host="localhost", proxy_auth=("a", "b")),
+        self.assertEqual(get_proxy_info("echo.websocket.events", True, proxy_host="localhost", proxy_auth=("a", "b")),
                          ("localhost", 0, ("a", "b")))
         self.assertEqual(
-            get_proxy_info("echo.websocket.org", True, proxy_host="localhost", proxy_port=3128, proxy_auth=("a", "b")),
+            get_proxy_info("echo.websocket.events", True, proxy_host="localhost", proxy_port=3128, proxy_auth=("a", "b")),
             ("localhost", 3128, ("a", "b")))
 
-        self.assertEqual(get_proxy_info("echo.websocket.org", True, proxy_host="localhost", proxy_port=3128,
+        self.assertEqual(get_proxy_info("echo.websocket.events", True, proxy_host="localhost", proxy_port=3128,
                                         no_proxy=["example.com"], proxy_auth=("a", "b")),
                          ("localhost", 3128, ("a", "b")))
-        self.assertEqual(get_proxy_info("echo.websocket.org", True, proxy_host="localhost", proxy_port=3128,
-                                        no_proxy=["echo.websocket.org"], proxy_auth=("a", "b")),
+        self.assertEqual(get_proxy_info("echo.websocket.events", True, proxy_host="localhost", proxy_port=3128,
+                                        no_proxy=["echo.websocket.events"], proxy_auth=("a", "b")),
                          (None, 0, None))
 
     def testProxyFromEnv(self):
         os.environ["http_proxy"] = "http://localhost/"
-        self.assertEqual(get_proxy_info("echo.websocket.org", False), ("localhost", None, None))
+        self.assertEqual(get_proxy_info("echo.websocket.events", False), ("localhost", None, None))
         os.environ["http_proxy"] = "http://localhost:3128/"
-        self.assertEqual(get_proxy_info("echo.websocket.org", False), ("localhost", 3128, None))
+        self.assertEqual(get_proxy_info("echo.websocket.events", False), ("localhost", 3128, None))
 
         os.environ["http_proxy"] = "http://localhost/"
         os.environ["https_proxy"] = "http://localhost2/"
-        self.assertEqual(get_proxy_info("echo.websocket.org", False), ("localhost", None, None))
+        self.assertEqual(get_proxy_info("echo.websocket.events", False), ("localhost", None, None))
         os.environ["http_proxy"] = "http://localhost:3128/"
         os.environ["https_proxy"] = "http://localhost2:3128/"
-        self.assertEqual(get_proxy_info("echo.websocket.org", False), ("localhost", 3128, None))
+        self.assertEqual(get_proxy_info("echo.websocket.events", False), ("localhost", 3128, None))
 
         os.environ["http_proxy"] = "http://localhost/"
         os.environ["https_proxy"] = "http://localhost2/"
-        self.assertEqual(get_proxy_info("echo.websocket.org", True), ("localhost2", None, None))
+        self.assertEqual(get_proxy_info("echo.websocket.events", True), ("localhost2", None, None))
         os.environ["http_proxy"] = "http://localhost:3128/"
         os.environ["https_proxy"] = "http://localhost2:3128/"
-        self.assertEqual(get_proxy_info("echo.websocket.org", True), ("localhost2", 3128, None))
+        self.assertEqual(get_proxy_info("echo.websocket.events", True), ("localhost2", 3128, None))
 
         os.environ["http_proxy"] = "http://a:b@localhost/"
-        self.assertEqual(get_proxy_info("echo.websocket.org", False), ("localhost", None, ("a", "b")))
+        self.assertEqual(get_proxy_info("echo.websocket.events", False), ("localhost", None, ("a", "b")))
         os.environ["http_proxy"] = "http://a:b@localhost:3128/"
-        self.assertEqual(get_proxy_info("echo.websocket.org", False), ("localhost", 3128, ("a", "b")))
+        self.assertEqual(get_proxy_info("echo.websocket.events", False), ("localhost", 3128, ("a", "b")))
 
         os.environ["http_proxy"] = "http://a:b@localhost/"
         os.environ["https_proxy"] = "http://a:b@localhost2/"
-        self.assertEqual(get_proxy_info("echo.websocket.org", False), ("localhost", None, ("a", "b")))
+        self.assertEqual(get_proxy_info("echo.websocket.events", False), ("localhost", None, ("a", "b")))
         os.environ["http_proxy"] = "http://a:b@localhost:3128/"
         os.environ["https_proxy"] = "http://a:b@localhost2:3128/"
-        self.assertEqual(get_proxy_info("echo.websocket.org", False), ("localhost", 3128, ("a", "b")))
+        self.assertEqual(get_proxy_info("echo.websocket.events", False), ("localhost", 3128, ("a", "b")))
 
         os.environ["http_proxy"] = "http://a:b@localhost/"
         os.environ["https_proxy"] = "http://a:b@localhost2/"
-        self.assertEqual(get_proxy_info("echo.websocket.org", True), ("localhost2", None, ("a", "b")))
+        self.assertEqual(get_proxy_info("echo.websocket.events", True), ("localhost2", None, ("a", "b")))
         os.environ["http_proxy"] = "http://a:b@localhost:3128/"
         os.environ["https_proxy"] = "http://a:b@localhost2:3128/"
-        self.assertEqual(get_proxy_info("echo.websocket.org", True), ("localhost2", 3128, ("a", "b")))
+        self.assertEqual(get_proxy_info("echo.websocket.events", True), ("localhost2", 3128, ("a", "b")))
 
         os.environ["http_proxy"] = "http://john%40example.com:P%40SSWORD@localhost:3128/"
         os.environ["https_proxy"] = "http://john%40example.com:P%40SSWORD@localhost2:3128/"
-        self.assertEqual(get_proxy_info("echo.websocket.org", True), ("localhost2", 3128, ("john@example.com", "P@SSWORD")))
+        self.assertEqual(get_proxy_info("echo.websocket.events", True), ("localhost2", 3128, ("john@example.com", "P@SSWORD")))
 
         os.environ["http_proxy"] = "http://a:b@localhost/"
         os.environ["https_proxy"] = "http://a:b@localhost2/"
@@ -283,12 +283,12 @@ class ProxyInfoTest(unittest.TestCase):
         self.assertEqual(get_proxy_info("example.1.com", True), ("localhost2", None, ("a", "b")))
         os.environ["http_proxy"] = "http://a:b@localhost:3128/"
         os.environ["https_proxy"] = "http://a:b@localhost2:3128/"
-        os.environ["no_proxy"] = "example1.com,example2.com, echo.websocket.org"
-        self.assertEqual(get_proxy_info("echo.websocket.org", True), (None, 0, None))
+        os.environ["no_proxy"] = "example1.com,example2.com, echo.websocket.events"
+        self.assertEqual(get_proxy_info("echo.websocket.events", True), (None, 0, None))
         os.environ["http_proxy"] = "http://a:b@localhost:3128/"
         os.environ["https_proxy"] = "http://a:b@localhost2:3128/"
-        os.environ["no_proxy"] = "example1.com,example2.com, .websocket.org"
-        self.assertEqual(get_proxy_info("echo.websocket.org", True), (None, 0, None))
+        os.environ["no_proxy"] = "example1.com,example2.com, .websocket.events"
+        self.assertEqual(get_proxy_info("echo.websocket.events", True), (None, 0, None))
 
         os.environ["http_proxy"] = "http://a:b@localhost:3128/"
         os.environ["https_proxy"] = "http://a:b@localhost2:3128/"
diff --git a/lib/websocket/tests/test_websocket.py b/lib/websocket/tests/test_websocket.py
index 8b34aa51..ae42ab54 100644
--- a/lib/websocket/tests/test_websocket.py
+++ b/lib/websocket/tests/test_websocket.py
@@ -1,14 +1,21 @@
 # -*- coding: utf-8 -*-
 #
-"""
-
-"""
+import os
+import os.path
+import socket
+import websocket as ws
+import unittest
+from websocket._handshake import _create_sec_websocket_key, \
+    _validate as _validate_header
+from websocket._http import read_headers
+from websocket._utils import validate_utf8
+from base64 import decodebytes as base64decode
 
 """
 test_websocket.py
 websocket - WebSocket client library for Python
 
-Copyright 2021 engn33r
+Copyright 2022 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
@@ -23,18 +30,6 @@ See the License for the specific language governing permissions and
 limitations under the License.
 """
 
-import os
-import os.path
-import socket
-import websocket as ws
-from websocket._handshake import _create_sec_websocket_key, \
-    _validate as _validate_header
-from websocket._http import read_headers
-from websocket._utils import validate_utf8
-from base64 import decodebytes as base64decode
-
-import unittest
-
 try:
     import ssl
     from ssl import SSLError
@@ -201,14 +196,16 @@ class WebSocketTest(unittest.TestCase):
     @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled")
     def testIter(self):
         count = 2
-        for _ in ws.create_connection('wss://stream.meetup.com/2/rsvps'):
+        s = ws.create_connection('wss://api.bitfinex.com/ws/2')
+        s.send('{"event": "subscribe", "channel": "ticker"}')
+        for _ in s:
             count -= 1
             if count == 0:
                 break
 
     @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled")
     def testNext(self):
-        sock = ws.create_connection('wss://stream.meetup.com/2/rsvps')
+        sock = ws.create_connection('wss://api.bitfinex.com/ws/2')
         self.assertEqual(str, type(next(sock)))
 
     def testInternalRecvStrict(self):
@@ -383,6 +380,7 @@ class WebSocketTest(unittest.TestCase):
         s = ws.create_connection("ws://127.0.0.1:" + LOCAL_WS_SERVER_PORT,
                                  headers={"User-Agent": "PythonWebsocketClient"})
         self.assertNotEqual(s, None)
+        self.assertEqual(s.getsubprotocol(), None)
         s.send("Hello, World")
         result = s.recv()
         self.assertEqual(result, "Hello, World")
diff --git a/requirements.txt b/requirements.txt
index 99f8033e..b91e719f 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -47,7 +47,7 @@ tzdata==2022.1
 tzlocal==4.2
 urllib3==1.26.9
 webencodings==0.5.1
-websocket-client==1.2.3
+websocket-client==1.3.2
 xmltodict==0.12.0
 zipp==3.8.0
 

From a1fe0b04d7edd0dd106f7f9aa0987a59ac478398 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 16 May 2022 20:41:47 -0700
Subject: [PATCH 080/743] Bump bleach from 4.1.0 to 5.0.0 (#1708)

* Bump bleach from 4.1.0 to 5.0.0

Bumps [bleach](https://github.com/mozilla/bleach) from 4.1.0 to 5.0.0.
- [Release notes](https://github.com/mozilla/bleach/releases)
- [Changelog](https://github.com/mozilla/bleach/blob/main/CHANGES)
- [Commits](https://github.com/mozilla/bleach/compare/v4.1.0...v5.0.0)

---
updated-dependencies:
- dependency-name: bleach
  dependency-type: direct:production
  update-type: version-update:semver-major
...

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

* Update bleach==5.0.0

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/bleach/__init__.py                        |  20 ++-
 .../_vendor/html5lib-1.1.dist-info/LICENSE    |  20 +++
 .../_vendor/html5lib-1.1.dist-info/REQUESTED  |   0
 lib/bleach/_vendor/parse.py.SHA256SUM         |   1 +
 lib/bleach/css_sanitizer.py                   | 104 ++++++++++++++++
 lib/bleach/html5lib_shim.py                   | 115 +++++++++++++-----
 lib/bleach/linkifier.py                       |  24 ++--
 lib/bleach/sanitizer.py                       | 108 ++++++----------
 lib/bleach/utils.py                           |  21 ----
 requirements.txt                              |   2 +-
 10 files changed, 264 insertions(+), 151 deletions(-)
 create mode 100644 lib/bleach/_vendor/html5lib-1.1.dist-info/LICENSE
 create mode 100644 lib/bleach/_vendor/html5lib-1.1.dist-info/REQUESTED
 create mode 100644 lib/bleach/_vendor/parse.py.SHA256SUM
 create mode 100644 lib/bleach/css_sanitizer.py
 delete mode 100644 lib/bleach/utils.py

diff --git a/lib/bleach/__init__.py b/lib/bleach/__init__.py
index d619fb2c..d271811d 100644
--- a/lib/bleach/__init__.py
+++ b/lib/bleach/__init__.py
@@ -1,7 +1,3 @@
-# -*- coding: utf-8 -*-
-
-import packaging.version
-
 from bleach.linkifier import (
     DEFAULT_CALLBACKS,
     Linker,
@@ -9,17 +5,15 @@ from bleach.linkifier import (
 from bleach.sanitizer import (
     ALLOWED_ATTRIBUTES,
     ALLOWED_PROTOCOLS,
-    ALLOWED_STYLES,
     ALLOWED_TAGS,
     Cleaner,
 )
 
 
 # yyyymmdd
-__releasedate__ = "20210825"
+__releasedate__ = "20220407"
 # x.y.z or x.y.z.dev0 -- semver
-__version__ = "4.1.0"
-VERSION = packaging.version.Version(__version__)
+__version__ = "5.0.0"
 
 
 __all__ = ["clean", "linkify"]
@@ -29,10 +23,10 @@ def clean(
     text,
     tags=ALLOWED_TAGS,
     attributes=ALLOWED_ATTRIBUTES,
-    styles=ALLOWED_STYLES,
     protocols=ALLOWED_PROTOCOLS,
     strip=False,
     strip_comments=True,
+    css_sanitizer=None,
 ):
     """Clean an HTML fragment of malicious content and return it
 
@@ -64,9 +58,6 @@ def clean(
     :arg dict attributes: allowed attributes; can be a callable, list or dict;
         defaults to ``bleach.sanitizer.ALLOWED_ATTRIBUTES``
 
-    :arg list styles: allowed list of css styles; defaults to
-        ``bleach.sanitizer.ALLOWED_STYLES``
-
     :arg list protocols: allowed list of protocols for links; defaults
         to ``bleach.sanitizer.ALLOWED_PROTOCOLS``
 
@@ -74,16 +65,19 @@ def clean(
 
     :arg bool strip_comments: whether or not to strip HTML comments
 
+    :arg CSSSanitizer css_sanitizer: instance with a "sanitize_css" method for
+        sanitizing style attribute values and style text; defaults to None
+
     :returns: cleaned text as unicode
 
     """
     cleaner = Cleaner(
         tags=tags,
         attributes=attributes,
-        styles=styles,
         protocols=protocols,
         strip=strip,
         strip_comments=strip_comments,
+        css_sanitizer=css_sanitizer,
     )
     return cleaner.clean(text)
 
diff --git a/lib/bleach/_vendor/html5lib-1.1.dist-info/LICENSE b/lib/bleach/_vendor/html5lib-1.1.dist-info/LICENSE
new file mode 100644
index 00000000..c87fa7a0
--- /dev/null
+++ b/lib/bleach/_vendor/html5lib-1.1.dist-info/LICENSE
@@ -0,0 +1,20 @@
+Copyright (c) 2006-2013 James Graham and other contributors
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
diff --git a/lib/bleach/_vendor/html5lib-1.1.dist-info/REQUESTED b/lib/bleach/_vendor/html5lib-1.1.dist-info/REQUESTED
new file mode 100644
index 00000000..e69de29b
diff --git a/lib/bleach/_vendor/parse.py.SHA256SUM b/lib/bleach/_vendor/parse.py.SHA256SUM
new file mode 100644
index 00000000..a324b193
--- /dev/null
+++ b/lib/bleach/_vendor/parse.py.SHA256SUM
@@ -0,0 +1 @@
+46af966e33b6247ae1d57d9459115a3eb46cda9f809c9f14e052abc2fe8dacb2  parse.py
diff --git a/lib/bleach/css_sanitizer.py b/lib/bleach/css_sanitizer.py
new file mode 100644
index 00000000..489dd6bc
--- /dev/null
+++ b/lib/bleach/css_sanitizer.py
@@ -0,0 +1,104 @@
+import tinycss2
+
+
+ALLOWED_CSS_PROPERTIES = frozenset(
+    (
+        "azimuth",
+        "background-color",
+        "border-bottom-color",
+        "border-collapse",
+        "border-color",
+        "border-left-color",
+        "border-right-color",
+        "border-top-color",
+        "clear",
+        "color",
+        "cursor",
+        "direction",
+        "display",
+        "elevation",
+        "float",
+        "font",
+        "font-family",
+        "font-size",
+        "font-style",
+        "font-variant",
+        "font-weight",
+        "height",
+        "letter-spacing",
+        "line-height",
+        "overflow",
+        "pause",
+        "pause-after",
+        "pause-before",
+        "pitch",
+        "pitch-range",
+        "richness",
+        "speak",
+        "speak-header",
+        "speak-numeral",
+        "speak-punctuation",
+        "speech-rate",
+        "stress",
+        "text-align",
+        "text-decoration",
+        "text-indent",
+        "unicode-bidi",
+        "vertical-align",
+        "voice-family",
+        "volume",
+        "white-space",
+        "width",
+    )
+)
+
+
+ALLOWED_SVG_PROPERTIES = frozenset(
+    (
+        "fill",
+        "fill-opacity",
+        "fill-rule",
+        "stroke",
+        "stroke-width",
+        "stroke-linecap",
+        "stroke-linejoin",
+        "stroke-opacity",
+    )
+)
+
+
+class CSSSanitizer:
+    def __init__(
+        self,
+        allowed_css_properties=ALLOWED_CSS_PROPERTIES,
+        allowed_svg_properties=ALLOWED_SVG_PROPERTIES,
+    ):
+        self.allowed_css_properties = allowed_css_properties
+        self.allowed_svg_properties = allowed_svg_properties
+
+    def sanitize_css(self, style):
+        """Sanitizes css in style tags"""
+        parsed = tinycss2.parse_declaration_list(style)
+
+        if not parsed:
+            return ""
+
+        new_tokens = []
+        for token in parsed:
+            if token.type == "declaration":
+                if (
+                    token.lower_name in self.allowed_css_properties
+                    or token.lower_name in self.allowed_svg_properties
+                ):
+                    new_tokens.append(token)
+            elif token.type in ("comment", "whitespace"):
+                if new_tokens and new_tokens[-1].type != token.type:
+                    new_tokens.append(token)
+
+            # NOTE(willkg): We currently don't handle AtRule or ParseError and
+            # so both get silently thrown out
+
+        if not new_tokens:
+            return ""
+
+        return tinycss2.serialize(new_tokens).strip()
diff --git a/lib/bleach/html5lib_shim.py b/lib/bleach/html5lib_shim.py
index 3c9c3306..6fc90485 100644
--- a/lib/bleach/html5lib_shim.py
+++ b/lib/bleach/html5lib_shim.py
@@ -36,6 +36,8 @@ from bleach._vendor.html5lib.filters.base import (
 )  # noqa: E402 module level import not at top of file
 from bleach._vendor.html5lib.filters.sanitizer import (
     allowed_protocols,
+    allowed_css_properties,
+    allowed_svg_properties,
 )  # noqa: E402 module level import not at top of file
 from bleach._vendor.html5lib.filters.sanitizer import (
     Filter as SanitizerFilter,
@@ -68,8 +70,10 @@ TAG_TOKEN_TYPES = {
     constants.tokenTypes["EndTag"],
     constants.tokenTypes["EmptyTag"],
 }
-CHARACTERS_TYPE = constants.tokenTypes["Characters"]
-PARSEERROR_TYPE = constants.tokenTypes["ParseError"]
+TAG_TOKEN_TYPE_START = constants.tokenTypes["StartTag"]
+TAG_TOKEN_TYPE_END = constants.tokenTypes["EndTag"]
+TAG_TOKEN_TYPE_CHARACTERS = constants.tokenTypes["Characters"]
+TAG_TOKEN_TYPE_PARSEERROR = constants.tokenTypes["ParseError"]
 
 
 #: List of valid HTML tags, from WHATWG HTML Living Standard as of 2018-10-17
@@ -190,6 +194,48 @@ HTML_TAGS = [
 ]
 
 
+#: List of block level HTML tags, as per https://github.com/mozilla/bleach/issues/369
+#: from mozilla on 2019.07.11
+#: https://developer.mozilla.org/en-US/docs/Web/HTML/Block-level_elements#Elements
+HTML_TAGS_BLOCK_LEVEL = frozenset(
+    [
+        "address",
+        "article",
+        "aside",
+        "blockquote",
+        "details",
+        "dialog",
+        "dd",
+        "div",
+        "dl",
+        "dt",
+        "fieldset",
+        "figcaption",
+        "figure",
+        "footer",
+        "form",
+        "h1",
+        "h2",
+        "h3",
+        "h4",
+        "h5",
+        "h6",
+        "header",
+        "hgroup",
+        "hr",
+        "li",
+        "main",
+        "nav",
+        "ol",
+        "p",
+        "pre",
+        "section",
+        "table",
+        "ul",
+    ]
+)
+
+
 class InputStreamWithMemory:
     """Wraps an HTMLInputStream to remember characters since last <
 
@@ -257,17 +303,20 @@ class BleachHTMLTokenizer(HTMLTokenizer):
     """Tokenizer that doesn't consume character entities"""
 
     def __init__(self, consume_entities=False, **kwargs):
-        super(BleachHTMLTokenizer, self).__init__(**kwargs)
+        super().__init__(**kwargs)
 
         self.consume_entities = consume_entities
 
         # Wrap the stream with one that remembers the history
         self.stream = InputStreamWithMemory(self.stream)
 
+        # Remember the last token emitted; needed for block element spacing
+        self.emitted_last_token = None
+
     def __iter__(self):
         last_error_token = None
 
-        for token in super(BleachHTMLTokenizer, self).__iter__():
+        for token in super().__iter__():
             if last_error_token is not None:
                 if (
                     last_error_token["data"] == "invalid-character-in-attribute-name"
@@ -309,12 +358,12 @@ class BleachHTMLTokenizer(HTMLTokenizer):
                     # If this is not an allowed tag, then we convert it to
                     # characters and it'll get escaped in the sanitizer.
                     token["data"] = self.stream.get_tag()
-                    token["type"] = CHARACTERS_TYPE
+                    token["type"] = TAG_TOKEN_TYPE_CHARACTERS
 
                     last_error_token = None
                     yield token
 
-                elif token["type"] == PARSEERROR_TYPE:
+                elif token["type"] == TAG_TOKEN_TYPE_PARSEERROR:
                     # If the token is a parse error, then let the last_error_token
                     # go, and make token the new last_error_token
                     yield last_error_token
@@ -329,7 +378,7 @@ class BleachHTMLTokenizer(HTMLTokenizer):
 
             # If the token is a ParseError, we hold on to it so we can get the
             # next token and potentially fix it.
-            if token["type"] == PARSEERROR_TYPE:
+            if token["type"] == TAG_TOKEN_TYPE_PARSEERROR:
                 last_error_token = token
                 continue
 
@@ -342,9 +391,7 @@ class BleachHTMLTokenizer(HTMLTokenizer):
         # If this tokenizer is set to consume entities, then we can let the
         # superclass do its thing.
         if self.consume_entities:
-            return super(BleachHTMLTokenizer, self).consumeEntity(
-                allowedChar, fromAttribute
-            )
+            return super().consumeEntity(allowedChar, fromAttribute)
 
         # If this tokenizer is set to not consume entities, then we don't want
         # to consume and convert them, so this overrides the html5lib tokenizer's
@@ -356,7 +403,7 @@ class BleachHTMLTokenizer(HTMLTokenizer):
             self.currentToken["data"][-1][1] += "&"
 
         else:
-            self.tokenQueue.append({"type": CHARACTERS_TYPE, "data": "&"})
+            self.tokenQueue.append({"type": TAG_TOKEN_TYPE_CHARACTERS, "data": "&"})
 
     def tagOpenState(self):
         # This state marks a < that is either a StartTag, EndTag, EmptyTag,
@@ -364,7 +411,7 @@ class BleachHTMLTokenizer(HTMLTokenizer):
         # we've collected so far and we do that by calling start_tag() on
         # the input stream wrapper.
         self.stream.start_tag()
-        return super(BleachHTMLTokenizer, self).tagOpenState()
+        return super().tagOpenState()
 
     def emitCurrentToken(self):
         token = self.currentToken
@@ -378,9 +425,19 @@ class BleachHTMLTokenizer(HTMLTokenizer):
             # allowed list, then it gets stripped or escaped. In both of these
             # cases it gets converted to a Characters token.
             if self.parser.strip:
-                # If we're stripping the token, we just throw in an empty
-                # string token.
-                new_data = ""
+                if (
+                    self.emitted_last_token
+                    and token["type"] == TAG_TOKEN_TYPE_START
+                    and token["name"].lower() in HTML_TAGS_BLOCK_LEVEL
+                ):
+                    # If this is a block level tag we're stripping, we drop it
+                    # for a newline because that's what a browser would parse
+                    # it as
+                    new_data = "\n"
+                else:
+                    # For all other things being stripped, we throw in an empty
+                    # string token
+                    new_data = ""
 
             else:
                 # If we're escaping the token, we want to escape the exact
@@ -390,14 +447,15 @@ class BleachHTMLTokenizer(HTMLTokenizer):
                 # string and use that.
                 new_data = self.stream.get_tag()
 
-            new_token = {"type": CHARACTERS_TYPE, "data": new_data}
+            new_token = {"type": TAG_TOKEN_TYPE_CHARACTERS, "data": new_data}
 
-            self.currentToken = new_token
+            self.currentToken = self.emitted_last_token = new_token
             self.tokenQueue.append(new_token)
             self.state = self.dataState
             return
 
-        super(BleachHTMLTokenizer, self).emitCurrentToken()
+        self.emitted_last_token = self.currentToken
+        super().emitCurrentToken()
 
 
 class BleachHTMLParser(HTMLParser):
@@ -416,7 +474,7 @@ class BleachHTMLParser(HTMLParser):
         self.tags = [tag.lower() for tag in tags] if tags is not None else None
         self.strip = strip
         self.consume_entities = consume_entities
-        super(BleachHTMLParser, self).__init__(**kwargs)
+        super().__init__(**kwargs)
 
     def _parse(
         self, stream, innerHTML=False, container="div", scripting=True, **kwargs
@@ -514,13 +572,13 @@ def convert_entities(text):
 def match_entity(stream):
     """Returns first entity in stream or None if no entity exists
 
-    Note: For Bleach purposes, entities must start with a "&" and end with
-    a ";". This ignoresambiguous character entities that have no ";" at the
-    end.
+    Note: For Bleach purposes, entities must start with a "&" and end with a
+    ";". This ignores ambiguous character entities that have no ";" at the end.
 
     :arg stream: the character stream
 
-    :returns: ``None`` or the entity string without "&" or ";"
+    :returns: the entity string without "&" or ";" if it's a valid character
+        entity; ``None`` otherwise
 
     """
     # Nix the & at the beginning
@@ -559,9 +617,11 @@ def match_entity(stream):
     # Handle character entities
     while stream and stream[0] not in end_characters:
         c = stream.pop(0)
-        if not ENTITIES_TRIE.has_keys_with_prefix(possible_entity):
-            break
         possible_entity += c
+        if not ENTITIES_TRIE.has_keys_with_prefix(possible_entity):
+            # If it's not a prefix, then it's not an entity and we're
+            # out
+            return None
 
     if possible_entity and stream and stream[0] == ";":
         return possible_entity
@@ -642,15 +702,14 @@ class BleachHTMLSerializer(HTMLSerializer):
         in_tag = False
         after_equals = False
 
-        for stoken in super(BleachHTMLSerializer, self).serialize(treewalker, encoding):
+        for stoken in super().serialize(treewalker, encoding):
             if in_tag:
                 if stoken == ">":
                     in_tag = False
 
                 elif after_equals:
                     if stoken != '"':
-                        for part in self.escape_base_amp(stoken):
-                            yield part
+                        yield from self.escape_base_amp(stoken)
 
                         after_equals = False
                         continue
diff --git a/lib/bleach/linkifier.py b/lib/bleach/linkifier.py
index 759882e9..68a4042e 100644
--- a/lib/bleach/linkifier.py
+++ b/lib/bleach/linkifier.py
@@ -2,7 +2,6 @@ import re
 
 from bleach import callbacks as linkify_callbacks
 from bleach import html5lib_shim
-from bleach.utils import alphabetize_attributes
 
 
 #: List of default callbacks
@@ -155,7 +154,7 @@ class Linker:
             omit_optional_tags=False,
             # linkify does not sanitize
             sanitize=False,
-            # linkify alphabetizes
+            # linkify preserves attr order
             alphabetical_attributes=False,
         )
 
@@ -228,7 +227,7 @@ class LinkifyFilter(html5lib_shim.Filter):
         :arg re email_re: email matching regex
 
         """
-        super(LinkifyFilter, self).__init__(source)
+        super().__init__(source)
 
         self.callbacks = callbacks or []
         self.skip_tags = skip_tags or []
@@ -316,7 +315,6 @@ class LinkifyFilter(html5lib_shim.Filter):
                     else:
                         # Add an "a" tag for the new link
                         _text = attrs.pop("_text", "")
-                        attrs = alphabetize_attributes(attrs)
                         new_tokens.extend(
                             [
                                 {"type": "StartTag", "name": "a", "data": attrs},
@@ -332,8 +330,7 @@ class LinkifyFilter(html5lib_shim.Filter):
                     if end < len(text):
                         new_tokens.append({"type": "Characters", "data": text[end:]})
 
-                    for new_token in new_tokens:
-                        yield new_token
+                    yield from new_tokens
 
                     continue
 
@@ -439,8 +436,6 @@ class LinkifyFilter(html5lib_shim.Filter):
                             new_tokens.append({"type": "Characters", "data": prefix})
 
                         _text = attrs.pop("_text", "")
-                        attrs = alphabetize_attributes(attrs)
-
                         new_tokens.extend(
                             [
                                 {"type": "StartTag", "name": "a", "data": attrs},
@@ -460,8 +455,7 @@ class LinkifyFilter(html5lib_shim.Filter):
                     if end < len(text):
                         new_tokens.append({"type": "Characters", "data": text[end:]})
 
-                    for new_token in new_tokens:
-                        yield new_token
+                    yield from new_tokens
 
                     continue
 
@@ -493,14 +487,13 @@ class LinkifyFilter(html5lib_shim.Filter):
 
         else:
             new_text = attrs.pop("_text", "")
-            a_token["data"] = alphabetize_attributes(attrs)
+            a_token["data"] = attrs
 
             if text == new_text:
                 # The callbacks didn't change the text, so we yield the new "a"
                 # token, then whatever else was there, then the end "a" token
                 yield a_token
-                for mem in token_buffer[1:]:
-                    yield mem
+                yield from token_buffer[1:]
 
             else:
                 # If the callbacks changed the text, then we're going to drop
@@ -516,7 +509,7 @@ class LinkifyFilter(html5lib_shim.Filter):
 
         token_buffer = []
 
-        for token in super(LinkifyFilter, self).__iter__():
+        for token in super().__iter__():
             if in_a:
                 # Handle the case where we're in an "a" tag--we want to buffer tokens
                 # until we hit an end "a" tag.
@@ -524,8 +517,7 @@ class LinkifyFilter(html5lib_shim.Filter):
                     # Add the end tag to the token buffer and then handle them
                     # and yield anything returned
                     token_buffer.append(token)
-                    for new_token in self.handle_a_tag(token_buffer):
-                        yield new_token
+                    yield from self.handle_a_tag(token_buffer)
 
                     # Clear "a" related state and continue since we've yielded all
                     # the tokens we're going to yield
diff --git a/lib/bleach/sanitizer.py b/lib/bleach/sanitizer.py
index 89aff1f4..0816cfd0 100644
--- a/lib/bleach/sanitizer.py
+++ b/lib/bleach/sanitizer.py
@@ -6,7 +6,6 @@ from bleach._vendor.parse import urlparse
 from xml.sax.saxutils import unescape
 
 from bleach import html5lib_shim
-from bleach.utils import alphabetize_attributes
 
 
 #: List of allowed tags
@@ -33,9 +32,6 @@ ALLOWED_ATTRIBUTES = {
     "acronym": ["title"],
 }
 
-#: List of allowed styles
-ALLOWED_STYLES = []
-
 #: List of allowed protocols
 ALLOWED_PROTOCOLS = ["http", "https", "mailto"]
 
@@ -85,11 +81,11 @@ class Cleaner:
         self,
         tags=ALLOWED_TAGS,
         attributes=ALLOWED_ATTRIBUTES,
-        styles=ALLOWED_STYLES,
         protocols=ALLOWED_PROTOCOLS,
         strip=False,
         strip_comments=True,
         filters=None,
+        css_sanitizer=None,
     ):
         """Initializes a Cleaner
 
@@ -99,9 +95,6 @@ class Cleaner:
         :arg dict attributes: allowed attributes; can be a callable, list or dict;
             defaults to ``bleach.sanitizer.ALLOWED_ATTRIBUTES``
 
-        :arg list styles: allowed list of css styles; defaults to
-            ``bleach.sanitizer.ALLOWED_STYLES``
-
         :arg list protocols: allowed list of protocols for links; defaults
             to ``bleach.sanitizer.ALLOWED_PROTOCOLS``
 
@@ -118,14 +111,17 @@ class Cleaner:
                Using filters changes the output of ``bleach.Cleaner.clean``.
                Make sure the way the filters change the output are secure.
 
+        :arg CSSSanitizer css_sanitizer: instance with a "sanitize_css" method for
+            sanitizing style attribute values and style text; defaults to None
+
         """
         self.tags = tags
         self.attributes = attributes
-        self.styles = styles
         self.protocols = protocols
         self.strip = strip
         self.strip_comments = strip_comments
         self.filters = filters or []
+        self.css_sanitizer = css_sanitizer
 
         self.parser = html5lib_shim.BleachHTMLParser(
             tags=self.tags,
@@ -143,7 +139,7 @@ class Cleaner:
             resolve_entities=False,
             # Bleach has its own sanitizer, so don't use the html5lib one
             sanitize=False,
-            # Bleach sanitizer alphabetizes already, so don't use the html5lib one
+            # clean preserves attr order
             alphabetical_attributes=False,
         )
 
@@ -175,11 +171,10 @@ class Cleaner:
             attributes=self.attributes,
             strip_disallowed_elements=self.strip,
             strip_html_comments=self.strip_comments,
+            css_sanitizer=self.css_sanitizer,
             # html5lib-sanitizer things
             allowed_elements=self.tags,
-            allowed_css_properties=self.styles,
             allowed_protocols=self.protocols,
-            allowed_svg_properties=[],
         )
 
         # Apply any filters after the BleachSanitizerFilter
@@ -242,25 +237,25 @@ class BleachSanitizerFilter(html5lib_shim.SanitizerFilter):
     def __init__(
         self,
         source,
+        allowed_elements=ALLOWED_TAGS,
         attributes=ALLOWED_ATTRIBUTES,
+        allowed_protocols=ALLOWED_PROTOCOLS,
         strip_disallowed_elements=False,
         strip_html_comments=True,
+        css_sanitizer=None,
         **kwargs,
     ):
         """Creates a BleachSanitizerFilter instance
 
         :arg Treewalker source: stream
 
-        :arg list tags: allowed list of tags; defaults to
+        :arg list allowed_elements: allowed list of tags; defaults to
             ``bleach.sanitizer.ALLOWED_TAGS``
 
         :arg dict attributes: allowed attributes; can be a callable, list or dict;
             defaults to ``bleach.sanitizer.ALLOWED_ATTRIBUTES``
 
-        :arg list styles: allowed list of css styles; defaults to
-            ``bleach.sanitizer.ALLOWED_STYLES``
-
-        :arg list protocols: allowed list of protocols for links; defaults
+        :arg list allowed_protocols: allowed list of protocols for links; defaults
             to ``bleach.sanitizer.ALLOWED_PROTOCOLS``
 
         :arg bool strip_disallowed_elements: whether or not to strip disallowed
@@ -268,10 +263,14 @@ class BleachSanitizerFilter(html5lib_shim.SanitizerFilter):
 
         :arg bool strip_html_comments: whether or not to strip HTML comments
 
+        :arg CSSSanitizer css_sanitizer: instance with a "sanitize_css" method for
+            sanitizing style attribute values and style text; defaults to None
+
         """
         self.attr_filter = attribute_filter_factory(attributes)
         self.strip_disallowed_elements = strip_disallowed_elements
         self.strip_html_comments = strip_html_comments
+        self.css_sanitizer = css_sanitizer
 
         # filter out html5lib deprecation warnings to use bleach from BleachSanitizerFilter init
         warnings.filterwarnings(
@@ -280,7 +279,12 @@ class BleachSanitizerFilter(html5lib_shim.SanitizerFilter):
             category=DeprecationWarning,
             module="bleach._vendor.html5lib",
         )
-        return super(BleachSanitizerFilter, self).__init__(source, **kwargs)
+        return super().__init__(
+            source,
+            allowed_elements=allowed_elements,
+            allowed_protocols=allowed_protocols,
+            **kwargs,
+        )
 
     def sanitize_stream(self, token_iterator):
         for token in token_iterator:
@@ -290,8 +294,7 @@ class BleachSanitizerFilter(html5lib_shim.SanitizerFilter):
                 continue
 
             if isinstance(ret, list):
-                for subtoken in ret:
-                    yield subtoken
+                yield from ret
             else:
                 yield ret
 
@@ -358,10 +361,6 @@ class BleachSanitizerFilter(html5lib_shim.SanitizerFilter):
                 return None
 
             else:
-                if "data" in token:
-                    # Alphabetize the attributes before calling .disallowed_token()
-                    # so that the resulting string is stable
-                    token["data"] = alphabetize_attributes(token["data"])
                 return self.disallowed_token(token)
 
         elif token_type == "Comment":
@@ -547,12 +546,21 @@ class BleachSanitizerFilter(html5lib_shim.SanitizerFilter):
 
                 # If it's a style attribute, sanitize it
                 if namespaced_name == (None, "style"):
-                    val = self.sanitize_css(val)
+                    if self.css_sanitizer:
+                        val = self.css_sanitizer.sanitize_css(val)
+                    else:
+                        # FIXME(willkg): if style is allowed, but no
+                        # css_sanitizer was set up, then this is probably a
+                        # mistake and we should raise an error here
+                        #
+                        # For now, we're going to set the value to "" because
+                        # there was no sanitizer set
+                        val = ""
 
                 # At this point, we want to keep the attribute, so add it in
                 attrs[namespaced_name] = val
 
-            token["data"] = alphabetize_attributes(attrs)
+            token["data"] = attrs
 
         return token
 
@@ -575,7 +583,7 @@ class BleachSanitizerFilter(html5lib_shim.SanitizerFilter):
                 if ns is None or ns not in html5lib_shim.prefixes:
                     namespaced_name = name
                 else:
-                    namespaced_name = "%s:%s" % (html5lib_shim.prefixes[ns], name)
+                    namespaced_name = "{}:{}".format(html5lib_shim.prefixes[ns], name)
 
                 attrs.append(
                     ' %s="%s"'
@@ -587,7 +595,7 @@ class BleachSanitizerFilter(html5lib_shim.SanitizerFilter):
                         v,
                     )
                 )
-            token["data"] = "<%s%s>" % (token["name"], "".join(attrs))
+            token["data"] = "<{}{}>".format(token["name"], "".join(attrs))
 
         else:
             token["data"] = "<%s>" % token["name"]
@@ -599,47 +607,3 @@ class BleachSanitizerFilter(html5lib_shim.SanitizerFilter):
 
         del token["name"]
         return token
-
-    def sanitize_css(self, style):
-        """Sanitizes css in style tags"""
-        # Convert entities in the style so that it can be parsed as CSS
-        style = html5lib_shim.convert_entities(style)
-
-        # Drop any url values before we do anything else
-        style = re.compile(r"url\s*\(\s*[^\s)]+?\s*\)\s*").sub(" ", style)
-
-        # The gauntlet of sanitization
-
-        # Validate the css in the style tag and if it's not valid, then drop
-        # the whole thing.
-        parts = style.split(";")
-        gauntlet = re.compile(
-            r"""^(  # consider a style attribute value as composed of:
-[/:,#%!.\s\w]    # a non-newline character
-|\w-\w           # 3 characters in the form \w-\w
-|'[\s\w]+'\s*    # a single quoted string of [\s\w]+ with trailing space
-|"[\s\w]+"       # a double quoted string of [\s\w]+
-|\([\d,%\.\s]+\) # a parenthesized string of one or more digits, commas, periods, ...
-)*$""",  # ... percent signs, or whitespace e.g. from 'color: hsl(30,100%,50%)'
-            flags=re.U | re.VERBOSE,
-        )
-
-        for part in parts:
-            if not gauntlet.match(part):
-                return ""
-
-        if not re.match(r"^\s*([-\w]+\s*:[^:;]*(;\s*|$))*$", style):
-            return ""
-
-        clean = []
-        for prop, value in re.findall(r"([-\w]+)\s*:\s*([^:;]*)", style):
-            if not value:
-                continue
-
-            if prop.lower() in self.allowed_css_properties:
-                clean.append(prop + ": " + value + ";")
-
-            elif prop.lower() in self.allowed_svg_properties:
-                clean.append(prop + ": " + value + ";")
-
-        return " ".join(clean)
diff --git a/lib/bleach/utils.py b/lib/bleach/utils.py
deleted file mode 100644
index 6be59f6f..00000000
--- a/lib/bleach/utils.py
+++ /dev/null
@@ -1,21 +0,0 @@
-from collections import OrderedDict
-
-
-def _attr_key(attr):
-    """Returns appropriate key for sorting attribute names
-
-    Attribute names are a tuple of ``(namespace, name)`` where namespace can be
-    ``None`` or a string. These can't be compared in Python 3, so we conver the
-    ``None`` to an empty string.
-
-    """
-    key = (attr[0][0] or ""), attr[0][1]
-    return key
-
-
-def alphabetize_attributes(attrs):
-    """Takes a dict of attributes (or None) and returns them alphabetized"""
-    if not attrs:
-        return attrs
-
-    return OrderedDict([(k, v) for k, v in sorted(attrs.items(), key=_attr_key)])
diff --git a/requirements.txt b/requirements.txt
index b91e719f..5e22dccb 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -5,7 +5,7 @@ backports.csv==1.0.7
 backports.functools-lru-cache==1.6.4
 backports.zoneinfo==0.2.1
 beautifulsoup4==4.10.0
-bleach==4.1.0
+bleach==5.0.0
 certifi==2021.10.8
 cheroot==8.6.0
 cherrypy==18.6.1

From 467ae352f56dc80f72c225d66f455a324d5b5229 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 16 May 2022 20:46:21 -0700
Subject: [PATCH 081/743] Bump beautifulsoup4 from 4.10.0 to 4.11.1 (#1717)

* Bump beautifulsoup4 from 4.10.0 to 4.11.1

Bumps [beautifulsoup4](https://www.crummy.com/software/BeautifulSoup/bs4/) from 4.10.0 to 4.11.1.

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

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

* Update beautifulsoup4==4.11.1

* Update soupsieve==2.3.2.post1

* 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/bs4/__init__.py                       |  128 +-
 lib/bs4/builder/__init__.py               |  123 +-
 lib/bs4/builder/_html5lib.py              |   10 +-
 lib/bs4/builder/_htmlparser.py            |   11 +-
 lib/bs4/builder/_lxml.py                  |   56 +-
 lib/bs4/dammit.py                         | 2297 +--------------------
 lib/bs4/diagnose.py                       |   10 +-
 lib/bs4/element.py                        |  198 +-
 lib/bs4/formatter.py                      |   22 +-
 lib/bs4/{testing.py => tests/__init__.py} |  397 ++--
 lib/bs4/tests/test_builder.py             |   29 +
 lib/bs4/tests/test_builder_registry.py    |  136 ++
 lib/bs4/tests/test_dammit.py              |  371 ++++
 lib/bs4/tests/test_docs.py                |   38 +
 lib/bs4/tests/test_element.py             |   74 +
 lib/bs4/tests/test_formatter.py           |  113 +
 lib/bs4/tests/test_html5lib.py            |  223 ++
 lib/bs4/tests/test_htmlparser.py          |  136 ++
 lib/bs4/tests/test_lxml.py                |  199 ++
 lib/bs4/tests/test_navigablestring.py     |  144 ++
 lib/bs4/tests/test_pageelement.py         |  751 +++++++
 lib/bs4/tests/test_soup.py                |  462 +++++
 lib/bs4/tests/test_tag.py                 |  221 ++
 lib/bs4/tests/test_tree.py                | 1290 ++++++++++++
 lib/soupsieve/__meta__.py                 |    2 +-
 lib/soupsieve/css_match.py                |    2 +-
 lib/soupsieve/css_parser.py               |    8 +-
 requirements.txt                          |    4 +-
 28 files changed, 4846 insertions(+), 2609 deletions(-)
 rename lib/bs4/{testing.py => tests/__init__.py} (78%)
 create mode 100644 lib/bs4/tests/test_builder.py
 create mode 100644 lib/bs4/tests/test_builder_registry.py
 create mode 100644 lib/bs4/tests/test_dammit.py
 create mode 100644 lib/bs4/tests/test_docs.py
 create mode 100644 lib/bs4/tests/test_element.py
 create mode 100644 lib/bs4/tests/test_formatter.py
 create mode 100644 lib/bs4/tests/test_html5lib.py
 create mode 100644 lib/bs4/tests/test_htmlparser.py
 create mode 100644 lib/bs4/tests/test_lxml.py
 create mode 100644 lib/bs4/tests/test_navigablestring.py
 create mode 100644 lib/bs4/tests/test_pageelement.py
 create mode 100644 lib/bs4/tests/test_soup.py
 create mode 100644 lib/bs4/tests/test_tag.py
 create mode 100644 lib/bs4/tests/test_tree.py

diff --git a/lib/bs4/__init__.py b/lib/bs4/__init__.py
index 2a436d34..b3c9feb8 100644
--- a/lib/bs4/__init__.py
+++ b/lib/bs4/__init__.py
@@ -15,14 +15,13 @@ documentation: http://www.crummy.com/software/BeautifulSoup/bs4/doc/
 """
 
 __author__ = "Leonard Richardson (leonardr@segfault.org)"
-__version__ = "4.10.0"
-__copyright__ = "Copyright (c) 2004-2021 Leonard Richardson"
+__version__ = "4.11.1"
+__copyright__ = "Copyright (c) 2004-2022 Leonard Richardson"
 # Use of this source code is governed by the MIT license.
 __license__ = "MIT"
 
 __all__ = ['BeautifulSoup']
 
-
 from collections import Counter
 import os
 import re
@@ -35,7 +34,11 @@ import warnings
 if sys.version_info.major < 3:
     raise ImportError('You are trying to use a Python 3-specific version of Beautiful Soup under Python 2. This will not work. The final version of Beautiful Soup to support Python 2 was 4.9.3.')
 
-from .builder import builder_registry, ParserRejectedMarkup
+from .builder import (
+    builder_registry,
+    ParserRejectedMarkup,
+    XMLParsedAsHTMLWarning,
+)
 from .dammit import UnicodeDammit
 from .element import (
     CData,
@@ -67,7 +70,7 @@ class MarkupResemblesLocatorWarning(UserWarning):
     on disk.
     """
 
-
+   
 class BeautifulSoup(Tag):
     """A data structure representing a parsed HTML or XML document.
 
@@ -207,10 +210,10 @@ class BeautifulSoup(Tag):
             if old_name in kwargs:
                 warnings.warn(
                     'The "%s" argument to the BeautifulSoup constructor '
-                    'has been renamed to "%s."' % (old_name, new_name))
-                value = kwargs[old_name]
-                del kwargs[old_name]
-                return value
+                    'has been renamed to "%s."' % (old_name, new_name),
+                    DeprecationWarning
+                )
+                return kwargs.pop(old_name)
             return None
 
         parse_only = parse_only or deprecated_argument(
@@ -305,51 +308,18 @@ class BeautifulSoup(Tag):
         self._namespaces = dict()
         self.parse_only = parse_only
 
-        self.builder.initialize_soup(self)
-
         if hasattr(markup, 'read'):        # It's a file-type object.
             markup = markup.read()
         elif len(markup) <= 256 and (
                 (isinstance(markup, bytes) and not b'<' in markup)
                 or (isinstance(markup, str) and not '<' in markup)
         ):
-            # Print out warnings for a couple beginner problems
+            # Issue warnings for a couple beginner problems
             # involving passing non-markup to Beautiful Soup.
             # Beautiful Soup will still parse the input as markup,
-            # just in case that's what the user really wants.
-            if (isinstance(markup, str)
-                and not os.path.supports_unicode_filenames):
-                possible_filename = markup.encode("utf8")
-            else:
-                possible_filename = markup
-            is_file = False
-            is_directory = False
-            try:
-                is_file = os.path.exists(possible_filename)
-                if is_file:
-                    is_directory = os.path.isdir(possible_filename)
-            except Exception as e:
-                # This is almost certainly a problem involving
-                # characters not valid in filenames on this
-                # system. Just let it go.
-                pass
-            if is_directory:
-                warnings.warn(
-                    '"%s" looks like a directory name, not markup. You may'
-                    ' want to open a file found in this directory and pass'
-                    ' the filehandle into Beautiful Soup.' % (
-                        self._decode_markup(markup)
-                    ),
-                    MarkupResemblesLocatorWarning
-                )
-            elif is_file:
-                warnings.warn(
-                    '"%s" looks like a filename, not markup. You should'
-                    ' probably open this file and pass the filehandle into'
-                    ' Beautiful Soup.' % self._decode_markup(markup),
-                    MarkupResemblesLocatorWarning
-                )
-            self._check_markup_is_url(markup)
+            # since that is sometimes the intended behavior.
+            if not self._markup_is_url(markup):
+                self._markup_resembles_filename(markup)                
 
         rejections = []
         success = False
@@ -358,6 +328,7 @@ class BeautifulSoup(Tag):
              self.builder.prepare_markup(
                  markup, from_encoding, exclude_encodings=exclude_encodings)):
             self.reset()
+            self.builder.initialize_soup(self)
             try:
                 self._feed()
                 success = True
@@ -393,10 +364,10 @@ class BeautifulSoup(Tag):
     def __getstate__(self):
         # Frequently a tree builder can't be pickled.
         d = dict(self.__dict__)
-        if 'builder' in d and not self.builder.picklable:
+        if 'builder' in d and d['builder'] is not None and not self.builder.picklable:
             d['builder'] = None
         return d
-
+    
     @classmethod
     def _decode_markup(cls, markup):
         """Ensure `markup` is bytes so it's safe to send into warnings.warn.
@@ -411,11 +382,13 @@ class BeautifulSoup(Tag):
         return decoded
 
     @classmethod
-    def _check_markup_is_url(cls, markup):
+    def _markup_is_url(cls, markup):
         """Error-handling method to raise a warning if incoming markup looks
         like a URL.
 
         :param markup: A string.
+        :return: Whether or not the markup resembles a URL
+            closely enough to justify a warning.
         """
         if isinstance(markup, bytes):
             space = b' '
@@ -424,20 +397,50 @@ class BeautifulSoup(Tag):
             space = ' '
             cant_start_with = ("http:", "https:")
         else:
-            return
+            return False
 
         if any(markup.startswith(prefix) for prefix in cant_start_with):
             if not space in markup:
                 warnings.warn(
-                    '"%s" looks like a URL. Beautiful Soup is not an'
-                    ' HTTP client. You should probably use an HTTP client like'
-                    ' requests to get the document behind the URL, and feed'
-                    ' that document to Beautiful Soup.' % cls._decode_markup(
-                        markup
-                    ),
+                    'The input looks more like a URL than markup. You may want to use'
+                    ' an HTTP client like requests to get the document behind'
+                    ' the URL, and feed that document to Beautiful Soup.',
                     MarkupResemblesLocatorWarning
                 )
+                return True
+        return False
 
+    @classmethod
+    def _markup_resembles_filename(cls, markup):
+        """Error-handling method to raise a warning if incoming markup
+        resembles a filename.
+
+        :param markup: A bytestring or string.
+        :return: Whether or not the markup resembles a filename
+            closely enough to justify a warning.
+        """
+        path_characters = '/\\'
+        extensions = ['.html', '.htm', '.xml', '.xhtml', '.txt']
+        if isinstance(markup, bytes):
+            path_characters = path_characters.encode("utf8")
+            extensions = [x.encode('utf8') for x in extensions]
+        filelike = False
+        if any(x in markup for x in path_characters):
+            filelike = True
+        else:
+            lower = markup.lower()
+            if any(lower.endswith(ext) for ext in extensions):
+                filelike = True
+        if filelike:
+            warnings.warn(
+                'The input looks more like a filename than markup. You may'
+                ' want to open this file and pass the filehandle into'
+                ' Beautiful Soup.',
+                MarkupResemblesLocatorWarning
+            )
+            return True
+        return False
+    
     def _feed(self):
         """Internal method that parses previously set markup, creating a large
         number of Tag and NavigableString objects.
@@ -689,7 +692,7 @@ class BeautifulSoup(Tag):
         return most_recently_popped
 
     def handle_starttag(self, name, namespace, nsprefix, attrs, sourceline=None,
-                        sourcepos=None):
+                        sourcepos=None, namespaces=None):
         """Called by the tree builder when a new tag is encountered.
 
         :param name: Name of the tag.
@@ -699,6 +702,8 @@ class BeautifulSoup(Tag):
             source document.
         :param sourcepos: The character position within `sourceline` where this
             tag was found.
+        :param namespaces: A dictionary of all namespace prefix mappings 
+            currently in scope in the document.
 
         If this method returns None, the tag was rejected by an active
         SoupStrainer. You should proceed as if the tag had not occurred
@@ -716,7 +721,8 @@ class BeautifulSoup(Tag):
         tag = self.element_classes.get(Tag, Tag)(
             self, self.builder, name, namespace, nsprefix, attrs,
             self.currentTag, self._most_recent_element,
-            sourceline=sourceline, sourcepos=sourcepos
+            sourceline=sourceline, sourcepos=sourcepos,
+            namespaces=namespaces
         )
         if tag is None:
             return tag
@@ -735,7 +741,7 @@ class BeautifulSoup(Tag):
         #print("End tag: " + name)
         self.endData()
         self._popToTag(name, nsprefix)
-
+        
     def handle_data(self, data):
         """Called by the tree builder when a chunk of textual data is encountered."""
         self.current_data.append(data)
@@ -782,7 +788,9 @@ class BeautifulStoneSoup(BeautifulSoup):
         kwargs['features'] = 'xml'
         warnings.warn(
             'The BeautifulStoneSoup class is deprecated. Instead of using '
-            'it, pass features="xml" into the BeautifulSoup constructor.')
+            'it, pass features="xml" into the BeautifulSoup constructor.',
+            DeprecationWarning
+        )
         super(BeautifulStoneSoup, self).__init__(*args, **kwargs)
 
 
diff --git a/lib/bs4/builder/__init__.py b/lib/bs4/builder/__init__.py
index bd44905e..9f789f3e 100644
--- a/lib/bs4/builder/__init__.py
+++ b/lib/bs4/builder/__init__.py
@@ -3,10 +3,14 @@ __license__ = "MIT"
 
 from collections import defaultdict
 import itertools
+import re
+import warnings
 import sys
 from bs4.element import (
     CharsetMetaAttributeValue,
     ContentMetaAttributeValue,
+    RubyParenthesisString,
+    RubyTextString,
     Stylesheet,
     Script,
     TemplateString,
@@ -28,6 +32,12 @@ XML = 'xml'
 HTML = 'html'
 HTML_5 = 'html5'
 
+class XMLParsedAsHTMLWarning(UserWarning):
+    """The warning issued when an HTML parser is used to parse
+    XML that is not XHTML.
+    """
+    MESSAGE = """It looks like you're parsing an XML document using an HTML parser. If this really is an HTML document (maybe it's XHTML?), you can ignore or filter this warning. If it's XML, you should know that using an XML parser will be more reliable. To parse this document as XML, make sure you have the lxml package installed, and pass the keyword argument `features="xml"` into the BeautifulSoup constructor."""
+
 
 class TreeBuilderRegistry(object):
     """A way of looking up TreeBuilder subclasses by their name or by desired
@@ -319,7 +329,7 @@ class TreeBuilder(object):
                         values = value
                     attrs[attr] = values
         return attrs
-
+    
 class SAXTreeBuilder(TreeBuilder):
     """A Beautiful Soup treebuilder that listens for SAX events.
 
@@ -390,17 +400,25 @@ class HTMLTreeBuilder(TreeBuilder):
     # you need to use it.
     block_elements = set(["address", "article", "aside", "blockquote", "canvas", "dd", "div", "dl", "dt", "fieldset", "figcaption", "figure", "footer", "form", "h1", "h2", "h3", "h4", "h5", "h6", "header", "hr", "li", "main", "nav", "noscript", "ol", "output", "p", "pre", "section", "table", "tfoot", "ul", "video"])
 
-    # The HTML standard defines an unusual content model for these tags.
-    # We represent this by using a string class other than NavigableString
-    # inside these tags.
+    # These HTML tags need special treatment so they can be
+    # represented by a string class other than NavigableString.
     #
-    # I made this list by going through the HTML spec
+    # For some of these tags, it's because the HTML standard defines
+    # an unusual content model for them. I made this list by going
+    # through the HTML spec
     # (https://html.spec.whatwg.org/#metadata-content) and looking for
     # "metadata content" elements that can contain strings.
     #
+    # The Ruby tags (<rt> and <rp>) are here despite being normal
+    # "phrasing content" tags, because the content they contain is
+    # qualitatively different from other text in the document, and it
+    # can be useful to be able to distinguish it.
+    #
     # TODO: Arguably <noscript> could go here but it seems
     # qualitatively different from the other tags.
     DEFAULT_STRING_CONTAINERS = {
+        'rt' : RubyTextString,
+        'rp' : RubyParenthesisString,
         'style': Stylesheet,
         'script': Script,
         'template': TemplateString,
@@ -431,7 +449,7 @@ class HTMLTreeBuilder(TreeBuilder):
         }
 
     DEFAULT_PRESERVE_WHITESPACE_TAGS = set(['pre', 'textarea'])
-    
+
     def set_up_substitutions(self, tag):
         """Replace the declared encoding in a <meta> tag with a placeholder,
         to be substituted when the tag is output to a string.
@@ -475,6 +493,99 @@ class HTMLTreeBuilder(TreeBuilder):
 
         return (meta_encoding is not None)
 
+class DetectsXMLParsedAsHTML(object):
+    """A mixin class for any class (a TreeBuilder, or some class used by a
+    TreeBuilder) that's in a position to detect whether an XML
+    document is being incorrectly parsed as HTML, and issue an
+    appropriate warning.
+
+    This requires being able to observe an incoming processing
+    instruction that might be an XML declaration, and also able to
+    observe tags as they're opened. If you can't do that for a given
+    TreeBuilder, there's a less reliable implementation based on
+    examining the raw markup.
+    """
+
+    # Regular expression for seeing if markup has an <html> tag.
+    LOOKS_LIKE_HTML = re.compile("<[^ +]html", re.I)
+    LOOKS_LIKE_HTML_B = re.compile(b"<[^ +]html", re.I)
+
+    XML_PREFIX = '<?xml'
+    XML_PREFIX_B = b'<?xml'
+    
+    @classmethod
+    def warn_if_markup_looks_like_xml(cls, markup):
+        """Perform a check on some markup to see if it looks like XML
+        that's not XHTML. If so, issue a warning.
+
+        This is much less reliable than doing the check while parsing,
+        but some of the tree builders can't do that.
+
+        :return: True if the markup looks like non-XHTML XML, False
+        otherwise.
+        """
+        if isinstance(markup, bytes):
+            prefix = cls.XML_PREFIX_B
+            looks_like_html = cls.LOOKS_LIKE_HTML_B
+        else:
+            prefix = cls.XML_PREFIX
+            looks_like_html = cls.LOOKS_LIKE_HTML
+        
+        if (markup is not None
+            and markup.startswith(prefix)
+            and not looks_like_html.search(markup[:500])
+        ):
+            cls._warn()
+            return True
+        return False
+
+    @classmethod
+    def _warn(cls):
+        """Issue a warning about XML being parsed as HTML."""
+        warnings.warn(
+            XMLParsedAsHTMLWarning.MESSAGE, XMLParsedAsHTMLWarning
+        )
+        
+    def _initialize_xml_detector(self):
+        """Call this method before parsing a document."""
+        self._first_processing_instruction = None
+        self._root_tag = None
+       
+    def _document_might_be_xml(self, processing_instruction):
+        """Call this method when encountering an XML declaration, or a
+        "processing instruction" that might be an XML declaration.
+        """
+        if (self._first_processing_instruction is not None
+            or self._root_tag is not None):
+            # The document has already started. Don't bother checking
+            # anymore.
+            return
+
+        self._first_processing_instruction = processing_instruction
+
+        # We won't know until we encounter the first tag whether or
+        # not this is actually a problem.
+        
+    def _root_tag_encountered(self, name):
+        """Call this when you encounter the document's root tag.
+
+        This is where we actually check whether an XML document is
+        being incorrectly parsed as HTML, and issue the warning.
+        """
+        if self._root_tag is not None:
+            # This method was incorrectly called multiple times. Do
+            # nothing.
+            return
+
+        self._root_tag = name
+        if (name != 'html' and self._first_processing_instruction is not None
+            and self._first_processing_instruction.lower().startswith('xml ')):
+            # We encountered an XML declaration and then a tag other
+            # than 'html'. This is a reliable indicator that a
+            # non-XHTML document is being parsed as XML.
+            self._warn()
+
+    
 def register_treebuilders_from(module):
     """Copy TreeBuilders from the given module into this module."""
     this_module = sys.modules[__name__]
diff --git a/lib/bs4/builder/_html5lib.py b/lib/bs4/builder/_html5lib.py
index 69aefd72..58bc176e 100644
--- a/lib/bs4/builder/_html5lib.py
+++ b/lib/bs4/builder/_html5lib.py
@@ -8,6 +8,7 @@ __all__ = [
 import warnings
 import re
 from bs4.builder import (
+    DetectsXMLParsedAsHTML,
     PERMISSIVE,
     HTML,
     HTML_5,
@@ -70,6 +71,11 @@ class HTML5TreeBuilder(HTMLTreeBuilder):
         # UnicodeDammit.
         if exclude_encodings:
             warnings.warn("You provided a value for exclude_encoding, but the html5lib tree builder doesn't support exclude_encoding.")
+
+        # html5lib only parses HTML, so if it's given XML that's worth
+        # noting.
+        DetectsXMLParsedAsHTML.warn_if_markup_looks_like_xml(markup)
+
         yield (markup, None, None, False)
 
     # These methods are defined by Beautiful Soup.
@@ -242,8 +248,8 @@ class AttrList(object):
     def __setitem__(self, name, value):
         # If this attribute is a multi-valued attribute for this element,
         # turn its value into a list.
-        list_attr = self.element.cdata_list_attributes
-        if (name in list_attr['*']
+        list_attr = self.element.cdata_list_attributes or {}
+        if (name in list_attr.get('*')
             or (self.element.name in list_attr
                 and name in list_attr[self.element.name])):
             # A node that is being cloned may have already undergone
diff --git a/lib/bs4/builder/_htmlparser.py b/lib/bs4/builder/_htmlparser.py
index 70e9be84..fae4d0f2 100644
--- a/lib/bs4/builder/_htmlparser.py
+++ b/lib/bs4/builder/_htmlparser.py
@@ -44,6 +44,7 @@ from bs4.element import (
 from bs4.dammit import EntitySubstitution, UnicodeDammit
 
 from bs4.builder import (
+    DetectsXMLParsedAsHTML,
     HTML,
     HTMLTreeBuilder,
     STRICT,
@@ -52,7 +53,7 @@ from bs4.builder import (
 
 HTMLPARSER = 'html.parser'
 
-class BeautifulSoupHTMLParser(HTMLParser):
+class BeautifulSoupHTMLParser(HTMLParser, DetectsXMLParsedAsHTML):
     """A subclass of the Python standard library's HTMLParser class, which
     listens for HTMLParser events and translates them into calls
     to Beautiful Soup's tree construction API.
@@ -88,6 +89,8 @@ class BeautifulSoupHTMLParser(HTMLParser):
         # will ignore, assuming they ever show up.
         self.already_closed_empty_element = []
 
+        self._initialize_xml_detector()
+        
     def error(self, msg):
         """In Python 3, HTMLParser subclasses must implement error(), although
         this requirement doesn't appear to be documented.
@@ -167,6 +170,9 @@ class BeautifulSoupHTMLParser(HTMLParser):
             # But we might encounter an explicit closing tag for this tag
             # later on. If so, we want to ignore it.
             self.already_closed_empty_element.append(name)
+
+        if self._root_tag is None:
+            self._root_tag_encountered(name)
             
     def handle_endtag(self, name, check_already_closed=True):
         """Handle a closing tag, e.g. '</tag>'
@@ -185,7 +191,7 @@ class BeautifulSoupHTMLParser(HTMLParser):
             self.already_closed_empty_element.remove(name)
         else:
             self.soup.handle_endtag(name)
-
+            
     def handle_data(self, data):
         """Handle some textual data that shows up between tags."""
         self.soup.handle_data(data)
@@ -288,6 +294,7 @@ class BeautifulSoupHTMLParser(HTMLParser):
         """
         self.soup.endData()
         self.soup.handle_data(data)
+        self._document_might_be_xml(data)
         self.soup.endData(ProcessingInstruction)
 
 
diff --git a/lib/bs4/builder/_lxml.py b/lib/bs4/builder/_lxml.py
index 11c9a696..971c81e5 100644
--- a/lib/bs4/builder/_lxml.py
+++ b/lib/bs4/builder/_lxml.py
@@ -22,6 +22,7 @@ from bs4.element import (
     XMLProcessingInstruction,
 )
 from bs4.builder import (
+    DetectsXMLParsedAsHTML,
     FAST,
     HTML,
     HTMLTreeBuilder,
@@ -79,15 +80,24 @@ class LXMLTreeBuilderForXML(TreeBuilder):
 
         This might be useful later on when creating CSS selectors.
 
+        This will track (almost) all namespaces, even ones that were
+        only in scope for part of the document. If two namespaces have
+        the same prefix, only the first one encountered will be
+        tracked. Un-prefixed namespaces are not tracked.
+
         :param mapping: A dictionary mapping namespace prefixes to URIs.
         """
         for key, value in list(mapping.items()):
+            # This is 'if key' and not 'if key is not None' because we
+            # don't track un-prefixed namespaces. Soupselect will
+            # treat an un-prefixed namespace as the default, which
+            # causes confusion in some cases.
             if key and key not in self.soup._namespaces:
                 # Let the BeautifulSoup object know about a new namespace.
                 # If there are multiple namespaces defined with the same
                 # prefix, the first one in the document takes precedence.
                 self.soup._namespaces[key] = value
-
+                
     def default_parser(self, encoding):
         """Find the default parser for the given encoding.
 
@@ -125,6 +135,7 @@ class LXMLTreeBuilderForXML(TreeBuilder):
             self.empty_element_tags = set(empty_element_tags)
         self.soup = None
         self.nsmaps = [self.DEFAULT_NSMAPS_INVERTED]
+        self.active_namespace_prefixes = [dict(self.DEFAULT_NSMAPS)]
         super(LXMLTreeBuilderForXML, self).__init__(**kwargs)
         
     def _getNsTag(self, tag):
@@ -166,12 +177,21 @@ class LXMLTreeBuilderForXML(TreeBuilder):
         is_html = not self.is_xml
         if is_html:
             self.processing_instruction_class = ProcessingInstruction
+            # We're in HTML mode, so if we're given XML, that's worth
+            # noting.
+            DetectsXMLParsedAsHTML.warn_if_markup_looks_like_xml(markup)
         else:
             self.processing_instruction_class = XMLProcessingInstruction
 
         if isinstance(markup, str):
             # We were given Unicode. Maybe lxml can parse Unicode on
             # this system?
+
+            # TODO: This is a workaround for
+            # https://bugs.launchpad.net/lxml/+bug/1948551.
+            # We can remove it once the upstream issue is fixed.
+            if len(markup) > 0 and markup[0] == u'\N{BYTE ORDER MARK}':
+                markup = markup[1:]
             yield markup, None, document_declared_encoding, False
 
         if isinstance(markup, str):
@@ -240,6 +260,20 @@ class LXMLTreeBuilderForXML(TreeBuilder):
             # mappings.
             self.nsmaps.append(_invert(nsmap))
 
+            # The currently active namespace prefixes have
+            # changed. Calculate the new mapping so it can be stored
+            # with all Tag objects created while these prefixes are in
+            # scope.
+            current_mapping = dict(self.active_namespace_prefixes[-1])
+            current_mapping.update(nsmap)
+
+            # We should not track un-prefixed namespaces as we can only hold one
+            # and it will be recognized as the default namespace by soupsieve,
+            # which may be confusing in some situations.
+            if '' in current_mapping:
+                del current_mapping['']
+            self.active_namespace_prefixes.append(current_mapping)
+            
             # Also treat the namespace mapping as a set of attributes on the
             # tag, so we can recreate it later.
             attrs = attrs.copy()
@@ -264,8 +298,11 @@ class LXMLTreeBuilderForXML(TreeBuilder):
 
         namespace, name = self._getNsTag(name)
         nsprefix = self._prefix_for_namespace(namespace)
-        self.soup.handle_starttag(name, namespace, nsprefix, attrs)
-
+        self.soup.handle_starttag(
+            name, namespace, nsprefix, attrs,
+            namespaces=self.active_namespace_prefixes[-1]
+        )
+        
     def _prefix_for_namespace(self, namespace):
         """Find the currently active prefix for the given namespace."""
         if namespace is None:
@@ -289,13 +326,20 @@ class LXMLTreeBuilderForXML(TreeBuilder):
         if len(self.nsmaps) > 1:
             # This tag, or one of its parents, introduced a namespace
             # mapping, so pop it off the stack.
-            self.nsmaps.pop()
+            out_of_scope_nsmap = self.nsmaps.pop()
 
+            if out_of_scope_nsmap is not None:
+                # This tag introduced a namespace mapping which is no
+                # longer in scope. Recalculate the currently active
+                # namespace prefixes.
+                self.active_namespace_prefixes.pop()
+            
     def pi(self, target, data):
         self.soup.endData()
-        self.soup.handle_data(target + ' ' + data)
+        data = target + ' ' + data
+        self.soup.handle_data(data)
         self.soup.endData(self.processing_instruction_class)
-
+        
     def data(self, content):
         self.soup.handle_data(content)
 
diff --git a/lib/bs4/dammit.py b/lib/bs4/dammit.py
index e017408b..692433c5 100644
--- a/lib/bs4/dammit.py
+++ b/lib/bs4/dammit.py
@@ -16,41 +16,37 @@ import re
 import logging
 import string
 
-# Import a library to autodetect character encodings.
-chardet_type = None
+# Import a library to autodetect character encodings. We'll support
+# any of a number of libraries that all support the same API:
+#
+# * cchardet
+# * chardet
+# * charset-normalizer
+chardet_module = None
 try:
-    # First try the fast C implementation.
     #  PyPI package: cchardet
-    import cchardet
+    import cchardet as chardet_module
+except ImportError:
+    try:
+        #  Debian package: python-chardet
+        #  PyPI package: chardet
+        import chardet as chardet_module
+    except ImportError:
+        try:
+            # PyPI package: charset-normalizer
+            import charset_normalizer as chardet_module
+        except ImportError:
+            # No chardet available.
+            chardet_module = None
+
+if chardet_module:
     def chardet_dammit(s):
         if isinstance(s, str):
             return None
-        return cchardet.detect(s)['encoding']
-except ImportError:
-    try:
-        # Fall back to the pure Python implementation
-        #  Debian package: python-chardet
-        #  PyPI package: chardet
-        import chardet
-        def chardet_dammit(s):
-            if isinstance(s, str):
-                return None
-            return chardet.detect(s)['encoding']
-        #import chardet.constants
-        #chardet.constants._debug = 1
-    except ImportError:
-        # No chardet available.
-        def chardet_dammit(s):
-            return None
-
-# Available from http://cjkpython.i18n.org/.
-#
-# TODO: This doesn't work anymore and the closest thing, iconv_codecs,
-# is GPL-licensed. Check whether this is still necessary.
-try:
-    import iconv_codec
-except ImportError:
-    pass
+        return chardet_module.detect(s)['encoding']
+else:
+    def chardet_dammit(s):
+        return None
 
 # Build bytestring and Unicode versions of regular expressions for finding
 # a declared encoding inside an XML or HTML document.
@@ -66,2246 +62,7 @@ encoding_res[str] = {
     'xml' : re.compile(xml_encoding, re.I)
 }
 
-try:
-    from html.entities import html5
-except ImportError:
-    # This is a copy of html.entities.html5 from Python 3.9. There's
-    # no equivalent table in Python 2, so we'll just provide a copy
-    # here.
-    html5 = {
-    'Aacute': '\xc1',
-    'aacute': '\xe1',
-    'Aacute;': '\xc1',
-    'aacute;': '\xe1',
-    'Abreve;': '\u0102',
-    'abreve;': '\u0103',
-    'ac;': '\u223e',
-    'acd;': '\u223f',
-    'acE;': '\u223e\u0333',
-    'Acirc': '\xc2',
-    'acirc': '\xe2',
-    'Acirc;': '\xc2',
-    'acirc;': '\xe2',
-    'acute': '\xb4',
-    'acute;': '\xb4',
-    'Acy;': '\u0410',
-    'acy;': '\u0430',
-    'AElig': '\xc6',
-    'aelig': '\xe6',
-    'AElig;': '\xc6',
-    'aelig;': '\xe6',
-    'af;': '\u2061',
-    'Afr;': '\U0001d504',
-    'afr;': '\U0001d51e',
-    'Agrave': '\xc0',
-    'agrave': '\xe0',
-    'Agrave;': '\xc0',
-    'agrave;': '\xe0',
-    'alefsym;': '\u2135',
-    'aleph;': '\u2135',
-    'Alpha;': '\u0391',
-    'alpha;': '\u03b1',
-    'Amacr;': '\u0100',
-    'amacr;': '\u0101',
-    'amalg;': '\u2a3f',
-    'AMP': '&',
-    'amp': '&',
-    'AMP;': '&',
-    'amp;': '&',
-    'And;': '\u2a53',
-    'and;': '\u2227',
-    'andand;': '\u2a55',
-    'andd;': '\u2a5c',
-    'andslope;': '\u2a58',
-    'andv;': '\u2a5a',
-    'ang;': '\u2220',
-    'ange;': '\u29a4',
-    'angle;': '\u2220',
-    'angmsd;': '\u2221',
-    'angmsdaa;': '\u29a8',
-    'angmsdab;': '\u29a9',
-    'angmsdac;': '\u29aa',
-    'angmsdad;': '\u29ab',
-    'angmsdae;': '\u29ac',
-    'angmsdaf;': '\u29ad',
-    'angmsdag;': '\u29ae',
-    'angmsdah;': '\u29af',
-    'angrt;': '\u221f',
-    'angrtvb;': '\u22be',
-    'angrtvbd;': '\u299d',
-    'angsph;': '\u2222',
-    'angst;': '\xc5',
-    'angzarr;': '\u237c',
-    'Aogon;': '\u0104',
-    'aogon;': '\u0105',
-    'Aopf;': '\U0001d538',
-    'aopf;': '\U0001d552',
-    'ap;': '\u2248',
-    'apacir;': '\u2a6f',
-    'apE;': '\u2a70',
-    'ape;': '\u224a',
-    'apid;': '\u224b',
-    'apos;': "'",
-    'ApplyFunction;': '\u2061',
-    'approx;': '\u2248',
-    'approxeq;': '\u224a',
-    'Aring': '\xc5',
-    'aring': '\xe5',
-    'Aring;': '\xc5',
-    'aring;': '\xe5',
-    'Ascr;': '\U0001d49c',
-    'ascr;': '\U0001d4b6',
-    'Assign;': '\u2254',
-    'ast;': '*',
-    'asymp;': '\u2248',
-    'asympeq;': '\u224d',
-    'Atilde': '\xc3',
-    'atilde': '\xe3',
-    'Atilde;': '\xc3',
-    'atilde;': '\xe3',
-    'Auml': '\xc4',
-    'auml': '\xe4',
-    'Auml;': '\xc4',
-    'auml;': '\xe4',
-    'awconint;': '\u2233',
-    'awint;': '\u2a11',
-    'backcong;': '\u224c',
-    'backepsilon;': '\u03f6',
-    'backprime;': '\u2035',
-    'backsim;': '\u223d',
-    'backsimeq;': '\u22cd',
-    'Backslash;': '\u2216',
-    'Barv;': '\u2ae7',
-    'barvee;': '\u22bd',
-    'Barwed;': '\u2306',
-    'barwed;': '\u2305',
-    'barwedge;': '\u2305',
-    'bbrk;': '\u23b5',
-    'bbrktbrk;': '\u23b6',
-    'bcong;': '\u224c',
-    'Bcy;': '\u0411',
-    'bcy;': '\u0431',
-    'bdquo;': '\u201e',
-    'becaus;': '\u2235',
-    'Because;': '\u2235',
-    'because;': '\u2235',
-    'bemptyv;': '\u29b0',
-    'bepsi;': '\u03f6',
-    'bernou;': '\u212c',
-    'Bernoullis;': '\u212c',
-    'Beta;': '\u0392',
-    'beta;': '\u03b2',
-    'beth;': '\u2136',
-    'between;': '\u226c',
-    'Bfr;': '\U0001d505',
-    'bfr;': '\U0001d51f',
-    'bigcap;': '\u22c2',
-    'bigcirc;': '\u25ef',
-    'bigcup;': '\u22c3',
-    'bigodot;': '\u2a00',
-    'bigoplus;': '\u2a01',
-    'bigotimes;': '\u2a02',
-    'bigsqcup;': '\u2a06',
-    'bigstar;': '\u2605',
-    'bigtriangledown;': '\u25bd',
-    'bigtriangleup;': '\u25b3',
-    'biguplus;': '\u2a04',
-    'bigvee;': '\u22c1',
-    'bigwedge;': '\u22c0',
-    'bkarow;': '\u290d',
-    'blacklozenge;': '\u29eb',
-    'blacksquare;': '\u25aa',
-    'blacktriangle;': '\u25b4',
-    'blacktriangledown;': '\u25be',
-    'blacktriangleleft;': '\u25c2',
-    'blacktriangleright;': '\u25b8',
-    'blank;': '\u2423',
-    'blk12;': '\u2592',
-    'blk14;': '\u2591',
-    'blk34;': '\u2593',
-    'block;': '\u2588',
-    'bne;': '=\u20e5',
-    'bnequiv;': '\u2261\u20e5',
-    'bNot;': '\u2aed',
-    'bnot;': '\u2310',
-    'Bopf;': '\U0001d539',
-    'bopf;': '\U0001d553',
-    'bot;': '\u22a5',
-    'bottom;': '\u22a5',
-    'bowtie;': '\u22c8',
-    'boxbox;': '\u29c9',
-    'boxDL;': '\u2557',
-    'boxDl;': '\u2556',
-    'boxdL;': '\u2555',
-    'boxdl;': '\u2510',
-    'boxDR;': '\u2554',
-    'boxDr;': '\u2553',
-    'boxdR;': '\u2552',
-    'boxdr;': '\u250c',
-    'boxH;': '\u2550',
-    'boxh;': '\u2500',
-    'boxHD;': '\u2566',
-    'boxHd;': '\u2564',
-    'boxhD;': '\u2565',
-    'boxhd;': '\u252c',
-    'boxHU;': '\u2569',
-    'boxHu;': '\u2567',
-    'boxhU;': '\u2568',
-    'boxhu;': '\u2534',
-    'boxminus;': '\u229f',
-    'boxplus;': '\u229e',
-    'boxtimes;': '\u22a0',
-    'boxUL;': '\u255d',
-    'boxUl;': '\u255c',
-    'boxuL;': '\u255b',
-    'boxul;': '\u2518',
-    'boxUR;': '\u255a',
-    'boxUr;': '\u2559',
-    'boxuR;': '\u2558',
-    'boxur;': '\u2514',
-    'boxV;': '\u2551',
-    'boxv;': '\u2502',
-    'boxVH;': '\u256c',
-    'boxVh;': '\u256b',
-    'boxvH;': '\u256a',
-    'boxvh;': '\u253c',
-    'boxVL;': '\u2563',
-    'boxVl;': '\u2562',
-    'boxvL;': '\u2561',
-    'boxvl;': '\u2524',
-    'boxVR;': '\u2560',
-    'boxVr;': '\u255f',
-    'boxvR;': '\u255e',
-    'boxvr;': '\u251c',
-    'bprime;': '\u2035',
-    'Breve;': '\u02d8',
-    'breve;': '\u02d8',
-    'brvbar': '\xa6',
-    'brvbar;': '\xa6',
-    'Bscr;': '\u212c',
-    'bscr;': '\U0001d4b7',
-    'bsemi;': '\u204f',
-    'bsim;': '\u223d',
-    'bsime;': '\u22cd',
-    'bsol;': '\\',
-    'bsolb;': '\u29c5',
-    'bsolhsub;': '\u27c8',
-    'bull;': '\u2022',
-    'bullet;': '\u2022',
-    'bump;': '\u224e',
-    'bumpE;': '\u2aae',
-    'bumpe;': '\u224f',
-    'Bumpeq;': '\u224e',
-    'bumpeq;': '\u224f',
-    'Cacute;': '\u0106',
-    'cacute;': '\u0107',
-    'Cap;': '\u22d2',
-    'cap;': '\u2229',
-    'capand;': '\u2a44',
-    'capbrcup;': '\u2a49',
-    'capcap;': '\u2a4b',
-    'capcup;': '\u2a47',
-    'capdot;': '\u2a40',
-    'CapitalDifferentialD;': '\u2145',
-    'caps;': '\u2229\ufe00',
-    'caret;': '\u2041',
-    'caron;': '\u02c7',
-    'Cayleys;': '\u212d',
-    'ccaps;': '\u2a4d',
-    'Ccaron;': '\u010c',
-    'ccaron;': '\u010d',
-    'Ccedil': '\xc7',
-    'ccedil': '\xe7',
-    'Ccedil;': '\xc7',
-    'ccedil;': '\xe7',
-    'Ccirc;': '\u0108',
-    'ccirc;': '\u0109',
-    'Cconint;': '\u2230',
-    'ccups;': '\u2a4c',
-    'ccupssm;': '\u2a50',
-    'Cdot;': '\u010a',
-    'cdot;': '\u010b',
-    'cedil': '\xb8',
-    'cedil;': '\xb8',
-    'Cedilla;': '\xb8',
-    'cemptyv;': '\u29b2',
-    'cent': '\xa2',
-    'cent;': '\xa2',
-    'CenterDot;': '\xb7',
-    'centerdot;': '\xb7',
-    'Cfr;': '\u212d',
-    'cfr;': '\U0001d520',
-    'CHcy;': '\u0427',
-    'chcy;': '\u0447',
-    'check;': '\u2713',
-    'checkmark;': '\u2713',
-    'Chi;': '\u03a7',
-    'chi;': '\u03c7',
-    'cir;': '\u25cb',
-    'circ;': '\u02c6',
-    'circeq;': '\u2257',
-    'circlearrowleft;': '\u21ba',
-    'circlearrowright;': '\u21bb',
-    'circledast;': '\u229b',
-    'circledcirc;': '\u229a',
-    'circleddash;': '\u229d',
-    'CircleDot;': '\u2299',
-    'circledR;': '\xae',
-    'circledS;': '\u24c8',
-    'CircleMinus;': '\u2296',
-    'CirclePlus;': '\u2295',
-    'CircleTimes;': '\u2297',
-    'cirE;': '\u29c3',
-    'cire;': '\u2257',
-    'cirfnint;': '\u2a10',
-    'cirmid;': '\u2aef',
-    'cirscir;': '\u29c2',
-    'ClockwiseContourIntegral;': '\u2232',
-    'CloseCurlyDoubleQuote;': '\u201d',
-    'CloseCurlyQuote;': '\u2019',
-    'clubs;': '\u2663',
-    'clubsuit;': '\u2663',
-    'Colon;': '\u2237',
-    'colon;': ':',
-    'Colone;': '\u2a74',
-    'colone;': '\u2254',
-    'coloneq;': '\u2254',
-    'comma;': ',',
-    'commat;': '@',
-    'comp;': '\u2201',
-    'compfn;': '\u2218',
-    'complement;': '\u2201',
-    'complexes;': '\u2102',
-    'cong;': '\u2245',
-    'congdot;': '\u2a6d',
-    'Congruent;': '\u2261',
-    'Conint;': '\u222f',
-    'conint;': '\u222e',
-    'ContourIntegral;': '\u222e',
-    'Copf;': '\u2102',
-    'copf;': '\U0001d554',
-    'coprod;': '\u2210',
-    'Coproduct;': '\u2210',
-    'COPY': '\xa9',
-    'copy': '\xa9',
-    'COPY;': '\xa9',
-    'copy;': '\xa9',
-    'copysr;': '\u2117',
-    'CounterClockwiseContourIntegral;': '\u2233',
-    'crarr;': '\u21b5',
-    'Cross;': '\u2a2f',
-    'cross;': '\u2717',
-    'Cscr;': '\U0001d49e',
-    'cscr;': '\U0001d4b8',
-    'csub;': '\u2acf',
-    'csube;': '\u2ad1',
-    'csup;': '\u2ad0',
-    'csupe;': '\u2ad2',
-    'ctdot;': '\u22ef',
-    'cudarrl;': '\u2938',
-    'cudarrr;': '\u2935',
-    'cuepr;': '\u22de',
-    'cuesc;': '\u22df',
-    'cularr;': '\u21b6',
-    'cularrp;': '\u293d',
-    'Cup;': '\u22d3',
-    'cup;': '\u222a',
-    'cupbrcap;': '\u2a48',
-    'CupCap;': '\u224d',
-    'cupcap;': '\u2a46',
-    'cupcup;': '\u2a4a',
-    'cupdot;': '\u228d',
-    'cupor;': '\u2a45',
-    'cups;': '\u222a\ufe00',
-    'curarr;': '\u21b7',
-    'curarrm;': '\u293c',
-    'curlyeqprec;': '\u22de',
-    'curlyeqsucc;': '\u22df',
-    'curlyvee;': '\u22ce',
-    'curlywedge;': '\u22cf',
-    'curren': '\xa4',
-    'curren;': '\xa4',
-    'curvearrowleft;': '\u21b6',
-    'curvearrowright;': '\u21b7',
-    'cuvee;': '\u22ce',
-    'cuwed;': '\u22cf',
-    'cwconint;': '\u2232',
-    'cwint;': '\u2231',
-    'cylcty;': '\u232d',
-    'Dagger;': '\u2021',
-    'dagger;': '\u2020',
-    'daleth;': '\u2138',
-    'Darr;': '\u21a1',
-    'dArr;': '\u21d3',
-    'darr;': '\u2193',
-    'dash;': '\u2010',
-    'Dashv;': '\u2ae4',
-    'dashv;': '\u22a3',
-    'dbkarow;': '\u290f',
-    'dblac;': '\u02dd',
-    'Dcaron;': '\u010e',
-    'dcaron;': '\u010f',
-    'Dcy;': '\u0414',
-    'dcy;': '\u0434',
-    'DD;': '\u2145',
-    'dd;': '\u2146',
-    'ddagger;': '\u2021',
-    'ddarr;': '\u21ca',
-    'DDotrahd;': '\u2911',
-    'ddotseq;': '\u2a77',
-    'deg': '\xb0',
-    'deg;': '\xb0',
-    'Del;': '\u2207',
-    'Delta;': '\u0394',
-    'delta;': '\u03b4',
-    'demptyv;': '\u29b1',
-    'dfisht;': '\u297f',
-    'Dfr;': '\U0001d507',
-    'dfr;': '\U0001d521',
-    'dHar;': '\u2965',
-    'dharl;': '\u21c3',
-    'dharr;': '\u21c2',
-    'DiacriticalAcute;': '\xb4',
-    'DiacriticalDot;': '\u02d9',
-    'DiacriticalDoubleAcute;': '\u02dd',
-    'DiacriticalGrave;': '`',
-    'DiacriticalTilde;': '\u02dc',
-    'diam;': '\u22c4',
-    'Diamond;': '\u22c4',
-    'diamond;': '\u22c4',
-    'diamondsuit;': '\u2666',
-    'diams;': '\u2666',
-    'die;': '\xa8',
-    'DifferentialD;': '\u2146',
-    'digamma;': '\u03dd',
-    'disin;': '\u22f2',
-    'div;': '\xf7',
-    'divide': '\xf7',
-    'divide;': '\xf7',
-    'divideontimes;': '\u22c7',
-    'divonx;': '\u22c7',
-    'DJcy;': '\u0402',
-    'djcy;': '\u0452',
-    'dlcorn;': '\u231e',
-    'dlcrop;': '\u230d',
-    'dollar;': '$',
-    'Dopf;': '\U0001d53b',
-    'dopf;': '\U0001d555',
-    'Dot;': '\xa8',
-    'dot;': '\u02d9',
-    'DotDot;': '\u20dc',
-    'doteq;': '\u2250',
-    'doteqdot;': '\u2251',
-    'DotEqual;': '\u2250',
-    'dotminus;': '\u2238',
-    'dotplus;': '\u2214',
-    'dotsquare;': '\u22a1',
-    'doublebarwedge;': '\u2306',
-    'DoubleContourIntegral;': '\u222f',
-    'DoubleDot;': '\xa8',
-    'DoubleDownArrow;': '\u21d3',
-    'DoubleLeftArrow;': '\u21d0',
-    'DoubleLeftRightArrow;': '\u21d4',
-    'DoubleLeftTee;': '\u2ae4',
-    'DoubleLongLeftArrow;': '\u27f8',
-    'DoubleLongLeftRightArrow;': '\u27fa',
-    'DoubleLongRightArrow;': '\u27f9',
-    'DoubleRightArrow;': '\u21d2',
-    'DoubleRightTee;': '\u22a8',
-    'DoubleUpArrow;': '\u21d1',
-    'DoubleUpDownArrow;': '\u21d5',
-    'DoubleVerticalBar;': '\u2225',
-    'DownArrow;': '\u2193',
-    'Downarrow;': '\u21d3',
-    'downarrow;': '\u2193',
-    'DownArrowBar;': '\u2913',
-    'DownArrowUpArrow;': '\u21f5',
-    'DownBreve;': '\u0311',
-    'downdownarrows;': '\u21ca',
-    'downharpoonleft;': '\u21c3',
-    'downharpoonright;': '\u21c2',
-    'DownLeftRightVector;': '\u2950',
-    'DownLeftTeeVector;': '\u295e',
-    'DownLeftVector;': '\u21bd',
-    'DownLeftVectorBar;': '\u2956',
-    'DownRightTeeVector;': '\u295f',
-    'DownRightVector;': '\u21c1',
-    'DownRightVectorBar;': '\u2957',
-    'DownTee;': '\u22a4',
-    'DownTeeArrow;': '\u21a7',
-    'drbkarow;': '\u2910',
-    'drcorn;': '\u231f',
-    'drcrop;': '\u230c',
-    'Dscr;': '\U0001d49f',
-    'dscr;': '\U0001d4b9',
-    'DScy;': '\u0405',
-    'dscy;': '\u0455',
-    'dsol;': '\u29f6',
-    'Dstrok;': '\u0110',
-    'dstrok;': '\u0111',
-    'dtdot;': '\u22f1',
-    'dtri;': '\u25bf',
-    'dtrif;': '\u25be',
-    'duarr;': '\u21f5',
-    'duhar;': '\u296f',
-    'dwangle;': '\u29a6',
-    'DZcy;': '\u040f',
-    'dzcy;': '\u045f',
-    'dzigrarr;': '\u27ff',
-    'Eacute': '\xc9',
-    'eacute': '\xe9',
-    'Eacute;': '\xc9',
-    'eacute;': '\xe9',
-    'easter;': '\u2a6e',
-    'Ecaron;': '\u011a',
-    'ecaron;': '\u011b',
-    'ecir;': '\u2256',
-    'Ecirc': '\xca',
-    'ecirc': '\xea',
-    'Ecirc;': '\xca',
-    'ecirc;': '\xea',
-    'ecolon;': '\u2255',
-    'Ecy;': '\u042d',
-    'ecy;': '\u044d',
-    'eDDot;': '\u2a77',
-    'Edot;': '\u0116',
-    'eDot;': '\u2251',
-    'edot;': '\u0117',
-    'ee;': '\u2147',
-    'efDot;': '\u2252',
-    'Efr;': '\U0001d508',
-    'efr;': '\U0001d522',
-    'eg;': '\u2a9a',
-    'Egrave': '\xc8',
-    'egrave': '\xe8',
-    'Egrave;': '\xc8',
-    'egrave;': '\xe8',
-    'egs;': '\u2a96',
-    'egsdot;': '\u2a98',
-    'el;': '\u2a99',
-    'Element;': '\u2208',
-    'elinters;': '\u23e7',
-    'ell;': '\u2113',
-    'els;': '\u2a95',
-    'elsdot;': '\u2a97',
-    'Emacr;': '\u0112',
-    'emacr;': '\u0113',
-    'empty;': '\u2205',
-    'emptyset;': '\u2205',
-    'EmptySmallSquare;': '\u25fb',
-    'emptyv;': '\u2205',
-    'EmptyVerySmallSquare;': '\u25ab',
-    'emsp13;': '\u2004',
-    'emsp14;': '\u2005',
-    'emsp;': '\u2003',
-    'ENG;': '\u014a',
-    'eng;': '\u014b',
-    'ensp;': '\u2002',
-    'Eogon;': '\u0118',
-    'eogon;': '\u0119',
-    'Eopf;': '\U0001d53c',
-    'eopf;': '\U0001d556',
-    'epar;': '\u22d5',
-    'eparsl;': '\u29e3',
-    'eplus;': '\u2a71',
-    'epsi;': '\u03b5',
-    'Epsilon;': '\u0395',
-    'epsilon;': '\u03b5',
-    'epsiv;': '\u03f5',
-    'eqcirc;': '\u2256',
-    'eqcolon;': '\u2255',
-    'eqsim;': '\u2242',
-    'eqslantgtr;': '\u2a96',
-    'eqslantless;': '\u2a95',
-    'Equal;': '\u2a75',
-    'equals;': '=',
-    'EqualTilde;': '\u2242',
-    'equest;': '\u225f',
-    'Equilibrium;': '\u21cc',
-    'equiv;': '\u2261',
-    'equivDD;': '\u2a78',
-    'eqvparsl;': '\u29e5',
-    'erarr;': '\u2971',
-    'erDot;': '\u2253',
-    'Escr;': '\u2130',
-    'escr;': '\u212f',
-    'esdot;': '\u2250',
-    'Esim;': '\u2a73',
-    'esim;': '\u2242',
-    'Eta;': '\u0397',
-    'eta;': '\u03b7',
-    'ETH': '\xd0',
-    'eth': '\xf0',
-    'ETH;': '\xd0',
-    'eth;': '\xf0',
-    'Euml': '\xcb',
-    'euml': '\xeb',
-    'Euml;': '\xcb',
-    'euml;': '\xeb',
-    'euro;': '\u20ac',
-    'excl;': '!',
-    'exist;': '\u2203',
-    'Exists;': '\u2203',
-    'expectation;': '\u2130',
-    'ExponentialE;': '\u2147',
-    'exponentiale;': '\u2147',
-    'fallingdotseq;': '\u2252',
-    'Fcy;': '\u0424',
-    'fcy;': '\u0444',
-    'female;': '\u2640',
-    'ffilig;': '\ufb03',
-    'fflig;': '\ufb00',
-    'ffllig;': '\ufb04',
-    'Ffr;': '\U0001d509',
-    'ffr;': '\U0001d523',
-    'filig;': '\ufb01',
-    'FilledSmallSquare;': '\u25fc',
-    'FilledVerySmallSquare;': '\u25aa',
-    'fjlig;': 'fj',
-    'flat;': '\u266d',
-    'fllig;': '\ufb02',
-    'fltns;': '\u25b1',
-    'fnof;': '\u0192',
-    'Fopf;': '\U0001d53d',
-    'fopf;': '\U0001d557',
-    'ForAll;': '\u2200',
-    'forall;': '\u2200',
-    'fork;': '\u22d4',
-    'forkv;': '\u2ad9',
-    'Fouriertrf;': '\u2131',
-    'fpartint;': '\u2a0d',
-    'frac12': '\xbd',
-    'frac12;': '\xbd',
-    'frac13;': '\u2153',
-    'frac14': '\xbc',
-    'frac14;': '\xbc',
-    'frac15;': '\u2155',
-    'frac16;': '\u2159',
-    'frac18;': '\u215b',
-    'frac23;': '\u2154',
-    'frac25;': '\u2156',
-    'frac34': '\xbe',
-    'frac34;': '\xbe',
-    'frac35;': '\u2157',
-    'frac38;': '\u215c',
-    'frac45;': '\u2158',
-    'frac56;': '\u215a',
-    'frac58;': '\u215d',
-    'frac78;': '\u215e',
-    'frasl;': '\u2044',
-    'frown;': '\u2322',
-    'Fscr;': '\u2131',
-    'fscr;': '\U0001d4bb',
-    'gacute;': '\u01f5',
-    'Gamma;': '\u0393',
-    'gamma;': '\u03b3',
-    'Gammad;': '\u03dc',
-    'gammad;': '\u03dd',
-    'gap;': '\u2a86',
-    'Gbreve;': '\u011e',
-    'gbreve;': '\u011f',
-    'Gcedil;': '\u0122',
-    'Gcirc;': '\u011c',
-    'gcirc;': '\u011d',
-    'Gcy;': '\u0413',
-    'gcy;': '\u0433',
-    'Gdot;': '\u0120',
-    'gdot;': '\u0121',
-    'gE;': '\u2267',
-    'ge;': '\u2265',
-    'gEl;': '\u2a8c',
-    'gel;': '\u22db',
-    'geq;': '\u2265',
-    'geqq;': '\u2267',
-    'geqslant;': '\u2a7e',
-    'ges;': '\u2a7e',
-    'gescc;': '\u2aa9',
-    'gesdot;': '\u2a80',
-    'gesdoto;': '\u2a82',
-    'gesdotol;': '\u2a84',
-    'gesl;': '\u22db\ufe00',
-    'gesles;': '\u2a94',
-    'Gfr;': '\U0001d50a',
-    'gfr;': '\U0001d524',
-    'Gg;': '\u22d9',
-    'gg;': '\u226b',
-    'ggg;': '\u22d9',
-    'gimel;': '\u2137',
-    'GJcy;': '\u0403',
-    'gjcy;': '\u0453',
-    'gl;': '\u2277',
-    'gla;': '\u2aa5',
-    'glE;': '\u2a92',
-    'glj;': '\u2aa4',
-    'gnap;': '\u2a8a',
-    'gnapprox;': '\u2a8a',
-    'gnE;': '\u2269',
-    'gne;': '\u2a88',
-    'gneq;': '\u2a88',
-    'gneqq;': '\u2269',
-    'gnsim;': '\u22e7',
-    'Gopf;': '\U0001d53e',
-    'gopf;': '\U0001d558',
-    'grave;': '`',
-    'GreaterEqual;': '\u2265',
-    'GreaterEqualLess;': '\u22db',
-    'GreaterFullEqual;': '\u2267',
-    'GreaterGreater;': '\u2aa2',
-    'GreaterLess;': '\u2277',
-    'GreaterSlantEqual;': '\u2a7e',
-    'GreaterTilde;': '\u2273',
-    'Gscr;': '\U0001d4a2',
-    'gscr;': '\u210a',
-    'gsim;': '\u2273',
-    'gsime;': '\u2a8e',
-    'gsiml;': '\u2a90',
-    'GT': '>',
-    'gt': '>',
-    'GT;': '>',
-    'Gt;': '\u226b',
-    'gt;': '>',
-    'gtcc;': '\u2aa7',
-    'gtcir;': '\u2a7a',
-    'gtdot;': '\u22d7',
-    'gtlPar;': '\u2995',
-    'gtquest;': '\u2a7c',
-    'gtrapprox;': '\u2a86',
-    'gtrarr;': '\u2978',
-    'gtrdot;': '\u22d7',
-    'gtreqless;': '\u22db',
-    'gtreqqless;': '\u2a8c',
-    'gtrless;': '\u2277',
-    'gtrsim;': '\u2273',
-    'gvertneqq;': '\u2269\ufe00',
-    'gvnE;': '\u2269\ufe00',
-    'Hacek;': '\u02c7',
-    'hairsp;': '\u200a',
-    'half;': '\xbd',
-    'hamilt;': '\u210b',
-    'HARDcy;': '\u042a',
-    'hardcy;': '\u044a',
-    'hArr;': '\u21d4',
-    'harr;': '\u2194',
-    'harrcir;': '\u2948',
-    'harrw;': '\u21ad',
-    'Hat;': '^',
-    'hbar;': '\u210f',
-    'Hcirc;': '\u0124',
-    'hcirc;': '\u0125',
-    'hearts;': '\u2665',
-    'heartsuit;': '\u2665',
-    'hellip;': '\u2026',
-    'hercon;': '\u22b9',
-    'Hfr;': '\u210c',
-    'hfr;': '\U0001d525',
-    'HilbertSpace;': '\u210b',
-    'hksearow;': '\u2925',
-    'hkswarow;': '\u2926',
-    'hoarr;': '\u21ff',
-    'homtht;': '\u223b',
-    'hookleftarrow;': '\u21a9',
-    'hookrightarrow;': '\u21aa',
-    'Hopf;': '\u210d',
-    'hopf;': '\U0001d559',
-    'horbar;': '\u2015',
-    'HorizontalLine;': '\u2500',
-    'Hscr;': '\u210b',
-    'hscr;': '\U0001d4bd',
-    'hslash;': '\u210f',
-    'Hstrok;': '\u0126',
-    'hstrok;': '\u0127',
-    'HumpDownHump;': '\u224e',
-    'HumpEqual;': '\u224f',
-    'hybull;': '\u2043',
-    'hyphen;': '\u2010',
-    'Iacute': '\xcd',
-    'iacute': '\xed',
-    'Iacute;': '\xcd',
-    'iacute;': '\xed',
-    'ic;': '\u2063',
-    'Icirc': '\xce',
-    'icirc': '\xee',
-    'Icirc;': '\xce',
-    'icirc;': '\xee',
-    'Icy;': '\u0418',
-    'icy;': '\u0438',
-    'Idot;': '\u0130',
-    'IEcy;': '\u0415',
-    'iecy;': '\u0435',
-    'iexcl': '\xa1',
-    'iexcl;': '\xa1',
-    'iff;': '\u21d4',
-    'Ifr;': '\u2111',
-    'ifr;': '\U0001d526',
-    'Igrave': '\xcc',
-    'igrave': '\xec',
-    'Igrave;': '\xcc',
-    'igrave;': '\xec',
-    'ii;': '\u2148',
-    'iiiint;': '\u2a0c',
-    'iiint;': '\u222d',
-    'iinfin;': '\u29dc',
-    'iiota;': '\u2129',
-    'IJlig;': '\u0132',
-    'ijlig;': '\u0133',
-    'Im;': '\u2111',
-    'Imacr;': '\u012a',
-    'imacr;': '\u012b',
-    'image;': '\u2111',
-    'ImaginaryI;': '\u2148',
-    'imagline;': '\u2110',
-    'imagpart;': '\u2111',
-    'imath;': '\u0131',
-    'imof;': '\u22b7',
-    'imped;': '\u01b5',
-    'Implies;': '\u21d2',
-    'in;': '\u2208',
-    'incare;': '\u2105',
-    'infin;': '\u221e',
-    'infintie;': '\u29dd',
-    'inodot;': '\u0131',
-    'Int;': '\u222c',
-    'int;': '\u222b',
-    'intcal;': '\u22ba',
-    'integers;': '\u2124',
-    'Integral;': '\u222b',
-    'intercal;': '\u22ba',
-    'Intersection;': '\u22c2',
-    'intlarhk;': '\u2a17',
-    'intprod;': '\u2a3c',
-    'InvisibleComma;': '\u2063',
-    'InvisibleTimes;': '\u2062',
-    'IOcy;': '\u0401',
-    'iocy;': '\u0451',
-    'Iogon;': '\u012e',
-    'iogon;': '\u012f',
-    'Iopf;': '\U0001d540',
-    'iopf;': '\U0001d55a',
-    'Iota;': '\u0399',
-    'iota;': '\u03b9',
-    'iprod;': '\u2a3c',
-    'iquest': '\xbf',
-    'iquest;': '\xbf',
-    'Iscr;': '\u2110',
-    'iscr;': '\U0001d4be',
-    'isin;': '\u2208',
-    'isindot;': '\u22f5',
-    'isinE;': '\u22f9',
-    'isins;': '\u22f4',
-    'isinsv;': '\u22f3',
-    'isinv;': '\u2208',
-    'it;': '\u2062',
-    'Itilde;': '\u0128',
-    'itilde;': '\u0129',
-    'Iukcy;': '\u0406',
-    'iukcy;': '\u0456',
-    'Iuml': '\xcf',
-    'iuml': '\xef',
-    'Iuml;': '\xcf',
-    'iuml;': '\xef',
-    'Jcirc;': '\u0134',
-    'jcirc;': '\u0135',
-    'Jcy;': '\u0419',
-    'jcy;': '\u0439',
-    'Jfr;': '\U0001d50d',
-    'jfr;': '\U0001d527',
-    'jmath;': '\u0237',
-    'Jopf;': '\U0001d541',
-    'jopf;': '\U0001d55b',
-    'Jscr;': '\U0001d4a5',
-    'jscr;': '\U0001d4bf',
-    'Jsercy;': '\u0408',
-    'jsercy;': '\u0458',
-    'Jukcy;': '\u0404',
-    'jukcy;': '\u0454',
-    'Kappa;': '\u039a',
-    'kappa;': '\u03ba',
-    'kappav;': '\u03f0',
-    'Kcedil;': '\u0136',
-    'kcedil;': '\u0137',
-    'Kcy;': '\u041a',
-    'kcy;': '\u043a',
-    'Kfr;': '\U0001d50e',
-    'kfr;': '\U0001d528',
-    'kgreen;': '\u0138',
-    'KHcy;': '\u0425',
-    'khcy;': '\u0445',
-    'KJcy;': '\u040c',
-    'kjcy;': '\u045c',
-    'Kopf;': '\U0001d542',
-    'kopf;': '\U0001d55c',
-    'Kscr;': '\U0001d4a6',
-    'kscr;': '\U0001d4c0',
-    'lAarr;': '\u21da',
-    'Lacute;': '\u0139',
-    'lacute;': '\u013a',
-    'laemptyv;': '\u29b4',
-    'lagran;': '\u2112',
-    'Lambda;': '\u039b',
-    'lambda;': '\u03bb',
-    'Lang;': '\u27ea',
-    'lang;': '\u27e8',
-    'langd;': '\u2991',
-    'langle;': '\u27e8',
-    'lap;': '\u2a85',
-    'Laplacetrf;': '\u2112',
-    'laquo': '\xab',
-    'laquo;': '\xab',
-    'Larr;': '\u219e',
-    'lArr;': '\u21d0',
-    'larr;': '\u2190',
-    'larrb;': '\u21e4',
-    'larrbfs;': '\u291f',
-    'larrfs;': '\u291d',
-    'larrhk;': '\u21a9',
-    'larrlp;': '\u21ab',
-    'larrpl;': '\u2939',
-    'larrsim;': '\u2973',
-    'larrtl;': '\u21a2',
-    'lat;': '\u2aab',
-    'lAtail;': '\u291b',
-    'latail;': '\u2919',
-    'late;': '\u2aad',
-    'lates;': '\u2aad\ufe00',
-    'lBarr;': '\u290e',
-    'lbarr;': '\u290c',
-    'lbbrk;': '\u2772',
-    'lbrace;': '{',
-    'lbrack;': '[',
-    'lbrke;': '\u298b',
-    'lbrksld;': '\u298f',
-    'lbrkslu;': '\u298d',
-    'Lcaron;': '\u013d',
-    'lcaron;': '\u013e',
-    'Lcedil;': '\u013b',
-    'lcedil;': '\u013c',
-    'lceil;': '\u2308',
-    'lcub;': '{',
-    'Lcy;': '\u041b',
-    'lcy;': '\u043b',
-    'ldca;': '\u2936',
-    'ldquo;': '\u201c',
-    'ldquor;': '\u201e',
-    'ldrdhar;': '\u2967',
-    'ldrushar;': '\u294b',
-    'ldsh;': '\u21b2',
-    'lE;': '\u2266',
-    'le;': '\u2264',
-    'LeftAngleBracket;': '\u27e8',
-    'LeftArrow;': '\u2190',
-    'Leftarrow;': '\u21d0',
-    'leftarrow;': '\u2190',
-    'LeftArrowBar;': '\u21e4',
-    'LeftArrowRightArrow;': '\u21c6',
-    'leftarrowtail;': '\u21a2',
-    'LeftCeiling;': '\u2308',
-    'LeftDoubleBracket;': '\u27e6',
-    'LeftDownTeeVector;': '\u2961',
-    'LeftDownVector;': '\u21c3',
-    'LeftDownVectorBar;': '\u2959',
-    'LeftFloor;': '\u230a',
-    'leftharpoondown;': '\u21bd',
-    'leftharpoonup;': '\u21bc',
-    'leftleftarrows;': '\u21c7',
-    'LeftRightArrow;': '\u2194',
-    'Leftrightarrow;': '\u21d4',
-    'leftrightarrow;': '\u2194',
-    'leftrightarrows;': '\u21c6',
-    'leftrightharpoons;': '\u21cb',
-    'leftrightsquigarrow;': '\u21ad',
-    'LeftRightVector;': '\u294e',
-    'LeftTee;': '\u22a3',
-    'LeftTeeArrow;': '\u21a4',
-    'LeftTeeVector;': '\u295a',
-    'leftthreetimes;': '\u22cb',
-    'LeftTriangle;': '\u22b2',
-    'LeftTriangleBar;': '\u29cf',
-    'LeftTriangleEqual;': '\u22b4',
-    'LeftUpDownVector;': '\u2951',
-    'LeftUpTeeVector;': '\u2960',
-    'LeftUpVector;': '\u21bf',
-    'LeftUpVectorBar;': '\u2958',
-    'LeftVector;': '\u21bc',
-    'LeftVectorBar;': '\u2952',
-    'lEg;': '\u2a8b',
-    'leg;': '\u22da',
-    'leq;': '\u2264',
-    'leqq;': '\u2266',
-    'leqslant;': '\u2a7d',
-    'les;': '\u2a7d',
-    'lescc;': '\u2aa8',
-    'lesdot;': '\u2a7f',
-    'lesdoto;': '\u2a81',
-    'lesdotor;': '\u2a83',
-    'lesg;': '\u22da\ufe00',
-    'lesges;': '\u2a93',
-    'lessapprox;': '\u2a85',
-    'lessdot;': '\u22d6',
-    'lesseqgtr;': '\u22da',
-    'lesseqqgtr;': '\u2a8b',
-    'LessEqualGreater;': '\u22da',
-    'LessFullEqual;': '\u2266',
-    'LessGreater;': '\u2276',
-    'lessgtr;': '\u2276',
-    'LessLess;': '\u2aa1',
-    'lesssim;': '\u2272',
-    'LessSlantEqual;': '\u2a7d',
-    'LessTilde;': '\u2272',
-    'lfisht;': '\u297c',
-    'lfloor;': '\u230a',
-    'Lfr;': '\U0001d50f',
-    'lfr;': '\U0001d529',
-    'lg;': '\u2276',
-    'lgE;': '\u2a91',
-    'lHar;': '\u2962',
-    'lhard;': '\u21bd',
-    'lharu;': '\u21bc',
-    'lharul;': '\u296a',
-    'lhblk;': '\u2584',
-    'LJcy;': '\u0409',
-    'ljcy;': '\u0459',
-    'Ll;': '\u22d8',
-    'll;': '\u226a',
-    'llarr;': '\u21c7',
-    'llcorner;': '\u231e',
-    'Lleftarrow;': '\u21da',
-    'llhard;': '\u296b',
-    'lltri;': '\u25fa',
-    'Lmidot;': '\u013f',
-    'lmidot;': '\u0140',
-    'lmoust;': '\u23b0',
-    'lmoustache;': '\u23b0',
-    'lnap;': '\u2a89',
-    'lnapprox;': '\u2a89',
-    'lnE;': '\u2268',
-    'lne;': '\u2a87',
-    'lneq;': '\u2a87',
-    'lneqq;': '\u2268',
-    'lnsim;': '\u22e6',
-    'loang;': '\u27ec',
-    'loarr;': '\u21fd',
-    'lobrk;': '\u27e6',
-    'LongLeftArrow;': '\u27f5',
-    'Longleftarrow;': '\u27f8',
-    'longleftarrow;': '\u27f5',
-    'LongLeftRightArrow;': '\u27f7',
-    'Longleftrightarrow;': '\u27fa',
-    'longleftrightarrow;': '\u27f7',
-    'longmapsto;': '\u27fc',
-    'LongRightArrow;': '\u27f6',
-    'Longrightarrow;': '\u27f9',
-    'longrightarrow;': '\u27f6',
-    'looparrowleft;': '\u21ab',
-    'looparrowright;': '\u21ac',
-    'lopar;': '\u2985',
-    'Lopf;': '\U0001d543',
-    'lopf;': '\U0001d55d',
-    'loplus;': '\u2a2d',
-    'lotimes;': '\u2a34',
-    'lowast;': '\u2217',
-    'lowbar;': '_',
-    'LowerLeftArrow;': '\u2199',
-    'LowerRightArrow;': '\u2198',
-    'loz;': '\u25ca',
-    'lozenge;': '\u25ca',
-    'lozf;': '\u29eb',
-    'lpar;': '(',
-    'lparlt;': '\u2993',
-    'lrarr;': '\u21c6',
-    'lrcorner;': '\u231f',
-    'lrhar;': '\u21cb',
-    'lrhard;': '\u296d',
-    'lrm;': '\u200e',
-    'lrtri;': '\u22bf',
-    'lsaquo;': '\u2039',
-    'Lscr;': '\u2112',
-    'lscr;': '\U0001d4c1',
-    'Lsh;': '\u21b0',
-    'lsh;': '\u21b0',
-    'lsim;': '\u2272',
-    'lsime;': '\u2a8d',
-    'lsimg;': '\u2a8f',
-    'lsqb;': '[',
-    'lsquo;': '\u2018',
-    'lsquor;': '\u201a',
-    'Lstrok;': '\u0141',
-    'lstrok;': '\u0142',
-    'LT': '<',
-    'lt': '<',
-    'LT;': '<',
-    'Lt;': '\u226a',
-    'lt;': '<',
-    'ltcc;': '\u2aa6',
-    'ltcir;': '\u2a79',
-    'ltdot;': '\u22d6',
-    'lthree;': '\u22cb',
-    'ltimes;': '\u22c9',
-    'ltlarr;': '\u2976',
-    'ltquest;': '\u2a7b',
-    'ltri;': '\u25c3',
-    'ltrie;': '\u22b4',
-    'ltrif;': '\u25c2',
-    'ltrPar;': '\u2996',
-    'lurdshar;': '\u294a',
-    'luruhar;': '\u2966',
-    'lvertneqq;': '\u2268\ufe00',
-    'lvnE;': '\u2268\ufe00',
-    'macr': '\xaf',
-    'macr;': '\xaf',
-    'male;': '\u2642',
-    'malt;': '\u2720',
-    'maltese;': '\u2720',
-    'Map;': '\u2905',
-    'map;': '\u21a6',
-    'mapsto;': '\u21a6',
-    'mapstodown;': '\u21a7',
-    'mapstoleft;': '\u21a4',
-    'mapstoup;': '\u21a5',
-    'marker;': '\u25ae',
-    'mcomma;': '\u2a29',
-    'Mcy;': '\u041c',
-    'mcy;': '\u043c',
-    'mdash;': '\u2014',
-    'mDDot;': '\u223a',
-    'measuredangle;': '\u2221',
-    'MediumSpace;': '\u205f',
-    'Mellintrf;': '\u2133',
-    'Mfr;': '\U0001d510',
-    'mfr;': '\U0001d52a',
-    'mho;': '\u2127',
-    'micro': '\xb5',
-    'micro;': '\xb5',
-    'mid;': '\u2223',
-    'midast;': '*',
-    'midcir;': '\u2af0',
-    'middot': '\xb7',
-    'middot;': '\xb7',
-    'minus;': '\u2212',
-    'minusb;': '\u229f',
-    'minusd;': '\u2238',
-    'minusdu;': '\u2a2a',
-    'MinusPlus;': '\u2213',
-    'mlcp;': '\u2adb',
-    'mldr;': '\u2026',
-    'mnplus;': '\u2213',
-    'models;': '\u22a7',
-    'Mopf;': '\U0001d544',
-    'mopf;': '\U0001d55e',
-    'mp;': '\u2213',
-    'Mscr;': '\u2133',
-    'mscr;': '\U0001d4c2',
-    'mstpos;': '\u223e',
-    'Mu;': '\u039c',
-    'mu;': '\u03bc',
-    'multimap;': '\u22b8',
-    'mumap;': '\u22b8',
-    'nabla;': '\u2207',
-    'Nacute;': '\u0143',
-    'nacute;': '\u0144',
-    'nang;': '\u2220\u20d2',
-    'nap;': '\u2249',
-    'napE;': '\u2a70\u0338',
-    'napid;': '\u224b\u0338',
-    'napos;': '\u0149',
-    'napprox;': '\u2249',
-    'natur;': '\u266e',
-    'natural;': '\u266e',
-    'naturals;': '\u2115',
-    'nbsp': '\xa0',
-    'nbsp;': '\xa0',
-    'nbump;': '\u224e\u0338',
-    'nbumpe;': '\u224f\u0338',
-    'ncap;': '\u2a43',
-    'Ncaron;': '\u0147',
-    'ncaron;': '\u0148',
-    'Ncedil;': '\u0145',
-    'ncedil;': '\u0146',
-    'ncong;': '\u2247',
-    'ncongdot;': '\u2a6d\u0338',
-    'ncup;': '\u2a42',
-    'Ncy;': '\u041d',
-    'ncy;': '\u043d',
-    'ndash;': '\u2013',
-    'ne;': '\u2260',
-    'nearhk;': '\u2924',
-    'neArr;': '\u21d7',
-    'nearr;': '\u2197',
-    'nearrow;': '\u2197',
-    'nedot;': '\u2250\u0338',
-    'NegativeMediumSpace;': '\u200b',
-    'NegativeThickSpace;': '\u200b',
-    'NegativeThinSpace;': '\u200b',
-    'NegativeVeryThinSpace;': '\u200b',
-    'nequiv;': '\u2262',
-    'nesear;': '\u2928',
-    'nesim;': '\u2242\u0338',
-    'NestedGreaterGreater;': '\u226b',
-    'NestedLessLess;': '\u226a',
-    'NewLine;': '\n',
-    'nexist;': '\u2204',
-    'nexists;': '\u2204',
-    'Nfr;': '\U0001d511',
-    'nfr;': '\U0001d52b',
-    'ngE;': '\u2267\u0338',
-    'nge;': '\u2271',
-    'ngeq;': '\u2271',
-    'ngeqq;': '\u2267\u0338',
-    'ngeqslant;': '\u2a7e\u0338',
-    'nges;': '\u2a7e\u0338',
-    'nGg;': '\u22d9\u0338',
-    'ngsim;': '\u2275',
-    'nGt;': '\u226b\u20d2',
-    'ngt;': '\u226f',
-    'ngtr;': '\u226f',
-    'nGtv;': '\u226b\u0338',
-    'nhArr;': '\u21ce',
-    'nharr;': '\u21ae',
-    'nhpar;': '\u2af2',
-    'ni;': '\u220b',
-    'nis;': '\u22fc',
-    'nisd;': '\u22fa',
-    'niv;': '\u220b',
-    'NJcy;': '\u040a',
-    'njcy;': '\u045a',
-    'nlArr;': '\u21cd',
-    'nlarr;': '\u219a',
-    'nldr;': '\u2025',
-    'nlE;': '\u2266\u0338',
-    'nle;': '\u2270',
-    'nLeftarrow;': '\u21cd',
-    'nleftarrow;': '\u219a',
-    'nLeftrightarrow;': '\u21ce',
-    'nleftrightarrow;': '\u21ae',
-    'nleq;': '\u2270',
-    'nleqq;': '\u2266\u0338',
-    'nleqslant;': '\u2a7d\u0338',
-    'nles;': '\u2a7d\u0338',
-    'nless;': '\u226e',
-    'nLl;': '\u22d8\u0338',
-    'nlsim;': '\u2274',
-    'nLt;': '\u226a\u20d2',
-    'nlt;': '\u226e',
-    'nltri;': '\u22ea',
-    'nltrie;': '\u22ec',
-    'nLtv;': '\u226a\u0338',
-    'nmid;': '\u2224',
-    'NoBreak;': '\u2060',
-    'NonBreakingSpace;': '\xa0',
-    'Nopf;': '\u2115',
-    'nopf;': '\U0001d55f',
-    'not': '\xac',
-    'Not;': '\u2aec',
-    'not;': '\xac',
-    'NotCongruent;': '\u2262',
-    'NotCupCap;': '\u226d',
-    'NotDoubleVerticalBar;': '\u2226',
-    'NotElement;': '\u2209',
-    'NotEqual;': '\u2260',
-    'NotEqualTilde;': '\u2242\u0338',
-    'NotExists;': '\u2204',
-    'NotGreater;': '\u226f',
-    'NotGreaterEqual;': '\u2271',
-    'NotGreaterFullEqual;': '\u2267\u0338',
-    'NotGreaterGreater;': '\u226b\u0338',
-    'NotGreaterLess;': '\u2279',
-    'NotGreaterSlantEqual;': '\u2a7e\u0338',
-    'NotGreaterTilde;': '\u2275',
-    'NotHumpDownHump;': '\u224e\u0338',
-    'NotHumpEqual;': '\u224f\u0338',
-    'notin;': '\u2209',
-    'notindot;': '\u22f5\u0338',
-    'notinE;': '\u22f9\u0338',
-    'notinva;': '\u2209',
-    'notinvb;': '\u22f7',
-    'notinvc;': '\u22f6',
-    'NotLeftTriangle;': '\u22ea',
-    'NotLeftTriangleBar;': '\u29cf\u0338',
-    'NotLeftTriangleEqual;': '\u22ec',
-    'NotLess;': '\u226e',
-    'NotLessEqual;': '\u2270',
-    'NotLessGreater;': '\u2278',
-    'NotLessLess;': '\u226a\u0338',
-    'NotLessSlantEqual;': '\u2a7d\u0338',
-    'NotLessTilde;': '\u2274',
-    'NotNestedGreaterGreater;': '\u2aa2\u0338',
-    'NotNestedLessLess;': '\u2aa1\u0338',
-    'notni;': '\u220c',
-    'notniva;': '\u220c',
-    'notnivb;': '\u22fe',
-    'notnivc;': '\u22fd',
-    'NotPrecedes;': '\u2280',
-    'NotPrecedesEqual;': '\u2aaf\u0338',
-    'NotPrecedesSlantEqual;': '\u22e0',
-    'NotReverseElement;': '\u220c',
-    'NotRightTriangle;': '\u22eb',
-    'NotRightTriangleBar;': '\u29d0\u0338',
-    'NotRightTriangleEqual;': '\u22ed',
-    'NotSquareSubset;': '\u228f\u0338',
-    'NotSquareSubsetEqual;': '\u22e2',
-    'NotSquareSuperset;': '\u2290\u0338',
-    'NotSquareSupersetEqual;': '\u22e3',
-    'NotSubset;': '\u2282\u20d2',
-    'NotSubsetEqual;': '\u2288',
-    'NotSucceeds;': '\u2281',
-    'NotSucceedsEqual;': '\u2ab0\u0338',
-    'NotSucceedsSlantEqual;': '\u22e1',
-    'NotSucceedsTilde;': '\u227f\u0338',
-    'NotSuperset;': '\u2283\u20d2',
-    'NotSupersetEqual;': '\u2289',
-    'NotTilde;': '\u2241',
-    'NotTildeEqual;': '\u2244',
-    'NotTildeFullEqual;': '\u2247',
-    'NotTildeTilde;': '\u2249',
-    'NotVerticalBar;': '\u2224',
-    'npar;': '\u2226',
-    'nparallel;': '\u2226',
-    'nparsl;': '\u2afd\u20e5',
-    'npart;': '\u2202\u0338',
-    'npolint;': '\u2a14',
-    'npr;': '\u2280',
-    'nprcue;': '\u22e0',
-    'npre;': '\u2aaf\u0338',
-    'nprec;': '\u2280',
-    'npreceq;': '\u2aaf\u0338',
-    'nrArr;': '\u21cf',
-    'nrarr;': '\u219b',
-    'nrarrc;': '\u2933\u0338',
-    'nrarrw;': '\u219d\u0338',
-    'nRightarrow;': '\u21cf',
-    'nrightarrow;': '\u219b',
-    'nrtri;': '\u22eb',
-    'nrtrie;': '\u22ed',
-    'nsc;': '\u2281',
-    'nsccue;': '\u22e1',
-    'nsce;': '\u2ab0\u0338',
-    'Nscr;': '\U0001d4a9',
-    'nscr;': '\U0001d4c3',
-    'nshortmid;': '\u2224',
-    'nshortparallel;': '\u2226',
-    'nsim;': '\u2241',
-    'nsime;': '\u2244',
-    'nsimeq;': '\u2244',
-    'nsmid;': '\u2224',
-    'nspar;': '\u2226',
-    'nsqsube;': '\u22e2',
-    'nsqsupe;': '\u22e3',
-    'nsub;': '\u2284',
-    'nsubE;': '\u2ac5\u0338',
-    'nsube;': '\u2288',
-    'nsubset;': '\u2282\u20d2',
-    'nsubseteq;': '\u2288',
-    'nsubseteqq;': '\u2ac5\u0338',
-    'nsucc;': '\u2281',
-    'nsucceq;': '\u2ab0\u0338',
-    'nsup;': '\u2285',
-    'nsupE;': '\u2ac6\u0338',
-    'nsupe;': '\u2289',
-    'nsupset;': '\u2283\u20d2',
-    'nsupseteq;': '\u2289',
-    'nsupseteqq;': '\u2ac6\u0338',
-    'ntgl;': '\u2279',
-    'Ntilde': '\xd1',
-    'ntilde': '\xf1',
-    'Ntilde;': '\xd1',
-    'ntilde;': '\xf1',
-    'ntlg;': '\u2278',
-    'ntriangleleft;': '\u22ea',
-    'ntrianglelefteq;': '\u22ec',
-    'ntriangleright;': '\u22eb',
-    'ntrianglerighteq;': '\u22ed',
-    'Nu;': '\u039d',
-    'nu;': '\u03bd',
-    'num;': '#',
-    'numero;': '\u2116',
-    'numsp;': '\u2007',
-    'nvap;': '\u224d\u20d2',
-    'nVDash;': '\u22af',
-    'nVdash;': '\u22ae',
-    'nvDash;': '\u22ad',
-    'nvdash;': '\u22ac',
-    'nvge;': '\u2265\u20d2',
-    'nvgt;': '>\u20d2',
-    'nvHarr;': '\u2904',
-    'nvinfin;': '\u29de',
-    'nvlArr;': '\u2902',
-    'nvle;': '\u2264\u20d2',
-    'nvlt;': '<\u20d2',
-    'nvltrie;': '\u22b4\u20d2',
-    'nvrArr;': '\u2903',
-    'nvrtrie;': '\u22b5\u20d2',
-    'nvsim;': '\u223c\u20d2',
-    'nwarhk;': '\u2923',
-    'nwArr;': '\u21d6',
-    'nwarr;': '\u2196',
-    'nwarrow;': '\u2196',
-    'nwnear;': '\u2927',
-    'Oacute': '\xd3',
-    'oacute': '\xf3',
-    'Oacute;': '\xd3',
-    'oacute;': '\xf3',
-    'oast;': '\u229b',
-    'ocir;': '\u229a',
-    'Ocirc': '\xd4',
-    'ocirc': '\xf4',
-    'Ocirc;': '\xd4',
-    'ocirc;': '\xf4',
-    'Ocy;': '\u041e',
-    'ocy;': '\u043e',
-    'odash;': '\u229d',
-    'Odblac;': '\u0150',
-    'odblac;': '\u0151',
-    'odiv;': '\u2a38',
-    'odot;': '\u2299',
-    'odsold;': '\u29bc',
-    'OElig;': '\u0152',
-    'oelig;': '\u0153',
-    'ofcir;': '\u29bf',
-    'Ofr;': '\U0001d512',
-    'ofr;': '\U0001d52c',
-    'ogon;': '\u02db',
-    'Ograve': '\xd2',
-    'ograve': '\xf2',
-    'Ograve;': '\xd2',
-    'ograve;': '\xf2',
-    'ogt;': '\u29c1',
-    'ohbar;': '\u29b5',
-    'ohm;': '\u03a9',
-    'oint;': '\u222e',
-    'olarr;': '\u21ba',
-    'olcir;': '\u29be',
-    'olcross;': '\u29bb',
-    'oline;': '\u203e',
-    'olt;': '\u29c0',
-    'Omacr;': '\u014c',
-    'omacr;': '\u014d',
-    'Omega;': '\u03a9',
-    'omega;': '\u03c9',
-    'Omicron;': '\u039f',
-    'omicron;': '\u03bf',
-    'omid;': '\u29b6',
-    'ominus;': '\u2296',
-    'Oopf;': '\U0001d546',
-    'oopf;': '\U0001d560',
-    'opar;': '\u29b7',
-    'OpenCurlyDoubleQuote;': '\u201c',
-    'OpenCurlyQuote;': '\u2018',
-    'operp;': '\u29b9',
-    'oplus;': '\u2295',
-    'Or;': '\u2a54',
-    'or;': '\u2228',
-    'orarr;': '\u21bb',
-    'ord;': '\u2a5d',
-    'order;': '\u2134',
-    'orderof;': '\u2134',
-    'ordf': '\xaa',
-    'ordf;': '\xaa',
-    'ordm': '\xba',
-    'ordm;': '\xba',
-    'origof;': '\u22b6',
-    'oror;': '\u2a56',
-    'orslope;': '\u2a57',
-    'orv;': '\u2a5b',
-    'oS;': '\u24c8',
-    'Oscr;': '\U0001d4aa',
-    'oscr;': '\u2134',
-    'Oslash': '\xd8',
-    'oslash': '\xf8',
-    'Oslash;': '\xd8',
-    'oslash;': '\xf8',
-    'osol;': '\u2298',
-    'Otilde': '\xd5',
-    'otilde': '\xf5',
-    'Otilde;': '\xd5',
-    'otilde;': '\xf5',
-    'Otimes;': '\u2a37',
-    'otimes;': '\u2297',
-    'otimesas;': '\u2a36',
-    'Ouml': '\xd6',
-    'ouml': '\xf6',
-    'Ouml;': '\xd6',
-    'ouml;': '\xf6',
-    'ovbar;': '\u233d',
-    'OverBar;': '\u203e',
-    'OverBrace;': '\u23de',
-    'OverBracket;': '\u23b4',
-    'OverParenthesis;': '\u23dc',
-    'par;': '\u2225',
-    'para': '\xb6',
-    'para;': '\xb6',
-    'parallel;': '\u2225',
-    'parsim;': '\u2af3',
-    'parsl;': '\u2afd',
-    'part;': '\u2202',
-    'PartialD;': '\u2202',
-    'Pcy;': '\u041f',
-    'pcy;': '\u043f',
-    'percnt;': '%',
-    'period;': '.',
-    'permil;': '\u2030',
-    'perp;': '\u22a5',
-    'pertenk;': '\u2031',
-    'Pfr;': '\U0001d513',
-    'pfr;': '\U0001d52d',
-    'Phi;': '\u03a6',
-    'phi;': '\u03c6',
-    'phiv;': '\u03d5',
-    'phmmat;': '\u2133',
-    'phone;': '\u260e',
-    'Pi;': '\u03a0',
-    'pi;': '\u03c0',
-    'pitchfork;': '\u22d4',
-    'piv;': '\u03d6',
-    'planck;': '\u210f',
-    'planckh;': '\u210e',
-    'plankv;': '\u210f',
-    'plus;': '+',
-    'plusacir;': '\u2a23',
-    'plusb;': '\u229e',
-    'pluscir;': '\u2a22',
-    'plusdo;': '\u2214',
-    'plusdu;': '\u2a25',
-    'pluse;': '\u2a72',
-    'PlusMinus;': '\xb1',
-    'plusmn': '\xb1',
-    'plusmn;': '\xb1',
-    'plussim;': '\u2a26',
-    'plustwo;': '\u2a27',
-    'pm;': '\xb1',
-    'Poincareplane;': '\u210c',
-    'pointint;': '\u2a15',
-    'Popf;': '\u2119',
-    'popf;': '\U0001d561',
-    'pound': '\xa3',
-    'pound;': '\xa3',
-    'Pr;': '\u2abb',
-    'pr;': '\u227a',
-    'prap;': '\u2ab7',
-    'prcue;': '\u227c',
-    'prE;': '\u2ab3',
-    'pre;': '\u2aaf',
-    'prec;': '\u227a',
-    'precapprox;': '\u2ab7',
-    'preccurlyeq;': '\u227c',
-    'Precedes;': '\u227a',
-    'PrecedesEqual;': '\u2aaf',
-    'PrecedesSlantEqual;': '\u227c',
-    'PrecedesTilde;': '\u227e',
-    'preceq;': '\u2aaf',
-    'precnapprox;': '\u2ab9',
-    'precneqq;': '\u2ab5',
-    'precnsim;': '\u22e8',
-    'precsim;': '\u227e',
-    'Prime;': '\u2033',
-    'prime;': '\u2032',
-    'primes;': '\u2119',
-    'prnap;': '\u2ab9',
-    'prnE;': '\u2ab5',
-    'prnsim;': '\u22e8',
-    'prod;': '\u220f',
-    'Product;': '\u220f',
-    'profalar;': '\u232e',
-    'profline;': '\u2312',
-    'profsurf;': '\u2313',
-    'prop;': '\u221d',
-    'Proportion;': '\u2237',
-    'Proportional;': '\u221d',
-    'propto;': '\u221d',
-    'prsim;': '\u227e',
-    'prurel;': '\u22b0',
-    'Pscr;': '\U0001d4ab',
-    'pscr;': '\U0001d4c5',
-    'Psi;': '\u03a8',
-    'psi;': '\u03c8',
-    'puncsp;': '\u2008',
-    'Qfr;': '\U0001d514',
-    'qfr;': '\U0001d52e',
-    'qint;': '\u2a0c',
-    'Qopf;': '\u211a',
-    'qopf;': '\U0001d562',
-    'qprime;': '\u2057',
-    'Qscr;': '\U0001d4ac',
-    'qscr;': '\U0001d4c6',
-    'quaternions;': '\u210d',
-    'quatint;': '\u2a16',
-    'quest;': '?',
-    'questeq;': '\u225f',
-    'QUOT': '"',
-    'quot': '"',
-    'QUOT;': '"',
-    'quot;': '"',
-    'rAarr;': '\u21db',
-    'race;': '\u223d\u0331',
-    'Racute;': '\u0154',
-    'racute;': '\u0155',
-    'radic;': '\u221a',
-    'raemptyv;': '\u29b3',
-    'Rang;': '\u27eb',
-    'rang;': '\u27e9',
-    'rangd;': '\u2992',
-    'range;': '\u29a5',
-    'rangle;': '\u27e9',
-    'raquo': '\xbb',
-    'raquo;': '\xbb',
-    'Rarr;': '\u21a0',
-    'rArr;': '\u21d2',
-    'rarr;': '\u2192',
-    'rarrap;': '\u2975',
-    'rarrb;': '\u21e5',
-    'rarrbfs;': '\u2920',
-    'rarrc;': '\u2933',
-    'rarrfs;': '\u291e',
-    'rarrhk;': '\u21aa',
-    'rarrlp;': '\u21ac',
-    'rarrpl;': '\u2945',
-    'rarrsim;': '\u2974',
-    'Rarrtl;': '\u2916',
-    'rarrtl;': '\u21a3',
-    'rarrw;': '\u219d',
-    'rAtail;': '\u291c',
-    'ratail;': '\u291a',
-    'ratio;': '\u2236',
-    'rationals;': '\u211a',
-    'RBarr;': '\u2910',
-    'rBarr;': '\u290f',
-    'rbarr;': '\u290d',
-    'rbbrk;': '\u2773',
-    'rbrace;': '}',
-    'rbrack;': ']',
-    'rbrke;': '\u298c',
-    'rbrksld;': '\u298e',
-    'rbrkslu;': '\u2990',
-    'Rcaron;': '\u0158',
-    'rcaron;': '\u0159',
-    'Rcedil;': '\u0156',
-    'rcedil;': '\u0157',
-    'rceil;': '\u2309',
-    'rcub;': '}',
-    'Rcy;': '\u0420',
-    'rcy;': '\u0440',
-    'rdca;': '\u2937',
-    'rdldhar;': '\u2969',
-    'rdquo;': '\u201d',
-    'rdquor;': '\u201d',
-    'rdsh;': '\u21b3',
-    'Re;': '\u211c',
-    'real;': '\u211c',
-    'realine;': '\u211b',
-    'realpart;': '\u211c',
-    'reals;': '\u211d',
-    'rect;': '\u25ad',
-    'REG': '\xae',
-    'reg': '\xae',
-    'REG;': '\xae',
-    'reg;': '\xae',
-    'ReverseElement;': '\u220b',
-    'ReverseEquilibrium;': '\u21cb',
-    'ReverseUpEquilibrium;': '\u296f',
-    'rfisht;': '\u297d',
-    'rfloor;': '\u230b',
-    'Rfr;': '\u211c',
-    'rfr;': '\U0001d52f',
-    'rHar;': '\u2964',
-    'rhard;': '\u21c1',
-    'rharu;': '\u21c0',
-    'rharul;': '\u296c',
-    'Rho;': '\u03a1',
-    'rho;': '\u03c1',
-    'rhov;': '\u03f1',
-    'RightAngleBracket;': '\u27e9',
-    'RightArrow;': '\u2192',
-    'Rightarrow;': '\u21d2',
-    'rightarrow;': '\u2192',
-    'RightArrowBar;': '\u21e5',
-    'RightArrowLeftArrow;': '\u21c4',
-    'rightarrowtail;': '\u21a3',
-    'RightCeiling;': '\u2309',
-    'RightDoubleBracket;': '\u27e7',
-    'RightDownTeeVector;': '\u295d',
-    'RightDownVector;': '\u21c2',
-    'RightDownVectorBar;': '\u2955',
-    'RightFloor;': '\u230b',
-    'rightharpoondown;': '\u21c1',
-    'rightharpoonup;': '\u21c0',
-    'rightleftarrows;': '\u21c4',
-    'rightleftharpoons;': '\u21cc',
-    'rightrightarrows;': '\u21c9',
-    'rightsquigarrow;': '\u219d',
-    'RightTee;': '\u22a2',
-    'RightTeeArrow;': '\u21a6',
-    'RightTeeVector;': '\u295b',
-    'rightthreetimes;': '\u22cc',
-    'RightTriangle;': '\u22b3',
-    'RightTriangleBar;': '\u29d0',
-    'RightTriangleEqual;': '\u22b5',
-    'RightUpDownVector;': '\u294f',
-    'RightUpTeeVector;': '\u295c',
-    'RightUpVector;': '\u21be',
-    'RightUpVectorBar;': '\u2954',
-    'RightVector;': '\u21c0',
-    'RightVectorBar;': '\u2953',
-    'ring;': '\u02da',
-    'risingdotseq;': '\u2253',
-    'rlarr;': '\u21c4',
-    'rlhar;': '\u21cc',
-    'rlm;': '\u200f',
-    'rmoust;': '\u23b1',
-    'rmoustache;': '\u23b1',
-    'rnmid;': '\u2aee',
-    'roang;': '\u27ed',
-    'roarr;': '\u21fe',
-    'robrk;': '\u27e7',
-    'ropar;': '\u2986',
-    'Ropf;': '\u211d',
-    'ropf;': '\U0001d563',
-    'roplus;': '\u2a2e',
-    'rotimes;': '\u2a35',
-    'RoundImplies;': '\u2970',
-    'rpar;': ')',
-    'rpargt;': '\u2994',
-    'rppolint;': '\u2a12',
-    'rrarr;': '\u21c9',
-    'Rrightarrow;': '\u21db',
-    'rsaquo;': '\u203a',
-    'Rscr;': '\u211b',
-    'rscr;': '\U0001d4c7',
-    'Rsh;': '\u21b1',
-    'rsh;': '\u21b1',
-    'rsqb;': ']',
-    'rsquo;': '\u2019',
-    'rsquor;': '\u2019',
-    'rthree;': '\u22cc',
-    'rtimes;': '\u22ca',
-    'rtri;': '\u25b9',
-    'rtrie;': '\u22b5',
-    'rtrif;': '\u25b8',
-    'rtriltri;': '\u29ce',
-    'RuleDelayed;': '\u29f4',
-    'ruluhar;': '\u2968',
-    'rx;': '\u211e',
-    'Sacute;': '\u015a',
-    'sacute;': '\u015b',
-    'sbquo;': '\u201a',
-    'Sc;': '\u2abc',
-    'sc;': '\u227b',
-    'scap;': '\u2ab8',
-    'Scaron;': '\u0160',
-    'scaron;': '\u0161',
-    'sccue;': '\u227d',
-    'scE;': '\u2ab4',
-    'sce;': '\u2ab0',
-    'Scedil;': '\u015e',
-    'scedil;': '\u015f',
-    'Scirc;': '\u015c',
-    'scirc;': '\u015d',
-    'scnap;': '\u2aba',
-    'scnE;': '\u2ab6',
-    'scnsim;': '\u22e9',
-    'scpolint;': '\u2a13',
-    'scsim;': '\u227f',
-    'Scy;': '\u0421',
-    'scy;': '\u0441',
-    'sdot;': '\u22c5',
-    'sdotb;': '\u22a1',
-    'sdote;': '\u2a66',
-    'searhk;': '\u2925',
-    'seArr;': '\u21d8',
-    'searr;': '\u2198',
-    'searrow;': '\u2198',
-    'sect': '\xa7',
-    'sect;': '\xa7',
-    'semi;': ';',
-    'seswar;': '\u2929',
-    'setminus;': '\u2216',
-    'setmn;': '\u2216',
-    'sext;': '\u2736',
-    'Sfr;': '\U0001d516',
-    'sfr;': '\U0001d530',
-    'sfrown;': '\u2322',
-    'sharp;': '\u266f',
-    'SHCHcy;': '\u0429',
-    'shchcy;': '\u0449',
-    'SHcy;': '\u0428',
-    'shcy;': '\u0448',
-    'ShortDownArrow;': '\u2193',
-    'ShortLeftArrow;': '\u2190',
-    'shortmid;': '\u2223',
-    'shortparallel;': '\u2225',
-    'ShortRightArrow;': '\u2192',
-    'ShortUpArrow;': '\u2191',
-    'shy': '\xad',
-    'shy;': '\xad',
-    'Sigma;': '\u03a3',
-    'sigma;': '\u03c3',
-    'sigmaf;': '\u03c2',
-    'sigmav;': '\u03c2',
-    'sim;': '\u223c',
-    'simdot;': '\u2a6a',
-    'sime;': '\u2243',
-    'simeq;': '\u2243',
-    'simg;': '\u2a9e',
-    'simgE;': '\u2aa0',
-    'siml;': '\u2a9d',
-    'simlE;': '\u2a9f',
-    'simne;': '\u2246',
-    'simplus;': '\u2a24',
-    'simrarr;': '\u2972',
-    'slarr;': '\u2190',
-    'SmallCircle;': '\u2218',
-    'smallsetminus;': '\u2216',
-    'smashp;': '\u2a33',
-    'smeparsl;': '\u29e4',
-    'smid;': '\u2223',
-    'smile;': '\u2323',
-    'smt;': '\u2aaa',
-    'smte;': '\u2aac',
-    'smtes;': '\u2aac\ufe00',
-    'SOFTcy;': '\u042c',
-    'softcy;': '\u044c',
-    'sol;': '/',
-    'solb;': '\u29c4',
-    'solbar;': '\u233f',
-    'Sopf;': '\U0001d54a',
-    'sopf;': '\U0001d564',
-    'spades;': '\u2660',
-    'spadesuit;': '\u2660',
-    'spar;': '\u2225',
-    'sqcap;': '\u2293',
-    'sqcaps;': '\u2293\ufe00',
-    'sqcup;': '\u2294',
-    'sqcups;': '\u2294\ufe00',
-    'Sqrt;': '\u221a',
-    'sqsub;': '\u228f',
-    'sqsube;': '\u2291',
-    'sqsubset;': '\u228f',
-    'sqsubseteq;': '\u2291',
-    'sqsup;': '\u2290',
-    'sqsupe;': '\u2292',
-    'sqsupset;': '\u2290',
-    'sqsupseteq;': '\u2292',
-    'squ;': '\u25a1',
-    'Square;': '\u25a1',
-    'square;': '\u25a1',
-    'SquareIntersection;': '\u2293',
-    'SquareSubset;': '\u228f',
-    'SquareSubsetEqual;': '\u2291',
-    'SquareSuperset;': '\u2290',
-    'SquareSupersetEqual;': '\u2292',
-    'SquareUnion;': '\u2294',
-    'squarf;': '\u25aa',
-    'squf;': '\u25aa',
-    'srarr;': '\u2192',
-    'Sscr;': '\U0001d4ae',
-    'sscr;': '\U0001d4c8',
-    'ssetmn;': '\u2216',
-    'ssmile;': '\u2323',
-    'sstarf;': '\u22c6',
-    'Star;': '\u22c6',
-    'star;': '\u2606',
-    'starf;': '\u2605',
-    'straightepsilon;': '\u03f5',
-    'straightphi;': '\u03d5',
-    'strns;': '\xaf',
-    'Sub;': '\u22d0',
-    'sub;': '\u2282',
-    'subdot;': '\u2abd',
-    'subE;': '\u2ac5',
-    'sube;': '\u2286',
-    'subedot;': '\u2ac3',
-    'submult;': '\u2ac1',
-    'subnE;': '\u2acb',
-    'subne;': '\u228a',
-    'subplus;': '\u2abf',
-    'subrarr;': '\u2979',
-    'Subset;': '\u22d0',
-    'subset;': '\u2282',
-    'subseteq;': '\u2286',
-    'subseteqq;': '\u2ac5',
-    'SubsetEqual;': '\u2286',
-    'subsetneq;': '\u228a',
-    'subsetneqq;': '\u2acb',
-    'subsim;': '\u2ac7',
-    'subsub;': '\u2ad5',
-    'subsup;': '\u2ad3',
-    'succ;': '\u227b',
-    'succapprox;': '\u2ab8',
-    'succcurlyeq;': '\u227d',
-    'Succeeds;': '\u227b',
-    'SucceedsEqual;': '\u2ab0',
-    'SucceedsSlantEqual;': '\u227d',
-    'SucceedsTilde;': '\u227f',
-    'succeq;': '\u2ab0',
-    'succnapprox;': '\u2aba',
-    'succneqq;': '\u2ab6',
-    'succnsim;': '\u22e9',
-    'succsim;': '\u227f',
-    'SuchThat;': '\u220b',
-    'Sum;': '\u2211',
-    'sum;': '\u2211',
-    'sung;': '\u266a',
-    'sup1': '\xb9',
-    'sup1;': '\xb9',
-    'sup2': '\xb2',
-    'sup2;': '\xb2',
-    'sup3': '\xb3',
-    'sup3;': '\xb3',
-    'Sup;': '\u22d1',
-    'sup;': '\u2283',
-    'supdot;': '\u2abe',
-    'supdsub;': '\u2ad8',
-    'supE;': '\u2ac6',
-    'supe;': '\u2287',
-    'supedot;': '\u2ac4',
-    'Superset;': '\u2283',
-    'SupersetEqual;': '\u2287',
-    'suphsol;': '\u27c9',
-    'suphsub;': '\u2ad7',
-    'suplarr;': '\u297b',
-    'supmult;': '\u2ac2',
-    'supnE;': '\u2acc',
-    'supne;': '\u228b',
-    'supplus;': '\u2ac0',
-    'Supset;': '\u22d1',
-    'supset;': '\u2283',
-    'supseteq;': '\u2287',
-    'supseteqq;': '\u2ac6',
-    'supsetneq;': '\u228b',
-    'supsetneqq;': '\u2acc',
-    'supsim;': '\u2ac8',
-    'supsub;': '\u2ad4',
-    'supsup;': '\u2ad6',
-    'swarhk;': '\u2926',
-    'swArr;': '\u21d9',
-    'swarr;': '\u2199',
-    'swarrow;': '\u2199',
-    'swnwar;': '\u292a',
-    'szlig': '\xdf',
-    'szlig;': '\xdf',
-    'Tab;': '\t',
-    'target;': '\u2316',
-    'Tau;': '\u03a4',
-    'tau;': '\u03c4',
-    'tbrk;': '\u23b4',
-    'Tcaron;': '\u0164',
-    'tcaron;': '\u0165',
-    'Tcedil;': '\u0162',
-    'tcedil;': '\u0163',
-    'Tcy;': '\u0422',
-    'tcy;': '\u0442',
-    'tdot;': '\u20db',
-    'telrec;': '\u2315',
-    'Tfr;': '\U0001d517',
-    'tfr;': '\U0001d531',
-    'there4;': '\u2234',
-    'Therefore;': '\u2234',
-    'therefore;': '\u2234',
-    'Theta;': '\u0398',
-    'theta;': '\u03b8',
-    'thetasym;': '\u03d1',
-    'thetav;': '\u03d1',
-    'thickapprox;': '\u2248',
-    'thicksim;': '\u223c',
-    'ThickSpace;': '\u205f\u200a',
-    'thinsp;': '\u2009',
-    'ThinSpace;': '\u2009',
-    'thkap;': '\u2248',
-    'thksim;': '\u223c',
-    'THORN': '\xde',
-    'thorn': '\xfe',
-    'THORN;': '\xde',
-    'thorn;': '\xfe',
-    'Tilde;': '\u223c',
-    'tilde;': '\u02dc',
-    'TildeEqual;': '\u2243',
-    'TildeFullEqual;': '\u2245',
-    'TildeTilde;': '\u2248',
-    'times': '\xd7',
-    'times;': '\xd7',
-    'timesb;': '\u22a0',
-    'timesbar;': '\u2a31',
-    'timesd;': '\u2a30',
-    'tint;': '\u222d',
-    'toea;': '\u2928',
-    'top;': '\u22a4',
-    'topbot;': '\u2336',
-    'topcir;': '\u2af1',
-    'Topf;': '\U0001d54b',
-    'topf;': '\U0001d565',
-    'topfork;': '\u2ada',
-    'tosa;': '\u2929',
-    'tprime;': '\u2034',
-    'TRADE;': '\u2122',
-    'trade;': '\u2122',
-    'triangle;': '\u25b5',
-    'triangledown;': '\u25bf',
-    'triangleleft;': '\u25c3',
-    'trianglelefteq;': '\u22b4',
-    'triangleq;': '\u225c',
-    'triangleright;': '\u25b9',
-    'trianglerighteq;': '\u22b5',
-    'tridot;': '\u25ec',
-    'trie;': '\u225c',
-    'triminus;': '\u2a3a',
-    'TripleDot;': '\u20db',
-    'triplus;': '\u2a39',
-    'trisb;': '\u29cd',
-    'tritime;': '\u2a3b',
-    'trpezium;': '\u23e2',
-    'Tscr;': '\U0001d4af',
-    'tscr;': '\U0001d4c9',
-    'TScy;': '\u0426',
-    'tscy;': '\u0446',
-    'TSHcy;': '\u040b',
-    'tshcy;': '\u045b',
-    'Tstrok;': '\u0166',
-    'tstrok;': '\u0167',
-    'twixt;': '\u226c',
-    'twoheadleftarrow;': '\u219e',
-    'twoheadrightarrow;': '\u21a0',
-    'Uacute': '\xda',
-    'uacute': '\xfa',
-    'Uacute;': '\xda',
-    'uacute;': '\xfa',
-    'Uarr;': '\u219f',
-    'uArr;': '\u21d1',
-    'uarr;': '\u2191',
-    'Uarrocir;': '\u2949',
-    'Ubrcy;': '\u040e',
-    'ubrcy;': '\u045e',
-    'Ubreve;': '\u016c',
-    'ubreve;': '\u016d',
-    'Ucirc': '\xdb',
-    'ucirc': '\xfb',
-    'Ucirc;': '\xdb',
-    'ucirc;': '\xfb',
-    'Ucy;': '\u0423',
-    'ucy;': '\u0443',
-    'udarr;': '\u21c5',
-    'Udblac;': '\u0170',
-    'udblac;': '\u0171',
-    'udhar;': '\u296e',
-    'ufisht;': '\u297e',
-    'Ufr;': '\U0001d518',
-    'ufr;': '\U0001d532',
-    'Ugrave': '\xd9',
-    'ugrave': '\xf9',
-    'Ugrave;': '\xd9',
-    'ugrave;': '\xf9',
-    'uHar;': '\u2963',
-    'uharl;': '\u21bf',
-    'uharr;': '\u21be',
-    'uhblk;': '\u2580',
-    'ulcorn;': '\u231c',
-    'ulcorner;': '\u231c',
-    'ulcrop;': '\u230f',
-    'ultri;': '\u25f8',
-    'Umacr;': '\u016a',
-    'umacr;': '\u016b',
-    'uml': '\xa8',
-    'uml;': '\xa8',
-    'UnderBar;': '_',
-    'UnderBrace;': '\u23df',
-    'UnderBracket;': '\u23b5',
-    'UnderParenthesis;': '\u23dd',
-    'Union;': '\u22c3',
-    'UnionPlus;': '\u228e',
-    'Uogon;': '\u0172',
-    'uogon;': '\u0173',
-    'Uopf;': '\U0001d54c',
-    'uopf;': '\U0001d566',
-    'UpArrow;': '\u2191',
-    'Uparrow;': '\u21d1',
-    'uparrow;': '\u2191',
-    'UpArrowBar;': '\u2912',
-    'UpArrowDownArrow;': '\u21c5',
-    'UpDownArrow;': '\u2195',
-    'Updownarrow;': '\u21d5',
-    'updownarrow;': '\u2195',
-    'UpEquilibrium;': '\u296e',
-    'upharpoonleft;': '\u21bf',
-    'upharpoonright;': '\u21be',
-    'uplus;': '\u228e',
-    'UpperLeftArrow;': '\u2196',
-    'UpperRightArrow;': '\u2197',
-    'Upsi;': '\u03d2',
-    'upsi;': '\u03c5',
-    'upsih;': '\u03d2',
-    'Upsilon;': '\u03a5',
-    'upsilon;': '\u03c5',
-    'UpTee;': '\u22a5',
-    'UpTeeArrow;': '\u21a5',
-    'upuparrows;': '\u21c8',
-    'urcorn;': '\u231d',
-    'urcorner;': '\u231d',
-    'urcrop;': '\u230e',
-    'Uring;': '\u016e',
-    'uring;': '\u016f',
-    'urtri;': '\u25f9',
-    'Uscr;': '\U0001d4b0',
-    'uscr;': '\U0001d4ca',
-    'utdot;': '\u22f0',
-    'Utilde;': '\u0168',
-    'utilde;': '\u0169',
-    'utri;': '\u25b5',
-    'utrif;': '\u25b4',
-    'uuarr;': '\u21c8',
-    'Uuml': '\xdc',
-    'uuml': '\xfc',
-    'Uuml;': '\xdc',
-    'uuml;': '\xfc',
-    'uwangle;': '\u29a7',
-    'vangrt;': '\u299c',
-    'varepsilon;': '\u03f5',
-    'varkappa;': '\u03f0',
-    'varnothing;': '\u2205',
-    'varphi;': '\u03d5',
-    'varpi;': '\u03d6',
-    'varpropto;': '\u221d',
-    'vArr;': '\u21d5',
-    'varr;': '\u2195',
-    'varrho;': '\u03f1',
-    'varsigma;': '\u03c2',
-    'varsubsetneq;': '\u228a\ufe00',
-    'varsubsetneqq;': '\u2acb\ufe00',
-    'varsupsetneq;': '\u228b\ufe00',
-    'varsupsetneqq;': '\u2acc\ufe00',
-    'vartheta;': '\u03d1',
-    'vartriangleleft;': '\u22b2',
-    'vartriangleright;': '\u22b3',
-    'Vbar;': '\u2aeb',
-    'vBar;': '\u2ae8',
-    'vBarv;': '\u2ae9',
-    'Vcy;': '\u0412',
-    'vcy;': '\u0432',
-    'VDash;': '\u22ab',
-    'Vdash;': '\u22a9',
-    'vDash;': '\u22a8',
-    'vdash;': '\u22a2',
-    'Vdashl;': '\u2ae6',
-    'Vee;': '\u22c1',
-    'vee;': '\u2228',
-    'veebar;': '\u22bb',
-    'veeeq;': '\u225a',
-    'vellip;': '\u22ee',
-    'Verbar;': '\u2016',
-    'verbar;': '|',
-    'Vert;': '\u2016',
-    'vert;': '|',
-    'VerticalBar;': '\u2223',
-    'VerticalLine;': '|',
-    'VerticalSeparator;': '\u2758',
-    'VerticalTilde;': '\u2240',
-    'VeryThinSpace;': '\u200a',
-    'Vfr;': '\U0001d519',
-    'vfr;': '\U0001d533',
-    'vltri;': '\u22b2',
-    'vnsub;': '\u2282\u20d2',
-    'vnsup;': '\u2283\u20d2',
-    'Vopf;': '\U0001d54d',
-    'vopf;': '\U0001d567',
-    'vprop;': '\u221d',
-    'vrtri;': '\u22b3',
-    'Vscr;': '\U0001d4b1',
-    'vscr;': '\U0001d4cb',
-    'vsubnE;': '\u2acb\ufe00',
-    'vsubne;': '\u228a\ufe00',
-    'vsupnE;': '\u2acc\ufe00',
-    'vsupne;': '\u228b\ufe00',
-    'Vvdash;': '\u22aa',
-    'vzigzag;': '\u299a',
-    'Wcirc;': '\u0174',
-    'wcirc;': '\u0175',
-    'wedbar;': '\u2a5f',
-    'Wedge;': '\u22c0',
-    'wedge;': '\u2227',
-    'wedgeq;': '\u2259',
-    'weierp;': '\u2118',
-    'Wfr;': '\U0001d51a',
-    'wfr;': '\U0001d534',
-    'Wopf;': '\U0001d54e',
-    'wopf;': '\U0001d568',
-    'wp;': '\u2118',
-    'wr;': '\u2240',
-    'wreath;': '\u2240',
-    'Wscr;': '\U0001d4b2',
-    'wscr;': '\U0001d4cc',
-    'xcap;': '\u22c2',
-    'xcirc;': '\u25ef',
-    'xcup;': '\u22c3',
-    'xdtri;': '\u25bd',
-    'Xfr;': '\U0001d51b',
-    'xfr;': '\U0001d535',
-    'xhArr;': '\u27fa',
-    'xharr;': '\u27f7',
-    'Xi;': '\u039e',
-    'xi;': '\u03be',
-    'xlArr;': '\u27f8',
-    'xlarr;': '\u27f5',
-    'xmap;': '\u27fc',
-    'xnis;': '\u22fb',
-    'xodot;': '\u2a00',
-    'Xopf;': '\U0001d54f',
-    'xopf;': '\U0001d569',
-    'xoplus;': '\u2a01',
-    'xotime;': '\u2a02',
-    'xrArr;': '\u27f9',
-    'xrarr;': '\u27f6',
-    'Xscr;': '\U0001d4b3',
-    'xscr;': '\U0001d4cd',
-    'xsqcup;': '\u2a06',
-    'xuplus;': '\u2a04',
-    'xutri;': '\u25b3',
-    'xvee;': '\u22c1',
-    'xwedge;': '\u22c0',
-    'Yacute': '\xdd',
-    'yacute': '\xfd',
-    'Yacute;': '\xdd',
-    'yacute;': '\xfd',
-    'YAcy;': '\u042f',
-    'yacy;': '\u044f',
-    'Ycirc;': '\u0176',
-    'ycirc;': '\u0177',
-    'Ycy;': '\u042b',
-    'ycy;': '\u044b',
-    'yen': '\xa5',
-    'yen;': '\xa5',
-    'Yfr;': '\U0001d51c',
-    'yfr;': '\U0001d536',
-    'YIcy;': '\u0407',
-    'yicy;': '\u0457',
-    'Yopf;': '\U0001d550',
-    'yopf;': '\U0001d56a',
-    'Yscr;': '\U0001d4b4',
-    'yscr;': '\U0001d4ce',
-    'YUcy;': '\u042e',
-    'yucy;': '\u044e',
-    'yuml': '\xff',
-    'Yuml;': '\u0178',
-    'yuml;': '\xff',
-    'Zacute;': '\u0179',
-    'zacute;': '\u017a',
-    'Zcaron;': '\u017d',
-    'zcaron;': '\u017e',
-    'Zcy;': '\u0417',
-    'zcy;': '\u0437',
-    'Zdot;': '\u017b',
-    'zdot;': '\u017c',
-    'zeetrf;': '\u2128',
-    'ZeroWidthSpace;': '\u200b',
-    'Zeta;': '\u0396',
-    'zeta;': '\u03b6',
-    'Zfr;': '\u2128',
-    'zfr;': '\U0001d537',
-    'ZHcy;': '\u0416',
-    'zhcy;': '\u0436',
-    'zigrarr;': '\u21dd',
-    'Zopf;': '\u2124',
-    'zopf;': '\U0001d56b',
-    'Zscr;': '\U0001d4b5',
-    'zscr;': '\U0001d4cf',
-    'zwj;': '\u200d',
-    'zwnj;': '\u200c',
-}
-
+from html.entities import html5
 
 class EntitySubstitution(object):
     """The ability to substitute XML or HTML entities for certain characters."""
diff --git a/lib/bs4/diagnose.py b/lib/bs4/diagnose.py
index 500e92df..3bf583f5 100644
--- a/lib/bs4/diagnose.py
+++ b/lib/bs4/diagnose.py
@@ -4,7 +4,7 @@
 __license__ = "MIT"
 
 import cProfile
-from io import StringIO
+from io import BytesIO
 from html.parser import HTMLParser
 import bs4
 from bs4 import BeautifulSoup, __version__
@@ -103,7 +103,13 @@ def lxml_trace(data, html=True, **kwargs):
        if False, lxml's XML parser will be used.
     """
     from lxml import etree
-    for event, element in etree.iterparse(StringIO(data), html=html, **kwargs):
+    recover = kwargs.pop('recover', True)
+    if isinstance(data, str):
+        data = data.encode("utf8")
+    reader = BytesIO(data)
+    for event, element in etree.iterparse(
+        reader, html=html, recover=recover, **kwargs
+    ):
         print(("%s, %4s, %s" % (event, element.tag, element.text)))
 
 class AnnouncingParser(HTMLParser):
diff --git a/lib/bs4/element.py b/lib/bs4/element.py
index 82a986e4..74b1dc0f 100644
--- a/lib/bs4/element.py
+++ b/lib/bs4/element.py
@@ -23,7 +23,6 @@ from bs4.formatter import (
 )
 
 DEFAULT_OUTPUT_ENCODING = "utf-8"
-PY3K = (sys.version_info[0] > 2)
 
 nonwhitespace_re = re.compile(r"\S+")
 
@@ -555,7 +554,7 @@ class PageElement(object):
             parent.insert(index+1+offset, successor)
             offset += 1
 
-    def find_next(self, name=None, attrs={}, text=None, **kwargs):
+    def find_next(self, name=None, attrs={}, string=None, **kwargs):
         """Find the first PageElement that matches the given criteria and
         appears later in the document than this PageElement.
 
@@ -564,15 +563,15 @@ class PageElement(object):
 
         :param name: A filter on tag name.
         :param attrs: A dictionary of filters on attribute values.
-        :param text: A filter for a NavigableString with specific text.
+        :param string: A filter for a NavigableString with specific text.
         :kwargs: A dictionary of filters on attribute values.
         :return: A PageElement.
         :rtype: bs4.element.Tag | bs4.element.NavigableString
         """
-        return self._find_one(self.find_all_next, name, attrs, text, **kwargs)
+        return self._find_one(self.find_all_next, name, attrs, string, **kwargs)
     findNext = find_next  # BS3
 
-    def find_all_next(self, name=None, attrs={}, text=None, limit=None,
+    def find_all_next(self, name=None, attrs={}, string=None, limit=None,
                     **kwargs):
         """Find all PageElements that match the given criteria and appear
         later in the document than this PageElement.
@@ -582,16 +581,16 @@ class PageElement(object):
 
         :param name: A filter on tag name.
         :param attrs: A dictionary of filters on attribute values.
-        :param text: A filter for a NavigableString with specific text.
+        :param string: A filter for a NavigableString with specific text.
         :param limit: Stop looking after finding this many results.
         :kwargs: A dictionary of filters on attribute values.
         :return: A ResultSet containing PageElements.
         """
-        return self._find_all(name, attrs, text, limit, self.next_elements,
+        return self._find_all(name, attrs, string, limit, self.next_elements,
                              **kwargs)
     findAllNext = find_all_next  # BS3
 
-    def find_next_sibling(self, name=None, attrs={}, text=None, **kwargs):
+    def find_next_sibling(self, name=None, attrs={}, string=None, **kwargs):
         """Find the closest sibling to this PageElement that matches the
         given criteria and appears later in the document.
 
@@ -600,16 +599,16 @@ class PageElement(object):
 
         :param name: A filter on tag name.
         :param attrs: A dictionary of filters on attribute values.
-        :param text: A filter for a NavigableString with specific text.
+        :param string: A filter for a NavigableString with specific text.
         :kwargs: A dictionary of filters on attribute values.
         :return: A PageElement.
         :rtype: bs4.element.Tag | bs4.element.NavigableString
         """
-        return self._find_one(self.find_next_siblings, name, attrs, text,
+        return self._find_one(self.find_next_siblings, name, attrs, string,
                              **kwargs)
     findNextSibling = find_next_sibling  # BS3
 
-    def find_next_siblings(self, name=None, attrs={}, text=None, limit=None,
+    def find_next_siblings(self, name=None, attrs={}, string=None, limit=None,
                            **kwargs):
         """Find all siblings of this PageElement that match the given criteria
         and appear later in the document.
@@ -619,18 +618,18 @@ class PageElement(object):
 
         :param name: A filter on tag name.
         :param attrs: A dictionary of filters on attribute values.
-        :param text: A filter for a NavigableString with specific text.
+        :param string: A filter for a NavigableString with specific text.
         :param limit: Stop looking after finding this many results.
         :kwargs: A dictionary of filters on attribute values.
         :return: A ResultSet of PageElements.
         :rtype: bs4.element.ResultSet
         """
-        return self._find_all(name, attrs, text, limit,
+        return self._find_all(name, attrs, string, limit,
                               self.next_siblings, **kwargs)
     findNextSiblings = find_next_siblings   # BS3
     fetchNextSiblings = find_next_siblings  # BS2
 
-    def find_previous(self, name=None, attrs={}, text=None, **kwargs):
+    def find_previous(self, name=None, attrs={}, string=None, **kwargs):
         """Look backwards in the document from this PageElement and find the
         first PageElement that matches the given criteria.
 
@@ -639,16 +638,16 @@ class PageElement(object):
 
         :param name: A filter on tag name.
         :param attrs: A dictionary of filters on attribute values.
-        :param text: A filter for a NavigableString with specific text.
+        :param string: A filter for a NavigableString with specific text.
         :kwargs: A dictionary of filters on attribute values.
         :return: A PageElement.
         :rtype: bs4.element.Tag | bs4.element.NavigableString
         """
         return self._find_one(
-            self.find_all_previous, name, attrs, text, **kwargs)
+            self.find_all_previous, name, attrs, string, **kwargs)
     findPrevious = find_previous  # BS3
 
-    def find_all_previous(self, name=None, attrs={}, text=None, limit=None,
+    def find_all_previous(self, name=None, attrs={}, string=None, limit=None,
                         **kwargs):
         """Look backwards in the document from this PageElement and find all
         PageElements that match the given criteria.
@@ -658,18 +657,18 @@ class PageElement(object):
 
         :param name: A filter on tag name.
         :param attrs: A dictionary of filters on attribute values.
-        :param text: A filter for a NavigableString with specific text.
+        :param string: A filter for a NavigableString with specific text.
         :param limit: Stop looking after finding this many results.
         :kwargs: A dictionary of filters on attribute values.
         :return: A ResultSet of PageElements.
         :rtype: bs4.element.ResultSet
         """
-        return self._find_all(name, attrs, text, limit, self.previous_elements,
+        return self._find_all(name, attrs, string, limit, self.previous_elements,
                            **kwargs)
     findAllPrevious = find_all_previous  # BS3
     fetchPrevious = find_all_previous    # BS2
 
-    def find_previous_sibling(self, name=None, attrs={}, text=None, **kwargs):
+    def find_previous_sibling(self, name=None, attrs={}, string=None, **kwargs):
         """Returns the closest sibling to this PageElement that matches the
         given criteria and appears earlier in the document.
 
@@ -678,16 +677,16 @@ class PageElement(object):
 
         :param name: A filter on tag name.
         :param attrs: A dictionary of filters on attribute values.
-        :param text: A filter for a NavigableString with specific text.
+        :param string: A filter for a NavigableString with specific text.
         :kwargs: A dictionary of filters on attribute values.
         :return: A PageElement.
         :rtype: bs4.element.Tag | bs4.element.NavigableString
         """
-        return self._find_one(self.find_previous_siblings, name, attrs, text,
+        return self._find_one(self.find_previous_siblings, name, attrs, string,
                              **kwargs)
     findPreviousSibling = find_previous_sibling  # BS3
 
-    def find_previous_siblings(self, name=None, attrs={}, text=None,
+    def find_previous_siblings(self, name=None, attrs={}, string=None,
                                limit=None, **kwargs):
         """Returns all siblings to this PageElement that match the
         given criteria and appear earlier in the document.
@@ -697,13 +696,13 @@ class PageElement(object):
 
         :param name: A filter on tag name.
         :param attrs: A dictionary of filters on attribute values.
-        :param text: A filter for a NavigableString with specific text.
+        :param string: A filter for a NavigableString with specific text.
         :param limit: Stop looking after finding this many results.
         :kwargs: A dictionary of filters on attribute values.
         :return: A ResultSet of PageElements.
         :rtype: bs4.element.ResultSet
         """
-        return self._find_all(name, attrs, text, limit,
+        return self._find_all(name, attrs, string, limit,
                               self.previous_siblings, **kwargs)
     findPreviousSiblings = find_previous_siblings   # BS3
     fetchPreviousSiblings = find_previous_siblings  # BS2
@@ -770,26 +769,29 @@ class PageElement(object):
 
     #These methods do the real heavy lifting.
 
-    def _find_one(self, method, name, attrs, text, **kwargs):
+    def _find_one(self, method, name, attrs, string, **kwargs):
         r = None
-        l = method(name, attrs, text, 1, **kwargs)
+        l = method(name, attrs, string, 1, **kwargs)
         if l:
             r = l[0]
         return r
 
-    def _find_all(self, name, attrs, text, limit, generator, **kwargs):
+    def _find_all(self, name, attrs, string, limit, generator, **kwargs):
         "Iterates over a generator looking for things that match."
 
-        if text is None and 'string' in kwargs:
-            text = kwargs['string']
-            del kwargs['string']
+        if string is None and 'text' in kwargs:
+            string = kwargs.pop('text')
+            warnings.warn(
+                "The 'text' argument to find()-type methods is deprecated. Use 'string' instead.",
+                DeprecationWarning
+            )
 
         if isinstance(name, SoupStrainer):
             strainer = name
         else:
-            strainer = SoupStrainer(name, attrs, text, **kwargs)
+            strainer = SoupStrainer(name, attrs, string, **kwargs)
 
-        if text is None and not limit and not attrs and not kwargs:
+        if string is None and not limit and not attrs and not kwargs:
             if name is True or name is None:
                 # Optimization to find all tags.
                 result = (element for element in generator
@@ -1013,6 +1015,11 @@ class NavigableString(str, PageElement):
 
         # Do nothing if the caller is looking for specific types of
         # string, and we're of a different type.
+        #
+        # We check specific types instead of using isinstance(self,
+        # types) because all of these classes subclass
+        # NavigableString. Anyone who's using this feature probably
+        # wants generic NavigableStrings but not other stuff.
         my_type = type(self)
         if types is not None:
             if isinstance(types, type):
@@ -1141,6 +1148,27 @@ class TemplateString(NavigableString):
     pass
 
 
+class RubyTextString(NavigableString):
+    """A NavigableString representing the contents of the <rt> HTML
+    element.
+
+    https://dev.w3.org/html5/spec-LC/text-level-semantics.html#the-rt-element
+
+    Can be used to distinguish such strings from the strings they're
+    annotating.
+    """
+    pass
+
+
+class RubyParenthesisString(NavigableString):
+    """A NavigableString representing the contents of the <rp> HTML
+    element.
+
+    https://dev.w3.org/html5/spec-LC/text-level-semantics.html#the-rp-element
+    """
+    pass
+
+
 class Tag(PageElement):
     """Represents an HTML or XML tag that is part of a parse tree, along
     with its attributes and contents.
@@ -1155,6 +1183,7 @@ class Tag(PageElement):
                  can_be_empty_element=None, cdata_list_attributes=None,
                  preserve_whitespace_tags=None,
                  interesting_string_types=None,
+                 namespaces=None
     ):
         """Basic constructor.
 
@@ -1187,6 +1216,9 @@ class Tag(PageElement):
             to be considered. The default is to consider
             NavigableString and CData the only interesting string
             subtypes.
+        :param namespaces: A dictionary mapping currently active
+            namespace prefixes to URIs. This can be used later to
+            construct CSS selectors.
         """
         if parser is None:
             self.parser_class = None
@@ -1198,6 +1230,7 @@ class Tag(PageElement):
             raise ValueError("No value provided for new tag's name.")
         self.name = name
         self.namespace = namespace
+        self._namespaces = namespaces or {}
         self.prefix = prefix
         if ((not builder or builder.store_line_numbers)
             and (sourceline is not None or sourcepos is not None)):
@@ -1280,7 +1313,7 @@ class Tag(PageElement):
         for child in self.contents:
             clone.append(child.__copy__())
         return clone
-
+    
     @property
     def is_empty_element(self):
         """Is this tag an empty-element tag? (aka a self-closing tag)
@@ -1524,7 +1557,8 @@ class Tag(PageElement):
             warnings.warn(
                 '.%(name)sTag is deprecated, use .find("%(name)s") instead. If you really were looking for a tag called %(name)sTag, use .find("%(name)sTag")' % dict(
                     name=tag_name
-                )
+                ),
+                DeprecationWarning
             )
             return self.find(tag_name)
         # We special case contents to avoid recursion.
@@ -1558,36 +1592,19 @@ class Tag(PageElement):
     def __repr__(self, encoding="unicode-escape"):
         """Renders this PageElement as a string.
 
-        :param encoding: The encoding to use (Python 2 only).
-        :return: Under Python 2, a bytestring; under Python 3,
-            a Unicode string.
+        :param encoding: The encoding to use (Python 2 only). 
+            TODO: This is now ignored and a warning should be issued
+            if a value is provided.
+        :return: A (Unicode) string.
         """
-        if PY3K:
-            # "The return value must be a string object", i.e. Unicode
-            return self.decode()
-        else:
-            # "The return value must be a string object", i.e. a bytestring.
-            # By convention, the return value of __repr__ should also be
-            # an ASCII string.
-            return self.encode(encoding)
+        # "The return value must be a string object", i.e. Unicode
+        return self.decode()
 
     def __unicode__(self):
         """Renders this PageElement as a Unicode string."""
         return self.decode()
 
-    def __str__(self):
-        """Renders this PageElement as a generic string.
-
-        :return: Under Python 2, a UTF-8 bytestring; under Python 3,
-            a Unicode string.        
-        """
-        if PY3K:
-            return self.decode()
-        else:
-            return self.encode()
-
-    if PY3K:
-        __str__ = __repr__ = __unicode__
+    __str__ = __repr__ = __unicode__
 
     def encode(self, encoding=DEFAULT_OUTPUT_ENCODING,
                indent_level=None, formatter="minimal",
@@ -1597,8 +1614,10 @@ class Tag(PageElement):
 
         :param encoding: The destination encoding.
         :param indent_level: Each line of the rendering will be
-            indented this many spaces. Used internally in
-            recursive calls while pretty-printing.
+           indented this many levels. (The formatter decides what a
+           'level' means in terms of spaces or other characters
+           output.) Used internally in recursive calls while
+           pretty-printing.
         :param formatter: A Formatter object, or a string naming one of
             the standard formatters.
         :param errors: An error handling strategy such as
@@ -1674,7 +1693,7 @@ class Tag(PageElement):
         space = ''
         indent_space = ''
         if indent_level is not None:
-            indent_space = (' ' * (indent_level - 1))
+            indent_space = (formatter.indent * (indent_level - 1))
         if pretty_print:
             space = indent_space
             indent_contents = indent_level + 1
@@ -1749,8 +1768,10 @@ class Tag(PageElement):
         """Renders the contents of this tag as a Unicode string.
 
         :param indent_level: Each line of the rendering will be
-           indented this many spaces. Used internally in
-           recursive calls while pretty-printing.
+           indented this many levels. (The formatter decides what a
+           'level' means in terms of spaces or other characters
+           output.) Used internally in recursive calls while
+           pretty-printing.
 
         :param eventual_encoding: The tag is destined to be
            encoded into this encoding. decode_contents() is _not_
@@ -1761,6 +1782,7 @@ class Tag(PageElement):
 
         :param formatter: A Formatter object, or a string naming one of
             the standard Formatters.
+
         """
         # First off, turn a string formatter into a Formatter object. This
         # will stop the lookup from happening over and over again.
@@ -1783,7 +1805,7 @@ class Tag(PageElement):
                 text = text.strip()
             if text:
                 if pretty_print and not preserve_whitespace:
-                    s.append(" " * (indent_level - 1))
+                    s.append(formatter.indent * (indent_level - 1))
                 s.append(text)
                 if pretty_print and not preserve_whitespace:
                     s.append("\n")
@@ -1795,8 +1817,10 @@ class Tag(PageElement):
         """Renders the contents of this PageElement as a bytestring.
 
         :param indent_level: Each line of the rendering will be
-           indented this many spaces. Used internally in
-           recursive calls while pretty-printing.
+           indented this many levels. (The formatter decides what a
+           'level' means in terms of spaces or other characters
+           output.) Used internally in recursive calls while
+           pretty-printing.
 
         :param eventual_encoding: The bytestring will be in this encoding.
 
@@ -1819,7 +1843,7 @@ class Tag(PageElement):
 
     #Soup methods
 
-    def find(self, name=None, attrs={}, recursive=True, text=None,
+    def find(self, name=None, attrs={}, recursive=True, string=None,
              **kwargs):
         """Look in the children of this PageElement and find the first
         PageElement that matches the given criteria.
@@ -1838,13 +1862,13 @@ class Tag(PageElement):
         :rtype: bs4.element.Tag | bs4.element.NavigableString
         """
         r = None
-        l = self.find_all(name, attrs, recursive, text, 1, **kwargs)
+        l = self.find_all(name, attrs, recursive, string, 1, **kwargs)
         if l:
             r = l[0]
         return r
     findChild = find #BS2
 
-    def find_all(self, name=None, attrs={}, recursive=True, text=None,
+    def find_all(self, name=None, attrs={}, recursive=True, string=None,
                  limit=None, **kwargs):
         """Look in the children of this PageElement and find all
         PageElements that match the given criteria.
@@ -1865,7 +1889,7 @@ class Tag(PageElement):
         generator = self.descendants
         if not recursive:
             generator = self.children
-        return self._find_all(name, attrs, text, limit, generator, **kwargs)
+        return self._find_all(name, attrs, string, limit, generator, **kwargs)
     findAll = find_all       # BS3
     findChildren = find_all  # BS2
 
@@ -1967,8 +1991,10 @@ class Tag(PageElement):
 
         has_key() is gone in Python 3, anyway.
         """
-        warnings.warn('has_key is deprecated. Use has_attr("%s") instead.' % (
-                key))
+        warnings.warn(
+            'has_key is deprecated. Use has_attr(key) instead.',
+            DeprecationWarning
+        )
         return self.has_attr(key)
 
 # Next, a couple classes to represent queries and their results.
@@ -1982,7 +2008,7 @@ class SoupStrainer(object):
     document.
     """
 
-    def __init__(self, name=None, attrs={}, text=None, **kwargs):
+    def __init__(self, name=None, attrs={}, string=None, **kwargs):
         """Constructor.
 
         The SoupStrainer constructor takes the same arguments passed
@@ -1991,9 +2017,16 @@ class SoupStrainer(object):
 
         :param name: A filter on tag name.
         :param attrs: A dictionary of filters on attribute values.
-        :param text: A filter for a NavigableString with specific text.
+        :param string: A filter for a NavigableString with specific text.
         :kwargs: A dictionary of filters on attribute values.
         """        
+        if string is None and 'text' in kwargs:
+            string = kwargs.pop('text')
+            warnings.warn(
+                "The 'text' argument to the SoupStrainer constructor is deprecated. Use 'string' instead.",
+                DeprecationWarning
+            )
+
         self.name = self._normalize_search_value(name)
         if not isinstance(attrs, dict):
             # Treat a non-dict value for attrs as a search for the 'class'
@@ -2018,7 +2051,10 @@ class SoupStrainer(object):
             normalized_attrs[key] = self._normalize_search_value(value)
 
         self.attrs = normalized_attrs
-        self.text = self._normalize_search_value(text)
+        self.string = self._normalize_search_value(string)
+
+        # DEPRECATED but just in case someone is checking this.
+        self.text = self.string
 
     def _normalize_search_value(self, value):
         # Leave it alone if it's a Unicode string, a callable, a
@@ -2052,8 +2088,8 @@ class SoupStrainer(object):
 
     def __str__(self):
         """A human-readable representation of this SoupStrainer."""
-        if self.text:
-            return self.text
+        if self.string:
+            return self.string
         else:
             return "%s|%s" % (self.name, self.attrs)
 
@@ -2113,7 +2149,7 @@ class SoupStrainer(object):
                     found = markup
                 else:
                     found = markup_name
-        if found and self.text and not self._matches(found.string, self.text):
+        if found and self.string and not self._matches(found.string, self.string):
             found = None
         return found
 
@@ -2141,12 +2177,12 @@ class SoupStrainer(object):
         # If it's a Tag, make sure its name or attributes match.
         # Don't bother with Tags if we're searching for text.
         elif isinstance(markup, Tag):
-            if not self.text or self.name or self.attrs:
+            if not self.string or self.name or self.attrs:
                 found = self.search_tag(markup)
         # If it's text, make sure the text matches.
         elif isinstance(markup, NavigableString) or \
                  isinstance(markup, str):
-            if not self.name and not self.attrs and self._matches(markup, self.text):
+            if not self.name and not self.attrs and self._matches(markup, self.string):
                 found = markup
         else:
             raise Exception(
diff --git a/lib/bs4/formatter.py b/lib/bs4/formatter.py
index 3bd9f859..65e57b57 100644
--- a/lib/bs4/formatter.py
+++ b/lib/bs4/formatter.py
@@ -49,7 +49,7 @@ class Formatter(EntitySubstitution):
     def __init__(
             self, language=None, entity_substitution=None,
             void_element_close_prefix='/', cdata_containing_tags=None,
-            empty_attributes_are_booleans=False,
+            empty_attributes_are_booleans=False, indent=1,
     ):
         """Constructor.
 
@@ -69,6 +69,15 @@ class Formatter(EntitySubstitution):
         :param blank_attributes_are_booleans: Render attributes whose value
             is the empty string as HTML-style boolean attributes.
             (Attributes whose value is None are always rendered this way.)
+
+        :param indent: If indent is a non-negative integer or string,
+            then the contents of elements will be indented
+            appropriately when pretty-printing. An indent level of 0,
+            negative, or "" will only insert newlines. Using a
+            positive integer indent indents that many spaces per
+            level. If indent is a string (such as "\t"), that string
+            is used to indent each level. The default behavior to
+            indent one space per level.
         """
         self.language = language
         self.entity_substitution = entity_substitution
@@ -77,6 +86,17 @@ class Formatter(EntitySubstitution):
             language, cdata_containing_tags, 'cdata_containing_tags'
         )
         self.empty_attributes_are_booleans=empty_attributes_are_booleans
+        if indent is None:
+            indent = 0
+        if isinstance(indent, int):
+            if indent < 0:
+                indent = 0
+            indent = ' ' * indent
+        elif isinstance(indent, str):
+            indent = indent
+        else:
+            indent = ' '
+        self.indent = indent
         
     def substitute(self, ns):
         """Process a string that needs to undergo entity substitution.
diff --git a/lib/bs4/testing.py b/lib/bs4/tests/__init__.py
similarity index 78%
rename from lib/bs4/testing.py
rename to lib/bs4/tests/__init__.py
index 2f9046ad..4af4b0ce 100644
--- a/lib/bs4/testing.py
+++ b/lib/bs4/tests/__init__.py
@@ -7,9 +7,8 @@ __license__ = "MIT"
 import pickle
 import copy
 import functools
-import unittest
 import warnings
-from unittest import TestCase
+import pytest
 from bs4 import BeautifulSoup
 from bs4.element import (
     CharsetMetaAttributeValue,
@@ -23,7 +22,11 @@ from bs4.element import (
     Tag
 )
 
-from bs4.builder import HTMLParserTreeBuilder
+from bs4.builder import (
+    DetectsXMLParsedAsHTML,
+    HTMLParserTreeBuilder,
+    XMLParsedAsHTMLWarning,
+)
 default_builder = HTMLParserTreeBuilder
 
 BAD_DOCUMENT = """A bare string
@@ -63,7 +66,7 @@ BAD_DOCUMENT = """A bare string
 """
 
 
-class SoupTest(unittest.TestCase):
+class SoupTest(object):
 
     @property
     def default_builder(self):
@@ -80,15 +83,18 @@ class SoupTest(unittest.TestCase):
         The details depend on the builder.
         """
         return self.default_builder(**kwargs).test_fragment_to_document(markup)
-
-    def assertSoupEquals(self, to_parse, compare_parsed_to=None):
+   
+    def assert_soup(self, to_parse, compare_parsed_to=None):
+        """Parse some markup using Beautiful Soup and verify that
+        the output markup is as expected.
+        """
         builder = self.default_builder
         obj = BeautifulSoup(to_parse, builder=builder)
         if compare_parsed_to is None:
             compare_parsed_to = to_parse
 
         # Verify that the documents come out the same.
-        self.assertEqual(obj.decode(), self.document_for(compare_parsed_to))
+        assert obj.decode() == self.document_for(compare_parsed_to)
 
         # Also run some checks on the BeautifulSoup object itself:
 
@@ -99,9 +105,9 @@ class SoupTest(unittest.TestCase):
 
         # The only tag in the tag stack is the one for the root
         # document.
-        self.assertEqual(
-            [obj.ROOT_TAG_NAME], [x.name for x in obj.tagStack]
-        )
+        assert [obj.ROOT_TAG_NAME] == [x.name for x in obj.tagStack]
+
+    assertSoupEquals = assert_soup
         
     def assertConnectedness(self, element):
         """Ensure that next_element and previous_element are properly
@@ -110,8 +116,8 @@ class SoupTest(unittest.TestCase):
         earlier = None
         for e in element.descendants:
             if earlier:
-                self.assertEqual(e, earlier.next_element)
-                self.assertEqual(earlier, e.previous_element)
+                assert e == earlier.next_element
+                assert earlier == e.previous_element
             earlier = e
 
     def linkage_validator(self, el, _recursive_call=False):
@@ -228,10 +234,47 @@ class SoupTest(unittest.TestCase):
             # Return the child to the recursive caller
             return child
 
+    def assert_selects(self, tags, should_match):
+        """Make sure that the given tags have the correct text.
+
+        This is used in tests that define a bunch of tags, each
+        containing a single string, and then select certain strings by
+        some mechanism.
+        """
+        assert [tag.string for tag in tags] == should_match
+
+    def assert_selects_ids(self, tags, should_match):
+        """Make sure that the given tags have the correct IDs.
+
+        This is used in tests that define a bunch of tags, each
+        containing a single string, and then select certain strings by
+        some mechanism.
+        """
+        assert [tag['id'] for tag in tags] == should_match
+
 
 class TreeBuilderSmokeTest(object):
     # Tests that are common to HTML and XML tree builders.
 
+    @pytest.mark.parametrize(
+        "multi_valued_attributes",
+        [None, dict(b=['class']), {'*': ['notclass']}]
+    )
+    def test_attribute_not_multi_valued(self, multi_valued_attributes):
+        markup = '<a class="a b c">'
+        soup = self.soup(markup, multi_valued_attributes=multi_valued_attributes)
+        assert soup.a['class'] == 'a b c'
+
+    @pytest.mark.parametrize(
+        "multi_valued_attributes", [dict(a=['class']), {'*': ['class']}]
+    )
+    def test_attribute_multi_valued(self, multi_valued_attributes):
+        markup = '<a class="a b c">'
+        soup = self.soup(
+            markup, multi_valued_attributes=multi_valued_attributes
+        )
+        assert soup.a['class'] == ['a', 'b', 'c']
+        
     def test_fuzzed_input(self):
         # This test centralizes in one place the various fuzz tests
         # for Beautiful Soup created by the oss-fuzz project.
@@ -283,7 +326,7 @@ class HTMLTreeBuilderSmokeTest(TreeBuilderSmokeTest):
         ]:
             soup = self.soup("")
             new_tag = soup.new_tag(name)
-            self.assertEqual(True, new_tag.is_empty_element)
+            assert new_tag.is_empty_element == True
 
     def test_special_string_containers(self):
         soup = self.soup(
@@ -298,7 +341,7 @@ class HTMLTreeBuilderSmokeTest(TreeBuilderSmokeTest):
         assert isinstance(soup.style.string, Stylesheet)
         # The contents of the style tag resemble an HTML comment, but
         # it's not treated as a comment.
-        self.assertEqual("<!--Some CSS-->", soup.style.string)
+        assert soup.style.string == "<!--Some CSS-->"
         assert isinstance(soup.style.string, Stylesheet)
         
     def test_pickle_and_unpickle_identity(self):
@@ -307,8 +350,8 @@ class HTMLTreeBuilderSmokeTest(TreeBuilderSmokeTest):
         tree = self.soup("<a><b>foo</a>")
         dumped = pickle.dumps(tree, 2)
         loaded = pickle.loads(dumped)
-        self.assertEqual(loaded.__class__, BeautifulSoup)
-        self.assertEqual(loaded.decode(), tree.decode())
+        assert loaded.__class__ == BeautifulSoup
+        assert loaded.decode() == tree.decode()
 
     def assertDoctypeHandled(self, doctype_fragment):
         """Assert that a given doctype string is handled correctly."""
@@ -316,16 +359,13 @@ class HTMLTreeBuilderSmokeTest(TreeBuilderSmokeTest):
 
         # Make sure a Doctype object was created.
         doctype = soup.contents[0]
-        self.assertEqual(doctype.__class__, Doctype)
-        self.assertEqual(doctype, doctype_fragment)
-        self.assertEqual(
-            soup.encode("utf8")[:len(doctype_str)],
-            doctype_str
-        )
+        assert doctype.__class__ == Doctype
+        assert doctype == doctype_fragment
+        assert soup.encode("utf8")[:len(doctype_str)] == doctype_str
 
         # Make sure that the doctype was correctly associated with the
         # parse tree and that the rest of the document parsed.
-        self.assertEqual(soup.p.contents[0], 'foo')
+        assert soup.p.contents[0] == 'foo'
 
     def _document_with_doctype(self, doctype_fragment, doctype_string="DOCTYPE"):
         """Generate and parse a document with the given doctype."""
@@ -343,7 +383,7 @@ class HTMLTreeBuilderSmokeTest(TreeBuilderSmokeTest):
     def test_empty_doctype(self):
         soup = self.soup("<!DOCTYPE>")
         doctype = soup.contents[0]
-        self.assertEqual("", doctype.strip())
+        assert "" == doctype.strip()
 
     def test_mixed_case_doctype(self):
         # A lowercase or mixed-case doctype becomes a Doctype.
@@ -355,16 +395,13 @@ class HTMLTreeBuilderSmokeTest(TreeBuilderSmokeTest):
             # Make sure a Doctype object was created and that the DOCTYPE
             # is uppercase.
             doctype = soup.contents[0]
-            self.assertEqual(doctype.__class__, Doctype)
-            self.assertEqual(doctype, "html")
-            self.assertEqual(
-                soup.encode("utf8")[:len(doctype_str)],
-                b"<!DOCTYPE html>"
-            )
+            assert doctype.__class__ == Doctype
+            assert doctype == "html"
+            assert soup.encode("utf8")[:len(doctype_str)] == b"<!DOCTYPE html>"
 
             # Make sure that the doctype was correctly associated with the
             # parse tree and that the rest of the document parsed.
-            self.assertEqual(soup.p.contents[0], 'foo')
+            assert soup.p.contents[0] == 'foo'
         
     def test_public_doctype_with_url(self):
         doctype = 'html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"'
@@ -389,18 +426,43 @@ class HTMLTreeBuilderSmokeTest(TreeBuilderSmokeTest):
 <head><title>Hello.</title></head>
 <body>Goodbye.</body>
 </html>"""
-        soup = self.soup(markup)
-        self.assertEqual(
-            soup.encode("utf-8").replace(b"\n", b""),
-            markup.replace(b"\n", b""))
+        with warnings.catch_warnings(record=True) as w:
+            soup = self.soup(markup)
+        assert soup.encode("utf-8").replace(b"\n", b"") == markup.replace(b"\n", b"")
+
+        # No warning was issued about parsing an XML document as HTML,
+        # because XHTML is both.
+        assert w == []
+
 
     def test_namespaced_html(self):
-        """When a namespaced XML document is parsed as HTML it should
-        be treated as HTML with weird tag names.
-        """
+        # When a namespaced XML document is parsed as HTML it should
+        # be treated as HTML with weird tag names.
         markup = b"""<ns1:foo>content</ns1:foo><ns1:foo/><ns2:foo/>"""
-        soup = self.soup(markup)
-        self.assertEqual(2, len(soup.find_all("ns1:foo")))
+        with warnings.catch_warnings(record=True) as w:
+            soup = self.soup(markup)
+
+        assert 2 == len(soup.find_all("ns1:foo"))
+            
+        # n.b. no "you're parsing XML as HTML" warning was given
+        # because there was no XML declaration.
+        assert [] == w
+
+    def test_detect_xml_parsed_as_html(self):
+        # A warning is issued when parsing an XML document as HTML,
+        # but basic stuff should still work.
+        markup = b"""<?xml version="1.0" encoding="utf-8"?><tag>string</tag>"""
+        with warnings.catch_warnings(record=True) as w:
+            soup = self.soup(markup)
+            assert soup.tag.string == 'string'
+        [warning] = w
+        assert isinstance(warning.message, XMLParsedAsHTMLWarning)
+        assert str(warning.message) == XMLParsedAsHTMLWarning.MESSAGE
+
+        # NOTE: the warning is not issued if the document appears to
+        # be XHTML (tested with test_real_xhtml_document in the
+        # superclass) or if there is no XML declaration (tested with
+        # test_namespaced_html in the superclass).
         
     def test_processing_instruction(self):
         # We test both Unicode and bytestring to verify that
@@ -409,11 +471,11 @@ class HTMLTreeBuilderSmokeTest(TreeBuilderSmokeTest):
         # need to process anything.
         markup = """<?PITarget PIContent?>"""
         soup = self.soup(markup)
-        self.assertEqual(markup, soup.decode())
+        assert markup == soup.decode()
 
         markup = b"""<?PITarget PIContent?>"""
         soup = self.soup(markup)
-        self.assertEqual(markup, soup.encode("utf8"))
+        assert markup == soup.encode("utf8")
 
     def test_deepcopy(self):
         """Make sure you can copy the tree builder.
@@ -430,18 +492,18 @@ class HTMLTreeBuilderSmokeTest(TreeBuilderSmokeTest):
         shouldn't be presented that way.
         """
         soup = self.soup("<p/>")
-        self.assertFalse(soup.p.is_empty_element)
-        self.assertEqual(str(soup.p), "<p></p>")
+        assert not soup.p.is_empty_element
+        assert str(soup.p) == "<p></p>"
 
     def test_unclosed_tags_get_closed(self):
         """A tag that's not closed by the end of the document should be closed.
 
         This applies to all tags except empty-element tags.
         """
-        self.assertSoupEquals("<p>", "<p></p>")
-        self.assertSoupEquals("<b>", "<b></b>")
+        self.assert_soup("<p>", "<p></p>")
+        self.assert_soup("<b>", "<b></b>")
 
-        self.assertSoupEquals("<br>", "<br/>")
+        self.assert_soup("<br>", "<br/>")
 
     def test_br_is_always_empty_element_tag(self):
         """A <br> tag is designated as an empty-element tag.
@@ -450,11 +512,11 @@ class HTMLTreeBuilderSmokeTest(TreeBuilderSmokeTest):
         two tags, but it should always be an empty-element tag.
         """
         soup = self.soup("<br></br>")
-        self.assertTrue(soup.br.is_empty_element)
-        self.assertEqual(str(soup.br), "<br/>")
+        assert soup.br.is_empty_element
+        assert str(soup.br) == "<br/>"
 
     def test_nested_formatting_elements(self):
-        self.assertSoupEquals("<em><em></em></em>")
+        self.assert_soup("<em><em></em></em>")
 
     def test_double_head(self):
         html = '''<!DOCTYPE html>
@@ -471,22 +533,22 @@ Hello, world!
 </html>
 '''
         soup = self.soup(html)
-        self.assertEqual("text/javascript", soup.find('script')['type'])
+        assert "text/javascript" == soup.find('script')['type']
 
     def test_comment(self):
         # Comments are represented as Comment objects.
         markup = "<p>foo<!--foobar-->baz</p>"
-        self.assertSoupEquals(markup)
+        self.assert_soup(markup)
 
         soup = self.soup(markup)
-        comment = soup.find(text="foobar")
-        self.assertEqual(comment.__class__, Comment)
+        comment = soup.find(string="foobar")
+        assert comment.__class__ == Comment
 
         # The comment is properly integrated into the tree.
-        foo = soup.find(text="foo")
-        self.assertEqual(comment, foo.next_element)
-        baz = soup.find(text="baz")
-        self.assertEqual(comment, baz.previous_element)
+        foo = soup.find(string="foo")
+        assert comment == foo.next_element
+        baz = soup.find(string="baz")
+        assert comment == baz.previous_element
 
     def test_preserved_whitespace_in_pre_and_textarea(self):
         """Whitespace must be preserved in <pre> and <textarea> tags,
@@ -494,35 +556,35 @@ Hello, world!
         """
         pre_markup = "<pre>   </pre>"
         textarea_markup = "<textarea> woo\nwoo  </textarea>"
-        self.assertSoupEquals(pre_markup)
-        self.assertSoupEquals(textarea_markup)
+        self.assert_soup(pre_markup)
+        self.assert_soup(textarea_markup)
 
         soup = self.soup(pre_markup)
-        self.assertEqual(soup.pre.prettify(), pre_markup)
+        assert soup.pre.prettify() == pre_markup
 
         soup = self.soup(textarea_markup)
-        self.assertEqual(soup.textarea.prettify(), textarea_markup)
+        assert soup.textarea.prettify() == textarea_markup
 
         soup = self.soup("<textarea></textarea>")
-        self.assertEqual(soup.textarea.prettify(), "<textarea></textarea>")
+        assert soup.textarea.prettify() == "<textarea></textarea>"
 
     def test_nested_inline_elements(self):
         """Inline elements can be nested indefinitely."""
         b_tag = "<b>Inside a B tag</b>"
-        self.assertSoupEquals(b_tag)
+        self.assert_soup(b_tag)
 
         nested_b_tag = "<p>A <i>nested <b>tag</b></i></p>"
-        self.assertSoupEquals(nested_b_tag)
+        self.assert_soup(nested_b_tag)
 
         double_nested_b_tag = "<p>A <a>doubly <i>nested <b>tag</b></i></a></p>"
-        self.assertSoupEquals(nested_b_tag)
+        self.assert_soup(nested_b_tag)
 
     def test_nested_block_level_elements(self):
         """Block elements can be nested."""
         soup = self.soup('<blockquote><p><b>Foo</b></p></blockquote>')
         blockquote = soup.blockquote
-        self.assertEqual(blockquote.p.b.string, 'Foo')
-        self.assertEqual(blockquote.b.string, 'Foo')
+        assert blockquote.p.b.string == 'Foo'
+        assert blockquote.b.string == 'Foo'
 
     def test_correctly_nested_tables(self):
         """One table can go inside another one."""
@@ -533,13 +595,13 @@ Hello, world!
                   '<tr><td>foo</td></tr>'
                   '</table></td>')
 
-        self.assertSoupEquals(
+        self.assert_soup(
             markup,
             '<table id="1"><tr><td>Here\'s another table:'
             '<table id="2"><tr><td>foo</td></tr></table>'
             '</td></tr></table>')
 
-        self.assertSoupEquals(
+        self.assert_soup(
             "<table><thead><tr><td>Foo</td></tr></thead>"
             "<tbody><tr><td>Bar</td></tr></tbody>"
             "<tfoot><tr><td>Baz</td></tr></tfoot></table>")
@@ -550,11 +612,11 @@ Hello, world!
 
         markup = '<div class=" foo bar	 "></a>'
         soup = self.soup(markup)
-        self.assertEqual(['foo', 'bar'], soup.div['class'])
+        assert ['foo', 'bar'] == soup.div['class']
 
         # If you search by the literal name of the class it's like the whitespace
         # wasn't there.
-        self.assertEqual(soup.div, soup.find('div', class_="foo bar"))
+        assert soup.div == soup.find('div', class_="foo bar")
         
     def test_deeply_nested_multivalued_attribute(self):
         # html5lib can set the attributes of the same tag many times
@@ -562,7 +624,7 @@ Hello, world!
         # multivalued attributes.
         markup = '<table><div><div class="css"></div></div></table>'
         soup = self.soup(markup)
-        self.assertEqual(["css"], soup.div.div['class'])
+        assert ["css"] == soup.div.div['class']
 
     def test_multivalued_attribute_on_html(self):
         # html5lib uses a different API to set the attributes ot the
@@ -570,21 +632,21 @@ Hello, world!
         # attributes.
         markup = '<html class="a b"></html>'
         soup = self.soup(markup)
-        self.assertEqual(["a", "b"], soup.html['class'])
+        assert ["a", "b"] == soup.html['class']
 
     def test_angle_brackets_in_attribute_values_are_escaped(self):
-        self.assertSoupEquals('<a b="<a>"></a>', '<a b="&lt;a&gt;"></a>')
+        self.assert_soup('<a b="<a>"></a>', '<a b="&lt;a&gt;"></a>')
 
     def test_strings_resembling_character_entity_references(self):
         # "&T" and "&p" look like incomplete character entities, but they are
         # not.
-        self.assertSoupEquals(
+        self.assert_soup(
             "<p>&bull; AT&T is in the s&p 500</p>",
             "<p>\u2022 AT&amp;T is in the s&amp;p 500</p>"
         )
 
     def test_apos_entity(self):
-        self.assertSoupEquals(
+        self.assert_soup(
             "<p>Bob&apos;s Bar</p>",
             "<p>Bob's Bar</p>",
         )
@@ -599,45 +661,45 @@ Hello, world!
         # characters.
         markup = "<p>&#147;Hello&#148; &#45;&#9731;</p>"
         soup = self.soup(markup)
-        self.assertEqual("“Hello” -☃", soup.p.string)
+        assert "“Hello” -☃" == soup.p.string
         
     def test_entities_in_attributes_converted_to_unicode(self):
         expect = '<p id="pi\N{LATIN SMALL LETTER N WITH TILDE}ata"></p>'
-        self.assertSoupEquals('<p id="pi&#241;ata"></p>', expect)
-        self.assertSoupEquals('<p id="pi&#xf1;ata"></p>', expect)
-        self.assertSoupEquals('<p id="pi&#Xf1;ata"></p>', expect)
-        self.assertSoupEquals('<p id="pi&ntilde;ata"></p>', expect)
+        self.assert_soup('<p id="pi&#241;ata"></p>', expect)
+        self.assert_soup('<p id="pi&#xf1;ata"></p>', expect)
+        self.assert_soup('<p id="pi&#Xf1;ata"></p>', expect)
+        self.assert_soup('<p id="pi&ntilde;ata"></p>', expect)
 
     def test_entities_in_text_converted_to_unicode(self):
         expect = '<p>pi\N{LATIN SMALL LETTER N WITH TILDE}ata</p>'
-        self.assertSoupEquals("<p>pi&#241;ata</p>", expect)
-        self.assertSoupEquals("<p>pi&#xf1;ata</p>", expect)
-        self.assertSoupEquals("<p>pi&#Xf1;ata</p>", expect)
-        self.assertSoupEquals("<p>pi&ntilde;ata</p>", expect)
+        self.assert_soup("<p>pi&#241;ata</p>", expect)
+        self.assert_soup("<p>pi&#xf1;ata</p>", expect)
+        self.assert_soup("<p>pi&#Xf1;ata</p>", expect)
+        self.assert_soup("<p>pi&ntilde;ata</p>", expect)
 
     def test_quot_entity_converted_to_quotation_mark(self):
-        self.assertSoupEquals("<p>I said &quot;good day!&quot;</p>",
+        self.assert_soup("<p>I said &quot;good day!&quot;</p>",
                               '<p>I said "good day!"</p>')
 
     def test_out_of_range_entity(self):
         expect = "\N{REPLACEMENT CHARACTER}"
-        self.assertSoupEquals("&#10000000000000;", expect)
-        self.assertSoupEquals("&#x10000000000000;", expect)
-        self.assertSoupEquals("&#1000000000;", expect)
+        self.assert_soup("&#10000000000000;", expect)
+        self.assert_soup("&#x10000000000000;", expect)
+        self.assert_soup("&#1000000000;", expect)
        
     def test_multipart_strings(self):
         "Mostly to prevent a recurrence of a bug in the html5lib treebuilder."
         soup = self.soup("<html><h2>\nfoo</h2><p></p></html>")
-        self.assertEqual("p", soup.h2.string.next_element.name)
-        self.assertEqual("p", soup.p.name)
+        assert "p" == soup.h2.string.next_element.name
+        assert "p" == soup.p.name
         self.assertConnectedness(soup)
 
     def test_empty_element_tags(self):
         """Verify consistent handling of empty-element tags,
         no matter how they come in through the markup.
         """
-        self.assertSoupEquals('<br/><br/><br/>', "<br/><br/><br/>")
-        self.assertSoupEquals('<br /><br /><br />', "<br/><br/><br/>")
+        self.assert_soup('<br/><br/><br/>', "<br/><br/><br/>")
+        self.assert_soup('<br /><br /><br />', "<br/><br/><br/>")
         
     def test_head_tag_between_head_and_body(self):
         "Prevent recurrence of a bug in the html5lib treebuilder."
@@ -647,7 +709,7 @@ Hello, world!
 </html>
 """
         soup = self.soup(content)
-        self.assertNotEqual(None, soup.html.body)
+        assert soup.html.body is not None
         self.assertConnectedness(soup)
 
     def test_multiple_copies_of_a_tag(self):
@@ -674,18 +736,16 @@ Hello, world!
 
         markup = b'<html xmlns="http://www.w3.org/1999/xhtml" xmlns:mathml="http://www.w3.org/1998/Math/MathML" xmlns:svg="http://www.w3.org/2000/svg"><head></head><body><mathml:msqrt>4</mathml:msqrt><b svg:fill="red"></b></body></html>'
         soup = self.soup(markup)
-        self.assertEqual(markup, soup.encode())
+        assert markup == soup.encode()
         html = soup.html
-        self.assertEqual('http://www.w3.org/1999/xhtml', soup.html['xmlns'])
-        self.assertEqual(
-            'http://www.w3.org/1998/Math/MathML', soup.html['xmlns:mathml'])
-        self.assertEqual(
-            'http://www.w3.org/2000/svg', soup.html['xmlns:svg'])
+        assert 'http://www.w3.org/1999/xhtml' == soup.html['xmlns']
+        assert 'http://www.w3.org/1998/Math/MathML' == soup.html['xmlns:mathml']
+        assert 'http://www.w3.org/2000/svg' == soup.html['xmlns:svg']
 
     def test_multivalued_attribute_value_becomes_list(self):
         markup = b'<a class="foo bar">'
         soup = self.soup(markup)
-        self.assertEqual(['foo', 'bar'], soup.a['class'])
+        assert ['foo', 'bar'] == soup.a['class']
         
     #
     # Generally speaking, tests below this point are more tests of
@@ -700,67 +760,65 @@ Hello, world!
         # encoding found in the  declaration! The horror!
         markup = '<html><head><meta encoding="euc-jp"></head><body>Sacr\N{LATIN SMALL LETTER E WITH ACUTE} bleu!</body>'
         soup = self.soup(markup)
-        self.assertEqual('Sacr\xe9 bleu!', soup.body.string)
+        assert 'Sacr\xe9 bleu!' == soup.body.string
 
     def test_soupstrainer(self):
         """Parsers should be able to work with SoupStrainers."""
         strainer = SoupStrainer("b")
         soup = self.soup("A <b>bold</b> <meta/> <i>statement</i>",
                          parse_only=strainer)
-        self.assertEqual(soup.decode(), "<b>bold</b>")
+        assert soup.decode() == "<b>bold</b>"
 
     def test_single_quote_attribute_values_become_double_quotes(self):
-        self.assertSoupEquals("<foo attr='bar'></foo>",
+        self.assert_soup("<foo attr='bar'></foo>",
                               '<foo attr="bar"></foo>')
 
     def test_attribute_values_with_nested_quotes_are_left_alone(self):
         text = """<foo attr='bar "brawls" happen'>a</foo>"""
-        self.assertSoupEquals(text)
+        self.assert_soup(text)
 
     def test_attribute_values_with_double_nested_quotes_get_quoted(self):
         text = """<foo attr='bar "brawls" happen'>a</foo>"""
         soup = self.soup(text)
         soup.foo['attr'] = 'Brawls happen at "Bob\'s Bar"'
-        self.assertSoupEquals(
+        self.assert_soup(
             soup.foo.decode(),
             """<foo attr="Brawls happen at &quot;Bob\'s Bar&quot;">a</foo>""")
 
     def test_ampersand_in_attribute_value_gets_escaped(self):
-        self.assertSoupEquals('<this is="really messed up & stuff"></this>',
+        self.assert_soup('<this is="really messed up & stuff"></this>',
                               '<this is="really messed up &amp; stuff"></this>')
 
-        self.assertSoupEquals(
+        self.assert_soup(
             '<a href="http://example.org?a=1&b=2;3">foo</a>',
             '<a href="http://example.org?a=1&amp;b=2;3">foo</a>')
 
     def test_escaped_ampersand_in_attribute_value_is_left_alone(self):
-        self.assertSoupEquals('<a href="http://example.org?a=1&amp;b=2;3"></a>')
+        self.assert_soup('<a href="http://example.org?a=1&amp;b=2;3"></a>')
 
     def test_entities_in_strings_converted_during_parsing(self):
         # Both XML and HTML entities are converted to Unicode characters
         # during parsing.
         text = "<p>&lt;&lt;sacr&eacute;&#32;bleu!&gt;&gt;</p>"
         expected = "<p>&lt;&lt;sacr\N{LATIN SMALL LETTER E WITH ACUTE} bleu!&gt;&gt;</p>"
-        self.assertSoupEquals(text, expected)
+        self.assert_soup(text, expected)
 
     def test_smart_quotes_converted_on_the_way_in(self):
         # Microsoft smart quotes are converted to Unicode characters during
         # parsing.
         quote = b"<p>\x91Foo\x92</p>"
         soup = self.soup(quote)
-        self.assertEqual(
-            soup.p.string,
-            "\N{LEFT SINGLE QUOTATION MARK}Foo\N{RIGHT SINGLE QUOTATION MARK}")
+        assert soup.p.string == "\N{LEFT SINGLE QUOTATION MARK}Foo\N{RIGHT SINGLE QUOTATION MARK}"
 
     def test_non_breaking_spaces_converted_on_the_way_in(self):
         soup = self.soup("<a>&nbsp;&nbsp;</a>")
-        self.assertEqual(soup.a.string, "\N{NO-BREAK SPACE}" * 2)
+        assert soup.a.string == "\N{NO-BREAK SPACE}" * 2
 
     def test_entities_converted_on_the_way_out(self):
         text = "<p>&lt;&lt;sacr&eacute;&#32;bleu!&gt;&gt;</p>"
         expected = "<p>&lt;&lt;sacr\N{LATIN SMALL LETTER E WITH ACUTE} bleu!&gt;&gt;</p>".encode("utf-8")
         soup = self.soup(text)
-        self.assertEqual(soup.p.encode("utf-8"), expected)
+        assert soup.p.encode("utf-8") == expected
 
     def test_real_iso_latin_document(self):
         # Smoke test of interrelated functionality, using an
@@ -787,7 +845,7 @@ Hello, world!
         expected = expected.encode("utf-8")
 
         # Ta-da!
-        self.assertEqual(result, expected)
+        assert result == expected
 
     def test_real_shift_jis_document(self):
         # Smoke test to make sure the parser can handle a document in
@@ -803,8 +861,8 @@ Hello, world!
 
         # Make sure the parse tree is correctly encoded to various
         # encodings.
-        self.assertEqual(soup.encode("utf-8"), unicode_html.encode("utf-8"))
-        self.assertEqual(soup.encode("euc_jp"), unicode_html.encode("euc_jp"))
+        assert soup.encode("utf-8") == unicode_html.encode("utf-8")
+        assert soup.encode("euc_jp") == unicode_html.encode("euc_jp")
 
     def test_real_hebrew_document(self):
         # A real-world test to make sure we can convert ISO-8859-9 (a
@@ -815,9 +873,9 @@ Hello, world!
         # Some tree builders call it iso8859-8, others call it iso-8859-9.
         # That's not a difference we really care about.
         assert soup.original_encoding in ('iso8859-8', 'iso-8859-8')
-        self.assertEqual(
-            soup.encode('utf-8'),
-            hebrew_document.decode("iso8859-8").encode("utf-8"))
+        assert soup.encode('utf-8') == (
+            hebrew_document.decode("iso8859-8").encode("utf-8")
+        )
 
     def test_meta_tag_reflects_current_encoding(self):
         # Here's the <meta> tag saying that a document is
@@ -835,14 +893,14 @@ Hello, world!
         # Parse the document, and the charset is seemingly unaffected.
         parsed_meta = soup.find('meta', {'http-equiv': 'Content-type'})
         content = parsed_meta['content']
-        self.assertEqual('text/html; charset=x-sjis', content)
+        assert 'text/html; charset=x-sjis' == content
 
         # But that value is actually a ContentMetaAttributeValue object.
-        self.assertTrue(isinstance(content, ContentMetaAttributeValue))
+        assert isinstance(content, ContentMetaAttributeValue)
 
         # And it will take on a value that reflects its current
         # encoding.
-        self.assertEqual('text/html; charset=utf8', content.encode("utf8"))
+        assert 'text/html; charset=utf8' == content.encode("utf8")
 
         # For the rest of the story, see TestSubstitutions in
         # test_tree.py.
@@ -862,14 +920,14 @@ Hello, world!
         # Parse the document, and the charset is seemingly unaffected.
         parsed_meta = soup.find('meta', id="encoding")
         charset = parsed_meta['charset']
-        self.assertEqual('x-sjis', charset)
+        assert 'x-sjis' == charset
 
         # But that value is actually a CharsetMetaAttributeValue object.
-        self.assertTrue(isinstance(charset, CharsetMetaAttributeValue))
+        assert isinstance(charset, CharsetMetaAttributeValue)
 
         # And it will take on a value that reflects its current
         # encoding.
-        self.assertEqual('utf8', charset.encode("utf8"))
+        assert 'utf8' == charset.encode("utf8")
 
     def test_python_specific_encodings_not_used_in_charset(self):
         # You can encode an HTML document using a Python-specific
@@ -897,7 +955,7 @@ Hello, world!
     def test_tag_with_no_attributes_can_have_attributes_added(self):
         data = self.soup("<a>text</a>")
         data.a['foo'] = 'bar'
-        self.assertEqual('<a foo="bar">text</a>', data.a.decode())
+        assert '<a foo="bar">text</a>' == data.a.decode()
 
     def test_closing_tag_with_no_opening_tag(self):
         # Without BeautifulSoup.open_tag_counter, the </span> tag will
@@ -905,9 +963,7 @@ Hello, world!
         # for a <span> tag that wasn't there. The result is that 'text2'
         # will show up outside the body of the document.
         soup = self.soup("<body><div><p>text1</p></span>text2</div></body>")
-        self.assertEqual(
-            "<body><div><p>text1</p>text2</div></body>", soup.body.decode()
-        )
+        assert "<body><div><p>text1</p>text2</div></body>" == soup.body.decode()
         
     def test_worst_case(self):
         """Test the worst case (currently) for linking issues."""
@@ -924,18 +980,17 @@ class XMLTreeBuilderSmokeTest(TreeBuilderSmokeTest):
         tree = self.soup("<a><b>foo</a>")
         dumped = pickle.dumps(tree, 2)
         loaded = pickle.loads(dumped)
-        self.assertEqual(loaded.__class__, BeautifulSoup)
-        self.assertEqual(loaded.decode(), tree.decode())
+        assert loaded.__class__ == BeautifulSoup
+        assert loaded.decode() == tree.decode()
 
     def test_docstring_generated(self):
         soup = self.soup("<root/>")
-        self.assertEqual(
-            soup.encode(), b'<?xml version="1.0" encoding="utf-8"?>\n<root/>')
+        assert soup.encode() == b'<?xml version="1.0" encoding="utf-8"?>\n<root/>'
 
     def test_xml_declaration(self):
         markup = b"""<?xml version="1.0" encoding="utf8"?>\n<foo/>"""
         soup = self.soup(markup)
-        self.assertEqual(markup, soup.encode("utf8"))
+        assert markup == soup.encode("utf8")
 
     def test_python_specific_encodings_not_used_in_xml_declaration(self):
         # You can encode an XML document using a Python-specific
@@ -959,7 +1014,7 @@ class XMLTreeBuilderSmokeTest(TreeBuilderSmokeTest):
     def test_processing_instruction(self):
         markup = b"""<?xml version="1.0" encoding="utf8"?>\n<?PITarget PIContent?>"""
         soup = self.soup(markup)
-        self.assertEqual(markup, soup.encode("utf8"))
+        assert markup == soup.encode("utf8")
 
     def test_real_xhtml_document(self):
         """A real XHTML document should come out *exactly* the same as it went in."""
@@ -970,8 +1025,7 @@ class XMLTreeBuilderSmokeTest(TreeBuilderSmokeTest):
 <body>Goodbye.</body>
 </html>"""
         soup = self.soup(markup)
-        self.assertEqual(
-            soup.encode("utf-8"), markup)
+        assert soup.encode("utf-8") == markup
        
     def test_nested_namespaces(self):
         doc = b"""<?xml version="1.0" encoding="utf-8"?>
@@ -982,7 +1036,7 @@ class XMLTreeBuilderSmokeTest(TreeBuilderSmokeTest):
 </child>
 </parent>"""
         soup = self.soup(doc)
-        self.assertEqual(doc, soup.encode())
+        assert doc == soup.encode()
         
     def test_formatter_processes_script_tag_for_xml_documents(self):
         doc = """
@@ -994,24 +1048,26 @@ class XMLTreeBuilderSmokeTest(TreeBuilderSmokeTest):
         # it later.
         soup.script.string = 'console.log("< < hey > > ");'
         encoded = soup.encode()
-        self.assertTrue(b"&lt; &lt; hey &gt; &gt;" in encoded)
+        assert b"&lt; &lt; hey &gt; &gt;" in encoded
 
     def test_can_parse_unicode_document(self):
         markup = '<?xml version="1.0" encoding="euc-jp"><root>Sacr\N{LATIN SMALL LETTER E WITH ACUTE} bleu!</root>'
         soup = self.soup(markup)
-        self.assertEqual('Sacr\xe9 bleu!', soup.root.string)
+        assert 'Sacr\xe9 bleu!' == soup.root.string
 
+    def test_can_parse_unicode_document_begining_with_bom(self):
+        markup = '\N{BYTE ORDER MARK}<?xml version="1.0" encoding="euc-jp"><root>Sacr\N{LATIN SMALL LETTER E WITH ACUTE} bleu!</root>'
+        soup = self.soup(markup)
+        assert 'Sacr\xe9 bleu!' == soup.root.string
+        
     def test_popping_namespaced_tag(self):
         markup = '<rss xmlns:dc="foo"><dc:creator>b</dc:creator><dc:date>2012-07-02T20:33:42Z</dc:date><dc:rights>c</dc:rights><image>d</image></rss>'
         soup = self.soup(markup)
-        self.assertEqual(
-            str(soup.rss), markup)
+        assert str(soup.rss) == markup
 
     def test_docstring_includes_correct_encoding(self):
         soup = self.soup("<root/>")
-        self.assertEqual(
-            soup.encode("latin1"),
-            b'<?xml version="1.0" encoding="latin1"?>\n<root/>')
+        assert soup.encode("latin1") == b'<?xml version="1.0" encoding="latin1"?>\n<root/>'
 
     def test_large_xml_document(self):
         """A large XML document should come out the same as it went in."""
@@ -1019,34 +1075,33 @@ class XMLTreeBuilderSmokeTest(TreeBuilderSmokeTest):
                   + b'0' * (2**12)
                   + b'</root>')
         soup = self.soup(markup)
-        self.assertEqual(soup.encode("utf-8"), markup)
-
+        assert soup.encode("utf-8") == markup
 
     def test_tags_are_empty_element_if_and_only_if_they_are_empty(self):
-        self.assertSoupEquals("<p>", "<p/>")
-        self.assertSoupEquals("<p>foo</p>")
+        self.assert_soup("<p>", "<p/>")
+        self.assert_soup("<p>foo</p>")
 
     def test_namespaces_are_preserved(self):
         markup = '<root xmlns:a="http://example.com/" xmlns:b="http://example.net/"><a:foo>This tag is in the a namespace</a:foo><b:foo>This tag is in the b namespace</b:foo></root>'
         soup = self.soup(markup)
         root = soup.root
-        self.assertEqual("http://example.com/", root['xmlns:a'])
-        self.assertEqual("http://example.net/", root['xmlns:b'])
+        assert "http://example.com/" == root['xmlns:a']
+        assert "http://example.net/" == root['xmlns:b']
 
     def test_closing_namespaced_tag(self):
         markup = '<p xmlns:dc="http://purl.org/dc/elements/1.1/"><dc:date>20010504</dc:date></p>'
         soup = self.soup(markup)
-        self.assertEqual(str(soup.p), markup)
+        assert str(soup.p) == markup
 
     def test_namespaced_attributes(self):
         markup = '<foo xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"><bar xsi:schemaLocation="http://www.example.com"/></foo>'
         soup = self.soup(markup)
-        self.assertEqual(str(soup.foo), markup)
+        assert str(soup.foo) == markup
 
     def test_namespaced_attributes_xml_namespace(self):
         markup = '<foo xml:lang="fr">bar</foo>'
         soup = self.soup(markup)
-        self.assertEqual(str(soup.foo), markup)
+        assert str(soup.foo) == markup
 
     def test_find_by_prefixed_name(self):
         doc = """<?xml version="1.0" encoding="utf-8"?>
@@ -1061,14 +1116,14 @@ class XMLTreeBuilderSmokeTest(TreeBuilderSmokeTest):
         soup = self.soup(doc)
 
         # There are three <tag> tags.
-        self.assertEqual(3, len(soup.find_all('tag')))
+        assert 3 == len(soup.find_all('tag'))
 
         # But two of them are ns1:tag and one of them is ns2:tag.
-        self.assertEqual(2, len(soup.find_all('ns1:tag')))
-        self.assertEqual(1, len(soup.find_all('ns2:tag')))
+        assert 2 == len(soup.find_all('ns1:tag'))
+        assert 1 == len(soup.find_all('ns2:tag'))
         
-        self.assertEqual(1, len(soup.find_all('ns2:tag', key='value')))
-        self.assertEqual(3, len(soup.find_all(['ns1:tag', 'ns2:tag'])))
+        assert 1, len(soup.find_all('ns2:tag', key='value'))
+        assert 3, len(soup.find_all(['ns1:tag', 'ns2:tag']))
         
     def test_copy_tag_preserves_namespace(self):
         xml = """<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
@@ -1079,7 +1134,7 @@ class XMLTreeBuilderSmokeTest(TreeBuilderSmokeTest):
         duplicate = copy.copy(tag)
 
         # The two tags have the same namespace prefix.
-        self.assertEqual(tag.prefix, duplicate.prefix)
+        assert tag.prefix == duplicate.prefix
 
     def test_worst_case(self):
         """Test the worst case (currently) for linking issues."""
@@ -1099,29 +1154,29 @@ class HTML5TreeBuilderSmokeTest(HTMLTreeBuilderSmokeTest):
     def test_html_tags_have_namespace(self):
         markup = "<a>"
         soup = self.soup(markup)
-        self.assertEqual("http://www.w3.org/1999/xhtml", soup.a.namespace)
+        assert "http://www.w3.org/1999/xhtml" == soup.a.namespace
 
     def test_svg_tags_have_namespace(self):
         markup = '<svg><circle/></svg>'
         soup = self.soup(markup)
         namespace = "http://www.w3.org/2000/svg"
-        self.assertEqual(namespace, soup.svg.namespace)
-        self.assertEqual(namespace, soup.circle.namespace)
+        assert namespace == soup.svg.namespace
+        assert namespace == soup.circle.namespace
 
 
     def test_mathml_tags_have_namespace(self):
         markup = '<math><msqrt>5</msqrt></math>'
         soup = self.soup(markup)
         namespace = 'http://www.w3.org/1998/Math/MathML'
-        self.assertEqual(namespace, soup.math.namespace)
-        self.assertEqual(namespace, soup.msqrt.namespace)
+        assert namespace == soup.math.namespace
+        assert namespace == soup.msqrt.namespace
 
     def test_xml_declaration_becomes_comment(self):
         markup = '<?xml version="1.0" encoding="utf-8"?><html></html>'
         soup = self.soup(markup)
-        self.assertTrue(isinstance(soup.contents[0], Comment))
-        self.assertEqual(soup.contents[0], '?xml version="1.0" encoding="utf-8"?')
-        self.assertEqual("html", soup.contents[0].next_element.name)
+        assert isinstance(soup.contents[0], Comment)
+        assert soup.contents[0] == '?xml version="1.0" encoding="utf-8"?'
+        assert "html" == soup.contents[0].next_element.name
 
 def skipIf(condition, reason):
    def nothing(test, *args, **kwargs):
diff --git a/lib/bs4/tests/test_builder.py b/lib/bs4/tests/test_builder.py
new file mode 100644
index 00000000..75370712
--- /dev/null
+++ b/lib/bs4/tests/test_builder.py
@@ -0,0 +1,29 @@
+import pytest
+from unittest.mock import patch
+from bs4.builder import DetectsXMLParsedAsHTML
+
+class TestDetectsXMLParsedAsHTML(object):
+
+    @pytest.mark.parametrize(
+        "markup,looks_like_xml",
+        [("No xml declaration", False),
+         ("<html>obviously HTML</html", False),
+         ("<?xml ><html>Actually XHTML</html>", False),
+         ("<?xml>            <    html>Tricky XHTML</html>", False),
+         ("<?xml ><no-html-tag>", True),
+        ]
+    )
+    def test_warn_if_markup_looks_like_xml(self, markup, looks_like_xml):
+        # Test of our ability to guess at whether markup looks XML-ish
+        # _and_ not HTML-ish.
+        with patch('bs4.builder.DetectsXMLParsedAsHTML._warn') as mock:
+            for data in markup, markup.encode('utf8'):
+                result = DetectsXMLParsedAsHTML.warn_if_markup_looks_like_xml(
+                    data
+                )
+                assert result == looks_like_xml
+                if looks_like_xml:
+                    assert mock.called
+                else:
+                    assert not mock.called
+                mock.reset_mock()
diff --git a/lib/bs4/tests/test_builder_registry.py b/lib/bs4/tests/test_builder_registry.py
new file mode 100644
index 00000000..5fa874c8
--- /dev/null
+++ b/lib/bs4/tests/test_builder_registry.py
@@ -0,0 +1,136 @@
+"""Tests of the builder registry."""
+
+import pytest
+import warnings
+
+from bs4 import BeautifulSoup
+from bs4.builder import (
+    builder_registry as registry,
+    HTMLParserTreeBuilder,
+    TreeBuilderRegistry,
+)
+
+try:
+    from bs4.builder import HTML5TreeBuilder
+    HTML5LIB_PRESENT = True
+except ImportError:
+    HTML5LIB_PRESENT = False
+
+try:
+    from bs4.builder import (
+        LXMLTreeBuilderForXML,
+        LXMLTreeBuilder,
+        )
+    LXML_PRESENT = True
+except ImportError:
+    LXML_PRESENT = False
+
+
+class TestBuiltInRegistry(object):
+    """Test the built-in registry with the default builders registered."""
+
+    def test_combination(self):
+        assert registry.lookup('strict', 'html') == HTMLParserTreeBuilder
+        if LXML_PRESENT:
+            assert registry.lookup('fast', 'html') == LXMLTreeBuilder
+            assert registry.lookup('permissive', 'xml') == LXMLTreeBuilderForXML
+        if HTML5LIB_PRESENT:
+            assert registry.lookup('html5lib', 'html') == HTML5TreeBuilder
+
+    def test_lookup_by_markup_type(self):
+        if LXML_PRESENT:
+            assert registry.lookup('html') == LXMLTreeBuilder
+            assert registry.lookup('xml') == LXMLTreeBuilderForXML
+        else:
+            assert registry.lookup('xml') == None
+            if HTML5LIB_PRESENT:
+                assert registry.lookup('html') == HTML5TreeBuilder
+            else:
+                assert registry.lookup('html') == HTMLParserTreeBuilder
+
+    def test_named_library(self):
+        if LXML_PRESENT:
+            assert registry.lookup('lxml', 'xml') == LXMLTreeBuilderForXML
+            assert registry.lookup('lxml', 'html') == LXMLTreeBuilder
+        if HTML5LIB_PRESENT:
+            assert registry.lookup('html5lib') == HTML5TreeBuilder
+
+        assert registry.lookup('html.parser') == HTMLParserTreeBuilder
+
+    def test_beautifulsoup_constructor_does_lookup(self):
+
+        with warnings.catch_warnings(record=True) as w:
+            # This will create a warning about not explicitly
+            # specifying a parser, but we'll ignore it.
+
+            # You can pass in a string.
+            BeautifulSoup("", features="html")
+            # Or a list of strings.
+            BeautifulSoup("", features=["html", "fast"])
+            pass
+            
+        # You'll get an exception if BS can't find an appropriate
+        # builder.
+        with pytest.raises(ValueError):
+            BeautifulSoup("", features="no-such-feature")
+
+class TestRegistry(object):
+    """Test the TreeBuilderRegistry class in general."""
+
+    def setup_method(self):
+        self.registry = TreeBuilderRegistry()
+
+    def builder_for_features(self, *feature_list):
+        cls = type('Builder_' + '_'.join(feature_list),
+                   (object,), {'features' : feature_list})
+
+        self.registry.register(cls)
+        return cls
+
+    def test_register_with_no_features(self):
+        builder = self.builder_for_features()
+
+        # Since the builder advertises no features, you can't find it
+        # by looking up features.
+        assert self.registry.lookup('foo') is None
+
+        # But you can find it by doing a lookup with no features, if
+        # this happens to be the only registered builder.
+        assert self.registry.lookup() == builder
+
+    def test_register_with_features_makes_lookup_succeed(self):
+        builder = self.builder_for_features('foo', 'bar')
+        assert self.registry.lookup('foo') is builder
+        assert self.registry.lookup('bar') is builder
+
+    def test_lookup_fails_when_no_builder_implements_feature(self):
+        builder = self.builder_for_features('foo', 'bar')
+        assert self.registry.lookup('baz') is None
+
+    def test_lookup_gets_most_recent_registration_when_no_feature_specified(self):
+        builder1 = self.builder_for_features('foo')
+        builder2 = self.builder_for_features('bar')
+        assert self.registry.lookup() == builder2
+
+    def test_lookup_fails_when_no_tree_builders_registered(self):
+        assert self.registry.lookup() is None
+
+    def test_lookup_gets_most_recent_builder_supporting_all_features(self):
+        has_one = self.builder_for_features('foo')
+        has_the_other = self.builder_for_features('bar')
+        has_both_early = self.builder_for_features('foo', 'bar', 'baz')
+        has_both_late = self.builder_for_features('foo', 'bar', 'quux')
+        lacks_one = self.builder_for_features('bar')
+        has_the_other = self.builder_for_features('foo')
+
+        # There are two builders featuring 'foo' and 'bar', but
+        # the one that also features 'quux' was registered later.
+        assert self.registry.lookup('foo', 'bar') == has_both_late
+
+        # There is only one builder featuring 'foo', 'bar', and 'baz'.
+        assert self.registry.lookup('foo', 'bar', 'baz') == has_both_early
+
+    def test_lookup_fails_when_cannot_reconcile_requested_features(self):
+        builder1 = self.builder_for_features('foo', 'bar')
+        builder2 = self.builder_for_features('foo', 'baz')
+        assert self.registry.lookup('bar', 'baz') is None
diff --git a/lib/bs4/tests/test_dammit.py b/lib/bs4/tests/test_dammit.py
new file mode 100644
index 00000000..9971234e
--- /dev/null
+++ b/lib/bs4/tests/test_dammit.py
@@ -0,0 +1,371 @@
+# encoding: utf-8
+import pytest
+import logging
+import bs4
+from bs4 import BeautifulSoup
+from bs4.dammit import (
+    EntitySubstitution,
+    EncodingDetector,
+    UnicodeDammit,
+)
+
+class TestUnicodeDammit(object):
+    """Standalone tests of UnicodeDammit."""
+
+    def test_unicode_input(self):
+        markup = "I'm already Unicode! \N{SNOWMAN}"
+        dammit = UnicodeDammit(markup)
+        assert dammit.unicode_markup == markup
+
+    def test_smart_quotes_to_unicode(self):
+        markup = b"<foo>\x91\x92\x93\x94</foo>"
+        dammit = UnicodeDammit(markup)
+        assert dammit.unicode_markup == "<foo>\u2018\u2019\u201c\u201d</foo>"
+
+    def test_smart_quotes_to_xml_entities(self):
+        markup = b"<foo>\x91\x92\x93\x94</foo>"
+        dammit = UnicodeDammit(markup, smart_quotes_to="xml")
+        assert dammit.unicode_markup == "<foo>&#x2018;&#x2019;&#x201C;&#x201D;</foo>"
+
+    def test_smart_quotes_to_html_entities(self):
+        markup = b"<foo>\x91\x92\x93\x94</foo>"
+        dammit = UnicodeDammit(markup, smart_quotes_to="html")
+        assert dammit.unicode_markup == "<foo>&lsquo;&rsquo;&ldquo;&rdquo;</foo>"
+
+    def test_smart_quotes_to_ascii(self):
+        markup = b"<foo>\x91\x92\x93\x94</foo>"
+        dammit = UnicodeDammit(markup, smart_quotes_to="ascii")
+        assert dammit.unicode_markup == """<foo>''""</foo>"""
+
+    def test_detect_utf8(self):
+        utf8 = b"Sacr\xc3\xa9 bleu! \xe2\x98\x83"
+        dammit = UnicodeDammit(utf8)
+        assert dammit.original_encoding.lower() == 'utf-8'
+        assert dammit.unicode_markup == 'Sacr\xe9 bleu! \N{SNOWMAN}'
+
+    def test_convert_hebrew(self):
+        hebrew = b"\xed\xe5\xec\xf9"
+        dammit = UnicodeDammit(hebrew, ["iso-8859-8"])
+        assert dammit.original_encoding.lower() == 'iso-8859-8'
+        assert dammit.unicode_markup == '\u05dd\u05d5\u05dc\u05e9'
+
+    def test_dont_see_smart_quotes_where_there_are_none(self):
+        utf_8 = b"\343\202\261\343\203\274\343\202\277\343\202\244 Watch"
+        dammit = UnicodeDammit(utf_8)
+        assert dammit.original_encoding.lower() == 'utf-8'
+        assert dammit.unicode_markup.encode("utf-8") == utf_8
+
+    def test_ignore_inappropriate_codecs(self):
+        utf8_data = "Räksmörgås".encode("utf-8")
+        dammit = UnicodeDammit(utf8_data, ["iso-8859-8"])
+        assert dammit.original_encoding.lower() == 'utf-8'
+
+    def test_ignore_invalid_codecs(self):
+        utf8_data = "Räksmörgås".encode("utf-8")
+        for bad_encoding in ['.utf8', '...', 'utF---16.!']:
+            dammit = UnicodeDammit(utf8_data, [bad_encoding])
+            assert dammit.original_encoding.lower() == 'utf-8'
+
+    def test_exclude_encodings(self):
+        # This is UTF-8.
+        utf8_data = "Räksmörgås".encode("utf-8")
+
+        # But if we exclude UTF-8 from consideration, the guess is
+        # Windows-1252.
+        dammit = UnicodeDammit(utf8_data, exclude_encodings=["utf-8"])
+        assert dammit.original_encoding.lower() == 'windows-1252'
+
+        # And if we exclude that, there is no valid guess at all.
+        dammit = UnicodeDammit(
+            utf8_data, exclude_encodings=["utf-8", "windows-1252"])
+        assert dammit.original_encoding == None
+
+class TestEncodingDetector(object):
+        
+    def test_encoding_detector_replaces_junk_in_encoding_name_with_replacement_character(self):
+        detected = EncodingDetector(
+            b'<?xml version="1.0" encoding="UTF-\xdb" ?>')
+        encodings = list(detected.encodings)
+        assert 'utf-\N{REPLACEMENT CHARACTER}' in encodings
+
+    def test_detect_html5_style_meta_tag(self):
+
+        for data in (
+            b'<html><meta charset="euc-jp" /></html>',
+            b"<html><meta charset='euc-jp' /></html>",
+            b"<html><meta charset=euc-jp /></html>",
+            b"<html><meta charset=euc-jp/></html>"):
+            dammit = UnicodeDammit(data, is_html=True)
+            assert "euc-jp" == dammit.original_encoding
+
+    def test_last_ditch_entity_replacement(self):
+        # This is a UTF-8 document that contains bytestrings
+        # completely incompatible with UTF-8 (ie. encoded with some other
+        # encoding).
+        #
+        # Since there is no consistent encoding for the document,
+        # Unicode, Dammit will eventually encode the document as UTF-8
+        # and encode the incompatible characters as REPLACEMENT
+        # CHARACTER.
+        #
+        # If chardet is installed, it will detect that the document
+        # can be converted into ISO-8859-1 without errors. This happens
+        # to be the wrong encoding, but it is a consistent encoding, so the
+        # code we're testing here won't run.
+        #
+        # So we temporarily disable chardet if it's present.
+        doc = b"""\357\273\277<?xml version="1.0" encoding="UTF-8"?>
+<html><b>\330\250\330\252\330\261</b>
+<i>\310\322\321\220\312\321\355\344</i></html>"""
+        chardet = bs4.dammit.chardet_dammit
+        logging.disable(logging.WARNING)
+        try:
+            def noop(str):
+                return None
+            bs4.dammit.chardet_dammit = noop
+            dammit = UnicodeDammit(doc)
+            assert True == dammit.contains_replacement_characters
+            assert "\ufffd" in dammit.unicode_markup
+
+            soup = BeautifulSoup(doc, "html.parser")
+            assert soup.contains_replacement_characters
+        finally:
+            logging.disable(logging.NOTSET)
+            bs4.dammit.chardet_dammit = chardet
+
+    def test_byte_order_mark_removed(self):
+        # A document written in UTF-16LE will have its byte order marker stripped.
+        data = b'\xff\xfe<\x00a\x00>\x00\xe1\x00\xe9\x00<\x00/\x00a\x00>\x00'
+        dammit = UnicodeDammit(data)
+        assert "<a>áé</a>" == dammit.unicode_markup
+        assert "utf-16le" == dammit.original_encoding
+       
+    def test_known_definite_versus_user_encodings(self):
+        # The known_definite_encodings are used before sniffing the
+        # byte-order mark; the user_encodings are used afterwards.
+
+        # Here's a document in UTF-16LE.
+        data = b'\xff\xfe<\x00a\x00>\x00\xe1\x00\xe9\x00<\x00/\x00a\x00>\x00'
+        dammit = UnicodeDammit(data)
+
+        # We can process it as UTF-16 by passing it in as a known
+        # definite encoding.
+        before = UnicodeDammit(data, known_definite_encodings=["utf-16"])
+        assert "utf-16" == before.original_encoding
+        
+        # If we pass UTF-18 as a user encoding, it's not even
+        # tried--the encoding sniffed from the byte-order mark takes
+        # precedence.
+        after = UnicodeDammit(data, user_encodings=["utf-8"])
+        assert "utf-16le" == after.original_encoding
+        assert ["utf-16le"] == [x[0] for x in dammit.tried_encodings]
+        
+        # Here's a document in ISO-8859-8.
+        hebrew = b"\xed\xe5\xec\xf9"
+        dammit = UnicodeDammit(hebrew, known_definite_encodings=["utf-8"],
+                               user_encodings=["iso-8859-8"])
+        
+        # The known_definite_encodings don't work, BOM sniffing does
+        # nothing (it only works for a few UTF encodings), but one of
+        # the user_encodings does work.
+        assert "iso-8859-8" == dammit.original_encoding
+        assert ["utf-8", "iso-8859-8"] == [x[0] for x in dammit.tried_encodings]
+        
+    def test_deprecated_override_encodings(self):
+        # override_encodings is a deprecated alias for
+        # known_definite_encodings.
+        hebrew = b"\xed\xe5\xec\xf9"
+        dammit = UnicodeDammit(
+            hebrew,
+            known_definite_encodings=["shift-jis"],
+            override_encodings=["utf-8"],
+            user_encodings=["iso-8859-8"],
+        )
+        assert "iso-8859-8" == dammit.original_encoding
+
+        # known_definite_encodings and override_encodings were tried
+        # before user_encodings.
+        assert ["shift-jis", "utf-8", "iso-8859-8"] == (
+            [x[0] for x in dammit.tried_encodings]
+        )
+
+    def test_detwingle(self):
+        # Here's a UTF8 document.
+        utf8 = ("\N{SNOWMAN}" * 3).encode("utf8")
+
+        # Here's a Windows-1252 document.
+        windows_1252 = (
+            "\N{LEFT DOUBLE QUOTATION MARK}Hi, I like Windows!"
+            "\N{RIGHT DOUBLE QUOTATION MARK}").encode("windows_1252")
+
+        # Through some unholy alchemy, they've been stuck together.
+        doc = utf8 + windows_1252 + utf8
+
+        # The document can't be turned into UTF-8:
+        with pytest.raises(UnicodeDecodeError):
+            doc.decode("utf8")
+
+        # Unicode, Dammit thinks the whole document is Windows-1252,
+        # and decodes it into "☃☃☃“Hi, I like Windows!”☃☃☃"
+
+        # But if we run it through fix_embedded_windows_1252, it's fixed:
+        fixed = UnicodeDammit.detwingle(doc)
+        assert "☃☃☃“Hi, I like Windows!”☃☃☃" == fixed.decode("utf8")
+
+    def test_detwingle_ignores_multibyte_characters(self):
+        # Each of these characters has a UTF-8 representation ending
+        # in \x93. \x93 is a smart quote if interpreted as
+        # Windows-1252. But our code knows to skip over multibyte
+        # UTF-8 characters, so they'll survive the process unscathed.
+        for tricky_unicode_char in (
+            "\N{LATIN SMALL LIGATURE OE}", # 2-byte char '\xc5\x93'
+            "\N{LATIN SUBSCRIPT SMALL LETTER X}", # 3-byte char '\xe2\x82\x93'
+            "\xf0\x90\x90\x93", # This is a CJK character, not sure which one.
+            ):
+            input = tricky_unicode_char.encode("utf8")
+            assert input.endswith(b'\x93')
+            output = UnicodeDammit.detwingle(input)
+            assert output == input
+
+    def test_find_declared_encoding(self):
+        # Test our ability to find a declared encoding inside an
+        # XML or HTML document.
+        #
+        # Even if the document comes in as Unicode, it may be
+        # interesting to know what encoding was claimed
+        # originally.
+
+        html_unicode = '<html><head><meta charset="utf-8"></head></html>'
+        html_bytes = html_unicode.encode("ascii")
+
+        xml_unicode= '<?xml version="1.0" encoding="ISO-8859-1" ?>'
+        xml_bytes = xml_unicode.encode("ascii")
+
+        m = EncodingDetector.find_declared_encoding
+        assert m(html_unicode, is_html=False) is None
+        assert "utf-8" == m(html_unicode, is_html=True)
+        assert "utf-8" == m(html_bytes, is_html=True)
+
+        assert "iso-8859-1" == m(xml_unicode)
+        assert "iso-8859-1" == m(xml_bytes)
+
+        # Normally, only the first few kilobytes of a document are checked for
+        # an encoding.
+        spacer = b' ' * 5000
+        assert m(spacer + html_bytes) is None
+        assert m(spacer + xml_bytes) is None
+
+        # But you can tell find_declared_encoding to search an entire
+        # HTML document.
+        assert (
+            m(spacer + html_bytes, is_html=True, search_entire_document=True)
+            == "utf-8"
+        )
+
+        # The XML encoding declaration has to be the very first thing
+        # in the document. We'll allow whitespace before the document
+        # starts, but nothing else.
+        assert m(xml_bytes, search_entire_document=True) == "iso-8859-1"
+        assert m(b' ' + xml_bytes, search_entire_document=True) == "iso-8859-1"
+        assert m(b'a' + xml_bytes, search_entire_document=True) is None
+
+
+class TestEntitySubstitution(object):
+    """Standalone tests of the EntitySubstitution class."""
+    def setup_method(self):
+        self.sub = EntitySubstitution
+
+    def test_simple_html_substitution(self):
+        # Unicode characters corresponding to named HTML entites
+        # are substituted, and no others.
+        s = "foo\u2200\N{SNOWMAN}\u00f5bar"
+        assert self.sub.substitute_html(s) == "foo&forall;\N{SNOWMAN}&otilde;bar"
+
+    def test_smart_quote_substitution(self):
+        # MS smart quotes are a common source of frustration, so we
+        # give them a special test.
+        quotes = b"\x91\x92foo\x93\x94"
+        dammit = UnicodeDammit(quotes)
+        assert self.sub.substitute_html(dammit.markup) == "&lsquo;&rsquo;foo&ldquo;&rdquo;"
+
+    def test_html5_entity(self):
+        # Some HTML5 entities correspond to single- or multi-character
+        # Unicode sequences.
+
+        for entity, u in (
+            # A few spot checks of our ability to recognize
+            # special character sequences and convert them
+            # to named entities.
+            ('&models;', '\u22a7'),
+            ('&Nfr;', '\U0001d511'),
+            ('&ngeqq;', '\u2267\u0338'),
+            ('&not;', '\xac'),
+            ('&Not;', '\u2aec'),
+                
+            # We _could_ convert | to &verbarr;, but we don't, because
+            # | is an ASCII character.
+            ('|' '|'),
+
+            # Similarly for the fj ligature, which we could convert to
+            # &fjlig;, but we don't.
+            ("fj", "fj"),
+
+            # We do convert _these_ ASCII characters to HTML entities,
+            # because that's required to generate valid HTML.
+            ('&gt;', '>'),
+            ('&lt;', '<'),
+            ('&amp;', '&'),
+        ):
+            template = '3 %s 4'
+            raw = template % u
+            with_entities = template % entity
+            assert self.sub.substitute_html(raw) == with_entities
+            
+    def test_html5_entity_with_variation_selector(self):
+        # Some HTML5 entities correspond either to a single-character
+        # Unicode sequence _or_ to the same character plus U+FE00,
+        # VARIATION SELECTOR 1. We can handle this.
+        data = "fjords \u2294 penguins"
+        markup = "fjords &sqcup; penguins"
+        assert self.sub.substitute_html(data) == markup
+
+        data = "fjords \u2294\ufe00 penguins"
+        markup = "fjords &sqcups; penguins"
+        assert self.sub.substitute_html(data) == markup
+        
+    def test_xml_converstion_includes_no_quotes_if_make_quoted_attribute_is_false(self):
+        s = 'Welcome to "my bar"'
+        assert self.sub.substitute_xml(s, False) == s
+
+    def test_xml_attribute_quoting_normally_uses_double_quotes(self):
+        assert self.sub.substitute_xml("Welcome", True) == '"Welcome"'
+        assert self.sub.substitute_xml("Bob's Bar", True) == '"Bob\'s Bar"'
+
+    def test_xml_attribute_quoting_uses_single_quotes_when_value_contains_double_quotes(self):
+        s = 'Welcome to "my bar"'
+        assert self.sub.substitute_xml(s, True) == "'Welcome to \"my bar\"'"
+
+    def test_xml_attribute_quoting_escapes_single_quotes_when_value_contains_both_single_and_double_quotes(self):
+        s = 'Welcome to "Bob\'s Bar"'
+        assert self.sub.substitute_xml(s, True) == '"Welcome to &quot;Bob\'s Bar&quot;"'
+
+    def test_xml_quotes_arent_escaped_when_value_is_not_being_quoted(self):
+        quoted = 'Welcome to "Bob\'s Bar"'
+        assert self.sub.substitute_xml(quoted) == quoted
+
+    def test_xml_quoting_handles_angle_brackets(self):
+        assert self.sub.substitute_xml("foo<bar>") == "foo&lt;bar&gt;"
+
+    def test_xml_quoting_handles_ampersands(self):
+        assert self.sub.substitute_xml("AT&T") == "AT&amp;T"
+
+    def test_xml_quoting_including_ampersands_when_they_are_part_of_an_entity(self):
+        assert self.sub.substitute_xml("&Aacute;T&T") == "&amp;Aacute;T&amp;T"
+
+    def test_xml_quoting_ignoring_ampersands_when_they_are_part_of_an_entity(self):
+        assert self.sub.substitute_xml_containing_entities("&Aacute;T&T") == "&Aacute;T&amp;T"
+       
+    def test_quotes_not_html_substituted(self):
+        """There's no need to do this except inside attribute values."""
+        text = 'Bob\'s "bar"'
+        assert self.sub.substitute_html(text) == text
diff --git a/lib/bs4/tests/test_docs.py b/lib/bs4/tests/test_docs.py
new file mode 100644
index 00000000..0194d697
--- /dev/null
+++ b/lib/bs4/tests/test_docs.py
@@ -0,0 +1,38 @@
+"Test harness for doctests."
+
+# TODO: Pretty sure this isn't used and should be deleted.
+
+# pylint: disable-msg=E0611,W0142
+
+__metaclass__ = type
+__all__ = [
+    'additional_tests',
+    ]
+
+import atexit
+import doctest
+import os
+#from pkg_resources import (
+#    resource_filename, resource_exists, resource_listdir, cleanup_resources)
+import unittest
+
+DOCTEST_FLAGS = (
+    doctest.ELLIPSIS |
+    doctest.NORMALIZE_WHITESPACE |
+    doctest.REPORT_NDIFF)
+
+
+# def additional_tests():
+#     "Run the doc tests (README.txt and docs/*, if any exist)"
+#     doctest_files = [
+#         os.path.abspath(resource_filename('bs4', 'README.txt'))]
+#     if resource_exists('bs4', 'docs'):
+#         for name in resource_listdir('bs4', 'docs'):
+#             if name.endswith('.txt'):
+#                 doctest_files.append(
+#                     os.path.abspath(
+#                         resource_filename('bs4', 'docs/%s' % name)))
+#     kwargs = dict(module_relative=False, optionflags=DOCTEST_FLAGS)
+#     atexit.register(cleanup_resources)
+#     return unittest.TestSuite((
+#         doctest.DocFileSuite(*doctest_files, **kwargs)))
diff --git a/lib/bs4/tests/test_element.py b/lib/bs4/tests/test_element.py
new file mode 100644
index 00000000..6d08ab5d
--- /dev/null
+++ b/lib/bs4/tests/test_element.py
@@ -0,0 +1,74 @@
+"""Tests of classes in element.py.
+
+The really big classes -- Tag, PageElement, and NavigableString --
+are tested in separate files.
+"""
+
+from bs4.element import (
+    CharsetMetaAttributeValue,
+    ContentMetaAttributeValue,
+    NamespacedAttribute,
+)
+from . import SoupTest
+
+
+class TestNamedspacedAttribute(object):
+
+    def test_name_may_be_none_or_missing(self):
+        a = NamespacedAttribute("xmlns", None)
+        assert a == "xmlns"
+
+        a = NamespacedAttribute("xmlns", "")
+        assert a == "xmlns"
+
+        a = NamespacedAttribute("xmlns")
+        assert a == "xmlns"
+        
+    def test_namespace_may_be_none_or_missing(self):
+        a = NamespacedAttribute(None, "tag")
+        assert a == "tag"
+        
+        a = NamespacedAttribute("", "tag")
+        assert a == "tag"
+        
+    def test_attribute_is_equivalent_to_colon_separated_string(self):
+        a = NamespacedAttribute("a", "b")
+        assert "a:b" == a
+
+    def test_attributes_are_equivalent_if_prefix_and_name_identical(self):
+        a = NamespacedAttribute("a", "b", "c")
+        b = NamespacedAttribute("a", "b", "c")
+        assert a == b
+
+        # The actual namespace is not considered.
+        c = NamespacedAttribute("a", "b", None)
+        assert a == c
+
+        # But name and prefix are important.
+        d = NamespacedAttribute("a", "z", "c")
+        assert a != d
+
+        e = NamespacedAttribute("z", "b", "c")
+        assert a != e
+
+
+class TestAttributeValueWithCharsetSubstitution(object):
+    """Certain attributes are designed to have the charset of the
+    final document substituted into their value.
+    """
+    
+    def test_content_meta_attribute_value(self):
+        # The value of a CharsetMetaAttributeValue is whatever
+        # encoding the string is in.
+        value = CharsetMetaAttributeValue("euc-jp")
+        assert "euc-jp" == value
+        assert "euc-jp" == value.original_value
+        assert "utf8" == value.encode("utf8")
+        assert "ascii" == value.encode("ascii")
+
+    def test_content_meta_attribute_value(self):
+        value = ContentMetaAttributeValue("text/html; charset=euc-jp")
+        assert "text/html; charset=euc-jp" == value
+        assert "text/html; charset=euc-jp" == value.original_value
+        assert "text/html; charset=utf8" == value.encode("utf8")
+        assert "text/html; charset=ascii" == value.encode("ascii")
diff --git a/lib/bs4/tests/test_formatter.py b/lib/bs4/tests/test_formatter.py
new file mode 100644
index 00000000..84d4e3b2
--- /dev/null
+++ b/lib/bs4/tests/test_formatter.py
@@ -0,0 +1,113 @@
+import pytest
+
+from bs4.element import Tag
+from bs4.formatter import (
+    Formatter,
+    HTMLFormatter,
+    XMLFormatter,
+)
+from . import SoupTest
+
+class TestFormatter(SoupTest):
+
+    def test_default_attributes(self):
+        # Test the default behavior of Formatter.attributes().
+        formatter = Formatter()
+        tag = Tag(name="tag")
+        tag['b'] = 1
+        tag['a'] = 2
+
+        # Attributes come out sorted by name. In Python 3, attributes
+        # normally come out of a dictionary in the order they were
+        # added.
+        assert [('a', 2), ('b', 1)] == formatter.attributes(tag)
+
+        # This works even if Tag.attrs is None, though this shouldn't
+        # normally happen.
+        tag.attrs = None
+        assert [] == formatter.attributes(tag)
+
+        assert ' ' == formatter.indent
+        
+    def test_sort_attributes(self):
+        # Test the ability to override Formatter.attributes() to,
+        # e.g., disable the normal sorting of attributes.
+        class UnsortedFormatter(Formatter):
+            def attributes(self, tag):
+                self.called_with = tag
+                for k, v in sorted(tag.attrs.items()):
+                    if k == 'ignore':
+                        continue
+                    yield k,v
+
+        soup = self.soup('<p cval="1" aval="2" ignore="ignored"></p>')
+        formatter = UnsortedFormatter()
+        decoded = soup.decode(formatter=formatter)
+
+        # attributes() was called on the <p> tag. It filtered out one
+        # attribute and sorted the other two.
+        assert formatter.called_with == soup.p
+        assert '<p aval="2" cval="1"></p>' == decoded
+
+    def test_empty_attributes_are_booleans(self):
+        # Test the behavior of empty_attributes_are_booleans as well
+        # as which Formatters have it enabled.
+        
+        for name in ('html', 'minimal', None):
+            formatter = HTMLFormatter.REGISTRY[name]
+            assert False == formatter.empty_attributes_are_booleans
+
+        formatter = XMLFormatter.REGISTRY[None]
+        assert False == formatter.empty_attributes_are_booleans
+
+        formatter = HTMLFormatter.REGISTRY['html5']
+        assert True == formatter.empty_attributes_are_booleans
+
+        # Verify that the constructor sets the value.
+        formatter = Formatter(empty_attributes_are_booleans=True)
+        assert True == formatter.empty_attributes_are_booleans
+
+        # Now demonstrate what it does to markup.
+        for markup in (
+                "<option selected></option>",
+                '<option selected=""></option>'
+        ):
+            soup = self.soup(markup)
+            for formatter in ('html', 'minimal', 'xml', None):
+                assert b'<option selected=""></option>' == soup.option.encode(formatter='html')
+                assert b'<option selected></option>' == soup.option.encode(formatter='html5')
+
+    @pytest.mark.parametrize(
+        "indent,expect",
+        [
+            (None, '<a>\n<b>\ntext\n</b>\n</a>'),
+            (-1, '<a>\n<b>\ntext\n</b>\n</a>'),
+            (0, '<a>\n<b>\ntext\n</b>\n</a>'),
+            ("", '<a>\n<b>\ntext\n</b>\n</a>'),
+
+            (1, '<a>\n <b>\n  text\n </b>\n</a>'),
+            (2, '<a>\n  <b>\n    text\n  </b>\n</a>'),
+
+            ("\t", '<a>\n\t<b>\n\t\ttext\n\t</b>\n</a>'),
+            ('abc', '<a>\nabc<b>\nabcabctext\nabc</b>\n</a>'),
+
+            # Some invalid inputs -- the default behavior is used.
+            (object(), '<a>\n <b>\n  text\n </b>\n</a>'),
+            (b'bytes', '<a>\n <b>\n  text\n </b>\n</a>'),
+        ]
+    )
+    def test_indent(self, indent, expect):
+        # Pretty-print a tree with a Formatter set to
+        # indent in a certain way and verify the results.
+        soup = self.soup("<a><b>text</b></a>")
+        formatter = Formatter(indent=indent)
+        assert soup.prettify(formatter=formatter) == expect
+
+        # Pretty-printing only happens with prettify(), not
+        # encode().
+        assert soup.encode(formatter=formatter) != expect
+        
+    def test_default_indent_value(self):
+        formatter = Formatter()
+        assert formatter.indent == ' '
+
diff --git a/lib/bs4/tests/test_html5lib.py b/lib/bs4/tests/test_html5lib.py
new file mode 100644
index 00000000..b32ab304
--- /dev/null
+++ b/lib/bs4/tests/test_html5lib.py
@@ -0,0 +1,223 @@
+"""Tests to ensure that the html5lib tree builder generates good trees."""
+
+import warnings
+
+try:
+    from bs4.builder import HTML5TreeBuilder
+    HTML5LIB_PRESENT = True
+except ImportError as e:
+    HTML5LIB_PRESENT = False
+from bs4.element import SoupStrainer
+from . import (
+    HTML5TreeBuilderSmokeTest,
+    SoupTest,
+    skipIf,
+)
+
+@skipIf(
+    not HTML5LIB_PRESENT,
+    "html5lib seems not to be present, not testing its tree builder.")
+class TestHTML5LibBuilder(SoupTest, HTML5TreeBuilderSmokeTest):
+    """See ``HTML5TreeBuilderSmokeTest``."""
+
+    @property
+    def default_builder(self):
+        return HTML5TreeBuilder
+
+    def test_soupstrainer(self):
+        # The html5lib tree builder does not support SoupStrainers.
+        strainer = SoupStrainer("b")
+        markup = "<p>A <b>bold</b> statement.</p>"
+        with warnings.catch_warnings(record=True) as w:
+            soup = self.soup(markup, parse_only=strainer)
+        assert soup.decode() == self.document_for(markup)
+
+        assert "the html5lib tree builder doesn't support parse_only" in str(w[0].message)
+
+    def test_correctly_nested_tables(self):
+        """html5lib inserts <tbody> tags where other parsers don't."""
+        markup = ('<table id="1">'
+                  '<tr>'
+                  "<td>Here's another table:"
+                  '<table id="2">'
+                  '<tr><td>foo</td></tr>'
+                  '</table></td>')
+
+        self.assert_soup(
+            markup,
+            '<table id="1"><tbody><tr><td>Here\'s another table:'
+            '<table id="2"><tbody><tr><td>foo</td></tr></tbody></table>'
+            '</td></tr></tbody></table>')
+
+        self.assert_soup(
+            "<table><thead><tr><td>Foo</td></tr></thead>"
+            "<tbody><tr><td>Bar</td></tr></tbody>"
+            "<tfoot><tr><td>Baz</td></tr></tfoot></table>")
+
+    def test_xml_declaration_followed_by_doctype(self):
+        markup = '''<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE html>
+<html>
+  <head>
+  </head>
+  <body>
+   <p>foo</p>
+  </body>
+</html>'''
+        soup = self.soup(markup)
+        # Verify that we can reach the <p> tag; this means the tree is connected.
+        assert b"<p>foo</p>" == soup.p.encode()
+
+    def test_reparented_markup(self):
+        markup = '<p><em>foo</p>\n<p>bar<a></a></em></p>'
+        soup = self.soup(markup)
+        assert "<body><p><em>foo</em></p><em>\n</em><p><em>bar<a></a></em></p></body>" == soup.body.decode()
+        assert 2 == len(soup.find_all('p'))
+
+
+    def test_reparented_markup_ends_with_whitespace(self):
+        markup = '<p><em>foo</p>\n<p>bar<a></a></em></p>\n'
+        soup = self.soup(markup)
+        assert "<body><p><em>foo</em></p><em>\n</em><p><em>bar<a></a></em></p>\n</body>" == soup.body.decode()
+        assert 2 == len(soup.find_all('p'))
+
+    def test_reparented_markup_containing_identical_whitespace_nodes(self):
+        """Verify that we keep the two whitespace nodes in this
+        document distinct when reparenting the adjacent <tbody> tags.
+        """
+        markup = '<table> <tbody><tbody><ims></tbody> </table>'
+        soup = self.soup(markup)
+        space1, space2 = soup.find_all(string=' ')
+        tbody1, tbody2 = soup.find_all('tbody')
+        assert space1.next_element is tbody1
+        assert tbody2.next_element is space2
+
+    def test_reparented_markup_containing_children(self):
+        markup = '<div><a>aftermath<p><noscript>target</noscript>aftermath</a></p></div>'
+        soup = self.soup(markup)
+        noscript = soup.noscript
+        assert "target" == noscript.next_element
+        target = soup.find(string='target')
+
+        # The 'aftermath' string was duplicated; we want the second one.
+        final_aftermath = soup.find_all(string='aftermath')[-1]
+
+        # The <noscript> tag was moved beneath a copy of the <a> tag,
+        # but the 'target' string within is still connected to the
+        # (second) 'aftermath' string.
+        assert final_aftermath == target.next_element
+        assert target == final_aftermath.previous_element
+        
+    def test_processing_instruction(self):
+        """Processing instructions become comments."""
+        markup = b"""<?PITarget PIContent?>"""
+        soup = self.soup(markup)
+        assert str(soup).startswith("<!--?PITarget PIContent?-->")
+
+    def test_cloned_multivalue_node(self):
+        markup = b"""<a class="my_class"><p></a>"""
+        soup = self.soup(markup)
+        a1, a2 = soup.find_all('a')
+        assert a1 == a2
+        assert a1 is not a2
+
+    def test_foster_parenting(self):
+        markup = b"""<table><td></tbody>A"""
+        soup = self.soup(markup)
+        assert "<body>A<table><tbody><tr><td></td></tr></tbody></table></body>" == soup.body.decode()
+
+    def test_extraction(self):
+        """
+        Test that extraction does not destroy the tree.
+
+        https://bugs.launchpad.net/beautifulsoup/+bug/1782928
+        """
+
+        markup = """
+<html><head></head>
+<style>
+</style><script></script><body><p>hello</p></body></html>
+"""
+        soup = self.soup(markup)
+        [s.extract() for s in soup('script')]
+        [s.extract() for s in soup('style')]
+
+        assert len(soup.find_all("p")) == 1
+
+    def test_empty_comment(self):
+        """
+        Test that empty comment does not break structure.
+
+        https://bugs.launchpad.net/beautifulsoup/+bug/1806598
+        """
+
+        markup = """
+<html>
+<body>
+<form>
+<!----><input type="text">
+</form>
+</body>
+</html>
+"""
+        soup = self.soup(markup)
+        inputs = []
+        for form in soup.find_all('form'):
+            inputs.extend(form.find_all('input'))
+        assert len(inputs) == 1
+
+    def test_tracking_line_numbers(self):
+        # The html.parser TreeBuilder keeps track of line number and
+        # position of each element.
+        markup = "\n   <p>\n\n<sourceline>\n<b>text</b></sourceline><sourcepos></p>"
+        soup = self.soup(markup)
+        assert 2 == soup.p.sourceline
+        assert 5 == soup.p.sourcepos
+        assert "sourceline" == soup.p.find('sourceline').name
+
+        # You can deactivate this behavior.
+        soup = self.soup(markup, store_line_numbers=False)
+        assert "sourceline" == soup.p.sourceline.name
+        assert "sourcepos" == soup.p.sourcepos.name
+
+    def test_special_string_containers(self):
+        # The html5lib tree builder doesn't support this standard feature,
+        # because there's no way of knowing, when a string is created,
+        # where in the tree it will eventually end up.
+        pass
+
+    def test_html5_attributes(self):
+        # The html5lib TreeBuilder can convert any entity named in
+        # the HTML5 spec to a sequence of Unicode characters, and
+        # convert those Unicode characters to a (potentially
+        # different) named entity on the way out.
+        #
+        # This is a copy of the same test from
+        # HTMLParserTreeBuilderSmokeTest.  It's not in the superclass
+        # because the lxml HTML TreeBuilder _doesn't_ work this way.
+        for input_element, output_unicode, output_element in (
+                ("&RightArrowLeftArrow;", '\u21c4', b'&rlarr;'),
+                ('&models;', '\u22a7', b'&models;'),
+                ('&Nfr;', '\U0001d511', b'&Nfr;'),
+                ('&ngeqq;', '\u2267\u0338', b'&ngeqq;'),
+                ('&not;', '\xac', b'&not;'),
+                ('&Not;', '\u2aec', b'&Not;'),
+                ('&quot;', '"', b'"'),
+                ('&there4;', '\u2234', b'&there4;'),
+                ('&Therefore;', '\u2234', b'&there4;'),
+                ('&therefore;', '\u2234', b'&there4;'),
+                ("&fjlig;", 'fj', b'fj'),                
+                ("&sqcup;", '\u2294', b'&sqcup;'),
+                ("&sqcups;", '\u2294\ufe00', b'&sqcups;'),
+                ("&apos;", "'", b"'"),
+                ("&verbar;", "|", b"|"),
+        ):
+            markup = '<div>%s</div>' % input_element
+            div = self.soup(markup).div
+            without_element = div.encode()
+            expect = b"<div>%s</div>" % output_unicode.encode("utf8")
+            assert without_element == expect
+
+            with_element = div.encode(formatter="html")
+            expect = b"<div>%s</div>" % output_element
+            assert with_element == expect
diff --git a/lib/bs4/tests/test_htmlparser.py b/lib/bs4/tests/test_htmlparser.py
new file mode 100644
index 00000000..bfcfa1f3
--- /dev/null
+++ b/lib/bs4/tests/test_htmlparser.py
@@ -0,0 +1,136 @@
+"""Tests to ensure that the html.parser tree builder generates good
+trees."""
+
+from pdb import set_trace
+import pickle
+import warnings
+from bs4.builder import (
+    HTMLParserTreeBuilder,
+    XMLParsedAsHTMLWarning,
+)
+from bs4.builder._htmlparser import BeautifulSoupHTMLParser
+from . import SoupTest, HTMLTreeBuilderSmokeTest
+
+class TestHTMLParserTreeBuilder(SoupTest, HTMLTreeBuilderSmokeTest):
+
+    default_builder = HTMLParserTreeBuilder
+
+    def test_namespaced_system_doctype(self):
+        # html.parser can't handle namespaced doctypes, so skip this one.
+        pass
+
+    def test_namespaced_public_doctype(self):
+        # html.parser can't handle namespaced doctypes, so skip this one.
+        pass
+
+    def test_builder_is_pickled(self):
+        """Unlike most tree builders, HTMLParserTreeBuilder and will
+        be restored after pickling.
+        """
+        tree = self.soup("<a><b>foo</a>")
+        dumped = pickle.dumps(tree, 2)
+        loaded = pickle.loads(dumped)
+        assert isinstance(loaded.builder, type(tree.builder))
+
+    def test_redundant_empty_element_closing_tags(self):
+        self.assert_soup('<br></br><br></br><br></br>', "<br/><br/><br/>")
+        self.assert_soup('</br></br></br>', "")
+
+    def test_empty_element(self):
+        # This verifies that any buffered data present when the parser
+        # finishes working is handled.
+        self.assert_soup("foo &# bar", "foo &amp;# bar")
+
+    def test_tracking_line_numbers(self):
+        # The html.parser TreeBuilder keeps track of line number and
+        # position of each element.
+        markup = "\n   <p>\n\n<sourceline>\n<b>text</b></sourceline><sourcepos></p>"
+        soup = self.soup(markup)
+        assert 2 == soup.p.sourceline
+        assert 3 == soup.p.sourcepos
+        assert "sourceline" == soup.p.find('sourceline').name
+
+        # You can deactivate this behavior.
+        soup = self.soup(markup, store_line_numbers=False)
+        assert "sourceline" == soup.p.sourceline.name
+        assert "sourcepos" == soup.p.sourcepos.name
+
+    def test_on_duplicate_attribute(self):
+        # The html.parser tree builder has a variety of ways of
+        # handling a tag that contains the same attribute multiple times.
+
+        markup = '<a class="cls" href="url1" href="url2" href="url3" id="id">'
+
+        # If you don't provide any particular value for
+        # on_duplicate_attribute, later values replace earlier values.
+        soup = self.soup(markup)
+        assert "url3" == soup.a['href']
+        assert ["cls"] == soup.a['class']
+        assert "id" == soup.a['id']
+        
+        # You can also get this behavior explicitly.
+        def assert_attribute(on_duplicate_attribute, expected):
+            soup = self.soup(
+                markup, on_duplicate_attribute=on_duplicate_attribute
+            )
+            assert expected == soup.a['href']
+
+            # Verify that non-duplicate attributes are treated normally.
+            assert ["cls"] == soup.a['class']
+            assert "id" == soup.a['id']
+        assert_attribute(None, "url3")
+        assert_attribute(BeautifulSoupHTMLParser.REPLACE, "url3")
+
+        # You can ignore subsequent values in favor of the first.
+        assert_attribute(BeautifulSoupHTMLParser.IGNORE, "url1")
+
+        # And you can pass in a callable that does whatever you want.
+        def accumulate(attrs, key, value):
+            if not isinstance(attrs[key], list):
+                attrs[key] = [attrs[key]]
+            attrs[key].append(value)
+        assert_attribute(accumulate, ["url1", "url2", "url3"])            
+
+    def test_html5_attributes(self):
+        # The html.parser TreeBuilder can convert any entity named in
+        # the HTML5 spec to a sequence of Unicode characters, and
+        # convert those Unicode characters to a (potentially
+        # different) named entity on the way out.
+        for input_element, output_unicode, output_element in (
+                ("&RightArrowLeftArrow;", '\u21c4', b'&rlarr;'),
+                ('&models;', '\u22a7', b'&models;'),
+                ('&Nfr;', '\U0001d511', b'&Nfr;'),
+                ('&ngeqq;', '\u2267\u0338', b'&ngeqq;'),
+                ('&not;', '\xac', b'&not;'),
+                ('&Not;', '\u2aec', b'&Not;'),
+                ('&quot;', '"', b'"'),
+                ('&there4;', '\u2234', b'&there4;'),
+                ('&Therefore;', '\u2234', b'&there4;'),
+                ('&therefore;', '\u2234', b'&there4;'),
+                ("&fjlig;", 'fj', b'fj'),                
+                ("&sqcup;", '\u2294', b'&sqcup;'),
+                ("&sqcups;", '\u2294\ufe00', b'&sqcups;'),
+                ("&apos;", "'", b"'"),
+                ("&verbar;", "|", b"|"),
+        ):
+            markup = '<div>%s</div>' % input_element
+            div = self.soup(markup).div
+            without_element = div.encode()
+            expect = b"<div>%s</div>" % output_unicode.encode("utf8")
+            assert without_element == expect
+
+            with_element = div.encode(formatter="html")
+            expect = b"<div>%s</div>" % output_element
+            assert with_element == expect
+
+class TestHTMLParserSubclass(SoupTest):
+    def test_error(self):
+        """Verify that our HTMLParser subclass implements error() in a way
+        that doesn't cause a crash.
+        """
+        parser = BeautifulSoupHTMLParser()
+        with warnings.catch_warnings(record=True) as warns:
+            parser.error("don't crash")
+        [warning] = warns
+        assert "don't crash" == str(warning.message)
+
diff --git a/lib/bs4/tests/test_lxml.py b/lib/bs4/tests/test_lxml.py
new file mode 100644
index 00000000..396ca0ef
--- /dev/null
+++ b/lib/bs4/tests/test_lxml.py
@@ -0,0 +1,199 @@
+"""Tests to ensure that the lxml tree builder generates good trees."""
+
+import pickle
+import re
+import warnings
+
+try:
+    import lxml.etree
+    LXML_PRESENT = True
+    LXML_VERSION = lxml.etree.LXML_VERSION
+except ImportError as e:
+    LXML_PRESENT = False
+    LXML_VERSION = (0,)
+
+if LXML_PRESENT:
+    from bs4.builder import LXMLTreeBuilder, LXMLTreeBuilderForXML
+
+from bs4 import (
+    BeautifulSoup,
+    BeautifulStoneSoup,
+    )
+from bs4.element import Comment, Doctype, SoupStrainer
+from . import (
+    HTMLTreeBuilderSmokeTest,
+    XMLTreeBuilderSmokeTest,
+    SoupTest,
+    skipIf,
+)
+
+@skipIf(
+    not LXML_PRESENT,
+    "lxml seems not to be present, not testing its tree builder.")
+class TestLXMLTreeBuilder(SoupTest, HTMLTreeBuilderSmokeTest):
+    """See ``HTMLTreeBuilderSmokeTest``."""
+
+    @property
+    def default_builder(self):
+        return LXMLTreeBuilder
+
+    def test_out_of_range_entity(self):
+        self.assert_soup(
+            "<p>foo&#10000000000000;bar</p>", "<p>foobar</p>")
+        self.assert_soup(
+            "<p>foo&#x10000000000000;bar</p>", "<p>foobar</p>")
+        self.assert_soup(
+            "<p>foo&#1000000000;bar</p>", "<p>foobar</p>")
+        
+    def test_entities_in_foreign_document_encoding(self):
+        # We can't implement this case correctly because by the time we
+        # hear about markup like "&#147;", it's been (incorrectly) converted into
+        # a string like u'\x93'
+        pass
+        
+    # In lxml < 2.3.5, an empty doctype causes a segfault. Skip this
+    # test if an old version of lxml is installed.
+
+    @skipIf(
+        not LXML_PRESENT or LXML_VERSION < (2,3,5,0),
+        "Skipping doctype test for old version of lxml to avoid segfault.")
+    def test_empty_doctype(self):
+        soup = self.soup("<!DOCTYPE>")
+        doctype = soup.contents[0]
+        assert "" == doctype.strip()
+
+    def test_beautifulstonesoup_is_xml_parser(self):
+        # Make sure that the deprecated BSS class uses an xml builder
+        # if one is installed.
+        with warnings.catch_warnings(record=True) as w:
+            soup = BeautifulStoneSoup("<b />")
+        assert "<b/>" == str(soup.b)
+        assert "BeautifulStoneSoup class is deprecated" in str(w[0].message)
+
+    def test_tracking_line_numbers(self):
+        # The lxml TreeBuilder cannot keep track of line numbers from
+        # the original markup. Even if you ask for line numbers, we
+        # don't have 'em.
+        #
+        # This means that if you have a tag like <sourceline> or
+        # <sourcepos>, attribute access will find it rather than
+        # giving you a numeric answer.
+        soup = self.soup(
+            "\n   <p>\n\n<sourceline>\n<b>text</b></sourceline><sourcepos></p>",
+            store_line_numbers=True
+        )
+        assert "sourceline" == soup.p.sourceline.name
+        assert "sourcepos" == soup.p.sourcepos.name
+        
+@skipIf(
+    not LXML_PRESENT,
+    "lxml seems not to be present, not testing its XML tree builder.")
+class TestLXMLXMLTreeBuilder(SoupTest, XMLTreeBuilderSmokeTest):
+    """See ``HTMLTreeBuilderSmokeTest``."""
+
+    @property
+    def default_builder(self):
+        return LXMLTreeBuilderForXML
+
+    def test_namespace_indexing(self):
+        soup = self.soup(
+            '<?xml version="1.1"?>\n'
+            '<root>'
+            '<tag xmlns="http://unprefixed-namespace.com">content</tag>'
+            '<prefix:tag2 xmlns:prefix="http://prefixed-namespace.com">content</prefix:tag2>'
+            '<prefix2:tag3 xmlns:prefix2="http://another-namespace.com">'
+            '<subtag xmlns="http://another-unprefixed-namespace.com">'
+            '<subsubtag xmlns="http://yet-another-unprefixed-namespace.com">'
+            '</prefix2:tag3>'
+            '</root>'
+        )
+
+        # The BeautifulSoup object includes every namespace prefix
+        # defined in the entire document. This is the default set of
+        # namespaces used by soupsieve.
+        #
+        # Un-prefixed namespaces are not included, and if a given
+        # prefix is defined twice, only the first prefix encountered
+        # in the document shows up here.
+        assert soup._namespaces == {
+            'xml': 'http://www.w3.org/XML/1998/namespace',
+            'prefix': 'http://prefixed-namespace.com',
+            'prefix2': 'http://another-namespace.com'
+        }
+
+        # A Tag object includes only the namespace prefixes
+        # that were in scope when it was parsed.
+
+        # We do not track un-prefixed namespaces as we can only hold
+        # one (the first one), and it will be recognized as the
+        # default namespace by soupsieve, even when operating from a
+        # tag with a different un-prefixed namespace.
+        assert soup.tag._namespaces == {
+            'xml': 'http://www.w3.org/XML/1998/namespace',
+        }
+
+        assert soup.tag2._namespaces == {
+            'prefix': 'http://prefixed-namespace.com',
+            'xml': 'http://www.w3.org/XML/1998/namespace',
+        }
+
+        assert soup.subtag._namespaces == {
+            'prefix2': 'http://another-namespace.com',
+            'xml': 'http://www.w3.org/XML/1998/namespace',
+        }
+
+        assert soup.subsubtag._namespaces == {
+            'prefix2': 'http://another-namespace.com',
+            'xml': 'http://www.w3.org/XML/1998/namespace',
+        }
+
+
+    def test_namespace_interaction_with_select_and_find(self):
+        # Demonstrate how namespaces interact with select* and
+        # find* methods.
+        
+        soup = self.soup(
+            '<?xml version="1.1"?>\n'
+            '<root>'
+            '<tag xmlns="http://unprefixed-namespace.com">content</tag>'
+            '<prefix:tag2 xmlns:prefix="http://prefixed-namespace.com">content</tag>'
+            '<subtag xmlns:prefix="http://another-namespace-same-prefix.com">'
+             '<prefix:tag3>'
+            '</subtag>'
+            '</root>'
+        )
+
+        # soupselect uses namespace URIs.
+        assert soup.select_one('tag').name == 'tag'
+        assert soup.select_one('prefix|tag2').name == 'tag2'
+
+        # If a prefix is declared more than once, only the first usage
+        # is registered with the BeautifulSoup object.
+        assert soup.select_one('prefix|tag3') is None
+
+        # But you can always explicitly specify a namespace dictionary.
+        assert soup.select_one(
+            'prefix|tag3', namespaces=soup.subtag._namespaces
+        ).name == 'tag3'
+
+        # And a Tag (as opposed to the BeautifulSoup object) will
+        # have a set of default namespaces scoped to that Tag.
+        assert soup.subtag.select_one('prefix|tag3').name=='tag3'
+
+        # the find() methods aren't fully namespace-aware; they just
+        # look at prefixes.
+        assert soup.find('tag').name == 'tag'
+        assert soup.find('prefix:tag2').name == 'tag2'
+        assert soup.find('prefix:tag3').name == 'tag3'
+        assert soup.subtag.find('prefix:tag3').name == 'tag3'
+
+    def test_pickle_removes_builder(self):
+        # The lxml TreeBuilder is not picklable, so it won't be
+        # preserved in a pickle/unpickle operation.
+
+        soup = self.soup("<a>some markup</a>")
+        assert isinstance(soup.builder, self.default_builder)
+        pickled = pickle.dumps(soup)
+        unpickled = pickle.loads(pickled)
+        assert "some markup" == unpickled.a.string
+        assert unpickled.builder is None
diff --git a/lib/bs4/tests/test_navigablestring.py b/lib/bs4/tests/test_navigablestring.py
new file mode 100644
index 00000000..e4c179e9
--- /dev/null
+++ b/lib/bs4/tests/test_navigablestring.py
@@ -0,0 +1,144 @@
+import pytest
+
+from bs4.element import (
+    CData,
+    Comment,
+    Declaration,
+    Doctype,
+    NavigableString,
+    RubyParenthesisString,
+    RubyTextString,
+    Script,
+    Stylesheet,
+    TemplateString,
+)
+
+from . import SoupTest
+
+class TestNavigableString(SoupTest):
+
+    def test_text_acquisition_methods(self):
+        # These methods are intended for use against Tag, but they
+        # work on NavigableString as well,
+        
+        s = NavigableString("fee ")
+        cdata = CData("fie ")
+        comment = Comment("foe ")
+
+        assert "fee " == s.get_text()
+        assert "fee" == s.get_text(strip=True)
+        assert ["fee "] == list(s.strings)
+        assert ["fee"] == list(s.stripped_strings)
+        assert ["fee "] == list(s._all_strings())
+
+        assert "fie " == cdata.get_text()
+        assert "fie" == cdata.get_text(strip=True)
+        assert ["fie "] == list(cdata.strings)
+        assert ["fie"] == list(cdata.stripped_strings)
+        assert ["fie "] == list(cdata._all_strings())
+        
+        # Since a Comment isn't normally considered 'text',
+        # these methods generally do nothing.
+        assert "" == comment.get_text()
+        assert [] == list(comment.strings)
+        assert [] == list(comment.stripped_strings)
+        assert [] == list(comment._all_strings())
+
+        # Unless you specifically say that comments are okay.
+        assert "foe" == comment.get_text(strip=True, types=Comment)
+        assert "foe " == comment.get_text(types=(Comment, NavigableString))
+
+    def test_string_has_immutable_name_property(self):
+        # string.name is defined as None and can't be modified
+        string = self.soup("s").string
+        assert None == string.name
+        with pytest.raises(AttributeError):
+            string.name = 'foo'
+
+class TestNavigableStringSubclasses(SoupTest):
+
+    def test_cdata(self):
+        # None of the current builders turn CDATA sections into CData
+        # objects, but you can create them manually.
+        soup = self.soup("")
+        cdata = CData("foo")
+        soup.insert(1, cdata)
+        assert str(soup) == "<![CDATA[foo]]>"
+        assert soup.find(string="foo") == "foo"
+        assert soup.contents[0] == "foo"
+
+    def test_cdata_is_never_formatted(self):
+        """Text inside a CData object is passed into the formatter.
+
+        But the return value is ignored.
+        """
+
+        self.count = 0
+        def increment(*args):
+            self.count += 1
+            return "BITTER FAILURE"
+
+        soup = self.soup("")
+        cdata = CData("<><><>")
+        soup.insert(1, cdata)
+        assert b"<![CDATA[<><><>]]>" == soup.encode(formatter=increment)
+        assert 1 == self.count
+
+    def test_doctype_ends_in_newline(self):
+        # Unlike other NavigableString subclasses, a DOCTYPE always ends
+        # in a newline.
+        doctype = Doctype("foo")
+        soup = self.soup("")
+        soup.insert(1, doctype)
+        assert soup.encode() == b"<!DOCTYPE foo>\n"
+
+    def test_declaration(self):
+        d = Declaration("foo")
+        assert "<?foo?>" == d.output_ready()
+
+    def test_default_string_containers(self):
+        # In some cases, we use different NavigableString subclasses for
+        # the same text in different tags.
+        soup = self.soup(
+            "<div>text</div><script>text</script><style>text</style>"
+        )
+        assert [NavigableString, Script, Stylesheet] == [
+            x.__class__ for x in soup.find_all(string=True)
+        ]
+
+        # The TemplateString is a little unusual because it's generally found
+        # _inside_ children of a <template> element, not a direct child of the
+        # <template> element.
+        soup = self.soup(
+            "<template>Some text<p>In a tag</p></template>Some text outside"
+        )
+        assert all(
+            isinstance(x, TemplateString)
+            for x in soup.template._all_strings(types=None)
+        )
+        
+        # Once the <template> tag closed, we went back to using
+        # NavigableString.
+        outside = soup.template.next_sibling
+        assert isinstance(outside, NavigableString)
+        assert not isinstance(outside, TemplateString)
+
+        # The TemplateString is also unusual because it can contain
+        # NavigableString subclasses of _other_ types, such as
+        # Comment.
+        markup = b"<template>Some text<p>In a tag</p><!--with a comment--></template>"
+        soup = self.soup(markup)
+        assert markup == soup.template.encode("utf8")
+
+    def test_ruby_strings(self):
+        markup = "<ruby>漢 <rp>(</rp><rt>kan</rt><rp>)</rp> 字 <rp>(</rp><rt>ji</rt><rp>)</rp></ruby>"
+        soup = self.soup(markup)
+        assert isinstance(soup.rp.string, RubyParenthesisString)
+        assert isinstance(soup.rt.string, RubyTextString)
+
+        # Just as a demo, here's what this means for get_text usage.
+        assert "漢字" == soup.get_text(strip=True)
+        assert "漢(kan)字(ji)" == soup.get_text(
+            strip=True,
+            types=(NavigableString, RubyTextString, RubyParenthesisString)
+        )
diff --git a/lib/bs4/tests/test_pageelement.py b/lib/bs4/tests/test_pageelement.py
new file mode 100644
index 00000000..26783f2c
--- /dev/null
+++ b/lib/bs4/tests/test_pageelement.py
@@ -0,0 +1,751 @@
+"""Tests of the bs4.element.PageElement class"""
+import copy
+import pickle
+import pytest
+
+from soupsieve import SelectorSyntaxError
+
+from bs4 import BeautifulSoup
+from bs4.element import (
+    Comment,
+    SoupStrainer,
+)
+from . import SoupTest
+
+
+class TestEncoding(SoupTest):
+    """Test the ability to encode objects into strings."""
+
+    def test_unicode_string_can_be_encoded(self):
+        html = "<b>\N{SNOWMAN}</b>"
+        soup = self.soup(html)
+        assert soup.b.string.encode("utf-8") == "\N{SNOWMAN}".encode("utf-8")
+
+    def test_tag_containing_unicode_string_can_be_encoded(self):
+        html = "<b>\N{SNOWMAN}</b>"
+        soup = self.soup(html)
+        assert soup.b.encode("utf-8") == html.encode("utf-8")
+
+    def test_encoding_substitutes_unrecognized_characters_by_default(self):
+        html = "<b>\N{SNOWMAN}</b>"
+        soup = self.soup(html)
+        assert soup.b.encode("ascii") == b"<b>&#9731;</b>"
+
+    def test_encoding_can_be_made_strict(self):
+        html = "<b>\N{SNOWMAN}</b>"
+        soup = self.soup(html)
+        with pytest.raises(UnicodeEncodeError):
+            soup.encode("ascii", errors="strict")
+
+    def test_decode_contents(self):
+        html = "<b>\N{SNOWMAN}</b>"
+        soup = self.soup(html)
+        assert "\N{SNOWMAN}" == soup.b.decode_contents()
+
+    def test_encode_contents(self):
+        html = "<b>\N{SNOWMAN}</b>"
+        soup = self.soup(html)
+        assert "\N{SNOWMAN}".encode("utf8") == soup.b.encode_contents(
+            encoding="utf8"
+        )
+
+    def test_deprecated_renderContents(self):
+        html = "<b>\N{SNOWMAN}</b>"
+        soup = self.soup(html)
+        assert "\N{SNOWMAN}".encode("utf8") == soup.b.renderContents()
+
+    def test_repr(self):
+        html = "<b>\N{SNOWMAN}</b>"
+        soup = self.soup(html)
+        assert html == repr(soup)
+
+        
+class TestFormatters(SoupTest):
+    """Test the formatting feature, used by methods like decode() and
+    prettify(), and the formatters themselves.
+    """
+    
+    def test_default_formatter_is_minimal(self):
+        markup = "<b>&lt;&lt;Sacr\N{LATIN SMALL LETTER E WITH ACUTE} bleu!&gt;&gt;</b>"
+        soup = self.soup(markup)
+        decoded = soup.decode(formatter="minimal")
+        # The < is converted back into &lt; but the e-with-acute is left alone.
+        assert decoded == self.document_for(
+                "<b>&lt;&lt;Sacr\N{LATIN SMALL LETTER E WITH ACUTE} bleu!&gt;&gt;</b>"
+        )
+
+    def test_formatter_html(self):
+        markup = "<br><b>&lt;&lt;Sacr\N{LATIN SMALL LETTER E WITH ACUTE} bleu!&gt;&gt;</b>"
+        soup = self.soup(markup)
+        decoded = soup.decode(formatter="html")
+        assert decoded == self.document_for(
+            "<br/><b>&lt;&lt;Sacr&eacute; bleu!&gt;&gt;</b>"
+        )
+
+    def test_formatter_html5(self):
+        markup = "<br><b>&lt;&lt;Sacr\N{LATIN SMALL LETTER E WITH ACUTE} bleu!&gt;&gt;</b>"
+        soup = self.soup(markup)
+        decoded = soup.decode(formatter="html5")
+        assert decoded == self.document_for(
+            "<br><b>&lt;&lt;Sacr&eacute; bleu!&gt;&gt;</b>"
+        )
+        
+    def test_formatter_minimal(self):
+        markup = "<b>&lt;&lt;Sacr\N{LATIN SMALL LETTER E WITH ACUTE} bleu!&gt;&gt;</b>"
+        soup = self.soup(markup)
+        decoded = soup.decode(formatter="minimal")
+        # The < is converted back into &lt; but the e-with-acute is left alone.
+        assert decoded == self.document_for(
+                "<b>&lt;&lt;Sacr\N{LATIN SMALL LETTER E WITH ACUTE} bleu!&gt;&gt;</b>"
+        )
+
+    def test_formatter_null(self):
+        markup = "<b>&lt;&lt;Sacr\N{LATIN SMALL LETTER E WITH ACUTE} bleu!&gt;&gt;</b>"
+        soup = self.soup(markup)
+        decoded = soup.decode(formatter=None)
+        # Neither the angle brackets nor the e-with-acute are converted.
+        # This is not valid HTML, but it's what the user wanted.
+        assert decoded == self.document_for(
+            "<b><<Sacr\N{LATIN SMALL LETTER E WITH ACUTE} bleu!>></b>"
+        )
+
+    def test_formatter_custom(self):
+        markup = "<b>&lt;foo&gt;</b><b>bar</b><br/>"
+        soup = self.soup(markup)
+        decoded = soup.decode(formatter = lambda x: x.upper())
+        # Instead of normal entity conversion code, the custom
+        # callable is called on every string.
+        assert decoded == self.document_for("<b><FOO></b><b>BAR</b><br/>")
+
+    def test_formatter_is_run_on_attribute_values(self):
+        markup = '<a href="http://a.com?a=b&c=é">e</a>'
+        soup = self.soup(markup)
+        a = soup.a
+
+        expect_minimal = '<a href="http://a.com?a=b&amp;c=é">e</a>'
+
+        assert expect_minimal == a.decode()
+        assert expect_minimal == a.decode(formatter="minimal")
+
+        expect_html = '<a href="http://a.com?a=b&amp;c=&eacute;">e</a>'
+        assert expect_html == a.decode(formatter="html")
+
+        assert markup == a.decode(formatter=None)
+        expect_upper = '<a href="HTTP://A.COM?A=B&C=É">E</a>'
+        assert expect_upper == a.decode(formatter=lambda x: x.upper())
+
+    def test_formatter_skips_script_tag_for_html_documents(self):
+        doc = """
+  <script type="text/javascript">
+   console.log("< < hey > > ");
+  </script>
+"""
+        encoded = BeautifulSoup(doc, 'html.parser').encode()
+        assert b"< < hey > >" in encoded
+
+    def test_formatter_skips_style_tag_for_html_documents(self):
+        doc = """
+  <style type="text/css">
+   console.log("< < hey > > ");
+  </style>
+"""
+        encoded = BeautifulSoup(doc, 'html.parser').encode()
+        assert b"< < hey > >" in encoded
+
+    def test_prettify_leaves_preformatted_text_alone(self):
+        soup = self.soup("<div>  foo  <pre>  \tbar\n  \n  </pre>  baz  <textarea> eee\nfff\t</textarea></div>")
+        # Everything outside the <pre> tag is reformatted, but everything
+        # inside is left alone.
+        assert '<div>\n foo\n <pre>  \tbar\n  \n  </pre>\n baz\n <textarea> eee\nfff\t</textarea>\n</div>' == soup.div.prettify()
+
+    def test_prettify_accepts_formatter_function(self):
+        soup = BeautifulSoup("<html><body>foo</body></html>", 'html.parser')
+        pretty = soup.prettify(formatter = lambda x: x.upper())
+        assert "FOO" in pretty
+
+    def test_prettify_outputs_unicode_by_default(self):
+        soup = self.soup("<a></a>")
+        assert str == type(soup.prettify())
+
+    def test_prettify_can_encode_data(self):
+        soup = self.soup("<a></a>")
+        assert bytes == type(soup.prettify("utf-8"))
+
+    def test_html_entity_substitution_off_by_default(self):
+        markup = "<b>Sacr\N{LATIN SMALL LETTER E WITH ACUTE} bleu!</b>"
+        soup = self.soup(markup)
+        encoded = soup.b.encode("utf-8")
+        assert encoded == markup.encode('utf-8')
+
+    def test_encoding_substitution(self):
+        # Here's the <meta> tag saying that a document is
+        # encoded in Shift-JIS.
+        meta_tag = ('<meta content="text/html; charset=x-sjis" '
+                    'http-equiv="Content-type"/>')
+        soup = self.soup(meta_tag)
+
+        # Parse the document, and the charset apprears unchanged.
+        assert soup.meta['content'] == 'text/html; charset=x-sjis'
+
+        # Encode the document into some encoding, and the encoding is
+        # substituted into the meta tag.
+        utf_8 = soup.encode("utf-8")
+        assert b"charset=utf-8" in utf_8
+
+        euc_jp = soup.encode("euc_jp")
+        assert b"charset=euc_jp" in euc_jp
+
+        shift_jis = soup.encode("shift-jis")
+        assert b"charset=shift-jis" in shift_jis
+
+        utf_16_u = soup.encode("utf-16").decode("utf-16")
+        assert "charset=utf-16" in utf_16_u
+
+    def test_encoding_substitution_doesnt_happen_if_tag_is_strained(self):
+        markup = ('<head><meta content="text/html; charset=x-sjis" '
+                    'http-equiv="Content-type"/></head><pre>foo</pre>')
+
+        # Beautiful Soup used to try to rewrite the meta tag even if the
+        # meta tag got filtered out by the strainer. This test makes
+        # sure that doesn't happen.
+        strainer = SoupStrainer('pre')
+        soup = self.soup(markup, parse_only=strainer)
+        assert soup.contents[0].name == 'pre'
+
+
+class TestCSSSelectors(SoupTest):
+    """Test basic CSS selector functionality.
+
+    This functionality is implemented in soupsieve, which has a much
+    more comprehensive test suite, so this is basically an extra check
+    that soupsieve works as expected.
+    """
+
+    HTML = """
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
+"http://www.w3.org/TR/html4/strict.dtd">
+<html>
+<head>
+<title>The title</title>
+<link rel="stylesheet" href="blah.css" type="text/css" id="l1">
+</head>
+<body>
+<custom-dashed-tag class="dashed" id="dash1">Hello there.</custom-dashed-tag>
+<div id="main" class="fancy">
+<div id="inner">
+<h1 id="header1">An H1</h1>
+<p>Some text</p>
+<p class="onep" id="p1">Some more text</p>
+<h2 id="header2">An H2</h2>
+<p class="class1 class2 class3" id="pmulti">Another</p>
+<a href="http://bob.example.org/" rel="friend met" id="bob">Bob</a>
+<h2 id="header3">Another H2</h2>
+<a id="me" href="http://simonwillison.net/" rel="me">me</a>
+<span class="s1">
+<a href="#" id="s1a1">span1a1</a>
+<a href="#" id="s1a2">span1a2 <span id="s1a2s1">test</span></a>
+<span class="span2">
+<a href="#" id="s2a1">span2a1</a>
+</span>
+<span class="span3"></span>
+<custom-dashed-tag class="dashed" id="dash2"/>
+<div data-tag="dashedvalue" id="data1"/>
+</span>
+</div>
+<x id="xid">
+<z id="zida"/>
+<z id="zidab"/>
+<z id="zidac"/>
+</x>
+<y id="yid">
+<z id="zidb"/>
+</y>
+<p lang="en" id="lang-en">English</p>
+<p lang="en-gb" id="lang-en-gb">English UK</p>
+<p lang="en-us" id="lang-en-us">English US</p>
+<p lang="fr" id="lang-fr">French</p>
+</div>
+
+<div id="footer">
+</div>
+"""
+
+    def setup_method(self):
+        self.soup = BeautifulSoup(self.HTML, 'html.parser')
+
+    def assert_selects(self, selector, expected_ids, **kwargs):
+        el_ids = [el['id'] for el in self.soup.select(selector, **kwargs)]
+        el_ids.sort()
+        expected_ids.sort()
+        assert expected_ids == el_ids, "Selector %s, expected [%s], got [%s]" % (
+                selector, ', '.join(expected_ids), ', '.join(el_ids)
+        )
+
+    assertSelect = assert_selects
+
+    def assert_select_multiple(self, *tests):
+        for selector, expected_ids in tests:
+            self.assert_selects(selector, expected_ids)
+
+    def test_one_tag_one(self):
+        els = self.soup.select('title')
+        assert len(els) == 1
+        assert els[0].name == 'title'
+        assert els[0].contents == ['The title']
+
+    def test_one_tag_many(self):
+        els = self.soup.select('div')
+        assert len(els) == 4
+        for div in els:
+            assert div.name == 'div'
+
+        el = self.soup.select_one('div')
+        assert 'main' == el['id']
+
+    def test_select_one_returns_none_if_no_match(self):
+        match = self.soup.select_one('nonexistenttag')
+        assert None == match
+
+
+    def test_tag_in_tag_one(self):
+        els = self.soup.select('div div')
+        self.assert_selects('div div', ['inner', 'data1'])
+
+    def test_tag_in_tag_many(self):
+        for selector in ('html div', 'html body div', 'body div'):
+            self.assert_selects(selector, ['data1', 'main', 'inner', 'footer'])
+
+
+    def test_limit(self):
+        self.assert_selects('html div', ['main'], limit=1)
+        self.assert_selects('html body div', ['inner', 'main'], limit=2)
+        self.assert_selects('body div', ['data1', 'main', 'inner', 'footer'],
+                           limit=10)
+
+    def test_tag_no_match(self):
+        assert len(self.soup.select('del')) == 0
+
+    def test_invalid_tag(self):
+        with pytest.raises(SelectorSyntaxError):
+            self.soup.select('tag%t')
+
+    def test_select_dashed_tag_ids(self):
+        self.assert_selects('custom-dashed-tag', ['dash1', 'dash2'])
+
+    def test_select_dashed_by_id(self):
+        dashed = self.soup.select('custom-dashed-tag[id=\"dash2\"]')
+        assert dashed[0].name == 'custom-dashed-tag'
+        assert dashed[0]['id'] == 'dash2'
+
+    def test_dashed_tag_text(self):
+        assert self.soup.select('body > custom-dashed-tag')[0].text == 'Hello there.'
+
+    def test_select_dashed_matches_find_all(self):
+        assert self.soup.select('custom-dashed-tag') == self.soup.find_all('custom-dashed-tag')
+
+    def test_header_tags(self):
+        self.assert_select_multiple(
+            ('h1', ['header1']),
+            ('h2', ['header2', 'header3']),
+        )
+
+    def test_class_one(self):
+        for selector in ('.onep', 'p.onep', 'html p.onep'):
+            els = self.soup.select(selector)
+            assert len(els) == 1
+            assert els[0].name == 'p'
+            assert els[0]['class'] == ['onep']
+
+    def test_class_mismatched_tag(self):
+        els = self.soup.select('div.onep')
+        assert len(els) == 0
+
+    def test_one_id(self):
+        for selector in ('div#inner', '#inner', 'div div#inner'):
+            self.assert_selects(selector, ['inner'])
+
+    def test_bad_id(self):
+        els = self.soup.select('#doesnotexist')
+        assert len(els) == 0
+
+    def test_items_in_id(self):
+        els = self.soup.select('div#inner p')
+        assert len(els) == 3
+        for el in els:
+            assert el.name == 'p'
+        assert els[1]['class'] == ['onep']
+        assert not els[0].has_attr('class')
+
+    def test_a_bunch_of_emptys(self):
+        for selector in ('div#main del', 'div#main div.oops', 'div div#main'):
+            assert len(self.soup.select(selector)) == 0
+
+    def test_multi_class_support(self):
+        for selector in ('.class1', 'p.class1', '.class2', 'p.class2',
+            '.class3', 'p.class3', 'html p.class2', 'div#inner .class2'):
+            self.assert_selects(selector, ['pmulti'])
+
+    def test_multi_class_selection(self):
+        for selector in ('.class1.class3', '.class3.class2',
+                         '.class1.class2.class3'):
+            self.assert_selects(selector, ['pmulti'])
+
+    def test_child_selector(self):
+        self.assert_selects('.s1 > a', ['s1a1', 's1a2'])
+        self.assert_selects('.s1 > a span', ['s1a2s1'])
+
+    def test_child_selector_id(self):
+        self.assert_selects('.s1 > a#s1a2 span', ['s1a2s1'])
+
+    def test_attribute_equals(self):
+        self.assert_select_multiple(
+            ('p[class="onep"]', ['p1']),
+            ('p[id="p1"]', ['p1']),
+            ('[class="onep"]', ['p1']),
+            ('[id="p1"]', ['p1']),
+            ('link[rel="stylesheet"]', ['l1']),
+            ('link[type="text/css"]', ['l1']),
+            ('link[href="blah.css"]', ['l1']),
+            ('link[href="no-blah.css"]', []),
+            ('[rel="stylesheet"]', ['l1']),
+            ('[type="text/css"]', ['l1']),
+            ('[href="blah.css"]', ['l1']),
+            ('[href="no-blah.css"]', []),
+            ('p[href="no-blah.css"]', []),
+            ('[href="no-blah.css"]', []),
+        )
+
+    def test_attribute_tilde(self):
+        self.assert_select_multiple(
+            ('p[class~="class1"]', ['pmulti']),
+            ('p[class~="class2"]', ['pmulti']),
+            ('p[class~="class3"]', ['pmulti']),
+            ('[class~="class1"]', ['pmulti']),
+            ('[class~="class2"]', ['pmulti']),
+            ('[class~="class3"]', ['pmulti']),
+            ('a[rel~="friend"]', ['bob']),
+            ('a[rel~="met"]', ['bob']),
+            ('[rel~="friend"]', ['bob']),
+            ('[rel~="met"]', ['bob']),
+        )
+
+    def test_attribute_startswith(self):
+        self.assert_select_multiple(
+            ('[rel^="style"]', ['l1']),
+            ('link[rel^="style"]', ['l1']),
+            ('notlink[rel^="notstyle"]', []),
+            ('[rel^="notstyle"]', []),
+            ('link[rel^="notstyle"]', []),
+            ('link[href^="bla"]', ['l1']),
+            ('a[href^="http://"]', ['bob', 'me']),
+            ('[href^="http://"]', ['bob', 'me']),
+            ('[id^="p"]', ['pmulti', 'p1']),
+            ('[id^="m"]', ['me', 'main']),
+            ('div[id^="m"]', ['main']),
+            ('a[id^="m"]', ['me']),
+            ('div[data-tag^="dashed"]', ['data1'])
+        )
+
+    def test_attribute_endswith(self):
+        self.assert_select_multiple(
+            ('[href$=".css"]', ['l1']),
+            ('link[href$=".css"]', ['l1']),
+            ('link[id$="1"]', ['l1']),
+            ('[id$="1"]', ['data1', 'l1', 'p1', 'header1', 's1a1', 's2a1', 's1a2s1', 'dash1']),
+            ('div[id$="1"]', ['data1']),
+            ('[id$="noending"]', []),
+        )
+
+    def test_attribute_contains(self):
+        self.assert_select_multiple(
+            # From test_attribute_startswith
+            ('[rel*="style"]', ['l1']),
+            ('link[rel*="style"]', ['l1']),
+            ('notlink[rel*="notstyle"]', []),
+            ('[rel*="notstyle"]', []),
+            ('link[rel*="notstyle"]', []),
+            ('link[href*="bla"]', ['l1']),
+            ('[href*="http://"]', ['bob', 'me']),
+            ('[id*="p"]', ['pmulti', 'p1']),
+            ('div[id*="m"]', ['main']),
+            ('a[id*="m"]', ['me']),
+            # From test_attribute_endswith
+            ('[href*=".css"]', ['l1']),
+            ('link[href*=".css"]', ['l1']),
+            ('link[id*="1"]', ['l1']),
+            ('[id*="1"]', ['data1', 'l1', 'p1', 'header1', 's1a1', 's1a2', 's2a1', 's1a2s1', 'dash1']),
+            ('div[id*="1"]', ['data1']),
+            ('[id*="noending"]', []),
+            # New for this test
+            ('[href*="."]', ['bob', 'me', 'l1']),
+            ('a[href*="."]', ['bob', 'me']),
+            ('link[href*="."]', ['l1']),
+            ('div[id*="n"]', ['main', 'inner']),
+            ('div[id*="nn"]', ['inner']),
+            ('div[data-tag*="edval"]', ['data1'])
+        )
+
+    def test_attribute_exact_or_hypen(self):
+        self.assert_select_multiple(
+            ('p[lang|="en"]', ['lang-en', 'lang-en-gb', 'lang-en-us']),
+            ('[lang|="en"]', ['lang-en', 'lang-en-gb', 'lang-en-us']),
+            ('p[lang|="fr"]', ['lang-fr']),
+            ('p[lang|="gb"]', []),
+        )
+
+    def test_attribute_exists(self):
+        self.assert_select_multiple(
+            ('[rel]', ['l1', 'bob', 'me']),
+            ('link[rel]', ['l1']),
+            ('a[rel]', ['bob', 'me']),
+            ('[lang]', ['lang-en', 'lang-en-gb', 'lang-en-us', 'lang-fr']),
+            ('p[class]', ['p1', 'pmulti']),
+            ('[blah]', []),
+            ('p[blah]', []),
+            ('div[data-tag]', ['data1'])
+        )
+
+    def test_quoted_space_in_selector_name(self):
+        html = """<div style="display: wrong">nope</div>
+        <div style="display: right">yes</div>
+        """
+        soup = BeautifulSoup(html, 'html.parser')
+        [chosen] = soup.select('div[style="display: right"]')
+        assert "yes" == chosen.string
+
+    def test_unsupported_pseudoclass(self):
+        with pytest.raises(NotImplementedError):
+            self.soup.select("a:no-such-pseudoclass")
+
+        with pytest.raises(SelectorSyntaxError):
+            self.soup.select("a:nth-of-type(a)")
+
+    def test_nth_of_type(self):
+        # Try to select first paragraph
+        els = self.soup.select('div#inner p:nth-of-type(1)')
+        assert len(els) == 1
+        assert els[0].string == 'Some text'
+
+        # Try to select third paragraph
+        els = self.soup.select('div#inner p:nth-of-type(3)')
+        assert len(els) == 1
+        assert els[0].string == 'Another'
+
+        # Try to select (non-existent!) fourth paragraph
+        els = self.soup.select('div#inner p:nth-of-type(4)')
+        assert len(els) == 0
+
+        # Zero will select no tags.
+        els = self.soup.select('div p:nth-of-type(0)')
+        assert len(els) == 0
+
+    def test_nth_of_type_direct_descendant(self):
+        els = self.soup.select('div#inner > p:nth-of-type(1)')
+        assert len(els) == 1
+        assert els[0].string == 'Some text'
+
+    def test_id_child_selector_nth_of_type(self):
+        self.assert_selects('#inner > p:nth-of-type(2)', ['p1'])
+
+    def test_select_on_element(self):
+        # Other tests operate on the tree; this operates on an element
+        # within the tree.
+        inner = self.soup.find("div", id="main")
+        selected = inner.select("div")
+        # The <div id="inner"> tag was selected. The <div id="footer">
+        # tag was not.
+        self.assert_selects_ids(selected, ['inner', 'data1'])
+
+    def test_overspecified_child_id(self):
+        self.assert_selects(".fancy #inner", ['inner'])
+        self.assert_selects(".normal #inner", [])
+
+    def test_adjacent_sibling_selector(self):
+        self.assert_selects('#p1 + h2', ['header2'])
+        self.assert_selects('#p1 + h2 + p', ['pmulti'])
+        self.assert_selects('#p1 + #header2 + .class1', ['pmulti'])
+        assert [] == self.soup.select('#p1 + p')
+
+    def test_general_sibling_selector(self):
+        self.assert_selects('#p1 ~ h2', ['header2', 'header3'])
+        self.assert_selects('#p1 ~ #header2', ['header2'])
+        self.assert_selects('#p1 ~ h2 + a', ['me'])
+        self.assert_selects('#p1 ~ h2 + [rel="me"]', ['me'])
+        assert [] == self.soup.select('#inner ~ h2')
+
+    def test_dangling_combinator(self):
+        with pytest.raises(SelectorSyntaxError):
+            self.soup.select('h1 >')
+
+    def test_sibling_combinator_wont_select_same_tag_twice(self):
+        self.assert_selects('p[lang] ~ p', ['lang-en-gb', 'lang-en-us', 'lang-fr'])
+
+    # Test the selector grouping operator (the comma)
+    def test_multiple_select(self):
+        self.assert_selects('x, y', ['xid', 'yid'])
+
+    def test_multiple_select_with_no_space(self):
+        self.assert_selects('x,y', ['xid', 'yid'])
+
+    def test_multiple_select_with_more_space(self):
+        self.assert_selects('x,    y', ['xid', 'yid'])
+
+    def test_multiple_select_duplicated(self):
+        self.assert_selects('x, x', ['xid'])
+
+    def test_multiple_select_sibling(self):
+        self.assert_selects('x, y ~ p[lang=fr]', ['xid', 'lang-fr'])
+
+    def test_multiple_select_tag_and_direct_descendant(self):
+        self.assert_selects('x, y > z', ['xid', 'zidb'])
+
+    def test_multiple_select_direct_descendant_and_tags(self):
+        self.assert_selects('div > x, y, z', ['xid', 'yid', 'zida', 'zidb', 'zidab', 'zidac'])
+
+    def test_multiple_select_indirect_descendant(self):
+        self.assert_selects('div x,y,  z', ['xid', 'yid', 'zida', 'zidb', 'zidab', 'zidac'])
+
+    def test_invalid_multiple_select(self):
+        with pytest.raises(SelectorSyntaxError):
+            self.soup.select(',x, y')
+        with pytest.raises(SelectorSyntaxError):
+            self.soup.select('x,,y')
+
+    def test_multiple_select_attrs(self):
+        self.assert_selects('p[lang=en], p[lang=en-gb]', ['lang-en', 'lang-en-gb'])
+
+    def test_multiple_select_ids(self):
+        self.assert_selects('x, y > z[id=zida], z[id=zidab], z[id=zidb]', ['xid', 'zidb', 'zidab'])
+
+    def test_multiple_select_nested(self):
+        self.assert_selects('body > div > x, y > z', ['xid', 'zidb'])
+
+    def test_select_duplicate_elements(self):
+        # When markup contains duplicate elements, a multiple select
+        # will find all of them.
+        markup = '<div class="c1"/><div class="c2"/><div class="c1"/>'
+        soup = BeautifulSoup(markup, 'html.parser')
+        selected = soup.select(".c1, .c2")
+        assert 3 == len(selected)
+
+        # Verify that find_all finds the same elements, though because
+        # of an implementation detail it finds them in a different
+        # order.
+        for element in soup.find_all(class_=['c1', 'c2']):
+            assert element in selected
+
+
+class TestPersistence(SoupTest):
+    "Testing features like pickle and deepcopy."
+
+    def setup_method(self):
+        self.page = """<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"
+"http://www.w3.org/TR/REC-html40/transitional.dtd">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<title>Beautiful Soup: We called him Tortoise because he taught us.</title>
+<link rev="made" href="mailto:leonardr@segfault.org">
+<meta name="Description" content="Beautiful Soup: an HTML parser optimized for screen-scraping.">
+<meta name="generator" content="Markov Approximation 1.4 (module: leonardr)">
+<meta name="author" content="Leonard Richardson">
+</head>
+<body>
+<a href="foo">foo</a>
+<a href="foo"><b>bar</b></a>
+</body>
+</html>"""
+        self.tree = self.soup(self.page)
+
+    def test_pickle_and_unpickle_identity(self):
+        # Pickling a tree, then unpickling it, yields a tree identical
+        # to the original.
+        dumped = pickle.dumps(self.tree, 2)
+        loaded = pickle.loads(dumped)
+        assert loaded.__class__ == BeautifulSoup
+        assert loaded.decode() == self.tree.decode()
+
+    def test_deepcopy_identity(self):
+        # Making a deepcopy of a tree yields an identical tree.
+        copied = copy.deepcopy(self.tree)
+        assert copied.decode() == self.tree.decode()
+
+    def test_copy_preserves_encoding(self):
+        soup = BeautifulSoup(b'<p>&nbsp;</p>', 'html.parser')
+        encoding = soup.original_encoding
+        copy = soup.__copy__()
+        assert "<p> </p>" == str(copy)
+        assert encoding == copy.original_encoding
+
+    def test_copy_preserves_builder_information(self):
+
+        tag = self.soup('<p></p>').p
+
+        # Simulate a tag obtained from a source file.
+        tag.sourceline = 10
+        tag.sourcepos = 33
+        
+        copied = tag.__copy__()
+
+        # The TreeBuilder object is no longer availble, but information
+        # obtained from it gets copied over to the new Tag object.
+        assert tag.sourceline == copied.sourceline
+        assert tag.sourcepos == copied.sourcepos
+        assert tag.can_be_empty_element == copied.can_be_empty_element
+        assert tag.cdata_list_attributes == copied.cdata_list_attributes
+        assert tag.preserve_whitespace_tags == copied.preserve_whitespace_tags
+        
+    def test_unicode_pickle(self):
+        # A tree containing Unicode characters can be pickled.
+        html = "<b>\N{SNOWMAN}</b>"
+        soup = self.soup(html)
+        dumped = pickle.dumps(soup, pickle.HIGHEST_PROTOCOL)
+        loaded = pickle.loads(dumped)
+        assert loaded.decode() == soup.decode()
+
+    def test_copy_navigablestring_is_not_attached_to_tree(self):
+        html = "<b>Foo<a></a></b><b>Bar</b>"
+        soup = self.soup(html)
+        s1 = soup.find(string="Foo")
+        s2 = copy.copy(s1)
+        assert s1 == s2
+        assert None == s2.parent
+        assert None == s2.next_element
+        assert None != s1.next_sibling
+        assert None == s2.next_sibling
+        assert None == s2.previous_element
+
+    def test_copy_navigablestring_subclass_has_same_type(self):
+        html = "<b><!--Foo--></b>"
+        soup = self.soup(html)
+        s1 = soup.string
+        s2 = copy.copy(s1)
+        assert s1 == s2
+        assert isinstance(s2, Comment)
+
+    def test_copy_entire_soup(self):
+        html = "<div><b>Foo<a></a></b><b>Bar</b></div>end"
+        soup = self.soup(html)
+        soup_copy = copy.copy(soup)
+        assert soup == soup_copy
+
+    def test_copy_tag_copies_contents(self):
+        html = "<div><b>Foo<a></a></b><b>Bar</b></div>end"
+        soup = self.soup(html)
+        div = soup.div
+        div_copy = copy.copy(div)
+
+        # The two tags look the same, and evaluate to equal.
+        assert str(div) == str(div_copy)
+        assert div == div_copy
+
+        # But they're not the same object.
+        assert div is not div_copy
+
+        # And they don't have the same relation to the parse tree. The
+        # copy is not associated with a parse tree at all.
+        assert None == div_copy.parent
+        assert None == div_copy.previous_element
+        assert None == div_copy.find(string='Bar').next_element
+        assert None != div.find(string='Bar').next_element
+
diff --git a/lib/bs4/tests/test_soup.py b/lib/bs4/tests/test_soup.py
new file mode 100644
index 00000000..445f74da
--- /dev/null
+++ b/lib/bs4/tests/test_soup.py
@@ -0,0 +1,462 @@
+# -*- coding: utf-8 -*-
+"""Tests of Beautiful Soup as a whole."""
+
+from pdb import set_trace
+import logging
+import os
+import pickle
+import pytest
+import sys
+import tempfile
+
+from bs4 import (
+    BeautifulSoup,
+    BeautifulStoneSoup,
+    GuessedAtParserWarning,
+    MarkupResemblesLocatorWarning,
+    dammit,
+)
+from bs4.builder import (
+    builder_registry,
+    TreeBuilder,
+    ParserRejectedMarkup,
+)
+from bs4.element import (
+    Comment,
+    SoupStrainer,
+    Tag,
+    NavigableString,
+)
+
+from . import (
+    default_builder,
+    SoupTest,
+    skipIf,
+)
+import warnings
+
+try:
+    from bs4.builder import LXMLTreeBuilder, LXMLTreeBuilderForXML
+    LXML_PRESENT = True
+except ImportError as e:
+    LXML_PRESENT = False
+    
+PYTHON_3_PRE_3_2 = (sys.version_info[0] == 3 and sys.version_info < (3,2))
+
+class TestConstructor(SoupTest):
+
+    def test_short_unicode_input(self):
+        data = "<h1>éé</h1>"
+        soup = self.soup(data)
+        assert "éé" == soup.h1.string
+
+    def test_embedded_null(self):
+        data = "<h1>foo\0bar</h1>"
+        soup = self.soup(data)
+        assert "foo\0bar" == soup.h1.string
+
+    def test_exclude_encodings(self):
+        utf8_data = "Räksmörgås".encode("utf-8")
+        soup = self.soup(utf8_data, exclude_encodings=["utf-8"])
+        assert "windows-1252" == soup.original_encoding
+
+    def test_custom_builder_class(self):
+        # Verify that you can pass in a custom Builder class and
+        # it'll be instantiated with the appropriate keyword arguments.
+        class Mock(object):
+            def __init__(self, **kwargs):
+                self.called_with = kwargs
+                self.is_xml = True
+                self.store_line_numbers = False
+                self.cdata_list_attributes = []
+                self.preserve_whitespace_tags = []
+                self.string_containers = {}
+            def initialize_soup(self, soup):
+                pass
+            def feed(self, markup):
+                self.fed = markup
+            def reset(self):
+                pass
+            def ignore(self, ignore):
+                pass
+            set_up_substitutions = can_be_empty_element = ignore
+            def prepare_markup(self, *args, **kwargs):
+                yield "prepared markup", "original encoding", "declared encoding", "contains replacement characters"
+                
+        kwargs = dict(
+            var="value",
+            # This is a deprecated BS3-era keyword argument, which
+            # will be stripped out.
+            convertEntities=True,
+        )
+        with warnings.catch_warnings(record=True):
+            soup = BeautifulSoup('', builder=Mock, **kwargs)
+        assert isinstance(soup.builder, Mock)
+        assert dict(var="value") == soup.builder.called_with
+        assert "prepared markup" == soup.builder.fed
+        
+        # You can also instantiate the TreeBuilder yourself. In this
+        # case, that specific object is used and any keyword arguments
+        # to the BeautifulSoup constructor are ignored.
+        builder = Mock(**kwargs)
+        with warnings.catch_warnings(record=True) as w:
+            soup = BeautifulSoup(
+                '', builder=builder, ignored_value=True,
+            )
+        msg = str(w[0].message)
+        assert msg.startswith("Keyword arguments to the BeautifulSoup constructor will be ignored.")
+        assert builder == soup.builder
+        assert kwargs == builder.called_with
+
+    def test_parser_markup_rejection(self):
+        # If markup is completely rejected by the parser, an
+        # explanatory ParserRejectedMarkup exception is raised.
+        class Mock(TreeBuilder):
+            def feed(self, *args, **kwargs):
+                raise ParserRejectedMarkup("Nope.")
+
+        def prepare_markup(self, *args, **kwargs):
+            # We're going to try two different ways of preparing this markup,
+            # but feed() will reject both of them.
+            yield markup, None, None, False
+            yield markup, None, None, False
+            
+
+        import re
+        with pytest.raises(ParserRejectedMarkup) as exc_info:
+            BeautifulSoup('', builder=Mock)
+        assert "The markup you provided was rejected by the parser. Trying a different parser or a different encoding may help." in str(exc_info.value)
+        
+    def test_cdata_list_attributes(self):
+        # Most attribute values are represented as scalars, but the
+        # HTML standard says that some attributes, like 'class' have
+        # space-separated lists as values.
+        markup = '<a id=" an id " class=" a class "></a>'
+        soup = self.soup(markup)
+
+        # Note that the spaces are stripped for 'class' but not for 'id'.
+        a = soup.a
+        assert " an id " == a['id']
+        assert ["a", "class"] == a['class']
+
+        # TreeBuilder takes an argument called 'mutli_valued_attributes'  which lets
+        # you customize or disable this. As always, you can customize the TreeBuilder
+        # by passing in a keyword argument to the BeautifulSoup constructor.
+        soup = self.soup(markup, builder=default_builder, multi_valued_attributes=None)
+        assert " a class " == soup.a['class']
+
+        # Here are two ways of saying that `id` is a multi-valued
+        # attribute in this context, but 'class' is not.
+        for switcheroo in ({'*': 'id'}, {'a': 'id'}):
+            with warnings.catch_warnings(record=True) as w:
+                # This will create a warning about not explicitly
+                # specifying a parser, but we'll ignore it.
+                soup = self.soup(markup, builder=None, multi_valued_attributes=switcheroo)
+            a = soup.a
+            assert ["an", "id"] == a['id']
+            assert " a class " == a['class']
+
+    def test_replacement_classes(self):
+        # Test the ability to pass in replacements for element classes
+        # which will be used when building the tree.
+        class TagPlus(Tag):
+            pass
+
+        class StringPlus(NavigableString):
+            pass
+
+        class CommentPlus(Comment):
+            pass
+        
+        soup = self.soup(
+            "<a><b>foo</b>bar</a><!--whee-->",
+            element_classes = {
+                Tag: TagPlus,
+                NavigableString: StringPlus,
+                Comment: CommentPlus,
+            }
+        )
+
+        # The tree was built with TagPlus, StringPlus, and CommentPlus objects,
+        # rather than Tag, String, and Comment objects.
+        assert all(
+            isinstance(x, (TagPlus, StringPlus, CommentPlus))
+            for x in soup.recursiveChildGenerator()
+        )
+
+    def test_alternate_string_containers(self):
+        # Test the ability to customize the string containers for
+        # different types of tags.
+        class PString(NavigableString):
+            pass
+
+        class BString(NavigableString):
+            pass
+
+        soup = self.soup(
+            "<div>Hello.<p>Here is <b>some <i>bolded</i></b> text",
+            string_containers = {
+                'b': BString,
+                'p': PString,
+            }
+        )
+
+        # The string before the <p> tag is a regular NavigableString.
+        assert isinstance(soup.div.contents[0], NavigableString)
+        
+        # The string inside the <p> tag, but not inside the <i> tag,
+        # is a PString.
+        assert isinstance(soup.p.contents[0], PString)
+
+        # Every string inside the <b> tag is a BString, even the one that
+        # was also inside an <i> tag.
+        for s in soup.b.strings:
+            assert isinstance(s, BString)
+
+        # Now that parsing was complete, the string_container_stack
+        # (where this information was kept) has been cleared out.
+        assert [] == soup.string_container_stack
+
+
+class TestWarnings(SoupTest):
+
+    def _assert_warning(self, warnings, cls):
+        for w in warnings:
+            if isinstance(w.message, cls):
+                return w
+        raise Exception("%s warning not found in %r" % (cls, warnings))
+    
+    def _assert_no_parser_specified(self, w):
+        warning = self._assert_warning(w, GuessedAtParserWarning)
+        message = str(warning.message)
+        assert message.startswith(BeautifulSoup.NO_PARSER_SPECIFIED_WARNING[:60])
+
+    def test_warning_if_no_parser_specified(self):
+        with warnings.catch_warnings(record=True) as w:
+            soup = BeautifulSoup("<a><b></b></a>")
+        self._assert_no_parser_specified(w)
+
+    def test_warning_if_parser_specified_too_vague(self):
+        with warnings.catch_warnings(record=True) as w:
+            soup = BeautifulSoup("<a><b></b></a>", "html")
+        self._assert_no_parser_specified(w)
+
+    def test_no_warning_if_explicit_parser_specified(self):
+        with warnings.catch_warnings(record=True) as w:
+            soup = BeautifulSoup("<a><b></b></a>", "html.parser")
+        assert [] == w
+
+    def test_parseOnlyThese_renamed_to_parse_only(self):
+        with warnings.catch_warnings(record=True) as w:
+            soup = self.soup("<a><b></b></a>", parseOnlyThese=SoupStrainer("b"))
+        msg = str(w[0].message)
+        assert "parseOnlyThese" in msg
+        assert "parse_only" in msg
+        assert b"<b></b>" == soup.encode()
+
+    def test_fromEncoding_renamed_to_from_encoding(self):
+        with warnings.catch_warnings(record=True) as w:
+            utf8 = b"\xc3\xa9"
+            soup = self.soup(utf8, fromEncoding="utf8")
+        msg = str(w[0].message)
+        assert "fromEncoding" in msg
+        assert "from_encoding" in msg
+        assert "utf8" == soup.original_encoding
+
+    def test_unrecognized_keyword_argument(self):
+        with pytest.raises(TypeError):
+            self.soup("<a>", no_such_argument=True)
+
+    @pytest.mark.parametrize(
+        "extension",
+        ['markup.html', 'markup.htm', 'markup.HTML', 'markup.txt',
+         'markup.xhtml', 'markup.xml', "/home/user/file", "c:\\user\file"]
+    )
+    def test_resembles_filename_warning(self, extension):
+        # A warning is issued if the "markup" looks like the name of
+        # an HTML or text file, or a full path to a file on disk.
+        with warnings.catch_warnings(record=True) as w:
+            soup = self.soup("markup" + extension)
+            warning = self._assert_warning(w, MarkupResemblesLocatorWarning)
+            assert "looks more like a filename" in str(warning.message)
+
+    @pytest.mark.parametrize(
+        "extension",
+        ['markuphtml', 'markup.com', '', 'markup.js']
+    )
+    def test_resembles_filename_no_warning(self, extension):
+        # The 'looks more like a filename' warning is not issued if
+        # the markup looks like a bare string, a domain name, or a
+        # file that's not an HTML file.
+        with warnings.catch_warnings(record=True) as w:
+            soup = self.soup("markup" + extension)
+        assert [] == w
+        
+    def test_url_warning_with_bytes_url(self):
+        url = b"http://www.crummybytes.com/"
+        with warnings.catch_warnings(record=True) as warning_list:
+            soup = self.soup(url)
+        warning = self._assert_warning(
+            warning_list, MarkupResemblesLocatorWarning
+        )
+        assert "looks more like a URL" in str(warning.message)
+        assert url not in str(warning.message).encode("utf8")
+        
+    def test_url_warning_with_unicode_url(self):
+        url = "http://www.crummyunicode.com/"
+        with warnings.catch_warnings(record=True) as warning_list:
+            # note - this url must differ from the bytes one otherwise
+            # python's warnings system swallows the second warning
+            soup = self.soup(url)
+        warning = self._assert_warning(
+            warning_list, MarkupResemblesLocatorWarning
+        )
+        assert "looks more like a URL" in str(warning.message)
+        assert url not in str(warning.message)
+
+    def test_url_warning_with_bytes_and_space(self):
+        # Here the markup contains something besides a URL, so no warning
+        # is issued.
+        with warnings.catch_warnings(record=True) as warning_list:
+            soup = self.soup(b"http://www.crummybytes.com/ is great")
+        assert not any("looks more like a URL" in str(w.message) 
+                       for w in warning_list)
+
+    def test_url_warning_with_unicode_and_space(self):
+        with warnings.catch_warnings(record=True) as warning_list:
+            soup = self.soup("http://www.crummyunicode.com/ is great")
+        assert not any("looks more like a URL" in str(w.message) 
+                       for w in warning_list)
+
+
+class TestSelectiveParsing(SoupTest):
+
+    def test_parse_with_soupstrainer(self):
+        markup = "No<b>Yes</b><a>No<b>Yes <c>Yes</c></b>"
+        strainer = SoupStrainer("b")
+        soup = self.soup(markup, parse_only=strainer)
+        assert soup.encode() == b"<b>Yes</b><b>Yes <c>Yes</c></b>"
+
+        
+class TestNewTag(SoupTest):
+    """Test the BeautifulSoup.new_tag() method."""
+    def test_new_tag(self):
+        soup = self.soup("")
+        new_tag = soup.new_tag("foo", bar="baz", attrs={"name": "a name"})
+        assert isinstance(new_tag, Tag)
+        assert "foo" == new_tag.name
+        assert dict(bar="baz", name="a name") == new_tag.attrs
+        assert None == new_tag.parent
+        
+    def test_tag_inherits_self_closing_rules_from_builder(self):
+        if LXML_PRESENT:
+            xml_soup = BeautifulSoup("", "lxml-xml")
+            xml_br = xml_soup.new_tag("br")
+            xml_p = xml_soup.new_tag("p")
+
+            # Both the <br> and <p> tag are empty-element, just because
+            # they have no contents.
+            assert b"<br/>" == xml_br.encode()
+            assert b"<p/>" == xml_p.encode()
+
+        html_soup = BeautifulSoup("", "html.parser")
+        html_br = html_soup.new_tag("br")
+        html_p = html_soup.new_tag("p")
+
+        # The HTML builder users HTML's rules about which tags are
+        # empty-element tags, and the new tags reflect these rules.
+        assert b"<br/>" == html_br.encode()
+        assert b"<p></p>" == html_p.encode()
+
+class TestNewString(SoupTest):
+    """Test the BeautifulSoup.new_string() method."""
+    def test_new_string_creates_navigablestring(self):
+        soup = self.soup("")
+        s = soup.new_string("foo")
+        assert "foo" == s
+        assert isinstance(s, NavigableString)
+
+    def test_new_string_can_create_navigablestring_subclass(self):
+        soup = self.soup("")
+        s = soup.new_string("foo", Comment)
+        assert "foo" == s
+        assert isinstance(s, Comment)
+
+
+class TestPickle(SoupTest):
+   # Test our ability to pickle the BeautifulSoup object itself.
+
+    def test_normal_pickle(self):
+        soup = self.soup("<a>some markup</a>")
+        pickled = pickle.dumps(soup)
+        unpickled = pickle.loads(pickled)
+        assert "some markup" == unpickled.a.string
+        
+    def test_pickle_with_no_builder(self):
+        # We had a bug that prevented pickling from working if
+        # the builder wasn't set.
+        soup = self.soup("some markup")
+        soup.builder = None
+        pickled = pickle.dumps(soup)
+        unpickled = pickle.loads(pickled)
+        assert "some markup" == unpickled.string
+
+class TestEncodingConversion(SoupTest):
+    # Test Beautiful Soup's ability to decode and encode from various
+    # encodings.
+
+    def setup_method(self):
+        self.unicode_data = '<html><head><meta charset="utf-8"/></head><body><foo>Sacr\N{LATIN SMALL LETTER E WITH ACUTE} bleu!</foo></body></html>'
+        self.utf8_data = self.unicode_data.encode("utf-8")
+        # Just so you know what it looks like.
+        assert self.utf8_data == b'<html><head><meta charset="utf-8"/></head><body><foo>Sacr\xc3\xa9 bleu!</foo></body></html>'
+
+    def test_ascii_in_unicode_out(self):
+        # ASCII input is converted to Unicode. The original_encoding
+        # attribute is set to 'utf-8', a superset of ASCII.
+        chardet = dammit.chardet_dammit
+        logging.disable(logging.WARNING)
+        try:
+            def noop(str):
+                return None
+            # Disable chardet, which will realize that the ASCII is ASCII.
+            dammit.chardet_dammit = noop
+            ascii = b"<foo>a</foo>"
+            soup_from_ascii = self.soup(ascii)
+            unicode_output = soup_from_ascii.decode()
+            assert isinstance(unicode_output, str)
+            assert unicode_output == self.document_for(ascii.decode())
+            assert soup_from_ascii.original_encoding.lower() == "utf-8"
+        finally:
+            logging.disable(logging.NOTSET)
+            dammit.chardet_dammit = chardet
+
+    def test_unicode_in_unicode_out(self):
+        # Unicode input is left alone. The original_encoding attribute
+        # is not set.
+        soup_from_unicode = self.soup(self.unicode_data)
+        assert soup_from_unicode.decode() == self.unicode_data
+        assert soup_from_unicode.foo.string == 'Sacr\xe9 bleu!'
+        assert soup_from_unicode.original_encoding == None
+
+    def test_utf8_in_unicode_out(self):
+        # UTF-8 input is converted to Unicode. The original_encoding
+        # attribute is set.
+        soup_from_utf8 = self.soup(self.utf8_data)
+        assert soup_from_utf8.decode() == self.unicode_data
+        assert soup_from_utf8.foo.string == 'Sacr\xe9 bleu!'
+
+    def test_utf8_out(self):
+        # The internal data structures can be encoded as UTF-8.
+        soup_from_unicode = self.soup(self.unicode_data)
+        assert soup_from_unicode.encode('utf-8') == self.utf8_data
+
+    @skipIf(
+        PYTHON_3_PRE_3_2,
+        "Bad HTMLParser detected; skipping test of non-ASCII characters in attribute name.")
+    def test_attribute_name_containing_unicode_characters(self):
+        markup = '<div><a \N{SNOWMAN}="snowman"></a></div>'
+        assert self.soup(markup).div.encode("utf8") == markup.encode("utf8")
+
+
+
diff --git a/lib/bs4/tests/test_tag.py b/lib/bs4/tests/test_tag.py
new file mode 100644
index 00000000..88cc202d
--- /dev/null
+++ b/lib/bs4/tests/test_tag.py
@@ -0,0 +1,221 @@
+import warnings
+from bs4.element import (
+    Comment,
+    NavigableString,
+)
+from . import SoupTest
+
+class TestTag(SoupTest):
+    """Test various methods of Tag which aren't so complicated they
+    need their own classes.
+    """
+
+    def test__should_pretty_print(self):
+        # Test the rules about when a tag should be pretty-printed.
+        tag = self.soup("").new_tag("a_tag")
+
+        # No list of whitespace-preserving tags -> pretty-print
+        tag._preserve_whitespace_tags = None
+        assert True == tag._should_pretty_print(0)
+
+        # List exists but tag is not on the list -> pretty-print
+        tag.preserve_whitespace_tags = ["some_other_tag"]
+        assert True == tag._should_pretty_print(1)
+
+        # Indent level is None -> don't pretty-print
+        assert False == tag._should_pretty_print(None)
+        
+        # Tag is on the whitespace-preserving list -> don't pretty-print
+        tag.preserve_whitespace_tags = ["some_other_tag", "a_tag"]
+        assert False == tag._should_pretty_print(1)
+    
+    def test_len(self):
+        """The length of a Tag is its number of children."""
+        soup = self.soup("<top>1<b>2</b>3</top>")
+
+        # The BeautifulSoup object itself contains one element: the
+        # <top> tag.
+        assert len(soup.contents) == 1
+        assert len(soup) == 1
+
+        # The <top> tag contains three elements: the text node "1", the
+        # <b> tag, and the text node "3".
+        assert len(soup.top) == 3
+        assert len(soup.top.contents) == 3
+
+    def test_member_access_invokes_find(self):
+        """Accessing a Python member .foo invokes find('foo')"""
+        soup = self.soup('<b><i></i></b>')
+        assert soup.b == soup.find('b')
+        assert soup.b.i == soup.find('b').find('i')
+        assert soup.a == None
+
+    def test_deprecated_member_access(self):
+        soup = self.soup('<b><i></i></b>')
+        with warnings.catch_warnings(record=True) as w:
+            tag = soup.bTag
+        assert soup.b == tag
+        assert '.bTag is deprecated, use .find("b") instead. If you really were looking for a tag called bTag, use .find("bTag")' == str(w[0].message)
+
+    def test_has_attr(self):
+        """has_attr() checks for the presence of an attribute.
+
+        Please note note: has_attr() is different from
+        __in__. has_attr() checks the tag's attributes and __in__
+        checks the tag's chidlren.
+        """
+        soup = self.soup("<foo attr='bar'>")
+        assert soup.foo.has_attr('attr')
+        assert not soup.foo.has_attr('attr2')
+
+    def test_attributes_come_out_in_alphabetical_order(self):
+        markup = '<b a="1" z="5" m="3" f="2" y="4"></b>'
+        self.assertSoupEquals(markup, '<b a="1" f="2" m="3" y="4" z="5"></b>')
+
+    def test_string(self):
+        # A Tag that contains only a text node makes that node
+        # available as .string.
+        soup = self.soup("<b>foo</b>")
+        assert soup.b.string == 'foo'
+
+    def test_empty_tag_has_no_string(self):
+        # A Tag with no children has no .stirng.
+        soup = self.soup("<b></b>")
+        assert soup.b.string == None
+
+    def test_tag_with_multiple_children_has_no_string(self):
+        # A Tag with no children has no .string.
+        soup = self.soup("<a>foo<b></b><b></b></b>")
+        assert soup.b.string == None
+
+        soup = self.soup("<a>foo<b></b>bar</b>")
+        assert soup.b.string == None
+
+        # Even if all the children are strings, due to trickery,
+        # it won't work--but this would be a good optimization.
+        soup = self.soup("<a>foo</b>")
+        soup.a.insert(1, "bar")
+        assert soup.a.string == None
+
+    def test_tag_with_recursive_string_has_string(self):
+        # A Tag with a single child which has a .string inherits that
+        # .string.
+        soup = self.soup("<a><b>foo</b></a>")
+        assert soup.a.string == "foo"
+        assert soup.string == "foo"
+
+    def test_lack_of_string(self):
+        """Only a Tag containing a single text node has a .string."""
+        soup = self.soup("<b>f<i>e</i>o</b>")
+        assert soup.b.string is None
+
+        soup = self.soup("<b></b>")
+        assert soup.b.string is None
+
+    def test_all_text(self):
+        """Tag.text and Tag.get_text(sep=u"") -> all child text, concatenated"""
+        soup = self.soup("<a>a<b>r</b>   <r> t </r></a>")
+        assert soup.a.text == "ar  t "
+        assert soup.a.get_text(strip=True) == "art"
+        assert soup.a.get_text(",") == "a,r, , t "
+        assert soup.a.get_text(",", strip=True) == "a,r,t"
+
+    def test_get_text_ignores_special_string_containers(self):
+        soup = self.soup("foo<!--IGNORE-->bar")
+        assert soup.get_text() == "foobar"
+
+        assert soup.get_text(types=(NavigableString, Comment)) == "fooIGNOREbar"
+        assert soup.get_text(types=None) == "fooIGNOREbar"
+
+        soup = self.soup("foo<style>CSS</style><script>Javascript</script>bar")
+        assert soup.get_text() == "foobar"
+        
+    def test_all_strings_ignores_special_string_containers(self):
+        soup = self.soup("foo<!--IGNORE-->bar")
+        assert ['foo', 'bar'] == list(soup.strings)
+
+        soup = self.soup("foo<style>CSS</style><script>Javascript</script>bar")
+        assert ['foo', 'bar'] == list(soup.strings)
+
+    def test_string_methods_inside_special_string_container_tags(self):
+        # Strings inside tags like <script> are generally ignored by
+        # methods like get_text, because they're not what humans
+        # consider 'text'. But if you call get_text on the <script>
+        # tag itself, those strings _are_ considered to be 'text',
+        # because there's nothing else you might be looking for.
+        
+        style = self.soup("<div>a<style>Some CSS</style></div>")
+        template = self.soup("<div>a<template><p>Templated <b>text</b>.</p><!--With a comment.--></template></div>")
+        script = self.soup("<div>a<script><!--a comment-->Some text</script></div>")
+        
+        assert style.div.get_text() == "a"
+        assert list(style.div.strings) == ["a"]
+        assert style.div.style.get_text() == "Some CSS"
+        assert list(style.div.style.strings) == ['Some CSS']
+        
+        # The comment is not picked up here. That's because it was
+        # parsed into a Comment object, which is not considered
+        # interesting by template.strings.
+        assert template.div.get_text() == "a"
+        assert list(template.div.strings) == ["a"]
+        assert template.div.template.get_text() == "Templated text."
+        assert list(template.div.template.strings) == ["Templated ", "text", "."]
+
+        # The comment is included here, because it didn't get parsed
+        # into a Comment object--it's part of the Script string.
+        assert script.div.get_text() == "a"
+        assert list(script.div.strings) == ["a"]
+        assert script.div.script.get_text() == "<!--a comment-->Some text"
+        assert list(script.div.script.strings) == ['<!--a comment-->Some text']
+
+
+class TestMultiValuedAttributes(SoupTest):
+    """Test the behavior of multi-valued attributes like 'class'.
+
+    The values of such attributes are always presented as lists.
+    """
+
+    def test_single_value_becomes_list(self):
+        soup = self.soup("<a class='foo'>")
+        assert ["foo"] ==soup.a['class']
+
+    def test_multiple_values_becomes_list(self):
+        soup = self.soup("<a class='foo bar'>")
+        assert ["foo", "bar"] == soup.a['class']
+
+    def test_multiple_values_separated_by_weird_whitespace(self):
+        soup = self.soup("<a class='foo\tbar\nbaz'>")
+        assert ["foo", "bar", "baz"] ==soup.a['class']
+
+    def test_attributes_joined_into_string_on_output(self):
+        soup = self.soup("<a class='foo\tbar'>")
+        assert b'<a class="foo bar"></a>' == soup.a.encode()
+
+    def test_get_attribute_list(self):
+        soup = self.soup("<a id='abc def'>")
+        assert ['abc def'] == soup.a.get_attribute_list('id')
+        
+    def test_accept_charset(self):
+        soup = self.soup('<form accept-charset="ISO-8859-1 UTF-8">')
+        assert ['ISO-8859-1', 'UTF-8'] == soup.form['accept-charset']
+
+    def test_cdata_attribute_applying_only_to_one_tag(self):
+        data = '<a accept-charset="ISO-8859-1 UTF-8"></a>'
+        soup = self.soup(data)
+        # We saw in another test that accept-charset is a cdata-list
+        # attribute for the <form> tag. But it's not a cdata-list
+        # attribute for any other tag.
+        assert 'ISO-8859-1 UTF-8' == soup.a['accept-charset']
+
+    def test_customization(self):
+        # It's possible to change which attributes of which tags
+        # are treated as multi-valued attributes.
+        #
+        # Here, 'id' is a multi-valued attribute and 'class' is not.
+        #
+        # TODO: This code is in the builder and should be tested there.
+        soup = self.soup(
+            '<a class="foo" id="bar">', multi_valued_attributes={ '*' : 'id' }
+        )
+        assert soup.a['class'] == 'foo'
+        assert soup.a['id'] == ['bar']
diff --git a/lib/bs4/tests/test_tree.py b/lib/bs4/tests/test_tree.py
new file mode 100644
index 00000000..bfd6826e
--- /dev/null
+++ b/lib/bs4/tests/test_tree.py
@@ -0,0 +1,1290 @@
+# -*- coding: utf-8 -*-
+"""Tests for Beautiful Soup's tree traversal methods.
+
+The tree traversal methods are the main advantage of using Beautiful
+Soup over just using a parser.
+
+Different parsers will build different Beautiful Soup trees given the
+same markup, but all Beautiful Soup trees can be traversed with the
+methods tested here.
+"""
+
+from pdb import set_trace
+import pytest
+import re
+import warnings
+from bs4 import BeautifulSoup
+from bs4.builder import (
+    builder_registry,
+    HTMLParserTreeBuilder,
+)
+from bs4.element import (
+    CData,
+    Comment,
+    Declaration,
+    Doctype,
+    Formatter,
+    NavigableString,
+    Script,
+    SoupStrainer,
+    Stylesheet,
+    Tag,
+    TemplateString,
+)
+from . import (
+    SoupTest,
+    skipIf,
+)
+
+class TestFind(SoupTest):
+    """Basic tests of the find() method.
+
+    find() just calls find_all() with limit=1, so it's not tested all
+    that thouroughly here.
+    """
+
+    def test_find_tag(self):
+        soup = self.soup("<a>1</a><b>2</b><a>3</a><b>4</b>")
+        assert soup.find("b").string == "2"
+
+    def test_unicode_text_find(self):
+        soup = self.soup('<h1>Räksmörgås</h1>')
+        assert soup.find(string='Räksmörgås') == 'Räksmörgås'
+
+    def test_unicode_attribute_find(self):
+        soup = self.soup('<h1 id="Räksmörgås">here it is</h1>')
+        str(soup)
+        assert "here it is" == soup.find(id='Räksmörgås').text
+
+
+    def test_find_everything(self):
+        """Test an optimization that finds all tags."""
+        soup = self.soup("<a>foo</a><b>bar</b>")
+        assert 2 == len(soup.find_all())
+
+    def test_find_everything_with_name(self):
+        """Test an optimization that finds all tags with a given name."""
+        soup = self.soup("<a>foo</a><b>bar</b><a>baz</a>")
+        assert 2 == len(soup.find_all('a'))
+
+class TestFindAll(SoupTest):
+    """Basic tests of the find_all() method."""
+
+    def test_find_all_text_nodes(self):
+        """You can search the tree for text nodes."""
+        soup = self.soup("<html>Foo<b>bar</b>\xbb</html>")
+        # Exact match.
+        assert soup.find_all(string="bar") == ["bar"]
+
+       
+        # Match any of a number of strings.
+        assert soup.find_all(string=["Foo", "bar"]) == ["Foo", "bar"]
+        # Match a regular expression.
+        assert soup.find_all(string=re.compile('.*')) == ["Foo", "bar", '\xbb']
+        # Match anything.
+        assert soup.find_all(string=True) == ["Foo", "bar", '\xbb']
+
+    def test_find_all_limit(self):
+        """You can limit the number of items returned by find_all."""
+        soup = self.soup("<a>1</a><a>2</a><a>3</a><a>4</a><a>5</a>")
+        self.assert_selects(soup.find_all('a', limit=3), ["1", "2", "3"])
+        self.assert_selects(soup.find_all('a', limit=1), ["1"])
+        self.assert_selects(
+            soup.find_all('a', limit=10), ["1", "2", "3", "4", "5"])
+
+        # A limit of 0 means no limit.
+        self.assert_selects(
+            soup.find_all('a', limit=0), ["1", "2", "3", "4", "5"])
+
+    def test_calling_a_tag_is_calling_findall(self):
+        soup = self.soup("<a>1</a><b>2<a id='foo'>3</a></b>")
+        self.assert_selects(soup('a', limit=1), ["1"])
+        self.assert_selects(soup.b(id="foo"), ["3"])
+
+    def test_find_all_with_self_referential_data_structure_does_not_cause_infinite_recursion(self):
+        soup = self.soup("<a></a>")
+        # Create a self-referential list.
+        l = []
+        l.append(l)
+
+        # Without special code in _normalize_search_value, this would cause infinite
+        # recursion.
+        assert [] == soup.find_all(l)
+
+    def test_find_all_resultset(self):
+        """All find_all calls return a ResultSet"""
+        soup = self.soup("<a></a>")
+        result = soup.find_all("a")
+        assert hasattr(result, "source")
+
+        result = soup.find_all(True)
+        assert hasattr(result, "source")
+
+        result = soup.find_all(string="foo")
+        assert hasattr(result, "source")
+
+
+class TestFindAllBasicNamespaces(SoupTest):
+
+    def test_find_by_namespaced_name(self):
+        soup = self.soup('<mathml:msqrt>4</mathml:msqrt><a svg:fill="red">')
+        assert "4" == soup.find("mathml:msqrt").string
+        assert "a" == soup.find(attrs= { "svg:fill" : "red" }).name
+
+
+class TestFindAllByName(SoupTest):
+    """Test ways of finding tags by tag name."""
+
+    def setup_method(self):
+        self.tree =  self.soup("""<a>First tag.</a>
+                                  <b>Second tag.</b>
+                                  <c>Third <a>Nested tag.</a> tag.</c>""")
+
+    def test_find_all_by_tag_name(self):
+        # Find all the <a> tags.
+        self.assert_selects(
+            self.tree.find_all('a'), ['First tag.', 'Nested tag.'])
+
+    def test_find_all_by_name_and_text(self):
+        self.assert_selects(
+            self.tree.find_all('a', string='First tag.'), ['First tag.'])
+
+        self.assert_selects(
+            self.tree.find_all('a', string=True), ['First tag.', 'Nested tag.'])
+
+        self.assert_selects(
+            self.tree.find_all('a', string=re.compile("tag")),
+            ['First tag.', 'Nested tag.'])
+
+
+    def test_find_all_on_non_root_element(self):
+        # You can call find_all on any node, not just the root.
+        self.assert_selects(self.tree.c.find_all('a'), ['Nested tag.'])
+
+    def test_calling_element_invokes_find_all(self):
+        self.assert_selects(self.tree('a'), ['First tag.', 'Nested tag.'])
+
+    def test_find_all_by_tag_strainer(self):
+        self.assert_selects(
+            self.tree.find_all(SoupStrainer('a')),
+            ['First tag.', 'Nested tag.'])
+
+    def test_find_all_by_tag_names(self):
+        self.assert_selects(
+            self.tree.find_all(['a', 'b']),
+            ['First tag.', 'Second tag.', 'Nested tag.'])
+
+    def test_find_all_by_tag_dict(self):
+        self.assert_selects(
+            self.tree.find_all({'a' : True, 'b' : True}),
+            ['First tag.', 'Second tag.', 'Nested tag.'])
+
+    def test_find_all_by_tag_re(self):
+        self.assert_selects(
+            self.tree.find_all(re.compile('^[ab]$')),
+            ['First tag.', 'Second tag.', 'Nested tag.'])
+
+    def test_find_all_with_tags_matching_method(self):
+        # You can define an oracle method that determines whether
+        # a tag matches the search.
+        def id_matches_name(tag):
+            return tag.name == tag.get('id')
+
+        tree = self.soup("""<a id="a">Match 1.</a>
+                            <a id="1">Does not match.</a>
+                            <b id="b">Match 2.</a>""")
+
+        self.assert_selects(
+            tree.find_all(id_matches_name), ["Match 1.", "Match 2."])
+
+    def test_find_with_multi_valued_attribute(self):
+        soup = self.soup(
+            "<div class='a b'>1</div><div class='a c'>2</div><div class='a d'>3</div>"
+        )
+        r1 = soup.find('div', 'a d');
+        r2 = soup.find('div', re.compile(r'a d'));
+        r3, r4 = soup.find_all('div', ['a b', 'a d']);
+        assert '3' == r1.string
+        assert '3' == r2.string
+        assert '1' == r3.string
+        assert '3' == r4.string
+
+        
+class TestFindAllByAttribute(SoupTest):
+
+    def test_find_all_by_attribute_name(self):
+        # You can pass in keyword arguments to find_all to search by
+        # attribute.
+        tree = self.soup("""
+                         <a id="first">Matching a.</a>
+                         <a id="second">
+                          Non-matching <b id="first">Matching b.</b>a.
+                         </a>""")
+        self.assert_selects(tree.find_all(id='first'),
+                           ["Matching a.", "Matching b."])
+
+    def test_find_all_by_utf8_attribute_value(self):
+        peace = "םולש".encode("utf8")
+        data = '<a title="םולש"></a>'.encode("utf8")
+        soup = self.soup(data)
+        assert [soup.a] == soup.find_all(title=peace)
+        assert [soup.a] == soup.find_all(title=peace.decode("utf8"))
+        assert [soup.a], soup.find_all(title=[peace, "something else"])
+
+    def test_find_all_by_attribute_dict(self):
+        # You can pass in a dictionary as the argument 'attrs'. This
+        # lets you search for attributes like 'name' (a fixed argument
+        # to find_all) and 'class' (a reserved word in Python.)
+        tree = self.soup("""
+                         <a name="name1" class="class1">Name match.</a>
+                         <a name="name2" class="class2">Class match.</a>
+                         <a name="name3" class="class3">Non-match.</a>
+                         <name1>A tag called 'name1'.</name1>
+                         """)
+
+        # This doesn't do what you want.
+        self.assert_selects(tree.find_all(name='name1'),
+                           ["A tag called 'name1'."])
+        # This does what you want.
+        self.assert_selects(tree.find_all(attrs={'name' : 'name1'}),
+                           ["Name match."])
+
+        self.assert_selects(tree.find_all(attrs={'class' : 'class2'}),
+                           ["Class match."])
+
+    def test_find_all_by_class(self):
+        tree = self.soup("""
+                         <a class="1">Class 1.</a>
+                         <a class="2">Class 2.</a>
+                         <b class="1">Class 1.</b>
+                         <c class="3 4">Class 3 and 4.</c>
+                         """)
+
+        # Passing in the class_ keyword argument will search against
+        # the 'class' attribute.
+        self.assert_selects(tree.find_all('a', class_='1'), ['Class 1.'])
+        self.assert_selects(tree.find_all('c', class_='3'), ['Class 3 and 4.'])
+        self.assert_selects(tree.find_all('c', class_='4'), ['Class 3 and 4.'])
+
+        # Passing in a string to 'attrs' will also search the CSS class.
+        self.assert_selects(tree.find_all('a', '1'), ['Class 1.'])
+        self.assert_selects(tree.find_all(attrs='1'), ['Class 1.', 'Class 1.'])
+        self.assert_selects(tree.find_all('c', '3'), ['Class 3 and 4.'])
+        self.assert_selects(tree.find_all('c', '4'), ['Class 3 and 4.'])
+
+    def test_find_by_class_when_multiple_classes_present(self):
+        tree = self.soup("<gar class='foo bar'>Found it</gar>")
+
+        f = tree.find_all("gar", class_=re.compile("o"))
+        self.assert_selects(f, ["Found it"])
+
+        f = tree.find_all("gar", class_=re.compile("a"))
+        self.assert_selects(f, ["Found it"])
+
+        # If the search fails to match the individual strings "foo" and "bar",
+        # it will be tried against the combined string "foo bar".
+        f = tree.find_all("gar", class_=re.compile("o b"))
+        self.assert_selects(f, ["Found it"])
+
+    def test_find_all_with_non_dictionary_for_attrs_finds_by_class(self):
+        soup = self.soup("<a class='bar'>Found it</a>")
+
+        self.assert_selects(soup.find_all("a", re.compile("ba")), ["Found it"])
+
+        def big_attribute_value(value):
+            return len(value) > 3
+
+        self.assert_selects(soup.find_all("a", big_attribute_value), [])
+
+        def small_attribute_value(value):
+            return len(value) <= 3
+
+        self.assert_selects(
+            soup.find_all("a", small_attribute_value), ["Found it"])
+
+    def test_find_all_with_string_for_attrs_finds_multiple_classes(self):
+        soup = self.soup('<a class="foo bar"></a><a class="foo"></a>')
+        a, a2 = soup.find_all("a")
+        assert [a, a2], soup.find_all("a", "foo")
+        assert [a], soup.find_all("a", "bar")
+
+        # If you specify the class as a string that contains a
+        # space, only that specific value will be found.
+        assert [a] == soup.find_all("a", class_="foo bar")
+        assert [a] == soup.find_all("a", "foo bar")
+        assert [] == soup.find_all("a", "bar foo")
+
+    def test_find_all_by_attribute_soupstrainer(self):
+        tree = self.soup("""
+                         <a id="first">Match.</a>
+                         <a id="second">Non-match.</a>""")
+
+        strainer = SoupStrainer(attrs={'id' : 'first'})
+        self.assert_selects(tree.find_all(strainer), ['Match.'])
+
+    def test_find_all_with_missing_attribute(self):
+        # You can pass in None as the value of an attribute to find_all.
+        # This will match tags that do not have that attribute set.
+        tree = self.soup("""<a id="1">ID present.</a>
+                            <a>No ID present.</a>
+                            <a id="">ID is empty.</a>""")
+        self.assert_selects(tree.find_all('a', id=None), ["No ID present."])
+
+    def test_find_all_with_defined_attribute(self):
+        # You can pass in None as the value of an attribute to find_all.
+        # This will match tags that have that attribute set to any value.
+        tree = self.soup("""<a id="1">ID present.</a>
+                            <a>No ID present.</a>
+                            <a id="">ID is empty.</a>""")
+        self.assert_selects(
+            tree.find_all(id=True), ["ID present.", "ID is empty."])
+
+    def test_find_all_with_numeric_attribute(self):
+        # If you search for a number, it's treated as a string.
+        tree = self.soup("""<a id=1>Unquoted attribute.</a>
+                            <a id="1">Quoted attribute.</a>""")
+
+        expected = ["Unquoted attribute.", "Quoted attribute."]
+        self.assert_selects(tree.find_all(id=1), expected)
+        self.assert_selects(tree.find_all(id="1"), expected)
+
+    def test_find_all_with_list_attribute_values(self):
+        # You can pass a list of attribute values instead of just one,
+        # and you'll get tags that match any of the values.
+        tree = self.soup("""<a id="1">1</a>
+                            <a id="2">2</a>
+                            <a id="3">3</a>
+                            <a>No ID.</a>""")
+        self.assert_selects(tree.find_all(id=["1", "3", "4"]),
+                           ["1", "3"])
+
+    def test_find_all_with_regular_expression_attribute_value(self):
+        # You can pass a regular expression as an attribute value, and
+        # you'll get tags whose values for that attribute match the
+        # regular expression.
+        tree = self.soup("""<a id="a">One a.</a>
+                            <a id="aa">Two as.</a>
+                            <a id="ab">Mixed as and bs.</a>
+                            <a id="b">One b.</a>
+                            <a>No ID.</a>""")
+
+        self.assert_selects(tree.find_all(id=re.compile("^a+$")),
+                           ["One a.", "Two as."])
+
+    def test_find_by_name_and_containing_string(self):
+        soup = self.soup("<b>foo</b><b>bar</b><a>foo</a>")
+        a = soup.a
+
+        assert [a] == soup.find_all("a", string="foo")
+        assert [] == soup.find_all("a", string="bar")
+
+    def test_find_by_name_and_containing_string_when_string_is_buried(self):
+        soup = self.soup("<a>foo</a><a><b><c>foo</c></b></a>")
+        assert soup.find_all("a") == soup.find_all("a", string="foo")
+
+    def test_find_by_attribute_and_containing_string(self):
+        soup = self.soup('<b id="1">foo</b><a id="2">foo</a>')
+        a = soup.a
+
+        assert [a] == soup.find_all(id=2, string="foo")
+        assert [] == soup.find_all(id=1, string="bar")
+
+
+class TestSmooth(SoupTest):
+    """Test Tag.smooth."""
+
+    def test_smooth(self):
+        soup = self.soup("<div>a</div>")
+        div = soup.div
+        div.append("b")
+        div.append("c")
+        div.append(Comment("Comment 1"))
+        div.append(Comment("Comment 2"))
+        div.append("d")
+        builder = self.default_builder()
+        span = Tag(soup, builder, 'span')
+        span.append('1')
+        span.append('2')
+        div.append(span)
+
+        # At this point the tree has a bunch of adjacent
+        # NavigableStrings. This is normal, but it has no meaning in
+        # terms of HTML, so we may want to smooth things out for
+        # output.
+
+        # Since the <span> tag has two children, its .string is None.
+        assert None == div.span.string
+
+        assert 7 == len(div.contents)
+        div.smooth()
+        assert 5 == len(div.contents)
+
+        # The three strings at the beginning of div.contents have been
+        # merged into on string.
+        #
+        assert 'abc' == div.contents[0]
+
+        # The call is recursive -- the <span> tag was also smoothed.
+        assert '12' == div.span.string
+
+        # The two comments have _not_ been merged, even though
+        # comments are strings. Merging comments would change the
+        # meaning of the HTML.
+        assert 'Comment 1' == div.contents[1]
+        assert 'Comment 2' == div.contents[2]
+
+
+class TestIndex(SoupTest):
+    """Test Tag.index"""
+    def test_index(self):
+        tree = self.soup("""<div>
+                            <a>Identical</a>
+                            <b>Not identical</b>
+                            <a>Identical</a>
+
+                            <c><d>Identical with child</d></c>
+                            <b>Also not identical</b>
+                            <c><d>Identical with child</d></c>
+                            </div>""")
+        div = tree.div
+        for i, element in enumerate(div.contents):
+            assert i == div.index(element)
+        with pytest.raises(ValueError):
+            tree.index(1)
+
+
+class TestParentOperations(SoupTest):
+    """Test navigation and searching through an element's parents."""
+
+    def setup_method(self):
+        self.tree = self.soup('''<ul id="empty"></ul>
+                                 <ul id="top">
+                                  <ul id="middle">
+                                   <ul id="bottom">
+                                    <b>Start here</b>
+                                   </ul>
+                                  </ul>''')
+        self.start = self.tree.b
+
+
+    def test_parent(self):
+        assert self.start.parent['id'] == 'bottom'
+        assert self.start.parent.parent['id'] == 'middle'
+        assert self.start.parent.parent.parent['id'] == 'top'
+
+    def test_parent_of_top_tag_is_soup_object(self):
+        top_tag = self.tree.contents[0]
+        assert top_tag.parent == self.tree
+
+    def test_soup_object_has_no_parent(self):
+        assert None == self.tree.parent
+
+    def test_find_parents(self):
+        self.assert_selects_ids(
+            self.start.find_parents('ul'), ['bottom', 'middle', 'top'])
+        self.assert_selects_ids(
+            self.start.find_parents('ul', id="middle"), ['middle'])
+
+    def test_find_parent(self):
+        assert self.start.find_parent('ul')['id'] == 'bottom'
+        assert self.start.find_parent('ul', id='top')['id'] == 'top'
+
+    def test_parent_of_text_element(self):
+        text = self.tree.find(string="Start here")
+        assert text.parent.name == 'b'
+
+    def test_text_element_find_parent(self):
+        text = self.tree.find(string="Start here")
+        assert text.find_parent('ul')['id'] == 'bottom'
+
+    def test_parent_generator(self):
+        parents = [parent['id'] for parent in self.start.parents
+                   if parent is not None and 'id' in parent.attrs]
+        assert parents, ['bottom', 'middle' == 'top']
+
+
+class ProximityTest(SoupTest):
+
+    def setup_method(self):
+        self.tree = self.soup(
+            '<html id="start"><head></head><body><b id="1">One</b><b id="2">Two</b><b id="3">Three</b></body></html>')
+
+
+class TestNextOperations(ProximityTest):
+
+    def setup_method(self):
+        super(TestNextOperations, self).setup_method()
+        self.start = self.tree.b
+
+    def test_next(self):
+        assert self.start.next_element == "One"
+        assert self.start.next_element.next_element['id'] == "2"
+
+    def test_next_of_last_item_is_none(self):
+        last = self.tree.find(string="Three")
+        assert last.next_element == None
+
+    def test_next_of_root_is_none(self):
+        # The document root is outside the next/previous chain.
+        assert self.tree.next_element == None
+
+    def test_find_all_next(self):
+        self.assert_selects(self.start.find_all_next('b'), ["Two", "Three"])
+        self.start.find_all_next(id=3)
+        self.assert_selects(self.start.find_all_next(id=3), ["Three"])
+
+    def test_find_next(self):
+        assert self.start.find_next('b')['id'] == '2'
+        assert self.start.find_next(string="Three") == "Three"
+
+    def test_find_next_for_text_element(self):
+        text = self.tree.find(string="One")
+        assert text.find_next("b").string == "Two"
+        self.assert_selects(text.find_all_next("b"), ["Two", "Three"])
+
+    def test_next_generator(self):
+        start = self.tree.find(string="Two")
+        successors = [node for node in start.next_elements]
+        # There are two successors: the final <b> tag and its text contents.
+        tag, contents = successors
+        assert tag['id'] == '3'
+        assert contents == "Three"
+
+class TestPreviousOperations(ProximityTest):
+
+    def setup_method(self):
+        super(TestPreviousOperations, self).setup_method()
+        self.end = self.tree.find(string="Three")
+
+    def test_previous(self):
+        assert self.end.previous_element['id'] == "3"
+        assert self.end.previous_element.previous_element == "Two"
+
+    def test_previous_of_first_item_is_none(self):
+        first = self.tree.find('html')
+        assert first.previous_element == None
+
+    def test_previous_of_root_is_none(self):
+        # The document root is outside the next/previous chain.
+        assert self.tree.previous_element == None
+
+    def test_find_all_previous(self):
+        # The <b> tag containing the "Three" node is the predecessor
+        # of the "Three" node itself, which is why "Three" shows up
+        # here.
+        self.assert_selects(
+            self.end.find_all_previous('b'), ["Three", "Two", "One"])
+        self.assert_selects(self.end.find_all_previous(id=1), ["One"])
+
+    def test_find_previous(self):
+        assert self.end.find_previous('b')['id'] == '3'
+        assert self.end.find_previous(string="One") == "One"
+
+    def test_find_previous_for_text_element(self):
+        text = self.tree.find(string="Three")
+        assert text.find_previous("b").string == "Three"
+        self.assert_selects(
+            text.find_all_previous("b"), ["Three", "Two", "One"])
+
+    def test_previous_generator(self):
+        start = self.tree.find(string="One")
+        predecessors = [node for node in start.previous_elements]
+
+        # There are four predecessors: the <b> tag containing "One"
+        # the <body> tag, the <head> tag, and the <html> tag.
+        b, body, head, html = predecessors
+        assert b['id'] == '1'
+        assert body.name == "body"
+        assert head.name == "head"
+        assert html.name == "html"
+
+
+class SiblingTest(SoupTest):
+
+    def setup_method(self):
+        markup = '''<html>
+                    <span id="1">
+                     <span id="1.1"></span>
+                    </span>
+                    <span id="2">
+                     <span id="2.1"></span>
+                    </span>
+                    <span id="3">
+                     <span id="3.1"></span>
+                    </span>
+                    <span id="4"></span>
+                    </html>'''
+        # All that whitespace looks good but makes the tests more
+        # difficult. Get rid of it.
+        markup = re.compile(r"\n\s*").sub("", markup)
+        self.tree = self.soup(markup)
+
+
+class TestNextSibling(SiblingTest):
+
+    def setup_method(self):
+        super(TestNextSibling, self).setup_method()
+        self.start = self.tree.find(id="1")
+
+    def test_next_sibling_of_root_is_none(self):
+        assert self.tree.next_sibling == None
+
+    def test_next_sibling(self):
+        assert self.start.next_sibling['id'] == '2'
+        assert self.start.next_sibling.next_sibling['id'] == '3'
+
+        # Note the difference between next_sibling and next_element.
+        assert self.start.next_element['id'] == '1.1'
+
+    def test_next_sibling_may_not_exist(self):
+        assert self.tree.html.next_sibling == None
+
+        nested_span = self.tree.find(id="1.1")
+        assert nested_span.next_sibling == None
+
+        last_span = self.tree.find(id="4")
+        assert last_span.next_sibling == None
+
+    def test_find_next_sibling(self):
+        assert self.start.find_next_sibling('span')['id'] == '2'
+
+    def test_next_siblings(self):
+        self.assert_selects_ids(self.start.find_next_siblings("span"),
+                              ['2', '3', '4'])
+
+        self.assert_selects_ids(self.start.find_next_siblings(id='3'), ['3'])
+
+    def test_next_sibling_for_text_element(self):
+        soup = self.soup("Foo<b>bar</b>baz")
+        start = soup.find(string="Foo")
+        assert start.next_sibling.name == 'b'
+        assert start.next_sibling.next_sibling == 'baz'
+
+        self.assert_selects(start.find_next_siblings('b'), ['bar'])
+        assert start.find_next_sibling(string="baz") == "baz"
+        assert start.find_next_sibling(string="nonesuch") == None
+
+
+class TestPreviousSibling(SiblingTest):
+
+    def setup_method(self):
+        super(TestPreviousSibling, self).setup_method()
+        self.end = self.tree.find(id="4")
+
+    def test_previous_sibling_of_root_is_none(self):
+        assert self.tree.previous_sibling == None
+
+    def test_previous_sibling(self):
+        assert self.end.previous_sibling['id'] == '3'
+        assert self.end.previous_sibling.previous_sibling['id'] == '2'
+
+        # Note the difference between previous_sibling and previous_element.
+        assert self.end.previous_element['id'] == '3.1'
+
+    def test_previous_sibling_may_not_exist(self):
+        assert self.tree.html.previous_sibling == None
+
+        nested_span = self.tree.find(id="1.1")
+        assert nested_span.previous_sibling == None
+
+        first_span = self.tree.find(id="1")
+        assert first_span.previous_sibling == None
+
+    def test_find_previous_sibling(self):
+        assert self.end.find_previous_sibling('span')['id'] == '3'
+
+    def test_previous_siblings(self):
+        self.assert_selects_ids(self.end.find_previous_siblings("span"),
+                              ['3', '2', '1'])
+
+        self.assert_selects_ids(self.end.find_previous_siblings(id='1'), ['1'])
+
+    def test_previous_sibling_for_text_element(self):
+        soup = self.soup("Foo<b>bar</b>baz")
+        start = soup.find(string="baz")
+        assert start.previous_sibling.name == 'b'
+        assert start.previous_sibling.previous_sibling == 'Foo'
+
+        self.assert_selects(start.find_previous_siblings('b'), ['bar'])
+        assert start.find_previous_sibling(string="Foo") == "Foo"
+        assert start.find_previous_sibling(string="nonesuch") == None
+
+
+class TestTreeModification(SoupTest):
+
+    def test_attribute_modification(self):
+        soup = self.soup('<a id="1"></a>')
+        soup.a['id'] = 2
+        assert soup.decode() == self.document_for('<a id="2"></a>')
+        del(soup.a['id'])
+        assert soup.decode() == self.document_for('<a></a>')
+        soup.a['id2'] = 'foo'
+        assert soup.decode() == self.document_for('<a id2="foo"></a>')
+
+    def test_new_tag_creation(self):
+        builder = builder_registry.lookup('html')()
+        soup = self.soup("<body></body>", builder=builder)
+        a = Tag(soup, builder, 'a')
+        ol = Tag(soup, builder, 'ol')
+        a['href'] = 'http://foo.com/'
+        soup.body.insert(0, a)
+        soup.body.insert(1, ol)
+        assert soup.body.encode() == b'<body><a href="http://foo.com/"></a><ol></ol></body>'
+
+    def test_append_to_contents_moves_tag(self):
+        doc = """<p id="1">Don't leave me <b>here</b>.</p>
+                <p id="2">Don\'t leave!</p>"""
+        soup = self.soup(doc)
+        second_para = soup.find(id='2')
+        bold = soup.b
+
+        # Move the <b> tag to the end of the second paragraph.
+        soup.find(id='2').append(soup.b)
+
+        # The <b> tag is now a child of the second paragraph.
+        assert bold.parent == second_para
+
+        assert soup.decode() == self.document_for(
+                '<p id="1">Don\'t leave me .</p>\n'
+                '<p id="2">Don\'t leave!<b>here</b></p>'
+        )
+
+    def test_replace_with_returns_thing_that_was_replaced(self):
+        text = "<a></a><b><c></c></b>"
+        soup = self.soup(text)
+        a = soup.a
+        new_a = a.replace_with(soup.c)
+        assert a == new_a
+
+    def test_unwrap_returns_thing_that_was_replaced(self):
+        text = "<a><b></b><c></c></a>"
+        soup = self.soup(text)
+        a = soup.a
+        new_a = a.unwrap()
+        assert a == new_a
+
+    def test_replace_with_and_unwrap_give_useful_exception_when_tag_has_no_parent(self):
+        soup = self.soup("<a><b>Foo</b></a><c>Bar</c>")
+        a = soup.a
+        a.extract()
+        assert None == a.parent
+        with pytest.raises(ValueError):
+            a.unwrap()
+        with pytest.raises(ValueError):
+            a.replace_with(soup.c)
+
+    def test_replace_tag_with_itself(self):
+        text = "<a><b></b><c>Foo<d></d></c></a><a><e></e></a>"
+        soup = self.soup(text)
+        c = soup.c
+        soup.c.replace_with(c)
+        assert soup.decode() == self.document_for(text)
+
+    def test_replace_tag_with_its_parent_raises_exception(self):
+        text = "<a><b></b></a>"
+        soup = self.soup(text)
+        with pytest.raises(ValueError):
+            soup.b.replace_with(soup.a)
+
+    def test_insert_tag_into_itself_raises_exception(self):
+        text = "<a><b></b></a>"
+        soup = self.soup(text)
+        with pytest.raises(ValueError):
+            soup.a.insert(0, soup.a)
+
+    def test_insert_beautifulsoup_object_inserts_children(self):
+        """Inserting one BeautifulSoup object into another actually inserts all
+        of its children -- you'll never combine BeautifulSoup objects.
+        """
+        soup = self.soup("<p>And now, a word:</p><p>And we're back.</p>")
+        
+        text = "<p>p2</p><p>p3</p>"
+        to_insert = self.soup(text)
+        soup.insert(1, to_insert)
+
+        for i in soup.descendants:
+            assert not isinstance(i, BeautifulSoup)
+        
+        p1, p2, p3, p4 = list(soup.children)
+        assert "And now, a word:" == p1.string
+        assert "p2" == p2.string
+        assert "p3" == p3.string
+        assert "And we're back." == p4.string
+        
+        
+    def test_replace_with_maintains_next_element_throughout(self):
+        soup = self.soup('<p><a>one</a><b>three</b></p>')
+        a = soup.a
+        b = a.contents[0]
+        # Make it so the <a> tag has two text children.
+        a.insert(1, "two")
+
+        # Now replace each one with the empty string.
+        left, right = a.contents
+        left.replaceWith('')
+        right.replaceWith('')
+
+        # The <b> tag is still connected to the tree.
+        assert "three" == soup.b.string
+
+    def test_replace_final_node(self):
+        soup = self.soup("<b>Argh!</b>")
+        soup.find(string="Argh!").replace_with("Hooray!")
+        new_text = soup.find(string="Hooray!")
+        b = soup.b
+        assert new_text.previous_element == b
+        assert new_text.parent == b
+        assert new_text.previous_element.next_element == new_text
+        assert new_text.next_element == None
+
+    def test_consecutive_text_nodes(self):
+        # A builder should never create two consecutive text nodes,
+        # but if you insert one next to another, Beautiful Soup will
+        # handle it correctly.
+        soup = self.soup("<a><b>Argh!</b><c></c></a>")
+        soup.b.insert(1, "Hooray!")
+
+        assert soup.decode() == self.document_for(
+            "<a><b>Argh!Hooray!</b><c></c></a>"
+        )
+
+        new_text = soup.find(string="Hooray!")
+        assert new_text.previous_element == "Argh!"
+        assert new_text.previous_element.next_element == new_text
+
+        assert new_text.previous_sibling == "Argh!"
+        assert new_text.previous_sibling.next_sibling == new_text
+
+        assert new_text.next_sibling == None
+        assert new_text.next_element == soup.c
+
+    def test_insert_string(self):
+        soup = self.soup("<a></a>")
+        soup.a.insert(0, "bar")
+        soup.a.insert(0, "foo")
+        # The string were added to the tag.
+        assert ["foo", "bar"] == soup.a.contents
+        # And they were converted to NavigableStrings.
+        assert soup.a.contents[0].next_element == "bar"
+
+    def test_insert_tag(self):
+        builder = self.default_builder()
+        soup = self.soup(
+            "<a><b>Find</b><c>lady!</c><d></d></a>", builder=builder)
+        magic_tag = Tag(soup, builder, 'magictag')
+        magic_tag.insert(0, "the")
+        soup.a.insert(1, magic_tag)
+
+        assert soup.decode() == self.document_for(
+                "<a><b>Find</b><magictag>the</magictag><c>lady!</c><d></d></a>"
+        )
+
+        # Make sure all the relationships are hooked up correctly.
+        b_tag = soup.b
+        assert b_tag.next_sibling == magic_tag
+        assert magic_tag.previous_sibling == b_tag
+
+        find = b_tag.find(string="Find")
+        assert find.next_element == magic_tag
+        assert magic_tag.previous_element == find
+
+        c_tag = soup.c
+        assert magic_tag.next_sibling == c_tag
+        assert c_tag.previous_sibling == magic_tag
+
+        the = magic_tag.find(string="the")
+        assert the.parent == magic_tag
+        assert the.next_element == c_tag
+        assert c_tag.previous_element == the
+
+    def test_append_child_thats_already_at_the_end(self):
+        data = "<a><b></b></a>"
+        soup = self.soup(data)
+        soup.a.append(soup.b)
+        assert data == soup.decode()
+
+    def test_extend(self):
+        data = "<a><b><c><d><e><f><g></g></f></e></d></c></b></a>"
+        soup = self.soup(data)
+        l = [soup.g, soup.f, soup.e, soup.d, soup.c, soup.b]
+        soup.a.extend(l)
+        assert "<a><g></g><f></f><e></e><d></d><c></c><b></b></a>" == soup.decode()
+
+    def test_extend_with_another_tags_contents(self):
+        data = '<body><div id="d1"><a>1</a><a>2</a><a>3</a><a>4</a></div><div id="d2"></div></body>'
+        soup = self.soup(data)
+        d1 = soup.find('div', id='d1')
+        d2 = soup.find('div', id='d2')
+        d2.extend(d1)
+        assert '<div id="d1"></div>' == d1.decode()
+        assert '<div id="d2"><a>1</a><a>2</a><a>3</a><a>4</a></div>' == d2.decode()
+        
+    def test_move_tag_to_beginning_of_parent(self):
+        data = "<a><b></b><c></c><d></d></a>"
+        soup = self.soup(data)
+        soup.a.insert(0, soup.d)
+        assert "<a><d></d><b></b><c></c></a>" == soup.decode()
+
+    def test_insert_works_on_empty_element_tag(self):
+        # This is a little strange, since most HTML parsers don't allow
+        # markup like this to come through. But in general, we don't
+        # know what the parser would or wouldn't have allowed, so
+        # I'm letting this succeed for now.
+        soup = self.soup("<br/>")
+        soup.br.insert(1, "Contents")
+        assert str(soup.br) == "<br>Contents</br>"
+
+    def test_insert_before(self):
+        soup = self.soup("<a>foo</a><b>bar</b>")
+        soup.b.insert_before("BAZ")
+        soup.a.insert_before("QUUX")
+        assert soup.decode() == self.document_for(
+            "QUUX<a>foo</a>BAZ<b>bar</b>"
+        )
+
+        soup.a.insert_before(soup.b)
+        assert soup.decode() == self.document_for("QUUX<b>bar</b><a>foo</a>BAZ")
+
+        # Can't insert an element before itself.
+        b = soup.b
+        with pytest.raises(ValueError):
+            b.insert_before(b)
+
+        # Can't insert before if an element has no parent.
+        b.extract()
+        with pytest.raises(ValueError):
+            b.insert_before("nope")
+
+        # Can insert an identical element
+        soup = self.soup("<a>")
+        soup.a.insert_before(soup.new_tag("a"))
+
+        # TODO: OK but what happens?
+        
+    def test_insert_multiple_before(self):
+        soup = self.soup("<a>foo</a><b>bar</b>")
+        soup.b.insert_before("BAZ", " ", "QUUX")
+        soup.a.insert_before("QUUX", " ", "BAZ")
+        assert soup.decode() == self.document_for(
+            "QUUX BAZ<a>foo</a>BAZ QUUX<b>bar</b>"
+        )
+
+        soup.a.insert_before(soup.b, "FOO")
+        assert soup.decode() == self.document_for(
+            "QUUX BAZ<b>bar</b>FOO<a>foo</a>BAZ QUUX"
+        )
+
+    def test_insert_after(self):
+        soup = self.soup("<a>foo</a><b>bar</b>")
+        soup.b.insert_after("BAZ")
+        soup.a.insert_after("QUUX")
+        assert soup.decode() == self.document_for(
+            "<a>foo</a>QUUX<b>bar</b>BAZ"
+        )
+        soup.b.insert_after(soup.a)
+        assert soup.decode() == self.document_for("QUUX<b>bar</b><a>foo</a>BAZ")
+
+        # Can't insert an element after itself.
+        b = soup.b
+        with pytest.raises(ValueError):
+            b.insert_after(b)
+
+        # Can't insert after if an element has no parent.
+        b.extract()
+        with pytest.raises(ValueError):
+            b.insert_after("nope")
+
+        # Can insert an identical element
+        soup = self.soup("<a>")
+        soup.a.insert_before(soup.new_tag("a"))
+
+        # TODO: OK but what does it look like?
+        
+    def test_insert_multiple_after(self):
+        soup = self.soup("<a>foo</a><b>bar</b>")
+        soup.b.insert_after("BAZ", " ", "QUUX")
+        soup.a.insert_after("QUUX", " ", "BAZ")
+        assert soup.decode() == self.document_for(
+            "<a>foo</a>QUUX BAZ<b>bar</b>BAZ QUUX"
+        )
+        soup.b.insert_after(soup.a, "FOO ")
+        assert soup.decode() == self.document_for(
+            "QUUX BAZ<b>bar</b><a>foo</a>FOO BAZ QUUX"
+        )
+
+    def test_insert_after_raises_exception_if_after_has_no_meaning(self):
+        soup = self.soup("")
+        tag = soup.new_tag("a")
+        string = soup.new_string("")
+        with pytest.raises(ValueError):
+            string.insert_after(tag)
+        with pytest.raises(NotImplementedError):
+            soup.insert_after(tag)
+        with pytest.raises(ValueError):
+            tag.insert_after(tag)
+
+    def test_insert_before_raises_notimplementederror_if_before_has_no_meaning(self):
+        soup = self.soup("")
+        tag = soup.new_tag("a")
+        string = soup.new_string("")
+        with pytest.raises(ValueError):
+            string.insert_before(tag)
+        with pytest.raises(NotImplementedError):
+            soup.insert_before(tag)
+        with pytest.raises(ValueError):
+            tag.insert_before(tag)
+
+    def test_replace_with(self):
+        soup = self.soup(
+                "<p>There's <b>no</b> business like <b>show</b> business</p>")
+        no, show = soup.find_all('b')
+        show.replace_with(no)
+        assert soup.decode() == self.document_for(
+            "<p>There's  business like <b>no</b> business</p>"
+        )
+
+        assert show.parent == None
+        assert no.parent == soup.p
+        assert no.next_element == "no"
+        assert no.next_sibling == " business"
+
+    def test_replace_with_errors(self):
+        # Can't replace a tag that's not part of a tree.
+        a_tag = Tag(name="a")
+        with pytest.raises(ValueError):
+            a_tag.replace_with("won't work")
+
+        # Can't replace a tag with its parent.
+        a_tag = self.soup("<a><b></b></a>").a
+        with pytest.raises(ValueError):
+            a_tag.b.replace_with(a_tag)
+
+        # Or with a list that includes its parent.
+        with pytest.raises(ValueError):
+            a_tag.b.replace_with("string1", a_tag, "string2")
+        
+    def test_replace_with_multiple(self):
+        data = "<a><b></b><c></c></a>"
+        soup = self.soup(data)
+        d_tag = soup.new_tag("d")
+        d_tag.string = "Text In D Tag"
+        e_tag = soup.new_tag("e")
+        f_tag = soup.new_tag("f")
+        a_string = "Random Text"
+        soup.c.replace_with(d_tag, e_tag, a_string, f_tag)
+        assert soup.decode() == "<a><b></b><d>Text In D Tag</d><e></e>Random Text<f></f></a>"
+        assert soup.b.next_element == d_tag
+        assert d_tag.string.next_element==e_tag
+        assert e_tag.next_element.string == a_string
+        assert e_tag.next_element.next_element == f_tag
+        
+    def test_replace_first_child(self):
+        data = "<a><b></b><c></c></a>"
+        soup = self.soup(data)
+        soup.b.replace_with(soup.c)
+        assert "<a><c></c></a>" == soup.decode()
+
+    def test_replace_last_child(self):
+        data = "<a><b></b><c></c></a>"
+        soup = self.soup(data)
+        soup.c.replace_with(soup.b)
+        assert "<a><b></b></a>" == soup.decode()
+
+    def test_nested_tag_replace_with(self):
+        soup = self.soup(
+            """<a>We<b>reserve<c>the</c><d>right</d></b></a><e>to<f>refuse</f><g>service</g></e>""")
+
+        # Replace the entire <b> tag and its contents ("reserve the
+        # right") with the <f> tag ("refuse").
+        remove_tag = soup.b
+        move_tag = soup.f
+        remove_tag.replace_with(move_tag)
+
+        assert soup.decode() == self.document_for(
+            "<a>We<f>refuse</f></a><e>to<g>service</g></e>"
+        )
+
+        # The <b> tag is now an orphan.
+        assert remove_tag.parent == None
+        assert remove_tag.find(string="right").next_element == None
+        assert remove_tag.previous_element == None
+        assert remove_tag.next_sibling == None
+        assert remove_tag.previous_sibling == None
+
+        # The <f> tag is now connected to the <a> tag.
+        assert move_tag.parent == soup.a
+        assert move_tag.previous_element == "We"
+        assert move_tag.next_element.next_element == soup.e
+        assert move_tag.next_sibling == None
+
+        # The gap where the <f> tag used to be has been mended, and
+        # the word "to" is now connected to the <g> tag.
+        to_text = soup.find(string="to")
+        g_tag = soup.g
+        assert to_text.next_element == g_tag
+        assert to_text.next_sibling == g_tag
+        assert g_tag.previous_element == to_text
+        assert g_tag.previous_sibling == to_text
+
+    def test_unwrap(self):
+        tree = self.soup("""
+            <p>Unneeded <em>formatting</em> is unneeded</p>
+            """)
+        tree.em.unwrap()
+        assert tree.em == None
+        assert tree.p.text == "Unneeded formatting is unneeded"
+
+    def test_wrap(self):
+        soup = self.soup("I wish I was bold.")
+        value = soup.string.wrap(soup.new_tag("b"))
+        assert value.decode() == "<b>I wish I was bold.</b>"
+        assert soup.decode() == self.document_for("<b>I wish I was bold.</b>")
+
+    def test_wrap_extracts_tag_from_elsewhere(self):
+        soup = self.soup("<b></b>I wish I was bold.")
+        soup.b.next_sibling.wrap(soup.b)
+        assert soup.decode() == self.document_for("<b>I wish I was bold.</b>")
+
+    def test_wrap_puts_new_contents_at_the_end(self):
+        soup = self.soup("<b>I like being bold.</b>I wish I was bold.")
+        soup.b.next_sibling.wrap(soup.b)
+        assert 2 == len(soup.b.contents)
+        assert soup.decode() == self.document_for(
+            "<b>I like being bold.I wish I was bold.</b>"
+        )
+
+    def test_extract(self):
+        soup = self.soup(
+            '<html><body>Some content. <div id="nav">Nav crap</div> More content.</body></html>')
+
+        assert len(soup.body.contents) == 3
+        extracted = soup.find(id="nav").extract()
+
+        assert soup.decode() == "<html><body>Some content.  More content.</body></html>"
+        assert extracted.decode() == '<div id="nav">Nav crap</div>'
+
+        # The extracted tag is now an orphan.
+        assert len(soup.body.contents) == 2
+        assert extracted.parent == None
+        assert extracted.previous_element == None
+        assert extracted.next_element.next_element == None
+
+        # The gap where the extracted tag used to be has been mended.
+        content_1 = soup.find(string="Some content. ")
+        content_2 = soup.find(string=" More content.")
+        assert content_1.next_element == content_2
+        assert content_1.next_sibling == content_2
+        assert content_2.previous_element == content_1
+        assert content_2.previous_sibling == content_1
+
+    def test_extract_distinguishes_between_identical_strings(self):
+        soup = self.soup("<a>foo</a><b>bar</b>")
+        foo_1 = soup.a.string
+        bar_1 = soup.b.string
+        foo_2 = soup.new_string("foo")
+        bar_2 = soup.new_string("bar")
+        soup.a.append(foo_2)
+        soup.b.append(bar_2)
+
+        # Now there are two identical strings in the <a> tag, and two
+        # in the <b> tag. Let's remove the first "foo" and the second
+        # "bar".
+        foo_1.extract()
+        bar_2.extract()
+        assert foo_2 == soup.a.string
+        assert bar_2 == soup.b.string
+
+    def test_extract_multiples_of_same_tag(self):
+        soup = self.soup("""
+<html>
+<head>
+<script>foo</script>
+</head>
+<body>
+ <script>bar</script>
+ <a></a>
+</body>
+<script>baz</script>
+</html>""")
+        [soup.script.extract() for i in soup.find_all("script")]
+        assert "<body>\n\n<a></a>\n</body>" == str(soup.body)
+
+
+    def test_extract_works_when_element_is_surrounded_by_identical_strings(self):
+        soup = self.soup(
+ '<html>\n'
+ '<body>hi</body>\n'
+ '</html>')
+        soup.find('body').extract()
+        assert None == soup.find('body')
+
+
+    def test_clear(self):
+        """Tag.clear()"""
+        soup = self.soup("<p><a>String <em>Italicized</em></a> and another</p>")
+        # clear using extract()
+        a = soup.a
+        soup.p.clear()
+        assert len(soup.p.contents) == 0
+        assert hasattr(a, "contents")
+
+        # clear using decompose()
+        em = a.em
+        a.clear(decompose=True)
+        assert 0 == len(em.contents)
+
+       
+    def test_decompose(self):
+        # Test PageElement.decompose() and PageElement.decomposed
+        soup = self.soup("<p><a>String <em>Italicized</em></a></p><p>Another para</p>")
+        p1, p2 = soup.find_all('p')
+        a = p1.a
+        text = p1.em.string
+        for i in [p1, p2, a, text]:
+            assert False == i.decomposed
+
+        # This sets p1 and everything beneath it to decomposed.
+        p1.decompose()
+        for i in [p1, a, text]:
+            assert True == i.decomposed
+        # p2 is unaffected.
+        assert False == p2.decomposed
+            
+    def test_string_set(self):
+        """Tag.string = 'string'"""
+        soup = self.soup("<a></a> <b><c></c></b>")
+        soup.a.string = "foo"
+        assert soup.a.contents == ["foo"]
+        soup.b.string = "bar"
+        assert soup.b.contents == ["bar"]
+
+    def test_string_set_does_not_affect_original_string(self):
+        soup = self.soup("<a><b>foo</b><c>bar</c>")
+        soup.b.string = soup.c.string
+        assert soup.a.encode() == b"<a><b>bar</b><c>bar</c></a>"
+
+    def test_set_string_preserves_class_of_string(self):
+        soup = self.soup("<a></a>")
+        cdata = CData("foo")
+        soup.a.string = cdata
+        assert isinstance(soup.a.string, CData)
+
+
+class TestDeprecatedArguments(SoupTest):
+
+    def test_find_type_method_string(self):
+        soup = self.soup("<a>some</a><b>markup</b>")
+        with warnings.catch_warnings(record=True) as w:
+            [result] = soup.find_all(text='markup')
+            assert result == 'markup'
+            assert result.parent.name == 'b'
+            msg = str(w[0].message)
+            assert msg == "The 'text' argument to find()-type methods is deprecated. Use 'string' instead."
+
+    def test_soupstrainer_constructor_string(self):
+        with warnings.catch_warnings(record=True) as w:
+            strainer = SoupStrainer(text="text")
+            assert strainer.text == 'text'
+            msg = str(w[0].message)
+            assert msg == "The 'text' argument to the SoupStrainer constructor is deprecated. Use 'string' instead."
+
diff --git a/lib/soupsieve/__meta__.py b/lib/soupsieve/__meta__.py
index 2d769fbf..3bd6607f 100644
--- a/lib/soupsieve/__meta__.py
+++ b/lib/soupsieve/__meta__.py
@@ -192,5 +192,5 @@ def parse_version(ver: str) -> Version:
     return Version(major, minor, micro, release, pre, post, dev)
 
 
-__version_info__ = Version(2, 3, 1, "final")
+__version_info__ = Version(2, 3, 2, "final", post=1)
 __version__ = __version_info__._get_canonical()
diff --git a/lib/soupsieve/css_match.py b/lib/soupsieve/css_match.py
index 79bb8707..49e5f070 100644
--- a/lib/soupsieve/css_match.py
+++ b/lib/soupsieve/css_match.py
@@ -84,7 +84,7 @@ class _DocumentNav:
 
         # Fail on unexpected types.
         if not cls.is_tag(tag):
-            raise TypeError("Expected a BeautifulSoup 'Tag', but instead recieved type {}".format(type(tag)))
+            raise TypeError("Expected a BeautifulSoup 'Tag', but instead received type {}".format(type(tag)))
 
     @staticmethod
     def is_doc(obj: 'bs4.Tag') -> bool:
diff --git a/lib/soupsieve/css_parser.py b/lib/soupsieve/css_parser.py
index 0536b80f..d77084d4 100644
--- a/lib/soupsieve/css_parser.py
+++ b/lib/soupsieve/css_parser.py
@@ -562,7 +562,7 @@ class CSSParser:
         selector = self.custom.get(pseudo)
         if selector is None:
             raise SelectorSyntaxError(
-                "Undefined custom selector '{}' found at postion {}".format(pseudo, m.end(0)),
+                "Undefined custom selector '{}' found at position {}".format(pseudo, m.end(0)),
                 self.pattern,
                 m.end(0)
             )
@@ -828,7 +828,7 @@ class CSSParser:
         if not has_selector:
             if not is_forgive or combinator != COMMA_COMBINATOR:
                 raise SelectorSyntaxError(
-                    "The combinator '{}' at postion {}, must have a selector before it".format(combinator, index),
+                    "The combinator '{}' at position {}, must have a selector before it".format(combinator, index),
                     self.pattern,
                     index
                 )
@@ -1007,7 +1007,7 @@ class CSSParser:
                     if not has_selector:
                         if not is_forgive:
                             raise SelectorSyntaxError(
-                                "Expected a selector at postion {}".format(m.start(0)),
+                                "Expected a selector at position {}".format(m.start(0)),
                                 self.pattern,
                                 m.start(0)
                             )
@@ -1017,7 +1017,7 @@ class CSSParser:
                         break
                     else:
                         raise SelectorSyntaxError(
-                            "Unmatched pseudo-class close at postion {}".format(m.start(0)),
+                            "Unmatched pseudo-class close at position {}".format(m.start(0)),
                             self.pattern,
                             m.start(0)
                         )
diff --git a/requirements.txt b/requirements.txt
index 5e22dccb..d6b0816c 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -4,7 +4,7 @@ arrow==1.2.2
 backports.csv==1.0.7
 backports.functools-lru-cache==1.6.4
 backports.zoneinfo==0.2.1
-beautifulsoup4==4.10.0
+beautifulsoup4==4.11.1
 bleach==5.0.0
 certifi==2021.10.8
 cheroot==8.6.0
@@ -40,7 +40,7 @@ requests-oauthlib==1.3.1
 rumps==0.3.0; platform_system == "Darwin"
 simplejson==3.17.6
 six==1.16.0
-soupsieve==2.3.1
+soupsieve==2.3.2.post1
 tempora==5.0.1
 tokenize-rt==4.2.1
 tzdata==2022.1

From 55812ce2f0c89b83aff9a4ec033a2325011b37b5 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 16 May 2022 20:48:17 -0700
Subject: [PATCH 082/743] Bump importlib-resources from 5.6.0 to 5.7.1 (#1723)

* Bump importlib-resources from 5.6.0 to 5.7.1

Bumps [importlib-resources](https://github.com/python/importlib_resources) from 5.6.0 to 5.7.1.
- [Release notes](https://github.com/python/importlib_resources/releases)
- [Changelog](https://github.com/python/importlib_resources/blob/main/CHANGES.rst)
- [Commits](https://github.com/python/importlib_resources/compare/v5.6.0...v5.7.1)

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

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

* Update importlib-resources==5.7.1

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/importlib_resources/abc.py    | 11 +++++++++--
 lib/importlib_resources/simple.py | 15 ++++++++++++---
 package/requirements-package.txt  |  2 +-
 requirements.txt                  |  2 +-
 4 files changed, 23 insertions(+), 7 deletions(-)

diff --git a/lib/importlib_resources/abc.py b/lib/importlib_resources/abc.py
index a2b0af62..5e38ba61 100644
--- a/lib/importlib_resources/abc.py
+++ b/lib/importlib_resources/abc.py
@@ -55,6 +55,9 @@ class Traversable(Protocol):
     """
     An object with a subset of pathlib.Path methods suitable for
     traversing directories and opening files.
+
+    Any exceptions that occur when accessing the backing resource
+    may propagate unaltered.
     """
 
     @abc.abstractmethod
@@ -90,9 +93,13 @@ class Traversable(Protocol):
         """
 
     @abc.abstractmethod
-    def joinpath(self, child: StrPath) -> "Traversable":
+    def joinpath(self, *descendants: StrPath) -> "Traversable":
         """
-        Return Traversable child in self
+        Return Traversable resolved with any descendants applied.
+
+        Each descendant should be a path segment relative to self
+        and each may contain multiple levels separated by
+        ``posixpath.sep`` (``/``).
         """
 
     def __truediv__(self, child: StrPath) -> "Traversable":
diff --git a/lib/importlib_resources/simple.py b/lib/importlib_resources/simple.py
index da073cbd..d0fbf237 100644
--- a/lib/importlib_resources/simple.py
+++ b/lib/importlib_resources/simple.py
@@ -99,10 +99,19 @@ class ResourceContainer(Traversable):
     def open(self, *args, **kwargs):
         raise IsADirectoryError()
 
-    def joinpath(self, name):
+    @staticmethod
+    def _flatten(compound_names):
+        for name in compound_names:
+            yield from name.split('/')
+
+    def joinpath(self, *descendants):
+        if not descendants:
+            return self
+        names = self._flatten(descendants)
+        target = next(names)
         return next(
-            traversable for traversable in self.iterdir() if traversable.name == name
-        )
+            traversable for traversable in self.iterdir() if traversable.name == target
+        ).joinpath(*names)
 
 
 class TraversableReader(TraversableResources, SimpleReader):
diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index 5acd462f..910a9fb8 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -1,5 +1,5 @@
 apscheduler==3.9.1
-importlib-resources==5.6.0
+importlib-resources==5.7.1
 pyinstaller==4.9
 pyopenssl==22.0.0
 pycryptodomex==3.14.1
diff --git a/requirements.txt b/requirements.txt
index d6b0816c..6fb9cf89 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -19,7 +19,7 @@ html5lib==1.1
 httpagentparser==1.9.2
 idna==3.3
 importlib-metadata==4.11.3
-importlib-resources==5.6.0
+importlib-resources==5.7.1
 git+https://github.com/Tautulli/ipwhois.git@master#egg=ipwhois
 IPy==1.01
 Mako==1.2.0

From 93b6370759e6d6dff6a4361bc2ab583494a09264 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 16 May 2022 20:55:30 -0700
Subject: [PATCH 083/743] Bump xmltodict from 0.12.0 to 0.13.0 (#1739)

* Bump xmltodict from 0.12.0 to 0.13.0

Bumps [xmltodict](https://github.com/martinblech/xmltodict) from 0.12.0 to 0.13.0.
- [Release notes](https://github.com/martinblech/xmltodict/releases)
- [Changelog](https://github.com/martinblech/xmltodict/blob/master/CHANGELOG.md)
- [Commits](https://github.com/martinblech/xmltodict/compare/v0.12.0...v0.13.0)

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

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

* Update xmltodict==0.13.0

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/xmltodict.py | 96 ++++++++++++++++++++++++++++++++++++++----------
 requirements.txt |  2 +-
 2 files changed, 77 insertions(+), 21 deletions(-)

diff --git a/lib/xmltodict.py b/lib/xmltodict.py
index d6dbcd7a..ca760aa6 100644
--- a/lib/xmltodict.py
+++ b/lib/xmltodict.py
@@ -15,7 +15,12 @@ except ImportError:  # pragma no cover
     except ImportError:
         from io import StringIO
 
-from collections import OrderedDict
+_dict = dict
+import platform
+if tuple(map(int, platform.python_version_tuple()[:2])) < (3, 7):
+    from collections import OrderedDict as _dict
+
+from inspect import isgenerator
 
 try:  # pragma no cover
     _basestring = basestring
@@ -27,7 +32,7 @@ except NameError:  # pragma no cover
     _unicode = str
 
 __author__ = 'Martin Blech'
-__version__ = '0.12.0'
+__version__ = '0.13.0'
 __license__ = 'MIT'
 
 
@@ -45,11 +50,12 @@ class _DictSAXHandler(object):
                  force_cdata=False,
                  cdata_separator='',
                  postprocessor=None,
-                 dict_constructor=OrderedDict,
+                 dict_constructor=_dict,
                  strip_whitespace=True,
                  namespace_separator=':',
                  namespaces=None,
-                 force_list=None):
+                 force_list=None,
+                 comment_key='#comment'):
         self.path = []
         self.stack = []
         self.data = []
@@ -66,17 +72,21 @@ class _DictSAXHandler(object):
         self.strip_whitespace = strip_whitespace
         self.namespace_separator = namespace_separator
         self.namespaces = namespaces
-        self.namespace_declarations = OrderedDict()
+        self.namespace_declarations = dict_constructor()
         self.force_list = force_list
+        self.comment_key = comment_key
 
     def _build_name(self, full_name):
-        if not self.namespaces:
+        if self.namespaces is None:
             return full_name
         i = full_name.rfind(self.namespace_separator)
         if i == -1:
             return full_name
         namespace, name = full_name[:i], full_name[i+1:]
-        short_namespace = self.namespaces.get(namespace, namespace)
+        try:
+            short_namespace = self.namespaces[namespace]
+        except KeyError:
+            short_namespace = namespace
         if not short_namespace:
             return name
         else:
@@ -95,7 +105,7 @@ class _DictSAXHandler(object):
         attrs = self._attrs_to_dict(attrs)
         if attrs and self.namespace_declarations:
             attrs['xmlns'] = self.namespace_declarations
-            self.namespace_declarations = OrderedDict()
+            self.namespace_declarations = self.dict_constructor()
         self.path.append((name, attrs or None))
         if len(self.path) > self.item_depth:
             self.stack.append((self.item, self.data))
@@ -126,7 +136,7 @@ class _DictSAXHandler(object):
             should_continue = self.item_callback(self.path, item)
             if not should_continue:
                 raise ParsingInterrupted()
-        if len(self.stack):
+        if self.stack:
             data = (None if not self.data
                     else self.cdata_separator.join(self.data))
             item = self.item
@@ -152,6 +162,11 @@ class _DictSAXHandler(object):
         else:
             self.data.append(data)
 
+    def comments(self, data):
+        if self.strip_whitespace:
+            data = data.strip()
+        self.item = self.push_data(self.item, self.comment_key, data)
+
     def push_data(self, item, key, data):
         if self.postprocessor is not None:
             result = self.postprocessor(self.path, key, data)
@@ -185,10 +200,10 @@ class _DictSAXHandler(object):
 
 
 def parse(xml_input, encoding=None, expat=expat, process_namespaces=False,
-          namespace_separator=':', disable_entities=True, **kwargs):
+          namespace_separator=':', disable_entities=True, process_comments=False, **kwargs):
     """Parse the given XML input and convert it into a dictionary.
 
-    `xml_input` can either be a `string` or a file-like object.
+    `xml_input` can either be a `string`, a file-like object, or a generator of strings.
 
     If `xml_attribs` is `True`, element attributes are put in the dictionary
     among regular child elements, using `@` as a prefix to avoid collisions. If
@@ -243,21 +258,21 @@ def parse(xml_input, encoding=None, expat=expat, process_namespaces=False,
         ...         return key, value
         >>> xmltodict.parse('<a><b>1</b><b>2</b><b>x</b></a>',
         ...                 postprocessor=postprocessor)
-        OrderedDict([(u'a', OrderedDict([(u'b:int', [1, 2]), (u'b', u'x')]))])
+        {'a': {'b:int': [1, 2], 'b': 'x'}}
 
     You can pass an alternate version of `expat` (such as `defusedexpat`) by
     using the `expat` parameter. E.g:
 
         >>> import defusedexpat
         >>> xmltodict.parse('<a>hello</a>', expat=defusedexpat.pyexpat)
-        OrderedDict([(u'a', u'hello')])
+        {'a': 'hello'}
 
     You can use the force_list argument to force lists to be created even
     when there is only a single child of a given level of hierarchy. The
     force_list argument is a tuple of keys. If the key for a given level
     of hierarchy is in the force_list argument, that level of hierarchy
     will have a list as a child (even if there is only one sub-element).
-    The index_keys operation takes precendence over this. This is applied
+    The index_keys operation takes precedence over this. This is applied
     after any user-supplied postprocessor has already run.
 
         For example, given this input:
@@ -287,6 +302,36 @@ def parse(xml_input, encoding=None, expat=expat, process_namespaces=False,
         `force_list` can also be a callable that receives `path`, `key` and
         `value`. This is helpful in cases where the logic that decides whether
         a list should be forced is more complex.
+
+
+        If `process_comment` is `True` then comment will be added with comment_key
+        (default=`'#comment'`) to then tag which contains comment
+
+            For example, given this input:
+            <a>
+              <b>
+                <!-- b comment -->
+                <c>
+                    <!-- c comment -->
+                    1
+                </c>
+                <d>2</d>
+              </b>
+            </a>
+
+            If called with process_comment=True, it will produce
+            this dictionary:
+            'a': {
+                'b': {
+                    '#comment': 'b comment',
+                    'c': {
+
+                        '#comment': 'c comment',
+                        '#text': '1',
+                    },
+                    'd': '2',
+                },
+            }
     """
     handler = _DictSAXHandler(namespace_separator=namespace_separator,
                               **kwargs)
@@ -309,6 +354,8 @@ def parse(xml_input, encoding=None, expat=expat, process_namespaces=False,
     parser.StartElementHandler = handler.startElement
     parser.EndElementHandler = handler.endElement
     parser.CharacterDataHandler = handler.characters
+    if process_comments:
+        parser.CommentHandler = handler.comments
     parser.buffer_text = True
     if disable_entities:
         try:
@@ -323,6 +370,10 @@ def parse(xml_input, encoding=None, expat=expat, process_namespaces=False,
             parser.ExternalEntityRefHandler = lambda *x: 1
     if hasattr(xml_input, 'read'):
         parser.ParseFile(xml_input)
+    elif isgenerator(xml_input):
+        for chunk in xml_input:
+            parser.Parse(chunk,False)
+        parser.Parse(b'',True)
     else:
         parser.Parse(xml_input, True)
     return handler.item
@@ -353,7 +404,8 @@ def _emit(key, value, content_handler,
           indent='\t',
           namespace_separator=':',
           namespaces=None,
-          full_document=True):
+          full_document=True,
+          expand_iter=None):
     key = _process_namespace(key, namespaces, namespace_separator, attr_prefix)
     if preprocessor is not None:
         result = preprocessor(key, value)
@@ -368,18 +420,21 @@ def _emit(key, value, content_handler,
         if full_document and depth == 0 and index > 0:
             raise ValueError('document with multiple roots')
         if v is None:
-            v = OrderedDict()
+            v = _dict()
         elif isinstance(v, bool):
             if v:
                 v = _unicode('true')
             else:
                 v = _unicode('false')
         elif not isinstance(v, dict):
-            v = _unicode(v)
+            if expand_iter and hasattr(v, '__iter__') and not isinstance(v, _basestring):
+                v = _dict(((expand_iter, v),))
+            else:
+                v = _unicode(v)
         if isinstance(v, _basestring):
-            v = OrderedDict(((cdata_key, v),))
+            v = _dict(((cdata_key, v),))
         cdata = None
-        attrs = OrderedDict()
+        attrs = _dict()
         children = []
         for ik, iv in v.items():
             if ik == cdata_key:
@@ -407,7 +462,8 @@ def _emit(key, value, content_handler,
             _emit(child_key, child_value, content_handler,
                   attr_prefix, cdata_key, depth+1, preprocessor,
                   pretty, newl, indent, namespaces=namespaces,
-                  namespace_separator=namespace_separator)
+                  namespace_separator=namespace_separator,
+                  expand_iter=expand_iter)
         if cdata is not None:
             content_handler.characters(cdata)
         if pretty and children:
diff --git a/requirements.txt b/requirements.txt
index 6fb9cf89..4af4f688 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -48,7 +48,7 @@ tzlocal==4.2
 urllib3==1.26.9
 webencodings==0.5.1
 websocket-client==1.3.2
-xmltodict==0.12.0
+xmltodict==0.13.0
 zipp==3.8.0
 
 # configobj==5.1.0

From d17015de444212e087c1be7a696ac4d7d83fb7cd Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 16 May 2022 20:55:40 -0700
Subject: [PATCH 084/743] Bump pyparsing from 3.0.7 to 3.0.9 (#1741)

* Bump pyparsing from 3.0.7 to 3.0.9

Bumps [pyparsing](https://github.com/pyparsing/pyparsing) from 3.0.7 to 3.0.9.
- [Release notes](https://github.com/pyparsing/pyparsing/releases)
- [Changelog](https://github.com/pyparsing/pyparsing/blob/master/CHANGES)
- [Commits](https://github.com/pyparsing/pyparsing/compare/pyparsing_3.0.7...pyparsing_3.0.9)

---
updated-dependencies:
- dependency-name: pyparsing
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

* Update pyparsing==3.0.9

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/pyparsing/__init__.py             |  25 ++-
 lib/pyparsing/actions.py              |   2 +-
 lib/pyparsing/core.py                 | 281 ++++++++++++++------------
 lib/pyparsing/diagram/__init__.py     |  81 ++++++--
 lib/pyparsing/diagram/template.jinja2 |  26 ---
 lib/pyparsing/exceptions.py           |   4 +-
 lib/pyparsing/helpers.py              |  67 +++---
 lib/pyparsing/py.typed                |   0
 lib/pyparsing/results.py              |  26 +--
 lib/pyparsing/testing.py              |  10 +-
 lib/pyparsing/unicode.py              |  30 ++-
 requirements.txt                      |   2 +-
 12 files changed, 322 insertions(+), 232 deletions(-)
 delete mode 100644 lib/pyparsing/diagram/template.jinja2
 create mode 100644 lib/pyparsing/py.typed

diff --git a/lib/pyparsing/__init__.py b/lib/pyparsing/__init__.py
index 47b8e5cf..7802ff15 100644
--- a/lib/pyparsing/__init__.py
+++ b/lib/pyparsing/__init__.py
@@ -1,6 +1,6 @@
 # module pyparsing.py
 #
-# Copyright (c) 2003-2021  Paul T. McGuire
+# Copyright (c) 2003-2022  Paul T. McGuire
 #
 # Permission is hereby granted, free of charge, to any person obtaining
 # a copy of this software and associated documentation files (the
@@ -105,14 +105,17 @@ class version_info(NamedTuple):
 
     @property
     def __version__(self):
-        return "{}.{}.{}".format(self.major, self.minor, self.micro) + (
-            "{}{}{}".format(
-                "r" if self.releaselevel[0] == "c" else "",
-                self.releaselevel[0],
-                self.serial,
-            ),
-            "",
-        )[self.releaselevel == "final"]
+        return (
+            "{}.{}.{}".format(self.major, self.minor, self.micro)
+            + (
+                "{}{}{}".format(
+                    "r" if self.releaselevel[0] == "c" else "",
+                    self.releaselevel[0],
+                    self.serial,
+                ),
+                "",
+            )[self.releaselevel == "final"]
+        )
 
     def __str__(self):
         return "{} {} / {}".format(__name__, self.__version__, __version_time__)
@@ -125,8 +128,8 @@ class version_info(NamedTuple):
         )
 
 
-__version_info__ = version_info(3, 0, 7, "final", 0)
-__version_time__ = "15 Jan 2022 04:10 UTC"
+__version_info__ = version_info(3, 0, 9, "final", 0)
+__version_time__ = "05 May 2022 07:02 UTC"
 __version__ = __version_info__.__version__
 __versionTime__ = __version_time__
 __author__ = "Paul McGuire <ptmcg.gm+pyparsing@gmail.com>"
diff --git a/lib/pyparsing/actions.py b/lib/pyparsing/actions.py
index 2bcc5502..f72c66e7 100644
--- a/lib/pyparsing/actions.py
+++ b/lib/pyparsing/actions.py
@@ -55,7 +55,7 @@ def replace_with(repl_str):
         na = one_of("N/A NA").set_parse_action(replace_with(math.nan))
         term = na | num
 
-        OneOrMore(term).parse_string("324 234 N/A 234") # -> [324, 234, nan, 234]
+        term[1, ...].parse_string("324 234 N/A 234") # -> [324, 234, nan, 234]
     """
     return lambda s, l, t: [repl_str]
 
diff --git a/lib/pyparsing/core.py b/lib/pyparsing/core.py
index 0e10b673..9acba3f3 100644
--- a/lib/pyparsing/core.py
+++ b/lib/pyparsing/core.py
@@ -2,9 +2,8 @@
 # core.py
 #
 import os
+import typing
 from typing import (
-    Optional as OptionalType,
-    Iterable as IterableType,
     NamedTuple,
     Union,
     Callable,
@@ -14,7 +13,6 @@ from typing import (
     List,
     TextIO,
     Set,
-    Dict as DictType,
     Sequence,
 )
 from abc import ABC, abstractmethod
@@ -23,7 +21,6 @@ import string
 import copy
 import warnings
 import re
-import sre_constants
 import sys
 from collections.abc import Iterable
 import traceback
@@ -53,7 +50,7 @@ _MAX_INT = sys.maxsize
 str_type: Tuple[type, ...] = (str, bytes)
 
 #
-# Copyright (c) 2003-2021  Paul T. McGuire
+# Copyright (c) 2003-2022  Paul T. McGuire
 #
 # Permission is hereby granted, free of charge, to any person obtaining
 # a copy of this software and associated documentation files (the
@@ -76,6 +73,19 @@ str_type: Tuple[type, ...] = (str, bytes)
 #
 
 
+if sys.version_info >= (3, 8):
+    from functools import cached_property
+else:
+
+    class cached_property:
+        def __init__(self, func):
+            self._func = func
+
+        def __get__(self, instance, owner=None):
+            ret = instance.__dict__[self._func.__name__] = self._func(instance)
+            return ret
+
+
 class __compat__(__config_flags):
     """
     A cross-version compatibility configuration for pyparsing features that will be
@@ -180,7 +190,7 @@ del __config_flags
 
 
 def _should_enable_warnings(
-    cmd_line_warn_options: IterableType[str], warn_env_var: OptionalType[str]
+    cmd_line_warn_options: typing.Iterable[str], warn_env_var: typing.Optional[str]
 ) -> bool:
     enable = bool(warn_env_var)
     for warn_opt in cmd_line_warn_options:
@@ -246,10 +256,10 @@ hexnums = nums + "ABCDEFabcdef"
 alphanums = alphas + nums
 printables = "".join([c for c in string.printable if c not in string.whitespace])
 
-_trim_arity_call_line = None
+_trim_arity_call_line: traceback.StackSummary = None
 
 
-def _trim_arity(func, maxargs=2):
+def _trim_arity(func, max_limit=3):
     """decorator to trim function calls to match the arity of the target"""
     global _trim_arity_call_line
 
@@ -267,16 +277,12 @@ def _trim_arity(func, maxargs=2):
     # synthesize what would be returned by traceback.extract_stack at the call to
     # user's parse action 'func', so that we don't incur call penalty at parse time
 
-    LINE_DIFF = 11
+    # fmt: off
+    LINE_DIFF = 7
     # IF ANY CODE CHANGES, EVEN JUST COMMENTS OR BLANK LINES, BETWEEN THE NEXT LINE AND
     # THE CALL TO FUNC INSIDE WRAPPER, LINE_DIFF MUST BE MODIFIED!!!!
-    _trim_arity_call_line = (
-        _trim_arity_call_line or traceback.extract_stack(limit=2)[-1]
-    )
-    pa_call_line_synth = (
-        _trim_arity_call_line[0],
-        _trim_arity_call_line[1] + LINE_DIFF,
-    )
+    _trim_arity_call_line = (_trim_arity_call_line or traceback.extract_stack(limit=2)[-1])
+    pa_call_line_synth = (_trim_arity_call_line[0], _trim_arity_call_line[1] + LINE_DIFF)
 
     def wrapper(*args):
         nonlocal found_arity, limit
@@ -297,16 +303,18 @@ def _trim_arity(func, maxargs=2):
                     del tb
 
                     if trim_arity_type_error:
-                        if limit <= maxargs:
+                        if limit < max_limit:
                             limit += 1
                             continue
 
                     raise
+    # fmt: on
 
     # copy func name to wrapper for sensible debug output
     # (can't use functools.wraps, since that messes with function signature)
     func_name = getattr(func, "__name__", getattr(func, "__class__").__name__)
     wrapper.__name__ = func_name
+    wrapper.__doc__ = func.__doc__
 
     return wrapper
 
@@ -394,7 +402,7 @@ class ParserElement(ABC):
 
     DEFAULT_WHITE_CHARS: str = " \n\t\r"
     verbose_stacktrace: bool = False
-    _literalStringClass: OptionalType[type] = None
+    _literalStringClass: typing.Optional[type] = None
 
     @staticmethod
     def set_default_whitespace_chars(chars: str) -> None:
@@ -404,11 +412,11 @@ class ParserElement(ABC):
         Example::
 
             # default whitespace chars are space, <TAB> and newline
-            OneOrMore(Word(alphas)).parse_string("abc def\nghi jkl")  # -> ['abc', 'def', 'ghi', 'jkl']
+            Word(alphas)[1, ...].parse_string("abc def\nghi jkl")  # -> ['abc', 'def', 'ghi', 'jkl']
 
             # change to just treat newline as significant
             ParserElement.set_default_whitespace_chars(" \t")
-            OneOrMore(Word(alphas)).parse_string("abc def\nghi jkl")  # -> ['abc', 'def']
+            Word(alphas)[1, ...].parse_string("abc def\nghi jkl")  # -> ['abc', 'def']
         """
         ParserElement.DEFAULT_WHITE_CHARS = chars
 
@@ -440,13 +448,13 @@ class ParserElement(ABC):
         ParserElement._literalStringClass = cls
 
     class DebugActions(NamedTuple):
-        debug_try: OptionalType[DebugStartAction]
-        debug_match: OptionalType[DebugSuccessAction]
-        debug_fail: OptionalType[DebugExceptionAction]
+        debug_try: typing.Optional[DebugStartAction]
+        debug_match: typing.Optional[DebugSuccessAction]
+        debug_fail: typing.Optional[DebugExceptionAction]
 
     def __init__(self, savelist: bool = False):
         self.parseAction: List[ParseAction] = list()
-        self.failAction: OptionalType[ParseFailAction] = None
+        self.failAction: typing.Optional[ParseFailAction] = None
         self.customName = None
         self._defaultName = None
         self.resultsName = None
@@ -467,7 +475,6 @@ class ParserElement(ABC):
         self.modalResults = True
         # custom debug actions
         self.debugActions = self.DebugActions(None, None, None)
-        self.re = None
         # avoid redundant calls to preParse
         self.callPreparse = True
         self.callDuringTry = False
@@ -501,7 +508,7 @@ class ParserElement(ABC):
             integerK = integer.copy().add_parse_action(lambda toks: toks[0] * 1024) + Suppress("K")
             integerM = integer.copy().add_parse_action(lambda toks: toks[0] * 1024 * 1024) + Suppress("M")
 
-            print(OneOrMore(integerK | integerM | integer).parse_string("5K 100 640K 256M"))
+            print((integerK | integerM | integer)[1, ...].parse_string("5K 100 640K 256M"))
 
         prints::
 
@@ -886,7 +893,7 @@ class ParserElement(ABC):
 
     # cache for left-recursion in Forward references
     recursion_lock = RLock()
-    recursion_memos: DictType[
+    recursion_memos: typing.Dict[
         Tuple[int, "Forward", bool], Tuple[int, Union[ParseResults, Exception]]
     ] = {}
 
@@ -976,7 +983,7 @@ class ParserElement(ABC):
 
     @staticmethod
     def enable_left_recursion(
-        cache_size_limit: OptionalType[int] = None, *, force=False
+        cache_size_limit: typing.Optional[int] = None, *, force=False
     ) -> None:
         """
         Enables "bounded recursion" parsing, which allows for both direct and indirect
@@ -1342,7 +1349,7 @@ class ParserElement(ABC):
             last = e
         yield instring[last:]
 
-    def __add__(self, other):
+    def __add__(self, other) -> "ParserElement":
         """
         Implementation of ``+`` operator - returns :class:`And`. Adding strings to a :class:`ParserElement`
         converts them to :class:`Literal`s by default.
@@ -1382,7 +1389,7 @@ class ParserElement(ABC):
             )
         return And([self, other])
 
-    def __radd__(self, other):
+    def __radd__(self, other) -> "ParserElement":
         """
         Implementation of ``+`` operator when left operand is not a :class:`ParserElement`
         """
@@ -1399,7 +1406,7 @@ class ParserElement(ABC):
             )
         return other + self
 
-    def __sub__(self, other):
+    def __sub__(self, other) -> "ParserElement":
         """
         Implementation of ``-`` operator, returns :class:`And` with error stop
         """
@@ -1413,7 +1420,7 @@ class ParserElement(ABC):
             )
         return self + And._ErrorStop() + other
 
-    def __rsub__(self, other):
+    def __rsub__(self, other) -> "ParserElement":
         """
         Implementation of ``-`` operator when left operand is not a :class:`ParserElement`
         """
@@ -1427,7 +1434,7 @@ class ParserElement(ABC):
             )
         return other - self
 
-    def __mul__(self, other):
+    def __mul__(self, other) -> "ParserElement":
         """
         Implementation of ``*`` operator, allows use of ``expr * 3`` in place of
         ``expr + expr + expr``.  Expressions may also be multiplied by a 2-integer
@@ -1513,10 +1520,10 @@ class ParserElement(ABC):
                 ret = And([self] * minElements)
         return ret
 
-    def __rmul__(self, other):
+    def __rmul__(self, other) -> "ParserElement":
         return self.__mul__(other)
 
-    def __or__(self, other):
+    def __or__(self, other) -> "ParserElement":
         """
         Implementation of ``|`` operator - returns :class:`MatchFirst`
         """
@@ -1533,7 +1540,7 @@ class ParserElement(ABC):
             )
         return MatchFirst([self, other])
 
-    def __ror__(self, other):
+    def __ror__(self, other) -> "ParserElement":
         """
         Implementation of ``|`` operator when left operand is not a :class:`ParserElement`
         """
@@ -1547,7 +1554,7 @@ class ParserElement(ABC):
             )
         return other | self
 
-    def __xor__(self, other):
+    def __xor__(self, other) -> "ParserElement":
         """
         Implementation of ``^`` operator - returns :class:`Or`
         """
@@ -1561,7 +1568,7 @@ class ParserElement(ABC):
             )
         return Or([self, other])
 
-    def __rxor__(self, other):
+    def __rxor__(self, other) -> "ParserElement":
         """
         Implementation of ``^`` operator when left operand is not a :class:`ParserElement`
         """
@@ -1575,7 +1582,7 @@ class ParserElement(ABC):
             )
         return other ^ self
 
-    def __and__(self, other):
+    def __and__(self, other) -> "ParserElement":
         """
         Implementation of ``&`` operator - returns :class:`Each`
         """
@@ -1589,7 +1596,7 @@ class ParserElement(ABC):
             )
         return Each([self, other])
 
-    def __rand__(self, other):
+    def __rand__(self, other) -> "ParserElement":
         """
         Implementation of ``&`` operator when left operand is not a :class:`ParserElement`
         """
@@ -1603,7 +1610,7 @@ class ParserElement(ABC):
             )
         return other & self
 
-    def __invert__(self):
+    def __invert__(self) -> "ParserElement":
         """
         Implementation of ``~`` operator - returns :class:`NotAny`
         """
@@ -1653,7 +1660,7 @@ class ParserElement(ABC):
         ret = self * tuple(key[:2])
         return ret
 
-    def __call__(self, name: str = None):
+    def __call__(self, name: str = None) -> "ParserElement":
         """
         Shortcut for :class:`set_results_name`, with ``list_all_matches=False``.
 
@@ -1729,7 +1736,7 @@ class ParserElement(ABC):
 
         Example::
 
-            patt = OneOrMore(Word(alphas))
+            patt = Word(alphas)[1, ...]
             patt.parse_string('ablaj /* comment */ lskjd')
             # -> ['ablaj']
 
@@ -1789,7 +1796,7 @@ class ParserElement(ABC):
             # turn on debugging for wd
             wd.set_debug()
 
-            OneOrMore(term).parse_string("abc 123 xyz 890")
+            term[1, ...].parse_string("abc 123 xyz 890")
 
         prints::
 
@@ -1944,12 +1951,12 @@ class ParserElement(ABC):
         self,
         tests: Union[str, List[str]],
         parse_all: bool = True,
-        comment: OptionalType[Union["ParserElement", str]] = "#",
+        comment: typing.Optional[Union["ParserElement", str]] = "#",
         full_dump: bool = True,
         print_results: bool = True,
         failure_tests: bool = False,
         post_parse: Callable[[str, ParseResults], str] = None,
-        file: OptionalType[TextIO] = None,
+        file: typing.Optional[TextIO] = None,
         with_line_numbers: bool = False,
         *,
         parseAll: bool = True,
@@ -2140,6 +2147,7 @@ class ParserElement(ABC):
         output_html: Union[TextIO, Path, str],
         vertical: int = 3,
         show_results_names: bool = False,
+        show_groups: bool = False,
         **kwargs,
     ) -> None:
         """
@@ -2152,7 +2160,7 @@ class ParserElement(ABC):
           instead of horizontally (default=3)
         - show_results_names - bool flag whether diagram should show annotations for
           defined results names
-
+        - show_groups - bool flag whether groups should be highlighted with an unlabeled surrounding box
         Additional diagram-formatting keyword arguments can also be included;
         see railroad.Diagram class.
         """
@@ -2170,6 +2178,7 @@ class ParserElement(ABC):
             self,
             vertical=vertical,
             show_results_names=show_results_names,
+            show_groups=show_groups,
             diagram_kwargs=kwargs,
         )
         if isinstance(output_html, (str, Path)):
@@ -2219,7 +2228,7 @@ class _PendingSkip(ParserElement):
     def _generateDefaultName(self):
         return str(self.anchor + Empty()).replace("Empty", "...")
 
-    def __add__(self, other):
+    def __add__(self, other) -> "ParserElement":
         skipper = SkipTo(other).set_name("...")("_skipped*")
         if self.must_skip:
 
@@ -2374,11 +2383,11 @@ class Keyword(Token):
     def __init__(
         self,
         match_string: str = "",
-        ident_chars: OptionalType[str] = None,
+        ident_chars: typing.Optional[str] = None,
         caseless: bool = False,
         *,
         matchString: str = "",
-        identChars: OptionalType[str] = None,
+        identChars: typing.Optional[str] = None,
     ):
         super().__init__()
         identChars = identChars or ident_chars
@@ -2468,7 +2477,7 @@ class CaselessLiteral(Literal):
 
     Example::
 
-        OneOrMore(CaselessLiteral("CMD")).parse_string("cmd CMD Cmd10")
+        CaselessLiteral("CMD")[1, ...].parse_string("cmd CMD Cmd10")
         # -> ['CMD', 'CMD', 'CMD']
 
     (Contrast with example for :class:`CaselessKeyword`.)
@@ -2493,7 +2502,7 @@ class CaselessKeyword(Keyword):
 
     Example::
 
-        OneOrMore(CaselessKeyword("CMD")).parse_string("cmd CMD Cmd10")
+        CaselessKeyword("CMD")[1, ...].parse_string("cmd CMD Cmd10")
         # -> ['CMD', 'CMD']
 
     (Contrast with example for :class:`CaselessLiteral`.)
@@ -2502,10 +2511,10 @@ class CaselessKeyword(Keyword):
     def __init__(
         self,
         match_string: str = "",
-        ident_chars: OptionalType[str] = None,
+        ident_chars: typing.Optional[str] = None,
         *,
         matchString: str = "",
-        identChars: OptionalType[str] = None,
+        identChars: typing.Optional[str] = None,
     ):
         identChars = identChars or ident_chars
         match_string = matchString or match_string
@@ -2669,17 +2678,17 @@ class Word(Token):
     def __init__(
         self,
         init_chars: str = "",
-        body_chars: OptionalType[str] = None,
+        body_chars: typing.Optional[str] = None,
         min: int = 1,
         max: int = 0,
         exact: int = 0,
         as_keyword: bool = False,
-        exclude_chars: OptionalType[str] = None,
+        exclude_chars: typing.Optional[str] = None,
         *,
-        initChars: OptionalType[str] = None,
-        bodyChars: OptionalType[str] = None,
+        initChars: typing.Optional[str] = None,
+        bodyChars: typing.Optional[str] = None,
         asKeyword: bool = False,
-        excludeChars: OptionalType[str] = None,
+        excludeChars: typing.Optional[str] = None,
     ):
         initChars = initChars or init_chars
         bodyChars = bodyChars or body_chars
@@ -2773,7 +2782,7 @@ class Word(Token):
 
             try:
                 self.re = re.compile(self.reString)
-            except sre_constants.error:
+            except re.error:
                 self.re = None
             else:
                 self.re_match = self.re.match
@@ -2861,10 +2870,10 @@ class Char(_WordRegex):
         self,
         charset: str,
         as_keyword: bool = False,
-        exclude_chars: OptionalType[str] = None,
+        exclude_chars: typing.Optional[str] = None,
         *,
         asKeyword: bool = False,
-        excludeChars: OptionalType[str] = None,
+        excludeChars: typing.Optional[str] = None,
     ):
         asKeyword = asKeyword or as_keyword
         excludeChars = excludeChars or exclude_chars
@@ -2926,19 +2935,12 @@ class Regex(Token):
             if not pattern:
                 raise ValueError("null string passed to Regex; use Empty() instead")
 
-            self.pattern = pattern
+            self._re = None
+            self.reString = self.pattern = pattern
             self.flags = flags
 
-            try:
-                self.re = re.compile(self.pattern, self.flags)
-                self.reString = self.pattern
-            except sre_constants.error:
-                raise ValueError(
-                    "invalid pattern ({!r}) passed to Regex".format(pattern)
-                )
-
         elif hasattr(pattern, "pattern") and hasattr(pattern, "match"):
-            self.re = pattern
+            self._re = pattern
             self.pattern = self.reString = pattern.pattern
             self.flags = flags
 
@@ -2947,11 +2949,8 @@ class Regex(Token):
                 "Regex may only be constructed with a string or a compiled RE object"
             )
 
-        self.re_match = self.re.match
-
         self.errmsg = "Expected " + self.name
         self.mayIndexError = False
-        self.mayReturnEmpty = self.re_match("") is not None
         self.asGroupList = asGroupList
         self.asMatch = asMatch
         if self.asGroupList:
@@ -2959,6 +2958,26 @@ class Regex(Token):
         if self.asMatch:
             self.parseImpl = self.parseImplAsMatch
 
+    @cached_property
+    def re(self):
+        if self._re:
+            return self._re
+        else:
+            try:
+                return re.compile(self.pattern, self.flags)
+            except re.error:
+                raise ValueError(
+                    "invalid pattern ({!r}) passed to Regex".format(self.pattern)
+                )
+
+    @cached_property
+    def re_match(self):
+        return self.re.match
+
+    @cached_property
+    def mayReturnEmpty(self):
+        return self.re_match("") is not None
+
     def _generateDefaultName(self):
         return "Re:({})".format(repr(self.pattern).replace("\\\\", "\\"))
 
@@ -3067,18 +3086,18 @@ class QuotedString(Token):
     def __init__(
         self,
         quote_char: str = "",
-        esc_char: OptionalType[str] = None,
-        esc_quote: OptionalType[str] = None,
+        esc_char: typing.Optional[str] = None,
+        esc_quote: typing.Optional[str] = None,
         multiline: bool = False,
         unquote_results: bool = True,
-        end_quote_char: OptionalType[str] = None,
+        end_quote_char: typing.Optional[str] = None,
         convert_whitespace_escapes: bool = True,
         *,
         quoteChar: str = "",
-        escChar: OptionalType[str] = None,
-        escQuote: OptionalType[str] = None,
+        escChar: typing.Optional[str] = None,
+        escQuote: typing.Optional[str] = None,
         unquoteResults: bool = True,
-        endQuoteChar: OptionalType[str] = None,
+        endQuoteChar: typing.Optional[str] = None,
         convertWhitespaceEscapes: bool = True,
     ):
         super().__init__()
@@ -3168,7 +3187,7 @@ class QuotedString(Token):
             self.re = re.compile(self.pattern, self.flags)
             self.reString = self.pattern
             self.re_match = self.re.match
-        except sre_constants.error:
+        except re.error:
             raise ValueError(
                 "invalid pattern {!r} passed to Regex".format(self.pattern)
             )
@@ -3579,7 +3598,7 @@ class ParseExpression(ParserElement):
     post-processing parsed tokens.
     """
 
-    def __init__(self, exprs: IterableType[ParserElement], savelist: bool = False):
+    def __init__(self, exprs: typing.Iterable[ParserElement], savelist: bool = False):
         super().__init__(savelist)
         self.exprs: List[ParserElement]
         if isinstance(exprs, _generatorType):
@@ -3746,7 +3765,7 @@ class And(ParseExpression):
     Example::
 
         integer = Word(nums)
-        name_expr = OneOrMore(Word(alphas))
+        name_expr = Word(alphas)[1, ...]
 
         expr = And([integer("id"), name_expr("name"), integer("age")])
         # more easily written as:
@@ -3761,7 +3780,9 @@ class And(ParseExpression):
         def _generateDefaultName(self):
             return "-"
 
-    def __init__(self, exprs_arg: IterableType[ParserElement], savelist: bool = True):
+    def __init__(
+        self, exprs_arg: typing.Iterable[ParserElement], savelist: bool = True
+    ):
         exprs: List[ParserElement] = list(exprs_arg)
         if exprs and Ellipsis in exprs:
             tmp = []
@@ -3826,7 +3847,9 @@ class And(ParseExpression):
                 seen.add(id(cur))
                 if isinstance(cur, IndentedBlock):
                     prev.add_parse_action(
-                        lambda s, l, t, cur_=cur: setattr(cur_, "parent_anchor", col(l, s))
+                        lambda s, l, t, cur_=cur: setattr(
+                            cur_, "parent_anchor", col(l, s)
+                        )
                     )
                     break
                 subs = cur.recurse()
@@ -3903,7 +3926,7 @@ class Or(ParseExpression):
         [['123'], ['3.1416'], ['789']]
     """
 
-    def __init__(self, exprs: IterableType[ParserElement], savelist: bool = False):
+    def __init__(self, exprs: typing.Iterable[ParserElement], savelist: bool = False):
         super().__init__(exprs, savelist)
         if self.exprs:
             self.mayReturnEmpty = any(e.mayReturnEmpty for e in self.exprs)
@@ -4058,7 +4081,7 @@ class MatchFirst(ParseExpression):
         print(number.search_string("123 3.1416 789")) #  Better -> [['123'], ['3.1416'], ['789']]
     """
 
-    def __init__(self, exprs: IterableType[ParserElement], savelist: bool = False):
+    def __init__(self, exprs: typing.Iterable[ParserElement], savelist: bool = False):
         super().__init__(exprs, savelist)
         if self.exprs:
             self.mayReturnEmpty = any(e.mayReturnEmpty for e in self.exprs)
@@ -4209,7 +4232,7 @@ class Each(ParseExpression):
         - size: 20
     """
 
-    def __init__(self, exprs: IterableType[ParserElement], savelist: bool = True):
+    def __init__(self, exprs: typing.Iterable[ParserElement], savelist: bool = True):
         super().__init__(exprs, savelist)
         if self.exprs:
             self.mayReturnEmpty = all(e.mayReturnEmpty for e in self.exprs)
@@ -4545,7 +4568,7 @@ class FollowedBy(ParseElementEnhance):
         label = data_word + FollowedBy(':')
         attr_expr = Group(label + Suppress(':') + OneOrMore(data_word, stop_on=label).set_parse_action(' '.join))
 
-        OneOrMore(attr_expr).parse_string("shape: SQUARE color: BLACK posn: upper left").pprint()
+        attr_expr[1, ...].parse_string("shape: SQUARE color: BLACK posn: upper left").pprint()
 
     prints::
 
@@ -4596,7 +4619,7 @@ class PrecededBy(ParseElementEnhance):
     """
 
     def __init__(
-        self, expr: Union[ParserElement, str], retreat: OptionalType[int] = None
+        self, expr: Union[ParserElement, str], retreat: typing.Optional[int] = None
     ):
         super().__init__(expr)
         self.expr = self.expr().leave_whitespace()
@@ -4707,7 +4730,7 @@ class NotAny(ParseElementEnhance):
 
         # very crude boolean expression - to support parenthesis groups and
         # operation hierarchy, use infix_notation
-        boolean_expr = boolean_term + ZeroOrMore((AND | OR) + boolean_term)
+        boolean_expr = boolean_term + ((AND | OR) + boolean_term)[...]
 
         # integers that are followed by "." are actually floats
         integer = Word(nums) + ~Char(".")
@@ -4735,9 +4758,9 @@ class _MultipleMatch(ParseElementEnhance):
     def __init__(
         self,
         expr: ParserElement,
-        stop_on: OptionalType[Union[ParserElement, str]] = None,
+        stop_on: typing.Optional[Union[ParserElement, str]] = None,
         *,
-        stopOn: OptionalType[Union[ParserElement, str]] = None,
+        stopOn: typing.Optional[Union[ParserElement, str]] = None,
     ):
         super().__init__(expr)
         stopOn = stopOn or stop_on
@@ -4826,7 +4849,7 @@ class OneOrMore(_MultipleMatch):
         attr_expr = Group(label + Suppress(':') + OneOrMore(data_word).set_parse_action(' '.join))
 
         text = "shape: SQUARE posn: upper left color: BLACK"
-        OneOrMore(attr_expr).parse_string(text).pprint()  # Fail! read 'color' as data instead of next label -> [['shape', 'SQUARE color']]
+        attr_expr[1, ...].parse_string(text).pprint()  # Fail! read 'color' as data instead of next label -> [['shape', 'SQUARE color']]
 
         # use stop_on attribute for OneOrMore to avoid reading label string as part of the data
         attr_expr = Group(label + Suppress(':') + OneOrMore(data_word, stop_on=label).set_parse_action(' '.join))
@@ -4856,9 +4879,9 @@ class ZeroOrMore(_MultipleMatch):
     def __init__(
         self,
         expr: ParserElement,
-        stop_on: OptionalType[Union[ParserElement, str]] = None,
+        stop_on: typing.Optional[Union[ParserElement, str]] = None,
         *,
-        stopOn: OptionalType[Union[ParserElement, str]] = None,
+        stopOn: typing.Optional[Union[ParserElement, str]] = None,
     ):
         super().__init__(expr, stopOn=stopOn or stop_on)
         self.mayReturnEmpty = True
@@ -5002,20 +5025,20 @@ class SkipTo(ParseElementEnhance):
     prints::
 
         ['101', 'Critical', 'Intermittent system crash', '6']
-        - days_open: 6
-        - desc: Intermittent system crash
-        - issue_num: 101
-        - sev: Critical
+        - days_open: '6'
+        - desc: 'Intermittent system crash'
+        - issue_num: '101'
+        - sev: 'Critical'
         ['94', 'Cosmetic', "Spelling error on Login ('log|n')", '14']
-        - days_open: 14
-        - desc: Spelling error on Login ('log|n')
-        - issue_num: 94
-        - sev: Cosmetic
+        - days_open: '14'
+        - desc: "Spelling error on Login ('log|n')"
+        - issue_num: '94'
+        - sev: 'Cosmetic'
         ['79', 'Minor', 'System slow when running too many reports', '47']
-        - days_open: 47
-        - desc: System slow when running too many reports
-        - issue_num: 79
-        - sev: Minor
+        - days_open: '47'
+        - desc: 'System slow when running too many reports'
+        - issue_num: '79'
+        - sev: 'Minor'
     """
 
     def __init__(
@@ -5023,7 +5046,7 @@ class SkipTo(ParseElementEnhance):
         other: Union[ParserElement, str],
         include: bool = False,
         ignore: bool = None,
-        fail_on: OptionalType[Union[ParserElement, str]] = None,
+        fail_on: typing.Optional[Union[ParserElement, str]] = None,
         *,
         failOn: Union[ParserElement, str] = None,
     ):
@@ -5120,7 +5143,7 @@ class Forward(ParseElementEnhance):
     parser created using ``Forward``.
     """
 
-    def __init__(self, other: OptionalType[Union[ParserElement, str]] = None):
+    def __init__(self, other: typing.Optional[Union[ParserElement, str]] = None):
         self.caller_frame = traceback.extract_stack(limit=2)[0]
         super().__init__(other, savelist=False)
         self.lshift_line = None
@@ -5372,7 +5395,7 @@ class Combine(TokenConverter):
         join_string: str = "",
         adjacent: bool = True,
         *,
-        joinString: OptionalType[str] = None,
+        joinString: typing.Optional[str] = None,
     ):
         super().__init__(expr)
         joinString = joinString if joinString is not None else join_string
@@ -5459,10 +5482,10 @@ class Dict(TokenConverter):
         attr_expr = (label + Suppress(':') + OneOrMore(data_word, stop_on=label).set_parse_action(' '.join))
 
         # print attributes as plain groups
-        print(OneOrMore(attr_expr).parse_string(text).dump())
+        print(attr_expr[1, ...].parse_string(text).dump())
 
-        # instead of OneOrMore(expr), parse using Dict(OneOrMore(Group(expr))) - Dict will auto-assign names
-        result = Dict(OneOrMore(Group(attr_expr))).parse_string(text)
+        # instead of OneOrMore(expr), parse using Dict(Group(expr)[1, ...]) - Dict will auto-assign names
+        result = Dict(Group(attr_expr)[1, ...]).parse_string(text)
         print(result.dump())
 
         # access named fields as dict entries, or output as dict
@@ -5473,10 +5496,10 @@ class Dict(TokenConverter):
 
         ['shape', 'SQUARE', 'posn', 'upper left', 'color', 'light blue', 'texture', 'burlap']
         [['shape', 'SQUARE'], ['posn', 'upper left'], ['color', 'light blue'], ['texture', 'burlap']]
-        - color: light blue
-        - posn: upper left
-        - shape: SQUARE
-        - texture: burlap
+        - color: 'light blue'
+        - posn: 'upper left'
+        - shape: 'SQUARE'
+        - texture: 'burlap'
         SQUARE
         {'color': 'light blue', 'posn': 'upper left', 'texture': 'burlap', 'shape': 'SQUARE'}
 
@@ -5535,12 +5558,12 @@ class Suppress(TokenConverter):
 
         source = "a, b, c,d"
         wd = Word(alphas)
-        wd_list1 = wd + ZeroOrMore(',' + wd)
+        wd_list1 = wd + (',' + wd)[...]
         print(wd_list1.parse_string(source))
 
         # often, delimiters that are useful during parsing are just in the
         # way afterward - use Suppress to keep them out of the parsed output
-        wd_list2 = wd + ZeroOrMore(Suppress(',') + wd)
+        wd_list2 = wd + (Suppress(',') + wd)[...]
         print(wd_list2.parse_string(source))
 
         # Skipped text (using '...') can be suppressed as well
@@ -5564,13 +5587,13 @@ class Suppress(TokenConverter):
             expr = _PendingSkip(NoMatch())
         super().__init__(expr)
 
-    def __add__(self, other):
+    def __add__(self, other) -> "ParserElement":
         if isinstance(self.expr, _PendingSkip):
             return Suppress(SkipTo(other)) + other
         else:
             return super().__add__(other)
 
-    def __sub__(self, other):
+    def __sub__(self, other) -> "ParserElement":
         if isinstance(self.expr, _PendingSkip):
             return Suppress(SkipTo(other)) - other
         else:
@@ -5599,7 +5622,7 @@ def trace_parse_action(f: ParseAction) -> ParseAction:
         def remove_duplicate_chars(tokens):
             return ''.join(sorted(set(''.join(tokens))))
 
-        wds = OneOrMore(wd).set_parse_action(remove_duplicate_chars)
+        wds = wd[1, ...].set_parse_action(remove_duplicate_chars)
         print(wds.parse_string("slkdjs sld sldd sdlf sdljf"))
 
     prints::
@@ -5705,18 +5728,18 @@ def token_map(func, *args) -> ParseAction:
 
     Example (compare the last to example in :class:`ParserElement.transform_string`::
 
-        hex_ints = OneOrMore(Word(hexnums)).set_parse_action(token_map(int, 16))
+        hex_ints = Word(hexnums)[1, ...].set_parse_action(token_map(int, 16))
         hex_ints.run_tests('''
             00 11 22 aa FF 0a 0d 1a
             ''')
 
         upperword = Word(alphas).set_parse_action(token_map(str.upper))
-        OneOrMore(upperword).run_tests('''
+        upperword[1, ...].run_tests('''
             my kingdom for a horse
             ''')
 
         wd = Word(alphas).set_parse_action(token_map(str.title))
-        OneOrMore(wd).set_parse_action(' '.join).run_tests('''
+        wd[1, ...].set_parse_action(' '.join).run_tests('''
             now is the winter of our discontent made glorious summer by this sun of york
             ''')
 
@@ -5772,7 +5795,9 @@ punc8bit = srange(r"[\0xa1-\0xbf\0xd7\0xf7]")
 
 # build list of built-in expressions, for future reference if a global default value
 # gets updated
-_builtin_exprs = [v for v in vars().values() if isinstance(v, ParserElement)]
+_builtin_exprs: List[ParserElement] = [
+    v for v in vars().values() if isinstance(v, ParserElement)
+]
 
 # backward compatibility names
 tokenMap = token_map
diff --git a/lib/pyparsing/diagram/__init__.py b/lib/pyparsing/diagram/__init__.py
index 4f7c41e4..89864475 100644
--- a/lib/pyparsing/diagram/__init__.py
+++ b/lib/pyparsing/diagram/__init__.py
@@ -1,9 +1,8 @@
 import railroad
 import pyparsing
-from pkg_resources import resource_filename
+import typing
 from typing import (
     List,
-    Optional,
     NamedTuple,
     Generic,
     TypeVar,
@@ -16,13 +15,42 @@ from jinja2 import Template
 from io import StringIO
 import inspect
 
-with open(resource_filename(__name__, "template.jinja2"), encoding="utf-8") as fp:
-    template = Template(fp.read())
+
+jinja2_template_source = """\
+<!DOCTYPE html>
+<html>
+<head>
+    {% if not head %}
+        <style type="text/css">
+            .railroad-heading {
+                font-family: monospace;
+            }
+        </style>
+    {% else %}
+        {{ head | safe }}
+    {% endif %}
+</head>
+<body>
+{{ body | safe }}
+{% for diagram in diagrams %}
+    <div class="railroad-group">
+        <h1 class="railroad-heading">{{ diagram.title }}</h1>
+        <div class="railroad-description">{{ diagram.text }}</div>
+        <div class="railroad-svg">
+            {{ diagram.svg }}
+        </div>
+    </div>
+{% endfor %}
+</body>
+</html>
+"""
+
+template = Template(jinja2_template_source)
 
 # Note: ideally this would be a dataclass, but we're supporting Python 3.5+ so we can't do this yet
 NamedDiagram = NamedTuple(
     "NamedDiagram",
-    [("name", str), ("diagram", Optional[railroad.DiagramItem]), ("index", int)],
+    [("name", str), ("diagram", typing.Optional[railroad.DiagramItem]), ("index", int)],
 )
 """
 A simple structure for associating a name with a railroad diagram
@@ -54,7 +82,7 @@ class AnnotatedItem(railroad.Group):
     """
 
     def __init__(self, label: str, item):
-        super().__init__(item=item, label="[{}]".format(label))
+        super().__init__(item=item, label="[{}]".format(label) if label else label)
 
 
 class EditablePartial(Generic[T]):
@@ -106,6 +134,8 @@ def railroad_to_html(diagrams: List[NamedDiagram], **kwargs) -> str:
     """
     data = []
     for diagram in diagrams:
+        if diagram.diagram is None:
+            continue
         io = StringIO()
         diagram.diagram.writeSvg(io.write)
         title = diagram.name
@@ -134,9 +164,10 @@ def resolve_partial(partial: "EditablePartial[T]") -> T:
 
 def to_railroad(
     element: pyparsing.ParserElement,
-    diagram_kwargs: Optional[dict] = None,
+    diagram_kwargs: typing.Optional[dict] = None,
     vertical: int = 3,
     show_results_names: bool = False,
+    show_groups: bool = False,
 ) -> List[NamedDiagram]:
     """
     Convert a pyparsing element tree into a list of diagrams. This is the recommended entrypoint to diagram
@@ -147,6 +178,8 @@ def to_railroad(
        shown vertically instead of horizontally
     :param show_results_names - bool to indicate whether results name annotations should be
        included in the diagram
+    :param show_groups - bool to indicate whether groups should be highlighted with an unlabeled
+       surrounding box
     """
     # Convert the whole tree underneath the root
     lookup = ConverterState(diagram_kwargs=diagram_kwargs or {})
@@ -156,6 +189,7 @@ def to_railroad(
         parent=None,
         vertical=vertical,
         show_results_names=show_results_names,
+        show_groups=show_groups,
     )
 
     root_id = id(element)
@@ -211,12 +245,12 @@ class ElementState:
         parent: EditablePartial,
         number: int,
         name: str = None,
-        parent_index: Optional[int] = None,
+        parent_index: typing.Optional[int] = None,
     ):
         #: The pyparsing element that this represents
         self.element: pyparsing.ParserElement = element
         #: The name of the element
-        self.name: str = name
+        self.name: typing.Optional[str] = name
         #: The output Railroad element in an unconverted state
         self.converted: EditablePartial = converted
         #: The parent Railroad element, which we store so that we can extract this if it's duplicated
@@ -224,7 +258,7 @@ class ElementState:
         #: The order in which we found this element, used for sorting diagrams if this is extracted into a diagram
         self.number: int = number
         #: The index of this inside its parent
-        self.parent_index: Optional[int] = parent_index
+        self.parent_index: typing.Optional[int] = parent_index
         #: If true, we should extract this out into a subdiagram
         self.extract: bool = False
         #: If true, all of this element's children have been filled out
@@ -265,7 +299,7 @@ class ConverterState:
     Stores some state that persists between recursions into the element tree
     """
 
-    def __init__(self, diagram_kwargs: Optional[dict] = None):
+    def __init__(self, diagram_kwargs: typing.Optional[dict] = None):
         #: A dictionary mapping ParserElements to state relating to them
         self._element_diagram_states: Dict[int, ElementState] = {}
         #: A dictionary mapping ParserElement IDs to subdiagrams generated from them
@@ -356,13 +390,14 @@ def _apply_diagram_item_enhancements(fn):
 
     def _inner(
         element: pyparsing.ParserElement,
-        parent: Optional[EditablePartial],
+        parent: typing.Optional[EditablePartial],
         lookup: ConverterState = None,
         vertical: int = None,
         index: int = 0,
         name_hint: str = None,
         show_results_names: bool = False,
-    ) -> Optional[EditablePartial]:
+        show_groups: bool = False,
+    ) -> typing.Optional[EditablePartial]:
 
         ret = fn(
             element,
@@ -372,6 +407,7 @@ def _apply_diagram_item_enhancements(fn):
             index,
             name_hint,
             show_results_names,
+            show_groups,
         )
 
         # apply annotation for results name, if present
@@ -405,13 +441,14 @@ def _visible_exprs(exprs: Iterable[pyparsing.ParserElement]):
 @_apply_diagram_item_enhancements
 def _to_diagram_element(
     element: pyparsing.ParserElement,
-    parent: Optional[EditablePartial],
+    parent: typing.Optional[EditablePartial],
     lookup: ConverterState = None,
     vertical: int = None,
     index: int = 0,
     name_hint: str = None,
     show_results_names: bool = False,
-) -> Optional[EditablePartial]:
+    show_groups: bool = False,
+) -> typing.Optional[EditablePartial]:
     """
     Recursively converts a PyParsing Element to a railroad Element
     :param lookup: The shared converter state that keeps track of useful things
@@ -423,6 +460,7 @@ def _to_diagram_element(
     :param name_hint: If provided, this will override the generated name
     :param show_results_names: bool flag indicating whether to add annotations for results names
     :returns: The converted version of the input element, but as a Partial that hasn't yet been constructed
+    :param show_groups: bool flag indicating whether to show groups using bounding box
     """
     exprs = element.recurse()
     name = name_hint or element.customName or element.__class__.__name__
@@ -437,7 +475,7 @@ def _to_diagram_element(
         if isinstance(
             element,
             (
-                pyparsing.TokenConverter,
+                # pyparsing.TokenConverter,
                 # pyparsing.Forward,
                 pyparsing.Located,
             ),
@@ -457,6 +495,7 @@ def _to_diagram_element(
                     index=index,
                     name_hint=propagated_name,
                     show_results_names=show_results_names,
+                    show_groups=show_groups,
                 )
 
     # If the element isn't worth extracting, we always treat it as the first time we say it
@@ -510,6 +549,15 @@ def _to_diagram_element(
         ret = EditablePartial.from_call(AnnotatedItem, label="LOOKAHEAD", item="")
     elif isinstance(element, pyparsing.PrecededBy):
         ret = EditablePartial.from_call(AnnotatedItem, label="LOOKBEHIND", item="")
+    elif isinstance(element, pyparsing.Group):
+        if show_groups:
+            ret = EditablePartial.from_call(AnnotatedItem, label="", item="")
+        else:
+            ret = EditablePartial.from_call(railroad.Group, label="", item="")
+    elif isinstance(element, pyparsing.TokenConverter):
+        ret = EditablePartial.from_call(
+            AnnotatedItem, label=type(element).__name__.lower(), item=""
+        )
     elif isinstance(element, pyparsing.Opt):
         ret = EditablePartial.from_call(railroad.Optional, item="")
     elif isinstance(element, pyparsing.OneOrMore):
@@ -558,6 +606,7 @@ def _to_diagram_element(
             vertical=vertical,
             index=i,
             show_results_names=show_results_names,
+            show_groups=show_groups,
         )
 
         # Some elements don't need to be shown in the diagram
diff --git a/lib/pyparsing/diagram/template.jinja2 b/lib/pyparsing/diagram/template.jinja2
deleted file mode 100644
index d2219fb0..00000000
--- a/lib/pyparsing/diagram/template.jinja2
+++ /dev/null
@@ -1,26 +0,0 @@
-<!DOCTYPE html>
-<html>
-<head>
-    {% if not head %}
-        <style type="text/css">
-            .railroad-heading {
-                font-family: monospace;
-            }
-        </style>
-    {% else %}
-        {{ hear | safe }}
-    {% endif %}
-</head>
-<body>
-{{ body | safe }}
-{% for diagram in diagrams %}
-    <div class="railroad-group">
-        <h1 class="railroad-heading">{{ diagram.title }}</h1>
-        <div class="railroad-description">{{ diagram.text }}</div>
-        <div class="railroad-svg">
-            {{ diagram.svg }}
-        </div>
-    </div>
-{% endfor %}
-</body>
-</html>
diff --git a/lib/pyparsing/exceptions.py b/lib/pyparsing/exceptions.py
index e06513eb..a38447bb 100644
--- a/lib/pyparsing/exceptions.py
+++ b/lib/pyparsing/exceptions.py
@@ -2,7 +2,7 @@
 
 import re
 import sys
-from typing import Optional
+import typing
 
 from .util import col, line, lineno, _collapse_string_to_ranges
 from .unicode import pyparsing_unicode as ppu
@@ -25,7 +25,7 @@ class ParseBaseException(Exception):
         self,
         pstr: str,
         loc: int = 0,
-        msg: Optional[str] = None,
+        msg: typing.Optional[str] = None,
         elem=None,
     ):
         self.loc = loc
diff --git a/lib/pyparsing/helpers.py b/lib/pyparsing/helpers.py
index 5e7b3ad0..9588b3b7 100644
--- a/lib/pyparsing/helpers.py
+++ b/lib/pyparsing/helpers.py
@@ -1,6 +1,7 @@
 # helpers.py
 import html.entities
 import re
+import typing
 
 from . import __diag__
 from .core import *
@@ -14,8 +15,8 @@ def delimited_list(
     expr: Union[str, ParserElement],
     delim: Union[str, ParserElement] = ",",
     combine: bool = False,
-    min: OptionalType[int] = None,
-    max: OptionalType[int] = None,
+    min: typing.Optional[int] = None,
+    max: typing.Optional[int] = None,
     *,
     allow_trailing_delim: bool = False,
 ) -> ParserElement:
@@ -69,9 +70,9 @@ def delimited_list(
 
 def counted_array(
     expr: ParserElement,
-    int_expr: OptionalType[ParserElement] = None,
+    int_expr: typing.Optional[ParserElement] = None,
     *,
-    intExpr: OptionalType[ParserElement] = None,
+    intExpr: typing.Optional[ParserElement] = None,
 ) -> ParserElement:
     """Helper to define a counted list of expressions.
 
@@ -185,7 +186,9 @@ def match_previous_expr(expr: ParserElement) -> ParserElement:
         def must_match_these_tokens(s, l, t):
             theseTokens = _flatten(t.as_list())
             if theseTokens != matchTokens:
-                raise ParseException(s, l, "Expected {}, found{}".format(matchTokens, theseTokens))
+                raise ParseException(
+                    s, l, "Expected {}, found{}".format(matchTokens, theseTokens)
+                )
 
         rep.set_parse_action(must_match_these_tokens, callDuringTry=True)
 
@@ -195,7 +198,7 @@ def match_previous_expr(expr: ParserElement) -> ParserElement:
 
 
 def one_of(
-    strs: Union[IterableType[str], str],
+    strs: Union[typing.Iterable[str], str],
     caseless: bool = False,
     use_regex: bool = True,
     as_keyword: bool = False,
@@ -310,7 +313,7 @@ def one_of(
 
             return ret
 
-        except sre_constants.error:
+        except re.error:
             warnings.warn(
                 "Exception creating Regex for one_of, building MatchFirst", stacklevel=2
             )
@@ -335,7 +338,7 @@ def dict_of(key: ParserElement, value: ParserElement) -> ParserElement:
 
         text = "shape: SQUARE posn: upper left color: light blue texture: burlap"
         attr_expr = (label + Suppress(':') + OneOrMore(data_word, stop_on=label).set_parse_action(' '.join))
-        print(OneOrMore(attr_expr).parse_string(text).dump())
+        print(attr_expr[1, ...].parse_string(text).dump())
 
         attr_label = label
         attr_value = Suppress(':') + OneOrMore(data_word, stop_on=label).set_parse_action(' '.join)
@@ -350,10 +353,10 @@ def dict_of(key: ParserElement, value: ParserElement) -> ParserElement:
     prints::
 
         [['shape', 'SQUARE'], ['posn', 'upper left'], ['color', 'light blue'], ['texture', 'burlap']]
-        - color: light blue
-        - posn: upper left
-        - shape: SQUARE
-        - texture: burlap
+        - color: 'light blue'
+        - posn: 'upper left'
+        - shape: 'SQUARE'
+        - texture: 'burlap'
         SQUARE
         SQUARE
         {'color': 'light blue', 'shape': 'SQUARE', 'posn': 'upper left', 'texture': 'burlap'}
@@ -459,7 +462,7 @@ def locatedExpr(expr: ParserElement) -> ParserElement:
 def nested_expr(
     opener: Union[str, ParserElement] = "(",
     closer: Union[str, ParserElement] = ")",
-    content: OptionalType[ParserElement] = None,
+    content: typing.Optional[ParserElement] = None,
     ignore_expr: ParserElement = quoted_string(),
     *,
     ignoreExpr: ParserElement = quoted_string(),
@@ -680,6 +683,8 @@ def make_xml_tags(
     return _makeTags(tag_str, True)
 
 
+any_open_tag: ParserElement
+any_close_tag: ParserElement
 any_open_tag, any_close_tag = make_html_tags(
     Word(alphas, alphanums + "_:").set_name("any tag")
 )
@@ -708,7 +713,7 @@ InfixNotationOperatorSpec = Union[
         InfixNotationOperatorArgType,
         int,
         OpAssoc,
-        OptionalType[ParseAction],
+        typing.Optional[ParseAction],
     ],
     Tuple[
         InfixNotationOperatorArgType,
@@ -758,10 +763,14 @@ def infix_notation(
         a tuple or list of functions, this is equivalent to calling
         ``set_parse_action(*fn)``
         (:class:`ParserElement.set_parse_action`)
-    - ``lpar`` - expression for matching left-parentheses
-      (default= ``Suppress('(')``)
-    - ``rpar`` - expression for matching right-parentheses
-      (default= ``Suppress(')')``)
+    - ``lpar`` - expression for matching left-parentheses; if passed as a
+      str, then will be parsed as Suppress(lpar). If lpar is passed as
+      an expression (such as ``Literal('(')``), then it will be kept in
+      the parsed results, and grouped with them. (default= ``Suppress('(')``)
+    - ``rpar`` - expression for matching right-parentheses; if passed as a
+      str, then will be parsed as Suppress(rpar). If rpar is passed as
+      an expression (such as ``Literal(')')``), then it will be kept in
+      the parsed results, and grouped with them. (default= ``Suppress(')')``)
 
     Example::
 
@@ -803,9 +812,17 @@ def infix_notation(
     _FB.__name__ = "FollowedBy>"
 
     ret = Forward()
-    lpar = Suppress(lpar)
-    rpar = Suppress(rpar)
-    lastExpr = base_expr | (lpar + ret + rpar)
+    if isinstance(lpar, str):
+        lpar = Suppress(lpar)
+    if isinstance(rpar, str):
+        rpar = Suppress(rpar)
+
+    # if lpar and rpar are not suppressed, wrap in group
+    if not (isinstance(rpar, Suppress) and isinstance(rpar, Suppress)):
+        lastExpr = base_expr | Group(lpar + ret + rpar)
+    else:
+        lastExpr = base_expr | (lpar + ret + rpar)
+
     for i, operDef in enumerate(op_list):
         opExpr, arity, rightLeftAssoc, pa = (operDef + (None,))[:4]
         if isinstance(opExpr, str_type):
@@ -826,7 +843,7 @@ def infix_notation(
         if rightLeftAssoc not in (OpAssoc.LEFT, OpAssoc.RIGHT):
             raise ValueError("operator must indicate right or left associativity")
 
-        thisExpr = Forward().set_name(term_name)
+        thisExpr: Forward = Forward().set_name(term_name)
         if rightLeftAssoc is OpAssoc.LEFT:
             if arity == 1:
                 matchExpr = _FB(lastExpr + opExpr) + Group(lastExpr + opExpr[1, ...])
@@ -931,7 +948,7 @@ def indentedBlock(blockStatementExpr, indentStack, indent=True, backup_stacks=[]
         assignment = Group(identifier + "=" + rvalue)
         stmt << (funcDef | assignment | identifier)
 
-        module_body = OneOrMore(stmt)
+        module_body = stmt[1, ...]
 
         parseTree = module_body.parseString(data)
         parseTree.pprint()
@@ -1041,7 +1058,9 @@ python_style_comment = Regex(r"#.*").set_name("Python style comment")
 
 # build list of built-in expressions, for future reference if a global default value
 # gets updated
-_builtin_exprs = [v for v in vars().values() if isinstance(v, ParserElement)]
+_builtin_exprs: List[ParserElement] = [
+    v for v in vars().values() if isinstance(v, ParserElement)
+]
 
 
 # pre-PEP8 compatible names
diff --git a/lib/pyparsing/py.typed b/lib/pyparsing/py.typed
new file mode 100644
index 00000000..e69de29b
diff --git a/lib/pyparsing/results.py b/lib/pyparsing/results.py
index 9676f45b..00c9421d 100644
--- a/lib/pyparsing/results.py
+++ b/lib/pyparsing/results.py
@@ -65,9 +65,9 @@ class ParseResults:
         'month' in result -> True
         'minutes' in result -> False
         result.dump() -> ['1999', '/', '12', '/', '31']
-        - day: 31
-        - month: 12
-        - year: 1999
+        - day: '31'
+        - month: '12'
+        - year: '1999'
     """
 
     _null_values: Tuple[Any, ...] = (None, [], "", ())
@@ -287,7 +287,7 @@ class ParseResults:
             print(numlist.parse_string("0 123 321")) # -> ['123', '321']
 
             label = Word(alphas)
-            patt = label("LABEL") + OneOrMore(Word(nums))
+            patt = label("LABEL") + Word(nums)[1, ...]
             print(patt.parse_string("AAB 123 321").dump())
 
             # Use pop() in a parse action to remove named result (note that corresponding value is not
@@ -301,7 +301,7 @@ class ParseResults:
         prints::
 
             ['AAB', '123', '321']
-            - LABEL: AAB
+            - LABEL: 'AAB'
 
             ['AAB', '123', '321']
         """
@@ -394,7 +394,7 @@ class ParseResults:
 
         Example::
 
-            patt = OneOrMore(Word(alphas))
+            patt = Word(alphas)[1, ...]
 
             # use a parse action to append the reverse of the matched strings, to make a palindrome
             def make_palindrome(tokens):
@@ -487,7 +487,7 @@ class ParseResults:
 
         Example::
 
-            patt = OneOrMore(Word(alphas))
+            patt = Word(alphas)[1, ...]
             result = patt.parse_string("sldkj lsdkj sldkj")
             # even though the result prints in string-like form, it is actually a pyparsing ParseResults
             print(type(result), result) # -> <class 'pyparsing.ParseResults'> ['sldkj', 'lsdkj', 'sldkj']
@@ -554,7 +554,7 @@ class ParseResults:
             user_data = (Group(house_number_expr)("house_number")
                         | Group(ssn_expr)("ssn")
                         | Group(integer)("age"))
-            user_info = OneOrMore(user_data)
+            user_info = user_data[1, ...]
 
             result = user_info.parse_string("22 111-22-3333 #221B")
             for item in result:
@@ -603,15 +603,15 @@ class ParseResults:
             integer = Word(nums)
             date_str = integer("year") + '/' + integer("month") + '/' + integer("day")
 
-            result = date_str.parse_string('12/31/1999')
+            result = date_str.parse_string('1999/12/31')
             print(result.dump())
 
         prints::
 
-            ['12', '/', '31', '/', '1999']
-            - day: 1999
-            - month: 31
-            - year: 12
+            ['1999', '/', '12', '/', '31']
+            - day: '31'
+            - month: '12'
+            - year: '1999'
         """
         out = []
         NL = "\n"
diff --git a/lib/pyparsing/testing.py b/lib/pyparsing/testing.py
index 991972f3..84a0ef17 100644
--- a/lib/pyparsing/testing.py
+++ b/lib/pyparsing/testing.py
@@ -1,7 +1,7 @@
 # testing.py
 
 from contextlib import contextmanager
-from typing import Optional
+import typing
 
 from .core import (
     ParserElement,
@@ -237,12 +237,12 @@ class pyparsing_test:
     @staticmethod
     def with_line_numbers(
         s: str,
-        start_line: Optional[int] = None,
-        end_line: Optional[int] = None,
+        start_line: typing.Optional[int] = None,
+        end_line: typing.Optional[int] = None,
         expand_tabs: bool = True,
         eol_mark: str = "|",
-        mark_spaces: Optional[str] = None,
-        mark_control: Optional[str] = None,
+        mark_spaces: typing.Optional[str] = None,
+        mark_control: typing.Optional[str] = None,
     ) -> str:
         """
         Helpful method for debugging a parser - prints a string with line and column numbers.
diff --git a/lib/pyparsing/unicode.py b/lib/pyparsing/unicode.py
index 92261487..06526203 100644
--- a/lib/pyparsing/unicode.py
+++ b/lib/pyparsing/unicode.py
@@ -120,7 +120,18 @@ class pyparsing_unicode(unicode_set):
     A namespace class for defining common language unicode_sets.
     """
 
-    _ranges: UnicodeRangeList = [(32, sys.maxunicode)]
+    # fmt: off
+
+    # define ranges in language character sets
+    _ranges: UnicodeRangeList = [
+        (0x0020, sys.maxunicode),
+    ]
+
+    class BasicMultilingualPlane(unicode_set):
+        "Unicode set for the Basic Multilingual Plane"
+        _ranges: UnicodeRangeList = [
+            (0x0020, 0xFFFF),
+        ]
 
     class Latin1(unicode_set):
         "Unicode set for Latin-1 Unicode Character Range"
@@ -278,11 +289,13 @@ class pyparsing_unicode(unicode_set):
 
     class CJK(Chinese, Japanese, Hangul):
         "Unicode set for combined Chinese, Japanese, and Korean (CJK) Unicode Character Range"
-        pass
 
     class Thai(unicode_set):
         "Unicode set for Thai Unicode Character Range"
-        _ranges: UnicodeRangeList = [(0x0E01, 0x0E3A), (0x0E3F, 0x0E5B)]
+        _ranges: UnicodeRangeList = [
+            (0x0E01, 0x0E3A),
+            (0x0E3F, 0x0E5B)
+        ]
 
     class Arabic(unicode_set):
         "Unicode set for Arabic Unicode Character Range"
@@ -308,7 +321,12 @@ class pyparsing_unicode(unicode_set):
 
     class Devanagari(unicode_set):
         "Unicode set for Devanagari Unicode Character Range"
-        _ranges: UnicodeRangeList = [(0x0900, 0x097F), (0xA8E0, 0xA8FF)]
+        _ranges: UnicodeRangeList = [
+            (0x0900, 0x097F),
+            (0xA8E0, 0xA8FF)
+        ]
+
+    # fmt: on
 
 
 pyparsing_unicode.Japanese._ranges = (
@@ -317,7 +335,9 @@ pyparsing_unicode.Japanese._ranges = (
     + pyparsing_unicode.Japanese.Katakana._ranges
 )
 
-# define ranges in language character sets
+pyparsing_unicode.BMP = pyparsing_unicode.BasicMultilingualPlane
+
+# add language identifiers using language Unicode
 pyparsing_unicode.العربية = pyparsing_unicode.Arabic
 pyparsing_unicode.中文 = pyparsing_unicode.Chinese
 pyparsing_unicode.кириллица = pyparsing_unicode.Cyrillic
diff --git a/requirements.txt b/requirements.txt
index 4af4f688..7550b14b 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -31,7 +31,7 @@ plexapi==4.9.2
 portend==3.1.0
 profilehooks==1.12.0
 PyJWT==2.3.0
-pyparsing==3.0.7
+pyparsing==3.0.9
 python-dateutil==2.8.2
 python-twitter==3.5
 pytz==2022.1

From b3aeaafd00c7f8013a57415a5f0f658cddfeebc9 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 16 May 2022 20:56:13 -0700
Subject: [PATCH 085/743] Bump pyjwt from 2.3.0 to 2.4.0 (#1743)

* Bump pyjwt from 2.3.0 to 2.4.0

Bumps [pyjwt](https://github.com/jpadilla/pyjwt) from 2.3.0 to 2.4.0.
- [Release notes](https://github.com/jpadilla/pyjwt/releases)
- [Changelog](https://github.com/jpadilla/pyjwt/blob/master/CHANGELOG.rst)
- [Commits](https://github.com/jpadilla/pyjwt/compare/2.3.0...2.4.0)

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

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

* Update pyjwt==2.4.0

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/jwt/__init__.py   |  6 ++---
 lib/jwt/algorithms.py | 45 ++++++++++++++++---------------
 lib/jwt/api_jwk.py    | 18 ++++++++-----
 lib/jwt/api_jws.py    | 62 ++++++++++++++++++++++++++++++++-----------
 lib/jwt/api_jwt.py    | 28 ++++++++++++-------
 lib/jwt/exceptions.py |  2 +-
 lib/jwt/help.py       |  8 +++---
 lib/jwt/utils.py      | 61 ++++++++++++++++++++++++++++++++++++++++++
 requirements.txt      |  2 +-
 9 files changed, 171 insertions(+), 61 deletions(-)

diff --git a/lib/jwt/__init__.py b/lib/jwt/__init__.py
index 3208c39f..6b3f8ab1 100644
--- a/lib/jwt/__init__.py
+++ b/lib/jwt/__init__.py
@@ -25,19 +25,19 @@ from .exceptions import (
 )
 from .jwks_client import PyJWKClient
 
-__version__ = "2.3.0"
+__version__ = "2.4.0"
 
 __title__ = "PyJWT"
 __description__ = "JSON Web Token implementation in Python"
 __url__ = "https://pyjwt.readthedocs.io"
 __uri__ = __url__
-__doc__ = __description__ + " <" + __uri__ + ">"
+__doc__ = f"{__description__} <{__uri__}>"
 
 __author__ = "José Padilla"
 __email__ = "hello@jpadilla.com"
 
 __license__ = "MIT"
-__copyright__ = "Copyright 2015-2020 José Padilla"
+__copyright__ = "Copyright 2015-2022 José Padilla"
 
 
 __all__ = [
diff --git a/lib/jwt/algorithms.py b/lib/jwt/algorithms.py
index 1f8865af..46a1a532 100644
--- a/lib/jwt/algorithms.py
+++ b/lib/jwt/algorithms.py
@@ -9,6 +9,8 @@ from .utils import (
     der_to_raw_signature,
     force_bytes,
     from_base64url_uint,
+    is_pem_format,
+    is_ssh_key,
     raw_to_der_signature,
     to_base64url_uint,
 )
@@ -183,14 +185,7 @@ class HMACAlgorithm(Algorithm):
     def prepare_key(self, key):
         key = force_bytes(key)
 
-        invalid_strings = [
-            b"-----BEGIN PUBLIC KEY-----",
-            b"-----BEGIN CERTIFICATE-----",
-            b"-----BEGIN RSA PUBLIC KEY-----",
-            b"ssh-rsa",
-        ]
-
-        if any(string_value in key for string_value in invalid_strings):
+        if is_pem_format(key) or is_ssh_key(key):
             raise InvalidKeyError(
                 "The specified key is an asymmetric key or x509 certificate and"
                 " should not be used as an HMAC secret."
@@ -417,6 +412,12 @@ if has_crypto:
             except ValueError:
                 key = load_pem_private_key(key, password=None)
 
+            # Explicit check the key to prevent confusing errors from cryptography
+            if not isinstance(key, (EllipticCurvePrivateKey, EllipticCurvePublicKey)):
+                raise InvalidKeyError(
+                    "Expecting a EllipticCurvePrivateKey/EllipticCurvePublicKey. Wrong key provided for ECDSA algorithms"
+                )
+
             return key
 
         def sign(self, msg, key):
@@ -545,26 +546,28 @@ if has_crypto:
             pass
 
         def prepare_key(self, key):
-
-            if isinstance(
-                key,
-                (Ed25519PrivateKey, Ed25519PublicKey, Ed448PrivateKey, Ed448PublicKey),
-            ):
-                return key
-
             if isinstance(key, (bytes, str)):
                 if isinstance(key, str):
                     key = key.encode("utf-8")
                 str_key = key.decode("utf-8")
 
                 if "-----BEGIN PUBLIC" in str_key:
-                    return load_pem_public_key(key)
-                if "-----BEGIN PRIVATE" in str_key:
-                    return load_pem_private_key(key, password=None)
-                if str_key[0:4] == "ssh-":
-                    return load_ssh_public_key(key)
+                    key = load_pem_public_key(key)
+                elif "-----BEGIN PRIVATE" in str_key:
+                    key = load_pem_private_key(key, password=None)
+                elif str_key[0:4] == "ssh-":
+                    key = load_ssh_public_key(key)
 
-            raise TypeError("Expecting a PEM-formatted or OpenSSH key.")
+            # Explicit check the key to prevent confusing errors from cryptography
+            if not isinstance(
+                key,
+                (Ed25519PrivateKey, Ed25519PublicKey, Ed448PrivateKey, Ed448PublicKey),
+            ):
+                raise InvalidKeyError(
+                    "Expecting a EllipticCurvePrivateKey/EllipticCurvePublicKey. Wrong key provided for EdDSA algorithms"
+                )
+
+            return key
 
         def sign(self, msg, key):
             """
diff --git a/lib/jwt/api_jwk.py b/lib/jwt/api_jwk.py
index a0f6364d..31250d57 100644
--- a/lib/jwt/api_jwk.py
+++ b/lib/jwt/api_jwk.py
@@ -11,7 +11,7 @@ class PyJWK:
 
         kty = self._jwk_data.get("kty", None)
         if not kty:
-            raise InvalidKeyError("kty is not found: %s" % self._jwk_data)
+            raise InvalidKeyError(f"kty is not found: {self._jwk_data}")
 
         if not algorithm and isinstance(self._jwk_data, dict):
             algorithm = self._jwk_data.get("alg", None)
@@ -29,25 +29,25 @@ class PyJWK:
                 elif crv == "secp256k1":
                     algorithm = "ES256K"
                 else:
-                    raise InvalidKeyError("Unsupported crv: %s" % crv)
+                    raise InvalidKeyError(f"Unsupported crv: {crv}")
             elif kty == "RSA":
                 algorithm = "RS256"
             elif kty == "oct":
                 algorithm = "HS256"
             elif kty == "OKP":
                 if not crv:
-                    raise InvalidKeyError("crv is not found: %s" % self._jwk_data)
+                    raise InvalidKeyError(f"crv is not found: {self._jwk_data}")
                 if crv == "Ed25519":
                     algorithm = "EdDSA"
                 else:
-                    raise InvalidKeyError("Unsupported crv: %s" % crv)
+                    raise InvalidKeyError(f"Unsupported crv: {crv}")
             else:
-                raise InvalidKeyError("Unsupported kty: %s" % kty)
+                raise InvalidKeyError(f"Unsupported kty: {kty}")
 
         self.Algorithm = self._algorithms.get(algorithm)
 
         if not self.Algorithm:
-            raise PyJWKError("Unable to find a algorithm for key: %s" % self._jwk_data)
+            raise PyJWKError(f"Unable to find a algorithm for key: {self._jwk_data}")
 
         self.key = self.Algorithm.from_jwk(self._jwk_data)
 
@@ -95,3 +95,9 @@ class PyJWKSet:
     def from_json(data):
         obj = json.loads(data)
         return PyJWKSet.from_dict(obj)
+
+    def __getitem__(self, kid):
+        for key in self.keys:
+            if key.key_id == kid:
+                return key
+        raise KeyError(f"keyset has no key for kid: {kid}")
diff --git a/lib/jwt/api_jws.py b/lib/jwt/api_jws.py
index f85072e0..cbf4f6f5 100644
--- a/lib/jwt/api_jws.py
+++ b/lib/jwt/api_jws.py
@@ -80,34 +80,54 @@ class PyJWS:
         algorithm: Optional[str] = "HS256",
         headers: Optional[Dict] = None,
         json_encoder: Optional[Type[json.JSONEncoder]] = None,
+        is_payload_detached: bool = False,
     ) -> str:
         segments = []
 
         if algorithm is None:
             algorithm = "none"
 
-        # Prefer headers["alg"] if present to algorithm parameter.
-        if headers and "alg" in headers and headers["alg"]:
-            algorithm = headers["alg"]
+        # Prefer headers values if present to function parameters.
+        if headers:
+            headers_alg = headers.get("alg")
+            if headers_alg:
+                algorithm = headers["alg"]
+
+            headers_b64 = headers.get("b64")
+            if headers_b64 is False:
+                is_payload_detached = True
 
         # Header
-        header = {"typ": self.header_typ, "alg": algorithm}
+        header = {"typ": self.header_typ, "alg": algorithm}  # type: Dict[str, Any]
 
         if headers:
             self._validate_headers(headers)
             header.update(headers)
-            if not header["typ"]:
-                del header["typ"]
+
+        if not header["typ"]:
+            del header["typ"]
+
+        if is_payload_detached:
+            header["b64"] = False
+        elif "b64" in header:
+            # True is the standard value for b64, so no need for it
+            del header["b64"]
 
         json_header = json.dumps(
             header, separators=(",", ":"), cls=json_encoder
         ).encode()
 
         segments.append(base64url_encode(json_header))
-        segments.append(base64url_encode(payload))
+
+        if is_payload_detached:
+            msg_payload = payload
+        else:
+            msg_payload = base64url_encode(payload)
+        segments.append(msg_payload)
 
         # Segments
         signing_input = b".".join(segments)
+
         try:
             alg_obj = self._algorithms[algorithm]
             key = alg_obj.prepare_key(key)
@@ -116,14 +136,15 @@ class PyJWS:
         except KeyError as e:
             if not has_crypto and algorithm in requires_cryptography:
                 raise NotImplementedError(
-                    "Algorithm '%s' could not be found. Do you have cryptography "
-                    "installed?" % algorithm
+                    f"Algorithm '{algorithm}' could not be found. Do you have cryptography installed?"
                 ) from e
-            else:
-                raise NotImplementedError("Algorithm not supported") from e
+            raise NotImplementedError("Algorithm not supported") from e
 
         segments.append(base64url_encode(signature))
 
+        # Don't put the payload content inside the encoded token when detached
+        if is_payload_detached:
+            segments[1] = b""
         encoded_string = b".".join(segments)
 
         return encoded_string.decode("utf-8")
@@ -132,8 +153,9 @@ class PyJWS:
         self,
         jwt: str,
         key: str = "",
-        algorithms: List[str] = None,
-        options: Dict = None,
+        algorithms: Optional[List[str]] = None,
+        options: Optional[Dict] = None,
+        detached_payload: Optional[bytes] = None,
         **kwargs,
     ) -> Dict[str, Any]:
         if options is None:
@@ -148,6 +170,14 @@ class PyJWS:
 
         payload, signing_input, header, signature = self._load(jwt)
 
+        if header.get("b64", True) is False:
+            if detached_payload is None:
+                raise DecodeError(
+                    'It is required that you pass in a value for the "detached_payload" argument to decode a message having the b64 header set to false.'
+                )
+            payload = detached_payload
+            signing_input = b".".join([signing_input.rsplit(b".", 1)[0], payload])
+
         if verify_signature:
             self._verify_signature(signing_input, header, signature, key, algorithms)
 
@@ -161,8 +191,8 @@ class PyJWS:
         self,
         jwt: str,
         key: str = "",
-        algorithms: List[str] = None,
-        options: Dict = None,
+        algorithms: Optional[List[str]] = None,
+        options: Optional[Dict] = None,
         **kwargs,
     ) -> str:
         decoded = self.decode_complete(jwt, key, algorithms, options, **kwargs)
@@ -200,7 +230,7 @@ class PyJWS:
         try:
             header = json.loads(header_data)
         except ValueError as e:
-            raise DecodeError("Invalid header string: %s" % e) from e
+            raise DecodeError(f"Invalid header string: {e}") from e
 
         if not isinstance(header, Mapping):
             raise DecodeError("Invalid header string: must be a json object")
diff --git a/lib/jwt/api_jwt.py b/lib/jwt/api_jwt.py
index f3b55d36..7d2177bf 100644
--- a/lib/jwt/api_jwt.py
+++ b/lib/jwt/api_jwt.py
@@ -1,4 +1,5 @@
 import json
+import warnings
 from calendar import timegm
 from collections.abc import Iterable, Mapping
 from datetime import datetime, timedelta, timezone
@@ -66,14 +67,23 @@ class PyJWT:
         self,
         jwt: str,
         key: str = "",
-        algorithms: List[str] = None,
-        options: Dict = None,
+        algorithms: Optional[List[str]] = None,
+        options: Optional[Dict] = None,
         **kwargs,
     ) -> Dict[str, Any]:
-        if options is None:
-            options = {"verify_signature": True}
-        else:
-            options.setdefault("verify_signature", True)
+        options = dict(options or {})  # shallow-copy or initialize an empty dict
+        options.setdefault("verify_signature", True)
+
+        # If the user has set the legacy `verify` argument, and it doesn't match
+        # what the relevant `options` entry for the argument is, inform the user
+        # that they're likely making a mistake.
+        if "verify" in kwargs and kwargs["verify"] != options["verify_signature"]:
+            warnings.warn(
+                "The `verify` argument to `decode` does nothing in PyJWT 2.0 and newer. "
+                "The equivalent is setting `verify_signature` to False in the `options` dictionary. "
+                "This invocation has a mismatch between the kwarg and the option entry.",
+                category=DeprecationWarning,
+            )
 
         if not options["verify_signature"]:
             options.setdefault("verify_exp", False)
@@ -98,7 +108,7 @@ class PyJWT:
         try:
             payload = json.loads(decoded["payload"])
         except ValueError as e:
-            raise DecodeError("Invalid payload string: %s" % e)
+            raise DecodeError(f"Invalid payload string: {e}")
         if not isinstance(payload, dict):
             raise DecodeError("Invalid payload string: must be a json object")
 
@@ -112,8 +122,8 @@ class PyJWT:
         self,
         jwt: str,
         key: str = "",
-        algorithms: List[str] = None,
-        options: Dict = None,
+        algorithms: Optional[List[str]] = None,
+        options: Optional[Dict] = None,
         **kwargs,
     ) -> Dict[str, Any]:
         decoded = self.decode_complete(jwt, key, algorithms, options, **kwargs)
diff --git a/lib/jwt/exceptions.py b/lib/jwt/exceptions.py
index 308899aa..ee201add 100644
--- a/lib/jwt/exceptions.py
+++ b/lib/jwt/exceptions.py
@@ -51,7 +51,7 @@ class MissingRequiredClaimError(InvalidTokenError):
         self.claim = claim
 
     def __str__(self):
-        return 'Token is missing the "%s" claim' % self.claim
+        return f'Token is missing the "{self.claim}" claim'
 
 
 class PyJWKError(PyJWTError):
diff --git a/lib/jwt/help.py b/lib/jwt/help.py
index d8f23024..d5c3ebbf 100644
--- a/lib/jwt/help.py
+++ b/lib/jwt/help.py
@@ -28,10 +28,10 @@ def info():
     if implementation == "CPython":
         implementation_version = platform.python_version()
     elif implementation == "PyPy":
-        implementation_version = "{}.{}.{}".format(
-            sys.pypy_version_info.major,
-            sys.pypy_version_info.minor,
-            sys.pypy_version_info.micro,
+        implementation_version = (
+            f"{sys.pypy_version_info.major}."
+            f"{sys.pypy_version_info.minor}."
+            f"{sys.pypy_version_info.micro}"
         )
         if sys.pypy_version_info.releaselevel != "final":
             implementation_version = "".join(
diff --git a/lib/jwt/utils.py b/lib/jwt/utils.py
index 9dde10cf..8ab73b42 100644
--- a/lib/jwt/utils.py
+++ b/lib/jwt/utils.py
@@ -1,5 +1,6 @@
 import base64
 import binascii
+import re
 from typing import Any, Union
 
 try:
@@ -97,3 +98,63 @@ def raw_to_der_signature(raw_sig: bytes, curve: EllipticCurve) -> bytes:
     s = bytes_to_number(raw_sig[num_bytes:])
 
     return encode_dss_signature(r, s)
+
+
+# Based on https://github.com/hynek/pem/blob/7ad94db26b0bc21d10953f5dbad3acfdfacf57aa/src/pem/_core.py#L224-L252
+_PEMS = {
+    b"CERTIFICATE",
+    b"TRUSTED CERTIFICATE",
+    b"PRIVATE KEY",
+    b"PUBLIC KEY",
+    b"ENCRYPTED PRIVATE KEY",
+    b"OPENSSH PRIVATE KEY",
+    b"DSA PRIVATE KEY",
+    b"RSA PRIVATE KEY",
+    b"RSA PUBLIC KEY",
+    b"EC PRIVATE KEY",
+    b"DH PARAMETERS",
+    b"NEW CERTIFICATE REQUEST",
+    b"CERTIFICATE REQUEST",
+    b"SSH2 PUBLIC KEY",
+    b"SSH2 ENCRYPTED PRIVATE KEY",
+    b"X509 CRL",
+}
+
+_PEM_RE = re.compile(
+    b"----[- ]BEGIN ("
+    + b"|".join(_PEMS)
+    + b""")[- ]----\r?
+.+?\r?
+----[- ]END \\1[- ]----\r?\n?""",
+    re.DOTALL,
+)
+
+
+def is_pem_format(key: bytes) -> bool:
+    return bool(_PEM_RE.search(key))
+
+
+# Based on https://github.com/pyca/cryptography/blob/bcb70852d577b3f490f015378c75cba74986297b/src/cryptography/hazmat/primitives/serialization/ssh.py#L40-L46
+_CERT_SUFFIX = b"-cert-v01@openssh.com"
+_SSH_PUBKEY_RC = re.compile(br"\A(\S+)[ \t]+(\S+)")
+_SSH_KEY_FORMATS = [
+    b"ssh-ed25519",
+    b"ssh-rsa",
+    b"ssh-dss",
+    b"ecdsa-sha2-nistp256",
+    b"ecdsa-sha2-nistp384",
+    b"ecdsa-sha2-nistp521",
+]
+
+
+def is_ssh_key(key: bytes) -> bool:
+    if any(string_value in key for string_value in _SSH_KEY_FORMATS):
+        return True
+
+    ssh_pubkey_match = _SSH_PUBKEY_RC.match(key)
+    if ssh_pubkey_match:
+        key_type = ssh_pubkey_match.group(1)
+        if _CERT_SUFFIX == key_type[-len(_CERT_SUFFIX) :]:
+            return True
+
+    return False
diff --git a/requirements.txt b/requirements.txt
index 7550b14b..b215a9f9 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -30,7 +30,7 @@ paho-mqtt==1.6.1
 plexapi==4.9.2
 portend==3.1.0
 profilehooks==1.12.0
-PyJWT==2.3.0
+PyJWT==2.4.0
 pyparsing==3.0.9
 python-dateutil==2.8.2
 python-twitter==3.5

From f068bcca01973cc88d9bda2e2576bfff30c78454 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 16 May 2022 21:17:59 -0700
Subject: [PATCH 086/743] Bump actions/cache from 2 to 3.0.1 (#1701)

Bumps [actions/cache](https://github.com/actions/cache) from 2 to 3.0.1.
- [Release notes](https://github.com/actions/cache/releases)
- [Changelog](https://github.com/actions/cache/blob/main/RELEASES.md)
- [Commits](https://github.com/actions/cache/compare/v2...v3.0.1)

---
updated-dependencies:
- dependency-name: actions/cache
  dependency-type: direct:production
  update-type: version-update:semver-major
...

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

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

[skip ci]
---
 .github/workflows/publish-docker.yml     | 2 +-
 .github/workflows/publish-installers.yml | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/publish-docker.yml b/.github/workflows/publish-docker.yml
index fe34b3b8..b02a84f8 100644
--- a/.github/workflows/publish-docker.yml
+++ b/.github/workflows/publish-docker.yml
@@ -46,7 +46,7 @@ jobs:
           version: latest
 
       - name: Cache Docker Layers
-        uses: actions/cache@v2
+        uses: actions/cache@v3.0.1
         with:
           path: /tmp/.buildx-cache
           key: ${{ runner.os }}-buildx-${{ github.sha }}
diff --git a/.github/workflows/publish-installers.yml b/.github/workflows/publish-installers.yml
index abea65e2..780bc9a2 100644
--- a/.github/workflows/publish-installers.yml
+++ b/.github/workflows/publish-installers.yml
@@ -56,7 +56,7 @@ jobs:
           python-version: 3.9
 
       - name: Cache Dependencies
-        uses: actions/cache@v2
+        uses: actions/cache@v3.0.1
         with:
           path: ~\AppData\Local\pip\Cache
           key: ${{ runner.os }}-pip-${{ hashFiles('package/requirements-package.txt') }}

From 04b745b584fc18db8cce4e8ae7cdf17b10697702 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 16 May 2022 21:19:14 -0700
Subject: [PATCH 087/743] Bump actions/setup-python from 2 to 3.1.1 (#1709)

Bumps [actions/setup-python](https://github.com/actions/setup-python) from 2 to 3.1.1.
- [Release notes](https://github.com/actions/setup-python/releases)
- [Commits](https://github.com/actions/setup-python/compare/v2...v3.1.1)

---
updated-dependencies:
- dependency-name: actions/setup-python
  dependency-type: direct:production
  update-type: version-update:semver-major
...

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

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

[skip ci]
---
 .github/workflows/publish-installers.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/publish-installers.yml b/.github/workflows/publish-installers.yml
index 780bc9a2..d4496775 100644
--- a/.github/workflows/publish-installers.yml
+++ b/.github/workflows/publish-installers.yml
@@ -51,7 +51,7 @@ jobs:
           echo $GITHUB_SHA > version.txt
 
       - name: Set Up Python
-        uses: actions/setup-python@v2
+        uses: actions/setup-python@v3.1.1
         with:
           python-version: 3.9
 

From 988c6750aa907da8b73b1f0a7dced45a25d56f4d Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 16 May 2022 21:19:54 -0700
Subject: [PATCH 088/743] Bump actions/download-artifact from 2 to 3 (#1711)

Bumps [actions/download-artifact](https://github.com/actions/download-artifact) from 2 to 3.
- [Release notes](https://github.com/actions/download-artifact/releases)
- [Commits](https://github.com/actions/download-artifact/compare/v2...v3)

---
updated-dependencies:
- dependency-name: actions/download-artifact
  dependency-type: direct:production
  update-type: version-update:semver-major
...

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

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

[skip ci]
---
 .github/workflows/publish-installers.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/publish-installers.yml b/.github/workflows/publish-installers.yml
index d4496775..0b118d91 100644
--- a/.github/workflows/publish-installers.yml
+++ b/.github/workflows/publish-installers.yml
@@ -116,7 +116,7 @@ jobs:
 
       - name: Download Installers
         if: env.WORKFLOW_CONCLUSION == 'success'
-        uses: actions/download-artifact@v2
+        uses: actions/download-artifact@v3
 
       - name: Get Changelog
         id: get_changelog

From f6214c9a987d5501e8c4bf7f993cd356f5296d33 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 16 May 2022 21:20:05 -0700
Subject: [PATCH 089/743] Bump actions/upload-artifact from 2 to 3 (#1712)

Bumps [actions/upload-artifact](https://github.com/actions/upload-artifact) from 2 to 3.
- [Release notes](https://github.com/actions/upload-artifact/releases)
- [Commits](https://github.com/actions/upload-artifact/compare/v2...v3)

---
updated-dependencies:
- dependency-name: actions/upload-artifact
  dependency-type: direct:production
  update-type: version-update:semver-major
...

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

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

[skip ci]
---
 .github/workflows/publish-installers.yml | 2 +-
 .github/workflows/publish-snap.yml       | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/publish-installers.yml b/.github/workflows/publish-installers.yml
index 0b118d91..153d14c5 100644
--- a/.github/workflows/publish-installers.yml
+++ b/.github/workflows/publish-installers.yml
@@ -92,7 +92,7 @@ jobs:
             Tautulli-macos-${{ steps.get_version.outputs.RELEASE_VERSION }}-x64.pkg
 
       - name: Upload Installer
-        uses: actions/upload-artifact@v2
+        uses: actions/upload-artifact@v3
         with:
           name: Tautulli-${{ matrix.os }}-installer
           path: Tautulli-${{ matrix.os }}-${{ steps.get_version.outputs.RELEASE_VERSION }}-x64.${{ matrix.ext }}
diff --git a/.github/workflows/publish-snap.yml b/.github/workflows/publish-snap.yml
index a308946a..64dbf952 100644
--- a/.github/workflows/publish-snap.yml
+++ b/.github/workflows/publish-snap.yml
@@ -48,7 +48,7 @@ jobs:
           architecture: ${{ matrix.architecture }}
 
       - name: Upload Snap Package
-        uses: actions/upload-artifact@v2
+        uses: actions/upload-artifact@v3
         with:
           name: Tautulli-snap-package-${{ matrix.architecture }}
           path: ${{ steps.build.outputs.snap }}

From 89d9fcac66ac4f95b168a39b4b19cdb92d7be72d Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 16 May 2022 21:20:19 -0700
Subject: [PATCH 090/743] Bump actions/stale from 4 to 5 (#1714)

Bumps [actions/stale](https://github.com/actions/stale) from 4 to 5.
- [Release notes](https://github.com/actions/stale/releases)
- [Changelog](https://github.com/actions/stale/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/stale/compare/v4...v5)

---
updated-dependencies:
- dependency-name: actions/stale
  dependency-type: direct:production
  update-type: version-update:semver-major
...

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

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

[skip ci]
---
 .github/workflows/issues-stale.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/issues-stale.yml b/.github/workflows/issues-stale.yml
index 466c3f38..4605bcec 100644
--- a/.github/workflows/issues-stale.yml
+++ b/.github/workflows/issues-stale.yml
@@ -10,7 +10,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Stale
-        uses: actions/stale@v4
+        uses: actions/stale@v5
         with:
           stale-issue-message: >
             This issue is stale because it has been open for 30 days with no activity.
@@ -30,7 +30,7 @@ jobs:
           days-before-close: 5
 
       - name: Invalid Template
-        uses: actions/stale@v4
+        uses: actions/stale@v5
         with:
           stale-issue-message: >
             Invalid issues template.

From 86dd3f0db7e5b6d75acd2f4f28e42201fd94531c Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 16 May 2022 21:20:39 -0700
Subject: [PATCH 091/743] Bump actions/checkout from 2 to 3.0.2 (#1726)

Bumps [actions/checkout](https://github.com/actions/checkout) from 2 to 3.0.2.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v2...v3.0.2)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-type: direct:production
  update-type: version-update:semver-major
...

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

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

[skip ci]
---
 .github/workflows/publish-docker.yml     | 2 +-
 .github/workflows/publish-installers.yml | 4 ++--
 .github/workflows/publish-snap.yml       | 2 +-
 .github/workflows/pull-requests.yml      | 2 +-
 4 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/publish-docker.yml b/.github/workflows/publish-docker.yml
index b02a84f8..9f7b3080 100644
--- a/.github/workflows/publish-docker.yml
+++ b/.github/workflows/publish-docker.yml
@@ -12,7 +12,7 @@ jobs:
     if: ${{ !contains(github.event.head_commit.message, '[skip ci]') }}
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v2
+        uses: actions/checkout@v3.0.2
 
       - name: Prepare
         id: prepare
diff --git a/.github/workflows/publish-installers.yml b/.github/workflows/publish-installers.yml
index 153d14c5..7acad95d 100644
--- a/.github/workflows/publish-installers.yml
+++ b/.github/workflows/publish-installers.yml
@@ -23,7 +23,7 @@ jobs:
 
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v2
+        uses: actions/checkout@v3.0.2
 
       - name: Set Release Version
         id: get_version
@@ -107,7 +107,7 @@ jobs:
         uses: technote-space/workflow-conclusion-action@v2.2
 
       - name: Checkout Code
-        uses: actions/checkout@v2
+        uses: actions/checkout@v3.0.2
 
       - name: Set Release Version
         id: get_version
diff --git a/.github/workflows/publish-snap.yml b/.github/workflows/publish-snap.yml
index 64dbf952..b6ff6398 100644
--- a/.github/workflows/publish-snap.yml
+++ b/.github/workflows/publish-snap.yml
@@ -22,7 +22,7 @@ jobs:
           #- s390x  # broken at the moment
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v2
+        uses: actions/checkout@v3.0.2
 
       - name: Prepare
         id: prepare
diff --git a/.github/workflows/pull-requests.yml b/.github/workflows/pull-requests.yml
index 91b155bc..08f92507 100644
--- a/.github/workflows/pull-requests.yml
+++ b/.github/workflows/pull-requests.yml
@@ -10,7 +10,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v2
+        uses: actions/checkout@v3.0.2
 
       - name: Comment on Pull Request
         uses: mshick/add-pr-comment@v1

From 9df184d7f4b3972e30b258e5973ebbb420b0948e Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 16 May 2022 21:20:50 -0700
Subject: [PATCH 092/743] Bump docker/build-push-action from 2 to 3 (#1735)

Bumps [docker/build-push-action](https://github.com/docker/build-push-action) from 2 to 3.
- [Release notes](https://github.com/docker/build-push-action/releases)
- [Upgrade guide](https://github.com/docker/build-push-action/blob/master/UPGRADE.md)
- [Commits](https://github.com/docker/build-push-action/compare/v2...v3)

---
updated-dependencies:
- dependency-name: docker/build-push-action
  dependency-type: direct:production
  update-type: version-update:semver-major
...

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

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

[skip ci]
---
 .github/workflows/publish-docker.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/publish-docker.yml b/.github/workflows/publish-docker.yml
index 9f7b3080..6f7f6367 100644
--- a/.github/workflows/publish-docker.yml
+++ b/.github/workflows/publish-docker.yml
@@ -69,7 +69,7 @@ jobs:
           password: ${{ secrets.GHCR_TOKEN }}
 
       - name: Docker Build and Push
-        uses: docker/build-push-action@v2
+        uses: docker/build-push-action@v3
         if: success()
         with:
           context: .

From 54a878f7b1d4ed5fa449f7fa73a1a682d781ef2b Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 16 May 2022 21:21:01 -0700
Subject: [PATCH 093/743] Bump docker/setup-qemu-action from 1 to 2 (#1736)

Bumps [docker/setup-qemu-action](https://github.com/docker/setup-qemu-action) from 1 to 2.
- [Release notes](https://github.com/docker/setup-qemu-action/releases)
- [Commits](https://github.com/docker/setup-qemu-action/compare/v1...v2)

---
updated-dependencies:
- dependency-name: docker/setup-qemu-action
  dependency-type: direct:production
  update-type: version-update:semver-major
...

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

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

[skip ci]
---
 .github/workflows/publish-docker.yml | 2 +-
 .github/workflows/publish-snap.yml   | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/publish-docker.yml b/.github/workflows/publish-docker.yml
index 6f7f6367..bf4bf72a 100644
--- a/.github/workflows/publish-docker.yml
+++ b/.github/workflows/publish-docker.yml
@@ -37,7 +37,7 @@ jobs:
           echo ::set-output name=docker_image::${{ secrets.DOCKER_REPO }}/tautulli
 
       - name: Set Up QEMU
-        uses: docker/setup-qemu-action@v1
+        uses: docker/setup-qemu-action@v2
 
       - name: Set up Docker Buildx
         uses: docker/setup-buildx-action@v1
diff --git a/.github/workflows/publish-snap.yml b/.github/workflows/publish-snap.yml
index b6ff6398..1d365996 100644
--- a/.github/workflows/publish-snap.yml
+++ b/.github/workflows/publish-snap.yml
@@ -37,7 +37,7 @@ jobs:
           fi
 
       - name: Set Up QEMU
-        uses: docker/setup-qemu-action@v1
+        uses: docker/setup-qemu-action@v2
         with:
           image: tonistiigi/binfmt@sha256:df15403e06a03c2f461c1f7938b171fda34a5849eb63a70e2a2109ed5a778bde
 

From 228101fd48f060f74799536e6e4fb6d882fbf6bd Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 16 May 2022 21:21:09 -0700
Subject: [PATCH 094/743] Bump docker/setup-buildx-action from 1 to 2 (#1737)

Bumps [docker/setup-buildx-action](https://github.com/docker/setup-buildx-action) from 1 to 2.
- [Release notes](https://github.com/docker/setup-buildx-action/releases)
- [Commits](https://github.com/docker/setup-buildx-action/compare/v1...v2)

---
updated-dependencies:
- dependency-name: docker/setup-buildx-action
  dependency-type: direct:production
  update-type: version-update:semver-major
...

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

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

[skip ci]
---
 .github/workflows/publish-docker.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/publish-docker.yml b/.github/workflows/publish-docker.yml
index bf4bf72a..8e66263e 100644
--- a/.github/workflows/publish-docker.yml
+++ b/.github/workflows/publish-docker.yml
@@ -40,7 +40,7 @@ jobs:
         uses: docker/setup-qemu-action@v2
 
       - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@v1
+        uses: docker/setup-buildx-action@v2
         id: buildx
         with:
           version: latest

From 1af3c43320140664ea4aee5519d230d738872078 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 16 May 2022 21:21:18 -0700
Subject: [PATCH 095/743] Bump docker/login-action from 1 to 2 (#1738)

Bumps [docker/login-action](https://github.com/docker/login-action) from 1 to 2.
- [Release notes](https://github.com/docker/login-action/releases)
- [Commits](https://github.com/docker/login-action/compare/v1...v2)

---
updated-dependencies:
- dependency-name: docker/login-action
  dependency-type: direct:production
  update-type: version-update:semver-major
...

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

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

[skip ci]
---
 .github/workflows/publish-docker.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/publish-docker.yml b/.github/workflows/publish-docker.yml
index 8e66263e..a35a9139 100644
--- a/.github/workflows/publish-docker.yml
+++ b/.github/workflows/publish-docker.yml
@@ -54,14 +54,14 @@ jobs:
             ${{ runner.os }}-buildx-
 
       - name: Login to DockerHub
-        uses: docker/login-action@v1
+        uses: docker/login-action@v2
         if: success()
         with:
           username: ${{ secrets.DOCKER_USERNAME }}
           password: ${{ secrets.DOCKER_PASSWORD }}
 
       - name: Login to GitHub Container Registry
-        uses: docker/login-action@v1
+        uses: docker/login-action@v2
         if: success()
         with:
           registry: ghcr.io

From fbf22b5ea2555d457249ad1ab3f1a65291e5be25 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 16 May 2022 21:21:44 -0700
Subject: [PATCH 096/743] Bump pyobjc-framework-cocoa from 8.2 to 8.5 (#1724)

Bumps [pyobjc-framework-cocoa](https://github.com/ronaldoussoren/pyobjc) from 8.2 to 8.5.
- [Release notes](https://github.com/ronaldoussoren/pyobjc/releases)
- [Changelog](https://github.com/ronaldoussoren/pyobjc/blob/master/docs/changelog.rst)
- [Commits](https://github.com/ronaldoussoren/pyobjc/compare/v8.2...v8.5)

---
updated-dependencies:
- dependency-name: pyobjc-framework-cocoa
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

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

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

[skip ci]
---
 package/requirements-package.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index 910a9fb8..88894f61 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -4,7 +4,7 @@ pyinstaller==4.9
 pyopenssl==22.0.0
 pycryptodomex==3.14.1
 
-pyobjc-framework-Cocoa==8.2; platform_system == "Darwin"
+pyobjc-framework-Cocoa==8.5; platform_system == "Darwin"
 pyobjc-core==8.2; platform_system == "Darwin"
 
 pywin32==303; platform_system == "Windows"

From df58950585fca7516e9567bd801e9f4461faba67 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 16 May 2022 21:23:21 -0700
Subject: [PATCH 097/743] Bump pyobjc-core from 8.2 to 8.5 (#1725)

Bumps [pyobjc-core](https://github.com/ronaldoussoren/pyobjc) from 8.2 to 8.5.
- [Release notes](https://github.com/ronaldoussoren/pyobjc/releases)
- [Changelog](https://github.com/ronaldoussoren/pyobjc/blob/master/docs/changelog.rst)
- [Commits](https://github.com/ronaldoussoren/pyobjc/compare/v8.2...v8.5)

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

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

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

[skip ci]
---
 package/requirements-package.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index 88894f61..d80ca071 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -5,6 +5,6 @@ pyopenssl==22.0.0
 pycryptodomex==3.14.1
 
 pyobjc-framework-Cocoa==8.5; platform_system == "Darwin"
-pyobjc-core==8.2; platform_system == "Darwin"
+pyobjc-core==8.5; platform_system == "Darwin"
 
 pywin32==303; platform_system == "Windows"

From ba3275fed7dd3b82c14e0d3a4a248a18d9ffc9e7 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 16 May 2022 21:23:40 -0700
Subject: [PATCH 098/743] Bump pywin32 from 303 to 304 (#1732)

Bumps [pywin32](https://github.com/mhammond/pywin32) from 303 to 304.
- [Release notes](https://github.com/mhammond/pywin32/releases)
- [Changelog](https://github.com/mhammond/pywin32/blob/main/CHANGES.txt)
- [Commits](https://github.com/mhammond/pywin32/commits)

---
updated-dependencies:
- dependency-name: pywin32
  dependency-type: direct:production
  update-type: version-update:semver-major
...

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

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

[skip ci]
---
 package/requirements-package.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index d80ca071..a3325f0e 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -7,4 +7,4 @@ pycryptodomex==3.14.1
 pyobjc-framework-Cocoa==8.5; platform_system == "Darwin"
 pyobjc-core==8.5; platform_system == "Darwin"
 
-pywin32==303; platform_system == "Windows"
+pywin32==304; platform_system == "Windows"

From bff4a3f6baece0b59858c7b71bd6a345f1c0812e Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 16 May 2022 21:24:56 -0700
Subject: [PATCH 099/743] Bump pyinstaller from 4.9 to 5.0.1 (#1730)

Bumps [pyinstaller](https://github.com/pyinstaller/pyinstaller) from 4.9 to 5.0.1.
- [Release notes](https://github.com/pyinstaller/pyinstaller/releases)
- [Changelog](https://github.com/pyinstaller/pyinstaller/blob/develop/doc/CHANGES.rst)
- [Commits](https://github.com/pyinstaller/pyinstaller/compare/v4.9...v5.0.1)

---
updated-dependencies:
- dependency-name: pyinstaller
  dependency-type: direct:production
  update-type: version-update:semver-major
...

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

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

[skip ci]
---
 package/requirements-package.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index a3325f0e..8774d605 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -1,6 +1,6 @@
 apscheduler==3.9.1
 importlib-resources==5.7.1
-pyinstaller==4.9
+pyinstaller==5.0.1
 pyopenssl==22.0.0
 pycryptodomex==3.14.1
 

From 27b72663d4d4df960f1bdcc1417ecb5c24ecc281 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 16 May 2022 15:06:45 -0700
Subject: [PATCH 100/743] Fix platform in get_home_stats and
 get_user_player_stats API docs

---
 plexpy/webserve.py | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/plexpy/webserve.py b/plexpy/webserve.py
index 925bf49b..495f5286 100644
--- a/plexpy/webserve.py
+++ b/plexpy/webserve.py
@@ -1744,13 +1744,15 @@ class WebInterface(object):
 
             Returns:
                 json:
-                    [{"platform_type": "Chrome",
+                    [{"platform": "Chrome",
+                      "platform_name": "chrome",
                       "player_name": "Plex Web (Chrome)",
                       "result_id": 1,
                       "total_plays": 170,
                       "total_time": 349618
                       },
-                     {"platform_type": "Chromecast",
+                     {"platform": "Chromecast",
+                      "platform_name": "chromecast",
                       "player_name": "Chromecast",
                       "result_id": 2,
                       "total_plays": 42,
@@ -6195,7 +6197,6 @@ class WebInterface(object):
                           "live": 0,
                           "media_type": "episode",
                           "platform": "",
-                          "platform_type": "",
                           "rating_key": 1219,
                           "row_id": 1116,
                           "section_id": 2,

From 1e99d51fe2cea2881ed12ea5c3c9f263ea16cc05 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 16 May 2022 22:37:28 -0700
Subject: [PATCH 101/743] Add importlib-metadata to requirements-package.txt

---
 package/requirements-package.txt | 1 +
 1 file changed, 1 insertion(+)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index 8774d605..7b3d3217 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -1,4 +1,5 @@
 apscheduler==3.9.1
+importlib-metadata==4.11.3
 importlib-resources==5.7.1
 pyinstaller==5.0.1
 pyopenssl==22.0.0

From bdc907ee670260e2161e99adfa49987b75fee758 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 18 May 2022 10:44:47 -0700
Subject: [PATCH 102/743] Bump actions/setup-python from 3.1.1 to 3.1.2 (#1744)

Bumps [actions/setup-python](https://github.com/actions/setup-python) from 3.1.1 to 3.1.2.
- [Release notes](https://github.com/actions/setup-python/releases)
- [Commits](https://github.com/actions/setup-python/compare/v3.1.1...v3.1.2)

---
updated-dependencies:
- dependency-name: actions/setup-python
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

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

[skip ci]
---
 .github/workflows/publish-installers.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/publish-installers.yml b/.github/workflows/publish-installers.yml
index 7acad95d..a37fc2fc 100644
--- a/.github/workflows/publish-installers.yml
+++ b/.github/workflows/publish-installers.yml
@@ -51,7 +51,7 @@ jobs:
           echo $GITHUB_SHA > version.txt
 
       - name: Set Up Python
-        uses: actions/setup-python@v3.1.1
+        uses: actions/setup-python@v3.1.2
         with:
           python-version: 3.9
 

From abc01bb64dc4b802255e0df76775a30d8d8034d1 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 18 May 2022 10:45:00 -0700
Subject: [PATCH 103/743] Bump actions/cache from 3.0.1 to 3.0.2 (#1745)

Bumps [actions/cache](https://github.com/actions/cache) from 3.0.1 to 3.0.2.
- [Release notes](https://github.com/actions/cache/releases)
- [Changelog](https://github.com/actions/cache/blob/main/RELEASES.md)
- [Commits](https://github.com/actions/cache/compare/v3.0.1...v3.0.2)

---
updated-dependencies:
- dependency-name: actions/cache
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

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

[skip ci]
---
 .github/workflows/publish-docker.yml     | 2 +-
 .github/workflows/publish-installers.yml | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/publish-docker.yml b/.github/workflows/publish-docker.yml
index a35a9139..0ec7b71e 100644
--- a/.github/workflows/publish-docker.yml
+++ b/.github/workflows/publish-docker.yml
@@ -46,7 +46,7 @@ jobs:
           version: latest
 
       - name: Cache Docker Layers
-        uses: actions/cache@v3.0.1
+        uses: actions/cache@v3.0.2
         with:
           path: /tmp/.buildx-cache
           key: ${{ runner.os }}-buildx-${{ github.sha }}
diff --git a/.github/workflows/publish-installers.yml b/.github/workflows/publish-installers.yml
index a37fc2fc..a4d6aa09 100644
--- a/.github/workflows/publish-installers.yml
+++ b/.github/workflows/publish-installers.yml
@@ -56,7 +56,7 @@ jobs:
           python-version: 3.9
 
       - name: Cache Dependencies
-        uses: actions/cache@v3.0.1
+        uses: actions/cache@v3.0.2
         with:
           path: ~\AppData\Local\pip\Cache
           key: ${{ runner.os }}-pip-${{ hashFiles('package/requirements-package.txt') }}

From f1b95f58373e2b4a1eceda730414adb5cfd309c3 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 18 May 2022 10:54:11 -0700
Subject: [PATCH 104/743] Bump pyinstaller from 5.0.1 to 5.1 (#1746)

Bumps [pyinstaller](https://github.com/pyinstaller/pyinstaller) from 5.0.1 to 5.1.
- [Release notes](https://github.com/pyinstaller/pyinstaller/releases)
- [Changelog](https://github.com/pyinstaller/pyinstaller/blob/develop/doc/CHANGES.rst)
- [Commits](https://github.com/pyinstaller/pyinstaller/compare/v5.0.1...v5.1)

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

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

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 package/requirements-package.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index 7b3d3217..461765ac 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -1,7 +1,7 @@
 apscheduler==3.9.1
 importlib-metadata==4.11.3
 importlib-resources==5.7.1
-pyinstaller==5.0.1
+pyinstaller==5.1
 pyopenssl==22.0.0
 pycryptodomex==3.14.1
 

From 399fd6ff913c331bcc7cca8e21f832bf7335d1b7 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 18 May 2022 11:24:15 -0700
Subject: [PATCH 105/743] Bump plexapi from 4.9.2 to 4.11.0 (#1690)

* Bump plexapi from 4.9.2 to 4.10.1

Bumps [plexapi](https://github.com/pkkid/python-plexapi) from 4.9.2 to 4.10.1.
- [Release notes](https://github.com/pkkid/python-plexapi/releases)
- [Commits](https://github.com/pkkid/python-plexapi/compare/4.9.2...4.10.1)

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

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

* Update plexapi==4.11.0

* 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/charset_normalizer/md.py      |   2 +-
 lib/charset_normalizer/version.py |   2 +-
 lib/plexapi/__init__.py           |   4 +-
 lib/plexapi/audio.py              |  75 ++-
 lib/plexapi/base.py               | 141 +++--
 lib/plexapi/client.py             |  50 +-
 lib/plexapi/collection.py         |  62 +-
 lib/plexapi/config.py             |   1 +
 lib/plexapi/const.py              |   4 +-
 lib/plexapi/gdm.py                |   2 +-
 lib/plexapi/library.py            | 130 +++-
 lib/plexapi/media.py              |  88 ++-
 lib/plexapi/mixins.py             | 951 +++++++++++++++++++++---------
 lib/plexapi/myplex.py             | 214 +++++--
 lib/plexapi/photo.py              |  31 +-
 lib/plexapi/playlist.py           |  10 +-
 lib/plexapi/server.py             |  77 ++-
 lib/plexapi/settings.py           |   6 +-
 lib/plexapi/sonos.py              |   4 +-
 lib/plexapi/utils.py              |  59 +-
 lib/plexapi/video.py              |  95 ++-
 requirements.txt                  |   2 +-
 22 files changed, 1421 insertions(+), 589 deletions(-)

diff --git a/lib/charset_normalizer/md.py b/lib/charset_normalizer/md.py
index b55e95c4..f3d6505c 100644
--- a/lib/charset_normalizer/md.py
+++ b/lib/charset_normalizer/md.py
@@ -314,7 +314,7 @@ class SuperWeirdWordPlugin(MessDetectorPlugin):
             self._buffer = ""
             self._buffer_accent_count = 0
         elif (
-            character not in {"<", ">", "-", "="}
+            character not in {"<", ">", "-", "=", "~", "|", "_"}
             and character.isdigit() is False
             and is_symbol(character)
         ):
diff --git a/lib/charset_normalizer/version.py b/lib/charset_normalizer/version.py
index 69bf0503..77cfff25 100644
--- a/lib/charset_normalizer/version.py
+++ b/lib/charset_normalizer/version.py
@@ -2,5 +2,5 @@
 Expose version
 """
 
-__version__ = "2.0.11"
+__version__ = "2.0.12"
 VERSION = __version__.split(".")
diff --git a/lib/plexapi/__init__.py b/lib/plexapi/__init__.py
index 06a1ee63..2a7d39ef 100644
--- a/lib/plexapi/__init__.py
+++ b/lib/plexapi/__init__.py
@@ -21,9 +21,9 @@ TIMEOUT = CONFIG.get('plexapi.timeout', 30, int)
 X_PLEX_CONTAINER_SIZE = CONFIG.get('plexapi.container_size', 100, int)
 X_PLEX_ENABLE_FAST_CONNECT = CONFIG.get('plexapi.enable_fast_connect', False, bool)
 
-# Plex Header Configuation
+# Plex Header Configuration
 X_PLEX_PROVIDES = CONFIG.get('header.provides', 'controller')
-X_PLEX_PLATFORM = CONFIG.get('header.platform', CONFIG.get('header.platorm', uname()[0]))
+X_PLEX_PLATFORM = CONFIG.get('header.platform', CONFIG.get('header.platform', uname()[0]))
 X_PLEX_PLATFORM_VERSION = CONFIG.get('header.platform_version', uname()[2])
 X_PLEX_PRODUCT = CONFIG.get('header.product', PROJECT)
 X_PLEX_VERSION = CONFIG.get('header.version', VERSION)
diff --git a/lib/plexapi/audio.py b/lib/plexapi/audio.py
index bef951d8..621183b3 100644
--- a/lib/plexapi/audio.py
+++ b/lib/plexapi/audio.py
@@ -2,12 +2,16 @@
 import os
 from urllib.parse import quote_plus
 
-from plexapi import library, media, utils
+from plexapi import media, utils
 from plexapi.base import Playable, PlexPartialObject
 from plexapi.exceptions import BadRequest
-from plexapi.mixins import AdvancedSettingsMixin, ArtUrlMixin, ArtMixin, PosterUrlMixin, PosterMixin
-from plexapi.mixins import RatingMixin, SplitMergeMixin, UnmatchMatchMixin
-from plexapi.mixins import CollectionMixin, CountryMixin, GenreMixin, LabelMixin, MoodMixin, SimilarArtistMixin, StyleMixin
+from plexapi.mixins import (
+    AdvancedSettingsMixin, SplitMergeMixin, UnmatchMatchMixin, ExtrasMixin, HubsMixin, RatingMixin,
+    ArtUrlMixin, ArtMixin, PosterUrlMixin, PosterMixin, ThemeMixin, ThemeUrlMixin,
+    OriginallyAvailableMixin, SortTitleMixin, StudioMixin, SummaryMixin, TitleMixin,
+    TrackArtistMixin, TrackDiscNumberMixin, TrackNumberMixin,
+    CollectionMixin, CountryMixin, GenreMixin, LabelMixin, MoodMixin, SimilarArtistMixin, StyleMixin
+)
 from plexapi.playlist import Playlist
 
 
@@ -38,7 +42,7 @@ class Audio(PlexPartialObject):
             title (str): Name of the artist, album, or track (Jason Mraz, We Sing, Lucky, etc.).
             titleSort (str): Title to use when sorting (defaults to title).
             type (str): 'artist', 'album', or 'track'.
-            updatedAt (datatime): Datetime the item was updated.
+            updatedAt (datetime): Datetime the item was updated.
             userRating (float): Rating of the item (0.0 - 10.0) equaling (0 stars - 5 stars).
             viewCount (int): Count of times the item was played.
     """
@@ -125,8 +129,13 @@ class Audio(PlexPartialObject):
 
 
 @utils.registerPlexObject
-class Artist(Audio, AdvancedSettingsMixin, ArtMixin, PosterMixin, RatingMixin, SplitMergeMixin, UnmatchMatchMixin,
-        CollectionMixin, CountryMixin, GenreMixin, MoodMixin, SimilarArtistMixin, StyleMixin):
+class Artist(
+    Audio,
+    AdvancedSettingsMixin, SplitMergeMixin, UnmatchMatchMixin, ExtrasMixin, HubsMixin, RatingMixin,
+    ArtMixin, PosterMixin, ThemeMixin,
+    SortTitleMixin, SummaryMixin, TitleMixin,
+    CollectionMixin, CountryMixin, GenreMixin, LabelMixin, MoodMixin, SimilarArtistMixin, StyleMixin
+):
     """ Represents a single Artist.
 
         Attributes:
@@ -138,9 +147,11 @@ class Artist(Audio, AdvancedSettingsMixin, ArtMixin, PosterMixin, RatingMixin, S
             countries (List<:class:`~plexapi.media.Country`>): List country objects.
             genres (List<:class:`~plexapi.media.Genre`>): List of genre objects.
             key (str): API URL (/library/metadata/<ratingkey>).
+            labels (List<:class:`~plexapi.media.Label`>): List of label objects.
             locations (List<str>): List of folder paths where the artist is found on disk.
             similar (List<:class:`~plexapi.media.Similar`>): List of similar objects.
             styles (List<:class:`~plexapi.media.Style`>): List of style objects.
+            theme (str): URL to theme resource (/library/metadata/<ratingkey>/theme/<themeid>).
     """
     TAG = 'Directory'
     TYPE = 'artist'
@@ -153,26 +164,23 @@ class Artist(Audio, AdvancedSettingsMixin, ArtMixin, PosterMixin, RatingMixin, S
         self.countries = self.findItems(data, media.Country)
         self.genres = self.findItems(data, media.Genre)
         self.key = self.key.replace('/children', '')  # FIX_BUG_50
+        self.labels = self.findItems(data, media.Label)
         self.locations = self.listAttrs(data, 'path', etag='Location')
         self.similar = self.findItems(data, media.Similar)
         self.styles = self.findItems(data, media.Style)
+        self.theme = data.attrib.get('theme')
 
     def __iter__(self):
         for album in self.albums():
             yield album
 
-    def hubs(self):
-        """ Returns a list of :class:`~plexapi.library.Hub` objects. """
-        data = self._server.query(self._details_key)
-        return self.findItems(data, library.Hub, rtag='Related')
-
     def album(self, title):
         """ Returns the :class:`~plexapi.audio.Album` that matches the specified title.
 
             Parameters:
                 title (str): Title of the album to return.
         """
-        key = '/library/metadata/%s/children' % self.ratingKey
+        key = f"/library/sections/{self.librarySectionID}/all?artist.id={self.ratingKey}&type=9"
         return self.fetchItem(key, Album, title__iexact=title)
 
     def albums(self, **kwargs):
@@ -230,8 +238,13 @@ class Artist(Audio, AdvancedSettingsMixin, ArtMixin, PosterMixin, RatingMixin, S
 
 
 @utils.registerPlexObject
-class Album(Audio, ArtMixin, PosterMixin, RatingMixin, UnmatchMatchMixin,
-        CollectionMixin, GenreMixin, LabelMixin, MoodMixin, StyleMixin):
+class Album(
+    Audio,
+    UnmatchMatchMixin, RatingMixin,
+    ArtMixin, PosterMixin, ThemeUrlMixin,
+    OriginallyAvailableMixin, SortTitleMixin, StudioMixin, SummaryMixin, TitleMixin,
+    CollectionMixin, GenreMixin, LabelMixin, MoodMixin, StyleMixin
+):
     """ Represents a single Album.
 
         Attributes:
@@ -248,6 +261,7 @@ class Album(Audio, ArtMixin, PosterMixin, RatingMixin, UnmatchMatchMixin,
             parentGuid (str): Plex GUID for the album artist (plex://artist/5d07bcb0403c64029053ac4c).
             parentKey (str): API URL of the album artist (/library/metadata/<parentRatingKey>).
             parentRatingKey (int): Unique key identifying the album artist.
+            parentTheme (str): URL to artist theme resource (/library/metadata/<parentRatingkey>/theme/<themeid>).
             parentThumb (str): URL to album artist thumbnail image (/library/metadata/<parentRatingKey>/thumb/<thumbid>).
             parentTitle (str): Name of the album artist.
             rating (float): Album rating (7.9; 9.8; 8.1).
@@ -274,6 +288,7 @@ class Album(Audio, ArtMixin, PosterMixin, RatingMixin, UnmatchMatchMixin,
         self.parentGuid = data.attrib.get('parentGuid')
         self.parentKey = data.attrib.get('parentKey')
         self.parentRatingKey = utils.cast(int, data.attrib.get('parentRatingKey'))
+        self.parentTheme = data.attrib.get('parentTheme')
         self.parentThumb = data.attrib.get('parentThumb')
         self.parentTitle = data.attrib.get('parentTitle')
         self.rating = utils.cast(float, data.attrib.get('rating'))
@@ -298,10 +313,14 @@ class Album(Audio, ArtMixin, PosterMixin, RatingMixin, UnmatchMatchMixin,
                 :exc:`~plexapi.exceptions.BadRequest`: If title or track parameter is missing.
         """
         key = '/library/metadata/%s/children' % self.ratingKey
-        if title is not None:
+        if title is not None and not isinstance(title, int):
             return self.fetchItem(key, Track, title__iexact=title)
-        elif track is not None:
-            return self.fetchItem(key, Track, parentTitle__iexact=self.title, index=track)
+        elif track is not None or isinstance(title, int):
+            if isinstance(title, int):
+                index = title
+            else:
+                index = track
+            return self.fetchItem(key, Track, parentTitle__iexact=self.title, index=index)
         raise BadRequest('Missing argument: title or track is required')
 
     def tracks(self, **kwargs):
@@ -337,8 +356,13 @@ class Album(Audio, ArtMixin, PosterMixin, RatingMixin, UnmatchMatchMixin,
 
 
 @utils.registerPlexObject
-class Track(Audio, Playable, ArtUrlMixin, PosterUrlMixin, RatingMixin,
-        CollectionMixin, MoodMixin):
+class Track(
+    Audio, Playable,
+    ExtrasMixin, RatingMixin,
+    ArtUrlMixin, PosterUrlMixin, ThemeUrlMixin,
+    TitleMixin, TrackArtistMixin, TrackNumberMixin, TrackDiscNumberMixin,
+    CollectionMixin, LabelMixin, MoodMixin
+):
     """ Represents a single Track.
 
         Attributes:
@@ -351,19 +375,23 @@ class Track(Audio, Playable, ArtUrlMixin, PosterUrlMixin, RatingMixin,
             grandparentGuid (str): Plex GUID for the album artist (plex://artist/5d07bcb0403c64029053ac4c).
             grandparentKey (str): API URL of the album artist (/library/metadata/<grandparentRatingKey>).
             grandparentRatingKey (int): Unique key identifying the album artist.
+            grandparentTheme (str): URL to artist theme resource  (/library/metadata/<grandparentRatingkey>/theme/<themeid>).
+                (/library/metadata/<grandparentRatingkey>/theme/<themeid>).
             grandparentThumb (str): URL to album artist thumbnail image
                 (/library/metadata/<grandparentRatingKey>/thumb/<thumbid>).
             grandparentTitle (str): Name of the album artist for the track.
+            labels (List<:class:`~plexapi.media.Label`>): List of label objects.
             media (List<:class:`~plexapi.media.Media`>): List of media objects.
             originalTitle (str): The artist for the track.
             parentGuid (str): Plex GUID for the album (plex://album/5d07cd8e403c640290f180f9).
-            parentIndex (int): Album index.
+            parentIndex (int): Disc number of the track.
             parentKey (str): API URL of the album (/library/metadata/<parentRatingKey>).
             parentRatingKey (int): Unique key identifying the album.
             parentThumb (str): URL to album thumbnail image (/library/metadata/<parentRatingKey>/thumb/<thumbid>).
             parentTitle (str): Name of the album for the track.
             primaryExtraKey (str) API URL for the primary extra for the track.
             ratingCount (int): Number of ratings contributing to the rating score.
+            skipCount (int): Number of times the track has been skipped.
             viewOffset (int): View offset in milliseconds.
             year (int): Year the track was released.
     """
@@ -381,18 +409,21 @@ class Track(Audio, Playable, ArtUrlMixin, PosterUrlMixin, RatingMixin,
         self.grandparentGuid = data.attrib.get('grandparentGuid')
         self.grandparentKey = data.attrib.get('grandparentKey')
         self.grandparentRatingKey = utils.cast(int, data.attrib.get('grandparentRatingKey'))
+        self.grandparentTheme = data.attrib.get('grandparentTheme')
         self.grandparentThumb = data.attrib.get('grandparentThumb')
         self.grandparentTitle = data.attrib.get('grandparentTitle')
+        self.labels = self.findItems(data, media.Label)
         self.media = self.findItems(data, media.Media)
         self.originalTitle = data.attrib.get('originalTitle')
         self.parentGuid = data.attrib.get('parentGuid')
-        self.parentIndex = data.attrib.get('parentIndex')
+        self.parentIndex = utils.cast(int, data.attrib.get('parentIndex'))
         self.parentKey = data.attrib.get('parentKey')
         self.parentRatingKey = utils.cast(int, data.attrib.get('parentRatingKey'))
         self.parentThumb = data.attrib.get('parentThumb')
         self.parentTitle = data.attrib.get('parentTitle')
         self.primaryExtraKey = data.attrib.get('primaryExtraKey')
         self.ratingCount = utils.cast(int, data.attrib.get('ratingCount'))
+        self.skipCount = utils.cast(int, data.attrib.get('skipCount'))
         self.viewOffset = utils.cast(int, data.attrib.get('viewOffset', 0))
         self.year = utils.cast(int, data.attrib.get('year'))
 
diff --git a/lib/plexapi/base.py b/lib/plexapi/base.py
index 94bfe2ad..fb1066aa 100644
--- a/lib/plexapi/base.py
+++ b/lib/plexapi/base.py
@@ -53,7 +53,9 @@ class PlexObject(object):
         if data is not None:
             self._loadData(data)
         self._details_key = self._buildDetailsKey()
-        self._autoReload = False
+        self._overwriteNone = True
+        self._edits = None  # Save batch edits for a single API call
+        self._autoReload = True  # Automatically reload the object when accessing a missing attribute
 
     def __repr__(self):
         uid = self._clean(self.firstAttr('_baseurl', 'key', 'id', 'playQueueID', 'uri'))
@@ -65,9 +67,9 @@ class PlexObject(object):
         if attr in _DONT_OVERWRITE_SESSION_KEYS and value == []:
             value = getattr(self, attr, [])
 
-        autoReload = self.__dict__.get('_autoReload')
-        # Don't overwrite an attr with None unless it's a private variable or not auto reload
-        if value is not None or attr.startswith('_') or attr not in self.__dict__ or not autoReload:
+        overwriteNone = self.__dict__.get('_overwriteNone')
+        # Don't overwrite an attr with None unless it's a private variable or overwrite None is True
+        if value is not None or attr.startswith('_') or attr not in self.__dict__ or overwriteNone:
             self.__dict__[attr] = value
 
     def _clean(self, value):
@@ -169,9 +171,14 @@ class PlexObject(object):
             raise BadRequest('ekey was not provided')
         if isinstance(ekey, int):
             ekey = '/library/metadata/%s' % ekey
-        for elem in self._server.query(ekey):
+        data = self._server.query(ekey)
+        librarySectionID = utils.cast(int, data.attrib.get('librarySectionID'))
+        for elem in data:
             if self._checkAttrs(elem, **kwargs):
-                return self._buildItem(elem, cls, ekey)
+                item = self._buildItem(elem, cls, ekey)
+                if librarySectionID:
+                    item.librarySectionID = librarySectionID
+                return item
         clsname = cls.__name__ if cls else 'None'
         raise NotFound('Unable to find elem: cls=%s, attrs=%s' % (clsname, kwargs))
 
@@ -196,7 +203,7 @@ class PlexObject(object):
             Any XML attribute can be filtered when fetching results. Filtering is done before
             the Python objects are built to help keep things speedy. For example, passing in
             ``viewCount=0`` will only return matching items where the view count is ``0``.
-            Note that case matters when specifying attributes. Attributes futher down in the XML
+            Note that case matters when specifying attributes. Attributes further down in the XML
             tree can be filtered by *prepending* the attribute with each element tag ``Tag__``.
 
             Examples:
@@ -228,12 +235,12 @@ class PlexObject(object):
             * ``__exists`` (*bool*): Value is or is not present in the attrs.
             * ``__gt``: Value is greater than specified arg.
             * ``__gte``: Value is greater than or equal to specified arg.
-            * ``__icontains``: Case insensative value contains specified arg.
-            * ``__iendswith``: Case insensative value ends with specified arg.
-            * ``__iexact``: Case insensative value matches specified arg.
+            * ``__icontains``: Case insensitive value contains specified arg.
+            * ``__iendswith``: Case insensitive value ends with specified arg.
+            * ``__iexact``: Case insensitive value matches specified arg.
             * ``__in``: Value is in a specified list or tuple.
-            * ``__iregex``: Case insensative value matches the specified regular expression.
-            * ``__istartswith``: Case insensative value starts with specified arg.
+            * ``__iregex``: Case insensitive value matches the specified regular expression.
+            * ``__istartswith``: Case insensitive value starts with specified arg.
             * ``__lt``: Value is less than specified arg.
             * ``__lte``: Value is less than or equal to specified arg.
             * ``__regex``: Value matches the specified regular expression.
@@ -276,9 +283,9 @@ class PlexObject(object):
             kwargs['etag'] = cls.TAG
         if cls and cls.TYPE and 'type' not in kwargs:
             kwargs['type'] = cls.TYPE
-        # rtag to iter on a specific root tag
+        # rtag to iter on a specific root tag using breadth-first search
         if rtag:
-            data = next(data.iter(rtag), [])
+            data = next(utils.iterXMLBFS(data, rtag), [])
         # loop through all data elements to find matches
         items = []
         for elem in data:
@@ -298,9 +305,9 @@ class PlexObject(object):
     def listAttrs(self, data, attr, rtag=None, **kwargs):
         """ Return a list of values from matching attribute. """
         results = []
-        # rtag to iter on a specific root tag
+        # rtag to iter on a specific root tag using breadth-first search
         if rtag:
-            data = next(data.iter(rtag), [])
+            data = next(utils.iterXMLBFS(data, rtag), [])
         for elem in data:
             kwargs['%s__exists' % attr] = True
             if self._checkAttrs(elem, **kwargs):
@@ -340,7 +347,7 @@ class PlexObject(object):
         """
         return self._reload(key=key, **kwargs)
 
-    def _reload(self, key=None, _autoReload=False, **kwargs):
+    def _reload(self, key=None, _overwriteNone=True, **kwargs):
         """ Perform the actual reload. """
         details_key = self._buildDetailsKey(**kwargs) if kwargs else self._details_key
         key = key or details_key or self.key
@@ -348,9 +355,9 @@ class PlexObject(object):
             raise Unsupported('Cannot reload an object not built from a URL.')
         self._initpath = key
         data = self._server.query(key)
-        self._autoReload = _autoReload
+        self._overwriteNone = _overwriteNone
         self._loadData(data[0])
-        self._autoReload = False
+        self._overwriteNone = True
         return self
 
     def _checkAttrs(self, elem, **kwargs):
@@ -392,7 +399,7 @@ class PlexObject(object):
         # check were looking for the tag
         if attr.lower() == 'etag':
             return [elem.tag]
-        # loop through attrs so we can perform case-insensative match
+        # loop through attrs so we can perform case-insensitive match
         for _attr, value in elem.attrib.items():
             if attr.lower() == _attr.lower():
                 return [value]
@@ -414,6 +421,10 @@ class PlexObject(object):
     def _loadData(self, data):
         raise NotImplementedError('Abstract method not implemented.')
 
+    @property
+    def _searchType(self):
+        return self.TYPE
+
 
 class PlexPartialObject(PlexObject):
     """ Not all objects in the Plex listings return the complete list of elements
@@ -455,20 +466,21 @@ class PlexPartialObject(PlexObject):
     def __getattribute__(self, attr):
         # Dragons inside.. :-/
         value = super(PlexPartialObject, self).__getattribute__(attr)
-        # Check a few cases where we dont want to reload
+        # Check a few cases where we don't want to reload
         if attr in _DONT_RELOAD_FOR_KEYS: return value
         if attr in _DONT_OVERWRITE_SESSION_KEYS: return value
         if attr in USER_DONT_RELOAD_FOR_KEYS: return value
         if attr.startswith('_'): return value
         if value not in (None, []): return value
         if self.isFullObject(): return value
+        if self._autoReload is False: return value
         # Log the reload.
         clsname = self.__class__.__name__
         title = self.__dict__.get('title', self.__dict__.get('name'))
         objname = "%s '%s'" % (clsname, title) if title else clsname
         log.debug("Reloading %s for attr '%s'", objname, attr)
         # Reload and return the value
-        self._reload(_autoReload=True)
+        self._reload()
         return super(PlexPartialObject, self).__getattribute__(attr)
 
     def analyze(self):
@@ -507,44 +519,79 @@ class PlexPartialObject(PlexObject):
 
     def _edit(self, **kwargs):
         """ Actually edit an object. """
+        if isinstance(self._edits, dict):
+            self._edits.update(kwargs)
+            return self
+
         if 'id' not in kwargs:
             kwargs['id'] = self.ratingKey
         if 'type' not in kwargs:
-            kwargs['type'] = utils.searchType(self.type)
+            kwargs['type'] = utils.searchType(self._searchType)
 
-        part = '/library/sections/%s/all?%s' % (self.librarySectionID,
-                                                urlencode(kwargs))
+        part = '/library/sections/%s/all%s' % (self.librarySectionID,
+                                               utils.joinArgs(kwargs))
         self._server.query(part, method=self._server._session.put)
+        return self
 
     def edit(self, **kwargs):
         """ Edit an object.
+            Note: This is a low level method and you need to know all the field/tag keys.
+            See :class:`~plexapi.mixins.EditFieldMixin` and :class:`~plexapi.mixins.EditTagsMixin`
+            for individual field and tag editing methods.
 
             Parameters:
                 kwargs (dict): Dict of settings to edit.
 
             Example:
-                {'type': 1,
-                 'id': movie.ratingKey,
-                 'collection[0].tag.tag': 'Super',
-                 'collection.locked': 0}
-        """
-        self._edit(**kwargs)
 
-    def _edit_tags(self, tag, items, locked=True, remove=False):
-        """ Helper to edit tags.
+                .. code-block:: python
+
+                    edits = {
+                        'type': 1,
+                        'id': movie.ratingKey,
+                        'title.value': 'A new title',
+                        'title.locked': 1,
+                        'summary.value': 'This is a summary.',
+                        'summary.locked': 1,
+                        'collection[0].tag.tag': 'A tag',
+                        'collection.locked': 1}
+                    }
+                    movie.edit(**edits)
 
-            Parameters:
-                tag (str): Tag name.
-                items (list): List of tags to add.
-                locked (bool): True to lock the field.
-                remove (bool): True to remove the tags in items.
         """
-        if not isinstance(items, list):
-            items = [items]
-        value = getattr(self, utils.tag_plural(tag))
-        existing_tags = [t.tag for t in value if t and remove is False]
-        tag_edits = utils.tag_helper(tag, existing_tags + items, locked, remove)
-        self.edit(**tag_edits)
+        return self._edit(**kwargs)
+
+    def batchEdits(self):
+        """ Enable batch editing mode to save API calls.
+            Must call :func:`~plexapi.base.PlexPartialObject.saveEdits` at the end to save all the edits.
+            See :class:`~plexapi.mixins.EditFieldMixin` and :class:`~plexapi.mixins.EditTagsMixin`
+            for individual field and tag editing methods.
+
+            Example:
+
+                .. code-block:: python
+
+                    # Batch editing multiple fields and tags in a single API call
+                    Movie.batchEdits()
+                    Movie.editTitle('A New Title').editSummary('A new summary').editTagline('A new tagline') \\
+                        .addCollection('New Collection').removeGenre('Action').addLabel('Favorite')
+                    Movie.saveEdits()
+
+        """
+        self._edits = {}
+        return self
+
+    def saveEdits(self):
+        """ Save all the batch edits and automatically reload the object.
+            See :func:`~plexapi.base.PlexPartialObject.batchEdits` for details.
+        """
+        if not isinstance(self._edits, dict):
+            raise BadRequest('Batch editing mode not enabled. Must call `batchEdits()` first.')
+
+        edits = self._edits
+        self._edits = None
+        self._edit(**edits)
+        return self.reload()
 
     def refresh(self):
         """ Refreshing a Library or individual item causes the metadata for the item to be
@@ -709,7 +756,7 @@ class Playable(object):
                 filename = part.file
 
             if kwargs:
-                # So this seems to be a alot slower but allows transcode.
+                # So this seems to be a a lot slower but allows transcode.
                 download_url = self.getStreamURL(**kwargs)
             else:
                 download_url = self._server.url('%s?download=1' % part.key)
@@ -746,7 +793,7 @@ class Playable(object):
         key = '/:/progress?key=%s&identifier=com.plexapp.plugins.library&time=%d&state=%s' % (self.ratingKey,
                                                                                               time, state)
         self._server.query(key)
-        self._reload(_autoReload=True)
+        self._reload(_overwriteNone=False)
 
     def updateTimeline(self, time, state='stopped', duration=None):
         """ Set the timeline progress for this video.
@@ -764,7 +811,7 @@ class Playable(object):
         key = '/:/timeline?ratingKey=%s&key=%s&identifier=com.plexapp.plugins.library&time=%d&state=%s%s'
         key %= (self.ratingKey, self.key, time, state, durationStr)
         self._server.query(key)
-        self._reload(_autoReload=True)
+        self._reload(_overwriteNone=False)
 
 
 class MediaContainer(PlexObject):
diff --git a/lib/plexapi/client.py b/lib/plexapi/client.py
index 56f522d2..cc976a58 100644
--- a/lib/plexapi/client.py
+++ b/lib/plexapi/client.py
@@ -23,10 +23,10 @@ class PlexClient(PlexObject):
             server (:class:`~plexapi.server.PlexServer`): PlexServer this client is connected to (optional).
             data (ElementTree): Response from PlexServer used to build this object (optional).
             initpath (str): Path used to generate data.
-            baseurl (str): HTTP URL to connect dirrectly to this client.
+            baseurl (str): HTTP URL to connect directly to this client.
             identifier (str): The resource/machine identifier for the desired client.
                 May be necessary when connecting to a specific proxied client (optional).
-            token (str): X-Plex-Token used for authenication (optional).
+            token (str): X-Plex-Token used for authentication (optional).
             session (:class:`~requests.Session`): requests.Session object if you want more control (optional).
             timeout (int): timeout in seconds on initial connect to client (default config.TIMEOUT).
 
@@ -48,7 +48,7 @@ class PlexClient(PlexObject):
             session (:class:`~requests.Session`): Session object used for connection.
             state (str): Unknown
             title (str): Name of this client (Johns iPhone, etc).
-            token (str): X-Plex-Token used for authenication
+            token (str): X-Plex-Token used for authentication
             vendor (str): Unknown
             version (str): Device version (4.6.1, etc).
             _baseurl (str): HTTP address of the client.
@@ -131,7 +131,7 @@ class PlexClient(PlexObject):
         self.platformVersion = data.attrib.get('platformVersion')
         self.title = data.attrib.get('title') or data.attrib.get('name')
         # Active session details
-        # Since protocolCapabilities is missing from /sessions we cant really control this player without
+        # Since protocolCapabilities is missing from /sessions we can't really control this player without
         # creating a client manually.
         # Add this in next breaking release.
         # if self._initpath == 'status/sessions':
@@ -210,8 +210,8 @@ class PlexClient(PlexObject):
         controller = command.split('/')[0]
         headers = {'X-Plex-Target-Client-Identifier': self.machineIdentifier}
         if controller not in self.protocolCapabilities:
-            log.debug('Client %s doesnt support %s controller.'
-                      'What your trying might not work' % (self.title, controller))
+            log.debug("Client %s doesn't support %s controller."
+                      "What your trying might not work" % (self.title, controller))
 
         proxy = self._proxyThroughServer if proxy is None else proxy
         query = self._server.query if proxy else self.query
@@ -318,21 +318,21 @@ class PlexClient(PlexObject):
             Parameters:
                 media (:class:`~plexapi.media.Media`): Media object to navigate to.
                 **params (dict): Additional GET parameters to include with the command.
-
-            Raises:
-                :exc:`~plexapi.exceptions.Unsupported`: When no PlexServer specified in this object.
         """
-        if not self._server:
-            raise Unsupported('A server must be specified before using this command.')
         server_url = media._server._baseurl.split(':')
-        self.sendCommand('mirror/details', **dict({
-            'machineIdentifier': self._server.machineIdentifier,
+        command = {
+            'machineIdentifier': media._server.machineIdentifier,
             'address': server_url[1].strip('/'),
             'port': server_url[-1],
             'key': media.key,
             'protocol': server_url[0],
-            'token': media._server.createToken()
-        }, **params))
+            **params,
+        }
+        token = media._server.createToken()
+        if token:
+            command["token"] = token
+
+        self.sendCommand("mirror/details", **command)
 
     # -------------------
     # Playback Commands
@@ -488,12 +488,7 @@ class PlexClient(PlexObject):
                     representing the beginning (default 0).
                 **params (dict): Optional additional parameters to include in the playback request. See
                     also: https://github.com/plexinc/plex-media-player/wiki/Remote-control-API#modified-commands
-
-            Raises:
-                :exc:`~plexapi.exceptions.Unsupported`: When no PlexServer specified in this object.
         """
-        if not self._server:
-            raise Unsupported('A server must be specified before using this command.')
         server_url = media._server._baseurl.split(':')
         server_port = server_url[-1].strip('/')
 
@@ -509,19 +504,24 @@ class PlexClient(PlexObject):
         if mediatype == "audio":
             mediatype = "music"
 
-        playqueue = media if isinstance(media, PlayQueue) else self._server.createPlayQueue(media)
-        self.sendCommand('playback/playMedia', **dict({
+        playqueue = media if isinstance(media, PlayQueue) else media._server.createPlayQueue(media)
+        command = {
             'providerIdentifier': 'com.plexapp.plugins.library',
-            'machineIdentifier': self._server.machineIdentifier,
+            'machineIdentifier': media._server.machineIdentifier,
             'protocol': server_url[0],
             'address': server_url[1].strip('/'),
             'port': server_port,
             'offset': offset,
             'key': media.key or playqueue.selectedItem.key,
-            'token': media._server.createToken(),
             'type': mediatype,
             'containerKey': '/playQueues/%s?window=100&own=1' % playqueue.playQueueID,
-        }, **params))
+            **params,
+        }
+        token = media._server.createToken()
+        if token:
+            command["token"] = token
+
+        self.sendCommand("playback/playMedia", **command)
 
     def setParameters(self, volume=None, shuffle=None, repeat=None, mtype=DEFAULT_MTYPE):
         """ Set multiple playback parameters at once.
diff --git a/lib/plexapi/collection.py b/lib/plexapi/collection.py
index cd9e52c1..44f1e1f7 100644
--- a/lib/plexapi/collection.py
+++ b/lib/plexapi/collection.py
@@ -5,14 +5,24 @@ from plexapi import media, utils
 from plexapi.base import PlexPartialObject
 from plexapi.exceptions import BadRequest, NotFound, Unsupported
 from plexapi.library import LibrarySection
-from plexapi.mixins import AdvancedSettingsMixin, ArtMixin, PosterMixin, RatingMixin
-from plexapi.mixins import LabelMixin, SmartFilterMixin
+from plexapi.mixins import (
+    AdvancedSettingsMixin, SmartFilterMixin, HubsMixin, RatingMixin,
+    ArtMixin, PosterMixin, ThemeMixin,
+    ContentRatingMixin, SortTitleMixin, SummaryMixin, TitleMixin,
+    LabelMixin
+)
 from plexapi.playqueue import PlayQueue
 from plexapi.utils import deprecated
 
 
 @utils.registerPlexObject
-class Collection(PlexPartialObject, AdvancedSettingsMixin, ArtMixin, PosterMixin, RatingMixin, LabelMixin, SmartFilterMixin):
+class Collection(
+    PlexPartialObject,
+    AdvancedSettingsMixin, SmartFilterMixin, HubsMixin, RatingMixin,
+    ArtMixin, PosterMixin, ThemeMixin,
+    ContentRatingMixin, SortTitleMixin, SummaryMixin, TitleMixin,
+    LabelMixin
+):
     """ Represents a single Collection.
 
         Attributes:
@@ -22,9 +32,10 @@ class Collection(PlexPartialObject, AdvancedSettingsMixin, ArtMixin, PosterMixin
             art (str): URL to artwork image (/library/metadata/<ratingKey>/art/<artid>).
             artBlurHash (str): BlurHash string for artwork image.
             childCount (int): Number of items in the collection.
-            collectionMode (str): How the items in the collection are displayed.
+            collectionFilterBasedOnUser (int): Which user's activity is used for the collection filtering.
+            collectionMode (int): How the items in the collection are displayed.
             collectionPublished (bool): True if the collection is published to the Plex homepage.
-            collectionSort (str): How to sort the items in the collection.
+            collectionSort (int): How to sort the items in the collection.
             content (str): The filter URI string for smart collections.
             contentRating (str) Content rating (PG-13; NR; TV-G).
             fields (List<:class:`~plexapi.media.Field`>): List of field objects.
@@ -43,12 +54,13 @@ class Collection(PlexPartialObject, AdvancedSettingsMixin, ArtMixin, PosterMixin
             smart (bool): True if the collection is a smart collection.
             subtype (str): Media type of the items in the collection (movie, show, artist, or album).
             summary (str): Summary of the collection.
+            theme (str): URL to theme resource (/library/metadata/<ratingkey>/theme/<themeid>).
             thumb (str): URL to thumbnail image (/library/metadata/<ratingKey>/thumb/<thumbid>).
             thumbBlurHash (str): BlurHash string for thumbnail image.
             title (str): Name of the collection.
             titleSort (str): Title to use when sorting (defaults to title).
             type (str): 'collection'
-            updatedAt (datatime): Datetime the collection was updated.
+            updatedAt (datetime): Datetime the collection was updated.
             userRating (float): Rating of the collection (0.0 - 10.0) equaling (0 stars - 5 stars).
     """
     TAG = 'Directory'
@@ -60,6 +72,7 @@ class Collection(PlexPartialObject, AdvancedSettingsMixin, ArtMixin, PosterMixin
         self.art = data.attrib.get('art')
         self.artBlurHash = data.attrib.get('artBlurHash')
         self.childCount = utils.cast(int, data.attrib.get('childCount'))
+        self.collectionFilterBasedOnUser = utils.cast(int, data.attrib.get('collectionFilterBasedOnUser', '0'))
         self.collectionMode = utils.cast(int, data.attrib.get('collectionMode', '-1'))
         self.collectionPublished = utils.cast(bool, data.attrib.get('collectionPublished', '0'))
         self.collectionSort = utils.cast(int, data.attrib.get('collectionSort', '0'))
@@ -81,6 +94,7 @@ class Collection(PlexPartialObject, AdvancedSettingsMixin, ArtMixin, PosterMixin
         self.smart = utils.cast(bool, data.attrib.get('smart', '0'))
         self.subtype = data.attrib.get('subtype')
         self.summary = data.attrib.get('summary')
+        self.theme = data.attrib.get('theme')
         self.thumb = data.attrib.get('thumb')
         self.thumbBlurHash = data.attrib.get('thumbBlurHash')
         self.title = data.attrib.get('title')
@@ -184,6 +198,32 @@ class Collection(PlexPartialObject, AdvancedSettingsMixin, ArtMixin, PosterMixin
         """ Alias to :func:`~plexapi.library.Collection.item`. """
         return self.item(title)
 
+    def filterUserUpdate(self, user=None):
+        """ Update the collection filtering user advanced setting.
+
+            Parameters:
+                user (str): One of the following values:
+                    "admin" (Always the server admin user),
+                    "user" (User currently viewing the content)
+
+            Example:
+
+                .. code-block:: python
+
+                    collection.updateMode(user="user")
+        """
+        if not self.smart:
+            raise BadRequest('Cannot change collection filtering user for a non-smart collection.')
+
+        user_dict = {
+            'admin': 0,
+            'user': 1
+        }
+        key = user_dict.get(user)
+        if key is None:
+            raise BadRequest('Unknown collection filtering user: %s. Options %s' % (user, list(user_dict)))
+        self.editAdvanced(collectionFilterBasedOnUser=key)
+
     def modeUpdate(self, mode=None):
         """ Update the collection mode advanced setting.
 
@@ -208,7 +248,7 @@ class Collection(PlexPartialObject, AdvancedSettingsMixin, ArtMixin, PosterMixin
         }
         key = mode_dict.get(mode)
         if key is None:
-            raise BadRequest('Unknown collection mode : %s. Options %s' % (mode, list(mode_dict)))
+            raise BadRequest('Unknown collection mode: %s. Options %s' % (mode, list(mode_dict)))
         self.editAdvanced(collectionMode=key)
 
     def sortUpdate(self, sort=None):
@@ -216,7 +256,7 @@ class Collection(PlexPartialObject, AdvancedSettingsMixin, ArtMixin, PosterMixin
 
             Parameters:
                 sort (str): One of the following values:
-                    "realease" (Order Collection by realease dates),
+                    "release" (Order Collection by release dates),
                     "alpha" (Order Collection alphabetically),
                     "custom" (Custom collection order)
 
@@ -226,6 +266,9 @@ class Collection(PlexPartialObject, AdvancedSettingsMixin, ArtMixin, PosterMixin
 
                     collection.updateSort(mode="alpha")
         """
+        if self.smart:
+            raise BadRequest('Cannot change collection order for a smart collection.')
+
         sort_dict = {
             'release': 0,
             'alpha': 1,
@@ -340,6 +383,7 @@ class Collection(PlexPartialObject, AdvancedSettingsMixin, ArtMixin, PosterMixin
         }))
         self._server.query(key, method=self._server._session.put)
 
+    @deprecated('use editTitle, editSortTitle, editContentRating, and editSummary instead')
     def edit(self, title=None, titleSort=None, contentRating=None, summary=None, **kwargs):
         """ Edit the collection.
         
@@ -364,7 +408,7 @@ class Collection(PlexPartialObject, AdvancedSettingsMixin, ArtMixin, PosterMixin
             args['summary.locked'] = 1
 
         args.update(kwargs)
-        super(Collection, self).edit(**args)
+        self._edit(**args)
 
     def delete(self):
         """ Delete the collection. """
diff --git a/lib/plexapi/config.py b/lib/plexapi/config.py
index e78fa193..77bb8953 100644
--- a/lib/plexapi/config.py
+++ b/lib/plexapi/config.py
@@ -62,4 +62,5 @@ def reset_base_headers():
         'X-Plex-Device-Name': plexapi.X_PLEX_DEVICE_NAME,
         'X-Plex-Client-Identifier': plexapi.X_PLEX_IDENTIFIER,
         'X-Plex-Sync-Version': '2',
+        'X-Plex-Features': 'external-media',
     }
diff --git a/lib/plexapi/const.py b/lib/plexapi/const.py
index 72ad282f..80d34806 100644
--- a/lib/plexapi/const.py
+++ b/lib/plexapi/const.py
@@ -3,7 +3,7 @@
 
 # Library version
 MAJOR_VERSION = 4
-MINOR_VERSION = 9
-PATCH_VERSION = 2
+MINOR_VERSION = 11
+PATCH_VERSION = 0
 __short_version__ = f"{MAJOR_VERSION}.{MINOR_VERSION}"
 __version__ = f"{__short_version__}.{PATCH_VERSION}"
diff --git a/lib/plexapi/gdm.py b/lib/plexapi/gdm.py
index b2214e9e..b9edac08 100644
--- a/lib/plexapi/gdm.py
+++ b/lib/plexapi/gdm.py
@@ -15,7 +15,7 @@ import struct
 class GDM:
     """Base class to discover GDM services.
 
-       Atrributes:
+       Attributes:
            entries (List<dict>): List of server and/or client data discovered.
     """
 
diff --git a/lib/plexapi/library.py b/lib/plexapi/library.py
index c67ae9b7..41892ef9 100644
--- a/lib/plexapi/library.py
+++ b/lib/plexapi/library.py
@@ -43,7 +43,7 @@ class Library(PlexObject):
                 if elem.attrib.get('type') == cls.TYPE:
                     section = cls(self._server, elem, key)
                     self._sectionsByID[section.key] = section
-                    self._sectionsByTitle[section.title.lower()] = section
+                    self._sectionsByTitle[section.title.lower().strip()] = section
 
     def sections(self):
         """ Returns a list of all media sections in this library. Library sections may be any of
@@ -59,10 +59,11 @@ class Library(PlexObject):
             Parameters:
                 title (str): Title of the section to return.
         """
-        if not self._sectionsByTitle or title not in self._sectionsByTitle:
+        normalized_title = title.lower().strip()
+        if not self._sectionsByTitle or normalized_title not in self._sectionsByTitle:
             self._loadSections()
         try:
-            return self._sectionsByTitle[title.lower()]
+            return self._sectionsByTitle[normalized_title]
         except KeyError:
             raise NotFound('Invalid library section: %s' % title) from None
 
@@ -125,7 +126,7 @@ class Library(PlexObject):
     def search(self, title=None, libtype=None, **kwargs):
         """ Searching within a library section is much more powerful. It seems certain
             attributes on the media objects can be targeted to filter this search down
-            a bit, but I havent found the documentation for it.
+            a bit, but I haven't found the documentation for it.
 
             Example: "studio=Comedy%20Central" or "year=1999" "title=Kung Fu" all work. Other items
             such as actor=<id> seem to work, but require you already know the id of the actor.
@@ -396,7 +397,7 @@ class LibrarySection(PlexObject):
         self.type = data.attrib.get('type')
         self.updatedAt = utils.toDatetime(data.attrib.get('updatedAt'))
         self.uuid = data.attrib.get('uuid')
-        # Private attrs as we dont want a reload.
+        # Private attrs as we don't want a reload.
         self._filterTypes = None
         self._fieldTypes = None
         self._totalViewSize = None
@@ -599,12 +600,13 @@ class LibrarySection(PlexObject):
         return self.fetchItem(key, title__iexact=title)
 
     def getGuid(self, guid):
-        """ Returns the media item with the specified external IMDB, TMDB, or TVDB ID.
+        """ Returns the media item with the specified external Plex, IMDB, TMDB, or TVDB ID.
             Note: Only available for the Plex Movie and Plex TV Series agents.
 
             Parameters:
                 guid (str): The external guid of the item to return.
-                    Examples: IMDB ``imdb://tt0944947``, TMDB ``tmdb://1399``, TVDB ``tvdb://121361``.
+                    Examples: Plex ``plex://show/5d9c086c46115600200aa2fe``
+                    IMDB ``imdb://tt0944947``, TMDB ``tmdb://1399``, TVDB ``tvdb://121361``.
 
             Raises:
                 :exc:`~plexapi.exceptions.NotFound`: The guid is not found in the library.
@@ -613,21 +615,32 @@ class LibrarySection(PlexObject):
 
                 .. code-block:: python
 
-                    result1 = library.getGuid('imdb://tt0944947')
-                    result2 = library.getGuid('tmdb://1399')
-                    result3 = library.getGuid('tvdb://121361')
+                    result1 = library.getGuid('plex://show/5d9c086c46115600200aa2fe')
+                    result2 = library.getGuid('imdb://tt0944947')
+                    result3 = library.getGuid('tmdb://1399')
+                    result4 = library.getGuid('tvdb://121361')
 
                     # Alternatively, create your own guid lookup dictionary for faster performance
-                    guidLookup = {guid.id: item for item in library.all() for guid in item.guids}
-                    result1 = guidLookup['imdb://tt0944947']
-                    result2 = guidLookup['tmdb://1399']
-                    result3 = guidLookup['tvdb://121361']
+                    guidLookup = {}
+                    for item in library.all():
+                        guidLookup[item.guid] = item
+                        guidLookup.update({guid.id for guid in item.guids}}
+
+                    result1 = guidLookup['plex://show/5d9c086c46115600200aa2fe']
+                    result2 = guidLookup['imdb://tt0944947']
+                    result4 = guidLookup['tmdb://1399']
+                    result5 = guidLookup['tvdb://121361']
 
         """
+
         try:
-            dummy = self.search(maxresults=1)[0]
-            match = dummy.matches(agent=self.agent, title=guid.replace('://', '-'))
-            return self.search(guid=match[0].guid)[0]
+            if guid.startswith('plex://'):
+                result = self.search(guid=guid)[0]
+                return result
+            else:
+                dummy = self.search(maxresults=1)[0]
+                match = dummy.matches(agent=self.agent, title=guid.replace('://', '-'))
+                return self.search(guid=match[0].guid)[0]
         except IndexError:
             raise NotFound("Guid '%s' is not found in the library" % guid) from None
 
@@ -1271,7 +1284,7 @@ class LibrarySection(PlexObject):
             * See :func:`~plexapi.library.LibrarySection.listOperators` to get a list of all available operators.
             * See :func:`~plexapi.library.LibrarySection.listFilterChoices` to get a list of all available filter values.
 
-            The following filter fields are just some examples of the possible filters. The list is not exaustive,
+            The following filter fields are just some examples of the possible filters. The list is not exhaustive,
             and not all filters apply to all library types.
 
             * **actor** (:class:`~plexapi.media.MediaTag`): Search for the name of an actor.
@@ -1334,7 +1347,7 @@ class LibrarySection(PlexObject):
             Some filters may be prefixed by the ``libtype`` separated by a ``.`` (e.g. ``show.collection``,
             ``episode.title``, ``artist.style``, ``album.genre``, ``track.userRating``, etc.). This should not be
             confused with the ``libtype`` parameter. If no ``libtype`` prefix is provided, then the default library
-            type is assumed. For example, in a TV show library ``viewCout`` is assumed to be ``show.viewCount``.
+            type is assumed. For example, in a TV show library ``viewCount`` is assumed to be ``show.viewCount``.
             If you want to filter using episode view count then you must specify ``episode.viewCount`` explicitly.
             In addition, if the filter does not exist for the default library type it will fallback to the most
             specific ``libtype`` available. For example, ``show.unwatched`` does not exists so it will fallback to
@@ -2236,16 +2249,61 @@ class FilteringType(PlexObject):
         self.title = data.attrib.get('title')
         self.type = data.attrib.get('type')
 
-        # Add additional manual sorts and fields which are available
+        self._librarySectionID = self._parent().key
+
+        # Add additional manual filters, sorts, and fields which are available
         # but not exposed on the Plex server
+        self.filters += self._manualFilters()
         self.sorts += self._manualSorts()
         self.fields += self._manualFields()
 
+    def _manualFilters(self):
+        """ Manually add additional filters which are available
+            but not exposed on the Plex server.
+        """
+        # Filters: (filter, type, title)
+        additionalFilters = [
+        ]
+
+        if self.type == 'season':
+            additionalFilters.extend([
+                ('label', 'string', 'Labels')
+            ])
+        elif self.type == 'episode':
+            additionalFilters.extend([
+                ('label', 'string', 'Labels')
+            ])
+        elif self.type == 'artist':
+            additionalFilters.extend([
+                ('label', 'string', 'Labels')
+            ])
+        elif self.type == 'track':
+            additionalFilters.extend([
+                ('label', 'string', 'Labels')
+            ])
+        elif self.type == 'collection':
+            additionalFilters.extend([
+                ('label', 'string', 'Labels')
+            ])
+
+        manualFilters = []
+        for filterTag, filterType, filterTitle in additionalFilters:
+            filterKey = '/library/sections/%s/%s?type=%s' % (
+                self._librarySectionID, filterTag, utils.searchType(self.type)
+            )
+            filterXML = (
+                '<Filter filter="%s" filterType="%s" key="%s" title="%s" type="filter" />'
+                % (filterTag, filterType, filterKey, filterTitle)
+            )
+            manualFilters.append(self._manuallyLoadXML(filterXML, FilteringFilter))
+
+        return manualFilters
+
     def _manualSorts(self):
         """ Manually add additional sorts which are available
             but not exposed on the Plex server.
         """
-        # Sorts: key, dir, title
+        # Sorts: (key, dir, title)
         additionalSorts = [
             ('guid', 'asc', 'Guid'),
             ('id', 'asc', 'Rating Key'),
@@ -2275,8 +2333,10 @@ class FilteringType(PlexObject):
 
         manualSorts = []
         for sortField, sortDir, sortTitle in additionalSorts:
-            sortXML = ('<Sort defaultDirection="%s" descKey="%s:desc" key="%s" title="%s" />'
-                       % (sortDir, sortField, sortField, sortTitle))
+            sortXML = (
+                '<Sort defaultDirection="%s" descKey="%s:desc" key="%s" title="%s" />'
+                % (sortDir, sortField, sortField, sortTitle)
+            )
             manualSorts.append(self._manuallyLoadXML(sortXML, FilteringSort))
 
         return manualSorts
@@ -2285,7 +2345,7 @@ class FilteringType(PlexObject):
         """ Manually add additional fields which are available
             but not exposed on the Plex server.
         """
-        # Fields: key, type, title
+        # Fields: (key, type, title)
         additionalFields = [
             ('guid', 'string', 'Guid'),
             ('id', 'integer', 'Rating Key'),
@@ -2311,31 +2371,41 @@ class FilteringType(PlexObject):
             additionalFields.extend([
                 ('addedAt', 'date', 'Date Season Added'),
                 ('unviewedLeafCount', 'integer', 'Episode Unplayed Count'),
-                ('year', 'integer', 'Season Year')
+                ('year', 'integer', 'Season Year'),
+                ('label', 'tag', 'Label')
             ])
         elif self.type == 'episode':
             additionalFields.extend([
                 ('audienceRating', 'integer', 'Audience Rating'),
                 ('duration', 'integer', 'Duration'),
                 ('rating', 'integer', 'Critic Rating'),
-                ('viewOffset', 'integer', 'View Offset')
+                ('viewOffset', 'integer', 'View Offset'),
+                ('label', 'tag', 'Label')
+            ])
+        elif self.type == 'artist':
+            additionalFields.extend([
+                ('label', 'tag', 'Label')
             ])
         elif self.type == 'track':
             additionalFields.extend([
                 ('duration', 'integer', 'Duration'),
-                ('viewOffset', 'integer', 'View Offset')
+                ('viewOffset', 'integer', 'View Offset'),
+                ('label', 'tag', 'Label')
             ])
         elif self.type == 'collection':
             additionalFields.extend([
-                ('addedAt', 'date', 'Date Added')
+                ('addedAt', 'date', 'Date Added'),
+                ('label', 'tag', 'Label')
             ])
 
         prefix = '' if self.type == 'movie' else self.type + '.'
 
         manualFields = []
         for field, fieldType, fieldTitle in additionalFields:
-            fieldXML = ('<Field key="%s%s" title="%s" type="%s"/>'
-                       % (prefix, field, fieldTitle, fieldType))
+            fieldXML = (
+                '<Field key="%s%s" title="%s" type="%s"/>'
+                % (prefix, field, fieldTitle, fieldType)
+            )
             manualFields.append(self._manuallyLoadXML(fieldXML, FilteringField))
 
         return manualFields
diff --git a/lib/plexapi/media.py b/lib/plexapi/media.py
index 87c33383..23ac7700 100644
--- a/lib/plexapi/media.py
+++ b/lib/plexapi/media.py
@@ -39,7 +39,7 @@ class Media(PlexObject):
 
             <Photo_only_attributes>: The following attributes are only available for photos.
 
-                * aperture (str): The apeture used to take the photo.
+                * aperture (str): The aperture used to take the photo.
                 * exposure (str): The exposure used to take the photo.
                 * iso (int): The iso used to take the photo.
                 * lens (str): The lens used to take the photo.
@@ -93,7 +93,7 @@ class Media(PlexObject):
         try:
             return self._server.query(part, method=self._server._session.delete)
         except BadRequest:
-            log.error("Failed to delete %s. This could be because you havn't allowed "
+            log.error("Failed to delete %s. This could be because you haven't allowed "
                       "items to be deleted" % part)
             raise
 
@@ -224,7 +224,7 @@ class MediaPartStream(PlexObject):
             id (int): The unique ID for this stream on the server.
             index (int): The index of the stream.
             language (str): The language of the stream (ex: English, ไทย).
-            languageCode (str): The Ascii language code of the stream (ex: eng, tha).
+            languageCode (str): The ASCII language code of the stream (ex: eng, tha).
             requiredBandwidths (str): The required bandwidths to stream the file.
             selected (bool): True if this stream is selected.
             streamType (int): The stream type (1= :class:`~plexapi.media.VideoStream`,
@@ -283,8 +283,8 @@ class VideoStream(MediaPartStream):
             duration (int): The duration of video stream in milliseconds.
             frameRate (float): The frame rate of the video stream (ex: 23.976).
             frameRateMode (str): The frame rate mode of the video stream.
-            hasScallingMatrix (bool): True if video stream has a scaling matrix.
-            height (int): The hight of the video stream in pixels (ex: 1080).
+            hasScalingMatrix (bool): True if video stream has a scaling matrix.
+            height (int): The height of the video stream in pixels (ex: 1080).
             level (int): The codec encoding level of the video stream (ex: 41).
             profile (str): The profile of the video stream (ex: asp).
             pixelAspectRatio (str): The pixel aspect ratio of the video stream.
@@ -323,7 +323,7 @@ class VideoStream(MediaPartStream):
         self.duration = utils.cast(int, data.attrib.get('duration'))
         self.frameRate = utils.cast(float, data.attrib.get('frameRate'))
         self.frameRateMode = data.attrib.get('frameRateMode')
-        self.hasScallingMatrix = utils.cast(bool, data.attrib.get('hasScallingMatrix'))
+        self.hasScalingMatrix = utils.cast(bool, data.attrib.get('hasScalingMatrix'))
         self.height = utils.cast(int, data.attrib.get('height'))
         self.level = utils.cast(int, data.attrib.get('level'))
         self.profile = data.attrib.get('profile')
@@ -400,7 +400,7 @@ class SubtitleStream(MediaPartStream):
             container (str): The container of the subtitle stream.
             forced (bool): True if this is a forced subtitle.
             format (str): The format of the subtitle stream (ex: srt).
-            headerCommpression (str): The header compression of the subtitle stream.
+            headerCompression (str): The header compression of the subtitle stream.
             transient (str): Unknown.
     """
     TAG = 'Stream'
@@ -468,7 +468,7 @@ class TranscodeSession(PlexObject):
             audioDecision (str): The transcode decision for the audio stream.
             complete (bool): True if the transcode is complete.
             container (str): The container of the transcoded media.
-            context (str): The context for the transcode sesson.
+            context (str): The context for the transcode session.
             duration (int): The duration of the transcoded media in milliseconds.
             height (int): The height of the transcoded media in pixels.
             key (str): API URL (ex: /transcode/sessions/<id>).
@@ -572,7 +572,7 @@ class Optimized(PlexObject):
         """
         key = '%s/%s/items' % (self._initpath, self.id)
         return self.fetchItems(key)
-        
+
     def remove(self):
         """ Remove an Optimized item"""
         key = '%s/%s' % (self._initpath, self.id)
@@ -893,7 +893,7 @@ class Guid(GuidTag):
 @utils.registerPlexObject
 class Review(PlexObject):
     """ Represents a single Review for a Movie.
-    
+
         Attributes:
             TAG (str): 'Review'
             filter (str): filter for reviews?
@@ -917,19 +917,17 @@ class Review(PlexObject):
         self.text = data.attrib.get('text')
 
 
-class BaseImage(PlexObject):
-    """ Base class for all Art, Banner, and Poster objects.
+class BaseResource(PlexObject):
+    """ Base class for all Art, Banner, Poster, and Theme objects.
 
         Attributes:
-            TAG (str): 'Photo'
+            TAG (str): 'Photo' or 'Track'
             key (str): API URL (/library/metadata/<ratingkey>).
-            provider (str): The source of the poster or art.
-            ratingKey (str): Unique key identifying the poster or art.
-            selected (bool): True if the poster or art is currently selected.
-            thumb (str): The URL to retrieve the poster or art thumbnail.
+            provider (str): The source of the art or poster, None for Theme objects.
+            ratingKey (str): Unique key identifying the resource.
+            selected (bool): True if the resource is currently selected.
+            thumb (str): The URL to retrieve the resource thumbnail.
     """
-    TAG = 'Photo'
-
     def _loadData(self, data):
         self._data = data
         self.key = data.attrib.get('key')
@@ -947,16 +945,24 @@ class BaseImage(PlexObject):
             pass
 
 
-class Art(BaseImage):
+class Art(BaseResource):
     """ Represents a single Art object. """
+    TAG = 'Photo'
 
 
-class Banner(BaseImage):
+class Banner(BaseResource):
     """ Represents a single Banner object. """
+    TAG = 'Photo'
 
 
-class Poster(BaseImage):
+class Poster(BaseResource):
     """ Represents a single Poster object. """
+    TAG = 'Photo'
+
+
+class Theme(BaseResource):
+    """ Represents a single Theme object. """
+    TAG = 'Track'
 
 
 @utils.registerPlexObject
@@ -1106,3 +1112,41 @@ class AgentMediaType(Agent):
     @deprecated('use "languageCodes" instead')
     def languageCode(self):
         return self.languageCodes
+
+
+@utils.registerPlexObject
+class Availability(PlexObject):
+    """ Represents a single online streaming service Availability.
+
+        Attributes:
+            TAG (str): 'Availability'
+            country (str): The streaming service country.
+            offerType (str): Subscription, buy, or rent from the streaming service.
+            platform (str): The platform slug for the streaming service.
+            platformColorThumb (str): Thumbnail icon for the streaming service.
+            platformInfo (str): The streaming service platform info.
+            platformUrl (str): The URL to the media on the streaming service.
+            price (float): The price to buy or rent from the streaming service.
+            priceDescription (str): The display price to buy or rent from the streaming service.
+            quality (str): The video quality on the streaming service.
+            title (str): The title of the streaming service.
+            url (str): The Plex availability URL.
+    """
+    TAG = 'Availability'
+
+    def __repr__(self):
+        return f'<{self.__class__.__name__}:{self.platform}:{self.offerType}>'
+
+    def _loadData(self, data):
+        self._data = data
+        self.country = data.attrib.get('country')
+        self.offerType = data.attrib.get('offerType')
+        self.platform = data.attrib.get('platform')
+        self.platformColorThumb = data.attrib.get('platformColorThumb')
+        self.platformInfo = data.attrib.get('platformInfo')
+        self.platformUrl = data.attrib.get('platformUrl')
+        self.price = utils.cast(float, data.attrib.get('price'))
+        self.priceDescription = data.attrib.get('priceDescription')
+        self.quality = data.attrib.get('quality')
+        self.title = data.attrib.get('title')
+        self.url = data.attrib.get('url')
diff --git a/lib/plexapi/mixins.py b/lib/plexapi/mixins.py
index af5d1da5..906ab81d 100644
--- a/lib/plexapi/mixins.py
+++ b/lib/plexapi/mixins.py
@@ -1,8 +1,11 @@
 # -*- coding: utf-8 -*-
+from datetime import datetime
+
 from urllib.parse import parse_qsl, quote_plus, unquote, urlencode, urlsplit
 
 from plexapi import media, settings, utils
 from plexapi.exceptions import BadRequest, NotFound
+from plexapi.utils import deprecated
 
 
 class AdvancedSettingsMixin(object):
@@ -57,176 +60,64 @@ class AdvancedSettingsMixin(object):
         self._server.query(url, method=self._server._session.put)
 
 
-class ArtUrlMixin(object):
-    """ Mixin for Plex objects that can have a background artwork url. """
+class SmartFilterMixin(object):
+    """ Mixing for Plex objects that can have smart filters. """
+
+    def _parseFilters(self, content):
+        """ Parse the content string and returns the filter dict. """
+        content = urlsplit(unquote(content))
+        filters = {}
+        filterOp = 'and'
+        filterGroups = [[]]
+        
+        for key, value in parse_qsl(content.query):
+            # Move = sign to key when operator is ==
+            if value.startswith('='):
+                key += '='
+                value = value[1:]
+
+            if key == 'includeGuids':
+                filters['includeGuids'] = int(value)
+            elif key == 'type':
+                filters['libtype'] = utils.reverseSearchType(value)
+            elif key == 'sort':
+                filters['sort'] = value.split(',')
+            elif key == 'limit':
+                filters['limit'] = int(value)
+            elif key == 'push':
+                filterGroups[-1].append([])
+                filterGroups.append(filterGroups[-1][-1])
+            elif key == 'and':
+                filterOp = 'and'
+            elif key == 'or':
+                filterOp = 'or'
+            elif key == 'pop':
+                filterGroups[-1].insert(0, filterOp)
+                filterGroups.pop()
+            else:
+                filterGroups[-1].append({key: value})
+        
+        if filterGroups:
+            filters['filters'] = self._formatFilterGroups(filterGroups.pop())
+        return filters
     
-    @property
-    def artUrl(self):
-        """ Return the art url for the Plex object. """
-        art = self.firstAttr('art', 'grandparentArt')
-        return self._server.url(art, includeToken=True) if art else None
+    def _formatFilterGroups(self, groups):
+        """ Formats the filter groups into the advanced search rules. """
+        if len(groups) == 1 and isinstance(groups[0], list):
+            groups = groups.pop()
 
+        filterOp = 'and'
+        rules = []
 
-class ArtMixin(ArtUrlMixin):
-    """ Mixin for Plex objects that can have background artwork. """
+        for g in groups:
+            if isinstance(g, list):
+                rules.append(self._formatFilterGroups(g))
+            elif isinstance(g, dict):
+                rules.append(g)
+            elif g in {'and', 'or'}:
+                filterOp = g
 
-    def arts(self):
-        """ Returns list of available :class:`~plexapi.media.Art` objects. """
-        return self.fetchItems('/library/metadata/%s/arts' % self.ratingKey, cls=media.Art)
-
-    def uploadArt(self, url=None, filepath=None):
-        """ Upload a background artwork from a url or filepath.
-        
-            Parameters:
-                url (str): The full URL to the image to upload.
-                filepath (str): The full file path the the image to upload.
-        """
-        if url:
-            key = '/library/metadata/%s/arts?url=%s' % (self.ratingKey, quote_plus(url))
-            self._server.query(key, method=self._server._session.post)
-        elif filepath:
-            key = '/library/metadata/%s/arts?' % self.ratingKey
-            data = open(filepath, 'rb').read()
-            self._server.query(key, method=self._server._session.post, data=data)
-
-    def setArt(self, art):
-        """ Set the background artwork for a Plex object.
-        
-            Parameters:
-                art (:class:`~plexapi.media.Art`): The art object to select.
-        """
-        art.select()
-
-    def lockArt(self):
-        """ Lock the background artwork for a Plex object. """
-        self._edit(**{'art.locked': 1})
-
-    def unlockArt(self):
-        """ Unlock the background artwork for a Plex object. """
-        self._edit(**{'art.locked': 0})
-
-
-class BannerUrlMixin(object):
-    """ Mixin for Plex objects that can have a banner url. """
-
-    @property
-    def bannerUrl(self):
-        """ Return the banner url for the Plex object. """
-        banner = self.firstAttr('banner')
-        return self._server.url(banner, includeToken=True) if banner else None
-
-
-class BannerMixin(BannerUrlMixin):
-    """ Mixin for Plex objects that can have banners. """
-
-    def banners(self):
-        """ Returns list of available :class:`~plexapi.media.Banner` objects. """
-        return self.fetchItems('/library/metadata/%s/banners' % self.ratingKey, cls=media.Banner)
-
-    def uploadBanner(self, url=None, filepath=None):
-        """ Upload a banner from a url or filepath.
-        
-            Parameters:
-                url (str): The full URL to the image to upload.
-                filepath (str): The full file path the the image to upload.
-        """
-        if url:
-            key = '/library/metadata/%s/banners?url=%s' % (self.ratingKey, quote_plus(url))
-            self._server.query(key, method=self._server._session.post)
-        elif filepath:
-            key = '/library/metadata/%s/banners?' % self.ratingKey
-            data = open(filepath, 'rb').read()
-            self._server.query(key, method=self._server._session.post, data=data)
-
-    def setBanner(self, banner):
-        """ Set the banner for a Plex object.
-        
-            Parameters:
-                banner (:class:`~plexapi.media.Banner`): The banner object to select.
-        """
-        banner.select()
-
-    def lockBanner(self):
-        """ Lock the banner for a Plex object. """
-        self._edit(**{'banner.locked': 1})
-
-    def unlockBanner(self):
-        """ Unlock the banner for a Plex object. """
-        self._edit(**{'banner.locked': 0})
-
-
-class PosterUrlMixin(object):
-    """ Mixin for Plex objects that can have a poster url. """
-
-    @property
-    def thumbUrl(self):
-        """ Return the thumb url for the Plex object. """
-        thumb = self.firstAttr('thumb', 'parentThumb', 'granparentThumb')
-        return self._server.url(thumb, includeToken=True) if thumb else None
-
-    @property
-    def posterUrl(self):
-        """ Alias to self.thumbUrl. """
-        return self.thumbUrl
-
-
-class PosterMixin(PosterUrlMixin):
-    """ Mixin for Plex objects that can have posters. """
-
-    def posters(self):
-        """ Returns list of available :class:`~plexapi.media.Poster` objects. """
-        return self.fetchItems('/library/metadata/%s/posters' % self.ratingKey, cls=media.Poster)
-
-    def uploadPoster(self, url=None, filepath=None):
-        """ Upload a poster from a url or filepath.
-
-            Parameters:
-                url (str): The full URL to the image to upload.
-                filepath (str): The full file path the the image to upload.
-        """
-        if url:
-            key = '/library/metadata/%s/posters?url=%s' % (self.ratingKey, quote_plus(url))
-            self._server.query(key, method=self._server._session.post)
-        elif filepath:
-            key = '/library/metadata/%s/posters?' % self.ratingKey
-            data = open(filepath, 'rb').read()
-            self._server.query(key, method=self._server._session.post, data=data)
-
-    def setPoster(self, poster):
-        """ Set the poster for a Plex object.
-        
-            Parameters:
-                poster (:class:`~plexapi.media.Poster`): The poster object to select.
-        """
-        poster.select()
-
-    def lockPoster(self):
-        """ Lock the poster for a Plex object. """
-        self._edit(**{'thumb.locked': 1})
-
-    def unlockPoster(self):
-        """ Unlock the poster for a Plex object. """
-        self._edit(**{'thumb.locked': 0})
-
-
-class RatingMixin(object):
-    """ Mixin for Plex objects that can have user star ratings. """
-
-    def rate(self, rating=None):
-        """ Rate the Plex object. Note: Plex ratings are displayed out of 5 stars (e.g. rating 7.0 = 3.5 stars).
-
-            Parameters:
-                rating (float, optional): Rating from 0 to 10. Exclude to reset the rating.
-
-            Raises:
-                :exc:`~plexapi.exceptions.BadRequest`: If the rating is invalid.
-        """
-        if rating is None:
-            rating = -1
-        elif not isinstance(rating, (int, float)) or rating < 0 or rating > 10:
-            raise BadRequest('Rating must be between 0 to 10.')
-        key = '/:/rate?key=%s&identifier=com.plexapp.plugins.library&rating=%s' % (self.ratingKey, rating)
-        self._server.query(key, method=self._server._session.put)
+        return {filterOp: rules}
 
 
 class SplitMergeMixin(object):
@@ -343,303 +234,815 @@ class UnmatchMatchMixin(object):
         self._server.query(data, method=self._server._session.put)
 
 
-class CollectionMixin(object):
+class ExtrasMixin(object):
+    """ Mixin for Plex objects that can have extras. """
+
+    def extras(self):
+        """ Returns a list of :class:`~plexapi.video.Extra` objects. """
+        from plexapi.video import Extra
+        data = self._server.query(self._details_key)
+        return self.findItems(data, Extra, rtag='Extras')
+
+
+class HubsMixin(object):
+    """ Mixin for Plex objects that can have related hubs. """
+
+    def hubs(self):
+        """ Returns a list of :class:`~plexapi.library.Hub` objects. """
+        from plexapi.library import Hub
+        data = self._server.query(self._details_key)
+        return self.findItems(data, Hub, rtag='Related')
+
+
+class RatingMixin(object):
+    """ Mixin for Plex objects that can have user star ratings. """
+
+    def rate(self, rating=None):
+        """ Rate the Plex object. Note: Plex ratings are displayed out of 5 stars (e.g. rating 7.0 = 3.5 stars).
+
+            Parameters:
+                rating (float, optional): Rating from 0 to 10. Exclude to reset the rating.
+
+            Raises:
+                :exc:`~plexapi.exceptions.BadRequest`: If the rating is invalid.
+        """
+        if rating is None:
+            rating = -1
+        elif not isinstance(rating, (int, float)) or rating < 0 or rating > 10:
+            raise BadRequest('Rating must be between 0 to 10.')
+        key = '/:/rate?key=%s&identifier=com.plexapp.plugins.library&rating=%s' % (self.ratingKey, rating)
+        self._server.query(key, method=self._server._session.put)
+
+
+class ArtUrlMixin(object):
+    """ Mixin for Plex objects that can have a background artwork url. """
+    
+    @property
+    def artUrl(self):
+        """ Return the art url for the Plex object. """
+        art = self.firstAttr('art', 'grandparentArt')
+        return self._server.url(art, includeToken=True) if art else None
+
+
+class ArtMixin(ArtUrlMixin):
+    """ Mixin for Plex objects that can have background artwork. """
+
+    def arts(self):
+        """ Returns list of available :class:`~plexapi.media.Art` objects. """
+        return self.fetchItems('/library/metadata/%s/arts' % self.ratingKey, cls=media.Art)
+
+    def uploadArt(self, url=None, filepath=None):
+        """ Upload a background artwork from a url or filepath.
+        
+            Parameters:
+                url (str): The full URL to the image to upload.
+                filepath (str): The full file path the the image to upload.
+        """
+        if url:
+            key = '/library/metadata/%s/arts?url=%s' % (self.ratingKey, quote_plus(url))
+            self._server.query(key, method=self._server._session.post)
+        elif filepath:
+            key = '/library/metadata/%s/arts?' % self.ratingKey
+            data = open(filepath, 'rb').read()
+            self._server.query(key, method=self._server._session.post, data=data)
+
+    def setArt(self, art):
+        """ Set the background artwork for a Plex object.
+        
+            Parameters:
+                art (:class:`~plexapi.media.Art`): The art object to select.
+        """
+        art.select()
+
+    def lockArt(self):
+        """ Lock the background artwork for a Plex object. """
+        return self._edit(**{'art.locked': 1})
+
+    def unlockArt(self):
+        """ Unlock the background artwork for a Plex object. """
+        return self._edit(**{'art.locked': 0})
+
+
+class BannerUrlMixin(object):
+    """ Mixin for Plex objects that can have a banner url. """
+
+    @property
+    def bannerUrl(self):
+        """ Return the banner url for the Plex object. """
+        banner = self.firstAttr('banner')
+        return self._server.url(banner, includeToken=True) if banner else None
+
+
+class BannerMixin(BannerUrlMixin):
+    """ Mixin for Plex objects that can have banners. """
+
+    def banners(self):
+        """ Returns list of available :class:`~plexapi.media.Banner` objects. """
+        return self.fetchItems('/library/metadata/%s/banners' % self.ratingKey, cls=media.Banner)
+
+    def uploadBanner(self, url=None, filepath=None):
+        """ Upload a banner from a url or filepath.
+        
+            Parameters:
+                url (str): The full URL to the image to upload.
+                filepath (str): The full file path the the image to upload.
+        """
+        if url:
+            key = '/library/metadata/%s/banners?url=%s' % (self.ratingKey, quote_plus(url))
+            self._server.query(key, method=self._server._session.post)
+        elif filepath:
+            key = '/library/metadata/%s/banners?' % self.ratingKey
+            data = open(filepath, 'rb').read()
+            self._server.query(key, method=self._server._session.post, data=data)
+
+    def setBanner(self, banner):
+        """ Set the banner for a Plex object.
+        
+            Parameters:
+                banner (:class:`~plexapi.media.Banner`): The banner object to select.
+        """
+        banner.select()
+
+    def lockBanner(self):
+        """ Lock the banner for a Plex object. """
+        return self._edit(**{'banner.locked': 1})
+
+    def unlockBanner(self):
+        """ Unlock the banner for a Plex object. """
+        return self._edit(**{'banner.locked': 0})
+
+
+class PosterUrlMixin(object):
+    """ Mixin for Plex objects that can have a poster url. """
+
+    @property
+    def thumbUrl(self):
+        """ Return the thumb url for the Plex object. """
+        thumb = self.firstAttr('thumb', 'parentThumb', 'grandparentThumb')
+        return self._server.url(thumb, includeToken=True) if thumb else None
+
+    @property
+    def posterUrl(self):
+        """ Alias to self.thumbUrl. """
+        return self.thumbUrl
+
+
+class PosterMixin(PosterUrlMixin):
+    """ Mixin for Plex objects that can have posters. """
+
+    def posters(self):
+        """ Returns list of available :class:`~plexapi.media.Poster` objects. """
+        return self.fetchItems('/library/metadata/%s/posters' % self.ratingKey, cls=media.Poster)
+
+    def uploadPoster(self, url=None, filepath=None):
+        """ Upload a poster from a url or filepath.
+
+            Parameters:
+                url (str): The full URL to the image to upload.
+                filepath (str): The full file path the the image to upload.
+        """
+        if url:
+            key = '/library/metadata/%s/posters?url=%s' % (self.ratingKey, quote_plus(url))
+            self._server.query(key, method=self._server._session.post)
+        elif filepath:
+            key = '/library/metadata/%s/posters?' % self.ratingKey
+            data = open(filepath, 'rb').read()
+            self._server.query(key, method=self._server._session.post, data=data)
+
+    def setPoster(self, poster):
+        """ Set the poster for a Plex object.
+        
+            Parameters:
+                poster (:class:`~plexapi.media.Poster`): The poster object to select.
+        """
+        poster.select()
+
+    def lockPoster(self):
+        """ Lock the poster for a Plex object. """
+        return self._edit(**{'thumb.locked': 1})
+
+    def unlockPoster(self):
+        """ Unlock the poster for a Plex object. """
+        return self._edit(**{'thumb.locked': 0})
+
+
+class ThemeUrlMixin(object):
+    """ Mixin for Plex objects that can have a theme url. """
+
+    @property
+    def themeUrl(self):
+        """ Return the theme url for the Plex object. """
+        theme = self.firstAttr('theme', 'parentTheme', 'grandparentTheme')
+        return self._server.url(theme, includeToken=True) if theme else None
+
+
+class ThemeMixin(ThemeUrlMixin):
+    """ Mixin for Plex objects that can have themes. """
+
+    def themes(self):
+        """ Returns list of available :class:`~plexapi.media.Theme` objects. """
+        return self.fetchItems('/library/metadata/%s/themes' % self.ratingKey, cls=media.Theme)
+
+    def uploadTheme(self, url=None, filepath=None):
+        """ Upload a theme from url or filepath.
+
+            Warning: Themes cannot be deleted using PlexAPI!
+
+            Parameters:
+                url (str): The full URL to the theme to upload.
+                filepath (str): The full file path to the theme to upload.
+        """
+        if url:
+            key = '/library/metadata/%s/themes?url=%s' % (self.ratingKey, quote_plus(url))
+            self._server.query(key, method=self._server._session.post)
+        elif filepath:
+            key = '/library/metadata/%s/themes?' % self.ratingKey
+            data = open(filepath, 'rb').read()
+            self._server.query(key, method=self._server._session.post, data=data)
+
+    def setTheme(self, theme):
+        raise NotImplementedError(
+            'Themes cannot be set through the API. '
+            'Re-upload the theme using "uploadTheme" to set it.'
+        )
+
+    def lockTheme(self):
+        """ Lock the theme for a Plex object. """
+        self._edit(**{'theme.locked': 1})
+
+    def unlockTheme(self):
+        """ Unlock the theme for a Plex object. """
+        self._edit(**{'theme.locked': 0})
+
+
+class EditFieldMixin(object):
+    """ Mixin for editing Plex object fields. """
+    
+    def editField(self, field, value, locked=True, **kwargs):
+        """ Edit the field of a Plex object. All field editing methods can be chained together.
+            Also see :func:`~plexapi.base.PlexPartialObject.batchEdits` for batch editing fields.
+        
+            Parameters:
+                field (str): The name of the field to edit.
+                value (str): The value to edit the field to.
+                locked (bool): True (default) to lock the field, False to unlock the field.
+
+            Example:
+
+                .. code-block:: python
+
+                    # Chaining multiple field edits with reloading
+                    Movie.editTitle('A New Title').editSummary('A new summary').editTagline('A new tagline').reload()
+
+        """
+        edits = {
+            '%s.value' % field: value or '',
+            '%s.locked' % field: 1 if locked else 0
+        }
+        edits.update(kwargs)
+        return self._edit(**edits)
+
+
+class ContentRatingMixin(EditFieldMixin):
+    """ Mixin for Plex objects that can have a content rating. """
+
+    def editContentRating(self, contentRating, locked=True):
+        """ Edit the content rating.
+
+            Parameters:
+                contentRating (str): The new value.
+                locked (bool): True (default) to lock the field, False to unlock the field.
+        """
+        return self.editField('contentRating', contentRating, locked=locked)
+
+
+class OriginallyAvailableMixin(EditFieldMixin):
+    """ Mixin for Plex objects that can have an originally available date. """
+
+    def editOriginallyAvailable(self, originallyAvailable, locked=True):
+        """ Edit the originally available date.
+
+            Parameters:
+                originallyAvailable (str or datetime): The new value (YYYY-MM-DD) or datetime object.
+                locked (bool): True (default) to lock the field, False to unlock the field.
+        """
+        if isinstance(originallyAvailable, datetime):
+            originallyAvailable = originallyAvailable.strftime('%Y-%m-%d')
+        return self.editField('originallyAvailableAt', originallyAvailable, locked=locked)
+
+
+class OriginalTitleMixin(EditFieldMixin):
+    """ Mixin for Plex objects that can have an original title. """
+
+    def editOriginalTitle(self, originalTitle, locked=True):
+        """ Edit the original title.
+
+            Parameters:
+                originalTitle (str): The new value.
+                locked (bool): True (default) to lock the field, False to unlock the field.
+        """
+        return self.editField('originalTitle', originalTitle, locked=locked)
+
+
+class SortTitleMixin(EditFieldMixin):
+    """ Mixin for Plex objects that can have a sort title. """
+
+    def editSortTitle(self, sortTitle, locked=True):
+        """ Edit the sort title.
+
+            Parameters:
+                sortTitle (str): The new value.
+                locked (bool): True (default) to lock the field, False to unlock the field.
+        """
+        return self.editField('titleSort', sortTitle, locked=locked)
+
+
+class StudioMixin(EditFieldMixin):
+    """ Mixin for Plex objects that can have a studio. """
+
+    def editStudio(self, studio, locked=True):
+        """ Edit the studio.
+
+            Parameters:
+                studio (str): The new value.
+                locked (bool): True (default) to lock the field, False to unlock the field.
+        """
+        return self.editField('studio', studio, locked=locked)
+
+
+class SummaryMixin(EditFieldMixin):
+    """ Mixin for Plex objects that can have a summary. """
+
+    def editSummary(self, summary, locked=True):
+        """ Edit the summary.
+
+            Parameters:
+                summary (str): The new value.
+                locked (bool): True (default) to lock the field, False to unlock the field.
+        """
+        return self.editField('summary', summary, locked=locked)
+
+
+class TaglineMixin(EditFieldMixin):
+    """ Mixin for Plex objects that can have a tagline. """
+
+    def editTagline(self, tagline, locked=True):
+        """ Edit the tagline.
+
+            Parameters:
+                tagline (str): The new value.
+                locked (bool): True (default) to lock the field, False to unlock the field.
+        """
+        return self.editField('tagline', tagline, locked=locked)
+
+
+class TitleMixin(EditFieldMixin):
+    """ Mixin for Plex objects that can have a title. """
+
+    def editTitle(self, title, locked=True):
+        """ Edit the title.
+
+            Parameters:
+                title (str): The new value.
+                locked (bool): True (default) to lock the field, False to unlock the field.
+        """
+        kwargs = {}
+        if self.TYPE == 'album':
+            # Editing album title also requires the artist ratingKey
+            kwargs['artist.id.value'] = self.parentRatingKey
+        return self.editField('title', title, locked=locked, **kwargs)
+
+
+class TrackArtistMixin(EditFieldMixin):
+    """ Mixin for Plex objects that can have a track artist. """
+
+    def editTrackArtist(self, trackArtist, locked=True):
+        """ Edit the track artist.
+
+            Parameters:
+                trackArtist (str): The new value.
+                locked (bool): True (default) to lock the field, False to unlock the field.
+        """
+        return self.editField('originalTitle', trackArtist, locked=locked)
+
+
+class TrackNumberMixin(EditFieldMixin):
+    """ Mixin for Plex objects that can have a track number. """
+
+    def editTrackNumber(self, trackNumber, locked=True):
+        """ Edit the track number.
+
+            Parameters:
+                trackNumber (int): The new value.
+                locked (bool): True (default) to lock the field, False to unlock the field.
+        """
+        return self.editField('index', trackNumber, locked=locked)
+
+
+class TrackDiscNumberMixin(EditFieldMixin):
+    """ Mixin for Plex objects that can have a track disc number. """
+
+    def editDiscNumber(self, discNumber, locked=True):
+        """ Edit the track disc number.
+
+            Parameters:
+                discNumber (int): The new value.
+                locked (bool): True (default) to lock the field, False to unlock the field.
+        """
+        return self.editField('parentIndex', discNumber, locked=locked)
+
+
+class PhotoCapturedTimeMixin(EditFieldMixin):
+    """ Mixin for Plex objects that can have a captured time. """
+
+    def editCapturedTime(self, capturedTime, locked=True):
+        """ Edit the photo captured time.
+
+            Parameters:
+                capturedTime (str or datetime): The new value (YYYY-MM-DD hh:mm:ss) or datetime object.
+                locked (bool): True (default) to lock the field, False to unlock the field.
+        """
+        if isinstance(capturedTime, datetime):
+            capturedTime = capturedTime.strftime('%Y-%m-%d %H:%M:%S')
+        return self.editField('originallyAvailableAt', capturedTime, locked=locked)
+
+
+class EditTagsMixin(object):
+    """ Mixin for editing Plex object tags. """
+
+    @deprecated('use "editTags" instead')
+    def _edit_tags(self, tag, items, locked=True, remove=False):
+        return self.editTags(tag, items, locked, remove)
+
+    def editTags(self, tag, items, locked=True, remove=False, **kwargs):
+        """ Edit the tags of a Plex object. All tag editing methods can be chained together.
+            Also see :func:`~plexapi.base.PlexPartialObject.batchEdits` for batch editing tags.
+
+            Parameters:
+                tag (str): Name of the tag to edit.
+                items (List<str>): List of tags to add or remove.
+                locked (bool): True (default) to lock the tags, False to unlock the tags.
+                remove (bool): True to remove the tags in items.
+
+            Example:
+
+                .. code-block:: python
+
+                    # Chaining multiple tag edits with reloading
+                    Show.addCollection('New Collection').removeGenre('Action').addLabel('Favorite').reload()
+
+        """
+        if not isinstance(items, list):
+            items = [items]
+
+        value = getattr(self, self._tagPlural(tag))
+        existing_tags = [t.tag for t in value if t and remove is False]
+        edits = self._tagHelper(self._tagSingular(tag), existing_tags + items, locked, remove)
+        edits.update(kwargs)
+        return self._edit(**edits)
+
+    @staticmethod
+    def _tagSingular(tag):
+        """ Return the singular name of a tag. """
+        if tag == 'countries':
+            return 'country'
+        elif tag == 'similar':
+            return 'similar'
+        elif tag[-1] == 's':
+            return tag[:-1]
+        return tag
+
+    @staticmethod
+    def _tagPlural(tag):
+        """ Return the plural name of a tag. """
+        if tag == 'country':
+            return 'countries'
+        elif tag == 'similar':
+            return 'similar'
+        elif tag[-1] != 's':
+            return tag + 's'
+        return tag
+
+    @staticmethod
+    def _tagHelper(tag, items, locked=True, remove=False):
+        """ Return a dict of the query parameters for editing a tag. """
+        if not isinstance(items, list):
+            items = [items]
+
+        data = {
+            '%s.locked' % tag: 1 if locked else 0
+        }
+
+        if remove:
+            tagname = '%s[].tag.tag-' % tag
+            data[tagname] = ','.join(items)
+        else:
+            for i, item in enumerate(items):
+                tagname = '%s[%s].tag.tag' % (tag, i)
+                data[tagname] = item
+
+        return data
+
+
+class CollectionMixin(EditTagsMixin):
     """ Mixin for Plex objects that can have collections. """
 
     def addCollection(self, collections, locked=True):
         """ Add a collection tag(s).
 
-           Parameters:
+            Parameters:
                 collections (list): List of strings.
                 locked (bool): True (default) to lock the field, False to unlock the field.
         """
-        self._edit_tags('collection', collections, locked=locked)
+        return self.editTags('collection', collections, locked=locked)
 
     def removeCollection(self, collections, locked=True):
         """ Remove a collection tag(s).
 
-           Parameters:
+            Parameters:
                 collections (list): List of strings.
                 locked (bool): True (default) to lock the field, False to unlock the field.
         """
-        self._edit_tags('collection', collections, locked=locked, remove=True)
+        return self.editTags('collection', collections, locked=locked, remove=True)
 
 
-class CountryMixin(object):
+class CountryMixin(EditTagsMixin):
     """ Mixin for Plex objects that can have countries. """
 
     def addCountry(self, countries, locked=True):
         """ Add a country tag(s).
 
-           Parameters:
+            Parameters:
                 countries (list): List of strings.
                 locked (bool): True (default) to lock the field, False to unlock the field.
         """
-        self._edit_tags('country', countries, locked=locked)
+        return self.editTags('country', countries, locked=locked)
 
     def removeCountry(self, countries, locked=True):
         """ Remove a country tag(s).
 
-           Parameters:
+            Parameters:
                 countries (list): List of strings.
                 locked (bool): True (default) to lock the field, False to unlock the field.
         """
-        self._edit_tags('country', countries, locked=locked, remove=True)
+        return self.editTags('country', countries, locked=locked, remove=True)
 
 
-class DirectorMixin(object):
+class DirectorMixin(EditTagsMixin):
     """ Mixin for Plex objects that can have directors. """
 
     def addDirector(self, directors, locked=True):
         """ Add a director tag(s).
 
-           Parameters:
+            Parameters:
                 directors (list): List of strings.
                 locked (bool): True (default) to lock the field, False to unlock the field.
         """
-        self._edit_tags('director', directors, locked=locked)
+        return self.editTags('director', directors, locked=locked)
 
     def removeDirector(self, directors, locked=True):
         """ Remove a director tag(s).
 
-           Parameters:
+            Parameters:
                 directors (list): List of strings.
                 locked (bool): True (default) to lock the field, False to unlock the field.
         """
-        self._edit_tags('director', directors, locked=locked, remove=True)
+        return self.editTags('director', directors, locked=locked, remove=True)
 
 
-class GenreMixin(object):
+class GenreMixin(EditTagsMixin):
     """ Mixin for Plex objects that can have genres. """
 
     def addGenre(self, genres, locked=True):
         """ Add a genre tag(s).
 
-           Parameters:
+            Parameters:
                 genres (list): List of strings.
                 locked (bool): True (default) to lock the field, False to unlock the field.
         """
-        self._edit_tags('genre', genres, locked=locked)
+        return self.editTags('genre', genres, locked=locked)
 
     def removeGenre(self, genres, locked=True):
         """ Remove a genre tag(s).
 
-           Parameters:
+            Parameters:
                 genres (list): List of strings.
                 locked (bool): True (default) to lock the field, False to unlock the field.
         """
-        self._edit_tags('genre', genres, locked=locked, remove=True)
+        return self.editTags('genre', genres, locked=locked, remove=True)
 
 
-class LabelMixin(object):
+class LabelMixin(EditTagsMixin):
     """ Mixin for Plex objects that can have labels. """
 
     def addLabel(self, labels, locked=True):
         """ Add a label tag(s).
 
-           Parameters:
+            Parameters:
                 labels (list): List of strings.
                 locked (bool): True (default) to lock the field, False to unlock the field.
         """
-        self._edit_tags('label', labels, locked=locked)
+        return self.editTags('label', labels, locked=locked)
 
     def removeLabel(self, labels, locked=True):
         """ Remove a label tag(s).
 
-           Parameters:
+            Parameters:
                 labels (list): List of strings.
                 locked (bool): True (default) to lock the field, False to unlock the field.
         """
-        self._edit_tags('label', labels, locked=locked, remove=True)
+        return self.editTags('label', labels, locked=locked, remove=True)
 
 
-class MoodMixin(object):
+class MoodMixin(EditTagsMixin):
     """ Mixin for Plex objects that can have moods. """
 
     def addMood(self, moods, locked=True):
         """ Add a mood tag(s).
 
-           Parameters:
+            Parameters:
                 moods (list): List of strings.
                 locked (bool): True (default) to lock the field, False to unlock the field.
         """
-        self._edit_tags('mood', moods, locked=locked)
+        return self.editTags('mood', moods, locked=locked)
 
     def removeMood(self, moods, locked=True):
         """ Remove a mood tag(s).
 
-           Parameters:
+            Parameters:
                 moods (list): List of strings.
                 locked (bool): True (default) to lock the field, False to unlock the field.
         """
-        self._edit_tags('mood', moods, locked=locked, remove=True)
+        return self.editTags('mood', moods, locked=locked, remove=True)
 
 
-class ProducerMixin(object):
+class ProducerMixin(EditTagsMixin):
     """ Mixin for Plex objects that can have producers. """
 
     def addProducer(self, producers, locked=True):
         """ Add a producer tag(s).
 
-           Parameters:
+            Parameters:
                 producers (list): List of strings.
                 locked (bool): True (default) to lock the field, False to unlock the field.
         """
-        self._edit_tags('producer', producers, locked=locked)
+        return self.editTags('producer', producers, locked=locked)
 
     def removeProducer(self, producers, locked=True):
         """ Remove a producer tag(s).
 
-           Parameters:
+            Parameters:
                 producers (list): List of strings.
                 locked (bool): True (default) to lock the field, False to unlock the field.
         """
-        self._edit_tags('producer', producers, locked=locked, remove=True)
+        return self.editTags('producer', producers, locked=locked, remove=True)
 
 
-class SimilarArtistMixin(object):
+class SimilarArtistMixin(EditTagsMixin):
     """ Mixin for Plex objects that can have similar artists. """
 
     def addSimilarArtist(self, artists, locked=True):
         """ Add a similar artist tag(s).
 
-           Parameters:
+            Parameters:
                 artists (list): List of strings.
                 locked (bool): True (default) to lock the field, False to unlock the field.
         """
-        self._edit_tags('similar', artists, locked=locked)
+        return self.editTags('similar', artists, locked=locked)
 
     def removeSimilarArtist(self, artists, locked=True):
         """ Remove a similar artist tag(s).
 
-           Parameters:
+            Parameters:
                 artists (list): List of strings.
                 locked (bool): True (default) to lock the field, False to unlock the field.
         """
-        self._edit_tags('similar', artists, locked=locked, remove=True)
+        return self.editTags('similar', artists, locked=locked, remove=True)
 
 
-class StyleMixin(object):
+class StyleMixin(EditTagsMixin):
     """ Mixin for Plex objects that can have styles. """
 
     def addStyle(self, styles, locked=True):
         """ Add a style tag(s).
 
-           Parameters:
+            Parameters:
                 styles (list): List of strings.
                 locked (bool): True (default) to lock the field, False to unlock the field.
         """
-        self._edit_tags('style', styles, locked=locked)
+        return self.editTags('style', styles, locked=locked)
 
     def removeStyle(self, styles, locked=True):
         """ Remove a style tag(s).
 
-           Parameters:
+            Parameters:
                 styles (list): List of strings.
                 locked (bool): True (default) to lock the field, False to unlock the field.
         """
-        self._edit_tags('style', styles, locked=locked, remove=True)
+        return self.editTags('style', styles, locked=locked, remove=True)
 
 
-class TagMixin(object):
+class TagMixin(EditTagsMixin):
     """ Mixin for Plex objects that can have tags. """
 
     def addTag(self, tags, locked=True):
         """ Add a tag(s).
 
-           Parameters:
+            Parameters:
                 tags (list): List of strings.
                 locked (bool): True (default) to lock the field, False to unlock the field.
         """
-        self._edit_tags('tag', tags, locked=locked)
+        return self.editTags('tag', tags, locked=locked)
 
     def removeTag(self, tags, locked=True):
         """ Remove a tag(s).
 
-           Parameters:
+            Parameters:
                 tags (list): List of strings.
                 locked (bool): True (default) to lock the field, False to unlock the field.
         """
-        self._edit_tags('tag', tags, locked=locked, remove=True)
+        return self.editTags('tag', tags, locked=locked, remove=True)
 
 
-class WriterMixin(object):
+class WriterMixin(EditTagsMixin):
     """ Mixin for Plex objects that can have writers. """
 
     def addWriter(self, writers, locked=True):
         """ Add a writer tag(s).
 
-           Parameters:
+            Parameters:
                 writers (list): List of strings.
                 locked (bool): True (default) to lock the field, False to unlock the field.
         """
-        self._edit_tags('writer', writers, locked=locked)
+        return self.editTags('writer', writers, locked=locked)
 
     def removeWriter(self, writers, locked=True):
         """ Remove a writer tag(s).
 
-           Parameters:
+            Parameters:
                 writers (list): List of strings.
                 locked (bool): True (default) to lock the field, False to unlock the field.
         """
-        self._edit_tags('writer', writers, locked=locked, remove=True)
+        return self.editTags('writer', writers, locked=locked, remove=True)
 
 
-class SmartFilterMixin(object):
-    """ Mixing for Plex objects that can have smart filters. """
+class WatchlistMixin(object):
+    """ Mixin for Plex objects that can be added to a user's watchlist. """
 
-    def _parseFilters(self, content):
-        """ Parse the content string and returns the filter dict. """
-        content = urlsplit(unquote(content))
-        filters = {}
-        filterOp = 'and'
-        filterGroups = [[]]
-        
-        for key, value in parse_qsl(content.query):
-            # Move = sign to key when operator is ==
-            if value.startswith('='):
-                key += '='
-                value = value[1:]
+    def onWatchlist(self, account=None):
+        """ Returns True if the item is on the user's watchlist.
+            Also see :func:`~plexapi.myplex.MyPlexAccount.onWatchlist`.
 
-            if key == 'includeGuids':
-                filters['includeGuids'] = int(value)
-            elif key == 'type':
-                filters['libtype'] = utils.reverseSearchType(value)
-            elif key == 'sort':
-                filters['sort'] = value.split(',')
-            elif key == 'limit':
-                filters['limit'] = int(value)
-            elif key == 'push':
-                filterGroups[-1].append([])
-                filterGroups.append(filterGroups[-1][-1])
-            elif key == 'and':
-                filterOp = 'and'
-            elif key == 'or':
-                filterOp = 'or'
-            elif key == 'pop':
-                filterGroups[-1].insert(0, filterOp)
-                filterGroups.pop()
-            else:
-                filterGroups[-1].append({key: value})
-        
-        if filterGroups:
-            filters['filters'] = self._formatFilterGroups(filterGroups.pop())
-        return filters
-    
-    def _formatFilterGroups(self, groups):
-        """ Formats the filter groups into the advanced search rules. """
-        if len(groups) == 1 and isinstance(groups[0], list):
-            groups = groups.pop()
+            Parameters:
+                account (:class:`~plexapi.myplex.MyPlexAccount`, optional): Account to check item on the watchlist.
+                   Note: This is required if you are not connected to a Plex server instance using the admin account.
+        """
+        try:
+            account = account or self._server.myPlexAccount()
+        except AttributeError:
+            account = self._server
+        return account.onWatchlist(self)
 
-        filterOp = 'and'
-        rules = []
+    def addToWatchlist(self, account=None):
+        """ Add this item to the specified user's watchlist.
+            Also see :func:`~plexapi.myplex.MyPlexAccount.addToWatchlist`.
 
-        for g in groups:
-            if isinstance(g, list):
-                rules.append(self._formatFilterGroups(g))
-            elif isinstance(g, dict):
-                rules.append(g)
-            elif g in {'and', 'or'}:
-                filterOp = g
+            Parameters:
+                account (:class:`~plexapi.myplex.MyPlexAccount`, optional): Account to add item to the watchlist.
+                   Note: This is required if you are not connected to a Plex server instance using the admin account.
+        """
+        try:
+            account = account or self._server.myPlexAccount()
+        except AttributeError:
+            account = self._server
+        account.addToWatchlist(self)
 
-        return {filterOp: rules}
+    def removeFromWatchlist(self, account=None):
+        """ Remove this item from the specified user's watchlist.
+            Also see :func:`~plexapi.myplex.MyPlexAccount.removeFromWatchlist`.
+
+            Parameters:
+                account (:class:`~plexapi.myplex.MyPlexAccount`, optional): Account to remove item from the watchlist.
+                   Note: This is required if you are not connected to a Plex server instance using the admin account.
+        """
+        try:
+            account = account or self._server.myPlexAccount()
+        except AttributeError:
+            account = self._server
+        account.removeFromWatchlist(self)
+
+    def streamingServices(self, account=None):
+        """ Return a list of :class:`~plexapi.media.Availability`
+            objects for the available streaming services for this item.
+
+            Parameters:
+                account (:class:`~plexapi.myplex.MyPlexAccount`, optional): Account used to retrieve availability.
+                   Note: This is required if you are not connected to a Plex server instance using the admin account.
+        """
+        try:
+            account = account or self._server.myPlexAccount()
+        except AttributeError:
+            account = self._server
+        ratingKey = self.guid.rsplit('/', 1)[-1]
+        data = account.query(f"{account.METADATA}/library/metadata/{ratingKey}/availabilities")
+        return self.findItems(data)
diff --git a/lib/plexapi/myplex.py b/lib/plexapi/myplex.py
index 312050a9..a05a74bd 100644
--- a/lib/plexapi/myplex.py
+++ b/lib/plexapi/myplex.py
@@ -1,5 +1,6 @@
 # -*- coding: utf-8 -*-
 import copy
+import html
 import threading
 import time
 from xml.etree import ElementTree
@@ -52,7 +53,7 @@ class MyPlexAccount(PlexObject):
             roles: (List<str>) Lit of account roles. Plexpass membership listed here.
             scrobbleTypes (str): Description
             secure (bool): Description
-            subscriptionActive (bool): True if your subsctiption is active.
+            subscriptionActive (bool): True if your subscription is active.
             subscriptionFeatures: (List<str>) List of features allowed on your subscription.
             subscriptionPlan (str): Name of subscription plan.
             subscriptionStatus (str): String representation of `subscriptionActive`.
@@ -72,14 +73,12 @@ class MyPlexAccount(PlexObject):
     REMOVEHOMEUSER = 'https://plex.tv/api/home/users/{userId}'                                  # delete
     SIGNIN = 'https://plex.tv/users/sign_in.xml'                                                # get with auth
     WEBHOOKS = 'https://plex.tv/api/v2/user/webhooks'                                           # get, post with data
-    OPTOUTS = 'https://plex.tv/api/v2/user/%(userUUID)s/settings/opt_outs'                      # get
+    OPTOUTS = 'https://plex.tv/api/v2/user/{userUUID}/settings/opt_outs'                        # get
     LINK = 'https://plex.tv/api/v2/pins/link'                                                   # put
     # Hub sections
-    VOD = 'https://vod.provider.plex.tv/'                                                       # get
-    WEBSHOWS = 'https://webshows.provider.plex.tv/'                                             # get
-    NEWS = 'https://news.provider.plex.tv/'                                                     # get
-    PODCASTS = 'https://podcasts.provider.plex.tv/'                                             # get
-    MUSIC = 'https://music.provider.plex.tv/'                                                   # get
+    VOD = 'https://vod.provider.plex.tv'                                                        # get
+    MUSIC = 'https://music.provider.plex.tv'                                                    # get
+    METADATA = 'https://metadata.provider.plex.tv'
     # Key may someday switch to the following url. For now the current value works.
     # https://plex.tv/api/v2/user?X-Plex-Token={token}&X-Plex-Client-Identifier={clientId}
     key = 'https://plex.tv/users/account'
@@ -182,6 +181,8 @@ class MyPlexAccount(PlexObject):
                 raise NotFound(message)
             else:
                 raise BadRequest(message)
+        if headers.get('Accept') == 'application/json':
+            return response.json()
         data = response.text.encode('utf8')
         return ElementTree.fromstring(data) if data.strip() else None
 
@@ -228,7 +229,7 @@ class MyPlexAccount(PlexObject):
                     of the user to be added.
                 server (:class:`~plexapi.server.PlexServer`): `PlexServer` object, or machineIdentifier
                     containing the library sections to share.
-                sections (List<:class:`~plexapi.library.LibrarySection`>): List of `LibrarySection` objecs, or names
+                sections (List<:class:`~plexapi.library.LibrarySection`>): List of `LibrarySection` objects, or names
                     to be shared (default None). `sections` must be defined in order to update shared libraries.
                 allowSync (Bool): Set True to allow user to sync content.
                 allowCameraUpload (Bool): Set True to allow user to upload photos.
@@ -268,7 +269,7 @@ class MyPlexAccount(PlexObject):
                     of the user to be added.
                 server (:class:`~plexapi.server.PlexServer`): `PlexServer` object, or machineIdentifier
                     containing the library sections to share.
-                sections (List<:class:`~plexapi.library.LibrarySection`>): List of `LibrarySection` objecs, or names
+                sections (List<:class:`~plexapi.library.LibrarySection`>): List of `LibrarySection` objects, or names
                     to be shared (default None). `sections` must be defined in order to update shared libraries.
                 allowSync (Bool): Set True to allow user to sync content.
                 allowCameraUpload (Bool): Set True to allow user to upload photos.
@@ -317,7 +318,7 @@ class MyPlexAccount(PlexObject):
                     of the user to be added.
                 server (:class:`~plexapi.server.PlexServer`): `PlexServer` object, or machineIdentifier
                     containing the library sections to share.
-                sections (List<:class:`~plexapi.library.LibrarySection`>): List of `LibrarySection` objecs, or names
+                sections (List<:class:`~plexapi.library.LibrarySection`>): List of `LibrarySection` objects, or names
                     to be shared (default None). `sections` must be defined in order to update shared libraries.
                 allowSync (Bool): Set True to allow user to sync content.
                 allowCameraUpload (Bool): Set True to allow user to upload photos.
@@ -420,7 +421,7 @@ class MyPlexAccount(PlexObject):
                     of the user to be updated.
                 server (:class:`~plexapi.server.PlexServer`): `PlexServer` object, or machineIdentifier
                     containing the library sections to share.
-                sections (List<:class:`~plexapi.library.LibrarySection`>): List of `LibrarySection` objecs, or names
+                sections (List<:class:`~plexapi.library.LibrarySection`>): List of `LibrarySection` objects, or names
                     to be shared (default None). `sections` must be defined in order to update shared libraries.
                 removeSections (Bool): Set True to remove all shares. Supersedes sections.
                 allowSync (Bool): Set True to allow user to sync content.
@@ -565,7 +566,7 @@ class MyPlexAccount(PlexObject):
         """ Converts friend filters to a string representation for transport. """
         values = []
         for key, vals in filterDict.items():
-            if key not in ('contentRating', 'label'):
+            if key not in ('contentRating', 'label', 'contentRating!', 'label!'):
                 raise BadRequest('Unknown filter key: %s', key)
             values.append('%s=%s' % (key, '%2C'.join(vals)))
         return '|'.join(values)
@@ -614,7 +615,7 @@ class MyPlexAccount(PlexObject):
                 clientId (str): an identifier of a client to query SyncItems for.
 
             If both `client` and `clientId` provided the client would be preferred.
-            If neither `client` nor `clientId` provided the clientId would be set to current clients`s identifier.
+            If neither `client` nor `clientId` provided the clientId would be set to current clients's identifier.
         """
         if client:
             clientId = client.clientIdentifier
@@ -635,14 +636,14 @@ class MyPlexAccount(PlexObject):
                 sync_item (:class:`~plexapi.sync.SyncItem`): prepared SyncItem object with all fields set.
 
             If both `client` and `clientId` provided the client would be preferred.
-            If neither `client` nor `clientId` provided the clientId would be set to current clients`s identifier.
+            If neither `client` nor `clientId` provided the clientId would be set to current clients's identifier.
 
             Returns:
                 :class:`~plexapi.sync.SyncItem`: an instance of created syncItem.
 
             Raises:
-                :exc:`~plexapi.exceptions.BadRequest`: When client with provided clientId wasn`t found.
-                :exc:`~plexapi.exceptions.BadRequest`: Provided client doesn`t provides `sync-target`.
+                :exc:`~plexapi.exceptions.BadRequest`: When client with provided clientId wasn't found.
+                :exc:`~plexapi.exceptions.BadRequest`: Provided client doesn't provides `sync-target`.
         """
         if not client and not clientId:
             clientId = X_PLEX_IDENTIFIER
@@ -657,7 +658,7 @@ class MyPlexAccount(PlexObject):
                 raise BadRequest('Unable to find client by clientId=%s', clientId)
 
         if 'sync-target' not in client.provides:
-            raise BadRequest('Received client doesn`t provides sync-target')
+            raise BadRequest("Received client doesn't provides sync-target")
 
         params = {
             'SyncItem[title]': sync_item.title,
@@ -698,6 +699,7 @@ class MyPlexAccount(PlexObject):
 
     def history(self, maxresults=9999999, mindate=None):
         """ Get Play History for all library sections on all servers for the owner.
+
             Parameters:
                 maxresults (int): Only return the specified number of results (optional).
                 mindate (datetime): Min datetime to return results from.
@@ -709,47 +711,155 @@ class MyPlexAccount(PlexObject):
             hist.extend(conn.history(maxresults=maxresults, mindate=mindate, accountID=1))
         return hist
 
+    def onlineMediaSources(self):
+        """ Returns a list of user account Online Media Sources settings :class:`~plexapi.myplex.AccountOptOut`
+        """
+        url = self.OPTOUTS.format(userUUID=self.uuid)
+        elem = self.query(url)
+        return self.findItems(elem, cls=AccountOptOut, etag='optOut')
+
     def videoOnDemand(self):
         """ Returns a list of VOD Hub items :class:`~plexapi.library.Hub`
         """
-        req = requests.get(self.VOD + 'hubs/', headers={'X-Plex-Token': self._token})
-        elem = ElementTree.fromstring(req.text)
-        return self.findItems(elem)
-
-    def webShows(self):
-        """ Returns a list of Webshow Hub items :class:`~plexapi.library.Hub`
-        """
-        req = requests.get(self.WEBSHOWS + 'hubs/', headers={'X-Plex-Token': self._token})
-        elem = ElementTree.fromstring(req.text)
-        return self.findItems(elem)
-
-    def news(self):
-        """ Returns a list of News Hub items :class:`~plexapi.library.Hub`
-        """
-        req = requests.get(self.NEWS + 'hubs/sections/all', headers={'X-Plex-Token': self._token})
-        elem = ElementTree.fromstring(req.text)
-        return self.findItems(elem)
-
-    def podcasts(self):
-        """ Returns a list of Podcasts Hub items :class:`~plexapi.library.Hub`
-        """
-        req = requests.get(self.PODCASTS + 'hubs/', headers={'X-Plex-Token': self._token})
-        elem = ElementTree.fromstring(req.text)
-        return self.findItems(elem)
+        data = self.query(f'{self.VOD}/hubs')
+        return self.findItems(data)
 
     def tidal(self):
         """ Returns a list of tidal Hub items :class:`~plexapi.library.Hub`
         """
-        req = requests.get(self.MUSIC + 'hubs/', headers={'X-Plex-Token': self._token})
-        elem = ElementTree.fromstring(req.text)
-        return self.findItems(elem)
+        data = self.query(f'{self.MUSIC}/hubs')
+        return self.findItems(data)
+
+    def watchlist(self, filter=None, sort=None, libtype=None, **kwargs):
+        """ Returns a list of :class:`~plexapi.video.Movie` and :class:`~plexapi.video.Show` items in the user's watchlist.
+            Note: The objects returned are from Plex's online metadata. To get the matching item on a Plex server,
+            search for the media using the guid.
+
+            Parameters:
+                filter (str, optional): 'available' or 'released' to only return items that are available or released,
+                    otherwise return all items.
+                sort (str, optional): In the format ``field:dir``. Available fields are ``watchlistedAt`` (Added At),
+                    ``titleSort`` (Title), ``originallyAvailableAt`` (Release Date), or ``rating`` (Critic Rating).
+                    ``dir`` can be ``asc`` or ``desc``.
+                libtype (str, optional): 'movie' or 'show' to only return movies or shows, otherwise return all items.
+                **kwargs (dict): Additional custom filters to apply to the search results.
+
+
+            Example:
+
+                .. code-block:: python
+
+                    # Watchlist for released movies sorted by critic rating in descending order
+                    watchlist = account.watchlist(filter='released', sort='rating:desc', libtype='movie')
+                    item = watchlist[0]  # First item in the watchlist
+
+                    # Search for the item on a Plex server
+                    result = plex.library.search(guid=item.guid, libtype=item.type)
 
-    def onlineMediaSources(self):
-        """ Returns a list of user account Online Media Sources settings :class:`~plexapi.myplex.AccountOptOut`
         """
-        url = self.OPTOUTS % {'userUUID': self.uuid}
-        elem = self.query(url)
-        return self.findItems(elem, cls=AccountOptOut, etag='optOut')
+        params = {
+            'includeCollections': 1,
+            'includeExternalMedia': 1
+        }
+
+        if not filter:
+            filter = 'all'
+        if sort:
+            params['sort'] = sort
+        if libtype:
+            params['type'] = utils.searchType(libtype)
+
+        params.update(kwargs)
+        data = self.query(f'{self.METADATA}/library/sections/watchlist/{filter}', params=params)
+        return self.findItems(data)
+
+    def onWatchlist(self, item):
+        """ Returns True if the item is on the user's watchlist.
+
+            Parameters:
+                item (:class:`~plexapi.video.Movie` or :class:`~plexapi.video.Show`): Item to check
+                    if it is on the user's watchlist.
+        """
+        ratingKey = item.guid.rsplit('/', 1)[-1]
+        data = self.query(f"{self.METADATA}/library/metadata/{ratingKey}/userState")
+        return bool(data.find('UserState').attrib.get('watchlistedAt'))
+
+    def addToWatchlist(self, items):
+        """ Add media items to the user's watchlist
+
+            Parameters:
+                items (List): List of :class:`~plexapi.video.Movie` or :class:`~plexapi.video.Show`
+                    objects to be added to the watchlist.
+
+            Raises:
+                :exc:`~plexapi.exceptions.BadRequest`: When trying to add invalid or existing
+                    media to the watchlist.
+        """
+        if not isinstance(items, list):
+            items = [items]
+        
+        for item in items:
+            if self.onWatchlist(item):
+                raise BadRequest('"%s" is already on the watchlist' % item.title)
+            ratingKey = item.guid.rsplit('/', 1)[-1]
+            self.query(f'{self.METADATA}/actions/addToWatchlist?ratingKey={ratingKey}', method=self._session.put)
+
+    def removeFromWatchlist(self, items):
+        """ Remove media items from the user's watchlist
+
+            Parameters:
+                items (List): List of :class:`~plexapi.video.Movie` or :class:`~plexapi.video.Show`
+                    objects to be added to the watchlist.
+
+            Raises:
+                :exc:`~plexapi.exceptions.BadRequest`: When trying to remove invalid or non-existing
+                    media to the watchlist.
+        """
+        if not isinstance(items, list):
+            items = [items]
+        
+        for item in items:
+            if not self.onWatchlist(item):
+                raise BadRequest('"%s" is not on the watchlist' % item.title)
+            ratingKey = item.guid.rsplit('/', 1)[-1]
+            self.query(f'{self.METADATA}/actions/removeFromWatchlist?ratingKey={ratingKey}', method=self._session.put)
+
+    def searchDiscover(self, query, limit=30):
+        """ Search for movies and TV shows in Discover.
+            Returns a list of :class:`~plexapi.video.Movie` and :class:`~plexapi.video.Show` objects.
+
+            Parameters:
+                query (str): Search query.
+                limit (int, optional): Limit to the specified number of results. Default 30.
+        """
+        headers = {
+            'Accept': 'application/json'
+        }
+        params = {
+            'query': query,
+            'limit ': limit,
+            'searchTypes': 'movies,tv',
+            'includeMetadata': 1
+        }
+
+        data = self.query(f'{self.METADATA}/library/search', headers=headers, params=params)
+        searchResults = data['MediaContainer'].get('SearchResult', [])
+
+        results = []
+        for result in searchResults:
+            metadata = result['Metadata']
+            type = metadata['type']
+            if type == 'movie':
+                tag = 'Video'
+            elif type == 'show':
+                tag = 'Directory'
+            else:
+                continue
+            attrs = ''.join(f'{k}="{html.escape(str(v))}" ' for k, v in metadata.items())
+            xml = f'<{tag} {attrs}/>'
+            results.append(self._manuallyLoadXML(xml))
+
+        return results
 
     def link(self, pin):
         """ Link a device to the account using a pin code.
@@ -790,7 +900,7 @@ class MyPlexUser(PlexObject):
             restricted (str): Unknown.
             servers (List<:class:`~plexapi.myplex.<MyPlexServerShare`>)): Servers shared with the user.
             thumb (str): Link to the users avatar.
-            title (str): Seems to be an aliad for username.
+            title (str): Seems to be an alias for username.
             username (str): User's username.
     """
     TAG = 'User'
@@ -1103,7 +1213,7 @@ class MyPlexResource(PlexObject):
                 :exc:`~plexapi.exceptions.NotFound`: When unable to connect to any addresses for this resource.
         """
         connections = self.preferred_connections(ssl, timeout, locations, schemes)
-        # Try connecting to all known resource connections in parellel, but
+        # Try connecting to all known resource connections in parallel, but
         # only return the first server (in order) that provides a response.
         cls = PlexServer if 'server' in self.provides else PlexClient
         listargs = [[cls, url, self.accessToken, timeout] for url in connections]
@@ -1215,7 +1325,7 @@ class MyPlexDevice(PlexObject):
         """ Returns an instance of :class:`~plexapi.sync.SyncList` for current device.
 
             Raises:
-                :exc:`~plexapi.exceptions.BadRequest`: when the device doesn`t provides `sync-target`.
+                :exc:`~plexapi.exceptions.BadRequest`: when the device doesn't provides `sync-target`.
         """
         if 'sync-target' not in self.provides:
             raise BadRequest('Requested syncList for device which do not provides sync-target')
diff --git a/lib/plexapi/photo.py b/lib/plexapi/photo.py
index c24d7fb1..cb6329ea 100644
--- a/lib/plexapi/photo.py
+++ b/lib/plexapi/photo.py
@@ -5,11 +5,21 @@ from urllib.parse import quote_plus
 from plexapi import media, utils, video
 from plexapi.base import Playable, PlexPartialObject
 from plexapi.exceptions import BadRequest
-from plexapi.mixins import ArtUrlMixin, ArtMixin, PosterUrlMixin, PosterMixin, RatingMixin, TagMixin
+from plexapi.mixins import (
+    RatingMixin,
+    ArtUrlMixin, ArtMixin, PosterUrlMixin, PosterMixin,
+    SortTitleMixin, SummaryMixin, TitleMixin, PhotoCapturedTimeMixin,
+    TagMixin
+)
 
 
 @utils.registerPlexObject
-class Photoalbum(PlexPartialObject, ArtMixin, PosterMixin, RatingMixin):
+class Photoalbum(
+    PlexPartialObject,
+    RatingMixin,
+    ArtMixin, PosterMixin,
+    SortTitleMixin, SummaryMixin, TitleMixin
+):
     """ Represents a single Photoalbum (collection of photos).
 
         Attributes:
@@ -33,11 +43,12 @@ class Photoalbum(PlexPartialObject, ArtMixin, PosterMixin, RatingMixin):
             title (str): Name of the photo album. (Trip to Disney World)
             titleSort (str): Title to use when sorting (defaults to title).
             type (str): 'photo'
-            updatedAt (datatime): Datetime the photo album was updated.
+            updatedAt (datetime): Datetime the photo album was updated.
             userRating (float): Rating of the photo album (0.0 - 10.0) equaling (0 stars - 5 stars).
     """
     TAG = 'Directory'
     TYPE = 'photo'
+    _searchType = 'photoalbum'
 
     def _loadData(self, data):
         """ Load attribute values from Plex XML response. """
@@ -109,7 +120,7 @@ class Photoalbum(PlexPartialObject, ArtMixin, PosterMixin, RatingMixin):
         return self.episode(title)
 
     def download(self, savepath=None, keep_original_name=False, subfolders=False):
-        """ Download all photos and clips from the photo ablum. See :func:`~plexapi.base.Playable.download` for details.
+        """ Download all photos and clips from the photo album. See :func:`~plexapi.base.Playable.download` for details.
 
             Parameters:
                 savepath (str): Defaults to current working dir.
@@ -131,7 +142,13 @@ class Photoalbum(PlexPartialObject, ArtMixin, PosterMixin, RatingMixin):
 
 
 @utils.registerPlexObject
-class Photo(PlexPartialObject, Playable, ArtUrlMixin, PosterUrlMixin, RatingMixin, TagMixin):
+class Photo(
+    PlexPartialObject, Playable,
+    RatingMixin,
+    ArtUrlMixin, PosterUrlMixin,
+    PhotoCapturedTimeMixin, SortTitleMixin, SummaryMixin, TitleMixin,
+    TagMixin
+):
     """ Represents a single Photo.
 
         Attributes:
@@ -164,7 +181,7 @@ class Photo(PlexPartialObject, Playable, ArtUrlMixin, PosterUrlMixin, RatingMixi
             title (str): Name of the photo.
             titleSort (str): Title to use when sorting (defaults to title).
             type (str): 'photo'
-            updatedAt (datatime): Datetime the photo was updated.
+            updatedAt (datetime): Datetime the photo was updated.
             userRating (float): Rating of the photo (0.0 - 10.0) equaling (0 stars - 5 stars).
             year (int): Year the photo was taken.
     """
@@ -223,7 +240,7 @@ class Photo(PlexPartialObject, Playable, ArtUrlMixin, PosterUrlMixin, RatingMixi
         elif self.parentKey:
             return self._server.library.sectionByID(self.photoalbum().librarySectionID)
         else:
-            raise BadRequest('Unable to get section for photo, can`t find librarySectionID')
+            raise BadRequest("Unable to get section for photo, can't find librarySectionID")
 
     @property
     def locations(self):
diff --git a/lib/plexapi/playlist.py b/lib/plexapi/playlist.py
index ee4694d2..5241e261 100644
--- a/lib/plexapi/playlist.py
+++ b/lib/plexapi/playlist.py
@@ -6,13 +6,17 @@ from plexapi import media, utils
 from plexapi.base import Playable, PlexPartialObject
 from plexapi.exceptions import BadRequest, NotFound, Unsupported
 from plexapi.library import LibrarySection
-from plexapi.mixins import ArtMixin, PosterMixin, SmartFilterMixin
+from plexapi.mixins import SmartFilterMixin, ArtMixin, PosterMixin
 from plexapi.playqueue import PlayQueue
 from plexapi.utils import deprecated
 
 
 @utils.registerPlexObject
-class Playlist(PlexPartialObject, Playable, ArtMixin, PosterMixin, SmartFilterMixin):
+class Playlist(
+    PlexPartialObject, Playable,
+    SmartFilterMixin,
+    ArtMixin, PosterMixin
+):
     """ Represents a single Playlist.
 
         Attributes:
@@ -39,7 +43,7 @@ class Playlist(PlexPartialObject, Playable, ArtMixin, PosterMixin, SmartFilterMi
             summary (str): Summary of the playlist.
             title (str): Name of the playlist.
             type (str): 'playlist'
-            updatedAt (datatime): Datetime the playlist was updated.
+            updatedAt (datetime): Datetime the playlist was updated.
     """
     TAG = 'Playlist'
     TYPE = 'playlist'
diff --git a/lib/plexapi/server.py b/lib/plexapi/server.py
index cb672197..e5c36ad6 100644
--- a/lib/plexapi/server.py
+++ b/lib/plexapi/server.py
@@ -314,7 +314,7 @@ class PlexServer(PlexObject):
     def myPlexAccount(self):
         """ Returns a :class:`~plexapi.myplex.MyPlexAccount` object using the same
             token to access this server. If you are not the owner of this PlexServer
-            you're likley to recieve an authentication error calling this.
+            you're likely to receive an authentication error calling this.
         """
         if self._myPlexAccount is None:
             from plexapi.myplex import MyPlexAccount
@@ -323,7 +323,7 @@ class PlexServer(PlexObject):
 
     def _myPlexClientPorts(self):
         """ Sometimes the PlexServer does not properly advertise port numbers required
-            to connect. This attemps to look up device port number from plex.tv.
+            to connect. This attempts to look up device port number from plex.tv.
             See issue #126: Make PlexServer.clients() more user friendly.
               https://github.com/pkkid/python-plexapi/issues/126
         """
@@ -393,7 +393,6 @@ class PlexServer(PlexObject):
         """
         if isinstance(path, Path):
             path = path.path
-        path = os.path.normpath(path)
         paths = [p.path for p in self.browse(os.path.dirname(path), includeFiles=False)]
         return path in paths
 
@@ -524,14 +523,39 @@ class PlexServer(PlexObject):
         filepath = utils.download(url, self._token, None, savepath, self._session, unpack=unpack)
         return filepath
 
+    def butlerTasks(self):
+        """ Return a list of :class:`~plexapi.base.ButlerTask` objects. """
+        return self.fetchItems('/butler')
+
+    def runButlerTask(self, task):
+        """ Manually run a butler task immediately instead of waiting for the scheduled task to run.
+            Note: The butler task is run asynchronously. Check Plex Web to monitor activity.
+        
+            Parameters:
+                task (str): The name of the task to run. (e.g. 'BackupDatabase')
+
+            Example:
+
+                .. code-block:: python
+
+                    availableTasks = [task.name for task in plex.butlerTasks()]
+                    print("Available butler tasks:", availableTasks)
+        """
+        validTasks = [task.name for task in self.butlerTasks()]
+        if task not in validTasks:
+            raise BadRequest(
+                f'Invalid butler task: {task}. Available tasks are: {validTasks}'
+            )
+        self.query(f'/butler/{task}', method=self._session.post)
+
     @deprecated('use "checkForUpdate" instead')
     def check_for_update(self, force=True, download=False):
-        return self.checkForUpdate()
+        return self.checkForUpdate(force=force, download=download)
 
     def checkForUpdate(self, force=True, download=False):
         """ Returns a :class:`~plexapi.base.Release` object containing release info.
 
-           Parameters:
+            Parameters:
                 force (bool): Force server to check for new releases
                 download (bool): Download if a update is available.
         """
@@ -730,7 +754,7 @@ class PlexServer(PlexObject):
         return self.fetchItems('/transcode/sessions')
 
     def startAlertListener(self, callback=None):
-        """ Creates a websocket connection to the Plex Server to optionally recieve
+        """ Creates a websocket connection to the Plex Server to optionally receive
             notifications. These often include messages from Plex about media scans
             as well as updates to currently running Transcode Sessions.
 
@@ -738,7 +762,7 @@ class PlexServer(PlexObject):
             >> pip install websocket-client
 
             Parameters:
-                callback (func): Callback function to call on recieved messages.
+                callback (func): Callback function to call on received messages.
 
             Raises:
                 :exc:`~plexapi.exception.Unsupported`: Websocket-client not installed.
@@ -1078,7 +1102,7 @@ class SystemDevice(PlexObject):
         Attributes:
             TAG (str): 'Device'
             clientIdentifier (str): The unique identifier for the device.
-            createdAt (datatime): Datetime the device was created.
+            createdAt (datetime): Datetime the device was created.
             id (int): The ID of the device (not the same as :class:`~plexapi.myplex.MyPlexDevice` ID).
             key (str): API URL (/devices/<id>)
             name (str): The name of the device.
@@ -1102,11 +1126,11 @@ class StatisticsBandwidth(PlexObject):
         Attributes:
             TAG (str): 'StatisticsBandwidth'
             accountID (int): The associated :class:`~plexapi.server.SystemAccount` ID.
-            at (datatime): Datetime of the bandwidth data.
-            bytes (int): The total number of bytes for the specified timespan.
+            at (datetime): Datetime of the bandwidth data.
+            bytes (int): The total number of bytes for the specified time span.
             deviceID (int): The associated :class:`~plexapi.server.SystemDevice` ID.
-            lan (bool): True or False wheter the bandwidth is local or remote.
-            timespan (int): The timespan for the bandwidth data.
+            lan (bool): True or False whether the bandwidth is local or remote.
+            timespan (int): The time span for the bandwidth data.
                 1: months, 2: weeks, 3: days, 4: hours, 6: seconds.
 
     """
@@ -1143,12 +1167,12 @@ class StatisticsResources(PlexObject):
 
         Attributes:
             TAG (str): 'StatisticsResources'
-            at (datatime): Datetime of the resource data.
+            at (datetime): Datetime of the resource data.
             hostCpuUtilization (float): The system CPU usage %.
             hostMemoryUtilization (float): The Plex Media Server CPU usage %.
             processCpuUtilization (float): The system RAM usage %.
             processMemoryUtilization (float): The Plex Media Server RAM usage %.
-            timespan (int): The timespan for the resource data (6: seconds).
+            timespan (int): The time span for the resource data (6: seconds).
     """
     TAG = 'StatisticsResources'
 
@@ -1166,3 +1190,28 @@ class StatisticsResources(PlexObject):
             self.__class__.__name__,
             self._clean(int(self.at.timestamp()))
         ] if p])
+
+
+@utils.registerPlexObject
+class ButlerTask(PlexObject):
+    """ Represents a single scheduled butler task.
+    
+        Attributes:
+            TAG (str): 'ButlerTask'
+            description (str): The description of the task.
+            enabled (bool): Whether the task is enabled.
+            interval (int): The interval the task is run in days.
+            name (str): The name of the task.
+            scheduleRandomized (bool): Whether the task schedule is randomized.
+            title (str): The title of the task.
+    """
+    TAG = 'ButlerTask'
+
+    def _loadData(self, data):
+        self._data = data
+        self.description = data.attrib.get('description')
+        self.enabled = utils.cast(bool, data.attrib.get('enabled'))
+        self.interval = utils.cast(int, data.attrib.get('interval'))
+        self.name = data.attrib.get('name')
+        self.scheduleRandomized = utils.cast(bool, data.attrib.get('scheduleRandomized'))
+        self.title = data.attrib.get('title')
diff --git a/lib/plexapi/settings.py b/lib/plexapi/settings.py
index 81fdf9b1..e0adba00 100644
--- a/lib/plexapi/settings.py
+++ b/lib/plexapi/settings.py
@@ -71,7 +71,7 @@ class Settings(PlexObject):
         return self.groups().get(group, [])
 
     def save(self):
-        """ Save any outstanding settnig changes to the :class:`~plexapi.server.PlexServer`. This
+        """ Save any outstanding setting changes to the :class:`~plexapi.server.PlexServer`. This
             performs a full reload() of Settings after complete.
         """
         params = {}
@@ -100,7 +100,7 @@ class Setting(PlexObject):
             hidden (bool): True if this is a hidden setting.
             advanced (bool): True if this is an advanced setting.
             group (str): Group name this setting is categorized as.
-            enumValues (list,dict): List or dictionary of valis values for this setting.
+            enumValues (list,dict): List or dictionary of valid values for this setting.
     """
     _bool_cast = lambda x: bool(x == 'true' or x == '1')
     _bool_str = lambda x: str(x).lower()
@@ -143,7 +143,7 @@ class Setting(PlexObject):
         return enumstr.split('|')
 
     def set(self, value):
-        """ Set a new value for this setitng. NOTE: You must call plex.settings.save() for before
+        """ Set a new value for this setting. NOTE: You must call plex.settings.save() for before
             any changes to setting values are persisted to the :class:`~plexapi.server.PlexServer`.
         """
         # check a few things up front
diff --git a/lib/plexapi/sonos.py b/lib/plexapi/sonos.py
index 3bdfc1f2..35956b99 100644
--- a/lib/plexapi/sonos.py
+++ b/lib/plexapi/sonos.py
@@ -14,7 +14,7 @@ class PlexSonosClient(PlexClient):
         speakers linked to your Plex account. It also requires remote access to
         be working properly.
 
-        More details on the Sonos integration are avaialble here:
+        More details on the Sonos integration are available here:
         https://support.plex.tv/articles/218237558-requirements-for-using-plex-for-sonos/
 
         The Sonos API emulates the Plex player control API closely:
@@ -38,7 +38,7 @@ class PlexSonosClient(PlexClient):
             server (:class:`~plexapi.server.PlexServer`): Server this client is connected to.
             session (:class:`~requests.Session`): Session object used for connection.
             title (str): Name of this Sonos speaker.
-            token (str): X-Plex-Token used for authenication
+            token (str): X-Plex-Token used for authentication
             _baseurl (str): Address of public Plex Sonos API endpoint.
             _commandId (int): Counter for commands sent to Plex API.
             _token (str): Token associated with linked Plex account.
diff --git a/lib/plexapi/utils.py b/lib/plexapi/utils.py
index 92d64299..9c43b23a 100644
--- a/lib/plexapi/utils.py
+++ b/lib/plexapi/utils.py
@@ -9,6 +9,7 @@ import time
 import unicodedata
 import warnings
 import zipfile
+from collections import deque
 from datetime import datetime
 from getpass import getpass
 from threading import Event, Thread
@@ -55,7 +56,7 @@ class SecretsFilter(logging.Filter):
 
 def registerPlexObject(cls):
     """ Registry of library types we may come across when parsing XML. This allows us to
-        define a few helper functions to dynamically convery the XML into objects. See
+        define a few helper functions to dynamically convert the XML into objects. See
         buildItem() below for an example.
     """
     etype = getattr(cls, 'STREAMTYPE', getattr(cls, 'TAGTYPE', cls.TYPE))
@@ -72,7 +73,7 @@ def cast(func, value):
         only support str, int, float, bool. Should be extended if needed.
 
         Parameters:
-            func (func): Calback function to used cast to type (int, bool, float).
+            func (func): Callback function to used cast to type (int, bool, float).
             value (any): value to be cast and returned.
     """
     if value is not None:
@@ -114,7 +115,7 @@ def lowerFirst(s):
 
 
 def rget(obj, attrstr, default=None, delim='.'):  # pragma: no cover
-    """ Returns the value at the specified attrstr location within a nexted tree of
+    """ Returns the value at the specified attrstr location within a nested tree of
         dicts, lists, tuples, functions, classes, etc. The lookup is done recursively
         for each key in attrstr (split by by the delimiter) This function is heavily
         influenced by the lookups used in Django templates.
@@ -194,7 +195,7 @@ def threaded(callback, listargs):
         args += [results, len(results)]
         results.append(None)
         threads.append(Thread(target=callback, args=args, kwargs=dict(job_is_done_event=job_is_done_event)))
-        threads[-1].setDaemon(True)
+        threads[-1].daemon = True
         threads[-1].start()
     while not job_is_done_event.is_set():
         if all(not t.is_alive() for t in threads):
@@ -304,7 +305,7 @@ def download(url, token, filename=None, savepath=None, session=None, chunksize=4
             filename (str): Filename of the downloaded file, default None.
             savepath (str): Defaults to current working dir.
             chunksize (int): What chunksize read/write at the time.
-            mocked (bool): Helper to do evertything except write the file.
+            mocked (bool): Helper to do everything except write the file.
             unpack (bool): Unpack the zip file.
             showstatus(bool): Display a progressbar.
 
@@ -361,40 +362,6 @@ def download(url, token, filename=None, savepath=None, session=None, chunksize=4
     return fullpath
 
 
-def tag_singular(tag):
-    if tag == 'countries':
-        return 'country'
-    elif tag == 'similar':
-        return 'similar'
-    else:
-        return tag[:-1]
-
-
-def tag_plural(tag):
-    if tag == 'country':
-        return 'countries'
-    elif tag == 'similar':
-        return 'similar'
-    else:
-        return tag + 's'
-
-
-def tag_helper(tag, items, locked=True, remove=False):
-    """ Simple tag helper for editing a object. """
-    if not isinstance(items, list):
-        items = [items]
-    data = {}
-    if not remove:
-        for i, item in enumerate(items):
-            tagname = '%s[%s].tag.tag' % (tag, i)
-            data[tagname] = item
-    if remove:
-        tagname = '%s[].tag.tag-' % tag
-        data[tagname] = ','.join(items)
-    data['%s.locked' % tag] = 1 if locked else 0
-    return data
-
-
 def getMyPlexAccount(opts=None):  # pragma: no cover
     """ Helper function tries to get a MyPlex Account instance by checking
         the the following locations for a username and password. This is
@@ -485,7 +452,7 @@ def getAgentIdentifier(section, agent):
         if agent in identifiers:
             return ag.identifier
         agents += identifiers
-    raise NotFound('Couldnt find "%s" in agents list (%s)' %
+    raise NotFound('Could not find "%s" in agents list (%s)' %
                    (agent, ', '.join(agents)))
 
 
@@ -506,3 +473,15 @@ def deprecated(message, stacklevel=2):
             return func(*args, **kwargs)
         return wrapper
     return decorator
+
+
+def iterXMLBFS(root, tag=None):
+    """ Iterate through an XML tree using a breadth-first search.
+        If tag is specified, only return nodes with that tag.
+    """
+    queue = deque([root])
+    while queue:
+        node = queue.popleft()
+        if tag is None or node.tag == tag:
+            yield node
+        queue.extend(list(node))
diff --git a/lib/plexapi/video.py b/lib/plexapi/video.py
index 4049d6c5..1604fef3 100644
--- a/lib/plexapi/video.py
+++ b/lib/plexapi/video.py
@@ -2,12 +2,17 @@
 import os
 from urllib.parse import quote_plus, urlencode
 
-from plexapi import library, media, utils
+from plexapi import media, utils
 from plexapi.base import Playable, PlexPartialObject
 from plexapi.exceptions import BadRequest
-from plexapi.mixins import AdvancedSettingsMixin, ArtUrlMixin, ArtMixin, BannerMixin, PosterUrlMixin, PosterMixin
-from plexapi.mixins import RatingMixin, SplitMergeMixin, UnmatchMatchMixin
-from plexapi.mixins import CollectionMixin, CountryMixin, DirectorMixin, GenreMixin, LabelMixin, ProducerMixin, WriterMixin
+from plexapi.mixins import (
+    AdvancedSettingsMixin, SplitMergeMixin, UnmatchMatchMixin, ExtrasMixin, HubsMixin, RatingMixin,
+    ArtUrlMixin, ArtMixin, BannerMixin, PosterUrlMixin, PosterMixin, ThemeUrlMixin, ThemeMixin,
+    ContentRatingMixin, OriginallyAvailableMixin, OriginalTitleMixin, SortTitleMixin, StudioMixin,
+    SummaryMixin, TaglineMixin, TitleMixin,
+    CollectionMixin, CountryMixin, DirectorMixin, GenreMixin, LabelMixin, ProducerMixin, WriterMixin,
+    WatchlistMixin
+)
 
 
 class Video(PlexPartialObject):
@@ -35,7 +40,7 @@ class Video(PlexPartialObject):
             title (str): Name of the movie, show, season, episode, or clip.
             titleSort (str): Title to use when sorting (defaults to title).
             type (str): 'movie', 'show', 'season', 'episode', or 'clip'.
-            updatedAt (datatime): Datetime the item was updated.
+            updatedAt (datetime): Datetime the item was updated.
             userRating (float): Rating of the item (0.0 - 10.0) equaling (0 stars - 5 stars).
             viewCount (int): Count of times the item was played.
     """
@@ -76,7 +81,7 @@ class Video(PlexPartialObject):
         return self._server.url(part, includeToken=True) if part else None
 
     def markWatched(self):
-        """ Mark the video as palyed. """
+        """ Mark the video as played. """
         key = '/:/scrobble?key=%s&identifier=com.plexapp.plugins.library' % self.ratingKey
         self._server.query(key)
 
@@ -107,6 +112,15 @@ class Video(PlexPartialObject):
         """ Returns str, default title for a new syncItem. """
         return self.title
 
+    def audioStreams(self):
+        """ Returns a list of :class:`~plexapi.media.AudioStream` objects for all MediaParts. """
+        streams = []
+
+        parts = self.iterParts()
+        for part in parts:
+            streams += part.audioStreams()
+        return streams
+
     def subtitleStreams(self):
         """ Returns a list of :class:`~plexapi.media.SubtitleStream` objects for all MediaParts. """
         streams = []
@@ -261,8 +275,15 @@ class Video(PlexPartialObject):
 
 
 @utils.registerPlexObject
-class Movie(Video, Playable, AdvancedSettingsMixin, ArtMixin, PosterMixin, RatingMixin, SplitMergeMixin, UnmatchMatchMixin,
-        CollectionMixin, CountryMixin, DirectorMixin, GenreMixin, LabelMixin, ProducerMixin, WriterMixin):
+class Movie(
+    Video, Playable,
+    AdvancedSettingsMixin, SplitMergeMixin, UnmatchMatchMixin, ExtrasMixin, HubsMixin, RatingMixin,
+    ArtMixin, PosterMixin, ThemeMixin,
+    ContentRatingMixin, OriginallyAvailableMixin, OriginalTitleMixin, SortTitleMixin, StudioMixin,
+    SummaryMixin, TaglineMixin, TitleMixin,
+    CollectionMixin, CountryMixin, DirectorMixin, GenreMixin, LabelMixin, ProducerMixin, WriterMixin,
+    WatchlistMixin
+):
     """ Represents a single Movie.
 
         Attributes:
@@ -280,7 +301,7 @@ class Movie(Video, Playable, AdvancedSettingsMixin, ArtMixin, PosterMixin, Ratin
             genres (List<:class:`~plexapi.media.Genre`>): List of genre objects.
             guids (List<:class:`~plexapi.media.Guid`>): List of guid objects.
             labels (List<:class:`~plexapi.media.Label`>): List of label objects.
-            languageOverride (str): Setting that indicates if a languge is used to override metadata
+            languageOverride (str): Setting that indicates if a language is used to override metadata
                 (eg. en-CA, None = Library default).
             media (List<:class:`~plexapi.media.Media`>): List of media objects.
             originallyAvailableAt (datetime): Datetime the movie was released.
@@ -293,6 +314,7 @@ class Movie(Video, Playable, AdvancedSettingsMixin, ArtMixin, PosterMixin, Ratin
             similar (List<:class:`~plexapi.media.Similar`>): List of Similar objects.
             studio (str): Studio that created movie (Di Bonaventura Pictures; 21 Laps Entertainment).
             tagline (str): Movie tag line (Back 2 Work; Who says men can't change?).
+            theme (str): URL to theme resource (/library/metadata/<ratingkey>/theme/<themeid>).
             useOriginalTitle (int): Setting that indicates if the original title is used for the movie
                 (-1 = Library default, 0 = No, 1 = Yes).
             viewOffset (int): View offset in milliseconds.
@@ -331,6 +353,7 @@ class Movie(Video, Playable, AdvancedSettingsMixin, ArtMixin, PosterMixin, Ratin
         self.similar = self.findItems(data, media.Similar)
         self.studio = data.attrib.get('studio')
         self.tagline = data.attrib.get('tagline')
+        self.theme = data.attrib.get('theme')
         self.useOriginalTitle = utils.cast(int, data.attrib.get('useOriginalTitle', '-1'))
         self.viewOffset = utils.cast(int, data.attrib.get('viewOffset', 0))
         self.writers = self.findItems(data, media.Writer)
@@ -365,20 +388,17 @@ class Movie(Video, Playable, AdvancedSettingsMixin, ArtMixin, PosterMixin, Ratin
         data = self._server.query(self._details_key)
         return self.findItems(data, media.Review, rtag='Video')
 
-    def extras(self):
-        """ Returns a list of :class:`~plexapi.video.Extra` objects. """
-        data = self._server.query(self._details_key)
-        return self.findItems(data, Extra, rtag='Extras')
-
-    def hubs(self):
-        """ Returns a list of :class:`~plexapi.library.Hub` objects. """
-        data = self._server.query(self._details_key)
-        return self.findItems(data, library.Hub, rtag='Related')
-
 
 @utils.registerPlexObject
-class Show(Video, AdvancedSettingsMixin, ArtMixin, BannerMixin, PosterMixin, RatingMixin, SplitMergeMixin, UnmatchMatchMixin,
-        CollectionMixin, GenreMixin, LabelMixin):
+class Show(
+    Video,
+    AdvancedSettingsMixin, SplitMergeMixin, UnmatchMatchMixin, ExtrasMixin, HubsMixin, RatingMixin,
+    ArtMixin, BannerMixin, PosterMixin, ThemeMixin,
+    ContentRatingMixin, OriginallyAvailableMixin, OriginalTitleMixin, SortTitleMixin, StudioMixin,
+    SummaryMixin, TaglineMixin, TitleMixin,
+    CollectionMixin, GenreMixin, LabelMixin,
+    WatchlistMixin
+):
     """ Represents a single Show (including all seasons and episodes).
 
         Attributes:
@@ -407,7 +427,7 @@ class Show(Video, AdvancedSettingsMixin, ArtMixin, BannerMixin, PosterMixin, Rat
             index (int): Plex index number for the show.
             key (str): API URL (/library/metadata/<ratingkey>).
             labels (List<:class:`~plexapi.media.Label`>): List of label objects.
-            languageOverride (str): Setting that indicates if a languge is used to override metadata
+            languageOverride (str): Setting that indicates if a language is used to override metadata
                 (eg. en-CA, None = Library default).
             leafCount (int): Number of items in the show view.
             locations (List<str>): List of folder paths where the show is found on disk.
@@ -483,11 +503,6 @@ class Show(Video, AdvancedSettingsMixin, ArtMixin, BannerMixin, PosterMixin, Rat
         """ Returns True if the show is fully watched. """
         return bool(self.viewedLeafCount == self.leafCount)
 
-    def hubs(self):
-        """ Returns a list of :class:`~plexapi.library.Hub` objects. """
-        data = self._server.query(self._details_key)
-        return self.findItems(data, library.Hub, rtag='Related')
-
     def onDeck(self):
         """ Returns show's On Deck :class:`~plexapi.video.Video` object or `None`.
             If show is unwatched, return will likely be the first episode.
@@ -574,7 +589,13 @@ class Show(Video, AdvancedSettingsMixin, ArtMixin, BannerMixin, PosterMixin, Rat
 
 
 @utils.registerPlexObject
-class Season(Video, ArtMixin, PosterMixin, RatingMixin, CollectionMixin):
+class Season(
+    Video,
+    ExtrasMixin, RatingMixin,
+    ArtMixin, PosterMixin, ThemeUrlMixin,
+    SummaryMixin, TitleMixin,
+    CollectionMixin, LabelMixin
+):
     """ Represents a single Show Season (including all episodes).
 
         Attributes:
@@ -584,6 +605,7 @@ class Season(Video, ArtMixin, PosterMixin, RatingMixin, CollectionMixin):
             guids (List<:class:`~plexapi.media.Guid`>): List of guid objects.
             index (int): Season number.
             key (str): API URL (/library/metadata/<ratingkey>).
+            labels (List<:class:`~plexapi.media.Label`>): List of label objects.
             leafCount (int): Number of items in the season view.
             parentGuid (str): Plex GUID for the show (plex://show/5d9c086fe9d5a1001f4d9fe6).
             parentIndex (int): Plex index number for the show.
@@ -607,6 +629,7 @@ class Season(Video, ArtMixin, PosterMixin, RatingMixin, CollectionMixin):
         self.guids = self.findItems(data, media.Guid)
         self.index = utils.cast(int, data.attrib.get('index'))
         self.key = self.key.replace('/children', '')  # FIX_BUG_50
+        self.labels = self.findItems(data, media.Label)
         self.leafCount = utils.cast(int, data.attrib.get('leafCount'))
         self.parentGuid = data.attrib.get('parentGuid')
         self.parentIndex = utils.cast(int, data.attrib.get('parentIndex'))
@@ -709,8 +732,13 @@ class Season(Video, ArtMixin, PosterMixin, RatingMixin, CollectionMixin):
 
 
 @utils.registerPlexObject
-class Episode(Video, Playable, ArtMixin, PosterMixin, RatingMixin,
-        CollectionMixin, DirectorMixin, WriterMixin):
+class Episode(
+    Video, Playable,
+    ExtrasMixin, RatingMixin,
+    ArtMixin, PosterMixin, ThemeUrlMixin,
+    ContentRatingMixin, OriginallyAvailableMixin, SortTitleMixin, SummaryMixin, TitleMixin,
+    CollectionMixin, DirectorMixin, LabelMixin, WriterMixin
+):
     """ Represents a single Shows Episode.
 
         Attributes:
@@ -733,6 +761,7 @@ class Episode(Video, Playable, ArtMixin, PosterMixin, RatingMixin,
             grandparentTitle (str): Name of the show for the episode.
             guids (List<:class:`~plexapi.media.Guid`>): List of guid objects.
             index (int): Episode number.
+            labels (List<:class:`~plexapi.media.Label`>): List of label objects.
             markers (List<:class:`~plexapi.media.Marker`>): List of marker objects.
             media (List<:class:`~plexapi.media.Media`>): List of media objects.
             originallyAvailableAt (datetime): Datetime the episode was released.
@@ -777,6 +806,7 @@ class Episode(Video, Playable, ArtMixin, PosterMixin, RatingMixin,
         self.grandparentTitle = data.attrib.get('grandparentTitle')
         self.guids = self.findItems(data, media.Guid)
         self.index = utils.cast(int, data.attrib.get('index'))
+        self.labels = self.findItems(data, media.Label)
         self.markers = self.findItems(data, media.Marker)
         self.media = self.findItems(data, media.Media)
         self.originallyAvailableAt = utils.toDatetime(data.attrib.get('originallyAvailableAt'), '%Y-%m-%d')
@@ -879,7 +909,10 @@ class Episode(Video, Playable, ArtMixin, PosterMixin, RatingMixin,
 
 
 @utils.registerPlexObject
-class Clip(Video, Playable, ArtUrlMixin, PosterUrlMixin):
+class Clip(
+    Video, Playable,
+    ArtUrlMixin, PosterUrlMixin
+):
     """ Represents a single Clip.
 
         Attributes:
diff --git a/requirements.txt b/requirements.txt
index b215a9f9..d9f7d751 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -27,7 +27,7 @@ MarkupSafe==2.1.1
 musicbrainzngs==0.7.1
 packaging==21.3
 paho-mqtt==1.6.1
-plexapi==4.9.2
+plexapi==4.11.0
 portend==3.1.0
 profilehooks==1.12.0
 PyJWT==2.4.0

From 07eba40096376a43d64dddb4eb9fea81d1484776 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 17 May 2022 11:28:08 -0700
Subject: [PATCH 106/743] Update default user thumb image

---
 data/interfaces/default/home_stats.html       |   4 ++--
 .../default/images/default_profile.svg        |  22 ++++++++++++++++++
 .../default/images/gravatar-default-80x80.png | Bin 1536 -> 2141 bytes
 .../default/images/gravatar-default.png       | Bin 3274 -> 3207 bytes
 data/interfaces/default/index.html            |   4 ++--
 5 files changed, 26 insertions(+), 4 deletions(-)
 create mode 100644 data/interfaces/default/images/default_profile.svg

diff --git a/data/interfaces/default/home_stats.html b/data/interfaces/default/home_stats.html
index 1f08c068..b873f64b 100644
--- a/data/interfaces/default/home_stats.html
+++ b/data/interfaces/default/home_stats.html
@@ -79,7 +79,7 @@ DOCUMENTATION :: END
         % elif stat_id == 'top_libraries':
         <div id="stats-background-${stat_id}" class="dashboard-stats-background" style="background-image: url(${page('pms_image_proxy', row0['art'], None, 500, 280, 40, '282828', 3, fallback='art')});">
         % elif stat_id == 'top_users':
-        <div id="stats-background-${stat_id}" class="dashboard-stats-background" data-blurhash="${page('pms_image_proxy', row0['user_thumb'] or 'interfaces/default/images/gravatar-default.png', None, 80, 80, 40, '282828', 0, fallback='user')}">
+        <div id="stats-background-${stat_id}" class="dashboard-stats-background" data-blurhash="${page('pms_image_proxy', row0['user_thumb'] or 'interfaces/default/images/gravatar-default.png', None, 100, 100, 40, '282828', 0, fallback='user')}">
         % elif stat_id == 'top_platforms':
         <div id="stats-background-${stat_id}" class="dashboard-stats-background platform-${row0['platform_name']}-rgba no-image">
         % else:
@@ -117,7 +117,7 @@ DOCUMENTATION :: END
             % elif stat_id == 'top_users':
             <% user_href = page('user', row0['user_id']) if row0['user_id'] else '#' %>
             <a id="stats-thumb-url-${stat_id}" href="${user_href}" title="${row0['user']}" class="hidden-xs">
-                <div id="stats-thumb-${stat_id}" class="dashboard-stats-circle" style="background-image: url(${page('pms_image_proxy', row0['user_thumb'] or 'interfaces/default/images/gravatar-default.png', None, 80, 80, fallback='user')})"></div>
+                <div id="stats-thumb-${stat_id}" class="dashboard-stats-circle" style="background-image: url(${page('pms_image_proxy', row0['user_thumb'] or 'interfaces/default/images/gravatar-default.png', None, 100, 100, fallback='user')})"></div>
             </a>
             % elif stat_id == 'top_platforms':
             <div id="stats-thumb-${stat_id}" class="dashboard-stats-flat svg-icon platform-${row0['platform_name']} transparent hidden-xs"></div>
diff --git a/data/interfaces/default/images/default_profile.svg b/data/interfaces/default/images/default_profile.svg
new file mode 100644
index 00000000..a2cd8f0e
--- /dev/null
+++ b/data/interfaces/default/images/default_profile.svg
@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Generator: Adobe Illustrator 16.0.0, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+	 width="120px" height="120px" viewBox="0 0 120 120" enable-background="new 0 0 120 120" xml:space="preserve">
+<g>
+	<path fill="#BEBEBE" d="M31.161,105.119c4.747-3.413,10.392-5.561,16.939-6.444c2.645,1.983,6.611,2.976,11.9,2.976
+		c5.288,0,9.255-0.992,11.9-2.976c6.546,0.884,12.192,3.031,16.938,6.444c-8.325,5.336-18.223,8.431-28.838,8.431
+		C49.385,113.55,39.487,110.455,31.161,105.119z"/>
+	<path fill="#D6D6D6" d="M48.1,98.675l2.737-8.553C42.241,84.96,36.2,72.758,36.2,58.526c0-7.478,1.669-14.397,4.498-20.029
+		c3.436,1.059,7.504,1.669,11.864,1.669c10.86,0,19.907-3.795,21.903-8.822c5.676,6.256,9.334,16.104,9.334,27.182
+		c0,14.232-6.041,26.434-14.637,31.596l2.737,8.553c-2.646,1.983-6.612,2.976-11.9,2.976c-5.248,0-9.194-0.977-11.838-2.929
+		L48.1,98.675z"/>
+	<path fill="#A6A6A6" d="M38.763,73.994C33.496,68.09,30.25,60,30.25,51.075C30.25,33.002,43.57,18.35,60,18.35
+		c16.431,0,29.75,14.65,29.75,32.724c0,8.925-3.247,17.016-8.514,22.92c1.64-4.647,2.563-9.901,2.563-15.468
+		c0-11.078-3.658-20.925-9.334-27.182c-1.996,5.027-11.043,8.822-21.903,8.822c-4.36,0-8.428-0.611-11.864-1.669
+		C37.868,44.128,36.2,51.048,36.2,58.526C36.2,64.093,37.124,69.348,38.763,73.994z"/>
+	<path fill="#D6D6D6" d="M60,113.55c29.575,0,53.55-23.974,53.55-53.55c0-29.575-23.975-53.55-53.55-53.55
+		C30.425,6.45,6.45,30.425,6.45,60C6.45,89.576,30.425,113.55,60,113.55z M60,119.5C27.138,119.5,0.5,92.86,0.5,60
+		S27.138,0.5,60,0.5c32.86,0,59.5,26.64,59.5,59.499C119.5,92.86,92.86,119.5,60,119.5z"/>
+</g>
+</svg>
diff --git a/data/interfaces/default/images/gravatar-default-80x80.png b/data/interfaces/default/images/gravatar-default-80x80.png
index 9440f72bf72653408f7f492e4047a8b6dd891b75..1686279447dd66813f091405edcc6bf165f0c06a 100644
GIT binary patch
delta 2092
zcmV+{2-Ej~4BZfrNPh?aNkl<Zc-rip%}yIT6o8$9{y?jeTNMe3O^~|krt}F&yXlg!
zWz*ydNS+|@1du04*mO(!0%drDh7Id1SyXC@N`LveK6B3?UvoT}v5#j4sYkLHK{B?#
zIe+%pW>yp|CnqO0`2$KFfAvz9s^Q}kS&s2Klx6(l#fx!~?SHQn1gs&;8bYf&-g1I4
zk7OC<4YZOow0E+sdaiCH%YI%kE1toDhHW9dB4j8_Pl62Z6hH*mRs32S8Djwr`fB*h
z0%~yVH`59L-0=aj!VC^Nx0@1N?6*SOj^Tr<EB-W1ogG=<s8j%DN2;iC?Gz^U0sYg2
z`QcU3Rjj9Q8Gk#n>~XZA!lZTmgx~;;9H1}CB|>7*0^i$Ai1MI?Emv)<I5xD6CTjxM
z<9gB#TG>XJCXfJekUK!xxIR8%lc{!!PI5Jk+)Xg;foy9l7l8Ow4-8Iwf=_fPN+`1J
z4RkkELx9=HYAt~Uyh8&#fVNUrcp%ue6>O_6(5FM}BY(dJD)6Xa0Xf#TOXuFde;-HD
zmr5OVMLS~04`bos=H}+aQ5&~0bD)CD>$IAf1)xduoSd)(*Tf-SJ>ypa>b?XyaDdoE
zlfHFt*{9cR022a+H9QHffsVcAXqgbGIuhiN8DgryQb|#PDOIt8ho;*1Fg^x=EgREL
zfH<{}m46gT@+U@ks~Ev+!jFJ9Zb*nDMu@MHlI>th(C8ZihAq59kMIQE`w;8O8leX`
z#M7mp6q%FKm@W}<hc?kxfmap&rRo52n@Dk14bj>R5KXsDCCQdPFE4mHM4LKW*jH8B
z$RxD}nu3N+?sbqeJQd=Bg%+9=Wj7T-WsXfZ-G8Bl_O&hYyUg<R=~FQ?GeiBUj%~0R
zvFQD+Bb%uj*d<K2V`;iw-|*(<=EU;yvRGMJG5T^#Q|=I^+)V^%&_3IFytZ%CU07HU
z&!0b!wD0lb$6|4D(PYXtS_pmaP18bM1Gfn6+q2ZZEnnd7-@hMe92C`bmzI`Hro3gT
zg@1d57H*LMl~<4YaK<KZG`Y18z<{p<XtGU__EDb!b2eyU(=wpwId215MKY`Yfw)J{
zvcK;rt$~jJ`0+!0`}R%z{{1_;2D!Yvyt#(YL5ckvT!VSSb=rV(dU_h&pJ>ybMPGV^
z3uwgmswf)xNlTm|@@`m~?-%{|U|vx25Ptv&g^+(N$I1tqf{i4bS2re%Dyb)mA1vEn
zH)%#*l2DgzN~N<{jm<bnFkjo5<y9(L#%7s^KwXrN6!yzXC>9MB;F|Ww(BVy*ey_-f
z<t>If*KF>EEJEsDfkCy8a_CGE0A1vWat8t0vYv8;4i(k))FN#J<sP9BIibt2Qh#Ss
z1$Ll;H9}=W&W;o%oOK(RL;&@tGA?T;N>I1XrXHmDkn;$lDDhDDn3_y@sr}A%>DQ>l
z8pzr=U>6Vp<f~&PlM-v7>mnzeO*Qb)?vW_3u(!<zz~d4FJiZG6!x94wOAl~!b91bk
z3QScMC0gAhY+LCy5M)2Ti0Ao=5Pz-ieIIoML}XfExbL8Z8aQCMrOsv&5RP?~!HjRF
z!b_ro1K0J01~$i(3D=m~59>@OB>*@P^qLnNsZk~z`T&RyyQjYI$QvG-aE~!~=xoA(
z8sAZG;4L9;L-d1}NO=p^Il?wLi-E~Fz!%86f2cF|rFDLOp8Gx#taF3$mVY{v39t(c
z3FaDCt+3cpj!9d21B5!6^S(7IDUSi(ny${e+&@X)zI{6s%+q93WQ=tRCiATd!)uQi
zpz*DfkK{TB;jYX0)-nQ!eo&vOSZ8howa&zcSgq%oB07svyx=NGcxwM!1L7+9YOt3B
zz#ix3M#Gw+eQGRBnKA1MD}P*r>~p?w<ho-jC4=EDfT)r>#3pAjiPIX709o&ieQ)aU
z)b*13P);{7tHp^^v~c7JVvBPtKMJ)-w5Jc{)Xs%OPPoPC3$dO7)9lF2WP!_my#(K<
zoA0gj9RkB7fUbqR-0Fh+&^V&yp6zDoDY8pw-wrjIAW~>y12-#kLx1exaLXoYMng5c
zhhWye1`&D5(?v`((p01R9s)|drN9P4$H(UGge`7l8-oN#zekvI-&6El&*?j9ggO#n
z#}uHF-ihoGIa>pFdUHQ<8~4!Qwg~K--j-34uMVb+94P19#jT+}$C-J2SBD3E>Kf9c
zNoIgka<)Dr#Px!{tAE4m+vJvoZTbKB@gw9}wWXz{Lzm8<o}R+l2IDtx-i(>y@of25
zDsnn>LIP9IwyMXD8Ww~<dGbWe&dz4)_{GJAI6FI2_k+ain4`0~B+!WiJl;bm6lb6L
z*b@n^E>fH!c<<i5n@u*A%74v@SN6w{uCK47YbbyI{F&C|=zr`$2{KFw82KH0k^<sT
zb+`yF>luPR1OV>DAeB6?;R-J^K&1i3qo1T{bv}Roye2I6rg@gZvuDqaq^qEYXff!_
zM?ZNveC*e+Uy*+*a#@Eeu+S3x?1Kjnk|rbaIeaXo6OR1V`T4o{{{6eSy1FU^To43e
zetup&di3bVuYYo863ze-V&Vae01{RS0L;8J5;P8=!5ZlVaK#_MsQJaVn6kwmO#A20
zpV3cltpsfY6MgvbVUnq;!_;yd0ZM3NszYewbR;e|5~n@t9^(`dxqOGv5+F0DFks$L
zAVD^1CukWY++d;^SO16NE*yhw0QvVIZU&Gw@%Jcrb|sj9{}}-z(3-fT{|@6{0R{l-
WB8GvTo!)~00000<MNUMnLSTXp&HQ-)

literal 1536
zcmeAS@N?(olHy`uVBq!ia0vp^0U*r51|<6gKdl8)k|nMYCBgY=CFO}lsSJ)O`AMk?
zp1FzXsX?iUDV2pMQ*9U+n3Xa^B1$5BeXNr6bM+EIYV;~{3xK*A7;Nk-3KEmEQ%e+*
zQqwc@Y?a>c-mj#PnPRIHZt82`Ti~3Uk?B!Ylp0*+7m{3+ootz+WN)WnQ(*-(AUCxn
zQK2F?C$HG5!d3}vt`(3C64qBz04piUwpD^SD#ABF!8yMuRl!uxSU1_g&``n5OwZ87
z)XdCKN5ROz&`93^h|F{iO{`4Ktc=VRpg;*|TTx1yRgjAt)Gi>;Rw<*Tq`*pFzr4I$
zuiRKKzbIYb(9+TpWQLKEE>MMTab;dfVufyAu`<jAm(=3qqRfJl%=|nBkco*&`K2Yc
zN<f!FypUS}H#V;r8ce_d)2~P@&^OdG0C@?f(AO8g(%f9Q>f(~1RD^r68eAMwS&*t9
zlv<o$T9gcoxHM&uRRvbgMX8A;`9&f5`8lvq49LhY$uG{xFHmp}HdD|D&&*57FE7>v
ztM~P_^2{qPNz6-5^>ndS0-B(gnVDi`W?<=TZeeL)Y2xH&Xy|HeVPs(LY;0-a>f&nX
z=3?pw)9aF-T$-DjR|3<Ug3xP-Q!gkf<Q4#Jc1bPDEK5ysE6UGR0DIXg6Q^4&TydHQ
z)tiFTEf#J#_38s1qYsK$q=<$I0aFi%2~V~_4m{zf<^fZC5inWzeAH58U|<4<fMZC-
ztv7SddWQr`96KN46+FR3OmK;~Q;V2xR?Lf}8NP~FT4tMxIn_6Kv2E>C3g0E+SYoc=
zA>XYbZYaX~&}*WnxNec6)8@blPC_k8t6o~(*_=_Ge(tZu_gc9hh6V-qE&rswn^S#m
zPqFdWs#wEbb>~JA4-n#E4N?Fi2=_#b)`ib|42~N!<TW#8u<k$enf>hJ^bc%P4wgwU
zueh4!$MuH!ykmMp^09-9cd*KN9Edbvo5pnNawUgWA-`Q-W4Xi1&d2MUDpxY?J~*Y-
z%K5=Am&S74YgG!q31T9;*IqMLdNNfX%sg$X?=4iJ(lYC~%DF@5+L<&bfRH5D5(gkU
zrr5Y!@yea)Dg}~jqSx(Icq^h8xyF?H+7iw=%*JA`Y8Va&sZSIa%bKEk{?LBiD;6q|
z58}B^jsCEFvYNp3_>?@?6Lo`Ye>NCQ{4+)8!;V(NIn%WQ%2U@ytoSSuGWEWay3+&Q
z4_DW;@<*>)8EswCJ?Gw%9aF*@cYRF~wqbm$xVJ4&GLrSZLwFQR9E<$H>H@t*=C8SK
z7-YXSUdQ$2K=jjm<EKf#=Iv$Nc3{gV>qBz{Dx7}CE{=DochbA=c0g{&{FKIBtLubn
zg6pnlT)M=hcIHQ(n(u;rDnI$&S#GGfkbWZAc%kScF$<2eGpe3pJ4J05>NZ_ppqtgG
zeo*}b&zzzf%V-l}Up=kH>j%6G9G9xQAJjIGYIXQqzGjbCyp>esQ4^&Np@y9|d=@yg
zfdY+{>xnJXKX2t+LDAwnkx$<jEK#gVkNNKu!CR$}Z*?(6101xP6BdGkmJ7<A>F`ti
Z0K*I3wKghN2Y-XgWKUN=mvv4FO#o1~BYOY<

diff --git a/data/interfaces/default/images/gravatar-default.png b/data/interfaces/default/images/gravatar-default.png
index d72cb55c8676cd5afcef1124641bde35894b39db..6ee806dd679666742e0b52200312bc47927357ab 100644
GIT binary patch
delta 3201
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

literal 3274
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
K;y>NVnZE;uX+F*X

diff --git a/data/interfaces/default/index.html b/data/interfaces/default/index.html
index 715996c1..1175e8cd 100644
--- a/data/interfaces/default/index.html
+++ b/data/interfaces/default/index.html
@@ -817,8 +817,8 @@
                         .addClass('svg-icon library-' + library_type);
                 }
             } else if (stat_id === 'top_users') {
-                loadBlurHash($('#stats-background-' + stat_id), page('pms_image_proxy', user_thumb || 'interfaces/default/images/gravatar-default.png', null, 80, 80, 40, '282828', 0, 'user'));
-                $('#stats-thumb-' + stat_id).css('background-image', 'url(' + page('pms_image_proxy', user_thumb || 'interfaces/default/images/gravatar-default.png', null, 80, 80, null, null, null, 'user') + ')');
+                loadBlurHash($('#stats-background-' + stat_id), page('pms_image_proxy', user_thumb || 'interfaces/default/images/gravatar-default.png', null, 100, 100, 40, '282828', 0, 'user'));
+                $('#stats-thumb-' + stat_id).css('background-image', 'url(' + page('pms_image_proxy', user_thumb || 'interfaces/default/images/gravatar-default.png', null, 100, 100, null, null, null, 'user') + ')');
                 if (user_id) {
                     href = page('user', user_id);
                 }

From 996778699798e2e83598aa4b7aac81b9c4dd2323 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 16 May 2022 22:25:33 -0700
Subject: [PATCH 107/743] Add new exporter fields for PlexAPI 4.11.0

---
 plexpy/exporter.py | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/plexpy/exporter.py b/plexpy/exporter.py
index 196b15f0..d82c974c 100644
--- a/plexpy/exporter.py
+++ b/plexpy/exporter.py
@@ -371,6 +371,7 @@ class Export(object):
                 'studio': None,
                 'summary': None,
                 'tagline': None,
+                'theme': None,
                 'thumb': None,
                 'thumbBlurHash': None,
                 'thumbFile': lambda o: self.get_image(o, 'thumb'),
@@ -490,6 +491,10 @@ class Export(object):
                 },
                 'index': None,
                 'key': None,
+                'labels': {
+                    'id': None,
+                    'tag': None
+                },
                 'lastRatedAt': helpers.datetime_to_iso,
                 'lastViewedAt': helpers.datetime_to_iso,
                 'leafCount': None,
@@ -571,6 +576,10 @@ class Export(object):
                 'hasPreviewThumbnails': None,
                 'index': None,
                 'key': None,
+                'labels': {
+                    'id': None,
+                    'tag': None
+                },
                 'lastRatedAt': helpers.datetime_to_iso,
                 'lastViewedAt': helpers.datetime_to_iso,
                 'librarySectionID': None,
@@ -792,6 +801,10 @@ class Export(object):
                 'guid': None,
                 'index': None,
                 'key': None,
+                'labels': {
+                    'id': None,
+                    'tag': None
+                },
                 'lastRatedAt': helpers.datetime_to_iso,
                 'lastViewedAt': helpers.datetime_to_iso,
                 'librarySectionID': None,
@@ -813,6 +826,7 @@ class Export(object):
                     'tag': None
                 },
                 'summary': None,
+                'theme': None,
                 'thumb': None,
                 'thumbBlurHash': None,
                 'thumbFile': lambda o: self.get_image(o, 'thumb'),
@@ -872,6 +886,7 @@ class Export(object):
                 'parentGuid': None,
                 'parentKey': None,
                 'parentRatingKey': None,
+                'parentTheme': None,
                 'parentThumb': None,
                 'parentTitle': None,
                 'rating': None,
@@ -921,12 +936,17 @@ class Export(object):
                 'grandparentGuid': None,
                 'grandparentKey': None,
                 'grandparentRatingKey': None,
+                'grandparentTheme': None,
                 'grandparentThumb': None,
                 'grandparentTitle': None,
                 'guid': None,
                 'hasSonicAnalysis': None,
                 'index': None,
                 'key': None,
+                'labels': {
+                    'id': None,
+                    'tag': None
+                },
                 'lastRatedAt': helpers.datetime_to_iso,
                 'lastViewedAt': helpers.datetime_to_iso,
                 'librarySectionID': None,
@@ -1027,6 +1047,7 @@ class Export(object):
                 'parentTitle': None,
                 'ratingCount': None,
                 'ratingKey': None,
+                'skipCount': None,
                 'summary': None,
                 'thumb': None,
                 'thumbBlurHash': None,
@@ -1143,6 +1164,7 @@ class Export(object):
                 'artBlurHash': None,
                 'artFile': lambda o: self.get_image(o, 'art'),
                 'childCount': None,
+                'collectionFilterBasedOnUser': None,
                 'collectionMode': None,
                 'collectionSort': None,
                 'contentRating': None,
@@ -1166,6 +1188,7 @@ class Export(object):
                 'ratingKey': None,
                 'subtype': None,
                 'summary': None,
+                'theme': None,
                 'thumb': None,
                 'thumbBlurHash': None,
                 'thumbFile': lambda o: self.get_image(o, 'thumb'),

From 010377870d38186f04cd23a14788d3cccbfbcb31 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Fri, 20 May 2022 10:57:24 -0700
Subject: [PATCH 108/743] Bump certifi from 2021.10.8 to 2022.5.18.1 (#1748)

* Bump certifi from 2021.10.8 to 2022.5.18.1

Bumps [certifi](https://github.com/certifi/python-certifi) from 2021.10.8 to 2022.5.18.1.
- [Release notes](https://github.com/certifi/python-certifi/releases)
- [Commits](https://github.com/certifi/python-certifi/compare/2021.10.08...2022.05.18.1)

---
updated-dependencies:
- dependency-name: certifi
  dependency-type: direct:production
  update-type: version-update:semver-major
...

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

* Update certifi==2022.5.18.1

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/certifi/__init__.py |   3 +-
 lib/certifi/cacert.pem  | 626 +++++++++++++++++++++++++---------------
 lib/certifi/core.py     |  22 +-
 lib/certifi/py.typed    |   0
 requirements.txt        |   2 +-
 5 files changed, 415 insertions(+), 238 deletions(-)
 create mode 100644 lib/certifi/py.typed

diff --git a/lib/certifi/__init__.py b/lib/certifi/__init__.py
index 8db1a0e5..b700d3a6 100644
--- a/lib/certifi/__init__.py
+++ b/lib/certifi/__init__.py
@@ -1,3 +1,4 @@
 from .core import contents, where
 
-__version__ = "2021.10.08"
+__all__ = ["contents", "where"]
+__version__ = "2022.05.18.1"
diff --git a/lib/certifi/cacert.pem b/lib/certifi/cacert.pem
index 6d0ccc0d..f597fb3a 100644
--- a/lib/certifi/cacert.pem
+++ b/lib/certifi/cacert.pem
@@ -28,36 +28,6 @@ DKqC5JlR3XC321Y9YeRq4VzW9v493kHMB65jUr9TU/Qr6cf9tveCX4XSQRjbgbME
 HMUfpIBvFSDJ3gyICh3WZlXi/EjJKSZp4A==
 -----END CERTIFICATE-----
 
-# Issuer: CN=GlobalSign O=GlobalSign OU=GlobalSign Root CA - R2
-# Subject: CN=GlobalSign O=GlobalSign OU=GlobalSign Root CA - R2
-# Label: "GlobalSign Root CA - R2"
-# Serial: 4835703278459682885658125
-# MD5 Fingerprint: 94:14:77:7e:3e:5e:fd:8f:30:bd:41:b0:cf:e7:d0:30
-# SHA1 Fingerprint: 75:e0:ab:b6:13:85:12:27:1c:04:f8:5f:dd:de:38:e4:b7:24:2e:fe
-# SHA256 Fingerprint: ca:42:dd:41:74:5f:d0:b8:1e:b9:02:36:2c:f9:d8:bf:71:9d:a1:bd:1b:1e:fc:94:6f:5b:4c:99:f4:2c:1b:9e
------BEGIN CERTIFICATE-----
-MIIDujCCAqKgAwIBAgILBAAAAAABD4Ym5g0wDQYJKoZIhvcNAQEFBQAwTDEgMB4G
-A1UECxMXR2xvYmFsU2lnbiBSb290IENBIC0gUjIxEzARBgNVBAoTCkdsb2JhbFNp
-Z24xEzARBgNVBAMTCkdsb2JhbFNpZ24wHhcNMDYxMjE1MDgwMDAwWhcNMjExMjE1
-MDgwMDAwWjBMMSAwHgYDVQQLExdHbG9iYWxTaWduIFJvb3QgQ0EgLSBSMjETMBEG
-A1UEChMKR2xvYmFsU2lnbjETMBEGA1UEAxMKR2xvYmFsU2lnbjCCASIwDQYJKoZI
-hvcNAQEBBQADggEPADCCAQoCggEBAKbPJA6+Lm8omUVCxKs+IVSbC9N/hHD6ErPL
-v4dfxn+G07IwXNb9rfF73OX4YJYJkhD10FPe+3t+c4isUoh7SqbKSaZeqKeMWhG8
-eoLrvozps6yWJQeXSpkqBy+0Hne/ig+1AnwblrjFuTosvNYSuetZfeLQBoZfXklq
-tTleiDTsvHgMCJiEbKjNS7SgfQx5TfC4LcshytVsW33hoCmEofnTlEnLJGKRILzd
-C9XZzPnqJworc5HGnRusyMvo4KD0L5CLTfuwNhv2GXqF4G3yYROIXJ/gkwpRl4pa
-zq+r1feqCapgvdzZX99yqWATXgAByUr6P6TqBwMhAo6CygPCm48CAwEAAaOBnDCB
-mTAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUm+IH
-V2ccHsBqBt5ZtJot39wZhi4wNgYDVR0fBC8wLTAroCmgJ4YlaHR0cDovL2NybC5n
-bG9iYWxzaWduLm5ldC9yb290LXIyLmNybDAfBgNVHSMEGDAWgBSb4gdXZxwewGoG
-3lm0mi3f3BmGLjANBgkqhkiG9w0BAQUFAAOCAQEAmYFThxxol4aR7OBKuEQLq4Gs
-J0/WwbgcQ3izDJr86iw8bmEbTUsp9Z8FHSbBuOmDAGJFtqkIk7mpM0sYmsL4h4hO
-291xNBrBVNpGP+DTKqttVCL1OmLNIG+6KYnX3ZHu01yiPqFbQfXf5WRDLenVOavS
-ot+3i9DAgBkcRcAtjOj4LaR0VknFBbVPFd5uRHg5h6h+u/N5GJG79G+dwfCMNYxd
-AfvDbbnvRG15RjF+Cv6pgsH/76tuIMRQyV+dTZsXjAzlAcmgQWpzU/qlULRuJQ/7
-TBj0/VLZjmmx6BEP3ojY+x1J96relc8geMJgEtslQIxq/H5COEBkEveegeGTLg==
------END CERTIFICATE-----
-
 # Issuer: CN=Entrust.net Certification Authority (2048) O=Entrust.net OU=www.entrust.net/CPS_2048 incorp. by ref. (limits liab.)/(c) 1999 Entrust.net Limited
 # Subject: CN=Entrust.net Certification Authority (2048) O=Entrust.net OU=www.entrust.net/CPS_2048 incorp. by ref. (limits liab.)/(c) 1999 Entrust.net Limited
 # Label: "Entrust.net Premium 2048 Secure Server CA"
@@ -491,34 +461,6 @@ vEsXCS+0yx5DaMkHJ8HSXPfqIbloEpw8nL+e/IBcm2PN7EeqJSdnoDfzAIJ9VNep
 +OkuE6N36B9K
 -----END CERTIFICATE-----
 
-# Issuer: CN=DST Root CA X3 O=Digital Signature Trust Co.
-# Subject: CN=DST Root CA X3 O=Digital Signature Trust Co.
-# Label: "DST Root CA X3"
-# Serial: 91299735575339953335919266965803778155
-# MD5 Fingerprint: 41:03:52:dc:0f:f7:50:1b:16:f0:02:8e:ba:6f:45:c5
-# SHA1 Fingerprint: da:c9:02:4f:54:d8:f6:df:94:93:5f:b1:73:26:38:ca:6a:d7:7c:13
-# SHA256 Fingerprint: 06:87:26:03:31:a7:24:03:d9:09:f1:05:e6:9b:cf:0d:32:e1:bd:24:93:ff:c6:d9:20:6d:11:bc:d6:77:07:39
------BEGIN CERTIFICATE-----
-MIIDSjCCAjKgAwIBAgIQRK+wgNajJ7qJMDmGLvhAazANBgkqhkiG9w0BAQUFADA/
-MSQwIgYDVQQKExtEaWdpdGFsIFNpZ25hdHVyZSBUcnVzdCBDby4xFzAVBgNVBAMT
-DkRTVCBSb290IENBIFgzMB4XDTAwMDkzMDIxMTIxOVoXDTIxMDkzMDE0MDExNVow
-PzEkMCIGA1UEChMbRGlnaXRhbCBTaWduYXR1cmUgVHJ1c3QgQ28uMRcwFQYDVQQD
-Ew5EU1QgUm9vdCBDQSBYMzCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEB
-AN+v6ZdQCINXtMxiZfaQguzH0yxrMMpb7NnDfcdAwRgUi+DoM3ZJKuM/IUmTrE4O
-rz5Iy2Xu/NMhD2XSKtkyj4zl93ewEnu1lcCJo6m67XMuegwGMoOifooUMM0RoOEq
-OLl5CjH9UL2AZd+3UWODyOKIYepLYYHsUmu5ouJLGiifSKOeDNoJjj4XLh7dIN9b
-xiqKqy69cK3FCxolkHRyxXtqqzTWMIn/5WgTe1QLyNau7Fqckh49ZLOMxt+/yUFw
-7BZy1SbsOFU5Q9D8/RhcQPGX69Wam40dutolucbY38EVAjqr2m7xPi71XAicPNaD
-aeQQmxkqtilX4+U9m5/wAl0CAwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNV
-HQ8BAf8EBAMCAQYwHQYDVR0OBBYEFMSnsaR7LHH62+FLkHX/xBVghYkQMA0GCSqG
-SIb3DQEBBQUAA4IBAQCjGiybFwBcqR7uKGY3Or+Dxz9LwwmglSBd49lZRNI+DT69
-ikugdB/OEIKcdBodfpga3csTS7MgROSR6cz8faXbauX+5v3gTt23ADq1cEmv8uXr
-AvHRAosZy5Q6XkjEGB5YGV8eAlrwDPGxrancWYaLbumR9YbK+rlmM6pZW87ipxZz
-R8srzJmwN0jP41ZL9c8PDHIyh8bwRLtTcm1D9SZImlJnt1ir/md2cXjbDaJWFBM5
-JDGFoqgCWjBH4d1QB7wCCZAA62RjYJsWvIjJEubSfZGL+T0yjWW06XyxV3bqxbYo
-Ob8VZRzI9neWagqNdwvYkQsEjgfbKbYK7p2CNTUQ
------END CERTIFICATE-----
-
 # Issuer: CN=SwissSign Gold CA - G2 O=SwissSign AG
 # Subject: CN=SwissSign Gold CA - G2 O=SwissSign AG
 # Label: "SwissSign Gold CA - G2"
@@ -779,36 +721,6 @@ t0QmwCbAr1UwnjvVNioZBPRcHv/PLLf/0P2HQBHVESO7SMAhqaQoLf0V+LBOK/Qw
 WyH8EZE0vkHve52Xdf+XlcCWWC/qu0bXu+TZLg==
 -----END CERTIFICATE-----
 
-# Issuer: CN=Cybertrust Global Root O=Cybertrust, Inc
-# Subject: CN=Cybertrust Global Root O=Cybertrust, Inc
-# Label: "Cybertrust Global Root"
-# Serial: 4835703278459682877484360
-# MD5 Fingerprint: 72:e4:4a:87:e3:69:40:80:77:ea:bc:e3:f4:ff:f0:e1
-# SHA1 Fingerprint: 5f:43:e5:b1:bf:f8:78:8c:ac:1c:c7:ca:4a:9a:c6:22:2b:cc:34:c6
-# SHA256 Fingerprint: 96:0a:df:00:63:e9:63:56:75:0c:29:65:dd:0a:08:67:da:0b:9c:bd:6e:77:71:4a:ea:fb:23:49:ab:39:3d:a3
------BEGIN CERTIFICATE-----
-MIIDoTCCAomgAwIBAgILBAAAAAABD4WqLUgwDQYJKoZIhvcNAQEFBQAwOzEYMBYG
-A1UEChMPQ3liZXJ0cnVzdCwgSW5jMR8wHQYDVQQDExZDeWJlcnRydXN0IEdsb2Jh
-bCBSb290MB4XDTA2MTIxNTA4MDAwMFoXDTIxMTIxNTA4MDAwMFowOzEYMBYGA1UE
-ChMPQ3liZXJ0cnVzdCwgSW5jMR8wHQYDVQQDExZDeWJlcnRydXN0IEdsb2JhbCBS
-b290MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA+Mi8vRRQZhP/8NN5
-7CPytxrHjoXxEnOmGaoQ25yiZXRadz5RfVb23CO21O1fWLE3TdVJDm71aofW0ozS
-J8bi/zafmGWgE07GKmSb1ZASzxQG9Dvj1Ci+6A74q05IlG2OlTEQXO2iLb3VOm2y
-HLtgwEZLAfVJrn5GitB0jaEMAs7u/OePuGtm839EAL9mJRQr3RAwHQeWP032a7iP
-t3sMpTjr3kfb1V05/Iin89cqdPHoWqI7n1C6poxFNcJQZZXcY4Lv3b93TZxiyWNz
-FtApD0mpSPCzqrdsxacwOUBdrsTiXSZT8M4cIwhhqJQZugRiQOwfOHB3EgZxpzAY
-XSUnpQIDAQABo4GlMIGiMA4GA1UdDwEB/wQEAwIBBjAPBgNVHRMBAf8EBTADAQH/
-MB0GA1UdDgQWBBS2CHsNesysIEyGVjJez6tuhS1wVzA/BgNVHR8EODA2MDSgMqAw
-hi5odHRwOi8vd3d3Mi5wdWJsaWMtdHJ1c3QuY29tL2NybC9jdC9jdHJvb3QuY3Js
-MB8GA1UdIwQYMBaAFLYIew16zKwgTIZWMl7Pq26FLXBXMA0GCSqGSIb3DQEBBQUA
-A4IBAQBW7wojoFROlZfJ+InaRcHUowAl9B8Tq7ejhVhpwjCt2BWKLePJzYFa+HMj
-Wqd8BfP9IjsO0QbE2zZMcwSO5bAi5MXzLqXZI+O4Tkogp24CJJ8iYGd7ix1yCcUx
-XOl5n4BHPa2hCwcUPUf/A2kaDAtE52Mlp3+yybh2hO0j9n0Hq0V+09+zv+mKts2o
-omcrUtW3ZfA5TGOgkXmTUg9U3YO7n9GPp1Nzw8v/MOx8BLjYRB+TX3EJIrduPuoc
-A06dGiBh+4E37F78CkWr1+cXVdCg6mCbpvbjjFspwgZgFJ0tl0ypkxWdYcQBX0jW
-WL1WMRJOEcgh4LMRkWXbtKaIOM5V
------END CERTIFICATE-----
-
 # Issuer: O=Chunghwa Telecom Co., Ltd. OU=ePKI Root Certification Authority
 # Subject: O=Chunghwa Telecom Co., Ltd. OU=ePKI Root Certification Authority
 # Label: "ePKI Root Certification Authority"
@@ -2342,27 +2254,6 @@ zzuqQhFkoJ2UOQIReVx7Hfpkue4WQrO/isIJxOzksU0CMQDpKmFHjFJKS04YcPbW
 RNZu9YO6bVi9JNlWSOrvxKJGgYhqOkbRqZtNyWHa0V1Xahg=
 -----END CERTIFICATE-----
 
-# Issuer: CN=GlobalSign O=GlobalSign OU=GlobalSign ECC Root CA - R4
-# Subject: CN=GlobalSign O=GlobalSign OU=GlobalSign ECC Root CA - R4
-# Label: "GlobalSign ECC Root CA - R4"
-# Serial: 14367148294922964480859022125800977897474
-# MD5 Fingerprint: 20:f0:27:68:d1:7e:a0:9d:0e:e6:2a:ca:df:5c:89:8e
-# SHA1 Fingerprint: 69:69:56:2e:40:80:f4:24:a1:e7:19:9f:14:ba:f3:ee:58:ab:6a:bb
-# SHA256 Fingerprint: be:c9:49:11:c2:95:56:76:db:6c:0a:55:09:86:d7:6e:3b:a0:05:66:7c:44:2c:97:62:b4:fb:b7:73:de:22:8c
------BEGIN CERTIFICATE-----
-MIIB4TCCAYegAwIBAgIRKjikHJYKBN5CsiilC+g0mAIwCgYIKoZIzj0EAwIwUDEk
-MCIGA1UECxMbR2xvYmFsU2lnbiBFQ0MgUm9vdCBDQSAtIFI0MRMwEQYDVQQKEwpH
-bG9iYWxTaWduMRMwEQYDVQQDEwpHbG9iYWxTaWduMB4XDTEyMTExMzAwMDAwMFoX
-DTM4MDExOTAzMTQwN1owUDEkMCIGA1UECxMbR2xvYmFsU2lnbiBFQ0MgUm9vdCBD
-QSAtIFI0MRMwEQYDVQQKEwpHbG9iYWxTaWduMRMwEQYDVQQDEwpHbG9iYWxTaWdu
-MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEuMZ5049sJQ6fLjkZHAOkrprlOQcJ
-FspjsbmG+IpXwVfOQvpzofdlQv8ewQCybnMO/8ch5RikqtlxP6jUuc6MHaNCMEAw
-DgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFFSwe61F
-uOJAf/sKbvu+M8k8o4TVMAoGCCqGSM49BAMCA0gAMEUCIQDckqGgE6bPA7DmxCGX
-kPoUVy0D7O48027KqGx2vKLeuwIgJ6iFJzWbVsaj8kfSt24bAgAXqmemFZHe+pTs
-ewv4n4Q=
------END CERTIFICATE-----
-
 # Issuer: CN=GlobalSign O=GlobalSign OU=GlobalSign ECC Root CA - R5
 # Subject: CN=GlobalSign O=GlobalSign OU=GlobalSign ECC Root CA - R5
 # Label: "GlobalSign ECC Root CA - R5"
@@ -3337,126 +3228,6 @@ rYy0UGYwEAYJKwYBBAGCNxUBBAMCAQAwCgYIKoZIzj0EAwMDaAAwZQIwJsdpW9zV
 Mgj/mkkCtojeFK9dbJlxjRo/i9fgojaGHAeCOnZT/cKi7e97sIBPWA9LUzm9
 -----END CERTIFICATE-----
 
-# Issuer: CN=GTS Root R1 O=Google Trust Services LLC
-# Subject: CN=GTS Root R1 O=Google Trust Services LLC
-# Label: "GTS Root R1"
-# Serial: 146587175971765017618439757810265552097
-# MD5 Fingerprint: 82:1a:ef:d4:d2:4a:f2:9f:e2:3d:97:06:14:70:72:85
-# SHA1 Fingerprint: e1:c9:50:e6:ef:22:f8:4c:56:45:72:8b:92:20:60:d7:d5:a7:a3:e8
-# SHA256 Fingerprint: 2a:57:54:71:e3:13:40:bc:21:58:1c:bd:2c:f1:3e:15:84:63:20:3e:ce:94:bc:f9:d3:cc:19:6b:f0:9a:54:72
------BEGIN CERTIFICATE-----
-MIIFWjCCA0KgAwIBAgIQbkepxUtHDA3sM9CJuRz04TANBgkqhkiG9w0BAQwFADBH
-MQswCQYDVQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZpY2VzIExM
-QzEUMBIGA1UEAxMLR1RTIFJvb3QgUjEwHhcNMTYwNjIyMDAwMDAwWhcNMzYwNjIy
-MDAwMDAwWjBHMQswCQYDVQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNl
-cnZpY2VzIExMQzEUMBIGA1UEAxMLR1RTIFJvb3QgUjEwggIiMA0GCSqGSIb3DQEB
-AQUAA4ICDwAwggIKAoICAQC2EQKLHuOhd5s73L+UPreVp0A8of2C+X0yBoJx9vaM
-f/vo27xqLpeXo4xL+Sv2sfnOhB2x+cWX3u+58qPpvBKJXqeqUqv4IyfLpLGcY9vX
-mX7wCl7raKb0xlpHDU0QM+NOsROjyBhsS+z8CZDfnWQpJSMHobTSPS5g4M/SCYe7
-zUjwTcLCeoiKu7rPWRnWr4+wB7CeMfGCwcDfLqZtbBkOtdh+JhpFAz2weaSUKK0P
-fyblqAj+lug8aJRT7oM6iCsVlgmy4HqMLnXWnOunVmSPlk9orj2XwoSPwLxAwAtc
-vfaHszVsrBhQf4TgTM2S0yDpM7xSma8ytSmzJSq0SPly4cpk9+aCEI3oncKKiPo4
-Zor8Y/kB+Xj9e1x3+naH+uzfsQ55lVe0vSbv1gHR6xYKu44LtcXFilWr06zqkUsp
-zBmkMiVOKvFlRNACzqrOSbTqn3yDsEB750Orp2yjj32JgfpMpf/VjsPOS+C12LOO
-Rc92wO1AK/1TD7Cn1TsNsYqiA94xrcx36m97PtbfkSIS5r762DL8EGMUUXLeXdYW
-k70paDPvOmbsB4om3xPXV2V4J95eSRQAogB/mqghtqmxlbCluQ0WEdrHbEg8QOB+
-DVrNVjzRlwW5y0vtOUucxD/SVRNuJLDWcfr0wbrM7Rv1/oFB2ACYPTrIrnqYNxgF
-lQIDAQABo0IwQDAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAdBgNV
-HQ4EFgQU5K8rJnEaK0gnhS9SZizv8IkTcT4wDQYJKoZIhvcNAQEMBQADggIBADiW
-Cu49tJYeX++dnAsznyvgyv3SjgofQXSlfKqE1OXyHuY3UjKcC9FhHb8owbZEKTV1
-d5iyfNm9dKyKaOOpMQkpAWBz40d8U6iQSifvS9efk+eCNs6aaAyC58/UEBZvXw6Z
-XPYfcX3v73svfuo21pdwCxXu11xWajOl40k4DLh9+42FpLFZXvRq4d2h9mREruZR
-gyFmxhE+885H7pwoHyXa/6xmld01D1zvICxi/ZG6qcz8WpyTgYMpl0p8WnK0OdC3
-d8t5/Wk6kjftbjhlRn7pYL15iJdfOBL07q9bgsiG1eGZbYwE8na6SfZu6W0eX6Dv
-J4J2QPim01hcDyxC2kLGe4g0x8HYRZvBPsVhHdljUEn2NIVq4BjFbkerQUIpm/Zg
-DdIx02OYI5NaAIFItO/Nis3Jz5nu2Z6qNuFoS3FJFDYoOj0dzpqPJeaAcWErtXvM
-+SUWgeExX6GjfhaknBZqlxi9dnKlC54dNuYvoS++cJEPqOba+MSSQGwlfnuzCdyy
-F62ARPBopY+Udf90WuioAnwMCeKpSwughQtiue+hMZL77/ZRBIls6Kl0obsXs7X9
-SQ98POyDGCBDTtWTurQ0sR8WNh8M5mQ5Fkzc4P4dyKliPUDqysU0ArSuiYgzNdws
-E3PYJ/HQcu51OyLemGhmW/HGY0dVHLqlCFF1pkgl
------END CERTIFICATE-----
-
-# Issuer: CN=GTS Root R2 O=Google Trust Services LLC
-# Subject: CN=GTS Root R2 O=Google Trust Services LLC
-# Label: "GTS Root R2"
-# Serial: 146587176055767053814479386953112547951
-# MD5 Fingerprint: 44:ed:9a:0e:a4:09:3b:00:f2:ae:4c:a3:c6:61:b0:8b
-# SHA1 Fingerprint: d2:73:96:2a:2a:5e:39:9f:73:3f:e1:c7:1e:64:3f:03:38:34:fc:4d
-# SHA256 Fingerprint: c4:5d:7b:b0:8e:6d:67:e6:2e:42:35:11:0b:56:4e:5f:78:fd:92:ef:05:8c:84:0a:ea:4e:64:55:d7:58:5c:60
------BEGIN CERTIFICATE-----
-MIIFWjCCA0KgAwIBAgIQbkepxlqz5yDFMJo/aFLybzANBgkqhkiG9w0BAQwFADBH
-MQswCQYDVQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZpY2VzIExM
-QzEUMBIGA1UEAxMLR1RTIFJvb3QgUjIwHhcNMTYwNjIyMDAwMDAwWhcNMzYwNjIy
-MDAwMDAwWjBHMQswCQYDVQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNl
-cnZpY2VzIExMQzEUMBIGA1UEAxMLR1RTIFJvb3QgUjIwggIiMA0GCSqGSIb3DQEB
-AQUAA4ICDwAwggIKAoICAQDO3v2m++zsFDQ8BwZabFn3GTXd98GdVarTzTukk3Lv
-CvptnfbwhYBboUhSnznFt+4orO/LdmgUud+tAWyZH8QiHZ/+cnfgLFuv5AS/T3Kg
-GjSY6Dlo7JUle3ah5mm5hRm9iYz+re026nO8/4Piy33B0s5Ks40FnotJk9/BW9Bu
-XvAuMC6C/Pq8tBcKSOWIm8Wba96wyrQD8Nr0kLhlZPdcTK3ofmZemde4wj7I0BOd
-re7kRXuJVfeKH2JShBKzwkCX44ofR5GmdFrS+LFjKBC4swm4VndAoiaYecb+3yXu
-PuWgf9RhD1FLPD+M2uFwdNjCaKH5wQzpoeJ/u1U8dgbuak7MkogwTZq9TwtImoS1
-mKPV+3PBV2HdKFZ1E66HjucMUQkQdYhMvI35ezzUIkgfKtzra7tEscszcTJGr61K
-8YzodDqs5xoic4DSMPclQsciOzsSrZYuxsN2B6ogtzVJV+mSSeh2FnIxZyuWfoqj
-x5RWIr9qS34BIbIjMt/kmkRtWVtd9QCgHJvGeJeNkP+byKq0rxFROV7Z+2et1VsR
-nTKaG73VululycslaVNVJ1zgyjbLiGH7HrfQy+4W+9OmTN6SpdTi3/UGVN4unUu0
-kzCqgc7dGtxRcw1PcOnlthYhGXmy5okLdWTK1au8CcEYof/UVKGFPP0UJAOyh9Ok
-twIDAQABo0IwQDAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAdBgNV
-HQ4EFgQUu//KjiOfT5nK2+JopqUVJxce2Q4wDQYJKoZIhvcNAQEMBQADggIBALZp
-8KZ3/p7uC4Gt4cCpx/k1HUCCq+YEtN/L9x0Pg/B+E02NjO7jMyLDOfxA325BS0JT
-vhaI8dI4XsRomRyYUpOM52jtG2pzegVATX9lO9ZY8c6DR2Dj/5epnGB3GFW1fgiT
-z9D2PGcDFWEJ+YF59exTpJ/JjwGLc8R3dtyDovUMSRqodt6Sm2T4syzFJ9MHwAiA
-pJiS4wGWAqoC7o87xdFtCjMwc3i5T1QWvwsHoaRc5svJXISPD+AVdyx+Jn7axEvb
-pxZ3B7DNdehyQtaVhJ2Gg/LkkM0JR9SLA3DaWsYDQvTtN6LwG1BUSw7YhN4ZKJmB
-R64JGz9I0cNv4rBgF/XuIwKl2gBbbZCr7qLpGzvpx0QnRY5rn/WkhLx3+WuXrD5R
-RaIRpsyF7gpo8j5QOHokYh4XIDdtak23CZvJ/KRY9bb7nE4Yu5UC56GtmwfuNmsk
-0jmGwZODUNKBRqhfYlcsu2xkiAhu7xNUX90txGdj08+JN7+dIPT7eoOboB6BAFDC
-5AwiWVIQ7UNWhwD4FFKnHYuTjKJNRn8nxnGbJN7k2oaLDX5rIMHAnuFl2GqjpuiF
-izoHCBy69Y9Vmhh1fuXsgWbRIXOhNUQLgD1bnF5vKheW0YMjiGZt5obicDIvUiLn
-yOd/xCxgXS/Dr55FBcOEArf9LAhST4Ldo/DUhgkC
------END CERTIFICATE-----
-
-# Issuer: CN=GTS Root R3 O=Google Trust Services LLC
-# Subject: CN=GTS Root R3 O=Google Trust Services LLC
-# Label: "GTS Root R3"
-# Serial: 146587176140553309517047991083707763997
-# MD5 Fingerprint: 1a:79:5b:6b:04:52:9c:5d:c7:74:33:1b:25:9a:f9:25
-# SHA1 Fingerprint: 30:d4:24:6f:07:ff:db:91:89:8a:0b:e9:49:66:11:eb:8c:5e:46:e5
-# SHA256 Fingerprint: 15:d5:b8:77:46:19:ea:7d:54:ce:1c:a6:d0:b0:c4:03:e0:37:a9:17:f1:31:e8:a0:4e:1e:6b:7a:71:ba:bc:e5
------BEGIN CERTIFICATE-----
-MIICDDCCAZGgAwIBAgIQbkepx2ypcyRAiQ8DVd2NHTAKBggqhkjOPQQDAzBHMQsw
-CQYDVQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZpY2VzIExMQzEU
-MBIGA1UEAxMLR1RTIFJvb3QgUjMwHhcNMTYwNjIyMDAwMDAwWhcNMzYwNjIyMDAw
-MDAwWjBHMQswCQYDVQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZp
-Y2VzIExMQzEUMBIGA1UEAxMLR1RTIFJvb3QgUjMwdjAQBgcqhkjOPQIBBgUrgQQA
-IgNiAAQfTzOHMymKoYTey8chWEGJ6ladK0uFxh1MJ7x/JlFyb+Kf1qPKzEUURout
-736GjOyxfi//qXGdGIRFBEFVbivqJn+7kAHjSxm65FSWRQmx1WyRRK2EE46ajA2A
-DDL24CejQjBAMA4GA1UdDwEB/wQEAwIBBjAPBgNVHRMBAf8EBTADAQH/MB0GA1Ud
-DgQWBBTB8Sa6oC2uhYHP0/EqEr24Cmf9vDAKBggqhkjOPQQDAwNpADBmAjEAgFuk
-fCPAlaUs3L6JbyO5o91lAFJekazInXJ0glMLfalAvWhgxeG4VDvBNhcl2MG9AjEA
-njWSdIUlUfUk7GRSJFClH9voy8l27OyCbvWFGFPouOOaKaqW04MjyaR7YbPMAuhd
------END CERTIFICATE-----
-
-# Issuer: CN=GTS Root R4 O=Google Trust Services LLC
-# Subject: CN=GTS Root R4 O=Google Trust Services LLC
-# Label: "GTS Root R4"
-# Serial: 146587176229350439916519468929765261721
-# MD5 Fingerprint: 5d:b6:6a:c4:60:17:24:6a:1a:99:a8:4b:ee:5e:b4:26
-# SHA1 Fingerprint: 2a:1d:60:27:d9:4a:b1:0a:1c:4d:91:5c:cd:33:a0:cb:3e:2d:54:cb
-# SHA256 Fingerprint: 71:cc:a5:39:1f:9e:79:4b:04:80:25:30:b3:63:e1:21:da:8a:30:43:bb:26:66:2f:ea:4d:ca:7f:c9:51:a4:bd
------BEGIN CERTIFICATE-----
-MIICCjCCAZGgAwIBAgIQbkepyIuUtui7OyrYorLBmTAKBggqhkjOPQQDAzBHMQsw
-CQYDVQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZpY2VzIExMQzEU
-MBIGA1UEAxMLR1RTIFJvb3QgUjQwHhcNMTYwNjIyMDAwMDAwWhcNMzYwNjIyMDAw
-MDAwWjBHMQswCQYDVQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZp
-Y2VzIExMQzEUMBIGA1UEAxMLR1RTIFJvb3QgUjQwdjAQBgcqhkjOPQIBBgUrgQQA
-IgNiAATzdHOnaItgrkO4NcWBMHtLSZ37wWHO5t5GvWvVYRg1rkDdc/eJkTBa6zzu
-hXyiQHY7qca4R9gq55KRanPpsXI5nymfopjTX15YhmUPoYRlBtHci8nHc8iMai/l
-xKvRHYqjQjBAMA4GA1UdDwEB/wQEAwIBBjAPBgNVHRMBAf8EBTADAQH/MB0GA1Ud
-DgQWBBSATNbrdP9JNqPV2Py1PsVq8JQdjDAKBggqhkjOPQQDAwNnADBkAjBqUFJ0
-CMRw3J5QdCHojXohw0+WbhXRIjVhLfoIN+4Zba3bssx9BzT1YBkstTTZbyACMANx
-sbqjYAuG7ZoIapVon+Kz4ZNkfF6Tpt95LY2F45TPI11xzPKwTdb+mciUqXWi4w==
------END CERTIFICATE-----
-
 # Issuer: CN=UCA Global G2 Root O=UniTrust
 # Subject: CN=UCA Global G2 Root O=UniTrust
 # Label: "UCA Global G2 Root"
@@ -4360,3 +4131,400 @@ AgGGMAoGCCqGSM49BAMDA2cAMGQCMBHervjcToiwqfAircJRQO9gcS3ujwLEXQNw
 SaSS6sUUiHCm0w2wqsosQJz76YJumgIwK0eaB8bRwoF8yguWGEEbo/QwCZ61IygN
 nxS2PFOiTAZpffpskcYqSUXm7LcT4Tps
 -----END CERTIFICATE-----
+
+# Issuer: CN=Autoridad de Certificacion Firmaprofesional CIF A62634068
+# Subject: CN=Autoridad de Certificacion Firmaprofesional CIF A62634068
+# Label: "Autoridad de Certificacion Firmaprofesional CIF A62634068"
+# Serial: 1977337328857672817
+# MD5 Fingerprint: 4e:6e:9b:54:4c:ca:b7:fa:48:e4:90:b1:15:4b:1c:a3
+# SHA1 Fingerprint: 0b:be:c2:27:22:49:cb:39:aa:db:35:5c:53:e3:8c:ae:78:ff:b6:fe
+# SHA256 Fingerprint: 57:de:05:83:ef:d2:b2:6e:03:61:da:99:da:9d:f4:64:8d:ef:7e:e8:44:1c:3b:72:8a:fa:9b:cd:e0:f9:b2:6a
+-----BEGIN CERTIFICATE-----
+MIIGFDCCA/ygAwIBAgIIG3Dp0v+ubHEwDQYJKoZIhvcNAQELBQAwUTELMAkGA1UE
+BhMCRVMxQjBABgNVBAMMOUF1dG9yaWRhZCBkZSBDZXJ0aWZpY2FjaW9uIEZpcm1h
+cHJvZmVzaW9uYWwgQ0lGIEE2MjYzNDA2ODAeFw0xNDA5MjMxNTIyMDdaFw0zNjA1
+MDUxNTIyMDdaMFExCzAJBgNVBAYTAkVTMUIwQAYDVQQDDDlBdXRvcmlkYWQgZGUg
+Q2VydGlmaWNhY2lvbiBGaXJtYXByb2Zlc2lvbmFsIENJRiBBNjI2MzQwNjgwggIi
+MA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDKlmuO6vj78aI14H9M2uDDUtd9
+thDIAl6zQyrET2qyyhxdKJp4ERppWVevtSBC5IsP5t9bpgOSL/UR5GLXMnE42QQM
+cas9UX4PB99jBVzpv5RvwSmCwLTaUbDBPLutN0pcyvFLNg4kq7/DhHf9qFD0sefG
+L9ItWY16Ck6WaVICqjaY7Pz6FIMMNx/Jkjd/14Et5cS54D40/mf0PmbR0/RAz15i
+NA9wBj4gGFrO93IbJWyTdBSTo3OxDqqHECNZXyAFGUftaI6SEspd/NYrspI8IM/h
+X68gvqB2f3bl7BqGYTM+53u0P6APjqK5am+5hyZvQWyIplD9amML9ZMWGxmPsu2b
+m8mQ9QEM3xk9Dz44I8kvjwzRAv4bVdZO0I08r0+k8/6vKtMFnXkIoctXMbScyJCy
+Z/QYFpM6/EfY0XiWMR+6KwxfXZmtY4laJCB22N/9q06mIqqdXuYnin1oKaPnirja
+EbsXLZmdEyRG98Xi2J+Of8ePdG1asuhy9azuJBCtLxTa/y2aRnFHvkLfuwHb9H/T
+KI8xWVvTyQKmtFLKbpf7Q8UIJm+K9Lv9nyiqDdVF8xM6HdjAeI9BZzwelGSuewvF
+6NkBiDkal4ZkQdU7hwxu+g/GvUgUvzlN1J5Bto+WHWOWk9mVBngxaJ43BjuAiUVh
+OSPHG0SjFeUc+JIwuwIDAQABo4HvMIHsMB0GA1UdDgQWBBRlzeurNR4APn7VdMAc
+tHNHDhpkLzASBgNVHRMBAf8ECDAGAQH/AgEBMIGmBgNVHSAEgZ4wgZswgZgGBFUd
+IAAwgY8wLwYIKwYBBQUHAgEWI2h0dHA6Ly93d3cuZmlybWFwcm9mZXNpb25hbC5j
+b20vY3BzMFwGCCsGAQUFBwICMFAeTgBQAGEAcwBlAG8AIABkAGUAIABsAGEAIABC
+AG8AbgBhAG4AbwB2AGEAIAA0ADcAIABCAGEAcgBjAGUAbABvAG4AYQAgADAAOAAw
+ADEANzAOBgNVHQ8BAf8EBAMCAQYwDQYJKoZIhvcNAQELBQADggIBAHSHKAIrdx9m
+iWTtj3QuRhy7qPj4Cx2Dtjqn6EWKB7fgPiDL4QjbEwj4KKE1soCzC1HA01aajTNF
+Sa9J8OA9B3pFE1r/yJfY0xgsfZb43aJlQ3CTkBW6kN/oGbDbLIpgD7dvlAceHabJ
+hfa9NPhAeGIQcDq+fUs5gakQ1JZBu/hfHAsdCPKxsIl68veg4MSPi3i1O1ilI45P
+Vf42O+AMt8oqMEEgtIDNrvx2ZnOorm7hfNoD6JQg5iKj0B+QXSBTFCZX2lSX3xZE
+EAEeiGaPcjiT3SC3NL7X8e5jjkd5KAb881lFJWAiMxujX6i6KtoaPc1A6ozuBRWV
+1aUsIC+nmCjuRfzxuIgALI9C2lHVnOUTaHFFQ4ueCyE8S1wF3BqfmI7avSKecs2t
+CsvMo2ebKHTEm9caPARYpoKdrcd7b/+Alun4jWq9GJAd/0kakFI3ky88Al2CdgtR
+5xbHV/g4+afNmyJU72OwFW1TZQNKXkqgsqeOSQBZONXH9IBk9W6VULgRfhVwOEqw
+f9DEMnDAGf/JOC0ULGb0QkTmVXYbgBVX/8Cnp6o5qtjTcNAuuuuUavpfNIbnYrX9
+ivAwhZTJryQCL2/W3Wf+47BVTwSYT6RBVuKT0Gro1vP7ZeDOdcQxWQzugsgMYDNK
+GbqEZycPvEJdvSRUDewdcAZfpLz6IHxV
+-----END CERTIFICATE-----
+
+# Issuer: CN=vTrus ECC Root CA O=iTrusChina Co.,Ltd.
+# Subject: CN=vTrus ECC Root CA O=iTrusChina Co.,Ltd.
+# Label: "vTrus ECC Root CA"
+# Serial: 630369271402956006249506845124680065938238527194
+# MD5 Fingerprint: de:4b:c1:f5:52:8c:9b:43:e1:3e:8f:55:54:17:8d:85
+# SHA1 Fingerprint: f6:9c:db:b0:fc:f6:02:13:b6:52:32:a6:a3:91:3f:16:70:da:c3:e1
+# SHA256 Fingerprint: 30:fb:ba:2c:32:23:8e:2a:98:54:7a:f9:79:31:e5:50:42:8b:9b:3f:1c:8e:eb:66:33:dc:fa:86:c5:b2:7d:d3
+-----BEGIN CERTIFICATE-----
+MIICDzCCAZWgAwIBAgIUbmq8WapTvpg5Z6LSa6Q75m0c1towCgYIKoZIzj0EAwMw
+RzELMAkGA1UEBhMCQ04xHDAaBgNVBAoTE2lUcnVzQ2hpbmEgQ28uLEx0ZC4xGjAY
+BgNVBAMTEXZUcnVzIEVDQyBSb290IENBMB4XDTE4MDczMTA3MjY0NFoXDTQzMDcz
+MTA3MjY0NFowRzELMAkGA1UEBhMCQ04xHDAaBgNVBAoTE2lUcnVzQ2hpbmEgQ28u
+LEx0ZC4xGjAYBgNVBAMTEXZUcnVzIEVDQyBSb290IENBMHYwEAYHKoZIzj0CAQYF
+K4EEACIDYgAEZVBKrox5lkqqHAjDo6LN/llWQXf9JpRCux3NCNtzslt188+cToL0
+v/hhJoVs1oVbcnDS/dtitN9Ti72xRFhiQgnH+n9bEOf+QP3A2MMrMudwpremIFUd
+e4BdS49nTPEQo0IwQDAdBgNVHQ4EFgQUmDnNvtiyjPeyq+GtJK97fKHbH88wDwYD
+VR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwCgYIKoZIzj0EAwMDaAAwZQIw
+V53dVvHH4+m4SVBrm2nDb+zDfSXkV5UTQJtS0zvzQBm8JsctBp61ezaf9SXUY2sA
+AjEA6dPGnlaaKsyh2j/IZivTWJwghfqrkYpwcBE4YGQLYgmRWAD5Tfs0aNoJrSEG
+GJTO
+-----END CERTIFICATE-----
+
+# Issuer: CN=vTrus Root CA O=iTrusChina Co.,Ltd.
+# Subject: CN=vTrus Root CA O=iTrusChina Co.,Ltd.
+# Label: "vTrus Root CA"
+# Serial: 387574501246983434957692974888460947164905180485
+# MD5 Fingerprint: b8:c9:37:df:fa:6b:31:84:64:c5:ea:11:6a:1b:75:fc
+# SHA1 Fingerprint: 84:1a:69:fb:f5:cd:1a:25:34:13:3d:e3:f8:fc:b8:99:d0:c9:14:b7
+# SHA256 Fingerprint: 8a:71:de:65:59:33:6f:42:6c:26:e5:38:80:d0:0d:88:a1:8d:a4:c6:a9:1f:0d:cb:61:94:e2:06:c5:c9:63:87
+-----BEGIN CERTIFICATE-----
+MIIFVjCCAz6gAwIBAgIUQ+NxE9izWRRdt86M/TX9b7wFjUUwDQYJKoZIhvcNAQEL
+BQAwQzELMAkGA1UEBhMCQ04xHDAaBgNVBAoTE2lUcnVzQ2hpbmEgQ28uLEx0ZC4x
+FjAUBgNVBAMTDXZUcnVzIFJvb3QgQ0EwHhcNMTgwNzMxMDcyNDA1WhcNNDMwNzMx
+MDcyNDA1WjBDMQswCQYDVQQGEwJDTjEcMBoGA1UEChMTaVRydXNDaGluYSBDby4s
+THRkLjEWMBQGA1UEAxMNdlRydXMgUm9vdCBDQTCCAiIwDQYJKoZIhvcNAQEBBQAD
+ggIPADCCAgoCggIBAL1VfGHTuB0EYgWgrmy3cLRB6ksDXhA/kFocizuwZotsSKYc
+IrrVQJLuM7IjWcmOvFjai57QGfIvWcaMY1q6n6MLsLOaXLoRuBLpDLvPbmyAhykU
+AyyNJJrIZIO1aqwTLDPxn9wsYTwaP3BVm60AUn/PBLn+NvqcwBauYv6WTEN+VRS+
+GrPSbcKvdmaVayqwlHeFXgQPYh1jdfdr58tbmnDsPmcF8P4HCIDPKNsFxhQnL4Z9
+8Cfe/+Z+M0jnCx5Y0ScrUw5XSmXX+6KAYPxMvDVTAWqXcoKv8R1w6Jz1717CbMdH
+flqUhSZNO7rrTOiwCcJlwp2dCZtOtZcFrPUGoPc2BX70kLJrxLT5ZOrpGgrIDajt
+J8nU57O5q4IikCc9Kuh8kO+8T/3iCiSn3mUkpF3qwHYw03dQ+A0Em5Q2AXPKBlim
+0zvc+gRGE1WKyURHuFE5Gi7oNOJ5y1lKCn+8pu8fA2dqWSslYpPZUxlmPCdiKYZN
+pGvu/9ROutW04o5IWgAZCfEF2c6Rsffr6TlP9m8EQ5pV9T4FFL2/s1m02I4zhKOQ
+UqqzApVg+QxMaPnu1RcN+HFXtSXkKe5lXa/R7jwXC1pDxaWG6iSe4gUH3DRCEpHW
+OXSuTEGC2/KmSNGzm/MzqvOmwMVO9fSddmPmAsYiS8GVP1BkLFTltvA8Kc9XAgMB
+AAGjQjBAMB0GA1UdDgQWBBRUYnBj8XWEQ1iO0RYgscasGrz2iTAPBgNVHRMBAf8E
+BTADAQH/MA4GA1UdDwEB/wQEAwIBBjANBgkqhkiG9w0BAQsFAAOCAgEAKbqSSaet
+8PFww+SX8J+pJdVrnjT+5hpk9jprUrIQeBqfTNqK2uwcN1LgQkv7bHbKJAs5EhWd
+nxEt/Hlk3ODg9d3gV8mlsnZwUKT+twpw1aA08XXXTUm6EdGz2OyC/+sOxL9kLX1j
+bhd47F18iMjrjld22VkE+rxSH0Ws8HqA7Oxvdq6R2xCOBNyS36D25q5J08FsEhvM
+Kar5CKXiNxTKsbhm7xqC5PD48acWabfbqWE8n/Uxy+QARsIvdLGx14HuqCaVvIiv
+TDUHKgLKeBRtRytAVunLKmChZwOgzoy8sHJnxDHO2zTlJQNgJXtxmOTAGytfdELS
+S8VZCAeHvsXDf+eW2eHcKJfWjwXj9ZtOyh1QRwVTsMo554WgicEFOwE30z9J4nfr
+I8iIZjs9OXYhRvHsXyO466JmdXTBQPfYaJqT4i2pLr0cox7IdMakLXogqzu4sEb9
+b91fUlV1YvCXoHzXOP0l382gmxDPi7g4Xl7FtKYCNqEeXxzP4padKar9mK5S4fNB
+UvupLnKWnyfjqnN9+BojZns7q2WwMgFLFT49ok8MKzWixtlnEjUwzXYuFrOZnk1P
+Ti07NEPhmg4NpGaXutIcSkwsKouLgU9xGqndXHt7CMUADTdA43x7VF8vhV929ven
+sBxXVsFy6K2ir40zSbofitzmdHxghm+Hl3s=
+-----END CERTIFICATE-----
+
+# Issuer: CN=ISRG Root X2 O=Internet Security Research Group
+# Subject: CN=ISRG Root X2 O=Internet Security Research Group
+# Label: "ISRG Root X2"
+# Serial: 87493402998870891108772069816698636114
+# MD5 Fingerprint: d3:9e:c4:1e:23:3c:a6:df:cf:a3:7e:6d:e0:14:e6:e5
+# SHA1 Fingerprint: bd:b1:b9:3c:d5:97:8d:45:c6:26:14:55:f8:db:95:c7:5a:d1:53:af
+# SHA256 Fingerprint: 69:72:9b:8e:15:a8:6e:fc:17:7a:57:af:b7:17:1d:fc:64:ad:d2:8c:2f:ca:8c:f1:50:7e:34:45:3c:cb:14:70
+-----BEGIN CERTIFICATE-----
+MIICGzCCAaGgAwIBAgIQQdKd0XLq7qeAwSxs6S+HUjAKBggqhkjOPQQDAzBPMQsw
+CQYDVQQGEwJVUzEpMCcGA1UEChMgSW50ZXJuZXQgU2VjdXJpdHkgUmVzZWFyY2gg
+R3JvdXAxFTATBgNVBAMTDElTUkcgUm9vdCBYMjAeFw0yMDA5MDQwMDAwMDBaFw00
+MDA5MTcxNjAwMDBaME8xCzAJBgNVBAYTAlVTMSkwJwYDVQQKEyBJbnRlcm5ldCBT
+ZWN1cml0eSBSZXNlYXJjaCBHcm91cDEVMBMGA1UEAxMMSVNSRyBSb290IFgyMHYw
+EAYHKoZIzj0CAQYFK4EEACIDYgAEzZvVn4CDCuwJSvMWSj5cz3es3mcFDR0HttwW
++1qLFNvicWDEukWVEYmO6gbf9yoWHKS5xcUy4APgHoIYOIvXRdgKam7mAHf7AlF9
+ItgKbppbd9/w+kHsOdx1ymgHDB/qo0IwQDAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0T
+AQH/BAUwAwEB/zAdBgNVHQ4EFgQUfEKWrt5LSDv6kviejM9ti6lyN5UwCgYIKoZI
+zj0EAwMDaAAwZQIwe3lORlCEwkSHRhtFcP9Ymd70/aTSVaYgLXTWNLxBo1BfASdW
+tL4ndQavEi51mI38AjEAi/V3bNTIZargCyzuFJ0nN6T5U6VR5CmD1/iQMVtCnwr1
+/q4AaOeMSQ+2b1tbFfLn
+-----END CERTIFICATE-----
+
+# Issuer: CN=HiPKI Root CA - G1 O=Chunghwa Telecom Co., Ltd.
+# Subject: CN=HiPKI Root CA - G1 O=Chunghwa Telecom Co., Ltd.
+# Label: "HiPKI Root CA - G1"
+# Serial: 60966262342023497858655262305426234976
+# MD5 Fingerprint: 69:45:df:16:65:4b:e8:68:9a:8f:76:5f:ff:80:9e:d3
+# SHA1 Fingerprint: 6a:92:e4:a8:ee:1b:ec:96:45:37:e3:29:57:49:cd:96:e3:e5:d2:60
+# SHA256 Fingerprint: f0:15:ce:3c:c2:39:bf:ef:06:4b:e9:f1:d2:c4:17:e1:a0:26:4a:0a:94:be:1f:0c:8d:12:18:64:eb:69:49:cc
+-----BEGIN CERTIFICATE-----
+MIIFajCCA1KgAwIBAgIQLd2szmKXlKFD6LDNdmpeYDANBgkqhkiG9w0BAQsFADBP
+MQswCQYDVQQGEwJUVzEjMCEGA1UECgwaQ2h1bmdod2EgVGVsZWNvbSBDby4sIEx0
+ZC4xGzAZBgNVBAMMEkhpUEtJIFJvb3QgQ0EgLSBHMTAeFw0xOTAyMjIwOTQ2MDRa
+Fw0zNzEyMzExNTU5NTlaME8xCzAJBgNVBAYTAlRXMSMwIQYDVQQKDBpDaHVuZ2h3
+YSBUZWxlY29tIENvLiwgTHRkLjEbMBkGA1UEAwwSSGlQS0kgUm9vdCBDQSAtIEcx
+MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA9B5/UnMyDHPkvRN0o9Qw
+qNCuS9i233VHZvR85zkEHmpwINJaR3JnVfSl6J3VHiGh8Ge6zCFovkRTv4354twv
+Vcg3Px+kwJyz5HdcoEb+d/oaoDjq7Zpy3iu9lFc6uux55199QmQ5eiY29yTw1S+6
+lZgRZq2XNdZ1AYDgr/SEYYwNHl98h5ZeQa/rh+r4XfEuiAU+TCK72h8q3VJGZDnz
+Qs7ZngyzsHeXZJzA9KMuH5UHsBffMNsAGJZMoYFL3QRtU6M9/Aes1MU3guvklQgZ
+KILSQjqj2FPseYlgSGDIcpJQ3AOPgz+yQlda22rpEZfdhSi8MEyr48KxRURHH+CK
+FgeW0iEPU8DtqX7UTuybCeyvQqww1r/REEXgphaypcXTT3OUM3ECoWqj1jOXTyFj
+HluP2cFeRXF3D4FdXyGarYPM+l7WjSNfGz1BryB1ZlpK9p/7qxj3ccC2HTHsOyDr
+y+K49a6SsvfhhEvyovKTmiKe0xRvNlS9H15ZFblzqMF8b3ti6RZsR1pl8w4Rm0bZ
+/W3c1pzAtH2lsN0/Vm+h+fbkEkj9Bn8SV7apI09bA8PgcSojt/ewsTu8mL3WmKgM
+a/aOEmem8rJY5AIJEzypuxC00jBF8ez3ABHfZfjcK0NVvxaXxA/VLGGEqnKG/uY6
+fsI/fe78LxQ+5oXdUG+3Se0CAwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAdBgNV
+HQ4EFgQU8ncX+l6o/vY9cdVouslGDDjYr7AwDgYDVR0PAQH/BAQDAgGGMA0GCSqG
+SIb3DQEBCwUAA4ICAQBQUfB13HAE4/+qddRxosuej6ip0691x1TPOhwEmSKsxBHi
+7zNKpiMdDg1H2DfHb680f0+BazVP6XKlMeJ45/dOlBhbQH3PayFUhuaVevvGyuqc
+SE5XCV0vrPSltJczWNWseanMX/mF+lLFjfiRFOs6DRfQUsJ748JzjkZ4Bjgs6Fza
+ZsT0pPBWGTMpWmWSBUdGSquEwx4noR8RkpkndZMPvDY7l1ePJlsMu5wP1G4wB9Tc
+XzZoZjmDlicmisjEOf6aIW/Vcobpf2Lll07QJNBAsNB1CI69aO4I1258EHBGG3zg
+iLKecoaZAeO/n0kZtCW+VmWuF2PlHt/o/0elv+EmBYTksMCv5wiZqAxeJoBF1Pho
+L5aPruJKHJwWDBNvOIf2u8g0X5IDUXlwpt/L9ZlNec1OvFefQ05rLisY+GpzjLrF
+Ne85akEez3GoorKGB1s6yeHvP2UEgEcyRHCVTjFnanRbEEV16rCf0OY1/k6fi8wr
+kkVbbiVghUbN0aqwdmaTd5a+g744tiROJgvM7XpWGuDpWsZkrUx6AEhEL7lAuxM+
+vhV4nYWBSipX3tUZQ9rbyltHhoMLP7YNdnhzeSJesYAfz77RP1YQmCuVh6EfnWQU
+YDksswBVLuT1sw5XxJFBAJw/6KXf6vb/yPCtbVKoF6ubYfwSUTXkJf2vqmqGOQ==
+-----END CERTIFICATE-----
+
+# Issuer: CN=GlobalSign O=GlobalSign OU=GlobalSign ECC Root CA - R4
+# Subject: CN=GlobalSign O=GlobalSign OU=GlobalSign ECC Root CA - R4
+# Label: "GlobalSign ECC Root CA - R4"
+# Serial: 159662223612894884239637590694
+# MD5 Fingerprint: 26:29:f8:6d:e1:88:bf:a2:65:7f:aa:c4:cd:0f:7f:fc
+# SHA1 Fingerprint: 6b:a0:b0:98:e1:71:ef:5a:ad:fe:48:15:80:77:10:f4:bd:6f:0b:28
+# SHA256 Fingerprint: b0:85:d7:0b:96:4f:19:1a:73:e4:af:0d:54:ae:7a:0e:07:aa:fd:af:9b:71:dd:08:62:13:8a:b7:32:5a:24:a2
+-----BEGIN CERTIFICATE-----
+MIIB3DCCAYOgAwIBAgINAgPlfvU/k/2lCSGypjAKBggqhkjOPQQDAjBQMSQwIgYD
+VQQLExtHbG9iYWxTaWduIEVDQyBSb290IENBIC0gUjQxEzARBgNVBAoTCkdsb2Jh
+bFNpZ24xEzARBgNVBAMTCkdsb2JhbFNpZ24wHhcNMTIxMTEzMDAwMDAwWhcNMzgw
+MTE5MDMxNDA3WjBQMSQwIgYDVQQLExtHbG9iYWxTaWduIEVDQyBSb290IENBIC0g
+UjQxEzARBgNVBAoTCkdsb2JhbFNpZ24xEzARBgNVBAMTCkdsb2JhbFNpZ24wWTAT
+BgcqhkjOPQIBBggqhkjOPQMBBwNCAAS4xnnTj2wlDp8uORkcA6SumuU5BwkWymOx
+uYb4ilfBV85C+nOh92VC/x7BALJucw7/xyHlGKSq2XE/qNS5zowdo0IwQDAOBgNV
+HQ8BAf8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUVLB7rUW44kB/
++wpu+74zyTyjhNUwCgYIKoZIzj0EAwIDRwAwRAIgIk90crlgr/HmnKAWBVBfw147
+bmF0774BxL4YSFlhgjICICadVGNA3jdgUM/I2O2dgq43mLyjj0xMqTQrbO/7lZsm
+-----END CERTIFICATE-----
+
+# Issuer: CN=GTS Root R1 O=Google Trust Services LLC
+# Subject: CN=GTS Root R1 O=Google Trust Services LLC
+# Label: "GTS Root R1"
+# Serial: 159662320309726417404178440727
+# MD5 Fingerprint: 05:fe:d0:bf:71:a8:a3:76:63:da:01:e0:d8:52:dc:40
+# SHA1 Fingerprint: e5:8c:1c:c4:91:3b:38:63:4b:e9:10:6e:e3:ad:8e:6b:9d:d9:81:4a
+# SHA256 Fingerprint: d9:47:43:2a:bd:e7:b7:fa:90:fc:2e:6b:59:10:1b:12:80:e0:e1:c7:e4:e4:0f:a3:c6:88:7f:ff:57:a7:f4:cf
+-----BEGIN CERTIFICATE-----
+MIIFVzCCAz+gAwIBAgINAgPlk28xsBNJiGuiFzANBgkqhkiG9w0BAQwFADBHMQsw
+CQYDVQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZpY2VzIExMQzEU
+MBIGA1UEAxMLR1RTIFJvb3QgUjEwHhcNMTYwNjIyMDAwMDAwWhcNMzYwNjIyMDAw
+MDAwWjBHMQswCQYDVQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZp
+Y2VzIExMQzEUMBIGA1UEAxMLR1RTIFJvb3QgUjEwggIiMA0GCSqGSIb3DQEBAQUA
+A4ICDwAwggIKAoICAQC2EQKLHuOhd5s73L+UPreVp0A8of2C+X0yBoJx9vaMf/vo
+27xqLpeXo4xL+Sv2sfnOhB2x+cWX3u+58qPpvBKJXqeqUqv4IyfLpLGcY9vXmX7w
+Cl7raKb0xlpHDU0QM+NOsROjyBhsS+z8CZDfnWQpJSMHobTSPS5g4M/SCYe7zUjw
+TcLCeoiKu7rPWRnWr4+wB7CeMfGCwcDfLqZtbBkOtdh+JhpFAz2weaSUKK0Pfybl
+qAj+lug8aJRT7oM6iCsVlgmy4HqMLnXWnOunVmSPlk9orj2XwoSPwLxAwAtcvfaH
+szVsrBhQf4TgTM2S0yDpM7xSma8ytSmzJSq0SPly4cpk9+aCEI3oncKKiPo4Zor8
+Y/kB+Xj9e1x3+naH+uzfsQ55lVe0vSbv1gHR6xYKu44LtcXFilWr06zqkUspzBmk
+MiVOKvFlRNACzqrOSbTqn3yDsEB750Orp2yjj32JgfpMpf/VjsPOS+C12LOORc92
+wO1AK/1TD7Cn1TsNsYqiA94xrcx36m97PtbfkSIS5r762DL8EGMUUXLeXdYWk70p
+aDPvOmbsB4om3xPXV2V4J95eSRQAogB/mqghtqmxlbCluQ0WEdrHbEg8QOB+DVrN
+VjzRlwW5y0vtOUucxD/SVRNuJLDWcfr0wbrM7Rv1/oFB2ACYPTrIrnqYNxgFlQID
+AQABo0IwQDAOBgNVHQ8BAf8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4E
+FgQU5K8rJnEaK0gnhS9SZizv8IkTcT4wDQYJKoZIhvcNAQEMBQADggIBAJ+qQibb
+C5u+/x6Wki4+omVKapi6Ist9wTrYggoGxval3sBOh2Z5ofmmWJyq+bXmYOfg6LEe
+QkEzCzc9zolwFcq1JKjPa7XSQCGYzyI0zzvFIoTgxQ6KfF2I5DUkzps+GlQebtuy
+h6f88/qBVRRiClmpIgUxPoLW7ttXNLwzldMXG+gnoot7TiYaelpkttGsN/H9oPM4
+7HLwEXWdyzRSjeZ2axfG34arJ45JK3VmgRAhpuo+9K4l/3wV3s6MJT/KYnAK9y8J
+ZgfIPxz88NtFMN9iiMG1D53Dn0reWVlHxYciNuaCp+0KueIHoI17eko8cdLiA6Ef
+MgfdG+RCzgwARWGAtQsgWSl4vflVy2PFPEz0tv/bal8xa5meLMFrUKTX5hgUvYU/
+Z6tGn6D/Qqc6f1zLXbBwHSs09dR2CQzreExZBfMzQsNhFRAbd03OIozUhfJFfbdT
+6u9AWpQKXCBfTkBdYiJ23//OYb2MI3jSNwLgjt7RETeJ9r/tSQdirpLsQBqvFAnZ
+0E6yove+7u7Y/9waLd64NnHi/Hm3lCXRSHNboTXns5lndcEZOitHTtNCjv0xyBZm
+2tIMPNuzjsmhDYAPexZ3FL//2wmUspO8IFgV6dtxQ/PeEMMA3KgqlbbC1j+Qa3bb
+bP6MvPJwNQzcmRk13NfIRmPVNnGuV/u3gm3c
+-----END CERTIFICATE-----
+
+# Issuer: CN=GTS Root R2 O=Google Trust Services LLC
+# Subject: CN=GTS Root R2 O=Google Trust Services LLC
+# Label: "GTS Root R2"
+# Serial: 159662449406622349769042896298
+# MD5 Fingerprint: 1e:39:c0:53:e6:1e:29:82:0b:ca:52:55:36:5d:57:dc
+# SHA1 Fingerprint: 9a:44:49:76:32:db:de:fa:d0:bc:fb:5a:7b:17:bd:9e:56:09:24:94
+# SHA256 Fingerprint: 8d:25:cd:97:22:9d:bf:70:35:6b:da:4e:b3:cc:73:40:31:e2:4c:f0:0f:af:cf:d3:2d:c7:6e:b5:84:1c:7e:a8
+-----BEGIN CERTIFICATE-----
+MIIFVzCCAz+gAwIBAgINAgPlrsWNBCUaqxElqjANBgkqhkiG9w0BAQwFADBHMQsw
+CQYDVQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZpY2VzIExMQzEU
+MBIGA1UEAxMLR1RTIFJvb3QgUjIwHhcNMTYwNjIyMDAwMDAwWhcNMzYwNjIyMDAw
+MDAwWjBHMQswCQYDVQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZp
+Y2VzIExMQzEUMBIGA1UEAxMLR1RTIFJvb3QgUjIwggIiMA0GCSqGSIb3DQEBAQUA
+A4ICDwAwggIKAoICAQDO3v2m++zsFDQ8BwZabFn3GTXd98GdVarTzTukk3LvCvpt
+nfbwhYBboUhSnznFt+4orO/LdmgUud+tAWyZH8QiHZ/+cnfgLFuv5AS/T3KgGjSY
+6Dlo7JUle3ah5mm5hRm9iYz+re026nO8/4Piy33B0s5Ks40FnotJk9/BW9BuXvAu
+MC6C/Pq8tBcKSOWIm8Wba96wyrQD8Nr0kLhlZPdcTK3ofmZemde4wj7I0BOdre7k
+RXuJVfeKH2JShBKzwkCX44ofR5GmdFrS+LFjKBC4swm4VndAoiaYecb+3yXuPuWg
+f9RhD1FLPD+M2uFwdNjCaKH5wQzpoeJ/u1U8dgbuak7MkogwTZq9TwtImoS1mKPV
++3PBV2HdKFZ1E66HjucMUQkQdYhMvI35ezzUIkgfKtzra7tEscszcTJGr61K8Yzo
+dDqs5xoic4DSMPclQsciOzsSrZYuxsN2B6ogtzVJV+mSSeh2FnIxZyuWfoqjx5RW
+Ir9qS34BIbIjMt/kmkRtWVtd9QCgHJvGeJeNkP+byKq0rxFROV7Z+2et1VsRnTKa
+G73VululycslaVNVJ1zgyjbLiGH7HrfQy+4W+9OmTN6SpdTi3/UGVN4unUu0kzCq
+gc7dGtxRcw1PcOnlthYhGXmy5okLdWTK1au8CcEYof/UVKGFPP0UJAOyh9OktwID
+AQABo0IwQDAOBgNVHQ8BAf8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4E
+FgQUu//KjiOfT5nK2+JopqUVJxce2Q4wDQYJKoZIhvcNAQEMBQADggIBAB/Kzt3H
+vqGf2SdMC9wXmBFqiN495nFWcrKeGk6c1SuYJF2ba3uwM4IJvd8lRuqYnrYb/oM8
+0mJhwQTtzuDFycgTE1XnqGOtjHsB/ncw4c5omwX4Eu55MaBBRTUoCnGkJE+M3DyC
+B19m3H0Q/gxhswWV7uGugQ+o+MePTagjAiZrHYNSVc61LwDKgEDg4XSsYPWHgJ2u
+NmSRXbBoGOqKYcl3qJfEycel/FVL8/B/uWU9J2jQzGv6U53hkRrJXRqWbTKH7QMg
+yALOWr7Z6v2yTcQvG99fevX4i8buMTolUVVnjWQye+mew4K6Ki3pHrTgSAai/Gev
+HyICc/sgCq+dVEuhzf9gR7A/Xe8bVr2XIZYtCtFenTgCR2y59PYjJbigapordwj6
+xLEokCZYCDzifqrXPW+6MYgKBesntaFJ7qBFVHvmJ2WZICGoo7z7GJa7Um8M7YNR
+TOlZ4iBgxcJlkoKM8xAfDoqXvneCbT+PHV28SSe9zE8P4c52hgQjxcCMElv924Sg
+JPFI/2R80L5cFtHvma3AH/vLrrw4IgYmZNralw4/KBVEqE8AyvCazM90arQ+POuV
+7LXTWtiBmelDGDfrs7vRWGJB82bSj6p4lVQgw1oudCvV0b4YacCs1aTPObpRhANl
+6WLAYv7YTVWW4tAR+kg0Eeye7QUd5MjWHYbL
+-----END CERTIFICATE-----
+
+# Issuer: CN=GTS Root R3 O=Google Trust Services LLC
+# Subject: CN=GTS Root R3 O=Google Trust Services LLC
+# Label: "GTS Root R3"
+# Serial: 159662495401136852707857743206
+# MD5 Fingerprint: 3e:e7:9d:58:02:94:46:51:94:e5:e0:22:4a:8b:e7:73
+# SHA1 Fingerprint: ed:e5:71:80:2b:c8:92:b9:5b:83:3c:d2:32:68:3f:09:cd:a0:1e:46
+# SHA256 Fingerprint: 34:d8:a7:3e:e2:08:d9:bc:db:0d:95:65:20:93:4b:4e:40:e6:94:82:59:6e:8b:6f:73:c8:42:6b:01:0a:6f:48
+-----BEGIN CERTIFICATE-----
+MIICCTCCAY6gAwIBAgINAgPluILrIPglJ209ZjAKBggqhkjOPQQDAzBHMQswCQYD
+VQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZpY2VzIExMQzEUMBIG
+A1UEAxMLR1RTIFJvb3QgUjMwHhcNMTYwNjIyMDAwMDAwWhcNMzYwNjIyMDAwMDAw
+WjBHMQswCQYDVQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZpY2Vz
+IExMQzEUMBIGA1UEAxMLR1RTIFJvb3QgUjMwdjAQBgcqhkjOPQIBBgUrgQQAIgNi
+AAQfTzOHMymKoYTey8chWEGJ6ladK0uFxh1MJ7x/JlFyb+Kf1qPKzEUURout736G
+jOyxfi//qXGdGIRFBEFVbivqJn+7kAHjSxm65FSWRQmx1WyRRK2EE46ajA2ADDL2
+4CejQjBAMA4GA1UdDwEB/wQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQW
+BBTB8Sa6oC2uhYHP0/EqEr24Cmf9vDAKBggqhkjOPQQDAwNpADBmAjEA9uEglRR7
+VKOQFhG/hMjqb2sXnh5GmCCbn9MN2azTL818+FsuVbu/3ZL3pAzcMeGiAjEA/Jdm
+ZuVDFhOD3cffL74UOO0BzrEXGhF16b0DjyZ+hOXJYKaV11RZt+cRLInUue4X
+-----END CERTIFICATE-----
+
+# Issuer: CN=GTS Root R4 O=Google Trust Services LLC
+# Subject: CN=GTS Root R4 O=Google Trust Services LLC
+# Label: "GTS Root R4"
+# Serial: 159662532700760215368942768210
+# MD5 Fingerprint: 43:96:83:77:19:4d:76:b3:9d:65:52:e4:1d:22:a5:e8
+# SHA1 Fingerprint: 77:d3:03:67:b5:e0:0c:15:f6:0c:38:61:df:7c:e1:3b:92:46:4d:47
+# SHA256 Fingerprint: 34:9d:fa:40:58:c5:e2:63:12:3b:39:8a:e7:95:57:3c:4e:13:13:c8:3f:e6:8f:93:55:6c:d5:e8:03:1b:3c:7d
+-----BEGIN CERTIFICATE-----
+MIICCTCCAY6gAwIBAgINAgPlwGjvYxqccpBQUjAKBggqhkjOPQQDAzBHMQswCQYD
+VQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZpY2VzIExMQzEUMBIG
+A1UEAxMLR1RTIFJvb3QgUjQwHhcNMTYwNjIyMDAwMDAwWhcNMzYwNjIyMDAwMDAw
+WjBHMQswCQYDVQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZpY2Vz
+IExMQzEUMBIGA1UEAxMLR1RTIFJvb3QgUjQwdjAQBgcqhkjOPQIBBgUrgQQAIgNi
+AATzdHOnaItgrkO4NcWBMHtLSZ37wWHO5t5GvWvVYRg1rkDdc/eJkTBa6zzuhXyi
+QHY7qca4R9gq55KRanPpsXI5nymfopjTX15YhmUPoYRlBtHci8nHc8iMai/lxKvR
+HYqjQjBAMA4GA1UdDwEB/wQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQW
+BBSATNbrdP9JNqPV2Py1PsVq8JQdjDAKBggqhkjOPQQDAwNpADBmAjEA6ED/g94D
+9J+uHXqnLrmvT/aDHQ4thQEd0dlq7A/Cr8deVl5c1RxYIigL9zC2L7F8AjEA8GE8
+p/SgguMh1YQdc4acLa/KNJvxn7kjNuK8YAOdgLOaVsjh4rsUecrNIdSUtUlD
+-----END CERTIFICATE-----
+
+# Issuer: CN=Telia Root CA v2 O=Telia Finland Oyj
+# Subject: CN=Telia Root CA v2 O=Telia Finland Oyj
+# Label: "Telia Root CA v2"
+# Serial: 7288924052977061235122729490515358
+# MD5 Fingerprint: 0e:8f:ac:aa:82:df:85:b1:f4:dc:10:1c:fc:99:d9:48
+# SHA1 Fingerprint: b9:99:cd:d1:73:50:8a:c4:47:05:08:9c:8c:88:fb:be:a0:2b:40:cd
+# SHA256 Fingerprint: 24:2b:69:74:2f:cb:1e:5b:2a:bf:98:89:8b:94:57:21:87:54:4e:5b:4d:99:11:78:65:73:62:1f:6a:74:b8:2c
+-----BEGIN CERTIFICATE-----
+MIIFdDCCA1ygAwIBAgIPAWdfJ9b+euPkrL4JWwWeMA0GCSqGSIb3DQEBCwUAMEQx
+CzAJBgNVBAYTAkZJMRowGAYDVQQKDBFUZWxpYSBGaW5sYW5kIE95ajEZMBcGA1UE
+AwwQVGVsaWEgUm9vdCBDQSB2MjAeFw0xODExMjkxMTU1NTRaFw00MzExMjkxMTU1
+NTRaMEQxCzAJBgNVBAYTAkZJMRowGAYDVQQKDBFUZWxpYSBGaW5sYW5kIE95ajEZ
+MBcGA1UEAwwQVGVsaWEgUm9vdCBDQSB2MjCCAiIwDQYJKoZIhvcNAQEBBQADggIP
+ADCCAgoCggIBALLQPwe84nvQa5n44ndp586dpAO8gm2h/oFlH0wnrI4AuhZ76zBq
+AMCzdGh+sq/H1WKzej9Qyow2RCRj0jbpDIX2Q3bVTKFgcmfiKDOlyzG4OiIjNLh9
+vVYiQJ3q9HsDrWj8soFPmNB06o3lfc1jw6P23pLCWBnglrvFxKk9pXSW/q/5iaq9
+lRdU2HhE8Qx3FZLgmEKnpNaqIJLNwaCzlrI6hEKNfdWV5Nbb6WLEWLN5xYzTNTOD
+n3WhUidhOPFZPY5Q4L15POdslv5e2QJltI5c0BE0312/UqeBAMN/mUWZFdUXyApT
+7GPzmX3MaRKGwhfwAZ6/hLzRUssbkmbOpFPlob/E2wnW5olWK8jjfN7j/4nlNW4o
+6GwLI1GpJQXrSPjdscr6bAhR77cYbETKJuFzxokGgeWKrLDiKca5JLNrRBH0pUPC
+TEPlcDaMtjNXepUugqD0XBCzYYP2AgWGLnwtbNwDRm41k9V6lS/eINhbfpSQBGq6
+WT0EBXWdN6IOLj3rwaRSg/7Qa9RmjtzG6RJOHSpXqhC8fF6CfaamyfItufUXJ63R
+DolUK5X6wK0dmBR4M0KGCqlztft0DbcbMBnEWg4cJ7faGND/isgFuvGqHKI3t+ZI
+pEYslOqodmJHixBTB0hXbOKSTbauBcvcwUpej6w9GU7C7WB1K9vBykLVAgMBAAGj
+YzBhMB8GA1UdIwQYMBaAFHKs5DN5qkWH9v2sHZ7Wxy+G2CQ5MB0GA1UdDgQWBBRy
+rOQzeapFh/b9rB2e1scvhtgkOTAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUw
+AwEB/zANBgkqhkiG9w0BAQsFAAOCAgEAoDtZpwmUPjaE0n4vOaWWl/oRrfxn83EJ
+8rKJhGdEr7nv7ZbsnGTbMjBvZ5qsfl+yqwE2foH65IRe0qw24GtixX1LDoJt0nZi
+0f6X+J8wfBj5tFJ3gh1229MdqfDBmgC9bXXYfef6xzijnHDoRnkDry5023X4blMM
+A8iZGok1GTzTyVR8qPAs5m4HeW9q4ebqkYJpCh3DflminmtGFZhb069GHWLIzoBS
+SRE/yQQSwxN8PzuKlts8oB4KtItUsiRnDe+Cy748fdHif64W1lZYudogsYMVoe+K
+TTJvQS8TUoKU1xrBeKJR3Stwbbca+few4GeXVtt8YVMJAygCQMez2P2ccGrGKMOF
+6eLtGpOg3kuYooQ+BXcBlj37tCAPnHICehIv1aO6UXivKitEZU61/Qrowc15h2Er
+3oBXRb9n8ZuRXqWk7FlIEA04x7D6w0RtBPV4UBySllva9bguulvP5fBqnUsvWHMt
+Ty3EHD70sz+rFQ47GUGKpMFXEmZxTPpT41frYpUJnlTd0cI8Vzy9OK2YZLe4A5pT
+VmBds9hCG1xLEooc6+t9xnppxyd/pPiL8uSUZodL6ZQHCRJ5irLrdATczvREWeAW
+ysUsWNc8e89ihmpQfTU2Zqf7N+cox9jQraVplI/owd8k+BsHMYeB2F326CjYSlKA
+rBPuUBQemMc=
+-----END CERTIFICATE-----
+
+# Issuer: CN=D-TRUST BR Root CA 1 2020 O=D-Trust GmbH
+# Subject: CN=D-TRUST BR Root CA 1 2020 O=D-Trust GmbH
+# Label: "D-TRUST BR Root CA 1 2020"
+# Serial: 165870826978392376648679885835942448534
+# MD5 Fingerprint: b5:aa:4b:d5:ed:f7:e3:55:2e:8f:72:0a:f3:75:b8:ed
+# SHA1 Fingerprint: 1f:5b:98:f0:e3:b5:f7:74:3c:ed:e6:b0:36:7d:32:cd:f4:09:41:67
+# SHA256 Fingerprint: e5:9a:aa:81:60:09:c2:2b:ff:5b:25:ba:d3:7d:f3:06:f0:49:79:7c:1f:81:d8:5a:b0:89:e6:57:bd:8f:00:44
+-----BEGIN CERTIFICATE-----
+MIIC2zCCAmCgAwIBAgIQfMmPK4TX3+oPyWWa00tNljAKBggqhkjOPQQDAzBIMQsw
+CQYDVQQGEwJERTEVMBMGA1UEChMMRC1UcnVzdCBHbWJIMSIwIAYDVQQDExlELVRS
+VVNUIEJSIFJvb3QgQ0EgMSAyMDIwMB4XDTIwMDIxMTA5NDUwMFoXDTM1MDIxMTA5
+NDQ1OVowSDELMAkGA1UEBhMCREUxFTATBgNVBAoTDEQtVHJ1c3QgR21iSDEiMCAG
+A1UEAxMZRC1UUlVTVCBCUiBSb290IENBIDEgMjAyMDB2MBAGByqGSM49AgEGBSuB
+BAAiA2IABMbLxyjR+4T1mu9CFCDhQ2tuda38KwOE1HaTJddZO0Flax7mNCq7dPYS
+zuht56vkPE4/RAiLzRZxy7+SmfSk1zxQVFKQhYN4lGdnoxwJGT11NIXe7WB9xwy0
+QVK5buXuQqOCAQ0wggEJMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFHOREKv/
+VbNafAkl1bK6CKBrqx9tMA4GA1UdDwEB/wQEAwIBBjCBxgYDVR0fBIG+MIG7MD6g
+PKA6hjhodHRwOi8vY3JsLmQtdHJ1c3QubmV0L2NybC9kLXRydXN0X2JyX3Jvb3Rf
+Y2FfMV8yMDIwLmNybDB5oHegdYZzbGRhcDovL2RpcmVjdG9yeS5kLXRydXN0Lm5l
+dC9DTj1ELVRSVVNUJTIwQlIlMjBSb290JTIwQ0ElMjAxJTIwMjAyMCxPPUQtVHJ1
+c3QlMjBHbWJILEM9REU/Y2VydGlmaWNhdGVyZXZvY2F0aW9ubGlzdDAKBggqhkjO
+PQQDAwNpADBmAjEAlJAtE/rhY/hhY+ithXhUkZy4kzg+GkHaQBZTQgjKL47xPoFW
+wKrY7RjEsK70PvomAjEA8yjixtsrmfu3Ubgko6SUeho/5jbiA1czijDLgsfWFBHV
+dWNbFJWcHwHP2NVypw87
+-----END CERTIFICATE-----
+
+# Issuer: CN=D-TRUST EV Root CA 1 2020 O=D-Trust GmbH
+# Subject: CN=D-TRUST EV Root CA 1 2020 O=D-Trust GmbH
+# Label: "D-TRUST EV Root CA 1 2020"
+# Serial: 126288379621884218666039612629459926992
+# MD5 Fingerprint: 8c:2d:9d:70:9f:48:99:11:06:11:fb:e9:cb:30:c0:6e
+# SHA1 Fingerprint: 61:db:8c:21:59:69:03:90:d8:7c:9c:12:86:54:cf:9d:3d:f4:dd:07
+# SHA256 Fingerprint: 08:17:0d:1a:a3:64:53:90:1a:2f:95:92:45:e3:47:db:0c:8d:37:ab:aa:bc:56:b8:1a:a1:00:dc:95:89:70:db
+-----BEGIN CERTIFICATE-----
+MIIC2zCCAmCgAwIBAgIQXwJB13qHfEwDo6yWjfv/0DAKBggqhkjOPQQDAzBIMQsw
+CQYDVQQGEwJERTEVMBMGA1UEChMMRC1UcnVzdCBHbWJIMSIwIAYDVQQDExlELVRS
+VVNUIEVWIFJvb3QgQ0EgMSAyMDIwMB4XDTIwMDIxMTEwMDAwMFoXDTM1MDIxMTA5
+NTk1OVowSDELMAkGA1UEBhMCREUxFTATBgNVBAoTDEQtVHJ1c3QgR21iSDEiMCAG
+A1UEAxMZRC1UUlVTVCBFViBSb290IENBIDEgMjAyMDB2MBAGByqGSM49AgEGBSuB
+BAAiA2IABPEL3YZDIBnfl4XoIkqbz52Yv7QFJsnL46bSj8WeeHsxiamJrSc8ZRCC
+/N/DnU7wMyPE0jL1HLDfMxddxfCxivnvubcUyilKwg+pf3VlSSowZ/Rk99Yad9rD
+wpdhQntJraOCAQ0wggEJMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFH8QARY3
+OqQo5FD4pPfsazK2/umLMA4GA1UdDwEB/wQEAwIBBjCBxgYDVR0fBIG+MIG7MD6g
+PKA6hjhodHRwOi8vY3JsLmQtdHJ1c3QubmV0L2NybC9kLXRydXN0X2V2X3Jvb3Rf
+Y2FfMV8yMDIwLmNybDB5oHegdYZzbGRhcDovL2RpcmVjdG9yeS5kLXRydXN0Lm5l
+dC9DTj1ELVRSVVNUJTIwRVYlMjBSb290JTIwQ0ElMjAxJTIwMjAyMCxPPUQtVHJ1
+c3QlMjBHbWJILEM9REU/Y2VydGlmaWNhdGVyZXZvY2F0aW9ubGlzdDAKBggqhkjO
+PQQDAwNpADBmAjEAyjzGKnXCXnViOTYAYFqLwZOZzNnbQTs7h5kXO9XMT8oi96CA
+y/m0sRtW9XLS/BnRAjEAkfcwkz8QRitxpNA7RJvAKQIFskF3UfN5Wp6OFKBOQtJb
+gfM0agPnIjhQW+0ZT0MW
+-----END CERTIFICATE-----
diff --git a/lib/certifi/core.py b/lib/certifi/core.py
index 5d2b8cd3..497d938d 100644
--- a/lib/certifi/core.py
+++ b/lib/certifi/core.py
@@ -1,5 +1,3 @@
-# -*- coding: utf-8 -*-
-
 """
 certifi.py
 ~~~~~~~~~~
@@ -7,6 +5,8 @@ certifi.py
 This module returns the installation location of cacert.pem or its contents.
 """
 import os
+import types
+from typing import Union
 
 try:
     from importlib.resources import path as get_path, read_text
@@ -14,7 +14,7 @@ try:
     _CACERT_CTX = None
     _CACERT_PATH = None
 
-    def where():
+    def where() -> str:
         # This is slightly terrible, but we want to delay extracting the file
         # in cases where we're inside of a zipimport situation until someone
         # actually calls where(), but we don't want to re-extract the file
@@ -40,21 +40,29 @@ try:
 
 
 except ImportError:
+    Package = Union[types.ModuleType, str]
+    Resource = Union[str, "os.PathLike"]
+
     # This fallback will work for Python versions prior to 3.7 that lack the
     # importlib.resources module but relies on the existing `where` function
     # so won't address issues with environments like PyOxidizer that don't set
     # __file__ on modules.
-    def read_text(_module, _path, encoding="ascii"):
-        with open(where(), "r", encoding=encoding) as data:
+    def read_text(
+        package: Package,
+        resource: Resource,
+        encoding: str = 'utf-8',
+        errors: str = 'strict'
+    ) -> str:
+        with open(where(), encoding=encoding) as data:
             return data.read()
 
     # If we don't have importlib.resources, then we will just do the old logic
     # of assuming we're on the filesystem and munge the path directly.
-    def where():
+    def where() -> str:
         f = os.path.dirname(__file__)
 
         return os.path.join(f, "cacert.pem")
 
 
-def contents():
+def contents() -> str:
     return read_text("certifi", "cacert.pem", encoding="ascii")
diff --git a/lib/certifi/py.typed b/lib/certifi/py.typed
new file mode 100644
index 00000000..e69de29b
diff --git a/requirements.txt b/requirements.txt
index d9f7d751..88712250 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -6,7 +6,7 @@ backports.functools-lru-cache==1.6.4
 backports.zoneinfo==0.2.1
 beautifulsoup4==4.11.1
 bleach==5.0.0
-certifi==2021.10.8
+certifi==2022.5.18.1
 cheroot==8.6.0
 cherrypy==18.6.1
 cloudinary==1.29.0

From 775375b8b4619de4e7f84988bcb4dbbb5acd6360 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Fri, 20 May 2022 10:57:35 -0700
Subject: [PATCH 109/743] Bump plexapi from 4.11.0 to 4.11.1 (#1749)

* Bump plexapi from 4.11.0 to 4.11.1

Bumps [plexapi](https://github.com/pkkid/python-plexapi) from 4.11.0 to 4.11.1.
- [Release notes](https://github.com/pkkid/python-plexapi/releases)
- [Commits](https://github.com/pkkid/python-plexapi/compare/4.11.0...4.11.1)

---
updated-dependencies:
- dependency-name: plexapi
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

* Update plexapi==4.11.1

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/plexapi/base.py  | 2 +-
 lib/plexapi/const.py | 2 +-
 requirements.txt     | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/lib/plexapi/base.py b/lib/plexapi/base.py
index fb1066aa..cfe82050 100644
--- a/lib/plexapi/base.py
+++ b/lib/plexapi/base.py
@@ -480,7 +480,7 @@ class PlexPartialObject(PlexObject):
         objname = "%s '%s'" % (clsname, title) if title else clsname
         log.debug("Reloading %s for attr '%s'", objname, attr)
         # Reload and return the value
-        self._reload()
+        self._reload(_overwriteNone=False)
         return super(PlexPartialObject, self).__getattribute__(attr)
 
     def analyze(self):
diff --git a/lib/plexapi/const.py b/lib/plexapi/const.py
index 80d34806..3d1860fc 100644
--- a/lib/plexapi/const.py
+++ b/lib/plexapi/const.py
@@ -4,6 +4,6 @@
 # Library version
 MAJOR_VERSION = 4
 MINOR_VERSION = 11
-PATCH_VERSION = 0
+PATCH_VERSION = 1
 __short_version__ = f"{MAJOR_VERSION}.{MINOR_VERSION}"
 __version__ = f"{__short_version__}.{PATCH_VERSION}"
diff --git a/requirements.txt b/requirements.txt
index 88712250..99364024 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -27,7 +27,7 @@ MarkupSafe==2.1.1
 musicbrainzngs==0.7.1
 packaging==21.3
 paho-mqtt==1.6.1
-plexapi==4.11.0
+plexapi==4.11.1
 portend==3.1.0
 profilehooks==1.12.0
 PyJWT==2.4.0

From bb01141cfc9715ed9d87b66aae74ac390cf700b2 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 20 May 2022 10:48:14 -0700
Subject: [PATCH 110/743] Fix parsing Windows path on Linux for notification
 filename parameter

---
 plexpy/notification_handler.py | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/plexpy/notification_handler.py b/plexpy/notification_handler.py
index b8a4b902..e747f3ae 100644
--- a/plexpy/notification_handler.py
+++ b/plexpy/notification_handler.py
@@ -35,7 +35,6 @@ import os
 import re
 from string import Formatter
 import threading
-import time
 
 import musicbrainzngs
 
@@ -1140,7 +1139,7 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
         'subtitle_language': notify_params['subtitle_language'],
         'subtitle_language_code': notify_params['subtitle_language_code'],
         'file': notify_params['file'],
-        'filename': os.path.basename(notify_params['file']),
+        'filename': os.path.basename(notify_params['file'].replace('\\', os.sep)),
         'file_size': helpers.human_file_size(notify_params['file_size']),
         'indexes': notify_params['indexes'],
         'guid': notify_params['guid'],

From 248fb6724aa199deea8dcb33c12b1cef5a03e488 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 23 May 2022 10:45:11 -0700
Subject: [PATCH 111/743] Bump importlib-metadata from 4.11.3 to 4.11.4 (#1750)

* Bump importlib-metadata from 4.11.3 to 4.11.4

Bumps [importlib-metadata](https://github.com/python/importlib_metadata) from 4.11.3 to 4.11.4.
- [Release notes](https://github.com/python/importlib_metadata/releases)
- [Changelog](https://github.com/python/importlib_metadata/blob/main/CHANGES.rst)
- [Commits](https://github.com/python/importlib_metadata/compare/v4.11.3...v4.11.4)

---
updated-dependencies:
- dependency-name: importlib-metadata
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

* Update importlib-metadata==4.11.4

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/importlib_metadata/__init__.py | 34 ++++++++++++++++++++++++------
 package/requirements-package.txt   |  2 +-
 requirements.txt                   |  2 +-
 3 files changed, 29 insertions(+), 9 deletions(-)

diff --git a/lib/importlib_metadata/__init__.py b/lib/importlib_metadata/__init__.py
index 5ac8be23..29ce1175 100644
--- a/lib/importlib_metadata/__init__.py
+++ b/lib/importlib_metadata/__init__.py
@@ -956,13 +956,26 @@ class PathDistribution(Distribution):
         normalized name from the file system path.
         """
         stem = os.path.basename(str(self._path))
-        return self._name_from_stem(stem) or super()._normalized_name
+        return (
+            pass_none(Prepared.normalize)(self._name_from_stem(stem))
+            or super()._normalized_name
+        )
 
-    def _name_from_stem(self, stem):
-        name, ext = os.path.splitext(stem)
+    @staticmethod
+    def _name_from_stem(stem):
+        """
+        >>> PathDistribution._name_from_stem('foo-3.0.egg-info')
+        'foo'
+        >>> PathDistribution._name_from_stem('CherryPy-3.0.dist-info')
+        'CherryPy'
+        >>> PathDistribution._name_from_stem('face.egg-info')
+        'face'
+        >>> PathDistribution._name_from_stem('foo.bar')
+        """
+        filename, ext = os.path.splitext(stem)
         if ext not in ('.dist-info', '.egg-info'):
             return
-        name, sep, rest = stem.partition('-')
+        name, sep, rest = filename.partition('-')
         return name
 
 
@@ -1002,6 +1015,15 @@ def version(distribution_name):
     return distribution(distribution_name).version
 
 
+_unique = functools.partial(
+    unique_everseen,
+    key=operator.attrgetter('_normalized_name'),
+)
+"""
+Wrapper for ``distributions`` to return unique distributions by name.
+"""
+
+
 def entry_points(**params) -> Union[EntryPoints, SelectableGroups]:
     """Return EntryPoint objects for all installed packages.
 
@@ -1019,10 +1041,8 @@ def entry_points(**params) -> Union[EntryPoints, SelectableGroups]:
 
     :return: EntryPoints or SelectableGroups for all installed packages.
     """
-    norm_name = operator.attrgetter('_normalized_name')
-    unique = functools.partial(unique_everseen, key=norm_name)
     eps = itertools.chain.from_iterable(
-        dist.entry_points for dist in unique(distributions())
+        dist.entry_points for dist in _unique(distributions())
     )
     return SelectableGroups.load(eps).select(**params)
 
diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index 461765ac..997ebbfe 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -1,5 +1,5 @@
 apscheduler==3.9.1
-importlib-metadata==4.11.3
+importlib-metadata==4.11.4
 importlib-resources==5.7.1
 pyinstaller==5.1
 pyopenssl==22.0.0
diff --git a/requirements.txt b/requirements.txt
index 99364024..7031b33e 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -18,7 +18,7 @@ gntp==1.0.3
 html5lib==1.1
 httpagentparser==1.9.2
 idna==3.3
-importlib-metadata==4.11.3
+importlib-metadata==4.11.4
 importlib-resources==5.7.1
 git+https://github.com/Tautulli/ipwhois.git@master#egg=ipwhois
 IPy==1.01

From e9d370a4b4eaaff26133d9c7529179299fc85fe5 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 23 May 2022 10:57:21 -0700
Subject: [PATCH 112/743] v2.10.0

---
 CHANGELOG.md      | 15 +++++++++++++++
 plexpy/version.py |  2 +-
 2 files changed, 16 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 9c8c3c69..37091625 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,20 @@
 # Changelog
 
+## v2.10.0 (2022-05-23)
+
+* Activity:
+  * Fix: Detection of Dolby Vision missing for PMS 1.26.1.
+* Notifications:
+  * Fix: Parsing of filename notification parameter incorrect for Windows PMS.
+* Exporter:
+  * New: Added additional theme and label export fields.
+* UI:
+  * Fix: Slow loading of collections and playlists tables.
+  * Change: Update default user thumbnail image to match Plex Web.
+* API:
+  * Change: Values for get_users_table and get_libraries_table return an integer instead of "Checked". 
+
+
 ## v2.9.7 (2022-04-11)
 
 * UI:
diff --git a/plexpy/version.py b/plexpy/version.py
index db1a06eb..9967683c 100644
--- a/plexpy/version.py
+++ b/plexpy/version.py
@@ -18,4 +18,4 @@
 from __future__ import unicode_literals
 
 PLEXPY_BRANCH = "master"
-PLEXPY_RELEASE_VERSION = "v2.9.7"
+PLEXPY_RELEASE_VERSION = "v2.10.0"

From b9b844dd3869002976c3a68ba80df4aa0ac0bf75 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Wed, 25 May 2022 11:37:32 -0700
Subject: [PATCH 113/743] Check for a blank user_id when retrieving user
 details

---
 plexpy/users.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/plexpy/users.py b/plexpy/users.py
index a0095573..e9438f4c 100644
--- a/plexpy/users.py
+++ b/plexpy/users.py
@@ -393,7 +393,7 @@ class Users(object):
                           'last_seen': None
                           }
 
-        if user_id is None and not user and not email:
+        if user_id in (None, '') and not user and not email:
             return default_return
 
         user_details = self.get_user_details(user_id=user_id, user=user, email=email,

From b905e0139c015cda66459aae68b3c69cdf6df599 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 28 May 2022 08:51:10 -0700
Subject: [PATCH 114/743] Add continent to geoip lookup

---
 data/interfaces/default/ip_address_modal.html |  2 ++
 plexpy/plextv.py                              | 12 ++++++------
 plexpy/webserve.py                            | 13 +++++++------
 3 files changed, 15 insertions(+), 12 deletions(-)

diff --git a/data/interfaces/default/ip_address_modal.html b/data/interfaces/default/ip_address_modal.html
index 7b831eeb..239b95e2 100644
--- a/data/interfaces/default/ip_address_modal.html
+++ b/data/interfaces/default/ip_address_modal.html
@@ -40,6 +40,7 @@
             <div id="ip_error" class="col-sm-12 text-muted"></div>
             <div class="col-sm-6">
                 <ul class="list-unstyled">
+                    <li>Continent: <strong><span id="continent"></span></strong></li>
                     <li>Country: <strong><span id="country"></span></strong></li>
                     <li>Region: <strong><span id="region"></span></strong></li>
                     <li>City: <strong><span id="city"></span></strong></li>
@@ -103,6 +104,7 @@
                     $('#ip_error').html('<i class="fa fa-exclamation-circle"></i> ' + result.message).show();
                 } else {
                     var data = result.data;
+                    $('#continent').html(data.continent);
                     $('#country').html(data.country);
                     $('#region').html(data.region);
                     $('#city').html(data.city);
diff --git a/plexpy/plextv.py b/plexpy/plextv.py
index 1cb53dd5..ebfa0bc6 100644
--- a/plexpy/plextv.py
+++ b/plexpy/plextv.py
@@ -930,15 +930,15 @@ class PlexTV(object):
             if len(coordinates) == 2:
                 latitude, longitude = [helpers.cast_to_float(c) for c in coordinates]
 
-            geo_info = {"code": helpers.get_xml_attr(a, 'code') or None,
+            geo_info = {"city": helpers.get_xml_attr(a, 'city') or None,
+                        "code": helpers.get_xml_attr(a, 'code') or None,
+                        "continent": helpers.get_xml_attr(a, 'continent_code') or None,
                         "country": helpers.get_xml_attr(a, 'country') or None,
-                        "region": helpers.get_xml_attr(a, 'subdivisions') or None,
-                        "city": helpers.get_xml_attr(a, 'city') or None,
-                        "postal_code": helpers.get_xml_attr(a, 'postal_code') or None,
-                        "timezone": helpers.get_xml_attr(a, 'time_zone') or None,
                         "latitude": latitude,
                         "longitude": longitude,
-                        "continent": None,  # keep for backwards compatibility with GeoLite2
+                        "postal_code": helpers.get_xml_attr(a, 'postal_code') or None,
+                        "region": helpers.get_xml_attr(a, 'subdivisions') or None,
+                        "timezone": helpers.get_xml_attr(a, 'time_zone') or None,
                         "accuracy": None   # keep for backwards compatibility with GeoLite2
                         }
 
diff --git a/plexpy/webserve.py b/plexpy/webserve.py
index 495f5286..83532098 100644
--- a/plexpy/webserve.py
+++ b/plexpy/webserve.py
@@ -6402,15 +6402,16 @@ class WebInterface(object):
 
             Returns:
                 json:
-                    {"code": 'US",
+                    {"city": "Mountain View",
+                     "code": "US",
+                     "continent": "NA",
                      "country": "United States",
-                     "region": "California",
-                     "city": "Mountain View",
-                     "postal_code": "94035",
-                     "timezone": "America/Los_Angeles",
                      "latitude": 37.386,
                      "longitude": -122.0838,
-                     "accuracy": 1000
+                     "postal_code": "94035",
+                     "region": "California",
+                     "timezone": "America/Los_Angeles",
+                     "accuracy": null
                      }
             ```
         """

From bd83c8d55c5db16d8a72d1c89cb74af471509f8c Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 28 May 2022 15:03:24 -0700
Subject: [PATCH 115/743] Remove server_token from get_users

---
 plexpy/users.py    | 5 ++---
 plexpy/webserve.py | 1 -
 2 files changed, 2 insertions(+), 4 deletions(-)

diff --git a/plexpy/users.py b/plexpy/users.py
index e9438f4c..29af0e09 100644
--- a/plexpy/users.py
+++ b/plexpy/users.py
@@ -1,4 +1,4 @@
-# -*- coding: utf-8 -*-
+# -*- coding: utf-8 -*-
 
 # This file is part of Tautulli.
 #
@@ -674,7 +674,7 @@ class Users(object):
         try:
             query = 'SELECT id AS row_id, user_id, username, friendly_name, thumb, custom_avatar_url, email, ' \
                     'is_active, is_admin, is_home_user, is_allow_sync, is_restricted, ' \
-                    'do_notify, keep_history, allow_guest, server_token, shared_libraries, ' \
+                    'do_notify, keep_history, allow_guest, shared_libraries, ' \
                     'filter_all, filter_movies, filter_tv, filter_music, filter_photos ' \
                     'FROM users WHERE deleted_user = 0'
             result = monitor_db.select(query=query)
@@ -698,7 +698,6 @@ class Users(object):
                     'do_notify': item['do_notify'],
                     'keep_history': item['keep_history'],
                     'allow_guest': item['allow_guest'],
-                    'server_token': item['server_token'],
                     'shared_libraries': item['shared_libraries'],
                     'filter_all': item['filter_all'],
                     'filter_movies': item['filter_movies'],
diff --git a/plexpy/webserve.py b/plexpy/webserve.py
index 83532098..1e9df451 100644
--- a/plexpy/webserve.py
+++ b/plexpy/webserve.py
@@ -6064,7 +6064,6 @@ class WebInterface(object):
                       "is_restricted": 0,
                       "keep_history": 1,
                       "row_id": 1,
-                      "server_token": "PU9cMuQZxJKFBtGqHk68",
                       "shared_libraries": "1;2;3",
                       "thumb": "https://plex.tv/users/k10w42309cynaopq/avatar",
                       "user_id": "133788",

From fffd936b0f1d78a145f321c0295cdd646868dc93 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 28 May 2022 15:03:52 -0700
Subject: [PATCH 116/743] Change shared_libraries to list for get_user

---
 plexpy/users.py    | 6 ++++--
 plexpy/webserve.py | 2 +-
 2 files changed, 5 insertions(+), 3 deletions(-)

diff --git a/plexpy/users.py b/plexpy/users.py
index 29af0e09..33ff543c 100644
--- a/plexpy/users.py
+++ b/plexpy/users.py
@@ -1,4 +1,4 @@
-# -*- coding: utf-8 -*-
+# -*- coding: utf-8 -*-
 
 # This file is part of Tautulli.
 #
@@ -684,6 +684,8 @@ class Users(object):
 
         users = []
         for item in result:
+            shared_libraries = tuple(item['shared_libraries'].split(';')) if item['shared_libraries'] else ()
+
             user = {'row_id': item['row_id'],
                     'user_id': item['user_id'],
                     'username': item['username'],
@@ -698,7 +700,7 @@ class Users(object):
                     'do_notify': item['do_notify'],
                     'keep_history': item['keep_history'],
                     'allow_guest': item['allow_guest'],
-                    'shared_libraries': item['shared_libraries'],
+                    'shared_libraries': shared_libraries,
                     'filter_all': item['filter_all'],
                     'filter_movies': item['filter_movies'],
                     'filter_tv': item['filter_tv'],
diff --git a/plexpy/webserve.py b/plexpy/webserve.py
index 1e9df451..1d61eece 100644
--- a/plexpy/webserve.py
+++ b/plexpy/webserve.py
@@ -6064,7 +6064,7 @@ class WebInterface(object):
                       "is_restricted": 0,
                       "keep_history": 1,
                       "row_id": 1,
-                      "shared_libraries": "1;2;3",
+                      "shared_libraries": ["1", "2", "3"],
                       "thumb": "https://plex.tv/users/k10w42309cynaopq/avatar",
                       "user_id": "133788",
                       "username": "Jon Snow"

From b7ca9c35025a2eaa99d4a644c4cdf61d6523096a Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 31 May 2022 10:51:53 -0700
Subject: [PATCH 117/743] Bump plexapi from 4.11.1 to 4.11.2 (#1753)

* Bump plexapi from 4.11.1 to 4.11.2

Bumps [plexapi](https://github.com/pkkid/python-plexapi) from 4.11.1 to 4.11.2.
- [Release notes](https://github.com/pkkid/python-plexapi/releases)
- [Commits](https://github.com/pkkid/python-plexapi/compare/4.11.1...4.11.2)

---
updated-dependencies:
- dependency-name: plexapi
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

* Update plexapi==4.11.2

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/plexapi/base.py   | 10 +++++-----
 lib/plexapi/const.py  |  2 +-
 lib/plexapi/mixins.py | 28 ++++++++++++++--------------
 lib/plexapi/myplex.py |  2 +-
 lib/plexapi/sync.py   |  6 +++---
 lib/plexapi/video.py  |  6 +++---
 requirements.txt      |  2 +-
 7 files changed, 28 insertions(+), 28 deletions(-)

diff --git a/lib/plexapi/base.py b/lib/plexapi/base.py
index cfe82050..e80b540f 100644
--- a/lib/plexapi/base.py
+++ b/lib/plexapi/base.py
@@ -31,7 +31,7 @@ OPERATORS = {
 }
 
 
-class PlexObject(object):
+class PlexObject:
     """ Base class for all Plex objects.
 
         Parameters:
@@ -50,12 +50,12 @@ class PlexObject(object):
         self._initpath = initpath or self.key
         self._parent = weakref.ref(parent) if parent is not None else None
         self._details_key = None
+        self._overwriteNone = True  # Allow overwriting previous attribute values with `None` when manually reloading
+        self._autoReload = True  # Automatically reload the object when accessing a missing attribute
+        self._edits = None  # Save batch edits for a single API call
         if data is not None:
             self._loadData(data)
         self._details_key = self._buildDetailsKey()
-        self._overwriteNone = True
-        self._edits = None  # Save batch edits for a single API call
-        self._autoReload = True  # Automatically reload the object when accessing a missing attribute
 
     def __repr__(self):
         uid = self._clean(self.firstAttr('_baseurl', 'key', 'id', 'playQueueID', 'uri'))
@@ -649,7 +649,7 @@ class PlexPartialObject(PlexObject):
         return self._getWebURL(base=base)
 
 
-class Playable(object):
+class Playable:
     """ This is a general place to store functions specific to media that is Playable.
         Things were getting mixed up a bit when dealing with Shows, Season, Artists,
         Albums which are all not playable.
diff --git a/lib/plexapi/const.py b/lib/plexapi/const.py
index 3d1860fc..250389fb 100644
--- a/lib/plexapi/const.py
+++ b/lib/plexapi/const.py
@@ -4,6 +4,6 @@
 # Library version
 MAJOR_VERSION = 4
 MINOR_VERSION = 11
-PATCH_VERSION = 1
+PATCH_VERSION = 2
 __short_version__ = f"{MAJOR_VERSION}.{MINOR_VERSION}"
 __version__ = f"{__short_version__}.{PATCH_VERSION}"
diff --git a/lib/plexapi/mixins.py b/lib/plexapi/mixins.py
index 906ab81d..4a6e1f0c 100644
--- a/lib/plexapi/mixins.py
+++ b/lib/plexapi/mixins.py
@@ -8,7 +8,7 @@ from plexapi.exceptions import BadRequest, NotFound
 from plexapi.utils import deprecated
 
 
-class AdvancedSettingsMixin(object):
+class AdvancedSettingsMixin:
     """ Mixin for Plex objects that can have advanced settings. """
 
     def preferences(self):
@@ -60,7 +60,7 @@ class AdvancedSettingsMixin(object):
         self._server.query(url, method=self._server._session.put)
 
 
-class SmartFilterMixin(object):
+class SmartFilterMixin:
     """ Mixing for Plex objects that can have smart filters. """
 
     def _parseFilters(self, content):
@@ -120,7 +120,7 @@ class SmartFilterMixin(object):
         return {filterOp: rules}
 
 
-class SplitMergeMixin(object):
+class SplitMergeMixin:
     """ Mixin for Plex objects that can be split and merged. """
 
     def split(self):
@@ -141,7 +141,7 @@ class SplitMergeMixin(object):
         return self._server.query(key, method=self._server._session.put)
 
 
-class UnmatchMatchMixin(object):
+class UnmatchMatchMixin:
     """ Mixin for Plex objects that can be unmatched and matched. """
 
     def unmatch(self):
@@ -234,7 +234,7 @@ class UnmatchMatchMixin(object):
         self._server.query(data, method=self._server._session.put)
 
 
-class ExtrasMixin(object):
+class ExtrasMixin:
     """ Mixin for Plex objects that can have extras. """
 
     def extras(self):
@@ -244,7 +244,7 @@ class ExtrasMixin(object):
         return self.findItems(data, Extra, rtag='Extras')
 
 
-class HubsMixin(object):
+class HubsMixin:
     """ Mixin for Plex objects that can have related hubs. """
 
     def hubs(self):
@@ -254,7 +254,7 @@ class HubsMixin(object):
         return self.findItems(data, Hub, rtag='Related')
 
 
-class RatingMixin(object):
+class RatingMixin:
     """ Mixin for Plex objects that can have user star ratings. """
 
     def rate(self, rating=None):
@@ -274,7 +274,7 @@ class RatingMixin(object):
         self._server.query(key, method=self._server._session.put)
 
 
-class ArtUrlMixin(object):
+class ArtUrlMixin:
     """ Mixin for Plex objects that can have a background artwork url. """
     
     @property
@@ -323,7 +323,7 @@ class ArtMixin(ArtUrlMixin):
         return self._edit(**{'art.locked': 0})
 
 
-class BannerUrlMixin(object):
+class BannerUrlMixin:
     """ Mixin for Plex objects that can have a banner url. """
 
     @property
@@ -372,7 +372,7 @@ class BannerMixin(BannerUrlMixin):
         return self._edit(**{'banner.locked': 0})
 
 
-class PosterUrlMixin(object):
+class PosterUrlMixin:
     """ Mixin for Plex objects that can have a poster url. """
 
     @property
@@ -426,7 +426,7 @@ class PosterMixin(PosterUrlMixin):
         return self._edit(**{'thumb.locked': 0})
 
 
-class ThemeUrlMixin(object):
+class ThemeUrlMixin:
     """ Mixin for Plex objects that can have a theme url. """
 
     @property
@@ -475,7 +475,7 @@ class ThemeMixin(ThemeUrlMixin):
         self._edit(**{'theme.locked': 0})
 
 
-class EditFieldMixin(object):
+class EditFieldMixin:
     """ Mixin for editing Plex object fields. """
     
     def editField(self, field, value, locked=True, **kwargs):
@@ -667,7 +667,7 @@ class PhotoCapturedTimeMixin(EditFieldMixin):
         return self.editField('originallyAvailableAt', capturedTime, locked=locked)
 
 
-class EditTagsMixin(object):
+class EditTagsMixin:
     """ Mixin for editing Plex object tags. """
 
     @deprecated('use "editTags" instead')
@@ -986,7 +986,7 @@ class WriterMixin(EditTagsMixin):
         return self.editTags('writer', writers, locked=locked, remove=True)
 
 
-class WatchlistMixin(object):
+class WatchlistMixin:
     """ Mixin for Plex objects that can be added to a user's watchlist. """
 
     def onWatchlist(self, account=None):
diff --git a/lib/plexapi/myplex.py b/lib/plexapi/myplex.py
index a05a74bd..b7e72d0f 100644
--- a/lib/plexapi/myplex.py
+++ b/lib/plexapi/myplex.py
@@ -1333,7 +1333,7 @@ class MyPlexDevice(PlexObject):
         return self._server.syncItems(client=self)
 
 
-class MyPlexPinLogin(object):
+class MyPlexPinLogin:
     """
         MyPlex PIN login class which supports getting the four character PIN which the user must
         enter on https://plex.tv/link to authenticate the client and provide an access token to
diff --git a/lib/plexapi/sync.py b/lib/plexapi/sync.py
index 53dc0636..0a02f4e9 100644
--- a/lib/plexapi/sync.py
+++ b/lib/plexapi/sync.py
@@ -130,7 +130,7 @@ class SyncList(PlexObject):
                 self.items.append(item)
 
 
-class Status(object):
+class Status:
     """ Represents a current status of specific :class:`~plexapi.sync.SyncItem`.
 
         Attributes:
@@ -168,7 +168,7 @@ class Status(object):
         ))
 
 
-class MediaSettings(object):
+class MediaSettings:
     """ Transcoding settings used for all media within :class:`~plexapi.sync.SyncItem`.
 
         Attributes:
@@ -239,7 +239,7 @@ class MediaSettings(object):
             raise BadRequest('Unexpected photo quality')
 
 
-class Policy(object):
+class Policy:
     """ Policy of syncing the media (how many items to sync and process watched media or not).
 
         Attributes:
diff --git a/lib/plexapi/video.py b/lib/plexapi/video.py
index 1604fef3..95f8336d 100644
--- a/lib/plexapi/video.py
+++ b/lib/plexapi/video.py
@@ -702,7 +702,7 @@ class Season(
 
     def show(self):
         """ Return the season's :class:`~plexapi.video.Show`. """
-        return self.fetchItem(self.parentRatingKey)
+        return self.fetchItem(self.parentKey)
 
     def watched(self):
         """ Returns list of watched :class:`~plexapi.video.Episode` objects. """
@@ -872,7 +872,7 @@ class Episode(
     def seasonNumber(self):
         """ Returns the episode's season number. """
         if self._seasonNumber is None:
-            self._seasonNumber = self.parentIndex if self.parentIndex else self.season().seasonNumber
+            self._seasonNumber = self.parentIndex if isinstance(self.parentIndex, int) else self.season().seasonNumber
         return utils.cast(int, self._seasonNumber)
 
     @property
@@ -901,7 +901,7 @@ class Episode(
 
     def show(self):
         """" Return the episode's :class:`~plexapi.video.Show`. """
-        return self.fetchItem(self.grandparentRatingKey)
+        return self.fetchItem(self.grandparentKey)
 
     def _defaultSyncTitle(self):
         """ Returns str, default title for a new syncItem. """
diff --git a/requirements.txt b/requirements.txt
index 7031b33e..fe7156aa 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -27,7 +27,7 @@ MarkupSafe==2.1.1
 musicbrainzngs==0.7.1
 packaging==21.3
 paho-mqtt==1.6.1
-plexapi==4.11.1
+plexapi==4.11.2
 portend==3.1.0
 profilehooks==1.12.0
 PyJWT==2.4.0

From 695a00350b9129d2f4ce7d089367c3e1d1440f01 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 31 May 2022 10:52:15 -0700
Subject: [PATCH 118/743] Bump actions/cache from 3.0.2 to 3.0.3 (#1755)

Bumps [actions/cache](https://github.com/actions/cache) from 3.0.2 to 3.0.3.
- [Release notes](https://github.com/actions/cache/releases)
- [Changelog](https://github.com/actions/cache/blob/main/RELEASES.md)
- [Commits](https://github.com/actions/cache/compare/v3.0.2...v3.0.3)

---
updated-dependencies:
- dependency-name: actions/cache
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

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

[skip ci]
---
 .github/workflows/publish-docker.yml     | 2 +-
 .github/workflows/publish-installers.yml | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/publish-docker.yml b/.github/workflows/publish-docker.yml
index 0ec7b71e..64747d4c 100644
--- a/.github/workflows/publish-docker.yml
+++ b/.github/workflows/publish-docker.yml
@@ -46,7 +46,7 @@ jobs:
           version: latest
 
       - name: Cache Docker Layers
-        uses: actions/cache@v3.0.2
+        uses: actions/cache@v3.0.3
         with:
           path: /tmp/.buildx-cache
           key: ${{ runner.os }}-buildx-${{ github.sha }}
diff --git a/.github/workflows/publish-installers.yml b/.github/workflows/publish-installers.yml
index a4d6aa09..bb100a2e 100644
--- a/.github/workflows/publish-installers.yml
+++ b/.github/workflows/publish-installers.yml
@@ -56,7 +56,7 @@ jobs:
           python-version: 3.9
 
       - name: Cache Dependencies
-        uses: actions/cache@v3.0.2
+        uses: actions/cache@v3.0.3
         with:
           path: ~\AppData\Local\pip\Cache
           key: ${{ runner.os }}-pip-${{ hashFiles('package/requirements-package.txt') }}

From ca3c2b09cfff9bf05d39c35814ac1bb7b7aa6efe Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 31 May 2022 10:57:01 -0700
Subject: [PATCH 119/743] Add grandparent_guids and parent_guids to
 get_metadata_details

---
 plexpy/pmsconnect.py | 31 +++++++++++++++++++++++----
 plexpy/webserve.py   | 50 ++++++++++++++++++++++++++++++--------------
 2 files changed, 61 insertions(+), 20 deletions(-)

diff --git a/plexpy/pmsconnect.py b/plexpy/pmsconnect.py
index de1f88ef..c7a2f552 100644
--- a/plexpy/pmsconnect.py
+++ b/plexpy/pmsconnect.py
@@ -787,6 +787,8 @@ class PmsConnect(object):
                         'labels': labels,
                         'collections': collections,
                         'guids': guids,
+                        'parent_guids': [],
+                        'grandparent_guids': [],
                         'full_title': helpers.get_xml_attr(metadata_main, 'title'),
                         'children_count': helpers.cast_to_int(helpers.get_xml_attr(metadata_main, 'leafCount')),
                         'live': int(helpers.get_xml_attr(metadata_main, 'live') == '1')
@@ -841,6 +843,8 @@ class PmsConnect(object):
                         'labels': labels,
                         'collections': collections,
                         'guids': guids,
+                        'parent_guids': [],
+                        'grandparent_guids': [],
                         'full_title': helpers.get_xml_attr(metadata_main, 'title'),
                         'children_count': helpers.cast_to_int(helpers.get_xml_attr(metadata_main, 'leafCount')),
                         'live': int(helpers.get_xml_attr(metadata_main, 'live') == '1')
@@ -897,7 +901,9 @@ class PmsConnect(object):
                         'genres': show_details.get('genres', []),
                         'labels': show_details.get('labels', []),
                         'collections': show_details.get('collections', []),
-                        'guids': show_details.get('guids', []),
+                        'guids': guids,
+                        'parent_guids': show_details.get('guids', []),
+                        'grandparent_guids': [],
                         'full_title': '{} - {}'.format(helpers.get_xml_attr(metadata_main, 'parentTitle'),
                                                        helpers.get_xml_attr(metadata_main, 'title')),
                         'children_count': helpers.cast_to_int(helpers.get_xml_attr(metadata_main, 'leafCount')),
@@ -916,6 +922,7 @@ class PmsConnect(object):
             parent_rating_key = helpers.get_xml_attr(metadata_main, 'parentRatingKey')
             parent_media_index = helpers.get_xml_attr(metadata_main, 'parentIndex')
             parent_thumb = helpers.get_xml_attr(metadata_main, 'parentThumb')
+            season_details = self.get_metadata_details(parent_rating_key) if parent_rating_key else {}
 
             if not plex_guid and not parent_rating_key:
                 # Try getting the parent_rating_key from the parent_thumb
@@ -970,7 +977,9 @@ class PmsConnect(object):
                         'genres': show_details.get('genres', []),
                         'labels': show_details.get('labels', []),
                         'collections': show_details.get('collections', []),
-                        'guids': show_details.get('guids', []),
+                        'guids': guids,
+                        'parent_guids': season_details.get('guids', []),
+                        'grandparent_guids': show_details.get('guids', []),
                         'full_title': '{} - {}'.format(helpers.get_xml_attr(metadata_main, 'grandparentTitle'),
                                                        helpers.get_xml_attr(metadata_main, 'title')),
                         'children_count': helpers.cast_to_int(helpers.get_xml_attr(metadata_main, 'leafCount')),
@@ -1021,6 +1030,8 @@ class PmsConnect(object):
                         'labels': labels,
                         'collections': collections,
                         'guids': guids,
+                        'parent_guids': [],
+                        'grandparent_guids': [],
                         'full_title': helpers.get_xml_attr(metadata_main, 'title'),
                         'children_count': helpers.cast_to_int(helpers.get_xml_attr(metadata_main, 'leafCount')),
                         'live': int(helpers.get_xml_attr(metadata_main, 'live') == '1')
@@ -1072,6 +1083,8 @@ class PmsConnect(object):
                         'labels': labels,
                         'collections': collections,
                         'guids': guids,
+                        'parent_guids': artist_details.get('guids', []),
+                        'grandparent_guids': [],
                         'full_title': '{} - {}'.format(helpers.get_xml_attr(metadata_main, 'parentTitle'),
                                                        helpers.get_xml_attr(metadata_main, 'title')),
                         'children_count': helpers.cast_to_int(helpers.get_xml_attr(metadata_main, 'leafCount')),
@@ -1125,7 +1138,9 @@ class PmsConnect(object):
                         'genres': album_details.get('genres', []),
                         'labels': album_details.get('labels', []),
                         'collections': album_details.get('collections', []),
-                        'guids': album_details.get('guids', []),
+                        'guids': guids,
+                        'parent_guids': album_details.get('guids', []),
+                        'grandparent_guids': album_details.get('parent_guids', []),
                         'full_title': '{} - {}'.format(helpers.get_xml_attr(metadata_main, 'title'),
                                                        track_artist),
                         'children_count': helpers.cast_to_int(helpers.get_xml_attr(metadata_main, 'leafCount')),
@@ -1176,6 +1191,8 @@ class PmsConnect(object):
                         'labels': labels,
                         'collections': collections,
                         'guids': guids,
+                        'parent_guids': [],
+                        'grandparent_guids': [],
                         'full_title': helpers.get_xml_attr(metadata_main, 'title'),
                         'children_count': helpers.cast_to_int(helpers.get_xml_attr(metadata_main, 'leafCount')),
                         'live': int(helpers.get_xml_attr(metadata_main, 'live') == '1')
@@ -1226,7 +1243,9 @@ class PmsConnect(object):
                         'genres': photo_album_details.get('genres', []),
                         'labels': photo_album_details.get('labels', []),
                         'collections': photo_album_details.get('collections', []),
-                        'guids': photo_album_details.get('guids', []),
+                        'guids': [],
+                        'parent_guids': photo_album_details.get('guids', []),
+                        'grandparent_guids': [],
                         'full_title': '{} - {}'.format(helpers.get_xml_attr(metadata_main, 'parentTitle') or library_name,
                                                        helpers.get_xml_attr(metadata_main, 'title')),
                         'children_count': helpers.cast_to_int(helpers.get_xml_attr(metadata_main, 'leafCount')),
@@ -1281,6 +1300,8 @@ class PmsConnect(object):
                         'labels': labels,
                         'collections': collections,
                         'guids': guids,
+                        'parent_guids': [],
+                        'grandparent_guids': [],
                         'full_title': helpers.get_xml_attr(metadata_main, 'title'),
                         'children_count': helpers.cast_to_int(helpers.get_xml_attr(metadata_main, 'childCount')),
                         'live': int(helpers.get_xml_attr(metadata_main, 'live') == '1'),
@@ -1351,6 +1372,8 @@ class PmsConnect(object):
                         'labels': labels,
                         'collections': collections,
                         'guids': guids,
+                        'parent_guids': [],
+                        'grandparent_guids': [],
                         'full_title': helpers.get_xml_attr(metadata_main, 'title'),
                         'extra_type': helpers.get_xml_attr(metadata_main, 'extraType'),
                         'sub_type': helpers.get_xml_attr(metadata_main, 'subtype'),
diff --git a/plexpy/webserve.py b/plexpy/webserve.py
index 1d61eece..85ab4ecf 100644
--- a/plexpy/webserve.py
+++ b/plexpy/webserve.py
@@ -5283,16 +5283,21 @@ class WebInterface(object):
             Returns:
                 json:
                     {"actors": [
-                        "Kit Harington",
                         "Emilia Clarke",
-                        "Isaac Hempstead-Wright",
+                        "Lena Headey",
+                        "Sophie Turner",
+                        "Kit Harington",
+                        "Peter Dinklage",
+                        "Nikolaj Coster-Waldau",
                         "Maisie Williams",
-                        "Liam Cunningham",
+                        "Iain Glen",
+                        "John Bradley",
+                        "Alfie Allen"
                      ],
                      "added_at": "1461572396",
                      "art": "/library/metadata/1219/art/1462175063",
-                     "audience_rating": "8",
-                     "audience_rating_image": "rottentomatoes://image.rating.upright",
+                     "audience_rating": "7.4",
+                     "audience_rating_image": "themoviedb://image.rating",
                      "banner": "/library/metadata/1219/banner/1462175063",
                      "collections": [],
                      "content_rating": "TV-MA",
@@ -5302,16 +5307,26 @@ class WebInterface(object):
                      "duration": "2998290",
                      "full_title": "Game of Thrones - The Red Woman",
                      "genres": [
-                        "Adventure",
+                        "Action/Adventure",
                         "Drama",
-                        "Fantasy"
+                        "Fantasy",
+                        "Romance"
+                     ],
+                     "grandparent_guid": "plex://show/5d9c086c46115600200aa2fe",
+                     "grandparent_guids": [
+                         "imdb://tt0944947",
+                         "tmdb://1399",
+                         "tvdb://121361"
                      ],
-                     "grandparent_guid": "com.plexapp.agents.thetvdb://121361?lang=en",
                      "grandparent_rating_key": "1219",
                      "grandparent_thumb": "/library/metadata/1219/thumb/1462175063",
                      "grandparent_title": "Game of Thrones",
-                     "guid": "com.plexapp.agents.thetvdb://121361/6/1?lang=en",
-                     "guids": [],
+                     "guid": "plex://episode/5d9c1276e9d5a1001f4ff2fa",
+                     "guids": [
+                         "imdb://tt3658014",
+                         "tmdb://1156503",
+                         "tvdb://5469015"
+                     ],
                      "labels": [],
                      "last_viewed_at": "1462165717",
                      "library_name": "TV Shows",
@@ -5401,18 +5416,21 @@ class WebInterface(object):
                      "media_type": "episode",
                      "original_title": "",
                      "originally_available_at": "2016-04-24",
-                     "parent_guid": "com.plexapp.agents.thetvdb://121361/6?lang=en",
+                     "parent_guid": "plex://season/602e67e61d3358002c4120f7",
+                     "parent_guids": [
+                         "tvdb://651357"
+                     ],
                      "parent_media_index": "6",
                      "parent_rating_key": "153036",
                      "parent_thumb": "/library/metadata/153036/thumb/1462175062",
-                     "parent_title": "",
-                     "rating": "7.8",
-                     "rating_image": "rottentomatoes://image.rating.ripe",
+                     "parent_title": "Season 6",
+                     "rating": "",
+                     "rating_image": "",
                      "rating_key": "153037",
                      "section_id": "2",
                      "sort_title": "Red Woman",
-                     "studio": "HBO",
-                     "summary": "Jon Snow is dead. Daenerys meets a strong man. Cersei sees her daughter again.",
+                     "studio": "Revolution Sun Studios",
+                     "summary": "The fate of Jon Snow is revealed. Daenerys meets a strong man. Cersei sees her daughter once again.",
                      "tagline": "",
                      "thumb": "/library/metadata/153037/thumb/1462175060",
                      "title": "The Red Woman",

From 0576920b89beaeb3eb86cd54ded362b213f0cfee Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 31 May 2022 10:40:25 -0700
Subject: [PATCH 120/743] Add support for mbid:// guids in notification
 parameters

* Requires PMS 1.27.0.5849
---
 plexpy/notification_handler.py | 19 +++++++++++++++++--
 1 file changed, 17 insertions(+), 2 deletions(-)

diff --git a/plexpy/notification_handler.py b/plexpy/notification_handler.py
index e747f3ae..747a860f 100644
--- a/plexpy/notification_handler.py
+++ b/plexpy/notification_handler.py
@@ -1,4 +1,4 @@
-# -*- coding: utf-8 -*-
+# -*- coding: utf-8 -*-
 
 #  This file is part of Tautulli.
 #
@@ -643,13 +643,22 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
         rating_key=plex_web_rating_key)
 
     # Check external guids
-    for guid in notify_params['guids']:
+    if notify_params['media_type'] == 'episode':
+        guids = notify_params['grandparent_guids']
+    elif notify_params['media_type'] in ('season', 'track'):
+        guids = notify_params['parent_guids']
+    else:
+        guids = notify_params['guids']
+
+    for guid in guids:
         if 'imdb://' in guid:
             notify_params['imdb_id'] = guid.split('imdb://')[1]
         elif 'tmdb://' in guid:
             notify_params['themoviedb_id'] = guid.split('tmdb://')[1]
         elif 'tvdb://' in guid:
             notify_params['thetvdb_id'] = guid.split('tvdb://')[1]
+        elif 'mbid://' in guid:
+            notify_params['musicbrainz_id'] = guid.split('mbid://')[1]
 
     # Get media IDs from guid and build URLs
     if 'plex://' in notify_params['guid']:
@@ -685,6 +694,12 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
         notify_params['lastfm_id'] = '/'.join(notify_params['guid'].split('lastfm://')[1].split('?')[0].split('/')[:2])
         notify_params['lastfm_url'] = 'https://www.last.fm/music/' + notify_params['lastfm_id']
 
+    if 'mbid://' in notify_params['guid'] or notify_params['musicbrainz_id']:
+        if notify_params['media_type'] == 'artist':
+            notify_params['musicbrainz_url'] = 'https://musicbrainz.org/artist/' + notify_params['musicbrainz_id']
+        else:
+            notify_params['musicbrainz_url'] = 'https://musicbrainz.org/release/' + notify_params['musicbrainz_id']
+
     # Get TheMovieDB info (for movies and tv only)
     if plexpy.CONFIG.THEMOVIEDB_LOOKUP and notify_params['media_type'] in ('movie', 'show', 'season', 'episode'):
         if notify_params.get('themoviedb_id'):

From 1bd516815634b75628047d8d0fb7fffe2ae70346 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Wed, 1 Jun 2022 09:42:47 -0700
Subject: [PATCH 121/743] Fix OneSignal device validation

* OneSignal changed to only accept `app_id` as a query parameter instead of in the payload
---
 plexpy/mobile_app.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/plexpy/mobile_app.py b/plexpy/mobile_app.py
index 75a33439..458f84a0 100644
--- a/plexpy/mobile_app.py
+++ b/plexpy/mobile_app.py
@@ -207,11 +207,11 @@ def validate_onesignal_id(onesignal_id):
         return 2
 
     headers = {'Content-Type': 'application/json'}
-    payload = {'app_id': _ONESIGNAL_APP_ID}
+    params = {'app_id': _ONESIGNAL_APP_ID}
 
     logger.info("Tautulli MobileApp :: Validating OneSignal ID")
     try:
-        r = requests.get('https://onesignal.com/api/v1/players/{}'.format(onesignal_id), headers=headers, json=payload)
+        r = requests.get('https://onesignal.com/api/v1/players/{}'.format(onesignal_id), headers=headers, params=params)
         status_code = r.status_code
         logger.info("Tautulli MobileApp :: OneSignal ID validation returned status code %s", status_code)
         return int(status_code == 200)

From a2c589fca46a83b0a244fcc59774ca7c51289b71 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Wed, 1 Jun 2022 10:18:41 -0700
Subject: [PATCH 122/743] v2.10.1

---
 CHANGELOG.md      | 13 +++++++++++++
 plexpy/version.py |  2 +-
 2 files changed, 14 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 37091625..54ed38b5 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,18 @@
 # Changelog
 
+## v2.10.1 (2022-06-01)
+
+* Notifications:
+  * New: Added support for MusicBrainz (mbid://) guids in notification parameters without MusicBrainz lookup enabled. Requires Plex Media Server 1.27.0 or newer with refreshed Plex Music agent metadata.
+* Mobile App:
+  * Fix: OneSignal validation failing when registering a device.
+* API:
+  * New: Added grandparent_guids and parent_guids to get_metadata API command.
+  * Change: Updated continent in get_geoip_lookup API command.
+  * Change: Removed server_token from from get_users API command.
+  * Change: shared_libraries changed to a list instead of a string for get_users API command.
+
+
 ## v2.10.0 (2022-05-23)
 
 * Activity:
diff --git a/plexpy/version.py b/plexpy/version.py
index 9967683c..b5c1abb8 100644
--- a/plexpy/version.py
+++ b/plexpy/version.py
@@ -18,4 +18,4 @@
 from __future__ import unicode_literals
 
 PLEXPY_BRANCH = "master"
-PLEXPY_RELEASE_VERSION = "v2.10.0"
+PLEXPY_RELEASE_VERSION = "v2.10.1"

From ebbd66d0565e077099dc62dbfcc87ad1ac2da2cc Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 3 Jun 2022 09:41:36 -0700
Subject: [PATCH 123/743] Fix empty recently added error message

---
 plexpy/webserve.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/plexpy/webserve.py b/plexpy/webserve.py
index 85ab4ecf..b00991a2 100644
--- a/plexpy/webserve.py
+++ b/plexpy/webserve.py
@@ -424,7 +424,7 @@ class WebInterface(object):
         except IOError as e:
             return serve_template(templatename="recently_added.html", data=None)
 
-        if result and result['recently_added']:
+        if result and 'recently_added' in result:
             return serve_template(templatename="recently_added.html", data=result['recently_added'])
         else:
             logger.warn("Unable to retrieve data for get_recently_added.")

From 15fb052716bc1b9f404af22e554db62d312dbb73 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 4 Jun 2022 17:57:57 -0700
Subject: [PATCH 124/743] Fix stream audio info when playing a secondary track

---
 plexpy/pmsconnect.py | 48 +++++++++++++++++++++++++-------------------
 1 file changed, 27 insertions(+), 21 deletions(-)

diff --git a/plexpy/pmsconnect.py b/plexpy/pmsconnect.py
index c7a2f552..b168683c 100644
--- a/plexpy/pmsconnect.py
+++ b/plexpy/pmsconnect.py
@@ -1876,12 +1876,15 @@ class PmsConnect(object):
             video_details = {'stream_video_bitrate': helpers.get_xml_attr(video_stream_info, 'bitrate'),
                              'stream_video_bit_depth': helpers.get_xml_attr(video_stream_info, 'bitDepth'),
                              'stream_video_chroma_subsampling': helpers.get_xml_attr(video_stream_info, 'chromaSubsampling'),
+                             'stream_video_codec': helpers.get_xml_attr(video_stream_info, 'codec'),
+                             'stream_video_codec_level': helpers.get_xml_attr(video_stream_info, 'level'),
                              'stream_video_color_primaries': helpers.get_xml_attr(video_stream_info, 'colorPrimaries'),
                              'stream_video_color_range': helpers.get_xml_attr(video_stream_info, 'colorRange'),
                              'stream_video_color_space': helpers.get_xml_attr(video_stream_info, 'colorSpace'),
                              'stream_video_color_trc': helpers.get_xml_attr(video_stream_info, 'colorTrc'),
-                             'stream_video_codec_level': helpers.get_xml_attr(video_stream_info, 'level'),
                              'stream_video_dynamic_range': self.get_dynamic_range(video_stream_info),
+                             'stream_video_height': helpers.get_xml_attr(video_stream_info, 'height'),
+                             'stream_video_width': helpers.get_xml_attr(video_stream_info, 'width'),
                              'stream_video_ref_frames': helpers.get_xml_attr(video_stream_info, 'refFrames'),
                              'stream_video_language': helpers.get_xml_attr(video_stream_info, 'language'),
                              'stream_video_language_code': helpers.get_xml_attr(video_stream_info, 'languageCode'),
@@ -1892,12 +1895,15 @@ class PmsConnect(object):
             video_details = {'stream_video_bitrate': '',
                              'stream_video_bit_depth': '',
                              'stream_video_chroma_subsampling': '',
+                             'stream_video_codec': '',
+                             'stream_video_codec_level': '',
                              'stream_video_color_primaries': '',
                              'stream_video_color_range': '',
                              'stream_video_color_space': '',
                              'stream_video_color_trc': '',
-                             'stream_video_codec_level': '',
                              'stream_video_dynamic_range': '',
+                             'stream_video_height': '',
+                             'stream_video_width': '',
                              'stream_video_ref_frames': '',
                              'stream_video_language': '',
                              'stream_video_language_code': '',
@@ -1907,10 +1913,16 @@ class PmsConnect(object):
 
         if audio_stream_info:
             audio_id = helpers.get_xml_attr(audio_stream_info, 'id')
+            stream_audio_channels = helpers.get_xml_attr(audio_stream_info, 'channels')
+            stream_audio_channel_layouts_ = helpers.get_xml_attr(audio_stream_info, 'audioChannelLayout')
             audio_details = {'stream_audio_bitrate': helpers.get_xml_attr(audio_stream_info, 'bitrate'),
                              'stream_audio_bitrate_mode': helpers.get_xml_attr(audio_stream_info, 'bitrateMode'),
+                             'stream_audio_channels': stream_audio_channels,
+                             'stream_audio_channel_layout': stream_audio_channel_layouts_ or common.AUDIO_CHANNELS.get(
+                                 stream_audio_channels, stream_audio_channels),
+                             'stream_audio_codec': helpers.get_xml_attr(audio_stream_info, 'codec'),
                              'stream_audio_sample_rate': helpers.get_xml_attr(audio_stream_info, 'samplingRate'),
-                             'stream_audio_channel_layout_': helpers.get_xml_attr(audio_stream_info, 'audioChannelLayout'),
+                             'stream_audio_channel_layout_': stream_audio_channel_layouts_,
                              'stream_audio_language': helpers.get_xml_attr(audio_stream_info, 'language'),
                              'stream_audio_language_code': helpers.get_xml_attr(audio_stream_info, 'languageCode'),
                              'stream_audio_decision': helpers.get_xml_attr(audio_stream_info, 'decision') or 'direct play'
@@ -1918,6 +1930,9 @@ class PmsConnect(object):
         else:
             audio_details = {'stream_audio_bitrate': '',
                              'stream_audio_bitrate_mode': '',
+                             'stream_audio_channels': '',
+                             'stream_audio_channel_layout': '',
+                             'stream_audio_codec': '',
                              'stream_audio_sample_rate': '',
                              'stream_audio_channel_layout_': '',
                              'stream_audio_language': '',
@@ -1960,25 +1975,16 @@ class PmsConnect(object):
         else:
             bif_thumb = ''
 
-        stream_video_width = helpers.get_xml_attr(stream_media_info, 'width')
-        if helpers.cast_to_int(stream_video_width) >= 3840:
+        if helpers.cast_to_int(video_details['stream_video_width']) >= 3840:
             stream_video_resolution = '4k'
         else:
             stream_video_resolution = helpers.get_xml_attr(stream_media_info, 'videoResolution').lower().rstrip('ip')
 
-        stream_audio_channels = helpers.get_xml_attr(stream_media_info, 'audioChannels')
-
         stream_details = {'stream_container': helpers.get_xml_attr(stream_media_info, 'container'),
                           'stream_bitrate': helpers.get_xml_attr(stream_media_info, 'bitrate'),
                           'stream_aspect_ratio': helpers.get_xml_attr(stream_media_info, 'aspectRatio'),
-                          'stream_audio_codec': helpers.get_xml_attr(stream_media_info, 'audioCodec'),
-                          'stream_audio_channels': stream_audio_channels,
-                          'stream_audio_channel_layout': audio_details.get('stream_audio_channel_layout_') or common.AUDIO_CHANNELS.get(stream_audio_channels, stream_audio_channels),
-                          'stream_video_codec': helpers.get_xml_attr(stream_media_info, 'videoCodec'),
                           'stream_video_framerate': helpers.get_xml_attr(stream_media_info, 'videoFrameRate'),
                           'stream_video_resolution': stream_video_resolution,
-                          'stream_video_height': helpers.get_xml_attr(stream_media_info, 'height'),
-                          'stream_video_width': helpers.get_xml_attr(stream_media_info, 'width'),
                           'stream_duration': helpers.get_xml_attr(stream_media_info, 'duration') or helpers.get_xml_attr(session, 'duration'),
                           'stream_container_decision': 'direct play' if sync_id else helpers.get_xml_attr(stream_media_parts_info, 'decision').replace('directplay', 'direct play'),
                           'optimized_version': int(helpers.get_xml_attr(stream_media_info, 'proxyType') == '42'),
@@ -2142,12 +2148,12 @@ class PmsConnect(object):
             stream_details['stream_container'] = transcode_details['transcode_container']
 
             video_details['stream_video_decision'] = transcode_details['video_decision']
-            stream_details['stream_video_codec'] = transcode_details['transcode_video_codec']
+            video_details['stream_video_codec'] = transcode_details['transcode_video_codec']
 
             audio_details['stream_audio_decision'] = transcode_details['audio_decision']
-            stream_details['stream_audio_codec'] = transcode_details['transcode_audio_codec']
-            stream_details['stream_audio_channels'] = transcode_details['transcode_audio_channels']
-            stream_details['stream_audio_channel_layout'] = common.AUDIO_CHANNELS.get(
+            audio_details['stream_audio_codec'] = transcode_details['transcode_audio_codec']
+            audio_details['stream_audio_channels'] = transcode_details['transcode_audio_channels']
+            audio_details['stream_audio_channel_layout'] = common.AUDIO_CHANNELS.get(
                 transcode_details['transcode_audio_channels'], transcode_details['transcode_audio_channels'])
 
         # Generate a combined transcode decision value
@@ -2162,14 +2168,14 @@ class PmsConnect(object):
         stream_details['container_decision'] = stream_details['stream_container_decision']
 
         # Override * in audio codecs
-        if stream_details['stream_audio_codec'] == '*':
-            stream_details['stream_audio_codec'] = source_audio_details.get('audio_codec', '')
+        if audio_details['stream_audio_codec'] == '*':
+            audio_details['stream_audio_codec'] = source_audio_details.get('audio_codec', '')
         if transcode_details['transcode_audio_codec'] == '*':
             transcode_details['transcode_audio_codec'] = source_audio_details.get('audio_codec', '')
 
         # Override * in video codecs
-        if stream_details['stream_video_codec'] == '*':
-            stream_details['stream_video_codec'] = source_video_details.get('video_codec', '')
+        if video_details['stream_video_codec'] == '*':
+            video_details['stream_video_codec'] = source_video_details.get('video_codec', '')
         if transcode_details['transcode_video_codec'] == '*':
             transcode_details['transcode_video_codec'] = source_video_details.get('video_codec', '')
 

From ed103bc5dec0b86770b94580bedaee6d67907439 Mon Sep 17 00:00:00 2001
From: TheMeanCanEHdian <drivard100@gmail.com>
Date: Sun, 3 Jul 2022 15:31:33 -0500
Subject: [PATCH 125/743] Update library icons to latest Plex style. (#1779)

* Update library icons to latest Plex style.

* Add back mistakenly removed live icons.

* Update live icon to match new style.

* Adjust icon size.

* Better center icon.
---
 .../default/images/libraries/artist.png       | Bin 4537 -> 2679 bytes
 .../default/images/libraries/artist.svg       |  12 +++--
 .../default/images/libraries/live.png         | Bin 6360 -> 6549 bytes
 .../default/images/libraries/live.svg         |  43 ++++++++++++++----
 .../default/images/libraries/movie.png        | Bin 1790 -> 1780 bytes
 .../default/images/libraries/movie.svg        |  20 ++++++--
 .../default/images/libraries/photo.png        | Bin 5436 -> 4602 bytes
 .../default/images/libraries/photo.svg        |  29 ++++++++++--
 .../default/images/libraries/playlist.png     | Bin 1115 -> 875 bytes
 .../default/images/libraries/playlist.svg     |  19 ++++----
 .../default/images/libraries/show.png         | Bin 1177 -> 1374 bytes
 .../default/images/libraries/show.svg         |  16 +++++--
 .../default/images/libraries/video.png        | Bin 2356 -> 2712 bytes
 .../default/images/libraries/video.svg        |  16 +++++--
 14 files changed, 115 insertions(+), 40 deletions(-)

diff --git a/data/interfaces/default/images/libraries/artist.png b/data/interfaces/default/images/libraries/artist.png
index 10a67be019bb3e94fea4405cbbbe6dcece602d3e..7c9c6c0391904ef0b01cba049f6b76a821fd187f 100644
GIT binary patch
literal 2679
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
DsvMwJ

literal 4537
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

diff --git a/data/interfaces/default/images/libraries/artist.svg b/data/interfaces/default/images/libraries/artist.svg
index b3bfa5b5..37920c10 100644
--- a/data/interfaces/default/images/libraries/artist.svg
+++ b/data/interfaces/default/images/libraries/artist.svg
@@ -1,5 +1,11 @@
-<!-- Generated by IcoMoon.io -->
-<svg version="1.1" xmlns="http://www.w3.org/2000/svg" width="32" height="32" viewBox="0 0 32 32">
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Generator: Adobe Illustrator 16.0.0, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+	 width="32px" height="32px" viewBox="0 0 32 32" enable-background="new 0 0 32 32" xml:space="preserve">
 <title>artist</title>
-<path fill="#fff" d="M9.201 24.681c0-6.699 0-13.358 0-20.035 7.594-1.505 15.157-3.004 22.768-4.513 0 0.172 0 0.319 0 0.465 0 7.067-0.026 14.135 0.021 21.202 0.010 1.498-0.59 2.57-1.716 3.423-1.999 1.512-4.26 2.145-6.751 1.88-0.504-0.054-1.020-0.205-1.481-0.418-1.502-0.695-1.856-2.122-0.908-3.48 0.826-1.184 1.99-1.924 3.302-2.433 1.362-0.528 2.774-0.843 4.252-0.719 0.324 0.027 0.646 0.084 0.994 0.13 0-4.345 0-8.679 0-13.050-6.062 1.204-12.099 2.404-18.16 3.608 0 0.196 0 0.345 0 0.495 0 5.174-0.006 10.349 0.004 15.523 0.003 1.409-0.802 2.302-1.854 3.056-0.889 0.637-1.859 1.114-2.906 1.426-1.524 0.453-3.067 0.627-4.619 0.169-0.952-0.281-1.789-0.736-2.010-1.83-0.136-0.673 0.098-1.269 0.459-1.822 0.772-1.183 1.947-1.853 3.193-2.388 1.662-0.714 3.394-1.043 5.207-0.698 0.048 0.009 0.099 0.005 0.206 0.010z"></path>
+<path fill="#FFFFFF" d="M29.369,0.72H10.271C8.864,0.722,7.726,1.861,7.724,3.267v18.534c-0.771-0.459-1.649-0.703-2.546-0.709
+	c-2.813,0-5.094,2.281-5.094,5.094s2.281,5.094,5.094,5.094s5.093-2.281,5.093-5.094V10.907h19.099v10.894
+	c-0.771-0.459-1.649-0.703-2.546-0.709c-2.813,0-5.094,2.281-5.094,5.094s2.281,5.094,5.094,5.094s5.093-2.281,5.093-5.094V3.267
+	C31.914,1.861,30.775,0.722,29.369,0.72z M10.271,3.267h19.099V8.36H10.271V3.267z"/>
 </svg>
diff --git a/data/interfaces/default/images/libraries/live.png b/data/interfaces/default/images/libraries/live.png
index 6c07e3b9c8b261381aaba1bc50078b9530aa6ea8..4b642df4d92c679b54a725204ef673c36d979566 100644
GIT binary patch
literal 6549
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

literal 6360
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
Js#CU$`5(7R+uHyD

diff --git a/data/interfaces/default/images/libraries/live.svg b/data/interfaces/default/images/libraries/live.svg
index 8df1503e..42a4f874 100644
--- a/data/interfaces/default/images/libraries/live.svg
+++ b/data/interfaces/default/images/libraries/live.svg
@@ -1,9 +1,36 @@
-<!-- Generated by IcoMoon.io -->
-<svg version="1.1" xmlns="http://www.w3.org/2000/svg" width="32" height="32" viewBox="0 0 32 32">
-<title>live</title>
-<path fill="#fff" d="M9.636 10.115c-0.829 0.544-1.243 0.816-2.072 1.361-2.331-3.547-2.331-6.195 0-9.749 0.829 0.546 1.244 0.819 2.072 1.361-1.68 2.557-1.68 4.464 0 7.027z"></path>
-<path fill="#fff" d="M4.374 11.662c-0.828 0.542-1.243 0.815-2.072 1.359-3.069-4.676-3.069-8.159 0-12.838 0.829 0.546 1.244 0.817 2.072 1.362-2.418 3.684-2.418 6.426 0 10.117z"></path>
-<path fill="#fff" d="M22.365 10.115c0.826 0.544 1.242 0.816 2.070 1.361 2.334-3.547 2.334-6.195 0-9.749-0.828 0.546-1.244 0.819-2.070 1.361 1.677 2.557 1.677 4.464 0 7.027z"></path>
-<path fill="#fff" d="M27.627 11.662c0.827 0.542 1.243 0.815 2.070 1.359 3.070-4.676 3.070-8.159 0-12.838-0.827 0.546-1.243 0.817-2.070 1.362 2.419 3.684 2.419 6.426 0 10.117z"></path>
-<path fill="#fff" d="M25.211 31.982l2.611-0.95-8.172-22.45c0.32-0.589 0.502-1.263 0.502-1.979 0-2.293-1.859-4.152-4.152-4.152s-4.151 1.858-4.151 4.152c0 0.672 0.16 1.305 0.443 1.868l-8.212 22.561 2.612 0.95 1.952-5.362h14.616l1.951 5.362zM17.396 10.513l3.945 10.834-7.903-7.9 1.080-2.966c0.46 0.176 0.96 0.272 1.481 0.272 0.49 0.001 0.961-0.084 1.397-0.24zM12.39 16.329l7.51 7.512h-10.245l2.735-7.512z"></path>
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Generator: Adobe Illustrator 16.0.0, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" id="Layer_2" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+	 width="32px" height="32px" viewBox="0 0 32 32" enable-background="new 0 0 32 32" xml:space="preserve">
+<g>
+	<polygon fill="none" points="12.252,15.364 9.287,23.717 20.6,23.709 	"/>
+	<path fill="none" d="M13.122,12.92l8.846,8.846l-4.158-11.71c-0.558,0.271-1.175,0.437-1.839,0.437
+		c-0.66,0-1.276-0.164-1.833-0.434L13.122,12.92z"/>
+	<path fill="#FFFFFF" d="M19.663,8.28c0.33-0.601,0.529-1.277,0.529-2.008c0-2.333-1.892-4.223-4.222-4.223s-4.222,1.89-4.222,4.223
+		c0,0.733,0.203,1.412,0.532,2.013l-7.56,21.292c-0.248,0.697,0.047,1.434,0.656,1.654c0.608,0.215,1.305-0.177,1.549-0.865
+		l1.53-4.309l15.034-0.007l1.532,4.315c0.247,0.688,0.941,1.08,1.549,0.865c0.61-0.221,0.904-0.957,0.658-1.654L19.663,8.28z
+		 M17.81,10.057l4.158,11.71l-8.846-8.846l1.016-2.861c0.557,0.27,1.173,0.434,1.833,0.434
+		C16.635,10.493,17.252,10.328,17.81,10.057z M12.252,15.364l8.347,8.345L9.287,23.717L12.252,15.364z"/>
+	<g>
+		<path fill="#FFFFFF" d="M3.638,1.458C3.189,0.996,2.563,0.875,2.279,1.211c-3.043,3.578-3.045,8.859-0.002,12.44
+			c0.284,0.335,0.913,0.214,1.362-0.25c0.452-0.462,0.628-1.022,0.424-1.264C1.76,9.428,1.762,5.433,4.064,2.726
+			C4.267,2.484,4.089,1.924,3.638,1.458z"/>
+	</g>
+	<g>
+		<path fill="#FFFFFF" d="M28.303,1.46c-0.45,0.464-0.626,1.021-0.421,1.261c2.303,2.71,2.3,6.707-0.003,9.412
+			c-0.205,0.24-0.025,0.802,0.424,1.266c0.448,0.466,1.075,0.586,1.361,0.25c3.044-3.578,3.046-8.86,0.003-12.441
+			C29.38,0.873,28.753,0.996,28.303,1.46z"/>
+	</g>
+	<g>
+		<path fill="#FFFFFF" d="M8.847,11.926c0.453-0.465,0.687-0.966,0.546-1.132C7.78,8.897,7.781,6.1,9.392,4.205
+			c0.141-0.167-0.094-0.672-0.545-1.138c-0.448-0.463-1.019-0.639-1.24-0.376c-2.351,2.766-2.353,6.848,0,9.616
+			C7.826,12.569,8.398,12.39,8.847,11.926z"/>
+	</g>
+	<g>
+		<path fill="#FFFFFF" d="M23.182,11.858c0.45,0.466,1.017,0.642,1.24,0.379c2.353-2.766,2.354-6.849,0.001-9.617
+			C24.199,2.362,23.63,2.54,23.18,3.004c-0.449,0.464-0.685,0.967-0.542,1.132c1.611,1.896,1.61,4.692-0.001,6.587
+			C22.495,10.888,22.73,11.393,23.182,11.858z"/>
+	</g>
+</g>
 </svg>
diff --git a/data/interfaces/default/images/libraries/movie.png b/data/interfaces/default/images/libraries/movie.png
index 6510383d2938e097a7fd33e178af71a97b3c76f0..454fc66bfbe4f6ef8fd0b9c7f811560253c1fd25 100644
GIT binary patch
literal 1780
zcmeAS@N?(olHy`uVBq!ia0y~yVAKI&4mO}jWo=(6kdiEMjVKAuPb(=;EJ|f?Ovz75
zRq)JBOiv9;O-!jQJeg|4z`!=m)5S5Q;?|qHy@As13=J1=^RS)}jd<q}qHvLMB|~|_
z3WlXj1?&r(E-(hMhOvifZLqrWruC?D%a4gSUCW>Cohds>Ab!f!ce7&)U(8}-XxQY`
z*?dHT{pD$u-ax73%Umg+O~f+KIB~4r%c|}E%A!}_GK9fD^YB;G-q-QH*Uue1wb1J9
zLa7SA2HCYmJM_wVulpVJ+L#p{BA&@}*7AebX_Iq7Th?{6Yae~3w0;ePS5|mbx@*(a
z?G5I=-&ZzN-TJ=0Z{BSswv9}`gw{T9`s%x;VS7&)*R_Yq_y0WZjEL<J{cy}}r>%Z`
z;?wzT|B~M|*#0cO?azOBTEy1((OaVrF0^F+mNN6$!)L!EZ*OZ^p2Yg*=7yU^lA$*?
z?fP|ZN0aQ0{bi+JGi#@A-Fe7LOnZUyySn(F7e%L?mT1u1Sw7SG#tpuI2KEleYj)fg
zTbIwN{*3j-g88{o{L|JdTyR~Sd+?LzLI?5Q?X27jF0*jI=xsiAe7@;+d8hbGp27dT
z{-jEU$MKa!#K(Pq`z`m<^@Ov|9G54t_ZaqN+Y~O9SKo8|dTrI5%d-w{Qe~-f-oS8>
zNkGS80|N^;kN~lP1endj4Q3M~DWDU~z#-O<!1(^E<I~6e$vu}39ha%PwcyOokcWR{
zzFS62wrSvF)9x*fb|S^}ilDdWOX8meUef4oT+SDlJN4M24~Ff&N2QNm;ky>fkr?%<
z!SLAZW4*cyT3oH{`?==NfBQ4;?J==!Ee`n{VhRxqO{`#7LD>osKo^1qnplaHY)a(<
zhslGzRx4`$^cx=Ye3;B<lN<0XW>rC5-J9YKcF!40&TI5aljyNajha8=d-)%?FIpcM
z9AF<&-zu<7m4C*eOLZA_FL!)-clgJ`hDex~>hiof_EbatLY&hN$nD5Jx7JlEeOV*l
z?u@+rX-W|$s|607F}V<Gcx-Cq22~c^(fy!2{P*<v=aYM$FO#&&oOJGdMk_G5NC~<>
za#{CV9=$hN$0h$+sdpkM>LwnGe3(3M$;X}R5B@T5G0?6&Ao2LrYo4x%Pz!tYZ7r~v
zBF=YUw}4|1ySv`s0H(tEM<kB7_FI11;yANdbMAa|AR8E8ZCn4dH^iHHBqw=uVAqU2
zvG}k0JM-OUlV`2{m6v|ZsnAHAc`Wo{@;39iGryQdd=@yg<q6~G*a{YIE|%4Yep;@T
z)QNUlU=Gbeq~<1YK3uWx+uB#he_p$)%ByX2F0u7E=lhSP_UkM;AHLJS#Jt}#UM)`C
z;W)4WbO)yP^&DasPA8o8WxwF~Irm`H4Dkicb=xxk`hIu(_37{(2HDSwEgN=iKXmH<
z0WIzqS6;o+3!5E%=vw$^=8_Y8)mp#qKY9Dm`%IoQ!W+`xo_ck8vG$rjysLE<2(MoK
zHNrL`aqZeo`%FvgL>V5aPRo?ZV|#tDb@9)53*-0$a&vQ!Wo2(D+OqEQbnjxeHwRPm
zE*v(q{kr_pw+(lt`p(FIaJzL{f=~YUv*LqU_s{PV)P10vH1*iUZEGKNH>pNBgeP6C
z`gU3B7V{I;S>LxbNZtCrhHrlN)$Xte>D6l=e|fs7@Feqxs?*QDEpNQ8|Cc%O`hTZ;
zO7oU|Tw3UAvtjpc?koE7n^skYZZJDkI_L1yzq$`ByJc3rj&=U}Dj~P?x=MTYn@Yw_
nm3&v<ge$W$IQahOG+@~O-jLB-_+$~V8e{Nu^>bP0l+XkKQ$y19

literal 1790
zcmeAS@N?(olHy`uVBq!ia0y~yVAKI&4mO}jWo=(6kYXuz@(kesf*OvL4j`Yiz$3Dl
zfuSoCgc&!cZZ-l6N|v}rlmzFem6RtIr81P4m+NKbWfvzW7NqLs7p2dBXCuYHz*g<)
z;uumf=k4A7tLHzJJpS=@U%Q^;lq8`REs1Vt*Di})Qy*!>{$cNuEPZjQZ|Q>zOIgI7
zg{(Rr32^l;;PdKMh*jAv*3}gI=8E36_`_EfrHoXUyU&X`|NKYQ!N~XL|F#~U{dvyA
z-yw`Z_aK2c2VT9~zFeQNKw|ao>R&<(?S)Cdm>AksBOG`RG9__{2{><PkZ58(BA}zt
zmcVGp!rh@rjMU?VUreE2>q2AYZtYvYD(=RMH=jel9&}6JoS(kxRk`%szeS;YcU-)=
z{c}ZVtkkV_t7=(Z%V)3c7CwCUZ$Pg28uRN>aSOlMUb)+UrR?CZlC`C|i#O-5-0ko8
z=H3})MKaw4^-09tyNAnvtXgF!eakK|^m|Upx8Qx3|NeeC`+dp(-(PI|7TfM=dBlGI
z55t{F?oK3m8e35HfJ|GwYM0TL+EuISEVuBwe>^{{TKW9SRli<dC<}e793j7MYn`#-
zoxA;06DB@=74>>&=fih(yH>69%c(z2kzcESbUpdK`}fR+Z`s?+9<J~!|1Ru&o1g#f
zy$!o|FV`>hvE6#D3K->gD)0XFIJ;NlQN(8t4pQS8hnJtdULX4P(uHrfp{1D_(tVHo
zLrW7gelJ|L%VJAx=x>f|$FtXJ1LL|jElGS|v;VcI_dY!3-;;%Rn^WY3V{-eHe(u<{
zfA@L6_$ERAoQiKV-_<1@{+$2xxbtrFHSgX%w62K^{VxlQ_v`U4j4U^tH!$!W{ZCc`
zNA>u(53|;9U-jzl!nc=0zpm~*w=W>H{^pCEZ*SMFssbk6`1Pyy=azhXYZDXtylvb1
z*OmL_{=Bij`Jvd>`s>aaSMRb*|BJJ=|FN@f+r#HpBK<9t<-O$6a{u^8Gpx2>+htSB
z`EJiUyA`X}FMnSs^OKv%+>7ctlspg0*a!YU?Oye(Cgb;lRqufLyRb2Hec07v=iB>N
ztg`3JJskL_Ztd6Gpj5nR)xFs_{#}!6`ua5L^?gw0zIjBiz~o;$$>j;cMc_z&_s-6G
zOKnw#c;Bm>^8Y}WTwHipI;{Nr7uCL%#o235U!MNp-0OGEtA17ek~=<;3fUM`7`}OE
z8oxf|>d%F5<wLK|Z{PM%BX0dF^R{jNVOQnbwyn;RKltl<)azSE3d;YdgVJ?2v_Ly7
z#W#&oCu{^|Sw@*#&qKc+z3^?-s_OP_>*F0ZG>FJ?HWFPt7Y2mB_lajhD*ZuBg=7C2
W_DSW-ri94#fcT!SelF{r5}E)j7sRRn

diff --git a/data/interfaces/default/images/libraries/movie.svg b/data/interfaces/default/images/libraries/movie.svg
index 6e1f1cf5..a1c47720 100644
--- a/data/interfaces/default/images/libraries/movie.svg
+++ b/data/interfaces/default/images/libraries/movie.svg
@@ -1,5 +1,17 @@
-<!-- Generated by IcoMoon.io -->
-<svg version="1.1" xmlns="http://www.w3.org/2000/svg" width="32" height="32" viewBox="0 0 32 32">
-<title>movie</title>
-<path fill="#fff" d="M0 1.416c10.695 0 21.315 0 32 0 0 9.719 0 19.417 0 29.168-10.635 0-21.293 0-32 0 0-9.699 0-19.399 0-29.168zM9.202 15.129c4.535 0 9.065 0 13.609 0 0-3.798 0-7.579 0-11.355-4.563 0-9.075 0-13.609 0 0 3.801 0 7.551 0 11.355zM9.215 28.909c4.581 0 9.093 0 13.61 0 0-3.818 0-7.585 0-11.382-4.549 0-9.062 0-13.61 0 0 3.803 0 7.57 0 11.382zM6.813 5.983c0-0.753 0-1.467 0-2.209-1.138 0-2.235 0-3.33 0 0 0.766 0 1.48 0 2.209 1.131 0 2.21 0 3.33 0zM25.231 3.754c0 0.783 0 1.494 0 2.219 1.141 0 2.235 0 3.33 0 0-0.763 0-1.476 0-2.219-1.12 0-2.198 0-3.33 0zM25.233 12.938c0 0.777 0 1.492 0 2.19 1.149 0 2.248 0 3.335 0 0-0.754 0-1.452 0-2.19-1.116 0-2.197 0-3.335 0zM25.227 22.074c0 0.783 0 1.496 0 2.218 1.139 0 2.235 0 3.335 0 0-0.758 0-1.471 0-2.218-1.119 0-2.196 0-3.335 0zM3.472 26.689c0 0.768 0 1.481 0 2.221 1.133 0 2.226 0 3.34 0 0-0.763 0-1.475 0-2.221-1.119 0-2.197 0-3.34 0zM28.579 26.711c-1.112 0-2.225 0-3.353 0 0 0.749 0 1.462 0 2.202 1.137 0 2.233 0 3.353 0 0-0.748 0-1.447 0-2.202zM6.817 15.155c0-0.774 0-1.468 0-2.21-1.133 0-2.229 0-3.338 0 0 0.761 0 1.473 0 2.21 1.127 0 2.207 0 3.338 0zM3.463 19.73c1.165 0 2.242 0 3.346 0 0-0.759 0-1.469 0-2.189-1.143 0-2.239 0-3.346 0 0 0.748 0 1.446 0 2.189zM28.559 19.733c0-0.764 0-1.479 0-2.188-1.144 0-2.241 0-3.34 0 0 0.752 0 1.448 0 2.188 1.114 0 2.195 0 3.34 0zM6.791 24.304c0-0.798 0-1.511 0-2.215-1.145 0-2.225 0-3.312 0 0 0.766 0 1.481 0 2.215 1.129 0 2.211 0 3.312 0zM3.489 8.378c0 0.771 0 1.464 0 2.145 1.138 0 2.219 0 3.319 0 0-0.74 0-1.431 0-2.145-1.129 0-2.211 0-3.319 0zM28.554 10.538c0-0.775 0-1.464 0-2.137-1.146 0-2.242 0-3.319 0 0 0.747 0 1.438 0 2.137 1.131 0 2.21 0 3.319 0z"></path>
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Generator: Adobe Illustrator 16.0.0, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px" width="32px"
+	 height="32px" viewBox="0 0 32 32" enable-background="new 0 0 32 32" xml:space="preserve">
+<g id="Layer_1">
+	<title>artist</title>
+</g>
+<g id="Layer_2">
+	<path fill="#FFFFFF" d="M29.508,0.241H2.492c-1.242,0-2.251,1.008-2.251,2.251v27.015c0,1.242,1.009,2.252,2.251,2.252h27.016
+		c1.242,0,2.251-1.01,2.251-2.252V2.493C31.759,1.25,30.75,0.241,29.508,0.241z M4.744,29.508H2.492v-3.002h2.252V29.508z
+		 M4.744,24.255H2.492v-3.753h2.252V24.255z M4.744,18.252H2.492V14.5h2.252V18.252z M4.744,12.248H2.492V8.496h2.252V12.248z
+		 M4.744,6.245H2.492V2.493h2.252V6.245z M25.005,29.508H6.995V16.75h18.01V29.508z M25.005,14.5H6.995V2.493h18.01V14.5z
+		 M29.508,29.508h-2.252v-3.002h2.252V29.508z M29.508,24.255h-2.252v-3.753h2.252V24.255z M29.508,18.252h-2.252V14.5h2.252V18.252
+		z M29.508,12.248h-2.252V8.496h2.252V12.248z M29.508,6.245h-2.252V2.493h2.252V6.245z"/>
+</g>
 </svg>
diff --git a/data/interfaces/default/images/libraries/photo.png b/data/interfaces/default/images/libraries/photo.png
index b9e48a85af46c61595dc8ea2330e77535b8aa7b8..31170f1ec4e40f2efa494e92f41fd926d30cd05d 100644
GIT binary patch
literal 4602
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
I#&;tA53>r%*8l(j

literal 5436
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
a_Vd113Bx7d_`pji$aDW8?Dc)&XZ{a5F5xo(

diff --git a/data/interfaces/default/images/libraries/photo.svg b/data/interfaces/default/images/libraries/photo.svg
index 2ceadc5d..6fdc16b9 100644
--- a/data/interfaces/default/images/libraries/photo.svg
+++ b/data/interfaces/default/images/libraries/photo.svg
@@ -1,6 +1,25 @@
-<!-- Generated by IcoMoon.io -->
-<svg version="1.1" xmlns="http://www.w3.org/2000/svg" width="32" height="32" viewBox="0 0 32 32">
-<title>photo</title>
-<path fill="#fff" d="M25.208 2.266c0 1.514 0 2.976 0 4.513 2.281 0 4.505 0 6.792 0 0 7.681 0 15.287 0 22.955-10.643 0-21.3 0-32 0 0-7.626 0-15.236 0-22.913 2.258 0 4.486 0 6.792 0 0-1.546 0-3.029 0-4.555 6.152 0 12.226 0 18.415 0zM16.008 9.209c-5.026-0.004-9.12 4.079-9.123 9.099-0.004 4.961 4.099 9.069 9.074 9.085 5.022 0.016 9.124-4.047 9.159-9.070 0.035-4.985-4.087-9.109-9.109-9.114z"></path>
-<path fill="#fff" d="M20.601 18.292c0.003 2.551-2.070 4.626-4.61 4.613-2.558-0.013-4.595-2.069-4.591-4.634 0.003-2.524 2.038-4.557 4.577-4.572 2.562-0.015 4.621 2.030 4.624 4.593z"></path>
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Generator: Adobe Illustrator 16.0.0, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px" width="32px"
+	 height="32px" viewBox="0 0 32 32" enable-background="new 0 0 32 32" xml:space="preserve">
+<g id="Layer_2">
+</g>
+<g id="Layer_3">
+	<g>
+		<path fill="#FFFFFF" d="M30.807,8.975c-0.587-0.596-1.388-0.933-2.224-0.934h-5.158l-0.855-2.599
+			c-0.207-0.633-0.607-1.184-1.145-1.577c-0.536-0.389-1.18-0.6-1.84-0.6h-7.171c-0.661,0-1.306,0.211-1.84,0.602
+			C10.037,4.259,9.637,4.811,9.43,5.442L8.573,8.041H3.416C2.579,8.042,1.779,8.379,1.192,8.975c-0.591,0.6-0.923,1.408-0.923,2.25
+			V25.55c0,0.843,0.332,1.65,0.923,2.25c0.587,0.596,1.387,0.932,2.224,0.934h25.167c0.836-0.002,1.637-0.338,2.224-0.934
+			c0.591-0.6,0.923-1.407,0.923-2.25V11.225C31.729,10.383,31.397,9.574,30.807,8.975z M29.482,25.55
+			c0,0.258-0.103,0.497-0.273,0.672c-0.165,0.168-0.391,0.265-0.627,0.266H3.418c-0.237-0.001-0.462-0.098-0.628-0.266
+			c-0.176-0.181-0.274-0.422-0.273-0.674v-14.32c0-0.258,0.103-0.499,0.273-0.673c0.172-0.173,0.396-0.266,0.627-0.267h6.782
+			l1.365-4.144c0.063-0.189,0.181-0.351,0.334-0.463c0.152-0.11,0.332-0.169,0.514-0.169h7.175c0.182,0,0.361,0.059,0.514,0.169
+			c0.153,0.112,0.271,0.273,0.335,0.463l1.363,4.144h6.783c0.23,0,0.456,0.094,0.627,0.267c0.171,0.174,0.272,0.413,0.273,0.671
+			V25.55z"/>
+		<path fill="#FFFFFF" d="M16,10.7c-3.764,0-6.813,3.049-6.813,6.812c0,3.765,3.05,6.815,6.813,6.815
+			c3.763,0,6.813-3.051,6.813-6.815C22.813,13.749,19.763,10.7,16,10.7z M15.999,22.082c-2.523,0-4.568-2.045-4.568-4.568
+			s2.045-4.569,4.568-4.569c2.524,0,4.569,2.046,4.569,4.569S18.523,22.082,15.999,22.082z"/>
+	</g>
+</g>
 </svg>
diff --git a/data/interfaces/default/images/libraries/playlist.png b/data/interfaces/default/images/libraries/playlist.png
index c52df8a12c1ca66f65d4fff54a5766ac41ecce06..6b8a5dadb2bda6781c22bb86174e31121e59bdbb 100644
GIT binary patch
literal 875
zcmeAS@N?(olHy`uVBq!ia0y~yVAKI&4mO}jWo=(6kdiEMjVKAuPb(=;EJ|f?Ovz75
zRq)JBOiv9;O-!jQJeg|4z`)Gw>EaktaqG?9gSn3l1RMf;A2P)>c@=Pasd{opH%{i-
z#=3lxhU^ZOsSo&OTy*T1a8&MO!?EfHgBE=jwj=wiB!Kqd1224X+JjDI_jy14Jx?j=
zU1j3V<^3{~mouN;lWKm=j+cEmLzQAgLjog*m_h_Y6RQG*4HN*efdU+2*d;HVD=d%u
zG+X<Ad40p&yEf7pSsR(~xdV^f58I8hUYf~$8$Z=<@7VEu&xSjfEsvkP+?Y1)&9P6$
z5$i4Wrs~(7>VAH%`Rl~wPi+fkZhv#^*7Ao5;tu*O+yXib2boy79X2pP*#bIXHjp^T
zgkAEM<-2pm&A+Fy-?&*_H-8?ViE%U|9_Qhc`ZMna-_j|X$3uSZ%XZPR)z|s{Wm58&
zk_9s@cN?y6fBf#aY1s5z;?K92?A!C4Es_0S?(u>R><h%9!Ac;A(Zc`joBtlAGOzwS
zzR*>A2ePW<T;V66RZG9yCx8+i8K7a_(K3ytd!AIRtGPeFW5-ue(BGFy_h+9~c|I@Z
z`r*Rwk7wKu`T6KFv(EcF3H}GRpMP7hftyVC6L8;$_;@BB2E|-21D-8gCxR4vy85}S
Ib4q9e0O<(!^Z)<=

literal 1115
zcmeAS@N?(olHy`uVBq!ia0y~yVAKI&4mO}jWo=(6kYXuz@(kesf*OvL4j`Yiz$3Dl
zfuSoCgc&!cZZ-l6N|v}rlmzFem6RtIr81P4m+NKbWfvzW7NqLs7p2dBXCuYHz<k5g
z#WAE}&f6<%yVj*jv^{(+xo?rM*k#@($MQo8Cq#J5y00b~a=dHwjPyLV&EPk)8E+Gt
z;AFOgX)*^}52jS!X)Slyu`{kenfqLc8qiLx;7WA$`|FeT*vJ+g2+v;oez|hrt?K<#
zp6q<dXE8Bf-!snh)4P(BjNd)8+NM64tCH{UexUPCjITI@OlpJ!?_s7a39*2~8yckA
zSg#o9ENDw)H09x5kw_h>9V$N+Pu?v#!MNXt-R8n$mHECv%m3KQV)X|;L6wuYs_SPw
zx%qMeb6sq9t%+>mk$b<bPKsZaEin3?{r<1X$+JK|#;@O+2lW1pYJ0Cw*Gt&voOvI9
znU%p^l6D@1hM1n`KA$36U<91M%*g-2f70%k92PU}moww@5;nO8mB{M%-<K)#RqeX=
zE5+(j$KLOsJ@b}ZKghXuuiD>T=F9D<*GFG=D1W<`uky2I7xTGiSyl`WG-w-%KtCQ+
z1;*kL$L}EDxlhVpri{(;_{AR7=e*rJU!}6v>PbWY^{Dqi-)#L}r+soZFbajL*Opd$
z7R`N<w(D6#`Z8v@7p*Gm{oD_DzERmZYaN5dDH<hDc<kBvetHZ{rS`tSR9fz7H>0m%
i@{P-kxIFa7{U56(yYJIm?Gx-lYCK*2T-G@yGywo8*=_s)

diff --git a/data/interfaces/default/images/libraries/playlist.svg b/data/interfaces/default/images/libraries/playlist.svg
index 661793dd..7fc2d88f 100644
--- a/data/interfaces/default/images/libraries/playlist.svg
+++ b/data/interfaces/default/images/libraries/playlist.svg
@@ -1,12 +1,9 @@
-<!-- Generated by IcoMoon.io -->
-<svg version="1.1" xmlns="http://www.w3.org/2000/svg" width="32" height="32" viewBox="0 0 32 32">
-<title>playlist</title>
-<path fill="#fff" d="M9.167 10.268c7.653 0 15.208 0 22.82 0 0 1.147 0 2.268 0 3.451-7.583 0-15.172 0-22.82 0 0-1.134 0-2.274 0-3.451z"></path>
-<path fill="#fff" d="M9.14 21.73c0-1.152 0-2.257 0-3.424 7.609 0 15.212 0 22.86 0 0 1.132 0 2.252 0 3.424-7.607 0-15.191 0-22.86 0z"></path>
-<path fill="#fff" d="M9.217 5.679c0-1.145 0-2.23 0-3.363 7.562 0 15.101 0 22.683 0 0 1.113 0 2.213 0 3.363-7.539 0-15.080 0-22.683 0z"></path>
-<path fill="#fff" d="M9.225 29.708c0-1.132 0-2.214 0-3.336 7.558 0 15.086 0 22.668 0 0 1.086 0 2.186 0 3.336-7.526 0-15.071 0-22.668 0z"></path>
-<path fill="#fff" d="M0.007 10.279c1.58 0 3.043 0 4.551 0 0 1.153 0 2.272 0 3.444-1.511 0-3.011 0-4.551 0 0-1.157 0-2.292 0-3.444z"></path>
-<path fill="#fff" d="M4.527 2.292c0 1.183 0 2.284 0 3.424-1.496 0-2.957 0-4.479 0 0-1.142 0-2.276 0-3.424 1.51 0 2.971 0 4.479 0z"></path>
-<path fill="#fff" d="M4.571 18.3c0 1.151 0 2.254 0 3.416-1.515 0-3.019 0-4.571 0 0-1.127 0-2.247 0-3.416 1.513 0 3.001 0 4.571 0z"></path>
-<path fill="#fff" d="M4.54 26.352c0 1.137 0 2.218 0 3.354-1.494 0-2.975 0-4.506 0 0-1.094 0-2.192 0-3.354 1.489 0 2.965 0 4.506 0z"></path>
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Generator: Adobe Illustrator 16.0.0, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" id="Layer_4" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+	 width="32px" height="32px" viewBox="0 0 32 32" enable-background="new 0 0 32 32" xml:space="preserve">
+<path fill="#FFFFFF" d="M0.27,2.892h2.621v2.622H0.27V2.892z M31.729,2.892H8.135v2.622h23.595V2.892z M31.729,10.757H8.135v2.622
+	h23.595V10.757z M8.135,18.622h23.595v2.621H8.135V18.622z M31.729,26.487H8.135v2.621h23.595V26.487z M2.891,10.757H0.27v2.622
+	h2.621V10.757z M0.27,18.622h2.621v2.621H0.27V18.622z M2.891,26.487H0.27v2.621h2.621V26.487z"/>
 </svg>
diff --git a/data/interfaces/default/images/libraries/show.png b/data/interfaces/default/images/libraries/show.png
index 6b54f49bcc98d772034a8a19c58b1bcf681509e1..5ba8a9cec7a94d5850e923bb6fcd447933ea77e5 100644
GIT binary patch
literal 1374
zcmeAS@N?(olHy`uVBq!ia0y~yVAKI&4mO}jWo=(6kdiEMjVKAuPb(=;EJ|f?Ovz75
zRq)JBOiv9;O-!jQJeg|4z`)Aj>EaktaqG?9-asiwiH5|!jSNAK8<^KB1USBNc<G>B
z5Y)MZIk+*M^-|-KrV9t3M#o4r)h}rBu9!EIw{L~<&yssLZS^)@WdhoV0v_0h?0r6Y
z_Oh49ob|75k8rPK)RB5xD!qE$s;oU%6I@rEd-TxcI9Gyf>6-b1>mIr_PjxPpT%G;w
zfc4V3*ZNBjZ4KJ+>EioSeOxy#^kr{275EXTXN_Oc8mnhqIVV)yU;jFL@Ra)j?aeIP
zQa)S~+$f}-5WXn1Q*?v&#Z~h<LU&Dnwe0CE(GQiEOxM=AWPgd;@GdHkfz|H5MpNmY
zAAR3~)|@-arEw%M@6u!0Fq?^e4d45k91`6RAHI?4JFPt8c@nG0vdOo<WVBB$3y=NG
z$YtCod+lLO`_y<z5$y#ockitDIq}04pN6KndTguH<s1$!>s|F};s!(h1u3B!=g+k<
zsCuvUa(CKp#ISq8Wi#f4aG9JB+5E|W&5~|d$0yHy8@1t5y;1z{dk5<>XD!>lGQm=a
z$=Z1X!$Bqi9fu7JEZjf>#0C;zHVZeHO^l>~jxt61p*B<KiV<bXy;lj%@xPa4N(r;Q
z0mYj}*wlX+bM7`=N)}DCUbC@~fmK>xjx+l+16P<n+v{sK4Nbn%rn}p&cDCE6F^RnL
z4h^0Bl23cDAiuLQBbUjU-l`jkPh-Q(<=&lT(>RmJl0E0%jQj0V?<Y=Yow9AW)OqWz
zKYZ?`-aYzihVX}zmkd8t7)JcR^K#z&9R}(P7{t3bR*9^US-WttV!(mG4}tBgp4(aV
zwZF`$NXa`etyd}RxWDbkOZIi|miwDnC(Pb>>TTv)(KR*qo$r4XxN*(Uz%;$={MB97
zYcjVa@ka5BKT?0jnd6Y<z3YHog=W}gwY9%QKkM>`Z>)O8T{FSzTEfq(2h87Ym{u13
zIO1=O&ziH673nK3eO$jkYt6M=iME>`TXlZDyN)};Flc{L?0Vsq{G8W>8NDxhm7mxx
z$~41s{ja6j5B*Y6N(}@@I_&LlhEMwEU;GSAV88PF-)R}XKRiCkrI|c$ytaJ%sek|5
mUv|=R3c_qC>xO<ks|3TLIr~BrPu9!<33|HvxvX<aXaWE)g6_ot

literal 1177
zcmeAS@N?(olHy`uVBq!ia0y~yVAKI&4mO}jWo=(6kYXuz@(kesf*OvL4j`Yiz$3Dl
zfuSoCgc&!cZZ-l6N|v}rlmzFem6RtIr81P4m+NKbWfvzW7NqLs7p2dBXCnnPNX*m4
zF{EP7+q)Zcr#OnZT{O=SR#Lg#Sj?ogkp0#IrWhvG0A|xj7Z(p__8;fd)_<GBweN+O
z{>+(-Knsw-4(9Cle`~5(4v1#I-|OGcu;bC)my8VIoMICcBOKZi7$uunQ#feAIrjET
z!_1$?#_@jr4EMem8PE6U+tHrzH#YmPl`Yec{d>Q^e#z_Sq~N@vf#)ET5exST0i99K
zunL2`<?Lt9{NDTh{AJ|^^I9w0gtvRYzZ7H$x8Q6X8d3h(%-DaqJ5pXkWqwe&_L6b=
z+r9hGp1FS6`azR?_S*N$-RG28+dkm4IeX^wOTmJJhwD#1R}LjMVITf%R9!!3CjavC
j1FZY6N3F-O+-6Vx$wH-14_G%J0lCG~)z4*}Q$iB}zu;uH

diff --git a/data/interfaces/default/images/libraries/show.svg b/data/interfaces/default/images/libraries/show.svg
index f4b6a4a0..6e11dc77 100644
--- a/data/interfaces/default/images/libraries/show.svg
+++ b/data/interfaces/default/images/libraries/show.svg
@@ -1,6 +1,12 @@
-<!-- Generated by IcoMoon.io -->
-<svg version="1.1" xmlns="http://www.w3.org/2000/svg" width="32" height="32" viewBox="0 0 32 32">
-<title>show</title>
-<path fill="#fff" d="M0 26.565c0-8.38 0-16.706 0-25.089 10.661 0 21.307 0 32 0 0 8.343 0 16.686 0 25.089-10.637 0-21.283 0-32 0zM3.514 4.937c0 5.355 0 10.634 0 15.901 8.375 0 16.691 0 24.994 0 0-5.331 0-10.612 0-15.901-8.356 0-16.656 0-24.994 0z"></path>
-<path fill="#fff" d="M6.874 30.524c0-0.553 0-1.056 0-1.602 6.084 0 12.136 0 18.25 0 0 0.509 0 1.029 0 1.602-6.050 0-12.12 0-18.25 0z"></path>
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Generator: Adobe Illustrator 16.0.0, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+	 width="32px" height="32px" viewBox="0 0 32 32" enable-background="new 0 0 32 32" xml:space="preserve">
+<title>artist</title>
+<g>
+	<path fill="#FFFFFF" d="M2.359,1.602h27.281c1.255,0,2.273,1.018,2.273,2.273v19.703c0,1.256-1.019,2.273-2.273,2.273H2.359
+		c-1.255,0-2.273-1.018-2.273-2.273V3.875C0.086,2.62,1.104,1.602,2.359,1.602z M2.359,23.578h27.281V3.875H2.359V23.578z"/>
+	<path fill="#FFFFFF" d="M25.094,30.398v-2.273H6.906v2.273H25.094z"/>
+</g>
 </svg>
diff --git a/data/interfaces/default/images/libraries/video.png b/data/interfaces/default/images/libraries/video.png
index d73aa7f935988c832a225ab9de7ba1d24160be6b..647310c3e54f8cad46b85d2514d434ec74881ce0 100644
GIT binary patch
literal 2712
zcma)8e>~IqA0KBmTU^rSN94y!hvmmb=T=UBg>rW)n~xDgYDZ?=7Wt9g5<=r1QlgVi
znrzr4xzUgDbve459~mV-W-hfAh84@W&!@-t|GPgvpV#a2dA**`*X#BCydUrP=VH)z
zetJk#Bn$@A3-I?j3WI6kpbN19d~-IF%>a!F-4~!AOFT(WiAs)zd7em&j<pO(h&mN}
zG&btQ*`z;W_rqXFe1MN<aO#V<W0#I>3ovC$CC|0^Cfx>RCoHW2du?wWduu25V>j&*
zt<ySz8z@*OtKy#;J{ljt<5sNN<1w~Je9X1x0co2o>0Nqc7N#>77L@lnRm&29vET>{
zldOfneDW=UPd<2K!T)3M-xJ#^TvkLx?vTsF(-BTCVkPPJ@E<3d==+c;V&Suy<%Lu2
zC#|~>GD4SPE_Lh))4gq{$p-s_@*NLxQ!3wElUYh((eQoahF$luCFCxkCMfgL@Ws)M
ziNZUbu~Tw;Ko!ggvCuHz4P17;KO?sSoQWLe-=bi6dRt+?kg*MqyaN10K^x!%+WmIc
zfGWLidl%BQ<P7Np)q9`lkO0ppsB(Ujs3&fJC#9{Y?II3G!!I4?l-{6vpEo3G-d~7h
zv--*x-C_w;?>&YRFJ2WPa*VaX1~-T<YdTcU|E2&<pDGBWt!6Vq{7{sTwEcftP&<=E
zq~CT<0%e+?om%2vojJf+{VIjRXU&j2hu7X=5SYsyku-Ay9Fv!MdPUY~G4gp$1^$9r
z<GIEeh2zJtSq)vXq&m-i<-UxKwp_otGAC>OnDX=XTK?Y=x3W^C{)i=$y3qE45b^4!
zQH$E*wK4HhjACY97t{AH*fe50Oej8r*Nmia>WirMeYD!6^x2N2qS`})l0n5+l5#%N
zCZ^P;`u6s<vmuUe;3$eq@GjM`HRm|t*qmcnR_95PwrRl-ud?n%Dy<`u1$RMn75w$+
z%tqVzMa6YE%56vRpnBU7UAYu2($;4W`BJEYhenC<urqo?>bA9|_r>2EV)%!7CvQIJ
z5|Xtpb;<F~Z9vKn9kxCJ`Ajeed=;ft|3q%R)C_rTIdvbpgu1Aaoy5DvqUhs%<^%{h
z(F6g;Q3PZ#v4CNSnJ4lbymBCqZ&JrIQrO_g=G@Tk41oi1z`20o=VhEyd$cM)lvlwg
zw+l$w9T+ghII=eXI1hy>v?tzGBT~O?o~XcDZL%j$boNGTPUJoEFvM)a26LnzCiKU%
z;Y-`OzV3uy^fe#iI#|ixuH8^qIY!*jjFr+*9(9VK3)beo#3;l{{Ea}H5O(%seDK!}
zk~tZ}Bu4etAHj<$9gTK}%k6UF#tFPYpg5~GIh^OHxD)qW<%k1{6L}}C9;NUm=mPE*
z+!yx59|RA(UmrX4<RN{Pt6trqgIYiiy*5&e0z&U^1Wlkep6_oq0Y<nltciEY;GjXw
zK{cYR0EbbGjzoE8C70I?L~D-yCD?+qZ0izYt>&-bAYmr&H3J^@wnT9L83S77$A+G4
z_*MbP<3vE;1y#*f+EE464px#~GGvtIS~EN6>H+~L{Vqod9QC_1K`&Y`>yPN%Tl-0Y
zcp4=8rbUFCg&gAQbbbwfRuS!XoybvQu6r}18dAOLbTtVwFR_yug>80*n9H%v1q=~O
z#$cFj(?pN`ytxN)1>$2HVHdVWR+3hC;=pRAs_Gi-<k^OaA3{N_t>U)SwijFjRfNTy
z+jbCM!r`qu{9d%YxflF`GAa^7H>e-o`pakRT#SMRf8fK-cRZz3w|KV>G{~PuYf{H^
z;kkbH?`|{<-Xqn2CsW`eb~UoIO5IDzo>V0%XLej~&L8m~_qI>F;+Qfpg~CkqvI2_J
zZymjkQL48zzPVzNvMuu5^0{nwcHfMT%DAy{G@8)n@3D97`rPbwvgfcsSR3Oyw#adq
z5@+&aa><^%N`}PPZ+z4%pDSg!m*0w5En}|p&I7ZG^g_w;2OGWlRmwMUNspar6=J0t
z?J@gw42`3_h}@m=v_zdpv2q0ZM(C~yslv2By(0Kk&Kz@%DQ1BM_tlBd^l2^z7fJqw
zcCzOY+%z1O9|NWbZAG0Gv8LF0)e+q&%;i(f&|@;EzJE8E(X+P>%3e8m7epHWWso!v
zMWalXKyGr`pv2M$r0#TW1(QU4y*QB0iH)7IgbK=ztU^f{gG2#@0T&Szjp%}C%?t`c
z!D34@UssE3@}LS?SCn}17vawx!DyPxwZOXN1>1-ZCYhw?4&WPgk>tnrS4xY<FUwn+
z!a?M;VMB#Ful4Ecys{y%ie)2Zw~T>VSK3s6Z(jlNRZ4|Os0+9+_y4vRlB1Od)!mA&
z?}rNYpoS^X0I>(TNE3%?*^vC!P9TWdoE+X=!DrS>dlJBwA4@2Iw}R7?<6D!%Krr8x
zMCeY00&V@K)6j?`QqyOUUG6u13fcWqyK~U24HUx7Nl2OHUkPuaK)ckA3I%2<=zAbz
zRT&u6Qcwt1i;z>%-;)N>hDm!MsUD~IlN_fX>0*KowKgbzPz3OqTYe>UU3E!N388j|
zDfLDRS8sA4=*JvIOJxf_5^Rs=-&~0g?+yWXV}k}o->lc#Z{s(>{ocR1u5a9HEf;Im
zM{j-sbaRS+!~zGxq(Z$vcTdmQX0zbUCiOO$g{u{9_9E>U`ooNoEUO#m-iEs0fs3?-
zg+z4YQg?apgqh)0Rj|r7Q%{!e@j9mW#@w5@duj7eeuo8)v8p>tZElZ_oG*EHVOWs%
zfD0bFZ%QgwWZH6CjT0evEyK^N%D6(5mb|a(n3(z#+0%9{3H5&eQR-R|VfxB}Q-4jQ
zH5#;SR5(1$I1^T-k&z3Bz#~%X*D;-VUk9HwhcWYrs=05qigZl$gPCny{Dm+7;Qvy%
zyRWVWaCM5h*7TT8c$$6BIaWi9uR@msu5M8Yfutho`lDAH-NH>b43r=$U*^9$?|R9x
zh@I0{wsZiWwQuAgUrwpfRd_Z}Qm)Rq%P!`y2!8RH$XOqh{uy)(L$;T`8CQZS<K-iX
z=Jh3M1LeOZ%!hq1jXiabZeM<Pagi@il$BJ9Gtm1npS1)$d9+6$PwGgEc|rQ0;_&=y
z0HIpH$a$o-`YHi+4Xz-x4-A^G@rv@Nx<;%C7p~@RcsZvIPfpt;;ii78pnTg^pyg+0
zuBtR&fu#;_ybs%qgNd|tPzU%h9n>d(GwzcQ-bC8}G5D{E%rT80QwtV2zGtB~OP2@!
PYQh41zw>GEBD4MhmH6d5

literal 2356
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
B6yX2>

diff --git a/data/interfaces/default/images/libraries/video.svg b/data/interfaces/default/images/libraries/video.svg
index 4cee59b9..46f78428 100644
--- a/data/interfaces/default/images/libraries/video.svg
+++ b/data/interfaces/default/images/libraries/video.svg
@@ -1,5 +1,13 @@
-<!-- Generated by IcoMoon.io -->
-<svg version="1.1" xmlns="http://www.w3.org/2000/svg" width="32" height="32" viewBox="0 0 32 32">
-<title>video</title>
-<path fill="#fff" d="M20.662 27.439c-6.971 0-13.797 0-20.662 0 0-7.639 0-15.235 0-22.878 6.846 0 13.672 0 20.588 0 0 2.962 0 5.932 0 9.091 3.87-2.316 7.591-4.542 11.412-6.828 0 6.153 0 12.176 0 18.33-3.769-2.257-7.494-4.488-11.338-6.789 0 3.070 0 6.035 0 9.075z"></path>
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Generator: Adobe Illustrator 16.0.0, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+	 width="32px" height="32px" viewBox="0 0 32 32" enable-background="new 0 0 32 32" xml:space="preserve">
+<title>artist</title>
+<path fill="#FFFFFF" d="M21.619,27.237H2.515c-1.241,0-2.247-1.006-2.247-2.247V7.011c0-1.242,1.006-2.248,2.247-2.248h19.104
+	c1.24,0,2.247,1.006,2.247,2.248v4.562l6.091-4.349c0.506-0.36,1.207-0.242,1.568,0.263c0.134,0.19,0.206,0.415,0.207,0.647v15.732
+	c-0.002,0.621-0.509,1.123-1.128,1.119c-0.232-0.001-0.458-0.075-0.647-0.209l-6.091-4.349v4.563
+	C23.866,26.231,22.859,27.237,21.619,27.237z M2.515,7.011V24.99h19.104v-6.742c0.003-0.621,0.509-1.122,1.129-1.118
+	c0.231,0,0.457,0.074,0.646,0.208l6.091,4.349V10.314l-6.091,4.349c-0.506,0.36-1.207,0.242-1.568-0.263
+	c-0.133-0.189-0.206-0.415-0.207-0.647V7.011H2.515z"/>
 </svg>

From d4def8e5ae881ceb45e70e532e5a472c6609804f Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 5 Jun 2022 08:55:55 -0700
Subject: [PATCH 126/743] Fix cover size on info page

---
 data/interfaces/default/info.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/data/interfaces/default/info.html b/data/interfaces/default/info.html
index 0b69d508..6d8b3aaf 100644
--- a/data/interfaces/default/info.html
+++ b/data/interfaces/default/info.html
@@ -213,7 +213,7 @@ DOCUMENTATION :: END
                             <span class="overlay-refresh-image" title="Refresh image"><i class="fa fa-refresh refresh_pms_image"></i></span>
                             % endif
                             % elif data['media_type'] in ('artist', 'album', 'track', 'playlist', 'photo_album', 'photo', 'clip'):
-                            <div class="summary-poster-face-track" style="background-image: url(${page('pms_image_proxy', data['thumb'], data['rating_key'], 500, 500, fallback='cover')});">
+                            <div class="summary-poster-face-track" style="background-image: url(${page('pms_image_proxy', data['thumb'], data['rating_key'], 300, 300, fallback='cover')});">
                                 <div class="summary-poster-face-overlay">
                                     <span></span>
                                 </div>

From 98433a7c54fbd17852a11b8ae729e8fb573e7176 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 5 Jun 2022 11:56:51 -0700
Subject: [PATCH 127/743] Fix username not showing on home stats cards

---
 plexpy/datafactory.py | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/plexpy/datafactory.py b/plexpy/datafactory.py
index 031c125c..6147c453 100644
--- a/plexpy/datafactory.py
+++ b/plexpy/datafactory.py
@@ -732,7 +732,8 @@ class DataFactory(object):
                 try:
                     query = 'SELECT sh.user, sh.user_id, u.thumb AS user_thumb, u.custom_avatar_url AS custom_thumb, ' \
                             'sh.started, ' \
-                            '(CASE WHEN u.friendly_name IS NULL THEN u.username ELSE u.friendly_name END) ' \
+                            '(CASE WHEN u.friendly_name IS NULL OR TRIM(u.friendly_name) = ""' \
+                            '   THEN u.username ELSE u.friendly_name END) ' \
                             '   AS friendly_name, ' \
                             'MAX(sh.started) AS last_watch, COUNT(sh.id) AS total_plays, SUM(sh.d) AS total_duration ' \
                             'FROM (SELECT *, SUM(CASE WHEN stopped > 0 THEN (stopped - started) - ' \
@@ -837,7 +838,8 @@ class DataFactory(object):
                             'sh.rating_key, shm.grandparent_rating_key, shm.thumb, shm.grandparent_thumb, ' \
                             'sh.user, sh.user_id, u.custom_avatar_url as user_thumb, sh.player, sh.section_id, ' \
                             'shm.art, sh.media_type, shm.content_rating, shm.labels, shm.live, shm.guid, ' \
-                            '(CASE WHEN u.friendly_name IS NULL THEN u.username ELSE u.friendly_name END) ' \
+                            '(CASE WHEN u.friendly_name IS NULL OR TRIM(u.friendly_name) = ""' \
+                            '   THEN u.username ELSE u.friendly_name END) ' \
                             '   AS friendly_name, ' \
                             'MAX(sh.started) AS last_watch, ' \
                             '((CASE WHEN sh.view_offset IS NULL THEN 0.1 ELSE sh.view_offset * 1.0 END) / ' \

From 285fa3a0f53dbd1efc13b995dbe6a8f162b05f52 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 9 Jun 2022 12:43:52 -0700
Subject: [PATCH 128/743] Clear user friendly name if equal to username

---
 plexpy/__init__.py | 8 ++++++++
 plexpy/users.py    | 4 ++++
 2 files changed, 12 insertions(+)

diff --git a/plexpy/__init__.py b/plexpy/__init__.py
index de453c0a..67c9138d 100644
--- a/plexpy/__init__.py
+++ b/plexpy/__init__.py
@@ -1920,6 +1920,14 @@ def dbcheck():
             'ALTER TABLE users ADD COLUMN title TEXT'
         )
 
+    try:
+        result = c_db.execute('SELECT * FROM users WHERE friendly_name = username').fetchall()
+        if result:
+            logger.debug("Altering database. Resetting user friendly names equal to username.")
+            c_db.execute('UPDATE users SET friendly_name = NULL WHERE friendly_name = username')
+    except sqlite3.OperationalError:
+       pass
+
     # Upgrade notify_log table from earlier versions
     try:
         c_db.execute('SELECT poster_url FROM notify_log')
diff --git a/plexpy/users.py b/plexpy/users.py
index 33ff543c..2c988050 100644
--- a/plexpy/users.py
+++ b/plexpy/users.py
@@ -361,6 +361,10 @@ class Users(object):
         if str(user_id).isdigit():
             monitor_db = database.MonitorDatabase()
 
+            user = monitor_db.select_single('SELECT username FROM users WHERE user_id = ?', [user_id])
+            if user.get('username') == friendly_name:
+                friendly_name = None
+
             key_dict = {'user_id': user_id}
             value_dict = {'friendly_name': friendly_name,
                           'custom_avatar_url': custom_thumb,

From d482177342629a1b78262929749d1f653603b8f3 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 10 Jun 2022 20:02:35 -0700
Subject: [PATCH 129/743] Update Python version in readme

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 93301401..fa35aab8 100644
--- a/README.md
+++ b/README.md
@@ -36,7 +36,7 @@ and [PlexWatchWeb](https://github.com/ecleese/plexWatchWeb).
 [![Docker Stars][badge-docker-stars]][DockerHub]
 [![Downloads][badge-downloads]][Releases Latest]
 
-[badge-python]: https://img.shields.io/badge/python->=3.6-blue?style=flat-square
+[badge-python]: https://img.shields.io/badge/python->=3.7-blue?style=flat-square
 [badge-docker-pulls]: https://img.shields.io/docker/pulls/tautulli/tautulli?style=flat-square
 [badge-docker-stars]: https://img.shields.io/docker/stars/tautulli/tautulli?style=flat-square
 [badge-downloads]: https://img.shields.io/github/downloads/Tautulli/Tautulli/total?style=flat-square

From ec99a2f3d985f65af7b4ac28cd7e381eccb72cd9 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 14 Jun 2022 10:29:09 -0700
Subject: [PATCH 130/743] Fix updating cron default value in newsletter table

---
 plexpy/__init__.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/plexpy/__init__.py b/plexpy/__init__.py
index 67c9138d..861ff8fc 100644
--- a/plexpy/__init__.py
+++ b/plexpy/__init__.py
@@ -2047,7 +2047,7 @@ def dbcheck():
     # Upgrade newsletters table from earlier versions
     try:
         result = c_db.execute('SELECT SQL FROM sqlite_master WHERE type="table" AND name="newsletters"').fetchone()
-        if '"cron"\tTEXT NOT NULL DEFAULT "0 0 * * 0"' in result[0]:
+        if 'TEXT NOT NULL DEFAULT "0 0 * * 0"' in result[0]:
             logger.debug("Altering database. Updating default cron value in newsletters table.")
             c_db.execute(
                 'CREATE TABLE newsletters_temp (id INTEGER PRIMARY KEY AUTOINCREMENT, '

From 746d44922e1061040e43f1279cb9f1367ef330cd Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 3 Jul 2022 15:32:18 -0700
Subject: [PATCH 131/743] v2.10.2

---
 CHANGELOG.md      | 10 ++++++++++
 plexpy/version.py |  2 +-
 2 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 54ed38b5..64a1c5f9 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,15 @@
 # Changelog
 
+## v2.10.2 (2022-07-03)
+
+* Activity:
+  * Fix: Incorrect audio stream info shown on the activity card when playing a secondary audio track.
+* UI:
+  * Fix: Usernames not showing on the home statistics cards.
+  * Fix: Do not save a user's friendly name if it is the same as the username.
+  * Change: Update library icons to the latest Plex style.
+
+
 ## v2.10.1 (2022-06-01)
 
 * Notifications:
diff --git a/plexpy/version.py b/plexpy/version.py
index b5c1abb8..906f1534 100644
--- a/plexpy/version.py
+++ b/plexpy/version.py
@@ -18,4 +18,4 @@
 from __future__ import unicode_literals
 
 PLEXPY_BRANCH = "master"
-PLEXPY_RELEASE_VERSION = "v2.10.1"
+PLEXPY_RELEASE_VERSION = "v2.10.2"

From 22070ea54938b70e1ddc288dc826ca2c756280ca Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sun, 3 Jul 2022 15:40:24 -0700
Subject: [PATCH 132/743] Bump technote-space/workflow-conclusion-action from
 2.2 to 3.0 (#1758)

Bumps [technote-space/workflow-conclusion-action](https://github.com/technote-space/workflow-conclusion-action) from 2.2 to 3.0.
- [Release notes](https://github.com/technote-space/workflow-conclusion-action/releases)
- [Changelog](https://github.com/technote-space/workflow-conclusion-action/blob/main/.releasegarc)
- [Commits](https://github.com/technote-space/workflow-conclusion-action/compare/v2.2...v3.0)

---
updated-dependencies:
- dependency-name: technote-space/workflow-conclusion-action
  dependency-type: direct:production
  update-type: version-update:semver-major
...

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

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

[skip ci]
---
 .github/workflows/publish-docker.yml     | 2 +-
 .github/workflows/publish-installers.yml | 4 ++--
 .github/workflows/publish-snap.yml       | 2 +-
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/publish-docker.yml b/.github/workflows/publish-docker.yml
index 64747d4c..65c9e879 100644
--- a/.github/workflows/publish-docker.yml
+++ b/.github/workflows/publish-docker.yml
@@ -94,7 +94,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Get Build Job Status
-        uses: technote-space/workflow-conclusion-action@v2.2
+        uses: technote-space/workflow-conclusion-action@v3.0
 
       - name: Combine Job Status
         id: status
diff --git a/.github/workflows/publish-installers.yml b/.github/workflows/publish-installers.yml
index bb100a2e..1f408793 100644
--- a/.github/workflows/publish-installers.yml
+++ b/.github/workflows/publish-installers.yml
@@ -104,7 +104,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Get Build Job Status
-        uses: technote-space/workflow-conclusion-action@v2.2
+        uses: technote-space/workflow-conclusion-action@v3.0
 
       - name: Checkout Code
         uses: actions/checkout@v3.0.2
@@ -168,7 +168,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Get Build Job Status
-        uses: technote-space/workflow-conclusion-action@v2.2
+        uses: technote-space/workflow-conclusion-action@v3.0
 
       - name: Combine Job Status
         id: status
diff --git a/.github/workflows/publish-snap.yml b/.github/workflows/publish-snap.yml
index 1d365996..df3c3475 100644
--- a/.github/workflows/publish-snap.yml
+++ b/.github/workflows/publish-snap.yml
@@ -73,7 +73,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Get Build Job Status
-        uses: technote-space/workflow-conclusion-action@v2.2
+        uses: technote-space/workflow-conclusion-action@v3.0
 
       - name: Combine Job Status
         id: status

From 7f15c00f7ef81bb1fb47ea0decdb12dcc2de4ea6 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sun, 3 Jul 2022 15:40:36 -0700
Subject: [PATCH 133/743] Bump actions/cache from 3.0.3 to 3.0.4 (#1759)

Bumps [actions/cache](https://github.com/actions/cache) from 3.0.3 to 3.0.4.
- [Release notes](https://github.com/actions/cache/releases)
- [Changelog](https://github.com/actions/cache/blob/main/RELEASES.md)
- [Commits](https://github.com/actions/cache/compare/v3.0.3...v3.0.4)

---
updated-dependencies:
- dependency-name: actions/cache
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

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

[skip ci]
---
 .github/workflows/publish-docker.yml     | 2 +-
 .github/workflows/publish-installers.yml | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/publish-docker.yml b/.github/workflows/publish-docker.yml
index 65c9e879..f66c5307 100644
--- a/.github/workflows/publish-docker.yml
+++ b/.github/workflows/publish-docker.yml
@@ -46,7 +46,7 @@ jobs:
           version: latest
 
       - name: Cache Docker Layers
-        uses: actions/cache@v3.0.3
+        uses: actions/cache@v3.0.4
         with:
           path: /tmp/.buildx-cache
           key: ${{ runner.os }}-buildx-${{ github.sha }}
diff --git a/.github/workflows/publish-installers.yml b/.github/workflows/publish-installers.yml
index 1f408793..3200eb74 100644
--- a/.github/workflows/publish-installers.yml
+++ b/.github/workflows/publish-installers.yml
@@ -56,7 +56,7 @@ jobs:
           python-version: 3.9
 
       - name: Cache Dependencies
-        uses: actions/cache@v3.0.3
+        uses: actions/cache@v3.0.4
         with:
           path: ~\AppData\Local\pip\Cache
           key: ${{ runner.os }}-pip-${{ hashFiles('package/requirements-package.txt') }}

From 167a914e206688d5fac9c4ef2290e93a20c5b066 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sun, 3 Jul 2022 15:40:56 -0700
Subject: [PATCH 134/743] Bump joncloud/makensis-action from 3.6 to 3.7 (#1775)

Bumps [joncloud/makensis-action](https://github.com/joncloud/makensis-action) from 3.6 to 3.7.
- [Release notes](https://github.com/joncloud/makensis-action/releases)
- [Commits](https://github.com/joncloud/makensis-action/compare/v3.6...v3.7)

---
updated-dependencies:
- dependency-name: joncloud/makensis-action
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

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

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

[skip ci]
---
 .github/workflows/publish-installers.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/publish-installers.yml b/.github/workflows/publish-installers.yml
index 3200eb74..b51568ef 100644
--- a/.github/workflows/publish-installers.yml
+++ b/.github/workflows/publish-installers.yml
@@ -72,7 +72,7 @@ jobs:
           pyinstaller -y ./package/Tautulli-${{ matrix.os }}.spec
 
       - name: Create Windows Installer
-        uses: joncloud/makensis-action@v3.6
+        uses: joncloud/makensis-action@v3.7
         if: matrix.os == 'windows'
         with:
           script-file: ./package/Tautulli.nsi

From 03938ebf2cd6108d44935e72e9132b41ea0859b1 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sun, 3 Jul 2022 15:41:07 -0700
Subject: [PATCH 135/743] Bump actions/setup-python from 3.1.2 to 4.0.0 (#1760)

Bumps [actions/setup-python](https://github.com/actions/setup-python) from 3.1.2 to 4.0.0.
- [Release notes](https://github.com/actions/setup-python/releases)
- [Commits](https://github.com/actions/setup-python/compare/v3.1.2...v4.0.0)

---
updated-dependencies:
- dependency-name: actions/setup-python
  dependency-type: direct:production
  update-type: version-update:semver-major
...

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

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 .github/workflows/publish-installers.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/publish-installers.yml b/.github/workflows/publish-installers.yml
index b51568ef..3a8d4f2d 100644
--- a/.github/workflows/publish-installers.yml
+++ b/.github/workflows/publish-installers.yml
@@ -51,7 +51,7 @@ jobs:
           echo $GITHUB_SHA > version.txt
 
       - name: Set Up Python
-        uses: actions/setup-python@v3.1.2
+        uses: actions/setup-python@v4.0.0
         with:
           python-version: 3.9
 

From 8cbf93fda4be6023ae7b81fdb67cc5c142b9632e Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 14 Jul 2022 12:14:16 -0700
Subject: [PATCH 136/743] Bump actions/setup-python from 4.0.0 to 4.1.0 (#1788)

Bumps [actions/setup-python](https://github.com/actions/setup-python) from 4.0.0 to 4.1.0.
- [Release notes](https://github.com/actions/setup-python/releases)
- [Commits](https://github.com/actions/setup-python/compare/v4.0.0...v4.1.0)

---
updated-dependencies:
- dependency-name: actions/setup-python
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

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

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

[skip ci]
---
 .github/workflows/publish-installers.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/publish-installers.yml b/.github/workflows/publish-installers.yml
index 3a8d4f2d..f7d929d7 100644
--- a/.github/workflows/publish-installers.yml
+++ b/.github/workflows/publish-installers.yml
@@ -51,7 +51,7 @@ jobs:
           echo $GITHUB_SHA > version.txt
 
       - name: Set Up Python
-        uses: actions/setup-python@v4.0.0
+        uses: actions/setup-python@v4.1.0
         with:
           python-version: 3.9
 

From 39afabf1b7e1cda9430d488d592daf1edcc0bc7b Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 14 Jul 2022 12:14:34 -0700
Subject: [PATCH 137/743] Bump actions/cache from 3.0.4 to 3.0.5 (#1792)

Bumps [actions/cache](https://github.com/actions/cache) from 3.0.4 to 3.0.5.
- [Release notes](https://github.com/actions/cache/releases)
- [Changelog](https://github.com/actions/cache/blob/main/RELEASES.md)
- [Commits](https://github.com/actions/cache/compare/v3.0.4...v3.0.5)

---
updated-dependencies:
- dependency-name: actions/cache
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

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

[skip ci]
---
 .github/workflows/publish-docker.yml     | 2 +-
 .github/workflows/publish-installers.yml | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/publish-docker.yml b/.github/workflows/publish-docker.yml
index f66c5307..f30eb60c 100644
--- a/.github/workflows/publish-docker.yml
+++ b/.github/workflows/publish-docker.yml
@@ -46,7 +46,7 @@ jobs:
           version: latest
 
       - name: Cache Docker Layers
-        uses: actions/cache@v3.0.4
+        uses: actions/cache@v3.0.5
         with:
           path: /tmp/.buildx-cache
           key: ${{ runner.os }}-buildx-${{ github.sha }}
diff --git a/.github/workflows/publish-installers.yml b/.github/workflows/publish-installers.yml
index f7d929d7..ff6fd120 100644
--- a/.github/workflows/publish-installers.yml
+++ b/.github/workflows/publish-installers.yml
@@ -56,7 +56,7 @@ jobs:
           python-version: 3.9
 
       - name: Cache Dependencies
-        uses: actions/cache@v3.0.4
+        uses: actions/cache@v3.0.5
         with:
           path: ~\AppData\Local\pip\Cache
           key: ${{ runner.os }}-pip-${{ hashFiles('package/requirements-package.txt') }}

From b6cb946ae23a2724e7bb15a7f917b9e8d41e0aa1 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 14 Jul 2022 12:29:12 -0700
Subject: [PATCH 138/743] Add json support for MQTT notifications

---
 plexpy/notification_handler.py | 14 ++++++++------
 plexpy/notifiers.py            | 28 ++++++++++++++++++++++------
 2 files changed, 30 insertions(+), 12 deletions(-)

diff --git a/plexpy/notification_handler.py b/plexpy/notification_handler.py
index 747a860f..97e0ba1a 100644
--- a/plexpy/notification_handler.py
+++ b/plexpy/notification_handler.py
@@ -402,7 +402,8 @@ def notify(notifier_id=None, notify_action=None, stream_data=None, timeline_data
                                                        body=body_string,
                                                        notify_action=notify_action,
                                                        parameters=parameters,
-                                                       agent_id=notifier_config['agent_id'])
+                                                       agent_id=notifier_config['agent_id'],
+                                                       as_json=notifier_config['config'].get('as_json', False))
 
     # Set the notification state in the db
     notification_id = set_notify_state(session=stream_data or timeline_data,
@@ -1259,7 +1260,7 @@ def build_server_notify_params(notify_action=None, **kwargs):
     return available_params
 
 
-def build_notify_text(subject='', body='', notify_action=None, parameters=None, agent_id=None, test=False):
+def build_notify_text(subject='', body='', notify_action=None, parameters=None, agent_id=None, test=False, as_json=False):
     # Default subject and body text
     if agent_id == 15:
         default_subject = default_body = ''
@@ -1320,21 +1321,22 @@ def build_notify_text(subject='', body='', notify_action=None, parameters=None,
             logger.exception("Tautulli NotificationHandler :: Unable to parse custom script arguments: %s. Using fallback." % e)
             script_args = []
 
-    elif agent_id == 25:
+    elif agent_id == 25 or as_json:
+        agent = 'MQTT' if agent_id == 23 else 'webhook'
         if subject:
             try:
                 subject = json.loads(subject)
             except ValueError as e:
-                logger.error("Tautulli NotificationHandler :: Unable to parse custom webhook json header data: %s. Using fallback." % e)
+                logger.error("Tautulli NotificationHandler :: Unable to parse custom %s json header data: %s. Using fallback." % (agent, e))
                 subject = ''
         if subject:
             try:
                 subject = json.dumps(helpers.traverse_map(subject, str_formatter))
             except LookupError as e:
-                logger.error("Tautulli NotificationHandler :: Unable to parse parameter %s in webhook header data. Using fallback." % e)
+                logger.error("Tautulli NotificationHandler :: Unable to parse parameter %s in %s header data. Using fallback." % (e, agent))
                 subject = ''
             except Exception as e:
-                logger.exception("Tautulli NotificationHandler :: Unable to parse custom webhook header data: %s. Using fallback." % e)
+                logger.exception("Tautulli NotificationHandler :: Unable to parse custom %s header data: %s. Using fallback." % (agent, e))
                 subject = ''
 
         if body:
diff --git a/plexpy/notifiers.py b/plexpy/notifiers.py
index 7c9627f0..b7ee4f17 100644
--- a/plexpy/notifiers.py
+++ b/plexpy/notifiers.py
@@ -2367,17 +2367,25 @@ class MQTT(Notifier):
                        'topic': '',
                        'qos': 1,
                        'retain': 0,
-                       'keep_alive': 60
+                       'keep_alive': 60,
+                       'as_json': 0
                        }
 
     def agent_notify(self, subject='', body='', action='', **kwargs):
-        if not self.config['topic']:
+        topic = self.config['topic']
+        if not topic:
             logger.error("Tautulli Notifiers :: MQTT topic not specified.")
             return
 
+        topic = topic.format(**kwargs.get('parameters', {}))
+
+        if self.config['as_json']:
+            subject = json.loads(subject)
+            body = json.loads(body)
+
         data = {'subject': subject,
                 'body': body,
-                'topic': self.config['topic']}
+                'topic': topic}
 
         auth = {}
         if self.config['username']:
@@ -2390,7 +2398,7 @@ class MQTT(Notifier):
         logger.info("Tautulli Notifiers :: Sending {name} notification...".format(name=self.NAME))
 
         paho.mqtt.publish.single(
-            self.config['topic'], payload=json.dumps(data), qos=self.config['qos'], retain=bool(self.config['retain']),
+            topic, payload=json.dumps(data), qos=self.config['qos'], retain=bool(self.config['retain']),
             hostname=self.config['broker'], port=self.config['port'], client_id=self.config['clientid'],
             keepalive=self.config['keep_alive'], auth=auth or None, protocol=protocol
         )
@@ -2443,7 +2451,9 @@ class MQTT(Notifier):
                          {'label': 'Topic',
                           'value': self.config['topic'],
                           'name': 'mqtt_topic',
-                          'description': 'The topic to publish notifications to.',
+                          'description': 'The topic to publish notifications to. You can include'
+                                         ' <a href="#notify-text-sub-modal" data-toggle="modal">notification parameters</a>'
+                                         ' to be substituted.',
                           'input_type': 'text'
                           },
                          {'label': 'Quality of Service',
@@ -2467,7 +2477,13 @@ class MQTT(Notifier):
                           'name': 'mqtt_keep_alive',
                           'description': 'Maximum period in seconds before timing out the connection with the broker.',
                           'input_type': 'number'
-                          }
+                          },
+                         {'label': 'Send Message as JSON',
+                          'value': self.config['as_json'],
+                          'name': 'mqtt_as_json',
+                          'description': 'Parse and send the subject and body as JSON instead of as a raw string.',
+                          'input_type': 'checkbox'
+                          },
                          ]
 
         return config_option

From b598e9fc0ca82407fd1d119d3261470ed1e3a08e Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 14 Jul 2022 16:14:10 -0700
Subject: [PATCH 139/743] Make sure token is saved before populating server
 dropdown list

---
 data/interfaces/default/settings.html | 2 +-
 data/interfaces/default/welcome.html  | 2 +-
 plexpy/plextv.py                      | 1 -
 3 files changed, 2 insertions(+), 3 deletions(-)

diff --git a/data/interfaces/default/settings.html b/data/interfaces/default/settings.html
index a6a95cb0..f7c24211 100644
--- a/data/interfaces/default/settings.html
+++ b/data/interfaces/default/settings.html
@@ -2757,10 +2757,10 @@ $(document).ready(function() {
     function OAuthSuccessCallback(authToken) {
         $.post('save_pms_token', { token: authToken, client_id: $('#pms_client_id').val() }, function() {
             showMsg('<i class="fa fa-check"></i> Saved new Plex.tv token.', false, true, 5000);
+            getServerOptions();
         });
         $("#pms-token-status").html('<i class="fa fa-check"></i>&nbsp; Authentication successful.').fadeIn('fast');
         $("#token_error_bar").hide();
-        getServerOptions(authToken);
     }
     function OAuthErrorCallback() {
         $("#pms-token-status").html('<i class="fa fa-exclamation-circle"></i>&nbsp; Error communicating with Plex.tv.').fadeIn('fast');
diff --git a/data/interfaces/default/welcome.html b/data/interfaces/default/welcome.html
index c1e043cc..e67deb49 100644
--- a/data/interfaces/default/welcome.html
+++ b/data/interfaces/default/welcome.html
@@ -541,10 +541,10 @@ $(document).ready(function() {
     function OAuthSuccessCallback(authToken) {
         $.post('save_pms_token', { token: authToken, client_id: $('#pms_client_id').val() }, function () {
             $("#pms_token_validated").val(1);
+            getServerOptions();
         });
         $("#pms-token-status").html('<i class="fa fa-check"></i>&nbsp; Authentication successful.').fadeIn('fast');
         authenticated = true;
-        getServerOptions(authToken);
     }
     function OAuthErrorCallback() {
         $("#pms-token-status").html('<i class="fa fa-exclamation-circle"></i>&nbsp; Error communicating with Plex.tv.').fadeIn('fast');
diff --git a/plexpy/plextv.py b/plexpy/plextv.py
index ebfa0bc6..1b596fc7 100644
--- a/plexpy/plextv.py
+++ b/plexpy/plextv.py
@@ -164,7 +164,6 @@ class PlexTV(object):
 
             if not self.token:
                 logger.error("Tautulli PlexTV :: PlexTV called, but no token provided.")
-                return
 
         self.request_handler = http_handler.HTTPHandler(urls=self.urls,
                                                         token=self.token,

From aeb572f211cabe262b7b50fb7956a0ff1e54bf2c Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 14 Jul 2022 18:39:59 -0700
Subject: [PATCH 140/743] Add parent_year and grandparent_year to
 get_metadata_details

---
 plexpy/pmsconnect.py | 21 +++++++++++++++++++++
 plexpy/webserve.py   |  2 ++
 2 files changed, 23 insertions(+)

diff --git a/plexpy/pmsconnect.py b/plexpy/pmsconnect.py
index b168683c..c20f4193 100644
--- a/plexpy/pmsconnect.py
+++ b/plexpy/pmsconnect.py
@@ -768,6 +768,8 @@ class PmsConnect(object):
                         'user_rating': helpers.get_xml_attr(metadata_main, 'userRating'),
                         'duration': helpers.get_xml_attr(metadata_main, 'duration'),
                         'year': helpers.get_xml_attr(metadata_main, 'year'),
+                        'parent_year': helpers.get_xml_attr(metadata_main, 'parentYear'),
+                        'grandparent_year': helpers.get_xml_attr(metadata_main, 'grandparentYear'),
                         'thumb': helpers.get_xml_attr(metadata_main, 'thumb'),
                         'parent_thumb': helpers.get_xml_attr(metadata_main, 'parentThumb'),
                         'grandparent_thumb': helpers.get_xml_attr(metadata_main, 'grandparentThumb'),
@@ -824,6 +826,8 @@ class PmsConnect(object):
                         'user_rating': helpers.get_xml_attr(metadata_main, 'userRating'),
                         'duration': duration,
                         'year': helpers.get_xml_attr(metadata_main, 'year'),
+                        'parent_year': helpers.get_xml_attr(metadata_main, 'parentYear'),
+                        'grandparent_year': helpers.get_xml_attr(metadata_main, 'grandparentYear'),
                         'thumb': helpers.get_xml_attr(metadata_main, 'thumb'),
                         'parent_thumb': helpers.get_xml_attr(metadata_main, 'parentThumb'),
                         'grandparent_thumb': helpers.get_xml_attr(metadata_main, 'grandparentThumb'),
@@ -883,6 +887,8 @@ class PmsConnect(object):
                         'user_rating': helpers.get_xml_attr(metadata_main, 'userRating'),
                         'duration': show_details.get('duration', ''),
                         'year': helpers.get_xml_attr(metadata_main, 'year'),
+                        'parent_year': show_details.get('year', ''),
+                        'grandparent_year': helpers.get_xml_attr(metadata_main, 'grandparentYear'),
                         'thumb': helpers.get_xml_attr(metadata_main, 'thumb'),
                         'parent_thumb': helpers.get_xml_attr(metadata_main, 'parentThumb'),
                         'grandparent_thumb': helpers.get_xml_attr(metadata_main, 'grandparentThumb'),
@@ -959,6 +965,8 @@ class PmsConnect(object):
                         'user_rating': helpers.get_xml_attr(metadata_main, 'userRating'),
                         'duration': helpers.get_xml_attr(metadata_main, 'duration'),
                         'year': helpers.get_xml_attr(metadata_main, 'year'),
+                        'parent_year': season_details.get('year', ''),
+                        'grandparent_year': show_details.get('year', ''),
                         'thumb': helpers.get_xml_attr(metadata_main, 'thumb'),
                         'parent_thumb': parent_thumb,
                         'grandparent_thumb': helpers.get_xml_attr(metadata_main, 'grandparentThumb'),
@@ -1011,6 +1019,8 @@ class PmsConnect(object):
                         'user_rating': helpers.get_xml_attr(metadata_main, 'userRating'),
                         'duration': helpers.get_xml_attr(metadata_main, 'duration'),
                         'year': helpers.get_xml_attr(metadata_main, 'year'),
+                        'parent_year': helpers.get_xml_attr(metadata_main, 'parentYear'),
+                        'grandparent_year': helpers.get_xml_attr(metadata_main, 'grandparentYear'),
                         'thumb': helpers.get_xml_attr(metadata_main, 'thumb'),
                         'parent_thumb': helpers.get_xml_attr(metadata_main, 'parentThumb'),
                         'grandparent_thumb': helpers.get_xml_attr(metadata_main, 'grandparentThumb'),
@@ -1064,6 +1074,8 @@ class PmsConnect(object):
                         'user_rating': helpers.get_xml_attr(metadata_main, 'userRating'),
                         'duration': helpers.get_xml_attr(metadata_main, 'duration'),
                         'year': helpers.get_xml_attr(metadata_main, 'year'),
+                        'parent_year': helpers.get_xml_attr(metadata_main, 'parentYear'),
+                        'grandparent_year': helpers.get_xml_attr(metadata_main, 'grandparentYear'),
                         'thumb': helpers.get_xml_attr(metadata_main, 'thumb'),
                         'parent_thumb': helpers.get_xml_attr(metadata_main, 'parentThumb'),
                         'grandparent_thumb': helpers.get_xml_attr(metadata_main, 'grandparentThumb'),
@@ -1120,6 +1132,8 @@ class PmsConnect(object):
                         'user_rating': helpers.get_xml_attr(metadata_main, 'userRating'),
                         'duration': helpers.get_xml_attr(metadata_main, 'duration'),
                         'year': album_details.get('year', ''),
+                        'parent_year': helpers.get_xml_attr(metadata_main, 'parentYear'),
+                        'grandparent_year': helpers.get_xml_attr(metadata_main, 'grandparentYear'),
                         'thumb': helpers.get_xml_attr(metadata_main, 'thumb'),
                         'parent_thumb': helpers.get_xml_attr(metadata_main, 'parentThumb'),
                         'grandparent_thumb': helpers.get_xml_attr(metadata_main, 'grandparentThumb'),
@@ -1172,6 +1186,8 @@ class PmsConnect(object):
                         'user_rating': helpers.get_xml_attr(metadata_main, 'userRating'),
                         'duration': helpers.get_xml_attr(metadata_main, 'duration'),
                         'year': helpers.get_xml_attr(metadata_main, 'year'),
+                        'parent_year': helpers.get_xml_attr(metadata_main, 'parentYear'),
+                        'grandparent_year': helpers.get_xml_attr(metadata_main, 'grandparentYear'),
                         'thumb': helpers.get_xml_attr(metadata_main, 'thumb'),
                         'parent_thumb': helpers.get_xml_attr(metadata_main, 'parentThumb'),
                         'grandparent_thumb': helpers.get_xml_attr(metadata_main, 'grandparentThumb'),
@@ -1225,6 +1241,8 @@ class PmsConnect(object):
                         'user_rating': helpers.get_xml_attr(metadata_main, 'userRating'),
                         'duration': helpers.get_xml_attr(metadata_main, 'duration'),
                         'year': helpers.get_xml_attr(metadata_main, 'year'),
+                        'parent_year': helpers.get_xml_attr(metadata_main, 'parentYear'),
+                        'grandparent_year': helpers.get_xml_attr(metadata_main, 'grandparentYear'),
                         'thumb': helpers.get_xml_attr(metadata_main, 'thumb'),
                         'parent_thumb': helpers.get_xml_attr(metadata_main, 'parentThumb'),
                         'grandparent_thumb': helpers.get_xml_attr(metadata_main, 'grandparentThumb'),
@@ -1278,6 +1296,8 @@ class PmsConnect(object):
                         'user_rating': helpers.get_xml_attr(metadata_main, 'userRating'),
                         'duration': helpers.get_xml_attr(metadata_main, 'duration'),
                         'year': helpers.get_xml_attr(metadata_main, 'year'),
+                        'parent_year': helpers.get_xml_attr(metadata_main, 'parentYear'),
+                        'grandparent_year': helpers.get_xml_attr(metadata_main, 'grandparentYear'),
                         'min_year': helpers.get_xml_attr(metadata_main, 'minYear'),
                         'max_year': helpers.get_xml_attr(metadata_main, 'maxYear'),
                         'thumb': helpers.get_xml_attr(metadata_main, 'thumb').split('?')[0],
@@ -1353,6 +1373,7 @@ class PmsConnect(object):
                         'user_rating': helpers.get_xml_attr(metadata_main, 'userRating'),
                         'duration': helpers.get_xml_attr(metadata_main, 'duration'),
                         'year': helpers.get_xml_attr(metadata_main, 'year'),
+                        'parent_year': helpers.get_xml_attr(metadata_main, 'parentYear'),
                         'thumb': helpers.get_xml_attr(metadata_main, 'thumb'),
                         'parent_thumb': helpers.get_xml_attr(metadata_main, 'parentThumb'),
                         'grandparent_thumb': helpers.get_xml_attr(metadata_main, 'grandparentThumb'),
diff --git a/plexpy/webserve.py b/plexpy/webserve.py
index b00991a2..bee64b9a 100644
--- a/plexpy/webserve.py
+++ b/plexpy/webserve.py
@@ -5321,6 +5321,7 @@ class WebInterface(object):
                      "grandparent_rating_key": "1219",
                      "grandparent_thumb": "/library/metadata/1219/thumb/1462175063",
                      "grandparent_title": "Game of Thrones",
+                     "grandparent_year": "2011",
                      "guid": "plex://episode/5d9c1276e9d5a1001f4ff2fa",
                      "guids": [
                          "imdb://tt3658014",
@@ -5424,6 +5425,7 @@ class WebInterface(object):
                      "parent_rating_key": "153036",
                      "parent_thumb": "/library/metadata/153036/thumb/1462175062",
                      "parent_title": "Season 6",
+                     "parent_year": "2016",
                      "rating": "",
                      "rating_image": "",
                      "rating_key": "153037",

From 9f1b7de623bdb98ac9ab53de6e99a278b8428a47 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 14 Jul 2022 18:45:00 -0700
Subject: [PATCH 141/743] Add show_year notification parameter

---
 plexpy/common.py               | 3 ++-
 plexpy/notification_handler.py | 6 ++++++
 2 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/plexpy/common.py b/plexpy/common.py
index 1312d98f..b89ef48a 100644
--- a/plexpy/common.py
+++ b/plexpy/common.py
@@ -491,7 +491,7 @@ NOTIFICATION_PARAMETERS = [
              {'name': 'Media Type', 'type': 'str', 'value': 'media_type', 'description': 'The type of media.', 'example': 'movie, show, season, episode, artist, album, track, clip'},
              {'name': 'Title', 'type': 'str', 'value': 'title', 'description': 'The full title of the item.'},
              {'name': 'Library Name', 'type': 'str', 'value': 'library_name', 'description': 'The library name of the item.'},
-             {'name': 'Show Name', 'type': 'str', 'value': 'show_name', 'description': 'The title of the TV series.'},
+             {'name': 'Show Name', 'type': 'str', 'value': 'show_name', 'description': 'The title of the TV show.'},
              {'name': 'Season Name', 'type': 'str', 'value': 'season_name', 'description': 'The title of the TV season.'},
              {'name': 'Episode Name', 'type': 'str', 'value': 'episode_name', 'description': 'The title of the TV episode.'},
              {'name': 'Artist Name', 'type': 'str', 'value': 'artist_name', 'description': 'The name of the artist.'},
@@ -511,6 +511,7 @@ NOTIFICATION_PARAMETERS = [
              {'name': 'Album Count', 'type': 'int', 'value': 'album_count', 'description': 'The number of albums in a grouped recently added notification.'},
              {'name': 'Track Count', 'type': 'int', 'value': 'track_count', 'description': 'The number of tracks in a grouped recently added notification.'},
              {'name': 'Year', 'type': 'int', 'value': 'year', 'description': 'The release year for the item.'},
+             {'name': 'Show Year', 'type': 'int', 'value': 'show_year', 'description': 'The release year of the TV show.'},
              {'name': 'Release Date', 'type': 'str', 'value': 'release_date', 'description': 'The release date (in date format) for the item.'},
              {'name': 'Air Date', 'type': 'str', 'value': 'air_date', 'description': 'The air date (in date format) for the item.'},
              {'name': 'Added Date', 'type': 'str', 'value': 'added_date', 'description': 'The date (in date format) the item was added to Plex.'},
diff --git a/plexpy/notification_handler.py b/plexpy/notification_handler.py
index 97e0ba1a..497973be 100644
--- a/plexpy/notification_handler.py
+++ b/plexpy/notification_handler.py
@@ -862,6 +862,8 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
         child_count = len(child_num)
         grandchild_count = ''
 
+        show_year = notify_params['year']
+
     elif ((manual_trigger or plexpy.CONFIG.NOTIFY_GROUP_RECENTLY_ADDED_PARENT)
           and notify_params['media_type'] in ('season', 'album')):
         show_name = notify_params['parent_title']
@@ -885,6 +887,8 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
         child_count = 1
         grandchild_count = len(grandchild_num)
 
+        show_year = notify_params['parent_year']
+
     else:
         show_name = notify_params['grandparent_title']
         season_name = notify_params['parent_title']
@@ -902,6 +906,7 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
         track_num00 = str(notify_params['media_index']).zfill(2)
         child_count = 1
         grandchild_count = 1
+        show_year = notify_params['grandparent_year']
 
     rating = notify_params['rating'] or notify_params['audience_rating']
 
@@ -1075,6 +1080,7 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
         'album_count': child_count,
         'track_count': grandchild_count,
         'year': notify_params['year'],
+        'show_year': show_year,
         'release_date': arrow.get(notify_params['originally_available_at']).format(date_format)
             if notify_params['originally_available_at'] else '',
         'air_date': arrow.get(notify_params['originally_available_at']).format(date_format)

From 6e6de11aaa25ff4a6a523620f4fc155014a191f2 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 18 Jul 2022 15:31:23 -0700
Subject: [PATCH 142/743] Cache usernames for log filter

* Fixes #1705
---
 plexpy/__init__.py |  2 ++
 plexpy/logger.py   | 27 +++++++++++++++------------
 plexpy/users.py    |  9 ++++++++-
 3 files changed, 25 insertions(+), 13 deletions(-)

diff --git a/plexpy/__init__.py b/plexpy/__init__.py
index 861ff8fc..b11f46d7 100644
--- a/plexpy/__init__.py
+++ b/plexpy/__init__.py
@@ -548,6 +548,8 @@ def start():
     global _STARTED
 
     if _INITIALIZED:
+        logger.filter_usernames()
+
         # Start refreshes on a separate thread
         threading.Thread(target=startup_refresh).start()
 
diff --git a/plexpy/logger.py b/plexpy/logger.py
index 5a1c0f0f..a1631610 100644
--- a/plexpy/logger.py
+++ b/plexpy/logger.py
@@ -46,6 +46,7 @@ MAX_SIZE = 5000000  # 5 MB
 MAX_FILES = 5
 
 _BLACKLIST_WORDS = set()
+_FILTER_USERNAMES = []
 
 # Tautulli logger
 logger = logging.getLogger("tautulli")
@@ -71,6 +72,19 @@ def blacklist_config(config):
     _BLACKLIST_WORDS.update(blacklist)
 
 
+def filter_usernames(new_users=None):
+    global _FILTER_USERNAMES
+
+    if new_users is None:
+        new_users = [user['username'] for user in users.Users().get_users()]
+
+    for username in new_users:
+        if username.lower() not in ('local', 'guest') and username not in _FILTER_USERNAMES:
+            _FILTER_USERNAMES.append(username)
+
+    _FILTER_USERNAMES = sorted(_FILTER_USERNAMES, key=len, reverse=True)
+
+
 class NoThreadFilter(logging.Filter):
     """
     Log filter for the current thread
@@ -126,18 +140,7 @@ class UsernameFilter(logging.Filter):
         if not plexpy._INITIALIZED:
             return True
 
-        items = sorted(
-            users.Users().get_users(),
-            key=lambda x: len(x['username']),
-            reverse=True
-        )
-
-        for item in items:
-            username = item['username']
-
-            if username.lower() in ('local', 'guest'):
-                continue
-
+        for username in _FILTER_USERNAMES:
             try:
                 record.msg = self.replace(record.msg, username)
 
diff --git a/plexpy/users.py b/plexpy/users.py
index 2c988050..5ec093ff 100644
--- a/plexpy/users.py
+++ b/plexpy/users.py
@@ -60,6 +60,7 @@ def refresh_users():
 
         # Keep track of user_id to update is_active status
         user_ids = [0]  # Local user always considered active
+        new_users = []
 
         for item in result:
             user_ids.append(helpers.cast_to_int(item['user_id']))
@@ -92,11 +93,17 @@ def refresh_users():
             if not item['username']:
                 item['username'] = item['title']
 
-            monitor_db.upsert('users', key_dict=keys_dict, value_dict=item)
+            result = monitor_db.upsert('users', key_dict=keys_dict, value_dict=item)
+
+            if result == 'insert':
+                new_users.append(item['username'])
 
         query = 'UPDATE users SET is_active = 0 WHERE user_id NOT IN ({})'.format(', '.join(['?'] * len(user_ids)))
         monitor_db.action(query=query, args=user_ids)
 
+        # Add new users to loger username filter
+        logger.filter_usernames(new_users)
+
         logger.info("Tautulli Users :: Users list refreshed.")
         return True
     else:

From 85eaed57e09e3c180f4c6948c70938d87177bcbc Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 18 Jul 2022 15:33:37 -0700
Subject: [PATCH 143/743] Clean up lookup table unique constraints on start up

---
 plexpy/__init__.py | 34 +++++++++++++++++++++++++---------
 1 file changed, 25 insertions(+), 9 deletions(-)

diff --git a/plexpy/__init__.py b/plexpy/__init__.py
index b11f46d7..6b10446b 100644
--- a/plexpy/__init__.py
+++ b/plexpy/__init__.py
@@ -2433,27 +2433,43 @@ def dbcheck():
             'ALTER TABLE exports ADD COLUMN total_items INTEGER DEFAULT 0'
         )
 
-    # Upgrade image_hash_lookup table from earlier versions
+    # Fix unique constraints
+    try:
+        c_db.execute('DELETE FROM tvmaze_lookup '
+                     'WHERE id NOT IN (SELECT MIN(id) FROM tvmaze_lookup GROUP BY rating_key)')
+    except sqlite3.OperationalError:
+        pass
+
+    try:
+        c_db.execute('DELETE FROM themoviedb_lookup '
+                     'WHERE id NOT IN (SELECT MIN(id) FROM themoviedb_lookup GROUP BY rating_key)')
+    except sqlite3.OperationalError:
+        pass
+
+    try:
+        c_db.execute('DELETE FROM musicbrainz_lookup '
+                     'WHERE id NOT IN (SELECT MIN(id) FROM musicbrainz_lookup GROUP BY rating_key)')
+    except sqlite3.OperationalError:
+        pass
+
     try:
         c_db.execute('DELETE FROM image_hash_lookup '
                      'WHERE id NOT IN (SELECT MIN(id) FROM image_hash_lookup GROUP BY img_hash)')
     except sqlite3.OperationalError:
         pass
 
-    # Upgrade imgur_lookup table from earlier versions
-    try:
-        c_db.execute('DELETE FROM imgur_lookup '
-                     'WHERE id NOT IN (SELECT MIN(id) FROM imgur_lookup GROUP BY img_hash)')
-    except sqlite3.OperationalError:
-        pass
-
-    # Upgrade cloudinary_lookup table from earlier versions
     try:
         c_db.execute('DELETE FROM cloudinary_lookup '
                      'WHERE id NOT IN (SELECT MIN(id) FROM cloudinary_lookup GROUP BY img_hash)')
     except sqlite3.OperationalError:
         pass
 
+    try:
+        c_db.execute('DELETE FROM imgur_lookup '
+                     'WHERE id NOT IN (SELECT MIN(id) FROM imgur_lookup GROUP BY img_hash)')
+    except sqlite3.OperationalError:
+        pass
+
     # Add "Local" user to database as default unauthenticated user.
     result = c_db.execute('SELECT id FROM users WHERE username = "Local"')
     if not result.fetchone():

From c45ded5a981e4667b1dc0d9f4a3a8a52e3e77c9b Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 24 Jul 2022 14:13:22 -0700
Subject: [PATCH 144/743] Implement X-Plex-Container-Size for retrieving
 library items

PMS 1.28 log warning
```
Missing X-Plex-Container-Size header. This will fail with status code 400 in the future.
```
---
 plexpy/pmsconnect.py | 128 +++++++++++++++++++++++++++++++------------
 1 file changed, 93 insertions(+), 35 deletions(-)

diff --git a/plexpy/pmsconnect.py b/plexpy/pmsconnect.py
index c20f4193..45597b18 100644
--- a/plexpy/pmsconnect.py
+++ b/plexpy/pmsconnect.py
@@ -147,7 +147,7 @@ class PmsConnect(object):
 
         return request
 
-    def get_metadata_children(self, rating_key='', section_id='', artist=False, collection=False, output_format=''):
+    def get_metadata_children(self, rating_key='', collection=False, output_format=''):
         """
         Return metadata for children of the request item.
 
@@ -156,14 +156,9 @@ class PmsConnect(object):
 
         Output: array
         """
-        if artist:
-            uri = '/library/sections/{}/all?artist.id={}&type=9'.format(
-                section_id, rating_key
-            )
-        else:
-            uri = '/library/{}/{}/children'.format(
-                'collections' if collection else 'metadata', rating_key
-            )
+        uri = '/library/{}/{}/children'.format(
+            'collections' if collection else 'metadata', rating_key
+        )
         request = self.request_handler.make_request(uri=uri,
                                                     request_type='GET',
                                                     output_format=output_format)
@@ -326,7 +321,8 @@ class PmsConnect(object):
 
         return request
 
-    def get_library_list(self, section_id='', list_type='all', count='0', sort_type='', label_key='', output_format=''):
+    def get_library_list(self, section_id='', list_type='all', start=0, count=0, sort_type='',
+                         label_key='', output_format=''):
         """
         Return list of items in library on server.
 
@@ -334,16 +330,51 @@ class PmsConnect(object):
 
         Output: array
         """
-        count = '&X-Plex-Container-Size=' + count if count else ''
+        start = 'X-Plex-Container-Start=' + str(start)
+        count = 'X-Plex-Container-Size=' + str(count)
         label_key = '&label=' + label_key if label_key else ''
 
-        uri = '/library/sections/' + section_id + '/' + list_type + '?X-Plex-Container-Start=0' + count + sort_type + label_key
+        uri = ('/library/sections/' + section_id + '/' + list_type + '?'
+               + start + '&' + count + sort_type + label_key)
         request = self.request_handler.make_request(uri=uri,
                                                     request_type='GET',
                                                     output_format=output_format)
 
         return request
 
+    def fetch_library_list(self, section_id='', list_type='all', count='', sort_type='',
+                           label_key='', output_format=''):
+        xml_head = []
+
+        start = 0
+        _count = int(count) if count else 100
+
+        while True:
+            library_data = self.get_library_list(
+                section_id=str(section_id),
+                list_type=list_type,
+                start=start,
+                count=_count,
+                sort_type=sort_type,
+                label_key=label_key,
+                output_format=output_format
+            )
+
+            try:
+                _xml_head = library_data.getElementsByTagName('MediaContainer')
+                library_count = int(helpers.get_xml_attr(_xml_head[0], 'totalSize'))
+                xml_head.extend(_xml_head)
+            except Exception as e:
+                logger.warn("Tautulli Pmsconnect :: Unable to parse XML for fetch_library_list: %s." % e)
+                return xml_head
+
+            start += _count
+
+            if count or start >= library_count:
+                break
+
+        return xml_head
+
     def get_library_labels(self, section_id='', output_format=''):
         """
         Return list of labels for a library on server.
@@ -2352,6 +2383,8 @@ class PmsConnect(object):
                           'children_list': []
                           }
 
+        xml_head = []
+
         if media_type == 'playlist':
             children_data = self.get_playlist_items(rating_key, output_format='xml')
         elif media_type == 'collection':
@@ -2361,15 +2394,21 @@ class PmsConnect(object):
         elif media_type == 'artist':
             artist_metadata = self.get_metadata_details(rating_key)
             section_id = artist_metadata['section_id']
-            children_data = self.get_metadata_children(rating_key, section_id, artist=True, output_format='xml')
+            sort_type = '&artist.id={}&type=9'.format(rating_key)
+            xml_head = self.fetch_library_list(
+                section_id=str(section_id),
+                sort_type=sort_type,
+                output_format='xml'
+            )
         else:
             children_data = self.get_metadata_children(rating_key, output_format='xml')
 
-        try:
-            xml_head = children_data.getElementsByTagName('MediaContainer')
-        except Exception as e:
-            logger.warn("Tautulli Pmsconnect :: Unable to parse XML for get_item_children: %s." % e)
-            return default_return
+        if not xml_head:
+            try:
+                xml_head = children_data.getElementsByTagName('MediaContainer')
+            except Exception as e:
+                logger.warn("Tautulli Pmsconnect :: Unable to parse XML for get_item_children: %s." % e)
+                return default_return
 
         children_list = []
 
@@ -2691,20 +2730,32 @@ class PmsConnect(object):
         else:
             sort_type = ''
 
-        if str(rating_key).isdigit():
-            _artist = section_type == 'album'
-            library_data = self.get_metadata_children(str(rating_key), str(section_id), artist=_artist, output_format='xml')
-        elif str(section_id).isdigit():
-            library_data = self.get_library_list(str(section_id), list_type, count, sort_type, label_key, output_format='xml')
+        if str(rating_key).isdigit() and section_type != 'album':
+            library_data = self.get_metadata_children(str(rating_key), output_format='xml')
+
+            try:
+                xml_head = library_data.getElementsByTagName('MediaContainer')
+            except Exception as e:
+                logger.warn("Tautulli Pmsconnect :: Unable to parse XML for get_library_children_details: %s." % e)
+                return []
+
+        elif str(section_id).isdigit() or section_type == 'album':
+            if section_type == 'album':
+                sort_type += '&artist.id=' + str(rating_key)
+
+            xml_head = self.fetch_library_list(
+                section_id=str(section_id),
+                list_type=list_type,
+                count=count,
+                sort_type=sort_type,
+                label_key=label_key,
+                output_format='xml'
+            )
+
         else:
             logger.warn("Tautulli Pmsconnect :: get_library_children called by invalid section_id or rating_key provided.")
             return []
 
-        try:
-            xml_head = library_data.getElementsByTagName('MediaContainer')
-        except Exception as e:
-            logger.warn("Tautulli Pmsconnect :: Unable to parse XML for get_library_children_details: %s." % e)
-            return []
 
         children_list = []
 
@@ -3055,14 +3106,21 @@ class PmsConnect(object):
 
 
         # get parent_rating_keys
-        _artist = media_type in ('artist', 'album', 'track')
-        metadata = self.get_metadata_children(str(rating_key), str(section_id), artist=_artist, output_format='xml')
+        if media_type in ('artist', 'album', 'track'):
+            sort_type = '&artist.id={}&type=9'.format(rating_key)
+            xml_head = self.fetch_library_list(
+                section_id=str(section_id),
+                sort_type=sort_type,
+                output_format='xml'
+            )
+        else:
+            metadata = self.get_metadata_children(str(rating_key), output_format='xml')
 
-        try:
-            xml_head = metadata.getElementsByTagName('MediaContainer')
-        except Exception as e:
-            logger.warn("Tautulli Pmsconnect :: Unable to parse XML for get_rating_keys_list: %s." % e)
-            return {}
+            try:
+                xml_head = metadata.getElementsByTagName('MediaContainer')
+            except Exception as e:
+                logger.warn("Tautulli Pmsconnect :: Unable to parse XML for get_rating_keys_list: %s." % e)
+                return {}
 
         for a in xml_head:
             if a.getAttribute('size'):

From 52e399144ad1a6df7774e27c55d6a0230a811738 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 29 Jul 2022 19:40:50 -0700
Subject: [PATCH 145/743] Add Stripe donation

---
 data/interfaces/default/base.html                |  12 ++++++++++++
 .../Stripe_wordmark_-_white_small_28px.png       | Bin 0 -> 1163 bytes
 2 files changed, 12 insertions(+)
 create mode 100644 data/interfaces/default/images/Stripe_wordmark_-_white_small_28px.png

diff --git a/data/interfaces/default/base.html b/data/interfaces/default/base.html
index 5e8d4447..94e9a360 100644
--- a/data/interfaces/default/base.html
+++ b/data/interfaces/default/base.html
@@ -236,6 +236,7 @@ ${next.modalIncludes()}
                 <ul id="donation_type" class="nav nav-pills" role="tablist" style="display: flex; justify-content: center; margin: 10px 0;">
                     <li class="active"><a href="#github-donation" role="tab" data-toggle="tab">GitHub</a></li>
                     <li><a href="#patreon-donation" role="tab" data-toggle="tab">Patreon</a></li>
+                    <li><a href="#stripe-donation" role="tab" data-toggle="tab">Stripe</a></li>
                     <li><a href="#paypal-donation" role="tab" data-toggle="tab">PayPal</a></li>
                     <li><a href="#crypto-donation" role="tab" data-toggle="tab">Crypto</a></li>
                 </ul>
@@ -262,6 +263,17 @@ ${next.modalIncludes()}
                         </p>
                         <p class="small-muted">(Patreon has a fee)</p>
                     </div>
+                    <div role="tabpanel" class="tab-pane" id="stripe-donation" style="text-align: center">
+                        <p>
+                            Click the button below to continue to Stripe.
+                        </p>
+                        <p>
+                            <a href="${anon_url('https://donate.stripe.com/5kA7vnb7dczVbxC9AA')}" target="_blank" rel="noreferrer">
+                                <img src="images/Stripe_wordmark_-_white_small_28px.png" alt="Stripe" style="background-color: #7068fe; border-radius: 3px; padding: 3px;">
+                            </a>
+                        </p>
+                        <p class="small-muted">(Stripe has a fee)</p>
+                    </div>
                     <div role="tabpanel" class="tab-pane" id="paypal-donation" style="text-align: center">
                         <p>
                             Click the button below to continue to PayPal.
diff --git a/data/interfaces/default/images/Stripe_wordmark_-_white_small_28px.png b/data/interfaces/default/images/Stripe_wordmark_-_white_small_28px.png
new file mode 100644
index 0000000000000000000000000000000000000000..960f32ee64596a7e63f6e7ec3be15fe380263cf4
GIT binary patch
literal 1163
zcmeAS@N?(olHy`uVBq!ia0vp^)<7)7!2%>pTlu#EDVB6cUq=Rpjs4tz5?O(Kg=CK)
zUj~LMH3o);76yi2K%s^gK-C5e46hOx7_4S6Fo+k-*%fF5lweBoc6VX;-`;;_Kaj^+
z;1OBOz#ygy!i=6lDj$G?>?NMQuI$g)<(Sl1_sR3RF)%RKdAc};cpQH_Ek5H~s>pHs
z^XKoMFF&R8_G-De_VSl!HcUFRCh~!6>B24CyHA`x*43gSsMIw<DddgPiC2r7{t4c7
zVF{YDBw^vY1v7a?H$OWg^lX_~sou8lcklU&|9kfAnRV)`xzEc#f2jU3?|t#PpYxtu
z7TjI8v-RS^Jx=T&HSV&X+S!^l>t;RgB*jM+>J}|mH||Sc%^Kc!F2AJnZ+k`e`pR!g
zJ9dT$o#^i~)0=wbN>(JV$)gE#<F;*>t5z22q}QjhutFlUPbzKlg>!aw-WNBoTsnEL
zj)Jqct<ID1x+iK~DKk#mJYWc}m|$18=;FQtzObW*?|8BAzL9R&6LIqQ-OPK%*WM+W
zuZY@`FxlHC>)>IzpzA+-S-G$M+{4QK?rY1c<Fz+?BzE5UD;8?|N=w*%#oOLB>4uz_
zxKkvjyGeI=avV7lVkq3v(b?H~>8i~p2A?!te}?Xgc5BW#3;Q$IJl{Am%etA>L41AT
zgh-ub+PbIA%s%U<b2Pkp$SxI8&?pmi^N8lW$9l&;^4#AzX{AWz{Qk<8t#=Mw&RM)X
zWYYVs&Tq@+UUgGTt8u>Ct8{K_?Ar})XLf{MtqNbg>!wG{v&gMyQ~#~p7MXl4>-$Rg
zIe}Iu+cOx9_8cm+Ti#Y9l`F#Ww@9bpmC~gt96wt3Hx@mc%&PW@)B464o&=$tmptvx
zO8IS?q7xi>Q0Nug9==DMi4}_(8M#ZC8w*_yM5OUQ^7OjQ_HRMoPn&bWKFcRnMg4yL
zeCfNgRvA%;dG#+Cttuy*F)6Xm^1d9lp^2?7U0E`YNy~!sfK1U7Nn@s5*3gnolV&%X
zNm)4c8U1@~yvt*T+nJ4*wmjYAA*owZ#LjSb3&VyfYfUzHCVAd!%~?3xlI1})-v`z2
z6F*p;&P-?8{#kQ9pI?N{o4h$C`%I&LH1NGzsrE4Mn6NOvQ_oI^NrIa%UCq0<bUOde
zc6H6ijg3lE`nL7*+MFsmW#OzWzfpQcI&bmIRQBUPrghF)Cake(^5z5aXS`2-+t8t8
z|JjV4d0vXB^~$GaN`4nkh(8oMe<xydnAJsvm(vZOrwBI#qmz;6n3|f~z6Gzs)8^z{
z^LX>UCH2{w4R;codfHD2ep=ac>6u7XhJU>X+uRN19rNw{coqbunBSfLktsIEg;Vuc
zYvZ|Bi>9iz`7tT?SudWm^c=hFjKd;)#dB&td@2n0s{R@iyM1-;f9BE$^Ro5|1eX9a
zr)r67L`h0wNvc(HQ7VvPFfuSQ(ls#GH8uz_FtReXure^!HZZU<Fle?syaYu<ZhlH;
YS|x4`pHiwNfEpM)UHx3vIVCg!0MwZJ6#xJL

literal 0
HcmV?d00001


From 2b339f60bc992497ac4a0b3343760316a59c1a5c Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 29 Jul 2022 20:04:08 -0700
Subject: [PATCH 146/743] Update PayPal URL

---
 data/interfaces/default/base.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/data/interfaces/default/base.html b/data/interfaces/default/base.html
index 94e9a360..19edb94b 100644
--- a/data/interfaces/default/base.html
+++ b/data/interfaces/default/base.html
@@ -279,7 +279,7 @@ ${next.modalIncludes()}
                             Click the button below to continue to PayPal.
                         </p>
                         <p>
-                            <a href="${anon_url('https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=6XPPKTDSX9QFL&lc=US&item_name=Tautulli&currency_code=USD&bn=PP%2dDonationsBF%3abtn_donate_LG%2egif%3aNonHosted')}" target="_blank" rel="noreferrer">
+                            <a href="${anon_url('https://www.paypal.com/donate/?hosted_button_id=CUHSQ99KAKC5Q')}" target="_blank" rel="noreferrer">
                                 <img src="images/gold-rect-paypal-34px.png" alt="PayPal">
                             </a>
                         </p>

From ddcf350353f54834b01dd8af0c77a3d92cb95b05 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 1 Aug 2022 14:46:32 -0700
Subject: [PATCH 147/743] Add last played metadata to home stats top_libraries
 and top_users

---
 plexpy/datafactory.py | 81 +++++++++++++++++++++++++++++++++----------
 1 file changed, 63 insertions(+), 18 deletions(-)

diff --git a/plexpy/datafactory.py b/plexpy/datafactory.py
index 6147c453..c87bcecd 100644
--- a/plexpy/datafactory.py
+++ b/plexpy/datafactory.py
@@ -667,7 +667,12 @@ class DataFactory(object):
             elif stat == 'top_libraries':
                 top_libraries = []
                 try:
-                    query = 'SELECT sh.section_id, ls.section_name, ls.section_type, ' \
+                    query = 'SELECT sh.id, shm.title, shm.grandparent_title, shm.full_title, shm.year, ' \
+                            'shm.media_index, shm.parent_media_index, ' \
+                            'sh.rating_key, shm.grandparent_rating_key, shm.thumb, shm.grandparent_thumb, ' \
+                            'sh.user, sh.user_id, sh.player, sh.section_id, ' \
+                            'shm.art, sh.media_type, shm.content_rating, shm.labels, shm.live, shm.guid, ' \
+                            'ls.section_name, ls.section_type, ' \
                             'ls.thumb AS library_thumb, ls.custom_thumb_url AS custom_thumb, ' \
                             'ls.art AS library_art, ls.custom_art_url AS custom_art, ' \
                             'sh.started, ' \
@@ -678,6 +683,7 @@ class DataFactory(object):
                             '   FROM session_history ' \
                             '   WHERE session_history.stopped >= %s ' \
                             '   GROUP BY %s) AS sh ' \
+                            'JOIN session_history_metadata AS shm ON shm.id = sh.id ' \
                             'LEFT OUTER JOIN (SELECT * FROM library_sections WHERE deleted_section = 0) ' \
                             '   AS ls ON sh.section_id = ls.section_id ' \
                             'GROUP BY sh.section_id ' \
@@ -701,6 +707,11 @@ class DataFactory(object):
                     else:
                         library_art = item['library_art']
 
+                    if not item['grandparent_thumb'] or item['grandparent_thumb'] == '':
+                        thumb = item['thumb']
+                    else:
+                        thumb = item['grandparent_thumb']
+
                     row = {
                         'total_plays': item['total_plays'],
                         'total_duration': item['total_duration'],
@@ -708,29 +719,46 @@ class DataFactory(object):
                         'section_name': item['section_name'],
                         'section_id': item['section_id'],
                         'last_play': item['last_watch'],
-                        'thumb': library_thumb,
-                        'grandparent_thumb': '',
-                        'art': library_art,
+                        'library_thumb': library_thumb,
+                        'library_art': library_art,
+                        'thumb': thumb,
+                        'grandparent_thumb': item['grandparent_thumb'],
+                        'art': item['art'],
                         'user': '',
                         'friendly_name': '',
                         'users_watched': '',
-                        'rating_key': '',
-                        'grandparent_rating_key': '',
-                        'title': '',
                         'platform': '',
-                        'row_id': ''
+                        'title': item['full_title'],
+                        'grandparent_title': item['grandparent_title'],
+                        'grandchild_title': item['title'],
+                        'year': item['year'],
+                        'media_index': item['media_index'],
+                        'parent_media_index': item['parent_media_index'],
+                        'rating_key': item['rating_key'],
+                        'grandparent_rating_key': item['grandparent_rating_key'],
+                        'media_type': item['media_type'],
+                        'content_rating': item['content_rating'],
+                        'labels': item['labels'].split(';') if item['labels'] else (),
+                        'live': item['live'],
+                        'guid': item['guid'],
+                        'row_id': item['id']
                     }
                     top_libraries.append(row)
 
                 home_stats.append({'stat_id': stat,
                                    'stat_type': sort_type,
                                    'stat_title': 'Most Active Libraries',
-                                   'rows': session.mask_session_info(top_libraries, mask_metadata=False)})
+                                   'rows': session.mask_session_info(top_libraries)})
 
             elif stat == 'top_users':
                 top_users = []
                 try:
-                    query = 'SELECT sh.user, sh.user_id, u.thumb AS user_thumb, u.custom_avatar_url AS custom_thumb, ' \
+                    query = 'SELECT sh.id, shm.title, shm.grandparent_title, shm.full_title, shm.year, ' \
+                            'shm.media_index, shm.parent_media_index, ' \
+                            'sh.rating_key, shm.grandparent_rating_key, shm.thumb, shm.grandparent_thumb, ' \
+                            'sh.user, sh.user_id, sh.player, sh.section_id, ' \
+                            'shm.art, sh.media_type, shm.content_rating, shm.labels, shm.live, shm.guid, ' \
+                            'u.thumb AS user_thumb, u.custom_avatar_url AS custom_thumb, ' \
                             'sh.started, ' \
                             '(CASE WHEN u.friendly_name IS NULL OR TRIM(u.friendly_name) = ""' \
                             '   THEN u.username ELSE u.friendly_name END) ' \
@@ -742,6 +770,7 @@ class DataFactory(object):
                             '   FROM session_history ' \
                             '   WHERE session_history.stopped >= %s ' \
                             '   GROUP BY %s) AS sh ' \
+                            'JOIN session_history_metadata AS shm ON shm.id = sh.id ' \
                             'LEFT OUTER JOIN users AS u ON sh.user_id = u.user_id ' \
                             'GROUP BY sh.user_id ' \
                             'ORDER BY %s DESC, sh.started DESC ' \
@@ -759,6 +788,11 @@ class DataFactory(object):
                     else:
                         user_thumb = common.DEFAULT_USER_THUMB
 
+                    if not item['grandparent_thumb'] or item['grandparent_thumb'] == '':
+                        thumb = item['thumb']
+                    else:
+                        thumb = item['grandparent_thumb']
+
                     row = {'user': item['user'],
                            'user_id': item['user_id'],
                            'friendly_name': item['friendly_name'],
@@ -766,21 +800,32 @@ class DataFactory(object):
                            'total_duration': item['total_duration'],
                            'last_play': item['last_watch'],
                            'user_thumb': user_thumb,
-                           'grandparent_thumb': '',
-                           'art': '',
+                           'thumb': thumb,
+                           'grandparent_thumb': item['grandparent_thumb'],
+                           'art': item['art'],
                            'users_watched': '',
-                           'rating_key': '',
-                           'grandparent_rating_key': '',
-                           'title': '',
                            'platform': '',
-                           'row_id': ''
-                    }
+                           'title': item['full_title'],
+                           'grandparent_title': item['grandparent_title'],
+                           'grandchild_title': item['title'],
+                           'year': item['year'],
+                           'media_index': item['media_index'],
+                           'parent_media_index': item['parent_media_index'],
+                           'rating_key': item['rating_key'],
+                           'grandparent_rating_key': item['grandparent_rating_key'],
+                           'media_type': item['media_type'],
+                           'content_rating': item['content_rating'],
+                           'labels': item['labels'].split(';') if item['labels'] else (),
+                           'live': item['live'],
+                           'guid': item['guid'],
+                           'row_id': item['id']
+                           }
                     top_users.append(row)
 
                 home_stats.append({'stat_id': stat,
                                    'stat_type': sort_type,
                                    'stat_title': 'Most Active Users',
-                                   'rows': session.mask_session_info(top_users, mask_metadata=False)})
+                                   'rows': session.mask_session_info(top_users)})
 
             elif stat == 'top_platforms':
                 top_platform = []

From 3631e723bc1a00b3afd77139686482dc918e7e04 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 1 Aug 2022 14:47:16 -0700
Subject: [PATCH 148/743] Add last played metadata to library stats

---
 plexpy/datafactory.py | 50 +++++++++++++++++++++++++++++++++++--------
 1 file changed, 41 insertions(+), 9 deletions(-)

diff --git a/plexpy/datafactory.py b/plexpy/datafactory.py
index c87bcecd..eb4c18ae 100644
--- a/plexpy/datafactory.py
+++ b/plexpy/datafactory.py
@@ -1038,12 +1038,21 @@ class DataFactory(object):
         library_stats = []
 
         try:
-            query = 'SELECT section_id, section_name, section_type, thumb AS library_thumb, ' \
-                    'custom_thumb_url AS custom_thumb, art AS library_art, custom_art_url AS custom_art, ' \
-                    'count, parent_count, child_count ' \
-                    'FROM library_sections ' \
-                    'WHERE section_id IN (%s) AND deleted_section = 0 ' \
-                    'ORDER BY section_type, count DESC, parent_count DESC, child_count DESC ' % ','.join(library_cards)
+            query = 'SELECT ls.id, ls.section_id, ls.section_name, ls.section_type, ls.thumb AS library_thumb, ' \
+                    'ls.custom_thumb_url AS custom_thumb, ls.art AS library_art, ls.custom_art_url AS custom_art, ' \
+                    'ls.count, ls.parent_count, ls.child_count, ' \
+                    'sh.id, shm.title, shm.grandparent_title, shm.full_title, shm.year, ' \
+                    'shm.media_index, shm.parent_media_index, ' \
+                    'sh.rating_key, shm.grandparent_rating_key, shm.thumb, shm.grandparent_thumb, ' \
+                    'sh.user, sh.user_id, sh.player, sh.section_id, ' \
+                    'shm.art, sh.media_type, shm.content_rating, shm.labels, shm.live, shm.guid, ' \
+                    'MAX(sh.started) AS last_watch ' \
+                    'FROM library_sections AS ls ' \
+                    'JOIN session_history AS sh ON ls.section_id = sh.section_id ' \
+                    'JOIN session_history_metadata AS shm ON sh.id = shm.id ' \
+                    'WHERE ls.section_id IN (%s) AND ls.deleted_section = 0 ' \
+                    'GROUP BY ls.id ' \
+                    'ORDER BY ls.section_type, ls.count DESC, ls.parent_count DESC, ls.child_count DESC ' % ','.join(library_cards)
             result = monitor_db.select(query)
         except Exception as e:
             logger.warn("Tautulli DataFactory :: Unable to execute database query for get_library_stats: %s." % e)
@@ -1062,17 +1071,40 @@ class DataFactory(object):
             else:
                 library_art = item['library_art']
 
+            if not item['grandparent_thumb'] or item['grandparent_thumb'] == '':
+                thumb = item['thumb']
+            else:
+                thumb = item['grandparent_thumb']
+
             library = {'section_id': item['section_id'],
                        'section_name': item['section_name'],
                        'section_type': item['section_type'],
-                       'thumb': library_thumb,
-                       'art': library_art,
+                       'library_thumb': library_thumb,
+                       'library_art': library_art,
                        'count': item['count'],
                        'child_count': item['parent_count'],
-                       'grandchild_count': item['child_count']
+                       'grandchild_count': item['child_count'],
+                       'thumb': thumb,
+                       'grandparent_thumb': item['grandparent_thumb'],
+                       'art': item['art'],
+                       'title': item['full_title'],
+                       'grandparent_title': item['grandparent_title'],
+                       'grandchild_title': item['title'],
+                       'year': item['year'],
+                       'media_index': item['media_index'],
+                       'parent_media_index': item['parent_media_index'],
+                       'rating_key': item['rating_key'],
+                       'grandparent_rating_key': item['grandparent_rating_key'],
+                       'media_type': item['media_type'],
+                       'content_rating': item['content_rating'],
+                       'labels': item['labels'].split(';') if item['labels'] else (),
+                       'live': item['live'],
+                       'guid': item['guid'],
+                       'row_id': item['id']
                        }
             library_stats.append(library)
 
+        library_stats = session.mask_session_info(library_stats)
         library_stats = {k: list(v) for k, v in groupby(library_stats, key=lambda x: x['section_type'])}
 
         return library_stats

From 4ae1f6cef907a1d328e030df8d3e55d8fa07e96b Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 1 Aug 2022 14:48:35 -0700
Subject: [PATCH 149/743] Allow fallback to another pms image

---
 plexpy/webserve.py | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/plexpy/webserve.py b/plexpy/webserve.py
index bee64b9a..e21b3139 100644
--- a/plexpy/webserve.py
+++ b/plexpy/webserve.py
@@ -4811,6 +4811,11 @@ class WebInterface(object):
                     fbi = common.DEFAULT_IMAGES[fallback]
                     fp = os.path.join(plexpy.PROG_DIR, 'data', fbi)
                     return serve_file(path=fp, content_type='image/png')
+                elif fallback:
+                    return self.real_pms_image_proxy(
+                        img=fallback, rating_key=None, width=width, height=height,
+                        opacity=opacity, background=background, blur=blur, img_format=img_format,
+                        fallback=None, refresh=refresh, clip=clip, **kwargs)
 
     @cherrypy.expose
     def image(self, *args, **kwargs):

From 3ab0c8fe22b2d18032955c5728e93d5fd1c2fb5c Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 1 Aug 2022 15:02:51 -0700
Subject: [PATCH 150/743] Use last played artwork on library stats cards

---
 data/interfaces/default/home_stats.html    | 4 ++--
 data/interfaces/default/index.html         | 5 +++--
 data/interfaces/default/library_stats.html | 4 ++--
 3 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/data/interfaces/default/home_stats.html b/data/interfaces/default/home_stats.html
index b873f64b..9a0c49f4 100644
--- a/data/interfaces/default/home_stats.html
+++ b/data/interfaces/default/home_stats.html
@@ -77,7 +77,7 @@ DOCUMENTATION :: END
         <% fallback = 'art-live' if row0['live'] else 'art' %>
         <div id="stats-background-${stat_id}" class="dashboard-stats-background" style="background-image: url(${page('pms_image_proxy', row0['art'], row0['rating_key'], 500, 280, 40, '282828', 3, fallback=fallback)});">
         % elif stat_id == 'top_libraries':
-        <div id="stats-background-${stat_id}" class="dashboard-stats-background" style="background-image: url(${page('pms_image_proxy', row0['art'], None, 500, 280, 40, '282828', 3, fallback='art')});">
+        <div id="stats-background-${stat_id}" class="dashboard-stats-background" style="background-image: url(${page('pms_image_proxy', row0['art'] or row0['library_art'], None, 500, 280, 40, '282828', 3, fallback=row0['library_art'])});" data-library_art="${row0['library_art']}">
         % elif stat_id == 'top_users':
         <div id="stats-background-${stat_id}" class="dashboard-stats-background" data-blurhash="${page('pms_image_proxy', row0['user_thumb'] or 'interfaces/default/images/gravatar-default.png', None, 100, 100, 40, '282828', 0, fallback='user')}">
         % elif stat_id == 'top_platforms':
@@ -147,7 +147,7 @@ DOCUMENTATION :: END
                                 data-rating_key="${row.get('rating_key')}" data-grandparent_rating_key="${row.get('grandparent_rating_key')}" data-guid="${row.get('guid')}" data-title="${row.get('title')}"
                                 data-art="${row.get('art')}" data-thumb="${row.get('thumb')}" data-platform="${row.get('platform_name')}" data-library-type="${row.get('section_type')}"
                                 data-user_id="${row.get('user_id')}" data-user="${row.get('user')}" data-friendly_name="${row.get('friendly_name')}" data-user_thumb="${row.get('user_thumb')}"
-                                data-last_watch="${row.get('last_watch')}" data-started="${row.get('started')}" data-live="${row.get('live')}">
+                                data-last_watch="${row.get('last_watch')}" data-started="${row.get('started')}" data-live="${row.get('live')}" data-library_art="${row.get('library_art', '')}">
                                 <div class="sub-list">${loop.index + 1}</div>
                                 <div class="sub-value">
                                     % if stat_id in ('top_movies', 'popular_movies', 'top_tv', 'popular_tv', 'top_music', 'popular_music', 'last_watched'):
diff --git a/data/interfaces/default/index.html b/data/interfaces/default/index.html
index 1175e8cd..b96e67cf 100644
--- a/data/interfaces/default/index.html
+++ b/data/interfaces/default/index.html
@@ -796,6 +796,7 @@
             var grandparent_rating_key = $(elem).data('grandparent_rating_key');
             var guid = $(elem).data('guid');
             var live = $(elem).data('live');
+            var library_art = $(elem).data('library_art');
             var [height, fallback_poster, fallback_art] = [450, 'poster', 'art'];
             if ($.inArray(stat_id, ['top_music', 'popular_music']) > -1) {
                 [height, fallback_poster, fallback_art] = [300, 'cover', 'art'];
@@ -807,7 +808,7 @@
             if (stat_id === 'most_concurrent') {
                 return
             } else if (stat_id === 'top_libraries') {
-                $('#stats-background-' + stat_id).css('background-image', 'url(' + page('pms_image_proxy', art, null, 500, 280, 40, '282828', 3, fallback_art) + ')');
+                $('#stats-background-' + stat_id).css('background-image', 'url(' + page('pms_image_proxy', art || library_art, null, 500, 280, 40, '282828', 3, library_art || fallback_art) + ')');
                 $('#stats-thumb-' + stat_id).removeClass(function (index, className) {
                     return (className.match (/(^|\s)svg-icon library-\S+/g) || []).join(' ')});
                 if (thumb.startsWith('http')) {
@@ -843,7 +844,7 @@
                 $('#stats-background-' + stat_id).css('background-image', 'url(' + page('pms_image_proxy', art, img_rating_key, 500, 280, 40, '282828', 3, fallback_art) + ')');
                 $('#stats-thumb-' + stat_id).css('background-image', 'url(' + page('pms_image_proxy', thumb, img_rating_key, 300, height, null, null, null, fallback_poster) + ')');
                 $('#stats-thumb-' + stat_id + '-bg').css('background-image', 'url(' + page('pms_image_proxy', thumb, img_rating_key, 300, height, 60, '282828', 3, fallback_poster) + ')');
-                $('#library-stats-background-' + stat_id).css('background-image', 'url(' + page('pms_image_proxy', art, img_rating_key, 500, 280, 40, '282828', 3, fallback_art) + ')');
+                $('#library-stats-background-' + stat_id).css('background-image', 'url(' + page('pms_image_proxy', art || library_art, img_rating_key, 500, 280, 40, '282828', 3, library_art || fallback_art) + ')');
                 if (thumb.startsWith('http')) {
                     $('#library-stats-thumb-' + stat_id).css('background-image', 'url(' + page('pms_image_proxy', thumb, img_rating_key, 300, 300, null, null, null, 'cover') + ')')
                         .removeClass('svg-icon library-' + stat_id);
diff --git a/data/interfaces/default/library_stats.html b/data/interfaces/default/library_stats.html
index c5cfca92..0690fd4e 100644
--- a/data/interfaces/default/library_stats.html
+++ b/data/interfaces/default/library_stats.html
@@ -40,7 +40,7 @@ DOCUMENTATION :: END
 %>
 <div class="dashboard-stats-instance" id="library-stats-instance-${section_type}" data-section_type="${section_type}">
     <div class="dashboard-stats-container">
-        <div id="library-stats-background-${section_type}" class="dashboard-stats-background" style="background-image: url(${page('pms_image_proxy', row0['art'], None, 500, 280, 40, '282828', 3, fallback='art')});">
+        <div id="library-stats-background-${section_type}" class="dashboard-stats-background" style="background-image: url(${page('pms_image_proxy', row0['art'] or row0['library_art'], None, 500, 280, 40, '282828', 3, fallback=row0['library_art'])});" data-library_art="${row0['library_art']}">
             % if row0['thumb'].startswith('http'):
             <div id="library-stats-thumb-${section_type}" class="dashboard-stats-flat hidden-xs" style="background-image: url(${page('pms_image_proxy', row0['thumb'], None, 80, 80)});"></div>
             % else:
@@ -56,7 +56,7 @@ DOCUMENTATION :: END
                         <ul class="list-unstyled dashboard-stats-info-list">
                             % for section in data[section_type]:
                             <li class="dashboard-stats-info-item ${'expanded' if loop.index == 0 else ''}" data-stat_id="${section_type}"
-                                data-art="${section.get('art')}" data-thumb="${section.get('thumb')}">
+                                data-art="${section.get('art')}" data-thumb="${section.get('thumb')}" data-library_art="${section.get('library_art')}">
                                 <div class="sub-list">${loop.index + 1}</div>
                                 <div class="sub-value">
                                     <a href="${page('library', section['section_id'])}" title="${section['section_name']}">

From e7b96ed9aefe560ee13ff1032095a89de04288a0 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Wed, 3 Aug 2022 10:52:58 -0700
Subject: [PATCH 151/743] Only filter usernames >= 3 characters

* Fixes #1806
---
 plexpy/logger.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/plexpy/logger.py b/plexpy/logger.py
index a1631610..971a741d 100644
--- a/plexpy/logger.py
+++ b/plexpy/logger.py
@@ -79,7 +79,7 @@ def filter_usernames(new_users=None):
         new_users = [user['username'] for user in users.Users().get_users()]
 
     for username in new_users:
-        if username.lower() not in ('local', 'guest') and username not in _FILTER_USERNAMES:
+        if username.lower() not in ('local', 'guest') and len(username) >= 3 and username not in _FILTER_USERNAMES:
             _FILTER_USERNAMES.append(username)
 
     _FILTER_USERNAMES = sorted(_FILTER_USERNAMES, key=len, reverse=True)

From 8327c4811149d3c45e70740e4636849ff230636f Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 9 Aug 2022 16:36:03 -0700
Subject: [PATCH 152/743] Bump actions/setup-python from 4.1.0 to 4.2.0 (#1805)

Bumps [actions/setup-python](https://github.com/actions/setup-python) from 4.1.0 to 4.2.0.
- [Release notes](https://github.com/actions/setup-python/releases)
- [Commits](https://github.com/actions/setup-python/compare/v4.1.0...v4.2.0)

---
updated-dependencies:
- dependency-name: actions/setup-python
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

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

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

[skip ci]
---
 .github/workflows/publish-installers.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/publish-installers.yml b/.github/workflows/publish-installers.yml
index ff6fd120..a5cc7495 100644
--- a/.github/workflows/publish-installers.yml
+++ b/.github/workflows/publish-installers.yml
@@ -51,7 +51,7 @@ jobs:
           echo $GITHUB_SHA > version.txt
 
       - name: Set Up Python
-        uses: actions/setup-python@v4.1.0
+        uses: actions/setup-python@v4.2.0
         with:
           python-version: 3.9
 

From e85834706aa3e147b89b3831d8a733c98234011d Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 9 Aug 2022 16:36:16 -0700
Subject: [PATCH 153/743] Bump actions/cache from 3.0.5 to 3.0.6 (#1808)

Bumps [actions/cache](https://github.com/actions/cache) from 3.0.5 to 3.0.6.
- [Release notes](https://github.com/actions/cache/releases)
- [Changelog](https://github.com/actions/cache/blob/main/RELEASES.md)
- [Commits](https://github.com/actions/cache/compare/v3.0.5...v3.0.6)

---
updated-dependencies:
- dependency-name: actions/cache
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

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

[skip ci]
---
 .github/workflows/publish-docker.yml     | 2 +-
 .github/workflows/publish-installers.yml | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/publish-docker.yml b/.github/workflows/publish-docker.yml
index f30eb60c..8fc0be89 100644
--- a/.github/workflows/publish-docker.yml
+++ b/.github/workflows/publish-docker.yml
@@ -46,7 +46,7 @@ jobs:
           version: latest
 
       - name: Cache Docker Layers
-        uses: actions/cache@v3.0.5
+        uses: actions/cache@v3.0.6
         with:
           path: /tmp/.buildx-cache
           key: ${{ runner.os }}-buildx-${{ github.sha }}
diff --git a/.github/workflows/publish-installers.yml b/.github/workflows/publish-installers.yml
index a5cc7495..1098ee01 100644
--- a/.github/workflows/publish-installers.yml
+++ b/.github/workflows/publish-installers.yml
@@ -56,7 +56,7 @@ jobs:
           python-version: 3.9
 
       - name: Cache Dependencies
-        uses: actions/cache@v3.0.5
+        uses: actions/cache@v3.0.6
         with:
           path: ~\AppData\Local\pip\Cache
           key: ${{ runner.os }}-pip-${{ hashFiles('package/requirements-package.txt') }}

From 23c881f4d1612b9ca1c5c38f0e7647e04dc6b951 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 9 Aug 2022 16:38:19 -0700
Subject: [PATCH 154/743] Bump plexapi from 4.11.2 to 4.12.1 (#1811)

Bumps [plexapi](https://github.com/pkkid/python-plexapi) from 4.11.2 to 4.12.1.
- [Release notes](https://github.com/pkkid/python-plexapi/releases)
- [Commits](https://github.com/pkkid/python-plexapi/compare/4.11.2...4.12.1)

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

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

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements.txt b/requirements.txt
index fe7156aa..b0285a13 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -27,7 +27,7 @@ MarkupSafe==2.1.1
 musicbrainzngs==0.7.1
 packaging==21.3
 paho-mqtt==1.6.1
-plexapi==4.11.2
+plexapi==4.12.1
 portend==3.1.0
 profilehooks==1.12.0
 PyJWT==2.4.0

From c1f433ab60e29ae87aebde95f29cfa405ef0de3e Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 9 Aug 2022 16:44:41 -0700
Subject: [PATCH 155/743] Add languageTag to export attribute

---
 plexpy/exporter.py | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/plexpy/exporter.py b/plexpy/exporter.py
index d82c974c..e34af467 100644
--- a/plexpy/exporter.py
+++ b/plexpy/exporter.py
@@ -265,6 +265,7 @@ class Export(object):
                             'key': None,
                             'language': None,
                             'languageCode': None,
+                            'languageTag': None,
                             'requiredBandwidths': None,
                             'selected': None,
                             'streamType': None,
@@ -316,6 +317,7 @@ class Export(object):
                             'key': None,
                             'language': None,
                             'languageCode': None,
+                            'languageTag': None,
                             'requiredBandwidths': None,
                             'selected': None,
                             'streamType': None,
@@ -340,6 +342,7 @@ class Export(object):
                             'key': None,
                             'language': None,
                             'languageCode': None,
+                            'languageTag': None,
                             'requiredBandwidths': None,
                             'selected': None,
                             'streamType': None,
@@ -646,6 +649,7 @@ class Export(object):
                             'key': None,
                             'language': None,
                             'languageCode': None,
+                            'languageTag': None,
                             'requiredBandwidths': None,
                             'selected': None,
                             'streamType': None,
@@ -697,6 +701,7 @@ class Export(object):
                             'key': None,
                             'language': None,
                             'languageCode': None,
+                            'languageTag': None,
                             'requiredBandwidths': None,
                             'selected': None,
                             'streamType': None,
@@ -721,6 +726,7 @@ class Export(object):
                             'key': None,
                             'language': None,
                             'languageCode': None,
+                            'languageTag': None,
                             'requiredBandwidths': None,
                             'selected': None,
                             'streamType': None,
@@ -989,6 +995,7 @@ class Export(object):
                             'key': None,
                             'language': None,
                             'languageCode': None,
+                            'languageTag': None,
                             'requiredBandwidths': None,
                             'selected': None,
                             'streamType': None,
@@ -1021,6 +1028,7 @@ class Export(object):
                             'key': None,
                             'language': None,
                             'languageCode': None,
+                            'languageTag': None,
                             'requiredBandwidths': None,
                             'selected': None,
                             'streamType': None,

From 0bf1329d039e7f49c956617f68002604a77463f3 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 9 Aug 2022 17:02:31 -0700
Subject: [PATCH 156/743] Add guides to Artist, Album, and Track export
 attributes

---
 plexpy/exporter.py | 15 ++++++++++++---
 1 file changed, 12 insertions(+), 3 deletions(-)

diff --git a/plexpy/exporter.py b/plexpy/exporter.py
index e34af467..09c0c6b0 100644
--- a/plexpy/exporter.py
+++ b/plexpy/exporter.py
@@ -805,6 +805,9 @@ class Export(object):
                     'tag': None
                 },
                 'guid': None,
+                'guids': {
+                    'id': None
+                },
                 'index': None,
                 'key': None,
                 'labels': {
@@ -869,6 +872,9 @@ class Export(object):
                     'tag': None
                 },
                 'guid': None,
+                'guids': {
+                    'id': None
+                },
                 'hasSonicAnalysis': None,
                 'index': None,
                 'key': None,
@@ -946,6 +952,9 @@ class Export(object):
                 'grandparentThumb': None,
                 'grandparentTitle': None,
                 'guid': None,
+                'guids': {
+                    'id': None
+                },
                 'hasSonicAnalysis': None,
                 'index': None,
                 'key': None,
@@ -1443,7 +1452,7 @@ class Export(object):
                 ],
                 2: [
                     'collections.tag', 'genres.tag', 'countries.tag', 'moods.tag', 'similar.tag', 'styles.tag',
-                    'fields.name', 'fields.locked'
+                    'fields.name', 'fields.locked', 'guids.id'
                 ],
                 3: [
                     'art', 'thumb', 'key',
@@ -1468,7 +1477,7 @@ class Export(object):
                 2: [
                     'collections.tag', 'formats.tag', 'genres.tag', 'labels.tag',
                     'moods.tag', 'styles.tag', 'subformats.tag',
-                    'fields.name', 'fields.locked'
+                    'fields.name', 'fields.locked', 'guids.id'
                 ],
                 3: [
                     'art', 'thumb', 'key',
@@ -1493,7 +1502,7 @@ class Export(object):
                 ],
                 2: [
                     'collections.tag', 'moods.tag',
-                    'fields.name', 'fields.locked'
+                    'fields.name', 'fields.locked', 'guids.id'
                 ],
                 3: [
                     'art', 'thumb', 'key',

From 2a83502ca1bd98edf021824b905fd1f22627ec9b Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 9 Aug 2022 16:58:42 -0700
Subject: [PATCH 157/743] Username log filter longer than 3 characters

---
 plexpy/logger.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/plexpy/logger.py b/plexpy/logger.py
index 971a741d..953073c3 100644
--- a/plexpy/logger.py
+++ b/plexpy/logger.py
@@ -79,7 +79,7 @@ def filter_usernames(new_users=None):
         new_users = [user['username'] for user in users.Users().get_users()]
 
     for username in new_users:
-        if username.lower() not in ('local', 'guest') and len(username) >= 3 and username not in _FILTER_USERNAMES:
+        if username.lower() not in ('local', 'guest') and len(username) > 3 and username not in _FILTER_USERNAMES:
             _FILTER_USERNAMES.append(username)
 
     _FILTER_USERNAMES = sorted(_FILTER_USERNAMES, key=len, reverse=True)

From b83e9e3257dae476a566c8a9b3b965625e17441d Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 9 Aug 2022 17:16:07 -0700
Subject: [PATCH 158/743] Fix channel identifier overflow on activity card

* Fixes #1802
---
 data/interfaces/default/css/tautulli.css               | 6 ++++++
 data/interfaces/default/current_activity_instance.html | 2 +-
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/data/interfaces/default/css/tautulli.css b/data/interfaces/default/css/tautulli.css
index 514975c3..c30a69ee 100644
--- a/data/interfaces/default/css/tautulli.css
+++ b/data/interfaces/default/css/tautulli.css
@@ -997,6 +997,12 @@ a .users-poster-face:hover {
     font-size: 10px;
     z-index: 2;
 }
+.dashboard-activity-info-channel {
+    display: inline-block;
+    max-width: 75px;
+    text-overflow: ellipsis;
+    overflow: hidden;
+}
 .dashboard-activity-progress {
     width: 100%;
     height: 5px;
diff --git a/data/interfaces/default/current_activity_instance.html b/data/interfaces/default/current_activity_instance.html
index e9838b8a..3ce0fb05 100644
--- a/data/interfaces/default/current_activity_instance.html
+++ b/data/interfaces/default/current_activity_instance.html
@@ -363,7 +363,7 @@ DOCUMENTATION :: END
                 % if data['media_type'] != 'photo':
                 <div class="dashboard-activity-info-time">
                     % if data['live']:
-                    <br /><span class="thumb-tooltip" data-toggle="popover" data-img="${data['channel_thumb']}" data-height="40" data-width="40">${data['channel_call_sign']} ${data['channel_identifier']}</span>
+                    <br /><span class="thumb-tooltip dashboard-activity-info-channel" data-toggle="popover" data-img="${data['channel_thumb']}" data-height="40" data-width="40">${data['channel_call_sign']} ${data['channel_identifier']}</span>
                     % elif data['view_offset']:
                     ETA:
                     <span id="stream-eta-${sk}">

From 24f05a03c0a760ed7970e3f2e4ab915dde047886 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 9 Aug 2022 17:20:12 -0700
Subject: [PATCH 159/743] v2.10.3

---
 CHANGELOG.md      | 19 +++++++++++++++++++
 plexpy/version.py |  2 +-
 2 files changed, 20 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 64a1c5f9..ca842b7b 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,24 @@
 # Changelog
 
+## v2.10.3 (2022-08-09)
+
+* Notifications:
+  * New: Added JSON support for MQTT notifications. (#1763)
+  * New: Added show year notification parameter.
+* Exporter:
+  * New: Added guids to artist, album, and track metadata export fields.
+  * New: Added languageTag to stream media info export fields.
+* UI:
+  * Change: Use the last played item's artwork for library statistics cards. 
+* Other:
+  * Fix: Username log filter causing database to lock up. (#1705)
+  * Change: Username log filter only applies to usernames longer than 3 characters. (#1806)
+* API:
+  * New: Added parent_year and grandparent_year to get_metadata_details API command.
+  * New: Added last played metadata to top_libraries and top_users in get_home_stats API command.
+  * New: Allow fallback to another PMS image in pms_image_proxy API command.
+
+
 ## v2.10.2 (2022-07-03)
 
 * Activity:
diff --git a/plexpy/version.py b/plexpy/version.py
index 906f1534..0b033d3d 100644
--- a/plexpy/version.py
+++ b/plexpy/version.py
@@ -18,4 +18,4 @@
 from __future__ import unicode_literals
 
 PLEXPY_BRANCH = "master"
-PLEXPY_RELEASE_VERSION = "v2.10.2"
+PLEXPY_RELEASE_VERSION = "v2.10.3"

From 444b138e97a272e110fcb4364e8864348eee71c3 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 9 Aug 2022 17:22:49 -0700
Subject: [PATCH 160/743] Update v2.10.3 changelog

---
 CHANGELOG.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index ca842b7b..cb1af251 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -9,6 +9,7 @@
   * New: Added guids to artist, album, and track metadata export fields.
   * New: Added languageTag to stream media info export fields.
 * UI:
+  * Fix: Long channel identifier overflowing activity card. (#1802) 
   * Change: Use the last played item's artwork for library statistics cards. 
 * Other:
   * Fix: Username log filter causing database to lock up. (#1705)

From 8114079eacda0588f9ac9b1083d067a876634e98 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 11 Aug 2022 09:46:15 -0700
Subject: [PATCH 161/743] Fix album count showing 0

---
 plexpy/pmsconnect.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/plexpy/pmsconnect.py b/plexpy/pmsconnect.py
index 45597b18..7149836d 100644
--- a/plexpy/pmsconnect.py
+++ b/plexpy/pmsconnect.py
@@ -2740,7 +2740,7 @@ class PmsConnect(object):
                 return []
 
         elif str(section_id).isdigit() or section_type == 'album':
-            if section_type == 'album':
+            if section_type == 'album' and rating_key:
                 sort_type += '&artist.id=' + str(rating_key)
 
             xml_head = self.fetch_library_list(

From 85dda97e52c828a86b67e75b7e38f77a5dd265c2 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 18 Aug 2022 10:02:32 -0700
Subject: [PATCH 162/743] Fix library stats not shown for libraries without
 history

* Fixes #1818
---
 plexpy/datafactory.py | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/plexpy/datafactory.py b/plexpy/datafactory.py
index eb4c18ae..09b26a45 100644
--- a/plexpy/datafactory.py
+++ b/plexpy/datafactory.py
@@ -1048,8 +1048,8 @@ class DataFactory(object):
                     'shm.art, sh.media_type, shm.content_rating, shm.labels, shm.live, shm.guid, ' \
                     'MAX(sh.started) AS last_watch ' \
                     'FROM library_sections AS ls ' \
-                    'JOIN session_history AS sh ON ls.section_id = sh.section_id ' \
-                    'JOIN session_history_metadata AS shm ON sh.id = shm.id ' \
+                    'LEFT OUTER JOIN session_history AS sh ON ls.section_id = sh.section_id ' \
+                    'LEFT OUTER JOIN session_history_metadata AS shm ON sh.id = shm.id ' \
                     'WHERE ls.section_id IN (%s) AND ls.deleted_section = 0 ' \
                     'GROUP BY ls.id ' \
                     'ORDER BY ls.section_type, ls.count DESC, ls.parent_count DESC, ls.child_count DESC ' % ','.join(library_cards)
@@ -1084,9 +1084,9 @@ class DataFactory(object):
                        'count': item['count'],
                        'child_count': item['parent_count'],
                        'grandchild_count': item['child_count'],
-                       'thumb': thumb,
-                       'grandparent_thumb': item['grandparent_thumb'],
-                       'art': item['art'],
+                       'thumb': thumb or '',
+                       'grandparent_thumb': item['grandparent_thumb'] or '',
+                       'art': item['art'] or '',
                        'title': item['full_title'],
                        'grandparent_title': item['grandparent_title'],
                        'grandchild_title': item['title'],

From c3572f3212f31c45a9b194785ea1823ecde05e06 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 18 Aug 2022 10:11:47 -0700
Subject: [PATCH 163/743] Add workflow dispatch to workflows

[skip ci]
---
 .github/workflows/publish-docker.yml     | 1 +
 .github/workflows/publish-installers.yml | 1 +
 .github/workflows/publish-snap.yml       | 1 +
 3 files changed, 3 insertions(+)

diff --git a/.github/workflows/publish-docker.yml b/.github/workflows/publish-docker.yml
index 8fc0be89..39533cb6 100644
--- a/.github/workflows/publish-docker.yml
+++ b/.github/workflows/publish-docker.yml
@@ -1,6 +1,7 @@
 name: Publish Docker
 
 on:
+  workflow_dispatch: ~
   push:
     branches: [master, beta, nightly]
     tags: [v*]
diff --git a/.github/workflows/publish-installers.yml b/.github/workflows/publish-installers.yml
index 1098ee01..ffb1f2ee 100644
--- a/.github/workflows/publish-installers.yml
+++ b/.github/workflows/publish-installers.yml
@@ -1,6 +1,7 @@
 name: Publish Installers
 
 on:
+  workflow_dispatch: ~
   push:
     branches: [master, beta, nightly]
     tags: [v*]
diff --git a/.github/workflows/publish-snap.yml b/.github/workflows/publish-snap.yml
index df3c3475..65fb9b17 100644
--- a/.github/workflows/publish-snap.yml
+++ b/.github/workflows/publish-snap.yml
@@ -1,6 +1,7 @@
 name: Publish Snap
 
 on:
+  workflow_dispatch: ~
   push:
     branches: [master, beta, nightly]
     tags: [v*]

From b73f8cc30e31e06fce6d2b7fce408fede40083c4 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 18 Aug 2022 10:14:14 -0700
Subject: [PATCH 164/743] Remove unused architectures in snap workflow

---
 .github/workflows/publish-snap.yml | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/.github/workflows/publish-snap.yml b/.github/workflows/publish-snap.yml
index 65fb9b17..26fb174c 100644
--- a/.github/workflows/publish-snap.yml
+++ b/.github/workflows/publish-snap.yml
@@ -15,12 +15,9 @@ jobs:
       fail-fast: false
       matrix:
         architecture:
-          - i386
           - amd64
           - arm64
           - armhf
-          - ppc64el
-          #- s390x  # broken at the moment
     steps:
       - name: Checkout Code
         uses: actions/checkout@v3.0.2

From 84fb1a2dc24d342b64a7170eaa104c9581eddd2c Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 18 Aug 2022 16:35:06 -0700
Subject: [PATCH 165/743] Add quality profile tooltip

---
 data/interfaces/default/current_activity_instance.html | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/data/interfaces/default/current_activity_instance.html b/data/interfaces/default/current_activity_instance.html
index 3ce0fb05..2c24c233 100644
--- a/data/interfaces/default/current_activity_instance.html
+++ b/data/interfaces/default/current_activity_instance.html
@@ -160,7 +160,8 @@ DOCUMENTATION :: END
                             </li>
                             <li class="dashboard-activity-info-item">
                                 <div class="sub-heading">Quality</div>
-                                <div class="sub-value platform-right" id="stream_quality-${sk}">
+                                <div class="sub-value platform-right">
+                                    <span id="stream_quality-${sk}">
                                     % if data['media_type'] != 'photo' and data['quality_profile'] != 'Unknown':
                                     <%
                                         br = cast_to_int(data['stream_bitrate']) or ''
@@ -174,6 +175,8 @@ DOCUMENTATION :: END
                                     % else:
                                     ${data['quality_profile']}
                                     % endif
+                                    </span>
+                                    <span data-toggle="tooltip" title="Quality profile is only an estimate based on bitrate and may be incorrect"><i class="fa fa-exclamation-circle"></i></span>
                                 </div>
                             </li>
                             % if data['optimized_version'] == 1:

From b2777e30f2d9d5f76e16a6ec9c7d7036a12bbc45 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 18 Aug 2022 16:40:38 -0700
Subject: [PATCH 166/743] Add git safe directory to snapcraft.yml

---
 snap/snapcraft.yaml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/snap/snapcraft.yaml b/snap/snapcraft.yaml
index 5cdeeeb9..82171392 100644
--- a/snap/snapcraft.yaml
+++ b/snap/snapcraft.yaml
@@ -28,6 +28,7 @@ parts:
       - git
     override-pull: |
       snapcraftctl pull
+      git config --global --add safe.directory /data/parts/tautulli/src
       TAG_FULL=$(git describe --tag)
       TAG=$(echo $TAG_FULL | grep -oP '(v\d+\.\d+\.\d+(?>-beta)?)')
       BRANCH=$(git rev-parse --abbrev-ref HEAD)

From 3c40f83738a4c74b12a4374c0cfb5802e04f24f2 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 19 Aug 2022 10:36:10 -0700
Subject: [PATCH 167/743] Update filterer.jquery.js

---
 data/interfaces/default/js/filterer.jquery.js | 19 ++++++++++---------
 1 file changed, 10 insertions(+), 9 deletions(-)

diff --git a/data/interfaces/default/js/filterer.jquery.js b/data/interfaces/default/js/filterer.jquery.js
index efab9afa..16458f13 100644
--- a/data/interfaces/default/js/filterer.jquery.js
+++ b/data/interfaces/default/js/filterer.jquery.js
@@ -1,9 +1,10 @@
-!function(e){function t(r){if(n[r])return n[r].exports;var o=n[r]={exports:{},id:r,loaded:!1};return e[r].call(o.exports,o,o.exports,t),o.loaded=!0,o.exports}var n={};return t.m=e,t.c=n,t.p="/filterer/",t(0)}(function(e){for(var t in e)if(Object.prototype.hasOwnProperty.call(e,t))switch(typeof e[t]){case"function":break;case"object":e[t]=function(t){var n=t.slice(1),r=e[t[0]];return function(e,t,o){r.apply(this,[e,t,o].concat(n))}}(e[t]);break;default:e[t]=e[e[t]]}return e}([function(e,t,n){n(181),e.exports=n(95)},function(e,t,n){"use strict";function r(e,t,n,r,i,a,s,u){if(o(t),!e){var l;if(void 0===t)l=new Error("Minified exception occurred; use the non-minified dev environment for the full error message and additional helpful warnings.");else{var c=[n,r,i,a,s,u],p=0;l=new Error(t.replace(/%s/g,function(){return c[p++]})),l.name="Invariant Violation"}throw l.framesToPop=1,l}}var o=function(e){};e.exports=r},function(e,t,n){"use strict";var r=n(8),o=r;e.exports=o},function(e,t){"use strict";function n(e){for(var t=arguments.length-1,n="Minified React error #"+e+"; visit http://facebook.github.io/react/docs/error-decoder.html?invariant="+e,r=0;r<t;r++)n+="&args[]="+encodeURIComponent(arguments[r+1]);n+=" for the full message or use the non-minified dev environment for full errors and additional helpful warnings.";var o=new Error(n);throw o.name="Invariant Violation",o.framesToPop=1,o}e.exports=n},function(e,t){"use strict";function n(e){if(null===e||void 0===e)throw new TypeError("Object.assign cannot be called with null or undefined");return Object(e)}function r(){try{if(!Object.assign)return!1;var e=new String("abc");if(e[5]="de","5"===Object.getOwnPropertyNames(e)[0])return!1;for(var t={},n=0;n<10;n++)t["_"+String.fromCharCode(n)]=n;var r=Object.getOwnPropertyNames(t).map(function(e){return t[e]});if("0123456789"!==r.join(""))return!1;var o={};return"abcdefghijklmnopqrst".split("").forEach(function(e){o[e]=e}),"abcdefghijklmnopqrst"===Object.keys(Object.assign({},o)).join("")}catch(e){return!1}}var o=Object.getOwnPropertySymbols,i=Object.prototype.hasOwnProperty,a=Object.prototype.propertyIsEnumerable;e.exports=r()?Object.assign:function(e,t){for(var r,s,u=n(e),l=1;l<arguments.length;l++){r=Object(arguments[l]);for(var c in r)i.call(r,c)&&(u[c]=r[c]);if(o){s=o(r);for(var p=0;p<s.length;p++)a.call(r,s[p])&&(u[s[p]]=r[s[p]])}}return u}},function(e,t,n){"use strict";function r(e,t){return 1===e.nodeType&&e.getAttribute(h)===String(t)||8===e.nodeType&&e.nodeValue===" react-text: "+t+" "||8===e.nodeType&&e.nodeValue===" react-empty: "+t+" "}function o(e){for(var t;t=e._renderedComponent;)e=t;return e}function i(e,t){var n=o(e);n._hostNode=t,t[m]=n}function a(e){var t=e._hostNode;t&&(delete t[m],e._hostNode=null)}function s(e,t){if(!(e._flags&v.hasCachedChildNodes)){var n=e._renderedChildren,a=t.firstChild;e:for(var s in n)if(n.hasOwnProperty(s)){var u=n[s],l=o(u)._domID;if(0!==l){for(;null!==a;a=a.nextSibling)if(r(a,l)){i(u,a);continue e}p("32",l)}}e._flags|=v.hasCachedChildNodes}}function u(e){if(e[m])return e[m];for(var t=[];!e[m];){if(t.push(e),!e.parentNode)return null;e=e.parentNode}for(var n,r;e&&(r=e[m]);e=t.pop())n=r,t.length&&s(r,e);return n}function l(e){var t=u(e);return null!=t&&t._hostNode===e?t:null}function c(e){if(void 0===e._hostNode?p("33"):void 0,e._hostNode)return e._hostNode;for(var t=[];!e._hostNode;)t.push(e),e._hostParent?void 0:p("34"),e=e._hostParent;for(;t.length;e=t.pop())s(e,e._hostNode);return e._hostNode}var p=n(3),f=n(19),d=n(66),h=(n(1),f.ID_ATTRIBUTE_NAME),v=d,m="__reactInternalInstance$"+Math.random().toString(36).slice(2),g={getClosestInstanceFromNode:u,getInstanceFromNode:l,getNodeFromInstance:c,precacheChildNodes:s,precacheNode:i,uncacheNode:a};e.exports=g},function(e,t,n){"use strict";e.exports=n(12)},function(e,t){"use strict";var n=!("undefined"==typeof window||!window.document||!window.document.createElement),r={canUseDOM:n,canUseWorkers:"undefined"!=typeof Worker,canUseEventListeners:n&&!(!window.addEventListener&&!window.attachEvent),canUseViewport:n&&!!window.screen,isInWorker:!n};e.exports=r},function(e,t){"use strict";function n(e){return function(){return e}}var r=function(){};r.thatReturns=n,r.thatReturnsFalse=n(!1),r.thatReturnsTrue=n(!0),r.thatReturnsNull=n(null),r.thatReturnsThis=function(){return this},r.thatReturnsArgument=function(e){return e},e.exports=r},function(e,t,n){"use strict";var r=null;e.exports={debugTool:r}},function(e,t,n){"use strict";function r(){P.ReactReconcileTransaction&&_?void 0:c("123")}function o(){this.reinitializeTransaction(),this.dirtyComponentsLength=null,this.callbackQueue=f.getPooled(),this.reconcileTransaction=P.ReactReconcileTransaction.getPooled(!0)}function i(e,t,n,o,i,a){return r(),_.batchedUpdates(e,t,n,o,i,a)}function a(e,t){return e._mountOrder-t._mountOrder}function s(e){var t=e.dirtyComponentsLength;t!==g.length?c("124",t,g.length):void 0,g.sort(a),y++;for(var n=0;n<t;n++){var r=g[n],o=r._pendingCallbacks;r._pendingCallbacks=null;var i;if(h.logTopLevelRenders){var s=r;r._currentElement.type.isReactTopLevelWrapper&&(s=r._renderedComponent),i="React update: "+s.getName(),console.time(i)}if(v.performUpdateIfNecessary(r,e.reconcileTransaction,y),i&&console.timeEnd(i),o)for(var u=0;u<o.length;u++)e.callbackQueue.enqueue(o[u],r.getPublicInstance())}}function u(e){return r(),_.isBatchingUpdates?(g.push(e),void(null==e._updateBatchNumber&&(e._updateBatchNumber=y+1))):void _.batchedUpdates(u,e)}function l(e,t){_.isBatchingUpdates?void 0:c("125"),b.enqueue(e,t),C=!0}var c=n(3),p=n(4),f=n(63),d=n(15),h=n(69),v=n(20),m=n(33),g=(n(1),[]),y=0,b=f.getPooled(),C=!1,_=null,w={initialize:function(){this.dirtyComponentsLength=g.length},close:function(){this.dirtyComponentsLength!==g.length?(g.splice(0,this.dirtyComponentsLength),T()):g.length=0}},E={initialize:function(){this.callbackQueue.reset()},close:function(){this.callbackQueue.notifyAll()}},x=[w,E];p(o.prototype,m,{getTransactionWrappers:function(){return x},destructor:function(){this.dirtyComponentsLength=null,f.release(this.callbackQueue),this.callbackQueue=null,P.ReactReconcileTransaction.release(this.reconcileTransaction),this.reconcileTransaction=null},perform:function(e,t,n){return m.perform.call(this,this.reconcileTransaction.perform,this.reconcileTransaction,e,t,n)}}),d.addPoolingTo(o);var T=function(){for(;g.length||C;){if(g.length){var e=o.getPooled();e.perform(s,null,e),o.release(e)}if(C){C=!1;var t=b;b=f.getPooled(),t.notifyAll(),f.release(t)}}},O={injectReconcileTransaction:function(e){e?void 0:c("126"),P.ReactReconcileTransaction=e},injectBatchingStrategy:function(e){e?void 0:c("127"),"function"!=typeof e.batchedUpdates?c("128"):void 0,"boolean"!=typeof e.isBatchingUpdates?c("129"):void 0,_=e}},P={ReactReconcileTransaction:null,batchedUpdates:i,enqueueUpdate:u,flushBatchedUpdates:T,injection:O,asap:l};e.exports=P},function(e,t,n){"use strict";function r(e,t,n,r){this.dispatchConfig=e,this._targetInst=t,this.nativeEvent=n;var o=this.constructor.Interface;for(var i in o)if(o.hasOwnProperty(i)){var s=o[i];s?this[i]=s(n):"target"===i?this.target=r:this[i]=n[i]}var u=null!=n.defaultPrevented?n.defaultPrevented:n.returnValue===!1;return u?this.isDefaultPrevented=a.thatReturnsTrue:this.isDefaultPrevented=a.thatReturnsFalse,this.isPropagationStopped=a.thatReturnsFalse,this}var o=n(4),i=n(15),a=n(8),s=(n(2),"function"==typeof Proxy,["dispatchConfig","_targetInst","nativeEvent","isDefaultPrevented","isPropagationStopped","_dispatchListeners","_dispatchInstances"]),u={type:null,target:null,currentTarget:a.thatReturnsNull,eventPhase:null,bubbles:null,cancelable:null,timeStamp:function(e){return e.timeStamp||Date.now()},defaultPrevented:null,isTrusted:null};o(r.prototype,{preventDefault:function(){this.defaultPrevented=!0;var e=this.nativeEvent;e&&(e.preventDefault?e.preventDefault():"unknown"!=typeof e.returnValue&&(e.returnValue=!1),this.isDefaultPrevented=a.thatReturnsTrue)},stopPropagation:function(){var e=this.nativeEvent;e&&(e.stopPropagation?e.stopPropagation():"unknown"!=typeof e.cancelBubble&&(e.cancelBubble=!0),this.isPropagationStopped=a.thatReturnsTrue)},persist:function(){this.isPersistent=a.thatReturnsTrue},isPersistent:a.thatReturnsFalse,destructor:function(){var e=this.constructor.Interface;for(var t in e)this[t]=null;for(var n=0;n<s.length;n++)this[s[n]]=null}}),r.Interface=u,r.augmentClass=function(e,t){var n=this,r=function(){};r.prototype=n.prototype;var a=new r;o(a,e.prototype),e.prototype=a,e.prototype.constructor=e,e.Interface=o({},n.Interface,t),e.augmentClass=n.augmentClass,i.addPoolingTo(e,i.fourArgumentPooler)},i.addPoolingTo(r,i.fourArgumentPooler),e.exports=r},function(e,t,n){"use strict";var r=n(4),o=n(197),i=n(54),a=n(202),s=n(198),u=n(199),l=n(21),c=n(201),p=n(206),f=n(89),d=(n(2),l.createElement),h=l.createFactory,v=l.cloneElement,m=r,g={Children:{map:o.map,forEach:o.forEach,count:o.count,toArray:o.toArray,only:f},Component:i,PureComponent:a,createElement:d,cloneElement:v,isValidElement:l.isValidElement,PropTypes:c,createClass:s.createClass,createFactory:h,createMixin:function(e){return e},DOM:u,version:p,__spread:m};e.exports=g},function(e,t){"use strict";var n={current:null};e.exports=n},function(e,t,n){function r(e,t){var n,r=function(o){return e.length>1?function(){var i=o?o.concat():[];return n=t?n||this:this,i.push.apply(i,arguments)<e.length&&arguments.length?r.call(n,i):e.apply(n,i)}:e};return r()}var o,i,a,s,u,l,c,p,f,d={}.toString;o=n(109),i=n(110),a=n(112),s=n(113),u=n(111),l=function(e){return e},c=r(function(e,t){return d.call(t).slice(8,-1)===e}),p=r(function(e,t){var n,r=[];for(n=0;n<e;++n)r.push(t);return r}),s.empty=i.empty,s.slice=i.slice,s.take=i.take,s.drop=i.drop,s.splitAt=i.splitAt,s.takeWhile=i.takeWhile,s.dropWhile=i.dropWhile,s.span=i.span,s.breakStr=i.breakList,f={Func:o,List:i,Obj:a,Str:s,Num:u,id:l,isType:c,replicate:p},f.each=i.each,f.map=i.map,f.filter=i.filter,f.compact=i.compact,f.reject=i.reject,f.partition=i.partition,f.find=i.find,f.head=i.head,f.first=i.first,f.tail=i.tail,f.last=i.last,f.initial=i.initial,f.empty=i.empty,f.reverse=i.reverse,f.difference=i.difference,f.intersection=i.intersection,f.union=i.union,f.countBy=i.countBy,f.groupBy=i.groupBy,f.fold=i.fold,f.foldl=i.foldl,f.fold1=i.fold1,f.foldl1=i.foldl1,f.foldr=i.foldr,f.foldr1=i.foldr1,f.unfoldr=i.unfoldr,f.andList=i.andList,f.orList=i.orList,f.any=i.any,f.all=i.all,f.unique=i.unique,f.uniqueBy=i.uniqueBy,f.sort=i.sort,f.sortWith=i.sortWith,f.sortBy=i.sortBy,f.sum=i.sum,f.product=i.product,f.mean=i.mean,f.average=i.average,f.concat=i.concat,f.concatMap=i.concatMap,f.flatten=i.flatten,f.maximum=i.maximum,f.minimum=i.minimum,f.maximumBy=i.maximumBy,f.minimumBy=i.minimumBy,f.scan=i.scan,f.scanl=i.scanl,f.scan1=i.scan1,f.scanl1=i.scanl1,f.scanr=i.scanr,f.scanr1=i.scanr1,f.slice=i.slice,f.take=i.take,f.drop=i.drop,f.splitAt=i.splitAt,f.takeWhile=i.takeWhile,f.dropWhile=i.dropWhile,f.span=i.span,f.breakList=i.breakList,f.zip=i.zip,f.zipWith=i.zipWith,f.zipAll=i.zipAll,f.zipAllWith=i.zipAllWith,f.at=i.at,f.elemIndex=i.elemIndex,f.elemIndices=i.elemIndices,f.findIndex=i.findIndex,f.findIndices=i.findIndices,f.apply=o.apply,f.curry=o.curry,f.flip=o.flip,f.fix=o.fix,f.over=o.over,f.split=s.split,f.join=s.join,f.lines=s.lines,f.unlines=s.unlines,f.words=s.words,f.unwords=s.unwords,f.chars=s.chars,f.unchars=s.unchars,f.repeat=s.repeat,f.capitalize=s.capitalize,f.camelize=s.camelize,f.dasherize=s.dasherize,f.values=a.values,f.keys=a.keys,f.pairsToObj=a.pairsToObj,f.objToPairs=a.objToPairs,f.listsToObj=a.listsToObj,f.objToLists=a.objToLists,f.max=u.max,f.min=u.min,f.negate=u.negate,f.abs=u.abs,f.signum=u.signum,f.quot=u.quot,f.rem=u.rem,f.div=u.div,f.mod=u.mod,f.recip=u.recip,f.pi=u.pi,f.tau=u.tau,f.exp=u.exp,f.sqrt=u.sqrt,f.ln=u.ln,f.pow=u.pow,f.sin=u.sin,f.tan=u.tan,f.cos=u.cos,f.acos=u.acos,f.asin=u.asin,f.atan=u.atan,f.atan2=u.atan2,f.truncate=u.truncate,f.round=u.round,f.ceiling=u.ceiling,f.floor=u.floor,f.isItNaN=u.isItNaN,f.even=u.even,f.odd=u.odd,f.gcd=u.gcd,f.lcm=u.lcm,f.VERSION="1.1.2",e.exports=f},[212,3],function(e,t,n){(function(){function t(e,t){var n,r=function(o){return e.length>1?function(){var i=o?o.concat():[];return n=t?n||this:this,i.push.apply(i,arguments)<e.length&&arguments.length?r.call(n,i):e.apply(n,i)}:e};return r()}function r(e,t){var n={}.hasOwnProperty;for(var r in t)n.call(t,r)&&(e[r]=t[r]);return e}var o,i,a,s,u,l,c,p,f,d,h,v,m,g,y,b,C,_,w,E,x,T,O,P,k,S,N=[].slice,M={}.toString;o=n(14),i=o.all,a=o.any,s=o.concatMap,u=o.each,l=o.filter,c=o.find,p=o.isType,f=o.keys,d=o.map,h=o.Obj,v=o.objToPairs,m=o.partition,g=o.reverse,y=o.sortBy,b=t(function(e,t,n){return Math.max(t,Math.min(n,e))}),C=t(function(e,t,n){var r;return r=e.substr(n).indexOf(t),r===-1?[]:[n+r].concat(C(e,t,n+r+t.length))}),_=t(function(e,t){var n,r,o;return n=t[0],r=N.call(t,1),0===r.length?null!=(o=e[n])?o:null:"undefined"==typeof e[n]?null:_(e[n],r)}),w=function(e){var t;return t=function(e){return e.length}(f(h.filter(function(e){return!!e})(e))),0===t},E=t(function(e,t){return M.call(e).slice(8,-1)===M.call(t).slice(8,-1)&&(a(function(t){return p(t,e)})(["Boolean","Number","String","undefined"])?e===t:"Array"===M.call(e).slice(8,-1)?e.length===t.length&&i(function(n){return E(e[n],t[n])})(function(){var t,n,r=[];for(t=0,n=e.length;t<n;++t)r.push(t);return r}()):f(e).length===f(t).length&&i(function(n){return E(e[n],t[n])})(f(e)))}),x=t(function(e,t){var n,r,o,i,a,s;return 0===t.length?[[0,e.length]]:(n=C(e,t,0),r=n[0],o=n[n.length-1],0===n.length?[]:(i=o+t.length,a=d(function(e){return[e,e+t.length,!0]})(n),s=d(function(e){return[a[e][1],a[e+1][0],!1]})(function(){var e,t,n=[];for(e=0,t=a.length-1;e<t;++e)n.push(e);return n}()),(0===r?[]:[[0,r,!1]]).concat(y(function(e){return e[0]})(a.concat(s)),i===e.length?[]:[[i,e.length,!1]])))}),T=t(function(e,t,n,r){var o;return o=_(e,t),P(e,t,o?r(o,n):n)}),O=t(function(e,t){var n,o;return n=M.call(t).slice(8,-1),a(function(e){return e===n},["Boolean","Number","String","Function"])?t:null===e||"Undefined"===M.call(e).slice(8,-1)?t:(o=h.keys(t),0===o.length?e:(u(function(n){return e[n]=O(h.keys(e[n]).length>0?r({},e[n]):e[n],t[n])})(o),e))}),P=t(function(e,t,n){var r,o,i;return r=t[0],o=N.call(t,1),o.length>0?(e[r]=null!=(i=e[r])?i:{},P(e[r],o,n)):(e[r]=n,e)}),k=function(e){return d(function(t){return d(function(e){return e[t]})(e)})(f(e[0]))},S=t(function(e,n,r){var o;return(o=t(function(e,t,n,r,i){return s(function(i){var a,s;return a=i[0],s=i[1],n<r?o(e,t.concat(a),n+1,r,s):e(t.concat(a),s)})(v(i))}))(e,[],0,n,r)}),e.exports={clamp:b,findAll:C,get:_,isEmptyObject:w,isEqualToObject:E,mappend:T,partitionString:x,rextend:O,set:P,transpose:k,unwrap:S}}).call(this)},function(e,t,n){"use strict";e.exports=n(65)},function(e,t,n){"use strict";function r(e){if(m){var t=e.node,n=e.children;if(n.length)for(var r=0;r<n.length;r++)g(t,n[r],null);else null!=e.html?p(t,e.html):null!=e.text&&d(t,e.text)}}function o(e,t){e.parentNode.replaceChild(t.node,e),r(t)}function i(e,t){m?e.children.push(t):e.node.appendChild(t.node)}function a(e,t){m?e.html=t:p(e.node,t)}function s(e,t){m?e.text=t:d(e.node,t)}function u(){return this.node.nodeName}function l(e){return{node:e,children:[],html:null,text:null,toString:u}}var c=n(38),p=n(35),f=n(46),d=n(82),h=1,v=11,m="undefined"!=typeof document&&"number"==typeof document.documentMode||"undefined"!=typeof navigator&&"string"==typeof navigator.userAgent&&/\bEdge\/\d/.test(navigator.userAgent),g=f(function(e,t,n){t.node.nodeType===v||t.node.nodeType===h&&"object"===t.node.nodeName.toLowerCase()&&(null==t.node.namespaceURI||t.node.namespaceURI===c.html)?(r(t),e.insertBefore(t.node,n)):(e.insertBefore(t.node,n),r(t))});l.insertTreeBefore=g,l.replaceChildWithTree=o,l.queueChild=i,l.queueHTML=a,l.queueText=s,e.exports=l},function(e,t,n){"use strict";function r(e,t){return(e&t)===t}var o=n(3),i=(n(1),{MUST_USE_PROPERTY:1,HAS_BOOLEAN_VALUE:4,HAS_NUMERIC_VALUE:8,HAS_POSITIVE_NUMERIC_VALUE:24,HAS_OVERLOADED_BOOLEAN_VALUE:32,injectDOMPropertyConfig:function(e){var t=i,n=e.Properties||{},a=e.DOMAttributeNamespaces||{},u=e.DOMAttributeNames||{},l=e.DOMPropertyNames||{},c=e.DOMMutationMethods||{};e.isCustomAttribute&&s._isCustomAttributeFunctions.push(e.isCustomAttribute);for(var p in n){s.properties.hasOwnProperty(p)?o("48",p):void 0;var f=p.toLowerCase(),d=n[p],h={attributeName:f,attributeNamespace:null,propertyName:p,mutationMethod:null,mustUseProperty:r(d,t.MUST_USE_PROPERTY),hasBooleanValue:r(d,t.HAS_BOOLEAN_VALUE),hasNumericValue:r(d,t.HAS_NUMERIC_VALUE),hasPositiveNumericValue:r(d,t.HAS_POSITIVE_NUMERIC_VALUE),hasOverloadedBooleanValue:r(d,t.HAS_OVERLOADED_BOOLEAN_VALUE)};if(h.hasBooleanValue+h.hasNumericValue+h.hasOverloadedBooleanValue<=1?void 0:o("50",p),u.hasOwnProperty(p)){var v=u[p];h.attributeName=v}a.hasOwnProperty(p)&&(h.attributeNamespace=a[p]),l.hasOwnProperty(p)&&(h.propertyName=l[p]),c.hasOwnProperty(p)&&(h.mutationMethod=c[p]),s.properties[p]=h}}}),a=":A-Z_a-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD",s={ID_ATTRIBUTE_NAME:"data-reactid",ROOT_ATTRIBUTE_NAME:"data-reactroot",ATTRIBUTE_NAME_START_CHAR:a,ATTRIBUTE_NAME_CHAR:a+"\\-.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040",properties:{},getPossibleStandardName:null,_isCustomAttributeFunctions:[],isCustomAttribute:function(e){for(var t=0;t<s._isCustomAttributeFunctions.length;t++){var n=s._isCustomAttributeFunctions[t];if(n(e))return!0}return!1},injection:i};e.exports=s},function(e,t,n){"use strict";function r(){o.attachRefs(this,this._currentElement)}var o=n(155),i=(n(9),n(2),{mountComponent:function(e,t,n,o,i,a){var s=e.mountComponent(t,n,o,i,a);return e._currentElement&&null!=e._currentElement.ref&&t.getReactMountReady().enqueue(r,e),s},getHostNode:function(e){return e.getHostNode()},unmountComponent:function(e,t){o.detachRefs(e,e._currentElement),e.unmountComponent(t)},receiveComponent:function(e,t,n,i){var a=e._currentElement;if(t!==a||i!==e._context){var s=o.shouldUpdateRefs(a,t);s&&o.detachRefs(e,a),e.receiveComponent(t,n,i),s&&e._currentElement&&null!=e._currentElement.ref&&n.getReactMountReady().enqueue(r,e)}},performUpdateIfNecessary:function(e,t,n){e._updateBatchNumber===n&&e.performUpdateIfNecessary(t)}});e.exports=i},function(e,t,n){"use strict";function r(e){return void 0!==e.ref}function o(e){return void 0!==e.key}var i=n(4),a=n(13),s=(n(2),n(88),Object.prototype.hasOwnProperty),u=n(87),l={key:!0,ref:!0,__self:!0,__source:!0},c=function(e,t,n,r,o,i,a){var s={$$typeof:u,type:e,key:t,ref:n,props:a,_owner:i};return s};c.createElement=function(e,t,n){var i,u={},p=null,f=null,d=null,h=null;if(null!=t){r(t)&&(f=t.ref),o(t)&&(p=""+t.key),d=void 0===t.__self?null:t.__self,h=void 0===t.__source?null:t.__source;for(i in t)s.call(t,i)&&!l.hasOwnProperty(i)&&(u[i]=t[i])}var v=arguments.length-2;if(1===v)u.children=n;else if(v>1){for(var m=Array(v),g=0;g<v;g++)m[g]=arguments[g+2];u.children=m}if(e&&e.defaultProps){var y=e.defaultProps;for(i in y)void 0===u[i]&&(u[i]=y[i])}return c(e,p,f,d,h,a.current,u)},c.createFactory=function(e){var t=c.createElement.bind(null,e);return t.type=e,t},c.cloneAndReplaceKey=function(e,t){var n=c(e.type,t,e.ref,e._self,e._source,e._owner,e.props);return n},c.cloneElement=function(e,t,n){var u,p=i({},e.props),f=e.key,d=e.ref,h=e._self,v=e._source,m=e._owner;if(null!=t){r(t)&&(d=t.ref,m=a.current),o(t)&&(f=""+t.key);var g;e.type&&e.type.defaultProps&&(g=e.type.defaultProps);for(u in t)s.call(t,u)&&!l.hasOwnProperty(u)&&(void 0===t[u]&&void 0!==g?p[u]=g[u]:p[u]=t[u])}var y=arguments.length-2;if(1===y)p.children=n;else if(y>1){for(var b=Array(y),C=0;C<y;C++)b[C]=arguments[C+2];p.children=b}return c(e.type,f,d,h,v,m,p)},c.isValidElement=function(e){return"object"==typeof e&&null!==e&&e.$$typeof===u},e.exports=c},3,function(e,t,n){"use strict";var r={};e.exports=r},function(e,t,n){"use strict";var r=n(117);e.exports=function(e){var t=!1;return r(e,t)}},function(e,t,n){"use strict";function r(e){return"button"===e||"input"===e||"select"===e||"textarea"===e}function o(e,t,n){switch(e){case"onClick":case"onClickCapture":case"onDoubleClick":case"onDoubleClickCapture":case"onMouseDown":case"onMouseDownCapture":case"onMouseMove":case"onMouseMoveCapture":case"onMouseUp":case"onMouseUpCapture":return!(!n.disabled||!r(t));default:return!1}}var i=n(3),a=n(39),s=n(40),u=n(44),l=n(75),c=n(76),p=(n(1),{}),f=null,d=function(e,t){e&&(s.executeDispatchesInOrder(e,t),e.isPersistent()||e.constructor.release(e))},h=function(e){return d(e,!0)},v=function(e){return d(e,!1)},m=function(e){return"."+e._rootNodeID},g={injection:{injectEventPluginOrder:a.injectEventPluginOrder,injectEventPluginsByName:a.injectEventPluginsByName},putListener:function(e,t,n){"function"!=typeof n?i("94",t,typeof n):void 0;var r=m(e),o=p[t]||(p[t]={});o[r]=n;var s=a.registrationNameModules[t];s&&s.didPutListener&&s.didPutListener(e,t,n)},getListener:function(e,t){var n=p[t];if(o(t,e._currentElement.type,e._currentElement.props))return null;var r=m(e);return n&&n[r]},deleteListener:function(e,t){var n=a.registrationNameModules[t];n&&n.willDeleteListener&&n.willDeleteListener(e,t);var r=p[t];if(r){var o=m(e);delete r[o]}},deleteAllListeners:function(e){var t=m(e);for(var n in p)if(p.hasOwnProperty(n)&&p[n][t]){var r=a.registrationNameModules[n];r&&r.willDeleteListener&&r.willDeleteListener(e,n),delete p[n][t]}},extractEvents:function(e,t,n,r){for(var o,i=a.plugins,s=0;s<i.length;s++){var u=i[s];if(u){var c=u.extractEvents(e,t,n,r);c&&(o=l(o,c))}}return o},enqueueEvents:function(e){e&&(f=l(f,e))},processEventQueue:function(e){var t=f;f=null,e?c(t,h):c(t,v),f?i("95"):void 0,u.rethrowCaughtError()},__purge:function(){p={}},__getListenerBank:function(){return p}};e.exports=g},function(e,t,n){"use strict";function r(e,t,n){var r=t.dispatchConfig.phasedRegistrationNames[n];return g(e,r)}function o(e,t,n){var o=r(e,n,t);o&&(n._dispatchListeners=v(n._dispatchListeners,o),n._dispatchInstances=v(n._dispatchInstances,e))}function i(e){e&&e.dispatchConfig.phasedRegistrationNames&&h.traverseTwoPhase(e._targetInst,o,e)}function a(e){if(e&&e.dispatchConfig.phasedRegistrationNames){var t=e._targetInst,n=t?h.getParentInstance(t):null;h.traverseTwoPhase(n,o,e)}}function s(e,t,n){if(n&&n.dispatchConfig.registrationName){var r=n.dispatchConfig.registrationName,o=g(e,r);o&&(n._dispatchListeners=v(n._dispatchListeners,o),n._dispatchInstances=v(n._dispatchInstances,e))}}function u(e){e&&e.dispatchConfig.registrationName&&s(e._targetInst,null,e)}function l(e){m(e,i)}function c(e){m(e,a)}function p(e,t,n,r){h.traverseEnterLeave(n,r,s,e,t)}function f(e){m(e,u)}var d=n(25),h=n(40),v=n(75),m=n(76),g=(n(2),d.getListener),y={accumulateTwoPhaseDispatches:l,accumulateTwoPhaseDispatchesSkipTarget:c,accumulateDirectDispatches:f,accumulateEnterLeaveDispatches:p};e.exports=y},function(e,t){"use strict";var n={remove:function(e){e._reactInternalInstance=void 0},get:function(e){return e._reactInternalInstance},has:function(e){return void 0!==e._reactInternalInstance},set:function(e,t){e._reactInternalInstance=t}};e.exports=n},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(11),i=n(49),a={view:function(e){if(e.view)return e.view;var t=i(e);if(t.window===t)return t;var n=t.ownerDocument;return n?n.defaultView||n.parentWindow:window},detail:function(e){return e.detail||0}};o.augmentClass(r,a),e.exports=r},function(e,t,n){(function(){var e,r,o,i,a,s,u,l="undefined"!=typeof t&&t||this;e=n(14),r=e.filter,o=e.map,i=e.objToPairs,a=e.Str,l.cancelEvent=s=function(e){e.preventDefault(),e.stopPropagation()},l.classNameFromObject=u=function(e){return a.join(" ")(o(function(e){return e[0]})(r(function(e){return!!e[1]})(i(e))))}}).call(this)},function(e,t){"use strict";function n(e,t){return e===t?0!==e||0!==t||1/e===1/t:e!==e&&t!==t}function r(e,t){if(n(e,t))return!0;if("object"!=typeof e||null===e||"object"!=typeof t||null===t)return!1;var r=Object.keys(e),i=Object.keys(t);if(r.length!==i.length)return!1;for(var a=0;a<r.length;a++)if(!o.call(t,r[a])||!n(e[r[a]],t[r[a]]))return!1;return!0}var o=Object.prototype.hasOwnProperty;e.exports=r},function(e,t,n){"use strict";function r(e){return Object.prototype.hasOwnProperty.call(e,v)||(e[v]=d++,p[e[v]]={}),p[e[v]]}var o,i=n(4),a=n(39),s=n(147),u=n(74),l=n(79),c=n(50),p={},f=!1,d=0,h={topAbort:"abort",topAnimationEnd:l("animationend")||"animationend",topAnimationIteration:l("animationiteration")||"animationiteration",topAnimationStart:l("animationstart")||"animationstart",topBlur:"blur",topCanPlay:"canplay",topCanPlayThrough:"canplaythrough",topChange:"change",topClick:"click",topCompositionEnd:"compositionend",topCompositionStart:"compositionstart",topCompositionUpdate:"compositionupdate",topContextMenu:"contextmenu",topCopy:"copy",topCut:"cut",topDoubleClick:"dblclick",topDrag:"drag",topDragEnd:"dragend",topDragEnter:"dragenter",topDragExit:"dragexit",topDragLeave:"dragleave",topDragOver:"dragover",topDragStart:"dragstart",topDrop:"drop",topDurationChange:"durationchange",topEmptied:"emptied",topEncrypted:"encrypted",topEnded:"ended",topError:"error",topFocus:"focus",topInput:"input",topKeyDown:"keydown",topKeyPress:"keypress",topKeyUp:"keyup",topLoadedData:"loadeddata",topLoadedMetadata:"loadedmetadata",topLoadStart:"loadstart",topMouseDown:"mousedown",topMouseMove:"mousemove",topMouseOut:"mouseout",topMouseOver:"mouseover",topMouseUp:"mouseup",topPaste:"paste",topPause:"pause",topPlay:"play",topPlaying:"playing",topProgress:"progress",topRateChange:"ratechange",topScroll:"scroll",topSeeked:"seeked",topSeeking:"seeking",topSelectionChange:"selectionchange",topStalled:"stalled",topSuspend:"suspend",topTextInput:"textInput",topTimeUpdate:"timeupdate",topTouchCancel:"touchcancel",topTouchEnd:"touchend",topTouchMove:"touchmove",topTouchStart:"touchstart",topTransitionEnd:l("transitionend")||"transitionend",topVolumeChange:"volumechange",topWaiting:"waiting",topWheel:"wheel"},v="_reactListenersID"+String(Math.random()).slice(2),m=i({},s,{ReactEventListener:null,injection:{injectReactEventListener:function(e){e.setHandleTopLevel(m.handleTopLevel),m.ReactEventListener=e}},setEnabled:function(e){m.ReactEventListener&&m.ReactEventListener.setEnabled(e)},isEnabled:function(){return!(!m.ReactEventListener||!m.ReactEventListener.isEnabled())},listenTo:function(e,t){for(var n=t,o=r(n),i=a.registrationNameDependencies[e],s=0;s<i.length;s++){var u=i[s];o.hasOwnProperty(u)&&o[u]||("topWheel"===u?c("wheel")?m.ReactEventListener.trapBubbledEvent("topWheel","wheel",n):c("mousewheel")?m.ReactEventListener.trapBubbledEvent("topWheel","mousewheel",n):m.ReactEventListener.trapBubbledEvent("topWheel","DOMMouseScroll",n):"topScroll"===u?c("scroll",!0)?m.ReactEventListener.trapCapturedEvent("topScroll","scroll",n):m.ReactEventListener.trapBubbledEvent("topScroll","scroll",m.ReactEventListener.WINDOW_HANDLE):"topFocus"===u||"topBlur"===u?(c("focus",!0)?(m.ReactEventListener.trapCapturedEvent("topFocus","focus",n),m.ReactEventListener.trapCapturedEvent("topBlur","blur",n)):c("focusin")&&(m.ReactEventListener.trapBubbledEvent("topFocus","focusin",n),m.ReactEventListener.trapBubbledEvent("topBlur","focusout",n)),o.topBlur=!0,o.topFocus=!0):h.hasOwnProperty(u)&&m.ReactEventListener.trapBubbledEvent(u,h[u],n),o[u]=!0)}},trapBubbledEvent:function(e,t,n){return m.ReactEventListener.trapBubbledEvent(e,t,n)},trapCapturedEvent:function(e,t,n){return m.ReactEventListener.trapCapturedEvent(e,t,n)},supportsEventPageXY:function(){if(!document.createEvent)return!1;var e=document.createEvent("MouseEvent");return null!=e&&"pageX"in e},ensureScrollValueMonitoring:function(){if(void 0===o&&(o=m.supportsEventPageXY()),!o&&!f){var e=u.refreshScrollValues;m.ReactEventListener.monitorScrollValue(e),f=!0}}});e.exports=m},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(28),i=n(74),a=n(48),s={screenX:null,screenY:null,clientX:null,clientY:null,ctrlKey:null,shiftKey:null,altKey:null,metaKey:null,getModifierState:a,button:function(e){var t=e.button;return"which"in e?t:2===t?2:4===t?1:0},buttons:null,relatedTarget:function(e){return e.relatedTarget||(e.fromElement===e.srcElement?e.toElement:e.fromElement)},pageX:function(e){return"pageX"in e?e.pageX:e.clientX+i.currentScrollLeft},pageY:function(e){return"pageY"in e?e.pageY:e.clientY+i.currentScrollTop}};o.augmentClass(r,s),e.exports=r},function(e,t,n){"use strict";var r=n(3),o=(n(1),{}),i={reinitializeTransaction:function(){this.transactionWrappers=this.getTransactionWrappers(),this.wrapperInitData?this.wrapperInitData.length=0:this.wrapperInitData=[],this._isInTransaction=!1},_isInTransaction:!1,getTransactionWrappers:null,isInTransaction:function(){return!!this._isInTransaction},perform:function(e,t,n,o,i,a,s,u){this.isInTransaction()?r("27"):void 0;var l,c;try{this._isInTransaction=!0,l=!0,this.initializeAll(0),c=e.call(t,n,o,i,a,s,u),l=!1}finally{try{if(l)try{this.closeAll(0)}catch(e){}else this.closeAll(0)}finally{this._isInTransaction=!1}}return c},initializeAll:function(e){for(var t=this.transactionWrappers,n=e;n<t.length;n++){var r=t[n];try{this.wrapperInitData[n]=o,this.wrapperInitData[n]=r.initialize?r.initialize.call(this):null}finally{if(this.wrapperInitData[n]===o)try{this.initializeAll(n+1)}catch(e){}}}},closeAll:function(e){this.isInTransaction()?void 0:r("28");for(var t=this.transactionWrappers,n=e;n<t.length;n++){var i,a=t[n],s=this.wrapperInitData[n];try{i=!0,s!==o&&a.close&&a.close.call(this,s),i=!1}finally{if(i)try{this.closeAll(n+1)}catch(e){}}}this.wrapperInitData.length=0}};e.exports=i},function(e,t){"use strict";function n(e){var t=""+e,n=o.exec(t);if(!n)return t;var r,i="",a=0,s=0;for(a=n.index;a<t.length;a++){switch(t.charCodeAt(a)){case 34:r="&quot;";break;case 38:r="&amp;";break;case 39:r="&#x27;";break;case 60:r="&lt;";break;case 62:r="&gt;";break;default:continue}s!==a&&(i+=t.substring(s,a)),s=a+1,i+=r}return s!==a?i+t.substring(s,a):i}function r(e){return"boolean"==typeof e||"number"==typeof e?""+e:n(e)}var o=/["'&<>]/;e.exports=r},function(e,t,n){"use strict";var r,o=n(7),i=n(38),a=/^[ \r\n\t\f]/,s=/<(!--|link|noscript|meta|script|style)[ \r\n\t\f\/>]/,u=n(46),l=u(function(e,t){if(e.namespaceURI!==i.svg||"innerHTML"in e)e.innerHTML=t;else{r=r||document.createElement("div"),r.innerHTML="<svg>"+t+"</svg>";for(var n=r.firstChild;n.firstChild;)e.appendChild(n.firstChild)}});if(o.canUseDOM){var c=document.createElement("div");c.innerHTML=" ",""===c.innerHTML&&(l=function(e,t){if(e.parentNode&&e.parentNode.replaceChild(e,e),a.test(t)||"<"===t[0]&&s.test(t)){e.innerHTML=String.fromCharCode(65279)+t;var n=e.firstChild;1===n.data.length?e.removeChild(n):n.deleteData(0,1)}else e.innerHTML=t}),c=null}e.exports=l},function(e,t){function n(){throw new Error("setTimeout has not been defined")}function r(){throw new Error("clearTimeout has not been defined")}function o(e){if(c===setTimeout)return setTimeout(e,0);if((c===n||!c)&&setTimeout)return c=setTimeout,setTimeout(e,0);try{return c(e,0)}catch(t){try{return c.call(null,e,0)}catch(t){return c.call(this,e,0)}}}function i(e){if(p===clearTimeout)return clearTimeout(e);if((p===r||!p)&&clearTimeout)return p=clearTimeout,clearTimeout(e);try{return p(e)}catch(t){try{return p.call(null,e)}catch(t){return p.call(this,e)}}}function a(){v&&d&&(v=!1,d.length?h=d.concat(h):m=-1,h.length&&s())}function s(){if(!v){var e=o(a);v=!0;for(var t=h.length;t;){for(d=h,h=[];++m<t;)d&&d[m].run();m=-1,t=h.length}d=null,v=!1,i(e)}}function u(e,t){this.fun=e,this.array=t}function l(){}var c,p,f=e.exports={};!function(){try{c="function"==typeof setTimeout?setTimeout:n}catch(e){c=n}try{p="function"==typeof clearTimeout?clearTimeout:r}catch(e){p=r}}();var d,h=[],v=!1,m=-1;f.nextTick=function(e){var t=new Array(arguments.length-1);if(arguments.length>1)for(var n=1;n<arguments.length;n++)t[n-1]=arguments[n];h.push(new u(e,t)),
-1!==h.length||v||o(s)},u.prototype.run=function(){this.fun.apply(null,this.array)},f.title="browser",f.browser=!0,f.env={},f.argv=[],f.version="",f.versions={},f.on=l,f.addListener=l,f.once=l,f.off=l,f.removeListener=l,f.removeAllListeners=l,f.emit=l,f.prependListener=l,f.prependOnceListener=l,f.listeners=function(e){return[]},f.binding=function(e){throw new Error("process.binding is not supported")},f.cwd=function(){return"/"},f.chdir=function(e){throw new Error("process.chdir is not supported")},f.umask=function(){return 0}},function(e,t,n){"use strict";function r(e,t){return Array.isArray(t)&&(t=t[1]),t?t.nextSibling:e.firstChild}function o(e,t,n){c.insertTreeBefore(e,t,n)}function i(e,t,n){Array.isArray(t)?s(e,t[0],t[1],n):v(e,t,n)}function a(e,t){if(Array.isArray(t)){var n=t[1];t=t[0],u(e,t,n),e.removeChild(n)}e.removeChild(t)}function s(e,t,n,r){for(var o=t;;){var i=o.nextSibling;if(v(e,o,r),o===n)break;o=i}}function u(e,t,n){for(;;){var r=t.nextSibling;if(r===n)break;e.removeChild(r)}}function l(e,t,n){var r=e.parentNode,o=e.nextSibling;o===t?n&&v(r,document.createTextNode(n),o):n?(h(o,n),u(r,o,t)):u(r,e,t)}var c=n(18),p=n(125),f=(n(5),n(9),n(46)),d=n(35),h=n(82),v=f(function(e,t,n){e.insertBefore(t,n)}),m=p.dangerouslyReplaceNodeWithMarkup,g={dangerouslyReplaceNodeWithMarkup:m,replaceDelimitedText:l,processUpdates:function(e,t){for(var n=0;n<t.length;n++){var s=t[n];switch(s.type){case"INSERT_MARKUP":o(e,s.content,r(e,s.afterNode));break;case"MOVE_EXISTING":i(e,s.fromNode,r(e,s.afterNode));break;case"SET_MARKUP":d(e,s.content);break;case"TEXT_CONTENT":h(e,s.content);break;case"REMOVE_NODE":a(e,s.fromNode)}}}};e.exports=g},function(e,t){"use strict";var n={html:"http://www.w3.org/1999/xhtml",mathml:"http://www.w3.org/1998/Math/MathML",svg:"http://www.w3.org/2000/svg"};e.exports=n},function(e,t,n){"use strict";function r(){if(s)for(var e in u){var t=u[e],n=s.indexOf(e);if(n>-1?void 0:a("96",e),!l.plugins[n]){t.extractEvents?void 0:a("97",e),l.plugins[n]=t;var r=t.eventTypes;for(var i in r)o(r[i],t,i)?void 0:a("98",i,e)}}}function o(e,t,n){l.eventNameDispatchConfigs.hasOwnProperty(n)?a("99",n):void 0,l.eventNameDispatchConfigs[n]=e;var r=e.phasedRegistrationNames;if(r){for(var o in r)if(r.hasOwnProperty(o)){var s=r[o];i(s,t,n)}return!0}return!!e.registrationName&&(i(e.registrationName,t,n),!0)}function i(e,t,n){l.registrationNameModules[e]?a("100",e):void 0,l.registrationNameModules[e]=t,l.registrationNameDependencies[e]=t.eventTypes[n].dependencies}var a=n(3),s=(n(1),null),u={},l={plugins:[],eventNameDispatchConfigs:{},registrationNameModules:{},registrationNameDependencies:{},possibleRegistrationNames:null,injectEventPluginOrder:function(e){s?a("101"):void 0,s=Array.prototype.slice.call(e),r()},injectEventPluginsByName:function(e){var t=!1;for(var n in e)if(e.hasOwnProperty(n)){var o=e[n];u.hasOwnProperty(n)&&u[n]===o||(u[n]?a("102",n):void 0,u[n]=o,t=!0)}t&&r()},getPluginModuleForEvent:function(e){var t=e.dispatchConfig;if(t.registrationName)return l.registrationNameModules[t.registrationName]||null;if(void 0!==t.phasedRegistrationNames){var n=t.phasedRegistrationNames;for(var r in n)if(n.hasOwnProperty(r)){var o=l.registrationNameModules[n[r]];if(o)return o}}return null},_resetEventPlugins:function(){s=null;for(var e in u)u.hasOwnProperty(e)&&delete u[e];l.plugins.length=0;var t=l.eventNameDispatchConfigs;for(var n in t)t.hasOwnProperty(n)&&delete t[n];var r=l.registrationNameModules;for(var o in r)r.hasOwnProperty(o)&&delete r[o]}};e.exports=l},function(e,t,n){"use strict";function r(e){return"topMouseUp"===e||"topTouchEnd"===e||"topTouchCancel"===e}function o(e){return"topMouseMove"===e||"topTouchMove"===e}function i(e){return"topMouseDown"===e||"topTouchStart"===e}function a(e,t,n,r){var o=e.type||"unknown-event";e.currentTarget=g.getNodeFromInstance(r),t?v.invokeGuardedCallbackWithCatch(o,n,e):v.invokeGuardedCallback(o,n,e),e.currentTarget=null}function s(e,t){var n=e._dispatchListeners,r=e._dispatchInstances;if(Array.isArray(n))for(var o=0;o<n.length&&!e.isPropagationStopped();o++)a(e,t,n[o],r[o]);else n&&a(e,t,n,r);e._dispatchListeners=null,e._dispatchInstances=null}function u(e){var t=e._dispatchListeners,n=e._dispatchInstances;if(Array.isArray(t)){for(var r=0;r<t.length&&!e.isPropagationStopped();r++)if(t[r](e,n[r]))return n[r]}else if(t&&t(e,n))return n;return null}function l(e){var t=u(e);return e._dispatchInstances=null,e._dispatchListeners=null,t}function c(e){var t=e._dispatchListeners,n=e._dispatchInstances;Array.isArray(t)?h("103"):void 0,e.currentTarget=t?g.getNodeFromInstance(n):null;var r=t?t(e):null;return e.currentTarget=null,e._dispatchListeners=null,e._dispatchInstances=null,r}function p(e){return!!e._dispatchListeners}var f,d,h=n(3),v=n(44),m=(n(1),n(2),{injectComponentTree:function(e){f=e},injectTreeTraversal:function(e){d=e}}),g={isEndish:r,isMoveish:o,isStartish:i,executeDirectDispatch:c,executeDispatchesInOrder:s,executeDispatchesInOrderStopAtTrue:l,hasDispatches:p,getInstanceFromNode:function(e){return f.getInstanceFromNode(e)},getNodeFromInstance:function(e){return f.getNodeFromInstance(e)},isAncestor:function(e,t){return d.isAncestor(e,t)},getLowestCommonAncestor:function(e,t){return d.getLowestCommonAncestor(e,t)},getParentInstance:function(e){return d.getParentInstance(e)},traverseTwoPhase:function(e,t,n){return d.traverseTwoPhase(e,t,n)},traverseEnterLeave:function(e,t,n,r,o){return d.traverseEnterLeave(e,t,n,r,o)},injection:m};e.exports=g},function(e,t){"use strict";function n(e){var t=/[=:]/g,n={"=":"=0",":":"=2"},r=(""+e).replace(t,function(e){return n[e]});return"$"+r}function r(e){var t=/(=0|=2)/g,n={"=0":"=","=2":":"},r="."===e[0]&&"$"===e[1]?e.substring(2):e.substring(1);return(""+r).replace(t,function(e){return n[e]})}var o={escape:n,unescape:r};e.exports=o},function(e,t,n){"use strict";function r(e){null!=e.checkedLink&&null!=e.valueLink?s("87"):void 0}function o(e){r(e),null!=e.value||null!=e.onChange?s("88"):void 0}function i(e){r(e),null!=e.checked||null!=e.onChange?s("89"):void 0}function a(e){if(e){var t=e.getName();if(t)return" Check the render method of `"+t+"`."}return""}var s=n(3),u=n(153),l=n(24),c=n(12),p=l(c.isValidElement),f=(n(1),n(2),{button:!0,checkbox:!0,image:!0,hidden:!0,radio:!0,reset:!0,submit:!0}),d={value:function(e,t,n){return!e[t]||f[e.type]||e.onChange||e.readOnly||e.disabled?null:new Error("You provided a `value` prop to a form field without an `onChange` handler. This will render a read-only field. If the field should be mutable use `defaultValue`. Otherwise, set either `onChange` or `readOnly`.")},checked:function(e,t,n){return!e[t]||e.onChange||e.readOnly||e.disabled?null:new Error("You provided a `checked` prop to a form field without an `onChange` handler. This will render a read-only field. If the field should be mutable use `defaultChecked`. Otherwise, set either `onChange` or `readOnly`.")},onChange:p.func},h={},v={checkPropTypes:function(e,t,n){for(var r in d){if(d.hasOwnProperty(r))var o=d[r](t,r,e,"prop",null,u);if(o instanceof Error&&!(o.message in h)){h[o.message]=!0;a(n)}}},getValue:function(e){return e.valueLink?(o(e),e.valueLink.value):e.value},getChecked:function(e){return e.checkedLink?(i(e),e.checkedLink.value):e.checked},executeOnChange:function(e,t){return e.valueLink?(o(e),e.valueLink.requestChange(t.target.value)):e.checkedLink?(i(e),e.checkedLink.requestChange(t.target.checked)):e.onChange?e.onChange.call(void 0,t):void 0}};e.exports=v},function(e,t,n){"use strict";var r=n(3),o=(n(1),!1),i={replaceNodeWithMarkup:null,processChildrenUpdates:null,injection:{injectEnvironment:function(e){o?r("104"):void 0,i.replaceNodeWithMarkup=e.replaceNodeWithMarkup,i.processChildrenUpdates=e.processChildrenUpdates,o=!0}}};e.exports=i},function(e,t,n){"use strict";function r(e,t,n){try{t(n)}catch(e){null===o&&(o=e)}}var o=null,i={invokeGuardedCallback:r,invokeGuardedCallbackWithCatch:r,rethrowCaughtError:function(){if(o){var e=o;throw o=null,e}}};e.exports=i},function(e,t,n){"use strict";function r(e){u.enqueueUpdate(e)}function o(e){var t=typeof e;if("object"!==t)return t;var n=e.constructor&&e.constructor.name||t,r=Object.keys(e);return r.length>0&&r.length<20?n+" (keys: "+r.join(", ")+")":n}function i(e,t){var n=s.get(e);if(!n){return null}return n}var a=n(3),s=(n(13),n(27)),u=(n(9),n(10)),l=(n(1),n(2),{isMounted:function(e){var t=s.get(e);return!!t&&!!t._renderedComponent},enqueueCallback:function(e,t,n){l.validateCallback(t,n);var o=i(e);return o?(o._pendingCallbacks?o._pendingCallbacks.push(t):o._pendingCallbacks=[t],void r(o)):null},enqueueCallbackInternal:function(e,t){e._pendingCallbacks?e._pendingCallbacks.push(t):e._pendingCallbacks=[t],r(e)},enqueueForceUpdate:function(e){var t=i(e,"forceUpdate");t&&(t._pendingForceUpdate=!0,r(t))},enqueueReplaceState:function(e,t,n){var o=i(e,"replaceState");o&&(o._pendingStateQueue=[t],o._pendingReplaceState=!0,void 0!==n&&null!==n&&(l.validateCallback(n,"replaceState"),o._pendingCallbacks?o._pendingCallbacks.push(n):o._pendingCallbacks=[n]),r(o))},enqueueSetState:function(e,t){var n=i(e,"setState");if(n){var o=n._pendingStateQueue||(n._pendingStateQueue=[]);o.push(t),r(n)}},enqueueElementInternal:function(e,t,n){e._pendingElement=t,e._context=n,r(e)},validateCallback:function(e,t){e&&"function"!=typeof e?a("122",t,o(e)):void 0}});e.exports=l},function(e,t){"use strict";var n=function(e){return"undefined"!=typeof MSApp&&MSApp.execUnsafeLocalFunction?function(t,n,r,o){MSApp.execUnsafeLocalFunction(function(){return e(t,n,r,o)})}:e};e.exports=n},function(e,t){"use strict";function n(e){var t,n=e.keyCode;return"charCode"in e?(t=e.charCode,0===t&&13===n&&(t=13)):t=n,t>=32||13===t?t:0}e.exports=n},function(e,t){"use strict";function n(e){var t=this,n=t.nativeEvent;if(n.getModifierState)return n.getModifierState(e);var r=o[e];return!!r&&!!n[r]}function r(e){return n}var o={Alt:"altKey",Control:"ctrlKey",Meta:"metaKey",Shift:"shiftKey"};e.exports=r},function(e,t){"use strict";function n(e){var t=e.target||e.srcElement||window;return t.correspondingUseElement&&(t=t.correspondingUseElement),3===t.nodeType?t.parentNode:t}e.exports=n},function(e,t,n){"use strict";function r(e,t){if(!i.canUseDOM||t&&!("addEventListener"in document))return!1;var n="on"+e,r=n in document;if(!r){var a=document.createElement("div");a.setAttribute(n,"return;"),r="function"==typeof a[n]}return!r&&o&&"wheel"===e&&(r=document.implementation.hasFeature("Events.wheel","3.0")),r}var o,i=n(7);i.canUseDOM&&(o=document.implementation&&document.implementation.hasFeature&&document.implementation.hasFeature("","")!==!0),e.exports=r},function(e,t){"use strict";function n(e,t){var n=null===e||e===!1,r=null===t||t===!1;if(n||r)return n===r;var o=typeof e,i=typeof t;return"string"===o||"number"===o?"string"===i||"number"===i:"object"===i&&e.type===t.type&&e.key===t.key}e.exports=n},function(e,t,n){"use strict";var r=(n(4),n(8)),o=(n(2),r);e.exports=o},function(e,t,n){(function(){function t(e,t){var n={}.hasOwnProperty;for(var r in t)n.call(t,r)&&(e[r]=t[r]);return e}function r(e,t){for(var n=-1,r=t.length>>>0;++n<r;)if(e===t[n])return!0;return!1}var o,i,a,s,u,l,c,p,f,d,h,v,m,g,y,b,C,_,w,E,x,T,O,P,k,S,N,M,A,I,D,R,L,U,F,j,B;o=n(14),i=o.each,a=o.filter,s=o.find,u=o.findIndex,l=o.id,c=o.initial,p=o.last,f=o.map,d=o.objToPairs,h=o.partition,v=o.reject,m=o.reverse,g=o.Str,y=o.sortBy,b=o.sum,C=o.values,o=n(16),_=o.clamp,w=o.isEqualToObject,E=n(6),o=E.DOM,x=o.div,T=o.input,O=o.path,P=o.span,k=o.svg,S=E.createClass,N=E.createFactory,M=n(17).findDOMNode,A=N(n(61)),I=N(n(190)),D=N(n(183)),R=N(n(84)),L=N(n(191)),U=N(n(187)),F=N(n(188)),o=n(29),j=o.cancelEvent,B=o.classNameFromObject,e.exports=S({displayName:"ReactSelectize",focusLock:!1,getDefaultProps:function(){return{anchor:null,autofocus:!1,cancelKeyboardEventOnSelection:!0,delimiters:[],disabled:!1,dropdownDirection:1,firstOptionIndexToHighlight:function(e){return 0},groupId:function(e){return e.groupId},groupsAsColumns:!1,highlightedUid:void 0,inputProps:{},onAnchorChange:function(e){},onBlur:function(e){},onEnter:function(e){},onFocus:function(e){},onHighlightedUidChange:function(e,t){},onKeyboardSelectionFailed:function(e){},onOpenChange:function(e,t){},onPaste:function(e){},onScrollLockChange:function(e){},onSearchChange:function(e,t){},onValuesChange:function(e,t){},open:!1,hideResetButton:!1,renderValue:function(e){var t;return t=e.label,x({className:"simple-value"},P(null,t))},renderToggleButton:I,renderResetButton:U,scrollLock:!1,search:"",style:{},theme:"default",uid:l,values:[]}},render:function(){var e,n,r,o,i,a=this;return e=function(){var e;switch(!1){case!("undefined"==typeof this.props.anchor||null===this.props.anchor):return-1;default:return null!=(e=u(function(e){return a.isEqualToObject(e,a.props.anchor)},this.props.values))?e:this.props.values.length-1}}.call(this),n=function(e){return f(function(e){var t,n;return t=a.props.values[e],n=a.props.uid(t),L({key:a.uidToString(n),uid:n,item:t,renderItem:a.props.renderValue})})(e)},r=this.props.dropdownDirection===-1,x({className:B((o={"react-selectize":1},o[this.props.theme+""]=1,o["root-node"]=1,o[this.props.className+""]=1,o.disabled=this.props.disabled,o.open=this.props.open,o.flipped=r,o.tethered=this.props.tether,o)),style:this.props.style},this.props.name?T({type:"hidden",name:this.props.name,value:this.props.serialize(this.props.values)}):void 0,x({className:"react-selectize-control",ref:"control",onMouseDown:function(e){if(function(){return a.props.onAnchorChange(p(a.props.values),function(){return a.onOpenChange(!0,function(){return a.highlightAndFocus()})})}(),!a.props.open)return j(e)}},0===this.props.search.length&&0===this.props.values.length?x({className:"react-selectize-placeholder"},this.props.placeholder):void 0,x({className:"react-selectize-search-field-and-selected-values"},n(function(){var t,n,r=[];for(t=0,n=e;t<=n;++t)r.push(t);return r}()),F((o=t({disabled:this.props.disabled},this.props.inputProps),o.ref="search",o.type="text",o.value=this.props.search,o.onChange=function(e){var t;return t=e.currentTarget.value,a.props.onSearchChange(t,function(){return a.highlightAndScrollToSelectableOption(a.props.firstOptionIndexToHighlight(a.props.options),1)})},o.onFocus=function(e){!function(){return function(e){return a.focusLock?e(a.focusLock=!1):a.onOpenChange(!0,function(){return e(!0)})}}()(function(){return a.props.onFocus(e)})},o.onBlur=function(e){if(!a.refs.dropdownMenu||document.activeElement!==M(a.refs.dropdownMenu))return a.closeDropdown(function(){return a.props.onBlur(e)})},o.onPaste=this.props.onPaste,o.onKeyDown=function(t){return a.handleKeydown({anchorIndex:e},t)},o)),n(function(){var t,n,r=[];for(t=e+1,n=this.props.values.length;t<n;++t)r.push(t);return r}.call(this))),this.props.values.length>0&&!this.props.hideResetButton?x({className:"react-selectize-reset-button-container",onClick:function(e){return function(){return a.props.onValuesChange([],function(){return a.props.onSearchChange("",function(){return a.highlightAndFocus()})})}(),j(e)}},this.props.renderResetButton()):void 0,x({className:"react-selectize-toggle-button-container",onMouseDown:function(e){return a.props.open?a.onOpenChange(!1,function(){}):a.props.onAnchorChange(p(a.props.values),function(){return a.onOpenChange(!0,function(){})}),j(e)}},this.props.renderToggleButton({open:this.props.open,flipped:r}))),D((o=t({},this.props),o.ref="dropdownMenu",o.className=B((i={"react-selectize":1},i[this.props.className+""]=1,i)),o.theme=this.props.theme,o.scrollLock=this.props.scrollLock,o.onScrollChange=this.props.onScrollChange,o.bottomAnchor=function(){return M(a.refs.control)},o.tetherProps=(i=t({},this.props.tetherProps),i.target=function(){return M(a.refs.control)},i),o.highlightedUid=this.props.highlightedUid,o.onHighlightedUidChange=this.props.onHighlightedUidChange,o.onOptionClick=function(t){a.selectHighlightedUid(e,function(){})},o)))},handleKeydown:function(e,t){var n,o,i,a=this;switch(n=e.anchorIndex,t.persist(),t.which){case 8:if(this.props.search.length>0||n===-1)return;!function(){var e,t,r,o;return e=n,t=n-1<0?void 0:a.props.values[n-1],r=a.props.values[n],a.props.onValuesChange(null!=(o=v(function(e){return a.isEqualToObject(e,r)})(a.props.values))?o:[],function(){return function(){return function(e){return"undefined"==typeof s(function(e){return a.isEqualToObject(e,r)},a.props.values)?a.props.restoreOnBackspace?a.props.onSearchChange(a.props.restoreOnBackspace(r),function(){return e(!0)}):e(!0):e(!1)}}()(function(r){if(r&&(a.highlightAndScrollToSelectableOption(a.props.firstOptionIndexToHighlight(a.props.options),1),n===e&&("undefined"==typeof t||s(function(e){return a.isEqualToObject(e,t)})(a.props.values))))return a.props.onAnchorChange(t,function(){})})})}(),j(t);break;case 27:!function(){return a.props.open?function(e){return a.onOpenChange(!1,e)}:function(e){return a.props.onValuesChange([],e)}}()(function(){return a.props.onSearchChange("",function(){return a.focusOnInput()})})}if(this.props.open&&r(t.which,[13].concat(this.props.delimiters))&&!(null!=t&&t.metaKey||null!=t&&t.ctrlKey||null!=t&&t.shiftKey)&&(o=this.selectHighlightedUid(n,function(e){if("undefined"==typeof e)return a.props.onKeyboardSelectionFailed(t.which)}),o&&this.props.cancelKeyboardEventOnSelection))return j(t);if(0===this.props.search.length)switch(t.which){case 37:this.props.onAnchorChange(n-1<0||t.metaKey?void 0:this.props.values[_(n-1,0,this.props.values.length-1)],function(){});break;case 39:this.props.onAnchorChange(t.metaKey?p(this.props.values):this.props.values[_(n+1,0,this.props.values.length-1)],function(){})}switch(t.which){case 38:return this.props.onScrollLockChange(!0),i=function(){switch(!1){case"undefined"!=typeof this.props.highlightedUid:return 0;default:return-1+this.optionIndexFromUid(this.props.highlightedUid)}}.call(this),this.highlightAndScrollToSelectableOption(i,-1,function(e){if(!e)return a.highlightAndScrollToSelectableOption(a.props.options.length-1,-1)});case 40:return this.props.onScrollLockChange(!0),i=function(){switch(!1){case"undefined"!=typeof this.props.highlightedUid:return 0;default:return 1+this.optionIndexFromUid(this.props.highlightedUid)}}.call(this),this.highlightAndScrollToSelectableOption(i,1,function(e){if(!e)return a.highlightAndScrollToSelectableOption(0,1)})}},componentDidMount:function(){this.props.autofocus&&this.focus(),this.props.open&&this.highlightAndFocus()},componentDidUpdate:function(e){this.props.open&&!e.open&&void 0===this.props.highlightedUid&&this.highlightAndFocus(),!this.props.open&&e.open&&this.props.onHighlightedUidChange(void 0,function(){})},componentWillReceiveProps:function(e){"undefined"!=typeof this.props.disabled&&this.props.disabled!==!1||"undefined"==typeof e.disabled||e.disabled!==!0||this.onOpenChange(!1,function(){})},optionIndexFromUid:function(e){var t=this;return u(function(n){return w(e,t.props.uid(n))})(this.props.options)},closeDropdown:function(e){var t=this;this.onOpenChange(!1,function(){return t.props.onAnchorChange(p(t.props.values),e)})},blur:function(){this.refs.search.blur()},focus:function(){this.refs.search.focus()},focusOnInput:function(){var e;e=M(this.refs.search),e!==document.activeElement&&(this.focusLock=!0,e.focus(),e.value=e.value)},highlightAndFocus:function(){this.highlightAndScrollToSelectableOption(this.props.firstOptionIndexToHighlight(this.props.options),1),this.focusOnInput()},highlightAndScrollToOption:function(e,t){null==t&&(t=function(){}),this.refs.dropdownMenu.highlightAndScrollToOption(e,t)},highlightAndScrollToSelectableOption:function(e,t,n){var r=this;null==n&&(n=function(){}),function(){return r.props.open?function(e){return e()}:function(e){return r.onOpenChange(!0,e)}}()(function(){return r.refs.dropdownMenu.highlightAndScrollToSelectableOption(e,t,n)})},isEqualToObject:function(){return w(this.props.uid(arguments[0]),this.props.uid(arguments[1]))},onOpenChange:function(e,t){return this.props.onOpenChange(!this.props.disabled&&e,t)},selectHighlightedUid:function(e,t){var n,r,o=this;return void 0===this.props.highlightedUid?(t(),!1):(n=this.optionIndexFromUid(this.props.highlightedUid),"number"!=typeof n?(t(),!1):(r=this.props.options[n],function(){return o.props.onValuesChange(f(function(e){return o.props.values[e]},function(){var t,n,r=[];for(t=0,n=e;t<=n;++t)r.push(t);return r}()).concat([r],f(function(e){return o.props.values[e]},function(){var t,n,r=[];for(t=e+1,n=this.props.values.length;t<n;++t)r.push(t);return r}.call(o))),function(){var e;return e=s(function(e){return o.isEqualToObject(e,r)},o.props.values),e?o.props.onSearchChange("",function(){return o.props.onAnchorChange(e,function(){return o.props.open?o.highlightAndScrollToSelectableOption(n,1,function(n){return n?void t(e):o.highlightAndScrollToSelectableOption(o.props.firstOptionIndexToHighlight(o.props.options),1,function(n){return n?t(e):o.onOpenChange(!1,function(){return t(e)})})}):void t(e)})}):void t()})}(),!0))},uidToString:function(e){return("object"==typeof e?JSON.stringify:l)(e)}})}).call(this)},function(e,t,n){"use strict";function r(e,t,n){this.props=e,this.context=t,this.refs=a,this.updater=n||i}var o=n(22),i=n(56),a=(n(88),n(23));n(1),n(2);r.prototype.isReactComponent={},r.prototype.setState=function(e,t){"object"!=typeof e&&"function"!=typeof e&&null!=e?o("85"):void 0,this.updater.enqueueSetState(this,e),t&&this.updater.enqueueCallback(this,t,"setState")},r.prototype.forceUpdate=function(e){this.updater.enqueueForceUpdate(this),e&&this.updater.enqueueCallback(this,e,"forceUpdate")};e.exports=r},function(e,t,n){"use strict";function r(e){var t=Function.prototype.toString,n=Object.prototype.hasOwnProperty,r=RegExp("^"+t.call(n).replace(/[\\^$.*+?()[\]{}|]/g,"\\$&").replace(/hasOwnProperty|(function).*?(?=\\\()| for .+?(?=\\\])/g,"$1.*?")+"$");try{var o=t.call(e);return r.test(o)}catch(e){return!1}}function o(e){var t=l(e);if(t){var n=t.childIDs;c(e),n.forEach(o)}}function i(e,t,n){return"\n    in "+(e||"Unknown")+(t?" (at "+t.fileName.replace(/^.*[\\\/]/,"")+":"+t.lineNumber+")":n?" (created by "+n+")":"")}function a(e){return null==e?"#empty":"string"==typeof e||"number"==typeof e?"#text":"string"==typeof e.type?e.type:e.type.displayName||e.type.name||"Unknown"}function s(e){var t,n=T.getDisplayName(e),r=T.getElement(e),o=T.getOwnerID(e);return o&&(t=T.getDisplayName(o)),i(n,r&&r._source,t)}var u,l,c,p,f,d,h,v=n(22),m=n(13),g=(n(1),n(2),"function"==typeof Array.from&&"function"==typeof Map&&r(Map)&&null!=Map.prototype&&"function"==typeof Map.prototype.keys&&r(Map.prototype.keys)&&"function"==typeof Set&&r(Set)&&null!=Set.prototype&&"function"==typeof Set.prototype.keys&&r(Set.prototype.keys));if(g){var y=new Map,b=new Set;u=function(e,t){y.set(e,t)},l=function(e){return y.get(e)},c=function(e){y.delete(e)},p=function(){return Array.from(y.keys())},f=function(e){b.add(e)},d=function(e){b.delete(e)},h=function(){return Array.from(b.keys())}}else{var C={},_={},w=function(e){return"."+e},E=function(e){return parseInt(e.substr(1),10)};u=function(e,t){var n=w(e);C[n]=t},l=function(e){var t=w(e);return C[t]},c=function(e){var t=w(e);delete C[t]},p=function(){return Object.keys(C).map(E)},f=function(e){var t=w(e);_[t]=!0},d=function(e){var t=w(e);delete _[t]},h=function(){return Object.keys(_).map(E)}}var x=[],T={onSetChildren:function(e,t){var n=l(e);n?void 0:v("144"),n.childIDs=t;for(var r=0;r<t.length;r++){var o=t[r],i=l(o);i?void 0:v("140"),null==i.childIDs&&"object"==typeof i.element&&null!=i.element?v("141"):void 0,i.isMounted?void 0:v("71"),null==i.parentID&&(i.parentID=e),i.parentID!==e?v("142",o,i.parentID,e):void 0}},onBeforeMountComponent:function(e,t,n){var r={element:t,parentID:n,text:null,childIDs:[],isMounted:!1,updateCount:0};u(e,r)},onBeforeUpdateComponent:function(e,t){var n=l(e);n&&n.isMounted&&(n.element=t)},onMountComponent:function(e){var t=l(e);t?void 0:v("144"),t.isMounted=!0;var n=0===t.parentID;n&&f(e)},onUpdateComponent:function(e){var t=l(e);t&&t.isMounted&&t.updateCount++},onUnmountComponent:function(e){var t=l(e);if(t){t.isMounted=!1;var n=0===t.parentID;n&&d(e)}x.push(e)},purgeUnmountedComponents:function(){if(!T._preventPurging){for(var e=0;e<x.length;e++){var t=x[e];o(t)}x.length=0}},isMounted:function(e){var t=l(e);return!!t&&t.isMounted},getCurrentStackAddendum:function(e){var t="";if(e){var n=a(e),r=e._owner;t+=i(n,e._source,r&&r.getName())}var o=m.current,s=o&&o._debugID;return t+=T.getStackAddendumByID(s)},getStackAddendumByID:function(e){for(var t="";e;)t+=s(e),e=T.getParentID(e);return t},getChildIDs:function(e){var t=l(e);return t?t.childIDs:[]},getDisplayName:function(e){var t=T.getElement(e);return t?a(t):null},getElement:function(e){var t=l(e);return t?t.element:null},getOwnerID:function(e){var t=T.getElement(e);return t&&t._owner?t._owner._debugID:null},getParentID:function(e){var t=l(e);return t?t.parentID:null},getSource:function(e){var t=l(e),n=t?t.element:null,r=null!=n?n._source:null;return r},getText:function(e){var t=T.getElement(e);return"string"==typeof t?t:"number"==typeof t?""+t:null},getUpdateCount:function(e){var t=l(e);return t?t.updateCount:0},getRootIDs:h,getRegisteredIDs:p};e.exports=T},function(e,t,n){"use strict";function r(e,t){}var o=(n(2),{isMounted:function(e){return!1},enqueueCallback:function(e,t){},enqueueForceUpdate:function(e){r(e,"forceUpdate")},enqueueReplaceState:function(e,t){r(e,"replaceState")},enqueueSetState:function(e,t){r(e,"setState")}});e.exports=o},function(e,t,n){"use strict";var r=n(8),o={listen:function(e,t,n){return e.addEventListener?(e.addEventListener(t,n,!1),{remove:function(){e.removeEventListener(t,n,!1)}}):e.attachEvent?(e.attachEvent("on"+t,n),{remove:function(){e.detachEvent("on"+t,n)}}):void 0},capture:function(e,t,n){return e.addEventListener?(e.addEventListener(t,n,!0),{remove:function(){e.removeEventListener(t,n,!0)}}):{remove:r}},registerDefault:function(){}};e.exports=o},function(e,t){"use strict";function n(e){try{e.focus()}catch(e){}}e.exports=n},function(e,t){"use strict";function n(e){if(e=e||("undefined"!=typeof document?document:void 0),"undefined"==typeof e)return null;try{return e.activeElement||e.body}catch(t){return e.body}}e.exports=n},function(e,t,n){"use strict";function r(){}function o(e){try{return e.then}catch(e){return g=e,y}}function i(e,t){try{return e(t)}catch(e){return g=e,y}}function a(e,t,n){try{e(t,n)}catch(e){return g=e,y}}function s(e){if("object"!=typeof this)throw new TypeError("Promises must be constructed via new");if("function"!=typeof e)throw new TypeError("not a function");this._45=0,this._81=0,this._65=null,this._54=null,e!==r&&v(e,this)}function u(e,t,n){return new e.constructor(function(o,i){var a=new s(r);a.then(o,i),l(e,new h(t,n,a))})}function l(e,t){for(;3===e._81;)e=e._65;return s._10&&s._10(e),0===e._81?0===e._45?(e._45=1,void(e._54=t)):1===e._45?(e._45=2,void(e._54=[e._54,t])):void e._54.push(t):void c(e,t)}function c(e,t){m(function(){var n=1===e._81?t.onFulfilled:t.onRejected;if(null===n)return void(1===e._81?p(t.promise,e._65):f(t.promise,e._65));var r=i(n,e._65);r===y?f(t.promise,g):p(t.promise,r)})}function p(e,t){if(t===e)return f(e,new TypeError("A promise cannot be resolved with itself."));if(t&&("object"==typeof t||"function"==typeof t)){var n=o(t);if(n===y)return f(e,g);if(n===e.then&&t instanceof s)return e._81=3,e._65=t,void d(e);if("function"==typeof n)return void v(n.bind(t),e)}e._81=1,e._65=t,d(e)}function f(e,t){e._81=2,e._65=t,s._97&&s._97(e,t),d(e)}function d(e){if(1===e._45&&(l(e,e._54),e._54=null),2===e._45){for(var t=0;t<e._54.length;t++)l(e,e._54[t]);e._54=null}}function h(e,t,n){this.onFulfilled="function"==typeof e?e:null,this.onRejected="function"==typeof t?t:null,this.promise=n}function v(e,t){var n=!1,r=a(e,function(e){n||(n=!0,p(t,e))},function(e){n||(n=!0,f(t,e))});n||r!==y||(n=!0,f(t,g))}var m=n(91),g=null,y={};e.exports=s,s._10=null,s._97=null,s._61=r,s.prototype.then=function(e,t){if(this.constructor!==s)return u(this,e,t);var n=new s(r);return l(this,new h(e,t,n)),n}},function(e,t,n){e.exports=n(195)},function(e,t){"use strict";function n(e,t){return e+t.charAt(0).toUpperCase()+t.substring(1)}var r={animationIterationCount:!0,borderImageOutset:!0,borderImageSlice:!0,borderImageWidth:!0,boxFlex:!0,boxFlexGroup:!0,boxOrdinalGroup:!0,columnCount:!0,flex:!0,flexGrow:!0,flexPositive:!0,flexShrink:!0,flexNegative:!0,flexOrder:!0,gridRow:!0,gridColumn:!0,fontWeight:!0,lineClamp:!0,lineHeight:!0,opacity:!0,order:!0,orphans:!0,tabSize:!0,widows:!0,zIndex:!0,zoom:!0,fillOpacity:!0,floodOpacity:!0,stopOpacity:!0,strokeDasharray:!0,strokeDashoffset:!0,strokeMiterlimit:!0,strokeOpacity:!0,strokeWidth:!0},o=["Webkit","ms","Moz","O"];Object.keys(r).forEach(function(e){o.forEach(function(t){r[n(t,e)]=r[e]})});var i={background:{backgroundAttachment:!0,backgroundColor:!0,backgroundImage:!0,backgroundPositionX:!0,backgroundPositionY:!0,backgroundRepeat:!0},backgroundPosition:{backgroundPositionX:!0,backgroundPositionY:!0},border:{borderWidth:!0,borderStyle:!0,borderColor:!0},borderBottom:{borderBottomWidth:!0,borderBottomStyle:!0,borderBottomColor:!0},borderLeft:{borderLeftWidth:!0,borderLeftStyle:!0,borderLeftColor:!0},borderRight:{borderRightWidth:!0,borderRightStyle:!0,borderRightColor:!0},borderTop:{borderTopWidth:!0,borderTopStyle:!0,borderTopColor:!0},font:{fontStyle:!0,fontVariant:!0,fontWeight:!0,fontSize:!0,lineHeight:!0,fontFamily:!0},outline:{outlineWidth:!0,outlineStyle:!0,outlineColor:!0}},a={isUnitlessNumber:r,shorthandPropertyExpansions:i};e.exports=a},function(e,t,n){"use strict";function r(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}var o=n(3),i=n(15),a=(n(1),function(){function e(t){r(this,e),this._callbacks=null,this._contexts=null,this._arg=t}return e.prototype.enqueue=function(e,t){this._callbacks=this._callbacks||[],this._callbacks.push(e),this._contexts=this._contexts||[],this._contexts.push(t)},e.prototype.notifyAll=function(){var e=this._callbacks,t=this._contexts,n=this._arg;if(e&&t){e.length!==t.length?o("24"):void 0,this._callbacks=null,this._contexts=null;for(var r=0;r<e.length;r++)e[r].call(t[r],n);e.length=0,t.length=0}},e.prototype.checkpoint=function(){return this._callbacks?this._callbacks.length:0},e.prototype.rollback=function(e){this._callbacks&&this._contexts&&(this._callbacks.length=e,this._contexts.length=e)},e.prototype.reset=function(){this._callbacks=null,this._contexts=null},e.prototype.destructor=function(){this.reset()},e}());e.exports=i.addPoolingTo(a)},function(e,t,n){"use strict";function r(e){return!!l.hasOwnProperty(e)||!u.hasOwnProperty(e)&&(s.test(e)?(l[e]=!0,!0):(u[e]=!0,!1))}function o(e,t){return null==t||e.hasBooleanValue&&!t||e.hasNumericValue&&isNaN(t)||e.hasPositiveNumericValue&&t<1||e.hasOverloadedBooleanValue&&t===!1}var i=n(19),a=(n(5),n(9),n(179)),s=(n(2),new RegExp("^["+i.ATTRIBUTE_NAME_START_CHAR+"]["+i.ATTRIBUTE_NAME_CHAR+"]*$")),u={},l={},c={createMarkupForID:function(e){return i.ID_ATTRIBUTE_NAME+"="+a(e)},setAttributeForID:function(e,t){e.setAttribute(i.ID_ATTRIBUTE_NAME,t)},createMarkupForRoot:function(){return i.ROOT_ATTRIBUTE_NAME+'=""'},setAttributeForRoot:function(e){e.setAttribute(i.ROOT_ATTRIBUTE_NAME,"")},createMarkupForProperty:function(e,t){var n=i.properties.hasOwnProperty(e)?i.properties[e]:null;if(n){if(o(n,t))return"";var r=n.attributeName;return n.hasBooleanValue||n.hasOverloadedBooleanValue&&t===!0?r+'=""':r+"="+a(t)}return i.isCustomAttribute(e)?null==t?"":e+"="+a(t):null},createMarkupForCustomAttribute:function(e,t){return r(e)&&null!=t?e+"="+a(t):""},setValueForProperty:function(e,t,n){var r=i.properties.hasOwnProperty(t)?i.properties[t]:null;if(r){var a=r.mutationMethod;if(a)a(e,n);else{if(o(r,n))return void this.deleteValueForProperty(e,t);if(r.mustUseProperty)e[r.propertyName]=n;else{var s=r.attributeName,u=r.attributeNamespace;u?e.setAttributeNS(u,s,""+n):r.hasBooleanValue||r.hasOverloadedBooleanValue&&n===!0?e.setAttribute(s,""):e.setAttribute(s,""+n);
-}}}else if(i.isCustomAttribute(t))return void c.setValueForAttribute(e,t,n)},setValueForAttribute:function(e,t,n){if(r(t)){null==n?e.removeAttribute(t):e.setAttribute(t,""+n)}},deleteValueForAttribute:function(e,t){e.removeAttribute(t)},deleteValueForProperty:function(e,t){var n=i.properties.hasOwnProperty(t)?i.properties[t]:null;if(n){var r=n.mutationMethod;if(r)r(e,void 0);else if(n.mustUseProperty){var o=n.propertyName;n.hasBooleanValue?e[o]=!1:e[o]=""}else e.removeAttribute(n.attributeName)}else i.isCustomAttribute(t)&&e.removeAttribute(t)}};e.exports=c},function(e,t,n){"use strict";var r=n(5),o=n(145),i=n(72),a=n(20),s=n(10),u=n(158),l=n(174),c=n(77),p=n(180);n(2);o.inject();var f={findDOMNode:l,render:i.render,unmountComponentAtNode:i.unmountComponentAtNode,version:u,unstable_batchedUpdates:s.batchedUpdates,unstable_renderSubtreeIntoContainer:p};"undefined"!=typeof __REACT_DEVTOOLS_GLOBAL_HOOK__&&"function"==typeof __REACT_DEVTOOLS_GLOBAL_HOOK__.inject&&__REACT_DEVTOOLS_GLOBAL_HOOK__.inject({ComponentTree:{getClosestInstanceFromNode:r.getClosestInstanceFromNode,getNodeFromInstance:function(e){return e._renderedComponent&&(e=c(e)),e?r.getNodeFromInstance(e):null}},Mount:i,Reconciler:a});e.exports=f},function(e,t){"use strict";var n={hasCachedChildNodes:1};e.exports=n},function(e,t,n){"use strict";function r(){if(this._rootNodeID&&this._wrapperState.pendingUpdate){this._wrapperState.pendingUpdate=!1;var e=this._currentElement.props,t=s.getValue(e);null!=t&&o(this,Boolean(e.multiple),t)}}function o(e,t,n){var r,o,i=u.getNodeFromInstance(e).options;if(t){for(r={},o=0;o<n.length;o++)r[""+n[o]]=!0;for(o=0;o<i.length;o++){var a=r.hasOwnProperty(i[o].value);i[o].selected!==a&&(i[o].selected=a)}}else{for(r=""+n,o=0;o<i.length;o++)if(i[o].value===r)return void(i[o].selected=!0);i.length&&(i[0].selected=!0)}}function i(e){var t=this._currentElement.props,n=s.executeOnChange(t,e);return this._rootNodeID&&(this._wrapperState.pendingUpdate=!0),l.asap(r,this),n}var a=n(4),s=n(42),u=n(5),l=n(10),c=(n(2),!1),p={getHostProps:function(e,t){return a({},t,{onChange:e._wrapperState.onChange,value:void 0})},mountWrapper:function(e,t){var n=s.getValue(t);e._wrapperState={pendingUpdate:!1,initialValue:null!=n?n:t.defaultValue,listeners:null,onChange:i.bind(e),wasMultiple:Boolean(t.multiple)},void 0===t.value||void 0===t.defaultValue||c||(c=!0)},getSelectValueContext:function(e){return e._wrapperState.initialValue},postUpdateWrapper:function(e){var t=e._currentElement.props;e._wrapperState.initialValue=void 0;var n=e._wrapperState.wasMultiple;e._wrapperState.wasMultiple=Boolean(t.multiple);var r=s.getValue(t);null!=r?(e._wrapperState.pendingUpdate=!1,o(e,Boolean(t.multiple),r)):n!==Boolean(t.multiple)&&(null!=t.defaultValue?o(e,Boolean(t.multiple),t.defaultValue):o(e,Boolean(t.multiple),t.multiple?[]:""))}};e.exports=p},function(e,t){"use strict";var n,r={injectEmptyComponentFactory:function(e){n=e}},o={create:function(e){return n(e)}};o.injection=r,e.exports=o},function(e,t){"use strict";var n={logTopLevelRenders:!1};e.exports=n},function(e,t,n){"use strict";function r(e){return s?void 0:a("111",e.type),new s(e)}function o(e){return new u(e)}function i(e){return e instanceof u}var a=n(3),s=(n(1),null),u=null,l={injectGenericComponentClass:function(e){s=e},injectTextComponentClass:function(e){u=e}},c={createInternalComponent:r,createInstanceForText:o,isTextComponent:i,injection:l};e.exports=c},function(e,t,n){"use strict";function r(e){return i(document.documentElement,e)}var o=n(140),i=n(99),a=n(58),s=n(59),u={hasSelectionCapabilities:function(e){var t=e&&e.nodeName&&e.nodeName.toLowerCase();return t&&("input"===t&&"text"===e.type||"textarea"===t||"true"===e.contentEditable)},getSelectionInformation:function(){var e=s();return{focusedElem:e,selectionRange:u.hasSelectionCapabilities(e)?u.getSelection(e):null}},restoreSelection:function(e){var t=s(),n=e.focusedElem,o=e.selectionRange;t!==n&&r(n)&&(u.hasSelectionCapabilities(n)&&u.setSelection(n,o),a(n))},getSelection:function(e){var t;if("selectionStart"in e)t={start:e.selectionStart,end:e.selectionEnd};else if(document.selection&&e.nodeName&&"input"===e.nodeName.toLowerCase()){var n=document.selection.createRange();n.parentElement()===e&&(t={start:-n.moveStart("character",-e.value.length),end:-n.moveEnd("character",-e.value.length)})}else t=o.getOffsets(e);return t||{start:0,end:0}},setSelection:function(e,t){var n=t.start,r=t.end;if(void 0===r&&(r=n),"selectionStart"in e)e.selectionStart=n,e.selectionEnd=Math.min(r,e.value.length);else if(document.selection&&e.nodeName&&"input"===e.nodeName.toLowerCase()){var i=e.createTextRange();i.collapse(!0),i.moveStart("character",n),i.moveEnd("character",r-n),i.select()}else o.setOffsets(e,t)}};e.exports=u},function(e,t,n){"use strict";function r(e,t){for(var n=Math.min(e.length,t.length),r=0;r<n;r++)if(e.charAt(r)!==t.charAt(r))return r;return e.length===t.length?-1:n}function o(e){return e?e.nodeType===D?e.documentElement:e.firstChild:null}function i(e){return e.getAttribute&&e.getAttribute(M)||""}function a(e,t,n,r,o){var i;if(_.logTopLevelRenders){var a=e._currentElement.props.child,s=a.type;i="React mount: "+("string"==typeof s?s:s.displayName||s.name),console.time(i)}var u=x.mountComponent(e,n,null,b(e,t),o,0);i&&console.timeEnd(i),e._renderedComponent._topLevelWrapper=e,j._mountImageIntoNode(u,t,e,r,n)}function s(e,t,n,r){var o=O.ReactReconcileTransaction.getPooled(!n&&C.useCreateElement);o.perform(a,null,e,t,o,n,r),O.ReactReconcileTransaction.release(o)}function u(e,t,n){for(x.unmountComponent(e,n),t.nodeType===D&&(t=t.documentElement);t.lastChild;)t.removeChild(t.lastChild)}function l(e){var t=o(e);if(t){var n=y.getInstanceFromNode(t);return!(!n||!n._hostParent)}}function c(e){return!(!e||e.nodeType!==I&&e.nodeType!==D&&e.nodeType!==R)}function p(e){var t=o(e),n=t&&y.getInstanceFromNode(t);return n&&!n._hostParent?n:null}function f(e){var t=p(e);return t?t._hostContainerInfo._topLevelWrapper:null}var d=n(3),h=n(18),v=n(19),m=n(12),g=n(31),y=(n(13),n(5)),b=n(134),C=n(136),_=n(69),w=n(27),E=(n(9),n(150)),x=n(20),T=n(45),O=n(10),P=n(23),k=n(80),S=(n(1),n(35)),N=n(51),M=(n(2),v.ID_ATTRIBUTE_NAME),A=v.ROOT_ATTRIBUTE_NAME,I=1,D=9,R=11,L={},U=1,F=function(){this.rootID=U++};F.prototype.isReactComponent={},F.prototype.render=function(){return this.props.child},F.isReactTopLevelWrapper=!0;var j={TopLevelWrapper:F,_instancesByReactRootID:L,scrollMonitor:function(e,t){t()},_updateRootComponent:function(e,t,n,r,o){return j.scrollMonitor(r,function(){T.enqueueElementInternal(e,t,n),o&&T.enqueueCallbackInternal(e,o)}),e},_renderNewRootComponent:function(e,t,n,r){c(t)?void 0:d("37"),g.ensureScrollValueMonitoring();var o=k(e,!1);O.batchedUpdates(s,o,t,n,r);var i=o._instance.rootID;return L[i]=o,o},renderSubtreeIntoContainer:function(e,t,n,r){return null!=e&&w.has(e)?void 0:d("38"),j._renderSubtreeIntoContainer(e,t,n,r)},_renderSubtreeIntoContainer:function(e,t,n,r){T.validateCallback(r,"ReactDOM.render"),m.isValidElement(t)?void 0:d("39","string"==typeof t?" Instead of passing a string like 'div', pass React.createElement('div') or <div />.":"function"==typeof t?" Instead of passing a class like Foo, pass React.createElement(Foo) or <Foo />.":null!=t&&void 0!==t.props?" This may be caused by unintentionally loading two independent copies of React.":"");var a,s=m.createElement(F,{child:t});if(e){var u=w.get(e);a=u._processChildContext(u._context)}else a=P;var c=f(n);if(c){var p=c._currentElement,h=p.props.child;if(N(h,t)){var v=c._renderedComponent.getPublicInstance(),g=r&&function(){r.call(v)};return j._updateRootComponent(c,s,a,n,g),v}j.unmountComponentAtNode(n)}var y=o(n),b=y&&!!i(y),C=l(n),_=b&&!c&&!C,E=j._renderNewRootComponent(s,n,_,a)._renderedComponent.getPublicInstance();return r&&r.call(E),E},render:function(e,t,n){return j._renderSubtreeIntoContainer(null,e,t,n)},unmountComponentAtNode:function(e){c(e)?void 0:d("40");var t=f(e);if(!t){l(e),1===e.nodeType&&e.hasAttribute(A);return!1}return delete L[t._instance.rootID],O.batchedUpdates(u,t,e,!1),!0},_mountImageIntoNode:function(e,t,n,i,a){if(c(t)?void 0:d("41"),i){var s=o(t);if(E.canReuseMarkup(e,s))return void y.precacheNode(n,s);var u=s.getAttribute(E.CHECKSUM_ATTR_NAME);s.removeAttribute(E.CHECKSUM_ATTR_NAME);var l=s.outerHTML;s.setAttribute(E.CHECKSUM_ATTR_NAME,u);var p=e,f=r(p,l),v=" (client) "+p.substring(f-20,f+20)+"\n (server) "+l.substring(f-20,f+20);t.nodeType===D?d("42",v):void 0}if(t.nodeType===D?d("43"):void 0,a.useCreateElement){for(;t.lastChild;)t.removeChild(t.lastChild);h.insertTreeBefore(t,e,null)}else S(t,e),y.precacheNode(n,t.firstChild)}};e.exports=j},function(e,t,n){"use strict";var r=n(3),o=n(12),i=(n(1),{HOST:0,COMPOSITE:1,EMPTY:2,getType:function(e){return null===e||e===!1?i.EMPTY:o.isValidElement(e)?"function"==typeof e.type?i.COMPOSITE:i.HOST:void r("26",e)}});e.exports=i},function(e,t){"use strict";var n={currentScrollLeft:0,currentScrollTop:0,refreshScrollValues:function(e){n.currentScrollLeft=e.x,n.currentScrollTop=e.y}};e.exports=n},function(e,t,n){"use strict";function r(e,t){return null==t?o("30"):void 0,null==e?t:Array.isArray(e)?Array.isArray(t)?(e.push.apply(e,t),e):(e.push(t),e):Array.isArray(t)?[e].concat(t):[e,t]}var o=n(3);n(1);e.exports=r},function(e,t){"use strict";function n(e,t,n){Array.isArray(e)?e.forEach(t,n):e&&t.call(n,e)}e.exports=n},function(e,t,n){"use strict";function r(e){for(var t;(t=e._renderedNodeType)===o.COMPOSITE;)e=e._renderedComponent;return t===o.HOST?e._renderedComponent:t===o.EMPTY?null:void 0}var o=n(73);e.exports=r},function(e,t,n){"use strict";function r(){return!i&&o.canUseDOM&&(i="textContent"in document.documentElement?"textContent":"innerText"),i}var o=n(7),i=null;e.exports=r},function(e,t,n){"use strict";function r(e,t){var n={};return n[e.toLowerCase()]=t.toLowerCase(),n["Webkit"+e]="webkit"+t,n["Moz"+e]="moz"+t,n["ms"+e]="MS"+t,n["O"+e]="o"+t.toLowerCase(),n}function o(e){if(s[e])return s[e];if(!a[e])return e;var t=a[e];for(var n in t)if(t.hasOwnProperty(n)&&n in u)return s[e]=t[n];return""}var i=n(7),a={animationend:r("Animation","AnimationEnd"),animationiteration:r("Animation","AnimationIteration"),animationstart:r("Animation","AnimationStart"),transitionend:r("Transition","TransitionEnd")},s={},u={};i.canUseDOM&&(u=document.createElement("div").style,"AnimationEvent"in window||(delete a.animationend.animation,delete a.animationiteration.animation,delete a.animationstart.animation),"TransitionEvent"in window||delete a.transitionend.transition),e.exports=o},function(e,t,n){"use strict";function r(e){if(e){var t=e.getName();if(t)return" Check the render method of `"+t+"`."}return""}function o(e){return"function"==typeof e&&"undefined"!=typeof e.prototype&&"function"==typeof e.prototype.mountComponent&&"function"==typeof e.prototype.receiveComponent}function i(e,t){var n;if(null===e||e===!1)n=l.create(i);else if("object"==typeof e){var s=e,u=s.type;if("function"!=typeof u&&"string"!=typeof u){var f="";f+=r(s._owner),a("130",null==u?u:typeof u,f)}"string"==typeof s.type?n=c.createInternalComponent(s):o(s.type)?(n=new s.type(s),n.getHostNode||(n.getHostNode=n.getNativeNode)):n=new p(s)}else"string"==typeof e||"number"==typeof e?n=c.createInstanceForText(e):a("131",typeof e);return n._mountIndex=0,n._mountImage=null,n}var a=n(3),s=n(4),u=n(132),l=n(68),c=n(70),p=(n(209),n(1),n(2),function(e){this.construct(e)});s(p.prototype,u,{_instantiateReactComponent:i}),e.exports=i},function(e,t){"use strict";function n(e){var t=e&&e.nodeName&&e.nodeName.toLowerCase();return"input"===t?!!r[e.type]:"textarea"===t}var r={color:!0,date:!0,datetime:!0,"datetime-local":!0,email:!0,month:!0,number:!0,password:!0,range:!0,search:!0,tel:!0,text:!0,time:!0,url:!0,week:!0};e.exports=n},function(e,t,n){"use strict";var r=n(7),o=n(34),i=n(35),a=function(e,t){if(t){var n=e.firstChild;if(n&&n===e.lastChild&&3===n.nodeType)return void(n.nodeValue=t)}e.textContent=t};r.canUseDOM&&("textContent"in document.documentElement||(a=function(e,t){return 3===e.nodeType?void(e.nodeValue=t):void i(e,o(t))})),e.exports=a},function(e,t,n){"use strict";function r(e,t){return e&&"object"==typeof e&&null!=e.key?l.escape(e.key):t.toString(36)}function o(e,t,n,i){var f=typeof e;if("undefined"!==f&&"boolean"!==f||(e=null),null===e||"string"===f||"number"===f||"object"===f&&e.$$typeof===s)return n(i,e,""===t?c+r(e,0):t),1;var d,h,v=0,m=""===t?c:t+p;if(Array.isArray(e))for(var g=0;g<e.length;g++)d=e[g],h=m+r(d,g),v+=o(d,h,n,i);else{var y=u(e);if(y){var b,C=y.call(e);if(y!==e.entries)for(var _=0;!(b=C.next()).done;)d=b.value,h=m+r(d,_++),v+=o(d,h,n,i);else for(;!(b=C.next()).done;){var w=b.value;w&&(d=w[1],h=m+l.escape(w[0])+p+r(d,0),v+=o(d,h,n,i))}}else if("object"===f){var E="",x=String(e);a("31","[object Object]"===x?"object with keys {"+Object.keys(e).join(", ")+"}":x,E)}}return v}function i(e,t,n){return null==e?0:o(e,"",t,n)}var a=n(3),s=(n(13),n(146)),u=n(177),l=(n(1),n(41)),c=(n(2),"."),p=":";e.exports=i},function(e,t,n){(function(){var t,r,o,i,a;t=n(6),r=t.createClass,o=t.DOM.div,i=n(16).isEqualToObject,a=n(29).cancelEvent,e.exports=r({getDefaultProps:function(){return{}},render:function(){var e=this;return o({className:"option-wrapper "+(this.props.highlight?"highlight":""),onMouseDown:function(t){var n;return n=function(t){return e.props.onClick(t),window.removeEventListener("mouseup",n)},window.addEventListener("mouseup",n),a(t)},onMouseMove:this.props.onMouseMove,onMouseOut:this.props.onMouseOut,onMouseOver:this.props.onMouseOver},this.props.renderItem(this.props.item))},shouldComponentUpdate:function(e){var t,n,r;return!i(null!=e?e.uid:void 0,null!=(t=this.props)?t.uid:void 0)||(null!=e?e.highlight:void 0)!==(null!=(n=this.props)?n.highlight:void 0)||(null!=e?e.selectable:void 0)!==(null!=(r=this.props)?r.selectable:void 0)}})}).call(this)},function(e,t,n){(function(){var t,r,o,i;t=n(6),r=t.createClass,o=t.DOM.svg,i=n(17).findDOMNode,e.exports=r({render:function(){return o(this.props)},componentDidMount:function(){i(this).setAttribute("focusable",!1)}})}).call(this)},41,function(e,t){"use strict";var n="function"==typeof Symbol&&Symbol.for&&Symbol.for("react.element")||60103;e.exports=n},function(e,t,n){"use strict";var r=!1;e.exports=r},function(e,t,n){"use strict";function r(e){return i.isValidElement(e)?void 0:o("143"),e}var o=n(22),i=n(21);n(1);e.exports=r},function(e,t,n){"use strict";function r(e,t){return e&&"object"==typeof e&&null!=e.key?l.escape(e.key):t.toString(36)}function o(e,t,n,i){var f=typeof e;if("undefined"!==f&&"boolean"!==f||(e=null),null===e||"string"===f||"number"===f||"object"===f&&e.$$typeof===s)return n(i,e,""===t?c+r(e,0):t),1;var d,h,v=0,m=""===t?c:t+p;if(Array.isArray(e))for(var g=0;g<e.length;g++)d=e[g],h=m+r(d,g),v+=o(d,h,n,i);else{var y=u(e);if(y){var b,C=y.call(e);if(y!==e.entries)for(var _=0;!(b=C.next()).done;)d=b.value,h=m+r(d,_++),v+=o(d,h,n,i);else for(;!(b=C.next()).done;){var w=b.value;w&&(d=w[1],h=m+l.escape(w[0])+p+r(d,0),v+=o(d,h,n,i))}}else if("object"===f){var E="",x=String(e);a("31","[object Object]"===x?"object with keys {"+Object.keys(e).join(", ")+"}":x,E)}}return v}function i(e,t,n){return null==e?0:o(e,"",t,n)}var a=n(22),s=(n(13),n(87)),u=n(208),l=(n(1),n(86)),c=(n(2),"."),p=":";e.exports=i},function(e,t){(function(t){"use strict";function n(e){s.length||(a(),u=!0),s[s.length]=e}function r(){for(;l<s.length;){var e=l;if(l+=1,s[e].call(),l>c){for(var t=0,n=s.length-l;t<n;t++)s[t]=s[t+l];s.length-=l,l=0}}s.length=0,l=0,u=!1}function o(e){var t=1,n=new f(e),r=document.createTextNode("");return n.observe(r,{characterData:!0}),function(){t=-t,r.data=t}}function i(e){return function(){function t(){clearTimeout(n),clearInterval(r),e()}var n=setTimeout(t,0),r=setInterval(t,50)}}e.exports=n;var a,s=[],u=!1,l=0,c=1024,p="undefined"!=typeof t?t:self,f=p.MutationObserver||p.WebKitMutationObserver;a="function"==typeof f?o(r):i(r),n.requestFlush=a,n.makeRequestCallFromTimer=i}).call(t,function(){return this}())},function(e,t,n){"use strict";function r(e){return e&&e.__esModule?e:{default:e}}function o(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function i(e,t){if(!e)throw new ReferenceError("this hasn't been initialised - super() hasn't been called");return!t||"object"!=typeof t&&"function"!=typeof t?e:t}function a(e,t){if("function"!=typeof t&&null!==t)throw new TypeError("Super expression must either be null or a function, not "+typeof t);e.prototype=Object.create(t&&t.prototype,{constructor:{value:e,enumerable:!1,writable:!0,configurable:!0}}),t&&(Object.setPrototypeOf?Object.setPrototypeOf(e,t):e.__proto__=t)}Object.defineProperty(t,"__esModule",{value:!0});var s=function(){function e(e,t){for(var n=0;n<t.length;n++){var r=t[n];r.enumerable=r.enumerable||!1,r.configurable=!0,"value"in r&&(r.writable=!0),Object.defineProperty(e,r.key,r)}}return function(t,n,r){return n&&e(t.prototype,n),r&&e(t,r),t}}(),u=n(6),l=r(u),c=n(192),p=function(e){function t(e){o(this,t);var n=i(this,(t.__proto__||Object.getPrototypeOf(t)).call(this,e));return n.getCoefficients=function(e){if(e)return e.map(function(e,t){return l.default.createElement("option",{key:t,value:e.value},e.name)})},n.labels=[],n.handleInputChange=n.handleInputChange.bind(n),n.handleValueChange=n.handleValueChange.bind(n),n}return a(t,e),s(t,[{key:"handleInputChange",value:function(e){var t=this.props.condition;t[e.target.name]=e.target.value;var n=this.props.parameters.find(function(t){return t.value===e.target.value});n&&(t.type=n.type),this.props.onChange({index:this.props.index,value:t})}},{key:"handleValueChange",value:function(e){var t=this.props.condition;t.value=e.map(function(e){return e.value}),this.props.onChange({index:this.props.index,value:t})}},{key:"getOperators",value:function(e,t){if(e&&t)return e.filter(function(e){return e.types.indexOf(t.type)>-1}).map(function(e,t){return l.default.createElement("option",{key:t,value:e.name},e.name)})}},{key:"getValues",value:function(e){return e?e.map(function(e){return{label:e,value:e}}):[]}},{key:"render",value:function(){var e=this,t=this.props.parameters.find(function(t){return t.value===e.props.condition.parameter});return this.props.condition.type=t?t.type:null,l.default.createElement("div",{className:this.props.classes.filterLineRow},l.default.createElement("div",{className:this.props.classes.filterLineParameter},l.default.createElement("select",{className:this.props.classes.filterLineInput,name:"parameter",value:this.props.condition.parameter,onChange:this.handleInputChange},l.default.createElement("option",{value:""},"-- Parameter --"),this.getCoefficients(this.props.parameters))),l.default.createElement("div",{className:this.props.classes.filterLineOperator},l.default.createElement("select",{className:this.props.classes.filterLineInput,name:"operator",value:this.props.condition.operator,onChange:this.handleInputChange},l.default.createElement("option",{disabled:!0,value:""},"-- Operator --"),this.getOperators(this.props.operators,this.props.parameters.find(function(t){return t.value===e.props.condition.parameter})))),l.default.createElement("div",{className:this.props.classes.filterLineValue},l.default.createElement(c.MultiSelect,{style:{width:"100%"},placeholder:"-- Value --",theme:"bootstrap3",values:this.getValues(this.props.condition.value),onValuesChange:this.handleValueChange,uid:function(e){return e.value},restoreOnBackspace:function(e){return e.label.toString()},createFromSearch:function(t,n,r){return e.labels=n.map(function(e){return e.label}),0===r.trim().length||e.labels.indexOf(r.trim())!==-1?null:{label:r.trim(),value:r.trim()}},renderNoResultsFound:function(e,t){return l.default.createElement("div",{className:"no-results-found"},function(){return 0===t.trim().length?"Enter a new value":e.map(function(e){return e.label}).indexOf(t.trim())!==-1?"Value already exists":void 0}())}})))}}]),t}(u.Component);t.default=p},function(e,t,n){"use strict";function r(e){return e&&e.__esModule?e:{default:e}}function o(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function i(e,t){if(!e)throw new ReferenceError("this hasn't been initialised - super() hasn't been called");return!t||"object"!=typeof t&&"function"!=typeof t?e:t}function a(e,t){if("function"!=typeof t&&null!==t)throw new TypeError("Super expression must either be null or a function, not "+typeof t);e.prototype=Object.create(t&&t.prototype,{constructor:{value:e,enumerable:!1,writable:!0,configurable:!0}}),t&&(Object.setPrototypeOf?Object.setPrototypeOf(e,t):e.__proto__=t)}Object.defineProperty(t,"__esModule",{value:!0});var s=function(){function e(e,t){for(var n=0;n<t.length;n++){var r=t[n];r.enumerable=r.enumerable||!1,r.configurable=!0,"value"in r&&(r.writable=!0),Object.defineProperty(e,r.key,r)}}return function(t,n,r){return n&&e(t.prototype,n),r&&e(t,r),t}}(),u=n(6),l=r(u),c={paddingTop:10,paddingBottom:10,paddingRight:3,paddingLeft:3},p=function(e){function t(e){o(this,t);var n=i(this,(t.__proto__||Object.getPrototypeOf(t)).call(this,e));return n.removeCondition=n.removeCondition.bind(n),n.addCondition=n.addCondition.bind(n),n}return a(t,e),s(t,[{key:"removeCondition",value:function(){this.props.removeCondition(this.props.index)}},{key:"addCondition",value:function(){this.props.addCondition(this.props.index)}},{key:"render",value:function(){return l.default.createElement("div",{className:this.props.classes.filterLineLabelRow},l.default.createElement("div",{className:this.props.classes.filterLineLabelCondition},l.default.createElement("label",{style:{marginTop:0}},"Condition {",this.props.index+1,"}")),l.default.createElement("div",{className:this.props.classes.filterLineLabelControls},l.default.createElement("a",{style:c,onClick:this.addCondition},l.default.createElement("span",{className:this.props.classes.plusIcon})),l.default.createElement("a",{style:c,onClick:this.removeCondition},l.default.createElement("span",{className:this.props.classes.minusIcon}))))}}]),t}(u.Component);t.default=p},function(e,t,n){"use strict";function r(e){return e&&e.__esModule?e:{default:e}}function o(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function i(e,t){if(!e)throw new ReferenceError("this hasn't been initialised - super() hasn't been called");return!t||"object"!=typeof t&&"function"!=typeof t?e:t}function a(e,t){if("function"!=typeof t&&null!==t)throw new TypeError("Super expression must either be null or a function, not "+typeof t);e.prototype=Object.create(t&&t.prototype,{constructor:{value:e,enumerable:!1,writable:!0,configurable:!0}}),t&&(Object.setPrototypeOf?Object.setPrototypeOf(e,t):e.__proto__=t)}Object.defineProperty(t,"__esModule",{value:!0});var s=function(){function e(e,t){for(var n=0;n<t.length;n++){var r=t[n];r.enumerable=r.enumerable||!1,r.configurable=!0,"value"in r&&(r.writable=!0),Object.defineProperty(e,r.key,r)}}return function(t,n,r){return n&&e(t.prototype,n),r&&e(t,r),t}}(),u=n(6),l=r(u),c=n(92),p=r(c),f=n(93),d=r(f),h=function(e){function t(e){o(this,t);var n=i(this,(t.__proto__||Object.getPrototypeOf(t)).call(this,e));return n.state={conditions:e.config.conditions},n.updateCondition=n.updateCondition.bind(n),n.addCondition=n.addCondition.bind(n),n.removeCondition=n.removeCondition.bind(n),n.componentDidUpdate=n.componentDidUpdate.bind(n),n}return a(t,e),s(t,[{key:"updateCondition",value:function(e){var t=this.state.conditions;t[e.index]=e.value,this.setState({conditions:t})}},{key:"addCondition",value:function(e){var t=this.state.conditions;t.splice(e+1,0,{parameter:"",operator:"",value:""}),this.setState({conditions:t})}},{key:"removeCondition",value:function(e){if(this.state.conditions.length>1){var t=this.state.conditions;t.splice(e,1),this.setState({conditions:t})}}},{key:"componentDidUpdate",value:function(e,t){t!==this.state&&this.props.config.updateConditions(this.state.conditions)}},{key:"render",value:function(){var e=this,t=this.state.conditions.map(function(t,n){return l.default.createElement("div",{key:n},l.default.createElement(d.default,{index:n,classes:e.props.config.classes,addCondition:e.addCondition,removeCondition:e.removeCondition}),l.default.createElement(p.default,{parameters:e.props.config.parameters,operators:e.props.config.operators,condition:t,index:n,classes:e.props.config.classes,onChange:e.updateCondition}))});return l.default.createElement("div",{className:"form-horizontal"},t)}}]),t}(u.Component);t.default=h},function(e,t,n){"use strict";function r(e){return e&&e.__esModule?e:{default:e}}var o=n(6),i=r(o),a=n(17),s=r(a),u=n(94),l=r(u),c=window.$;if(c.fn.filterer=function(e){e.operators=[{name:"contains",types:["string","str"]},{name:"does not contain",types:["string","str"]},{name:"is",types:["string","str","number","int","float"]},{name:"is not",types:["string","str","number","int","float"]},{name:"begins with",types:["string","str"]},{name:"ends with",types:["string","str"]},{name:"is greater than",types:["number","int","float"]},{name:"is less than",types:["number","int","float"]}],e.classes=Object.assign({plusIcon:"fa fa-fw fa-plus",minusIcon:"fa fa-fw fa-minus",filterLineRow:"form-group",filterLineParameter:"col-sm-4",filterLineOperator:"col-sm-3",filterLineValue:"col-sm-5",filterLineInput:"form-control",filterLineLabelRow:"row",filterLineLabelCondition:"col-sm-10",filterLineLabelControls:"col-sm-2 text-right"},e.classes),this.each(function(){s.default.render(i.default.createElement(l.default,{id:"filterer",config:e}),this)})},window.wcomartin_filterer_demo){var p={parameters:[{name:"Title",type:"string",value:"title"},{name:"Year",type:"number",value:"year"}],conditions:[{parameter:"year",operator:"is",value:[2017]}]};p.updateConditions=function(e){console.log(JSON.stringify(e))},c("#root").filterer(p)}},function(e,t,n){"use strict";function r(e,t){for(var n=e;n.parentNode;)n=n.parentNode;var r=n.querySelectorAll(t);return Array.prototype.indexOf.call(r,e)!==-1}var o=n(1),i={addClass:function(e,t){return/\s/.test(t)?o(!1):void 0,t&&(e.classList?e.classList.add(t):i.hasClass(e,t)||(e.className=e.className+" "+t)),e},removeClass:function(e,t){return/\s/.test(t)?o(!1):void 0,t&&(e.classList?e.classList.remove(t):i.hasClass(e,t)&&(e.className=e.className.replace(new RegExp("(^|\\s)"+t+"(?:\\s|$)","g"),"$1").replace(/\s+/g," ").replace(/^\s*|\s*$/g,""))),e},conditionClass:function(e,t,n){return(n?i.addClass:i.removeClass)(e,t)},hasClass:function(e,t){return/\s/.test(t)?o(!1):void 0,e.classList?!!t&&e.classList.contains(t):(" "+e.className+" ").indexOf(" "+t+" ")>-1},matchesSelector:function(e,t){var n=e.matches||e.webkitMatchesSelector||e.mozMatchesSelector||e.msMatchesSelector||function(t){return r(e,t)};return n.call(e,t)}};e.exports=i},function(e,t){"use strict";function n(e){return e.replace(r,function(e,t){return t.toUpperCase()})}var r=/-(.)/g;e.exports=n},function(e,t,n){"use strict";function r(e){return o(e.replace(i,"ms-"))}var o=n(97),i=/^-ms-/;e.exports=r},function(e,t,n){"use strict";function r(e,t){return!(!e||!t)&&(e===t||!o(e)&&(o(t)?r(e,t.parentNode):"contains"in e?e.contains(t):!!e.compareDocumentPosition&&!!(16&e.compareDocumentPosition(t))))}var o=n(107);e.exports=r},function(e,t,n){"use strict";function r(e){var t=e.length;if(Array.isArray(e)||"object"!=typeof e&&"function"!=typeof e?a(!1):void 0,"number"!=typeof t?a(!1):void 0,0===t||t-1 in e?void 0:a(!1),"function"==typeof e.callee?a(!1):void 0,e.hasOwnProperty)try{return Array.prototype.slice.call(e)}catch(e){}for(var n=Array(t),r=0;r<t;r++)n[r]=e[r];return n}function o(e){return!!e&&("object"==typeof e||"function"==typeof e)&&"length"in e&&!("setInterval"in e)&&"number"!=typeof e.nodeType&&(Array.isArray(e)||"callee"in e||"item"in e)}function i(e){return o(e)?Array.isArray(e)?e.slice():r(e):[e]}var a=n(1);e.exports=i},function(e,t,n){"use strict";function r(e){var t=e.match(c);return t&&t[1].toLowerCase()}function o(e,t){var n=l;l?void 0:u(!1);var o=r(e),i=o&&s(o);if(i){n.innerHTML=i[1]+e+i[2];for(var c=i[0];c--;)n=n.lastChild}else n.innerHTML=e;var p=n.getElementsByTagName("script");p.length&&(t?void 0:u(!1),a(p).forEach(t));for(var f=Array.from(n.childNodes);n.lastChild;)n.removeChild(n.lastChild);return f}var i=n(7),a=n(100),s=n(102),u=n(1),l=i.canUseDOM?document.createElement("div"):null,c=/^\s*<(\w+)/;e.exports=o},function(e,t,n){"use strict";function r(e){return a?void 0:i(!1),f.hasOwnProperty(e)||(e="*"),s.hasOwnProperty(e)||("*"===e?a.innerHTML="<link />":a.innerHTML="<"+e+"></"+e+">",s[e]=!a.firstChild),s[e]?f[e]:null}var o=n(7),i=n(1),a=o.canUseDOM?document.createElement("div"):null,s={},u=[1,'<select multiple="true">',"</select>"],l=[1,"<table>","</table>"],c=[3,"<table><tbody><tr>","</tr></tbody></table>"],p=[1,'<svg xmlns="http://www.w3.org/2000/svg">',"</svg>"],f={"*":[1,"?<div>","</div>"],area:[1,"<map>","</map>"],col:[2,"<table><tbody></tbody><colgroup>","</colgroup></table>"],legend:[1,"<fieldset>","</fieldset>"],param:[1,"<object>","</object>"],tr:[2,"<table><tbody>","</tbody></table>"],optgroup:u,option:u,caption:l,colgroup:l,tbody:l,tfoot:l,thead:l,td:c,th:c},d=["circle","clipPath","defs","ellipse","g","image","line","linearGradient","mask","path","pattern","polygon","polyline","radialGradient","rect","stop","text","tspan"];d.forEach(function(e){f[e]=p,s[e]=!0}),e.exports=r},function(e,t){"use strict";function n(e){return e.Window&&e instanceof e.Window?{x:e.pageXOffset||e.document.documentElement.scrollLeft,y:e.pageYOffset||e.document.documentElement.scrollTop}:{x:e.scrollLeft,y:e.scrollTop}}e.exports=n},function(e,t){"use strict";function n(e){return e.replace(r,"-$1").toLowerCase()}var r=/([A-Z])/g;e.exports=n},function(e,t,n){"use strict";function r(e){return o(e).replace(i,"-ms-")}var o=n(104),i=/^ms-/;e.exports=r},function(e,t){"use strict";function n(e){var t=e?e.ownerDocument||e:document,n=t.defaultView||window;return!(!e||!("function"==typeof n.Node?e instanceof n.Node:"object"==typeof e&&"number"==typeof e.nodeType&&"string"==typeof e.nodeName))}e.exports=n},function(e,t,n){"use strict";function r(e){return o(e)&&3==e.nodeType}var o=n(106);e.exports=r},function(e,t){"use strict";function n(e){var t={};return function(n){return t.hasOwnProperty(n)||(t[n]=e.call(this,n)),t[n]}}e.exports=n},function(e,t){function n(e,t){var n,r=function(o){return e.length>1?function(){var i=o?o.concat():[];return n=t?n||this:this,i.push.apply(i,arguments)<e.length&&arguments.length?r.call(n,i):e.apply(n,i)}:e};return r()}var r,o,i,a,s,u,l=[].slice,c={}.toString;r=n(function(e,t){return e.apply(null,t)}),o=function(e){return n(e)},i=n(function(e,t,n){return e(n,t)}),a=function(e){return function(t){return function(){return e(t(t)).apply(null,arguments)}}(function(t){return function(){return e(t(t)).apply(null,arguments)}})},s=n(function(e,t,n,r){return e(t(n),t(r))}),u=function(e){var t;return t={},function(){var n,r,o;return n=l.call(arguments),r=function(){var e,t,r,i=[];for(e=0,r=(t=n).length;e<r;++e)o=t[e],i.push(o+c.call(o).slice(8,-1));return i}().join(""),t[r]=r in t?t[r]:e.apply(null,n)}},e.exports={curry:o,flip:i,fix:a,apply:r,over:s,memoize:u}},function(e,t){function n(e,t){var n,r=function(o){return e.length>1?function(){var i=o?o.concat():[];return n=t?n||this:this,i.push.apply(i,arguments)<e.length&&arguments.length?r.call(n,i):e.apply(n,i)}:e};return r()}function r(e,t){for(var n=-1,r=t.length>>>0;++n<r;)if(e===t[n])return!0;return!1}function o(){var e=arguments;return function(){var t,n;for(n=e[0].apply(this,arguments),t=1;t<e.length;++t)n=e[t](n);return n}}function i(e){return!e}var a,s,u,l,c,p,f,d,h,v,m,g,y,b,C,_,w,E,x,T,O,P,k,S,N,M,A,I,D,R,L,U,F,j,B,V,W,H,q,z,K,Y,X,G,Q,$,Z,J,ee,te,ne,re,oe,ie,ae,se,ue,le,ce,pe,fe,de,he,ve,me,ge,ye,be,Ce,_e={}.toString,we=[].slice;a=n(function(e,t){var n,r,o;for(n=0,r=t.length;n<r;++n)o=t[n],e(o);return t}),s=n(function(e,t){var n,r,o,i=[];for(n=0,r=t.length;n<r;++n)o=t[n],i.push(e(o));return i}),u=function(e){var t,n,r,o=[];for(t=0,
-n=e.length;t<n;++t)r=e[t],r&&o.push(r);return o},l=n(function(e,t){var n,r,o,i=[];for(n=0,r=t.length;n<r;++n)o=t[n],e(o)&&i.push(o);return i}),c=n(function(e,t){var n,r,o,i=[];for(n=0,r=t.length;n<r;++n)o=t[n],e(o)||i.push(o);return i}),p=n(function(e,t){var n,r,o,i,a;for(n=[],r=[],o=0,i=t.length;o<i;++o)a=t[o],(e(a)?n:r).push(a);return[n,r]}),f=n(function(e,t){var n,r,o;for(n=0,r=t.length;n<r;++n)if(o=t[n],e(o))return o}),d=h=function(e){return e[0]},v=function(e){if(e.length)return e.slice(1)},m=function(e){return e[e.length-1]},g=function(e){if(e.length)return e.slice(0,-1)},y=function(e){return!e.length},b=function(e){return e.concat().reverse()},C=function(e){var t,n,o,i;for(t=[],n=0,o=e.length;n<o;++n)i=e[n],r(i,t)||t.push(i);return t},_=n(function(e,t){var n,o,i,a,s,u=[];for(n=[],o=0,i=t.length;o<i;++o)a=t[o],s=e(a),r(s,n)||(n.push(s),u.push(a));return u}),w=E=n(function(e,t,n){var r,o,i;for(r=0,o=n.length;r<o;++r)i=n[r],t=e(t,i);return t}),x=T=n(function(e,t){return w(e,t[0],t.slice(1))}),O=n(function(e,t,n){var r,o;for(r=n.length-1;r>=0;--r)o=n[r],t=e(o,t);return t}),P=n(function(e,t){return O(e,t[t.length-1],t.slice(0,-1))}),k=n(function(e,t){var n,r,o;for(n=[],r=t;null!=(o=e(r));)n.push(o[0]),r=o[1];return n}),S=function(e){return[].concat.apply([],e)},N=n(function(e,t){var n;return[].concat.apply([],function(){var r,o,i,a=[];for(r=0,i=(o=t).length;r<i;++r)n=o[r],a.push(e(n));return a}())}),M=function(e){var t;return[].concat.apply([],function(){var n,r,o,i=[];for(n=0,o=(r=e).length;n<o;++n)t=r[n],"Array"===_e.call(t).slice(8,-1)?i.push(M(t)):i.push(t);return i}())},A=function(e){var t,n,o,i,a,s,u,l;t=we.call(arguments,1),n=[];e:for(o=0,i=e.length;o<i;++o){for(a=e[o],s=0,u=t.length;s<u;++s)if(l=t[s],r(a,l))continue e;n.push(a)}return n},I=function(e){var t,n,o,i,a,s,u,l;t=we.call(arguments,1),n=[];e:for(o=0,i=e.length;o<i;++o){for(a=e[o],s=0,u=t.length;s<u;++s)if(l=t[s],!r(a,l))continue e;n.push(a)}return n},D=function(){var e,t,n,o,i,a,s,u;for(e=we.call(arguments),t=[],n=0,o=e.length;n<o;++n)for(i=e[n],a=0,s=i.length;a<s;++a)u=i[a],r(u,t)||t.push(u);return t},R=n(function(e,t){var n,r,o,i,a;for(n={},r=0,o=t.length;r<o;++r)i=t[r],a=e(i),a in n?n[a]+=1:n[a]=1;return n}),L=n(function(e,t){var n,r,o,i,a;for(n={},r=0,o=t.length;r<o;++r)i=t[r],a=e(i),a in n?n[a].push(i):n[a]=[i];return n}),U=function(e){var t,n,r;for(t=0,n=e.length;t<n;++t)if(r=e[t],!r)return!1;return!0},F=function(e){var t,n,r;for(t=0,n=e.length;t<n;++t)if(r=e[t])return!0;return!1},j=n(function(e,t){var n,r,o;for(n=0,r=t.length;n<r;++n)if(o=t[n],e(o))return!0;return!1}),B=n(function(e,t){var n,r,o;for(n=0,r=t.length;n<r;++n)if(o=t[n],!e(o))return!1;return!0}),V=function(e){return e.concat().sort(function(e,t){return e>t?1:e<t?-1:0})},W=n(function(e,t){return t.concat().sort(e)}),H=n(function(e,t){return t.concat().sort(function(t,n){return e(t)>e(n)?1:e(t)<e(n)?-1:0})}),q=function(e){var t,n,r,o;for(t=0,n=0,r=e.length;n<r;++n)o=e[n],t+=o;return t},z=function(e){var t,n,r,o;for(t=1,n=0,r=e.length;n<r;++n)o=e[n],t*=o;return t},K=Y=function(e){var t,n,r,o;for(t=0,n=0,r=e.length;n<r;++n)o=e[n],t+=o;return t/e.length},X=function(e){var t,n,r,o,i;for(t=e[0],n=0,o=(r=e.slice(1)).length;n<o;++n)i=r[n],i>t&&(t=i);return t},G=function(e){var t,n,r,o,i;for(t=e[0],n=0,o=(r=e.slice(1)).length;n<o;++n)i=r[n],i<t&&(t=i);return t},Q=n(function(e,t){var n,r,o,i,a;for(n=t[0],r=0,i=(o=t.slice(1)).length;r<i;++r)a=o[r],e(a)>e(n)&&(n=a);return n}),$=n(function(e,t){var n,r,o,i,a;for(n=t[0],r=0,i=(o=t.slice(1)).length;r<i;++r)a=o[r],e(a)<e(n)&&(n=a);return n}),Z=J=n(function(e,t,n){var r,o;return r=t,[t].concat(function(){var t,i,a,s=[];for(t=0,a=(i=n).length;t<a;++t)o=i[t],s.push(r=e(r,o));return s}())}),ee=te=n(function(e,t){if(t.length)return Z(e,t[0],t.slice(1))}),ne=n(function(e,t,n){return n=n.concat().reverse(),Z(e,t,n).reverse()}),re=n(function(e,t){if(t.length)return t=t.concat().reverse(),Z(e,t[0],t.slice(1)).reverse()}),oe=n(function(e,t,n){return n.slice(e,t)}),ie=n(function(e,t){return e<=0?t.slice(0,0):t.slice(0,e)}),ae=n(function(e,t){return e<=0?t:t.slice(e)}),se=n(function(e,t){return[ie(e,t),ae(e,t)]}),ue=n(function(e,t){var n,r;if(n=t.length,!n)return t;for(r=0;r<n&&e(t[r]);)r+=1;return t.slice(0,r)}),le=n(function(e,t){var n,r;if(n=t.length,!n)return t;for(r=0;r<n&&e(t[r]);)r+=1;return t.slice(r)}),ce=n(function(e,t){return[ue(e,t),le(e,t)]}),pe=n(function(e,t){return ce(o(e,i),t)}),fe=n(function(e,t){var n,r,o,i,a,s;for(n=[],r=t.length,o=0,i=e.length;o<i&&(a=o,s=e[o],a!==r);++o)n.push([s,t[a]]);return n}),de=n(function(e,t,n){var r,o,i,a,s,u;for(r=[],o=n.length,i=0,a=t.length;i<a&&(s=i,u=t[i],s!==o);++i)r.push(e(u,n[s]));return r}),he=function(){var e,t,n,r,o,i,a,s,u,l=[];for(e=we.call(arguments),t=void 0,n=0,r=e.length;n<r;++n)o=e[n],t<=(i=o.length)||(t=i);for(n=0;n<t;++n){for(a=n,s=[],u=0,r=e.length;u<r;++u)o=e[u],s.push(o[a]);l.push(s)}return l},ve=function(e){function t(){var e,t,r,o=[];for(e=0,r=(t=n).length;e<r;++e)a=t[e],o.push(a[u]);return o}var n,r,o,i,a,s,u,l=[];for(n=we.call(arguments,1),r=void 0,o=0,i=n.length;o<i;++o)a=n[o],r<=(s=a.length)||(r=s);for(o=0;o<r;++o)u=o,l.push(e.apply(null,t()));return l},me=n(function(e,t){return e<0?t[t.length+e]:t[e]}),ge=n(function(e,t){var n,r,o,i;for(n=0,r=t.length;n<r;++n)if(o=n,i=t[n],i===e)return o}),ye=n(function(e,t){var n,r,o,i,a=[];for(n=0,r=t.length;n<r;++n)o=n,i=t[n],i===e&&a.push(o);return a}),be=n(function(e,t){var n,r,o,i;for(n=0,r=t.length;n<r;++n)if(o=n,i=t[n],e(i))return o}),Ce=n(function(e,t){var n,r,o,i,a=[];for(n=0,r=t.length;n<r;++n)o=n,i=t[n],e(i)&&a.push(o);return a}),e.exports={each:a,map:s,filter:l,compact:u,reject:c,partition:p,find:f,head:d,first:h,tail:v,last:m,initial:g,empty:y,reverse:b,difference:A,intersection:I,union:D,countBy:R,groupBy:L,fold:w,fold1:x,foldl:E,foldl1:T,foldr:O,foldr1:P,unfoldr:k,andList:U,orList:F,any:j,all:B,unique:C,uniqueBy:_,sort:V,sortWith:W,sortBy:H,sum:q,product:z,mean:K,average:Y,concat:S,concatMap:N,flatten:M,maximum:X,minimum:G,maximumBy:Q,minimumBy:$,scan:Z,scan1:ee,scanl:J,scanl1:te,scanr:ne,scanr1:re,slice:oe,take:ie,drop:ae,splitAt:se,takeWhile:ue,dropWhile:le,span:ce,breakList:pe,zip:fe,zipWith:de,zipAll:he,zipAllWith:ve,at:me,elemIndex:ge,elemIndices:ye,findIndex:be,findIndices:Ce}},function(e,t){function n(e,t){var n,r=function(o){return e.length>1?function(){var i=o?o.concat():[];return n=t?n||this:this,i.push.apply(i,arguments)<e.length&&arguments.length?r.call(n,i):e.apply(n,i)}:e};return r()}var r,o,i,a,s,u,l,c,p,f,d,h,v,m,g,y,b,C,_,w,E,x,T,O,P,k,S,N,M,A,I,D;r=n(function(e,t){return e>t?e:t}),o=n(function(e,t){return e<t?e:t}),i=function(e){return-e},a=Math.abs,s=function(e){return e<0?-1:e>0?1:0},u=n(function(e,t){return~~(e/t)}),l=n(function(e,t){return e%t}),c=n(function(e,t){return Math.floor(e/t)}),p=n(function(e,t){var n;return(e%(n=t)+n)%n}),f=function(e){return 1/e},d=Math.PI,h=2*d,v=Math.exp,m=Math.sqrt,g=Math.log,y=n(function(e,t){return Math.pow(e,t)}),b=Math.sin,C=Math.tan,_=Math.cos,w=Math.asin,E=Math.acos,x=Math.atan,T=n(function(e,t){return Math.atan2(e,t)}),O=function(e){return~~e},P=Math.round,k=Math.ceil,S=Math.floor,N=function(e){return e!==e},M=function(e){return e%2===0},A=function(e){return e%2!==0},I=n(function(e,t){var n;for(e=Math.abs(e),t=Math.abs(t);0!==t;)n=e%t,e=t,t=n;return e}),D=n(function(e,t){return Math.abs(Math.floor(e/I(e,t)*t))}),e.exports={max:r,min:o,negate:i,abs:a,signum:s,quot:u,rem:l,div:c,mod:p,recip:f,pi:d,tau:h,exp:v,sqrt:m,ln:g,pow:y,sin:b,tan:C,cos:_,acos:E,asin:w,atan:x,atan2:T,truncate:O,round:P,ceiling:k,floor:S,isItNaN:N,even:M,odd:A,gcd:I,lcm:D}},function(e,t){function n(e,t){var n,r=function(o){return e.length>1?function(){var i=o?o.concat():[];return n=t?n||this:this,i.push.apply(i,arguments)<e.length&&arguments.length?r.call(n,i):e.apply(n,i)}:e};return r()}var r,o,i,a,s,u,l,c,p,f,d,h,v,m;r=function(e){var t,n,r=[];for(t in e)n=e[t],r.push(n);return r},o=function(e){var t,n=[];for(t in e)n.push(t);return n},i=function(e){var t,n,r,o={};for(t=0,n=e.length;t<n;++t)r=e[t],o[r[0]]=r[1];return o},a=function(e){var t,n,r=[];for(t in e)n=e[t],r.push([t,n]);return r},s=n(function(e,t){var n,r,o,i,a={};for(n=0,r=e.length;n<r;++n)o=n,i=e[n],a[i]=t[o];return a}),u=function(e){var t,n,r,o;t=[],n=[];for(r in e)o=e[r],t.push(r),n.push(o);return[t,n]},l=function(e){var t;for(t in e)return!1;return!0},c=n(function(e,t){var n,r;for(n in t)r=t[n],e(r);return t}),p=n(function(e,t){var n,r,o={};for(n in t)r=t[n],o[n]=e(r);return o}),f=function(e){var t,n,r={};for(t in e)n=e[t],n&&(r[t]=n);return r},d=n(function(e,t){var n,r,o={};for(n in t)r=t[n],e(r)&&(o[n]=r);return o}),h=n(function(e,t){var n,r,o={};for(n in t)r=t[n],e(r)||(o[n]=r);return o}),v=n(function(e,t){var n,r,o,i;n={},r={};for(o in t)i=t[o],(e(i)?n:r)[o]=i;return[n,r]}),m=n(function(e,t){var n,r;for(n in t)if(r=t[n],e(r))return r}),e.exports={values:r,keys:o,pairsToObj:i,objToPairs:a,listsToObj:s,objToLists:u,empty:l,each:c,map:p,filter:d,compact:f,reject:h,partition:v,find:m}},function(e,t){function n(e,t){var n,r=function(o){return e.length>1?function(){var i=o?o.concat():[];return n=t?n||this:this,i.push.apply(i,arguments)<e.length&&arguments.length?r.call(n,i):e.apply(n,i)}:e};return r()}var r,o,i,a,s,u,l,c,p,f,d,h,v;r=n(function(e,t){return t.split(e)}),o=n(function(e,t){return t.join(e)}),i=function(e){return e.length?e.split("\n"):[]},a=function(e){return e.join("\n")},s=function(e){return e.length?e.split(/[ ]+/):[]},u=function(e){return e.join(" ")},l=function(e){return e.split("")},c=function(e){return e.join("")},p=function(e){return e.split("").reverse().join("")},f=n(function(e,t){var n,r;for(n="",r=0;r<e;++r)n+=t;return n}),d=function(e){return e.charAt(0).toUpperCase()+e.slice(1)},h=function(e){return e.replace(/[-_]+(.)?/g,function(e,t){return(null!=t?t:"").toUpperCase()})},v=function(e){return e.replace(/([^-A-Z])([A-Z]+)/g,function(e,t,n){return t+"-"+(n.length>1?n:n.toLowerCase())}).replace(/^([A-Z]+)/,function(e,t){return t.length>1?t+"-":t.toLowerCase()})},e.exports={split:r,join:o,lines:i,unlines:a,words:s,unwords:u,chars:l,unchars:c,reverse:p,repeat:f,capitalize:d,camelize:h,dasherize:v}},function(e,t,n){"use strict";function r(e){var t=new o(o._61);return t._81=1,t._65=e,t}var o=n(60);e.exports=o;var i=r(!0),a=r(!1),s=r(null),u=r(void 0),l=r(0),c=r("");o.resolve=function(e){if(e instanceof o)return e;if(null===e)return s;if(void 0===e)return u;if(e===!0)return i;if(e===!1)return a;if(0===e)return l;if(""===e)return c;if("object"==typeof e||"function"==typeof e)try{var t=e.then;if("function"==typeof t)return new o(t.bind(e))}catch(e){return new o(function(t,n){n(e)})}return r(e)},o.all=function(e){var t=Array.prototype.slice.call(e);return new o(function(e,n){function r(a,s){if(s&&("object"==typeof s||"function"==typeof s)){if(s instanceof o&&s.then===o.prototype.then){for(;3===s._81;)s=s._65;return 1===s._81?r(a,s._65):(2===s._81&&n(s._65),void s.then(function(e){r(a,e)},n))}var u=s.then;if("function"==typeof u){var l=new o(u.bind(s));return void l.then(function(e){r(a,e)},n)}}t[a]=s,0===--i&&e(t)}if(0===t.length)return e([]);for(var i=t.length,a=0;a<t.length;a++)r(a,t[a])})},o.reject=function(e){return new o(function(t,n){n(e)})},o.race=function(e){return new o(function(t,n){e.forEach(function(e){o.resolve(e).then(t,n)})})},o.prototype.catch=function(e){return this.then(null,e)}},function(e,t,n){"use strict";function r(){l=!1,s._10=null,s._97=null}function o(e){function t(t){(e.allRejections||a(p[t].error,e.whitelist||u))&&(p[t].displayId=c++,e.onUnhandled?(p[t].logged=!0,e.onUnhandled(p[t].displayId,p[t].error)):(p[t].logged=!0,i(p[t].displayId,p[t].error)))}function n(t){p[t].logged&&(e.onHandled?e.onHandled(p[t].displayId,p[t].error):p[t].onUnhandled||(console.warn("Promise Rejection Handled (id: "+p[t].displayId+"):"),console.warn('  This means you can ignore any previous messages of the form "Possible Unhandled Promise Rejection" with id '+p[t].displayId+".")))}e=e||{},l&&r(),l=!0;var o=0,c=0,p={};s._10=function(e){2===e._81&&p[e._72]&&(p[e._72].logged?n(e._72):clearTimeout(p[e._72].timeout),delete p[e._72])},s._97=function(e,n){0===e._45&&(e._72=o++,p[e._72]={displayId:null,error:n,timeout:setTimeout(t.bind(null,e._72),a(n,u)?100:2e3),logged:!1})}}function i(e,t){console.warn("Possible Unhandled Promise Rejection (id: "+e+"):");var n=(t&&(t.stack||t))+"";n.split("\n").forEach(function(e){console.warn("  "+e)})}function a(e,t){return t.some(function(t){return e instanceof t})}var s=n(60),u=[ReferenceError,TypeError,RangeError],l=!1;t.disable=r,t.enable=o},function(e,t,n){"use strict";function r(e,t,n,r,o){}e.exports=r},function(e,t,n){"use strict";var r=n(8),o=n(1),i=(n(2),n(118)),a=n(116);e.exports=function(e,t){function n(e){var t=e&&(T&&e[T]||e[O]);if("function"==typeof t)return t}function s(e,t){return e===t?0!==e||1/e===1/t:e!==e&&t!==t}function u(e){this.message=e,this.stack=""}function l(e){function n(n,r,a,s,l,c,p){if(s=s||P,c=c||a,p!==i)if(t)o(!1,"Calling PropTypes validators directly is not supported by the `prop-types` package. Use `PropTypes.checkPropTypes()` to call them. Read more at http://fb.me/use-check-prop-types");else;return null==r[a]?n?new u(null===r[a]?"The "+l+" `"+c+"` is marked as required "+("in `"+s+"`, but its value is `null`."):"The "+l+" `"+c+"` is marked as required in "+("`"+s+"`, but its value is `undefined`.")):null:e(r,a,s,l,c)}var r=n.bind(null,!1);return r.isRequired=n.bind(null,!0),r}function c(e){function t(t,n,r,o,i,a){var s=t[n],l=w(s);if(l!==e){var c=E(s);return new u("Invalid "+o+" `"+i+"` of type "+("`"+c+"` supplied to `"+r+"`, expected ")+("`"+e+"`."))}return null}return l(t)}function p(){return l(r.thatReturnsNull)}function f(e){function t(t,n,r,o,a){if("function"!=typeof e)return new u("Property `"+a+"` of component `"+r+"` has invalid PropType notation inside arrayOf.");var s=t[n];if(!Array.isArray(s)){var l=w(s);return new u("Invalid "+o+" `"+a+"` of type "+("`"+l+"` supplied to `"+r+"`, expected an array."))}for(var c=0;c<s.length;c++){var p=e(s,c,r,o,a+"["+c+"]",i);if(p instanceof Error)return p}return null}return l(t)}function d(){function t(t,n,r,o,i){var a=t[n];if(!e(a)){var s=w(a);return new u("Invalid "+o+" `"+i+"` of type "+("`"+s+"` supplied to `"+r+"`, expected a single ReactElement."))}return null}return l(t)}function h(e){function t(t,n,r,o,i){if(!(t[n]instanceof e)){var a=e.name||P,s=x(t[n]);return new u("Invalid "+o+" `"+i+"` of type "+("`"+s+"` supplied to `"+r+"`, expected ")+("instance of `"+a+"`."))}return null}return l(t)}function v(e){function t(t,n,r,o,i){for(var a=t[n],l=0;l<e.length;l++)if(s(a,e[l]))return null;var c=JSON.stringify(e);return new u("Invalid "+o+" `"+i+"` of value `"+a+"` "+("supplied to `"+r+"`, expected one of "+c+"."))}return Array.isArray(e)?l(t):r.thatReturnsNull}function m(e){function t(t,n,r,o,a){if("function"!=typeof e)return new u("Property `"+a+"` of component `"+r+"` has invalid PropType notation inside objectOf.");var s=t[n],l=w(s);if("object"!==l)return new u("Invalid "+o+" `"+a+"` of type "+("`"+l+"` supplied to `"+r+"`, expected an object."));for(var c in s)if(s.hasOwnProperty(c)){var p=e(s,c,r,o,a+"."+c,i);if(p instanceof Error)return p}return null}return l(t)}function g(e){function t(t,n,r,o,a){for(var s=0;s<e.length;s++){var l=e[s];if(null==l(t,n,r,o,a,i))return null}return new u("Invalid "+o+" `"+a+"` supplied to "+("`"+r+"`."))}return Array.isArray(e)?l(t):r.thatReturnsNull}function y(){function e(e,t,n,r,o){return C(e[t])?null:new u("Invalid "+r+" `"+o+"` supplied to "+("`"+n+"`, expected a ReactNode."))}return l(e)}function b(e){function t(t,n,r,o,a){var s=t[n],l=w(s);if("object"!==l)return new u("Invalid "+o+" `"+a+"` of type `"+l+"` "+("supplied to `"+r+"`, expected `object`."));for(var c in e){var p=e[c];if(p){var f=p(s,c,r,o,a+"."+c,i);if(f)return f}}return null}return l(t)}function C(t){switch(typeof t){case"number":case"string":case"undefined":return!0;case"boolean":return!t;case"object":if(Array.isArray(t))return t.every(C);if(null===t||e(t))return!0;var r=n(t);if(!r)return!1;var o,i=r.call(t);if(r!==t.entries){for(;!(o=i.next()).done;)if(!C(o.value))return!1}else for(;!(o=i.next()).done;){var a=o.value;if(a&&!C(a[1]))return!1}return!0;default:return!1}}function _(e,t){return"symbol"===e||("Symbol"===t["@@toStringTag"]||"function"==typeof Symbol&&t instanceof Symbol)}function w(e){var t=typeof e;return Array.isArray(e)?"array":e instanceof RegExp?"object":_(t,e)?"symbol":t}function E(e){var t=w(e);if("object"===t){if(e instanceof Date)return"date";if(e instanceof RegExp)return"regexp"}return t}function x(e){return e.constructor&&e.constructor.name?e.constructor.name:P}var T="function"==typeof Symbol&&Symbol.iterator,O="@@iterator",P="<<anonymous>>",k={array:c("array"),bool:c("boolean"),func:c("function"),number:c("number"),object:c("object"),string:c("string"),symbol:c("symbol"),any:p(),arrayOf:f,element:d(),instanceOf:h,node:y(),objectOf:m,oneOf:v,oneOfType:g,shape:b};return u.prototype=Error.prototype,k.checkPropTypes=a,k.PropTypes=k,k}},function(e,t){"use strict";var n="SECRET_DO_NOT_PASS_THIS_OR_YOU_WILL_BE_FIRED";e.exports=n},function(e,t,n){"use strict";function r(e,t,n){return!o(e.props,t)||!o(e.state,n)}var o=n(30);e.exports=r},function(e,t){"use strict";var n={Properties:{"aria-current":0,"aria-details":0,"aria-disabled":0,"aria-hidden":0,"aria-invalid":0,"aria-keyshortcuts":0,"aria-label":0,"aria-roledescription":0,"aria-autocomplete":0,"aria-checked":0,"aria-expanded":0,"aria-haspopup":0,"aria-level":0,"aria-modal":0,"aria-multiline":0,"aria-multiselectable":0,"aria-orientation":0,"aria-placeholder":0,"aria-pressed":0,"aria-readonly":0,"aria-required":0,"aria-selected":0,"aria-sort":0,"aria-valuemax":0,"aria-valuemin":0,"aria-valuenow":0,"aria-valuetext":0,"aria-atomic":0,"aria-busy":0,"aria-live":0,"aria-relevant":0,"aria-dropeffect":0,"aria-grabbed":0,"aria-activedescendant":0,"aria-colcount":0,"aria-colindex":0,"aria-colspan":0,"aria-controls":0,"aria-describedby":0,"aria-errormessage":0,"aria-flowto":0,"aria-labelledby":0,"aria-owns":0,"aria-posinset":0,"aria-rowcount":0,"aria-rowindex":0,"aria-rowspan":0,"aria-setsize":0},DOMAttributeNames:{},DOMPropertyNames:{}};e.exports=n},function(e,t,n){"use strict";var r=n(5),o=n(58),i={focusDOMComponent:function(){o(r.getNodeFromInstance(this))}};e.exports=i},function(e,t,n){"use strict";function r(){var e=window.opera;return"object"==typeof e&&"function"==typeof e.version&&parseInt(e.version(),10)<=12}function o(e){return(e.ctrlKey||e.altKey||e.metaKey)&&!(e.ctrlKey&&e.altKey)}function i(e){switch(e){case"topCompositionStart":return O.compositionStart;case"topCompositionEnd":return O.compositionEnd;case"topCompositionUpdate":return O.compositionUpdate}}function a(e,t){return"topKeyDown"===e&&t.keyCode===b}function s(e,t){switch(e){case"topKeyUp":return y.indexOf(t.keyCode)!==-1;case"topKeyDown":return t.keyCode!==b;case"topKeyPress":case"topMouseDown":case"topBlur":return!0;default:return!1}}function u(e){var t=e.detail;return"object"==typeof t&&"data"in t?t.data:null}function l(e,t,n,r){var o,l;if(C?o=i(e):k?s(e,n)&&(o=O.compositionEnd):a(e,n)&&(o=O.compositionStart),!o)return null;E&&(k||o!==O.compositionStart?o===O.compositionEnd&&k&&(l=k.getData()):k=v.getPooled(r));var c=m.getPooled(o,t,n,r);if(l)c.data=l;else{var p=u(n);null!==p&&(c.data=p)}return d.accumulateTwoPhaseDispatches(c),c}function c(e,t){switch(e){case"topCompositionEnd":return u(t);case"topKeyPress":var n=t.which;return n!==x?null:(P=!0,T);case"topTextInput":var r=t.data;return r===T&&P?null:r;default:return null}}function p(e,t){if(k){if("topCompositionEnd"===e||!C&&s(e,t)){var n=k.getData();return v.release(k),k=null,n}return null}switch(e){case"topPaste":return null;case"topKeyPress":return t.which&&!o(t)?String.fromCharCode(t.which):null;case"topCompositionEnd":return E?null:t.data;default:return null}}function f(e,t,n,r){var o;if(o=w?c(e,n):p(e,n),!o)return null;var i=g.getPooled(O.beforeInput,t,n,r);return i.data=o,d.accumulateTwoPhaseDispatches(i),i}var d=n(26),h=n(7),v=n(128),m=n(164),g=n(167),y=[9,13,27,32],b=229,C=h.canUseDOM&&"CompositionEvent"in window,_=null;h.canUseDOM&&"documentMode"in document&&(_=document.documentMode);var w=h.canUseDOM&&"TextEvent"in window&&!_&&!r(),E=h.canUseDOM&&(!C||_&&_>8&&_<=11),x=32,T=String.fromCharCode(x),O={beforeInput:{phasedRegistrationNames:{bubbled:"onBeforeInput",captured:"onBeforeInputCapture"},dependencies:["topCompositionEnd","topKeyPress","topTextInput","topPaste"]},compositionEnd:{phasedRegistrationNames:{bubbled:"onCompositionEnd",captured:"onCompositionEndCapture"},dependencies:["topBlur","topCompositionEnd","topKeyDown","topKeyPress","topKeyUp","topMouseDown"]},compositionStart:{phasedRegistrationNames:{bubbled:"onCompositionStart",captured:"onCompositionStartCapture"},dependencies:["topBlur","topCompositionStart","topKeyDown","topKeyPress","topKeyUp","topMouseDown"]},compositionUpdate:{phasedRegistrationNames:{bubbled:"onCompositionUpdate",captured:"onCompositionUpdateCapture"},dependencies:["topBlur","topCompositionUpdate","topKeyDown","topKeyPress","topKeyUp","topMouseDown"]}},P=!1,k=null,S={eventTypes:O,extractEvents:function(e,t,n,r){return[l(e,t,n,r),f(e,t,n,r)]}};e.exports=S},function(e,t,n){"use strict";var r=n(62),o=n(7),i=(n(9),n(98),n(173)),a=n(105),s=n(108),u=(n(2),s(function(e){return a(e)})),l=!1,c="cssFloat";if(o.canUseDOM){var p=document.createElement("div").style;try{p.font=""}catch(e){l=!0}void 0===document.documentElement.style.cssFloat&&(c="styleFloat")}var f={createMarkupForStyles:function(e,t){var n="";for(var r in e)if(e.hasOwnProperty(r)){var o=e[r];null!=o&&(n+=u(r)+":",n+=i(r,o,t)+";")}return n||null},setValueForStyles:function(e,t,n){var o=e.style;for(var a in t)if(t.hasOwnProperty(a)){var s=i(a,t[a],n);if("float"!==a&&"cssFloat"!==a||(a=c),s)o[a]=s;else{var u=l&&r.shorthandPropertyExpansions[a];if(u)for(var p in u)o[p]="";else o[a]=""}}}};e.exports=f},function(e,t,n){"use strict";function r(e){var t=e.nodeName&&e.nodeName.toLowerCase();return"select"===t||"input"===t&&"file"===e.type}function o(e){var t=x.getPooled(k.change,N,e,T(e));C.accumulateTwoPhaseDispatches(t),E.batchedUpdates(i,t)}function i(e){b.enqueueEvents(e),b.processEventQueue(!1)}function a(e,t){S=e,N=t,S.attachEvent("onchange",o)}function s(){S&&(S.detachEvent("onchange",o),S=null,N=null)}function u(e,t){if("topChange"===e)return t}function l(e,t,n){"topFocus"===e?(s(),a(t,n)):"topBlur"===e&&s()}function c(e,t){S=e,N=t,M=e.value,A=Object.getOwnPropertyDescriptor(e.constructor.prototype,"value"),Object.defineProperty(S,"value",R),S.attachEvent?S.attachEvent("onpropertychange",f):S.addEventListener("propertychange",f,!1)}function p(){S&&(delete S.value,S.detachEvent?S.detachEvent("onpropertychange",f):S.removeEventListener("propertychange",f,!1),S=null,N=null,M=null,A=null)}function f(e){if("value"===e.propertyName){var t=e.srcElement.value;t!==M&&(M=t,o(e))}}function d(e,t){if("topInput"===e)return t}function h(e,t,n){"topFocus"===e?(p(),c(t,n)):"topBlur"===e&&p()}function v(e,t){if(("topSelectionChange"===e||"topKeyUp"===e||"topKeyDown"===e)&&S&&S.value!==M)return M=S.value,N}function m(e){return e.nodeName&&"input"===e.nodeName.toLowerCase()&&("checkbox"===e.type||"radio"===e.type)}function g(e,t){if("topClick"===e)return t}function y(e,t){if(null!=e){var n=e._wrapperState||t._wrapperState;if(n&&n.controlled&&"number"===t.type){var r=""+t.value;t.getAttribute("value")!==r&&t.setAttribute("value",r)}}}var b=n(25),C=n(26),_=n(7),w=n(5),E=n(10),x=n(11),T=n(49),O=n(50),P=n(81),k={change:{phasedRegistrationNames:{bubbled:"onChange",captured:"onChangeCapture"},dependencies:["topBlur","topChange","topClick","topFocus","topInput","topKeyDown","topKeyUp","topSelectionChange"]}},S=null,N=null,M=null,A=null,I=!1;_.canUseDOM&&(I=O("change")&&(!document.documentMode||document.documentMode>8));var D=!1;_.canUseDOM&&(D=O("input")&&(!document.documentMode||document.documentMode>11));var R={get:function(){return A.get.call(this)},set:function(e){M=""+e,A.set.call(this,e)}},L={eventTypes:k,extractEvents:function(e,t,n,o){var i,a,s=t?w.getNodeFromInstance(t):window;if(r(s)?I?i=u:a=l:P(s)?D?i=d:(i=v,a=h):m(s)&&(i=g),i){var c=i(e,t);if(c){var p=x.getPooled(k.change,c,n,o);return p.type="change",C.accumulateTwoPhaseDispatches(p),p}}a&&a(e,s,t),"topBlur"===e&&y(t,s)}};e.exports=L},function(e,t,n){"use strict";var r=n(3),o=n(18),i=n(7),a=n(101),s=n(8),u=(n(1),{dangerouslyReplaceNodeWithMarkup:function(e,t){if(i.canUseDOM?void 0:r("56"),t?void 0:r("57"),"HTML"===e.nodeName?r("58"):void 0,"string"==typeof t){var n=a(t,s)[0];e.parentNode.replaceChild(n,e)}else o.replaceChildWithTree(e,t)}});e.exports=u},function(e,t){"use strict";var n=["ResponderEventPlugin","SimpleEventPlugin","TapEventPlugin","EnterLeaveEventPlugin","ChangeEventPlugin","SelectEventPlugin","BeforeInputEventPlugin"];e.exports=n},function(e,t,n){"use strict";var r=n(26),o=n(5),i=n(32),a={mouseEnter:{registrationName:"onMouseEnter",dependencies:["topMouseOut","topMouseOver"]},mouseLeave:{registrationName:"onMouseLeave",dependencies:["topMouseOut","topMouseOver"]}},s={eventTypes:a,extractEvents:function(e,t,n,s){if("topMouseOver"===e&&(n.relatedTarget||n.fromElement))return null;if("topMouseOut"!==e&&"topMouseOver"!==e)return null;var u;if(s.window===s)u=s;else{var l=s.ownerDocument;u=l?l.defaultView||l.parentWindow:window}var c,p;if("topMouseOut"===e){c=t;var f=n.relatedTarget||n.toElement;p=f?o.getClosestInstanceFromNode(f):null}else c=null,p=t;if(c===p)return null;var d=null==c?u:o.getNodeFromInstance(c),h=null==p?u:o.getNodeFromInstance(p),v=i.getPooled(a.mouseLeave,c,n,s);v.type="mouseleave",v.target=d,v.relatedTarget=h;var m=i.getPooled(a.mouseEnter,p,n,s);return m.type="mouseenter",m.target=h,m.relatedTarget=d,r.accumulateEnterLeaveDispatches(v,m,c,p),[v,m]}};e.exports=s},function(e,t,n){"use strict";function r(e){this._root=e,this._startText=this.getText(),this._fallbackText=null}var o=n(4),i=n(15),a=n(78);o(r.prototype,{destructor:function(){this._root=null,this._startText=null,this._fallbackText=null},getText:function(){return"value"in this._root?this._root.value:this._root[a()]},getData:function(){if(this._fallbackText)return this._fallbackText;var e,t,n=this._startText,r=n.length,o=this.getText(),i=o.length;for(e=0;e<r&&n[e]===o[e];e++);var a=r-e;for(t=1;t<=a&&n[r-t]===o[i-t];t++);var s=t>1?1-t:void 0;return this._fallbackText=o.slice(e,s),this._fallbackText}}),i.addPoolingTo(r),e.exports=r},function(e,t,n){"use strict";var r=n(19),o=r.injection.MUST_USE_PROPERTY,i=r.injection.HAS_BOOLEAN_VALUE,a=r.injection.HAS_NUMERIC_VALUE,s=r.injection.HAS_POSITIVE_NUMERIC_VALUE,u=r.injection.HAS_OVERLOADED_BOOLEAN_VALUE,l={isCustomAttribute:RegExp.prototype.test.bind(new RegExp("^(data|aria)-["+r.ATTRIBUTE_NAME_CHAR+"]*$")),Properties:{accept:0,acceptCharset:0,accessKey:0,action:0,allowFullScreen:i,allowTransparency:0,alt:0,as:0,async:i,autoComplete:0,autoPlay:i,capture:i,cellPadding:0,cellSpacing:0,charSet:0,challenge:0,checked:o|i,cite:0,classID:0,className:0,cols:s,colSpan:0,content:0,contentEditable:0,contextMenu:0,controls:i,coords:0,crossOrigin:0,data:0,dateTime:0,default:i,defer:i,dir:0,disabled:i,download:u,draggable:0,encType:0,form:0,formAction:0,formEncType:0,formMethod:0,formNoValidate:i,formTarget:0,frameBorder:0,headers:0,height:0,hidden:i,high:0,href:0,hrefLang:0,htmlFor:0,httpEquiv:0,icon:0,id:0,inputMode:0,integrity:0,is:0,keyParams:0,keyType:0,kind:0,label:0,lang:0,list:0,loop:i,low:0,manifest:0,marginHeight:0,marginWidth:0,max:0,maxLength:0,media:0,mediaGroup:0,method:0,min:0,minLength:0,multiple:o|i,muted:o|i,name:0,nonce:0,noValidate:i,open:i,optimum:0,pattern:0,placeholder:0,playsInline:i,poster:0,preload:0,profile:0,radioGroup:0,readOnly:i,referrerPolicy:0,rel:0,required:i,reversed:i,role:0,rows:s,rowSpan:a,sandbox:0,scope:0,scoped:i,scrolling:0,seamless:i,selected:o|i,shape:0,size:s,sizes:0,span:s,spellCheck:0,src:0,srcDoc:0,srcLang:0,srcSet:0,start:a,step:0,style:0,summary:0,tabIndex:0,target:0,title:0,type:0,useMap:0,value:0,width:0,wmode:0,wrap:0,about:0,datatype:0,inlist:0,prefix:0,property:0,resource:0,typeof:0,vocab:0,autoCapitalize:0,autoCorrect:0,autoSave:0,color:0,itemProp:0,itemScope:i,itemType:0,itemID:0,itemRef:0,results:0,security:0,unselectable:0},DOMAttributeNames:{acceptCharset:"accept-charset",className:"class",htmlFor:"for",httpEquiv:"http-equiv"},DOMPropertyNames:{},DOMMutationMethods:{value:function(e,t){return null==t?e.removeAttribute("value"):void("number"!==e.type||e.hasAttribute("value")===!1?e.setAttribute("value",""+t):e.validity&&!e.validity.badInput&&e.ownerDocument.activeElement!==e&&e.setAttribute("value",""+t))}}};e.exports=l},function(e,t,n){(function(t){"use strict";function r(e,t,n,r){var o=void 0===e[n];null!=t&&o&&(e[n]=i(t,!0))}var o=n(20),i=n(80),a=(n(41),n(51)),s=n(83),u=(n(2),{instantiateChildren:function(e,t,n,o){if(null==e)return null;var i={};return s(e,r,i),i},updateChildren:function(e,t,n,r,s,u,l,c,p){if(t||e){var f,d;for(f in t)if(t.hasOwnProperty(f)){d=e&&e[f];var h=d&&d._currentElement,v=t[f];if(null!=d&&a(h,v))o.receiveComponent(d,v,s,c),t[f]=d;else{d&&(r[f]=o.getHostNode(d),o.unmountComponent(d,!1));var m=i(v,!0);t[f]=m;var g=o.mountComponent(m,s,u,l,c,p);n.push(g)}}for(f in e)!e.hasOwnProperty(f)||t&&t.hasOwnProperty(f)||(d=e[f],r[f]=o.getHostNode(d),o.unmountComponent(d,!1))}},unmountChildren:function(e,t){for(var n in e)if(e.hasOwnProperty(n)){var r=e[n];o.unmountComponent(r,t)}}});e.exports=u}).call(t,n(36))},function(e,t,n){"use strict";var r=n(37),o=n(137),i={processChildrenUpdates:o.dangerouslyProcessChildrenUpdates,replaceNodeWithMarkup:r.dangerouslyReplaceNodeWithMarkup};e.exports=i},function(e,t,n){"use strict";function r(e){}function o(e,t){}function i(e){return!(!e.prototype||!e.prototype.isReactComponent)}function a(e){return!(!e.prototype||!e.prototype.isPureReactComponent)}var s=n(3),u=n(4),l=n(12),c=n(43),p=n(13),f=n(44),d=n(27),h=(n(9),n(73)),v=n(20),m=n(23),g=(n(1),n(30)),y=n(51),b=(n(2),{ImpureClass:0,PureClass:1,StatelessFunctional:2});r.prototype.render=function(){var e=d.get(this)._currentElement.type,t=e(this.props,this.context,this.updater);return o(e,t),t};var C=1,_={construct:function(e){this._currentElement=e,this._rootNodeID=0,this._compositeType=null,this._instance=null,this._hostParent=null,this._hostContainerInfo=null,this._updateBatchNumber=null,this._pendingElement=null,this._pendingStateQueue=null,this._pendingReplaceState=!1,this._pendingForceUpdate=!1,this._renderedNodeType=null,this._renderedComponent=null,this._context=null,this._mountOrder=0,this._topLevelWrapper=null,this._pendingCallbacks=null,this._calledComponentWillUnmount=!1},mountComponent:function(e,t,n,u){this._context=u,this._mountOrder=C++,this._hostParent=t,this._hostContainerInfo=n;var c,p=this._currentElement.props,f=this._processContext(u),h=this._currentElement.type,v=e.getUpdateQueue(),g=i(h),y=this._constructComponent(g,p,f,v);g||null!=y&&null!=y.render?a(h)?this._compositeType=b.PureClass:this._compositeType=b.ImpureClass:(c=y,o(h,c),null===y||y===!1||l.isValidElement(y)?void 0:s("105",h.displayName||h.name||"Component"),y=new r(h),this._compositeType=b.StatelessFunctional);y.props=p,y.context=f,y.refs=m,y.updater=v,this._instance=y,d.set(y,this);var _=y.state;void 0===_&&(y.state=_=null),"object"!=typeof _||Array.isArray(_)?s("106",this.getName()||"ReactCompositeComponent"):void 0,this._pendingStateQueue=null,this._pendingReplaceState=!1,this._pendingForceUpdate=!1;var w;return w=y.unstable_handleError?this.performInitialMountWithErrorHandling(c,t,n,e,u):this.performInitialMount(c,t,n,e,u),y.componentDidMount&&e.getReactMountReady().enqueue(y.componentDidMount,y),w},_constructComponent:function(e,t,n,r){return this._constructComponentWithoutOwner(e,t,n,r)},_constructComponentWithoutOwner:function(e,t,n,r){var o=this._currentElement.type;return e?new o(t,n,r):o(t,n,r);
-},performInitialMountWithErrorHandling:function(e,t,n,r,o){var i,a=r.checkpoint();try{i=this.performInitialMount(e,t,n,r,o)}catch(s){r.rollback(a),this._instance.unstable_handleError(s),this._pendingStateQueue&&(this._instance.state=this._processPendingState(this._instance.props,this._instance.context)),a=r.checkpoint(),this._renderedComponent.unmountComponent(!0),r.rollback(a),i=this.performInitialMount(e,t,n,r,o)}return i},performInitialMount:function(e,t,n,r,o){var i=this._instance,a=0;i.componentWillMount&&(i.componentWillMount(),this._pendingStateQueue&&(i.state=this._processPendingState(i.props,i.context))),void 0===e&&(e=this._renderValidatedComponent());var s=h.getType(e);this._renderedNodeType=s;var u=this._instantiateReactComponent(e,s!==h.EMPTY);this._renderedComponent=u;var l=v.mountComponent(u,r,t,n,this._processChildContext(o),a);return l},getHostNode:function(){return v.getHostNode(this._renderedComponent)},unmountComponent:function(e){if(this._renderedComponent){var t=this._instance;if(t.componentWillUnmount&&!t._calledComponentWillUnmount)if(t._calledComponentWillUnmount=!0,e){var n=this.getName()+".componentWillUnmount()";f.invokeGuardedCallback(n,t.componentWillUnmount.bind(t))}else t.componentWillUnmount();this._renderedComponent&&(v.unmountComponent(this._renderedComponent,e),this._renderedNodeType=null,this._renderedComponent=null,this._instance=null),this._pendingStateQueue=null,this._pendingReplaceState=!1,this._pendingForceUpdate=!1,this._pendingCallbacks=null,this._pendingElement=null,this._context=null,this._rootNodeID=0,this._topLevelWrapper=null,d.remove(t)}},_maskContext:function(e){var t=this._currentElement.type,n=t.contextTypes;if(!n)return m;var r={};for(var o in n)r[o]=e[o];return r},_processContext:function(e){var t=this._maskContext(e);return t},_processChildContext:function(e){var t,n=this._currentElement.type,r=this._instance;if(r.getChildContext&&(t=r.getChildContext()),t){"object"!=typeof n.childContextTypes?s("107",this.getName()||"ReactCompositeComponent"):void 0;for(var o in t)o in n.childContextTypes?void 0:s("108",this.getName()||"ReactCompositeComponent",o);return u({},e,t)}return e},_checkContextTypes:function(e,t,n){},receiveComponent:function(e,t,n){var r=this._currentElement,o=this._context;this._pendingElement=null,this.updateComponent(t,r,e,o,n)},performUpdateIfNecessary:function(e){null!=this._pendingElement?v.receiveComponent(this,this._pendingElement,e,this._context):null!==this._pendingStateQueue||this._pendingForceUpdate?this.updateComponent(e,this._currentElement,this._currentElement,this._context,this._context):this._updateBatchNumber=null},updateComponent:function(e,t,n,r,o){var i=this._instance;null==i?s("136",this.getName()||"ReactCompositeComponent"):void 0;var a,u=!1;this._context===o?a=i.context:(a=this._processContext(o),u=!0);var l=t.props,c=n.props;t!==n&&(u=!0),u&&i.componentWillReceiveProps&&i.componentWillReceiveProps(c,a);var p=this._processPendingState(c,a),f=!0;this._pendingForceUpdate||(i.shouldComponentUpdate?f=i.shouldComponentUpdate(c,p,a):this._compositeType===b.PureClass&&(f=!g(l,c)||!g(i.state,p))),this._updateBatchNumber=null,f?(this._pendingForceUpdate=!1,this._performComponentUpdate(n,c,p,a,e,o)):(this._currentElement=n,this._context=o,i.props=c,i.state=p,i.context=a)},_processPendingState:function(e,t){var n=this._instance,r=this._pendingStateQueue,o=this._pendingReplaceState;if(this._pendingReplaceState=!1,this._pendingStateQueue=null,!r)return n.state;if(o&&1===r.length)return r[0];for(var i=u({},o?r[0]:n.state),a=o?1:0;a<r.length;a++){var s=r[a];u(i,"function"==typeof s?s.call(n,i,e,t):s)}return i},_performComponentUpdate:function(e,t,n,r,o,i){var a,s,u,l=this._instance,c=Boolean(l.componentDidUpdate);c&&(a=l.props,s=l.state,u=l.context),l.componentWillUpdate&&l.componentWillUpdate(t,n,r),this._currentElement=e,this._context=i,l.props=t,l.state=n,l.context=r,this._updateRenderedComponent(o,i),c&&o.getReactMountReady().enqueue(l.componentDidUpdate.bind(l,a,s,u),l)},_updateRenderedComponent:function(e,t){var n=this._renderedComponent,r=n._currentElement,o=this._renderValidatedComponent(),i=0;if(y(r,o))v.receiveComponent(n,o,e,this._processChildContext(t));else{var a=v.getHostNode(n);v.unmountComponent(n,!1);var s=h.getType(o);this._renderedNodeType=s;var u=this._instantiateReactComponent(o,s!==h.EMPTY);this._renderedComponent=u;var l=v.mountComponent(u,e,this._hostParent,this._hostContainerInfo,this._processChildContext(t),i);this._replaceNodeWithMarkup(a,l,n)}},_replaceNodeWithMarkup:function(e,t,n){c.replaceNodeWithMarkup(e,t,n)},_renderValidatedComponentWithoutOwnerOrContext:function(){var e,t=this._instance;return e=t.render()},_renderValidatedComponent:function(){var e;if(this._compositeType!==b.StatelessFunctional){p.current=this;try{e=this._renderValidatedComponentWithoutOwnerOrContext()}finally{p.current=null}}else e=this._renderValidatedComponentWithoutOwnerOrContext();return null===e||e===!1||l.isValidElement(e)?void 0:s("109",this.getName()||"ReactCompositeComponent"),e},attachRef:function(e,t){var n=this.getPublicInstance();null==n?s("110"):void 0;var r=t.getPublicInstance(),o=n.refs===m?n.refs={}:n.refs;o[e]=r},detachRef:function(e){var t=this.getPublicInstance().refs;delete t[e]},getName:function(){var e=this._currentElement.type,t=this._instance&&this._instance.constructor;return e.displayName||t&&t.displayName||e.name||t&&t.name||null},getPublicInstance:function(){var e=this._instance;return this._compositeType===b.StatelessFunctional?null:e},_instantiateReactComponent:null};e.exports=_},function(e,t,n){"use strict";function r(e){if(e){var t=e._currentElement._owner||null;if(t){var n=t.getName();if(n)return" This DOM node was rendered by `"+n+"`."}}return""}function o(e,t){t&&(X[e._tag]&&(null!=t.children||null!=t.dangerouslySetInnerHTML?v("137",e._tag,e._currentElement._owner?" Check the render method of "+e._currentElement._owner.getName()+".":""):void 0),null!=t.dangerouslySetInnerHTML&&(null!=t.children?v("60"):void 0,"object"==typeof t.dangerouslySetInnerHTML&&W in t.dangerouslySetInnerHTML?void 0:v("61")),null!=t.style&&"object"!=typeof t.style?v("62",r(e)):void 0)}function i(e,t,n,r){if(!(r instanceof I)){var o=e._hostContainerInfo,i=o._node&&o._node.nodeType===q,s=i?o._node:o._ownerDocument;F(t,s),r.getReactMountReady().enqueue(a,{inst:e,registrationName:t,listener:n})}}function a(){var e=this;E.putListener(e.inst,e.registrationName,e.listener)}function s(){var e=this;k.postMountWrapper(e)}function u(){var e=this;M.postMountWrapper(e)}function l(){var e=this;S.postMountWrapper(e)}function c(){var e=this;e._rootNodeID?void 0:v("63");var t=U(e);switch(t?void 0:v("64"),e._tag){case"iframe":case"object":e._wrapperState.listeners=[T.trapBubbledEvent("topLoad","load",t)];break;case"video":case"audio":e._wrapperState.listeners=[];for(var n in z)z.hasOwnProperty(n)&&e._wrapperState.listeners.push(T.trapBubbledEvent(n,z[n],t));break;case"source":e._wrapperState.listeners=[T.trapBubbledEvent("topError","error",t)];break;case"img":e._wrapperState.listeners=[T.trapBubbledEvent("topError","error",t),T.trapBubbledEvent("topLoad","load",t)];break;case"form":e._wrapperState.listeners=[T.trapBubbledEvent("topReset","reset",t),T.trapBubbledEvent("topSubmit","submit",t)];break;case"input":case"select":case"textarea":e._wrapperState.listeners=[T.trapBubbledEvent("topInvalid","invalid",t)]}}function p(){N.postUpdateWrapper(this)}function f(e){$.call(Q,e)||(G.test(e)?void 0:v("65",e),Q[e]=!0)}function d(e,t){return e.indexOf("-")>=0||null!=t.is}function h(e){var t=e.type;f(t),this._currentElement=e,this._tag=t.toLowerCase(),this._namespaceURI=null,this._renderedChildren=null,this._previousStyle=null,this._previousStyleCopy=null,this._hostNode=null,this._hostParent=null,this._rootNodeID=0,this._domID=0,this._hostContainerInfo=null,this._wrapperState=null,this._topLevelWrapper=null,this._flags=0}var v=n(3),m=n(4),g=n(121),y=n(123),b=n(18),C=n(38),_=n(19),w=n(64),E=n(25),x=n(39),T=n(31),O=n(66),P=n(5),k=n(138),S=n(139),N=n(67),M=n(142),A=(n(9),n(151)),I=n(156),D=(n(8),n(34)),R=(n(1),n(50),n(30),n(52),n(2),O),L=E.deleteListener,U=P.getNodeFromInstance,F=T.listenTo,j=x.registrationNameModules,B={string:!0,number:!0},V="style",W="__html",H={children:null,dangerouslySetInnerHTML:null,suppressContentEditableWarning:null},q=11,z={topAbort:"abort",topCanPlay:"canplay",topCanPlayThrough:"canplaythrough",topDurationChange:"durationchange",topEmptied:"emptied",topEncrypted:"encrypted",topEnded:"ended",topError:"error",topLoadedData:"loadeddata",topLoadedMetadata:"loadedmetadata",topLoadStart:"loadstart",topPause:"pause",topPlay:"play",topPlaying:"playing",topProgress:"progress",topRateChange:"ratechange",topSeeked:"seeked",topSeeking:"seeking",topStalled:"stalled",topSuspend:"suspend",topTimeUpdate:"timeupdate",topVolumeChange:"volumechange",topWaiting:"waiting"},K={area:!0,base:!0,br:!0,col:!0,embed:!0,hr:!0,img:!0,input:!0,keygen:!0,link:!0,meta:!0,param:!0,source:!0,track:!0,wbr:!0},Y={listing:!0,pre:!0,textarea:!0},X=m({menuitem:!0},K),G=/^[a-zA-Z][a-zA-Z:_\.\-\d]*$/,Q={},$={}.hasOwnProperty,Z=1;h.displayName="ReactDOMComponent",h.Mixin={mountComponent:function(e,t,n,r){this._rootNodeID=Z++,this._domID=n._idCounter++,this._hostParent=t,this._hostContainerInfo=n;var i=this._currentElement.props;switch(this._tag){case"audio":case"form":case"iframe":case"img":case"link":case"object":case"source":case"video":this._wrapperState={listeners:null},e.getReactMountReady().enqueue(c,this);break;case"input":k.mountWrapper(this,i,t),i=k.getHostProps(this,i),e.getReactMountReady().enqueue(c,this);break;case"option":S.mountWrapper(this,i,t),i=S.getHostProps(this,i);break;case"select":N.mountWrapper(this,i,t),i=N.getHostProps(this,i),e.getReactMountReady().enqueue(c,this);break;case"textarea":M.mountWrapper(this,i,t),i=M.getHostProps(this,i),e.getReactMountReady().enqueue(c,this)}o(this,i);var a,p;null!=t?(a=t._namespaceURI,p=t._tag):n._tag&&(a=n._namespaceURI,p=n._tag),(null==a||a===C.svg&&"foreignobject"===p)&&(a=C.html),a===C.html&&("svg"===this._tag?a=C.svg:"math"===this._tag&&(a=C.mathml)),this._namespaceURI=a;var f;if(e.useCreateElement){var d,h=n._ownerDocument;if(a===C.html)if("script"===this._tag){var v=h.createElement("div"),m=this._currentElement.type;v.innerHTML="<"+m+"></"+m+">",d=v.removeChild(v.firstChild)}else d=i.is?h.createElement(this._currentElement.type,i.is):h.createElement(this._currentElement.type);else d=h.createElementNS(a,this._currentElement.type);P.precacheNode(this,d),this._flags|=R.hasCachedChildNodes,this._hostParent||w.setAttributeForRoot(d),this._updateDOMProperties(null,i,e);var y=b(d);this._createInitialChildren(e,i,r,y),f=y}else{var _=this._createOpenTagMarkupAndPutListeners(e,i),E=this._createContentMarkup(e,i,r);f=!E&&K[this._tag]?_+"/>":_+">"+E+"</"+this._currentElement.type+">"}switch(this._tag){case"input":e.getReactMountReady().enqueue(s,this),i.autoFocus&&e.getReactMountReady().enqueue(g.focusDOMComponent,this);break;case"textarea":e.getReactMountReady().enqueue(u,this),i.autoFocus&&e.getReactMountReady().enqueue(g.focusDOMComponent,this);break;case"select":i.autoFocus&&e.getReactMountReady().enqueue(g.focusDOMComponent,this);break;case"button":i.autoFocus&&e.getReactMountReady().enqueue(g.focusDOMComponent,this);break;case"option":e.getReactMountReady().enqueue(l,this)}return f},_createOpenTagMarkupAndPutListeners:function(e,t){var n="<"+this._currentElement.type;for(var r in t)if(t.hasOwnProperty(r)){var o=t[r];if(null!=o)if(j.hasOwnProperty(r))o&&i(this,r,o,e);else{r===V&&(o&&(o=this._previousStyleCopy=m({},t.style)),o=y.createMarkupForStyles(o,this));var a=null;null!=this._tag&&d(this._tag,t)?H.hasOwnProperty(r)||(a=w.createMarkupForCustomAttribute(r,o)):a=w.createMarkupForProperty(r,o),a&&(n+=" "+a)}}return e.renderToStaticMarkup?n:(this._hostParent||(n+=" "+w.createMarkupForRoot()),n+=" "+w.createMarkupForID(this._domID))},_createContentMarkup:function(e,t,n){var r="",o=t.dangerouslySetInnerHTML;if(null!=o)null!=o.__html&&(r=o.__html);else{var i=B[typeof t.children]?t.children:null,a=null!=i?null:t.children;if(null!=i)r=D(i);else if(null!=a){var s=this.mountChildren(a,e,n);r=s.join("")}}return Y[this._tag]&&"\n"===r.charAt(0)?"\n"+r:r},_createInitialChildren:function(e,t,n,r){var o=t.dangerouslySetInnerHTML;if(null!=o)null!=o.__html&&b.queueHTML(r,o.__html);else{var i=B[typeof t.children]?t.children:null,a=null!=i?null:t.children;if(null!=i)""!==i&&b.queueText(r,i);else if(null!=a)for(var s=this.mountChildren(a,e,n),u=0;u<s.length;u++)b.queueChild(r,s[u])}},receiveComponent:function(e,t,n){var r=this._currentElement;this._currentElement=e,this.updateComponent(t,r,e,n)},updateComponent:function(e,t,n,r){var i=t.props,a=this._currentElement.props;switch(this._tag){case"input":i=k.getHostProps(this,i),a=k.getHostProps(this,a);break;case"option":i=S.getHostProps(this,i),a=S.getHostProps(this,a);break;case"select":i=N.getHostProps(this,i),a=N.getHostProps(this,a);break;case"textarea":i=M.getHostProps(this,i),a=M.getHostProps(this,a)}switch(o(this,a),this._updateDOMProperties(i,a,e),this._updateDOMChildren(i,a,e,r),this._tag){case"input":k.updateWrapper(this);break;case"textarea":M.updateWrapper(this);break;case"select":e.getReactMountReady().enqueue(p,this)}},_updateDOMProperties:function(e,t,n){var r,o,a;for(r in e)if(!t.hasOwnProperty(r)&&e.hasOwnProperty(r)&&null!=e[r])if(r===V){var s=this._previousStyleCopy;for(o in s)s.hasOwnProperty(o)&&(a=a||{},a[o]="");this._previousStyleCopy=null}else j.hasOwnProperty(r)?e[r]&&L(this,r):d(this._tag,e)?H.hasOwnProperty(r)||w.deleteValueForAttribute(U(this),r):(_.properties[r]||_.isCustomAttribute(r))&&w.deleteValueForProperty(U(this),r);for(r in t){var u=t[r],l=r===V?this._previousStyleCopy:null!=e?e[r]:void 0;if(t.hasOwnProperty(r)&&u!==l&&(null!=u||null!=l))if(r===V)if(u?u=this._previousStyleCopy=m({},u):this._previousStyleCopy=null,l){for(o in l)!l.hasOwnProperty(o)||u&&u.hasOwnProperty(o)||(a=a||{},a[o]="");for(o in u)u.hasOwnProperty(o)&&l[o]!==u[o]&&(a=a||{},a[o]=u[o])}else a=u;else if(j.hasOwnProperty(r))u?i(this,r,u,n):l&&L(this,r);else if(d(this._tag,t))H.hasOwnProperty(r)||w.setValueForAttribute(U(this),r,u);else if(_.properties[r]||_.isCustomAttribute(r)){var c=U(this);null!=u?w.setValueForProperty(c,r,u):w.deleteValueForProperty(c,r)}}a&&y.setValueForStyles(U(this),a,this)},_updateDOMChildren:function(e,t,n,r){var o=B[typeof e.children]?e.children:null,i=B[typeof t.children]?t.children:null,a=e.dangerouslySetInnerHTML&&e.dangerouslySetInnerHTML.__html,s=t.dangerouslySetInnerHTML&&t.dangerouslySetInnerHTML.__html,u=null!=o?null:e.children,l=null!=i?null:t.children,c=null!=o||null!=a,p=null!=i||null!=s;null!=u&&null==l?this.updateChildren(null,n,r):c&&!p&&this.updateTextContent(""),null!=i?o!==i&&this.updateTextContent(""+i):null!=s?a!==s&&this.updateMarkup(""+s):null!=l&&this.updateChildren(l,n,r)},getHostNode:function(){return U(this)},unmountComponent:function(e){switch(this._tag){case"audio":case"form":case"iframe":case"img":case"link":case"object":case"source":case"video":var t=this._wrapperState.listeners;if(t)for(var n=0;n<t.length;n++)t[n].remove();break;case"html":case"head":case"body":v("66",this._tag)}this.unmountChildren(e),P.uncacheNode(this),E.deleteAllListeners(this),this._rootNodeID=0,this._domID=0,this._wrapperState=null},getPublicInstance:function(){return U(this)}},m(h.prototype,h.Mixin,A.Mixin),e.exports=h},function(e,t,n){"use strict";function r(e,t){var n={_topLevelWrapper:e,_idCounter:1,_ownerDocument:t?t.nodeType===o?t:t.ownerDocument:null,_node:t,_tag:t?t.nodeName.toLowerCase():null,_namespaceURI:t?t.namespaceURI:null};return n}var o=(n(52),9);e.exports=r},function(e,t,n){"use strict";var r=n(4),o=n(18),i=n(5),a=function(e){this._currentElement=null,this._hostNode=null,this._hostParent=null,this._hostContainerInfo=null,this._domID=0};r(a.prototype,{mountComponent:function(e,t,n,r){var a=n._idCounter++;this._domID=a,this._hostParent=t,this._hostContainerInfo=n;var s=" react-empty: "+this._domID+" ";if(e.useCreateElement){var u=n._ownerDocument,l=u.createComment(s);return i.precacheNode(this,l),o(l)}return e.renderToStaticMarkup?"":"<!--"+s+"-->"},receiveComponent:function(){},getHostNode:function(){return i.getNodeFromInstance(this)},unmountComponent:function(){i.uncacheNode(this)}}),e.exports=a},function(e,t){"use strict";var n={useCreateElement:!0,useFiber:!1};e.exports=n},function(e,t,n){"use strict";var r=n(37),o=n(5),i={dangerouslyProcessChildrenUpdates:function(e,t){var n=o.getNodeFromInstance(e);r.processUpdates(n,t)}};e.exports=i},function(e,t,n){"use strict";function r(){this._rootNodeID&&f.updateWrapper(this)}function o(e){var t="checkbox"===e.type||"radio"===e.type;return t?null!=e.checked:null!=e.value}function i(e){var t=this._currentElement.props,n=l.executeOnChange(t,e);p.asap(r,this);var o=t.name;if("radio"===t.type&&null!=o){for(var i=c.getNodeFromInstance(this),s=i;s.parentNode;)s=s.parentNode;for(var u=s.querySelectorAll("input[name="+JSON.stringify(""+o)+'][type="radio"]'),f=0;f<u.length;f++){var d=u[f];if(d!==i&&d.form===i.form){var h=c.getInstanceFromNode(d);h?void 0:a("90"),p.asap(r,h)}}}return n}var a=n(3),s=n(4),u=n(64),l=n(42),c=n(5),p=n(10),f=(n(1),n(2),{getHostProps:function(e,t){var n=l.getValue(t),r=l.getChecked(t),o=s({type:void 0,step:void 0,min:void 0,max:void 0},t,{defaultChecked:void 0,defaultValue:void 0,value:null!=n?n:e._wrapperState.initialValue,checked:null!=r?r:e._wrapperState.initialChecked,onChange:e._wrapperState.onChange});return o},mountWrapper:function(e,t){var n=t.defaultValue;e._wrapperState={initialChecked:null!=t.checked?t.checked:t.defaultChecked,initialValue:null!=t.value?t.value:n,listeners:null,onChange:i.bind(e),controlled:o(t)}},updateWrapper:function(e){var t=e._currentElement.props,n=t.checked;null!=n&&u.setValueForProperty(c.getNodeFromInstance(e),"checked",n||!1);var r=c.getNodeFromInstance(e),o=l.getValue(t);if(null!=o)if(0===o&&""===r.value)r.value="0";else if("number"===t.type){var i=parseFloat(r.value,10)||0;o!=i&&(r.value=""+o)}else o!=r.value&&(r.value=""+o);else null==t.value&&null!=t.defaultValue&&r.defaultValue!==""+t.defaultValue&&(r.defaultValue=""+t.defaultValue),null==t.checked&&null!=t.defaultChecked&&(r.defaultChecked=!!t.defaultChecked)},postMountWrapper:function(e){var t=e._currentElement.props,n=c.getNodeFromInstance(e);switch(t.type){case"submit":case"reset":break;case"color":case"date":case"datetime":case"datetime-local":case"month":case"time":case"week":n.value="",n.value=n.defaultValue;break;default:n.value=n.value}var r=n.name;""!==r&&(n.name=""),n.defaultChecked=!n.defaultChecked,n.defaultChecked=!n.defaultChecked,""!==r&&(n.name=r)}});e.exports=f},function(e,t,n){"use strict";function r(e){var t="";return i.Children.forEach(e,function(e){null!=e&&("string"==typeof e||"number"==typeof e?t+=e:u||(u=!0))}),t}var o=n(4),i=n(12),a=n(5),s=n(67),u=(n(2),!1),l={mountWrapper:function(e,t,n){var o=null;if(null!=n){var i=n;"optgroup"===i._tag&&(i=i._hostParent),null!=i&&"select"===i._tag&&(o=s.getSelectValueContext(i))}var a=null;if(null!=o){var u;if(u=null!=t.value?t.value+"":r(t.children),a=!1,Array.isArray(o)){for(var l=0;l<o.length;l++)if(""+o[l]===u){a=!0;break}}else a=""+o===u}e._wrapperState={selected:a}},postMountWrapper:function(e){var t=e._currentElement.props;if(null!=t.value){var n=a.getNodeFromInstance(e);n.setAttribute("value",t.value)}},getHostProps:function(e,t){var n=o({selected:void 0,children:void 0},t);null!=e._wrapperState.selected&&(n.selected=e._wrapperState.selected);var i=r(t.children);return i&&(n.children=i),n}};e.exports=l},function(e,t,n){"use strict";function r(e,t,n,r){return e===n&&t===r}function o(e){var t=document.selection,n=t.createRange(),r=n.text.length,o=n.duplicate();o.moveToElementText(e),o.setEndPoint("EndToStart",n);var i=o.text.length,a=i+r;return{start:i,end:a}}function i(e){var t=window.getSelection&&window.getSelection();if(!t||0===t.rangeCount)return null;var n=t.anchorNode,o=t.anchorOffset,i=t.focusNode,a=t.focusOffset,s=t.getRangeAt(0);try{s.startContainer.nodeType,s.endContainer.nodeType}catch(e){return null}var u=r(t.anchorNode,t.anchorOffset,t.focusNode,t.focusOffset),l=u?0:s.toString().length,c=s.cloneRange();c.selectNodeContents(e),c.setEnd(s.startContainer,s.startOffset);var p=r(c.startContainer,c.startOffset,c.endContainer,c.endOffset),f=p?0:c.toString().length,d=f+l,h=document.createRange();h.setStart(n,o),h.setEnd(i,a);var v=h.collapsed;return{start:v?d:f,end:v?f:d}}function a(e,t){var n,r,o=document.selection.createRange().duplicate();void 0===t.end?(n=t.start,r=n):t.start>t.end?(n=t.end,r=t.start):(n=t.start,r=t.end),o.moveToElementText(e),o.moveStart("character",n),o.setEndPoint("EndToStart",o),o.moveEnd("character",r-n),o.select()}function s(e,t){if(window.getSelection){var n=window.getSelection(),r=e[c()].length,o=Math.min(t.start,r),i=void 0===t.end?o:Math.min(t.end,r);if(!n.extend&&o>i){var a=i;i=o,o=a}var s=l(e,o),u=l(e,i);if(s&&u){var p=document.createRange();p.setStart(s.node,s.offset),n.removeAllRanges(),o>i?(n.addRange(p),n.extend(u.node,u.offset)):(p.setEnd(u.node,u.offset),n.addRange(p))}}}var u=n(7),l=n(178),c=n(78),p=u.canUseDOM&&"selection"in document&&!("getSelection"in window),f={getOffsets:p?o:i,setOffsets:p?a:s};e.exports=f},function(e,t,n){"use strict";var r=n(3),o=n(4),i=n(37),a=n(18),s=n(5),u=n(34),l=(n(1),n(52),function(e){this._currentElement=e,this._stringText=""+e,this._hostNode=null,this._hostParent=null,this._domID=0,this._mountIndex=0,this._closingComment=null,this._commentNodes=null});o(l.prototype,{mountComponent:function(e,t,n,r){var o=n._idCounter++,i=" react-text: "+o+" ",l=" /react-text ";if(this._domID=o,this._hostParent=t,e.useCreateElement){var c=n._ownerDocument,p=c.createComment(i),f=c.createComment(l),d=a(c.createDocumentFragment());return a.queueChild(d,a(p)),this._stringText&&a.queueChild(d,a(c.createTextNode(this._stringText))),a.queueChild(d,a(f)),s.precacheNode(this,p),this._closingComment=f,d}var h=u(this._stringText);return e.renderToStaticMarkup?h:"<!--"+i+"-->"+h+"<!--"+l+"-->"},receiveComponent:function(e,t){if(e!==this._currentElement){this._currentElement=e;var n=""+e;if(n!==this._stringText){this._stringText=n;var r=this.getHostNode();i.replaceDelimitedText(r[0],r[1],n)}}},getHostNode:function(){var e=this._commentNodes;if(e)return e;if(!this._closingComment)for(var t=s.getNodeFromInstance(this),n=t.nextSibling;;){if(null==n?r("67",this._domID):void 0,8===n.nodeType&&" /react-text "===n.nodeValue){this._closingComment=n;break}n=n.nextSibling}return e=[this._hostNode,this._closingComment],this._commentNodes=e,e},unmountComponent:function(){this._closingComment=null,this._commentNodes=null,s.uncacheNode(this)}}),e.exports=l},function(e,t,n){"use strict";function r(){this._rootNodeID&&c.updateWrapper(this)}function o(e){var t=this._currentElement.props,n=s.executeOnChange(t,e);return l.asap(r,this),n}var i=n(3),a=n(4),s=n(42),u=n(5),l=n(10),c=(n(1),n(2),{getHostProps:function(e,t){null!=t.dangerouslySetInnerHTML?i("91"):void 0;var n=a({},t,{value:void 0,defaultValue:void 0,children:""+e._wrapperState.initialValue,onChange:e._wrapperState.onChange});return n},mountWrapper:function(e,t){var n=s.getValue(t),r=n;if(null==n){var a=t.defaultValue,u=t.children;null!=u&&(null!=a?i("92"):void 0,Array.isArray(u)&&(u.length<=1?void 0:i("93"),u=u[0]),a=""+u),null==a&&(a=""),r=a}e._wrapperState={initialValue:""+r,listeners:null,onChange:o.bind(e)}},updateWrapper:function(e){var t=e._currentElement.props,n=u.getNodeFromInstance(e),r=s.getValue(t);if(null!=r){var o=""+r;o!==n.value&&(n.value=o),null==t.defaultValue&&(n.defaultValue=o)}null!=t.defaultValue&&(n.defaultValue=t.defaultValue)},postMountWrapper:function(e){var t=u.getNodeFromInstance(e),n=t.textContent;n===e._wrapperState.initialValue&&(t.value=n)}});e.exports=c},function(e,t,n){"use strict";function r(e,t){"_hostNode"in e?void 0:u("33"),"_hostNode"in t?void 0:u("33");for(var n=0,r=e;r;r=r._hostParent)n++;for(var o=0,i=t;i;i=i._hostParent)o++;for(;n-o>0;)e=e._hostParent,n--;for(;o-n>0;)t=t._hostParent,o--;for(var a=n;a--;){if(e===t)return e;e=e._hostParent,t=t._hostParent}return null}function o(e,t){"_hostNode"in e?void 0:u("35"),"_hostNode"in t?void 0:u("35");for(;t;){if(t===e)return!0;t=t._hostParent}return!1}function i(e){return"_hostNode"in e?void 0:u("36"),e._hostParent}function a(e,t,n){for(var r=[];e;)r.push(e),e=e._hostParent;var o;for(o=r.length;o-- >0;)t(r[o],"captured",n);for(o=0;o<r.length;o++)t(r[o],"bubbled",n)}function s(e,t,n,o,i){for(var a=e&&t?r(e,t):null,s=[];e&&e!==a;)s.push(e),e=e._hostParent;for(var u=[];t&&t!==a;)u.push(t),t=t._hostParent;var l;for(l=0;l<s.length;l++)n(s[l],"bubbled",o);for(l=u.length;l-- >0;)n(u[l],"captured",i)}var u=n(3);n(1);e.exports={isAncestor:o,getLowestCommonAncestor:r,getParentInstance:i,traverseTwoPhase:a,traverseEnterLeave:s}},function(e,t,n){"use strict";function r(){this.reinitializeTransaction()}var o=n(4),i=n(10),a=n(33),s=n(8),u={initialize:s,close:function(){f.isBatchingUpdates=!1}},l={initialize:s,close:i.flushBatchedUpdates.bind(i)},c=[l,u];o(r.prototype,a,{getTransactionWrappers:function(){return c}});var p=new r,f={isBatchingUpdates:!1,batchedUpdates:function(e,t,n,r,o,i){var a=f.isBatchingUpdates;return f.isBatchingUpdates=!0,a?e(t,n,r,o,i):p.perform(e,null,t,n,r,o,i)}};e.exports=f},function(e,t,n){"use strict";function r(){E||(E=!0,y.EventEmitter.injectReactEventListener(g),y.EventPluginHub.injectEventPluginOrder(s),y.EventPluginUtils.injectComponentTree(f),y.EventPluginUtils.injectTreeTraversal(h),y.EventPluginHub.injectEventPluginsByName({SimpleEventPlugin:w,EnterLeaveEventPlugin:u,ChangeEventPlugin:a,SelectEventPlugin:_,BeforeInputEventPlugin:i}),y.HostComponent.injectGenericComponentClass(p),y.HostComponent.injectTextComponentClass(v),y.DOMProperty.injectDOMPropertyConfig(o),y.DOMProperty.injectDOMPropertyConfig(l),y.DOMProperty.injectDOMPropertyConfig(C),y.EmptyComponent.injectEmptyComponentFactory(function(e){return new d(e)}),y.Updates.injectReconcileTransaction(b),y.Updates.injectBatchingStrategy(m),y.Component.injectEnvironment(c))}var o=n(120),i=n(122),a=n(124),s=n(126),u=n(127),l=n(129),c=n(131),p=n(133),f=n(5),d=n(135),h=n(143),v=n(141),m=n(144),g=n(148),y=n(149),b=n(154),C=n(159),_=n(160),w=n(161),E=!1;e.exports={inject:r}},87,function(e,t,n){"use strict";function r(e){o.enqueueEvents(e),o.processEventQueue(!1)}var o=n(25),i={handleTopLevel:function(e,t,n,i){var a=o.extractEvents(e,t,n,i);r(a)}};e.exports=i},function(e,t,n){"use strict";function r(e){for(;e._hostParent;)e=e._hostParent;var t=p.getNodeFromInstance(e),n=t.parentNode;return p.getClosestInstanceFromNode(n)}function o(e,t){this.topLevelType=e,this.nativeEvent=t,this.ancestors=[]}function i(e){var t=d(e.nativeEvent),n=p.getClosestInstanceFromNode(t),o=n;do e.ancestors.push(o),o=o&&r(o);while(o);for(var i=0;i<e.ancestors.length;i++)n=e.ancestors[i],v._handleTopLevel(e.topLevelType,n,e.nativeEvent,d(e.nativeEvent))}function a(e){var t=h(window);e(t)}var s=n(4),u=n(57),l=n(7),c=n(15),p=n(5),f=n(10),d=n(49),h=n(103);s(o.prototype,{destructor:function(){this.topLevelType=null,this.nativeEvent=null,this.ancestors.length=0}}),c.addPoolingTo(o,c.twoArgumentPooler);var v={_enabled:!0,_handleTopLevel:null,WINDOW_HANDLE:l.canUseDOM?window:null,setHandleTopLevel:function(e){v._handleTopLevel=e},setEnabled:function(e){v._enabled=!!e},isEnabled:function(){return v._enabled},trapBubbledEvent:function(e,t,n){return n?u.listen(n,t,v.dispatchEvent.bind(null,e)):null},trapCapturedEvent:function(e,t,n){return n?u.capture(n,t,v.dispatchEvent.bind(null,e)):null},monitorScrollValue:function(e){var t=a.bind(null,e);u.listen(window,"scroll",t)},dispatchEvent:function(e,t){if(v._enabled){var n=o.getPooled(e,t);try{f.batchedUpdates(i,n)}finally{o.release(n)}}}};e.exports=v},function(e,t,n){"use strict";var r=n(19),o=n(25),i=n(40),a=n(43),s=n(68),u=n(31),l=n(70),c=n(10),p={Component:a.injection,DOMProperty:r.injection,EmptyComponent:s.injection,EventPluginHub:o.injection,EventPluginUtils:i.injection,EventEmitter:u.injection,HostComponent:l.injection,Updates:c.injection};e.exports=p},function(e,t,n){"use strict";var r=n(172),o=/\/?>/,i=/^<\!\-\-/,a={CHECKSUM_ATTR_NAME:"data-react-checksum",addChecksumToMarkup:function(e){var t=r(e);return i.test(e)?e:e.replace(o," "+a.CHECKSUM_ATTR_NAME+'="'+t+'"$&')},canReuseMarkup:function(e,t){var n=t.getAttribute(a.CHECKSUM_ATTR_NAME);n=n&&parseInt(n,10);var o=r(e);return o===n}};e.exports=a},function(e,t,n){"use strict";function r(e,t,n){return{type:"INSERT_MARKUP",content:e,fromIndex:null,fromNode:null,toIndex:n,afterNode:t}}function o(e,t,n){return{type:"MOVE_EXISTING",content:null,fromIndex:e._mountIndex,fromNode:f.getHostNode(e),toIndex:n,afterNode:t}}function i(e,t){return{type:"REMOVE_NODE",content:null,fromIndex:e._mountIndex,fromNode:t,toIndex:null,afterNode:null}}function a(e){return{type:"SET_MARKUP",content:e,fromIndex:null,fromNode:null,toIndex:null,afterNode:null}}function s(e){return{type:"TEXT_CONTENT",content:e,fromIndex:null,fromNode:null,toIndex:null,afterNode:null}}function u(e,t){return t&&(e=e||[],e.push(t)),e}function l(e,t){p.processChildrenUpdates(e,t)}var c=n(3),p=n(43),f=(n(27),n(9),n(13),n(20)),d=n(130),h=(n(8),n(175)),v=(n(1),{Mixin:{_reconcilerInstantiateChildren:function(e,t,n){return d.instantiateChildren(e,t,n)},_reconcilerUpdateChildren:function(e,t,n,r,o,i){var a,s=0;return a=h(t,s),d.updateChildren(e,a,n,r,o,this,this._hostContainerInfo,i,s),a},mountChildren:function(e,t,n){var r=this._reconcilerInstantiateChildren(e,t,n);this._renderedChildren=r;var o=[],i=0;for(var a in r)if(r.hasOwnProperty(a)){var s=r[a],u=0,l=f.mountComponent(s,t,this,this._hostContainerInfo,n,u);s._mountIndex=i++,o.push(l)}return o},updateTextContent:function(e){var t=this._renderedChildren;d.unmountChildren(t,!1);for(var n in t)t.hasOwnProperty(n)&&c("118");var r=[s(e)];l(this,r)},updateMarkup:function(e){var t=this._renderedChildren;d.unmountChildren(t,!1);for(var n in t)t.hasOwnProperty(n)&&c("118");var r=[a(e)];l(this,r)},updateChildren:function(e,t,n){this._updateChildren(e,t,n)},_updateChildren:function(e,t,n){var r=this._renderedChildren,o={},i=[],a=this._reconcilerUpdateChildren(r,e,i,o,t,n);if(a||r){var s,c=null,p=0,d=0,h=0,v=null;for(s in a)if(a.hasOwnProperty(s)){var m=r&&r[s],g=a[s];m===g?(c=u(c,this.moveChild(m,v,p,d)),d=Math.max(m._mountIndex,d),m._mountIndex=p):(m&&(d=Math.max(m._mountIndex,d)),c=u(c,this._mountChildAtIndex(g,i[h],v,p,t,n)),h++),p++,v=f.getHostNode(g)}for(s in o)o.hasOwnProperty(s)&&(c=u(c,this._unmountChild(r[s],o[s])));c&&l(this,c),this._renderedChildren=a}},unmountChildren:function(e){var t=this._renderedChildren;d.unmountChildren(t,e),this._renderedChildren=null},moveChild:function(e,t,n,r){if(e._mountIndex<r)return o(e,t,n)},createChild:function(e,t,n){return r(n,t,e._mountIndex)},removeChild:function(e,t){return i(e,t)},_mountChildAtIndex:function(e,t,n,r,o,i){return e._mountIndex=r,this.createChild(e,n,t)},_unmountChild:function(e,t){var n=this.removeChild(e,t);return e._mountIndex=null,n}}});e.exports=v},function(e,t,n){"use strict";function r(e){return!(!e||"function"!=typeof e.attachRef||"function"!=typeof e.detachRef)}var o=n(3),i=(n(1),{addComponentAsRefTo:function(e,t,n){r(n)?void 0:o("119"),n.attachRef(t,e)},removeComponentAsRefFrom:function(e,t,n){r(n)?void 0:o("120");var i=n.getPublicInstance();i&&i.refs[t]===e.getPublicInstance()&&n.detachRef(t)}});e.exports=i},function(e,t){"use strict";var n="SECRET_DO_NOT_PASS_THIS_OR_YOU_WILL_BE_FIRED";e.exports=n},function(e,t,n){"use strict";function r(e){this.reinitializeTransaction(),this.renderToStaticMarkup=!1,this.reactMountReady=i.getPooled(null),this.useCreateElement=e}var o=n(4),i=n(63),a=n(15),s=n(31),u=n(71),l=(n(9),n(33)),c=n(45),p={initialize:u.getSelectionInformation,close:u.restoreSelection},f={initialize:function(){
-var e=s.isEnabled();return s.setEnabled(!1),e},close:function(e){s.setEnabled(e)}},d={initialize:function(){this.reactMountReady.reset()},close:function(){this.reactMountReady.notifyAll()}},h=[p,f,d],v={getTransactionWrappers:function(){return h},getReactMountReady:function(){return this.reactMountReady},getUpdateQueue:function(){return c},checkpoint:function(){return this.reactMountReady.checkpoint()},rollback:function(e){this.reactMountReady.rollback(e)},destructor:function(){i.release(this.reactMountReady),this.reactMountReady=null}};o(r.prototype,l,v),a.addPoolingTo(r),e.exports=r},function(e,t,n){"use strict";function r(e,t,n){"function"==typeof e?e(t.getPublicInstance()):i.addComponentAsRefTo(t,e,n)}function o(e,t,n){"function"==typeof e?e(null):i.removeComponentAsRefFrom(t,e,n)}var i=n(152),a={};a.attachRefs=function(e,t){if(null!==t&&"object"==typeof t){var n=t.ref;null!=n&&r(n,e,t._owner)}},a.shouldUpdateRefs=function(e,t){var n=null,r=null;null!==e&&"object"==typeof e&&(n=e.ref,r=e._owner);var o=null,i=null;return null!==t&&"object"==typeof t&&(o=t.ref,i=t._owner),n!==o||"string"==typeof o&&i!==r},a.detachRefs=function(e,t){if(null!==t&&"object"==typeof t){var n=t.ref;null!=n&&o(n,e,t._owner)}},e.exports=a},function(e,t,n){"use strict";function r(e){this.reinitializeTransaction(),this.renderToStaticMarkup=e,this.useCreateElement=!1,this.updateQueue=new s(this)}var o=n(4),i=n(15),a=n(33),s=(n(9),n(157)),u=[],l={enqueue:function(){}},c={getTransactionWrappers:function(){return u},getReactMountReady:function(){return l},getUpdateQueue:function(){return this.updateQueue},destructor:function(){},checkpoint:function(){},rollback:function(){}};o(r.prototype,a,c),i.addPoolingTo(r),e.exports=r},function(e,t,n){"use strict";function r(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function o(e,t){}var i=n(45),a=(n(2),function(){function e(t){r(this,e),this.transaction=t}return e.prototype.isMounted=function(e){return!1},e.prototype.enqueueCallback=function(e,t,n){this.transaction.isInTransaction()&&i.enqueueCallback(e,t,n)},e.prototype.enqueueForceUpdate=function(e){this.transaction.isInTransaction()?i.enqueueForceUpdate(e):o(e,"forceUpdate")},e.prototype.enqueueReplaceState=function(e,t){this.transaction.isInTransaction()?i.enqueueReplaceState(e,t):o(e,"replaceState")},e.prototype.enqueueSetState=function(e,t){this.transaction.isInTransaction()?i.enqueueSetState(e,t):o(e,"setState")},e}());e.exports=a},function(e,t){"use strict";e.exports="15.5.4"},function(e,t){"use strict";var n={xlink:"http://www.w3.org/1999/xlink",xml:"http://www.w3.org/XML/1998/namespace"},r={accentHeight:"accent-height",accumulate:0,additive:0,alignmentBaseline:"alignment-baseline",allowReorder:"allowReorder",alphabetic:0,amplitude:0,arabicForm:"arabic-form",ascent:0,attributeName:"attributeName",attributeType:"attributeType",autoReverse:"autoReverse",azimuth:0,baseFrequency:"baseFrequency",baseProfile:"baseProfile",baselineShift:"baseline-shift",bbox:0,begin:0,bias:0,by:0,calcMode:"calcMode",capHeight:"cap-height",clip:0,clipPath:"clip-path",clipRule:"clip-rule",clipPathUnits:"clipPathUnits",colorInterpolation:"color-interpolation",colorInterpolationFilters:"color-interpolation-filters",colorProfile:"color-profile",colorRendering:"color-rendering",contentScriptType:"contentScriptType",contentStyleType:"contentStyleType",cursor:0,cx:0,cy:0,d:0,decelerate:0,descent:0,diffuseConstant:"diffuseConstant",direction:0,display:0,divisor:0,dominantBaseline:"dominant-baseline",dur:0,dx:0,dy:0,edgeMode:"edgeMode",elevation:0,enableBackground:"enable-background",end:0,exponent:0,externalResourcesRequired:"externalResourcesRequired",fill:0,fillOpacity:"fill-opacity",fillRule:"fill-rule",filter:0,filterRes:"filterRes",filterUnits:"filterUnits",floodColor:"flood-color",floodOpacity:"flood-opacity",focusable:0,fontFamily:"font-family",fontSize:"font-size",fontSizeAdjust:"font-size-adjust",fontStretch:"font-stretch",fontStyle:"font-style",fontVariant:"font-variant",fontWeight:"font-weight",format:0,from:0,fx:0,fy:0,g1:0,g2:0,glyphName:"glyph-name",glyphOrientationHorizontal:"glyph-orientation-horizontal",glyphOrientationVertical:"glyph-orientation-vertical",glyphRef:"glyphRef",gradientTransform:"gradientTransform",gradientUnits:"gradientUnits",hanging:0,horizAdvX:"horiz-adv-x",horizOriginX:"horiz-origin-x",ideographic:0,imageRendering:"image-rendering",in:0,in2:0,intercept:0,k:0,k1:0,k2:0,k3:0,k4:0,kernelMatrix:"kernelMatrix",kernelUnitLength:"kernelUnitLength",kerning:0,keyPoints:"keyPoints",keySplines:"keySplines",keyTimes:"keyTimes",lengthAdjust:"lengthAdjust",letterSpacing:"letter-spacing",lightingColor:"lighting-color",limitingConeAngle:"limitingConeAngle",local:0,markerEnd:"marker-end",markerMid:"marker-mid",markerStart:"marker-start",markerHeight:"markerHeight",markerUnits:"markerUnits",markerWidth:"markerWidth",mask:0,maskContentUnits:"maskContentUnits",maskUnits:"maskUnits",mathematical:0,mode:0,numOctaves:"numOctaves",offset:0,opacity:0,operator:0,order:0,orient:0,orientation:0,origin:0,overflow:0,overlinePosition:"overline-position",overlineThickness:"overline-thickness",paintOrder:"paint-order",panose1:"panose-1",pathLength:"pathLength",patternContentUnits:"patternContentUnits",patternTransform:"patternTransform",patternUnits:"patternUnits",pointerEvents:"pointer-events",points:0,pointsAtX:"pointsAtX",pointsAtY:"pointsAtY",pointsAtZ:"pointsAtZ",preserveAlpha:"preserveAlpha",preserveAspectRatio:"preserveAspectRatio",primitiveUnits:"primitiveUnits",r:0,radius:0,refX:"refX",refY:"refY",renderingIntent:"rendering-intent",repeatCount:"repeatCount",repeatDur:"repeatDur",requiredExtensions:"requiredExtensions",requiredFeatures:"requiredFeatures",restart:0,result:0,rotate:0,rx:0,ry:0,scale:0,seed:0,shapeRendering:"shape-rendering",slope:0,spacing:0,specularConstant:"specularConstant",specularExponent:"specularExponent",speed:0,spreadMethod:"spreadMethod",startOffset:"startOffset",stdDeviation:"stdDeviation",stemh:0,stemv:0,stitchTiles:"stitchTiles",stopColor:"stop-color",stopOpacity:"stop-opacity",strikethroughPosition:"strikethrough-position",strikethroughThickness:"strikethrough-thickness",string:0,stroke:0,strokeDasharray:"stroke-dasharray",strokeDashoffset:"stroke-dashoffset",strokeLinecap:"stroke-linecap",strokeLinejoin:"stroke-linejoin",strokeMiterlimit:"stroke-miterlimit",strokeOpacity:"stroke-opacity",strokeWidth:"stroke-width",surfaceScale:"surfaceScale",systemLanguage:"systemLanguage",tableValues:"tableValues",targetX:"targetX",targetY:"targetY",textAnchor:"text-anchor",textDecoration:"text-decoration",textRendering:"text-rendering",textLength:"textLength",to:0,transform:0,u1:0,u2:0,underlinePosition:"underline-position",underlineThickness:"underline-thickness",unicode:0,unicodeBidi:"unicode-bidi",unicodeRange:"unicode-range",unitsPerEm:"units-per-em",vAlphabetic:"v-alphabetic",vHanging:"v-hanging",vIdeographic:"v-ideographic",vMathematical:"v-mathematical",values:0,vectorEffect:"vector-effect",version:0,vertAdvY:"vert-adv-y",vertOriginX:"vert-origin-x",vertOriginY:"vert-origin-y",viewBox:"viewBox",viewTarget:"viewTarget",visibility:0,widths:0,wordSpacing:"word-spacing",writingMode:"writing-mode",x:0,xHeight:"x-height",x1:0,x2:0,xChannelSelector:"xChannelSelector",xlinkActuate:"xlink:actuate",xlinkArcrole:"xlink:arcrole",xlinkHref:"xlink:href",xlinkRole:"xlink:role",xlinkShow:"xlink:show",xlinkTitle:"xlink:title",xlinkType:"xlink:type",xmlBase:"xml:base",xmlns:0,xmlnsXlink:"xmlns:xlink",xmlLang:"xml:lang",xmlSpace:"xml:space",y:0,y1:0,y2:0,yChannelSelector:"yChannelSelector",z:0,zoomAndPan:"zoomAndPan"},o={Properties:{},DOMAttributeNamespaces:{xlinkActuate:n.xlink,xlinkArcrole:n.xlink,xlinkHref:n.xlink,xlinkRole:n.xlink,xlinkShow:n.xlink,xlinkTitle:n.xlink,xlinkType:n.xlink,xmlBase:n.xml,xmlLang:n.xml,xmlSpace:n.xml},DOMAttributeNames:{}};Object.keys(r).forEach(function(e){o.Properties[e]=0,r[e]&&(o.DOMAttributeNames[e]=r[e])}),e.exports=o},function(e,t,n){"use strict";function r(e){if("selectionStart"in e&&u.hasSelectionCapabilities(e))return{start:e.selectionStart,end:e.selectionEnd};if(window.getSelection){var t=window.getSelection();return{anchorNode:t.anchorNode,anchorOffset:t.anchorOffset,focusNode:t.focusNode,focusOffset:t.focusOffset}}if(document.selection){var n=document.selection.createRange();return{parentElement:n.parentElement(),text:n.text,top:n.boundingTop,left:n.boundingLeft}}}function o(e,t){if(y||null==v||v!==c())return null;var n=r(v);if(!g||!f(g,n)){g=n;var o=l.getPooled(h.select,m,e,t);return o.type="select",o.target=v,i.accumulateTwoPhaseDispatches(o),o}return null}var i=n(26),a=n(7),s=n(5),u=n(71),l=n(11),c=n(59),p=n(81),f=n(30),d=a.canUseDOM&&"documentMode"in document&&document.documentMode<=11,h={select:{phasedRegistrationNames:{bubbled:"onSelect",captured:"onSelectCapture"},dependencies:["topBlur","topContextMenu","topFocus","topKeyDown","topKeyUp","topMouseDown","topMouseUp","topSelectionChange"]}},v=null,m=null,g=null,y=!1,b=!1,C={eventTypes:h,extractEvents:function(e,t,n,r){if(!b)return null;var i=t?s.getNodeFromInstance(t):window;switch(e){case"topFocus":(p(i)||"true"===i.contentEditable)&&(v=i,m=t,g=null);break;case"topBlur":v=null,m=null,g=null;break;case"topMouseDown":y=!0;break;case"topContextMenu":case"topMouseUp":return y=!1,o(n,r);case"topSelectionChange":if(d)break;case"topKeyDown":case"topKeyUp":return o(n,r)}return null},didPutListener:function(e,t,n){"onSelect"===t&&(b=!0)}};e.exports=C},function(e,t,n){"use strict";function r(e){return"."+e._rootNodeID}function o(e){return"button"===e||"input"===e||"select"===e||"textarea"===e}var i=n(3),a=n(57),s=n(26),u=n(5),l=n(162),c=n(163),p=n(11),f=n(166),d=n(168),h=n(32),v=n(165),m=n(169),g=n(170),y=n(28),b=n(171),C=n(8),_=n(47),w=(n(1),{}),E={};["abort","animationEnd","animationIteration","animationStart","blur","canPlay","canPlayThrough","click","contextMenu","copy","cut","doubleClick","drag","dragEnd","dragEnter","dragExit","dragLeave","dragOver","dragStart","drop","durationChange","emptied","encrypted","ended","error","focus","input","invalid","keyDown","keyPress","keyUp","load","loadedData","loadedMetadata","loadStart","mouseDown","mouseMove","mouseOut","mouseOver","mouseUp","paste","pause","play","playing","progress","rateChange","reset","scroll","seeked","seeking","stalled","submit","suspend","timeUpdate","touchCancel","touchEnd","touchMove","touchStart","transitionEnd","volumeChange","waiting","wheel"].forEach(function(e){var t=e[0].toUpperCase()+e.slice(1),n="on"+t,r="top"+t,o={phasedRegistrationNames:{bubbled:n,captured:n+"Capture"},dependencies:[r]};w[e]=o,E[r]=o});var x={},T={eventTypes:w,extractEvents:function(e,t,n,r){var o=E[e];if(!o)return null;var a;switch(e){case"topAbort":case"topCanPlay":case"topCanPlayThrough":case"topDurationChange":case"topEmptied":case"topEncrypted":case"topEnded":case"topError":case"topInput":case"topInvalid":case"topLoad":case"topLoadedData":case"topLoadedMetadata":case"topLoadStart":case"topPause":case"topPlay":case"topPlaying":case"topProgress":case"topRateChange":case"topReset":case"topSeeked":case"topSeeking":case"topStalled":case"topSubmit":case"topSuspend":case"topTimeUpdate":case"topVolumeChange":case"topWaiting":a=p;break;case"topKeyPress":if(0===_(n))return null;case"topKeyDown":case"topKeyUp":a=d;break;case"topBlur":case"topFocus":a=f;break;case"topClick":if(2===n.button)return null;case"topDoubleClick":case"topMouseDown":case"topMouseMove":case"topMouseUp":case"topMouseOut":case"topMouseOver":case"topContextMenu":a=h;break;case"topDrag":case"topDragEnd":case"topDragEnter":case"topDragExit":case"topDragLeave":case"topDragOver":case"topDragStart":case"topDrop":a=v;break;case"topTouchCancel":case"topTouchEnd":case"topTouchMove":case"topTouchStart":a=m;break;case"topAnimationEnd":case"topAnimationIteration":case"topAnimationStart":a=l;break;case"topTransitionEnd":a=g;break;case"topScroll":a=y;break;case"topWheel":a=b;break;case"topCopy":case"topCut":case"topPaste":a=c}a?void 0:i("86",e);var u=a.getPooled(o,t,n,r);return s.accumulateTwoPhaseDispatches(u),u},didPutListener:function(e,t,n){if("onClick"===t&&!o(e._tag)){var i=r(e),s=u.getNodeFromInstance(e);x[i]||(x[i]=a.listen(s,"click",C))}},willDeleteListener:function(e,t){if("onClick"===t&&!o(e._tag)){var n=r(e);x[n].remove(),delete x[n]}}};e.exports=T},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(11),i={animationName:null,elapsedTime:null,pseudoElement:null};o.augmentClass(r,i),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(11),i={clipboardData:function(e){return"clipboardData"in e?e.clipboardData:window.clipboardData}};o.augmentClass(r,i),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(11),i={data:null};o.augmentClass(r,i),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(32),i={dataTransfer:null};o.augmentClass(r,i),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(28),i={relatedTarget:null};o.augmentClass(r,i),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(11),i={data:null};o.augmentClass(r,i),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(28),i=n(47),a=n(176),s=n(48),u={key:a,location:null,ctrlKey:null,shiftKey:null,altKey:null,metaKey:null,repeat:null,locale:null,getModifierState:s,charCode:function(e){return"keypress"===e.type?i(e):0},keyCode:function(e){return"keydown"===e.type||"keyup"===e.type?e.keyCode:0},which:function(e){return"keypress"===e.type?i(e):"keydown"===e.type||"keyup"===e.type?e.keyCode:0}};o.augmentClass(r,u),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(28),i=n(48),a={touches:null,targetTouches:null,changedTouches:null,altKey:null,metaKey:null,ctrlKey:null,shiftKey:null,getModifierState:i};o.augmentClass(r,a),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(11),i={propertyName:null,elapsedTime:null,pseudoElement:null};o.augmentClass(r,i),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(32),i={deltaX:function(e){return"deltaX"in e?e.deltaX:"wheelDeltaX"in e?-e.wheelDeltaX:0},deltaY:function(e){return"deltaY"in e?e.deltaY:"wheelDeltaY"in e?-e.wheelDeltaY:"wheelDelta"in e?-e.wheelDelta:0},deltaZ:null,deltaMode:null};o.augmentClass(r,i),e.exports=r},function(e,t){"use strict";function n(e){for(var t=1,n=0,o=0,i=e.length,a=i&-4;o<a;){for(var s=Math.min(o+4096,a);o<s;o+=4)n+=(t+=e.charCodeAt(o))+(t+=e.charCodeAt(o+1))+(t+=e.charCodeAt(o+2))+(t+=e.charCodeAt(o+3));t%=r,n%=r}for(;o<i;o++)n+=t+=e.charCodeAt(o);return t%=r,n%=r,t|n<<16}var r=65521;e.exports=n},function(e,t,n){"use strict";function r(e,t,n){var r=null==t||"boolean"==typeof t||""===t;if(r)return"";var o=isNaN(t);if(o||0===t||i.hasOwnProperty(e)&&i[e])return""+t;if("string"==typeof t){t=t.trim()}return t+"px"}var o=n(62),i=(n(2),o.isUnitlessNumber);e.exports=r},function(e,t,n){"use strict";function r(e){if(null==e)return null;if(1===e.nodeType)return e;var t=a.get(e);return t?(t=s(t),t?i.getNodeFromInstance(t):null):void("function"==typeof e.render?o("44"):o("45",Object.keys(e)))}var o=n(3),i=(n(13),n(5)),a=n(27),s=n(77);n(1),n(2);e.exports=r},function(e,t,n){(function(t){"use strict";function r(e,t,n,r){if(e&&"object"==typeof e){var o=e,i=void 0===o[n];i&&null!=t&&(o[n]=t)}}function o(e,t){if(null==e)return e;var n={};return i(e,r,n),n}var i=(n(41),n(83));n(2);e.exports=o}).call(t,n(36))},function(e,t,n){"use strict";function r(e){if(e.key){var t=i[e.key]||e.key;if("Unidentified"!==t)return t}if("keypress"===e.type){var n=o(e);return 13===n?"Enter":String.fromCharCode(n)}return"keydown"===e.type||"keyup"===e.type?a[e.keyCode]||"Unidentified":""}var o=n(47),i={Esc:"Escape",Spacebar:" ",Left:"ArrowLeft",Up:"ArrowUp",Right:"ArrowRight",Down:"ArrowDown",Del:"Delete",Win:"OS",Menu:"ContextMenu",Apps:"ContextMenu",Scroll:"ScrollLock",MozPrintableKey:"Unidentified"},a={8:"Backspace",9:"Tab",12:"Clear",13:"Enter",16:"Shift",17:"Control",18:"Alt",19:"Pause",20:"CapsLock",27:"Escape",32:" ",33:"PageUp",34:"PageDown",35:"End",36:"Home",37:"ArrowLeft",38:"ArrowUp",39:"ArrowRight",40:"ArrowDown",45:"Insert",46:"Delete",112:"F1",113:"F2",114:"F3",115:"F4",116:"F5",117:"F6",118:"F7",119:"F8",120:"F9",121:"F10",122:"F11",123:"F12",144:"NumLock",145:"ScrollLock",224:"Meta"};e.exports=r},function(e,t){"use strict";function n(e){var t=e&&(r&&e[r]||e[o]);if("function"==typeof t)return t}var r="function"==typeof Symbol&&Symbol.iterator,o="@@iterator";e.exports=n},function(e,t){"use strict";function n(e){for(;e&&e.firstChild;)e=e.firstChild;return e}function r(e){for(;e;){if(e.nextSibling)return e.nextSibling;e=e.parentNode}}function o(e,t){for(var o=n(e),i=0,a=0;o;){if(3===o.nodeType){if(a=i+o.textContent.length,i<=t&&a>=t)return{node:o,offset:t-i};i=a}o=n(r(o))}}e.exports=o},function(e,t,n){"use strict";function r(e){return'"'+o(e)+'"'}var o=n(34);e.exports=r},function(e,t,n){"use strict";var r=n(72);e.exports=r.renderSubtreeIntoContainer},function(e,t,n){"use strict";"undefined"==typeof Promise&&(n(115).enable(),window.Promise=n(114)),n(211),Object.assign=n(4)},function(e,t,n){(function(){var t,r,o;t=n(6),r=t.createClass,o=t.DOM.div,e.exports=r({getDefaultProps:function(){return{className:"",onHeightChange:function(){}}},render:function(){return o({className:this.props.className,ref:"dropdown"},this.props.children)},componentDidMount:function(){this.props.onHeightChange(this.refs.dropdown.offsetHeight)},componentDidUpdate:function(){this.props.onHeightChange(this.refs.dropdown.offsetHeight)},componentWillUnmount:function(){this.props.onHeightChange(0)}})}).call(this)},function(e,t,n){(function(){function t(e,t){var n={}.hasOwnProperty;for(var r in t)n.call(t,r)&&(e[r]=t[r]);return e}var r,o,i,a,s,u,l,c,p,f,d,h,v,m,g,y,b,C;r=n(14),o=r.filter,i=r.id,a=r.map,s=n(16).isEqualToObject,u=n(6),r=u.DOM,l=r.div,c=r.input,p=r.span,f=u.createClass,d=u.createFactory,h=n(17).findDOMNode,v=d(n(61)),m=d(n(186)),g=d(n(182)),y=d(n(84)),r=n(29),b=r.cancelEvent,C=r.classNameFromObject,e.exports=f({displayName:"DropdownMenu",getDefaultProps:function(){return{className:"",dropdownDirection:1,groupId:function(e){return e.groupId},groupsAsColumns:!1,highlightedUid:void 0,onHighlightedUidChange:function(e,t){},onOptionClick:function(e){},onScrollLockChange:function(e){},options:[],renderNoResultsFound:function(){return l({className:"no-results-found"},"No results found")},renderGroupTitle:function(e,t){var n,r;return null!=t&&(n=t.groupId,r=t.title),l({className:"simple-group-title",key:n},r)},renderOption:function(e){var t,n,r,o;return null!=e&&(t=e.label,n=e.newOption,r=e.selectable),o="undefined"==typeof r||r,l({className:"simple-option "+(o?"":"not-selectable")},p(null,n?"Add "+t+" ...":t))},scrollLock:!1,style:{},tether:!1,tetherProps:{},theme:"default",transitionEnter:!1,transitionLeave:!1,transitionEnterTimeout:200,transitionLeaveTimeout:200,uid:i}},render:function(){var e,n;return e=C((n={},n[this.props.theme+""]=1,n[this.props.className+""]=1,n.flipped=this.props.dropdownDirection===-1,n.tethered=this.props.tether,n)),this.props.tether?m((n=t({},this.props.tetherProps),n.options={attachment:"top left",targetAttachment:"bottom left",constraints:[{to:"scrollParent"}]},n),this.renderAnimatedDropdown({dynamicClassName:e})):this.renderAnimatedDropdown({dynamicClassName:e})},renderAnimatedDropdown:function(e){var t;return t=e.dynamicClassName,this.props.transitionEnter||this.props.transitionLeave?v({component:"div",transitionName:"custom",transitionEnter:this.props.transitionEnter,transitionLeave:this.props.transitionLeave,transitionEnterTimeout:this.props.transitionEnterTimeout,transitionLeaveTimeout:this.props.transitionLeaveTimeout,className:"dropdown-menu-wrapper "+t,ref:"dropdownMenuWrapper"},this.renderDropdown(e)):this.renderDropdown(e)},renderOptions:function(e){var n=this;return a(function(r){var o,i;return o=e[r],i=n.props.uid(o),y(t({uid:i,ref:"option-"+n.uidToString(i),key:n.uidToString(i),item:o,highlight:s(n.props.highlightedUid,i),selectable:null!=o?o.selectable:void 0,onMouseMove:function(e){var t;t=e.currentTarget,n.props.scrollLock&&n.props.onScrollLockChange(!1)},onMouseOut:function(){n.props.scrollLock||n.props.onHighlightedUidChange(void 0,function(){})},renderItem:n.props.renderOption},function(){switch(!1){case!("boolean"==typeof(null!=o?o.selectable:void 0)&&!o.selectable):return{onClick:b};default:return{onClick:function(){n.props.onOptionClick(n.props.highlightedUid)},onMouseOver:function(e){var t;t=e.currentTarget,n.props.scrollLock||n.props.onHighlightedUidChange(i,function(){})}}}}()))})(function(){var t,n,r=[];for(t=0,n=e.length;t<n;++t)r.push(t);return r}())},renderDropdown:function(e){var t,n,r,i,s=this;return t=e.dynamicClassName,this.props.open?g({className:"dropdown-menu "+t,ref:"dropdownMenu",onHeightChange:function(e){s.refs.dropdownMenuWrapper&&(h(s.refs.dropdownMenuWrapper).style.height=e+"px")}},0===this.props.options.length?this.props.renderNoResultsFound():(null!=(n=this.props)&&null!=(r=n.groups)?r.length:void 0)>0?(i=a(function(e){var t,n,r;return t=s.props.groups[e],n=t.groupId,r=o(function(e){return s.props.groupId(e)===n})(s.props.options),{index:e,group:t,options:r}})(function(){var e,t,n=[];for(e=0,t=this.props.groups.length;e<t;++e)n.push(e);return n}.call(this)),l({className:"groups "+(this.props.groupsAsColumns?"as-columns":"")},a(function(e){var t,n,r,o;return t=e.index,n=e.group,r=n.groupId,o=e.options,l({key:r},s.props.renderGroupTitle(t,n,o),l({className:"options"},s.renderOptions(o)))})(o(function(e){return e.options.length>0})(i)))):this.renderOptions(this.props.options)):null},componentDidUpdate:function(){var e,t,n;e=t=h(null!=(n=this.refs.dropdownMenuWrapper)?n:this.refs.dropdownMenu),null!=e&&(e.style.bottom=function(){switch(!1){case this.props.dropdownDirection!==-1:return this.props.bottomAnchor().offsetHeight+t.style.marginBottom+"px";default:return""}}.call(this))},highlightAndScrollToOption:function(e,t){var n,r=this;null==t&&(t=function(){}),n=this.props.uid(this.props.options[e]),this.props.onHighlightedUidChange(n,function(){var e,o,i,a,s;return null!=(e=h(null!=(o=r.refs)?o["option-"+r.uidToString(n)]:void 0))&&(i=e),i&&(a=h(r.refs.dropdownMenu),s=i.offsetHeight-1,i.offsetTop-a.scrollTop>=a.offsetHeight?a.scrollTop=i.offsetTop-a.offsetHeight+s:i.offsetTop-a.scrollTop+s<=0&&(a.scrollTop=i.offsetTop)),t()})},highlightAndScrollToSelectableOption:function(e,t,n){var r,o,i;null==n&&(n=function(){}),e<0||e>=this.props.options.length?this.props.onHighlightedUidChange(void 0,function(){return n(!1)}):(r=null!=(o=this.props)&&null!=(i=o.options)?i[e]:void 0,"boolean"!=typeof(null!=r?r.selectable:void 0)||r.selectable?this.highlightAndScrollToOption(e,function(){return n(!0)}):this.highlightAndScrollToSelectableOption(e+t,t,n))},uidToString:function(e){return("object"==typeof e?JSON.stringify:i)(e)}})}).call(this)},function(e,t,n){(function(){var t,r,o,i,a,s;t=n(6),r=t.createClass,o=t.DOM,i=o.div,a=o.span,s=n(14).map,e.exports=r({getDefaultProps:function(){return{partitions:[],text:"",style:{},highlightStyle:{}}},render:function(){var e=this;return i({className:"highlighted-text",style:this.props.style},s(function(t){var n,r,o;return n=t[0],r=t[1],o=t[2],a({key:e.props.text+""+n+r+o,className:o?"highlight":"",style:o?e.props.highlightStyle:{}},e.props.text.substring(n,r))})(this.props.partitions))}})}).call(this)},function(e,t,n){(function(){function t(e,t){for(var n=-1,r=t.length>>>0;++n<r;)if(e===t[n])return!0;return!1}function r(e,t){var n,r=function(o){return e.length>1?function(){var i=o?o.concat():[];return n=t?n||this:this,i.push.apply(i,arguments)<e.length&&arguments.length?r.call(n,i):e.apply(n,i)}:e};return r()}function o(e,t){var n={}.hasOwnProperty;for(var r in t)n.call(t,r)&&(e[r]=t[r]);return e}var i,a,s,u,l,c,p,f,d,h,v,m,g,y,b,C,_,w,E,x,T,O={}.toString;i=n(14),a=i.all,s=i.any,u=i.camelize,l=i.difference,c=i.drop,p=i.filter,f=i.find,d=i.findIndex,h=i.id,v=i.last,m=i.map,g=i.reject,y=n(16).isEqualToObject,b=n(6),C=b.createFactory,i=b.DOM,_=i.div,w=i.img,E=i.span,x=C(n(53)),T=n(29).cancelEvent,e.exports=b.createClass({displayName:"MultiSelect",getDefaultProps:function(){return{className:"",closeOnSelect:!1,defaultValues:[],delimiters:[],filterOptions:r(function(e,n,r){return p(function(e){return e.label.toLowerCase().trim().indexOf(r.toLowerCase().trim())>-1})(g(function(e){return t(e.label.trim(),m(function(e){return e.label.trim()},null!=n?n:[]))})(e))}),firstOptionIndexToHighlight:h,onBlur:function(e){},onFocus:function(e){},onPaste:function(e){},serialize:m(function(e){return null!=e?e.value:void 0}),tether:!1}},render:function(){var e,t,n,r,i,a,s,u,l,c,p,f,d,h,m,g,y,b,C,_,w,E,O,P,k,S,N,M,A,I,D,R,L,U,F,j,B,V,W=this;return e=this.getComputedState(),t=e.anchor,n=e.filteredOptions,r=e.highlightedUid,i=e.onAnchorChange,a=e.onOpenChange,s=e.onHighlightedUidChange,u=e.onSearchChange,l=e.onValuesChange,c=e.search,p=e.open,f=e.options,d=e.values,null!=(e=this.props)&&(h=e.autofocus,m=e.autosize,g=e.cancelKeyboardEventOnSelection,y=e.delimiters,b=e.disabled,C=e.dropdownDirection,_=e.groupId,w=e.groups,E=e.groupsAsColumns,O=e.hideResetButton,P=e.inputProps,k=e.name,S=e.onKeyboardSelectionFailed,N=e.renderToggleButton,M=e.renderGroupTitle,A=e.renderResetButton,I=e.serialize,D=e.tether,R=e.tetherProps,L=e.theme,U=e.transitionEnter,F=e.transitionLeave,j=e.transitionEnterTimeout,B=e.transitionLeaveTimeout,V=e.uid),x(o(o({autofocus:h,autosize:m,cancelKeyboardEventOnSelection:g,className:"multi-select "+this.props.className,delimiters:y,disabled:b,dropdownDirection:C,groupId:_,groups:w,groupsAsColumns:E,hideResetButton:O,highlightedUid:r,onHighlightedUidChange:s,inputProps:P,name:k,onKeyboardSelectionFailed:S,renderGroupTitle:M,renderResetButton:A,renderToggleButton:N,scrollLock:this.state.scrollLock,onScrollLockChange:function(e){return W.setState({scrollLock:e})},tether:D,tetherProps:R,theme:L,transitionEnter:U,transitionEnterTimeout:j,transitionLeave:F,transitionLeaveTimeout:B,uid:V,ref:"select",anchor:t,onAnchorChange:i,open:p,onOpenChange:a,options:f,renderOption:this.props.renderOption,firstOptionIndexToHighlight:function(){return W.firstOptionIndexToHighlight(f)},search:c,onSearchChange:function(e,t){return u(W.props.maxValues&&d.length>=W.props.maxValues?"":e,t)},values:d,onValuesChange:function(e,t){return l(e,function(){if(t(),W.props.closeOnSelect||W.props.maxValues&&W.values().length>=W.props.maxValues)return a(!1,function(){})})},renderValue:this.props.renderValue,serialize:I,onBlur:function(e){u("",function(){return W.props.onBlur({open:p,values:d,originalEvent:e})})},onFocus:function(e){W.props.onFocus({open:p,values:d,originalEvent:e})},onPaste:function(){var e;switch(!1){case"undefined"!=typeof(null!=(e=this.props)?e.valuesFromPaste:void 0):return this.props.onPaste;default:return function(e){var t;return t=e.clipboardData,function(){var e;return e=d.concat(W.props.valuesFromPaste(f,d,t.getData("text"))),l(e,function(){return i(v(e))})}(),T(e)}}}.call(this),placeholder:this.props.placeholder,style:this.props.style},function(){switch(!1){case"function"!=typeof this.props.restoreOnBackspace:return{restoreOnBackspace:this.props.restoreOnBackspace};default:return{}}}.call(this)),function(){switch(!1){case"function"!=typeof this.props.renderNoResultsFound:return{renderNoResultsFound:function(){return W.props.renderNoResultsFound(d,c)}};default:return{}}}.call(this)))},getComputedState:function(){var e,t,n,r,i,a,s,l,c,p,f,d,h,v,g,y,b=this;return e=this.props.hasOwnProperty("anchor")?this.props.anchor:this.state.anchor,t=this.props.hasOwnProperty("highlightedUid")?this.props.highlightedUid:this.state.highlightedUid,n=this.isOpen(),r=this.props.hasOwnProperty("search")?this.props.search:this.state.search,i=this.values(),a=m(function(e){switch(!1){case!(b.props.hasOwnProperty(e)&&b.props.hasOwnProperty(u("on-"+e+"-change"))):return function(t,n){return b.props[u("on-"+e+"-change")](t,function(){}),b.setState({},n)};case!(b.props.hasOwnProperty(e)&&!b.props.hasOwnProperty(u("on-"+e+"-change"))):return function(e,t){return t()};case!(!b.props.hasOwnProperty(e)&&b.props.hasOwnProperty(u("on-"+e+"-change"))):return function(t,n){var r;return b.setState((r={},r[e+""]=t,r),function(){return n(),b.props[u("on-"+e+"-change")](t,function(){})})};case!(!b.props.hasOwnProperty(e)&&!b.props.hasOwnProperty(u("on-"+e+"-change"))):return function(t,n){var r;return b.setState((r={},r[e+""]=t,r),n)}}})(["anchor","highlightedUid","open","search","values"]),s=a[0],l=a[1],c=a[2],p=a[3],f=a[4],d=function(){var e;switch(!1){case!(null!=(e=this.props)&&e.children):return m(function(e){var t,n,r;return null!=e&&(t=e.props),null!=t&&(n=t.value,r=t.children),{label:r,value:n}})("Array"===O.call(this.props.children).slice(8,-1)?this.props.children:[this.props.children]);default:return[]}}.call(this),h=this.props.hasOwnProperty("options")?null!=(a=this.props.options)?a:[]:d,v=this.props.filterOptions(h,i,r),g=function(){switch(!1){case"function"!=typeof this.props.createFromSearch:return this.props.createFromSearch(v,i,r);default:return null}}.call(this),y=(g?[(a=o({},g),a.newOption=!0,a)]:[]).concat(v),{anchor:e,highlightedUid:t,search:r,values:i,onAnchorChange:s,onHighlightedUidChange:l,open:n,onOpenChange:function(e,t){c(function(){switch(!1){case!("undefined"!=typeof this.props.maxValues&&this.values().length>=this.props.maxValues):return!1;default:return e}}.call(b),t)},onSearchChange:p,onValuesChange:f,filteredOptions:v,options:y}},getInitialState:function(){return{anchor:this.props.values?v(this.props.values):void 0,highlightedUid:void 0,open:!1,scrollLock:!1,search:"",values:this.props.defaultValues}},firstOptionIndexToHighlight:function(e){var t,n;return t=function(){var t;switch(!1){case 1!==e.length:return 0;case"undefined"!=typeof(null!=(t=e[0])?t.newOption:void 0):return 0;default:return a(function(e){return"boolean"==typeof e.selectable&&!e.selectable})(c(1)(e))?0:1}}(),n=this.props.hasOwnProperty("search")?this.props.search:this.state.search,this.props.firstOptionIndexToHighlight(t,e,this.values(),n)},focus:function(){this.refs.select.focus()},blur:function(){this.refs.select.blur()},highlightFirstSelectableOption:function(){this.state.open&&this.refs.select.highlightAndScrollToSelectableOption(this.firstOptionIndexToHighlight(this.getComputedState().options),1)},values:function(){return this.props.hasOwnProperty("values")?this.props.values:this.state.values},isOpen:function(){return this.props.hasOwnProperty("open")?this.props.open:this.state.open}})}).call(this)},function(e,t,n){(function(){function t(e,t){var n={}.hasOwnProperty;for(var r in t)n.call(t,r)&&(e[r]=t[r]);return e}var r,o,i,a,s,u;r=n(6).createClass,o=n(17),i=o.render,a=o.unmountComponentAtNode,s=n(119),u=n(210),e.exports=r({getDefaultProps:function(){return{parentElement:function(){return document.body}}},render:function(){return null},initTether:function(e){var n=this;this.node=document.createElement("div"),this.props.parentElement().appendChild(this.node),this.tether=new u(t({element:this.node,target:e.target()},e.options)),i(e.children,this.node,function(){return n.tether.position()})},destroyTether:function(){this.tether&&this.tether.destroy(),this.node&&(a(this.node),this.node.parentElement.removeChild(this.node)),this.node=this.tether=void 0},componentDidMount:function(){this.props.children&&this.initTether(this.props)},componentWillReceiveProps:function(e){var n=this;this.props.children&&!e.children?this.destroyTether():e.children&&!this.props.children?this.initTether(e):e.children&&(this.tether.setOptions(t({element:this.node,target:e.target()
-},e.options)),i(e.children,this.node,function(){return n.tether.position()}))},shouldComponentUpdate:function(e,t){return s(this,e,t)},componentWillUnmount:function(){this.destroyTether()}})}).call(this)},function(e,t,n){(function(){var t,r,o,i,a;t=n(6),r=t.createClass,o=t.createFactory,i=t.DOM.path,a=o(n(85)),e.exports=r({render:function(){return a({className:"react-selectize-reset-button",style:{width:8,height:8}},i({d:"M0 0 L8 8 M8 0 L 0 8"}))}})}).call(this)},function(e,t,n){(function(){function t(e,t){var n={}.hasOwnProperty;for(var r in t)n.call(t,r)&&(e[r]=t[r]);return e}var r,o,i,a,s,u,l,c;r=n(14),o=r.each,i=r.objToPairs,a=n(6),s=a.DOM.input,u=a.createClass,l=a.createFactory,c=n(17).findDOMNode,e.exports=u({displayName:"ResizableInput",render:function(){var e;return s((e=t({},this.props),e.type="input",e.className="resizable-input",e))},autosize:function(){var e,t,n,r,a;return e=t=c(this),e.style.width="0px",0===t.value.length?t.style.width=null!=t&&t.currentStyle?"4px":"2px":t.scrollWidth>0?t.style.width=2+t.scrollWidth+"px":(n=r=document.createElement("div"),n.innerHTML=t.value,function(){var e;return e=r.style,e.display="inline-block",e.width="",e}(o(function(e){var t,n;return t=e[0],n=e[1],r.style[t]=n})(i(t.currentStyle?t.currentStyle:null!=(a=document.defaultView)?a:window.getComputedStyle(t)))),document.body.appendChild(r),t.style.width=4+r.clientWidth+"px",document.body.removeChild(r))},componentDidMount:function(){this.autosize()},componentDidUpdate:function(){this.autosize()},blur:function(){return c(this).blur()},focus:function(){return c(this).focus()}})}).call(this)},function(e,t,n){(function(){function t(e,t){var n,r=function(o){return e.length>1?function(){var i=o?o.concat():[];return n=t?n||this:this,i.push.apply(i,arguments)<e.length&&arguments.length?r.call(n,i):e.apply(n,i)}:e};return r()}function r(e,t){var n={}.hasOwnProperty;for(var r in t)n.call(t,r)&&(e[r]=t[r]);return e}var o,i,a,s,u,l,c,p,f,d,h,v,m,g,y,b,C,_,w,E,x,T={}.toString;o=n(14),i=o.all,a=o.any,s=o.drop,u=o.camelize,l=o.difference,c=o.filter,p=o.find,f=o.findIndex,d=o.id,h=o.last,v=o.map,m=o.reject,g=n(16).isEqualToObject,y=n(6),b=y.createFactory,o=y.DOM,C=o.div,_=o.img,w=o.span,E=b(n(53)),x=n(29).cancelEvent,e.exports=y.createClass({displayName:"SimpleSelect",getDefaultProps:function(){return{delimiters:[],filterOptions:t(function(e,t){return c(function(e){return e.label.toLowerCase().trim().indexOf(t.toLowerCase().trim())>-1})(e)}),firstOptionIndexToHighlight:d,onBlur:function(e){},onBlurResetsInput:!0,onFocus:function(e){},onKeyboardSelectionFailed:function(e){},onPaste:function(e){},placeholder:"",renderValue:function(e){var t;return t=e.label,C({className:"simple-value"},w(null,t))},serialize:function(e){return null!=e?e.value:void 0},style:{},tether:!1,uid:d}},render:function(){var e,t,n,o,i,a,s,u,l,c,p,f,d,v,m,y,b,C,_,w,T,O,P,k,S,N,M,A,I,D,R,L,U,F,j,B,V,W=this;return e=this.getComputedState(),t=e.filteredOptions,n=e.highlightedUid,o=e.onHighlightedUidChange,i=e.onOpenChange,a=e.onSearchChange,s=e.onValueChange,u=e.open,l=e.options,c=e.search,p=e.value,f=e.values,null!=(e=this.props)&&(d=e.autofocus,v=e.autosize,m=e.cancelKeyboardEventOnSelection,y=e.delimiters,b=e.disabled,C=e.dropdownDirection,_=e.groupId,w=e.groups,T=e.groupsAsColumns,O=e.hideResetButton,P=e.name,k=e.inputProps,S=e.onBlurResetsInput,N=e.renderToggleButton,M=e.renderGroupTitle,A=e.renderResetButton,I=e.serialize,D=e.tether,R=e.tetherProps,L=e.theme,U=e.transitionEnter,F=e.transitionLeave,j=e.transitionEnterTimeout,B=e.transitionLeaveTimeout,V=e.uid),E(r(r({autofocus:d,autosize:v,cancelKeyboardEventOnSelection:m,className:"simple-select"+(this.props.className?" "+this.props.className:""),delimiters:y,disabled:b,dropdownDirection:C,groupId:_,groups:w,groupsAsColumns:T,hideResetButton:O,highlightedUid:n,onHighlightedUidChange:o,inputProps:k,name:P,onBlurResetsInput:S,renderGroupTitle:M,renderResetButton:A,renderToggleButton:N,scrollLock:this.state.scrollLock,onScrollLockChange:function(e){return W.setState({scrollLock:e})},tether:D,tetherProps:R,theme:L,transitionEnter:U,transitionEnterTimeout:j,transitionLeave:F,transitionLeaveTimeout:B,ref:"select",anchor:h(f),onAnchorChange:function(e,t){return t()},open:u,onOpenChange:i,firstOptionIndexToHighlight:function(){return W.firstOptionIndexToHighlight(l,p)},options:l,renderOption:this.props.renderOption,renderNoResultsFound:this.props.renderNoResultsFound,search:c,onSearchChange:function(e,t){return a(e,t)},values:f,onValuesChange:function(e,t){var n,r;return 0===e.length?s(void 0,function(){return t()}):(n=h(e),r=!g(n,p),function(){return function(e){return r?s(n,e):e()}}()(function(){return t(),i(!1,function(){})}))},renderValue:function(e){return u&&(W.props.editable||c.length>0)?null:W.props.renderValue(e)},onKeyboardSelectionFailed:function(e){return a("",function(){return i(!1,function(){return W.props.onKeyboardSelectionFailed(e)})})},uid:function(e){return{uid:W.props.uid(e),open:u,search:c}},serialize:function(e){return I(e[0])},onBlur:function(e){var t;t=W.props.onBlurResetsInput,function(){return function(e){return c.length>0&&t?a("",e):e()}}()(function(){return W.props.onBlur({value:p,open:u,originalEvent:e})})},onFocus:function(e){W.props.onFocus({value:p,open:u,originalEvent:e})},onPaste:function(){var e;switch(!1){case"undefined"!=typeof(null!=(e=this.props)?e.valueFromPaste:void 0):return this.props.onPaste;default:return function(e){var t,n;if(t=e.clipboardData,n=W.props.valueFromPaste(l,p,t.getData("text")))return function(){return s(n,function(){return a("",function(){return i(!1)})})}(),x(e)}}}.call(this),placeholder:this.props.placeholder,style:this.props.style},function(){switch(!1){case"function"!=typeof this.props.restoreOnBackspace:return{restoreOnBackspace:this.props.restoreOnBackspace};default:return{}}}.call(this)),function(){switch(!1){case"function"!=typeof this.props.renderNoResultsFound:return{renderNoResultsFound:function(){return W.props.renderNoResultsFound(p,c)}};default:return{}}}.call(this)))},getComputedState:function(){var e,t,n,o,i,a,s,l,c,p,f,d,h,m,g,y=this;return e=this.props.hasOwnProperty("highlightedUid")?this.props.highlightedUid:this.state.highlightedUid,t=this.isOpen(),n=this.props.hasOwnProperty("search")?this.props.search:this.state.search,o=this.value(),i=o||0===o?[o]:[],a=v(function(e){var t;return t=function(){switch(!1){case!(this.props.hasOwnProperty(e)&&this.props.hasOwnProperty(u("on-"+e+"-change"))):return function(t,n){return y.props[u("on-"+e+"-change")](t,function(){}),y.setState({},n)};case!(this.props.hasOwnProperty(e)&&!this.props.hasOwnProperty(u("on-"+e+"-change"))):return function(e,t){return t()};case!(!this.props.hasOwnProperty(e)&&this.props.hasOwnProperty(u("on-"+e+"-change"))):return function(t,n){var r;return y.setState((r={},r[e+""]=t,r),function(){return n(),y.props[u("on-"+e+"-change")](t,function(){})})};case!(!this.props.hasOwnProperty(e)&&!this.props.hasOwnProperty(u("on-"+e+"-change"))):return function(t,n){var r;return y.setState((r={},r[e+""]=t,r),n)}}}.call(y)})(["highlightedUid","open","search","value"]),s=a[0],l=a[1],c=a[2],p=a[3],f=function(){var e;switch(!1){case!(null!=(e=this.props)&&e.children):return v(function(e){var t,n,r;return null!=(t=null!=e?e.props:void 0)&&(n=t.value,r=t.children),{label:r,value:n}})("Array"===T.call(this.props.children).slice(8,-1)?this.props.children:[this.props.children]);default:return[]}}.call(this),d=this.props.hasOwnProperty("options")?null!=(a=this.props.options)?a:[]:f,h=this.props.filterOptions(d,n),m=function(){switch(!1){case"function"!=typeof this.props.createFromSearch:return this.props.createFromSearch(h,n);default:return null}}.call(this),g=(m?[(a=r({},m),a.newOption=!0,a)]:[]).concat(h),{highlightedUid:e,open:t,search:n,value:o,values:i,onHighlightedUidChange:s,onOpenChange:function(e,t){l(e,function(){if(t(),y.props.editable&&y.isOpen()&&o)return c(y.props.editable(o)+""+(1===n.length?n:""),function(){return y.highlightFirstSelectableOption(function(){})})})},onSearchChange:c,onValueChange:p,filteredOptions:h,options:g}},getInitialState:function(){var e;return{highlightedUid:void 0,open:!1,scrollLock:!1,search:"",value:null!=(e=this.props)?e.defaultValue:void 0}},firstOptionIndexToHighlight:function(e,t){var n,r,o;return n=t?f(function(e){return g(e,t)},e):void 0,r=function(){var t;switch(!1){case"undefined"==typeof n:return n;case 1!==e.length:return 0;case"undefined"!=typeof(null!=(t=e[0])?t.newOption:void 0):return 0;default:return i(function(e){return"boolean"==typeof e.selectable&&!e.selectable})(s(1)(e))?0:1}}(),o=this.props.hasOwnProperty("search")?this.props.search:this.state.search,this.props.firstOptionIndexToHighlight(r,e,t,o)},focus:function(){this.refs.select.focus()},blur:function(){this.refs.select.blur()},highlightFirstSelectableOption:function(e){var t,n,r;null==e&&(e=function(){}),this.state.open?(t=this.getComputedState(),n=t.options,r=t.value,this.refs.select.highlightAndScrollToSelectableOption(this.firstOptionIndexToHighlight(n,r),1,e)):e()},value:function(){return this.props.hasOwnProperty("value")?this.props.value:this.state.value},isOpen:function(){return this.props.hasOwnProperty("open")?this.props.open:this.state.open}})}).call(this)},function(e,t,n){(function(){var t,r,o,i,a;t=n(6),r=t.createClass,o=t.createFactory,i=t.DOM.path,a=o(n(85)),e.exports=r({getDefaultProps:function(){return{open:!1,flipped:!1}},render:function(){return a({className:"react-selectize-toggle-button",style:{width:10,height:8}},i({d:function(){switch(!1){case!(this.props.open&&!this.props.flipped||!this.props.open&&this.props.flipped):return"M0 6 L5 1 L10 6 Z";default:return"M0 1 L5 6 L10 1 Z"}}.call(this)}))}})}).call(this)},function(e,t,n){(function(){var t,r,o,i;t=n(6),r=t.createClass,o=t.DOM.div,i=n(16).isEqualToObject,e.exports=r({getDefaultProps:function(){return{}},render:function(){return o({className:"value-wrapper"},this.props.renderItem(this.props.item))},shouldComponentUpdate:function(e){var t;return!i(null!=e?e.uid:void 0,null!=(t=this.props)?t.uid:void 0)}})}).call(this)},function(e,t,n){(function(){var t,r,o,i;t=n(184),r=n(189),o=n(185),i=n(53),e.exports={HighlightedText:t,SimpleSelect:r,MultiSelect:o,ReactSelectize:i}}).call(this)},[212,22],function(e,t,n){"use strict";var r=n(65);t.getReactDOM=function(){return r}},function(e,t,n){"use strict";function r(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function o(e,t){if(!e)throw new ReferenceError("this hasn't been initialised - super() hasn't been called");return!t||"object"!=typeof t&&"function"!=typeof t?e:t}function i(e,t){if("function"!=typeof t&&null!==t)throw new TypeError("Super expression must either be null or a function, not "+typeof t);e.prototype=Object.create(t&&t.prototype,{constructor:{value:e,enumerable:!1,writable:!0,configurable:!0}}),t&&(Object.setPrototypeOf?Object.setPrototypeOf(e,t):e.__proto__=t)}function a(e){var t="transition"+e+"Timeout",n="transition"+e;return function(e){if(e[n]){if(null==e[t])return new Error(t+" wasn't supplied to ReactCSSTransitionGroup: this can cause unreliable animations and won't be supported in a future version of React. See https://fb.me/react-animation-transition-group-timeout for more information.");if("number"!=typeof e[t])return new Error(t+" must be a number (in milliseconds)")}}}var s=n(4),u=n(12),l=n(24),c=l(u.isValidElement),p=n(205),f=n(196),d=function(e){function t(){var n,i,a;r(this,t);for(var s=arguments.length,l=Array(s),c=0;c<s;c++)l[c]=arguments[c];return n=i=o(this,e.call.apply(e,[this].concat(l))),i._wrapChild=function(e){return u.createElement(f,{name:i.props.transitionName,appear:i.props.transitionAppear,enter:i.props.transitionEnter,leave:i.props.transitionLeave,appearTimeout:i.props.transitionAppearTimeout,enterTimeout:i.props.transitionEnterTimeout,leaveTimeout:i.props.transitionLeaveTimeout},e)},a=n,o(i,a)}return i(t,e),t.prototype.render=function(){return u.createElement(p,s({},this.props,{childFactory:this._wrapChild}))},t}(u.Component);d.displayName="ReactCSSTransitionGroup",d.propTypes={transitionName:f.propTypes.name,transitionAppear:c.bool,transitionEnter:c.bool,transitionLeave:c.bool,transitionAppearTimeout:a("Appear"),transitionEnterTimeout:a("Enter"),transitionLeaveTimeout:a("Leave")},d.defaultProps={transitionAppear:!1,transitionEnter:!0,transitionLeave:!0},e.exports=d},function(e,t,n){"use strict";function r(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function o(e,t){if(!e)throw new ReferenceError("this hasn't been initialised - super() hasn't been called");return!t||"object"!=typeof t&&"function"!=typeof t?e:t}function i(e,t){if("function"!=typeof t&&null!==t)throw new TypeError("Super expression must either be null or a function, not "+typeof t);e.prototype=Object.create(t&&t.prototype,{constructor:{value:e,enumerable:!1,writable:!0,configurable:!0}}),t&&(Object.setPrototypeOf?Object.setPrototypeOf(e,t):e.__proto__=t)}var a=n(12),s=n(194),u=n(24),l=u(a.isValidElement),c=n(96),p=n(204),f=n(89),d=17,h=function(e){function t(){var n,i,a;r(this,t);for(var u=arguments.length,l=Array(u),f=0;f<u;f++)l[f]=arguments[f];return n=i=o(this,e.call.apply(e,[this].concat(l))),i._isMounted=!1,i.transition=function(e,t,n){var r=s.getReactDOM().findDOMNode(i);if(!r)return void(t&&t());var o=i.props.name[e]||i.props.name+"-"+e,a=i.props.name[e+"Active"]||o+"-active",u=null,l=function(e){e&&e.target!==r||(clearTimeout(u),c.removeClass(r,o),c.removeClass(r,a),p.removeEndEventListener(r,l),t&&t())};c.addClass(r,o),i.queueClassAndNode(a,r),n?(u=setTimeout(l,n),i.transitionTimeouts.push(u)):p.addEndEventListener(r,l)},i.queueClassAndNode=function(e,t){i.classNameAndNodeQueue.push({className:e,node:t}),i.timeout||(i.timeout=setTimeout(i.flushClassNameAndNodeQueue,d))},i.flushClassNameAndNodeQueue=function(){i._isMounted&&i.classNameAndNodeQueue.forEach(function(e){c.addClass(e.node,e.className)}),i.classNameAndNodeQueue.length=0,i.timeout=null},i.componentWillAppear=function(e){i.props.appear?i.transition("appear",e,i.props.appearTimeout):e()},i.componentWillEnter=function(e){i.props.enter?i.transition("enter",e,i.props.enterTimeout):e()},i.componentWillLeave=function(e){i.props.leave?i.transition("leave",e,i.props.leaveTimeout):e()},a=n,o(i,a)}return i(t,e),t.prototype.componentWillMount=function(){this.classNameAndNodeQueue=[],this.transitionTimeouts=[]},t.prototype.componentDidMount=function(){this._isMounted=!0},t.prototype.componentWillUnmount=function(){this._isMounted=!1,this.timeout&&clearTimeout(this.timeout),this.transitionTimeouts.forEach(function(e){clearTimeout(e)}),this.classNameAndNodeQueue.length=0},t.prototype.render=function(){return f(this.props.children)},t}(a.Component);h.propTypes={name:l.oneOfType([l.string,l.shape({enter:l.string,leave:l.string,active:l.string}),l.shape({enter:l.string,enterActive:l.string,leave:l.string,leaveActive:l.string,appear:l.string,appearActive:l.string})]).isRequired,appear:l.bool,enter:l.bool,leave:l.bool,appearTimeout:l.number,enterTimeout:l.number,leaveTimeout:l.number},e.exports=h},function(e,t,n){"use strict";function r(e){return(""+e).replace(C,"$&/")}function o(e,t){this.func=e,this.context=t,this.count=0}function i(e,t,n){var r=e.func,o=e.context;r.call(o,t,e.count++)}function a(e,t,n){if(null==e)return e;var r=o.getPooled(t,n);g(e,i,r),o.release(r)}function s(e,t,n,r){this.result=e,this.keyPrefix=t,this.func=n,this.context=r,this.count=0}function u(e,t,n){var o=e.result,i=e.keyPrefix,a=e.func,s=e.context,u=a.call(s,t,e.count++);Array.isArray(u)?l(u,o,n,m.thatReturnsArgument):null!=u&&(v.isValidElement(u)&&(u=v.cloneAndReplaceKey(u,i+(!u.key||t&&t.key===u.key?"":r(u.key)+"/")+n)),o.push(u))}function l(e,t,n,o,i){var a="";null!=n&&(a=r(n)+"/");var l=s.getPooled(t,a,o,i);g(e,u,l),s.release(l)}function c(e,t,n){if(null==e)return e;var r=[];return l(e,r,null,t,n),r}function p(e,t,n){return null}function f(e,t){return g(e,p,null)}function d(e){var t=[];return l(e,t,null,m.thatReturnsArgument),t}var h=n(193),v=n(21),m=n(8),g=n(90),y=h.twoArgumentPooler,b=h.fourArgumentPooler,C=/\/+/g;o.prototype.destructor=function(){this.func=null,this.context=null,this.count=0},h.addPoolingTo(o,y),s.prototype.destructor=function(){this.result=null,this.keyPrefix=null,this.func=null,this.context=null,this.count=0},h.addPoolingTo(s,b);var _={forEach:a,map:c,mapIntoWithKeyPrefixInternal:l,count:f,toArray:d};e.exports=_},function(e,t,n){"use strict";function r(e){return e}function o(e,t){var n=C.hasOwnProperty(t)?C[t]:null;w.hasOwnProperty(t)&&("OVERRIDE_BASE"!==n?f("73",t):void 0),e&&("DEFINE_MANY"!==n&&"DEFINE_MANY_MERGED"!==n?f("74",t):void 0)}function i(e,t){if(t){"function"==typeof t?f("75"):void 0,v.isValidElement(t)?f("76"):void 0;var n=e.prototype,r=n.__reactAutoBindPairs;t.hasOwnProperty(y)&&_.mixins(e,t.mixins);for(var i in t)if(t.hasOwnProperty(i)&&i!==y){var a=t[i],s=n.hasOwnProperty(i);if(o(s,i),_.hasOwnProperty(i))_[i](e,a);else{var c=C.hasOwnProperty(i),p="function"==typeof a,d=p&&!c&&!s&&t.autobind!==!1;if(d)r.push(i,a),n[i]=a;else if(s){var h=C[i];!c||"DEFINE_MANY_MERGED"!==h&&"DEFINE_MANY"!==h?f("77",h,i):void 0,"DEFINE_MANY_MERGED"===h?n[i]=u(n[i],a):"DEFINE_MANY"===h&&(n[i]=l(n[i],a))}else n[i]=a}}}else;}function a(e,t){if(t)for(var n in t){var r=t[n];if(t.hasOwnProperty(n)){var o=n in _;o?f("78",n):void 0;var i=n in e;i?f("79",n):void 0,e[n]=r}}}function s(e,t){e&&t&&"object"==typeof e&&"object"==typeof t?void 0:f("80");for(var n in t)t.hasOwnProperty(n)&&(void 0!==e[n]?f("81",n):void 0,e[n]=t[n]);return e}function u(e,t){return function(){var n=e.apply(this,arguments),r=t.apply(this,arguments);if(null==n)return r;if(null==r)return n;var o={};return s(o,n),s(o,r),o}}function l(e,t){return function(){e.apply(this,arguments),t.apply(this,arguments)}}function c(e,t){var n=t.bind(e);return n}function p(e){for(var t=e.__reactAutoBindPairs,n=0;n<t.length;n+=2){var r=t[n],o=t[n+1];e[r]=c(e,o)}}var f=n(22),d=n(4),h=n(54),v=n(21),m=(n(200),n(56)),g=n(23),y=(n(1),n(2),"mixins"),b=[],C={mixins:"DEFINE_MANY",statics:"DEFINE_MANY",propTypes:"DEFINE_MANY",contextTypes:"DEFINE_MANY",childContextTypes:"DEFINE_MANY",getDefaultProps:"DEFINE_MANY_MERGED",getInitialState:"DEFINE_MANY_MERGED",getChildContext:"DEFINE_MANY_MERGED",render:"DEFINE_ONCE",componentWillMount:"DEFINE_MANY",componentDidMount:"DEFINE_MANY",componentWillReceiveProps:"DEFINE_MANY",shouldComponentUpdate:"DEFINE_ONCE",componentWillUpdate:"DEFINE_MANY",componentDidUpdate:"DEFINE_MANY",componentWillUnmount:"DEFINE_MANY",updateComponent:"OVERRIDE_BASE"},_={displayName:function(e,t){e.displayName=t},mixins:function(e,t){if(t)for(var n=0;n<t.length;n++)i(e,t[n])},childContextTypes:function(e,t){e.childContextTypes=d({},e.childContextTypes,t)},contextTypes:function(e,t){e.contextTypes=d({},e.contextTypes,t)},getDefaultProps:function(e,t){e.getDefaultProps?e.getDefaultProps=u(e.getDefaultProps,t):e.getDefaultProps=t},propTypes:function(e,t){e.propTypes=d({},e.propTypes,t)},statics:function(e,t){a(e,t)},autobind:function(){}},w={replaceState:function(e,t){this.updater.enqueueReplaceState(this,e),t&&this.updater.enqueueCallback(this,t,"replaceState")},isMounted:function(){return this.updater.isMounted(this)}},E=function(){};d(E.prototype,h.prototype,w);var x={createClass:function(e){var t=r(function(e,n,r){this.__reactAutoBindPairs.length&&p(this),this.props=e,this.context=n,this.refs=g,this.updater=r||m,this.state=null;var o=this.getInitialState?this.getInitialState():null;"object"!=typeof o||Array.isArray(o)?f("82",t.displayName||"ReactCompositeComponent"):void 0,this.state=o});t.prototype=new E,t.prototype.constructor=t,t.prototype.__reactAutoBindPairs=[],b.forEach(i.bind(null,t)),i(t,e),t.getDefaultProps&&(t.defaultProps=t.getDefaultProps()),t.prototype.render?void 0:f("83");for(var n in C)t.prototype[n]||(t.prototype[n]=null);return t},injection:{injectMixin:function(e){b.push(e)}}};e.exports=x},function(e,t,n){"use strict";var r=n(21),o=r.createFactory,i={a:o("a"),abbr:o("abbr"),address:o("address"),area:o("area"),article:o("article"),aside:o("aside"),audio:o("audio"),b:o("b"),base:o("base"),bdi:o("bdi"),bdo:o("bdo"),big:o("big"),blockquote:o("blockquote"),body:o("body"),br:o("br"),button:o("button"),canvas:o("canvas"),caption:o("caption"),cite:o("cite"),code:o("code"),col:o("col"),colgroup:o("colgroup"),data:o("data"),datalist:o("datalist"),dd:o("dd"),del:o("del"),details:o("details"),dfn:o("dfn"),dialog:o("dialog"),div:o("div"),dl:o("dl"),dt:o("dt"),em:o("em"),embed:o("embed"),fieldset:o("fieldset"),figcaption:o("figcaption"),figure:o("figure"),footer:o("footer"),form:o("form"),h1:o("h1"),h2:o("h2"),h3:o("h3"),h4:o("h4"),h5:o("h5"),h6:o("h6"),head:o("head"),header:o("header"),hgroup:o("hgroup"),hr:o("hr"),html:o("html"),i:o("i"),iframe:o("iframe"),img:o("img"),input:o("input"),ins:o("ins"),kbd:o("kbd"),keygen:o("keygen"),label:o("label"),legend:o("legend"),li:o("li"),link:o("link"),main:o("main"),map:o("map"),mark:o("mark"),menu:o("menu"),menuitem:o("menuitem"),meta:o("meta"),meter:o("meter"),nav:o("nav"),noscript:o("noscript"),object:o("object"),ol:o("ol"),optgroup:o("optgroup"),option:o("option"),output:o("output"),p:o("p"),param:o("param"),picture:o("picture"),pre:o("pre"),progress:o("progress"),q:o("q"),rp:o("rp"),rt:o("rt"),ruby:o("ruby"),s:o("s"),samp:o("samp"),script:o("script"),section:o("section"),select:o("select"),small:o("small"),source:o("source"),span:o("span"),strong:o("strong"),style:o("style"),sub:o("sub"),summary:o("summary"),sup:o("sup"),table:o("table"),tbody:o("tbody"),td:o("td"),textarea:o("textarea"),tfoot:o("tfoot"),th:o("th"),thead:o("thead"),time:o("time"),title:o("title"),tr:o("tr"),track:o("track"),u:o("u"),ul:o("ul"),var:o("var"),video:o("video"),wbr:o("wbr"),circle:o("circle"),clipPath:o("clipPath"),defs:o("defs"),ellipse:o("ellipse"),g:o("g"),image:o("image"),line:o("line"),linearGradient:o("linearGradient"),mask:o("mask"),path:o("path"),pattern:o("pattern"),polygon:o("polygon"),polyline:o("polyline"),radialGradient:o("radialGradient"),rect:o("rect"),stop:o("stop"),svg:o("svg"),text:o("text"),tspan:o("tspan")};e.exports=i},function(e,t,n){"use strict";var r={};e.exports=r},function(e,t,n){"use strict";var r=n(21),o=r.isValidElement,i=n(24);e.exports=i(o)},function(e,t,n){"use strict";function r(e,t,n){this.props=e,this.context=t,this.refs=u,this.updater=n||s}function o(){}var i=n(4),a=n(54),s=n(56),u=n(23);o.prototype=a.prototype,r.prototype=new o,r.prototype.constructor=r,i(r.prototype,a.prototype),r.prototype.isPureReactComponent=!0,e.exports=r},function(e,t,n){"use strict";var r=n(207),o={getChildMapping:function(e,t){return e?r(e):e},mergeChildMappings:function(e,t){function n(n){return t.hasOwnProperty(n)?t[n]:e[n]}e=e||{},t=t||{};var r={},o=[];for(var i in e)t.hasOwnProperty(i)?o.length&&(r[i]=o,o=[]):o.push(i);var a,s={};for(var u in t){if(r.hasOwnProperty(u))for(a=0;a<r[u].length;a++){var l=r[u][a];s[r[u][a]]=n(l)}s[u]=n(u)}for(a=0;a<o.length;a++)s[o[a]]=n(o[a]);return s}};e.exports=o},function(e,t,n){"use strict";function r(){var e=s("animationend"),t=s("transitionend");e&&u.push(e),t&&u.push(t)}function o(e,t,n){e.addEventListener(t,n,!1)}function i(e,t,n){e.removeEventListener(t,n,!1)}var a=n(7),s=n(79),u=[];a.canUseDOM&&r();var l={addEndEventListener:function(e,t){return 0===u.length?void window.setTimeout(t,0):void u.forEach(function(n){o(e,n,t)})},removeEndEventListener:function(e,t){0!==u.length&&u.forEach(function(n){i(e,n,t)})}};e.exports=l},function(e,t,n){"use strict";function r(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function o(e,t){if(!e)throw new ReferenceError("this hasn't been initialised - super() hasn't been called");return!t||"object"!=typeof t&&"function"!=typeof t?e:t}function i(e,t){if("function"!=typeof t&&null!==t)throw new TypeError("Super expression must either be null or a function, not "+typeof t);e.prototype=Object.create(t&&t.prototype,{constructor:{value:e,enumerable:!1,writable:!0,configurable:!0}}),t&&(Object.setPrototypeOf?Object.setPrototypeOf(e,t):e.__proto__=t)}var a=n(4),s=n(12),u=n(203),l=n(24),c=l(s.isValidElement),p=n(8),f=function(e){function t(){var n,i,s;r(this,t);for(var l=arguments.length,c=Array(l),p=0;p<l;p++)c[p]=arguments[p];return n=i=o(this,e.call.apply(e,[this].concat(c))),i.state={children:u.getChildMapping(i.props.children)},i.performAppear=function(e){i.currentlyTransitioningKeys[e]=!0;var t=i.refs[e];t.componentWillAppear?t.componentWillAppear(i._handleDoneAppearing.bind(i,e)):i._handleDoneAppearing(e)},i._handleDoneAppearing=function(e){var t=i.refs[e];t.componentDidAppear&&t.componentDidAppear(),delete i.currentlyTransitioningKeys[e];var n=u.getChildMapping(i.props.children);n&&n.hasOwnProperty(e)||i.performLeave(e)},i.performEnter=function(e){i.currentlyTransitioningKeys[e]=!0;var t=i.refs[e];t.componentWillEnter?t.componentWillEnter(i._handleDoneEntering.bind(i,e)):i._handleDoneEntering(e)},i._handleDoneEntering=function(e){var t=i.refs[e];t.componentDidEnter&&t.componentDidEnter(),delete i.currentlyTransitioningKeys[e];var n=u.getChildMapping(i.props.children);n&&n.hasOwnProperty(e)||i.performLeave(e)},i.performLeave=function(e){i.currentlyTransitioningKeys[e]=!0;var t=i.refs[e];t.componentWillLeave?t.componentWillLeave(i._handleDoneLeaving.bind(i,e)):i._handleDoneLeaving(e)},i._handleDoneLeaving=function(e){var t=i.refs[e];t.componentDidLeave&&t.componentDidLeave(),delete i.currentlyTransitioningKeys[e];var n=u.getChildMapping(i.props.children);n&&n.hasOwnProperty(e)?i.performEnter(e):i.setState(function(t){var n=a({},t.children);return delete n[e],{children:n}})},s=n,o(i,s)}return i(t,e),t.prototype.componentWillMount=function(){this.currentlyTransitioningKeys={},this.keysToEnter=[],this.keysToLeave=[]},t.prototype.componentDidMount=function(){var e=this.state.children;for(var t in e)e[t]&&this.performAppear(t)},t.prototype.componentWillReceiveProps=function(e){var t=u.getChildMapping(e.children),n=this.state.children;this.setState({children:u.mergeChildMappings(n,t)});var r;for(r in t){var o=n&&n.hasOwnProperty(r);!t[r]||o||this.currentlyTransitioningKeys[r]||this.keysToEnter.push(r)}for(r in n){var i=t&&t.hasOwnProperty(r);!n[r]||i||this.currentlyTransitioningKeys[r]||this.keysToLeave.push(r)}},t.prototype.componentDidUpdate=function(){var e=this.keysToEnter;this.keysToEnter=[],e.forEach(this.performEnter);var t=this.keysToLeave;this.keysToLeave=[],t.forEach(this.performLeave)},t.prototype.render=function(){var e=[];for(var t in this.state.children){var n=this.state.children[t];n&&e.push(s.cloneElement(this.props.childFactory(n),{ref:t,key:t}))}var r=a({},this.props);return delete r.transitionLeave,delete r.transitionName,delete r.transitionAppear,delete r.transitionEnter,delete r.childFactory,delete r.transitionLeaveTimeout,delete r.transitionEnterTimeout,delete r.transitionAppearTimeout,delete r.component,s.createElement(this.props.component,r,e)},t}(s.Component);f.displayName="ReactTransitionGroup",f.propTypes={component:c.any,childFactory:c.func},f.defaultProps={component:"span",childFactory:p.thatReturnsArgument},e.exports=f},158,function(e,t,n){(function(t){"use strict";function r(e,t,n,r){if(e&&"object"==typeof e){var o=e,i=void 0===o[n];i&&null!=t&&(o[n]=t)}}function o(e,t){if(null==e)return e;var n={};return i(e,r,n),n}var i=(n(86),n(90));n(2);e.exports=o}).call(t,n(36))},177,function(e,t){"use strict";function n(){return r++}var r=1;e.exports=n},function(e,t,n){var r,o;!function(i,a){r=a,o="function"==typeof r?r.call(t,n,t,e):r,!(void 0!==o&&(e.exports=o))}(this,function(e,t,n){"use strict";function r(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function o(e){var t=e.getBoundingClientRect(),n={};for(var r in t)n[r]=t[r];if(e.ownerDocument!==document){var i=e.ownerDocument.defaultView.frameElement;if(i){var a=o(i);n.top+=a.top,n.bottom+=a.top,n.left+=a.left,n.right+=a.left}}return n}function i(e){var t=getComputedStyle(e)||{},n=t.position,r=[];if("fixed"===n)return[e];for(var o=e;(o=o.parentNode)&&o&&1===o.nodeType;){var i=void 0;try{i=getComputedStyle(o)}catch(e){}if("undefined"==typeof i||null===i)return r.push(o),r;var a=i,s=a.overflow,u=a.overflowX,l=a.overflowY;/(auto|scroll)/.test(s+l+u)&&("absolute"!==n||["relative","absolute","fixed"].indexOf(i.position)>=0)&&r.push(o)}return r.push(e.ownerDocument.body),e.ownerDocument!==document&&r.push(e.ownerDocument.defaultView),r}function a(){T&&document.body.removeChild(T),T=null}function s(e){var t=void 0;e===document?(t=document,e=document.documentElement):t=e.ownerDocument;var n=t.documentElement,r=o(e),i=k();return r.top-=i.top,r.left-=i.left,"undefined"==typeof r.width&&(r.width=document.body.scrollWidth-r.left-r.right),"undefined"==typeof r.height&&(r.height=document.body.scrollHeight-r.top-r.bottom),r.top=r.top-n.clientTop,r.left=r.left-n.clientLeft,r.right=t.body.clientWidth-r.width-r.left,r.bottom=t.body.clientHeight-r.height-r.top,r}function u(e){return e.offsetParent||document.documentElement}function l(){if(S)return S;var e=document.createElement("div");e.style.width="100%",e.style.height="200px";var t=document.createElement("div");c(t.style,{position:"absolute",top:0,left:0,pointerEvents:"none",visibility:"hidden",width:"200px",height:"150px",overflow:"hidden"}),t.appendChild(e),document.body.appendChild(t);var n=e.offsetWidth;t.style.overflow="scroll";var r=e.offsetWidth;n===r&&(r=t.clientWidth),document.body.removeChild(t);var o=n-r;return S={width:o,height:o}}function c(){var e=arguments.length<=0||void 0===arguments[0]?{}:arguments[0],t=[];return Array.prototype.push.apply(t,arguments),t.slice(1).forEach(function(t){if(t)for(var n in t)({}).hasOwnProperty.call(t,n)&&(e[n]=t[n])}),e}function p(e,t){if("undefined"!=typeof e.classList)t.split(" ").forEach(function(t){t.trim()&&e.classList.remove(t)});else{var n=new RegExp("(^| )"+t.split(" ").join("|")+"( |$)","gi"),r=h(e).replace(n," ");v(e,r)}}function f(e,t){if("undefined"!=typeof e.classList)t.split(" ").forEach(function(t){t.trim()&&e.classList.add(t)});else{p(e,t);var n=h(e)+(" "+t);v(e,n)}}function d(e,t){if("undefined"!=typeof e.classList)return e.classList.contains(t);var n=h(e);return new RegExp("(^| )"+t+"( |$)","gi").test(n)}function h(e){return e.className instanceof e.ownerDocument.defaultView.SVGAnimatedString?e.className.baseVal:e.className}function v(e,t){e.setAttribute("class",t)}function m(e,t,n){n.forEach(function(n){t.indexOf(n)===-1&&d(e,n)&&p(e,n)}),t.forEach(function(t){d(e,t)||f(e,t)})}function r(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function g(e,t){if("function"!=typeof t&&null!==t)throw new TypeError("Super expression must either be null or a function, not "+typeof t);e.prototype=Object.create(t&&t.prototype,{constructor:{value:e,enumerable:!1,writable:!0,configurable:!0}}),t&&(Object.setPrototypeOf?Object.setPrototypeOf(e,t):e.__proto__=t)}function y(e,t){var n=arguments.length<=2||void 0===arguments[2]?1:arguments[2];return e+n>=t&&t>=e-n}function b(){return"undefined"!=typeof performance&&"undefined"!=typeof performance.now?performance.now():+new Date}function C(){for(var e={top:0,left:0},t=arguments.length,n=Array(t),r=0;r<t;r++)n[r]=arguments[r];return n.forEach(function(t){var n=t.top,r=t.left;"string"==typeof n&&(n=parseFloat(n,10)),"string"==typeof r&&(r=parseFloat(r,10)),e.top+=n,e.left+=r}),e}function _(e,t){return"string"==typeof e.left&&e.left.indexOf("%")!==-1&&(e.left=parseFloat(e.left,10)/100*t.width),"string"==typeof e.top&&e.top.indexOf("%")!==-1&&(e.top=parseFloat(e.top,10)/100*t.height),e}function w(e,t){return"scrollParent"===t?t=e.scrollParents[0]:"window"===t&&(t=[pageXOffset,pageYOffset,innerWidth+pageXOffset,innerHeight+pageYOffset]),t===document&&(t=t.documentElement),"undefined"!=typeof t.nodeType&&!function(){var e=t,n=s(t),r=n,o=getComputedStyle(t);
-if(t=[r.left,r.top,n.width+r.left,n.height+r.top],e.ownerDocument!==document){var i=e.ownerDocument.defaultView;t[0]+=i.pageXOffset,t[1]+=i.pageYOffset,t[2]+=i.pageXOffset,t[3]+=i.pageYOffset}G.forEach(function(e,n){e=e[0].toUpperCase()+e.substr(1),"Top"===e||"Left"===e?t[n]+=parseFloat(o["border"+e+"Width"]):t[n]-=parseFloat(o["border"+e+"Width"])})}(),t}var E=function(){function e(e,t){for(var n=0;n<t.length;n++){var r=t[n];r.enumerable=r.enumerable||!1,r.configurable=!0,"value"in r&&(r.writable=!0),Object.defineProperty(e,r.key,r)}}return function(t,n,r){return n&&e(t.prototype,n),r&&e(t,r),t}}(),x=void 0;"undefined"==typeof x&&(x={modules:[]});var T=null,O=function(){var e=0;return function(){return++e}}(),P={},k=function(){var e=T;e&&document.body.contains(e)||(e=document.createElement("div"),e.setAttribute("data-tether-id",O()),c(e.style,{top:0,left:0,position:"absolute"}),document.body.appendChild(e),T=e);var t=e.getAttribute("data-tether-id");return"undefined"==typeof P[t]&&(P[t]=o(e),M(function(){delete P[t]})),P[t]},S=null,N=[],M=function(e){N.push(e)},A=function(){for(var e=void 0;e=N.pop();)e()},I=function(){function e(){r(this,e)}return E(e,[{key:"on",value:function(e,t,n){var r=!(arguments.length<=3||void 0===arguments[3])&&arguments[3];"undefined"==typeof this.bindings&&(this.bindings={}),"undefined"==typeof this.bindings[e]&&(this.bindings[e]=[]),this.bindings[e].push({handler:t,ctx:n,once:r})}},{key:"once",value:function(e,t,n){this.on(e,t,n,!0)}},{key:"off",value:function(e,t){if("undefined"!=typeof this.bindings&&"undefined"!=typeof this.bindings[e])if("undefined"==typeof t)delete this.bindings[e];else for(var n=0;n<this.bindings[e].length;)this.bindings[e][n].handler===t?this.bindings[e].splice(n,1):++n}},{key:"trigger",value:function(e){if("undefined"!=typeof this.bindings&&this.bindings[e]){for(var t=0,n=arguments.length,r=Array(n>1?n-1:0),o=1;o<n;o++)r[o-1]=arguments[o];for(;t<this.bindings[e].length;){var i=this.bindings[e][t],a=i.handler,s=i.ctx,u=i.once,l=s;"undefined"==typeof l&&(l=this),a.apply(l,r),u?this.bindings[e].splice(t,1):++t}}}}]),e}();x.Utils={getActualBoundingClientRect:o,getScrollParents:i,getBounds:s,getOffsetParent:u,extend:c,addClass:f,removeClass:p,hasClass:d,updateClasses:m,defer:M,flush:A,uniqueId:O,Evented:I,getScrollBarSize:l,removeUtilElements:a};var D=function(){function e(e,t){var n=[],r=!0,o=!1,i=void 0;try{for(var a,s=e[Symbol.iterator]();!(r=(a=s.next()).done)&&(n.push(a.value),!t||n.length!==t);r=!0);}catch(e){o=!0,i=e}finally{try{!r&&s.return&&s.return()}finally{if(o)throw i}}return n}return function(t,n){if(Array.isArray(t))return t;if(Symbol.iterator in Object(t))return e(t,n);throw new TypeError("Invalid attempt to destructure non-iterable instance")}}(),E=function(){function e(e,t){for(var n=0;n<t.length;n++){var r=t[n];r.enumerable=r.enumerable||!1,r.configurable=!0,"value"in r&&(r.writable=!0),Object.defineProperty(e,r.key,r)}}return function(t,n,r){return n&&e(t.prototype,n),r&&e(t,r),t}}(),R=function(e,t,n){for(var r=!0;r;){var o=e,i=t,a=n;r=!1,null===o&&(o=Function.prototype);var s=Object.getOwnPropertyDescriptor(o,i);if(void 0!==s){if("value"in s)return s.value;var u=s.get;if(void 0===u)return;return u.call(a)}var l=Object.getPrototypeOf(o);if(null===l)return;e=l,t=i,n=a,r=!0,s=l=void 0}};if("undefined"==typeof x)throw new Error("You must include the utils.js file before tether.js");var L=x.Utils,i=L.getScrollParents,s=L.getBounds,u=L.getOffsetParent,c=L.extend,f=L.addClass,p=L.removeClass,m=L.updateClasses,M=L.defer,A=L.flush,l=L.getScrollBarSize,a=L.removeUtilElements,U=function(){if("undefined"==typeof document)return"";for(var e=document.createElement("div"),t=["transform","WebkitTransform","OTransform","MozTransform","msTransform"],n=0;n<t.length;++n){var r=t[n];if(void 0!==e.style[r])return r}}(),F=[],j=function(){F.forEach(function(e){e.position(!1)}),A()};!function(){var e=null,t=null,n=null,r=function r(){return"undefined"!=typeof t&&t>16?(t=Math.min(t-16,250),void(n=setTimeout(r,250))):void("undefined"!=typeof e&&b()-e<10||(null!=n&&(clearTimeout(n),n=null),e=b(),j(),t=b()-e))};"undefined"!=typeof window&&"undefined"!=typeof window.addEventListener&&["resize","scroll","touchmove"].forEach(function(e){window.addEventListener(e,r)})}();var B={center:"center",left:"right",right:"left"},V={middle:"middle",top:"bottom",bottom:"top"},W={top:0,left:0,middle:"50%",center:"50%",bottom:"100%",right:"100%"},H=function(e,t){var n=e.left,r=e.top;return"auto"===n&&(n=B[t.left]),"auto"===r&&(r=V[t.top]),{left:n,top:r}},q=function(e){var t=e.left,n=e.top;return"undefined"!=typeof W[e.left]&&(t=W[e.left]),"undefined"!=typeof W[e.top]&&(n=W[e.top]),{left:t,top:n}},z=function(e){var t=e.split(" "),n=D(t,2),r=n[0],o=n[1];return{top:r,left:o}},K=z,Y=function(e){function t(e){var n=this;r(this,t),R(Object.getPrototypeOf(t.prototype),"constructor",this).call(this),this.position=this.position.bind(this),F.push(this),this.history=[],this.setOptions(e,!1),x.modules.forEach(function(e){"undefined"!=typeof e.initialize&&e.initialize.call(n)}),this.position()}return g(t,e),E(t,[{key:"getClass",value:function(){var e=arguments.length<=0||void 0===arguments[0]?"":arguments[0],t=this.options.classes;return"undefined"!=typeof t&&t[e]?this.options.classes[e]:this.options.classPrefix?this.options.classPrefix+"-"+e:e}},{key:"setOptions",value:function(e){var t=this,n=arguments.length<=1||void 0===arguments[1]||arguments[1],r={offset:"0 0",targetOffset:"0 0",targetAttachment:"auto auto",classPrefix:"tether"};this.options=c(r,e);var o=this.options,a=o.element,s=o.target,u=o.targetModifier;if(this.element=a,this.target=s,this.targetModifier=u,"viewport"===this.target?(this.target=document.body,this.targetModifier="visible"):"scroll-handle"===this.target&&(this.target=document.body,this.targetModifier="scroll-handle"),["element","target"].forEach(function(e){if("undefined"==typeof t[e])throw new Error("Tether Error: Both element and target must be defined");"undefined"!=typeof t[e].jquery?t[e]=t[e][0]:"string"==typeof t[e]&&(t[e]=document.querySelector(t[e]))}),f(this.element,this.getClass("element")),this.options.addTargetClasses!==!1&&f(this.target,this.getClass("target")),!this.options.attachment)throw new Error("Tether Error: You must provide an attachment");this.targetAttachment=K(this.options.targetAttachment),this.attachment=K(this.options.attachment),this.offset=z(this.options.offset),this.targetOffset=z(this.options.targetOffset),"undefined"!=typeof this.scrollParents&&this.disable(),"scroll-handle"===this.targetModifier?this.scrollParents=[this.target]:this.scrollParents=i(this.target),this.options.enabled!==!1&&this.enable(n)}},{key:"getTargetBounds",value:function(){if("undefined"==typeof this.targetModifier)return s(this.target);if("visible"===this.targetModifier){if(this.target===document.body)return{top:pageYOffset,left:pageXOffset,height:innerHeight,width:innerWidth};var e=s(this.target),t={height:e.height,width:e.width,top:e.top,left:e.left};return t.height=Math.min(t.height,e.height-(pageYOffset-e.top)),t.height=Math.min(t.height,e.height-(e.top+e.height-(pageYOffset+innerHeight))),t.height=Math.min(innerHeight,t.height),t.height-=2,t.width=Math.min(t.width,e.width-(pageXOffset-e.left)),t.width=Math.min(t.width,e.width-(e.left+e.width-(pageXOffset+innerWidth))),t.width=Math.min(innerWidth,t.width),t.width-=2,t.top<pageYOffset&&(t.top=pageYOffset),t.left<pageXOffset&&(t.left=pageXOffset),t}if("scroll-handle"===this.targetModifier){var e=void 0,n=this.target;n===document.body?(n=document.documentElement,e={left:pageXOffset,top:pageYOffset,height:innerHeight,width:innerWidth}):e=s(n);var r=getComputedStyle(n),o=n.scrollWidth>n.clientWidth||[r.overflow,r.overflowX].indexOf("scroll")>=0||this.target!==document.body,i=0;o&&(i=15);var a=e.height-parseFloat(r.borderTopWidth)-parseFloat(r.borderBottomWidth)-i,t={width:15,height:.975*a*(a/n.scrollHeight),left:e.left+e.width-parseFloat(r.borderLeftWidth)-15},u=0;a<408&&this.target===document.body&&(u=-11e-5*Math.pow(a,2)-.00727*a+22.58),this.target!==document.body&&(t.height=Math.max(t.height,24));var l=this.target.scrollTop/(n.scrollHeight-a);return t.top=l*(a-t.height-u)+e.top+parseFloat(r.borderTopWidth),this.target===document.body&&(t.height=Math.max(t.height,24)),t}}},{key:"clearCache",value:function(){this._cache={}}},{key:"cache",value:function(e,t){return"undefined"==typeof this._cache&&(this._cache={}),"undefined"==typeof this._cache[e]&&(this._cache[e]=t.call(this)),this._cache[e]}},{key:"enable",value:function(){var e=this,t=arguments.length<=0||void 0===arguments[0]||arguments[0];this.options.addTargetClasses!==!1&&f(this.target,this.getClass("enabled")),f(this.element,this.getClass("enabled")),this.enabled=!0,this.scrollParents.forEach(function(t){t!==e.target.ownerDocument&&t.addEventListener("scroll",e.position)}),t&&this.position()}},{key:"disable",value:function(){var e=this;p(this.target,this.getClass("enabled")),p(this.element,this.getClass("enabled")),this.enabled=!1,"undefined"!=typeof this.scrollParents&&this.scrollParents.forEach(function(t){t.removeEventListener("scroll",e.position)})}},{key:"destroy",value:function(){var e=this;this.disable(),F.forEach(function(t,n){t===e&&F.splice(n,1)}),0===F.length&&a()}},{key:"updateAttachClasses",value:function(e,t){var n=this;e=e||this.attachment,t=t||this.targetAttachment;var r=["left","top","bottom","right","middle","center"];"undefined"!=typeof this._addAttachClasses&&this._addAttachClasses.length&&this._addAttachClasses.splice(0,this._addAttachClasses.length),"undefined"==typeof this._addAttachClasses&&(this._addAttachClasses=[]);var o=this._addAttachClasses;e.top&&o.push(this.getClass("element-attached")+"-"+e.top),e.left&&o.push(this.getClass("element-attached")+"-"+e.left),t.top&&o.push(this.getClass("target-attached")+"-"+t.top),t.left&&o.push(this.getClass("target-attached")+"-"+t.left);var i=[];r.forEach(function(e){i.push(n.getClass("element-attached")+"-"+e),i.push(n.getClass("target-attached")+"-"+e)}),M(function(){"undefined"!=typeof n._addAttachClasses&&(m(n.element,n._addAttachClasses,i),n.options.addTargetClasses!==!1&&m(n.target,n._addAttachClasses,i),delete n._addAttachClasses)})}},{key:"position",value:function(){var e=this,t=arguments.length<=0||void 0===arguments[0]||arguments[0];if(this.enabled){this.clearCache();var n=H(this.targetAttachment,this.attachment);this.updateAttachClasses(this.attachment,n);var r=this.cache("element-bounds",function(){return s(e.element)}),o=r.width,i=r.height;if(0===o&&0===i&&"undefined"!=typeof this.lastSize){var a=this.lastSize;o=a.width,i=a.height}else this.lastSize={width:o,height:i};var c=this.cache("target-bounds",function(){return e.getTargetBounds()}),p=c,f=_(q(this.attachment),{width:o,height:i}),d=_(q(n),p),h=_(this.offset,{width:o,height:i}),v=_(this.targetOffset,p);f=C(f,h),d=C(d,v);for(var m=c.left+d.left-f.left,g=c.top+d.top-f.top,y=0;y<x.modules.length;++y){var b=x.modules[y],w=b.position.call(this,{left:m,top:g,targetAttachment:n,targetPos:c,elementPos:r,offset:f,targetOffset:d,manualOffset:h,manualTargetOffset:v,scrollbarSize:P,attachment:this.attachment});if(w===!1)return!1;"undefined"!=typeof w&&"object"==typeof w&&(g=w.top,m=w.left)}var E={page:{top:g,left:m},viewport:{top:g-pageYOffset,bottom:pageYOffset-g-i+innerHeight,left:m-pageXOffset,right:pageXOffset-m-o+innerWidth}},T=this.target.ownerDocument,O=T.defaultView,P=void 0;return O.innerHeight>T.documentElement.clientHeight&&(P=this.cache("scrollbar-size",l),E.viewport.bottom-=P.height),O.innerWidth>T.documentElement.clientWidth&&(P=this.cache("scrollbar-size",l),E.viewport.right-=P.width),["","static"].indexOf(T.body.style.position)!==-1&&["","static"].indexOf(T.body.parentElement.style.position)!==-1||(E.page.bottom=T.body.scrollHeight-g-i,E.page.right=T.body.scrollWidth-m-o),"undefined"!=typeof this.options.optimizations&&this.options.optimizations.moveElement!==!1&&"undefined"==typeof this.targetModifier&&!function(){var t=e.cache("target-offsetparent",function(){return u(e.target)}),n=e.cache("target-offsetparent-bounds",function(){return s(t)}),r=getComputedStyle(t),o=n,i={};if(["Top","Left","Bottom","Right"].forEach(function(e){i[e.toLowerCase()]=parseFloat(r["border"+e+"Width"])}),n.right=T.body.scrollWidth-n.left-o.width+i.right,n.bottom=T.body.scrollHeight-n.top-o.height+i.bottom,E.page.top>=n.top+i.top&&E.page.bottom>=n.bottom&&E.page.left>=n.left+i.left&&E.page.right>=n.right){var a=t.scrollTop,l=t.scrollLeft;E.offset={top:E.page.top-n.top+a-i.top,left:E.page.left-n.left+l-i.left}}}(),this.move(E),this.history.unshift(E),this.history.length>3&&this.history.pop(),t&&A(),!0}}},{key:"move",value:function(e){var t=this;if("undefined"!=typeof this.element.parentNode){var n={};for(var r in e){n[r]={};for(var o in e[r]){for(var i=!1,a=0;a<this.history.length;++a){var s=this.history[a];if("undefined"!=typeof s[r]&&!y(s[r][o],e[r][o])){i=!0;break}}i||(n[r][o]=!0)}}var l={top:"",left:"",right:"",bottom:""},p=function(e,n){var r="undefined"!=typeof t.options.optimizations,o=r?t.options.optimizations.gpu:null;if(o!==!1){var i=void 0,a=void 0;if(e.top?(l.top=0,i=n.top):(l.bottom=0,i=-n.bottom),e.left?(l.left=0,a=n.left):(l.right=0,a=-n.right),window.matchMedia){var s=window.matchMedia("only screen and (min-resolution: 1.3dppx)").matches||window.matchMedia("only screen and (-webkit-min-device-pixel-ratio: 1.3)").matches;s||(a=Math.round(a),i=Math.round(i))}l[U]="translateX("+a+"px) translateY("+i+"px)","msTransform"!==U&&(l[U]+=" translateZ(0)")}else e.top?l.top=n.top+"px":l.bottom=n.bottom+"px",e.left?l.left=n.left+"px":l.right=n.right+"px"},f=!1;if((n.page.top||n.page.bottom)&&(n.page.left||n.page.right)?(l.position="absolute",p(n.page,e.page)):(n.viewport.top||n.viewport.bottom)&&(n.viewport.left||n.viewport.right)?(l.position="fixed",p(n.viewport,e.viewport)):"undefined"!=typeof n.offset&&n.offset.top&&n.offset.left?!function(){l.position="absolute";var r=t.cache("target-offsetparent",function(){return u(t.target)});u(t.element)!==r&&M(function(){t.element.parentNode.removeChild(t.element),r.appendChild(t.element)}),p(n.offset,e.offset),f=!0}():(l.position="absolute",p({top:!0,left:!0},e.page)),!f)if(this.options.bodyElement)this.options.bodyElement.appendChild(this.element);else{for(var d=!0,h=this.element.parentNode;h&&1===h.nodeType&&"BODY"!==h.tagName;){if("static"!==getComputedStyle(h).position){d=!1;break}h=h.parentNode}d||(this.element.parentNode.removeChild(this.element),this.element.ownerDocument.body.appendChild(this.element))}var v={},m=!1;for(var o in l){var g=l[o],b=this.element.style[o];b!==g&&(m=!0,v[o]=g)}m&&M(function(){c(t.element.style,v),t.trigger("repositioned")})}}}]),t}(I);Y.modules=[],x.position=j;var X=c(Y,x),D=function(){function e(e,t){var n=[],r=!0,o=!1,i=void 0;try{for(var a,s=e[Symbol.iterator]();!(r=(a=s.next()).done)&&(n.push(a.value),!t||n.length!==t);r=!0);}catch(e){o=!0,i=e}finally{try{!r&&s.return&&s.return()}finally{if(o)throw i}}return n}return function(t,n){if(Array.isArray(t))return t;if(Symbol.iterator in Object(t))return e(t,n);throw new TypeError("Invalid attempt to destructure non-iterable instance")}}(),L=x.Utils,s=L.getBounds,c=L.extend,m=L.updateClasses,M=L.defer,G=["left","top","right","bottom"];x.modules.push({position:function(e){var t=this,n=e.top,r=e.left,o=e.targetAttachment;if(!this.options.constraints)return!0;var i=this.cache("element-bounds",function(){return s(t.element)}),a=i.height,u=i.width;if(0===u&&0===a&&"undefined"!=typeof this.lastSize){var l=this.lastSize;u=l.width,a=l.height}var p=this.cache("target-bounds",function(){return t.getTargetBounds()}),f=p.height,d=p.width,h=[this.getClass("pinned"),this.getClass("out-of-bounds")];this.options.constraints.forEach(function(e){var t=e.outOfBoundsClass,n=e.pinnedClass;t&&h.push(t),n&&h.push(n)}),h.forEach(function(e){["left","top","right","bottom"].forEach(function(t){h.push(e+"-"+t)})});var v=[],g=c({},o),y=c({},this.attachment);return this.options.constraints.forEach(function(e){var i=e.to,s=e.attachment,l=e.pin;"undefined"==typeof s&&(s="");var c=void 0,p=void 0;if(s.indexOf(" ")>=0){var h=s.split(" "),m=D(h,2);p=m[0],c=m[1]}else c=p=s;var b=w(t,i);"target"!==p&&"both"!==p||(n<b[1]&&"top"===g.top&&(n+=f,g.top="bottom"),n+a>b[3]&&"bottom"===g.top&&(n-=f,g.top="top")),"together"===p&&("top"===g.top&&("bottom"===y.top&&n<b[1]?(n+=f,g.top="bottom",n+=a,y.top="top"):"top"===y.top&&n+a>b[3]&&n-(a-f)>=b[1]&&(n-=a-f,g.top="bottom",y.top="bottom")),"bottom"===g.top&&("top"===y.top&&n+a>b[3]?(n-=f,g.top="top",n-=a,y.top="bottom"):"bottom"===y.top&&n<b[1]&&n+(2*a-f)<=b[3]&&(n+=a-f,g.top="top",y.top="top")),"middle"===g.top&&(n+a>b[3]&&"top"===y.top?(n-=a,y.top="bottom"):n<b[1]&&"bottom"===y.top&&(n+=a,y.top="top"))),"target"!==c&&"both"!==c||(r<b[0]&&"left"===g.left&&(r+=d,g.left="right"),r+u>b[2]&&"right"===g.left&&(r-=d,g.left="left")),"together"===c&&(r<b[0]&&"left"===g.left?"right"===y.left?(r+=d,g.left="right",r+=u,y.left="left"):"left"===y.left&&(r+=d,g.left="right",r-=u,y.left="right"):r+u>b[2]&&"right"===g.left?"left"===y.left?(r-=d,g.left="left",r-=u,y.left="right"):"right"===y.left&&(r-=d,g.left="left",r+=u,y.left="left"):"center"===g.left&&(r+u>b[2]&&"left"===y.left?(r-=u,y.left="right"):r<b[0]&&"right"===y.left&&(r+=u,y.left="left"))),"element"!==p&&"both"!==p||(n<b[1]&&"bottom"===y.top&&(n+=a,y.top="top"),n+a>b[3]&&"top"===y.top&&(n-=a,y.top="bottom")),"element"!==c&&"both"!==c||(r<b[0]&&("right"===y.left?(r+=u,y.left="left"):"center"===y.left&&(r+=u/2,y.left="left")),r+u>b[2]&&("left"===y.left?(r-=u,y.left="right"):"center"===y.left&&(r-=u/2,y.left="right"))),"string"==typeof l?l=l.split(",").map(function(e){return e.trim()}):l===!0&&(l=["top","left","right","bottom"]),l=l||[];var C=[],_=[];n<b[1]&&(l.indexOf("top")>=0?(n=b[1],C.push("top")):_.push("top")),n+a>b[3]&&(l.indexOf("bottom")>=0?(n=b[3]-a,C.push("bottom")):_.push("bottom")),r<b[0]&&(l.indexOf("left")>=0?(r=b[0],C.push("left")):_.push("left")),r+u>b[2]&&(l.indexOf("right")>=0?(r=b[2]-u,C.push("right")):_.push("right")),C.length&&!function(){var e=void 0;e="undefined"!=typeof t.options.pinnedClass?t.options.pinnedClass:t.getClass("pinned"),v.push(e),C.forEach(function(t){v.push(e+"-"+t)})}(),_.length&&!function(){var e=void 0;e="undefined"!=typeof t.options.outOfBoundsClass?t.options.outOfBoundsClass:t.getClass("out-of-bounds"),v.push(e),_.forEach(function(t){v.push(e+"-"+t)})}(),(C.indexOf("left")>=0||C.indexOf("right")>=0)&&(y.left=g.left=!1),(C.indexOf("top")>=0||C.indexOf("bottom")>=0)&&(y.top=g.top=!1),g.top===o.top&&g.left===o.left&&y.top===t.attachment.top&&y.left===t.attachment.left||(t.updateAttachClasses(y,g),t.trigger("update",{attachment:y,targetAttachment:g}))}),M(function(){t.options.addTargetClasses!==!1&&m(t.target,v,h),m(t.element,v,h)}),{top:n,left:r}}});var L=x.Utils,s=L.getBounds,m=L.updateClasses,M=L.defer;x.modules.push({position:function(e){var t=this,n=e.top,r=e.left,o=this.cache("element-bounds",function(){return s(t.element)}),i=o.height,a=o.width,u=this.getTargetBounds(),l=n+i,c=r+a,p=[];n<=u.bottom&&l>=u.top&&["left","right"].forEach(function(e){var t=u[e];t!==r&&t!==c||p.push(e)}),r<=u.right&&c>=u.left&&["top","bottom"].forEach(function(e){var t=u[e];t!==n&&t!==l||p.push(e)});var f=[],d=[],h=["left","top","right","bottom"];return f.push(this.getClass("abutted")),h.forEach(function(e){f.push(t.getClass("abutted")+"-"+e)}),p.length&&d.push(this.getClass("abutted")),p.forEach(function(e){d.push(t.getClass("abutted")+"-"+e)}),M(function(){t.options.addTargetClasses!==!1&&m(t.target,d,f),m(t.element,d,f)}),!0}});var D=function(){function e(e,t){var n=[],r=!0,o=!1,i=void 0;try{for(var a,s=e[Symbol.iterator]();!(r=(a=s.next()).done)&&(n.push(a.value),!t||n.length!==t);r=!0);}catch(e){o=!0,i=e}finally{try{!r&&s.return&&s.return()}finally{if(o)throw i}}return n}return function(t,n){if(Array.isArray(t))return t;if(Symbol.iterator in Object(t))return e(t,n);throw new TypeError("Invalid attempt to destructure non-iterable instance")}}();return x.modules.push({position:function(e){var t=e.top,n=e.left;if(this.options.shift){var r=this.options.shift;"function"==typeof this.options.shift&&(r=this.options.shift.call(this,{top:t,left:n}));var o=void 0,i=void 0;if("string"==typeof r){r=r.split(" "),r[1]=r[1]||r[0];var a=r,s=D(a,2);o=s[0],i=s[1],o=parseFloat(o,10),i=parseFloat(i,10)}else o=r.top,i=r.left;return t+=o,n+=i,{top:t,left:n}}}}),X})},function(e,t){!function(e){"use strict";function t(e){if("string"!=typeof e&&(e=String(e)),/[^a-z0-9\-#$%&'*+.\^_`|~]/i.test(e))throw new TypeError("Invalid character in header field name");return e.toLowerCase()}function n(e){return"string"!=typeof e&&(e=String(e)),e}function r(e){var t={next:function(){var t=e.shift();return{done:void 0===t,value:t}}};return g.iterable&&(t[Symbol.iterator]=function(){return t}),t}function o(e){this.map={},e instanceof o?e.forEach(function(e,t){this.append(t,e)},this):e&&Object.getOwnPropertyNames(e).forEach(function(t){this.append(t,e[t])},this)}function i(e){return e.bodyUsed?Promise.reject(new TypeError("Already read")):void(e.bodyUsed=!0)}function a(e){return new Promise(function(t,n){e.onload=function(){t(e.result)},e.onerror=function(){n(e.error)}})}function s(e){var t=new FileReader,n=a(t);return t.readAsArrayBuffer(e),n}function u(e){var t=new FileReader,n=a(t);return t.readAsText(e),n}function l(e){for(var t=new Uint8Array(e),n=new Array(t.length),r=0;r<t.length;r++)n[r]=String.fromCharCode(t[r]);return n.join("")}function c(e){if(e.slice)return e.slice(0);var t=new Uint8Array(e.byteLength);return t.set(new Uint8Array(e)),t.buffer}function p(){return this.bodyUsed=!1,this._initBody=function(e){if(this._bodyInit=e,e)if("string"==typeof e)this._bodyText=e;else if(g.blob&&Blob.prototype.isPrototypeOf(e))this._bodyBlob=e;else if(g.formData&&FormData.prototype.isPrototypeOf(e))this._bodyFormData=e;else if(g.searchParams&&URLSearchParams.prototype.isPrototypeOf(e))this._bodyText=e.toString();else if(g.arrayBuffer&&g.blob&&b(e))this._bodyArrayBuffer=c(e.buffer),this._bodyInit=new Blob([this._bodyArrayBuffer]);else{if(!g.arrayBuffer||!ArrayBuffer.prototype.isPrototypeOf(e)&&!C(e))throw new Error("unsupported BodyInit type");this._bodyArrayBuffer=c(e)}else this._bodyText="";this.headers.get("content-type")||("string"==typeof e?this.headers.set("content-type","text/plain;charset=UTF-8"):this._bodyBlob&&this._bodyBlob.type?this.headers.set("content-type",this._bodyBlob.type):g.searchParams&&URLSearchParams.prototype.isPrototypeOf(e)&&this.headers.set("content-type","application/x-www-form-urlencoded;charset=UTF-8"))},g.blob&&(this.blob=function(){var e=i(this);if(e)return e;if(this._bodyBlob)return Promise.resolve(this._bodyBlob);if(this._bodyArrayBuffer)return Promise.resolve(new Blob([this._bodyArrayBuffer]));if(this._bodyFormData)throw new Error("could not read FormData body as blob");return Promise.resolve(new Blob([this._bodyText]))},this.arrayBuffer=function(){return this._bodyArrayBuffer?i(this)||Promise.resolve(this._bodyArrayBuffer):this.blob().then(s)}),this.text=function(){var e=i(this);if(e)return e;if(this._bodyBlob)return u(this._bodyBlob);if(this._bodyArrayBuffer)return Promise.resolve(l(this._bodyArrayBuffer));if(this._bodyFormData)throw new Error("could not read FormData body as text");return Promise.resolve(this._bodyText)},g.formData&&(this.formData=function(){return this.text().then(h)}),this.json=function(){return this.text().then(JSON.parse)},this}function f(e){var t=e.toUpperCase();return _.indexOf(t)>-1?t:e}function d(e,t){t=t||{};var n=t.body;if(e instanceof d){if(e.bodyUsed)throw new TypeError("Already read");this.url=e.url,this.credentials=e.credentials,t.headers||(this.headers=new o(e.headers)),this.method=e.method,this.mode=e.mode,n||null==e._bodyInit||(n=e._bodyInit,e.bodyUsed=!0)}else this.url=String(e);if(this.credentials=t.credentials||this.credentials||"omit",!t.headers&&this.headers||(this.headers=new o(t.headers)),this.method=f(t.method||this.method||"GET"),this.mode=t.mode||this.mode||null,this.referrer=null,("GET"===this.method||"HEAD"===this.method)&&n)throw new TypeError("Body not allowed for GET or HEAD requests");this._initBody(n)}function h(e){var t=new FormData;return e.trim().split("&").forEach(function(e){if(e){var n=e.split("="),r=n.shift().replace(/\+/g," "),o=n.join("=").replace(/\+/g," ");t.append(decodeURIComponent(r),decodeURIComponent(o))}}),t}function v(e){var t=new o;return e.split(/\r?\n/).forEach(function(e){var n=e.split(":"),r=n.shift().trim();if(r){var o=n.join(":").trim();t.append(r,o)}}),t}function m(e,t){t||(t={}),this.type="default",this.status="status"in t?t.status:200,this.ok=this.status>=200&&this.status<300,this.statusText="statusText"in t?t.statusText:"OK",this.headers=new o(t.headers),this.url=t.url||"",this._initBody(e)}if(!e.fetch){var g={searchParams:"URLSearchParams"in e,iterable:"Symbol"in e&&"iterator"in Symbol,blob:"FileReader"in e&&"Blob"in e&&function(){try{return new Blob,!0}catch(e){return!1}}(),formData:"FormData"in e,arrayBuffer:"ArrayBuffer"in e};if(g.arrayBuffer)var y=["[object Int8Array]","[object Uint8Array]","[object Uint8ClampedArray]","[object Int16Array]","[object Uint16Array]","[object Int32Array]","[object Uint32Array]","[object Float32Array]","[object Float64Array]"],b=function(e){return e&&DataView.prototype.isPrototypeOf(e)},C=ArrayBuffer.isView||function(e){return e&&y.indexOf(Object.prototype.toString.call(e))>-1};o.prototype.append=function(e,r){e=t(e),r=n(r);var o=this.map[e];this.map[e]=o?o+","+r:r},o.prototype.delete=function(e){delete this.map[t(e)]},o.prototype.get=function(e){return e=t(e),this.has(e)?this.map[e]:null},o.prototype.has=function(e){return this.map.hasOwnProperty(t(e))},o.prototype.set=function(e,r){this.map[t(e)]=n(r)},o.prototype.forEach=function(e,t){for(var n in this.map)this.map.hasOwnProperty(n)&&e.call(t,this.map[n],n,this)},o.prototype.keys=function(){var e=[];return this.forEach(function(t,n){e.push(n)}),r(e)},o.prototype.values=function(){var e=[];return this.forEach(function(t){e.push(t)}),r(e)},o.prototype.entries=function(){var e=[];return this.forEach(function(t,n){e.push([n,t])}),r(e)},g.iterable&&(o.prototype[Symbol.iterator]=o.prototype.entries);var _=["DELETE","GET","HEAD","OPTIONS","POST","PUT"];d.prototype.clone=function(){return new d(this,{body:this._bodyInit})},p.call(d.prototype),p.call(m.prototype),m.prototype.clone=function(){return new m(this._bodyInit,{status:this.status,statusText:this.statusText,headers:new o(this.headers),url:this.url})},m.error=function(){var e=new m(null,{status:0,statusText:""});return e.type="error",e};var w=[301,302,303,307,308];m.redirect=function(e,t){if(w.indexOf(t)===-1)throw new RangeError("Invalid status code");return new m(null,{status:t,headers:{location:e}})},e.Headers=o,e.Request=d,e.Response=m,e.fetch=function(e,t){return new Promise(function(n,r){var o=new d(e,t),i=new XMLHttpRequest;i.onload=function(){var e={status:i.status,statusText:i.statusText,headers:v(i.getAllResponseHeaders()||"")};e.url="responseURL"in i?i.responseURL:e.headers.get("X-Request-URL");var t="response"in i?i.response:i.responseText;n(new m(t,e))},i.onerror=function(){r(new TypeError("Network request failed"))},i.ontimeout=function(){r(new TypeError("Network request failed"))},i.open(o.method,o.url,!0),"include"===o.credentials&&(i.withCredentials=!0),"responseType"in i&&g.blob&&(i.responseType="blob"),o.headers.forEach(function(e,t){i.setRequestHeader(t,e)}),i.send("undefined"==typeof o._bodyInit?null:o._bodyInit)})},e.fetch.polyfill=!0}}("undefined"!=typeof self?self:this)},function(e,t,n,r){"use strict";var o=n(r),i=(n(1),function(e){var t=this;if(t.instancePool.length){var n=t.instancePool.pop();return t.call(n,e),n}return new t(e)}),a=function(e,t){var n=this;if(n.instancePool.length){var r=n.instancePool.pop();return n.call(r,e,t),r}return new n(e,t)},s=function(e,t,n){var r=this;if(r.instancePool.length){var o=r.instancePool.pop();return r.call(o,e,t,n),o}return new r(e,t,n)},u=function(e,t,n,r){var o=this;if(o.instancePool.length){var i=o.instancePool.pop();return o.call(i,e,t,n,r),i}return new o(e,t,n,r)},l=function(e){var t=this;e instanceof t?void 0:o("25"),e.destructor(),t.instancePool.length<t.poolSize&&t.instancePool.push(e)},c=10,p=i,f=function(e,t){var n=e;return n.instancePool=[],n.getPooled=t||p,n.poolSize||(n.poolSize=c),n.release=l,n},d={addPoolingTo:f,oneArgumentPooler:i,twoArgumentPooler:a,threeArgumentPooler:s,fourArgumentPooler:u};e.exports=d}]));
-//# sourceMappingURL=main.9a04d80a.js.map
\ No newline at end of file
+!function(e){function t(r){if(n[r])return n[r].exports;var o=n[r]={exports:{},id:r,loaded:!1};return e[r].call(o.exports,o,o.exports,t),o.loaded=!0,o.exports}var n={};return t.m=e,t.c=n,t.p="/filterer/",t(0)}(function(e){for(var t in e)if(Object.prototype.hasOwnProperty.call(e,t))switch(typeof e[t]){case"function":break;case"object":e[t]=function(t){var n=t.slice(1),r=e[t[0]];return function(e,t,o){r.apply(this,[e,t,o].concat(n))}}(e[t]);break;default:e[t]=e[e[t]]}return e}([function(e,t,n){n(188),e.exports=n(94)},function(e,t,n){"use strict";function r(e,t,n,r,i,a,s,u){if(o(t),!e){var l;if(void 0===t)l=new Error("Minified exception occurred; use the non-minified dev environment for the full error message and additional helpful warnings.");else{var c=[n,r,i,a,s,u],p=0;l=new Error(t.replace(/%s/g,function(){return c[p++]})),l.name="Invariant Violation"}throw l.framesToPop=1,l}}var o=function(e){};e.exports=r},function(e,t,n){"use strict";var r=n(8),o=r;e.exports=o},function(e,t){"use strict";function n(e){for(var t=arguments.length-1,n="Minified React error #"+e+"; visit http://facebook.github.io/react/docs/error-decoder.html?invariant="+e,r=0;r<t;r++)n+="&args[]="+encodeURIComponent(arguments[r+1]);n+=" for the full message or use the non-minified dev environment for full errors and additional helpful warnings.";var o=new Error(n);throw o.name="Invariant Violation",o.framesToPop=1,o}e.exports=n},function(e,t){"use strict";function n(e){if(null===e||void 0===e)throw new TypeError("Object.assign cannot be called with null or undefined");return Object(e)}function r(){try{if(!Object.assign)return!1;var e=new String("abc");if(e[5]="de","5"===Object.getOwnPropertyNames(e)[0])return!1;for(var t={},n=0;n<10;n++)t["_"+String.fromCharCode(n)]=n;var r=Object.getOwnPropertyNames(t).map(function(e){return t[e]});if("0123456789"!==r.join(""))return!1;var o={};return"abcdefghijklmnopqrst".split("").forEach(function(e){o[e]=e}),"abcdefghijklmnopqrst"===Object.keys(Object.assign({},o)).join("")}catch(e){return!1}}var o=Object.getOwnPropertySymbols,i=Object.prototype.hasOwnProperty,a=Object.prototype.propertyIsEnumerable;e.exports=r()?Object.assign:function(e,t){for(var r,s,u=n(e),l=1;l<arguments.length;l++){r=Object(arguments[l]);for(var c in r)i.call(r,c)&&(u[c]=r[c]);if(o){s=o(r);for(var p=0;p<s.length;p++)a.call(r,s[p])&&(u[s[p]]=r[s[p]])}}return u}},function(e,t,n){"use strict";e.exports=n(20)},function(e,t,n){"use strict";function r(e,t){return 1===e.nodeType&&e.getAttribute(h)===String(t)||8===e.nodeType&&e.nodeValue===" react-text: "+t+" "||8===e.nodeType&&e.nodeValue===" react-empty: "+t+" "}function o(e){for(var t;t=e._renderedComponent;)e=t;return e}function i(e,t){var n=o(e);n._hostNode=t,t[v]=n}function a(e){var t=e._hostNode;t&&(delete t[v],e._hostNode=null)}function s(e,t){if(!(e._flags&m.hasCachedChildNodes)){var n=e._renderedChildren,a=t.firstChild;e:for(var s in n)if(n.hasOwnProperty(s)){var u=n[s],l=o(u)._domID;if(0!==l){for(;null!==a;a=a.nextSibling)if(r(a,l)){i(u,a);continue e}p("32",l)}}e._flags|=m.hasCachedChildNodes}}function u(e){if(e[v])return e[v];for(var t=[];!e[v];){if(t.push(e),!e.parentNode)return null;e=e.parentNode}for(var n,r;e&&(r=e[v]);e=t.pop())n=r,t.length&&s(r,e);return n}function l(e){var t=u(e);return null!=t&&t._hostNode===e?t:null}function c(e){if(void 0===e._hostNode?p("33"):void 0,e._hostNode)return e._hostNode;for(var t=[];!e._hostNode;)t.push(e),e._hostParent?void 0:p("34"),e=e._hostParent;for(;t.length;e=t.pop())s(e,e._hostNode);return e._hostNode}var p=n(3),f=n(18),d=n(67),h=(n(1),f.ID_ATTRIBUTE_NAME),m=d,v="__reactInternalInstance$"+Math.random().toString(36).slice(2),g={getClosestInstanceFromNode:u,getInstanceFromNode:l,getNodeFromInstance:c,precacheChildNodes:s,precacheNode:i,uncacheNode:a};e.exports=g},function(e,t){"use strict";var n=!("undefined"==typeof window||!window.document||!window.document.createElement),r={canUseDOM:n,canUseWorkers:"undefined"!=typeof Worker,canUseEventListeners:n&&!(!window.addEventListener&&!window.attachEvent),canUseViewport:n&&!!window.screen,isInWorker:!n};e.exports=r},function(e,t){"use strict";function n(e){return function(){return e}}var r=function(){};r.thatReturns=n,r.thatReturnsFalse=n(!1),r.thatReturnsTrue=n(!0),r.thatReturnsNull=n(null),r.thatReturnsThis=function(){return this},r.thatReturnsArgument=function(e){return e},e.exports=r},function(e,t,n){"use strict";var r=null;e.exports={debugTool:r}},function(e,t,n){"use strict";function r(){P.ReactReconcileTransaction&&_?void 0:c("123")}function o(){this.reinitializeTransaction(),this.dirtyComponentsLength=null,this.callbackQueue=f.getPooled(),this.reconcileTransaction=P.ReactReconcileTransaction.getPooled(!0)}function i(e,t,n,o,i,a){return r(),_.batchedUpdates(e,t,n,o,i,a)}function a(e,t){return e._mountOrder-t._mountOrder}function s(e){var t=e.dirtyComponentsLength;t!==g.length?c("124",t,g.length):void 0,g.sort(a),y++;for(var n=0;n<t;n++){var r=g[n],o=r._pendingCallbacks;r._pendingCallbacks=null;var i;if(h.logTopLevelRenders){var s=r;r._currentElement.type.isReactTopLevelWrapper&&(s=r._renderedComponent),i="React update: "+s.getName(),console.time(i)}if(m.performUpdateIfNecessary(r,e.reconcileTransaction,y),i&&console.timeEnd(i),o)for(var u=0;u<o.length;u++)e.callbackQueue.enqueue(o[u],r.getPublicInstance())}}function u(e){return r(),_.isBatchingUpdates?(g.push(e),void(null==e._updateBatchNumber&&(e._updateBatchNumber=y+1))):void _.batchedUpdates(u,e)}function l(e,t){_.isBatchingUpdates?void 0:c("125"),b.enqueue(e,t),C=!0}var c=n(3),p=n(4),f=n(65),d=n(14),h=n(70),m=n(19),v=n(31),g=(n(1),[]),y=0,b=f.getPooled(),C=!1,_=null,w={initialize:function(){this.dirtyComponentsLength=g.length},close:function(){this.dirtyComponentsLength!==g.length?(g.splice(0,this.dirtyComponentsLength),x()):g.length=0}},E={initialize:function(){this.callbackQueue.reset()},close:function(){this.callbackQueue.notifyAll()}},T=[w,E];p(o.prototype,v,{getTransactionWrappers:function(){return T},destructor:function(){this.dirtyComponentsLength=null,f.release(this.callbackQueue),this.callbackQueue=null,P.ReactReconcileTransaction.release(this.reconcileTransaction),this.reconcileTransaction=null},perform:function(e,t,n){return v.perform.call(this,this.reconcileTransaction.perform,this.reconcileTransaction,e,t,n)}}),d.addPoolingTo(o);var x=function(){for(;g.length||C;){if(g.length){var e=o.getPooled();e.perform(s,null,e),o.release(e)}if(C){C=!1;var t=b;b=f.getPooled(),t.notifyAll(),f.release(t)}}},O={injectReconcileTransaction:function(e){e?void 0:c("126"),P.ReactReconcileTransaction=e},injectBatchingStrategy:function(e){e?void 0:c("127"),"function"!=typeof e.batchedUpdates?c("128"):void 0,"boolean"!=typeof e.isBatchingUpdates?c("129"):void 0,_=e}},P={ReactReconcileTransaction:null,batchedUpdates:i,enqueueUpdate:u,flushBatchedUpdates:x,injection:O,asap:l};e.exports=P},function(e,t,n){"use strict";function r(e,t,n,r){this.dispatchConfig=e,this._targetInst=t,this.nativeEvent=n;var o=this.constructor.Interface;for(var i in o)if(o.hasOwnProperty(i)){var s=o[i];s?this[i]=s(n):"target"===i?this.target=r:this[i]=n[i]}var u=null!=n.defaultPrevented?n.defaultPrevented:n.returnValue===!1;return u?this.isDefaultPrevented=a.thatReturnsTrue:this.isDefaultPrevented=a.thatReturnsFalse,this.isPropagationStopped=a.thatReturnsFalse,this}var o=n(4),i=n(14),a=n(8),s=(n(2),"function"==typeof Proxy,["dispatchConfig","_targetInst","nativeEvent","isDefaultPrevented","isPropagationStopped","_dispatchListeners","_dispatchInstances"]),u={type:null,target:null,currentTarget:a.thatReturnsNull,eventPhase:null,bubbles:null,cancelable:null,timeStamp:function(e){return e.timeStamp||Date.now()},defaultPrevented:null,isTrusted:null};o(r.prototype,{preventDefault:function(){this.defaultPrevented=!0;var e=this.nativeEvent;e&&(e.preventDefault?e.preventDefault():"unknown"!=typeof e.returnValue&&(e.returnValue=!1),this.isDefaultPrevented=a.thatReturnsTrue)},stopPropagation:function(){var e=this.nativeEvent;e&&(e.stopPropagation?e.stopPropagation():"unknown"!=typeof e.cancelBubble&&(e.cancelBubble=!0),this.isPropagationStopped=a.thatReturnsTrue)},persist:function(){this.isPersistent=a.thatReturnsTrue},isPersistent:a.thatReturnsFalse,destructor:function(){var e=this.constructor.Interface;for(var t in e)this[t]=null;for(var n=0;n<s.length;n++)this[s[n]]=null}}),r.Interface=u,r.augmentClass=function(e,t){var n=this,r=function(){};r.prototype=n.prototype;var a=new r;o(a,e.prototype),e.prototype=a,e.prototype.constructor=e,e.Interface=o({},n.Interface,t),e.augmentClass=n.augmentClass,i.addPoolingTo(e,i.fourArgumentPooler)},i.addPoolingTo(r,i.fourArgumentPooler),e.exports=r},function(e,t){"use strict";var n={current:null};e.exports=n},function(e,t,n){"use strict";e.exports=n(138)},[228,3],[227,189,190,192,193,191],function(e,t,n){(function(){function t(e,t){var n,r=function(o){return e.length>1?function(){var i=o?o.concat():[];return n=t?n||this:this,i.push.apply(i,arguments)<e.length&&arguments.length?r.call(n,i):e.apply(n,i)}:e};return r()}function r(e,t){var n={}.hasOwnProperty;for(var r in t)n.call(t,r)&&(e[r]=t[r]);return e}var o,i,a,s,u,l,c,p,f,d,h,m,v,g,y,b,C,_,w,E,T,x,O,P,k,S,N=[].slice,M={}.toString;o=n(118),i=o.all,a=o.any,s=o.concatMap,u=o.each,l=o.filter,c=o.find,p=o.isType,f=o.keys,d=o.map,h=o.Obj,m=o.objToPairs,v=o.partition,g=o.reverse,y=o.sortBy,b=t(function(e,t,n){return Math.max(t,Math.min(n,e))}),C=t(function(e,t,n){var r;return r=e.substr(n).indexOf(t),r===-1?[]:[n+r].concat(C(e,t,n+r+t.length))}),_=t(function(e,t){var n,r,o;return n=t[0],r=N.call(t,1),0===r.length?null!=(o=e[n])?o:null:"undefined"==typeof e[n]?null:_(e[n],r)}),w=function(e){var t;return t=function(e){return e.length}(f(h.filter(function(e){return!!e})(e))),0===t},E=t(function(e,t){return M.call(e).slice(8,-1)===M.call(t).slice(8,-1)&&(a(function(t){return p(t,e)})(["Boolean","Number","String","undefined"])?e===t:"Array"===M.call(e).slice(8,-1)?e.length===t.length&&i(function(n){return E(e[n],t[n])})(function(){var t,n,r=[];for(t=0,n=e.length;t<n;++t)r.push(t);return r}()):f(e).length===f(t).length&&i(function(n){return E(e[n],t[n])})(f(e)))}),T=t(function(e,t){var n,r,o,i,a,s;return 0===t.length?[[0,e.length]]:(n=C(e,t,0),r=n[0],o=n[n.length-1],0===n.length?[]:(i=o+t.length,a=d(function(e){return[e,e+t.length,!0]})(n),s=d(function(e){return[a[e][1],a[e+1][0],!1]})(function(){var e,t,n=[];for(e=0,t=a.length-1;e<t;++e)n.push(e);return n}()),(0===r?[]:[[0,r,!1]]).concat(y(function(e){return e[0]})(a.concat(s)),i===e.length?[]:[[i,e.length,!1]])))}),x=t(function(e,t,n,r){var o;return o=_(e,t),P(e,t,o?r(o,n):n)}),O=t(function(e,t){var n,o;return n=M.call(t).slice(8,-1),a(function(e){return e===n},["Boolean","Number","String","Function"])?t:null===e||"Undefined"===M.call(e).slice(8,-1)?t:(o=h.keys(t),0===o.length?e:(u(function(n){return e[n]=O(h.keys(e[n]).length>0?r({},e[n]):e[n],t[n])})(o),e))}),P=t(function(e,t,n){var r,o,i;return r=t[0],o=N.call(t,1),o.length>0?(e[r]=null!=(i=e[r])?i:{},P(e[r],o,n)):(e[r]=n,e)}),k=function(e){return d(function(t){return d(function(e){return e[t]})(e)})(f(e[0]))},S=t(function(e,n,r){var o;return(o=t(function(e,t,n,r,i){return s(function(i){var a,s;return a=i[0],s=i[1],n<r?o(e,t.concat(a),n+1,r,s):e(t.concat(a),s)})(m(i))}))(e,[],0,n,r)}),e.exports={clamp:b,findAll:C,get:_,isEmptyObject:w,isEqualToObject:E,mappend:x,partitionString:T,rextend:O,set:P,transpose:k,unwrap:S}}).call(this)},function(e,t,n){"use strict";function r(e){if(v){var t=e.node,n=e.children;if(n.length)for(var r=0;r<n.length;r++)g(t,n[r],null);else null!=e.html?p(t,e.html):null!=e.text&&d(t,e.text)}}function o(e,t){e.parentNode.replaceChild(t.node,e),r(t)}function i(e,t){v?e.children.push(t):e.node.appendChild(t.node)}function a(e,t){v?e.html=t:p(e.node,t)}function s(e,t){v?e.text=t:d(e.node,t)}function u(){return this.node.nodeName}function l(e){return{node:e,children:[],html:null,text:null,toString:u}}var c=n(38),p=n(33),f=n(46),d=n(82),h=1,m=11,v="undefined"!=typeof document&&"number"==typeof document.documentMode||"undefined"!=typeof navigator&&"string"==typeof navigator.userAgent&&/\bEdge\/\d/.test(navigator.userAgent),g=f(function(e,t,n){t.node.nodeType===m||t.node.nodeType===h&&"object"===t.node.nodeName.toLowerCase()&&(null==t.node.namespaceURI||t.node.namespaceURI===c.html)?(r(t),e.insertBefore(t.node,n)):(e.insertBefore(t.node,n),r(t))});l.insertTreeBefore=g,l.replaceChildWithTree=o,l.queueChild=i,l.queueHTML=a,l.queueText=s,e.exports=l},function(e,t,n){"use strict";function r(e,t){return(e&t)===t}var o=n(3),i=(n(1),{MUST_USE_PROPERTY:1,HAS_BOOLEAN_VALUE:4,HAS_NUMERIC_VALUE:8,HAS_POSITIVE_NUMERIC_VALUE:24,HAS_OVERLOADED_BOOLEAN_VALUE:32,injectDOMPropertyConfig:function(e){var t=i,n=e.Properties||{},a=e.DOMAttributeNamespaces||{},u=e.DOMAttributeNames||{},l=e.DOMPropertyNames||{},c=e.DOMMutationMethods||{};e.isCustomAttribute&&s._isCustomAttributeFunctions.push(e.isCustomAttribute);for(var p in n){s.properties.hasOwnProperty(p)?o("48",p):void 0;var f=p.toLowerCase(),d=n[p],h={attributeName:f,attributeNamespace:null,propertyName:p,mutationMethod:null,mustUseProperty:r(d,t.MUST_USE_PROPERTY),hasBooleanValue:r(d,t.HAS_BOOLEAN_VALUE),hasNumericValue:r(d,t.HAS_NUMERIC_VALUE),hasPositiveNumericValue:r(d,t.HAS_POSITIVE_NUMERIC_VALUE),hasOverloadedBooleanValue:r(d,t.HAS_OVERLOADED_BOOLEAN_VALUE)};if(h.hasBooleanValue+h.hasNumericValue+h.hasOverloadedBooleanValue<=1?void 0:o("50",p),u.hasOwnProperty(p)){var m=u[p];h.attributeName=m}a.hasOwnProperty(p)&&(h.attributeNamespace=a[p]),l.hasOwnProperty(p)&&(h.propertyName=l[p]),c.hasOwnProperty(p)&&(h.mutationMethod=c[p]),s.properties[p]=h}}}),a=":A-Z_a-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD",s={ID_ATTRIBUTE_NAME:"data-reactid",ROOT_ATTRIBUTE_NAME:"data-reactroot",ATTRIBUTE_NAME_START_CHAR:a,ATTRIBUTE_NAME_CHAR:a+"\\-.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040",properties:{},getPossibleStandardName:null,_isCustomAttributeFunctions:[],isCustomAttribute:function(e){for(var t=0;t<s._isCustomAttributeFunctions.length;t++){var n=s._isCustomAttributeFunctions[t];if(n(e))return!0}return!1},injection:i};e.exports=s},function(e,t,n){"use strict";function r(){o.attachRefs(this,this._currentElement)}var o=n(161),i=(n(9),n(2),{mountComponent:function(e,t,n,o,i,a){var s=e.mountComponent(t,n,o,i,a);return e._currentElement&&null!=e._currentElement.ref&&t.getReactMountReady().enqueue(r,e),s},getHostNode:function(e){return e.getHostNode()},unmountComponent:function(e,t){o.detachRefs(e,e._currentElement),e.unmountComponent(t)},receiveComponent:function(e,t,n,i){var a=e._currentElement;if(t!==a||i!==e._context){var s=o.shouldUpdateRefs(a,t);s&&o.detachRefs(e,a),e.receiveComponent(t,n,i),s&&e._currentElement&&null!=e._currentElement.ref&&n.getReactMountReady().enqueue(r,e)}},performUpdateIfNecessary:function(e,t,n){e._updateBatchNumber===n&&e.performUpdateIfNecessary(t)}});e.exports=i},function(e,t,n){"use strict";var r=n(4),o=n(213),i=n(54),a=n(218),s=n(214),u=n(215),l=n(21),c=n(217),p=n(219),f=n(222),d=(n(2),l.createElement),h=l.createFactory,m=l.cloneElement,v=r,g={Children:{map:o.map,forEach:o.forEach,count:o.count,toArray:o.toArray,only:f},Component:i,PureComponent:a,createElement:d,cloneElement:m,isValidElement:l.isValidElement,PropTypes:c,createClass:s.createClass,createFactory:h,createMixin:function(e){return e},DOM:u,version:p,__spread:v};e.exports=g},function(e,t,n){"use strict";function r(e){return void 0!==e.ref}function o(e){return void 0!==e.key}var i=n(4),a=n(12),s=(n(2),n(89),Object.prototype.hasOwnProperty),u=n(88),l={key:!0,ref:!0,__self:!0,__source:!0},c=function(e,t,n,r,o,i,a){var s={$$typeof:u,type:e,key:t,ref:n,props:a,_owner:i};return s};c.createElement=function(e,t,n){var i,u={},p=null,f=null,d=null,h=null;if(null!=t){r(t)&&(f=t.ref),o(t)&&(p=""+t.key),d=void 0===t.__self?null:t.__self,h=void 0===t.__source?null:t.__source;for(i in t)s.call(t,i)&&!l.hasOwnProperty(i)&&(u[i]=t[i])}var m=arguments.length-2;if(1===m)u.children=n;else if(m>1){for(var v=Array(m),g=0;g<m;g++)v[g]=arguments[g+2];u.children=v}if(e&&e.defaultProps){var y=e.defaultProps;for(i in y)void 0===u[i]&&(u[i]=y[i])}return c(e,p,f,d,h,a.current,u)},c.createFactory=function(e){var t=c.createElement.bind(null,e);return t.type=e,t},c.cloneAndReplaceKey=function(e,t){var n=c(e.type,t,e.ref,e._self,e._source,e._owner,e.props);return n},c.cloneElement=function(e,t,n){var u,p=i({},e.props),f=e.key,d=e.ref,h=e._self,m=e._source,v=e._owner;if(null!=t){r(t)&&(d=t.ref,v=a.current),o(t)&&(f=""+t.key);var g;e.type&&e.type.defaultProps&&(g=e.type.defaultProps);for(u in t)s.call(t,u)&&!l.hasOwnProperty(u)&&(void 0===t[u]&&void 0!==g?p[u]=g[u]:p[u]=t[u])}var y=arguments.length-2;if(1===y)p.children=n;else if(y>1){for(var b=Array(y),C=0;C<y;C++)b[C]=arguments[C+2];p.children=b}return c(e.type,f,d,h,m,v,p)},c.isValidElement=function(e){return"object"==typeof e&&null!==e&&e.$$typeof===u},e.exports=c},3,function(e,t,n){"use strict";var r={};e.exports=r},function(e,t,n){"use strict";function r(e){return"button"===e||"input"===e||"select"===e||"textarea"===e}function o(e,t,n){switch(e){case"onClick":case"onClickCapture":case"onDoubleClick":case"onDoubleClickCapture":case"onMouseDown":case"onMouseDownCapture":case"onMouseMove":case"onMouseMoveCapture":case"onMouseUp":case"onMouseUpCapture":return!(!n.disabled||!r(t));default:return!1}}var i=n(3),a=n(39),s=n(40),u=n(44),l=n(76),c=n(77),p=(n(1),{}),f=null,d=function(e,t){e&&(s.executeDispatchesInOrder(e,t),e.isPersistent()||e.constructor.release(e))},h=function(e){return d(e,!0)},m=function(e){return d(e,!1)},v=function(e){return"."+e._rootNodeID},g={injection:{injectEventPluginOrder:a.injectEventPluginOrder,injectEventPluginsByName:a.injectEventPluginsByName},putListener:function(e,t,n){"function"!=typeof n?i("94",t,typeof n):void 0;var r=v(e),o=p[t]||(p[t]={});o[r]=n;var s=a.registrationNameModules[t];s&&s.didPutListener&&s.didPutListener(e,t,n)},getListener:function(e,t){var n=p[t];if(o(t,e._currentElement.type,e._currentElement.props))return null;var r=v(e);return n&&n[r]},deleteListener:function(e,t){var n=a.registrationNameModules[t];n&&n.willDeleteListener&&n.willDeleteListener(e,t);var r=p[t];if(r){var o=v(e);delete r[o]}},deleteAllListeners:function(e){var t=v(e);for(var n in p)if(p.hasOwnProperty(n)&&p[n][t]){var r=a.registrationNameModules[n];r&&r.willDeleteListener&&r.willDeleteListener(e,n),delete p[n][t]}},extractEvents:function(e,t,n,r){for(var o,i=a.plugins,s=0;s<i.length;s++){var u=i[s];if(u){var c=u.extractEvents(e,t,n,r);c&&(o=l(o,c))}}return o},enqueueEvents:function(e){e&&(f=l(f,e))},processEventQueue:function(e){var t=f;f=null,e?c(t,h):c(t,m),f?i("95"):void 0,u.rethrowCaughtError()},__purge:function(){p={}},__getListenerBank:function(){return p}};e.exports=g},function(e,t,n){"use strict";function r(e,t,n){var r=t.dispatchConfig.phasedRegistrationNames[n];return g(e,r)}function o(e,t,n){var o=r(e,n,t);o&&(n._dispatchListeners=m(n._dispatchListeners,o),n._dispatchInstances=m(n._dispatchInstances,e))}function i(e){e&&e.dispatchConfig.phasedRegistrationNames&&h.traverseTwoPhase(e._targetInst,o,e)}function a(e){if(e&&e.dispatchConfig.phasedRegistrationNames){var t=e._targetInst,n=t?h.getParentInstance(t):null;h.traverseTwoPhase(n,o,e)}}function s(e,t,n){if(n&&n.dispatchConfig.registrationName){var r=n.dispatchConfig.registrationName,o=g(e,r);o&&(n._dispatchListeners=m(n._dispatchListeners,o),n._dispatchInstances=m(n._dispatchInstances,e))}}function u(e){e&&e.dispatchConfig.registrationName&&s(e._targetInst,null,e)}function l(e){v(e,i)}function c(e){v(e,a)}function p(e,t,n,r){h.traverseEnterLeave(n,r,s,e,t)}function f(e){v(e,u)}var d=n(24),h=n(40),m=n(76),v=n(77),g=(n(2),d.getListener),y={accumulateTwoPhaseDispatches:l,accumulateTwoPhaseDispatchesSkipTarget:c,accumulateDirectDispatches:f,accumulateEnterLeaveDispatches:p};e.exports=y},function(e,t){"use strict";var n={remove:function(e){e._reactInternalInstance=void 0},get:function(e){return e._reactInternalInstance},has:function(e){return void 0!==e._reactInternalInstance},set:function(e,t){e._reactInternalInstance=t}};e.exports=n},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(11),i=n(49),a={view:function(e){if(e.view)return e.view;var t=i(e);if(t.window===t)return t;var n=t.ownerDocument;return n?n.defaultView||n.parentWindow:window},detail:function(e){return e.detail||0}};o.augmentClass(r,a),e.exports=r},function(e,t,n){(function(){var e,r,o,i,a,s,u,l="undefined"!=typeof t&&t||this;e=n(15),r=e.filter,o=e.map,i=e.objToPairs,a=e.Str,l.cancelEvent=s=function(e){e.preventDefault(),e.stopPropagation()},l.classNameFromObject=u=function(e){return a.join(" ")(o(function(e){return e[0]})(r(function(e){return!!e[1]})(i(e))))}}).call(this)},function(e,t,n){"use strict";function r(e){return Object.prototype.hasOwnProperty.call(e,m)||(e[m]=d++,p[e[m]]={}),p[e[m]]}var o,i=n(4),a=n(39),s=n(153),u=n(75),l=n(185),c=n(50),p={},f=!1,d=0,h={topAbort:"abort",topAnimationEnd:l("animationend")||"animationend",topAnimationIteration:l("animationiteration")||"animationiteration",topAnimationStart:l("animationstart")||"animationstart",topBlur:"blur",topCanPlay:"canplay",topCanPlayThrough:"canplaythrough",topChange:"change",topClick:"click",topCompositionEnd:"compositionend",topCompositionStart:"compositionstart",topCompositionUpdate:"compositionupdate",topContextMenu:"contextmenu",topCopy:"copy",topCut:"cut",topDoubleClick:"dblclick",topDrag:"drag",topDragEnd:"dragend",topDragEnter:"dragenter",topDragExit:"dragexit",topDragLeave:"dragleave",topDragOver:"dragover",topDragStart:"dragstart",topDrop:"drop",topDurationChange:"durationchange",topEmptied:"emptied",topEncrypted:"encrypted",topEnded:"ended",topError:"error",topFocus:"focus",topInput:"input",topKeyDown:"keydown",topKeyPress:"keypress",topKeyUp:"keyup",topLoadedData:"loadeddata",topLoadedMetadata:"loadedmetadata",topLoadStart:"loadstart",topMouseDown:"mousedown",topMouseMove:"mousemove",topMouseOut:"mouseout",topMouseOver:"mouseover",topMouseUp:"mouseup",topPaste:"paste",topPause:"pause",topPlay:"play",topPlaying:"playing",topProgress:"progress",topRateChange:"ratechange",topScroll:"scroll",topSeeked:"seeked",topSeeking:"seeking",topSelectionChange:"selectionchange",topStalled:"stalled",topSuspend:"suspend",topTextInput:"textInput",topTimeUpdate:"timeupdate",topTouchCancel:"touchcancel",topTouchEnd:"touchend",topTouchMove:"touchmove",topTouchStart:"touchstart",topTransitionEnd:l("transitionend")||"transitionend",topVolumeChange:"volumechange",topWaiting:"waiting",topWheel:"wheel"},m="_reactListenersID"+String(Math.random()).slice(2),v=i({},s,{ReactEventListener:null,injection:{injectReactEventListener:function(e){e.setHandleTopLevel(v.handleTopLevel),v.ReactEventListener=e}},setEnabled:function(e){v.ReactEventListener&&v.ReactEventListener.setEnabled(e)},isEnabled:function(){return!(!v.ReactEventListener||!v.ReactEventListener.isEnabled())},listenTo:function(e,t){for(var n=t,o=r(n),i=a.registrationNameDependencies[e],s=0;s<i.length;s++){var u=i[s];o.hasOwnProperty(u)&&o[u]||("topWheel"===u?c("wheel")?v.ReactEventListener.trapBubbledEvent("topWheel","wheel",n):c("mousewheel")?v.ReactEventListener.trapBubbledEvent("topWheel","mousewheel",n):v.ReactEventListener.trapBubbledEvent("topWheel","DOMMouseScroll",n):"topScroll"===u?c("scroll",!0)?v.ReactEventListener.trapCapturedEvent("topScroll","scroll",n):v.ReactEventListener.trapBubbledEvent("topScroll","scroll",v.ReactEventListener.WINDOW_HANDLE):"topFocus"===u||"topBlur"===u?(c("focus",!0)?(v.ReactEventListener.trapCapturedEvent("topFocus","focus",n),v.ReactEventListener.trapCapturedEvent("topBlur","blur",n)):c("focusin")&&(v.ReactEventListener.trapBubbledEvent("topFocus","focusin",n),v.ReactEventListener.trapBubbledEvent("topBlur","focusout",n)),o.topBlur=!0,o.topFocus=!0):h.hasOwnProperty(u)&&v.ReactEventListener.trapBubbledEvent(u,h[u],n),o[u]=!0)}},trapBubbledEvent:function(e,t,n){return v.ReactEventListener.trapBubbledEvent(e,t,n)},trapCapturedEvent:function(e,t,n){return v.ReactEventListener.trapCapturedEvent(e,t,n)},supportsEventPageXY:function(){if(!document.createEvent)return!1;var e=document.createEvent("MouseEvent");return null!=e&&"pageX"in e},ensureScrollValueMonitoring:function(){if(void 0===o&&(o=v.supportsEventPageXY()),!o&&!f){var e=u.refreshScrollValues;v.ReactEventListener.monitorScrollValue(e),f=!0}}});e.exports=v},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(27),i=n(75),a=n(48),s={screenX:null,screenY:null,clientX:null,clientY:null,ctrlKey:null,shiftKey:null,altKey:null,metaKey:null,getModifierState:a,button:function(e){var t=e.button;return"which"in e?t:2===t?2:4===t?1:0},buttons:null,relatedTarget:function(e){return e.relatedTarget||(e.fromElement===e.srcElement?e.toElement:e.fromElement)},pageX:function(e){return"pageX"in e?e.pageX:e.clientX+i.currentScrollLeft},pageY:function(e){return"pageY"in e?e.pageY:e.clientY+i.currentScrollTop}};o.augmentClass(r,s),e.exports=r},function(e,t,n){"use strict";var r=n(3),o=(n(1),{}),i={reinitializeTransaction:function(){this.transactionWrappers=this.getTransactionWrappers(),this.wrapperInitData?this.wrapperInitData.length=0:this.wrapperInitData=[],this._isInTransaction=!1},_isInTransaction:!1,getTransactionWrappers:null,isInTransaction:function(){return!!this._isInTransaction},perform:function(e,t,n,o,i,a,s,u){this.isInTransaction()?r("27"):void 0;var l,c;try{this._isInTransaction=!0,l=!0,this.initializeAll(0),c=e.call(t,n,o,i,a,s,u),l=!1}finally{try{if(l)try{this.closeAll(0)}catch(e){}else this.closeAll(0)}finally{this._isInTransaction=!1}}return c},initializeAll:function(e){for(var t=this.transactionWrappers,n=e;n<t.length;n++){var r=t[n];try{this.wrapperInitData[n]=o,this.wrapperInitData[n]=r.initialize?r.initialize.call(this):null}finally{if(this.wrapperInitData[n]===o)try{this.initializeAll(n+1)}catch(e){}}}},closeAll:function(e){this.isInTransaction()?void 0:r("28");for(var t=this.transactionWrappers,n=e;n<t.length;n++){var i,a=t[n],s=this.wrapperInitData[n];try{i=!0,s!==o&&a.close&&a.close.call(this,s),i=!1}finally{if(i)try{this.closeAll(n+1)}catch(e){}}}this.wrapperInitData.length=0}};e.exports=i},function(e,t){"use strict";function n(e){var t=""+e,n=o.exec(t);if(!n)return t;var r,i="",a=0,s=0;for(a=n.index;a<t.length;a++){switch(t.charCodeAt(a)){case 34:r="&quot;";break;case 38:r="&amp;";break;case 39:r="&#x27;";break;case 60:r="&lt;";break;case 62:r="&gt;";break;default:continue}s!==a&&(i+=t.substring(s,a)),s=a+1,i+=r}return s!==a?i+t.substring(s,a):i}function r(e){return"boolean"==typeof e||"number"==typeof e?""+e:n(e)}var o=/["'&<>]/;e.exports=r},function(e,t,n){"use strict";var r,o=n(7),i=n(38),a=/^[ \r\n\t\f]/,s=/<(!--|link|noscript|meta|script|style)[ \r\n\t\f\/>]/,u=n(46),l=u(function(e,t){if(e.namespaceURI!==i.svg||"innerHTML"in e)e.innerHTML=t;else{r=r||document.createElement("div"),r.innerHTML="<svg>"+t+"</svg>";for(var n=r.firstChild;n.firstChild;)e.appendChild(n.firstChild)}});if(o.canUseDOM){var c=document.createElement("div");c.innerHTML=" ",""===c.innerHTML&&(l=function(e,t){if(e.parentNode&&e.parentNode.replaceChild(e,e),a.test(t)||"<"===t[0]&&s.test(t)){e.innerHTML=String.fromCharCode(65279)+t;var n=e.firstChild;1===n.data.length?e.removeChild(n):n.deleteData(0,1)}else e.innerHTML=t}),c=null}e.exports=l},function(e,t,n){e.exports=n(208)()},function(e,t){function n(e){return e&&e.__esModule?e:{default:e}}e.exports=n,e.exports.__esModule=!0,e.exports.default=e.exports},function(e,t){"use strict";function n(e,t){return e===t?0!==e||0!==t||1/e===1/t:e!==e&&t!==t}function r(e,t){if(n(e,t))return!0;if("object"!=typeof e||null===e||"object"!=typeof t||null===t)return!1;var r=Object.keys(e),i=Object.keys(t);if(r.length!==i.length)return!1;for(var a=0;a<r.length;a++)if(!o.call(t,r[a])||!n(e[r[a]],t[r[a]]))return!1;return!0}var o=Object.prototype.hasOwnProperty;e.exports=r},function(e,t,n){"use strict";function r(e,t){return Array.isArray(t)&&(t=t[1]),t?t.nextSibling:e.firstChild}function o(e,t,n){c.insertTreeBefore(e,t,n)}function i(e,t,n){Array.isArray(t)?s(e,t[0],t[1],n):m(e,t,n)}function a(e,t){if(Array.isArray(t)){var n=t[1];t=t[0],u(e,t,n),e.removeChild(n)}e.removeChild(t)}function s(e,t,n,r){for(var o=t;;){var i=o.nextSibling;if(m(e,o,r),o===n)break;o=i}}function u(e,t,n){for(;;){var r=t.nextSibling;if(r===n)break;e.removeChild(r)}}function l(e,t,n){var r=e.parentNode,o=e.nextSibling;o===t?n&&m(r,document.createTextNode(n),o):n?(h(o,n),u(r,o,t)):u(r,e,t)}var c=n(17),p=n(130),f=(n(6),n(9),n(46)),d=n(33),h=n(82),m=f(function(e,t,n){e.insertBefore(t,n)}),v=p.dangerouslyReplaceNodeWithMarkup,g={dangerouslyReplaceNodeWithMarkup:v,replaceDelimitedText:l,processUpdates:function(e,t){for(var n=0;n<t.length;n++){var s=t[n];switch(s.type){case"INSERT_MARKUP":o(e,s.content,r(e,s.afterNode));break;case"MOVE_EXISTING":i(e,s.fromNode,r(e,s.afterNode));break;case"SET_MARKUP":d(e,s.content);break;case"TEXT_CONTENT":h(e,s.content);break;case"REMOVE_NODE":a(e,s.fromNode)}}}};e.exports=g},function(e,t){"use strict";var n={html:"http://www.w3.org/1999/xhtml",mathml:"http://www.w3.org/1998/Math/MathML",svg:"http://www.w3.org/2000/svg"};e.exports=n},function(e,t,n){"use strict";function r(){if(s)for(var e in u){var t=u[e],n=s.indexOf(e);if(n>-1?void 0:a("96",e),!l.plugins[n]){t.extractEvents?void 0:a("97",e),l.plugins[n]=t;var r=t.eventTypes;for(var i in r)o(r[i],t,i)?void 0:a("98",i,e)}}}function o(e,t,n){l.eventNameDispatchConfigs.hasOwnProperty(n)?a("99",n):void 0,l.eventNameDispatchConfigs[n]=e;var r=e.phasedRegistrationNames;if(r){for(var o in r)if(r.hasOwnProperty(o)){var s=r[o];i(s,t,n)}return!0}return!!e.registrationName&&(i(e.registrationName,t,n),!0)}function i(e,t,n){l.registrationNameModules[e]?a("100",e):void 0,l.registrationNameModules[e]=t,l.registrationNameDependencies[e]=t.eventTypes[n].dependencies}var a=n(3),s=(n(1),null),u={},l={plugins:[],eventNameDispatchConfigs:{},registrationNameModules:{},registrationNameDependencies:{},possibleRegistrationNames:null,injectEventPluginOrder:function(e){s?a("101"):void 0,s=Array.prototype.slice.call(e),r()},injectEventPluginsByName:function(e){var t=!1;for(var n in e)if(e.hasOwnProperty(n)){var o=e[n];u.hasOwnProperty(n)&&u[n]===o||(u[n]?a("102",n):void 0,u[n]=o,t=!0)}t&&r()},getPluginModuleForEvent:function(e){var t=e.dispatchConfig;if(t.registrationName)return l.registrationNameModules[t.registrationName]||null;if(void 0!==t.phasedRegistrationNames){var n=t.phasedRegistrationNames;for(var r in n)if(n.hasOwnProperty(r)){var o=l.registrationNameModules[n[r]];if(o)return o}}return null},_resetEventPlugins:function(){s=null;for(var e in u)u.hasOwnProperty(e)&&delete u[e];l.plugins.length=0;var t=l.eventNameDispatchConfigs;for(var n in t)t.hasOwnProperty(n)&&delete t[n];var r=l.registrationNameModules;for(var o in r)r.hasOwnProperty(o)&&delete r[o]}};e.exports=l},function(e,t,n){"use strict";function r(e){return"topMouseUp"===e||"topTouchEnd"===e||"topTouchCancel"===e}function o(e){return"topMouseMove"===e||"topTouchMove"===e}function i(e){return"topMouseDown"===e||"topTouchStart"===e}function a(e,t,n,r){var o=e.type||"unknown-event";e.currentTarget=g.getNodeFromInstance(r),t?m.invokeGuardedCallbackWithCatch(o,n,e):m.invokeGuardedCallback(o,n,e),e.currentTarget=null}function s(e,t){var n=e._dispatchListeners,r=e._dispatchInstances;if(Array.isArray(n))for(var o=0;o<n.length&&!e.isPropagationStopped();o++)a(e,t,n[o],r[o]);else n&&a(e,t,n,r);e._dispatchListeners=null,e._dispatchInstances=null}function u(e){var t=e._dispatchListeners,n=e._dispatchInstances;if(Array.isArray(t)){for(var r=0;r<t.length&&!e.isPropagationStopped();r++)if(t[r](e,n[r]))return n[r]}else if(t&&t(e,n))return n;return null}function l(e){var t=u(e);return e._dispatchInstances=null,e._dispatchListeners=null,
+t}function c(e){var t=e._dispatchListeners,n=e._dispatchInstances;Array.isArray(t)?h("103"):void 0,e.currentTarget=t?g.getNodeFromInstance(n):null;var r=t?t(e):null;return e.currentTarget=null,e._dispatchListeners=null,e._dispatchInstances=null,r}function p(e){return!!e._dispatchListeners}var f,d,h=n(3),m=n(44),v=(n(1),n(2),{injectComponentTree:function(e){f=e},injectTreeTraversal:function(e){d=e}}),g={isEndish:r,isMoveish:o,isStartish:i,executeDirectDispatch:c,executeDispatchesInOrder:s,executeDispatchesInOrderStopAtTrue:l,hasDispatches:p,getInstanceFromNode:function(e){return f.getInstanceFromNode(e)},getNodeFromInstance:function(e){return f.getNodeFromInstance(e)},isAncestor:function(e,t){return d.isAncestor(e,t)},getLowestCommonAncestor:function(e,t){return d.getLowestCommonAncestor(e,t)},getParentInstance:function(e){return d.getParentInstance(e)},traverseTwoPhase:function(e,t,n){return d.traverseTwoPhase(e,t,n)},traverseEnterLeave:function(e,t,n,r,o){return d.traverseEnterLeave(e,t,n,r,o)},injection:v};e.exports=g},function(e,t){"use strict";function n(e){var t=/[=:]/g,n={"=":"=0",":":"=2"},r=(""+e).replace(t,function(e){return n[e]});return"$"+r}function r(e){var t=/(=0|=2)/g,n={"=0":"=","=2":":"},r="."===e[0]&&"$"===e[1]?e.substring(2):e.substring(1);return(""+r).replace(t,function(e){return n[e]})}var o={escape:n,unescape:r};e.exports=o},function(e,t,n){"use strict";function r(e){null!=e.checkedLink&&null!=e.valueLink?s("87"):void 0}function o(e){r(e),null!=e.value||null!=e.onChange?s("88"):void 0}function i(e){r(e),null!=e.checked||null!=e.onChange?s("89"):void 0}function a(e){if(e){var t=e.getName();if(t)return" Check the render method of `"+t+"`."}return""}var s=n(3),u=n(159),l=n(62),c=n(20),p=l(c.isValidElement),f=(n(1),n(2),{button:!0,checkbox:!0,image:!0,hidden:!0,radio:!0,reset:!0,submit:!0}),d={value:function(e,t,n){return!e[t]||f[e.type]||e.onChange||e.readOnly||e.disabled?null:new Error("You provided a `value` prop to a form field without an `onChange` handler. This will render a read-only field. If the field should be mutable use `defaultValue`. Otherwise, set either `onChange` or `readOnly`.")},checked:function(e,t,n){return!e[t]||e.onChange||e.readOnly||e.disabled?null:new Error("You provided a `checked` prop to a form field without an `onChange` handler. This will render a read-only field. If the field should be mutable use `defaultChecked`. Otherwise, set either `onChange` or `readOnly`.")},onChange:p.func},h={},m={checkPropTypes:function(e,t,n){for(var r in d){if(d.hasOwnProperty(r))var o=d[r](t,r,e,"prop",null,u);if(o instanceof Error&&!(o.message in h)){h[o.message]=!0;a(n)}}},getValue:function(e){return e.valueLink?(o(e),e.valueLink.value):e.value},getChecked:function(e){return e.checkedLink?(i(e),e.checkedLink.value):e.checked},executeOnChange:function(e,t){return e.valueLink?(o(e),e.valueLink.requestChange(t.target.value)):e.checkedLink?(i(e),e.checkedLink.requestChange(t.target.checked)):e.onChange?e.onChange.call(void 0,t):void 0}};e.exports=m},function(e,t,n){"use strict";var r=n(3),o=(n(1),!1),i={replaceNodeWithMarkup:null,processChildrenUpdates:null,injection:{injectEnvironment:function(e){o?r("104"):void 0,i.replaceNodeWithMarkup=e.replaceNodeWithMarkup,i.processChildrenUpdates=e.processChildrenUpdates,o=!0}}};e.exports=i},function(e,t,n){"use strict";function r(e,t,n){try{t(n)}catch(e){null===o&&(o=e)}}var o=null,i={invokeGuardedCallback:r,invokeGuardedCallbackWithCatch:r,rethrowCaughtError:function(){if(o){var e=o;throw o=null,e}}};e.exports=i},function(e,t,n){"use strict";function r(e){u.enqueueUpdate(e)}function o(e){var t=typeof e;if("object"!==t)return t;var n=e.constructor&&e.constructor.name||t,r=Object.keys(e);return r.length>0&&r.length<20?n+" (keys: "+r.join(", ")+")":n}function i(e,t){var n=s.get(e);if(!n){return null}return n}var a=n(3),s=(n(12),n(26)),u=(n(9),n(10)),l=(n(1),n(2),{isMounted:function(e){var t=s.get(e);return!!t&&!!t._renderedComponent},enqueueCallback:function(e,t,n){l.validateCallback(t,n);var o=i(e);return o?(o._pendingCallbacks?o._pendingCallbacks.push(t):o._pendingCallbacks=[t],void r(o)):null},enqueueCallbackInternal:function(e,t){e._pendingCallbacks?e._pendingCallbacks.push(t):e._pendingCallbacks=[t],r(e)},enqueueForceUpdate:function(e){var t=i(e,"forceUpdate");t&&(t._pendingForceUpdate=!0,r(t))},enqueueReplaceState:function(e,t,n){var o=i(e,"replaceState");o&&(o._pendingStateQueue=[t],o._pendingReplaceState=!0,void 0!==n&&null!==n&&(l.validateCallback(n,"replaceState"),o._pendingCallbacks?o._pendingCallbacks.push(n):o._pendingCallbacks=[n]),r(o))},enqueueSetState:function(e,t){var n=i(e,"setState");if(n){var o=n._pendingStateQueue||(n._pendingStateQueue=[]);o.push(t),r(n)}},enqueueElementInternal:function(e,t,n){e._pendingElement=t,e._context=n,r(e)},validateCallback:function(e,t){e&&"function"!=typeof e?a("122",t,o(e)):void 0}});e.exports=l},function(e,t){"use strict";var n=function(e){return"undefined"!=typeof MSApp&&MSApp.execUnsafeLocalFunction?function(t,n,r,o){MSApp.execUnsafeLocalFunction(function(){return e(t,n,r,o)})}:e};e.exports=n},function(e,t){"use strict";function n(e){var t,n=e.keyCode;return"charCode"in e?(t=e.charCode,0===t&&13===n&&(t=13)):t=n,t>=32||13===t?t:0}e.exports=n},function(e,t){"use strict";function n(e){var t=this,n=t.nativeEvent;if(n.getModifierState)return n.getModifierState(e);var r=o[e];return!!r&&!!n[r]}function r(e){return n}var o={Alt:"altKey",Control:"ctrlKey",Meta:"metaKey",Shift:"shiftKey"};e.exports=r},function(e,t){"use strict";function n(e){var t=e.target||e.srcElement||window;return t.correspondingUseElement&&(t=t.correspondingUseElement),3===t.nodeType?t.parentNode:t}e.exports=n},function(e,t,n){"use strict";function r(e,t){if(!i.canUseDOM||t&&!("addEventListener"in document))return!1;var n="on"+e,r=n in document;if(!r){var a=document.createElement("div");a.setAttribute(n,"return;"),r="function"==typeof a[n]}return!r&&o&&"wheel"===e&&(r=document.implementation.hasFeature("Events.wheel","3.0")),r}var o,i=n(7);i.canUseDOM&&(o=document.implementation&&document.implementation.hasFeature&&document.implementation.hasFeature("","")!==!0),e.exports=r},function(e,t){"use strict";function n(e,t){var n=null===e||e===!1,r=null===t||t===!1;if(n||r)return n===r;var o=typeof e,i=typeof t;return"string"===o||"number"===o?"string"===i||"number"===i:"object"===i&&e.type===t.type&&e.key===t.key}e.exports=n},function(e,t,n){"use strict";var r=(n(4),n(8)),o=(n(2),r);e.exports=o},function(e,t,n){(function(){function t(e,t){var n={}.hasOwnProperty;for(var r in t)n.call(t,r)&&(e[r]=t[r]);return e}function r(e,t){for(var n=-1,r=t.length>>>0;++n<r;)if(e===t[n])return!0;return!1}var o,i,a,s,u,l,c,p,f,d,h,m,v,g,y,b,C,_,w,E,T,x,O,P,k,S,N,M,A,I,D,R,L,U,F,j,B;o=n(15),i=o.each,a=o.filter,s=o.find,u=o.findIndex,l=o.id,c=o.initial,p=o.last,f=o.map,d=o.objToPairs,h=o.partition,m=o.reject,v=o.reverse,g=o.Str,y=o.sortBy,b=o.sum,C=o.values,o=n(16),_=o.clamp,w=o.isEqualToObject,E=n(5),o=E.DOM,T=o.div,x=o.input,O=o.path,P=o.span,k=o.svg,S=E.createClass,N=E.createFactory,M=n(13).findDOMNode,A=N(n(63)),I=N(n(202)),D=N(n(195)),R=N(n(84)),L=N(n(203)),U=N(n(199)),F=N(n(200)),o=n(28),j=o.cancelEvent,B=o.classNameFromObject,e.exports=S({displayName:"ReactSelectize",focusLock:!1,getDefaultProps:function(){return{anchor:null,autofocus:!1,cancelKeyboardEventOnSelection:!0,delimiters:[],disabled:!1,dropdownDirection:1,firstOptionIndexToHighlight:function(e){return 0},groupId:function(e){return e.groupId},groupsAsColumns:!1,highlightedUid:void 0,inputProps:{},onAnchorChange:function(e){},onBlur:function(e){},onEnter:function(e){},onFocus:function(e){},onHighlightedUidChange:function(e,t){},onKeyboardSelectionFailed:function(e){},onOpenChange:function(e,t){},onPaste:function(e){},onScrollLockChange:function(e){},onSearchChange:function(e,t){},onValuesChange:function(e,t){},open:!1,hideResetButton:!1,renderValue:function(e){var t;return t=e.label,T({className:"simple-value"},P(null,t))},renderToggleButton:I,renderResetButton:U,scrollLock:!1,search:"",style:{},theme:"default",uid:l,values:[]}},render:function(){var e,n,r,o,i,a=this;return e=function(){var e;switch(!1){case!("undefined"==typeof this.props.anchor||null===this.props.anchor):return-1;default:return null!=(e=u(function(e){return a.isEqualToObject(e,a.props.anchor)},this.props.values))?e:this.props.values.length-1}}.call(this),n=function(e){return f(function(e){var t,n;return t=a.props.values[e],n=a.props.uid(t),L({key:a.uidToString(n),uid:n,item:t,renderItem:a.props.renderValue})})(e)},r=this.props.dropdownDirection===-1,T({className:B((o={"react-selectize":1},o[this.props.theme+""]=1,o["root-node"]=1,o[this.props.className+""]=1,o.disabled=this.props.disabled,o.open=this.props.open,o.flipped=r,o.tethered=this.props.tether,o)),style:this.props.style},this.props.name?x({type:"hidden",name:this.props.name,value:this.props.serialize(this.props.values)}):void 0,T({className:"react-selectize-control",ref:"control",onMouseDown:function(e){if(function(){return a.props.onAnchorChange(p(a.props.values),function(){return a.onOpenChange(!0,function(){return a.highlightAndFocus()})})}(),!a.props.open)return j(e)}},0===this.props.search.length&&0===this.props.values.length?T({className:"react-selectize-placeholder"},this.props.placeholder):void 0,T({className:"react-selectize-search-field-and-selected-values"},n(function(){var t,n,r=[];for(t=0,n=e;t<=n;++t)r.push(t);return r}()),F((o=t({disabled:this.props.disabled},this.props.inputProps),o.ref="search",o.type="text",o.value=this.props.search,o.onChange=function(e){var t;return t=e.currentTarget.value,a.props.onSearchChange(t,function(){return a.highlightAndScrollToSelectableOption(a.props.firstOptionIndexToHighlight(a.props.options),1)})},o.onFocus=function(e){!function(){return function(e){return a.focusLock?e(a.focusLock=!1):a.onOpenChange(!0,function(){return e(!0)})}}()(function(){return a.props.onFocus(e)})},o.onBlur=function(e){if(!a.refs.dropdownMenu||document.activeElement!==M(a.refs.dropdownMenu))return a.closeDropdown(function(){return a.props.onBlur(e)})},o.onPaste=this.props.onPaste,o.onKeyDown=function(t){return a.handleKeydown({anchorIndex:e},t)},o)),n(function(){var t,n,r=[];for(t=e+1,n=this.props.values.length;t<n;++t)r.push(t);return r}.call(this))),this.props.values.length>0&&!this.props.hideResetButton?T({className:"react-selectize-reset-button-container",onClick:function(e){return function(){return a.props.onValuesChange([],function(){return a.props.onSearchChange("",function(){return a.highlightAndFocus()})})}(),j(e)}},this.props.renderResetButton()):void 0,T({className:"react-selectize-toggle-button-container",onMouseDown:function(e){return a.props.open?a.onOpenChange(!1,function(){}):a.props.onAnchorChange(p(a.props.values),function(){return a.onOpenChange(!0,function(){})}),j(e)}},this.props.renderToggleButton({open:this.props.open,flipped:r}))),D((o=t({},this.props),o.ref="dropdownMenu",o.className=B((i={"react-selectize":1},i[this.props.className+""]=1,i)),o.theme=this.props.theme,o.scrollLock=this.props.scrollLock,o.onScrollChange=this.props.onScrollChange,o.bottomAnchor=function(){return M(a.refs.control)},o.tetherProps=(i=t({},this.props.tetherProps),i.target=function(){return M(a.refs.control)},i),o.highlightedUid=this.props.highlightedUid,o.onHighlightedUidChange=this.props.onHighlightedUidChange,o.onOptionClick=function(t){a.selectHighlightedUid(e,function(){})},o)))},handleKeydown:function(e,t){var n,o,i,a=this;switch(n=e.anchorIndex,t.persist(),t.which){case 8:if(this.props.search.length>0||n===-1)return;!function(){var e,t,r,o;return e=n,t=n-1<0?void 0:a.props.values[n-1],r=a.props.values[n],a.props.onValuesChange(null!=(o=m(function(e){return a.isEqualToObject(e,r)})(a.props.values))?o:[],function(){return function(){return function(e){return"undefined"==typeof s(function(e){return a.isEqualToObject(e,r)},a.props.values)?a.props.restoreOnBackspace?a.props.onSearchChange(a.props.restoreOnBackspace(r),function(){return e(!0)}):e(!0):e(!1)}}()(function(r){if(r&&(a.highlightAndScrollToSelectableOption(a.props.firstOptionIndexToHighlight(a.props.options),1),n===e&&("undefined"==typeof t||s(function(e){return a.isEqualToObject(e,t)})(a.props.values))))return a.props.onAnchorChange(t,function(){})})})}(),j(t);break;case 27:!function(){return a.props.open?function(e){return a.onOpenChange(!1,e)}:function(e){return a.props.onValuesChange([],e)}}()(function(){return a.props.onSearchChange("",function(){return a.focusOnInput()})})}if(this.props.open&&r(t.which,[13].concat(this.props.delimiters))&&!(null!=t&&t.metaKey||null!=t&&t.ctrlKey||null!=t&&t.shiftKey)&&(o=this.selectHighlightedUid(n,function(e){if("undefined"==typeof e)return a.props.onKeyboardSelectionFailed(t.which)}),o&&this.props.cancelKeyboardEventOnSelection))return j(t);if(0===this.props.search.length)switch(t.which){case 37:this.props.onAnchorChange(n-1<0||t.metaKey?void 0:this.props.values[_(n-1,0,this.props.values.length-1)],function(){});break;case 39:this.props.onAnchorChange(t.metaKey?p(this.props.values):this.props.values[_(n+1,0,this.props.values.length-1)],function(){})}switch(t.which){case 38:return this.props.onScrollLockChange(!0),i=function(){switch(!1){case"undefined"!=typeof this.props.highlightedUid:return 0;default:return-1+this.optionIndexFromUid(this.props.highlightedUid)}}.call(this),this.highlightAndScrollToSelectableOption(i,-1,function(e){if(!e)return a.highlightAndScrollToSelectableOption(a.props.options.length-1,-1)});case 40:return this.props.onScrollLockChange(!0),i=function(){switch(!1){case"undefined"!=typeof this.props.highlightedUid:return 0;default:return 1+this.optionIndexFromUid(this.props.highlightedUid)}}.call(this),this.highlightAndScrollToSelectableOption(i,1,function(e){if(!e)return a.highlightAndScrollToSelectableOption(0,1)})}},componentDidMount:function(){this.props.autofocus&&this.focus(),this.props.open&&this.highlightAndFocus()},componentDidUpdate:function(e){this.props.open&&!e.open&&void 0===this.props.highlightedUid&&this.highlightAndFocus(),!this.props.open&&e.open&&this.props.onHighlightedUidChange(void 0,function(){})},componentWillReceiveProps:function(e){"undefined"!=typeof this.props.disabled&&this.props.disabled!==!1||"undefined"==typeof e.disabled||e.disabled!==!0||this.onOpenChange(!1,function(){})},optionIndexFromUid:function(e){var t=this;return u(function(n){return w(e,t.props.uid(n))})(this.props.options)},closeDropdown:function(e){var t=this;this.onOpenChange(!1,function(){return t.props.onAnchorChange(p(t.props.values),e)})},blur:function(){this.refs.search.blur()},focus:function(){this.refs.search.focus()},focusOnInput:function(){var e;e=M(this.refs.search),e!==document.activeElement&&(this.focusLock=!0,e.focus(),e.value=e.value)},highlightAndFocus:function(){this.highlightAndScrollToSelectableOption(this.props.firstOptionIndexToHighlight(this.props.options),1),this.focusOnInput()},highlightAndScrollToOption:function(e,t){null==t&&(t=function(){}),this.refs.dropdownMenu.highlightAndScrollToOption(e,t)},highlightAndScrollToSelectableOption:function(e,t,n){var r=this;null==n&&(n=function(){}),function(){return r.props.open?function(e){return e()}:function(e){return r.onOpenChange(!0,e)}}()(function(){return r.refs.dropdownMenu.highlightAndScrollToSelectableOption(e,t,n)})},isEqualToObject:function(){return w(this.props.uid(arguments[0]),this.props.uid(arguments[1]))},onOpenChange:function(e,t){return this.props.onOpenChange(!this.props.disabled&&e,t)},selectHighlightedUid:function(e,t){var n,r,o=this;return void 0===this.props.highlightedUid?(t(),!1):(n=this.optionIndexFromUid(this.props.highlightedUid),"number"!=typeof n?(t(),!1):(r=this.props.options[n],function(){return o.props.onValuesChange(f(function(e){return o.props.values[e]},function(){var t,n,r=[];for(t=0,n=e;t<=n;++t)r.push(t);return r}()).concat([r],f(function(e){return o.props.values[e]},function(){var t,n,r=[];for(t=e+1,n=this.props.values.length;t<n;++t)r.push(t);return r}.call(o))),function(){var e;return e=s(function(e){return o.isEqualToObject(e,r)},o.props.values),e?o.props.onSearchChange("",function(){return o.props.onAnchorChange(e,function(){return o.props.open?o.highlightAndScrollToSelectableOption(n,1,function(n){return n?void t(e):o.highlightAndScrollToSelectableOption(o.props.firstOptionIndexToHighlight(o.props.options),1,function(n){return n?t(e):o.onOpenChange(!1,function(){return t(e)})})}):void t(e)})}):void t()})}(),!0))},uidToString:function(e){return("object"==typeof e?JSON.stringify:l)(e)}})}).call(this)},function(e,t,n){"use strict";function r(e,t,n){this.props=e,this.context=t,this.refs=a,this.updater=n||i}var o=n(22),i=n(55),a=(n(89),n(23));n(1),n(2);r.prototype.isReactComponent={},r.prototype.setState=function(e,t){"object"!=typeof e&&"function"!=typeof e&&null!=e?o("85"):void 0,this.updater.enqueueSetState(this,e),t&&this.updater.enqueueCallback(this,t,"setState")},r.prototype.forceUpdate=function(e){this.updater.enqueueForceUpdate(this),e&&this.updater.enqueueCallback(this,e,"forceUpdate")};e.exports=r},function(e,t,n){"use strict";function r(e,t){}var o=(n(2),{isMounted:function(e){return!1},enqueueCallback:function(e,t){},enqueueForceUpdate:function(e){r(e,"forceUpdate")},enqueueReplaceState:function(e,t){r(e,"replaceState")},enqueueSetState:function(e,t){r(e,"setState")}});e.exports=o},function(e,t){"use strict";t.__esModule=!0,t.default=void 0;var n=!("undefined"==typeof window||!window.document||!window.document.createElement);t.default=n,e.exports=t.default},function(e,t,n){"use strict";var r=n(8),o={listen:function(e,t,n){return e.addEventListener?(e.addEventListener(t,n,!1),{remove:function(){e.removeEventListener(t,n,!1)}}):e.attachEvent?(e.attachEvent("on"+t,n),{remove:function(){e.detachEvent("on"+t,n)}}):void 0},capture:function(e,t,n){return e.addEventListener?(e.addEventListener(t,n,!0),{remove:function(){e.removeEventListener(t,n,!0)}}):{remove:r}},registerDefault:function(){}};e.exports=o},function(e,t){"use strict";function n(e){try{e.focus()}catch(e){}}e.exports=n},function(e,t){"use strict";function n(e){if(e=e||("undefined"!=typeof document?document:void 0),"undefined"==typeof e)return null;try{return e.activeElement||e.body}catch(t){return e.body}}e.exports=n},function(e,t){function n(){throw new Error("setTimeout has not been defined")}function r(){throw new Error("clearTimeout has not been defined")}function o(e){if(c===setTimeout)return setTimeout(e,0);if((c===n||!c)&&setTimeout)return c=setTimeout,setTimeout(e,0);try{return c(e,0)}catch(t){try{return c.call(null,e,0)}catch(t){return c.call(this,e,0)}}}function i(e){if(p===clearTimeout)return clearTimeout(e);if((p===r||!p)&&clearTimeout)return p=clearTimeout,clearTimeout(e);try{return p(e)}catch(t){try{return p.call(null,e)}catch(t){return p.call(this,e)}}}function a(){m&&d&&(m=!1,d.length?h=d.concat(h):v=-1,h.length&&s())}function s(){if(!m){var e=o(a);m=!0;for(var t=h.length;t;){for(d=h,h=[];++v<t;)d&&d[v].run();v=-1,t=h.length}d=null,m=!1,i(e)}}function u(e,t){this.fun=e,this.array=t}function l(){}var c,p,f=e.exports={};!function(){try{c="function"==typeof setTimeout?setTimeout:n}catch(e){c=n}try{p="function"==typeof clearTimeout?clearTimeout:r}catch(e){p=r}}();var d,h=[],m=!1,v=-1;f.nextTick=function(e){var t=new Array(arguments.length-1);if(arguments.length>1)for(var n=1;n<arguments.length;n++)t[n-1]=arguments[n];h.push(new u(e,t)),1!==h.length||m||o(s)},u.prototype.run=function(){this.fun.apply(null,this.array)},f.title="browser",f.browser=!0,f.env={},f.argv=[],f.version="",f.versions={},f.on=l,f.addListener=l,f.once=l,f.off=l,f.removeListener=l,f.removeAllListeners=l,f.emit=l,f.prependListener=l,f.prependOnceListener=l,f.listeners=function(e){return[]},f.binding=function(e){throw new Error("process.binding is not supported")},f.cwd=function(){return"/"},f.chdir=function(e){throw new Error("process.chdir is not supported")},f.umask=function(){return 0}},function(e,t,n){"use strict";function r(){}function o(e){try{return e.then}catch(e){return g=e,y}}function i(e,t){try{return e(t)}catch(e){return g=e,y}}function a(e,t,n){try{e(t,n)}catch(e){return g=e,y}}function s(e){if("object"!=typeof this)throw new TypeError("Promises must be constructed via new");if("function"!=typeof e)throw new TypeError("not a function");this._45=0,this._81=0,this._65=null,this._54=null,e!==r&&m(e,this)}function u(e,t,n){return new e.constructor(function(o,i){var a=new s(r);a.then(o,i),l(e,new h(t,n,a))})}function l(e,t){for(;3===e._81;)e=e._65;return s._10&&s._10(e),0===e._81?0===e._45?(e._45=1,void(e._54=t)):1===e._45?(e._45=2,void(e._54=[e._54,t])):void e._54.push(t):void c(e,t)}function c(e,t){v(function(){var n=1===e._81?t.onFulfilled:t.onRejected;if(null===n)return void(1===e._81?p(t.promise,e._65):f(t.promise,e._65));var r=i(n,e._65);r===y?f(t.promise,g):p(t.promise,r)})}function p(e,t){if(t===e)return f(e,new TypeError("A promise cannot be resolved with itself."));if(t&&("object"==typeof t||"function"==typeof t)){var n=o(t);if(n===y)return f(e,g);if(n===e.then&&t instanceof s)return e._81=3,e._65=t,void d(e);if("function"==typeof n)return void m(n.bind(t),e)}e._81=1,e._65=t,d(e)}function f(e,t){e._81=2,e._65=t,s._97&&s._97(e,t),d(e)}function d(e){if(1===e._45&&(l(e,e._54),e._54=null),2===e._45){for(var t=0;t<e._54.length;t++)l(e,e._54[t]);e._54=null}}function h(e,t,n){this.onFulfilled="function"==typeof e?e:null,this.onRejected="function"==typeof t?t:null,this.promise=n}function m(e,t){var n=!1,r=a(e,function(e){n||(n=!0,p(t,e))},function(e){n||(n=!0,f(t,e))});n||r!==y||(n=!0,f(t,g))}var v=n(90),g=null,y={};e.exports=s,s._10=null,s._97=null,s._61=r,s.prototype.then=function(e,t){if(this.constructor!==s)return u(this,e,t);var n=new s(r);return l(this,new h(e,t,n)),n}},function(e,t,n){"use strict";var r=n(122);e.exports=function(e){var t=!1;return r(e,t)}},function(e,t,n){"use strict";e.exports=n(205)},function(e,t){"use strict";function n(e,t){return e+t.charAt(0).toUpperCase()+t.substring(1)}var r={animationIterationCount:!0,borderImageOutset:!0,borderImageSlice:!0,borderImageWidth:!0,boxFlex:!0,boxFlexGroup:!0,boxOrdinalGroup:!0,columnCount:!0,flex:!0,flexGrow:!0,flexPositive:!0,flexShrink:!0,flexNegative:!0,flexOrder:!0,gridRow:!0,gridColumn:!0,fontWeight:!0,lineClamp:!0,lineHeight:!0,opacity:!0,order:!0,orphans:!0,tabSize:!0,widows:!0,zIndex:!0,zoom:!0,fillOpacity:!0,floodOpacity:!0,stopOpacity:!0,strokeDasharray:!0,strokeDashoffset:!0,strokeMiterlimit:!0,strokeOpacity:!0,strokeWidth:!0},o=["Webkit","ms","Moz","O"];Object.keys(r).forEach(function(e){o.forEach(function(t){r[n(t,e)]=r[e]})});var i={background:{backgroundAttachment:!0,backgroundColor:!0,backgroundImage:!0,backgroundPositionX:!0,backgroundPositionY:!0,backgroundRepeat:!0},backgroundPosition:{backgroundPositionX:!0,backgroundPositionY:!0},border:{borderWidth:!0,borderStyle:!0,borderColor:!0},borderBottom:{borderBottomWidth:!0,borderBottomStyle:!0,borderBottomColor:!0},borderLeft:{borderLeftWidth:!0,borderLeftStyle:!0,borderLeftColor:!0},borderRight:{borderRightWidth:!0,borderRightStyle:!0,borderRightColor:!0},borderTop:{borderTopWidth:!0,borderTopStyle:!0,borderTopColor:!0},font:{fontStyle:!0,fontVariant:!0,fontWeight:!0,fontSize:!0,lineHeight:!0,fontFamily:!0},outline:{outlineWidth:!0,outlineStyle:!0,outlineColor:!0}},a={isUnitlessNumber:r,shorthandPropertyExpansions:i};e.exports=a},function(e,t,n){"use strict";function r(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}var o=n(3),i=n(14),a=(n(1),function(){function e(t){r(this,e),this._callbacks=null,this._contexts=null,this._arg=t}return e.prototype.enqueue=function(e,t){this._callbacks=this._callbacks||[],this._callbacks.push(e),this._contexts=this._contexts||[],this._contexts.push(t)},e.prototype.notifyAll=function(){var e=this._callbacks,t=this._contexts,n=this._arg;if(e&&t){e.length!==t.length?o("24"):void 0,this._callbacks=null,this._contexts=null;for(var r=0;r<e.length;r++)e[r].call(t[r],n);e.length=0,t.length=0}},e.prototype.checkpoint=function(){return this._callbacks?this._callbacks.length:0},e.prototype.rollback=function(e){this._callbacks&&this._contexts&&(this._callbacks.length=e,this._contexts.length=e)},e.prototype.reset=function(){this._callbacks=null,this._contexts=null},e.prototype.destructor=function(){this.reset()},e}());e.exports=i.addPoolingTo(a)},function(e,t,n){"use strict";function r(e){return!!l.hasOwnProperty(e)||!u.hasOwnProperty(e)&&(s.test(e)?(l[e]=!0,!0):(u[e]=!0,!1))}function o(e,t){return null==t||e.hasBooleanValue&&!t||e.hasNumericValue&&isNaN(t)||e.hasPositiveNumericValue&&t<1||e.hasOverloadedBooleanValue&&t===!1}var i=n(18),a=(n(6),n(9),n(186)),s=(n(2),new RegExp("^["+i.ATTRIBUTE_NAME_START_CHAR+"]["+i.ATTRIBUTE_NAME_CHAR+"]*$")),u={},l={},c={createMarkupForID:function(e){return i.ID_ATTRIBUTE_NAME+"="+a(e)},setAttributeForID:function(e,t){e.setAttribute(i.ID_ATTRIBUTE_NAME,t)},createMarkupForRoot:function(){return i.ROOT_ATTRIBUTE_NAME+'=""'},setAttributeForRoot:function(e){e.setAttribute(i.ROOT_ATTRIBUTE_NAME,"")},createMarkupForProperty:function(e,t){var n=i.properties.hasOwnProperty(e)?i.properties[e]:null;if(n){if(o(n,t))return"";var r=n.attributeName;return n.hasBooleanValue||n.hasOverloadedBooleanValue&&t===!0?r+'=""':r+"="+a(t)}return i.isCustomAttribute(e)?null==t?"":e+"="+a(t):null},createMarkupForCustomAttribute:function(e,t){return r(e)&&null!=t?e+"="+a(t):""},setValueForProperty:function(e,t,n){var r=i.properties.hasOwnProperty(t)?i.properties[t]:null;if(r){var a=r.mutationMethod;if(a)a(e,n);else{if(o(r,n))return void this.deleteValueForProperty(e,t);if(r.mustUseProperty)e[r.propertyName]=n;else{var s=r.attributeName,u=r.attributeNamespace;u?e.setAttributeNS(u,s,""+n):r.hasBooleanValue||r.hasOverloadedBooleanValue&&n===!0?e.setAttribute(s,""):e.setAttribute(s,""+n)}}}else if(i.isCustomAttribute(t))return void c.setValueForAttribute(e,t,n)},setValueForAttribute:function(e,t,n){if(r(t)){null==n?e.removeAttribute(t):e.setAttribute(t,""+n)}},deleteValueForAttribute:function(e,t){e.removeAttribute(t)},deleteValueForProperty:function(e,t){var n=i.properties.hasOwnProperty(t)?i.properties[t]:null;if(n){var r=n.mutationMethod;if(r)r(e,void 0);else if(n.mustUseProperty){var o=n.propertyName;n.hasBooleanValue?e[o]=!1:e[o]=""}else e.removeAttribute(n.attributeName)}else i.isCustomAttribute(t)&&e.removeAttribute(t)}};e.exports=c},function(e,t){"use strict";var n={hasCachedChildNodes:1};e.exports=n},function(e,t,n){"use strict";function r(){if(this._rootNodeID&&this._wrapperState.pendingUpdate){this._wrapperState.pendingUpdate=!1;var e=this._currentElement.props,t=s.getValue(e);null!=t&&o(this,Boolean(e.multiple),t)}}function o(e,t,n){var r,o,i=u.getNodeFromInstance(e).options;if(t){for(r={},o=0;o<n.length;o++)r[""+n[o]]=!0;for(o=0;o<i.length;o++){var a=r.hasOwnProperty(i[o].value);i[o].selected!==a&&(i[o].selected=a)}}else{for(r=""+n,o=0;o<i.length;o++)if(i[o].value===r)return void(i[o].selected=!0);i.length&&(i[0].selected=!0)}}function i(e){var t=this._currentElement.props,n=s.executeOnChange(t,e);return this._rootNodeID&&(this._wrapperState.pendingUpdate=!0),l.asap(r,this),n}var a=n(4),s=n(42),u=n(6),l=n(10),c=(n(2),!1),p={getHostProps:function(e,t){return a({},t,{onChange:e._wrapperState.onChange,value:void 0})},mountWrapper:function(e,t){var n=s.getValue(t);e._wrapperState={pendingUpdate:!1,initialValue:null!=n?n:t.defaultValue,listeners:null,onChange:i.bind(e),wasMultiple:Boolean(t.multiple)},void 0===t.value||void 0===t.defaultValue||c||(c=!0)},getSelectValueContext:function(e){return e._wrapperState.initialValue},postUpdateWrapper:function(e){var t=e._currentElement.props;e._wrapperState.initialValue=void 0;var n=e._wrapperState.wasMultiple;e._wrapperState.wasMultiple=Boolean(t.multiple);var r=s.getValue(t);null!=r?(e._wrapperState.pendingUpdate=!1,o(e,Boolean(t.multiple),r)):n!==Boolean(t.multiple)&&(null!=t.defaultValue?o(e,Boolean(t.multiple),t.defaultValue):o(e,Boolean(t.multiple),t.multiple?[]:""))}};e.exports=p},function(e,t){"use strict";var n,r={injectEmptyComponentFactory:function(e){n=e}},o={create:function(e){return n(e)}};o.injection=r,e.exports=o},function(e,t){"use strict";var n={logTopLevelRenders:!1};e.exports=n},function(e,t,n){"use strict";function r(e){return s?void 0:a("111",e.type),new s(e)}function o(e){return new u(e)}function i(e){return e instanceof u}var a=n(3),s=(n(1),null),u=null,l={injectGenericComponentClass:function(e){s=e},injectTextComponentClass:function(e){u=e}},c={createInternalComponent:r,createInstanceForText:o,isTextComponent:i,injection:l};e.exports=c},function(e,t,n){"use strict";function r(e){return i(document.documentElement,e)}var o=n(146),i=n(103),a=n(58),s=n(59),u={hasSelectionCapabilities:function(e){var t=e&&e.nodeName&&e.nodeName.toLowerCase();return t&&("input"===t&&"text"===e.type||"textarea"===t||"true"===e.contentEditable)},getSelectionInformation:function(){var e=s();return{focusedElem:e,selectionRange:u.hasSelectionCapabilities(e)?u.getSelection(e):null}},restoreSelection:function(e){var t=s(),n=e.focusedElem,o=e.selectionRange;t!==n&&r(n)&&(u.hasSelectionCapabilities(n)&&u.setSelection(n,o),a(n))},getSelection:function(e){var t;if("selectionStart"in e)t={start:e.selectionStart,end:e.selectionEnd};else if(document.selection&&e.nodeName&&"input"===e.nodeName.toLowerCase()){var n=document.selection.createRange();n.parentElement()===e&&(t={start:-n.moveStart("character",-e.value.length),end:-n.moveEnd("character",-e.value.length)})}else t=o.getOffsets(e);return t||{start:0,end:0}},setSelection:function(e,t){var n=t.start,r=t.end;if(void 0===r&&(r=n),"selectionStart"in e)e.selectionStart=n,e.selectionEnd=Math.min(r,e.value.length);else if(document.selection&&e.nodeName&&"input"===e.nodeName.toLowerCase()){var i=e.createTextRange();i.collapse(!0),i.moveStart("character",n),i.moveEnd("character",r-n),i.select()}else o.setOffsets(e,t)}};e.exports=u},function(e,t,n){"use strict";function r(e,t){for(var n=Math.min(e.length,t.length),r=0;r<n;r++)if(e.charAt(r)!==t.charAt(r))return r;return e.length===t.length?-1:n}function o(e){return e?e.nodeType===D?e.documentElement:e.firstChild:null}function i(e){return e.getAttribute&&e.getAttribute(M)||""}function a(e,t,n,r,o){var i;if(_.logTopLevelRenders){var a=e._currentElement.props.child,s=a.type;i="React mount: "+("string"==typeof s?s:s.displayName||s.name),console.time(i)}var u=T.mountComponent(e,n,null,b(e,t),o,0);i&&console.timeEnd(i),e._renderedComponent._topLevelWrapper=e,j._mountImageIntoNode(u,t,e,r,n)}function s(e,t,n,r){var o=O.ReactReconcileTransaction.getPooled(!n&&C.useCreateElement);o.perform(a,null,e,t,o,n,r),O.ReactReconcileTransaction.release(o)}function u(e,t,n){for(T.unmountComponent(e,n),t.nodeType===D&&(t=t.documentElement);t.lastChild;)t.removeChild(t.lastChild)}function l(e){var t=o(e);if(t){var n=y.getInstanceFromNode(t);return!(!n||!n._hostParent)}}function c(e){return!(!e||e.nodeType!==I&&e.nodeType!==D&&e.nodeType!==R)}function p(e){var t=o(e),n=t&&y.getInstanceFromNode(t);return n&&!n._hostParent?n:null}function f(e){var t=p(e);return t?t._hostContainerInfo._topLevelWrapper:null}var d=n(3),h=n(17),m=n(18),v=n(20),g=n(29),y=(n(12),n(6)),b=n(140),C=n(142),_=n(70),w=n(26),E=(n(9),n(156)),T=n(19),x=n(45),O=n(10),P=n(23),k=n(80),S=(n(1),n(33)),N=n(51),M=(n(2),m.ID_ATTRIBUTE_NAME),A=m.ROOT_ATTRIBUTE_NAME,I=1,D=9,R=11,L={},U=1,F=function(){this.rootID=U++};F.prototype.isReactComponent={},F.prototype.render=function(){return this.props.child},F.isReactTopLevelWrapper=!0;var j={TopLevelWrapper:F,_instancesByReactRootID:L,scrollMonitor:function(e,t){t()},_updateRootComponent:function(e,t,n,r,o){return j.scrollMonitor(r,function(){x.enqueueElementInternal(e,t,n),o&&x.enqueueCallbackInternal(e,o)}),e},_renderNewRootComponent:function(e,t,n,r){c(t)?void 0:d("37"),g.ensureScrollValueMonitoring();var o=k(e,!1);O.batchedUpdates(s,o,t,n,r);
+var i=o._instance.rootID;return L[i]=o,o},renderSubtreeIntoContainer:function(e,t,n,r){return null!=e&&w.has(e)?void 0:d("38"),j._renderSubtreeIntoContainer(e,t,n,r)},_renderSubtreeIntoContainer:function(e,t,n,r){x.validateCallback(r,"ReactDOM.render"),v.isValidElement(t)?void 0:d("39","string"==typeof t?" Instead of passing a string like 'div', pass React.createElement('div') or <div />.":"function"==typeof t?" Instead of passing a class like Foo, pass React.createElement(Foo) or <Foo />.":null!=t&&void 0!==t.props?" This may be caused by unintentionally loading two independent copies of React.":"");var a,s=v.createElement(F,{child:t});if(e){var u=w.get(e);a=u._processChildContext(u._context)}else a=P;var c=f(n);if(c){var p=c._currentElement,h=p.props.child;if(N(h,t)){var m=c._renderedComponent.getPublicInstance(),g=r&&function(){r.call(m)};return j._updateRootComponent(c,s,a,n,g),m}j.unmountComponentAtNode(n)}var y=o(n),b=y&&!!i(y),C=l(n),_=b&&!c&&!C,E=j._renderNewRootComponent(s,n,_,a)._renderedComponent.getPublicInstance();return r&&r.call(E),E},render:function(e,t,n){return j._renderSubtreeIntoContainer(null,e,t,n)},unmountComponentAtNode:function(e){c(e)?void 0:d("40");var t=f(e);if(!t){l(e),1===e.nodeType&&e.hasAttribute(A);return!1}return delete L[t._instance.rootID],O.batchedUpdates(u,t,e,!1),!0},_mountImageIntoNode:function(e,t,n,i,a){if(c(t)?void 0:d("41"),i){var s=o(t);if(E.canReuseMarkup(e,s))return void y.precacheNode(n,s);var u=s.getAttribute(E.CHECKSUM_ATTR_NAME);s.removeAttribute(E.CHECKSUM_ATTR_NAME);var l=s.outerHTML;s.setAttribute(E.CHECKSUM_ATTR_NAME,u);var p=e,f=r(p,l),m=" (client) "+p.substring(f-20,f+20)+"\n (server) "+l.substring(f-20,f+20);t.nodeType===D?d("42",m):void 0}if(t.nodeType===D?d("43"):void 0,a.useCreateElement){for(;t.lastChild;)t.removeChild(t.lastChild);h.insertTreeBefore(t,e,null)}else S(t,e),y.precacheNode(n,t.firstChild)}};e.exports=j},function(e,t,n){"use strict";var r=n(3),o=n(20),i=(n(1),{HOST:0,COMPOSITE:1,EMPTY:2,getType:function(e){return null===e||e===!1?i.EMPTY:o.isValidElement(e)?"function"==typeof e.type?i.COMPOSITE:i.HOST:void r("26",e)}});e.exports=i},function(e,t){"use strict";var n={currentScrollLeft:0,currentScrollTop:0,refreshScrollValues:function(e){n.currentScrollLeft=e.x,n.currentScrollTop=e.y}};e.exports=n},function(e,t,n){"use strict";function r(e,t){return null==t?o("30"):void 0,null==e?t:Array.isArray(e)?Array.isArray(t)?(e.push.apply(e,t),e):(e.push(t),e):Array.isArray(t)?[e].concat(t):[e,t]}var o=n(3);n(1);e.exports=r},function(e,t){"use strict";function n(e,t,n){Array.isArray(e)?e.forEach(t,n):e&&t.call(n,e)}e.exports=n},function(e,t,n){"use strict";function r(e){for(var t;(t=e._renderedNodeType)===o.COMPOSITE;)e=e._renderedComponent;return t===o.HOST?e._renderedComponent:t===o.EMPTY?null:void 0}var o=n(74);e.exports=r},function(e,t,n){"use strict";function r(){return!i&&o.canUseDOM&&(i="textContent"in document.documentElement?"textContent":"innerText"),i}var o=n(7),i=null;e.exports=r},function(e,t,n){"use strict";function r(e){if(e){var t=e.getName();if(t)return" Check the render method of `"+t+"`."}return""}function o(e){return"function"==typeof e&&"undefined"!=typeof e.prototype&&"function"==typeof e.prototype.mountComponent&&"function"==typeof e.prototype.receiveComponent}function i(e,t){var n;if(null===e||e===!1)n=l.create(i);else if("object"==typeof e){var s=e,u=s.type;if("function"!=typeof u&&"string"!=typeof u){var f="";f+=r(s._owner),a("130",null==u?u:typeof u,f)}"string"==typeof s.type?n=c.createInternalComponent(s):o(s.type)?(n=new s.type(s),n.getHostNode||(n.getHostNode=n.getNativeNode)):n=new p(s)}else"string"==typeof e||"number"==typeof e?n=c.createInstanceForText(e):a("131",typeof e);return n._mountIndex=0,n._mountImage=null,n}var a=n(3),s=n(4),u=n(137),l=n(69),c=n(71),p=(n(221),n(1),n(2),function(e){this.construct(e)});s(p.prototype,u,{_instantiateReactComponent:i}),e.exports=i},function(e,t){"use strict";function n(e){var t=e&&e.nodeName&&e.nodeName.toLowerCase();return"input"===t?!!r[e.type]:"textarea"===t}var r={color:!0,date:!0,datetime:!0,"datetime-local":!0,email:!0,month:!0,number:!0,password:!0,range:!0,search:!0,tel:!0,text:!0,time:!0,url:!0,week:!0};e.exports=n},function(e,t,n){"use strict";var r=n(7),o=n(32),i=n(33),a=function(e,t){if(t){var n=e.firstChild;if(n&&n===e.lastChild&&3===n.nodeType)return void(n.nodeValue=t)}e.textContent=t};r.canUseDOM&&("textContent"in document.documentElement||(a=function(e,t){return 3===e.nodeType?void(e.nodeValue=t):void i(e,o(t))})),e.exports=a},function(e,t,n){"use strict";function r(e,t){return e&&"object"==typeof e&&null!=e.key?l.escape(e.key):t.toString(36)}function o(e,t,n,i){var f=typeof e;if("undefined"!==f&&"boolean"!==f||(e=null),null===e||"string"===f||"number"===f||"object"===f&&e.$$typeof===s)return n(i,e,""===t?c+r(e,0):t),1;var d,h,m=0,v=""===t?c:t+p;if(Array.isArray(e))for(var g=0;g<e.length;g++)d=e[g],h=v+r(d,g),m+=o(d,h,n,i);else{var y=u(e);if(y){var b,C=y.call(e);if(y!==e.entries)for(var _=0;!(b=C.next()).done;)d=b.value,h=v+r(d,_++),m+=o(d,h,n,i);else for(;!(b=C.next()).done;){var w=b.value;w&&(d=w[1],h=v+l.escape(w[0])+p+r(d,0),m+=o(d,h,n,i))}}else if("object"===f){var E="",T=String(e);a("31","[object Object]"===T?"object with keys {"+Object.keys(e).join(", ")+"}":T,E)}}return m}function i(e,t,n){return null==e?0:o(e,"",t,n)}var a=n(3),s=(n(12),n(152)),u=n(183),l=(n(1),n(41)),c=(n(2),"."),p=":";e.exports=i},function(e,t,n){(function(){var t,r,o,i,a;t=n(5),r=t.createClass,o=t.DOM.div,i=n(16).isEqualToObject,a=n(28).cancelEvent,e.exports=r({getDefaultProps:function(){return{}},render:function(){var e=this;return o({className:"option-wrapper "+(this.props.highlight?"highlight":""),onMouseDown:function(t){var n;return n=function(t){return e.props.onClick(t),window.removeEventListener("mouseup",n)},window.addEventListener("mouseup",n),a(t)},onMouseMove:this.props.onMouseMove,onMouseOut:this.props.onMouseOut,onMouseOver:this.props.onMouseOver},this.props.renderItem(this.props.item))},shouldComponentUpdate:function(e){var t,n,r;return!i(null!=e?e.uid:void 0,null!=(t=this.props)?t.uid:void 0)||(null!=e?e.highlight:void 0)!==(null!=(n=this.props)?n.highlight:void 0)||(null!=e?e.selectable:void 0)!==(null!=(r=this.props)?r.selectable:void 0)}})}).call(this)},function(e,t,n){(function(){var t,r,o,i;t=n(5),r=t.createClass,o=t.DOM.svg,i=n(13).findDOMNode,e.exports=r({render:function(){return o(this.props)},componentDidMount:function(){i(this).setAttribute("focusable",!1)}})}).call(this)},function(e,t,n){"use strict";function r(e){return e&&e.__esModule?e:{default:e}}function o(e){var t="transition"+e+"Timeout",n="transition"+e;return function(e){if(e[n]){if(null==e[t])return new Error(t+" wasn't supplied to CSSTransitionGroup: this can cause unreliable animations and won't be supported in a future version of React. See https://fb.me/react-animation-transition-group-timeout for more information.");if("number"!=typeof e[t])return new Error(t+" must be a number (in milliseconds)")}return null}}t.__esModule=!0,t.nameShape=void 0,t.transitionTimeout=o;var i=n(5),a=(r(i),n(34)),s=r(a);t.nameShape=s.default.oneOfType([s.default.string,s.default.shape({enter:s.default.string,leave:s.default.string,active:s.default.string}),s.default.shape({enter:s.default.string,enterActive:s.default.string,leave:s.default.string,leaveActive:s.default.string,appear:s.default.string,appearActive:s.default.string})])},function(e,t,n){"use strict";function r(e){var t=Function.prototype.toString,n=Object.prototype.hasOwnProperty,r=RegExp("^"+t.call(n).replace(/[\\^$.*+?()[\]{}|]/g,"\\$&").replace(/hasOwnProperty|(function).*?(?=\\\()| for .+?(?=\\\])/g,"$1.*?")+"$");try{var o=t.call(e);return r.test(o)}catch(e){return!1}}function o(e){var t=l(e);if(t){var n=t.childIDs;c(e),n.forEach(o)}}function i(e,t,n){return"\n    in "+(e||"Unknown")+(t?" (at "+t.fileName.replace(/^.*[\\\/]/,"")+":"+t.lineNumber+")":n?" (created by "+n+")":"")}function a(e){return null==e?"#empty":"string"==typeof e||"number"==typeof e?"#text":"string"==typeof e.type?e.type:e.type.displayName||e.type.name||"Unknown"}function s(e){var t,n=x.getDisplayName(e),r=x.getElement(e),o=x.getOwnerID(e);return o&&(t=x.getDisplayName(o)),i(n,r&&r._source,t)}var u,l,c,p,f,d,h,m=n(22),v=n(12),g=(n(1),n(2),"function"==typeof Array.from&&"function"==typeof Map&&r(Map)&&null!=Map.prototype&&"function"==typeof Map.prototype.keys&&r(Map.prototype.keys)&&"function"==typeof Set&&r(Set)&&null!=Set.prototype&&"function"==typeof Set.prototype.keys&&r(Set.prototype.keys));if(g){var y=new Map,b=new Set;u=function(e,t){y.set(e,t)},l=function(e){return y.get(e)},c=function(e){y.delete(e)},p=function(){return Array.from(y.keys())},f=function(e){b.add(e)},d=function(e){b.delete(e)},h=function(){return Array.from(b.keys())}}else{var C={},_={},w=function(e){return"."+e},E=function(e){return parseInt(e.substr(1),10)};u=function(e,t){var n=w(e);C[n]=t},l=function(e){var t=w(e);return C[t]},c=function(e){var t=w(e);delete C[t]},p=function(){return Object.keys(C).map(E)},f=function(e){var t=w(e);_[t]=!0},d=function(e){var t=w(e);delete _[t]},h=function(){return Object.keys(_).map(E)}}var T=[],x={onSetChildren:function(e,t){var n=l(e);n?void 0:m("144"),n.childIDs=t;for(var r=0;r<t.length;r++){var o=t[r],i=l(o);i?void 0:m("140"),null==i.childIDs&&"object"==typeof i.element&&null!=i.element?m("141"):void 0,i.isMounted?void 0:m("71"),null==i.parentID&&(i.parentID=e),i.parentID!==e?m("142",o,i.parentID,e):void 0}},onBeforeMountComponent:function(e,t,n){var r={element:t,parentID:n,text:null,childIDs:[],isMounted:!1,updateCount:0};u(e,r)},onBeforeUpdateComponent:function(e,t){var n=l(e);n&&n.isMounted&&(n.element=t)},onMountComponent:function(e){var t=l(e);t?void 0:m("144"),t.isMounted=!0;var n=0===t.parentID;n&&f(e)},onUpdateComponent:function(e){var t=l(e);t&&t.isMounted&&t.updateCount++},onUnmountComponent:function(e){var t=l(e);if(t){t.isMounted=!1;var n=0===t.parentID;n&&d(e)}T.push(e)},purgeUnmountedComponents:function(){if(!x._preventPurging){for(var e=0;e<T.length;e++){var t=T[e];o(t)}T.length=0}},isMounted:function(e){var t=l(e);return!!t&&t.isMounted},getCurrentStackAddendum:function(e){var t="";if(e){var n=a(e),r=e._owner;t+=i(n,e._source,r&&r.getName())}var o=v.current,s=o&&o._debugID;return t+=x.getStackAddendumByID(s)},getStackAddendumByID:function(e){for(var t="";e;)t+=s(e),e=x.getParentID(e);return t},getChildIDs:function(e){var t=l(e);return t?t.childIDs:[]},getDisplayName:function(e){var t=x.getElement(e);return t?a(t):null},getElement:function(e){var t=l(e);return t?t.element:null},getOwnerID:function(e){var t=x.getElement(e);return t&&t._owner?t._owner._debugID:null},getParentID:function(e){var t=l(e);return t?t.parentID:null},getSource:function(e){var t=l(e),n=t?t.element:null,r=null!=n?n._source:null;return r},getText:function(e){var t=x.getElement(e);return"string"==typeof t?t:"number"==typeof t?""+t:null},getUpdateCount:function(e){var t=l(e);return t?t.updateCount:0},getRootIDs:h,getRegisteredIDs:p};e.exports=x},function(e,t){"use strict";var n="function"==typeof Symbol&&Symbol.for&&Symbol.for("react.element")||60103;e.exports=n},function(e,t,n){"use strict";var r=!1;e.exports=r},function(e,t){(function(t){"use strict";function n(e){s.length||(a(),u=!0),s[s.length]=e}function r(){for(;l<s.length;){var e=l;if(l+=1,s[e].call(),l>c){for(var t=0,n=s.length-l;t<n;t++)s[t]=s[t+l];s.length-=l,l=0}}s.length=0,l=0,u=!1}function o(e){var t=1,n=new f(e),r=document.createTextNode("");return n.observe(r,{characterData:!0}),function(){t=-t,r.data=t}}function i(e){return function(){function t(){clearTimeout(n),clearInterval(r),e()}var n=setTimeout(t,0),r=setInterval(t,50)}}e.exports=n;var a,s=[],u=!1,l=0,c=1024,p="undefined"!=typeof t?t:self,f=p.MutationObserver||p.WebKitMutationObserver;a="function"==typeof f?o(r):i(r),n.requestFlush=a,n.makeRequestCallFromTimer=i}).call(t,function(){return this}())},function(e,t,n){"use strict";function r(e){return e&&e.__esModule?e:{default:e}}function o(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function i(e,t){if(!e)throw new ReferenceError("this hasn't been initialised - super() hasn't been called");return!t||"object"!=typeof t&&"function"!=typeof t?e:t}function a(e,t){if("function"!=typeof t&&null!==t)throw new TypeError("Super expression must either be null or a function, not "+typeof t);e.prototype=Object.create(t&&t.prototype,{constructor:{value:e,enumerable:!1,writable:!0,configurable:!0}}),t&&(Object.setPrototypeOf?Object.setPrototypeOf(e,t):e.__proto__=t)}Object.defineProperty(t,"__esModule",{value:!0});var s=function(){function e(e,t){for(var n=0;n<t.length;n++){var r=t[n];r.enumerable=r.enumerable||!1,r.configurable=!0,"value"in r&&(r.writable=!0),Object.defineProperty(e,r.key,r)}}return function(t,n,r){return n&&e(t.prototype,n),r&&e(t,r),t}}(),u=n(5),l=r(u),c=n(204),p=function(e){function t(e){o(this,t);var n=i(this,(t.__proto__||Object.getPrototypeOf(t)).call(this,e));return n.getCoefficients=function(e){if(e)return e.map(function(e,t){return l.default.createElement("option",{key:t,value:e.value},e.name)})},n.labels=[],n.handleInputChange=n.handleInputChange.bind(n),n.handleValueChange=n.handleValueChange.bind(n),n}return a(t,e),s(t,[{key:"handleInputChange",value:function(e){var t=this.props.condition;t[e.target.name]=e.target.value;var n=this.props.parameters.find(function(t){return t.value===e.target.value});n&&(t.type=n.type),this.props.onChange({index:this.props.index,value:t})}},{key:"handleValueChange",value:function(e){var t=this.props.condition;t.value=e.map(function(e){return e.value}),this.props.onChange({index:this.props.index,value:t})}},{key:"getOperators",value:function(e,t){if(e&&t)return e.filter(function(e){return e.types.indexOf(t.type)>-1}).map(function(e,t){return l.default.createElement("option",{key:t,value:e.name},e.name)})}},{key:"getValues",value:function(e){return e?e.map(function(e){return{label:e,value:e}}):[]}},{key:"render",value:function(){var e=this,t=this.props.parameters.find(function(t){return t.value===e.props.condition.parameter});return this.props.condition.type=t?t.type:null,l.default.createElement("div",{className:this.props.classes.filterLineRow},l.default.createElement("div",{className:this.props.classes.filterLineParameter},l.default.createElement("select",{className:this.props.classes.filterLineInput,name:"parameter",value:this.props.condition.parameter,onChange:this.handleInputChange},l.default.createElement("option",{value:""},"-- Parameter --"),this.getCoefficients(this.props.parameters))),l.default.createElement("div",{className:this.props.classes.filterLineOperator,style:{"padding-left":0,"padding-right":0}},l.default.createElement("select",{className:this.props.classes.filterLineInput,name:"operator",value:this.props.condition.operator,onChange:this.handleInputChange},l.default.createElement("option",{disabled:!0,value:""},"-- Operator --"),this.getOperators(this.props.operators,this.props.parameters.find(function(t){return t.value===e.props.condition.parameter})))),l.default.createElement("div",{className:this.props.classes.filterLineValue},l.default.createElement(c.MultiSelect,{style:{width:"100%"},placeholder:"-- Value --",theme:"bootstrap3",values:this.getValues(this.props.condition.value),onValuesChange:this.handleValueChange,uid:function(e){return e.value},restoreOnBackspace:function(e){return e.label.toString()},createFromSearch:function(t,n,r){return e.labels=n.map(function(e){return e.label}),0===r.trim().length||e.labels.indexOf(r.trim())!==-1?null:{label:r.trim(),value:r.trim()}},renderNoResultsFound:function(e,t){return l.default.createElement("div",{className:"no-results-found"},function(){return 0===t.trim().length?"Enter a new value":e.map(function(e){return e.label}).indexOf(t.trim())!==-1?"Value already exists":void 0}())}})))}}]),t}(u.Component);t.default=p},function(e,t,n){"use strict";function r(e){return e&&e.__esModule?e:{default:e}}function o(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function i(e,t){if(!e)throw new ReferenceError("this hasn't been initialised - super() hasn't been called");return!t||"object"!=typeof t&&"function"!=typeof t?e:t}function a(e,t){if("function"!=typeof t&&null!==t)throw new TypeError("Super expression must either be null or a function, not "+typeof t);e.prototype=Object.create(t&&t.prototype,{constructor:{value:e,enumerable:!1,writable:!0,configurable:!0}}),t&&(Object.setPrototypeOf?Object.setPrototypeOf(e,t):e.__proto__=t)}Object.defineProperty(t,"__esModule",{value:!0});var s=function(){function e(e,t){for(var n=0;n<t.length;n++){var r=t[n];r.enumerable=r.enumerable||!1,r.configurable=!0,"value"in r&&(r.writable=!0),Object.defineProperty(e,r.key,r)}}return function(t,n,r){return n&&e(t.prototype,n),r&&e(t,r),t}}(),u=n(5),l=r(u),c={paddingTop:10,paddingBottom:10,paddingRight:3,paddingLeft:3},p=function(e){function t(e){o(this,t);var n=i(this,(t.__proto__||Object.getPrototypeOf(t)).call(this,e));return n.removeCondition=n.removeCondition.bind(n),n.addCondition=n.addCondition.bind(n),n}return a(t,e),s(t,[{key:"removeCondition",value:function(){this.props.removeCondition(this.props.index)}},{key:"addCondition",value:function(){this.props.addCondition(this.props.index)}},{key:"render",value:function(){return l.default.createElement("div",{className:this.props.classes.filterLineLabelRow},l.default.createElement("div",{className:this.props.classes.filterLineLabelCondition},l.default.createElement("label",{style:{marginTop:0}},"Condition {",this.props.index+1,"}")),l.default.createElement("div",{className:this.props.classes.filterLineLabelControls},l.default.createElement("a",{style:c,onClick:this.addCondition},l.default.createElement("span",{className:this.props.classes.plusIcon})),l.default.createElement("a",{style:c,onClick:this.removeCondition},l.default.createElement("span",{className:this.props.classes.minusIcon}))))}}]),t}(u.Component);t.default=p},function(e,t,n){"use strict";function r(e){return e&&e.__esModule?e:{default:e}}function o(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function i(e,t){if(!e)throw new ReferenceError("this hasn't been initialised - super() hasn't been called");return!t||"object"!=typeof t&&"function"!=typeof t?e:t}function a(e,t){if("function"!=typeof t&&null!==t)throw new TypeError("Super expression must either be null or a function, not "+typeof t);e.prototype=Object.create(t&&t.prototype,{constructor:{value:e,enumerable:!1,writable:!0,configurable:!0}}),t&&(Object.setPrototypeOf?Object.setPrototypeOf(e,t):e.__proto__=t)}Object.defineProperty(t,"__esModule",{value:!0});var s=function(){function e(e,t){for(var n=0;n<t.length;n++){var r=t[n];r.enumerable=r.enumerable||!1,r.configurable=!0,"value"in r&&(r.writable=!0),Object.defineProperty(e,r.key,r)}}return function(t,n,r){return n&&e(t.prototype,n),r&&e(t,r),t}}(),u=n(5),l=r(u),c=n(91),p=r(c),f=n(92),d=r(f),h=function(e){function t(e){o(this,t);var n=i(this,(t.__proto__||Object.getPrototypeOf(t)).call(this,e));return n.state={conditions:e.config.conditions},n.updateCondition=n.updateCondition.bind(n),n.addCondition=n.addCondition.bind(n),n.removeCondition=n.removeCondition.bind(n),n.componentDidUpdate=n.componentDidUpdate.bind(n),n}return a(t,e),s(t,[{key:"updateCondition",value:function(e){var t=this.state.conditions;t[e.index]=e.value,this.setState({conditions:t})}},{key:"addCondition",value:function(e){var t=this.state.conditions;t.splice(e+1,0,{parameter:"",operator:"",value:""}),this.setState({conditions:t})}},{key:"removeCondition",value:function(e){if(this.state.conditions.length>1){var t=this.state.conditions;t.splice(e,1),this.setState({conditions:t})}}},{key:"componentDidUpdate",value:function(e,t){t!==this.state&&this.props.config.updateConditions(this.state.conditions)}},{key:"render",value:function(){var e=this,t=this.state.conditions.map(function(t,n){return l.default.createElement("div",{key:n},l.default.createElement(d.default,{index:n,classes:e.props.config.classes,addCondition:e.addCondition,removeCondition:e.removeCondition}),l.default.createElement(p.default,{parameters:e.props.config.parameters,operators:e.props.config.operators,condition:t,index:n,classes:e.props.config.classes,onChange:e.updateCondition}))});return l.default.createElement("div",{className:"form-horizontal"},t)}}]),t}(u.Component);t.default=h},function(e,t,n){"use strict";function r(e){return e&&e.__esModule?e:{default:e}}var o=n(5),i=r(o),a=n(13),s=r(a),u=n(93),l=r(u),c=window.$;if(c.fn.filterer=function(e){e.operators=[{name:"contains",types:["string","str"]},{name:"does not contain",types:["string","str"]},{name:"is",types:["string","str","number","int","float"]},{name:"is not",types:["string","str","number","int","float"]},{name:"begins with",types:["string","str"]},{name:"does not begin with",types:["string","str"]},{name:"ends with",types:["string","str"]},{name:"does not end with",types:["string","str"]},{name:"is greater than",types:["number","int","float"]},{name:"is less than",types:["number","int","float"]}],e.classes=Object.assign({plusIcon:"fa fa-fw fa-plus",minusIcon:"fa fa-fw fa-minus",filterLineRow:"form-group",filterLineParameter:"col-sm-4",filterLineOperator:"col-sm-3",filterLineValue:"col-sm-5",filterLineInput:"form-control",filterLineLabelRow:"row",filterLineLabelCondition:"col-sm-10",filterLineLabelControls:"col-sm-2 text-right"},e.classes),this.each(function(){s.default.render(i.default.createElement(l.default,{id:"filterer",config:e}),this)})},window.wcomartin_filterer_demo){var p={parameters:[{name:"Title",type:"string",value:"title"},{name:"Year",type:"number",value:"year"}],conditions:[{parameter:"year",operator:"is",value:[2017]}]};p.updateConditions=function(e){console.log(JSON.stringify(e))},c("#root").filterer(p)}},function(e,t){e.exports=function(){for(var e=arguments.length,t=[],n=0;n<e;n++)t[n]=arguments[n];if(t=t.filter(function(e){return null!=e}),0!==t.length)return 1===t.length?t[0]:t.reduce(function(e,t){return function(){e.apply(this,arguments),t.apply(this,arguments)}})}},function(e,t,n){"use strict";function r(e,t){e.classList?e.classList.add(t):(0,i.default)(e,t)||("string"==typeof e.className?e.className=e.className+" "+t:e.setAttribute("class",(e.className&&e.className.baseVal||"")+" "+t))}var o=n(35);t.__esModule=!0,t.default=r;var i=o(n(97));e.exports=t.default},function(e,t){"use strict";function n(e,t){return e.classList?!!t&&e.classList.contains(t):(" "+(e.className.baseVal||e.className)+" ").indexOf(" "+t+" ")!==-1}t.__esModule=!0,t.default=n,e.exports=t.default},function(e,t){"use strict";function n(e,t){return e.replace(new RegExp("(^|\\s)"+t+"(?:\\s|$)","g"),"$1").replace(/\s+/g," ").replace(/^\s*|\s*$/g,"")}e.exports=function(e,t){e.classList?e.classList.remove(t):"string"==typeof e.className?e.className=n(e.className,t):e.setAttribute("class",n(e.className&&e.className.baseVal||"",t))}},function(e,t,n){"use strict";function r(){for(var e,t,n=document.createElement("div").style,r={O:function(e){return"o"+e.toLowerCase()},Moz:function(e){return e.toLowerCase()},Webkit:function(e){return"webkit"+e},ms:function(e){return"MS"+e}},o=Object.keys(r),i="",a=0;a<o.length;a++){var s=o[a];if(s+"TransitionProperty"in n){i="-"+s.toLowerCase(),e=r[s]("TransitionEnd"),t=r[s]("AnimationEnd");break}}return!e&&"transitionProperty"in n&&(e="transitionend"),!t&&"animationName"in n&&(t="animationend"),n=null,{animationEnd:t,transitionEnd:e,prefix:i}}var o=n(35);t.__esModule=!0,t.default=t.animationEnd=t.animationDelay=t.animationTiming=t.animationDuration=t.animationName=t.transitionEnd=t.transitionDuration=t.transitionDelay=t.transitionTiming=t.transitionProperty=t.transform=void 0;var i=o(n(56)),a="transform";t.transform=a;var s,u,l;t.animationEnd=l,t.transitionEnd=u;var c,p,f,d;t.transitionDelay=d,t.transitionTiming=f,t.transitionDuration=p,t.transitionProperty=c;var h,m,v,g;if(t.animationDelay=g,t.animationTiming=v,t.animationDuration=m,t.animationName=h,i.default){var y=r();s=y.prefix,t.transitionEnd=u=y.transitionEnd,t.animationEnd=l=y.animationEnd,t.transform=a=s+"-"+a,t.transitionProperty=c=s+"-transition-property",t.transitionDuration=p=s+"-transition-duration",t.transitionDelay=d=s+"-transition-delay",t.transitionTiming=f=s+"-transition-timing-function",t.animationName=h=s+"-animation-name",t.animationDuration=m=s+"-animation-duration",t.animationTiming=v=s+"-animation-delay",t.animationDelay=g=s+"-animation-timing-function"}var b={transform:a,end:u,property:c,timing:f,delay:d,duration:p};t.default=b},function(e,t,n){"use strict";function r(e){var t=(new Date).getTime(),n=Math.max(0,16-(t-p)),r=setTimeout(e,n);return p=t,r}var o=n(35);t.__esModule=!0,t.default=void 0;var i,a=o(n(56)),s=["","webkit","moz","o","ms"],u="clearTimeout",l=r,c=function(e,t){return e+(e?t[0].toUpperCase()+t.substr(1):t)+"AnimationFrame"};a.default&&s.some(function(e){var t=c(e,"request");if(t in window)return u=c(e,"cancel"),l=function(e){return window[t](e)}});var p=(new Date).getTime();i=function(e){return l(e)},i.cancel=function(e){window[u]&&"function"==typeof window[u]&&window[u](e)};var f=i;t.default=f,e.exports=t.default},function(e,t){"use strict";function n(e){return e.replace(r,function(e,t){return t.toUpperCase()})}var r=/-(.)/g;e.exports=n},function(e,t,n){"use strict";function r(e){return o(e.replace(i,"ms-"))}var o=n(101),i=/^-ms-/;e.exports=r},function(e,t,n){"use strict";function r(e,t){return!(!e||!t)&&(e===t||!o(e)&&(o(t)?r(e,t.parentNode):"contains"in e?e.contains(t):!!e.compareDocumentPosition&&!!(16&e.compareDocumentPosition(t))))}var o=n(111);e.exports=r},function(e,t,n){"use strict";function r(e){var t=e.length;if(Array.isArray(e)||"object"!=typeof e&&"function"!=typeof e?a(!1):void 0,"number"!=typeof t?a(!1):void 0,0===t||t-1 in e?void 0:a(!1),"function"==typeof e.callee?a(!1):void 0,e.hasOwnProperty)try{return Array.prototype.slice.call(e)}catch(e){}for(var n=Array(t),r=0;r<t;r++)n[r]=e[r];return n}function o(e){return!!e&&("object"==typeof e||"function"==typeof e)&&"length"in e&&!("setInterval"in e)&&"number"!=typeof e.nodeType&&(Array.isArray(e)||"callee"in e||"item"in e)}function i(e){return o(e)?Array.isArray(e)?e.slice():r(e):[e]}var a=n(1);e.exports=i},function(e,t,n){"use strict";function r(e){var t=e.match(c);return t&&t[1].toLowerCase()}function o(e,t){var n=l;l?void 0:u(!1);var o=r(e),i=o&&s(o);if(i){n.innerHTML=i[1]+e+i[2];for(var c=i[0];c--;)n=n.lastChild}else n.innerHTML=e;var p=n.getElementsByTagName("script");p.length&&(t?void 0:u(!1),a(p).forEach(t));for(var f=Array.from(n.childNodes);n.lastChild;)n.removeChild(n.lastChild);return f}var i=n(7),a=n(104),s=n(106),u=n(1),l=i.canUseDOM?document.createElement("div"):null,c=/^\s*<(\w+)/;e.exports=o},function(e,t,n){"use strict";function r(e){return a?void 0:i(!1),f.hasOwnProperty(e)||(e="*"),s.hasOwnProperty(e)||("*"===e?a.innerHTML="<link />":a.innerHTML="<"+e+"></"+e+">",s[e]=!a.firstChild),s[e]?f[e]:null}var o=n(7),i=n(1),a=o.canUseDOM?document.createElement("div"):null,s={},u=[1,'<select multiple="true">',"</select>"],l=[1,"<table>","</table>"],c=[3,"<table><tbody><tr>","</tr></tbody></table>"],p=[1,'<svg xmlns="http://www.w3.org/2000/svg">',"</svg>"],f={"*":[1,"?<div>","</div>"],area:[1,"<map>","</map>"],col:[2,"<table><tbody></tbody><colgroup>","</colgroup></table>"],legend:[1,"<fieldset>","</fieldset>"],param:[1,"<object>","</object>"],tr:[2,"<table><tbody>","</tbody></table>"],optgroup:u,option:u,caption:l,colgroup:l,tbody:l,tfoot:l,thead:l,td:c,th:c},d=["circle","clipPath","defs","ellipse","g","image","line","linearGradient","mask","path","pattern","polygon","polyline","radialGradient","rect","stop","text","tspan"];d.forEach(function(e){f[e]=p,s[e]=!0}),e.exports=r},function(e,t){"use strict";function n(e){return e.Window&&e instanceof e.Window?{x:e.pageXOffset||e.document.documentElement.scrollLeft,y:e.pageYOffset||e.document.documentElement.scrollTop}:{x:e.scrollLeft,y:e.scrollTop}}e.exports=n},function(e,t){"use strict";function n(e){return e.replace(r,"-$1").toLowerCase()}var r=/([A-Z])/g;e.exports=n},function(e,t,n){"use strict";function r(e){return o(e).replace(i,"-ms-")}var o=n(108),i=/^ms-/;e.exports=r},function(e,t){"use strict";function n(e){var t=e?e.ownerDocument||e:document,n=t.defaultView||window;return!(!e||!("function"==typeof n.Node?e instanceof n.Node:"object"==typeof e&&"number"==typeof e.nodeType&&"string"==typeof e.nodeName))}e.exports=n},function(e,t,n){"use strict";function r(e){return o(e)&&3==e.nodeType}var o=n(110);e.exports=r},function(e,t){"use strict";function n(e){var t={};return function(n){return t.hasOwnProperty(n)||(t[n]=e.call(this,n)),t[n]}}e.exports=n},function(e,t){function n(e,t){var n,r=function(o){return e.length>1?function(){var i=o?o.concat():[];return n=t?n||this:this,i.push.apply(i,arguments)<e.length&&arguments.length?r.call(n,i):e.apply(n,i)}:e};return r()}var r,o,i,a,s,u,l={}.toString;r=n(function(e,t){return e.apply(null,t)}),o=function(e){return n(e)},i=n(function(e,t,n){return e(n,t)}),a=function(e){return function(t){return function(){return e(t(t)).apply(null,arguments)}}(function(t){return function(){return e(t(t)).apply(null,arguments)}})},s=n(function(e,t,n,r){return e(t(n),t(r))}),u=function(e){var t;return t={},function(){var n,r,o,i,a,s;for(r=[],o=0,i=arguments.length;o<i;++o)r.push(arguments[o]);return n=r,a=function(){var e,t,r,o=[];for(e=0,r=(t=n).length;e<r;++e)s=t[e],o.push(s+l.call(s).slice(8,-1));return o}().join(""),t[a]=a in t?t[a]:e.apply(null,n)}},e.exports={curry:o,flip:i,fix:a,apply:r,over:s,memoize:u}},function(e,t){function n(e,t){var n,r=function(o){return e.length>1?function(){var i=o?o.concat():[];return n=t?n||this:this,i.push.apply(i,arguments)<e.length&&arguments.length?r.call(n,i):e.apply(n,i)}:e};return r()}function r(e,t){for(var n=-1,r=t.length>>>0;++n<r;)if(e===t[n])return!0;return!1}function o(){var e=arguments;return function(){var t,n;for(n=e[0].apply(this,arguments),t=1;t<e.length;++t)n=e[t](n);return n}}function i(e){return!e}var a,s,u,l,c,p,f,d,h,m,v,g,y,b,C,_,w,E,T,x,O,P,k,S,N,M,A,I,D,R,L,U,F,j,B,V,W,H,q,z,K,Y,X,G,Q,$,Z,J,ee,te,ne,re,oe,ie,ae,se,ue,le,ce,pe,fe,de,he,me,ve,ge,ye,be,Ce,_e,we={}.toString;a=n(function(e,t){var n,r,o;for(n=0,r=t.length;n<r;++n)o=t[n],e(o);return t}),s=n(function(e,t){var n,r,o,i=[];for(n=0,r=t.length;n<r;++n)o=t[n],i.push(e(o));return i}),u=function(e){var t,n,r,o=[];for(t=0,n=e.length;t<n;++t)r=e[t],r&&o.push(r);return o},l=n(function(e,t){var n,r,o,i=[];for(n=0,r=t.length;n<r;++n)o=t[n],e(o)&&i.push(o);return i}),c=n(function(e,t){var n,r,o,i=[];for(n=0,r=t.length;n<r;++n)o=t[n],e(o)||i.push(o);return i}),p=n(function(e,t){var n,r;return n=ye(e,t),r=t.slice(),null!=n&&r.splice(n,1),r}),f=n(function(e,t){var n,r,o,i,a;for(n=[],r=[],o=0,i=t.length;o<i;++o)a=t[o],(e(a)?n:r).push(a);return[n,r]}),d=n(function(e,t){var n,r,o;for(n=0,r=t.length;n<r;++n)if(o=t[n],e(o))return o}),h=m=function(e){return e[0]},v=function(e){if(e.length)return e.slice(1)},g=function(e){return e[e.length-1]},y=function(e){if(e.length)return e.slice(0,-1)},b=function(e){return!e.length},C=function(e){return e.concat().reverse()},_=function(e){var t,n,o,i;for(t=[],n=0,o=e.length;n<o;++n)i=e[n],r(i,t)||t.push(i);return t},w=n(function(e,t){var n,o,i,a,s,u=[];for(n=[],o=0,i=t.length;o<i;++o)a=t[o],s=e(a),r(s,n)||(n.push(s),u.push(a));return u}),E=T=n(function(e,t,n){var r,o,i;for(r=0,o=n.length;r<o;++r)i=n[r],t=e(t,i);return t}),x=O=n(function(e,t){return E(e,t[0],t.slice(1))}),P=n(function(e,t,n){var r,o;for(r=n.length-1;r>=0;--r)o=n[r],t=e(o,t);return t}),k=n(function(e,t){return P(e,t[t.length-1],t.slice(0,-1))}),S=n(function(e,t){var n,r,o;for(n=[],r=t;null!=(o=e(r));)n.push(o[0]),r=o[1];return n}),N=function(e){return[].concat.apply([],e)},M=n(function(e,t){var n;return[].concat.apply([],function(){
+var r,o,i,a=[];for(r=0,i=(o=t).length;r<i;++r)n=o[r],a.push(e(n));return a}())}),A=function(e){var t;return[].concat.apply([],function(){var n,r,o,i=[];for(n=0,o=(r=e).length;n<o;++n)t=r[n],"Array"===we.call(t).slice(8,-1)?i.push(A(t)):i.push(t);return i}())},I=function(e){var t,n,o,i,a,s,u,l,c,p;for(n=[],o=1,i=arguments.length;o<i;++o)n.push(arguments[o]);t=n,a=[];e:for(o=0,s=e.length;o<s;++o){for(u=e[o],l=0,c=t.length;l<c;++l)if(p=t[l],r(u,p))continue e;a.push(u)}return a},D=function(e){var t,n,o,i,a,s,u,l,c,p;for(n=[],o=1,i=arguments.length;o<i;++o)n.push(arguments[o]);t=n,a=[];e:for(o=0,s=e.length;o<s;++o){for(u=e[o],l=0,c=t.length;l<c;++l)if(p=t[l],!r(u,p))continue e;a.push(u)}return a},R=function(){var e,t,n,o,i,a,s,u,l,c;for(t=[],n=0,o=arguments.length;n<o;++n)t.push(arguments[n]);for(e=t,i=[],n=0,a=e.length;n<a;++n)for(s=e[n],u=0,l=s.length;u<l;++u)c=s[u],r(c,i)||i.push(c);return i},L=n(function(e,t){var n,r,o,i,a;for(n={},r=0,o=t.length;r<o;++r)i=t[r],a=e(i),a in n?n[a]+=1:n[a]=1;return n}),U=n(function(e,t){var n,r,o,i,a;for(n={},r=0,o=t.length;r<o;++r)i=t[r],a=e(i),a in n?n[a].push(i):n[a]=[i];return n}),F=function(e){var t,n,r;for(t=0,n=e.length;t<n;++t)if(r=e[t],!r)return!1;return!0},j=function(e){var t,n,r;for(t=0,n=e.length;t<n;++t)if(r=e[t])return!0;return!1},B=n(function(e,t){var n,r,o;for(n=0,r=t.length;n<r;++n)if(o=t[n],e(o))return!0;return!1}),V=n(function(e,t){var n,r,o;for(n=0,r=t.length;n<r;++n)if(o=t[n],!e(o))return!1;return!0}),W=function(e){return e.concat().sort(function(e,t){return e>t?1:e<t?-1:0})},H=n(function(e,t){return t.concat().sort(e)}),q=n(function(e,t){return t.concat().sort(function(t,n){return e(t)>e(n)?1:e(t)<e(n)?-1:0})}),z=function(e){var t,n,r,o;for(t=0,n=0,r=e.length;n<r;++n)o=e[n],t+=o;return t},K=function(e){var t,n,r,o;for(t=1,n=0,r=e.length;n<r;++n)o=e[n],t*=o;return t},Y=X=function(e){var t,n,r,o;for(t=0,n=0,r=e.length;n<r;++n)o=e[n],t+=o;return t/e.length},G=function(e){var t,n,r,o,i;for(t=e[0],n=0,o=(r=e.slice(1)).length;n<o;++n)i=r[n],i>t&&(t=i);return t},Q=function(e){var t,n,r,o,i;for(t=e[0],n=0,o=(r=e.slice(1)).length;n<o;++n)i=r[n],i<t&&(t=i);return t},$=n(function(e,t){var n,r,o,i,a;for(n=t[0],r=0,i=(o=t.slice(1)).length;r<i;++r)a=o[r],e(a)>e(n)&&(n=a);return n}),Z=n(function(e,t){var n,r,o,i,a;for(n=t[0],r=0,i=(o=t.slice(1)).length;r<i;++r)a=o[r],e(a)<e(n)&&(n=a);return n}),J=ee=n(function(e,t,n){var r,o;return r=t,[t].concat(function(){var t,i,a,s=[];for(t=0,a=(i=n).length;t<a;++t)o=i[t],s.push(r=e(r,o));return s}())}),te=ne=n(function(e,t){if(t.length)return J(e,t[0],t.slice(1))}),re=n(function(e,t,n){return n=n.concat().reverse(),J(e,t,n).reverse()}),oe=n(function(e,t){if(t.length)return t=t.concat().reverse(),J(e,t[0],t.slice(1)).reverse()}),ie=n(function(e,t,n){return n.slice(e,t)}),ae=n(function(e,t){return e<=0?t.slice(0,0):t.slice(0,e)}),se=n(function(e,t){return e<=0?t:t.slice(e)}),ue=n(function(e,t){return[ae(e,t),se(e,t)]}),le=n(function(e,t){var n,r;if(n=t.length,!n)return t;for(r=0;r<n&&e(t[r]);)r+=1;return t.slice(0,r)}),ce=n(function(e,t){var n,r;if(n=t.length,!n)return t;for(r=0;r<n&&e(t[r]);)r+=1;return t.slice(r)}),pe=n(function(e,t){return[le(e,t),ce(e,t)]}),fe=n(function(e,t){return pe(o(e,i),t)}),de=n(function(e,t){var n,r,o,i,a,s;for(n=[],r=t.length,o=0,i=e.length;o<i&&(a=o,s=e[o],a!==r);++o)n.push([s,t[a]]);return n}),he=n(function(e,t,n){var r,o,i,a,s,u;for(r=[],o=n.length,i=0,a=t.length;i<a&&(s=i,u=t[i],s!==o);++i)r.push(e(u,n[s]));return r}),me=function(){var e,t,n,r,o,i,a,s,u,l,c,p=[];for(t=[],n=0,r=arguments.length;n<r;++n)t.push(arguments[n]);for(e=t,o=void 0,n=0,i=e.length;n<i;++n)a=e[n],o<=(s=a.length)||(o=s);for(n=0;n<o;++n){for(u=n,l=[],c=0,i=e.length;c<i;++c)a=e[c],l.push(a[u]);p.push(l)}return p},ve=function(e){function t(){var e,t,r,o=[];for(e=0,r=(t=n).length;e<r;++e)u=t[e],o.push(u[c]);return o}var n,r,o,i,a,s,u,l,c,p=[];for(r=[],o=1,i=arguments.length;o<i;++o)r.push(arguments[o]);for(n=r,a=void 0,o=0,s=n.length;o<s;++o)u=n[o],a<=(l=u.length)||(a=l);for(o=0;o<a;++o)c=o,p.push(e.apply(null,t()));return p},ge=n(function(e,t){return e<0?t[t.length+e]:t[e]}),ye=n(function(e,t){var n,r,o,i;for(n=0,r=t.length;n<r;++n)if(o=n,i=t[n],i===e)return o}),be=n(function(e,t){var n,r,o,i,a=[];for(n=0,r=t.length;n<r;++n)o=n,i=t[n],i===e&&a.push(o);return a}),Ce=n(function(e,t){var n,r,o,i;for(n=0,r=t.length;n<r;++n)if(o=n,i=t[n],e(i))return o}),_e=n(function(e,t){var n,r,o,i,a=[];for(n=0,r=t.length;n<r;++n)o=n,i=t[n],e(i)&&a.push(o);return a}),e.exports={each:a,map:s,filter:l,compact:u,reject:c,remove:p,partition:f,find:d,head:h,first:m,tail:v,last:g,initial:y,empty:b,reverse:C,difference:I,intersection:D,union:R,countBy:L,groupBy:U,fold:E,fold1:x,foldl:T,foldl1:O,foldr:P,foldr1:k,unfoldr:S,andList:F,orList:j,any:B,all:V,unique:_,uniqueBy:w,sort:W,sortWith:H,sortBy:q,sum:z,product:K,mean:Y,average:X,concat:N,concatMap:M,flatten:A,maximum:G,minimum:Q,maximumBy:$,minimumBy:Z,scan:J,scan1:te,scanl:ee,scanl1:ne,scanr:re,scanr1:oe,slice:ie,take:ae,drop:se,splitAt:ue,takeWhile:le,dropWhile:ce,span:pe,breakList:fe,zip:de,zipWith:he,zipAll:me,zipAllWith:ve,at:ge,elemIndex:ye,elemIndices:be,findIndex:Ce,findIndices:_e}},function(e,t){function n(e,t){var n,r=function(o){return e.length>1?function(){var i=o?o.concat():[];return n=t?n||this:this,i.push.apply(i,arguments)<e.length&&arguments.length?r.call(n,i):e.apply(n,i)}:e};return r()}var r,o,i,a,s,u,l,c,p,f,d,h,m,v,g,y,b,C,_,w,E,T,x,O,P,k,S,N,M,A,I,D;r=n(function(e,t){return e>t?e:t}),o=n(function(e,t){return e<t?e:t}),i=function(e){return-e},a=Math.abs,s=function(e){return e<0?-1:e>0?1:0},u=n(function(e,t){return~~(e/t)}),l=n(function(e,t){return e%t}),c=n(function(e,t){return Math.floor(e/t)}),p=n(function(e,t){var n;return(e%(n=t)+n)%n}),f=function(e){return 1/e},d=Math.PI,h=2*d,m=Math.exp,v=Math.sqrt,g=Math.log,y=n(function(e,t){return Math.pow(e,t)}),b=Math.sin,C=Math.tan,_=Math.cos,w=Math.asin,E=Math.acos,T=Math.atan,x=n(function(e,t){return Math.atan2(e,t)}),O=function(e){return~~e},P=Math.round,k=Math.ceil,S=Math.floor,N=function(e){return e!==e},M=function(e){return e%2===0},A=function(e){return e%2!==0},I=n(function(e,t){var n;for(e=Math.abs(e),t=Math.abs(t);0!==t;)n=e%t,e=t,t=n;return e}),D=n(function(e,t){return Math.abs(Math.floor(e/I(e,t)*t))}),e.exports={max:r,min:o,negate:i,abs:a,signum:s,quot:u,rem:l,div:c,mod:p,recip:f,pi:d,tau:h,exp:m,sqrt:v,ln:g,pow:y,sin:b,tan:C,cos:_,acos:E,asin:w,atan:T,atan2:x,truncate:O,round:P,ceiling:k,floor:S,isItNaN:N,even:M,odd:A,gcd:I,lcm:D}},function(e,t){function n(e,t){var n,r=function(o){return e.length>1?function(){var i=o?o.concat():[];return n=t?n||this:this,i.push.apply(i,arguments)<e.length&&arguments.length?r.call(n,i):e.apply(n,i)}:e};return r()}var r,o,i,a,s,u,l,c,p,f,d,h,m,v;r=function(e){var t,n,r=[];for(t in e)n=e[t],r.push(n);return r},o=function(e){var t,n=[];for(t in e)n.push(t);return n},i=function(e){var t,n,r,o={};for(t=0,n=e.length;t<n;++t)r=e[t],o[r[0]]=r[1];return o},a=function(e){var t,n,r=[];for(t in e)n=e[t],r.push([t,n]);return r},s=n(function(e,t){var n,r,o,i,a={};for(n=0,r=e.length;n<r;++n)o=n,i=e[n],a[i]=t[o];return a}),u=function(e){var t,n,r,o;t=[],n=[];for(r in e)o=e[r],t.push(r),n.push(o);return[t,n]},l=function(e){var t;for(t in e)return!1;return!0},c=n(function(e,t){var n,r;for(n in t)r=t[n],e(r);return t}),p=n(function(e,t){var n,r,o={};for(n in t)r=t[n],o[n]=e(r);return o}),f=function(e){var t,n,r={};for(t in e)n=e[t],n&&(r[t]=n);return r},d=n(function(e,t){var n,r,o={};for(n in t)r=t[n],e(r)&&(o[n]=r);return o}),h=n(function(e,t){var n,r,o={};for(n in t)r=t[n],e(r)||(o[n]=r);return o}),m=n(function(e,t){var n,r,o,i;n={},r={};for(o in t)i=t[o],(e(i)?n:r)[o]=i;return[n,r]}),v=n(function(e,t){var n,r;for(n in t)if(r=t[n],e(r))return r}),e.exports={values:r,keys:o,pairsToObj:i,objToPairs:a,listsToObj:s,objToLists:u,empty:l,each:c,map:p,filter:d,compact:f,reject:h,partition:m,find:v}},function(e,t){function n(e,t){var n,r=function(o){return e.length>1?function(){var i=o?o.concat():[];return n=t?n||this:this,i.push.apply(i,arguments)<e.length&&arguments.length?r.call(n,i):e.apply(n,i)}:e};return r()}var r,o,i,a,s,u,l,c,p,f,d,h,m;r=n(function(e,t){return t.split(e)}),o=n(function(e,t){return t.join(e)}),i=function(e){return e.length?e.split("\n"):[]},a=function(e){return e.join("\n")},s=function(e){return e.length?e.split(/[ ]+/):[]},u=function(e){return e.join(" ")},l=function(e){return e.split("")},c=function(e){return e.join("")},p=function(e){return e.split("").reverse().join("")},f=n(function(e,t){var n,r;for(n="",r=0;r<e;++r)n+=t;return n}),d=function(e){return e.charAt(0).toUpperCase()+e.slice(1)},h=function(e){return e.replace(/[-_]+(.)?/g,function(e,t){return(null!=t?t:"").toUpperCase()})},m=function(e){return e.replace(/([^-A-Z])([A-Z]+)/g,function(e,t,n){return t+"-"+(n.length>1?n:n.toLowerCase())}).replace(/^([A-Z]+)/,function(e,t){return t.length>1?t+"-":t.toLowerCase()})},e.exports={split:r,join:o,lines:i,unlines:a,words:s,unwords:u,chars:l,unchars:c,reverse:p,repeat:f,capitalize:d,camelize:h,dasherize:m}},[227,113,114,116,117,115],function(e,t,n){"use strict";function r(e){var t=new o(o._61);return t._81=1,t._65=e,t}var o=n(61);e.exports=o;var i=r(!0),a=r(!1),s=r(null),u=r(void 0),l=r(0),c=r("");o.resolve=function(e){if(e instanceof o)return e;if(null===e)return s;if(void 0===e)return u;if(e===!0)return i;if(e===!1)return a;if(0===e)return l;if(""===e)return c;if("object"==typeof e||"function"==typeof e)try{var t=e.then;if("function"==typeof t)return new o(t.bind(e))}catch(e){return new o(function(t,n){n(e)})}return r(e)},o.all=function(e){var t=Array.prototype.slice.call(e);return new o(function(e,n){function r(a,s){if(s&&("object"==typeof s||"function"==typeof s)){if(s instanceof o&&s.then===o.prototype.then){for(;3===s._81;)s=s._65;return 1===s._81?r(a,s._65):(2===s._81&&n(s._65),void s.then(function(e){r(a,e)},n))}var u=s.then;if("function"==typeof u){var l=new o(u.bind(s));return void l.then(function(e){r(a,e)},n)}}t[a]=s,0===--i&&e(t)}if(0===t.length)return e([]);for(var i=t.length,a=0;a<t.length;a++)r(a,t[a])})},o.reject=function(e){return new o(function(t,n){n(e)})},o.race=function(e){return new o(function(t,n){e.forEach(function(e){o.resolve(e).then(t,n)})})},o.prototype.catch=function(e){return this.then(null,e)}},function(e,t,n){"use strict";function r(){l=!1,s._10=null,s._97=null}function o(e){function t(t){(e.allRejections||a(p[t].error,e.whitelist||u))&&(p[t].displayId=c++,e.onUnhandled?(p[t].logged=!0,e.onUnhandled(p[t].displayId,p[t].error)):(p[t].logged=!0,i(p[t].displayId,p[t].error)))}function n(t){p[t].logged&&(e.onHandled?e.onHandled(p[t].displayId,p[t].error):p[t].onUnhandled||(console.warn("Promise Rejection Handled (id: "+p[t].displayId+"):"),console.warn('  This means you can ignore any previous messages of the form "Possible Unhandled Promise Rejection" with id '+p[t].displayId+".")))}e=e||{},l&&r(),l=!0;var o=0,c=0,p={};s._10=function(e){2===e._81&&p[e._72]&&(p[e._72].logged?n(e._72):clearTimeout(p[e._72].timeout),delete p[e._72])},s._97=function(e,n){0===e._45&&(e._72=o++,p[e._72]={displayId:null,error:n,timeout:setTimeout(t.bind(null,e._72),a(n,u)?100:2e3),logged:!1})}}function i(e,t){console.warn("Possible Unhandled Promise Rejection (id: "+e+"):");var n=(t&&(t.stack||t))+"";n.split("\n").forEach(function(e){console.warn("  "+e)})}function a(e,t){return t.some(function(t){return e instanceof t})}var s=n(61),u=[ReferenceError,TypeError,RangeError],l=!1;t.disable=r,t.enable=o},function(e,t,n){"use strict";function r(e,t,n,r,o){}e.exports=r},function(e,t,n){"use strict";var r=n(8),o=n(1),i=(n(2),n(123)),a=n(121);e.exports=function(e,t){function n(e){var t=e&&(x&&e[x]||e[O]);if("function"==typeof t)return t}function s(e,t){return e===t?0!==e||1/e===1/t:e!==e&&t!==t}function u(e){this.message=e,this.stack=""}function l(e){function n(n,r,a,s,l,c,p){if(s=s||P,c=c||a,p!==i)if(t)o(!1,"Calling PropTypes validators directly is not supported by the `prop-types` package. Use `PropTypes.checkPropTypes()` to call them. Read more at http://fb.me/use-check-prop-types");else;return null==r[a]?n?new u(null===r[a]?"The "+l+" `"+c+"` is marked as required "+("in `"+s+"`, but its value is `null`."):"The "+l+" `"+c+"` is marked as required in "+("`"+s+"`, but its value is `undefined`.")):null:e(r,a,s,l,c)}var r=n.bind(null,!1);return r.isRequired=n.bind(null,!0),r}function c(e){function t(t,n,r,o,i,a){var s=t[n],l=w(s);if(l!==e){var c=E(s);return new u("Invalid "+o+" `"+i+"` of type "+("`"+c+"` supplied to `"+r+"`, expected ")+("`"+e+"`."))}return null}return l(t)}function p(){return l(r.thatReturnsNull)}function f(e){function t(t,n,r,o,a){if("function"!=typeof e)return new u("Property `"+a+"` of component `"+r+"` has invalid PropType notation inside arrayOf.");var s=t[n];if(!Array.isArray(s)){var l=w(s);return new u("Invalid "+o+" `"+a+"` of type "+("`"+l+"` supplied to `"+r+"`, expected an array."))}for(var c=0;c<s.length;c++){var p=e(s,c,r,o,a+"["+c+"]",i);if(p instanceof Error)return p}return null}return l(t)}function d(){function t(t,n,r,o,i){var a=t[n];if(!e(a)){var s=w(a);return new u("Invalid "+o+" `"+i+"` of type "+("`"+s+"` supplied to `"+r+"`, expected a single ReactElement."))}return null}return l(t)}function h(e){function t(t,n,r,o,i){if(!(t[n]instanceof e)){var a=e.name||P,s=T(t[n]);return new u("Invalid "+o+" `"+i+"` of type "+("`"+s+"` supplied to `"+r+"`, expected ")+("instance of `"+a+"`."))}return null}return l(t)}function m(e){function t(t,n,r,o,i){for(var a=t[n],l=0;l<e.length;l++)if(s(a,e[l]))return null;var c=JSON.stringify(e);return new u("Invalid "+o+" `"+i+"` of value `"+a+"` "+("supplied to `"+r+"`, expected one of "+c+"."))}return Array.isArray(e)?l(t):r.thatReturnsNull}function v(e){function t(t,n,r,o,a){if("function"!=typeof e)return new u("Property `"+a+"` of component `"+r+"` has invalid PropType notation inside objectOf.");var s=t[n],l=w(s);if("object"!==l)return new u("Invalid "+o+" `"+a+"` of type "+("`"+l+"` supplied to `"+r+"`, expected an object."));for(var c in s)if(s.hasOwnProperty(c)){var p=e(s,c,r,o,a+"."+c,i);if(p instanceof Error)return p}return null}return l(t)}function g(e){function t(t,n,r,o,a){for(var s=0;s<e.length;s++){var l=e[s];if(null==l(t,n,r,o,a,i))return null}return new u("Invalid "+o+" `"+a+"` supplied to "+("`"+r+"`."))}return Array.isArray(e)?l(t):r.thatReturnsNull}function y(){function e(e,t,n,r,o){return C(e[t])?null:new u("Invalid "+r+" `"+o+"` supplied to "+("`"+n+"`, expected a ReactNode."))}return l(e)}function b(e){function t(t,n,r,o,a){var s=t[n],l=w(s);if("object"!==l)return new u("Invalid "+o+" `"+a+"` of type `"+l+"` "+("supplied to `"+r+"`, expected `object`."));for(var c in e){var p=e[c];if(p){var f=p(s,c,r,o,a+"."+c,i);if(f)return f}}return null}return l(t)}function C(t){switch(typeof t){case"number":case"string":case"undefined":return!0;case"boolean":return!t;case"object":if(Array.isArray(t))return t.every(C);if(null===t||e(t))return!0;var r=n(t);if(!r)return!1;var o,i=r.call(t);if(r!==t.entries){for(;!(o=i.next()).done;)if(!C(o.value))return!1}else for(;!(o=i.next()).done;){var a=o.value;if(a&&!C(a[1]))return!1}return!0;default:return!1}}function _(e,t){return"symbol"===e||("Symbol"===t["@@toStringTag"]||"function"==typeof Symbol&&t instanceof Symbol)}function w(e){var t=typeof e;return Array.isArray(e)?"array":e instanceof RegExp?"object":_(t,e)?"symbol":t}function E(e){var t=w(e);if("object"===t){if(e instanceof Date)return"date";if(e instanceof RegExp)return"regexp"}return t}function T(e){return e.constructor&&e.constructor.name?e.constructor.name:P}var x="function"==typeof Symbol&&Symbol.iterator,O="@@iterator",P="<<anonymous>>",k={array:c("array"),bool:c("boolean"),func:c("function"),number:c("number"),object:c("object"),string:c("string"),symbol:c("symbol"),any:p(),arrayOf:f,element:d(),instanceOf:h,node:y(),objectOf:v,oneOf:m,oneOfType:g,shape:b};return u.prototype=Error.prototype,k.checkPropTypes=a,k.PropTypes=k,k}},function(e,t){"use strict";var n="SECRET_DO_NOT_PASS_THIS_OR_YOU_WILL_BE_FIRED";e.exports=n},function(e,t){"use strict";function n(e,t){return e===t?0!==e||0!==t||1/e===1/t:e!==e&&t!==t}function r(e,t){if(n(e,t))return!0;if("object"!=typeof e||null===e||"object"!=typeof t||null===t)return!1;var r=Object.keys(e),o=Object.keys(t);if(r.length!==o.length)return!1;for(var a=0;a<r.length;a++)if(!i.call(t,r[a])||!n(e[r[a]],t[r[a]]))return!1;return!0}function o(e,t,n){return!r(e.props,t)||!r(e.state,n)}var i=Object.prototype.hasOwnProperty;e.exports=o},function(e,t){"use strict";var n={Properties:{"aria-current":0,"aria-details":0,"aria-disabled":0,"aria-hidden":0,"aria-invalid":0,"aria-keyshortcuts":0,"aria-label":0,"aria-roledescription":0,"aria-autocomplete":0,"aria-checked":0,"aria-expanded":0,"aria-haspopup":0,"aria-level":0,"aria-modal":0,"aria-multiline":0,"aria-multiselectable":0,"aria-orientation":0,"aria-placeholder":0,"aria-pressed":0,"aria-readonly":0,"aria-required":0,"aria-selected":0,"aria-sort":0,"aria-valuemax":0,"aria-valuemin":0,"aria-valuenow":0,"aria-valuetext":0,"aria-atomic":0,"aria-busy":0,"aria-live":0,"aria-relevant":0,"aria-dropeffect":0,"aria-grabbed":0,"aria-activedescendant":0,"aria-colcount":0,"aria-colindex":0,"aria-colspan":0,"aria-controls":0,"aria-describedby":0,"aria-errormessage":0,"aria-flowto":0,"aria-labelledby":0,"aria-owns":0,"aria-posinset":0,"aria-rowcount":0,"aria-rowindex":0,"aria-rowspan":0,"aria-setsize":0},DOMAttributeNames:{},DOMPropertyNames:{}};e.exports=n},function(e,t,n){"use strict";var r=n(6),o=n(58),i={focusDOMComponent:function(){o(r.getNodeFromInstance(this))}};e.exports=i},function(e,t,n){"use strict";function r(){var e=window.opera;return"object"==typeof e&&"function"==typeof e.version&&parseInt(e.version(),10)<=12}function o(e){return(e.ctrlKey||e.altKey||e.metaKey)&&!(e.ctrlKey&&e.altKey)}function i(e){switch(e){case"topCompositionStart":return O.compositionStart;case"topCompositionEnd":return O.compositionEnd;case"topCompositionUpdate":return O.compositionUpdate}}function a(e,t){return"topKeyDown"===e&&t.keyCode===b}function s(e,t){switch(e){case"topKeyUp":return y.indexOf(t.keyCode)!==-1;case"topKeyDown":return t.keyCode!==b;case"topKeyPress":case"topMouseDown":case"topBlur":return!0;default:return!1}}function u(e){var t=e.detail;return"object"==typeof t&&"data"in t?t.data:null}function l(e,t,n,r){var o,l;if(C?o=i(e):k?s(e,n)&&(o=O.compositionEnd):a(e,n)&&(o=O.compositionStart),!o)return null;E&&(k||o!==O.compositionStart?o===O.compositionEnd&&k&&(l=k.getData()):k=m.getPooled(r));var c=v.getPooled(o,t,n,r);if(l)c.data=l;else{var p=u(n);null!==p&&(c.data=p)}return d.accumulateTwoPhaseDispatches(c),c}function c(e,t){switch(e){case"topCompositionEnd":return u(t);case"topKeyPress":var n=t.which;return n!==T?null:(P=!0,x);case"topTextInput":var r=t.data;return r===x&&P?null:r;default:return null}}function p(e,t){if(k){if("topCompositionEnd"===e||!C&&s(e,t)){var n=k.getData();return m.release(k),k=null,n}return null}switch(e){case"topPaste":return null;case"topKeyPress":return t.which&&!o(t)?String.fromCharCode(t.which):null;case"topCompositionEnd":return E?null:t.data;default:return null}}function f(e,t,n,r){var o;if(o=w?c(e,n):p(e,n),!o)return null;var i=g.getPooled(O.beforeInput,t,n,r);return i.data=o,d.accumulateTwoPhaseDispatches(i),i}var d=n(25),h=n(7),m=n(133),v=n(170),g=n(173),y=[9,13,27,32],b=229,C=h.canUseDOM&&"CompositionEvent"in window,_=null;h.canUseDOM&&"documentMode"in document&&(_=document.documentMode);var w=h.canUseDOM&&"TextEvent"in window&&!_&&!r(),E=h.canUseDOM&&(!C||_&&_>8&&_<=11),T=32,x=String.fromCharCode(T),O={beforeInput:{phasedRegistrationNames:{bubbled:"onBeforeInput",captured:"onBeforeInputCapture"},dependencies:["topCompositionEnd","topKeyPress","topTextInput","topPaste"]},compositionEnd:{phasedRegistrationNames:{bubbled:"onCompositionEnd",captured:"onCompositionEndCapture"},dependencies:["topBlur","topCompositionEnd","topKeyDown","topKeyPress","topKeyUp","topMouseDown"]},compositionStart:{phasedRegistrationNames:{bubbled:"onCompositionStart",captured:"onCompositionStartCapture"},dependencies:["topBlur","topCompositionStart","topKeyDown","topKeyPress","topKeyUp","topMouseDown"]},compositionUpdate:{phasedRegistrationNames:{bubbled:"onCompositionUpdate",captured:"onCompositionUpdateCapture"},dependencies:["topBlur","topCompositionUpdate","topKeyDown","topKeyPress","topKeyUp","topMouseDown"]}},P=!1,k=null,S={eventTypes:O,extractEvents:function(e,t,n,r){return[l(e,t,n,r),f(e,t,n,r)]}};e.exports=S},function(e,t,n){"use strict";var r=n(64),o=n(7),i=(n(9),n(102),n(179)),a=n(109),s=n(112),u=(n(2),s(function(e){return a(e)})),l=!1,c="cssFloat";if(o.canUseDOM){var p=document.createElement("div").style;try{p.font=""}catch(e){l=!0}void 0===document.documentElement.style.cssFloat&&(c="styleFloat")}var f={createMarkupForStyles:function(e,t){var n="";for(var r in e)if(e.hasOwnProperty(r)){var o=e[r];null!=o&&(n+=u(r)+":",n+=i(r,o,t)+";")}return n||null},setValueForStyles:function(e,t,n){var o=e.style;for(var a in t)if(t.hasOwnProperty(a)){var s=i(a,t[a],n);if("float"!==a&&"cssFloat"!==a||(a=c),s)o[a]=s;else{var u=l&&r.shorthandPropertyExpansions[a];if(u)for(var p in u)o[p]="";else o[a]=""}}}};e.exports=f},function(e,t,n){"use strict";function r(e){var t=e.nodeName&&e.nodeName.toLowerCase();return"select"===t||"input"===t&&"file"===e.type}function o(e){var t=T.getPooled(k.change,N,e,x(e));C.accumulateTwoPhaseDispatches(t),E.batchedUpdates(i,t)}function i(e){b.enqueueEvents(e),b.processEventQueue(!1)}function a(e,t){S=e,N=t,S.attachEvent("onchange",o)}function s(){S&&(S.detachEvent("onchange",o),S=null,N=null)}function u(e,t){if("topChange"===e)return t}function l(e,t,n){"topFocus"===e?(s(),a(t,n)):"topBlur"===e&&s()}function c(e,t){S=e,N=t,M=e.value,A=Object.getOwnPropertyDescriptor(e.constructor.prototype,"value"),Object.defineProperty(S,"value",R),S.attachEvent?S.attachEvent("onpropertychange",f):S.addEventListener("propertychange",f,!1)}function p(){S&&(delete S.value,S.detachEvent?S.detachEvent("onpropertychange",f):S.removeEventListener("propertychange",f,!1),S=null,N=null,M=null,A=null)}function f(e){if("value"===e.propertyName){var t=e.srcElement.value;t!==M&&(M=t,o(e))}}function d(e,t){if("topInput"===e)return t}function h(e,t,n){"topFocus"===e?(p(),c(t,n)):"topBlur"===e&&p()}function m(e,t){if(("topSelectionChange"===e||"topKeyUp"===e||"topKeyDown"===e)&&S&&S.value!==M)return M=S.value,N}function v(e){return e.nodeName&&"input"===e.nodeName.toLowerCase()&&("checkbox"===e.type||"radio"===e.type)}function g(e,t){if("topClick"===e)return t}function y(e,t){if(null!=e){var n=e._wrapperState||t._wrapperState;if(n&&n.controlled&&"number"===t.type){var r=""+t.value;t.getAttribute("value")!==r&&t.setAttribute("value",r)}}}var b=n(24),C=n(25),_=n(7),w=n(6),E=n(10),T=n(11),x=n(49),O=n(50),P=n(81),k={change:{phasedRegistrationNames:{bubbled:"onChange",captured:"onChangeCapture"},dependencies:["topBlur","topChange","topClick","topFocus","topInput","topKeyDown","topKeyUp","topSelectionChange"]}},S=null,N=null,M=null,A=null,I=!1;_.canUseDOM&&(I=O("change")&&(!document.documentMode||document.documentMode>8));var D=!1;_.canUseDOM&&(D=O("input")&&(!document.documentMode||document.documentMode>11));var R={get:function(){return A.get.call(this)},set:function(e){M=""+e,A.set.call(this,e)}},L={eventTypes:k,extractEvents:function(e,t,n,o){var i,a,s=t?w.getNodeFromInstance(t):window;if(r(s)?I?i=u:a=l:P(s)?D?i=d:(i=m,a=h):v(s)&&(i=g),i){var c=i(e,t);if(c){var p=T.getPooled(k.change,c,n,o);return p.type="change",C.accumulateTwoPhaseDispatches(p),p}}a&&a(e,s,t),"topBlur"===e&&y(t,s)}};e.exports=L},function(e,t,n){"use strict";var r=n(3),o=n(17),i=n(7),a=n(105),s=n(8),u=(n(1),{dangerouslyReplaceNodeWithMarkup:function(e,t){if(i.canUseDOM?void 0:r("56"),t?void 0:r("57"),"HTML"===e.nodeName?r("58"):void 0,"string"==typeof t){var n=a(t,s)[0];e.parentNode.replaceChild(n,e)}else o.replaceChildWithTree(e,t)}});e.exports=u},function(e,t){"use strict";var n=["ResponderEventPlugin","SimpleEventPlugin","TapEventPlugin","EnterLeaveEventPlugin","ChangeEventPlugin","SelectEventPlugin","BeforeInputEventPlugin"];e.exports=n},function(e,t,n){"use strict";var r=n(25),o=n(6),i=n(30),a={mouseEnter:{registrationName:"onMouseEnter",dependencies:["topMouseOut","topMouseOver"]},mouseLeave:{registrationName:"onMouseLeave",dependencies:["topMouseOut","topMouseOver"]}},s={eventTypes:a,extractEvents:function(e,t,n,s){if("topMouseOver"===e&&(n.relatedTarget||n.fromElement))return null;if("topMouseOut"!==e&&"topMouseOver"!==e)return null;var u;if(s.window===s)u=s;else{var l=s.ownerDocument;u=l?l.defaultView||l.parentWindow:window}var c,p;if("topMouseOut"===e){c=t;var f=n.relatedTarget||n.toElement;p=f?o.getClosestInstanceFromNode(f):null}else c=null,p=t;if(c===p)return null;var d=null==c?u:o.getNodeFromInstance(c),h=null==p?u:o.getNodeFromInstance(p),m=i.getPooled(a.mouseLeave,c,n,s);m.type="mouseleave",m.target=d,m.relatedTarget=h;var v=i.getPooled(a.mouseEnter,p,n,s);return v.type="mouseenter",v.target=h,v.relatedTarget=d,r.accumulateEnterLeaveDispatches(m,v,c,p),[m,v]}};e.exports=s},function(e,t,n){"use strict";function r(e){this._root=e,this._startText=this.getText(),this._fallbackText=null}var o=n(4),i=n(14),a=n(79);o(r.prototype,{destructor:function(){this._root=null,this._startText=null,this._fallbackText=null},getText:function(){return"value"in this._root?this._root.value:this._root[a()]},getData:function(){if(this._fallbackText)return this._fallbackText;var e,t,n=this._startText,r=n.length,o=this.getText(),i=o.length;for(e=0;e<r&&n[e]===o[e];e++);var a=r-e;for(t=1;t<=a&&n[r-t]===o[i-t];t++);var s=t>1?1-t:void 0;return this._fallbackText=o.slice(e,s),this._fallbackText}}),i.addPoolingTo(r),e.exports=r},function(e,t,n){"use strict";var r=n(18),o=r.injection.MUST_USE_PROPERTY,i=r.injection.HAS_BOOLEAN_VALUE,a=r.injection.HAS_NUMERIC_VALUE,s=r.injection.HAS_POSITIVE_NUMERIC_VALUE,u=r.injection.HAS_OVERLOADED_BOOLEAN_VALUE,l={isCustomAttribute:RegExp.prototype.test.bind(new RegExp("^(data|aria)-["+r.ATTRIBUTE_NAME_CHAR+"]*$")),Properties:{accept:0,acceptCharset:0,accessKey:0,action:0,allowFullScreen:i,allowTransparency:0,alt:0,as:0,async:i,autoComplete:0,autoPlay:i,capture:i,cellPadding:0,cellSpacing:0,charSet:0,challenge:0,checked:o|i,cite:0,classID:0,className:0,cols:s,colSpan:0,content:0,contentEditable:0,contextMenu:0,controls:i,coords:0,crossOrigin:0,data:0,dateTime:0,default:i,defer:i,dir:0,disabled:i,download:u,draggable:0,encType:0,form:0,formAction:0,formEncType:0,formMethod:0,formNoValidate:i,formTarget:0,frameBorder:0,headers:0,height:0,hidden:i,high:0,href:0,hrefLang:0,htmlFor:0,httpEquiv:0,icon:0,id:0,inputMode:0,integrity:0,is:0,keyParams:0,keyType:0,kind:0,label:0,lang:0,list:0,loop:i,low:0,manifest:0,marginHeight:0,marginWidth:0,max:0,maxLength:0,media:0,mediaGroup:0,method:0,min:0,minLength:0,multiple:o|i,muted:o|i,name:0,nonce:0,noValidate:i,open:i,optimum:0,pattern:0,placeholder:0,playsInline:i,poster:0,preload:0,profile:0,radioGroup:0,readOnly:i,referrerPolicy:0,rel:0,required:i,reversed:i,role:0,rows:s,rowSpan:a,sandbox:0,scope:0,scoped:i,scrolling:0,seamless:i,selected:o|i,shape:0,size:s,sizes:0,span:s,spellCheck:0,src:0,srcDoc:0,srcLang:0,srcSet:0,start:a,step:0,style:0,summary:0,tabIndex:0,target:0,title:0,type:0,useMap:0,value:0,width:0,wmode:0,wrap:0,about:0,datatype:0,inlist:0,prefix:0,property:0,resource:0,typeof:0,vocab:0,autoCapitalize:0,autoCorrect:0,autoSave:0,color:0,itemProp:0,itemScope:i,itemType:0,itemID:0,itemRef:0,results:0,security:0,unselectable:0},DOMAttributeNames:{acceptCharset:"accept-charset",className:"class",htmlFor:"for",httpEquiv:"http-equiv"},DOMPropertyNames:{},DOMMutationMethods:{value:function(e,t){return null==t?e.removeAttribute("value"):void("number"!==e.type||e.hasAttribute("value")===!1?e.setAttribute("value",""+t):e.validity&&!e.validity.badInput&&e.ownerDocument.activeElement!==e&&e.setAttribute("value",""+t))}}};e.exports=l},function(e,t,n){(function(t){"use strict";function r(e,t,n,r){var o=void 0===e[n];null!=t&&o&&(e[n]=i(t,!0))}var o=n(19),i=n(80),a=(n(41),n(51)),s=n(83),u=(n(2),{instantiateChildren:function(e,t,n,o){if(null==e)return null;var i={};return s(e,r,i),i},updateChildren:function(e,t,n,r,s,u,l,c,p){if(t||e){var f,d;for(f in t)if(t.hasOwnProperty(f)){d=e&&e[f];var h=d&&d._currentElement,m=t[f];if(null!=d&&a(h,m))o.receiveComponent(d,m,s,c),t[f]=d;else{d&&(r[f]=o.getHostNode(d),o.unmountComponent(d,!1));var v=i(m,!0);t[f]=v;var g=o.mountComponent(v,s,u,l,c,p);n.push(g)}}for(f in e)!e.hasOwnProperty(f)||t&&t.hasOwnProperty(f)||(d=e[f],r[f]=o.getHostNode(d),o.unmountComponent(d,!1))}},unmountChildren:function(e,t){for(var n in e)if(e.hasOwnProperty(n)){var r=e[n];o.unmountComponent(r,t)}}});e.exports=u}).call(t,n(60))},function(e,t,n){"use strict";var r=n(37),o=n(143),i={processChildrenUpdates:o.dangerouslyProcessChildrenUpdates,replaceNodeWithMarkup:r.dangerouslyReplaceNodeWithMarkup};e.exports=i},function(e,t,n){"use strict";function r(e){}function o(e,t){}function i(e){return!(!e.prototype||!e.prototype.isReactComponent)}function a(e){return!(!e.prototype||!e.prototype.isPureReactComponent)}var s=n(3),u=n(4),l=n(20),c=n(43),p=n(12),f=n(44),d=n(26),h=(n(9),n(74)),m=n(19),v=n(23),g=(n(1),n(36)),y=n(51),b=(n(2),{ImpureClass:0,PureClass:1,StatelessFunctional:2});r.prototype.render=function(){var e=d.get(this)._currentElement.type,t=e(this.props,this.context,this.updater);return o(e,t),t};var C=1,_={construct:function(e){this._currentElement=e,this._rootNodeID=0,this._compositeType=null,this._instance=null,this._hostParent=null,this._hostContainerInfo=null,this._updateBatchNumber=null,this._pendingElement=null,this._pendingStateQueue=null,this._pendingReplaceState=!1,this._pendingForceUpdate=!1,this._renderedNodeType=null,this._renderedComponent=null,this._context=null,this._mountOrder=0,this._topLevelWrapper=null,this._pendingCallbacks=null,this._calledComponentWillUnmount=!1},mountComponent:function(e,t,n,u){this._context=u,this._mountOrder=C++,this._hostParent=t,this._hostContainerInfo=n;var c,p=this._currentElement.props,f=this._processContext(u),h=this._currentElement.type,m=e.getUpdateQueue(),g=i(h),y=this._constructComponent(g,p,f,m);g||null!=y&&null!=y.render?a(h)?this._compositeType=b.PureClass:this._compositeType=b.ImpureClass:(c=y,o(h,c),null===y||y===!1||l.isValidElement(y)?void 0:s("105",h.displayName||h.name||"Component"),y=new r(h),this._compositeType=b.StatelessFunctional);y.props=p,y.context=f,y.refs=v,y.updater=m,this._instance=y,d.set(y,this);var _=y.state;void 0===_&&(y.state=_=null),"object"!=typeof _||Array.isArray(_)?s("106",this.getName()||"ReactCompositeComponent"):void 0,this._pendingStateQueue=null,this._pendingReplaceState=!1,this._pendingForceUpdate=!1;var w;return w=y.unstable_handleError?this.performInitialMountWithErrorHandling(c,t,n,e,u):this.performInitialMount(c,t,n,e,u),y.componentDidMount&&e.getReactMountReady().enqueue(y.componentDidMount,y),w},_constructComponent:function(e,t,n,r){return this._constructComponentWithoutOwner(e,t,n,r)},_constructComponentWithoutOwner:function(e,t,n,r){var o=this._currentElement.type;return e?new o(t,n,r):o(t,n,r)},performInitialMountWithErrorHandling:function(e,t,n,r,o){var i,a=r.checkpoint();try{i=this.performInitialMount(e,t,n,r,o)}catch(s){r.rollback(a),this._instance.unstable_handleError(s),this._pendingStateQueue&&(this._instance.state=this._processPendingState(this._instance.props,this._instance.context)),a=r.checkpoint(),this._renderedComponent.unmountComponent(!0),r.rollback(a),i=this.performInitialMount(e,t,n,r,o)}return i},performInitialMount:function(e,t,n,r,o){var i=this._instance,a=0;i.componentWillMount&&(i.componentWillMount(),this._pendingStateQueue&&(i.state=this._processPendingState(i.props,i.context))),void 0===e&&(e=this._renderValidatedComponent());var s=h.getType(e);this._renderedNodeType=s;
+var u=this._instantiateReactComponent(e,s!==h.EMPTY);this._renderedComponent=u;var l=m.mountComponent(u,r,t,n,this._processChildContext(o),a);return l},getHostNode:function(){return m.getHostNode(this._renderedComponent)},unmountComponent:function(e){if(this._renderedComponent){var t=this._instance;if(t.componentWillUnmount&&!t._calledComponentWillUnmount)if(t._calledComponentWillUnmount=!0,e){var n=this.getName()+".componentWillUnmount()";f.invokeGuardedCallback(n,t.componentWillUnmount.bind(t))}else t.componentWillUnmount();this._renderedComponent&&(m.unmountComponent(this._renderedComponent,e),this._renderedNodeType=null,this._renderedComponent=null,this._instance=null),this._pendingStateQueue=null,this._pendingReplaceState=!1,this._pendingForceUpdate=!1,this._pendingCallbacks=null,this._pendingElement=null,this._context=null,this._rootNodeID=0,this._topLevelWrapper=null,d.remove(t)}},_maskContext:function(e){var t=this._currentElement.type,n=t.contextTypes;if(!n)return v;var r={};for(var o in n)r[o]=e[o];return r},_processContext:function(e){var t=this._maskContext(e);return t},_processChildContext:function(e){var t,n=this._currentElement.type,r=this._instance;if(r.getChildContext&&(t=r.getChildContext()),t){"object"!=typeof n.childContextTypes?s("107",this.getName()||"ReactCompositeComponent"):void 0;for(var o in t)o in n.childContextTypes?void 0:s("108",this.getName()||"ReactCompositeComponent",o);return u({},e,t)}return e},_checkContextTypes:function(e,t,n){},receiveComponent:function(e,t,n){var r=this._currentElement,o=this._context;this._pendingElement=null,this.updateComponent(t,r,e,o,n)},performUpdateIfNecessary:function(e){null!=this._pendingElement?m.receiveComponent(this,this._pendingElement,e,this._context):null!==this._pendingStateQueue||this._pendingForceUpdate?this.updateComponent(e,this._currentElement,this._currentElement,this._context,this._context):this._updateBatchNumber=null},updateComponent:function(e,t,n,r,o){var i=this._instance;null==i?s("136",this.getName()||"ReactCompositeComponent"):void 0;var a,u=!1;this._context===o?a=i.context:(a=this._processContext(o),u=!0);var l=t.props,c=n.props;t!==n&&(u=!0),u&&i.componentWillReceiveProps&&i.componentWillReceiveProps(c,a);var p=this._processPendingState(c,a),f=!0;this._pendingForceUpdate||(i.shouldComponentUpdate?f=i.shouldComponentUpdate(c,p,a):this._compositeType===b.PureClass&&(f=!g(l,c)||!g(i.state,p))),this._updateBatchNumber=null,f?(this._pendingForceUpdate=!1,this._performComponentUpdate(n,c,p,a,e,o)):(this._currentElement=n,this._context=o,i.props=c,i.state=p,i.context=a)},_processPendingState:function(e,t){var n=this._instance,r=this._pendingStateQueue,o=this._pendingReplaceState;if(this._pendingReplaceState=!1,this._pendingStateQueue=null,!r)return n.state;if(o&&1===r.length)return r[0];for(var i=u({},o?r[0]:n.state),a=o?1:0;a<r.length;a++){var s=r[a];u(i,"function"==typeof s?s.call(n,i,e,t):s)}return i},_performComponentUpdate:function(e,t,n,r,o,i){var a,s,u,l=this._instance,c=Boolean(l.componentDidUpdate);c&&(a=l.props,s=l.state,u=l.context),l.componentWillUpdate&&l.componentWillUpdate(t,n,r),this._currentElement=e,this._context=i,l.props=t,l.state=n,l.context=r,this._updateRenderedComponent(o,i),c&&o.getReactMountReady().enqueue(l.componentDidUpdate.bind(l,a,s,u),l)},_updateRenderedComponent:function(e,t){var n=this._renderedComponent,r=n._currentElement,o=this._renderValidatedComponent(),i=0;if(y(r,o))m.receiveComponent(n,o,e,this._processChildContext(t));else{var a=m.getHostNode(n);m.unmountComponent(n,!1);var s=h.getType(o);this._renderedNodeType=s;var u=this._instantiateReactComponent(o,s!==h.EMPTY);this._renderedComponent=u;var l=m.mountComponent(u,e,this._hostParent,this._hostContainerInfo,this._processChildContext(t),i);this._replaceNodeWithMarkup(a,l,n)}},_replaceNodeWithMarkup:function(e,t,n){c.replaceNodeWithMarkup(e,t,n)},_renderValidatedComponentWithoutOwnerOrContext:function(){var e,t=this._instance;return e=t.render()},_renderValidatedComponent:function(){var e;if(this._compositeType!==b.StatelessFunctional){p.current=this;try{e=this._renderValidatedComponentWithoutOwnerOrContext()}finally{p.current=null}}else e=this._renderValidatedComponentWithoutOwnerOrContext();return null===e||e===!1||l.isValidElement(e)?void 0:s("109",this.getName()||"ReactCompositeComponent"),e},attachRef:function(e,t){var n=this.getPublicInstance();null==n?s("110"):void 0;var r=t.getPublicInstance(),o=n.refs===v?n.refs={}:n.refs;o[e]=r},detachRef:function(e){var t=this.getPublicInstance().refs;delete t[e]},getName:function(){var e=this._currentElement.type,t=this._instance&&this._instance.constructor;return e.displayName||t&&t.displayName||e.name||t&&t.name||null},getPublicInstance:function(){var e=this._instance;return this._compositeType===b.StatelessFunctional?null:e},_instantiateReactComponent:null};e.exports=_},function(e,t,n){"use strict";var r=n(6),o=n(151),i=n(73),a=n(19),s=n(10),u=n(164),l=n(180),c=n(78),p=n(187);n(2);o.inject();var f={findDOMNode:l,render:i.render,unmountComponentAtNode:i.unmountComponentAtNode,version:u,unstable_batchedUpdates:s.batchedUpdates,unstable_renderSubtreeIntoContainer:p};"undefined"!=typeof __REACT_DEVTOOLS_GLOBAL_HOOK__&&"function"==typeof __REACT_DEVTOOLS_GLOBAL_HOOK__.inject&&__REACT_DEVTOOLS_GLOBAL_HOOK__.inject({ComponentTree:{getClosestInstanceFromNode:r.getClosestInstanceFromNode,getNodeFromInstance:function(e){return e._renderedComponent&&(e=c(e)),e?r.getNodeFromInstance(e):null}},Mount:i,Reconciler:a});e.exports=f},function(e,t,n){"use strict";function r(e){if(e){var t=e._currentElement._owner||null;if(t){var n=t.getName();if(n)return" This DOM node was rendered by `"+n+"`."}}return""}function o(e,t){t&&(X[e._tag]&&(null!=t.children||null!=t.dangerouslySetInnerHTML?m("137",e._tag,e._currentElement._owner?" Check the render method of "+e._currentElement._owner.getName()+".":""):void 0),null!=t.dangerouslySetInnerHTML&&(null!=t.children?m("60"):void 0,"object"==typeof t.dangerouslySetInnerHTML&&W in t.dangerouslySetInnerHTML?void 0:m("61")),null!=t.style&&"object"!=typeof t.style?m("62",r(e)):void 0)}function i(e,t,n,r){if(!(r instanceof I)){var o=e._hostContainerInfo,i=o._node&&o._node.nodeType===q,s=i?o._node:o._ownerDocument;F(t,s),r.getReactMountReady().enqueue(a,{inst:e,registrationName:t,listener:n})}}function a(){var e=this;E.putListener(e.inst,e.registrationName,e.listener)}function s(){var e=this;k.postMountWrapper(e)}function u(){var e=this;M.postMountWrapper(e)}function l(){var e=this;S.postMountWrapper(e)}function c(){var e=this;e._rootNodeID?void 0:m("63");var t=U(e);switch(t?void 0:m("64"),e._tag){case"iframe":case"object":e._wrapperState.listeners=[x.trapBubbledEvent("topLoad","load",t)];break;case"video":case"audio":e._wrapperState.listeners=[];for(var n in z)z.hasOwnProperty(n)&&e._wrapperState.listeners.push(x.trapBubbledEvent(n,z[n],t));break;case"source":e._wrapperState.listeners=[x.trapBubbledEvent("topError","error",t)];break;case"img":e._wrapperState.listeners=[x.trapBubbledEvent("topError","error",t),x.trapBubbledEvent("topLoad","load",t)];break;case"form":e._wrapperState.listeners=[x.trapBubbledEvent("topReset","reset",t),x.trapBubbledEvent("topSubmit","submit",t)];break;case"input":case"select":case"textarea":e._wrapperState.listeners=[x.trapBubbledEvent("topInvalid","invalid",t)]}}function p(){N.postUpdateWrapper(this)}function f(e){$.call(Q,e)||(G.test(e)?void 0:m("65",e),Q[e]=!0)}function d(e,t){return e.indexOf("-")>=0||null!=t.is}function h(e){var t=e.type;f(t),this._currentElement=e,this._tag=t.toLowerCase(),this._namespaceURI=null,this._renderedChildren=null,this._previousStyle=null,this._previousStyleCopy=null,this._hostNode=null,this._hostParent=null,this._rootNodeID=0,this._domID=0,this._hostContainerInfo=null,this._wrapperState=null,this._topLevelWrapper=null,this._flags=0}var m=n(3),v=n(4),g=n(126),y=n(128),b=n(17),C=n(38),_=n(18),w=n(66),E=n(24),T=n(39),x=n(29),O=n(67),P=n(6),k=n(144),S=n(145),N=n(68),M=n(148),A=(n(9),n(157)),I=n(162),D=(n(8),n(32)),R=(n(1),n(50),n(36),n(52),n(2),O),L=E.deleteListener,U=P.getNodeFromInstance,F=x.listenTo,j=T.registrationNameModules,B={string:!0,number:!0},V="style",W="__html",H={children:null,dangerouslySetInnerHTML:null,suppressContentEditableWarning:null},q=11,z={topAbort:"abort",topCanPlay:"canplay",topCanPlayThrough:"canplaythrough",topDurationChange:"durationchange",topEmptied:"emptied",topEncrypted:"encrypted",topEnded:"ended",topError:"error",topLoadedData:"loadeddata",topLoadedMetadata:"loadedmetadata",topLoadStart:"loadstart",topPause:"pause",topPlay:"play",topPlaying:"playing",topProgress:"progress",topRateChange:"ratechange",topSeeked:"seeked",topSeeking:"seeking",topStalled:"stalled",topSuspend:"suspend",topTimeUpdate:"timeupdate",topVolumeChange:"volumechange",topWaiting:"waiting"},K={area:!0,base:!0,br:!0,col:!0,embed:!0,hr:!0,img:!0,input:!0,keygen:!0,link:!0,meta:!0,param:!0,source:!0,track:!0,wbr:!0},Y={listing:!0,pre:!0,textarea:!0},X=v({menuitem:!0},K),G=/^[a-zA-Z][a-zA-Z:_\.\-\d]*$/,Q={},$={}.hasOwnProperty,Z=1;h.displayName="ReactDOMComponent",h.Mixin={mountComponent:function(e,t,n,r){this._rootNodeID=Z++,this._domID=n._idCounter++,this._hostParent=t,this._hostContainerInfo=n;var i=this._currentElement.props;switch(this._tag){case"audio":case"form":case"iframe":case"img":case"link":case"object":case"source":case"video":this._wrapperState={listeners:null},e.getReactMountReady().enqueue(c,this);break;case"input":k.mountWrapper(this,i,t),i=k.getHostProps(this,i),e.getReactMountReady().enqueue(c,this);break;case"option":S.mountWrapper(this,i,t),i=S.getHostProps(this,i);break;case"select":N.mountWrapper(this,i,t),i=N.getHostProps(this,i),e.getReactMountReady().enqueue(c,this);break;case"textarea":M.mountWrapper(this,i,t),i=M.getHostProps(this,i),e.getReactMountReady().enqueue(c,this)}o(this,i);var a,p;null!=t?(a=t._namespaceURI,p=t._tag):n._tag&&(a=n._namespaceURI,p=n._tag),(null==a||a===C.svg&&"foreignobject"===p)&&(a=C.html),a===C.html&&("svg"===this._tag?a=C.svg:"math"===this._tag&&(a=C.mathml)),this._namespaceURI=a;var f;if(e.useCreateElement){var d,h=n._ownerDocument;if(a===C.html)if("script"===this._tag){var m=h.createElement("div"),v=this._currentElement.type;m.innerHTML="<"+v+"></"+v+">",d=m.removeChild(m.firstChild)}else d=i.is?h.createElement(this._currentElement.type,i.is):h.createElement(this._currentElement.type);else d=h.createElementNS(a,this._currentElement.type);P.precacheNode(this,d),this._flags|=R.hasCachedChildNodes,this._hostParent||w.setAttributeForRoot(d),this._updateDOMProperties(null,i,e);var y=b(d);this._createInitialChildren(e,i,r,y),f=y}else{var _=this._createOpenTagMarkupAndPutListeners(e,i),E=this._createContentMarkup(e,i,r);f=!E&&K[this._tag]?_+"/>":_+">"+E+"</"+this._currentElement.type+">"}switch(this._tag){case"input":e.getReactMountReady().enqueue(s,this),i.autoFocus&&e.getReactMountReady().enqueue(g.focusDOMComponent,this);break;case"textarea":e.getReactMountReady().enqueue(u,this),i.autoFocus&&e.getReactMountReady().enqueue(g.focusDOMComponent,this);break;case"select":i.autoFocus&&e.getReactMountReady().enqueue(g.focusDOMComponent,this);break;case"button":i.autoFocus&&e.getReactMountReady().enqueue(g.focusDOMComponent,this);break;case"option":e.getReactMountReady().enqueue(l,this)}return f},_createOpenTagMarkupAndPutListeners:function(e,t){var n="<"+this._currentElement.type;for(var r in t)if(t.hasOwnProperty(r)){var o=t[r];if(null!=o)if(j.hasOwnProperty(r))o&&i(this,r,o,e);else{r===V&&(o&&(o=this._previousStyleCopy=v({},t.style)),o=y.createMarkupForStyles(o,this));var a=null;null!=this._tag&&d(this._tag,t)?H.hasOwnProperty(r)||(a=w.createMarkupForCustomAttribute(r,o)):a=w.createMarkupForProperty(r,o),a&&(n+=" "+a)}}return e.renderToStaticMarkup?n:(this._hostParent||(n+=" "+w.createMarkupForRoot()),n+=" "+w.createMarkupForID(this._domID))},_createContentMarkup:function(e,t,n){var r="",o=t.dangerouslySetInnerHTML;if(null!=o)null!=o.__html&&(r=o.__html);else{var i=B[typeof t.children]?t.children:null,a=null!=i?null:t.children;if(null!=i)r=D(i);else if(null!=a){var s=this.mountChildren(a,e,n);r=s.join("")}}return Y[this._tag]&&"\n"===r.charAt(0)?"\n"+r:r},_createInitialChildren:function(e,t,n,r){var o=t.dangerouslySetInnerHTML;if(null!=o)null!=o.__html&&b.queueHTML(r,o.__html);else{var i=B[typeof t.children]?t.children:null,a=null!=i?null:t.children;if(null!=i)""!==i&&b.queueText(r,i);else if(null!=a)for(var s=this.mountChildren(a,e,n),u=0;u<s.length;u++)b.queueChild(r,s[u])}},receiveComponent:function(e,t,n){var r=this._currentElement;this._currentElement=e,this.updateComponent(t,r,e,n)},updateComponent:function(e,t,n,r){var i=t.props,a=this._currentElement.props;switch(this._tag){case"input":i=k.getHostProps(this,i),a=k.getHostProps(this,a);break;case"option":i=S.getHostProps(this,i),a=S.getHostProps(this,a);break;case"select":i=N.getHostProps(this,i),a=N.getHostProps(this,a);break;case"textarea":i=M.getHostProps(this,i),a=M.getHostProps(this,a)}switch(o(this,a),this._updateDOMProperties(i,a,e),this._updateDOMChildren(i,a,e,r),this._tag){case"input":k.updateWrapper(this);break;case"textarea":M.updateWrapper(this);break;case"select":e.getReactMountReady().enqueue(p,this)}},_updateDOMProperties:function(e,t,n){var r,o,a;for(r in e)if(!t.hasOwnProperty(r)&&e.hasOwnProperty(r)&&null!=e[r])if(r===V){var s=this._previousStyleCopy;for(o in s)s.hasOwnProperty(o)&&(a=a||{},a[o]="");this._previousStyleCopy=null}else j.hasOwnProperty(r)?e[r]&&L(this,r):d(this._tag,e)?H.hasOwnProperty(r)||w.deleteValueForAttribute(U(this),r):(_.properties[r]||_.isCustomAttribute(r))&&w.deleteValueForProperty(U(this),r);for(r in t){var u=t[r],l=r===V?this._previousStyleCopy:null!=e?e[r]:void 0;if(t.hasOwnProperty(r)&&u!==l&&(null!=u||null!=l))if(r===V)if(u?u=this._previousStyleCopy=v({},u):this._previousStyleCopy=null,l){for(o in l)!l.hasOwnProperty(o)||u&&u.hasOwnProperty(o)||(a=a||{},a[o]="");for(o in u)u.hasOwnProperty(o)&&l[o]!==u[o]&&(a=a||{},a[o]=u[o])}else a=u;else if(j.hasOwnProperty(r))u?i(this,r,u,n):l&&L(this,r);else if(d(this._tag,t))H.hasOwnProperty(r)||w.setValueForAttribute(U(this),r,u);else if(_.properties[r]||_.isCustomAttribute(r)){var c=U(this);null!=u?w.setValueForProperty(c,r,u):w.deleteValueForProperty(c,r)}}a&&y.setValueForStyles(U(this),a,this)},_updateDOMChildren:function(e,t,n,r){var o=B[typeof e.children]?e.children:null,i=B[typeof t.children]?t.children:null,a=e.dangerouslySetInnerHTML&&e.dangerouslySetInnerHTML.__html,s=t.dangerouslySetInnerHTML&&t.dangerouslySetInnerHTML.__html,u=null!=o?null:e.children,l=null!=i?null:t.children,c=null!=o||null!=a,p=null!=i||null!=s;null!=u&&null==l?this.updateChildren(null,n,r):c&&!p&&this.updateTextContent(""),null!=i?o!==i&&this.updateTextContent(""+i):null!=s?a!==s&&this.updateMarkup(""+s):null!=l&&this.updateChildren(l,n,r)},getHostNode:function(){return U(this)},unmountComponent:function(e){switch(this._tag){case"audio":case"form":case"iframe":case"img":case"link":case"object":case"source":case"video":var t=this._wrapperState.listeners;if(t)for(var n=0;n<t.length;n++)t[n].remove();break;case"html":case"head":case"body":m("66",this._tag)}this.unmountChildren(e),P.uncacheNode(this),E.deleteAllListeners(this),this._rootNodeID=0,this._domID=0,this._wrapperState=null},getPublicInstance:function(){return U(this)}},v(h.prototype,h.Mixin,A.Mixin),e.exports=h},function(e,t,n){"use strict";function r(e,t){var n={_topLevelWrapper:e,_idCounter:1,_ownerDocument:t?t.nodeType===o?t:t.ownerDocument:null,_node:t,_tag:t?t.nodeName.toLowerCase():null,_namespaceURI:t?t.namespaceURI:null};return n}var o=(n(52),9);e.exports=r},function(e,t,n){"use strict";var r=n(4),o=n(17),i=n(6),a=function(e){this._currentElement=null,this._hostNode=null,this._hostParent=null,this._hostContainerInfo=null,this._domID=0};r(a.prototype,{mountComponent:function(e,t,n,r){var a=n._idCounter++;this._domID=a,this._hostParent=t,this._hostContainerInfo=n;var s=" react-empty: "+this._domID+" ";if(e.useCreateElement){var u=n._ownerDocument,l=u.createComment(s);return i.precacheNode(this,l),o(l)}return e.renderToStaticMarkup?"":"<!--"+s+"-->"},receiveComponent:function(){},getHostNode:function(){return i.getNodeFromInstance(this)},unmountComponent:function(){i.uncacheNode(this)}}),e.exports=a},function(e,t){"use strict";var n={useCreateElement:!0,useFiber:!1};e.exports=n},function(e,t,n){"use strict";var r=n(37),o=n(6),i={dangerouslyProcessChildrenUpdates:function(e,t){var n=o.getNodeFromInstance(e);r.processUpdates(n,t)}};e.exports=i},function(e,t,n){"use strict";function r(){this._rootNodeID&&f.updateWrapper(this)}function o(e){var t="checkbox"===e.type||"radio"===e.type;return t?null!=e.checked:null!=e.value}function i(e){var t=this._currentElement.props,n=l.executeOnChange(t,e);p.asap(r,this);var o=t.name;if("radio"===t.type&&null!=o){for(var i=c.getNodeFromInstance(this),s=i;s.parentNode;)s=s.parentNode;for(var u=s.querySelectorAll("input[name="+JSON.stringify(""+o)+'][type="radio"]'),f=0;f<u.length;f++){var d=u[f];if(d!==i&&d.form===i.form){var h=c.getInstanceFromNode(d);h?void 0:a("90"),p.asap(r,h)}}}return n}var a=n(3),s=n(4),u=n(66),l=n(42),c=n(6),p=n(10),f=(n(1),n(2),{getHostProps:function(e,t){var n=l.getValue(t),r=l.getChecked(t),o=s({type:void 0,step:void 0,min:void 0,max:void 0},t,{defaultChecked:void 0,defaultValue:void 0,value:null!=n?n:e._wrapperState.initialValue,checked:null!=r?r:e._wrapperState.initialChecked,onChange:e._wrapperState.onChange});return o},mountWrapper:function(e,t){var n=t.defaultValue;e._wrapperState={initialChecked:null!=t.checked?t.checked:t.defaultChecked,initialValue:null!=t.value?t.value:n,listeners:null,onChange:i.bind(e),controlled:o(t)}},updateWrapper:function(e){var t=e._currentElement.props,n=t.checked;null!=n&&u.setValueForProperty(c.getNodeFromInstance(e),"checked",n||!1);var r=c.getNodeFromInstance(e),o=l.getValue(t);if(null!=o)if(0===o&&""===r.value)r.value="0";else if("number"===t.type){var i=parseFloat(r.value,10)||0;o!=i&&(r.value=""+o)}else o!=r.value&&(r.value=""+o);else null==t.value&&null!=t.defaultValue&&r.defaultValue!==""+t.defaultValue&&(r.defaultValue=""+t.defaultValue),null==t.checked&&null!=t.defaultChecked&&(r.defaultChecked=!!t.defaultChecked)},postMountWrapper:function(e){var t=e._currentElement.props,n=c.getNodeFromInstance(e);switch(t.type){case"submit":case"reset":break;case"color":case"date":case"datetime":case"datetime-local":case"month":case"time":case"week":n.value="",n.value=n.defaultValue;break;default:n.value=n.value}var r=n.name;""!==r&&(n.name=""),n.defaultChecked=!n.defaultChecked,n.defaultChecked=!n.defaultChecked,""!==r&&(n.name=r)}});e.exports=f},function(e,t,n){"use strict";function r(e){var t="";return i.Children.forEach(e,function(e){null!=e&&("string"==typeof e||"number"==typeof e?t+=e:u||(u=!0))}),t}var o=n(4),i=n(20),a=n(6),s=n(68),u=(n(2),!1),l={mountWrapper:function(e,t,n){var o=null;if(null!=n){var i=n;"optgroup"===i._tag&&(i=i._hostParent),null!=i&&"select"===i._tag&&(o=s.getSelectValueContext(i))}var a=null;if(null!=o){var u;if(u=null!=t.value?t.value+"":r(t.children),a=!1,Array.isArray(o)){for(var l=0;l<o.length;l++)if(""+o[l]===u){a=!0;break}}else a=""+o===u}e._wrapperState={selected:a}},postMountWrapper:function(e){var t=e._currentElement.props;if(null!=t.value){var n=a.getNodeFromInstance(e);n.setAttribute("value",t.value)}},getHostProps:function(e,t){var n=o({selected:void 0,children:void 0},t);null!=e._wrapperState.selected&&(n.selected=e._wrapperState.selected);var i=r(t.children);return i&&(n.children=i),n}};e.exports=l},function(e,t,n){"use strict";function r(e,t,n,r){return e===n&&t===r}function o(e){var t=document.selection,n=t.createRange(),r=n.text.length,o=n.duplicate();o.moveToElementText(e),o.setEndPoint("EndToStart",n);var i=o.text.length,a=i+r;return{start:i,end:a}}function i(e){var t=window.getSelection&&window.getSelection();if(!t||0===t.rangeCount)return null;var n=t.anchorNode,o=t.anchorOffset,i=t.focusNode,a=t.focusOffset,s=t.getRangeAt(0);try{s.startContainer.nodeType,s.endContainer.nodeType}catch(e){return null}var u=r(t.anchorNode,t.anchorOffset,t.focusNode,t.focusOffset),l=u?0:s.toString().length,c=s.cloneRange();c.selectNodeContents(e),c.setEnd(s.startContainer,s.startOffset);var p=r(c.startContainer,c.startOffset,c.endContainer,c.endOffset),f=p?0:c.toString().length,d=f+l,h=document.createRange();h.setStart(n,o),h.setEnd(i,a);var m=h.collapsed;return{start:m?d:f,end:m?f:d}}function a(e,t){var n,r,o=document.selection.createRange().duplicate();void 0===t.end?(n=t.start,r=n):t.start>t.end?(n=t.end,r=t.start):(n=t.start,r=t.end),o.moveToElementText(e),o.moveStart("character",n),o.setEndPoint("EndToStart",o),o.moveEnd("character",r-n),o.select()}function s(e,t){if(window.getSelection){var n=window.getSelection(),r=e[c()].length,o=Math.min(t.start,r),i=void 0===t.end?o:Math.min(t.end,r);if(!n.extend&&o>i){var a=i;i=o,o=a}var s=l(e,o),u=l(e,i);if(s&&u){var p=document.createRange();p.setStart(s.node,s.offset),n.removeAllRanges(),o>i?(n.addRange(p),n.extend(u.node,u.offset)):(p.setEnd(u.node,u.offset),n.addRange(p))}}}var u=n(7),l=n(184),c=n(79),p=u.canUseDOM&&"selection"in document&&!("getSelection"in window),f={getOffsets:p?o:i,setOffsets:p?a:s};e.exports=f},function(e,t,n){"use strict";var r=n(3),o=n(4),i=n(37),a=n(17),s=n(6),u=n(32),l=(n(1),n(52),function(e){this._currentElement=e,this._stringText=""+e,this._hostNode=null,this._hostParent=null,this._domID=0,this._mountIndex=0,this._closingComment=null,this._commentNodes=null});o(l.prototype,{mountComponent:function(e,t,n,r){var o=n._idCounter++,i=" react-text: "+o+" ",l=" /react-text ";if(this._domID=o,this._hostParent=t,e.useCreateElement){var c=n._ownerDocument,p=c.createComment(i),f=c.createComment(l),d=a(c.createDocumentFragment());return a.queueChild(d,a(p)),this._stringText&&a.queueChild(d,a(c.createTextNode(this._stringText))),a.queueChild(d,a(f)),s.precacheNode(this,p),this._closingComment=f,d}var h=u(this._stringText);return e.renderToStaticMarkup?h:"<!--"+i+"-->"+h+"<!--"+l+"-->"},receiveComponent:function(e,t){if(e!==this._currentElement){this._currentElement=e;var n=""+e;if(n!==this._stringText){this._stringText=n;var r=this.getHostNode();i.replaceDelimitedText(r[0],r[1],n)}}},getHostNode:function(){var e=this._commentNodes;if(e)return e;if(!this._closingComment)for(var t=s.getNodeFromInstance(this),n=t.nextSibling;;){if(null==n?r("67",this._domID):void 0,8===n.nodeType&&" /react-text "===n.nodeValue){this._closingComment=n;break}n=n.nextSibling}return e=[this._hostNode,this._closingComment],this._commentNodes=e,e},unmountComponent:function(){this._closingComment=null,this._commentNodes=null,s.uncacheNode(this)}}),e.exports=l},function(e,t,n){"use strict";function r(){this._rootNodeID&&c.updateWrapper(this)}function o(e){var t=this._currentElement.props,n=s.executeOnChange(t,e);return l.asap(r,this),n}var i=n(3),a=n(4),s=n(42),u=n(6),l=n(10),c=(n(1),n(2),{getHostProps:function(e,t){null!=t.dangerouslySetInnerHTML?i("91"):void 0;var n=a({},t,{value:void 0,defaultValue:void 0,children:""+e._wrapperState.initialValue,onChange:e._wrapperState.onChange});return n},mountWrapper:function(e,t){var n=s.getValue(t),r=n;if(null==n){var a=t.defaultValue,u=t.children;null!=u&&(null!=a?i("92"):void 0,Array.isArray(u)&&(u.length<=1?void 0:i("93"),u=u[0]),a=""+u),null==a&&(a=""),r=a}e._wrapperState={initialValue:""+r,listeners:null,onChange:o.bind(e)}},updateWrapper:function(e){var t=e._currentElement.props,n=u.getNodeFromInstance(e),r=s.getValue(t);if(null!=r){var o=""+r;o!==n.value&&(n.value=o),null==t.defaultValue&&(n.defaultValue=o)}null!=t.defaultValue&&(n.defaultValue=t.defaultValue)},postMountWrapper:function(e){var t=u.getNodeFromInstance(e),n=t.textContent;n===e._wrapperState.initialValue&&(t.value=n)}});e.exports=c},function(e,t,n){"use strict";function r(e,t){"_hostNode"in e?void 0:u("33"),"_hostNode"in t?void 0:u("33");for(var n=0,r=e;r;r=r._hostParent)n++;for(var o=0,i=t;i;i=i._hostParent)o++;for(;n-o>0;)e=e._hostParent,n--;for(;o-n>0;)t=t._hostParent,o--;for(var a=n;a--;){if(e===t)return e;e=e._hostParent,t=t._hostParent}return null}function o(e,t){"_hostNode"in e?void 0:u("35"),"_hostNode"in t?void 0:u("35");for(;t;){if(t===e)return!0;t=t._hostParent}return!1}function i(e){return"_hostNode"in e?void 0:u("36"),e._hostParent}function a(e,t,n){for(var r=[];e;)r.push(e),e=e._hostParent;var o;for(o=r.length;o-- >0;)t(r[o],"captured",n);for(o=0;o<r.length;o++)t(r[o],"bubbled",n)}function s(e,t,n,o,i){for(var a=e&&t?r(e,t):null,s=[];e&&e!==a;)s.push(e),e=e._hostParent;for(var u=[];t&&t!==a;)u.push(t),t=t._hostParent;var l;for(l=0;l<s.length;l++)n(s[l],"bubbled",o);for(l=u.length;l-- >0;)n(u[l],"captured",i)}var u=n(3);n(1);e.exports={isAncestor:o,getLowestCommonAncestor:r,getParentInstance:i,traverseTwoPhase:a,traverseEnterLeave:s}},function(e,t,n){"use strict";function r(){this.reinitializeTransaction()}var o=n(4),i=n(10),a=n(31),s=n(8),u={initialize:s,close:function(){f.isBatchingUpdates=!1}},l={initialize:s,close:i.flushBatchedUpdates.bind(i)},c=[l,u];o(r.prototype,a,{getTransactionWrappers:function(){return c}});var p=new r,f={isBatchingUpdates:!1,batchedUpdates:function(e,t,n,r,o,i){var a=f.isBatchingUpdates;return f.isBatchingUpdates=!0,a?e(t,n,r,o,i):p.perform(e,null,t,n,r,o,i)}};e.exports=f},function(e,t,n){"use strict";function r(){E||(E=!0,y.EventEmitter.injectReactEventListener(g),y.EventPluginHub.injectEventPluginOrder(s),y.EventPluginUtils.injectComponentTree(f),y.EventPluginUtils.injectTreeTraversal(h),y.EventPluginHub.injectEventPluginsByName({SimpleEventPlugin:w,EnterLeaveEventPlugin:u,ChangeEventPlugin:a,SelectEventPlugin:_,BeforeInputEventPlugin:i}),y.HostComponent.injectGenericComponentClass(p),y.HostComponent.injectTextComponentClass(m),y.DOMProperty.injectDOMPropertyConfig(o),y.DOMProperty.injectDOMPropertyConfig(l),y.DOMProperty.injectDOMPropertyConfig(C),y.EmptyComponent.injectEmptyComponentFactory(function(e){return new d(e)}),y.Updates.injectReconcileTransaction(b),y.Updates.injectBatchingStrategy(v),y.Component.injectEnvironment(c))}var o=n(125),i=n(127),a=n(129),s=n(131),u=n(132),l=n(134),c=n(136),p=n(139),f=n(6),d=n(141),h=n(149),m=n(147),v=n(150),g=n(154),y=n(155),b=n(160),C=n(165),_=n(166),w=n(167),E=!1;e.exports={inject:r}},88,function(e,t,n){"use strict";function r(e){o.enqueueEvents(e),o.processEventQueue(!1)}var o=n(24),i={handleTopLevel:function(e,t,n,i){var a=o.extractEvents(e,t,n,i);r(a)}};e.exports=i},function(e,t,n){"use strict";function r(e){for(;e._hostParent;)e=e._hostParent;var t=p.getNodeFromInstance(e),n=t.parentNode;return p.getClosestInstanceFromNode(n)}function o(e,t){this.topLevelType=e,this.nativeEvent=t,this.ancestors=[]}function i(e){var t=d(e.nativeEvent),n=p.getClosestInstanceFromNode(t),o=n;do e.ancestors.push(o),o=o&&r(o);while(o);for(var i=0;i<e.ancestors.length;i++)n=e.ancestors[i],m._handleTopLevel(e.topLevelType,n,e.nativeEvent,d(e.nativeEvent))}function a(e){var t=h(window);e(t)}var s=n(4),u=n(57),l=n(7),c=n(14),p=n(6),f=n(10),d=n(49),h=n(107);s(o.prototype,{destructor:function(){this.topLevelType=null,this.nativeEvent=null,this.ancestors.length=0}}),c.addPoolingTo(o,c.twoArgumentPooler);var m={_enabled:!0,_handleTopLevel:null,WINDOW_HANDLE:l.canUseDOM?window:null,setHandleTopLevel:function(e){m._handleTopLevel=e},setEnabled:function(e){m._enabled=!!e},isEnabled:function(){return m._enabled},trapBubbledEvent:function(e,t,n){return n?u.listen(n,t,m.dispatchEvent.bind(null,e)):null},trapCapturedEvent:function(e,t,n){return n?u.capture(n,t,m.dispatchEvent.bind(null,e)):null},monitorScrollValue:function(e){var t=a.bind(null,e);u.listen(window,"scroll",t)},dispatchEvent:function(e,t){if(m._enabled){var n=o.getPooled(e,t);try{f.batchedUpdates(i,n)}finally{o.release(n)}}}};e.exports=m},function(e,t,n){"use strict";var r=n(18),o=n(24),i=n(40),a=n(43),s=n(69),u=n(29),l=n(71),c=n(10),p={Component:a.injection,DOMProperty:r.injection,EmptyComponent:s.injection,EventPluginHub:o.injection,EventPluginUtils:i.injection,EventEmitter:u.injection,HostComponent:l.injection,Updates:c.injection};e.exports=p},function(e,t,n){"use strict";var r=n(178),o=/\/?>/,i=/^<\!\-\-/,a={CHECKSUM_ATTR_NAME:"data-react-checksum",addChecksumToMarkup:function(e){var t=r(e);return i.test(e)?e:e.replace(o," "+a.CHECKSUM_ATTR_NAME+'="'+t+'"$&')},canReuseMarkup:function(e,t){var n=t.getAttribute(a.CHECKSUM_ATTR_NAME);n=n&&parseInt(n,10);var o=r(e);return o===n}};e.exports=a},function(e,t,n){"use strict";function r(e,t,n){return{type:"INSERT_MARKUP",content:e,fromIndex:null,fromNode:null,toIndex:n,afterNode:t}}function o(e,t,n){return{type:"MOVE_EXISTING",content:null,fromIndex:e._mountIndex,fromNode:f.getHostNode(e),toIndex:n,afterNode:t}}function i(e,t){return{type:"REMOVE_NODE",content:null,fromIndex:e._mountIndex,fromNode:t,toIndex:null,afterNode:null}}function a(e){return{type:"SET_MARKUP",content:e,fromIndex:null,fromNode:null,toIndex:null,afterNode:null}}function s(e){return{type:"TEXT_CONTENT",content:e,fromIndex:null,fromNode:null,toIndex:null,afterNode:null}}function u(e,t){return t&&(e=e||[],e.push(t)),e}function l(e,t){p.processChildrenUpdates(e,t)}var c=n(3),p=n(43),f=(n(26),n(9),n(12),n(19)),d=n(135),h=(n(8),n(181)),m=(n(1),{Mixin:{_reconcilerInstantiateChildren:function(e,t,n){return d.instantiateChildren(e,t,n)},_reconcilerUpdateChildren:function(e,t,n,r,o,i){var a,s=0;return a=h(t,s),d.updateChildren(e,a,n,r,o,this,this._hostContainerInfo,i,s),a},mountChildren:function(e,t,n){var r=this._reconcilerInstantiateChildren(e,t,n);this._renderedChildren=r;var o=[],i=0;for(var a in r)if(r.hasOwnProperty(a)){var s=r[a],u=0,l=f.mountComponent(s,t,this,this._hostContainerInfo,n,u);s._mountIndex=i++,o.push(l)}return o},updateTextContent:function(e){var t=this._renderedChildren;d.unmountChildren(t,!1);for(var n in t)t.hasOwnProperty(n)&&c("118");var r=[s(e)];l(this,r)},updateMarkup:function(e){var t=this._renderedChildren;d.unmountChildren(t,!1);for(var n in t)t.hasOwnProperty(n)&&c("118");var r=[a(e)];l(this,r)},updateChildren:function(e,t,n){this._updateChildren(e,t,n)},_updateChildren:function(e,t,n){var r=this._renderedChildren,o={},i=[],a=this._reconcilerUpdateChildren(r,e,i,o,t,n);if(a||r){var s,c=null,p=0,d=0,h=0,m=null;for(s in a)if(a.hasOwnProperty(s)){var v=r&&r[s],g=a[s];v===g?(c=u(c,this.moveChild(v,m,p,d)),d=Math.max(v._mountIndex,d),v._mountIndex=p):(v&&(d=Math.max(v._mountIndex,d)),c=u(c,this._mountChildAtIndex(g,i[h],m,p,t,n)),h++),p++,m=f.getHostNode(g)}for(s in o)o.hasOwnProperty(s)&&(c=u(c,this._unmountChild(r[s],o[s])));c&&l(this,c),this._renderedChildren=a}},unmountChildren:function(e){var t=this._renderedChildren;d.unmountChildren(t,e),this._renderedChildren=null},moveChild:function(e,t,n,r){if(e._mountIndex<r)return o(e,t,n)},createChild:function(e,t,n){return r(n,t,e._mountIndex)},removeChild:function(e,t){return i(e,t)},_mountChildAtIndex:function(e,t,n,r,o,i){return e._mountIndex=r,this.createChild(e,n,t)},_unmountChild:function(e,t){var n=this.removeChild(e,t);return e._mountIndex=null,n}}});e.exports=m},function(e,t,n){"use strict";function r(e){return!(!e||"function"!=typeof e.attachRef||"function"!=typeof e.detachRef)}var o=n(3),i=(n(1),{addComponentAsRefTo:function(e,t,n){r(n)?void 0:o("119"),n.attachRef(t,e)},removeComponentAsRefFrom:function(e,t,n){r(n)?void 0:o("120");var i=n.getPublicInstance();i&&i.refs[t]===e.getPublicInstance()&&n.detachRef(t)}});e.exports=i},function(e,t){"use strict";var n="SECRET_DO_NOT_PASS_THIS_OR_YOU_WILL_BE_FIRED";e.exports=n},function(e,t,n){"use strict";function r(e){this.reinitializeTransaction(),this.renderToStaticMarkup=!1,this.reactMountReady=i.getPooled(null),this.useCreateElement=e}var o=n(4),i=n(65),a=n(14),s=n(29),u=n(72),l=(n(9),n(31)),c=n(45),p={initialize:u.getSelectionInformation,close:u.restoreSelection},f={initialize:function(){var e=s.isEnabled();return s.setEnabled(!1),e},close:function(e){
+s.setEnabled(e)}},d={initialize:function(){this.reactMountReady.reset()},close:function(){this.reactMountReady.notifyAll()}},h=[p,f,d],m={getTransactionWrappers:function(){return h},getReactMountReady:function(){return this.reactMountReady},getUpdateQueue:function(){return c},checkpoint:function(){return this.reactMountReady.checkpoint()},rollback:function(e){this.reactMountReady.rollback(e)},destructor:function(){i.release(this.reactMountReady),this.reactMountReady=null}};o(r.prototype,l,m),a.addPoolingTo(r),e.exports=r},function(e,t,n){"use strict";function r(e,t,n){"function"==typeof e?e(t.getPublicInstance()):i.addComponentAsRefTo(t,e,n)}function o(e,t,n){"function"==typeof e?e(null):i.removeComponentAsRefFrom(t,e,n)}var i=n(158),a={};a.attachRefs=function(e,t){if(null!==t&&"object"==typeof t){var n=t.ref;null!=n&&r(n,e,t._owner)}},a.shouldUpdateRefs=function(e,t){var n=null,r=null;null!==e&&"object"==typeof e&&(n=e.ref,r=e._owner);var o=null,i=null;return null!==t&&"object"==typeof t&&(o=t.ref,i=t._owner),n!==o||"string"==typeof o&&i!==r},a.detachRefs=function(e,t){if(null!==t&&"object"==typeof t){var n=t.ref;null!=n&&o(n,e,t._owner)}},e.exports=a},function(e,t,n){"use strict";function r(e){this.reinitializeTransaction(),this.renderToStaticMarkup=e,this.useCreateElement=!1,this.updateQueue=new s(this)}var o=n(4),i=n(14),a=n(31),s=(n(9),n(163)),u=[],l={enqueue:function(){}},c={getTransactionWrappers:function(){return u},getReactMountReady:function(){return l},getUpdateQueue:function(){return this.updateQueue},destructor:function(){},checkpoint:function(){},rollback:function(){}};o(r.prototype,a,c),i.addPoolingTo(r),e.exports=r},function(e,t,n){"use strict";function r(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function o(e,t){}var i=n(45),a=(n(2),function(){function e(t){r(this,e),this.transaction=t}return e.prototype.isMounted=function(e){return!1},e.prototype.enqueueCallback=function(e,t,n){this.transaction.isInTransaction()&&i.enqueueCallback(e,t,n)},e.prototype.enqueueForceUpdate=function(e){this.transaction.isInTransaction()?i.enqueueForceUpdate(e):o(e,"forceUpdate")},e.prototype.enqueueReplaceState=function(e,t){this.transaction.isInTransaction()?i.enqueueReplaceState(e,t):o(e,"replaceState")},e.prototype.enqueueSetState=function(e,t){this.transaction.isInTransaction()?i.enqueueSetState(e,t):o(e,"setState")},e}());e.exports=a},function(e,t){"use strict";e.exports="15.5.4"},function(e,t){"use strict";var n={xlink:"http://www.w3.org/1999/xlink",xml:"http://www.w3.org/XML/1998/namespace"},r={accentHeight:"accent-height",accumulate:0,additive:0,alignmentBaseline:"alignment-baseline",allowReorder:"allowReorder",alphabetic:0,amplitude:0,arabicForm:"arabic-form",ascent:0,attributeName:"attributeName",attributeType:"attributeType",autoReverse:"autoReverse",azimuth:0,baseFrequency:"baseFrequency",baseProfile:"baseProfile",baselineShift:"baseline-shift",bbox:0,begin:0,bias:0,by:0,calcMode:"calcMode",capHeight:"cap-height",clip:0,clipPath:"clip-path",clipRule:"clip-rule",clipPathUnits:"clipPathUnits",colorInterpolation:"color-interpolation",colorInterpolationFilters:"color-interpolation-filters",colorProfile:"color-profile",colorRendering:"color-rendering",contentScriptType:"contentScriptType",contentStyleType:"contentStyleType",cursor:0,cx:0,cy:0,d:0,decelerate:0,descent:0,diffuseConstant:"diffuseConstant",direction:0,display:0,divisor:0,dominantBaseline:"dominant-baseline",dur:0,dx:0,dy:0,edgeMode:"edgeMode",elevation:0,enableBackground:"enable-background",end:0,exponent:0,externalResourcesRequired:"externalResourcesRequired",fill:0,fillOpacity:"fill-opacity",fillRule:"fill-rule",filter:0,filterRes:"filterRes",filterUnits:"filterUnits",floodColor:"flood-color",floodOpacity:"flood-opacity",focusable:0,fontFamily:"font-family",fontSize:"font-size",fontSizeAdjust:"font-size-adjust",fontStretch:"font-stretch",fontStyle:"font-style",fontVariant:"font-variant",fontWeight:"font-weight",format:0,from:0,fx:0,fy:0,g1:0,g2:0,glyphName:"glyph-name",glyphOrientationHorizontal:"glyph-orientation-horizontal",glyphOrientationVertical:"glyph-orientation-vertical",glyphRef:"glyphRef",gradientTransform:"gradientTransform",gradientUnits:"gradientUnits",hanging:0,horizAdvX:"horiz-adv-x",horizOriginX:"horiz-origin-x",ideographic:0,imageRendering:"image-rendering",in:0,in2:0,intercept:0,k:0,k1:0,k2:0,k3:0,k4:0,kernelMatrix:"kernelMatrix",kernelUnitLength:"kernelUnitLength",kerning:0,keyPoints:"keyPoints",keySplines:"keySplines",keyTimes:"keyTimes",lengthAdjust:"lengthAdjust",letterSpacing:"letter-spacing",lightingColor:"lighting-color",limitingConeAngle:"limitingConeAngle",local:0,markerEnd:"marker-end",markerMid:"marker-mid",markerStart:"marker-start",markerHeight:"markerHeight",markerUnits:"markerUnits",markerWidth:"markerWidth",mask:0,maskContentUnits:"maskContentUnits",maskUnits:"maskUnits",mathematical:0,mode:0,numOctaves:"numOctaves",offset:0,opacity:0,operator:0,order:0,orient:0,orientation:0,origin:0,overflow:0,overlinePosition:"overline-position",overlineThickness:"overline-thickness",paintOrder:"paint-order",panose1:"panose-1",pathLength:"pathLength",patternContentUnits:"patternContentUnits",patternTransform:"patternTransform",patternUnits:"patternUnits",pointerEvents:"pointer-events",points:0,pointsAtX:"pointsAtX",pointsAtY:"pointsAtY",pointsAtZ:"pointsAtZ",preserveAlpha:"preserveAlpha",preserveAspectRatio:"preserveAspectRatio",primitiveUnits:"primitiveUnits",r:0,radius:0,refX:"refX",refY:"refY",renderingIntent:"rendering-intent",repeatCount:"repeatCount",repeatDur:"repeatDur",requiredExtensions:"requiredExtensions",requiredFeatures:"requiredFeatures",restart:0,result:0,rotate:0,rx:0,ry:0,scale:0,seed:0,shapeRendering:"shape-rendering",slope:0,spacing:0,specularConstant:"specularConstant",specularExponent:"specularExponent",speed:0,spreadMethod:"spreadMethod",startOffset:"startOffset",stdDeviation:"stdDeviation",stemh:0,stemv:0,stitchTiles:"stitchTiles",stopColor:"stop-color",stopOpacity:"stop-opacity",strikethroughPosition:"strikethrough-position",strikethroughThickness:"strikethrough-thickness",string:0,stroke:0,strokeDasharray:"stroke-dasharray",strokeDashoffset:"stroke-dashoffset",strokeLinecap:"stroke-linecap",strokeLinejoin:"stroke-linejoin",strokeMiterlimit:"stroke-miterlimit",strokeOpacity:"stroke-opacity",strokeWidth:"stroke-width",surfaceScale:"surfaceScale",systemLanguage:"systemLanguage",tableValues:"tableValues",targetX:"targetX",targetY:"targetY",textAnchor:"text-anchor",textDecoration:"text-decoration",textRendering:"text-rendering",textLength:"textLength",to:0,transform:0,u1:0,u2:0,underlinePosition:"underline-position",underlineThickness:"underline-thickness",unicode:0,unicodeBidi:"unicode-bidi",unicodeRange:"unicode-range",unitsPerEm:"units-per-em",vAlphabetic:"v-alphabetic",vHanging:"v-hanging",vIdeographic:"v-ideographic",vMathematical:"v-mathematical",values:0,vectorEffect:"vector-effect",version:0,vertAdvY:"vert-adv-y",vertOriginX:"vert-origin-x",vertOriginY:"vert-origin-y",viewBox:"viewBox",viewTarget:"viewTarget",visibility:0,widths:0,wordSpacing:"word-spacing",writingMode:"writing-mode",x:0,xHeight:"x-height",x1:0,x2:0,xChannelSelector:"xChannelSelector",xlinkActuate:"xlink:actuate",xlinkArcrole:"xlink:arcrole",xlinkHref:"xlink:href",xlinkRole:"xlink:role",xlinkShow:"xlink:show",xlinkTitle:"xlink:title",xlinkType:"xlink:type",xmlBase:"xml:base",xmlns:0,xmlnsXlink:"xmlns:xlink",xmlLang:"xml:lang",xmlSpace:"xml:space",y:0,y1:0,y2:0,yChannelSelector:"yChannelSelector",z:0,zoomAndPan:"zoomAndPan"},o={Properties:{},DOMAttributeNamespaces:{xlinkActuate:n.xlink,xlinkArcrole:n.xlink,xlinkHref:n.xlink,xlinkRole:n.xlink,xlinkShow:n.xlink,xlinkTitle:n.xlink,xlinkType:n.xlink,xmlBase:n.xml,xmlLang:n.xml,xmlSpace:n.xml},DOMAttributeNames:{}};Object.keys(r).forEach(function(e){o.Properties[e]=0,r[e]&&(o.DOMAttributeNames[e]=r[e])}),e.exports=o},function(e,t,n){"use strict";function r(e){if("selectionStart"in e&&u.hasSelectionCapabilities(e))return{start:e.selectionStart,end:e.selectionEnd};if(window.getSelection){var t=window.getSelection();return{anchorNode:t.anchorNode,anchorOffset:t.anchorOffset,focusNode:t.focusNode,focusOffset:t.focusOffset}}if(document.selection){var n=document.selection.createRange();return{parentElement:n.parentElement(),text:n.text,top:n.boundingTop,left:n.boundingLeft}}}function o(e,t){if(y||null==m||m!==c())return null;var n=r(m);if(!g||!f(g,n)){g=n;var o=l.getPooled(h.select,v,e,t);return o.type="select",o.target=m,i.accumulateTwoPhaseDispatches(o),o}return null}var i=n(25),a=n(7),s=n(6),u=n(72),l=n(11),c=n(59),p=n(81),f=n(36),d=a.canUseDOM&&"documentMode"in document&&document.documentMode<=11,h={select:{phasedRegistrationNames:{bubbled:"onSelect",captured:"onSelectCapture"},dependencies:["topBlur","topContextMenu","topFocus","topKeyDown","topKeyUp","topMouseDown","topMouseUp","topSelectionChange"]}},m=null,v=null,g=null,y=!1,b=!1,C={eventTypes:h,extractEvents:function(e,t,n,r){if(!b)return null;var i=t?s.getNodeFromInstance(t):window;switch(e){case"topFocus":(p(i)||"true"===i.contentEditable)&&(m=i,v=t,g=null);break;case"topBlur":m=null,v=null,g=null;break;case"topMouseDown":y=!0;break;case"topContextMenu":case"topMouseUp":return y=!1,o(n,r);case"topSelectionChange":if(d)break;case"topKeyDown":case"topKeyUp":return o(n,r)}return null},didPutListener:function(e,t,n){"onSelect"===t&&(b=!0)}};e.exports=C},function(e,t,n){"use strict";function r(e){return"."+e._rootNodeID}function o(e){return"button"===e||"input"===e||"select"===e||"textarea"===e}var i=n(3),a=n(57),s=n(25),u=n(6),l=n(168),c=n(169),p=n(11),f=n(172),d=n(174),h=n(30),m=n(171),v=n(175),g=n(176),y=n(27),b=n(177),C=n(8),_=n(47),w=(n(1),{}),E={};["abort","animationEnd","animationIteration","animationStart","blur","canPlay","canPlayThrough","click","contextMenu","copy","cut","doubleClick","drag","dragEnd","dragEnter","dragExit","dragLeave","dragOver","dragStart","drop","durationChange","emptied","encrypted","ended","error","focus","input","invalid","keyDown","keyPress","keyUp","load","loadedData","loadedMetadata","loadStart","mouseDown","mouseMove","mouseOut","mouseOver","mouseUp","paste","pause","play","playing","progress","rateChange","reset","scroll","seeked","seeking","stalled","submit","suspend","timeUpdate","touchCancel","touchEnd","touchMove","touchStart","transitionEnd","volumeChange","waiting","wheel"].forEach(function(e){var t=e[0].toUpperCase()+e.slice(1),n="on"+t,r="top"+t,o={phasedRegistrationNames:{bubbled:n,captured:n+"Capture"},dependencies:[r]};w[e]=o,E[r]=o});var T={},x={eventTypes:w,extractEvents:function(e,t,n,r){var o=E[e];if(!o)return null;var a;switch(e){case"topAbort":case"topCanPlay":case"topCanPlayThrough":case"topDurationChange":case"topEmptied":case"topEncrypted":case"topEnded":case"topError":case"topInput":case"topInvalid":case"topLoad":case"topLoadedData":case"topLoadedMetadata":case"topLoadStart":case"topPause":case"topPlay":case"topPlaying":case"topProgress":case"topRateChange":case"topReset":case"topSeeked":case"topSeeking":case"topStalled":case"topSubmit":case"topSuspend":case"topTimeUpdate":case"topVolumeChange":case"topWaiting":a=p;break;case"topKeyPress":if(0===_(n))return null;case"topKeyDown":case"topKeyUp":a=d;break;case"topBlur":case"topFocus":a=f;break;case"topClick":if(2===n.button)return null;case"topDoubleClick":case"topMouseDown":case"topMouseMove":case"topMouseUp":case"topMouseOut":case"topMouseOver":case"topContextMenu":a=h;break;case"topDrag":case"topDragEnd":case"topDragEnter":case"topDragExit":case"topDragLeave":case"topDragOver":case"topDragStart":case"topDrop":a=m;break;case"topTouchCancel":case"topTouchEnd":case"topTouchMove":case"topTouchStart":a=v;break;case"topAnimationEnd":case"topAnimationIteration":case"topAnimationStart":a=l;break;case"topTransitionEnd":a=g;break;case"topScroll":a=y;break;case"topWheel":a=b;break;case"topCopy":case"topCut":case"topPaste":a=c}a?void 0:i("86",e);var u=a.getPooled(o,t,n,r);return s.accumulateTwoPhaseDispatches(u),u},didPutListener:function(e,t,n){if("onClick"===t&&!o(e._tag)){var i=r(e),s=u.getNodeFromInstance(e);T[i]||(T[i]=a.listen(s,"click",C))}},willDeleteListener:function(e,t){if("onClick"===t&&!o(e._tag)){var n=r(e);T[n].remove(),delete T[n]}}};e.exports=x},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(11),i={animationName:null,elapsedTime:null,pseudoElement:null};o.augmentClass(r,i),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(11),i={clipboardData:function(e){return"clipboardData"in e?e.clipboardData:window.clipboardData}};o.augmentClass(r,i),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(11),i={data:null};o.augmentClass(r,i),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(30),i={dataTransfer:null};o.augmentClass(r,i),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(27),i={relatedTarget:null};o.augmentClass(r,i),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(11),i={data:null};o.augmentClass(r,i),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(27),i=n(47),a=n(182),s=n(48),u={key:a,location:null,ctrlKey:null,shiftKey:null,altKey:null,metaKey:null,repeat:null,locale:null,getModifierState:s,charCode:function(e){return"keypress"===e.type?i(e):0},keyCode:function(e){return"keydown"===e.type||"keyup"===e.type?e.keyCode:0},which:function(e){return"keypress"===e.type?i(e):"keydown"===e.type||"keyup"===e.type?e.keyCode:0}};o.augmentClass(r,u),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(27),i=n(48),a={touches:null,targetTouches:null,changedTouches:null,altKey:null,metaKey:null,ctrlKey:null,shiftKey:null,getModifierState:i};o.augmentClass(r,a),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(11),i={propertyName:null,elapsedTime:null,pseudoElement:null};o.augmentClass(r,i),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(30),i={deltaX:function(e){return"deltaX"in e?e.deltaX:"wheelDeltaX"in e?-e.wheelDeltaX:0},deltaY:function(e){return"deltaY"in e?e.deltaY:"wheelDeltaY"in e?-e.wheelDeltaY:"wheelDelta"in e?-e.wheelDelta:0},deltaZ:null,deltaMode:null};o.augmentClass(r,i),e.exports=r},function(e,t){"use strict";function n(e){for(var t=1,n=0,o=0,i=e.length,a=i&-4;o<a;){for(var s=Math.min(o+4096,a);o<s;o+=4)n+=(t+=e.charCodeAt(o))+(t+=e.charCodeAt(o+1))+(t+=e.charCodeAt(o+2))+(t+=e.charCodeAt(o+3));t%=r,n%=r}for(;o<i;o++)n+=t+=e.charCodeAt(o);return t%=r,n%=r,t|n<<16}var r=65521;e.exports=n},function(e,t,n){"use strict";function r(e,t,n){var r=null==t||"boolean"==typeof t||""===t;if(r)return"";var o=isNaN(t);if(o||0===t||i.hasOwnProperty(e)&&i[e])return""+t;if("string"==typeof t){t=t.trim()}return t+"px"}var o=n(64),i=(n(2),o.isUnitlessNumber);e.exports=r},function(e,t,n){"use strict";function r(e){if(null==e)return null;if(1===e.nodeType)return e;var t=a.get(e);return t?(t=s(t),t?i.getNodeFromInstance(t):null):void("function"==typeof e.render?o("44"):o("45",Object.keys(e)))}var o=n(3),i=(n(12),n(6)),a=n(26),s=n(78);n(1),n(2);e.exports=r},function(e,t,n){(function(t){"use strict";function r(e,t,n,r){if(e&&"object"==typeof e){var o=e,i=void 0===o[n];i&&null!=t&&(o[n]=t)}}function o(e,t){if(null==e)return e;var n={};return i(e,r,n),n}var i=(n(41),n(83));n(2);e.exports=o}).call(t,n(60))},function(e,t,n){"use strict";function r(e){if(e.key){var t=i[e.key]||e.key;if("Unidentified"!==t)return t}if("keypress"===e.type){var n=o(e);return 13===n?"Enter":String.fromCharCode(n)}return"keydown"===e.type||"keyup"===e.type?a[e.keyCode]||"Unidentified":""}var o=n(47),i={Esc:"Escape",Spacebar:" ",Left:"ArrowLeft",Up:"ArrowUp",Right:"ArrowRight",Down:"ArrowDown",Del:"Delete",Win:"OS",Menu:"ContextMenu",Apps:"ContextMenu",Scroll:"ScrollLock",MozPrintableKey:"Unidentified"},a={8:"Backspace",9:"Tab",12:"Clear",13:"Enter",16:"Shift",17:"Control",18:"Alt",19:"Pause",20:"CapsLock",27:"Escape",32:" ",33:"PageUp",34:"PageDown",35:"End",36:"Home",37:"ArrowLeft",38:"ArrowUp",39:"ArrowRight",40:"ArrowDown",45:"Insert",46:"Delete",112:"F1",113:"F2",114:"F3",115:"F4",116:"F5",117:"F6",118:"F7",119:"F8",120:"F9",121:"F10",122:"F11",123:"F12",144:"NumLock",145:"ScrollLock",224:"Meta"};e.exports=r},function(e,t){"use strict";function n(e){var t=e&&(r&&e[r]||e[o]);if("function"==typeof t)return t}var r="function"==typeof Symbol&&Symbol.iterator,o="@@iterator";e.exports=n},function(e,t){"use strict";function n(e){for(;e&&e.firstChild;)e=e.firstChild;return e}function r(e){for(;e;){if(e.nextSibling)return e.nextSibling;e=e.parentNode}}function o(e,t){for(var o=n(e),i=0,a=0;o;){if(3===o.nodeType){if(a=i+o.textContent.length,i<=t&&a>=t)return{node:o,offset:t-i};i=a}o=n(r(o))}}e.exports=o},function(e,t,n){"use strict";function r(e,t){var n={};return n[e.toLowerCase()]=t.toLowerCase(),n["Webkit"+e]="webkit"+t,n["Moz"+e]="moz"+t,n["ms"+e]="MS"+t,n["O"+e]="o"+t.toLowerCase(),n}function o(e){if(s[e])return s[e];if(!a[e])return e;var t=a[e];for(var n in t)if(t.hasOwnProperty(n)&&n in u)return s[e]=t[n];return""}var i=n(7),a={animationend:r("Animation","AnimationEnd"),animationiteration:r("Animation","AnimationIteration"),animationstart:r("Animation","AnimationStart"),transitionend:r("Transition","TransitionEnd")},s={},u={};i.canUseDOM&&(u=document.createElement("div").style,"AnimationEvent"in window||(delete a.animationend.animation,delete a.animationiteration.animation,delete a.animationstart.animation),"TransitionEvent"in window||delete a.transitionend.transition),e.exports=o},function(e,t,n){"use strict";function r(e){return'"'+o(e)+'"'}var o=n(32);e.exports=r},function(e,t,n){"use strict";var r=n(73);e.exports=r.renderSubtreeIntoContainer},function(e,t,n){"use strict";"undefined"==typeof Promise&&(n(120).enable(),window.Promise=n(119)),n(226),Object.assign=n(4)},113,114,115,116,117,function(e,t,n){(function(){var t,r,o;t=n(5),r=t.createClass,o=t.DOM.div,e.exports=r({getDefaultProps:function(){return{className:"",onHeightChange:function(){}}},render:function(){return o({className:this.props.className,ref:"dropdown"},this.props.children)},componentDidMount:function(){this.props.onHeightChange(this.refs.dropdown.offsetHeight)},componentDidUpdate:function(){this.props.onHeightChange(this.refs.dropdown.offsetHeight)},componentWillUnmount:function(){this.props.onHeightChange(0)}})}).call(this)},function(e,t,n){(function(){function t(e,t){var n={}.hasOwnProperty;for(var r in t)n.call(t,r)&&(e[r]=t[r]);return e}var r,o,i,a,s,u,l,c,p,f,d,h,m,v,g,y,b,C;r=n(15),o=r.filter,i=r.id,a=r.map,s=n(16).isEqualToObject,u=n(5),r=u.DOM,l=r.div,c=r.input,p=r.span,f=u.createClass,d=u.createFactory,h=n(13).findDOMNode,m=d(n(63)),v=d(n(198)),g=d(n(194)),y=d(n(84)),r=n(28),b=r.cancelEvent,C=r.classNameFromObject,e.exports=f({displayName:"DropdownMenu",getDefaultProps:function(){return{className:"",dropdownDirection:1,groupId:function(e){return e.groupId},groupsAsColumns:!1,highlightedUid:void 0,onHighlightedUidChange:function(e,t){},onOptionClick:function(e){},onScrollLockChange:function(e){},options:[],renderNoResultsFound:function(){return l({className:"no-results-found"},"No results found")},renderGroupTitle:function(e,t){var n,r;return null!=t&&(n=t.groupId,r=t.title),l({className:"simple-group-title",key:n},r)},renderOption:function(e){var t,n,r,o;return null!=e&&(t=e.label,n=e.newOption,r=e.selectable),o="undefined"==typeof r||r,l({className:"simple-option "+(o?"":"not-selectable")},p(null,n?"Add "+t+" ...":t))},scrollLock:!1,style:{},tether:!1,tetherProps:{},theme:"default",transitionEnter:!1,transitionLeave:!1,transitionEnterTimeout:200,transitionLeaveTimeout:200,uid:i}},render:function(){var e,n;return e=C((n={},n[this.props.theme+""]=1,n[this.props.className+""]=1,n.flipped=this.props.dropdownDirection===-1,n.tethered=this.props.tether,n)),this.props.tether?v((n=t({},this.props.tetherProps),n.options={attachment:"top left",targetAttachment:"bottom left",constraints:[{to:"scrollParent"}]},n),this.renderAnimatedDropdown({dynamicClassName:e})):this.renderAnimatedDropdown({dynamicClassName:e})},renderAnimatedDropdown:function(e){var t;return t=e.dynamicClassName,this.props.transitionEnter||this.props.transitionLeave?m({component:"div",transitionName:"custom",transitionEnter:this.props.transitionEnter,transitionLeave:this.props.transitionLeave,transitionEnterTimeout:this.props.transitionEnterTimeout,transitionLeaveTimeout:this.props.transitionLeaveTimeout,className:"dropdown-menu-wrapper "+t,ref:"dropdownMenuWrapper"},this.renderDropdown(e)):this.renderDropdown(e)},renderOptions:function(e){var n=this;return a(function(r){var o,i;return o=e[r],i=n.props.uid(o),y(t({uid:i,ref:"option-"+n.uidToString(i),key:n.uidToString(i),item:o,highlight:s(n.props.highlightedUid,i),selectable:null!=o?o.selectable:void 0,onMouseMove:function(e){var t;t=e.currentTarget,n.props.scrollLock&&n.props.onScrollLockChange(!1)},onMouseOut:function(){n.props.scrollLock||n.props.onHighlightedUidChange(void 0,function(){})},renderItem:n.props.renderOption},function(){switch(!1){case!("boolean"==typeof(null!=o?o.selectable:void 0)&&!o.selectable):return{onClick:b};default:return{onClick:function(){n.props.onOptionClick(n.props.highlightedUid)},onMouseOver:function(e){var t;t=e.currentTarget,n.props.scrollLock||n.props.onHighlightedUidChange(i,function(){})}}}}()))})(function(){var t,n,r=[];for(t=0,n=e.length;t<n;++t)r.push(t);return r}())},renderDropdown:function(e){var t,n,r,i,s=this;return t=e.dynamicClassName,this.props.open?g({className:"dropdown-menu "+t,ref:"dropdownMenu",onHeightChange:function(e){s.refs.dropdownMenuWrapper&&(h(s.refs.dropdownMenuWrapper).style.height=e+"px")}},0===this.props.options.length?this.props.renderNoResultsFound():(null!=(n=this.props)&&null!=(r=n.groups)?r.length:void 0)>0?(i=a(function(e){var t,n,r;return t=s.props.groups[e],n=t.groupId,r=o(function(e){return s.props.groupId(e)===n})(s.props.options),{index:e,group:t,options:r}})(function(){var e,t,n=[];for(e=0,t=this.props.groups.length;e<t;++e)n.push(e);return n}.call(this)),l({className:"groups "+(this.props.groupsAsColumns?"as-columns":"")},a(function(e){var t,n,r,o;return t=e.index,n=e.group,r=n.groupId,o=e.options,l({key:r},s.props.renderGroupTitle(t,n,o),l({className:"options"},s.renderOptions(o)))})(o(function(e){return e.options.length>0})(i)))):this.renderOptions(this.props.options)):null},componentDidUpdate:function(){var e,t,n;e=t=h(null!=(n=this.refs.dropdownMenuWrapper)?n:this.refs.dropdownMenu),null!=e&&(e.style.bottom=function(){switch(!1){case this.props.dropdownDirection!==-1:return this.props.bottomAnchor().offsetHeight+t.style.marginBottom+"px";default:return""}}.call(this))},highlightAndScrollToOption:function(e,t){var n,r=this;null==t&&(t=function(){}),n=this.props.uid(this.props.options[e]),this.props.onHighlightedUidChange(n,function(){var e,o,i,a,s;return null!=(e=h(null!=(o=r.refs)?o["option-"+r.uidToString(n)]:void 0))&&(i=e),i&&(a=h(r.refs.dropdownMenu),s=i.offsetHeight-1,i.offsetTop-a.scrollTop>=a.offsetHeight?a.scrollTop=i.offsetTop-a.offsetHeight+s:i.offsetTop-a.scrollTop+s<=0&&(a.scrollTop=i.offsetTop)),t()})},highlightAndScrollToSelectableOption:function(e,t,n){var r,o,i;null==n&&(n=function(){}),e<0||e>=this.props.options.length?this.props.onHighlightedUidChange(void 0,function(){return n(!1)}):(r=null!=(o=this.props)&&null!=(i=o.options)?i[e]:void 0,"boolean"!=typeof(null!=r?r.selectable:void 0)||r.selectable?this.highlightAndScrollToOption(e,function(){return n(!0)}):this.highlightAndScrollToSelectableOption(e+t,t,n))},uidToString:function(e){return("object"==typeof e?JSON.stringify:i)(e)}})}).call(this)},function(e,t,n){(function(){var t,r,o,i,a,s;t=n(5),r=t.createClass,o=t.DOM,i=o.div,a=o.span,s=n(15).map,e.exports=r({getDefaultProps:function(){return{partitions:[],text:"",style:{},highlightStyle:{}}},render:function(){var e=this;return i({className:"highlighted-text",style:this.props.style},s(function(t){var n,r,o;return n=t[0],r=t[1],o=t[2],a({key:e.props.text+""+n+r+o,className:o?"highlight":"",style:o?e.props.highlightStyle:{}},e.props.text.substring(n,r))})(this.props.partitions))}})}).call(this)},function(e,t,n){(function(){function t(e,t){for(var n=-1,r=t.length>>>0;++n<r;)if(e===t[n])return!0;return!1}function r(e,t){var n,r=function(o){return e.length>1?function(){var i=o?o.concat():[];return n=t?n||this:this,i.push.apply(i,arguments)<e.length&&arguments.length?r.call(n,i):e.apply(n,i)}:e};return r()}function o(e,t){var n={}.hasOwnProperty;for(var r in t)n.call(t,r)&&(e[r]=t[r]);return e}var i,a,s,u,l,c,p,f,d,h,m,v,g,y,b,C,_,w,E,T,x,O={}.toString;i=n(15),a=i.all,s=i.any,u=i.camelize,l=i.difference,c=i.drop,p=i.filter,f=i.find,d=i.findIndex,h=i.id,m=i.last,v=i.map,g=i.reject,y=n(16).isEqualToObject,b=n(5),C=b.createFactory,i=b.DOM,_=i.div,w=i.img,E=i.span,T=C(n(53)),x=n(28).cancelEvent,e.exports=b.createClass({displayName:"MultiSelect",getDefaultProps:function(){return{className:"",closeOnSelect:!1,defaultValues:[],delimiters:[],filterOptions:r(function(e,n,r){return p(function(e){return e.label.toLowerCase().trim().indexOf(r.toLowerCase().trim())>-1})(g(function(e){return t(e.label.trim(),v(function(e){return e.label.trim()},null!=n?n:[]))})(e))}),firstOptionIndexToHighlight:h,onBlur:function(e){},onFocus:function(e){},onPaste:function(e){},serialize:v(function(e){return null!=e?e.value:void 0}),tether:!1}},render:function(){var e,t,n,r,i,a,s,u,l,c,p,f,d,h,v,g,y,b,C,_,w,E,O,P,k,S,N,M,A,I,D,R,L,U,F,j,B,V,W=this;return e=this.getComputedState(),t=e.anchor,n=e.filteredOptions,r=e.highlightedUid,i=e.onAnchorChange,a=e.onOpenChange,s=e.onHighlightedUidChange,u=e.onSearchChange,l=e.onValuesChange,c=e.search,p=e.open,f=e.options,d=e.values,null!=(e=this.props)&&(h=e.autofocus,v=e.autosize,g=e.cancelKeyboardEventOnSelection,y=e.delimiters,b=e.disabled,C=e.dropdownDirection,_=e.groupId,w=e.groups,E=e.groupsAsColumns,O=e.hideResetButton,P=e.inputProps,k=e.name,S=e.onKeyboardSelectionFailed,N=e.renderToggleButton,M=e.renderGroupTitle,A=e.renderResetButton,I=e.serialize,D=e.tether,R=e.tetherProps,L=e.theme,U=e.transitionEnter,F=e.transitionLeave,j=e.transitionEnterTimeout,B=e.transitionLeaveTimeout,V=e.uid),T(o(o({autofocus:h,autosize:v,cancelKeyboardEventOnSelection:g,className:"multi-select "+this.props.className,delimiters:y,disabled:b,dropdownDirection:C,groupId:_,groups:w,groupsAsColumns:E,hideResetButton:O,highlightedUid:r,onHighlightedUidChange:s,inputProps:P,name:k,onKeyboardSelectionFailed:S,renderGroupTitle:M,renderResetButton:A,renderToggleButton:N,scrollLock:this.state.scrollLock,onScrollLockChange:function(e){return W.setState({scrollLock:e})},tether:D,tetherProps:R,theme:L,transitionEnter:U,transitionEnterTimeout:j,transitionLeave:F,transitionLeaveTimeout:B,uid:V,ref:"select",anchor:t,onAnchorChange:i,open:p,onOpenChange:a,options:f,renderOption:this.props.renderOption,firstOptionIndexToHighlight:function(){return W.firstOptionIndexToHighlight(f)},search:c,onSearchChange:function(e,t){return u(W.props.maxValues&&d.length>=W.props.maxValues?"":e,t)},values:d,onValuesChange:function(e,t){return l(e,function(){if(t(),W.props.closeOnSelect||W.props.maxValues&&W.values().length>=W.props.maxValues)return a(!1,function(){})})},renderValue:this.props.renderValue,serialize:I,onBlur:function(e){u("",function(){return W.props.onBlur({open:p,values:d,originalEvent:e})})},onFocus:function(e){W.props.onFocus({open:p,values:d,originalEvent:e})},onPaste:function(){var e;switch(!1){case"undefined"!=typeof(null!=(e=this.props)?e.valuesFromPaste:void 0):return this.props.onPaste;default:return function(e){var t;return t=e.clipboardData,function(){var e;return e=d.concat(W.props.valuesFromPaste(f,d,t.getData("text"))),l(e,function(){return i(m(e))})}(),x(e)}}}.call(this),placeholder:this.props.placeholder,style:this.props.style},function(){switch(!1){case"function"!=typeof this.props.restoreOnBackspace:return{restoreOnBackspace:this.props.restoreOnBackspace};default:return{}}}.call(this)),function(){switch(!1){case"function"!=typeof this.props.renderNoResultsFound:return{renderNoResultsFound:function(){return W.props.renderNoResultsFound(d,c)}};default:return{}}}.call(this)))},getComputedState:function(){var e,t,n,r,i,a,s,l,c,p,f,d,h,m,g,y,b=this;return e=this.props.hasOwnProperty("anchor")?this.props.anchor:this.state.anchor,t=this.props.hasOwnProperty("highlightedUid")?this.props.highlightedUid:this.state.highlightedUid,n=this.isOpen(),r=this.props.hasOwnProperty("search")?this.props.search:this.state.search,i=this.values(),a=v(function(e){switch(!1){case!(b.props.hasOwnProperty(e)&&b.props.hasOwnProperty(u("on-"+e+"-change"))):return function(t,n){return b.props[u("on-"+e+"-change")](t,function(){}),b.setState({},n)};case!(b.props.hasOwnProperty(e)&&!b.props.hasOwnProperty(u("on-"+e+"-change"))):return function(e,t){return t()};case!(!b.props.hasOwnProperty(e)&&b.props.hasOwnProperty(u("on-"+e+"-change"))):return function(t,n){var r;return b.setState((r={},r[e+""]=t,r),function(){return n(),b.props[u("on-"+e+"-change")](t,function(){})})};case!(!b.props.hasOwnProperty(e)&&!b.props.hasOwnProperty(u("on-"+e+"-change"))):return function(t,n){var r;return b.setState((r={},r[e+""]=t,r),n)}}})(["anchor","highlightedUid","open","search","values"]),s=a[0],l=a[1],c=a[2],p=a[3],f=a[4],d=function(){var e;switch(!1){case!(null!=(e=this.props)&&e.children):return v(function(e){var t,n,r;return null!=e&&(t=e.props),null!=t&&(n=t.value,r=t.children),{label:r,value:n}})("Array"===O.call(this.props.children).slice(8,-1)?this.props.children:[this.props.children]);default:return[]}}.call(this),h=this.props.hasOwnProperty("options")?null!=(a=this.props.options)?a:[]:d,m=this.props.filterOptions(h,i,r),g=function(){switch(!1){case"function"!=typeof this.props.createFromSearch:return this.props.createFromSearch(m,i,r);default:return null}}.call(this),y=(g?[(a=o({},g),a.newOption=!0,a)]:[]).concat(m),{anchor:e,highlightedUid:t,search:r,values:i,onAnchorChange:s,onHighlightedUidChange:l,open:n,onOpenChange:function(e,t){c(function(){switch(!1){case!("undefined"!=typeof this.props.maxValues&&this.values().length>=this.props.maxValues):return!1;default:return e}}.call(b),t)},onSearchChange:p,onValuesChange:f,filteredOptions:m,options:y}},getInitialState:function(){return{anchor:this.props.values?m(this.props.values):void 0,highlightedUid:void 0,open:!1,scrollLock:!1,search:"",values:this.props.defaultValues}},firstOptionIndexToHighlight:function(e){var t,n;return t=function(){var t;switch(!1){case 1!==e.length:return 0;case"undefined"!=typeof(null!=(t=e[0])?t.newOption:void 0):return 0;default:return a(function(e){return"boolean"==typeof e.selectable&&!e.selectable})(c(1)(e))?0:1}}(),n=this.props.hasOwnProperty("search")?this.props.search:this.state.search,this.props.firstOptionIndexToHighlight(t,e,this.values(),n)},focus:function(){this.refs.select.focus()},blur:function(){this.refs.select.blur()},highlightFirstSelectableOption:function(){this.state.open&&this.refs.select.highlightAndScrollToSelectableOption(this.firstOptionIndexToHighlight(this.getComputedState().options),1)},values:function(){return this.props.hasOwnProperty("values")?this.props.values:this.state.values},isOpen:function(){return this.props.hasOwnProperty("open")?this.props.open:this.state.open}})}).call(this)},function(e,t,n){(function(){function t(e,t){var n={}.hasOwnProperty;for(var r in t)n.call(t,r)&&(e[r]=t[r]);return e}var r,o,i,a,s,u;r=n(5).createClass,o=n(13),i=o.render,a=o.unmountComponentAtNode,s=n(124),u=n(224),e.exports=r({getDefaultProps:function(){return{parentElement:function(){return document.body}}},render:function(){
+return null},initTether:function(e){var n=this;this.node=document.createElement("div"),this.props.parentElement().appendChild(this.node),this.tether=new u(t({element:this.node,target:e.target()},e.options)),i(e.children,this.node,function(){return n.tether.position()})},destroyTether:function(){this.tether&&this.tether.destroy(),this.node&&(a(this.node),this.node.parentElement.removeChild(this.node)),this.node=this.tether=void 0},componentDidMount:function(){this.props.children&&this.initTether(this.props)},componentWillReceiveProps:function(e){var n=this;this.props.children&&!e.children?this.destroyTether():e.children&&!this.props.children?this.initTether(e):e.children&&(this.tether.setOptions(t({element:this.node,target:e.target()},e.options)),i(e.children,this.node,function(){return n.tether.position()}))},shouldComponentUpdate:function(e,t){return s(this,e,t)},componentWillUnmount:function(){this.destroyTether()}})}).call(this)},function(e,t,n){(function(){var t,r,o,i,a;t=n(5),r=t.createClass,o=t.createFactory,i=t.DOM.path,a=o(n(85)),e.exports=r({render:function(){return a({className:"react-selectize-reset-button",style:{width:8,height:8}},i({d:"M0 0 L8 8 M8 0 L 0 8"}))}})}).call(this)},function(e,t,n){(function(){function t(e,t){var n={}.hasOwnProperty;for(var r in t)n.call(t,r)&&(e[r]=t[r]);return e}var r,o,i,a,s,u,l,c;r=n(15),o=r.each,i=r.objToPairs,a=n(5),s=a.DOM.input,u=a.createClass,l=a.createFactory,c=n(13).findDOMNode,e.exports=u({displayName:"ResizableInput",render:function(){var e;return s((e=t({},this.props),e.type="input",e.className="resizable-input",e))},autosize:function(){var e,t,n,r,a;return e=t=c(this),e.style.width="0px",0===t.value.length?t.style.width=null!=t&&t.currentStyle?"4px":"2px":t.scrollWidth>0?t.style.width=2+t.scrollWidth+"px":(n=r=document.createElement("div"),n.innerHTML=t.value,function(){var e;return e=r.style,e.display="inline-block",e.width="",e}(o(function(e){var t,n;return t=e[0],n=e[1],r.style[t]=n})(i(t.currentStyle?t.currentStyle:null!=(a=document.defaultView)?a:window.getComputedStyle(t)))),document.body.appendChild(r),t.style.width=4+r.clientWidth+"px",document.body.removeChild(r))},componentDidMount:function(){this.autosize()},componentDidUpdate:function(){this.autosize()},blur:function(){return c(this).blur()},focus:function(){return c(this).focus()}})}).call(this)},function(e,t,n){(function(){function t(e,t){var n,r=function(o){return e.length>1?function(){var i=o?o.concat():[];return n=t?n||this:this,i.push.apply(i,arguments)<e.length&&arguments.length?r.call(n,i):e.apply(n,i)}:e};return r()}function r(e,t){var n={}.hasOwnProperty;for(var r in t)n.call(t,r)&&(e[r]=t[r]);return e}var o,i,a,s,u,l,c,p,f,d,h,m,v,g,y,b,C,_,w,E,T,x={}.toString;o=n(15),i=o.all,a=o.any,s=o.drop,u=o.camelize,l=o.difference,c=o.filter,p=o.find,f=o.findIndex,d=o.id,h=o.last,m=o.map,v=o.reject,g=n(16).isEqualToObject,y=n(5),b=y.createFactory,o=y.DOM,C=o.div,_=o.img,w=o.span,E=b(n(53)),T=n(28).cancelEvent,e.exports=y.createClass({displayName:"SimpleSelect",getDefaultProps:function(){return{delimiters:[],filterOptions:t(function(e,t){return c(function(e){return e.label.toLowerCase().trim().indexOf(t.toLowerCase().trim())>-1})(e)}),firstOptionIndexToHighlight:d,onBlur:function(e){},onBlurResetsInput:!0,onFocus:function(e){},onKeyboardSelectionFailed:function(e){},onPaste:function(e){},placeholder:"",renderValue:function(e){var t;return t=e.label,C({className:"simple-value"},w(null,t))},serialize:function(e){return null!=e?e.value:void 0},style:{},tether:!1,uid:d}},render:function(){var e,t,n,o,i,a,s,u,l,c,p,f,d,m,v,y,b,C,_,w,x,O,P,k,S,N,M,A,I,D,R,L,U,F,j,B,V,W=this;return e=this.getComputedState(),t=e.filteredOptions,n=e.highlightedUid,o=e.onHighlightedUidChange,i=e.onOpenChange,a=e.onSearchChange,s=e.onValueChange,u=e.open,l=e.options,c=e.search,p=e.value,f=e.values,null!=(e=this.props)&&(d=e.autofocus,m=e.autosize,v=e.cancelKeyboardEventOnSelection,y=e.delimiters,b=e.disabled,C=e.dropdownDirection,_=e.groupId,w=e.groups,x=e.groupsAsColumns,O=e.hideResetButton,P=e.name,k=e.inputProps,S=e.onBlurResetsInput,N=e.renderToggleButton,M=e.renderGroupTitle,A=e.renderResetButton,I=e.serialize,D=e.tether,R=e.tetherProps,L=e.theme,U=e.transitionEnter,F=e.transitionLeave,j=e.transitionEnterTimeout,B=e.transitionLeaveTimeout,V=e.uid),E(r(r({autofocus:d,autosize:m,cancelKeyboardEventOnSelection:v,className:"simple-select"+(this.props.className?" "+this.props.className:""),delimiters:y,disabled:b,dropdownDirection:C,groupId:_,groups:w,groupsAsColumns:x,hideResetButton:O,highlightedUid:n,onHighlightedUidChange:o,inputProps:k,name:P,onBlurResetsInput:S,renderGroupTitle:M,renderResetButton:A,renderToggleButton:N,scrollLock:this.state.scrollLock,onScrollLockChange:function(e){return W.setState({scrollLock:e})},tether:D,tetherProps:R,theme:L,transitionEnter:U,transitionEnterTimeout:j,transitionLeave:F,transitionLeaveTimeout:B,ref:"select",anchor:h(f),onAnchorChange:function(e,t){return t()},open:u,onOpenChange:i,firstOptionIndexToHighlight:function(){return W.firstOptionIndexToHighlight(l,p)},options:l,renderOption:this.props.renderOption,renderNoResultsFound:this.props.renderNoResultsFound,search:c,onSearchChange:function(e,t){return a(e,t)},values:f,onValuesChange:function(e,t){var n,r;return 0===e.length?s(void 0,function(){return t()}):(n=h(e),r=!g(n,p),function(){return function(e){return r?s(n,e):e()}}()(function(){return t(),i(!1,function(){})}))},renderValue:function(e){return u&&(W.props.editable||c.length>0)?null:W.props.renderValue(e)},onKeyboardSelectionFailed:function(e){return a("",function(){return i(!1,function(){return W.props.onKeyboardSelectionFailed(e)})})},uid:function(e){return{uid:W.props.uid(e),open:u,search:c}},serialize:function(e){return I(e[0])},onBlur:function(e){var t;t=W.props.onBlurResetsInput,function(){return function(e){return c.length>0&&t?a("",e):e()}}()(function(){return W.props.onBlur({value:p,open:u,originalEvent:e})})},onFocus:function(e){W.props.onFocus({value:p,open:u,originalEvent:e})},onPaste:function(){var e;switch(!1){case"undefined"!=typeof(null!=(e=this.props)?e.valueFromPaste:void 0):return this.props.onPaste;default:return function(e){var t,n;if(t=e.clipboardData,n=W.props.valueFromPaste(l,p,t.getData("text")))return function(){return s(n,function(){return a("",function(){return i(!1)})})}(),T(e)}}}.call(this),placeholder:this.props.placeholder,style:this.props.style},function(){switch(!1){case"function"!=typeof this.props.restoreOnBackspace:return{restoreOnBackspace:this.props.restoreOnBackspace};default:return{}}}.call(this)),function(){switch(!1){case"function"!=typeof this.props.renderNoResultsFound:return{renderNoResultsFound:function(){return W.props.renderNoResultsFound(p,c)}};default:return{}}}.call(this)))},getComputedState:function(){var e,t,n,o,i,a,s,l,c,p,f,d,h,v,g,y=this;return e=this.props.hasOwnProperty("highlightedUid")?this.props.highlightedUid:this.state.highlightedUid,t=this.isOpen(),n=this.props.hasOwnProperty("search")?this.props.search:this.state.search,o=this.value(),i=o||0===o?[o]:[],a=m(function(e){var t;return t=function(){switch(!1){case!(this.props.hasOwnProperty(e)&&this.props.hasOwnProperty(u("on-"+e+"-change"))):return function(t,n){return y.props[u("on-"+e+"-change")](t,function(){}),y.setState({},n)};case!(this.props.hasOwnProperty(e)&&!this.props.hasOwnProperty(u("on-"+e+"-change"))):return function(e,t){return t()};case!(!this.props.hasOwnProperty(e)&&this.props.hasOwnProperty(u("on-"+e+"-change"))):return function(t,n){var r;return y.setState((r={},r[e+""]=t,r),function(){return n(),y.props[u("on-"+e+"-change")](t,function(){})})};case!(!this.props.hasOwnProperty(e)&&!this.props.hasOwnProperty(u("on-"+e+"-change"))):return function(t,n){var r;return y.setState((r={},r[e+""]=t,r),n)}}}.call(y)})(["highlightedUid","open","search","value"]),s=a[0],l=a[1],c=a[2],p=a[3],f=function(){var e;switch(!1){case!(null!=(e=this.props)&&e.children):return m(function(e){var t,n,r;return null!=(t=null!=e?e.props:void 0)&&(n=t.value,r=t.children),{label:r,value:n}})("Array"===x.call(this.props.children).slice(8,-1)?this.props.children:[this.props.children]);default:return[]}}.call(this),d=this.props.hasOwnProperty("options")?null!=(a=this.props.options)?a:[]:f,h=this.props.filterOptions(d,n),v=function(){switch(!1){case"function"!=typeof this.props.createFromSearch:return this.props.createFromSearch(h,n);default:return null}}.call(this),g=(v?[(a=r({},v),a.newOption=!0,a)]:[]).concat(h),{highlightedUid:e,open:t,search:n,value:o,values:i,onHighlightedUidChange:s,onOpenChange:function(e,t){l(e,function(){if(t(),y.props.editable&&y.isOpen()&&o)return c(y.props.editable(o)+""+(1===n.length?n:""),function(){return y.highlightFirstSelectableOption(function(){})})})},onSearchChange:c,onValueChange:p,filteredOptions:h,options:g}},getInitialState:function(){var e;return{highlightedUid:void 0,open:!1,scrollLock:!1,search:"",value:null!=(e=this.props)?e.defaultValue:void 0}},firstOptionIndexToHighlight:function(e,t){var n,r,o;return n=t?f(function(e){return g(e,t)},e):void 0,r=function(){var t;switch(!1){case"undefined"==typeof n:return n;case 1!==e.length:return 0;case"undefined"!=typeof(null!=(t=e[0])?t.newOption:void 0):return 0;default:return i(function(e){return"boolean"==typeof e.selectable&&!e.selectable})(s(1)(e))?0:1}}(),o=this.props.hasOwnProperty("search")?this.props.search:this.state.search,this.props.firstOptionIndexToHighlight(r,e,t,o)},focus:function(){this.refs.select.focus()},blur:function(){this.refs.select.blur()},highlightFirstSelectableOption:function(e){var t,n,r;null==e&&(e=function(){}),this.state.open?(t=this.getComputedState(),n=t.options,r=t.value,this.refs.select.highlightAndScrollToSelectableOption(this.firstOptionIndexToHighlight(n,r),1,e)):e()},value:function(){return this.props.hasOwnProperty("value")?this.props.value:this.state.value},isOpen:function(){return this.props.hasOwnProperty("open")?this.props.open:this.state.open}})}).call(this)},function(e,t,n){(function(){var t,r,o,i,a;t=n(5),r=t.createClass,o=t.createFactory,i=t.DOM.path,a=o(n(85)),e.exports=r({getDefaultProps:function(){return{open:!1,flipped:!1}},render:function(){return a({className:"react-selectize-toggle-button",style:{width:10,height:8}},i({d:function(){switch(!1){case!(this.props.open&&!this.props.flipped||!this.props.open&&this.props.flipped):return"M0 6 L5 1 L10 6 Z";default:return"M0 1 L5 6 L10 1 Z"}}.call(this)}))}})}).call(this)},function(e,t,n){(function(){var t,r,o,i;t=n(5),r=t.createClass,o=t.DOM.div,i=n(16).isEqualToObject,e.exports=r({getDefaultProps:function(){return{}},render:function(){return o({className:"value-wrapper"},this.props.renderItem(this.props.item))},shouldComponentUpdate:function(e){var t;return!i(null!=e?e.uid:void 0,null!=(t=this.props)?t.uid:void 0)}})}).call(this)},function(e,t,n){(function(){var t,r,o,i;t=n(196),r=n(201),o=n(197),i=n(53),e.exports={HighlightedText:t,SimpleSelect:r,MultiSelect:o,ReactSelectize:i}}).call(this)},function(e,t,n){"use strict";function r(e){return e&&e.__esModule?e:{default:e}}function o(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function i(e,t){if(!e)throw new ReferenceError("this hasn't been initialised - super() hasn't been called");return!t||"object"!=typeof t&&"function"!=typeof t?e:t}function a(e,t){if("function"!=typeof t&&null!==t)throw new TypeError("Super expression must either be null or a function, not "+typeof t);e.prototype=Object.create(t&&t.prototype,{constructor:{value:e,enumerable:!1,writable:!0,configurable:!0}}),t&&(Object.setPrototypeOf?Object.setPrototypeOf(e,t):e.__proto__=t)}t.__esModule=!0;var s=Object.assign||function(e){for(var t=1;t<arguments.length;t++){var n=arguments[t];for(var r in n)Object.prototype.hasOwnProperty.call(n,r)&&(e[r]=n[r])}return e},u=n(5),l=r(u),c=n(34),p=r(c),f=n(207),d=r(f),h=n(206),m=r(h),v=n(86),g=({transitionName:v.nameShape.isRequired,transitionAppear:p.default.bool,transitionEnter:p.default.bool,transitionLeave:p.default.bool,transitionAppearTimeout:(0,v.transitionTimeout)("Appear"),transitionEnterTimeout:(0,v.transitionTimeout)("Enter"),transitionLeaveTimeout:(0,v.transitionTimeout)("Leave")},{transitionAppear:!1,transitionEnter:!0,transitionLeave:!0}),y=function(e){function t(){var n,r,a;o(this,t);for(var s=arguments.length,u=Array(s),c=0;c<s;c++)u[c]=arguments[c];return n=r=i(this,e.call.apply(e,[this].concat(u))),r._wrapChild=function(e){return l.default.createElement(m.default,{name:r.props.transitionName,appear:r.props.transitionAppear,enter:r.props.transitionEnter,leave:r.props.transitionLeave,appearTimeout:r.props.transitionAppearTimeout,enterTimeout:r.props.transitionEnterTimeout,leaveTimeout:r.props.transitionLeaveTimeout},e)},a=n,i(r,a)}return a(t,e),t.prototype.render=function(){return l.default.createElement(d.default,s({},this.props,{childFactory:this._wrapChild}))},t}(l.default.Component);y.displayName="CSSTransitionGroup",y.propTypes={},y.defaultProps=g,t.default=y,e.exports=t.default},function(e,t,n){"use strict";function r(e){return e&&e.__esModule?e:{default:e}}function o(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function i(e,t){if(!e)throw new ReferenceError("this hasn't been initialised - super() hasn't been called");return!t||"object"!=typeof t&&"function"!=typeof t?e:t}function a(e,t){if("function"!=typeof t&&null!==t)throw new TypeError("Super expression must either be null or a function, not "+typeof t);e.prototype=Object.create(t&&t.prototype,{constructor:{value:e,enumerable:!1,writable:!0,configurable:!0}}),t&&(Object.setPrototypeOf?Object.setPrototypeOf(e,t):e.__proto__=t)}function s(e,t){return w.length?w.forEach(function(n){return e.addEventListener(n,t,!1)}):setTimeout(t,0),function(){w.length&&w.forEach(function(n){return e.removeEventListener(n,t,!1)})}}t.__esModule=!0;var u=Object.assign||function(e){for(var t=1;t<arguments.length;t++){var n=arguments[t];for(var r in n)Object.prototype.hasOwnProperty.call(n,r)&&(e[r]=n[r])}return e},l=n(96),c=r(l),p=n(98),f=r(p),d=n(100),h=r(d),m=n(99),v=n(5),g=r(v),y=n(34),b=r(y),C=n(13),_=n(86),w=[];m.transitionEnd&&w.push(m.transitionEnd),m.animationEnd&&w.push(m.animationEnd);var E=({children:b.default.node,name:_.nameShape.isRequired,appear:b.default.bool,enter:b.default.bool,leave:b.default.bool,appearTimeout:b.default.number,enterTimeout:b.default.number,leaveTimeout:b.default.number},function(e){function t(){var n,r,a;o(this,t);for(var s=arguments.length,u=Array(s),l=0;l<s;l++)u[l]=arguments[l];return n=r=i(this,e.call.apply(e,[this].concat(u))),r.componentWillAppear=function(e){r.props.appear?r.transition("appear",e,r.props.appearTimeout):e()},r.componentWillEnter=function(e){r.props.enter?r.transition("enter",e,r.props.enterTimeout):e()},r.componentWillLeave=function(e){r.props.leave?r.transition("leave",e,r.props.leaveTimeout):e()},a=n,i(r,a)}return a(t,e),t.prototype.componentWillMount=function(){this.classNameAndNodeQueue=[],this.transitionTimeouts=[]},t.prototype.componentWillUnmount=function(){this.unmounted=!0,this.timeout&&clearTimeout(this.timeout),this.transitionTimeouts.forEach(function(e){clearTimeout(e)}),this.classNameAndNodeQueue.length=0},t.prototype.transition=function(e,t,n){var r=(0,C.findDOMNode)(this);if(!r)return void(t&&t());var o=this.props.name[e]||this.props.name+"-"+e,i=this.props.name[e+"Active"]||o+"-active",a=null,u=void 0;(0,c.default)(r,o),this.queueClassAndNode(i,r);var l=function(e){e&&e.target!==r||(clearTimeout(a),u&&u(),(0,f.default)(r,o),(0,f.default)(r,i),u&&u(),t&&t())};n?(a=setTimeout(l,n),this.transitionTimeouts.push(a)):m.transitionEnd&&(u=s(r,l))},t.prototype.queueClassAndNode=function(e,t){var n=this;this.classNameAndNodeQueue.push({className:e,node:t}),this.rafHandle||(this.rafHandle=(0,h.default)(function(){return n.flushClassNameAndNodeQueue()}))},t.prototype.flushClassNameAndNodeQueue=function(){this.unmounted||this.classNameAndNodeQueue.forEach(function(e){e.node.scrollTop,(0,c.default)(e.node,e.className)}),this.classNameAndNodeQueue.length=0,this.rafHandle=null},t.prototype.render=function(){var e=u({},this.props);return delete e.name,delete e.appear,delete e.enter,delete e.leave,delete e.appearTimeout,delete e.enterTimeout,delete e.leaveTimeout,delete e.children,g.default.cloneElement(g.default.Children.only(this.props.children),e)},t}(g.default.Component));E.displayName="CSSTransitionGroupChild",E.propTypes={},t.default=E,e.exports=t.default},function(e,t,n){"use strict";function r(e){return e&&e.__esModule?e:{default:e}}function o(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function i(e,t){if(!e)throw new ReferenceError("this hasn't been initialised - super() hasn't been called");return!t||"object"!=typeof t&&"function"!=typeof t?e:t}function a(e,t){if("function"!=typeof t&&null!==t)throw new TypeError("Super expression must either be null or a function, not "+typeof t);e.prototype=Object.create(t&&t.prototype,{constructor:{value:e,enumerable:!1,writable:!0,configurable:!0}}),t&&(Object.setPrototypeOf?Object.setPrototypeOf(e,t):e.__proto__=t)}t.__esModule=!0;var s=Object.assign||function(e){for(var t=1;t<arguments.length;t++){var n=arguments[t];for(var r in n)Object.prototype.hasOwnProperty.call(n,r)&&(e[r]=n[r])}return e},u=n(95),l=r(u),c=n(5),p=r(c),f=n(34),d=r(f),h=n(225),m=(r(h),n(210)),v=({component:d.default.any,childFactory:d.default.func,children:d.default.node},{component:"span",childFactory:function(e){return e}}),g=function(e){function t(n,r){o(this,t);var a=i(this,e.call(this,n,r));return a.performAppear=function(e,t){a.currentlyTransitioningKeys[e]=!0,t.componentWillAppear?t.componentWillAppear(a._handleDoneAppearing.bind(a,e,t)):a._handleDoneAppearing(e,t)},a._handleDoneAppearing=function(e,t){t.componentDidAppear&&t.componentDidAppear(),delete a.currentlyTransitioningKeys[e];var n=(0,m.getChildMapping)(a.props.children);n&&n.hasOwnProperty(e)||a.performLeave(e,t)},a.performEnter=function(e,t){a.currentlyTransitioningKeys[e]=!0,t.componentWillEnter?t.componentWillEnter(a._handleDoneEntering.bind(a,e,t)):a._handleDoneEntering(e,t)},a._handleDoneEntering=function(e,t){t.componentDidEnter&&t.componentDidEnter(),delete a.currentlyTransitioningKeys[e];var n=(0,m.getChildMapping)(a.props.children);n&&n.hasOwnProperty(e)||a.performLeave(e,t)},a.performLeave=function(e,t){a.currentlyTransitioningKeys[e]=!0,t.componentWillLeave?t.componentWillLeave(a._handleDoneLeaving.bind(a,e,t)):a._handleDoneLeaving(e,t)},a._handleDoneLeaving=function(e,t){t.componentDidLeave&&t.componentDidLeave(),delete a.currentlyTransitioningKeys[e];var n=(0,m.getChildMapping)(a.props.children);n&&n.hasOwnProperty(e)?a.keysToEnter.push(e):a.setState(function(t){var n=s({},t.children);return delete n[e],{children:n}})},a.childRefs=Object.create(null),a.state={children:(0,m.getChildMapping)(n.children)},a}return a(t,e),t.prototype.componentWillMount=function(){this.currentlyTransitioningKeys={},this.keysToEnter=[],this.keysToLeave=[]},t.prototype.componentDidMount=function(){var e=this.state.children;for(var t in e)e[t]&&this.performAppear(t,this.childRefs[t])},t.prototype.componentWillReceiveProps=function(e){var t=(0,m.getChildMapping)(e.children),n=this.state.children;this.setState({children:(0,m.mergeChildMappings)(n,t)});for(var r in t){var o=n&&n.hasOwnProperty(r);!t[r]||o||this.currentlyTransitioningKeys[r]||this.keysToEnter.push(r)}for(var i in n){var a=t&&t.hasOwnProperty(i);!n[i]||a||this.currentlyTransitioningKeys[i]||this.keysToLeave.push(i)}},t.prototype.componentDidUpdate=function(){var e=this,t=this.keysToEnter;this.keysToEnter=[],t.forEach(function(t){return e.performEnter(t,e.childRefs[t])});var n=this.keysToLeave;this.keysToLeave=[],n.forEach(function(t){return e.performLeave(t,e.childRefs[t])})},t.prototype.render=function(){var e=this,t=[],n=function(n){var r=e.state.children[n];if(r){var o="string"!=typeof r.ref,i=e.props.childFactory(r),a=function(t){e.childRefs[n]=t};i===r&&o&&(a=(0,l.default)(r.ref,a)),t.push(p.default.cloneElement(i,{key:n,ref:a}))}};for(var r in this.state.children)n(r);var o=s({},this.props);return delete o.transitionLeave,delete o.transitionName,delete o.transitionAppear,delete o.transitionEnter,delete o.childFactory,delete o.transitionLeaveTimeout,delete o.transitionEnterTimeout,delete o.transitionAppearTimeout,delete o.component,p.default.createElement(this.props.component,o,t)},t}(p.default.Component);g.displayName="TransitionGroup",g.propTypes={},g.defaultProps=v,t.default=g,e.exports=t.default},function(e,t,n){"use strict";function r(){}function o(){}var i=n(209);o.resetWarningCache=r,e.exports=function(){function e(e,t,n,r,o,a){if(a!==i){var s=new Error("Calling PropTypes validators directly is not supported by the `prop-types` package. Use PropTypes.checkPropTypes() to call them. Read more at http://fb.me/use-check-prop-types");throw s.name="Invariant Violation",s}}function t(){return e}e.isRequired=e;var n={array:e,bigint:e,bool:e,func:e,number:e,object:e,string:e,symbol:e,any:e,arrayOf:t,element:e,elementType:e,instanceOf:t,node:e,objectOf:t,oneOf:t,oneOfType:t,shape:t,exact:t,checkPropTypes:o,resetWarningCache:r};return n.PropTypes=n,n}},function(e,t){"use strict";var n="SECRET_DO_NOT_PASS_THIS_OR_YOU_WILL_BE_FIRED";e.exports=n},function(e,t,n){"use strict";function r(e){if(!e)return e;var t={};return i.Children.map(e,function(e){return e}).forEach(function(e){t[e.key]=e}),t}function o(e,t){function n(n){return t.hasOwnProperty(n)?t[n]:e[n]}e=e||{},t=t||{};var r={},o=[];for(var i in e)t.hasOwnProperty(i)?o.length&&(r[i]=o,o=[]):o.push(i);var a=void 0,s={};for(var u in t){if(r.hasOwnProperty(u))for(a=0;a<r[u].length;a++){var l=r[u][a];s[r[u][a]]=n(l)}s[u]=n(u)}for(a=0;a<o.length;a++)s[o[a]]=n(o[a]);return s}t.__esModule=!0,t.getChildMapping=r,t.mergeChildMappings=o;var i=n(5)},41,[228,22],function(e,t,n){"use strict";function r(e){return(""+e).replace(C,"$&/")}function o(e,t){this.func=e,this.context=t,this.count=0}function i(e,t,n){var r=e.func,o=e.context;r.call(o,t,e.count++)}function a(e,t,n){if(null==e)return e;var r=o.getPooled(t,n);g(e,i,r),o.release(r)}function s(e,t,n,r){this.result=e,this.keyPrefix=t,this.func=n,this.context=r,this.count=0}function u(e,t,n){var o=e.result,i=e.keyPrefix,a=e.func,s=e.context,u=a.call(s,t,e.count++);Array.isArray(u)?l(u,o,n,v.thatReturnsArgument):null!=u&&(m.isValidElement(u)&&(u=m.cloneAndReplaceKey(u,i+(!u.key||t&&t.key===u.key?"":r(u.key)+"/")+n)),o.push(u))}function l(e,t,n,o,i){var a="";null!=n&&(a=r(n)+"/");var l=s.getPooled(t,a,o,i);g(e,u,l),s.release(l)}function c(e,t,n){if(null==e)return e;var r=[];return l(e,r,null,t,n),r}function p(e,t,n){return null}function f(e,t){return g(e,p,null)}function d(e){var t=[];return l(e,t,null,v.thatReturnsArgument),t}var h=n(212),m=n(21),v=n(8),g=n(223),y=h.twoArgumentPooler,b=h.fourArgumentPooler,C=/\/+/g;o.prototype.destructor=function(){this.func=null,this.context=null,this.count=0},h.addPoolingTo(o,y),s.prototype.destructor=function(){this.result=null,this.keyPrefix=null,this.func=null,this.context=null,this.count=0},h.addPoolingTo(s,b);var _={forEach:a,map:c,mapIntoWithKeyPrefixInternal:l,count:f,toArray:d};e.exports=_},function(e,t,n){"use strict";function r(e){return e}function o(e,t){var n=C.hasOwnProperty(t)?C[t]:null;w.hasOwnProperty(t)&&("OVERRIDE_BASE"!==n?f("73",t):void 0),e&&("DEFINE_MANY"!==n&&"DEFINE_MANY_MERGED"!==n?f("74",t):void 0)}function i(e,t){if(t){"function"==typeof t?f("75"):void 0,m.isValidElement(t)?f("76"):void 0;var n=e.prototype,r=n.__reactAutoBindPairs;t.hasOwnProperty(y)&&_.mixins(e,t.mixins);for(var i in t)if(t.hasOwnProperty(i)&&i!==y){var a=t[i],s=n.hasOwnProperty(i);if(o(s,i),_.hasOwnProperty(i))_[i](e,a);else{var c=C.hasOwnProperty(i),p="function"==typeof a,d=p&&!c&&!s&&t.autobind!==!1;if(d)r.push(i,a),n[i]=a;else if(s){var h=C[i];!c||"DEFINE_MANY_MERGED"!==h&&"DEFINE_MANY"!==h?f("77",h,i):void 0,"DEFINE_MANY_MERGED"===h?n[i]=u(n[i],a):"DEFINE_MANY"===h&&(n[i]=l(n[i],a))}else n[i]=a}}}else;}function a(e,t){if(t)for(var n in t){var r=t[n];if(t.hasOwnProperty(n)){var o=n in _;o?f("78",n):void 0;var i=n in e;i?f("79",n):void 0,e[n]=r}}}function s(e,t){e&&t&&"object"==typeof e&&"object"==typeof t?void 0:f("80");for(var n in t)t.hasOwnProperty(n)&&(void 0!==e[n]?f("81",n):void 0,e[n]=t[n]);return e}function u(e,t){return function(){var n=e.apply(this,arguments),r=t.apply(this,arguments);if(null==n)return r;if(null==r)return n;var o={};return s(o,n),s(o,r),o}}function l(e,t){return function(){e.apply(this,arguments),t.apply(this,arguments)}}function c(e,t){var n=t.bind(e);return n}function p(e){for(var t=e.__reactAutoBindPairs,n=0;n<t.length;n+=2){var r=t[n],o=t[n+1];e[r]=c(e,o)}}var f=n(22),d=n(4),h=n(54),m=n(21),v=(n(216),n(55)),g=n(23),y=(n(1),n(2),"mixins"),b=[],C={mixins:"DEFINE_MANY",statics:"DEFINE_MANY",propTypes:"DEFINE_MANY",contextTypes:"DEFINE_MANY",childContextTypes:"DEFINE_MANY",getDefaultProps:"DEFINE_MANY_MERGED",getInitialState:"DEFINE_MANY_MERGED",getChildContext:"DEFINE_MANY_MERGED",render:"DEFINE_ONCE",componentWillMount:"DEFINE_MANY",componentDidMount:"DEFINE_MANY",componentWillReceiveProps:"DEFINE_MANY",shouldComponentUpdate:"DEFINE_ONCE",componentWillUpdate:"DEFINE_MANY",componentDidUpdate:"DEFINE_MANY",componentWillUnmount:"DEFINE_MANY",updateComponent:"OVERRIDE_BASE"},_={displayName:function(e,t){e.displayName=t},mixins:function(e,t){if(t)for(var n=0;n<t.length;n++)i(e,t[n])},childContextTypes:function(e,t){e.childContextTypes=d({},e.childContextTypes,t)},contextTypes:function(e,t){e.contextTypes=d({},e.contextTypes,t)},getDefaultProps:function(e,t){e.getDefaultProps?e.getDefaultProps=u(e.getDefaultProps,t):e.getDefaultProps=t},propTypes:function(e,t){e.propTypes=d({},e.propTypes,t)},statics:function(e,t){a(e,t)},autobind:function(){}},w={replaceState:function(e,t){this.updater.enqueueReplaceState(this,e),t&&this.updater.enqueueCallback(this,t,"replaceState")},isMounted:function(){return this.updater.isMounted(this)}},E=function(){};d(E.prototype,h.prototype,w);var T={createClass:function(e){var t=r(function(e,n,r){this.__reactAutoBindPairs.length&&p(this),this.props=e,this.context=n,this.refs=g,this.updater=r||v,this.state=null;var o=this.getInitialState?this.getInitialState():null;"object"!=typeof o||Array.isArray(o)?f("82",t.displayName||"ReactCompositeComponent"):void 0,this.state=o});t.prototype=new E,t.prototype.constructor=t,t.prototype.__reactAutoBindPairs=[],b.forEach(i.bind(null,t)),i(t,e),t.getDefaultProps&&(t.defaultProps=t.getDefaultProps()),t.prototype.render?void 0:f("83");for(var n in C)t.prototype[n]||(t.prototype[n]=null);return t},injection:{injectMixin:function(e){b.push(e)}}};e.exports=T},function(e,t,n){"use strict";var r=n(21),o=r.createFactory,i={a:o("a"),abbr:o("abbr"),address:o("address"),area:o("area"),article:o("article"),aside:o("aside"),audio:o("audio"),b:o("b"),base:o("base"),bdi:o("bdi"),bdo:o("bdo"),big:o("big"),blockquote:o("blockquote"),body:o("body"),br:o("br"),button:o("button"),canvas:o("canvas"),caption:o("caption"),cite:o("cite"),code:o("code"),col:o("col"),colgroup:o("colgroup"),data:o("data"),datalist:o("datalist"),dd:o("dd"),del:o("del"),details:o("details"),dfn:o("dfn"),dialog:o("dialog"),div:o("div"),dl:o("dl"),dt:o("dt"),em:o("em"),embed:o("embed"),fieldset:o("fieldset"),figcaption:o("figcaption"),figure:o("figure"),footer:o("footer"),form:o("form"),h1:o("h1"),h2:o("h2"),h3:o("h3"),h4:o("h4"),h5:o("h5"),h6:o("h6"),head:o("head"),header:o("header"),hgroup:o("hgroup"),hr:o("hr"),html:o("html"),i:o("i"),iframe:o("iframe"),img:o("img"),input:o("input"),ins:o("ins"),kbd:o("kbd"),keygen:o("keygen"),label:o("label"),legend:o("legend"),li:o("li"),link:o("link"),main:o("main"),map:o("map"),mark:o("mark"),menu:o("menu"),menuitem:o("menuitem"),meta:o("meta"),meter:o("meter"),nav:o("nav"),noscript:o("noscript"),object:o("object"),ol:o("ol"),optgroup:o("optgroup"),option:o("option"),output:o("output"),p:o("p"),param:o("param"),picture:o("picture"),pre:o("pre"),progress:o("progress"),q:o("q"),rp:o("rp"),rt:o("rt"),ruby:o("ruby"),s:o("s"),samp:o("samp"),script:o("script"),section:o("section"),select:o("select"),small:o("small"),source:o("source"),span:o("span"),strong:o("strong"),style:o("style"),sub:o("sub"),summary:o("summary"),sup:o("sup"),table:o("table"),tbody:o("tbody"),td:o("td"),textarea:o("textarea"),tfoot:o("tfoot"),th:o("th"),thead:o("thead"),time:o("time"),title:o("title"),tr:o("tr"),track:o("track"),u:o("u"),ul:o("ul"),var:o("var"),video:o("video"),wbr:o("wbr"),circle:o("circle"),clipPath:o("clipPath"),defs:o("defs"),ellipse:o("ellipse"),g:o("g"),image:o("image"),line:o("line"),linearGradient:o("linearGradient"),mask:o("mask"),path:o("path"),pattern:o("pattern"),polygon:o("polygon"),polyline:o("polyline"),radialGradient:o("radialGradient"),rect:o("rect"),stop:o("stop"),svg:o("svg"),text:o("text"),tspan:o("tspan")};e.exports=i},function(e,t,n){"use strict";var r={};e.exports=r},function(e,t,n){"use strict";var r=n(21),o=r.isValidElement,i=n(62);e.exports=i(o)},function(e,t,n){"use strict";function r(e,t,n){this.props=e,this.context=t,this.refs=u,this.updater=n||s}function o(){}var i=n(4),a=n(54),s=n(55),u=n(23);o.prototype=a.prototype,r.prototype=new o,r.prototype.constructor=r,i(r.prototype,a.prototype),r.prototype.isPureReactComponent=!0,e.exports=r},164,183,function(e,t){"use strict";function n(){return r++}var r=1;e.exports=n},function(e,t,n){"use strict";function r(e){return i.isValidElement(e)?void 0:o("143"),e}var o=n(22),i=n(21);n(1);e.exports=r},function(e,t,n){"use strict";function r(e,t){return e&&"object"==typeof e&&null!=e.key?l.escape(e.key):t.toString(36)}function o(e,t,n,i){var f=typeof e;if("undefined"!==f&&"boolean"!==f||(e=null),null===e||"string"===f||"number"===f||"object"===f&&e.$$typeof===s)return n(i,e,""===t?c+r(e,0):t),1;var d,h,m=0,v=""===t?c:t+p;if(Array.isArray(e))for(var g=0;g<e.length;g++)d=e[g],h=v+r(d,g),m+=o(d,h,n,i);else{var y=u(e);if(y){var b,C=y.call(e);if(y!==e.entries)for(var _=0;!(b=C.next()).done;)d=b.value,h=v+r(d,_++),m+=o(d,h,n,i);else for(;!(b=C.next()).done;){var w=b.value;w&&(d=w[1],h=v+l.escape(w[0])+p+r(d,0),m+=o(d,h,n,i))}}else if("object"===f){var E="",T=String(e);a("31","[object Object]"===T?"object with keys {"+Object.keys(e).join(", ")+"}":T,E)}}return m}function i(e,t,n){return null==e?0:o(e,"",t,n)}var a=n(22),s=(n(12),n(88)),u=n(220),l=(n(1),n(211)),c=(n(2),"."),p=":";e.exports=i},function(e,t,n){var r,o,i;!function(n,a){o=[],r=a,i="function"==typeof r?r.apply(t,o):r,!(void 0!==i&&(e.exports=i))}(this,function(){"use strict";function e(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function t(e){var n=e.getBoundingClientRect(),r={};for(var o in n)r[o]=n[o];try{if(e.ownerDocument!==document){var i=e.ownerDocument.defaultView.frameElement;if(i){var a=t(i);r.top+=a.top,r.bottom+=a.top,r.left+=a.left,r.right+=a.left}}}catch(e){}return r}function n(e){var t=getComputedStyle(e)||{},n=t.position,r=[];if("fixed"===n)return[e];for(var o=e;(o=o.parentNode)&&o&&1===o.nodeType;){var i=void 0;try{i=getComputedStyle(o)}catch(e){}if("undefined"==typeof i||null===i)return r.push(o),r;var a=i,s=a.overflow,u=a.overflowX,l=a.overflowY;/(auto|scroll|overlay)/.test(s+l+u)&&("absolute"!==n||["relative","absolute","fixed"].indexOf(i.position)>=0)&&r.push(o)}return r.push(e.ownerDocument.body),e.ownerDocument!==document&&r.push(e.ownerDocument.defaultView),r}function r(){w&&document.body.removeChild(w),w=null}function o(e){var n=void 0;e===document?(n=document,e=document.documentElement):n=e.ownerDocument;var r=n.documentElement,o=t(e),i=x();return o.top-=i.top,o.left-=i.left,"undefined"==typeof o.width&&(o.width=document.body.scrollWidth-o.left-o.right),"undefined"==typeof o.height&&(o.height=document.body.scrollHeight-o.top-o.bottom),o.top=o.top-r.clientTop,o.left=o.left-r.clientLeft,
+o.right=n.body.clientWidth-o.width-o.left,o.bottom=n.body.clientHeight-o.height-o.top,o}function i(e){return e.offsetParent||document.documentElement}function a(){if(O)return O;var e=document.createElement("div");e.style.width="100%",e.style.height="200px";var t=document.createElement("div");s(t.style,{position:"absolute",top:0,left:0,pointerEvents:"none",visibility:"hidden",width:"200px",height:"150px",overflow:"hidden"}),t.appendChild(e),document.body.appendChild(t);var n=e.offsetWidth;t.style.overflow="scroll";var r=e.offsetWidth;n===r&&(r=t.clientWidth),document.body.removeChild(t);var o=n-r;return O={width:o,height:o}}function s(){var e=arguments.length<=0||void 0===arguments[0]?{}:arguments[0],t=[];return Array.prototype.push.apply(t,arguments),t.slice(1).forEach(function(t){if(t)for(var n in t)({}).hasOwnProperty.call(t,n)&&(e[n]=t[n])}),e}function u(e,t){if("undefined"!=typeof e.classList)t.split(" ").forEach(function(t){t.trim()&&e.classList.remove(t)});else{var n=new RegExp("(^| )"+t.split(" ").join("|")+"( |$)","gi"),r=p(e).replace(n," ");f(e,r)}}function l(e,t){if("undefined"!=typeof e.classList)t.split(" ").forEach(function(t){t.trim()&&e.classList.add(t)});else{u(e,t);var n=p(e)+(" "+t);f(e,n)}}function c(e,t){if("undefined"!=typeof e.classList)return e.classList.contains(t);var n=p(e);return new RegExp("(^| )"+t+"( |$)","gi").test(n)}function p(e){return e.className instanceof e.ownerDocument.defaultView.SVGAnimatedString?e.className.baseVal:e.className}function f(e,t){e.setAttribute("class",t)}function d(e,t,n){n.forEach(function(n){t.indexOf(n)===-1&&c(e,n)&&u(e,n)}),t.forEach(function(t){c(e,t)||l(e,t)})}function e(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function h(e,t){if("function"!=typeof t&&null!==t)throw new TypeError("Super expression must either be null or a function, not "+typeof t);e.prototype=Object.create(t&&t.prototype,{constructor:{value:e,enumerable:!1,writable:!0,configurable:!0}}),t&&(Object.setPrototypeOf?Object.setPrototypeOf(e,t):e.__proto__=t)}function m(e,t){var n=arguments.length<=2||void 0===arguments[2]?1:arguments[2];return e+n>=t&&t>=e-n}function v(){return"object"==typeof performance&&"function"==typeof performance.now?performance.now():+new Date}function g(){for(var e={top:0,left:0},t=arguments.length,n=Array(t),r=0;r<t;r++)n[r]=arguments[r];return n.forEach(function(t){var n=t.top,r=t.left;"string"==typeof n&&(n=parseFloat(n,10)),"string"==typeof r&&(r=parseFloat(r,10)),e.top+=n,e.left+=r}),e}function y(e,t){return"string"==typeof e.left&&e.left.indexOf("%")!==-1&&(e.left=parseFloat(e.left,10)/100*t.width),"string"==typeof e.top&&e.top.indexOf("%")!==-1&&(e.top=parseFloat(e.top,10)/100*t.height),e}function b(e,t){return"scrollParent"===t?t=e.scrollParents[0]:"window"===t&&(t=[pageXOffset,pageYOffset,innerWidth+pageXOffset,innerHeight+pageYOffset]),t===document&&(t=t.documentElement),"undefined"!=typeof t.nodeType&&!function(){var e=t,n=o(t),r=n,i=getComputedStyle(t);if(t=[r.left,r.top,n.width+r.left,n.height+r.top],e.ownerDocument!==document){var a=e.ownerDocument.defaultView;t[0]+=a.pageXOffset,t[1]+=a.pageYOffset,t[2]+=a.pageXOffset,t[3]+=a.pageYOffset}K.forEach(function(e,n){e=e[0].toUpperCase()+e.substr(1),"Top"===e||"Left"===e?t[n]+=parseFloat(i["border"+e+"Width"]):t[n]-=parseFloat(i["border"+e+"Width"])})}(),t}var C=function(){function e(e,t){for(var n=0;n<t.length;n++){var r=t[n];r.enumerable=r.enumerable||!1,r.configurable=!0,"value"in r&&(r.writable=!0),Object.defineProperty(e,r.key,r)}}return function(t,n,r){return n&&e(t.prototype,n),r&&e(t,r),t}}(),_=void 0;"undefined"==typeof _&&(_={modules:[]});var w=null,E=function(){var e=0;return function(){return++e}}(),T={},x=function(){var e=w;e&&document.body.contains(e)||(e=document.createElement("div"),e.setAttribute("data-tether-id",E()),s(e.style,{top:0,left:0,position:"absolute"}),document.body.appendChild(e),w=e);var n=e.getAttribute("data-tether-id");return"undefined"==typeof T[n]&&(T[n]=t(e),k(function(){delete T[n]})),T[n]},O=null,P=[],k=function(e){P.push(e)},S=function(){for(var e=void 0;e=P.pop();)e()},N=function(){function t(){e(this,t)}return C(t,[{key:"on",value:function(e,t,n){var r=!(arguments.length<=3||void 0===arguments[3])&&arguments[3];"undefined"==typeof this.bindings&&(this.bindings={}),"undefined"==typeof this.bindings[e]&&(this.bindings[e]=[]),this.bindings[e].push({handler:t,ctx:n,once:r})}},{key:"once",value:function(e,t,n){this.on(e,t,n,!0)}},{key:"off",value:function(e,t){if("undefined"!=typeof this.bindings&&"undefined"!=typeof this.bindings[e])if("undefined"==typeof t)delete this.bindings[e];else for(var n=0;n<this.bindings[e].length;)this.bindings[e][n].handler===t?this.bindings[e].splice(n,1):++n}},{key:"trigger",value:function(e){if("undefined"!=typeof this.bindings&&this.bindings[e]){for(var t=0,n=arguments.length,r=Array(n>1?n-1:0),o=1;o<n;o++)r[o-1]=arguments[o];for(;t<this.bindings[e].length;){var i=this.bindings[e][t],a=i.handler,s=i.ctx,u=i.once,l=s;"undefined"==typeof l&&(l=this),a.apply(l,r),u?this.bindings[e].splice(t,1):++t}}}}]),t}();_.Utils={getActualBoundingClientRect:t,getScrollParents:n,getBounds:o,getOffsetParent:i,extend:s,addClass:l,removeClass:u,hasClass:c,updateClasses:d,defer:k,flush:S,uniqueId:E,Evented:N,getScrollBarSize:a,removeUtilElements:r};var M=function(){function e(e,t){var n=[],r=!0,o=!1,i=void 0;try{for(var a,s=e[Symbol.iterator]();!(r=(a=s.next()).done)&&(n.push(a.value),!t||n.length!==t);r=!0);}catch(e){o=!0,i=e}finally{try{!r&&s.return&&s.return()}finally{if(o)throw i}}return n}return function(t,n){if(Array.isArray(t))return t;if(Symbol.iterator in Object(t))return e(t,n);throw new TypeError("Invalid attempt to destructure non-iterable instance")}}(),C=function(){function e(e,t){for(var n=0;n<t.length;n++){var r=t[n];r.enumerable=r.enumerable||!1,r.configurable=!0,"value"in r&&(r.writable=!0),Object.defineProperty(e,r.key,r)}}return function(t,n,r){return n&&e(t.prototype,n),r&&e(t,r),t}}(),A=function(e,t,n){for(var r=!0;r;){var o=e,i=t,a=n;r=!1,null===o&&(o=Function.prototype);var s=Object.getOwnPropertyDescriptor(o,i);if(void 0!==s){if("value"in s)return s.value;var u=s.get;if(void 0===u)return;return u.call(a)}var l=Object.getPrototypeOf(o);if(null===l)return;e=l,t=i,n=a,r=!0,s=l=void 0}};if("undefined"==typeof _)throw new Error("You must include the utils.js file before tether.js");var I=_.Utils,n=I.getScrollParents,o=I.getBounds,i=I.getOffsetParent,s=I.extend,l=I.addClass,u=I.removeClass,d=I.updateClasses,k=I.defer,S=I.flush,a=I.getScrollBarSize,r=I.removeUtilElements,D=function(){if("undefined"==typeof document)return"";for(var e=document.createElement("div"),t=["transform","WebkitTransform","OTransform","MozTransform","msTransform"],n=0;n<t.length;++n){var r=t[n];if(void 0!==e.style[r])return r}}(),R=[],L=function(){R.forEach(function(e){e.position(!1)}),S()};!function(){var e=null,t=null,n=null,r=function r(){return"undefined"!=typeof t&&t>16?(t=Math.min(t-16,250),void(n=setTimeout(r,250))):void("undefined"!=typeof e&&v()-e<10||(null!=n&&(clearTimeout(n),n=null),e=v(),L(),t=v()-e))};"undefined"!=typeof window&&"undefined"!=typeof window.addEventListener&&["resize","scroll","touchmove"].forEach(function(e){window.addEventListener(e,r)})}();var U={center:"center",left:"right",right:"left"},F={middle:"middle",top:"bottom",bottom:"top"},j={top:0,left:0,middle:"50%",center:"50%",bottom:"100%",right:"100%"},B=function(e,t){var n=e.left,r=e.top;return"auto"===n&&(n=U[t.left]),"auto"===r&&(r=F[t.top]),{left:n,top:r}},V=function(e){var t=e.left,n=e.top;return"undefined"!=typeof j[e.left]&&(t=j[e.left]),"undefined"!=typeof j[e.top]&&(n=j[e.top]),{left:t,top:n}},W=function(e){var t=e.split(" "),n=M(t,2),r=n[0],o=n[1];return{top:r,left:o}},H=W,q=function(t){function c(t){var n=this;e(this,c),A(Object.getPrototypeOf(c.prototype),"constructor",this).call(this),this.position=this.position.bind(this),R.push(this),this.history=[],this.setOptions(t,!1),_.modules.forEach(function(e){"undefined"!=typeof e.initialize&&e.initialize.call(n)}),this.position()}return h(c,t),C(c,[{key:"getClass",value:function(){var e=arguments.length<=0||void 0===arguments[0]?"":arguments[0],t=this.options.classes;return"undefined"!=typeof t&&t[e]?this.options.classes[e]:this.options.classPrefix?this.options.classPrefix+"-"+e:e}},{key:"setOptions",value:function(e){var t=this,r=arguments.length<=1||void 0===arguments[1]||arguments[1],o={offset:"0 0",targetOffset:"0 0",targetAttachment:"auto auto",classPrefix:"tether"};this.options=s(o,e);var i=this.options,a=i.element,u=i.target,c=i.targetModifier;if(this.element=a,this.target=u,this.targetModifier=c,"viewport"===this.target?(this.target=document.body,this.targetModifier="visible"):"scroll-handle"===this.target&&(this.target=document.body,this.targetModifier="scroll-handle"),["element","target"].forEach(function(e){if("undefined"==typeof t[e])throw new Error("Tether Error: Both element and target must be defined");"undefined"!=typeof t[e].jquery?t[e]=t[e][0]:"string"==typeof t[e]&&(t[e]=document.querySelector(t[e]))}),l(this.element,this.getClass("element")),this.options.addTargetClasses!==!1&&l(this.target,this.getClass("target")),!this.options.attachment)throw new Error("Tether Error: You must provide an attachment");this.targetAttachment=H(this.options.targetAttachment),this.attachment=H(this.options.attachment),this.offset=W(this.options.offset),this.targetOffset=W(this.options.targetOffset),"undefined"!=typeof this.scrollParents&&this.disable(),"scroll-handle"===this.targetModifier?this.scrollParents=[this.target]:this.scrollParents=n(this.target),this.options.enabled!==!1&&this.enable(r)}},{key:"getTargetBounds",value:function(){if("undefined"==typeof this.targetModifier)return o(this.target);if("visible"===this.targetModifier){if(this.target===document.body)return{top:pageYOffset,left:pageXOffset,height:innerHeight,width:innerWidth};var e=o(this.target),t={height:e.height,width:e.width,top:e.top,left:e.left};return t.height=Math.min(t.height,e.height-(pageYOffset-e.top)),t.height=Math.min(t.height,e.height-(e.top+e.height-(pageYOffset+innerHeight))),t.height=Math.min(innerHeight,t.height),t.height-=2,t.width=Math.min(t.width,e.width-(pageXOffset-e.left)),t.width=Math.min(t.width,e.width-(e.left+e.width-(pageXOffset+innerWidth))),t.width=Math.min(innerWidth,t.width),t.width-=2,t.top<pageYOffset&&(t.top=pageYOffset),t.left<pageXOffset&&(t.left=pageXOffset),t}if("scroll-handle"===this.targetModifier){var e=void 0,n=this.target;n===document.body?(n=document.documentElement,e={left:pageXOffset,top:pageYOffset,height:innerHeight,width:innerWidth}):e=o(n);var r=getComputedStyle(n),i=n.scrollWidth>n.clientWidth||[r.overflow,r.overflowX].indexOf("scroll")>=0||this.target!==document.body,a=0;i&&(a=15);var s=e.height-parseFloat(r.borderTopWidth)-parseFloat(r.borderBottomWidth)-a,t={width:15,height:.975*s*(s/n.scrollHeight),left:e.left+e.width-parseFloat(r.borderLeftWidth)-15},u=0;s<408&&this.target===document.body&&(u=-11e-5*Math.pow(s,2)-.00727*s+22.58),this.target!==document.body&&(t.height=Math.max(t.height,24));var l=this.target.scrollTop/(n.scrollHeight-s);return t.top=l*(s-t.height-u)+e.top+parseFloat(r.borderTopWidth),this.target===document.body&&(t.height=Math.max(t.height,24)),t}}},{key:"clearCache",value:function(){this._cache={}}},{key:"cache",value:function(e,t){return"undefined"==typeof this._cache&&(this._cache={}),"undefined"==typeof this._cache[e]&&(this._cache[e]=t.call(this)),this._cache[e]}},{key:"enable",value:function(){var e=this,t=arguments.length<=0||void 0===arguments[0]||arguments[0];this.options.addTargetClasses!==!1&&l(this.target,this.getClass("enabled")),l(this.element,this.getClass("enabled")),this.enabled=!0,this.scrollParents.forEach(function(t){t!==e.target.ownerDocument&&t.addEventListener("scroll",e.position)}),t&&this.position()}},{key:"disable",value:function(){var e=this;u(this.target,this.getClass("enabled")),u(this.element,this.getClass("enabled")),this.enabled=!1,"undefined"!=typeof this.scrollParents&&this.scrollParents.forEach(function(t){t.removeEventListener("scroll",e.position)})}},{key:"destroy",value:function(){var e=this;this.disable(),R.forEach(function(t,n){t===e&&R.splice(n,1)}),0===R.length&&r()}},{key:"updateAttachClasses",value:function(e,t){var n=this;e=e||this.attachment,t=t||this.targetAttachment;var r=["left","top","bottom","right","middle","center"];"undefined"!=typeof this._addAttachClasses&&this._addAttachClasses.length&&this._addAttachClasses.splice(0,this._addAttachClasses.length),"undefined"==typeof this._addAttachClasses&&(this._addAttachClasses=[]);var o=this._addAttachClasses;e.top&&o.push(this.getClass("element-attached")+"-"+e.top),e.left&&o.push(this.getClass("element-attached")+"-"+e.left),t.top&&o.push(this.getClass("target-attached")+"-"+t.top),t.left&&o.push(this.getClass("target-attached")+"-"+t.left);var i=[];r.forEach(function(e){i.push(n.getClass("element-attached")+"-"+e),i.push(n.getClass("target-attached")+"-"+e)}),k(function(){"undefined"!=typeof n._addAttachClasses&&(d(n.element,n._addAttachClasses,i),n.options.addTargetClasses!==!1&&d(n.target,n._addAttachClasses,i),delete n._addAttachClasses)})}},{key:"position",value:function(){var e=this,t=arguments.length<=0||void 0===arguments[0]||arguments[0];if(this.enabled){this.clearCache();var n=B(this.targetAttachment,this.attachment);this.updateAttachClasses(this.attachment,n);var r=this.cache("element-bounds",function(){return o(e.element)}),s=r.width,u=r.height;if(0===s&&0===u&&"undefined"!=typeof this.lastSize){var l=this.lastSize;s=l.width,u=l.height}else this.lastSize={width:s,height:u};var c=this.cache("target-bounds",function(){return e.getTargetBounds()}),p=c,f=y(V(this.attachment),{width:s,height:u}),d=y(V(n),p),h=y(this.offset,{width:s,height:u}),m=y(this.targetOffset,p);f=g(f,h),d=g(d,m);for(var v=c.left+d.left-f.left,b=c.top+d.top-f.top,C=0;C<_.modules.length;++C){var w=_.modules[C],E=w.position.call(this,{left:v,top:b,targetAttachment:n,targetPos:c,elementPos:r,offset:f,targetOffset:d,manualOffset:h,manualTargetOffset:m,scrollbarSize:P,attachment:this.attachment});if(E===!1)return!1;"undefined"!=typeof E&&"object"==typeof E&&(b=E.top,v=E.left)}var T={page:{top:b,left:v},viewport:{top:b-pageYOffset,bottom:pageYOffset-b-u+innerHeight,left:v-pageXOffset,right:pageXOffset-v-s+innerWidth}},x=this.target.ownerDocument,O=x.defaultView,P=void 0;return O.innerHeight>x.documentElement.clientHeight&&(P=this.cache("scrollbar-size",a),T.viewport.bottom-=P.height),O.innerWidth>x.documentElement.clientWidth&&(P=this.cache("scrollbar-size",a),T.viewport.right-=P.width),["","static"].indexOf(x.body.style.position)!==-1&&["","static"].indexOf(x.body.parentElement.style.position)!==-1||(T.page.bottom=x.body.scrollHeight-b-u,T.page.right=x.body.scrollWidth-v-s),"undefined"!=typeof this.options.optimizations&&this.options.optimizations.moveElement!==!1&&"undefined"==typeof this.targetModifier&&!function(){var t=e.cache("target-offsetparent",function(){return i(e.target)}),n=e.cache("target-offsetparent-bounds",function(){return o(t)}),r=getComputedStyle(t),a=n,s={};if(["Top","Left","Bottom","Right"].forEach(function(e){s[e.toLowerCase()]=parseFloat(r["border"+e+"Width"])}),n.right=x.body.scrollWidth-n.left-a.width+s.right,n.bottom=x.body.scrollHeight-n.top-a.height+s.bottom,T.page.top>=n.top+s.top&&T.page.bottom>=n.bottom&&T.page.left>=n.left+s.left&&T.page.right>=n.right){var u=t.scrollTop,l=t.scrollLeft;T.offset={top:T.page.top-n.top+u-s.top,left:T.page.left-n.left+l-s.left}}}(),this.move(T),this.history.unshift(T),this.history.length>3&&this.history.pop(),t&&S(),!0}}},{key:"move",value:function(e){var t=this;if("undefined"!=typeof this.element.parentNode){var n={};for(var r in e){n[r]={};for(var o in e[r]){for(var a=!1,u=0;u<this.history.length;++u){var l=this.history[u];if("undefined"!=typeof l[r]&&!m(l[r][o],e[r][o])){a=!0;break}}a||(n[r][o]=!0)}}var c={top:"",left:"",right:"",bottom:""},p=function(e,n){var r="undefined"!=typeof t.options.optimizations,o=r?t.options.optimizations.gpu:null;if(o!==!1){var i=void 0,a=void 0;e.top?(c.top=0,i=n.top):(c.bottom=0,i=-n.bottom),e.left?(c.left=0,a=n.left):(c.right=0,a=-n.right),"number"==typeof window.devicePixelRatio&&devicePixelRatio%1===0&&(a=Math.round(a*devicePixelRatio)/devicePixelRatio,i=Math.round(i*devicePixelRatio)/devicePixelRatio),c[D]="translateX("+a+"px) translateY("+i+"px)","msTransform"!==D&&(c[D]+=" translateZ(0)")}else e.top?c.top=n.top+"px":c.bottom=n.bottom+"px",e.left?c.left=n.left+"px":c.right=n.right+"px"},f=!1;if((n.page.top||n.page.bottom)&&(n.page.left||n.page.right)?(c.position="absolute",p(n.page,e.page)):(n.viewport.top||n.viewport.bottom)&&(n.viewport.left||n.viewport.right)?(c.position="fixed",p(n.viewport,e.viewport)):"undefined"!=typeof n.offset&&n.offset.top&&n.offset.left?!function(){c.position="absolute";var r=t.cache("target-offsetparent",function(){return i(t.target)});i(t.element)!==r&&k(function(){t.element.parentNode.removeChild(t.element),r.appendChild(t.element)}),p(n.offset,e.offset),f=!0}():(c.position="absolute",p({top:!0,left:!0},e.page)),!f)if(this.options.bodyElement)this.element.parentNode!==this.options.bodyElement&&this.options.bodyElement.appendChild(this.element);else{for(var d=function(e){var t=e.ownerDocument,n=t.fullscreenElement||t.webkitFullscreenElement||t.mozFullScreenElement||t.msFullscreenElement;return n===e},h=!0,v=this.element.parentNode;v&&1===v.nodeType&&"BODY"!==v.tagName&&!d(v);){if("static"!==getComputedStyle(v).position){h=!1;break}v=v.parentNode}h||(this.element.parentNode.removeChild(this.element),this.element.ownerDocument.body.appendChild(this.element))}var g={},y=!1;for(var o in c){var b=c[o],C=this.element.style[o];C!==b&&(y=!0,g[o]=b)}y&&k(function(){s(t.element.style,g),t.trigger("repositioned")})}}}]),c}(N);q.modules=[],_.position=L;var z=s(q,_),M=function(){function e(e,t){var n=[],r=!0,o=!1,i=void 0;try{for(var a,s=e[Symbol.iterator]();!(r=(a=s.next()).done)&&(n.push(a.value),!t||n.length!==t);r=!0);}catch(e){o=!0,i=e}finally{try{!r&&s.return&&s.return()}finally{if(o)throw i}}return n}return function(t,n){if(Array.isArray(t))return t;if(Symbol.iterator in Object(t))return e(t,n);throw new TypeError("Invalid attempt to destructure non-iterable instance")}}(),I=_.Utils,o=I.getBounds,s=I.extend,d=I.updateClasses,k=I.defer,K=["left","top","right","bottom"];_.modules.push({position:function(e){var t=this,n=e.top,r=e.left,i=e.targetAttachment;if(!this.options.constraints)return!0;var a=this.cache("element-bounds",function(){return o(t.element)}),u=a.height,l=a.width;if(0===l&&0===u&&"undefined"!=typeof this.lastSize){var c=this.lastSize;l=c.width,u=c.height}var p=this.cache("target-bounds",function(){return t.getTargetBounds()}),f=p.height,h=p.width,m=[this.getClass("pinned"),this.getClass("out-of-bounds")];this.options.constraints.forEach(function(e){var t=e.outOfBoundsClass,n=e.pinnedClass;t&&m.push(t),n&&m.push(n)}),m.forEach(function(e){["left","top","right","bottom"].forEach(function(t){m.push(e+"-"+t)})});var v=[],g=s({},i),y=s({},this.attachment);return this.options.constraints.forEach(function(e){var o=e.to,a=e.attachment,s=e.pin;"undefined"==typeof a&&(a="");var c=void 0,p=void 0;if(a.indexOf(" ")>=0){var d=a.split(" "),m=M(d,2);p=m[0],c=m[1]}else c=p=a;var C=b(t,o);"target"!==p&&"both"!==p||(n<C[1]&&"top"===g.top&&(n+=f,g.top="bottom"),n+u>C[3]&&"bottom"===g.top&&(n-=f,g.top="top")),"together"===p&&("top"===g.top&&("bottom"===y.top&&n<C[1]?(n+=f,g.top="bottom",n+=u,y.top="top"):"top"===y.top&&n+u>C[3]&&n-(u-f)>=C[1]&&(n-=u-f,g.top="bottom",y.top="bottom")),"bottom"===g.top&&("top"===y.top&&n+u>C[3]?(n-=f,g.top="top",n-=u,y.top="bottom"):"bottom"===y.top&&n<C[1]&&n+(2*u-f)<=C[3]&&(n+=u-f,g.top="top",y.top="top")),"middle"===g.top&&(n+u>C[3]&&"top"===y.top?(n-=u,y.top="bottom"):n<C[1]&&"bottom"===y.top&&(n+=u,y.top="top"))),"target"!==c&&"both"!==c||(r<C[0]&&"left"===g.left&&(r+=h,g.left="right"),r+l>C[2]&&"right"===g.left&&(r-=h,g.left="left")),"together"===c&&(r<C[0]&&"left"===g.left?"right"===y.left?(r+=h,g.left="right",r+=l,y.left="left"):"left"===y.left&&(r+=h,g.left="right",r-=l,y.left="right"):r+l>C[2]&&"right"===g.left?"left"===y.left?(r-=h,g.left="left",r-=l,y.left="right"):"right"===y.left&&(r-=h,g.left="left",r+=l,y.left="left"):"center"===g.left&&(r+l>C[2]&&"left"===y.left?(r-=l,y.left="right"):r<C[0]&&"right"===y.left&&(r+=l,y.left="left"))),"element"!==p&&"both"!==p||(n<C[1]&&"bottom"===y.top&&(n+=u,y.top="top"),n+u>C[3]&&"top"===y.top&&(n-=u,y.top="bottom")),"element"!==c&&"both"!==c||(r<C[0]&&("right"===y.left?(r+=l,y.left="left"):"center"===y.left&&(r+=l/2,y.left="left")),r+l>C[2]&&("left"===y.left?(r-=l,y.left="right"):"center"===y.left&&(r-=l/2,y.left="right"))),"string"==typeof s?s=s.split(",").map(function(e){return e.trim()}):s===!0&&(s=["top","left","right","bottom"]),s=s||[];var _=[],w=[];n<C[1]&&(s.indexOf("top")>=0?(n=C[1],_.push("top")):w.push("top")),n+u>C[3]&&(s.indexOf("bottom")>=0?(n=C[3]-u,_.push("bottom")):w.push("bottom")),r<C[0]&&(s.indexOf("left")>=0?(r=C[0],_.push("left")):w.push("left")),r+l>C[2]&&(s.indexOf("right")>=0?(r=C[2]-l,_.push("right")):w.push("right")),_.length&&!function(){var e=void 0;e="undefined"!=typeof t.options.pinnedClass?t.options.pinnedClass:t.getClass("pinned"),v.push(e),_.forEach(function(t){v.push(e+"-"+t)})}(),w.length&&!function(){var e=void 0;e="undefined"!=typeof t.options.outOfBoundsClass?t.options.outOfBoundsClass:t.getClass("out-of-bounds"),v.push(e),w.forEach(function(t){v.push(e+"-"+t)})}(),(_.indexOf("left")>=0||_.indexOf("right")>=0)&&(y.left=g.left=!1),(_.indexOf("top")>=0||_.indexOf("bottom")>=0)&&(y.top=g.top=!1),g.top===i.top&&g.left===i.left&&y.top===t.attachment.top&&y.left===t.attachment.left||(t.updateAttachClasses(y,g),t.trigger("update",{attachment:y,targetAttachment:g}))}),k(function(){t.options.addTargetClasses!==!1&&d(t.target,v,m),d(t.element,v,m)}),{top:n,left:r}}});var I=_.Utils,o=I.getBounds,d=I.updateClasses,k=I.defer;_.modules.push({position:function(e){var t=this,n=e.top,r=e.left,i=this.cache("element-bounds",function(){return o(t.element)}),a=i.height,s=i.width,u=this.getTargetBounds(),l=n+a,c=r+s,p=[];n<=u.bottom&&l>=u.top&&["left","right"].forEach(function(e){var t=u[e];t!==r&&t!==c||p.push(e)}),r<=u.right&&c>=u.left&&["top","bottom"].forEach(function(e){var t=u[e];t!==n&&t!==l||p.push(e)});var f=[],h=[],m=["left","top","right","bottom"];return f.push(this.getClass("abutted")),m.forEach(function(e){f.push(t.getClass("abutted")+"-"+e)}),p.length&&h.push(this.getClass("abutted")),p.forEach(function(e){h.push(t.getClass("abutted")+"-"+e)}),k(function(){t.options.addTargetClasses!==!1&&d(t.target,h,f),d(t.element,h,f)}),!0}});var M=function(){function e(e,t){var n=[],r=!0,o=!1,i=void 0;try{for(var a,s=e[Symbol.iterator]();!(r=(a=s.next()).done)&&(n.push(a.value),!t||n.length!==t);r=!0);}catch(e){o=!0,i=e}finally{try{!r&&s.return&&s.return()}finally{if(o)throw i}}return n}return function(t,n){if(Array.isArray(t))return t;if(Symbol.iterator in Object(t))return e(t,n);throw new TypeError("Invalid attempt to destructure non-iterable instance")}}();return _.modules.push({position:function(e){var t=e.top,n=e.left;if(this.options.shift){var r=this.options.shift;"function"==typeof this.options.shift&&(r=this.options.shift.call(this,{top:t,left:n}));var o=void 0,i=void 0;if("string"==typeof r){r=r.split(" "),r[1]=r[1]||r[0];var a=r,s=M(a,2);o=s[0],i=s[1],o=parseFloat(o,10),i=parseFloat(i,10)}else o=r.top,i=r.left;return t+=o,n+=i,{top:t,left:n}}}}),z})},function(e,t,n){"use strict";var r=function(){};e.exports=r},function(e,t){!function(e){"use strict";function t(e){if("string"!=typeof e&&(e=String(e)),/[^a-z0-9\-#$%&'*+.\^_`|~]/i.test(e))throw new TypeError("Invalid character in header field name");return e.toLowerCase()}function n(e){return"string"!=typeof e&&(e=String(e)),e}function r(e){var t={next:function(){var t=e.shift();return{done:void 0===t,value:t}}};return g.iterable&&(t[Symbol.iterator]=function(){return t}),t}function o(e){this.map={},e instanceof o?e.forEach(function(e,t){this.append(t,e)},this):e&&Object.getOwnPropertyNames(e).forEach(function(t){this.append(t,e[t])},this)}function i(e){return e.bodyUsed?Promise.reject(new TypeError("Already read")):void(e.bodyUsed=!0)}function a(e){return new Promise(function(t,n){e.onload=function(){t(e.result)},e.onerror=function(){n(e.error)}})}function s(e){var t=new FileReader,n=a(t);return t.readAsArrayBuffer(e),n}function u(e){var t=new FileReader,n=a(t);return t.readAsText(e),n}function l(e){for(var t=new Uint8Array(e),n=new Array(t.length),r=0;r<t.length;r++)n[r]=String.fromCharCode(t[r]);return n.join("")}function c(e){if(e.slice)return e.slice(0);var t=new Uint8Array(e.byteLength);return t.set(new Uint8Array(e)),t.buffer}function p(){return this.bodyUsed=!1,this._initBody=function(e){if(this._bodyInit=e,e)if("string"==typeof e)this._bodyText=e;else if(g.blob&&Blob.prototype.isPrototypeOf(e))this._bodyBlob=e;else if(g.formData&&FormData.prototype.isPrototypeOf(e))this._bodyFormData=e;else if(g.searchParams&&URLSearchParams.prototype.isPrototypeOf(e))this._bodyText=e.toString();else if(g.arrayBuffer&&g.blob&&b(e))this._bodyArrayBuffer=c(e.buffer),this._bodyInit=new Blob([this._bodyArrayBuffer]);else{if(!g.arrayBuffer||!ArrayBuffer.prototype.isPrototypeOf(e)&&!C(e))throw new Error("unsupported BodyInit type");this._bodyArrayBuffer=c(e)}else this._bodyText="";this.headers.get("content-type")||("string"==typeof e?this.headers.set("content-type","text/plain;charset=UTF-8"):this._bodyBlob&&this._bodyBlob.type?this.headers.set("content-type",this._bodyBlob.type):g.searchParams&&URLSearchParams.prototype.isPrototypeOf(e)&&this.headers.set("content-type","application/x-www-form-urlencoded;charset=UTF-8"))},g.blob&&(this.blob=function(){var e=i(this);if(e)return e;if(this._bodyBlob)return Promise.resolve(this._bodyBlob);if(this._bodyArrayBuffer)return Promise.resolve(new Blob([this._bodyArrayBuffer]));if(this._bodyFormData)throw new Error("could not read FormData body as blob");return Promise.resolve(new Blob([this._bodyText]))},this.arrayBuffer=function(){return this._bodyArrayBuffer?i(this)||Promise.resolve(this._bodyArrayBuffer):this.blob().then(s)}),this.text=function(){var e=i(this);if(e)return e;if(this._bodyBlob)return u(this._bodyBlob);if(this._bodyArrayBuffer)return Promise.resolve(l(this._bodyArrayBuffer));if(this._bodyFormData)throw new Error("could not read FormData body as text");return Promise.resolve(this._bodyText)},g.formData&&(this.formData=function(){return this.text().then(h)}),this.json=function(){return this.text().then(JSON.parse)},this}function f(e){var t=e.toUpperCase();return _.indexOf(t)>-1?t:e}function d(e,t){t=t||{};var n=t.body;if(e instanceof d){if(e.bodyUsed)throw new TypeError("Already read");this.url=e.url,this.credentials=e.credentials,t.headers||(this.headers=new o(e.headers)),this.method=e.method,this.mode=e.mode,n||null==e._bodyInit||(n=e._bodyInit,e.bodyUsed=!0)}else this.url=String(e);if(this.credentials=t.credentials||this.credentials||"omit",!t.headers&&this.headers||(this.headers=new o(t.headers)),this.method=f(t.method||this.method||"GET"),this.mode=t.mode||this.mode||null,this.referrer=null,("GET"===this.method||"HEAD"===this.method)&&n)throw new TypeError("Body not allowed for GET or HEAD requests");this._initBody(n)}function h(e){var t=new FormData;return e.trim().split("&").forEach(function(e){if(e){var n=e.split("="),r=n.shift().replace(/\+/g," "),o=n.join("=").replace(/\+/g," ");t.append(decodeURIComponent(r),decodeURIComponent(o))}}),t}function m(e){var t=new o;return e.split(/\r?\n/).forEach(function(e){var n=e.split(":"),r=n.shift().trim();if(r){var o=n.join(":").trim();t.append(r,o)}}),t}function v(e,t){t||(t={}),this.type="default",this.status="status"in t?t.status:200,this.ok=this.status>=200&&this.status<300,this.statusText="statusText"in t?t.statusText:"OK",this.headers=new o(t.headers),this.url=t.url||"",this._initBody(e)}if(!e.fetch){var g={searchParams:"URLSearchParams"in e,iterable:"Symbol"in e&&"iterator"in Symbol,blob:"FileReader"in e&&"Blob"in e&&function(){try{return new Blob,!0}catch(e){return!1}}(),formData:"FormData"in e,arrayBuffer:"ArrayBuffer"in e};if(g.arrayBuffer)var y=["[object Int8Array]","[object Uint8Array]","[object Uint8ClampedArray]","[object Int16Array]","[object Uint16Array]","[object Int32Array]","[object Uint32Array]","[object Float32Array]","[object Float64Array]"],b=function(e){return e&&DataView.prototype.isPrototypeOf(e)},C=ArrayBuffer.isView||function(e){return e&&y.indexOf(Object.prototype.toString.call(e))>-1};o.prototype.append=function(e,r){e=t(e),r=n(r);var o=this.map[e];this.map[e]=o?o+","+r:r},o.prototype.delete=function(e){delete this.map[t(e)]},o.prototype.get=function(e){return e=t(e),this.has(e)?this.map[e]:null},o.prototype.has=function(e){return this.map.hasOwnProperty(t(e))},o.prototype.set=function(e,r){this.map[t(e)]=n(r)},o.prototype.forEach=function(e,t){for(var n in this.map)this.map.hasOwnProperty(n)&&e.call(t,this.map[n],n,this)},o.prototype.keys=function(){var e=[];return this.forEach(function(t,n){e.push(n)}),r(e)},o.prototype.values=function(){var e=[];return this.forEach(function(t){e.push(t)}),r(e)},o.prototype.entries=function(){var e=[];return this.forEach(function(t,n){e.push([n,t])}),r(e)},g.iterable&&(o.prototype[Symbol.iterator]=o.prototype.entries);var _=["DELETE","GET","HEAD","OPTIONS","POST","PUT"];d.prototype.clone=function(){return new d(this,{body:this._bodyInit})},p.call(d.prototype),p.call(v.prototype),v.prototype.clone=function(){return new v(this._bodyInit,{status:this.status,statusText:this.statusText,headers:new o(this.headers),url:this.url})},v.error=function(){var e=new v(null,{status:0,statusText:""});return e.type="error",e};var w=[301,302,303,307,308];v.redirect=function(e,t){if(w.indexOf(t)===-1)throw new RangeError("Invalid status code");return new v(null,{status:t,headers:{location:e}})},e.Headers=o,e.Request=d,e.Response=v,e.fetch=function(e,t){return new Promise(function(n,r){var o=new d(e,t),i=new XMLHttpRequest;i.onload=function(){var e={status:i.status,statusText:i.statusText,headers:m(i.getAllResponseHeaders()||"")};e.url="responseURL"in i?i.responseURL:e.headers.get("X-Request-URL");var t="response"in i?i.response:i.responseText;n(new v(t,e))},i.onerror=function(){r(new TypeError("Network request failed"))},i.ontimeout=function(){r(new TypeError("Network request failed"))},i.open(o.method,o.url,!0),"include"===o.credentials&&(i.withCredentials=!0),"responseType"in i&&g.blob&&(i.responseType="blob"),o.headers.forEach(function(e,t){i.setRequestHeader(t,e)}),i.send("undefined"==typeof o._bodyInit?null:o._bodyInit)})},e.fetch.polyfill=!0}}("undefined"!=typeof self?self:this)},function(e,t,n,r,o,i,a,s){function u(e,t){var n,r=function(o){return e.length>1?function(){var i=o?o.concat():[];return n=t?n||this:this,i.push.apply(i,arguments)<e.length&&arguments.length?r.call(n,i):e.apply(n,i)}:e};return r()}var l,c,p,f,d,h,m,v,g,y={}.toString;l=n(r),c=n(o),p=n(i),f=n(a),d=n(s),h=function(e){return e},m=u(function(e,t){return y.call(t).slice(8,-1)===e}),v=u(function(e,t){var n,r=[];for(n=0;n<e;++n)r.push(t);return r}),f.empty=c.empty,f.slice=c.slice,f.take=c.take,f.drop=c.drop,f.splitAt=c.splitAt,f.takeWhile=c.takeWhile,f.dropWhile=c.dropWhile,f.span=c.span,f.breakStr=c.breakList,g={Func:l,List:c,Obj:p,Str:f,Num:d,id:h,isType:m,replicate:v},g.each=c.each,g.map=c.map,g.filter=c.filter,g.compact=c.compact,g.reject=c.reject,g.partition=c.partition,g.find=c.find,g.head=c.head,g.first=c.first,g.tail=c.tail,g.last=c.last,g.initial=c.initial,g.empty=c.empty,g.reverse=c.reverse,g.difference=c.difference,g.intersection=c.intersection,g.union=c.union,g.countBy=c.countBy,g.groupBy=c.groupBy,g.fold=c.fold,g.foldl=c.foldl,g.fold1=c.fold1,g.foldl1=c.foldl1,
+g.foldr=c.foldr,g.foldr1=c.foldr1,g.unfoldr=c.unfoldr,g.andList=c.andList,g.orList=c.orList,g.any=c.any,g.all=c.all,g.unique=c.unique,g.uniqueBy=c.uniqueBy,g.sort=c.sort,g.sortWith=c.sortWith,g.sortBy=c.sortBy,g.sum=c.sum,g.product=c.product,g.mean=c.mean,g.average=c.average,g.concat=c.concat,g.concatMap=c.concatMap,g.flatten=c.flatten,g.maximum=c.maximum,g.minimum=c.minimum,g.maximumBy=c.maximumBy,g.minimumBy=c.minimumBy,g.scan=c.scan,g.scanl=c.scanl,g.scan1=c.scan1,g.scanl1=c.scanl1,g.scanr=c.scanr,g.scanr1=c.scanr1,g.slice=c.slice,g.take=c.take,g.drop=c.drop,g.splitAt=c.splitAt,g.takeWhile=c.takeWhile,g.dropWhile=c.dropWhile,g.span=c.span,g.breakList=c.breakList,g.zip=c.zip,g.zipWith=c.zipWith,g.zipAll=c.zipAll,g.zipAllWith=c.zipAllWith,g.at=c.at,g.elemIndex=c.elemIndex,g.elemIndices=c.elemIndices,g.findIndex=c.findIndex,g.findIndices=c.findIndices,g.apply=l.apply,g.curry=l.curry,g.flip=l.flip,g.fix=l.fix,g.over=l.over,g.split=f.split,g.join=f.join,g.lines=f.lines,g.unlines=f.unlines,g.words=f.words,g.unwords=f.unwords,g.chars=f.chars,g.unchars=f.unchars,g.repeat=f.repeat,g.capitalize=f.capitalize,g.camelize=f.camelize,g.dasherize=f.dasherize,g.values=p.values,g.keys=p.keys,g.pairsToObj=p.pairsToObj,g.objToPairs=p.objToPairs,g.listsToObj=p.listsToObj,g.objToLists=p.objToLists,g.max=d.max,g.min=d.min,g.negate=d.negate,g.abs=d.abs,g.signum=d.signum,g.quot=d.quot,g.rem=d.rem,g.div=d.div,g.mod=d.mod,g.recip=d.recip,g.pi=d.pi,g.tau=d.tau,g.exp=d.exp,g.sqrt=d.sqrt,g.ln=d.ln,g.pow=d.pow,g.sin=d.sin,g.tan=d.tan,g.cos=d.cos,g.acos=d.acos,g.asin=d.asin,g.atan=d.atan,g.atan2=d.atan2,g.truncate=d.truncate,g.round=d.round,g.ceiling=d.ceiling,g.floor=d.floor,g.isItNaN=d.isItNaN,g.even=d.even,g.odd=d.odd,g.gcd=d.gcd,g.lcm=d.lcm,g.VERSION="1.2.1",e.exports=g},function(e,t,n,r){"use strict";var o=n(r),i=(n(1),function(e){var t=this;if(t.instancePool.length){var n=t.instancePool.pop();return t.call(n,e),n}return new t(e)}),a=function(e,t){var n=this;if(n.instancePool.length){var r=n.instancePool.pop();return n.call(r,e,t),r}return new n(e,t)},s=function(e,t,n){var r=this;if(r.instancePool.length){var o=r.instancePool.pop();return r.call(o,e,t,n),o}return new r(e,t,n)},u=function(e,t,n,r){var o=this;if(o.instancePool.length){var i=o.instancePool.pop();return o.call(i,e,t,n,r),i}return new o(e,t,n,r)},l=function(e){var t=this;e instanceof t?void 0:o("25"),e.destructor(),t.instancePool.length<t.poolSize&&t.instancePool.push(e)},c=10,p=i,f=function(e,t){var n=e;return n.instancePool=[],n.getPooled=t||p,n.poolSize||(n.poolSize=c),n.release=l,n},d={addPoolingTo:f,oneArgumentPooler:i,twoArgumentPooler:a,threeArgumentPooler:s,fourArgumentPooler:u};e.exports=d}]));
+//# sourceMappingURL=main.33e618c9.js.map
\ No newline at end of file

From ac520d656b0852402cb6eb8dd50497b423872e6a Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 19 Aug 2022 10:41:02 -0700
Subject: [PATCH 168/743] Add "does not begin with" and "does not end with"
 condition operators

---
 plexpy/notification_handler.py | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/plexpy/notification_handler.py b/plexpy/notification_handler.py
index 497973be..ed4e60b3 100644
--- a/plexpy/notification_handler.py
+++ b/plexpy/notification_handler.py
@@ -339,9 +339,15 @@ def notify_custom_conditions(notifier_id=None, parameters=None):
             elif operator == 'begins with':
                 evaluated = parameter_value.startswith(tuple(values))
 
+            elif operator == 'does not begin with':
+                evaluated = not parameter_value.startswith(tuple(values))
+
             elif operator == 'ends with':
                 evaluated = parameter_value.endswith(tuple(values))
 
+            elif operator == 'does not end with':
+                evaluated = not parameter_value.endswith(tuple(values))
+
             elif operator == 'is greater than':
                 evaluated = any(parameter_value > c for c in values)
 

From 70256dd0b977987609f07099f88d216562d3807c Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 23 Aug 2022 10:48:01 -0700
Subject: [PATCH 169/743] Update snap login in workflow

---
 .github/workflows/publish-snap.yml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/publish-snap.yml b/.github/workflows/publish-snap.yml
index 26fb174c..b62f2e01 100644
--- a/.github/workflows/publish-snap.yml
+++ b/.github/workflows/publish-snap.yml
@@ -59,8 +59,9 @@ jobs:
       - name: Publish Snap Package
         uses: snapcore/action-publish@v1
         if: startsWith(github.ref, 'refs/tags/') || github.ref == 'refs/heads/nightly'
+        env:
+          SNAPCRAFT_STORE_CREDENTIALS: ${{ secrets.SNAP_LOGIN }}
         with:
-          store_login: ${{ secrets.SNAP_LOGIN }}
           snap: ${{ steps.build.outputs.snap }}
           release: ${{ steps.prepare.outputs.RELEASE }}
 

From 806c8814b64af3cfa5b8ef93335199a6106ca038 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 23 Aug 2022 11:22:54 -0700
Subject: [PATCH 170/743] Unpin QEMU in snap workflow

---
 .github/workflows/publish-snap.yml | 2 --
 1 file changed, 2 deletions(-)

diff --git a/.github/workflows/publish-snap.yml b/.github/workflows/publish-snap.yml
index b62f2e01..27682148 100644
--- a/.github/workflows/publish-snap.yml
+++ b/.github/workflows/publish-snap.yml
@@ -36,8 +36,6 @@ jobs:
 
       - name: Set Up QEMU
         uses: docker/setup-qemu-action@v2
-        with:
-          image: tonistiigi/binfmt@sha256:df15403e06a03c2f461c1f7938b171fda34a5849eb63a70e2a2109ed5a778bde
 
       - name: Build Snap Package
         uses: diddlesnaps/snapcraft-multiarch-action@v1

From 925efe0db771b3953d62e8831bb8f1210e3a07f2 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Fri, 26 Aug 2022 09:17:13 -0700
Subject: [PATCH 171/743] Bump actions/cache from 3.0.6 to 3.0.8 (#1822)

Bumps [actions/cache](https://github.com/actions/cache) from 3.0.6 to 3.0.8.
- [Release notes](https://github.com/actions/cache/releases)
- [Changelog](https://github.com/actions/cache/blob/main/RELEASES.md)
- [Commits](https://github.com/actions/cache/compare/v3.0.6...v3.0.8)

---
updated-dependencies:
- dependency-name: actions/cache
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 .github/workflows/publish-docker.yml     | 2 +-
 .github/workflows/publish-installers.yml | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/publish-docker.yml b/.github/workflows/publish-docker.yml
index 39533cb6..773f730f 100644
--- a/.github/workflows/publish-docker.yml
+++ b/.github/workflows/publish-docker.yml
@@ -47,7 +47,7 @@ jobs:
           version: latest
 
       - name: Cache Docker Layers
-        uses: actions/cache@v3.0.6
+        uses: actions/cache@v3.0.8
         with:
           path: /tmp/.buildx-cache
           key: ${{ runner.os }}-buildx-${{ github.sha }}
diff --git a/.github/workflows/publish-installers.yml b/.github/workflows/publish-installers.yml
index ffb1f2ee..6b9b9c8b 100644
--- a/.github/workflows/publish-installers.yml
+++ b/.github/workflows/publish-installers.yml
@@ -57,7 +57,7 @@ jobs:
           python-version: 3.9
 
       - name: Cache Dependencies
-        uses: actions/cache@v3.0.6
+        uses: actions/cache@v3.0.8
         with:
           path: ~\AppData\Local\pip\Cache
           key: ${{ runner.os }}-pip-${{ hashFiles('package/requirements-package.txt') }}

From 41b796e007764a95a18bc0779f3ef2e02e943bfa Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 5 Sep 2022 11:07:25 -0700
Subject: [PATCH 172/743] v2.10.4

---
 CHANGELOG.md      | 11 +++++++++++
 plexpy/version.py |  2 +-
 2 files changed, 12 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index cb1af251..abd4cc2c 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,16 @@
 # Changelog
 
+## v2.10.4 (2022-09-05)
+
+* Activity:
+  * New: Added tooltip for quality profile on activity cards.
+* Notifications:
+  * New: Added "does not begin with" and "does not end with" condition operators.
+* UI:
+  * Fix: Album count showing 0 on library statistics.
+  * Fix: Library statistics not showing up for libraries without any history.
+
+
 ## v2.10.3 (2022-08-09)
 
 * Notifications:
diff --git a/plexpy/version.py b/plexpy/version.py
index 0b033d3d..a338dabd 100644
--- a/plexpy/version.py
+++ b/plexpy/version.py
@@ -18,4 +18,4 @@
 from __future__ import unicode_literals
 
 PLEXPY_BRANCH = "master"
-PLEXPY_RELEASE_VERSION = "v2.10.3"
+PLEXPY_RELEASE_VERSION = "v2.10.4"

From 0a6b12329cbeb21285bde0f62bdf2ab8ba393b29 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 9 Sep 2022 16:14:31 -0700
Subject: [PATCH 173/743] Link to MusicBrainz track for notifications

---
 plexpy/notification_handler.py | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/plexpy/notification_handler.py b/plexpy/notification_handler.py
index ed4e60b3..1fc6ff83 100644
--- a/plexpy/notification_handler.py
+++ b/plexpy/notification_handler.py
@@ -652,7 +652,7 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
     # Check external guids
     if notify_params['media_type'] == 'episode':
         guids = notify_params['grandparent_guids']
-    elif notify_params['media_type'] in ('season', 'track'):
+    elif notify_params['media_type'] == 'season':
         guids = notify_params['parent_guids']
     else:
         guids = notify_params['guids']
@@ -704,8 +704,10 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
     if 'mbid://' in notify_params['guid'] or notify_params['musicbrainz_id']:
         if notify_params['media_type'] == 'artist':
             notify_params['musicbrainz_url'] = 'https://musicbrainz.org/artist/' + notify_params['musicbrainz_id']
-        else:
+        elif notify_params['media_type'] == 'album':
             notify_params['musicbrainz_url'] = 'https://musicbrainz.org/release/' + notify_params['musicbrainz_id']
+        else:
+            notify_params['musicbrainz_url'] = 'https://musicbrainz.org/track/' + notify_params['musicbrainz_id']
 
     # Get TheMovieDB info (for movies and tv only)
     if plexpy.CONFIG.THEMOVIEDB_LOOKUP and notify_params['media_type'] in ('movie', 'show', 'season', 'episode'):

From 54af528f6c0ccd227a24e7c0ca43a7effded7256 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 10 Sep 2022 09:17:01 -0700
Subject: [PATCH 174/743] Add submit-winget.yml workflow

---
 .github/workflows/submit-winget.yml | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)
 create mode 100644 .github/workflows/submit-winget.yml

diff --git a/.github/workflows/submit-winget.yml b/.github/workflows/submit-winget.yml
new file mode 100644
index 00000000..de943c29
--- /dev/null
+++ b/.github/workflows/submit-winget.yml
@@ -0,0 +1,24 @@
+name: Submit Tautulli package to Windows Package Manager Community Repository
+
+on:
+  workflow_dispatch: ~
+  release:
+    types: [published]
+
+jobs:
+  winget:
+    name: Publish Winget Package
+    runs-on: windows-latest
+    steps:
+      - name: Submit package to Windows Package Manager Community Repository
+        run: |
+          $wingetPackage = "Tautulli.Tautulli"
+          $gitToken = "${{ secrets.GITHUB_TOKEN }}"
+
+          $github = Invoke-RestMethod -uri "https://api.github.com/repos/Tautulli/Tautulli/releases/latest"
+          $installerUrl = $github | Select -ExpandProperty assets -First 1 | Where-Object -Property name -match "Tautulli-windows-.*-x64.exe" | Select -ExpandProperty browser_download_url
+          $version = "$($github.tag_name.Trim('v')).1"
+          
+          # getting latest wingetcreate file
+          iwr https://aka.ms/wingetcreate/latest -OutFile wingetcreate.exe
+          .\wingetcreate.exe update $wingetPackage -s -v $version -u $installerUrl -t $gitToken

From 5ace9e163d04e49a8eb0c5555eab5e9dc31bb5a7 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 12 Sep 2022 16:47:06 -0700
Subject: [PATCH 175/743] Set default library count to 0

---
 plexpy/pmsconnect.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/plexpy/pmsconnect.py b/plexpy/pmsconnect.py
index 7149836d..30e82f18 100644
--- a/plexpy/pmsconnect.py
+++ b/plexpy/pmsconnect.py
@@ -2757,6 +2757,7 @@ class PmsConnect(object):
             return []
 
 
+        library_count = '0'
         children_list = []
 
         for a in xml_head:

From 90cf863305f6f6c381e8381943a32fbb6eedd002 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 15 Sep 2022 10:05:57 -0700
Subject: [PATCH 176/743] Update pip cache in publish-installers workflow

---
 .github/workflows/publish-installers.yml | 11 +++--------
 1 file changed, 3 insertions(+), 8 deletions(-)

diff --git a/.github/workflows/publish-installers.yml b/.github/workflows/publish-installers.yml
index 6b9b9c8b..ad590098 100644
--- a/.github/workflows/publish-installers.yml
+++ b/.github/workflows/publish-installers.yml
@@ -54,14 +54,9 @@ jobs:
       - name: Set Up Python
         uses: actions/setup-python@v4.2.0
         with:
-          python-version: 3.9
-
-      - name: Cache Dependencies
-        uses: actions/cache@v3.0.8
-        with:
-          path: ~\AppData\Local\pip\Cache
-          key: ${{ runner.os }}-pip-${{ hashFiles('package/requirements-package.txt') }}
-          restore-keys: ${{ runner.os }}-pip-
+          python-version: '3.9'
+          cache: pip
+          cache-dependency-path: '**/requirements*.txt'
 
       - name: Install Dependencies
         run: |

From a8be53e0dcebad2329360a2d51dfb924ea472415 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 27 Sep 2022 21:18:52 +0000
Subject: [PATCH 177/743] Add edition_title to metadata details

---
 plexpy/pmsconnect.py | 11 +++++++++++
 plexpy/webserve.py   |  1 +
 2 files changed, 12 insertions(+)

diff --git a/plexpy/pmsconnect.py b/plexpy/pmsconnect.py
index 30e82f18..e83a0a2d 100644
--- a/plexpy/pmsconnect.py
+++ b/plexpy/pmsconnect.py
@@ -786,6 +786,7 @@ class PmsConnect(object):
                         'grandparent_title': helpers.get_xml_attr(metadata_main, 'grandparentTitle'),
                         'original_title': helpers.get_xml_attr(metadata_main, 'originalTitle'),
                         'sort_title': helpers.get_xml_attr(metadata_main, 'titleSort'),
+                        'edition_title': helpers.get_xml_attr(metadata_main, 'editionTitle'),
                         'media_index': helpers.get_xml_attr(metadata_main, 'index'),
                         'parent_media_index': helpers.get_xml_attr(metadata_main, 'parentIndex'),
                         'studio': helpers.get_xml_attr(metadata_main, 'studio'),
@@ -844,6 +845,7 @@ class PmsConnect(object):
                         'grandparent_title': helpers.get_xml_attr(metadata_main, 'grandparentTitle'),
                         'original_title': helpers.get_xml_attr(metadata_main, 'originalTitle'),
                         'sort_title': helpers.get_xml_attr(metadata_main, 'titleSort'),
+                        'edition_title': helpers.get_xml_attr(metadata_main, 'editionTitle'),
                         'media_index': helpers.get_xml_attr(metadata_main, 'index'),
                         'parent_media_index': helpers.get_xml_attr(metadata_main, 'parentIndex'),
                         'studio': helpers.get_xml_attr(metadata_main, 'studio'),
@@ -905,6 +907,7 @@ class PmsConnect(object):
                         'grandparent_title': helpers.get_xml_attr(metadata_main, 'grandparentTitle'),
                         'original_title': helpers.get_xml_attr(metadata_main, 'originalTitle'),
                         'sort_title': helpers.get_xml_attr(metadata_main, 'titleSort'),
+                        'edition_title': helpers.get_xml_attr(metadata_main, 'editionTitle'),
                         'media_index': helpers.get_xml_attr(metadata_main, 'index'),
                         'parent_media_index': helpers.get_xml_attr(metadata_main, 'parentIndex'),
                         'studio': show_details.get('studio', ''),
@@ -983,6 +986,7 @@ class PmsConnect(object):
                         'grandparent_title': helpers.get_xml_attr(metadata_main, 'grandparentTitle'),
                         'original_title': helpers.get_xml_attr(metadata_main, 'originalTitle'),
                         'sort_title': helpers.get_xml_attr(metadata_main, 'titleSort'),
+                        'edition_title': helpers.get_xml_attr(metadata_main, 'editionTitle'),
                         'media_index': helpers.get_xml_attr(metadata_main, 'index'),
                         'parent_media_index': parent_media_index,
                         'studio': show_details.get('studio', ''),
@@ -1037,6 +1041,7 @@ class PmsConnect(object):
                         'grandparent_title': helpers.get_xml_attr(metadata_main, 'grandparentTitle'),
                         'original_title': helpers.get_xml_attr(metadata_main, 'originalTitle'),
                         'sort_title': helpers.get_xml_attr(metadata_main, 'titleSort'),
+                        'edition_title': helpers.get_xml_attr(metadata_main, 'editionTitle'),
                         'media_index': helpers.get_xml_attr(metadata_main, 'index'),
                         'parent_media_index': helpers.get_xml_attr(metadata_main, 'parentIndex'),
                         'studio': helpers.get_xml_attr(metadata_main, 'studio'),
@@ -1092,6 +1097,7 @@ class PmsConnect(object):
                         'grandparent_title': helpers.get_xml_attr(metadata_main, 'grandparentTitle'),
                         'original_title': helpers.get_xml_attr(metadata_main, 'originalTitle'),
                         'sort_title': helpers.get_xml_attr(metadata_main, 'titleSort'),
+                        'edition_title': helpers.get_xml_attr(metadata_main, 'editionTitle'),
                         'media_index': helpers.get_xml_attr(metadata_main, 'index'),
                         'parent_media_index': helpers.get_xml_attr(metadata_main, 'parentIndex'),
                         'studio': helpers.get_xml_attr(metadata_main, 'studio'),
@@ -1150,6 +1156,7 @@ class PmsConnect(object):
                         'grandparent_title': helpers.get_xml_attr(metadata_main, 'grandparentTitle'),
                         'original_title': helpers.get_xml_attr(metadata_main, 'originalTitle'),
                         'sort_title': helpers.get_xml_attr(metadata_main, 'titleSort'),
+                        'edition_title': helpers.get_xml_attr(metadata_main, 'editionTitle'),
                         'media_index': helpers.get_xml_attr(metadata_main, 'index'),
                         'parent_media_index': helpers.get_xml_attr(metadata_main, 'parentIndex'),
                         'studio': helpers.get_xml_attr(metadata_main, 'studio'),
@@ -1204,6 +1211,7 @@ class PmsConnect(object):
                         'grandparent_title': helpers.get_xml_attr(metadata_main, 'grandparentTitle'),
                         'original_title': helpers.get_xml_attr(metadata_main, 'originalTitle'),
                         'sort_title': helpers.get_xml_attr(metadata_main, 'titleSort'),
+                        'edition_title': helpers.get_xml_attr(metadata_main, 'editionTitle'),
                         'media_index': helpers.get_xml_attr(metadata_main, 'index'),
                         'parent_media_index': helpers.get_xml_attr(metadata_main, 'parentIndex'),
                         'studio': helpers.get_xml_attr(metadata_main, 'studio'),
@@ -1259,6 +1267,7 @@ class PmsConnect(object):
                         'grandparent_title': helpers.get_xml_attr(metadata_main, 'grandparentTitle'),
                         'original_title': helpers.get_xml_attr(metadata_main, 'originalTitle'),
                         'sort_title': helpers.get_xml_attr(metadata_main, 'titleSort'),
+                        'edition_title': helpers.get_xml_attr(metadata_main, 'editionTitle'),
                         'media_index': helpers.get_xml_attr(metadata_main, 'index'),
                         'parent_media_index': helpers.get_xml_attr(metadata_main, 'parentIndex'),
                         'studio': helpers.get_xml_attr(metadata_main, 'studio'),
@@ -1314,6 +1323,7 @@ class PmsConnect(object):
                         'grandparent_title': helpers.get_xml_attr(metadata_main, 'grandparentTitle'),
                         'original_title': helpers.get_xml_attr(metadata_main, 'originalTitle'),
                         'sort_title': helpers.get_xml_attr(metadata_main, 'titleSort'),
+                        'edition_title': helpers.get_xml_attr(metadata_main, 'editionTitle'),
                         'media_index': helpers.get_xml_attr(metadata_main, 'index'),
                         'parent_media_index': helpers.get_xml_attr(metadata_main, 'parentIndex'),
                         'studio': helpers.get_xml_attr(metadata_main, 'studio'),
@@ -1391,6 +1401,7 @@ class PmsConnect(object):
                         'grandparent_title': helpers.get_xml_attr(metadata_main, 'grandparentTitle'),
                         'original_title': helpers.get_xml_attr(metadata_main, 'originalTitle'),
                         'sort_title': helpers.get_xml_attr(metadata_main, 'titleSort'),
+                        'edition_title': helpers.get_xml_attr(metadata_main, 'editionTitle'),
                         'media_index': helpers.get_xml_attr(metadata_main, 'index'),
                         'parent_media_index': helpers.get_xml_attr(metadata_main, 'parentIndex'),
                         'studio': helpers.get_xml_attr(metadata_main, 'studio'),
diff --git a/plexpy/webserve.py b/plexpy/webserve.py
index e21b3139..3355d53e 100644
--- a/plexpy/webserve.py
+++ b/plexpy/webserve.py
@@ -5310,6 +5310,7 @@ class WebInterface(object):
                         "Jeremy Podeswa"
                      ],
                      "duration": "2998290",
+                     "edition_title": "",
                      "full_title": "Game of Thrones - The Red Woman",
                      "genres": [
                         "Action/Adventure",

From 15afbe300131d38cb86751c16a29ecdb22bb51b5 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 27 Sep 2022 23:28:48 +0000
Subject: [PATCH 178/743] Add edition_title notification parameter

---
 plexpy/common.py               | 3 ++-
 plexpy/notification_handler.py | 3 ++-
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/plexpy/common.py b/plexpy/common.py
index b89ef48a..039931f4 100644
--- a/plexpy/common.py
+++ b/plexpy/common.py
@@ -489,8 +489,9 @@ NOTIFICATION_PARAMETERS = [
         'category': 'Source Metadata Details',
         'parameters': [
              {'name': 'Media Type', 'type': 'str', 'value': 'media_type', 'description': 'The type of media.', 'example': 'movie, show, season, episode, artist, album, track, clip'},
-             {'name': 'Title', 'type': 'str', 'value': 'title', 'description': 'The full title of the item.'},
              {'name': 'Library Name', 'type': 'str', 'value': 'library_name', 'description': 'The library name of the item.'},
+             {'name': 'Title', 'type': 'str', 'value': 'title', 'description': 'The full title of the item.'},
+             {'name': 'Edition Title', 'type': 'str', 'value': 'edition_title', 'description': 'The edition title of the movie.'},
              {'name': 'Show Name', 'type': 'str', 'value': 'show_name', 'description': 'The title of the TV show.'},
              {'name': 'Season Name', 'type': 'str', 'value': 'season_name', 'description': 'The title of the TV season.'},
              {'name': 'Episode Name', 'type': 'str', 'value': 'episode_name', 'description': 'The title of the TV episode.'},
diff --git a/plexpy/notification_handler.py b/plexpy/notification_handler.py
index 1fc6ff83..ad774fa6 100644
--- a/plexpy/notification_handler.py
+++ b/plexpy/notification_handler.py
@@ -1066,8 +1066,9 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
         'machine_id': notify_params['machine_id'],
         # Source metadata parameters
         'media_type': notify_params['media_type'],
-        'title': notify_params['full_title'],
         'library_name': notify_params['library_name'],
+        'title': notify_params['full_title'],
+        'edition_title': notify_params['edition_title'],
         'show_name': show_name,
         'season_name': season_name,
         'episode_name': episode_name,

From 0f872ab440c186a376d663c2e3394dd70c966f79 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 27 Sep 2022 23:41:27 +0000
Subject: [PATCH 179/743] Fix broken link on library stats cards

---
 plexpy/datafactory.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/plexpy/datafactory.py b/plexpy/datafactory.py
index 09b26a45..7027ae81 100644
--- a/plexpy/datafactory.py
+++ b/plexpy/datafactory.py
@@ -1044,7 +1044,7 @@ class DataFactory(object):
                     'sh.id, shm.title, shm.grandparent_title, shm.full_title, shm.year, ' \
                     'shm.media_index, shm.parent_media_index, ' \
                     'sh.rating_key, shm.grandparent_rating_key, shm.thumb, shm.grandparent_thumb, ' \
-                    'sh.user, sh.user_id, sh.player, sh.section_id, ' \
+                    'sh.user, sh.user_id, sh.player, ' \
                     'shm.art, sh.media_type, shm.content_rating, shm.labels, shm.live, shm.guid, ' \
                     'MAX(sh.started) AS last_watch ' \
                     'FROM library_sections AS ls ' \

From 5faeafedd53b4a9f83485d341fa9aed028e199ab Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 1 Oct 2022 19:24:57 +0000
Subject: [PATCH 180/743] Fix API 400 response code

---
 plexpy/api2.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/plexpy/api2.py b/plexpy/api2.py
index add091b1..4d9efbdc 100644
--- a/plexpy/api2.py
+++ b/plexpy/api2.py
@@ -824,7 +824,7 @@ General optional parameters:
 
         if self._api_result_type == 'success' and not self._api_response_code:
             self._api_response_code = 200
-        elif self._api_result_type == 'error' and not self._api_response_code:
+        elif self._api_result_type == 'error' and self._api_response_code != 500:
             self._api_response_code = 400
 
         if not self._api_response_code:

From a9949a07da6d8dc09d8914e06290a22a847a9146 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 10 Oct 2022 18:05:14 +0000
Subject: [PATCH 181/743] Update filterer

* Clear condition operator if type changes
---
 data/interfaces/default/js/filterer.jquery.js | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/data/interfaces/default/js/filterer.jquery.js b/data/interfaces/default/js/filterer.jquery.js
index 16458f13..c17646fe 100644
--- a/data/interfaces/default/js/filterer.jquery.js
+++ b/data/interfaces/default/js/filterer.jquery.js
@@ -1,10 +1,10 @@
 !function(e){function t(r){if(n[r])return n[r].exports;var o=n[r]={exports:{},id:r,loaded:!1};return e[r].call(o.exports,o,o.exports,t),o.loaded=!0,o.exports}var n={};return t.m=e,t.c=n,t.p="/filterer/",t(0)}(function(e){for(var t in e)if(Object.prototype.hasOwnProperty.call(e,t))switch(typeof e[t]){case"function":break;case"object":e[t]=function(t){var n=t.slice(1),r=e[t[0]];return function(e,t,o){r.apply(this,[e,t,o].concat(n))}}(e[t]);break;default:e[t]=e[e[t]]}return e}([function(e,t,n){n(188),e.exports=n(94)},function(e,t,n){"use strict";function r(e,t,n,r,i,a,s,u){if(o(t),!e){var l;if(void 0===t)l=new Error("Minified exception occurred; use the non-minified dev environment for the full error message and additional helpful warnings.");else{var c=[n,r,i,a,s,u],p=0;l=new Error(t.replace(/%s/g,function(){return c[p++]})),l.name="Invariant Violation"}throw l.framesToPop=1,l}}var o=function(e){};e.exports=r},function(e,t,n){"use strict";var r=n(8),o=r;e.exports=o},function(e,t){"use strict";function n(e){for(var t=arguments.length-1,n="Minified React error #"+e+"; visit http://facebook.github.io/react/docs/error-decoder.html?invariant="+e,r=0;r<t;r++)n+="&args[]="+encodeURIComponent(arguments[r+1]);n+=" for the full message or use the non-minified dev environment for full errors and additional helpful warnings.";var o=new Error(n);throw o.name="Invariant Violation",o.framesToPop=1,o}e.exports=n},function(e,t){"use strict";function n(e){if(null===e||void 0===e)throw new TypeError("Object.assign cannot be called with null or undefined");return Object(e)}function r(){try{if(!Object.assign)return!1;var e=new String("abc");if(e[5]="de","5"===Object.getOwnPropertyNames(e)[0])return!1;for(var t={},n=0;n<10;n++)t["_"+String.fromCharCode(n)]=n;var r=Object.getOwnPropertyNames(t).map(function(e){return t[e]});if("0123456789"!==r.join(""))return!1;var o={};return"abcdefghijklmnopqrst".split("").forEach(function(e){o[e]=e}),"abcdefghijklmnopqrst"===Object.keys(Object.assign({},o)).join("")}catch(e){return!1}}var o=Object.getOwnPropertySymbols,i=Object.prototype.hasOwnProperty,a=Object.prototype.propertyIsEnumerable;e.exports=r()?Object.assign:function(e,t){for(var r,s,u=n(e),l=1;l<arguments.length;l++){r=Object(arguments[l]);for(var c in r)i.call(r,c)&&(u[c]=r[c]);if(o){s=o(r);for(var p=0;p<s.length;p++)a.call(r,s[p])&&(u[s[p]]=r[s[p]])}}return u}},function(e,t,n){"use strict";e.exports=n(20)},function(e,t,n){"use strict";function r(e,t){return 1===e.nodeType&&e.getAttribute(h)===String(t)||8===e.nodeType&&e.nodeValue===" react-text: "+t+" "||8===e.nodeType&&e.nodeValue===" react-empty: "+t+" "}function o(e){for(var t;t=e._renderedComponent;)e=t;return e}function i(e,t){var n=o(e);n._hostNode=t,t[v]=n}function a(e){var t=e._hostNode;t&&(delete t[v],e._hostNode=null)}function s(e,t){if(!(e._flags&m.hasCachedChildNodes)){var n=e._renderedChildren,a=t.firstChild;e:for(var s in n)if(n.hasOwnProperty(s)){var u=n[s],l=o(u)._domID;if(0!==l){for(;null!==a;a=a.nextSibling)if(r(a,l)){i(u,a);continue e}p("32",l)}}e._flags|=m.hasCachedChildNodes}}function u(e){if(e[v])return e[v];for(var t=[];!e[v];){if(t.push(e),!e.parentNode)return null;e=e.parentNode}for(var n,r;e&&(r=e[v]);e=t.pop())n=r,t.length&&s(r,e);return n}function l(e){var t=u(e);return null!=t&&t._hostNode===e?t:null}function c(e){if(void 0===e._hostNode?p("33"):void 0,e._hostNode)return e._hostNode;for(var t=[];!e._hostNode;)t.push(e),e._hostParent?void 0:p("34"),e=e._hostParent;for(;t.length;e=t.pop())s(e,e._hostNode);return e._hostNode}var p=n(3),f=n(18),d=n(67),h=(n(1),f.ID_ATTRIBUTE_NAME),m=d,v="__reactInternalInstance$"+Math.random().toString(36).slice(2),g={getClosestInstanceFromNode:u,getInstanceFromNode:l,getNodeFromInstance:c,precacheChildNodes:s,precacheNode:i,uncacheNode:a};e.exports=g},function(e,t){"use strict";var n=!("undefined"==typeof window||!window.document||!window.document.createElement),r={canUseDOM:n,canUseWorkers:"undefined"!=typeof Worker,canUseEventListeners:n&&!(!window.addEventListener&&!window.attachEvent),canUseViewport:n&&!!window.screen,isInWorker:!n};e.exports=r},function(e,t){"use strict";function n(e){return function(){return e}}var r=function(){};r.thatReturns=n,r.thatReturnsFalse=n(!1),r.thatReturnsTrue=n(!0),r.thatReturnsNull=n(null),r.thatReturnsThis=function(){return this},r.thatReturnsArgument=function(e){return e},e.exports=r},function(e,t,n){"use strict";var r=null;e.exports={debugTool:r}},function(e,t,n){"use strict";function r(){P.ReactReconcileTransaction&&_?void 0:c("123")}function o(){this.reinitializeTransaction(),this.dirtyComponentsLength=null,this.callbackQueue=f.getPooled(),this.reconcileTransaction=P.ReactReconcileTransaction.getPooled(!0)}function i(e,t,n,o,i,a){return r(),_.batchedUpdates(e,t,n,o,i,a)}function a(e,t){return e._mountOrder-t._mountOrder}function s(e){var t=e.dirtyComponentsLength;t!==g.length?c("124",t,g.length):void 0,g.sort(a),y++;for(var n=0;n<t;n++){var r=g[n],o=r._pendingCallbacks;r._pendingCallbacks=null;var i;if(h.logTopLevelRenders){var s=r;r._currentElement.type.isReactTopLevelWrapper&&(s=r._renderedComponent),i="React update: "+s.getName(),console.time(i)}if(m.performUpdateIfNecessary(r,e.reconcileTransaction,y),i&&console.timeEnd(i),o)for(var u=0;u<o.length;u++)e.callbackQueue.enqueue(o[u],r.getPublicInstance())}}function u(e){return r(),_.isBatchingUpdates?(g.push(e),void(null==e._updateBatchNumber&&(e._updateBatchNumber=y+1))):void _.batchedUpdates(u,e)}function l(e,t){_.isBatchingUpdates?void 0:c("125"),b.enqueue(e,t),C=!0}var c=n(3),p=n(4),f=n(65),d=n(14),h=n(70),m=n(19),v=n(31),g=(n(1),[]),y=0,b=f.getPooled(),C=!1,_=null,w={initialize:function(){this.dirtyComponentsLength=g.length},close:function(){this.dirtyComponentsLength!==g.length?(g.splice(0,this.dirtyComponentsLength),x()):g.length=0}},E={initialize:function(){this.callbackQueue.reset()},close:function(){this.callbackQueue.notifyAll()}},T=[w,E];p(o.prototype,v,{getTransactionWrappers:function(){return T},destructor:function(){this.dirtyComponentsLength=null,f.release(this.callbackQueue),this.callbackQueue=null,P.ReactReconcileTransaction.release(this.reconcileTransaction),this.reconcileTransaction=null},perform:function(e,t,n){return v.perform.call(this,this.reconcileTransaction.perform,this.reconcileTransaction,e,t,n)}}),d.addPoolingTo(o);var x=function(){for(;g.length||C;){if(g.length){var e=o.getPooled();e.perform(s,null,e),o.release(e)}if(C){C=!1;var t=b;b=f.getPooled(),t.notifyAll(),f.release(t)}}},O={injectReconcileTransaction:function(e){e?void 0:c("126"),P.ReactReconcileTransaction=e},injectBatchingStrategy:function(e){e?void 0:c("127"),"function"!=typeof e.batchedUpdates?c("128"):void 0,"boolean"!=typeof e.isBatchingUpdates?c("129"):void 0,_=e}},P={ReactReconcileTransaction:null,batchedUpdates:i,enqueueUpdate:u,flushBatchedUpdates:x,injection:O,asap:l};e.exports=P},function(e,t,n){"use strict";function r(e,t,n,r){this.dispatchConfig=e,this._targetInst=t,this.nativeEvent=n;var o=this.constructor.Interface;for(var i in o)if(o.hasOwnProperty(i)){var s=o[i];s?this[i]=s(n):"target"===i?this.target=r:this[i]=n[i]}var u=null!=n.defaultPrevented?n.defaultPrevented:n.returnValue===!1;return u?this.isDefaultPrevented=a.thatReturnsTrue:this.isDefaultPrevented=a.thatReturnsFalse,this.isPropagationStopped=a.thatReturnsFalse,this}var o=n(4),i=n(14),a=n(8),s=(n(2),"function"==typeof Proxy,["dispatchConfig","_targetInst","nativeEvent","isDefaultPrevented","isPropagationStopped","_dispatchListeners","_dispatchInstances"]),u={type:null,target:null,currentTarget:a.thatReturnsNull,eventPhase:null,bubbles:null,cancelable:null,timeStamp:function(e){return e.timeStamp||Date.now()},defaultPrevented:null,isTrusted:null};o(r.prototype,{preventDefault:function(){this.defaultPrevented=!0;var e=this.nativeEvent;e&&(e.preventDefault?e.preventDefault():"unknown"!=typeof e.returnValue&&(e.returnValue=!1),this.isDefaultPrevented=a.thatReturnsTrue)},stopPropagation:function(){var e=this.nativeEvent;e&&(e.stopPropagation?e.stopPropagation():"unknown"!=typeof e.cancelBubble&&(e.cancelBubble=!0),this.isPropagationStopped=a.thatReturnsTrue)},persist:function(){this.isPersistent=a.thatReturnsTrue},isPersistent:a.thatReturnsFalse,destructor:function(){var e=this.constructor.Interface;for(var t in e)this[t]=null;for(var n=0;n<s.length;n++)this[s[n]]=null}}),r.Interface=u,r.augmentClass=function(e,t){var n=this,r=function(){};r.prototype=n.prototype;var a=new r;o(a,e.prototype),e.prototype=a,e.prototype.constructor=e,e.Interface=o({},n.Interface,t),e.augmentClass=n.augmentClass,i.addPoolingTo(e,i.fourArgumentPooler)},i.addPoolingTo(r,i.fourArgumentPooler),e.exports=r},function(e,t){"use strict";var n={current:null};e.exports=n},function(e,t,n){"use strict";e.exports=n(138)},[228,3],[227,189,190,192,193,191],function(e,t,n){(function(){function t(e,t){var n,r=function(o){return e.length>1?function(){var i=o?o.concat():[];return n=t?n||this:this,i.push.apply(i,arguments)<e.length&&arguments.length?r.call(n,i):e.apply(n,i)}:e};return r()}function r(e,t){var n={}.hasOwnProperty;for(var r in t)n.call(t,r)&&(e[r]=t[r]);return e}var o,i,a,s,u,l,c,p,f,d,h,m,v,g,y,b,C,_,w,E,T,x,O,P,k,S,N=[].slice,M={}.toString;o=n(118),i=o.all,a=o.any,s=o.concatMap,u=o.each,l=o.filter,c=o.find,p=o.isType,f=o.keys,d=o.map,h=o.Obj,m=o.objToPairs,v=o.partition,g=o.reverse,y=o.sortBy,b=t(function(e,t,n){return Math.max(t,Math.min(n,e))}),C=t(function(e,t,n){var r;return r=e.substr(n).indexOf(t),r===-1?[]:[n+r].concat(C(e,t,n+r+t.length))}),_=t(function(e,t){var n,r,o;return n=t[0],r=N.call(t,1),0===r.length?null!=(o=e[n])?o:null:"undefined"==typeof e[n]?null:_(e[n],r)}),w=function(e){var t;return t=function(e){return e.length}(f(h.filter(function(e){return!!e})(e))),0===t},E=t(function(e,t){return M.call(e).slice(8,-1)===M.call(t).slice(8,-1)&&(a(function(t){return p(t,e)})(["Boolean","Number","String","undefined"])?e===t:"Array"===M.call(e).slice(8,-1)?e.length===t.length&&i(function(n){return E(e[n],t[n])})(function(){var t,n,r=[];for(t=0,n=e.length;t<n;++t)r.push(t);return r}()):f(e).length===f(t).length&&i(function(n){return E(e[n],t[n])})(f(e)))}),T=t(function(e,t){var n,r,o,i,a,s;return 0===t.length?[[0,e.length]]:(n=C(e,t,0),r=n[0],o=n[n.length-1],0===n.length?[]:(i=o+t.length,a=d(function(e){return[e,e+t.length,!0]})(n),s=d(function(e){return[a[e][1],a[e+1][0],!1]})(function(){var e,t,n=[];for(e=0,t=a.length-1;e<t;++e)n.push(e);return n}()),(0===r?[]:[[0,r,!1]]).concat(y(function(e){return e[0]})(a.concat(s)),i===e.length?[]:[[i,e.length,!1]])))}),x=t(function(e,t,n,r){var o;return o=_(e,t),P(e,t,o?r(o,n):n)}),O=t(function(e,t){var n,o;return n=M.call(t).slice(8,-1),a(function(e){return e===n},["Boolean","Number","String","Function"])?t:null===e||"Undefined"===M.call(e).slice(8,-1)?t:(o=h.keys(t),0===o.length?e:(u(function(n){return e[n]=O(h.keys(e[n]).length>0?r({},e[n]):e[n],t[n])})(o),e))}),P=t(function(e,t,n){var r,o,i;return r=t[0],o=N.call(t,1),o.length>0?(e[r]=null!=(i=e[r])?i:{},P(e[r],o,n)):(e[r]=n,e)}),k=function(e){return d(function(t){return d(function(e){return e[t]})(e)})(f(e[0]))},S=t(function(e,n,r){var o;return(o=t(function(e,t,n,r,i){return s(function(i){var a,s;return a=i[0],s=i[1],n<r?o(e,t.concat(a),n+1,r,s):e(t.concat(a),s)})(m(i))}))(e,[],0,n,r)}),e.exports={clamp:b,findAll:C,get:_,isEmptyObject:w,isEqualToObject:E,mappend:x,partitionString:T,rextend:O,set:P,transpose:k,unwrap:S}}).call(this)},function(e,t,n){"use strict";function r(e){if(v){var t=e.node,n=e.children;if(n.length)for(var r=0;r<n.length;r++)g(t,n[r],null);else null!=e.html?p(t,e.html):null!=e.text&&d(t,e.text)}}function o(e,t){e.parentNode.replaceChild(t.node,e),r(t)}function i(e,t){v?e.children.push(t):e.node.appendChild(t.node)}function a(e,t){v?e.html=t:p(e.node,t)}function s(e,t){v?e.text=t:d(e.node,t)}function u(){return this.node.nodeName}function l(e){return{node:e,children:[],html:null,text:null,toString:u}}var c=n(38),p=n(33),f=n(46),d=n(82),h=1,m=11,v="undefined"!=typeof document&&"number"==typeof document.documentMode||"undefined"!=typeof navigator&&"string"==typeof navigator.userAgent&&/\bEdge\/\d/.test(navigator.userAgent),g=f(function(e,t,n){t.node.nodeType===m||t.node.nodeType===h&&"object"===t.node.nodeName.toLowerCase()&&(null==t.node.namespaceURI||t.node.namespaceURI===c.html)?(r(t),e.insertBefore(t.node,n)):(e.insertBefore(t.node,n),r(t))});l.insertTreeBefore=g,l.replaceChildWithTree=o,l.queueChild=i,l.queueHTML=a,l.queueText=s,e.exports=l},function(e,t,n){"use strict";function r(e,t){return(e&t)===t}var o=n(3),i=(n(1),{MUST_USE_PROPERTY:1,HAS_BOOLEAN_VALUE:4,HAS_NUMERIC_VALUE:8,HAS_POSITIVE_NUMERIC_VALUE:24,HAS_OVERLOADED_BOOLEAN_VALUE:32,injectDOMPropertyConfig:function(e){var t=i,n=e.Properties||{},a=e.DOMAttributeNamespaces||{},u=e.DOMAttributeNames||{},l=e.DOMPropertyNames||{},c=e.DOMMutationMethods||{};e.isCustomAttribute&&s._isCustomAttributeFunctions.push(e.isCustomAttribute);for(var p in n){s.properties.hasOwnProperty(p)?o("48",p):void 0;var f=p.toLowerCase(),d=n[p],h={attributeName:f,attributeNamespace:null,propertyName:p,mutationMethod:null,mustUseProperty:r(d,t.MUST_USE_PROPERTY),hasBooleanValue:r(d,t.HAS_BOOLEAN_VALUE),hasNumericValue:r(d,t.HAS_NUMERIC_VALUE),hasPositiveNumericValue:r(d,t.HAS_POSITIVE_NUMERIC_VALUE),hasOverloadedBooleanValue:r(d,t.HAS_OVERLOADED_BOOLEAN_VALUE)};if(h.hasBooleanValue+h.hasNumericValue+h.hasOverloadedBooleanValue<=1?void 0:o("50",p),u.hasOwnProperty(p)){var m=u[p];h.attributeName=m}a.hasOwnProperty(p)&&(h.attributeNamespace=a[p]),l.hasOwnProperty(p)&&(h.propertyName=l[p]),c.hasOwnProperty(p)&&(h.mutationMethod=c[p]),s.properties[p]=h}}}),a=":A-Z_a-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD",s={ID_ATTRIBUTE_NAME:"data-reactid",ROOT_ATTRIBUTE_NAME:"data-reactroot",ATTRIBUTE_NAME_START_CHAR:a,ATTRIBUTE_NAME_CHAR:a+"\\-.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040",properties:{},getPossibleStandardName:null,_isCustomAttributeFunctions:[],isCustomAttribute:function(e){for(var t=0;t<s._isCustomAttributeFunctions.length;t++){var n=s._isCustomAttributeFunctions[t];if(n(e))return!0}return!1},injection:i};e.exports=s},function(e,t,n){"use strict";function r(){o.attachRefs(this,this._currentElement)}var o=n(161),i=(n(9),n(2),{mountComponent:function(e,t,n,o,i,a){var s=e.mountComponent(t,n,o,i,a);return e._currentElement&&null!=e._currentElement.ref&&t.getReactMountReady().enqueue(r,e),s},getHostNode:function(e){return e.getHostNode()},unmountComponent:function(e,t){o.detachRefs(e,e._currentElement),e.unmountComponent(t)},receiveComponent:function(e,t,n,i){var a=e._currentElement;if(t!==a||i!==e._context){var s=o.shouldUpdateRefs(a,t);s&&o.detachRefs(e,a),e.receiveComponent(t,n,i),s&&e._currentElement&&null!=e._currentElement.ref&&n.getReactMountReady().enqueue(r,e)}},performUpdateIfNecessary:function(e,t,n){e._updateBatchNumber===n&&e.performUpdateIfNecessary(t)}});e.exports=i},function(e,t,n){"use strict";var r=n(4),o=n(213),i=n(54),a=n(218),s=n(214),u=n(215),l=n(21),c=n(217),p=n(219),f=n(222),d=(n(2),l.createElement),h=l.createFactory,m=l.cloneElement,v=r,g={Children:{map:o.map,forEach:o.forEach,count:o.count,toArray:o.toArray,only:f},Component:i,PureComponent:a,createElement:d,cloneElement:m,isValidElement:l.isValidElement,PropTypes:c,createClass:s.createClass,createFactory:h,createMixin:function(e){return e},DOM:u,version:p,__spread:v};e.exports=g},function(e,t,n){"use strict";function r(e){return void 0!==e.ref}function o(e){return void 0!==e.key}var i=n(4),a=n(12),s=(n(2),n(89),Object.prototype.hasOwnProperty),u=n(88),l={key:!0,ref:!0,__self:!0,__source:!0},c=function(e,t,n,r,o,i,a){var s={$$typeof:u,type:e,key:t,ref:n,props:a,_owner:i};return s};c.createElement=function(e,t,n){var i,u={},p=null,f=null,d=null,h=null;if(null!=t){r(t)&&(f=t.ref),o(t)&&(p=""+t.key),d=void 0===t.__self?null:t.__self,h=void 0===t.__source?null:t.__source;for(i in t)s.call(t,i)&&!l.hasOwnProperty(i)&&(u[i]=t[i])}var m=arguments.length-2;if(1===m)u.children=n;else if(m>1){for(var v=Array(m),g=0;g<m;g++)v[g]=arguments[g+2];u.children=v}if(e&&e.defaultProps){var y=e.defaultProps;for(i in y)void 0===u[i]&&(u[i]=y[i])}return c(e,p,f,d,h,a.current,u)},c.createFactory=function(e){var t=c.createElement.bind(null,e);return t.type=e,t},c.cloneAndReplaceKey=function(e,t){var n=c(e.type,t,e.ref,e._self,e._source,e._owner,e.props);return n},c.cloneElement=function(e,t,n){var u,p=i({},e.props),f=e.key,d=e.ref,h=e._self,m=e._source,v=e._owner;if(null!=t){r(t)&&(d=t.ref,v=a.current),o(t)&&(f=""+t.key);var g;e.type&&e.type.defaultProps&&(g=e.type.defaultProps);for(u in t)s.call(t,u)&&!l.hasOwnProperty(u)&&(void 0===t[u]&&void 0!==g?p[u]=g[u]:p[u]=t[u])}var y=arguments.length-2;if(1===y)p.children=n;else if(y>1){for(var b=Array(y),C=0;C<y;C++)b[C]=arguments[C+2];p.children=b}return c(e.type,f,d,h,m,v,p)},c.isValidElement=function(e){return"object"==typeof e&&null!==e&&e.$$typeof===u},e.exports=c},3,function(e,t,n){"use strict";var r={};e.exports=r},function(e,t,n){"use strict";function r(e){return"button"===e||"input"===e||"select"===e||"textarea"===e}function o(e,t,n){switch(e){case"onClick":case"onClickCapture":case"onDoubleClick":case"onDoubleClickCapture":case"onMouseDown":case"onMouseDownCapture":case"onMouseMove":case"onMouseMoveCapture":case"onMouseUp":case"onMouseUpCapture":return!(!n.disabled||!r(t));default:return!1}}var i=n(3),a=n(39),s=n(40),u=n(44),l=n(76),c=n(77),p=(n(1),{}),f=null,d=function(e,t){e&&(s.executeDispatchesInOrder(e,t),e.isPersistent()||e.constructor.release(e))},h=function(e){return d(e,!0)},m=function(e){return d(e,!1)},v=function(e){return"."+e._rootNodeID},g={injection:{injectEventPluginOrder:a.injectEventPluginOrder,injectEventPluginsByName:a.injectEventPluginsByName},putListener:function(e,t,n){"function"!=typeof n?i("94",t,typeof n):void 0;var r=v(e),o=p[t]||(p[t]={});o[r]=n;var s=a.registrationNameModules[t];s&&s.didPutListener&&s.didPutListener(e,t,n)},getListener:function(e,t){var n=p[t];if(o(t,e._currentElement.type,e._currentElement.props))return null;var r=v(e);return n&&n[r]},deleteListener:function(e,t){var n=a.registrationNameModules[t];n&&n.willDeleteListener&&n.willDeleteListener(e,t);var r=p[t];if(r){var o=v(e);delete r[o]}},deleteAllListeners:function(e){var t=v(e);for(var n in p)if(p.hasOwnProperty(n)&&p[n][t]){var r=a.registrationNameModules[n];r&&r.willDeleteListener&&r.willDeleteListener(e,n),delete p[n][t]}},extractEvents:function(e,t,n,r){for(var o,i=a.plugins,s=0;s<i.length;s++){var u=i[s];if(u){var c=u.extractEvents(e,t,n,r);c&&(o=l(o,c))}}return o},enqueueEvents:function(e){e&&(f=l(f,e))},processEventQueue:function(e){var t=f;f=null,e?c(t,h):c(t,m),f?i("95"):void 0,u.rethrowCaughtError()},__purge:function(){p={}},__getListenerBank:function(){return p}};e.exports=g},function(e,t,n){"use strict";function r(e,t,n){var r=t.dispatchConfig.phasedRegistrationNames[n];return g(e,r)}function o(e,t,n){var o=r(e,n,t);o&&(n._dispatchListeners=m(n._dispatchListeners,o),n._dispatchInstances=m(n._dispatchInstances,e))}function i(e){e&&e.dispatchConfig.phasedRegistrationNames&&h.traverseTwoPhase(e._targetInst,o,e)}function a(e){if(e&&e.dispatchConfig.phasedRegistrationNames){var t=e._targetInst,n=t?h.getParentInstance(t):null;h.traverseTwoPhase(n,o,e)}}function s(e,t,n){if(n&&n.dispatchConfig.registrationName){var r=n.dispatchConfig.registrationName,o=g(e,r);o&&(n._dispatchListeners=m(n._dispatchListeners,o),n._dispatchInstances=m(n._dispatchInstances,e))}}function u(e){e&&e.dispatchConfig.registrationName&&s(e._targetInst,null,e)}function l(e){v(e,i)}function c(e){v(e,a)}function p(e,t,n,r){h.traverseEnterLeave(n,r,s,e,t)}function f(e){v(e,u)}var d=n(24),h=n(40),m=n(76),v=n(77),g=(n(2),d.getListener),y={accumulateTwoPhaseDispatches:l,accumulateTwoPhaseDispatchesSkipTarget:c,accumulateDirectDispatches:f,accumulateEnterLeaveDispatches:p};e.exports=y},function(e,t){"use strict";var n={remove:function(e){e._reactInternalInstance=void 0},get:function(e){return e._reactInternalInstance},has:function(e){return void 0!==e._reactInternalInstance},set:function(e,t){e._reactInternalInstance=t}};e.exports=n},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(11),i=n(49),a={view:function(e){if(e.view)return e.view;var t=i(e);if(t.window===t)return t;var n=t.ownerDocument;return n?n.defaultView||n.parentWindow:window},detail:function(e){return e.detail||0}};o.augmentClass(r,a),e.exports=r},function(e,t,n){(function(){var e,r,o,i,a,s,u,l="undefined"!=typeof t&&t||this;e=n(15),r=e.filter,o=e.map,i=e.objToPairs,a=e.Str,l.cancelEvent=s=function(e){e.preventDefault(),e.stopPropagation()},l.classNameFromObject=u=function(e){return a.join(" ")(o(function(e){return e[0]})(r(function(e){return!!e[1]})(i(e))))}}).call(this)},function(e,t,n){"use strict";function r(e){return Object.prototype.hasOwnProperty.call(e,m)||(e[m]=d++,p[e[m]]={}),p[e[m]]}var o,i=n(4),a=n(39),s=n(153),u=n(75),l=n(185),c=n(50),p={},f=!1,d=0,h={topAbort:"abort",topAnimationEnd:l("animationend")||"animationend",topAnimationIteration:l("animationiteration")||"animationiteration",topAnimationStart:l("animationstart")||"animationstart",topBlur:"blur",topCanPlay:"canplay",topCanPlayThrough:"canplaythrough",topChange:"change",topClick:"click",topCompositionEnd:"compositionend",topCompositionStart:"compositionstart",topCompositionUpdate:"compositionupdate",topContextMenu:"contextmenu",topCopy:"copy",topCut:"cut",topDoubleClick:"dblclick",topDrag:"drag",topDragEnd:"dragend",topDragEnter:"dragenter",topDragExit:"dragexit",topDragLeave:"dragleave",topDragOver:"dragover",topDragStart:"dragstart",topDrop:"drop",topDurationChange:"durationchange",topEmptied:"emptied",topEncrypted:"encrypted",topEnded:"ended",topError:"error",topFocus:"focus",topInput:"input",topKeyDown:"keydown",topKeyPress:"keypress",topKeyUp:"keyup",topLoadedData:"loadeddata",topLoadedMetadata:"loadedmetadata",topLoadStart:"loadstart",topMouseDown:"mousedown",topMouseMove:"mousemove",topMouseOut:"mouseout",topMouseOver:"mouseover",topMouseUp:"mouseup",topPaste:"paste",topPause:"pause",topPlay:"play",topPlaying:"playing",topProgress:"progress",topRateChange:"ratechange",topScroll:"scroll",topSeeked:"seeked",topSeeking:"seeking",topSelectionChange:"selectionchange",topStalled:"stalled",topSuspend:"suspend",topTextInput:"textInput",topTimeUpdate:"timeupdate",topTouchCancel:"touchcancel",topTouchEnd:"touchend",topTouchMove:"touchmove",topTouchStart:"touchstart",topTransitionEnd:l("transitionend")||"transitionend",topVolumeChange:"volumechange",topWaiting:"waiting",topWheel:"wheel"},m="_reactListenersID"+String(Math.random()).slice(2),v=i({},s,{ReactEventListener:null,injection:{injectReactEventListener:function(e){e.setHandleTopLevel(v.handleTopLevel),v.ReactEventListener=e}},setEnabled:function(e){v.ReactEventListener&&v.ReactEventListener.setEnabled(e)},isEnabled:function(){return!(!v.ReactEventListener||!v.ReactEventListener.isEnabled())},listenTo:function(e,t){for(var n=t,o=r(n),i=a.registrationNameDependencies[e],s=0;s<i.length;s++){var u=i[s];o.hasOwnProperty(u)&&o[u]||("topWheel"===u?c("wheel")?v.ReactEventListener.trapBubbledEvent("topWheel","wheel",n):c("mousewheel")?v.ReactEventListener.trapBubbledEvent("topWheel","mousewheel",n):v.ReactEventListener.trapBubbledEvent("topWheel","DOMMouseScroll",n):"topScroll"===u?c("scroll",!0)?v.ReactEventListener.trapCapturedEvent("topScroll","scroll",n):v.ReactEventListener.trapBubbledEvent("topScroll","scroll",v.ReactEventListener.WINDOW_HANDLE):"topFocus"===u||"topBlur"===u?(c("focus",!0)?(v.ReactEventListener.trapCapturedEvent("topFocus","focus",n),v.ReactEventListener.trapCapturedEvent("topBlur","blur",n)):c("focusin")&&(v.ReactEventListener.trapBubbledEvent("topFocus","focusin",n),v.ReactEventListener.trapBubbledEvent("topBlur","focusout",n)),o.topBlur=!0,o.topFocus=!0):h.hasOwnProperty(u)&&v.ReactEventListener.trapBubbledEvent(u,h[u],n),o[u]=!0)}},trapBubbledEvent:function(e,t,n){return v.ReactEventListener.trapBubbledEvent(e,t,n)},trapCapturedEvent:function(e,t,n){return v.ReactEventListener.trapCapturedEvent(e,t,n)},supportsEventPageXY:function(){if(!document.createEvent)return!1;var e=document.createEvent("MouseEvent");return null!=e&&"pageX"in e},ensureScrollValueMonitoring:function(){if(void 0===o&&(o=v.supportsEventPageXY()),!o&&!f){var e=u.refreshScrollValues;v.ReactEventListener.monitorScrollValue(e),f=!0}}});e.exports=v},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(27),i=n(75),a=n(48),s={screenX:null,screenY:null,clientX:null,clientY:null,ctrlKey:null,shiftKey:null,altKey:null,metaKey:null,getModifierState:a,button:function(e){var t=e.button;return"which"in e?t:2===t?2:4===t?1:0},buttons:null,relatedTarget:function(e){return e.relatedTarget||(e.fromElement===e.srcElement?e.toElement:e.fromElement)},pageX:function(e){return"pageX"in e?e.pageX:e.clientX+i.currentScrollLeft},pageY:function(e){return"pageY"in e?e.pageY:e.clientY+i.currentScrollTop}};o.augmentClass(r,s),e.exports=r},function(e,t,n){"use strict";var r=n(3),o=(n(1),{}),i={reinitializeTransaction:function(){this.transactionWrappers=this.getTransactionWrappers(),this.wrapperInitData?this.wrapperInitData.length=0:this.wrapperInitData=[],this._isInTransaction=!1},_isInTransaction:!1,getTransactionWrappers:null,isInTransaction:function(){return!!this._isInTransaction},perform:function(e,t,n,o,i,a,s,u){this.isInTransaction()?r("27"):void 0;var l,c;try{this._isInTransaction=!0,l=!0,this.initializeAll(0),c=e.call(t,n,o,i,a,s,u),l=!1}finally{try{if(l)try{this.closeAll(0)}catch(e){}else this.closeAll(0)}finally{this._isInTransaction=!1}}return c},initializeAll:function(e){for(var t=this.transactionWrappers,n=e;n<t.length;n++){var r=t[n];try{this.wrapperInitData[n]=o,this.wrapperInitData[n]=r.initialize?r.initialize.call(this):null}finally{if(this.wrapperInitData[n]===o)try{this.initializeAll(n+1)}catch(e){}}}},closeAll:function(e){this.isInTransaction()?void 0:r("28");for(var t=this.transactionWrappers,n=e;n<t.length;n++){var i,a=t[n],s=this.wrapperInitData[n];try{i=!0,s!==o&&a.close&&a.close.call(this,s),i=!1}finally{if(i)try{this.closeAll(n+1)}catch(e){}}}this.wrapperInitData.length=0}};e.exports=i},function(e,t){"use strict";function n(e){var t=""+e,n=o.exec(t);if(!n)return t;var r,i="",a=0,s=0;for(a=n.index;a<t.length;a++){switch(t.charCodeAt(a)){case 34:r="&quot;";break;case 38:r="&amp;";break;case 39:r="&#x27;";break;case 60:r="&lt;";break;case 62:r="&gt;";break;default:continue}s!==a&&(i+=t.substring(s,a)),s=a+1,i+=r}return s!==a?i+t.substring(s,a):i}function r(e){return"boolean"==typeof e||"number"==typeof e?""+e:n(e)}var o=/["'&<>]/;e.exports=r},function(e,t,n){"use strict";var r,o=n(7),i=n(38),a=/^[ \r\n\t\f]/,s=/<(!--|link|noscript|meta|script|style)[ \r\n\t\f\/>]/,u=n(46),l=u(function(e,t){if(e.namespaceURI!==i.svg||"innerHTML"in e)e.innerHTML=t;else{r=r||document.createElement("div"),r.innerHTML="<svg>"+t+"</svg>";for(var n=r.firstChild;n.firstChild;)e.appendChild(n.firstChild)}});if(o.canUseDOM){var c=document.createElement("div");c.innerHTML=" ",""===c.innerHTML&&(l=function(e,t){if(e.parentNode&&e.parentNode.replaceChild(e,e),a.test(t)||"<"===t[0]&&s.test(t)){e.innerHTML=String.fromCharCode(65279)+t;var n=e.firstChild;1===n.data.length?e.removeChild(n):n.deleteData(0,1)}else e.innerHTML=t}),c=null}e.exports=l},function(e,t,n){e.exports=n(208)()},function(e,t){function n(e){return e&&e.__esModule?e:{default:e}}e.exports=n,e.exports.__esModule=!0,e.exports.default=e.exports},function(e,t){"use strict";function n(e,t){return e===t?0!==e||0!==t||1/e===1/t:e!==e&&t!==t}function r(e,t){if(n(e,t))return!0;if("object"!=typeof e||null===e||"object"!=typeof t||null===t)return!1;var r=Object.keys(e),i=Object.keys(t);if(r.length!==i.length)return!1;for(var a=0;a<r.length;a++)if(!o.call(t,r[a])||!n(e[r[a]],t[r[a]]))return!1;return!0}var o=Object.prototype.hasOwnProperty;e.exports=r},function(e,t,n){"use strict";function r(e,t){return Array.isArray(t)&&(t=t[1]),t?t.nextSibling:e.firstChild}function o(e,t,n){c.insertTreeBefore(e,t,n)}function i(e,t,n){Array.isArray(t)?s(e,t[0],t[1],n):m(e,t,n)}function a(e,t){if(Array.isArray(t)){var n=t[1];t=t[0],u(e,t,n),e.removeChild(n)}e.removeChild(t)}function s(e,t,n,r){for(var o=t;;){var i=o.nextSibling;if(m(e,o,r),o===n)break;o=i}}function u(e,t,n){for(;;){var r=t.nextSibling;if(r===n)break;e.removeChild(r)}}function l(e,t,n){var r=e.parentNode,o=e.nextSibling;o===t?n&&m(r,document.createTextNode(n),o):n?(h(o,n),u(r,o,t)):u(r,e,t)}var c=n(17),p=n(130),f=(n(6),n(9),n(46)),d=n(33),h=n(82),m=f(function(e,t,n){e.insertBefore(t,n)}),v=p.dangerouslyReplaceNodeWithMarkup,g={dangerouslyReplaceNodeWithMarkup:v,replaceDelimitedText:l,processUpdates:function(e,t){for(var n=0;n<t.length;n++){var s=t[n];switch(s.type){case"INSERT_MARKUP":o(e,s.content,r(e,s.afterNode));break;case"MOVE_EXISTING":i(e,s.fromNode,r(e,s.afterNode));break;case"SET_MARKUP":d(e,s.content);break;case"TEXT_CONTENT":h(e,s.content);break;case"REMOVE_NODE":a(e,s.fromNode)}}}};e.exports=g},function(e,t){"use strict";var n={html:"http://www.w3.org/1999/xhtml",mathml:"http://www.w3.org/1998/Math/MathML",svg:"http://www.w3.org/2000/svg"};e.exports=n},function(e,t,n){"use strict";function r(){if(s)for(var e in u){var t=u[e],n=s.indexOf(e);if(n>-1?void 0:a("96",e),!l.plugins[n]){t.extractEvents?void 0:a("97",e),l.plugins[n]=t;var r=t.eventTypes;for(var i in r)o(r[i],t,i)?void 0:a("98",i,e)}}}function o(e,t,n){l.eventNameDispatchConfigs.hasOwnProperty(n)?a("99",n):void 0,l.eventNameDispatchConfigs[n]=e;var r=e.phasedRegistrationNames;if(r){for(var o in r)if(r.hasOwnProperty(o)){var s=r[o];i(s,t,n)}return!0}return!!e.registrationName&&(i(e.registrationName,t,n),!0)}function i(e,t,n){l.registrationNameModules[e]?a("100",e):void 0,l.registrationNameModules[e]=t,l.registrationNameDependencies[e]=t.eventTypes[n].dependencies}var a=n(3),s=(n(1),null),u={},l={plugins:[],eventNameDispatchConfigs:{},registrationNameModules:{},registrationNameDependencies:{},possibleRegistrationNames:null,injectEventPluginOrder:function(e){s?a("101"):void 0,s=Array.prototype.slice.call(e),r()},injectEventPluginsByName:function(e){var t=!1;for(var n in e)if(e.hasOwnProperty(n)){var o=e[n];u.hasOwnProperty(n)&&u[n]===o||(u[n]?a("102",n):void 0,u[n]=o,t=!0)}t&&r()},getPluginModuleForEvent:function(e){var t=e.dispatchConfig;if(t.registrationName)return l.registrationNameModules[t.registrationName]||null;if(void 0!==t.phasedRegistrationNames){var n=t.phasedRegistrationNames;for(var r in n)if(n.hasOwnProperty(r)){var o=l.registrationNameModules[n[r]];if(o)return o}}return null},_resetEventPlugins:function(){s=null;for(var e in u)u.hasOwnProperty(e)&&delete u[e];l.plugins.length=0;var t=l.eventNameDispatchConfigs;for(var n in t)t.hasOwnProperty(n)&&delete t[n];var r=l.registrationNameModules;for(var o in r)r.hasOwnProperty(o)&&delete r[o]}};e.exports=l},function(e,t,n){"use strict";function r(e){return"topMouseUp"===e||"topTouchEnd"===e||"topTouchCancel"===e}function o(e){return"topMouseMove"===e||"topTouchMove"===e}function i(e){return"topMouseDown"===e||"topTouchStart"===e}function a(e,t,n,r){var o=e.type||"unknown-event";e.currentTarget=g.getNodeFromInstance(r),t?m.invokeGuardedCallbackWithCatch(o,n,e):m.invokeGuardedCallback(o,n,e),e.currentTarget=null}function s(e,t){var n=e._dispatchListeners,r=e._dispatchInstances;if(Array.isArray(n))for(var o=0;o<n.length&&!e.isPropagationStopped();o++)a(e,t,n[o],r[o]);else n&&a(e,t,n,r);e._dispatchListeners=null,e._dispatchInstances=null}function u(e){var t=e._dispatchListeners,n=e._dispatchInstances;if(Array.isArray(t)){for(var r=0;r<t.length&&!e.isPropagationStopped();r++)if(t[r](e,n[r]))return n[r]}else if(t&&t(e,n))return n;return null}function l(e){var t=u(e);return e._dispatchInstances=null,e._dispatchListeners=null,
 t}function c(e){var t=e._dispatchListeners,n=e._dispatchInstances;Array.isArray(t)?h("103"):void 0,e.currentTarget=t?g.getNodeFromInstance(n):null;var r=t?t(e):null;return e.currentTarget=null,e._dispatchListeners=null,e._dispatchInstances=null,r}function p(e){return!!e._dispatchListeners}var f,d,h=n(3),m=n(44),v=(n(1),n(2),{injectComponentTree:function(e){f=e},injectTreeTraversal:function(e){d=e}}),g={isEndish:r,isMoveish:o,isStartish:i,executeDirectDispatch:c,executeDispatchesInOrder:s,executeDispatchesInOrderStopAtTrue:l,hasDispatches:p,getInstanceFromNode:function(e){return f.getInstanceFromNode(e)},getNodeFromInstance:function(e){return f.getNodeFromInstance(e)},isAncestor:function(e,t){return d.isAncestor(e,t)},getLowestCommonAncestor:function(e,t){return d.getLowestCommonAncestor(e,t)},getParentInstance:function(e){return d.getParentInstance(e)},traverseTwoPhase:function(e,t,n){return d.traverseTwoPhase(e,t,n)},traverseEnterLeave:function(e,t,n,r,o){return d.traverseEnterLeave(e,t,n,r,o)},injection:v};e.exports=g},function(e,t){"use strict";function n(e){var t=/[=:]/g,n={"=":"=0",":":"=2"},r=(""+e).replace(t,function(e){return n[e]});return"$"+r}function r(e){var t=/(=0|=2)/g,n={"=0":"=","=2":":"},r="."===e[0]&&"$"===e[1]?e.substring(2):e.substring(1);return(""+r).replace(t,function(e){return n[e]})}var o={escape:n,unescape:r};e.exports=o},function(e,t,n){"use strict";function r(e){null!=e.checkedLink&&null!=e.valueLink?s("87"):void 0}function o(e){r(e),null!=e.value||null!=e.onChange?s("88"):void 0}function i(e){r(e),null!=e.checked||null!=e.onChange?s("89"):void 0}function a(e){if(e){var t=e.getName();if(t)return" Check the render method of `"+t+"`."}return""}var s=n(3),u=n(159),l=n(62),c=n(20),p=l(c.isValidElement),f=(n(1),n(2),{button:!0,checkbox:!0,image:!0,hidden:!0,radio:!0,reset:!0,submit:!0}),d={value:function(e,t,n){return!e[t]||f[e.type]||e.onChange||e.readOnly||e.disabled?null:new Error("You provided a `value` prop to a form field without an `onChange` handler. This will render a read-only field. If the field should be mutable use `defaultValue`. Otherwise, set either `onChange` or `readOnly`.")},checked:function(e,t,n){return!e[t]||e.onChange||e.readOnly||e.disabled?null:new Error("You provided a `checked` prop to a form field without an `onChange` handler. This will render a read-only field. If the field should be mutable use `defaultChecked`. Otherwise, set either `onChange` or `readOnly`.")},onChange:p.func},h={},m={checkPropTypes:function(e,t,n){for(var r in d){if(d.hasOwnProperty(r))var o=d[r](t,r,e,"prop",null,u);if(o instanceof Error&&!(o.message in h)){h[o.message]=!0;a(n)}}},getValue:function(e){return e.valueLink?(o(e),e.valueLink.value):e.value},getChecked:function(e){return e.checkedLink?(i(e),e.checkedLink.value):e.checked},executeOnChange:function(e,t){return e.valueLink?(o(e),e.valueLink.requestChange(t.target.value)):e.checkedLink?(i(e),e.checkedLink.requestChange(t.target.checked)):e.onChange?e.onChange.call(void 0,t):void 0}};e.exports=m},function(e,t,n){"use strict";var r=n(3),o=(n(1),!1),i={replaceNodeWithMarkup:null,processChildrenUpdates:null,injection:{injectEnvironment:function(e){o?r("104"):void 0,i.replaceNodeWithMarkup=e.replaceNodeWithMarkup,i.processChildrenUpdates=e.processChildrenUpdates,o=!0}}};e.exports=i},function(e,t,n){"use strict";function r(e,t,n){try{t(n)}catch(e){null===o&&(o=e)}}var o=null,i={invokeGuardedCallback:r,invokeGuardedCallbackWithCatch:r,rethrowCaughtError:function(){if(o){var e=o;throw o=null,e}}};e.exports=i},function(e,t,n){"use strict";function r(e){u.enqueueUpdate(e)}function o(e){var t=typeof e;if("object"!==t)return t;var n=e.constructor&&e.constructor.name||t,r=Object.keys(e);return r.length>0&&r.length<20?n+" (keys: "+r.join(", ")+")":n}function i(e,t){var n=s.get(e);if(!n){return null}return n}var a=n(3),s=(n(12),n(26)),u=(n(9),n(10)),l=(n(1),n(2),{isMounted:function(e){var t=s.get(e);return!!t&&!!t._renderedComponent},enqueueCallback:function(e,t,n){l.validateCallback(t,n);var o=i(e);return o?(o._pendingCallbacks?o._pendingCallbacks.push(t):o._pendingCallbacks=[t],void r(o)):null},enqueueCallbackInternal:function(e,t){e._pendingCallbacks?e._pendingCallbacks.push(t):e._pendingCallbacks=[t],r(e)},enqueueForceUpdate:function(e){var t=i(e,"forceUpdate");t&&(t._pendingForceUpdate=!0,r(t))},enqueueReplaceState:function(e,t,n){var o=i(e,"replaceState");o&&(o._pendingStateQueue=[t],o._pendingReplaceState=!0,void 0!==n&&null!==n&&(l.validateCallback(n,"replaceState"),o._pendingCallbacks?o._pendingCallbacks.push(n):o._pendingCallbacks=[n]),r(o))},enqueueSetState:function(e,t){var n=i(e,"setState");if(n){var o=n._pendingStateQueue||(n._pendingStateQueue=[]);o.push(t),r(n)}},enqueueElementInternal:function(e,t,n){e._pendingElement=t,e._context=n,r(e)},validateCallback:function(e,t){e&&"function"!=typeof e?a("122",t,o(e)):void 0}});e.exports=l},function(e,t){"use strict";var n=function(e){return"undefined"!=typeof MSApp&&MSApp.execUnsafeLocalFunction?function(t,n,r,o){MSApp.execUnsafeLocalFunction(function(){return e(t,n,r,o)})}:e};e.exports=n},function(e,t){"use strict";function n(e){var t,n=e.keyCode;return"charCode"in e?(t=e.charCode,0===t&&13===n&&(t=13)):t=n,t>=32||13===t?t:0}e.exports=n},function(e,t){"use strict";function n(e){var t=this,n=t.nativeEvent;if(n.getModifierState)return n.getModifierState(e);var r=o[e];return!!r&&!!n[r]}function r(e){return n}var o={Alt:"altKey",Control:"ctrlKey",Meta:"metaKey",Shift:"shiftKey"};e.exports=r},function(e,t){"use strict";function n(e){var t=e.target||e.srcElement||window;return t.correspondingUseElement&&(t=t.correspondingUseElement),3===t.nodeType?t.parentNode:t}e.exports=n},function(e,t,n){"use strict";function r(e,t){if(!i.canUseDOM||t&&!("addEventListener"in document))return!1;var n="on"+e,r=n in document;if(!r){var a=document.createElement("div");a.setAttribute(n,"return;"),r="function"==typeof a[n]}return!r&&o&&"wheel"===e&&(r=document.implementation.hasFeature("Events.wheel","3.0")),r}var o,i=n(7);i.canUseDOM&&(o=document.implementation&&document.implementation.hasFeature&&document.implementation.hasFeature("","")!==!0),e.exports=r},function(e,t){"use strict";function n(e,t){var n=null===e||e===!1,r=null===t||t===!1;if(n||r)return n===r;var o=typeof e,i=typeof t;return"string"===o||"number"===o?"string"===i||"number"===i:"object"===i&&e.type===t.type&&e.key===t.key}e.exports=n},function(e,t,n){"use strict";var r=(n(4),n(8)),o=(n(2),r);e.exports=o},function(e,t,n){(function(){function t(e,t){var n={}.hasOwnProperty;for(var r in t)n.call(t,r)&&(e[r]=t[r]);return e}function r(e,t){for(var n=-1,r=t.length>>>0;++n<r;)if(e===t[n])return!0;return!1}var o,i,a,s,u,l,c,p,f,d,h,m,v,g,y,b,C,_,w,E,T,x,O,P,k,S,N,M,A,I,D,R,L,U,F,j,B;o=n(15),i=o.each,a=o.filter,s=o.find,u=o.findIndex,l=o.id,c=o.initial,p=o.last,f=o.map,d=o.objToPairs,h=o.partition,m=o.reject,v=o.reverse,g=o.Str,y=o.sortBy,b=o.sum,C=o.values,o=n(16),_=o.clamp,w=o.isEqualToObject,E=n(5),o=E.DOM,T=o.div,x=o.input,O=o.path,P=o.span,k=o.svg,S=E.createClass,N=E.createFactory,M=n(13).findDOMNode,A=N(n(63)),I=N(n(202)),D=N(n(195)),R=N(n(84)),L=N(n(203)),U=N(n(199)),F=N(n(200)),o=n(28),j=o.cancelEvent,B=o.classNameFromObject,e.exports=S({displayName:"ReactSelectize",focusLock:!1,getDefaultProps:function(){return{anchor:null,autofocus:!1,cancelKeyboardEventOnSelection:!0,delimiters:[],disabled:!1,dropdownDirection:1,firstOptionIndexToHighlight:function(e){return 0},groupId:function(e){return e.groupId},groupsAsColumns:!1,highlightedUid:void 0,inputProps:{},onAnchorChange:function(e){},onBlur:function(e){},onEnter:function(e){},onFocus:function(e){},onHighlightedUidChange:function(e,t){},onKeyboardSelectionFailed:function(e){},onOpenChange:function(e,t){},onPaste:function(e){},onScrollLockChange:function(e){},onSearchChange:function(e,t){},onValuesChange:function(e,t){},open:!1,hideResetButton:!1,renderValue:function(e){var t;return t=e.label,T({className:"simple-value"},P(null,t))},renderToggleButton:I,renderResetButton:U,scrollLock:!1,search:"",style:{},theme:"default",uid:l,values:[]}},render:function(){var e,n,r,o,i,a=this;return e=function(){var e;switch(!1){case!("undefined"==typeof this.props.anchor||null===this.props.anchor):return-1;default:return null!=(e=u(function(e){return a.isEqualToObject(e,a.props.anchor)},this.props.values))?e:this.props.values.length-1}}.call(this),n=function(e){return f(function(e){var t,n;return t=a.props.values[e],n=a.props.uid(t),L({key:a.uidToString(n),uid:n,item:t,renderItem:a.props.renderValue})})(e)},r=this.props.dropdownDirection===-1,T({className:B((o={"react-selectize":1},o[this.props.theme+""]=1,o["root-node"]=1,o[this.props.className+""]=1,o.disabled=this.props.disabled,o.open=this.props.open,o.flipped=r,o.tethered=this.props.tether,o)),style:this.props.style},this.props.name?x({type:"hidden",name:this.props.name,value:this.props.serialize(this.props.values)}):void 0,T({className:"react-selectize-control",ref:"control",onMouseDown:function(e){if(function(){return a.props.onAnchorChange(p(a.props.values),function(){return a.onOpenChange(!0,function(){return a.highlightAndFocus()})})}(),!a.props.open)return j(e)}},0===this.props.search.length&&0===this.props.values.length?T({className:"react-selectize-placeholder"},this.props.placeholder):void 0,T({className:"react-selectize-search-field-and-selected-values"},n(function(){var t,n,r=[];for(t=0,n=e;t<=n;++t)r.push(t);return r}()),F((o=t({disabled:this.props.disabled},this.props.inputProps),o.ref="search",o.type="text",o.value=this.props.search,o.onChange=function(e){var t;return t=e.currentTarget.value,a.props.onSearchChange(t,function(){return a.highlightAndScrollToSelectableOption(a.props.firstOptionIndexToHighlight(a.props.options),1)})},o.onFocus=function(e){!function(){return function(e){return a.focusLock?e(a.focusLock=!1):a.onOpenChange(!0,function(){return e(!0)})}}()(function(){return a.props.onFocus(e)})},o.onBlur=function(e){if(!a.refs.dropdownMenu||document.activeElement!==M(a.refs.dropdownMenu))return a.closeDropdown(function(){return a.props.onBlur(e)})},o.onPaste=this.props.onPaste,o.onKeyDown=function(t){return a.handleKeydown({anchorIndex:e},t)},o)),n(function(){var t,n,r=[];for(t=e+1,n=this.props.values.length;t<n;++t)r.push(t);return r}.call(this))),this.props.values.length>0&&!this.props.hideResetButton?T({className:"react-selectize-reset-button-container",onClick:function(e){return function(){return a.props.onValuesChange([],function(){return a.props.onSearchChange("",function(){return a.highlightAndFocus()})})}(),j(e)}},this.props.renderResetButton()):void 0,T({className:"react-selectize-toggle-button-container",onMouseDown:function(e){return a.props.open?a.onOpenChange(!1,function(){}):a.props.onAnchorChange(p(a.props.values),function(){return a.onOpenChange(!0,function(){})}),j(e)}},this.props.renderToggleButton({open:this.props.open,flipped:r}))),D((o=t({},this.props),o.ref="dropdownMenu",o.className=B((i={"react-selectize":1},i[this.props.className+""]=1,i)),o.theme=this.props.theme,o.scrollLock=this.props.scrollLock,o.onScrollChange=this.props.onScrollChange,o.bottomAnchor=function(){return M(a.refs.control)},o.tetherProps=(i=t({},this.props.tetherProps),i.target=function(){return M(a.refs.control)},i),o.highlightedUid=this.props.highlightedUid,o.onHighlightedUidChange=this.props.onHighlightedUidChange,o.onOptionClick=function(t){a.selectHighlightedUid(e,function(){})},o)))},handleKeydown:function(e,t){var n,o,i,a=this;switch(n=e.anchorIndex,t.persist(),t.which){case 8:if(this.props.search.length>0||n===-1)return;!function(){var e,t,r,o;return e=n,t=n-1<0?void 0:a.props.values[n-1],r=a.props.values[n],a.props.onValuesChange(null!=(o=m(function(e){return a.isEqualToObject(e,r)})(a.props.values))?o:[],function(){return function(){return function(e){return"undefined"==typeof s(function(e){return a.isEqualToObject(e,r)},a.props.values)?a.props.restoreOnBackspace?a.props.onSearchChange(a.props.restoreOnBackspace(r),function(){return e(!0)}):e(!0):e(!1)}}()(function(r){if(r&&(a.highlightAndScrollToSelectableOption(a.props.firstOptionIndexToHighlight(a.props.options),1),n===e&&("undefined"==typeof t||s(function(e){return a.isEqualToObject(e,t)})(a.props.values))))return a.props.onAnchorChange(t,function(){})})})}(),j(t);break;case 27:!function(){return a.props.open?function(e){return a.onOpenChange(!1,e)}:function(e){return a.props.onValuesChange([],e)}}()(function(){return a.props.onSearchChange("",function(){return a.focusOnInput()})})}if(this.props.open&&r(t.which,[13].concat(this.props.delimiters))&&!(null!=t&&t.metaKey||null!=t&&t.ctrlKey||null!=t&&t.shiftKey)&&(o=this.selectHighlightedUid(n,function(e){if("undefined"==typeof e)return a.props.onKeyboardSelectionFailed(t.which)}),o&&this.props.cancelKeyboardEventOnSelection))return j(t);if(0===this.props.search.length)switch(t.which){case 37:this.props.onAnchorChange(n-1<0||t.metaKey?void 0:this.props.values[_(n-1,0,this.props.values.length-1)],function(){});break;case 39:this.props.onAnchorChange(t.metaKey?p(this.props.values):this.props.values[_(n+1,0,this.props.values.length-1)],function(){})}switch(t.which){case 38:return this.props.onScrollLockChange(!0),i=function(){switch(!1){case"undefined"!=typeof this.props.highlightedUid:return 0;default:return-1+this.optionIndexFromUid(this.props.highlightedUid)}}.call(this),this.highlightAndScrollToSelectableOption(i,-1,function(e){if(!e)return a.highlightAndScrollToSelectableOption(a.props.options.length-1,-1)});case 40:return this.props.onScrollLockChange(!0),i=function(){switch(!1){case"undefined"!=typeof this.props.highlightedUid:return 0;default:return 1+this.optionIndexFromUid(this.props.highlightedUid)}}.call(this),this.highlightAndScrollToSelectableOption(i,1,function(e){if(!e)return a.highlightAndScrollToSelectableOption(0,1)})}},componentDidMount:function(){this.props.autofocus&&this.focus(),this.props.open&&this.highlightAndFocus()},componentDidUpdate:function(e){this.props.open&&!e.open&&void 0===this.props.highlightedUid&&this.highlightAndFocus(),!this.props.open&&e.open&&this.props.onHighlightedUidChange(void 0,function(){})},componentWillReceiveProps:function(e){"undefined"!=typeof this.props.disabled&&this.props.disabled!==!1||"undefined"==typeof e.disabled||e.disabled!==!0||this.onOpenChange(!1,function(){})},optionIndexFromUid:function(e){var t=this;return u(function(n){return w(e,t.props.uid(n))})(this.props.options)},closeDropdown:function(e){var t=this;this.onOpenChange(!1,function(){return t.props.onAnchorChange(p(t.props.values),e)})},blur:function(){this.refs.search.blur()},focus:function(){this.refs.search.focus()},focusOnInput:function(){var e;e=M(this.refs.search),e!==document.activeElement&&(this.focusLock=!0,e.focus(),e.value=e.value)},highlightAndFocus:function(){this.highlightAndScrollToSelectableOption(this.props.firstOptionIndexToHighlight(this.props.options),1),this.focusOnInput()},highlightAndScrollToOption:function(e,t){null==t&&(t=function(){}),this.refs.dropdownMenu.highlightAndScrollToOption(e,t)},highlightAndScrollToSelectableOption:function(e,t,n){var r=this;null==n&&(n=function(){}),function(){return r.props.open?function(e){return e()}:function(e){return r.onOpenChange(!0,e)}}()(function(){return r.refs.dropdownMenu.highlightAndScrollToSelectableOption(e,t,n)})},isEqualToObject:function(){return w(this.props.uid(arguments[0]),this.props.uid(arguments[1]))},onOpenChange:function(e,t){return this.props.onOpenChange(!this.props.disabled&&e,t)},selectHighlightedUid:function(e,t){var n,r,o=this;return void 0===this.props.highlightedUid?(t(),!1):(n=this.optionIndexFromUid(this.props.highlightedUid),"number"!=typeof n?(t(),!1):(r=this.props.options[n],function(){return o.props.onValuesChange(f(function(e){return o.props.values[e]},function(){var t,n,r=[];for(t=0,n=e;t<=n;++t)r.push(t);return r}()).concat([r],f(function(e){return o.props.values[e]},function(){var t,n,r=[];for(t=e+1,n=this.props.values.length;t<n;++t)r.push(t);return r}.call(o))),function(){var e;return e=s(function(e){return o.isEqualToObject(e,r)},o.props.values),e?o.props.onSearchChange("",function(){return o.props.onAnchorChange(e,function(){return o.props.open?o.highlightAndScrollToSelectableOption(n,1,function(n){return n?void t(e):o.highlightAndScrollToSelectableOption(o.props.firstOptionIndexToHighlight(o.props.options),1,function(n){return n?t(e):o.onOpenChange(!1,function(){return t(e)})})}):void t(e)})}):void t()})}(),!0))},uidToString:function(e){return("object"==typeof e?JSON.stringify:l)(e)}})}).call(this)},function(e,t,n){"use strict";function r(e,t,n){this.props=e,this.context=t,this.refs=a,this.updater=n||i}var o=n(22),i=n(55),a=(n(89),n(23));n(1),n(2);r.prototype.isReactComponent={},r.prototype.setState=function(e,t){"object"!=typeof e&&"function"!=typeof e&&null!=e?o("85"):void 0,this.updater.enqueueSetState(this,e),t&&this.updater.enqueueCallback(this,t,"setState")},r.prototype.forceUpdate=function(e){this.updater.enqueueForceUpdate(this),e&&this.updater.enqueueCallback(this,e,"forceUpdate")};e.exports=r},function(e,t,n){"use strict";function r(e,t){}var o=(n(2),{isMounted:function(e){return!1},enqueueCallback:function(e,t){},enqueueForceUpdate:function(e){r(e,"forceUpdate")},enqueueReplaceState:function(e,t){r(e,"replaceState")},enqueueSetState:function(e,t){r(e,"setState")}});e.exports=o},function(e,t){"use strict";t.__esModule=!0,t.default=void 0;var n=!("undefined"==typeof window||!window.document||!window.document.createElement);t.default=n,e.exports=t.default},function(e,t,n){"use strict";var r=n(8),o={listen:function(e,t,n){return e.addEventListener?(e.addEventListener(t,n,!1),{remove:function(){e.removeEventListener(t,n,!1)}}):e.attachEvent?(e.attachEvent("on"+t,n),{remove:function(){e.detachEvent("on"+t,n)}}):void 0},capture:function(e,t,n){return e.addEventListener?(e.addEventListener(t,n,!0),{remove:function(){e.removeEventListener(t,n,!0)}}):{remove:r}},registerDefault:function(){}};e.exports=o},function(e,t){"use strict";function n(e){try{e.focus()}catch(e){}}e.exports=n},function(e,t){"use strict";function n(e){if(e=e||("undefined"!=typeof document?document:void 0),"undefined"==typeof e)return null;try{return e.activeElement||e.body}catch(t){return e.body}}e.exports=n},function(e,t){function n(){throw new Error("setTimeout has not been defined")}function r(){throw new Error("clearTimeout has not been defined")}function o(e){if(c===setTimeout)return setTimeout(e,0);if((c===n||!c)&&setTimeout)return c=setTimeout,setTimeout(e,0);try{return c(e,0)}catch(t){try{return c.call(null,e,0)}catch(t){return c.call(this,e,0)}}}function i(e){if(p===clearTimeout)return clearTimeout(e);if((p===r||!p)&&clearTimeout)return p=clearTimeout,clearTimeout(e);try{return p(e)}catch(t){try{return p.call(null,e)}catch(t){return p.call(this,e)}}}function a(){m&&d&&(m=!1,d.length?h=d.concat(h):v=-1,h.length&&s())}function s(){if(!m){var e=o(a);m=!0;for(var t=h.length;t;){for(d=h,h=[];++v<t;)d&&d[v].run();v=-1,t=h.length}d=null,m=!1,i(e)}}function u(e,t){this.fun=e,this.array=t}function l(){}var c,p,f=e.exports={};!function(){try{c="function"==typeof setTimeout?setTimeout:n}catch(e){c=n}try{p="function"==typeof clearTimeout?clearTimeout:r}catch(e){p=r}}();var d,h=[],m=!1,v=-1;f.nextTick=function(e){var t=new Array(arguments.length-1);if(arguments.length>1)for(var n=1;n<arguments.length;n++)t[n-1]=arguments[n];h.push(new u(e,t)),1!==h.length||m||o(s)},u.prototype.run=function(){this.fun.apply(null,this.array)},f.title="browser",f.browser=!0,f.env={},f.argv=[],f.version="",f.versions={},f.on=l,f.addListener=l,f.once=l,f.off=l,f.removeListener=l,f.removeAllListeners=l,f.emit=l,f.prependListener=l,f.prependOnceListener=l,f.listeners=function(e){return[]},f.binding=function(e){throw new Error("process.binding is not supported")},f.cwd=function(){return"/"},f.chdir=function(e){throw new Error("process.chdir is not supported")},f.umask=function(){return 0}},function(e,t,n){"use strict";function r(){}function o(e){try{return e.then}catch(e){return g=e,y}}function i(e,t){try{return e(t)}catch(e){return g=e,y}}function a(e,t,n){try{e(t,n)}catch(e){return g=e,y}}function s(e){if("object"!=typeof this)throw new TypeError("Promises must be constructed via new");if("function"!=typeof e)throw new TypeError("not a function");this._45=0,this._81=0,this._65=null,this._54=null,e!==r&&m(e,this)}function u(e,t,n){return new e.constructor(function(o,i){var a=new s(r);a.then(o,i),l(e,new h(t,n,a))})}function l(e,t){for(;3===e._81;)e=e._65;return s._10&&s._10(e),0===e._81?0===e._45?(e._45=1,void(e._54=t)):1===e._45?(e._45=2,void(e._54=[e._54,t])):void e._54.push(t):void c(e,t)}function c(e,t){v(function(){var n=1===e._81?t.onFulfilled:t.onRejected;if(null===n)return void(1===e._81?p(t.promise,e._65):f(t.promise,e._65));var r=i(n,e._65);r===y?f(t.promise,g):p(t.promise,r)})}function p(e,t){if(t===e)return f(e,new TypeError("A promise cannot be resolved with itself."));if(t&&("object"==typeof t||"function"==typeof t)){var n=o(t);if(n===y)return f(e,g);if(n===e.then&&t instanceof s)return e._81=3,e._65=t,void d(e);if("function"==typeof n)return void m(n.bind(t),e)}e._81=1,e._65=t,d(e)}function f(e,t){e._81=2,e._65=t,s._97&&s._97(e,t),d(e)}function d(e){if(1===e._45&&(l(e,e._54),e._54=null),2===e._45){for(var t=0;t<e._54.length;t++)l(e,e._54[t]);e._54=null}}function h(e,t,n){this.onFulfilled="function"==typeof e?e:null,this.onRejected="function"==typeof t?t:null,this.promise=n}function m(e,t){var n=!1,r=a(e,function(e){n||(n=!0,p(t,e))},function(e){n||(n=!0,f(t,e))});n||r!==y||(n=!0,f(t,g))}var v=n(90),g=null,y={};e.exports=s,s._10=null,s._97=null,s._61=r,s.prototype.then=function(e,t){if(this.constructor!==s)return u(this,e,t);var n=new s(r);return l(this,new h(e,t,n)),n}},function(e,t,n){"use strict";var r=n(122);e.exports=function(e){var t=!1;return r(e,t)}},function(e,t,n){"use strict";e.exports=n(205)},function(e,t){"use strict";function n(e,t){return e+t.charAt(0).toUpperCase()+t.substring(1)}var r={animationIterationCount:!0,borderImageOutset:!0,borderImageSlice:!0,borderImageWidth:!0,boxFlex:!0,boxFlexGroup:!0,boxOrdinalGroup:!0,columnCount:!0,flex:!0,flexGrow:!0,flexPositive:!0,flexShrink:!0,flexNegative:!0,flexOrder:!0,gridRow:!0,gridColumn:!0,fontWeight:!0,lineClamp:!0,lineHeight:!0,opacity:!0,order:!0,orphans:!0,tabSize:!0,widows:!0,zIndex:!0,zoom:!0,fillOpacity:!0,floodOpacity:!0,stopOpacity:!0,strokeDasharray:!0,strokeDashoffset:!0,strokeMiterlimit:!0,strokeOpacity:!0,strokeWidth:!0},o=["Webkit","ms","Moz","O"];Object.keys(r).forEach(function(e){o.forEach(function(t){r[n(t,e)]=r[e]})});var i={background:{backgroundAttachment:!0,backgroundColor:!0,backgroundImage:!0,backgroundPositionX:!0,backgroundPositionY:!0,backgroundRepeat:!0},backgroundPosition:{backgroundPositionX:!0,backgroundPositionY:!0},border:{borderWidth:!0,borderStyle:!0,borderColor:!0},borderBottom:{borderBottomWidth:!0,borderBottomStyle:!0,borderBottomColor:!0},borderLeft:{borderLeftWidth:!0,borderLeftStyle:!0,borderLeftColor:!0},borderRight:{borderRightWidth:!0,borderRightStyle:!0,borderRightColor:!0},borderTop:{borderTopWidth:!0,borderTopStyle:!0,borderTopColor:!0},font:{fontStyle:!0,fontVariant:!0,fontWeight:!0,fontSize:!0,lineHeight:!0,fontFamily:!0},outline:{outlineWidth:!0,outlineStyle:!0,outlineColor:!0}},a={isUnitlessNumber:r,shorthandPropertyExpansions:i};e.exports=a},function(e,t,n){"use strict";function r(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}var o=n(3),i=n(14),a=(n(1),function(){function e(t){r(this,e),this._callbacks=null,this._contexts=null,this._arg=t}return e.prototype.enqueue=function(e,t){this._callbacks=this._callbacks||[],this._callbacks.push(e),this._contexts=this._contexts||[],this._contexts.push(t)},e.prototype.notifyAll=function(){var e=this._callbacks,t=this._contexts,n=this._arg;if(e&&t){e.length!==t.length?o("24"):void 0,this._callbacks=null,this._contexts=null;for(var r=0;r<e.length;r++)e[r].call(t[r],n);e.length=0,t.length=0}},e.prototype.checkpoint=function(){return this._callbacks?this._callbacks.length:0},e.prototype.rollback=function(e){this._callbacks&&this._contexts&&(this._callbacks.length=e,this._contexts.length=e)},e.prototype.reset=function(){this._callbacks=null,this._contexts=null},e.prototype.destructor=function(){this.reset()},e}());e.exports=i.addPoolingTo(a)},function(e,t,n){"use strict";function r(e){return!!l.hasOwnProperty(e)||!u.hasOwnProperty(e)&&(s.test(e)?(l[e]=!0,!0):(u[e]=!0,!1))}function o(e,t){return null==t||e.hasBooleanValue&&!t||e.hasNumericValue&&isNaN(t)||e.hasPositiveNumericValue&&t<1||e.hasOverloadedBooleanValue&&t===!1}var i=n(18),a=(n(6),n(9),n(186)),s=(n(2),new RegExp("^["+i.ATTRIBUTE_NAME_START_CHAR+"]["+i.ATTRIBUTE_NAME_CHAR+"]*$")),u={},l={},c={createMarkupForID:function(e){return i.ID_ATTRIBUTE_NAME+"="+a(e)},setAttributeForID:function(e,t){e.setAttribute(i.ID_ATTRIBUTE_NAME,t)},createMarkupForRoot:function(){return i.ROOT_ATTRIBUTE_NAME+'=""'},setAttributeForRoot:function(e){e.setAttribute(i.ROOT_ATTRIBUTE_NAME,"")},createMarkupForProperty:function(e,t){var n=i.properties.hasOwnProperty(e)?i.properties[e]:null;if(n){if(o(n,t))return"";var r=n.attributeName;return n.hasBooleanValue||n.hasOverloadedBooleanValue&&t===!0?r+'=""':r+"="+a(t)}return i.isCustomAttribute(e)?null==t?"":e+"="+a(t):null},createMarkupForCustomAttribute:function(e,t){return r(e)&&null!=t?e+"="+a(t):""},setValueForProperty:function(e,t,n){var r=i.properties.hasOwnProperty(t)?i.properties[t]:null;if(r){var a=r.mutationMethod;if(a)a(e,n);else{if(o(r,n))return void this.deleteValueForProperty(e,t);if(r.mustUseProperty)e[r.propertyName]=n;else{var s=r.attributeName,u=r.attributeNamespace;u?e.setAttributeNS(u,s,""+n):r.hasBooleanValue||r.hasOverloadedBooleanValue&&n===!0?e.setAttribute(s,""):e.setAttribute(s,""+n)}}}else if(i.isCustomAttribute(t))return void c.setValueForAttribute(e,t,n)},setValueForAttribute:function(e,t,n){if(r(t)){null==n?e.removeAttribute(t):e.setAttribute(t,""+n)}},deleteValueForAttribute:function(e,t){e.removeAttribute(t)},deleteValueForProperty:function(e,t){var n=i.properties.hasOwnProperty(t)?i.properties[t]:null;if(n){var r=n.mutationMethod;if(r)r(e,void 0);else if(n.mustUseProperty){var o=n.propertyName;n.hasBooleanValue?e[o]=!1:e[o]=""}else e.removeAttribute(n.attributeName)}else i.isCustomAttribute(t)&&e.removeAttribute(t)}};e.exports=c},function(e,t){"use strict";var n={hasCachedChildNodes:1};e.exports=n},function(e,t,n){"use strict";function r(){if(this._rootNodeID&&this._wrapperState.pendingUpdate){this._wrapperState.pendingUpdate=!1;var e=this._currentElement.props,t=s.getValue(e);null!=t&&o(this,Boolean(e.multiple),t)}}function o(e,t,n){var r,o,i=u.getNodeFromInstance(e).options;if(t){for(r={},o=0;o<n.length;o++)r[""+n[o]]=!0;for(o=0;o<i.length;o++){var a=r.hasOwnProperty(i[o].value);i[o].selected!==a&&(i[o].selected=a)}}else{for(r=""+n,o=0;o<i.length;o++)if(i[o].value===r)return void(i[o].selected=!0);i.length&&(i[0].selected=!0)}}function i(e){var t=this._currentElement.props,n=s.executeOnChange(t,e);return this._rootNodeID&&(this._wrapperState.pendingUpdate=!0),l.asap(r,this),n}var a=n(4),s=n(42),u=n(6),l=n(10),c=(n(2),!1),p={getHostProps:function(e,t){return a({},t,{onChange:e._wrapperState.onChange,value:void 0})},mountWrapper:function(e,t){var n=s.getValue(t);e._wrapperState={pendingUpdate:!1,initialValue:null!=n?n:t.defaultValue,listeners:null,onChange:i.bind(e),wasMultiple:Boolean(t.multiple)},void 0===t.value||void 0===t.defaultValue||c||(c=!0)},getSelectValueContext:function(e){return e._wrapperState.initialValue},postUpdateWrapper:function(e){var t=e._currentElement.props;e._wrapperState.initialValue=void 0;var n=e._wrapperState.wasMultiple;e._wrapperState.wasMultiple=Boolean(t.multiple);var r=s.getValue(t);null!=r?(e._wrapperState.pendingUpdate=!1,o(e,Boolean(t.multiple),r)):n!==Boolean(t.multiple)&&(null!=t.defaultValue?o(e,Boolean(t.multiple),t.defaultValue):o(e,Boolean(t.multiple),t.multiple?[]:""))}};e.exports=p},function(e,t){"use strict";var n,r={injectEmptyComponentFactory:function(e){n=e}},o={create:function(e){return n(e)}};o.injection=r,e.exports=o},function(e,t){"use strict";var n={logTopLevelRenders:!1};e.exports=n},function(e,t,n){"use strict";function r(e){return s?void 0:a("111",e.type),new s(e)}function o(e){return new u(e)}function i(e){return e instanceof u}var a=n(3),s=(n(1),null),u=null,l={injectGenericComponentClass:function(e){s=e},injectTextComponentClass:function(e){u=e}},c={createInternalComponent:r,createInstanceForText:o,isTextComponent:i,injection:l};e.exports=c},function(e,t,n){"use strict";function r(e){return i(document.documentElement,e)}var o=n(146),i=n(103),a=n(58),s=n(59),u={hasSelectionCapabilities:function(e){var t=e&&e.nodeName&&e.nodeName.toLowerCase();return t&&("input"===t&&"text"===e.type||"textarea"===t||"true"===e.contentEditable)},getSelectionInformation:function(){var e=s();return{focusedElem:e,selectionRange:u.hasSelectionCapabilities(e)?u.getSelection(e):null}},restoreSelection:function(e){var t=s(),n=e.focusedElem,o=e.selectionRange;t!==n&&r(n)&&(u.hasSelectionCapabilities(n)&&u.setSelection(n,o),a(n))},getSelection:function(e){var t;if("selectionStart"in e)t={start:e.selectionStart,end:e.selectionEnd};else if(document.selection&&e.nodeName&&"input"===e.nodeName.toLowerCase()){var n=document.selection.createRange();n.parentElement()===e&&(t={start:-n.moveStart("character",-e.value.length),end:-n.moveEnd("character",-e.value.length)})}else t=o.getOffsets(e);return t||{start:0,end:0}},setSelection:function(e,t){var n=t.start,r=t.end;if(void 0===r&&(r=n),"selectionStart"in e)e.selectionStart=n,e.selectionEnd=Math.min(r,e.value.length);else if(document.selection&&e.nodeName&&"input"===e.nodeName.toLowerCase()){var i=e.createTextRange();i.collapse(!0),i.moveStart("character",n),i.moveEnd("character",r-n),i.select()}else o.setOffsets(e,t)}};e.exports=u},function(e,t,n){"use strict";function r(e,t){for(var n=Math.min(e.length,t.length),r=0;r<n;r++)if(e.charAt(r)!==t.charAt(r))return r;return e.length===t.length?-1:n}function o(e){return e?e.nodeType===D?e.documentElement:e.firstChild:null}function i(e){return e.getAttribute&&e.getAttribute(M)||""}function a(e,t,n,r,o){var i;if(_.logTopLevelRenders){var a=e._currentElement.props.child,s=a.type;i="React mount: "+("string"==typeof s?s:s.displayName||s.name),console.time(i)}var u=T.mountComponent(e,n,null,b(e,t),o,0);i&&console.timeEnd(i),e._renderedComponent._topLevelWrapper=e,j._mountImageIntoNode(u,t,e,r,n)}function s(e,t,n,r){var o=O.ReactReconcileTransaction.getPooled(!n&&C.useCreateElement);o.perform(a,null,e,t,o,n,r),O.ReactReconcileTransaction.release(o)}function u(e,t,n){for(T.unmountComponent(e,n),t.nodeType===D&&(t=t.documentElement);t.lastChild;)t.removeChild(t.lastChild)}function l(e){var t=o(e);if(t){var n=y.getInstanceFromNode(t);return!(!n||!n._hostParent)}}function c(e){return!(!e||e.nodeType!==I&&e.nodeType!==D&&e.nodeType!==R)}function p(e){var t=o(e),n=t&&y.getInstanceFromNode(t);return n&&!n._hostParent?n:null}function f(e){var t=p(e);return t?t._hostContainerInfo._topLevelWrapper:null}var d=n(3),h=n(17),m=n(18),v=n(20),g=n(29),y=(n(12),n(6)),b=n(140),C=n(142),_=n(70),w=n(26),E=(n(9),n(156)),T=n(19),x=n(45),O=n(10),P=n(23),k=n(80),S=(n(1),n(33)),N=n(51),M=(n(2),m.ID_ATTRIBUTE_NAME),A=m.ROOT_ATTRIBUTE_NAME,I=1,D=9,R=11,L={},U=1,F=function(){this.rootID=U++};F.prototype.isReactComponent={},F.prototype.render=function(){return this.props.child},F.isReactTopLevelWrapper=!0;var j={TopLevelWrapper:F,_instancesByReactRootID:L,scrollMonitor:function(e,t){t()},_updateRootComponent:function(e,t,n,r,o){return j.scrollMonitor(r,function(){x.enqueueElementInternal(e,t,n),o&&x.enqueueCallbackInternal(e,o)}),e},_renderNewRootComponent:function(e,t,n,r){c(t)?void 0:d("37"),g.ensureScrollValueMonitoring();var o=k(e,!1);O.batchedUpdates(s,o,t,n,r);
-var i=o._instance.rootID;return L[i]=o,o},renderSubtreeIntoContainer:function(e,t,n,r){return null!=e&&w.has(e)?void 0:d("38"),j._renderSubtreeIntoContainer(e,t,n,r)},_renderSubtreeIntoContainer:function(e,t,n,r){x.validateCallback(r,"ReactDOM.render"),v.isValidElement(t)?void 0:d("39","string"==typeof t?" Instead of passing a string like 'div', pass React.createElement('div') or <div />.":"function"==typeof t?" Instead of passing a class like Foo, pass React.createElement(Foo) or <Foo />.":null!=t&&void 0!==t.props?" This may be caused by unintentionally loading two independent copies of React.":"");var a,s=v.createElement(F,{child:t});if(e){var u=w.get(e);a=u._processChildContext(u._context)}else a=P;var c=f(n);if(c){var p=c._currentElement,h=p.props.child;if(N(h,t)){var m=c._renderedComponent.getPublicInstance(),g=r&&function(){r.call(m)};return j._updateRootComponent(c,s,a,n,g),m}j.unmountComponentAtNode(n)}var y=o(n),b=y&&!!i(y),C=l(n),_=b&&!c&&!C,E=j._renderNewRootComponent(s,n,_,a)._renderedComponent.getPublicInstance();return r&&r.call(E),E},render:function(e,t,n){return j._renderSubtreeIntoContainer(null,e,t,n)},unmountComponentAtNode:function(e){c(e)?void 0:d("40");var t=f(e);if(!t){l(e),1===e.nodeType&&e.hasAttribute(A);return!1}return delete L[t._instance.rootID],O.batchedUpdates(u,t,e,!1),!0},_mountImageIntoNode:function(e,t,n,i,a){if(c(t)?void 0:d("41"),i){var s=o(t);if(E.canReuseMarkup(e,s))return void y.precacheNode(n,s);var u=s.getAttribute(E.CHECKSUM_ATTR_NAME);s.removeAttribute(E.CHECKSUM_ATTR_NAME);var l=s.outerHTML;s.setAttribute(E.CHECKSUM_ATTR_NAME,u);var p=e,f=r(p,l),m=" (client) "+p.substring(f-20,f+20)+"\n (server) "+l.substring(f-20,f+20);t.nodeType===D?d("42",m):void 0}if(t.nodeType===D?d("43"):void 0,a.useCreateElement){for(;t.lastChild;)t.removeChild(t.lastChild);h.insertTreeBefore(t,e,null)}else S(t,e),y.precacheNode(n,t.firstChild)}};e.exports=j},function(e,t,n){"use strict";var r=n(3),o=n(20),i=(n(1),{HOST:0,COMPOSITE:1,EMPTY:2,getType:function(e){return null===e||e===!1?i.EMPTY:o.isValidElement(e)?"function"==typeof e.type?i.COMPOSITE:i.HOST:void r("26",e)}});e.exports=i},function(e,t){"use strict";var n={currentScrollLeft:0,currentScrollTop:0,refreshScrollValues:function(e){n.currentScrollLeft=e.x,n.currentScrollTop=e.y}};e.exports=n},function(e,t,n){"use strict";function r(e,t){return null==t?o("30"):void 0,null==e?t:Array.isArray(e)?Array.isArray(t)?(e.push.apply(e,t),e):(e.push(t),e):Array.isArray(t)?[e].concat(t):[e,t]}var o=n(3);n(1);e.exports=r},function(e,t){"use strict";function n(e,t,n){Array.isArray(e)?e.forEach(t,n):e&&t.call(n,e)}e.exports=n},function(e,t,n){"use strict";function r(e){for(var t;(t=e._renderedNodeType)===o.COMPOSITE;)e=e._renderedComponent;return t===o.HOST?e._renderedComponent:t===o.EMPTY?null:void 0}var o=n(74);e.exports=r},function(e,t,n){"use strict";function r(){return!i&&o.canUseDOM&&(i="textContent"in document.documentElement?"textContent":"innerText"),i}var o=n(7),i=null;e.exports=r},function(e,t,n){"use strict";function r(e){if(e){var t=e.getName();if(t)return" Check the render method of `"+t+"`."}return""}function o(e){return"function"==typeof e&&"undefined"!=typeof e.prototype&&"function"==typeof e.prototype.mountComponent&&"function"==typeof e.prototype.receiveComponent}function i(e,t){var n;if(null===e||e===!1)n=l.create(i);else if("object"==typeof e){var s=e,u=s.type;if("function"!=typeof u&&"string"!=typeof u){var f="";f+=r(s._owner),a("130",null==u?u:typeof u,f)}"string"==typeof s.type?n=c.createInternalComponent(s):o(s.type)?(n=new s.type(s),n.getHostNode||(n.getHostNode=n.getNativeNode)):n=new p(s)}else"string"==typeof e||"number"==typeof e?n=c.createInstanceForText(e):a("131",typeof e);return n._mountIndex=0,n._mountImage=null,n}var a=n(3),s=n(4),u=n(137),l=n(69),c=n(71),p=(n(221),n(1),n(2),function(e){this.construct(e)});s(p.prototype,u,{_instantiateReactComponent:i}),e.exports=i},function(e,t){"use strict";function n(e){var t=e&&e.nodeName&&e.nodeName.toLowerCase();return"input"===t?!!r[e.type]:"textarea"===t}var r={color:!0,date:!0,datetime:!0,"datetime-local":!0,email:!0,month:!0,number:!0,password:!0,range:!0,search:!0,tel:!0,text:!0,time:!0,url:!0,week:!0};e.exports=n},function(e,t,n){"use strict";var r=n(7),o=n(32),i=n(33),a=function(e,t){if(t){var n=e.firstChild;if(n&&n===e.lastChild&&3===n.nodeType)return void(n.nodeValue=t)}e.textContent=t};r.canUseDOM&&("textContent"in document.documentElement||(a=function(e,t){return 3===e.nodeType?void(e.nodeValue=t):void i(e,o(t))})),e.exports=a},function(e,t,n){"use strict";function r(e,t){return e&&"object"==typeof e&&null!=e.key?l.escape(e.key):t.toString(36)}function o(e,t,n,i){var f=typeof e;if("undefined"!==f&&"boolean"!==f||(e=null),null===e||"string"===f||"number"===f||"object"===f&&e.$$typeof===s)return n(i,e,""===t?c+r(e,0):t),1;var d,h,m=0,v=""===t?c:t+p;if(Array.isArray(e))for(var g=0;g<e.length;g++)d=e[g],h=v+r(d,g),m+=o(d,h,n,i);else{var y=u(e);if(y){var b,C=y.call(e);if(y!==e.entries)for(var _=0;!(b=C.next()).done;)d=b.value,h=v+r(d,_++),m+=o(d,h,n,i);else for(;!(b=C.next()).done;){var w=b.value;w&&(d=w[1],h=v+l.escape(w[0])+p+r(d,0),m+=o(d,h,n,i))}}else if("object"===f){var E="",T=String(e);a("31","[object Object]"===T?"object with keys {"+Object.keys(e).join(", ")+"}":T,E)}}return m}function i(e,t,n){return null==e?0:o(e,"",t,n)}var a=n(3),s=(n(12),n(152)),u=n(183),l=(n(1),n(41)),c=(n(2),"."),p=":";e.exports=i},function(e,t,n){(function(){var t,r,o,i,a;t=n(5),r=t.createClass,o=t.DOM.div,i=n(16).isEqualToObject,a=n(28).cancelEvent,e.exports=r({getDefaultProps:function(){return{}},render:function(){var e=this;return o({className:"option-wrapper "+(this.props.highlight?"highlight":""),onMouseDown:function(t){var n;return n=function(t){return e.props.onClick(t),window.removeEventListener("mouseup",n)},window.addEventListener("mouseup",n),a(t)},onMouseMove:this.props.onMouseMove,onMouseOut:this.props.onMouseOut,onMouseOver:this.props.onMouseOver},this.props.renderItem(this.props.item))},shouldComponentUpdate:function(e){var t,n,r;return!i(null!=e?e.uid:void 0,null!=(t=this.props)?t.uid:void 0)||(null!=e?e.highlight:void 0)!==(null!=(n=this.props)?n.highlight:void 0)||(null!=e?e.selectable:void 0)!==(null!=(r=this.props)?r.selectable:void 0)}})}).call(this)},function(e,t,n){(function(){var t,r,o,i;t=n(5),r=t.createClass,o=t.DOM.svg,i=n(13).findDOMNode,e.exports=r({render:function(){return o(this.props)},componentDidMount:function(){i(this).setAttribute("focusable",!1)}})}).call(this)},function(e,t,n){"use strict";function r(e){return e&&e.__esModule?e:{default:e}}function o(e){var t="transition"+e+"Timeout",n="transition"+e;return function(e){if(e[n]){if(null==e[t])return new Error(t+" wasn't supplied to CSSTransitionGroup: this can cause unreliable animations and won't be supported in a future version of React. See https://fb.me/react-animation-transition-group-timeout for more information.");if("number"!=typeof e[t])return new Error(t+" must be a number (in milliseconds)")}return null}}t.__esModule=!0,t.nameShape=void 0,t.transitionTimeout=o;var i=n(5),a=(r(i),n(34)),s=r(a);t.nameShape=s.default.oneOfType([s.default.string,s.default.shape({enter:s.default.string,leave:s.default.string,active:s.default.string}),s.default.shape({enter:s.default.string,enterActive:s.default.string,leave:s.default.string,leaveActive:s.default.string,appear:s.default.string,appearActive:s.default.string})])},function(e,t,n){"use strict";function r(e){var t=Function.prototype.toString,n=Object.prototype.hasOwnProperty,r=RegExp("^"+t.call(n).replace(/[\\^$.*+?()[\]{}|]/g,"\\$&").replace(/hasOwnProperty|(function).*?(?=\\\()| for .+?(?=\\\])/g,"$1.*?")+"$");try{var o=t.call(e);return r.test(o)}catch(e){return!1}}function o(e){var t=l(e);if(t){var n=t.childIDs;c(e),n.forEach(o)}}function i(e,t,n){return"\n    in "+(e||"Unknown")+(t?" (at "+t.fileName.replace(/^.*[\\\/]/,"")+":"+t.lineNumber+")":n?" (created by "+n+")":"")}function a(e){return null==e?"#empty":"string"==typeof e||"number"==typeof e?"#text":"string"==typeof e.type?e.type:e.type.displayName||e.type.name||"Unknown"}function s(e){var t,n=x.getDisplayName(e),r=x.getElement(e),o=x.getOwnerID(e);return o&&(t=x.getDisplayName(o)),i(n,r&&r._source,t)}var u,l,c,p,f,d,h,m=n(22),v=n(12),g=(n(1),n(2),"function"==typeof Array.from&&"function"==typeof Map&&r(Map)&&null!=Map.prototype&&"function"==typeof Map.prototype.keys&&r(Map.prototype.keys)&&"function"==typeof Set&&r(Set)&&null!=Set.prototype&&"function"==typeof Set.prototype.keys&&r(Set.prototype.keys));if(g){var y=new Map,b=new Set;u=function(e,t){y.set(e,t)},l=function(e){return y.get(e)},c=function(e){y.delete(e)},p=function(){return Array.from(y.keys())},f=function(e){b.add(e)},d=function(e){b.delete(e)},h=function(){return Array.from(b.keys())}}else{var C={},_={},w=function(e){return"."+e},E=function(e){return parseInt(e.substr(1),10)};u=function(e,t){var n=w(e);C[n]=t},l=function(e){var t=w(e);return C[t]},c=function(e){var t=w(e);delete C[t]},p=function(){return Object.keys(C).map(E)},f=function(e){var t=w(e);_[t]=!0},d=function(e){var t=w(e);delete _[t]},h=function(){return Object.keys(_).map(E)}}var T=[],x={onSetChildren:function(e,t){var n=l(e);n?void 0:m("144"),n.childIDs=t;for(var r=0;r<t.length;r++){var o=t[r],i=l(o);i?void 0:m("140"),null==i.childIDs&&"object"==typeof i.element&&null!=i.element?m("141"):void 0,i.isMounted?void 0:m("71"),null==i.parentID&&(i.parentID=e),i.parentID!==e?m("142",o,i.parentID,e):void 0}},onBeforeMountComponent:function(e,t,n){var r={element:t,parentID:n,text:null,childIDs:[],isMounted:!1,updateCount:0};u(e,r)},onBeforeUpdateComponent:function(e,t){var n=l(e);n&&n.isMounted&&(n.element=t)},onMountComponent:function(e){var t=l(e);t?void 0:m("144"),t.isMounted=!0;var n=0===t.parentID;n&&f(e)},onUpdateComponent:function(e){var t=l(e);t&&t.isMounted&&t.updateCount++},onUnmountComponent:function(e){var t=l(e);if(t){t.isMounted=!1;var n=0===t.parentID;n&&d(e)}T.push(e)},purgeUnmountedComponents:function(){if(!x._preventPurging){for(var e=0;e<T.length;e++){var t=T[e];o(t)}T.length=0}},isMounted:function(e){var t=l(e);return!!t&&t.isMounted},getCurrentStackAddendum:function(e){var t="";if(e){var n=a(e),r=e._owner;t+=i(n,e._source,r&&r.getName())}var o=v.current,s=o&&o._debugID;return t+=x.getStackAddendumByID(s)},getStackAddendumByID:function(e){for(var t="";e;)t+=s(e),e=x.getParentID(e);return t},getChildIDs:function(e){var t=l(e);return t?t.childIDs:[]},getDisplayName:function(e){var t=x.getElement(e);return t?a(t):null},getElement:function(e){var t=l(e);return t?t.element:null},getOwnerID:function(e){var t=x.getElement(e);return t&&t._owner?t._owner._debugID:null},getParentID:function(e){var t=l(e);return t?t.parentID:null},getSource:function(e){var t=l(e),n=t?t.element:null,r=null!=n?n._source:null;return r},getText:function(e){var t=x.getElement(e);return"string"==typeof t?t:"number"==typeof t?""+t:null},getUpdateCount:function(e){var t=l(e);return t?t.updateCount:0},getRootIDs:h,getRegisteredIDs:p};e.exports=x},function(e,t){"use strict";var n="function"==typeof Symbol&&Symbol.for&&Symbol.for("react.element")||60103;e.exports=n},function(e,t,n){"use strict";var r=!1;e.exports=r},function(e,t){(function(t){"use strict";function n(e){s.length||(a(),u=!0),s[s.length]=e}function r(){for(;l<s.length;){var e=l;if(l+=1,s[e].call(),l>c){for(var t=0,n=s.length-l;t<n;t++)s[t]=s[t+l];s.length-=l,l=0}}s.length=0,l=0,u=!1}function o(e){var t=1,n=new f(e),r=document.createTextNode("");return n.observe(r,{characterData:!0}),function(){t=-t,r.data=t}}function i(e){return function(){function t(){clearTimeout(n),clearInterval(r),e()}var n=setTimeout(t,0),r=setInterval(t,50)}}e.exports=n;var a,s=[],u=!1,l=0,c=1024,p="undefined"!=typeof t?t:self,f=p.MutationObserver||p.WebKitMutationObserver;a="function"==typeof f?o(r):i(r),n.requestFlush=a,n.makeRequestCallFromTimer=i}).call(t,function(){return this}())},function(e,t,n){"use strict";function r(e){return e&&e.__esModule?e:{default:e}}function o(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function i(e,t){if(!e)throw new ReferenceError("this hasn't been initialised - super() hasn't been called");return!t||"object"!=typeof t&&"function"!=typeof t?e:t}function a(e,t){if("function"!=typeof t&&null!==t)throw new TypeError("Super expression must either be null or a function, not "+typeof t);e.prototype=Object.create(t&&t.prototype,{constructor:{value:e,enumerable:!1,writable:!0,configurable:!0}}),t&&(Object.setPrototypeOf?Object.setPrototypeOf(e,t):e.__proto__=t)}Object.defineProperty(t,"__esModule",{value:!0});var s=function(){function e(e,t){for(var n=0;n<t.length;n++){var r=t[n];r.enumerable=r.enumerable||!1,r.configurable=!0,"value"in r&&(r.writable=!0),Object.defineProperty(e,r.key,r)}}return function(t,n,r){return n&&e(t.prototype,n),r&&e(t,r),t}}(),u=n(5),l=r(u),c=n(204),p=function(e){function t(e){o(this,t);var n=i(this,(t.__proto__||Object.getPrototypeOf(t)).call(this,e));return n.getCoefficients=function(e){if(e)return e.map(function(e,t){return l.default.createElement("option",{key:t,value:e.value},e.name)})},n.labels=[],n.handleInputChange=n.handleInputChange.bind(n),n.handleValueChange=n.handleValueChange.bind(n),n}return a(t,e),s(t,[{key:"handleInputChange",value:function(e){var t=this.props.condition;t[e.target.name]=e.target.value;var n=this.props.parameters.find(function(t){return t.value===e.target.value});n&&(t.type=n.type),this.props.onChange({index:this.props.index,value:t})}},{key:"handleValueChange",value:function(e){var t=this.props.condition;t.value=e.map(function(e){return e.value}),this.props.onChange({index:this.props.index,value:t})}},{key:"getOperators",value:function(e,t){if(e&&t)return e.filter(function(e){return e.types.indexOf(t.type)>-1}).map(function(e,t){return l.default.createElement("option",{key:t,value:e.name},e.name)})}},{key:"getValues",value:function(e){return e?e.map(function(e){return{label:e,value:e}}):[]}},{key:"render",value:function(){var e=this,t=this.props.parameters.find(function(t){return t.value===e.props.condition.parameter});return this.props.condition.type=t?t.type:null,l.default.createElement("div",{className:this.props.classes.filterLineRow},l.default.createElement("div",{className:this.props.classes.filterLineParameter},l.default.createElement("select",{className:this.props.classes.filterLineInput,name:"parameter",value:this.props.condition.parameter,onChange:this.handleInputChange},l.default.createElement("option",{value:""},"-- Parameter --"),this.getCoefficients(this.props.parameters))),l.default.createElement("div",{className:this.props.classes.filterLineOperator,style:{"padding-left":0,"padding-right":0}},l.default.createElement("select",{className:this.props.classes.filterLineInput,name:"operator",value:this.props.condition.operator,onChange:this.handleInputChange},l.default.createElement("option",{disabled:!0,value:""},"-- Operator --"),this.getOperators(this.props.operators,this.props.parameters.find(function(t){return t.value===e.props.condition.parameter})))),l.default.createElement("div",{className:this.props.classes.filterLineValue},l.default.createElement(c.MultiSelect,{style:{width:"100%"},placeholder:"-- Value --",theme:"bootstrap3",values:this.getValues(this.props.condition.value),onValuesChange:this.handleValueChange,uid:function(e){return e.value},restoreOnBackspace:function(e){return e.label.toString()},createFromSearch:function(t,n,r){return e.labels=n.map(function(e){return e.label}),0===r.trim().length||e.labels.indexOf(r.trim())!==-1?null:{label:r.trim(),value:r.trim()}},renderNoResultsFound:function(e,t){return l.default.createElement("div",{className:"no-results-found"},function(){return 0===t.trim().length?"Enter a new value":e.map(function(e){return e.label}).indexOf(t.trim())!==-1?"Value already exists":void 0}())}})))}}]),t}(u.Component);t.default=p},function(e,t,n){"use strict";function r(e){return e&&e.__esModule?e:{default:e}}function o(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function i(e,t){if(!e)throw new ReferenceError("this hasn't been initialised - super() hasn't been called");return!t||"object"!=typeof t&&"function"!=typeof t?e:t}function a(e,t){if("function"!=typeof t&&null!==t)throw new TypeError("Super expression must either be null or a function, not "+typeof t);e.prototype=Object.create(t&&t.prototype,{constructor:{value:e,enumerable:!1,writable:!0,configurable:!0}}),t&&(Object.setPrototypeOf?Object.setPrototypeOf(e,t):e.__proto__=t)}Object.defineProperty(t,"__esModule",{value:!0});var s=function(){function e(e,t){for(var n=0;n<t.length;n++){var r=t[n];r.enumerable=r.enumerable||!1,r.configurable=!0,"value"in r&&(r.writable=!0),Object.defineProperty(e,r.key,r)}}return function(t,n,r){return n&&e(t.prototype,n),r&&e(t,r),t}}(),u=n(5),l=r(u),c={paddingTop:10,paddingBottom:10,paddingRight:3,paddingLeft:3},p=function(e){function t(e){o(this,t);var n=i(this,(t.__proto__||Object.getPrototypeOf(t)).call(this,e));return n.removeCondition=n.removeCondition.bind(n),n.addCondition=n.addCondition.bind(n),n}return a(t,e),s(t,[{key:"removeCondition",value:function(){this.props.removeCondition(this.props.index)}},{key:"addCondition",value:function(){this.props.addCondition(this.props.index)}},{key:"render",value:function(){return l.default.createElement("div",{className:this.props.classes.filterLineLabelRow},l.default.createElement("div",{className:this.props.classes.filterLineLabelCondition},l.default.createElement("label",{style:{marginTop:0}},"Condition {",this.props.index+1,"}")),l.default.createElement("div",{className:this.props.classes.filterLineLabelControls},l.default.createElement("a",{style:c,onClick:this.addCondition},l.default.createElement("span",{className:this.props.classes.plusIcon})),l.default.createElement("a",{style:c,onClick:this.removeCondition},l.default.createElement("span",{className:this.props.classes.minusIcon}))))}}]),t}(u.Component);t.default=p},function(e,t,n){"use strict";function r(e){return e&&e.__esModule?e:{default:e}}function o(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function i(e,t){if(!e)throw new ReferenceError("this hasn't been initialised - super() hasn't been called");return!t||"object"!=typeof t&&"function"!=typeof t?e:t}function a(e,t){if("function"!=typeof t&&null!==t)throw new TypeError("Super expression must either be null or a function, not "+typeof t);e.prototype=Object.create(t&&t.prototype,{constructor:{value:e,enumerable:!1,writable:!0,configurable:!0}}),t&&(Object.setPrototypeOf?Object.setPrototypeOf(e,t):e.__proto__=t)}Object.defineProperty(t,"__esModule",{value:!0});var s=function(){function e(e,t){for(var n=0;n<t.length;n++){var r=t[n];r.enumerable=r.enumerable||!1,r.configurable=!0,"value"in r&&(r.writable=!0),Object.defineProperty(e,r.key,r)}}return function(t,n,r){return n&&e(t.prototype,n),r&&e(t,r),t}}(),u=n(5),l=r(u),c=n(91),p=r(c),f=n(92),d=r(f),h=function(e){function t(e){o(this,t);var n=i(this,(t.__proto__||Object.getPrototypeOf(t)).call(this,e));return n.state={conditions:e.config.conditions},n.updateCondition=n.updateCondition.bind(n),n.addCondition=n.addCondition.bind(n),n.removeCondition=n.removeCondition.bind(n),n.componentDidUpdate=n.componentDidUpdate.bind(n),n}return a(t,e),s(t,[{key:"updateCondition",value:function(e){var t=this.state.conditions;t[e.index]=e.value,this.setState({conditions:t})}},{key:"addCondition",value:function(e){var t=this.state.conditions;t.splice(e+1,0,{parameter:"",operator:"",value:""}),this.setState({conditions:t})}},{key:"removeCondition",value:function(e){if(this.state.conditions.length>1){var t=this.state.conditions;t.splice(e,1),this.setState({conditions:t})}}},{key:"componentDidUpdate",value:function(e,t){t!==this.state&&this.props.config.updateConditions(this.state.conditions)}},{key:"render",value:function(){var e=this,t=this.state.conditions.map(function(t,n){return l.default.createElement("div",{key:n},l.default.createElement(d.default,{index:n,classes:e.props.config.classes,addCondition:e.addCondition,removeCondition:e.removeCondition}),l.default.createElement(p.default,{parameters:e.props.config.parameters,operators:e.props.config.operators,condition:t,index:n,classes:e.props.config.classes,onChange:e.updateCondition}))});return l.default.createElement("div",{className:"form-horizontal"},t)}}]),t}(u.Component);t.default=h},function(e,t,n){"use strict";function r(e){return e&&e.__esModule?e:{default:e}}var o=n(5),i=r(o),a=n(13),s=r(a),u=n(93),l=r(u),c=window.$;if(c.fn.filterer=function(e){e.operators=[{name:"contains",types:["string","str"]},{name:"does not contain",types:["string","str"]},{name:"is",types:["string","str","number","int","float"]},{name:"is not",types:["string","str","number","int","float"]},{name:"begins with",types:["string","str"]},{name:"does not begin with",types:["string","str"]},{name:"ends with",types:["string","str"]},{name:"does not end with",types:["string","str"]},{name:"is greater than",types:["number","int","float"]},{name:"is less than",types:["number","int","float"]}],e.classes=Object.assign({plusIcon:"fa fa-fw fa-plus",minusIcon:"fa fa-fw fa-minus",filterLineRow:"form-group",filterLineParameter:"col-sm-4",filterLineOperator:"col-sm-3",filterLineValue:"col-sm-5",filterLineInput:"form-control",filterLineLabelRow:"row",filterLineLabelCondition:"col-sm-10",filterLineLabelControls:"col-sm-2 text-right"},e.classes),this.each(function(){s.default.render(i.default.createElement(l.default,{id:"filterer",config:e}),this)})},window.wcomartin_filterer_demo){var p={parameters:[{name:"Title",type:"string",value:"title"},{name:"Year",type:"number",value:"year"}],conditions:[{parameter:"year",operator:"is",value:[2017]}]};p.updateConditions=function(e){console.log(JSON.stringify(e))},c("#root").filterer(p)}},function(e,t){e.exports=function(){for(var e=arguments.length,t=[],n=0;n<e;n++)t[n]=arguments[n];if(t=t.filter(function(e){return null!=e}),0!==t.length)return 1===t.length?t[0]:t.reduce(function(e,t){return function(){e.apply(this,arguments),t.apply(this,arguments)}})}},function(e,t,n){"use strict";function r(e,t){e.classList?e.classList.add(t):(0,i.default)(e,t)||("string"==typeof e.className?e.className=e.className+" "+t:e.setAttribute("class",(e.className&&e.className.baseVal||"")+" "+t))}var o=n(35);t.__esModule=!0,t.default=r;var i=o(n(97));e.exports=t.default},function(e,t){"use strict";function n(e,t){return e.classList?!!t&&e.classList.contains(t):(" "+(e.className.baseVal||e.className)+" ").indexOf(" "+t+" ")!==-1}t.__esModule=!0,t.default=n,e.exports=t.default},function(e,t){"use strict";function n(e,t){return e.replace(new RegExp("(^|\\s)"+t+"(?:\\s|$)","g"),"$1").replace(/\s+/g," ").replace(/^\s*|\s*$/g,"")}e.exports=function(e,t){e.classList?e.classList.remove(t):"string"==typeof e.className?e.className=n(e.className,t):e.setAttribute("class",n(e.className&&e.className.baseVal||"",t))}},function(e,t,n){"use strict";function r(){for(var e,t,n=document.createElement("div").style,r={O:function(e){return"o"+e.toLowerCase()},Moz:function(e){return e.toLowerCase()},Webkit:function(e){return"webkit"+e},ms:function(e){return"MS"+e}},o=Object.keys(r),i="",a=0;a<o.length;a++){var s=o[a];if(s+"TransitionProperty"in n){i="-"+s.toLowerCase(),e=r[s]("TransitionEnd"),t=r[s]("AnimationEnd");break}}return!e&&"transitionProperty"in n&&(e="transitionend"),!t&&"animationName"in n&&(t="animationend"),n=null,{animationEnd:t,transitionEnd:e,prefix:i}}var o=n(35);t.__esModule=!0,t.default=t.animationEnd=t.animationDelay=t.animationTiming=t.animationDuration=t.animationName=t.transitionEnd=t.transitionDuration=t.transitionDelay=t.transitionTiming=t.transitionProperty=t.transform=void 0;var i=o(n(56)),a="transform";t.transform=a;var s,u,l;t.animationEnd=l,t.transitionEnd=u;var c,p,f,d;t.transitionDelay=d,t.transitionTiming=f,t.transitionDuration=p,t.transitionProperty=c;var h,m,v,g;if(t.animationDelay=g,t.animationTiming=v,t.animationDuration=m,t.animationName=h,i.default){var y=r();s=y.prefix,t.transitionEnd=u=y.transitionEnd,t.animationEnd=l=y.animationEnd,t.transform=a=s+"-"+a,t.transitionProperty=c=s+"-transition-property",t.transitionDuration=p=s+"-transition-duration",t.transitionDelay=d=s+"-transition-delay",t.transitionTiming=f=s+"-transition-timing-function",t.animationName=h=s+"-animation-name",t.animationDuration=m=s+"-animation-duration",t.animationTiming=v=s+"-animation-delay",t.animationDelay=g=s+"-animation-timing-function"}var b={transform:a,end:u,property:c,timing:f,delay:d,duration:p};t.default=b},function(e,t,n){"use strict";function r(e){var t=(new Date).getTime(),n=Math.max(0,16-(t-p)),r=setTimeout(e,n);return p=t,r}var o=n(35);t.__esModule=!0,t.default=void 0;var i,a=o(n(56)),s=["","webkit","moz","o","ms"],u="clearTimeout",l=r,c=function(e,t){return e+(e?t[0].toUpperCase()+t.substr(1):t)+"AnimationFrame"};a.default&&s.some(function(e){var t=c(e,"request");if(t in window)return u=c(e,"cancel"),l=function(e){return window[t](e)}});var p=(new Date).getTime();i=function(e){return l(e)},i.cancel=function(e){window[u]&&"function"==typeof window[u]&&window[u](e)};var f=i;t.default=f,e.exports=t.default},function(e,t){"use strict";function n(e){return e.replace(r,function(e,t){return t.toUpperCase()})}var r=/-(.)/g;e.exports=n},function(e,t,n){"use strict";function r(e){return o(e.replace(i,"ms-"))}var o=n(101),i=/^-ms-/;e.exports=r},function(e,t,n){"use strict";function r(e,t){return!(!e||!t)&&(e===t||!o(e)&&(o(t)?r(e,t.parentNode):"contains"in e?e.contains(t):!!e.compareDocumentPosition&&!!(16&e.compareDocumentPosition(t))))}var o=n(111);e.exports=r},function(e,t,n){"use strict";function r(e){var t=e.length;if(Array.isArray(e)||"object"!=typeof e&&"function"!=typeof e?a(!1):void 0,"number"!=typeof t?a(!1):void 0,0===t||t-1 in e?void 0:a(!1),"function"==typeof e.callee?a(!1):void 0,e.hasOwnProperty)try{return Array.prototype.slice.call(e)}catch(e){}for(var n=Array(t),r=0;r<t;r++)n[r]=e[r];return n}function o(e){return!!e&&("object"==typeof e||"function"==typeof e)&&"length"in e&&!("setInterval"in e)&&"number"!=typeof e.nodeType&&(Array.isArray(e)||"callee"in e||"item"in e)}function i(e){return o(e)?Array.isArray(e)?e.slice():r(e):[e]}var a=n(1);e.exports=i},function(e,t,n){"use strict";function r(e){var t=e.match(c);return t&&t[1].toLowerCase()}function o(e,t){var n=l;l?void 0:u(!1);var o=r(e),i=o&&s(o);if(i){n.innerHTML=i[1]+e+i[2];for(var c=i[0];c--;)n=n.lastChild}else n.innerHTML=e;var p=n.getElementsByTagName("script");p.length&&(t?void 0:u(!1),a(p).forEach(t));for(var f=Array.from(n.childNodes);n.lastChild;)n.removeChild(n.lastChild);return f}var i=n(7),a=n(104),s=n(106),u=n(1),l=i.canUseDOM?document.createElement("div"):null,c=/^\s*<(\w+)/;e.exports=o},function(e,t,n){"use strict";function r(e){return a?void 0:i(!1),f.hasOwnProperty(e)||(e="*"),s.hasOwnProperty(e)||("*"===e?a.innerHTML="<link />":a.innerHTML="<"+e+"></"+e+">",s[e]=!a.firstChild),s[e]?f[e]:null}var o=n(7),i=n(1),a=o.canUseDOM?document.createElement("div"):null,s={},u=[1,'<select multiple="true">',"</select>"],l=[1,"<table>","</table>"],c=[3,"<table><tbody><tr>","</tr></tbody></table>"],p=[1,'<svg xmlns="http://www.w3.org/2000/svg">',"</svg>"],f={"*":[1,"?<div>","</div>"],area:[1,"<map>","</map>"],col:[2,"<table><tbody></tbody><colgroup>","</colgroup></table>"],legend:[1,"<fieldset>","</fieldset>"],param:[1,"<object>","</object>"],tr:[2,"<table><tbody>","</tbody></table>"],optgroup:u,option:u,caption:l,colgroup:l,tbody:l,tfoot:l,thead:l,td:c,th:c},d=["circle","clipPath","defs","ellipse","g","image","line","linearGradient","mask","path","pattern","polygon","polyline","radialGradient","rect","stop","text","tspan"];d.forEach(function(e){f[e]=p,s[e]=!0}),e.exports=r},function(e,t){"use strict";function n(e){return e.Window&&e instanceof e.Window?{x:e.pageXOffset||e.document.documentElement.scrollLeft,y:e.pageYOffset||e.document.documentElement.scrollTop}:{x:e.scrollLeft,y:e.scrollTop}}e.exports=n},function(e,t){"use strict";function n(e){return e.replace(r,"-$1").toLowerCase()}var r=/([A-Z])/g;e.exports=n},function(e,t,n){"use strict";function r(e){return o(e).replace(i,"-ms-")}var o=n(108),i=/^ms-/;e.exports=r},function(e,t){"use strict";function n(e){var t=e?e.ownerDocument||e:document,n=t.defaultView||window;return!(!e||!("function"==typeof n.Node?e instanceof n.Node:"object"==typeof e&&"number"==typeof e.nodeType&&"string"==typeof e.nodeName))}e.exports=n},function(e,t,n){"use strict";function r(e){return o(e)&&3==e.nodeType}var o=n(110);e.exports=r},function(e,t){"use strict";function n(e){var t={};return function(n){return t.hasOwnProperty(n)||(t[n]=e.call(this,n)),t[n]}}e.exports=n},function(e,t){function n(e,t){var n,r=function(o){return e.length>1?function(){var i=o?o.concat():[];return n=t?n||this:this,i.push.apply(i,arguments)<e.length&&arguments.length?r.call(n,i):e.apply(n,i)}:e};return r()}var r,o,i,a,s,u,l={}.toString;r=n(function(e,t){return e.apply(null,t)}),o=function(e){return n(e)},i=n(function(e,t,n){return e(n,t)}),a=function(e){return function(t){return function(){return e(t(t)).apply(null,arguments)}}(function(t){return function(){return e(t(t)).apply(null,arguments)}})},s=n(function(e,t,n,r){return e(t(n),t(r))}),u=function(e){var t;return t={},function(){var n,r,o,i,a,s;for(r=[],o=0,i=arguments.length;o<i;++o)r.push(arguments[o]);return n=r,a=function(){var e,t,r,o=[];for(e=0,r=(t=n).length;e<r;++e)s=t[e],o.push(s+l.call(s).slice(8,-1));return o}().join(""),t[a]=a in t?t[a]:e.apply(null,n)}},e.exports={curry:o,flip:i,fix:a,apply:r,over:s,memoize:u}},function(e,t){function n(e,t){var n,r=function(o){return e.length>1?function(){var i=o?o.concat():[];return n=t?n||this:this,i.push.apply(i,arguments)<e.length&&arguments.length?r.call(n,i):e.apply(n,i)}:e};return r()}function r(e,t){for(var n=-1,r=t.length>>>0;++n<r;)if(e===t[n])return!0;return!1}function o(){var e=arguments;return function(){var t,n;for(n=e[0].apply(this,arguments),t=1;t<e.length;++t)n=e[t](n);return n}}function i(e){return!e}var a,s,u,l,c,p,f,d,h,m,v,g,y,b,C,_,w,E,T,x,O,P,k,S,N,M,A,I,D,R,L,U,F,j,B,V,W,H,q,z,K,Y,X,G,Q,$,Z,J,ee,te,ne,re,oe,ie,ae,se,ue,le,ce,pe,fe,de,he,me,ve,ge,ye,be,Ce,_e,we={}.toString;a=n(function(e,t){var n,r,o;for(n=0,r=t.length;n<r;++n)o=t[n],e(o);return t}),s=n(function(e,t){var n,r,o,i=[];for(n=0,r=t.length;n<r;++n)o=t[n],i.push(e(o));return i}),u=function(e){var t,n,r,o=[];for(t=0,n=e.length;t<n;++t)r=e[t],r&&o.push(r);return o},l=n(function(e,t){var n,r,o,i=[];for(n=0,r=t.length;n<r;++n)o=t[n],e(o)&&i.push(o);return i}),c=n(function(e,t){var n,r,o,i=[];for(n=0,r=t.length;n<r;++n)o=t[n],e(o)||i.push(o);return i}),p=n(function(e,t){var n,r;return n=ye(e,t),r=t.slice(),null!=n&&r.splice(n,1),r}),f=n(function(e,t){var n,r,o,i,a;for(n=[],r=[],o=0,i=t.length;o<i;++o)a=t[o],(e(a)?n:r).push(a);return[n,r]}),d=n(function(e,t){var n,r,o;for(n=0,r=t.length;n<r;++n)if(o=t[n],e(o))return o}),h=m=function(e){return e[0]},v=function(e){if(e.length)return e.slice(1)},g=function(e){return e[e.length-1]},y=function(e){if(e.length)return e.slice(0,-1)},b=function(e){return!e.length},C=function(e){return e.concat().reverse()},_=function(e){var t,n,o,i;for(t=[],n=0,o=e.length;n<o;++n)i=e[n],r(i,t)||t.push(i);return t},w=n(function(e,t){var n,o,i,a,s,u=[];for(n=[],o=0,i=t.length;o<i;++o)a=t[o],s=e(a),r(s,n)||(n.push(s),u.push(a));return u}),E=T=n(function(e,t,n){var r,o,i;for(r=0,o=n.length;r<o;++r)i=n[r],t=e(t,i);return t}),x=O=n(function(e,t){return E(e,t[0],t.slice(1))}),P=n(function(e,t,n){var r,o;for(r=n.length-1;r>=0;--r)o=n[r],t=e(o,t);return t}),k=n(function(e,t){return P(e,t[t.length-1],t.slice(0,-1))}),S=n(function(e,t){var n,r,o;for(n=[],r=t;null!=(o=e(r));)n.push(o[0]),r=o[1];return n}),N=function(e){return[].concat.apply([],e)},M=n(function(e,t){var n;return[].concat.apply([],function(){
-var r,o,i,a=[];for(r=0,i=(o=t).length;r<i;++r)n=o[r],a.push(e(n));return a}())}),A=function(e){var t;return[].concat.apply([],function(){var n,r,o,i=[];for(n=0,o=(r=e).length;n<o;++n)t=r[n],"Array"===we.call(t).slice(8,-1)?i.push(A(t)):i.push(t);return i}())},I=function(e){var t,n,o,i,a,s,u,l,c,p;for(n=[],o=1,i=arguments.length;o<i;++o)n.push(arguments[o]);t=n,a=[];e:for(o=0,s=e.length;o<s;++o){for(u=e[o],l=0,c=t.length;l<c;++l)if(p=t[l],r(u,p))continue e;a.push(u)}return a},D=function(e){var t,n,o,i,a,s,u,l,c,p;for(n=[],o=1,i=arguments.length;o<i;++o)n.push(arguments[o]);t=n,a=[];e:for(o=0,s=e.length;o<s;++o){for(u=e[o],l=0,c=t.length;l<c;++l)if(p=t[l],!r(u,p))continue e;a.push(u)}return a},R=function(){var e,t,n,o,i,a,s,u,l,c;for(t=[],n=0,o=arguments.length;n<o;++n)t.push(arguments[n]);for(e=t,i=[],n=0,a=e.length;n<a;++n)for(s=e[n],u=0,l=s.length;u<l;++u)c=s[u],r(c,i)||i.push(c);return i},L=n(function(e,t){var n,r,o,i,a;for(n={},r=0,o=t.length;r<o;++r)i=t[r],a=e(i),a in n?n[a]+=1:n[a]=1;return n}),U=n(function(e,t){var n,r,o,i,a;for(n={},r=0,o=t.length;r<o;++r)i=t[r],a=e(i),a in n?n[a].push(i):n[a]=[i];return n}),F=function(e){var t,n,r;for(t=0,n=e.length;t<n;++t)if(r=e[t],!r)return!1;return!0},j=function(e){var t,n,r;for(t=0,n=e.length;t<n;++t)if(r=e[t])return!0;return!1},B=n(function(e,t){var n,r,o;for(n=0,r=t.length;n<r;++n)if(o=t[n],e(o))return!0;return!1}),V=n(function(e,t){var n,r,o;for(n=0,r=t.length;n<r;++n)if(o=t[n],!e(o))return!1;return!0}),W=function(e){return e.concat().sort(function(e,t){return e>t?1:e<t?-1:0})},H=n(function(e,t){return t.concat().sort(e)}),q=n(function(e,t){return t.concat().sort(function(t,n){return e(t)>e(n)?1:e(t)<e(n)?-1:0})}),z=function(e){var t,n,r,o;for(t=0,n=0,r=e.length;n<r;++n)o=e[n],t+=o;return t},K=function(e){var t,n,r,o;for(t=1,n=0,r=e.length;n<r;++n)o=e[n],t*=o;return t},Y=X=function(e){var t,n,r,o;for(t=0,n=0,r=e.length;n<r;++n)o=e[n],t+=o;return t/e.length},G=function(e){var t,n,r,o,i;for(t=e[0],n=0,o=(r=e.slice(1)).length;n<o;++n)i=r[n],i>t&&(t=i);return t},Q=function(e){var t,n,r,o,i;for(t=e[0],n=0,o=(r=e.slice(1)).length;n<o;++n)i=r[n],i<t&&(t=i);return t},$=n(function(e,t){var n,r,o,i,a;for(n=t[0],r=0,i=(o=t.slice(1)).length;r<i;++r)a=o[r],e(a)>e(n)&&(n=a);return n}),Z=n(function(e,t){var n,r,o,i,a;for(n=t[0],r=0,i=(o=t.slice(1)).length;r<i;++r)a=o[r],e(a)<e(n)&&(n=a);return n}),J=ee=n(function(e,t,n){var r,o;return r=t,[t].concat(function(){var t,i,a,s=[];for(t=0,a=(i=n).length;t<a;++t)o=i[t],s.push(r=e(r,o));return s}())}),te=ne=n(function(e,t){if(t.length)return J(e,t[0],t.slice(1))}),re=n(function(e,t,n){return n=n.concat().reverse(),J(e,t,n).reverse()}),oe=n(function(e,t){if(t.length)return t=t.concat().reverse(),J(e,t[0],t.slice(1)).reverse()}),ie=n(function(e,t,n){return n.slice(e,t)}),ae=n(function(e,t){return e<=0?t.slice(0,0):t.slice(0,e)}),se=n(function(e,t){return e<=0?t:t.slice(e)}),ue=n(function(e,t){return[ae(e,t),se(e,t)]}),le=n(function(e,t){var n,r;if(n=t.length,!n)return t;for(r=0;r<n&&e(t[r]);)r+=1;return t.slice(0,r)}),ce=n(function(e,t){var n,r;if(n=t.length,!n)return t;for(r=0;r<n&&e(t[r]);)r+=1;return t.slice(r)}),pe=n(function(e,t){return[le(e,t),ce(e,t)]}),fe=n(function(e,t){return pe(o(e,i),t)}),de=n(function(e,t){var n,r,o,i,a,s;for(n=[],r=t.length,o=0,i=e.length;o<i&&(a=o,s=e[o],a!==r);++o)n.push([s,t[a]]);return n}),he=n(function(e,t,n){var r,o,i,a,s,u;for(r=[],o=n.length,i=0,a=t.length;i<a&&(s=i,u=t[i],s!==o);++i)r.push(e(u,n[s]));return r}),me=function(){var e,t,n,r,o,i,a,s,u,l,c,p=[];for(t=[],n=0,r=arguments.length;n<r;++n)t.push(arguments[n]);for(e=t,o=void 0,n=0,i=e.length;n<i;++n)a=e[n],o<=(s=a.length)||(o=s);for(n=0;n<o;++n){for(u=n,l=[],c=0,i=e.length;c<i;++c)a=e[c],l.push(a[u]);p.push(l)}return p},ve=function(e){function t(){var e,t,r,o=[];for(e=0,r=(t=n).length;e<r;++e)u=t[e],o.push(u[c]);return o}var n,r,o,i,a,s,u,l,c,p=[];for(r=[],o=1,i=arguments.length;o<i;++o)r.push(arguments[o]);for(n=r,a=void 0,o=0,s=n.length;o<s;++o)u=n[o],a<=(l=u.length)||(a=l);for(o=0;o<a;++o)c=o,p.push(e.apply(null,t()));return p},ge=n(function(e,t){return e<0?t[t.length+e]:t[e]}),ye=n(function(e,t){var n,r,o,i;for(n=0,r=t.length;n<r;++n)if(o=n,i=t[n],i===e)return o}),be=n(function(e,t){var n,r,o,i,a=[];for(n=0,r=t.length;n<r;++n)o=n,i=t[n],i===e&&a.push(o);return a}),Ce=n(function(e,t){var n,r,o,i;for(n=0,r=t.length;n<r;++n)if(o=n,i=t[n],e(i))return o}),_e=n(function(e,t){var n,r,o,i,a=[];for(n=0,r=t.length;n<r;++n)o=n,i=t[n],e(i)&&a.push(o);return a}),e.exports={each:a,map:s,filter:l,compact:u,reject:c,remove:p,partition:f,find:d,head:h,first:m,tail:v,last:g,initial:y,empty:b,reverse:C,difference:I,intersection:D,union:R,countBy:L,groupBy:U,fold:E,fold1:x,foldl:T,foldl1:O,foldr:P,foldr1:k,unfoldr:S,andList:F,orList:j,any:B,all:V,unique:_,uniqueBy:w,sort:W,sortWith:H,sortBy:q,sum:z,product:K,mean:Y,average:X,concat:N,concatMap:M,flatten:A,maximum:G,minimum:Q,maximumBy:$,minimumBy:Z,scan:J,scan1:te,scanl:ee,scanl1:ne,scanr:re,scanr1:oe,slice:ie,take:ae,drop:se,splitAt:ue,takeWhile:le,dropWhile:ce,span:pe,breakList:fe,zip:de,zipWith:he,zipAll:me,zipAllWith:ve,at:ge,elemIndex:ye,elemIndices:be,findIndex:Ce,findIndices:_e}},function(e,t){function n(e,t){var n,r=function(o){return e.length>1?function(){var i=o?o.concat():[];return n=t?n||this:this,i.push.apply(i,arguments)<e.length&&arguments.length?r.call(n,i):e.apply(n,i)}:e};return r()}var r,o,i,a,s,u,l,c,p,f,d,h,m,v,g,y,b,C,_,w,E,T,x,O,P,k,S,N,M,A,I,D;r=n(function(e,t){return e>t?e:t}),o=n(function(e,t){return e<t?e:t}),i=function(e){return-e},a=Math.abs,s=function(e){return e<0?-1:e>0?1:0},u=n(function(e,t){return~~(e/t)}),l=n(function(e,t){return e%t}),c=n(function(e,t){return Math.floor(e/t)}),p=n(function(e,t){var n;return(e%(n=t)+n)%n}),f=function(e){return 1/e},d=Math.PI,h=2*d,m=Math.exp,v=Math.sqrt,g=Math.log,y=n(function(e,t){return Math.pow(e,t)}),b=Math.sin,C=Math.tan,_=Math.cos,w=Math.asin,E=Math.acos,T=Math.atan,x=n(function(e,t){return Math.atan2(e,t)}),O=function(e){return~~e},P=Math.round,k=Math.ceil,S=Math.floor,N=function(e){return e!==e},M=function(e){return e%2===0},A=function(e){return e%2!==0},I=n(function(e,t){var n;for(e=Math.abs(e),t=Math.abs(t);0!==t;)n=e%t,e=t,t=n;return e}),D=n(function(e,t){return Math.abs(Math.floor(e/I(e,t)*t))}),e.exports={max:r,min:o,negate:i,abs:a,signum:s,quot:u,rem:l,div:c,mod:p,recip:f,pi:d,tau:h,exp:m,sqrt:v,ln:g,pow:y,sin:b,tan:C,cos:_,acos:E,asin:w,atan:T,atan2:x,truncate:O,round:P,ceiling:k,floor:S,isItNaN:N,even:M,odd:A,gcd:I,lcm:D}},function(e,t){function n(e,t){var n,r=function(o){return e.length>1?function(){var i=o?o.concat():[];return n=t?n||this:this,i.push.apply(i,arguments)<e.length&&arguments.length?r.call(n,i):e.apply(n,i)}:e};return r()}var r,o,i,a,s,u,l,c,p,f,d,h,m,v;r=function(e){var t,n,r=[];for(t in e)n=e[t],r.push(n);return r},o=function(e){var t,n=[];for(t in e)n.push(t);return n},i=function(e){var t,n,r,o={};for(t=0,n=e.length;t<n;++t)r=e[t],o[r[0]]=r[1];return o},a=function(e){var t,n,r=[];for(t in e)n=e[t],r.push([t,n]);return r},s=n(function(e,t){var n,r,o,i,a={};for(n=0,r=e.length;n<r;++n)o=n,i=e[n],a[i]=t[o];return a}),u=function(e){var t,n,r,o;t=[],n=[];for(r in e)o=e[r],t.push(r),n.push(o);return[t,n]},l=function(e){var t;for(t in e)return!1;return!0},c=n(function(e,t){var n,r;for(n in t)r=t[n],e(r);return t}),p=n(function(e,t){var n,r,o={};for(n in t)r=t[n],o[n]=e(r);return o}),f=function(e){var t,n,r={};for(t in e)n=e[t],n&&(r[t]=n);return r},d=n(function(e,t){var n,r,o={};for(n in t)r=t[n],e(r)&&(o[n]=r);return o}),h=n(function(e,t){var n,r,o={};for(n in t)r=t[n],e(r)||(o[n]=r);return o}),m=n(function(e,t){var n,r,o,i;n={},r={};for(o in t)i=t[o],(e(i)?n:r)[o]=i;return[n,r]}),v=n(function(e,t){var n,r;for(n in t)if(r=t[n],e(r))return r}),e.exports={values:r,keys:o,pairsToObj:i,objToPairs:a,listsToObj:s,objToLists:u,empty:l,each:c,map:p,filter:d,compact:f,reject:h,partition:m,find:v}},function(e,t){function n(e,t){var n,r=function(o){return e.length>1?function(){var i=o?o.concat():[];return n=t?n||this:this,i.push.apply(i,arguments)<e.length&&arguments.length?r.call(n,i):e.apply(n,i)}:e};return r()}var r,o,i,a,s,u,l,c,p,f,d,h,m;r=n(function(e,t){return t.split(e)}),o=n(function(e,t){return t.join(e)}),i=function(e){return e.length?e.split("\n"):[]},a=function(e){return e.join("\n")},s=function(e){return e.length?e.split(/[ ]+/):[]},u=function(e){return e.join(" ")},l=function(e){return e.split("")},c=function(e){return e.join("")},p=function(e){return e.split("").reverse().join("")},f=n(function(e,t){var n,r;for(n="",r=0;r<e;++r)n+=t;return n}),d=function(e){return e.charAt(0).toUpperCase()+e.slice(1)},h=function(e){return e.replace(/[-_]+(.)?/g,function(e,t){return(null!=t?t:"").toUpperCase()})},m=function(e){return e.replace(/([^-A-Z])([A-Z]+)/g,function(e,t,n){return t+"-"+(n.length>1?n:n.toLowerCase())}).replace(/^([A-Z]+)/,function(e,t){return t.length>1?t+"-":t.toLowerCase()})},e.exports={split:r,join:o,lines:i,unlines:a,words:s,unwords:u,chars:l,unchars:c,reverse:p,repeat:f,capitalize:d,camelize:h,dasherize:m}},[227,113,114,116,117,115],function(e,t,n){"use strict";function r(e){var t=new o(o._61);return t._81=1,t._65=e,t}var o=n(61);e.exports=o;var i=r(!0),a=r(!1),s=r(null),u=r(void 0),l=r(0),c=r("");o.resolve=function(e){if(e instanceof o)return e;if(null===e)return s;if(void 0===e)return u;if(e===!0)return i;if(e===!1)return a;if(0===e)return l;if(""===e)return c;if("object"==typeof e||"function"==typeof e)try{var t=e.then;if("function"==typeof t)return new o(t.bind(e))}catch(e){return new o(function(t,n){n(e)})}return r(e)},o.all=function(e){var t=Array.prototype.slice.call(e);return new o(function(e,n){function r(a,s){if(s&&("object"==typeof s||"function"==typeof s)){if(s instanceof o&&s.then===o.prototype.then){for(;3===s._81;)s=s._65;return 1===s._81?r(a,s._65):(2===s._81&&n(s._65),void s.then(function(e){r(a,e)},n))}var u=s.then;if("function"==typeof u){var l=new o(u.bind(s));return void l.then(function(e){r(a,e)},n)}}t[a]=s,0===--i&&e(t)}if(0===t.length)return e([]);for(var i=t.length,a=0;a<t.length;a++)r(a,t[a])})},o.reject=function(e){return new o(function(t,n){n(e)})},o.race=function(e){return new o(function(t,n){e.forEach(function(e){o.resolve(e).then(t,n)})})},o.prototype.catch=function(e){return this.then(null,e)}},function(e,t,n){"use strict";function r(){l=!1,s._10=null,s._97=null}function o(e){function t(t){(e.allRejections||a(p[t].error,e.whitelist||u))&&(p[t].displayId=c++,e.onUnhandled?(p[t].logged=!0,e.onUnhandled(p[t].displayId,p[t].error)):(p[t].logged=!0,i(p[t].displayId,p[t].error)))}function n(t){p[t].logged&&(e.onHandled?e.onHandled(p[t].displayId,p[t].error):p[t].onUnhandled||(console.warn("Promise Rejection Handled (id: "+p[t].displayId+"):"),console.warn('  This means you can ignore any previous messages of the form "Possible Unhandled Promise Rejection" with id '+p[t].displayId+".")))}e=e||{},l&&r(),l=!0;var o=0,c=0,p={};s._10=function(e){2===e._81&&p[e._72]&&(p[e._72].logged?n(e._72):clearTimeout(p[e._72].timeout),delete p[e._72])},s._97=function(e,n){0===e._45&&(e._72=o++,p[e._72]={displayId:null,error:n,timeout:setTimeout(t.bind(null,e._72),a(n,u)?100:2e3),logged:!1})}}function i(e,t){console.warn("Possible Unhandled Promise Rejection (id: "+e+"):");var n=(t&&(t.stack||t))+"";n.split("\n").forEach(function(e){console.warn("  "+e)})}function a(e,t){return t.some(function(t){return e instanceof t})}var s=n(61),u=[ReferenceError,TypeError,RangeError],l=!1;t.disable=r,t.enable=o},function(e,t,n){"use strict";function r(e,t,n,r,o){}e.exports=r},function(e,t,n){"use strict";var r=n(8),o=n(1),i=(n(2),n(123)),a=n(121);e.exports=function(e,t){function n(e){var t=e&&(x&&e[x]||e[O]);if("function"==typeof t)return t}function s(e,t){return e===t?0!==e||1/e===1/t:e!==e&&t!==t}function u(e){this.message=e,this.stack=""}function l(e){function n(n,r,a,s,l,c,p){if(s=s||P,c=c||a,p!==i)if(t)o(!1,"Calling PropTypes validators directly is not supported by the `prop-types` package. Use `PropTypes.checkPropTypes()` to call them. Read more at http://fb.me/use-check-prop-types");else;return null==r[a]?n?new u(null===r[a]?"The "+l+" `"+c+"` is marked as required "+("in `"+s+"`, but its value is `null`."):"The "+l+" `"+c+"` is marked as required in "+("`"+s+"`, but its value is `undefined`.")):null:e(r,a,s,l,c)}var r=n.bind(null,!1);return r.isRequired=n.bind(null,!0),r}function c(e){function t(t,n,r,o,i,a){var s=t[n],l=w(s);if(l!==e){var c=E(s);return new u("Invalid "+o+" `"+i+"` of type "+("`"+c+"` supplied to `"+r+"`, expected ")+("`"+e+"`."))}return null}return l(t)}function p(){return l(r.thatReturnsNull)}function f(e){function t(t,n,r,o,a){if("function"!=typeof e)return new u("Property `"+a+"` of component `"+r+"` has invalid PropType notation inside arrayOf.");var s=t[n];if(!Array.isArray(s)){var l=w(s);return new u("Invalid "+o+" `"+a+"` of type "+("`"+l+"` supplied to `"+r+"`, expected an array."))}for(var c=0;c<s.length;c++){var p=e(s,c,r,o,a+"["+c+"]",i);if(p instanceof Error)return p}return null}return l(t)}function d(){function t(t,n,r,o,i){var a=t[n];if(!e(a)){var s=w(a);return new u("Invalid "+o+" `"+i+"` of type "+("`"+s+"` supplied to `"+r+"`, expected a single ReactElement."))}return null}return l(t)}function h(e){function t(t,n,r,o,i){if(!(t[n]instanceof e)){var a=e.name||P,s=T(t[n]);return new u("Invalid "+o+" `"+i+"` of type "+("`"+s+"` supplied to `"+r+"`, expected ")+("instance of `"+a+"`."))}return null}return l(t)}function m(e){function t(t,n,r,o,i){for(var a=t[n],l=0;l<e.length;l++)if(s(a,e[l]))return null;var c=JSON.stringify(e);return new u("Invalid "+o+" `"+i+"` of value `"+a+"` "+("supplied to `"+r+"`, expected one of "+c+"."))}return Array.isArray(e)?l(t):r.thatReturnsNull}function v(e){function t(t,n,r,o,a){if("function"!=typeof e)return new u("Property `"+a+"` of component `"+r+"` has invalid PropType notation inside objectOf.");var s=t[n],l=w(s);if("object"!==l)return new u("Invalid "+o+" `"+a+"` of type "+("`"+l+"` supplied to `"+r+"`, expected an object."));for(var c in s)if(s.hasOwnProperty(c)){var p=e(s,c,r,o,a+"."+c,i);if(p instanceof Error)return p}return null}return l(t)}function g(e){function t(t,n,r,o,a){for(var s=0;s<e.length;s++){var l=e[s];if(null==l(t,n,r,o,a,i))return null}return new u("Invalid "+o+" `"+a+"` supplied to "+("`"+r+"`."))}return Array.isArray(e)?l(t):r.thatReturnsNull}function y(){function e(e,t,n,r,o){return C(e[t])?null:new u("Invalid "+r+" `"+o+"` supplied to "+("`"+n+"`, expected a ReactNode."))}return l(e)}function b(e){function t(t,n,r,o,a){var s=t[n],l=w(s);if("object"!==l)return new u("Invalid "+o+" `"+a+"` of type `"+l+"` "+("supplied to `"+r+"`, expected `object`."));for(var c in e){var p=e[c];if(p){var f=p(s,c,r,o,a+"."+c,i);if(f)return f}}return null}return l(t)}function C(t){switch(typeof t){case"number":case"string":case"undefined":return!0;case"boolean":return!t;case"object":if(Array.isArray(t))return t.every(C);if(null===t||e(t))return!0;var r=n(t);if(!r)return!1;var o,i=r.call(t);if(r!==t.entries){for(;!(o=i.next()).done;)if(!C(o.value))return!1}else for(;!(o=i.next()).done;){var a=o.value;if(a&&!C(a[1]))return!1}return!0;default:return!1}}function _(e,t){return"symbol"===e||("Symbol"===t["@@toStringTag"]||"function"==typeof Symbol&&t instanceof Symbol)}function w(e){var t=typeof e;return Array.isArray(e)?"array":e instanceof RegExp?"object":_(t,e)?"symbol":t}function E(e){var t=w(e);if("object"===t){if(e instanceof Date)return"date";if(e instanceof RegExp)return"regexp"}return t}function T(e){return e.constructor&&e.constructor.name?e.constructor.name:P}var x="function"==typeof Symbol&&Symbol.iterator,O="@@iterator",P="<<anonymous>>",k={array:c("array"),bool:c("boolean"),func:c("function"),number:c("number"),object:c("object"),string:c("string"),symbol:c("symbol"),any:p(),arrayOf:f,element:d(),instanceOf:h,node:y(),objectOf:v,oneOf:m,oneOfType:g,shape:b};return u.prototype=Error.prototype,k.checkPropTypes=a,k.PropTypes=k,k}},function(e,t){"use strict";var n="SECRET_DO_NOT_PASS_THIS_OR_YOU_WILL_BE_FIRED";e.exports=n},function(e,t){"use strict";function n(e,t){return e===t?0!==e||0!==t||1/e===1/t:e!==e&&t!==t}function r(e,t){if(n(e,t))return!0;if("object"!=typeof e||null===e||"object"!=typeof t||null===t)return!1;var r=Object.keys(e),o=Object.keys(t);if(r.length!==o.length)return!1;for(var a=0;a<r.length;a++)if(!i.call(t,r[a])||!n(e[r[a]],t[r[a]]))return!1;return!0}function o(e,t,n){return!r(e.props,t)||!r(e.state,n)}var i=Object.prototype.hasOwnProperty;e.exports=o},function(e,t){"use strict";var n={Properties:{"aria-current":0,"aria-details":0,"aria-disabled":0,"aria-hidden":0,"aria-invalid":0,"aria-keyshortcuts":0,"aria-label":0,"aria-roledescription":0,"aria-autocomplete":0,"aria-checked":0,"aria-expanded":0,"aria-haspopup":0,"aria-level":0,"aria-modal":0,"aria-multiline":0,"aria-multiselectable":0,"aria-orientation":0,"aria-placeholder":0,"aria-pressed":0,"aria-readonly":0,"aria-required":0,"aria-selected":0,"aria-sort":0,"aria-valuemax":0,"aria-valuemin":0,"aria-valuenow":0,"aria-valuetext":0,"aria-atomic":0,"aria-busy":0,"aria-live":0,"aria-relevant":0,"aria-dropeffect":0,"aria-grabbed":0,"aria-activedescendant":0,"aria-colcount":0,"aria-colindex":0,"aria-colspan":0,"aria-controls":0,"aria-describedby":0,"aria-errormessage":0,"aria-flowto":0,"aria-labelledby":0,"aria-owns":0,"aria-posinset":0,"aria-rowcount":0,"aria-rowindex":0,"aria-rowspan":0,"aria-setsize":0},DOMAttributeNames:{},DOMPropertyNames:{}};e.exports=n},function(e,t,n){"use strict";var r=n(6),o=n(58),i={focusDOMComponent:function(){o(r.getNodeFromInstance(this))}};e.exports=i},function(e,t,n){"use strict";function r(){var e=window.opera;return"object"==typeof e&&"function"==typeof e.version&&parseInt(e.version(),10)<=12}function o(e){return(e.ctrlKey||e.altKey||e.metaKey)&&!(e.ctrlKey&&e.altKey)}function i(e){switch(e){case"topCompositionStart":return O.compositionStart;case"topCompositionEnd":return O.compositionEnd;case"topCompositionUpdate":return O.compositionUpdate}}function a(e,t){return"topKeyDown"===e&&t.keyCode===b}function s(e,t){switch(e){case"topKeyUp":return y.indexOf(t.keyCode)!==-1;case"topKeyDown":return t.keyCode!==b;case"topKeyPress":case"topMouseDown":case"topBlur":return!0;default:return!1}}function u(e){var t=e.detail;return"object"==typeof t&&"data"in t?t.data:null}function l(e,t,n,r){var o,l;if(C?o=i(e):k?s(e,n)&&(o=O.compositionEnd):a(e,n)&&(o=O.compositionStart),!o)return null;E&&(k||o!==O.compositionStart?o===O.compositionEnd&&k&&(l=k.getData()):k=m.getPooled(r));var c=v.getPooled(o,t,n,r);if(l)c.data=l;else{var p=u(n);null!==p&&(c.data=p)}return d.accumulateTwoPhaseDispatches(c),c}function c(e,t){switch(e){case"topCompositionEnd":return u(t);case"topKeyPress":var n=t.which;return n!==T?null:(P=!0,x);case"topTextInput":var r=t.data;return r===x&&P?null:r;default:return null}}function p(e,t){if(k){if("topCompositionEnd"===e||!C&&s(e,t)){var n=k.getData();return m.release(k),k=null,n}return null}switch(e){case"topPaste":return null;case"topKeyPress":return t.which&&!o(t)?String.fromCharCode(t.which):null;case"topCompositionEnd":return E?null:t.data;default:return null}}function f(e,t,n,r){var o;if(o=w?c(e,n):p(e,n),!o)return null;var i=g.getPooled(O.beforeInput,t,n,r);return i.data=o,d.accumulateTwoPhaseDispatches(i),i}var d=n(25),h=n(7),m=n(133),v=n(170),g=n(173),y=[9,13,27,32],b=229,C=h.canUseDOM&&"CompositionEvent"in window,_=null;h.canUseDOM&&"documentMode"in document&&(_=document.documentMode);var w=h.canUseDOM&&"TextEvent"in window&&!_&&!r(),E=h.canUseDOM&&(!C||_&&_>8&&_<=11),T=32,x=String.fromCharCode(T),O={beforeInput:{phasedRegistrationNames:{bubbled:"onBeforeInput",captured:"onBeforeInputCapture"},dependencies:["topCompositionEnd","topKeyPress","topTextInput","topPaste"]},compositionEnd:{phasedRegistrationNames:{bubbled:"onCompositionEnd",captured:"onCompositionEndCapture"},dependencies:["topBlur","topCompositionEnd","topKeyDown","topKeyPress","topKeyUp","topMouseDown"]},compositionStart:{phasedRegistrationNames:{bubbled:"onCompositionStart",captured:"onCompositionStartCapture"},dependencies:["topBlur","topCompositionStart","topKeyDown","topKeyPress","topKeyUp","topMouseDown"]},compositionUpdate:{phasedRegistrationNames:{bubbled:"onCompositionUpdate",captured:"onCompositionUpdateCapture"},dependencies:["topBlur","topCompositionUpdate","topKeyDown","topKeyPress","topKeyUp","topMouseDown"]}},P=!1,k=null,S={eventTypes:O,extractEvents:function(e,t,n,r){return[l(e,t,n,r),f(e,t,n,r)]}};e.exports=S},function(e,t,n){"use strict";var r=n(64),o=n(7),i=(n(9),n(102),n(179)),a=n(109),s=n(112),u=(n(2),s(function(e){return a(e)})),l=!1,c="cssFloat";if(o.canUseDOM){var p=document.createElement("div").style;try{p.font=""}catch(e){l=!0}void 0===document.documentElement.style.cssFloat&&(c="styleFloat")}var f={createMarkupForStyles:function(e,t){var n="";for(var r in e)if(e.hasOwnProperty(r)){var o=e[r];null!=o&&(n+=u(r)+":",n+=i(r,o,t)+";")}return n||null},setValueForStyles:function(e,t,n){var o=e.style;for(var a in t)if(t.hasOwnProperty(a)){var s=i(a,t[a],n);if("float"!==a&&"cssFloat"!==a||(a=c),s)o[a]=s;else{var u=l&&r.shorthandPropertyExpansions[a];if(u)for(var p in u)o[p]="";else o[a]=""}}}};e.exports=f},function(e,t,n){"use strict";function r(e){var t=e.nodeName&&e.nodeName.toLowerCase();return"select"===t||"input"===t&&"file"===e.type}function o(e){var t=T.getPooled(k.change,N,e,x(e));C.accumulateTwoPhaseDispatches(t),E.batchedUpdates(i,t)}function i(e){b.enqueueEvents(e),b.processEventQueue(!1)}function a(e,t){S=e,N=t,S.attachEvent("onchange",o)}function s(){S&&(S.detachEvent("onchange",o),S=null,N=null)}function u(e,t){if("topChange"===e)return t}function l(e,t,n){"topFocus"===e?(s(),a(t,n)):"topBlur"===e&&s()}function c(e,t){S=e,N=t,M=e.value,A=Object.getOwnPropertyDescriptor(e.constructor.prototype,"value"),Object.defineProperty(S,"value",R),S.attachEvent?S.attachEvent("onpropertychange",f):S.addEventListener("propertychange",f,!1)}function p(){S&&(delete S.value,S.detachEvent?S.detachEvent("onpropertychange",f):S.removeEventListener("propertychange",f,!1),S=null,N=null,M=null,A=null)}function f(e){if("value"===e.propertyName){var t=e.srcElement.value;t!==M&&(M=t,o(e))}}function d(e,t){if("topInput"===e)return t}function h(e,t,n){"topFocus"===e?(p(),c(t,n)):"topBlur"===e&&p()}function m(e,t){if(("topSelectionChange"===e||"topKeyUp"===e||"topKeyDown"===e)&&S&&S.value!==M)return M=S.value,N}function v(e){return e.nodeName&&"input"===e.nodeName.toLowerCase()&&("checkbox"===e.type||"radio"===e.type)}function g(e,t){if("topClick"===e)return t}function y(e,t){if(null!=e){var n=e._wrapperState||t._wrapperState;if(n&&n.controlled&&"number"===t.type){var r=""+t.value;t.getAttribute("value")!==r&&t.setAttribute("value",r)}}}var b=n(24),C=n(25),_=n(7),w=n(6),E=n(10),T=n(11),x=n(49),O=n(50),P=n(81),k={change:{phasedRegistrationNames:{bubbled:"onChange",captured:"onChangeCapture"},dependencies:["topBlur","topChange","topClick","topFocus","topInput","topKeyDown","topKeyUp","topSelectionChange"]}},S=null,N=null,M=null,A=null,I=!1;_.canUseDOM&&(I=O("change")&&(!document.documentMode||document.documentMode>8));var D=!1;_.canUseDOM&&(D=O("input")&&(!document.documentMode||document.documentMode>11));var R={get:function(){return A.get.call(this)},set:function(e){M=""+e,A.set.call(this,e)}},L={eventTypes:k,extractEvents:function(e,t,n,o){var i,a,s=t?w.getNodeFromInstance(t):window;if(r(s)?I?i=u:a=l:P(s)?D?i=d:(i=m,a=h):v(s)&&(i=g),i){var c=i(e,t);if(c){var p=T.getPooled(k.change,c,n,o);return p.type="change",C.accumulateTwoPhaseDispatches(p),p}}a&&a(e,s,t),"topBlur"===e&&y(t,s)}};e.exports=L},function(e,t,n){"use strict";var r=n(3),o=n(17),i=n(7),a=n(105),s=n(8),u=(n(1),{dangerouslyReplaceNodeWithMarkup:function(e,t){if(i.canUseDOM?void 0:r("56"),t?void 0:r("57"),"HTML"===e.nodeName?r("58"):void 0,"string"==typeof t){var n=a(t,s)[0];e.parentNode.replaceChild(n,e)}else o.replaceChildWithTree(e,t)}});e.exports=u},function(e,t){"use strict";var n=["ResponderEventPlugin","SimpleEventPlugin","TapEventPlugin","EnterLeaveEventPlugin","ChangeEventPlugin","SelectEventPlugin","BeforeInputEventPlugin"];e.exports=n},function(e,t,n){"use strict";var r=n(25),o=n(6),i=n(30),a={mouseEnter:{registrationName:"onMouseEnter",dependencies:["topMouseOut","topMouseOver"]},mouseLeave:{registrationName:"onMouseLeave",dependencies:["topMouseOut","topMouseOver"]}},s={eventTypes:a,extractEvents:function(e,t,n,s){if("topMouseOver"===e&&(n.relatedTarget||n.fromElement))return null;if("topMouseOut"!==e&&"topMouseOver"!==e)return null;var u;if(s.window===s)u=s;else{var l=s.ownerDocument;u=l?l.defaultView||l.parentWindow:window}var c,p;if("topMouseOut"===e){c=t;var f=n.relatedTarget||n.toElement;p=f?o.getClosestInstanceFromNode(f):null}else c=null,p=t;if(c===p)return null;var d=null==c?u:o.getNodeFromInstance(c),h=null==p?u:o.getNodeFromInstance(p),m=i.getPooled(a.mouseLeave,c,n,s);m.type="mouseleave",m.target=d,m.relatedTarget=h;var v=i.getPooled(a.mouseEnter,p,n,s);return v.type="mouseenter",v.target=h,v.relatedTarget=d,r.accumulateEnterLeaveDispatches(m,v,c,p),[m,v]}};e.exports=s},function(e,t,n){"use strict";function r(e){this._root=e,this._startText=this.getText(),this._fallbackText=null}var o=n(4),i=n(14),a=n(79);o(r.prototype,{destructor:function(){this._root=null,this._startText=null,this._fallbackText=null},getText:function(){return"value"in this._root?this._root.value:this._root[a()]},getData:function(){if(this._fallbackText)return this._fallbackText;var e,t,n=this._startText,r=n.length,o=this.getText(),i=o.length;for(e=0;e<r&&n[e]===o[e];e++);var a=r-e;for(t=1;t<=a&&n[r-t]===o[i-t];t++);var s=t>1?1-t:void 0;return this._fallbackText=o.slice(e,s),this._fallbackText}}),i.addPoolingTo(r),e.exports=r},function(e,t,n){"use strict";var r=n(18),o=r.injection.MUST_USE_PROPERTY,i=r.injection.HAS_BOOLEAN_VALUE,a=r.injection.HAS_NUMERIC_VALUE,s=r.injection.HAS_POSITIVE_NUMERIC_VALUE,u=r.injection.HAS_OVERLOADED_BOOLEAN_VALUE,l={isCustomAttribute:RegExp.prototype.test.bind(new RegExp("^(data|aria)-["+r.ATTRIBUTE_NAME_CHAR+"]*$")),Properties:{accept:0,acceptCharset:0,accessKey:0,action:0,allowFullScreen:i,allowTransparency:0,alt:0,as:0,async:i,autoComplete:0,autoPlay:i,capture:i,cellPadding:0,cellSpacing:0,charSet:0,challenge:0,checked:o|i,cite:0,classID:0,className:0,cols:s,colSpan:0,content:0,contentEditable:0,contextMenu:0,controls:i,coords:0,crossOrigin:0,data:0,dateTime:0,default:i,defer:i,dir:0,disabled:i,download:u,draggable:0,encType:0,form:0,formAction:0,formEncType:0,formMethod:0,formNoValidate:i,formTarget:0,frameBorder:0,headers:0,height:0,hidden:i,high:0,href:0,hrefLang:0,htmlFor:0,httpEquiv:0,icon:0,id:0,inputMode:0,integrity:0,is:0,keyParams:0,keyType:0,kind:0,label:0,lang:0,list:0,loop:i,low:0,manifest:0,marginHeight:0,marginWidth:0,max:0,maxLength:0,media:0,mediaGroup:0,method:0,min:0,minLength:0,multiple:o|i,muted:o|i,name:0,nonce:0,noValidate:i,open:i,optimum:0,pattern:0,placeholder:0,playsInline:i,poster:0,preload:0,profile:0,radioGroup:0,readOnly:i,referrerPolicy:0,rel:0,required:i,reversed:i,role:0,rows:s,rowSpan:a,sandbox:0,scope:0,scoped:i,scrolling:0,seamless:i,selected:o|i,shape:0,size:s,sizes:0,span:s,spellCheck:0,src:0,srcDoc:0,srcLang:0,srcSet:0,start:a,step:0,style:0,summary:0,tabIndex:0,target:0,title:0,type:0,useMap:0,value:0,width:0,wmode:0,wrap:0,about:0,datatype:0,inlist:0,prefix:0,property:0,resource:0,typeof:0,vocab:0,autoCapitalize:0,autoCorrect:0,autoSave:0,color:0,itemProp:0,itemScope:i,itemType:0,itemID:0,itemRef:0,results:0,security:0,unselectable:0},DOMAttributeNames:{acceptCharset:"accept-charset",className:"class",htmlFor:"for",httpEquiv:"http-equiv"},DOMPropertyNames:{},DOMMutationMethods:{value:function(e,t){return null==t?e.removeAttribute("value"):void("number"!==e.type||e.hasAttribute("value")===!1?e.setAttribute("value",""+t):e.validity&&!e.validity.badInput&&e.ownerDocument.activeElement!==e&&e.setAttribute("value",""+t))}}};e.exports=l},function(e,t,n){(function(t){"use strict";function r(e,t,n,r){var o=void 0===e[n];null!=t&&o&&(e[n]=i(t,!0))}var o=n(19),i=n(80),a=(n(41),n(51)),s=n(83),u=(n(2),{instantiateChildren:function(e,t,n,o){if(null==e)return null;var i={};return s(e,r,i),i},updateChildren:function(e,t,n,r,s,u,l,c,p){if(t||e){var f,d;for(f in t)if(t.hasOwnProperty(f)){d=e&&e[f];var h=d&&d._currentElement,m=t[f];if(null!=d&&a(h,m))o.receiveComponent(d,m,s,c),t[f]=d;else{d&&(r[f]=o.getHostNode(d),o.unmountComponent(d,!1));var v=i(m,!0);t[f]=v;var g=o.mountComponent(v,s,u,l,c,p);n.push(g)}}for(f in e)!e.hasOwnProperty(f)||t&&t.hasOwnProperty(f)||(d=e[f],r[f]=o.getHostNode(d),o.unmountComponent(d,!1))}},unmountChildren:function(e,t){for(var n in e)if(e.hasOwnProperty(n)){var r=e[n];o.unmountComponent(r,t)}}});e.exports=u}).call(t,n(60))},function(e,t,n){"use strict";var r=n(37),o=n(143),i={processChildrenUpdates:o.dangerouslyProcessChildrenUpdates,replaceNodeWithMarkup:r.dangerouslyReplaceNodeWithMarkup};e.exports=i},function(e,t,n){"use strict";function r(e){}function o(e,t){}function i(e){return!(!e.prototype||!e.prototype.isReactComponent)}function a(e){return!(!e.prototype||!e.prototype.isPureReactComponent)}var s=n(3),u=n(4),l=n(20),c=n(43),p=n(12),f=n(44),d=n(26),h=(n(9),n(74)),m=n(19),v=n(23),g=(n(1),n(36)),y=n(51),b=(n(2),{ImpureClass:0,PureClass:1,StatelessFunctional:2});r.prototype.render=function(){var e=d.get(this)._currentElement.type,t=e(this.props,this.context,this.updater);return o(e,t),t};var C=1,_={construct:function(e){this._currentElement=e,this._rootNodeID=0,this._compositeType=null,this._instance=null,this._hostParent=null,this._hostContainerInfo=null,this._updateBatchNumber=null,this._pendingElement=null,this._pendingStateQueue=null,this._pendingReplaceState=!1,this._pendingForceUpdate=!1,this._renderedNodeType=null,this._renderedComponent=null,this._context=null,this._mountOrder=0,this._topLevelWrapper=null,this._pendingCallbacks=null,this._calledComponentWillUnmount=!1},mountComponent:function(e,t,n,u){this._context=u,this._mountOrder=C++,this._hostParent=t,this._hostContainerInfo=n;var c,p=this._currentElement.props,f=this._processContext(u),h=this._currentElement.type,m=e.getUpdateQueue(),g=i(h),y=this._constructComponent(g,p,f,m);g||null!=y&&null!=y.render?a(h)?this._compositeType=b.PureClass:this._compositeType=b.ImpureClass:(c=y,o(h,c),null===y||y===!1||l.isValidElement(y)?void 0:s("105",h.displayName||h.name||"Component"),y=new r(h),this._compositeType=b.StatelessFunctional);y.props=p,y.context=f,y.refs=v,y.updater=m,this._instance=y,d.set(y,this);var _=y.state;void 0===_&&(y.state=_=null),"object"!=typeof _||Array.isArray(_)?s("106",this.getName()||"ReactCompositeComponent"):void 0,this._pendingStateQueue=null,this._pendingReplaceState=!1,this._pendingForceUpdate=!1;var w;return w=y.unstable_handleError?this.performInitialMountWithErrorHandling(c,t,n,e,u):this.performInitialMount(c,t,n,e,u),y.componentDidMount&&e.getReactMountReady().enqueue(y.componentDidMount,y),w},_constructComponent:function(e,t,n,r){return this._constructComponentWithoutOwner(e,t,n,r)},_constructComponentWithoutOwner:function(e,t,n,r){var o=this._currentElement.type;return e?new o(t,n,r):o(t,n,r)},performInitialMountWithErrorHandling:function(e,t,n,r,o){var i,a=r.checkpoint();try{i=this.performInitialMount(e,t,n,r,o)}catch(s){r.rollback(a),this._instance.unstable_handleError(s),this._pendingStateQueue&&(this._instance.state=this._processPendingState(this._instance.props,this._instance.context)),a=r.checkpoint(),this._renderedComponent.unmountComponent(!0),r.rollback(a),i=this.performInitialMount(e,t,n,r,o)}return i},performInitialMount:function(e,t,n,r,o){var i=this._instance,a=0;i.componentWillMount&&(i.componentWillMount(),this._pendingStateQueue&&(i.state=this._processPendingState(i.props,i.context))),void 0===e&&(e=this._renderValidatedComponent());var s=h.getType(e);this._renderedNodeType=s;
-var u=this._instantiateReactComponent(e,s!==h.EMPTY);this._renderedComponent=u;var l=m.mountComponent(u,r,t,n,this._processChildContext(o),a);return l},getHostNode:function(){return m.getHostNode(this._renderedComponent)},unmountComponent:function(e){if(this._renderedComponent){var t=this._instance;if(t.componentWillUnmount&&!t._calledComponentWillUnmount)if(t._calledComponentWillUnmount=!0,e){var n=this.getName()+".componentWillUnmount()";f.invokeGuardedCallback(n,t.componentWillUnmount.bind(t))}else t.componentWillUnmount();this._renderedComponent&&(m.unmountComponent(this._renderedComponent,e),this._renderedNodeType=null,this._renderedComponent=null,this._instance=null),this._pendingStateQueue=null,this._pendingReplaceState=!1,this._pendingForceUpdate=!1,this._pendingCallbacks=null,this._pendingElement=null,this._context=null,this._rootNodeID=0,this._topLevelWrapper=null,d.remove(t)}},_maskContext:function(e){var t=this._currentElement.type,n=t.contextTypes;if(!n)return v;var r={};for(var o in n)r[o]=e[o];return r},_processContext:function(e){var t=this._maskContext(e);return t},_processChildContext:function(e){var t,n=this._currentElement.type,r=this._instance;if(r.getChildContext&&(t=r.getChildContext()),t){"object"!=typeof n.childContextTypes?s("107",this.getName()||"ReactCompositeComponent"):void 0;for(var o in t)o in n.childContextTypes?void 0:s("108",this.getName()||"ReactCompositeComponent",o);return u({},e,t)}return e},_checkContextTypes:function(e,t,n){},receiveComponent:function(e,t,n){var r=this._currentElement,o=this._context;this._pendingElement=null,this.updateComponent(t,r,e,o,n)},performUpdateIfNecessary:function(e){null!=this._pendingElement?m.receiveComponent(this,this._pendingElement,e,this._context):null!==this._pendingStateQueue||this._pendingForceUpdate?this.updateComponent(e,this._currentElement,this._currentElement,this._context,this._context):this._updateBatchNumber=null},updateComponent:function(e,t,n,r,o){var i=this._instance;null==i?s("136",this.getName()||"ReactCompositeComponent"):void 0;var a,u=!1;this._context===o?a=i.context:(a=this._processContext(o),u=!0);var l=t.props,c=n.props;t!==n&&(u=!0),u&&i.componentWillReceiveProps&&i.componentWillReceiveProps(c,a);var p=this._processPendingState(c,a),f=!0;this._pendingForceUpdate||(i.shouldComponentUpdate?f=i.shouldComponentUpdate(c,p,a):this._compositeType===b.PureClass&&(f=!g(l,c)||!g(i.state,p))),this._updateBatchNumber=null,f?(this._pendingForceUpdate=!1,this._performComponentUpdate(n,c,p,a,e,o)):(this._currentElement=n,this._context=o,i.props=c,i.state=p,i.context=a)},_processPendingState:function(e,t){var n=this._instance,r=this._pendingStateQueue,o=this._pendingReplaceState;if(this._pendingReplaceState=!1,this._pendingStateQueue=null,!r)return n.state;if(o&&1===r.length)return r[0];for(var i=u({},o?r[0]:n.state),a=o?1:0;a<r.length;a++){var s=r[a];u(i,"function"==typeof s?s.call(n,i,e,t):s)}return i},_performComponentUpdate:function(e,t,n,r,o,i){var a,s,u,l=this._instance,c=Boolean(l.componentDidUpdate);c&&(a=l.props,s=l.state,u=l.context),l.componentWillUpdate&&l.componentWillUpdate(t,n,r),this._currentElement=e,this._context=i,l.props=t,l.state=n,l.context=r,this._updateRenderedComponent(o,i),c&&o.getReactMountReady().enqueue(l.componentDidUpdate.bind(l,a,s,u),l)},_updateRenderedComponent:function(e,t){var n=this._renderedComponent,r=n._currentElement,o=this._renderValidatedComponent(),i=0;if(y(r,o))m.receiveComponent(n,o,e,this._processChildContext(t));else{var a=m.getHostNode(n);m.unmountComponent(n,!1);var s=h.getType(o);this._renderedNodeType=s;var u=this._instantiateReactComponent(o,s!==h.EMPTY);this._renderedComponent=u;var l=m.mountComponent(u,e,this._hostParent,this._hostContainerInfo,this._processChildContext(t),i);this._replaceNodeWithMarkup(a,l,n)}},_replaceNodeWithMarkup:function(e,t,n){c.replaceNodeWithMarkup(e,t,n)},_renderValidatedComponentWithoutOwnerOrContext:function(){var e,t=this._instance;return e=t.render()},_renderValidatedComponent:function(){var e;if(this._compositeType!==b.StatelessFunctional){p.current=this;try{e=this._renderValidatedComponentWithoutOwnerOrContext()}finally{p.current=null}}else e=this._renderValidatedComponentWithoutOwnerOrContext();return null===e||e===!1||l.isValidElement(e)?void 0:s("109",this.getName()||"ReactCompositeComponent"),e},attachRef:function(e,t){var n=this.getPublicInstance();null==n?s("110"):void 0;var r=t.getPublicInstance(),o=n.refs===v?n.refs={}:n.refs;o[e]=r},detachRef:function(e){var t=this.getPublicInstance().refs;delete t[e]},getName:function(){var e=this._currentElement.type,t=this._instance&&this._instance.constructor;return e.displayName||t&&t.displayName||e.name||t&&t.name||null},getPublicInstance:function(){var e=this._instance;return this._compositeType===b.StatelessFunctional?null:e},_instantiateReactComponent:null};e.exports=_},function(e,t,n){"use strict";var r=n(6),o=n(151),i=n(73),a=n(19),s=n(10),u=n(164),l=n(180),c=n(78),p=n(187);n(2);o.inject();var f={findDOMNode:l,render:i.render,unmountComponentAtNode:i.unmountComponentAtNode,version:u,unstable_batchedUpdates:s.batchedUpdates,unstable_renderSubtreeIntoContainer:p};"undefined"!=typeof __REACT_DEVTOOLS_GLOBAL_HOOK__&&"function"==typeof __REACT_DEVTOOLS_GLOBAL_HOOK__.inject&&__REACT_DEVTOOLS_GLOBAL_HOOK__.inject({ComponentTree:{getClosestInstanceFromNode:r.getClosestInstanceFromNode,getNodeFromInstance:function(e){return e._renderedComponent&&(e=c(e)),e?r.getNodeFromInstance(e):null}},Mount:i,Reconciler:a});e.exports=f},function(e,t,n){"use strict";function r(e){if(e){var t=e._currentElement._owner||null;if(t){var n=t.getName();if(n)return" This DOM node was rendered by `"+n+"`."}}return""}function o(e,t){t&&(X[e._tag]&&(null!=t.children||null!=t.dangerouslySetInnerHTML?m("137",e._tag,e._currentElement._owner?" Check the render method of "+e._currentElement._owner.getName()+".":""):void 0),null!=t.dangerouslySetInnerHTML&&(null!=t.children?m("60"):void 0,"object"==typeof t.dangerouslySetInnerHTML&&W in t.dangerouslySetInnerHTML?void 0:m("61")),null!=t.style&&"object"!=typeof t.style?m("62",r(e)):void 0)}function i(e,t,n,r){if(!(r instanceof I)){var o=e._hostContainerInfo,i=o._node&&o._node.nodeType===q,s=i?o._node:o._ownerDocument;F(t,s),r.getReactMountReady().enqueue(a,{inst:e,registrationName:t,listener:n})}}function a(){var e=this;E.putListener(e.inst,e.registrationName,e.listener)}function s(){var e=this;k.postMountWrapper(e)}function u(){var e=this;M.postMountWrapper(e)}function l(){var e=this;S.postMountWrapper(e)}function c(){var e=this;e._rootNodeID?void 0:m("63");var t=U(e);switch(t?void 0:m("64"),e._tag){case"iframe":case"object":e._wrapperState.listeners=[x.trapBubbledEvent("topLoad","load",t)];break;case"video":case"audio":e._wrapperState.listeners=[];for(var n in z)z.hasOwnProperty(n)&&e._wrapperState.listeners.push(x.trapBubbledEvent(n,z[n],t));break;case"source":e._wrapperState.listeners=[x.trapBubbledEvent("topError","error",t)];break;case"img":e._wrapperState.listeners=[x.trapBubbledEvent("topError","error",t),x.trapBubbledEvent("topLoad","load",t)];break;case"form":e._wrapperState.listeners=[x.trapBubbledEvent("topReset","reset",t),x.trapBubbledEvent("topSubmit","submit",t)];break;case"input":case"select":case"textarea":e._wrapperState.listeners=[x.trapBubbledEvent("topInvalid","invalid",t)]}}function p(){N.postUpdateWrapper(this)}function f(e){$.call(Q,e)||(G.test(e)?void 0:m("65",e),Q[e]=!0)}function d(e,t){return e.indexOf("-")>=0||null!=t.is}function h(e){var t=e.type;f(t),this._currentElement=e,this._tag=t.toLowerCase(),this._namespaceURI=null,this._renderedChildren=null,this._previousStyle=null,this._previousStyleCopy=null,this._hostNode=null,this._hostParent=null,this._rootNodeID=0,this._domID=0,this._hostContainerInfo=null,this._wrapperState=null,this._topLevelWrapper=null,this._flags=0}var m=n(3),v=n(4),g=n(126),y=n(128),b=n(17),C=n(38),_=n(18),w=n(66),E=n(24),T=n(39),x=n(29),O=n(67),P=n(6),k=n(144),S=n(145),N=n(68),M=n(148),A=(n(9),n(157)),I=n(162),D=(n(8),n(32)),R=(n(1),n(50),n(36),n(52),n(2),O),L=E.deleteListener,U=P.getNodeFromInstance,F=x.listenTo,j=T.registrationNameModules,B={string:!0,number:!0},V="style",W="__html",H={children:null,dangerouslySetInnerHTML:null,suppressContentEditableWarning:null},q=11,z={topAbort:"abort",topCanPlay:"canplay",topCanPlayThrough:"canplaythrough",topDurationChange:"durationchange",topEmptied:"emptied",topEncrypted:"encrypted",topEnded:"ended",topError:"error",topLoadedData:"loadeddata",topLoadedMetadata:"loadedmetadata",topLoadStart:"loadstart",topPause:"pause",topPlay:"play",topPlaying:"playing",topProgress:"progress",topRateChange:"ratechange",topSeeked:"seeked",topSeeking:"seeking",topStalled:"stalled",topSuspend:"suspend",topTimeUpdate:"timeupdate",topVolumeChange:"volumechange",topWaiting:"waiting"},K={area:!0,base:!0,br:!0,col:!0,embed:!0,hr:!0,img:!0,input:!0,keygen:!0,link:!0,meta:!0,param:!0,source:!0,track:!0,wbr:!0},Y={listing:!0,pre:!0,textarea:!0},X=v({menuitem:!0},K),G=/^[a-zA-Z][a-zA-Z:_\.\-\d]*$/,Q={},$={}.hasOwnProperty,Z=1;h.displayName="ReactDOMComponent",h.Mixin={mountComponent:function(e,t,n,r){this._rootNodeID=Z++,this._domID=n._idCounter++,this._hostParent=t,this._hostContainerInfo=n;var i=this._currentElement.props;switch(this._tag){case"audio":case"form":case"iframe":case"img":case"link":case"object":case"source":case"video":this._wrapperState={listeners:null},e.getReactMountReady().enqueue(c,this);break;case"input":k.mountWrapper(this,i,t),i=k.getHostProps(this,i),e.getReactMountReady().enqueue(c,this);break;case"option":S.mountWrapper(this,i,t),i=S.getHostProps(this,i);break;case"select":N.mountWrapper(this,i,t),i=N.getHostProps(this,i),e.getReactMountReady().enqueue(c,this);break;case"textarea":M.mountWrapper(this,i,t),i=M.getHostProps(this,i),e.getReactMountReady().enqueue(c,this)}o(this,i);var a,p;null!=t?(a=t._namespaceURI,p=t._tag):n._tag&&(a=n._namespaceURI,p=n._tag),(null==a||a===C.svg&&"foreignobject"===p)&&(a=C.html),a===C.html&&("svg"===this._tag?a=C.svg:"math"===this._tag&&(a=C.mathml)),this._namespaceURI=a;var f;if(e.useCreateElement){var d,h=n._ownerDocument;if(a===C.html)if("script"===this._tag){var m=h.createElement("div"),v=this._currentElement.type;m.innerHTML="<"+v+"></"+v+">",d=m.removeChild(m.firstChild)}else d=i.is?h.createElement(this._currentElement.type,i.is):h.createElement(this._currentElement.type);else d=h.createElementNS(a,this._currentElement.type);P.precacheNode(this,d),this._flags|=R.hasCachedChildNodes,this._hostParent||w.setAttributeForRoot(d),this._updateDOMProperties(null,i,e);var y=b(d);this._createInitialChildren(e,i,r,y),f=y}else{var _=this._createOpenTagMarkupAndPutListeners(e,i),E=this._createContentMarkup(e,i,r);f=!E&&K[this._tag]?_+"/>":_+">"+E+"</"+this._currentElement.type+">"}switch(this._tag){case"input":e.getReactMountReady().enqueue(s,this),i.autoFocus&&e.getReactMountReady().enqueue(g.focusDOMComponent,this);break;case"textarea":e.getReactMountReady().enqueue(u,this),i.autoFocus&&e.getReactMountReady().enqueue(g.focusDOMComponent,this);break;case"select":i.autoFocus&&e.getReactMountReady().enqueue(g.focusDOMComponent,this);break;case"button":i.autoFocus&&e.getReactMountReady().enqueue(g.focusDOMComponent,this);break;case"option":e.getReactMountReady().enqueue(l,this)}return f},_createOpenTagMarkupAndPutListeners:function(e,t){var n="<"+this._currentElement.type;for(var r in t)if(t.hasOwnProperty(r)){var o=t[r];if(null!=o)if(j.hasOwnProperty(r))o&&i(this,r,o,e);else{r===V&&(o&&(o=this._previousStyleCopy=v({},t.style)),o=y.createMarkupForStyles(o,this));var a=null;null!=this._tag&&d(this._tag,t)?H.hasOwnProperty(r)||(a=w.createMarkupForCustomAttribute(r,o)):a=w.createMarkupForProperty(r,o),a&&(n+=" "+a)}}return e.renderToStaticMarkup?n:(this._hostParent||(n+=" "+w.createMarkupForRoot()),n+=" "+w.createMarkupForID(this._domID))},_createContentMarkup:function(e,t,n){var r="",o=t.dangerouslySetInnerHTML;if(null!=o)null!=o.__html&&(r=o.__html);else{var i=B[typeof t.children]?t.children:null,a=null!=i?null:t.children;if(null!=i)r=D(i);else if(null!=a){var s=this.mountChildren(a,e,n);r=s.join("")}}return Y[this._tag]&&"\n"===r.charAt(0)?"\n"+r:r},_createInitialChildren:function(e,t,n,r){var o=t.dangerouslySetInnerHTML;if(null!=o)null!=o.__html&&b.queueHTML(r,o.__html);else{var i=B[typeof t.children]?t.children:null,a=null!=i?null:t.children;if(null!=i)""!==i&&b.queueText(r,i);else if(null!=a)for(var s=this.mountChildren(a,e,n),u=0;u<s.length;u++)b.queueChild(r,s[u])}},receiveComponent:function(e,t,n){var r=this._currentElement;this._currentElement=e,this.updateComponent(t,r,e,n)},updateComponent:function(e,t,n,r){var i=t.props,a=this._currentElement.props;switch(this._tag){case"input":i=k.getHostProps(this,i),a=k.getHostProps(this,a);break;case"option":i=S.getHostProps(this,i),a=S.getHostProps(this,a);break;case"select":i=N.getHostProps(this,i),a=N.getHostProps(this,a);break;case"textarea":i=M.getHostProps(this,i),a=M.getHostProps(this,a)}switch(o(this,a),this._updateDOMProperties(i,a,e),this._updateDOMChildren(i,a,e,r),this._tag){case"input":k.updateWrapper(this);break;case"textarea":M.updateWrapper(this);break;case"select":e.getReactMountReady().enqueue(p,this)}},_updateDOMProperties:function(e,t,n){var r,o,a;for(r in e)if(!t.hasOwnProperty(r)&&e.hasOwnProperty(r)&&null!=e[r])if(r===V){var s=this._previousStyleCopy;for(o in s)s.hasOwnProperty(o)&&(a=a||{},a[o]="");this._previousStyleCopy=null}else j.hasOwnProperty(r)?e[r]&&L(this,r):d(this._tag,e)?H.hasOwnProperty(r)||w.deleteValueForAttribute(U(this),r):(_.properties[r]||_.isCustomAttribute(r))&&w.deleteValueForProperty(U(this),r);for(r in t){var u=t[r],l=r===V?this._previousStyleCopy:null!=e?e[r]:void 0;if(t.hasOwnProperty(r)&&u!==l&&(null!=u||null!=l))if(r===V)if(u?u=this._previousStyleCopy=v({},u):this._previousStyleCopy=null,l){for(o in l)!l.hasOwnProperty(o)||u&&u.hasOwnProperty(o)||(a=a||{},a[o]="");for(o in u)u.hasOwnProperty(o)&&l[o]!==u[o]&&(a=a||{},a[o]=u[o])}else a=u;else if(j.hasOwnProperty(r))u?i(this,r,u,n):l&&L(this,r);else if(d(this._tag,t))H.hasOwnProperty(r)||w.setValueForAttribute(U(this),r,u);else if(_.properties[r]||_.isCustomAttribute(r)){var c=U(this);null!=u?w.setValueForProperty(c,r,u):w.deleteValueForProperty(c,r)}}a&&y.setValueForStyles(U(this),a,this)},_updateDOMChildren:function(e,t,n,r){var o=B[typeof e.children]?e.children:null,i=B[typeof t.children]?t.children:null,a=e.dangerouslySetInnerHTML&&e.dangerouslySetInnerHTML.__html,s=t.dangerouslySetInnerHTML&&t.dangerouslySetInnerHTML.__html,u=null!=o?null:e.children,l=null!=i?null:t.children,c=null!=o||null!=a,p=null!=i||null!=s;null!=u&&null==l?this.updateChildren(null,n,r):c&&!p&&this.updateTextContent(""),null!=i?o!==i&&this.updateTextContent(""+i):null!=s?a!==s&&this.updateMarkup(""+s):null!=l&&this.updateChildren(l,n,r)},getHostNode:function(){return U(this)},unmountComponent:function(e){switch(this._tag){case"audio":case"form":case"iframe":case"img":case"link":case"object":case"source":case"video":var t=this._wrapperState.listeners;if(t)for(var n=0;n<t.length;n++)t[n].remove();break;case"html":case"head":case"body":m("66",this._tag)}this.unmountChildren(e),P.uncacheNode(this),E.deleteAllListeners(this),this._rootNodeID=0,this._domID=0,this._wrapperState=null},getPublicInstance:function(){return U(this)}},v(h.prototype,h.Mixin,A.Mixin),e.exports=h},function(e,t,n){"use strict";function r(e,t){var n={_topLevelWrapper:e,_idCounter:1,_ownerDocument:t?t.nodeType===o?t:t.ownerDocument:null,_node:t,_tag:t?t.nodeName.toLowerCase():null,_namespaceURI:t?t.namespaceURI:null};return n}var o=(n(52),9);e.exports=r},function(e,t,n){"use strict";var r=n(4),o=n(17),i=n(6),a=function(e){this._currentElement=null,this._hostNode=null,this._hostParent=null,this._hostContainerInfo=null,this._domID=0};r(a.prototype,{mountComponent:function(e,t,n,r){var a=n._idCounter++;this._domID=a,this._hostParent=t,this._hostContainerInfo=n;var s=" react-empty: "+this._domID+" ";if(e.useCreateElement){var u=n._ownerDocument,l=u.createComment(s);return i.precacheNode(this,l),o(l)}return e.renderToStaticMarkup?"":"<!--"+s+"-->"},receiveComponent:function(){},getHostNode:function(){return i.getNodeFromInstance(this)},unmountComponent:function(){i.uncacheNode(this)}}),e.exports=a},function(e,t){"use strict";var n={useCreateElement:!0,useFiber:!1};e.exports=n},function(e,t,n){"use strict";var r=n(37),o=n(6),i={dangerouslyProcessChildrenUpdates:function(e,t){var n=o.getNodeFromInstance(e);r.processUpdates(n,t)}};e.exports=i},function(e,t,n){"use strict";function r(){this._rootNodeID&&f.updateWrapper(this)}function o(e){var t="checkbox"===e.type||"radio"===e.type;return t?null!=e.checked:null!=e.value}function i(e){var t=this._currentElement.props,n=l.executeOnChange(t,e);p.asap(r,this);var o=t.name;if("radio"===t.type&&null!=o){for(var i=c.getNodeFromInstance(this),s=i;s.parentNode;)s=s.parentNode;for(var u=s.querySelectorAll("input[name="+JSON.stringify(""+o)+'][type="radio"]'),f=0;f<u.length;f++){var d=u[f];if(d!==i&&d.form===i.form){var h=c.getInstanceFromNode(d);h?void 0:a("90"),p.asap(r,h)}}}return n}var a=n(3),s=n(4),u=n(66),l=n(42),c=n(6),p=n(10),f=(n(1),n(2),{getHostProps:function(e,t){var n=l.getValue(t),r=l.getChecked(t),o=s({type:void 0,step:void 0,min:void 0,max:void 0},t,{defaultChecked:void 0,defaultValue:void 0,value:null!=n?n:e._wrapperState.initialValue,checked:null!=r?r:e._wrapperState.initialChecked,onChange:e._wrapperState.onChange});return o},mountWrapper:function(e,t){var n=t.defaultValue;e._wrapperState={initialChecked:null!=t.checked?t.checked:t.defaultChecked,initialValue:null!=t.value?t.value:n,listeners:null,onChange:i.bind(e),controlled:o(t)}},updateWrapper:function(e){var t=e._currentElement.props,n=t.checked;null!=n&&u.setValueForProperty(c.getNodeFromInstance(e),"checked",n||!1);var r=c.getNodeFromInstance(e),o=l.getValue(t);if(null!=o)if(0===o&&""===r.value)r.value="0";else if("number"===t.type){var i=parseFloat(r.value,10)||0;o!=i&&(r.value=""+o)}else o!=r.value&&(r.value=""+o);else null==t.value&&null!=t.defaultValue&&r.defaultValue!==""+t.defaultValue&&(r.defaultValue=""+t.defaultValue),null==t.checked&&null!=t.defaultChecked&&(r.defaultChecked=!!t.defaultChecked)},postMountWrapper:function(e){var t=e._currentElement.props,n=c.getNodeFromInstance(e);switch(t.type){case"submit":case"reset":break;case"color":case"date":case"datetime":case"datetime-local":case"month":case"time":case"week":n.value="",n.value=n.defaultValue;break;default:n.value=n.value}var r=n.name;""!==r&&(n.name=""),n.defaultChecked=!n.defaultChecked,n.defaultChecked=!n.defaultChecked,""!==r&&(n.name=r)}});e.exports=f},function(e,t,n){"use strict";function r(e){var t="";return i.Children.forEach(e,function(e){null!=e&&("string"==typeof e||"number"==typeof e?t+=e:u||(u=!0))}),t}var o=n(4),i=n(20),a=n(6),s=n(68),u=(n(2),!1),l={mountWrapper:function(e,t,n){var o=null;if(null!=n){var i=n;"optgroup"===i._tag&&(i=i._hostParent),null!=i&&"select"===i._tag&&(o=s.getSelectValueContext(i))}var a=null;if(null!=o){var u;if(u=null!=t.value?t.value+"":r(t.children),a=!1,Array.isArray(o)){for(var l=0;l<o.length;l++)if(""+o[l]===u){a=!0;break}}else a=""+o===u}e._wrapperState={selected:a}},postMountWrapper:function(e){var t=e._currentElement.props;if(null!=t.value){var n=a.getNodeFromInstance(e);n.setAttribute("value",t.value)}},getHostProps:function(e,t){var n=o({selected:void 0,children:void 0},t);null!=e._wrapperState.selected&&(n.selected=e._wrapperState.selected);var i=r(t.children);return i&&(n.children=i),n}};e.exports=l},function(e,t,n){"use strict";function r(e,t,n,r){return e===n&&t===r}function o(e){var t=document.selection,n=t.createRange(),r=n.text.length,o=n.duplicate();o.moveToElementText(e),o.setEndPoint("EndToStart",n);var i=o.text.length,a=i+r;return{start:i,end:a}}function i(e){var t=window.getSelection&&window.getSelection();if(!t||0===t.rangeCount)return null;var n=t.anchorNode,o=t.anchorOffset,i=t.focusNode,a=t.focusOffset,s=t.getRangeAt(0);try{s.startContainer.nodeType,s.endContainer.nodeType}catch(e){return null}var u=r(t.anchorNode,t.anchorOffset,t.focusNode,t.focusOffset),l=u?0:s.toString().length,c=s.cloneRange();c.selectNodeContents(e),c.setEnd(s.startContainer,s.startOffset);var p=r(c.startContainer,c.startOffset,c.endContainer,c.endOffset),f=p?0:c.toString().length,d=f+l,h=document.createRange();h.setStart(n,o),h.setEnd(i,a);var m=h.collapsed;return{start:m?d:f,end:m?f:d}}function a(e,t){var n,r,o=document.selection.createRange().duplicate();void 0===t.end?(n=t.start,r=n):t.start>t.end?(n=t.end,r=t.start):(n=t.start,r=t.end),o.moveToElementText(e),o.moveStart("character",n),o.setEndPoint("EndToStart",o),o.moveEnd("character",r-n),o.select()}function s(e,t){if(window.getSelection){var n=window.getSelection(),r=e[c()].length,o=Math.min(t.start,r),i=void 0===t.end?o:Math.min(t.end,r);if(!n.extend&&o>i){var a=i;i=o,o=a}var s=l(e,o),u=l(e,i);if(s&&u){var p=document.createRange();p.setStart(s.node,s.offset),n.removeAllRanges(),o>i?(n.addRange(p),n.extend(u.node,u.offset)):(p.setEnd(u.node,u.offset),n.addRange(p))}}}var u=n(7),l=n(184),c=n(79),p=u.canUseDOM&&"selection"in document&&!("getSelection"in window),f={getOffsets:p?o:i,setOffsets:p?a:s};e.exports=f},function(e,t,n){"use strict";var r=n(3),o=n(4),i=n(37),a=n(17),s=n(6),u=n(32),l=(n(1),n(52),function(e){this._currentElement=e,this._stringText=""+e,this._hostNode=null,this._hostParent=null,this._domID=0,this._mountIndex=0,this._closingComment=null,this._commentNodes=null});o(l.prototype,{mountComponent:function(e,t,n,r){var o=n._idCounter++,i=" react-text: "+o+" ",l=" /react-text ";if(this._domID=o,this._hostParent=t,e.useCreateElement){var c=n._ownerDocument,p=c.createComment(i),f=c.createComment(l),d=a(c.createDocumentFragment());return a.queueChild(d,a(p)),this._stringText&&a.queueChild(d,a(c.createTextNode(this._stringText))),a.queueChild(d,a(f)),s.precacheNode(this,p),this._closingComment=f,d}var h=u(this._stringText);return e.renderToStaticMarkup?h:"<!--"+i+"-->"+h+"<!--"+l+"-->"},receiveComponent:function(e,t){if(e!==this._currentElement){this._currentElement=e;var n=""+e;if(n!==this._stringText){this._stringText=n;var r=this.getHostNode();i.replaceDelimitedText(r[0],r[1],n)}}},getHostNode:function(){var e=this._commentNodes;if(e)return e;if(!this._closingComment)for(var t=s.getNodeFromInstance(this),n=t.nextSibling;;){if(null==n?r("67",this._domID):void 0,8===n.nodeType&&" /react-text "===n.nodeValue){this._closingComment=n;break}n=n.nextSibling}return e=[this._hostNode,this._closingComment],this._commentNodes=e,e},unmountComponent:function(){this._closingComment=null,this._commentNodes=null,s.uncacheNode(this)}}),e.exports=l},function(e,t,n){"use strict";function r(){this._rootNodeID&&c.updateWrapper(this)}function o(e){var t=this._currentElement.props,n=s.executeOnChange(t,e);return l.asap(r,this),n}var i=n(3),a=n(4),s=n(42),u=n(6),l=n(10),c=(n(1),n(2),{getHostProps:function(e,t){null!=t.dangerouslySetInnerHTML?i("91"):void 0;var n=a({},t,{value:void 0,defaultValue:void 0,children:""+e._wrapperState.initialValue,onChange:e._wrapperState.onChange});return n},mountWrapper:function(e,t){var n=s.getValue(t),r=n;if(null==n){var a=t.defaultValue,u=t.children;null!=u&&(null!=a?i("92"):void 0,Array.isArray(u)&&(u.length<=1?void 0:i("93"),u=u[0]),a=""+u),null==a&&(a=""),r=a}e._wrapperState={initialValue:""+r,listeners:null,onChange:o.bind(e)}},updateWrapper:function(e){var t=e._currentElement.props,n=u.getNodeFromInstance(e),r=s.getValue(t);if(null!=r){var o=""+r;o!==n.value&&(n.value=o),null==t.defaultValue&&(n.defaultValue=o)}null!=t.defaultValue&&(n.defaultValue=t.defaultValue)},postMountWrapper:function(e){var t=u.getNodeFromInstance(e),n=t.textContent;n===e._wrapperState.initialValue&&(t.value=n)}});e.exports=c},function(e,t,n){"use strict";function r(e,t){"_hostNode"in e?void 0:u("33"),"_hostNode"in t?void 0:u("33");for(var n=0,r=e;r;r=r._hostParent)n++;for(var o=0,i=t;i;i=i._hostParent)o++;for(;n-o>0;)e=e._hostParent,n--;for(;o-n>0;)t=t._hostParent,o--;for(var a=n;a--;){if(e===t)return e;e=e._hostParent,t=t._hostParent}return null}function o(e,t){"_hostNode"in e?void 0:u("35"),"_hostNode"in t?void 0:u("35");for(;t;){if(t===e)return!0;t=t._hostParent}return!1}function i(e){return"_hostNode"in e?void 0:u("36"),e._hostParent}function a(e,t,n){for(var r=[];e;)r.push(e),e=e._hostParent;var o;for(o=r.length;o-- >0;)t(r[o],"captured",n);for(o=0;o<r.length;o++)t(r[o],"bubbled",n)}function s(e,t,n,o,i){for(var a=e&&t?r(e,t):null,s=[];e&&e!==a;)s.push(e),e=e._hostParent;for(var u=[];t&&t!==a;)u.push(t),t=t._hostParent;var l;for(l=0;l<s.length;l++)n(s[l],"bubbled",o);for(l=u.length;l-- >0;)n(u[l],"captured",i)}var u=n(3);n(1);e.exports={isAncestor:o,getLowestCommonAncestor:r,getParentInstance:i,traverseTwoPhase:a,traverseEnterLeave:s}},function(e,t,n){"use strict";function r(){this.reinitializeTransaction()}var o=n(4),i=n(10),a=n(31),s=n(8),u={initialize:s,close:function(){f.isBatchingUpdates=!1}},l={initialize:s,close:i.flushBatchedUpdates.bind(i)},c=[l,u];o(r.prototype,a,{getTransactionWrappers:function(){return c}});var p=new r,f={isBatchingUpdates:!1,batchedUpdates:function(e,t,n,r,o,i){var a=f.isBatchingUpdates;return f.isBatchingUpdates=!0,a?e(t,n,r,o,i):p.perform(e,null,t,n,r,o,i)}};e.exports=f},function(e,t,n){"use strict";function r(){E||(E=!0,y.EventEmitter.injectReactEventListener(g),y.EventPluginHub.injectEventPluginOrder(s),y.EventPluginUtils.injectComponentTree(f),y.EventPluginUtils.injectTreeTraversal(h),y.EventPluginHub.injectEventPluginsByName({SimpleEventPlugin:w,EnterLeaveEventPlugin:u,ChangeEventPlugin:a,SelectEventPlugin:_,BeforeInputEventPlugin:i}),y.HostComponent.injectGenericComponentClass(p),y.HostComponent.injectTextComponentClass(m),y.DOMProperty.injectDOMPropertyConfig(o),y.DOMProperty.injectDOMPropertyConfig(l),y.DOMProperty.injectDOMPropertyConfig(C),y.EmptyComponent.injectEmptyComponentFactory(function(e){return new d(e)}),y.Updates.injectReconcileTransaction(b),y.Updates.injectBatchingStrategy(v),y.Component.injectEnvironment(c))}var o=n(125),i=n(127),a=n(129),s=n(131),u=n(132),l=n(134),c=n(136),p=n(139),f=n(6),d=n(141),h=n(149),m=n(147),v=n(150),g=n(154),y=n(155),b=n(160),C=n(165),_=n(166),w=n(167),E=!1;e.exports={inject:r}},88,function(e,t,n){"use strict";function r(e){o.enqueueEvents(e),o.processEventQueue(!1)}var o=n(24),i={handleTopLevel:function(e,t,n,i){var a=o.extractEvents(e,t,n,i);r(a)}};e.exports=i},function(e,t,n){"use strict";function r(e){for(;e._hostParent;)e=e._hostParent;var t=p.getNodeFromInstance(e),n=t.parentNode;return p.getClosestInstanceFromNode(n)}function o(e,t){this.topLevelType=e,this.nativeEvent=t,this.ancestors=[]}function i(e){var t=d(e.nativeEvent),n=p.getClosestInstanceFromNode(t),o=n;do e.ancestors.push(o),o=o&&r(o);while(o);for(var i=0;i<e.ancestors.length;i++)n=e.ancestors[i],m._handleTopLevel(e.topLevelType,n,e.nativeEvent,d(e.nativeEvent))}function a(e){var t=h(window);e(t)}var s=n(4),u=n(57),l=n(7),c=n(14),p=n(6),f=n(10),d=n(49),h=n(107);s(o.prototype,{destructor:function(){this.topLevelType=null,this.nativeEvent=null,this.ancestors.length=0}}),c.addPoolingTo(o,c.twoArgumentPooler);var m={_enabled:!0,_handleTopLevel:null,WINDOW_HANDLE:l.canUseDOM?window:null,setHandleTopLevel:function(e){m._handleTopLevel=e},setEnabled:function(e){m._enabled=!!e},isEnabled:function(){return m._enabled},trapBubbledEvent:function(e,t,n){return n?u.listen(n,t,m.dispatchEvent.bind(null,e)):null},trapCapturedEvent:function(e,t,n){return n?u.capture(n,t,m.dispatchEvent.bind(null,e)):null},monitorScrollValue:function(e){var t=a.bind(null,e);u.listen(window,"scroll",t)},dispatchEvent:function(e,t){if(m._enabled){var n=o.getPooled(e,t);try{f.batchedUpdates(i,n)}finally{o.release(n)}}}};e.exports=m},function(e,t,n){"use strict";var r=n(18),o=n(24),i=n(40),a=n(43),s=n(69),u=n(29),l=n(71),c=n(10),p={Component:a.injection,DOMProperty:r.injection,EmptyComponent:s.injection,EventPluginHub:o.injection,EventPluginUtils:i.injection,EventEmitter:u.injection,HostComponent:l.injection,Updates:c.injection};e.exports=p},function(e,t,n){"use strict";var r=n(178),o=/\/?>/,i=/^<\!\-\-/,a={CHECKSUM_ATTR_NAME:"data-react-checksum",addChecksumToMarkup:function(e){var t=r(e);return i.test(e)?e:e.replace(o," "+a.CHECKSUM_ATTR_NAME+'="'+t+'"$&')},canReuseMarkup:function(e,t){var n=t.getAttribute(a.CHECKSUM_ATTR_NAME);n=n&&parseInt(n,10);var o=r(e);return o===n}};e.exports=a},function(e,t,n){"use strict";function r(e,t,n){return{type:"INSERT_MARKUP",content:e,fromIndex:null,fromNode:null,toIndex:n,afterNode:t}}function o(e,t,n){return{type:"MOVE_EXISTING",content:null,fromIndex:e._mountIndex,fromNode:f.getHostNode(e),toIndex:n,afterNode:t}}function i(e,t){return{type:"REMOVE_NODE",content:null,fromIndex:e._mountIndex,fromNode:t,toIndex:null,afterNode:null}}function a(e){return{type:"SET_MARKUP",content:e,fromIndex:null,fromNode:null,toIndex:null,afterNode:null}}function s(e){return{type:"TEXT_CONTENT",content:e,fromIndex:null,fromNode:null,toIndex:null,afterNode:null}}function u(e,t){return t&&(e=e||[],e.push(t)),e}function l(e,t){p.processChildrenUpdates(e,t)}var c=n(3),p=n(43),f=(n(26),n(9),n(12),n(19)),d=n(135),h=(n(8),n(181)),m=(n(1),{Mixin:{_reconcilerInstantiateChildren:function(e,t,n){return d.instantiateChildren(e,t,n)},_reconcilerUpdateChildren:function(e,t,n,r,o,i){var a,s=0;return a=h(t,s),d.updateChildren(e,a,n,r,o,this,this._hostContainerInfo,i,s),a},mountChildren:function(e,t,n){var r=this._reconcilerInstantiateChildren(e,t,n);this._renderedChildren=r;var o=[],i=0;for(var a in r)if(r.hasOwnProperty(a)){var s=r[a],u=0,l=f.mountComponent(s,t,this,this._hostContainerInfo,n,u);s._mountIndex=i++,o.push(l)}return o},updateTextContent:function(e){var t=this._renderedChildren;d.unmountChildren(t,!1);for(var n in t)t.hasOwnProperty(n)&&c("118");var r=[s(e)];l(this,r)},updateMarkup:function(e){var t=this._renderedChildren;d.unmountChildren(t,!1);for(var n in t)t.hasOwnProperty(n)&&c("118");var r=[a(e)];l(this,r)},updateChildren:function(e,t,n){this._updateChildren(e,t,n)},_updateChildren:function(e,t,n){var r=this._renderedChildren,o={},i=[],a=this._reconcilerUpdateChildren(r,e,i,o,t,n);if(a||r){var s,c=null,p=0,d=0,h=0,m=null;for(s in a)if(a.hasOwnProperty(s)){var v=r&&r[s],g=a[s];v===g?(c=u(c,this.moveChild(v,m,p,d)),d=Math.max(v._mountIndex,d),v._mountIndex=p):(v&&(d=Math.max(v._mountIndex,d)),c=u(c,this._mountChildAtIndex(g,i[h],m,p,t,n)),h++),p++,m=f.getHostNode(g)}for(s in o)o.hasOwnProperty(s)&&(c=u(c,this._unmountChild(r[s],o[s])));c&&l(this,c),this._renderedChildren=a}},unmountChildren:function(e){var t=this._renderedChildren;d.unmountChildren(t,e),this._renderedChildren=null},moveChild:function(e,t,n,r){if(e._mountIndex<r)return o(e,t,n)},createChild:function(e,t,n){return r(n,t,e._mountIndex)},removeChild:function(e,t){return i(e,t)},_mountChildAtIndex:function(e,t,n,r,o,i){return e._mountIndex=r,this.createChild(e,n,t)},_unmountChild:function(e,t){var n=this.removeChild(e,t);return e._mountIndex=null,n}}});e.exports=m},function(e,t,n){"use strict";function r(e){return!(!e||"function"!=typeof e.attachRef||"function"!=typeof e.detachRef)}var o=n(3),i=(n(1),{addComponentAsRefTo:function(e,t,n){r(n)?void 0:o("119"),n.attachRef(t,e)},removeComponentAsRefFrom:function(e,t,n){r(n)?void 0:o("120");var i=n.getPublicInstance();i&&i.refs[t]===e.getPublicInstance()&&n.detachRef(t)}});e.exports=i},function(e,t){"use strict";var n="SECRET_DO_NOT_PASS_THIS_OR_YOU_WILL_BE_FIRED";e.exports=n},function(e,t,n){"use strict";function r(e){this.reinitializeTransaction(),this.renderToStaticMarkup=!1,this.reactMountReady=i.getPooled(null),this.useCreateElement=e}var o=n(4),i=n(65),a=n(14),s=n(29),u=n(72),l=(n(9),n(31)),c=n(45),p={initialize:u.getSelectionInformation,close:u.restoreSelection},f={initialize:function(){var e=s.isEnabled();return s.setEnabled(!1),e},close:function(e){
-s.setEnabled(e)}},d={initialize:function(){this.reactMountReady.reset()},close:function(){this.reactMountReady.notifyAll()}},h=[p,f,d],m={getTransactionWrappers:function(){return h},getReactMountReady:function(){return this.reactMountReady},getUpdateQueue:function(){return c},checkpoint:function(){return this.reactMountReady.checkpoint()},rollback:function(e){this.reactMountReady.rollback(e)},destructor:function(){i.release(this.reactMountReady),this.reactMountReady=null}};o(r.prototype,l,m),a.addPoolingTo(r),e.exports=r},function(e,t,n){"use strict";function r(e,t,n){"function"==typeof e?e(t.getPublicInstance()):i.addComponentAsRefTo(t,e,n)}function o(e,t,n){"function"==typeof e?e(null):i.removeComponentAsRefFrom(t,e,n)}var i=n(158),a={};a.attachRefs=function(e,t){if(null!==t&&"object"==typeof t){var n=t.ref;null!=n&&r(n,e,t._owner)}},a.shouldUpdateRefs=function(e,t){var n=null,r=null;null!==e&&"object"==typeof e&&(n=e.ref,r=e._owner);var o=null,i=null;return null!==t&&"object"==typeof t&&(o=t.ref,i=t._owner),n!==o||"string"==typeof o&&i!==r},a.detachRefs=function(e,t){if(null!==t&&"object"==typeof t){var n=t.ref;null!=n&&o(n,e,t._owner)}},e.exports=a},function(e,t,n){"use strict";function r(e){this.reinitializeTransaction(),this.renderToStaticMarkup=e,this.useCreateElement=!1,this.updateQueue=new s(this)}var o=n(4),i=n(14),a=n(31),s=(n(9),n(163)),u=[],l={enqueue:function(){}},c={getTransactionWrappers:function(){return u},getReactMountReady:function(){return l},getUpdateQueue:function(){return this.updateQueue},destructor:function(){},checkpoint:function(){},rollback:function(){}};o(r.prototype,a,c),i.addPoolingTo(r),e.exports=r},function(e,t,n){"use strict";function r(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function o(e,t){}var i=n(45),a=(n(2),function(){function e(t){r(this,e),this.transaction=t}return e.prototype.isMounted=function(e){return!1},e.prototype.enqueueCallback=function(e,t,n){this.transaction.isInTransaction()&&i.enqueueCallback(e,t,n)},e.prototype.enqueueForceUpdate=function(e){this.transaction.isInTransaction()?i.enqueueForceUpdate(e):o(e,"forceUpdate")},e.prototype.enqueueReplaceState=function(e,t){this.transaction.isInTransaction()?i.enqueueReplaceState(e,t):o(e,"replaceState")},e.prototype.enqueueSetState=function(e,t){this.transaction.isInTransaction()?i.enqueueSetState(e,t):o(e,"setState")},e}());e.exports=a},function(e,t){"use strict";e.exports="15.5.4"},function(e,t){"use strict";var n={xlink:"http://www.w3.org/1999/xlink",xml:"http://www.w3.org/XML/1998/namespace"},r={accentHeight:"accent-height",accumulate:0,additive:0,alignmentBaseline:"alignment-baseline",allowReorder:"allowReorder",alphabetic:0,amplitude:0,arabicForm:"arabic-form",ascent:0,attributeName:"attributeName",attributeType:"attributeType",autoReverse:"autoReverse",azimuth:0,baseFrequency:"baseFrequency",baseProfile:"baseProfile",baselineShift:"baseline-shift",bbox:0,begin:0,bias:0,by:0,calcMode:"calcMode",capHeight:"cap-height",clip:0,clipPath:"clip-path",clipRule:"clip-rule",clipPathUnits:"clipPathUnits",colorInterpolation:"color-interpolation",colorInterpolationFilters:"color-interpolation-filters",colorProfile:"color-profile",colorRendering:"color-rendering",contentScriptType:"contentScriptType",contentStyleType:"contentStyleType",cursor:0,cx:0,cy:0,d:0,decelerate:0,descent:0,diffuseConstant:"diffuseConstant",direction:0,display:0,divisor:0,dominantBaseline:"dominant-baseline",dur:0,dx:0,dy:0,edgeMode:"edgeMode",elevation:0,enableBackground:"enable-background",end:0,exponent:0,externalResourcesRequired:"externalResourcesRequired",fill:0,fillOpacity:"fill-opacity",fillRule:"fill-rule",filter:0,filterRes:"filterRes",filterUnits:"filterUnits",floodColor:"flood-color",floodOpacity:"flood-opacity",focusable:0,fontFamily:"font-family",fontSize:"font-size",fontSizeAdjust:"font-size-adjust",fontStretch:"font-stretch",fontStyle:"font-style",fontVariant:"font-variant",fontWeight:"font-weight",format:0,from:0,fx:0,fy:0,g1:0,g2:0,glyphName:"glyph-name",glyphOrientationHorizontal:"glyph-orientation-horizontal",glyphOrientationVertical:"glyph-orientation-vertical",glyphRef:"glyphRef",gradientTransform:"gradientTransform",gradientUnits:"gradientUnits",hanging:0,horizAdvX:"horiz-adv-x",horizOriginX:"horiz-origin-x",ideographic:0,imageRendering:"image-rendering",in:0,in2:0,intercept:0,k:0,k1:0,k2:0,k3:0,k4:0,kernelMatrix:"kernelMatrix",kernelUnitLength:"kernelUnitLength",kerning:0,keyPoints:"keyPoints",keySplines:"keySplines",keyTimes:"keyTimes",lengthAdjust:"lengthAdjust",letterSpacing:"letter-spacing",lightingColor:"lighting-color",limitingConeAngle:"limitingConeAngle",local:0,markerEnd:"marker-end",markerMid:"marker-mid",markerStart:"marker-start",markerHeight:"markerHeight",markerUnits:"markerUnits",markerWidth:"markerWidth",mask:0,maskContentUnits:"maskContentUnits",maskUnits:"maskUnits",mathematical:0,mode:0,numOctaves:"numOctaves",offset:0,opacity:0,operator:0,order:0,orient:0,orientation:0,origin:0,overflow:0,overlinePosition:"overline-position",overlineThickness:"overline-thickness",paintOrder:"paint-order",panose1:"panose-1",pathLength:"pathLength",patternContentUnits:"patternContentUnits",patternTransform:"patternTransform",patternUnits:"patternUnits",pointerEvents:"pointer-events",points:0,pointsAtX:"pointsAtX",pointsAtY:"pointsAtY",pointsAtZ:"pointsAtZ",preserveAlpha:"preserveAlpha",preserveAspectRatio:"preserveAspectRatio",primitiveUnits:"primitiveUnits",r:0,radius:0,refX:"refX",refY:"refY",renderingIntent:"rendering-intent",repeatCount:"repeatCount",repeatDur:"repeatDur",requiredExtensions:"requiredExtensions",requiredFeatures:"requiredFeatures",restart:0,result:0,rotate:0,rx:0,ry:0,scale:0,seed:0,shapeRendering:"shape-rendering",slope:0,spacing:0,specularConstant:"specularConstant",specularExponent:"specularExponent",speed:0,spreadMethod:"spreadMethod",startOffset:"startOffset",stdDeviation:"stdDeviation",stemh:0,stemv:0,stitchTiles:"stitchTiles",stopColor:"stop-color",stopOpacity:"stop-opacity",strikethroughPosition:"strikethrough-position",strikethroughThickness:"strikethrough-thickness",string:0,stroke:0,strokeDasharray:"stroke-dasharray",strokeDashoffset:"stroke-dashoffset",strokeLinecap:"stroke-linecap",strokeLinejoin:"stroke-linejoin",strokeMiterlimit:"stroke-miterlimit",strokeOpacity:"stroke-opacity",strokeWidth:"stroke-width",surfaceScale:"surfaceScale",systemLanguage:"systemLanguage",tableValues:"tableValues",targetX:"targetX",targetY:"targetY",textAnchor:"text-anchor",textDecoration:"text-decoration",textRendering:"text-rendering",textLength:"textLength",to:0,transform:0,u1:0,u2:0,underlinePosition:"underline-position",underlineThickness:"underline-thickness",unicode:0,unicodeBidi:"unicode-bidi",unicodeRange:"unicode-range",unitsPerEm:"units-per-em",vAlphabetic:"v-alphabetic",vHanging:"v-hanging",vIdeographic:"v-ideographic",vMathematical:"v-mathematical",values:0,vectorEffect:"vector-effect",version:0,vertAdvY:"vert-adv-y",vertOriginX:"vert-origin-x",vertOriginY:"vert-origin-y",viewBox:"viewBox",viewTarget:"viewTarget",visibility:0,widths:0,wordSpacing:"word-spacing",writingMode:"writing-mode",x:0,xHeight:"x-height",x1:0,x2:0,xChannelSelector:"xChannelSelector",xlinkActuate:"xlink:actuate",xlinkArcrole:"xlink:arcrole",xlinkHref:"xlink:href",xlinkRole:"xlink:role",xlinkShow:"xlink:show",xlinkTitle:"xlink:title",xlinkType:"xlink:type",xmlBase:"xml:base",xmlns:0,xmlnsXlink:"xmlns:xlink",xmlLang:"xml:lang",xmlSpace:"xml:space",y:0,y1:0,y2:0,yChannelSelector:"yChannelSelector",z:0,zoomAndPan:"zoomAndPan"},o={Properties:{},DOMAttributeNamespaces:{xlinkActuate:n.xlink,xlinkArcrole:n.xlink,xlinkHref:n.xlink,xlinkRole:n.xlink,xlinkShow:n.xlink,xlinkTitle:n.xlink,xlinkType:n.xlink,xmlBase:n.xml,xmlLang:n.xml,xmlSpace:n.xml},DOMAttributeNames:{}};Object.keys(r).forEach(function(e){o.Properties[e]=0,r[e]&&(o.DOMAttributeNames[e]=r[e])}),e.exports=o},function(e,t,n){"use strict";function r(e){if("selectionStart"in e&&u.hasSelectionCapabilities(e))return{start:e.selectionStart,end:e.selectionEnd};if(window.getSelection){var t=window.getSelection();return{anchorNode:t.anchorNode,anchorOffset:t.anchorOffset,focusNode:t.focusNode,focusOffset:t.focusOffset}}if(document.selection){var n=document.selection.createRange();return{parentElement:n.parentElement(),text:n.text,top:n.boundingTop,left:n.boundingLeft}}}function o(e,t){if(y||null==m||m!==c())return null;var n=r(m);if(!g||!f(g,n)){g=n;var o=l.getPooled(h.select,v,e,t);return o.type="select",o.target=m,i.accumulateTwoPhaseDispatches(o),o}return null}var i=n(25),a=n(7),s=n(6),u=n(72),l=n(11),c=n(59),p=n(81),f=n(36),d=a.canUseDOM&&"documentMode"in document&&document.documentMode<=11,h={select:{phasedRegistrationNames:{bubbled:"onSelect",captured:"onSelectCapture"},dependencies:["topBlur","topContextMenu","topFocus","topKeyDown","topKeyUp","topMouseDown","topMouseUp","topSelectionChange"]}},m=null,v=null,g=null,y=!1,b=!1,C={eventTypes:h,extractEvents:function(e,t,n,r){if(!b)return null;var i=t?s.getNodeFromInstance(t):window;switch(e){case"topFocus":(p(i)||"true"===i.contentEditable)&&(m=i,v=t,g=null);break;case"topBlur":m=null,v=null,g=null;break;case"topMouseDown":y=!0;break;case"topContextMenu":case"topMouseUp":return y=!1,o(n,r);case"topSelectionChange":if(d)break;case"topKeyDown":case"topKeyUp":return o(n,r)}return null},didPutListener:function(e,t,n){"onSelect"===t&&(b=!0)}};e.exports=C},function(e,t,n){"use strict";function r(e){return"."+e._rootNodeID}function o(e){return"button"===e||"input"===e||"select"===e||"textarea"===e}var i=n(3),a=n(57),s=n(25),u=n(6),l=n(168),c=n(169),p=n(11),f=n(172),d=n(174),h=n(30),m=n(171),v=n(175),g=n(176),y=n(27),b=n(177),C=n(8),_=n(47),w=(n(1),{}),E={};["abort","animationEnd","animationIteration","animationStart","blur","canPlay","canPlayThrough","click","contextMenu","copy","cut","doubleClick","drag","dragEnd","dragEnter","dragExit","dragLeave","dragOver","dragStart","drop","durationChange","emptied","encrypted","ended","error","focus","input","invalid","keyDown","keyPress","keyUp","load","loadedData","loadedMetadata","loadStart","mouseDown","mouseMove","mouseOut","mouseOver","mouseUp","paste","pause","play","playing","progress","rateChange","reset","scroll","seeked","seeking","stalled","submit","suspend","timeUpdate","touchCancel","touchEnd","touchMove","touchStart","transitionEnd","volumeChange","waiting","wheel"].forEach(function(e){var t=e[0].toUpperCase()+e.slice(1),n="on"+t,r="top"+t,o={phasedRegistrationNames:{bubbled:n,captured:n+"Capture"},dependencies:[r]};w[e]=o,E[r]=o});var T={},x={eventTypes:w,extractEvents:function(e,t,n,r){var o=E[e];if(!o)return null;var a;switch(e){case"topAbort":case"topCanPlay":case"topCanPlayThrough":case"topDurationChange":case"topEmptied":case"topEncrypted":case"topEnded":case"topError":case"topInput":case"topInvalid":case"topLoad":case"topLoadedData":case"topLoadedMetadata":case"topLoadStart":case"topPause":case"topPlay":case"topPlaying":case"topProgress":case"topRateChange":case"topReset":case"topSeeked":case"topSeeking":case"topStalled":case"topSubmit":case"topSuspend":case"topTimeUpdate":case"topVolumeChange":case"topWaiting":a=p;break;case"topKeyPress":if(0===_(n))return null;case"topKeyDown":case"topKeyUp":a=d;break;case"topBlur":case"topFocus":a=f;break;case"topClick":if(2===n.button)return null;case"topDoubleClick":case"topMouseDown":case"topMouseMove":case"topMouseUp":case"topMouseOut":case"topMouseOver":case"topContextMenu":a=h;break;case"topDrag":case"topDragEnd":case"topDragEnter":case"topDragExit":case"topDragLeave":case"topDragOver":case"topDragStart":case"topDrop":a=m;break;case"topTouchCancel":case"topTouchEnd":case"topTouchMove":case"topTouchStart":a=v;break;case"topAnimationEnd":case"topAnimationIteration":case"topAnimationStart":a=l;break;case"topTransitionEnd":a=g;break;case"topScroll":a=y;break;case"topWheel":a=b;break;case"topCopy":case"topCut":case"topPaste":a=c}a?void 0:i("86",e);var u=a.getPooled(o,t,n,r);return s.accumulateTwoPhaseDispatches(u),u},didPutListener:function(e,t,n){if("onClick"===t&&!o(e._tag)){var i=r(e),s=u.getNodeFromInstance(e);T[i]||(T[i]=a.listen(s,"click",C))}},willDeleteListener:function(e,t){if("onClick"===t&&!o(e._tag)){var n=r(e);T[n].remove(),delete T[n]}}};e.exports=x},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(11),i={animationName:null,elapsedTime:null,pseudoElement:null};o.augmentClass(r,i),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(11),i={clipboardData:function(e){return"clipboardData"in e?e.clipboardData:window.clipboardData}};o.augmentClass(r,i),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(11),i={data:null};o.augmentClass(r,i),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(30),i={dataTransfer:null};o.augmentClass(r,i),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(27),i={relatedTarget:null};o.augmentClass(r,i),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(11),i={data:null};o.augmentClass(r,i),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(27),i=n(47),a=n(182),s=n(48),u={key:a,location:null,ctrlKey:null,shiftKey:null,altKey:null,metaKey:null,repeat:null,locale:null,getModifierState:s,charCode:function(e){return"keypress"===e.type?i(e):0},keyCode:function(e){return"keydown"===e.type||"keyup"===e.type?e.keyCode:0},which:function(e){return"keypress"===e.type?i(e):"keydown"===e.type||"keyup"===e.type?e.keyCode:0}};o.augmentClass(r,u),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(27),i=n(48),a={touches:null,targetTouches:null,changedTouches:null,altKey:null,metaKey:null,ctrlKey:null,shiftKey:null,getModifierState:i};o.augmentClass(r,a),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(11),i={propertyName:null,elapsedTime:null,pseudoElement:null};o.augmentClass(r,i),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(30),i={deltaX:function(e){return"deltaX"in e?e.deltaX:"wheelDeltaX"in e?-e.wheelDeltaX:0},deltaY:function(e){return"deltaY"in e?e.deltaY:"wheelDeltaY"in e?-e.wheelDeltaY:"wheelDelta"in e?-e.wheelDelta:0},deltaZ:null,deltaMode:null};o.augmentClass(r,i),e.exports=r},function(e,t){"use strict";function n(e){for(var t=1,n=0,o=0,i=e.length,a=i&-4;o<a;){for(var s=Math.min(o+4096,a);o<s;o+=4)n+=(t+=e.charCodeAt(o))+(t+=e.charCodeAt(o+1))+(t+=e.charCodeAt(o+2))+(t+=e.charCodeAt(o+3));t%=r,n%=r}for(;o<i;o++)n+=t+=e.charCodeAt(o);return t%=r,n%=r,t|n<<16}var r=65521;e.exports=n},function(e,t,n){"use strict";function r(e,t,n){var r=null==t||"boolean"==typeof t||""===t;if(r)return"";var o=isNaN(t);if(o||0===t||i.hasOwnProperty(e)&&i[e])return""+t;if("string"==typeof t){t=t.trim()}return t+"px"}var o=n(64),i=(n(2),o.isUnitlessNumber);e.exports=r},function(e,t,n){"use strict";function r(e){if(null==e)return null;if(1===e.nodeType)return e;var t=a.get(e);return t?(t=s(t),t?i.getNodeFromInstance(t):null):void("function"==typeof e.render?o("44"):o("45",Object.keys(e)))}var o=n(3),i=(n(12),n(6)),a=n(26),s=n(78);n(1),n(2);e.exports=r},function(e,t,n){(function(t){"use strict";function r(e,t,n,r){if(e&&"object"==typeof e){var o=e,i=void 0===o[n];i&&null!=t&&(o[n]=t)}}function o(e,t){if(null==e)return e;var n={};return i(e,r,n),n}var i=(n(41),n(83));n(2);e.exports=o}).call(t,n(60))},function(e,t,n){"use strict";function r(e){if(e.key){var t=i[e.key]||e.key;if("Unidentified"!==t)return t}if("keypress"===e.type){var n=o(e);return 13===n?"Enter":String.fromCharCode(n)}return"keydown"===e.type||"keyup"===e.type?a[e.keyCode]||"Unidentified":""}var o=n(47),i={Esc:"Escape",Spacebar:" ",Left:"ArrowLeft",Up:"ArrowUp",Right:"ArrowRight",Down:"ArrowDown",Del:"Delete",Win:"OS",Menu:"ContextMenu",Apps:"ContextMenu",Scroll:"ScrollLock",MozPrintableKey:"Unidentified"},a={8:"Backspace",9:"Tab",12:"Clear",13:"Enter",16:"Shift",17:"Control",18:"Alt",19:"Pause",20:"CapsLock",27:"Escape",32:" ",33:"PageUp",34:"PageDown",35:"End",36:"Home",37:"ArrowLeft",38:"ArrowUp",39:"ArrowRight",40:"ArrowDown",45:"Insert",46:"Delete",112:"F1",113:"F2",114:"F3",115:"F4",116:"F5",117:"F6",118:"F7",119:"F8",120:"F9",121:"F10",122:"F11",123:"F12",144:"NumLock",145:"ScrollLock",224:"Meta"};e.exports=r},function(e,t){"use strict";function n(e){var t=e&&(r&&e[r]||e[o]);if("function"==typeof t)return t}var r="function"==typeof Symbol&&Symbol.iterator,o="@@iterator";e.exports=n},function(e,t){"use strict";function n(e){for(;e&&e.firstChild;)e=e.firstChild;return e}function r(e){for(;e;){if(e.nextSibling)return e.nextSibling;e=e.parentNode}}function o(e,t){for(var o=n(e),i=0,a=0;o;){if(3===o.nodeType){if(a=i+o.textContent.length,i<=t&&a>=t)return{node:o,offset:t-i};i=a}o=n(r(o))}}e.exports=o},function(e,t,n){"use strict";function r(e,t){var n={};return n[e.toLowerCase()]=t.toLowerCase(),n["Webkit"+e]="webkit"+t,n["Moz"+e]="moz"+t,n["ms"+e]="MS"+t,n["O"+e]="o"+t.toLowerCase(),n}function o(e){if(s[e])return s[e];if(!a[e])return e;var t=a[e];for(var n in t)if(t.hasOwnProperty(n)&&n in u)return s[e]=t[n];return""}var i=n(7),a={animationend:r("Animation","AnimationEnd"),animationiteration:r("Animation","AnimationIteration"),animationstart:r("Animation","AnimationStart"),transitionend:r("Transition","TransitionEnd")},s={},u={};i.canUseDOM&&(u=document.createElement("div").style,"AnimationEvent"in window||(delete a.animationend.animation,delete a.animationiteration.animation,delete a.animationstart.animation),"TransitionEvent"in window||delete a.transitionend.transition),e.exports=o},function(e,t,n){"use strict";function r(e){return'"'+o(e)+'"'}var o=n(32);e.exports=r},function(e,t,n){"use strict";var r=n(73);e.exports=r.renderSubtreeIntoContainer},function(e,t,n){"use strict";"undefined"==typeof Promise&&(n(120).enable(),window.Promise=n(119)),n(226),Object.assign=n(4)},113,114,115,116,117,function(e,t,n){(function(){var t,r,o;t=n(5),r=t.createClass,o=t.DOM.div,e.exports=r({getDefaultProps:function(){return{className:"",onHeightChange:function(){}}},render:function(){return o({className:this.props.className,ref:"dropdown"},this.props.children)},componentDidMount:function(){this.props.onHeightChange(this.refs.dropdown.offsetHeight)},componentDidUpdate:function(){this.props.onHeightChange(this.refs.dropdown.offsetHeight)},componentWillUnmount:function(){this.props.onHeightChange(0)}})}).call(this)},function(e,t,n){(function(){function t(e,t){var n={}.hasOwnProperty;for(var r in t)n.call(t,r)&&(e[r]=t[r]);return e}var r,o,i,a,s,u,l,c,p,f,d,h,m,v,g,y,b,C;r=n(15),o=r.filter,i=r.id,a=r.map,s=n(16).isEqualToObject,u=n(5),r=u.DOM,l=r.div,c=r.input,p=r.span,f=u.createClass,d=u.createFactory,h=n(13).findDOMNode,m=d(n(63)),v=d(n(198)),g=d(n(194)),y=d(n(84)),r=n(28),b=r.cancelEvent,C=r.classNameFromObject,e.exports=f({displayName:"DropdownMenu",getDefaultProps:function(){return{className:"",dropdownDirection:1,groupId:function(e){return e.groupId},groupsAsColumns:!1,highlightedUid:void 0,onHighlightedUidChange:function(e,t){},onOptionClick:function(e){},onScrollLockChange:function(e){},options:[],renderNoResultsFound:function(){return l({className:"no-results-found"},"No results found")},renderGroupTitle:function(e,t){var n,r;return null!=t&&(n=t.groupId,r=t.title),l({className:"simple-group-title",key:n},r)},renderOption:function(e){var t,n,r,o;return null!=e&&(t=e.label,n=e.newOption,r=e.selectable),o="undefined"==typeof r||r,l({className:"simple-option "+(o?"":"not-selectable")},p(null,n?"Add "+t+" ...":t))},scrollLock:!1,style:{},tether:!1,tetherProps:{},theme:"default",transitionEnter:!1,transitionLeave:!1,transitionEnterTimeout:200,transitionLeaveTimeout:200,uid:i}},render:function(){var e,n;return e=C((n={},n[this.props.theme+""]=1,n[this.props.className+""]=1,n.flipped=this.props.dropdownDirection===-1,n.tethered=this.props.tether,n)),this.props.tether?v((n=t({},this.props.tetherProps),n.options={attachment:"top left",targetAttachment:"bottom left",constraints:[{to:"scrollParent"}]},n),this.renderAnimatedDropdown({dynamicClassName:e})):this.renderAnimatedDropdown({dynamicClassName:e})},renderAnimatedDropdown:function(e){var t;return t=e.dynamicClassName,this.props.transitionEnter||this.props.transitionLeave?m({component:"div",transitionName:"custom",transitionEnter:this.props.transitionEnter,transitionLeave:this.props.transitionLeave,transitionEnterTimeout:this.props.transitionEnterTimeout,transitionLeaveTimeout:this.props.transitionLeaveTimeout,className:"dropdown-menu-wrapper "+t,ref:"dropdownMenuWrapper"},this.renderDropdown(e)):this.renderDropdown(e)},renderOptions:function(e){var n=this;return a(function(r){var o,i;return o=e[r],i=n.props.uid(o),y(t({uid:i,ref:"option-"+n.uidToString(i),key:n.uidToString(i),item:o,highlight:s(n.props.highlightedUid,i),selectable:null!=o?o.selectable:void 0,onMouseMove:function(e){var t;t=e.currentTarget,n.props.scrollLock&&n.props.onScrollLockChange(!1)},onMouseOut:function(){n.props.scrollLock||n.props.onHighlightedUidChange(void 0,function(){})},renderItem:n.props.renderOption},function(){switch(!1){case!("boolean"==typeof(null!=o?o.selectable:void 0)&&!o.selectable):return{onClick:b};default:return{onClick:function(){n.props.onOptionClick(n.props.highlightedUid)},onMouseOver:function(e){var t;t=e.currentTarget,n.props.scrollLock||n.props.onHighlightedUidChange(i,function(){})}}}}()))})(function(){var t,n,r=[];for(t=0,n=e.length;t<n;++t)r.push(t);return r}())},renderDropdown:function(e){var t,n,r,i,s=this;return t=e.dynamicClassName,this.props.open?g({className:"dropdown-menu "+t,ref:"dropdownMenu",onHeightChange:function(e){s.refs.dropdownMenuWrapper&&(h(s.refs.dropdownMenuWrapper).style.height=e+"px")}},0===this.props.options.length?this.props.renderNoResultsFound():(null!=(n=this.props)&&null!=(r=n.groups)?r.length:void 0)>0?(i=a(function(e){var t,n,r;return t=s.props.groups[e],n=t.groupId,r=o(function(e){return s.props.groupId(e)===n})(s.props.options),{index:e,group:t,options:r}})(function(){var e,t,n=[];for(e=0,t=this.props.groups.length;e<t;++e)n.push(e);return n}.call(this)),l({className:"groups "+(this.props.groupsAsColumns?"as-columns":"")},a(function(e){var t,n,r,o;return t=e.index,n=e.group,r=n.groupId,o=e.options,l({key:r},s.props.renderGroupTitle(t,n,o),l({className:"options"},s.renderOptions(o)))})(o(function(e){return e.options.length>0})(i)))):this.renderOptions(this.props.options)):null},componentDidUpdate:function(){var e,t,n;e=t=h(null!=(n=this.refs.dropdownMenuWrapper)?n:this.refs.dropdownMenu),null!=e&&(e.style.bottom=function(){switch(!1){case this.props.dropdownDirection!==-1:return this.props.bottomAnchor().offsetHeight+t.style.marginBottom+"px";default:return""}}.call(this))},highlightAndScrollToOption:function(e,t){var n,r=this;null==t&&(t=function(){}),n=this.props.uid(this.props.options[e]),this.props.onHighlightedUidChange(n,function(){var e,o,i,a,s;return null!=(e=h(null!=(o=r.refs)?o["option-"+r.uidToString(n)]:void 0))&&(i=e),i&&(a=h(r.refs.dropdownMenu),s=i.offsetHeight-1,i.offsetTop-a.scrollTop>=a.offsetHeight?a.scrollTop=i.offsetTop-a.offsetHeight+s:i.offsetTop-a.scrollTop+s<=0&&(a.scrollTop=i.offsetTop)),t()})},highlightAndScrollToSelectableOption:function(e,t,n){var r,o,i;null==n&&(n=function(){}),e<0||e>=this.props.options.length?this.props.onHighlightedUidChange(void 0,function(){return n(!1)}):(r=null!=(o=this.props)&&null!=(i=o.options)?i[e]:void 0,"boolean"!=typeof(null!=r?r.selectable:void 0)||r.selectable?this.highlightAndScrollToOption(e,function(){return n(!0)}):this.highlightAndScrollToSelectableOption(e+t,t,n))},uidToString:function(e){return("object"==typeof e?JSON.stringify:i)(e)}})}).call(this)},function(e,t,n){(function(){var t,r,o,i,a,s;t=n(5),r=t.createClass,o=t.DOM,i=o.div,a=o.span,s=n(15).map,e.exports=r({getDefaultProps:function(){return{partitions:[],text:"",style:{},highlightStyle:{}}},render:function(){var e=this;return i({className:"highlighted-text",style:this.props.style},s(function(t){var n,r,o;return n=t[0],r=t[1],o=t[2],a({key:e.props.text+""+n+r+o,className:o?"highlight":"",style:o?e.props.highlightStyle:{}},e.props.text.substring(n,r))})(this.props.partitions))}})}).call(this)},function(e,t,n){(function(){function t(e,t){for(var n=-1,r=t.length>>>0;++n<r;)if(e===t[n])return!0;return!1}function r(e,t){var n,r=function(o){return e.length>1?function(){var i=o?o.concat():[];return n=t?n||this:this,i.push.apply(i,arguments)<e.length&&arguments.length?r.call(n,i):e.apply(n,i)}:e};return r()}function o(e,t){var n={}.hasOwnProperty;for(var r in t)n.call(t,r)&&(e[r]=t[r]);return e}var i,a,s,u,l,c,p,f,d,h,m,v,g,y,b,C,_,w,E,T,x,O={}.toString;i=n(15),a=i.all,s=i.any,u=i.camelize,l=i.difference,c=i.drop,p=i.filter,f=i.find,d=i.findIndex,h=i.id,m=i.last,v=i.map,g=i.reject,y=n(16).isEqualToObject,b=n(5),C=b.createFactory,i=b.DOM,_=i.div,w=i.img,E=i.span,T=C(n(53)),x=n(28).cancelEvent,e.exports=b.createClass({displayName:"MultiSelect",getDefaultProps:function(){return{className:"",closeOnSelect:!1,defaultValues:[],delimiters:[],filterOptions:r(function(e,n,r){return p(function(e){return e.label.toLowerCase().trim().indexOf(r.toLowerCase().trim())>-1})(g(function(e){return t(e.label.trim(),v(function(e){return e.label.trim()},null!=n?n:[]))})(e))}),firstOptionIndexToHighlight:h,onBlur:function(e){},onFocus:function(e){},onPaste:function(e){},serialize:v(function(e){return null!=e?e.value:void 0}),tether:!1}},render:function(){var e,t,n,r,i,a,s,u,l,c,p,f,d,h,v,g,y,b,C,_,w,E,O,P,k,S,N,M,A,I,D,R,L,U,F,j,B,V,W=this;return e=this.getComputedState(),t=e.anchor,n=e.filteredOptions,r=e.highlightedUid,i=e.onAnchorChange,a=e.onOpenChange,s=e.onHighlightedUidChange,u=e.onSearchChange,l=e.onValuesChange,c=e.search,p=e.open,f=e.options,d=e.values,null!=(e=this.props)&&(h=e.autofocus,v=e.autosize,g=e.cancelKeyboardEventOnSelection,y=e.delimiters,b=e.disabled,C=e.dropdownDirection,_=e.groupId,w=e.groups,E=e.groupsAsColumns,O=e.hideResetButton,P=e.inputProps,k=e.name,S=e.onKeyboardSelectionFailed,N=e.renderToggleButton,M=e.renderGroupTitle,A=e.renderResetButton,I=e.serialize,D=e.tether,R=e.tetherProps,L=e.theme,U=e.transitionEnter,F=e.transitionLeave,j=e.transitionEnterTimeout,B=e.transitionLeaveTimeout,V=e.uid),T(o(o({autofocus:h,autosize:v,cancelKeyboardEventOnSelection:g,className:"multi-select "+this.props.className,delimiters:y,disabled:b,dropdownDirection:C,groupId:_,groups:w,groupsAsColumns:E,hideResetButton:O,highlightedUid:r,onHighlightedUidChange:s,inputProps:P,name:k,onKeyboardSelectionFailed:S,renderGroupTitle:M,renderResetButton:A,renderToggleButton:N,scrollLock:this.state.scrollLock,onScrollLockChange:function(e){return W.setState({scrollLock:e})},tether:D,tetherProps:R,theme:L,transitionEnter:U,transitionEnterTimeout:j,transitionLeave:F,transitionLeaveTimeout:B,uid:V,ref:"select",anchor:t,onAnchorChange:i,open:p,onOpenChange:a,options:f,renderOption:this.props.renderOption,firstOptionIndexToHighlight:function(){return W.firstOptionIndexToHighlight(f)},search:c,onSearchChange:function(e,t){return u(W.props.maxValues&&d.length>=W.props.maxValues?"":e,t)},values:d,onValuesChange:function(e,t){return l(e,function(){if(t(),W.props.closeOnSelect||W.props.maxValues&&W.values().length>=W.props.maxValues)return a(!1,function(){})})},renderValue:this.props.renderValue,serialize:I,onBlur:function(e){u("",function(){return W.props.onBlur({open:p,values:d,originalEvent:e})})},onFocus:function(e){W.props.onFocus({open:p,values:d,originalEvent:e})},onPaste:function(){var e;switch(!1){case"undefined"!=typeof(null!=(e=this.props)?e.valuesFromPaste:void 0):return this.props.onPaste;default:return function(e){var t;return t=e.clipboardData,function(){var e;return e=d.concat(W.props.valuesFromPaste(f,d,t.getData("text"))),l(e,function(){return i(m(e))})}(),x(e)}}}.call(this),placeholder:this.props.placeholder,style:this.props.style},function(){switch(!1){case"function"!=typeof this.props.restoreOnBackspace:return{restoreOnBackspace:this.props.restoreOnBackspace};default:return{}}}.call(this)),function(){switch(!1){case"function"!=typeof this.props.renderNoResultsFound:return{renderNoResultsFound:function(){return W.props.renderNoResultsFound(d,c)}};default:return{}}}.call(this)))},getComputedState:function(){var e,t,n,r,i,a,s,l,c,p,f,d,h,m,g,y,b=this;return e=this.props.hasOwnProperty("anchor")?this.props.anchor:this.state.anchor,t=this.props.hasOwnProperty("highlightedUid")?this.props.highlightedUid:this.state.highlightedUid,n=this.isOpen(),r=this.props.hasOwnProperty("search")?this.props.search:this.state.search,i=this.values(),a=v(function(e){switch(!1){case!(b.props.hasOwnProperty(e)&&b.props.hasOwnProperty(u("on-"+e+"-change"))):return function(t,n){return b.props[u("on-"+e+"-change")](t,function(){}),b.setState({},n)};case!(b.props.hasOwnProperty(e)&&!b.props.hasOwnProperty(u("on-"+e+"-change"))):return function(e,t){return t()};case!(!b.props.hasOwnProperty(e)&&b.props.hasOwnProperty(u("on-"+e+"-change"))):return function(t,n){var r;return b.setState((r={},r[e+""]=t,r),function(){return n(),b.props[u("on-"+e+"-change")](t,function(){})})};case!(!b.props.hasOwnProperty(e)&&!b.props.hasOwnProperty(u("on-"+e+"-change"))):return function(t,n){var r;return b.setState((r={},r[e+""]=t,r),n)}}})(["anchor","highlightedUid","open","search","values"]),s=a[0],l=a[1],c=a[2],p=a[3],f=a[4],d=function(){var e;switch(!1){case!(null!=(e=this.props)&&e.children):return v(function(e){var t,n,r;return null!=e&&(t=e.props),null!=t&&(n=t.value,r=t.children),{label:r,value:n}})("Array"===O.call(this.props.children).slice(8,-1)?this.props.children:[this.props.children]);default:return[]}}.call(this),h=this.props.hasOwnProperty("options")?null!=(a=this.props.options)?a:[]:d,m=this.props.filterOptions(h,i,r),g=function(){switch(!1){case"function"!=typeof this.props.createFromSearch:return this.props.createFromSearch(m,i,r);default:return null}}.call(this),y=(g?[(a=o({},g),a.newOption=!0,a)]:[]).concat(m),{anchor:e,highlightedUid:t,search:r,values:i,onAnchorChange:s,onHighlightedUidChange:l,open:n,onOpenChange:function(e,t){c(function(){switch(!1){case!("undefined"!=typeof this.props.maxValues&&this.values().length>=this.props.maxValues):return!1;default:return e}}.call(b),t)},onSearchChange:p,onValuesChange:f,filteredOptions:m,options:y}},getInitialState:function(){return{anchor:this.props.values?m(this.props.values):void 0,highlightedUid:void 0,open:!1,scrollLock:!1,search:"",values:this.props.defaultValues}},firstOptionIndexToHighlight:function(e){var t,n;return t=function(){var t;switch(!1){case 1!==e.length:return 0;case"undefined"!=typeof(null!=(t=e[0])?t.newOption:void 0):return 0;default:return a(function(e){return"boolean"==typeof e.selectable&&!e.selectable})(c(1)(e))?0:1}}(),n=this.props.hasOwnProperty("search")?this.props.search:this.state.search,this.props.firstOptionIndexToHighlight(t,e,this.values(),n)},focus:function(){this.refs.select.focus()},blur:function(){this.refs.select.blur()},highlightFirstSelectableOption:function(){this.state.open&&this.refs.select.highlightAndScrollToSelectableOption(this.firstOptionIndexToHighlight(this.getComputedState().options),1)},values:function(){return this.props.hasOwnProperty("values")?this.props.values:this.state.values},isOpen:function(){return this.props.hasOwnProperty("open")?this.props.open:this.state.open}})}).call(this)},function(e,t,n){(function(){function t(e,t){var n={}.hasOwnProperty;for(var r in t)n.call(t,r)&&(e[r]=t[r]);return e}var r,o,i,a,s,u;r=n(5).createClass,o=n(13),i=o.render,a=o.unmountComponentAtNode,s=n(124),u=n(224),e.exports=r({getDefaultProps:function(){return{parentElement:function(){return document.body}}},render:function(){
-return null},initTether:function(e){var n=this;this.node=document.createElement("div"),this.props.parentElement().appendChild(this.node),this.tether=new u(t({element:this.node,target:e.target()},e.options)),i(e.children,this.node,function(){return n.tether.position()})},destroyTether:function(){this.tether&&this.tether.destroy(),this.node&&(a(this.node),this.node.parentElement.removeChild(this.node)),this.node=this.tether=void 0},componentDidMount:function(){this.props.children&&this.initTether(this.props)},componentWillReceiveProps:function(e){var n=this;this.props.children&&!e.children?this.destroyTether():e.children&&!this.props.children?this.initTether(e):e.children&&(this.tether.setOptions(t({element:this.node,target:e.target()},e.options)),i(e.children,this.node,function(){return n.tether.position()}))},shouldComponentUpdate:function(e,t){return s(this,e,t)},componentWillUnmount:function(){this.destroyTether()}})}).call(this)},function(e,t,n){(function(){var t,r,o,i,a;t=n(5),r=t.createClass,o=t.createFactory,i=t.DOM.path,a=o(n(85)),e.exports=r({render:function(){return a({className:"react-selectize-reset-button",style:{width:8,height:8}},i({d:"M0 0 L8 8 M8 0 L 0 8"}))}})}).call(this)},function(e,t,n){(function(){function t(e,t){var n={}.hasOwnProperty;for(var r in t)n.call(t,r)&&(e[r]=t[r]);return e}var r,o,i,a,s,u,l,c;r=n(15),o=r.each,i=r.objToPairs,a=n(5),s=a.DOM.input,u=a.createClass,l=a.createFactory,c=n(13).findDOMNode,e.exports=u({displayName:"ResizableInput",render:function(){var e;return s((e=t({},this.props),e.type="input",e.className="resizable-input",e))},autosize:function(){var e,t,n,r,a;return e=t=c(this),e.style.width="0px",0===t.value.length?t.style.width=null!=t&&t.currentStyle?"4px":"2px":t.scrollWidth>0?t.style.width=2+t.scrollWidth+"px":(n=r=document.createElement("div"),n.innerHTML=t.value,function(){var e;return e=r.style,e.display="inline-block",e.width="",e}(o(function(e){var t,n;return t=e[0],n=e[1],r.style[t]=n})(i(t.currentStyle?t.currentStyle:null!=(a=document.defaultView)?a:window.getComputedStyle(t)))),document.body.appendChild(r),t.style.width=4+r.clientWidth+"px",document.body.removeChild(r))},componentDidMount:function(){this.autosize()},componentDidUpdate:function(){this.autosize()},blur:function(){return c(this).blur()},focus:function(){return c(this).focus()}})}).call(this)},function(e,t,n){(function(){function t(e,t){var n,r=function(o){return e.length>1?function(){var i=o?o.concat():[];return n=t?n||this:this,i.push.apply(i,arguments)<e.length&&arguments.length?r.call(n,i):e.apply(n,i)}:e};return r()}function r(e,t){var n={}.hasOwnProperty;for(var r in t)n.call(t,r)&&(e[r]=t[r]);return e}var o,i,a,s,u,l,c,p,f,d,h,m,v,g,y,b,C,_,w,E,T,x={}.toString;o=n(15),i=o.all,a=o.any,s=o.drop,u=o.camelize,l=o.difference,c=o.filter,p=o.find,f=o.findIndex,d=o.id,h=o.last,m=o.map,v=o.reject,g=n(16).isEqualToObject,y=n(5),b=y.createFactory,o=y.DOM,C=o.div,_=o.img,w=o.span,E=b(n(53)),T=n(28).cancelEvent,e.exports=y.createClass({displayName:"SimpleSelect",getDefaultProps:function(){return{delimiters:[],filterOptions:t(function(e,t){return c(function(e){return e.label.toLowerCase().trim().indexOf(t.toLowerCase().trim())>-1})(e)}),firstOptionIndexToHighlight:d,onBlur:function(e){},onBlurResetsInput:!0,onFocus:function(e){},onKeyboardSelectionFailed:function(e){},onPaste:function(e){},placeholder:"",renderValue:function(e){var t;return t=e.label,C({className:"simple-value"},w(null,t))},serialize:function(e){return null!=e?e.value:void 0},style:{},tether:!1,uid:d}},render:function(){var e,t,n,o,i,a,s,u,l,c,p,f,d,m,v,y,b,C,_,w,x,O,P,k,S,N,M,A,I,D,R,L,U,F,j,B,V,W=this;return e=this.getComputedState(),t=e.filteredOptions,n=e.highlightedUid,o=e.onHighlightedUidChange,i=e.onOpenChange,a=e.onSearchChange,s=e.onValueChange,u=e.open,l=e.options,c=e.search,p=e.value,f=e.values,null!=(e=this.props)&&(d=e.autofocus,m=e.autosize,v=e.cancelKeyboardEventOnSelection,y=e.delimiters,b=e.disabled,C=e.dropdownDirection,_=e.groupId,w=e.groups,x=e.groupsAsColumns,O=e.hideResetButton,P=e.name,k=e.inputProps,S=e.onBlurResetsInput,N=e.renderToggleButton,M=e.renderGroupTitle,A=e.renderResetButton,I=e.serialize,D=e.tether,R=e.tetherProps,L=e.theme,U=e.transitionEnter,F=e.transitionLeave,j=e.transitionEnterTimeout,B=e.transitionLeaveTimeout,V=e.uid),E(r(r({autofocus:d,autosize:m,cancelKeyboardEventOnSelection:v,className:"simple-select"+(this.props.className?" "+this.props.className:""),delimiters:y,disabled:b,dropdownDirection:C,groupId:_,groups:w,groupsAsColumns:x,hideResetButton:O,highlightedUid:n,onHighlightedUidChange:o,inputProps:k,name:P,onBlurResetsInput:S,renderGroupTitle:M,renderResetButton:A,renderToggleButton:N,scrollLock:this.state.scrollLock,onScrollLockChange:function(e){return W.setState({scrollLock:e})},tether:D,tetherProps:R,theme:L,transitionEnter:U,transitionEnterTimeout:j,transitionLeave:F,transitionLeaveTimeout:B,ref:"select",anchor:h(f),onAnchorChange:function(e,t){return t()},open:u,onOpenChange:i,firstOptionIndexToHighlight:function(){return W.firstOptionIndexToHighlight(l,p)},options:l,renderOption:this.props.renderOption,renderNoResultsFound:this.props.renderNoResultsFound,search:c,onSearchChange:function(e,t){return a(e,t)},values:f,onValuesChange:function(e,t){var n,r;return 0===e.length?s(void 0,function(){return t()}):(n=h(e),r=!g(n,p),function(){return function(e){return r?s(n,e):e()}}()(function(){return t(),i(!1,function(){})}))},renderValue:function(e){return u&&(W.props.editable||c.length>0)?null:W.props.renderValue(e)},onKeyboardSelectionFailed:function(e){return a("",function(){return i(!1,function(){return W.props.onKeyboardSelectionFailed(e)})})},uid:function(e){return{uid:W.props.uid(e),open:u,search:c}},serialize:function(e){return I(e[0])},onBlur:function(e){var t;t=W.props.onBlurResetsInput,function(){return function(e){return c.length>0&&t?a("",e):e()}}()(function(){return W.props.onBlur({value:p,open:u,originalEvent:e})})},onFocus:function(e){W.props.onFocus({value:p,open:u,originalEvent:e})},onPaste:function(){var e;switch(!1){case"undefined"!=typeof(null!=(e=this.props)?e.valueFromPaste:void 0):return this.props.onPaste;default:return function(e){var t,n;if(t=e.clipboardData,n=W.props.valueFromPaste(l,p,t.getData("text")))return function(){return s(n,function(){return a("",function(){return i(!1)})})}(),T(e)}}}.call(this),placeholder:this.props.placeholder,style:this.props.style},function(){switch(!1){case"function"!=typeof this.props.restoreOnBackspace:return{restoreOnBackspace:this.props.restoreOnBackspace};default:return{}}}.call(this)),function(){switch(!1){case"function"!=typeof this.props.renderNoResultsFound:return{renderNoResultsFound:function(){return W.props.renderNoResultsFound(p,c)}};default:return{}}}.call(this)))},getComputedState:function(){var e,t,n,o,i,a,s,l,c,p,f,d,h,v,g,y=this;return e=this.props.hasOwnProperty("highlightedUid")?this.props.highlightedUid:this.state.highlightedUid,t=this.isOpen(),n=this.props.hasOwnProperty("search")?this.props.search:this.state.search,o=this.value(),i=o||0===o?[o]:[],a=m(function(e){var t;return t=function(){switch(!1){case!(this.props.hasOwnProperty(e)&&this.props.hasOwnProperty(u("on-"+e+"-change"))):return function(t,n){return y.props[u("on-"+e+"-change")](t,function(){}),y.setState({},n)};case!(this.props.hasOwnProperty(e)&&!this.props.hasOwnProperty(u("on-"+e+"-change"))):return function(e,t){return t()};case!(!this.props.hasOwnProperty(e)&&this.props.hasOwnProperty(u("on-"+e+"-change"))):return function(t,n){var r;return y.setState((r={},r[e+""]=t,r),function(){return n(),y.props[u("on-"+e+"-change")](t,function(){})})};case!(!this.props.hasOwnProperty(e)&&!this.props.hasOwnProperty(u("on-"+e+"-change"))):return function(t,n){var r;return y.setState((r={},r[e+""]=t,r),n)}}}.call(y)})(["highlightedUid","open","search","value"]),s=a[0],l=a[1],c=a[2],p=a[3],f=function(){var e;switch(!1){case!(null!=(e=this.props)&&e.children):return m(function(e){var t,n,r;return null!=(t=null!=e?e.props:void 0)&&(n=t.value,r=t.children),{label:r,value:n}})("Array"===x.call(this.props.children).slice(8,-1)?this.props.children:[this.props.children]);default:return[]}}.call(this),d=this.props.hasOwnProperty("options")?null!=(a=this.props.options)?a:[]:f,h=this.props.filterOptions(d,n),v=function(){switch(!1){case"function"!=typeof this.props.createFromSearch:return this.props.createFromSearch(h,n);default:return null}}.call(this),g=(v?[(a=r({},v),a.newOption=!0,a)]:[]).concat(h),{highlightedUid:e,open:t,search:n,value:o,values:i,onHighlightedUidChange:s,onOpenChange:function(e,t){l(e,function(){if(t(),y.props.editable&&y.isOpen()&&o)return c(y.props.editable(o)+""+(1===n.length?n:""),function(){return y.highlightFirstSelectableOption(function(){})})})},onSearchChange:c,onValueChange:p,filteredOptions:h,options:g}},getInitialState:function(){var e;return{highlightedUid:void 0,open:!1,scrollLock:!1,search:"",value:null!=(e=this.props)?e.defaultValue:void 0}},firstOptionIndexToHighlight:function(e,t){var n,r,o;return n=t?f(function(e){return g(e,t)},e):void 0,r=function(){var t;switch(!1){case"undefined"==typeof n:return n;case 1!==e.length:return 0;case"undefined"!=typeof(null!=(t=e[0])?t.newOption:void 0):return 0;default:return i(function(e){return"boolean"==typeof e.selectable&&!e.selectable})(s(1)(e))?0:1}}(),o=this.props.hasOwnProperty("search")?this.props.search:this.state.search,this.props.firstOptionIndexToHighlight(r,e,t,o)},focus:function(){this.refs.select.focus()},blur:function(){this.refs.select.blur()},highlightFirstSelectableOption:function(e){var t,n,r;null==e&&(e=function(){}),this.state.open?(t=this.getComputedState(),n=t.options,r=t.value,this.refs.select.highlightAndScrollToSelectableOption(this.firstOptionIndexToHighlight(n,r),1,e)):e()},value:function(){return this.props.hasOwnProperty("value")?this.props.value:this.state.value},isOpen:function(){return this.props.hasOwnProperty("open")?this.props.open:this.state.open}})}).call(this)},function(e,t,n){(function(){var t,r,o,i,a;t=n(5),r=t.createClass,o=t.createFactory,i=t.DOM.path,a=o(n(85)),e.exports=r({getDefaultProps:function(){return{open:!1,flipped:!1}},render:function(){return a({className:"react-selectize-toggle-button",style:{width:10,height:8}},i({d:function(){switch(!1){case!(this.props.open&&!this.props.flipped||!this.props.open&&this.props.flipped):return"M0 6 L5 1 L10 6 Z";default:return"M0 1 L5 6 L10 1 Z"}}.call(this)}))}})}).call(this)},function(e,t,n){(function(){var t,r,o,i;t=n(5),r=t.createClass,o=t.DOM.div,i=n(16).isEqualToObject,e.exports=r({getDefaultProps:function(){return{}},render:function(){return o({className:"value-wrapper"},this.props.renderItem(this.props.item))},shouldComponentUpdate:function(e){var t;return!i(null!=e?e.uid:void 0,null!=(t=this.props)?t.uid:void 0)}})}).call(this)},function(e,t,n){(function(){var t,r,o,i;t=n(196),r=n(201),o=n(197),i=n(53),e.exports={HighlightedText:t,SimpleSelect:r,MultiSelect:o,ReactSelectize:i}}).call(this)},function(e,t,n){"use strict";function r(e){return e&&e.__esModule?e:{default:e}}function o(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function i(e,t){if(!e)throw new ReferenceError("this hasn't been initialised - super() hasn't been called");return!t||"object"!=typeof t&&"function"!=typeof t?e:t}function a(e,t){if("function"!=typeof t&&null!==t)throw new TypeError("Super expression must either be null or a function, not "+typeof t);e.prototype=Object.create(t&&t.prototype,{constructor:{value:e,enumerable:!1,writable:!0,configurable:!0}}),t&&(Object.setPrototypeOf?Object.setPrototypeOf(e,t):e.__proto__=t)}t.__esModule=!0;var s=Object.assign||function(e){for(var t=1;t<arguments.length;t++){var n=arguments[t];for(var r in n)Object.prototype.hasOwnProperty.call(n,r)&&(e[r]=n[r])}return e},u=n(5),l=r(u),c=n(34),p=r(c),f=n(207),d=r(f),h=n(206),m=r(h),v=n(86),g=({transitionName:v.nameShape.isRequired,transitionAppear:p.default.bool,transitionEnter:p.default.bool,transitionLeave:p.default.bool,transitionAppearTimeout:(0,v.transitionTimeout)("Appear"),transitionEnterTimeout:(0,v.transitionTimeout)("Enter"),transitionLeaveTimeout:(0,v.transitionTimeout)("Leave")},{transitionAppear:!1,transitionEnter:!0,transitionLeave:!0}),y=function(e){function t(){var n,r,a;o(this,t);for(var s=arguments.length,u=Array(s),c=0;c<s;c++)u[c]=arguments[c];return n=r=i(this,e.call.apply(e,[this].concat(u))),r._wrapChild=function(e){return l.default.createElement(m.default,{name:r.props.transitionName,appear:r.props.transitionAppear,enter:r.props.transitionEnter,leave:r.props.transitionLeave,appearTimeout:r.props.transitionAppearTimeout,enterTimeout:r.props.transitionEnterTimeout,leaveTimeout:r.props.transitionLeaveTimeout},e)},a=n,i(r,a)}return a(t,e),t.prototype.render=function(){return l.default.createElement(d.default,s({},this.props,{childFactory:this._wrapChild}))},t}(l.default.Component);y.displayName="CSSTransitionGroup",y.propTypes={},y.defaultProps=g,t.default=y,e.exports=t.default},function(e,t,n){"use strict";function r(e){return e&&e.__esModule?e:{default:e}}function o(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function i(e,t){if(!e)throw new ReferenceError("this hasn't been initialised - super() hasn't been called");return!t||"object"!=typeof t&&"function"!=typeof t?e:t}function a(e,t){if("function"!=typeof t&&null!==t)throw new TypeError("Super expression must either be null or a function, not "+typeof t);e.prototype=Object.create(t&&t.prototype,{constructor:{value:e,enumerable:!1,writable:!0,configurable:!0}}),t&&(Object.setPrototypeOf?Object.setPrototypeOf(e,t):e.__proto__=t)}function s(e,t){return w.length?w.forEach(function(n){return e.addEventListener(n,t,!1)}):setTimeout(t,0),function(){w.length&&w.forEach(function(n){return e.removeEventListener(n,t,!1)})}}t.__esModule=!0;var u=Object.assign||function(e){for(var t=1;t<arguments.length;t++){var n=arguments[t];for(var r in n)Object.prototype.hasOwnProperty.call(n,r)&&(e[r]=n[r])}return e},l=n(96),c=r(l),p=n(98),f=r(p),d=n(100),h=r(d),m=n(99),v=n(5),g=r(v),y=n(34),b=r(y),C=n(13),_=n(86),w=[];m.transitionEnd&&w.push(m.transitionEnd),m.animationEnd&&w.push(m.animationEnd);var E=({children:b.default.node,name:_.nameShape.isRequired,appear:b.default.bool,enter:b.default.bool,leave:b.default.bool,appearTimeout:b.default.number,enterTimeout:b.default.number,leaveTimeout:b.default.number},function(e){function t(){var n,r,a;o(this,t);for(var s=arguments.length,u=Array(s),l=0;l<s;l++)u[l]=arguments[l];return n=r=i(this,e.call.apply(e,[this].concat(u))),r.componentWillAppear=function(e){r.props.appear?r.transition("appear",e,r.props.appearTimeout):e()},r.componentWillEnter=function(e){r.props.enter?r.transition("enter",e,r.props.enterTimeout):e()},r.componentWillLeave=function(e){r.props.leave?r.transition("leave",e,r.props.leaveTimeout):e()},a=n,i(r,a)}return a(t,e),t.prototype.componentWillMount=function(){this.classNameAndNodeQueue=[],this.transitionTimeouts=[]},t.prototype.componentWillUnmount=function(){this.unmounted=!0,this.timeout&&clearTimeout(this.timeout),this.transitionTimeouts.forEach(function(e){clearTimeout(e)}),this.classNameAndNodeQueue.length=0},t.prototype.transition=function(e,t,n){var r=(0,C.findDOMNode)(this);if(!r)return void(t&&t());var o=this.props.name[e]||this.props.name+"-"+e,i=this.props.name[e+"Active"]||o+"-active",a=null,u=void 0;(0,c.default)(r,o),this.queueClassAndNode(i,r);var l=function(e){e&&e.target!==r||(clearTimeout(a),u&&u(),(0,f.default)(r,o),(0,f.default)(r,i),u&&u(),t&&t())};n?(a=setTimeout(l,n),this.transitionTimeouts.push(a)):m.transitionEnd&&(u=s(r,l))},t.prototype.queueClassAndNode=function(e,t){var n=this;this.classNameAndNodeQueue.push({className:e,node:t}),this.rafHandle||(this.rafHandle=(0,h.default)(function(){return n.flushClassNameAndNodeQueue()}))},t.prototype.flushClassNameAndNodeQueue=function(){this.unmounted||this.classNameAndNodeQueue.forEach(function(e){e.node.scrollTop,(0,c.default)(e.node,e.className)}),this.classNameAndNodeQueue.length=0,this.rafHandle=null},t.prototype.render=function(){var e=u({},this.props);return delete e.name,delete e.appear,delete e.enter,delete e.leave,delete e.appearTimeout,delete e.enterTimeout,delete e.leaveTimeout,delete e.children,g.default.cloneElement(g.default.Children.only(this.props.children),e)},t}(g.default.Component));E.displayName="CSSTransitionGroupChild",E.propTypes={},t.default=E,e.exports=t.default},function(e,t,n){"use strict";function r(e){return e&&e.__esModule?e:{default:e}}function o(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function i(e,t){if(!e)throw new ReferenceError("this hasn't been initialised - super() hasn't been called");return!t||"object"!=typeof t&&"function"!=typeof t?e:t}function a(e,t){if("function"!=typeof t&&null!==t)throw new TypeError("Super expression must either be null or a function, not "+typeof t);e.prototype=Object.create(t&&t.prototype,{constructor:{value:e,enumerable:!1,writable:!0,configurable:!0}}),t&&(Object.setPrototypeOf?Object.setPrototypeOf(e,t):e.__proto__=t)}t.__esModule=!0;var s=Object.assign||function(e){for(var t=1;t<arguments.length;t++){var n=arguments[t];for(var r in n)Object.prototype.hasOwnProperty.call(n,r)&&(e[r]=n[r])}return e},u=n(95),l=r(u),c=n(5),p=r(c),f=n(34),d=r(f),h=n(225),m=(r(h),n(210)),v=({component:d.default.any,childFactory:d.default.func,children:d.default.node},{component:"span",childFactory:function(e){return e}}),g=function(e){function t(n,r){o(this,t);var a=i(this,e.call(this,n,r));return a.performAppear=function(e,t){a.currentlyTransitioningKeys[e]=!0,t.componentWillAppear?t.componentWillAppear(a._handleDoneAppearing.bind(a,e,t)):a._handleDoneAppearing(e,t)},a._handleDoneAppearing=function(e,t){t.componentDidAppear&&t.componentDidAppear(),delete a.currentlyTransitioningKeys[e];var n=(0,m.getChildMapping)(a.props.children);n&&n.hasOwnProperty(e)||a.performLeave(e,t)},a.performEnter=function(e,t){a.currentlyTransitioningKeys[e]=!0,t.componentWillEnter?t.componentWillEnter(a._handleDoneEntering.bind(a,e,t)):a._handleDoneEntering(e,t)},a._handleDoneEntering=function(e,t){t.componentDidEnter&&t.componentDidEnter(),delete a.currentlyTransitioningKeys[e];var n=(0,m.getChildMapping)(a.props.children);n&&n.hasOwnProperty(e)||a.performLeave(e,t)},a.performLeave=function(e,t){a.currentlyTransitioningKeys[e]=!0,t.componentWillLeave?t.componentWillLeave(a._handleDoneLeaving.bind(a,e,t)):a._handleDoneLeaving(e,t)},a._handleDoneLeaving=function(e,t){t.componentDidLeave&&t.componentDidLeave(),delete a.currentlyTransitioningKeys[e];var n=(0,m.getChildMapping)(a.props.children);n&&n.hasOwnProperty(e)?a.keysToEnter.push(e):a.setState(function(t){var n=s({},t.children);return delete n[e],{children:n}})},a.childRefs=Object.create(null),a.state={children:(0,m.getChildMapping)(n.children)},a}return a(t,e),t.prototype.componentWillMount=function(){this.currentlyTransitioningKeys={},this.keysToEnter=[],this.keysToLeave=[]},t.prototype.componentDidMount=function(){var e=this.state.children;for(var t in e)e[t]&&this.performAppear(t,this.childRefs[t])},t.prototype.componentWillReceiveProps=function(e){var t=(0,m.getChildMapping)(e.children),n=this.state.children;this.setState({children:(0,m.mergeChildMappings)(n,t)});for(var r in t){var o=n&&n.hasOwnProperty(r);!t[r]||o||this.currentlyTransitioningKeys[r]||this.keysToEnter.push(r)}for(var i in n){var a=t&&t.hasOwnProperty(i);!n[i]||a||this.currentlyTransitioningKeys[i]||this.keysToLeave.push(i)}},t.prototype.componentDidUpdate=function(){var e=this,t=this.keysToEnter;this.keysToEnter=[],t.forEach(function(t){return e.performEnter(t,e.childRefs[t])});var n=this.keysToLeave;this.keysToLeave=[],n.forEach(function(t){return e.performLeave(t,e.childRefs[t])})},t.prototype.render=function(){var e=this,t=[],n=function(n){var r=e.state.children[n];if(r){var o="string"!=typeof r.ref,i=e.props.childFactory(r),a=function(t){e.childRefs[n]=t};i===r&&o&&(a=(0,l.default)(r.ref,a)),t.push(p.default.cloneElement(i,{key:n,ref:a}))}};for(var r in this.state.children)n(r);var o=s({},this.props);return delete o.transitionLeave,delete o.transitionName,delete o.transitionAppear,delete o.transitionEnter,delete o.childFactory,delete o.transitionLeaveTimeout,delete o.transitionEnterTimeout,delete o.transitionAppearTimeout,delete o.component,p.default.createElement(this.props.component,o,t)},t}(p.default.Component);g.displayName="TransitionGroup",g.propTypes={},g.defaultProps=v,t.default=g,e.exports=t.default},function(e,t,n){"use strict";function r(){}function o(){}var i=n(209);o.resetWarningCache=r,e.exports=function(){function e(e,t,n,r,o,a){if(a!==i){var s=new Error("Calling PropTypes validators directly is not supported by the `prop-types` package. Use PropTypes.checkPropTypes() to call them. Read more at http://fb.me/use-check-prop-types");throw s.name="Invariant Violation",s}}function t(){return e}e.isRequired=e;var n={array:e,bigint:e,bool:e,func:e,number:e,object:e,string:e,symbol:e,any:e,arrayOf:t,element:e,elementType:e,instanceOf:t,node:e,objectOf:t,oneOf:t,oneOfType:t,shape:t,exact:t,checkPropTypes:o,resetWarningCache:r};return n.PropTypes=n,n}},function(e,t){"use strict";var n="SECRET_DO_NOT_PASS_THIS_OR_YOU_WILL_BE_FIRED";e.exports=n},function(e,t,n){"use strict";function r(e){if(!e)return e;var t={};return i.Children.map(e,function(e){return e}).forEach(function(e){t[e.key]=e}),t}function o(e,t){function n(n){return t.hasOwnProperty(n)?t[n]:e[n]}e=e||{},t=t||{};var r={},o=[];for(var i in e)t.hasOwnProperty(i)?o.length&&(r[i]=o,o=[]):o.push(i);var a=void 0,s={};for(var u in t){if(r.hasOwnProperty(u))for(a=0;a<r[u].length;a++){var l=r[u][a];s[r[u][a]]=n(l)}s[u]=n(u)}for(a=0;a<o.length;a++)s[o[a]]=n(o[a]);return s}t.__esModule=!0,t.getChildMapping=r,t.mergeChildMappings=o;var i=n(5)},41,[228,22],function(e,t,n){"use strict";function r(e){return(""+e).replace(C,"$&/")}function o(e,t){this.func=e,this.context=t,this.count=0}function i(e,t,n){var r=e.func,o=e.context;r.call(o,t,e.count++)}function a(e,t,n){if(null==e)return e;var r=o.getPooled(t,n);g(e,i,r),o.release(r)}function s(e,t,n,r){this.result=e,this.keyPrefix=t,this.func=n,this.context=r,this.count=0}function u(e,t,n){var o=e.result,i=e.keyPrefix,a=e.func,s=e.context,u=a.call(s,t,e.count++);Array.isArray(u)?l(u,o,n,v.thatReturnsArgument):null!=u&&(m.isValidElement(u)&&(u=m.cloneAndReplaceKey(u,i+(!u.key||t&&t.key===u.key?"":r(u.key)+"/")+n)),o.push(u))}function l(e,t,n,o,i){var a="";null!=n&&(a=r(n)+"/");var l=s.getPooled(t,a,o,i);g(e,u,l),s.release(l)}function c(e,t,n){if(null==e)return e;var r=[];return l(e,r,null,t,n),r}function p(e,t,n){return null}function f(e,t){return g(e,p,null)}function d(e){var t=[];return l(e,t,null,v.thatReturnsArgument),t}var h=n(212),m=n(21),v=n(8),g=n(223),y=h.twoArgumentPooler,b=h.fourArgumentPooler,C=/\/+/g;o.prototype.destructor=function(){this.func=null,this.context=null,this.count=0},h.addPoolingTo(o,y),s.prototype.destructor=function(){this.result=null,this.keyPrefix=null,this.func=null,this.context=null,this.count=0},h.addPoolingTo(s,b);var _={forEach:a,map:c,mapIntoWithKeyPrefixInternal:l,count:f,toArray:d};e.exports=_},function(e,t,n){"use strict";function r(e){return e}function o(e,t){var n=C.hasOwnProperty(t)?C[t]:null;w.hasOwnProperty(t)&&("OVERRIDE_BASE"!==n?f("73",t):void 0),e&&("DEFINE_MANY"!==n&&"DEFINE_MANY_MERGED"!==n?f("74",t):void 0)}function i(e,t){if(t){"function"==typeof t?f("75"):void 0,m.isValidElement(t)?f("76"):void 0;var n=e.prototype,r=n.__reactAutoBindPairs;t.hasOwnProperty(y)&&_.mixins(e,t.mixins);for(var i in t)if(t.hasOwnProperty(i)&&i!==y){var a=t[i],s=n.hasOwnProperty(i);if(o(s,i),_.hasOwnProperty(i))_[i](e,a);else{var c=C.hasOwnProperty(i),p="function"==typeof a,d=p&&!c&&!s&&t.autobind!==!1;if(d)r.push(i,a),n[i]=a;else if(s){var h=C[i];!c||"DEFINE_MANY_MERGED"!==h&&"DEFINE_MANY"!==h?f("77",h,i):void 0,"DEFINE_MANY_MERGED"===h?n[i]=u(n[i],a):"DEFINE_MANY"===h&&(n[i]=l(n[i],a))}else n[i]=a}}}else;}function a(e,t){if(t)for(var n in t){var r=t[n];if(t.hasOwnProperty(n)){var o=n in _;o?f("78",n):void 0;var i=n in e;i?f("79",n):void 0,e[n]=r}}}function s(e,t){e&&t&&"object"==typeof e&&"object"==typeof t?void 0:f("80");for(var n in t)t.hasOwnProperty(n)&&(void 0!==e[n]?f("81",n):void 0,e[n]=t[n]);return e}function u(e,t){return function(){var n=e.apply(this,arguments),r=t.apply(this,arguments);if(null==n)return r;if(null==r)return n;var o={};return s(o,n),s(o,r),o}}function l(e,t){return function(){e.apply(this,arguments),t.apply(this,arguments)}}function c(e,t){var n=t.bind(e);return n}function p(e){for(var t=e.__reactAutoBindPairs,n=0;n<t.length;n+=2){var r=t[n],o=t[n+1];e[r]=c(e,o)}}var f=n(22),d=n(4),h=n(54),m=n(21),v=(n(216),n(55)),g=n(23),y=(n(1),n(2),"mixins"),b=[],C={mixins:"DEFINE_MANY",statics:"DEFINE_MANY",propTypes:"DEFINE_MANY",contextTypes:"DEFINE_MANY",childContextTypes:"DEFINE_MANY",getDefaultProps:"DEFINE_MANY_MERGED",getInitialState:"DEFINE_MANY_MERGED",getChildContext:"DEFINE_MANY_MERGED",render:"DEFINE_ONCE",componentWillMount:"DEFINE_MANY",componentDidMount:"DEFINE_MANY",componentWillReceiveProps:"DEFINE_MANY",shouldComponentUpdate:"DEFINE_ONCE",componentWillUpdate:"DEFINE_MANY",componentDidUpdate:"DEFINE_MANY",componentWillUnmount:"DEFINE_MANY",updateComponent:"OVERRIDE_BASE"},_={displayName:function(e,t){e.displayName=t},mixins:function(e,t){if(t)for(var n=0;n<t.length;n++)i(e,t[n])},childContextTypes:function(e,t){e.childContextTypes=d({},e.childContextTypes,t)},contextTypes:function(e,t){e.contextTypes=d({},e.contextTypes,t)},getDefaultProps:function(e,t){e.getDefaultProps?e.getDefaultProps=u(e.getDefaultProps,t):e.getDefaultProps=t},propTypes:function(e,t){e.propTypes=d({},e.propTypes,t)},statics:function(e,t){a(e,t)},autobind:function(){}},w={replaceState:function(e,t){this.updater.enqueueReplaceState(this,e),t&&this.updater.enqueueCallback(this,t,"replaceState")},isMounted:function(){return this.updater.isMounted(this)}},E=function(){};d(E.prototype,h.prototype,w);var T={createClass:function(e){var t=r(function(e,n,r){this.__reactAutoBindPairs.length&&p(this),this.props=e,this.context=n,this.refs=g,this.updater=r||v,this.state=null;var o=this.getInitialState?this.getInitialState():null;"object"!=typeof o||Array.isArray(o)?f("82",t.displayName||"ReactCompositeComponent"):void 0,this.state=o});t.prototype=new E,t.prototype.constructor=t,t.prototype.__reactAutoBindPairs=[],b.forEach(i.bind(null,t)),i(t,e),t.getDefaultProps&&(t.defaultProps=t.getDefaultProps()),t.prototype.render?void 0:f("83");for(var n in C)t.prototype[n]||(t.prototype[n]=null);return t},injection:{injectMixin:function(e){b.push(e)}}};e.exports=T},function(e,t,n){"use strict";var r=n(21),o=r.createFactory,i={a:o("a"),abbr:o("abbr"),address:o("address"),area:o("area"),article:o("article"),aside:o("aside"),audio:o("audio"),b:o("b"),base:o("base"),bdi:o("bdi"),bdo:o("bdo"),big:o("big"),blockquote:o("blockquote"),body:o("body"),br:o("br"),button:o("button"),canvas:o("canvas"),caption:o("caption"),cite:o("cite"),code:o("code"),col:o("col"),colgroup:o("colgroup"),data:o("data"),datalist:o("datalist"),dd:o("dd"),del:o("del"),details:o("details"),dfn:o("dfn"),dialog:o("dialog"),div:o("div"),dl:o("dl"),dt:o("dt"),em:o("em"),embed:o("embed"),fieldset:o("fieldset"),figcaption:o("figcaption"),figure:o("figure"),footer:o("footer"),form:o("form"),h1:o("h1"),h2:o("h2"),h3:o("h3"),h4:o("h4"),h5:o("h5"),h6:o("h6"),head:o("head"),header:o("header"),hgroup:o("hgroup"),hr:o("hr"),html:o("html"),i:o("i"),iframe:o("iframe"),img:o("img"),input:o("input"),ins:o("ins"),kbd:o("kbd"),keygen:o("keygen"),label:o("label"),legend:o("legend"),li:o("li"),link:o("link"),main:o("main"),map:o("map"),mark:o("mark"),menu:o("menu"),menuitem:o("menuitem"),meta:o("meta"),meter:o("meter"),nav:o("nav"),noscript:o("noscript"),object:o("object"),ol:o("ol"),optgroup:o("optgroup"),option:o("option"),output:o("output"),p:o("p"),param:o("param"),picture:o("picture"),pre:o("pre"),progress:o("progress"),q:o("q"),rp:o("rp"),rt:o("rt"),ruby:o("ruby"),s:o("s"),samp:o("samp"),script:o("script"),section:o("section"),select:o("select"),small:o("small"),source:o("source"),span:o("span"),strong:o("strong"),style:o("style"),sub:o("sub"),summary:o("summary"),sup:o("sup"),table:o("table"),tbody:o("tbody"),td:o("td"),textarea:o("textarea"),tfoot:o("tfoot"),th:o("th"),thead:o("thead"),time:o("time"),title:o("title"),tr:o("tr"),track:o("track"),u:o("u"),ul:o("ul"),var:o("var"),video:o("video"),wbr:o("wbr"),circle:o("circle"),clipPath:o("clipPath"),defs:o("defs"),ellipse:o("ellipse"),g:o("g"),image:o("image"),line:o("line"),linearGradient:o("linearGradient"),mask:o("mask"),path:o("path"),pattern:o("pattern"),polygon:o("polygon"),polyline:o("polyline"),radialGradient:o("radialGradient"),rect:o("rect"),stop:o("stop"),svg:o("svg"),text:o("text"),tspan:o("tspan")};e.exports=i},function(e,t,n){"use strict";var r={};e.exports=r},function(e,t,n){"use strict";var r=n(21),o=r.isValidElement,i=n(62);e.exports=i(o)},function(e,t,n){"use strict";function r(e,t,n){this.props=e,this.context=t,this.refs=u,this.updater=n||s}function o(){}var i=n(4),a=n(54),s=n(55),u=n(23);o.prototype=a.prototype,r.prototype=new o,r.prototype.constructor=r,i(r.prototype,a.prototype),r.prototype.isPureReactComponent=!0,e.exports=r},164,183,function(e,t){"use strict";function n(){return r++}var r=1;e.exports=n},function(e,t,n){"use strict";function r(e){return i.isValidElement(e)?void 0:o("143"),e}var o=n(22),i=n(21);n(1);e.exports=r},function(e,t,n){"use strict";function r(e,t){return e&&"object"==typeof e&&null!=e.key?l.escape(e.key):t.toString(36)}function o(e,t,n,i){var f=typeof e;if("undefined"!==f&&"boolean"!==f||(e=null),null===e||"string"===f||"number"===f||"object"===f&&e.$$typeof===s)return n(i,e,""===t?c+r(e,0):t),1;var d,h,m=0,v=""===t?c:t+p;if(Array.isArray(e))for(var g=0;g<e.length;g++)d=e[g],h=v+r(d,g),m+=o(d,h,n,i);else{var y=u(e);if(y){var b,C=y.call(e);if(y!==e.entries)for(var _=0;!(b=C.next()).done;)d=b.value,h=v+r(d,_++),m+=o(d,h,n,i);else for(;!(b=C.next()).done;){var w=b.value;w&&(d=w[1],h=v+l.escape(w[0])+p+r(d,0),m+=o(d,h,n,i))}}else if("object"===f){var E="",T=String(e);a("31","[object Object]"===T?"object with keys {"+Object.keys(e).join(", ")+"}":T,E)}}return m}function i(e,t,n){return null==e?0:o(e,"",t,n)}var a=n(22),s=(n(12),n(88)),u=n(220),l=(n(1),n(211)),c=(n(2),"."),p=":";e.exports=i},function(e,t,n){var r,o,i;!function(n,a){o=[],r=a,i="function"==typeof r?r.apply(t,o):r,!(void 0!==i&&(e.exports=i))}(this,function(){"use strict";function e(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function t(e){var n=e.getBoundingClientRect(),r={};for(var o in n)r[o]=n[o];try{if(e.ownerDocument!==document){var i=e.ownerDocument.defaultView.frameElement;if(i){var a=t(i);r.top+=a.top,r.bottom+=a.top,r.left+=a.left,r.right+=a.left}}}catch(e){}return r}function n(e){var t=getComputedStyle(e)||{},n=t.position,r=[];if("fixed"===n)return[e];for(var o=e;(o=o.parentNode)&&o&&1===o.nodeType;){var i=void 0;try{i=getComputedStyle(o)}catch(e){}if("undefined"==typeof i||null===i)return r.push(o),r;var a=i,s=a.overflow,u=a.overflowX,l=a.overflowY;/(auto|scroll|overlay)/.test(s+l+u)&&("absolute"!==n||["relative","absolute","fixed"].indexOf(i.position)>=0)&&r.push(o)}return r.push(e.ownerDocument.body),e.ownerDocument!==document&&r.push(e.ownerDocument.defaultView),r}function r(){w&&document.body.removeChild(w),w=null}function o(e){var n=void 0;e===document?(n=document,e=document.documentElement):n=e.ownerDocument;var r=n.documentElement,o=t(e),i=x();return o.top-=i.top,o.left-=i.left,"undefined"==typeof o.width&&(o.width=document.body.scrollWidth-o.left-o.right),"undefined"==typeof o.height&&(o.height=document.body.scrollHeight-o.top-o.bottom),o.top=o.top-r.clientTop,o.left=o.left-r.clientLeft,
-o.right=n.body.clientWidth-o.width-o.left,o.bottom=n.body.clientHeight-o.height-o.top,o}function i(e){return e.offsetParent||document.documentElement}function a(){if(O)return O;var e=document.createElement("div");e.style.width="100%",e.style.height="200px";var t=document.createElement("div");s(t.style,{position:"absolute",top:0,left:0,pointerEvents:"none",visibility:"hidden",width:"200px",height:"150px",overflow:"hidden"}),t.appendChild(e),document.body.appendChild(t);var n=e.offsetWidth;t.style.overflow="scroll";var r=e.offsetWidth;n===r&&(r=t.clientWidth),document.body.removeChild(t);var o=n-r;return O={width:o,height:o}}function s(){var e=arguments.length<=0||void 0===arguments[0]?{}:arguments[0],t=[];return Array.prototype.push.apply(t,arguments),t.slice(1).forEach(function(t){if(t)for(var n in t)({}).hasOwnProperty.call(t,n)&&(e[n]=t[n])}),e}function u(e,t){if("undefined"!=typeof e.classList)t.split(" ").forEach(function(t){t.trim()&&e.classList.remove(t)});else{var n=new RegExp("(^| )"+t.split(" ").join("|")+"( |$)","gi"),r=p(e).replace(n," ");f(e,r)}}function l(e,t){if("undefined"!=typeof e.classList)t.split(" ").forEach(function(t){t.trim()&&e.classList.add(t)});else{u(e,t);var n=p(e)+(" "+t);f(e,n)}}function c(e,t){if("undefined"!=typeof e.classList)return e.classList.contains(t);var n=p(e);return new RegExp("(^| )"+t+"( |$)","gi").test(n)}function p(e){return e.className instanceof e.ownerDocument.defaultView.SVGAnimatedString?e.className.baseVal:e.className}function f(e,t){e.setAttribute("class",t)}function d(e,t,n){n.forEach(function(n){t.indexOf(n)===-1&&c(e,n)&&u(e,n)}),t.forEach(function(t){c(e,t)||l(e,t)})}function e(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function h(e,t){if("function"!=typeof t&&null!==t)throw new TypeError("Super expression must either be null or a function, not "+typeof t);e.prototype=Object.create(t&&t.prototype,{constructor:{value:e,enumerable:!1,writable:!0,configurable:!0}}),t&&(Object.setPrototypeOf?Object.setPrototypeOf(e,t):e.__proto__=t)}function m(e,t){var n=arguments.length<=2||void 0===arguments[2]?1:arguments[2];return e+n>=t&&t>=e-n}function v(){return"object"==typeof performance&&"function"==typeof performance.now?performance.now():+new Date}function g(){for(var e={top:0,left:0},t=arguments.length,n=Array(t),r=0;r<t;r++)n[r]=arguments[r];return n.forEach(function(t){var n=t.top,r=t.left;"string"==typeof n&&(n=parseFloat(n,10)),"string"==typeof r&&(r=parseFloat(r,10)),e.top+=n,e.left+=r}),e}function y(e,t){return"string"==typeof e.left&&e.left.indexOf("%")!==-1&&(e.left=parseFloat(e.left,10)/100*t.width),"string"==typeof e.top&&e.top.indexOf("%")!==-1&&(e.top=parseFloat(e.top,10)/100*t.height),e}function b(e,t){return"scrollParent"===t?t=e.scrollParents[0]:"window"===t&&(t=[pageXOffset,pageYOffset,innerWidth+pageXOffset,innerHeight+pageYOffset]),t===document&&(t=t.documentElement),"undefined"!=typeof t.nodeType&&!function(){var e=t,n=o(t),r=n,i=getComputedStyle(t);if(t=[r.left,r.top,n.width+r.left,n.height+r.top],e.ownerDocument!==document){var a=e.ownerDocument.defaultView;t[0]+=a.pageXOffset,t[1]+=a.pageYOffset,t[2]+=a.pageXOffset,t[3]+=a.pageYOffset}K.forEach(function(e,n){e=e[0].toUpperCase()+e.substr(1),"Top"===e||"Left"===e?t[n]+=parseFloat(i["border"+e+"Width"]):t[n]-=parseFloat(i["border"+e+"Width"])})}(),t}var C=function(){function e(e,t){for(var n=0;n<t.length;n++){var r=t[n];r.enumerable=r.enumerable||!1,r.configurable=!0,"value"in r&&(r.writable=!0),Object.defineProperty(e,r.key,r)}}return function(t,n,r){return n&&e(t.prototype,n),r&&e(t,r),t}}(),_=void 0;"undefined"==typeof _&&(_={modules:[]});var w=null,E=function(){var e=0;return function(){return++e}}(),T={},x=function(){var e=w;e&&document.body.contains(e)||(e=document.createElement("div"),e.setAttribute("data-tether-id",E()),s(e.style,{top:0,left:0,position:"absolute"}),document.body.appendChild(e),w=e);var n=e.getAttribute("data-tether-id");return"undefined"==typeof T[n]&&(T[n]=t(e),k(function(){delete T[n]})),T[n]},O=null,P=[],k=function(e){P.push(e)},S=function(){for(var e=void 0;e=P.pop();)e()},N=function(){function t(){e(this,t)}return C(t,[{key:"on",value:function(e,t,n){var r=!(arguments.length<=3||void 0===arguments[3])&&arguments[3];"undefined"==typeof this.bindings&&(this.bindings={}),"undefined"==typeof this.bindings[e]&&(this.bindings[e]=[]),this.bindings[e].push({handler:t,ctx:n,once:r})}},{key:"once",value:function(e,t,n){this.on(e,t,n,!0)}},{key:"off",value:function(e,t){if("undefined"!=typeof this.bindings&&"undefined"!=typeof this.bindings[e])if("undefined"==typeof t)delete this.bindings[e];else for(var n=0;n<this.bindings[e].length;)this.bindings[e][n].handler===t?this.bindings[e].splice(n,1):++n}},{key:"trigger",value:function(e){if("undefined"!=typeof this.bindings&&this.bindings[e]){for(var t=0,n=arguments.length,r=Array(n>1?n-1:0),o=1;o<n;o++)r[o-1]=arguments[o];for(;t<this.bindings[e].length;){var i=this.bindings[e][t],a=i.handler,s=i.ctx,u=i.once,l=s;"undefined"==typeof l&&(l=this),a.apply(l,r),u?this.bindings[e].splice(t,1):++t}}}}]),t}();_.Utils={getActualBoundingClientRect:t,getScrollParents:n,getBounds:o,getOffsetParent:i,extend:s,addClass:l,removeClass:u,hasClass:c,updateClasses:d,defer:k,flush:S,uniqueId:E,Evented:N,getScrollBarSize:a,removeUtilElements:r};var M=function(){function e(e,t){var n=[],r=!0,o=!1,i=void 0;try{for(var a,s=e[Symbol.iterator]();!(r=(a=s.next()).done)&&(n.push(a.value),!t||n.length!==t);r=!0);}catch(e){o=!0,i=e}finally{try{!r&&s.return&&s.return()}finally{if(o)throw i}}return n}return function(t,n){if(Array.isArray(t))return t;if(Symbol.iterator in Object(t))return e(t,n);throw new TypeError("Invalid attempt to destructure non-iterable instance")}}(),C=function(){function e(e,t){for(var n=0;n<t.length;n++){var r=t[n];r.enumerable=r.enumerable||!1,r.configurable=!0,"value"in r&&(r.writable=!0),Object.defineProperty(e,r.key,r)}}return function(t,n,r){return n&&e(t.prototype,n),r&&e(t,r),t}}(),A=function(e,t,n){for(var r=!0;r;){var o=e,i=t,a=n;r=!1,null===o&&(o=Function.prototype);var s=Object.getOwnPropertyDescriptor(o,i);if(void 0!==s){if("value"in s)return s.value;var u=s.get;if(void 0===u)return;return u.call(a)}var l=Object.getPrototypeOf(o);if(null===l)return;e=l,t=i,n=a,r=!0,s=l=void 0}};if("undefined"==typeof _)throw new Error("You must include the utils.js file before tether.js");var I=_.Utils,n=I.getScrollParents,o=I.getBounds,i=I.getOffsetParent,s=I.extend,l=I.addClass,u=I.removeClass,d=I.updateClasses,k=I.defer,S=I.flush,a=I.getScrollBarSize,r=I.removeUtilElements,D=function(){if("undefined"==typeof document)return"";for(var e=document.createElement("div"),t=["transform","WebkitTransform","OTransform","MozTransform","msTransform"],n=0;n<t.length;++n){var r=t[n];if(void 0!==e.style[r])return r}}(),R=[],L=function(){R.forEach(function(e){e.position(!1)}),S()};!function(){var e=null,t=null,n=null,r=function r(){return"undefined"!=typeof t&&t>16?(t=Math.min(t-16,250),void(n=setTimeout(r,250))):void("undefined"!=typeof e&&v()-e<10||(null!=n&&(clearTimeout(n),n=null),e=v(),L(),t=v()-e))};"undefined"!=typeof window&&"undefined"!=typeof window.addEventListener&&["resize","scroll","touchmove"].forEach(function(e){window.addEventListener(e,r)})}();var U={center:"center",left:"right",right:"left"},F={middle:"middle",top:"bottom",bottom:"top"},j={top:0,left:0,middle:"50%",center:"50%",bottom:"100%",right:"100%"},B=function(e,t){var n=e.left,r=e.top;return"auto"===n&&(n=U[t.left]),"auto"===r&&(r=F[t.top]),{left:n,top:r}},V=function(e){var t=e.left,n=e.top;return"undefined"!=typeof j[e.left]&&(t=j[e.left]),"undefined"!=typeof j[e.top]&&(n=j[e.top]),{left:t,top:n}},W=function(e){var t=e.split(" "),n=M(t,2),r=n[0],o=n[1];return{top:r,left:o}},H=W,q=function(t){function c(t){var n=this;e(this,c),A(Object.getPrototypeOf(c.prototype),"constructor",this).call(this),this.position=this.position.bind(this),R.push(this),this.history=[],this.setOptions(t,!1),_.modules.forEach(function(e){"undefined"!=typeof e.initialize&&e.initialize.call(n)}),this.position()}return h(c,t),C(c,[{key:"getClass",value:function(){var e=arguments.length<=0||void 0===arguments[0]?"":arguments[0],t=this.options.classes;return"undefined"!=typeof t&&t[e]?this.options.classes[e]:this.options.classPrefix?this.options.classPrefix+"-"+e:e}},{key:"setOptions",value:function(e){var t=this,r=arguments.length<=1||void 0===arguments[1]||arguments[1],o={offset:"0 0",targetOffset:"0 0",targetAttachment:"auto auto",classPrefix:"tether"};this.options=s(o,e);var i=this.options,a=i.element,u=i.target,c=i.targetModifier;if(this.element=a,this.target=u,this.targetModifier=c,"viewport"===this.target?(this.target=document.body,this.targetModifier="visible"):"scroll-handle"===this.target&&(this.target=document.body,this.targetModifier="scroll-handle"),["element","target"].forEach(function(e){if("undefined"==typeof t[e])throw new Error("Tether Error: Both element and target must be defined");"undefined"!=typeof t[e].jquery?t[e]=t[e][0]:"string"==typeof t[e]&&(t[e]=document.querySelector(t[e]))}),l(this.element,this.getClass("element")),this.options.addTargetClasses!==!1&&l(this.target,this.getClass("target")),!this.options.attachment)throw new Error("Tether Error: You must provide an attachment");this.targetAttachment=H(this.options.targetAttachment),this.attachment=H(this.options.attachment),this.offset=W(this.options.offset),this.targetOffset=W(this.options.targetOffset),"undefined"!=typeof this.scrollParents&&this.disable(),"scroll-handle"===this.targetModifier?this.scrollParents=[this.target]:this.scrollParents=n(this.target),this.options.enabled!==!1&&this.enable(r)}},{key:"getTargetBounds",value:function(){if("undefined"==typeof this.targetModifier)return o(this.target);if("visible"===this.targetModifier){if(this.target===document.body)return{top:pageYOffset,left:pageXOffset,height:innerHeight,width:innerWidth};var e=o(this.target),t={height:e.height,width:e.width,top:e.top,left:e.left};return t.height=Math.min(t.height,e.height-(pageYOffset-e.top)),t.height=Math.min(t.height,e.height-(e.top+e.height-(pageYOffset+innerHeight))),t.height=Math.min(innerHeight,t.height),t.height-=2,t.width=Math.min(t.width,e.width-(pageXOffset-e.left)),t.width=Math.min(t.width,e.width-(e.left+e.width-(pageXOffset+innerWidth))),t.width=Math.min(innerWidth,t.width),t.width-=2,t.top<pageYOffset&&(t.top=pageYOffset),t.left<pageXOffset&&(t.left=pageXOffset),t}if("scroll-handle"===this.targetModifier){var e=void 0,n=this.target;n===document.body?(n=document.documentElement,e={left:pageXOffset,top:pageYOffset,height:innerHeight,width:innerWidth}):e=o(n);var r=getComputedStyle(n),i=n.scrollWidth>n.clientWidth||[r.overflow,r.overflowX].indexOf("scroll")>=0||this.target!==document.body,a=0;i&&(a=15);var s=e.height-parseFloat(r.borderTopWidth)-parseFloat(r.borderBottomWidth)-a,t={width:15,height:.975*s*(s/n.scrollHeight),left:e.left+e.width-parseFloat(r.borderLeftWidth)-15},u=0;s<408&&this.target===document.body&&(u=-11e-5*Math.pow(s,2)-.00727*s+22.58),this.target!==document.body&&(t.height=Math.max(t.height,24));var l=this.target.scrollTop/(n.scrollHeight-s);return t.top=l*(s-t.height-u)+e.top+parseFloat(r.borderTopWidth),this.target===document.body&&(t.height=Math.max(t.height,24)),t}}},{key:"clearCache",value:function(){this._cache={}}},{key:"cache",value:function(e,t){return"undefined"==typeof this._cache&&(this._cache={}),"undefined"==typeof this._cache[e]&&(this._cache[e]=t.call(this)),this._cache[e]}},{key:"enable",value:function(){var e=this,t=arguments.length<=0||void 0===arguments[0]||arguments[0];this.options.addTargetClasses!==!1&&l(this.target,this.getClass("enabled")),l(this.element,this.getClass("enabled")),this.enabled=!0,this.scrollParents.forEach(function(t){t!==e.target.ownerDocument&&t.addEventListener("scroll",e.position)}),t&&this.position()}},{key:"disable",value:function(){var e=this;u(this.target,this.getClass("enabled")),u(this.element,this.getClass("enabled")),this.enabled=!1,"undefined"!=typeof this.scrollParents&&this.scrollParents.forEach(function(t){t.removeEventListener("scroll",e.position)})}},{key:"destroy",value:function(){var e=this;this.disable(),R.forEach(function(t,n){t===e&&R.splice(n,1)}),0===R.length&&r()}},{key:"updateAttachClasses",value:function(e,t){var n=this;e=e||this.attachment,t=t||this.targetAttachment;var r=["left","top","bottom","right","middle","center"];"undefined"!=typeof this._addAttachClasses&&this._addAttachClasses.length&&this._addAttachClasses.splice(0,this._addAttachClasses.length),"undefined"==typeof this._addAttachClasses&&(this._addAttachClasses=[]);var o=this._addAttachClasses;e.top&&o.push(this.getClass("element-attached")+"-"+e.top),e.left&&o.push(this.getClass("element-attached")+"-"+e.left),t.top&&o.push(this.getClass("target-attached")+"-"+t.top),t.left&&o.push(this.getClass("target-attached")+"-"+t.left);var i=[];r.forEach(function(e){i.push(n.getClass("element-attached")+"-"+e),i.push(n.getClass("target-attached")+"-"+e)}),k(function(){"undefined"!=typeof n._addAttachClasses&&(d(n.element,n._addAttachClasses,i),n.options.addTargetClasses!==!1&&d(n.target,n._addAttachClasses,i),delete n._addAttachClasses)})}},{key:"position",value:function(){var e=this,t=arguments.length<=0||void 0===arguments[0]||arguments[0];if(this.enabled){this.clearCache();var n=B(this.targetAttachment,this.attachment);this.updateAttachClasses(this.attachment,n);var r=this.cache("element-bounds",function(){return o(e.element)}),s=r.width,u=r.height;if(0===s&&0===u&&"undefined"!=typeof this.lastSize){var l=this.lastSize;s=l.width,u=l.height}else this.lastSize={width:s,height:u};var c=this.cache("target-bounds",function(){return e.getTargetBounds()}),p=c,f=y(V(this.attachment),{width:s,height:u}),d=y(V(n),p),h=y(this.offset,{width:s,height:u}),m=y(this.targetOffset,p);f=g(f,h),d=g(d,m);for(var v=c.left+d.left-f.left,b=c.top+d.top-f.top,C=0;C<_.modules.length;++C){var w=_.modules[C],E=w.position.call(this,{left:v,top:b,targetAttachment:n,targetPos:c,elementPos:r,offset:f,targetOffset:d,manualOffset:h,manualTargetOffset:m,scrollbarSize:P,attachment:this.attachment});if(E===!1)return!1;"undefined"!=typeof E&&"object"==typeof E&&(b=E.top,v=E.left)}var T={page:{top:b,left:v},viewport:{top:b-pageYOffset,bottom:pageYOffset-b-u+innerHeight,left:v-pageXOffset,right:pageXOffset-v-s+innerWidth}},x=this.target.ownerDocument,O=x.defaultView,P=void 0;return O.innerHeight>x.documentElement.clientHeight&&(P=this.cache("scrollbar-size",a),T.viewport.bottom-=P.height),O.innerWidth>x.documentElement.clientWidth&&(P=this.cache("scrollbar-size",a),T.viewport.right-=P.width),["","static"].indexOf(x.body.style.position)!==-1&&["","static"].indexOf(x.body.parentElement.style.position)!==-1||(T.page.bottom=x.body.scrollHeight-b-u,T.page.right=x.body.scrollWidth-v-s),"undefined"!=typeof this.options.optimizations&&this.options.optimizations.moveElement!==!1&&"undefined"==typeof this.targetModifier&&!function(){var t=e.cache("target-offsetparent",function(){return i(e.target)}),n=e.cache("target-offsetparent-bounds",function(){return o(t)}),r=getComputedStyle(t),a=n,s={};if(["Top","Left","Bottom","Right"].forEach(function(e){s[e.toLowerCase()]=parseFloat(r["border"+e+"Width"])}),n.right=x.body.scrollWidth-n.left-a.width+s.right,n.bottom=x.body.scrollHeight-n.top-a.height+s.bottom,T.page.top>=n.top+s.top&&T.page.bottom>=n.bottom&&T.page.left>=n.left+s.left&&T.page.right>=n.right){var u=t.scrollTop,l=t.scrollLeft;T.offset={top:T.page.top-n.top+u-s.top,left:T.page.left-n.left+l-s.left}}}(),this.move(T),this.history.unshift(T),this.history.length>3&&this.history.pop(),t&&S(),!0}}},{key:"move",value:function(e){var t=this;if("undefined"!=typeof this.element.parentNode){var n={};for(var r in e){n[r]={};for(var o in e[r]){for(var a=!1,u=0;u<this.history.length;++u){var l=this.history[u];if("undefined"!=typeof l[r]&&!m(l[r][o],e[r][o])){a=!0;break}}a||(n[r][o]=!0)}}var c={top:"",left:"",right:"",bottom:""},p=function(e,n){var r="undefined"!=typeof t.options.optimizations,o=r?t.options.optimizations.gpu:null;if(o!==!1){var i=void 0,a=void 0;e.top?(c.top=0,i=n.top):(c.bottom=0,i=-n.bottom),e.left?(c.left=0,a=n.left):(c.right=0,a=-n.right),"number"==typeof window.devicePixelRatio&&devicePixelRatio%1===0&&(a=Math.round(a*devicePixelRatio)/devicePixelRatio,i=Math.round(i*devicePixelRatio)/devicePixelRatio),c[D]="translateX("+a+"px) translateY("+i+"px)","msTransform"!==D&&(c[D]+=" translateZ(0)")}else e.top?c.top=n.top+"px":c.bottom=n.bottom+"px",e.left?c.left=n.left+"px":c.right=n.right+"px"},f=!1;if((n.page.top||n.page.bottom)&&(n.page.left||n.page.right)?(c.position="absolute",p(n.page,e.page)):(n.viewport.top||n.viewport.bottom)&&(n.viewport.left||n.viewport.right)?(c.position="fixed",p(n.viewport,e.viewport)):"undefined"!=typeof n.offset&&n.offset.top&&n.offset.left?!function(){c.position="absolute";var r=t.cache("target-offsetparent",function(){return i(t.target)});i(t.element)!==r&&k(function(){t.element.parentNode.removeChild(t.element),r.appendChild(t.element)}),p(n.offset,e.offset),f=!0}():(c.position="absolute",p({top:!0,left:!0},e.page)),!f)if(this.options.bodyElement)this.element.parentNode!==this.options.bodyElement&&this.options.bodyElement.appendChild(this.element);else{for(var d=function(e){var t=e.ownerDocument,n=t.fullscreenElement||t.webkitFullscreenElement||t.mozFullScreenElement||t.msFullscreenElement;return n===e},h=!0,v=this.element.parentNode;v&&1===v.nodeType&&"BODY"!==v.tagName&&!d(v);){if("static"!==getComputedStyle(v).position){h=!1;break}v=v.parentNode}h||(this.element.parentNode.removeChild(this.element),this.element.ownerDocument.body.appendChild(this.element))}var g={},y=!1;for(var o in c){var b=c[o],C=this.element.style[o];C!==b&&(y=!0,g[o]=b)}y&&k(function(){s(t.element.style,g),t.trigger("repositioned")})}}}]),c}(N);q.modules=[],_.position=L;var z=s(q,_),M=function(){function e(e,t){var n=[],r=!0,o=!1,i=void 0;try{for(var a,s=e[Symbol.iterator]();!(r=(a=s.next()).done)&&(n.push(a.value),!t||n.length!==t);r=!0);}catch(e){o=!0,i=e}finally{try{!r&&s.return&&s.return()}finally{if(o)throw i}}return n}return function(t,n){if(Array.isArray(t))return t;if(Symbol.iterator in Object(t))return e(t,n);throw new TypeError("Invalid attempt to destructure non-iterable instance")}}(),I=_.Utils,o=I.getBounds,s=I.extend,d=I.updateClasses,k=I.defer,K=["left","top","right","bottom"];_.modules.push({position:function(e){var t=this,n=e.top,r=e.left,i=e.targetAttachment;if(!this.options.constraints)return!0;var a=this.cache("element-bounds",function(){return o(t.element)}),u=a.height,l=a.width;if(0===l&&0===u&&"undefined"!=typeof this.lastSize){var c=this.lastSize;l=c.width,u=c.height}var p=this.cache("target-bounds",function(){return t.getTargetBounds()}),f=p.height,h=p.width,m=[this.getClass("pinned"),this.getClass("out-of-bounds")];this.options.constraints.forEach(function(e){var t=e.outOfBoundsClass,n=e.pinnedClass;t&&m.push(t),n&&m.push(n)}),m.forEach(function(e){["left","top","right","bottom"].forEach(function(t){m.push(e+"-"+t)})});var v=[],g=s({},i),y=s({},this.attachment);return this.options.constraints.forEach(function(e){var o=e.to,a=e.attachment,s=e.pin;"undefined"==typeof a&&(a="");var c=void 0,p=void 0;if(a.indexOf(" ")>=0){var d=a.split(" "),m=M(d,2);p=m[0],c=m[1]}else c=p=a;var C=b(t,o);"target"!==p&&"both"!==p||(n<C[1]&&"top"===g.top&&(n+=f,g.top="bottom"),n+u>C[3]&&"bottom"===g.top&&(n-=f,g.top="top")),"together"===p&&("top"===g.top&&("bottom"===y.top&&n<C[1]?(n+=f,g.top="bottom",n+=u,y.top="top"):"top"===y.top&&n+u>C[3]&&n-(u-f)>=C[1]&&(n-=u-f,g.top="bottom",y.top="bottom")),"bottom"===g.top&&("top"===y.top&&n+u>C[3]?(n-=f,g.top="top",n-=u,y.top="bottom"):"bottom"===y.top&&n<C[1]&&n+(2*u-f)<=C[3]&&(n+=u-f,g.top="top",y.top="top")),"middle"===g.top&&(n+u>C[3]&&"top"===y.top?(n-=u,y.top="bottom"):n<C[1]&&"bottom"===y.top&&(n+=u,y.top="top"))),"target"!==c&&"both"!==c||(r<C[0]&&"left"===g.left&&(r+=h,g.left="right"),r+l>C[2]&&"right"===g.left&&(r-=h,g.left="left")),"together"===c&&(r<C[0]&&"left"===g.left?"right"===y.left?(r+=h,g.left="right",r+=l,y.left="left"):"left"===y.left&&(r+=h,g.left="right",r-=l,y.left="right"):r+l>C[2]&&"right"===g.left?"left"===y.left?(r-=h,g.left="left",r-=l,y.left="right"):"right"===y.left&&(r-=h,g.left="left",r+=l,y.left="left"):"center"===g.left&&(r+l>C[2]&&"left"===y.left?(r-=l,y.left="right"):r<C[0]&&"right"===y.left&&(r+=l,y.left="left"))),"element"!==p&&"both"!==p||(n<C[1]&&"bottom"===y.top&&(n+=u,y.top="top"),n+u>C[3]&&"top"===y.top&&(n-=u,y.top="bottom")),"element"!==c&&"both"!==c||(r<C[0]&&("right"===y.left?(r+=l,y.left="left"):"center"===y.left&&(r+=l/2,y.left="left")),r+l>C[2]&&("left"===y.left?(r-=l,y.left="right"):"center"===y.left&&(r-=l/2,y.left="right"))),"string"==typeof s?s=s.split(",").map(function(e){return e.trim()}):s===!0&&(s=["top","left","right","bottom"]),s=s||[];var _=[],w=[];n<C[1]&&(s.indexOf("top")>=0?(n=C[1],_.push("top")):w.push("top")),n+u>C[3]&&(s.indexOf("bottom")>=0?(n=C[3]-u,_.push("bottom")):w.push("bottom")),r<C[0]&&(s.indexOf("left")>=0?(r=C[0],_.push("left")):w.push("left")),r+l>C[2]&&(s.indexOf("right")>=0?(r=C[2]-l,_.push("right")):w.push("right")),_.length&&!function(){var e=void 0;e="undefined"!=typeof t.options.pinnedClass?t.options.pinnedClass:t.getClass("pinned"),v.push(e),_.forEach(function(t){v.push(e+"-"+t)})}(),w.length&&!function(){var e=void 0;e="undefined"!=typeof t.options.outOfBoundsClass?t.options.outOfBoundsClass:t.getClass("out-of-bounds"),v.push(e),w.forEach(function(t){v.push(e+"-"+t)})}(),(_.indexOf("left")>=0||_.indexOf("right")>=0)&&(y.left=g.left=!1),(_.indexOf("top")>=0||_.indexOf("bottom")>=0)&&(y.top=g.top=!1),g.top===i.top&&g.left===i.left&&y.top===t.attachment.top&&y.left===t.attachment.left||(t.updateAttachClasses(y,g),t.trigger("update",{attachment:y,targetAttachment:g}))}),k(function(){t.options.addTargetClasses!==!1&&d(t.target,v,m),d(t.element,v,m)}),{top:n,left:r}}});var I=_.Utils,o=I.getBounds,d=I.updateClasses,k=I.defer;_.modules.push({position:function(e){var t=this,n=e.top,r=e.left,i=this.cache("element-bounds",function(){return o(t.element)}),a=i.height,s=i.width,u=this.getTargetBounds(),l=n+a,c=r+s,p=[];n<=u.bottom&&l>=u.top&&["left","right"].forEach(function(e){var t=u[e];t!==r&&t!==c||p.push(e)}),r<=u.right&&c>=u.left&&["top","bottom"].forEach(function(e){var t=u[e];t!==n&&t!==l||p.push(e)});var f=[],h=[],m=["left","top","right","bottom"];return f.push(this.getClass("abutted")),m.forEach(function(e){f.push(t.getClass("abutted")+"-"+e)}),p.length&&h.push(this.getClass("abutted")),p.forEach(function(e){h.push(t.getClass("abutted")+"-"+e)}),k(function(){t.options.addTargetClasses!==!1&&d(t.target,h,f),d(t.element,h,f)}),!0}});var M=function(){function e(e,t){var n=[],r=!0,o=!1,i=void 0;try{for(var a,s=e[Symbol.iterator]();!(r=(a=s.next()).done)&&(n.push(a.value),!t||n.length!==t);r=!0);}catch(e){o=!0,i=e}finally{try{!r&&s.return&&s.return()}finally{if(o)throw i}}return n}return function(t,n){if(Array.isArray(t))return t;if(Symbol.iterator in Object(t))return e(t,n);throw new TypeError("Invalid attempt to destructure non-iterable instance")}}();return _.modules.push({position:function(e){var t=e.top,n=e.left;if(this.options.shift){var r=this.options.shift;"function"==typeof this.options.shift&&(r=this.options.shift.call(this,{top:t,left:n}));var o=void 0,i=void 0;if("string"==typeof r){r=r.split(" "),r[1]=r[1]||r[0];var a=r,s=M(a,2);o=s[0],i=s[1],o=parseFloat(o,10),i=parseFloat(i,10)}else o=r.top,i=r.left;return t+=o,n+=i,{top:t,left:n}}}}),z})},function(e,t,n){"use strict";var r=function(){};e.exports=r},function(e,t){!function(e){"use strict";function t(e){if("string"!=typeof e&&(e=String(e)),/[^a-z0-9\-#$%&'*+.\^_`|~]/i.test(e))throw new TypeError("Invalid character in header field name");return e.toLowerCase()}function n(e){return"string"!=typeof e&&(e=String(e)),e}function r(e){var t={next:function(){var t=e.shift();return{done:void 0===t,value:t}}};return g.iterable&&(t[Symbol.iterator]=function(){return t}),t}function o(e){this.map={},e instanceof o?e.forEach(function(e,t){this.append(t,e)},this):e&&Object.getOwnPropertyNames(e).forEach(function(t){this.append(t,e[t])},this)}function i(e){return e.bodyUsed?Promise.reject(new TypeError("Already read")):void(e.bodyUsed=!0)}function a(e){return new Promise(function(t,n){e.onload=function(){t(e.result)},e.onerror=function(){n(e.error)}})}function s(e){var t=new FileReader,n=a(t);return t.readAsArrayBuffer(e),n}function u(e){var t=new FileReader,n=a(t);return t.readAsText(e),n}function l(e){for(var t=new Uint8Array(e),n=new Array(t.length),r=0;r<t.length;r++)n[r]=String.fromCharCode(t[r]);return n.join("")}function c(e){if(e.slice)return e.slice(0);var t=new Uint8Array(e.byteLength);return t.set(new Uint8Array(e)),t.buffer}function p(){return this.bodyUsed=!1,this._initBody=function(e){if(this._bodyInit=e,e)if("string"==typeof e)this._bodyText=e;else if(g.blob&&Blob.prototype.isPrototypeOf(e))this._bodyBlob=e;else if(g.formData&&FormData.prototype.isPrototypeOf(e))this._bodyFormData=e;else if(g.searchParams&&URLSearchParams.prototype.isPrototypeOf(e))this._bodyText=e.toString();else if(g.arrayBuffer&&g.blob&&b(e))this._bodyArrayBuffer=c(e.buffer),this._bodyInit=new Blob([this._bodyArrayBuffer]);else{if(!g.arrayBuffer||!ArrayBuffer.prototype.isPrototypeOf(e)&&!C(e))throw new Error("unsupported BodyInit type");this._bodyArrayBuffer=c(e)}else this._bodyText="";this.headers.get("content-type")||("string"==typeof e?this.headers.set("content-type","text/plain;charset=UTF-8"):this._bodyBlob&&this._bodyBlob.type?this.headers.set("content-type",this._bodyBlob.type):g.searchParams&&URLSearchParams.prototype.isPrototypeOf(e)&&this.headers.set("content-type","application/x-www-form-urlencoded;charset=UTF-8"))},g.blob&&(this.blob=function(){var e=i(this);if(e)return e;if(this._bodyBlob)return Promise.resolve(this._bodyBlob);if(this._bodyArrayBuffer)return Promise.resolve(new Blob([this._bodyArrayBuffer]));if(this._bodyFormData)throw new Error("could not read FormData body as blob");return Promise.resolve(new Blob([this._bodyText]))},this.arrayBuffer=function(){return this._bodyArrayBuffer?i(this)||Promise.resolve(this._bodyArrayBuffer):this.blob().then(s)}),this.text=function(){var e=i(this);if(e)return e;if(this._bodyBlob)return u(this._bodyBlob);if(this._bodyArrayBuffer)return Promise.resolve(l(this._bodyArrayBuffer));if(this._bodyFormData)throw new Error("could not read FormData body as text");return Promise.resolve(this._bodyText)},g.formData&&(this.formData=function(){return this.text().then(h)}),this.json=function(){return this.text().then(JSON.parse)},this}function f(e){var t=e.toUpperCase();return _.indexOf(t)>-1?t:e}function d(e,t){t=t||{};var n=t.body;if(e instanceof d){if(e.bodyUsed)throw new TypeError("Already read");this.url=e.url,this.credentials=e.credentials,t.headers||(this.headers=new o(e.headers)),this.method=e.method,this.mode=e.mode,n||null==e._bodyInit||(n=e._bodyInit,e.bodyUsed=!0)}else this.url=String(e);if(this.credentials=t.credentials||this.credentials||"omit",!t.headers&&this.headers||(this.headers=new o(t.headers)),this.method=f(t.method||this.method||"GET"),this.mode=t.mode||this.mode||null,this.referrer=null,("GET"===this.method||"HEAD"===this.method)&&n)throw new TypeError("Body not allowed for GET or HEAD requests");this._initBody(n)}function h(e){var t=new FormData;return e.trim().split("&").forEach(function(e){if(e){var n=e.split("="),r=n.shift().replace(/\+/g," "),o=n.join("=").replace(/\+/g," ");t.append(decodeURIComponent(r),decodeURIComponent(o))}}),t}function m(e){var t=new o;return e.split(/\r?\n/).forEach(function(e){var n=e.split(":"),r=n.shift().trim();if(r){var o=n.join(":").trim();t.append(r,o)}}),t}function v(e,t){t||(t={}),this.type="default",this.status="status"in t?t.status:200,this.ok=this.status>=200&&this.status<300,this.statusText="statusText"in t?t.statusText:"OK",this.headers=new o(t.headers),this.url=t.url||"",this._initBody(e)}if(!e.fetch){var g={searchParams:"URLSearchParams"in e,iterable:"Symbol"in e&&"iterator"in Symbol,blob:"FileReader"in e&&"Blob"in e&&function(){try{return new Blob,!0}catch(e){return!1}}(),formData:"FormData"in e,arrayBuffer:"ArrayBuffer"in e};if(g.arrayBuffer)var y=["[object Int8Array]","[object Uint8Array]","[object Uint8ClampedArray]","[object Int16Array]","[object Uint16Array]","[object Int32Array]","[object Uint32Array]","[object Float32Array]","[object Float64Array]"],b=function(e){return e&&DataView.prototype.isPrototypeOf(e)},C=ArrayBuffer.isView||function(e){return e&&y.indexOf(Object.prototype.toString.call(e))>-1};o.prototype.append=function(e,r){e=t(e),r=n(r);var o=this.map[e];this.map[e]=o?o+","+r:r},o.prototype.delete=function(e){delete this.map[t(e)]},o.prototype.get=function(e){return e=t(e),this.has(e)?this.map[e]:null},o.prototype.has=function(e){return this.map.hasOwnProperty(t(e))},o.prototype.set=function(e,r){this.map[t(e)]=n(r)},o.prototype.forEach=function(e,t){for(var n in this.map)this.map.hasOwnProperty(n)&&e.call(t,this.map[n],n,this)},o.prototype.keys=function(){var e=[];return this.forEach(function(t,n){e.push(n)}),r(e)},o.prototype.values=function(){var e=[];return this.forEach(function(t){e.push(t)}),r(e)},o.prototype.entries=function(){var e=[];return this.forEach(function(t,n){e.push([n,t])}),r(e)},g.iterable&&(o.prototype[Symbol.iterator]=o.prototype.entries);var _=["DELETE","GET","HEAD","OPTIONS","POST","PUT"];d.prototype.clone=function(){return new d(this,{body:this._bodyInit})},p.call(d.prototype),p.call(v.prototype),v.prototype.clone=function(){return new v(this._bodyInit,{status:this.status,statusText:this.statusText,headers:new o(this.headers),url:this.url})},v.error=function(){var e=new v(null,{status:0,statusText:""});return e.type="error",e};var w=[301,302,303,307,308];v.redirect=function(e,t){if(w.indexOf(t)===-1)throw new RangeError("Invalid status code");return new v(null,{status:t,headers:{location:e}})},e.Headers=o,e.Request=d,e.Response=v,e.fetch=function(e,t){return new Promise(function(n,r){var o=new d(e,t),i=new XMLHttpRequest;i.onload=function(){var e={status:i.status,statusText:i.statusText,headers:m(i.getAllResponseHeaders()||"")};e.url="responseURL"in i?i.responseURL:e.headers.get("X-Request-URL");var t="response"in i?i.response:i.responseText;n(new v(t,e))},i.onerror=function(){r(new TypeError("Network request failed"))},i.ontimeout=function(){r(new TypeError("Network request failed"))},i.open(o.method,o.url,!0),"include"===o.credentials&&(i.withCredentials=!0),"responseType"in i&&g.blob&&(i.responseType="blob"),o.headers.forEach(function(e,t){i.setRequestHeader(t,e)}),i.send("undefined"==typeof o._bodyInit?null:o._bodyInit)})},e.fetch.polyfill=!0}}("undefined"!=typeof self?self:this)},function(e,t,n,r,o,i,a,s){function u(e,t){var n,r=function(o){return e.length>1?function(){var i=o?o.concat():[];return n=t?n||this:this,i.push.apply(i,arguments)<e.length&&arguments.length?r.call(n,i):e.apply(n,i)}:e};return r()}var l,c,p,f,d,h,m,v,g,y={}.toString;l=n(r),c=n(o),p=n(i),f=n(a),d=n(s),h=function(e){return e},m=u(function(e,t){return y.call(t).slice(8,-1)===e}),v=u(function(e,t){var n,r=[];for(n=0;n<e;++n)r.push(t);return r}),f.empty=c.empty,f.slice=c.slice,f.take=c.take,f.drop=c.drop,f.splitAt=c.splitAt,f.takeWhile=c.takeWhile,f.dropWhile=c.dropWhile,f.span=c.span,f.breakStr=c.breakList,g={Func:l,List:c,Obj:p,Str:f,Num:d,id:h,isType:m,replicate:v},g.each=c.each,g.map=c.map,g.filter=c.filter,g.compact=c.compact,g.reject=c.reject,g.partition=c.partition,g.find=c.find,g.head=c.head,g.first=c.first,g.tail=c.tail,g.last=c.last,g.initial=c.initial,g.empty=c.empty,g.reverse=c.reverse,g.difference=c.difference,g.intersection=c.intersection,g.union=c.union,g.countBy=c.countBy,g.groupBy=c.groupBy,g.fold=c.fold,g.foldl=c.foldl,g.fold1=c.fold1,g.foldl1=c.foldl1,
-g.foldr=c.foldr,g.foldr1=c.foldr1,g.unfoldr=c.unfoldr,g.andList=c.andList,g.orList=c.orList,g.any=c.any,g.all=c.all,g.unique=c.unique,g.uniqueBy=c.uniqueBy,g.sort=c.sort,g.sortWith=c.sortWith,g.sortBy=c.sortBy,g.sum=c.sum,g.product=c.product,g.mean=c.mean,g.average=c.average,g.concat=c.concat,g.concatMap=c.concatMap,g.flatten=c.flatten,g.maximum=c.maximum,g.minimum=c.minimum,g.maximumBy=c.maximumBy,g.minimumBy=c.minimumBy,g.scan=c.scan,g.scanl=c.scanl,g.scan1=c.scan1,g.scanl1=c.scanl1,g.scanr=c.scanr,g.scanr1=c.scanr1,g.slice=c.slice,g.take=c.take,g.drop=c.drop,g.splitAt=c.splitAt,g.takeWhile=c.takeWhile,g.dropWhile=c.dropWhile,g.span=c.span,g.breakList=c.breakList,g.zip=c.zip,g.zipWith=c.zipWith,g.zipAll=c.zipAll,g.zipAllWith=c.zipAllWith,g.at=c.at,g.elemIndex=c.elemIndex,g.elemIndices=c.elemIndices,g.findIndex=c.findIndex,g.findIndices=c.findIndices,g.apply=l.apply,g.curry=l.curry,g.flip=l.flip,g.fix=l.fix,g.over=l.over,g.split=f.split,g.join=f.join,g.lines=f.lines,g.unlines=f.unlines,g.words=f.words,g.unwords=f.unwords,g.chars=f.chars,g.unchars=f.unchars,g.repeat=f.repeat,g.capitalize=f.capitalize,g.camelize=f.camelize,g.dasherize=f.dasherize,g.values=p.values,g.keys=p.keys,g.pairsToObj=p.pairsToObj,g.objToPairs=p.objToPairs,g.listsToObj=p.listsToObj,g.objToLists=p.objToLists,g.max=d.max,g.min=d.min,g.negate=d.negate,g.abs=d.abs,g.signum=d.signum,g.quot=d.quot,g.rem=d.rem,g.div=d.div,g.mod=d.mod,g.recip=d.recip,g.pi=d.pi,g.tau=d.tau,g.exp=d.exp,g.sqrt=d.sqrt,g.ln=d.ln,g.pow=d.pow,g.sin=d.sin,g.tan=d.tan,g.cos=d.cos,g.acos=d.acos,g.asin=d.asin,g.atan=d.atan,g.atan2=d.atan2,g.truncate=d.truncate,g.round=d.round,g.ceiling=d.ceiling,g.floor=d.floor,g.isItNaN=d.isItNaN,g.even=d.even,g.odd=d.odd,g.gcd=d.gcd,g.lcm=d.lcm,g.VERSION="1.2.1",e.exports=g},function(e,t,n,r){"use strict";var o=n(r),i=(n(1),function(e){var t=this;if(t.instancePool.length){var n=t.instancePool.pop();return t.call(n,e),n}return new t(e)}),a=function(e,t){var n=this;if(n.instancePool.length){var r=n.instancePool.pop();return n.call(r,e,t),r}return new n(e,t)},s=function(e,t,n){var r=this;if(r.instancePool.length){var o=r.instancePool.pop();return r.call(o,e,t,n),o}return new r(e,t,n)},u=function(e,t,n,r){var o=this;if(o.instancePool.length){var i=o.instancePool.pop();return o.call(i,e,t,n,r),i}return new o(e,t,n,r)},l=function(e){var t=this;e instanceof t?void 0:o("25"),e.destructor(),t.instancePool.length<t.poolSize&&t.instancePool.push(e)},c=10,p=i,f=function(e,t){var n=e;return n.instancePool=[],n.getPooled=t||p,n.poolSize||(n.poolSize=c),n.release=l,n},d={addPoolingTo:f,oneArgumentPooler:i,twoArgumentPooler:a,threeArgumentPooler:s,fourArgumentPooler:u};e.exports=d}]));
-//# sourceMappingURL=main.33e618c9.js.map
\ No newline at end of file
+var i=o._instance.rootID;return L[i]=o,o},renderSubtreeIntoContainer:function(e,t,n,r){return null!=e&&w.has(e)?void 0:d("38"),j._renderSubtreeIntoContainer(e,t,n,r)},_renderSubtreeIntoContainer:function(e,t,n,r){x.validateCallback(r,"ReactDOM.render"),v.isValidElement(t)?void 0:d("39","string"==typeof t?" Instead of passing a string like 'div', pass React.createElement('div') or <div />.":"function"==typeof t?" Instead of passing a class like Foo, pass React.createElement(Foo) or <Foo />.":null!=t&&void 0!==t.props?" This may be caused by unintentionally loading two independent copies of React.":"");var a,s=v.createElement(F,{child:t});if(e){var u=w.get(e);a=u._processChildContext(u._context)}else a=P;var c=f(n);if(c){var p=c._currentElement,h=p.props.child;if(N(h,t)){var m=c._renderedComponent.getPublicInstance(),g=r&&function(){r.call(m)};return j._updateRootComponent(c,s,a,n,g),m}j.unmountComponentAtNode(n)}var y=o(n),b=y&&!!i(y),C=l(n),_=b&&!c&&!C,E=j._renderNewRootComponent(s,n,_,a)._renderedComponent.getPublicInstance();return r&&r.call(E),E},render:function(e,t,n){return j._renderSubtreeIntoContainer(null,e,t,n)},unmountComponentAtNode:function(e){c(e)?void 0:d("40");var t=f(e);if(!t){l(e),1===e.nodeType&&e.hasAttribute(A);return!1}return delete L[t._instance.rootID],O.batchedUpdates(u,t,e,!1),!0},_mountImageIntoNode:function(e,t,n,i,a){if(c(t)?void 0:d("41"),i){var s=o(t);if(E.canReuseMarkup(e,s))return void y.precacheNode(n,s);var u=s.getAttribute(E.CHECKSUM_ATTR_NAME);s.removeAttribute(E.CHECKSUM_ATTR_NAME);var l=s.outerHTML;s.setAttribute(E.CHECKSUM_ATTR_NAME,u);var p=e,f=r(p,l),m=" (client) "+p.substring(f-20,f+20)+"\n (server) "+l.substring(f-20,f+20);t.nodeType===D?d("42",m):void 0}if(t.nodeType===D?d("43"):void 0,a.useCreateElement){for(;t.lastChild;)t.removeChild(t.lastChild);h.insertTreeBefore(t,e,null)}else S(t,e),y.precacheNode(n,t.firstChild)}};e.exports=j},function(e,t,n){"use strict";var r=n(3),o=n(20),i=(n(1),{HOST:0,COMPOSITE:1,EMPTY:2,getType:function(e){return null===e||e===!1?i.EMPTY:o.isValidElement(e)?"function"==typeof e.type?i.COMPOSITE:i.HOST:void r("26",e)}});e.exports=i},function(e,t){"use strict";var n={currentScrollLeft:0,currentScrollTop:0,refreshScrollValues:function(e){n.currentScrollLeft=e.x,n.currentScrollTop=e.y}};e.exports=n},function(e,t,n){"use strict";function r(e,t){return null==t?o("30"):void 0,null==e?t:Array.isArray(e)?Array.isArray(t)?(e.push.apply(e,t),e):(e.push(t),e):Array.isArray(t)?[e].concat(t):[e,t]}var o=n(3);n(1);e.exports=r},function(e,t){"use strict";function n(e,t,n){Array.isArray(e)?e.forEach(t,n):e&&t.call(n,e)}e.exports=n},function(e,t,n){"use strict";function r(e){for(var t;(t=e._renderedNodeType)===o.COMPOSITE;)e=e._renderedComponent;return t===o.HOST?e._renderedComponent:t===o.EMPTY?null:void 0}var o=n(74);e.exports=r},function(e,t,n){"use strict";function r(){return!i&&o.canUseDOM&&(i="textContent"in document.documentElement?"textContent":"innerText"),i}var o=n(7),i=null;e.exports=r},function(e,t,n){"use strict";function r(e){if(e){var t=e.getName();if(t)return" Check the render method of `"+t+"`."}return""}function o(e){return"function"==typeof e&&"undefined"!=typeof e.prototype&&"function"==typeof e.prototype.mountComponent&&"function"==typeof e.prototype.receiveComponent}function i(e,t){var n;if(null===e||e===!1)n=l.create(i);else if("object"==typeof e){var s=e,u=s.type;if("function"!=typeof u&&"string"!=typeof u){var f="";f+=r(s._owner),a("130",null==u?u:typeof u,f)}"string"==typeof s.type?n=c.createInternalComponent(s):o(s.type)?(n=new s.type(s),n.getHostNode||(n.getHostNode=n.getNativeNode)):n=new p(s)}else"string"==typeof e||"number"==typeof e?n=c.createInstanceForText(e):a("131",typeof e);return n._mountIndex=0,n._mountImage=null,n}var a=n(3),s=n(4),u=n(137),l=n(69),c=n(71),p=(n(221),n(1),n(2),function(e){this.construct(e)});s(p.prototype,u,{_instantiateReactComponent:i}),e.exports=i},function(e,t){"use strict";function n(e){var t=e&&e.nodeName&&e.nodeName.toLowerCase();return"input"===t?!!r[e.type]:"textarea"===t}var r={color:!0,date:!0,datetime:!0,"datetime-local":!0,email:!0,month:!0,number:!0,password:!0,range:!0,search:!0,tel:!0,text:!0,time:!0,url:!0,week:!0};e.exports=n},function(e,t,n){"use strict";var r=n(7),o=n(32),i=n(33),a=function(e,t){if(t){var n=e.firstChild;if(n&&n===e.lastChild&&3===n.nodeType)return void(n.nodeValue=t)}e.textContent=t};r.canUseDOM&&("textContent"in document.documentElement||(a=function(e,t){return 3===e.nodeType?void(e.nodeValue=t):void i(e,o(t))})),e.exports=a},function(e,t,n){"use strict";function r(e,t){return e&&"object"==typeof e&&null!=e.key?l.escape(e.key):t.toString(36)}function o(e,t,n,i){var f=typeof e;if("undefined"!==f&&"boolean"!==f||(e=null),null===e||"string"===f||"number"===f||"object"===f&&e.$$typeof===s)return n(i,e,""===t?c+r(e,0):t),1;var d,h,m=0,v=""===t?c:t+p;if(Array.isArray(e))for(var g=0;g<e.length;g++)d=e[g],h=v+r(d,g),m+=o(d,h,n,i);else{var y=u(e);if(y){var b,C=y.call(e);if(y!==e.entries)for(var _=0;!(b=C.next()).done;)d=b.value,h=v+r(d,_++),m+=o(d,h,n,i);else for(;!(b=C.next()).done;){var w=b.value;w&&(d=w[1],h=v+l.escape(w[0])+p+r(d,0),m+=o(d,h,n,i))}}else if("object"===f){var E="",T=String(e);a("31","[object Object]"===T?"object with keys {"+Object.keys(e).join(", ")+"}":T,E)}}return m}function i(e,t,n){return null==e?0:o(e,"",t,n)}var a=n(3),s=(n(12),n(152)),u=n(183),l=(n(1),n(41)),c=(n(2),"."),p=":";e.exports=i},function(e,t,n){(function(){var t,r,o,i,a;t=n(5),r=t.createClass,o=t.DOM.div,i=n(16).isEqualToObject,a=n(28).cancelEvent,e.exports=r({getDefaultProps:function(){return{}},render:function(){var e=this;return o({className:"option-wrapper "+(this.props.highlight?"highlight":""),onMouseDown:function(t){var n;return n=function(t){return e.props.onClick(t),window.removeEventListener("mouseup",n)},window.addEventListener("mouseup",n),a(t)},onMouseMove:this.props.onMouseMove,onMouseOut:this.props.onMouseOut,onMouseOver:this.props.onMouseOver},this.props.renderItem(this.props.item))},shouldComponentUpdate:function(e){var t,n,r;return!i(null!=e?e.uid:void 0,null!=(t=this.props)?t.uid:void 0)||(null!=e?e.highlight:void 0)!==(null!=(n=this.props)?n.highlight:void 0)||(null!=e?e.selectable:void 0)!==(null!=(r=this.props)?r.selectable:void 0)}})}).call(this)},function(e,t,n){(function(){var t,r,o,i;t=n(5),r=t.createClass,o=t.DOM.svg,i=n(13).findDOMNode,e.exports=r({render:function(){return o(this.props)},componentDidMount:function(){i(this).setAttribute("focusable",!1)}})}).call(this)},function(e,t,n){"use strict";function r(e){return e&&e.__esModule?e:{default:e}}function o(e){var t="transition"+e+"Timeout",n="transition"+e;return function(e){if(e[n]){if(null==e[t])return new Error(t+" wasn't supplied to CSSTransitionGroup: this can cause unreliable animations and won't be supported in a future version of React. See https://fb.me/react-animation-transition-group-timeout for more information.");if("number"!=typeof e[t])return new Error(t+" must be a number (in milliseconds)")}return null}}t.__esModule=!0,t.nameShape=void 0,t.transitionTimeout=o;var i=n(5),a=(r(i),n(34)),s=r(a);t.nameShape=s.default.oneOfType([s.default.string,s.default.shape({enter:s.default.string,leave:s.default.string,active:s.default.string}),s.default.shape({enter:s.default.string,enterActive:s.default.string,leave:s.default.string,leaveActive:s.default.string,appear:s.default.string,appearActive:s.default.string})])},function(e,t,n){"use strict";function r(e){var t=Function.prototype.toString,n=Object.prototype.hasOwnProperty,r=RegExp("^"+t.call(n).replace(/[\\^$.*+?()[\]{}|]/g,"\\$&").replace(/hasOwnProperty|(function).*?(?=\\\()| for .+?(?=\\\])/g,"$1.*?")+"$");try{var o=t.call(e);return r.test(o)}catch(e){return!1}}function o(e){var t=l(e);if(t){var n=t.childIDs;c(e),n.forEach(o)}}function i(e,t,n){return"\n    in "+(e||"Unknown")+(t?" (at "+t.fileName.replace(/^.*[\\\/]/,"")+":"+t.lineNumber+")":n?" (created by "+n+")":"")}function a(e){return null==e?"#empty":"string"==typeof e||"number"==typeof e?"#text":"string"==typeof e.type?e.type:e.type.displayName||e.type.name||"Unknown"}function s(e){var t,n=x.getDisplayName(e),r=x.getElement(e),o=x.getOwnerID(e);return o&&(t=x.getDisplayName(o)),i(n,r&&r._source,t)}var u,l,c,p,f,d,h,m=n(22),v=n(12),g=(n(1),n(2),"function"==typeof Array.from&&"function"==typeof Map&&r(Map)&&null!=Map.prototype&&"function"==typeof Map.prototype.keys&&r(Map.prototype.keys)&&"function"==typeof Set&&r(Set)&&null!=Set.prototype&&"function"==typeof Set.prototype.keys&&r(Set.prototype.keys));if(g){var y=new Map,b=new Set;u=function(e,t){y.set(e,t)},l=function(e){return y.get(e)},c=function(e){y.delete(e)},p=function(){return Array.from(y.keys())},f=function(e){b.add(e)},d=function(e){b.delete(e)},h=function(){return Array.from(b.keys())}}else{var C={},_={},w=function(e){return"."+e},E=function(e){return parseInt(e.substr(1),10)};u=function(e,t){var n=w(e);C[n]=t},l=function(e){var t=w(e);return C[t]},c=function(e){var t=w(e);delete C[t]},p=function(){return Object.keys(C).map(E)},f=function(e){var t=w(e);_[t]=!0},d=function(e){var t=w(e);delete _[t]},h=function(){return Object.keys(_).map(E)}}var T=[],x={onSetChildren:function(e,t){var n=l(e);n?void 0:m("144"),n.childIDs=t;for(var r=0;r<t.length;r++){var o=t[r],i=l(o);i?void 0:m("140"),null==i.childIDs&&"object"==typeof i.element&&null!=i.element?m("141"):void 0,i.isMounted?void 0:m("71"),null==i.parentID&&(i.parentID=e),i.parentID!==e?m("142",o,i.parentID,e):void 0}},onBeforeMountComponent:function(e,t,n){var r={element:t,parentID:n,text:null,childIDs:[],isMounted:!1,updateCount:0};u(e,r)},onBeforeUpdateComponent:function(e,t){var n=l(e);n&&n.isMounted&&(n.element=t)},onMountComponent:function(e){var t=l(e);t?void 0:m("144"),t.isMounted=!0;var n=0===t.parentID;n&&f(e)},onUpdateComponent:function(e){var t=l(e);t&&t.isMounted&&t.updateCount++},onUnmountComponent:function(e){var t=l(e);if(t){t.isMounted=!1;var n=0===t.parentID;n&&d(e)}T.push(e)},purgeUnmountedComponents:function(){if(!x._preventPurging){for(var e=0;e<T.length;e++){var t=T[e];o(t)}T.length=0}},isMounted:function(e){var t=l(e);return!!t&&t.isMounted},getCurrentStackAddendum:function(e){var t="";if(e){var n=a(e),r=e._owner;t+=i(n,e._source,r&&r.getName())}var o=v.current,s=o&&o._debugID;return t+=x.getStackAddendumByID(s)},getStackAddendumByID:function(e){for(var t="";e;)t+=s(e),e=x.getParentID(e);return t},getChildIDs:function(e){var t=l(e);return t?t.childIDs:[]},getDisplayName:function(e){var t=x.getElement(e);return t?a(t):null},getElement:function(e){var t=l(e);return t?t.element:null},getOwnerID:function(e){var t=x.getElement(e);return t&&t._owner?t._owner._debugID:null},getParentID:function(e){var t=l(e);return t?t.parentID:null},getSource:function(e){var t=l(e),n=t?t.element:null,r=null!=n?n._source:null;return r},getText:function(e){var t=x.getElement(e);return"string"==typeof t?t:"number"==typeof t?""+t:null},getUpdateCount:function(e){var t=l(e);return t?t.updateCount:0},getRootIDs:h,getRegisteredIDs:p};e.exports=x},function(e,t){"use strict";var n="function"==typeof Symbol&&Symbol.for&&Symbol.for("react.element")||60103;e.exports=n},function(e,t,n){"use strict";var r=!1;e.exports=r},function(e,t){(function(t){"use strict";function n(e){s.length||(a(),u=!0),s[s.length]=e}function r(){for(;l<s.length;){var e=l;if(l+=1,s[e].call(),l>c){for(var t=0,n=s.length-l;t<n;t++)s[t]=s[t+l];s.length-=l,l=0}}s.length=0,l=0,u=!1}function o(e){var t=1,n=new f(e),r=document.createTextNode("");return n.observe(r,{characterData:!0}),function(){t=-t,r.data=t}}function i(e){return function(){function t(){clearTimeout(n),clearInterval(r),e()}var n=setTimeout(t,0),r=setInterval(t,50)}}e.exports=n;var a,s=[],u=!1,l=0,c=1024,p="undefined"!=typeof t?t:self,f=p.MutationObserver||p.WebKitMutationObserver;a="function"==typeof f?o(r):i(r),n.requestFlush=a,n.makeRequestCallFromTimer=i}).call(t,function(){return this}())},function(e,t,n){"use strict";function r(e){return e&&e.__esModule?e:{default:e}}function o(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function i(e,t){if(!e)throw new ReferenceError("this hasn't been initialised - super() hasn't been called");return!t||"object"!=typeof t&&"function"!=typeof t?e:t}function a(e,t){if("function"!=typeof t&&null!==t)throw new TypeError("Super expression must either be null or a function, not "+typeof t);e.prototype=Object.create(t&&t.prototype,{constructor:{value:e,enumerable:!1,writable:!0,configurable:!0}}),t&&(Object.setPrototypeOf?Object.setPrototypeOf(e,t):e.__proto__=t)}Object.defineProperty(t,"__esModule",{value:!0});var s=function(){function e(e,t){for(var n=0;n<t.length;n++){var r=t[n];r.enumerable=r.enumerable||!1,r.configurable=!0,"value"in r&&(r.writable=!0),Object.defineProperty(e,r.key,r)}}return function(t,n,r){return n&&e(t.prototype,n),r&&e(t,r),t}}(),u=n(5),l=r(u),c=n(204),p=function(e){function t(e){o(this,t);var n=i(this,(t.__proto__||Object.getPrototypeOf(t)).call(this,e));return n.getCoefficients=function(e){if(e)return e.map(function(e,t){return l.default.createElement("option",{key:t,value:e.value},e.name)})},n.labels=[],n.handleInputChange=n.handleInputChange.bind(n),n.handleValueChange=n.handleValueChange.bind(n),n}return a(t,e),s(t,[{key:"handleInputChange",value:function(e){var t=this.props.condition;t[e.target.name]=e.target.value;var n=this.props.parameters.find(function(t){return t.value===e.target.value});n&&(n.type!==t.type&&(t.operator=""),t.type=n.type),this.props.onChange({index:this.props.index,value:t})}},{key:"handleValueChange",value:function(e){var t=this.props.condition;t.value=e.map(function(e){return e.value}),this.props.onChange({index:this.props.index,value:t})}},{key:"getOperators",value:function(e,t){if(e&&t)return e.filter(function(e){return e.types.indexOf(t.type)>-1}).map(function(e,t){return l.default.createElement("option",{key:t,value:e.name},e.name)})}},{key:"getValues",value:function(e){return e?e.map(function(e){return{label:e,value:e}}):[]}},{key:"render",value:function(){var e=this,t=this.props.parameters.find(function(t){return t.value===e.props.condition.parameter});return this.props.condition.type=t?t.type:null,l.default.createElement("div",{className:this.props.classes.filterLineRow},l.default.createElement("div",{className:this.props.classes.filterLineParameter},l.default.createElement("select",{className:this.props.classes.filterLineInput,name:"parameter",value:this.props.condition.parameter,onChange:this.handleInputChange},l.default.createElement("option",{value:""},"-- Parameter --"),this.getCoefficients(this.props.parameters))),l.default.createElement("div",{className:this.props.classes.filterLineOperator,style:{"padding-left":0,"padding-right":0}},l.default.createElement("select",{className:this.props.classes.filterLineInput,name:"operator",value:this.props.condition.operator,onChange:this.handleInputChange},l.default.createElement("option",{disabled:!0,value:""},"-- Operator --"),this.getOperators(this.props.operators,this.props.parameters.find(function(t){return t.value===e.props.condition.parameter})))),l.default.createElement("div",{className:this.props.classes.filterLineValue},l.default.createElement(c.MultiSelect,{style:{width:"100%"},placeholder:"-- Value --",theme:"bootstrap3",values:this.getValues(this.props.condition.value),onValuesChange:this.handleValueChange,uid:function(e){return e.value},restoreOnBackspace:function(e){return e.label.toString()},createFromSearch:function(t,n,r){return e.labels=n.map(function(e){return e.label}),0===r.trim().length||e.labels.indexOf(r.trim())!==-1?null:{label:r.trim(),value:r.trim()}},renderNoResultsFound:function(e,t){return l.default.createElement("div",{className:"no-results-found"},function(){return 0===t.trim().length?"Enter a new value":e.map(function(e){return e.label}).indexOf(t.trim())!==-1?"Value already exists":void 0}())}})))}}]),t}(u.Component);t.default=p},function(e,t,n){"use strict";function r(e){return e&&e.__esModule?e:{default:e}}function o(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function i(e,t){if(!e)throw new ReferenceError("this hasn't been initialised - super() hasn't been called");return!t||"object"!=typeof t&&"function"!=typeof t?e:t}function a(e,t){if("function"!=typeof t&&null!==t)throw new TypeError("Super expression must either be null or a function, not "+typeof t);e.prototype=Object.create(t&&t.prototype,{constructor:{value:e,enumerable:!1,writable:!0,configurable:!0}}),t&&(Object.setPrototypeOf?Object.setPrototypeOf(e,t):e.__proto__=t)}Object.defineProperty(t,"__esModule",{value:!0});var s=function(){function e(e,t){for(var n=0;n<t.length;n++){var r=t[n];r.enumerable=r.enumerable||!1,r.configurable=!0,"value"in r&&(r.writable=!0),Object.defineProperty(e,r.key,r)}}return function(t,n,r){return n&&e(t.prototype,n),r&&e(t,r),t}}(),u=n(5),l=r(u),c={paddingTop:10,paddingBottom:10,paddingRight:3,paddingLeft:3},p=function(e){function t(e){o(this,t);var n=i(this,(t.__proto__||Object.getPrototypeOf(t)).call(this,e));return n.removeCondition=n.removeCondition.bind(n),n.addCondition=n.addCondition.bind(n),n}return a(t,e),s(t,[{key:"removeCondition",value:function(){this.props.removeCondition(this.props.index)}},{key:"addCondition",value:function(){this.props.addCondition(this.props.index)}},{key:"render",value:function(){return l.default.createElement("div",{className:this.props.classes.filterLineLabelRow},l.default.createElement("div",{className:this.props.classes.filterLineLabelCondition},l.default.createElement("label",{style:{marginTop:0}},"Condition {",this.props.index+1,"}")),l.default.createElement("div",{className:this.props.classes.filterLineLabelControls},l.default.createElement("a",{style:c,onClick:this.addCondition},l.default.createElement("span",{className:this.props.classes.plusIcon})),l.default.createElement("a",{style:c,onClick:this.removeCondition},l.default.createElement("span",{className:this.props.classes.minusIcon}))))}}]),t}(u.Component);t.default=p},function(e,t,n){"use strict";function r(e){return e&&e.__esModule?e:{default:e}}function o(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function i(e,t){if(!e)throw new ReferenceError("this hasn't been initialised - super() hasn't been called");return!t||"object"!=typeof t&&"function"!=typeof t?e:t}function a(e,t){if("function"!=typeof t&&null!==t)throw new TypeError("Super expression must either be null or a function, not "+typeof t);e.prototype=Object.create(t&&t.prototype,{constructor:{value:e,enumerable:!1,writable:!0,configurable:!0}}),t&&(Object.setPrototypeOf?Object.setPrototypeOf(e,t):e.__proto__=t)}Object.defineProperty(t,"__esModule",{value:!0});var s=function(){function e(e,t){for(var n=0;n<t.length;n++){var r=t[n];r.enumerable=r.enumerable||!1,r.configurable=!0,"value"in r&&(r.writable=!0),Object.defineProperty(e,r.key,r)}}return function(t,n,r){return n&&e(t.prototype,n),r&&e(t,r),t}}(),u=n(5),l=r(u),c=n(91),p=r(c),f=n(92),d=r(f),h=function(e){function t(e){o(this,t);var n=i(this,(t.__proto__||Object.getPrototypeOf(t)).call(this,e));return n.state={conditions:e.config.conditions},n.updateCondition=n.updateCondition.bind(n),n.addCondition=n.addCondition.bind(n),n.removeCondition=n.removeCondition.bind(n),n.componentDidUpdate=n.componentDidUpdate.bind(n),n}return a(t,e),s(t,[{key:"updateCondition",value:function(e){var t=this.state.conditions;t[e.index]=e.value,this.setState({conditions:t})}},{key:"addCondition",value:function(e){var t=this.state.conditions;t.splice(e+1,0,{parameter:"",operator:"",value:""}),this.setState({conditions:t})}},{key:"removeCondition",value:function(e){if(this.state.conditions.length>1){var t=this.state.conditions;t.splice(e,1),this.setState({conditions:t})}}},{key:"componentDidUpdate",value:function(e,t){t!==this.state&&this.props.config.updateConditions(this.state.conditions)}},{key:"render",value:function(){var e=this,t=this.state.conditions.map(function(t,n){return l.default.createElement("div",{key:n},l.default.createElement(d.default,{index:n,classes:e.props.config.classes,addCondition:e.addCondition,removeCondition:e.removeCondition}),l.default.createElement(p.default,{parameters:e.props.config.parameters,operators:e.props.config.operators,condition:t,index:n,classes:e.props.config.classes,onChange:e.updateCondition}))});return l.default.createElement("div",{className:"form-horizontal"},t)}}]),t}(u.Component);t.default=h},function(e,t,n){"use strict";function r(e){return e&&e.__esModule?e:{default:e}}var o=n(5),i=r(o),a=n(13),s=r(a),u=n(93),l=r(u),c=window.$;if(c.fn.filterer=function(e){e.operators=[{name:"contains",types:["string","str"]},{name:"does not contain",types:["string","str"]},{name:"is",types:["string","str","number","int","float"]},{name:"is not",types:["string","str","number","int","float"]},{name:"begins with",types:["string","str"]},{name:"does not begin with",types:["string","str"]},{name:"ends with",types:["string","str"]},{name:"does not end with",types:["string","str"]},{name:"is greater than",types:["number","int","float"]},{name:"is less than",types:["number","int","float"]}],e.classes=Object.assign({plusIcon:"fa fa-fw fa-plus",minusIcon:"fa fa-fw fa-minus",filterLineRow:"form-group",filterLineParameter:"col-sm-4",filterLineOperator:"col-sm-3",filterLineValue:"col-sm-5",filterLineInput:"form-control",filterLineLabelRow:"row",filterLineLabelCondition:"col-sm-10",filterLineLabelControls:"col-sm-2 text-right"},e.classes),this.each(function(){s.default.render(i.default.createElement(l.default,{id:"filterer",config:e}),this)})},window.wcomartin_filterer_demo){var p={parameters:[{name:"Title",type:"string",value:"title"},{name:"Year",type:"number",value:"year"}],conditions:[{parameter:"year",operator:"is",value:[2017]}]};p.updateConditions=function(e){console.log(JSON.stringify(e))},c("#root").filterer(p)}},function(e,t){e.exports=function(){for(var e=arguments.length,t=[],n=0;n<e;n++)t[n]=arguments[n];if(t=t.filter(function(e){return null!=e}),0!==t.length)return 1===t.length?t[0]:t.reduce(function(e,t){return function(){e.apply(this,arguments),t.apply(this,arguments)}})}},function(e,t,n){"use strict";function r(e,t){e.classList?e.classList.add(t):(0,i.default)(e,t)||("string"==typeof e.className?e.className=e.className+" "+t:e.setAttribute("class",(e.className&&e.className.baseVal||"")+" "+t))}var o=n(35);t.__esModule=!0,t.default=r;var i=o(n(97));e.exports=t.default},function(e,t){"use strict";function n(e,t){return e.classList?!!t&&e.classList.contains(t):(" "+(e.className.baseVal||e.className)+" ").indexOf(" "+t+" ")!==-1}t.__esModule=!0,t.default=n,e.exports=t.default},function(e,t){"use strict";function n(e,t){return e.replace(new RegExp("(^|\\s)"+t+"(?:\\s|$)","g"),"$1").replace(/\s+/g," ").replace(/^\s*|\s*$/g,"")}e.exports=function(e,t){e.classList?e.classList.remove(t):"string"==typeof e.className?e.className=n(e.className,t):e.setAttribute("class",n(e.className&&e.className.baseVal||"",t))}},function(e,t,n){"use strict";function r(){for(var e,t,n=document.createElement("div").style,r={O:function(e){return"o"+e.toLowerCase()},Moz:function(e){return e.toLowerCase()},Webkit:function(e){return"webkit"+e},ms:function(e){return"MS"+e}},o=Object.keys(r),i="",a=0;a<o.length;a++){var s=o[a];if(s+"TransitionProperty"in n){i="-"+s.toLowerCase(),e=r[s]("TransitionEnd"),t=r[s]("AnimationEnd");break}}return!e&&"transitionProperty"in n&&(e="transitionend"),!t&&"animationName"in n&&(t="animationend"),n=null,{animationEnd:t,transitionEnd:e,prefix:i}}var o=n(35);t.__esModule=!0,t.default=t.animationEnd=t.animationDelay=t.animationTiming=t.animationDuration=t.animationName=t.transitionEnd=t.transitionDuration=t.transitionDelay=t.transitionTiming=t.transitionProperty=t.transform=void 0;var i=o(n(56)),a="transform";t.transform=a;var s,u,l;t.animationEnd=l,t.transitionEnd=u;var c,p,f,d;t.transitionDelay=d,t.transitionTiming=f,t.transitionDuration=p,t.transitionProperty=c;var h,m,v,g;if(t.animationDelay=g,t.animationTiming=v,t.animationDuration=m,t.animationName=h,i.default){var y=r();s=y.prefix,t.transitionEnd=u=y.transitionEnd,t.animationEnd=l=y.animationEnd,t.transform=a=s+"-"+a,t.transitionProperty=c=s+"-transition-property",t.transitionDuration=p=s+"-transition-duration",t.transitionDelay=d=s+"-transition-delay",t.transitionTiming=f=s+"-transition-timing-function",t.animationName=h=s+"-animation-name",t.animationDuration=m=s+"-animation-duration",t.animationTiming=v=s+"-animation-delay",t.animationDelay=g=s+"-animation-timing-function"}var b={transform:a,end:u,property:c,timing:f,delay:d,duration:p};t.default=b},function(e,t,n){"use strict";function r(e){var t=(new Date).getTime(),n=Math.max(0,16-(t-p)),r=setTimeout(e,n);return p=t,r}var o=n(35);t.__esModule=!0,t.default=void 0;var i,a=o(n(56)),s=["","webkit","moz","o","ms"],u="clearTimeout",l=r,c=function(e,t){return e+(e?t[0].toUpperCase()+t.substr(1):t)+"AnimationFrame"};a.default&&s.some(function(e){var t=c(e,"request");if(t in window)return u=c(e,"cancel"),l=function(e){return window[t](e)}});var p=(new Date).getTime();i=function(e){return l(e)},i.cancel=function(e){window[u]&&"function"==typeof window[u]&&window[u](e)};var f=i;t.default=f,e.exports=t.default},function(e,t){"use strict";function n(e){return e.replace(r,function(e,t){return t.toUpperCase()})}var r=/-(.)/g;e.exports=n},function(e,t,n){"use strict";function r(e){return o(e.replace(i,"ms-"))}var o=n(101),i=/^-ms-/;e.exports=r},function(e,t,n){"use strict";function r(e,t){return!(!e||!t)&&(e===t||!o(e)&&(o(t)?r(e,t.parentNode):"contains"in e?e.contains(t):!!e.compareDocumentPosition&&!!(16&e.compareDocumentPosition(t))))}var o=n(111);e.exports=r},function(e,t,n){"use strict";function r(e){var t=e.length;if(Array.isArray(e)||"object"!=typeof e&&"function"!=typeof e?a(!1):void 0,"number"!=typeof t?a(!1):void 0,0===t||t-1 in e?void 0:a(!1),"function"==typeof e.callee?a(!1):void 0,e.hasOwnProperty)try{return Array.prototype.slice.call(e)}catch(e){}for(var n=Array(t),r=0;r<t;r++)n[r]=e[r];return n}function o(e){return!!e&&("object"==typeof e||"function"==typeof e)&&"length"in e&&!("setInterval"in e)&&"number"!=typeof e.nodeType&&(Array.isArray(e)||"callee"in e||"item"in e)}function i(e){return o(e)?Array.isArray(e)?e.slice():r(e):[e]}var a=n(1);e.exports=i},function(e,t,n){"use strict";function r(e){var t=e.match(c);return t&&t[1].toLowerCase()}function o(e,t){var n=l;l?void 0:u(!1);var o=r(e),i=o&&s(o);if(i){n.innerHTML=i[1]+e+i[2];for(var c=i[0];c--;)n=n.lastChild}else n.innerHTML=e;var p=n.getElementsByTagName("script");p.length&&(t?void 0:u(!1),a(p).forEach(t));for(var f=Array.from(n.childNodes);n.lastChild;)n.removeChild(n.lastChild);return f}var i=n(7),a=n(104),s=n(106),u=n(1),l=i.canUseDOM?document.createElement("div"):null,c=/^\s*<(\w+)/;e.exports=o},function(e,t,n){"use strict";function r(e){return a?void 0:i(!1),f.hasOwnProperty(e)||(e="*"),s.hasOwnProperty(e)||("*"===e?a.innerHTML="<link />":a.innerHTML="<"+e+"></"+e+">",s[e]=!a.firstChild),s[e]?f[e]:null}var o=n(7),i=n(1),a=o.canUseDOM?document.createElement("div"):null,s={},u=[1,'<select multiple="true">',"</select>"],l=[1,"<table>","</table>"],c=[3,"<table><tbody><tr>","</tr></tbody></table>"],p=[1,'<svg xmlns="http://www.w3.org/2000/svg">',"</svg>"],f={"*":[1,"?<div>","</div>"],area:[1,"<map>","</map>"],col:[2,"<table><tbody></tbody><colgroup>","</colgroup></table>"],legend:[1,"<fieldset>","</fieldset>"],param:[1,"<object>","</object>"],tr:[2,"<table><tbody>","</tbody></table>"],optgroup:u,option:u,caption:l,colgroup:l,tbody:l,tfoot:l,thead:l,td:c,th:c},d=["circle","clipPath","defs","ellipse","g","image","line","linearGradient","mask","path","pattern","polygon","polyline","radialGradient","rect","stop","text","tspan"];d.forEach(function(e){f[e]=p,s[e]=!0}),e.exports=r},function(e,t){"use strict";function n(e){return e.Window&&e instanceof e.Window?{x:e.pageXOffset||e.document.documentElement.scrollLeft,y:e.pageYOffset||e.document.documentElement.scrollTop}:{x:e.scrollLeft,y:e.scrollTop}}e.exports=n},function(e,t){"use strict";function n(e){return e.replace(r,"-$1").toLowerCase()}var r=/([A-Z])/g;e.exports=n},function(e,t,n){"use strict";function r(e){return o(e).replace(i,"-ms-")}var o=n(108),i=/^ms-/;e.exports=r},function(e,t){"use strict";function n(e){var t=e?e.ownerDocument||e:document,n=t.defaultView||window;return!(!e||!("function"==typeof n.Node?e instanceof n.Node:"object"==typeof e&&"number"==typeof e.nodeType&&"string"==typeof e.nodeName))}e.exports=n},function(e,t,n){"use strict";function r(e){return o(e)&&3==e.nodeType}var o=n(110);e.exports=r},function(e,t){"use strict";function n(e){var t={};return function(n){return t.hasOwnProperty(n)||(t[n]=e.call(this,n)),t[n]}}e.exports=n},function(e,t){function n(e,t){var n,r=function(o){return e.length>1?function(){var i=o?o.concat():[];return n=t?n||this:this,i.push.apply(i,arguments)<e.length&&arguments.length?r.call(n,i):e.apply(n,i)}:e};return r()}var r,o,i,a,s,u,l={}.toString;r=n(function(e,t){return e.apply(null,t)}),o=function(e){return n(e)},i=n(function(e,t,n){return e(n,t)}),a=function(e){return function(t){return function(){return e(t(t)).apply(null,arguments)}}(function(t){return function(){return e(t(t)).apply(null,arguments)}})},s=n(function(e,t,n,r){return e(t(n),t(r))}),u=function(e){var t;return t={},function(){var n,r,o,i,a,s;for(r=[],o=0,i=arguments.length;o<i;++o)r.push(arguments[o]);return n=r,a=function(){var e,t,r,o=[];for(e=0,r=(t=n).length;e<r;++e)s=t[e],o.push(s+l.call(s).slice(8,-1));return o}().join(""),t[a]=a in t?t[a]:e.apply(null,n)}},e.exports={curry:o,flip:i,fix:a,apply:r,over:s,memoize:u}},function(e,t){function n(e,t){var n,r=function(o){return e.length>1?function(){var i=o?o.concat():[];return n=t?n||this:this,i.push.apply(i,arguments)<e.length&&arguments.length?r.call(n,i):e.apply(n,i)}:e};return r()}function r(e,t){for(var n=-1,r=t.length>>>0;++n<r;)if(e===t[n])return!0;return!1}function o(){var e=arguments;return function(){var t,n;for(n=e[0].apply(this,arguments),t=1;t<e.length;++t)n=e[t](n);return n}}function i(e){return!e}var a,s,u,l,c,p,f,d,h,m,v,g,y,b,C,_,w,E,T,x,O,P,k,S,N,M,A,I,D,R,L,U,F,j,B,V,W,H,q,z,K,Y,X,G,Q,$,Z,J,ee,te,ne,re,oe,ie,ae,se,ue,le,ce,pe,fe,de,he,me,ve,ge,ye,be,Ce,_e,we={}.toString;a=n(function(e,t){var n,r,o;for(n=0,r=t.length;n<r;++n)o=t[n],e(o);return t}),s=n(function(e,t){var n,r,o,i=[];for(n=0,r=t.length;n<r;++n)o=t[n],i.push(e(o));return i}),u=function(e){var t,n,r,o=[];for(t=0,n=e.length;t<n;++t)r=e[t],r&&o.push(r);return o},l=n(function(e,t){var n,r,o,i=[];for(n=0,r=t.length;n<r;++n)o=t[n],e(o)&&i.push(o);return i}),c=n(function(e,t){var n,r,o,i=[];for(n=0,r=t.length;n<r;++n)o=t[n],e(o)||i.push(o);return i}),p=n(function(e,t){var n,r;return n=ye(e,t),r=t.slice(),null!=n&&r.splice(n,1),r}),f=n(function(e,t){var n,r,o,i,a;for(n=[],r=[],o=0,i=t.length;o<i;++o)a=t[o],(e(a)?n:r).push(a);return[n,r]}),d=n(function(e,t){var n,r,o;for(n=0,r=t.length;n<r;++n)if(o=t[n],e(o))return o}),h=m=function(e){return e[0]},v=function(e){if(e.length)return e.slice(1)},g=function(e){return e[e.length-1]},y=function(e){if(e.length)return e.slice(0,-1)},b=function(e){return!e.length},C=function(e){return e.concat().reverse()},_=function(e){var t,n,o,i;for(t=[],n=0,o=e.length;n<o;++n)i=e[n],r(i,t)||t.push(i);return t},w=n(function(e,t){var n,o,i,a,s,u=[];for(n=[],o=0,i=t.length;o<i;++o)a=t[o],s=e(a),r(s,n)||(n.push(s),u.push(a));return u}),E=T=n(function(e,t,n){var r,o,i;for(r=0,o=n.length;r<o;++r)i=n[r],t=e(t,i);return t}),x=O=n(function(e,t){return E(e,t[0],t.slice(1))}),P=n(function(e,t,n){var r,o;for(r=n.length-1;r>=0;--r)o=n[r],t=e(o,t);return t}),k=n(function(e,t){return P(e,t[t.length-1],t.slice(0,-1))}),S=n(function(e,t){var n,r,o;for(n=[],r=t;null!=(o=e(r));)n.push(o[0]),r=o[1];return n}),N=function(e){return[].concat.apply([],e)},M=n(function(e,t){var n;
+return[].concat.apply([],function(){var r,o,i,a=[];for(r=0,i=(o=t).length;r<i;++r)n=o[r],a.push(e(n));return a}())}),A=function(e){var t;return[].concat.apply([],function(){var n,r,o,i=[];for(n=0,o=(r=e).length;n<o;++n)t=r[n],"Array"===we.call(t).slice(8,-1)?i.push(A(t)):i.push(t);return i}())},I=function(e){var t,n,o,i,a,s,u,l,c,p;for(n=[],o=1,i=arguments.length;o<i;++o)n.push(arguments[o]);t=n,a=[];e:for(o=0,s=e.length;o<s;++o){for(u=e[o],l=0,c=t.length;l<c;++l)if(p=t[l],r(u,p))continue e;a.push(u)}return a},D=function(e){var t,n,o,i,a,s,u,l,c,p;for(n=[],o=1,i=arguments.length;o<i;++o)n.push(arguments[o]);t=n,a=[];e:for(o=0,s=e.length;o<s;++o){for(u=e[o],l=0,c=t.length;l<c;++l)if(p=t[l],!r(u,p))continue e;a.push(u)}return a},R=function(){var e,t,n,o,i,a,s,u,l,c;for(t=[],n=0,o=arguments.length;n<o;++n)t.push(arguments[n]);for(e=t,i=[],n=0,a=e.length;n<a;++n)for(s=e[n],u=0,l=s.length;u<l;++u)c=s[u],r(c,i)||i.push(c);return i},L=n(function(e,t){var n,r,o,i,a;for(n={},r=0,o=t.length;r<o;++r)i=t[r],a=e(i),a in n?n[a]+=1:n[a]=1;return n}),U=n(function(e,t){var n,r,o,i,a;for(n={},r=0,o=t.length;r<o;++r)i=t[r],a=e(i),a in n?n[a].push(i):n[a]=[i];return n}),F=function(e){var t,n,r;for(t=0,n=e.length;t<n;++t)if(r=e[t],!r)return!1;return!0},j=function(e){var t,n,r;for(t=0,n=e.length;t<n;++t)if(r=e[t])return!0;return!1},B=n(function(e,t){var n,r,o;for(n=0,r=t.length;n<r;++n)if(o=t[n],e(o))return!0;return!1}),V=n(function(e,t){var n,r,o;for(n=0,r=t.length;n<r;++n)if(o=t[n],!e(o))return!1;return!0}),W=function(e){return e.concat().sort(function(e,t){return e>t?1:e<t?-1:0})},H=n(function(e,t){return t.concat().sort(e)}),q=n(function(e,t){return t.concat().sort(function(t,n){return e(t)>e(n)?1:e(t)<e(n)?-1:0})}),z=function(e){var t,n,r,o;for(t=0,n=0,r=e.length;n<r;++n)o=e[n],t+=o;return t},K=function(e){var t,n,r,o;for(t=1,n=0,r=e.length;n<r;++n)o=e[n],t*=o;return t},Y=X=function(e){var t,n,r,o;for(t=0,n=0,r=e.length;n<r;++n)o=e[n],t+=o;return t/e.length},G=function(e){var t,n,r,o,i;for(t=e[0],n=0,o=(r=e.slice(1)).length;n<o;++n)i=r[n],i>t&&(t=i);return t},Q=function(e){var t,n,r,o,i;for(t=e[0],n=0,o=(r=e.slice(1)).length;n<o;++n)i=r[n],i<t&&(t=i);return t},$=n(function(e,t){var n,r,o,i,a;for(n=t[0],r=0,i=(o=t.slice(1)).length;r<i;++r)a=o[r],e(a)>e(n)&&(n=a);return n}),Z=n(function(e,t){var n,r,o,i,a;for(n=t[0],r=0,i=(o=t.slice(1)).length;r<i;++r)a=o[r],e(a)<e(n)&&(n=a);return n}),J=ee=n(function(e,t,n){var r,o;return r=t,[t].concat(function(){var t,i,a,s=[];for(t=0,a=(i=n).length;t<a;++t)o=i[t],s.push(r=e(r,o));return s}())}),te=ne=n(function(e,t){if(t.length)return J(e,t[0],t.slice(1))}),re=n(function(e,t,n){return n=n.concat().reverse(),J(e,t,n).reverse()}),oe=n(function(e,t){if(t.length)return t=t.concat().reverse(),J(e,t[0],t.slice(1)).reverse()}),ie=n(function(e,t,n){return n.slice(e,t)}),ae=n(function(e,t){return e<=0?t.slice(0,0):t.slice(0,e)}),se=n(function(e,t){return e<=0?t:t.slice(e)}),ue=n(function(e,t){return[ae(e,t),se(e,t)]}),le=n(function(e,t){var n,r;if(n=t.length,!n)return t;for(r=0;r<n&&e(t[r]);)r+=1;return t.slice(0,r)}),ce=n(function(e,t){var n,r;if(n=t.length,!n)return t;for(r=0;r<n&&e(t[r]);)r+=1;return t.slice(r)}),pe=n(function(e,t){return[le(e,t),ce(e,t)]}),fe=n(function(e,t){return pe(o(e,i),t)}),de=n(function(e,t){var n,r,o,i,a,s;for(n=[],r=t.length,o=0,i=e.length;o<i&&(a=o,s=e[o],a!==r);++o)n.push([s,t[a]]);return n}),he=n(function(e,t,n){var r,o,i,a,s,u;for(r=[],o=n.length,i=0,a=t.length;i<a&&(s=i,u=t[i],s!==o);++i)r.push(e(u,n[s]));return r}),me=function(){var e,t,n,r,o,i,a,s,u,l,c,p=[];for(t=[],n=0,r=arguments.length;n<r;++n)t.push(arguments[n]);for(e=t,o=void 0,n=0,i=e.length;n<i;++n)a=e[n],o<=(s=a.length)||(o=s);for(n=0;n<o;++n){for(u=n,l=[],c=0,i=e.length;c<i;++c)a=e[c],l.push(a[u]);p.push(l)}return p},ve=function(e){function t(){var e,t,r,o=[];for(e=0,r=(t=n).length;e<r;++e)u=t[e],o.push(u[c]);return o}var n,r,o,i,a,s,u,l,c,p=[];for(r=[],o=1,i=arguments.length;o<i;++o)r.push(arguments[o]);for(n=r,a=void 0,o=0,s=n.length;o<s;++o)u=n[o],a<=(l=u.length)||(a=l);for(o=0;o<a;++o)c=o,p.push(e.apply(null,t()));return p},ge=n(function(e,t){return e<0?t[t.length+e]:t[e]}),ye=n(function(e,t){var n,r,o,i;for(n=0,r=t.length;n<r;++n)if(o=n,i=t[n],i===e)return o}),be=n(function(e,t){var n,r,o,i,a=[];for(n=0,r=t.length;n<r;++n)o=n,i=t[n],i===e&&a.push(o);return a}),Ce=n(function(e,t){var n,r,o,i;for(n=0,r=t.length;n<r;++n)if(o=n,i=t[n],e(i))return o}),_e=n(function(e,t){var n,r,o,i,a=[];for(n=0,r=t.length;n<r;++n)o=n,i=t[n],e(i)&&a.push(o);return a}),e.exports={each:a,map:s,filter:l,compact:u,reject:c,remove:p,partition:f,find:d,head:h,first:m,tail:v,last:g,initial:y,empty:b,reverse:C,difference:I,intersection:D,union:R,countBy:L,groupBy:U,fold:E,fold1:x,foldl:T,foldl1:O,foldr:P,foldr1:k,unfoldr:S,andList:F,orList:j,any:B,all:V,unique:_,uniqueBy:w,sort:W,sortWith:H,sortBy:q,sum:z,product:K,mean:Y,average:X,concat:N,concatMap:M,flatten:A,maximum:G,minimum:Q,maximumBy:$,minimumBy:Z,scan:J,scan1:te,scanl:ee,scanl1:ne,scanr:re,scanr1:oe,slice:ie,take:ae,drop:se,splitAt:ue,takeWhile:le,dropWhile:ce,span:pe,breakList:fe,zip:de,zipWith:he,zipAll:me,zipAllWith:ve,at:ge,elemIndex:ye,elemIndices:be,findIndex:Ce,findIndices:_e}},function(e,t){function n(e,t){var n,r=function(o){return e.length>1?function(){var i=o?o.concat():[];return n=t?n||this:this,i.push.apply(i,arguments)<e.length&&arguments.length?r.call(n,i):e.apply(n,i)}:e};return r()}var r,o,i,a,s,u,l,c,p,f,d,h,m,v,g,y,b,C,_,w,E,T,x,O,P,k,S,N,M,A,I,D;r=n(function(e,t){return e>t?e:t}),o=n(function(e,t){return e<t?e:t}),i=function(e){return-e},a=Math.abs,s=function(e){return e<0?-1:e>0?1:0},u=n(function(e,t){return~~(e/t)}),l=n(function(e,t){return e%t}),c=n(function(e,t){return Math.floor(e/t)}),p=n(function(e,t){var n;return(e%(n=t)+n)%n}),f=function(e){return 1/e},d=Math.PI,h=2*d,m=Math.exp,v=Math.sqrt,g=Math.log,y=n(function(e,t){return Math.pow(e,t)}),b=Math.sin,C=Math.tan,_=Math.cos,w=Math.asin,E=Math.acos,T=Math.atan,x=n(function(e,t){return Math.atan2(e,t)}),O=function(e){return~~e},P=Math.round,k=Math.ceil,S=Math.floor,N=function(e){return e!==e},M=function(e){return e%2===0},A=function(e){return e%2!==0},I=n(function(e,t){var n;for(e=Math.abs(e),t=Math.abs(t);0!==t;)n=e%t,e=t,t=n;return e}),D=n(function(e,t){return Math.abs(Math.floor(e/I(e,t)*t))}),e.exports={max:r,min:o,negate:i,abs:a,signum:s,quot:u,rem:l,div:c,mod:p,recip:f,pi:d,tau:h,exp:m,sqrt:v,ln:g,pow:y,sin:b,tan:C,cos:_,acos:E,asin:w,atan:T,atan2:x,truncate:O,round:P,ceiling:k,floor:S,isItNaN:N,even:M,odd:A,gcd:I,lcm:D}},function(e,t){function n(e,t){var n,r=function(o){return e.length>1?function(){var i=o?o.concat():[];return n=t?n||this:this,i.push.apply(i,arguments)<e.length&&arguments.length?r.call(n,i):e.apply(n,i)}:e};return r()}var r,o,i,a,s,u,l,c,p,f,d,h,m,v;r=function(e){var t,n,r=[];for(t in e)n=e[t],r.push(n);return r},o=function(e){var t,n=[];for(t in e)n.push(t);return n},i=function(e){var t,n,r,o={};for(t=0,n=e.length;t<n;++t)r=e[t],o[r[0]]=r[1];return o},a=function(e){var t,n,r=[];for(t in e)n=e[t],r.push([t,n]);return r},s=n(function(e,t){var n,r,o,i,a={};for(n=0,r=e.length;n<r;++n)o=n,i=e[n],a[i]=t[o];return a}),u=function(e){var t,n,r,o;t=[],n=[];for(r in e)o=e[r],t.push(r),n.push(o);return[t,n]},l=function(e){var t;for(t in e)return!1;return!0},c=n(function(e,t){var n,r;for(n in t)r=t[n],e(r);return t}),p=n(function(e,t){var n,r,o={};for(n in t)r=t[n],o[n]=e(r);return o}),f=function(e){var t,n,r={};for(t in e)n=e[t],n&&(r[t]=n);return r},d=n(function(e,t){var n,r,o={};for(n in t)r=t[n],e(r)&&(o[n]=r);return o}),h=n(function(e,t){var n,r,o={};for(n in t)r=t[n],e(r)||(o[n]=r);return o}),m=n(function(e,t){var n,r,o,i;n={},r={};for(o in t)i=t[o],(e(i)?n:r)[o]=i;return[n,r]}),v=n(function(e,t){var n,r;for(n in t)if(r=t[n],e(r))return r}),e.exports={values:r,keys:o,pairsToObj:i,objToPairs:a,listsToObj:s,objToLists:u,empty:l,each:c,map:p,filter:d,compact:f,reject:h,partition:m,find:v}},function(e,t){function n(e,t){var n,r=function(o){return e.length>1?function(){var i=o?o.concat():[];return n=t?n||this:this,i.push.apply(i,arguments)<e.length&&arguments.length?r.call(n,i):e.apply(n,i)}:e};return r()}var r,o,i,a,s,u,l,c,p,f,d,h,m;r=n(function(e,t){return t.split(e)}),o=n(function(e,t){return t.join(e)}),i=function(e){return e.length?e.split("\n"):[]},a=function(e){return e.join("\n")},s=function(e){return e.length?e.split(/[ ]+/):[]},u=function(e){return e.join(" ")},l=function(e){return e.split("")},c=function(e){return e.join("")},p=function(e){return e.split("").reverse().join("")},f=n(function(e,t){var n,r;for(n="",r=0;r<e;++r)n+=t;return n}),d=function(e){return e.charAt(0).toUpperCase()+e.slice(1)},h=function(e){return e.replace(/[-_]+(.)?/g,function(e,t){return(null!=t?t:"").toUpperCase()})},m=function(e){return e.replace(/([^-A-Z])([A-Z]+)/g,function(e,t,n){return t+"-"+(n.length>1?n:n.toLowerCase())}).replace(/^([A-Z]+)/,function(e,t){return t.length>1?t+"-":t.toLowerCase()})},e.exports={split:r,join:o,lines:i,unlines:a,words:s,unwords:u,chars:l,unchars:c,reverse:p,repeat:f,capitalize:d,camelize:h,dasherize:m}},[227,113,114,116,117,115],function(e,t,n){"use strict";function r(e){var t=new o(o._61);return t._81=1,t._65=e,t}var o=n(61);e.exports=o;var i=r(!0),a=r(!1),s=r(null),u=r(void 0),l=r(0),c=r("");o.resolve=function(e){if(e instanceof o)return e;if(null===e)return s;if(void 0===e)return u;if(e===!0)return i;if(e===!1)return a;if(0===e)return l;if(""===e)return c;if("object"==typeof e||"function"==typeof e)try{var t=e.then;if("function"==typeof t)return new o(t.bind(e))}catch(e){return new o(function(t,n){n(e)})}return r(e)},o.all=function(e){var t=Array.prototype.slice.call(e);return new o(function(e,n){function r(a,s){if(s&&("object"==typeof s||"function"==typeof s)){if(s instanceof o&&s.then===o.prototype.then){for(;3===s._81;)s=s._65;return 1===s._81?r(a,s._65):(2===s._81&&n(s._65),void s.then(function(e){r(a,e)},n))}var u=s.then;if("function"==typeof u){var l=new o(u.bind(s));return void l.then(function(e){r(a,e)},n)}}t[a]=s,0===--i&&e(t)}if(0===t.length)return e([]);for(var i=t.length,a=0;a<t.length;a++)r(a,t[a])})},o.reject=function(e){return new o(function(t,n){n(e)})},o.race=function(e){return new o(function(t,n){e.forEach(function(e){o.resolve(e).then(t,n)})})},o.prototype.catch=function(e){return this.then(null,e)}},function(e,t,n){"use strict";function r(){l=!1,s._10=null,s._97=null}function o(e){function t(t){(e.allRejections||a(p[t].error,e.whitelist||u))&&(p[t].displayId=c++,e.onUnhandled?(p[t].logged=!0,e.onUnhandled(p[t].displayId,p[t].error)):(p[t].logged=!0,i(p[t].displayId,p[t].error)))}function n(t){p[t].logged&&(e.onHandled?e.onHandled(p[t].displayId,p[t].error):p[t].onUnhandled||(console.warn("Promise Rejection Handled (id: "+p[t].displayId+"):"),console.warn('  This means you can ignore any previous messages of the form "Possible Unhandled Promise Rejection" with id '+p[t].displayId+".")))}e=e||{},l&&r(),l=!0;var o=0,c=0,p={};s._10=function(e){2===e._81&&p[e._72]&&(p[e._72].logged?n(e._72):clearTimeout(p[e._72].timeout),delete p[e._72])},s._97=function(e,n){0===e._45&&(e._72=o++,p[e._72]={displayId:null,error:n,timeout:setTimeout(t.bind(null,e._72),a(n,u)?100:2e3),logged:!1})}}function i(e,t){console.warn("Possible Unhandled Promise Rejection (id: "+e+"):");var n=(t&&(t.stack||t))+"";n.split("\n").forEach(function(e){console.warn("  "+e)})}function a(e,t){return t.some(function(t){return e instanceof t})}var s=n(61),u=[ReferenceError,TypeError,RangeError],l=!1;t.disable=r,t.enable=o},function(e,t,n){"use strict";function r(e,t,n,r,o){}e.exports=r},function(e,t,n){"use strict";var r=n(8),o=n(1),i=(n(2),n(123)),a=n(121);e.exports=function(e,t){function n(e){var t=e&&(x&&e[x]||e[O]);if("function"==typeof t)return t}function s(e,t){return e===t?0!==e||1/e===1/t:e!==e&&t!==t}function u(e){this.message=e,this.stack=""}function l(e){function n(n,r,a,s,l,c,p){if(s=s||P,c=c||a,p!==i)if(t)o(!1,"Calling PropTypes validators directly is not supported by the `prop-types` package. Use `PropTypes.checkPropTypes()` to call them. Read more at http://fb.me/use-check-prop-types");else;return null==r[a]?n?new u(null===r[a]?"The "+l+" `"+c+"` is marked as required "+("in `"+s+"`, but its value is `null`."):"The "+l+" `"+c+"` is marked as required in "+("`"+s+"`, but its value is `undefined`.")):null:e(r,a,s,l,c)}var r=n.bind(null,!1);return r.isRequired=n.bind(null,!0),r}function c(e){function t(t,n,r,o,i,a){var s=t[n],l=w(s);if(l!==e){var c=E(s);return new u("Invalid "+o+" `"+i+"` of type "+("`"+c+"` supplied to `"+r+"`, expected ")+("`"+e+"`."))}return null}return l(t)}function p(){return l(r.thatReturnsNull)}function f(e){function t(t,n,r,o,a){if("function"!=typeof e)return new u("Property `"+a+"` of component `"+r+"` has invalid PropType notation inside arrayOf.");var s=t[n];if(!Array.isArray(s)){var l=w(s);return new u("Invalid "+o+" `"+a+"` of type "+("`"+l+"` supplied to `"+r+"`, expected an array."))}for(var c=0;c<s.length;c++){var p=e(s,c,r,o,a+"["+c+"]",i);if(p instanceof Error)return p}return null}return l(t)}function d(){function t(t,n,r,o,i){var a=t[n];if(!e(a)){var s=w(a);return new u("Invalid "+o+" `"+i+"` of type "+("`"+s+"` supplied to `"+r+"`, expected a single ReactElement."))}return null}return l(t)}function h(e){function t(t,n,r,o,i){if(!(t[n]instanceof e)){var a=e.name||P,s=T(t[n]);return new u("Invalid "+o+" `"+i+"` of type "+("`"+s+"` supplied to `"+r+"`, expected ")+("instance of `"+a+"`."))}return null}return l(t)}function m(e){function t(t,n,r,o,i){for(var a=t[n],l=0;l<e.length;l++)if(s(a,e[l]))return null;var c=JSON.stringify(e);return new u("Invalid "+o+" `"+i+"` of value `"+a+"` "+("supplied to `"+r+"`, expected one of "+c+"."))}return Array.isArray(e)?l(t):r.thatReturnsNull}function v(e){function t(t,n,r,o,a){if("function"!=typeof e)return new u("Property `"+a+"` of component `"+r+"` has invalid PropType notation inside objectOf.");var s=t[n],l=w(s);if("object"!==l)return new u("Invalid "+o+" `"+a+"` of type "+("`"+l+"` supplied to `"+r+"`, expected an object."));for(var c in s)if(s.hasOwnProperty(c)){var p=e(s,c,r,o,a+"."+c,i);if(p instanceof Error)return p}return null}return l(t)}function g(e){function t(t,n,r,o,a){for(var s=0;s<e.length;s++){var l=e[s];if(null==l(t,n,r,o,a,i))return null}return new u("Invalid "+o+" `"+a+"` supplied to "+("`"+r+"`."))}return Array.isArray(e)?l(t):r.thatReturnsNull}function y(){function e(e,t,n,r,o){return C(e[t])?null:new u("Invalid "+r+" `"+o+"` supplied to "+("`"+n+"`, expected a ReactNode."))}return l(e)}function b(e){function t(t,n,r,o,a){var s=t[n],l=w(s);if("object"!==l)return new u("Invalid "+o+" `"+a+"` of type `"+l+"` "+("supplied to `"+r+"`, expected `object`."));for(var c in e){var p=e[c];if(p){var f=p(s,c,r,o,a+"."+c,i);if(f)return f}}return null}return l(t)}function C(t){switch(typeof t){case"number":case"string":case"undefined":return!0;case"boolean":return!t;case"object":if(Array.isArray(t))return t.every(C);if(null===t||e(t))return!0;var r=n(t);if(!r)return!1;var o,i=r.call(t);if(r!==t.entries){for(;!(o=i.next()).done;)if(!C(o.value))return!1}else for(;!(o=i.next()).done;){var a=o.value;if(a&&!C(a[1]))return!1}return!0;default:return!1}}function _(e,t){return"symbol"===e||("Symbol"===t["@@toStringTag"]||"function"==typeof Symbol&&t instanceof Symbol)}function w(e){var t=typeof e;return Array.isArray(e)?"array":e instanceof RegExp?"object":_(t,e)?"symbol":t}function E(e){var t=w(e);if("object"===t){if(e instanceof Date)return"date";if(e instanceof RegExp)return"regexp"}return t}function T(e){return e.constructor&&e.constructor.name?e.constructor.name:P}var x="function"==typeof Symbol&&Symbol.iterator,O="@@iterator",P="<<anonymous>>",k={array:c("array"),bool:c("boolean"),func:c("function"),number:c("number"),object:c("object"),string:c("string"),symbol:c("symbol"),any:p(),arrayOf:f,element:d(),instanceOf:h,node:y(),objectOf:v,oneOf:m,oneOfType:g,shape:b};return u.prototype=Error.prototype,k.checkPropTypes=a,k.PropTypes=k,k}},function(e,t){"use strict";var n="SECRET_DO_NOT_PASS_THIS_OR_YOU_WILL_BE_FIRED";e.exports=n},function(e,t){"use strict";function n(e,t){return e===t?0!==e||0!==t||1/e===1/t:e!==e&&t!==t}function r(e,t){if(n(e,t))return!0;if("object"!=typeof e||null===e||"object"!=typeof t||null===t)return!1;var r=Object.keys(e),o=Object.keys(t);if(r.length!==o.length)return!1;for(var a=0;a<r.length;a++)if(!i.call(t,r[a])||!n(e[r[a]],t[r[a]]))return!1;return!0}function o(e,t,n){return!r(e.props,t)||!r(e.state,n)}var i=Object.prototype.hasOwnProperty;e.exports=o},function(e,t){"use strict";var n={Properties:{"aria-current":0,"aria-details":0,"aria-disabled":0,"aria-hidden":0,"aria-invalid":0,"aria-keyshortcuts":0,"aria-label":0,"aria-roledescription":0,"aria-autocomplete":0,"aria-checked":0,"aria-expanded":0,"aria-haspopup":0,"aria-level":0,"aria-modal":0,"aria-multiline":0,"aria-multiselectable":0,"aria-orientation":0,"aria-placeholder":0,"aria-pressed":0,"aria-readonly":0,"aria-required":0,"aria-selected":0,"aria-sort":0,"aria-valuemax":0,"aria-valuemin":0,"aria-valuenow":0,"aria-valuetext":0,"aria-atomic":0,"aria-busy":0,"aria-live":0,"aria-relevant":0,"aria-dropeffect":0,"aria-grabbed":0,"aria-activedescendant":0,"aria-colcount":0,"aria-colindex":0,"aria-colspan":0,"aria-controls":0,"aria-describedby":0,"aria-errormessage":0,"aria-flowto":0,"aria-labelledby":0,"aria-owns":0,"aria-posinset":0,"aria-rowcount":0,"aria-rowindex":0,"aria-rowspan":0,"aria-setsize":0},DOMAttributeNames:{},DOMPropertyNames:{}};e.exports=n},function(e,t,n){"use strict";var r=n(6),o=n(58),i={focusDOMComponent:function(){o(r.getNodeFromInstance(this))}};e.exports=i},function(e,t,n){"use strict";function r(){var e=window.opera;return"object"==typeof e&&"function"==typeof e.version&&parseInt(e.version(),10)<=12}function o(e){return(e.ctrlKey||e.altKey||e.metaKey)&&!(e.ctrlKey&&e.altKey)}function i(e){switch(e){case"topCompositionStart":return O.compositionStart;case"topCompositionEnd":return O.compositionEnd;case"topCompositionUpdate":return O.compositionUpdate}}function a(e,t){return"topKeyDown"===e&&t.keyCode===b}function s(e,t){switch(e){case"topKeyUp":return y.indexOf(t.keyCode)!==-1;case"topKeyDown":return t.keyCode!==b;case"topKeyPress":case"topMouseDown":case"topBlur":return!0;default:return!1}}function u(e){var t=e.detail;return"object"==typeof t&&"data"in t?t.data:null}function l(e,t,n,r){var o,l;if(C?o=i(e):k?s(e,n)&&(o=O.compositionEnd):a(e,n)&&(o=O.compositionStart),!o)return null;E&&(k||o!==O.compositionStart?o===O.compositionEnd&&k&&(l=k.getData()):k=m.getPooled(r));var c=v.getPooled(o,t,n,r);if(l)c.data=l;else{var p=u(n);null!==p&&(c.data=p)}return d.accumulateTwoPhaseDispatches(c),c}function c(e,t){switch(e){case"topCompositionEnd":return u(t);case"topKeyPress":var n=t.which;return n!==T?null:(P=!0,x);case"topTextInput":var r=t.data;return r===x&&P?null:r;default:return null}}function p(e,t){if(k){if("topCompositionEnd"===e||!C&&s(e,t)){var n=k.getData();return m.release(k),k=null,n}return null}switch(e){case"topPaste":return null;case"topKeyPress":return t.which&&!o(t)?String.fromCharCode(t.which):null;case"topCompositionEnd":return E?null:t.data;default:return null}}function f(e,t,n,r){var o;if(o=w?c(e,n):p(e,n),!o)return null;var i=g.getPooled(O.beforeInput,t,n,r);return i.data=o,d.accumulateTwoPhaseDispatches(i),i}var d=n(25),h=n(7),m=n(133),v=n(170),g=n(173),y=[9,13,27,32],b=229,C=h.canUseDOM&&"CompositionEvent"in window,_=null;h.canUseDOM&&"documentMode"in document&&(_=document.documentMode);var w=h.canUseDOM&&"TextEvent"in window&&!_&&!r(),E=h.canUseDOM&&(!C||_&&_>8&&_<=11),T=32,x=String.fromCharCode(T),O={beforeInput:{phasedRegistrationNames:{bubbled:"onBeforeInput",captured:"onBeforeInputCapture"},dependencies:["topCompositionEnd","topKeyPress","topTextInput","topPaste"]},compositionEnd:{phasedRegistrationNames:{bubbled:"onCompositionEnd",captured:"onCompositionEndCapture"},dependencies:["topBlur","topCompositionEnd","topKeyDown","topKeyPress","topKeyUp","topMouseDown"]},compositionStart:{phasedRegistrationNames:{bubbled:"onCompositionStart",captured:"onCompositionStartCapture"},dependencies:["topBlur","topCompositionStart","topKeyDown","topKeyPress","topKeyUp","topMouseDown"]},compositionUpdate:{phasedRegistrationNames:{bubbled:"onCompositionUpdate",captured:"onCompositionUpdateCapture"},dependencies:["topBlur","topCompositionUpdate","topKeyDown","topKeyPress","topKeyUp","topMouseDown"]}},P=!1,k=null,S={eventTypes:O,extractEvents:function(e,t,n,r){return[l(e,t,n,r),f(e,t,n,r)]}};e.exports=S},function(e,t,n){"use strict";var r=n(64),o=n(7),i=(n(9),n(102),n(179)),a=n(109),s=n(112),u=(n(2),s(function(e){return a(e)})),l=!1,c="cssFloat";if(o.canUseDOM){var p=document.createElement("div").style;try{p.font=""}catch(e){l=!0}void 0===document.documentElement.style.cssFloat&&(c="styleFloat")}var f={createMarkupForStyles:function(e,t){var n="";for(var r in e)if(e.hasOwnProperty(r)){var o=e[r];null!=o&&(n+=u(r)+":",n+=i(r,o,t)+";")}return n||null},setValueForStyles:function(e,t,n){var o=e.style;for(var a in t)if(t.hasOwnProperty(a)){var s=i(a,t[a],n);if("float"!==a&&"cssFloat"!==a||(a=c),s)o[a]=s;else{var u=l&&r.shorthandPropertyExpansions[a];if(u)for(var p in u)o[p]="";else o[a]=""}}}};e.exports=f},function(e,t,n){"use strict";function r(e){var t=e.nodeName&&e.nodeName.toLowerCase();return"select"===t||"input"===t&&"file"===e.type}function o(e){var t=T.getPooled(k.change,N,e,x(e));C.accumulateTwoPhaseDispatches(t),E.batchedUpdates(i,t)}function i(e){b.enqueueEvents(e),b.processEventQueue(!1)}function a(e,t){S=e,N=t,S.attachEvent("onchange",o)}function s(){S&&(S.detachEvent("onchange",o),S=null,N=null)}function u(e,t){if("topChange"===e)return t}function l(e,t,n){"topFocus"===e?(s(),a(t,n)):"topBlur"===e&&s()}function c(e,t){S=e,N=t,M=e.value,A=Object.getOwnPropertyDescriptor(e.constructor.prototype,"value"),Object.defineProperty(S,"value",R),S.attachEvent?S.attachEvent("onpropertychange",f):S.addEventListener("propertychange",f,!1)}function p(){S&&(delete S.value,S.detachEvent?S.detachEvent("onpropertychange",f):S.removeEventListener("propertychange",f,!1),S=null,N=null,M=null,A=null)}function f(e){if("value"===e.propertyName){var t=e.srcElement.value;t!==M&&(M=t,o(e))}}function d(e,t){if("topInput"===e)return t}function h(e,t,n){"topFocus"===e?(p(),c(t,n)):"topBlur"===e&&p()}function m(e,t){if(("topSelectionChange"===e||"topKeyUp"===e||"topKeyDown"===e)&&S&&S.value!==M)return M=S.value,N}function v(e){return e.nodeName&&"input"===e.nodeName.toLowerCase()&&("checkbox"===e.type||"radio"===e.type)}function g(e,t){if("topClick"===e)return t}function y(e,t){if(null!=e){var n=e._wrapperState||t._wrapperState;if(n&&n.controlled&&"number"===t.type){var r=""+t.value;t.getAttribute("value")!==r&&t.setAttribute("value",r)}}}var b=n(24),C=n(25),_=n(7),w=n(6),E=n(10),T=n(11),x=n(49),O=n(50),P=n(81),k={change:{phasedRegistrationNames:{bubbled:"onChange",captured:"onChangeCapture"},dependencies:["topBlur","topChange","topClick","topFocus","topInput","topKeyDown","topKeyUp","topSelectionChange"]}},S=null,N=null,M=null,A=null,I=!1;_.canUseDOM&&(I=O("change")&&(!document.documentMode||document.documentMode>8));var D=!1;_.canUseDOM&&(D=O("input")&&(!document.documentMode||document.documentMode>11));var R={get:function(){return A.get.call(this)},set:function(e){M=""+e,A.set.call(this,e)}},L={eventTypes:k,extractEvents:function(e,t,n,o){var i,a,s=t?w.getNodeFromInstance(t):window;if(r(s)?I?i=u:a=l:P(s)?D?i=d:(i=m,a=h):v(s)&&(i=g),i){var c=i(e,t);if(c){var p=T.getPooled(k.change,c,n,o);return p.type="change",C.accumulateTwoPhaseDispatches(p),p}}a&&a(e,s,t),"topBlur"===e&&y(t,s)}};e.exports=L},function(e,t,n){"use strict";var r=n(3),o=n(17),i=n(7),a=n(105),s=n(8),u=(n(1),{dangerouslyReplaceNodeWithMarkup:function(e,t){if(i.canUseDOM?void 0:r("56"),t?void 0:r("57"),"HTML"===e.nodeName?r("58"):void 0,"string"==typeof t){var n=a(t,s)[0];e.parentNode.replaceChild(n,e)}else o.replaceChildWithTree(e,t)}});e.exports=u},function(e,t){"use strict";var n=["ResponderEventPlugin","SimpleEventPlugin","TapEventPlugin","EnterLeaveEventPlugin","ChangeEventPlugin","SelectEventPlugin","BeforeInputEventPlugin"];e.exports=n},function(e,t,n){"use strict";var r=n(25),o=n(6),i=n(30),a={mouseEnter:{registrationName:"onMouseEnter",dependencies:["topMouseOut","topMouseOver"]},mouseLeave:{registrationName:"onMouseLeave",dependencies:["topMouseOut","topMouseOver"]}},s={eventTypes:a,extractEvents:function(e,t,n,s){if("topMouseOver"===e&&(n.relatedTarget||n.fromElement))return null;if("topMouseOut"!==e&&"topMouseOver"!==e)return null;var u;if(s.window===s)u=s;else{var l=s.ownerDocument;u=l?l.defaultView||l.parentWindow:window}var c,p;if("topMouseOut"===e){c=t;var f=n.relatedTarget||n.toElement;p=f?o.getClosestInstanceFromNode(f):null}else c=null,p=t;if(c===p)return null;var d=null==c?u:o.getNodeFromInstance(c),h=null==p?u:o.getNodeFromInstance(p),m=i.getPooled(a.mouseLeave,c,n,s);m.type="mouseleave",m.target=d,m.relatedTarget=h;var v=i.getPooled(a.mouseEnter,p,n,s);return v.type="mouseenter",v.target=h,v.relatedTarget=d,r.accumulateEnterLeaveDispatches(m,v,c,p),[m,v]}};e.exports=s},function(e,t,n){"use strict";function r(e){this._root=e,this._startText=this.getText(),this._fallbackText=null}var o=n(4),i=n(14),a=n(79);o(r.prototype,{destructor:function(){this._root=null,this._startText=null,this._fallbackText=null},getText:function(){return"value"in this._root?this._root.value:this._root[a()]},getData:function(){if(this._fallbackText)return this._fallbackText;var e,t,n=this._startText,r=n.length,o=this.getText(),i=o.length;for(e=0;e<r&&n[e]===o[e];e++);var a=r-e;for(t=1;t<=a&&n[r-t]===o[i-t];t++);var s=t>1?1-t:void 0;return this._fallbackText=o.slice(e,s),this._fallbackText}}),i.addPoolingTo(r),e.exports=r},function(e,t,n){"use strict";var r=n(18),o=r.injection.MUST_USE_PROPERTY,i=r.injection.HAS_BOOLEAN_VALUE,a=r.injection.HAS_NUMERIC_VALUE,s=r.injection.HAS_POSITIVE_NUMERIC_VALUE,u=r.injection.HAS_OVERLOADED_BOOLEAN_VALUE,l={isCustomAttribute:RegExp.prototype.test.bind(new RegExp("^(data|aria)-["+r.ATTRIBUTE_NAME_CHAR+"]*$")),Properties:{accept:0,acceptCharset:0,accessKey:0,action:0,allowFullScreen:i,allowTransparency:0,alt:0,as:0,async:i,autoComplete:0,autoPlay:i,capture:i,cellPadding:0,cellSpacing:0,charSet:0,challenge:0,checked:o|i,cite:0,classID:0,className:0,cols:s,colSpan:0,content:0,contentEditable:0,contextMenu:0,controls:i,coords:0,crossOrigin:0,data:0,dateTime:0,default:i,defer:i,dir:0,disabled:i,download:u,draggable:0,encType:0,form:0,formAction:0,formEncType:0,formMethod:0,formNoValidate:i,formTarget:0,frameBorder:0,headers:0,height:0,hidden:i,high:0,href:0,hrefLang:0,htmlFor:0,httpEquiv:0,icon:0,id:0,inputMode:0,integrity:0,is:0,keyParams:0,keyType:0,kind:0,label:0,lang:0,list:0,loop:i,low:0,manifest:0,marginHeight:0,marginWidth:0,max:0,maxLength:0,media:0,mediaGroup:0,method:0,min:0,minLength:0,multiple:o|i,muted:o|i,name:0,nonce:0,noValidate:i,open:i,optimum:0,pattern:0,placeholder:0,playsInline:i,poster:0,preload:0,profile:0,radioGroup:0,readOnly:i,referrerPolicy:0,rel:0,required:i,reversed:i,role:0,rows:s,rowSpan:a,sandbox:0,scope:0,scoped:i,scrolling:0,seamless:i,selected:o|i,shape:0,size:s,sizes:0,span:s,spellCheck:0,src:0,srcDoc:0,srcLang:0,srcSet:0,start:a,step:0,style:0,summary:0,tabIndex:0,target:0,title:0,type:0,useMap:0,value:0,width:0,wmode:0,wrap:0,about:0,datatype:0,inlist:0,prefix:0,property:0,resource:0,typeof:0,vocab:0,autoCapitalize:0,autoCorrect:0,autoSave:0,color:0,itemProp:0,itemScope:i,itemType:0,itemID:0,itemRef:0,results:0,security:0,unselectable:0},DOMAttributeNames:{acceptCharset:"accept-charset",className:"class",htmlFor:"for",httpEquiv:"http-equiv"},DOMPropertyNames:{},DOMMutationMethods:{value:function(e,t){return null==t?e.removeAttribute("value"):void("number"!==e.type||e.hasAttribute("value")===!1?e.setAttribute("value",""+t):e.validity&&!e.validity.badInput&&e.ownerDocument.activeElement!==e&&e.setAttribute("value",""+t))}}};e.exports=l},function(e,t,n){(function(t){"use strict";function r(e,t,n,r){var o=void 0===e[n];null!=t&&o&&(e[n]=i(t,!0))}var o=n(19),i=n(80),a=(n(41),n(51)),s=n(83),u=(n(2),{instantiateChildren:function(e,t,n,o){if(null==e)return null;var i={};return s(e,r,i),i},updateChildren:function(e,t,n,r,s,u,l,c,p){if(t||e){var f,d;for(f in t)if(t.hasOwnProperty(f)){d=e&&e[f];var h=d&&d._currentElement,m=t[f];if(null!=d&&a(h,m))o.receiveComponent(d,m,s,c),t[f]=d;else{d&&(r[f]=o.getHostNode(d),o.unmountComponent(d,!1));var v=i(m,!0);t[f]=v;var g=o.mountComponent(v,s,u,l,c,p);n.push(g)}}for(f in e)!e.hasOwnProperty(f)||t&&t.hasOwnProperty(f)||(d=e[f],r[f]=o.getHostNode(d),o.unmountComponent(d,!1))}},unmountChildren:function(e,t){for(var n in e)if(e.hasOwnProperty(n)){var r=e[n];o.unmountComponent(r,t)}}});e.exports=u}).call(t,n(60))},function(e,t,n){"use strict";var r=n(37),o=n(143),i={processChildrenUpdates:o.dangerouslyProcessChildrenUpdates,replaceNodeWithMarkup:r.dangerouslyReplaceNodeWithMarkup};e.exports=i},function(e,t,n){"use strict";function r(e){}function o(e,t){}function i(e){return!(!e.prototype||!e.prototype.isReactComponent)}function a(e){return!(!e.prototype||!e.prototype.isPureReactComponent)}var s=n(3),u=n(4),l=n(20),c=n(43),p=n(12),f=n(44),d=n(26),h=(n(9),n(74)),m=n(19),v=n(23),g=(n(1),n(36)),y=n(51),b=(n(2),{ImpureClass:0,PureClass:1,StatelessFunctional:2});r.prototype.render=function(){var e=d.get(this)._currentElement.type,t=e(this.props,this.context,this.updater);return o(e,t),t};var C=1,_={construct:function(e){this._currentElement=e,this._rootNodeID=0,this._compositeType=null,this._instance=null,this._hostParent=null,this._hostContainerInfo=null,this._updateBatchNumber=null,this._pendingElement=null,this._pendingStateQueue=null,this._pendingReplaceState=!1,this._pendingForceUpdate=!1,this._renderedNodeType=null,this._renderedComponent=null,this._context=null,this._mountOrder=0,this._topLevelWrapper=null,this._pendingCallbacks=null,this._calledComponentWillUnmount=!1},mountComponent:function(e,t,n,u){this._context=u,this._mountOrder=C++,this._hostParent=t,this._hostContainerInfo=n;var c,p=this._currentElement.props,f=this._processContext(u),h=this._currentElement.type,m=e.getUpdateQueue(),g=i(h),y=this._constructComponent(g,p,f,m);g||null!=y&&null!=y.render?a(h)?this._compositeType=b.PureClass:this._compositeType=b.ImpureClass:(c=y,o(h,c),null===y||y===!1||l.isValidElement(y)?void 0:s("105",h.displayName||h.name||"Component"),y=new r(h),this._compositeType=b.StatelessFunctional);y.props=p,y.context=f,y.refs=v,y.updater=m,this._instance=y,d.set(y,this);var _=y.state;void 0===_&&(y.state=_=null),"object"!=typeof _||Array.isArray(_)?s("106",this.getName()||"ReactCompositeComponent"):void 0,this._pendingStateQueue=null,this._pendingReplaceState=!1,this._pendingForceUpdate=!1;var w;return w=y.unstable_handleError?this.performInitialMountWithErrorHandling(c,t,n,e,u):this.performInitialMount(c,t,n,e,u),y.componentDidMount&&e.getReactMountReady().enqueue(y.componentDidMount,y),w},_constructComponent:function(e,t,n,r){return this._constructComponentWithoutOwner(e,t,n,r)},_constructComponentWithoutOwner:function(e,t,n,r){var o=this._currentElement.type;return e?new o(t,n,r):o(t,n,r)},performInitialMountWithErrorHandling:function(e,t,n,r,o){var i,a=r.checkpoint();try{i=this.performInitialMount(e,t,n,r,o)}catch(s){r.rollback(a),this._instance.unstable_handleError(s),this._pendingStateQueue&&(this._instance.state=this._processPendingState(this._instance.props,this._instance.context)),a=r.checkpoint(),this._renderedComponent.unmountComponent(!0),r.rollback(a),i=this.performInitialMount(e,t,n,r,o)}return i},performInitialMount:function(e,t,n,r,o){var i=this._instance,a=0;i.componentWillMount&&(i.componentWillMount(),this._pendingStateQueue&&(i.state=this._processPendingState(i.props,i.context))),void 0===e&&(e=this._renderValidatedComponent());var s=h.getType(e);
+this._renderedNodeType=s;var u=this._instantiateReactComponent(e,s!==h.EMPTY);this._renderedComponent=u;var l=m.mountComponent(u,r,t,n,this._processChildContext(o),a);return l},getHostNode:function(){return m.getHostNode(this._renderedComponent)},unmountComponent:function(e){if(this._renderedComponent){var t=this._instance;if(t.componentWillUnmount&&!t._calledComponentWillUnmount)if(t._calledComponentWillUnmount=!0,e){var n=this.getName()+".componentWillUnmount()";f.invokeGuardedCallback(n,t.componentWillUnmount.bind(t))}else t.componentWillUnmount();this._renderedComponent&&(m.unmountComponent(this._renderedComponent,e),this._renderedNodeType=null,this._renderedComponent=null,this._instance=null),this._pendingStateQueue=null,this._pendingReplaceState=!1,this._pendingForceUpdate=!1,this._pendingCallbacks=null,this._pendingElement=null,this._context=null,this._rootNodeID=0,this._topLevelWrapper=null,d.remove(t)}},_maskContext:function(e){var t=this._currentElement.type,n=t.contextTypes;if(!n)return v;var r={};for(var o in n)r[o]=e[o];return r},_processContext:function(e){var t=this._maskContext(e);return t},_processChildContext:function(e){var t,n=this._currentElement.type,r=this._instance;if(r.getChildContext&&(t=r.getChildContext()),t){"object"!=typeof n.childContextTypes?s("107",this.getName()||"ReactCompositeComponent"):void 0;for(var o in t)o in n.childContextTypes?void 0:s("108",this.getName()||"ReactCompositeComponent",o);return u({},e,t)}return e},_checkContextTypes:function(e,t,n){},receiveComponent:function(e,t,n){var r=this._currentElement,o=this._context;this._pendingElement=null,this.updateComponent(t,r,e,o,n)},performUpdateIfNecessary:function(e){null!=this._pendingElement?m.receiveComponent(this,this._pendingElement,e,this._context):null!==this._pendingStateQueue||this._pendingForceUpdate?this.updateComponent(e,this._currentElement,this._currentElement,this._context,this._context):this._updateBatchNumber=null},updateComponent:function(e,t,n,r,o){var i=this._instance;null==i?s("136",this.getName()||"ReactCompositeComponent"):void 0;var a,u=!1;this._context===o?a=i.context:(a=this._processContext(o),u=!0);var l=t.props,c=n.props;t!==n&&(u=!0),u&&i.componentWillReceiveProps&&i.componentWillReceiveProps(c,a);var p=this._processPendingState(c,a),f=!0;this._pendingForceUpdate||(i.shouldComponentUpdate?f=i.shouldComponentUpdate(c,p,a):this._compositeType===b.PureClass&&(f=!g(l,c)||!g(i.state,p))),this._updateBatchNumber=null,f?(this._pendingForceUpdate=!1,this._performComponentUpdate(n,c,p,a,e,o)):(this._currentElement=n,this._context=o,i.props=c,i.state=p,i.context=a)},_processPendingState:function(e,t){var n=this._instance,r=this._pendingStateQueue,o=this._pendingReplaceState;if(this._pendingReplaceState=!1,this._pendingStateQueue=null,!r)return n.state;if(o&&1===r.length)return r[0];for(var i=u({},o?r[0]:n.state),a=o?1:0;a<r.length;a++){var s=r[a];u(i,"function"==typeof s?s.call(n,i,e,t):s)}return i},_performComponentUpdate:function(e,t,n,r,o,i){var a,s,u,l=this._instance,c=Boolean(l.componentDidUpdate);c&&(a=l.props,s=l.state,u=l.context),l.componentWillUpdate&&l.componentWillUpdate(t,n,r),this._currentElement=e,this._context=i,l.props=t,l.state=n,l.context=r,this._updateRenderedComponent(o,i),c&&o.getReactMountReady().enqueue(l.componentDidUpdate.bind(l,a,s,u),l)},_updateRenderedComponent:function(e,t){var n=this._renderedComponent,r=n._currentElement,o=this._renderValidatedComponent(),i=0;if(y(r,o))m.receiveComponent(n,o,e,this._processChildContext(t));else{var a=m.getHostNode(n);m.unmountComponent(n,!1);var s=h.getType(o);this._renderedNodeType=s;var u=this._instantiateReactComponent(o,s!==h.EMPTY);this._renderedComponent=u;var l=m.mountComponent(u,e,this._hostParent,this._hostContainerInfo,this._processChildContext(t),i);this._replaceNodeWithMarkup(a,l,n)}},_replaceNodeWithMarkup:function(e,t,n){c.replaceNodeWithMarkup(e,t,n)},_renderValidatedComponentWithoutOwnerOrContext:function(){var e,t=this._instance;return e=t.render()},_renderValidatedComponent:function(){var e;if(this._compositeType!==b.StatelessFunctional){p.current=this;try{e=this._renderValidatedComponentWithoutOwnerOrContext()}finally{p.current=null}}else e=this._renderValidatedComponentWithoutOwnerOrContext();return null===e||e===!1||l.isValidElement(e)?void 0:s("109",this.getName()||"ReactCompositeComponent"),e},attachRef:function(e,t){var n=this.getPublicInstance();null==n?s("110"):void 0;var r=t.getPublicInstance(),o=n.refs===v?n.refs={}:n.refs;o[e]=r},detachRef:function(e){var t=this.getPublicInstance().refs;delete t[e]},getName:function(){var e=this._currentElement.type,t=this._instance&&this._instance.constructor;return e.displayName||t&&t.displayName||e.name||t&&t.name||null},getPublicInstance:function(){var e=this._instance;return this._compositeType===b.StatelessFunctional?null:e},_instantiateReactComponent:null};e.exports=_},function(e,t,n){"use strict";var r=n(6),o=n(151),i=n(73),a=n(19),s=n(10),u=n(164),l=n(180),c=n(78),p=n(187);n(2);o.inject();var f={findDOMNode:l,render:i.render,unmountComponentAtNode:i.unmountComponentAtNode,version:u,unstable_batchedUpdates:s.batchedUpdates,unstable_renderSubtreeIntoContainer:p};"undefined"!=typeof __REACT_DEVTOOLS_GLOBAL_HOOK__&&"function"==typeof __REACT_DEVTOOLS_GLOBAL_HOOK__.inject&&__REACT_DEVTOOLS_GLOBAL_HOOK__.inject({ComponentTree:{getClosestInstanceFromNode:r.getClosestInstanceFromNode,getNodeFromInstance:function(e){return e._renderedComponent&&(e=c(e)),e?r.getNodeFromInstance(e):null}},Mount:i,Reconciler:a});e.exports=f},function(e,t,n){"use strict";function r(e){if(e){var t=e._currentElement._owner||null;if(t){var n=t.getName();if(n)return" This DOM node was rendered by `"+n+"`."}}return""}function o(e,t){t&&(X[e._tag]&&(null!=t.children||null!=t.dangerouslySetInnerHTML?m("137",e._tag,e._currentElement._owner?" Check the render method of "+e._currentElement._owner.getName()+".":""):void 0),null!=t.dangerouslySetInnerHTML&&(null!=t.children?m("60"):void 0,"object"==typeof t.dangerouslySetInnerHTML&&W in t.dangerouslySetInnerHTML?void 0:m("61")),null!=t.style&&"object"!=typeof t.style?m("62",r(e)):void 0)}function i(e,t,n,r){if(!(r instanceof I)){var o=e._hostContainerInfo,i=o._node&&o._node.nodeType===q,s=i?o._node:o._ownerDocument;F(t,s),r.getReactMountReady().enqueue(a,{inst:e,registrationName:t,listener:n})}}function a(){var e=this;E.putListener(e.inst,e.registrationName,e.listener)}function s(){var e=this;k.postMountWrapper(e)}function u(){var e=this;M.postMountWrapper(e)}function l(){var e=this;S.postMountWrapper(e)}function c(){var e=this;e._rootNodeID?void 0:m("63");var t=U(e);switch(t?void 0:m("64"),e._tag){case"iframe":case"object":e._wrapperState.listeners=[x.trapBubbledEvent("topLoad","load",t)];break;case"video":case"audio":e._wrapperState.listeners=[];for(var n in z)z.hasOwnProperty(n)&&e._wrapperState.listeners.push(x.trapBubbledEvent(n,z[n],t));break;case"source":e._wrapperState.listeners=[x.trapBubbledEvent("topError","error",t)];break;case"img":e._wrapperState.listeners=[x.trapBubbledEvent("topError","error",t),x.trapBubbledEvent("topLoad","load",t)];break;case"form":e._wrapperState.listeners=[x.trapBubbledEvent("topReset","reset",t),x.trapBubbledEvent("topSubmit","submit",t)];break;case"input":case"select":case"textarea":e._wrapperState.listeners=[x.trapBubbledEvent("topInvalid","invalid",t)]}}function p(){N.postUpdateWrapper(this)}function f(e){$.call(Q,e)||(G.test(e)?void 0:m("65",e),Q[e]=!0)}function d(e,t){return e.indexOf("-")>=0||null!=t.is}function h(e){var t=e.type;f(t),this._currentElement=e,this._tag=t.toLowerCase(),this._namespaceURI=null,this._renderedChildren=null,this._previousStyle=null,this._previousStyleCopy=null,this._hostNode=null,this._hostParent=null,this._rootNodeID=0,this._domID=0,this._hostContainerInfo=null,this._wrapperState=null,this._topLevelWrapper=null,this._flags=0}var m=n(3),v=n(4),g=n(126),y=n(128),b=n(17),C=n(38),_=n(18),w=n(66),E=n(24),T=n(39),x=n(29),O=n(67),P=n(6),k=n(144),S=n(145),N=n(68),M=n(148),A=(n(9),n(157)),I=n(162),D=(n(8),n(32)),R=(n(1),n(50),n(36),n(52),n(2),O),L=E.deleteListener,U=P.getNodeFromInstance,F=x.listenTo,j=T.registrationNameModules,B={string:!0,number:!0},V="style",W="__html",H={children:null,dangerouslySetInnerHTML:null,suppressContentEditableWarning:null},q=11,z={topAbort:"abort",topCanPlay:"canplay",topCanPlayThrough:"canplaythrough",topDurationChange:"durationchange",topEmptied:"emptied",topEncrypted:"encrypted",topEnded:"ended",topError:"error",topLoadedData:"loadeddata",topLoadedMetadata:"loadedmetadata",topLoadStart:"loadstart",topPause:"pause",topPlay:"play",topPlaying:"playing",topProgress:"progress",topRateChange:"ratechange",topSeeked:"seeked",topSeeking:"seeking",topStalled:"stalled",topSuspend:"suspend",topTimeUpdate:"timeupdate",topVolumeChange:"volumechange",topWaiting:"waiting"},K={area:!0,base:!0,br:!0,col:!0,embed:!0,hr:!0,img:!0,input:!0,keygen:!0,link:!0,meta:!0,param:!0,source:!0,track:!0,wbr:!0},Y={listing:!0,pre:!0,textarea:!0},X=v({menuitem:!0},K),G=/^[a-zA-Z][a-zA-Z:_\.\-\d]*$/,Q={},$={}.hasOwnProperty,Z=1;h.displayName="ReactDOMComponent",h.Mixin={mountComponent:function(e,t,n,r){this._rootNodeID=Z++,this._domID=n._idCounter++,this._hostParent=t,this._hostContainerInfo=n;var i=this._currentElement.props;switch(this._tag){case"audio":case"form":case"iframe":case"img":case"link":case"object":case"source":case"video":this._wrapperState={listeners:null},e.getReactMountReady().enqueue(c,this);break;case"input":k.mountWrapper(this,i,t),i=k.getHostProps(this,i),e.getReactMountReady().enqueue(c,this);break;case"option":S.mountWrapper(this,i,t),i=S.getHostProps(this,i);break;case"select":N.mountWrapper(this,i,t),i=N.getHostProps(this,i),e.getReactMountReady().enqueue(c,this);break;case"textarea":M.mountWrapper(this,i,t),i=M.getHostProps(this,i),e.getReactMountReady().enqueue(c,this)}o(this,i);var a,p;null!=t?(a=t._namespaceURI,p=t._tag):n._tag&&(a=n._namespaceURI,p=n._tag),(null==a||a===C.svg&&"foreignobject"===p)&&(a=C.html),a===C.html&&("svg"===this._tag?a=C.svg:"math"===this._tag&&(a=C.mathml)),this._namespaceURI=a;var f;if(e.useCreateElement){var d,h=n._ownerDocument;if(a===C.html)if("script"===this._tag){var m=h.createElement("div"),v=this._currentElement.type;m.innerHTML="<"+v+"></"+v+">",d=m.removeChild(m.firstChild)}else d=i.is?h.createElement(this._currentElement.type,i.is):h.createElement(this._currentElement.type);else d=h.createElementNS(a,this._currentElement.type);P.precacheNode(this,d),this._flags|=R.hasCachedChildNodes,this._hostParent||w.setAttributeForRoot(d),this._updateDOMProperties(null,i,e);var y=b(d);this._createInitialChildren(e,i,r,y),f=y}else{var _=this._createOpenTagMarkupAndPutListeners(e,i),E=this._createContentMarkup(e,i,r);f=!E&&K[this._tag]?_+"/>":_+">"+E+"</"+this._currentElement.type+">"}switch(this._tag){case"input":e.getReactMountReady().enqueue(s,this),i.autoFocus&&e.getReactMountReady().enqueue(g.focusDOMComponent,this);break;case"textarea":e.getReactMountReady().enqueue(u,this),i.autoFocus&&e.getReactMountReady().enqueue(g.focusDOMComponent,this);break;case"select":i.autoFocus&&e.getReactMountReady().enqueue(g.focusDOMComponent,this);break;case"button":i.autoFocus&&e.getReactMountReady().enqueue(g.focusDOMComponent,this);break;case"option":e.getReactMountReady().enqueue(l,this)}return f},_createOpenTagMarkupAndPutListeners:function(e,t){var n="<"+this._currentElement.type;for(var r in t)if(t.hasOwnProperty(r)){var o=t[r];if(null!=o)if(j.hasOwnProperty(r))o&&i(this,r,o,e);else{r===V&&(o&&(o=this._previousStyleCopy=v({},t.style)),o=y.createMarkupForStyles(o,this));var a=null;null!=this._tag&&d(this._tag,t)?H.hasOwnProperty(r)||(a=w.createMarkupForCustomAttribute(r,o)):a=w.createMarkupForProperty(r,o),a&&(n+=" "+a)}}return e.renderToStaticMarkup?n:(this._hostParent||(n+=" "+w.createMarkupForRoot()),n+=" "+w.createMarkupForID(this._domID))},_createContentMarkup:function(e,t,n){var r="",o=t.dangerouslySetInnerHTML;if(null!=o)null!=o.__html&&(r=o.__html);else{var i=B[typeof t.children]?t.children:null,a=null!=i?null:t.children;if(null!=i)r=D(i);else if(null!=a){var s=this.mountChildren(a,e,n);r=s.join("")}}return Y[this._tag]&&"\n"===r.charAt(0)?"\n"+r:r},_createInitialChildren:function(e,t,n,r){var o=t.dangerouslySetInnerHTML;if(null!=o)null!=o.__html&&b.queueHTML(r,o.__html);else{var i=B[typeof t.children]?t.children:null,a=null!=i?null:t.children;if(null!=i)""!==i&&b.queueText(r,i);else if(null!=a)for(var s=this.mountChildren(a,e,n),u=0;u<s.length;u++)b.queueChild(r,s[u])}},receiveComponent:function(e,t,n){var r=this._currentElement;this._currentElement=e,this.updateComponent(t,r,e,n)},updateComponent:function(e,t,n,r){var i=t.props,a=this._currentElement.props;switch(this._tag){case"input":i=k.getHostProps(this,i),a=k.getHostProps(this,a);break;case"option":i=S.getHostProps(this,i),a=S.getHostProps(this,a);break;case"select":i=N.getHostProps(this,i),a=N.getHostProps(this,a);break;case"textarea":i=M.getHostProps(this,i),a=M.getHostProps(this,a)}switch(o(this,a),this._updateDOMProperties(i,a,e),this._updateDOMChildren(i,a,e,r),this._tag){case"input":k.updateWrapper(this);break;case"textarea":M.updateWrapper(this);break;case"select":e.getReactMountReady().enqueue(p,this)}},_updateDOMProperties:function(e,t,n){var r,o,a;for(r in e)if(!t.hasOwnProperty(r)&&e.hasOwnProperty(r)&&null!=e[r])if(r===V){var s=this._previousStyleCopy;for(o in s)s.hasOwnProperty(o)&&(a=a||{},a[o]="");this._previousStyleCopy=null}else j.hasOwnProperty(r)?e[r]&&L(this,r):d(this._tag,e)?H.hasOwnProperty(r)||w.deleteValueForAttribute(U(this),r):(_.properties[r]||_.isCustomAttribute(r))&&w.deleteValueForProperty(U(this),r);for(r in t){var u=t[r],l=r===V?this._previousStyleCopy:null!=e?e[r]:void 0;if(t.hasOwnProperty(r)&&u!==l&&(null!=u||null!=l))if(r===V)if(u?u=this._previousStyleCopy=v({},u):this._previousStyleCopy=null,l){for(o in l)!l.hasOwnProperty(o)||u&&u.hasOwnProperty(o)||(a=a||{},a[o]="");for(o in u)u.hasOwnProperty(o)&&l[o]!==u[o]&&(a=a||{},a[o]=u[o])}else a=u;else if(j.hasOwnProperty(r))u?i(this,r,u,n):l&&L(this,r);else if(d(this._tag,t))H.hasOwnProperty(r)||w.setValueForAttribute(U(this),r,u);else if(_.properties[r]||_.isCustomAttribute(r)){var c=U(this);null!=u?w.setValueForProperty(c,r,u):w.deleteValueForProperty(c,r)}}a&&y.setValueForStyles(U(this),a,this)},_updateDOMChildren:function(e,t,n,r){var o=B[typeof e.children]?e.children:null,i=B[typeof t.children]?t.children:null,a=e.dangerouslySetInnerHTML&&e.dangerouslySetInnerHTML.__html,s=t.dangerouslySetInnerHTML&&t.dangerouslySetInnerHTML.__html,u=null!=o?null:e.children,l=null!=i?null:t.children,c=null!=o||null!=a,p=null!=i||null!=s;null!=u&&null==l?this.updateChildren(null,n,r):c&&!p&&this.updateTextContent(""),null!=i?o!==i&&this.updateTextContent(""+i):null!=s?a!==s&&this.updateMarkup(""+s):null!=l&&this.updateChildren(l,n,r)},getHostNode:function(){return U(this)},unmountComponent:function(e){switch(this._tag){case"audio":case"form":case"iframe":case"img":case"link":case"object":case"source":case"video":var t=this._wrapperState.listeners;if(t)for(var n=0;n<t.length;n++)t[n].remove();break;case"html":case"head":case"body":m("66",this._tag)}this.unmountChildren(e),P.uncacheNode(this),E.deleteAllListeners(this),this._rootNodeID=0,this._domID=0,this._wrapperState=null},getPublicInstance:function(){return U(this)}},v(h.prototype,h.Mixin,A.Mixin),e.exports=h},function(e,t,n){"use strict";function r(e,t){var n={_topLevelWrapper:e,_idCounter:1,_ownerDocument:t?t.nodeType===o?t:t.ownerDocument:null,_node:t,_tag:t?t.nodeName.toLowerCase():null,_namespaceURI:t?t.namespaceURI:null};return n}var o=(n(52),9);e.exports=r},function(e,t,n){"use strict";var r=n(4),o=n(17),i=n(6),a=function(e){this._currentElement=null,this._hostNode=null,this._hostParent=null,this._hostContainerInfo=null,this._domID=0};r(a.prototype,{mountComponent:function(e,t,n,r){var a=n._idCounter++;this._domID=a,this._hostParent=t,this._hostContainerInfo=n;var s=" react-empty: "+this._domID+" ";if(e.useCreateElement){var u=n._ownerDocument,l=u.createComment(s);return i.precacheNode(this,l),o(l)}return e.renderToStaticMarkup?"":"<!--"+s+"-->"},receiveComponent:function(){},getHostNode:function(){return i.getNodeFromInstance(this)},unmountComponent:function(){i.uncacheNode(this)}}),e.exports=a},function(e,t){"use strict";var n={useCreateElement:!0,useFiber:!1};e.exports=n},function(e,t,n){"use strict";var r=n(37),o=n(6),i={dangerouslyProcessChildrenUpdates:function(e,t){var n=o.getNodeFromInstance(e);r.processUpdates(n,t)}};e.exports=i},function(e,t,n){"use strict";function r(){this._rootNodeID&&f.updateWrapper(this)}function o(e){var t="checkbox"===e.type||"radio"===e.type;return t?null!=e.checked:null!=e.value}function i(e){var t=this._currentElement.props,n=l.executeOnChange(t,e);p.asap(r,this);var o=t.name;if("radio"===t.type&&null!=o){for(var i=c.getNodeFromInstance(this),s=i;s.parentNode;)s=s.parentNode;for(var u=s.querySelectorAll("input[name="+JSON.stringify(""+o)+'][type="radio"]'),f=0;f<u.length;f++){var d=u[f];if(d!==i&&d.form===i.form){var h=c.getInstanceFromNode(d);h?void 0:a("90"),p.asap(r,h)}}}return n}var a=n(3),s=n(4),u=n(66),l=n(42),c=n(6),p=n(10),f=(n(1),n(2),{getHostProps:function(e,t){var n=l.getValue(t),r=l.getChecked(t),o=s({type:void 0,step:void 0,min:void 0,max:void 0},t,{defaultChecked:void 0,defaultValue:void 0,value:null!=n?n:e._wrapperState.initialValue,checked:null!=r?r:e._wrapperState.initialChecked,onChange:e._wrapperState.onChange});return o},mountWrapper:function(e,t){var n=t.defaultValue;e._wrapperState={initialChecked:null!=t.checked?t.checked:t.defaultChecked,initialValue:null!=t.value?t.value:n,listeners:null,onChange:i.bind(e),controlled:o(t)}},updateWrapper:function(e){var t=e._currentElement.props,n=t.checked;null!=n&&u.setValueForProperty(c.getNodeFromInstance(e),"checked",n||!1);var r=c.getNodeFromInstance(e),o=l.getValue(t);if(null!=o)if(0===o&&""===r.value)r.value="0";else if("number"===t.type){var i=parseFloat(r.value,10)||0;o!=i&&(r.value=""+o)}else o!=r.value&&(r.value=""+o);else null==t.value&&null!=t.defaultValue&&r.defaultValue!==""+t.defaultValue&&(r.defaultValue=""+t.defaultValue),null==t.checked&&null!=t.defaultChecked&&(r.defaultChecked=!!t.defaultChecked)},postMountWrapper:function(e){var t=e._currentElement.props,n=c.getNodeFromInstance(e);switch(t.type){case"submit":case"reset":break;case"color":case"date":case"datetime":case"datetime-local":case"month":case"time":case"week":n.value="",n.value=n.defaultValue;break;default:n.value=n.value}var r=n.name;""!==r&&(n.name=""),n.defaultChecked=!n.defaultChecked,n.defaultChecked=!n.defaultChecked,""!==r&&(n.name=r)}});e.exports=f},function(e,t,n){"use strict";function r(e){var t="";return i.Children.forEach(e,function(e){null!=e&&("string"==typeof e||"number"==typeof e?t+=e:u||(u=!0))}),t}var o=n(4),i=n(20),a=n(6),s=n(68),u=(n(2),!1),l={mountWrapper:function(e,t,n){var o=null;if(null!=n){var i=n;"optgroup"===i._tag&&(i=i._hostParent),null!=i&&"select"===i._tag&&(o=s.getSelectValueContext(i))}var a=null;if(null!=o){var u;if(u=null!=t.value?t.value+"":r(t.children),a=!1,Array.isArray(o)){for(var l=0;l<o.length;l++)if(""+o[l]===u){a=!0;break}}else a=""+o===u}e._wrapperState={selected:a}},postMountWrapper:function(e){var t=e._currentElement.props;if(null!=t.value){var n=a.getNodeFromInstance(e);n.setAttribute("value",t.value)}},getHostProps:function(e,t){var n=o({selected:void 0,children:void 0},t);null!=e._wrapperState.selected&&(n.selected=e._wrapperState.selected);var i=r(t.children);return i&&(n.children=i),n}};e.exports=l},function(e,t,n){"use strict";function r(e,t,n,r){return e===n&&t===r}function o(e){var t=document.selection,n=t.createRange(),r=n.text.length,o=n.duplicate();o.moveToElementText(e),o.setEndPoint("EndToStart",n);var i=o.text.length,a=i+r;return{start:i,end:a}}function i(e){var t=window.getSelection&&window.getSelection();if(!t||0===t.rangeCount)return null;var n=t.anchorNode,o=t.anchorOffset,i=t.focusNode,a=t.focusOffset,s=t.getRangeAt(0);try{s.startContainer.nodeType,s.endContainer.nodeType}catch(e){return null}var u=r(t.anchorNode,t.anchorOffset,t.focusNode,t.focusOffset),l=u?0:s.toString().length,c=s.cloneRange();c.selectNodeContents(e),c.setEnd(s.startContainer,s.startOffset);var p=r(c.startContainer,c.startOffset,c.endContainer,c.endOffset),f=p?0:c.toString().length,d=f+l,h=document.createRange();h.setStart(n,o),h.setEnd(i,a);var m=h.collapsed;return{start:m?d:f,end:m?f:d}}function a(e,t){var n,r,o=document.selection.createRange().duplicate();void 0===t.end?(n=t.start,r=n):t.start>t.end?(n=t.end,r=t.start):(n=t.start,r=t.end),o.moveToElementText(e),o.moveStart("character",n),o.setEndPoint("EndToStart",o),o.moveEnd("character",r-n),o.select()}function s(e,t){if(window.getSelection){var n=window.getSelection(),r=e[c()].length,o=Math.min(t.start,r),i=void 0===t.end?o:Math.min(t.end,r);if(!n.extend&&o>i){var a=i;i=o,o=a}var s=l(e,o),u=l(e,i);if(s&&u){var p=document.createRange();p.setStart(s.node,s.offset),n.removeAllRanges(),o>i?(n.addRange(p),n.extend(u.node,u.offset)):(p.setEnd(u.node,u.offset),n.addRange(p))}}}var u=n(7),l=n(184),c=n(79),p=u.canUseDOM&&"selection"in document&&!("getSelection"in window),f={getOffsets:p?o:i,setOffsets:p?a:s};e.exports=f},function(e,t,n){"use strict";var r=n(3),o=n(4),i=n(37),a=n(17),s=n(6),u=n(32),l=(n(1),n(52),function(e){this._currentElement=e,this._stringText=""+e,this._hostNode=null,this._hostParent=null,this._domID=0,this._mountIndex=0,this._closingComment=null,this._commentNodes=null});o(l.prototype,{mountComponent:function(e,t,n,r){var o=n._idCounter++,i=" react-text: "+o+" ",l=" /react-text ";if(this._domID=o,this._hostParent=t,e.useCreateElement){var c=n._ownerDocument,p=c.createComment(i),f=c.createComment(l),d=a(c.createDocumentFragment());return a.queueChild(d,a(p)),this._stringText&&a.queueChild(d,a(c.createTextNode(this._stringText))),a.queueChild(d,a(f)),s.precacheNode(this,p),this._closingComment=f,d}var h=u(this._stringText);return e.renderToStaticMarkup?h:"<!--"+i+"-->"+h+"<!--"+l+"-->"},receiveComponent:function(e,t){if(e!==this._currentElement){this._currentElement=e;var n=""+e;if(n!==this._stringText){this._stringText=n;var r=this.getHostNode();i.replaceDelimitedText(r[0],r[1],n)}}},getHostNode:function(){var e=this._commentNodes;if(e)return e;if(!this._closingComment)for(var t=s.getNodeFromInstance(this),n=t.nextSibling;;){if(null==n?r("67",this._domID):void 0,8===n.nodeType&&" /react-text "===n.nodeValue){this._closingComment=n;break}n=n.nextSibling}return e=[this._hostNode,this._closingComment],this._commentNodes=e,e},unmountComponent:function(){this._closingComment=null,this._commentNodes=null,s.uncacheNode(this)}}),e.exports=l},function(e,t,n){"use strict";function r(){this._rootNodeID&&c.updateWrapper(this)}function o(e){var t=this._currentElement.props,n=s.executeOnChange(t,e);return l.asap(r,this),n}var i=n(3),a=n(4),s=n(42),u=n(6),l=n(10),c=(n(1),n(2),{getHostProps:function(e,t){null!=t.dangerouslySetInnerHTML?i("91"):void 0;var n=a({},t,{value:void 0,defaultValue:void 0,children:""+e._wrapperState.initialValue,onChange:e._wrapperState.onChange});return n},mountWrapper:function(e,t){var n=s.getValue(t),r=n;if(null==n){var a=t.defaultValue,u=t.children;null!=u&&(null!=a?i("92"):void 0,Array.isArray(u)&&(u.length<=1?void 0:i("93"),u=u[0]),a=""+u),null==a&&(a=""),r=a}e._wrapperState={initialValue:""+r,listeners:null,onChange:o.bind(e)}},updateWrapper:function(e){var t=e._currentElement.props,n=u.getNodeFromInstance(e),r=s.getValue(t);if(null!=r){var o=""+r;o!==n.value&&(n.value=o),null==t.defaultValue&&(n.defaultValue=o)}null!=t.defaultValue&&(n.defaultValue=t.defaultValue)},postMountWrapper:function(e){var t=u.getNodeFromInstance(e),n=t.textContent;n===e._wrapperState.initialValue&&(t.value=n)}});e.exports=c},function(e,t,n){"use strict";function r(e,t){"_hostNode"in e?void 0:u("33"),"_hostNode"in t?void 0:u("33");for(var n=0,r=e;r;r=r._hostParent)n++;for(var o=0,i=t;i;i=i._hostParent)o++;for(;n-o>0;)e=e._hostParent,n--;for(;o-n>0;)t=t._hostParent,o--;for(var a=n;a--;){if(e===t)return e;e=e._hostParent,t=t._hostParent}return null}function o(e,t){"_hostNode"in e?void 0:u("35"),"_hostNode"in t?void 0:u("35");for(;t;){if(t===e)return!0;t=t._hostParent}return!1}function i(e){return"_hostNode"in e?void 0:u("36"),e._hostParent}function a(e,t,n){for(var r=[];e;)r.push(e),e=e._hostParent;var o;for(o=r.length;o-- >0;)t(r[o],"captured",n);for(o=0;o<r.length;o++)t(r[o],"bubbled",n)}function s(e,t,n,o,i){for(var a=e&&t?r(e,t):null,s=[];e&&e!==a;)s.push(e),e=e._hostParent;for(var u=[];t&&t!==a;)u.push(t),t=t._hostParent;var l;for(l=0;l<s.length;l++)n(s[l],"bubbled",o);for(l=u.length;l-- >0;)n(u[l],"captured",i)}var u=n(3);n(1);e.exports={isAncestor:o,getLowestCommonAncestor:r,getParentInstance:i,traverseTwoPhase:a,traverseEnterLeave:s}},function(e,t,n){"use strict";function r(){this.reinitializeTransaction()}var o=n(4),i=n(10),a=n(31),s=n(8),u={initialize:s,close:function(){f.isBatchingUpdates=!1}},l={initialize:s,close:i.flushBatchedUpdates.bind(i)},c=[l,u];o(r.prototype,a,{getTransactionWrappers:function(){return c}});var p=new r,f={isBatchingUpdates:!1,batchedUpdates:function(e,t,n,r,o,i){var a=f.isBatchingUpdates;return f.isBatchingUpdates=!0,a?e(t,n,r,o,i):p.perform(e,null,t,n,r,o,i)}};e.exports=f},function(e,t,n){"use strict";function r(){E||(E=!0,y.EventEmitter.injectReactEventListener(g),y.EventPluginHub.injectEventPluginOrder(s),y.EventPluginUtils.injectComponentTree(f),y.EventPluginUtils.injectTreeTraversal(h),y.EventPluginHub.injectEventPluginsByName({SimpleEventPlugin:w,EnterLeaveEventPlugin:u,ChangeEventPlugin:a,SelectEventPlugin:_,BeforeInputEventPlugin:i}),y.HostComponent.injectGenericComponentClass(p),y.HostComponent.injectTextComponentClass(m),y.DOMProperty.injectDOMPropertyConfig(o),y.DOMProperty.injectDOMPropertyConfig(l),y.DOMProperty.injectDOMPropertyConfig(C),y.EmptyComponent.injectEmptyComponentFactory(function(e){return new d(e)}),y.Updates.injectReconcileTransaction(b),y.Updates.injectBatchingStrategy(v),y.Component.injectEnvironment(c))}var o=n(125),i=n(127),a=n(129),s=n(131),u=n(132),l=n(134),c=n(136),p=n(139),f=n(6),d=n(141),h=n(149),m=n(147),v=n(150),g=n(154),y=n(155),b=n(160),C=n(165),_=n(166),w=n(167),E=!1;e.exports={inject:r}},88,function(e,t,n){"use strict";function r(e){o.enqueueEvents(e),o.processEventQueue(!1)}var o=n(24),i={handleTopLevel:function(e,t,n,i){var a=o.extractEvents(e,t,n,i);r(a)}};e.exports=i},function(e,t,n){"use strict";function r(e){for(;e._hostParent;)e=e._hostParent;var t=p.getNodeFromInstance(e),n=t.parentNode;return p.getClosestInstanceFromNode(n)}function o(e,t){this.topLevelType=e,this.nativeEvent=t,this.ancestors=[]}function i(e){var t=d(e.nativeEvent),n=p.getClosestInstanceFromNode(t),o=n;do e.ancestors.push(o),o=o&&r(o);while(o);for(var i=0;i<e.ancestors.length;i++)n=e.ancestors[i],m._handleTopLevel(e.topLevelType,n,e.nativeEvent,d(e.nativeEvent))}function a(e){var t=h(window);e(t)}var s=n(4),u=n(57),l=n(7),c=n(14),p=n(6),f=n(10),d=n(49),h=n(107);s(o.prototype,{destructor:function(){this.topLevelType=null,this.nativeEvent=null,this.ancestors.length=0}}),c.addPoolingTo(o,c.twoArgumentPooler);var m={_enabled:!0,_handleTopLevel:null,WINDOW_HANDLE:l.canUseDOM?window:null,setHandleTopLevel:function(e){m._handleTopLevel=e},setEnabled:function(e){m._enabled=!!e},isEnabled:function(){return m._enabled},trapBubbledEvent:function(e,t,n){return n?u.listen(n,t,m.dispatchEvent.bind(null,e)):null},trapCapturedEvent:function(e,t,n){return n?u.capture(n,t,m.dispatchEvent.bind(null,e)):null},monitorScrollValue:function(e){var t=a.bind(null,e);u.listen(window,"scroll",t)},dispatchEvent:function(e,t){if(m._enabled){var n=o.getPooled(e,t);try{f.batchedUpdates(i,n)}finally{o.release(n)}}}};e.exports=m},function(e,t,n){"use strict";var r=n(18),o=n(24),i=n(40),a=n(43),s=n(69),u=n(29),l=n(71),c=n(10),p={Component:a.injection,DOMProperty:r.injection,EmptyComponent:s.injection,EventPluginHub:o.injection,EventPluginUtils:i.injection,EventEmitter:u.injection,HostComponent:l.injection,Updates:c.injection};e.exports=p},function(e,t,n){"use strict";var r=n(178),o=/\/?>/,i=/^<\!\-\-/,a={CHECKSUM_ATTR_NAME:"data-react-checksum",addChecksumToMarkup:function(e){var t=r(e);return i.test(e)?e:e.replace(o," "+a.CHECKSUM_ATTR_NAME+'="'+t+'"$&')},canReuseMarkup:function(e,t){var n=t.getAttribute(a.CHECKSUM_ATTR_NAME);n=n&&parseInt(n,10);var o=r(e);return o===n}};e.exports=a},function(e,t,n){"use strict";function r(e,t,n){return{type:"INSERT_MARKUP",content:e,fromIndex:null,fromNode:null,toIndex:n,afterNode:t}}function o(e,t,n){return{type:"MOVE_EXISTING",content:null,fromIndex:e._mountIndex,fromNode:f.getHostNode(e),toIndex:n,afterNode:t}}function i(e,t){return{type:"REMOVE_NODE",content:null,fromIndex:e._mountIndex,fromNode:t,toIndex:null,afterNode:null}}function a(e){return{type:"SET_MARKUP",content:e,fromIndex:null,fromNode:null,toIndex:null,afterNode:null}}function s(e){return{type:"TEXT_CONTENT",content:e,fromIndex:null,fromNode:null,toIndex:null,afterNode:null}}function u(e,t){return t&&(e=e||[],e.push(t)),e}function l(e,t){p.processChildrenUpdates(e,t)}var c=n(3),p=n(43),f=(n(26),n(9),n(12),n(19)),d=n(135),h=(n(8),n(181)),m=(n(1),{Mixin:{_reconcilerInstantiateChildren:function(e,t,n){return d.instantiateChildren(e,t,n)},_reconcilerUpdateChildren:function(e,t,n,r,o,i){var a,s=0;return a=h(t,s),d.updateChildren(e,a,n,r,o,this,this._hostContainerInfo,i,s),a},mountChildren:function(e,t,n){var r=this._reconcilerInstantiateChildren(e,t,n);this._renderedChildren=r;var o=[],i=0;for(var a in r)if(r.hasOwnProperty(a)){var s=r[a],u=0,l=f.mountComponent(s,t,this,this._hostContainerInfo,n,u);s._mountIndex=i++,o.push(l)}return o},updateTextContent:function(e){var t=this._renderedChildren;d.unmountChildren(t,!1);for(var n in t)t.hasOwnProperty(n)&&c("118");var r=[s(e)];l(this,r)},updateMarkup:function(e){var t=this._renderedChildren;d.unmountChildren(t,!1);for(var n in t)t.hasOwnProperty(n)&&c("118");var r=[a(e)];l(this,r)},updateChildren:function(e,t,n){this._updateChildren(e,t,n)},_updateChildren:function(e,t,n){var r=this._renderedChildren,o={},i=[],a=this._reconcilerUpdateChildren(r,e,i,o,t,n);if(a||r){var s,c=null,p=0,d=0,h=0,m=null;for(s in a)if(a.hasOwnProperty(s)){var v=r&&r[s],g=a[s];v===g?(c=u(c,this.moveChild(v,m,p,d)),d=Math.max(v._mountIndex,d),v._mountIndex=p):(v&&(d=Math.max(v._mountIndex,d)),c=u(c,this._mountChildAtIndex(g,i[h],m,p,t,n)),h++),p++,m=f.getHostNode(g)}for(s in o)o.hasOwnProperty(s)&&(c=u(c,this._unmountChild(r[s],o[s])));c&&l(this,c),this._renderedChildren=a}},unmountChildren:function(e){var t=this._renderedChildren;d.unmountChildren(t,e),this._renderedChildren=null},moveChild:function(e,t,n,r){if(e._mountIndex<r)return o(e,t,n)},createChild:function(e,t,n){return r(n,t,e._mountIndex)},removeChild:function(e,t){return i(e,t)},_mountChildAtIndex:function(e,t,n,r,o,i){return e._mountIndex=r,this.createChild(e,n,t)},_unmountChild:function(e,t){var n=this.removeChild(e,t);return e._mountIndex=null,n}}});e.exports=m},function(e,t,n){"use strict";function r(e){return!(!e||"function"!=typeof e.attachRef||"function"!=typeof e.detachRef)}var o=n(3),i=(n(1),{addComponentAsRefTo:function(e,t,n){r(n)?void 0:o("119"),n.attachRef(t,e)},removeComponentAsRefFrom:function(e,t,n){r(n)?void 0:o("120");var i=n.getPublicInstance();i&&i.refs[t]===e.getPublicInstance()&&n.detachRef(t)}});e.exports=i},function(e,t){"use strict";var n="SECRET_DO_NOT_PASS_THIS_OR_YOU_WILL_BE_FIRED";e.exports=n},function(e,t,n){"use strict";function r(e){this.reinitializeTransaction(),this.renderToStaticMarkup=!1,this.reactMountReady=i.getPooled(null),this.useCreateElement=e}var o=n(4),i=n(65),a=n(14),s=n(29),u=n(72),l=(n(9),n(31)),c=n(45),p={initialize:u.getSelectionInformation,close:u.restoreSelection},f={initialize:function(){var e=s.isEnabled();return s.setEnabled(!1),
+e},close:function(e){s.setEnabled(e)}},d={initialize:function(){this.reactMountReady.reset()},close:function(){this.reactMountReady.notifyAll()}},h=[p,f,d],m={getTransactionWrappers:function(){return h},getReactMountReady:function(){return this.reactMountReady},getUpdateQueue:function(){return c},checkpoint:function(){return this.reactMountReady.checkpoint()},rollback:function(e){this.reactMountReady.rollback(e)},destructor:function(){i.release(this.reactMountReady),this.reactMountReady=null}};o(r.prototype,l,m),a.addPoolingTo(r),e.exports=r},function(e,t,n){"use strict";function r(e,t,n){"function"==typeof e?e(t.getPublicInstance()):i.addComponentAsRefTo(t,e,n)}function o(e,t,n){"function"==typeof e?e(null):i.removeComponentAsRefFrom(t,e,n)}var i=n(158),a={};a.attachRefs=function(e,t){if(null!==t&&"object"==typeof t){var n=t.ref;null!=n&&r(n,e,t._owner)}},a.shouldUpdateRefs=function(e,t){var n=null,r=null;null!==e&&"object"==typeof e&&(n=e.ref,r=e._owner);var o=null,i=null;return null!==t&&"object"==typeof t&&(o=t.ref,i=t._owner),n!==o||"string"==typeof o&&i!==r},a.detachRefs=function(e,t){if(null!==t&&"object"==typeof t){var n=t.ref;null!=n&&o(n,e,t._owner)}},e.exports=a},function(e,t,n){"use strict";function r(e){this.reinitializeTransaction(),this.renderToStaticMarkup=e,this.useCreateElement=!1,this.updateQueue=new s(this)}var o=n(4),i=n(14),a=n(31),s=(n(9),n(163)),u=[],l={enqueue:function(){}},c={getTransactionWrappers:function(){return u},getReactMountReady:function(){return l},getUpdateQueue:function(){return this.updateQueue},destructor:function(){},checkpoint:function(){},rollback:function(){}};o(r.prototype,a,c),i.addPoolingTo(r),e.exports=r},function(e,t,n){"use strict";function r(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function o(e,t){}var i=n(45),a=(n(2),function(){function e(t){r(this,e),this.transaction=t}return e.prototype.isMounted=function(e){return!1},e.prototype.enqueueCallback=function(e,t,n){this.transaction.isInTransaction()&&i.enqueueCallback(e,t,n)},e.prototype.enqueueForceUpdate=function(e){this.transaction.isInTransaction()?i.enqueueForceUpdate(e):o(e,"forceUpdate")},e.prototype.enqueueReplaceState=function(e,t){this.transaction.isInTransaction()?i.enqueueReplaceState(e,t):o(e,"replaceState")},e.prototype.enqueueSetState=function(e,t){this.transaction.isInTransaction()?i.enqueueSetState(e,t):o(e,"setState")},e}());e.exports=a},function(e,t){"use strict";e.exports="15.5.4"},function(e,t){"use strict";var n={xlink:"http://www.w3.org/1999/xlink",xml:"http://www.w3.org/XML/1998/namespace"},r={accentHeight:"accent-height",accumulate:0,additive:0,alignmentBaseline:"alignment-baseline",allowReorder:"allowReorder",alphabetic:0,amplitude:0,arabicForm:"arabic-form",ascent:0,attributeName:"attributeName",attributeType:"attributeType",autoReverse:"autoReverse",azimuth:0,baseFrequency:"baseFrequency",baseProfile:"baseProfile",baselineShift:"baseline-shift",bbox:0,begin:0,bias:0,by:0,calcMode:"calcMode",capHeight:"cap-height",clip:0,clipPath:"clip-path",clipRule:"clip-rule",clipPathUnits:"clipPathUnits",colorInterpolation:"color-interpolation",colorInterpolationFilters:"color-interpolation-filters",colorProfile:"color-profile",colorRendering:"color-rendering",contentScriptType:"contentScriptType",contentStyleType:"contentStyleType",cursor:0,cx:0,cy:0,d:0,decelerate:0,descent:0,diffuseConstant:"diffuseConstant",direction:0,display:0,divisor:0,dominantBaseline:"dominant-baseline",dur:0,dx:0,dy:0,edgeMode:"edgeMode",elevation:0,enableBackground:"enable-background",end:0,exponent:0,externalResourcesRequired:"externalResourcesRequired",fill:0,fillOpacity:"fill-opacity",fillRule:"fill-rule",filter:0,filterRes:"filterRes",filterUnits:"filterUnits",floodColor:"flood-color",floodOpacity:"flood-opacity",focusable:0,fontFamily:"font-family",fontSize:"font-size",fontSizeAdjust:"font-size-adjust",fontStretch:"font-stretch",fontStyle:"font-style",fontVariant:"font-variant",fontWeight:"font-weight",format:0,from:0,fx:0,fy:0,g1:0,g2:0,glyphName:"glyph-name",glyphOrientationHorizontal:"glyph-orientation-horizontal",glyphOrientationVertical:"glyph-orientation-vertical",glyphRef:"glyphRef",gradientTransform:"gradientTransform",gradientUnits:"gradientUnits",hanging:0,horizAdvX:"horiz-adv-x",horizOriginX:"horiz-origin-x",ideographic:0,imageRendering:"image-rendering",in:0,in2:0,intercept:0,k:0,k1:0,k2:0,k3:0,k4:0,kernelMatrix:"kernelMatrix",kernelUnitLength:"kernelUnitLength",kerning:0,keyPoints:"keyPoints",keySplines:"keySplines",keyTimes:"keyTimes",lengthAdjust:"lengthAdjust",letterSpacing:"letter-spacing",lightingColor:"lighting-color",limitingConeAngle:"limitingConeAngle",local:0,markerEnd:"marker-end",markerMid:"marker-mid",markerStart:"marker-start",markerHeight:"markerHeight",markerUnits:"markerUnits",markerWidth:"markerWidth",mask:0,maskContentUnits:"maskContentUnits",maskUnits:"maskUnits",mathematical:0,mode:0,numOctaves:"numOctaves",offset:0,opacity:0,operator:0,order:0,orient:0,orientation:0,origin:0,overflow:0,overlinePosition:"overline-position",overlineThickness:"overline-thickness",paintOrder:"paint-order",panose1:"panose-1",pathLength:"pathLength",patternContentUnits:"patternContentUnits",patternTransform:"patternTransform",patternUnits:"patternUnits",pointerEvents:"pointer-events",points:0,pointsAtX:"pointsAtX",pointsAtY:"pointsAtY",pointsAtZ:"pointsAtZ",preserveAlpha:"preserveAlpha",preserveAspectRatio:"preserveAspectRatio",primitiveUnits:"primitiveUnits",r:0,radius:0,refX:"refX",refY:"refY",renderingIntent:"rendering-intent",repeatCount:"repeatCount",repeatDur:"repeatDur",requiredExtensions:"requiredExtensions",requiredFeatures:"requiredFeatures",restart:0,result:0,rotate:0,rx:0,ry:0,scale:0,seed:0,shapeRendering:"shape-rendering",slope:0,spacing:0,specularConstant:"specularConstant",specularExponent:"specularExponent",speed:0,spreadMethod:"spreadMethod",startOffset:"startOffset",stdDeviation:"stdDeviation",stemh:0,stemv:0,stitchTiles:"stitchTiles",stopColor:"stop-color",stopOpacity:"stop-opacity",strikethroughPosition:"strikethrough-position",strikethroughThickness:"strikethrough-thickness",string:0,stroke:0,strokeDasharray:"stroke-dasharray",strokeDashoffset:"stroke-dashoffset",strokeLinecap:"stroke-linecap",strokeLinejoin:"stroke-linejoin",strokeMiterlimit:"stroke-miterlimit",strokeOpacity:"stroke-opacity",strokeWidth:"stroke-width",surfaceScale:"surfaceScale",systemLanguage:"systemLanguage",tableValues:"tableValues",targetX:"targetX",targetY:"targetY",textAnchor:"text-anchor",textDecoration:"text-decoration",textRendering:"text-rendering",textLength:"textLength",to:0,transform:0,u1:0,u2:0,underlinePosition:"underline-position",underlineThickness:"underline-thickness",unicode:0,unicodeBidi:"unicode-bidi",unicodeRange:"unicode-range",unitsPerEm:"units-per-em",vAlphabetic:"v-alphabetic",vHanging:"v-hanging",vIdeographic:"v-ideographic",vMathematical:"v-mathematical",values:0,vectorEffect:"vector-effect",version:0,vertAdvY:"vert-adv-y",vertOriginX:"vert-origin-x",vertOriginY:"vert-origin-y",viewBox:"viewBox",viewTarget:"viewTarget",visibility:0,widths:0,wordSpacing:"word-spacing",writingMode:"writing-mode",x:0,xHeight:"x-height",x1:0,x2:0,xChannelSelector:"xChannelSelector",xlinkActuate:"xlink:actuate",xlinkArcrole:"xlink:arcrole",xlinkHref:"xlink:href",xlinkRole:"xlink:role",xlinkShow:"xlink:show",xlinkTitle:"xlink:title",xlinkType:"xlink:type",xmlBase:"xml:base",xmlns:0,xmlnsXlink:"xmlns:xlink",xmlLang:"xml:lang",xmlSpace:"xml:space",y:0,y1:0,y2:0,yChannelSelector:"yChannelSelector",z:0,zoomAndPan:"zoomAndPan"},o={Properties:{},DOMAttributeNamespaces:{xlinkActuate:n.xlink,xlinkArcrole:n.xlink,xlinkHref:n.xlink,xlinkRole:n.xlink,xlinkShow:n.xlink,xlinkTitle:n.xlink,xlinkType:n.xlink,xmlBase:n.xml,xmlLang:n.xml,xmlSpace:n.xml},DOMAttributeNames:{}};Object.keys(r).forEach(function(e){o.Properties[e]=0,r[e]&&(o.DOMAttributeNames[e]=r[e])}),e.exports=o},function(e,t,n){"use strict";function r(e){if("selectionStart"in e&&u.hasSelectionCapabilities(e))return{start:e.selectionStart,end:e.selectionEnd};if(window.getSelection){var t=window.getSelection();return{anchorNode:t.anchorNode,anchorOffset:t.anchorOffset,focusNode:t.focusNode,focusOffset:t.focusOffset}}if(document.selection){var n=document.selection.createRange();return{parentElement:n.parentElement(),text:n.text,top:n.boundingTop,left:n.boundingLeft}}}function o(e,t){if(y||null==m||m!==c())return null;var n=r(m);if(!g||!f(g,n)){g=n;var o=l.getPooled(h.select,v,e,t);return o.type="select",o.target=m,i.accumulateTwoPhaseDispatches(o),o}return null}var i=n(25),a=n(7),s=n(6),u=n(72),l=n(11),c=n(59),p=n(81),f=n(36),d=a.canUseDOM&&"documentMode"in document&&document.documentMode<=11,h={select:{phasedRegistrationNames:{bubbled:"onSelect",captured:"onSelectCapture"},dependencies:["topBlur","topContextMenu","topFocus","topKeyDown","topKeyUp","topMouseDown","topMouseUp","topSelectionChange"]}},m=null,v=null,g=null,y=!1,b=!1,C={eventTypes:h,extractEvents:function(e,t,n,r){if(!b)return null;var i=t?s.getNodeFromInstance(t):window;switch(e){case"topFocus":(p(i)||"true"===i.contentEditable)&&(m=i,v=t,g=null);break;case"topBlur":m=null,v=null,g=null;break;case"topMouseDown":y=!0;break;case"topContextMenu":case"topMouseUp":return y=!1,o(n,r);case"topSelectionChange":if(d)break;case"topKeyDown":case"topKeyUp":return o(n,r)}return null},didPutListener:function(e,t,n){"onSelect"===t&&(b=!0)}};e.exports=C},function(e,t,n){"use strict";function r(e){return"."+e._rootNodeID}function o(e){return"button"===e||"input"===e||"select"===e||"textarea"===e}var i=n(3),a=n(57),s=n(25),u=n(6),l=n(168),c=n(169),p=n(11),f=n(172),d=n(174),h=n(30),m=n(171),v=n(175),g=n(176),y=n(27),b=n(177),C=n(8),_=n(47),w=(n(1),{}),E={};["abort","animationEnd","animationIteration","animationStart","blur","canPlay","canPlayThrough","click","contextMenu","copy","cut","doubleClick","drag","dragEnd","dragEnter","dragExit","dragLeave","dragOver","dragStart","drop","durationChange","emptied","encrypted","ended","error","focus","input","invalid","keyDown","keyPress","keyUp","load","loadedData","loadedMetadata","loadStart","mouseDown","mouseMove","mouseOut","mouseOver","mouseUp","paste","pause","play","playing","progress","rateChange","reset","scroll","seeked","seeking","stalled","submit","suspend","timeUpdate","touchCancel","touchEnd","touchMove","touchStart","transitionEnd","volumeChange","waiting","wheel"].forEach(function(e){var t=e[0].toUpperCase()+e.slice(1),n="on"+t,r="top"+t,o={phasedRegistrationNames:{bubbled:n,captured:n+"Capture"},dependencies:[r]};w[e]=o,E[r]=o});var T={},x={eventTypes:w,extractEvents:function(e,t,n,r){var o=E[e];if(!o)return null;var a;switch(e){case"topAbort":case"topCanPlay":case"topCanPlayThrough":case"topDurationChange":case"topEmptied":case"topEncrypted":case"topEnded":case"topError":case"topInput":case"topInvalid":case"topLoad":case"topLoadedData":case"topLoadedMetadata":case"topLoadStart":case"topPause":case"topPlay":case"topPlaying":case"topProgress":case"topRateChange":case"topReset":case"topSeeked":case"topSeeking":case"topStalled":case"topSubmit":case"topSuspend":case"topTimeUpdate":case"topVolumeChange":case"topWaiting":a=p;break;case"topKeyPress":if(0===_(n))return null;case"topKeyDown":case"topKeyUp":a=d;break;case"topBlur":case"topFocus":a=f;break;case"topClick":if(2===n.button)return null;case"topDoubleClick":case"topMouseDown":case"topMouseMove":case"topMouseUp":case"topMouseOut":case"topMouseOver":case"topContextMenu":a=h;break;case"topDrag":case"topDragEnd":case"topDragEnter":case"topDragExit":case"topDragLeave":case"topDragOver":case"topDragStart":case"topDrop":a=m;break;case"topTouchCancel":case"topTouchEnd":case"topTouchMove":case"topTouchStart":a=v;break;case"topAnimationEnd":case"topAnimationIteration":case"topAnimationStart":a=l;break;case"topTransitionEnd":a=g;break;case"topScroll":a=y;break;case"topWheel":a=b;break;case"topCopy":case"topCut":case"topPaste":a=c}a?void 0:i("86",e);var u=a.getPooled(o,t,n,r);return s.accumulateTwoPhaseDispatches(u),u},didPutListener:function(e,t,n){if("onClick"===t&&!o(e._tag)){var i=r(e),s=u.getNodeFromInstance(e);T[i]||(T[i]=a.listen(s,"click",C))}},willDeleteListener:function(e,t){if("onClick"===t&&!o(e._tag)){var n=r(e);T[n].remove(),delete T[n]}}};e.exports=x},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(11),i={animationName:null,elapsedTime:null,pseudoElement:null};o.augmentClass(r,i),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(11),i={clipboardData:function(e){return"clipboardData"in e?e.clipboardData:window.clipboardData}};o.augmentClass(r,i),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(11),i={data:null};o.augmentClass(r,i),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(30),i={dataTransfer:null};o.augmentClass(r,i),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(27),i={relatedTarget:null};o.augmentClass(r,i),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(11),i={data:null};o.augmentClass(r,i),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(27),i=n(47),a=n(182),s=n(48),u={key:a,location:null,ctrlKey:null,shiftKey:null,altKey:null,metaKey:null,repeat:null,locale:null,getModifierState:s,charCode:function(e){return"keypress"===e.type?i(e):0},keyCode:function(e){return"keydown"===e.type||"keyup"===e.type?e.keyCode:0},which:function(e){return"keypress"===e.type?i(e):"keydown"===e.type||"keyup"===e.type?e.keyCode:0}};o.augmentClass(r,u),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(27),i=n(48),a={touches:null,targetTouches:null,changedTouches:null,altKey:null,metaKey:null,ctrlKey:null,shiftKey:null,getModifierState:i};o.augmentClass(r,a),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(11),i={propertyName:null,elapsedTime:null,pseudoElement:null};o.augmentClass(r,i),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(30),i={deltaX:function(e){return"deltaX"in e?e.deltaX:"wheelDeltaX"in e?-e.wheelDeltaX:0},deltaY:function(e){return"deltaY"in e?e.deltaY:"wheelDeltaY"in e?-e.wheelDeltaY:"wheelDelta"in e?-e.wheelDelta:0},deltaZ:null,deltaMode:null};o.augmentClass(r,i),e.exports=r},function(e,t){"use strict";function n(e){for(var t=1,n=0,o=0,i=e.length,a=i&-4;o<a;){for(var s=Math.min(o+4096,a);o<s;o+=4)n+=(t+=e.charCodeAt(o))+(t+=e.charCodeAt(o+1))+(t+=e.charCodeAt(o+2))+(t+=e.charCodeAt(o+3));t%=r,n%=r}for(;o<i;o++)n+=t+=e.charCodeAt(o);return t%=r,n%=r,t|n<<16}var r=65521;e.exports=n},function(e,t,n){"use strict";function r(e,t,n){var r=null==t||"boolean"==typeof t||""===t;if(r)return"";var o=isNaN(t);if(o||0===t||i.hasOwnProperty(e)&&i[e])return""+t;if("string"==typeof t){t=t.trim()}return t+"px"}var o=n(64),i=(n(2),o.isUnitlessNumber);e.exports=r},function(e,t,n){"use strict";function r(e){if(null==e)return null;if(1===e.nodeType)return e;var t=a.get(e);return t?(t=s(t),t?i.getNodeFromInstance(t):null):void("function"==typeof e.render?o("44"):o("45",Object.keys(e)))}var o=n(3),i=(n(12),n(6)),a=n(26),s=n(78);n(1),n(2);e.exports=r},function(e,t,n){(function(t){"use strict";function r(e,t,n,r){if(e&&"object"==typeof e){var o=e,i=void 0===o[n];i&&null!=t&&(o[n]=t)}}function o(e,t){if(null==e)return e;var n={};return i(e,r,n),n}var i=(n(41),n(83));n(2);e.exports=o}).call(t,n(60))},function(e,t,n){"use strict";function r(e){if(e.key){var t=i[e.key]||e.key;if("Unidentified"!==t)return t}if("keypress"===e.type){var n=o(e);return 13===n?"Enter":String.fromCharCode(n)}return"keydown"===e.type||"keyup"===e.type?a[e.keyCode]||"Unidentified":""}var o=n(47),i={Esc:"Escape",Spacebar:" ",Left:"ArrowLeft",Up:"ArrowUp",Right:"ArrowRight",Down:"ArrowDown",Del:"Delete",Win:"OS",Menu:"ContextMenu",Apps:"ContextMenu",Scroll:"ScrollLock",MozPrintableKey:"Unidentified"},a={8:"Backspace",9:"Tab",12:"Clear",13:"Enter",16:"Shift",17:"Control",18:"Alt",19:"Pause",20:"CapsLock",27:"Escape",32:" ",33:"PageUp",34:"PageDown",35:"End",36:"Home",37:"ArrowLeft",38:"ArrowUp",39:"ArrowRight",40:"ArrowDown",45:"Insert",46:"Delete",112:"F1",113:"F2",114:"F3",115:"F4",116:"F5",117:"F6",118:"F7",119:"F8",120:"F9",121:"F10",122:"F11",123:"F12",144:"NumLock",145:"ScrollLock",224:"Meta"};e.exports=r},function(e,t){"use strict";function n(e){var t=e&&(r&&e[r]||e[o]);if("function"==typeof t)return t}var r="function"==typeof Symbol&&Symbol.iterator,o="@@iterator";e.exports=n},function(e,t){"use strict";function n(e){for(;e&&e.firstChild;)e=e.firstChild;return e}function r(e){for(;e;){if(e.nextSibling)return e.nextSibling;e=e.parentNode}}function o(e,t){for(var o=n(e),i=0,a=0;o;){if(3===o.nodeType){if(a=i+o.textContent.length,i<=t&&a>=t)return{node:o,offset:t-i};i=a}o=n(r(o))}}e.exports=o},function(e,t,n){"use strict";function r(e,t){var n={};return n[e.toLowerCase()]=t.toLowerCase(),n["Webkit"+e]="webkit"+t,n["Moz"+e]="moz"+t,n["ms"+e]="MS"+t,n["O"+e]="o"+t.toLowerCase(),n}function o(e){if(s[e])return s[e];if(!a[e])return e;var t=a[e];for(var n in t)if(t.hasOwnProperty(n)&&n in u)return s[e]=t[n];return""}var i=n(7),a={animationend:r("Animation","AnimationEnd"),animationiteration:r("Animation","AnimationIteration"),animationstart:r("Animation","AnimationStart"),transitionend:r("Transition","TransitionEnd")},s={},u={};i.canUseDOM&&(u=document.createElement("div").style,"AnimationEvent"in window||(delete a.animationend.animation,delete a.animationiteration.animation,delete a.animationstart.animation),"TransitionEvent"in window||delete a.transitionend.transition),e.exports=o},function(e,t,n){"use strict";function r(e){return'"'+o(e)+'"'}var o=n(32);e.exports=r},function(e,t,n){"use strict";var r=n(73);e.exports=r.renderSubtreeIntoContainer},function(e,t,n){"use strict";"undefined"==typeof Promise&&(n(120).enable(),window.Promise=n(119)),n(226),Object.assign=n(4)},113,114,115,116,117,function(e,t,n){(function(){var t,r,o;t=n(5),r=t.createClass,o=t.DOM.div,e.exports=r({getDefaultProps:function(){return{className:"",onHeightChange:function(){}}},render:function(){return o({className:this.props.className,ref:"dropdown"},this.props.children)},componentDidMount:function(){this.props.onHeightChange(this.refs.dropdown.offsetHeight)},componentDidUpdate:function(){this.props.onHeightChange(this.refs.dropdown.offsetHeight)},componentWillUnmount:function(){this.props.onHeightChange(0)}})}).call(this)},function(e,t,n){(function(){function t(e,t){var n={}.hasOwnProperty;for(var r in t)n.call(t,r)&&(e[r]=t[r]);return e}var r,o,i,a,s,u,l,c,p,f,d,h,m,v,g,y,b,C;r=n(15),o=r.filter,i=r.id,a=r.map,s=n(16).isEqualToObject,u=n(5),r=u.DOM,l=r.div,c=r.input,p=r.span,f=u.createClass,d=u.createFactory,h=n(13).findDOMNode,m=d(n(63)),v=d(n(198)),g=d(n(194)),y=d(n(84)),r=n(28),b=r.cancelEvent,C=r.classNameFromObject,e.exports=f({displayName:"DropdownMenu",getDefaultProps:function(){return{className:"",dropdownDirection:1,groupId:function(e){return e.groupId},groupsAsColumns:!1,highlightedUid:void 0,onHighlightedUidChange:function(e,t){},onOptionClick:function(e){},onScrollLockChange:function(e){},options:[],renderNoResultsFound:function(){return l({className:"no-results-found"},"No results found")},renderGroupTitle:function(e,t){var n,r;return null!=t&&(n=t.groupId,r=t.title),l({className:"simple-group-title",key:n},r)},renderOption:function(e){var t,n,r,o;return null!=e&&(t=e.label,n=e.newOption,r=e.selectable),o="undefined"==typeof r||r,l({className:"simple-option "+(o?"":"not-selectable")},p(null,n?"Add "+t+" ...":t))},scrollLock:!1,style:{},tether:!1,tetherProps:{},theme:"default",transitionEnter:!1,transitionLeave:!1,transitionEnterTimeout:200,transitionLeaveTimeout:200,uid:i}},render:function(){var e,n;return e=C((n={},n[this.props.theme+""]=1,n[this.props.className+""]=1,n.flipped=this.props.dropdownDirection===-1,n.tethered=this.props.tether,n)),this.props.tether?v((n=t({},this.props.tetherProps),n.options={attachment:"top left",targetAttachment:"bottom left",constraints:[{to:"scrollParent"}]},n),this.renderAnimatedDropdown({dynamicClassName:e})):this.renderAnimatedDropdown({dynamicClassName:e})},renderAnimatedDropdown:function(e){var t;return t=e.dynamicClassName,this.props.transitionEnter||this.props.transitionLeave?m({component:"div",transitionName:"custom",transitionEnter:this.props.transitionEnter,transitionLeave:this.props.transitionLeave,transitionEnterTimeout:this.props.transitionEnterTimeout,transitionLeaveTimeout:this.props.transitionLeaveTimeout,className:"dropdown-menu-wrapper "+t,ref:"dropdownMenuWrapper"},this.renderDropdown(e)):this.renderDropdown(e)},renderOptions:function(e){var n=this;return a(function(r){var o,i;return o=e[r],i=n.props.uid(o),y(t({uid:i,ref:"option-"+n.uidToString(i),key:n.uidToString(i),item:o,highlight:s(n.props.highlightedUid,i),selectable:null!=o?o.selectable:void 0,onMouseMove:function(e){var t;t=e.currentTarget,n.props.scrollLock&&n.props.onScrollLockChange(!1)},onMouseOut:function(){n.props.scrollLock||n.props.onHighlightedUidChange(void 0,function(){})},renderItem:n.props.renderOption},function(){switch(!1){case!("boolean"==typeof(null!=o?o.selectable:void 0)&&!o.selectable):return{onClick:b};default:return{onClick:function(){n.props.onOptionClick(n.props.highlightedUid)},onMouseOver:function(e){var t;t=e.currentTarget,n.props.scrollLock||n.props.onHighlightedUidChange(i,function(){})}}}}()))})(function(){var t,n,r=[];for(t=0,n=e.length;t<n;++t)r.push(t);return r}())},renderDropdown:function(e){var t,n,r,i,s=this;return t=e.dynamicClassName,this.props.open?g({className:"dropdown-menu "+t,ref:"dropdownMenu",onHeightChange:function(e){s.refs.dropdownMenuWrapper&&(h(s.refs.dropdownMenuWrapper).style.height=e+"px")}},0===this.props.options.length?this.props.renderNoResultsFound():(null!=(n=this.props)&&null!=(r=n.groups)?r.length:void 0)>0?(i=a(function(e){var t,n,r;return t=s.props.groups[e],n=t.groupId,r=o(function(e){return s.props.groupId(e)===n})(s.props.options),{index:e,group:t,options:r}})(function(){var e,t,n=[];for(e=0,t=this.props.groups.length;e<t;++e)n.push(e);return n}.call(this)),l({className:"groups "+(this.props.groupsAsColumns?"as-columns":"")},a(function(e){var t,n,r,o;return t=e.index,n=e.group,r=n.groupId,o=e.options,l({key:r},s.props.renderGroupTitle(t,n,o),l({className:"options"},s.renderOptions(o)))})(o(function(e){return e.options.length>0})(i)))):this.renderOptions(this.props.options)):null},componentDidUpdate:function(){var e,t,n;e=t=h(null!=(n=this.refs.dropdownMenuWrapper)?n:this.refs.dropdownMenu),null!=e&&(e.style.bottom=function(){switch(!1){case this.props.dropdownDirection!==-1:return this.props.bottomAnchor().offsetHeight+t.style.marginBottom+"px";default:return""}}.call(this))},highlightAndScrollToOption:function(e,t){var n,r=this;null==t&&(t=function(){}),n=this.props.uid(this.props.options[e]),this.props.onHighlightedUidChange(n,function(){var e,o,i,a,s;return null!=(e=h(null!=(o=r.refs)?o["option-"+r.uidToString(n)]:void 0))&&(i=e),i&&(a=h(r.refs.dropdownMenu),s=i.offsetHeight-1,i.offsetTop-a.scrollTop>=a.offsetHeight?a.scrollTop=i.offsetTop-a.offsetHeight+s:i.offsetTop-a.scrollTop+s<=0&&(a.scrollTop=i.offsetTop)),t()})},highlightAndScrollToSelectableOption:function(e,t,n){var r,o,i;null==n&&(n=function(){}),e<0||e>=this.props.options.length?this.props.onHighlightedUidChange(void 0,function(){return n(!1)}):(r=null!=(o=this.props)&&null!=(i=o.options)?i[e]:void 0,"boolean"!=typeof(null!=r?r.selectable:void 0)||r.selectable?this.highlightAndScrollToOption(e,function(){return n(!0)}):this.highlightAndScrollToSelectableOption(e+t,t,n))},uidToString:function(e){return("object"==typeof e?JSON.stringify:i)(e)}})}).call(this)},function(e,t,n){(function(){var t,r,o,i,a,s;t=n(5),r=t.createClass,o=t.DOM,i=o.div,a=o.span,s=n(15).map,e.exports=r({getDefaultProps:function(){return{partitions:[],text:"",style:{},highlightStyle:{}}},render:function(){var e=this;return i({className:"highlighted-text",style:this.props.style},s(function(t){var n,r,o;return n=t[0],r=t[1],o=t[2],a({key:e.props.text+""+n+r+o,className:o?"highlight":"",style:o?e.props.highlightStyle:{}},e.props.text.substring(n,r))})(this.props.partitions))}})}).call(this)},function(e,t,n){(function(){function t(e,t){for(var n=-1,r=t.length>>>0;++n<r;)if(e===t[n])return!0;return!1}function r(e,t){var n,r=function(o){return e.length>1?function(){var i=o?o.concat():[];return n=t?n||this:this,i.push.apply(i,arguments)<e.length&&arguments.length?r.call(n,i):e.apply(n,i)}:e};return r()}function o(e,t){var n={}.hasOwnProperty;for(var r in t)n.call(t,r)&&(e[r]=t[r]);return e}var i,a,s,u,l,c,p,f,d,h,m,v,g,y,b,C,_,w,E,T,x,O={}.toString;i=n(15),a=i.all,s=i.any,u=i.camelize,l=i.difference,c=i.drop,p=i.filter,f=i.find,d=i.findIndex,h=i.id,m=i.last,v=i.map,g=i.reject,y=n(16).isEqualToObject,b=n(5),C=b.createFactory,i=b.DOM,_=i.div,w=i.img,E=i.span,T=C(n(53)),x=n(28).cancelEvent,e.exports=b.createClass({displayName:"MultiSelect",getDefaultProps:function(){return{className:"",closeOnSelect:!1,defaultValues:[],delimiters:[],filterOptions:r(function(e,n,r){return p(function(e){return e.label.toLowerCase().trim().indexOf(r.toLowerCase().trim())>-1})(g(function(e){return t(e.label.trim(),v(function(e){return e.label.trim()},null!=n?n:[]))})(e))}),firstOptionIndexToHighlight:h,onBlur:function(e){},onFocus:function(e){},onPaste:function(e){},serialize:v(function(e){return null!=e?e.value:void 0}),tether:!1}},render:function(){var e,t,n,r,i,a,s,u,l,c,p,f,d,h,v,g,y,b,C,_,w,E,O,P,k,S,N,M,A,I,D,R,L,U,F,j,B,V,W=this;return e=this.getComputedState(),t=e.anchor,n=e.filteredOptions,r=e.highlightedUid,i=e.onAnchorChange,a=e.onOpenChange,s=e.onHighlightedUidChange,u=e.onSearchChange,l=e.onValuesChange,c=e.search,p=e.open,f=e.options,d=e.values,null!=(e=this.props)&&(h=e.autofocus,v=e.autosize,g=e.cancelKeyboardEventOnSelection,y=e.delimiters,b=e.disabled,C=e.dropdownDirection,_=e.groupId,w=e.groups,E=e.groupsAsColumns,O=e.hideResetButton,P=e.inputProps,k=e.name,S=e.onKeyboardSelectionFailed,N=e.renderToggleButton,M=e.renderGroupTitle,A=e.renderResetButton,I=e.serialize,D=e.tether,R=e.tetherProps,L=e.theme,U=e.transitionEnter,F=e.transitionLeave,j=e.transitionEnterTimeout,B=e.transitionLeaveTimeout,V=e.uid),T(o(o({autofocus:h,autosize:v,cancelKeyboardEventOnSelection:g,className:"multi-select "+this.props.className,delimiters:y,disabled:b,dropdownDirection:C,groupId:_,groups:w,groupsAsColumns:E,hideResetButton:O,highlightedUid:r,onHighlightedUidChange:s,inputProps:P,name:k,onKeyboardSelectionFailed:S,renderGroupTitle:M,renderResetButton:A,renderToggleButton:N,scrollLock:this.state.scrollLock,onScrollLockChange:function(e){return W.setState({scrollLock:e})},tether:D,tetherProps:R,theme:L,transitionEnter:U,transitionEnterTimeout:j,transitionLeave:F,transitionLeaveTimeout:B,uid:V,ref:"select",anchor:t,onAnchorChange:i,open:p,onOpenChange:a,options:f,renderOption:this.props.renderOption,firstOptionIndexToHighlight:function(){return W.firstOptionIndexToHighlight(f)},search:c,onSearchChange:function(e,t){return u(W.props.maxValues&&d.length>=W.props.maxValues?"":e,t)},values:d,onValuesChange:function(e,t){return l(e,function(){if(t(),W.props.closeOnSelect||W.props.maxValues&&W.values().length>=W.props.maxValues)return a(!1,function(){})})},renderValue:this.props.renderValue,serialize:I,onBlur:function(e){u("",function(){return W.props.onBlur({open:p,values:d,originalEvent:e})})},onFocus:function(e){W.props.onFocus({open:p,values:d,originalEvent:e})},onPaste:function(){var e;switch(!1){case"undefined"!=typeof(null!=(e=this.props)?e.valuesFromPaste:void 0):return this.props.onPaste;default:return function(e){var t;return t=e.clipboardData,function(){var e;return e=d.concat(W.props.valuesFromPaste(f,d,t.getData("text"))),l(e,function(){return i(m(e))})}(),x(e)}}}.call(this),placeholder:this.props.placeholder,style:this.props.style},function(){switch(!1){case"function"!=typeof this.props.restoreOnBackspace:return{restoreOnBackspace:this.props.restoreOnBackspace};default:return{}}}.call(this)),function(){switch(!1){case"function"!=typeof this.props.renderNoResultsFound:return{renderNoResultsFound:function(){return W.props.renderNoResultsFound(d,c)}};default:return{}}}.call(this)))},getComputedState:function(){var e,t,n,r,i,a,s,l,c,p,f,d,h,m,g,y,b=this;return e=this.props.hasOwnProperty("anchor")?this.props.anchor:this.state.anchor,t=this.props.hasOwnProperty("highlightedUid")?this.props.highlightedUid:this.state.highlightedUid,n=this.isOpen(),r=this.props.hasOwnProperty("search")?this.props.search:this.state.search,i=this.values(),a=v(function(e){switch(!1){case!(b.props.hasOwnProperty(e)&&b.props.hasOwnProperty(u("on-"+e+"-change"))):return function(t,n){return b.props[u("on-"+e+"-change")](t,function(){}),b.setState({},n)};case!(b.props.hasOwnProperty(e)&&!b.props.hasOwnProperty(u("on-"+e+"-change"))):return function(e,t){return t()};case!(!b.props.hasOwnProperty(e)&&b.props.hasOwnProperty(u("on-"+e+"-change"))):return function(t,n){var r;return b.setState((r={},r[e+""]=t,r),function(){return n(),b.props[u("on-"+e+"-change")](t,function(){})})};case!(!b.props.hasOwnProperty(e)&&!b.props.hasOwnProperty(u("on-"+e+"-change"))):return function(t,n){var r;return b.setState((r={},r[e+""]=t,r),n)}}})(["anchor","highlightedUid","open","search","values"]),s=a[0],l=a[1],c=a[2],p=a[3],f=a[4],d=function(){var e;switch(!1){case!(null!=(e=this.props)&&e.children):return v(function(e){var t,n,r;return null!=e&&(t=e.props),null!=t&&(n=t.value,r=t.children),{label:r,value:n}})("Array"===O.call(this.props.children).slice(8,-1)?this.props.children:[this.props.children]);default:return[]}}.call(this),h=this.props.hasOwnProperty("options")?null!=(a=this.props.options)?a:[]:d,m=this.props.filterOptions(h,i,r),g=function(){switch(!1){case"function"!=typeof this.props.createFromSearch:return this.props.createFromSearch(m,i,r);default:return null}}.call(this),y=(g?[(a=o({},g),a.newOption=!0,a)]:[]).concat(m),{anchor:e,highlightedUid:t,search:r,values:i,onAnchorChange:s,onHighlightedUidChange:l,open:n,onOpenChange:function(e,t){c(function(){switch(!1){case!("undefined"!=typeof this.props.maxValues&&this.values().length>=this.props.maxValues):return!1;default:return e}}.call(b),t)},onSearchChange:p,onValuesChange:f,filteredOptions:m,options:y}},getInitialState:function(){return{anchor:this.props.values?m(this.props.values):void 0,highlightedUid:void 0,open:!1,scrollLock:!1,search:"",values:this.props.defaultValues}},firstOptionIndexToHighlight:function(e){var t,n;return t=function(){var t;switch(!1){case 1!==e.length:return 0;case"undefined"!=typeof(null!=(t=e[0])?t.newOption:void 0):return 0;default:return a(function(e){return"boolean"==typeof e.selectable&&!e.selectable})(c(1)(e))?0:1}}(),n=this.props.hasOwnProperty("search")?this.props.search:this.state.search,this.props.firstOptionIndexToHighlight(t,e,this.values(),n)},focus:function(){this.refs.select.focus()},blur:function(){this.refs.select.blur()},highlightFirstSelectableOption:function(){this.state.open&&this.refs.select.highlightAndScrollToSelectableOption(this.firstOptionIndexToHighlight(this.getComputedState().options),1)},values:function(){return this.props.hasOwnProperty("values")?this.props.values:this.state.values},isOpen:function(){return this.props.hasOwnProperty("open")?this.props.open:this.state.open}})}).call(this)},function(e,t,n){(function(){function t(e,t){var n={}.hasOwnProperty;for(var r in t)n.call(t,r)&&(e[r]=t[r]);return e}var r,o,i,a,s,u;r=n(5).createClass,o=n(13),i=o.render,a=o.unmountComponentAtNode,s=n(124),u=n(224),e.exports=r({getDefaultProps:function(){return{parentElement:function(){return document.body;
+}}},render:function(){return null},initTether:function(e){var n=this;this.node=document.createElement("div"),this.props.parentElement().appendChild(this.node),this.tether=new u(t({element:this.node,target:e.target()},e.options)),i(e.children,this.node,function(){return n.tether.position()})},destroyTether:function(){this.tether&&this.tether.destroy(),this.node&&(a(this.node),this.node.parentElement.removeChild(this.node)),this.node=this.tether=void 0},componentDidMount:function(){this.props.children&&this.initTether(this.props)},componentWillReceiveProps:function(e){var n=this;this.props.children&&!e.children?this.destroyTether():e.children&&!this.props.children?this.initTether(e):e.children&&(this.tether.setOptions(t({element:this.node,target:e.target()},e.options)),i(e.children,this.node,function(){return n.tether.position()}))},shouldComponentUpdate:function(e,t){return s(this,e,t)},componentWillUnmount:function(){this.destroyTether()}})}).call(this)},function(e,t,n){(function(){var t,r,o,i,a;t=n(5),r=t.createClass,o=t.createFactory,i=t.DOM.path,a=o(n(85)),e.exports=r({render:function(){return a({className:"react-selectize-reset-button",style:{width:8,height:8}},i({d:"M0 0 L8 8 M8 0 L 0 8"}))}})}).call(this)},function(e,t,n){(function(){function t(e,t){var n={}.hasOwnProperty;for(var r in t)n.call(t,r)&&(e[r]=t[r]);return e}var r,o,i,a,s,u,l,c;r=n(15),o=r.each,i=r.objToPairs,a=n(5),s=a.DOM.input,u=a.createClass,l=a.createFactory,c=n(13).findDOMNode,e.exports=u({displayName:"ResizableInput",render:function(){var e;return s((e=t({},this.props),e.type="input",e.className="resizable-input",e))},autosize:function(){var e,t,n,r,a;return e=t=c(this),e.style.width="0px",0===t.value.length?t.style.width=null!=t&&t.currentStyle?"4px":"2px":t.scrollWidth>0?t.style.width=2+t.scrollWidth+"px":(n=r=document.createElement("div"),n.innerHTML=t.value,function(){var e;return e=r.style,e.display="inline-block",e.width="",e}(o(function(e){var t,n;return t=e[0],n=e[1],r.style[t]=n})(i(t.currentStyle?t.currentStyle:null!=(a=document.defaultView)?a:window.getComputedStyle(t)))),document.body.appendChild(r),t.style.width=4+r.clientWidth+"px",document.body.removeChild(r))},componentDidMount:function(){this.autosize()},componentDidUpdate:function(){this.autosize()},blur:function(){return c(this).blur()},focus:function(){return c(this).focus()}})}).call(this)},function(e,t,n){(function(){function t(e,t){var n,r=function(o){return e.length>1?function(){var i=o?o.concat():[];return n=t?n||this:this,i.push.apply(i,arguments)<e.length&&arguments.length?r.call(n,i):e.apply(n,i)}:e};return r()}function r(e,t){var n={}.hasOwnProperty;for(var r in t)n.call(t,r)&&(e[r]=t[r]);return e}var o,i,a,s,u,l,c,p,f,d,h,m,v,g,y,b,C,_,w,E,T,x={}.toString;o=n(15),i=o.all,a=o.any,s=o.drop,u=o.camelize,l=o.difference,c=o.filter,p=o.find,f=o.findIndex,d=o.id,h=o.last,m=o.map,v=o.reject,g=n(16).isEqualToObject,y=n(5),b=y.createFactory,o=y.DOM,C=o.div,_=o.img,w=o.span,E=b(n(53)),T=n(28).cancelEvent,e.exports=y.createClass({displayName:"SimpleSelect",getDefaultProps:function(){return{delimiters:[],filterOptions:t(function(e,t){return c(function(e){return e.label.toLowerCase().trim().indexOf(t.toLowerCase().trim())>-1})(e)}),firstOptionIndexToHighlight:d,onBlur:function(e){},onBlurResetsInput:!0,onFocus:function(e){},onKeyboardSelectionFailed:function(e){},onPaste:function(e){},placeholder:"",renderValue:function(e){var t;return t=e.label,C({className:"simple-value"},w(null,t))},serialize:function(e){return null!=e?e.value:void 0},style:{},tether:!1,uid:d}},render:function(){var e,t,n,o,i,a,s,u,l,c,p,f,d,m,v,y,b,C,_,w,x,O,P,k,S,N,M,A,I,D,R,L,U,F,j,B,V,W=this;return e=this.getComputedState(),t=e.filteredOptions,n=e.highlightedUid,o=e.onHighlightedUidChange,i=e.onOpenChange,a=e.onSearchChange,s=e.onValueChange,u=e.open,l=e.options,c=e.search,p=e.value,f=e.values,null!=(e=this.props)&&(d=e.autofocus,m=e.autosize,v=e.cancelKeyboardEventOnSelection,y=e.delimiters,b=e.disabled,C=e.dropdownDirection,_=e.groupId,w=e.groups,x=e.groupsAsColumns,O=e.hideResetButton,P=e.name,k=e.inputProps,S=e.onBlurResetsInput,N=e.renderToggleButton,M=e.renderGroupTitle,A=e.renderResetButton,I=e.serialize,D=e.tether,R=e.tetherProps,L=e.theme,U=e.transitionEnter,F=e.transitionLeave,j=e.transitionEnterTimeout,B=e.transitionLeaveTimeout,V=e.uid),E(r(r({autofocus:d,autosize:m,cancelKeyboardEventOnSelection:v,className:"simple-select"+(this.props.className?" "+this.props.className:""),delimiters:y,disabled:b,dropdownDirection:C,groupId:_,groups:w,groupsAsColumns:x,hideResetButton:O,highlightedUid:n,onHighlightedUidChange:o,inputProps:k,name:P,onBlurResetsInput:S,renderGroupTitle:M,renderResetButton:A,renderToggleButton:N,scrollLock:this.state.scrollLock,onScrollLockChange:function(e){return W.setState({scrollLock:e})},tether:D,tetherProps:R,theme:L,transitionEnter:U,transitionEnterTimeout:j,transitionLeave:F,transitionLeaveTimeout:B,ref:"select",anchor:h(f),onAnchorChange:function(e,t){return t()},open:u,onOpenChange:i,firstOptionIndexToHighlight:function(){return W.firstOptionIndexToHighlight(l,p)},options:l,renderOption:this.props.renderOption,renderNoResultsFound:this.props.renderNoResultsFound,search:c,onSearchChange:function(e,t){return a(e,t)},values:f,onValuesChange:function(e,t){var n,r;return 0===e.length?s(void 0,function(){return t()}):(n=h(e),r=!g(n,p),function(){return function(e){return r?s(n,e):e()}}()(function(){return t(),i(!1,function(){})}))},renderValue:function(e){return u&&(W.props.editable||c.length>0)?null:W.props.renderValue(e)},onKeyboardSelectionFailed:function(e){return a("",function(){return i(!1,function(){return W.props.onKeyboardSelectionFailed(e)})})},uid:function(e){return{uid:W.props.uid(e),open:u,search:c}},serialize:function(e){return I(e[0])},onBlur:function(e){var t;t=W.props.onBlurResetsInput,function(){return function(e){return c.length>0&&t?a("",e):e()}}()(function(){return W.props.onBlur({value:p,open:u,originalEvent:e})})},onFocus:function(e){W.props.onFocus({value:p,open:u,originalEvent:e})},onPaste:function(){var e;switch(!1){case"undefined"!=typeof(null!=(e=this.props)?e.valueFromPaste:void 0):return this.props.onPaste;default:return function(e){var t,n;if(t=e.clipboardData,n=W.props.valueFromPaste(l,p,t.getData("text")))return function(){return s(n,function(){return a("",function(){return i(!1)})})}(),T(e)}}}.call(this),placeholder:this.props.placeholder,style:this.props.style},function(){switch(!1){case"function"!=typeof this.props.restoreOnBackspace:return{restoreOnBackspace:this.props.restoreOnBackspace};default:return{}}}.call(this)),function(){switch(!1){case"function"!=typeof this.props.renderNoResultsFound:return{renderNoResultsFound:function(){return W.props.renderNoResultsFound(p,c)}};default:return{}}}.call(this)))},getComputedState:function(){var e,t,n,o,i,a,s,l,c,p,f,d,h,v,g,y=this;return e=this.props.hasOwnProperty("highlightedUid")?this.props.highlightedUid:this.state.highlightedUid,t=this.isOpen(),n=this.props.hasOwnProperty("search")?this.props.search:this.state.search,o=this.value(),i=o||0===o?[o]:[],a=m(function(e){var t;return t=function(){switch(!1){case!(this.props.hasOwnProperty(e)&&this.props.hasOwnProperty(u("on-"+e+"-change"))):return function(t,n){return y.props[u("on-"+e+"-change")](t,function(){}),y.setState({},n)};case!(this.props.hasOwnProperty(e)&&!this.props.hasOwnProperty(u("on-"+e+"-change"))):return function(e,t){return t()};case!(!this.props.hasOwnProperty(e)&&this.props.hasOwnProperty(u("on-"+e+"-change"))):return function(t,n){var r;return y.setState((r={},r[e+""]=t,r),function(){return n(),y.props[u("on-"+e+"-change")](t,function(){})})};case!(!this.props.hasOwnProperty(e)&&!this.props.hasOwnProperty(u("on-"+e+"-change"))):return function(t,n){var r;return y.setState((r={},r[e+""]=t,r),n)}}}.call(y)})(["highlightedUid","open","search","value"]),s=a[0],l=a[1],c=a[2],p=a[3],f=function(){var e;switch(!1){case!(null!=(e=this.props)&&e.children):return m(function(e){var t,n,r;return null!=(t=null!=e?e.props:void 0)&&(n=t.value,r=t.children),{label:r,value:n}})("Array"===x.call(this.props.children).slice(8,-1)?this.props.children:[this.props.children]);default:return[]}}.call(this),d=this.props.hasOwnProperty("options")?null!=(a=this.props.options)?a:[]:f,h=this.props.filterOptions(d,n),v=function(){switch(!1){case"function"!=typeof this.props.createFromSearch:return this.props.createFromSearch(h,n);default:return null}}.call(this),g=(v?[(a=r({},v),a.newOption=!0,a)]:[]).concat(h),{highlightedUid:e,open:t,search:n,value:o,values:i,onHighlightedUidChange:s,onOpenChange:function(e,t){l(e,function(){if(t(),y.props.editable&&y.isOpen()&&o)return c(y.props.editable(o)+""+(1===n.length?n:""),function(){return y.highlightFirstSelectableOption(function(){})})})},onSearchChange:c,onValueChange:p,filteredOptions:h,options:g}},getInitialState:function(){var e;return{highlightedUid:void 0,open:!1,scrollLock:!1,search:"",value:null!=(e=this.props)?e.defaultValue:void 0}},firstOptionIndexToHighlight:function(e,t){var n,r,o;return n=t?f(function(e){return g(e,t)},e):void 0,r=function(){var t;switch(!1){case"undefined"==typeof n:return n;case 1!==e.length:return 0;case"undefined"!=typeof(null!=(t=e[0])?t.newOption:void 0):return 0;default:return i(function(e){return"boolean"==typeof e.selectable&&!e.selectable})(s(1)(e))?0:1}}(),o=this.props.hasOwnProperty("search")?this.props.search:this.state.search,this.props.firstOptionIndexToHighlight(r,e,t,o)},focus:function(){this.refs.select.focus()},blur:function(){this.refs.select.blur()},highlightFirstSelectableOption:function(e){var t,n,r;null==e&&(e=function(){}),this.state.open?(t=this.getComputedState(),n=t.options,r=t.value,this.refs.select.highlightAndScrollToSelectableOption(this.firstOptionIndexToHighlight(n,r),1,e)):e()},value:function(){return this.props.hasOwnProperty("value")?this.props.value:this.state.value},isOpen:function(){return this.props.hasOwnProperty("open")?this.props.open:this.state.open}})}).call(this)},function(e,t,n){(function(){var t,r,o,i,a;t=n(5),r=t.createClass,o=t.createFactory,i=t.DOM.path,a=o(n(85)),e.exports=r({getDefaultProps:function(){return{open:!1,flipped:!1}},render:function(){return a({className:"react-selectize-toggle-button",style:{width:10,height:8}},i({d:function(){switch(!1){case!(this.props.open&&!this.props.flipped||!this.props.open&&this.props.flipped):return"M0 6 L5 1 L10 6 Z";default:return"M0 1 L5 6 L10 1 Z"}}.call(this)}))}})}).call(this)},function(e,t,n){(function(){var t,r,o,i;t=n(5),r=t.createClass,o=t.DOM.div,i=n(16).isEqualToObject,e.exports=r({getDefaultProps:function(){return{}},render:function(){return o({className:"value-wrapper"},this.props.renderItem(this.props.item))},shouldComponentUpdate:function(e){var t;return!i(null!=e?e.uid:void 0,null!=(t=this.props)?t.uid:void 0)}})}).call(this)},function(e,t,n){(function(){var t,r,o,i;t=n(196),r=n(201),o=n(197),i=n(53),e.exports={HighlightedText:t,SimpleSelect:r,MultiSelect:o,ReactSelectize:i}}).call(this)},function(e,t,n){"use strict";function r(e){return e&&e.__esModule?e:{default:e}}function o(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function i(e,t){if(!e)throw new ReferenceError("this hasn't been initialised - super() hasn't been called");return!t||"object"!=typeof t&&"function"!=typeof t?e:t}function a(e,t){if("function"!=typeof t&&null!==t)throw new TypeError("Super expression must either be null or a function, not "+typeof t);e.prototype=Object.create(t&&t.prototype,{constructor:{value:e,enumerable:!1,writable:!0,configurable:!0}}),t&&(Object.setPrototypeOf?Object.setPrototypeOf(e,t):e.__proto__=t)}t.__esModule=!0;var s=Object.assign||function(e){for(var t=1;t<arguments.length;t++){var n=arguments[t];for(var r in n)Object.prototype.hasOwnProperty.call(n,r)&&(e[r]=n[r])}return e},u=n(5),l=r(u),c=n(34),p=r(c),f=n(207),d=r(f),h=n(206),m=r(h),v=n(86),g=({transitionName:v.nameShape.isRequired,transitionAppear:p.default.bool,transitionEnter:p.default.bool,transitionLeave:p.default.bool,transitionAppearTimeout:(0,v.transitionTimeout)("Appear"),transitionEnterTimeout:(0,v.transitionTimeout)("Enter"),transitionLeaveTimeout:(0,v.transitionTimeout)("Leave")},{transitionAppear:!1,transitionEnter:!0,transitionLeave:!0}),y=function(e){function t(){var n,r,a;o(this,t);for(var s=arguments.length,u=Array(s),c=0;c<s;c++)u[c]=arguments[c];return n=r=i(this,e.call.apply(e,[this].concat(u))),r._wrapChild=function(e){return l.default.createElement(m.default,{name:r.props.transitionName,appear:r.props.transitionAppear,enter:r.props.transitionEnter,leave:r.props.transitionLeave,appearTimeout:r.props.transitionAppearTimeout,enterTimeout:r.props.transitionEnterTimeout,leaveTimeout:r.props.transitionLeaveTimeout},e)},a=n,i(r,a)}return a(t,e),t.prototype.render=function(){return l.default.createElement(d.default,s({},this.props,{childFactory:this._wrapChild}))},t}(l.default.Component);y.displayName="CSSTransitionGroup",y.propTypes={},y.defaultProps=g,t.default=y,e.exports=t.default},function(e,t,n){"use strict";function r(e){return e&&e.__esModule?e:{default:e}}function o(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function i(e,t){if(!e)throw new ReferenceError("this hasn't been initialised - super() hasn't been called");return!t||"object"!=typeof t&&"function"!=typeof t?e:t}function a(e,t){if("function"!=typeof t&&null!==t)throw new TypeError("Super expression must either be null or a function, not "+typeof t);e.prototype=Object.create(t&&t.prototype,{constructor:{value:e,enumerable:!1,writable:!0,configurable:!0}}),t&&(Object.setPrototypeOf?Object.setPrototypeOf(e,t):e.__proto__=t)}function s(e,t){return w.length?w.forEach(function(n){return e.addEventListener(n,t,!1)}):setTimeout(t,0),function(){w.length&&w.forEach(function(n){return e.removeEventListener(n,t,!1)})}}t.__esModule=!0;var u=Object.assign||function(e){for(var t=1;t<arguments.length;t++){var n=arguments[t];for(var r in n)Object.prototype.hasOwnProperty.call(n,r)&&(e[r]=n[r])}return e},l=n(96),c=r(l),p=n(98),f=r(p),d=n(100),h=r(d),m=n(99),v=n(5),g=r(v),y=n(34),b=r(y),C=n(13),_=n(86),w=[];m.transitionEnd&&w.push(m.transitionEnd),m.animationEnd&&w.push(m.animationEnd);var E=({children:b.default.node,name:_.nameShape.isRequired,appear:b.default.bool,enter:b.default.bool,leave:b.default.bool,appearTimeout:b.default.number,enterTimeout:b.default.number,leaveTimeout:b.default.number},function(e){function t(){var n,r,a;o(this,t);for(var s=arguments.length,u=Array(s),l=0;l<s;l++)u[l]=arguments[l];return n=r=i(this,e.call.apply(e,[this].concat(u))),r.componentWillAppear=function(e){r.props.appear?r.transition("appear",e,r.props.appearTimeout):e()},r.componentWillEnter=function(e){r.props.enter?r.transition("enter",e,r.props.enterTimeout):e()},r.componentWillLeave=function(e){r.props.leave?r.transition("leave",e,r.props.leaveTimeout):e()},a=n,i(r,a)}return a(t,e),t.prototype.componentWillMount=function(){this.classNameAndNodeQueue=[],this.transitionTimeouts=[]},t.prototype.componentWillUnmount=function(){this.unmounted=!0,this.timeout&&clearTimeout(this.timeout),this.transitionTimeouts.forEach(function(e){clearTimeout(e)}),this.classNameAndNodeQueue.length=0},t.prototype.transition=function(e,t,n){var r=(0,C.findDOMNode)(this);if(!r)return void(t&&t());var o=this.props.name[e]||this.props.name+"-"+e,i=this.props.name[e+"Active"]||o+"-active",a=null,u=void 0;(0,c.default)(r,o),this.queueClassAndNode(i,r);var l=function(e){e&&e.target!==r||(clearTimeout(a),u&&u(),(0,f.default)(r,o),(0,f.default)(r,i),u&&u(),t&&t())};n?(a=setTimeout(l,n),this.transitionTimeouts.push(a)):m.transitionEnd&&(u=s(r,l))},t.prototype.queueClassAndNode=function(e,t){var n=this;this.classNameAndNodeQueue.push({className:e,node:t}),this.rafHandle||(this.rafHandle=(0,h.default)(function(){return n.flushClassNameAndNodeQueue()}))},t.prototype.flushClassNameAndNodeQueue=function(){this.unmounted||this.classNameAndNodeQueue.forEach(function(e){e.node.scrollTop,(0,c.default)(e.node,e.className)}),this.classNameAndNodeQueue.length=0,this.rafHandle=null},t.prototype.render=function(){var e=u({},this.props);return delete e.name,delete e.appear,delete e.enter,delete e.leave,delete e.appearTimeout,delete e.enterTimeout,delete e.leaveTimeout,delete e.children,g.default.cloneElement(g.default.Children.only(this.props.children),e)},t}(g.default.Component));E.displayName="CSSTransitionGroupChild",E.propTypes={},t.default=E,e.exports=t.default},function(e,t,n){"use strict";function r(e){return e&&e.__esModule?e:{default:e}}function o(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function i(e,t){if(!e)throw new ReferenceError("this hasn't been initialised - super() hasn't been called");return!t||"object"!=typeof t&&"function"!=typeof t?e:t}function a(e,t){if("function"!=typeof t&&null!==t)throw new TypeError("Super expression must either be null or a function, not "+typeof t);e.prototype=Object.create(t&&t.prototype,{constructor:{value:e,enumerable:!1,writable:!0,configurable:!0}}),t&&(Object.setPrototypeOf?Object.setPrototypeOf(e,t):e.__proto__=t)}t.__esModule=!0;var s=Object.assign||function(e){for(var t=1;t<arguments.length;t++){var n=arguments[t];for(var r in n)Object.prototype.hasOwnProperty.call(n,r)&&(e[r]=n[r])}return e},u=n(95),l=r(u),c=n(5),p=r(c),f=n(34),d=r(f),h=n(225),m=(r(h),n(210)),v=({component:d.default.any,childFactory:d.default.func,children:d.default.node},{component:"span",childFactory:function(e){return e}}),g=function(e){function t(n,r){o(this,t);var a=i(this,e.call(this,n,r));return a.performAppear=function(e,t){a.currentlyTransitioningKeys[e]=!0,t.componentWillAppear?t.componentWillAppear(a._handleDoneAppearing.bind(a,e,t)):a._handleDoneAppearing(e,t)},a._handleDoneAppearing=function(e,t){t.componentDidAppear&&t.componentDidAppear(),delete a.currentlyTransitioningKeys[e];var n=(0,m.getChildMapping)(a.props.children);n&&n.hasOwnProperty(e)||a.performLeave(e,t)},a.performEnter=function(e,t){a.currentlyTransitioningKeys[e]=!0,t.componentWillEnter?t.componentWillEnter(a._handleDoneEntering.bind(a,e,t)):a._handleDoneEntering(e,t)},a._handleDoneEntering=function(e,t){t.componentDidEnter&&t.componentDidEnter(),delete a.currentlyTransitioningKeys[e];var n=(0,m.getChildMapping)(a.props.children);n&&n.hasOwnProperty(e)||a.performLeave(e,t)},a.performLeave=function(e,t){a.currentlyTransitioningKeys[e]=!0,t.componentWillLeave?t.componentWillLeave(a._handleDoneLeaving.bind(a,e,t)):a._handleDoneLeaving(e,t)},a._handleDoneLeaving=function(e,t){t.componentDidLeave&&t.componentDidLeave(),delete a.currentlyTransitioningKeys[e];var n=(0,m.getChildMapping)(a.props.children);n&&n.hasOwnProperty(e)?a.keysToEnter.push(e):a.setState(function(t){var n=s({},t.children);return delete n[e],{children:n}})},a.childRefs=Object.create(null),a.state={children:(0,m.getChildMapping)(n.children)},a}return a(t,e),t.prototype.componentWillMount=function(){this.currentlyTransitioningKeys={},this.keysToEnter=[],this.keysToLeave=[]},t.prototype.componentDidMount=function(){var e=this.state.children;for(var t in e)e[t]&&this.performAppear(t,this.childRefs[t])},t.prototype.componentWillReceiveProps=function(e){var t=(0,m.getChildMapping)(e.children),n=this.state.children;this.setState({children:(0,m.mergeChildMappings)(n,t)});for(var r in t){var o=n&&n.hasOwnProperty(r);!t[r]||o||this.currentlyTransitioningKeys[r]||this.keysToEnter.push(r)}for(var i in n){var a=t&&t.hasOwnProperty(i);!n[i]||a||this.currentlyTransitioningKeys[i]||this.keysToLeave.push(i)}},t.prototype.componentDidUpdate=function(){var e=this,t=this.keysToEnter;this.keysToEnter=[],t.forEach(function(t){return e.performEnter(t,e.childRefs[t])});var n=this.keysToLeave;this.keysToLeave=[],n.forEach(function(t){return e.performLeave(t,e.childRefs[t])})},t.prototype.render=function(){var e=this,t=[],n=function(n){var r=e.state.children[n];if(r){var o="string"!=typeof r.ref,i=e.props.childFactory(r),a=function(t){e.childRefs[n]=t};i===r&&o&&(a=(0,l.default)(r.ref,a)),t.push(p.default.cloneElement(i,{key:n,ref:a}))}};for(var r in this.state.children)n(r);var o=s({},this.props);return delete o.transitionLeave,delete o.transitionName,delete o.transitionAppear,delete o.transitionEnter,delete o.childFactory,delete o.transitionLeaveTimeout,delete o.transitionEnterTimeout,delete o.transitionAppearTimeout,delete o.component,p.default.createElement(this.props.component,o,t)},t}(p.default.Component);g.displayName="TransitionGroup",g.propTypes={},g.defaultProps=v,t.default=g,e.exports=t.default},function(e,t,n){"use strict";function r(){}function o(){}var i=n(209);o.resetWarningCache=r,e.exports=function(){function e(e,t,n,r,o,a){if(a!==i){var s=new Error("Calling PropTypes validators directly is not supported by the `prop-types` package. Use PropTypes.checkPropTypes() to call them. Read more at http://fb.me/use-check-prop-types");throw s.name="Invariant Violation",s}}function t(){return e}e.isRequired=e;var n={array:e,bigint:e,bool:e,func:e,number:e,object:e,string:e,symbol:e,any:e,arrayOf:t,element:e,elementType:e,instanceOf:t,node:e,objectOf:t,oneOf:t,oneOfType:t,shape:t,exact:t,checkPropTypes:o,resetWarningCache:r};return n.PropTypes=n,n}},function(e,t){"use strict";var n="SECRET_DO_NOT_PASS_THIS_OR_YOU_WILL_BE_FIRED";e.exports=n},function(e,t,n){"use strict";function r(e){if(!e)return e;var t={};return i.Children.map(e,function(e){return e}).forEach(function(e){t[e.key]=e}),t}function o(e,t){function n(n){return t.hasOwnProperty(n)?t[n]:e[n]}e=e||{},t=t||{};var r={},o=[];for(var i in e)t.hasOwnProperty(i)?o.length&&(r[i]=o,o=[]):o.push(i);var a=void 0,s={};for(var u in t){if(r.hasOwnProperty(u))for(a=0;a<r[u].length;a++){var l=r[u][a];s[r[u][a]]=n(l)}s[u]=n(u)}for(a=0;a<o.length;a++)s[o[a]]=n(o[a]);return s}t.__esModule=!0,t.getChildMapping=r,t.mergeChildMappings=o;var i=n(5)},41,[228,22],function(e,t,n){"use strict";function r(e){return(""+e).replace(C,"$&/")}function o(e,t){this.func=e,this.context=t,this.count=0}function i(e,t,n){var r=e.func,o=e.context;r.call(o,t,e.count++)}function a(e,t,n){if(null==e)return e;var r=o.getPooled(t,n);g(e,i,r),o.release(r)}function s(e,t,n,r){this.result=e,this.keyPrefix=t,this.func=n,this.context=r,this.count=0}function u(e,t,n){var o=e.result,i=e.keyPrefix,a=e.func,s=e.context,u=a.call(s,t,e.count++);Array.isArray(u)?l(u,o,n,v.thatReturnsArgument):null!=u&&(m.isValidElement(u)&&(u=m.cloneAndReplaceKey(u,i+(!u.key||t&&t.key===u.key?"":r(u.key)+"/")+n)),o.push(u))}function l(e,t,n,o,i){var a="";null!=n&&(a=r(n)+"/");var l=s.getPooled(t,a,o,i);g(e,u,l),s.release(l)}function c(e,t,n){if(null==e)return e;var r=[];return l(e,r,null,t,n),r}function p(e,t,n){return null}function f(e,t){return g(e,p,null)}function d(e){var t=[];return l(e,t,null,v.thatReturnsArgument),t}var h=n(212),m=n(21),v=n(8),g=n(223),y=h.twoArgumentPooler,b=h.fourArgumentPooler,C=/\/+/g;o.prototype.destructor=function(){this.func=null,this.context=null,this.count=0},h.addPoolingTo(o,y),s.prototype.destructor=function(){this.result=null,this.keyPrefix=null,this.func=null,this.context=null,this.count=0},h.addPoolingTo(s,b);var _={forEach:a,map:c,mapIntoWithKeyPrefixInternal:l,count:f,toArray:d};e.exports=_},function(e,t,n){"use strict";function r(e){return e}function o(e,t){var n=C.hasOwnProperty(t)?C[t]:null;w.hasOwnProperty(t)&&("OVERRIDE_BASE"!==n?f("73",t):void 0),e&&("DEFINE_MANY"!==n&&"DEFINE_MANY_MERGED"!==n?f("74",t):void 0)}function i(e,t){if(t){"function"==typeof t?f("75"):void 0,m.isValidElement(t)?f("76"):void 0;var n=e.prototype,r=n.__reactAutoBindPairs;t.hasOwnProperty(y)&&_.mixins(e,t.mixins);for(var i in t)if(t.hasOwnProperty(i)&&i!==y){var a=t[i],s=n.hasOwnProperty(i);if(o(s,i),_.hasOwnProperty(i))_[i](e,a);else{var c=C.hasOwnProperty(i),p="function"==typeof a,d=p&&!c&&!s&&t.autobind!==!1;if(d)r.push(i,a),n[i]=a;else if(s){var h=C[i];!c||"DEFINE_MANY_MERGED"!==h&&"DEFINE_MANY"!==h?f("77",h,i):void 0,"DEFINE_MANY_MERGED"===h?n[i]=u(n[i],a):"DEFINE_MANY"===h&&(n[i]=l(n[i],a))}else n[i]=a}}}else;}function a(e,t){if(t)for(var n in t){var r=t[n];if(t.hasOwnProperty(n)){var o=n in _;o?f("78",n):void 0;var i=n in e;i?f("79",n):void 0,e[n]=r}}}function s(e,t){e&&t&&"object"==typeof e&&"object"==typeof t?void 0:f("80");for(var n in t)t.hasOwnProperty(n)&&(void 0!==e[n]?f("81",n):void 0,e[n]=t[n]);return e}function u(e,t){return function(){var n=e.apply(this,arguments),r=t.apply(this,arguments);if(null==n)return r;if(null==r)return n;var o={};return s(o,n),s(o,r),o}}function l(e,t){return function(){e.apply(this,arguments),t.apply(this,arguments)}}function c(e,t){var n=t.bind(e);return n}function p(e){for(var t=e.__reactAutoBindPairs,n=0;n<t.length;n+=2){var r=t[n],o=t[n+1];e[r]=c(e,o)}}var f=n(22),d=n(4),h=n(54),m=n(21),v=(n(216),n(55)),g=n(23),y=(n(1),n(2),"mixins"),b=[],C={mixins:"DEFINE_MANY",statics:"DEFINE_MANY",propTypes:"DEFINE_MANY",contextTypes:"DEFINE_MANY",childContextTypes:"DEFINE_MANY",getDefaultProps:"DEFINE_MANY_MERGED",getInitialState:"DEFINE_MANY_MERGED",getChildContext:"DEFINE_MANY_MERGED",render:"DEFINE_ONCE",componentWillMount:"DEFINE_MANY",componentDidMount:"DEFINE_MANY",componentWillReceiveProps:"DEFINE_MANY",shouldComponentUpdate:"DEFINE_ONCE",componentWillUpdate:"DEFINE_MANY",componentDidUpdate:"DEFINE_MANY",componentWillUnmount:"DEFINE_MANY",updateComponent:"OVERRIDE_BASE"},_={displayName:function(e,t){e.displayName=t},mixins:function(e,t){if(t)for(var n=0;n<t.length;n++)i(e,t[n])},childContextTypes:function(e,t){e.childContextTypes=d({},e.childContextTypes,t)},contextTypes:function(e,t){e.contextTypes=d({},e.contextTypes,t)},getDefaultProps:function(e,t){e.getDefaultProps?e.getDefaultProps=u(e.getDefaultProps,t):e.getDefaultProps=t},propTypes:function(e,t){e.propTypes=d({},e.propTypes,t)},statics:function(e,t){a(e,t)},autobind:function(){}},w={replaceState:function(e,t){this.updater.enqueueReplaceState(this,e),t&&this.updater.enqueueCallback(this,t,"replaceState")},isMounted:function(){return this.updater.isMounted(this)}},E=function(){};d(E.prototype,h.prototype,w);var T={createClass:function(e){var t=r(function(e,n,r){this.__reactAutoBindPairs.length&&p(this),this.props=e,this.context=n,this.refs=g,this.updater=r||v,this.state=null;var o=this.getInitialState?this.getInitialState():null;"object"!=typeof o||Array.isArray(o)?f("82",t.displayName||"ReactCompositeComponent"):void 0,this.state=o});t.prototype=new E,t.prototype.constructor=t,t.prototype.__reactAutoBindPairs=[],b.forEach(i.bind(null,t)),i(t,e),t.getDefaultProps&&(t.defaultProps=t.getDefaultProps()),t.prototype.render?void 0:f("83");for(var n in C)t.prototype[n]||(t.prototype[n]=null);return t},injection:{injectMixin:function(e){b.push(e)}}};e.exports=T},function(e,t,n){"use strict";var r=n(21),o=r.createFactory,i={a:o("a"),abbr:o("abbr"),address:o("address"),area:o("area"),article:o("article"),aside:o("aside"),audio:o("audio"),b:o("b"),base:o("base"),bdi:o("bdi"),bdo:o("bdo"),big:o("big"),blockquote:o("blockquote"),body:o("body"),br:o("br"),button:o("button"),canvas:o("canvas"),caption:o("caption"),cite:o("cite"),code:o("code"),col:o("col"),colgroup:o("colgroup"),data:o("data"),datalist:o("datalist"),dd:o("dd"),del:o("del"),details:o("details"),dfn:o("dfn"),dialog:o("dialog"),div:o("div"),dl:o("dl"),dt:o("dt"),em:o("em"),embed:o("embed"),fieldset:o("fieldset"),figcaption:o("figcaption"),figure:o("figure"),footer:o("footer"),form:o("form"),h1:o("h1"),h2:o("h2"),h3:o("h3"),h4:o("h4"),h5:o("h5"),h6:o("h6"),head:o("head"),header:o("header"),hgroup:o("hgroup"),hr:o("hr"),html:o("html"),i:o("i"),iframe:o("iframe"),img:o("img"),input:o("input"),ins:o("ins"),kbd:o("kbd"),keygen:o("keygen"),label:o("label"),legend:o("legend"),li:o("li"),link:o("link"),main:o("main"),map:o("map"),mark:o("mark"),menu:o("menu"),menuitem:o("menuitem"),meta:o("meta"),meter:o("meter"),nav:o("nav"),noscript:o("noscript"),object:o("object"),ol:o("ol"),optgroup:o("optgroup"),option:o("option"),output:o("output"),p:o("p"),param:o("param"),picture:o("picture"),pre:o("pre"),progress:o("progress"),q:o("q"),rp:o("rp"),rt:o("rt"),ruby:o("ruby"),s:o("s"),samp:o("samp"),script:o("script"),section:o("section"),select:o("select"),small:o("small"),source:o("source"),span:o("span"),strong:o("strong"),style:o("style"),sub:o("sub"),summary:o("summary"),sup:o("sup"),table:o("table"),tbody:o("tbody"),td:o("td"),textarea:o("textarea"),tfoot:o("tfoot"),th:o("th"),thead:o("thead"),time:o("time"),title:o("title"),tr:o("tr"),track:o("track"),u:o("u"),ul:o("ul"),var:o("var"),video:o("video"),wbr:o("wbr"),circle:o("circle"),clipPath:o("clipPath"),defs:o("defs"),ellipse:o("ellipse"),g:o("g"),image:o("image"),line:o("line"),linearGradient:o("linearGradient"),mask:o("mask"),path:o("path"),pattern:o("pattern"),polygon:o("polygon"),polyline:o("polyline"),radialGradient:o("radialGradient"),rect:o("rect"),stop:o("stop"),svg:o("svg"),text:o("text"),tspan:o("tspan")};e.exports=i},function(e,t,n){"use strict";var r={};e.exports=r},function(e,t,n){"use strict";var r=n(21),o=r.isValidElement,i=n(62);e.exports=i(o)},function(e,t,n){"use strict";function r(e,t,n){this.props=e,this.context=t,this.refs=u,this.updater=n||s}function o(){}var i=n(4),a=n(54),s=n(55),u=n(23);o.prototype=a.prototype,r.prototype=new o,r.prototype.constructor=r,i(r.prototype,a.prototype),r.prototype.isPureReactComponent=!0,e.exports=r},164,183,function(e,t){"use strict";function n(){return r++}var r=1;e.exports=n},function(e,t,n){"use strict";function r(e){return i.isValidElement(e)?void 0:o("143"),e}var o=n(22),i=n(21);n(1);e.exports=r},function(e,t,n){"use strict";function r(e,t){return e&&"object"==typeof e&&null!=e.key?l.escape(e.key):t.toString(36)}function o(e,t,n,i){var f=typeof e;if("undefined"!==f&&"boolean"!==f||(e=null),null===e||"string"===f||"number"===f||"object"===f&&e.$$typeof===s)return n(i,e,""===t?c+r(e,0):t),1;var d,h,m=0,v=""===t?c:t+p;if(Array.isArray(e))for(var g=0;g<e.length;g++)d=e[g],h=v+r(d,g),m+=o(d,h,n,i);else{var y=u(e);if(y){var b,C=y.call(e);if(y!==e.entries)for(var _=0;!(b=C.next()).done;)d=b.value,h=v+r(d,_++),m+=o(d,h,n,i);else for(;!(b=C.next()).done;){var w=b.value;w&&(d=w[1],h=v+l.escape(w[0])+p+r(d,0),m+=o(d,h,n,i))}}else if("object"===f){var E="",T=String(e);a("31","[object Object]"===T?"object with keys {"+Object.keys(e).join(", ")+"}":T,E)}}return m}function i(e,t,n){return null==e?0:o(e,"",t,n)}var a=n(22),s=(n(12),n(88)),u=n(220),l=(n(1),n(211)),c=(n(2),"."),p=":";e.exports=i},function(e,t,n){var r,o,i;!function(n,a){o=[],r=a,i="function"==typeof r?r.apply(t,o):r,!(void 0!==i&&(e.exports=i))}(this,function(){"use strict";function e(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function t(e){var n=e.getBoundingClientRect(),r={};for(var o in n)r[o]=n[o];try{if(e.ownerDocument!==document){var i=e.ownerDocument.defaultView.frameElement;if(i){var a=t(i);r.top+=a.top,r.bottom+=a.top,r.left+=a.left,r.right+=a.left}}}catch(e){}return r}function n(e){var t=getComputedStyle(e)||{},n=t.position,r=[];if("fixed"===n)return[e];for(var o=e;(o=o.parentNode)&&o&&1===o.nodeType;){var i=void 0;try{i=getComputedStyle(o)}catch(e){}if("undefined"==typeof i||null===i)return r.push(o),r;var a=i,s=a.overflow,u=a.overflowX,l=a.overflowY;/(auto|scroll|overlay)/.test(s+l+u)&&("absolute"!==n||["relative","absolute","fixed"].indexOf(i.position)>=0)&&r.push(o)}return r.push(e.ownerDocument.body),e.ownerDocument!==document&&r.push(e.ownerDocument.defaultView),r}function r(){w&&document.body.removeChild(w),w=null}function o(e){var n=void 0;e===document?(n=document,e=document.documentElement):n=e.ownerDocument;var r=n.documentElement,o=t(e),i=x();return o.top-=i.top,o.left-=i.left,"undefined"==typeof o.width&&(o.width=document.body.scrollWidth-o.left-o.right),"undefined"==typeof o.height&&(o.height=document.body.scrollHeight-o.top-o.bottom),o.top=o.top-r.clientTop,
+o.left=o.left-r.clientLeft,o.right=n.body.clientWidth-o.width-o.left,o.bottom=n.body.clientHeight-o.height-o.top,o}function i(e){return e.offsetParent||document.documentElement}function a(){if(O)return O;var e=document.createElement("div");e.style.width="100%",e.style.height="200px";var t=document.createElement("div");s(t.style,{position:"absolute",top:0,left:0,pointerEvents:"none",visibility:"hidden",width:"200px",height:"150px",overflow:"hidden"}),t.appendChild(e),document.body.appendChild(t);var n=e.offsetWidth;t.style.overflow="scroll";var r=e.offsetWidth;n===r&&(r=t.clientWidth),document.body.removeChild(t);var o=n-r;return O={width:o,height:o}}function s(){var e=arguments.length<=0||void 0===arguments[0]?{}:arguments[0],t=[];return Array.prototype.push.apply(t,arguments),t.slice(1).forEach(function(t){if(t)for(var n in t)({}).hasOwnProperty.call(t,n)&&(e[n]=t[n])}),e}function u(e,t){if("undefined"!=typeof e.classList)t.split(" ").forEach(function(t){t.trim()&&e.classList.remove(t)});else{var n=new RegExp("(^| )"+t.split(" ").join("|")+"( |$)","gi"),r=p(e).replace(n," ");f(e,r)}}function l(e,t){if("undefined"!=typeof e.classList)t.split(" ").forEach(function(t){t.trim()&&e.classList.add(t)});else{u(e,t);var n=p(e)+(" "+t);f(e,n)}}function c(e,t){if("undefined"!=typeof e.classList)return e.classList.contains(t);var n=p(e);return new RegExp("(^| )"+t+"( |$)","gi").test(n)}function p(e){return e.className instanceof e.ownerDocument.defaultView.SVGAnimatedString?e.className.baseVal:e.className}function f(e,t){e.setAttribute("class",t)}function d(e,t,n){n.forEach(function(n){t.indexOf(n)===-1&&c(e,n)&&u(e,n)}),t.forEach(function(t){c(e,t)||l(e,t)})}function e(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function h(e,t){if("function"!=typeof t&&null!==t)throw new TypeError("Super expression must either be null or a function, not "+typeof t);e.prototype=Object.create(t&&t.prototype,{constructor:{value:e,enumerable:!1,writable:!0,configurable:!0}}),t&&(Object.setPrototypeOf?Object.setPrototypeOf(e,t):e.__proto__=t)}function m(e,t){var n=arguments.length<=2||void 0===arguments[2]?1:arguments[2];return e+n>=t&&t>=e-n}function v(){return"object"==typeof performance&&"function"==typeof performance.now?performance.now():+new Date}function g(){for(var e={top:0,left:0},t=arguments.length,n=Array(t),r=0;r<t;r++)n[r]=arguments[r];return n.forEach(function(t){var n=t.top,r=t.left;"string"==typeof n&&(n=parseFloat(n,10)),"string"==typeof r&&(r=parseFloat(r,10)),e.top+=n,e.left+=r}),e}function y(e,t){return"string"==typeof e.left&&e.left.indexOf("%")!==-1&&(e.left=parseFloat(e.left,10)/100*t.width),"string"==typeof e.top&&e.top.indexOf("%")!==-1&&(e.top=parseFloat(e.top,10)/100*t.height),e}function b(e,t){return"scrollParent"===t?t=e.scrollParents[0]:"window"===t&&(t=[pageXOffset,pageYOffset,innerWidth+pageXOffset,innerHeight+pageYOffset]),t===document&&(t=t.documentElement),"undefined"!=typeof t.nodeType&&!function(){var e=t,n=o(t),r=n,i=getComputedStyle(t);if(t=[r.left,r.top,n.width+r.left,n.height+r.top],e.ownerDocument!==document){var a=e.ownerDocument.defaultView;t[0]+=a.pageXOffset,t[1]+=a.pageYOffset,t[2]+=a.pageXOffset,t[3]+=a.pageYOffset}K.forEach(function(e,n){e=e[0].toUpperCase()+e.substr(1),"Top"===e||"Left"===e?t[n]+=parseFloat(i["border"+e+"Width"]):t[n]-=parseFloat(i["border"+e+"Width"])})}(),t}var C=function(){function e(e,t){for(var n=0;n<t.length;n++){var r=t[n];r.enumerable=r.enumerable||!1,r.configurable=!0,"value"in r&&(r.writable=!0),Object.defineProperty(e,r.key,r)}}return function(t,n,r){return n&&e(t.prototype,n),r&&e(t,r),t}}(),_=void 0;"undefined"==typeof _&&(_={modules:[]});var w=null,E=function(){var e=0;return function(){return++e}}(),T={},x=function(){var e=w;e&&document.body.contains(e)||(e=document.createElement("div"),e.setAttribute("data-tether-id",E()),s(e.style,{top:0,left:0,position:"absolute"}),document.body.appendChild(e),w=e);var n=e.getAttribute("data-tether-id");return"undefined"==typeof T[n]&&(T[n]=t(e),k(function(){delete T[n]})),T[n]},O=null,P=[],k=function(e){P.push(e)},S=function(){for(var e=void 0;e=P.pop();)e()},N=function(){function t(){e(this,t)}return C(t,[{key:"on",value:function(e,t,n){var r=!(arguments.length<=3||void 0===arguments[3])&&arguments[3];"undefined"==typeof this.bindings&&(this.bindings={}),"undefined"==typeof this.bindings[e]&&(this.bindings[e]=[]),this.bindings[e].push({handler:t,ctx:n,once:r})}},{key:"once",value:function(e,t,n){this.on(e,t,n,!0)}},{key:"off",value:function(e,t){if("undefined"!=typeof this.bindings&&"undefined"!=typeof this.bindings[e])if("undefined"==typeof t)delete this.bindings[e];else for(var n=0;n<this.bindings[e].length;)this.bindings[e][n].handler===t?this.bindings[e].splice(n,1):++n}},{key:"trigger",value:function(e){if("undefined"!=typeof this.bindings&&this.bindings[e]){for(var t=0,n=arguments.length,r=Array(n>1?n-1:0),o=1;o<n;o++)r[o-1]=arguments[o];for(;t<this.bindings[e].length;){var i=this.bindings[e][t],a=i.handler,s=i.ctx,u=i.once,l=s;"undefined"==typeof l&&(l=this),a.apply(l,r),u?this.bindings[e].splice(t,1):++t}}}}]),t}();_.Utils={getActualBoundingClientRect:t,getScrollParents:n,getBounds:o,getOffsetParent:i,extend:s,addClass:l,removeClass:u,hasClass:c,updateClasses:d,defer:k,flush:S,uniqueId:E,Evented:N,getScrollBarSize:a,removeUtilElements:r};var M=function(){function e(e,t){var n=[],r=!0,o=!1,i=void 0;try{for(var a,s=e[Symbol.iterator]();!(r=(a=s.next()).done)&&(n.push(a.value),!t||n.length!==t);r=!0);}catch(e){o=!0,i=e}finally{try{!r&&s.return&&s.return()}finally{if(o)throw i}}return n}return function(t,n){if(Array.isArray(t))return t;if(Symbol.iterator in Object(t))return e(t,n);throw new TypeError("Invalid attempt to destructure non-iterable instance")}}(),C=function(){function e(e,t){for(var n=0;n<t.length;n++){var r=t[n];r.enumerable=r.enumerable||!1,r.configurable=!0,"value"in r&&(r.writable=!0),Object.defineProperty(e,r.key,r)}}return function(t,n,r){return n&&e(t.prototype,n),r&&e(t,r),t}}(),A=function(e,t,n){for(var r=!0;r;){var o=e,i=t,a=n;r=!1,null===o&&(o=Function.prototype);var s=Object.getOwnPropertyDescriptor(o,i);if(void 0!==s){if("value"in s)return s.value;var u=s.get;if(void 0===u)return;return u.call(a)}var l=Object.getPrototypeOf(o);if(null===l)return;e=l,t=i,n=a,r=!0,s=l=void 0}};if("undefined"==typeof _)throw new Error("You must include the utils.js file before tether.js");var I=_.Utils,n=I.getScrollParents,o=I.getBounds,i=I.getOffsetParent,s=I.extend,l=I.addClass,u=I.removeClass,d=I.updateClasses,k=I.defer,S=I.flush,a=I.getScrollBarSize,r=I.removeUtilElements,D=function(){if("undefined"==typeof document)return"";for(var e=document.createElement("div"),t=["transform","WebkitTransform","OTransform","MozTransform","msTransform"],n=0;n<t.length;++n){var r=t[n];if(void 0!==e.style[r])return r}}(),R=[],L=function(){R.forEach(function(e){e.position(!1)}),S()};!function(){var e=null,t=null,n=null,r=function r(){return"undefined"!=typeof t&&t>16?(t=Math.min(t-16,250),void(n=setTimeout(r,250))):void("undefined"!=typeof e&&v()-e<10||(null!=n&&(clearTimeout(n),n=null),e=v(),L(),t=v()-e))};"undefined"!=typeof window&&"undefined"!=typeof window.addEventListener&&["resize","scroll","touchmove"].forEach(function(e){window.addEventListener(e,r)})}();var U={center:"center",left:"right",right:"left"},F={middle:"middle",top:"bottom",bottom:"top"},j={top:0,left:0,middle:"50%",center:"50%",bottom:"100%",right:"100%"},B=function(e,t){var n=e.left,r=e.top;return"auto"===n&&(n=U[t.left]),"auto"===r&&(r=F[t.top]),{left:n,top:r}},V=function(e){var t=e.left,n=e.top;return"undefined"!=typeof j[e.left]&&(t=j[e.left]),"undefined"!=typeof j[e.top]&&(n=j[e.top]),{left:t,top:n}},W=function(e){var t=e.split(" "),n=M(t,2),r=n[0],o=n[1];return{top:r,left:o}},H=W,q=function(t){function c(t){var n=this;e(this,c),A(Object.getPrototypeOf(c.prototype),"constructor",this).call(this),this.position=this.position.bind(this),R.push(this),this.history=[],this.setOptions(t,!1),_.modules.forEach(function(e){"undefined"!=typeof e.initialize&&e.initialize.call(n)}),this.position()}return h(c,t),C(c,[{key:"getClass",value:function(){var e=arguments.length<=0||void 0===arguments[0]?"":arguments[0],t=this.options.classes;return"undefined"!=typeof t&&t[e]?this.options.classes[e]:this.options.classPrefix?this.options.classPrefix+"-"+e:e}},{key:"setOptions",value:function(e){var t=this,r=arguments.length<=1||void 0===arguments[1]||arguments[1],o={offset:"0 0",targetOffset:"0 0",targetAttachment:"auto auto",classPrefix:"tether"};this.options=s(o,e);var i=this.options,a=i.element,u=i.target,c=i.targetModifier;if(this.element=a,this.target=u,this.targetModifier=c,"viewport"===this.target?(this.target=document.body,this.targetModifier="visible"):"scroll-handle"===this.target&&(this.target=document.body,this.targetModifier="scroll-handle"),["element","target"].forEach(function(e){if("undefined"==typeof t[e])throw new Error("Tether Error: Both element and target must be defined");"undefined"!=typeof t[e].jquery?t[e]=t[e][0]:"string"==typeof t[e]&&(t[e]=document.querySelector(t[e]))}),l(this.element,this.getClass("element")),this.options.addTargetClasses!==!1&&l(this.target,this.getClass("target")),!this.options.attachment)throw new Error("Tether Error: You must provide an attachment");this.targetAttachment=H(this.options.targetAttachment),this.attachment=H(this.options.attachment),this.offset=W(this.options.offset),this.targetOffset=W(this.options.targetOffset),"undefined"!=typeof this.scrollParents&&this.disable(),"scroll-handle"===this.targetModifier?this.scrollParents=[this.target]:this.scrollParents=n(this.target),this.options.enabled!==!1&&this.enable(r)}},{key:"getTargetBounds",value:function(){if("undefined"==typeof this.targetModifier)return o(this.target);if("visible"===this.targetModifier){if(this.target===document.body)return{top:pageYOffset,left:pageXOffset,height:innerHeight,width:innerWidth};var e=o(this.target),t={height:e.height,width:e.width,top:e.top,left:e.left};return t.height=Math.min(t.height,e.height-(pageYOffset-e.top)),t.height=Math.min(t.height,e.height-(e.top+e.height-(pageYOffset+innerHeight))),t.height=Math.min(innerHeight,t.height),t.height-=2,t.width=Math.min(t.width,e.width-(pageXOffset-e.left)),t.width=Math.min(t.width,e.width-(e.left+e.width-(pageXOffset+innerWidth))),t.width=Math.min(innerWidth,t.width),t.width-=2,t.top<pageYOffset&&(t.top=pageYOffset),t.left<pageXOffset&&(t.left=pageXOffset),t}if("scroll-handle"===this.targetModifier){var e=void 0,n=this.target;n===document.body?(n=document.documentElement,e={left:pageXOffset,top:pageYOffset,height:innerHeight,width:innerWidth}):e=o(n);var r=getComputedStyle(n),i=n.scrollWidth>n.clientWidth||[r.overflow,r.overflowX].indexOf("scroll")>=0||this.target!==document.body,a=0;i&&(a=15);var s=e.height-parseFloat(r.borderTopWidth)-parseFloat(r.borderBottomWidth)-a,t={width:15,height:.975*s*(s/n.scrollHeight),left:e.left+e.width-parseFloat(r.borderLeftWidth)-15},u=0;s<408&&this.target===document.body&&(u=-11e-5*Math.pow(s,2)-.00727*s+22.58),this.target!==document.body&&(t.height=Math.max(t.height,24));var l=this.target.scrollTop/(n.scrollHeight-s);return t.top=l*(s-t.height-u)+e.top+parseFloat(r.borderTopWidth),this.target===document.body&&(t.height=Math.max(t.height,24)),t}}},{key:"clearCache",value:function(){this._cache={}}},{key:"cache",value:function(e,t){return"undefined"==typeof this._cache&&(this._cache={}),"undefined"==typeof this._cache[e]&&(this._cache[e]=t.call(this)),this._cache[e]}},{key:"enable",value:function(){var e=this,t=arguments.length<=0||void 0===arguments[0]||arguments[0];this.options.addTargetClasses!==!1&&l(this.target,this.getClass("enabled")),l(this.element,this.getClass("enabled")),this.enabled=!0,this.scrollParents.forEach(function(t){t!==e.target.ownerDocument&&t.addEventListener("scroll",e.position)}),t&&this.position()}},{key:"disable",value:function(){var e=this;u(this.target,this.getClass("enabled")),u(this.element,this.getClass("enabled")),this.enabled=!1,"undefined"!=typeof this.scrollParents&&this.scrollParents.forEach(function(t){t.removeEventListener("scroll",e.position)})}},{key:"destroy",value:function(){var e=this;this.disable(),R.forEach(function(t,n){t===e&&R.splice(n,1)}),0===R.length&&r()}},{key:"updateAttachClasses",value:function(e,t){var n=this;e=e||this.attachment,t=t||this.targetAttachment;var r=["left","top","bottom","right","middle","center"];"undefined"!=typeof this._addAttachClasses&&this._addAttachClasses.length&&this._addAttachClasses.splice(0,this._addAttachClasses.length),"undefined"==typeof this._addAttachClasses&&(this._addAttachClasses=[]);var o=this._addAttachClasses;e.top&&o.push(this.getClass("element-attached")+"-"+e.top),e.left&&o.push(this.getClass("element-attached")+"-"+e.left),t.top&&o.push(this.getClass("target-attached")+"-"+t.top),t.left&&o.push(this.getClass("target-attached")+"-"+t.left);var i=[];r.forEach(function(e){i.push(n.getClass("element-attached")+"-"+e),i.push(n.getClass("target-attached")+"-"+e)}),k(function(){"undefined"!=typeof n._addAttachClasses&&(d(n.element,n._addAttachClasses,i),n.options.addTargetClasses!==!1&&d(n.target,n._addAttachClasses,i),delete n._addAttachClasses)})}},{key:"position",value:function(){var e=this,t=arguments.length<=0||void 0===arguments[0]||arguments[0];if(this.enabled){this.clearCache();var n=B(this.targetAttachment,this.attachment);this.updateAttachClasses(this.attachment,n);var r=this.cache("element-bounds",function(){return o(e.element)}),s=r.width,u=r.height;if(0===s&&0===u&&"undefined"!=typeof this.lastSize){var l=this.lastSize;s=l.width,u=l.height}else this.lastSize={width:s,height:u};var c=this.cache("target-bounds",function(){return e.getTargetBounds()}),p=c,f=y(V(this.attachment),{width:s,height:u}),d=y(V(n),p),h=y(this.offset,{width:s,height:u}),m=y(this.targetOffset,p);f=g(f,h),d=g(d,m);for(var v=c.left+d.left-f.left,b=c.top+d.top-f.top,C=0;C<_.modules.length;++C){var w=_.modules[C],E=w.position.call(this,{left:v,top:b,targetAttachment:n,targetPos:c,elementPos:r,offset:f,targetOffset:d,manualOffset:h,manualTargetOffset:m,scrollbarSize:P,attachment:this.attachment});if(E===!1)return!1;"undefined"!=typeof E&&"object"==typeof E&&(b=E.top,v=E.left)}var T={page:{top:b,left:v},viewport:{top:b-pageYOffset,bottom:pageYOffset-b-u+innerHeight,left:v-pageXOffset,right:pageXOffset-v-s+innerWidth}},x=this.target.ownerDocument,O=x.defaultView,P=void 0;return O.innerHeight>x.documentElement.clientHeight&&(P=this.cache("scrollbar-size",a),T.viewport.bottom-=P.height),O.innerWidth>x.documentElement.clientWidth&&(P=this.cache("scrollbar-size",a),T.viewport.right-=P.width),["","static"].indexOf(x.body.style.position)!==-1&&["","static"].indexOf(x.body.parentElement.style.position)!==-1||(T.page.bottom=x.body.scrollHeight-b-u,T.page.right=x.body.scrollWidth-v-s),"undefined"!=typeof this.options.optimizations&&this.options.optimizations.moveElement!==!1&&"undefined"==typeof this.targetModifier&&!function(){var t=e.cache("target-offsetparent",function(){return i(e.target)}),n=e.cache("target-offsetparent-bounds",function(){return o(t)}),r=getComputedStyle(t),a=n,s={};if(["Top","Left","Bottom","Right"].forEach(function(e){s[e.toLowerCase()]=parseFloat(r["border"+e+"Width"])}),n.right=x.body.scrollWidth-n.left-a.width+s.right,n.bottom=x.body.scrollHeight-n.top-a.height+s.bottom,T.page.top>=n.top+s.top&&T.page.bottom>=n.bottom&&T.page.left>=n.left+s.left&&T.page.right>=n.right){var u=t.scrollTop,l=t.scrollLeft;T.offset={top:T.page.top-n.top+u-s.top,left:T.page.left-n.left+l-s.left}}}(),this.move(T),this.history.unshift(T),this.history.length>3&&this.history.pop(),t&&S(),!0}}},{key:"move",value:function(e){var t=this;if("undefined"!=typeof this.element.parentNode){var n={};for(var r in e){n[r]={};for(var o in e[r]){for(var a=!1,u=0;u<this.history.length;++u){var l=this.history[u];if("undefined"!=typeof l[r]&&!m(l[r][o],e[r][o])){a=!0;break}}a||(n[r][o]=!0)}}var c={top:"",left:"",right:"",bottom:""},p=function(e,n){var r="undefined"!=typeof t.options.optimizations,o=r?t.options.optimizations.gpu:null;if(o!==!1){var i=void 0,a=void 0;e.top?(c.top=0,i=n.top):(c.bottom=0,i=-n.bottom),e.left?(c.left=0,a=n.left):(c.right=0,a=-n.right),"number"==typeof window.devicePixelRatio&&devicePixelRatio%1===0&&(a=Math.round(a*devicePixelRatio)/devicePixelRatio,i=Math.round(i*devicePixelRatio)/devicePixelRatio),c[D]="translateX("+a+"px) translateY("+i+"px)","msTransform"!==D&&(c[D]+=" translateZ(0)")}else e.top?c.top=n.top+"px":c.bottom=n.bottom+"px",e.left?c.left=n.left+"px":c.right=n.right+"px"},f=!1;if((n.page.top||n.page.bottom)&&(n.page.left||n.page.right)?(c.position="absolute",p(n.page,e.page)):(n.viewport.top||n.viewport.bottom)&&(n.viewport.left||n.viewport.right)?(c.position="fixed",p(n.viewport,e.viewport)):"undefined"!=typeof n.offset&&n.offset.top&&n.offset.left?!function(){c.position="absolute";var r=t.cache("target-offsetparent",function(){return i(t.target)});i(t.element)!==r&&k(function(){t.element.parentNode.removeChild(t.element),r.appendChild(t.element)}),p(n.offset,e.offset),f=!0}():(c.position="absolute",p({top:!0,left:!0},e.page)),!f)if(this.options.bodyElement)this.element.parentNode!==this.options.bodyElement&&this.options.bodyElement.appendChild(this.element);else{for(var d=function(e){var t=e.ownerDocument,n=t.fullscreenElement||t.webkitFullscreenElement||t.mozFullScreenElement||t.msFullscreenElement;return n===e},h=!0,v=this.element.parentNode;v&&1===v.nodeType&&"BODY"!==v.tagName&&!d(v);){if("static"!==getComputedStyle(v).position){h=!1;break}v=v.parentNode}h||(this.element.parentNode.removeChild(this.element),this.element.ownerDocument.body.appendChild(this.element))}var g={},y=!1;for(var o in c){var b=c[o],C=this.element.style[o];C!==b&&(y=!0,g[o]=b)}y&&k(function(){s(t.element.style,g),t.trigger("repositioned")})}}}]),c}(N);q.modules=[],_.position=L;var z=s(q,_),M=function(){function e(e,t){var n=[],r=!0,o=!1,i=void 0;try{for(var a,s=e[Symbol.iterator]();!(r=(a=s.next()).done)&&(n.push(a.value),!t||n.length!==t);r=!0);}catch(e){o=!0,i=e}finally{try{!r&&s.return&&s.return()}finally{if(o)throw i}}return n}return function(t,n){if(Array.isArray(t))return t;if(Symbol.iterator in Object(t))return e(t,n);throw new TypeError("Invalid attempt to destructure non-iterable instance")}}(),I=_.Utils,o=I.getBounds,s=I.extend,d=I.updateClasses,k=I.defer,K=["left","top","right","bottom"];_.modules.push({position:function(e){var t=this,n=e.top,r=e.left,i=e.targetAttachment;if(!this.options.constraints)return!0;var a=this.cache("element-bounds",function(){return o(t.element)}),u=a.height,l=a.width;if(0===l&&0===u&&"undefined"!=typeof this.lastSize){var c=this.lastSize;l=c.width,u=c.height}var p=this.cache("target-bounds",function(){return t.getTargetBounds()}),f=p.height,h=p.width,m=[this.getClass("pinned"),this.getClass("out-of-bounds")];this.options.constraints.forEach(function(e){var t=e.outOfBoundsClass,n=e.pinnedClass;t&&m.push(t),n&&m.push(n)}),m.forEach(function(e){["left","top","right","bottom"].forEach(function(t){m.push(e+"-"+t)})});var v=[],g=s({},i),y=s({},this.attachment);return this.options.constraints.forEach(function(e){var o=e.to,a=e.attachment,s=e.pin;"undefined"==typeof a&&(a="");var c=void 0,p=void 0;if(a.indexOf(" ")>=0){var d=a.split(" "),m=M(d,2);p=m[0],c=m[1]}else c=p=a;var C=b(t,o);"target"!==p&&"both"!==p||(n<C[1]&&"top"===g.top&&(n+=f,g.top="bottom"),n+u>C[3]&&"bottom"===g.top&&(n-=f,g.top="top")),"together"===p&&("top"===g.top&&("bottom"===y.top&&n<C[1]?(n+=f,g.top="bottom",n+=u,y.top="top"):"top"===y.top&&n+u>C[3]&&n-(u-f)>=C[1]&&(n-=u-f,g.top="bottom",y.top="bottom")),"bottom"===g.top&&("top"===y.top&&n+u>C[3]?(n-=f,g.top="top",n-=u,y.top="bottom"):"bottom"===y.top&&n<C[1]&&n+(2*u-f)<=C[3]&&(n+=u-f,g.top="top",y.top="top")),"middle"===g.top&&(n+u>C[3]&&"top"===y.top?(n-=u,y.top="bottom"):n<C[1]&&"bottom"===y.top&&(n+=u,y.top="top"))),"target"!==c&&"both"!==c||(r<C[0]&&"left"===g.left&&(r+=h,g.left="right"),r+l>C[2]&&"right"===g.left&&(r-=h,g.left="left")),"together"===c&&(r<C[0]&&"left"===g.left?"right"===y.left?(r+=h,g.left="right",r+=l,y.left="left"):"left"===y.left&&(r+=h,g.left="right",r-=l,y.left="right"):r+l>C[2]&&"right"===g.left?"left"===y.left?(r-=h,g.left="left",r-=l,y.left="right"):"right"===y.left&&(r-=h,g.left="left",r+=l,y.left="left"):"center"===g.left&&(r+l>C[2]&&"left"===y.left?(r-=l,y.left="right"):r<C[0]&&"right"===y.left&&(r+=l,y.left="left"))),"element"!==p&&"both"!==p||(n<C[1]&&"bottom"===y.top&&(n+=u,y.top="top"),n+u>C[3]&&"top"===y.top&&(n-=u,y.top="bottom")),"element"!==c&&"both"!==c||(r<C[0]&&("right"===y.left?(r+=l,y.left="left"):"center"===y.left&&(r+=l/2,y.left="left")),r+l>C[2]&&("left"===y.left?(r-=l,y.left="right"):"center"===y.left&&(r-=l/2,y.left="right"))),"string"==typeof s?s=s.split(",").map(function(e){return e.trim()}):s===!0&&(s=["top","left","right","bottom"]),s=s||[];var _=[],w=[];n<C[1]&&(s.indexOf("top")>=0?(n=C[1],_.push("top")):w.push("top")),n+u>C[3]&&(s.indexOf("bottom")>=0?(n=C[3]-u,_.push("bottom")):w.push("bottom")),r<C[0]&&(s.indexOf("left")>=0?(r=C[0],_.push("left")):w.push("left")),r+l>C[2]&&(s.indexOf("right")>=0?(r=C[2]-l,_.push("right")):w.push("right")),_.length&&!function(){var e=void 0;e="undefined"!=typeof t.options.pinnedClass?t.options.pinnedClass:t.getClass("pinned"),v.push(e),_.forEach(function(t){v.push(e+"-"+t)})}(),w.length&&!function(){var e=void 0;e="undefined"!=typeof t.options.outOfBoundsClass?t.options.outOfBoundsClass:t.getClass("out-of-bounds"),v.push(e),w.forEach(function(t){v.push(e+"-"+t)})}(),(_.indexOf("left")>=0||_.indexOf("right")>=0)&&(y.left=g.left=!1),(_.indexOf("top")>=0||_.indexOf("bottom")>=0)&&(y.top=g.top=!1),g.top===i.top&&g.left===i.left&&y.top===t.attachment.top&&y.left===t.attachment.left||(t.updateAttachClasses(y,g),t.trigger("update",{attachment:y,targetAttachment:g}))}),k(function(){t.options.addTargetClasses!==!1&&d(t.target,v,m),d(t.element,v,m)}),{top:n,left:r}}});var I=_.Utils,o=I.getBounds,d=I.updateClasses,k=I.defer;_.modules.push({position:function(e){var t=this,n=e.top,r=e.left,i=this.cache("element-bounds",function(){return o(t.element)}),a=i.height,s=i.width,u=this.getTargetBounds(),l=n+a,c=r+s,p=[];n<=u.bottom&&l>=u.top&&["left","right"].forEach(function(e){var t=u[e];t!==r&&t!==c||p.push(e)}),r<=u.right&&c>=u.left&&["top","bottom"].forEach(function(e){var t=u[e];t!==n&&t!==l||p.push(e)});var f=[],h=[],m=["left","top","right","bottom"];return f.push(this.getClass("abutted")),m.forEach(function(e){f.push(t.getClass("abutted")+"-"+e)}),p.length&&h.push(this.getClass("abutted")),p.forEach(function(e){h.push(t.getClass("abutted")+"-"+e)}),k(function(){t.options.addTargetClasses!==!1&&d(t.target,h,f),d(t.element,h,f)}),!0}});var M=function(){function e(e,t){var n=[],r=!0,o=!1,i=void 0;try{for(var a,s=e[Symbol.iterator]();!(r=(a=s.next()).done)&&(n.push(a.value),!t||n.length!==t);r=!0);}catch(e){o=!0,i=e}finally{try{!r&&s.return&&s.return()}finally{if(o)throw i}}return n}return function(t,n){if(Array.isArray(t))return t;if(Symbol.iterator in Object(t))return e(t,n);throw new TypeError("Invalid attempt to destructure non-iterable instance")}}();return _.modules.push({position:function(e){var t=e.top,n=e.left;if(this.options.shift){var r=this.options.shift;"function"==typeof this.options.shift&&(r=this.options.shift.call(this,{top:t,left:n}));var o=void 0,i=void 0;if("string"==typeof r){r=r.split(" "),r[1]=r[1]||r[0];var a=r,s=M(a,2);o=s[0],i=s[1],o=parseFloat(o,10),i=parseFloat(i,10)}else o=r.top,i=r.left;return t+=o,n+=i,{top:t,left:n}}}}),z})},function(e,t,n){"use strict";var r=function(){};e.exports=r},function(e,t){!function(e){"use strict";function t(e){if("string"!=typeof e&&(e=String(e)),/[^a-z0-9\-#$%&'*+.\^_`|~]/i.test(e))throw new TypeError("Invalid character in header field name");return e.toLowerCase()}function n(e){return"string"!=typeof e&&(e=String(e)),e}function r(e){var t={next:function(){var t=e.shift();return{done:void 0===t,value:t}}};return g.iterable&&(t[Symbol.iterator]=function(){return t}),t}function o(e){this.map={},e instanceof o?e.forEach(function(e,t){this.append(t,e)},this):e&&Object.getOwnPropertyNames(e).forEach(function(t){this.append(t,e[t])},this)}function i(e){return e.bodyUsed?Promise.reject(new TypeError("Already read")):void(e.bodyUsed=!0)}function a(e){return new Promise(function(t,n){e.onload=function(){t(e.result)},e.onerror=function(){n(e.error)}})}function s(e){var t=new FileReader,n=a(t);return t.readAsArrayBuffer(e),n}function u(e){var t=new FileReader,n=a(t);return t.readAsText(e),n}function l(e){for(var t=new Uint8Array(e),n=new Array(t.length),r=0;r<t.length;r++)n[r]=String.fromCharCode(t[r]);return n.join("")}function c(e){if(e.slice)return e.slice(0);var t=new Uint8Array(e.byteLength);return t.set(new Uint8Array(e)),t.buffer}function p(){return this.bodyUsed=!1,this._initBody=function(e){if(this._bodyInit=e,e)if("string"==typeof e)this._bodyText=e;else if(g.blob&&Blob.prototype.isPrototypeOf(e))this._bodyBlob=e;else if(g.formData&&FormData.prototype.isPrototypeOf(e))this._bodyFormData=e;else if(g.searchParams&&URLSearchParams.prototype.isPrototypeOf(e))this._bodyText=e.toString();else if(g.arrayBuffer&&g.blob&&b(e))this._bodyArrayBuffer=c(e.buffer),this._bodyInit=new Blob([this._bodyArrayBuffer]);else{if(!g.arrayBuffer||!ArrayBuffer.prototype.isPrototypeOf(e)&&!C(e))throw new Error("unsupported BodyInit type");this._bodyArrayBuffer=c(e)}else this._bodyText="";this.headers.get("content-type")||("string"==typeof e?this.headers.set("content-type","text/plain;charset=UTF-8"):this._bodyBlob&&this._bodyBlob.type?this.headers.set("content-type",this._bodyBlob.type):g.searchParams&&URLSearchParams.prototype.isPrototypeOf(e)&&this.headers.set("content-type","application/x-www-form-urlencoded;charset=UTF-8"))},g.blob&&(this.blob=function(){var e=i(this);if(e)return e;if(this._bodyBlob)return Promise.resolve(this._bodyBlob);if(this._bodyArrayBuffer)return Promise.resolve(new Blob([this._bodyArrayBuffer]));if(this._bodyFormData)throw new Error("could not read FormData body as blob");return Promise.resolve(new Blob([this._bodyText]))},this.arrayBuffer=function(){return this._bodyArrayBuffer?i(this)||Promise.resolve(this._bodyArrayBuffer):this.blob().then(s)}),this.text=function(){var e=i(this);if(e)return e;if(this._bodyBlob)return u(this._bodyBlob);if(this._bodyArrayBuffer)return Promise.resolve(l(this._bodyArrayBuffer));if(this._bodyFormData)throw new Error("could not read FormData body as text");return Promise.resolve(this._bodyText)},g.formData&&(this.formData=function(){return this.text().then(h)}),this.json=function(){return this.text().then(JSON.parse)},this}function f(e){var t=e.toUpperCase();return _.indexOf(t)>-1?t:e}function d(e,t){t=t||{};var n=t.body;if(e instanceof d){if(e.bodyUsed)throw new TypeError("Already read");this.url=e.url,this.credentials=e.credentials,t.headers||(this.headers=new o(e.headers)),this.method=e.method,this.mode=e.mode,n||null==e._bodyInit||(n=e._bodyInit,e.bodyUsed=!0)}else this.url=String(e);if(this.credentials=t.credentials||this.credentials||"omit",!t.headers&&this.headers||(this.headers=new o(t.headers)),this.method=f(t.method||this.method||"GET"),this.mode=t.mode||this.mode||null,this.referrer=null,("GET"===this.method||"HEAD"===this.method)&&n)throw new TypeError("Body not allowed for GET or HEAD requests");this._initBody(n)}function h(e){var t=new FormData;return e.trim().split("&").forEach(function(e){if(e){var n=e.split("="),r=n.shift().replace(/\+/g," "),o=n.join("=").replace(/\+/g," ");t.append(decodeURIComponent(r),decodeURIComponent(o))}}),t}function m(e){var t=new o;return e.split(/\r?\n/).forEach(function(e){var n=e.split(":"),r=n.shift().trim();if(r){var o=n.join(":").trim();t.append(r,o)}}),t}function v(e,t){t||(t={}),this.type="default",this.status="status"in t?t.status:200,this.ok=this.status>=200&&this.status<300,this.statusText="statusText"in t?t.statusText:"OK",this.headers=new o(t.headers),this.url=t.url||"",this._initBody(e)}if(!e.fetch){var g={searchParams:"URLSearchParams"in e,iterable:"Symbol"in e&&"iterator"in Symbol,blob:"FileReader"in e&&"Blob"in e&&function(){try{return new Blob,!0}catch(e){return!1}}(),formData:"FormData"in e,arrayBuffer:"ArrayBuffer"in e};if(g.arrayBuffer)var y=["[object Int8Array]","[object Uint8Array]","[object Uint8ClampedArray]","[object Int16Array]","[object Uint16Array]","[object Int32Array]","[object Uint32Array]","[object Float32Array]","[object Float64Array]"],b=function(e){return e&&DataView.prototype.isPrototypeOf(e)},C=ArrayBuffer.isView||function(e){return e&&y.indexOf(Object.prototype.toString.call(e))>-1};o.prototype.append=function(e,r){e=t(e),r=n(r);var o=this.map[e];this.map[e]=o?o+","+r:r},o.prototype.delete=function(e){delete this.map[t(e)]},o.prototype.get=function(e){return e=t(e),this.has(e)?this.map[e]:null},o.prototype.has=function(e){return this.map.hasOwnProperty(t(e))},o.prototype.set=function(e,r){this.map[t(e)]=n(r)},o.prototype.forEach=function(e,t){for(var n in this.map)this.map.hasOwnProperty(n)&&e.call(t,this.map[n],n,this)},o.prototype.keys=function(){var e=[];return this.forEach(function(t,n){e.push(n)}),r(e)},o.prototype.values=function(){var e=[];return this.forEach(function(t){e.push(t)}),r(e)},o.prototype.entries=function(){var e=[];return this.forEach(function(t,n){e.push([n,t])}),r(e)},g.iterable&&(o.prototype[Symbol.iterator]=o.prototype.entries);var _=["DELETE","GET","HEAD","OPTIONS","POST","PUT"];d.prototype.clone=function(){return new d(this,{body:this._bodyInit})},p.call(d.prototype),p.call(v.prototype),v.prototype.clone=function(){return new v(this._bodyInit,{status:this.status,statusText:this.statusText,headers:new o(this.headers),url:this.url})},v.error=function(){var e=new v(null,{status:0,statusText:""});return e.type="error",e};var w=[301,302,303,307,308];v.redirect=function(e,t){if(w.indexOf(t)===-1)throw new RangeError("Invalid status code");return new v(null,{status:t,headers:{location:e}})},e.Headers=o,e.Request=d,e.Response=v,e.fetch=function(e,t){return new Promise(function(n,r){var o=new d(e,t),i=new XMLHttpRequest;i.onload=function(){var e={status:i.status,statusText:i.statusText,headers:m(i.getAllResponseHeaders()||"")};e.url="responseURL"in i?i.responseURL:e.headers.get("X-Request-URL");var t="response"in i?i.response:i.responseText;n(new v(t,e))},i.onerror=function(){r(new TypeError("Network request failed"))},i.ontimeout=function(){r(new TypeError("Network request failed"))},i.open(o.method,o.url,!0),"include"===o.credentials&&(i.withCredentials=!0),"responseType"in i&&g.blob&&(i.responseType="blob"),o.headers.forEach(function(e,t){i.setRequestHeader(t,e)}),i.send("undefined"==typeof o._bodyInit?null:o._bodyInit)})},e.fetch.polyfill=!0}}("undefined"!=typeof self?self:this)},function(e,t,n,r,o,i,a,s){function u(e,t){var n,r=function(o){return e.length>1?function(){var i=o?o.concat():[];return n=t?n||this:this,i.push.apply(i,arguments)<e.length&&arguments.length?r.call(n,i):e.apply(n,i)}:e};return r()}var l,c,p,f,d,h,m,v,g,y={}.toString;l=n(r),c=n(o),p=n(i),f=n(a),d=n(s),h=function(e){return e},m=u(function(e,t){return y.call(t).slice(8,-1)===e}),v=u(function(e,t){var n,r=[];for(n=0;n<e;++n)r.push(t);return r}),f.empty=c.empty,f.slice=c.slice,f.take=c.take,f.drop=c.drop,f.splitAt=c.splitAt,f.takeWhile=c.takeWhile,f.dropWhile=c.dropWhile,f.span=c.span,f.breakStr=c.breakList,g={Func:l,List:c,Obj:p,Str:f,Num:d,id:h,isType:m,replicate:v},g.each=c.each,g.map=c.map,g.filter=c.filter,g.compact=c.compact,g.reject=c.reject,g.partition=c.partition,g.find=c.find,g.head=c.head,g.first=c.first,g.tail=c.tail,g.last=c.last,g.initial=c.initial,g.empty=c.empty,g.reverse=c.reverse,g.difference=c.difference,g.intersection=c.intersection,g.union=c.union,g.countBy=c.countBy,g.groupBy=c.groupBy,g.fold=c.fold,g.foldl=c.foldl,
+g.fold1=c.fold1,g.foldl1=c.foldl1,g.foldr=c.foldr,g.foldr1=c.foldr1,g.unfoldr=c.unfoldr,g.andList=c.andList,g.orList=c.orList,g.any=c.any,g.all=c.all,g.unique=c.unique,g.uniqueBy=c.uniqueBy,g.sort=c.sort,g.sortWith=c.sortWith,g.sortBy=c.sortBy,g.sum=c.sum,g.product=c.product,g.mean=c.mean,g.average=c.average,g.concat=c.concat,g.concatMap=c.concatMap,g.flatten=c.flatten,g.maximum=c.maximum,g.minimum=c.minimum,g.maximumBy=c.maximumBy,g.minimumBy=c.minimumBy,g.scan=c.scan,g.scanl=c.scanl,g.scan1=c.scan1,g.scanl1=c.scanl1,g.scanr=c.scanr,g.scanr1=c.scanr1,g.slice=c.slice,g.take=c.take,g.drop=c.drop,g.splitAt=c.splitAt,g.takeWhile=c.takeWhile,g.dropWhile=c.dropWhile,g.span=c.span,g.breakList=c.breakList,g.zip=c.zip,g.zipWith=c.zipWith,g.zipAll=c.zipAll,g.zipAllWith=c.zipAllWith,g.at=c.at,g.elemIndex=c.elemIndex,g.elemIndices=c.elemIndices,g.findIndex=c.findIndex,g.findIndices=c.findIndices,g.apply=l.apply,g.curry=l.curry,g.flip=l.flip,g.fix=l.fix,g.over=l.over,g.split=f.split,g.join=f.join,g.lines=f.lines,g.unlines=f.unlines,g.words=f.words,g.unwords=f.unwords,g.chars=f.chars,g.unchars=f.unchars,g.repeat=f.repeat,g.capitalize=f.capitalize,g.camelize=f.camelize,g.dasherize=f.dasherize,g.values=p.values,g.keys=p.keys,g.pairsToObj=p.pairsToObj,g.objToPairs=p.objToPairs,g.listsToObj=p.listsToObj,g.objToLists=p.objToLists,g.max=d.max,g.min=d.min,g.negate=d.negate,g.abs=d.abs,g.signum=d.signum,g.quot=d.quot,g.rem=d.rem,g.div=d.div,g.mod=d.mod,g.recip=d.recip,g.pi=d.pi,g.tau=d.tau,g.exp=d.exp,g.sqrt=d.sqrt,g.ln=d.ln,g.pow=d.pow,g.sin=d.sin,g.tan=d.tan,g.cos=d.cos,g.acos=d.acos,g.asin=d.asin,g.atan=d.atan,g.atan2=d.atan2,g.truncate=d.truncate,g.round=d.round,g.ceiling=d.ceiling,g.floor=d.floor,g.isItNaN=d.isItNaN,g.even=d.even,g.odd=d.odd,g.gcd=d.gcd,g.lcm=d.lcm,g.VERSION="1.2.1",e.exports=g},function(e,t,n,r){"use strict";var o=n(r),i=(n(1),function(e){var t=this;if(t.instancePool.length){var n=t.instancePool.pop();return t.call(n,e),n}return new t(e)}),a=function(e,t){var n=this;if(n.instancePool.length){var r=n.instancePool.pop();return n.call(r,e,t),r}return new n(e,t)},s=function(e,t,n){var r=this;if(r.instancePool.length){var o=r.instancePool.pop();return r.call(o,e,t,n),o}return new r(e,t,n)},u=function(e,t,n,r){var o=this;if(o.instancePool.length){var i=o.instancePool.pop();return o.call(i,e,t,n,r),i}return new o(e,t,n,r)},l=function(e){var t=this;e instanceof t?void 0:o("25"),e.destructor(),t.instancePool.length<t.poolSize&&t.instancePool.push(e)},c=10,p=i,f=function(e,t){var n=e;return n.instancePool=[],n.getPooled=t||p,n.poolSize||(n.poolSize=c),n.release=l,n},d={addPoolingTo:f,oneArgumentPooler:i,twoArgumentPooler:a,threeArgumentPooler:s,fourArgumentPooler:u};e.exports=d}]));
+//# sourceMappingURL=main.0be833e3.js.map
\ No newline at end of file

From e6829310adc98ce57b5ea65c977aa212397036c4 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 10 Oct 2022 19:05:13 +0000
Subject: [PATCH 182/743] Validate notifier custom conditions before saving

* Fixes #1846
---
 plexpy/common.py               |  5 +++
 plexpy/notification_handler.py |  8 +++-
 plexpy/notifiers.py            | 74 +++++++++++++++++++++++++++++++++-
 3 files changed, 84 insertions(+), 3 deletions(-)

diff --git a/plexpy/common.py b/plexpy/common.py
index 039931f4..b6800d3c 100644
--- a/plexpy/common.py
+++ b/plexpy/common.py
@@ -679,3 +679,8 @@ NEWSLETTER_PARAMETERS = [
         ]
     }
 ]
+
+
+NOTIFICATION_PARAMETERS_TYPES = {
+    parameter['value']: parameter['type'] for category in NOTIFICATION_PARAMETERS for parameter in category['parameters']
+}
diff --git a/plexpy/notification_handler.py b/plexpy/notification_handler.py
index ad774fa6..315bcb52 100644
--- a/plexpy/notification_handler.py
+++ b/plexpy/notification_handler.py
@@ -288,7 +288,7 @@ def notify_custom_conditions(notifier_id=None, parameters=None):
                 continue
 
             # Make sure the condition values is in a list
-            if isinstance(values, str):
+            if not isinstance(values, list):
                 values = [values]
 
             # Cast the condition values to the correct type
@@ -302,6 +302,9 @@ def notify_custom_conditions(notifier_id=None, parameters=None):
                 elif parameter_type == 'float':
                     values = [helpers.cast_to_float(v) for v in values]
 
+                else:
+                    raise ValueError
+
             except ValueError as e:
                 logger.error("Tautulli NotificationHandler :: {%s} Unable to cast condition '%s', values '%s', to type '%s'."
                              % (i+1, parameter, values, parameter_type))
@@ -318,6 +321,9 @@ def notify_custom_conditions(notifier_id=None, parameters=None):
                 elif parameter_type == 'float':
                     parameter_value = helpers.cast_to_float(parameter_value)
 
+                else:
+                    raise ValueError
+
             except ValueError as e:
                 logger.error("Tautulli NotificationHandler :: {%s} Unable to cast parameter '%s', value '%s', to type '%s'."
                              % (i+1, parameter, parameter_value, parameter_type))
diff --git a/plexpy/notifiers.py b/plexpy/notifiers.py
index b7ee4f17..ffe3d40a 100644
--- a/plexpy/notifiers.py
+++ b/plexpy/notifiers.py
@@ -112,7 +112,12 @@ AGENT_IDS = {'growl': 0,
              'gotify': 29
              }
 
-DEFAULT_CUSTOM_CONDITIONS = [{'parameter': '', 'operator': '', 'value': ''}]
+DEFAULT_CUSTOM_CONDITIONS = [{'parameter': '', 'operator': '', 'value': [], 'type': None}]
+CUSTOM_CONDITION_TYPE_OPERATORS = {
+    'float': ['is', 'is not', 'is greater than', 'is less than'],
+    'int': ['is', 'is not', 'is greater than', 'is less than'],
+    'str': ['contains', 'does not contain', 'is', 'is not', 'begins with', 'does not begin with', 'ends with', 'does not end with'],
+}
 
 
 def available_notification_agents():
@@ -642,13 +647,18 @@ def set_notifier_config(notifier_id=None, agent_id=None, **kwargs):
 
     agent_class = get_agent_class(agent_id=agent['id'], config=notifier_config)
 
+    custom_conditions = validate_conditions(kwargs.get('custom_conditions'))
+    if custom_conditions is False:
+        logger.error("Tautulli Notifiers :: Unable to update notification agent: Invalid custom conditions.")
+        return False
+
     keys = {'id': notifier_id}
     values = {'agent_id': agent['id'],
               'agent_name': agent['name'],
               'agent_label': agent['label'],
               'friendly_name': kwargs.get('friendly_name', ''),
               'notifier_config': json.dumps(agent_class.config),
-              'custom_conditions': kwargs.get('custom_conditions', json.dumps(DEFAULT_CUSTOM_CONDITIONS)),
+              'custom_conditions': json.dumps(custom_conditions or DEFAULT_CUSTOM_CONDITIONS),
               'custom_conditions_logic': kwargs.get('custom_conditions_logic', ''),
               }
     values.update(actions)
@@ -685,6 +695,66 @@ def send_notification(notifier_id=None, subject='', body='', notify_action='', n
         logger.debug("Tautulli Notifiers :: Notification requested but no notifier_id received.")
 
 
+def validate_conditions(custom_conditions):
+    if custom_conditions is None:
+        return DEFAULT_CUSTOM_CONDITIONS
+
+    try:
+        conditions = json.loads(custom_conditions)
+    except ValueError:
+        logger.error("Tautulli Notifiers :: Unable to parse custom conditions json: %s" % custom_conditions)
+        return False
+
+    if not isinstance(conditions, list):
+        logger.error("Tautulli Notifiers :: Invalid custom conditions: %s. Conditions must be a list." % conditions)
+        return False
+
+    validated_conditions = []
+
+    for condition in conditions:
+        validated_condition = DEFAULT_CUSTOM_CONDITIONS[0].copy()
+
+        if not isinstance(condition, dict):
+            logger.error("Tautulli Notifiers :: Invalid custom condition: %s. Condition must be a dict." % condition)
+            return False
+
+        parameter = str(condition.get('parameter', '')).lower()
+        operator = str(condition.get('operator', '')).lower()
+        values = condition.get('value', [])
+
+        if parameter:
+            parameter_type = common.NOTIFICATION_PARAMETERS_TYPES.get(parameter)
+        
+            if not parameter_type:
+                logger.error("Tautulli Notifiers :: Invalid parameter '%s' in custom condition: %s" % (parameter, condition))
+                return False
+
+            validated_condition['parameter'] = parameter.lower()
+            validated_condition['type'] = parameter_type
+
+        if operator:
+            if operator not in CUSTOM_CONDITION_TYPE_OPERATORS.get(parameter_type, []):
+                logger.error("Tautulli Notifiers :: Invalid operator '%s' for parameter '%s' in custom condition: %s" % (operator, parameter, condition))
+                return False
+
+            validated_condition['operator'] = operator
+
+        if values:
+            if not isinstance(values, list):
+                values = [values]
+
+            for value in values:
+                if not isinstance(value, (str, int, float)):
+                    logger.error("Tautulli Notifiers :: Invalid value '%s' for parameter '%s' in custom condition: %s" % (value, parameter, condition))
+                    return False
+            
+            validated_condition['value'] = values
+
+        validated_conditions.append(validated_condition)
+
+    return validated_conditions
+
+
 def blacklist_logger():
     db = database.MonitorDatabase()
     notifiers = db.select('SELECT notifier_config FROM notifiers')

From 08bc365a7c8dd7f91ab5c5344f8a19927ba9acd9 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 25 Oct 2022 16:11:37 +0000
Subject: [PATCH 183/743] Add collections to get_children_metadata API data

---
 plexpy/pmsconnect.py | 6 ++++++
 plexpy/webserve.py   | 3 ++-
 2 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/plexpy/pmsconnect.py b/plexpy/pmsconnect.py
index e83a0a2d..9353b716 100644
--- a/plexpy/pmsconnect.py
+++ b/plexpy/pmsconnect.py
@@ -2442,6 +2442,7 @@ class PmsConnect(object):
                     actors = []
                     genres = []
                     labels = []
+                    collections = []
 
                     if m.getElementsByTagName('Director'):
                         for director in m.getElementsByTagName('Director'):
@@ -2463,6 +2464,10 @@ class PmsConnect(object):
                         for label in m.getElementsByTagName('Label'):
                             labels.append(helpers.get_xml_attr(label, 'tag'))
 
+                    if m.getElementsByTagName('Collection'):
+                        for collection in m.getElementsByTagName('Collection'):
+                            collections.append(helpers.get_xml_attr(collection, 'tag'))
+
                     media_type = helpers.get_xml_attr(m, 'type')
                     if m.nodeName == 'Directory' and media_type == 'photo':
                         media_type = 'photo_album'
@@ -2506,6 +2511,7 @@ class PmsConnect(object):
                                        'actors': actors,
                                        'genres': genres,
                                        'labels': labels,
+                                       'collections': collections,
                                        'full_title': helpers.get_xml_attr(m, 'title')
                                        }
                     children_list.append(children_output)
diff --git a/plexpy/webserve.py b/plexpy/webserve.py
index 3355d53e..040d61c7 100644
--- a/plexpy/webserve.py
+++ b/plexpy/webserve.py
@@ -4591,6 +4591,7 @@ class WebInterface(object):
                           "audience_rating": "",
                           "audience_rating_image": "",
                           "banner": "",
+                          "collections": [],
                           "content_rating": "",
                           "directors": [],
                           "duration": "",
@@ -5442,8 +5443,8 @@ class WebInterface(object):
                      "tagline": "",
                      "thumb": "/library/metadata/153037/thumb/1462175060",
                      "title": "The Red Woman",
-                     "user_rating": "9.0",
                      "updated_at": "1462175060",
+                     "user_rating": "9.0",
                      "writers": [
                         "David Benioff",
                         "D. B. Weiss"

From 571bbb2db114fcc6868ef9287223ccc3dee39139 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 1 Nov 2022 16:37:36 +0000
Subject: [PATCH 184/743] Fallback season thumb to show thumb in get_metadata

---
 plexpy/pmsconnect.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/plexpy/pmsconnect.py b/plexpy/pmsconnect.py
index 9353b716..11142873 100644
--- a/plexpy/pmsconnect.py
+++ b/plexpy/pmsconnect.py
@@ -924,7 +924,7 @@ class PmsConnect(object):
                         'parent_year': show_details.get('year', ''),
                         'grandparent_year': helpers.get_xml_attr(metadata_main, 'grandparentYear'),
                         'thumb': helpers.get_xml_attr(metadata_main, 'thumb'),
-                        'parent_thumb': helpers.get_xml_attr(metadata_main, 'parentThumb'),
+                        'parent_thumb': helpers.get_xml_attr(metadata_main, 'parentThumb') or show_details.get('thumb'),
                         'grandparent_thumb': helpers.get_xml_attr(metadata_main, 'grandparentThumb'),
                         'art': helpers.get_xml_attr(metadata_main, 'art'),
                         'banner': show_details.get('banner', ''),
@@ -1003,7 +1003,7 @@ class PmsConnect(object):
                         'parent_year': season_details.get('year', ''),
                         'grandparent_year': show_details.get('year', ''),
                         'thumb': helpers.get_xml_attr(metadata_main, 'thumb'),
-                        'parent_thumb': parent_thumb,
+                        'parent_thumb': parent_thumb or show_details.get('thumb'),
                         'grandparent_thumb': helpers.get_xml_attr(metadata_main, 'grandparentThumb'),
                         'art': helpers.get_xml_attr(metadata_main, 'art'),
                         'banner': show_details.get('banner', ''),

From 5975b59c93c8cc1526c35b167670fe5d23c0d9f6 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 5 Nov 2022 20:03:48 +0000
Subject: [PATCH 185/743] Add user_thumb to get_history response

---
 plexpy/datafactory.py | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/plexpy/datafactory.py b/plexpy/datafactory.py
index 7027ae81..8a15ef7d 100644
--- a/plexpy/datafactory.py
+++ b/plexpy/datafactory.py
@@ -34,6 +34,7 @@ if plexpy.PYTHON2:
     import logger
     import pmsconnect
     import session
+    import users
 else:
     from plexpy import libraries
     from plexpy import common
@@ -43,6 +44,7 @@ else:
     from plexpy import logger
     from plexpy import pmsconnect
     from plexpy import session
+    from plexpy import users
 
 # Temporarily store update_metadata row ids in memory to prevent rating_key collisions
 _UPDATE_METADATA_IDS = {
@@ -103,6 +105,8 @@ class DataFactory(object):
             'session_history.user',
             '(CASE WHEN users.friendly_name IS NULL OR TRIM(users.friendly_name) = "" \
              THEN users.username ELSE users.friendly_name END) AS friendly_name',
+            'users.thumb AS user_thumb',
+            'users.custom_avatar_url AS custom_thumb',
             'platform',
             'product',
             'player',
@@ -161,6 +165,8 @@ class DataFactory(object):
                 'user',
                 '(CASE WHEN friendly_name IS NULL OR TRIM(friendly_name) = "" \
                  THEN user ELSE friendly_name END) AS friendly_name',
+                'NULL AS user_thumb',
+                'NULL AS custom_thumb',
                 'platform',
                 'product',
                 'player',
@@ -244,7 +250,18 @@ class DataFactory(object):
                            }
 
         rows = []
+
+        users_lookup = {}
+
         for item in history:
+            if item['state']:
+                # Get user thumb from database for current activity
+                if not users_lookup:
+                    # Cache user lookup
+                    users_lookup = {u['user_id']: u['thumb'] for u in users.Users().get_users()}
+
+                item['user_thumb'] = users_lookup.get(item['user_id'])
+
             filter_duration += int(item['duration'])
 
             if item['media_type'] == 'episode' and item['parent_thumb']:
@@ -267,6 +284,13 @@ class DataFactory(object):
             # Rename Mystery platform names
             platform = common.PLATFORM_NAME_OVERRIDES.get(item['platform'], item['platform'])
 
+            if item['custom_thumb'] and item['custom_thumb'] != item['user_thumb']:
+                user_thumb = item['custom_thumb']
+            elif item['user_thumb']:
+                user_thumb = item['user_thumb']
+            else:
+                user_thumb = common.DEFAULT_USER_THUMB
+
             row = {'reference_id': item['reference_id'],
                    'row_id': item['row_id'],
                    'id': item['row_id'],
@@ -278,6 +302,7 @@ class DataFactory(object):
                    'user_id': item['user_id'],
                    'user': item['user'],
                    'friendly_name': item['friendly_name'],
+                   'user_thumb': user_thumb,
                    'platform': platform,
                    'product': item['product'],
                    'player': item['player'],

From 4b97382b7c8a6611ef10741118fa475139c220e9 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 7 Nov 2022 09:30:19 -0800
Subject: [PATCH 186/743] Bump actions/stale from 5 to 6 (#1844)

Bumps [actions/stale](https://github.com/actions/stale) from 5 to 6.
- [Release notes](https://github.com/actions/stale/releases)
- [Changelog](https://github.com/actions/stale/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/stale/compare/v5...v6)

---
updated-dependencies:
- dependency-name: actions/stale
  dependency-type: direct:production
  update-type: version-update:semver-major
...

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

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 .github/workflows/issues-stale.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/issues-stale.yml b/.github/workflows/issues-stale.yml
index 4605bcec..75c1e08f 100644
--- a/.github/workflows/issues-stale.yml
+++ b/.github/workflows/issues-stale.yml
@@ -10,7 +10,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Stale
-        uses: actions/stale@v5
+        uses: actions/stale@v6
         with:
           stale-issue-message: >
             This issue is stale because it has been open for 30 days with no activity.
@@ -30,7 +30,7 @@ jobs:
           days-before-close: 5
 
       - name: Invalid Template
-        uses: actions/stale@v5
+        uses: actions/stale@v6
         with:
           stale-issue-message: >
             Invalid issues template.

From 1977ca7db2b48bcc24be13019e618ce74ed471b9 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 7 Nov 2022 09:30:30 -0800
Subject: [PATCH 187/743] Bump actions/checkout from 3.0.2 to 3.1.0 (#1858)

Bumps [actions/checkout](https://github.com/actions/checkout) from 3.0.2 to 3.1.0.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v3.0.2...v3.1.0)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

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

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 .github/workflows/publish-docker.yml     | 2 +-
 .github/workflows/publish-installers.yml | 4 ++--
 .github/workflows/publish-snap.yml       | 2 +-
 .github/workflows/pull-requests.yml      | 2 +-
 4 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/publish-docker.yml b/.github/workflows/publish-docker.yml
index 773f730f..313ac340 100644
--- a/.github/workflows/publish-docker.yml
+++ b/.github/workflows/publish-docker.yml
@@ -13,7 +13,7 @@ jobs:
     if: ${{ !contains(github.event.head_commit.message, '[skip ci]') }}
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v3.0.2
+        uses: actions/checkout@v3.1.0
 
       - name: Prepare
         id: prepare
diff --git a/.github/workflows/publish-installers.yml b/.github/workflows/publish-installers.yml
index ad590098..372e2591 100644
--- a/.github/workflows/publish-installers.yml
+++ b/.github/workflows/publish-installers.yml
@@ -24,7 +24,7 @@ jobs:
 
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v3.0.2
+        uses: actions/checkout@v3.1.0
 
       - name: Set Release Version
         id: get_version
@@ -103,7 +103,7 @@ jobs:
         uses: technote-space/workflow-conclusion-action@v3.0
 
       - name: Checkout Code
-        uses: actions/checkout@v3.0.2
+        uses: actions/checkout@v3.1.0
 
       - name: Set Release Version
         id: get_version
diff --git a/.github/workflows/publish-snap.yml b/.github/workflows/publish-snap.yml
index 27682148..81a4728f 100644
--- a/.github/workflows/publish-snap.yml
+++ b/.github/workflows/publish-snap.yml
@@ -20,7 +20,7 @@ jobs:
           - armhf
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v3.0.2
+        uses: actions/checkout@v3.1.0
 
       - name: Prepare
         id: prepare
diff --git a/.github/workflows/pull-requests.yml b/.github/workflows/pull-requests.yml
index 08f92507..ff9a0839 100644
--- a/.github/workflows/pull-requests.yml
+++ b/.github/workflows/pull-requests.yml
@@ -10,7 +10,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v3.0.2
+        uses: actions/checkout@v3.1.0
 
       - name: Comment on Pull Request
         uses: mshick/add-pr-comment@v1

From a1b6c35bd2630ce280515c8419e30a452cac7feb Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 7 Nov 2022 09:30:40 -0800
Subject: [PATCH 188/743] Bump actions/setup-python from 4.2.0 to 4.3.0 (#1859)

Bumps [actions/setup-python](https://github.com/actions/setup-python) from 4.2.0 to 4.3.0.
- [Release notes](https://github.com/actions/setup-python/releases)
- [Commits](https://github.com/actions/setup-python/compare/v4.2.0...v4.3.0)

---
updated-dependencies:
- dependency-name: actions/setup-python
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

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

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 .github/workflows/publish-installers.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/publish-installers.yml b/.github/workflows/publish-installers.yml
index 372e2591..00c5f722 100644
--- a/.github/workflows/publish-installers.yml
+++ b/.github/workflows/publish-installers.yml
@@ -52,7 +52,7 @@ jobs:
           echo $GITHUB_SHA > version.txt
 
       - name: Set Up Python
-        uses: actions/setup-python@v4.2.0
+        uses: actions/setup-python@v4.3.0
         with:
           python-version: '3.9'
           cache: pip

From c53566225cc03068161f66d13c72f6c41e250776 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 7 Nov 2022 09:30:51 -0800
Subject: [PATCH 189/743] Bump actions/cache from 3.0.8 to 3.0.11 (#1864)

Bumps [actions/cache](https://github.com/actions/cache) from 3.0.8 to 3.0.11.
- [Release notes](https://github.com/actions/cache/releases)
- [Changelog](https://github.com/actions/cache/blob/main/RELEASES.md)
- [Commits](https://github.com/actions/cache/compare/v3.0.8...v3.0.11)

---
updated-dependencies:
- dependency-name: actions/cache
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 .github/workflows/publish-docker.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/publish-docker.yml b/.github/workflows/publish-docker.yml
index 313ac340..5f95cd9d 100644
--- a/.github/workflows/publish-docker.yml
+++ b/.github/workflows/publish-docker.yml
@@ -47,7 +47,7 @@ jobs:
           version: latest
 
       - name: Cache Docker Layers
-        uses: actions/cache@v3.0.8
+        uses: actions/cache@v3.0.11
         with:
           path: /tmp/.buildx-cache
           key: ${{ runner.os }}-buildx-${{ github.sha }}

From ed53d66aa71ff4f712da48aa2e6aed01a4454449 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 18 Sep 2022 15:30:53 -0700
Subject: [PATCH 190/743] Launch browser with IPv6 http_host

---
 plexpy/__init__.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/plexpy/__init__.py b/plexpy/__init__.py
index 6b10446b..e4f64b45 100644
--- a/plexpy/__init__.py
+++ b/plexpy/__init__.py
@@ -429,7 +429,7 @@ def daemonize():
 
 def launch_browser(host, port, root):
     if not no_browser:
-        if host == '0.0.0.0':
+        if host in ('0.0.0.0', '::'):
             host = 'localhost'
 
         if CONFIG.ENABLE_HTTPS:

From 894eaf0365d36aa80c6e8ee6ac647c853a001d33 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 18 Sep 2022 15:34:11 -0700
Subject: [PATCH 191/743] Check IPv6 HTTP host when retrieving app URL

---
 data/interfaces/default/mobile_devices_table.html | 4 ++--
 plexpy/helpers.py                                 | 5 +++--
 2 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/data/interfaces/default/mobile_devices_table.html b/data/interfaces/default/mobile_devices_table.html
index 35c873bf..328e40e4 100644
--- a/data/interfaces/default/mobile_devices_table.html
+++ b/data/interfaces/default/mobile_devices_table.html
@@ -58,7 +58,7 @@ DOCUMENTATION :: END
 
     getPlexPyURL = function () {
         var deferred = $.Deferred();
-        if (location.hostname !== "localhost" && location.hostname !== "127.0.0.1") {
+        if (location.hostname !== "localhost" && location.hostname !== "127.0.0.1" && location.hostname !== "[::1]") {
             deferred.resolve(location.href.split('/settings')[0]);
         } else {
             $.get('get_plexpy_url').then(function (url) {
@@ -74,7 +74,7 @@ DOCUMENTATION :: END
         var hostname = parser.hostname;
         var protocol = parser.protocol;
 
-        if (hostname === '127.0.0.1' || hostname === 'localhost') {
+        if (hostname === 'localhost' || hostname === '127.0.0.1' || hostname === '[::1]') {
             $('#api_qr_localhost').toggle(true);
             $('#api_qr_private').toggle(false);
         } else {
diff --git a/plexpy/helpers.py b/plexpy/helpers.py
index d5ef887f..da5a5df5 100644
--- a/plexpy/helpers.py
+++ b/plexpy/helpers.py
@@ -1191,9 +1191,10 @@ def get_plexpy_url(hostname=None):
     else:
         scheme = 'http'
 
-    if hostname is None and plexpy.CONFIG.HTTP_HOST == '0.0.0.0':
+    if hostname is None and plexpy.CONFIG.HTTP_HOST in ('0.0.0.0', '::'):
         import socket
         try:
+            # Only returns IPv4 address
             s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
             s.setsockopt(socket.SOL_SOCKET, socket.SO_BROADCAST, 1)
             s.connect(('<broadcast>', 0))
@@ -1206,7 +1207,7 @@ def get_plexpy_url(hostname=None):
 
         if not hostname:
             hostname = 'localhost'
-    elif hostname == 'localhost' and plexpy.CONFIG.HTTP_HOST != '0.0.0.0':
+    elif hostname == 'localhost' and plexpy.CONFIG.HTTP_HOST not in ('0.0.0.0', '::'):
         hostname = plexpy.CONFIG.HTTP_HOST
     else:
         hostname = hostname or plexpy.CONFIG.HTTP_HOST

From b74a1a3c327aa0e80f6c7b3c370e4295b1ba439d Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 7 Nov 2022 10:39:39 -0800
Subject: [PATCH 192/743] Separate stdout and stderr console logging

* Closes #1874
---
 plexpy/logger.py | 28 +++++++++++++++++++++++-----
 1 file changed, 23 insertions(+), 5 deletions(-)

diff --git a/plexpy/logger.py b/plexpy/logger.py
index 953073c3..9f44df95 100644
--- a/plexpy/logger.py
+++ b/plexpy/logger.py
@@ -85,6 +85,16 @@ def filter_usernames(new_users=None):
     _FILTER_USERNAMES = sorted(_FILTER_USERNAMES, key=len, reverse=True)
 
 
+class LogLevelFilter(logging.Filter):
+    def __init__(self, max_level):
+        super(LogLevelFilter, self).__init__()
+
+        self.max_level = max_level
+
+    def filter(self, record):
+        return record.levelno <= self.max_level
+
+
 class NoThreadFilter(logging.Filter):
     """
     Log filter for the current thread
@@ -330,12 +340,20 @@ def initLogger(console=False, log_dir=False, verbose=False):
     # Setup console logger
     if console:
         console_formatter = logging.Formatter('%(asctime)s - %(levelname)s :: %(threadName)s : %(message)s', '%Y-%m-%d %H:%M:%S')
-        console_handler = logging.StreamHandler()
-        console_handler.setFormatter(console_formatter)
-        console_handler.setLevel(logging.DEBUG)
 
-        logger.addHandler(console_handler)
-        cherrypy.log.error_log.addHandler(console_handler)
+        stdout_handler = logging.StreamHandler(sys.stdout)
+        stdout_handler.setFormatter(console_formatter)
+        stdout_handler.setLevel(logging.DEBUG)
+        stdout_handler.addFilter(LogLevelFilter(logging.INFO))
+
+        stderr_handler = logging.StreamHandler(sys.stderr)
+        stderr_handler.setFormatter(console_formatter)
+        stderr_handler.setLevel(logging.WARNING)
+
+        logger.addHandler(stdout_handler)
+        logger.addHandler(stderr_handler)
+        cherrypy.log.error_log.addHandler(stdout_handler)
+        cherrypy.log.error_log.addHandler(stderr_handler)
 
     # Add filters to log handlers
     # Only add filters after the config file has been initialized

From a3ad40122d0eee52cf0029ddb798d85bf3a6b326 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 7 Nov 2022 11:26:13 -0800
Subject: [PATCH 193/743] Add months timeframe for newsletters

* Closes #1876
---
 data/interfaces/default/newsletter_config.html | 3 ++-
 plexpy/newsletters.py                          | 4 +++-
 2 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/data/interfaces/default/newsletter_config.html b/data/interfaces/default/newsletter_config.html
index 003594a7..dc6de294 100644
--- a/data/interfaces/default/newsletter_config.html
+++ b/data/interfaces/default/newsletter_config.html
@@ -56,11 +56,12 @@
                                     <div class="form-group">
                                         <label for="time_frame">Time Frame</label>
                                         <div class="row">
-                                            <div class="col-md-4">
+                                            <div class="col-md-5">
                                                 <div class="input-group newsletter-time_frame">
                                                     <span class="input-group-addon form-control btn-dark inactive">Last</span>
                                                     <input type="number" class="form-control" id="newsletter_config_time_frame" name="newsletter_config_time_frame" value="${newsletter['config']['time_frame']}">
                                                     <select class="form-control" id="newsletter_config_time_frame_units" name="newsletter_config_time_frame_units">
+                                                        <option value="months" ${'selected' if newsletter['config']['time_frame_units'] == 'months' else ''}>months</option>
                                                         <option value="days" ${'selected' if newsletter['config']['time_frame_units'] == 'days' else ''}>days</option>
                                                         <option value="hours" ${'selected' if newsletter['config']['time_frame_units'] == 'hours' else ''}>hours</option>
                                                     </select>
diff --git a/plexpy/newsletters.py b/plexpy/newsletters.py
index 03513f1e..902eb69b 100644
--- a/plexpy/newsletters.py
+++ b/plexpy/newsletters.py
@@ -402,7 +402,9 @@ class Newsletter(object):
                 pass
 
         if self.start_date is None:
-            if self.config['time_frame_units'] == 'days':
+            if self.config['time_frame_units'] == 'months':
+                self.start_date = self.end_date.shift(months=-self.config['time_frame'])
+            elif self.config['time_frame_units'] == 'days':
                 self.start_date = self.end_date.shift(days=-self.config['time_frame'])
             else:
                 self.start_date = self.end_date.shift(hours=-self.config['time_frame'])

From 7c8cea74e4c38a41ef5364ca063b0a6199842578 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 7 Nov 2022 12:05:04 -0800
Subject: [PATCH 194/743] Fix padding on condition operator dropdown on small
 screens

---
 data/interfaces/default/css/tautulli.css      | 10 ++++++++++
 data/interfaces/default/js/filterer.jquery.js | 16 ++++++++--------
 2 files changed, 18 insertions(+), 8 deletions(-)

diff --git a/data/interfaces/default/css/tautulli.css b/data/interfaces/default/css/tautulli.css
index c30a69ee..ac99ae76 100644
--- a/data/interfaces/default/css/tautulli.css
+++ b/data/interfaces/default/css/tautulli.css
@@ -122,6 +122,16 @@ select.form-control {
 #condition-widget .fa-minus {
     cursor: pointer;
 }
+#condition-widget .condition-operator-col {
+    padding-left: 0;
+    padding-right: 0;
+}
+@media (max-width: 767px) {
+    #condition-widget .condition-operator-col {
+        padding-left: 15px;
+        padding-right: 15px;
+    }
+}
 .react-selectize.root-node .react-selectize-control .react-selectize-placeholder {
     color: #eee !important;
 }
diff --git a/data/interfaces/default/js/filterer.jquery.js b/data/interfaces/default/js/filterer.jquery.js
index c17646fe..db84ab9d 100644
--- a/data/interfaces/default/js/filterer.jquery.js
+++ b/data/interfaces/default/js/filterer.jquery.js
@@ -1,10 +1,10 @@
 !function(e){function t(r){if(n[r])return n[r].exports;var o=n[r]={exports:{},id:r,loaded:!1};return e[r].call(o.exports,o,o.exports,t),o.loaded=!0,o.exports}var n={};return t.m=e,t.c=n,t.p="/filterer/",t(0)}(function(e){for(var t in e)if(Object.prototype.hasOwnProperty.call(e,t))switch(typeof e[t]){case"function":break;case"object":e[t]=function(t){var n=t.slice(1),r=e[t[0]];return function(e,t,o){r.apply(this,[e,t,o].concat(n))}}(e[t]);break;default:e[t]=e[e[t]]}return e}([function(e,t,n){n(188),e.exports=n(94)},function(e,t,n){"use strict";function r(e,t,n,r,i,a,s,u){if(o(t),!e){var l;if(void 0===t)l=new Error("Minified exception occurred; use the non-minified dev environment for the full error message and additional helpful warnings.");else{var c=[n,r,i,a,s,u],p=0;l=new Error(t.replace(/%s/g,function(){return c[p++]})),l.name="Invariant Violation"}throw l.framesToPop=1,l}}var o=function(e){};e.exports=r},function(e,t,n){"use strict";var r=n(8),o=r;e.exports=o},function(e,t){"use strict";function n(e){for(var t=arguments.length-1,n="Minified React error #"+e+"; visit http://facebook.github.io/react/docs/error-decoder.html?invariant="+e,r=0;r<t;r++)n+="&args[]="+encodeURIComponent(arguments[r+1]);n+=" for the full message or use the non-minified dev environment for full errors and additional helpful warnings.";var o=new Error(n);throw o.name="Invariant Violation",o.framesToPop=1,o}e.exports=n},function(e,t){"use strict";function n(e){if(null===e||void 0===e)throw new TypeError("Object.assign cannot be called with null or undefined");return Object(e)}function r(){try{if(!Object.assign)return!1;var e=new String("abc");if(e[5]="de","5"===Object.getOwnPropertyNames(e)[0])return!1;for(var t={},n=0;n<10;n++)t["_"+String.fromCharCode(n)]=n;var r=Object.getOwnPropertyNames(t).map(function(e){return t[e]});if("0123456789"!==r.join(""))return!1;var o={};return"abcdefghijklmnopqrst".split("").forEach(function(e){o[e]=e}),"abcdefghijklmnopqrst"===Object.keys(Object.assign({},o)).join("")}catch(e){return!1}}var o=Object.getOwnPropertySymbols,i=Object.prototype.hasOwnProperty,a=Object.prototype.propertyIsEnumerable;e.exports=r()?Object.assign:function(e,t){for(var r,s,u=n(e),l=1;l<arguments.length;l++){r=Object(arguments[l]);for(var c in r)i.call(r,c)&&(u[c]=r[c]);if(o){s=o(r);for(var p=0;p<s.length;p++)a.call(r,s[p])&&(u[s[p]]=r[s[p]])}}return u}},function(e,t,n){"use strict";e.exports=n(20)},function(e,t,n){"use strict";function r(e,t){return 1===e.nodeType&&e.getAttribute(h)===String(t)||8===e.nodeType&&e.nodeValue===" react-text: "+t+" "||8===e.nodeType&&e.nodeValue===" react-empty: "+t+" "}function o(e){for(var t;t=e._renderedComponent;)e=t;return e}function i(e,t){var n=o(e);n._hostNode=t,t[v]=n}function a(e){var t=e._hostNode;t&&(delete t[v],e._hostNode=null)}function s(e,t){if(!(e._flags&m.hasCachedChildNodes)){var n=e._renderedChildren,a=t.firstChild;e:for(var s in n)if(n.hasOwnProperty(s)){var u=n[s],l=o(u)._domID;if(0!==l){for(;null!==a;a=a.nextSibling)if(r(a,l)){i(u,a);continue e}p("32",l)}}e._flags|=m.hasCachedChildNodes}}function u(e){if(e[v])return e[v];for(var t=[];!e[v];){if(t.push(e),!e.parentNode)return null;e=e.parentNode}for(var n,r;e&&(r=e[v]);e=t.pop())n=r,t.length&&s(r,e);return n}function l(e){var t=u(e);return null!=t&&t._hostNode===e?t:null}function c(e){if(void 0===e._hostNode?p("33"):void 0,e._hostNode)return e._hostNode;for(var t=[];!e._hostNode;)t.push(e),e._hostParent?void 0:p("34"),e=e._hostParent;for(;t.length;e=t.pop())s(e,e._hostNode);return e._hostNode}var p=n(3),f=n(18),d=n(67),h=(n(1),f.ID_ATTRIBUTE_NAME),m=d,v="__reactInternalInstance$"+Math.random().toString(36).slice(2),g={getClosestInstanceFromNode:u,getInstanceFromNode:l,getNodeFromInstance:c,precacheChildNodes:s,precacheNode:i,uncacheNode:a};e.exports=g},function(e,t){"use strict";var n=!("undefined"==typeof window||!window.document||!window.document.createElement),r={canUseDOM:n,canUseWorkers:"undefined"!=typeof Worker,canUseEventListeners:n&&!(!window.addEventListener&&!window.attachEvent),canUseViewport:n&&!!window.screen,isInWorker:!n};e.exports=r},function(e,t){"use strict";function n(e){return function(){return e}}var r=function(){};r.thatReturns=n,r.thatReturnsFalse=n(!1),r.thatReturnsTrue=n(!0),r.thatReturnsNull=n(null),r.thatReturnsThis=function(){return this},r.thatReturnsArgument=function(e){return e},e.exports=r},function(e,t,n){"use strict";var r=null;e.exports={debugTool:r}},function(e,t,n){"use strict";function r(){P.ReactReconcileTransaction&&_?void 0:c("123")}function o(){this.reinitializeTransaction(),this.dirtyComponentsLength=null,this.callbackQueue=f.getPooled(),this.reconcileTransaction=P.ReactReconcileTransaction.getPooled(!0)}function i(e,t,n,o,i,a){return r(),_.batchedUpdates(e,t,n,o,i,a)}function a(e,t){return e._mountOrder-t._mountOrder}function s(e){var t=e.dirtyComponentsLength;t!==g.length?c("124",t,g.length):void 0,g.sort(a),y++;for(var n=0;n<t;n++){var r=g[n],o=r._pendingCallbacks;r._pendingCallbacks=null;var i;if(h.logTopLevelRenders){var s=r;r._currentElement.type.isReactTopLevelWrapper&&(s=r._renderedComponent),i="React update: "+s.getName(),console.time(i)}if(m.performUpdateIfNecessary(r,e.reconcileTransaction,y),i&&console.timeEnd(i),o)for(var u=0;u<o.length;u++)e.callbackQueue.enqueue(o[u],r.getPublicInstance())}}function u(e){return r(),_.isBatchingUpdates?(g.push(e),void(null==e._updateBatchNumber&&(e._updateBatchNumber=y+1))):void _.batchedUpdates(u,e)}function l(e,t){_.isBatchingUpdates?void 0:c("125"),b.enqueue(e,t),C=!0}var c=n(3),p=n(4),f=n(65),d=n(14),h=n(70),m=n(19),v=n(31),g=(n(1),[]),y=0,b=f.getPooled(),C=!1,_=null,w={initialize:function(){this.dirtyComponentsLength=g.length},close:function(){this.dirtyComponentsLength!==g.length?(g.splice(0,this.dirtyComponentsLength),x()):g.length=0}},E={initialize:function(){this.callbackQueue.reset()},close:function(){this.callbackQueue.notifyAll()}},T=[w,E];p(o.prototype,v,{getTransactionWrappers:function(){return T},destructor:function(){this.dirtyComponentsLength=null,f.release(this.callbackQueue),this.callbackQueue=null,P.ReactReconcileTransaction.release(this.reconcileTransaction),this.reconcileTransaction=null},perform:function(e,t,n){return v.perform.call(this,this.reconcileTransaction.perform,this.reconcileTransaction,e,t,n)}}),d.addPoolingTo(o);var x=function(){for(;g.length||C;){if(g.length){var e=o.getPooled();e.perform(s,null,e),o.release(e)}if(C){C=!1;var t=b;b=f.getPooled(),t.notifyAll(),f.release(t)}}},O={injectReconcileTransaction:function(e){e?void 0:c("126"),P.ReactReconcileTransaction=e},injectBatchingStrategy:function(e){e?void 0:c("127"),"function"!=typeof e.batchedUpdates?c("128"):void 0,"boolean"!=typeof e.isBatchingUpdates?c("129"):void 0,_=e}},P={ReactReconcileTransaction:null,batchedUpdates:i,enqueueUpdate:u,flushBatchedUpdates:x,injection:O,asap:l};e.exports=P},function(e,t,n){"use strict";function r(e,t,n,r){this.dispatchConfig=e,this._targetInst=t,this.nativeEvent=n;var o=this.constructor.Interface;for(var i in o)if(o.hasOwnProperty(i)){var s=o[i];s?this[i]=s(n):"target"===i?this.target=r:this[i]=n[i]}var u=null!=n.defaultPrevented?n.defaultPrevented:n.returnValue===!1;return u?this.isDefaultPrevented=a.thatReturnsTrue:this.isDefaultPrevented=a.thatReturnsFalse,this.isPropagationStopped=a.thatReturnsFalse,this}var o=n(4),i=n(14),a=n(8),s=(n(2),"function"==typeof Proxy,["dispatchConfig","_targetInst","nativeEvent","isDefaultPrevented","isPropagationStopped","_dispatchListeners","_dispatchInstances"]),u={type:null,target:null,currentTarget:a.thatReturnsNull,eventPhase:null,bubbles:null,cancelable:null,timeStamp:function(e){return e.timeStamp||Date.now()},defaultPrevented:null,isTrusted:null};o(r.prototype,{preventDefault:function(){this.defaultPrevented=!0;var e=this.nativeEvent;e&&(e.preventDefault?e.preventDefault():"unknown"!=typeof e.returnValue&&(e.returnValue=!1),this.isDefaultPrevented=a.thatReturnsTrue)},stopPropagation:function(){var e=this.nativeEvent;e&&(e.stopPropagation?e.stopPropagation():"unknown"!=typeof e.cancelBubble&&(e.cancelBubble=!0),this.isPropagationStopped=a.thatReturnsTrue)},persist:function(){this.isPersistent=a.thatReturnsTrue},isPersistent:a.thatReturnsFalse,destructor:function(){var e=this.constructor.Interface;for(var t in e)this[t]=null;for(var n=0;n<s.length;n++)this[s[n]]=null}}),r.Interface=u,r.augmentClass=function(e,t){var n=this,r=function(){};r.prototype=n.prototype;var a=new r;o(a,e.prototype),e.prototype=a,e.prototype.constructor=e,e.Interface=o({},n.Interface,t),e.augmentClass=n.augmentClass,i.addPoolingTo(e,i.fourArgumentPooler)},i.addPoolingTo(r,i.fourArgumentPooler),e.exports=r},function(e,t){"use strict";var n={current:null};e.exports=n},function(e,t,n){"use strict";e.exports=n(138)},[228,3],[227,189,190,192,193,191],function(e,t,n){(function(){function t(e,t){var n,r=function(o){return e.length>1?function(){var i=o?o.concat():[];return n=t?n||this:this,i.push.apply(i,arguments)<e.length&&arguments.length?r.call(n,i):e.apply(n,i)}:e};return r()}function r(e,t){var n={}.hasOwnProperty;for(var r in t)n.call(t,r)&&(e[r]=t[r]);return e}var o,i,a,s,u,l,c,p,f,d,h,m,v,g,y,b,C,_,w,E,T,x,O,P,k,S,N=[].slice,M={}.toString;o=n(118),i=o.all,a=o.any,s=o.concatMap,u=o.each,l=o.filter,c=o.find,p=o.isType,f=o.keys,d=o.map,h=o.Obj,m=o.objToPairs,v=o.partition,g=o.reverse,y=o.sortBy,b=t(function(e,t,n){return Math.max(t,Math.min(n,e))}),C=t(function(e,t,n){var r;return r=e.substr(n).indexOf(t),r===-1?[]:[n+r].concat(C(e,t,n+r+t.length))}),_=t(function(e,t){var n,r,o;return n=t[0],r=N.call(t,1),0===r.length?null!=(o=e[n])?o:null:"undefined"==typeof e[n]?null:_(e[n],r)}),w=function(e){var t;return t=function(e){return e.length}(f(h.filter(function(e){return!!e})(e))),0===t},E=t(function(e,t){return M.call(e).slice(8,-1)===M.call(t).slice(8,-1)&&(a(function(t){return p(t,e)})(["Boolean","Number","String","undefined"])?e===t:"Array"===M.call(e).slice(8,-1)?e.length===t.length&&i(function(n){return E(e[n],t[n])})(function(){var t,n,r=[];for(t=0,n=e.length;t<n;++t)r.push(t);return r}()):f(e).length===f(t).length&&i(function(n){return E(e[n],t[n])})(f(e)))}),T=t(function(e,t){var n,r,o,i,a,s;return 0===t.length?[[0,e.length]]:(n=C(e,t,0),r=n[0],o=n[n.length-1],0===n.length?[]:(i=o+t.length,a=d(function(e){return[e,e+t.length,!0]})(n),s=d(function(e){return[a[e][1],a[e+1][0],!1]})(function(){var e,t,n=[];for(e=0,t=a.length-1;e<t;++e)n.push(e);return n}()),(0===r?[]:[[0,r,!1]]).concat(y(function(e){return e[0]})(a.concat(s)),i===e.length?[]:[[i,e.length,!1]])))}),x=t(function(e,t,n,r){var o;return o=_(e,t),P(e,t,o?r(o,n):n)}),O=t(function(e,t){var n,o;return n=M.call(t).slice(8,-1),a(function(e){return e===n},["Boolean","Number","String","Function"])?t:null===e||"Undefined"===M.call(e).slice(8,-1)?t:(o=h.keys(t),0===o.length?e:(u(function(n){return e[n]=O(h.keys(e[n]).length>0?r({},e[n]):e[n],t[n])})(o),e))}),P=t(function(e,t,n){var r,o,i;return r=t[0],o=N.call(t,1),o.length>0?(e[r]=null!=(i=e[r])?i:{},P(e[r],o,n)):(e[r]=n,e)}),k=function(e){return d(function(t){return d(function(e){return e[t]})(e)})(f(e[0]))},S=t(function(e,n,r){var o;return(o=t(function(e,t,n,r,i){return s(function(i){var a,s;return a=i[0],s=i[1],n<r?o(e,t.concat(a),n+1,r,s):e(t.concat(a),s)})(m(i))}))(e,[],0,n,r)}),e.exports={clamp:b,findAll:C,get:_,isEmptyObject:w,isEqualToObject:E,mappend:x,partitionString:T,rextend:O,set:P,transpose:k,unwrap:S}}).call(this)},function(e,t,n){"use strict";function r(e){if(v){var t=e.node,n=e.children;if(n.length)for(var r=0;r<n.length;r++)g(t,n[r],null);else null!=e.html?p(t,e.html):null!=e.text&&d(t,e.text)}}function o(e,t){e.parentNode.replaceChild(t.node,e),r(t)}function i(e,t){v?e.children.push(t):e.node.appendChild(t.node)}function a(e,t){v?e.html=t:p(e.node,t)}function s(e,t){v?e.text=t:d(e.node,t)}function u(){return this.node.nodeName}function l(e){return{node:e,children:[],html:null,text:null,toString:u}}var c=n(38),p=n(33),f=n(46),d=n(82),h=1,m=11,v="undefined"!=typeof document&&"number"==typeof document.documentMode||"undefined"!=typeof navigator&&"string"==typeof navigator.userAgent&&/\bEdge\/\d/.test(navigator.userAgent),g=f(function(e,t,n){t.node.nodeType===m||t.node.nodeType===h&&"object"===t.node.nodeName.toLowerCase()&&(null==t.node.namespaceURI||t.node.namespaceURI===c.html)?(r(t),e.insertBefore(t.node,n)):(e.insertBefore(t.node,n),r(t))});l.insertTreeBefore=g,l.replaceChildWithTree=o,l.queueChild=i,l.queueHTML=a,l.queueText=s,e.exports=l},function(e,t,n){"use strict";function r(e,t){return(e&t)===t}var o=n(3),i=(n(1),{MUST_USE_PROPERTY:1,HAS_BOOLEAN_VALUE:4,HAS_NUMERIC_VALUE:8,HAS_POSITIVE_NUMERIC_VALUE:24,HAS_OVERLOADED_BOOLEAN_VALUE:32,injectDOMPropertyConfig:function(e){var t=i,n=e.Properties||{},a=e.DOMAttributeNamespaces||{},u=e.DOMAttributeNames||{},l=e.DOMPropertyNames||{},c=e.DOMMutationMethods||{};e.isCustomAttribute&&s._isCustomAttributeFunctions.push(e.isCustomAttribute);for(var p in n){s.properties.hasOwnProperty(p)?o("48",p):void 0;var f=p.toLowerCase(),d=n[p],h={attributeName:f,attributeNamespace:null,propertyName:p,mutationMethod:null,mustUseProperty:r(d,t.MUST_USE_PROPERTY),hasBooleanValue:r(d,t.HAS_BOOLEAN_VALUE),hasNumericValue:r(d,t.HAS_NUMERIC_VALUE),hasPositiveNumericValue:r(d,t.HAS_POSITIVE_NUMERIC_VALUE),hasOverloadedBooleanValue:r(d,t.HAS_OVERLOADED_BOOLEAN_VALUE)};if(h.hasBooleanValue+h.hasNumericValue+h.hasOverloadedBooleanValue<=1?void 0:o("50",p),u.hasOwnProperty(p)){var m=u[p];h.attributeName=m}a.hasOwnProperty(p)&&(h.attributeNamespace=a[p]),l.hasOwnProperty(p)&&(h.propertyName=l[p]),c.hasOwnProperty(p)&&(h.mutationMethod=c[p]),s.properties[p]=h}}}),a=":A-Z_a-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD",s={ID_ATTRIBUTE_NAME:"data-reactid",ROOT_ATTRIBUTE_NAME:"data-reactroot",ATTRIBUTE_NAME_START_CHAR:a,ATTRIBUTE_NAME_CHAR:a+"\\-.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040",properties:{},getPossibleStandardName:null,_isCustomAttributeFunctions:[],isCustomAttribute:function(e){for(var t=0;t<s._isCustomAttributeFunctions.length;t++){var n=s._isCustomAttributeFunctions[t];if(n(e))return!0}return!1},injection:i};e.exports=s},function(e,t,n){"use strict";function r(){o.attachRefs(this,this._currentElement)}var o=n(161),i=(n(9),n(2),{mountComponent:function(e,t,n,o,i,a){var s=e.mountComponent(t,n,o,i,a);return e._currentElement&&null!=e._currentElement.ref&&t.getReactMountReady().enqueue(r,e),s},getHostNode:function(e){return e.getHostNode()},unmountComponent:function(e,t){o.detachRefs(e,e._currentElement),e.unmountComponent(t)},receiveComponent:function(e,t,n,i){var a=e._currentElement;if(t!==a||i!==e._context){var s=o.shouldUpdateRefs(a,t);s&&o.detachRefs(e,a),e.receiveComponent(t,n,i),s&&e._currentElement&&null!=e._currentElement.ref&&n.getReactMountReady().enqueue(r,e)}},performUpdateIfNecessary:function(e,t,n){e._updateBatchNumber===n&&e.performUpdateIfNecessary(t)}});e.exports=i},function(e,t,n){"use strict";var r=n(4),o=n(213),i=n(54),a=n(218),s=n(214),u=n(215),l=n(21),c=n(217),p=n(219),f=n(222),d=(n(2),l.createElement),h=l.createFactory,m=l.cloneElement,v=r,g={Children:{map:o.map,forEach:o.forEach,count:o.count,toArray:o.toArray,only:f},Component:i,PureComponent:a,createElement:d,cloneElement:m,isValidElement:l.isValidElement,PropTypes:c,createClass:s.createClass,createFactory:h,createMixin:function(e){return e},DOM:u,version:p,__spread:v};e.exports=g},function(e,t,n){"use strict";function r(e){return void 0!==e.ref}function o(e){return void 0!==e.key}var i=n(4),a=n(12),s=(n(2),n(89),Object.prototype.hasOwnProperty),u=n(88),l={key:!0,ref:!0,__self:!0,__source:!0},c=function(e,t,n,r,o,i,a){var s={$$typeof:u,type:e,key:t,ref:n,props:a,_owner:i};return s};c.createElement=function(e,t,n){var i,u={},p=null,f=null,d=null,h=null;if(null!=t){r(t)&&(f=t.ref),o(t)&&(p=""+t.key),d=void 0===t.__self?null:t.__self,h=void 0===t.__source?null:t.__source;for(i in t)s.call(t,i)&&!l.hasOwnProperty(i)&&(u[i]=t[i])}var m=arguments.length-2;if(1===m)u.children=n;else if(m>1){for(var v=Array(m),g=0;g<m;g++)v[g]=arguments[g+2];u.children=v}if(e&&e.defaultProps){var y=e.defaultProps;for(i in y)void 0===u[i]&&(u[i]=y[i])}return c(e,p,f,d,h,a.current,u)},c.createFactory=function(e){var t=c.createElement.bind(null,e);return t.type=e,t},c.cloneAndReplaceKey=function(e,t){var n=c(e.type,t,e.ref,e._self,e._source,e._owner,e.props);return n},c.cloneElement=function(e,t,n){var u,p=i({},e.props),f=e.key,d=e.ref,h=e._self,m=e._source,v=e._owner;if(null!=t){r(t)&&(d=t.ref,v=a.current),o(t)&&(f=""+t.key);var g;e.type&&e.type.defaultProps&&(g=e.type.defaultProps);for(u in t)s.call(t,u)&&!l.hasOwnProperty(u)&&(void 0===t[u]&&void 0!==g?p[u]=g[u]:p[u]=t[u])}var y=arguments.length-2;if(1===y)p.children=n;else if(y>1){for(var b=Array(y),C=0;C<y;C++)b[C]=arguments[C+2];p.children=b}return c(e.type,f,d,h,m,v,p)},c.isValidElement=function(e){return"object"==typeof e&&null!==e&&e.$$typeof===u},e.exports=c},3,function(e,t,n){"use strict";var r={};e.exports=r},function(e,t,n){"use strict";function r(e){return"button"===e||"input"===e||"select"===e||"textarea"===e}function o(e,t,n){switch(e){case"onClick":case"onClickCapture":case"onDoubleClick":case"onDoubleClickCapture":case"onMouseDown":case"onMouseDownCapture":case"onMouseMove":case"onMouseMoveCapture":case"onMouseUp":case"onMouseUpCapture":return!(!n.disabled||!r(t));default:return!1}}var i=n(3),a=n(39),s=n(40),u=n(44),l=n(76),c=n(77),p=(n(1),{}),f=null,d=function(e,t){e&&(s.executeDispatchesInOrder(e,t),e.isPersistent()||e.constructor.release(e))},h=function(e){return d(e,!0)},m=function(e){return d(e,!1)},v=function(e){return"."+e._rootNodeID},g={injection:{injectEventPluginOrder:a.injectEventPluginOrder,injectEventPluginsByName:a.injectEventPluginsByName},putListener:function(e,t,n){"function"!=typeof n?i("94",t,typeof n):void 0;var r=v(e),o=p[t]||(p[t]={});o[r]=n;var s=a.registrationNameModules[t];s&&s.didPutListener&&s.didPutListener(e,t,n)},getListener:function(e,t){var n=p[t];if(o(t,e._currentElement.type,e._currentElement.props))return null;var r=v(e);return n&&n[r]},deleteListener:function(e,t){var n=a.registrationNameModules[t];n&&n.willDeleteListener&&n.willDeleteListener(e,t);var r=p[t];if(r){var o=v(e);delete r[o]}},deleteAllListeners:function(e){var t=v(e);for(var n in p)if(p.hasOwnProperty(n)&&p[n][t]){var r=a.registrationNameModules[n];r&&r.willDeleteListener&&r.willDeleteListener(e,n),delete p[n][t]}},extractEvents:function(e,t,n,r){for(var o,i=a.plugins,s=0;s<i.length;s++){var u=i[s];if(u){var c=u.extractEvents(e,t,n,r);c&&(o=l(o,c))}}return o},enqueueEvents:function(e){e&&(f=l(f,e))},processEventQueue:function(e){var t=f;f=null,e?c(t,h):c(t,m),f?i("95"):void 0,u.rethrowCaughtError()},__purge:function(){p={}},__getListenerBank:function(){return p}};e.exports=g},function(e,t,n){"use strict";function r(e,t,n){var r=t.dispatchConfig.phasedRegistrationNames[n];return g(e,r)}function o(e,t,n){var o=r(e,n,t);o&&(n._dispatchListeners=m(n._dispatchListeners,o),n._dispatchInstances=m(n._dispatchInstances,e))}function i(e){e&&e.dispatchConfig.phasedRegistrationNames&&h.traverseTwoPhase(e._targetInst,o,e)}function a(e){if(e&&e.dispatchConfig.phasedRegistrationNames){var t=e._targetInst,n=t?h.getParentInstance(t):null;h.traverseTwoPhase(n,o,e)}}function s(e,t,n){if(n&&n.dispatchConfig.registrationName){var r=n.dispatchConfig.registrationName,o=g(e,r);o&&(n._dispatchListeners=m(n._dispatchListeners,o),n._dispatchInstances=m(n._dispatchInstances,e))}}function u(e){e&&e.dispatchConfig.registrationName&&s(e._targetInst,null,e)}function l(e){v(e,i)}function c(e){v(e,a)}function p(e,t,n,r){h.traverseEnterLeave(n,r,s,e,t)}function f(e){v(e,u)}var d=n(24),h=n(40),m=n(76),v=n(77),g=(n(2),d.getListener),y={accumulateTwoPhaseDispatches:l,accumulateTwoPhaseDispatchesSkipTarget:c,accumulateDirectDispatches:f,accumulateEnterLeaveDispatches:p};e.exports=y},function(e,t){"use strict";var n={remove:function(e){e._reactInternalInstance=void 0},get:function(e){return e._reactInternalInstance},has:function(e){return void 0!==e._reactInternalInstance},set:function(e,t){e._reactInternalInstance=t}};e.exports=n},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(11),i=n(49),a={view:function(e){if(e.view)return e.view;var t=i(e);if(t.window===t)return t;var n=t.ownerDocument;return n?n.defaultView||n.parentWindow:window},detail:function(e){return e.detail||0}};o.augmentClass(r,a),e.exports=r},function(e,t,n){(function(){var e,r,o,i,a,s,u,l="undefined"!=typeof t&&t||this;e=n(15),r=e.filter,o=e.map,i=e.objToPairs,a=e.Str,l.cancelEvent=s=function(e){e.preventDefault(),e.stopPropagation()},l.classNameFromObject=u=function(e){return a.join(" ")(o(function(e){return e[0]})(r(function(e){return!!e[1]})(i(e))))}}).call(this)},function(e,t,n){"use strict";function r(e){return Object.prototype.hasOwnProperty.call(e,m)||(e[m]=d++,p[e[m]]={}),p[e[m]]}var o,i=n(4),a=n(39),s=n(153),u=n(75),l=n(185),c=n(50),p={},f=!1,d=0,h={topAbort:"abort",topAnimationEnd:l("animationend")||"animationend",topAnimationIteration:l("animationiteration")||"animationiteration",topAnimationStart:l("animationstart")||"animationstart",topBlur:"blur",topCanPlay:"canplay",topCanPlayThrough:"canplaythrough",topChange:"change",topClick:"click",topCompositionEnd:"compositionend",topCompositionStart:"compositionstart",topCompositionUpdate:"compositionupdate",topContextMenu:"contextmenu",topCopy:"copy",topCut:"cut",topDoubleClick:"dblclick",topDrag:"drag",topDragEnd:"dragend",topDragEnter:"dragenter",topDragExit:"dragexit",topDragLeave:"dragleave",topDragOver:"dragover",topDragStart:"dragstart",topDrop:"drop",topDurationChange:"durationchange",topEmptied:"emptied",topEncrypted:"encrypted",topEnded:"ended",topError:"error",topFocus:"focus",topInput:"input",topKeyDown:"keydown",topKeyPress:"keypress",topKeyUp:"keyup",topLoadedData:"loadeddata",topLoadedMetadata:"loadedmetadata",topLoadStart:"loadstart",topMouseDown:"mousedown",topMouseMove:"mousemove",topMouseOut:"mouseout",topMouseOver:"mouseover",topMouseUp:"mouseup",topPaste:"paste",topPause:"pause",topPlay:"play",topPlaying:"playing",topProgress:"progress",topRateChange:"ratechange",topScroll:"scroll",topSeeked:"seeked",topSeeking:"seeking",topSelectionChange:"selectionchange",topStalled:"stalled",topSuspend:"suspend",topTextInput:"textInput",topTimeUpdate:"timeupdate",topTouchCancel:"touchcancel",topTouchEnd:"touchend",topTouchMove:"touchmove",topTouchStart:"touchstart",topTransitionEnd:l("transitionend")||"transitionend",topVolumeChange:"volumechange",topWaiting:"waiting",topWheel:"wheel"},m="_reactListenersID"+String(Math.random()).slice(2),v=i({},s,{ReactEventListener:null,injection:{injectReactEventListener:function(e){e.setHandleTopLevel(v.handleTopLevel),v.ReactEventListener=e}},setEnabled:function(e){v.ReactEventListener&&v.ReactEventListener.setEnabled(e)},isEnabled:function(){return!(!v.ReactEventListener||!v.ReactEventListener.isEnabled())},listenTo:function(e,t){for(var n=t,o=r(n),i=a.registrationNameDependencies[e],s=0;s<i.length;s++){var u=i[s];o.hasOwnProperty(u)&&o[u]||("topWheel"===u?c("wheel")?v.ReactEventListener.trapBubbledEvent("topWheel","wheel",n):c("mousewheel")?v.ReactEventListener.trapBubbledEvent("topWheel","mousewheel",n):v.ReactEventListener.trapBubbledEvent("topWheel","DOMMouseScroll",n):"topScroll"===u?c("scroll",!0)?v.ReactEventListener.trapCapturedEvent("topScroll","scroll",n):v.ReactEventListener.trapBubbledEvent("topScroll","scroll",v.ReactEventListener.WINDOW_HANDLE):"topFocus"===u||"topBlur"===u?(c("focus",!0)?(v.ReactEventListener.trapCapturedEvent("topFocus","focus",n),v.ReactEventListener.trapCapturedEvent("topBlur","blur",n)):c("focusin")&&(v.ReactEventListener.trapBubbledEvent("topFocus","focusin",n),v.ReactEventListener.trapBubbledEvent("topBlur","focusout",n)),o.topBlur=!0,o.topFocus=!0):h.hasOwnProperty(u)&&v.ReactEventListener.trapBubbledEvent(u,h[u],n),o[u]=!0)}},trapBubbledEvent:function(e,t,n){return v.ReactEventListener.trapBubbledEvent(e,t,n)},trapCapturedEvent:function(e,t,n){return v.ReactEventListener.trapCapturedEvent(e,t,n)},supportsEventPageXY:function(){if(!document.createEvent)return!1;var e=document.createEvent("MouseEvent");return null!=e&&"pageX"in e},ensureScrollValueMonitoring:function(){if(void 0===o&&(o=v.supportsEventPageXY()),!o&&!f){var e=u.refreshScrollValues;v.ReactEventListener.monitorScrollValue(e),f=!0}}});e.exports=v},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(27),i=n(75),a=n(48),s={screenX:null,screenY:null,clientX:null,clientY:null,ctrlKey:null,shiftKey:null,altKey:null,metaKey:null,getModifierState:a,button:function(e){var t=e.button;return"which"in e?t:2===t?2:4===t?1:0},buttons:null,relatedTarget:function(e){return e.relatedTarget||(e.fromElement===e.srcElement?e.toElement:e.fromElement)},pageX:function(e){return"pageX"in e?e.pageX:e.clientX+i.currentScrollLeft},pageY:function(e){return"pageY"in e?e.pageY:e.clientY+i.currentScrollTop}};o.augmentClass(r,s),e.exports=r},function(e,t,n){"use strict";var r=n(3),o=(n(1),{}),i={reinitializeTransaction:function(){this.transactionWrappers=this.getTransactionWrappers(),this.wrapperInitData?this.wrapperInitData.length=0:this.wrapperInitData=[],this._isInTransaction=!1},_isInTransaction:!1,getTransactionWrappers:null,isInTransaction:function(){return!!this._isInTransaction},perform:function(e,t,n,o,i,a,s,u){this.isInTransaction()?r("27"):void 0;var l,c;try{this._isInTransaction=!0,l=!0,this.initializeAll(0),c=e.call(t,n,o,i,a,s,u),l=!1}finally{try{if(l)try{this.closeAll(0)}catch(e){}else this.closeAll(0)}finally{this._isInTransaction=!1}}return c},initializeAll:function(e){for(var t=this.transactionWrappers,n=e;n<t.length;n++){var r=t[n];try{this.wrapperInitData[n]=o,this.wrapperInitData[n]=r.initialize?r.initialize.call(this):null}finally{if(this.wrapperInitData[n]===o)try{this.initializeAll(n+1)}catch(e){}}}},closeAll:function(e){this.isInTransaction()?void 0:r("28");for(var t=this.transactionWrappers,n=e;n<t.length;n++){var i,a=t[n],s=this.wrapperInitData[n];try{i=!0,s!==o&&a.close&&a.close.call(this,s),i=!1}finally{if(i)try{this.closeAll(n+1)}catch(e){}}}this.wrapperInitData.length=0}};e.exports=i},function(e,t){"use strict";function n(e){var t=""+e,n=o.exec(t);if(!n)return t;var r,i="",a=0,s=0;for(a=n.index;a<t.length;a++){switch(t.charCodeAt(a)){case 34:r="&quot;";break;case 38:r="&amp;";break;case 39:r="&#x27;";break;case 60:r="&lt;";break;case 62:r="&gt;";break;default:continue}s!==a&&(i+=t.substring(s,a)),s=a+1,i+=r}return s!==a?i+t.substring(s,a):i}function r(e){return"boolean"==typeof e||"number"==typeof e?""+e:n(e)}var o=/["'&<>]/;e.exports=r},function(e,t,n){"use strict";var r,o=n(7),i=n(38),a=/^[ \r\n\t\f]/,s=/<(!--|link|noscript|meta|script|style)[ \r\n\t\f\/>]/,u=n(46),l=u(function(e,t){if(e.namespaceURI!==i.svg||"innerHTML"in e)e.innerHTML=t;else{r=r||document.createElement("div"),r.innerHTML="<svg>"+t+"</svg>";for(var n=r.firstChild;n.firstChild;)e.appendChild(n.firstChild)}});if(o.canUseDOM){var c=document.createElement("div");c.innerHTML=" ",""===c.innerHTML&&(l=function(e,t){if(e.parentNode&&e.parentNode.replaceChild(e,e),a.test(t)||"<"===t[0]&&s.test(t)){e.innerHTML=String.fromCharCode(65279)+t;var n=e.firstChild;1===n.data.length?e.removeChild(n):n.deleteData(0,1)}else e.innerHTML=t}),c=null}e.exports=l},function(e,t,n){e.exports=n(208)()},function(e,t){function n(e){return e&&e.__esModule?e:{default:e}}e.exports=n,e.exports.__esModule=!0,e.exports.default=e.exports},function(e,t){"use strict";function n(e,t){return e===t?0!==e||0!==t||1/e===1/t:e!==e&&t!==t}function r(e,t){if(n(e,t))return!0;if("object"!=typeof e||null===e||"object"!=typeof t||null===t)return!1;var r=Object.keys(e),i=Object.keys(t);if(r.length!==i.length)return!1;for(var a=0;a<r.length;a++)if(!o.call(t,r[a])||!n(e[r[a]],t[r[a]]))return!1;return!0}var o=Object.prototype.hasOwnProperty;e.exports=r},function(e,t,n){"use strict";function r(e,t){return Array.isArray(t)&&(t=t[1]),t?t.nextSibling:e.firstChild}function o(e,t,n){c.insertTreeBefore(e,t,n)}function i(e,t,n){Array.isArray(t)?s(e,t[0],t[1],n):m(e,t,n)}function a(e,t){if(Array.isArray(t)){var n=t[1];t=t[0],u(e,t,n),e.removeChild(n)}e.removeChild(t)}function s(e,t,n,r){for(var o=t;;){var i=o.nextSibling;if(m(e,o,r),o===n)break;o=i}}function u(e,t,n){for(;;){var r=t.nextSibling;if(r===n)break;e.removeChild(r)}}function l(e,t,n){var r=e.parentNode,o=e.nextSibling;o===t?n&&m(r,document.createTextNode(n),o):n?(h(o,n),u(r,o,t)):u(r,e,t)}var c=n(17),p=n(130),f=(n(6),n(9),n(46)),d=n(33),h=n(82),m=f(function(e,t,n){e.insertBefore(t,n)}),v=p.dangerouslyReplaceNodeWithMarkup,g={dangerouslyReplaceNodeWithMarkup:v,replaceDelimitedText:l,processUpdates:function(e,t){for(var n=0;n<t.length;n++){var s=t[n];switch(s.type){case"INSERT_MARKUP":o(e,s.content,r(e,s.afterNode));break;case"MOVE_EXISTING":i(e,s.fromNode,r(e,s.afterNode));break;case"SET_MARKUP":d(e,s.content);break;case"TEXT_CONTENT":h(e,s.content);break;case"REMOVE_NODE":a(e,s.fromNode)}}}};e.exports=g},function(e,t){"use strict";var n={html:"http://www.w3.org/1999/xhtml",mathml:"http://www.w3.org/1998/Math/MathML",svg:"http://www.w3.org/2000/svg"};e.exports=n},function(e,t,n){"use strict";function r(){if(s)for(var e in u){var t=u[e],n=s.indexOf(e);if(n>-1?void 0:a("96",e),!l.plugins[n]){t.extractEvents?void 0:a("97",e),l.plugins[n]=t;var r=t.eventTypes;for(var i in r)o(r[i],t,i)?void 0:a("98",i,e)}}}function o(e,t,n){l.eventNameDispatchConfigs.hasOwnProperty(n)?a("99",n):void 0,l.eventNameDispatchConfigs[n]=e;var r=e.phasedRegistrationNames;if(r){for(var o in r)if(r.hasOwnProperty(o)){var s=r[o];i(s,t,n)}return!0}return!!e.registrationName&&(i(e.registrationName,t,n),!0)}function i(e,t,n){l.registrationNameModules[e]?a("100",e):void 0,l.registrationNameModules[e]=t,l.registrationNameDependencies[e]=t.eventTypes[n].dependencies}var a=n(3),s=(n(1),null),u={},l={plugins:[],eventNameDispatchConfigs:{},registrationNameModules:{},registrationNameDependencies:{},possibleRegistrationNames:null,injectEventPluginOrder:function(e){s?a("101"):void 0,s=Array.prototype.slice.call(e),r()},injectEventPluginsByName:function(e){var t=!1;for(var n in e)if(e.hasOwnProperty(n)){var o=e[n];u.hasOwnProperty(n)&&u[n]===o||(u[n]?a("102",n):void 0,u[n]=o,t=!0)}t&&r()},getPluginModuleForEvent:function(e){var t=e.dispatchConfig;if(t.registrationName)return l.registrationNameModules[t.registrationName]||null;if(void 0!==t.phasedRegistrationNames){var n=t.phasedRegistrationNames;for(var r in n)if(n.hasOwnProperty(r)){var o=l.registrationNameModules[n[r]];if(o)return o}}return null},_resetEventPlugins:function(){s=null;for(var e in u)u.hasOwnProperty(e)&&delete u[e];l.plugins.length=0;var t=l.eventNameDispatchConfigs;for(var n in t)t.hasOwnProperty(n)&&delete t[n];var r=l.registrationNameModules;for(var o in r)r.hasOwnProperty(o)&&delete r[o]}};e.exports=l},function(e,t,n){"use strict";function r(e){return"topMouseUp"===e||"topTouchEnd"===e||"topTouchCancel"===e}function o(e){return"topMouseMove"===e||"topTouchMove"===e}function i(e){return"topMouseDown"===e||"topTouchStart"===e}function a(e,t,n,r){var o=e.type||"unknown-event";e.currentTarget=g.getNodeFromInstance(r),t?m.invokeGuardedCallbackWithCatch(o,n,e):m.invokeGuardedCallback(o,n,e),e.currentTarget=null}function s(e,t){var n=e._dispatchListeners,r=e._dispatchInstances;if(Array.isArray(n))for(var o=0;o<n.length&&!e.isPropagationStopped();o++)a(e,t,n[o],r[o]);else n&&a(e,t,n,r);e._dispatchListeners=null,e._dispatchInstances=null}function u(e){var t=e._dispatchListeners,n=e._dispatchInstances;if(Array.isArray(t)){for(var r=0;r<t.length&&!e.isPropagationStopped();r++)if(t[r](e,n[r]))return n[r]}else if(t&&t(e,n))return n;return null}function l(e){var t=u(e);return e._dispatchInstances=null,e._dispatchListeners=null,
 t}function c(e){var t=e._dispatchListeners,n=e._dispatchInstances;Array.isArray(t)?h("103"):void 0,e.currentTarget=t?g.getNodeFromInstance(n):null;var r=t?t(e):null;return e.currentTarget=null,e._dispatchListeners=null,e._dispatchInstances=null,r}function p(e){return!!e._dispatchListeners}var f,d,h=n(3),m=n(44),v=(n(1),n(2),{injectComponentTree:function(e){f=e},injectTreeTraversal:function(e){d=e}}),g={isEndish:r,isMoveish:o,isStartish:i,executeDirectDispatch:c,executeDispatchesInOrder:s,executeDispatchesInOrderStopAtTrue:l,hasDispatches:p,getInstanceFromNode:function(e){return f.getInstanceFromNode(e)},getNodeFromInstance:function(e){return f.getNodeFromInstance(e)},isAncestor:function(e,t){return d.isAncestor(e,t)},getLowestCommonAncestor:function(e,t){return d.getLowestCommonAncestor(e,t)},getParentInstance:function(e){return d.getParentInstance(e)},traverseTwoPhase:function(e,t,n){return d.traverseTwoPhase(e,t,n)},traverseEnterLeave:function(e,t,n,r,o){return d.traverseEnterLeave(e,t,n,r,o)},injection:v};e.exports=g},function(e,t){"use strict";function n(e){var t=/[=:]/g,n={"=":"=0",":":"=2"},r=(""+e).replace(t,function(e){return n[e]});return"$"+r}function r(e){var t=/(=0|=2)/g,n={"=0":"=","=2":":"},r="."===e[0]&&"$"===e[1]?e.substring(2):e.substring(1);return(""+r).replace(t,function(e){return n[e]})}var o={escape:n,unescape:r};e.exports=o},function(e,t,n){"use strict";function r(e){null!=e.checkedLink&&null!=e.valueLink?s("87"):void 0}function o(e){r(e),null!=e.value||null!=e.onChange?s("88"):void 0}function i(e){r(e),null!=e.checked||null!=e.onChange?s("89"):void 0}function a(e){if(e){var t=e.getName();if(t)return" Check the render method of `"+t+"`."}return""}var s=n(3),u=n(159),l=n(62),c=n(20),p=l(c.isValidElement),f=(n(1),n(2),{button:!0,checkbox:!0,image:!0,hidden:!0,radio:!0,reset:!0,submit:!0}),d={value:function(e,t,n){return!e[t]||f[e.type]||e.onChange||e.readOnly||e.disabled?null:new Error("You provided a `value` prop to a form field without an `onChange` handler. This will render a read-only field. If the field should be mutable use `defaultValue`. Otherwise, set either `onChange` or `readOnly`.")},checked:function(e,t,n){return!e[t]||e.onChange||e.readOnly||e.disabled?null:new Error("You provided a `checked` prop to a form field without an `onChange` handler. This will render a read-only field. If the field should be mutable use `defaultChecked`. Otherwise, set either `onChange` or `readOnly`.")},onChange:p.func},h={},m={checkPropTypes:function(e,t,n){for(var r in d){if(d.hasOwnProperty(r))var o=d[r](t,r,e,"prop",null,u);if(o instanceof Error&&!(o.message in h)){h[o.message]=!0;a(n)}}},getValue:function(e){return e.valueLink?(o(e),e.valueLink.value):e.value},getChecked:function(e){return e.checkedLink?(i(e),e.checkedLink.value):e.checked},executeOnChange:function(e,t){return e.valueLink?(o(e),e.valueLink.requestChange(t.target.value)):e.checkedLink?(i(e),e.checkedLink.requestChange(t.target.checked)):e.onChange?e.onChange.call(void 0,t):void 0}};e.exports=m},function(e,t,n){"use strict";var r=n(3),o=(n(1),!1),i={replaceNodeWithMarkup:null,processChildrenUpdates:null,injection:{injectEnvironment:function(e){o?r("104"):void 0,i.replaceNodeWithMarkup=e.replaceNodeWithMarkup,i.processChildrenUpdates=e.processChildrenUpdates,o=!0}}};e.exports=i},function(e,t,n){"use strict";function r(e,t,n){try{t(n)}catch(e){null===o&&(o=e)}}var o=null,i={invokeGuardedCallback:r,invokeGuardedCallbackWithCatch:r,rethrowCaughtError:function(){if(o){var e=o;throw o=null,e}}};e.exports=i},function(e,t,n){"use strict";function r(e){u.enqueueUpdate(e)}function o(e){var t=typeof e;if("object"!==t)return t;var n=e.constructor&&e.constructor.name||t,r=Object.keys(e);return r.length>0&&r.length<20?n+" (keys: "+r.join(", ")+")":n}function i(e,t){var n=s.get(e);if(!n){return null}return n}var a=n(3),s=(n(12),n(26)),u=(n(9),n(10)),l=(n(1),n(2),{isMounted:function(e){var t=s.get(e);return!!t&&!!t._renderedComponent},enqueueCallback:function(e,t,n){l.validateCallback(t,n);var o=i(e);return o?(o._pendingCallbacks?o._pendingCallbacks.push(t):o._pendingCallbacks=[t],void r(o)):null},enqueueCallbackInternal:function(e,t){e._pendingCallbacks?e._pendingCallbacks.push(t):e._pendingCallbacks=[t],r(e)},enqueueForceUpdate:function(e){var t=i(e,"forceUpdate");t&&(t._pendingForceUpdate=!0,r(t))},enqueueReplaceState:function(e,t,n){var o=i(e,"replaceState");o&&(o._pendingStateQueue=[t],o._pendingReplaceState=!0,void 0!==n&&null!==n&&(l.validateCallback(n,"replaceState"),o._pendingCallbacks?o._pendingCallbacks.push(n):o._pendingCallbacks=[n]),r(o))},enqueueSetState:function(e,t){var n=i(e,"setState");if(n){var o=n._pendingStateQueue||(n._pendingStateQueue=[]);o.push(t),r(n)}},enqueueElementInternal:function(e,t,n){e._pendingElement=t,e._context=n,r(e)},validateCallback:function(e,t){e&&"function"!=typeof e?a("122",t,o(e)):void 0}});e.exports=l},function(e,t){"use strict";var n=function(e){return"undefined"!=typeof MSApp&&MSApp.execUnsafeLocalFunction?function(t,n,r,o){MSApp.execUnsafeLocalFunction(function(){return e(t,n,r,o)})}:e};e.exports=n},function(e,t){"use strict";function n(e){var t,n=e.keyCode;return"charCode"in e?(t=e.charCode,0===t&&13===n&&(t=13)):t=n,t>=32||13===t?t:0}e.exports=n},function(e,t){"use strict";function n(e){var t=this,n=t.nativeEvent;if(n.getModifierState)return n.getModifierState(e);var r=o[e];return!!r&&!!n[r]}function r(e){return n}var o={Alt:"altKey",Control:"ctrlKey",Meta:"metaKey",Shift:"shiftKey"};e.exports=r},function(e,t){"use strict";function n(e){var t=e.target||e.srcElement||window;return t.correspondingUseElement&&(t=t.correspondingUseElement),3===t.nodeType?t.parentNode:t}e.exports=n},function(e,t,n){"use strict";function r(e,t){if(!i.canUseDOM||t&&!("addEventListener"in document))return!1;var n="on"+e,r=n in document;if(!r){var a=document.createElement("div");a.setAttribute(n,"return;"),r="function"==typeof a[n]}return!r&&o&&"wheel"===e&&(r=document.implementation.hasFeature("Events.wheel","3.0")),r}var o,i=n(7);i.canUseDOM&&(o=document.implementation&&document.implementation.hasFeature&&document.implementation.hasFeature("","")!==!0),e.exports=r},function(e,t){"use strict";function n(e,t){var n=null===e||e===!1,r=null===t||t===!1;if(n||r)return n===r;var o=typeof e,i=typeof t;return"string"===o||"number"===o?"string"===i||"number"===i:"object"===i&&e.type===t.type&&e.key===t.key}e.exports=n},function(e,t,n){"use strict";var r=(n(4),n(8)),o=(n(2),r);e.exports=o},function(e,t,n){(function(){function t(e,t){var n={}.hasOwnProperty;for(var r in t)n.call(t,r)&&(e[r]=t[r]);return e}function r(e,t){for(var n=-1,r=t.length>>>0;++n<r;)if(e===t[n])return!0;return!1}var o,i,a,s,u,l,c,p,f,d,h,m,v,g,y,b,C,_,w,E,T,x,O,P,k,S,N,M,A,I,D,R,L,U,F,j,B;o=n(15),i=o.each,a=o.filter,s=o.find,u=o.findIndex,l=o.id,c=o.initial,p=o.last,f=o.map,d=o.objToPairs,h=o.partition,m=o.reject,v=o.reverse,g=o.Str,y=o.sortBy,b=o.sum,C=o.values,o=n(16),_=o.clamp,w=o.isEqualToObject,E=n(5),o=E.DOM,T=o.div,x=o.input,O=o.path,P=o.span,k=o.svg,S=E.createClass,N=E.createFactory,M=n(13).findDOMNode,A=N(n(63)),I=N(n(202)),D=N(n(195)),R=N(n(84)),L=N(n(203)),U=N(n(199)),F=N(n(200)),o=n(28),j=o.cancelEvent,B=o.classNameFromObject,e.exports=S({displayName:"ReactSelectize",focusLock:!1,getDefaultProps:function(){return{anchor:null,autofocus:!1,cancelKeyboardEventOnSelection:!0,delimiters:[],disabled:!1,dropdownDirection:1,firstOptionIndexToHighlight:function(e){return 0},groupId:function(e){return e.groupId},groupsAsColumns:!1,highlightedUid:void 0,inputProps:{},onAnchorChange:function(e){},onBlur:function(e){},onEnter:function(e){},onFocus:function(e){},onHighlightedUidChange:function(e,t){},onKeyboardSelectionFailed:function(e){},onOpenChange:function(e,t){},onPaste:function(e){},onScrollLockChange:function(e){},onSearchChange:function(e,t){},onValuesChange:function(e,t){},open:!1,hideResetButton:!1,renderValue:function(e){var t;return t=e.label,T({className:"simple-value"},P(null,t))},renderToggleButton:I,renderResetButton:U,scrollLock:!1,search:"",style:{},theme:"default",uid:l,values:[]}},render:function(){var e,n,r,o,i,a=this;return e=function(){var e;switch(!1){case!("undefined"==typeof this.props.anchor||null===this.props.anchor):return-1;default:return null!=(e=u(function(e){return a.isEqualToObject(e,a.props.anchor)},this.props.values))?e:this.props.values.length-1}}.call(this),n=function(e){return f(function(e){var t,n;return t=a.props.values[e],n=a.props.uid(t),L({key:a.uidToString(n),uid:n,item:t,renderItem:a.props.renderValue})})(e)},r=this.props.dropdownDirection===-1,T({className:B((o={"react-selectize":1},o[this.props.theme+""]=1,o["root-node"]=1,o[this.props.className+""]=1,o.disabled=this.props.disabled,o.open=this.props.open,o.flipped=r,o.tethered=this.props.tether,o)),style:this.props.style},this.props.name?x({type:"hidden",name:this.props.name,value:this.props.serialize(this.props.values)}):void 0,T({className:"react-selectize-control",ref:"control",onMouseDown:function(e){if(function(){return a.props.onAnchorChange(p(a.props.values),function(){return a.onOpenChange(!0,function(){return a.highlightAndFocus()})})}(),!a.props.open)return j(e)}},0===this.props.search.length&&0===this.props.values.length?T({className:"react-selectize-placeholder"},this.props.placeholder):void 0,T({className:"react-selectize-search-field-and-selected-values"},n(function(){var t,n,r=[];for(t=0,n=e;t<=n;++t)r.push(t);return r}()),F((o=t({disabled:this.props.disabled},this.props.inputProps),o.ref="search",o.type="text",o.value=this.props.search,o.onChange=function(e){var t;return t=e.currentTarget.value,a.props.onSearchChange(t,function(){return a.highlightAndScrollToSelectableOption(a.props.firstOptionIndexToHighlight(a.props.options),1)})},o.onFocus=function(e){!function(){return function(e){return a.focusLock?e(a.focusLock=!1):a.onOpenChange(!0,function(){return e(!0)})}}()(function(){return a.props.onFocus(e)})},o.onBlur=function(e){if(!a.refs.dropdownMenu||document.activeElement!==M(a.refs.dropdownMenu))return a.closeDropdown(function(){return a.props.onBlur(e)})},o.onPaste=this.props.onPaste,o.onKeyDown=function(t){return a.handleKeydown({anchorIndex:e},t)},o)),n(function(){var t,n,r=[];for(t=e+1,n=this.props.values.length;t<n;++t)r.push(t);return r}.call(this))),this.props.values.length>0&&!this.props.hideResetButton?T({className:"react-selectize-reset-button-container",onClick:function(e){return function(){return a.props.onValuesChange([],function(){return a.props.onSearchChange("",function(){return a.highlightAndFocus()})})}(),j(e)}},this.props.renderResetButton()):void 0,T({className:"react-selectize-toggle-button-container",onMouseDown:function(e){return a.props.open?a.onOpenChange(!1,function(){}):a.props.onAnchorChange(p(a.props.values),function(){return a.onOpenChange(!0,function(){})}),j(e)}},this.props.renderToggleButton({open:this.props.open,flipped:r}))),D((o=t({},this.props),o.ref="dropdownMenu",o.className=B((i={"react-selectize":1},i[this.props.className+""]=1,i)),o.theme=this.props.theme,o.scrollLock=this.props.scrollLock,o.onScrollChange=this.props.onScrollChange,o.bottomAnchor=function(){return M(a.refs.control)},o.tetherProps=(i=t({},this.props.tetherProps),i.target=function(){return M(a.refs.control)},i),o.highlightedUid=this.props.highlightedUid,o.onHighlightedUidChange=this.props.onHighlightedUidChange,o.onOptionClick=function(t){a.selectHighlightedUid(e,function(){})},o)))},handleKeydown:function(e,t){var n,o,i,a=this;switch(n=e.anchorIndex,t.persist(),t.which){case 8:if(this.props.search.length>0||n===-1)return;!function(){var e,t,r,o;return e=n,t=n-1<0?void 0:a.props.values[n-1],r=a.props.values[n],a.props.onValuesChange(null!=(o=m(function(e){return a.isEqualToObject(e,r)})(a.props.values))?o:[],function(){return function(){return function(e){return"undefined"==typeof s(function(e){return a.isEqualToObject(e,r)},a.props.values)?a.props.restoreOnBackspace?a.props.onSearchChange(a.props.restoreOnBackspace(r),function(){return e(!0)}):e(!0):e(!1)}}()(function(r){if(r&&(a.highlightAndScrollToSelectableOption(a.props.firstOptionIndexToHighlight(a.props.options),1),n===e&&("undefined"==typeof t||s(function(e){return a.isEqualToObject(e,t)})(a.props.values))))return a.props.onAnchorChange(t,function(){})})})}(),j(t);break;case 27:!function(){return a.props.open?function(e){return a.onOpenChange(!1,e)}:function(e){return a.props.onValuesChange([],e)}}()(function(){return a.props.onSearchChange("",function(){return a.focusOnInput()})})}if(this.props.open&&r(t.which,[13].concat(this.props.delimiters))&&!(null!=t&&t.metaKey||null!=t&&t.ctrlKey||null!=t&&t.shiftKey)&&(o=this.selectHighlightedUid(n,function(e){if("undefined"==typeof e)return a.props.onKeyboardSelectionFailed(t.which)}),o&&this.props.cancelKeyboardEventOnSelection))return j(t);if(0===this.props.search.length)switch(t.which){case 37:this.props.onAnchorChange(n-1<0||t.metaKey?void 0:this.props.values[_(n-1,0,this.props.values.length-1)],function(){});break;case 39:this.props.onAnchorChange(t.metaKey?p(this.props.values):this.props.values[_(n+1,0,this.props.values.length-1)],function(){})}switch(t.which){case 38:return this.props.onScrollLockChange(!0),i=function(){switch(!1){case"undefined"!=typeof this.props.highlightedUid:return 0;default:return-1+this.optionIndexFromUid(this.props.highlightedUid)}}.call(this),this.highlightAndScrollToSelectableOption(i,-1,function(e){if(!e)return a.highlightAndScrollToSelectableOption(a.props.options.length-1,-1)});case 40:return this.props.onScrollLockChange(!0),i=function(){switch(!1){case"undefined"!=typeof this.props.highlightedUid:return 0;default:return 1+this.optionIndexFromUid(this.props.highlightedUid)}}.call(this),this.highlightAndScrollToSelectableOption(i,1,function(e){if(!e)return a.highlightAndScrollToSelectableOption(0,1)})}},componentDidMount:function(){this.props.autofocus&&this.focus(),this.props.open&&this.highlightAndFocus()},componentDidUpdate:function(e){this.props.open&&!e.open&&void 0===this.props.highlightedUid&&this.highlightAndFocus(),!this.props.open&&e.open&&this.props.onHighlightedUidChange(void 0,function(){})},componentWillReceiveProps:function(e){"undefined"!=typeof this.props.disabled&&this.props.disabled!==!1||"undefined"==typeof e.disabled||e.disabled!==!0||this.onOpenChange(!1,function(){})},optionIndexFromUid:function(e){var t=this;return u(function(n){return w(e,t.props.uid(n))})(this.props.options)},closeDropdown:function(e){var t=this;this.onOpenChange(!1,function(){return t.props.onAnchorChange(p(t.props.values),e)})},blur:function(){this.refs.search.blur()},focus:function(){this.refs.search.focus()},focusOnInput:function(){var e;e=M(this.refs.search),e!==document.activeElement&&(this.focusLock=!0,e.focus(),e.value=e.value)},highlightAndFocus:function(){this.highlightAndScrollToSelectableOption(this.props.firstOptionIndexToHighlight(this.props.options),1),this.focusOnInput()},highlightAndScrollToOption:function(e,t){null==t&&(t=function(){}),this.refs.dropdownMenu.highlightAndScrollToOption(e,t)},highlightAndScrollToSelectableOption:function(e,t,n){var r=this;null==n&&(n=function(){}),function(){return r.props.open?function(e){return e()}:function(e){return r.onOpenChange(!0,e)}}()(function(){return r.refs.dropdownMenu.highlightAndScrollToSelectableOption(e,t,n)})},isEqualToObject:function(){return w(this.props.uid(arguments[0]),this.props.uid(arguments[1]))},onOpenChange:function(e,t){return this.props.onOpenChange(!this.props.disabled&&e,t)},selectHighlightedUid:function(e,t){var n,r,o=this;return void 0===this.props.highlightedUid?(t(),!1):(n=this.optionIndexFromUid(this.props.highlightedUid),"number"!=typeof n?(t(),!1):(r=this.props.options[n],function(){return o.props.onValuesChange(f(function(e){return o.props.values[e]},function(){var t,n,r=[];for(t=0,n=e;t<=n;++t)r.push(t);return r}()).concat([r],f(function(e){return o.props.values[e]},function(){var t,n,r=[];for(t=e+1,n=this.props.values.length;t<n;++t)r.push(t);return r}.call(o))),function(){var e;return e=s(function(e){return o.isEqualToObject(e,r)},o.props.values),e?o.props.onSearchChange("",function(){return o.props.onAnchorChange(e,function(){return o.props.open?o.highlightAndScrollToSelectableOption(n,1,function(n){return n?void t(e):o.highlightAndScrollToSelectableOption(o.props.firstOptionIndexToHighlight(o.props.options),1,function(n){return n?t(e):o.onOpenChange(!1,function(){return t(e)})})}):void t(e)})}):void t()})}(),!0))},uidToString:function(e){return("object"==typeof e?JSON.stringify:l)(e)}})}).call(this)},function(e,t,n){"use strict";function r(e,t,n){this.props=e,this.context=t,this.refs=a,this.updater=n||i}var o=n(22),i=n(55),a=(n(89),n(23));n(1),n(2);r.prototype.isReactComponent={},r.prototype.setState=function(e,t){"object"!=typeof e&&"function"!=typeof e&&null!=e?o("85"):void 0,this.updater.enqueueSetState(this,e),t&&this.updater.enqueueCallback(this,t,"setState")},r.prototype.forceUpdate=function(e){this.updater.enqueueForceUpdate(this),e&&this.updater.enqueueCallback(this,e,"forceUpdate")};e.exports=r},function(e,t,n){"use strict";function r(e,t){}var o=(n(2),{isMounted:function(e){return!1},enqueueCallback:function(e,t){},enqueueForceUpdate:function(e){r(e,"forceUpdate")},enqueueReplaceState:function(e,t){r(e,"replaceState")},enqueueSetState:function(e,t){r(e,"setState")}});e.exports=o},function(e,t){"use strict";t.__esModule=!0,t.default=void 0;var n=!("undefined"==typeof window||!window.document||!window.document.createElement);t.default=n,e.exports=t.default},function(e,t,n){"use strict";var r=n(8),o={listen:function(e,t,n){return e.addEventListener?(e.addEventListener(t,n,!1),{remove:function(){e.removeEventListener(t,n,!1)}}):e.attachEvent?(e.attachEvent("on"+t,n),{remove:function(){e.detachEvent("on"+t,n)}}):void 0},capture:function(e,t,n){return e.addEventListener?(e.addEventListener(t,n,!0),{remove:function(){e.removeEventListener(t,n,!0)}}):{remove:r}},registerDefault:function(){}};e.exports=o},function(e,t){"use strict";function n(e){try{e.focus()}catch(e){}}e.exports=n},function(e,t){"use strict";function n(e){if(e=e||("undefined"!=typeof document?document:void 0),"undefined"==typeof e)return null;try{return e.activeElement||e.body}catch(t){return e.body}}e.exports=n},function(e,t){function n(){throw new Error("setTimeout has not been defined")}function r(){throw new Error("clearTimeout has not been defined")}function o(e){if(c===setTimeout)return setTimeout(e,0);if((c===n||!c)&&setTimeout)return c=setTimeout,setTimeout(e,0);try{return c(e,0)}catch(t){try{return c.call(null,e,0)}catch(t){return c.call(this,e,0)}}}function i(e){if(p===clearTimeout)return clearTimeout(e);if((p===r||!p)&&clearTimeout)return p=clearTimeout,clearTimeout(e);try{return p(e)}catch(t){try{return p.call(null,e)}catch(t){return p.call(this,e)}}}function a(){m&&d&&(m=!1,d.length?h=d.concat(h):v=-1,h.length&&s())}function s(){if(!m){var e=o(a);m=!0;for(var t=h.length;t;){for(d=h,h=[];++v<t;)d&&d[v].run();v=-1,t=h.length}d=null,m=!1,i(e)}}function u(e,t){this.fun=e,this.array=t}function l(){}var c,p,f=e.exports={};!function(){try{c="function"==typeof setTimeout?setTimeout:n}catch(e){c=n}try{p="function"==typeof clearTimeout?clearTimeout:r}catch(e){p=r}}();var d,h=[],m=!1,v=-1;f.nextTick=function(e){var t=new Array(arguments.length-1);if(arguments.length>1)for(var n=1;n<arguments.length;n++)t[n-1]=arguments[n];h.push(new u(e,t)),1!==h.length||m||o(s)},u.prototype.run=function(){this.fun.apply(null,this.array)},f.title="browser",f.browser=!0,f.env={},f.argv=[],f.version="",f.versions={},f.on=l,f.addListener=l,f.once=l,f.off=l,f.removeListener=l,f.removeAllListeners=l,f.emit=l,f.prependListener=l,f.prependOnceListener=l,f.listeners=function(e){return[]},f.binding=function(e){throw new Error("process.binding is not supported")},f.cwd=function(){return"/"},f.chdir=function(e){throw new Error("process.chdir is not supported")},f.umask=function(){return 0}},function(e,t,n){"use strict";function r(){}function o(e){try{return e.then}catch(e){return g=e,y}}function i(e,t){try{return e(t)}catch(e){return g=e,y}}function a(e,t,n){try{e(t,n)}catch(e){return g=e,y}}function s(e){if("object"!=typeof this)throw new TypeError("Promises must be constructed via new");if("function"!=typeof e)throw new TypeError("not a function");this._45=0,this._81=0,this._65=null,this._54=null,e!==r&&m(e,this)}function u(e,t,n){return new e.constructor(function(o,i){var a=new s(r);a.then(o,i),l(e,new h(t,n,a))})}function l(e,t){for(;3===e._81;)e=e._65;return s._10&&s._10(e),0===e._81?0===e._45?(e._45=1,void(e._54=t)):1===e._45?(e._45=2,void(e._54=[e._54,t])):void e._54.push(t):void c(e,t)}function c(e,t){v(function(){var n=1===e._81?t.onFulfilled:t.onRejected;if(null===n)return void(1===e._81?p(t.promise,e._65):f(t.promise,e._65));var r=i(n,e._65);r===y?f(t.promise,g):p(t.promise,r)})}function p(e,t){if(t===e)return f(e,new TypeError("A promise cannot be resolved with itself."));if(t&&("object"==typeof t||"function"==typeof t)){var n=o(t);if(n===y)return f(e,g);if(n===e.then&&t instanceof s)return e._81=3,e._65=t,void d(e);if("function"==typeof n)return void m(n.bind(t),e)}e._81=1,e._65=t,d(e)}function f(e,t){e._81=2,e._65=t,s._97&&s._97(e,t),d(e)}function d(e){if(1===e._45&&(l(e,e._54),e._54=null),2===e._45){for(var t=0;t<e._54.length;t++)l(e,e._54[t]);e._54=null}}function h(e,t,n){this.onFulfilled="function"==typeof e?e:null,this.onRejected="function"==typeof t?t:null,this.promise=n}function m(e,t){var n=!1,r=a(e,function(e){n||(n=!0,p(t,e))},function(e){n||(n=!0,f(t,e))});n||r!==y||(n=!0,f(t,g))}var v=n(90),g=null,y={};e.exports=s,s._10=null,s._97=null,s._61=r,s.prototype.then=function(e,t){if(this.constructor!==s)return u(this,e,t);var n=new s(r);return l(this,new h(e,t,n)),n}},function(e,t,n){"use strict";var r=n(122);e.exports=function(e){var t=!1;return r(e,t)}},function(e,t,n){"use strict";e.exports=n(205)},function(e,t){"use strict";function n(e,t){return e+t.charAt(0).toUpperCase()+t.substring(1)}var r={animationIterationCount:!0,borderImageOutset:!0,borderImageSlice:!0,borderImageWidth:!0,boxFlex:!0,boxFlexGroup:!0,boxOrdinalGroup:!0,columnCount:!0,flex:!0,flexGrow:!0,flexPositive:!0,flexShrink:!0,flexNegative:!0,flexOrder:!0,gridRow:!0,gridColumn:!0,fontWeight:!0,lineClamp:!0,lineHeight:!0,opacity:!0,order:!0,orphans:!0,tabSize:!0,widows:!0,zIndex:!0,zoom:!0,fillOpacity:!0,floodOpacity:!0,stopOpacity:!0,strokeDasharray:!0,strokeDashoffset:!0,strokeMiterlimit:!0,strokeOpacity:!0,strokeWidth:!0},o=["Webkit","ms","Moz","O"];Object.keys(r).forEach(function(e){o.forEach(function(t){r[n(t,e)]=r[e]})});var i={background:{backgroundAttachment:!0,backgroundColor:!0,backgroundImage:!0,backgroundPositionX:!0,backgroundPositionY:!0,backgroundRepeat:!0},backgroundPosition:{backgroundPositionX:!0,backgroundPositionY:!0},border:{borderWidth:!0,borderStyle:!0,borderColor:!0},borderBottom:{borderBottomWidth:!0,borderBottomStyle:!0,borderBottomColor:!0},borderLeft:{borderLeftWidth:!0,borderLeftStyle:!0,borderLeftColor:!0},borderRight:{borderRightWidth:!0,borderRightStyle:!0,borderRightColor:!0},borderTop:{borderTopWidth:!0,borderTopStyle:!0,borderTopColor:!0},font:{fontStyle:!0,fontVariant:!0,fontWeight:!0,fontSize:!0,lineHeight:!0,fontFamily:!0},outline:{outlineWidth:!0,outlineStyle:!0,outlineColor:!0}},a={isUnitlessNumber:r,shorthandPropertyExpansions:i};e.exports=a},function(e,t,n){"use strict";function r(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}var o=n(3),i=n(14),a=(n(1),function(){function e(t){r(this,e),this._callbacks=null,this._contexts=null,this._arg=t}return e.prototype.enqueue=function(e,t){this._callbacks=this._callbacks||[],this._callbacks.push(e),this._contexts=this._contexts||[],this._contexts.push(t)},e.prototype.notifyAll=function(){var e=this._callbacks,t=this._contexts,n=this._arg;if(e&&t){e.length!==t.length?o("24"):void 0,this._callbacks=null,this._contexts=null;for(var r=0;r<e.length;r++)e[r].call(t[r],n);e.length=0,t.length=0}},e.prototype.checkpoint=function(){return this._callbacks?this._callbacks.length:0},e.prototype.rollback=function(e){this._callbacks&&this._contexts&&(this._callbacks.length=e,this._contexts.length=e)},e.prototype.reset=function(){this._callbacks=null,this._contexts=null},e.prototype.destructor=function(){this.reset()},e}());e.exports=i.addPoolingTo(a)},function(e,t,n){"use strict";function r(e){return!!l.hasOwnProperty(e)||!u.hasOwnProperty(e)&&(s.test(e)?(l[e]=!0,!0):(u[e]=!0,!1))}function o(e,t){return null==t||e.hasBooleanValue&&!t||e.hasNumericValue&&isNaN(t)||e.hasPositiveNumericValue&&t<1||e.hasOverloadedBooleanValue&&t===!1}var i=n(18),a=(n(6),n(9),n(186)),s=(n(2),new RegExp("^["+i.ATTRIBUTE_NAME_START_CHAR+"]["+i.ATTRIBUTE_NAME_CHAR+"]*$")),u={},l={},c={createMarkupForID:function(e){return i.ID_ATTRIBUTE_NAME+"="+a(e)},setAttributeForID:function(e,t){e.setAttribute(i.ID_ATTRIBUTE_NAME,t)},createMarkupForRoot:function(){return i.ROOT_ATTRIBUTE_NAME+'=""'},setAttributeForRoot:function(e){e.setAttribute(i.ROOT_ATTRIBUTE_NAME,"")},createMarkupForProperty:function(e,t){var n=i.properties.hasOwnProperty(e)?i.properties[e]:null;if(n){if(o(n,t))return"";var r=n.attributeName;return n.hasBooleanValue||n.hasOverloadedBooleanValue&&t===!0?r+'=""':r+"="+a(t)}return i.isCustomAttribute(e)?null==t?"":e+"="+a(t):null},createMarkupForCustomAttribute:function(e,t){return r(e)&&null!=t?e+"="+a(t):""},setValueForProperty:function(e,t,n){var r=i.properties.hasOwnProperty(t)?i.properties[t]:null;if(r){var a=r.mutationMethod;if(a)a(e,n);else{if(o(r,n))return void this.deleteValueForProperty(e,t);if(r.mustUseProperty)e[r.propertyName]=n;else{var s=r.attributeName,u=r.attributeNamespace;u?e.setAttributeNS(u,s,""+n):r.hasBooleanValue||r.hasOverloadedBooleanValue&&n===!0?e.setAttribute(s,""):e.setAttribute(s,""+n)}}}else if(i.isCustomAttribute(t))return void c.setValueForAttribute(e,t,n)},setValueForAttribute:function(e,t,n){if(r(t)){null==n?e.removeAttribute(t):e.setAttribute(t,""+n)}},deleteValueForAttribute:function(e,t){e.removeAttribute(t)},deleteValueForProperty:function(e,t){var n=i.properties.hasOwnProperty(t)?i.properties[t]:null;if(n){var r=n.mutationMethod;if(r)r(e,void 0);else if(n.mustUseProperty){var o=n.propertyName;n.hasBooleanValue?e[o]=!1:e[o]=""}else e.removeAttribute(n.attributeName)}else i.isCustomAttribute(t)&&e.removeAttribute(t)}};e.exports=c},function(e,t){"use strict";var n={hasCachedChildNodes:1};e.exports=n},function(e,t,n){"use strict";function r(){if(this._rootNodeID&&this._wrapperState.pendingUpdate){this._wrapperState.pendingUpdate=!1;var e=this._currentElement.props,t=s.getValue(e);null!=t&&o(this,Boolean(e.multiple),t)}}function o(e,t,n){var r,o,i=u.getNodeFromInstance(e).options;if(t){for(r={},o=0;o<n.length;o++)r[""+n[o]]=!0;for(o=0;o<i.length;o++){var a=r.hasOwnProperty(i[o].value);i[o].selected!==a&&(i[o].selected=a)}}else{for(r=""+n,o=0;o<i.length;o++)if(i[o].value===r)return void(i[o].selected=!0);i.length&&(i[0].selected=!0)}}function i(e){var t=this._currentElement.props,n=s.executeOnChange(t,e);return this._rootNodeID&&(this._wrapperState.pendingUpdate=!0),l.asap(r,this),n}var a=n(4),s=n(42),u=n(6),l=n(10),c=(n(2),!1),p={getHostProps:function(e,t){return a({},t,{onChange:e._wrapperState.onChange,value:void 0})},mountWrapper:function(e,t){var n=s.getValue(t);e._wrapperState={pendingUpdate:!1,initialValue:null!=n?n:t.defaultValue,listeners:null,onChange:i.bind(e),wasMultiple:Boolean(t.multiple)},void 0===t.value||void 0===t.defaultValue||c||(c=!0)},getSelectValueContext:function(e){return e._wrapperState.initialValue},postUpdateWrapper:function(e){var t=e._currentElement.props;e._wrapperState.initialValue=void 0;var n=e._wrapperState.wasMultiple;e._wrapperState.wasMultiple=Boolean(t.multiple);var r=s.getValue(t);null!=r?(e._wrapperState.pendingUpdate=!1,o(e,Boolean(t.multiple),r)):n!==Boolean(t.multiple)&&(null!=t.defaultValue?o(e,Boolean(t.multiple),t.defaultValue):o(e,Boolean(t.multiple),t.multiple?[]:""))}};e.exports=p},function(e,t){"use strict";var n,r={injectEmptyComponentFactory:function(e){n=e}},o={create:function(e){return n(e)}};o.injection=r,e.exports=o},function(e,t){"use strict";var n={logTopLevelRenders:!1};e.exports=n},function(e,t,n){"use strict";function r(e){return s?void 0:a("111",e.type),new s(e)}function o(e){return new u(e)}function i(e){return e instanceof u}var a=n(3),s=(n(1),null),u=null,l={injectGenericComponentClass:function(e){s=e},injectTextComponentClass:function(e){u=e}},c={createInternalComponent:r,createInstanceForText:o,isTextComponent:i,injection:l};e.exports=c},function(e,t,n){"use strict";function r(e){return i(document.documentElement,e)}var o=n(146),i=n(103),a=n(58),s=n(59),u={hasSelectionCapabilities:function(e){var t=e&&e.nodeName&&e.nodeName.toLowerCase();return t&&("input"===t&&"text"===e.type||"textarea"===t||"true"===e.contentEditable)},getSelectionInformation:function(){var e=s();return{focusedElem:e,selectionRange:u.hasSelectionCapabilities(e)?u.getSelection(e):null}},restoreSelection:function(e){var t=s(),n=e.focusedElem,o=e.selectionRange;t!==n&&r(n)&&(u.hasSelectionCapabilities(n)&&u.setSelection(n,o),a(n))},getSelection:function(e){var t;if("selectionStart"in e)t={start:e.selectionStart,end:e.selectionEnd};else if(document.selection&&e.nodeName&&"input"===e.nodeName.toLowerCase()){var n=document.selection.createRange();n.parentElement()===e&&(t={start:-n.moveStart("character",-e.value.length),end:-n.moveEnd("character",-e.value.length)})}else t=o.getOffsets(e);return t||{start:0,end:0}},setSelection:function(e,t){var n=t.start,r=t.end;if(void 0===r&&(r=n),"selectionStart"in e)e.selectionStart=n,e.selectionEnd=Math.min(r,e.value.length);else if(document.selection&&e.nodeName&&"input"===e.nodeName.toLowerCase()){var i=e.createTextRange();i.collapse(!0),i.moveStart("character",n),i.moveEnd("character",r-n),i.select()}else o.setOffsets(e,t)}};e.exports=u},function(e,t,n){"use strict";function r(e,t){for(var n=Math.min(e.length,t.length),r=0;r<n;r++)if(e.charAt(r)!==t.charAt(r))return r;return e.length===t.length?-1:n}function o(e){return e?e.nodeType===D?e.documentElement:e.firstChild:null}function i(e){return e.getAttribute&&e.getAttribute(M)||""}function a(e,t,n,r,o){var i;if(_.logTopLevelRenders){var a=e._currentElement.props.child,s=a.type;i="React mount: "+("string"==typeof s?s:s.displayName||s.name),console.time(i)}var u=T.mountComponent(e,n,null,b(e,t),o,0);i&&console.timeEnd(i),e._renderedComponent._topLevelWrapper=e,j._mountImageIntoNode(u,t,e,r,n)}function s(e,t,n,r){var o=O.ReactReconcileTransaction.getPooled(!n&&C.useCreateElement);o.perform(a,null,e,t,o,n,r),O.ReactReconcileTransaction.release(o)}function u(e,t,n){for(T.unmountComponent(e,n),t.nodeType===D&&(t=t.documentElement);t.lastChild;)t.removeChild(t.lastChild)}function l(e){var t=o(e);if(t){var n=y.getInstanceFromNode(t);return!(!n||!n._hostParent)}}function c(e){return!(!e||e.nodeType!==I&&e.nodeType!==D&&e.nodeType!==R)}function p(e){var t=o(e),n=t&&y.getInstanceFromNode(t);return n&&!n._hostParent?n:null}function f(e){var t=p(e);return t?t._hostContainerInfo._topLevelWrapper:null}var d=n(3),h=n(17),m=n(18),v=n(20),g=n(29),y=(n(12),n(6)),b=n(140),C=n(142),_=n(70),w=n(26),E=(n(9),n(156)),T=n(19),x=n(45),O=n(10),P=n(23),k=n(80),S=(n(1),n(33)),N=n(51),M=(n(2),m.ID_ATTRIBUTE_NAME),A=m.ROOT_ATTRIBUTE_NAME,I=1,D=9,R=11,L={},U=1,F=function(){this.rootID=U++};F.prototype.isReactComponent={},F.prototype.render=function(){return this.props.child},F.isReactTopLevelWrapper=!0;var j={TopLevelWrapper:F,_instancesByReactRootID:L,scrollMonitor:function(e,t){t()},_updateRootComponent:function(e,t,n,r,o){return j.scrollMonitor(r,function(){x.enqueueElementInternal(e,t,n),o&&x.enqueueCallbackInternal(e,o)}),e},_renderNewRootComponent:function(e,t,n,r){c(t)?void 0:d("37"),g.ensureScrollValueMonitoring();var o=k(e,!1);O.batchedUpdates(s,o,t,n,r);
-var i=o._instance.rootID;return L[i]=o,o},renderSubtreeIntoContainer:function(e,t,n,r){return null!=e&&w.has(e)?void 0:d("38"),j._renderSubtreeIntoContainer(e,t,n,r)},_renderSubtreeIntoContainer:function(e,t,n,r){x.validateCallback(r,"ReactDOM.render"),v.isValidElement(t)?void 0:d("39","string"==typeof t?" Instead of passing a string like 'div', pass React.createElement('div') or <div />.":"function"==typeof t?" Instead of passing a class like Foo, pass React.createElement(Foo) or <Foo />.":null!=t&&void 0!==t.props?" This may be caused by unintentionally loading two independent copies of React.":"");var a,s=v.createElement(F,{child:t});if(e){var u=w.get(e);a=u._processChildContext(u._context)}else a=P;var c=f(n);if(c){var p=c._currentElement,h=p.props.child;if(N(h,t)){var m=c._renderedComponent.getPublicInstance(),g=r&&function(){r.call(m)};return j._updateRootComponent(c,s,a,n,g),m}j.unmountComponentAtNode(n)}var y=o(n),b=y&&!!i(y),C=l(n),_=b&&!c&&!C,E=j._renderNewRootComponent(s,n,_,a)._renderedComponent.getPublicInstance();return r&&r.call(E),E},render:function(e,t,n){return j._renderSubtreeIntoContainer(null,e,t,n)},unmountComponentAtNode:function(e){c(e)?void 0:d("40");var t=f(e);if(!t){l(e),1===e.nodeType&&e.hasAttribute(A);return!1}return delete L[t._instance.rootID],O.batchedUpdates(u,t,e,!1),!0},_mountImageIntoNode:function(e,t,n,i,a){if(c(t)?void 0:d("41"),i){var s=o(t);if(E.canReuseMarkup(e,s))return void y.precacheNode(n,s);var u=s.getAttribute(E.CHECKSUM_ATTR_NAME);s.removeAttribute(E.CHECKSUM_ATTR_NAME);var l=s.outerHTML;s.setAttribute(E.CHECKSUM_ATTR_NAME,u);var p=e,f=r(p,l),m=" (client) "+p.substring(f-20,f+20)+"\n (server) "+l.substring(f-20,f+20);t.nodeType===D?d("42",m):void 0}if(t.nodeType===D?d("43"):void 0,a.useCreateElement){for(;t.lastChild;)t.removeChild(t.lastChild);h.insertTreeBefore(t,e,null)}else S(t,e),y.precacheNode(n,t.firstChild)}};e.exports=j},function(e,t,n){"use strict";var r=n(3),o=n(20),i=(n(1),{HOST:0,COMPOSITE:1,EMPTY:2,getType:function(e){return null===e||e===!1?i.EMPTY:o.isValidElement(e)?"function"==typeof e.type?i.COMPOSITE:i.HOST:void r("26",e)}});e.exports=i},function(e,t){"use strict";var n={currentScrollLeft:0,currentScrollTop:0,refreshScrollValues:function(e){n.currentScrollLeft=e.x,n.currentScrollTop=e.y}};e.exports=n},function(e,t,n){"use strict";function r(e,t){return null==t?o("30"):void 0,null==e?t:Array.isArray(e)?Array.isArray(t)?(e.push.apply(e,t),e):(e.push(t),e):Array.isArray(t)?[e].concat(t):[e,t]}var o=n(3);n(1);e.exports=r},function(e,t){"use strict";function n(e,t,n){Array.isArray(e)?e.forEach(t,n):e&&t.call(n,e)}e.exports=n},function(e,t,n){"use strict";function r(e){for(var t;(t=e._renderedNodeType)===o.COMPOSITE;)e=e._renderedComponent;return t===o.HOST?e._renderedComponent:t===o.EMPTY?null:void 0}var o=n(74);e.exports=r},function(e,t,n){"use strict";function r(){return!i&&o.canUseDOM&&(i="textContent"in document.documentElement?"textContent":"innerText"),i}var o=n(7),i=null;e.exports=r},function(e,t,n){"use strict";function r(e){if(e){var t=e.getName();if(t)return" Check the render method of `"+t+"`."}return""}function o(e){return"function"==typeof e&&"undefined"!=typeof e.prototype&&"function"==typeof e.prototype.mountComponent&&"function"==typeof e.prototype.receiveComponent}function i(e,t){var n;if(null===e||e===!1)n=l.create(i);else if("object"==typeof e){var s=e,u=s.type;if("function"!=typeof u&&"string"!=typeof u){var f="";f+=r(s._owner),a("130",null==u?u:typeof u,f)}"string"==typeof s.type?n=c.createInternalComponent(s):o(s.type)?(n=new s.type(s),n.getHostNode||(n.getHostNode=n.getNativeNode)):n=new p(s)}else"string"==typeof e||"number"==typeof e?n=c.createInstanceForText(e):a("131",typeof e);return n._mountIndex=0,n._mountImage=null,n}var a=n(3),s=n(4),u=n(137),l=n(69),c=n(71),p=(n(221),n(1),n(2),function(e){this.construct(e)});s(p.prototype,u,{_instantiateReactComponent:i}),e.exports=i},function(e,t){"use strict";function n(e){var t=e&&e.nodeName&&e.nodeName.toLowerCase();return"input"===t?!!r[e.type]:"textarea"===t}var r={color:!0,date:!0,datetime:!0,"datetime-local":!0,email:!0,month:!0,number:!0,password:!0,range:!0,search:!0,tel:!0,text:!0,time:!0,url:!0,week:!0};e.exports=n},function(e,t,n){"use strict";var r=n(7),o=n(32),i=n(33),a=function(e,t){if(t){var n=e.firstChild;if(n&&n===e.lastChild&&3===n.nodeType)return void(n.nodeValue=t)}e.textContent=t};r.canUseDOM&&("textContent"in document.documentElement||(a=function(e,t){return 3===e.nodeType?void(e.nodeValue=t):void i(e,o(t))})),e.exports=a},function(e,t,n){"use strict";function r(e,t){return e&&"object"==typeof e&&null!=e.key?l.escape(e.key):t.toString(36)}function o(e,t,n,i){var f=typeof e;if("undefined"!==f&&"boolean"!==f||(e=null),null===e||"string"===f||"number"===f||"object"===f&&e.$$typeof===s)return n(i,e,""===t?c+r(e,0):t),1;var d,h,m=0,v=""===t?c:t+p;if(Array.isArray(e))for(var g=0;g<e.length;g++)d=e[g],h=v+r(d,g),m+=o(d,h,n,i);else{var y=u(e);if(y){var b,C=y.call(e);if(y!==e.entries)for(var _=0;!(b=C.next()).done;)d=b.value,h=v+r(d,_++),m+=o(d,h,n,i);else for(;!(b=C.next()).done;){var w=b.value;w&&(d=w[1],h=v+l.escape(w[0])+p+r(d,0),m+=o(d,h,n,i))}}else if("object"===f){var E="",T=String(e);a("31","[object Object]"===T?"object with keys {"+Object.keys(e).join(", ")+"}":T,E)}}return m}function i(e,t,n){return null==e?0:o(e,"",t,n)}var a=n(3),s=(n(12),n(152)),u=n(183),l=(n(1),n(41)),c=(n(2),"."),p=":";e.exports=i},function(e,t,n){(function(){var t,r,o,i,a;t=n(5),r=t.createClass,o=t.DOM.div,i=n(16).isEqualToObject,a=n(28).cancelEvent,e.exports=r({getDefaultProps:function(){return{}},render:function(){var e=this;return o({className:"option-wrapper "+(this.props.highlight?"highlight":""),onMouseDown:function(t){var n;return n=function(t){return e.props.onClick(t),window.removeEventListener("mouseup",n)},window.addEventListener("mouseup",n),a(t)},onMouseMove:this.props.onMouseMove,onMouseOut:this.props.onMouseOut,onMouseOver:this.props.onMouseOver},this.props.renderItem(this.props.item))},shouldComponentUpdate:function(e){var t,n,r;return!i(null!=e?e.uid:void 0,null!=(t=this.props)?t.uid:void 0)||(null!=e?e.highlight:void 0)!==(null!=(n=this.props)?n.highlight:void 0)||(null!=e?e.selectable:void 0)!==(null!=(r=this.props)?r.selectable:void 0)}})}).call(this)},function(e,t,n){(function(){var t,r,o,i;t=n(5),r=t.createClass,o=t.DOM.svg,i=n(13).findDOMNode,e.exports=r({render:function(){return o(this.props)},componentDidMount:function(){i(this).setAttribute("focusable",!1)}})}).call(this)},function(e,t,n){"use strict";function r(e){return e&&e.__esModule?e:{default:e}}function o(e){var t="transition"+e+"Timeout",n="transition"+e;return function(e){if(e[n]){if(null==e[t])return new Error(t+" wasn't supplied to CSSTransitionGroup: this can cause unreliable animations and won't be supported in a future version of React. See https://fb.me/react-animation-transition-group-timeout for more information.");if("number"!=typeof e[t])return new Error(t+" must be a number (in milliseconds)")}return null}}t.__esModule=!0,t.nameShape=void 0,t.transitionTimeout=o;var i=n(5),a=(r(i),n(34)),s=r(a);t.nameShape=s.default.oneOfType([s.default.string,s.default.shape({enter:s.default.string,leave:s.default.string,active:s.default.string}),s.default.shape({enter:s.default.string,enterActive:s.default.string,leave:s.default.string,leaveActive:s.default.string,appear:s.default.string,appearActive:s.default.string})])},function(e,t,n){"use strict";function r(e){var t=Function.prototype.toString,n=Object.prototype.hasOwnProperty,r=RegExp("^"+t.call(n).replace(/[\\^$.*+?()[\]{}|]/g,"\\$&").replace(/hasOwnProperty|(function).*?(?=\\\()| for .+?(?=\\\])/g,"$1.*?")+"$");try{var o=t.call(e);return r.test(o)}catch(e){return!1}}function o(e){var t=l(e);if(t){var n=t.childIDs;c(e),n.forEach(o)}}function i(e,t,n){return"\n    in "+(e||"Unknown")+(t?" (at "+t.fileName.replace(/^.*[\\\/]/,"")+":"+t.lineNumber+")":n?" (created by "+n+")":"")}function a(e){return null==e?"#empty":"string"==typeof e||"number"==typeof e?"#text":"string"==typeof e.type?e.type:e.type.displayName||e.type.name||"Unknown"}function s(e){var t,n=x.getDisplayName(e),r=x.getElement(e),o=x.getOwnerID(e);return o&&(t=x.getDisplayName(o)),i(n,r&&r._source,t)}var u,l,c,p,f,d,h,m=n(22),v=n(12),g=(n(1),n(2),"function"==typeof Array.from&&"function"==typeof Map&&r(Map)&&null!=Map.prototype&&"function"==typeof Map.prototype.keys&&r(Map.prototype.keys)&&"function"==typeof Set&&r(Set)&&null!=Set.prototype&&"function"==typeof Set.prototype.keys&&r(Set.prototype.keys));if(g){var y=new Map,b=new Set;u=function(e,t){y.set(e,t)},l=function(e){return y.get(e)},c=function(e){y.delete(e)},p=function(){return Array.from(y.keys())},f=function(e){b.add(e)},d=function(e){b.delete(e)},h=function(){return Array.from(b.keys())}}else{var C={},_={},w=function(e){return"."+e},E=function(e){return parseInt(e.substr(1),10)};u=function(e,t){var n=w(e);C[n]=t},l=function(e){var t=w(e);return C[t]},c=function(e){var t=w(e);delete C[t]},p=function(){return Object.keys(C).map(E)},f=function(e){var t=w(e);_[t]=!0},d=function(e){var t=w(e);delete _[t]},h=function(){return Object.keys(_).map(E)}}var T=[],x={onSetChildren:function(e,t){var n=l(e);n?void 0:m("144"),n.childIDs=t;for(var r=0;r<t.length;r++){var o=t[r],i=l(o);i?void 0:m("140"),null==i.childIDs&&"object"==typeof i.element&&null!=i.element?m("141"):void 0,i.isMounted?void 0:m("71"),null==i.parentID&&(i.parentID=e),i.parentID!==e?m("142",o,i.parentID,e):void 0}},onBeforeMountComponent:function(e,t,n){var r={element:t,parentID:n,text:null,childIDs:[],isMounted:!1,updateCount:0};u(e,r)},onBeforeUpdateComponent:function(e,t){var n=l(e);n&&n.isMounted&&(n.element=t)},onMountComponent:function(e){var t=l(e);t?void 0:m("144"),t.isMounted=!0;var n=0===t.parentID;n&&f(e)},onUpdateComponent:function(e){var t=l(e);t&&t.isMounted&&t.updateCount++},onUnmountComponent:function(e){var t=l(e);if(t){t.isMounted=!1;var n=0===t.parentID;n&&d(e)}T.push(e)},purgeUnmountedComponents:function(){if(!x._preventPurging){for(var e=0;e<T.length;e++){var t=T[e];o(t)}T.length=0}},isMounted:function(e){var t=l(e);return!!t&&t.isMounted},getCurrentStackAddendum:function(e){var t="";if(e){var n=a(e),r=e._owner;t+=i(n,e._source,r&&r.getName())}var o=v.current,s=o&&o._debugID;return t+=x.getStackAddendumByID(s)},getStackAddendumByID:function(e){for(var t="";e;)t+=s(e),e=x.getParentID(e);return t},getChildIDs:function(e){var t=l(e);return t?t.childIDs:[]},getDisplayName:function(e){var t=x.getElement(e);return t?a(t):null},getElement:function(e){var t=l(e);return t?t.element:null},getOwnerID:function(e){var t=x.getElement(e);return t&&t._owner?t._owner._debugID:null},getParentID:function(e){var t=l(e);return t?t.parentID:null},getSource:function(e){var t=l(e),n=t?t.element:null,r=null!=n?n._source:null;return r},getText:function(e){var t=x.getElement(e);return"string"==typeof t?t:"number"==typeof t?""+t:null},getUpdateCount:function(e){var t=l(e);return t?t.updateCount:0},getRootIDs:h,getRegisteredIDs:p};e.exports=x},function(e,t){"use strict";var n="function"==typeof Symbol&&Symbol.for&&Symbol.for("react.element")||60103;e.exports=n},function(e,t,n){"use strict";var r=!1;e.exports=r},function(e,t){(function(t){"use strict";function n(e){s.length||(a(),u=!0),s[s.length]=e}function r(){for(;l<s.length;){var e=l;if(l+=1,s[e].call(),l>c){for(var t=0,n=s.length-l;t<n;t++)s[t]=s[t+l];s.length-=l,l=0}}s.length=0,l=0,u=!1}function o(e){var t=1,n=new f(e),r=document.createTextNode("");return n.observe(r,{characterData:!0}),function(){t=-t,r.data=t}}function i(e){return function(){function t(){clearTimeout(n),clearInterval(r),e()}var n=setTimeout(t,0),r=setInterval(t,50)}}e.exports=n;var a,s=[],u=!1,l=0,c=1024,p="undefined"!=typeof t?t:self,f=p.MutationObserver||p.WebKitMutationObserver;a="function"==typeof f?o(r):i(r),n.requestFlush=a,n.makeRequestCallFromTimer=i}).call(t,function(){return this}())},function(e,t,n){"use strict";function r(e){return e&&e.__esModule?e:{default:e}}function o(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function i(e,t){if(!e)throw new ReferenceError("this hasn't been initialised - super() hasn't been called");return!t||"object"!=typeof t&&"function"!=typeof t?e:t}function a(e,t){if("function"!=typeof t&&null!==t)throw new TypeError("Super expression must either be null or a function, not "+typeof t);e.prototype=Object.create(t&&t.prototype,{constructor:{value:e,enumerable:!1,writable:!0,configurable:!0}}),t&&(Object.setPrototypeOf?Object.setPrototypeOf(e,t):e.__proto__=t)}Object.defineProperty(t,"__esModule",{value:!0});var s=function(){function e(e,t){for(var n=0;n<t.length;n++){var r=t[n];r.enumerable=r.enumerable||!1,r.configurable=!0,"value"in r&&(r.writable=!0),Object.defineProperty(e,r.key,r)}}return function(t,n,r){return n&&e(t.prototype,n),r&&e(t,r),t}}(),u=n(5),l=r(u),c=n(204),p=function(e){function t(e){o(this,t);var n=i(this,(t.__proto__||Object.getPrototypeOf(t)).call(this,e));return n.getCoefficients=function(e){if(e)return e.map(function(e,t){return l.default.createElement("option",{key:t,value:e.value},e.name)})},n.labels=[],n.handleInputChange=n.handleInputChange.bind(n),n.handleValueChange=n.handleValueChange.bind(n),n}return a(t,e),s(t,[{key:"handleInputChange",value:function(e){var t=this.props.condition;t[e.target.name]=e.target.value;var n=this.props.parameters.find(function(t){return t.value===e.target.value});n&&(n.type!==t.type&&(t.operator=""),t.type=n.type),this.props.onChange({index:this.props.index,value:t})}},{key:"handleValueChange",value:function(e){var t=this.props.condition;t.value=e.map(function(e){return e.value}),this.props.onChange({index:this.props.index,value:t})}},{key:"getOperators",value:function(e,t){if(e&&t)return e.filter(function(e){return e.types.indexOf(t.type)>-1}).map(function(e,t){return l.default.createElement("option",{key:t,value:e.name},e.name)})}},{key:"getValues",value:function(e){return e?e.map(function(e){return{label:e,value:e}}):[]}},{key:"render",value:function(){var e=this,t=this.props.parameters.find(function(t){return t.value===e.props.condition.parameter});return this.props.condition.type=t?t.type:null,l.default.createElement("div",{className:this.props.classes.filterLineRow},l.default.createElement("div",{className:this.props.classes.filterLineParameter},l.default.createElement("select",{className:this.props.classes.filterLineInput,name:"parameter",value:this.props.condition.parameter,onChange:this.handleInputChange},l.default.createElement("option",{value:""},"-- Parameter --"),this.getCoefficients(this.props.parameters))),l.default.createElement("div",{className:this.props.classes.filterLineOperator,style:{"padding-left":0,"padding-right":0}},l.default.createElement("select",{className:this.props.classes.filterLineInput,name:"operator",value:this.props.condition.operator,onChange:this.handleInputChange},l.default.createElement("option",{disabled:!0,value:""},"-- Operator --"),this.getOperators(this.props.operators,this.props.parameters.find(function(t){return t.value===e.props.condition.parameter})))),l.default.createElement("div",{className:this.props.classes.filterLineValue},l.default.createElement(c.MultiSelect,{style:{width:"100%"},placeholder:"-- Value --",theme:"bootstrap3",values:this.getValues(this.props.condition.value),onValuesChange:this.handleValueChange,uid:function(e){return e.value},restoreOnBackspace:function(e){return e.label.toString()},createFromSearch:function(t,n,r){return e.labels=n.map(function(e){return e.label}),0===r.trim().length||e.labels.indexOf(r.trim())!==-1?null:{label:r.trim(),value:r.trim()}},renderNoResultsFound:function(e,t){return l.default.createElement("div",{className:"no-results-found"},function(){return 0===t.trim().length?"Enter a new value":e.map(function(e){return e.label}).indexOf(t.trim())!==-1?"Value already exists":void 0}())}})))}}]),t}(u.Component);t.default=p},function(e,t,n){"use strict";function r(e){return e&&e.__esModule?e:{default:e}}function o(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function i(e,t){if(!e)throw new ReferenceError("this hasn't been initialised - super() hasn't been called");return!t||"object"!=typeof t&&"function"!=typeof t?e:t}function a(e,t){if("function"!=typeof t&&null!==t)throw new TypeError("Super expression must either be null or a function, not "+typeof t);e.prototype=Object.create(t&&t.prototype,{constructor:{value:e,enumerable:!1,writable:!0,configurable:!0}}),t&&(Object.setPrototypeOf?Object.setPrototypeOf(e,t):e.__proto__=t)}Object.defineProperty(t,"__esModule",{value:!0});var s=function(){function e(e,t){for(var n=0;n<t.length;n++){var r=t[n];r.enumerable=r.enumerable||!1,r.configurable=!0,"value"in r&&(r.writable=!0),Object.defineProperty(e,r.key,r)}}return function(t,n,r){return n&&e(t.prototype,n),r&&e(t,r),t}}(),u=n(5),l=r(u),c={paddingTop:10,paddingBottom:10,paddingRight:3,paddingLeft:3},p=function(e){function t(e){o(this,t);var n=i(this,(t.__proto__||Object.getPrototypeOf(t)).call(this,e));return n.removeCondition=n.removeCondition.bind(n),n.addCondition=n.addCondition.bind(n),n}return a(t,e),s(t,[{key:"removeCondition",value:function(){this.props.removeCondition(this.props.index)}},{key:"addCondition",value:function(){this.props.addCondition(this.props.index)}},{key:"render",value:function(){return l.default.createElement("div",{className:this.props.classes.filterLineLabelRow},l.default.createElement("div",{className:this.props.classes.filterLineLabelCondition},l.default.createElement("label",{style:{marginTop:0}},"Condition {",this.props.index+1,"}")),l.default.createElement("div",{className:this.props.classes.filterLineLabelControls},l.default.createElement("a",{style:c,onClick:this.addCondition},l.default.createElement("span",{className:this.props.classes.plusIcon})),l.default.createElement("a",{style:c,onClick:this.removeCondition},l.default.createElement("span",{className:this.props.classes.minusIcon}))))}}]),t}(u.Component);t.default=p},function(e,t,n){"use strict";function r(e){return e&&e.__esModule?e:{default:e}}function o(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function i(e,t){if(!e)throw new ReferenceError("this hasn't been initialised - super() hasn't been called");return!t||"object"!=typeof t&&"function"!=typeof t?e:t}function a(e,t){if("function"!=typeof t&&null!==t)throw new TypeError("Super expression must either be null or a function, not "+typeof t);e.prototype=Object.create(t&&t.prototype,{constructor:{value:e,enumerable:!1,writable:!0,configurable:!0}}),t&&(Object.setPrototypeOf?Object.setPrototypeOf(e,t):e.__proto__=t)}Object.defineProperty(t,"__esModule",{value:!0});var s=function(){function e(e,t){for(var n=0;n<t.length;n++){var r=t[n];r.enumerable=r.enumerable||!1,r.configurable=!0,"value"in r&&(r.writable=!0),Object.defineProperty(e,r.key,r)}}return function(t,n,r){return n&&e(t.prototype,n),r&&e(t,r),t}}(),u=n(5),l=r(u),c=n(91),p=r(c),f=n(92),d=r(f),h=function(e){function t(e){o(this,t);var n=i(this,(t.__proto__||Object.getPrototypeOf(t)).call(this,e));return n.state={conditions:e.config.conditions},n.updateCondition=n.updateCondition.bind(n),n.addCondition=n.addCondition.bind(n),n.removeCondition=n.removeCondition.bind(n),n.componentDidUpdate=n.componentDidUpdate.bind(n),n}return a(t,e),s(t,[{key:"updateCondition",value:function(e){var t=this.state.conditions;t[e.index]=e.value,this.setState({conditions:t})}},{key:"addCondition",value:function(e){var t=this.state.conditions;t.splice(e+1,0,{parameter:"",operator:"",value:""}),this.setState({conditions:t})}},{key:"removeCondition",value:function(e){if(this.state.conditions.length>1){var t=this.state.conditions;t.splice(e,1),this.setState({conditions:t})}}},{key:"componentDidUpdate",value:function(e,t){t!==this.state&&this.props.config.updateConditions(this.state.conditions)}},{key:"render",value:function(){var e=this,t=this.state.conditions.map(function(t,n){return l.default.createElement("div",{key:n},l.default.createElement(d.default,{index:n,classes:e.props.config.classes,addCondition:e.addCondition,removeCondition:e.removeCondition}),l.default.createElement(p.default,{parameters:e.props.config.parameters,operators:e.props.config.operators,condition:t,index:n,classes:e.props.config.classes,onChange:e.updateCondition}))});return l.default.createElement("div",{className:"form-horizontal"},t)}}]),t}(u.Component);t.default=h},function(e,t,n){"use strict";function r(e){return e&&e.__esModule?e:{default:e}}var o=n(5),i=r(o),a=n(13),s=r(a),u=n(93),l=r(u),c=window.$;if(c.fn.filterer=function(e){e.operators=[{name:"contains",types:["string","str"]},{name:"does not contain",types:["string","str"]},{name:"is",types:["string","str","number","int","float"]},{name:"is not",types:["string","str","number","int","float"]},{name:"begins with",types:["string","str"]},{name:"does not begin with",types:["string","str"]},{name:"ends with",types:["string","str"]},{name:"does not end with",types:["string","str"]},{name:"is greater than",types:["number","int","float"]},{name:"is less than",types:["number","int","float"]}],e.classes=Object.assign({plusIcon:"fa fa-fw fa-plus",minusIcon:"fa fa-fw fa-minus",filterLineRow:"form-group",filterLineParameter:"col-sm-4",filterLineOperator:"col-sm-3",filterLineValue:"col-sm-5",filterLineInput:"form-control",filterLineLabelRow:"row",filterLineLabelCondition:"col-sm-10",filterLineLabelControls:"col-sm-2 text-right"},e.classes),this.each(function(){s.default.render(i.default.createElement(l.default,{id:"filterer",config:e}),this)})},window.wcomartin_filterer_demo){var p={parameters:[{name:"Title",type:"string",value:"title"},{name:"Year",type:"number",value:"year"}],conditions:[{parameter:"year",operator:"is",value:[2017]}]};p.updateConditions=function(e){console.log(JSON.stringify(e))},c("#root").filterer(p)}},function(e,t){e.exports=function(){for(var e=arguments.length,t=[],n=0;n<e;n++)t[n]=arguments[n];if(t=t.filter(function(e){return null!=e}),0!==t.length)return 1===t.length?t[0]:t.reduce(function(e,t){return function(){e.apply(this,arguments),t.apply(this,arguments)}})}},function(e,t,n){"use strict";function r(e,t){e.classList?e.classList.add(t):(0,i.default)(e,t)||("string"==typeof e.className?e.className=e.className+" "+t:e.setAttribute("class",(e.className&&e.className.baseVal||"")+" "+t))}var o=n(35);t.__esModule=!0,t.default=r;var i=o(n(97));e.exports=t.default},function(e,t){"use strict";function n(e,t){return e.classList?!!t&&e.classList.contains(t):(" "+(e.className.baseVal||e.className)+" ").indexOf(" "+t+" ")!==-1}t.__esModule=!0,t.default=n,e.exports=t.default},function(e,t){"use strict";function n(e,t){return e.replace(new RegExp("(^|\\s)"+t+"(?:\\s|$)","g"),"$1").replace(/\s+/g," ").replace(/^\s*|\s*$/g,"")}e.exports=function(e,t){e.classList?e.classList.remove(t):"string"==typeof e.className?e.className=n(e.className,t):e.setAttribute("class",n(e.className&&e.className.baseVal||"",t))}},function(e,t,n){"use strict";function r(){for(var e,t,n=document.createElement("div").style,r={O:function(e){return"o"+e.toLowerCase()},Moz:function(e){return e.toLowerCase()},Webkit:function(e){return"webkit"+e},ms:function(e){return"MS"+e}},o=Object.keys(r),i="",a=0;a<o.length;a++){var s=o[a];if(s+"TransitionProperty"in n){i="-"+s.toLowerCase(),e=r[s]("TransitionEnd"),t=r[s]("AnimationEnd");break}}return!e&&"transitionProperty"in n&&(e="transitionend"),!t&&"animationName"in n&&(t="animationend"),n=null,{animationEnd:t,transitionEnd:e,prefix:i}}var o=n(35);t.__esModule=!0,t.default=t.animationEnd=t.animationDelay=t.animationTiming=t.animationDuration=t.animationName=t.transitionEnd=t.transitionDuration=t.transitionDelay=t.transitionTiming=t.transitionProperty=t.transform=void 0;var i=o(n(56)),a="transform";t.transform=a;var s,u,l;t.animationEnd=l,t.transitionEnd=u;var c,p,f,d;t.transitionDelay=d,t.transitionTiming=f,t.transitionDuration=p,t.transitionProperty=c;var h,m,v,g;if(t.animationDelay=g,t.animationTiming=v,t.animationDuration=m,t.animationName=h,i.default){var y=r();s=y.prefix,t.transitionEnd=u=y.transitionEnd,t.animationEnd=l=y.animationEnd,t.transform=a=s+"-"+a,t.transitionProperty=c=s+"-transition-property",t.transitionDuration=p=s+"-transition-duration",t.transitionDelay=d=s+"-transition-delay",t.transitionTiming=f=s+"-transition-timing-function",t.animationName=h=s+"-animation-name",t.animationDuration=m=s+"-animation-duration",t.animationTiming=v=s+"-animation-delay",t.animationDelay=g=s+"-animation-timing-function"}var b={transform:a,end:u,property:c,timing:f,delay:d,duration:p};t.default=b},function(e,t,n){"use strict";function r(e){var t=(new Date).getTime(),n=Math.max(0,16-(t-p)),r=setTimeout(e,n);return p=t,r}var o=n(35);t.__esModule=!0,t.default=void 0;var i,a=o(n(56)),s=["","webkit","moz","o","ms"],u="clearTimeout",l=r,c=function(e,t){return e+(e?t[0].toUpperCase()+t.substr(1):t)+"AnimationFrame"};a.default&&s.some(function(e){var t=c(e,"request");if(t in window)return u=c(e,"cancel"),l=function(e){return window[t](e)}});var p=(new Date).getTime();i=function(e){return l(e)},i.cancel=function(e){window[u]&&"function"==typeof window[u]&&window[u](e)};var f=i;t.default=f,e.exports=t.default},function(e,t){"use strict";function n(e){return e.replace(r,function(e,t){return t.toUpperCase()})}var r=/-(.)/g;e.exports=n},function(e,t,n){"use strict";function r(e){return o(e.replace(i,"ms-"))}var o=n(101),i=/^-ms-/;e.exports=r},function(e,t,n){"use strict";function r(e,t){return!(!e||!t)&&(e===t||!o(e)&&(o(t)?r(e,t.parentNode):"contains"in e?e.contains(t):!!e.compareDocumentPosition&&!!(16&e.compareDocumentPosition(t))))}var o=n(111);e.exports=r},function(e,t,n){"use strict";function r(e){var t=e.length;if(Array.isArray(e)||"object"!=typeof e&&"function"!=typeof e?a(!1):void 0,"number"!=typeof t?a(!1):void 0,0===t||t-1 in e?void 0:a(!1),"function"==typeof e.callee?a(!1):void 0,e.hasOwnProperty)try{return Array.prototype.slice.call(e)}catch(e){}for(var n=Array(t),r=0;r<t;r++)n[r]=e[r];return n}function o(e){return!!e&&("object"==typeof e||"function"==typeof e)&&"length"in e&&!("setInterval"in e)&&"number"!=typeof e.nodeType&&(Array.isArray(e)||"callee"in e||"item"in e)}function i(e){return o(e)?Array.isArray(e)?e.slice():r(e):[e]}var a=n(1);e.exports=i},function(e,t,n){"use strict";function r(e){var t=e.match(c);return t&&t[1].toLowerCase()}function o(e,t){var n=l;l?void 0:u(!1);var o=r(e),i=o&&s(o);if(i){n.innerHTML=i[1]+e+i[2];for(var c=i[0];c--;)n=n.lastChild}else n.innerHTML=e;var p=n.getElementsByTagName("script");p.length&&(t?void 0:u(!1),a(p).forEach(t));for(var f=Array.from(n.childNodes);n.lastChild;)n.removeChild(n.lastChild);return f}var i=n(7),a=n(104),s=n(106),u=n(1),l=i.canUseDOM?document.createElement("div"):null,c=/^\s*<(\w+)/;e.exports=o},function(e,t,n){"use strict";function r(e){return a?void 0:i(!1),f.hasOwnProperty(e)||(e="*"),s.hasOwnProperty(e)||("*"===e?a.innerHTML="<link />":a.innerHTML="<"+e+"></"+e+">",s[e]=!a.firstChild),s[e]?f[e]:null}var o=n(7),i=n(1),a=o.canUseDOM?document.createElement("div"):null,s={},u=[1,'<select multiple="true">',"</select>"],l=[1,"<table>","</table>"],c=[3,"<table><tbody><tr>","</tr></tbody></table>"],p=[1,'<svg xmlns="http://www.w3.org/2000/svg">',"</svg>"],f={"*":[1,"?<div>","</div>"],area:[1,"<map>","</map>"],col:[2,"<table><tbody></tbody><colgroup>","</colgroup></table>"],legend:[1,"<fieldset>","</fieldset>"],param:[1,"<object>","</object>"],tr:[2,"<table><tbody>","</tbody></table>"],optgroup:u,option:u,caption:l,colgroup:l,tbody:l,tfoot:l,thead:l,td:c,th:c},d=["circle","clipPath","defs","ellipse","g","image","line","linearGradient","mask","path","pattern","polygon","polyline","radialGradient","rect","stop","text","tspan"];d.forEach(function(e){f[e]=p,s[e]=!0}),e.exports=r},function(e,t){"use strict";function n(e){return e.Window&&e instanceof e.Window?{x:e.pageXOffset||e.document.documentElement.scrollLeft,y:e.pageYOffset||e.document.documentElement.scrollTop}:{x:e.scrollLeft,y:e.scrollTop}}e.exports=n},function(e,t){"use strict";function n(e){return e.replace(r,"-$1").toLowerCase()}var r=/([A-Z])/g;e.exports=n},function(e,t,n){"use strict";function r(e){return o(e).replace(i,"-ms-")}var o=n(108),i=/^ms-/;e.exports=r},function(e,t){"use strict";function n(e){var t=e?e.ownerDocument||e:document,n=t.defaultView||window;return!(!e||!("function"==typeof n.Node?e instanceof n.Node:"object"==typeof e&&"number"==typeof e.nodeType&&"string"==typeof e.nodeName))}e.exports=n},function(e,t,n){"use strict";function r(e){return o(e)&&3==e.nodeType}var o=n(110);e.exports=r},function(e,t){"use strict";function n(e){var t={};return function(n){return t.hasOwnProperty(n)||(t[n]=e.call(this,n)),t[n]}}e.exports=n},function(e,t){function n(e,t){var n,r=function(o){return e.length>1?function(){var i=o?o.concat():[];return n=t?n||this:this,i.push.apply(i,arguments)<e.length&&arguments.length?r.call(n,i):e.apply(n,i)}:e};return r()}var r,o,i,a,s,u,l={}.toString;r=n(function(e,t){return e.apply(null,t)}),o=function(e){return n(e)},i=n(function(e,t,n){return e(n,t)}),a=function(e){return function(t){return function(){return e(t(t)).apply(null,arguments)}}(function(t){return function(){return e(t(t)).apply(null,arguments)}})},s=n(function(e,t,n,r){return e(t(n),t(r))}),u=function(e){var t;return t={},function(){var n,r,o,i,a,s;for(r=[],o=0,i=arguments.length;o<i;++o)r.push(arguments[o]);return n=r,a=function(){var e,t,r,o=[];for(e=0,r=(t=n).length;e<r;++e)s=t[e],o.push(s+l.call(s).slice(8,-1));return o}().join(""),t[a]=a in t?t[a]:e.apply(null,n)}},e.exports={curry:o,flip:i,fix:a,apply:r,over:s,memoize:u}},function(e,t){function n(e,t){var n,r=function(o){return e.length>1?function(){var i=o?o.concat():[];return n=t?n||this:this,i.push.apply(i,arguments)<e.length&&arguments.length?r.call(n,i):e.apply(n,i)}:e};return r()}function r(e,t){for(var n=-1,r=t.length>>>0;++n<r;)if(e===t[n])return!0;return!1}function o(){var e=arguments;return function(){var t,n;for(n=e[0].apply(this,arguments),t=1;t<e.length;++t)n=e[t](n);return n}}function i(e){return!e}var a,s,u,l,c,p,f,d,h,m,v,g,y,b,C,_,w,E,T,x,O,P,k,S,N,M,A,I,D,R,L,U,F,j,B,V,W,H,q,z,K,Y,X,G,Q,$,Z,J,ee,te,ne,re,oe,ie,ae,se,ue,le,ce,pe,fe,de,he,me,ve,ge,ye,be,Ce,_e,we={}.toString;a=n(function(e,t){var n,r,o;for(n=0,r=t.length;n<r;++n)o=t[n],e(o);return t}),s=n(function(e,t){var n,r,o,i=[];for(n=0,r=t.length;n<r;++n)o=t[n],i.push(e(o));return i}),u=function(e){var t,n,r,o=[];for(t=0,n=e.length;t<n;++t)r=e[t],r&&o.push(r);return o},l=n(function(e,t){var n,r,o,i=[];for(n=0,r=t.length;n<r;++n)o=t[n],e(o)&&i.push(o);return i}),c=n(function(e,t){var n,r,o,i=[];for(n=0,r=t.length;n<r;++n)o=t[n],e(o)||i.push(o);return i}),p=n(function(e,t){var n,r;return n=ye(e,t),r=t.slice(),null!=n&&r.splice(n,1),r}),f=n(function(e,t){var n,r,o,i,a;for(n=[],r=[],o=0,i=t.length;o<i;++o)a=t[o],(e(a)?n:r).push(a);return[n,r]}),d=n(function(e,t){var n,r,o;for(n=0,r=t.length;n<r;++n)if(o=t[n],e(o))return o}),h=m=function(e){return e[0]},v=function(e){if(e.length)return e.slice(1)},g=function(e){return e[e.length-1]},y=function(e){if(e.length)return e.slice(0,-1)},b=function(e){return!e.length},C=function(e){return e.concat().reverse()},_=function(e){var t,n,o,i;for(t=[],n=0,o=e.length;n<o;++n)i=e[n],r(i,t)||t.push(i);return t},w=n(function(e,t){var n,o,i,a,s,u=[];for(n=[],o=0,i=t.length;o<i;++o)a=t[o],s=e(a),r(s,n)||(n.push(s),u.push(a));return u}),E=T=n(function(e,t,n){var r,o,i;for(r=0,o=n.length;r<o;++r)i=n[r],t=e(t,i);return t}),x=O=n(function(e,t){return E(e,t[0],t.slice(1))}),P=n(function(e,t,n){var r,o;for(r=n.length-1;r>=0;--r)o=n[r],t=e(o,t);return t}),k=n(function(e,t){return P(e,t[t.length-1],t.slice(0,-1))}),S=n(function(e,t){var n,r,o;for(n=[],r=t;null!=(o=e(r));)n.push(o[0]),r=o[1];return n}),N=function(e){return[].concat.apply([],e)},M=n(function(e,t){var n;
-return[].concat.apply([],function(){var r,o,i,a=[];for(r=0,i=(o=t).length;r<i;++r)n=o[r],a.push(e(n));return a}())}),A=function(e){var t;return[].concat.apply([],function(){var n,r,o,i=[];for(n=0,o=(r=e).length;n<o;++n)t=r[n],"Array"===we.call(t).slice(8,-1)?i.push(A(t)):i.push(t);return i}())},I=function(e){var t,n,o,i,a,s,u,l,c,p;for(n=[],o=1,i=arguments.length;o<i;++o)n.push(arguments[o]);t=n,a=[];e:for(o=0,s=e.length;o<s;++o){for(u=e[o],l=0,c=t.length;l<c;++l)if(p=t[l],r(u,p))continue e;a.push(u)}return a},D=function(e){var t,n,o,i,a,s,u,l,c,p;for(n=[],o=1,i=arguments.length;o<i;++o)n.push(arguments[o]);t=n,a=[];e:for(o=0,s=e.length;o<s;++o){for(u=e[o],l=0,c=t.length;l<c;++l)if(p=t[l],!r(u,p))continue e;a.push(u)}return a},R=function(){var e,t,n,o,i,a,s,u,l,c;for(t=[],n=0,o=arguments.length;n<o;++n)t.push(arguments[n]);for(e=t,i=[],n=0,a=e.length;n<a;++n)for(s=e[n],u=0,l=s.length;u<l;++u)c=s[u],r(c,i)||i.push(c);return i},L=n(function(e,t){var n,r,o,i,a;for(n={},r=0,o=t.length;r<o;++r)i=t[r],a=e(i),a in n?n[a]+=1:n[a]=1;return n}),U=n(function(e,t){var n,r,o,i,a;for(n={},r=0,o=t.length;r<o;++r)i=t[r],a=e(i),a in n?n[a].push(i):n[a]=[i];return n}),F=function(e){var t,n,r;for(t=0,n=e.length;t<n;++t)if(r=e[t],!r)return!1;return!0},j=function(e){var t,n,r;for(t=0,n=e.length;t<n;++t)if(r=e[t])return!0;return!1},B=n(function(e,t){var n,r,o;for(n=0,r=t.length;n<r;++n)if(o=t[n],e(o))return!0;return!1}),V=n(function(e,t){var n,r,o;for(n=0,r=t.length;n<r;++n)if(o=t[n],!e(o))return!1;return!0}),W=function(e){return e.concat().sort(function(e,t){return e>t?1:e<t?-1:0})},H=n(function(e,t){return t.concat().sort(e)}),q=n(function(e,t){return t.concat().sort(function(t,n){return e(t)>e(n)?1:e(t)<e(n)?-1:0})}),z=function(e){var t,n,r,o;for(t=0,n=0,r=e.length;n<r;++n)o=e[n],t+=o;return t},K=function(e){var t,n,r,o;for(t=1,n=0,r=e.length;n<r;++n)o=e[n],t*=o;return t},Y=X=function(e){var t,n,r,o;for(t=0,n=0,r=e.length;n<r;++n)o=e[n],t+=o;return t/e.length},G=function(e){var t,n,r,o,i;for(t=e[0],n=0,o=(r=e.slice(1)).length;n<o;++n)i=r[n],i>t&&(t=i);return t},Q=function(e){var t,n,r,o,i;for(t=e[0],n=0,o=(r=e.slice(1)).length;n<o;++n)i=r[n],i<t&&(t=i);return t},$=n(function(e,t){var n,r,o,i,a;for(n=t[0],r=0,i=(o=t.slice(1)).length;r<i;++r)a=o[r],e(a)>e(n)&&(n=a);return n}),Z=n(function(e,t){var n,r,o,i,a;for(n=t[0],r=0,i=(o=t.slice(1)).length;r<i;++r)a=o[r],e(a)<e(n)&&(n=a);return n}),J=ee=n(function(e,t,n){var r,o;return r=t,[t].concat(function(){var t,i,a,s=[];for(t=0,a=(i=n).length;t<a;++t)o=i[t],s.push(r=e(r,o));return s}())}),te=ne=n(function(e,t){if(t.length)return J(e,t[0],t.slice(1))}),re=n(function(e,t,n){return n=n.concat().reverse(),J(e,t,n).reverse()}),oe=n(function(e,t){if(t.length)return t=t.concat().reverse(),J(e,t[0],t.slice(1)).reverse()}),ie=n(function(e,t,n){return n.slice(e,t)}),ae=n(function(e,t){return e<=0?t.slice(0,0):t.slice(0,e)}),se=n(function(e,t){return e<=0?t:t.slice(e)}),ue=n(function(e,t){return[ae(e,t),se(e,t)]}),le=n(function(e,t){var n,r;if(n=t.length,!n)return t;for(r=0;r<n&&e(t[r]);)r+=1;return t.slice(0,r)}),ce=n(function(e,t){var n,r;if(n=t.length,!n)return t;for(r=0;r<n&&e(t[r]);)r+=1;return t.slice(r)}),pe=n(function(e,t){return[le(e,t),ce(e,t)]}),fe=n(function(e,t){return pe(o(e,i),t)}),de=n(function(e,t){var n,r,o,i,a,s;for(n=[],r=t.length,o=0,i=e.length;o<i&&(a=o,s=e[o],a!==r);++o)n.push([s,t[a]]);return n}),he=n(function(e,t,n){var r,o,i,a,s,u;for(r=[],o=n.length,i=0,a=t.length;i<a&&(s=i,u=t[i],s!==o);++i)r.push(e(u,n[s]));return r}),me=function(){var e,t,n,r,o,i,a,s,u,l,c,p=[];for(t=[],n=0,r=arguments.length;n<r;++n)t.push(arguments[n]);for(e=t,o=void 0,n=0,i=e.length;n<i;++n)a=e[n],o<=(s=a.length)||(o=s);for(n=0;n<o;++n){for(u=n,l=[],c=0,i=e.length;c<i;++c)a=e[c],l.push(a[u]);p.push(l)}return p},ve=function(e){function t(){var e,t,r,o=[];for(e=0,r=(t=n).length;e<r;++e)u=t[e],o.push(u[c]);return o}var n,r,o,i,a,s,u,l,c,p=[];for(r=[],o=1,i=arguments.length;o<i;++o)r.push(arguments[o]);for(n=r,a=void 0,o=0,s=n.length;o<s;++o)u=n[o],a<=(l=u.length)||(a=l);for(o=0;o<a;++o)c=o,p.push(e.apply(null,t()));return p},ge=n(function(e,t){return e<0?t[t.length+e]:t[e]}),ye=n(function(e,t){var n,r,o,i;for(n=0,r=t.length;n<r;++n)if(o=n,i=t[n],i===e)return o}),be=n(function(e,t){var n,r,o,i,a=[];for(n=0,r=t.length;n<r;++n)o=n,i=t[n],i===e&&a.push(o);return a}),Ce=n(function(e,t){var n,r,o,i;for(n=0,r=t.length;n<r;++n)if(o=n,i=t[n],e(i))return o}),_e=n(function(e,t){var n,r,o,i,a=[];for(n=0,r=t.length;n<r;++n)o=n,i=t[n],e(i)&&a.push(o);return a}),e.exports={each:a,map:s,filter:l,compact:u,reject:c,remove:p,partition:f,find:d,head:h,first:m,tail:v,last:g,initial:y,empty:b,reverse:C,difference:I,intersection:D,union:R,countBy:L,groupBy:U,fold:E,fold1:x,foldl:T,foldl1:O,foldr:P,foldr1:k,unfoldr:S,andList:F,orList:j,any:B,all:V,unique:_,uniqueBy:w,sort:W,sortWith:H,sortBy:q,sum:z,product:K,mean:Y,average:X,concat:N,concatMap:M,flatten:A,maximum:G,minimum:Q,maximumBy:$,minimumBy:Z,scan:J,scan1:te,scanl:ee,scanl1:ne,scanr:re,scanr1:oe,slice:ie,take:ae,drop:se,splitAt:ue,takeWhile:le,dropWhile:ce,span:pe,breakList:fe,zip:de,zipWith:he,zipAll:me,zipAllWith:ve,at:ge,elemIndex:ye,elemIndices:be,findIndex:Ce,findIndices:_e}},function(e,t){function n(e,t){var n,r=function(o){return e.length>1?function(){var i=o?o.concat():[];return n=t?n||this:this,i.push.apply(i,arguments)<e.length&&arguments.length?r.call(n,i):e.apply(n,i)}:e};return r()}var r,o,i,a,s,u,l,c,p,f,d,h,m,v,g,y,b,C,_,w,E,T,x,O,P,k,S,N,M,A,I,D;r=n(function(e,t){return e>t?e:t}),o=n(function(e,t){return e<t?e:t}),i=function(e){return-e},a=Math.abs,s=function(e){return e<0?-1:e>0?1:0},u=n(function(e,t){return~~(e/t)}),l=n(function(e,t){return e%t}),c=n(function(e,t){return Math.floor(e/t)}),p=n(function(e,t){var n;return(e%(n=t)+n)%n}),f=function(e){return 1/e},d=Math.PI,h=2*d,m=Math.exp,v=Math.sqrt,g=Math.log,y=n(function(e,t){return Math.pow(e,t)}),b=Math.sin,C=Math.tan,_=Math.cos,w=Math.asin,E=Math.acos,T=Math.atan,x=n(function(e,t){return Math.atan2(e,t)}),O=function(e){return~~e},P=Math.round,k=Math.ceil,S=Math.floor,N=function(e){return e!==e},M=function(e){return e%2===0},A=function(e){return e%2!==0},I=n(function(e,t){var n;for(e=Math.abs(e),t=Math.abs(t);0!==t;)n=e%t,e=t,t=n;return e}),D=n(function(e,t){return Math.abs(Math.floor(e/I(e,t)*t))}),e.exports={max:r,min:o,negate:i,abs:a,signum:s,quot:u,rem:l,div:c,mod:p,recip:f,pi:d,tau:h,exp:m,sqrt:v,ln:g,pow:y,sin:b,tan:C,cos:_,acos:E,asin:w,atan:T,atan2:x,truncate:O,round:P,ceiling:k,floor:S,isItNaN:N,even:M,odd:A,gcd:I,lcm:D}},function(e,t){function n(e,t){var n,r=function(o){return e.length>1?function(){var i=o?o.concat():[];return n=t?n||this:this,i.push.apply(i,arguments)<e.length&&arguments.length?r.call(n,i):e.apply(n,i)}:e};return r()}var r,o,i,a,s,u,l,c,p,f,d,h,m,v;r=function(e){var t,n,r=[];for(t in e)n=e[t],r.push(n);return r},o=function(e){var t,n=[];for(t in e)n.push(t);return n},i=function(e){var t,n,r,o={};for(t=0,n=e.length;t<n;++t)r=e[t],o[r[0]]=r[1];return o},a=function(e){var t,n,r=[];for(t in e)n=e[t],r.push([t,n]);return r},s=n(function(e,t){var n,r,o,i,a={};for(n=0,r=e.length;n<r;++n)o=n,i=e[n],a[i]=t[o];return a}),u=function(e){var t,n,r,o;t=[],n=[];for(r in e)o=e[r],t.push(r),n.push(o);return[t,n]},l=function(e){var t;for(t in e)return!1;return!0},c=n(function(e,t){var n,r;for(n in t)r=t[n],e(r);return t}),p=n(function(e,t){var n,r,o={};for(n in t)r=t[n],o[n]=e(r);return o}),f=function(e){var t,n,r={};for(t in e)n=e[t],n&&(r[t]=n);return r},d=n(function(e,t){var n,r,o={};for(n in t)r=t[n],e(r)&&(o[n]=r);return o}),h=n(function(e,t){var n,r,o={};for(n in t)r=t[n],e(r)||(o[n]=r);return o}),m=n(function(e,t){var n,r,o,i;n={},r={};for(o in t)i=t[o],(e(i)?n:r)[o]=i;return[n,r]}),v=n(function(e,t){var n,r;for(n in t)if(r=t[n],e(r))return r}),e.exports={values:r,keys:o,pairsToObj:i,objToPairs:a,listsToObj:s,objToLists:u,empty:l,each:c,map:p,filter:d,compact:f,reject:h,partition:m,find:v}},function(e,t){function n(e,t){var n,r=function(o){return e.length>1?function(){var i=o?o.concat():[];return n=t?n||this:this,i.push.apply(i,arguments)<e.length&&arguments.length?r.call(n,i):e.apply(n,i)}:e};return r()}var r,o,i,a,s,u,l,c,p,f,d,h,m;r=n(function(e,t){return t.split(e)}),o=n(function(e,t){return t.join(e)}),i=function(e){return e.length?e.split("\n"):[]},a=function(e){return e.join("\n")},s=function(e){return e.length?e.split(/[ ]+/):[]},u=function(e){return e.join(" ")},l=function(e){return e.split("")},c=function(e){return e.join("")},p=function(e){return e.split("").reverse().join("")},f=n(function(e,t){var n,r;for(n="",r=0;r<e;++r)n+=t;return n}),d=function(e){return e.charAt(0).toUpperCase()+e.slice(1)},h=function(e){return e.replace(/[-_]+(.)?/g,function(e,t){return(null!=t?t:"").toUpperCase()})},m=function(e){return e.replace(/([^-A-Z])([A-Z]+)/g,function(e,t,n){return t+"-"+(n.length>1?n:n.toLowerCase())}).replace(/^([A-Z]+)/,function(e,t){return t.length>1?t+"-":t.toLowerCase()})},e.exports={split:r,join:o,lines:i,unlines:a,words:s,unwords:u,chars:l,unchars:c,reverse:p,repeat:f,capitalize:d,camelize:h,dasherize:m}},[227,113,114,116,117,115],function(e,t,n){"use strict";function r(e){var t=new o(o._61);return t._81=1,t._65=e,t}var o=n(61);e.exports=o;var i=r(!0),a=r(!1),s=r(null),u=r(void 0),l=r(0),c=r("");o.resolve=function(e){if(e instanceof o)return e;if(null===e)return s;if(void 0===e)return u;if(e===!0)return i;if(e===!1)return a;if(0===e)return l;if(""===e)return c;if("object"==typeof e||"function"==typeof e)try{var t=e.then;if("function"==typeof t)return new o(t.bind(e))}catch(e){return new o(function(t,n){n(e)})}return r(e)},o.all=function(e){var t=Array.prototype.slice.call(e);return new o(function(e,n){function r(a,s){if(s&&("object"==typeof s||"function"==typeof s)){if(s instanceof o&&s.then===o.prototype.then){for(;3===s._81;)s=s._65;return 1===s._81?r(a,s._65):(2===s._81&&n(s._65),void s.then(function(e){r(a,e)},n))}var u=s.then;if("function"==typeof u){var l=new o(u.bind(s));return void l.then(function(e){r(a,e)},n)}}t[a]=s,0===--i&&e(t)}if(0===t.length)return e([]);for(var i=t.length,a=0;a<t.length;a++)r(a,t[a])})},o.reject=function(e){return new o(function(t,n){n(e)})},o.race=function(e){return new o(function(t,n){e.forEach(function(e){o.resolve(e).then(t,n)})})},o.prototype.catch=function(e){return this.then(null,e)}},function(e,t,n){"use strict";function r(){l=!1,s._10=null,s._97=null}function o(e){function t(t){(e.allRejections||a(p[t].error,e.whitelist||u))&&(p[t].displayId=c++,e.onUnhandled?(p[t].logged=!0,e.onUnhandled(p[t].displayId,p[t].error)):(p[t].logged=!0,i(p[t].displayId,p[t].error)))}function n(t){p[t].logged&&(e.onHandled?e.onHandled(p[t].displayId,p[t].error):p[t].onUnhandled||(console.warn("Promise Rejection Handled (id: "+p[t].displayId+"):"),console.warn('  This means you can ignore any previous messages of the form "Possible Unhandled Promise Rejection" with id '+p[t].displayId+".")))}e=e||{},l&&r(),l=!0;var o=0,c=0,p={};s._10=function(e){2===e._81&&p[e._72]&&(p[e._72].logged?n(e._72):clearTimeout(p[e._72].timeout),delete p[e._72])},s._97=function(e,n){0===e._45&&(e._72=o++,p[e._72]={displayId:null,error:n,timeout:setTimeout(t.bind(null,e._72),a(n,u)?100:2e3),logged:!1})}}function i(e,t){console.warn("Possible Unhandled Promise Rejection (id: "+e+"):");var n=(t&&(t.stack||t))+"";n.split("\n").forEach(function(e){console.warn("  "+e)})}function a(e,t){return t.some(function(t){return e instanceof t})}var s=n(61),u=[ReferenceError,TypeError,RangeError],l=!1;t.disable=r,t.enable=o},function(e,t,n){"use strict";function r(e,t,n,r,o){}e.exports=r},function(e,t,n){"use strict";var r=n(8),o=n(1),i=(n(2),n(123)),a=n(121);e.exports=function(e,t){function n(e){var t=e&&(x&&e[x]||e[O]);if("function"==typeof t)return t}function s(e,t){return e===t?0!==e||1/e===1/t:e!==e&&t!==t}function u(e){this.message=e,this.stack=""}function l(e){function n(n,r,a,s,l,c,p){if(s=s||P,c=c||a,p!==i)if(t)o(!1,"Calling PropTypes validators directly is not supported by the `prop-types` package. Use `PropTypes.checkPropTypes()` to call them. Read more at http://fb.me/use-check-prop-types");else;return null==r[a]?n?new u(null===r[a]?"The "+l+" `"+c+"` is marked as required "+("in `"+s+"`, but its value is `null`."):"The "+l+" `"+c+"` is marked as required in "+("`"+s+"`, but its value is `undefined`.")):null:e(r,a,s,l,c)}var r=n.bind(null,!1);return r.isRequired=n.bind(null,!0),r}function c(e){function t(t,n,r,o,i,a){var s=t[n],l=w(s);if(l!==e){var c=E(s);return new u("Invalid "+o+" `"+i+"` of type "+("`"+c+"` supplied to `"+r+"`, expected ")+("`"+e+"`."))}return null}return l(t)}function p(){return l(r.thatReturnsNull)}function f(e){function t(t,n,r,o,a){if("function"!=typeof e)return new u("Property `"+a+"` of component `"+r+"` has invalid PropType notation inside arrayOf.");var s=t[n];if(!Array.isArray(s)){var l=w(s);return new u("Invalid "+o+" `"+a+"` of type "+("`"+l+"` supplied to `"+r+"`, expected an array."))}for(var c=0;c<s.length;c++){var p=e(s,c,r,o,a+"["+c+"]",i);if(p instanceof Error)return p}return null}return l(t)}function d(){function t(t,n,r,o,i){var a=t[n];if(!e(a)){var s=w(a);return new u("Invalid "+o+" `"+i+"` of type "+("`"+s+"` supplied to `"+r+"`, expected a single ReactElement."))}return null}return l(t)}function h(e){function t(t,n,r,o,i){if(!(t[n]instanceof e)){var a=e.name||P,s=T(t[n]);return new u("Invalid "+o+" `"+i+"` of type "+("`"+s+"` supplied to `"+r+"`, expected ")+("instance of `"+a+"`."))}return null}return l(t)}function m(e){function t(t,n,r,o,i){for(var a=t[n],l=0;l<e.length;l++)if(s(a,e[l]))return null;var c=JSON.stringify(e);return new u("Invalid "+o+" `"+i+"` of value `"+a+"` "+("supplied to `"+r+"`, expected one of "+c+"."))}return Array.isArray(e)?l(t):r.thatReturnsNull}function v(e){function t(t,n,r,o,a){if("function"!=typeof e)return new u("Property `"+a+"` of component `"+r+"` has invalid PropType notation inside objectOf.");var s=t[n],l=w(s);if("object"!==l)return new u("Invalid "+o+" `"+a+"` of type "+("`"+l+"` supplied to `"+r+"`, expected an object."));for(var c in s)if(s.hasOwnProperty(c)){var p=e(s,c,r,o,a+"."+c,i);if(p instanceof Error)return p}return null}return l(t)}function g(e){function t(t,n,r,o,a){for(var s=0;s<e.length;s++){var l=e[s];if(null==l(t,n,r,o,a,i))return null}return new u("Invalid "+o+" `"+a+"` supplied to "+("`"+r+"`."))}return Array.isArray(e)?l(t):r.thatReturnsNull}function y(){function e(e,t,n,r,o){return C(e[t])?null:new u("Invalid "+r+" `"+o+"` supplied to "+("`"+n+"`, expected a ReactNode."))}return l(e)}function b(e){function t(t,n,r,o,a){var s=t[n],l=w(s);if("object"!==l)return new u("Invalid "+o+" `"+a+"` of type `"+l+"` "+("supplied to `"+r+"`, expected `object`."));for(var c in e){var p=e[c];if(p){var f=p(s,c,r,o,a+"."+c,i);if(f)return f}}return null}return l(t)}function C(t){switch(typeof t){case"number":case"string":case"undefined":return!0;case"boolean":return!t;case"object":if(Array.isArray(t))return t.every(C);if(null===t||e(t))return!0;var r=n(t);if(!r)return!1;var o,i=r.call(t);if(r!==t.entries){for(;!(o=i.next()).done;)if(!C(o.value))return!1}else for(;!(o=i.next()).done;){var a=o.value;if(a&&!C(a[1]))return!1}return!0;default:return!1}}function _(e,t){return"symbol"===e||("Symbol"===t["@@toStringTag"]||"function"==typeof Symbol&&t instanceof Symbol)}function w(e){var t=typeof e;return Array.isArray(e)?"array":e instanceof RegExp?"object":_(t,e)?"symbol":t}function E(e){var t=w(e);if("object"===t){if(e instanceof Date)return"date";if(e instanceof RegExp)return"regexp"}return t}function T(e){return e.constructor&&e.constructor.name?e.constructor.name:P}var x="function"==typeof Symbol&&Symbol.iterator,O="@@iterator",P="<<anonymous>>",k={array:c("array"),bool:c("boolean"),func:c("function"),number:c("number"),object:c("object"),string:c("string"),symbol:c("symbol"),any:p(),arrayOf:f,element:d(),instanceOf:h,node:y(),objectOf:v,oneOf:m,oneOfType:g,shape:b};return u.prototype=Error.prototype,k.checkPropTypes=a,k.PropTypes=k,k}},function(e,t){"use strict";var n="SECRET_DO_NOT_PASS_THIS_OR_YOU_WILL_BE_FIRED";e.exports=n},function(e,t){"use strict";function n(e,t){return e===t?0!==e||0!==t||1/e===1/t:e!==e&&t!==t}function r(e,t){if(n(e,t))return!0;if("object"!=typeof e||null===e||"object"!=typeof t||null===t)return!1;var r=Object.keys(e),o=Object.keys(t);if(r.length!==o.length)return!1;for(var a=0;a<r.length;a++)if(!i.call(t,r[a])||!n(e[r[a]],t[r[a]]))return!1;return!0}function o(e,t,n){return!r(e.props,t)||!r(e.state,n)}var i=Object.prototype.hasOwnProperty;e.exports=o},function(e,t){"use strict";var n={Properties:{"aria-current":0,"aria-details":0,"aria-disabled":0,"aria-hidden":0,"aria-invalid":0,"aria-keyshortcuts":0,"aria-label":0,"aria-roledescription":0,"aria-autocomplete":0,"aria-checked":0,"aria-expanded":0,"aria-haspopup":0,"aria-level":0,"aria-modal":0,"aria-multiline":0,"aria-multiselectable":0,"aria-orientation":0,"aria-placeholder":0,"aria-pressed":0,"aria-readonly":0,"aria-required":0,"aria-selected":0,"aria-sort":0,"aria-valuemax":0,"aria-valuemin":0,"aria-valuenow":0,"aria-valuetext":0,"aria-atomic":0,"aria-busy":0,"aria-live":0,"aria-relevant":0,"aria-dropeffect":0,"aria-grabbed":0,"aria-activedescendant":0,"aria-colcount":0,"aria-colindex":0,"aria-colspan":0,"aria-controls":0,"aria-describedby":0,"aria-errormessage":0,"aria-flowto":0,"aria-labelledby":0,"aria-owns":0,"aria-posinset":0,"aria-rowcount":0,"aria-rowindex":0,"aria-rowspan":0,"aria-setsize":0},DOMAttributeNames:{},DOMPropertyNames:{}};e.exports=n},function(e,t,n){"use strict";var r=n(6),o=n(58),i={focusDOMComponent:function(){o(r.getNodeFromInstance(this))}};e.exports=i},function(e,t,n){"use strict";function r(){var e=window.opera;return"object"==typeof e&&"function"==typeof e.version&&parseInt(e.version(),10)<=12}function o(e){return(e.ctrlKey||e.altKey||e.metaKey)&&!(e.ctrlKey&&e.altKey)}function i(e){switch(e){case"topCompositionStart":return O.compositionStart;case"topCompositionEnd":return O.compositionEnd;case"topCompositionUpdate":return O.compositionUpdate}}function a(e,t){return"topKeyDown"===e&&t.keyCode===b}function s(e,t){switch(e){case"topKeyUp":return y.indexOf(t.keyCode)!==-1;case"topKeyDown":return t.keyCode!==b;case"topKeyPress":case"topMouseDown":case"topBlur":return!0;default:return!1}}function u(e){var t=e.detail;return"object"==typeof t&&"data"in t?t.data:null}function l(e,t,n,r){var o,l;if(C?o=i(e):k?s(e,n)&&(o=O.compositionEnd):a(e,n)&&(o=O.compositionStart),!o)return null;E&&(k||o!==O.compositionStart?o===O.compositionEnd&&k&&(l=k.getData()):k=m.getPooled(r));var c=v.getPooled(o,t,n,r);if(l)c.data=l;else{var p=u(n);null!==p&&(c.data=p)}return d.accumulateTwoPhaseDispatches(c),c}function c(e,t){switch(e){case"topCompositionEnd":return u(t);case"topKeyPress":var n=t.which;return n!==T?null:(P=!0,x);case"topTextInput":var r=t.data;return r===x&&P?null:r;default:return null}}function p(e,t){if(k){if("topCompositionEnd"===e||!C&&s(e,t)){var n=k.getData();return m.release(k),k=null,n}return null}switch(e){case"topPaste":return null;case"topKeyPress":return t.which&&!o(t)?String.fromCharCode(t.which):null;case"topCompositionEnd":return E?null:t.data;default:return null}}function f(e,t,n,r){var o;if(o=w?c(e,n):p(e,n),!o)return null;var i=g.getPooled(O.beforeInput,t,n,r);return i.data=o,d.accumulateTwoPhaseDispatches(i),i}var d=n(25),h=n(7),m=n(133),v=n(170),g=n(173),y=[9,13,27,32],b=229,C=h.canUseDOM&&"CompositionEvent"in window,_=null;h.canUseDOM&&"documentMode"in document&&(_=document.documentMode);var w=h.canUseDOM&&"TextEvent"in window&&!_&&!r(),E=h.canUseDOM&&(!C||_&&_>8&&_<=11),T=32,x=String.fromCharCode(T),O={beforeInput:{phasedRegistrationNames:{bubbled:"onBeforeInput",captured:"onBeforeInputCapture"},dependencies:["topCompositionEnd","topKeyPress","topTextInput","topPaste"]},compositionEnd:{phasedRegistrationNames:{bubbled:"onCompositionEnd",captured:"onCompositionEndCapture"},dependencies:["topBlur","topCompositionEnd","topKeyDown","topKeyPress","topKeyUp","topMouseDown"]},compositionStart:{phasedRegistrationNames:{bubbled:"onCompositionStart",captured:"onCompositionStartCapture"},dependencies:["topBlur","topCompositionStart","topKeyDown","topKeyPress","topKeyUp","topMouseDown"]},compositionUpdate:{phasedRegistrationNames:{bubbled:"onCompositionUpdate",captured:"onCompositionUpdateCapture"},dependencies:["topBlur","topCompositionUpdate","topKeyDown","topKeyPress","topKeyUp","topMouseDown"]}},P=!1,k=null,S={eventTypes:O,extractEvents:function(e,t,n,r){return[l(e,t,n,r),f(e,t,n,r)]}};e.exports=S},function(e,t,n){"use strict";var r=n(64),o=n(7),i=(n(9),n(102),n(179)),a=n(109),s=n(112),u=(n(2),s(function(e){return a(e)})),l=!1,c="cssFloat";if(o.canUseDOM){var p=document.createElement("div").style;try{p.font=""}catch(e){l=!0}void 0===document.documentElement.style.cssFloat&&(c="styleFloat")}var f={createMarkupForStyles:function(e,t){var n="";for(var r in e)if(e.hasOwnProperty(r)){var o=e[r];null!=o&&(n+=u(r)+":",n+=i(r,o,t)+";")}return n||null},setValueForStyles:function(e,t,n){var o=e.style;for(var a in t)if(t.hasOwnProperty(a)){var s=i(a,t[a],n);if("float"!==a&&"cssFloat"!==a||(a=c),s)o[a]=s;else{var u=l&&r.shorthandPropertyExpansions[a];if(u)for(var p in u)o[p]="";else o[a]=""}}}};e.exports=f},function(e,t,n){"use strict";function r(e){var t=e.nodeName&&e.nodeName.toLowerCase();return"select"===t||"input"===t&&"file"===e.type}function o(e){var t=T.getPooled(k.change,N,e,x(e));C.accumulateTwoPhaseDispatches(t),E.batchedUpdates(i,t)}function i(e){b.enqueueEvents(e),b.processEventQueue(!1)}function a(e,t){S=e,N=t,S.attachEvent("onchange",o)}function s(){S&&(S.detachEvent("onchange",o),S=null,N=null)}function u(e,t){if("topChange"===e)return t}function l(e,t,n){"topFocus"===e?(s(),a(t,n)):"topBlur"===e&&s()}function c(e,t){S=e,N=t,M=e.value,A=Object.getOwnPropertyDescriptor(e.constructor.prototype,"value"),Object.defineProperty(S,"value",R),S.attachEvent?S.attachEvent("onpropertychange",f):S.addEventListener("propertychange",f,!1)}function p(){S&&(delete S.value,S.detachEvent?S.detachEvent("onpropertychange",f):S.removeEventListener("propertychange",f,!1),S=null,N=null,M=null,A=null)}function f(e){if("value"===e.propertyName){var t=e.srcElement.value;t!==M&&(M=t,o(e))}}function d(e,t){if("topInput"===e)return t}function h(e,t,n){"topFocus"===e?(p(),c(t,n)):"topBlur"===e&&p()}function m(e,t){if(("topSelectionChange"===e||"topKeyUp"===e||"topKeyDown"===e)&&S&&S.value!==M)return M=S.value,N}function v(e){return e.nodeName&&"input"===e.nodeName.toLowerCase()&&("checkbox"===e.type||"radio"===e.type)}function g(e,t){if("topClick"===e)return t}function y(e,t){if(null!=e){var n=e._wrapperState||t._wrapperState;if(n&&n.controlled&&"number"===t.type){var r=""+t.value;t.getAttribute("value")!==r&&t.setAttribute("value",r)}}}var b=n(24),C=n(25),_=n(7),w=n(6),E=n(10),T=n(11),x=n(49),O=n(50),P=n(81),k={change:{phasedRegistrationNames:{bubbled:"onChange",captured:"onChangeCapture"},dependencies:["topBlur","topChange","topClick","topFocus","topInput","topKeyDown","topKeyUp","topSelectionChange"]}},S=null,N=null,M=null,A=null,I=!1;_.canUseDOM&&(I=O("change")&&(!document.documentMode||document.documentMode>8));var D=!1;_.canUseDOM&&(D=O("input")&&(!document.documentMode||document.documentMode>11));var R={get:function(){return A.get.call(this)},set:function(e){M=""+e,A.set.call(this,e)}},L={eventTypes:k,extractEvents:function(e,t,n,o){var i,a,s=t?w.getNodeFromInstance(t):window;if(r(s)?I?i=u:a=l:P(s)?D?i=d:(i=m,a=h):v(s)&&(i=g),i){var c=i(e,t);if(c){var p=T.getPooled(k.change,c,n,o);return p.type="change",C.accumulateTwoPhaseDispatches(p),p}}a&&a(e,s,t),"topBlur"===e&&y(t,s)}};e.exports=L},function(e,t,n){"use strict";var r=n(3),o=n(17),i=n(7),a=n(105),s=n(8),u=(n(1),{dangerouslyReplaceNodeWithMarkup:function(e,t){if(i.canUseDOM?void 0:r("56"),t?void 0:r("57"),"HTML"===e.nodeName?r("58"):void 0,"string"==typeof t){var n=a(t,s)[0];e.parentNode.replaceChild(n,e)}else o.replaceChildWithTree(e,t)}});e.exports=u},function(e,t){"use strict";var n=["ResponderEventPlugin","SimpleEventPlugin","TapEventPlugin","EnterLeaveEventPlugin","ChangeEventPlugin","SelectEventPlugin","BeforeInputEventPlugin"];e.exports=n},function(e,t,n){"use strict";var r=n(25),o=n(6),i=n(30),a={mouseEnter:{registrationName:"onMouseEnter",dependencies:["topMouseOut","topMouseOver"]},mouseLeave:{registrationName:"onMouseLeave",dependencies:["topMouseOut","topMouseOver"]}},s={eventTypes:a,extractEvents:function(e,t,n,s){if("topMouseOver"===e&&(n.relatedTarget||n.fromElement))return null;if("topMouseOut"!==e&&"topMouseOver"!==e)return null;var u;if(s.window===s)u=s;else{var l=s.ownerDocument;u=l?l.defaultView||l.parentWindow:window}var c,p;if("topMouseOut"===e){c=t;var f=n.relatedTarget||n.toElement;p=f?o.getClosestInstanceFromNode(f):null}else c=null,p=t;if(c===p)return null;var d=null==c?u:o.getNodeFromInstance(c),h=null==p?u:o.getNodeFromInstance(p),m=i.getPooled(a.mouseLeave,c,n,s);m.type="mouseleave",m.target=d,m.relatedTarget=h;var v=i.getPooled(a.mouseEnter,p,n,s);return v.type="mouseenter",v.target=h,v.relatedTarget=d,r.accumulateEnterLeaveDispatches(m,v,c,p),[m,v]}};e.exports=s},function(e,t,n){"use strict";function r(e){this._root=e,this._startText=this.getText(),this._fallbackText=null}var o=n(4),i=n(14),a=n(79);o(r.prototype,{destructor:function(){this._root=null,this._startText=null,this._fallbackText=null},getText:function(){return"value"in this._root?this._root.value:this._root[a()]},getData:function(){if(this._fallbackText)return this._fallbackText;var e,t,n=this._startText,r=n.length,o=this.getText(),i=o.length;for(e=0;e<r&&n[e]===o[e];e++);var a=r-e;for(t=1;t<=a&&n[r-t]===o[i-t];t++);var s=t>1?1-t:void 0;return this._fallbackText=o.slice(e,s),this._fallbackText}}),i.addPoolingTo(r),e.exports=r},function(e,t,n){"use strict";var r=n(18),o=r.injection.MUST_USE_PROPERTY,i=r.injection.HAS_BOOLEAN_VALUE,a=r.injection.HAS_NUMERIC_VALUE,s=r.injection.HAS_POSITIVE_NUMERIC_VALUE,u=r.injection.HAS_OVERLOADED_BOOLEAN_VALUE,l={isCustomAttribute:RegExp.prototype.test.bind(new RegExp("^(data|aria)-["+r.ATTRIBUTE_NAME_CHAR+"]*$")),Properties:{accept:0,acceptCharset:0,accessKey:0,action:0,allowFullScreen:i,allowTransparency:0,alt:0,as:0,async:i,autoComplete:0,autoPlay:i,capture:i,cellPadding:0,cellSpacing:0,charSet:0,challenge:0,checked:o|i,cite:0,classID:0,className:0,cols:s,colSpan:0,content:0,contentEditable:0,contextMenu:0,controls:i,coords:0,crossOrigin:0,data:0,dateTime:0,default:i,defer:i,dir:0,disabled:i,download:u,draggable:0,encType:0,form:0,formAction:0,formEncType:0,formMethod:0,formNoValidate:i,formTarget:0,frameBorder:0,headers:0,height:0,hidden:i,high:0,href:0,hrefLang:0,htmlFor:0,httpEquiv:0,icon:0,id:0,inputMode:0,integrity:0,is:0,keyParams:0,keyType:0,kind:0,label:0,lang:0,list:0,loop:i,low:0,manifest:0,marginHeight:0,marginWidth:0,max:0,maxLength:0,media:0,mediaGroup:0,method:0,min:0,minLength:0,multiple:o|i,muted:o|i,name:0,nonce:0,noValidate:i,open:i,optimum:0,pattern:0,placeholder:0,playsInline:i,poster:0,preload:0,profile:0,radioGroup:0,readOnly:i,referrerPolicy:0,rel:0,required:i,reversed:i,role:0,rows:s,rowSpan:a,sandbox:0,scope:0,scoped:i,scrolling:0,seamless:i,selected:o|i,shape:0,size:s,sizes:0,span:s,spellCheck:0,src:0,srcDoc:0,srcLang:0,srcSet:0,start:a,step:0,style:0,summary:0,tabIndex:0,target:0,title:0,type:0,useMap:0,value:0,width:0,wmode:0,wrap:0,about:0,datatype:0,inlist:0,prefix:0,property:0,resource:0,typeof:0,vocab:0,autoCapitalize:0,autoCorrect:0,autoSave:0,color:0,itemProp:0,itemScope:i,itemType:0,itemID:0,itemRef:0,results:0,security:0,unselectable:0},DOMAttributeNames:{acceptCharset:"accept-charset",className:"class",htmlFor:"for",httpEquiv:"http-equiv"},DOMPropertyNames:{},DOMMutationMethods:{value:function(e,t){return null==t?e.removeAttribute("value"):void("number"!==e.type||e.hasAttribute("value")===!1?e.setAttribute("value",""+t):e.validity&&!e.validity.badInput&&e.ownerDocument.activeElement!==e&&e.setAttribute("value",""+t))}}};e.exports=l},function(e,t,n){(function(t){"use strict";function r(e,t,n,r){var o=void 0===e[n];null!=t&&o&&(e[n]=i(t,!0))}var o=n(19),i=n(80),a=(n(41),n(51)),s=n(83),u=(n(2),{instantiateChildren:function(e,t,n,o){if(null==e)return null;var i={};return s(e,r,i),i},updateChildren:function(e,t,n,r,s,u,l,c,p){if(t||e){var f,d;for(f in t)if(t.hasOwnProperty(f)){d=e&&e[f];var h=d&&d._currentElement,m=t[f];if(null!=d&&a(h,m))o.receiveComponent(d,m,s,c),t[f]=d;else{d&&(r[f]=o.getHostNode(d),o.unmountComponent(d,!1));var v=i(m,!0);t[f]=v;var g=o.mountComponent(v,s,u,l,c,p);n.push(g)}}for(f in e)!e.hasOwnProperty(f)||t&&t.hasOwnProperty(f)||(d=e[f],r[f]=o.getHostNode(d),o.unmountComponent(d,!1))}},unmountChildren:function(e,t){for(var n in e)if(e.hasOwnProperty(n)){var r=e[n];o.unmountComponent(r,t)}}});e.exports=u}).call(t,n(60))},function(e,t,n){"use strict";var r=n(37),o=n(143),i={processChildrenUpdates:o.dangerouslyProcessChildrenUpdates,replaceNodeWithMarkup:r.dangerouslyReplaceNodeWithMarkup};e.exports=i},function(e,t,n){"use strict";function r(e){}function o(e,t){}function i(e){return!(!e.prototype||!e.prototype.isReactComponent)}function a(e){return!(!e.prototype||!e.prototype.isPureReactComponent)}var s=n(3),u=n(4),l=n(20),c=n(43),p=n(12),f=n(44),d=n(26),h=(n(9),n(74)),m=n(19),v=n(23),g=(n(1),n(36)),y=n(51),b=(n(2),{ImpureClass:0,PureClass:1,StatelessFunctional:2});r.prototype.render=function(){var e=d.get(this)._currentElement.type,t=e(this.props,this.context,this.updater);return o(e,t),t};var C=1,_={construct:function(e){this._currentElement=e,this._rootNodeID=0,this._compositeType=null,this._instance=null,this._hostParent=null,this._hostContainerInfo=null,this._updateBatchNumber=null,this._pendingElement=null,this._pendingStateQueue=null,this._pendingReplaceState=!1,this._pendingForceUpdate=!1,this._renderedNodeType=null,this._renderedComponent=null,this._context=null,this._mountOrder=0,this._topLevelWrapper=null,this._pendingCallbacks=null,this._calledComponentWillUnmount=!1},mountComponent:function(e,t,n,u){this._context=u,this._mountOrder=C++,this._hostParent=t,this._hostContainerInfo=n;var c,p=this._currentElement.props,f=this._processContext(u),h=this._currentElement.type,m=e.getUpdateQueue(),g=i(h),y=this._constructComponent(g,p,f,m);g||null!=y&&null!=y.render?a(h)?this._compositeType=b.PureClass:this._compositeType=b.ImpureClass:(c=y,o(h,c),null===y||y===!1||l.isValidElement(y)?void 0:s("105",h.displayName||h.name||"Component"),y=new r(h),this._compositeType=b.StatelessFunctional);y.props=p,y.context=f,y.refs=v,y.updater=m,this._instance=y,d.set(y,this);var _=y.state;void 0===_&&(y.state=_=null),"object"!=typeof _||Array.isArray(_)?s("106",this.getName()||"ReactCompositeComponent"):void 0,this._pendingStateQueue=null,this._pendingReplaceState=!1,this._pendingForceUpdate=!1;var w;return w=y.unstable_handleError?this.performInitialMountWithErrorHandling(c,t,n,e,u):this.performInitialMount(c,t,n,e,u),y.componentDidMount&&e.getReactMountReady().enqueue(y.componentDidMount,y),w},_constructComponent:function(e,t,n,r){return this._constructComponentWithoutOwner(e,t,n,r)},_constructComponentWithoutOwner:function(e,t,n,r){var o=this._currentElement.type;return e?new o(t,n,r):o(t,n,r)},performInitialMountWithErrorHandling:function(e,t,n,r,o){var i,a=r.checkpoint();try{i=this.performInitialMount(e,t,n,r,o)}catch(s){r.rollback(a),this._instance.unstable_handleError(s),this._pendingStateQueue&&(this._instance.state=this._processPendingState(this._instance.props,this._instance.context)),a=r.checkpoint(),this._renderedComponent.unmountComponent(!0),r.rollback(a),i=this.performInitialMount(e,t,n,r,o)}return i},performInitialMount:function(e,t,n,r,o){var i=this._instance,a=0;i.componentWillMount&&(i.componentWillMount(),this._pendingStateQueue&&(i.state=this._processPendingState(i.props,i.context))),void 0===e&&(e=this._renderValidatedComponent());var s=h.getType(e);
-this._renderedNodeType=s;var u=this._instantiateReactComponent(e,s!==h.EMPTY);this._renderedComponent=u;var l=m.mountComponent(u,r,t,n,this._processChildContext(o),a);return l},getHostNode:function(){return m.getHostNode(this._renderedComponent)},unmountComponent:function(e){if(this._renderedComponent){var t=this._instance;if(t.componentWillUnmount&&!t._calledComponentWillUnmount)if(t._calledComponentWillUnmount=!0,e){var n=this.getName()+".componentWillUnmount()";f.invokeGuardedCallback(n,t.componentWillUnmount.bind(t))}else t.componentWillUnmount();this._renderedComponent&&(m.unmountComponent(this._renderedComponent,e),this._renderedNodeType=null,this._renderedComponent=null,this._instance=null),this._pendingStateQueue=null,this._pendingReplaceState=!1,this._pendingForceUpdate=!1,this._pendingCallbacks=null,this._pendingElement=null,this._context=null,this._rootNodeID=0,this._topLevelWrapper=null,d.remove(t)}},_maskContext:function(e){var t=this._currentElement.type,n=t.contextTypes;if(!n)return v;var r={};for(var o in n)r[o]=e[o];return r},_processContext:function(e){var t=this._maskContext(e);return t},_processChildContext:function(e){var t,n=this._currentElement.type,r=this._instance;if(r.getChildContext&&(t=r.getChildContext()),t){"object"!=typeof n.childContextTypes?s("107",this.getName()||"ReactCompositeComponent"):void 0;for(var o in t)o in n.childContextTypes?void 0:s("108",this.getName()||"ReactCompositeComponent",o);return u({},e,t)}return e},_checkContextTypes:function(e,t,n){},receiveComponent:function(e,t,n){var r=this._currentElement,o=this._context;this._pendingElement=null,this.updateComponent(t,r,e,o,n)},performUpdateIfNecessary:function(e){null!=this._pendingElement?m.receiveComponent(this,this._pendingElement,e,this._context):null!==this._pendingStateQueue||this._pendingForceUpdate?this.updateComponent(e,this._currentElement,this._currentElement,this._context,this._context):this._updateBatchNumber=null},updateComponent:function(e,t,n,r,o){var i=this._instance;null==i?s("136",this.getName()||"ReactCompositeComponent"):void 0;var a,u=!1;this._context===o?a=i.context:(a=this._processContext(o),u=!0);var l=t.props,c=n.props;t!==n&&(u=!0),u&&i.componentWillReceiveProps&&i.componentWillReceiveProps(c,a);var p=this._processPendingState(c,a),f=!0;this._pendingForceUpdate||(i.shouldComponentUpdate?f=i.shouldComponentUpdate(c,p,a):this._compositeType===b.PureClass&&(f=!g(l,c)||!g(i.state,p))),this._updateBatchNumber=null,f?(this._pendingForceUpdate=!1,this._performComponentUpdate(n,c,p,a,e,o)):(this._currentElement=n,this._context=o,i.props=c,i.state=p,i.context=a)},_processPendingState:function(e,t){var n=this._instance,r=this._pendingStateQueue,o=this._pendingReplaceState;if(this._pendingReplaceState=!1,this._pendingStateQueue=null,!r)return n.state;if(o&&1===r.length)return r[0];for(var i=u({},o?r[0]:n.state),a=o?1:0;a<r.length;a++){var s=r[a];u(i,"function"==typeof s?s.call(n,i,e,t):s)}return i},_performComponentUpdate:function(e,t,n,r,o,i){var a,s,u,l=this._instance,c=Boolean(l.componentDidUpdate);c&&(a=l.props,s=l.state,u=l.context),l.componentWillUpdate&&l.componentWillUpdate(t,n,r),this._currentElement=e,this._context=i,l.props=t,l.state=n,l.context=r,this._updateRenderedComponent(o,i),c&&o.getReactMountReady().enqueue(l.componentDidUpdate.bind(l,a,s,u),l)},_updateRenderedComponent:function(e,t){var n=this._renderedComponent,r=n._currentElement,o=this._renderValidatedComponent(),i=0;if(y(r,o))m.receiveComponent(n,o,e,this._processChildContext(t));else{var a=m.getHostNode(n);m.unmountComponent(n,!1);var s=h.getType(o);this._renderedNodeType=s;var u=this._instantiateReactComponent(o,s!==h.EMPTY);this._renderedComponent=u;var l=m.mountComponent(u,e,this._hostParent,this._hostContainerInfo,this._processChildContext(t),i);this._replaceNodeWithMarkup(a,l,n)}},_replaceNodeWithMarkup:function(e,t,n){c.replaceNodeWithMarkup(e,t,n)},_renderValidatedComponentWithoutOwnerOrContext:function(){var e,t=this._instance;return e=t.render()},_renderValidatedComponent:function(){var e;if(this._compositeType!==b.StatelessFunctional){p.current=this;try{e=this._renderValidatedComponentWithoutOwnerOrContext()}finally{p.current=null}}else e=this._renderValidatedComponentWithoutOwnerOrContext();return null===e||e===!1||l.isValidElement(e)?void 0:s("109",this.getName()||"ReactCompositeComponent"),e},attachRef:function(e,t){var n=this.getPublicInstance();null==n?s("110"):void 0;var r=t.getPublicInstance(),o=n.refs===v?n.refs={}:n.refs;o[e]=r},detachRef:function(e){var t=this.getPublicInstance().refs;delete t[e]},getName:function(){var e=this._currentElement.type,t=this._instance&&this._instance.constructor;return e.displayName||t&&t.displayName||e.name||t&&t.name||null},getPublicInstance:function(){var e=this._instance;return this._compositeType===b.StatelessFunctional?null:e},_instantiateReactComponent:null};e.exports=_},function(e,t,n){"use strict";var r=n(6),o=n(151),i=n(73),a=n(19),s=n(10),u=n(164),l=n(180),c=n(78),p=n(187);n(2);o.inject();var f={findDOMNode:l,render:i.render,unmountComponentAtNode:i.unmountComponentAtNode,version:u,unstable_batchedUpdates:s.batchedUpdates,unstable_renderSubtreeIntoContainer:p};"undefined"!=typeof __REACT_DEVTOOLS_GLOBAL_HOOK__&&"function"==typeof __REACT_DEVTOOLS_GLOBAL_HOOK__.inject&&__REACT_DEVTOOLS_GLOBAL_HOOK__.inject({ComponentTree:{getClosestInstanceFromNode:r.getClosestInstanceFromNode,getNodeFromInstance:function(e){return e._renderedComponent&&(e=c(e)),e?r.getNodeFromInstance(e):null}},Mount:i,Reconciler:a});e.exports=f},function(e,t,n){"use strict";function r(e){if(e){var t=e._currentElement._owner||null;if(t){var n=t.getName();if(n)return" This DOM node was rendered by `"+n+"`."}}return""}function o(e,t){t&&(X[e._tag]&&(null!=t.children||null!=t.dangerouslySetInnerHTML?m("137",e._tag,e._currentElement._owner?" Check the render method of "+e._currentElement._owner.getName()+".":""):void 0),null!=t.dangerouslySetInnerHTML&&(null!=t.children?m("60"):void 0,"object"==typeof t.dangerouslySetInnerHTML&&W in t.dangerouslySetInnerHTML?void 0:m("61")),null!=t.style&&"object"!=typeof t.style?m("62",r(e)):void 0)}function i(e,t,n,r){if(!(r instanceof I)){var o=e._hostContainerInfo,i=o._node&&o._node.nodeType===q,s=i?o._node:o._ownerDocument;F(t,s),r.getReactMountReady().enqueue(a,{inst:e,registrationName:t,listener:n})}}function a(){var e=this;E.putListener(e.inst,e.registrationName,e.listener)}function s(){var e=this;k.postMountWrapper(e)}function u(){var e=this;M.postMountWrapper(e)}function l(){var e=this;S.postMountWrapper(e)}function c(){var e=this;e._rootNodeID?void 0:m("63");var t=U(e);switch(t?void 0:m("64"),e._tag){case"iframe":case"object":e._wrapperState.listeners=[x.trapBubbledEvent("topLoad","load",t)];break;case"video":case"audio":e._wrapperState.listeners=[];for(var n in z)z.hasOwnProperty(n)&&e._wrapperState.listeners.push(x.trapBubbledEvent(n,z[n],t));break;case"source":e._wrapperState.listeners=[x.trapBubbledEvent("topError","error",t)];break;case"img":e._wrapperState.listeners=[x.trapBubbledEvent("topError","error",t),x.trapBubbledEvent("topLoad","load",t)];break;case"form":e._wrapperState.listeners=[x.trapBubbledEvent("topReset","reset",t),x.trapBubbledEvent("topSubmit","submit",t)];break;case"input":case"select":case"textarea":e._wrapperState.listeners=[x.trapBubbledEvent("topInvalid","invalid",t)]}}function p(){N.postUpdateWrapper(this)}function f(e){$.call(Q,e)||(G.test(e)?void 0:m("65",e),Q[e]=!0)}function d(e,t){return e.indexOf("-")>=0||null!=t.is}function h(e){var t=e.type;f(t),this._currentElement=e,this._tag=t.toLowerCase(),this._namespaceURI=null,this._renderedChildren=null,this._previousStyle=null,this._previousStyleCopy=null,this._hostNode=null,this._hostParent=null,this._rootNodeID=0,this._domID=0,this._hostContainerInfo=null,this._wrapperState=null,this._topLevelWrapper=null,this._flags=0}var m=n(3),v=n(4),g=n(126),y=n(128),b=n(17),C=n(38),_=n(18),w=n(66),E=n(24),T=n(39),x=n(29),O=n(67),P=n(6),k=n(144),S=n(145),N=n(68),M=n(148),A=(n(9),n(157)),I=n(162),D=(n(8),n(32)),R=(n(1),n(50),n(36),n(52),n(2),O),L=E.deleteListener,U=P.getNodeFromInstance,F=x.listenTo,j=T.registrationNameModules,B={string:!0,number:!0},V="style",W="__html",H={children:null,dangerouslySetInnerHTML:null,suppressContentEditableWarning:null},q=11,z={topAbort:"abort",topCanPlay:"canplay",topCanPlayThrough:"canplaythrough",topDurationChange:"durationchange",topEmptied:"emptied",topEncrypted:"encrypted",topEnded:"ended",topError:"error",topLoadedData:"loadeddata",topLoadedMetadata:"loadedmetadata",topLoadStart:"loadstart",topPause:"pause",topPlay:"play",topPlaying:"playing",topProgress:"progress",topRateChange:"ratechange",topSeeked:"seeked",topSeeking:"seeking",topStalled:"stalled",topSuspend:"suspend",topTimeUpdate:"timeupdate",topVolumeChange:"volumechange",topWaiting:"waiting"},K={area:!0,base:!0,br:!0,col:!0,embed:!0,hr:!0,img:!0,input:!0,keygen:!0,link:!0,meta:!0,param:!0,source:!0,track:!0,wbr:!0},Y={listing:!0,pre:!0,textarea:!0},X=v({menuitem:!0},K),G=/^[a-zA-Z][a-zA-Z:_\.\-\d]*$/,Q={},$={}.hasOwnProperty,Z=1;h.displayName="ReactDOMComponent",h.Mixin={mountComponent:function(e,t,n,r){this._rootNodeID=Z++,this._domID=n._idCounter++,this._hostParent=t,this._hostContainerInfo=n;var i=this._currentElement.props;switch(this._tag){case"audio":case"form":case"iframe":case"img":case"link":case"object":case"source":case"video":this._wrapperState={listeners:null},e.getReactMountReady().enqueue(c,this);break;case"input":k.mountWrapper(this,i,t),i=k.getHostProps(this,i),e.getReactMountReady().enqueue(c,this);break;case"option":S.mountWrapper(this,i,t),i=S.getHostProps(this,i);break;case"select":N.mountWrapper(this,i,t),i=N.getHostProps(this,i),e.getReactMountReady().enqueue(c,this);break;case"textarea":M.mountWrapper(this,i,t),i=M.getHostProps(this,i),e.getReactMountReady().enqueue(c,this)}o(this,i);var a,p;null!=t?(a=t._namespaceURI,p=t._tag):n._tag&&(a=n._namespaceURI,p=n._tag),(null==a||a===C.svg&&"foreignobject"===p)&&(a=C.html),a===C.html&&("svg"===this._tag?a=C.svg:"math"===this._tag&&(a=C.mathml)),this._namespaceURI=a;var f;if(e.useCreateElement){var d,h=n._ownerDocument;if(a===C.html)if("script"===this._tag){var m=h.createElement("div"),v=this._currentElement.type;m.innerHTML="<"+v+"></"+v+">",d=m.removeChild(m.firstChild)}else d=i.is?h.createElement(this._currentElement.type,i.is):h.createElement(this._currentElement.type);else d=h.createElementNS(a,this._currentElement.type);P.precacheNode(this,d),this._flags|=R.hasCachedChildNodes,this._hostParent||w.setAttributeForRoot(d),this._updateDOMProperties(null,i,e);var y=b(d);this._createInitialChildren(e,i,r,y),f=y}else{var _=this._createOpenTagMarkupAndPutListeners(e,i),E=this._createContentMarkup(e,i,r);f=!E&&K[this._tag]?_+"/>":_+">"+E+"</"+this._currentElement.type+">"}switch(this._tag){case"input":e.getReactMountReady().enqueue(s,this),i.autoFocus&&e.getReactMountReady().enqueue(g.focusDOMComponent,this);break;case"textarea":e.getReactMountReady().enqueue(u,this),i.autoFocus&&e.getReactMountReady().enqueue(g.focusDOMComponent,this);break;case"select":i.autoFocus&&e.getReactMountReady().enqueue(g.focusDOMComponent,this);break;case"button":i.autoFocus&&e.getReactMountReady().enqueue(g.focusDOMComponent,this);break;case"option":e.getReactMountReady().enqueue(l,this)}return f},_createOpenTagMarkupAndPutListeners:function(e,t){var n="<"+this._currentElement.type;for(var r in t)if(t.hasOwnProperty(r)){var o=t[r];if(null!=o)if(j.hasOwnProperty(r))o&&i(this,r,o,e);else{r===V&&(o&&(o=this._previousStyleCopy=v({},t.style)),o=y.createMarkupForStyles(o,this));var a=null;null!=this._tag&&d(this._tag,t)?H.hasOwnProperty(r)||(a=w.createMarkupForCustomAttribute(r,o)):a=w.createMarkupForProperty(r,o),a&&(n+=" "+a)}}return e.renderToStaticMarkup?n:(this._hostParent||(n+=" "+w.createMarkupForRoot()),n+=" "+w.createMarkupForID(this._domID))},_createContentMarkup:function(e,t,n){var r="",o=t.dangerouslySetInnerHTML;if(null!=o)null!=o.__html&&(r=o.__html);else{var i=B[typeof t.children]?t.children:null,a=null!=i?null:t.children;if(null!=i)r=D(i);else if(null!=a){var s=this.mountChildren(a,e,n);r=s.join("")}}return Y[this._tag]&&"\n"===r.charAt(0)?"\n"+r:r},_createInitialChildren:function(e,t,n,r){var o=t.dangerouslySetInnerHTML;if(null!=o)null!=o.__html&&b.queueHTML(r,o.__html);else{var i=B[typeof t.children]?t.children:null,a=null!=i?null:t.children;if(null!=i)""!==i&&b.queueText(r,i);else if(null!=a)for(var s=this.mountChildren(a,e,n),u=0;u<s.length;u++)b.queueChild(r,s[u])}},receiveComponent:function(e,t,n){var r=this._currentElement;this._currentElement=e,this.updateComponent(t,r,e,n)},updateComponent:function(e,t,n,r){var i=t.props,a=this._currentElement.props;switch(this._tag){case"input":i=k.getHostProps(this,i),a=k.getHostProps(this,a);break;case"option":i=S.getHostProps(this,i),a=S.getHostProps(this,a);break;case"select":i=N.getHostProps(this,i),a=N.getHostProps(this,a);break;case"textarea":i=M.getHostProps(this,i),a=M.getHostProps(this,a)}switch(o(this,a),this._updateDOMProperties(i,a,e),this._updateDOMChildren(i,a,e,r),this._tag){case"input":k.updateWrapper(this);break;case"textarea":M.updateWrapper(this);break;case"select":e.getReactMountReady().enqueue(p,this)}},_updateDOMProperties:function(e,t,n){var r,o,a;for(r in e)if(!t.hasOwnProperty(r)&&e.hasOwnProperty(r)&&null!=e[r])if(r===V){var s=this._previousStyleCopy;for(o in s)s.hasOwnProperty(o)&&(a=a||{},a[o]="");this._previousStyleCopy=null}else j.hasOwnProperty(r)?e[r]&&L(this,r):d(this._tag,e)?H.hasOwnProperty(r)||w.deleteValueForAttribute(U(this),r):(_.properties[r]||_.isCustomAttribute(r))&&w.deleteValueForProperty(U(this),r);for(r in t){var u=t[r],l=r===V?this._previousStyleCopy:null!=e?e[r]:void 0;if(t.hasOwnProperty(r)&&u!==l&&(null!=u||null!=l))if(r===V)if(u?u=this._previousStyleCopy=v({},u):this._previousStyleCopy=null,l){for(o in l)!l.hasOwnProperty(o)||u&&u.hasOwnProperty(o)||(a=a||{},a[o]="");for(o in u)u.hasOwnProperty(o)&&l[o]!==u[o]&&(a=a||{},a[o]=u[o])}else a=u;else if(j.hasOwnProperty(r))u?i(this,r,u,n):l&&L(this,r);else if(d(this._tag,t))H.hasOwnProperty(r)||w.setValueForAttribute(U(this),r,u);else if(_.properties[r]||_.isCustomAttribute(r)){var c=U(this);null!=u?w.setValueForProperty(c,r,u):w.deleteValueForProperty(c,r)}}a&&y.setValueForStyles(U(this),a,this)},_updateDOMChildren:function(e,t,n,r){var o=B[typeof e.children]?e.children:null,i=B[typeof t.children]?t.children:null,a=e.dangerouslySetInnerHTML&&e.dangerouslySetInnerHTML.__html,s=t.dangerouslySetInnerHTML&&t.dangerouslySetInnerHTML.__html,u=null!=o?null:e.children,l=null!=i?null:t.children,c=null!=o||null!=a,p=null!=i||null!=s;null!=u&&null==l?this.updateChildren(null,n,r):c&&!p&&this.updateTextContent(""),null!=i?o!==i&&this.updateTextContent(""+i):null!=s?a!==s&&this.updateMarkup(""+s):null!=l&&this.updateChildren(l,n,r)},getHostNode:function(){return U(this)},unmountComponent:function(e){switch(this._tag){case"audio":case"form":case"iframe":case"img":case"link":case"object":case"source":case"video":var t=this._wrapperState.listeners;if(t)for(var n=0;n<t.length;n++)t[n].remove();break;case"html":case"head":case"body":m("66",this._tag)}this.unmountChildren(e),P.uncacheNode(this),E.deleteAllListeners(this),this._rootNodeID=0,this._domID=0,this._wrapperState=null},getPublicInstance:function(){return U(this)}},v(h.prototype,h.Mixin,A.Mixin),e.exports=h},function(e,t,n){"use strict";function r(e,t){var n={_topLevelWrapper:e,_idCounter:1,_ownerDocument:t?t.nodeType===o?t:t.ownerDocument:null,_node:t,_tag:t?t.nodeName.toLowerCase():null,_namespaceURI:t?t.namespaceURI:null};return n}var o=(n(52),9);e.exports=r},function(e,t,n){"use strict";var r=n(4),o=n(17),i=n(6),a=function(e){this._currentElement=null,this._hostNode=null,this._hostParent=null,this._hostContainerInfo=null,this._domID=0};r(a.prototype,{mountComponent:function(e,t,n,r){var a=n._idCounter++;this._domID=a,this._hostParent=t,this._hostContainerInfo=n;var s=" react-empty: "+this._domID+" ";if(e.useCreateElement){var u=n._ownerDocument,l=u.createComment(s);return i.precacheNode(this,l),o(l)}return e.renderToStaticMarkup?"":"<!--"+s+"-->"},receiveComponent:function(){},getHostNode:function(){return i.getNodeFromInstance(this)},unmountComponent:function(){i.uncacheNode(this)}}),e.exports=a},function(e,t){"use strict";var n={useCreateElement:!0,useFiber:!1};e.exports=n},function(e,t,n){"use strict";var r=n(37),o=n(6),i={dangerouslyProcessChildrenUpdates:function(e,t){var n=o.getNodeFromInstance(e);r.processUpdates(n,t)}};e.exports=i},function(e,t,n){"use strict";function r(){this._rootNodeID&&f.updateWrapper(this)}function o(e){var t="checkbox"===e.type||"radio"===e.type;return t?null!=e.checked:null!=e.value}function i(e){var t=this._currentElement.props,n=l.executeOnChange(t,e);p.asap(r,this);var o=t.name;if("radio"===t.type&&null!=o){for(var i=c.getNodeFromInstance(this),s=i;s.parentNode;)s=s.parentNode;for(var u=s.querySelectorAll("input[name="+JSON.stringify(""+o)+'][type="radio"]'),f=0;f<u.length;f++){var d=u[f];if(d!==i&&d.form===i.form){var h=c.getInstanceFromNode(d);h?void 0:a("90"),p.asap(r,h)}}}return n}var a=n(3),s=n(4),u=n(66),l=n(42),c=n(6),p=n(10),f=(n(1),n(2),{getHostProps:function(e,t){var n=l.getValue(t),r=l.getChecked(t),o=s({type:void 0,step:void 0,min:void 0,max:void 0},t,{defaultChecked:void 0,defaultValue:void 0,value:null!=n?n:e._wrapperState.initialValue,checked:null!=r?r:e._wrapperState.initialChecked,onChange:e._wrapperState.onChange});return o},mountWrapper:function(e,t){var n=t.defaultValue;e._wrapperState={initialChecked:null!=t.checked?t.checked:t.defaultChecked,initialValue:null!=t.value?t.value:n,listeners:null,onChange:i.bind(e),controlled:o(t)}},updateWrapper:function(e){var t=e._currentElement.props,n=t.checked;null!=n&&u.setValueForProperty(c.getNodeFromInstance(e),"checked",n||!1);var r=c.getNodeFromInstance(e),o=l.getValue(t);if(null!=o)if(0===o&&""===r.value)r.value="0";else if("number"===t.type){var i=parseFloat(r.value,10)||0;o!=i&&(r.value=""+o)}else o!=r.value&&(r.value=""+o);else null==t.value&&null!=t.defaultValue&&r.defaultValue!==""+t.defaultValue&&(r.defaultValue=""+t.defaultValue),null==t.checked&&null!=t.defaultChecked&&(r.defaultChecked=!!t.defaultChecked)},postMountWrapper:function(e){var t=e._currentElement.props,n=c.getNodeFromInstance(e);switch(t.type){case"submit":case"reset":break;case"color":case"date":case"datetime":case"datetime-local":case"month":case"time":case"week":n.value="",n.value=n.defaultValue;break;default:n.value=n.value}var r=n.name;""!==r&&(n.name=""),n.defaultChecked=!n.defaultChecked,n.defaultChecked=!n.defaultChecked,""!==r&&(n.name=r)}});e.exports=f},function(e,t,n){"use strict";function r(e){var t="";return i.Children.forEach(e,function(e){null!=e&&("string"==typeof e||"number"==typeof e?t+=e:u||(u=!0))}),t}var o=n(4),i=n(20),a=n(6),s=n(68),u=(n(2),!1),l={mountWrapper:function(e,t,n){var o=null;if(null!=n){var i=n;"optgroup"===i._tag&&(i=i._hostParent),null!=i&&"select"===i._tag&&(o=s.getSelectValueContext(i))}var a=null;if(null!=o){var u;if(u=null!=t.value?t.value+"":r(t.children),a=!1,Array.isArray(o)){for(var l=0;l<o.length;l++)if(""+o[l]===u){a=!0;break}}else a=""+o===u}e._wrapperState={selected:a}},postMountWrapper:function(e){var t=e._currentElement.props;if(null!=t.value){var n=a.getNodeFromInstance(e);n.setAttribute("value",t.value)}},getHostProps:function(e,t){var n=o({selected:void 0,children:void 0},t);null!=e._wrapperState.selected&&(n.selected=e._wrapperState.selected);var i=r(t.children);return i&&(n.children=i),n}};e.exports=l},function(e,t,n){"use strict";function r(e,t,n,r){return e===n&&t===r}function o(e){var t=document.selection,n=t.createRange(),r=n.text.length,o=n.duplicate();o.moveToElementText(e),o.setEndPoint("EndToStart",n);var i=o.text.length,a=i+r;return{start:i,end:a}}function i(e){var t=window.getSelection&&window.getSelection();if(!t||0===t.rangeCount)return null;var n=t.anchorNode,o=t.anchorOffset,i=t.focusNode,a=t.focusOffset,s=t.getRangeAt(0);try{s.startContainer.nodeType,s.endContainer.nodeType}catch(e){return null}var u=r(t.anchorNode,t.anchorOffset,t.focusNode,t.focusOffset),l=u?0:s.toString().length,c=s.cloneRange();c.selectNodeContents(e),c.setEnd(s.startContainer,s.startOffset);var p=r(c.startContainer,c.startOffset,c.endContainer,c.endOffset),f=p?0:c.toString().length,d=f+l,h=document.createRange();h.setStart(n,o),h.setEnd(i,a);var m=h.collapsed;return{start:m?d:f,end:m?f:d}}function a(e,t){var n,r,o=document.selection.createRange().duplicate();void 0===t.end?(n=t.start,r=n):t.start>t.end?(n=t.end,r=t.start):(n=t.start,r=t.end),o.moveToElementText(e),o.moveStart("character",n),o.setEndPoint("EndToStart",o),o.moveEnd("character",r-n),o.select()}function s(e,t){if(window.getSelection){var n=window.getSelection(),r=e[c()].length,o=Math.min(t.start,r),i=void 0===t.end?o:Math.min(t.end,r);if(!n.extend&&o>i){var a=i;i=o,o=a}var s=l(e,o),u=l(e,i);if(s&&u){var p=document.createRange();p.setStart(s.node,s.offset),n.removeAllRanges(),o>i?(n.addRange(p),n.extend(u.node,u.offset)):(p.setEnd(u.node,u.offset),n.addRange(p))}}}var u=n(7),l=n(184),c=n(79),p=u.canUseDOM&&"selection"in document&&!("getSelection"in window),f={getOffsets:p?o:i,setOffsets:p?a:s};e.exports=f},function(e,t,n){"use strict";var r=n(3),o=n(4),i=n(37),a=n(17),s=n(6),u=n(32),l=(n(1),n(52),function(e){this._currentElement=e,this._stringText=""+e,this._hostNode=null,this._hostParent=null,this._domID=0,this._mountIndex=0,this._closingComment=null,this._commentNodes=null});o(l.prototype,{mountComponent:function(e,t,n,r){var o=n._idCounter++,i=" react-text: "+o+" ",l=" /react-text ";if(this._domID=o,this._hostParent=t,e.useCreateElement){var c=n._ownerDocument,p=c.createComment(i),f=c.createComment(l),d=a(c.createDocumentFragment());return a.queueChild(d,a(p)),this._stringText&&a.queueChild(d,a(c.createTextNode(this._stringText))),a.queueChild(d,a(f)),s.precacheNode(this,p),this._closingComment=f,d}var h=u(this._stringText);return e.renderToStaticMarkup?h:"<!--"+i+"-->"+h+"<!--"+l+"-->"},receiveComponent:function(e,t){if(e!==this._currentElement){this._currentElement=e;var n=""+e;if(n!==this._stringText){this._stringText=n;var r=this.getHostNode();i.replaceDelimitedText(r[0],r[1],n)}}},getHostNode:function(){var e=this._commentNodes;if(e)return e;if(!this._closingComment)for(var t=s.getNodeFromInstance(this),n=t.nextSibling;;){if(null==n?r("67",this._domID):void 0,8===n.nodeType&&" /react-text "===n.nodeValue){this._closingComment=n;break}n=n.nextSibling}return e=[this._hostNode,this._closingComment],this._commentNodes=e,e},unmountComponent:function(){this._closingComment=null,this._commentNodes=null,s.uncacheNode(this)}}),e.exports=l},function(e,t,n){"use strict";function r(){this._rootNodeID&&c.updateWrapper(this)}function o(e){var t=this._currentElement.props,n=s.executeOnChange(t,e);return l.asap(r,this),n}var i=n(3),a=n(4),s=n(42),u=n(6),l=n(10),c=(n(1),n(2),{getHostProps:function(e,t){null!=t.dangerouslySetInnerHTML?i("91"):void 0;var n=a({},t,{value:void 0,defaultValue:void 0,children:""+e._wrapperState.initialValue,onChange:e._wrapperState.onChange});return n},mountWrapper:function(e,t){var n=s.getValue(t),r=n;if(null==n){var a=t.defaultValue,u=t.children;null!=u&&(null!=a?i("92"):void 0,Array.isArray(u)&&(u.length<=1?void 0:i("93"),u=u[0]),a=""+u),null==a&&(a=""),r=a}e._wrapperState={initialValue:""+r,listeners:null,onChange:o.bind(e)}},updateWrapper:function(e){var t=e._currentElement.props,n=u.getNodeFromInstance(e),r=s.getValue(t);if(null!=r){var o=""+r;o!==n.value&&(n.value=o),null==t.defaultValue&&(n.defaultValue=o)}null!=t.defaultValue&&(n.defaultValue=t.defaultValue)},postMountWrapper:function(e){var t=u.getNodeFromInstance(e),n=t.textContent;n===e._wrapperState.initialValue&&(t.value=n)}});e.exports=c},function(e,t,n){"use strict";function r(e,t){"_hostNode"in e?void 0:u("33"),"_hostNode"in t?void 0:u("33");for(var n=0,r=e;r;r=r._hostParent)n++;for(var o=0,i=t;i;i=i._hostParent)o++;for(;n-o>0;)e=e._hostParent,n--;for(;o-n>0;)t=t._hostParent,o--;for(var a=n;a--;){if(e===t)return e;e=e._hostParent,t=t._hostParent}return null}function o(e,t){"_hostNode"in e?void 0:u("35"),"_hostNode"in t?void 0:u("35");for(;t;){if(t===e)return!0;t=t._hostParent}return!1}function i(e){return"_hostNode"in e?void 0:u("36"),e._hostParent}function a(e,t,n){for(var r=[];e;)r.push(e),e=e._hostParent;var o;for(o=r.length;o-- >0;)t(r[o],"captured",n);for(o=0;o<r.length;o++)t(r[o],"bubbled",n)}function s(e,t,n,o,i){for(var a=e&&t?r(e,t):null,s=[];e&&e!==a;)s.push(e),e=e._hostParent;for(var u=[];t&&t!==a;)u.push(t),t=t._hostParent;var l;for(l=0;l<s.length;l++)n(s[l],"bubbled",o);for(l=u.length;l-- >0;)n(u[l],"captured",i)}var u=n(3);n(1);e.exports={isAncestor:o,getLowestCommonAncestor:r,getParentInstance:i,traverseTwoPhase:a,traverseEnterLeave:s}},function(e,t,n){"use strict";function r(){this.reinitializeTransaction()}var o=n(4),i=n(10),a=n(31),s=n(8),u={initialize:s,close:function(){f.isBatchingUpdates=!1}},l={initialize:s,close:i.flushBatchedUpdates.bind(i)},c=[l,u];o(r.prototype,a,{getTransactionWrappers:function(){return c}});var p=new r,f={isBatchingUpdates:!1,batchedUpdates:function(e,t,n,r,o,i){var a=f.isBatchingUpdates;return f.isBatchingUpdates=!0,a?e(t,n,r,o,i):p.perform(e,null,t,n,r,o,i)}};e.exports=f},function(e,t,n){"use strict";function r(){E||(E=!0,y.EventEmitter.injectReactEventListener(g),y.EventPluginHub.injectEventPluginOrder(s),y.EventPluginUtils.injectComponentTree(f),y.EventPluginUtils.injectTreeTraversal(h),y.EventPluginHub.injectEventPluginsByName({SimpleEventPlugin:w,EnterLeaveEventPlugin:u,ChangeEventPlugin:a,SelectEventPlugin:_,BeforeInputEventPlugin:i}),y.HostComponent.injectGenericComponentClass(p),y.HostComponent.injectTextComponentClass(m),y.DOMProperty.injectDOMPropertyConfig(o),y.DOMProperty.injectDOMPropertyConfig(l),y.DOMProperty.injectDOMPropertyConfig(C),y.EmptyComponent.injectEmptyComponentFactory(function(e){return new d(e)}),y.Updates.injectReconcileTransaction(b),y.Updates.injectBatchingStrategy(v),y.Component.injectEnvironment(c))}var o=n(125),i=n(127),a=n(129),s=n(131),u=n(132),l=n(134),c=n(136),p=n(139),f=n(6),d=n(141),h=n(149),m=n(147),v=n(150),g=n(154),y=n(155),b=n(160),C=n(165),_=n(166),w=n(167),E=!1;e.exports={inject:r}},88,function(e,t,n){"use strict";function r(e){o.enqueueEvents(e),o.processEventQueue(!1)}var o=n(24),i={handleTopLevel:function(e,t,n,i){var a=o.extractEvents(e,t,n,i);r(a)}};e.exports=i},function(e,t,n){"use strict";function r(e){for(;e._hostParent;)e=e._hostParent;var t=p.getNodeFromInstance(e),n=t.parentNode;return p.getClosestInstanceFromNode(n)}function o(e,t){this.topLevelType=e,this.nativeEvent=t,this.ancestors=[]}function i(e){var t=d(e.nativeEvent),n=p.getClosestInstanceFromNode(t),o=n;do e.ancestors.push(o),o=o&&r(o);while(o);for(var i=0;i<e.ancestors.length;i++)n=e.ancestors[i],m._handleTopLevel(e.topLevelType,n,e.nativeEvent,d(e.nativeEvent))}function a(e){var t=h(window);e(t)}var s=n(4),u=n(57),l=n(7),c=n(14),p=n(6),f=n(10),d=n(49),h=n(107);s(o.prototype,{destructor:function(){this.topLevelType=null,this.nativeEvent=null,this.ancestors.length=0}}),c.addPoolingTo(o,c.twoArgumentPooler);var m={_enabled:!0,_handleTopLevel:null,WINDOW_HANDLE:l.canUseDOM?window:null,setHandleTopLevel:function(e){m._handleTopLevel=e},setEnabled:function(e){m._enabled=!!e},isEnabled:function(){return m._enabled},trapBubbledEvent:function(e,t,n){return n?u.listen(n,t,m.dispatchEvent.bind(null,e)):null},trapCapturedEvent:function(e,t,n){return n?u.capture(n,t,m.dispatchEvent.bind(null,e)):null},monitorScrollValue:function(e){var t=a.bind(null,e);u.listen(window,"scroll",t)},dispatchEvent:function(e,t){if(m._enabled){var n=o.getPooled(e,t);try{f.batchedUpdates(i,n)}finally{o.release(n)}}}};e.exports=m},function(e,t,n){"use strict";var r=n(18),o=n(24),i=n(40),a=n(43),s=n(69),u=n(29),l=n(71),c=n(10),p={Component:a.injection,DOMProperty:r.injection,EmptyComponent:s.injection,EventPluginHub:o.injection,EventPluginUtils:i.injection,EventEmitter:u.injection,HostComponent:l.injection,Updates:c.injection};e.exports=p},function(e,t,n){"use strict";var r=n(178),o=/\/?>/,i=/^<\!\-\-/,a={CHECKSUM_ATTR_NAME:"data-react-checksum",addChecksumToMarkup:function(e){var t=r(e);return i.test(e)?e:e.replace(o," "+a.CHECKSUM_ATTR_NAME+'="'+t+'"$&')},canReuseMarkup:function(e,t){var n=t.getAttribute(a.CHECKSUM_ATTR_NAME);n=n&&parseInt(n,10);var o=r(e);return o===n}};e.exports=a},function(e,t,n){"use strict";function r(e,t,n){return{type:"INSERT_MARKUP",content:e,fromIndex:null,fromNode:null,toIndex:n,afterNode:t}}function o(e,t,n){return{type:"MOVE_EXISTING",content:null,fromIndex:e._mountIndex,fromNode:f.getHostNode(e),toIndex:n,afterNode:t}}function i(e,t){return{type:"REMOVE_NODE",content:null,fromIndex:e._mountIndex,fromNode:t,toIndex:null,afterNode:null}}function a(e){return{type:"SET_MARKUP",content:e,fromIndex:null,fromNode:null,toIndex:null,afterNode:null}}function s(e){return{type:"TEXT_CONTENT",content:e,fromIndex:null,fromNode:null,toIndex:null,afterNode:null}}function u(e,t){return t&&(e=e||[],e.push(t)),e}function l(e,t){p.processChildrenUpdates(e,t)}var c=n(3),p=n(43),f=(n(26),n(9),n(12),n(19)),d=n(135),h=(n(8),n(181)),m=(n(1),{Mixin:{_reconcilerInstantiateChildren:function(e,t,n){return d.instantiateChildren(e,t,n)},_reconcilerUpdateChildren:function(e,t,n,r,o,i){var a,s=0;return a=h(t,s),d.updateChildren(e,a,n,r,o,this,this._hostContainerInfo,i,s),a},mountChildren:function(e,t,n){var r=this._reconcilerInstantiateChildren(e,t,n);this._renderedChildren=r;var o=[],i=0;for(var a in r)if(r.hasOwnProperty(a)){var s=r[a],u=0,l=f.mountComponent(s,t,this,this._hostContainerInfo,n,u);s._mountIndex=i++,o.push(l)}return o},updateTextContent:function(e){var t=this._renderedChildren;d.unmountChildren(t,!1);for(var n in t)t.hasOwnProperty(n)&&c("118");var r=[s(e)];l(this,r)},updateMarkup:function(e){var t=this._renderedChildren;d.unmountChildren(t,!1);for(var n in t)t.hasOwnProperty(n)&&c("118");var r=[a(e)];l(this,r)},updateChildren:function(e,t,n){this._updateChildren(e,t,n)},_updateChildren:function(e,t,n){var r=this._renderedChildren,o={},i=[],a=this._reconcilerUpdateChildren(r,e,i,o,t,n);if(a||r){var s,c=null,p=0,d=0,h=0,m=null;for(s in a)if(a.hasOwnProperty(s)){var v=r&&r[s],g=a[s];v===g?(c=u(c,this.moveChild(v,m,p,d)),d=Math.max(v._mountIndex,d),v._mountIndex=p):(v&&(d=Math.max(v._mountIndex,d)),c=u(c,this._mountChildAtIndex(g,i[h],m,p,t,n)),h++),p++,m=f.getHostNode(g)}for(s in o)o.hasOwnProperty(s)&&(c=u(c,this._unmountChild(r[s],o[s])));c&&l(this,c),this._renderedChildren=a}},unmountChildren:function(e){var t=this._renderedChildren;d.unmountChildren(t,e),this._renderedChildren=null},moveChild:function(e,t,n,r){if(e._mountIndex<r)return o(e,t,n)},createChild:function(e,t,n){return r(n,t,e._mountIndex)},removeChild:function(e,t){return i(e,t)},_mountChildAtIndex:function(e,t,n,r,o,i){return e._mountIndex=r,this.createChild(e,n,t)},_unmountChild:function(e,t){var n=this.removeChild(e,t);return e._mountIndex=null,n}}});e.exports=m},function(e,t,n){"use strict";function r(e){return!(!e||"function"!=typeof e.attachRef||"function"!=typeof e.detachRef)}var o=n(3),i=(n(1),{addComponentAsRefTo:function(e,t,n){r(n)?void 0:o("119"),n.attachRef(t,e)},removeComponentAsRefFrom:function(e,t,n){r(n)?void 0:o("120");var i=n.getPublicInstance();i&&i.refs[t]===e.getPublicInstance()&&n.detachRef(t)}});e.exports=i},function(e,t){"use strict";var n="SECRET_DO_NOT_PASS_THIS_OR_YOU_WILL_BE_FIRED";e.exports=n},function(e,t,n){"use strict";function r(e){this.reinitializeTransaction(),this.renderToStaticMarkup=!1,this.reactMountReady=i.getPooled(null),this.useCreateElement=e}var o=n(4),i=n(65),a=n(14),s=n(29),u=n(72),l=(n(9),n(31)),c=n(45),p={initialize:u.getSelectionInformation,close:u.restoreSelection},f={initialize:function(){var e=s.isEnabled();return s.setEnabled(!1),
-e},close:function(e){s.setEnabled(e)}},d={initialize:function(){this.reactMountReady.reset()},close:function(){this.reactMountReady.notifyAll()}},h=[p,f,d],m={getTransactionWrappers:function(){return h},getReactMountReady:function(){return this.reactMountReady},getUpdateQueue:function(){return c},checkpoint:function(){return this.reactMountReady.checkpoint()},rollback:function(e){this.reactMountReady.rollback(e)},destructor:function(){i.release(this.reactMountReady),this.reactMountReady=null}};o(r.prototype,l,m),a.addPoolingTo(r),e.exports=r},function(e,t,n){"use strict";function r(e,t,n){"function"==typeof e?e(t.getPublicInstance()):i.addComponentAsRefTo(t,e,n)}function o(e,t,n){"function"==typeof e?e(null):i.removeComponentAsRefFrom(t,e,n)}var i=n(158),a={};a.attachRefs=function(e,t){if(null!==t&&"object"==typeof t){var n=t.ref;null!=n&&r(n,e,t._owner)}},a.shouldUpdateRefs=function(e,t){var n=null,r=null;null!==e&&"object"==typeof e&&(n=e.ref,r=e._owner);var o=null,i=null;return null!==t&&"object"==typeof t&&(o=t.ref,i=t._owner),n!==o||"string"==typeof o&&i!==r},a.detachRefs=function(e,t){if(null!==t&&"object"==typeof t){var n=t.ref;null!=n&&o(n,e,t._owner)}},e.exports=a},function(e,t,n){"use strict";function r(e){this.reinitializeTransaction(),this.renderToStaticMarkup=e,this.useCreateElement=!1,this.updateQueue=new s(this)}var o=n(4),i=n(14),a=n(31),s=(n(9),n(163)),u=[],l={enqueue:function(){}},c={getTransactionWrappers:function(){return u},getReactMountReady:function(){return l},getUpdateQueue:function(){return this.updateQueue},destructor:function(){},checkpoint:function(){},rollback:function(){}};o(r.prototype,a,c),i.addPoolingTo(r),e.exports=r},function(e,t,n){"use strict";function r(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function o(e,t){}var i=n(45),a=(n(2),function(){function e(t){r(this,e),this.transaction=t}return e.prototype.isMounted=function(e){return!1},e.prototype.enqueueCallback=function(e,t,n){this.transaction.isInTransaction()&&i.enqueueCallback(e,t,n)},e.prototype.enqueueForceUpdate=function(e){this.transaction.isInTransaction()?i.enqueueForceUpdate(e):o(e,"forceUpdate")},e.prototype.enqueueReplaceState=function(e,t){this.transaction.isInTransaction()?i.enqueueReplaceState(e,t):o(e,"replaceState")},e.prototype.enqueueSetState=function(e,t){this.transaction.isInTransaction()?i.enqueueSetState(e,t):o(e,"setState")},e}());e.exports=a},function(e,t){"use strict";e.exports="15.5.4"},function(e,t){"use strict";var n={xlink:"http://www.w3.org/1999/xlink",xml:"http://www.w3.org/XML/1998/namespace"},r={accentHeight:"accent-height",accumulate:0,additive:0,alignmentBaseline:"alignment-baseline",allowReorder:"allowReorder",alphabetic:0,amplitude:0,arabicForm:"arabic-form",ascent:0,attributeName:"attributeName",attributeType:"attributeType",autoReverse:"autoReverse",azimuth:0,baseFrequency:"baseFrequency",baseProfile:"baseProfile",baselineShift:"baseline-shift",bbox:0,begin:0,bias:0,by:0,calcMode:"calcMode",capHeight:"cap-height",clip:0,clipPath:"clip-path",clipRule:"clip-rule",clipPathUnits:"clipPathUnits",colorInterpolation:"color-interpolation",colorInterpolationFilters:"color-interpolation-filters",colorProfile:"color-profile",colorRendering:"color-rendering",contentScriptType:"contentScriptType",contentStyleType:"contentStyleType",cursor:0,cx:0,cy:0,d:0,decelerate:0,descent:0,diffuseConstant:"diffuseConstant",direction:0,display:0,divisor:0,dominantBaseline:"dominant-baseline",dur:0,dx:0,dy:0,edgeMode:"edgeMode",elevation:0,enableBackground:"enable-background",end:0,exponent:0,externalResourcesRequired:"externalResourcesRequired",fill:0,fillOpacity:"fill-opacity",fillRule:"fill-rule",filter:0,filterRes:"filterRes",filterUnits:"filterUnits",floodColor:"flood-color",floodOpacity:"flood-opacity",focusable:0,fontFamily:"font-family",fontSize:"font-size",fontSizeAdjust:"font-size-adjust",fontStretch:"font-stretch",fontStyle:"font-style",fontVariant:"font-variant",fontWeight:"font-weight",format:0,from:0,fx:0,fy:0,g1:0,g2:0,glyphName:"glyph-name",glyphOrientationHorizontal:"glyph-orientation-horizontal",glyphOrientationVertical:"glyph-orientation-vertical",glyphRef:"glyphRef",gradientTransform:"gradientTransform",gradientUnits:"gradientUnits",hanging:0,horizAdvX:"horiz-adv-x",horizOriginX:"horiz-origin-x",ideographic:0,imageRendering:"image-rendering",in:0,in2:0,intercept:0,k:0,k1:0,k2:0,k3:0,k4:0,kernelMatrix:"kernelMatrix",kernelUnitLength:"kernelUnitLength",kerning:0,keyPoints:"keyPoints",keySplines:"keySplines",keyTimes:"keyTimes",lengthAdjust:"lengthAdjust",letterSpacing:"letter-spacing",lightingColor:"lighting-color",limitingConeAngle:"limitingConeAngle",local:0,markerEnd:"marker-end",markerMid:"marker-mid",markerStart:"marker-start",markerHeight:"markerHeight",markerUnits:"markerUnits",markerWidth:"markerWidth",mask:0,maskContentUnits:"maskContentUnits",maskUnits:"maskUnits",mathematical:0,mode:0,numOctaves:"numOctaves",offset:0,opacity:0,operator:0,order:0,orient:0,orientation:0,origin:0,overflow:0,overlinePosition:"overline-position",overlineThickness:"overline-thickness",paintOrder:"paint-order",panose1:"panose-1",pathLength:"pathLength",patternContentUnits:"patternContentUnits",patternTransform:"patternTransform",patternUnits:"patternUnits",pointerEvents:"pointer-events",points:0,pointsAtX:"pointsAtX",pointsAtY:"pointsAtY",pointsAtZ:"pointsAtZ",preserveAlpha:"preserveAlpha",preserveAspectRatio:"preserveAspectRatio",primitiveUnits:"primitiveUnits",r:0,radius:0,refX:"refX",refY:"refY",renderingIntent:"rendering-intent",repeatCount:"repeatCount",repeatDur:"repeatDur",requiredExtensions:"requiredExtensions",requiredFeatures:"requiredFeatures",restart:0,result:0,rotate:0,rx:0,ry:0,scale:0,seed:0,shapeRendering:"shape-rendering",slope:0,spacing:0,specularConstant:"specularConstant",specularExponent:"specularExponent",speed:0,spreadMethod:"spreadMethod",startOffset:"startOffset",stdDeviation:"stdDeviation",stemh:0,stemv:0,stitchTiles:"stitchTiles",stopColor:"stop-color",stopOpacity:"stop-opacity",strikethroughPosition:"strikethrough-position",strikethroughThickness:"strikethrough-thickness",string:0,stroke:0,strokeDasharray:"stroke-dasharray",strokeDashoffset:"stroke-dashoffset",strokeLinecap:"stroke-linecap",strokeLinejoin:"stroke-linejoin",strokeMiterlimit:"stroke-miterlimit",strokeOpacity:"stroke-opacity",strokeWidth:"stroke-width",surfaceScale:"surfaceScale",systemLanguage:"systemLanguage",tableValues:"tableValues",targetX:"targetX",targetY:"targetY",textAnchor:"text-anchor",textDecoration:"text-decoration",textRendering:"text-rendering",textLength:"textLength",to:0,transform:0,u1:0,u2:0,underlinePosition:"underline-position",underlineThickness:"underline-thickness",unicode:0,unicodeBidi:"unicode-bidi",unicodeRange:"unicode-range",unitsPerEm:"units-per-em",vAlphabetic:"v-alphabetic",vHanging:"v-hanging",vIdeographic:"v-ideographic",vMathematical:"v-mathematical",values:0,vectorEffect:"vector-effect",version:0,vertAdvY:"vert-adv-y",vertOriginX:"vert-origin-x",vertOriginY:"vert-origin-y",viewBox:"viewBox",viewTarget:"viewTarget",visibility:0,widths:0,wordSpacing:"word-spacing",writingMode:"writing-mode",x:0,xHeight:"x-height",x1:0,x2:0,xChannelSelector:"xChannelSelector",xlinkActuate:"xlink:actuate",xlinkArcrole:"xlink:arcrole",xlinkHref:"xlink:href",xlinkRole:"xlink:role",xlinkShow:"xlink:show",xlinkTitle:"xlink:title",xlinkType:"xlink:type",xmlBase:"xml:base",xmlns:0,xmlnsXlink:"xmlns:xlink",xmlLang:"xml:lang",xmlSpace:"xml:space",y:0,y1:0,y2:0,yChannelSelector:"yChannelSelector",z:0,zoomAndPan:"zoomAndPan"},o={Properties:{},DOMAttributeNamespaces:{xlinkActuate:n.xlink,xlinkArcrole:n.xlink,xlinkHref:n.xlink,xlinkRole:n.xlink,xlinkShow:n.xlink,xlinkTitle:n.xlink,xlinkType:n.xlink,xmlBase:n.xml,xmlLang:n.xml,xmlSpace:n.xml},DOMAttributeNames:{}};Object.keys(r).forEach(function(e){o.Properties[e]=0,r[e]&&(o.DOMAttributeNames[e]=r[e])}),e.exports=o},function(e,t,n){"use strict";function r(e){if("selectionStart"in e&&u.hasSelectionCapabilities(e))return{start:e.selectionStart,end:e.selectionEnd};if(window.getSelection){var t=window.getSelection();return{anchorNode:t.anchorNode,anchorOffset:t.anchorOffset,focusNode:t.focusNode,focusOffset:t.focusOffset}}if(document.selection){var n=document.selection.createRange();return{parentElement:n.parentElement(),text:n.text,top:n.boundingTop,left:n.boundingLeft}}}function o(e,t){if(y||null==m||m!==c())return null;var n=r(m);if(!g||!f(g,n)){g=n;var o=l.getPooled(h.select,v,e,t);return o.type="select",o.target=m,i.accumulateTwoPhaseDispatches(o),o}return null}var i=n(25),a=n(7),s=n(6),u=n(72),l=n(11),c=n(59),p=n(81),f=n(36),d=a.canUseDOM&&"documentMode"in document&&document.documentMode<=11,h={select:{phasedRegistrationNames:{bubbled:"onSelect",captured:"onSelectCapture"},dependencies:["topBlur","topContextMenu","topFocus","topKeyDown","topKeyUp","topMouseDown","topMouseUp","topSelectionChange"]}},m=null,v=null,g=null,y=!1,b=!1,C={eventTypes:h,extractEvents:function(e,t,n,r){if(!b)return null;var i=t?s.getNodeFromInstance(t):window;switch(e){case"topFocus":(p(i)||"true"===i.contentEditable)&&(m=i,v=t,g=null);break;case"topBlur":m=null,v=null,g=null;break;case"topMouseDown":y=!0;break;case"topContextMenu":case"topMouseUp":return y=!1,o(n,r);case"topSelectionChange":if(d)break;case"topKeyDown":case"topKeyUp":return o(n,r)}return null},didPutListener:function(e,t,n){"onSelect"===t&&(b=!0)}};e.exports=C},function(e,t,n){"use strict";function r(e){return"."+e._rootNodeID}function o(e){return"button"===e||"input"===e||"select"===e||"textarea"===e}var i=n(3),a=n(57),s=n(25),u=n(6),l=n(168),c=n(169),p=n(11),f=n(172),d=n(174),h=n(30),m=n(171),v=n(175),g=n(176),y=n(27),b=n(177),C=n(8),_=n(47),w=(n(1),{}),E={};["abort","animationEnd","animationIteration","animationStart","blur","canPlay","canPlayThrough","click","contextMenu","copy","cut","doubleClick","drag","dragEnd","dragEnter","dragExit","dragLeave","dragOver","dragStart","drop","durationChange","emptied","encrypted","ended","error","focus","input","invalid","keyDown","keyPress","keyUp","load","loadedData","loadedMetadata","loadStart","mouseDown","mouseMove","mouseOut","mouseOver","mouseUp","paste","pause","play","playing","progress","rateChange","reset","scroll","seeked","seeking","stalled","submit","suspend","timeUpdate","touchCancel","touchEnd","touchMove","touchStart","transitionEnd","volumeChange","waiting","wheel"].forEach(function(e){var t=e[0].toUpperCase()+e.slice(1),n="on"+t,r="top"+t,o={phasedRegistrationNames:{bubbled:n,captured:n+"Capture"},dependencies:[r]};w[e]=o,E[r]=o});var T={},x={eventTypes:w,extractEvents:function(e,t,n,r){var o=E[e];if(!o)return null;var a;switch(e){case"topAbort":case"topCanPlay":case"topCanPlayThrough":case"topDurationChange":case"topEmptied":case"topEncrypted":case"topEnded":case"topError":case"topInput":case"topInvalid":case"topLoad":case"topLoadedData":case"topLoadedMetadata":case"topLoadStart":case"topPause":case"topPlay":case"topPlaying":case"topProgress":case"topRateChange":case"topReset":case"topSeeked":case"topSeeking":case"topStalled":case"topSubmit":case"topSuspend":case"topTimeUpdate":case"topVolumeChange":case"topWaiting":a=p;break;case"topKeyPress":if(0===_(n))return null;case"topKeyDown":case"topKeyUp":a=d;break;case"topBlur":case"topFocus":a=f;break;case"topClick":if(2===n.button)return null;case"topDoubleClick":case"topMouseDown":case"topMouseMove":case"topMouseUp":case"topMouseOut":case"topMouseOver":case"topContextMenu":a=h;break;case"topDrag":case"topDragEnd":case"topDragEnter":case"topDragExit":case"topDragLeave":case"topDragOver":case"topDragStart":case"topDrop":a=m;break;case"topTouchCancel":case"topTouchEnd":case"topTouchMove":case"topTouchStart":a=v;break;case"topAnimationEnd":case"topAnimationIteration":case"topAnimationStart":a=l;break;case"topTransitionEnd":a=g;break;case"topScroll":a=y;break;case"topWheel":a=b;break;case"topCopy":case"topCut":case"topPaste":a=c}a?void 0:i("86",e);var u=a.getPooled(o,t,n,r);return s.accumulateTwoPhaseDispatches(u),u},didPutListener:function(e,t,n){if("onClick"===t&&!o(e._tag)){var i=r(e),s=u.getNodeFromInstance(e);T[i]||(T[i]=a.listen(s,"click",C))}},willDeleteListener:function(e,t){if("onClick"===t&&!o(e._tag)){var n=r(e);T[n].remove(),delete T[n]}}};e.exports=x},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(11),i={animationName:null,elapsedTime:null,pseudoElement:null};o.augmentClass(r,i),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(11),i={clipboardData:function(e){return"clipboardData"in e?e.clipboardData:window.clipboardData}};o.augmentClass(r,i),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(11),i={data:null};o.augmentClass(r,i),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(30),i={dataTransfer:null};o.augmentClass(r,i),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(27),i={relatedTarget:null};o.augmentClass(r,i),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(11),i={data:null};o.augmentClass(r,i),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(27),i=n(47),a=n(182),s=n(48),u={key:a,location:null,ctrlKey:null,shiftKey:null,altKey:null,metaKey:null,repeat:null,locale:null,getModifierState:s,charCode:function(e){return"keypress"===e.type?i(e):0},keyCode:function(e){return"keydown"===e.type||"keyup"===e.type?e.keyCode:0},which:function(e){return"keypress"===e.type?i(e):"keydown"===e.type||"keyup"===e.type?e.keyCode:0}};o.augmentClass(r,u),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(27),i=n(48),a={touches:null,targetTouches:null,changedTouches:null,altKey:null,metaKey:null,ctrlKey:null,shiftKey:null,getModifierState:i};o.augmentClass(r,a),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(11),i={propertyName:null,elapsedTime:null,pseudoElement:null};o.augmentClass(r,i),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(30),i={deltaX:function(e){return"deltaX"in e?e.deltaX:"wheelDeltaX"in e?-e.wheelDeltaX:0},deltaY:function(e){return"deltaY"in e?e.deltaY:"wheelDeltaY"in e?-e.wheelDeltaY:"wheelDelta"in e?-e.wheelDelta:0},deltaZ:null,deltaMode:null};o.augmentClass(r,i),e.exports=r},function(e,t){"use strict";function n(e){for(var t=1,n=0,o=0,i=e.length,a=i&-4;o<a;){for(var s=Math.min(o+4096,a);o<s;o+=4)n+=(t+=e.charCodeAt(o))+(t+=e.charCodeAt(o+1))+(t+=e.charCodeAt(o+2))+(t+=e.charCodeAt(o+3));t%=r,n%=r}for(;o<i;o++)n+=t+=e.charCodeAt(o);return t%=r,n%=r,t|n<<16}var r=65521;e.exports=n},function(e,t,n){"use strict";function r(e,t,n){var r=null==t||"boolean"==typeof t||""===t;if(r)return"";var o=isNaN(t);if(o||0===t||i.hasOwnProperty(e)&&i[e])return""+t;if("string"==typeof t){t=t.trim()}return t+"px"}var o=n(64),i=(n(2),o.isUnitlessNumber);e.exports=r},function(e,t,n){"use strict";function r(e){if(null==e)return null;if(1===e.nodeType)return e;var t=a.get(e);return t?(t=s(t),t?i.getNodeFromInstance(t):null):void("function"==typeof e.render?o("44"):o("45",Object.keys(e)))}var o=n(3),i=(n(12),n(6)),a=n(26),s=n(78);n(1),n(2);e.exports=r},function(e,t,n){(function(t){"use strict";function r(e,t,n,r){if(e&&"object"==typeof e){var o=e,i=void 0===o[n];i&&null!=t&&(o[n]=t)}}function o(e,t){if(null==e)return e;var n={};return i(e,r,n),n}var i=(n(41),n(83));n(2);e.exports=o}).call(t,n(60))},function(e,t,n){"use strict";function r(e){if(e.key){var t=i[e.key]||e.key;if("Unidentified"!==t)return t}if("keypress"===e.type){var n=o(e);return 13===n?"Enter":String.fromCharCode(n)}return"keydown"===e.type||"keyup"===e.type?a[e.keyCode]||"Unidentified":""}var o=n(47),i={Esc:"Escape",Spacebar:" ",Left:"ArrowLeft",Up:"ArrowUp",Right:"ArrowRight",Down:"ArrowDown",Del:"Delete",Win:"OS",Menu:"ContextMenu",Apps:"ContextMenu",Scroll:"ScrollLock",MozPrintableKey:"Unidentified"},a={8:"Backspace",9:"Tab",12:"Clear",13:"Enter",16:"Shift",17:"Control",18:"Alt",19:"Pause",20:"CapsLock",27:"Escape",32:" ",33:"PageUp",34:"PageDown",35:"End",36:"Home",37:"ArrowLeft",38:"ArrowUp",39:"ArrowRight",40:"ArrowDown",45:"Insert",46:"Delete",112:"F1",113:"F2",114:"F3",115:"F4",116:"F5",117:"F6",118:"F7",119:"F8",120:"F9",121:"F10",122:"F11",123:"F12",144:"NumLock",145:"ScrollLock",224:"Meta"};e.exports=r},function(e,t){"use strict";function n(e){var t=e&&(r&&e[r]||e[o]);if("function"==typeof t)return t}var r="function"==typeof Symbol&&Symbol.iterator,o="@@iterator";e.exports=n},function(e,t){"use strict";function n(e){for(;e&&e.firstChild;)e=e.firstChild;return e}function r(e){for(;e;){if(e.nextSibling)return e.nextSibling;e=e.parentNode}}function o(e,t){for(var o=n(e),i=0,a=0;o;){if(3===o.nodeType){if(a=i+o.textContent.length,i<=t&&a>=t)return{node:o,offset:t-i};i=a}o=n(r(o))}}e.exports=o},function(e,t,n){"use strict";function r(e,t){var n={};return n[e.toLowerCase()]=t.toLowerCase(),n["Webkit"+e]="webkit"+t,n["Moz"+e]="moz"+t,n["ms"+e]="MS"+t,n["O"+e]="o"+t.toLowerCase(),n}function o(e){if(s[e])return s[e];if(!a[e])return e;var t=a[e];for(var n in t)if(t.hasOwnProperty(n)&&n in u)return s[e]=t[n];return""}var i=n(7),a={animationend:r("Animation","AnimationEnd"),animationiteration:r("Animation","AnimationIteration"),animationstart:r("Animation","AnimationStart"),transitionend:r("Transition","TransitionEnd")},s={},u={};i.canUseDOM&&(u=document.createElement("div").style,"AnimationEvent"in window||(delete a.animationend.animation,delete a.animationiteration.animation,delete a.animationstart.animation),"TransitionEvent"in window||delete a.transitionend.transition),e.exports=o},function(e,t,n){"use strict";function r(e){return'"'+o(e)+'"'}var o=n(32);e.exports=r},function(e,t,n){"use strict";var r=n(73);e.exports=r.renderSubtreeIntoContainer},function(e,t,n){"use strict";"undefined"==typeof Promise&&(n(120).enable(),window.Promise=n(119)),n(226),Object.assign=n(4)},113,114,115,116,117,function(e,t,n){(function(){var t,r,o;t=n(5),r=t.createClass,o=t.DOM.div,e.exports=r({getDefaultProps:function(){return{className:"",onHeightChange:function(){}}},render:function(){return o({className:this.props.className,ref:"dropdown"},this.props.children)},componentDidMount:function(){this.props.onHeightChange(this.refs.dropdown.offsetHeight)},componentDidUpdate:function(){this.props.onHeightChange(this.refs.dropdown.offsetHeight)},componentWillUnmount:function(){this.props.onHeightChange(0)}})}).call(this)},function(e,t,n){(function(){function t(e,t){var n={}.hasOwnProperty;for(var r in t)n.call(t,r)&&(e[r]=t[r]);return e}var r,o,i,a,s,u,l,c,p,f,d,h,m,v,g,y,b,C;r=n(15),o=r.filter,i=r.id,a=r.map,s=n(16).isEqualToObject,u=n(5),r=u.DOM,l=r.div,c=r.input,p=r.span,f=u.createClass,d=u.createFactory,h=n(13).findDOMNode,m=d(n(63)),v=d(n(198)),g=d(n(194)),y=d(n(84)),r=n(28),b=r.cancelEvent,C=r.classNameFromObject,e.exports=f({displayName:"DropdownMenu",getDefaultProps:function(){return{className:"",dropdownDirection:1,groupId:function(e){return e.groupId},groupsAsColumns:!1,highlightedUid:void 0,onHighlightedUidChange:function(e,t){},onOptionClick:function(e){},onScrollLockChange:function(e){},options:[],renderNoResultsFound:function(){return l({className:"no-results-found"},"No results found")},renderGroupTitle:function(e,t){var n,r;return null!=t&&(n=t.groupId,r=t.title),l({className:"simple-group-title",key:n},r)},renderOption:function(e){var t,n,r,o;return null!=e&&(t=e.label,n=e.newOption,r=e.selectable),o="undefined"==typeof r||r,l({className:"simple-option "+(o?"":"not-selectable")},p(null,n?"Add "+t+" ...":t))},scrollLock:!1,style:{},tether:!1,tetherProps:{},theme:"default",transitionEnter:!1,transitionLeave:!1,transitionEnterTimeout:200,transitionLeaveTimeout:200,uid:i}},render:function(){var e,n;return e=C((n={},n[this.props.theme+""]=1,n[this.props.className+""]=1,n.flipped=this.props.dropdownDirection===-1,n.tethered=this.props.tether,n)),this.props.tether?v((n=t({},this.props.tetherProps),n.options={attachment:"top left",targetAttachment:"bottom left",constraints:[{to:"scrollParent"}]},n),this.renderAnimatedDropdown({dynamicClassName:e})):this.renderAnimatedDropdown({dynamicClassName:e})},renderAnimatedDropdown:function(e){var t;return t=e.dynamicClassName,this.props.transitionEnter||this.props.transitionLeave?m({component:"div",transitionName:"custom",transitionEnter:this.props.transitionEnter,transitionLeave:this.props.transitionLeave,transitionEnterTimeout:this.props.transitionEnterTimeout,transitionLeaveTimeout:this.props.transitionLeaveTimeout,className:"dropdown-menu-wrapper "+t,ref:"dropdownMenuWrapper"},this.renderDropdown(e)):this.renderDropdown(e)},renderOptions:function(e){var n=this;return a(function(r){var o,i;return o=e[r],i=n.props.uid(o),y(t({uid:i,ref:"option-"+n.uidToString(i),key:n.uidToString(i),item:o,highlight:s(n.props.highlightedUid,i),selectable:null!=o?o.selectable:void 0,onMouseMove:function(e){var t;t=e.currentTarget,n.props.scrollLock&&n.props.onScrollLockChange(!1)},onMouseOut:function(){n.props.scrollLock||n.props.onHighlightedUidChange(void 0,function(){})},renderItem:n.props.renderOption},function(){switch(!1){case!("boolean"==typeof(null!=o?o.selectable:void 0)&&!o.selectable):return{onClick:b};default:return{onClick:function(){n.props.onOptionClick(n.props.highlightedUid)},onMouseOver:function(e){var t;t=e.currentTarget,n.props.scrollLock||n.props.onHighlightedUidChange(i,function(){})}}}}()))})(function(){var t,n,r=[];for(t=0,n=e.length;t<n;++t)r.push(t);return r}())},renderDropdown:function(e){var t,n,r,i,s=this;return t=e.dynamicClassName,this.props.open?g({className:"dropdown-menu "+t,ref:"dropdownMenu",onHeightChange:function(e){s.refs.dropdownMenuWrapper&&(h(s.refs.dropdownMenuWrapper).style.height=e+"px")}},0===this.props.options.length?this.props.renderNoResultsFound():(null!=(n=this.props)&&null!=(r=n.groups)?r.length:void 0)>0?(i=a(function(e){var t,n,r;return t=s.props.groups[e],n=t.groupId,r=o(function(e){return s.props.groupId(e)===n})(s.props.options),{index:e,group:t,options:r}})(function(){var e,t,n=[];for(e=0,t=this.props.groups.length;e<t;++e)n.push(e);return n}.call(this)),l({className:"groups "+(this.props.groupsAsColumns?"as-columns":"")},a(function(e){var t,n,r,o;return t=e.index,n=e.group,r=n.groupId,o=e.options,l({key:r},s.props.renderGroupTitle(t,n,o),l({className:"options"},s.renderOptions(o)))})(o(function(e){return e.options.length>0})(i)))):this.renderOptions(this.props.options)):null},componentDidUpdate:function(){var e,t,n;e=t=h(null!=(n=this.refs.dropdownMenuWrapper)?n:this.refs.dropdownMenu),null!=e&&(e.style.bottom=function(){switch(!1){case this.props.dropdownDirection!==-1:return this.props.bottomAnchor().offsetHeight+t.style.marginBottom+"px";default:return""}}.call(this))},highlightAndScrollToOption:function(e,t){var n,r=this;null==t&&(t=function(){}),n=this.props.uid(this.props.options[e]),this.props.onHighlightedUidChange(n,function(){var e,o,i,a,s;return null!=(e=h(null!=(o=r.refs)?o["option-"+r.uidToString(n)]:void 0))&&(i=e),i&&(a=h(r.refs.dropdownMenu),s=i.offsetHeight-1,i.offsetTop-a.scrollTop>=a.offsetHeight?a.scrollTop=i.offsetTop-a.offsetHeight+s:i.offsetTop-a.scrollTop+s<=0&&(a.scrollTop=i.offsetTop)),t()})},highlightAndScrollToSelectableOption:function(e,t,n){var r,o,i;null==n&&(n=function(){}),e<0||e>=this.props.options.length?this.props.onHighlightedUidChange(void 0,function(){return n(!1)}):(r=null!=(o=this.props)&&null!=(i=o.options)?i[e]:void 0,"boolean"!=typeof(null!=r?r.selectable:void 0)||r.selectable?this.highlightAndScrollToOption(e,function(){return n(!0)}):this.highlightAndScrollToSelectableOption(e+t,t,n))},uidToString:function(e){return("object"==typeof e?JSON.stringify:i)(e)}})}).call(this)},function(e,t,n){(function(){var t,r,o,i,a,s;t=n(5),r=t.createClass,o=t.DOM,i=o.div,a=o.span,s=n(15).map,e.exports=r({getDefaultProps:function(){return{partitions:[],text:"",style:{},highlightStyle:{}}},render:function(){var e=this;return i({className:"highlighted-text",style:this.props.style},s(function(t){var n,r,o;return n=t[0],r=t[1],o=t[2],a({key:e.props.text+""+n+r+o,className:o?"highlight":"",style:o?e.props.highlightStyle:{}},e.props.text.substring(n,r))})(this.props.partitions))}})}).call(this)},function(e,t,n){(function(){function t(e,t){for(var n=-1,r=t.length>>>0;++n<r;)if(e===t[n])return!0;return!1}function r(e,t){var n,r=function(o){return e.length>1?function(){var i=o?o.concat():[];return n=t?n||this:this,i.push.apply(i,arguments)<e.length&&arguments.length?r.call(n,i):e.apply(n,i)}:e};return r()}function o(e,t){var n={}.hasOwnProperty;for(var r in t)n.call(t,r)&&(e[r]=t[r]);return e}var i,a,s,u,l,c,p,f,d,h,m,v,g,y,b,C,_,w,E,T,x,O={}.toString;i=n(15),a=i.all,s=i.any,u=i.camelize,l=i.difference,c=i.drop,p=i.filter,f=i.find,d=i.findIndex,h=i.id,m=i.last,v=i.map,g=i.reject,y=n(16).isEqualToObject,b=n(5),C=b.createFactory,i=b.DOM,_=i.div,w=i.img,E=i.span,T=C(n(53)),x=n(28).cancelEvent,e.exports=b.createClass({displayName:"MultiSelect",getDefaultProps:function(){return{className:"",closeOnSelect:!1,defaultValues:[],delimiters:[],filterOptions:r(function(e,n,r){return p(function(e){return e.label.toLowerCase().trim().indexOf(r.toLowerCase().trim())>-1})(g(function(e){return t(e.label.trim(),v(function(e){return e.label.trim()},null!=n?n:[]))})(e))}),firstOptionIndexToHighlight:h,onBlur:function(e){},onFocus:function(e){},onPaste:function(e){},serialize:v(function(e){return null!=e?e.value:void 0}),tether:!1}},render:function(){var e,t,n,r,i,a,s,u,l,c,p,f,d,h,v,g,y,b,C,_,w,E,O,P,k,S,N,M,A,I,D,R,L,U,F,j,B,V,W=this;return e=this.getComputedState(),t=e.anchor,n=e.filteredOptions,r=e.highlightedUid,i=e.onAnchorChange,a=e.onOpenChange,s=e.onHighlightedUidChange,u=e.onSearchChange,l=e.onValuesChange,c=e.search,p=e.open,f=e.options,d=e.values,null!=(e=this.props)&&(h=e.autofocus,v=e.autosize,g=e.cancelKeyboardEventOnSelection,y=e.delimiters,b=e.disabled,C=e.dropdownDirection,_=e.groupId,w=e.groups,E=e.groupsAsColumns,O=e.hideResetButton,P=e.inputProps,k=e.name,S=e.onKeyboardSelectionFailed,N=e.renderToggleButton,M=e.renderGroupTitle,A=e.renderResetButton,I=e.serialize,D=e.tether,R=e.tetherProps,L=e.theme,U=e.transitionEnter,F=e.transitionLeave,j=e.transitionEnterTimeout,B=e.transitionLeaveTimeout,V=e.uid),T(o(o({autofocus:h,autosize:v,cancelKeyboardEventOnSelection:g,className:"multi-select "+this.props.className,delimiters:y,disabled:b,dropdownDirection:C,groupId:_,groups:w,groupsAsColumns:E,hideResetButton:O,highlightedUid:r,onHighlightedUidChange:s,inputProps:P,name:k,onKeyboardSelectionFailed:S,renderGroupTitle:M,renderResetButton:A,renderToggleButton:N,scrollLock:this.state.scrollLock,onScrollLockChange:function(e){return W.setState({scrollLock:e})},tether:D,tetherProps:R,theme:L,transitionEnter:U,transitionEnterTimeout:j,transitionLeave:F,transitionLeaveTimeout:B,uid:V,ref:"select",anchor:t,onAnchorChange:i,open:p,onOpenChange:a,options:f,renderOption:this.props.renderOption,firstOptionIndexToHighlight:function(){return W.firstOptionIndexToHighlight(f)},search:c,onSearchChange:function(e,t){return u(W.props.maxValues&&d.length>=W.props.maxValues?"":e,t)},values:d,onValuesChange:function(e,t){return l(e,function(){if(t(),W.props.closeOnSelect||W.props.maxValues&&W.values().length>=W.props.maxValues)return a(!1,function(){})})},renderValue:this.props.renderValue,serialize:I,onBlur:function(e){u("",function(){return W.props.onBlur({open:p,values:d,originalEvent:e})})},onFocus:function(e){W.props.onFocus({open:p,values:d,originalEvent:e})},onPaste:function(){var e;switch(!1){case"undefined"!=typeof(null!=(e=this.props)?e.valuesFromPaste:void 0):return this.props.onPaste;default:return function(e){var t;return t=e.clipboardData,function(){var e;return e=d.concat(W.props.valuesFromPaste(f,d,t.getData("text"))),l(e,function(){return i(m(e))})}(),x(e)}}}.call(this),placeholder:this.props.placeholder,style:this.props.style},function(){switch(!1){case"function"!=typeof this.props.restoreOnBackspace:return{restoreOnBackspace:this.props.restoreOnBackspace};default:return{}}}.call(this)),function(){switch(!1){case"function"!=typeof this.props.renderNoResultsFound:return{renderNoResultsFound:function(){return W.props.renderNoResultsFound(d,c)}};default:return{}}}.call(this)))},getComputedState:function(){var e,t,n,r,i,a,s,l,c,p,f,d,h,m,g,y,b=this;return e=this.props.hasOwnProperty("anchor")?this.props.anchor:this.state.anchor,t=this.props.hasOwnProperty("highlightedUid")?this.props.highlightedUid:this.state.highlightedUid,n=this.isOpen(),r=this.props.hasOwnProperty("search")?this.props.search:this.state.search,i=this.values(),a=v(function(e){switch(!1){case!(b.props.hasOwnProperty(e)&&b.props.hasOwnProperty(u("on-"+e+"-change"))):return function(t,n){return b.props[u("on-"+e+"-change")](t,function(){}),b.setState({},n)};case!(b.props.hasOwnProperty(e)&&!b.props.hasOwnProperty(u("on-"+e+"-change"))):return function(e,t){return t()};case!(!b.props.hasOwnProperty(e)&&b.props.hasOwnProperty(u("on-"+e+"-change"))):return function(t,n){var r;return b.setState((r={},r[e+""]=t,r),function(){return n(),b.props[u("on-"+e+"-change")](t,function(){})})};case!(!b.props.hasOwnProperty(e)&&!b.props.hasOwnProperty(u("on-"+e+"-change"))):return function(t,n){var r;return b.setState((r={},r[e+""]=t,r),n)}}})(["anchor","highlightedUid","open","search","values"]),s=a[0],l=a[1],c=a[2],p=a[3],f=a[4],d=function(){var e;switch(!1){case!(null!=(e=this.props)&&e.children):return v(function(e){var t,n,r;return null!=e&&(t=e.props),null!=t&&(n=t.value,r=t.children),{label:r,value:n}})("Array"===O.call(this.props.children).slice(8,-1)?this.props.children:[this.props.children]);default:return[]}}.call(this),h=this.props.hasOwnProperty("options")?null!=(a=this.props.options)?a:[]:d,m=this.props.filterOptions(h,i,r),g=function(){switch(!1){case"function"!=typeof this.props.createFromSearch:return this.props.createFromSearch(m,i,r);default:return null}}.call(this),y=(g?[(a=o({},g),a.newOption=!0,a)]:[]).concat(m),{anchor:e,highlightedUid:t,search:r,values:i,onAnchorChange:s,onHighlightedUidChange:l,open:n,onOpenChange:function(e,t){c(function(){switch(!1){case!("undefined"!=typeof this.props.maxValues&&this.values().length>=this.props.maxValues):return!1;default:return e}}.call(b),t)},onSearchChange:p,onValuesChange:f,filteredOptions:m,options:y}},getInitialState:function(){return{anchor:this.props.values?m(this.props.values):void 0,highlightedUid:void 0,open:!1,scrollLock:!1,search:"",values:this.props.defaultValues}},firstOptionIndexToHighlight:function(e){var t,n;return t=function(){var t;switch(!1){case 1!==e.length:return 0;case"undefined"!=typeof(null!=(t=e[0])?t.newOption:void 0):return 0;default:return a(function(e){return"boolean"==typeof e.selectable&&!e.selectable})(c(1)(e))?0:1}}(),n=this.props.hasOwnProperty("search")?this.props.search:this.state.search,this.props.firstOptionIndexToHighlight(t,e,this.values(),n)},focus:function(){this.refs.select.focus()},blur:function(){this.refs.select.blur()},highlightFirstSelectableOption:function(){this.state.open&&this.refs.select.highlightAndScrollToSelectableOption(this.firstOptionIndexToHighlight(this.getComputedState().options),1)},values:function(){return this.props.hasOwnProperty("values")?this.props.values:this.state.values},isOpen:function(){return this.props.hasOwnProperty("open")?this.props.open:this.state.open}})}).call(this)},function(e,t,n){(function(){function t(e,t){var n={}.hasOwnProperty;for(var r in t)n.call(t,r)&&(e[r]=t[r]);return e}var r,o,i,a,s,u;r=n(5).createClass,o=n(13),i=o.render,a=o.unmountComponentAtNode,s=n(124),u=n(224),e.exports=r({getDefaultProps:function(){return{parentElement:function(){return document.body;
-}}},render:function(){return null},initTether:function(e){var n=this;this.node=document.createElement("div"),this.props.parentElement().appendChild(this.node),this.tether=new u(t({element:this.node,target:e.target()},e.options)),i(e.children,this.node,function(){return n.tether.position()})},destroyTether:function(){this.tether&&this.tether.destroy(),this.node&&(a(this.node),this.node.parentElement.removeChild(this.node)),this.node=this.tether=void 0},componentDidMount:function(){this.props.children&&this.initTether(this.props)},componentWillReceiveProps:function(e){var n=this;this.props.children&&!e.children?this.destroyTether():e.children&&!this.props.children?this.initTether(e):e.children&&(this.tether.setOptions(t({element:this.node,target:e.target()},e.options)),i(e.children,this.node,function(){return n.tether.position()}))},shouldComponentUpdate:function(e,t){return s(this,e,t)},componentWillUnmount:function(){this.destroyTether()}})}).call(this)},function(e,t,n){(function(){var t,r,o,i,a;t=n(5),r=t.createClass,o=t.createFactory,i=t.DOM.path,a=o(n(85)),e.exports=r({render:function(){return a({className:"react-selectize-reset-button",style:{width:8,height:8}},i({d:"M0 0 L8 8 M8 0 L 0 8"}))}})}).call(this)},function(e,t,n){(function(){function t(e,t){var n={}.hasOwnProperty;for(var r in t)n.call(t,r)&&(e[r]=t[r]);return e}var r,o,i,a,s,u,l,c;r=n(15),o=r.each,i=r.objToPairs,a=n(5),s=a.DOM.input,u=a.createClass,l=a.createFactory,c=n(13).findDOMNode,e.exports=u({displayName:"ResizableInput",render:function(){var e;return s((e=t({},this.props),e.type="input",e.className="resizable-input",e))},autosize:function(){var e,t,n,r,a;return e=t=c(this),e.style.width="0px",0===t.value.length?t.style.width=null!=t&&t.currentStyle?"4px":"2px":t.scrollWidth>0?t.style.width=2+t.scrollWidth+"px":(n=r=document.createElement("div"),n.innerHTML=t.value,function(){var e;return e=r.style,e.display="inline-block",e.width="",e}(o(function(e){var t,n;return t=e[0],n=e[1],r.style[t]=n})(i(t.currentStyle?t.currentStyle:null!=(a=document.defaultView)?a:window.getComputedStyle(t)))),document.body.appendChild(r),t.style.width=4+r.clientWidth+"px",document.body.removeChild(r))},componentDidMount:function(){this.autosize()},componentDidUpdate:function(){this.autosize()},blur:function(){return c(this).blur()},focus:function(){return c(this).focus()}})}).call(this)},function(e,t,n){(function(){function t(e,t){var n,r=function(o){return e.length>1?function(){var i=o?o.concat():[];return n=t?n||this:this,i.push.apply(i,arguments)<e.length&&arguments.length?r.call(n,i):e.apply(n,i)}:e};return r()}function r(e,t){var n={}.hasOwnProperty;for(var r in t)n.call(t,r)&&(e[r]=t[r]);return e}var o,i,a,s,u,l,c,p,f,d,h,m,v,g,y,b,C,_,w,E,T,x={}.toString;o=n(15),i=o.all,a=o.any,s=o.drop,u=o.camelize,l=o.difference,c=o.filter,p=o.find,f=o.findIndex,d=o.id,h=o.last,m=o.map,v=o.reject,g=n(16).isEqualToObject,y=n(5),b=y.createFactory,o=y.DOM,C=o.div,_=o.img,w=o.span,E=b(n(53)),T=n(28).cancelEvent,e.exports=y.createClass({displayName:"SimpleSelect",getDefaultProps:function(){return{delimiters:[],filterOptions:t(function(e,t){return c(function(e){return e.label.toLowerCase().trim().indexOf(t.toLowerCase().trim())>-1})(e)}),firstOptionIndexToHighlight:d,onBlur:function(e){},onBlurResetsInput:!0,onFocus:function(e){},onKeyboardSelectionFailed:function(e){},onPaste:function(e){},placeholder:"",renderValue:function(e){var t;return t=e.label,C({className:"simple-value"},w(null,t))},serialize:function(e){return null!=e?e.value:void 0},style:{},tether:!1,uid:d}},render:function(){var e,t,n,o,i,a,s,u,l,c,p,f,d,m,v,y,b,C,_,w,x,O,P,k,S,N,M,A,I,D,R,L,U,F,j,B,V,W=this;return e=this.getComputedState(),t=e.filteredOptions,n=e.highlightedUid,o=e.onHighlightedUidChange,i=e.onOpenChange,a=e.onSearchChange,s=e.onValueChange,u=e.open,l=e.options,c=e.search,p=e.value,f=e.values,null!=(e=this.props)&&(d=e.autofocus,m=e.autosize,v=e.cancelKeyboardEventOnSelection,y=e.delimiters,b=e.disabled,C=e.dropdownDirection,_=e.groupId,w=e.groups,x=e.groupsAsColumns,O=e.hideResetButton,P=e.name,k=e.inputProps,S=e.onBlurResetsInput,N=e.renderToggleButton,M=e.renderGroupTitle,A=e.renderResetButton,I=e.serialize,D=e.tether,R=e.tetherProps,L=e.theme,U=e.transitionEnter,F=e.transitionLeave,j=e.transitionEnterTimeout,B=e.transitionLeaveTimeout,V=e.uid),E(r(r({autofocus:d,autosize:m,cancelKeyboardEventOnSelection:v,className:"simple-select"+(this.props.className?" "+this.props.className:""),delimiters:y,disabled:b,dropdownDirection:C,groupId:_,groups:w,groupsAsColumns:x,hideResetButton:O,highlightedUid:n,onHighlightedUidChange:o,inputProps:k,name:P,onBlurResetsInput:S,renderGroupTitle:M,renderResetButton:A,renderToggleButton:N,scrollLock:this.state.scrollLock,onScrollLockChange:function(e){return W.setState({scrollLock:e})},tether:D,tetherProps:R,theme:L,transitionEnter:U,transitionEnterTimeout:j,transitionLeave:F,transitionLeaveTimeout:B,ref:"select",anchor:h(f),onAnchorChange:function(e,t){return t()},open:u,onOpenChange:i,firstOptionIndexToHighlight:function(){return W.firstOptionIndexToHighlight(l,p)},options:l,renderOption:this.props.renderOption,renderNoResultsFound:this.props.renderNoResultsFound,search:c,onSearchChange:function(e,t){return a(e,t)},values:f,onValuesChange:function(e,t){var n,r;return 0===e.length?s(void 0,function(){return t()}):(n=h(e),r=!g(n,p),function(){return function(e){return r?s(n,e):e()}}()(function(){return t(),i(!1,function(){})}))},renderValue:function(e){return u&&(W.props.editable||c.length>0)?null:W.props.renderValue(e)},onKeyboardSelectionFailed:function(e){return a("",function(){return i(!1,function(){return W.props.onKeyboardSelectionFailed(e)})})},uid:function(e){return{uid:W.props.uid(e),open:u,search:c}},serialize:function(e){return I(e[0])},onBlur:function(e){var t;t=W.props.onBlurResetsInput,function(){return function(e){return c.length>0&&t?a("",e):e()}}()(function(){return W.props.onBlur({value:p,open:u,originalEvent:e})})},onFocus:function(e){W.props.onFocus({value:p,open:u,originalEvent:e})},onPaste:function(){var e;switch(!1){case"undefined"!=typeof(null!=(e=this.props)?e.valueFromPaste:void 0):return this.props.onPaste;default:return function(e){var t,n;if(t=e.clipboardData,n=W.props.valueFromPaste(l,p,t.getData("text")))return function(){return s(n,function(){return a("",function(){return i(!1)})})}(),T(e)}}}.call(this),placeholder:this.props.placeholder,style:this.props.style},function(){switch(!1){case"function"!=typeof this.props.restoreOnBackspace:return{restoreOnBackspace:this.props.restoreOnBackspace};default:return{}}}.call(this)),function(){switch(!1){case"function"!=typeof this.props.renderNoResultsFound:return{renderNoResultsFound:function(){return W.props.renderNoResultsFound(p,c)}};default:return{}}}.call(this)))},getComputedState:function(){var e,t,n,o,i,a,s,l,c,p,f,d,h,v,g,y=this;return e=this.props.hasOwnProperty("highlightedUid")?this.props.highlightedUid:this.state.highlightedUid,t=this.isOpen(),n=this.props.hasOwnProperty("search")?this.props.search:this.state.search,o=this.value(),i=o||0===o?[o]:[],a=m(function(e){var t;return t=function(){switch(!1){case!(this.props.hasOwnProperty(e)&&this.props.hasOwnProperty(u("on-"+e+"-change"))):return function(t,n){return y.props[u("on-"+e+"-change")](t,function(){}),y.setState({},n)};case!(this.props.hasOwnProperty(e)&&!this.props.hasOwnProperty(u("on-"+e+"-change"))):return function(e,t){return t()};case!(!this.props.hasOwnProperty(e)&&this.props.hasOwnProperty(u("on-"+e+"-change"))):return function(t,n){var r;return y.setState((r={},r[e+""]=t,r),function(){return n(),y.props[u("on-"+e+"-change")](t,function(){})})};case!(!this.props.hasOwnProperty(e)&&!this.props.hasOwnProperty(u("on-"+e+"-change"))):return function(t,n){var r;return y.setState((r={},r[e+""]=t,r),n)}}}.call(y)})(["highlightedUid","open","search","value"]),s=a[0],l=a[1],c=a[2],p=a[3],f=function(){var e;switch(!1){case!(null!=(e=this.props)&&e.children):return m(function(e){var t,n,r;return null!=(t=null!=e?e.props:void 0)&&(n=t.value,r=t.children),{label:r,value:n}})("Array"===x.call(this.props.children).slice(8,-1)?this.props.children:[this.props.children]);default:return[]}}.call(this),d=this.props.hasOwnProperty("options")?null!=(a=this.props.options)?a:[]:f,h=this.props.filterOptions(d,n),v=function(){switch(!1){case"function"!=typeof this.props.createFromSearch:return this.props.createFromSearch(h,n);default:return null}}.call(this),g=(v?[(a=r({},v),a.newOption=!0,a)]:[]).concat(h),{highlightedUid:e,open:t,search:n,value:o,values:i,onHighlightedUidChange:s,onOpenChange:function(e,t){l(e,function(){if(t(),y.props.editable&&y.isOpen()&&o)return c(y.props.editable(o)+""+(1===n.length?n:""),function(){return y.highlightFirstSelectableOption(function(){})})})},onSearchChange:c,onValueChange:p,filteredOptions:h,options:g}},getInitialState:function(){var e;return{highlightedUid:void 0,open:!1,scrollLock:!1,search:"",value:null!=(e=this.props)?e.defaultValue:void 0}},firstOptionIndexToHighlight:function(e,t){var n,r,o;return n=t?f(function(e){return g(e,t)},e):void 0,r=function(){var t;switch(!1){case"undefined"==typeof n:return n;case 1!==e.length:return 0;case"undefined"!=typeof(null!=(t=e[0])?t.newOption:void 0):return 0;default:return i(function(e){return"boolean"==typeof e.selectable&&!e.selectable})(s(1)(e))?0:1}}(),o=this.props.hasOwnProperty("search")?this.props.search:this.state.search,this.props.firstOptionIndexToHighlight(r,e,t,o)},focus:function(){this.refs.select.focus()},blur:function(){this.refs.select.blur()},highlightFirstSelectableOption:function(e){var t,n,r;null==e&&(e=function(){}),this.state.open?(t=this.getComputedState(),n=t.options,r=t.value,this.refs.select.highlightAndScrollToSelectableOption(this.firstOptionIndexToHighlight(n,r),1,e)):e()},value:function(){return this.props.hasOwnProperty("value")?this.props.value:this.state.value},isOpen:function(){return this.props.hasOwnProperty("open")?this.props.open:this.state.open}})}).call(this)},function(e,t,n){(function(){var t,r,o,i,a;t=n(5),r=t.createClass,o=t.createFactory,i=t.DOM.path,a=o(n(85)),e.exports=r({getDefaultProps:function(){return{open:!1,flipped:!1}},render:function(){return a({className:"react-selectize-toggle-button",style:{width:10,height:8}},i({d:function(){switch(!1){case!(this.props.open&&!this.props.flipped||!this.props.open&&this.props.flipped):return"M0 6 L5 1 L10 6 Z";default:return"M0 1 L5 6 L10 1 Z"}}.call(this)}))}})}).call(this)},function(e,t,n){(function(){var t,r,o,i;t=n(5),r=t.createClass,o=t.DOM.div,i=n(16).isEqualToObject,e.exports=r({getDefaultProps:function(){return{}},render:function(){return o({className:"value-wrapper"},this.props.renderItem(this.props.item))},shouldComponentUpdate:function(e){var t;return!i(null!=e?e.uid:void 0,null!=(t=this.props)?t.uid:void 0)}})}).call(this)},function(e,t,n){(function(){var t,r,o,i;t=n(196),r=n(201),o=n(197),i=n(53),e.exports={HighlightedText:t,SimpleSelect:r,MultiSelect:o,ReactSelectize:i}}).call(this)},function(e,t,n){"use strict";function r(e){return e&&e.__esModule?e:{default:e}}function o(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function i(e,t){if(!e)throw new ReferenceError("this hasn't been initialised - super() hasn't been called");return!t||"object"!=typeof t&&"function"!=typeof t?e:t}function a(e,t){if("function"!=typeof t&&null!==t)throw new TypeError("Super expression must either be null or a function, not "+typeof t);e.prototype=Object.create(t&&t.prototype,{constructor:{value:e,enumerable:!1,writable:!0,configurable:!0}}),t&&(Object.setPrototypeOf?Object.setPrototypeOf(e,t):e.__proto__=t)}t.__esModule=!0;var s=Object.assign||function(e){for(var t=1;t<arguments.length;t++){var n=arguments[t];for(var r in n)Object.prototype.hasOwnProperty.call(n,r)&&(e[r]=n[r])}return e},u=n(5),l=r(u),c=n(34),p=r(c),f=n(207),d=r(f),h=n(206),m=r(h),v=n(86),g=({transitionName:v.nameShape.isRequired,transitionAppear:p.default.bool,transitionEnter:p.default.bool,transitionLeave:p.default.bool,transitionAppearTimeout:(0,v.transitionTimeout)("Appear"),transitionEnterTimeout:(0,v.transitionTimeout)("Enter"),transitionLeaveTimeout:(0,v.transitionTimeout)("Leave")},{transitionAppear:!1,transitionEnter:!0,transitionLeave:!0}),y=function(e){function t(){var n,r,a;o(this,t);for(var s=arguments.length,u=Array(s),c=0;c<s;c++)u[c]=arguments[c];return n=r=i(this,e.call.apply(e,[this].concat(u))),r._wrapChild=function(e){return l.default.createElement(m.default,{name:r.props.transitionName,appear:r.props.transitionAppear,enter:r.props.transitionEnter,leave:r.props.transitionLeave,appearTimeout:r.props.transitionAppearTimeout,enterTimeout:r.props.transitionEnterTimeout,leaveTimeout:r.props.transitionLeaveTimeout},e)},a=n,i(r,a)}return a(t,e),t.prototype.render=function(){return l.default.createElement(d.default,s({},this.props,{childFactory:this._wrapChild}))},t}(l.default.Component);y.displayName="CSSTransitionGroup",y.propTypes={},y.defaultProps=g,t.default=y,e.exports=t.default},function(e,t,n){"use strict";function r(e){return e&&e.__esModule?e:{default:e}}function o(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function i(e,t){if(!e)throw new ReferenceError("this hasn't been initialised - super() hasn't been called");return!t||"object"!=typeof t&&"function"!=typeof t?e:t}function a(e,t){if("function"!=typeof t&&null!==t)throw new TypeError("Super expression must either be null or a function, not "+typeof t);e.prototype=Object.create(t&&t.prototype,{constructor:{value:e,enumerable:!1,writable:!0,configurable:!0}}),t&&(Object.setPrototypeOf?Object.setPrototypeOf(e,t):e.__proto__=t)}function s(e,t){return w.length?w.forEach(function(n){return e.addEventListener(n,t,!1)}):setTimeout(t,0),function(){w.length&&w.forEach(function(n){return e.removeEventListener(n,t,!1)})}}t.__esModule=!0;var u=Object.assign||function(e){for(var t=1;t<arguments.length;t++){var n=arguments[t];for(var r in n)Object.prototype.hasOwnProperty.call(n,r)&&(e[r]=n[r])}return e},l=n(96),c=r(l),p=n(98),f=r(p),d=n(100),h=r(d),m=n(99),v=n(5),g=r(v),y=n(34),b=r(y),C=n(13),_=n(86),w=[];m.transitionEnd&&w.push(m.transitionEnd),m.animationEnd&&w.push(m.animationEnd);var E=({children:b.default.node,name:_.nameShape.isRequired,appear:b.default.bool,enter:b.default.bool,leave:b.default.bool,appearTimeout:b.default.number,enterTimeout:b.default.number,leaveTimeout:b.default.number},function(e){function t(){var n,r,a;o(this,t);for(var s=arguments.length,u=Array(s),l=0;l<s;l++)u[l]=arguments[l];return n=r=i(this,e.call.apply(e,[this].concat(u))),r.componentWillAppear=function(e){r.props.appear?r.transition("appear",e,r.props.appearTimeout):e()},r.componentWillEnter=function(e){r.props.enter?r.transition("enter",e,r.props.enterTimeout):e()},r.componentWillLeave=function(e){r.props.leave?r.transition("leave",e,r.props.leaveTimeout):e()},a=n,i(r,a)}return a(t,e),t.prototype.componentWillMount=function(){this.classNameAndNodeQueue=[],this.transitionTimeouts=[]},t.prototype.componentWillUnmount=function(){this.unmounted=!0,this.timeout&&clearTimeout(this.timeout),this.transitionTimeouts.forEach(function(e){clearTimeout(e)}),this.classNameAndNodeQueue.length=0},t.prototype.transition=function(e,t,n){var r=(0,C.findDOMNode)(this);if(!r)return void(t&&t());var o=this.props.name[e]||this.props.name+"-"+e,i=this.props.name[e+"Active"]||o+"-active",a=null,u=void 0;(0,c.default)(r,o),this.queueClassAndNode(i,r);var l=function(e){e&&e.target!==r||(clearTimeout(a),u&&u(),(0,f.default)(r,o),(0,f.default)(r,i),u&&u(),t&&t())};n?(a=setTimeout(l,n),this.transitionTimeouts.push(a)):m.transitionEnd&&(u=s(r,l))},t.prototype.queueClassAndNode=function(e,t){var n=this;this.classNameAndNodeQueue.push({className:e,node:t}),this.rafHandle||(this.rafHandle=(0,h.default)(function(){return n.flushClassNameAndNodeQueue()}))},t.prototype.flushClassNameAndNodeQueue=function(){this.unmounted||this.classNameAndNodeQueue.forEach(function(e){e.node.scrollTop,(0,c.default)(e.node,e.className)}),this.classNameAndNodeQueue.length=0,this.rafHandle=null},t.prototype.render=function(){var e=u({},this.props);return delete e.name,delete e.appear,delete e.enter,delete e.leave,delete e.appearTimeout,delete e.enterTimeout,delete e.leaveTimeout,delete e.children,g.default.cloneElement(g.default.Children.only(this.props.children),e)},t}(g.default.Component));E.displayName="CSSTransitionGroupChild",E.propTypes={},t.default=E,e.exports=t.default},function(e,t,n){"use strict";function r(e){return e&&e.__esModule?e:{default:e}}function o(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function i(e,t){if(!e)throw new ReferenceError("this hasn't been initialised - super() hasn't been called");return!t||"object"!=typeof t&&"function"!=typeof t?e:t}function a(e,t){if("function"!=typeof t&&null!==t)throw new TypeError("Super expression must either be null or a function, not "+typeof t);e.prototype=Object.create(t&&t.prototype,{constructor:{value:e,enumerable:!1,writable:!0,configurable:!0}}),t&&(Object.setPrototypeOf?Object.setPrototypeOf(e,t):e.__proto__=t)}t.__esModule=!0;var s=Object.assign||function(e){for(var t=1;t<arguments.length;t++){var n=arguments[t];for(var r in n)Object.prototype.hasOwnProperty.call(n,r)&&(e[r]=n[r])}return e},u=n(95),l=r(u),c=n(5),p=r(c),f=n(34),d=r(f),h=n(225),m=(r(h),n(210)),v=({component:d.default.any,childFactory:d.default.func,children:d.default.node},{component:"span",childFactory:function(e){return e}}),g=function(e){function t(n,r){o(this,t);var a=i(this,e.call(this,n,r));return a.performAppear=function(e,t){a.currentlyTransitioningKeys[e]=!0,t.componentWillAppear?t.componentWillAppear(a._handleDoneAppearing.bind(a,e,t)):a._handleDoneAppearing(e,t)},a._handleDoneAppearing=function(e,t){t.componentDidAppear&&t.componentDidAppear(),delete a.currentlyTransitioningKeys[e];var n=(0,m.getChildMapping)(a.props.children);n&&n.hasOwnProperty(e)||a.performLeave(e,t)},a.performEnter=function(e,t){a.currentlyTransitioningKeys[e]=!0,t.componentWillEnter?t.componentWillEnter(a._handleDoneEntering.bind(a,e,t)):a._handleDoneEntering(e,t)},a._handleDoneEntering=function(e,t){t.componentDidEnter&&t.componentDidEnter(),delete a.currentlyTransitioningKeys[e];var n=(0,m.getChildMapping)(a.props.children);n&&n.hasOwnProperty(e)||a.performLeave(e,t)},a.performLeave=function(e,t){a.currentlyTransitioningKeys[e]=!0,t.componentWillLeave?t.componentWillLeave(a._handleDoneLeaving.bind(a,e,t)):a._handleDoneLeaving(e,t)},a._handleDoneLeaving=function(e,t){t.componentDidLeave&&t.componentDidLeave(),delete a.currentlyTransitioningKeys[e];var n=(0,m.getChildMapping)(a.props.children);n&&n.hasOwnProperty(e)?a.keysToEnter.push(e):a.setState(function(t){var n=s({},t.children);return delete n[e],{children:n}})},a.childRefs=Object.create(null),a.state={children:(0,m.getChildMapping)(n.children)},a}return a(t,e),t.prototype.componentWillMount=function(){this.currentlyTransitioningKeys={},this.keysToEnter=[],this.keysToLeave=[]},t.prototype.componentDidMount=function(){var e=this.state.children;for(var t in e)e[t]&&this.performAppear(t,this.childRefs[t])},t.prototype.componentWillReceiveProps=function(e){var t=(0,m.getChildMapping)(e.children),n=this.state.children;this.setState({children:(0,m.mergeChildMappings)(n,t)});for(var r in t){var o=n&&n.hasOwnProperty(r);!t[r]||o||this.currentlyTransitioningKeys[r]||this.keysToEnter.push(r)}for(var i in n){var a=t&&t.hasOwnProperty(i);!n[i]||a||this.currentlyTransitioningKeys[i]||this.keysToLeave.push(i)}},t.prototype.componentDidUpdate=function(){var e=this,t=this.keysToEnter;this.keysToEnter=[],t.forEach(function(t){return e.performEnter(t,e.childRefs[t])});var n=this.keysToLeave;this.keysToLeave=[],n.forEach(function(t){return e.performLeave(t,e.childRefs[t])})},t.prototype.render=function(){var e=this,t=[],n=function(n){var r=e.state.children[n];if(r){var o="string"!=typeof r.ref,i=e.props.childFactory(r),a=function(t){e.childRefs[n]=t};i===r&&o&&(a=(0,l.default)(r.ref,a)),t.push(p.default.cloneElement(i,{key:n,ref:a}))}};for(var r in this.state.children)n(r);var o=s({},this.props);return delete o.transitionLeave,delete o.transitionName,delete o.transitionAppear,delete o.transitionEnter,delete o.childFactory,delete o.transitionLeaveTimeout,delete o.transitionEnterTimeout,delete o.transitionAppearTimeout,delete o.component,p.default.createElement(this.props.component,o,t)},t}(p.default.Component);g.displayName="TransitionGroup",g.propTypes={},g.defaultProps=v,t.default=g,e.exports=t.default},function(e,t,n){"use strict";function r(){}function o(){}var i=n(209);o.resetWarningCache=r,e.exports=function(){function e(e,t,n,r,o,a){if(a!==i){var s=new Error("Calling PropTypes validators directly is not supported by the `prop-types` package. Use PropTypes.checkPropTypes() to call them. Read more at http://fb.me/use-check-prop-types");throw s.name="Invariant Violation",s}}function t(){return e}e.isRequired=e;var n={array:e,bigint:e,bool:e,func:e,number:e,object:e,string:e,symbol:e,any:e,arrayOf:t,element:e,elementType:e,instanceOf:t,node:e,objectOf:t,oneOf:t,oneOfType:t,shape:t,exact:t,checkPropTypes:o,resetWarningCache:r};return n.PropTypes=n,n}},function(e,t){"use strict";var n="SECRET_DO_NOT_PASS_THIS_OR_YOU_WILL_BE_FIRED";e.exports=n},function(e,t,n){"use strict";function r(e){if(!e)return e;var t={};return i.Children.map(e,function(e){return e}).forEach(function(e){t[e.key]=e}),t}function o(e,t){function n(n){return t.hasOwnProperty(n)?t[n]:e[n]}e=e||{},t=t||{};var r={},o=[];for(var i in e)t.hasOwnProperty(i)?o.length&&(r[i]=o,o=[]):o.push(i);var a=void 0,s={};for(var u in t){if(r.hasOwnProperty(u))for(a=0;a<r[u].length;a++){var l=r[u][a];s[r[u][a]]=n(l)}s[u]=n(u)}for(a=0;a<o.length;a++)s[o[a]]=n(o[a]);return s}t.__esModule=!0,t.getChildMapping=r,t.mergeChildMappings=o;var i=n(5)},41,[228,22],function(e,t,n){"use strict";function r(e){return(""+e).replace(C,"$&/")}function o(e,t){this.func=e,this.context=t,this.count=0}function i(e,t,n){var r=e.func,o=e.context;r.call(o,t,e.count++)}function a(e,t,n){if(null==e)return e;var r=o.getPooled(t,n);g(e,i,r),o.release(r)}function s(e,t,n,r){this.result=e,this.keyPrefix=t,this.func=n,this.context=r,this.count=0}function u(e,t,n){var o=e.result,i=e.keyPrefix,a=e.func,s=e.context,u=a.call(s,t,e.count++);Array.isArray(u)?l(u,o,n,v.thatReturnsArgument):null!=u&&(m.isValidElement(u)&&(u=m.cloneAndReplaceKey(u,i+(!u.key||t&&t.key===u.key?"":r(u.key)+"/")+n)),o.push(u))}function l(e,t,n,o,i){var a="";null!=n&&(a=r(n)+"/");var l=s.getPooled(t,a,o,i);g(e,u,l),s.release(l)}function c(e,t,n){if(null==e)return e;var r=[];return l(e,r,null,t,n),r}function p(e,t,n){return null}function f(e,t){return g(e,p,null)}function d(e){var t=[];return l(e,t,null,v.thatReturnsArgument),t}var h=n(212),m=n(21),v=n(8),g=n(223),y=h.twoArgumentPooler,b=h.fourArgumentPooler,C=/\/+/g;o.prototype.destructor=function(){this.func=null,this.context=null,this.count=0},h.addPoolingTo(o,y),s.prototype.destructor=function(){this.result=null,this.keyPrefix=null,this.func=null,this.context=null,this.count=0},h.addPoolingTo(s,b);var _={forEach:a,map:c,mapIntoWithKeyPrefixInternal:l,count:f,toArray:d};e.exports=_},function(e,t,n){"use strict";function r(e){return e}function o(e,t){var n=C.hasOwnProperty(t)?C[t]:null;w.hasOwnProperty(t)&&("OVERRIDE_BASE"!==n?f("73",t):void 0),e&&("DEFINE_MANY"!==n&&"DEFINE_MANY_MERGED"!==n?f("74",t):void 0)}function i(e,t){if(t){"function"==typeof t?f("75"):void 0,m.isValidElement(t)?f("76"):void 0;var n=e.prototype,r=n.__reactAutoBindPairs;t.hasOwnProperty(y)&&_.mixins(e,t.mixins);for(var i in t)if(t.hasOwnProperty(i)&&i!==y){var a=t[i],s=n.hasOwnProperty(i);if(o(s,i),_.hasOwnProperty(i))_[i](e,a);else{var c=C.hasOwnProperty(i),p="function"==typeof a,d=p&&!c&&!s&&t.autobind!==!1;if(d)r.push(i,a),n[i]=a;else if(s){var h=C[i];!c||"DEFINE_MANY_MERGED"!==h&&"DEFINE_MANY"!==h?f("77",h,i):void 0,"DEFINE_MANY_MERGED"===h?n[i]=u(n[i],a):"DEFINE_MANY"===h&&(n[i]=l(n[i],a))}else n[i]=a}}}else;}function a(e,t){if(t)for(var n in t){var r=t[n];if(t.hasOwnProperty(n)){var o=n in _;o?f("78",n):void 0;var i=n in e;i?f("79",n):void 0,e[n]=r}}}function s(e,t){e&&t&&"object"==typeof e&&"object"==typeof t?void 0:f("80");for(var n in t)t.hasOwnProperty(n)&&(void 0!==e[n]?f("81",n):void 0,e[n]=t[n]);return e}function u(e,t){return function(){var n=e.apply(this,arguments),r=t.apply(this,arguments);if(null==n)return r;if(null==r)return n;var o={};return s(o,n),s(o,r),o}}function l(e,t){return function(){e.apply(this,arguments),t.apply(this,arguments)}}function c(e,t){var n=t.bind(e);return n}function p(e){for(var t=e.__reactAutoBindPairs,n=0;n<t.length;n+=2){var r=t[n],o=t[n+1];e[r]=c(e,o)}}var f=n(22),d=n(4),h=n(54),m=n(21),v=(n(216),n(55)),g=n(23),y=(n(1),n(2),"mixins"),b=[],C={mixins:"DEFINE_MANY",statics:"DEFINE_MANY",propTypes:"DEFINE_MANY",contextTypes:"DEFINE_MANY",childContextTypes:"DEFINE_MANY",getDefaultProps:"DEFINE_MANY_MERGED",getInitialState:"DEFINE_MANY_MERGED",getChildContext:"DEFINE_MANY_MERGED",render:"DEFINE_ONCE",componentWillMount:"DEFINE_MANY",componentDidMount:"DEFINE_MANY",componentWillReceiveProps:"DEFINE_MANY",shouldComponentUpdate:"DEFINE_ONCE",componentWillUpdate:"DEFINE_MANY",componentDidUpdate:"DEFINE_MANY",componentWillUnmount:"DEFINE_MANY",updateComponent:"OVERRIDE_BASE"},_={displayName:function(e,t){e.displayName=t},mixins:function(e,t){if(t)for(var n=0;n<t.length;n++)i(e,t[n])},childContextTypes:function(e,t){e.childContextTypes=d({},e.childContextTypes,t)},contextTypes:function(e,t){e.contextTypes=d({},e.contextTypes,t)},getDefaultProps:function(e,t){e.getDefaultProps?e.getDefaultProps=u(e.getDefaultProps,t):e.getDefaultProps=t},propTypes:function(e,t){e.propTypes=d({},e.propTypes,t)},statics:function(e,t){a(e,t)},autobind:function(){}},w={replaceState:function(e,t){this.updater.enqueueReplaceState(this,e),t&&this.updater.enqueueCallback(this,t,"replaceState")},isMounted:function(){return this.updater.isMounted(this)}},E=function(){};d(E.prototype,h.prototype,w);var T={createClass:function(e){var t=r(function(e,n,r){this.__reactAutoBindPairs.length&&p(this),this.props=e,this.context=n,this.refs=g,this.updater=r||v,this.state=null;var o=this.getInitialState?this.getInitialState():null;"object"!=typeof o||Array.isArray(o)?f("82",t.displayName||"ReactCompositeComponent"):void 0,this.state=o});t.prototype=new E,t.prototype.constructor=t,t.prototype.__reactAutoBindPairs=[],b.forEach(i.bind(null,t)),i(t,e),t.getDefaultProps&&(t.defaultProps=t.getDefaultProps()),t.prototype.render?void 0:f("83");for(var n in C)t.prototype[n]||(t.prototype[n]=null);return t},injection:{injectMixin:function(e){b.push(e)}}};e.exports=T},function(e,t,n){"use strict";var r=n(21),o=r.createFactory,i={a:o("a"),abbr:o("abbr"),address:o("address"),area:o("area"),article:o("article"),aside:o("aside"),audio:o("audio"),b:o("b"),base:o("base"),bdi:o("bdi"),bdo:o("bdo"),big:o("big"),blockquote:o("blockquote"),body:o("body"),br:o("br"),button:o("button"),canvas:o("canvas"),caption:o("caption"),cite:o("cite"),code:o("code"),col:o("col"),colgroup:o("colgroup"),data:o("data"),datalist:o("datalist"),dd:o("dd"),del:o("del"),details:o("details"),dfn:o("dfn"),dialog:o("dialog"),div:o("div"),dl:o("dl"),dt:o("dt"),em:o("em"),embed:o("embed"),fieldset:o("fieldset"),figcaption:o("figcaption"),figure:o("figure"),footer:o("footer"),form:o("form"),h1:o("h1"),h2:o("h2"),h3:o("h3"),h4:o("h4"),h5:o("h5"),h6:o("h6"),head:o("head"),header:o("header"),hgroup:o("hgroup"),hr:o("hr"),html:o("html"),i:o("i"),iframe:o("iframe"),img:o("img"),input:o("input"),ins:o("ins"),kbd:o("kbd"),keygen:o("keygen"),label:o("label"),legend:o("legend"),li:o("li"),link:o("link"),main:o("main"),map:o("map"),mark:o("mark"),menu:o("menu"),menuitem:o("menuitem"),meta:o("meta"),meter:o("meter"),nav:o("nav"),noscript:o("noscript"),object:o("object"),ol:o("ol"),optgroup:o("optgroup"),option:o("option"),output:o("output"),p:o("p"),param:o("param"),picture:o("picture"),pre:o("pre"),progress:o("progress"),q:o("q"),rp:o("rp"),rt:o("rt"),ruby:o("ruby"),s:o("s"),samp:o("samp"),script:o("script"),section:o("section"),select:o("select"),small:o("small"),source:o("source"),span:o("span"),strong:o("strong"),style:o("style"),sub:o("sub"),summary:o("summary"),sup:o("sup"),table:o("table"),tbody:o("tbody"),td:o("td"),textarea:o("textarea"),tfoot:o("tfoot"),th:o("th"),thead:o("thead"),time:o("time"),title:o("title"),tr:o("tr"),track:o("track"),u:o("u"),ul:o("ul"),var:o("var"),video:o("video"),wbr:o("wbr"),circle:o("circle"),clipPath:o("clipPath"),defs:o("defs"),ellipse:o("ellipse"),g:o("g"),image:o("image"),line:o("line"),linearGradient:o("linearGradient"),mask:o("mask"),path:o("path"),pattern:o("pattern"),polygon:o("polygon"),polyline:o("polyline"),radialGradient:o("radialGradient"),rect:o("rect"),stop:o("stop"),svg:o("svg"),text:o("text"),tspan:o("tspan")};e.exports=i},function(e,t,n){"use strict";var r={};e.exports=r},function(e,t,n){"use strict";var r=n(21),o=r.isValidElement,i=n(62);e.exports=i(o)},function(e,t,n){"use strict";function r(e,t,n){this.props=e,this.context=t,this.refs=u,this.updater=n||s}function o(){}var i=n(4),a=n(54),s=n(55),u=n(23);o.prototype=a.prototype,r.prototype=new o,r.prototype.constructor=r,i(r.prototype,a.prototype),r.prototype.isPureReactComponent=!0,e.exports=r},164,183,function(e,t){"use strict";function n(){return r++}var r=1;e.exports=n},function(e,t,n){"use strict";function r(e){return i.isValidElement(e)?void 0:o("143"),e}var o=n(22),i=n(21);n(1);e.exports=r},function(e,t,n){"use strict";function r(e,t){return e&&"object"==typeof e&&null!=e.key?l.escape(e.key):t.toString(36)}function o(e,t,n,i){var f=typeof e;if("undefined"!==f&&"boolean"!==f||(e=null),null===e||"string"===f||"number"===f||"object"===f&&e.$$typeof===s)return n(i,e,""===t?c+r(e,0):t),1;var d,h,m=0,v=""===t?c:t+p;if(Array.isArray(e))for(var g=0;g<e.length;g++)d=e[g],h=v+r(d,g),m+=o(d,h,n,i);else{var y=u(e);if(y){var b,C=y.call(e);if(y!==e.entries)for(var _=0;!(b=C.next()).done;)d=b.value,h=v+r(d,_++),m+=o(d,h,n,i);else for(;!(b=C.next()).done;){var w=b.value;w&&(d=w[1],h=v+l.escape(w[0])+p+r(d,0),m+=o(d,h,n,i))}}else if("object"===f){var E="",T=String(e);a("31","[object Object]"===T?"object with keys {"+Object.keys(e).join(", ")+"}":T,E)}}return m}function i(e,t,n){return null==e?0:o(e,"",t,n)}var a=n(22),s=(n(12),n(88)),u=n(220),l=(n(1),n(211)),c=(n(2),"."),p=":";e.exports=i},function(e,t,n){var r,o,i;!function(n,a){o=[],r=a,i="function"==typeof r?r.apply(t,o):r,!(void 0!==i&&(e.exports=i))}(this,function(){"use strict";function e(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function t(e){var n=e.getBoundingClientRect(),r={};for(var o in n)r[o]=n[o];try{if(e.ownerDocument!==document){var i=e.ownerDocument.defaultView.frameElement;if(i){var a=t(i);r.top+=a.top,r.bottom+=a.top,r.left+=a.left,r.right+=a.left}}}catch(e){}return r}function n(e){var t=getComputedStyle(e)||{},n=t.position,r=[];if("fixed"===n)return[e];for(var o=e;(o=o.parentNode)&&o&&1===o.nodeType;){var i=void 0;try{i=getComputedStyle(o)}catch(e){}if("undefined"==typeof i||null===i)return r.push(o),r;var a=i,s=a.overflow,u=a.overflowX,l=a.overflowY;/(auto|scroll|overlay)/.test(s+l+u)&&("absolute"!==n||["relative","absolute","fixed"].indexOf(i.position)>=0)&&r.push(o)}return r.push(e.ownerDocument.body),e.ownerDocument!==document&&r.push(e.ownerDocument.defaultView),r}function r(){w&&document.body.removeChild(w),w=null}function o(e){var n=void 0;e===document?(n=document,e=document.documentElement):n=e.ownerDocument;var r=n.documentElement,o=t(e),i=x();return o.top-=i.top,o.left-=i.left,"undefined"==typeof o.width&&(o.width=document.body.scrollWidth-o.left-o.right),"undefined"==typeof o.height&&(o.height=document.body.scrollHeight-o.top-o.bottom),o.top=o.top-r.clientTop,
-o.left=o.left-r.clientLeft,o.right=n.body.clientWidth-o.width-o.left,o.bottom=n.body.clientHeight-o.height-o.top,o}function i(e){return e.offsetParent||document.documentElement}function a(){if(O)return O;var e=document.createElement("div");e.style.width="100%",e.style.height="200px";var t=document.createElement("div");s(t.style,{position:"absolute",top:0,left:0,pointerEvents:"none",visibility:"hidden",width:"200px",height:"150px",overflow:"hidden"}),t.appendChild(e),document.body.appendChild(t);var n=e.offsetWidth;t.style.overflow="scroll";var r=e.offsetWidth;n===r&&(r=t.clientWidth),document.body.removeChild(t);var o=n-r;return O={width:o,height:o}}function s(){var e=arguments.length<=0||void 0===arguments[0]?{}:arguments[0],t=[];return Array.prototype.push.apply(t,arguments),t.slice(1).forEach(function(t){if(t)for(var n in t)({}).hasOwnProperty.call(t,n)&&(e[n]=t[n])}),e}function u(e,t){if("undefined"!=typeof e.classList)t.split(" ").forEach(function(t){t.trim()&&e.classList.remove(t)});else{var n=new RegExp("(^| )"+t.split(" ").join("|")+"( |$)","gi"),r=p(e).replace(n," ");f(e,r)}}function l(e,t){if("undefined"!=typeof e.classList)t.split(" ").forEach(function(t){t.trim()&&e.classList.add(t)});else{u(e,t);var n=p(e)+(" "+t);f(e,n)}}function c(e,t){if("undefined"!=typeof e.classList)return e.classList.contains(t);var n=p(e);return new RegExp("(^| )"+t+"( |$)","gi").test(n)}function p(e){return e.className instanceof e.ownerDocument.defaultView.SVGAnimatedString?e.className.baseVal:e.className}function f(e,t){e.setAttribute("class",t)}function d(e,t,n){n.forEach(function(n){t.indexOf(n)===-1&&c(e,n)&&u(e,n)}),t.forEach(function(t){c(e,t)||l(e,t)})}function e(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function h(e,t){if("function"!=typeof t&&null!==t)throw new TypeError("Super expression must either be null or a function, not "+typeof t);e.prototype=Object.create(t&&t.prototype,{constructor:{value:e,enumerable:!1,writable:!0,configurable:!0}}),t&&(Object.setPrototypeOf?Object.setPrototypeOf(e,t):e.__proto__=t)}function m(e,t){var n=arguments.length<=2||void 0===arguments[2]?1:arguments[2];return e+n>=t&&t>=e-n}function v(){return"object"==typeof performance&&"function"==typeof performance.now?performance.now():+new Date}function g(){for(var e={top:0,left:0},t=arguments.length,n=Array(t),r=0;r<t;r++)n[r]=arguments[r];return n.forEach(function(t){var n=t.top,r=t.left;"string"==typeof n&&(n=parseFloat(n,10)),"string"==typeof r&&(r=parseFloat(r,10)),e.top+=n,e.left+=r}),e}function y(e,t){return"string"==typeof e.left&&e.left.indexOf("%")!==-1&&(e.left=parseFloat(e.left,10)/100*t.width),"string"==typeof e.top&&e.top.indexOf("%")!==-1&&(e.top=parseFloat(e.top,10)/100*t.height),e}function b(e,t){return"scrollParent"===t?t=e.scrollParents[0]:"window"===t&&(t=[pageXOffset,pageYOffset,innerWidth+pageXOffset,innerHeight+pageYOffset]),t===document&&(t=t.documentElement),"undefined"!=typeof t.nodeType&&!function(){var e=t,n=o(t),r=n,i=getComputedStyle(t);if(t=[r.left,r.top,n.width+r.left,n.height+r.top],e.ownerDocument!==document){var a=e.ownerDocument.defaultView;t[0]+=a.pageXOffset,t[1]+=a.pageYOffset,t[2]+=a.pageXOffset,t[3]+=a.pageYOffset}K.forEach(function(e,n){e=e[0].toUpperCase()+e.substr(1),"Top"===e||"Left"===e?t[n]+=parseFloat(i["border"+e+"Width"]):t[n]-=parseFloat(i["border"+e+"Width"])})}(),t}var C=function(){function e(e,t){for(var n=0;n<t.length;n++){var r=t[n];r.enumerable=r.enumerable||!1,r.configurable=!0,"value"in r&&(r.writable=!0),Object.defineProperty(e,r.key,r)}}return function(t,n,r){return n&&e(t.prototype,n),r&&e(t,r),t}}(),_=void 0;"undefined"==typeof _&&(_={modules:[]});var w=null,E=function(){var e=0;return function(){return++e}}(),T={},x=function(){var e=w;e&&document.body.contains(e)||(e=document.createElement("div"),e.setAttribute("data-tether-id",E()),s(e.style,{top:0,left:0,position:"absolute"}),document.body.appendChild(e),w=e);var n=e.getAttribute("data-tether-id");return"undefined"==typeof T[n]&&(T[n]=t(e),k(function(){delete T[n]})),T[n]},O=null,P=[],k=function(e){P.push(e)},S=function(){for(var e=void 0;e=P.pop();)e()},N=function(){function t(){e(this,t)}return C(t,[{key:"on",value:function(e,t,n){var r=!(arguments.length<=3||void 0===arguments[3])&&arguments[3];"undefined"==typeof this.bindings&&(this.bindings={}),"undefined"==typeof this.bindings[e]&&(this.bindings[e]=[]),this.bindings[e].push({handler:t,ctx:n,once:r})}},{key:"once",value:function(e,t,n){this.on(e,t,n,!0)}},{key:"off",value:function(e,t){if("undefined"!=typeof this.bindings&&"undefined"!=typeof this.bindings[e])if("undefined"==typeof t)delete this.bindings[e];else for(var n=0;n<this.bindings[e].length;)this.bindings[e][n].handler===t?this.bindings[e].splice(n,1):++n}},{key:"trigger",value:function(e){if("undefined"!=typeof this.bindings&&this.bindings[e]){for(var t=0,n=arguments.length,r=Array(n>1?n-1:0),o=1;o<n;o++)r[o-1]=arguments[o];for(;t<this.bindings[e].length;){var i=this.bindings[e][t],a=i.handler,s=i.ctx,u=i.once,l=s;"undefined"==typeof l&&(l=this),a.apply(l,r),u?this.bindings[e].splice(t,1):++t}}}}]),t}();_.Utils={getActualBoundingClientRect:t,getScrollParents:n,getBounds:o,getOffsetParent:i,extend:s,addClass:l,removeClass:u,hasClass:c,updateClasses:d,defer:k,flush:S,uniqueId:E,Evented:N,getScrollBarSize:a,removeUtilElements:r};var M=function(){function e(e,t){var n=[],r=!0,o=!1,i=void 0;try{for(var a,s=e[Symbol.iterator]();!(r=(a=s.next()).done)&&(n.push(a.value),!t||n.length!==t);r=!0);}catch(e){o=!0,i=e}finally{try{!r&&s.return&&s.return()}finally{if(o)throw i}}return n}return function(t,n){if(Array.isArray(t))return t;if(Symbol.iterator in Object(t))return e(t,n);throw new TypeError("Invalid attempt to destructure non-iterable instance")}}(),C=function(){function e(e,t){for(var n=0;n<t.length;n++){var r=t[n];r.enumerable=r.enumerable||!1,r.configurable=!0,"value"in r&&(r.writable=!0),Object.defineProperty(e,r.key,r)}}return function(t,n,r){return n&&e(t.prototype,n),r&&e(t,r),t}}(),A=function(e,t,n){for(var r=!0;r;){var o=e,i=t,a=n;r=!1,null===o&&(o=Function.prototype);var s=Object.getOwnPropertyDescriptor(o,i);if(void 0!==s){if("value"in s)return s.value;var u=s.get;if(void 0===u)return;return u.call(a)}var l=Object.getPrototypeOf(o);if(null===l)return;e=l,t=i,n=a,r=!0,s=l=void 0}};if("undefined"==typeof _)throw new Error("You must include the utils.js file before tether.js");var I=_.Utils,n=I.getScrollParents,o=I.getBounds,i=I.getOffsetParent,s=I.extend,l=I.addClass,u=I.removeClass,d=I.updateClasses,k=I.defer,S=I.flush,a=I.getScrollBarSize,r=I.removeUtilElements,D=function(){if("undefined"==typeof document)return"";for(var e=document.createElement("div"),t=["transform","WebkitTransform","OTransform","MozTransform","msTransform"],n=0;n<t.length;++n){var r=t[n];if(void 0!==e.style[r])return r}}(),R=[],L=function(){R.forEach(function(e){e.position(!1)}),S()};!function(){var e=null,t=null,n=null,r=function r(){return"undefined"!=typeof t&&t>16?(t=Math.min(t-16,250),void(n=setTimeout(r,250))):void("undefined"!=typeof e&&v()-e<10||(null!=n&&(clearTimeout(n),n=null),e=v(),L(),t=v()-e))};"undefined"!=typeof window&&"undefined"!=typeof window.addEventListener&&["resize","scroll","touchmove"].forEach(function(e){window.addEventListener(e,r)})}();var U={center:"center",left:"right",right:"left"},F={middle:"middle",top:"bottom",bottom:"top"},j={top:0,left:0,middle:"50%",center:"50%",bottom:"100%",right:"100%"},B=function(e,t){var n=e.left,r=e.top;return"auto"===n&&(n=U[t.left]),"auto"===r&&(r=F[t.top]),{left:n,top:r}},V=function(e){var t=e.left,n=e.top;return"undefined"!=typeof j[e.left]&&(t=j[e.left]),"undefined"!=typeof j[e.top]&&(n=j[e.top]),{left:t,top:n}},W=function(e){var t=e.split(" "),n=M(t,2),r=n[0],o=n[1];return{top:r,left:o}},H=W,q=function(t){function c(t){var n=this;e(this,c),A(Object.getPrototypeOf(c.prototype),"constructor",this).call(this),this.position=this.position.bind(this),R.push(this),this.history=[],this.setOptions(t,!1),_.modules.forEach(function(e){"undefined"!=typeof e.initialize&&e.initialize.call(n)}),this.position()}return h(c,t),C(c,[{key:"getClass",value:function(){var e=arguments.length<=0||void 0===arguments[0]?"":arguments[0],t=this.options.classes;return"undefined"!=typeof t&&t[e]?this.options.classes[e]:this.options.classPrefix?this.options.classPrefix+"-"+e:e}},{key:"setOptions",value:function(e){var t=this,r=arguments.length<=1||void 0===arguments[1]||arguments[1],o={offset:"0 0",targetOffset:"0 0",targetAttachment:"auto auto",classPrefix:"tether"};this.options=s(o,e);var i=this.options,a=i.element,u=i.target,c=i.targetModifier;if(this.element=a,this.target=u,this.targetModifier=c,"viewport"===this.target?(this.target=document.body,this.targetModifier="visible"):"scroll-handle"===this.target&&(this.target=document.body,this.targetModifier="scroll-handle"),["element","target"].forEach(function(e){if("undefined"==typeof t[e])throw new Error("Tether Error: Both element and target must be defined");"undefined"!=typeof t[e].jquery?t[e]=t[e][0]:"string"==typeof t[e]&&(t[e]=document.querySelector(t[e]))}),l(this.element,this.getClass("element")),this.options.addTargetClasses!==!1&&l(this.target,this.getClass("target")),!this.options.attachment)throw new Error("Tether Error: You must provide an attachment");this.targetAttachment=H(this.options.targetAttachment),this.attachment=H(this.options.attachment),this.offset=W(this.options.offset),this.targetOffset=W(this.options.targetOffset),"undefined"!=typeof this.scrollParents&&this.disable(),"scroll-handle"===this.targetModifier?this.scrollParents=[this.target]:this.scrollParents=n(this.target),this.options.enabled!==!1&&this.enable(r)}},{key:"getTargetBounds",value:function(){if("undefined"==typeof this.targetModifier)return o(this.target);if("visible"===this.targetModifier){if(this.target===document.body)return{top:pageYOffset,left:pageXOffset,height:innerHeight,width:innerWidth};var e=o(this.target),t={height:e.height,width:e.width,top:e.top,left:e.left};return t.height=Math.min(t.height,e.height-(pageYOffset-e.top)),t.height=Math.min(t.height,e.height-(e.top+e.height-(pageYOffset+innerHeight))),t.height=Math.min(innerHeight,t.height),t.height-=2,t.width=Math.min(t.width,e.width-(pageXOffset-e.left)),t.width=Math.min(t.width,e.width-(e.left+e.width-(pageXOffset+innerWidth))),t.width=Math.min(innerWidth,t.width),t.width-=2,t.top<pageYOffset&&(t.top=pageYOffset),t.left<pageXOffset&&(t.left=pageXOffset),t}if("scroll-handle"===this.targetModifier){var e=void 0,n=this.target;n===document.body?(n=document.documentElement,e={left:pageXOffset,top:pageYOffset,height:innerHeight,width:innerWidth}):e=o(n);var r=getComputedStyle(n),i=n.scrollWidth>n.clientWidth||[r.overflow,r.overflowX].indexOf("scroll")>=0||this.target!==document.body,a=0;i&&(a=15);var s=e.height-parseFloat(r.borderTopWidth)-parseFloat(r.borderBottomWidth)-a,t={width:15,height:.975*s*(s/n.scrollHeight),left:e.left+e.width-parseFloat(r.borderLeftWidth)-15},u=0;s<408&&this.target===document.body&&(u=-11e-5*Math.pow(s,2)-.00727*s+22.58),this.target!==document.body&&(t.height=Math.max(t.height,24));var l=this.target.scrollTop/(n.scrollHeight-s);return t.top=l*(s-t.height-u)+e.top+parseFloat(r.borderTopWidth),this.target===document.body&&(t.height=Math.max(t.height,24)),t}}},{key:"clearCache",value:function(){this._cache={}}},{key:"cache",value:function(e,t){return"undefined"==typeof this._cache&&(this._cache={}),"undefined"==typeof this._cache[e]&&(this._cache[e]=t.call(this)),this._cache[e]}},{key:"enable",value:function(){var e=this,t=arguments.length<=0||void 0===arguments[0]||arguments[0];this.options.addTargetClasses!==!1&&l(this.target,this.getClass("enabled")),l(this.element,this.getClass("enabled")),this.enabled=!0,this.scrollParents.forEach(function(t){t!==e.target.ownerDocument&&t.addEventListener("scroll",e.position)}),t&&this.position()}},{key:"disable",value:function(){var e=this;u(this.target,this.getClass("enabled")),u(this.element,this.getClass("enabled")),this.enabled=!1,"undefined"!=typeof this.scrollParents&&this.scrollParents.forEach(function(t){t.removeEventListener("scroll",e.position)})}},{key:"destroy",value:function(){var e=this;this.disable(),R.forEach(function(t,n){t===e&&R.splice(n,1)}),0===R.length&&r()}},{key:"updateAttachClasses",value:function(e,t){var n=this;e=e||this.attachment,t=t||this.targetAttachment;var r=["left","top","bottom","right","middle","center"];"undefined"!=typeof this._addAttachClasses&&this._addAttachClasses.length&&this._addAttachClasses.splice(0,this._addAttachClasses.length),"undefined"==typeof this._addAttachClasses&&(this._addAttachClasses=[]);var o=this._addAttachClasses;e.top&&o.push(this.getClass("element-attached")+"-"+e.top),e.left&&o.push(this.getClass("element-attached")+"-"+e.left),t.top&&o.push(this.getClass("target-attached")+"-"+t.top),t.left&&o.push(this.getClass("target-attached")+"-"+t.left);var i=[];r.forEach(function(e){i.push(n.getClass("element-attached")+"-"+e),i.push(n.getClass("target-attached")+"-"+e)}),k(function(){"undefined"!=typeof n._addAttachClasses&&(d(n.element,n._addAttachClasses,i),n.options.addTargetClasses!==!1&&d(n.target,n._addAttachClasses,i),delete n._addAttachClasses)})}},{key:"position",value:function(){var e=this,t=arguments.length<=0||void 0===arguments[0]||arguments[0];if(this.enabled){this.clearCache();var n=B(this.targetAttachment,this.attachment);this.updateAttachClasses(this.attachment,n);var r=this.cache("element-bounds",function(){return o(e.element)}),s=r.width,u=r.height;if(0===s&&0===u&&"undefined"!=typeof this.lastSize){var l=this.lastSize;s=l.width,u=l.height}else this.lastSize={width:s,height:u};var c=this.cache("target-bounds",function(){return e.getTargetBounds()}),p=c,f=y(V(this.attachment),{width:s,height:u}),d=y(V(n),p),h=y(this.offset,{width:s,height:u}),m=y(this.targetOffset,p);f=g(f,h),d=g(d,m);for(var v=c.left+d.left-f.left,b=c.top+d.top-f.top,C=0;C<_.modules.length;++C){var w=_.modules[C],E=w.position.call(this,{left:v,top:b,targetAttachment:n,targetPos:c,elementPos:r,offset:f,targetOffset:d,manualOffset:h,manualTargetOffset:m,scrollbarSize:P,attachment:this.attachment});if(E===!1)return!1;"undefined"!=typeof E&&"object"==typeof E&&(b=E.top,v=E.left)}var T={page:{top:b,left:v},viewport:{top:b-pageYOffset,bottom:pageYOffset-b-u+innerHeight,left:v-pageXOffset,right:pageXOffset-v-s+innerWidth}},x=this.target.ownerDocument,O=x.defaultView,P=void 0;return O.innerHeight>x.documentElement.clientHeight&&(P=this.cache("scrollbar-size",a),T.viewport.bottom-=P.height),O.innerWidth>x.documentElement.clientWidth&&(P=this.cache("scrollbar-size",a),T.viewport.right-=P.width),["","static"].indexOf(x.body.style.position)!==-1&&["","static"].indexOf(x.body.parentElement.style.position)!==-1||(T.page.bottom=x.body.scrollHeight-b-u,T.page.right=x.body.scrollWidth-v-s),"undefined"!=typeof this.options.optimizations&&this.options.optimizations.moveElement!==!1&&"undefined"==typeof this.targetModifier&&!function(){var t=e.cache("target-offsetparent",function(){return i(e.target)}),n=e.cache("target-offsetparent-bounds",function(){return o(t)}),r=getComputedStyle(t),a=n,s={};if(["Top","Left","Bottom","Right"].forEach(function(e){s[e.toLowerCase()]=parseFloat(r["border"+e+"Width"])}),n.right=x.body.scrollWidth-n.left-a.width+s.right,n.bottom=x.body.scrollHeight-n.top-a.height+s.bottom,T.page.top>=n.top+s.top&&T.page.bottom>=n.bottom&&T.page.left>=n.left+s.left&&T.page.right>=n.right){var u=t.scrollTop,l=t.scrollLeft;T.offset={top:T.page.top-n.top+u-s.top,left:T.page.left-n.left+l-s.left}}}(),this.move(T),this.history.unshift(T),this.history.length>3&&this.history.pop(),t&&S(),!0}}},{key:"move",value:function(e){var t=this;if("undefined"!=typeof this.element.parentNode){var n={};for(var r in e){n[r]={};for(var o in e[r]){for(var a=!1,u=0;u<this.history.length;++u){var l=this.history[u];if("undefined"!=typeof l[r]&&!m(l[r][o],e[r][o])){a=!0;break}}a||(n[r][o]=!0)}}var c={top:"",left:"",right:"",bottom:""},p=function(e,n){var r="undefined"!=typeof t.options.optimizations,o=r?t.options.optimizations.gpu:null;if(o!==!1){var i=void 0,a=void 0;e.top?(c.top=0,i=n.top):(c.bottom=0,i=-n.bottom),e.left?(c.left=0,a=n.left):(c.right=0,a=-n.right),"number"==typeof window.devicePixelRatio&&devicePixelRatio%1===0&&(a=Math.round(a*devicePixelRatio)/devicePixelRatio,i=Math.round(i*devicePixelRatio)/devicePixelRatio),c[D]="translateX("+a+"px) translateY("+i+"px)","msTransform"!==D&&(c[D]+=" translateZ(0)")}else e.top?c.top=n.top+"px":c.bottom=n.bottom+"px",e.left?c.left=n.left+"px":c.right=n.right+"px"},f=!1;if((n.page.top||n.page.bottom)&&(n.page.left||n.page.right)?(c.position="absolute",p(n.page,e.page)):(n.viewport.top||n.viewport.bottom)&&(n.viewport.left||n.viewport.right)?(c.position="fixed",p(n.viewport,e.viewport)):"undefined"!=typeof n.offset&&n.offset.top&&n.offset.left?!function(){c.position="absolute";var r=t.cache("target-offsetparent",function(){return i(t.target)});i(t.element)!==r&&k(function(){t.element.parentNode.removeChild(t.element),r.appendChild(t.element)}),p(n.offset,e.offset),f=!0}():(c.position="absolute",p({top:!0,left:!0},e.page)),!f)if(this.options.bodyElement)this.element.parentNode!==this.options.bodyElement&&this.options.bodyElement.appendChild(this.element);else{for(var d=function(e){var t=e.ownerDocument,n=t.fullscreenElement||t.webkitFullscreenElement||t.mozFullScreenElement||t.msFullscreenElement;return n===e},h=!0,v=this.element.parentNode;v&&1===v.nodeType&&"BODY"!==v.tagName&&!d(v);){if("static"!==getComputedStyle(v).position){h=!1;break}v=v.parentNode}h||(this.element.parentNode.removeChild(this.element),this.element.ownerDocument.body.appendChild(this.element))}var g={},y=!1;for(var o in c){var b=c[o],C=this.element.style[o];C!==b&&(y=!0,g[o]=b)}y&&k(function(){s(t.element.style,g),t.trigger("repositioned")})}}}]),c}(N);q.modules=[],_.position=L;var z=s(q,_),M=function(){function e(e,t){var n=[],r=!0,o=!1,i=void 0;try{for(var a,s=e[Symbol.iterator]();!(r=(a=s.next()).done)&&(n.push(a.value),!t||n.length!==t);r=!0);}catch(e){o=!0,i=e}finally{try{!r&&s.return&&s.return()}finally{if(o)throw i}}return n}return function(t,n){if(Array.isArray(t))return t;if(Symbol.iterator in Object(t))return e(t,n);throw new TypeError("Invalid attempt to destructure non-iterable instance")}}(),I=_.Utils,o=I.getBounds,s=I.extend,d=I.updateClasses,k=I.defer,K=["left","top","right","bottom"];_.modules.push({position:function(e){var t=this,n=e.top,r=e.left,i=e.targetAttachment;if(!this.options.constraints)return!0;var a=this.cache("element-bounds",function(){return o(t.element)}),u=a.height,l=a.width;if(0===l&&0===u&&"undefined"!=typeof this.lastSize){var c=this.lastSize;l=c.width,u=c.height}var p=this.cache("target-bounds",function(){return t.getTargetBounds()}),f=p.height,h=p.width,m=[this.getClass("pinned"),this.getClass("out-of-bounds")];this.options.constraints.forEach(function(e){var t=e.outOfBoundsClass,n=e.pinnedClass;t&&m.push(t),n&&m.push(n)}),m.forEach(function(e){["left","top","right","bottom"].forEach(function(t){m.push(e+"-"+t)})});var v=[],g=s({},i),y=s({},this.attachment);return this.options.constraints.forEach(function(e){var o=e.to,a=e.attachment,s=e.pin;"undefined"==typeof a&&(a="");var c=void 0,p=void 0;if(a.indexOf(" ")>=0){var d=a.split(" "),m=M(d,2);p=m[0],c=m[1]}else c=p=a;var C=b(t,o);"target"!==p&&"both"!==p||(n<C[1]&&"top"===g.top&&(n+=f,g.top="bottom"),n+u>C[3]&&"bottom"===g.top&&(n-=f,g.top="top")),"together"===p&&("top"===g.top&&("bottom"===y.top&&n<C[1]?(n+=f,g.top="bottom",n+=u,y.top="top"):"top"===y.top&&n+u>C[3]&&n-(u-f)>=C[1]&&(n-=u-f,g.top="bottom",y.top="bottom")),"bottom"===g.top&&("top"===y.top&&n+u>C[3]?(n-=f,g.top="top",n-=u,y.top="bottom"):"bottom"===y.top&&n<C[1]&&n+(2*u-f)<=C[3]&&(n+=u-f,g.top="top",y.top="top")),"middle"===g.top&&(n+u>C[3]&&"top"===y.top?(n-=u,y.top="bottom"):n<C[1]&&"bottom"===y.top&&(n+=u,y.top="top"))),"target"!==c&&"both"!==c||(r<C[0]&&"left"===g.left&&(r+=h,g.left="right"),r+l>C[2]&&"right"===g.left&&(r-=h,g.left="left")),"together"===c&&(r<C[0]&&"left"===g.left?"right"===y.left?(r+=h,g.left="right",r+=l,y.left="left"):"left"===y.left&&(r+=h,g.left="right",r-=l,y.left="right"):r+l>C[2]&&"right"===g.left?"left"===y.left?(r-=h,g.left="left",r-=l,y.left="right"):"right"===y.left&&(r-=h,g.left="left",r+=l,y.left="left"):"center"===g.left&&(r+l>C[2]&&"left"===y.left?(r-=l,y.left="right"):r<C[0]&&"right"===y.left&&(r+=l,y.left="left"))),"element"!==p&&"both"!==p||(n<C[1]&&"bottom"===y.top&&(n+=u,y.top="top"),n+u>C[3]&&"top"===y.top&&(n-=u,y.top="bottom")),"element"!==c&&"both"!==c||(r<C[0]&&("right"===y.left?(r+=l,y.left="left"):"center"===y.left&&(r+=l/2,y.left="left")),r+l>C[2]&&("left"===y.left?(r-=l,y.left="right"):"center"===y.left&&(r-=l/2,y.left="right"))),"string"==typeof s?s=s.split(",").map(function(e){return e.trim()}):s===!0&&(s=["top","left","right","bottom"]),s=s||[];var _=[],w=[];n<C[1]&&(s.indexOf("top")>=0?(n=C[1],_.push("top")):w.push("top")),n+u>C[3]&&(s.indexOf("bottom")>=0?(n=C[3]-u,_.push("bottom")):w.push("bottom")),r<C[0]&&(s.indexOf("left")>=0?(r=C[0],_.push("left")):w.push("left")),r+l>C[2]&&(s.indexOf("right")>=0?(r=C[2]-l,_.push("right")):w.push("right")),_.length&&!function(){var e=void 0;e="undefined"!=typeof t.options.pinnedClass?t.options.pinnedClass:t.getClass("pinned"),v.push(e),_.forEach(function(t){v.push(e+"-"+t)})}(),w.length&&!function(){var e=void 0;e="undefined"!=typeof t.options.outOfBoundsClass?t.options.outOfBoundsClass:t.getClass("out-of-bounds"),v.push(e),w.forEach(function(t){v.push(e+"-"+t)})}(),(_.indexOf("left")>=0||_.indexOf("right")>=0)&&(y.left=g.left=!1),(_.indexOf("top")>=0||_.indexOf("bottom")>=0)&&(y.top=g.top=!1),g.top===i.top&&g.left===i.left&&y.top===t.attachment.top&&y.left===t.attachment.left||(t.updateAttachClasses(y,g),t.trigger("update",{attachment:y,targetAttachment:g}))}),k(function(){t.options.addTargetClasses!==!1&&d(t.target,v,m),d(t.element,v,m)}),{top:n,left:r}}});var I=_.Utils,o=I.getBounds,d=I.updateClasses,k=I.defer;_.modules.push({position:function(e){var t=this,n=e.top,r=e.left,i=this.cache("element-bounds",function(){return o(t.element)}),a=i.height,s=i.width,u=this.getTargetBounds(),l=n+a,c=r+s,p=[];n<=u.bottom&&l>=u.top&&["left","right"].forEach(function(e){var t=u[e];t!==r&&t!==c||p.push(e)}),r<=u.right&&c>=u.left&&["top","bottom"].forEach(function(e){var t=u[e];t!==n&&t!==l||p.push(e)});var f=[],h=[],m=["left","top","right","bottom"];return f.push(this.getClass("abutted")),m.forEach(function(e){f.push(t.getClass("abutted")+"-"+e)}),p.length&&h.push(this.getClass("abutted")),p.forEach(function(e){h.push(t.getClass("abutted")+"-"+e)}),k(function(){t.options.addTargetClasses!==!1&&d(t.target,h,f),d(t.element,h,f)}),!0}});var M=function(){function e(e,t){var n=[],r=!0,o=!1,i=void 0;try{for(var a,s=e[Symbol.iterator]();!(r=(a=s.next()).done)&&(n.push(a.value),!t||n.length!==t);r=!0);}catch(e){o=!0,i=e}finally{try{!r&&s.return&&s.return()}finally{if(o)throw i}}return n}return function(t,n){if(Array.isArray(t))return t;if(Symbol.iterator in Object(t))return e(t,n);throw new TypeError("Invalid attempt to destructure non-iterable instance")}}();return _.modules.push({position:function(e){var t=e.top,n=e.left;if(this.options.shift){var r=this.options.shift;"function"==typeof this.options.shift&&(r=this.options.shift.call(this,{top:t,left:n}));var o=void 0,i=void 0;if("string"==typeof r){r=r.split(" "),r[1]=r[1]||r[0];var a=r,s=M(a,2);o=s[0],i=s[1],o=parseFloat(o,10),i=parseFloat(i,10)}else o=r.top,i=r.left;return t+=o,n+=i,{top:t,left:n}}}}),z})},function(e,t,n){"use strict";var r=function(){};e.exports=r},function(e,t){!function(e){"use strict";function t(e){if("string"!=typeof e&&(e=String(e)),/[^a-z0-9\-#$%&'*+.\^_`|~]/i.test(e))throw new TypeError("Invalid character in header field name");return e.toLowerCase()}function n(e){return"string"!=typeof e&&(e=String(e)),e}function r(e){var t={next:function(){var t=e.shift();return{done:void 0===t,value:t}}};return g.iterable&&(t[Symbol.iterator]=function(){return t}),t}function o(e){this.map={},e instanceof o?e.forEach(function(e,t){this.append(t,e)},this):e&&Object.getOwnPropertyNames(e).forEach(function(t){this.append(t,e[t])},this)}function i(e){return e.bodyUsed?Promise.reject(new TypeError("Already read")):void(e.bodyUsed=!0)}function a(e){return new Promise(function(t,n){e.onload=function(){t(e.result)},e.onerror=function(){n(e.error)}})}function s(e){var t=new FileReader,n=a(t);return t.readAsArrayBuffer(e),n}function u(e){var t=new FileReader,n=a(t);return t.readAsText(e),n}function l(e){for(var t=new Uint8Array(e),n=new Array(t.length),r=0;r<t.length;r++)n[r]=String.fromCharCode(t[r]);return n.join("")}function c(e){if(e.slice)return e.slice(0);var t=new Uint8Array(e.byteLength);return t.set(new Uint8Array(e)),t.buffer}function p(){return this.bodyUsed=!1,this._initBody=function(e){if(this._bodyInit=e,e)if("string"==typeof e)this._bodyText=e;else if(g.blob&&Blob.prototype.isPrototypeOf(e))this._bodyBlob=e;else if(g.formData&&FormData.prototype.isPrototypeOf(e))this._bodyFormData=e;else if(g.searchParams&&URLSearchParams.prototype.isPrototypeOf(e))this._bodyText=e.toString();else if(g.arrayBuffer&&g.blob&&b(e))this._bodyArrayBuffer=c(e.buffer),this._bodyInit=new Blob([this._bodyArrayBuffer]);else{if(!g.arrayBuffer||!ArrayBuffer.prototype.isPrototypeOf(e)&&!C(e))throw new Error("unsupported BodyInit type");this._bodyArrayBuffer=c(e)}else this._bodyText="";this.headers.get("content-type")||("string"==typeof e?this.headers.set("content-type","text/plain;charset=UTF-8"):this._bodyBlob&&this._bodyBlob.type?this.headers.set("content-type",this._bodyBlob.type):g.searchParams&&URLSearchParams.prototype.isPrototypeOf(e)&&this.headers.set("content-type","application/x-www-form-urlencoded;charset=UTF-8"))},g.blob&&(this.blob=function(){var e=i(this);if(e)return e;if(this._bodyBlob)return Promise.resolve(this._bodyBlob);if(this._bodyArrayBuffer)return Promise.resolve(new Blob([this._bodyArrayBuffer]));if(this._bodyFormData)throw new Error("could not read FormData body as blob");return Promise.resolve(new Blob([this._bodyText]))},this.arrayBuffer=function(){return this._bodyArrayBuffer?i(this)||Promise.resolve(this._bodyArrayBuffer):this.blob().then(s)}),this.text=function(){var e=i(this);if(e)return e;if(this._bodyBlob)return u(this._bodyBlob);if(this._bodyArrayBuffer)return Promise.resolve(l(this._bodyArrayBuffer));if(this._bodyFormData)throw new Error("could not read FormData body as text");return Promise.resolve(this._bodyText)},g.formData&&(this.formData=function(){return this.text().then(h)}),this.json=function(){return this.text().then(JSON.parse)},this}function f(e){var t=e.toUpperCase();return _.indexOf(t)>-1?t:e}function d(e,t){t=t||{};var n=t.body;if(e instanceof d){if(e.bodyUsed)throw new TypeError("Already read");this.url=e.url,this.credentials=e.credentials,t.headers||(this.headers=new o(e.headers)),this.method=e.method,this.mode=e.mode,n||null==e._bodyInit||(n=e._bodyInit,e.bodyUsed=!0)}else this.url=String(e);if(this.credentials=t.credentials||this.credentials||"omit",!t.headers&&this.headers||(this.headers=new o(t.headers)),this.method=f(t.method||this.method||"GET"),this.mode=t.mode||this.mode||null,this.referrer=null,("GET"===this.method||"HEAD"===this.method)&&n)throw new TypeError("Body not allowed for GET or HEAD requests");this._initBody(n)}function h(e){var t=new FormData;return e.trim().split("&").forEach(function(e){if(e){var n=e.split("="),r=n.shift().replace(/\+/g," "),o=n.join("=").replace(/\+/g," ");t.append(decodeURIComponent(r),decodeURIComponent(o))}}),t}function m(e){var t=new o;return e.split(/\r?\n/).forEach(function(e){var n=e.split(":"),r=n.shift().trim();if(r){var o=n.join(":").trim();t.append(r,o)}}),t}function v(e,t){t||(t={}),this.type="default",this.status="status"in t?t.status:200,this.ok=this.status>=200&&this.status<300,this.statusText="statusText"in t?t.statusText:"OK",this.headers=new o(t.headers),this.url=t.url||"",this._initBody(e)}if(!e.fetch){var g={searchParams:"URLSearchParams"in e,iterable:"Symbol"in e&&"iterator"in Symbol,blob:"FileReader"in e&&"Blob"in e&&function(){try{return new Blob,!0}catch(e){return!1}}(),formData:"FormData"in e,arrayBuffer:"ArrayBuffer"in e};if(g.arrayBuffer)var y=["[object Int8Array]","[object Uint8Array]","[object Uint8ClampedArray]","[object Int16Array]","[object Uint16Array]","[object Int32Array]","[object Uint32Array]","[object Float32Array]","[object Float64Array]"],b=function(e){return e&&DataView.prototype.isPrototypeOf(e)},C=ArrayBuffer.isView||function(e){return e&&y.indexOf(Object.prototype.toString.call(e))>-1};o.prototype.append=function(e,r){e=t(e),r=n(r);var o=this.map[e];this.map[e]=o?o+","+r:r},o.prototype.delete=function(e){delete this.map[t(e)]},o.prototype.get=function(e){return e=t(e),this.has(e)?this.map[e]:null},o.prototype.has=function(e){return this.map.hasOwnProperty(t(e))},o.prototype.set=function(e,r){this.map[t(e)]=n(r)},o.prototype.forEach=function(e,t){for(var n in this.map)this.map.hasOwnProperty(n)&&e.call(t,this.map[n],n,this)},o.prototype.keys=function(){var e=[];return this.forEach(function(t,n){e.push(n)}),r(e)},o.prototype.values=function(){var e=[];return this.forEach(function(t){e.push(t)}),r(e)},o.prototype.entries=function(){var e=[];return this.forEach(function(t,n){e.push([n,t])}),r(e)},g.iterable&&(o.prototype[Symbol.iterator]=o.prototype.entries);var _=["DELETE","GET","HEAD","OPTIONS","POST","PUT"];d.prototype.clone=function(){return new d(this,{body:this._bodyInit})},p.call(d.prototype),p.call(v.prototype),v.prototype.clone=function(){return new v(this._bodyInit,{status:this.status,statusText:this.statusText,headers:new o(this.headers),url:this.url})},v.error=function(){var e=new v(null,{status:0,statusText:""});return e.type="error",e};var w=[301,302,303,307,308];v.redirect=function(e,t){if(w.indexOf(t)===-1)throw new RangeError("Invalid status code");return new v(null,{status:t,headers:{location:e}})},e.Headers=o,e.Request=d,e.Response=v,e.fetch=function(e,t){return new Promise(function(n,r){var o=new d(e,t),i=new XMLHttpRequest;i.onload=function(){var e={status:i.status,statusText:i.statusText,headers:m(i.getAllResponseHeaders()||"")};e.url="responseURL"in i?i.responseURL:e.headers.get("X-Request-URL");var t="response"in i?i.response:i.responseText;n(new v(t,e))},i.onerror=function(){r(new TypeError("Network request failed"))},i.ontimeout=function(){r(new TypeError("Network request failed"))},i.open(o.method,o.url,!0),"include"===o.credentials&&(i.withCredentials=!0),"responseType"in i&&g.blob&&(i.responseType="blob"),o.headers.forEach(function(e,t){i.setRequestHeader(t,e)}),i.send("undefined"==typeof o._bodyInit?null:o._bodyInit)})},e.fetch.polyfill=!0}}("undefined"!=typeof self?self:this)},function(e,t,n,r,o,i,a,s){function u(e,t){var n,r=function(o){return e.length>1?function(){var i=o?o.concat():[];return n=t?n||this:this,i.push.apply(i,arguments)<e.length&&arguments.length?r.call(n,i):e.apply(n,i)}:e};return r()}var l,c,p,f,d,h,m,v,g,y={}.toString;l=n(r),c=n(o),p=n(i),f=n(a),d=n(s),h=function(e){return e},m=u(function(e,t){return y.call(t).slice(8,-1)===e}),v=u(function(e,t){var n,r=[];for(n=0;n<e;++n)r.push(t);return r}),f.empty=c.empty,f.slice=c.slice,f.take=c.take,f.drop=c.drop,f.splitAt=c.splitAt,f.takeWhile=c.takeWhile,f.dropWhile=c.dropWhile,f.span=c.span,f.breakStr=c.breakList,g={Func:l,List:c,Obj:p,Str:f,Num:d,id:h,isType:m,replicate:v},g.each=c.each,g.map=c.map,g.filter=c.filter,g.compact=c.compact,g.reject=c.reject,g.partition=c.partition,g.find=c.find,g.head=c.head,g.first=c.first,g.tail=c.tail,g.last=c.last,g.initial=c.initial,g.empty=c.empty,g.reverse=c.reverse,g.difference=c.difference,g.intersection=c.intersection,g.union=c.union,g.countBy=c.countBy,g.groupBy=c.groupBy,g.fold=c.fold,g.foldl=c.foldl,
-g.fold1=c.fold1,g.foldl1=c.foldl1,g.foldr=c.foldr,g.foldr1=c.foldr1,g.unfoldr=c.unfoldr,g.andList=c.andList,g.orList=c.orList,g.any=c.any,g.all=c.all,g.unique=c.unique,g.uniqueBy=c.uniqueBy,g.sort=c.sort,g.sortWith=c.sortWith,g.sortBy=c.sortBy,g.sum=c.sum,g.product=c.product,g.mean=c.mean,g.average=c.average,g.concat=c.concat,g.concatMap=c.concatMap,g.flatten=c.flatten,g.maximum=c.maximum,g.minimum=c.minimum,g.maximumBy=c.maximumBy,g.minimumBy=c.minimumBy,g.scan=c.scan,g.scanl=c.scanl,g.scan1=c.scan1,g.scanl1=c.scanl1,g.scanr=c.scanr,g.scanr1=c.scanr1,g.slice=c.slice,g.take=c.take,g.drop=c.drop,g.splitAt=c.splitAt,g.takeWhile=c.takeWhile,g.dropWhile=c.dropWhile,g.span=c.span,g.breakList=c.breakList,g.zip=c.zip,g.zipWith=c.zipWith,g.zipAll=c.zipAll,g.zipAllWith=c.zipAllWith,g.at=c.at,g.elemIndex=c.elemIndex,g.elemIndices=c.elemIndices,g.findIndex=c.findIndex,g.findIndices=c.findIndices,g.apply=l.apply,g.curry=l.curry,g.flip=l.flip,g.fix=l.fix,g.over=l.over,g.split=f.split,g.join=f.join,g.lines=f.lines,g.unlines=f.unlines,g.words=f.words,g.unwords=f.unwords,g.chars=f.chars,g.unchars=f.unchars,g.repeat=f.repeat,g.capitalize=f.capitalize,g.camelize=f.camelize,g.dasherize=f.dasherize,g.values=p.values,g.keys=p.keys,g.pairsToObj=p.pairsToObj,g.objToPairs=p.objToPairs,g.listsToObj=p.listsToObj,g.objToLists=p.objToLists,g.max=d.max,g.min=d.min,g.negate=d.negate,g.abs=d.abs,g.signum=d.signum,g.quot=d.quot,g.rem=d.rem,g.div=d.div,g.mod=d.mod,g.recip=d.recip,g.pi=d.pi,g.tau=d.tau,g.exp=d.exp,g.sqrt=d.sqrt,g.ln=d.ln,g.pow=d.pow,g.sin=d.sin,g.tan=d.tan,g.cos=d.cos,g.acos=d.acos,g.asin=d.asin,g.atan=d.atan,g.atan2=d.atan2,g.truncate=d.truncate,g.round=d.round,g.ceiling=d.ceiling,g.floor=d.floor,g.isItNaN=d.isItNaN,g.even=d.even,g.odd=d.odd,g.gcd=d.gcd,g.lcm=d.lcm,g.VERSION="1.2.1",e.exports=g},function(e,t,n,r){"use strict";var o=n(r),i=(n(1),function(e){var t=this;if(t.instancePool.length){var n=t.instancePool.pop();return t.call(n,e),n}return new t(e)}),a=function(e,t){var n=this;if(n.instancePool.length){var r=n.instancePool.pop();return n.call(r,e,t),r}return new n(e,t)},s=function(e,t,n){var r=this;if(r.instancePool.length){var o=r.instancePool.pop();return r.call(o,e,t,n),o}return new r(e,t,n)},u=function(e,t,n,r){var o=this;if(o.instancePool.length){var i=o.instancePool.pop();return o.call(i,e,t,n,r),i}return new o(e,t,n,r)},l=function(e){var t=this;e instanceof t?void 0:o("25"),e.destructor(),t.instancePool.length<t.poolSize&&t.instancePool.push(e)},c=10,p=i,f=function(e,t){var n=e;return n.instancePool=[],n.getPooled=t||p,n.poolSize||(n.poolSize=c),n.release=l,n},d={addPoolingTo:f,oneArgumentPooler:i,twoArgumentPooler:a,threeArgumentPooler:s,fourArgumentPooler:u};e.exports=d}]));
-//# sourceMappingURL=main.0be833e3.js.map
\ No newline at end of file
+var i=o._instance.rootID;return L[i]=o,o},renderSubtreeIntoContainer:function(e,t,n,r){return null!=e&&w.has(e)?void 0:d("38"),j._renderSubtreeIntoContainer(e,t,n,r)},_renderSubtreeIntoContainer:function(e,t,n,r){x.validateCallback(r,"ReactDOM.render"),v.isValidElement(t)?void 0:d("39","string"==typeof t?" Instead of passing a string like 'div', pass React.createElement('div') or <div />.":"function"==typeof t?" Instead of passing a class like Foo, pass React.createElement(Foo) or <Foo />.":null!=t&&void 0!==t.props?" This may be caused by unintentionally loading two independent copies of React.":"");var a,s=v.createElement(F,{child:t});if(e){var u=w.get(e);a=u._processChildContext(u._context)}else a=P;var c=f(n);if(c){var p=c._currentElement,h=p.props.child;if(N(h,t)){var m=c._renderedComponent.getPublicInstance(),g=r&&function(){r.call(m)};return j._updateRootComponent(c,s,a,n,g),m}j.unmountComponentAtNode(n)}var y=o(n),b=y&&!!i(y),C=l(n),_=b&&!c&&!C,E=j._renderNewRootComponent(s,n,_,a)._renderedComponent.getPublicInstance();return r&&r.call(E),E},render:function(e,t,n){return j._renderSubtreeIntoContainer(null,e,t,n)},unmountComponentAtNode:function(e){c(e)?void 0:d("40");var t=f(e);if(!t){l(e),1===e.nodeType&&e.hasAttribute(A);return!1}return delete L[t._instance.rootID],O.batchedUpdates(u,t,e,!1),!0},_mountImageIntoNode:function(e,t,n,i,a){if(c(t)?void 0:d("41"),i){var s=o(t);if(E.canReuseMarkup(e,s))return void y.precacheNode(n,s);var u=s.getAttribute(E.CHECKSUM_ATTR_NAME);s.removeAttribute(E.CHECKSUM_ATTR_NAME);var l=s.outerHTML;s.setAttribute(E.CHECKSUM_ATTR_NAME,u);var p=e,f=r(p,l),m=" (client) "+p.substring(f-20,f+20)+"\n (server) "+l.substring(f-20,f+20);t.nodeType===D?d("42",m):void 0}if(t.nodeType===D?d("43"):void 0,a.useCreateElement){for(;t.lastChild;)t.removeChild(t.lastChild);h.insertTreeBefore(t,e,null)}else S(t,e),y.precacheNode(n,t.firstChild)}};e.exports=j},function(e,t,n){"use strict";var r=n(3),o=n(20),i=(n(1),{HOST:0,COMPOSITE:1,EMPTY:2,getType:function(e){return null===e||e===!1?i.EMPTY:o.isValidElement(e)?"function"==typeof e.type?i.COMPOSITE:i.HOST:void r("26",e)}});e.exports=i},function(e,t){"use strict";var n={currentScrollLeft:0,currentScrollTop:0,refreshScrollValues:function(e){n.currentScrollLeft=e.x,n.currentScrollTop=e.y}};e.exports=n},function(e,t,n){"use strict";function r(e,t){return null==t?o("30"):void 0,null==e?t:Array.isArray(e)?Array.isArray(t)?(e.push.apply(e,t),e):(e.push(t),e):Array.isArray(t)?[e].concat(t):[e,t]}var o=n(3);n(1);e.exports=r},function(e,t){"use strict";function n(e,t,n){Array.isArray(e)?e.forEach(t,n):e&&t.call(n,e)}e.exports=n},function(e,t,n){"use strict";function r(e){for(var t;(t=e._renderedNodeType)===o.COMPOSITE;)e=e._renderedComponent;return t===o.HOST?e._renderedComponent:t===o.EMPTY?null:void 0}var o=n(74);e.exports=r},function(e,t,n){"use strict";function r(){return!i&&o.canUseDOM&&(i="textContent"in document.documentElement?"textContent":"innerText"),i}var o=n(7),i=null;e.exports=r},function(e,t,n){"use strict";function r(e){if(e){var t=e.getName();if(t)return" Check the render method of `"+t+"`."}return""}function o(e){return"function"==typeof e&&"undefined"!=typeof e.prototype&&"function"==typeof e.prototype.mountComponent&&"function"==typeof e.prototype.receiveComponent}function i(e,t){var n;if(null===e||e===!1)n=l.create(i);else if("object"==typeof e){var s=e,u=s.type;if("function"!=typeof u&&"string"!=typeof u){var f="";f+=r(s._owner),a("130",null==u?u:typeof u,f)}"string"==typeof s.type?n=c.createInternalComponent(s):o(s.type)?(n=new s.type(s),n.getHostNode||(n.getHostNode=n.getNativeNode)):n=new p(s)}else"string"==typeof e||"number"==typeof e?n=c.createInstanceForText(e):a("131",typeof e);return n._mountIndex=0,n._mountImage=null,n}var a=n(3),s=n(4),u=n(137),l=n(69),c=n(71),p=(n(221),n(1),n(2),function(e){this.construct(e)});s(p.prototype,u,{_instantiateReactComponent:i}),e.exports=i},function(e,t){"use strict";function n(e){var t=e&&e.nodeName&&e.nodeName.toLowerCase();return"input"===t?!!r[e.type]:"textarea"===t}var r={color:!0,date:!0,datetime:!0,"datetime-local":!0,email:!0,month:!0,number:!0,password:!0,range:!0,search:!0,tel:!0,text:!0,time:!0,url:!0,week:!0};e.exports=n},function(e,t,n){"use strict";var r=n(7),o=n(32),i=n(33),a=function(e,t){if(t){var n=e.firstChild;if(n&&n===e.lastChild&&3===n.nodeType)return void(n.nodeValue=t)}e.textContent=t};r.canUseDOM&&("textContent"in document.documentElement||(a=function(e,t){return 3===e.nodeType?void(e.nodeValue=t):void i(e,o(t))})),e.exports=a},function(e,t,n){"use strict";function r(e,t){return e&&"object"==typeof e&&null!=e.key?l.escape(e.key):t.toString(36)}function o(e,t,n,i){var f=typeof e;if("undefined"!==f&&"boolean"!==f||(e=null),null===e||"string"===f||"number"===f||"object"===f&&e.$$typeof===s)return n(i,e,""===t?c+r(e,0):t),1;var d,h,m=0,v=""===t?c:t+p;if(Array.isArray(e))for(var g=0;g<e.length;g++)d=e[g],h=v+r(d,g),m+=o(d,h,n,i);else{var y=u(e);if(y){var b,C=y.call(e);if(y!==e.entries)for(var _=0;!(b=C.next()).done;)d=b.value,h=v+r(d,_++),m+=o(d,h,n,i);else for(;!(b=C.next()).done;){var w=b.value;w&&(d=w[1],h=v+l.escape(w[0])+p+r(d,0),m+=o(d,h,n,i))}}else if("object"===f){var E="",T=String(e);a("31","[object Object]"===T?"object with keys {"+Object.keys(e).join(", ")+"}":T,E)}}return m}function i(e,t,n){return null==e?0:o(e,"",t,n)}var a=n(3),s=(n(12),n(152)),u=n(183),l=(n(1),n(41)),c=(n(2),"."),p=":";e.exports=i},function(e,t,n){(function(){var t,r,o,i,a;t=n(5),r=t.createClass,o=t.DOM.div,i=n(16).isEqualToObject,a=n(28).cancelEvent,e.exports=r({getDefaultProps:function(){return{}},render:function(){var e=this;return o({className:"option-wrapper "+(this.props.highlight?"highlight":""),onMouseDown:function(t){var n;return n=function(t){return e.props.onClick(t),window.removeEventListener("mouseup",n)},window.addEventListener("mouseup",n),a(t)},onMouseMove:this.props.onMouseMove,onMouseOut:this.props.onMouseOut,onMouseOver:this.props.onMouseOver},this.props.renderItem(this.props.item))},shouldComponentUpdate:function(e){var t,n,r;return!i(null!=e?e.uid:void 0,null!=(t=this.props)?t.uid:void 0)||(null!=e?e.highlight:void 0)!==(null!=(n=this.props)?n.highlight:void 0)||(null!=e?e.selectable:void 0)!==(null!=(r=this.props)?r.selectable:void 0)}})}).call(this)},function(e,t,n){(function(){var t,r,o,i;t=n(5),r=t.createClass,o=t.DOM.svg,i=n(13).findDOMNode,e.exports=r({render:function(){return o(this.props)},componentDidMount:function(){i(this).setAttribute("focusable",!1)}})}).call(this)},function(e,t,n){"use strict";function r(e){return e&&e.__esModule?e:{default:e}}function o(e){var t="transition"+e+"Timeout",n="transition"+e;return function(e){if(e[n]){if(null==e[t])return new Error(t+" wasn't supplied to CSSTransitionGroup: this can cause unreliable animations and won't be supported in a future version of React. See https://fb.me/react-animation-transition-group-timeout for more information.");if("number"!=typeof e[t])return new Error(t+" must be a number (in milliseconds)")}return null}}t.__esModule=!0,t.nameShape=void 0,t.transitionTimeout=o;var i=n(5),a=(r(i),n(34)),s=r(a);t.nameShape=s.default.oneOfType([s.default.string,s.default.shape({enter:s.default.string,leave:s.default.string,active:s.default.string}),s.default.shape({enter:s.default.string,enterActive:s.default.string,leave:s.default.string,leaveActive:s.default.string,appear:s.default.string,appearActive:s.default.string})])},function(e,t,n){"use strict";function r(e){var t=Function.prototype.toString,n=Object.prototype.hasOwnProperty,r=RegExp("^"+t.call(n).replace(/[\\^$.*+?()[\]{}|]/g,"\\$&").replace(/hasOwnProperty|(function).*?(?=\\\()| for .+?(?=\\\])/g,"$1.*?")+"$");try{var o=t.call(e);return r.test(o)}catch(e){return!1}}function o(e){var t=l(e);if(t){var n=t.childIDs;c(e),n.forEach(o)}}function i(e,t,n){return"\n    in "+(e||"Unknown")+(t?" (at "+t.fileName.replace(/^.*[\\\/]/,"")+":"+t.lineNumber+")":n?" (created by "+n+")":"")}function a(e){return null==e?"#empty":"string"==typeof e||"number"==typeof e?"#text":"string"==typeof e.type?e.type:e.type.displayName||e.type.name||"Unknown"}function s(e){var t,n=x.getDisplayName(e),r=x.getElement(e),o=x.getOwnerID(e);return o&&(t=x.getDisplayName(o)),i(n,r&&r._source,t)}var u,l,c,p,f,d,h,m=n(22),v=n(12),g=(n(1),n(2),"function"==typeof Array.from&&"function"==typeof Map&&r(Map)&&null!=Map.prototype&&"function"==typeof Map.prototype.keys&&r(Map.prototype.keys)&&"function"==typeof Set&&r(Set)&&null!=Set.prototype&&"function"==typeof Set.prototype.keys&&r(Set.prototype.keys));if(g){var y=new Map,b=new Set;u=function(e,t){y.set(e,t)},l=function(e){return y.get(e)},c=function(e){y.delete(e)},p=function(){return Array.from(y.keys())},f=function(e){b.add(e)},d=function(e){b.delete(e)},h=function(){return Array.from(b.keys())}}else{var C={},_={},w=function(e){return"."+e},E=function(e){return parseInt(e.substr(1),10)};u=function(e,t){var n=w(e);C[n]=t},l=function(e){var t=w(e);return C[t]},c=function(e){var t=w(e);delete C[t]},p=function(){return Object.keys(C).map(E)},f=function(e){var t=w(e);_[t]=!0},d=function(e){var t=w(e);delete _[t]},h=function(){return Object.keys(_).map(E)}}var T=[],x={onSetChildren:function(e,t){var n=l(e);n?void 0:m("144"),n.childIDs=t;for(var r=0;r<t.length;r++){var o=t[r],i=l(o);i?void 0:m("140"),null==i.childIDs&&"object"==typeof i.element&&null!=i.element?m("141"):void 0,i.isMounted?void 0:m("71"),null==i.parentID&&(i.parentID=e),i.parentID!==e?m("142",o,i.parentID,e):void 0}},onBeforeMountComponent:function(e,t,n){var r={element:t,parentID:n,text:null,childIDs:[],isMounted:!1,updateCount:0};u(e,r)},onBeforeUpdateComponent:function(e,t){var n=l(e);n&&n.isMounted&&(n.element=t)},onMountComponent:function(e){var t=l(e);t?void 0:m("144"),t.isMounted=!0;var n=0===t.parentID;n&&f(e)},onUpdateComponent:function(e){var t=l(e);t&&t.isMounted&&t.updateCount++},onUnmountComponent:function(e){var t=l(e);if(t){t.isMounted=!1;var n=0===t.parentID;n&&d(e)}T.push(e)},purgeUnmountedComponents:function(){if(!x._preventPurging){for(var e=0;e<T.length;e++){var t=T[e];o(t)}T.length=0}},isMounted:function(e){var t=l(e);return!!t&&t.isMounted},getCurrentStackAddendum:function(e){var t="";if(e){var n=a(e),r=e._owner;t+=i(n,e._source,r&&r.getName())}var o=v.current,s=o&&o._debugID;return t+=x.getStackAddendumByID(s)},getStackAddendumByID:function(e){for(var t="";e;)t+=s(e),e=x.getParentID(e);return t},getChildIDs:function(e){var t=l(e);return t?t.childIDs:[]},getDisplayName:function(e){var t=x.getElement(e);return t?a(t):null},getElement:function(e){var t=l(e);return t?t.element:null},getOwnerID:function(e){var t=x.getElement(e);return t&&t._owner?t._owner._debugID:null},getParentID:function(e){var t=l(e);return t?t.parentID:null},getSource:function(e){var t=l(e),n=t?t.element:null,r=null!=n?n._source:null;return r},getText:function(e){var t=x.getElement(e);return"string"==typeof t?t:"number"==typeof t?""+t:null},getUpdateCount:function(e){var t=l(e);return t?t.updateCount:0},getRootIDs:h,getRegisteredIDs:p};e.exports=x},function(e,t){"use strict";var n="function"==typeof Symbol&&Symbol.for&&Symbol.for("react.element")||60103;e.exports=n},function(e,t,n){"use strict";var r=!1;e.exports=r},function(e,t){(function(t){"use strict";function n(e){s.length||(a(),u=!0),s[s.length]=e}function r(){for(;l<s.length;){var e=l;if(l+=1,s[e].call(),l>c){for(var t=0,n=s.length-l;t<n;t++)s[t]=s[t+l];s.length-=l,l=0}}s.length=0,l=0,u=!1}function o(e){var t=1,n=new f(e),r=document.createTextNode("");return n.observe(r,{characterData:!0}),function(){t=-t,r.data=t}}function i(e){return function(){function t(){clearTimeout(n),clearInterval(r),e()}var n=setTimeout(t,0),r=setInterval(t,50)}}e.exports=n;var a,s=[],u=!1,l=0,c=1024,p="undefined"!=typeof t?t:self,f=p.MutationObserver||p.WebKitMutationObserver;a="function"==typeof f?o(r):i(r),n.requestFlush=a,n.makeRequestCallFromTimer=i}).call(t,function(){return this}())},function(e,t,n){"use strict";function r(e){return e&&e.__esModule?e:{default:e}}function o(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function i(e,t){if(!e)throw new ReferenceError("this hasn't been initialised - super() hasn't been called");return!t||"object"!=typeof t&&"function"!=typeof t?e:t}function a(e,t){if("function"!=typeof t&&null!==t)throw new TypeError("Super expression must either be null or a function, not "+typeof t);e.prototype=Object.create(t&&t.prototype,{constructor:{value:e,enumerable:!1,writable:!0,configurable:!0}}),t&&(Object.setPrototypeOf?Object.setPrototypeOf(e,t):e.__proto__=t)}Object.defineProperty(t,"__esModule",{value:!0});var s=function(){function e(e,t){for(var n=0;n<t.length;n++){var r=t[n];r.enumerable=r.enumerable||!1,r.configurable=!0,"value"in r&&(r.writable=!0),Object.defineProperty(e,r.key,r)}}return function(t,n,r){return n&&e(t.prototype,n),r&&e(t,r),t}}(),u=n(5),l=r(u),c=n(204),p=function(e){function t(e){o(this,t);var n=i(this,(t.__proto__||Object.getPrototypeOf(t)).call(this,e));return n.getCoefficients=function(e){if(e)return e.map(function(e,t){return l.default.createElement("option",{key:t,value:e.value},e.name)})},n.labels=[],n.handleInputChange=n.handleInputChange.bind(n),n.handleValueChange=n.handleValueChange.bind(n),n}return a(t,e),s(t,[{key:"handleInputChange",value:function(e){var t=this.props.condition;t[e.target.name]=e.target.value;var n=this.props.parameters.find(function(t){return t.value===e.target.value});n&&(n.type!==t.type&&(t.operator=""),t.type=n.type),this.props.onChange({index:this.props.index,value:t})}},{key:"handleValueChange",value:function(e){var t=this.props.condition;t.value=e.map(function(e){return e.value}),this.props.onChange({index:this.props.index,value:t})}},{key:"getOperators",value:function(e,t){if(e&&t)return e.filter(function(e){return e.types.indexOf(t.type)>-1}).map(function(e,t){return l.default.createElement("option",{key:t,value:e.name},e.name)})}},{key:"getValues",value:function(e){return e?e.map(function(e){return{label:e,value:e}}):[]}},{key:"render",value:function(){var e=this,t=this.props.parameters.find(function(t){return t.value===e.props.condition.parameter});return this.props.condition.type=t?t.type:null,l.default.createElement("div",{className:this.props.classes.filterLineRow},l.default.createElement("div",{className:this.props.classes.filterLineParameter},l.default.createElement("select",{className:this.props.classes.filterLineInput,name:"parameter",value:this.props.condition.parameter,onChange:this.handleInputChange},l.default.createElement("option",{value:""},"-- Parameter --"),this.getCoefficients(this.props.parameters))),l.default.createElement("div",{className:this.props.classes.filterLineOperator},l.default.createElement("select",{className:this.props.classes.filterLineInput,name:"operator",value:this.props.condition.operator,onChange:this.handleInputChange},l.default.createElement("option",{disabled:!0,value:""},"-- Operator --"),this.getOperators(this.props.operators,this.props.parameters.find(function(t){return t.value===e.props.condition.parameter})))),l.default.createElement("div",{className:this.props.classes.filterLineValue},l.default.createElement(c.MultiSelect,{style:{width:"100%"},placeholder:"-- Value --",theme:"bootstrap3",values:this.getValues(this.props.condition.value),onValuesChange:this.handleValueChange,uid:function(e){return e.value},restoreOnBackspace:function(e){return e.label.toString()},createFromSearch:function(t,n,r){return e.labels=n.map(function(e){return e.label}),0===r.trim().length||e.labels.indexOf(r.trim())!==-1?null:{label:r.trim(),value:r.trim()}},renderNoResultsFound:function(e,t){return l.default.createElement("div",{className:"no-results-found"},function(){return 0===t.trim().length?"Enter a new value":e.map(function(e){return e.label}).indexOf(t.trim())!==-1?"Value already exists":void 0}())}})))}}]),t}(u.Component);t.default=p},function(e,t,n){"use strict";function r(e){return e&&e.__esModule?e:{default:e}}function o(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function i(e,t){if(!e)throw new ReferenceError("this hasn't been initialised - super() hasn't been called");return!t||"object"!=typeof t&&"function"!=typeof t?e:t}function a(e,t){if("function"!=typeof t&&null!==t)throw new TypeError("Super expression must either be null or a function, not "+typeof t);e.prototype=Object.create(t&&t.prototype,{constructor:{value:e,enumerable:!1,writable:!0,configurable:!0}}),t&&(Object.setPrototypeOf?Object.setPrototypeOf(e,t):e.__proto__=t)}Object.defineProperty(t,"__esModule",{value:!0});var s=function(){function e(e,t){for(var n=0;n<t.length;n++){var r=t[n];r.enumerable=r.enumerable||!1,r.configurable=!0,"value"in r&&(r.writable=!0),Object.defineProperty(e,r.key,r)}}return function(t,n,r){return n&&e(t.prototype,n),r&&e(t,r),t}}(),u=n(5),l=r(u),c={paddingTop:10,paddingBottom:10,paddingRight:3,paddingLeft:3},p=function(e){function t(e){o(this,t);var n=i(this,(t.__proto__||Object.getPrototypeOf(t)).call(this,e));return n.removeCondition=n.removeCondition.bind(n),n.addCondition=n.addCondition.bind(n),n}return a(t,e),s(t,[{key:"removeCondition",value:function(){this.props.removeCondition(this.props.index)}},{key:"addCondition",value:function(){this.props.addCondition(this.props.index)}},{key:"render",value:function(){return l.default.createElement("div",{className:this.props.classes.filterLineLabelRow},l.default.createElement("div",{className:this.props.classes.filterLineLabelCondition},l.default.createElement("label",{style:{marginTop:0}},"Condition {",this.props.index+1,"}")),l.default.createElement("div",{className:this.props.classes.filterLineLabelControls},l.default.createElement("a",{style:c,onClick:this.addCondition},l.default.createElement("span",{className:this.props.classes.plusIcon})),l.default.createElement("a",{style:c,onClick:this.removeCondition},l.default.createElement("span",{className:this.props.classes.minusIcon}))))}}]),t}(u.Component);t.default=p},function(e,t,n){"use strict";function r(e){return e&&e.__esModule?e:{default:e}}function o(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function i(e,t){if(!e)throw new ReferenceError("this hasn't been initialised - super() hasn't been called");return!t||"object"!=typeof t&&"function"!=typeof t?e:t}function a(e,t){if("function"!=typeof t&&null!==t)throw new TypeError("Super expression must either be null or a function, not "+typeof t);e.prototype=Object.create(t&&t.prototype,{constructor:{value:e,enumerable:!1,writable:!0,configurable:!0}}),t&&(Object.setPrototypeOf?Object.setPrototypeOf(e,t):e.__proto__=t)}Object.defineProperty(t,"__esModule",{value:!0});var s=function(){function e(e,t){for(var n=0;n<t.length;n++){var r=t[n];r.enumerable=r.enumerable||!1,r.configurable=!0,"value"in r&&(r.writable=!0),Object.defineProperty(e,r.key,r)}}return function(t,n,r){return n&&e(t.prototype,n),r&&e(t,r),t}}(),u=n(5),l=r(u),c=n(91),p=r(c),f=n(92),d=r(f),h=function(e){function t(e){o(this,t);var n=i(this,(t.__proto__||Object.getPrototypeOf(t)).call(this,e));return n.state={conditions:e.config.conditions},n.updateCondition=n.updateCondition.bind(n),n.addCondition=n.addCondition.bind(n),n.removeCondition=n.removeCondition.bind(n),n.componentDidUpdate=n.componentDidUpdate.bind(n),n}return a(t,e),s(t,[{key:"updateCondition",value:function(e){var t=this.state.conditions;t[e.index]=e.value,this.setState({conditions:t})}},{key:"addCondition",value:function(e){var t=this.state.conditions;t.splice(e+1,0,{parameter:"",operator:"",value:""}),this.setState({conditions:t})}},{key:"removeCondition",value:function(e){if(this.state.conditions.length>1){var t=this.state.conditions;t.splice(e,1),this.setState({conditions:t})}}},{key:"componentDidUpdate",value:function(e,t){t!==this.state&&this.props.config.updateConditions(this.state.conditions)}},{key:"render",value:function(){var e=this,t=this.state.conditions.map(function(t,n){return l.default.createElement("div",{key:n},l.default.createElement(d.default,{index:n,classes:e.props.config.classes,addCondition:e.addCondition,removeCondition:e.removeCondition}),l.default.createElement(p.default,{parameters:e.props.config.parameters,operators:e.props.config.operators,condition:t,index:n,classes:e.props.config.classes,onChange:e.updateCondition}))});return l.default.createElement("div",{className:"form-horizontal"},t)}}]),t}(u.Component);t.default=h},function(e,t,n){"use strict";function r(e){return e&&e.__esModule?e:{default:e}}var o=n(5),i=r(o),a=n(13),s=r(a),u=n(93),l=r(u),c=window.$;if(c.fn.filterer=function(e){e.operators=[{name:"contains",types:["string","str"]},{name:"does not contain",types:["string","str"]},{name:"is",types:["string","str","number","int","float"]},{name:"is not",types:["string","str","number","int","float"]},{name:"begins with",types:["string","str"]},{name:"does not begin with",types:["string","str"]},{name:"ends with",types:["string","str"]},{name:"does not end with",types:["string","str"]},{name:"is greater than",types:["number","int","float"]},{name:"is less than",types:["number","int","float"]}],e.classes=Object.assign({plusIcon:"fa fa-fw fa-plus",minusIcon:"fa fa-fw fa-minus",filterLineRow:"form-group",filterLineParameter:"col-sm-4",filterLineOperator:"col-sm-3 condition-operator-col",filterLineValue:"col-sm-5",filterLineInput:"form-control",filterLineLabelRow:"row",filterLineLabelCondition:"col-sm-10",filterLineLabelControls:"col-sm-2 text-right"},e.classes),this.each(function(){s.default.render(i.default.createElement(l.default,{id:"filterer",config:e}),this)})},window.wcomartin_filterer_demo){var p={parameters:[{name:"Title",type:"string",value:"title"},{name:"Year",type:"number",value:"year"}],conditions:[{parameter:"year",operator:"is",value:[2017]}]};p.updateConditions=function(e){console.log(JSON.stringify(e))},c("#root").filterer(p)}},function(e,t){e.exports=function(){for(var e=arguments.length,t=[],n=0;n<e;n++)t[n]=arguments[n];if(t=t.filter(function(e){return null!=e}),0!==t.length)return 1===t.length?t[0]:t.reduce(function(e,t){return function(){e.apply(this,arguments),t.apply(this,arguments)}})}},function(e,t,n){"use strict";function r(e,t){e.classList?e.classList.add(t):(0,i.default)(e,t)||("string"==typeof e.className?e.className=e.className+" "+t:e.setAttribute("class",(e.className&&e.className.baseVal||"")+" "+t))}var o=n(35);t.__esModule=!0,t.default=r;var i=o(n(97));e.exports=t.default},function(e,t){"use strict";function n(e,t){return e.classList?!!t&&e.classList.contains(t):(" "+(e.className.baseVal||e.className)+" ").indexOf(" "+t+" ")!==-1}t.__esModule=!0,t.default=n,e.exports=t.default},function(e,t){"use strict";function n(e,t){return e.replace(new RegExp("(^|\\s)"+t+"(?:\\s|$)","g"),"$1").replace(/\s+/g," ").replace(/^\s*|\s*$/g,"")}e.exports=function(e,t){e.classList?e.classList.remove(t):"string"==typeof e.className?e.className=n(e.className,t):e.setAttribute("class",n(e.className&&e.className.baseVal||"",t))}},function(e,t,n){"use strict";function r(){for(var e,t,n=document.createElement("div").style,r={O:function(e){return"o"+e.toLowerCase()},Moz:function(e){return e.toLowerCase()},Webkit:function(e){return"webkit"+e},ms:function(e){return"MS"+e}},o=Object.keys(r),i="",a=0;a<o.length;a++){var s=o[a];if(s+"TransitionProperty"in n){i="-"+s.toLowerCase(),e=r[s]("TransitionEnd"),t=r[s]("AnimationEnd");break}}return!e&&"transitionProperty"in n&&(e="transitionend"),!t&&"animationName"in n&&(t="animationend"),n=null,{animationEnd:t,transitionEnd:e,prefix:i}}var o=n(35);t.__esModule=!0,t.default=t.animationEnd=t.animationDelay=t.animationTiming=t.animationDuration=t.animationName=t.transitionEnd=t.transitionDuration=t.transitionDelay=t.transitionTiming=t.transitionProperty=t.transform=void 0;var i=o(n(56)),a="transform";t.transform=a;var s,u,l;t.animationEnd=l,t.transitionEnd=u;var c,p,f,d;t.transitionDelay=d,t.transitionTiming=f,t.transitionDuration=p,t.transitionProperty=c;var h,m,v,g;if(t.animationDelay=g,t.animationTiming=v,t.animationDuration=m,t.animationName=h,i.default){var y=r();s=y.prefix,t.transitionEnd=u=y.transitionEnd,t.animationEnd=l=y.animationEnd,t.transform=a=s+"-"+a,t.transitionProperty=c=s+"-transition-property",t.transitionDuration=p=s+"-transition-duration",t.transitionDelay=d=s+"-transition-delay",t.transitionTiming=f=s+"-transition-timing-function",t.animationName=h=s+"-animation-name",t.animationDuration=m=s+"-animation-duration",t.animationTiming=v=s+"-animation-delay",t.animationDelay=g=s+"-animation-timing-function"}var b={transform:a,end:u,property:c,timing:f,delay:d,duration:p};t.default=b},function(e,t,n){"use strict";function r(e){var t=(new Date).getTime(),n=Math.max(0,16-(t-p)),r=setTimeout(e,n);return p=t,r}var o=n(35);t.__esModule=!0,t.default=void 0;var i,a=o(n(56)),s=["","webkit","moz","o","ms"],u="clearTimeout",l=r,c=function(e,t){return e+(e?t[0].toUpperCase()+t.substr(1):t)+"AnimationFrame"};a.default&&s.some(function(e){var t=c(e,"request");if(t in window)return u=c(e,"cancel"),l=function(e){return window[t](e)}});var p=(new Date).getTime();i=function(e){return l(e)},i.cancel=function(e){window[u]&&"function"==typeof window[u]&&window[u](e)};var f=i;t.default=f,e.exports=t.default},function(e,t){"use strict";function n(e){return e.replace(r,function(e,t){return t.toUpperCase()})}var r=/-(.)/g;e.exports=n},function(e,t,n){"use strict";function r(e){return o(e.replace(i,"ms-"))}var o=n(101),i=/^-ms-/;e.exports=r},function(e,t,n){"use strict";function r(e,t){return!(!e||!t)&&(e===t||!o(e)&&(o(t)?r(e,t.parentNode):"contains"in e?e.contains(t):!!e.compareDocumentPosition&&!!(16&e.compareDocumentPosition(t))))}var o=n(111);e.exports=r},function(e,t,n){"use strict";function r(e){var t=e.length;if(Array.isArray(e)||"object"!=typeof e&&"function"!=typeof e?a(!1):void 0,"number"!=typeof t?a(!1):void 0,0===t||t-1 in e?void 0:a(!1),"function"==typeof e.callee?a(!1):void 0,e.hasOwnProperty)try{return Array.prototype.slice.call(e)}catch(e){}for(var n=Array(t),r=0;r<t;r++)n[r]=e[r];return n}function o(e){return!!e&&("object"==typeof e||"function"==typeof e)&&"length"in e&&!("setInterval"in e)&&"number"!=typeof e.nodeType&&(Array.isArray(e)||"callee"in e||"item"in e)}function i(e){return o(e)?Array.isArray(e)?e.slice():r(e):[e]}var a=n(1);e.exports=i},function(e,t,n){"use strict";function r(e){var t=e.match(c);return t&&t[1].toLowerCase()}function o(e,t){var n=l;l?void 0:u(!1);var o=r(e),i=o&&s(o);if(i){n.innerHTML=i[1]+e+i[2];for(var c=i[0];c--;)n=n.lastChild}else n.innerHTML=e;var p=n.getElementsByTagName("script");p.length&&(t?void 0:u(!1),a(p).forEach(t));for(var f=Array.from(n.childNodes);n.lastChild;)n.removeChild(n.lastChild);return f}var i=n(7),a=n(104),s=n(106),u=n(1),l=i.canUseDOM?document.createElement("div"):null,c=/^\s*<(\w+)/;e.exports=o},function(e,t,n){"use strict";function r(e){return a?void 0:i(!1),f.hasOwnProperty(e)||(e="*"),s.hasOwnProperty(e)||("*"===e?a.innerHTML="<link />":a.innerHTML="<"+e+"></"+e+">",s[e]=!a.firstChild),s[e]?f[e]:null}var o=n(7),i=n(1),a=o.canUseDOM?document.createElement("div"):null,s={},u=[1,'<select multiple="true">',"</select>"],l=[1,"<table>","</table>"],c=[3,"<table><tbody><tr>","</tr></tbody></table>"],p=[1,'<svg xmlns="http://www.w3.org/2000/svg">',"</svg>"],f={"*":[1,"?<div>","</div>"],area:[1,"<map>","</map>"],col:[2,"<table><tbody></tbody><colgroup>","</colgroup></table>"],legend:[1,"<fieldset>","</fieldset>"],param:[1,"<object>","</object>"],tr:[2,"<table><tbody>","</tbody></table>"],optgroup:u,option:u,caption:l,colgroup:l,tbody:l,tfoot:l,thead:l,td:c,th:c},d=["circle","clipPath","defs","ellipse","g","image","line","linearGradient","mask","path","pattern","polygon","polyline","radialGradient","rect","stop","text","tspan"];d.forEach(function(e){f[e]=p,s[e]=!0}),e.exports=r},function(e,t){"use strict";function n(e){return e.Window&&e instanceof e.Window?{x:e.pageXOffset||e.document.documentElement.scrollLeft,y:e.pageYOffset||e.document.documentElement.scrollTop}:{x:e.scrollLeft,y:e.scrollTop}}e.exports=n},function(e,t){"use strict";function n(e){return e.replace(r,"-$1").toLowerCase()}var r=/([A-Z])/g;e.exports=n},function(e,t,n){"use strict";function r(e){return o(e).replace(i,"-ms-")}var o=n(108),i=/^ms-/;e.exports=r},function(e,t){"use strict";function n(e){var t=e?e.ownerDocument||e:document,n=t.defaultView||window;return!(!e||!("function"==typeof n.Node?e instanceof n.Node:"object"==typeof e&&"number"==typeof e.nodeType&&"string"==typeof e.nodeName))}e.exports=n},function(e,t,n){"use strict";function r(e){return o(e)&&3==e.nodeType}var o=n(110);e.exports=r},function(e,t){"use strict";function n(e){var t={};return function(n){return t.hasOwnProperty(n)||(t[n]=e.call(this,n)),t[n]}}e.exports=n},function(e,t){function n(e,t){var n,r=function(o){return e.length>1?function(){var i=o?o.concat():[];return n=t?n||this:this,i.push.apply(i,arguments)<e.length&&arguments.length?r.call(n,i):e.apply(n,i)}:e};return r()}var r,o,i,a,s,u,l={}.toString;r=n(function(e,t){return e.apply(null,t)}),o=function(e){return n(e)},i=n(function(e,t,n){return e(n,t)}),a=function(e){return function(t){return function(){return e(t(t)).apply(null,arguments)}}(function(t){return function(){return e(t(t)).apply(null,arguments)}})},s=n(function(e,t,n,r){return e(t(n),t(r))}),u=function(e){var t;return t={},function(){var n,r,o,i,a,s;for(r=[],o=0,i=arguments.length;o<i;++o)r.push(arguments[o]);return n=r,a=function(){var e,t,r,o=[];for(e=0,r=(t=n).length;e<r;++e)s=t[e],o.push(s+l.call(s).slice(8,-1));return o}().join(""),t[a]=a in t?t[a]:e.apply(null,n)}},e.exports={curry:o,flip:i,fix:a,apply:r,over:s,memoize:u}},function(e,t){function n(e,t){var n,r=function(o){return e.length>1?function(){var i=o?o.concat():[];return n=t?n||this:this,i.push.apply(i,arguments)<e.length&&arguments.length?r.call(n,i):e.apply(n,i)}:e};return r()}function r(e,t){for(var n=-1,r=t.length>>>0;++n<r;)if(e===t[n])return!0;return!1}function o(){var e=arguments;return function(){var t,n;for(n=e[0].apply(this,arguments),t=1;t<e.length;++t)n=e[t](n);return n}}function i(e){return!e}var a,s,u,l,c,p,f,d,h,m,v,g,y,b,C,_,w,E,T,x,O,P,k,S,N,M,A,I,D,R,L,U,F,j,B,V,W,H,q,z,K,Y,X,G,Q,$,Z,J,ee,te,ne,re,oe,ie,ae,se,ue,le,ce,pe,fe,de,he,me,ve,ge,ye,be,Ce,_e,we={}.toString;a=n(function(e,t){var n,r,o;for(n=0,r=t.length;n<r;++n)o=t[n],e(o);return t}),s=n(function(e,t){var n,r,o,i=[];for(n=0,r=t.length;n<r;++n)o=t[n],i.push(e(o));return i}),u=function(e){var t,n,r,o=[];for(t=0,n=e.length;t<n;++t)r=e[t],r&&o.push(r);return o},l=n(function(e,t){var n,r,o,i=[];for(n=0,r=t.length;n<r;++n)o=t[n],e(o)&&i.push(o);return i}),c=n(function(e,t){var n,r,o,i=[];for(n=0,r=t.length;n<r;++n)o=t[n],e(o)||i.push(o);return i}),p=n(function(e,t){var n,r;return n=ye(e,t),r=t.slice(),null!=n&&r.splice(n,1),r}),f=n(function(e,t){var n,r,o,i,a;for(n=[],r=[],o=0,i=t.length;o<i;++o)a=t[o],(e(a)?n:r).push(a);return[n,r]}),d=n(function(e,t){var n,r,o;for(n=0,r=t.length;n<r;++n)if(o=t[n],e(o))return o}),h=m=function(e){return e[0]},v=function(e){if(e.length)return e.slice(1)},g=function(e){return e[e.length-1]},y=function(e){if(e.length)return e.slice(0,-1)},b=function(e){return!e.length},C=function(e){return e.concat().reverse()},_=function(e){var t,n,o,i;for(t=[],n=0,o=e.length;n<o;++n)i=e[n],r(i,t)||t.push(i);return t},w=n(function(e,t){var n,o,i,a,s,u=[];for(n=[],o=0,i=t.length;o<i;++o)a=t[o],s=e(a),r(s,n)||(n.push(s),u.push(a));return u}),E=T=n(function(e,t,n){var r,o,i;for(r=0,o=n.length;r<o;++r)i=n[r],t=e(t,i);return t}),x=O=n(function(e,t){return E(e,t[0],t.slice(1))}),P=n(function(e,t,n){var r,o;for(r=n.length-1;r>=0;--r)o=n[r],t=e(o,t);return t}),k=n(function(e,t){return P(e,t[t.length-1],t.slice(0,-1))}),S=n(function(e,t){var n,r,o;for(n=[],r=t;null!=(o=e(r));)n.push(o[0]),r=o[1];return n}),N=function(e){return[].concat.apply([],e)},M=n(function(e,t){var n;return[].concat.apply([],function(){
+var r,o,i,a=[];for(r=0,i=(o=t).length;r<i;++r)n=o[r],a.push(e(n));return a}())}),A=function(e){var t;return[].concat.apply([],function(){var n,r,o,i=[];for(n=0,o=(r=e).length;n<o;++n)t=r[n],"Array"===we.call(t).slice(8,-1)?i.push(A(t)):i.push(t);return i}())},I=function(e){var t,n,o,i,a,s,u,l,c,p;for(n=[],o=1,i=arguments.length;o<i;++o)n.push(arguments[o]);t=n,a=[];e:for(o=0,s=e.length;o<s;++o){for(u=e[o],l=0,c=t.length;l<c;++l)if(p=t[l],r(u,p))continue e;a.push(u)}return a},D=function(e){var t,n,o,i,a,s,u,l,c,p;for(n=[],o=1,i=arguments.length;o<i;++o)n.push(arguments[o]);t=n,a=[];e:for(o=0,s=e.length;o<s;++o){for(u=e[o],l=0,c=t.length;l<c;++l)if(p=t[l],!r(u,p))continue e;a.push(u)}return a},R=function(){var e,t,n,o,i,a,s,u,l,c;for(t=[],n=0,o=arguments.length;n<o;++n)t.push(arguments[n]);for(e=t,i=[],n=0,a=e.length;n<a;++n)for(s=e[n],u=0,l=s.length;u<l;++u)c=s[u],r(c,i)||i.push(c);return i},L=n(function(e,t){var n,r,o,i,a;for(n={},r=0,o=t.length;r<o;++r)i=t[r],a=e(i),a in n?n[a]+=1:n[a]=1;return n}),U=n(function(e,t){var n,r,o,i,a;for(n={},r=0,o=t.length;r<o;++r)i=t[r],a=e(i),a in n?n[a].push(i):n[a]=[i];return n}),F=function(e){var t,n,r;for(t=0,n=e.length;t<n;++t)if(r=e[t],!r)return!1;return!0},j=function(e){var t,n,r;for(t=0,n=e.length;t<n;++t)if(r=e[t])return!0;return!1},B=n(function(e,t){var n,r,o;for(n=0,r=t.length;n<r;++n)if(o=t[n],e(o))return!0;return!1}),V=n(function(e,t){var n,r,o;for(n=0,r=t.length;n<r;++n)if(o=t[n],!e(o))return!1;return!0}),W=function(e){return e.concat().sort(function(e,t){return e>t?1:e<t?-1:0})},H=n(function(e,t){return t.concat().sort(e)}),q=n(function(e,t){return t.concat().sort(function(t,n){return e(t)>e(n)?1:e(t)<e(n)?-1:0})}),z=function(e){var t,n,r,o;for(t=0,n=0,r=e.length;n<r;++n)o=e[n],t+=o;return t},K=function(e){var t,n,r,o;for(t=1,n=0,r=e.length;n<r;++n)o=e[n],t*=o;return t},Y=X=function(e){var t,n,r,o;for(t=0,n=0,r=e.length;n<r;++n)o=e[n],t+=o;return t/e.length},G=function(e){var t,n,r,o,i;for(t=e[0],n=0,o=(r=e.slice(1)).length;n<o;++n)i=r[n],i>t&&(t=i);return t},Q=function(e){var t,n,r,o,i;for(t=e[0],n=0,o=(r=e.slice(1)).length;n<o;++n)i=r[n],i<t&&(t=i);return t},$=n(function(e,t){var n,r,o,i,a;for(n=t[0],r=0,i=(o=t.slice(1)).length;r<i;++r)a=o[r],e(a)>e(n)&&(n=a);return n}),Z=n(function(e,t){var n,r,o,i,a;for(n=t[0],r=0,i=(o=t.slice(1)).length;r<i;++r)a=o[r],e(a)<e(n)&&(n=a);return n}),J=ee=n(function(e,t,n){var r,o;return r=t,[t].concat(function(){var t,i,a,s=[];for(t=0,a=(i=n).length;t<a;++t)o=i[t],s.push(r=e(r,o));return s}())}),te=ne=n(function(e,t){if(t.length)return J(e,t[0],t.slice(1))}),re=n(function(e,t,n){return n=n.concat().reverse(),J(e,t,n).reverse()}),oe=n(function(e,t){if(t.length)return t=t.concat().reverse(),J(e,t[0],t.slice(1)).reverse()}),ie=n(function(e,t,n){return n.slice(e,t)}),ae=n(function(e,t){return e<=0?t.slice(0,0):t.slice(0,e)}),se=n(function(e,t){return e<=0?t:t.slice(e)}),ue=n(function(e,t){return[ae(e,t),se(e,t)]}),le=n(function(e,t){var n,r;if(n=t.length,!n)return t;for(r=0;r<n&&e(t[r]);)r+=1;return t.slice(0,r)}),ce=n(function(e,t){var n,r;if(n=t.length,!n)return t;for(r=0;r<n&&e(t[r]);)r+=1;return t.slice(r)}),pe=n(function(e,t){return[le(e,t),ce(e,t)]}),fe=n(function(e,t){return pe(o(e,i),t)}),de=n(function(e,t){var n,r,o,i,a,s;for(n=[],r=t.length,o=0,i=e.length;o<i&&(a=o,s=e[o],a!==r);++o)n.push([s,t[a]]);return n}),he=n(function(e,t,n){var r,o,i,a,s,u;for(r=[],o=n.length,i=0,a=t.length;i<a&&(s=i,u=t[i],s!==o);++i)r.push(e(u,n[s]));return r}),me=function(){var e,t,n,r,o,i,a,s,u,l,c,p=[];for(t=[],n=0,r=arguments.length;n<r;++n)t.push(arguments[n]);for(e=t,o=void 0,n=0,i=e.length;n<i;++n)a=e[n],o<=(s=a.length)||(o=s);for(n=0;n<o;++n){for(u=n,l=[],c=0,i=e.length;c<i;++c)a=e[c],l.push(a[u]);p.push(l)}return p},ve=function(e){function t(){var e,t,r,o=[];for(e=0,r=(t=n).length;e<r;++e)u=t[e],o.push(u[c]);return o}var n,r,o,i,a,s,u,l,c,p=[];for(r=[],o=1,i=arguments.length;o<i;++o)r.push(arguments[o]);for(n=r,a=void 0,o=0,s=n.length;o<s;++o)u=n[o],a<=(l=u.length)||(a=l);for(o=0;o<a;++o)c=o,p.push(e.apply(null,t()));return p},ge=n(function(e,t){return e<0?t[t.length+e]:t[e]}),ye=n(function(e,t){var n,r,o,i;for(n=0,r=t.length;n<r;++n)if(o=n,i=t[n],i===e)return o}),be=n(function(e,t){var n,r,o,i,a=[];for(n=0,r=t.length;n<r;++n)o=n,i=t[n],i===e&&a.push(o);return a}),Ce=n(function(e,t){var n,r,o,i;for(n=0,r=t.length;n<r;++n)if(o=n,i=t[n],e(i))return o}),_e=n(function(e,t){var n,r,o,i,a=[];for(n=0,r=t.length;n<r;++n)o=n,i=t[n],e(i)&&a.push(o);return a}),e.exports={each:a,map:s,filter:l,compact:u,reject:c,remove:p,partition:f,find:d,head:h,first:m,tail:v,last:g,initial:y,empty:b,reverse:C,difference:I,intersection:D,union:R,countBy:L,groupBy:U,fold:E,fold1:x,foldl:T,foldl1:O,foldr:P,foldr1:k,unfoldr:S,andList:F,orList:j,any:B,all:V,unique:_,uniqueBy:w,sort:W,sortWith:H,sortBy:q,sum:z,product:K,mean:Y,average:X,concat:N,concatMap:M,flatten:A,maximum:G,minimum:Q,maximumBy:$,minimumBy:Z,scan:J,scan1:te,scanl:ee,scanl1:ne,scanr:re,scanr1:oe,slice:ie,take:ae,drop:se,splitAt:ue,takeWhile:le,dropWhile:ce,span:pe,breakList:fe,zip:de,zipWith:he,zipAll:me,zipAllWith:ve,at:ge,elemIndex:ye,elemIndices:be,findIndex:Ce,findIndices:_e}},function(e,t){function n(e,t){var n,r=function(o){return e.length>1?function(){var i=o?o.concat():[];return n=t?n||this:this,i.push.apply(i,arguments)<e.length&&arguments.length?r.call(n,i):e.apply(n,i)}:e};return r()}var r,o,i,a,s,u,l,c,p,f,d,h,m,v,g,y,b,C,_,w,E,T,x,O,P,k,S,N,M,A,I,D;r=n(function(e,t){return e>t?e:t}),o=n(function(e,t){return e<t?e:t}),i=function(e){return-e},a=Math.abs,s=function(e){return e<0?-1:e>0?1:0},u=n(function(e,t){return~~(e/t)}),l=n(function(e,t){return e%t}),c=n(function(e,t){return Math.floor(e/t)}),p=n(function(e,t){var n;return(e%(n=t)+n)%n}),f=function(e){return 1/e},d=Math.PI,h=2*d,m=Math.exp,v=Math.sqrt,g=Math.log,y=n(function(e,t){return Math.pow(e,t)}),b=Math.sin,C=Math.tan,_=Math.cos,w=Math.asin,E=Math.acos,T=Math.atan,x=n(function(e,t){return Math.atan2(e,t)}),O=function(e){return~~e},P=Math.round,k=Math.ceil,S=Math.floor,N=function(e){return e!==e},M=function(e){return e%2===0},A=function(e){return e%2!==0},I=n(function(e,t){var n;for(e=Math.abs(e),t=Math.abs(t);0!==t;)n=e%t,e=t,t=n;return e}),D=n(function(e,t){return Math.abs(Math.floor(e/I(e,t)*t))}),e.exports={max:r,min:o,negate:i,abs:a,signum:s,quot:u,rem:l,div:c,mod:p,recip:f,pi:d,tau:h,exp:m,sqrt:v,ln:g,pow:y,sin:b,tan:C,cos:_,acos:E,asin:w,atan:T,atan2:x,truncate:O,round:P,ceiling:k,floor:S,isItNaN:N,even:M,odd:A,gcd:I,lcm:D}},function(e,t){function n(e,t){var n,r=function(o){return e.length>1?function(){var i=o?o.concat():[];return n=t?n||this:this,i.push.apply(i,arguments)<e.length&&arguments.length?r.call(n,i):e.apply(n,i)}:e};return r()}var r,o,i,a,s,u,l,c,p,f,d,h,m,v;r=function(e){var t,n,r=[];for(t in e)n=e[t],r.push(n);return r},o=function(e){var t,n=[];for(t in e)n.push(t);return n},i=function(e){var t,n,r,o={};for(t=0,n=e.length;t<n;++t)r=e[t],o[r[0]]=r[1];return o},a=function(e){var t,n,r=[];for(t in e)n=e[t],r.push([t,n]);return r},s=n(function(e,t){var n,r,o,i,a={};for(n=0,r=e.length;n<r;++n)o=n,i=e[n],a[i]=t[o];return a}),u=function(e){var t,n,r,o;t=[],n=[];for(r in e)o=e[r],t.push(r),n.push(o);return[t,n]},l=function(e){var t;for(t in e)return!1;return!0},c=n(function(e,t){var n,r;for(n in t)r=t[n],e(r);return t}),p=n(function(e,t){var n,r,o={};for(n in t)r=t[n],o[n]=e(r);return o}),f=function(e){var t,n,r={};for(t in e)n=e[t],n&&(r[t]=n);return r},d=n(function(e,t){var n,r,o={};for(n in t)r=t[n],e(r)&&(o[n]=r);return o}),h=n(function(e,t){var n,r,o={};for(n in t)r=t[n],e(r)||(o[n]=r);return o}),m=n(function(e,t){var n,r,o,i;n={},r={};for(o in t)i=t[o],(e(i)?n:r)[o]=i;return[n,r]}),v=n(function(e,t){var n,r;for(n in t)if(r=t[n],e(r))return r}),e.exports={values:r,keys:o,pairsToObj:i,objToPairs:a,listsToObj:s,objToLists:u,empty:l,each:c,map:p,filter:d,compact:f,reject:h,partition:m,find:v}},function(e,t){function n(e,t){var n,r=function(o){return e.length>1?function(){var i=o?o.concat():[];return n=t?n||this:this,i.push.apply(i,arguments)<e.length&&arguments.length?r.call(n,i):e.apply(n,i)}:e};return r()}var r,o,i,a,s,u,l,c,p,f,d,h,m;r=n(function(e,t){return t.split(e)}),o=n(function(e,t){return t.join(e)}),i=function(e){return e.length?e.split("\n"):[]},a=function(e){return e.join("\n")},s=function(e){return e.length?e.split(/[ ]+/):[]},u=function(e){return e.join(" ")},l=function(e){return e.split("")},c=function(e){return e.join("")},p=function(e){return e.split("").reverse().join("")},f=n(function(e,t){var n,r;for(n="",r=0;r<e;++r)n+=t;return n}),d=function(e){return e.charAt(0).toUpperCase()+e.slice(1)},h=function(e){return e.replace(/[-_]+(.)?/g,function(e,t){return(null!=t?t:"").toUpperCase()})},m=function(e){return e.replace(/([^-A-Z])([A-Z]+)/g,function(e,t,n){return t+"-"+(n.length>1?n:n.toLowerCase())}).replace(/^([A-Z]+)/,function(e,t){return t.length>1?t+"-":t.toLowerCase()})},e.exports={split:r,join:o,lines:i,unlines:a,words:s,unwords:u,chars:l,unchars:c,reverse:p,repeat:f,capitalize:d,camelize:h,dasherize:m}},[227,113,114,116,117,115],function(e,t,n){"use strict";function r(e){var t=new o(o._61);return t._81=1,t._65=e,t}var o=n(61);e.exports=o;var i=r(!0),a=r(!1),s=r(null),u=r(void 0),l=r(0),c=r("");o.resolve=function(e){if(e instanceof o)return e;if(null===e)return s;if(void 0===e)return u;if(e===!0)return i;if(e===!1)return a;if(0===e)return l;if(""===e)return c;if("object"==typeof e||"function"==typeof e)try{var t=e.then;if("function"==typeof t)return new o(t.bind(e))}catch(e){return new o(function(t,n){n(e)})}return r(e)},o.all=function(e){var t=Array.prototype.slice.call(e);return new o(function(e,n){function r(a,s){if(s&&("object"==typeof s||"function"==typeof s)){if(s instanceof o&&s.then===o.prototype.then){for(;3===s._81;)s=s._65;return 1===s._81?r(a,s._65):(2===s._81&&n(s._65),void s.then(function(e){r(a,e)},n))}var u=s.then;if("function"==typeof u){var l=new o(u.bind(s));return void l.then(function(e){r(a,e)},n)}}t[a]=s,0===--i&&e(t)}if(0===t.length)return e([]);for(var i=t.length,a=0;a<t.length;a++)r(a,t[a])})},o.reject=function(e){return new o(function(t,n){n(e)})},o.race=function(e){return new o(function(t,n){e.forEach(function(e){o.resolve(e).then(t,n)})})},o.prototype.catch=function(e){return this.then(null,e)}},function(e,t,n){"use strict";function r(){l=!1,s._10=null,s._97=null}function o(e){function t(t){(e.allRejections||a(p[t].error,e.whitelist||u))&&(p[t].displayId=c++,e.onUnhandled?(p[t].logged=!0,e.onUnhandled(p[t].displayId,p[t].error)):(p[t].logged=!0,i(p[t].displayId,p[t].error)))}function n(t){p[t].logged&&(e.onHandled?e.onHandled(p[t].displayId,p[t].error):p[t].onUnhandled||(console.warn("Promise Rejection Handled (id: "+p[t].displayId+"):"),console.warn('  This means you can ignore any previous messages of the form "Possible Unhandled Promise Rejection" with id '+p[t].displayId+".")))}e=e||{},l&&r(),l=!0;var o=0,c=0,p={};s._10=function(e){2===e._81&&p[e._72]&&(p[e._72].logged?n(e._72):clearTimeout(p[e._72].timeout),delete p[e._72])},s._97=function(e,n){0===e._45&&(e._72=o++,p[e._72]={displayId:null,error:n,timeout:setTimeout(t.bind(null,e._72),a(n,u)?100:2e3),logged:!1})}}function i(e,t){console.warn("Possible Unhandled Promise Rejection (id: "+e+"):");var n=(t&&(t.stack||t))+"";n.split("\n").forEach(function(e){console.warn("  "+e)})}function a(e,t){return t.some(function(t){return e instanceof t})}var s=n(61),u=[ReferenceError,TypeError,RangeError],l=!1;t.disable=r,t.enable=o},function(e,t,n){"use strict";function r(e,t,n,r,o){}e.exports=r},function(e,t,n){"use strict";var r=n(8),o=n(1),i=(n(2),n(123)),a=n(121);e.exports=function(e,t){function n(e){var t=e&&(x&&e[x]||e[O]);if("function"==typeof t)return t}function s(e,t){return e===t?0!==e||1/e===1/t:e!==e&&t!==t}function u(e){this.message=e,this.stack=""}function l(e){function n(n,r,a,s,l,c,p){if(s=s||P,c=c||a,p!==i)if(t)o(!1,"Calling PropTypes validators directly is not supported by the `prop-types` package. Use `PropTypes.checkPropTypes()` to call them. Read more at http://fb.me/use-check-prop-types");else;return null==r[a]?n?new u(null===r[a]?"The "+l+" `"+c+"` is marked as required "+("in `"+s+"`, but its value is `null`."):"The "+l+" `"+c+"` is marked as required in "+("`"+s+"`, but its value is `undefined`.")):null:e(r,a,s,l,c)}var r=n.bind(null,!1);return r.isRequired=n.bind(null,!0),r}function c(e){function t(t,n,r,o,i,a){var s=t[n],l=w(s);if(l!==e){var c=E(s);return new u("Invalid "+o+" `"+i+"` of type "+("`"+c+"` supplied to `"+r+"`, expected ")+("`"+e+"`."))}return null}return l(t)}function p(){return l(r.thatReturnsNull)}function f(e){function t(t,n,r,o,a){if("function"!=typeof e)return new u("Property `"+a+"` of component `"+r+"` has invalid PropType notation inside arrayOf.");var s=t[n];if(!Array.isArray(s)){var l=w(s);return new u("Invalid "+o+" `"+a+"` of type "+("`"+l+"` supplied to `"+r+"`, expected an array."))}for(var c=0;c<s.length;c++){var p=e(s,c,r,o,a+"["+c+"]",i);if(p instanceof Error)return p}return null}return l(t)}function d(){function t(t,n,r,o,i){var a=t[n];if(!e(a)){var s=w(a);return new u("Invalid "+o+" `"+i+"` of type "+("`"+s+"` supplied to `"+r+"`, expected a single ReactElement."))}return null}return l(t)}function h(e){function t(t,n,r,o,i){if(!(t[n]instanceof e)){var a=e.name||P,s=T(t[n]);return new u("Invalid "+o+" `"+i+"` of type "+("`"+s+"` supplied to `"+r+"`, expected ")+("instance of `"+a+"`."))}return null}return l(t)}function m(e){function t(t,n,r,o,i){for(var a=t[n],l=0;l<e.length;l++)if(s(a,e[l]))return null;var c=JSON.stringify(e);return new u("Invalid "+o+" `"+i+"` of value `"+a+"` "+("supplied to `"+r+"`, expected one of "+c+"."))}return Array.isArray(e)?l(t):r.thatReturnsNull}function v(e){function t(t,n,r,o,a){if("function"!=typeof e)return new u("Property `"+a+"` of component `"+r+"` has invalid PropType notation inside objectOf.");var s=t[n],l=w(s);if("object"!==l)return new u("Invalid "+o+" `"+a+"` of type "+("`"+l+"` supplied to `"+r+"`, expected an object."));for(var c in s)if(s.hasOwnProperty(c)){var p=e(s,c,r,o,a+"."+c,i);if(p instanceof Error)return p}return null}return l(t)}function g(e){function t(t,n,r,o,a){for(var s=0;s<e.length;s++){var l=e[s];if(null==l(t,n,r,o,a,i))return null}return new u("Invalid "+o+" `"+a+"` supplied to "+("`"+r+"`."))}return Array.isArray(e)?l(t):r.thatReturnsNull}function y(){function e(e,t,n,r,o){return C(e[t])?null:new u("Invalid "+r+" `"+o+"` supplied to "+("`"+n+"`, expected a ReactNode."))}return l(e)}function b(e){function t(t,n,r,o,a){var s=t[n],l=w(s);if("object"!==l)return new u("Invalid "+o+" `"+a+"` of type `"+l+"` "+("supplied to `"+r+"`, expected `object`."));for(var c in e){var p=e[c];if(p){var f=p(s,c,r,o,a+"."+c,i);if(f)return f}}return null}return l(t)}function C(t){switch(typeof t){case"number":case"string":case"undefined":return!0;case"boolean":return!t;case"object":if(Array.isArray(t))return t.every(C);if(null===t||e(t))return!0;var r=n(t);if(!r)return!1;var o,i=r.call(t);if(r!==t.entries){for(;!(o=i.next()).done;)if(!C(o.value))return!1}else for(;!(o=i.next()).done;){var a=o.value;if(a&&!C(a[1]))return!1}return!0;default:return!1}}function _(e,t){return"symbol"===e||("Symbol"===t["@@toStringTag"]||"function"==typeof Symbol&&t instanceof Symbol)}function w(e){var t=typeof e;return Array.isArray(e)?"array":e instanceof RegExp?"object":_(t,e)?"symbol":t}function E(e){var t=w(e);if("object"===t){if(e instanceof Date)return"date";if(e instanceof RegExp)return"regexp"}return t}function T(e){return e.constructor&&e.constructor.name?e.constructor.name:P}var x="function"==typeof Symbol&&Symbol.iterator,O="@@iterator",P="<<anonymous>>",k={array:c("array"),bool:c("boolean"),func:c("function"),number:c("number"),object:c("object"),string:c("string"),symbol:c("symbol"),any:p(),arrayOf:f,element:d(),instanceOf:h,node:y(),objectOf:v,oneOf:m,oneOfType:g,shape:b};return u.prototype=Error.prototype,k.checkPropTypes=a,k.PropTypes=k,k}},function(e,t){"use strict";var n="SECRET_DO_NOT_PASS_THIS_OR_YOU_WILL_BE_FIRED";e.exports=n},function(e,t){"use strict";function n(e,t){return e===t?0!==e||0!==t||1/e===1/t:e!==e&&t!==t}function r(e,t){if(n(e,t))return!0;if("object"!=typeof e||null===e||"object"!=typeof t||null===t)return!1;var r=Object.keys(e),o=Object.keys(t);if(r.length!==o.length)return!1;for(var a=0;a<r.length;a++)if(!i.call(t,r[a])||!n(e[r[a]],t[r[a]]))return!1;return!0}function o(e,t,n){return!r(e.props,t)||!r(e.state,n)}var i=Object.prototype.hasOwnProperty;e.exports=o},function(e,t){"use strict";var n={Properties:{"aria-current":0,"aria-details":0,"aria-disabled":0,"aria-hidden":0,"aria-invalid":0,"aria-keyshortcuts":0,"aria-label":0,"aria-roledescription":0,"aria-autocomplete":0,"aria-checked":0,"aria-expanded":0,"aria-haspopup":0,"aria-level":0,"aria-modal":0,"aria-multiline":0,"aria-multiselectable":0,"aria-orientation":0,"aria-placeholder":0,"aria-pressed":0,"aria-readonly":0,"aria-required":0,"aria-selected":0,"aria-sort":0,"aria-valuemax":0,"aria-valuemin":0,"aria-valuenow":0,"aria-valuetext":0,"aria-atomic":0,"aria-busy":0,"aria-live":0,"aria-relevant":0,"aria-dropeffect":0,"aria-grabbed":0,"aria-activedescendant":0,"aria-colcount":0,"aria-colindex":0,"aria-colspan":0,"aria-controls":0,"aria-describedby":0,"aria-errormessage":0,"aria-flowto":0,"aria-labelledby":0,"aria-owns":0,"aria-posinset":0,"aria-rowcount":0,"aria-rowindex":0,"aria-rowspan":0,"aria-setsize":0},DOMAttributeNames:{},DOMPropertyNames:{}};e.exports=n},function(e,t,n){"use strict";var r=n(6),o=n(58),i={focusDOMComponent:function(){o(r.getNodeFromInstance(this))}};e.exports=i},function(e,t,n){"use strict";function r(){var e=window.opera;return"object"==typeof e&&"function"==typeof e.version&&parseInt(e.version(),10)<=12}function o(e){return(e.ctrlKey||e.altKey||e.metaKey)&&!(e.ctrlKey&&e.altKey)}function i(e){switch(e){case"topCompositionStart":return O.compositionStart;case"topCompositionEnd":return O.compositionEnd;case"topCompositionUpdate":return O.compositionUpdate}}function a(e,t){return"topKeyDown"===e&&t.keyCode===b}function s(e,t){switch(e){case"topKeyUp":return y.indexOf(t.keyCode)!==-1;case"topKeyDown":return t.keyCode!==b;case"topKeyPress":case"topMouseDown":case"topBlur":return!0;default:return!1}}function u(e){var t=e.detail;return"object"==typeof t&&"data"in t?t.data:null}function l(e,t,n,r){var o,l;if(C?o=i(e):k?s(e,n)&&(o=O.compositionEnd):a(e,n)&&(o=O.compositionStart),!o)return null;E&&(k||o!==O.compositionStart?o===O.compositionEnd&&k&&(l=k.getData()):k=m.getPooled(r));var c=v.getPooled(o,t,n,r);if(l)c.data=l;else{var p=u(n);null!==p&&(c.data=p)}return d.accumulateTwoPhaseDispatches(c),c}function c(e,t){switch(e){case"topCompositionEnd":return u(t);case"topKeyPress":var n=t.which;return n!==T?null:(P=!0,x);case"topTextInput":var r=t.data;return r===x&&P?null:r;default:return null}}function p(e,t){if(k){if("topCompositionEnd"===e||!C&&s(e,t)){var n=k.getData();return m.release(k),k=null,n}return null}switch(e){case"topPaste":return null;case"topKeyPress":return t.which&&!o(t)?String.fromCharCode(t.which):null;case"topCompositionEnd":return E?null:t.data;default:return null}}function f(e,t,n,r){var o;if(o=w?c(e,n):p(e,n),!o)return null;var i=g.getPooled(O.beforeInput,t,n,r);return i.data=o,d.accumulateTwoPhaseDispatches(i),i}var d=n(25),h=n(7),m=n(133),v=n(170),g=n(173),y=[9,13,27,32],b=229,C=h.canUseDOM&&"CompositionEvent"in window,_=null;h.canUseDOM&&"documentMode"in document&&(_=document.documentMode);var w=h.canUseDOM&&"TextEvent"in window&&!_&&!r(),E=h.canUseDOM&&(!C||_&&_>8&&_<=11),T=32,x=String.fromCharCode(T),O={beforeInput:{phasedRegistrationNames:{bubbled:"onBeforeInput",captured:"onBeforeInputCapture"},dependencies:["topCompositionEnd","topKeyPress","topTextInput","topPaste"]},compositionEnd:{phasedRegistrationNames:{bubbled:"onCompositionEnd",captured:"onCompositionEndCapture"},dependencies:["topBlur","topCompositionEnd","topKeyDown","topKeyPress","topKeyUp","topMouseDown"]},compositionStart:{phasedRegistrationNames:{bubbled:"onCompositionStart",captured:"onCompositionStartCapture"},dependencies:["topBlur","topCompositionStart","topKeyDown","topKeyPress","topKeyUp","topMouseDown"]},compositionUpdate:{phasedRegistrationNames:{bubbled:"onCompositionUpdate",captured:"onCompositionUpdateCapture"},dependencies:["topBlur","topCompositionUpdate","topKeyDown","topKeyPress","topKeyUp","topMouseDown"]}},P=!1,k=null,S={eventTypes:O,extractEvents:function(e,t,n,r){return[l(e,t,n,r),f(e,t,n,r)]}};e.exports=S},function(e,t,n){"use strict";var r=n(64),o=n(7),i=(n(9),n(102),n(179)),a=n(109),s=n(112),u=(n(2),s(function(e){return a(e)})),l=!1,c="cssFloat";if(o.canUseDOM){var p=document.createElement("div").style;try{p.font=""}catch(e){l=!0}void 0===document.documentElement.style.cssFloat&&(c="styleFloat")}var f={createMarkupForStyles:function(e,t){var n="";for(var r in e)if(e.hasOwnProperty(r)){var o=e[r];null!=o&&(n+=u(r)+":",n+=i(r,o,t)+";")}return n||null},setValueForStyles:function(e,t,n){var o=e.style;for(var a in t)if(t.hasOwnProperty(a)){var s=i(a,t[a],n);if("float"!==a&&"cssFloat"!==a||(a=c),s)o[a]=s;else{var u=l&&r.shorthandPropertyExpansions[a];if(u)for(var p in u)o[p]="";else o[a]=""}}}};e.exports=f},function(e,t,n){"use strict";function r(e){var t=e.nodeName&&e.nodeName.toLowerCase();return"select"===t||"input"===t&&"file"===e.type}function o(e){var t=T.getPooled(k.change,N,e,x(e));C.accumulateTwoPhaseDispatches(t),E.batchedUpdates(i,t)}function i(e){b.enqueueEvents(e),b.processEventQueue(!1)}function a(e,t){S=e,N=t,S.attachEvent("onchange",o)}function s(){S&&(S.detachEvent("onchange",o),S=null,N=null)}function u(e,t){if("topChange"===e)return t}function l(e,t,n){"topFocus"===e?(s(),a(t,n)):"topBlur"===e&&s()}function c(e,t){S=e,N=t,M=e.value,A=Object.getOwnPropertyDescriptor(e.constructor.prototype,"value"),Object.defineProperty(S,"value",R),S.attachEvent?S.attachEvent("onpropertychange",f):S.addEventListener("propertychange",f,!1)}function p(){S&&(delete S.value,S.detachEvent?S.detachEvent("onpropertychange",f):S.removeEventListener("propertychange",f,!1),S=null,N=null,M=null,A=null)}function f(e){if("value"===e.propertyName){var t=e.srcElement.value;t!==M&&(M=t,o(e))}}function d(e,t){if("topInput"===e)return t}function h(e,t,n){"topFocus"===e?(p(),c(t,n)):"topBlur"===e&&p()}function m(e,t){if(("topSelectionChange"===e||"topKeyUp"===e||"topKeyDown"===e)&&S&&S.value!==M)return M=S.value,N}function v(e){return e.nodeName&&"input"===e.nodeName.toLowerCase()&&("checkbox"===e.type||"radio"===e.type)}function g(e,t){if("topClick"===e)return t}function y(e,t){if(null!=e){var n=e._wrapperState||t._wrapperState;if(n&&n.controlled&&"number"===t.type){var r=""+t.value;t.getAttribute("value")!==r&&t.setAttribute("value",r)}}}var b=n(24),C=n(25),_=n(7),w=n(6),E=n(10),T=n(11),x=n(49),O=n(50),P=n(81),k={change:{phasedRegistrationNames:{bubbled:"onChange",captured:"onChangeCapture"},dependencies:["topBlur","topChange","topClick","topFocus","topInput","topKeyDown","topKeyUp","topSelectionChange"]}},S=null,N=null,M=null,A=null,I=!1;_.canUseDOM&&(I=O("change")&&(!document.documentMode||document.documentMode>8));var D=!1;_.canUseDOM&&(D=O("input")&&(!document.documentMode||document.documentMode>11));var R={get:function(){return A.get.call(this)},set:function(e){M=""+e,A.set.call(this,e)}},L={eventTypes:k,extractEvents:function(e,t,n,o){var i,a,s=t?w.getNodeFromInstance(t):window;if(r(s)?I?i=u:a=l:P(s)?D?i=d:(i=m,a=h):v(s)&&(i=g),i){var c=i(e,t);if(c){var p=T.getPooled(k.change,c,n,o);return p.type="change",C.accumulateTwoPhaseDispatches(p),p}}a&&a(e,s,t),"topBlur"===e&&y(t,s)}};e.exports=L},function(e,t,n){"use strict";var r=n(3),o=n(17),i=n(7),a=n(105),s=n(8),u=(n(1),{dangerouslyReplaceNodeWithMarkup:function(e,t){if(i.canUseDOM?void 0:r("56"),t?void 0:r("57"),"HTML"===e.nodeName?r("58"):void 0,"string"==typeof t){var n=a(t,s)[0];e.parentNode.replaceChild(n,e)}else o.replaceChildWithTree(e,t)}});e.exports=u},function(e,t){"use strict";var n=["ResponderEventPlugin","SimpleEventPlugin","TapEventPlugin","EnterLeaveEventPlugin","ChangeEventPlugin","SelectEventPlugin","BeforeInputEventPlugin"];e.exports=n},function(e,t,n){"use strict";var r=n(25),o=n(6),i=n(30),a={mouseEnter:{registrationName:"onMouseEnter",dependencies:["topMouseOut","topMouseOver"]},mouseLeave:{registrationName:"onMouseLeave",dependencies:["topMouseOut","topMouseOver"]}},s={eventTypes:a,extractEvents:function(e,t,n,s){if("topMouseOver"===e&&(n.relatedTarget||n.fromElement))return null;if("topMouseOut"!==e&&"topMouseOver"!==e)return null;var u;if(s.window===s)u=s;else{var l=s.ownerDocument;u=l?l.defaultView||l.parentWindow:window}var c,p;if("topMouseOut"===e){c=t;var f=n.relatedTarget||n.toElement;p=f?o.getClosestInstanceFromNode(f):null}else c=null,p=t;if(c===p)return null;var d=null==c?u:o.getNodeFromInstance(c),h=null==p?u:o.getNodeFromInstance(p),m=i.getPooled(a.mouseLeave,c,n,s);m.type="mouseleave",m.target=d,m.relatedTarget=h;var v=i.getPooled(a.mouseEnter,p,n,s);return v.type="mouseenter",v.target=h,v.relatedTarget=d,r.accumulateEnterLeaveDispatches(m,v,c,p),[m,v]}};e.exports=s},function(e,t,n){"use strict";function r(e){this._root=e,this._startText=this.getText(),this._fallbackText=null}var o=n(4),i=n(14),a=n(79);o(r.prototype,{destructor:function(){this._root=null,this._startText=null,this._fallbackText=null},getText:function(){return"value"in this._root?this._root.value:this._root[a()]},getData:function(){if(this._fallbackText)return this._fallbackText;var e,t,n=this._startText,r=n.length,o=this.getText(),i=o.length;for(e=0;e<r&&n[e]===o[e];e++);var a=r-e;for(t=1;t<=a&&n[r-t]===o[i-t];t++);var s=t>1?1-t:void 0;return this._fallbackText=o.slice(e,s),this._fallbackText}}),i.addPoolingTo(r),e.exports=r},function(e,t,n){"use strict";var r=n(18),o=r.injection.MUST_USE_PROPERTY,i=r.injection.HAS_BOOLEAN_VALUE,a=r.injection.HAS_NUMERIC_VALUE,s=r.injection.HAS_POSITIVE_NUMERIC_VALUE,u=r.injection.HAS_OVERLOADED_BOOLEAN_VALUE,l={isCustomAttribute:RegExp.prototype.test.bind(new RegExp("^(data|aria)-["+r.ATTRIBUTE_NAME_CHAR+"]*$")),Properties:{accept:0,acceptCharset:0,accessKey:0,action:0,allowFullScreen:i,allowTransparency:0,alt:0,as:0,async:i,autoComplete:0,autoPlay:i,capture:i,cellPadding:0,cellSpacing:0,charSet:0,challenge:0,checked:o|i,cite:0,classID:0,className:0,cols:s,colSpan:0,content:0,contentEditable:0,contextMenu:0,controls:i,coords:0,crossOrigin:0,data:0,dateTime:0,default:i,defer:i,dir:0,disabled:i,download:u,draggable:0,encType:0,form:0,formAction:0,formEncType:0,formMethod:0,formNoValidate:i,formTarget:0,frameBorder:0,headers:0,height:0,hidden:i,high:0,href:0,hrefLang:0,htmlFor:0,httpEquiv:0,icon:0,id:0,inputMode:0,integrity:0,is:0,keyParams:0,keyType:0,kind:0,label:0,lang:0,list:0,loop:i,low:0,manifest:0,marginHeight:0,marginWidth:0,max:0,maxLength:0,media:0,mediaGroup:0,method:0,min:0,minLength:0,multiple:o|i,muted:o|i,name:0,nonce:0,noValidate:i,open:i,optimum:0,pattern:0,placeholder:0,playsInline:i,poster:0,preload:0,profile:0,radioGroup:0,readOnly:i,referrerPolicy:0,rel:0,required:i,reversed:i,role:0,rows:s,rowSpan:a,sandbox:0,scope:0,scoped:i,scrolling:0,seamless:i,selected:o|i,shape:0,size:s,sizes:0,span:s,spellCheck:0,src:0,srcDoc:0,srcLang:0,srcSet:0,start:a,step:0,style:0,summary:0,tabIndex:0,target:0,title:0,type:0,useMap:0,value:0,width:0,wmode:0,wrap:0,about:0,datatype:0,inlist:0,prefix:0,property:0,resource:0,typeof:0,vocab:0,autoCapitalize:0,autoCorrect:0,autoSave:0,color:0,itemProp:0,itemScope:i,itemType:0,itemID:0,itemRef:0,results:0,security:0,unselectable:0},DOMAttributeNames:{acceptCharset:"accept-charset",className:"class",htmlFor:"for",httpEquiv:"http-equiv"},DOMPropertyNames:{},DOMMutationMethods:{value:function(e,t){return null==t?e.removeAttribute("value"):void("number"!==e.type||e.hasAttribute("value")===!1?e.setAttribute("value",""+t):e.validity&&!e.validity.badInput&&e.ownerDocument.activeElement!==e&&e.setAttribute("value",""+t))}}};e.exports=l},function(e,t,n){(function(t){"use strict";function r(e,t,n,r){var o=void 0===e[n];null!=t&&o&&(e[n]=i(t,!0))}var o=n(19),i=n(80),a=(n(41),n(51)),s=n(83),u=(n(2),{instantiateChildren:function(e,t,n,o){if(null==e)return null;var i={};return s(e,r,i),i},updateChildren:function(e,t,n,r,s,u,l,c,p){if(t||e){var f,d;for(f in t)if(t.hasOwnProperty(f)){d=e&&e[f];var h=d&&d._currentElement,m=t[f];if(null!=d&&a(h,m))o.receiveComponent(d,m,s,c),t[f]=d;else{d&&(r[f]=o.getHostNode(d),o.unmountComponent(d,!1));var v=i(m,!0);t[f]=v;var g=o.mountComponent(v,s,u,l,c,p);n.push(g)}}for(f in e)!e.hasOwnProperty(f)||t&&t.hasOwnProperty(f)||(d=e[f],r[f]=o.getHostNode(d),o.unmountComponent(d,!1))}},unmountChildren:function(e,t){for(var n in e)if(e.hasOwnProperty(n)){var r=e[n];o.unmountComponent(r,t)}}});e.exports=u}).call(t,n(60))},function(e,t,n){"use strict";var r=n(37),o=n(143),i={processChildrenUpdates:o.dangerouslyProcessChildrenUpdates,replaceNodeWithMarkup:r.dangerouslyReplaceNodeWithMarkup};e.exports=i},function(e,t,n){"use strict";function r(e){}function o(e,t){}function i(e){return!(!e.prototype||!e.prototype.isReactComponent)}function a(e){return!(!e.prototype||!e.prototype.isPureReactComponent)}var s=n(3),u=n(4),l=n(20),c=n(43),p=n(12),f=n(44),d=n(26),h=(n(9),n(74)),m=n(19),v=n(23),g=(n(1),n(36)),y=n(51),b=(n(2),{ImpureClass:0,PureClass:1,StatelessFunctional:2});r.prototype.render=function(){var e=d.get(this)._currentElement.type,t=e(this.props,this.context,this.updater);return o(e,t),t};var C=1,_={construct:function(e){this._currentElement=e,this._rootNodeID=0,this._compositeType=null,this._instance=null,this._hostParent=null,this._hostContainerInfo=null,this._updateBatchNumber=null,this._pendingElement=null,this._pendingStateQueue=null,this._pendingReplaceState=!1,this._pendingForceUpdate=!1,this._renderedNodeType=null,this._renderedComponent=null,this._context=null,this._mountOrder=0,this._topLevelWrapper=null,this._pendingCallbacks=null,this._calledComponentWillUnmount=!1},mountComponent:function(e,t,n,u){this._context=u,this._mountOrder=C++,this._hostParent=t,this._hostContainerInfo=n;var c,p=this._currentElement.props,f=this._processContext(u),h=this._currentElement.type,m=e.getUpdateQueue(),g=i(h),y=this._constructComponent(g,p,f,m);g||null!=y&&null!=y.render?a(h)?this._compositeType=b.PureClass:this._compositeType=b.ImpureClass:(c=y,o(h,c),null===y||y===!1||l.isValidElement(y)?void 0:s("105",h.displayName||h.name||"Component"),y=new r(h),this._compositeType=b.StatelessFunctional);y.props=p,y.context=f,y.refs=v,y.updater=m,this._instance=y,d.set(y,this);var _=y.state;void 0===_&&(y.state=_=null),"object"!=typeof _||Array.isArray(_)?s("106",this.getName()||"ReactCompositeComponent"):void 0,this._pendingStateQueue=null,this._pendingReplaceState=!1,this._pendingForceUpdate=!1;var w;return w=y.unstable_handleError?this.performInitialMountWithErrorHandling(c,t,n,e,u):this.performInitialMount(c,t,n,e,u),y.componentDidMount&&e.getReactMountReady().enqueue(y.componentDidMount,y),w},_constructComponent:function(e,t,n,r){return this._constructComponentWithoutOwner(e,t,n,r)},_constructComponentWithoutOwner:function(e,t,n,r){var o=this._currentElement.type;return e?new o(t,n,r):o(t,n,r)},performInitialMountWithErrorHandling:function(e,t,n,r,o){var i,a=r.checkpoint();try{i=this.performInitialMount(e,t,n,r,o)}catch(s){r.rollback(a),this._instance.unstable_handleError(s),this._pendingStateQueue&&(this._instance.state=this._processPendingState(this._instance.props,this._instance.context)),a=r.checkpoint(),this._renderedComponent.unmountComponent(!0),r.rollback(a),i=this.performInitialMount(e,t,n,r,o)}return i},performInitialMount:function(e,t,n,r,o){var i=this._instance,a=0;i.componentWillMount&&(i.componentWillMount(),this._pendingStateQueue&&(i.state=this._processPendingState(i.props,i.context))),void 0===e&&(e=this._renderValidatedComponent());var s=h.getType(e);this._renderedNodeType=s;
+var u=this._instantiateReactComponent(e,s!==h.EMPTY);this._renderedComponent=u;var l=m.mountComponent(u,r,t,n,this._processChildContext(o),a);return l},getHostNode:function(){return m.getHostNode(this._renderedComponent)},unmountComponent:function(e){if(this._renderedComponent){var t=this._instance;if(t.componentWillUnmount&&!t._calledComponentWillUnmount)if(t._calledComponentWillUnmount=!0,e){var n=this.getName()+".componentWillUnmount()";f.invokeGuardedCallback(n,t.componentWillUnmount.bind(t))}else t.componentWillUnmount();this._renderedComponent&&(m.unmountComponent(this._renderedComponent,e),this._renderedNodeType=null,this._renderedComponent=null,this._instance=null),this._pendingStateQueue=null,this._pendingReplaceState=!1,this._pendingForceUpdate=!1,this._pendingCallbacks=null,this._pendingElement=null,this._context=null,this._rootNodeID=0,this._topLevelWrapper=null,d.remove(t)}},_maskContext:function(e){var t=this._currentElement.type,n=t.contextTypes;if(!n)return v;var r={};for(var o in n)r[o]=e[o];return r},_processContext:function(e){var t=this._maskContext(e);return t},_processChildContext:function(e){var t,n=this._currentElement.type,r=this._instance;if(r.getChildContext&&(t=r.getChildContext()),t){"object"!=typeof n.childContextTypes?s("107",this.getName()||"ReactCompositeComponent"):void 0;for(var o in t)o in n.childContextTypes?void 0:s("108",this.getName()||"ReactCompositeComponent",o);return u({},e,t)}return e},_checkContextTypes:function(e,t,n){},receiveComponent:function(e,t,n){var r=this._currentElement,o=this._context;this._pendingElement=null,this.updateComponent(t,r,e,o,n)},performUpdateIfNecessary:function(e){null!=this._pendingElement?m.receiveComponent(this,this._pendingElement,e,this._context):null!==this._pendingStateQueue||this._pendingForceUpdate?this.updateComponent(e,this._currentElement,this._currentElement,this._context,this._context):this._updateBatchNumber=null},updateComponent:function(e,t,n,r,o){var i=this._instance;null==i?s("136",this.getName()||"ReactCompositeComponent"):void 0;var a,u=!1;this._context===o?a=i.context:(a=this._processContext(o),u=!0);var l=t.props,c=n.props;t!==n&&(u=!0),u&&i.componentWillReceiveProps&&i.componentWillReceiveProps(c,a);var p=this._processPendingState(c,a),f=!0;this._pendingForceUpdate||(i.shouldComponentUpdate?f=i.shouldComponentUpdate(c,p,a):this._compositeType===b.PureClass&&(f=!g(l,c)||!g(i.state,p))),this._updateBatchNumber=null,f?(this._pendingForceUpdate=!1,this._performComponentUpdate(n,c,p,a,e,o)):(this._currentElement=n,this._context=o,i.props=c,i.state=p,i.context=a)},_processPendingState:function(e,t){var n=this._instance,r=this._pendingStateQueue,o=this._pendingReplaceState;if(this._pendingReplaceState=!1,this._pendingStateQueue=null,!r)return n.state;if(o&&1===r.length)return r[0];for(var i=u({},o?r[0]:n.state),a=o?1:0;a<r.length;a++){var s=r[a];u(i,"function"==typeof s?s.call(n,i,e,t):s)}return i},_performComponentUpdate:function(e,t,n,r,o,i){var a,s,u,l=this._instance,c=Boolean(l.componentDidUpdate);c&&(a=l.props,s=l.state,u=l.context),l.componentWillUpdate&&l.componentWillUpdate(t,n,r),this._currentElement=e,this._context=i,l.props=t,l.state=n,l.context=r,this._updateRenderedComponent(o,i),c&&o.getReactMountReady().enqueue(l.componentDidUpdate.bind(l,a,s,u),l)},_updateRenderedComponent:function(e,t){var n=this._renderedComponent,r=n._currentElement,o=this._renderValidatedComponent(),i=0;if(y(r,o))m.receiveComponent(n,o,e,this._processChildContext(t));else{var a=m.getHostNode(n);m.unmountComponent(n,!1);var s=h.getType(o);this._renderedNodeType=s;var u=this._instantiateReactComponent(o,s!==h.EMPTY);this._renderedComponent=u;var l=m.mountComponent(u,e,this._hostParent,this._hostContainerInfo,this._processChildContext(t),i);this._replaceNodeWithMarkup(a,l,n)}},_replaceNodeWithMarkup:function(e,t,n){c.replaceNodeWithMarkup(e,t,n)},_renderValidatedComponentWithoutOwnerOrContext:function(){var e,t=this._instance;return e=t.render()},_renderValidatedComponent:function(){var e;if(this._compositeType!==b.StatelessFunctional){p.current=this;try{e=this._renderValidatedComponentWithoutOwnerOrContext()}finally{p.current=null}}else e=this._renderValidatedComponentWithoutOwnerOrContext();return null===e||e===!1||l.isValidElement(e)?void 0:s("109",this.getName()||"ReactCompositeComponent"),e},attachRef:function(e,t){var n=this.getPublicInstance();null==n?s("110"):void 0;var r=t.getPublicInstance(),o=n.refs===v?n.refs={}:n.refs;o[e]=r},detachRef:function(e){var t=this.getPublicInstance().refs;delete t[e]},getName:function(){var e=this._currentElement.type,t=this._instance&&this._instance.constructor;return e.displayName||t&&t.displayName||e.name||t&&t.name||null},getPublicInstance:function(){var e=this._instance;return this._compositeType===b.StatelessFunctional?null:e},_instantiateReactComponent:null};e.exports=_},function(e,t,n){"use strict";var r=n(6),o=n(151),i=n(73),a=n(19),s=n(10),u=n(164),l=n(180),c=n(78),p=n(187);n(2);o.inject();var f={findDOMNode:l,render:i.render,unmountComponentAtNode:i.unmountComponentAtNode,version:u,unstable_batchedUpdates:s.batchedUpdates,unstable_renderSubtreeIntoContainer:p};"undefined"!=typeof __REACT_DEVTOOLS_GLOBAL_HOOK__&&"function"==typeof __REACT_DEVTOOLS_GLOBAL_HOOK__.inject&&__REACT_DEVTOOLS_GLOBAL_HOOK__.inject({ComponentTree:{getClosestInstanceFromNode:r.getClosestInstanceFromNode,getNodeFromInstance:function(e){return e._renderedComponent&&(e=c(e)),e?r.getNodeFromInstance(e):null}},Mount:i,Reconciler:a});e.exports=f},function(e,t,n){"use strict";function r(e){if(e){var t=e._currentElement._owner||null;if(t){var n=t.getName();if(n)return" This DOM node was rendered by `"+n+"`."}}return""}function o(e,t){t&&(X[e._tag]&&(null!=t.children||null!=t.dangerouslySetInnerHTML?m("137",e._tag,e._currentElement._owner?" Check the render method of "+e._currentElement._owner.getName()+".":""):void 0),null!=t.dangerouslySetInnerHTML&&(null!=t.children?m("60"):void 0,"object"==typeof t.dangerouslySetInnerHTML&&W in t.dangerouslySetInnerHTML?void 0:m("61")),null!=t.style&&"object"!=typeof t.style?m("62",r(e)):void 0)}function i(e,t,n,r){if(!(r instanceof I)){var o=e._hostContainerInfo,i=o._node&&o._node.nodeType===q,s=i?o._node:o._ownerDocument;F(t,s),r.getReactMountReady().enqueue(a,{inst:e,registrationName:t,listener:n})}}function a(){var e=this;E.putListener(e.inst,e.registrationName,e.listener)}function s(){var e=this;k.postMountWrapper(e)}function u(){var e=this;M.postMountWrapper(e)}function l(){var e=this;S.postMountWrapper(e)}function c(){var e=this;e._rootNodeID?void 0:m("63");var t=U(e);switch(t?void 0:m("64"),e._tag){case"iframe":case"object":e._wrapperState.listeners=[x.trapBubbledEvent("topLoad","load",t)];break;case"video":case"audio":e._wrapperState.listeners=[];for(var n in z)z.hasOwnProperty(n)&&e._wrapperState.listeners.push(x.trapBubbledEvent(n,z[n],t));break;case"source":e._wrapperState.listeners=[x.trapBubbledEvent("topError","error",t)];break;case"img":e._wrapperState.listeners=[x.trapBubbledEvent("topError","error",t),x.trapBubbledEvent("topLoad","load",t)];break;case"form":e._wrapperState.listeners=[x.trapBubbledEvent("topReset","reset",t),x.trapBubbledEvent("topSubmit","submit",t)];break;case"input":case"select":case"textarea":e._wrapperState.listeners=[x.trapBubbledEvent("topInvalid","invalid",t)]}}function p(){N.postUpdateWrapper(this)}function f(e){$.call(Q,e)||(G.test(e)?void 0:m("65",e),Q[e]=!0)}function d(e,t){return e.indexOf("-")>=0||null!=t.is}function h(e){var t=e.type;f(t),this._currentElement=e,this._tag=t.toLowerCase(),this._namespaceURI=null,this._renderedChildren=null,this._previousStyle=null,this._previousStyleCopy=null,this._hostNode=null,this._hostParent=null,this._rootNodeID=0,this._domID=0,this._hostContainerInfo=null,this._wrapperState=null,this._topLevelWrapper=null,this._flags=0}var m=n(3),v=n(4),g=n(126),y=n(128),b=n(17),C=n(38),_=n(18),w=n(66),E=n(24),T=n(39),x=n(29),O=n(67),P=n(6),k=n(144),S=n(145),N=n(68),M=n(148),A=(n(9),n(157)),I=n(162),D=(n(8),n(32)),R=(n(1),n(50),n(36),n(52),n(2),O),L=E.deleteListener,U=P.getNodeFromInstance,F=x.listenTo,j=T.registrationNameModules,B={string:!0,number:!0},V="style",W="__html",H={children:null,dangerouslySetInnerHTML:null,suppressContentEditableWarning:null},q=11,z={topAbort:"abort",topCanPlay:"canplay",topCanPlayThrough:"canplaythrough",topDurationChange:"durationchange",topEmptied:"emptied",topEncrypted:"encrypted",topEnded:"ended",topError:"error",topLoadedData:"loadeddata",topLoadedMetadata:"loadedmetadata",topLoadStart:"loadstart",topPause:"pause",topPlay:"play",topPlaying:"playing",topProgress:"progress",topRateChange:"ratechange",topSeeked:"seeked",topSeeking:"seeking",topStalled:"stalled",topSuspend:"suspend",topTimeUpdate:"timeupdate",topVolumeChange:"volumechange",topWaiting:"waiting"},K={area:!0,base:!0,br:!0,col:!0,embed:!0,hr:!0,img:!0,input:!0,keygen:!0,link:!0,meta:!0,param:!0,source:!0,track:!0,wbr:!0},Y={listing:!0,pre:!0,textarea:!0},X=v({menuitem:!0},K),G=/^[a-zA-Z][a-zA-Z:_\.\-\d]*$/,Q={},$={}.hasOwnProperty,Z=1;h.displayName="ReactDOMComponent",h.Mixin={mountComponent:function(e,t,n,r){this._rootNodeID=Z++,this._domID=n._idCounter++,this._hostParent=t,this._hostContainerInfo=n;var i=this._currentElement.props;switch(this._tag){case"audio":case"form":case"iframe":case"img":case"link":case"object":case"source":case"video":this._wrapperState={listeners:null},e.getReactMountReady().enqueue(c,this);break;case"input":k.mountWrapper(this,i,t),i=k.getHostProps(this,i),e.getReactMountReady().enqueue(c,this);break;case"option":S.mountWrapper(this,i,t),i=S.getHostProps(this,i);break;case"select":N.mountWrapper(this,i,t),i=N.getHostProps(this,i),e.getReactMountReady().enqueue(c,this);break;case"textarea":M.mountWrapper(this,i,t),i=M.getHostProps(this,i),e.getReactMountReady().enqueue(c,this)}o(this,i);var a,p;null!=t?(a=t._namespaceURI,p=t._tag):n._tag&&(a=n._namespaceURI,p=n._tag),(null==a||a===C.svg&&"foreignobject"===p)&&(a=C.html),a===C.html&&("svg"===this._tag?a=C.svg:"math"===this._tag&&(a=C.mathml)),this._namespaceURI=a;var f;if(e.useCreateElement){var d,h=n._ownerDocument;if(a===C.html)if("script"===this._tag){var m=h.createElement("div"),v=this._currentElement.type;m.innerHTML="<"+v+"></"+v+">",d=m.removeChild(m.firstChild)}else d=i.is?h.createElement(this._currentElement.type,i.is):h.createElement(this._currentElement.type);else d=h.createElementNS(a,this._currentElement.type);P.precacheNode(this,d),this._flags|=R.hasCachedChildNodes,this._hostParent||w.setAttributeForRoot(d),this._updateDOMProperties(null,i,e);var y=b(d);this._createInitialChildren(e,i,r,y),f=y}else{var _=this._createOpenTagMarkupAndPutListeners(e,i),E=this._createContentMarkup(e,i,r);f=!E&&K[this._tag]?_+"/>":_+">"+E+"</"+this._currentElement.type+">"}switch(this._tag){case"input":e.getReactMountReady().enqueue(s,this),i.autoFocus&&e.getReactMountReady().enqueue(g.focusDOMComponent,this);break;case"textarea":e.getReactMountReady().enqueue(u,this),i.autoFocus&&e.getReactMountReady().enqueue(g.focusDOMComponent,this);break;case"select":i.autoFocus&&e.getReactMountReady().enqueue(g.focusDOMComponent,this);break;case"button":i.autoFocus&&e.getReactMountReady().enqueue(g.focusDOMComponent,this);break;case"option":e.getReactMountReady().enqueue(l,this)}return f},_createOpenTagMarkupAndPutListeners:function(e,t){var n="<"+this._currentElement.type;for(var r in t)if(t.hasOwnProperty(r)){var o=t[r];if(null!=o)if(j.hasOwnProperty(r))o&&i(this,r,o,e);else{r===V&&(o&&(o=this._previousStyleCopy=v({},t.style)),o=y.createMarkupForStyles(o,this));var a=null;null!=this._tag&&d(this._tag,t)?H.hasOwnProperty(r)||(a=w.createMarkupForCustomAttribute(r,o)):a=w.createMarkupForProperty(r,o),a&&(n+=" "+a)}}return e.renderToStaticMarkup?n:(this._hostParent||(n+=" "+w.createMarkupForRoot()),n+=" "+w.createMarkupForID(this._domID))},_createContentMarkup:function(e,t,n){var r="",o=t.dangerouslySetInnerHTML;if(null!=o)null!=o.__html&&(r=o.__html);else{var i=B[typeof t.children]?t.children:null,a=null!=i?null:t.children;if(null!=i)r=D(i);else if(null!=a){var s=this.mountChildren(a,e,n);r=s.join("")}}return Y[this._tag]&&"\n"===r.charAt(0)?"\n"+r:r},_createInitialChildren:function(e,t,n,r){var o=t.dangerouslySetInnerHTML;if(null!=o)null!=o.__html&&b.queueHTML(r,o.__html);else{var i=B[typeof t.children]?t.children:null,a=null!=i?null:t.children;if(null!=i)""!==i&&b.queueText(r,i);else if(null!=a)for(var s=this.mountChildren(a,e,n),u=0;u<s.length;u++)b.queueChild(r,s[u])}},receiveComponent:function(e,t,n){var r=this._currentElement;this._currentElement=e,this.updateComponent(t,r,e,n)},updateComponent:function(e,t,n,r){var i=t.props,a=this._currentElement.props;switch(this._tag){case"input":i=k.getHostProps(this,i),a=k.getHostProps(this,a);break;case"option":i=S.getHostProps(this,i),a=S.getHostProps(this,a);break;case"select":i=N.getHostProps(this,i),a=N.getHostProps(this,a);break;case"textarea":i=M.getHostProps(this,i),a=M.getHostProps(this,a)}switch(o(this,a),this._updateDOMProperties(i,a,e),this._updateDOMChildren(i,a,e,r),this._tag){case"input":k.updateWrapper(this);break;case"textarea":M.updateWrapper(this);break;case"select":e.getReactMountReady().enqueue(p,this)}},_updateDOMProperties:function(e,t,n){var r,o,a;for(r in e)if(!t.hasOwnProperty(r)&&e.hasOwnProperty(r)&&null!=e[r])if(r===V){var s=this._previousStyleCopy;for(o in s)s.hasOwnProperty(o)&&(a=a||{},a[o]="");this._previousStyleCopy=null}else j.hasOwnProperty(r)?e[r]&&L(this,r):d(this._tag,e)?H.hasOwnProperty(r)||w.deleteValueForAttribute(U(this),r):(_.properties[r]||_.isCustomAttribute(r))&&w.deleteValueForProperty(U(this),r);for(r in t){var u=t[r],l=r===V?this._previousStyleCopy:null!=e?e[r]:void 0;if(t.hasOwnProperty(r)&&u!==l&&(null!=u||null!=l))if(r===V)if(u?u=this._previousStyleCopy=v({},u):this._previousStyleCopy=null,l){for(o in l)!l.hasOwnProperty(o)||u&&u.hasOwnProperty(o)||(a=a||{},a[o]="");for(o in u)u.hasOwnProperty(o)&&l[o]!==u[o]&&(a=a||{},a[o]=u[o])}else a=u;else if(j.hasOwnProperty(r))u?i(this,r,u,n):l&&L(this,r);else if(d(this._tag,t))H.hasOwnProperty(r)||w.setValueForAttribute(U(this),r,u);else if(_.properties[r]||_.isCustomAttribute(r)){var c=U(this);null!=u?w.setValueForProperty(c,r,u):w.deleteValueForProperty(c,r)}}a&&y.setValueForStyles(U(this),a,this)},_updateDOMChildren:function(e,t,n,r){var o=B[typeof e.children]?e.children:null,i=B[typeof t.children]?t.children:null,a=e.dangerouslySetInnerHTML&&e.dangerouslySetInnerHTML.__html,s=t.dangerouslySetInnerHTML&&t.dangerouslySetInnerHTML.__html,u=null!=o?null:e.children,l=null!=i?null:t.children,c=null!=o||null!=a,p=null!=i||null!=s;null!=u&&null==l?this.updateChildren(null,n,r):c&&!p&&this.updateTextContent(""),null!=i?o!==i&&this.updateTextContent(""+i):null!=s?a!==s&&this.updateMarkup(""+s):null!=l&&this.updateChildren(l,n,r)},getHostNode:function(){return U(this)},unmountComponent:function(e){switch(this._tag){case"audio":case"form":case"iframe":case"img":case"link":case"object":case"source":case"video":var t=this._wrapperState.listeners;if(t)for(var n=0;n<t.length;n++)t[n].remove();break;case"html":case"head":case"body":m("66",this._tag)}this.unmountChildren(e),P.uncacheNode(this),E.deleteAllListeners(this),this._rootNodeID=0,this._domID=0,this._wrapperState=null},getPublicInstance:function(){return U(this)}},v(h.prototype,h.Mixin,A.Mixin),e.exports=h},function(e,t,n){"use strict";function r(e,t){var n={_topLevelWrapper:e,_idCounter:1,_ownerDocument:t?t.nodeType===o?t:t.ownerDocument:null,_node:t,_tag:t?t.nodeName.toLowerCase():null,_namespaceURI:t?t.namespaceURI:null};return n}var o=(n(52),9);e.exports=r},function(e,t,n){"use strict";var r=n(4),o=n(17),i=n(6),a=function(e){this._currentElement=null,this._hostNode=null,this._hostParent=null,this._hostContainerInfo=null,this._domID=0};r(a.prototype,{mountComponent:function(e,t,n,r){var a=n._idCounter++;this._domID=a,this._hostParent=t,this._hostContainerInfo=n;var s=" react-empty: "+this._domID+" ";if(e.useCreateElement){var u=n._ownerDocument,l=u.createComment(s);return i.precacheNode(this,l),o(l)}return e.renderToStaticMarkup?"":"<!--"+s+"-->"},receiveComponent:function(){},getHostNode:function(){return i.getNodeFromInstance(this)},unmountComponent:function(){i.uncacheNode(this)}}),e.exports=a},function(e,t){"use strict";var n={useCreateElement:!0,useFiber:!1};e.exports=n},function(e,t,n){"use strict";var r=n(37),o=n(6),i={dangerouslyProcessChildrenUpdates:function(e,t){var n=o.getNodeFromInstance(e);r.processUpdates(n,t)}};e.exports=i},function(e,t,n){"use strict";function r(){this._rootNodeID&&f.updateWrapper(this)}function o(e){var t="checkbox"===e.type||"radio"===e.type;return t?null!=e.checked:null!=e.value}function i(e){var t=this._currentElement.props,n=l.executeOnChange(t,e);p.asap(r,this);var o=t.name;if("radio"===t.type&&null!=o){for(var i=c.getNodeFromInstance(this),s=i;s.parentNode;)s=s.parentNode;for(var u=s.querySelectorAll("input[name="+JSON.stringify(""+o)+'][type="radio"]'),f=0;f<u.length;f++){var d=u[f];if(d!==i&&d.form===i.form){var h=c.getInstanceFromNode(d);h?void 0:a("90"),p.asap(r,h)}}}return n}var a=n(3),s=n(4),u=n(66),l=n(42),c=n(6),p=n(10),f=(n(1),n(2),{getHostProps:function(e,t){var n=l.getValue(t),r=l.getChecked(t),o=s({type:void 0,step:void 0,min:void 0,max:void 0},t,{defaultChecked:void 0,defaultValue:void 0,value:null!=n?n:e._wrapperState.initialValue,checked:null!=r?r:e._wrapperState.initialChecked,onChange:e._wrapperState.onChange});return o},mountWrapper:function(e,t){var n=t.defaultValue;e._wrapperState={initialChecked:null!=t.checked?t.checked:t.defaultChecked,initialValue:null!=t.value?t.value:n,listeners:null,onChange:i.bind(e),controlled:o(t)}},updateWrapper:function(e){var t=e._currentElement.props,n=t.checked;null!=n&&u.setValueForProperty(c.getNodeFromInstance(e),"checked",n||!1);var r=c.getNodeFromInstance(e),o=l.getValue(t);if(null!=o)if(0===o&&""===r.value)r.value="0";else if("number"===t.type){var i=parseFloat(r.value,10)||0;o!=i&&(r.value=""+o)}else o!=r.value&&(r.value=""+o);else null==t.value&&null!=t.defaultValue&&r.defaultValue!==""+t.defaultValue&&(r.defaultValue=""+t.defaultValue),null==t.checked&&null!=t.defaultChecked&&(r.defaultChecked=!!t.defaultChecked)},postMountWrapper:function(e){var t=e._currentElement.props,n=c.getNodeFromInstance(e);switch(t.type){case"submit":case"reset":break;case"color":case"date":case"datetime":case"datetime-local":case"month":case"time":case"week":n.value="",n.value=n.defaultValue;break;default:n.value=n.value}var r=n.name;""!==r&&(n.name=""),n.defaultChecked=!n.defaultChecked,n.defaultChecked=!n.defaultChecked,""!==r&&(n.name=r)}});e.exports=f},function(e,t,n){"use strict";function r(e){var t="";return i.Children.forEach(e,function(e){null!=e&&("string"==typeof e||"number"==typeof e?t+=e:u||(u=!0))}),t}var o=n(4),i=n(20),a=n(6),s=n(68),u=(n(2),!1),l={mountWrapper:function(e,t,n){var o=null;if(null!=n){var i=n;"optgroup"===i._tag&&(i=i._hostParent),null!=i&&"select"===i._tag&&(o=s.getSelectValueContext(i))}var a=null;if(null!=o){var u;if(u=null!=t.value?t.value+"":r(t.children),a=!1,Array.isArray(o)){for(var l=0;l<o.length;l++)if(""+o[l]===u){a=!0;break}}else a=""+o===u}e._wrapperState={selected:a}},postMountWrapper:function(e){var t=e._currentElement.props;if(null!=t.value){var n=a.getNodeFromInstance(e);n.setAttribute("value",t.value)}},getHostProps:function(e,t){var n=o({selected:void 0,children:void 0},t);null!=e._wrapperState.selected&&(n.selected=e._wrapperState.selected);var i=r(t.children);return i&&(n.children=i),n}};e.exports=l},function(e,t,n){"use strict";function r(e,t,n,r){return e===n&&t===r}function o(e){var t=document.selection,n=t.createRange(),r=n.text.length,o=n.duplicate();o.moveToElementText(e),o.setEndPoint("EndToStart",n);var i=o.text.length,a=i+r;return{start:i,end:a}}function i(e){var t=window.getSelection&&window.getSelection();if(!t||0===t.rangeCount)return null;var n=t.anchorNode,o=t.anchorOffset,i=t.focusNode,a=t.focusOffset,s=t.getRangeAt(0);try{s.startContainer.nodeType,s.endContainer.nodeType}catch(e){return null}var u=r(t.anchorNode,t.anchorOffset,t.focusNode,t.focusOffset),l=u?0:s.toString().length,c=s.cloneRange();c.selectNodeContents(e),c.setEnd(s.startContainer,s.startOffset);var p=r(c.startContainer,c.startOffset,c.endContainer,c.endOffset),f=p?0:c.toString().length,d=f+l,h=document.createRange();h.setStart(n,o),h.setEnd(i,a);var m=h.collapsed;return{start:m?d:f,end:m?f:d}}function a(e,t){var n,r,o=document.selection.createRange().duplicate();void 0===t.end?(n=t.start,r=n):t.start>t.end?(n=t.end,r=t.start):(n=t.start,r=t.end),o.moveToElementText(e),o.moveStart("character",n),o.setEndPoint("EndToStart",o),o.moveEnd("character",r-n),o.select()}function s(e,t){if(window.getSelection){var n=window.getSelection(),r=e[c()].length,o=Math.min(t.start,r),i=void 0===t.end?o:Math.min(t.end,r);if(!n.extend&&o>i){var a=i;i=o,o=a}var s=l(e,o),u=l(e,i);if(s&&u){var p=document.createRange();p.setStart(s.node,s.offset),n.removeAllRanges(),o>i?(n.addRange(p),n.extend(u.node,u.offset)):(p.setEnd(u.node,u.offset),n.addRange(p))}}}var u=n(7),l=n(184),c=n(79),p=u.canUseDOM&&"selection"in document&&!("getSelection"in window),f={getOffsets:p?o:i,setOffsets:p?a:s};e.exports=f},function(e,t,n){"use strict";var r=n(3),o=n(4),i=n(37),a=n(17),s=n(6),u=n(32),l=(n(1),n(52),function(e){this._currentElement=e,this._stringText=""+e,this._hostNode=null,this._hostParent=null,this._domID=0,this._mountIndex=0,this._closingComment=null,this._commentNodes=null});o(l.prototype,{mountComponent:function(e,t,n,r){var o=n._idCounter++,i=" react-text: "+o+" ",l=" /react-text ";if(this._domID=o,this._hostParent=t,e.useCreateElement){var c=n._ownerDocument,p=c.createComment(i),f=c.createComment(l),d=a(c.createDocumentFragment());return a.queueChild(d,a(p)),this._stringText&&a.queueChild(d,a(c.createTextNode(this._stringText))),a.queueChild(d,a(f)),s.precacheNode(this,p),this._closingComment=f,d}var h=u(this._stringText);return e.renderToStaticMarkup?h:"<!--"+i+"-->"+h+"<!--"+l+"-->"},receiveComponent:function(e,t){if(e!==this._currentElement){this._currentElement=e;var n=""+e;if(n!==this._stringText){this._stringText=n;var r=this.getHostNode();i.replaceDelimitedText(r[0],r[1],n)}}},getHostNode:function(){var e=this._commentNodes;if(e)return e;if(!this._closingComment)for(var t=s.getNodeFromInstance(this),n=t.nextSibling;;){if(null==n?r("67",this._domID):void 0,8===n.nodeType&&" /react-text "===n.nodeValue){this._closingComment=n;break}n=n.nextSibling}return e=[this._hostNode,this._closingComment],this._commentNodes=e,e},unmountComponent:function(){this._closingComment=null,this._commentNodes=null,s.uncacheNode(this)}}),e.exports=l},function(e,t,n){"use strict";function r(){this._rootNodeID&&c.updateWrapper(this)}function o(e){var t=this._currentElement.props,n=s.executeOnChange(t,e);return l.asap(r,this),n}var i=n(3),a=n(4),s=n(42),u=n(6),l=n(10),c=(n(1),n(2),{getHostProps:function(e,t){null!=t.dangerouslySetInnerHTML?i("91"):void 0;var n=a({},t,{value:void 0,defaultValue:void 0,children:""+e._wrapperState.initialValue,onChange:e._wrapperState.onChange});return n},mountWrapper:function(e,t){var n=s.getValue(t),r=n;if(null==n){var a=t.defaultValue,u=t.children;null!=u&&(null!=a?i("92"):void 0,Array.isArray(u)&&(u.length<=1?void 0:i("93"),u=u[0]),a=""+u),null==a&&(a=""),r=a}e._wrapperState={initialValue:""+r,listeners:null,onChange:o.bind(e)}},updateWrapper:function(e){var t=e._currentElement.props,n=u.getNodeFromInstance(e),r=s.getValue(t);if(null!=r){var o=""+r;o!==n.value&&(n.value=o),null==t.defaultValue&&(n.defaultValue=o)}null!=t.defaultValue&&(n.defaultValue=t.defaultValue)},postMountWrapper:function(e){var t=u.getNodeFromInstance(e),n=t.textContent;n===e._wrapperState.initialValue&&(t.value=n)}});e.exports=c},function(e,t,n){"use strict";function r(e,t){"_hostNode"in e?void 0:u("33"),"_hostNode"in t?void 0:u("33");for(var n=0,r=e;r;r=r._hostParent)n++;for(var o=0,i=t;i;i=i._hostParent)o++;for(;n-o>0;)e=e._hostParent,n--;for(;o-n>0;)t=t._hostParent,o--;for(var a=n;a--;){if(e===t)return e;e=e._hostParent,t=t._hostParent}return null}function o(e,t){"_hostNode"in e?void 0:u("35"),"_hostNode"in t?void 0:u("35");for(;t;){if(t===e)return!0;t=t._hostParent}return!1}function i(e){return"_hostNode"in e?void 0:u("36"),e._hostParent}function a(e,t,n){for(var r=[];e;)r.push(e),e=e._hostParent;var o;for(o=r.length;o-- >0;)t(r[o],"captured",n);for(o=0;o<r.length;o++)t(r[o],"bubbled",n)}function s(e,t,n,o,i){for(var a=e&&t?r(e,t):null,s=[];e&&e!==a;)s.push(e),e=e._hostParent;for(var u=[];t&&t!==a;)u.push(t),t=t._hostParent;var l;for(l=0;l<s.length;l++)n(s[l],"bubbled",o);for(l=u.length;l-- >0;)n(u[l],"captured",i)}var u=n(3);n(1);e.exports={isAncestor:o,getLowestCommonAncestor:r,getParentInstance:i,traverseTwoPhase:a,traverseEnterLeave:s}},function(e,t,n){"use strict";function r(){this.reinitializeTransaction()}var o=n(4),i=n(10),a=n(31),s=n(8),u={initialize:s,close:function(){f.isBatchingUpdates=!1}},l={initialize:s,close:i.flushBatchedUpdates.bind(i)},c=[l,u];o(r.prototype,a,{getTransactionWrappers:function(){return c}});var p=new r,f={isBatchingUpdates:!1,batchedUpdates:function(e,t,n,r,o,i){var a=f.isBatchingUpdates;return f.isBatchingUpdates=!0,a?e(t,n,r,o,i):p.perform(e,null,t,n,r,o,i)}};e.exports=f},function(e,t,n){"use strict";function r(){E||(E=!0,y.EventEmitter.injectReactEventListener(g),y.EventPluginHub.injectEventPluginOrder(s),y.EventPluginUtils.injectComponentTree(f),y.EventPluginUtils.injectTreeTraversal(h),y.EventPluginHub.injectEventPluginsByName({SimpleEventPlugin:w,EnterLeaveEventPlugin:u,ChangeEventPlugin:a,SelectEventPlugin:_,BeforeInputEventPlugin:i}),y.HostComponent.injectGenericComponentClass(p),y.HostComponent.injectTextComponentClass(m),y.DOMProperty.injectDOMPropertyConfig(o),y.DOMProperty.injectDOMPropertyConfig(l),y.DOMProperty.injectDOMPropertyConfig(C),y.EmptyComponent.injectEmptyComponentFactory(function(e){return new d(e)}),y.Updates.injectReconcileTransaction(b),y.Updates.injectBatchingStrategy(v),y.Component.injectEnvironment(c))}var o=n(125),i=n(127),a=n(129),s=n(131),u=n(132),l=n(134),c=n(136),p=n(139),f=n(6),d=n(141),h=n(149),m=n(147),v=n(150),g=n(154),y=n(155),b=n(160),C=n(165),_=n(166),w=n(167),E=!1;e.exports={inject:r}},88,function(e,t,n){"use strict";function r(e){o.enqueueEvents(e),o.processEventQueue(!1)}var o=n(24),i={handleTopLevel:function(e,t,n,i){var a=o.extractEvents(e,t,n,i);r(a)}};e.exports=i},function(e,t,n){"use strict";function r(e){for(;e._hostParent;)e=e._hostParent;var t=p.getNodeFromInstance(e),n=t.parentNode;return p.getClosestInstanceFromNode(n)}function o(e,t){this.topLevelType=e,this.nativeEvent=t,this.ancestors=[]}function i(e){var t=d(e.nativeEvent),n=p.getClosestInstanceFromNode(t),o=n;do e.ancestors.push(o),o=o&&r(o);while(o);for(var i=0;i<e.ancestors.length;i++)n=e.ancestors[i],m._handleTopLevel(e.topLevelType,n,e.nativeEvent,d(e.nativeEvent))}function a(e){var t=h(window);e(t)}var s=n(4),u=n(57),l=n(7),c=n(14),p=n(6),f=n(10),d=n(49),h=n(107);s(o.prototype,{destructor:function(){this.topLevelType=null,this.nativeEvent=null,this.ancestors.length=0}}),c.addPoolingTo(o,c.twoArgumentPooler);var m={_enabled:!0,_handleTopLevel:null,WINDOW_HANDLE:l.canUseDOM?window:null,setHandleTopLevel:function(e){m._handleTopLevel=e},setEnabled:function(e){m._enabled=!!e},isEnabled:function(){return m._enabled},trapBubbledEvent:function(e,t,n){return n?u.listen(n,t,m.dispatchEvent.bind(null,e)):null},trapCapturedEvent:function(e,t,n){return n?u.capture(n,t,m.dispatchEvent.bind(null,e)):null},monitorScrollValue:function(e){var t=a.bind(null,e);u.listen(window,"scroll",t)},dispatchEvent:function(e,t){if(m._enabled){var n=o.getPooled(e,t);try{f.batchedUpdates(i,n)}finally{o.release(n)}}}};e.exports=m},function(e,t,n){"use strict";var r=n(18),o=n(24),i=n(40),a=n(43),s=n(69),u=n(29),l=n(71),c=n(10),p={Component:a.injection,DOMProperty:r.injection,EmptyComponent:s.injection,EventPluginHub:o.injection,EventPluginUtils:i.injection,EventEmitter:u.injection,HostComponent:l.injection,Updates:c.injection};e.exports=p},function(e,t,n){"use strict";var r=n(178),o=/\/?>/,i=/^<\!\-\-/,a={CHECKSUM_ATTR_NAME:"data-react-checksum",addChecksumToMarkup:function(e){var t=r(e);return i.test(e)?e:e.replace(o," "+a.CHECKSUM_ATTR_NAME+'="'+t+'"$&')},canReuseMarkup:function(e,t){var n=t.getAttribute(a.CHECKSUM_ATTR_NAME);n=n&&parseInt(n,10);var o=r(e);return o===n}};e.exports=a},function(e,t,n){"use strict";function r(e,t,n){return{type:"INSERT_MARKUP",content:e,fromIndex:null,fromNode:null,toIndex:n,afterNode:t}}function o(e,t,n){return{type:"MOVE_EXISTING",content:null,fromIndex:e._mountIndex,fromNode:f.getHostNode(e),toIndex:n,afterNode:t}}function i(e,t){return{type:"REMOVE_NODE",content:null,fromIndex:e._mountIndex,fromNode:t,toIndex:null,afterNode:null}}function a(e){return{type:"SET_MARKUP",content:e,fromIndex:null,fromNode:null,toIndex:null,afterNode:null}}function s(e){return{type:"TEXT_CONTENT",content:e,fromIndex:null,fromNode:null,toIndex:null,afterNode:null}}function u(e,t){return t&&(e=e||[],e.push(t)),e}function l(e,t){p.processChildrenUpdates(e,t)}var c=n(3),p=n(43),f=(n(26),n(9),n(12),n(19)),d=n(135),h=(n(8),n(181)),m=(n(1),{Mixin:{_reconcilerInstantiateChildren:function(e,t,n){return d.instantiateChildren(e,t,n)},_reconcilerUpdateChildren:function(e,t,n,r,o,i){var a,s=0;return a=h(t,s),d.updateChildren(e,a,n,r,o,this,this._hostContainerInfo,i,s),a},mountChildren:function(e,t,n){var r=this._reconcilerInstantiateChildren(e,t,n);this._renderedChildren=r;var o=[],i=0;for(var a in r)if(r.hasOwnProperty(a)){var s=r[a],u=0,l=f.mountComponent(s,t,this,this._hostContainerInfo,n,u);s._mountIndex=i++,o.push(l)}return o},updateTextContent:function(e){var t=this._renderedChildren;d.unmountChildren(t,!1);for(var n in t)t.hasOwnProperty(n)&&c("118");var r=[s(e)];l(this,r)},updateMarkup:function(e){var t=this._renderedChildren;d.unmountChildren(t,!1);for(var n in t)t.hasOwnProperty(n)&&c("118");var r=[a(e)];l(this,r)},updateChildren:function(e,t,n){this._updateChildren(e,t,n)},_updateChildren:function(e,t,n){var r=this._renderedChildren,o={},i=[],a=this._reconcilerUpdateChildren(r,e,i,o,t,n);if(a||r){var s,c=null,p=0,d=0,h=0,m=null;for(s in a)if(a.hasOwnProperty(s)){var v=r&&r[s],g=a[s];v===g?(c=u(c,this.moveChild(v,m,p,d)),d=Math.max(v._mountIndex,d),v._mountIndex=p):(v&&(d=Math.max(v._mountIndex,d)),c=u(c,this._mountChildAtIndex(g,i[h],m,p,t,n)),h++),p++,m=f.getHostNode(g)}for(s in o)o.hasOwnProperty(s)&&(c=u(c,this._unmountChild(r[s],o[s])));c&&l(this,c),this._renderedChildren=a}},unmountChildren:function(e){var t=this._renderedChildren;d.unmountChildren(t,e),this._renderedChildren=null},moveChild:function(e,t,n,r){if(e._mountIndex<r)return o(e,t,n)},createChild:function(e,t,n){return r(n,t,e._mountIndex)},removeChild:function(e,t){return i(e,t)},_mountChildAtIndex:function(e,t,n,r,o,i){return e._mountIndex=r,this.createChild(e,n,t)},_unmountChild:function(e,t){var n=this.removeChild(e,t);return e._mountIndex=null,n}}});e.exports=m},function(e,t,n){"use strict";function r(e){return!(!e||"function"!=typeof e.attachRef||"function"!=typeof e.detachRef)}var o=n(3),i=(n(1),{addComponentAsRefTo:function(e,t,n){r(n)?void 0:o("119"),n.attachRef(t,e)},removeComponentAsRefFrom:function(e,t,n){r(n)?void 0:o("120");var i=n.getPublicInstance();i&&i.refs[t]===e.getPublicInstance()&&n.detachRef(t)}});e.exports=i},function(e,t){"use strict";var n="SECRET_DO_NOT_PASS_THIS_OR_YOU_WILL_BE_FIRED";e.exports=n},function(e,t,n){"use strict";function r(e){this.reinitializeTransaction(),this.renderToStaticMarkup=!1,this.reactMountReady=i.getPooled(null),this.useCreateElement=e}var o=n(4),i=n(65),a=n(14),s=n(29),u=n(72),l=(n(9),n(31)),c=n(45),p={initialize:u.getSelectionInformation,close:u.restoreSelection},f={initialize:function(){var e=s.isEnabled();return s.setEnabled(!1),e},close:function(e){
+s.setEnabled(e)}},d={initialize:function(){this.reactMountReady.reset()},close:function(){this.reactMountReady.notifyAll()}},h=[p,f,d],m={getTransactionWrappers:function(){return h},getReactMountReady:function(){return this.reactMountReady},getUpdateQueue:function(){return c},checkpoint:function(){return this.reactMountReady.checkpoint()},rollback:function(e){this.reactMountReady.rollback(e)},destructor:function(){i.release(this.reactMountReady),this.reactMountReady=null}};o(r.prototype,l,m),a.addPoolingTo(r),e.exports=r},function(e,t,n){"use strict";function r(e,t,n){"function"==typeof e?e(t.getPublicInstance()):i.addComponentAsRefTo(t,e,n)}function o(e,t,n){"function"==typeof e?e(null):i.removeComponentAsRefFrom(t,e,n)}var i=n(158),a={};a.attachRefs=function(e,t){if(null!==t&&"object"==typeof t){var n=t.ref;null!=n&&r(n,e,t._owner)}},a.shouldUpdateRefs=function(e,t){var n=null,r=null;null!==e&&"object"==typeof e&&(n=e.ref,r=e._owner);var o=null,i=null;return null!==t&&"object"==typeof t&&(o=t.ref,i=t._owner),n!==o||"string"==typeof o&&i!==r},a.detachRefs=function(e,t){if(null!==t&&"object"==typeof t){var n=t.ref;null!=n&&o(n,e,t._owner)}},e.exports=a},function(e,t,n){"use strict";function r(e){this.reinitializeTransaction(),this.renderToStaticMarkup=e,this.useCreateElement=!1,this.updateQueue=new s(this)}var o=n(4),i=n(14),a=n(31),s=(n(9),n(163)),u=[],l={enqueue:function(){}},c={getTransactionWrappers:function(){return u},getReactMountReady:function(){return l},getUpdateQueue:function(){return this.updateQueue},destructor:function(){},checkpoint:function(){},rollback:function(){}};o(r.prototype,a,c),i.addPoolingTo(r),e.exports=r},function(e,t,n){"use strict";function r(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function o(e,t){}var i=n(45),a=(n(2),function(){function e(t){r(this,e),this.transaction=t}return e.prototype.isMounted=function(e){return!1},e.prototype.enqueueCallback=function(e,t,n){this.transaction.isInTransaction()&&i.enqueueCallback(e,t,n)},e.prototype.enqueueForceUpdate=function(e){this.transaction.isInTransaction()?i.enqueueForceUpdate(e):o(e,"forceUpdate")},e.prototype.enqueueReplaceState=function(e,t){this.transaction.isInTransaction()?i.enqueueReplaceState(e,t):o(e,"replaceState")},e.prototype.enqueueSetState=function(e,t){this.transaction.isInTransaction()?i.enqueueSetState(e,t):o(e,"setState")},e}());e.exports=a},function(e,t){"use strict";e.exports="15.5.4"},function(e,t){"use strict";var n={xlink:"http://www.w3.org/1999/xlink",xml:"http://www.w3.org/XML/1998/namespace"},r={accentHeight:"accent-height",accumulate:0,additive:0,alignmentBaseline:"alignment-baseline",allowReorder:"allowReorder",alphabetic:0,amplitude:0,arabicForm:"arabic-form",ascent:0,attributeName:"attributeName",attributeType:"attributeType",autoReverse:"autoReverse",azimuth:0,baseFrequency:"baseFrequency",baseProfile:"baseProfile",baselineShift:"baseline-shift",bbox:0,begin:0,bias:0,by:0,calcMode:"calcMode",capHeight:"cap-height",clip:0,clipPath:"clip-path",clipRule:"clip-rule",clipPathUnits:"clipPathUnits",colorInterpolation:"color-interpolation",colorInterpolationFilters:"color-interpolation-filters",colorProfile:"color-profile",colorRendering:"color-rendering",contentScriptType:"contentScriptType",contentStyleType:"contentStyleType",cursor:0,cx:0,cy:0,d:0,decelerate:0,descent:0,diffuseConstant:"diffuseConstant",direction:0,display:0,divisor:0,dominantBaseline:"dominant-baseline",dur:0,dx:0,dy:0,edgeMode:"edgeMode",elevation:0,enableBackground:"enable-background",end:0,exponent:0,externalResourcesRequired:"externalResourcesRequired",fill:0,fillOpacity:"fill-opacity",fillRule:"fill-rule",filter:0,filterRes:"filterRes",filterUnits:"filterUnits",floodColor:"flood-color",floodOpacity:"flood-opacity",focusable:0,fontFamily:"font-family",fontSize:"font-size",fontSizeAdjust:"font-size-adjust",fontStretch:"font-stretch",fontStyle:"font-style",fontVariant:"font-variant",fontWeight:"font-weight",format:0,from:0,fx:0,fy:0,g1:0,g2:0,glyphName:"glyph-name",glyphOrientationHorizontal:"glyph-orientation-horizontal",glyphOrientationVertical:"glyph-orientation-vertical",glyphRef:"glyphRef",gradientTransform:"gradientTransform",gradientUnits:"gradientUnits",hanging:0,horizAdvX:"horiz-adv-x",horizOriginX:"horiz-origin-x",ideographic:0,imageRendering:"image-rendering",in:0,in2:0,intercept:0,k:0,k1:0,k2:0,k3:0,k4:0,kernelMatrix:"kernelMatrix",kernelUnitLength:"kernelUnitLength",kerning:0,keyPoints:"keyPoints",keySplines:"keySplines",keyTimes:"keyTimes",lengthAdjust:"lengthAdjust",letterSpacing:"letter-spacing",lightingColor:"lighting-color",limitingConeAngle:"limitingConeAngle",local:0,markerEnd:"marker-end",markerMid:"marker-mid",markerStart:"marker-start",markerHeight:"markerHeight",markerUnits:"markerUnits",markerWidth:"markerWidth",mask:0,maskContentUnits:"maskContentUnits",maskUnits:"maskUnits",mathematical:0,mode:0,numOctaves:"numOctaves",offset:0,opacity:0,operator:0,order:0,orient:0,orientation:0,origin:0,overflow:0,overlinePosition:"overline-position",overlineThickness:"overline-thickness",paintOrder:"paint-order",panose1:"panose-1",pathLength:"pathLength",patternContentUnits:"patternContentUnits",patternTransform:"patternTransform",patternUnits:"patternUnits",pointerEvents:"pointer-events",points:0,pointsAtX:"pointsAtX",pointsAtY:"pointsAtY",pointsAtZ:"pointsAtZ",preserveAlpha:"preserveAlpha",preserveAspectRatio:"preserveAspectRatio",primitiveUnits:"primitiveUnits",r:0,radius:0,refX:"refX",refY:"refY",renderingIntent:"rendering-intent",repeatCount:"repeatCount",repeatDur:"repeatDur",requiredExtensions:"requiredExtensions",requiredFeatures:"requiredFeatures",restart:0,result:0,rotate:0,rx:0,ry:0,scale:0,seed:0,shapeRendering:"shape-rendering",slope:0,spacing:0,specularConstant:"specularConstant",specularExponent:"specularExponent",speed:0,spreadMethod:"spreadMethod",startOffset:"startOffset",stdDeviation:"stdDeviation",stemh:0,stemv:0,stitchTiles:"stitchTiles",stopColor:"stop-color",stopOpacity:"stop-opacity",strikethroughPosition:"strikethrough-position",strikethroughThickness:"strikethrough-thickness",string:0,stroke:0,strokeDasharray:"stroke-dasharray",strokeDashoffset:"stroke-dashoffset",strokeLinecap:"stroke-linecap",strokeLinejoin:"stroke-linejoin",strokeMiterlimit:"stroke-miterlimit",strokeOpacity:"stroke-opacity",strokeWidth:"stroke-width",surfaceScale:"surfaceScale",systemLanguage:"systemLanguage",tableValues:"tableValues",targetX:"targetX",targetY:"targetY",textAnchor:"text-anchor",textDecoration:"text-decoration",textRendering:"text-rendering",textLength:"textLength",to:0,transform:0,u1:0,u2:0,underlinePosition:"underline-position",underlineThickness:"underline-thickness",unicode:0,unicodeBidi:"unicode-bidi",unicodeRange:"unicode-range",unitsPerEm:"units-per-em",vAlphabetic:"v-alphabetic",vHanging:"v-hanging",vIdeographic:"v-ideographic",vMathematical:"v-mathematical",values:0,vectorEffect:"vector-effect",version:0,vertAdvY:"vert-adv-y",vertOriginX:"vert-origin-x",vertOriginY:"vert-origin-y",viewBox:"viewBox",viewTarget:"viewTarget",visibility:0,widths:0,wordSpacing:"word-spacing",writingMode:"writing-mode",x:0,xHeight:"x-height",x1:0,x2:0,xChannelSelector:"xChannelSelector",xlinkActuate:"xlink:actuate",xlinkArcrole:"xlink:arcrole",xlinkHref:"xlink:href",xlinkRole:"xlink:role",xlinkShow:"xlink:show",xlinkTitle:"xlink:title",xlinkType:"xlink:type",xmlBase:"xml:base",xmlns:0,xmlnsXlink:"xmlns:xlink",xmlLang:"xml:lang",xmlSpace:"xml:space",y:0,y1:0,y2:0,yChannelSelector:"yChannelSelector",z:0,zoomAndPan:"zoomAndPan"},o={Properties:{},DOMAttributeNamespaces:{xlinkActuate:n.xlink,xlinkArcrole:n.xlink,xlinkHref:n.xlink,xlinkRole:n.xlink,xlinkShow:n.xlink,xlinkTitle:n.xlink,xlinkType:n.xlink,xmlBase:n.xml,xmlLang:n.xml,xmlSpace:n.xml},DOMAttributeNames:{}};Object.keys(r).forEach(function(e){o.Properties[e]=0,r[e]&&(o.DOMAttributeNames[e]=r[e])}),e.exports=o},function(e,t,n){"use strict";function r(e){if("selectionStart"in e&&u.hasSelectionCapabilities(e))return{start:e.selectionStart,end:e.selectionEnd};if(window.getSelection){var t=window.getSelection();return{anchorNode:t.anchorNode,anchorOffset:t.anchorOffset,focusNode:t.focusNode,focusOffset:t.focusOffset}}if(document.selection){var n=document.selection.createRange();return{parentElement:n.parentElement(),text:n.text,top:n.boundingTop,left:n.boundingLeft}}}function o(e,t){if(y||null==m||m!==c())return null;var n=r(m);if(!g||!f(g,n)){g=n;var o=l.getPooled(h.select,v,e,t);return o.type="select",o.target=m,i.accumulateTwoPhaseDispatches(o),o}return null}var i=n(25),a=n(7),s=n(6),u=n(72),l=n(11),c=n(59),p=n(81),f=n(36),d=a.canUseDOM&&"documentMode"in document&&document.documentMode<=11,h={select:{phasedRegistrationNames:{bubbled:"onSelect",captured:"onSelectCapture"},dependencies:["topBlur","topContextMenu","topFocus","topKeyDown","topKeyUp","topMouseDown","topMouseUp","topSelectionChange"]}},m=null,v=null,g=null,y=!1,b=!1,C={eventTypes:h,extractEvents:function(e,t,n,r){if(!b)return null;var i=t?s.getNodeFromInstance(t):window;switch(e){case"topFocus":(p(i)||"true"===i.contentEditable)&&(m=i,v=t,g=null);break;case"topBlur":m=null,v=null,g=null;break;case"topMouseDown":y=!0;break;case"topContextMenu":case"topMouseUp":return y=!1,o(n,r);case"topSelectionChange":if(d)break;case"topKeyDown":case"topKeyUp":return o(n,r)}return null},didPutListener:function(e,t,n){"onSelect"===t&&(b=!0)}};e.exports=C},function(e,t,n){"use strict";function r(e){return"."+e._rootNodeID}function o(e){return"button"===e||"input"===e||"select"===e||"textarea"===e}var i=n(3),a=n(57),s=n(25),u=n(6),l=n(168),c=n(169),p=n(11),f=n(172),d=n(174),h=n(30),m=n(171),v=n(175),g=n(176),y=n(27),b=n(177),C=n(8),_=n(47),w=(n(1),{}),E={};["abort","animationEnd","animationIteration","animationStart","blur","canPlay","canPlayThrough","click","contextMenu","copy","cut","doubleClick","drag","dragEnd","dragEnter","dragExit","dragLeave","dragOver","dragStart","drop","durationChange","emptied","encrypted","ended","error","focus","input","invalid","keyDown","keyPress","keyUp","load","loadedData","loadedMetadata","loadStart","mouseDown","mouseMove","mouseOut","mouseOver","mouseUp","paste","pause","play","playing","progress","rateChange","reset","scroll","seeked","seeking","stalled","submit","suspend","timeUpdate","touchCancel","touchEnd","touchMove","touchStart","transitionEnd","volumeChange","waiting","wheel"].forEach(function(e){var t=e[0].toUpperCase()+e.slice(1),n="on"+t,r="top"+t,o={phasedRegistrationNames:{bubbled:n,captured:n+"Capture"},dependencies:[r]};w[e]=o,E[r]=o});var T={},x={eventTypes:w,extractEvents:function(e,t,n,r){var o=E[e];if(!o)return null;var a;switch(e){case"topAbort":case"topCanPlay":case"topCanPlayThrough":case"topDurationChange":case"topEmptied":case"topEncrypted":case"topEnded":case"topError":case"topInput":case"topInvalid":case"topLoad":case"topLoadedData":case"topLoadedMetadata":case"topLoadStart":case"topPause":case"topPlay":case"topPlaying":case"topProgress":case"topRateChange":case"topReset":case"topSeeked":case"topSeeking":case"topStalled":case"topSubmit":case"topSuspend":case"topTimeUpdate":case"topVolumeChange":case"topWaiting":a=p;break;case"topKeyPress":if(0===_(n))return null;case"topKeyDown":case"topKeyUp":a=d;break;case"topBlur":case"topFocus":a=f;break;case"topClick":if(2===n.button)return null;case"topDoubleClick":case"topMouseDown":case"topMouseMove":case"topMouseUp":case"topMouseOut":case"topMouseOver":case"topContextMenu":a=h;break;case"topDrag":case"topDragEnd":case"topDragEnter":case"topDragExit":case"topDragLeave":case"topDragOver":case"topDragStart":case"topDrop":a=m;break;case"topTouchCancel":case"topTouchEnd":case"topTouchMove":case"topTouchStart":a=v;break;case"topAnimationEnd":case"topAnimationIteration":case"topAnimationStart":a=l;break;case"topTransitionEnd":a=g;break;case"topScroll":a=y;break;case"topWheel":a=b;break;case"topCopy":case"topCut":case"topPaste":a=c}a?void 0:i("86",e);var u=a.getPooled(o,t,n,r);return s.accumulateTwoPhaseDispatches(u),u},didPutListener:function(e,t,n){if("onClick"===t&&!o(e._tag)){var i=r(e),s=u.getNodeFromInstance(e);T[i]||(T[i]=a.listen(s,"click",C))}},willDeleteListener:function(e,t){if("onClick"===t&&!o(e._tag)){var n=r(e);T[n].remove(),delete T[n]}}};e.exports=x},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(11),i={animationName:null,elapsedTime:null,pseudoElement:null};o.augmentClass(r,i),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(11),i={clipboardData:function(e){return"clipboardData"in e?e.clipboardData:window.clipboardData}};o.augmentClass(r,i),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(11),i={data:null};o.augmentClass(r,i),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(30),i={dataTransfer:null};o.augmentClass(r,i),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(27),i={relatedTarget:null};o.augmentClass(r,i),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(11),i={data:null};o.augmentClass(r,i),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(27),i=n(47),a=n(182),s=n(48),u={key:a,location:null,ctrlKey:null,shiftKey:null,altKey:null,metaKey:null,repeat:null,locale:null,getModifierState:s,charCode:function(e){return"keypress"===e.type?i(e):0},keyCode:function(e){return"keydown"===e.type||"keyup"===e.type?e.keyCode:0},which:function(e){return"keypress"===e.type?i(e):"keydown"===e.type||"keyup"===e.type?e.keyCode:0}};o.augmentClass(r,u),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(27),i=n(48),a={touches:null,targetTouches:null,changedTouches:null,altKey:null,metaKey:null,ctrlKey:null,shiftKey:null,getModifierState:i};o.augmentClass(r,a),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(11),i={propertyName:null,elapsedTime:null,pseudoElement:null};o.augmentClass(r,i),e.exports=r},function(e,t,n){"use strict";function r(e,t,n,r){return o.call(this,e,t,n,r)}var o=n(30),i={deltaX:function(e){return"deltaX"in e?e.deltaX:"wheelDeltaX"in e?-e.wheelDeltaX:0},deltaY:function(e){return"deltaY"in e?e.deltaY:"wheelDeltaY"in e?-e.wheelDeltaY:"wheelDelta"in e?-e.wheelDelta:0},deltaZ:null,deltaMode:null};o.augmentClass(r,i),e.exports=r},function(e,t){"use strict";function n(e){for(var t=1,n=0,o=0,i=e.length,a=i&-4;o<a;){for(var s=Math.min(o+4096,a);o<s;o+=4)n+=(t+=e.charCodeAt(o))+(t+=e.charCodeAt(o+1))+(t+=e.charCodeAt(o+2))+(t+=e.charCodeAt(o+3));t%=r,n%=r}for(;o<i;o++)n+=t+=e.charCodeAt(o);return t%=r,n%=r,t|n<<16}var r=65521;e.exports=n},function(e,t,n){"use strict";function r(e,t,n){var r=null==t||"boolean"==typeof t||""===t;if(r)return"";var o=isNaN(t);if(o||0===t||i.hasOwnProperty(e)&&i[e])return""+t;if("string"==typeof t){t=t.trim()}return t+"px"}var o=n(64),i=(n(2),o.isUnitlessNumber);e.exports=r},function(e,t,n){"use strict";function r(e){if(null==e)return null;if(1===e.nodeType)return e;var t=a.get(e);return t?(t=s(t),t?i.getNodeFromInstance(t):null):void("function"==typeof e.render?o("44"):o("45",Object.keys(e)))}var o=n(3),i=(n(12),n(6)),a=n(26),s=n(78);n(1),n(2);e.exports=r},function(e,t,n){(function(t){"use strict";function r(e,t,n,r){if(e&&"object"==typeof e){var o=e,i=void 0===o[n];i&&null!=t&&(o[n]=t)}}function o(e,t){if(null==e)return e;var n={};return i(e,r,n),n}var i=(n(41),n(83));n(2);e.exports=o}).call(t,n(60))},function(e,t,n){"use strict";function r(e){if(e.key){var t=i[e.key]||e.key;if("Unidentified"!==t)return t}if("keypress"===e.type){var n=o(e);return 13===n?"Enter":String.fromCharCode(n)}return"keydown"===e.type||"keyup"===e.type?a[e.keyCode]||"Unidentified":""}var o=n(47),i={Esc:"Escape",Spacebar:" ",Left:"ArrowLeft",Up:"ArrowUp",Right:"ArrowRight",Down:"ArrowDown",Del:"Delete",Win:"OS",Menu:"ContextMenu",Apps:"ContextMenu",Scroll:"ScrollLock",MozPrintableKey:"Unidentified"},a={8:"Backspace",9:"Tab",12:"Clear",13:"Enter",16:"Shift",17:"Control",18:"Alt",19:"Pause",20:"CapsLock",27:"Escape",32:" ",33:"PageUp",34:"PageDown",35:"End",36:"Home",37:"ArrowLeft",38:"ArrowUp",39:"ArrowRight",40:"ArrowDown",45:"Insert",46:"Delete",112:"F1",113:"F2",114:"F3",115:"F4",116:"F5",117:"F6",118:"F7",119:"F8",120:"F9",121:"F10",122:"F11",123:"F12",144:"NumLock",145:"ScrollLock",224:"Meta"};e.exports=r},function(e,t){"use strict";function n(e){var t=e&&(r&&e[r]||e[o]);if("function"==typeof t)return t}var r="function"==typeof Symbol&&Symbol.iterator,o="@@iterator";e.exports=n},function(e,t){"use strict";function n(e){for(;e&&e.firstChild;)e=e.firstChild;return e}function r(e){for(;e;){if(e.nextSibling)return e.nextSibling;e=e.parentNode}}function o(e,t){for(var o=n(e),i=0,a=0;o;){if(3===o.nodeType){if(a=i+o.textContent.length,i<=t&&a>=t)return{node:o,offset:t-i};i=a}o=n(r(o))}}e.exports=o},function(e,t,n){"use strict";function r(e,t){var n={};return n[e.toLowerCase()]=t.toLowerCase(),n["Webkit"+e]="webkit"+t,n["Moz"+e]="moz"+t,n["ms"+e]="MS"+t,n["O"+e]="o"+t.toLowerCase(),n}function o(e){if(s[e])return s[e];if(!a[e])return e;var t=a[e];for(var n in t)if(t.hasOwnProperty(n)&&n in u)return s[e]=t[n];return""}var i=n(7),a={animationend:r("Animation","AnimationEnd"),animationiteration:r("Animation","AnimationIteration"),animationstart:r("Animation","AnimationStart"),transitionend:r("Transition","TransitionEnd")},s={},u={};i.canUseDOM&&(u=document.createElement("div").style,"AnimationEvent"in window||(delete a.animationend.animation,delete a.animationiteration.animation,delete a.animationstart.animation),"TransitionEvent"in window||delete a.transitionend.transition),e.exports=o},function(e,t,n){"use strict";function r(e){return'"'+o(e)+'"'}var o=n(32);e.exports=r},function(e,t,n){"use strict";var r=n(73);e.exports=r.renderSubtreeIntoContainer},function(e,t,n){"use strict";"undefined"==typeof Promise&&(n(120).enable(),window.Promise=n(119)),n(226),Object.assign=n(4)},113,114,115,116,117,function(e,t,n){(function(){var t,r,o;t=n(5),r=t.createClass,o=t.DOM.div,e.exports=r({getDefaultProps:function(){return{className:"",onHeightChange:function(){}}},render:function(){return o({className:this.props.className,ref:"dropdown"},this.props.children)},componentDidMount:function(){this.props.onHeightChange(this.refs.dropdown.offsetHeight)},componentDidUpdate:function(){this.props.onHeightChange(this.refs.dropdown.offsetHeight)},componentWillUnmount:function(){this.props.onHeightChange(0)}})}).call(this)},function(e,t,n){(function(){function t(e,t){var n={}.hasOwnProperty;for(var r in t)n.call(t,r)&&(e[r]=t[r]);return e}var r,o,i,a,s,u,l,c,p,f,d,h,m,v,g,y,b,C;r=n(15),o=r.filter,i=r.id,a=r.map,s=n(16).isEqualToObject,u=n(5),r=u.DOM,l=r.div,c=r.input,p=r.span,f=u.createClass,d=u.createFactory,h=n(13).findDOMNode,m=d(n(63)),v=d(n(198)),g=d(n(194)),y=d(n(84)),r=n(28),b=r.cancelEvent,C=r.classNameFromObject,e.exports=f({displayName:"DropdownMenu",getDefaultProps:function(){return{className:"",dropdownDirection:1,groupId:function(e){return e.groupId},groupsAsColumns:!1,highlightedUid:void 0,onHighlightedUidChange:function(e,t){},onOptionClick:function(e){},onScrollLockChange:function(e){},options:[],renderNoResultsFound:function(){return l({className:"no-results-found"},"No results found")},renderGroupTitle:function(e,t){var n,r;return null!=t&&(n=t.groupId,r=t.title),l({className:"simple-group-title",key:n},r)},renderOption:function(e){var t,n,r,o;return null!=e&&(t=e.label,n=e.newOption,r=e.selectable),o="undefined"==typeof r||r,l({className:"simple-option "+(o?"":"not-selectable")},p(null,n?"Add "+t+" ...":t))},scrollLock:!1,style:{},tether:!1,tetherProps:{},theme:"default",transitionEnter:!1,transitionLeave:!1,transitionEnterTimeout:200,transitionLeaveTimeout:200,uid:i}},render:function(){var e,n;return e=C((n={},n[this.props.theme+""]=1,n[this.props.className+""]=1,n.flipped=this.props.dropdownDirection===-1,n.tethered=this.props.tether,n)),this.props.tether?v((n=t({},this.props.tetherProps),n.options={attachment:"top left",targetAttachment:"bottom left",constraints:[{to:"scrollParent"}]},n),this.renderAnimatedDropdown({dynamicClassName:e})):this.renderAnimatedDropdown({dynamicClassName:e})},renderAnimatedDropdown:function(e){var t;return t=e.dynamicClassName,this.props.transitionEnter||this.props.transitionLeave?m({component:"div",transitionName:"custom",transitionEnter:this.props.transitionEnter,transitionLeave:this.props.transitionLeave,transitionEnterTimeout:this.props.transitionEnterTimeout,transitionLeaveTimeout:this.props.transitionLeaveTimeout,className:"dropdown-menu-wrapper "+t,ref:"dropdownMenuWrapper"},this.renderDropdown(e)):this.renderDropdown(e)},renderOptions:function(e){var n=this;return a(function(r){var o,i;return o=e[r],i=n.props.uid(o),y(t({uid:i,ref:"option-"+n.uidToString(i),key:n.uidToString(i),item:o,highlight:s(n.props.highlightedUid,i),selectable:null!=o?o.selectable:void 0,onMouseMove:function(e){var t;t=e.currentTarget,n.props.scrollLock&&n.props.onScrollLockChange(!1)},onMouseOut:function(){n.props.scrollLock||n.props.onHighlightedUidChange(void 0,function(){})},renderItem:n.props.renderOption},function(){switch(!1){case!("boolean"==typeof(null!=o?o.selectable:void 0)&&!o.selectable):return{onClick:b};default:return{onClick:function(){n.props.onOptionClick(n.props.highlightedUid)},onMouseOver:function(e){var t;t=e.currentTarget,n.props.scrollLock||n.props.onHighlightedUidChange(i,function(){})}}}}()))})(function(){var t,n,r=[];for(t=0,n=e.length;t<n;++t)r.push(t);return r}())},renderDropdown:function(e){var t,n,r,i,s=this;return t=e.dynamicClassName,this.props.open?g({className:"dropdown-menu "+t,ref:"dropdownMenu",onHeightChange:function(e){s.refs.dropdownMenuWrapper&&(h(s.refs.dropdownMenuWrapper).style.height=e+"px")}},0===this.props.options.length?this.props.renderNoResultsFound():(null!=(n=this.props)&&null!=(r=n.groups)?r.length:void 0)>0?(i=a(function(e){var t,n,r;return t=s.props.groups[e],n=t.groupId,r=o(function(e){return s.props.groupId(e)===n})(s.props.options),{index:e,group:t,options:r}})(function(){var e,t,n=[];for(e=0,t=this.props.groups.length;e<t;++e)n.push(e);return n}.call(this)),l({className:"groups "+(this.props.groupsAsColumns?"as-columns":"")},a(function(e){var t,n,r,o;return t=e.index,n=e.group,r=n.groupId,o=e.options,l({key:r},s.props.renderGroupTitle(t,n,o),l({className:"options"},s.renderOptions(o)))})(o(function(e){return e.options.length>0})(i)))):this.renderOptions(this.props.options)):null},componentDidUpdate:function(){var e,t,n;e=t=h(null!=(n=this.refs.dropdownMenuWrapper)?n:this.refs.dropdownMenu),null!=e&&(e.style.bottom=function(){switch(!1){case this.props.dropdownDirection!==-1:return this.props.bottomAnchor().offsetHeight+t.style.marginBottom+"px";default:return""}}.call(this))},highlightAndScrollToOption:function(e,t){var n,r=this;null==t&&(t=function(){}),n=this.props.uid(this.props.options[e]),this.props.onHighlightedUidChange(n,function(){var e,o,i,a,s;return null!=(e=h(null!=(o=r.refs)?o["option-"+r.uidToString(n)]:void 0))&&(i=e),i&&(a=h(r.refs.dropdownMenu),s=i.offsetHeight-1,i.offsetTop-a.scrollTop>=a.offsetHeight?a.scrollTop=i.offsetTop-a.offsetHeight+s:i.offsetTop-a.scrollTop+s<=0&&(a.scrollTop=i.offsetTop)),t()})},highlightAndScrollToSelectableOption:function(e,t,n){var r,o,i;null==n&&(n=function(){}),e<0||e>=this.props.options.length?this.props.onHighlightedUidChange(void 0,function(){return n(!1)}):(r=null!=(o=this.props)&&null!=(i=o.options)?i[e]:void 0,"boolean"!=typeof(null!=r?r.selectable:void 0)||r.selectable?this.highlightAndScrollToOption(e,function(){return n(!0)}):this.highlightAndScrollToSelectableOption(e+t,t,n))},uidToString:function(e){return("object"==typeof e?JSON.stringify:i)(e)}})}).call(this)},function(e,t,n){(function(){var t,r,o,i,a,s;t=n(5),r=t.createClass,o=t.DOM,i=o.div,a=o.span,s=n(15).map,e.exports=r({getDefaultProps:function(){return{partitions:[],text:"",style:{},highlightStyle:{}}},render:function(){var e=this;return i({className:"highlighted-text",style:this.props.style},s(function(t){var n,r,o;return n=t[0],r=t[1],o=t[2],a({key:e.props.text+""+n+r+o,className:o?"highlight":"",style:o?e.props.highlightStyle:{}},e.props.text.substring(n,r))})(this.props.partitions))}})}).call(this)},function(e,t,n){(function(){function t(e,t){for(var n=-1,r=t.length>>>0;++n<r;)if(e===t[n])return!0;return!1}function r(e,t){var n,r=function(o){return e.length>1?function(){var i=o?o.concat():[];return n=t?n||this:this,i.push.apply(i,arguments)<e.length&&arguments.length?r.call(n,i):e.apply(n,i)}:e};return r()}function o(e,t){var n={}.hasOwnProperty;for(var r in t)n.call(t,r)&&(e[r]=t[r]);return e}var i,a,s,u,l,c,p,f,d,h,m,v,g,y,b,C,_,w,E,T,x,O={}.toString;i=n(15),a=i.all,s=i.any,u=i.camelize,l=i.difference,c=i.drop,p=i.filter,f=i.find,d=i.findIndex,h=i.id,m=i.last,v=i.map,g=i.reject,y=n(16).isEqualToObject,b=n(5),C=b.createFactory,i=b.DOM,_=i.div,w=i.img,E=i.span,T=C(n(53)),x=n(28).cancelEvent,e.exports=b.createClass({displayName:"MultiSelect",getDefaultProps:function(){return{className:"",closeOnSelect:!1,defaultValues:[],delimiters:[],filterOptions:r(function(e,n,r){return p(function(e){return e.label.toLowerCase().trim().indexOf(r.toLowerCase().trim())>-1})(g(function(e){return t(e.label.trim(),v(function(e){return e.label.trim()},null!=n?n:[]))})(e))}),firstOptionIndexToHighlight:h,onBlur:function(e){},onFocus:function(e){},onPaste:function(e){},serialize:v(function(e){return null!=e?e.value:void 0}),tether:!1}},render:function(){var e,t,n,r,i,a,s,u,l,c,p,f,d,h,v,g,y,b,C,_,w,E,O,P,k,S,N,M,A,I,D,R,L,U,F,j,B,V,W=this;return e=this.getComputedState(),t=e.anchor,n=e.filteredOptions,r=e.highlightedUid,i=e.onAnchorChange,a=e.onOpenChange,s=e.onHighlightedUidChange,u=e.onSearchChange,l=e.onValuesChange,c=e.search,p=e.open,f=e.options,d=e.values,null!=(e=this.props)&&(h=e.autofocus,v=e.autosize,g=e.cancelKeyboardEventOnSelection,y=e.delimiters,b=e.disabled,C=e.dropdownDirection,_=e.groupId,w=e.groups,E=e.groupsAsColumns,O=e.hideResetButton,P=e.inputProps,k=e.name,S=e.onKeyboardSelectionFailed,N=e.renderToggleButton,M=e.renderGroupTitle,A=e.renderResetButton,I=e.serialize,D=e.tether,R=e.tetherProps,L=e.theme,U=e.transitionEnter,F=e.transitionLeave,j=e.transitionEnterTimeout,B=e.transitionLeaveTimeout,V=e.uid),T(o(o({autofocus:h,autosize:v,cancelKeyboardEventOnSelection:g,className:"multi-select "+this.props.className,delimiters:y,disabled:b,dropdownDirection:C,groupId:_,groups:w,groupsAsColumns:E,hideResetButton:O,highlightedUid:r,onHighlightedUidChange:s,inputProps:P,name:k,onKeyboardSelectionFailed:S,renderGroupTitle:M,renderResetButton:A,renderToggleButton:N,scrollLock:this.state.scrollLock,onScrollLockChange:function(e){return W.setState({scrollLock:e})},tether:D,tetherProps:R,theme:L,transitionEnter:U,transitionEnterTimeout:j,transitionLeave:F,transitionLeaveTimeout:B,uid:V,ref:"select",anchor:t,onAnchorChange:i,open:p,onOpenChange:a,options:f,renderOption:this.props.renderOption,firstOptionIndexToHighlight:function(){return W.firstOptionIndexToHighlight(f)},search:c,onSearchChange:function(e,t){return u(W.props.maxValues&&d.length>=W.props.maxValues?"":e,t)},values:d,onValuesChange:function(e,t){return l(e,function(){if(t(),W.props.closeOnSelect||W.props.maxValues&&W.values().length>=W.props.maxValues)return a(!1,function(){})})},renderValue:this.props.renderValue,serialize:I,onBlur:function(e){u("",function(){return W.props.onBlur({open:p,values:d,originalEvent:e})})},onFocus:function(e){W.props.onFocus({open:p,values:d,originalEvent:e})},onPaste:function(){var e;switch(!1){case"undefined"!=typeof(null!=(e=this.props)?e.valuesFromPaste:void 0):return this.props.onPaste;default:return function(e){var t;return t=e.clipboardData,function(){var e;return e=d.concat(W.props.valuesFromPaste(f,d,t.getData("text"))),l(e,function(){return i(m(e))})}(),x(e)}}}.call(this),placeholder:this.props.placeholder,style:this.props.style},function(){switch(!1){case"function"!=typeof this.props.restoreOnBackspace:return{restoreOnBackspace:this.props.restoreOnBackspace};default:return{}}}.call(this)),function(){switch(!1){case"function"!=typeof this.props.renderNoResultsFound:return{renderNoResultsFound:function(){return W.props.renderNoResultsFound(d,c)}};default:return{}}}.call(this)))},getComputedState:function(){var e,t,n,r,i,a,s,l,c,p,f,d,h,m,g,y,b=this;return e=this.props.hasOwnProperty("anchor")?this.props.anchor:this.state.anchor,t=this.props.hasOwnProperty("highlightedUid")?this.props.highlightedUid:this.state.highlightedUid,n=this.isOpen(),r=this.props.hasOwnProperty("search")?this.props.search:this.state.search,i=this.values(),a=v(function(e){switch(!1){case!(b.props.hasOwnProperty(e)&&b.props.hasOwnProperty(u("on-"+e+"-change"))):return function(t,n){return b.props[u("on-"+e+"-change")](t,function(){}),b.setState({},n)};case!(b.props.hasOwnProperty(e)&&!b.props.hasOwnProperty(u("on-"+e+"-change"))):return function(e,t){return t()};case!(!b.props.hasOwnProperty(e)&&b.props.hasOwnProperty(u("on-"+e+"-change"))):return function(t,n){var r;return b.setState((r={},r[e+""]=t,r),function(){return n(),b.props[u("on-"+e+"-change")](t,function(){})})};case!(!b.props.hasOwnProperty(e)&&!b.props.hasOwnProperty(u("on-"+e+"-change"))):return function(t,n){var r;return b.setState((r={},r[e+""]=t,r),n)}}})(["anchor","highlightedUid","open","search","values"]),s=a[0],l=a[1],c=a[2],p=a[3],f=a[4],d=function(){var e;switch(!1){case!(null!=(e=this.props)&&e.children):return v(function(e){var t,n,r;return null!=e&&(t=e.props),null!=t&&(n=t.value,r=t.children),{label:r,value:n}})("Array"===O.call(this.props.children).slice(8,-1)?this.props.children:[this.props.children]);default:return[]}}.call(this),h=this.props.hasOwnProperty("options")?null!=(a=this.props.options)?a:[]:d,m=this.props.filterOptions(h,i,r),g=function(){switch(!1){case"function"!=typeof this.props.createFromSearch:return this.props.createFromSearch(m,i,r);default:return null}}.call(this),y=(g?[(a=o({},g),a.newOption=!0,a)]:[]).concat(m),{anchor:e,highlightedUid:t,search:r,values:i,onAnchorChange:s,onHighlightedUidChange:l,open:n,onOpenChange:function(e,t){c(function(){switch(!1){case!("undefined"!=typeof this.props.maxValues&&this.values().length>=this.props.maxValues):return!1;default:return e}}.call(b),t)},onSearchChange:p,onValuesChange:f,filteredOptions:m,options:y}},getInitialState:function(){return{anchor:this.props.values?m(this.props.values):void 0,highlightedUid:void 0,open:!1,scrollLock:!1,search:"",values:this.props.defaultValues}},firstOptionIndexToHighlight:function(e){var t,n;return t=function(){var t;switch(!1){case 1!==e.length:return 0;case"undefined"!=typeof(null!=(t=e[0])?t.newOption:void 0):return 0;default:return a(function(e){return"boolean"==typeof e.selectable&&!e.selectable})(c(1)(e))?0:1}}(),n=this.props.hasOwnProperty("search")?this.props.search:this.state.search,this.props.firstOptionIndexToHighlight(t,e,this.values(),n)},focus:function(){this.refs.select.focus()},blur:function(){this.refs.select.blur()},highlightFirstSelectableOption:function(){this.state.open&&this.refs.select.highlightAndScrollToSelectableOption(this.firstOptionIndexToHighlight(this.getComputedState().options),1)},values:function(){return this.props.hasOwnProperty("values")?this.props.values:this.state.values},isOpen:function(){return this.props.hasOwnProperty("open")?this.props.open:this.state.open}})}).call(this)},function(e,t,n){(function(){function t(e,t){var n={}.hasOwnProperty;for(var r in t)n.call(t,r)&&(e[r]=t[r]);return e}var r,o,i,a,s,u;r=n(5).createClass,o=n(13),i=o.render,a=o.unmountComponentAtNode,s=n(124),u=n(224),e.exports=r({getDefaultProps:function(){return{parentElement:function(){return document.body}}},render:function(){
+return null},initTether:function(e){var n=this;this.node=document.createElement("div"),this.props.parentElement().appendChild(this.node),this.tether=new u(t({element:this.node,target:e.target()},e.options)),i(e.children,this.node,function(){return n.tether.position()})},destroyTether:function(){this.tether&&this.tether.destroy(),this.node&&(a(this.node),this.node.parentElement.removeChild(this.node)),this.node=this.tether=void 0},componentDidMount:function(){this.props.children&&this.initTether(this.props)},componentWillReceiveProps:function(e){var n=this;this.props.children&&!e.children?this.destroyTether():e.children&&!this.props.children?this.initTether(e):e.children&&(this.tether.setOptions(t({element:this.node,target:e.target()},e.options)),i(e.children,this.node,function(){return n.tether.position()}))},shouldComponentUpdate:function(e,t){return s(this,e,t)},componentWillUnmount:function(){this.destroyTether()}})}).call(this)},function(e,t,n){(function(){var t,r,o,i,a;t=n(5),r=t.createClass,o=t.createFactory,i=t.DOM.path,a=o(n(85)),e.exports=r({render:function(){return a({className:"react-selectize-reset-button",style:{width:8,height:8}},i({d:"M0 0 L8 8 M8 0 L 0 8"}))}})}).call(this)},function(e,t,n){(function(){function t(e,t){var n={}.hasOwnProperty;for(var r in t)n.call(t,r)&&(e[r]=t[r]);return e}var r,o,i,a,s,u,l,c;r=n(15),o=r.each,i=r.objToPairs,a=n(5),s=a.DOM.input,u=a.createClass,l=a.createFactory,c=n(13).findDOMNode,e.exports=u({displayName:"ResizableInput",render:function(){var e;return s((e=t({},this.props),e.type="input",e.className="resizable-input",e))},autosize:function(){var e,t,n,r,a;return e=t=c(this),e.style.width="0px",0===t.value.length?t.style.width=null!=t&&t.currentStyle?"4px":"2px":t.scrollWidth>0?t.style.width=2+t.scrollWidth+"px":(n=r=document.createElement("div"),n.innerHTML=t.value,function(){var e;return e=r.style,e.display="inline-block",e.width="",e}(o(function(e){var t,n;return t=e[0],n=e[1],r.style[t]=n})(i(t.currentStyle?t.currentStyle:null!=(a=document.defaultView)?a:window.getComputedStyle(t)))),document.body.appendChild(r),t.style.width=4+r.clientWidth+"px",document.body.removeChild(r))},componentDidMount:function(){this.autosize()},componentDidUpdate:function(){this.autosize()},blur:function(){return c(this).blur()},focus:function(){return c(this).focus()}})}).call(this)},function(e,t,n){(function(){function t(e,t){var n,r=function(o){return e.length>1?function(){var i=o?o.concat():[];return n=t?n||this:this,i.push.apply(i,arguments)<e.length&&arguments.length?r.call(n,i):e.apply(n,i)}:e};return r()}function r(e,t){var n={}.hasOwnProperty;for(var r in t)n.call(t,r)&&(e[r]=t[r]);return e}var o,i,a,s,u,l,c,p,f,d,h,m,v,g,y,b,C,_,w,E,T,x={}.toString;o=n(15),i=o.all,a=o.any,s=o.drop,u=o.camelize,l=o.difference,c=o.filter,p=o.find,f=o.findIndex,d=o.id,h=o.last,m=o.map,v=o.reject,g=n(16).isEqualToObject,y=n(5),b=y.createFactory,o=y.DOM,C=o.div,_=o.img,w=o.span,E=b(n(53)),T=n(28).cancelEvent,e.exports=y.createClass({displayName:"SimpleSelect",getDefaultProps:function(){return{delimiters:[],filterOptions:t(function(e,t){return c(function(e){return e.label.toLowerCase().trim().indexOf(t.toLowerCase().trim())>-1})(e)}),firstOptionIndexToHighlight:d,onBlur:function(e){},onBlurResetsInput:!0,onFocus:function(e){},onKeyboardSelectionFailed:function(e){},onPaste:function(e){},placeholder:"",renderValue:function(e){var t;return t=e.label,C({className:"simple-value"},w(null,t))},serialize:function(e){return null!=e?e.value:void 0},style:{},tether:!1,uid:d}},render:function(){var e,t,n,o,i,a,s,u,l,c,p,f,d,m,v,y,b,C,_,w,x,O,P,k,S,N,M,A,I,D,R,L,U,F,j,B,V,W=this;return e=this.getComputedState(),t=e.filteredOptions,n=e.highlightedUid,o=e.onHighlightedUidChange,i=e.onOpenChange,a=e.onSearchChange,s=e.onValueChange,u=e.open,l=e.options,c=e.search,p=e.value,f=e.values,null!=(e=this.props)&&(d=e.autofocus,m=e.autosize,v=e.cancelKeyboardEventOnSelection,y=e.delimiters,b=e.disabled,C=e.dropdownDirection,_=e.groupId,w=e.groups,x=e.groupsAsColumns,O=e.hideResetButton,P=e.name,k=e.inputProps,S=e.onBlurResetsInput,N=e.renderToggleButton,M=e.renderGroupTitle,A=e.renderResetButton,I=e.serialize,D=e.tether,R=e.tetherProps,L=e.theme,U=e.transitionEnter,F=e.transitionLeave,j=e.transitionEnterTimeout,B=e.transitionLeaveTimeout,V=e.uid),E(r(r({autofocus:d,autosize:m,cancelKeyboardEventOnSelection:v,className:"simple-select"+(this.props.className?" "+this.props.className:""),delimiters:y,disabled:b,dropdownDirection:C,groupId:_,groups:w,groupsAsColumns:x,hideResetButton:O,highlightedUid:n,onHighlightedUidChange:o,inputProps:k,name:P,onBlurResetsInput:S,renderGroupTitle:M,renderResetButton:A,renderToggleButton:N,scrollLock:this.state.scrollLock,onScrollLockChange:function(e){return W.setState({scrollLock:e})},tether:D,tetherProps:R,theme:L,transitionEnter:U,transitionEnterTimeout:j,transitionLeave:F,transitionLeaveTimeout:B,ref:"select",anchor:h(f),onAnchorChange:function(e,t){return t()},open:u,onOpenChange:i,firstOptionIndexToHighlight:function(){return W.firstOptionIndexToHighlight(l,p)},options:l,renderOption:this.props.renderOption,renderNoResultsFound:this.props.renderNoResultsFound,search:c,onSearchChange:function(e,t){return a(e,t)},values:f,onValuesChange:function(e,t){var n,r;return 0===e.length?s(void 0,function(){return t()}):(n=h(e),r=!g(n,p),function(){return function(e){return r?s(n,e):e()}}()(function(){return t(),i(!1,function(){})}))},renderValue:function(e){return u&&(W.props.editable||c.length>0)?null:W.props.renderValue(e)},onKeyboardSelectionFailed:function(e){return a("",function(){return i(!1,function(){return W.props.onKeyboardSelectionFailed(e)})})},uid:function(e){return{uid:W.props.uid(e),open:u,search:c}},serialize:function(e){return I(e[0])},onBlur:function(e){var t;t=W.props.onBlurResetsInput,function(){return function(e){return c.length>0&&t?a("",e):e()}}()(function(){return W.props.onBlur({value:p,open:u,originalEvent:e})})},onFocus:function(e){W.props.onFocus({value:p,open:u,originalEvent:e})},onPaste:function(){var e;switch(!1){case"undefined"!=typeof(null!=(e=this.props)?e.valueFromPaste:void 0):return this.props.onPaste;default:return function(e){var t,n;if(t=e.clipboardData,n=W.props.valueFromPaste(l,p,t.getData("text")))return function(){return s(n,function(){return a("",function(){return i(!1)})})}(),T(e)}}}.call(this),placeholder:this.props.placeholder,style:this.props.style},function(){switch(!1){case"function"!=typeof this.props.restoreOnBackspace:return{restoreOnBackspace:this.props.restoreOnBackspace};default:return{}}}.call(this)),function(){switch(!1){case"function"!=typeof this.props.renderNoResultsFound:return{renderNoResultsFound:function(){return W.props.renderNoResultsFound(p,c)}};default:return{}}}.call(this)))},getComputedState:function(){var e,t,n,o,i,a,s,l,c,p,f,d,h,v,g,y=this;return e=this.props.hasOwnProperty("highlightedUid")?this.props.highlightedUid:this.state.highlightedUid,t=this.isOpen(),n=this.props.hasOwnProperty("search")?this.props.search:this.state.search,o=this.value(),i=o||0===o?[o]:[],a=m(function(e){var t;return t=function(){switch(!1){case!(this.props.hasOwnProperty(e)&&this.props.hasOwnProperty(u("on-"+e+"-change"))):return function(t,n){return y.props[u("on-"+e+"-change")](t,function(){}),y.setState({},n)};case!(this.props.hasOwnProperty(e)&&!this.props.hasOwnProperty(u("on-"+e+"-change"))):return function(e,t){return t()};case!(!this.props.hasOwnProperty(e)&&this.props.hasOwnProperty(u("on-"+e+"-change"))):return function(t,n){var r;return y.setState((r={},r[e+""]=t,r),function(){return n(),y.props[u("on-"+e+"-change")](t,function(){})})};case!(!this.props.hasOwnProperty(e)&&!this.props.hasOwnProperty(u("on-"+e+"-change"))):return function(t,n){var r;return y.setState((r={},r[e+""]=t,r),n)}}}.call(y)})(["highlightedUid","open","search","value"]),s=a[0],l=a[1],c=a[2],p=a[3],f=function(){var e;switch(!1){case!(null!=(e=this.props)&&e.children):return m(function(e){var t,n,r;return null!=(t=null!=e?e.props:void 0)&&(n=t.value,r=t.children),{label:r,value:n}})("Array"===x.call(this.props.children).slice(8,-1)?this.props.children:[this.props.children]);default:return[]}}.call(this),d=this.props.hasOwnProperty("options")?null!=(a=this.props.options)?a:[]:f,h=this.props.filterOptions(d,n),v=function(){switch(!1){case"function"!=typeof this.props.createFromSearch:return this.props.createFromSearch(h,n);default:return null}}.call(this),g=(v?[(a=r({},v),a.newOption=!0,a)]:[]).concat(h),{highlightedUid:e,open:t,search:n,value:o,values:i,onHighlightedUidChange:s,onOpenChange:function(e,t){l(e,function(){if(t(),y.props.editable&&y.isOpen()&&o)return c(y.props.editable(o)+""+(1===n.length?n:""),function(){return y.highlightFirstSelectableOption(function(){})})})},onSearchChange:c,onValueChange:p,filteredOptions:h,options:g}},getInitialState:function(){var e;return{highlightedUid:void 0,open:!1,scrollLock:!1,search:"",value:null!=(e=this.props)?e.defaultValue:void 0}},firstOptionIndexToHighlight:function(e,t){var n,r,o;return n=t?f(function(e){return g(e,t)},e):void 0,r=function(){var t;switch(!1){case"undefined"==typeof n:return n;case 1!==e.length:return 0;case"undefined"!=typeof(null!=(t=e[0])?t.newOption:void 0):return 0;default:return i(function(e){return"boolean"==typeof e.selectable&&!e.selectable})(s(1)(e))?0:1}}(),o=this.props.hasOwnProperty("search")?this.props.search:this.state.search,this.props.firstOptionIndexToHighlight(r,e,t,o)},focus:function(){this.refs.select.focus()},blur:function(){this.refs.select.blur()},highlightFirstSelectableOption:function(e){var t,n,r;null==e&&(e=function(){}),this.state.open?(t=this.getComputedState(),n=t.options,r=t.value,this.refs.select.highlightAndScrollToSelectableOption(this.firstOptionIndexToHighlight(n,r),1,e)):e()},value:function(){return this.props.hasOwnProperty("value")?this.props.value:this.state.value},isOpen:function(){return this.props.hasOwnProperty("open")?this.props.open:this.state.open}})}).call(this)},function(e,t,n){(function(){var t,r,o,i,a;t=n(5),r=t.createClass,o=t.createFactory,i=t.DOM.path,a=o(n(85)),e.exports=r({getDefaultProps:function(){return{open:!1,flipped:!1}},render:function(){return a({className:"react-selectize-toggle-button",style:{width:10,height:8}},i({d:function(){switch(!1){case!(this.props.open&&!this.props.flipped||!this.props.open&&this.props.flipped):return"M0 6 L5 1 L10 6 Z";default:return"M0 1 L5 6 L10 1 Z"}}.call(this)}))}})}).call(this)},function(e,t,n){(function(){var t,r,o,i;t=n(5),r=t.createClass,o=t.DOM.div,i=n(16).isEqualToObject,e.exports=r({getDefaultProps:function(){return{}},render:function(){return o({className:"value-wrapper"},this.props.renderItem(this.props.item))},shouldComponentUpdate:function(e){var t;return!i(null!=e?e.uid:void 0,null!=(t=this.props)?t.uid:void 0)}})}).call(this)},function(e,t,n){(function(){var t,r,o,i;t=n(196),r=n(201),o=n(197),i=n(53),e.exports={HighlightedText:t,SimpleSelect:r,MultiSelect:o,ReactSelectize:i}}).call(this)},function(e,t,n){"use strict";function r(e){return e&&e.__esModule?e:{default:e}}function o(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function i(e,t){if(!e)throw new ReferenceError("this hasn't been initialised - super() hasn't been called");return!t||"object"!=typeof t&&"function"!=typeof t?e:t}function a(e,t){if("function"!=typeof t&&null!==t)throw new TypeError("Super expression must either be null or a function, not "+typeof t);e.prototype=Object.create(t&&t.prototype,{constructor:{value:e,enumerable:!1,writable:!0,configurable:!0}}),t&&(Object.setPrototypeOf?Object.setPrototypeOf(e,t):e.__proto__=t)}t.__esModule=!0;var s=Object.assign||function(e){for(var t=1;t<arguments.length;t++){var n=arguments[t];for(var r in n)Object.prototype.hasOwnProperty.call(n,r)&&(e[r]=n[r])}return e},u=n(5),l=r(u),c=n(34),p=r(c),f=n(207),d=r(f),h=n(206),m=r(h),v=n(86),g=({transitionName:v.nameShape.isRequired,transitionAppear:p.default.bool,transitionEnter:p.default.bool,transitionLeave:p.default.bool,transitionAppearTimeout:(0,v.transitionTimeout)("Appear"),transitionEnterTimeout:(0,v.transitionTimeout)("Enter"),transitionLeaveTimeout:(0,v.transitionTimeout)("Leave")},{transitionAppear:!1,transitionEnter:!0,transitionLeave:!0}),y=function(e){function t(){var n,r,a;o(this,t);for(var s=arguments.length,u=Array(s),c=0;c<s;c++)u[c]=arguments[c];return n=r=i(this,e.call.apply(e,[this].concat(u))),r._wrapChild=function(e){return l.default.createElement(m.default,{name:r.props.transitionName,appear:r.props.transitionAppear,enter:r.props.transitionEnter,leave:r.props.transitionLeave,appearTimeout:r.props.transitionAppearTimeout,enterTimeout:r.props.transitionEnterTimeout,leaveTimeout:r.props.transitionLeaveTimeout},e)},a=n,i(r,a)}return a(t,e),t.prototype.render=function(){return l.default.createElement(d.default,s({},this.props,{childFactory:this._wrapChild}))},t}(l.default.Component);y.displayName="CSSTransitionGroup",y.propTypes={},y.defaultProps=g,t.default=y,e.exports=t.default},function(e,t,n){"use strict";function r(e){return e&&e.__esModule?e:{default:e}}function o(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function i(e,t){if(!e)throw new ReferenceError("this hasn't been initialised - super() hasn't been called");return!t||"object"!=typeof t&&"function"!=typeof t?e:t}function a(e,t){if("function"!=typeof t&&null!==t)throw new TypeError("Super expression must either be null or a function, not "+typeof t);e.prototype=Object.create(t&&t.prototype,{constructor:{value:e,enumerable:!1,writable:!0,configurable:!0}}),t&&(Object.setPrototypeOf?Object.setPrototypeOf(e,t):e.__proto__=t)}function s(e,t){return w.length?w.forEach(function(n){return e.addEventListener(n,t,!1)}):setTimeout(t,0),function(){w.length&&w.forEach(function(n){return e.removeEventListener(n,t,!1)})}}t.__esModule=!0;var u=Object.assign||function(e){for(var t=1;t<arguments.length;t++){var n=arguments[t];for(var r in n)Object.prototype.hasOwnProperty.call(n,r)&&(e[r]=n[r])}return e},l=n(96),c=r(l),p=n(98),f=r(p),d=n(100),h=r(d),m=n(99),v=n(5),g=r(v),y=n(34),b=r(y),C=n(13),_=n(86),w=[];m.transitionEnd&&w.push(m.transitionEnd),m.animationEnd&&w.push(m.animationEnd);var E=({children:b.default.node,name:_.nameShape.isRequired,appear:b.default.bool,enter:b.default.bool,leave:b.default.bool,appearTimeout:b.default.number,enterTimeout:b.default.number,leaveTimeout:b.default.number},function(e){function t(){var n,r,a;o(this,t);for(var s=arguments.length,u=Array(s),l=0;l<s;l++)u[l]=arguments[l];return n=r=i(this,e.call.apply(e,[this].concat(u))),r.componentWillAppear=function(e){r.props.appear?r.transition("appear",e,r.props.appearTimeout):e()},r.componentWillEnter=function(e){r.props.enter?r.transition("enter",e,r.props.enterTimeout):e()},r.componentWillLeave=function(e){r.props.leave?r.transition("leave",e,r.props.leaveTimeout):e()},a=n,i(r,a)}return a(t,e),t.prototype.componentWillMount=function(){this.classNameAndNodeQueue=[],this.transitionTimeouts=[]},t.prototype.componentWillUnmount=function(){this.unmounted=!0,this.timeout&&clearTimeout(this.timeout),this.transitionTimeouts.forEach(function(e){clearTimeout(e)}),this.classNameAndNodeQueue.length=0},t.prototype.transition=function(e,t,n){var r=(0,C.findDOMNode)(this);if(!r)return void(t&&t());var o=this.props.name[e]||this.props.name+"-"+e,i=this.props.name[e+"Active"]||o+"-active",a=null,u=void 0;(0,c.default)(r,o),this.queueClassAndNode(i,r);var l=function(e){e&&e.target!==r||(clearTimeout(a),u&&u(),(0,f.default)(r,o),(0,f.default)(r,i),u&&u(),t&&t())};n?(a=setTimeout(l,n),this.transitionTimeouts.push(a)):m.transitionEnd&&(u=s(r,l))},t.prototype.queueClassAndNode=function(e,t){var n=this;this.classNameAndNodeQueue.push({className:e,node:t}),this.rafHandle||(this.rafHandle=(0,h.default)(function(){return n.flushClassNameAndNodeQueue()}))},t.prototype.flushClassNameAndNodeQueue=function(){this.unmounted||this.classNameAndNodeQueue.forEach(function(e){e.node.scrollTop,(0,c.default)(e.node,e.className)}),this.classNameAndNodeQueue.length=0,this.rafHandle=null},t.prototype.render=function(){var e=u({},this.props);return delete e.name,delete e.appear,delete e.enter,delete e.leave,delete e.appearTimeout,delete e.enterTimeout,delete e.leaveTimeout,delete e.children,g.default.cloneElement(g.default.Children.only(this.props.children),e)},t}(g.default.Component));E.displayName="CSSTransitionGroupChild",E.propTypes={},t.default=E,e.exports=t.default},function(e,t,n){"use strict";function r(e){return e&&e.__esModule?e:{default:e}}function o(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function i(e,t){if(!e)throw new ReferenceError("this hasn't been initialised - super() hasn't been called");return!t||"object"!=typeof t&&"function"!=typeof t?e:t}function a(e,t){if("function"!=typeof t&&null!==t)throw new TypeError("Super expression must either be null or a function, not "+typeof t);e.prototype=Object.create(t&&t.prototype,{constructor:{value:e,enumerable:!1,writable:!0,configurable:!0}}),t&&(Object.setPrototypeOf?Object.setPrototypeOf(e,t):e.__proto__=t)}t.__esModule=!0;var s=Object.assign||function(e){for(var t=1;t<arguments.length;t++){var n=arguments[t];for(var r in n)Object.prototype.hasOwnProperty.call(n,r)&&(e[r]=n[r])}return e},u=n(95),l=r(u),c=n(5),p=r(c),f=n(34),d=r(f),h=n(225),m=(r(h),n(210)),v=({component:d.default.any,childFactory:d.default.func,children:d.default.node},{component:"span",childFactory:function(e){return e}}),g=function(e){function t(n,r){o(this,t);var a=i(this,e.call(this,n,r));return a.performAppear=function(e,t){a.currentlyTransitioningKeys[e]=!0,t.componentWillAppear?t.componentWillAppear(a._handleDoneAppearing.bind(a,e,t)):a._handleDoneAppearing(e,t)},a._handleDoneAppearing=function(e,t){t.componentDidAppear&&t.componentDidAppear(),delete a.currentlyTransitioningKeys[e];var n=(0,m.getChildMapping)(a.props.children);n&&n.hasOwnProperty(e)||a.performLeave(e,t)},a.performEnter=function(e,t){a.currentlyTransitioningKeys[e]=!0,t.componentWillEnter?t.componentWillEnter(a._handleDoneEntering.bind(a,e,t)):a._handleDoneEntering(e,t)},a._handleDoneEntering=function(e,t){t.componentDidEnter&&t.componentDidEnter(),delete a.currentlyTransitioningKeys[e];var n=(0,m.getChildMapping)(a.props.children);n&&n.hasOwnProperty(e)||a.performLeave(e,t)},a.performLeave=function(e,t){a.currentlyTransitioningKeys[e]=!0,t.componentWillLeave?t.componentWillLeave(a._handleDoneLeaving.bind(a,e,t)):a._handleDoneLeaving(e,t)},a._handleDoneLeaving=function(e,t){t.componentDidLeave&&t.componentDidLeave(),delete a.currentlyTransitioningKeys[e];var n=(0,m.getChildMapping)(a.props.children);n&&n.hasOwnProperty(e)?a.keysToEnter.push(e):a.setState(function(t){var n=s({},t.children);return delete n[e],{children:n}})},a.childRefs=Object.create(null),a.state={children:(0,m.getChildMapping)(n.children)},a}return a(t,e),t.prototype.componentWillMount=function(){this.currentlyTransitioningKeys={},this.keysToEnter=[],this.keysToLeave=[]},t.prototype.componentDidMount=function(){var e=this.state.children;for(var t in e)e[t]&&this.performAppear(t,this.childRefs[t])},t.prototype.componentWillReceiveProps=function(e){var t=(0,m.getChildMapping)(e.children),n=this.state.children;this.setState({children:(0,m.mergeChildMappings)(n,t)});for(var r in t){var o=n&&n.hasOwnProperty(r);!t[r]||o||this.currentlyTransitioningKeys[r]||this.keysToEnter.push(r)}for(var i in n){var a=t&&t.hasOwnProperty(i);!n[i]||a||this.currentlyTransitioningKeys[i]||this.keysToLeave.push(i)}},t.prototype.componentDidUpdate=function(){var e=this,t=this.keysToEnter;this.keysToEnter=[],t.forEach(function(t){return e.performEnter(t,e.childRefs[t])});var n=this.keysToLeave;this.keysToLeave=[],n.forEach(function(t){return e.performLeave(t,e.childRefs[t])})},t.prototype.render=function(){var e=this,t=[],n=function(n){var r=e.state.children[n];if(r){var o="string"!=typeof r.ref,i=e.props.childFactory(r),a=function(t){e.childRefs[n]=t};i===r&&o&&(a=(0,l.default)(r.ref,a)),t.push(p.default.cloneElement(i,{key:n,ref:a}))}};for(var r in this.state.children)n(r);var o=s({},this.props);return delete o.transitionLeave,delete o.transitionName,delete o.transitionAppear,delete o.transitionEnter,delete o.childFactory,delete o.transitionLeaveTimeout,delete o.transitionEnterTimeout,delete o.transitionAppearTimeout,delete o.component,p.default.createElement(this.props.component,o,t)},t}(p.default.Component);g.displayName="TransitionGroup",g.propTypes={},g.defaultProps=v,t.default=g,e.exports=t.default},function(e,t,n){"use strict";function r(){}function o(){}var i=n(209);o.resetWarningCache=r,e.exports=function(){function e(e,t,n,r,o,a){if(a!==i){var s=new Error("Calling PropTypes validators directly is not supported by the `prop-types` package. Use PropTypes.checkPropTypes() to call them. Read more at http://fb.me/use-check-prop-types");throw s.name="Invariant Violation",s}}function t(){return e}e.isRequired=e;var n={array:e,bigint:e,bool:e,func:e,number:e,object:e,string:e,symbol:e,any:e,arrayOf:t,element:e,elementType:e,instanceOf:t,node:e,objectOf:t,oneOf:t,oneOfType:t,shape:t,exact:t,checkPropTypes:o,resetWarningCache:r};return n.PropTypes=n,n}},function(e,t){"use strict";var n="SECRET_DO_NOT_PASS_THIS_OR_YOU_WILL_BE_FIRED";e.exports=n},function(e,t,n){"use strict";function r(e){if(!e)return e;var t={};return i.Children.map(e,function(e){return e}).forEach(function(e){t[e.key]=e}),t}function o(e,t){function n(n){return t.hasOwnProperty(n)?t[n]:e[n]}e=e||{},t=t||{};var r={},o=[];for(var i in e)t.hasOwnProperty(i)?o.length&&(r[i]=o,o=[]):o.push(i);var a=void 0,s={};for(var u in t){if(r.hasOwnProperty(u))for(a=0;a<r[u].length;a++){var l=r[u][a];s[r[u][a]]=n(l)}s[u]=n(u)}for(a=0;a<o.length;a++)s[o[a]]=n(o[a]);return s}t.__esModule=!0,t.getChildMapping=r,t.mergeChildMappings=o;var i=n(5)},41,[228,22],function(e,t,n){"use strict";function r(e){return(""+e).replace(C,"$&/")}function o(e,t){this.func=e,this.context=t,this.count=0}function i(e,t,n){var r=e.func,o=e.context;r.call(o,t,e.count++)}function a(e,t,n){if(null==e)return e;var r=o.getPooled(t,n);g(e,i,r),o.release(r)}function s(e,t,n,r){this.result=e,this.keyPrefix=t,this.func=n,this.context=r,this.count=0}function u(e,t,n){var o=e.result,i=e.keyPrefix,a=e.func,s=e.context,u=a.call(s,t,e.count++);Array.isArray(u)?l(u,o,n,v.thatReturnsArgument):null!=u&&(m.isValidElement(u)&&(u=m.cloneAndReplaceKey(u,i+(!u.key||t&&t.key===u.key?"":r(u.key)+"/")+n)),o.push(u))}function l(e,t,n,o,i){var a="";null!=n&&(a=r(n)+"/");var l=s.getPooled(t,a,o,i);g(e,u,l),s.release(l)}function c(e,t,n){if(null==e)return e;var r=[];return l(e,r,null,t,n),r}function p(e,t,n){return null}function f(e,t){return g(e,p,null)}function d(e){var t=[];return l(e,t,null,v.thatReturnsArgument),t}var h=n(212),m=n(21),v=n(8),g=n(223),y=h.twoArgumentPooler,b=h.fourArgumentPooler,C=/\/+/g;o.prototype.destructor=function(){this.func=null,this.context=null,this.count=0},h.addPoolingTo(o,y),s.prototype.destructor=function(){this.result=null,this.keyPrefix=null,this.func=null,this.context=null,this.count=0},h.addPoolingTo(s,b);var _={forEach:a,map:c,mapIntoWithKeyPrefixInternal:l,count:f,toArray:d};e.exports=_},function(e,t,n){"use strict";function r(e){return e}function o(e,t){var n=C.hasOwnProperty(t)?C[t]:null;w.hasOwnProperty(t)&&("OVERRIDE_BASE"!==n?f("73",t):void 0),e&&("DEFINE_MANY"!==n&&"DEFINE_MANY_MERGED"!==n?f("74",t):void 0)}function i(e,t){if(t){"function"==typeof t?f("75"):void 0,m.isValidElement(t)?f("76"):void 0;var n=e.prototype,r=n.__reactAutoBindPairs;t.hasOwnProperty(y)&&_.mixins(e,t.mixins);for(var i in t)if(t.hasOwnProperty(i)&&i!==y){var a=t[i],s=n.hasOwnProperty(i);if(o(s,i),_.hasOwnProperty(i))_[i](e,a);else{var c=C.hasOwnProperty(i),p="function"==typeof a,d=p&&!c&&!s&&t.autobind!==!1;if(d)r.push(i,a),n[i]=a;else if(s){var h=C[i];!c||"DEFINE_MANY_MERGED"!==h&&"DEFINE_MANY"!==h?f("77",h,i):void 0,"DEFINE_MANY_MERGED"===h?n[i]=u(n[i],a):"DEFINE_MANY"===h&&(n[i]=l(n[i],a))}else n[i]=a}}}else;}function a(e,t){if(t)for(var n in t){var r=t[n];if(t.hasOwnProperty(n)){var o=n in _;o?f("78",n):void 0;var i=n in e;i?f("79",n):void 0,e[n]=r}}}function s(e,t){e&&t&&"object"==typeof e&&"object"==typeof t?void 0:f("80");for(var n in t)t.hasOwnProperty(n)&&(void 0!==e[n]?f("81",n):void 0,e[n]=t[n]);return e}function u(e,t){return function(){var n=e.apply(this,arguments),r=t.apply(this,arguments);if(null==n)return r;if(null==r)return n;var o={};return s(o,n),s(o,r),o}}function l(e,t){return function(){e.apply(this,arguments),t.apply(this,arguments)}}function c(e,t){var n=t.bind(e);return n}function p(e){for(var t=e.__reactAutoBindPairs,n=0;n<t.length;n+=2){var r=t[n],o=t[n+1];e[r]=c(e,o)}}var f=n(22),d=n(4),h=n(54),m=n(21),v=(n(216),n(55)),g=n(23),y=(n(1),n(2),"mixins"),b=[],C={mixins:"DEFINE_MANY",statics:"DEFINE_MANY",propTypes:"DEFINE_MANY",contextTypes:"DEFINE_MANY",childContextTypes:"DEFINE_MANY",getDefaultProps:"DEFINE_MANY_MERGED",getInitialState:"DEFINE_MANY_MERGED",getChildContext:"DEFINE_MANY_MERGED",render:"DEFINE_ONCE",componentWillMount:"DEFINE_MANY",componentDidMount:"DEFINE_MANY",componentWillReceiveProps:"DEFINE_MANY",shouldComponentUpdate:"DEFINE_ONCE",componentWillUpdate:"DEFINE_MANY",componentDidUpdate:"DEFINE_MANY",componentWillUnmount:"DEFINE_MANY",updateComponent:"OVERRIDE_BASE"},_={displayName:function(e,t){e.displayName=t},mixins:function(e,t){if(t)for(var n=0;n<t.length;n++)i(e,t[n])},childContextTypes:function(e,t){e.childContextTypes=d({},e.childContextTypes,t)},contextTypes:function(e,t){e.contextTypes=d({},e.contextTypes,t)},getDefaultProps:function(e,t){e.getDefaultProps?e.getDefaultProps=u(e.getDefaultProps,t):e.getDefaultProps=t},propTypes:function(e,t){e.propTypes=d({},e.propTypes,t)},statics:function(e,t){a(e,t)},autobind:function(){}},w={replaceState:function(e,t){this.updater.enqueueReplaceState(this,e),t&&this.updater.enqueueCallback(this,t,"replaceState")},isMounted:function(){return this.updater.isMounted(this)}},E=function(){};d(E.prototype,h.prototype,w);var T={createClass:function(e){var t=r(function(e,n,r){this.__reactAutoBindPairs.length&&p(this),this.props=e,this.context=n,this.refs=g,this.updater=r||v,this.state=null;var o=this.getInitialState?this.getInitialState():null;"object"!=typeof o||Array.isArray(o)?f("82",t.displayName||"ReactCompositeComponent"):void 0,this.state=o});t.prototype=new E,t.prototype.constructor=t,t.prototype.__reactAutoBindPairs=[],b.forEach(i.bind(null,t)),i(t,e),t.getDefaultProps&&(t.defaultProps=t.getDefaultProps()),t.prototype.render?void 0:f("83");for(var n in C)t.prototype[n]||(t.prototype[n]=null);return t},injection:{injectMixin:function(e){b.push(e)}}};e.exports=T},function(e,t,n){"use strict";var r=n(21),o=r.createFactory,i={a:o("a"),abbr:o("abbr"),address:o("address"),area:o("area"),article:o("article"),aside:o("aside"),audio:o("audio"),b:o("b"),base:o("base"),bdi:o("bdi"),bdo:o("bdo"),big:o("big"),blockquote:o("blockquote"),body:o("body"),br:o("br"),button:o("button"),canvas:o("canvas"),caption:o("caption"),cite:o("cite"),code:o("code"),col:o("col"),colgroup:o("colgroup"),data:o("data"),datalist:o("datalist"),dd:o("dd"),del:o("del"),details:o("details"),dfn:o("dfn"),dialog:o("dialog"),div:o("div"),dl:o("dl"),dt:o("dt"),em:o("em"),embed:o("embed"),fieldset:o("fieldset"),figcaption:o("figcaption"),figure:o("figure"),footer:o("footer"),form:o("form"),h1:o("h1"),h2:o("h2"),h3:o("h3"),h4:o("h4"),h5:o("h5"),h6:o("h6"),head:o("head"),header:o("header"),hgroup:o("hgroup"),hr:o("hr"),html:o("html"),i:o("i"),iframe:o("iframe"),img:o("img"),input:o("input"),ins:o("ins"),kbd:o("kbd"),keygen:o("keygen"),label:o("label"),legend:o("legend"),li:o("li"),link:o("link"),main:o("main"),map:o("map"),mark:o("mark"),menu:o("menu"),menuitem:o("menuitem"),meta:o("meta"),meter:o("meter"),nav:o("nav"),noscript:o("noscript"),object:o("object"),ol:o("ol"),optgroup:o("optgroup"),option:o("option"),output:o("output"),p:o("p"),param:o("param"),picture:o("picture"),pre:o("pre"),progress:o("progress"),q:o("q"),rp:o("rp"),rt:o("rt"),ruby:o("ruby"),s:o("s"),samp:o("samp"),script:o("script"),section:o("section"),select:o("select"),small:o("small"),source:o("source"),span:o("span"),strong:o("strong"),style:o("style"),sub:o("sub"),summary:o("summary"),sup:o("sup"),table:o("table"),tbody:o("tbody"),td:o("td"),textarea:o("textarea"),tfoot:o("tfoot"),th:o("th"),thead:o("thead"),time:o("time"),title:o("title"),tr:o("tr"),track:o("track"),u:o("u"),ul:o("ul"),var:o("var"),video:o("video"),wbr:o("wbr"),circle:o("circle"),clipPath:o("clipPath"),defs:o("defs"),ellipse:o("ellipse"),g:o("g"),image:o("image"),line:o("line"),linearGradient:o("linearGradient"),mask:o("mask"),path:o("path"),pattern:o("pattern"),polygon:o("polygon"),polyline:o("polyline"),radialGradient:o("radialGradient"),rect:o("rect"),stop:o("stop"),svg:o("svg"),text:o("text"),tspan:o("tspan")};e.exports=i},function(e,t,n){"use strict";var r={};e.exports=r},function(e,t,n){"use strict";var r=n(21),o=r.isValidElement,i=n(62);e.exports=i(o)},function(e,t,n){"use strict";function r(e,t,n){this.props=e,this.context=t,this.refs=u,this.updater=n||s}function o(){}var i=n(4),a=n(54),s=n(55),u=n(23);o.prototype=a.prototype,r.prototype=new o,r.prototype.constructor=r,i(r.prototype,a.prototype),r.prototype.isPureReactComponent=!0,e.exports=r},164,183,function(e,t){"use strict";function n(){return r++}var r=1;e.exports=n},function(e,t,n){"use strict";function r(e){return i.isValidElement(e)?void 0:o("143"),e}var o=n(22),i=n(21);n(1);e.exports=r},function(e,t,n){"use strict";function r(e,t){return e&&"object"==typeof e&&null!=e.key?l.escape(e.key):t.toString(36)}function o(e,t,n,i){var f=typeof e;if("undefined"!==f&&"boolean"!==f||(e=null),null===e||"string"===f||"number"===f||"object"===f&&e.$$typeof===s)return n(i,e,""===t?c+r(e,0):t),1;var d,h,m=0,v=""===t?c:t+p;if(Array.isArray(e))for(var g=0;g<e.length;g++)d=e[g],h=v+r(d,g),m+=o(d,h,n,i);else{var y=u(e);if(y){var b,C=y.call(e);if(y!==e.entries)for(var _=0;!(b=C.next()).done;)d=b.value,h=v+r(d,_++),m+=o(d,h,n,i);else for(;!(b=C.next()).done;){var w=b.value;w&&(d=w[1],h=v+l.escape(w[0])+p+r(d,0),m+=o(d,h,n,i))}}else if("object"===f){var E="",T=String(e);a("31","[object Object]"===T?"object with keys {"+Object.keys(e).join(", ")+"}":T,E)}}return m}function i(e,t,n){return null==e?0:o(e,"",t,n)}var a=n(22),s=(n(12),n(88)),u=n(220),l=(n(1),n(211)),c=(n(2),"."),p=":";e.exports=i},function(e,t,n){var r,o,i;!function(n,a){o=[],r=a,i="function"==typeof r?r.apply(t,o):r,!(void 0!==i&&(e.exports=i))}(this,function(){"use strict";function e(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function t(e){var n=e.getBoundingClientRect(),r={};for(var o in n)r[o]=n[o];try{if(e.ownerDocument!==document){var i=e.ownerDocument.defaultView.frameElement;if(i){var a=t(i);r.top+=a.top,r.bottom+=a.top,r.left+=a.left,r.right+=a.left}}}catch(e){}return r}function n(e){var t=getComputedStyle(e)||{},n=t.position,r=[];if("fixed"===n)return[e];for(var o=e;(o=o.parentNode)&&o&&1===o.nodeType;){var i=void 0;try{i=getComputedStyle(o)}catch(e){}if("undefined"==typeof i||null===i)return r.push(o),r;var a=i,s=a.overflow,u=a.overflowX,l=a.overflowY;/(auto|scroll|overlay)/.test(s+l+u)&&("absolute"!==n||["relative","absolute","fixed"].indexOf(i.position)>=0)&&r.push(o)}return r.push(e.ownerDocument.body),e.ownerDocument!==document&&r.push(e.ownerDocument.defaultView),r}function r(){w&&document.body.removeChild(w),w=null}function o(e){var n=void 0;e===document?(n=document,e=document.documentElement):n=e.ownerDocument;var r=n.documentElement,o=t(e),i=x();return o.top-=i.top,o.left-=i.left,"undefined"==typeof o.width&&(o.width=document.body.scrollWidth-o.left-o.right),"undefined"==typeof o.height&&(o.height=document.body.scrollHeight-o.top-o.bottom),o.top=o.top-r.clientTop,o.left=o.left-r.clientLeft,
+o.right=n.body.clientWidth-o.width-o.left,o.bottom=n.body.clientHeight-o.height-o.top,o}function i(e){return e.offsetParent||document.documentElement}function a(){if(O)return O;var e=document.createElement("div");e.style.width="100%",e.style.height="200px";var t=document.createElement("div");s(t.style,{position:"absolute",top:0,left:0,pointerEvents:"none",visibility:"hidden",width:"200px",height:"150px",overflow:"hidden"}),t.appendChild(e),document.body.appendChild(t);var n=e.offsetWidth;t.style.overflow="scroll";var r=e.offsetWidth;n===r&&(r=t.clientWidth),document.body.removeChild(t);var o=n-r;return O={width:o,height:o}}function s(){var e=arguments.length<=0||void 0===arguments[0]?{}:arguments[0],t=[];return Array.prototype.push.apply(t,arguments),t.slice(1).forEach(function(t){if(t)for(var n in t)({}).hasOwnProperty.call(t,n)&&(e[n]=t[n])}),e}function u(e,t){if("undefined"!=typeof e.classList)t.split(" ").forEach(function(t){t.trim()&&e.classList.remove(t)});else{var n=new RegExp("(^| )"+t.split(" ").join("|")+"( |$)","gi"),r=p(e).replace(n," ");f(e,r)}}function l(e,t){if("undefined"!=typeof e.classList)t.split(" ").forEach(function(t){t.trim()&&e.classList.add(t)});else{u(e,t);var n=p(e)+(" "+t);f(e,n)}}function c(e,t){if("undefined"!=typeof e.classList)return e.classList.contains(t);var n=p(e);return new RegExp("(^| )"+t+"( |$)","gi").test(n)}function p(e){return e.className instanceof e.ownerDocument.defaultView.SVGAnimatedString?e.className.baseVal:e.className}function f(e,t){e.setAttribute("class",t)}function d(e,t,n){n.forEach(function(n){t.indexOf(n)===-1&&c(e,n)&&u(e,n)}),t.forEach(function(t){c(e,t)||l(e,t)})}function e(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function h(e,t){if("function"!=typeof t&&null!==t)throw new TypeError("Super expression must either be null or a function, not "+typeof t);e.prototype=Object.create(t&&t.prototype,{constructor:{value:e,enumerable:!1,writable:!0,configurable:!0}}),t&&(Object.setPrototypeOf?Object.setPrototypeOf(e,t):e.__proto__=t)}function m(e,t){var n=arguments.length<=2||void 0===arguments[2]?1:arguments[2];return e+n>=t&&t>=e-n}function v(){return"object"==typeof performance&&"function"==typeof performance.now?performance.now():+new Date}function g(){for(var e={top:0,left:0},t=arguments.length,n=Array(t),r=0;r<t;r++)n[r]=arguments[r];return n.forEach(function(t){var n=t.top,r=t.left;"string"==typeof n&&(n=parseFloat(n,10)),"string"==typeof r&&(r=parseFloat(r,10)),e.top+=n,e.left+=r}),e}function y(e,t){return"string"==typeof e.left&&e.left.indexOf("%")!==-1&&(e.left=parseFloat(e.left,10)/100*t.width),"string"==typeof e.top&&e.top.indexOf("%")!==-1&&(e.top=parseFloat(e.top,10)/100*t.height),e}function b(e,t){return"scrollParent"===t?t=e.scrollParents[0]:"window"===t&&(t=[pageXOffset,pageYOffset,innerWidth+pageXOffset,innerHeight+pageYOffset]),t===document&&(t=t.documentElement),"undefined"!=typeof t.nodeType&&!function(){var e=t,n=o(t),r=n,i=getComputedStyle(t);if(t=[r.left,r.top,n.width+r.left,n.height+r.top],e.ownerDocument!==document){var a=e.ownerDocument.defaultView;t[0]+=a.pageXOffset,t[1]+=a.pageYOffset,t[2]+=a.pageXOffset,t[3]+=a.pageYOffset}K.forEach(function(e,n){e=e[0].toUpperCase()+e.substr(1),"Top"===e||"Left"===e?t[n]+=parseFloat(i["border"+e+"Width"]):t[n]-=parseFloat(i["border"+e+"Width"])})}(),t}var C=function(){function e(e,t){for(var n=0;n<t.length;n++){var r=t[n];r.enumerable=r.enumerable||!1,r.configurable=!0,"value"in r&&(r.writable=!0),Object.defineProperty(e,r.key,r)}}return function(t,n,r){return n&&e(t.prototype,n),r&&e(t,r),t}}(),_=void 0;"undefined"==typeof _&&(_={modules:[]});var w=null,E=function(){var e=0;return function(){return++e}}(),T={},x=function(){var e=w;e&&document.body.contains(e)||(e=document.createElement("div"),e.setAttribute("data-tether-id",E()),s(e.style,{top:0,left:0,position:"absolute"}),document.body.appendChild(e),w=e);var n=e.getAttribute("data-tether-id");return"undefined"==typeof T[n]&&(T[n]=t(e),k(function(){delete T[n]})),T[n]},O=null,P=[],k=function(e){P.push(e)},S=function(){for(var e=void 0;e=P.pop();)e()},N=function(){function t(){e(this,t)}return C(t,[{key:"on",value:function(e,t,n){var r=!(arguments.length<=3||void 0===arguments[3])&&arguments[3];"undefined"==typeof this.bindings&&(this.bindings={}),"undefined"==typeof this.bindings[e]&&(this.bindings[e]=[]),this.bindings[e].push({handler:t,ctx:n,once:r})}},{key:"once",value:function(e,t,n){this.on(e,t,n,!0)}},{key:"off",value:function(e,t){if("undefined"!=typeof this.bindings&&"undefined"!=typeof this.bindings[e])if("undefined"==typeof t)delete this.bindings[e];else for(var n=0;n<this.bindings[e].length;)this.bindings[e][n].handler===t?this.bindings[e].splice(n,1):++n}},{key:"trigger",value:function(e){if("undefined"!=typeof this.bindings&&this.bindings[e]){for(var t=0,n=arguments.length,r=Array(n>1?n-1:0),o=1;o<n;o++)r[o-1]=arguments[o];for(;t<this.bindings[e].length;){var i=this.bindings[e][t],a=i.handler,s=i.ctx,u=i.once,l=s;"undefined"==typeof l&&(l=this),a.apply(l,r),u?this.bindings[e].splice(t,1):++t}}}}]),t}();_.Utils={getActualBoundingClientRect:t,getScrollParents:n,getBounds:o,getOffsetParent:i,extend:s,addClass:l,removeClass:u,hasClass:c,updateClasses:d,defer:k,flush:S,uniqueId:E,Evented:N,getScrollBarSize:a,removeUtilElements:r};var M=function(){function e(e,t){var n=[],r=!0,o=!1,i=void 0;try{for(var a,s=e[Symbol.iterator]();!(r=(a=s.next()).done)&&(n.push(a.value),!t||n.length!==t);r=!0);}catch(e){o=!0,i=e}finally{try{!r&&s.return&&s.return()}finally{if(o)throw i}}return n}return function(t,n){if(Array.isArray(t))return t;if(Symbol.iterator in Object(t))return e(t,n);throw new TypeError("Invalid attempt to destructure non-iterable instance")}}(),C=function(){function e(e,t){for(var n=0;n<t.length;n++){var r=t[n];r.enumerable=r.enumerable||!1,r.configurable=!0,"value"in r&&(r.writable=!0),Object.defineProperty(e,r.key,r)}}return function(t,n,r){return n&&e(t.prototype,n),r&&e(t,r),t}}(),A=function(e,t,n){for(var r=!0;r;){var o=e,i=t,a=n;r=!1,null===o&&(o=Function.prototype);var s=Object.getOwnPropertyDescriptor(o,i);if(void 0!==s){if("value"in s)return s.value;var u=s.get;if(void 0===u)return;return u.call(a)}var l=Object.getPrototypeOf(o);if(null===l)return;e=l,t=i,n=a,r=!0,s=l=void 0}};if("undefined"==typeof _)throw new Error("You must include the utils.js file before tether.js");var I=_.Utils,n=I.getScrollParents,o=I.getBounds,i=I.getOffsetParent,s=I.extend,l=I.addClass,u=I.removeClass,d=I.updateClasses,k=I.defer,S=I.flush,a=I.getScrollBarSize,r=I.removeUtilElements,D=function(){if("undefined"==typeof document)return"";for(var e=document.createElement("div"),t=["transform","WebkitTransform","OTransform","MozTransform","msTransform"],n=0;n<t.length;++n){var r=t[n];if(void 0!==e.style[r])return r}}(),R=[],L=function(){R.forEach(function(e){e.position(!1)}),S()};!function(){var e=null,t=null,n=null,r=function r(){return"undefined"!=typeof t&&t>16?(t=Math.min(t-16,250),void(n=setTimeout(r,250))):void("undefined"!=typeof e&&v()-e<10||(null!=n&&(clearTimeout(n),n=null),e=v(),L(),t=v()-e))};"undefined"!=typeof window&&"undefined"!=typeof window.addEventListener&&["resize","scroll","touchmove"].forEach(function(e){window.addEventListener(e,r)})}();var U={center:"center",left:"right",right:"left"},F={middle:"middle",top:"bottom",bottom:"top"},j={top:0,left:0,middle:"50%",center:"50%",bottom:"100%",right:"100%"},B=function(e,t){var n=e.left,r=e.top;return"auto"===n&&(n=U[t.left]),"auto"===r&&(r=F[t.top]),{left:n,top:r}},V=function(e){var t=e.left,n=e.top;return"undefined"!=typeof j[e.left]&&(t=j[e.left]),"undefined"!=typeof j[e.top]&&(n=j[e.top]),{left:t,top:n}},W=function(e){var t=e.split(" "),n=M(t,2),r=n[0],o=n[1];return{top:r,left:o}},H=W,q=function(t){function c(t){var n=this;e(this,c),A(Object.getPrototypeOf(c.prototype),"constructor",this).call(this),this.position=this.position.bind(this),R.push(this),this.history=[],this.setOptions(t,!1),_.modules.forEach(function(e){"undefined"!=typeof e.initialize&&e.initialize.call(n)}),this.position()}return h(c,t),C(c,[{key:"getClass",value:function(){var e=arguments.length<=0||void 0===arguments[0]?"":arguments[0],t=this.options.classes;return"undefined"!=typeof t&&t[e]?this.options.classes[e]:this.options.classPrefix?this.options.classPrefix+"-"+e:e}},{key:"setOptions",value:function(e){var t=this,r=arguments.length<=1||void 0===arguments[1]||arguments[1],o={offset:"0 0",targetOffset:"0 0",targetAttachment:"auto auto",classPrefix:"tether"};this.options=s(o,e);var i=this.options,a=i.element,u=i.target,c=i.targetModifier;if(this.element=a,this.target=u,this.targetModifier=c,"viewport"===this.target?(this.target=document.body,this.targetModifier="visible"):"scroll-handle"===this.target&&(this.target=document.body,this.targetModifier="scroll-handle"),["element","target"].forEach(function(e){if("undefined"==typeof t[e])throw new Error("Tether Error: Both element and target must be defined");"undefined"!=typeof t[e].jquery?t[e]=t[e][0]:"string"==typeof t[e]&&(t[e]=document.querySelector(t[e]))}),l(this.element,this.getClass("element")),this.options.addTargetClasses!==!1&&l(this.target,this.getClass("target")),!this.options.attachment)throw new Error("Tether Error: You must provide an attachment");this.targetAttachment=H(this.options.targetAttachment),this.attachment=H(this.options.attachment),this.offset=W(this.options.offset),this.targetOffset=W(this.options.targetOffset),"undefined"!=typeof this.scrollParents&&this.disable(),"scroll-handle"===this.targetModifier?this.scrollParents=[this.target]:this.scrollParents=n(this.target),this.options.enabled!==!1&&this.enable(r)}},{key:"getTargetBounds",value:function(){if("undefined"==typeof this.targetModifier)return o(this.target);if("visible"===this.targetModifier){if(this.target===document.body)return{top:pageYOffset,left:pageXOffset,height:innerHeight,width:innerWidth};var e=o(this.target),t={height:e.height,width:e.width,top:e.top,left:e.left};return t.height=Math.min(t.height,e.height-(pageYOffset-e.top)),t.height=Math.min(t.height,e.height-(e.top+e.height-(pageYOffset+innerHeight))),t.height=Math.min(innerHeight,t.height),t.height-=2,t.width=Math.min(t.width,e.width-(pageXOffset-e.left)),t.width=Math.min(t.width,e.width-(e.left+e.width-(pageXOffset+innerWidth))),t.width=Math.min(innerWidth,t.width),t.width-=2,t.top<pageYOffset&&(t.top=pageYOffset),t.left<pageXOffset&&(t.left=pageXOffset),t}if("scroll-handle"===this.targetModifier){var e=void 0,n=this.target;n===document.body?(n=document.documentElement,e={left:pageXOffset,top:pageYOffset,height:innerHeight,width:innerWidth}):e=o(n);var r=getComputedStyle(n),i=n.scrollWidth>n.clientWidth||[r.overflow,r.overflowX].indexOf("scroll")>=0||this.target!==document.body,a=0;i&&(a=15);var s=e.height-parseFloat(r.borderTopWidth)-parseFloat(r.borderBottomWidth)-a,t={width:15,height:.975*s*(s/n.scrollHeight),left:e.left+e.width-parseFloat(r.borderLeftWidth)-15},u=0;s<408&&this.target===document.body&&(u=-11e-5*Math.pow(s,2)-.00727*s+22.58),this.target!==document.body&&(t.height=Math.max(t.height,24));var l=this.target.scrollTop/(n.scrollHeight-s);return t.top=l*(s-t.height-u)+e.top+parseFloat(r.borderTopWidth),this.target===document.body&&(t.height=Math.max(t.height,24)),t}}},{key:"clearCache",value:function(){this._cache={}}},{key:"cache",value:function(e,t){return"undefined"==typeof this._cache&&(this._cache={}),"undefined"==typeof this._cache[e]&&(this._cache[e]=t.call(this)),this._cache[e]}},{key:"enable",value:function(){var e=this,t=arguments.length<=0||void 0===arguments[0]||arguments[0];this.options.addTargetClasses!==!1&&l(this.target,this.getClass("enabled")),l(this.element,this.getClass("enabled")),this.enabled=!0,this.scrollParents.forEach(function(t){t!==e.target.ownerDocument&&t.addEventListener("scroll",e.position)}),t&&this.position()}},{key:"disable",value:function(){var e=this;u(this.target,this.getClass("enabled")),u(this.element,this.getClass("enabled")),this.enabled=!1,"undefined"!=typeof this.scrollParents&&this.scrollParents.forEach(function(t){t.removeEventListener("scroll",e.position)})}},{key:"destroy",value:function(){var e=this;this.disable(),R.forEach(function(t,n){t===e&&R.splice(n,1)}),0===R.length&&r()}},{key:"updateAttachClasses",value:function(e,t){var n=this;e=e||this.attachment,t=t||this.targetAttachment;var r=["left","top","bottom","right","middle","center"];"undefined"!=typeof this._addAttachClasses&&this._addAttachClasses.length&&this._addAttachClasses.splice(0,this._addAttachClasses.length),"undefined"==typeof this._addAttachClasses&&(this._addAttachClasses=[]);var o=this._addAttachClasses;e.top&&o.push(this.getClass("element-attached")+"-"+e.top),e.left&&o.push(this.getClass("element-attached")+"-"+e.left),t.top&&o.push(this.getClass("target-attached")+"-"+t.top),t.left&&o.push(this.getClass("target-attached")+"-"+t.left);var i=[];r.forEach(function(e){i.push(n.getClass("element-attached")+"-"+e),i.push(n.getClass("target-attached")+"-"+e)}),k(function(){"undefined"!=typeof n._addAttachClasses&&(d(n.element,n._addAttachClasses,i),n.options.addTargetClasses!==!1&&d(n.target,n._addAttachClasses,i),delete n._addAttachClasses)})}},{key:"position",value:function(){var e=this,t=arguments.length<=0||void 0===arguments[0]||arguments[0];if(this.enabled){this.clearCache();var n=B(this.targetAttachment,this.attachment);this.updateAttachClasses(this.attachment,n);var r=this.cache("element-bounds",function(){return o(e.element)}),s=r.width,u=r.height;if(0===s&&0===u&&"undefined"!=typeof this.lastSize){var l=this.lastSize;s=l.width,u=l.height}else this.lastSize={width:s,height:u};var c=this.cache("target-bounds",function(){return e.getTargetBounds()}),p=c,f=y(V(this.attachment),{width:s,height:u}),d=y(V(n),p),h=y(this.offset,{width:s,height:u}),m=y(this.targetOffset,p);f=g(f,h),d=g(d,m);for(var v=c.left+d.left-f.left,b=c.top+d.top-f.top,C=0;C<_.modules.length;++C){var w=_.modules[C],E=w.position.call(this,{left:v,top:b,targetAttachment:n,targetPos:c,elementPos:r,offset:f,targetOffset:d,manualOffset:h,manualTargetOffset:m,scrollbarSize:P,attachment:this.attachment});if(E===!1)return!1;"undefined"!=typeof E&&"object"==typeof E&&(b=E.top,v=E.left)}var T={page:{top:b,left:v},viewport:{top:b-pageYOffset,bottom:pageYOffset-b-u+innerHeight,left:v-pageXOffset,right:pageXOffset-v-s+innerWidth}},x=this.target.ownerDocument,O=x.defaultView,P=void 0;return O.innerHeight>x.documentElement.clientHeight&&(P=this.cache("scrollbar-size",a),T.viewport.bottom-=P.height),O.innerWidth>x.documentElement.clientWidth&&(P=this.cache("scrollbar-size",a),T.viewport.right-=P.width),["","static"].indexOf(x.body.style.position)!==-1&&["","static"].indexOf(x.body.parentElement.style.position)!==-1||(T.page.bottom=x.body.scrollHeight-b-u,T.page.right=x.body.scrollWidth-v-s),"undefined"!=typeof this.options.optimizations&&this.options.optimizations.moveElement!==!1&&"undefined"==typeof this.targetModifier&&!function(){var t=e.cache("target-offsetparent",function(){return i(e.target)}),n=e.cache("target-offsetparent-bounds",function(){return o(t)}),r=getComputedStyle(t),a=n,s={};if(["Top","Left","Bottom","Right"].forEach(function(e){s[e.toLowerCase()]=parseFloat(r["border"+e+"Width"])}),n.right=x.body.scrollWidth-n.left-a.width+s.right,n.bottom=x.body.scrollHeight-n.top-a.height+s.bottom,T.page.top>=n.top+s.top&&T.page.bottom>=n.bottom&&T.page.left>=n.left+s.left&&T.page.right>=n.right){var u=t.scrollTop,l=t.scrollLeft;T.offset={top:T.page.top-n.top+u-s.top,left:T.page.left-n.left+l-s.left}}}(),this.move(T),this.history.unshift(T),this.history.length>3&&this.history.pop(),t&&S(),!0}}},{key:"move",value:function(e){var t=this;if("undefined"!=typeof this.element.parentNode){var n={};for(var r in e){n[r]={};for(var o in e[r]){for(var a=!1,u=0;u<this.history.length;++u){var l=this.history[u];if("undefined"!=typeof l[r]&&!m(l[r][o],e[r][o])){a=!0;break}}a||(n[r][o]=!0)}}var c={top:"",left:"",right:"",bottom:""},p=function(e,n){var r="undefined"!=typeof t.options.optimizations,o=r?t.options.optimizations.gpu:null;if(o!==!1){var i=void 0,a=void 0;e.top?(c.top=0,i=n.top):(c.bottom=0,i=-n.bottom),e.left?(c.left=0,a=n.left):(c.right=0,a=-n.right),"number"==typeof window.devicePixelRatio&&devicePixelRatio%1===0&&(a=Math.round(a*devicePixelRatio)/devicePixelRatio,i=Math.round(i*devicePixelRatio)/devicePixelRatio),c[D]="translateX("+a+"px) translateY("+i+"px)","msTransform"!==D&&(c[D]+=" translateZ(0)")}else e.top?c.top=n.top+"px":c.bottom=n.bottom+"px",e.left?c.left=n.left+"px":c.right=n.right+"px"},f=!1;if((n.page.top||n.page.bottom)&&(n.page.left||n.page.right)?(c.position="absolute",p(n.page,e.page)):(n.viewport.top||n.viewport.bottom)&&(n.viewport.left||n.viewport.right)?(c.position="fixed",p(n.viewport,e.viewport)):"undefined"!=typeof n.offset&&n.offset.top&&n.offset.left?!function(){c.position="absolute";var r=t.cache("target-offsetparent",function(){return i(t.target)});i(t.element)!==r&&k(function(){t.element.parentNode.removeChild(t.element),r.appendChild(t.element)}),p(n.offset,e.offset),f=!0}():(c.position="absolute",p({top:!0,left:!0},e.page)),!f)if(this.options.bodyElement)this.element.parentNode!==this.options.bodyElement&&this.options.bodyElement.appendChild(this.element);else{for(var d=function(e){var t=e.ownerDocument,n=t.fullscreenElement||t.webkitFullscreenElement||t.mozFullScreenElement||t.msFullscreenElement;return n===e},h=!0,v=this.element.parentNode;v&&1===v.nodeType&&"BODY"!==v.tagName&&!d(v);){if("static"!==getComputedStyle(v).position){h=!1;break}v=v.parentNode}h||(this.element.parentNode.removeChild(this.element),this.element.ownerDocument.body.appendChild(this.element))}var g={},y=!1;for(var o in c){var b=c[o],C=this.element.style[o];C!==b&&(y=!0,g[o]=b)}y&&k(function(){s(t.element.style,g),t.trigger("repositioned")})}}}]),c}(N);q.modules=[],_.position=L;var z=s(q,_),M=function(){function e(e,t){var n=[],r=!0,o=!1,i=void 0;try{for(var a,s=e[Symbol.iterator]();!(r=(a=s.next()).done)&&(n.push(a.value),!t||n.length!==t);r=!0);}catch(e){o=!0,i=e}finally{try{!r&&s.return&&s.return()}finally{if(o)throw i}}return n}return function(t,n){if(Array.isArray(t))return t;if(Symbol.iterator in Object(t))return e(t,n);throw new TypeError("Invalid attempt to destructure non-iterable instance")}}(),I=_.Utils,o=I.getBounds,s=I.extend,d=I.updateClasses,k=I.defer,K=["left","top","right","bottom"];_.modules.push({position:function(e){var t=this,n=e.top,r=e.left,i=e.targetAttachment;if(!this.options.constraints)return!0;var a=this.cache("element-bounds",function(){return o(t.element)}),u=a.height,l=a.width;if(0===l&&0===u&&"undefined"!=typeof this.lastSize){var c=this.lastSize;l=c.width,u=c.height}var p=this.cache("target-bounds",function(){return t.getTargetBounds()}),f=p.height,h=p.width,m=[this.getClass("pinned"),this.getClass("out-of-bounds")];this.options.constraints.forEach(function(e){var t=e.outOfBoundsClass,n=e.pinnedClass;t&&m.push(t),n&&m.push(n)}),m.forEach(function(e){["left","top","right","bottom"].forEach(function(t){m.push(e+"-"+t)})});var v=[],g=s({},i),y=s({},this.attachment);return this.options.constraints.forEach(function(e){var o=e.to,a=e.attachment,s=e.pin;"undefined"==typeof a&&(a="");var c=void 0,p=void 0;if(a.indexOf(" ")>=0){var d=a.split(" "),m=M(d,2);p=m[0],c=m[1]}else c=p=a;var C=b(t,o);"target"!==p&&"both"!==p||(n<C[1]&&"top"===g.top&&(n+=f,g.top="bottom"),n+u>C[3]&&"bottom"===g.top&&(n-=f,g.top="top")),"together"===p&&("top"===g.top&&("bottom"===y.top&&n<C[1]?(n+=f,g.top="bottom",n+=u,y.top="top"):"top"===y.top&&n+u>C[3]&&n-(u-f)>=C[1]&&(n-=u-f,g.top="bottom",y.top="bottom")),"bottom"===g.top&&("top"===y.top&&n+u>C[3]?(n-=f,g.top="top",n-=u,y.top="bottom"):"bottom"===y.top&&n<C[1]&&n+(2*u-f)<=C[3]&&(n+=u-f,g.top="top",y.top="top")),"middle"===g.top&&(n+u>C[3]&&"top"===y.top?(n-=u,y.top="bottom"):n<C[1]&&"bottom"===y.top&&(n+=u,y.top="top"))),"target"!==c&&"both"!==c||(r<C[0]&&"left"===g.left&&(r+=h,g.left="right"),r+l>C[2]&&"right"===g.left&&(r-=h,g.left="left")),"together"===c&&(r<C[0]&&"left"===g.left?"right"===y.left?(r+=h,g.left="right",r+=l,y.left="left"):"left"===y.left&&(r+=h,g.left="right",r-=l,y.left="right"):r+l>C[2]&&"right"===g.left?"left"===y.left?(r-=h,g.left="left",r-=l,y.left="right"):"right"===y.left&&(r-=h,g.left="left",r+=l,y.left="left"):"center"===g.left&&(r+l>C[2]&&"left"===y.left?(r-=l,y.left="right"):r<C[0]&&"right"===y.left&&(r+=l,y.left="left"))),"element"!==p&&"both"!==p||(n<C[1]&&"bottom"===y.top&&(n+=u,y.top="top"),n+u>C[3]&&"top"===y.top&&(n-=u,y.top="bottom")),"element"!==c&&"both"!==c||(r<C[0]&&("right"===y.left?(r+=l,y.left="left"):"center"===y.left&&(r+=l/2,y.left="left")),r+l>C[2]&&("left"===y.left?(r-=l,y.left="right"):"center"===y.left&&(r-=l/2,y.left="right"))),"string"==typeof s?s=s.split(",").map(function(e){return e.trim()}):s===!0&&(s=["top","left","right","bottom"]),s=s||[];var _=[],w=[];n<C[1]&&(s.indexOf("top")>=0?(n=C[1],_.push("top")):w.push("top")),n+u>C[3]&&(s.indexOf("bottom")>=0?(n=C[3]-u,_.push("bottom")):w.push("bottom")),r<C[0]&&(s.indexOf("left")>=0?(r=C[0],_.push("left")):w.push("left")),r+l>C[2]&&(s.indexOf("right")>=0?(r=C[2]-l,_.push("right")):w.push("right")),_.length&&!function(){var e=void 0;e="undefined"!=typeof t.options.pinnedClass?t.options.pinnedClass:t.getClass("pinned"),v.push(e),_.forEach(function(t){v.push(e+"-"+t)})}(),w.length&&!function(){var e=void 0;e="undefined"!=typeof t.options.outOfBoundsClass?t.options.outOfBoundsClass:t.getClass("out-of-bounds"),v.push(e),w.forEach(function(t){v.push(e+"-"+t)})}(),(_.indexOf("left")>=0||_.indexOf("right")>=0)&&(y.left=g.left=!1),(_.indexOf("top")>=0||_.indexOf("bottom")>=0)&&(y.top=g.top=!1),g.top===i.top&&g.left===i.left&&y.top===t.attachment.top&&y.left===t.attachment.left||(t.updateAttachClasses(y,g),t.trigger("update",{attachment:y,targetAttachment:g}))}),k(function(){t.options.addTargetClasses!==!1&&d(t.target,v,m),d(t.element,v,m)}),{top:n,left:r}}});var I=_.Utils,o=I.getBounds,d=I.updateClasses,k=I.defer;_.modules.push({position:function(e){var t=this,n=e.top,r=e.left,i=this.cache("element-bounds",function(){return o(t.element)}),a=i.height,s=i.width,u=this.getTargetBounds(),l=n+a,c=r+s,p=[];n<=u.bottom&&l>=u.top&&["left","right"].forEach(function(e){var t=u[e];t!==r&&t!==c||p.push(e)}),r<=u.right&&c>=u.left&&["top","bottom"].forEach(function(e){var t=u[e];t!==n&&t!==l||p.push(e)});var f=[],h=[],m=["left","top","right","bottom"];return f.push(this.getClass("abutted")),m.forEach(function(e){f.push(t.getClass("abutted")+"-"+e)}),p.length&&h.push(this.getClass("abutted")),p.forEach(function(e){h.push(t.getClass("abutted")+"-"+e)}),k(function(){t.options.addTargetClasses!==!1&&d(t.target,h,f),d(t.element,h,f)}),!0}});var M=function(){function e(e,t){var n=[],r=!0,o=!1,i=void 0;try{for(var a,s=e[Symbol.iterator]();!(r=(a=s.next()).done)&&(n.push(a.value),!t||n.length!==t);r=!0);}catch(e){o=!0,i=e}finally{try{!r&&s.return&&s.return()}finally{if(o)throw i}}return n}return function(t,n){if(Array.isArray(t))return t;if(Symbol.iterator in Object(t))return e(t,n);throw new TypeError("Invalid attempt to destructure non-iterable instance")}}();return _.modules.push({position:function(e){var t=e.top,n=e.left;if(this.options.shift){var r=this.options.shift;"function"==typeof this.options.shift&&(r=this.options.shift.call(this,{top:t,left:n}));var o=void 0,i=void 0;if("string"==typeof r){r=r.split(" "),r[1]=r[1]||r[0];var a=r,s=M(a,2);o=s[0],i=s[1],o=parseFloat(o,10),i=parseFloat(i,10)}else o=r.top,i=r.left;return t+=o,n+=i,{top:t,left:n}}}}),z})},function(e,t,n){"use strict";var r=function(){};e.exports=r},function(e,t){!function(e){"use strict";function t(e){if("string"!=typeof e&&(e=String(e)),/[^a-z0-9\-#$%&'*+.\^_`|~]/i.test(e))throw new TypeError("Invalid character in header field name");return e.toLowerCase()}function n(e){return"string"!=typeof e&&(e=String(e)),e}function r(e){var t={next:function(){var t=e.shift();return{done:void 0===t,value:t}}};return g.iterable&&(t[Symbol.iterator]=function(){return t}),t}function o(e){this.map={},e instanceof o?e.forEach(function(e,t){this.append(t,e)},this):e&&Object.getOwnPropertyNames(e).forEach(function(t){this.append(t,e[t])},this)}function i(e){return e.bodyUsed?Promise.reject(new TypeError("Already read")):void(e.bodyUsed=!0)}function a(e){return new Promise(function(t,n){e.onload=function(){t(e.result)},e.onerror=function(){n(e.error)}})}function s(e){var t=new FileReader,n=a(t);return t.readAsArrayBuffer(e),n}function u(e){var t=new FileReader,n=a(t);return t.readAsText(e),n}function l(e){for(var t=new Uint8Array(e),n=new Array(t.length),r=0;r<t.length;r++)n[r]=String.fromCharCode(t[r]);return n.join("")}function c(e){if(e.slice)return e.slice(0);var t=new Uint8Array(e.byteLength);return t.set(new Uint8Array(e)),t.buffer}function p(){return this.bodyUsed=!1,this._initBody=function(e){if(this._bodyInit=e,e)if("string"==typeof e)this._bodyText=e;else if(g.blob&&Blob.prototype.isPrototypeOf(e))this._bodyBlob=e;else if(g.formData&&FormData.prototype.isPrototypeOf(e))this._bodyFormData=e;else if(g.searchParams&&URLSearchParams.prototype.isPrototypeOf(e))this._bodyText=e.toString();else if(g.arrayBuffer&&g.blob&&b(e))this._bodyArrayBuffer=c(e.buffer),this._bodyInit=new Blob([this._bodyArrayBuffer]);else{if(!g.arrayBuffer||!ArrayBuffer.prototype.isPrototypeOf(e)&&!C(e))throw new Error("unsupported BodyInit type");this._bodyArrayBuffer=c(e)}else this._bodyText="";this.headers.get("content-type")||("string"==typeof e?this.headers.set("content-type","text/plain;charset=UTF-8"):this._bodyBlob&&this._bodyBlob.type?this.headers.set("content-type",this._bodyBlob.type):g.searchParams&&URLSearchParams.prototype.isPrototypeOf(e)&&this.headers.set("content-type","application/x-www-form-urlencoded;charset=UTF-8"))},g.blob&&(this.blob=function(){var e=i(this);if(e)return e;if(this._bodyBlob)return Promise.resolve(this._bodyBlob);if(this._bodyArrayBuffer)return Promise.resolve(new Blob([this._bodyArrayBuffer]));if(this._bodyFormData)throw new Error("could not read FormData body as blob");return Promise.resolve(new Blob([this._bodyText]))},this.arrayBuffer=function(){return this._bodyArrayBuffer?i(this)||Promise.resolve(this._bodyArrayBuffer):this.blob().then(s)}),this.text=function(){var e=i(this);if(e)return e;if(this._bodyBlob)return u(this._bodyBlob);if(this._bodyArrayBuffer)return Promise.resolve(l(this._bodyArrayBuffer));if(this._bodyFormData)throw new Error("could not read FormData body as text");return Promise.resolve(this._bodyText)},g.formData&&(this.formData=function(){return this.text().then(h)}),this.json=function(){return this.text().then(JSON.parse)},this}function f(e){var t=e.toUpperCase();return _.indexOf(t)>-1?t:e}function d(e,t){t=t||{};var n=t.body;if(e instanceof d){if(e.bodyUsed)throw new TypeError("Already read");this.url=e.url,this.credentials=e.credentials,t.headers||(this.headers=new o(e.headers)),this.method=e.method,this.mode=e.mode,n||null==e._bodyInit||(n=e._bodyInit,e.bodyUsed=!0)}else this.url=String(e);if(this.credentials=t.credentials||this.credentials||"omit",!t.headers&&this.headers||(this.headers=new o(t.headers)),this.method=f(t.method||this.method||"GET"),this.mode=t.mode||this.mode||null,this.referrer=null,("GET"===this.method||"HEAD"===this.method)&&n)throw new TypeError("Body not allowed for GET or HEAD requests");this._initBody(n)}function h(e){var t=new FormData;return e.trim().split("&").forEach(function(e){if(e){var n=e.split("="),r=n.shift().replace(/\+/g," "),o=n.join("=").replace(/\+/g," ");t.append(decodeURIComponent(r),decodeURIComponent(o))}}),t}function m(e){var t=new o;return e.split(/\r?\n/).forEach(function(e){var n=e.split(":"),r=n.shift().trim();if(r){var o=n.join(":").trim();t.append(r,o)}}),t}function v(e,t){t||(t={}),this.type="default",this.status="status"in t?t.status:200,this.ok=this.status>=200&&this.status<300,this.statusText="statusText"in t?t.statusText:"OK",this.headers=new o(t.headers),this.url=t.url||"",this._initBody(e)}if(!e.fetch){var g={searchParams:"URLSearchParams"in e,iterable:"Symbol"in e&&"iterator"in Symbol,blob:"FileReader"in e&&"Blob"in e&&function(){try{return new Blob,!0}catch(e){return!1}}(),formData:"FormData"in e,arrayBuffer:"ArrayBuffer"in e};if(g.arrayBuffer)var y=["[object Int8Array]","[object Uint8Array]","[object Uint8ClampedArray]","[object Int16Array]","[object Uint16Array]","[object Int32Array]","[object Uint32Array]","[object Float32Array]","[object Float64Array]"],b=function(e){return e&&DataView.prototype.isPrototypeOf(e)},C=ArrayBuffer.isView||function(e){return e&&y.indexOf(Object.prototype.toString.call(e))>-1};o.prototype.append=function(e,r){e=t(e),r=n(r);var o=this.map[e];this.map[e]=o?o+","+r:r},o.prototype.delete=function(e){delete this.map[t(e)]},o.prototype.get=function(e){return e=t(e),this.has(e)?this.map[e]:null},o.prototype.has=function(e){return this.map.hasOwnProperty(t(e))},o.prototype.set=function(e,r){this.map[t(e)]=n(r)},o.prototype.forEach=function(e,t){for(var n in this.map)this.map.hasOwnProperty(n)&&e.call(t,this.map[n],n,this)},o.prototype.keys=function(){var e=[];return this.forEach(function(t,n){e.push(n)}),r(e)},o.prototype.values=function(){var e=[];return this.forEach(function(t){e.push(t)}),r(e)},o.prototype.entries=function(){var e=[];return this.forEach(function(t,n){e.push([n,t])}),r(e)},g.iterable&&(o.prototype[Symbol.iterator]=o.prototype.entries);var _=["DELETE","GET","HEAD","OPTIONS","POST","PUT"];d.prototype.clone=function(){return new d(this,{body:this._bodyInit})},p.call(d.prototype),p.call(v.prototype),v.prototype.clone=function(){return new v(this._bodyInit,{status:this.status,statusText:this.statusText,headers:new o(this.headers),url:this.url})},v.error=function(){var e=new v(null,{status:0,statusText:""});return e.type="error",e};var w=[301,302,303,307,308];v.redirect=function(e,t){if(w.indexOf(t)===-1)throw new RangeError("Invalid status code");return new v(null,{status:t,headers:{location:e}})},e.Headers=o,e.Request=d,e.Response=v,e.fetch=function(e,t){return new Promise(function(n,r){var o=new d(e,t),i=new XMLHttpRequest;i.onload=function(){var e={status:i.status,statusText:i.statusText,headers:m(i.getAllResponseHeaders()||"")};e.url="responseURL"in i?i.responseURL:e.headers.get("X-Request-URL");var t="response"in i?i.response:i.responseText;n(new v(t,e))},i.onerror=function(){r(new TypeError("Network request failed"))},i.ontimeout=function(){r(new TypeError("Network request failed"))},i.open(o.method,o.url,!0),"include"===o.credentials&&(i.withCredentials=!0),"responseType"in i&&g.blob&&(i.responseType="blob"),o.headers.forEach(function(e,t){i.setRequestHeader(t,e)}),i.send("undefined"==typeof o._bodyInit?null:o._bodyInit)})},e.fetch.polyfill=!0}}("undefined"!=typeof self?self:this)},function(e,t,n,r,o,i,a,s){function u(e,t){var n,r=function(o){return e.length>1?function(){var i=o?o.concat():[];return n=t?n||this:this,i.push.apply(i,arguments)<e.length&&arguments.length?r.call(n,i):e.apply(n,i)}:e};return r()}var l,c,p,f,d,h,m,v,g,y={}.toString;l=n(r),c=n(o),p=n(i),f=n(a),d=n(s),h=function(e){return e},m=u(function(e,t){return y.call(t).slice(8,-1)===e}),v=u(function(e,t){var n,r=[];for(n=0;n<e;++n)r.push(t);return r}),f.empty=c.empty,f.slice=c.slice,f.take=c.take,f.drop=c.drop,f.splitAt=c.splitAt,f.takeWhile=c.takeWhile,f.dropWhile=c.dropWhile,f.span=c.span,f.breakStr=c.breakList,g={Func:l,List:c,Obj:p,Str:f,Num:d,id:h,isType:m,replicate:v},g.each=c.each,g.map=c.map,g.filter=c.filter,g.compact=c.compact,g.reject=c.reject,g.partition=c.partition,g.find=c.find,g.head=c.head,g.first=c.first,g.tail=c.tail,g.last=c.last,g.initial=c.initial,g.empty=c.empty,g.reverse=c.reverse,g.difference=c.difference,g.intersection=c.intersection,g.union=c.union,g.countBy=c.countBy,g.groupBy=c.groupBy,g.fold=c.fold,g.foldl=c.foldl,g.fold1=c.fold1,g.foldl1=c.foldl1,
+g.foldr=c.foldr,g.foldr1=c.foldr1,g.unfoldr=c.unfoldr,g.andList=c.andList,g.orList=c.orList,g.any=c.any,g.all=c.all,g.unique=c.unique,g.uniqueBy=c.uniqueBy,g.sort=c.sort,g.sortWith=c.sortWith,g.sortBy=c.sortBy,g.sum=c.sum,g.product=c.product,g.mean=c.mean,g.average=c.average,g.concat=c.concat,g.concatMap=c.concatMap,g.flatten=c.flatten,g.maximum=c.maximum,g.minimum=c.minimum,g.maximumBy=c.maximumBy,g.minimumBy=c.minimumBy,g.scan=c.scan,g.scanl=c.scanl,g.scan1=c.scan1,g.scanl1=c.scanl1,g.scanr=c.scanr,g.scanr1=c.scanr1,g.slice=c.slice,g.take=c.take,g.drop=c.drop,g.splitAt=c.splitAt,g.takeWhile=c.takeWhile,g.dropWhile=c.dropWhile,g.span=c.span,g.breakList=c.breakList,g.zip=c.zip,g.zipWith=c.zipWith,g.zipAll=c.zipAll,g.zipAllWith=c.zipAllWith,g.at=c.at,g.elemIndex=c.elemIndex,g.elemIndices=c.elemIndices,g.findIndex=c.findIndex,g.findIndices=c.findIndices,g.apply=l.apply,g.curry=l.curry,g.flip=l.flip,g.fix=l.fix,g.over=l.over,g.split=f.split,g.join=f.join,g.lines=f.lines,g.unlines=f.unlines,g.words=f.words,g.unwords=f.unwords,g.chars=f.chars,g.unchars=f.unchars,g.repeat=f.repeat,g.capitalize=f.capitalize,g.camelize=f.camelize,g.dasherize=f.dasherize,g.values=p.values,g.keys=p.keys,g.pairsToObj=p.pairsToObj,g.objToPairs=p.objToPairs,g.listsToObj=p.listsToObj,g.objToLists=p.objToLists,g.max=d.max,g.min=d.min,g.negate=d.negate,g.abs=d.abs,g.signum=d.signum,g.quot=d.quot,g.rem=d.rem,g.div=d.div,g.mod=d.mod,g.recip=d.recip,g.pi=d.pi,g.tau=d.tau,g.exp=d.exp,g.sqrt=d.sqrt,g.ln=d.ln,g.pow=d.pow,g.sin=d.sin,g.tan=d.tan,g.cos=d.cos,g.acos=d.acos,g.asin=d.asin,g.atan=d.atan,g.atan2=d.atan2,g.truncate=d.truncate,g.round=d.round,g.ceiling=d.ceiling,g.floor=d.floor,g.isItNaN=d.isItNaN,g.even=d.even,g.odd=d.odd,g.gcd=d.gcd,g.lcm=d.lcm,g.VERSION="1.2.1",e.exports=g},function(e,t,n,r){"use strict";var o=n(r),i=(n(1),function(e){var t=this;if(t.instancePool.length){var n=t.instancePool.pop();return t.call(n,e),n}return new t(e)}),a=function(e,t){var n=this;if(n.instancePool.length){var r=n.instancePool.pop();return n.call(r,e,t),r}return new n(e,t)},s=function(e,t,n){var r=this;if(r.instancePool.length){var o=r.instancePool.pop();return r.call(o,e,t,n),o}return new r(e,t,n)},u=function(e,t,n,r){var o=this;if(o.instancePool.length){var i=o.instancePool.pop();return o.call(i,e,t,n,r),i}return new o(e,t,n,r)},l=function(e){var t=this;e instanceof t?void 0:o("25"),e.destructor(),t.instancePool.length<t.poolSize&&t.instancePool.push(e)},c=10,p=i,f=function(e,t){var n=e;return n.instancePool=[],n.getPooled=t||p,n.poolSize||(n.poolSize=c),n.release=l,n},d={addPoolingTo:f,oneArgumentPooler:i,twoArgumentPooler:a,threeArgumentPooler:s,fourArgumentPooler:u};e.exports=d}]));
+//# sourceMappingURL=main.bd8d4a90.js.map
\ No newline at end of file

From defbbbff929d109d8819efc3863c39620a42dac7 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 7 Nov 2022 12:22:30 -0800
Subject: [PATCH 195/743] Patch set-output to environment files in GitHub
 workflow

* https://github.blog/changelog/2022-10-11-github-actions-deprecating-save-state-and-set-output-commands/
---
 .github/workflows/publish-docker.yml     | 24 ++++++++++++------------
 .github/workflows/publish-installers.yml | 20 ++++++++++----------
 .github/workflows/publish-snap.yml       | 10 +++++-----
 3 files changed, 27 insertions(+), 27 deletions(-)

diff --git a/.github/workflows/publish-docker.yml b/.github/workflows/publish-docker.yml
index 5f95cd9d..3f6af320 100644
--- a/.github/workflows/publish-docker.yml
+++ b/.github/workflows/publish-docker.yml
@@ -19,23 +19,23 @@ jobs:
         id: prepare
         run: |
           if [[ $GITHUB_REF == refs/tags/* ]]; then
-            echo ::set-output name=tag::${GITHUB_REF#refs/tags/}
+            echo "tag=${GITHUB_REF#refs/tags/}" >> $GITHUB_OUTPUT
           elif [[ $GITHUB_REF == refs/heads/master ]]; then
-            echo ::set-output name=tag::latest
+            echo "tag=latest" >> $GITHUB_OUTPUT
           else
-            echo ::set-output name=tag::${GITHUB_REF#refs/heads/}
+            echo "tag=${GITHUB_REF#refs/heads/}" >> $GITHUB_OUTPUT
           fi
           if [[ $GITHUB_REF == refs/tags/*-beta ]]; then
-            echo ::set-output name=branch::beta
+            echo "branch=beta" >> $GITHUB_OUTPUT
           elif [[ $GITHUB_REF == refs/tags/* ]]; then
-            echo ::set-output name=branch::master
+            echo "branch=master" >> $GITHUB_OUTPUT
           else
-            echo ::set-output name=branch::${GITHUB_REF#refs/heads/}
+            echo "branch=${GITHUB_REF#refs/heads/}" >> $GITHUB_OUTPUT
           fi
-          echo ::set-output name=commit::${GITHUB_SHA}
-          echo ::set-output name=build_date::$(date -u +'%Y-%m-%dT%H:%M:%SZ')
-          echo ::set-output name=docker_platforms::linux/amd64,linux/arm64/v8,linux/arm/v7,linux/arm/v6
-          echo ::set-output name=docker_image::${{ secrets.DOCKER_REPO }}/tautulli
+          echo "commit=${GITHUB_SHA}" >> $GITHUB_OUTPUT
+          echo "build_date=$(date -u +'%Y-%m-%dT%H:%M:%SZ')" >> $GITHUB_OUTPUT
+          echo "docker_platforms=linux/amd64,linux/arm64/v8,linux/arm/v7,linux/arm/v6" >> $GITHUB_OUTPUT
+          echo "docker_image=${{ secrets.DOCKER_REPO }}/tautulli" >> $GITHUB_OUTPUT
 
       - name: Set Up QEMU
         uses: docker/setup-qemu-action@v2
@@ -102,9 +102,9 @@ jobs:
         run: |
           failures=(neutral, skipped, timed_out, action_required)
           if [[ ${array[@]} =~ $WORKFLOW_CONCLUSION ]]; then
-            echo ::set-output name=status::failure
+            echo "status=failure" >> $GITHUB_OUTPUT
           else
-            echo ::set-output name=status::$WORKFLOW_CONCLUSION
+            echo "status=$WORKFLOW_CONCLUSION" >> $GITHUB_OUTPUT
           fi
 
       - name: Post Status to Discord
diff --git a/.github/workflows/publish-installers.yml b/.github/workflows/publish-installers.yml
index 00c5f722..dc616236 100644
--- a/.github/workflows/publish-installers.yml
+++ b/.github/workflows/publish-installers.yml
@@ -33,14 +33,14 @@ jobs:
           if [[ $GITHUB_REF == refs/tags/* ]]; then
             echo "VERSION=${GITHUB_REF#refs/tags/v}" >> $GITHUB_ENV
             VERSION_NSIS=${GITHUB_REF#refs/tags/v}.1
-            echo ::set-output name=VERSION_NSIS::${VERSION_NSIS/%-beta.1/.0}
-            echo ::set-output name=VERSION::${GITHUB_REF#refs/tags/v}
-            echo ::set-output name=RELEASE_VERSION::${GITHUB_REF#refs/tags/}
+            echo "VERSION_NSIS=${VERSION_NSIS/%-beta.1/.0}" >> $GITHUB_OUTPUT
+            echo "VERSION=${GITHUB_REF#refs/tags/v}" >> $GITHUB_OUTPUT
+            echo "RELEASE_VERSION=${GITHUB_REF#refs/tags/}" >> $GITHUB_OUTPUT
           else
             echo "VERSION=0.0.0" >> $GITHUB_ENV
-            echo ::set-output name=VERSION_NSIS::0.0.0.0
-            echo ::set-output name=VERSION::0.0.0
-            echo ::set-output name=RELEASE_VERSION::${GITHUB_SHA::7}
+            echo "VERSION_NSIS=0.0.0.0" >> $GITHUB_OUTPUT
+            echo "VERSION=0.0.0" >> $GITHUB_OUTPUT
+            echo "RELEASE_VERSION::${GITHUB_SHA=7}" >> $GITHUB_OUTPUT
           fi
           if [[ $GITHUB_REF == refs/tags/*-beta ]]; then
             echo "beta" > branch.txt
@@ -108,7 +108,7 @@ jobs:
       - name: Set Release Version
         id: get_version
         run: |
-          echo ::set-output name=RELEASE_VERSION::${GITHUB_REF#refs/tags/}
+          echo "RELEASE_VERSION=${GITHUB_REF#refs/tags/}" >> $GITHUB_OUTPUT
 
       - name: Download Installers
         if: env.WORKFLOW_CONCLUSION == 'success'
@@ -117,7 +117,7 @@ jobs:
       - name: Get Changelog
         id: get_changelog
         run: |
-          echo ::set-output name=CHANGELOG::"$( sed -n '/^## /{p; :loop n; p; /^## /q; b loop}' CHANGELOG.md \
+          echo "CHANGELOG="$( sed -n '/^## /{p; :loop n; p; /^## /q; b loop}' CHANGELOG.md \" >> $GITHUB_OUTPUT
             | sed '$d' | sed '$d' | sed '$d' | sed ':a;N;$!ba;s/\n/%0A/g' )"
 
       - name: Create Release
@@ -171,9 +171,9 @@ jobs:
         run: |
           failures=(neutral, skipped, timed_out, action_required)
           if [[ ${array[@]} =~ $WORKFLOW_CONCLUSION ]]; then
-            echo ::set-output name=status::failure
+            echo "status=failure" >> $GITHUB_OUTPUT
           else
-            echo ::set-output name=status::$WORKFLOW_CONCLUSION
+            echo "status=$WORKFLOW_CONCLUSION" >> $GITHUB_OUTPUT
           fi
 
       - name: Post Status to Discord
diff --git a/.github/workflows/publish-snap.yml b/.github/workflows/publish-snap.yml
index 81a4728f..da1959ea 100644
--- a/.github/workflows/publish-snap.yml
+++ b/.github/workflows/publish-snap.yml
@@ -27,11 +27,11 @@ jobs:
         run: |
           git fetch --prune --unshallow --tags
           if [[ $GITHUB_REF == refs/tags/*-beta || $GITHUB_REF == refs/heads/beta ]]; then
-            echo ::set-output name=RELEASE::beta
+            echo "RELEASE=beta" >> $GITHUB_OUTPUT
           elif [[ $GITHUB_REF == refs/tags/* || $GITHUB_REF == refs/heads/master ]]; then
-            echo ::set-output name=RELEASE::stable
+            echo "RELEASE=stable" >> $GITHUB_OUTPUT
           else
-            echo ::set-output name=RELEASE::edge
+            echo "RELEASE=edge" >> $GITHUB_OUTPUT
           fi
 
       - name: Set Up QEMU
@@ -77,9 +77,9 @@ jobs:
         run: |
           failures=(neutral, skipped, timed_out, action_required)
           if [[ ${array[@]} =~ $WORKFLOW_CONCLUSION ]]; then
-            echo ::set-output name=status::failure
+            echo "status=failure" >> $GITHUB_OUTPUT
           else
-            echo ::set-output name=status::$WORKFLOW_CONCLUSION
+            echo "status=$WORKFLOW_CONCLUSION" >> $GITHUB_OUTPUT
           fi
 
       - name: Post Status to Discord

From b1e2a30dc1dec95c73f6d1e557c292c7a47f5098 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 7 Nov 2022 12:31:17 -0800
Subject: [PATCH 196/743] Fix publish installer workflow

---
 .github/workflows/publish-installers.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/publish-installers.yml b/.github/workflows/publish-installers.yml
index dc616236..c04f338e 100644
--- a/.github/workflows/publish-installers.yml
+++ b/.github/workflows/publish-installers.yml
@@ -40,7 +40,7 @@ jobs:
             echo "VERSION=0.0.0" >> $GITHUB_ENV
             echo "VERSION_NSIS=0.0.0.0" >> $GITHUB_OUTPUT
             echo "VERSION=0.0.0" >> $GITHUB_OUTPUT
-            echo "RELEASE_VERSION::${GITHUB_SHA=7}" >> $GITHUB_OUTPUT
+            echo "RELEASE_VERSION=${GITHUB_SHA::7}" >> $GITHUB_OUTPUT
           fi
           if [[ $GITHUB_REF == refs/tags/*-beta ]]; then
             echo "beta" > branch.txt

From d7f6a1b186250bedbd46ae61888d80597b8ba976 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 7 Nov 2022 13:14:21 -0800
Subject: [PATCH 197/743] v2.10.5

---
 CHANGELOG.md      | 24 ++++++++++++++++++++++++
 plexpy/version.py |  2 +-
 2 files changed, 25 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index abd4cc2c..44da2582 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,29 @@
 # Changelog
 
+## v2.10.5 (2022-11-07)
+
+* Notifications:
+  * New: Added edition_title notification parameter. (#1838)
+  * Change: Track notifications link to MusicBrainz track instead of album.
+* Newsletters:
+  * New: Added months time frame for newsletters. (#1876)
+* UI:
+  * Fix: Broken link on library statistic cards. (#1852)
+  * Fix: Check for IPv6 host when generating QR code for app registration.
+  * Fix: Missing padding on condition operator dropdown on small screens.
+* Other:
+  * Fix: Launching browser when webserver is bound to IPv6.
+  * New: Tautulli can be installed via the Windows Package Manager (winget).
+  * Change: Separate stdout and stderr console logging. (#1874)
+* API:
+  * Fix: API not returning 400 response code.
+  * New: Added edition_title to get_metadata API response.
+  * New: Added collections to get_children_metadata API response.
+  * New: Added user_thumb to get_history API response.
+  * New: Validate custom notification conditions before saving notification agents. (#1846)
+  * Change: Fallback to parent_thumb for seasons in get_metadata API response.
+
+
 ## v2.10.4 (2022-09-05)
 
 * Activity:
diff --git a/plexpy/version.py b/plexpy/version.py
index a338dabd..6c3d1104 100644
--- a/plexpy/version.py
+++ b/plexpy/version.py
@@ -18,4 +18,4 @@
 from __future__ import unicode_literals
 
 PLEXPY_BRANCH = "master"
-PLEXPY_RELEASE_VERSION = "v2.10.4"
+PLEXPY_RELEASE_VERSION = "v2.10.5"

From 04d6bfbd7819f11348f6120497f04d60ccff4316 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 7 Nov 2022 13:22:37 -0800
Subject: [PATCH 198/743] Fix publish installer changelog

---
 .github/workflows/publish-installers.yml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/publish-installers.yml b/.github/workflows/publish-installers.yml
index c04f338e..1c5f075b 100644
--- a/.github/workflows/publish-installers.yml
+++ b/.github/workflows/publish-installers.yml
@@ -117,8 +117,9 @@ jobs:
       - name: Get Changelog
         id: get_changelog
         run: |
-          echo "CHANGELOG="$( sed -n '/^## /{p; :loop n; p; /^## /q; b loop}' CHANGELOG.md \" >> $GITHUB_OUTPUT
+          CHANGELOG="$( sed -n '/^## /{p; :loop n; p; /^## /q; b loop}' CHANGELOG.md \
             | sed '$d' | sed '$d' | sed '$d' | sed ':a;N;$!ba;s/\n/%0A/g' )"
+          echo "CHANGELOG=${CHANGELOG}" >> $GITHUB_OUTPUT
 
       - name: Create Release
         uses: actions/create-release@v1

From 38cc3bc7f2956d2b448255daa08735346dec97ca Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 7 Nov 2022 13:34:20 -0800
Subject: [PATCH 199/743] Update winget workflow token

[skip ci]
---
 .github/workflows/submit-winget.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/submit-winget.yml b/.github/workflows/submit-winget.yml
index de943c29..c295cd47 100644
--- a/.github/workflows/submit-winget.yml
+++ b/.github/workflows/submit-winget.yml
@@ -13,7 +13,7 @@ jobs:
       - name: Submit package to Windows Package Manager Community Repository
         run: |
           $wingetPackage = "Tautulli.Tautulli"
-          $gitToken = "${{ secrets.GITHUB_TOKEN }}"
+          $gitToken = "${{ secrets.WINGET_TOKEN }}"
 
           $github = Invoke-RestMethod -uri "https://api.github.com/repos/Tautulli/Tautulli/releases/latest"
           $installerUrl = $github | Select -ExpandProperty assets -First 1 | Where-Object -Property name -match "Tautulli-windows-.*-x64.exe" | Select -ExpandProperty browser_download_url

From 2ea85f31e7c146f9e1803644815fda9d86135cb3 Mon Sep 17 00:00:00 2001
From: Paarth Shah <mail@shahpaarth.com>
Date: Sat, 12 Nov 2022 16:48:40 -0800
Subject: [PATCH 200/743] Bump minimum python version in CONTRIBUTING.md.
 (#1854)

* Bump minimum python version in CONTRIBUTING.md.

* Fix random typo.

* More touch-ups.

[skip ci]
---
 CONTRIBUTING.md | 4 ++--
 Tautulli.py     | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index a415fb54..19644c56 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -9,12 +9,12 @@ All pull requests should be based on the `nightly` branch, to minimize cross mer
 ### Python Code
 
 #### Compatibility
-The code should work with Python 3.6+. Note that Tautulli runs on many different platforms.
+The code should work with Python 3.7+. Note that Tautulli runs on many different platforms.
 
 Re-use existing code. Do not hesitate to add logging in your code. You can the logger module `plexpy.logger.*` for this. Web requests are invoked via `plexpy.request.*` and derived ones. Use these methods to automatically add proper and meaningful error handling.
 
 #### Code conventions
-Although Tautulli did not adapt a code convention in the past, we try to follow the [PEP8](http://legacy.python.org/dev/peps/pep-0008/) conventions for future code. A short summary to remind you (copied from http://wiki.ros.org/PyStyleGuide):
+Although Tautulli did not adopt a code convention in the past, we try to follow [PEP8](http://legacy.python.org/dev/peps/pep-0008/) conventions for future code. A short summary to remind you (copied from http://wiki.ros.org/PyStyleGuide):
 
  * 4 space indentation
  * 80 characters per line
diff --git a/Tautulli.py b/Tautulli.py
index 85e30c04..ead27c31 100755
--- a/Tautulli.py
+++ b/Tautulli.py
@@ -246,7 +246,7 @@ def main():
     # Start the background threads
     plexpy.start()
 
-    # Force the http port if neccessary
+    # Force the http port if necessary
     if args.port:
         plexpy.HTTP_PORT = args.port
         logger.info('Using forced web server port: %i', plexpy.HTTP_PORT)

From a58a4ed6326e4e6a8428510fa7184cf067168dd5 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 12 Nov 2022 16:51:59 -0800
Subject: [PATCH 201/743] Bump pycryptodomex from 3.14.1 to 3.15.0 (#1773)

Bumps [pycryptodomex](https://github.com/Legrandin/pycryptodome) from 3.14.1 to 3.15.0.
- [Release notes](https://github.com/Legrandin/pycryptodome/releases)
- [Changelog](https://github.com/Legrandin/pycryptodome/blob/master/Changelog.rst)
- [Commits](https://github.com/Legrandin/pycryptodome/compare/v3.14.1...v3.15.0)

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

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

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 package/requirements-package.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index 997ebbfe..05d98fc2 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -3,7 +3,7 @@ importlib-metadata==4.11.4
 importlib-resources==5.7.1
 pyinstaller==5.1
 pyopenssl==22.0.0
-pycryptodomex==3.14.1
+pycryptodomex==3.15.0
 
 pyobjc-framework-Cocoa==8.5; platform_system == "Darwin"
 pyobjc-core==8.5; platform_system == "Darwin"

From 75e492556b9d6781e12cdcc7922634e49a0fd672 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 12 Nov 2022 16:52:16 -0800
Subject: [PATCH 202/743] Bump pyobjc-core from 8.5 to 9.0 (#1887)

Bumps [pyobjc-core](https://github.com/ronaldoussoren/pyobjc) from 8.5 to 9.0.
- [Release notes](https://github.com/ronaldoussoren/pyobjc/releases)
- [Changelog](https://github.com/ronaldoussoren/pyobjc/blob/master/docs/changelog.rst)
- [Commits](https://github.com/ronaldoussoren/pyobjc/compare/v8.5...v9.0)

---
updated-dependencies:
- dependency-name: pyobjc-core
  dependency-type: direct:production
  update-type: version-update:semver-major
...

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

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 package/requirements-package.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index 05d98fc2..7cc0e2d2 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -6,6 +6,6 @@ pyopenssl==22.0.0
 pycryptodomex==3.15.0
 
 pyobjc-framework-Cocoa==8.5; platform_system == "Darwin"
-pyobjc-core==8.5; platform_system == "Darwin"
+pyobjc-core==9.0; platform_system == "Darwin"
 
 pywin32==304; platform_system == "Windows"

From 65452f08ce25136f72f8d6692d3922ab3c170c08 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 12 Nov 2022 16:52:22 -0800
Subject: [PATCH 203/743] Bump importlib-metadata from 4.11.4 to 5.0.0 (#1856)

Bumps [importlib-metadata](https://github.com/python/importlib_metadata) from 4.11.4 to 5.0.0.
- [Release notes](https://github.com/python/importlib_metadata/releases)
- [Changelog](https://github.com/python/importlib_metadata/blob/main/CHANGES.rst)
- [Commits](https://github.com/python/importlib_metadata/compare/v4.11.4...v5.0.0)

---
updated-dependencies:
- dependency-name: importlib-metadata
  dependency-type: direct:production
  update-type: version-update:semver-major
...

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

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 package/requirements-package.txt | 2 +-
 requirements.txt                 | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index 7cc0e2d2..af03574f 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -1,5 +1,5 @@
 apscheduler==3.9.1
-importlib-metadata==4.11.4
+importlib-metadata==5.0.0
 importlib-resources==5.7.1
 pyinstaller==5.1
 pyopenssl==22.0.0
diff --git a/requirements.txt b/requirements.txt
index b0285a13..5544b9fc 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -18,7 +18,7 @@ gntp==1.0.3
 html5lib==1.1
 httpagentparser==1.9.2
 idna==3.3
-importlib-metadata==4.11.4
+importlib-metadata==5.0.0
 importlib-resources==5.7.1
 git+https://github.com/Tautulli/ipwhois.git@master#egg=ipwhois
 IPy==1.01

From 76a3b3d2a577f9ff6b344a0df06e745b58c46742 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 12 Nov 2022 17:00:33 -0800
Subject: [PATCH 204/743] Bump importlib-resources from 5.7.1 to 5.10.0 (#1862)

Bumps [importlib-resources](https://github.com/python/importlib_resources) from 5.7.1 to 5.10.0.
- [Release notes](https://github.com/python/importlib_resources/releases)
- [Changelog](https://github.com/python/importlib_resources/blob/main/CHANGES.rst)
- [Commits](https://github.com/python/importlib_resources/compare/v5.7.1...v5.10.0)

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

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

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

[skip ci]
---
 package/requirements-package.txt | 2 +-
 requirements.txt                 | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index af03574f..31d69fb5 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -1,6 +1,6 @@
 apscheduler==3.9.1
 importlib-metadata==5.0.0
-importlib-resources==5.7.1
+importlib-resources==5.10.0
 pyinstaller==5.1
 pyopenssl==22.0.0
 pycryptodomex==3.15.0
diff --git a/requirements.txt b/requirements.txt
index 5544b9fc..ad51d1d5 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -19,7 +19,7 @@ html5lib==1.1
 httpagentparser==1.9.2
 idna==3.3
 importlib-metadata==5.0.0
-importlib-resources==5.7.1
+importlib-resources==5.10.0
 git+https://github.com/Tautulli/ipwhois.git@master#egg=ipwhois
 IPy==1.01
 Mako==1.2.0

From b11b7e62e970004621908134d6c9ecdfcfe10984 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 12 Nov 2022 17:00:58 -0800
Subject: [PATCH 205/743] Bump pyinstaller from 5.1 to 5.6.2 (#1879)

Bumps [pyinstaller](https://github.com/pyinstaller/pyinstaller) from 5.1 to 5.6.2.
- [Release notes](https://github.com/pyinstaller/pyinstaller/releases)
- [Changelog](https://github.com/pyinstaller/pyinstaller/blob/develop/doc/CHANGES.rst)
- [Commits](https://github.com/pyinstaller/pyinstaller/compare/v5.1...v5.6.2)

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

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

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
---
 package/requirements-package.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index 31d69fb5..ce53967b 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -1,7 +1,7 @@
 apscheduler==3.9.1
 importlib-metadata==5.0.0
 importlib-resources==5.10.0
-pyinstaller==5.1
+pyinstaller==5.6.2
 pyopenssl==22.0.0
 pycryptodomex==3.15.0
 

From 20be945e8cd5194417542d7fe39d47e8f5f586ae Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 12 Nov 2022 17:03:24 -0800
Subject: [PATCH 206/743] Bump mshick/add-pr-comment from 1 to 2 (#1885)

Bumps [mshick/add-pr-comment](https://github.com/mshick/add-pr-comment) from 1 to 2.
- [Release notes](https://github.com/mshick/add-pr-comment/releases)
- [Commits](https://github.com/mshick/add-pr-comment/compare/v1...v2)

---
updated-dependencies:
- dependency-name: mshick/add-pr-comment
  dependency-type: direct:production
  update-type: version-update:semver-major
...

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

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 .github/workflows/pull-requests.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/pull-requests.yml b/.github/workflows/pull-requests.yml
index ff9a0839..d15b9140 100644
--- a/.github/workflows/pull-requests.yml
+++ b/.github/workflows/pull-requests.yml
@@ -13,7 +13,7 @@ jobs:
         uses: actions/checkout@v3.1.0
 
       - name: Comment on Pull Request
-        uses: mshick/add-pr-comment@v1
+        uses: mshick/add-pr-comment@v2
         if: github.base_ref != 'nightly'
         with:
           message: Pull requests must be made to the `nightly` branch. Thanks.

From 5bb9dbd0f6f933aaf4f14cc9e32c484aef1ff9b5 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 12 Nov 2022 17:02:37 -0800
Subject: [PATCH 207/743] Update importlib-metadata==5.0.0

[skip ci]
---
 lib/importlib_metadata/__init__.py    | 231 +++-----------------------
 lib/importlib_metadata/_compat.py     |   1 +
 lib/importlib_metadata/_py39compat.py |  48 ++++++
 3 files changed, 69 insertions(+), 211 deletions(-)
 create mode 100644 lib/importlib_metadata/_py39compat.py

diff --git a/lib/importlib_metadata/__init__.py b/lib/importlib_metadata/__init__.py
index 29ce1175..304b6d48 100644
--- a/lib/importlib_metadata/__init__.py
+++ b/lib/importlib_metadata/__init__.py
@@ -14,7 +14,7 @@ import itertools
 import posixpath
 import collections
 
-from . import _adapters, _meta
+from . import _adapters, _meta, _py39compat
 from ._collections import FreezableDefaultDict, Pair
 from ._compat import (
     NullFinder,
@@ -29,7 +29,7 @@ from contextlib import suppress
 from importlib import import_module
 from importlib.abc import MetaPathFinder
 from itertools import starmap
-from typing import List, Mapping, Optional, Union
+from typing import List, Mapping, Optional
 
 
 __all__ = [
@@ -189,6 +189,10 @@ class EntryPoint(DeprecatedTuple):
     following the attr, and following any extras.
     """
 
+    name: str
+    value: str
+    group: str
+
     dist: Optional['Distribution'] = None
 
     def __init__(self, name, value, group):
@@ -223,17 +227,6 @@ class EntryPoint(DeprecatedTuple):
         vars(self).update(dist=dist)
         return self
 
-    def __iter__(self):
-        """
-        Supply iter so one may construct dicts of EntryPoints by name.
-        """
-        msg = (
-            "Construction of dict of EntryPoints is deprecated in "
-            "favor of EntryPoints."
-        )
-        warnings.warn(msg, DeprecationWarning)
-        return iter((self.name, self))
-
     def matches(self, **params):
         """
         EntryPoint matches the given parameters.
@@ -279,77 +272,7 @@ class EntryPoint(DeprecatedTuple):
         return hash(self._key())
 
 
-class DeprecatedList(list):
-    """
-    Allow an otherwise immutable object to implement mutability
-    for compatibility.
-
-    >>> recwarn = getfixture('recwarn')
-    >>> dl = DeprecatedList(range(3))
-    >>> dl[0] = 1
-    >>> dl.append(3)
-    >>> del dl[3]
-    >>> dl.reverse()
-    >>> dl.sort()
-    >>> dl.extend([4])
-    >>> dl.pop(-1)
-    4
-    >>> dl.remove(1)
-    >>> dl += [5]
-    >>> dl + [6]
-    [1, 2, 5, 6]
-    >>> dl + (6,)
-    [1, 2, 5, 6]
-    >>> dl.insert(0, 0)
-    >>> dl
-    [0, 1, 2, 5]
-    >>> dl == [0, 1, 2, 5]
-    True
-    >>> dl == (0, 1, 2, 5)
-    True
-    >>> len(recwarn)
-    1
-    """
-
-    __slots__ = ()
-
-    _warn = functools.partial(
-        warnings.warn,
-        "EntryPoints list interface is deprecated. Cast to list if needed.",
-        DeprecationWarning,
-        stacklevel=pypy_partial(2),
-    )
-
-    def _wrap_deprecated_method(method_name: str):  # type: ignore
-        def wrapped(self, *args, **kwargs):
-            self._warn()
-            return getattr(super(), method_name)(*args, **kwargs)
-
-        return method_name, wrapped
-
-    locals().update(
-        map(
-            _wrap_deprecated_method,
-            '__setitem__ __delitem__ append reverse extend pop remove '
-            '__iadd__ insert sort'.split(),
-        )
-    )
-
-    def __add__(self, other):
-        if not isinstance(other, tuple):
-            self._warn()
-            other = tuple(other)
-        return self.__class__(tuple(self) + other)
-
-    def __eq__(self, other):
-        if not isinstance(other, tuple):
-            self._warn()
-            other = tuple(other)
-
-        return tuple(self).__eq__(other)
-
-
-class EntryPoints(DeprecatedList):
+class EntryPoints(tuple):
     """
     An immutable collection of selectable EntryPoint objects.
     """
@@ -360,14 +283,6 @@ class EntryPoints(DeprecatedList):
         """
         Get the EntryPoint in self matching name.
         """
-        if isinstance(name, int):
-            warnings.warn(
-                "Accessing entry points by index is deprecated. "
-                "Cast to tuple if needed.",
-                DeprecationWarning,
-                stacklevel=2,
-            )
-            return super().__getitem__(name)
         try:
             return next(iter(self.select(name=name)))
         except StopIteration:
@@ -378,7 +293,8 @@ class EntryPoints(DeprecatedList):
         Select entry points from self that match the
         given parameters (typically group and/or name).
         """
-        return EntryPoints(ep for ep in self if ep.matches(**params))
+        candidates = (_py39compat.ep_matches(ep, **params) for ep in self)
+        return EntryPoints(ep for ep, predicate in candidates if predicate)
 
     @property
     def names(self):
@@ -391,10 +307,6 @@ class EntryPoints(DeprecatedList):
     def groups(self):
         """
         Return the set of all groups of all entry points.
-
-        For coverage while SelectableGroups is present.
-        >>> EntryPoints().groups
-        set()
         """
         return {ep.group for ep in self}
 
@@ -410,101 +322,6 @@ class EntryPoints(DeprecatedList):
         )
 
 
-class Deprecated:
-    """
-    Compatibility add-in for mapping to indicate that
-    mapping behavior is deprecated.
-
-    >>> recwarn = getfixture('recwarn')
-    >>> class DeprecatedDict(Deprecated, dict): pass
-    >>> dd = DeprecatedDict(foo='bar')
-    >>> dd.get('baz', None)
-    >>> dd['foo']
-    'bar'
-    >>> list(dd)
-    ['foo']
-    >>> list(dd.keys())
-    ['foo']
-    >>> 'foo' in dd
-    True
-    >>> list(dd.values())
-    ['bar']
-    >>> len(recwarn)
-    1
-    """
-
-    _warn = functools.partial(
-        warnings.warn,
-        "SelectableGroups dict interface is deprecated. Use select.",
-        DeprecationWarning,
-        stacklevel=pypy_partial(2),
-    )
-
-    def __getitem__(self, name):
-        self._warn()
-        return super().__getitem__(name)
-
-    def get(self, name, default=None):
-        self._warn()
-        return super().get(name, default)
-
-    def __iter__(self):
-        self._warn()
-        return super().__iter__()
-
-    def __contains__(self, *args):
-        self._warn()
-        return super().__contains__(*args)
-
-    def keys(self):
-        self._warn()
-        return super().keys()
-
-    def values(self):
-        self._warn()
-        return super().values()
-
-
-class SelectableGroups(Deprecated, dict):
-    """
-    A backward- and forward-compatible result from
-    entry_points that fully implements the dict interface.
-    """
-
-    @classmethod
-    def load(cls, eps):
-        by_group = operator.attrgetter('group')
-        ordered = sorted(eps, key=by_group)
-        grouped = itertools.groupby(ordered, by_group)
-        return cls((group, EntryPoints(eps)) for group, eps in grouped)
-
-    @property
-    def _all(self):
-        """
-        Reconstruct a list of all entrypoints from the groups.
-        """
-        groups = super(Deprecated, self).values()
-        return EntryPoints(itertools.chain.from_iterable(groups))
-
-    @property
-    def groups(self):
-        return self._all.groups
-
-    @property
-    def names(self):
-        """
-        for coverage:
-        >>> SelectableGroups().names
-        set()
-        """
-        return self._all.names
-
-    def select(self, **params):
-        if not params:
-            return self
-        return self._all.select(**params)
-
-
 class PackagePath(pathlib.PurePosixPath):
     """A reference to a path in a package"""
 
@@ -548,7 +365,7 @@ class Distribution:
         """
 
     @classmethod
-    def from_name(cls, name):
+    def from_name(cls, name: str):
         """Return the Distribution for the given package name.
 
         :param name: The name of the distribution package to search for.
@@ -556,13 +373,13 @@ class Distribution:
             package, if found.
         :raises PackageNotFoundError: When the named package's distribution
             metadata cannot be found.
+        :raises ValueError: When an invalid value is supplied for name.
         """
-        for resolver in cls._discover_resolvers():
-            dists = resolver(DistributionFinder.Context(name=name))
-            dist = next(iter(dists), None)
-            if dist is not None:
-                return dist
-        else:
+        if not name:
+            raise ValueError("A distribution name is required.")
+        try:
+            return next(cls.discover(name=name))
+        except StopIteration:
             raise PackageNotFoundError(name)
 
     @classmethod
@@ -1017,34 +834,26 @@ def version(distribution_name):
 
 _unique = functools.partial(
     unique_everseen,
-    key=operator.attrgetter('_normalized_name'),
+    key=_py39compat.normalized_name,
 )
 """
 Wrapper for ``distributions`` to return unique distributions by name.
 """
 
 
-def entry_points(**params) -> Union[EntryPoints, SelectableGroups]:
+def entry_points(**params) -> EntryPoints:
     """Return EntryPoint objects for all installed packages.
 
     Pass selection parameters (group or name) to filter the
     result to entry points matching those properties (see
     EntryPoints.select()).
 
-    For compatibility, returns ``SelectableGroups`` object unless
-    selection parameters are supplied. In the future, this function
-    will return ``EntryPoints`` instead of ``SelectableGroups``
-    even when no selection parameters are supplied.
-
-    For maximum future compatibility, pass selection parameters
-    or invoke ``.select`` with parameters on the result.
-
-    :return: EntryPoints or SelectableGroups for all installed packages.
+    :return: EntryPoints for all installed packages.
     """
     eps = itertools.chain.from_iterable(
         dist.entry_points for dist in _unique(distributions())
     )
-    return SelectableGroups.load(eps).select(**params)
+    return EntryPoints(eps).select(**params)
 
 
 def files(distribution_name):
diff --git a/lib/importlib_metadata/_compat.py b/lib/importlib_metadata/_compat.py
index 8fe4e4e3..3d78566e 100644
--- a/lib/importlib_metadata/_compat.py
+++ b/lib/importlib_metadata/_compat.py
@@ -8,6 +8,7 @@ __all__ = ['install', 'NullFinder', 'Protocol']
 try:
     from typing import Protocol
 except ImportError:  # pragma: no cover
+    # Python 3.7 compatibility
     from typing_extensions import Protocol  # type: ignore
 
 
diff --git a/lib/importlib_metadata/_py39compat.py b/lib/importlib_metadata/_py39compat.py
new file mode 100644
index 00000000..cf9cc124
--- /dev/null
+++ b/lib/importlib_metadata/_py39compat.py
@@ -0,0 +1,48 @@
+"""
+Compatibility layer with Python 3.8/3.9
+"""
+from typing import TYPE_CHECKING, Any, Optional, Tuple
+
+if TYPE_CHECKING:  # pragma: no cover
+    # Prevent circular imports on runtime.
+    from . import Distribution, EntryPoint
+else:
+    Distribution = EntryPoint = Any
+
+
+def normalized_name(dist: Distribution) -> Optional[str]:
+    """
+    Honor name normalization for distributions that don't provide ``_normalized_name``.
+    """
+    try:
+        return dist._normalized_name
+    except AttributeError:
+        from . import Prepared  # -> delay to prevent circular imports.
+
+        return Prepared.normalize(getattr(dist, "name", None) or dist.metadata['Name'])
+
+
+def ep_matches(ep: EntryPoint, **params) -> Tuple[EntryPoint, bool]:
+    """
+    Workaround for ``EntryPoint`` objects without the ``matches`` method.
+    For the sake of convenience, a tuple is returned containing not only the
+    boolean value corresponding to the predicate evalutation, but also a compatible
+    ``EntryPoint`` object that can be safely used at a later stage.
+
+    For example, the following sequences of expressions should be compatible:
+
+        # Sequence 1: using the compatibility layer
+        candidates = (_py39compat.ep_matches(ep, **params) for ep in entry_points)
+        [ep for ep, predicate in candidates if predicate]
+
+        # Sequence 2: using Python 3.9+
+        [ep for ep in entry_points if ep.matches(**params)]
+    """
+    try:
+        return ep, ep.matches(**params)
+    except AttributeError:
+        from . import EntryPoint  # -> delay to prevent circular imports.
+
+        # Reconstruct the EntryPoint object to make sure it is compatible.
+        _ep = EntryPoint(ep.name, ep.value, ep.group)
+        return _ep, _ep.matches(**params)

From c73450c0db8572572bb415acc902a55d4d31c6b2 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 12 Nov 2022 17:02:51 -0800
Subject: [PATCH 208/743] Update importlib-resources==5.10.0

[skip ci]
---
 lib/importlib_resources/__init__.py           |   2 +-
 lib/importlib_resources/_common.py            | 147 +++++++++++++++---
 lib/importlib_resources/_legacy.py            |   3 +-
 lib/importlib_resources/abc.py                |  26 +++-
 lib/importlib_resources/readers.py            |  16 +-
 lib/importlib_resources/simple.py             |  79 ++++------
 lib/importlib_resources/tests/_compat.py      |  15 +-
 lib/importlib_resources/tests/_path.py        |  50 ++++++
 lib/importlib_resources/tests/test_files.py   |  68 +++++++-
 lib/importlib_resources/tests/test_reader.py  |   5 +
 .../tests/test_resource.py                    |   8 +
 lib/importlib_resources/tests/util.py         |  17 +-
 12 files changed, 335 insertions(+), 101 deletions(-)
 create mode 100644 lib/importlib_resources/tests/_path.py

diff --git a/lib/importlib_resources/__init__.py b/lib/importlib_resources/__init__.py
index 15f6b26b..34e3a995 100644
--- a/lib/importlib_resources/__init__.py
+++ b/lib/importlib_resources/__init__.py
@@ -17,7 +17,7 @@ from ._legacy import (
     Resource,
 )
 
-from importlib_resources.abc import ResourceReader
+from .abc import ResourceReader
 
 
 __all__ = [
diff --git a/lib/importlib_resources/_common.py b/lib/importlib_resources/_common.py
index a12e2c75..9f19784d 100644
--- a/lib/importlib_resources/_common.py
+++ b/lib/importlib_resources/_common.py
@@ -5,25 +5,58 @@ import functools
 import contextlib
 import types
 import importlib
+import inspect
+import warnings
+import itertools
 
-from typing import Union, Optional
+from typing import Union, Optional, cast
 from .abc import ResourceReader, Traversable
 
 from ._compat import wrap_spec
 
 Package = Union[types.ModuleType, str]
+Anchor = Package
 
 
-def files(package):
-    # type: (Package) -> Traversable
+def package_to_anchor(func):
     """
-    Get a Traversable resource from a package
+    Replace 'package' parameter as 'anchor' and warn about the change.
+
+    Other errors should fall through.
+
+    >>> files('a', 'b')
+    Traceback (most recent call last):
+    TypeError: files() takes from 0 to 1 positional arguments but 2 were given
     """
-    return from_package(get_package(package))
+    undefined = object()
+
+    @functools.wraps(func)
+    def wrapper(anchor=undefined, package=undefined):
+        if package is not undefined:
+            if anchor is not undefined:
+                return func(anchor, package)
+            warnings.warn(
+                "First parameter to files is renamed to 'anchor'",
+                DeprecationWarning,
+                stacklevel=2,
+            )
+            return func(package)
+        elif anchor is undefined:
+            return func()
+        return func(anchor)
+
+    return wrapper
 
 
-def get_resource_reader(package):
-    # type: (types.ModuleType) -> Optional[ResourceReader]
+@package_to_anchor
+def files(anchor: Optional[Anchor] = None) -> Traversable:
+    """
+    Get a Traversable resource for an anchor.
+    """
+    return from_package(resolve(anchor))
+
+
+def get_resource_reader(package: types.ModuleType) -> Optional[ResourceReader]:
     """
     Return the package's loader if it's a ResourceReader.
     """
@@ -39,24 +72,39 @@ def get_resource_reader(package):
     return reader(spec.name)  # type: ignore
 
 
-def resolve(cand):
-    # type: (Package) -> types.ModuleType
-    return cand if isinstance(cand, types.ModuleType) else importlib.import_module(cand)
+@functools.singledispatch
+def resolve(cand: Optional[Anchor]) -> types.ModuleType:
+    return cast(types.ModuleType, cand)
 
 
-def get_package(package):
-    # type: (Package) -> types.ModuleType
-    """Take a package name or module object and return the module.
+@resolve.register
+def _(cand: str) -> types.ModuleType:
+    return importlib.import_module(cand)
 
-    Raise an exception if the resolved module is not a package.
+
+@resolve.register
+def _(cand: None) -> types.ModuleType:
+    return resolve(_infer_caller().f_globals['__name__'])
+
+
+def _infer_caller():
     """
-    resolved = resolve(package)
-    if wrap_spec(resolved).submodule_search_locations is None:
-        raise TypeError(f'{package!r} is not a package')
-    return resolved
+    Walk the stack and find the frame of the first caller not in this module.
+    """
+
+    def is_this_file(frame_info):
+        return frame_info.filename == __file__
+
+    def is_wrapper(frame_info):
+        return frame_info.function == 'wrapper'
+
+    not_this_file = itertools.filterfalse(is_this_file, inspect.stack())
+    # also exclude 'wrapper' due to singledispatch in the call stack
+    callers = itertools.filterfalse(is_wrapper, not_this_file)
+    return next(callers).frame
 
 
-def from_package(package):
+def from_package(package: types.ModuleType):
     """
     Return a Traversable object for the given package.
 
@@ -67,7 +115,14 @@ def from_package(package):
 
 
 @contextlib.contextmanager
-def _tempfile(reader, suffix=''):
+def _tempfile(
+    reader,
+    suffix='',
+    # gh-93353: Keep a reference to call os.remove() in late Python
+    # finalization.
+    *,
+    _os_remove=os.remove,
+):
     # Not using tempfile.NamedTemporaryFile as it leads to deeper 'try'
     # blocks due to the need to close the temporary file to work on Windows
     # properly.
@@ -81,18 +136,35 @@ def _tempfile(reader, suffix=''):
         yield pathlib.Path(raw_path)
     finally:
         try:
-            os.remove(raw_path)
+            _os_remove(raw_path)
         except FileNotFoundError:
             pass
 
 
+def _temp_file(path):
+    return _tempfile(path.read_bytes, suffix=path.name)
+
+
+def _is_present_dir(path: Traversable) -> bool:
+    """
+    Some Traversables implement ``is_dir()`` to raise an
+    exception (i.e. ``FileNotFoundError``) when the
+    directory doesn't exist. This function wraps that call
+    to always return a boolean and only return True
+    if there's a dir and it exists.
+    """
+    with contextlib.suppress(FileNotFoundError):
+        return path.is_dir()
+    return False
+
+
 @functools.singledispatch
 def as_file(path):
     """
     Given a Traversable object, return that object as a
     path on the local file system in a context manager.
     """
-    return _tempfile(path.read_bytes, suffix=path.name)
+    return _temp_dir(path) if _is_present_dir(path) else _temp_file(path)
 
 
 @as_file.register(pathlib.Path)
@@ -102,3 +174,34 @@ def _(path):
     Degenerate behavior for pathlib.Path objects.
     """
     yield path
+
+
+@contextlib.contextmanager
+def _temp_path(dir: tempfile.TemporaryDirectory):
+    """
+    Wrap tempfile.TemporyDirectory to return a pathlib object.
+    """
+    with dir as result:
+        yield pathlib.Path(result)
+
+
+@contextlib.contextmanager
+def _temp_dir(path):
+    """
+    Given a traversable dir, recursively replicate the whole tree
+    to the file system in a context manager.
+    """
+    assert path.is_dir()
+    with _temp_path(tempfile.TemporaryDirectory()) as temp_dir:
+        yield _write_contents(temp_dir, path)
+
+
+def _write_contents(target, source):
+    child = target.joinpath(source.name)
+    if source.is_dir():
+        child.mkdir()
+        for item in source.iterdir():
+            _write_contents(child, item)
+    else:
+        child.open('wb').write(source.read_bytes())
+    return child
diff --git a/lib/importlib_resources/_legacy.py b/lib/importlib_resources/_legacy.py
index 1d5d3f1f..b1ea8105 100644
--- a/lib/importlib_resources/_legacy.py
+++ b/lib/importlib_resources/_legacy.py
@@ -27,8 +27,7 @@ def deprecated(func):
     return wrapper
 
 
-def normalize_path(path):
-    # type: (Any) -> str
+def normalize_path(path: Any) -> str:
     """Normalize a path by ensuring it is a string.
 
     If the resulting string contains path separators, an exception is raised.
diff --git a/lib/importlib_resources/abc.py b/lib/importlib_resources/abc.py
index 5e38ba61..23b6aeaf 100644
--- a/lib/importlib_resources/abc.py
+++ b/lib/importlib_resources/abc.py
@@ -1,5 +1,7 @@
 import abc
 import io
+import itertools
+import pathlib
 from typing import Any, BinaryIO, Iterable, Iterator, NoReturn, Text, Optional
 
 from ._compat import runtime_checkable, Protocol, StrPath
@@ -50,6 +52,10 @@ class ResourceReader(metaclass=abc.ABCMeta):
         raise FileNotFoundError
 
 
+class TraversalError(Exception):
+    pass
+
+
 @runtime_checkable
 class Traversable(Protocol):
     """
@@ -92,7 +98,6 @@ class Traversable(Protocol):
         Return True if self is a file
         """
 
-    @abc.abstractmethod
     def joinpath(self, *descendants: StrPath) -> "Traversable":
         """
         Return Traversable resolved with any descendants applied.
@@ -101,6 +106,22 @@ class Traversable(Protocol):
         and each may contain multiple levels separated by
         ``posixpath.sep`` (``/``).
         """
+        if not descendants:
+            return self
+        names = itertools.chain.from_iterable(
+            path.parts for path in map(pathlib.PurePosixPath, descendants)
+        )
+        target = next(names)
+        matches = (
+            traversable for traversable in self.iterdir() if traversable.name == target
+        )
+        try:
+            match = next(matches)
+        except StopIteration:
+            raise TraversalError(
+                "Target not found during traversal.", target, list(names)
+            )
+        return match.joinpath(*names)
 
     def __truediv__(self, child: StrPath) -> "Traversable":
         """
@@ -118,7 +139,8 @@ class Traversable(Protocol):
         accepted by io.TextIOWrapper.
         """
 
-    @abc.abstractproperty
+    @property
+    @abc.abstractmethod
     def name(self) -> str:
         """
         The base name of this object without any parent references.
diff --git a/lib/importlib_resources/readers.py b/lib/importlib_resources/readers.py
index f1190ca4..ab34db74 100644
--- a/lib/importlib_resources/readers.py
+++ b/lib/importlib_resources/readers.py
@@ -82,15 +82,13 @@ class MultiplexedPath(abc.Traversable):
     def is_file(self):
         return False
 
-    def joinpath(self, child):
-        # first try to find child in current paths
-        for file in self.iterdir():
-            if file.name == child:
-                return file
-        # if it does not exist, construct it with the first path
-        return self._paths[0] / child
-
-    __truediv__ = joinpath
+    def joinpath(self, *descendants):
+        try:
+            return super().joinpath(*descendants)
+        except abc.TraversalError:
+            # One of the paths did not resolve (a directory does not exist).
+            # Just return something that will not exist.
+            return self._paths[0].joinpath(*descendants)
 
     def open(self, *args, **kwargs):
         raise FileNotFoundError(f'{self} is not a file')
diff --git a/lib/importlib_resources/simple.py b/lib/importlib_resources/simple.py
index d0fbf237..7770c922 100644
--- a/lib/importlib_resources/simple.py
+++ b/lib/importlib_resources/simple.py
@@ -16,31 +16,28 @@ class SimpleReader(abc.ABC):
     provider.
     """
 
-    @abc.abstractproperty
-    def package(self):
-        # type: () -> str
+    @property
+    @abc.abstractmethod
+    def package(self) -> str:
         """
         The name of the package for which this reader loads resources.
         """
 
     @abc.abstractmethod
-    def children(self):
-        # type: () -> List['SimpleReader']
+    def children(self) -> List['SimpleReader']:
         """
         Obtain an iterable of SimpleReader for available
         child containers (e.g. directories).
         """
 
     @abc.abstractmethod
-    def resources(self):
-        # type: () -> List[str]
+    def resources(self) -> List[str]:
         """
         Obtain available named resources for this virtual package.
         """
 
     @abc.abstractmethod
-    def open_binary(self, resource):
-        # type: (str) -> BinaryIO
+    def open_binary(self, resource: str) -> BinaryIO:
         """
         Obtain a File-like for a named resource.
         """
@@ -50,13 +47,35 @@ class SimpleReader(abc.ABC):
         return self.package.split('.')[-1]
 
 
+class ResourceContainer(Traversable):
+    """
+    Traversable container for a package's resources via its reader.
+    """
+
+    def __init__(self, reader: SimpleReader):
+        self.reader = reader
+
+    def is_dir(self):
+        return True
+
+    def is_file(self):
+        return False
+
+    def iterdir(self):
+        files = (ResourceHandle(self, name) for name in self.reader.resources)
+        dirs = map(ResourceContainer, self.reader.children())
+        return itertools.chain(files, dirs)
+
+    def open(self, *args, **kwargs):
+        raise IsADirectoryError()
+
+
 class ResourceHandle(Traversable):
     """
     Handle to a named resource in a ResourceReader.
     """
 
-    def __init__(self, parent, name):
-        # type: (ResourceContainer, str) -> None
+    def __init__(self, parent: ResourceContainer, name: str):
         self.parent = parent
         self.name = name  # type: ignore
 
@@ -76,44 +95,6 @@ class ResourceHandle(Traversable):
         raise RuntimeError("Cannot traverse into a resource")
 
 
-class ResourceContainer(Traversable):
-    """
-    Traversable container for a package's resources via its reader.
-    """
-
-    def __init__(self, reader):
-        # type: (SimpleReader) -> None
-        self.reader = reader
-
-    def is_dir(self):
-        return True
-
-    def is_file(self):
-        return False
-
-    def iterdir(self):
-        files = (ResourceHandle(self, name) for name in self.reader.resources)
-        dirs = map(ResourceContainer, self.reader.children())
-        return itertools.chain(files, dirs)
-
-    def open(self, *args, **kwargs):
-        raise IsADirectoryError()
-
-    @staticmethod
-    def _flatten(compound_names):
-        for name in compound_names:
-            yield from name.split('/')
-
-    def joinpath(self, *descendants):
-        if not descendants:
-            return self
-        names = self._flatten(descendants)
-        target = next(names)
-        return next(
-            traversable for traversable in self.iterdir() if traversable.name == target
-        ).joinpath(*names)
-
-
 class TraversableReader(TraversableResources, SimpleReader):
     """
     A TraversableResources based on SimpleReader. Resource providers
diff --git a/lib/importlib_resources/tests/_compat.py b/lib/importlib_resources/tests/_compat.py
index 4c99cffd..e7bf06dd 100644
--- a/lib/importlib_resources/tests/_compat.py
+++ b/lib/importlib_resources/tests/_compat.py
@@ -6,7 +6,20 @@ try:
 except ImportError:
     # Python 3.9 and earlier
     class import_helper:  # type: ignore
-        from test.support import modules_setup, modules_cleanup
+        from test.support import (
+            modules_setup,
+            modules_cleanup,
+            DirsOnSysPath,
+            CleanImport,
+        )
+
+
+try:
+    from test.support import os_helper  # type: ignore
+except ImportError:
+    # Python 3.9 compat
+    class os_helper:  # type:ignore
+        from test.support import temp_dir
 
 
 try:
diff --git a/lib/importlib_resources/tests/_path.py b/lib/importlib_resources/tests/_path.py
new file mode 100644
index 00000000..c630e4d3
--- /dev/null
+++ b/lib/importlib_resources/tests/_path.py
@@ -0,0 +1,50 @@
+import pathlib
+import functools
+
+
+####
+# from jaraco.path 3.4
+
+
+def build(spec, prefix=pathlib.Path()):
+    """
+    Build a set of files/directories, as described by the spec.
+
+    Each key represents a pathname, and the value represents
+    the content. Content may be a nested directory.
+
+    >>> spec = {
+    ...     'README.txt': "A README file",
+    ...     "foo": {
+    ...         "__init__.py": "",
+    ...         "bar": {
+    ...             "__init__.py": "",
+    ...         },
+    ...         "baz.py": "# Some code",
+    ...     }
+    ... }
+    >>> tmpdir = getfixture('tmpdir')
+    >>> build(spec, tmpdir)
+    """
+    for name, contents in spec.items():
+        create(contents, pathlib.Path(prefix) / name)
+
+
+@functools.singledispatch
+def create(content, path):
+    path.mkdir(exist_ok=True)
+    build(content, prefix=path)  # type: ignore
+
+
+@create.register
+def _(content: bytes, path):
+    path.write_bytes(content)
+
+
+@create.register
+def _(content: str, path):
+    path.write_text(content)
+
+
+# end from jaraco.path
+####
diff --git a/lib/importlib_resources/tests/test_files.py b/lib/importlib_resources/tests/test_files.py
index 2676b49e..d258fb5f 100644
--- a/lib/importlib_resources/tests/test_files.py
+++ b/lib/importlib_resources/tests/test_files.py
@@ -1,10 +1,23 @@
 import typing
+import textwrap
 import unittest
+import warnings
+import importlib
+import contextlib
 
 import importlib_resources as resources
-from importlib_resources.abc import Traversable
+from ..abc import Traversable
 from . import data01
 from . import util
+from . import _path
+from ._compat import os_helper, import_helper
+
+
+@contextlib.contextmanager
+def suppress_known_deprecation():
+    with warnings.catch_warnings(record=True) as ctx:
+        warnings.simplefilter('default', category=DeprecationWarning)
+        yield ctx
 
 
 class FilesTests:
@@ -25,6 +38,14 @@ class FilesTests:
     def test_traversable(self):
         assert isinstance(resources.files(self.data), Traversable)
 
+    def test_old_parameter(self):
+        """
+        Files used to take a 'package' parameter. Make sure anyone
+        passing by name is still supported.
+        """
+        with suppress_known_deprecation():
+            resources.files(package=self.data)
+
 
 class OpenDiskTests(FilesTests, unittest.TestCase):
     def setUp(self):
@@ -42,5 +63,50 @@ class OpenNamespaceTests(FilesTests, unittest.TestCase):
         self.data = namespacedata01
 
 
+class SiteDir:
+    def setUp(self):
+        self.fixtures = contextlib.ExitStack()
+        self.addCleanup(self.fixtures.close)
+        self.site_dir = self.fixtures.enter_context(os_helper.temp_dir())
+        self.fixtures.enter_context(import_helper.DirsOnSysPath(self.site_dir))
+        self.fixtures.enter_context(import_helper.CleanImport())
+
+
+class ModulesFilesTests(SiteDir, unittest.TestCase):
+    def test_module_resources(self):
+        """
+        A module can have resources found adjacent to the module.
+        """
+        spec = {
+            'mod.py': '',
+            'res.txt': 'resources are the best',
+        }
+        _path.build(spec, self.site_dir)
+        import mod
+
+        actual = resources.files(mod).joinpath('res.txt').read_text()
+        assert actual == spec['res.txt']
+
+
+class ImplicitContextFilesTests(SiteDir, unittest.TestCase):
+    def test_implicit_files(self):
+        """
+        Without any parameter, files() will infer the location as the caller.
+        """
+        spec = {
+            'somepkg': {
+                '__init__.py': textwrap.dedent(
+                    """
+                    import importlib_resources as res
+                    val = res.files().joinpath('res.txt').read_text()
+                    """
+                ),
+                'res.txt': 'resources are the best',
+            },
+        }
+        _path.build(spec, self.site_dir)
+        assert importlib.import_module('somepkg').val == 'resources are the best'
+
+
 if __name__ == '__main__':
     unittest.main()
diff --git a/lib/importlib_resources/tests/test_reader.py b/lib/importlib_resources/tests/test_reader.py
index 16841a50..1c8ebeeb 100644
--- a/lib/importlib_resources/tests/test_reader.py
+++ b/lib/importlib_resources/tests/test_reader.py
@@ -75,6 +75,11 @@ class MultiplexedPathTest(unittest.TestCase):
             str(path.joinpath('imaginary'))[len(prefix) + 1 :],
             os.path.join('namespacedata01', 'imaginary'),
         )
+        self.assertEqual(path.joinpath(), path)
+
+    def test_join_path_compound(self):
+        path = MultiplexedPath(self.folder)
+        assert not path.joinpath('imaginary/foo.py').exists()
 
     def test_repr(self):
         self.assertEqual(
diff --git a/lib/importlib_resources/tests/test_resource.py b/lib/importlib_resources/tests/test_resource.py
index 5affd8b0..82390271 100644
--- a/lib/importlib_resources/tests/test_resource.py
+++ b/lib/importlib_resources/tests/test_resource.py
@@ -111,6 +111,14 @@ class ResourceFromZipsTest01(util.ZipSetupBase, unittest.TestCase):
             {'__init__.py', 'binary.file'},
         )
 
+    def test_as_file_directory(self):
+        with resources.as_file(resources.files('ziptestdata')) as data:
+            assert data.name == 'ziptestdata'
+            assert data.is_dir()
+            assert data.joinpath('subdirectory').is_dir()
+            assert len(list(data.iterdir()))
+        assert not data.parent.exists()
+
 
 class ResourceFromZipsTest02(util.ZipSetupBase, unittest.TestCase):
     ZIP_MODULE = zipdata02  # type: ignore
diff --git a/lib/importlib_resources/tests/util.py b/lib/importlib_resources/tests/util.py
index c6d83e4b..b596c0ce 100644
--- a/lib/importlib_resources/tests/util.py
+++ b/lib/importlib_resources/tests/util.py
@@ -3,7 +3,7 @@ import importlib
 import io
 import sys
 import types
-from pathlib import Path, PurePath
+import pathlib
 
 from . import data01
 from . import zipdata01
@@ -94,7 +94,7 @@ class CommonTests(metaclass=abc.ABCMeta):
 
     def test_pathlib_path(self):
         # Passing in a pathlib.PurePath object for the path should succeed.
-        path = PurePath('utf-8.file')
+        path = pathlib.PurePath('utf-8.file')
         self.execute(data01, path)
 
     def test_importing_module_as_side_effect(self):
@@ -102,17 +102,6 @@ class CommonTests(metaclass=abc.ABCMeta):
         del sys.modules[data01.__name__]
         self.execute(data01.__name__, 'utf-8.file')
 
-    def test_non_package_by_name(self):
-        # The anchor package cannot be a module.
-        with self.assertRaises(TypeError):
-            self.execute(__name__, 'utf-8.file')
-
-    def test_non_package_by_package(self):
-        # The anchor package cannot be a module.
-        with self.assertRaises(TypeError):
-            module = sys.modules['importlib_resources.tests.util']
-            self.execute(module, 'utf-8.file')
-
     def test_missing_path(self):
         # Attempting to open or read or request the path for a
         # non-existent path should succeed if open_resource
@@ -144,7 +133,7 @@ class ZipSetupBase:
 
     @classmethod
     def setUpClass(cls):
-        data_path = Path(cls.ZIP_MODULE.__file__)
+        data_path = pathlib.Path(cls.ZIP_MODULE.__file__)
         data_dir = data_path.parent
         cls._zip_path = str(data_dir / 'ziptestdata.zip')
         sys.path.append(cls._zip_path)

From cc0c4b638de796c57fc8fef700ed1ea4ad0776c2 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 12 Nov 2022 17:10:26 -0800
Subject: [PATCH 209/743] Bump urllib3 from 1.26.9 to 1.26.12 (#1823)

Bumps [urllib3](https://github.com/urllib3/urllib3) from 1.26.9 to 1.26.12.
- [Release notes](https://github.com/urllib3/urllib3/releases)
- [Changelog](https://github.com/urllib3/urllib3/blob/main/CHANGES.rst)
- [Commits](https://github.com/urllib3/urllib3/compare/1.26.9...1.26.12)

---
updated-dependencies:
- dependency-name: urllib3
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements.txt b/requirements.txt
index ad51d1d5..c987e114 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -45,7 +45,7 @@ tempora==5.0.1
 tokenize-rt==4.2.1
 tzdata==2022.1
 tzlocal==4.2
-urllib3==1.26.9
+urllib3==1.26.12
 webencodings==0.5.1
 websocket-client==1.3.2
 xmltodict==0.13.0

From fbb016a7fd9549d6d65dcb0a6e37ab0a8e719fdd Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 12 Nov 2022 17:10:37 -0800
Subject: [PATCH 210/743] Bump certifi from 2022.5.18.1 to 2022.9.24 (#1849)

Bumps [certifi](https://github.com/certifi/python-certifi) from 2022.5.18.1 to 2022.9.24.
- [Release notes](https://github.com/certifi/python-certifi/releases)
- [Commits](https://github.com/certifi/python-certifi/compare/2022.05.18.1...2022.09.24)

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

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

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements.txt b/requirements.txt
index c987e114..d7b48f64 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -6,7 +6,7 @@ backports.functools-lru-cache==1.6.4
 backports.zoneinfo==0.2.1
 beautifulsoup4==4.11.1
 bleach==5.0.0
-certifi==2022.5.18.1
+certifi==2022.9.24
 cheroot==8.6.0
 cherrypy==18.6.1
 cloudinary==1.29.0

From 21f5fee4038721782d90bc0f0babe9f9b7638e68 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 12 Nov 2022 17:11:08 -0800
Subject: [PATCH 211/743] Bump idna from 3.3 to 3.4 (#1835)

Bumps [idna](https://github.com/kjd/idna) from 3.3 to 3.4.
- [Release notes](https://github.com/kjd/idna/releases)
- [Changelog](https://github.com/kjd/idna/blob/master/HISTORY.rst)
- [Commits](https://github.com/kjd/idna/compare/v3.3...v3.4)

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

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

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

[skip ci]
---
 requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements.txt b/requirements.txt
index d7b48f64..2e5930f3 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -17,7 +17,7 @@ future==0.18.2
 gntp==1.0.3
 html5lib==1.1
 httpagentparser==1.9.2
-idna==3.3
+idna==3.4
 importlib-metadata==5.0.0
 importlib-resources==5.10.0
 git+https://github.com/Tautulli/ipwhois.git@master#egg=ipwhois

From d889e810f455fec5bd49b3881d0d1d1c0c85aabd Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 12 Nov 2022 17:11:49 -0800
Subject: [PATCH 212/743] Bump bleach from 5.0.0 to 5.0.1 (#1777)

* Bump bleach from 5.0.0 to 5.0.1

Bumps [bleach](https://github.com/mozilla/bleach) from 5.0.0 to 5.0.1.
- [Release notes](https://github.com/mozilla/bleach/releases)
- [Changelog](https://github.com/mozilla/bleach/blob/main/CHANGES)
- [Commits](https://github.com/mozilla/bleach/commits)

---
updated-dependencies:
- dependency-name: bleach
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

* Update bleach==5.0.1

Signed-off-by: dependabot[bot] <support@github.com>
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/bleach/__init__.py      |  4 ++--
 lib/bleach/html5lib_shim.py | 12 +++++++++++-
 lib/bleach/linkifier.py     | 21 ++++++++++++++-------
 lib/bleach/parse_shim.py    |  1 +
 lib/bleach/sanitizer.py     | 33 ++++++++++++++++++---------------
 requirements.txt            |  2 +-
 6 files changed, 47 insertions(+), 26 deletions(-)
 create mode 100644 lib/bleach/parse_shim.py

diff --git a/lib/bleach/__init__.py b/lib/bleach/__init__.py
index d271811d..bbcc2e03 100644
--- a/lib/bleach/__init__.py
+++ b/lib/bleach/__init__.py
@@ -11,9 +11,9 @@ from bleach.sanitizer import (
 
 
 # yyyymmdd
-__releasedate__ = "20220407"
+__releasedate__ = "20220627"
 # x.y.z or x.y.z.dev0 -- semver
-__version__ = "5.0.0"
+__version__ = "5.0.1"
 
 
 __all__ = ["clean", "linkify"]
diff --git a/lib/bleach/html5lib_shim.py b/lib/bleach/html5lib_shim.py
index 6fc90485..d121953b 100644
--- a/lib/bleach/html5lib_shim.py
+++ b/lib/bleach/html5lib_shim.py
@@ -385,7 +385,17 @@ class BleachHTMLTokenizer(HTMLTokenizer):
             yield token
 
         if last_error_token:
-            yield last_error_token
+            if last_error_token["data"] == "eof-in-tag-name":
+                # Handle the case where the text being parsed ends with <
+                # followed by a series of characters. It's treated as a tag
+                # name that abruptly ends, but we should treat that like
+                # character data
+                yield {
+                    "type": TAG_TOKEN_TYPE_CHARACTERS,
+                    "data": "<" + self.currentToken["name"],
+                }
+            else:
+                yield last_error_token
 
     def consumeEntity(self, allowedChar=None, fromAttribute=False):
         # If this tokenizer is set to consume entities, then we can let the
diff --git a/lib/bleach/linkifier.py b/lib/bleach/linkifier.py
index 68a4042e..b3b83e62 100644
--- a/lib/bleach/linkifier.py
+++ b/lib/bleach/linkifier.py
@@ -1,5 +1,7 @@
 import re
 
+from urllib.parse import quote
+
 from bleach import callbacks as linkify_callbacks
 from bleach import html5lib_shim
 
@@ -124,11 +126,11 @@ class Linker:
 
         :arg bool parse_email: whether or not to linkify email addresses
 
-        :arg re url_re: url matching regex
+        :arg url_re: url matching regex
 
-        :arg re email_re: email matching regex
+        :arg email_re: email matching regex
 
-        :arg list-of-strings recognized_tags: the list of tags that linkify knows about;
+        :arg list recognized_tags: the list of tags that linkify knows about;
             everything else gets escaped
 
         :returns: linkified text as unicode
@@ -211,7 +213,7 @@ class LinkifyFilter(html5lib_shim.Filter):
     ):
         """Creates a LinkifyFilter instance
 
-        :arg TreeWalker source: stream
+        :arg source: stream as an html5lib TreeWalker
 
         :arg list callbacks: list of callbacks to run when adjusting tag attributes;
             defaults to ``bleach.linkifier.DEFAULT_CALLBACKS``
@@ -222,9 +224,9 @@ class LinkifyFilter(html5lib_shim.Filter):
 
         :arg bool parse_email: whether or not to linkify email addresses
 
-        :arg re url_re: url matching regex
+        :arg url_re: url matching regex
 
-        :arg re email_re: email matching regex
+        :arg email_re: email matching regex
 
         """
         super().__init__(source)
@@ -298,10 +300,15 @@ class LinkifyFilter(html5lib_shim.Filter):
                             {"type": "Characters", "data": text[end : match.start()]}
                         )
 
+                    # URL-encode the "local-part" according to RFC6068
+                    parts = match.group(0).split("@")
+                    parts[0] = quote(parts[0])
+                    address = "@".join(parts)
+
                     # Run attributes through the callbacks to see what we
                     # should do with this match
                     attrs = {
-                        (None, "href"): "mailto:%s" % match.group(0),
+                        (None, "href"): "mailto:%s" % address,
                         "_text": match.group(0),
                     }
                     attrs = self.apply_callbacks(attrs, True)
diff --git a/lib/bleach/parse_shim.py b/lib/bleach/parse_shim.py
new file mode 100644
index 00000000..c7ce2d44
--- /dev/null
+++ b/lib/bleach/parse_shim.py
@@ -0,0 +1 @@
+from bleach._vendor.parse import urlparse  # noqa
diff --git a/lib/bleach/sanitizer.py b/lib/bleach/sanitizer.py
index 0816cfd0..6527ac03 100644
--- a/lib/bleach/sanitizer.py
+++ b/lib/bleach/sanitizer.py
@@ -2,10 +2,10 @@ from itertools import chain
 import re
 import warnings
 
-from bleach._vendor.parse import urlparse
 from xml.sax.saxutils import unescape
 
 from bleach import html5lib_shim
+from bleach import parse_shim
 
 
 #: List of allowed tags
@@ -247,7 +247,7 @@ class BleachSanitizerFilter(html5lib_shim.SanitizerFilter):
     ):
         """Creates a BleachSanitizerFilter instance
 
-        :arg Treewalker source: stream
+        :arg source: html5lib TreeWalker stream as an html5lib TreeWalker
 
         :arg list allowed_elements: allowed list of tags; defaults to
             ``bleach.sanitizer.ALLOWED_TAGS``
@@ -449,27 +449,27 @@ class BleachSanitizerFilter(html5lib_shim.SanitizerFilter):
         :returns: allowed value or None
 
         """
-        # NOTE(willkg): This transforms the value into one that's easier to
-        # match and verify, but shouldn't get returned since it's vastly
-        # different than the original value.
+        # NOTE(willkg): This transforms the value into a normalized one that's
+        # easier to match and verify, but shouldn't get returned since it's
+        # vastly different than the original value.
 
         # Convert all character entities in the value
-        new_value = html5lib_shim.convert_entities(value)
+        normalized_uri = html5lib_shim.convert_entities(value)
 
         # Nix backtick, space characters, and control characters
-        new_value = re.sub(r"[`\000-\040\177-\240\s]+", "", new_value)
+        normalized_uri = re.sub(r"[`\000-\040\177-\240\s]+", "", normalized_uri)
 
         # Remove REPLACEMENT characters
-        new_value = new_value.replace("\ufffd", "")
+        normalized_uri = normalized_uri.replace("\ufffd", "")
 
         # Lowercase it--this breaks the value, but makes it easier to match
         # against
-        new_value = new_value.lower()
+        normalized_uri = normalized_uri.lower()
 
         try:
             # Drop attributes with uri values that have protocols that aren't
             # allowed
-            parsed = urlparse(new_value)
+            parsed = parse_shim.urlparse(normalized_uri)
         except ValueError:
             # URI is impossible to parse, therefore it's not allowed
             return None
@@ -481,16 +481,19 @@ class BleachSanitizerFilter(html5lib_shim.SanitizerFilter):
 
         else:
             # Allow uris that are just an anchor
-            if new_value.startswith("#"):
+            if normalized_uri.startswith("#"):
                 return value
 
             # Handle protocols that urlparse doesn't recognize like "myprotocol"
-            if ":" in new_value and new_value.split(":")[0] in allowed_protocols:
+            if (
+                ":" in normalized_uri
+                and normalized_uri.split(":")[0] in allowed_protocols
+            ):
                 return value
 
-            # If there's no protocol/scheme specified, then assume it's "http"
-            # and see if that's allowed
-            if "http" in allowed_protocols:
+            # If there's no protocol/scheme specified, then assume it's "http" or
+            # "https" and see if that's allowed
+            if "http" in allowed_protocols or "https" in allowed_protocols:
                 return value
 
         return None
diff --git a/requirements.txt b/requirements.txt
index 2e5930f3..a949d18b 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -5,7 +5,7 @@ backports.csv==1.0.7
 backports.functools-lru-cache==1.6.4
 backports.zoneinfo==0.2.1
 beautifulsoup4==4.11.1
-bleach==5.0.0
+bleach==5.0.1
 certifi==2022.9.24
 cheroot==8.6.0
 cherrypy==18.6.1

From baa0e08c2a770eece0a811b2194b1b1a1b2e0c29 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 12 Nov 2022 17:12:06 -0800
Subject: [PATCH 213/743] Bump zipp from 3.8.0 to 3.10.0 (#1872)

* Bump zipp from 3.8.0 to 3.10.0

Bumps [zipp](https://github.com/jaraco/zipp) from 3.8.0 to 3.10.0.
- [Release notes](https://github.com/jaraco/zipp/releases)
- [Changelog](https://github.com/jaraco/zipp/blob/main/CHANGES.rst)
- [Commits](https://github.com/jaraco/zipp/compare/v3.8.0...v3.10.0)

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

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

* Update zipp==3.10.0

Signed-off-by: dependabot[bot] <support@github.com>
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/zipp/__init__.py    | 335 ++++++++++++++++++++++++++++++++++++++++
 lib/zipp/py310compat.py |  12 ++
 requirements.txt        |   2 +-
 3 files changed, 348 insertions(+), 1 deletion(-)
 create mode 100644 lib/zipp/__init__.py
 create mode 100644 lib/zipp/py310compat.py

diff --git a/lib/zipp/__init__.py b/lib/zipp/__init__.py
new file mode 100644
index 00000000..c1f3632e
--- /dev/null
+++ b/lib/zipp/__init__.py
@@ -0,0 +1,335 @@
+import io
+import posixpath
+import zipfile
+import itertools
+import contextlib
+import pathlib
+
+from .py310compat import text_encoding
+
+
+__all__ = ['Path']
+
+
+def _parents(path):
+    """
+    Given a path with elements separated by
+    posixpath.sep, generate all parents of that path.
+
+    >>> list(_parents('b/d'))
+    ['b']
+    >>> list(_parents('/b/d/'))
+    ['/b']
+    >>> list(_parents('b/d/f/'))
+    ['b/d', 'b']
+    >>> list(_parents('b'))
+    []
+    >>> list(_parents(''))
+    []
+    """
+    return itertools.islice(_ancestry(path), 1, None)
+
+
+def _ancestry(path):
+    """
+    Given a path with elements separated by
+    posixpath.sep, generate all elements of that path
+
+    >>> list(_ancestry('b/d'))
+    ['b/d', 'b']
+    >>> list(_ancestry('/b/d/'))
+    ['/b/d', '/b']
+    >>> list(_ancestry('b/d/f/'))
+    ['b/d/f', 'b/d', 'b']
+    >>> list(_ancestry('b'))
+    ['b']
+    >>> list(_ancestry(''))
+    []
+    """
+    path = path.rstrip(posixpath.sep)
+    while path and path != posixpath.sep:
+        yield path
+        path, tail = posixpath.split(path)
+
+
+_dedupe = dict.fromkeys
+"""Deduplicate an iterable in original order"""
+
+
+def _difference(minuend, subtrahend):
+    """
+    Return items in minuend not in subtrahend, retaining order
+    with O(1) lookup.
+    """
+    return itertools.filterfalse(set(subtrahend).__contains__, minuend)
+
+
+class InitializedState:
+    """
+    Mix-in to save the initialization state for pickling.
+    """
+
+    def __init__(self, *args, **kwargs):
+        self.__args = args
+        self.__kwargs = kwargs
+        super().__init__(*args, **kwargs)
+
+    def __getstate__(self):
+        return self.__args, self.__kwargs
+
+    def __setstate__(self, state):
+        args, kwargs = state
+        super().__init__(*args, **kwargs)
+
+
+class CompleteDirs(InitializedState, zipfile.ZipFile):
+    """
+    A ZipFile subclass that ensures that implied directories
+    are always included in the namelist.
+    """
+
+    @staticmethod
+    def _implied_dirs(names):
+        parents = itertools.chain.from_iterable(map(_parents, names))
+        as_dirs = (p + posixpath.sep for p in parents)
+        return _dedupe(_difference(as_dirs, names))
+
+    def namelist(self):
+        names = super(CompleteDirs, self).namelist()
+        return names + list(self._implied_dirs(names))
+
+    def _name_set(self):
+        return set(self.namelist())
+
+    def resolve_dir(self, name):
+        """
+        If the name represents a directory, return that name
+        as a directory (with the trailing slash).
+        """
+        names = self._name_set()
+        dirname = name + '/'
+        dir_match = name not in names and dirname in names
+        return dirname if dir_match else name
+
+    @classmethod
+    def make(cls, source):
+        """
+        Given a source (filename or zipfile), return an
+        appropriate CompleteDirs subclass.
+        """
+        if isinstance(source, CompleteDirs):
+            return source
+
+        if not isinstance(source, zipfile.ZipFile):
+            return cls(source)
+
+        # Only allow for FastLookup when supplied zipfile is read-only
+        if 'r' not in source.mode:
+            cls = CompleteDirs
+
+        source.__class__ = cls
+        return source
+
+
+class FastLookup(CompleteDirs):
+    """
+    ZipFile subclass to ensure implicit
+    dirs exist and are resolved rapidly.
+    """
+
+    def namelist(self):
+        with contextlib.suppress(AttributeError):
+            return self.__names
+        self.__names = super(FastLookup, self).namelist()
+        return self.__names
+
+    def _name_set(self):
+        with contextlib.suppress(AttributeError):
+            return self.__lookup
+        self.__lookup = super(FastLookup, self)._name_set()
+        return self.__lookup
+
+
+class Path:
+    """
+    A pathlib-compatible interface for zip files.
+
+    Consider a zip file with this structure::
+
+        .
+        ├── a.txt
+        └── b
+            ├── c.txt
+            └── d
+                └── e.txt
+
+    >>> data = io.BytesIO()
+    >>> zf = zipfile.ZipFile(data, 'w')
+    >>> zf.writestr('a.txt', 'content of a')
+    >>> zf.writestr('b/c.txt', 'content of c')
+    >>> zf.writestr('b/d/e.txt', 'content of e')
+    >>> zf.filename = 'mem/abcde.zip'
+
+    Path accepts the zipfile object itself or a filename
+
+    >>> root = Path(zf)
+
+    From there, several path operations are available.
+
+    Directory iteration (including the zip file itself):
+
+    >>> a, b = root.iterdir()
+    >>> a
+    Path('mem/abcde.zip', 'a.txt')
+    >>> b
+    Path('mem/abcde.zip', 'b/')
+
+    name property:
+
+    >>> b.name
+    'b'
+
+    join with divide operator:
+
+    >>> c = b / 'c.txt'
+    >>> c
+    Path('mem/abcde.zip', 'b/c.txt')
+    >>> c.name
+    'c.txt'
+
+    Read text:
+
+    >>> c.read_text()
+    'content of c'
+
+    existence:
+
+    >>> c.exists()
+    True
+    >>> (b / 'missing.txt').exists()
+    False
+
+    Coercion to string:
+
+    >>> import os
+    >>> str(c).replace(os.sep, posixpath.sep)
+    'mem/abcde.zip/b/c.txt'
+
+    At the root, ``name``, ``filename``, and ``parent``
+    resolve to the zipfile. Note these attributes are not
+    valid and will raise a ``ValueError`` if the zipfile
+    has no filename.
+
+    >>> root.name
+    'abcde.zip'
+    >>> str(root.filename).replace(os.sep, posixpath.sep)
+    'mem/abcde.zip'
+    >>> str(root.parent)
+    'mem'
+    """
+
+    __repr = "{self.__class__.__name__}({self.root.filename!r}, {self.at!r})"
+
+    def __init__(self, root, at=""):
+        """
+        Construct a Path from a ZipFile or filename.
+
+        Note: When the source is an existing ZipFile object,
+        its type (__class__) will be mutated to a
+        specialized type. If the caller wishes to retain the
+        original type, the caller should either create a
+        separate ZipFile object or pass a filename.
+        """
+        self.root = FastLookup.make(root)
+        self.at = at
+
+    def open(self, mode='r', *args, pwd=None, **kwargs):
+        """
+        Open this entry as text or binary following the semantics
+        of ``pathlib.Path.open()`` by passing arguments through
+        to io.TextIOWrapper().
+        """
+        if self.is_dir():
+            raise IsADirectoryError(self)
+        zip_mode = mode[0]
+        if not self.exists() and zip_mode == 'r':
+            raise FileNotFoundError(self)
+        stream = self.root.open(self.at, zip_mode, pwd=pwd)
+        if 'b' in mode:
+            if args or kwargs:
+                raise ValueError("encoding args invalid for binary operation")
+            return stream
+        else:
+            kwargs["encoding"] = text_encoding(kwargs.get("encoding"))
+        return io.TextIOWrapper(stream, *args, **kwargs)
+
+    @property
+    def name(self):
+        return pathlib.Path(self.at).name or self.filename.name
+
+    @property
+    def suffix(self):
+        return pathlib.Path(self.at).suffix or self.filename.suffix
+
+    @property
+    def suffixes(self):
+        return pathlib.Path(self.at).suffixes or self.filename.suffixes
+
+    @property
+    def stem(self):
+        return pathlib.Path(self.at).stem or self.filename.stem
+
+    @property
+    def filename(self):
+        return pathlib.Path(self.root.filename).joinpath(self.at)
+
+    def read_text(self, *args, **kwargs):
+        kwargs["encoding"] = text_encoding(kwargs.get("encoding"))
+        with self.open('r', *args, **kwargs) as strm:
+            return strm.read()
+
+    def read_bytes(self):
+        with self.open('rb') as strm:
+            return strm.read()
+
+    def _is_child(self, path):
+        return posixpath.dirname(path.at.rstrip("/")) == self.at.rstrip("/")
+
+    def _next(self, at):
+        return self.__class__(self.root, at)
+
+    def is_dir(self):
+        return not self.at or self.at.endswith("/")
+
+    def is_file(self):
+        return self.exists() and not self.is_dir()
+
+    def exists(self):
+        return self.at in self.root._name_set()
+
+    def iterdir(self):
+        if not self.is_dir():
+            raise ValueError("Can't listdir a file")
+        subs = map(self._next, self.root.namelist())
+        return filter(self._is_child, subs)
+
+    def __str__(self):
+        return posixpath.join(self.root.filename, self.at)
+
+    def __repr__(self):
+        return self.__repr.format(self=self)
+
+    def joinpath(self, *other):
+        next = posixpath.join(self.at, *other)
+        return self._next(self.root.resolve_dir(next))
+
+    __truediv__ = joinpath
+
+    @property
+    def parent(self):
+        if not self.at:
+            return self.filename.parent
+        parent_at = posixpath.dirname(self.at.rstrip('/'))
+        if parent_at:
+            parent_at += '/'
+        return self._next(parent_at)
diff --git a/lib/zipp/py310compat.py b/lib/zipp/py310compat.py
new file mode 100644
index 00000000..8244124c
--- /dev/null
+++ b/lib/zipp/py310compat.py
@@ -0,0 +1,12 @@
+import sys
+import io
+
+
+te_impl = 'lambda encoding, stacklevel=2, /: encoding'
+te_impl_37 = te_impl.replace(', /', '')
+_text_encoding = eval(te_impl) if sys.version_info > (3, 8) else eval(te_impl_37)
+
+
+text_encoding = (
+    io.text_encoding if sys.version_info > (3, 10) else _text_encoding  # type: ignore
+)
diff --git a/requirements.txt b/requirements.txt
index a949d18b..10edc91e 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -49,7 +49,7 @@ urllib3==1.26.12
 webencodings==0.5.1
 websocket-client==1.3.2
 xmltodict==0.13.0
-zipp==3.8.0
+zipp==3.10.0
 
 # configobj==5.1.0
 # sgmllib3k==1.0.0

From af1aed0b6bc4d2f9742f238260aad9c726264d52 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 12 Nov 2022 17:12:19 -0800
Subject: [PATCH 214/743] Bump requests from 2.27.1 to 2.28.1 (#1781)

* Bump requests from 2.27.1 to 2.28.1

Bumps [requests](https://github.com/psf/requests) from 2.27.1 to 2.28.1.
- [Release notes](https://github.com/psf/requests/releases)
- [Changelog](https://github.com/psf/requests/blob/main/HISTORY.md)
- [Commits](https://github.com/psf/requests/compare/v2.27.1...v2.28.1)

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

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

* Update requests==2.28.1

* Update urllib3==1.26.12

* Update certifi==2022.9.24

* Update idna==3.4

* Update charset-normalizer==2.1.1

Signed-off-by: dependabot[bot] <support@github.com>
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/certifi/__init__.py                   |    2 +-
 lib/certifi/cacert.pem                    |  322 ++-
 lib/certifi/core.py                       |   58 +-
 lib/charset_normalizer/__init__.py        |    2 +-
 lib/charset_normalizer/api.py             |  178 +-
 lib/charset_normalizer/assets/__init__.py | 2364 ++++++++++-----------
 lib/charset_normalizer/cd.py              |  101 +-
 lib/charset_normalizer/cli/normalizer.py  |   17 +-
 lib/charset_normalizer/constant.py        |   72 +-
 lib/charset_normalizer/md.py              |  106 +-
 lib/charset_normalizer/models.py          |   71 +-
 lib/charset_normalizer/utils.py           |  136 +-
 lib/charset_normalizer/version.py         |    2 +-
 lib/idna/core.py                          |    5 +-
 lib/idna/idnadata.py                      |   34 +-
 lib/idna/package_data.py                  |    2 +-
 lib/idna/uts46data.py                     |  306 ++-
 lib/requests/__init__.py                  |   94 +-
 lib/requests/__version__.py               |   20 +-
 lib/requests/_internal_utils.py           |   24 +-
 lib/requests/adapters.py                  |  232 +-
 lib/requests/api.py                       |   18 +-
 lib/requests/auth.py                      |  156 +-
 lib/requests/certs.py                     |    3 +-
 lib/requests/compat.py                    |   92 +-
 lib/requests/cookies.py                   |  152 +-
 lib/requests/exceptions.py                |   22 +-
 lib/requests/help.py                      |  101 +-
 lib/requests/hooks.py                     |    7 +-
 lib/requests/models.py                    |  347 +--
 lib/requests/packages.py                  |   16 +-
 lib/requests/sessions.py                  |  276 ++-
 lib/requests/status_codes.py              |  169 +-
 lib/requests/structures.py                |   12 +-
 lib/requests/utils.py                     |  388 ++--
 lib/urllib3/__init__.py                   |   17 +
 lib/urllib3/_version.py                   |    2 +-
 lib/urllib3/connection.py                 |    2 +-
 lib/urllib3/connectionpool.py             |    2 +
 lib/urllib3/contrib/pyopenssl.py          |   10 +-
 lib/urllib3/contrib/securetransport.py    |    1 -
 lib/urllib3/packages/six.py               |    1 -
 lib/urllib3/response.py                   |   54 +-
 lib/urllib3/util/url.py                   |    5 +-
 lib/urllib3/util/wait.py                  |    1 -
 requirements.txt                          |    2 +-
 46 files changed, 3295 insertions(+), 2709 deletions(-)

diff --git a/lib/certifi/__init__.py b/lib/certifi/__init__.py
index b700d3a6..af4bcc15 100644
--- a/lib/certifi/__init__.py
+++ b/lib/certifi/__init__.py
@@ -1,4 +1,4 @@
 from .core import contents, where
 
 __all__ = ["contents", "where"]
-__version__ = "2022.05.18.1"
+__version__ = "2022.09.24"
diff --git a/lib/certifi/cacert.pem b/lib/certifi/cacert.pem
index f597fb3a..40051551 100644
--- a/lib/certifi/cacert.pem
+++ b/lib/certifi/cacert.pem
@@ -1323,78 +1323,6 @@ t/2jioSgrGK+KwmHNPBqAbubKVY8/gA3zyNs8U6qtnRGEmyR7jTV7JqR50S+kDFy
 SjnRBUkLp7Y3gaVdjKozXoEofKd9J+sAro03
 -----END CERTIFICATE-----
 
-# Issuer: CN=EC-ACC O=Agencia Catalana de Certificacio (NIF Q-0801176-I) OU=Serveis Publics de Certificacio/Vegeu https://www.catcert.net/verarrel (c)03/Jerarquia Entitats de Certificacio Catalanes
-# Subject: CN=EC-ACC O=Agencia Catalana de Certificacio (NIF Q-0801176-I) OU=Serveis Publics de Certificacio/Vegeu https://www.catcert.net/verarrel (c)03/Jerarquia Entitats de Certificacio Catalanes
-# Label: "EC-ACC"
-# Serial: -23701579247955709139626555126524820479
-# MD5 Fingerprint: eb:f5:9d:29:0d:61:f9:42:1f:7c:c2:ba:6d:e3:15:09
-# SHA1 Fingerprint: 28:90:3a:63:5b:52:80:fa:e6:77:4c:0b:6d:a7:d6:ba:a6:4a:f2:e8
-# SHA256 Fingerprint: 88:49:7f:01:60:2f:31:54:24:6a:e2:8c:4d:5a:ef:10:f1:d8:7e:bb:76:62:6f:4a:e0:b7:f9:5b:a7:96:87:99
------BEGIN CERTIFICATE-----
-MIIFVjCCBD6gAwIBAgIQ7is969Qh3hSoYqwE893EATANBgkqhkiG9w0BAQUFADCB
-8zELMAkGA1UEBhMCRVMxOzA5BgNVBAoTMkFnZW5jaWEgQ2F0YWxhbmEgZGUgQ2Vy
-dGlmaWNhY2lvIChOSUYgUS0wODAxMTc2LUkpMSgwJgYDVQQLEx9TZXJ2ZWlzIFB1
-YmxpY3MgZGUgQ2VydGlmaWNhY2lvMTUwMwYDVQQLEyxWZWdldSBodHRwczovL3d3
-dy5jYXRjZXJ0Lm5ldC92ZXJhcnJlbCAoYykwMzE1MDMGA1UECxMsSmVyYXJxdWlh
-IEVudGl0YXRzIGRlIENlcnRpZmljYWNpbyBDYXRhbGFuZXMxDzANBgNVBAMTBkVD
-LUFDQzAeFw0wMzAxMDcyMzAwMDBaFw0zMTAxMDcyMjU5NTlaMIHzMQswCQYDVQQG
-EwJFUzE7MDkGA1UEChMyQWdlbmNpYSBDYXRhbGFuYSBkZSBDZXJ0aWZpY2FjaW8g
-KE5JRiBRLTA4MDExNzYtSSkxKDAmBgNVBAsTH1NlcnZlaXMgUHVibGljcyBkZSBD
-ZXJ0aWZpY2FjaW8xNTAzBgNVBAsTLFZlZ2V1IGh0dHBzOi8vd3d3LmNhdGNlcnQu
-bmV0L3ZlcmFycmVsIChjKTAzMTUwMwYDVQQLEyxKZXJhcnF1aWEgRW50aXRhdHMg
-ZGUgQ2VydGlmaWNhY2lvIENhdGFsYW5lczEPMA0GA1UEAxMGRUMtQUNDMIIBIjAN
-BgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAsyLHT+KXQpWIR4NA9h0X84NzJB5R
-85iKw5K4/0CQBXCHYMkAqbWUZRkiFRfCQ2xmRJoNBD45b6VLeqpjt4pEndljkYRm
-4CgPukLjbo73FCeTae6RDqNfDrHrZqJyTxIThmV6PttPB/SnCWDaOkKZx7J/sxaV
-HMf5NLWUhdWZXqBIoH7nF2W4onW4HvPlQn2v7fOKSGRdghST2MDk/7NQcvJ29rNd
-QlB50JQ+awwAvthrDk4q7D7SzIKiGGUzE3eeml0aE9jD2z3Il3rucO2n5nzbcc8t
-lGLfbdb1OL4/pYUKGbio2Al1QnDE6u/LDsg0qBIimAy4E5S2S+zw0JDnJwIDAQAB
-o4HjMIHgMB0GA1UdEQQWMBSBEmVjX2FjY0BjYXRjZXJ0Lm5ldDAPBgNVHRMBAf8E
-BTADAQH/MA4GA1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQUoMOLRKo3pUW/l4Ba0fF4
-opvpXY0wfwYDVR0gBHgwdjB0BgsrBgEEAfV4AQMBCjBlMCwGCCsGAQUFBwIBFiBo
-dHRwczovL3d3dy5jYXRjZXJ0Lm5ldC92ZXJhcnJlbDA1BggrBgEFBQcCAjApGidW
-ZWdldSBodHRwczovL3d3dy5jYXRjZXJ0Lm5ldC92ZXJhcnJlbCAwDQYJKoZIhvcN
-AQEFBQADggEBAKBIW4IB9k1IuDlVNZyAelOZ1Vr/sXE7zDkJlF7W2u++AVtd0x7Y
-/X1PzaBB4DSTv8vihpw3kpBWHNzrKQXlxJ7HNd+KDM3FIUPpqojlNcAZQmNaAl6k
-SBg6hW/cnbw/nZzBh7h6YQjpdwt/cKt63dmXLGQehb+8dJahw3oS7AwaboMMPOhy
-Rp/7SNVel+axofjk70YllJyJ22k4vuxcDlbHZVHlUIiIv0LVKz3l+bqeLrPK9HOS
-Agu+TGbrIP65y7WZf+a2E/rKS03Z7lNGBjvGTq2TWoF+bCpLagVFjPIhpDGQh2xl
-nJ2lYJU6Un/10asIbvPuW/mIPX64b24D5EI=
------END CERTIFICATE-----
-
-# Issuer: CN=Hellenic Academic and Research Institutions RootCA 2011 O=Hellenic Academic and Research Institutions Cert. Authority
-# Subject: CN=Hellenic Academic and Research Institutions RootCA 2011 O=Hellenic Academic and Research Institutions Cert. Authority
-# Label: "Hellenic Academic and Research Institutions RootCA 2011"
-# Serial: 0
-# MD5 Fingerprint: 73:9f:4c:4b:73:5b:79:e9:fa:ba:1c:ef:6e:cb:d5:c9
-# SHA1 Fingerprint: fe:45:65:9b:79:03:5b:98:a1:61:b5:51:2e:ac:da:58:09:48:22:4d
-# SHA256 Fingerprint: bc:10:4f:15:a4:8b:e7:09:dc:a5:42:a7:e1:d4:b9:df:6f:05:45:27:e8:02:ea:a9:2d:59:54:44:25:8a:fe:71
------BEGIN CERTIFICATE-----
-MIIEMTCCAxmgAwIBAgIBADANBgkqhkiG9w0BAQUFADCBlTELMAkGA1UEBhMCR1Ix
-RDBCBgNVBAoTO0hlbGxlbmljIEFjYWRlbWljIGFuZCBSZXNlYXJjaCBJbnN0aXR1
-dGlvbnMgQ2VydC4gQXV0aG9yaXR5MUAwPgYDVQQDEzdIZWxsZW5pYyBBY2FkZW1p
-YyBhbmQgUmVzZWFyY2ggSW5zdGl0dXRpb25zIFJvb3RDQSAyMDExMB4XDTExMTIw
-NjEzNDk1MloXDTMxMTIwMTEzNDk1MlowgZUxCzAJBgNVBAYTAkdSMUQwQgYDVQQK
-EztIZWxsZW5pYyBBY2FkZW1pYyBhbmQgUmVzZWFyY2ggSW5zdGl0dXRpb25zIENl
-cnQuIEF1dGhvcml0eTFAMD4GA1UEAxM3SGVsbGVuaWMgQWNhZGVtaWMgYW5kIFJl
-c2VhcmNoIEluc3RpdHV0aW9ucyBSb290Q0EgMjAxMTCCASIwDQYJKoZIhvcNAQEB
-BQADggEPADCCAQoCggEBAKlTAOMupvaO+mDYLZU++CwqVE7NuYRhlFhPjz2L5EPz
-dYmNUeTDN9KKiE15HrcS3UN4SoqS5tdI1Q+kOilENbgH9mgdVc04UfCMJDGFr4PJ
-fel3r+0ae50X+bOdOFAPplp5kYCvN66m0zH7tSYJnTxa71HFK9+WXesyHgLacEns
-bgzImjeN9/E2YEsmLIKe0HjzDQ9jpFEw4fkrJxIH2Oq9GGKYsFk3fb7u8yBRQlqD
-75O6aRXxYp2fmTmCobd0LovUxQt7L/DICto9eQqakxylKHJzkUOap9FNhYS5qXSP
-FEDH3N6sQWRstBmbAmNtJGSPRLIl6s5ddAxjMlyNh+UCAwEAAaOBiTCBhjAPBgNV
-HRMBAf8EBTADAQH/MAsGA1UdDwQEAwIBBjAdBgNVHQ4EFgQUppFC/RNhSiOeCKQp
-5dgTBCPuQSUwRwYDVR0eBEAwPqA8MAWCAy5ncjAFggMuZXUwBoIELmVkdTAGggQu
-b3JnMAWBAy5ncjAFgQMuZXUwBoEELmVkdTAGgQQub3JnMA0GCSqGSIb3DQEBBQUA
-A4IBAQAf73lB4XtuP7KMhjdCSk4cNx6NZrokgclPEg8hwAOXhiVtXdMiKahsog2p
-6z0GW5k6x8zDmjR/qw7IThzh+uTczQ2+vyT+bOdrwg3IBp5OjWEopmr95fZi6hg8
-TqBTnbI6nOulnJEWtk2C4AwFSKls9cz4y51JtPACpf1wA+2KIaWuE4ZJwzNzvoc7
-dIsXRSZMFpGD/md9zU1jZ/rzAxKWeAaNsWftjj++n08C9bMJL/NMh98qy5V8Acys
-Nnq/onN694/BtZqhFLKPM58N7yLcZnuEvUUXBj08yrl3NI/K6s8/MT7jiOOASSXI
-l7WdmplNsDz4SgCbZN2fOUvRJ9e4
------END CERTIFICATE-----
-
 # Issuer: CN=Actalis Authentication Root CA O=Actalis S.p.A./03358520967
 # Subject: CN=Actalis Authentication Root CA O=Actalis S.p.A./03358520967
 # Label: "Actalis Authentication Root CA"
@@ -4528,3 +4456,253 @@ PQQDAwNpADBmAjEAyjzGKnXCXnViOTYAYFqLwZOZzNnbQTs7h5kXO9XMT8oi96CA
 y/m0sRtW9XLS/BnRAjEAkfcwkz8QRitxpNA7RJvAKQIFskF3UfN5Wp6OFKBOQtJb
 gfM0agPnIjhQW+0ZT0MW
 -----END CERTIFICATE-----
+
+# Issuer: CN=DigiCert TLS ECC P384 Root G5 O=DigiCert, Inc.
+# Subject: CN=DigiCert TLS ECC P384 Root G5 O=DigiCert, Inc.
+# Label: "DigiCert TLS ECC P384 Root G5"
+# Serial: 13129116028163249804115411775095713523
+# MD5 Fingerprint: d3:71:04:6a:43:1c:db:a6:59:e1:a8:a3:aa:c5:71:ed
+# SHA1 Fingerprint: 17:f3:de:5e:9f:0f:19:e9:8e:f6:1f:32:26:6e:20:c4:07:ae:30:ee
+# SHA256 Fingerprint: 01:8e:13:f0:77:25:32:cf:80:9b:d1:b1:72:81:86:72:83:fc:48:c6:e1:3b:e9:c6:98:12:85:4a:49:0c:1b:05
+-----BEGIN CERTIFICATE-----
+MIICGTCCAZ+gAwIBAgIQCeCTZaz32ci5PhwLBCou8zAKBggqhkjOPQQDAzBOMQsw
+CQYDVQQGEwJVUzEXMBUGA1UEChMORGlnaUNlcnQsIEluYy4xJjAkBgNVBAMTHURp
+Z2lDZXJ0IFRMUyBFQ0MgUDM4NCBSb290IEc1MB4XDTIxMDExNTAwMDAwMFoXDTQ2
+MDExNDIzNTk1OVowTjELMAkGA1UEBhMCVVMxFzAVBgNVBAoTDkRpZ2lDZXJ0LCBJ
+bmMuMSYwJAYDVQQDEx1EaWdpQ2VydCBUTFMgRUNDIFAzODQgUm9vdCBHNTB2MBAG
+ByqGSM49AgEGBSuBBAAiA2IABMFEoc8Rl1Ca3iOCNQfN0MsYndLxf3c1TzvdlHJS
+7cI7+Oz6e2tYIOyZrsn8aLN1udsJ7MgT9U7GCh1mMEy7H0cKPGEQQil8pQgO4CLp
+0zVozptjn4S1mU1YoI71VOeVyaNCMEAwHQYDVR0OBBYEFMFRRVBZqz7nLFr6ICIS
+B4CIfBFqMA4GA1UdDwEB/wQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MAoGCCqGSM49
+BAMDA2gAMGUCMQCJao1H5+z8blUD2WdsJk6Dxv3J+ysTvLd6jLRl0mlpYxNjOyZQ
+LgGheQaRnUi/wr4CMEfDFXuxoJGZSZOoPHzoRgaLLPIxAJSdYsiJvRmEFOml+wG4
+DXZDjC5Ty3zfDBeWUA==
+-----END CERTIFICATE-----
+
+# Issuer: CN=DigiCert TLS RSA4096 Root G5 O=DigiCert, Inc.
+# Subject: CN=DigiCert TLS RSA4096 Root G5 O=DigiCert, Inc.
+# Label: "DigiCert TLS RSA4096 Root G5"
+# Serial: 11930366277458970227240571539258396554
+# MD5 Fingerprint: ac:fe:f7:34:96:a9:f2:b3:b4:12:4b:e4:27:41:6f:e1
+# SHA1 Fingerprint: a7:88:49:dc:5d:7c:75:8c:8c:de:39:98:56:b3:aa:d0:b2:a5:71:35
+# SHA256 Fingerprint: 37:1a:00:dc:05:33:b3:72:1a:7e:eb:40:e8:41:9e:70:79:9d:2b:0a:0f:2c:1d:80:69:31:65:f7:ce:c4:ad:75
+-----BEGIN CERTIFICATE-----
+MIIFZjCCA06gAwIBAgIQCPm0eKj6ftpqMzeJ3nzPijANBgkqhkiG9w0BAQwFADBN
+MQswCQYDVQQGEwJVUzEXMBUGA1UEChMORGlnaUNlcnQsIEluYy4xJTAjBgNVBAMT
+HERpZ2lDZXJ0IFRMUyBSU0E0MDk2IFJvb3QgRzUwHhcNMjEwMTE1MDAwMDAwWhcN
+NDYwMTE0MjM1OTU5WjBNMQswCQYDVQQGEwJVUzEXMBUGA1UEChMORGlnaUNlcnQs
+IEluYy4xJTAjBgNVBAMTHERpZ2lDZXJ0IFRMUyBSU0E0MDk2IFJvb3QgRzUwggIi
+MA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCz0PTJeRGd/fxmgefM1eS87IE+
+ajWOLrfn3q/5B03PMJ3qCQuZvWxX2hhKuHisOjmopkisLnLlvevxGs3npAOpPxG0
+2C+JFvuUAT27L/gTBaF4HI4o4EXgg/RZG5Wzrn4DReW+wkL+7vI8toUTmDKdFqgp
+wgscONyfMXdcvyej/Cestyu9dJsXLfKB2l2w4SMXPohKEiPQ6s+d3gMXsUJKoBZM
+pG2T6T867jp8nVid9E6P/DsjyG244gXazOvswzH016cpVIDPRFtMbzCe88zdH5RD
+nU1/cHAN1DrRN/BsnZvAFJNY781BOHW8EwOVfH/jXOnVDdXifBBiqmvwPXbzP6Po
+sMH976pXTayGpxi0KcEsDr9kvimM2AItzVwv8n/vFfQMFawKsPHTDU9qTXeXAaDx
+Zre3zu/O7Oyldcqs4+Fj97ihBMi8ez9dLRYiVu1ISf6nL3kwJZu6ay0/nTvEF+cd
+Lvvyz6b84xQslpghjLSR6Rlgg/IwKwZzUNWYOwbpx4oMYIwo+FKbbuH2TbsGJJvX
+KyY//SovcfXWJL5/MZ4PbeiPT02jP/816t9JXkGPhvnxd3lLG7SjXi/7RgLQZhNe
+XoVPzthwiHvOAbWWl9fNff2C+MIkwcoBOU+NosEUQB+cZtUMCUbW8tDRSHZWOkPL
+tgoRObqME2wGtZ7P6wIDAQABo0IwQDAdBgNVHQ4EFgQUUTMc7TZArxfTJc1paPKv
+TiM+s0EwDgYDVR0PAQH/BAQDAgGGMA8GA1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcN
+AQEMBQADggIBAGCmr1tfV9qJ20tQqcQjNSH/0GEwhJG3PxDPJY7Jv0Y02cEhJhxw
+GXIeo8mH/qlDZJY6yFMECrZBu8RHANmfGBg7sg7zNOok992vIGCukihfNudd5N7H
+PNtQOa27PShNlnx2xlv0wdsUpasZYgcYQF+Xkdycx6u1UQ3maVNVzDl92sURVXLF
+O4uJ+DQtpBflF+aZfTCIITfNMBc9uPK8qHWgQ9w+iUuQrm0D4ByjoJYJu32jtyoQ
+REtGBzRj7TG5BO6jm5qu5jF49OokYTurWGT/u4cnYiWB39yhL/btp/96j1EuMPik
+AdKFOV8BmZZvWltwGUb+hmA+rYAQCd05JS9Yf7vSdPD3Rh9GOUrYU9DzLjtxpdRv
+/PNn5AeP3SYZ4Y1b+qOTEZvpyDrDVWiakuFSdjjo4bq9+0/V77PnSIMx8IIh47a+
+p6tv75/fTM8BuGJqIz3nCU2AG3swpMPdB380vqQmsvZB6Akd4yCYqjdP//fx4ilw
+MUc/dNAUFvohigLVigmUdy7yWSiLfFCSCmZ4OIN1xLVaqBHG5cGdZlXPU8Sv13WF
+qUITVuwhd4GTWgzqltlJyqEI8pc7bZsEGCREjnwB8twl2F6GmrE52/WRMmrRpnCK
+ovfepEWFJqgejF0pW8hL2JpqA15w8oVPbEtoL8pU9ozaMv7Da4M/OMZ+
+-----END CERTIFICATE-----
+
+# Issuer: CN=Certainly Root R1 O=Certainly
+# Subject: CN=Certainly Root R1 O=Certainly
+# Label: "Certainly Root R1"
+# Serial: 188833316161142517227353805653483829216
+# MD5 Fingerprint: 07:70:d4:3e:82:87:a0:fa:33:36:13:f4:fa:33:e7:12
+# SHA1 Fingerprint: a0:50:ee:0f:28:71:f4:27:b2:12:6d:6f:50:96:25:ba:cc:86:42:af
+# SHA256 Fingerprint: 77:b8:2c:d8:64:4c:43:05:f7:ac:c5:cb:15:6b:45:67:50:04:03:3d:51:c6:0c:62:02:a8:e0:c3:34:67:d3:a0
+-----BEGIN CERTIFICATE-----
+MIIFRzCCAy+gAwIBAgIRAI4P+UuQcWhlM1T01EQ5t+AwDQYJKoZIhvcNAQELBQAw
+PTELMAkGA1UEBhMCVVMxEjAQBgNVBAoTCUNlcnRhaW5seTEaMBgGA1UEAxMRQ2Vy
+dGFpbmx5IFJvb3QgUjEwHhcNMjEwNDAxMDAwMDAwWhcNNDYwNDAxMDAwMDAwWjA9
+MQswCQYDVQQGEwJVUzESMBAGA1UEChMJQ2VydGFpbmx5MRowGAYDVQQDExFDZXJ0
+YWlubHkgUm9vdCBSMTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBANA2
+1B/q3avk0bbm+yLA3RMNansiExyXPGhjZjKcA7WNpIGD2ngwEc/csiu+kr+O5MQT
+vqRoTNoCaBZ0vrLdBORrKt03H2As2/X3oXyVtwxwhi7xOu9S98zTm/mLvg7fMbed
+aFySpvXl8wo0tf97ouSHocavFwDvA5HtqRxOcT3Si2yJ9HiG5mpJoM610rCrm/b0
+1C7jcvk2xusVtyWMOvwlDbMicyF0yEqWYZL1LwsYpfSt4u5BvQF5+paMjRcCMLT5
+r3gajLQ2EBAHBXDQ9DGQilHFhiZ5shGIXsXwClTNSaa/ApzSRKft43jvRl5tcdF5
+cBxGX1HpyTfcX35pe0HfNEXgO4T0oYoKNp43zGJS4YkNKPl6I7ENPT2a/Z2B7yyQ
+wHtETrtJ4A5KVpK8y7XdeReJkd5hiXSSqOMyhb5OhaRLWcsrxXiOcVTQAjeZjOVJ
+6uBUcqQRBi8LjMFbvrWhsFNunLhgkR9Za/kt9JQKl7XsxXYDVBtlUrpMklZRNaBA
+2CnbrlJ2Oy0wQJuK0EJWtLeIAaSHO1OWzaMWj/Nmqhexx2DgwUMFDO6bW2BvBlyH
+Wyf5QBGenDPBt+U1VwV/J84XIIwc/PH72jEpSe31C4SnT8H2TsIonPru4K8H+zMR
+eiFPCyEQtkA6qyI6BJyLm4SGcprSp6XEtHWRqSsjAgMBAAGjQjBAMA4GA1UdDwEB
+/wQEAwIBBjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBTgqj8ljZ9EXME66C6u
+d0yEPmcM9DANBgkqhkiG9w0BAQsFAAOCAgEAuVevuBLaV4OPaAszHQNTVfSVcOQr
+PbA56/qJYv331hgELyE03fFo8NWWWt7CgKPBjcZq91l3rhVkz1t5BXdm6ozTaw3d
+8VkswTOlMIAVRQdFGjEitpIAq5lNOo93r6kiyi9jyhXWx8bwPWz8HA2YEGGeEaIi
+1wrykXprOQ4vMMM2SZ/g6Q8CRFA3lFV96p/2O7qUpUzpvD5RtOjKkjZUbVwlKNrd
+rRT90+7iIgXr0PK3aBLXWopBGsaSpVo7Y0VPv+E6dyIvXL9G+VoDhRNCX8reU9di
+taY1BMJH/5n9hN9czulegChB8n3nHpDYT3Y+gjwN/KUD+nsa2UUeYNrEjvn8K8l7
+lcUq/6qJ34IxD3L/DCfXCh5WAFAeDJDBlrXYFIW7pw0WwfgHJBu6haEaBQmAupVj
+yTrsJZ9/nbqkRxWbRHDxakvWOF5D8xh+UG7pWijmZeZ3Gzr9Hb4DJqPb1OG7fpYn
+Kx3upPvaJVQTA945xsMfTZDsjxtK0hzthZU4UHlG1sGQUDGpXJpuHfUzVounmdLy
+yCwzk5Iwx06MZTMQZBf9JBeW0Y3COmor6xOLRPIh80oat3df1+2IpHLlOR+Vnb5n
+wXARPbv0+Em34yaXOp/SX3z7wJl8OSngex2/DaeP0ik0biQVy96QXr8axGbqwua6
+OV+KmalBWQewLK8=
+-----END CERTIFICATE-----
+
+# Issuer: CN=Certainly Root E1 O=Certainly
+# Subject: CN=Certainly Root E1 O=Certainly
+# Label: "Certainly Root E1"
+# Serial: 8168531406727139161245376702891150584
+# MD5 Fingerprint: 0a:9e:ca:cd:3e:52:50:c6:36:f3:4b:a3:ed:a7:53:e9
+# SHA1 Fingerprint: f9:e1:6d:dc:01:89:cf:d5:82:45:63:3e:c5:37:7d:c2:eb:93:6f:2b
+# SHA256 Fingerprint: b4:58:5f:22:e4:ac:75:6a:4e:86:12:a1:36:1c:5d:9d:03:1a:93:fd:84:fe:bb:77:8f:a3:06:8b:0f:c4:2d:c2
+-----BEGIN CERTIFICATE-----
+MIIB9zCCAX2gAwIBAgIQBiUzsUcDMydc+Y2aub/M+DAKBggqhkjOPQQDAzA9MQsw
+CQYDVQQGEwJVUzESMBAGA1UEChMJQ2VydGFpbmx5MRowGAYDVQQDExFDZXJ0YWlu
+bHkgUm9vdCBFMTAeFw0yMTA0MDEwMDAwMDBaFw00NjA0MDEwMDAwMDBaMD0xCzAJ
+BgNVBAYTAlVTMRIwEAYDVQQKEwlDZXJ0YWlubHkxGjAYBgNVBAMTEUNlcnRhaW5s
+eSBSb290IEUxMHYwEAYHKoZIzj0CAQYFK4EEACIDYgAE3m/4fxzf7flHh4axpMCK
++IKXgOqPyEpeKn2IaKcBYhSRJHpcnqMXfYqGITQYUBsQ3tA3SybHGWCA6TS9YBk2
+QNYphwk8kXr2vBMj3VlOBF7PyAIcGFPBMdjaIOlEjeR2o0IwQDAOBgNVHQ8BAf8E
+BAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQU8ygYy2R17ikq6+2uI1g4
+hevIIgcwCgYIKoZIzj0EAwMDaAAwZQIxALGOWiDDshliTd6wT99u0nCK8Z9+aozm
+ut6Dacpps6kFtZaSF4fC0urQe87YQVt8rgIwRt7qy12a7DLCZRawTDBcMPPaTnOG
+BtjOiQRINzf43TNRnXCve1XYAS59BWQOhriR
+-----END CERTIFICATE-----
+
+# Issuer: CN=E-Tugra Global Root CA RSA v3 O=E-Tugra EBG A.S. OU=E-Tugra Trust Center
+# Subject: CN=E-Tugra Global Root CA RSA v3 O=E-Tugra EBG A.S. OU=E-Tugra Trust Center
+# Label: "E-Tugra Global Root CA RSA v3"
+# Serial: 75951268308633135324246244059508261641472512052
+# MD5 Fingerprint: 22:be:10:f6:c2:f8:03:88:73:5f:33:29:47:28:47:a4
+# SHA1 Fingerprint: e9:a8:5d:22:14:52:1c:5b:aa:0a:b4:be:24:6a:23:8a:c9:ba:e2:a9
+# SHA256 Fingerprint: ef:66:b0:b1:0a:3c:db:9f:2e:36:48:c7:6b:d2:af:18:ea:d2:bf:e6:f1:17:65:5e:28:c4:06:0d:a1:a3:f4:c2
+-----BEGIN CERTIFICATE-----
+MIIF8zCCA9ugAwIBAgIUDU3FzRYilZYIfrgLfxUGNPt5EDQwDQYJKoZIhvcNAQEL
+BQAwgYAxCzAJBgNVBAYTAlRSMQ8wDQYDVQQHEwZBbmthcmExGTAXBgNVBAoTEEUt
+VHVncmEgRUJHIEEuUy4xHTAbBgNVBAsTFEUtVHVncmEgVHJ1c3QgQ2VudGVyMSYw
+JAYDVQQDEx1FLVR1Z3JhIEdsb2JhbCBSb290IENBIFJTQSB2MzAeFw0yMDAzMTgw
+OTA3MTdaFw00NTAzMTIwOTA3MTdaMIGAMQswCQYDVQQGEwJUUjEPMA0GA1UEBxMG
+QW5rYXJhMRkwFwYDVQQKExBFLVR1Z3JhIEVCRyBBLlMuMR0wGwYDVQQLExRFLVR1
+Z3JhIFRydXN0IENlbnRlcjEmMCQGA1UEAxMdRS1UdWdyYSBHbG9iYWwgUm9vdCBD
+QSBSU0EgdjMwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCiZvCJt3J7
+7gnJY9LTQ91ew6aEOErxjYG7FL1H6EAX8z3DeEVypi6Q3po61CBxyryfHUuXCscx
+uj7X/iWpKo429NEvx7epXTPcMHD4QGxLsqYxYdE0PD0xesevxKenhOGXpOhL9hd8
+7jwH7eKKV9y2+/hDJVDqJ4GohryPUkqWOmAalrv9c/SF/YP9f4RtNGx/ardLAQO/
+rWm31zLZ9Vdq6YaCPqVmMbMWPcLzJmAy01IesGykNz709a/r4d+ABs8qQedmCeFL
+l+d3vSFtKbZnwy1+7dZ5ZdHPOrbRsV5WYVB6Ws5OUDGAA5hH5+QYfERaxqSzO8bG
+wzrwbMOLyKSRBfP12baqBqG3q+Sx6iEUXIOk/P+2UNOMEiaZdnDpwA+mdPy70Bt4
+znKS4iicvObpCdg604nmvi533wEKb5b25Y08TVJ2Glbhc34XrD2tbKNSEhhw5oBO
+M/J+JjKsBY04pOZ2PJ8QaQ5tndLBeSBrW88zjdGUdjXnXVXHt6woq0bM5zshtQoK
+5EpZ3IE1S0SVEgpnpaH/WwAH0sDM+T/8nzPyAPiMbIedBi3x7+PmBvrFZhNb/FAH
+nnGGstpvdDDPk1Po3CLW3iAfYY2jLqN4MpBs3KwytQXk9TwzDdbgh3cXTJ2w2Amo
+DVf3RIXwyAS+XF1a4xeOVGNpf0l0ZAWMowIDAQABo2MwYTAPBgNVHRMBAf8EBTAD
+AQH/MB8GA1UdIwQYMBaAFLK0ruYt9ybVqnUtdkvAG1Mh0EjvMB0GA1UdDgQWBBSy
+tK7mLfcm1ap1LXZLwBtTIdBI7zAOBgNVHQ8BAf8EBAMCAQYwDQYJKoZIhvcNAQEL
+BQADggIBAImocn+M684uGMQQgC0QDP/7FM0E4BQ8Tpr7nym/Ip5XuYJzEmMmtcyQ
+6dIqKe6cLcwsmb5FJ+Sxce3kOJUxQfJ9emN438o2Fi+CiJ+8EUdPdk3ILY7r3y18
+Tjvarvbj2l0Upq7ohUSdBm6O++96SmotKygY/r+QLHUWnw/qln0F7psTpURs+APQ
+3SPh/QMSEgj0GDSz4DcLdxEBSL9htLX4GdnLTeqjjO/98Aa1bZL0SmFQhO3sSdPk
+vmjmLuMxC1QLGpLWgti2omU8ZgT5Vdps+9u1FGZNlIM7zR6mK7L+d0CGq+ffCsn9
+9t2HVhjYsCxVYJb6CH5SkPVLpi6HfMsg2wY+oF0Dd32iPBMbKaITVaA9FCKvb7jQ
+mhty3QUBjYZgv6Rn7rWlDdF/5horYmbDB7rnoEgcOMPpRfunf/ztAmgayncSd6YA
+VSgU7NbHEqIbZULpkejLPoeJVF3Zr52XnGnnCv8PWniLYypMfUeUP95L6VPQMPHF
+9p5J3zugkaOj/s1YzOrfr28oO6Bpm4/srK4rVJ2bBLFHIK+WEj5jlB0E5y67hscM
+moi/dkfv97ALl2bSRM9gUgfh1SxKOidhd8rXj+eHDjD/DLsE4mHDosiXYY60MGo8
+bcIHX0pzLz/5FooBZu+6kcpSV3uu1OYP3Qt6f4ueJiDPO++BcYNZ
+-----END CERTIFICATE-----
+
+# Issuer: CN=E-Tugra Global Root CA ECC v3 O=E-Tugra EBG A.S. OU=E-Tugra Trust Center
+# Subject: CN=E-Tugra Global Root CA ECC v3 O=E-Tugra EBG A.S. OU=E-Tugra Trust Center
+# Label: "E-Tugra Global Root CA ECC v3"
+# Serial: 218504919822255052842371958738296604628416471745
+# MD5 Fingerprint: 46:bc:81:bb:f1:b5:1e:f7:4b:96:bc:14:e2:e7:27:64
+# SHA1 Fingerprint: 8a:2f:af:57:53:b1:b0:e6:a1:04:ec:5b:6a:69:71:6d:f6:1c:e2:84
+# SHA256 Fingerprint: 87:3f:46:85:fa:7f:56:36:25:25:2e:6d:36:bc:d7:f1:6f:c2:49:51:f2:64:e4:7e:1b:95:4f:49:08:cd:ca:13
+-----BEGIN CERTIFICATE-----
+MIICpTCCAiqgAwIBAgIUJkYZdzHhT28oNt45UYbm1JeIIsEwCgYIKoZIzj0EAwMw
+gYAxCzAJBgNVBAYTAlRSMQ8wDQYDVQQHEwZBbmthcmExGTAXBgNVBAoTEEUtVHVn
+cmEgRUJHIEEuUy4xHTAbBgNVBAsTFEUtVHVncmEgVHJ1c3QgQ2VudGVyMSYwJAYD
+VQQDEx1FLVR1Z3JhIEdsb2JhbCBSb290IENBIEVDQyB2MzAeFw0yMDAzMTgwOTQ2
+NThaFw00NTAzMTIwOTQ2NThaMIGAMQswCQYDVQQGEwJUUjEPMA0GA1UEBxMGQW5r
+YXJhMRkwFwYDVQQKExBFLVR1Z3JhIEVCRyBBLlMuMR0wGwYDVQQLExRFLVR1Z3Jh
+IFRydXN0IENlbnRlcjEmMCQGA1UEAxMdRS1UdWdyYSBHbG9iYWwgUm9vdCBDQSBF
+Q0MgdjMwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAASOmCm/xxAeJ9urA8woLNheSBkQ
+KczLWYHMjLiSF4mDKpL2w6QdTGLVn9agRtwcvHbB40fQWxPa56WzZkjnIZpKT4YK
+fWzqTTKACrJ6CZtpS5iB4i7sAnCWH/31Rs7K3IKjYzBhMA8GA1UdEwEB/wQFMAMB
+Af8wHwYDVR0jBBgwFoAU/4Ixcj75xGZsrTie0bBRiKWQzPUwHQYDVR0OBBYEFP+C
+MXI++cRmbK04ntGwUYilkMz1MA4GA1UdDwEB/wQEAwIBBjAKBggqhkjOPQQDAwNp
+ADBmAjEA5gVYaWHlLcoNy/EZCL3W/VGSGn5jVASQkZo1kTmZ+gepZpO6yGjUij/6
+7W4WAie3AjEA3VoXK3YdZUKWpqxdinlW2Iob35reX8dQj7FbcQwm32pAAOwzkSFx
+vmjkI6TZraE3
+-----END CERTIFICATE-----
+
+# Issuer: CN=Security Communication RootCA3 O=SECOM Trust Systems CO.,LTD.
+# Subject: CN=Security Communication RootCA3 O=SECOM Trust Systems CO.,LTD.
+# Label: "Security Communication RootCA3"
+# Serial: 16247922307909811815
+# MD5 Fingerprint: 1c:9a:16:ff:9e:5c:e0:4d:8a:14:01:f4:35:5d:29:26
+# SHA1 Fingerprint: c3:03:c8:22:74:92:e5:61:a2:9c:5f:79:91:2b:1e:44:13:91:30:3a
+# SHA256 Fingerprint: 24:a5:5c:2a:b0:51:44:2d:06:17:76:65:41:23:9a:4a:d0:32:d7:c5:51:75:aa:34:ff:de:2f:bc:4f:5c:52:94
+-----BEGIN CERTIFICATE-----
+MIIFfzCCA2egAwIBAgIJAOF8N0D9G/5nMA0GCSqGSIb3DQEBDAUAMF0xCzAJBgNV
+BAYTAkpQMSUwIwYDVQQKExxTRUNPTSBUcnVzdCBTeXN0ZW1zIENPLixMVEQuMScw
+JQYDVQQDEx5TZWN1cml0eSBDb21tdW5pY2F0aW9uIFJvb3RDQTMwHhcNMTYwNjE2
+MDYxNzE2WhcNMzgwMTE4MDYxNzE2WjBdMQswCQYDVQQGEwJKUDElMCMGA1UEChMc
+U0VDT00gVHJ1c3QgU3lzdGVtcyBDTy4sTFRELjEnMCUGA1UEAxMeU2VjdXJpdHkg
+Q29tbXVuaWNhdGlvbiBSb290Q0EzMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC
+CgKCAgEA48lySfcw3gl8qUCBWNO0Ot26YQ+TUG5pPDXC7ltzkBtnTCHsXzW7OT4r
+CmDvu20rhvtxosis5FaU+cmvsXLUIKx00rgVrVH+hXShuRD+BYD5UpOzQD11EKzA
+lrenfna84xtSGc4RHwsENPXY9Wk8d/Nk9A2qhd7gCVAEF5aEt8iKvE1y/By7z/MG
+TfmfZPd+pmaGNXHIEYBMwXFAWB6+oHP2/D5Q4eAvJj1+XCO1eXDe+uDRpdYMQXF7
+9+qMHIjH7Iv10S9VlkZ8WjtYO/u62C21Jdp6Ts9EriGmnpjKIG58u4iFW/vAEGK7
+8vknR+/RiTlDxN/e4UG/VHMgly1s2vPUB6PmudhvrvyMGS7TZ2crldtYXLVqAvO4
+g160a75BflcJdURQVc1aEWEhCmHCqYj9E7wtiS/NYeCVvsq1e+F7NGcLH7YMx3we
+GVPKp7FKFSBWFHA9K4IsD50VHUeAR/94mQ4xr28+j+2GaR57GIgUssL8gjMunEst
++3A7caoreyYn8xrC3PsXuKHqy6C0rtOUfnrQq8PsOC0RLoi/1D+tEjtCrI8Cbn3M
+0V9hvqG8OmpI6iZVIhZdXw3/JzOfGAN0iltSIEdrRU0id4xVJ/CvHozJgyJUt5rQ
+T9nO/NkuHJYosQLTA70lUhw0Zk8jq/R3gpYd0VcwCBEF/VfR2ccCAwEAAaNCMEAw
+HQYDVR0OBBYEFGQUfPxYchamCik0FW8qy7z8r6irMA4GA1UdDwEB/wQEAwIBBjAP
+BgNVHRMBAf8EBTADAQH/MA0GCSqGSIb3DQEBDAUAA4ICAQDcAiMI4u8hOscNtybS
+YpOnpSNyByCCYN8Y11StaSWSntkUz5m5UoHPrmyKO1o5yGwBQ8IibQLwYs1OY0PA
+FNr0Y/Dq9HHuTofjcan0yVflLl8cebsjqodEV+m9NU1Bu0soo5iyG9kLFwfl9+qd
+9XbXv8S2gVj/yP9kaWJ5rW4OH3/uHWnlt3Jxs/6lATWUVCvAUm2PVcTJ0rjLyjQI
+UYWg9by0F1jqClx6vWPGOi//lkkZhOpn2ASxYfQAW0q3nHE3GYV5v4GwxxMOdnE+
+OoAGrgYWp421wsTL/0ClXI2lyTrtcoHKXJg80jQDdwj98ClZXSEIx2C/pHF7uNke
+gr4Jr2VvKKu/S7XuPghHJ6APbw+LP6yVGPO5DtxnVW5inkYO0QR4ynKudtml+LLf
+iAlhi+8kTtFZP1rUPcmTPCtk9YENFpb3ksP+MW/oKjJ0DvRMmEoYDjBU1cXrvMUV
+nuiZIesnKwkK2/HmcBhWuwzkvvnoEKQTkrgc4NtnHVMDpCKn3F2SEDzq//wbEBrD
+2NCcnWXL0CsnMQMeNuE9dnUM/0Umud1RvCPHX9jYhxBAEg09ODfnRDwYwFMJZI//
+1ZqmfHAuc1Uh6N//g7kdPjIe1qZ9LPFm6Vwdp6POXiUyK+OVrCoHzrQoeIY8Laad
+TdJ0MN1kURXbg4NR16/9M51NZg==
+-----END CERTIFICATE-----
+
+# Issuer: CN=Security Communication ECC RootCA1 O=SECOM Trust Systems CO.,LTD.
+# Subject: CN=Security Communication ECC RootCA1 O=SECOM Trust Systems CO.,LTD.
+# Label: "Security Communication ECC RootCA1"
+# Serial: 15446673492073852651
+# MD5 Fingerprint: 7e:43:b0:92:68:ec:05:43:4c:98:ab:5d:35:2e:7e:86
+# SHA1 Fingerprint: b8:0e:26:a9:bf:d2:b2:3b:c0:ef:46:c9:ba:c7:bb:f6:1d:0d:41:41
+# SHA256 Fingerprint: e7:4f:bd:a5:5b:d5:64:c4:73:a3:6b:44:1a:a7:99:c8:a6:8e:07:74:40:e8:28:8b:9f:a1:e5:0e:4b:ba:ca:11
+-----BEGIN CERTIFICATE-----
+MIICODCCAb6gAwIBAgIJANZdm7N4gS7rMAoGCCqGSM49BAMDMGExCzAJBgNVBAYT
+AkpQMSUwIwYDVQQKExxTRUNPTSBUcnVzdCBTeXN0ZW1zIENPLixMVEQuMSswKQYD
+VQQDEyJTZWN1cml0eSBDb21tdW5pY2F0aW9uIEVDQyBSb290Q0ExMB4XDTE2MDYx
+NjA1MTUyOFoXDTM4MDExODA1MTUyOFowYTELMAkGA1UEBhMCSlAxJTAjBgNVBAoT
+HFNFQ09NIFRydXN0IFN5c3RlbXMgQ08uLExURC4xKzApBgNVBAMTIlNlY3VyaXR5
+IENvbW11bmljYXRpb24gRUNDIFJvb3RDQTEwdjAQBgcqhkjOPQIBBgUrgQQAIgNi
+AASkpW9gAwPDvTH00xecK4R1rOX9PVdu12O/5gSJko6BnOPpR27KkBLIE+Cnnfdl
+dB9sELLo5OnvbYUymUSxXv3MdhDYW72ixvnWQuRXdtyQwjWpS4g8EkdtXP9JTxpK
+ULGjQjBAMB0GA1UdDgQWBBSGHOf+LaVKiwj+KBH6vqNm+GBZLzAOBgNVHQ8BAf8E
+BAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAKBggqhkjOPQQDAwNoADBlAjAVXUI9/Lbu
+9zuxNuie9sRGKEkz0FhDKmMpzE2xtHqiuQ04pV1IKv3LsnNdo4gIxwwCMQDAqy0O
+be0YottT6SXbVQjgUMzfRGEWgqtJsLKB7HOHeLRMsmIbEvoWTSVLY70eN9k=
+-----END CERTIFICATE-----
diff --git a/lib/certifi/core.py b/lib/certifi/core.py
index 497d938d..de028981 100644
--- a/lib/certifi/core.py
+++ b/lib/certifi/core.py
@@ -4,12 +4,12 @@ certifi.py
 
 This module returns the installation location of cacert.pem or its contents.
 """
-import os
-import types
-from typing import Union
+import sys
 
-try:
-    from importlib.resources import path as get_path, read_text
+
+if sys.version_info >= (3, 11):
+
+    from importlib.resources import as_file, files
 
     _CACERT_CTX = None
     _CACERT_PATH = None
@@ -33,13 +33,54 @@ try:
             # We also have to hold onto the actual context manager, because
             # it will do the cleanup whenever it gets garbage collected, so
             # we will also store that at the global level as well.
+            _CACERT_CTX = as_file(files("certifi").joinpath("cacert.pem"))
+            _CACERT_PATH = str(_CACERT_CTX.__enter__())
+
+        return _CACERT_PATH
+
+    def contents() -> str:
+        return files("certifi").joinpath("cacert.pem").read_text(encoding="ascii")
+
+elif sys.version_info >= (3, 7):
+
+    from importlib.resources import path as get_path, read_text
+
+    _CACERT_CTX = None
+    _CACERT_PATH = None
+
+    def where() -> str:
+        # This is slightly terrible, but we want to delay extracting the
+        # file in cases where we're inside of a zipimport situation until
+        # someone actually calls where(), but we don't want to re-extract
+        # the file on every call of where(), so we'll do it once then store
+        # it in a global variable.
+        global _CACERT_CTX
+        global _CACERT_PATH
+        if _CACERT_PATH is None:
+            # This is slightly janky, the importlib.resources API wants you
+            # to manage the cleanup of this file, so it doesn't actually
+            # return a path, it returns a context manager that will give
+            # you the path when you enter it and will do any cleanup when
+            # you leave it. In the common case of not needing a temporary
+            # file, it will just return the file system location and the
+            # __exit__() is a no-op.
+            #
+            # We also have to hold onto the actual context manager, because
+            # it will do the cleanup whenever it gets garbage collected, so
+            # we will also store that at the global level as well.
             _CACERT_CTX = get_path("certifi", "cacert.pem")
             _CACERT_PATH = str(_CACERT_CTX.__enter__())
 
         return _CACERT_PATH
 
+    def contents() -> str:
+        return read_text("certifi", "cacert.pem", encoding="ascii")
+
+else:
+    import os
+    import types
+    from typing import Union
 
-except ImportError:
     Package = Union[types.ModuleType, str]
     Resource = Union[str, "os.PathLike"]
 
@@ -63,6 +104,5 @@ except ImportError:
 
         return os.path.join(f, "cacert.pem")
 
-
-def contents() -> str:
-    return read_text("certifi", "cacert.pem", encoding="ascii")
+    def contents() -> str:
+        return read_text("certifi", "cacert.pem", encoding="ascii")
diff --git a/lib/charset_normalizer/__init__.py b/lib/charset_normalizer/__init__.py
index 1aea851a..2dcaf56f 100644
--- a/lib/charset_normalizer/__init__.py
+++ b/lib/charset_normalizer/__init__.py
@@ -1,4 +1,4 @@
-# -*- coding: utf_8 -*-
+# -*- coding: utf-8 -*-
 """
 Charset-Normalizer
 ~~~~~~~~~~~~~~
diff --git a/lib/charset_normalizer/api.py b/lib/charset_normalizer/api.py
index bdc8ed98..72907f94 100644
--- a/lib/charset_normalizer/api.py
+++ b/lib/charset_normalizer/api.py
@@ -1,11 +1,8 @@
 import logging
+import warnings
+from os import PathLike
 from os.path import basename, splitext
-from typing import BinaryIO, List, Optional, Set
-
-try:
-    from os import PathLike
-except ImportError:  # pragma: no cover
-    PathLike = str  # type: ignore
+from typing import Any, BinaryIO, List, Optional, Set
 
 from .cd import (
     coherence_ratio,
@@ -18,6 +15,7 @@ from .md import mess_ratio
 from .models import CharsetMatch, CharsetMatches
 from .utils import (
     any_specified_encoding,
+    cut_sequence_chunks,
     iana_name,
     identify_sig_or_bom,
     is_cp_similar,
@@ -39,8 +37,8 @@ def from_bytes(
     steps: int = 5,
     chunk_size: int = 512,
     threshold: float = 0.2,
-    cp_isolation: List[str] = None,
-    cp_exclusion: List[str] = None,
+    cp_isolation: Optional[List[str]] = None,
+    cp_exclusion: Optional[List[str]] = None,
     preemptive_behaviour: bool = True,
     explain: bool = False,
 ) -> CharsetMatches:
@@ -70,11 +68,11 @@ def from_bytes(
         )
 
     if explain:
-        previous_logger_level = logger.level  # type: int
+        previous_logger_level: int = logger.level
         logger.addHandler(explain_handler)
         logger.setLevel(TRACE)
 
-    length = len(sequences)  # type: int
+    length: int = len(sequences)
 
     if length == 0:
         logger.debug("Encoding detection on empty bytes, assuming utf_8 intention.")
@@ -119,8 +117,8 @@ def from_bytes(
     if steps > 1 and length / steps < chunk_size:
         chunk_size = int(length / steps)
 
-    is_too_small_sequence = len(sequences) < TOO_SMALL_SEQUENCE  # type: bool
-    is_too_large_sequence = len(sequences) >= TOO_BIG_SEQUENCE  # type: bool
+    is_too_small_sequence: bool = len(sequences) < TOO_SMALL_SEQUENCE
+    is_too_large_sequence: bool = len(sequences) >= TOO_BIG_SEQUENCE
 
     if is_too_small_sequence:
         logger.log(
@@ -137,11 +135,11 @@ def from_bytes(
             ),
         )
 
-    prioritized_encodings = []  # type: List[str]
+    prioritized_encodings: List[str] = []
 
-    specified_encoding = (
+    specified_encoding: Optional[str] = (
         any_specified_encoding(sequences) if preemptive_behaviour else None
-    )  # type: Optional[str]
+    )
 
     if specified_encoding is not None:
         prioritized_encodings.append(specified_encoding)
@@ -151,15 +149,15 @@ def from_bytes(
             specified_encoding,
         )
 
-    tested = set()  # type: Set[str]
-    tested_but_hard_failure = []  # type: List[str]
-    tested_but_soft_failure = []  # type: List[str]
+    tested: Set[str] = set()
+    tested_but_hard_failure: List[str] = []
+    tested_but_soft_failure: List[str] = []
 
-    fallback_ascii = None  # type: Optional[CharsetMatch]
-    fallback_u8 = None  # type: Optional[CharsetMatch]
-    fallback_specified = None  # type: Optional[CharsetMatch]
+    fallback_ascii: Optional[CharsetMatch] = None
+    fallback_u8: Optional[CharsetMatch] = None
+    fallback_specified: Optional[CharsetMatch] = None
 
-    results = CharsetMatches()  # type: CharsetMatches
+    results: CharsetMatches = CharsetMatches()
 
     sig_encoding, sig_payload = identify_sig_or_bom(sequences)
 
@@ -190,11 +188,11 @@ def from_bytes(
 
         tested.add(encoding_iana)
 
-        decoded_payload = None  # type: Optional[str]
-        bom_or_sig_available = sig_encoding == encoding_iana  # type: bool
-        strip_sig_or_bom = bom_or_sig_available and should_strip_sig_or_bom(
+        decoded_payload: Optional[str] = None
+        bom_or_sig_available: bool = sig_encoding == encoding_iana
+        strip_sig_or_bom: bool = bom_or_sig_available and should_strip_sig_or_bom(
             encoding_iana
-        )  # type: bool
+        )
 
         if encoding_iana in {"utf_16", "utf_32"} and not bom_or_sig_available:
             logger.log(
@@ -205,7 +203,7 @@ def from_bytes(
             continue
 
         try:
-            is_multi_byte_decoder = is_multi_byte_encoding(encoding_iana)  # type: bool
+            is_multi_byte_decoder: bool = is_multi_byte_encoding(encoding_iana)
         except (ModuleNotFoundError, ImportError):
             logger.log(
                 TRACE,
@@ -240,7 +238,7 @@ def from_bytes(
             tested_but_hard_failure.append(encoding_iana)
             continue
 
-        similar_soft_failure_test = False  # type: bool
+        similar_soft_failure_test: bool = False
 
         for encoding_soft_failed in tested_but_soft_failure:
             if is_cp_similar(encoding_iana, encoding_soft_failed):
@@ -262,11 +260,11 @@ def from_bytes(
             int(length / steps),
         )
 
-        multi_byte_bonus = (
+        multi_byte_bonus: bool = (
             is_multi_byte_decoder
             and decoded_payload is not None
             and len(decoded_payload) < length
-        )  # type: bool
+        )
 
         if multi_byte_bonus:
             logger.log(
@@ -276,72 +274,47 @@ def from_bytes(
                 encoding_iana,
             )
 
-        max_chunk_gave_up = int(len(r_) / 4)  # type: int
+        max_chunk_gave_up: int = int(len(r_) / 4)
 
         max_chunk_gave_up = max(max_chunk_gave_up, 2)
-        early_stop_count = 0  # type: int
+        early_stop_count: int = 0
         lazy_str_hard_failure = False
 
-        md_chunks = []  # type: List[str]
+        md_chunks: List[str] = []
         md_ratios = []
 
-        for i in r_:
-            if i + chunk_size > length + 8:
-                continue
-
-            cut_sequence = sequences[i : i + chunk_size]
-
-            if bom_or_sig_available and strip_sig_or_bom is False:
-                cut_sequence = sig_payload + cut_sequence
-
-            try:
-                chunk = cut_sequence.decode(
-                    encoding_iana,
-                    errors="ignore" if is_multi_byte_decoder else "strict",
-                )  # type: str
-            except UnicodeDecodeError as e:  # Lazy str loading may have missed something there
-                logger.log(
-                    TRACE,
-                    "LazyStr Loading: After MD chunk decode, code page %s does not fit given bytes sequence at ALL. %s",
-                    encoding_iana,
-                    str(e),
-                )
-                early_stop_count = max_chunk_gave_up
-                lazy_str_hard_failure = True
-                break
-
-            # multi-byte bad cutting detector and adjustment
-            # not the cleanest way to perform that fix but clever enough for now.
-            if is_multi_byte_decoder and i > 0 and sequences[i] >= 0x80:
-
-                chunk_partial_size_chk = min(chunk_size, 16)  # type: int
-
-                if (
-                    decoded_payload
-                    and chunk[:chunk_partial_size_chk] not in decoded_payload
-                ):
-                    for j in range(i, i - 4, -1):
-                        cut_sequence = sequences[j : i + chunk_size]
-
-                        if bom_or_sig_available and strip_sig_or_bom is False:
-                            cut_sequence = sig_payload + cut_sequence
-
-                        chunk = cut_sequence.decode(encoding_iana, errors="ignore")
-
-                        if chunk[:chunk_partial_size_chk] in decoded_payload:
-                            break
-
-            md_chunks.append(chunk)
-
-            md_ratios.append(mess_ratio(chunk, threshold))
-
-            if md_ratios[-1] >= threshold:
-                early_stop_count += 1
-
-            if (early_stop_count >= max_chunk_gave_up) or (
-                bom_or_sig_available and strip_sig_or_bom is False
+        try:
+            for chunk in cut_sequence_chunks(
+                sequences,
+                encoding_iana,
+                r_,
+                chunk_size,
+                bom_or_sig_available,
+                strip_sig_or_bom,
+                sig_payload,
+                is_multi_byte_decoder,
+                decoded_payload,
             ):
-                break
+                md_chunks.append(chunk)
+
+                md_ratios.append(mess_ratio(chunk, threshold))
+
+                if md_ratios[-1] >= threshold:
+                    early_stop_count += 1
+
+                if (early_stop_count >= max_chunk_gave_up) or (
+                    bom_or_sig_available and strip_sig_or_bom is False
+                ):
+                    break
+        except UnicodeDecodeError as e:  # Lazy str loading may have missed something there
+            logger.log(
+                TRACE,
+                "LazyStr Loading: After MD chunk decode, code page %s does not fit given bytes sequence at ALL. %s",
+                encoding_iana,
+                str(e),
+            )
+            early_stop_count = max_chunk_gave_up
+            lazy_str_hard_failure = True
 
         # We might want to check the sequence again with the whole content
         # Only if initial MD tests passes
@@ -362,9 +335,7 @@ def from_bytes(
                 tested_but_hard_failure.append(encoding_iana)
                 continue
 
-        mean_mess_ratio = (
-            sum(md_ratios) / len(md_ratios) if md_ratios else 0.0
-        )  # type: float
+        mean_mess_ratio: float = sum(md_ratios) / len(md_ratios) if md_ratios else 0.0
         if mean_mess_ratio >= threshold or early_stop_count >= max_chunk_gave_up:
             tested_but_soft_failure.append(encoding_iana)
             logger.log(
@@ -399,7 +370,7 @@ def from_bytes(
         )
 
         if not is_multi_byte_decoder:
-            target_languages = encoding_languages(encoding_iana)  # type: List[str]
+            target_languages: List[str] = encoding_languages(encoding_iana)
         else:
             target_languages = mb_encoding_languages(encoding_iana)
 
@@ -516,8 +487,8 @@ def from_fp(
     steps: int = 5,
     chunk_size: int = 512,
     threshold: float = 0.20,
-    cp_isolation: List[str] = None,
-    cp_exclusion: List[str] = None,
+    cp_isolation: Optional[List[str]] = None,
+    cp_exclusion: Optional[List[str]] = None,
     preemptive_behaviour: bool = True,
     explain: bool = False,
 ) -> CharsetMatches:
@@ -538,12 +509,12 @@ def from_fp(
 
 
 def from_path(
-    path: PathLike,
+    path: "PathLike[Any]",
     steps: int = 5,
     chunk_size: int = 512,
     threshold: float = 0.20,
-    cp_isolation: List[str] = None,
-    cp_exclusion: List[str] = None,
+    cp_isolation: Optional[List[str]] = None,
+    cp_exclusion: Optional[List[str]] = None,
     preemptive_behaviour: bool = True,
     explain: bool = False,
 ) -> CharsetMatches:
@@ -565,17 +536,22 @@ def from_path(
 
 
 def normalize(
-    path: PathLike,
+    path: "PathLike[Any]",
     steps: int = 5,
     chunk_size: int = 512,
     threshold: float = 0.20,
-    cp_isolation: List[str] = None,
-    cp_exclusion: List[str] = None,
+    cp_isolation: Optional[List[str]] = None,
+    cp_exclusion: Optional[List[str]] = None,
     preemptive_behaviour: bool = True,
 ) -> CharsetMatch:
     """
     Take a (text-based) file path and try to create another file next to it, this time using UTF-8.
     """
+    warnings.warn(
+        "normalize is deprecated and will be removed in 3.0",
+        DeprecationWarning,
+    )
+
     results = from_path(
         path,
         steps,
diff --git a/lib/charset_normalizer/assets/__init__.py b/lib/charset_normalizer/assets/__init__.py
index b2e56ff3..3c33ba30 100644
--- a/lib/charset_normalizer/assets/__init__.py
+++ b/lib/charset_normalizer/assets/__init__.py
@@ -1,1244 +1,1122 @@
-# -*- coding: utf_8 -*-
-from collections import OrderedDict
+# -*- coding: utf-8 -*-
+from typing import Dict, List
 
-FREQUENCIES = OrderedDict(
-    [
-        (
-            "English",
-            [
-                "e",
-                "a",
-                "t",
-                "i",
-                "o",
-                "n",
-                "s",
-                "r",
-                "h",
-                "l",
-                "d",
-                "c",
-                "u",
-                "m",
-                "f",
-                "p",
-                "g",
-                "w",
-                "y",
-                "b",
-                "v",
-                "k",
-                "x",
-                "j",
-                "z",
-                "q",
-            ],
-        ),
-        (
-            "German",
-            [
-                "e",
-                "n",
-                "i",
-                "r",
-                "s",
-                "t",
-                "a",
-                "d",
-                "h",
-                "u",
-                "l",
-                "g",
-                "o",
-                "c",
-                "m",
-                "b",
-                "f",
-                "k",
-                "w",
-                "z",
-                "p",
-                "v",
-                "ü",
-                "ä",
-                "ö",
-                "j",
-            ],
-        ),
-        (
-            "French",
-            [
-                "e",
-                "a",
-                "s",
-                "n",
-                "i",
-                "t",
-                "r",
-                "l",
-                "u",
-                "o",
-                "d",
-                "c",
-                "p",
-                "m",
-                "é",
-                "v",
-                "g",
-                "f",
-                "b",
-                "h",
-                "q",
-                "à",
-                "x",
-                "è",
-                "y",
-                "j",
-            ],
-        ),
-        (
-            "Dutch",
-            [
-                "e",
-                "n",
-                "a",
-                "i",
-                "r",
-                "t",
-                "o",
-                "d",
-                "s",
-                "l",
-                "g",
-                "h",
-                "v",
-                "m",
-                "u",
-                "k",
-                "c",
-                "p",
-                "b",
-                "w",
-                "j",
-                "z",
-                "f",
-                "y",
-                "x",
-                "ë",
-            ],
-        ),
-        (
-            "Italian",
-            [
-                "e",
-                "i",
-                "a",
-                "o",
-                "n",
-                "l",
-                "t",
-                "r",
-                "s",
-                "c",
-                "d",
-                "u",
-                "p",
-                "m",
-                "g",
-                "v",
-                "f",
-                "b",
-                "z",
-                "h",
-                "q",
-                "è",
-                "à",
-                "k",
-                "y",
-                "ò",
-            ],
-        ),
-        (
-            "Polish",
-            [
-                "a",
-                "i",
-                "o",
-                "e",
-                "n",
-                "r",
-                "z",
-                "w",
-                "s",
-                "c",
-                "t",
-                "k",
-                "y",
-                "d",
-                "p",
-                "m",
-                "u",
-                "l",
-                "j",
-                "ł",
-                "g",
-                "b",
-                "h",
-                "ą",
-                "ę",
-                "ó",
-            ],
-        ),
-        (
-            "Spanish",
-            [
-                "e",
-                "a",
-                "o",
-                "n",
-                "s",
-                "r",
-                "i",
-                "l",
-                "d",
-                "t",
-                "c",
-                "u",
-                "m",
-                "p",
-                "b",
-                "g",
-                "v",
-                "f",
-                "y",
-                "ó",
-                "h",
-                "q",
-                "í",
-                "j",
-                "z",
-                "á",
-            ],
-        ),
-        (
-            "Russian",
-            [
-                "о",
-                "а",
-                "е",
-                "и",
-                "н",
-                "с",
-                "т",
-                "р",
-                "в",
-                "л",
-                "к",
-                "м",
-                "д",
-                "п",
-                "у",
-                "г",
-                "я",
-                "ы",
-                "з",
-                "б",
-                "й",
-                "ь",
-                "ч",
-                "х",
-                "ж",
-                "ц",
-            ],
-        ),
-        (
-            "Japanese",
-            [
-                "の",
-                "に",
-                "る",
-                "た",
-                "は",
-                "ー",
-                "と",
-                "し",
-                "を",
-                "で",
-                "て",
-                "が",
-                "い",
-                "ン",
-                "れ",
-                "な",
-                "年",
-                "ス",
-                "っ",
-                "ル",
-                "か",
-                "ら",
-                "あ",
-                "さ",
-                "も",
-                "り",
-            ],
-        ),
-        (
-            "Portuguese",
-            [
-                "a",
-                "e",
-                "o",
-                "s",
-                "i",
-                "r",
-                "d",
-                "n",
-                "t",
-                "m",
-                "u",
-                "c",
-                "l",
-                "p",
-                "g",
-                "v",
-                "b",
-                "f",
-                "h",
-                "ã",
-                "q",
-                "é",
-                "ç",
-                "á",
-                "z",
-                "í",
-            ],
-        ),
-        (
-            "Swedish",
-            [
-                "e",
-                "a",
-                "n",
-                "r",
-                "t",
-                "s",
-                "i",
-                "l",
-                "d",
-                "o",
-                "m",
-                "k",
-                "g",
-                "v",
-                "h",
-                "f",
-                "u",
-                "p",
-                "ä",
-                "c",
-                "b",
-                "ö",
-                "å",
-                "y",
-                "j",
-                "x",
-            ],
-        ),
-        (
-            "Chinese",
-            [
-                "的",
-                "一",
-                "是",
-                "不",
-                "了",
-                "在",
-                "人",
-                "有",
-                "我",
-                "他",
-                "这",
-                "个",
-                "们",
-                "中",
-                "来",
-                "上",
-                "大",
-                "为",
-                "和",
-                "国",
-                "地",
-                "到",
-                "以",
-                "说",
-                "时",
-                "要",
-                "就",
-                "出",
-                "会",
-            ],
-        ),
-        (
-            "Ukrainian",
-            [
-                "о",
-                "а",
-                "н",
-                "і",
-                "и",
-                "р",
-                "в",
-                "т",
-                "е",
-                "с",
-                "к",
-                "л",
-                "у",
-                "д",
-                "м",
-                "п",
-                "з",
-                "я",
-                "ь",
-                "б",
-                "г",
-                "й",
-                "ч",
-                "х",
-                "ц",
-                "ї",
-            ],
-        ),
-        (
-            "Norwegian",
-            [
-                "e",
-                "r",
-                "n",
-                "t",
-                "a",
-                "s",
-                "i",
-                "o",
-                "l",
-                "d",
-                "g",
-                "k",
-                "m",
-                "v",
-                "f",
-                "p",
-                "u",
-                "b",
-                "h",
-                "å",
-                "y",
-                "j",
-                "ø",
-                "c",
-                "æ",
-                "w",
-            ],
-        ),
-        (
-            "Finnish",
-            [
-                "a",
-                "i",
-                "n",
-                "t",
-                "e",
-                "s",
-                "l",
-                "o",
-                "u",
-                "k",
-                "ä",
-                "m",
-                "r",
-                "v",
-                "j",
-                "h",
-                "p",
-                "y",
-                "d",
-                "ö",
-                "g",
-                "c",
-                "b",
-                "f",
-                "w",
-                "z",
-            ],
-        ),
-        (
-            "Vietnamese",
-            [
-                "n",
-                "h",
-                "t",
-                "i",
-                "c",
-                "g",
-                "a",
-                "o",
-                "u",
-                "m",
-                "l",
-                "r",
-                "à",
-                "đ",
-                "s",
-                "e",
-                "v",
-                "p",
-                "b",
-                "y",
-                "ư",
-                "d",
-                "á",
-                "k",
-                "ộ",
-                "ế",
-            ],
-        ),
-        (
-            "Czech",
-            [
-                "o",
-                "e",
-                "a",
-                "n",
-                "t",
-                "s",
-                "i",
-                "l",
-                "v",
-                "r",
-                "k",
-                "d",
-                "u",
-                "m",
-                "p",
-                "í",
-                "c",
-                "h",
-                "z",
-                "á",
-                "y",
-                "j",
-                "b",
-                "ě",
-                "é",
-                "ř",
-            ],
-        ),
-        (
-            "Hungarian",
-            [
-                "e",
-                "a",
-                "t",
-                "l",
-                "s",
-                "n",
-                "k",
-                "r",
-                "i",
-                "o",
-                "z",
-                "á",
-                "é",
-                "g",
-                "m",
-                "b",
-                "y",
-                "v",
-                "d",
-                "h",
-                "u",
-                "p",
-                "j",
-                "ö",
-                "f",
-                "c",
-            ],
-        ),
-        (
-            "Korean",
-            [
-                "이",
-                "다",
-                "에",
-                "의",
-                "는",
-                "로",
-                "하",
-                "을",
-                "가",
-                "고",
-                "지",
-                "서",
-                "한",
-                "은",
-                "기",
-                "으",
-                "년",
-                "대",
-                "사",
-                "시",
-                "를",
-                "리",
-                "도",
-                "인",
-                "스",
-                "일",
-            ],
-        ),
-        (
-            "Indonesian",
-            [
-                "a",
-                "n",
-                "e",
-                "i",
-                "r",
-                "t",
-                "u",
-                "s",
-                "d",
-                "k",
-                "m",
-                "l",
-                "g",
-                "p",
-                "b",
-                "o",
-                "h",
-                "y",
-                "j",
-                "c",
-                "w",
-                "f",
-                "v",
-                "z",
-                "x",
-                "q",
-            ],
-        ),
-        (
-            "Turkish",
-            [
-                "a",
-                "e",
-                "i",
-                "n",
-                "r",
-                "l",
-                "ı",
-                "k",
-                "d",
-                "t",
-                "s",
-                "m",
-                "y",
-                "u",
-                "o",
-                "b",
-                "ü",
-                "ş",
-                "v",
-                "g",
-                "z",
-                "h",
-                "c",
-                "p",
-                "ç",
-                "ğ",
-            ],
-        ),
-        (
-            "Romanian",
-            [
-                "e",
-                "i",
-                "a",
-                "r",
-                "n",
-                "t",
-                "u",
-                "l",
-                "o",
-                "c",
-                "s",
-                "d",
-                "p",
-                "m",
-                "ă",
-                "f",
-                "v",
-                "î",
-                "g",
-                "b",
-                "ș",
-                "ț",
-                "z",
-                "h",
-                "â",
-                "j",
-            ],
-        ),
-        (
-            "Farsi",
-            [
-                "ا",
-                "ی",
-                "ر",
-                "د",
-                "ن",
-                "ه",
-                "و",
-                "م",
-                "ت",
-                "ب",
-                "س",
-                "ل",
-                "ک",
-                "ش",
-                "ز",
-                "ف",
-                "گ",
-                "ع",
-                "خ",
-                "ق",
-                "ج",
-                "آ",
-                "پ",
-                "ح",
-                "ط",
-                "ص",
-            ],
-        ),
-        (
-            "Arabic",
-            [
-                "ا",
-                "ل",
-                "ي",
-                "م",
-                "و",
-                "ن",
-                "ر",
-                "ت",
-                "ب",
-                "ة",
-                "ع",
-                "د",
-                "س",
-                "ف",
-                "ه",
-                "ك",
-                "ق",
-                "أ",
-                "ح",
-                "ج",
-                "ش",
-                "ط",
-                "ص",
-                "ى",
-                "خ",
-                "إ",
-            ],
-        ),
-        (
-            "Danish",
-            [
-                "e",
-                "r",
-                "n",
-                "t",
-                "a",
-                "i",
-                "s",
-                "d",
-                "l",
-                "o",
-                "g",
-                "m",
-                "k",
-                "f",
-                "v",
-                "u",
-                "b",
-                "h",
-                "p",
-                "å",
-                "y",
-                "ø",
-                "æ",
-                "c",
-                "j",
-                "w",
-            ],
-        ),
-        (
-            "Serbian",
-            [
-                "а",
-                "и",
-                "о",
-                "е",
-                "н",
-                "р",
-                "с",
-                "у",
-                "т",
-                "к",
-                "ј",
-                "в",
-                "д",
-                "м",
-                "п",
-                "л",
-                "г",
-                "з",
-                "б",
-                "a",
-                "i",
-                "e",
-                "o",
-                "n",
-                "ц",
-                "ш",
-            ],
-        ),
-        (
-            "Lithuanian",
-            [
-                "i",
-                "a",
-                "s",
-                "o",
-                "r",
-                "e",
-                "t",
-                "n",
-                "u",
-                "k",
-                "m",
-                "l",
-                "p",
-                "v",
-                "d",
-                "j",
-                "g",
-                "ė",
-                "b",
-                "y",
-                "ų",
-                "š",
-                "ž",
-                "c",
-                "ą",
-                "į",
-            ],
-        ),
-        (
-            "Slovene",
-            [
-                "e",
-                "a",
-                "i",
-                "o",
-                "n",
-                "r",
-                "s",
-                "l",
-                "t",
-                "j",
-                "v",
-                "k",
-                "d",
-                "p",
-                "m",
-                "u",
-                "z",
-                "b",
-                "g",
-                "h",
-                "č",
-                "c",
-                "š",
-                "ž",
-                "f",
-                "y",
-            ],
-        ),
-        (
-            "Slovak",
-            [
-                "o",
-                "a",
-                "e",
-                "n",
-                "i",
-                "r",
-                "v",
-                "t",
-                "s",
-                "l",
-                "k",
-                "d",
-                "m",
-                "p",
-                "u",
-                "c",
-                "h",
-                "j",
-                "b",
-                "z",
-                "á",
-                "y",
-                "ý",
-                "í",
-                "č",
-                "é",
-            ],
-        ),
-        (
-            "Hebrew",
-            [
-                "י",
-                "ו",
-                "ה",
-                "ל",
-                "ר",
-                "ב",
-                "ת",
-                "מ",
-                "א",
-                "ש",
-                "נ",
-                "ע",
-                "ם",
-                "ד",
-                "ק",
-                "ח",
-                "פ",
-                "ס",
-                "כ",
-                "ג",
-                "ט",
-                "צ",
-                "ן",
-                "ז",
-                "ך",
-            ],
-        ),
-        (
-            "Bulgarian",
-            [
-                "а",
-                "и",
-                "о",
-                "е",
-                "н",
-                "т",
-                "р",
-                "с",
-                "в",
-                "л",
-                "к",
-                "д",
-                "п",
-                "м",
-                "з",
-                "г",
-                "я",
-                "ъ",
-                "у",
-                "б",
-                "ч",
-                "ц",
-                "й",
-                "ж",
-                "щ",
-                "х",
-            ],
-        ),
-        (
-            "Croatian",
-            [
-                "a",
-                "i",
-                "o",
-                "e",
-                "n",
-                "r",
-                "j",
-                "s",
-                "t",
-                "u",
-                "k",
-                "l",
-                "v",
-                "d",
-                "m",
-                "p",
-                "g",
-                "z",
-                "b",
-                "c",
-                "č",
-                "h",
-                "š",
-                "ž",
-                "ć",
-                "f",
-            ],
-        ),
-        (
-            "Hindi",
-            [
-                "क",
-                "र",
-                "स",
-                "न",
-                "त",
-                "म",
-                "ह",
-                "प",
-                "य",
-                "ल",
-                "व",
-                "ज",
-                "द",
-                "ग",
-                "ब",
-                "श",
-                "ट",
-                "अ",
-                "ए",
-                "थ",
-                "भ",
-                "ड",
-                "च",
-                "ध",
-                "ष",
-                "इ",
-            ],
-        ),
-        (
-            "Estonian",
-            [
-                "a",
-                "i",
-                "e",
-                "s",
-                "t",
-                "l",
-                "u",
-                "n",
-                "o",
-                "k",
-                "r",
-                "d",
-                "m",
-                "v",
-                "g",
-                "p",
-                "j",
-                "h",
-                "ä",
-                "b",
-                "õ",
-                "ü",
-                "f",
-                "c",
-                "ö",
-                "y",
-            ],
-        ),
-        (
-            "Simple English",
-            [
-                "e",
-                "a",
-                "t",
-                "i",
-                "o",
-                "n",
-                "s",
-                "r",
-                "h",
-                "l",
-                "d",
-                "c",
-                "m",
-                "u",
-                "f",
-                "p",
-                "g",
-                "w",
-                "b",
-                "y",
-                "v",
-                "k",
-                "j",
-                "x",
-                "z",
-                "q",
-            ],
-        ),
-        (
-            "Thai",
-            [
-                "า",
-                "น",
-                "ร",
-                "อ",
-                "ก",
-                "เ",
-                "ง",
-                "ม",
-                "ย",
-                "ล",
-                "ว",
-                "ด",
-                "ท",
-                "ส",
-                "ต",
-                "ะ",
-                "ป",
-                "บ",
-                "ค",
-                "ห",
-                "แ",
-                "จ",
-                "พ",
-                "ช",
-                "ข",
-                "ใ",
-            ],
-        ),
-        (
-            "Greek",
-            [
-                "α",
-                "τ",
-                "ο",
-                "ι",
-                "ε",
-                "ν",
-                "ρ",
-                "σ",
-                "κ",
-                "η",
-                "π",
-                "ς",
-                "υ",
-                "μ",
-                "λ",
-                "ί",
-                "ό",
-                "ά",
-                "γ",
-                "έ",
-                "δ",
-                "ή",
-                "ω",
-                "χ",
-                "θ",
-                "ύ",
-            ],
-        ),
-        (
-            "Tamil",
-            [
-                "க",
-                "த",
-                "ப",
-                "ட",
-                "ர",
-                "ம",
-                "ல",
-                "ன",
-                "வ",
-                "ற",
-                "ய",
-                "ள",
-                "ச",
-                "ந",
-                "இ",
-                "ண",
-                "அ",
-                "ஆ",
-                "ழ",
-                "ங",
-                "எ",
-                "உ",
-                "ஒ",
-                "ஸ",
-            ],
-        ),
-        (
-            "Classical Chinese",
-            [
-                "之",
-                "年",
-                "為",
-                "也",
-                "以",
-                "一",
-                "人",
-                "其",
-                "者",
-                "國",
-                "有",
-                "二",
-                "十",
-                "於",
-                "曰",
-                "三",
-                "不",
-                "大",
-                "而",
-                "子",
-                "中",
-                "五",
-                "四",
-            ],
-        ),
-        (
-            "Kazakh",
-            [
-                "а",
-                "ы",
-                "е",
-                "н",
-                "т",
-                "р",
-                "л",
-                "і",
-                "д",
-                "с",
-                "м",
-                "қ",
-                "к",
-                "о",
-                "б",
-                "и",
-                "у",
-                "ғ",
-                "ж",
-                "ң",
-                "з",
-                "ш",
-                "й",
-                "п",
-                "г",
-                "ө",
-            ],
-        ),
-    ]
-)
+FREQUENCIES: Dict[str, List[str]] = {
+    "English": [
+        "e",
+        "a",
+        "t",
+        "i",
+        "o",
+        "n",
+        "s",
+        "r",
+        "h",
+        "l",
+        "d",
+        "c",
+        "u",
+        "m",
+        "f",
+        "p",
+        "g",
+        "w",
+        "y",
+        "b",
+        "v",
+        "k",
+        "x",
+        "j",
+        "z",
+        "q",
+    ],
+    "German": [
+        "e",
+        "n",
+        "i",
+        "r",
+        "s",
+        "t",
+        "a",
+        "d",
+        "h",
+        "u",
+        "l",
+        "g",
+        "o",
+        "c",
+        "m",
+        "b",
+        "f",
+        "k",
+        "w",
+        "z",
+        "p",
+        "v",
+        "ü",
+        "ä",
+        "ö",
+        "j",
+    ],
+    "French": [
+        "e",
+        "a",
+        "s",
+        "n",
+        "i",
+        "t",
+        "r",
+        "l",
+        "u",
+        "o",
+        "d",
+        "c",
+        "p",
+        "m",
+        "é",
+        "v",
+        "g",
+        "f",
+        "b",
+        "h",
+        "q",
+        "à",
+        "x",
+        "è",
+        "y",
+        "j",
+    ],
+    "Dutch": [
+        "e",
+        "n",
+        "a",
+        "i",
+        "r",
+        "t",
+        "o",
+        "d",
+        "s",
+        "l",
+        "g",
+        "h",
+        "v",
+        "m",
+        "u",
+        "k",
+        "c",
+        "p",
+        "b",
+        "w",
+        "j",
+        "z",
+        "f",
+        "y",
+        "x",
+        "ë",
+    ],
+    "Italian": [
+        "e",
+        "i",
+        "a",
+        "o",
+        "n",
+        "l",
+        "t",
+        "r",
+        "s",
+        "c",
+        "d",
+        "u",
+        "p",
+        "m",
+        "g",
+        "v",
+        "f",
+        "b",
+        "z",
+        "h",
+        "q",
+        "è",
+        "à",
+        "k",
+        "y",
+        "ò",
+    ],
+    "Polish": [
+        "a",
+        "i",
+        "o",
+        "e",
+        "n",
+        "r",
+        "z",
+        "w",
+        "s",
+        "c",
+        "t",
+        "k",
+        "y",
+        "d",
+        "p",
+        "m",
+        "u",
+        "l",
+        "j",
+        "ł",
+        "g",
+        "b",
+        "h",
+        "ą",
+        "ę",
+        "ó",
+    ],
+    "Spanish": [
+        "e",
+        "a",
+        "o",
+        "n",
+        "s",
+        "r",
+        "i",
+        "l",
+        "d",
+        "t",
+        "c",
+        "u",
+        "m",
+        "p",
+        "b",
+        "g",
+        "v",
+        "f",
+        "y",
+        "ó",
+        "h",
+        "q",
+        "í",
+        "j",
+        "z",
+        "á",
+    ],
+    "Russian": [
+        "о",
+        "а",
+        "е",
+        "и",
+        "н",
+        "с",
+        "т",
+        "р",
+        "в",
+        "л",
+        "к",
+        "м",
+        "д",
+        "п",
+        "у",
+        "г",
+        "я",
+        "ы",
+        "з",
+        "б",
+        "й",
+        "ь",
+        "ч",
+        "х",
+        "ж",
+        "ц",
+    ],
+    "Japanese": [
+        "の",
+        "に",
+        "る",
+        "た",
+        "は",
+        "ー",
+        "と",
+        "し",
+        "を",
+        "で",
+        "て",
+        "が",
+        "い",
+        "ン",
+        "れ",
+        "な",
+        "年",
+        "ス",
+        "っ",
+        "ル",
+        "か",
+        "ら",
+        "あ",
+        "さ",
+        "も",
+        "り",
+    ],
+    "Portuguese": [
+        "a",
+        "e",
+        "o",
+        "s",
+        "i",
+        "r",
+        "d",
+        "n",
+        "t",
+        "m",
+        "u",
+        "c",
+        "l",
+        "p",
+        "g",
+        "v",
+        "b",
+        "f",
+        "h",
+        "ã",
+        "q",
+        "é",
+        "ç",
+        "á",
+        "z",
+        "í",
+    ],
+    "Swedish": [
+        "e",
+        "a",
+        "n",
+        "r",
+        "t",
+        "s",
+        "i",
+        "l",
+        "d",
+        "o",
+        "m",
+        "k",
+        "g",
+        "v",
+        "h",
+        "f",
+        "u",
+        "p",
+        "ä",
+        "c",
+        "b",
+        "ö",
+        "å",
+        "y",
+        "j",
+        "x",
+    ],
+    "Chinese": [
+        "的",
+        "一",
+        "是",
+        "不",
+        "了",
+        "在",
+        "人",
+        "有",
+        "我",
+        "他",
+        "这",
+        "个",
+        "们",
+        "中",
+        "来",
+        "上",
+        "大",
+        "为",
+        "和",
+        "国",
+        "地",
+        "到",
+        "以",
+        "说",
+        "时",
+        "要",
+        "就",
+        "出",
+        "会",
+    ],
+    "Ukrainian": [
+        "о",
+        "а",
+        "н",
+        "і",
+        "и",
+        "р",
+        "в",
+        "т",
+        "е",
+        "с",
+        "к",
+        "л",
+        "у",
+        "д",
+        "м",
+        "п",
+        "з",
+        "я",
+        "ь",
+        "б",
+        "г",
+        "й",
+        "ч",
+        "х",
+        "ц",
+        "ї",
+    ],
+    "Norwegian": [
+        "e",
+        "r",
+        "n",
+        "t",
+        "a",
+        "s",
+        "i",
+        "o",
+        "l",
+        "d",
+        "g",
+        "k",
+        "m",
+        "v",
+        "f",
+        "p",
+        "u",
+        "b",
+        "h",
+        "å",
+        "y",
+        "j",
+        "ø",
+        "c",
+        "æ",
+        "w",
+    ],
+    "Finnish": [
+        "a",
+        "i",
+        "n",
+        "t",
+        "e",
+        "s",
+        "l",
+        "o",
+        "u",
+        "k",
+        "ä",
+        "m",
+        "r",
+        "v",
+        "j",
+        "h",
+        "p",
+        "y",
+        "d",
+        "ö",
+        "g",
+        "c",
+        "b",
+        "f",
+        "w",
+        "z",
+    ],
+    "Vietnamese": [
+        "n",
+        "h",
+        "t",
+        "i",
+        "c",
+        "g",
+        "a",
+        "o",
+        "u",
+        "m",
+        "l",
+        "r",
+        "à",
+        "đ",
+        "s",
+        "e",
+        "v",
+        "p",
+        "b",
+        "y",
+        "ư",
+        "d",
+        "á",
+        "k",
+        "ộ",
+        "ế",
+    ],
+    "Czech": [
+        "o",
+        "e",
+        "a",
+        "n",
+        "t",
+        "s",
+        "i",
+        "l",
+        "v",
+        "r",
+        "k",
+        "d",
+        "u",
+        "m",
+        "p",
+        "í",
+        "c",
+        "h",
+        "z",
+        "á",
+        "y",
+        "j",
+        "b",
+        "ě",
+        "é",
+        "ř",
+    ],
+    "Hungarian": [
+        "e",
+        "a",
+        "t",
+        "l",
+        "s",
+        "n",
+        "k",
+        "r",
+        "i",
+        "o",
+        "z",
+        "á",
+        "é",
+        "g",
+        "m",
+        "b",
+        "y",
+        "v",
+        "d",
+        "h",
+        "u",
+        "p",
+        "j",
+        "ö",
+        "f",
+        "c",
+    ],
+    "Korean": [
+        "이",
+        "다",
+        "에",
+        "의",
+        "는",
+        "로",
+        "하",
+        "을",
+        "가",
+        "고",
+        "지",
+        "서",
+        "한",
+        "은",
+        "기",
+        "으",
+        "년",
+        "대",
+        "사",
+        "시",
+        "를",
+        "리",
+        "도",
+        "인",
+        "스",
+        "일",
+    ],
+    "Indonesian": [
+        "a",
+        "n",
+        "e",
+        "i",
+        "r",
+        "t",
+        "u",
+        "s",
+        "d",
+        "k",
+        "m",
+        "l",
+        "g",
+        "p",
+        "b",
+        "o",
+        "h",
+        "y",
+        "j",
+        "c",
+        "w",
+        "f",
+        "v",
+        "z",
+        "x",
+        "q",
+    ],
+    "Turkish": [
+        "a",
+        "e",
+        "i",
+        "n",
+        "r",
+        "l",
+        "ı",
+        "k",
+        "d",
+        "t",
+        "s",
+        "m",
+        "y",
+        "u",
+        "o",
+        "b",
+        "ü",
+        "ş",
+        "v",
+        "g",
+        "z",
+        "h",
+        "c",
+        "p",
+        "ç",
+        "ğ",
+    ],
+    "Romanian": [
+        "e",
+        "i",
+        "a",
+        "r",
+        "n",
+        "t",
+        "u",
+        "l",
+        "o",
+        "c",
+        "s",
+        "d",
+        "p",
+        "m",
+        "ă",
+        "f",
+        "v",
+        "î",
+        "g",
+        "b",
+        "ș",
+        "ț",
+        "z",
+        "h",
+        "â",
+        "j",
+    ],
+    "Farsi": [
+        "ا",
+        "ی",
+        "ر",
+        "د",
+        "ن",
+        "ه",
+        "و",
+        "م",
+        "ت",
+        "ب",
+        "س",
+        "ل",
+        "ک",
+        "ش",
+        "ز",
+        "ف",
+        "گ",
+        "ع",
+        "خ",
+        "ق",
+        "ج",
+        "آ",
+        "پ",
+        "ح",
+        "ط",
+        "ص",
+    ],
+    "Arabic": [
+        "ا",
+        "ل",
+        "ي",
+        "م",
+        "و",
+        "ن",
+        "ر",
+        "ت",
+        "ب",
+        "ة",
+        "ع",
+        "د",
+        "س",
+        "ف",
+        "ه",
+        "ك",
+        "ق",
+        "أ",
+        "ح",
+        "ج",
+        "ش",
+        "ط",
+        "ص",
+        "ى",
+        "خ",
+        "إ",
+    ],
+    "Danish": [
+        "e",
+        "r",
+        "n",
+        "t",
+        "a",
+        "i",
+        "s",
+        "d",
+        "l",
+        "o",
+        "g",
+        "m",
+        "k",
+        "f",
+        "v",
+        "u",
+        "b",
+        "h",
+        "p",
+        "å",
+        "y",
+        "ø",
+        "æ",
+        "c",
+        "j",
+        "w",
+    ],
+    "Serbian": [
+        "а",
+        "и",
+        "о",
+        "е",
+        "н",
+        "р",
+        "с",
+        "у",
+        "т",
+        "к",
+        "ј",
+        "в",
+        "д",
+        "м",
+        "п",
+        "л",
+        "г",
+        "з",
+        "б",
+        "a",
+        "i",
+        "e",
+        "o",
+        "n",
+        "ц",
+        "ш",
+    ],
+    "Lithuanian": [
+        "i",
+        "a",
+        "s",
+        "o",
+        "r",
+        "e",
+        "t",
+        "n",
+        "u",
+        "k",
+        "m",
+        "l",
+        "p",
+        "v",
+        "d",
+        "j",
+        "g",
+        "ė",
+        "b",
+        "y",
+        "ų",
+        "š",
+        "ž",
+        "c",
+        "ą",
+        "į",
+    ],
+    "Slovene": [
+        "e",
+        "a",
+        "i",
+        "o",
+        "n",
+        "r",
+        "s",
+        "l",
+        "t",
+        "j",
+        "v",
+        "k",
+        "d",
+        "p",
+        "m",
+        "u",
+        "z",
+        "b",
+        "g",
+        "h",
+        "č",
+        "c",
+        "š",
+        "ž",
+        "f",
+        "y",
+    ],
+    "Slovak": [
+        "o",
+        "a",
+        "e",
+        "n",
+        "i",
+        "r",
+        "v",
+        "t",
+        "s",
+        "l",
+        "k",
+        "d",
+        "m",
+        "p",
+        "u",
+        "c",
+        "h",
+        "j",
+        "b",
+        "z",
+        "á",
+        "y",
+        "ý",
+        "í",
+        "č",
+        "é",
+    ],
+    "Hebrew": [
+        "י",
+        "ו",
+        "ה",
+        "ל",
+        "ר",
+        "ב",
+        "ת",
+        "מ",
+        "א",
+        "ש",
+        "נ",
+        "ע",
+        "ם",
+        "ד",
+        "ק",
+        "ח",
+        "פ",
+        "ס",
+        "כ",
+        "ג",
+        "ט",
+        "צ",
+        "ן",
+        "ז",
+        "ך",
+    ],
+    "Bulgarian": [
+        "а",
+        "и",
+        "о",
+        "е",
+        "н",
+        "т",
+        "р",
+        "с",
+        "в",
+        "л",
+        "к",
+        "д",
+        "п",
+        "м",
+        "з",
+        "г",
+        "я",
+        "ъ",
+        "у",
+        "б",
+        "ч",
+        "ц",
+        "й",
+        "ж",
+        "щ",
+        "х",
+    ],
+    "Croatian": [
+        "a",
+        "i",
+        "o",
+        "e",
+        "n",
+        "r",
+        "j",
+        "s",
+        "t",
+        "u",
+        "k",
+        "l",
+        "v",
+        "d",
+        "m",
+        "p",
+        "g",
+        "z",
+        "b",
+        "c",
+        "č",
+        "h",
+        "š",
+        "ž",
+        "ć",
+        "f",
+    ],
+    "Hindi": [
+        "क",
+        "र",
+        "स",
+        "न",
+        "त",
+        "म",
+        "ह",
+        "प",
+        "य",
+        "ल",
+        "व",
+        "ज",
+        "द",
+        "ग",
+        "ब",
+        "श",
+        "ट",
+        "अ",
+        "ए",
+        "थ",
+        "भ",
+        "ड",
+        "च",
+        "ध",
+        "ष",
+        "इ",
+    ],
+    "Estonian": [
+        "a",
+        "i",
+        "e",
+        "s",
+        "t",
+        "l",
+        "u",
+        "n",
+        "o",
+        "k",
+        "r",
+        "d",
+        "m",
+        "v",
+        "g",
+        "p",
+        "j",
+        "h",
+        "ä",
+        "b",
+        "õ",
+        "ü",
+        "f",
+        "c",
+        "ö",
+        "y",
+    ],
+    "Simple English": [
+        "e",
+        "a",
+        "t",
+        "i",
+        "o",
+        "n",
+        "s",
+        "r",
+        "h",
+        "l",
+        "d",
+        "c",
+        "m",
+        "u",
+        "f",
+        "p",
+        "g",
+        "w",
+        "b",
+        "y",
+        "v",
+        "k",
+        "j",
+        "x",
+        "z",
+        "q",
+    ],
+    "Thai": [
+        "า",
+        "น",
+        "ร",
+        "อ",
+        "ก",
+        "เ",
+        "ง",
+        "ม",
+        "ย",
+        "ล",
+        "ว",
+        "ด",
+        "ท",
+        "ส",
+        "ต",
+        "ะ",
+        "ป",
+        "บ",
+        "ค",
+        "ห",
+        "แ",
+        "จ",
+        "พ",
+        "ช",
+        "ข",
+        "ใ",
+    ],
+    "Greek": [
+        "α",
+        "τ",
+        "ο",
+        "ι",
+        "ε",
+        "ν",
+        "ρ",
+        "σ",
+        "κ",
+        "η",
+        "π",
+        "ς",
+        "υ",
+        "μ",
+        "λ",
+        "ί",
+        "ό",
+        "ά",
+        "γ",
+        "έ",
+        "δ",
+        "ή",
+        "ω",
+        "χ",
+        "θ",
+        "ύ",
+    ],
+    "Tamil": [
+        "க",
+        "த",
+        "ப",
+        "ட",
+        "ர",
+        "ம",
+        "ல",
+        "ன",
+        "வ",
+        "ற",
+        "ய",
+        "ள",
+        "ச",
+        "ந",
+        "இ",
+        "ண",
+        "அ",
+        "ஆ",
+        "ழ",
+        "ங",
+        "எ",
+        "உ",
+        "ஒ",
+        "ஸ",
+    ],
+    "Classical Chinese": [
+        "之",
+        "年",
+        "為",
+        "也",
+        "以",
+        "一",
+        "人",
+        "其",
+        "者",
+        "國",
+        "有",
+        "二",
+        "十",
+        "於",
+        "曰",
+        "三",
+        "不",
+        "大",
+        "而",
+        "子",
+        "中",
+        "五",
+        "四",
+    ],
+    "Kazakh": [
+        "а",
+        "ы",
+        "е",
+        "н",
+        "т",
+        "р",
+        "л",
+        "і",
+        "д",
+        "с",
+        "м",
+        "қ",
+        "к",
+        "о",
+        "б",
+        "и",
+        "у",
+        "ғ",
+        "ж",
+        "ң",
+        "з",
+        "ш",
+        "й",
+        "п",
+        "г",
+        "ө",
+    ],
+}
diff --git a/lib/charset_normalizer/cd.py b/lib/charset_normalizer/cd.py
index 8429a0eb..ee4b7424 100644
--- a/lib/charset_normalizer/cd.py
+++ b/lib/charset_normalizer/cd.py
@@ -1,8 +1,8 @@
 import importlib
 from codecs import IncrementalDecoder
-from collections import Counter, OrderedDict
+from collections import Counter
 from functools import lru_cache
-from typing import Dict, List, Optional, Tuple
+from typing import Counter as TypeCounter, Dict, List, Optional, Tuple
 
 from .assets import FREQUENCIES
 from .constant import KO_NAMES, LANGUAGE_SUPPORTED_COUNT, TOO_SMALL_SEQUENCE, ZH_NAMES
@@ -24,17 +24,19 @@ def encoding_unicode_range(iana_name: str) -> List[str]:
     if is_multi_byte_encoding(iana_name):
         raise IOError("Function not supported on multi-byte code page")
 
-    decoder = importlib.import_module("encodings.{}".format(iana_name)).IncrementalDecoder  # type: ignore
+    decoder = importlib.import_module(
+        "encodings.{}".format(iana_name)
+    ).IncrementalDecoder
 
-    p = decoder(errors="ignore")  # type: IncrementalDecoder
-    seen_ranges = {}  # type: Dict[str, int]
-    character_count = 0  # type: int
+    p: IncrementalDecoder = decoder(errors="ignore")
+    seen_ranges: Dict[str, int] = {}
+    character_count: int = 0
 
     for i in range(0x40, 0xFF):
-        chunk = p.decode(bytes([i]))  # type: str
+        chunk: str = p.decode(bytes([i]))
 
         if chunk:
-            character_range = unicode_range(chunk)  # type: Optional[str]
+            character_range: Optional[str] = unicode_range(chunk)
 
             if character_range is None:
                 continue
@@ -58,7 +60,7 @@ def unicode_range_languages(primary_range: str) -> List[str]:
     """
     Return inferred languages used with a unicode range.
     """
-    languages = []  # type: List[str]
+    languages: List[str] = []
 
     for language, characters in FREQUENCIES.items():
         for character in characters:
@@ -75,8 +77,8 @@ def encoding_languages(iana_name: str) -> List[str]:
     Single-byte encoding language association. Some code page are heavily linked to particular language(s).
     This function does the correspondence.
     """
-    unicode_ranges = encoding_unicode_range(iana_name)  # type: List[str]
-    primary_range = None  # type: Optional[str]
+    unicode_ranges: List[str] = encoding_unicode_range(iana_name)
+    primary_range: Optional[str] = None
 
     for specified_range in unicode_ranges:
         if "Latin" not in specified_range:
@@ -115,8 +117,8 @@ def get_target_features(language: str) -> Tuple[bool, bool]:
     """
     Determine main aspects from a supported language if it contains accents and if is pure Latin.
     """
-    target_have_accents = False  # type: bool
-    target_pure_latin = True  # type: bool
+    target_have_accents: bool = False
+    target_pure_latin: bool = True
 
     for character in FREQUENCIES[language]:
         if not target_have_accents and is_accentuated(character):
@@ -133,7 +135,7 @@ def alphabet_languages(
     """
     Return associated languages associated to given characters.
     """
-    languages = []  # type: List[Tuple[str, float]]
+    languages: List[Tuple[str, float]] = []
 
     source_have_accents = any(is_accentuated(character) for character in characters)
 
@@ -147,13 +149,13 @@ def alphabet_languages(
         if target_have_accents is False and source_have_accents:
             continue
 
-        character_count = len(language_characters)  # type: int
+        character_count: int = len(language_characters)
 
-        character_match_count = len(
+        character_match_count: int = len(
             [c for c in language_characters if c in characters]
-        )  # type: int
+        )
 
-        ratio = character_match_count / character_count  # type: float
+        ratio: float = character_match_count / character_count
 
         if ratio >= 0.2:
             languages.append((language, ratio))
@@ -174,36 +176,33 @@ def characters_popularity_compare(
     if language not in FREQUENCIES:
         raise ValueError("{} not available".format(language))
 
-    character_approved_count = 0  # type: int
+    character_approved_count: int = 0
+    FREQUENCIES_language_set = set(FREQUENCIES[language])
 
     for character in ordered_characters:
-        if character not in FREQUENCIES[language]:
+        if character not in FREQUENCIES_language_set:
             continue
 
-        characters_before_source = FREQUENCIES[language][
+        characters_before_source: List[str] = FREQUENCIES[language][
             0 : FREQUENCIES[language].index(character)
-        ]  # type: List[str]
-        characters_after_source = FREQUENCIES[language][
+        ]
+        characters_after_source: List[str] = FREQUENCIES[language][
             FREQUENCIES[language].index(character) :
-        ]  # type: List[str]
-
-        characters_before = ordered_characters[
+        ]
+        characters_before: List[str] = ordered_characters[
             0 : ordered_characters.index(character)
-        ]  # type: List[str]
-        characters_after = ordered_characters[
+        ]
+        characters_after: List[str] = ordered_characters[
             ordered_characters.index(character) :
-        ]  # type: List[str]
+        ]
 
-        before_match_count = [
-            e in characters_before for e in characters_before_source
-        ].count(
-            True
-        )  # type: int
-        after_match_count = [
-            e in characters_after for e in characters_after_source
-        ].count(
-            True
-        )  # type: int
+        before_match_count: int = len(
+            set(characters_before) & set(characters_before_source)
+        )
+
+        after_match_count: int = len(
+            set(characters_after) & set(characters_after_source)
+        )
 
         if len(characters_before_source) == 0 and before_match_count <= 4:
             character_approved_count += 1
@@ -229,18 +228,18 @@ def alpha_unicode_split(decoded_sequence: str) -> List[str]:
     Ex. a text containing English/Latin with a bit a Hebrew will return two items in the resulting list;
     One containing the latin letters and the other hebrew.
     """
-    layers = OrderedDict()  # type: Dict[str, str]
+    layers: Dict[str, str] = {}
 
     for character in decoded_sequence:
         if character.isalpha() is False:
             continue
 
-        character_range = unicode_range(character)  # type: Optional[str]
+        character_range: Optional[str] = unicode_range(character)
 
         if character_range is None:
             continue
 
-        layer_target_range = None  # type: Optional[str]
+        layer_target_range: Optional[str] = None
 
         for discovered_range in layers:
             if (
@@ -267,7 +266,7 @@ def merge_coherence_ratios(results: List[CoherenceMatches]) -> CoherenceMatches:
     This function merge results previously given by the function coherence_ratio.
     The return type is the same as coherence_ratio.
     """
-    per_language_ratios = OrderedDict()  # type: Dict[str, List[float]]
+    per_language_ratios: Dict[str, List[float]] = {}
     for result in results:
         for sub_result in result:
             language, ratio = sub_result
@@ -299,10 +298,10 @@ def coherence_ratio(
     A layer = Character extraction by alphabets/ranges.
     """
 
-    results = []  # type: List[Tuple[str, float]]
-    ignore_non_latin = False  # type: bool
+    results: List[Tuple[str, float]] = []
+    ignore_non_latin: bool = False
 
-    sufficient_match_count = 0  # type: int
+    sufficient_match_count: int = 0
 
     lg_inclusion_list = lg_inclusion.split(",") if lg_inclusion is not None else []
     if "Latin Based" in lg_inclusion_list:
@@ -310,22 +309,22 @@ def coherence_ratio(
         lg_inclusion_list.remove("Latin Based")
 
     for layer in alpha_unicode_split(decoded_sequence):
-        sequence_frequencies = Counter(layer)  # type: Counter
+        sequence_frequencies: TypeCounter[str] = Counter(layer)
         most_common = sequence_frequencies.most_common()
 
-        character_count = sum(o for c, o in most_common)  # type: int
+        character_count: int = sum(o for c, o in most_common)
 
         if character_count <= TOO_SMALL_SEQUENCE:
             continue
 
-        popular_character_ordered = [c for c, o in most_common]  # type: List[str]
+        popular_character_ordered: List[str] = [c for c, o in most_common]
 
         for language in lg_inclusion_list or alphabet_languages(
             popular_character_ordered, ignore_non_latin
         ):
-            ratio = characters_popularity_compare(
+            ratio: float = characters_popularity_compare(
                 language, popular_character_ordered
-            )  # type: float
+            )
 
             if ratio < threshold:
                 continue
diff --git a/lib/charset_normalizer/cli/normalizer.py b/lib/charset_normalizer/cli/normalizer.py
index 5f912c92..b8b652a5 100644
--- a/lib/charset_normalizer/cli/normalizer.py
+++ b/lib/charset_normalizer/cli/normalizer.py
@@ -3,7 +3,12 @@ import sys
 from json import dumps
 from os.path import abspath
 from platform import python_version
-from typing import List
+from typing import List, Optional
+
+try:
+    from unicodedata2 import unidata_version
+except ImportError:
+    from unicodedata import unidata_version
 
 from charset_normalizer import from_fp
 from charset_normalizer.models import CliDetectionResult
@@ -43,7 +48,7 @@ def query_yes_no(question: str, default: str = "yes") -> bool:
             sys.stdout.write("Please respond with 'yes' or 'no' " "(or 'y' or 'n').\n")
 
 
-def cli_detect(argv: List[str] = None) -> int:
+def cli_detect(argv: Optional[List[str]] = None) -> int:
     """
     CLI assistant using ARGV and ArgumentParser
     :param argv:
@@ -111,7 +116,7 @@ def cli_detect(argv: List[str] = None) -> int:
         "-t",
         "--threshold",
         action="store",
-        default=0.1,
+        default=0.2,
         type=float,
         dest="threshold",
         help="Define a custom maximum amount of chaos allowed in decoded content. 0. <= chaos <= 1.",
@@ -119,8 +124,8 @@ def cli_detect(argv: List[str] = None) -> int:
     parser.add_argument(
         "--version",
         action="version",
-        version="Charset-Normalizer {} - Python {}".format(
-            __version__, python_version()
+        version="Charset-Normalizer {} - Python {} - Unicode {}".format(
+            __version__, python_version(), unidata_version
         ),
         help="Show version information and exit.",
     )
@@ -229,7 +234,7 @@ def cli_detect(argv: List[str] = None) -> int:
                         my_file.close()
                     continue
 
-                o_ = my_file.name.split(".")  # type: List[str]
+                o_: List[str] = my_file.name.split(".")
 
                 if args.replace is False:
                     o_.insert(-1, best_guess.encoding)
diff --git a/lib/charset_normalizer/constant.py b/lib/charset_normalizer/constant.py
index c32f5cf2..ac840c46 100644
--- a/lib/charset_normalizer/constant.py
+++ b/lib/charset_normalizer/constant.py
@@ -1,5 +1,4 @@
 from codecs import BOM_UTF8, BOM_UTF16_BE, BOM_UTF16_LE, BOM_UTF32_BE, BOM_UTF32_LE
-from collections import OrderedDict
 from encodings.aliases import aliases
 from re import IGNORECASE, compile as re_compile
 from typing import Dict, List, Set, Union
@@ -7,31 +6,26 @@ from typing import Dict, List, Set, Union
 from .assets import FREQUENCIES
 
 # Contain for each eligible encoding a list of/item bytes SIG/BOM
-ENCODING_MARKS = OrderedDict(
-    [
-        ("utf_8", BOM_UTF8),
-        (
-            "utf_7",
-            [
-                b"\x2b\x2f\x76\x38",
-                b"\x2b\x2f\x76\x39",
-                b"\x2b\x2f\x76\x2b",
-                b"\x2b\x2f\x76\x2f",
-                b"\x2b\x2f\x76\x38\x2d",
-            ],
-        ),
-        ("gb18030", b"\x84\x31\x95\x33"),
-        ("utf_32", [BOM_UTF32_BE, BOM_UTF32_LE]),
-        ("utf_16", [BOM_UTF16_BE, BOM_UTF16_LE]),
-    ]
-)  # type: Dict[str, Union[bytes, List[bytes]]]
+ENCODING_MARKS: Dict[str, Union[bytes, List[bytes]]] = {
+    "utf_8": BOM_UTF8,
+    "utf_7": [
+        b"\x2b\x2f\x76\x38",
+        b"\x2b\x2f\x76\x39",
+        b"\x2b\x2f\x76\x2b",
+        b"\x2b\x2f\x76\x2f",
+        b"\x2b\x2f\x76\x38\x2d",
+    ],
+    "gb18030": b"\x84\x31\x95\x33",
+    "utf_32": [BOM_UTF32_BE, BOM_UTF32_LE],
+    "utf_16": [BOM_UTF16_BE, BOM_UTF16_LE],
+}
 
-TOO_SMALL_SEQUENCE = 32  # type: int
-TOO_BIG_SEQUENCE = int(10e6)  # type: int
+TOO_SMALL_SEQUENCE: int = 32
+TOO_BIG_SEQUENCE: int = int(10e6)
 
-UTF8_MAXIMAL_ALLOCATION = 1112064  # type: int
+UTF8_MAXIMAL_ALLOCATION: int = 1112064
 
-UNICODE_RANGES_COMBINED = {
+UNICODE_RANGES_COMBINED: Dict[str, range] = {
     "Control character": range(31 + 1),
     "Basic Latin": range(32, 127 + 1),
     "Latin-1 Supplement": range(128, 255 + 1),
@@ -311,10 +305,10 @@ UNICODE_RANGES_COMBINED = {
     "CJK Compatibility Ideographs Supplement": range(194560, 195103 + 1),
     "Tags": range(917504, 917631 + 1),
     "Variation Selectors Supplement": range(917760, 917999 + 1),
-}  # type: Dict[str, range]
+}
 
 
-UNICODE_SECONDARY_RANGE_KEYWORD = [
+UNICODE_SECONDARY_RANGE_KEYWORD: List[str] = [
     "Supplement",
     "Extended",
     "Extensions",
@@ -330,25 +324,25 @@ UNICODE_SECONDARY_RANGE_KEYWORD = [
     "Shapes",
     "Supplemental",
     "Tags",
-]  # type: List[str]
+]
 
 RE_POSSIBLE_ENCODING_INDICATION = re_compile(
     r"(?:(?:encoding)|(?:charset)|(?:coding))(?:[\:= ]{1,10})(?:[\"\']?)([a-zA-Z0-9\-_]+)(?:[\"\']?)",
     IGNORECASE,
 )
 
-IANA_SUPPORTED = sorted(
+IANA_SUPPORTED: List[str] = sorted(
     filter(
         lambda x: x.endswith("_codec") is False
         and x not in {"rot_13", "tactis", "mbcs"},
         list(set(aliases.values())),
     )
-)  # type: List[str]
+)
 
-IANA_SUPPORTED_COUNT = len(IANA_SUPPORTED)  # type: int
+IANA_SUPPORTED_COUNT: int = len(IANA_SUPPORTED)
 
 # pre-computed code page that are similar using the function cp_similarity.
-IANA_SUPPORTED_SIMILAR = {
+IANA_SUPPORTED_SIMILAR: Dict[str, List[str]] = {
     "cp037": ["cp1026", "cp1140", "cp273", "cp500"],
     "cp1026": ["cp037", "cp1140", "cp273", "cp500"],
     "cp1125": ["cp866"],
@@ -434,10 +428,10 @@ IANA_SUPPORTED_SIMILAR = {
     "mac_turkish": ["mac_iceland", "mac_roman"],
     "ptcp154": ["cp1251", "kz1048"],
     "tis_620": ["iso8859_11"],
-}  # type: Dict[str, List[str]]
+}
 
 
-CHARDET_CORRESPONDENCE = {
+CHARDET_CORRESPONDENCE: Dict[str, str] = {
     "iso2022_kr": "ISO-2022-KR",
     "iso2022_jp": "ISO-2022-JP",
     "euc_kr": "EUC-KR",
@@ -470,10 +464,10 @@ CHARDET_CORRESPONDENCE = {
     "cp1256": "windows-1256",
     "cp1254": "Windows-1254",
     "cp949": "CP949",
-}  # type: Dict[str, str]
+}
 
 
-COMMON_SAFE_ASCII_CHARACTERS = {
+COMMON_SAFE_ASCII_CHARACTERS: Set[str] = {
     "<",
     ">",
     "=",
@@ -489,15 +483,15 @@ COMMON_SAFE_ASCII_CHARACTERS = {
     "|",
     '"',
     "-",
-}  # type: Set[str]
+}
 
 
-KO_NAMES = {"johab", "cp949", "euc_kr"}  # type: Set[str]
-ZH_NAMES = {"big5", "cp950", "big5hkscs", "hz"}  # type: Set[str]
+KO_NAMES: Set[str] = {"johab", "cp949", "euc_kr"}
+ZH_NAMES: Set[str] = {"big5", "cp950", "big5hkscs", "hz"}
 
 NOT_PRINTABLE_PATTERN = re_compile(r"[0-9\W\n\r\t]+")
 
-LANGUAGE_SUPPORTED_COUNT = len(FREQUENCIES)  # type: int
+LANGUAGE_SUPPORTED_COUNT: int = len(FREQUENCIES)
 
 # Logging LEVEL bellow DEBUG
-TRACE = 5  # type: int
+TRACE: int = 5
diff --git a/lib/charset_normalizer/md.py b/lib/charset_normalizer/md.py
index f3d6505c..31808af8 100644
--- a/lib/charset_normalizer/md.py
+++ b/lib/charset_normalizer/md.py
@@ -16,6 +16,7 @@ from .utils import (
     is_separator,
     is_symbol,
     is_thai,
+    is_unprintable,
     remove_accent,
     unicode_range,
 )
@@ -57,12 +58,12 @@ class MessDetectorPlugin:
 
 class TooManySymbolOrPunctuationPlugin(MessDetectorPlugin):
     def __init__(self) -> None:
-        self._punctuation_count = 0  # type: int
-        self._symbol_count = 0  # type: int
-        self._character_count = 0  # type: int
+        self._punctuation_count: int = 0
+        self._symbol_count: int = 0
+        self._character_count: int = 0
 
-        self._last_printable_char = None  # type: Optional[str]
-        self._frenzy_symbol_in_word = False  # type: bool
+        self._last_printable_char: Optional[str] = None
+        self._frenzy_symbol_in_word: bool = False
 
     def eligible(self, character: str) -> bool:
         return character.isprintable()
@@ -95,17 +96,17 @@ class TooManySymbolOrPunctuationPlugin(MessDetectorPlugin):
         if self._character_count == 0:
             return 0.0
 
-        ratio_of_punctuation = (
+        ratio_of_punctuation: float = (
             self._punctuation_count + self._symbol_count
-        ) / self._character_count  # type: float
+        ) / self._character_count
 
         return ratio_of_punctuation if ratio_of_punctuation >= 0.3 else 0.0
 
 
 class TooManyAccentuatedPlugin(MessDetectorPlugin):
     def __init__(self) -> None:
-        self._character_count = 0  # type: int
-        self._accentuated_count = 0  # type: int
+        self._character_count: int = 0
+        self._accentuated_count: int = 0
 
     def eligible(self, character: str) -> bool:
         return character.isalpha()
@@ -124,26 +125,20 @@ class TooManyAccentuatedPlugin(MessDetectorPlugin):
     def ratio(self) -> float:
         if self._character_count == 0:
             return 0.0
-        ratio_of_accentuation = (
-            self._accentuated_count / self._character_count
-        )  # type: float
+        ratio_of_accentuation: float = self._accentuated_count / self._character_count
         return ratio_of_accentuation if ratio_of_accentuation >= 0.35 else 0.0
 
 
 class UnprintablePlugin(MessDetectorPlugin):
     def __init__(self) -> None:
-        self._unprintable_count = 0  # type: int
-        self._character_count = 0  # type: int
+        self._unprintable_count: int = 0
+        self._character_count: int = 0
 
     def eligible(self, character: str) -> bool:
         return True
 
     def feed(self, character: str) -> None:
-        if (
-            character.isspace() is False  # includes \n \t \r \v
-            and character.isprintable() is False
-            and character != "\x1A"  # Why? Its the ASCII substitute character.
-        ):
+        if is_unprintable(character):
             self._unprintable_count += 1
         self._character_count += 1
 
@@ -160,10 +155,10 @@ class UnprintablePlugin(MessDetectorPlugin):
 
 class SuspiciousDuplicateAccentPlugin(MessDetectorPlugin):
     def __init__(self) -> None:
-        self._successive_count = 0  # type: int
-        self._character_count = 0  # type: int
+        self._successive_count: int = 0
+        self._character_count: int = 0
 
-        self._last_latin_character = None  # type: Optional[str]
+        self._last_latin_character: Optional[str] = None
 
     def eligible(self, character: str) -> bool:
         return character.isalpha() and is_latin(character)
@@ -197,9 +192,9 @@ class SuspiciousDuplicateAccentPlugin(MessDetectorPlugin):
 
 class SuspiciousRange(MessDetectorPlugin):
     def __init__(self) -> None:
-        self._suspicious_successive_range_count = 0  # type: int
-        self._character_count = 0  # type: int
-        self._last_printable_seen = None  # type: Optional[str]
+        self._suspicious_successive_range_count: int = 0
+        self._character_count: int = 0
+        self._last_printable_seen: Optional[str] = None
 
     def eligible(self, character: str) -> bool:
         return character.isprintable()
@@ -219,10 +214,8 @@ class SuspiciousRange(MessDetectorPlugin):
             self._last_printable_seen = character
             return
 
-        unicode_range_a = unicode_range(
-            self._last_printable_seen
-        )  # type: Optional[str]
-        unicode_range_b = unicode_range(character)  # type: Optional[str]
+        unicode_range_a: Optional[str] = unicode_range(self._last_printable_seen)
+        unicode_range_b: Optional[str] = unicode_range(character)
 
         if is_suspiciously_successive_range(unicode_range_a, unicode_range_b):
             self._suspicious_successive_range_count += 1
@@ -239,9 +232,9 @@ class SuspiciousRange(MessDetectorPlugin):
         if self._character_count == 0:
             return 0.0
 
-        ratio_of_suspicious_range_usage = (
+        ratio_of_suspicious_range_usage: float = (
             self._suspicious_successive_range_count * 2
-        ) / self._character_count  # type: float
+        ) / self._character_count
 
         if ratio_of_suspicious_range_usage < 0.1:
             return 0.0
@@ -251,25 +244,25 @@ class SuspiciousRange(MessDetectorPlugin):
 
 class SuperWeirdWordPlugin(MessDetectorPlugin):
     def __init__(self) -> None:
-        self._word_count = 0  # type: int
-        self._bad_word_count = 0  # type: int
-        self._foreign_long_count = 0  # type: int
+        self._word_count: int = 0
+        self._bad_word_count: int = 0
+        self._foreign_long_count: int = 0
 
-        self._is_current_word_bad = False  # type: bool
-        self._foreign_long_watch = False  # type: bool
+        self._is_current_word_bad: bool = False
+        self._foreign_long_watch: bool = False
 
-        self._character_count = 0  # type: int
-        self._bad_character_count = 0  # type: int
+        self._character_count: int = 0
+        self._bad_character_count: int = 0
 
-        self._buffer = ""  # type: str
-        self._buffer_accent_count = 0  # type: int
+        self._buffer: str = ""
+        self._buffer_accent_count: int = 0
 
     def eligible(self, character: str) -> bool:
         return True
 
     def feed(self, character: str) -> None:
         if character.isalpha():
-            self._buffer = "".join([self._buffer, character])
+            self._buffer += character
             if is_accentuated(character):
                 self._buffer_accent_count += 1
             if (
@@ -289,7 +282,7 @@ class SuperWeirdWordPlugin(MessDetectorPlugin):
             character.isspace() or is_punctuation(character) or is_separator(character)
         ) and self._buffer:
             self._word_count += 1
-            buffer_length = len(self._buffer)  # type: int
+            buffer_length: int = len(self._buffer)
 
             self._character_count += buffer_length
 
@@ -346,8 +339,8 @@ class CjkInvalidStopPlugin(MessDetectorPlugin):
     """
 
     def __init__(self) -> None:
-        self._wrong_stop_count = 0  # type: int
-        self._cjk_character_count = 0  # type: int
+        self._wrong_stop_count: int = 0
+        self._cjk_character_count: int = 0
 
     def eligible(self, character: str) -> bool:
         return True
@@ -372,17 +365,17 @@ class CjkInvalidStopPlugin(MessDetectorPlugin):
 
 class ArchaicUpperLowerPlugin(MessDetectorPlugin):
     def __init__(self) -> None:
-        self._buf = False  # type: bool
+        self._buf: bool = False
 
-        self._character_count_since_last_sep = 0  # type: int
+        self._character_count_since_last_sep: int = 0
 
-        self._successive_upper_lower_count = 0  # type: int
-        self._successive_upper_lower_count_final = 0  # type: int
+        self._successive_upper_lower_count: int = 0
+        self._successive_upper_lower_count_final: int = 0
 
-        self._character_count = 0  # type: int
+        self._character_count: int = 0
 
-        self._last_alpha_seen = None  # type: Optional[str]
-        self._current_ascii_only = True  # type: bool
+        self._last_alpha_seen: Optional[str] = None
+        self._current_ascii_only: bool = True
 
     def eligible(self, character: str) -> bool:
         return True
@@ -446,6 +439,7 @@ class ArchaicUpperLowerPlugin(MessDetectorPlugin):
         return self._successive_upper_lower_count_final / self._character_count
 
 
+@lru_cache(maxsize=1024)
 def is_suspiciously_successive_range(
     unicode_range_a: Optional[str], unicode_range_b: Optional[str]
 ) -> bool:
@@ -524,16 +518,16 @@ def mess_ratio(
     Compute a mess ratio given a decoded bytes sequence. The maximum threshold does stop the computation earlier.
     """
 
-    detectors = [
+    detectors: List[MessDetectorPlugin] = [
         md_class() for md_class in MessDetectorPlugin.__subclasses__()
-    ]  # type: List[MessDetectorPlugin]
+    ]
 
-    length = len(decoded_sequence) + 1  # type: int
+    length: int = len(decoded_sequence) + 1
 
-    mean_mess_ratio = 0.0  # type: float
+    mean_mess_ratio: float = 0.0
 
     if length < 512:
-        intermediary_mean_mess_ratio_calc = 32  # type: int
+        intermediary_mean_mess_ratio_calc: int = 32
     elif length <= 1024:
         intermediary_mean_mess_ratio_calc = 64
     else:
diff --git a/lib/charset_normalizer/models.py b/lib/charset_normalizer/models.py
index c38da31f..ccb0d475 100644
--- a/lib/charset_normalizer/models.py
+++ b/lib/charset_normalizer/models.py
@@ -4,7 +4,16 @@ from encodings.aliases import aliases
 from hashlib import sha256
 from json import dumps
 from re import sub
-from typing import Any, Dict, Iterator, List, Optional, Tuple, Union
+from typing import (
+    Any,
+    Counter as TypeCounter,
+    Dict,
+    Iterator,
+    List,
+    Optional,
+    Tuple,
+    Union,
+)
 
 from .constant import NOT_PRINTABLE_PATTERN, TOO_BIG_SEQUENCE
 from .md import mess_ratio
@@ -21,21 +30,21 @@ class CharsetMatch:
         languages: "CoherenceMatches",
         decoded_payload: Optional[str] = None,
     ):
-        self._payload = payload  # type: bytes
+        self._payload: bytes = payload
 
-        self._encoding = guessed_encoding  # type: str
-        self._mean_mess_ratio = mean_mess_ratio  # type: float
-        self._languages = languages  # type: CoherenceMatches
-        self._has_sig_or_bom = has_sig_or_bom  # type: bool
-        self._unicode_ranges = None  # type: Optional[List[str]]
+        self._encoding: str = guessed_encoding
+        self._mean_mess_ratio: float = mean_mess_ratio
+        self._languages: CoherenceMatches = languages
+        self._has_sig_or_bom: bool = has_sig_or_bom
+        self._unicode_ranges: Optional[List[str]] = None
 
-        self._leaves = []  # type: List[CharsetMatch]
-        self._mean_coherence_ratio = 0.0  # type: float
+        self._leaves: List[CharsetMatch] = []
+        self._mean_coherence_ratio: float = 0.0
 
-        self._output_payload = None  # type: Optional[bytes]
-        self._output_encoding = None  # type: Optional[str]
+        self._output_payload: Optional[bytes] = None
+        self._output_encoding: Optional[str] = None
 
-        self._string = decoded_payload  # type: Optional[str]
+        self._string: Optional[str] = decoded_payload
 
     def __eq__(self, other: object) -> bool:
         if not isinstance(other, CharsetMatch):
@@ -53,8 +62,8 @@ class CharsetMatch:
         if not isinstance(other, CharsetMatch):
             raise ValueError
 
-        chaos_difference = abs(self.chaos - other.chaos)  # type: float
-        coherence_difference = abs(self.coherence - other.coherence)  # type: float
+        chaos_difference: float = abs(self.chaos - other.chaos)
+        coherence_difference: float = abs(self.coherence - other.coherence)
 
         # Bellow 1% difference --> Use Coherence
         if chaos_difference < 0.01 and coherence_difference > 0.02:
@@ -95,7 +104,7 @@ class CharsetMatch:
         return 0.0
 
     @property
-    def w_counter(self) -> Counter:
+    def w_counter(self) -> TypeCounter[str]:
         """
         Word counter instance on decoded text.
         Notice: Will be removed in 3.0
@@ -137,7 +146,7 @@ class CharsetMatch:
         """
         Encoding name are known by many name, using this could help when searching for IBM855 when it's listed as CP855.
         """
-        also_known_as = []  # type: List[str]
+        also_known_as: List[str] = []
         for u, p in aliases.items():
             if self.encoding == u:
                 also_known_as.append(p)
@@ -227,9 +236,9 @@ class CharsetMatch:
         if self._unicode_ranges is not None:
             return self._unicode_ranges
         # list detected ranges
-        detected_ranges = [
+        detected_ranges: List[Optional[str]] = [
             unicode_range(char) for char in str(self)
-        ]  # type: List[Optional[str]]
+        ]
         # filter and sort
         self._unicode_ranges = sorted(list({r for r in detected_ranges if r}))
         return self._unicode_ranges
@@ -280,8 +289,8 @@ class CharsetMatches:
     Act like a list(iterable) but does not implements all related methods.
     """
 
-    def __init__(self, results: List[CharsetMatch] = None):
-        self._results = sorted(results) if results else []  # type: List[CharsetMatch]
+    def __init__(self, results: Optional[List[CharsetMatch]] = None):
+        self._results: List[CharsetMatch] = sorted(results) if results else []
 
     def __iter__(self) -> Iterator[CharsetMatch]:
         yield from self._results
@@ -360,17 +369,17 @@ class CliDetectionResult:
         unicode_path: Optional[str],
         is_preferred: bool,
     ):
-        self.path = path  # type: str
-        self.unicode_path = unicode_path  # type: Optional[str]
-        self.encoding = encoding  # type: Optional[str]
-        self.encoding_aliases = encoding_aliases  # type: List[str]
-        self.alternative_encodings = alternative_encodings  # type: List[str]
-        self.language = language  # type: str
-        self.alphabets = alphabets  # type: List[str]
-        self.has_sig_or_bom = has_sig_or_bom  # type: bool
-        self.chaos = chaos  # type: float
-        self.coherence = coherence  # type: float
-        self.is_preferred = is_preferred  # type: bool
+        self.path: str = path
+        self.unicode_path: Optional[str] = unicode_path
+        self.encoding: Optional[str] = encoding
+        self.encoding_aliases: List[str] = encoding_aliases
+        self.alternative_encodings: List[str] = alternative_encodings
+        self.language: str = language
+        self.alphabets: List[str] = alphabets
+        self.has_sig_or_bom: bool = has_sig_or_bom
+        self.chaos: float = chaos
+        self.coherence: float = coherence
+        self.is_preferred: bool = is_preferred
 
     @property
     def __dict__(self) -> Dict[str, Any]:  # type: ignore
diff --git a/lib/charset_normalizer/utils.py b/lib/charset_normalizer/utils.py
index dcb14dfe..859f212b 100644
--- a/lib/charset_normalizer/utils.py
+++ b/lib/charset_normalizer/utils.py
@@ -1,4 +1,6 @@
 try:
+    # WARNING: unicodedata2 support is going to be removed in 3.0
+    # Python is quickly catching up.
     import unicodedata2 as unicodedata
 except ImportError:
     import unicodedata  # type: ignore[no-redef]
@@ -9,9 +11,9 @@ from codecs import IncrementalDecoder
 from encodings.aliases import aliases
 from functools import lru_cache
 from re import findall
-from typing import List, Optional, Set, Tuple, Union
+from typing import Generator, List, Optional, Set, Tuple, Union
 
-from _multibytecodec import MultibyteIncrementalDecoder  # type: ignore
+from _multibytecodec import MultibyteIncrementalDecoder
 
 from .constant import (
     ENCODING_MARKS,
@@ -26,7 +28,7 @@ from .constant import (
 @lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION)
 def is_accentuated(character: str) -> bool:
     try:
-        description = unicodedata.name(character)  # type: str
+        description: str = unicodedata.name(character)
     except ValueError:
         return False
     return (
@@ -41,11 +43,11 @@ def is_accentuated(character: str) -> bool:
 
 @lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION)
 def remove_accent(character: str) -> str:
-    decomposed = unicodedata.decomposition(character)  # type: str
+    decomposed: str = unicodedata.decomposition(character)
     if not decomposed:
         return character
 
-    codes = decomposed.split(" ")  # type: List[str]
+    codes: List[str] = decomposed.split(" ")
 
     return chr(int(codes[0], 16))
 
@@ -55,7 +57,7 @@ def unicode_range(character: str) -> Optional[str]:
     """
     Retrieve the Unicode range official name from a single character.
     """
-    character_ord = ord(character)  # type: int
+    character_ord: int = ord(character)
 
     for range_name, ord_range in UNICODE_RANGES_COMBINED.items():
         if character_ord in ord_range:
@@ -67,12 +69,13 @@ def unicode_range(character: str) -> Optional[str]:
 @lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION)
 def is_latin(character: str) -> bool:
     try:
-        description = unicodedata.name(character)  # type: str
+        description: str = unicodedata.name(character)
     except ValueError:
         return False
     return "LATIN" in description
 
 
+@lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION)
 def is_ascii(character: str) -> bool:
     try:
         character.encode("ascii")
@@ -83,12 +86,12 @@ def is_ascii(character: str) -> bool:
 
 @lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION)
 def is_punctuation(character: str) -> bool:
-    character_category = unicodedata.category(character)  # type: str
+    character_category: str = unicodedata.category(character)
 
     if "P" in character_category:
         return True
 
-    character_range = unicode_range(character)  # type: Optional[str]
+    character_range: Optional[str] = unicode_range(character)
 
     if character_range is None:
         return False
@@ -98,12 +101,12 @@ def is_punctuation(character: str) -> bool:
 
 @lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION)
 def is_symbol(character: str) -> bool:
-    character_category = unicodedata.category(character)  # type: str
+    character_category: str = unicodedata.category(character)
 
     if "S" in character_category or "N" in character_category:
         return True
 
-    character_range = unicode_range(character)  # type: Optional[str]
+    character_range: Optional[str] = unicode_range(character)
 
     if character_range is None:
         return False
@@ -113,7 +116,7 @@ def is_symbol(character: str) -> bool:
 
 @lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION)
 def is_emoticon(character: str) -> bool:
-    character_range = unicode_range(character)  # type: Optional[str]
+    character_range: Optional[str] = unicode_range(character)
 
     if character_range is None:
         return False
@@ -126,7 +129,7 @@ def is_separator(character: str) -> bool:
     if character.isspace() or character in {"｜", "+", ",", ";", "<", ">"}:
         return True
 
-    character_category = unicodedata.category(character)  # type: str
+    character_category: str = unicodedata.category(character)
 
     return "Z" in character_category
 
@@ -137,7 +140,7 @@ def is_case_variable(character: str) -> bool:
 
 
 def is_private_use_only(character: str) -> bool:
-    character_category = unicodedata.category(character)  # type: str
+    character_category: str = unicodedata.category(character)
 
     return character_category == "Co"
 
@@ -197,6 +200,17 @@ def is_unicode_range_secondary(range_name: str) -> bool:
     return any(keyword in range_name for keyword in UNICODE_SECONDARY_RANGE_KEYWORD)
 
 
+@lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION)
+def is_unprintable(character: str) -> bool:
+    return (
+        character.isspace() is False  # includes \n \t \r \v
+        and character.isprintable() is False
+        and character != "\x1A"  # Why? Its the ASCII substitute character.
+        and character != "\ufeff"  # bug discovered in Python,
+        # Zero Width No-Break Space located in 	Arabic Presentation Forms-B, Unicode 1.1 not acknowledged as space.
+    )
+
+
 def any_specified_encoding(sequence: bytes, search_zone: int = 4096) -> Optional[str]:
     """
     Extract using ASCII-only decoder any specified encoding in the first n-bytes.
@@ -204,12 +218,12 @@ def any_specified_encoding(sequence: bytes, search_zone: int = 4096) -> Optional
     if not isinstance(sequence, bytes):
         raise TypeError
 
-    seq_len = len(sequence)  # type: int
+    seq_len: int = len(sequence)
 
-    results = findall(
+    results: List[str] = findall(
         RE_POSSIBLE_ENCODING_INDICATION,
         sequence[: min(seq_len, search_zone)].decode("ascii", errors="ignore"),
-    )  # type: List[str]
+    )
 
     if len(results) == 0:
         return None
@@ -217,6 +231,9 @@ def any_specified_encoding(sequence: bytes, search_zone: int = 4096) -> Optional
     for specified_encoding in results:
         specified_encoding = specified_encoding.lower().replace("-", "_")
 
+        encoding_alias: str
+        encoding_iana: str
+
         for encoding_alias, encoding_iana in aliases.items():
             if encoding_alias == specified_encoding:
                 return encoding_iana
@@ -242,7 +259,7 @@ def is_multi_byte_encoding(name: str) -> bool:
         "utf_32_be",
         "utf_7",
     } or issubclass(
-        importlib.import_module("encodings.{}".format(name)).IncrementalDecoder,  # type: ignore
+        importlib.import_module("encodings.{}".format(name)).IncrementalDecoder,
         MultibyteIncrementalDecoder,
     )
 
@@ -253,7 +270,7 @@ def identify_sig_or_bom(sequence: bytes) -> Tuple[Optional[str], bytes]:
     """
 
     for iana_encoding in ENCODING_MARKS:
-        marks = ENCODING_MARKS[iana_encoding]  # type: Union[bytes, List[bytes]]
+        marks: Union[bytes, List[bytes]] = ENCODING_MARKS[iana_encoding]
 
         if isinstance(marks, bytes):
             marks = [marks]
@@ -272,6 +289,9 @@ def should_strip_sig_or_bom(iana_encoding: str) -> bool:
 def iana_name(cp_name: str, strict: bool = True) -> str:
     cp_name = cp_name.lower().replace("-", "_")
 
+    encoding_alias: str
+    encoding_iana: str
+
     for encoding_alias, encoding_iana in aliases.items():
         if cp_name in [encoding_alias, encoding_iana]:
             return encoding_iana
@@ -283,10 +303,10 @@ def iana_name(cp_name: str, strict: bool = True) -> str:
 
 
 def range_scan(decoded_sequence: str) -> List[str]:
-    ranges = set()  # type: Set[str]
+    ranges: Set[str] = set()
 
     for character in decoded_sequence:
-        character_range = unicode_range(character)  # type: Optional[str]
+        character_range: Optional[str] = unicode_range(character)
 
         if character_range is None:
             continue
@@ -301,16 +321,20 @@ def cp_similarity(iana_name_a: str, iana_name_b: str) -> float:
     if is_multi_byte_encoding(iana_name_a) or is_multi_byte_encoding(iana_name_b):
         return 0.0
 
-    decoder_a = importlib.import_module("encodings.{}".format(iana_name_a)).IncrementalDecoder  # type: ignore
-    decoder_b = importlib.import_module("encodings.{}".format(iana_name_b)).IncrementalDecoder  # type: ignore
+    decoder_a = importlib.import_module(
+        "encodings.{}".format(iana_name_a)
+    ).IncrementalDecoder
+    decoder_b = importlib.import_module(
+        "encodings.{}".format(iana_name_b)
+    ).IncrementalDecoder
 
-    id_a = decoder_a(errors="ignore")  # type: IncrementalDecoder
-    id_b = decoder_b(errors="ignore")  # type: IncrementalDecoder
+    id_a: IncrementalDecoder = decoder_a(errors="ignore")
+    id_b: IncrementalDecoder = decoder_b(errors="ignore")
 
-    character_match_count = 0  # type: int
+    character_match_count: int = 0
 
     for i in range(255):
-        to_be_decoded = bytes([i])  # type: bytes
+        to_be_decoded: bytes = bytes([i])
         if id_a.decode(to_be_decoded) == id_b.decode(to_be_decoded):
             character_match_count += 1
 
@@ -340,3 +364,61 @@ def set_logging_handler(
     handler = logging.StreamHandler()
     handler.setFormatter(logging.Formatter(format_string))
     logger.addHandler(handler)
+
+
+def cut_sequence_chunks(
+    sequences: bytes,
+    encoding_iana: str,
+    offsets: range,
+    chunk_size: int,
+    bom_or_sig_available: bool,
+    strip_sig_or_bom: bool,
+    sig_payload: bytes,
+    is_multi_byte_decoder: bool,
+    decoded_payload: Optional[str] = None,
+) -> Generator[str, None, None]:
+
+    if decoded_payload and is_multi_byte_decoder is False:
+        for i in offsets:
+            chunk = decoded_payload[i : i + chunk_size]
+            if not chunk:
+                break
+            yield chunk
+    else:
+        for i in offsets:
+            chunk_end = i + chunk_size
+            if chunk_end > len(sequences) + 8:
+                continue
+
+            cut_sequence = sequences[i : i + chunk_size]
+
+            if bom_or_sig_available and strip_sig_or_bom is False:
+                cut_sequence = sig_payload + cut_sequence
+
+            chunk = cut_sequence.decode(
+                encoding_iana,
+                errors="ignore" if is_multi_byte_decoder else "strict",
+            )
+
+            # multi-byte bad cutting detector and adjustment
+            # not the cleanest way to perform that fix but clever enough for now.
+            if is_multi_byte_decoder and i > 0 and sequences[i] >= 0x80:
+
+                chunk_partial_size_chk: int = min(chunk_size, 16)
+
+                if (
+                    decoded_payload
+                    and chunk[:chunk_partial_size_chk] not in decoded_payload
+                ):
+                    for j in range(i, i - 4, -1):
+                        cut_sequence = sequences[j:chunk_end]
+
+                        if bom_or_sig_available and strip_sig_or_bom is False:
+                            cut_sequence = sig_payload + cut_sequence
+
+                        chunk = cut_sequence.decode(encoding_iana, errors="ignore")
+
+                        if chunk[:chunk_partial_size_chk] in decoded_payload:
+                            break
+
+            yield chunk
diff --git a/lib/charset_normalizer/version.py b/lib/charset_normalizer/version.py
index 77cfff25..64c0dbde 100644
--- a/lib/charset_normalizer/version.py
+++ b/lib/charset_normalizer/version.py
@@ -2,5 +2,5 @@
 Expose version
 """
 
-__version__ = "2.0.12"
+__version__ = "2.1.1"
 VERSION = __version__.split(".")
diff --git a/lib/idna/core.py b/lib/idna/core.py
index 55ab9678..4f300371 100644
--- a/lib/idna/core.py
+++ b/lib/idna/core.py
@@ -339,7 +339,10 @@ def uts46_remap(domain: str, std3_rules: bool = True, transitional: bool = False
 
 def encode(s: Union[str, bytes, bytearray], strict: bool = False, uts46: bool = False, std3_rules: bool = False, transitional: bool = False) -> bytes:
     if isinstance(s, (bytes, bytearray)):
-        s = s.decode('ascii')
+        try:
+            s = s.decode('ascii')
+        except UnicodeDecodeError:
+            raise IDNAError('should pass a unicode string to the function rather than a byte string.')
     if uts46:
         s = uts46_remap(s, std3_rules, transitional)
     trailing_dot = False
diff --git a/lib/idna/idnadata.py b/lib/idna/idnadata.py
index 1b5805d1..67db4625 100644
--- a/lib/idna/idnadata.py
+++ b/lib/idna/idnadata.py
@@ -1,6 +1,6 @@
 # This file is automatically generated by tools/idna-data
 
-__version__ = '14.0.0'
+__version__ = '15.0.0'
 scripts = {
     'Greek': (
         0x37000000374,
@@ -55,12 +55,13 @@ scripts = {
         0x16fe200016fe4,
         0x16ff000016ff2,
         0x200000002a6e0,
-        0x2a7000002b739,
+        0x2a7000002b73a,
         0x2b7400002b81e,
         0x2b8200002cea2,
         0x2ceb00002ebe1,
         0x2f8000002fa1e,
         0x300000003134b,
+        0x31350000323b0,
     ),
     'Hebrew': (
         0x591000005c8,
@@ -77,6 +78,7 @@ scripts = {
         0x304100003097,
         0x309d000030a0,
         0x1b0010001b120,
+        0x1b1320001b133,
         0x1b1500001b153,
         0x1f2000001f201,
     ),
@@ -93,6 +95,7 @@ scripts = {
         0x1affd0001afff,
         0x1b0000001b001,
         0x1b1200001b123,
+        0x1b1550001b156,
         0x1b1640001b168,
     ),
 }
@@ -1331,7 +1334,7 @@ codepoint_classes = {
         0xcdd00000cdf,
         0xce000000ce4,
         0xce600000cf0,
-        0xcf100000cf3,
+        0xcf100000cf4,
         0xd0000000d0d,
         0xd0e00000d11,
         0xd1200000d45,
@@ -1366,7 +1369,7 @@ codepoint_classes = {
         0xeb400000ebe,
         0xec000000ec5,
         0xec600000ec7,
-        0xec800000ece,
+        0xec800000ecf,
         0xed000000eda,
         0xede00000ee0,
         0xf0000000f01,
@@ -1859,7 +1862,7 @@ codepoint_classes = {
         0xab200000ab27,
         0xab280000ab2f,
         0xab300000ab5b,
-        0xab600000ab6a,
+        0xab600000ab69,
         0xabc00000abeb,
         0xabec0000abee,
         0xabf00000abfa,
@@ -1943,7 +1946,7 @@ codepoint_classes = {
         0x10e8000010eaa,
         0x10eab00010ead,
         0x10eb000010eb2,
-        0x10f0000010f1d,
+        0x10efd00010f1d,
         0x10f2700010f28,
         0x10f3000010f51,
         0x10f7000010f86,
@@ -1966,7 +1969,7 @@ codepoint_classes = {
         0x111dc000111dd,
         0x1120000011212,
         0x1121300011238,
-        0x1123e0001123f,
+        0x1123e00011242,
         0x1128000011287,
         0x1128800011289,
         0x1128a0001128e,
@@ -2047,11 +2050,16 @@ codepoint_classes = {
         0x11d9300011d99,
         0x11da000011daa,
         0x11ee000011ef7,
+        0x11f0000011f11,
+        0x11f1200011f3b,
+        0x11f3e00011f43,
+        0x11f5000011f5a,
         0x11fb000011fb1,
         0x120000001239a,
         0x1248000012544,
         0x12f9000012ff1,
-        0x130000001342f,
+        0x1300000013430,
+        0x1344000013456,
         0x1440000014647,
         0x1680000016a39,
         0x16a4000016a5f,
@@ -2079,7 +2087,9 @@ codepoint_classes = {
         0x1aff50001affc,
         0x1affd0001afff,
         0x1b0000001b123,
+        0x1b1320001b133,
         0x1b1500001b153,
+        0x1b1550001b156,
         0x1b1640001b168,
         0x1b1700001b2fc,
         0x1bc000001bc6b,
@@ -2096,17 +2106,21 @@ codepoint_classes = {
         0x1da9b0001daa0,
         0x1daa10001dab0,
         0x1df000001df1f,
+        0x1df250001df2b,
         0x1e0000001e007,
         0x1e0080001e019,
         0x1e01b0001e022,
         0x1e0230001e025,
         0x1e0260001e02b,
+        0x1e0300001e06e,
+        0x1e08f0001e090,
         0x1e1000001e12d,
         0x1e1300001e13e,
         0x1e1400001e14a,
         0x1e14e0001e14f,
         0x1e2900001e2af,
         0x1e2c00001e2fa,
+        0x1e4d00001e4fa,
         0x1e7e00001e7e7,
         0x1e7e80001e7ec,
         0x1e7ed0001e7ef,
@@ -2115,13 +2129,13 @@ codepoint_classes = {
         0x1e8d00001e8d7,
         0x1e9220001e94c,
         0x1e9500001e95a,
-        0x1fbf00001fbfa,
         0x200000002a6e0,
-        0x2a7000002b739,
+        0x2a7000002b73a,
         0x2b7400002b81e,
         0x2b8200002cea2,
         0x2ceb00002ebe1,
         0x300000003134b,
+        0x31350000323b0,
     ),
     'CONTEXTJ': (
         0x200c0000200e,
diff --git a/lib/idna/package_data.py b/lib/idna/package_data.py
index f5ea87c1..8501893b 100644
--- a/lib/idna/package_data.py
+++ b/lib/idna/package_data.py
@@ -1,2 +1,2 @@
-__version__ = '3.3'
+__version__ = '3.4'
 
diff --git a/lib/idna/uts46data.py b/lib/idna/uts46data.py
index 8f65705e..186796c1 100644
--- a/lib/idna/uts46data.py
+++ b/lib/idna/uts46data.py
@@ -7,7 +7,7 @@ from typing import List, Tuple, Union
 """IDNA Mapping Table from UTS46."""
 
 
-__version__ = '14.0.0'
+__version__ = '15.0.0'
 def _seg_0() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
     (0x0, '3'),
@@ -1300,7 +1300,7 @@ def _seg_12() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0xCE6, 'V'),
     (0xCF0, 'X'),
     (0xCF1, 'V'),
-    (0xCF3, 'X'),
+    (0xCF4, 'X'),
     (0xD00, 'V'),
     (0xD0D, 'X'),
     (0xD0E, 'V'),
@@ -1368,7 +1368,7 @@ def _seg_13() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0xEC6, 'V'),
     (0xEC7, 'X'),
     (0xEC8, 'V'),
-    (0xECE, 'X'),
+    (0xECF, 'X'),
     (0xED0, 'V'),
     (0xEDA, 'X'),
     (0xEDC, 'M', 'ຫນ'),
@@ -5917,7 +5917,7 @@ def _seg_56() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x10EAE, 'X'),
     (0x10EB0, 'V'),
     (0x10EB2, 'X'),
-    (0x10F00, 'V'),
+    (0x10EFD, 'V'),
     (0x10F28, 'X'),
     (0x10F30, 'V'),
     (0x10F5A, 'X'),
@@ -5956,7 +5956,7 @@ def _seg_57() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x11200, 'V'),
     (0x11212, 'X'),
     (0x11213, 'V'),
-    (0x1123F, 'X'),
+    (0x11242, 'X'),
     (0x11280, 'V'),
     (0x11287, 'X'),
     (0x11288, 'V'),
@@ -6097,6 +6097,8 @@ def _seg_58() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x11AA3, 'X'),
     (0x11AB0, 'V'),
     (0x11AF9, 'X'),
+    (0x11B00, 'V'),
+    (0x11B0A, 'X'),
     (0x11C00, 'V'),
     (0x11C09, 'X'),
     (0x11C0A, 'V'),
@@ -6139,13 +6141,19 @@ def _seg_58() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x11DAA, 'X'),
     (0x11EE0, 'V'),
     (0x11EF9, 'X'),
-    (0x11FB0, 'V'),
-    (0x11FB1, 'X'),
-    (0x11FC0, 'V'),
+    (0x11F00, 'V'),
     ]
 
 def _seg_59() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
+    (0x11F11, 'X'),
+    (0x11F12, 'V'),
+    (0x11F3B, 'X'),
+    (0x11F3E, 'V'),
+    (0x11F5A, 'X'),
+    (0x11FB0, 'V'),
+    (0x11FB1, 'X'),
+    (0x11FC0, 'V'),
     (0x11FF2, 'X'),
     (0x11FFF, 'V'),
     (0x1239A, 'X'),
@@ -6158,7 +6166,9 @@ def _seg_59() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x12F90, 'V'),
     (0x12FF3, 'X'),
     (0x13000, 'V'),
-    (0x1342F, 'X'),
+    (0x13430, 'X'),
+    (0x13440, 'V'),
+    (0x13456, 'X'),
     (0x14400, 'V'),
     (0x14647, 'X'),
     (0x16800, 'V'),
@@ -6236,6 +6246,10 @@ def _seg_59() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x18D00, 'V'),
     (0x18D09, 'X'),
     (0x1AFF0, 'V'),
+    ]
+
+def _seg_60() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x1AFF4, 'X'),
     (0x1AFF5, 'V'),
     (0x1AFFC, 'X'),
@@ -6243,13 +6257,13 @@ def _seg_59() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x1AFFF, 'X'),
     (0x1B000, 'V'),
     (0x1B123, 'X'),
+    (0x1B132, 'V'),
+    (0x1B133, 'X'),
     (0x1B150, 'V'),
     (0x1B153, 'X'),
+    (0x1B155, 'V'),
+    (0x1B156, 'X'),
     (0x1B164, 'V'),
-    ]
-
-def _seg_60() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x1B168, 'X'),
     (0x1B170, 'V'),
     (0x1B2FC, 'X'),
@@ -6295,6 +6309,8 @@ def _seg_60() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x1D1EB, 'X'),
     (0x1D200, 'V'),
     (0x1D246, 'X'),
+    (0x1D2C0, 'V'),
+    (0x1D2D4, 'X'),
     (0x1D2E0, 'V'),
     (0x1D2F4, 'X'),
     (0x1D300, 'V'),
@@ -6334,6 +6350,10 @@ def _seg_60() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x1D41E, 'M', 'e'),
     (0x1D41F, 'M', 'f'),
     (0x1D420, 'M', 'g'),
+    ]
+
+def _seg_61() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x1D421, 'M', 'h'),
     (0x1D422, 'M', 'i'),
     (0x1D423, 'M', 'j'),
@@ -6350,10 +6370,6 @@ def _seg_60() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x1D42E, 'M', 'u'),
     (0x1D42F, 'M', 'v'),
     (0x1D430, 'M', 'w'),
-    ]
-
-def _seg_61() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x1D431, 'M', 'x'),
     (0x1D432, 'M', 'y'),
     (0x1D433, 'M', 'z'),
@@ -6438,6 +6454,10 @@ def _seg_61() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x1D482, 'M', 'a'),
     (0x1D483, 'M', 'b'),
     (0x1D484, 'M', 'c'),
+    ]
+
+def _seg_62() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x1D485, 'M', 'd'),
     (0x1D486, 'M', 'e'),
     (0x1D487, 'M', 'f'),
@@ -6454,10 +6474,6 @@ def _seg_61() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x1D492, 'M', 'q'),
     (0x1D493, 'M', 'r'),
     (0x1D494, 'M', 's'),
-    ]
-
-def _seg_62() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x1D495, 'M', 't'),
     (0x1D496, 'M', 'u'),
     (0x1D497, 'M', 'v'),
@@ -6542,6 +6558,10 @@ def _seg_62() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x1D4E9, 'M', 'z'),
     (0x1D4EA, 'M', 'a'),
     (0x1D4EB, 'M', 'b'),
+    ]
+
+def _seg_63() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x1D4EC, 'M', 'c'),
     (0x1D4ED, 'M', 'd'),
     (0x1D4EE, 'M', 'e'),
@@ -6558,10 +6578,6 @@ def _seg_62() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x1D4F9, 'M', 'p'),
     (0x1D4FA, 'M', 'q'),
     (0x1D4FB, 'M', 'r'),
-    ]
-
-def _seg_63() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x1D4FC, 'M', 's'),
     (0x1D4FD, 'M', 't'),
     (0x1D4FE, 'M', 'u'),
@@ -6646,6 +6662,10 @@ def _seg_63() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x1D550, 'M', 'y'),
     (0x1D551, 'X'),
     (0x1D552, 'M', 'a'),
+    ]
+
+def _seg_64() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x1D553, 'M', 'b'),
     (0x1D554, 'M', 'c'),
     (0x1D555, 'M', 'd'),
@@ -6662,10 +6682,6 @@ def _seg_63() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x1D560, 'M', 'o'),
     (0x1D561, 'M', 'p'),
     (0x1D562, 'M', 'q'),
-    ]
-
-def _seg_64() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x1D563, 'M', 'r'),
     (0x1D564, 'M', 's'),
     (0x1D565, 'M', 't'),
@@ -6750,6 +6766,10 @@ def _seg_64() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x1D5B4, 'M', 'u'),
     (0x1D5B5, 'M', 'v'),
     (0x1D5B6, 'M', 'w'),
+    ]
+
+def _seg_65() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x1D5B7, 'M', 'x'),
     (0x1D5B8, 'M', 'y'),
     (0x1D5B9, 'M', 'z'),
@@ -6766,10 +6786,6 @@ def _seg_64() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x1D5C4, 'M', 'k'),
     (0x1D5C5, 'M', 'l'),
     (0x1D5C6, 'M', 'm'),
-    ]
-
-def _seg_65() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x1D5C7, 'M', 'n'),
     (0x1D5C8, 'M', 'o'),
     (0x1D5C9, 'M', 'p'),
@@ -6854,6 +6870,10 @@ def _seg_65() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x1D618, 'M', 'q'),
     (0x1D619, 'M', 'r'),
     (0x1D61A, 'M', 's'),
+    ]
+
+def _seg_66() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x1D61B, 'M', 't'),
     (0x1D61C, 'M', 'u'),
     (0x1D61D, 'M', 'v'),
@@ -6870,10 +6890,6 @@ def _seg_65() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x1D628, 'M', 'g'),
     (0x1D629, 'M', 'h'),
     (0x1D62A, 'M', 'i'),
-    ]
-
-def _seg_66() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x1D62B, 'M', 'j'),
     (0x1D62C, 'M', 'k'),
     (0x1D62D, 'M', 'l'),
@@ -6958,6 +6974,10 @@ def _seg_66() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x1D67C, 'M', 'm'),
     (0x1D67D, 'M', 'n'),
     (0x1D67E, 'M', 'o'),
+    ]
+
+def _seg_67() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x1D67F, 'M', 'p'),
     (0x1D680, 'M', 'q'),
     (0x1D681, 'M', 'r'),
@@ -6974,10 +6994,6 @@ def _seg_66() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x1D68C, 'M', 'c'),
     (0x1D68D, 'M', 'd'),
     (0x1D68E, 'M', 'e'),
-    ]
-
-def _seg_67() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x1D68F, 'M', 'f'),
     (0x1D690, 'M', 'g'),
     (0x1D691, 'M', 'h'),
@@ -7062,6 +7078,10 @@ def _seg_67() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x1D6E2, 'M', 'α'),
     (0x1D6E3, 'M', 'β'),
     (0x1D6E4, 'M', 'γ'),
+    ]
+
+def _seg_68() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x1D6E5, 'M', 'δ'),
     (0x1D6E6, 'M', 'ε'),
     (0x1D6E7, 'M', 'ζ'),
@@ -7078,10 +7098,6 @@ def _seg_67() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x1D6F2, 'M', 'ρ'),
     (0x1D6F3, 'M', 'θ'),
     (0x1D6F4, 'M', 'σ'),
-    ]
-
-def _seg_68() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x1D6F5, 'M', 'τ'),
     (0x1D6F6, 'M', 'υ'),
     (0x1D6F7, 'M', 'φ'),
@@ -7166,6 +7182,10 @@ def _seg_68() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x1D747, 'M', 'σ'),
     (0x1D749, 'M', 'τ'),
     (0x1D74A, 'M', 'υ'),
+    ]
+
+def _seg_69() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x1D74B, 'M', 'φ'),
     (0x1D74C, 'M', 'χ'),
     (0x1D74D, 'M', 'ψ'),
@@ -7182,10 +7202,6 @@ def _seg_68() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x1D758, 'M', 'γ'),
     (0x1D759, 'M', 'δ'),
     (0x1D75A, 'M', 'ε'),
-    ]
-
-def _seg_69() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x1D75B, 'M', 'ζ'),
     (0x1D75C, 'M', 'η'),
     (0x1D75D, 'M', 'θ'),
@@ -7270,6 +7286,10 @@ def _seg_69() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x1D7AD, 'M', 'δ'),
     (0x1D7AE, 'M', 'ε'),
     (0x1D7AF, 'M', 'ζ'),
+    ]
+
+def _seg_70() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x1D7B0, 'M', 'η'),
     (0x1D7B1, 'M', 'θ'),
     (0x1D7B2, 'M', 'ι'),
@@ -7286,10 +7306,6 @@ def _seg_69() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x1D7BE, 'M', 'υ'),
     (0x1D7BF, 'M', 'φ'),
     (0x1D7C0, 'M', 'χ'),
-    ]
-
-def _seg_70() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x1D7C1, 'M', 'ψ'),
     (0x1D7C2, 'M', 'ω'),
     (0x1D7C3, 'M', '∂'),
@@ -7359,6 +7375,8 @@ def _seg_70() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x1DAB0, 'X'),
     (0x1DF00, 'V'),
     (0x1DF1F, 'X'),
+    (0x1DF25, 'V'),
+    (0x1DF2B, 'X'),
     (0x1E000, 'V'),
     (0x1E007, 'X'),
     (0x1E008, 'V'),
@@ -7369,6 +7387,75 @@ def _seg_70() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x1E025, 'X'),
     (0x1E026, 'V'),
     (0x1E02B, 'X'),
+    (0x1E030, 'M', 'а'),
+    (0x1E031, 'M', 'б'),
+    (0x1E032, 'M', 'в'),
+    ]
+
+def _seg_71() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
+    (0x1E033, 'M', 'г'),
+    (0x1E034, 'M', 'д'),
+    (0x1E035, 'M', 'е'),
+    (0x1E036, 'M', 'ж'),
+    (0x1E037, 'M', 'з'),
+    (0x1E038, 'M', 'и'),
+    (0x1E039, 'M', 'к'),
+    (0x1E03A, 'M', 'л'),
+    (0x1E03B, 'M', 'м'),
+    (0x1E03C, 'M', 'о'),
+    (0x1E03D, 'M', 'п'),
+    (0x1E03E, 'M', 'р'),
+    (0x1E03F, 'M', 'с'),
+    (0x1E040, 'M', 'т'),
+    (0x1E041, 'M', 'у'),
+    (0x1E042, 'M', 'ф'),
+    (0x1E043, 'M', 'х'),
+    (0x1E044, 'M', 'ц'),
+    (0x1E045, 'M', 'ч'),
+    (0x1E046, 'M', 'ш'),
+    (0x1E047, 'M', 'ы'),
+    (0x1E048, 'M', 'э'),
+    (0x1E049, 'M', 'ю'),
+    (0x1E04A, 'M', 'ꚉ'),
+    (0x1E04B, 'M', 'ә'),
+    (0x1E04C, 'M', 'і'),
+    (0x1E04D, 'M', 'ј'),
+    (0x1E04E, 'M', 'ө'),
+    (0x1E04F, 'M', 'ү'),
+    (0x1E050, 'M', 'ӏ'),
+    (0x1E051, 'M', 'а'),
+    (0x1E052, 'M', 'б'),
+    (0x1E053, 'M', 'в'),
+    (0x1E054, 'M', 'г'),
+    (0x1E055, 'M', 'д'),
+    (0x1E056, 'M', 'е'),
+    (0x1E057, 'M', 'ж'),
+    (0x1E058, 'M', 'з'),
+    (0x1E059, 'M', 'и'),
+    (0x1E05A, 'M', 'к'),
+    (0x1E05B, 'M', 'л'),
+    (0x1E05C, 'M', 'о'),
+    (0x1E05D, 'M', 'п'),
+    (0x1E05E, 'M', 'с'),
+    (0x1E05F, 'M', 'у'),
+    (0x1E060, 'M', 'ф'),
+    (0x1E061, 'M', 'х'),
+    (0x1E062, 'M', 'ц'),
+    (0x1E063, 'M', 'ч'),
+    (0x1E064, 'M', 'ш'),
+    (0x1E065, 'M', 'ъ'),
+    (0x1E066, 'M', 'ы'),
+    (0x1E067, 'M', 'ґ'),
+    (0x1E068, 'M', 'і'),
+    (0x1E069, 'M', 'ѕ'),
+    (0x1E06A, 'M', 'џ'),
+    (0x1E06B, 'M', 'ҫ'),
+    (0x1E06C, 'M', 'ꙑ'),
+    (0x1E06D, 'M', 'ұ'),
+    (0x1E06E, 'X'),
+    (0x1E08F, 'V'),
+    (0x1E090, 'X'),
     (0x1E100, 'V'),
     (0x1E12D, 'X'),
     (0x1E130, 'V'),
@@ -7383,6 +7470,8 @@ def _seg_70() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x1E2FA, 'X'),
     (0x1E2FF, 'V'),
     (0x1E300, 'X'),
+    (0x1E4D0, 'V'),
+    (0x1E4FA, 'X'),
     (0x1E7E0, 'V'),
     (0x1E7E7, 'X'),
     (0x1E7E8, 'V'),
@@ -7390,10 +7479,6 @@ def _seg_70() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x1E7ED, 'V'),
     (0x1E7EF, 'X'),
     (0x1E7F0, 'V'),
-    ]
-
-def _seg_71() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x1E7FF, 'X'),
     (0x1E800, 'V'),
     (0x1E8C5, 'X'),
@@ -7409,6 +7494,10 @@ def _seg_71() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x1E907, 'M', '𞤩'),
     (0x1E908, 'M', '𞤪'),
     (0x1E909, 'M', '𞤫'),
+    ]
+
+def _seg_72() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x1E90A, 'M', '𞤬'),
     (0x1E90B, 'M', '𞤭'),
     (0x1E90C, 'M', '𞤮'),
@@ -7494,10 +7583,6 @@ def _seg_71() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x1EE31, 'M', 'ص'),
     (0x1EE32, 'M', 'ق'),
     (0x1EE33, 'X'),
-    ]
-
-def _seg_72() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x1EE34, 'M', 'ش'),
     (0x1EE35, 'M', 'ت'),
     (0x1EE36, 'M', 'ث'),
@@ -7513,6 +7598,10 @@ def _seg_72() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x1EE48, 'X'),
     (0x1EE49, 'M', 'ي'),
     (0x1EE4A, 'X'),
+    ]
+
+def _seg_73() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x1EE4B, 'M', 'ل'),
     (0x1EE4C, 'X'),
     (0x1EE4D, 'M', 'ن'),
@@ -7598,10 +7687,6 @@ def _seg_72() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x1EEA3, 'M', 'د'),
     (0x1EEA4, 'X'),
     (0x1EEA5, 'M', 'و'),
-    ]
-
-def _seg_73() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x1EEA6, 'M', 'ز'),
     (0x1EEA7, 'M', 'ح'),
     (0x1EEA8, 'M', 'ط'),
@@ -7617,6 +7702,10 @@ def _seg_73() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x1EEB2, 'M', 'ق'),
     (0x1EEB3, 'M', 'ر'),
     (0x1EEB4, 'M', 'ش'),
+    ]
+
+def _seg_74() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x1EEB5, 'M', 'ت'),
     (0x1EEB6, 'M', 'ث'),
     (0x1EEB7, 'M', 'خ'),
@@ -7702,10 +7791,6 @@ def _seg_73() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x1F141, 'M', 'r'),
     (0x1F142, 'M', 's'),
     (0x1F143, 'M', 't'),
-    ]
-
-def _seg_74() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x1F144, 'M', 'u'),
     (0x1F145, 'M', 'v'),
     (0x1F146, 'M', 'w'),
@@ -7721,6 +7806,10 @@ def _seg_74() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x1F150, 'V'),
     (0x1F16A, 'M', 'mc'),
     (0x1F16B, 'M', 'md'),
+    ]
+
+def _seg_75() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x1F16C, 'M', 'mr'),
     (0x1F16D, 'V'),
     (0x1F190, 'M', 'dj'),
@@ -7793,23 +7882,19 @@ def _seg_74() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x1F266, 'X'),
     (0x1F300, 'V'),
     (0x1F6D8, 'X'),
-    (0x1F6DD, 'V'),
+    (0x1F6DC, 'V'),
     (0x1F6ED, 'X'),
     (0x1F6F0, 'V'),
     (0x1F6FD, 'X'),
     (0x1F700, 'V'),
-    (0x1F774, 'X'),
-    (0x1F780, 'V'),
-    (0x1F7D9, 'X'),
+    (0x1F777, 'X'),
+    (0x1F77B, 'V'),
+    (0x1F7DA, 'X'),
     (0x1F7E0, 'V'),
     (0x1F7EC, 'X'),
     (0x1F7F0, 'V'),
     (0x1F7F1, 'X'),
     (0x1F800, 'V'),
-    ]
-
-def _seg_75() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x1F80C, 'X'),
     (0x1F810, 'V'),
     (0x1F848, 'X'),
@@ -7825,24 +7910,24 @@ def _seg_75() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x1FA54, 'X'),
     (0x1FA60, 'V'),
     (0x1FA6E, 'X'),
+    ]
+
+def _seg_76() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x1FA70, 'V'),
-    (0x1FA75, 'X'),
-    (0x1FA78, 'V'),
     (0x1FA7D, 'X'),
     (0x1FA80, 'V'),
-    (0x1FA87, 'X'),
+    (0x1FA89, 'X'),
     (0x1FA90, 'V'),
-    (0x1FAAD, 'X'),
-    (0x1FAB0, 'V'),
-    (0x1FABB, 'X'),
-    (0x1FAC0, 'V'),
+    (0x1FABE, 'X'),
+    (0x1FABF, 'V'),
     (0x1FAC6, 'X'),
-    (0x1FAD0, 'V'),
-    (0x1FADA, 'X'),
+    (0x1FACE, 'V'),
+    (0x1FADC, 'X'),
     (0x1FAE0, 'V'),
-    (0x1FAE8, 'X'),
+    (0x1FAE9, 'X'),
     (0x1FAF0, 'V'),
-    (0x1FAF7, 'X'),
+    (0x1FAF9, 'X'),
     (0x1FB00, 'V'),
     (0x1FB93, 'X'),
     (0x1FB94, 'V'),
@@ -7861,7 +7946,7 @@ def _seg_75() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x20000, 'V'),
     (0x2A6E0, 'X'),
     (0x2A700, 'V'),
-    (0x2B739, 'X'),
+    (0x2B73A, 'X'),
     (0x2B740, 'V'),
     (0x2B81E, 'X'),
     (0x2B820, 'V'),
@@ -7910,10 +7995,6 @@ def _seg_75() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x2F827, 'M', '勤'),
     (0x2F828, 'M', '勺'),
     (0x2F829, 'M', '包'),
-    ]
-
-def _seg_76() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x2F82A, 'M', '匆'),
     (0x2F82B, 'M', '北'),
     (0x2F82C, 'M', '卉'),
@@ -7933,6 +8014,10 @@ def _seg_76() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x2F83C, 'M', '咞'),
     (0x2F83D, 'M', '吸'),
     (0x2F83E, 'M', '呈'),
+    ]
+
+def _seg_77() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x2F83F, 'M', '周'),
     (0x2F840, 'M', '咢'),
     (0x2F841, 'M', '哶'),
@@ -8014,10 +8099,6 @@ def _seg_76() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x2F88F, 'M', '𪎒'),
     (0x2F890, 'M', '廾'),
     (0x2F891, 'M', '𢌱'),
-    ]
-
-def _seg_77() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x2F893, 'M', '舁'),
     (0x2F894, 'M', '弢'),
     (0x2F896, 'M', '㣇'),
@@ -8037,6 +8118,10 @@ def _seg_77() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x2F8A4, 'M', '𢛔'),
     (0x2F8A5, 'M', '惇'),
     (0x2F8A6, 'M', '慈'),
+    ]
+
+def _seg_78() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x2F8A7, 'M', '慌'),
     (0x2F8A8, 'M', '慎'),
     (0x2F8A9, 'M', '慌'),
@@ -8118,10 +8203,6 @@ def _seg_77() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x2F8F5, 'M', '殺'),
     (0x2F8F6, 'M', '殻'),
     (0x2F8F7, 'M', '𣪍'),
-    ]
-
-def _seg_78() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x2F8F8, 'M', '𡴋'),
     (0x2F8F9, 'M', '𣫺'),
     (0x2F8FA, 'M', '汎'),
@@ -8141,6 +8222,10 @@ def _seg_78() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x2F908, 'M', '港'),
     (0x2F909, 'M', '湮'),
     (0x2F90A, 'M', '㴳'),
+    ]
+
+def _seg_79() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x2F90B, 'M', '滋'),
     (0x2F90C, 'M', '滇'),
     (0x2F90D, 'M', '𣻑'),
@@ -8222,10 +8307,6 @@ def _seg_78() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x2F95B, 'M', '穏'),
     (0x2F95C, 'M', '𥥼'),
     (0x2F95D, 'M', '𥪧'),
-    ]
-
-def _seg_79() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x2F95F, 'X'),
     (0x2F960, 'M', '䈂'),
     (0x2F961, 'M', '𥮫'),
@@ -8245,6 +8326,10 @@ def _seg_79() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x2F96F, 'M', '縂'),
     (0x2F970, 'M', '繅'),
     (0x2F971, 'M', '䌴'),
+    ]
+
+def _seg_80() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x2F972, 'M', '𦈨'),
     (0x2F973, 'M', '𦉇'),
     (0x2F974, 'M', '䍙'),
@@ -8326,10 +8411,6 @@ def _seg_79() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x2F9C0, 'M', '蟡'),
     (0x2F9C1, 'M', '蠁'),
     (0x2F9C2, 'M', '䗹'),
-    ]
-
-def _seg_80() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x2F9C3, 'M', '衠'),
     (0x2F9C4, 'M', '衣'),
     (0x2F9C5, 'M', '𧙧'),
@@ -8349,6 +8430,10 @@ def _seg_80() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x2F9D3, 'M', '𧲨'),
     (0x2F9D4, 'M', '貫'),
     (0x2F9D5, 'M', '賁'),
+    ]
+
+def _seg_81() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x2F9D6, 'M', '贛'),
     (0x2F9D7, 'M', '起'),
     (0x2F9D8, 'M', '𧼯'),
@@ -8423,6 +8508,8 @@ def _seg_80() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x2FA1E, 'X'),
     (0x30000, 'V'),
     (0x3134B, 'X'),
+    (0x31350, 'V'),
+    (0x323B0, 'X'),
     (0xE0100, 'I'),
     (0xE01F0, 'X'),
     ]
@@ -8509,4 +8596,5 @@ uts46data = tuple(
     + _seg_78()
     + _seg_79()
     + _seg_80()
+    + _seg_81()
 )  # type: Tuple[Union[Tuple[int, str], Tuple[int, str, str]], ...]
diff --git a/lib/requests/__init__.py b/lib/requests/__init__.py
index 53a5b42a..7ac8e297 100644
--- a/lib/requests/__init__.py
+++ b/lib/requests/__init__.py
@@ -1,5 +1,3 @@
-# -*- coding: utf-8 -*-
-
 #   __
 #  /__)  _  _     _   _ _/   _
 # / (   (- (/ (/ (- _)  /  _)
@@ -40,8 +38,10 @@ is at <https://requests.readthedocs.io>.
 :license: Apache 2.0, see LICENSE for more details.
 """
 
-import urllib3
 import warnings
+
+import urllib3
+
 from .exceptions import RequestsDependencyWarning
 
 try:
@@ -54,13 +54,14 @@ try:
 except ImportError:
     chardet_version = None
 
+
 def check_compatibility(urllib3_version, chardet_version, charset_normalizer_version):
-    urllib3_version = urllib3_version.split('.')
-    assert urllib3_version != ['dev']  # Verify urllib3 isn't installed from git.
+    urllib3_version = urllib3_version.split(".")
+    assert urllib3_version != ["dev"]  # Verify urllib3 isn't installed from git.
 
     # Sometimes, urllib3 only reports its version as 16.1.
     if len(urllib3_version) == 2:
-        urllib3_version.append('0')
+        urllib3_version.append("0")
 
     # Check urllib3 for compatibility.
     major, minor, patch = urllib3_version  # noqa: F811
@@ -72,36 +73,46 @@ def check_compatibility(urllib3_version, chardet_version, charset_normalizer_ver
 
     # Check charset_normalizer for compatibility.
     if chardet_version:
-        major, minor, patch = chardet_version.split('.')[:3]
+        major, minor, patch = chardet_version.split(".")[:3]
         major, minor, patch = int(major), int(minor), int(patch)
-        # chardet_version >= 3.0.2, < 5.0.0
-        assert (3, 0, 2) <= (major, minor, patch) < (5, 0, 0)
+        # chardet_version >= 3.0.2, < 6.0.0
+        assert (3, 0, 2) <= (major, minor, patch) < (6, 0, 0)
     elif charset_normalizer_version:
-        major, minor, patch = charset_normalizer_version.split('.')[:3]
+        major, minor, patch = charset_normalizer_version.split(".")[:3]
         major, minor, patch = int(major), int(minor), int(patch)
         # charset_normalizer >= 2.0.0 < 3.0.0
         assert (2, 0, 0) <= (major, minor, patch) < (3, 0, 0)
     else:
         raise Exception("You need either charset_normalizer or chardet installed")
 
+
 def _check_cryptography(cryptography_version):
     # cryptography < 1.3.4
     try:
-        cryptography_version = list(map(int, cryptography_version.split('.')))
+        cryptography_version = list(map(int, cryptography_version.split(".")))
     except ValueError:
         return
 
     if cryptography_version < [1, 3, 4]:
-        warning = 'Old version of cryptography ({}) may cause slowdown.'.format(cryptography_version)
+        warning = "Old version of cryptography ({}) may cause slowdown.".format(
+            cryptography_version
+        )
         warnings.warn(warning, RequestsDependencyWarning)
 
+
 # Check imported dependencies for compatibility.
 try:
-    check_compatibility(urllib3.__version__, chardet_version, charset_normalizer_version)
+    check_compatibility(
+        urllib3.__version__, chardet_version, charset_normalizer_version
+    )
 except (AssertionError, ValueError):
-    warnings.warn("urllib3 ({}) or chardet ({})/charset_normalizer ({}) doesn't match a supported "
-                  "version!".format(urllib3.__version__, chardet_version, charset_normalizer_version),
-                  RequestsDependencyWarning)
+    warnings.warn(
+        "urllib3 ({}) or chardet ({})/charset_normalizer ({}) doesn't match a supported "
+        "version!".format(
+            urllib3.__version__, chardet_version, charset_normalizer_version
+        ),
+        RequestsDependencyWarning,
+    )
 
 # Attempt to enable urllib3's fallback for SNI support
 # if the standard library doesn't support SNI or the
@@ -114,39 +125,56 @@ try:
 
     if not getattr(ssl, "HAS_SNI", False):
         from urllib3.contrib import pyopenssl
+
         pyopenssl.inject_into_urllib3()
 
         # Check cryptography version
         from cryptography import __version__ as cryptography_version
+
         _check_cryptography(cryptography_version)
 except ImportError:
     pass
 
 # urllib3's DependencyWarnings should be silenced.
 from urllib3.exceptions import DependencyWarning
-warnings.simplefilter('ignore', DependencyWarning)
 
-from .__version__ import __title__, __description__, __url__, __version__
-from .__version__ import __build__, __author__, __author_email__, __license__
-from .__version__ import __copyright__, __cake__
-
-from . import utils
-from . import packages
-from .models import Request, Response, PreparedRequest
-from .api import request, get, head, post, patch, put, delete, options
-from .sessions import session, Session
-from .status_codes import codes
-from .exceptions import (
-    RequestException, Timeout, URLRequired,
-    TooManyRedirects, HTTPError, ConnectionError,
-    FileModeWarning, ConnectTimeout, ReadTimeout, JSONDecodeError
-)
+warnings.simplefilter("ignore", DependencyWarning)
 
 # Set default logging handler to avoid "No handler found" warnings.
 import logging
 from logging import NullHandler
 
+from . import packages, utils
+from .__version__ import (
+    __author__,
+    __author_email__,
+    __build__,
+    __cake__,
+    __copyright__,
+    __description__,
+    __license__,
+    __title__,
+    __url__,
+    __version__,
+)
+from .api import delete, get, head, options, patch, post, put, request
+from .exceptions import (
+    ConnectionError,
+    ConnectTimeout,
+    FileModeWarning,
+    HTTPError,
+    JSONDecodeError,
+    ReadTimeout,
+    RequestException,
+    Timeout,
+    TooManyRedirects,
+    URLRequired,
+)
+from .models import PreparedRequest, Request, Response
+from .sessions import Session, session
+from .status_codes import codes
+
 logging.getLogger(__name__).addHandler(NullHandler())
 
 # FileModeWarnings go off per the default.
-warnings.simplefilter('default', FileModeWarning, append=True)
+warnings.simplefilter("default", FileModeWarning, append=True)
diff --git a/lib/requests/__version__.py b/lib/requests/__version__.py
index e973b03b..e725ada6 100644
--- a/lib/requests/__version__.py
+++ b/lib/requests/__version__.py
@@ -2,13 +2,13 @@
 # |(  |-  |.| | | |-  `-.  |  `-.
 # ' ' `-' `-`.`-' `-' `-'  '  `-'
 
-__title__ = 'requests'
-__description__ = 'Python HTTP for Humans.'
-__url__ = 'https://requests.readthedocs.io'
-__version__ = '2.27.1'
-__build__ = 0x022701
-__author__ = 'Kenneth Reitz'
-__author_email__ = 'me@kennethreitz.org'
-__license__ = 'Apache 2.0'
-__copyright__ = 'Copyright 2022 Kenneth Reitz'
-__cake__ = u'\u2728 \U0001f370 \u2728'
+__title__ = "requests"
+__description__ = "Python HTTP for Humans."
+__url__ = "https://requests.readthedocs.io"
+__version__ = "2.28.1"
+__build__ = 0x022801
+__author__ = "Kenneth Reitz"
+__author_email__ = "me@kennethreitz.org"
+__license__ = "Apache 2.0"
+__copyright__ = "Copyright 2022 Kenneth Reitz"
+__cake__ = "\u2728 \U0001f370 \u2728"
diff --git a/lib/requests/_internal_utils.py b/lib/requests/_internal_utils.py
index 759d9a56..7dc9bc53 100644
--- a/lib/requests/_internal_utils.py
+++ b/lib/requests/_internal_utils.py
@@ -1,5 +1,3 @@
-# -*- coding: utf-8 -*-
-
 """
 requests._internal_utils
 ~~~~~~~~~~~~~~
@@ -7,11 +5,22 @@ requests._internal_utils
 Provides utility functions that are consumed internally by Requests
 which depend on extremely few external helpers (such as compat)
 """
+import re
 
-from .compat import is_py2, builtin_str, str
+from .compat import builtin_str
+
+_VALID_HEADER_NAME_RE_BYTE = re.compile(rb"^[^:\s][^:\r\n]*$")
+_VALID_HEADER_NAME_RE_STR = re.compile(r"^[^:\s][^:\r\n]*$")
+_VALID_HEADER_VALUE_RE_BYTE = re.compile(rb"^\S[^\r\n]*$|^$")
+_VALID_HEADER_VALUE_RE_STR = re.compile(r"^\S[^\r\n]*$|^$")
+
+HEADER_VALIDATORS = {
+    bytes: (_VALID_HEADER_NAME_RE_BYTE, _VALID_HEADER_VALUE_RE_BYTE),
+    str: (_VALID_HEADER_NAME_RE_STR, _VALID_HEADER_VALUE_RE_STR),
+}
 
 
-def to_native_string(string, encoding='ascii'):
+def to_native_string(string, encoding="ascii"):
     """Given a string object, regardless of type, returns a representation of
     that string in the native string type, encoding and decoding where
     necessary. This assumes ASCII unless told otherwise.
@@ -19,10 +28,7 @@ def to_native_string(string, encoding='ascii'):
     if isinstance(string, builtin_str):
         out = string
     else:
-        if is_py2:
-            out = string.encode(encoding)
-        else:
-            out = string.decode(encoding)
+        out = string.decode(encoding)
 
     return out
 
@@ -36,7 +42,7 @@ def unicode_is_ascii(u_string):
     """
     assert isinstance(u_string, str)
     try:
-        u_string.encode('ascii')
+        u_string.encode("ascii")
         return True
     except UnicodeEncodeError:
         return False
diff --git a/lib/requests/adapters.py b/lib/requests/adapters.py
index fe22ff45..d3b2d5bb 100644
--- a/lib/requests/adapters.py
+++ b/lib/requests/adapters.py
@@ -1,5 +1,3 @@
-# -*- coding: utf-8 -*-
-
 """
 requests.adapters
 ~~~~~~~~~~~~~~~~~
@@ -9,58 +7,76 @@ and maintain connections.
 """
 
 import os.path
-import socket
+import socket  # noqa: F401
 
-from urllib3.poolmanager import PoolManager, proxy_from_url
-from urllib3.response import HTTPResponse
-from urllib3.util import parse_url
-from urllib3.util import Timeout as TimeoutSauce
-from urllib3.util.retry import Retry
-from urllib3.exceptions import ClosedPoolError
-from urllib3.exceptions import ConnectTimeoutError
+from urllib3.exceptions import ClosedPoolError, ConnectTimeoutError
 from urllib3.exceptions import HTTPError as _HTTPError
 from urllib3.exceptions import InvalidHeader as _InvalidHeader
-from urllib3.exceptions import MaxRetryError
-from urllib3.exceptions import NewConnectionError
+from urllib3.exceptions import (
+    LocationValueError,
+    MaxRetryError,
+    NewConnectionError,
+    ProtocolError,
+)
 from urllib3.exceptions import ProxyError as _ProxyError
-from urllib3.exceptions import ProtocolError
-from urllib3.exceptions import ReadTimeoutError
+from urllib3.exceptions import ReadTimeoutError, ResponseError
 from urllib3.exceptions import SSLError as _SSLError
-from urllib3.exceptions import ResponseError
-from urllib3.exceptions import LocationValueError
+from urllib3.poolmanager import PoolManager, proxy_from_url
+from urllib3.response import HTTPResponse
+from urllib3.util import Timeout as TimeoutSauce
+from urllib3.util import parse_url
+from urllib3.util.retry import Retry
 
-from .models import Response
-from .compat import urlparse, basestring
-from .utils import (DEFAULT_CA_BUNDLE_PATH, extract_zipped_paths,
-                    get_encoding_from_headers, prepend_scheme_if_needed,
-                    get_auth_from_url, urldefragauth, select_proxy)
-from .structures import CaseInsensitiveDict
-from .cookies import extract_cookies_to_jar
-from .exceptions import (ConnectionError, ConnectTimeout, ReadTimeout, SSLError,
-                         ProxyError, RetryError, InvalidSchema, InvalidProxyURL,
-                         InvalidURL, InvalidHeader)
 from .auth import _basic_auth_str
+from .compat import basestring, urlparse
+from .cookies import extract_cookies_to_jar
+from .exceptions import (
+    ConnectionError,
+    ConnectTimeout,
+    InvalidHeader,
+    InvalidProxyURL,
+    InvalidSchema,
+    InvalidURL,
+    ProxyError,
+    ReadTimeout,
+    RetryError,
+    SSLError,
+)
+from .models import Response
+from .structures import CaseInsensitiveDict
+from .utils import (
+    DEFAULT_CA_BUNDLE_PATH,
+    extract_zipped_paths,
+    get_auth_from_url,
+    get_encoding_from_headers,
+    prepend_scheme_if_needed,
+    select_proxy,
+    urldefragauth,
+)
 
 try:
     from urllib3.contrib.socks import SOCKSProxyManager
 except ImportError:
+
     def SOCKSProxyManager(*args, **kwargs):
         raise InvalidSchema("Missing dependencies for SOCKS support.")
 
+
 DEFAULT_POOLBLOCK = False
 DEFAULT_POOLSIZE = 10
 DEFAULT_RETRIES = 0
 DEFAULT_POOL_TIMEOUT = None
 
 
-class BaseAdapter(object):
+class BaseAdapter:
     """The Base Transport Adapter"""
 
     def __init__(self):
-        super(BaseAdapter, self).__init__()
+        super().__init__()
 
-    def send(self, request, stream=False, timeout=None, verify=True,
-             cert=None, proxies=None):
+    def send(
+        self, request, stream=False, timeout=None, verify=True, cert=None, proxies=None
+    ):
         """Sends PreparedRequest object. Returns Response object.
 
         :param request: The :class:`PreparedRequest <PreparedRequest>` being sent.
@@ -108,12 +124,22 @@ class HTTPAdapter(BaseAdapter):
       >>> a = requests.adapters.HTTPAdapter(max_retries=3)
       >>> s.mount('http://', a)
     """
-    __attrs__ = ['max_retries', 'config', '_pool_connections', '_pool_maxsize',
-                 '_pool_block']
 
-    def __init__(self, pool_connections=DEFAULT_POOLSIZE,
-                 pool_maxsize=DEFAULT_POOLSIZE, max_retries=DEFAULT_RETRIES,
-                 pool_block=DEFAULT_POOLBLOCK):
+    __attrs__ = [
+        "max_retries",
+        "config",
+        "_pool_connections",
+        "_pool_maxsize",
+        "_pool_block",
+    ]
+
+    def __init__(
+        self,
+        pool_connections=DEFAULT_POOLSIZE,
+        pool_maxsize=DEFAULT_POOLSIZE,
+        max_retries=DEFAULT_RETRIES,
+        pool_block=DEFAULT_POOLBLOCK,
+    ):
         if max_retries == DEFAULT_RETRIES:
             self.max_retries = Retry(0, read=False)
         else:
@@ -121,7 +147,7 @@ class HTTPAdapter(BaseAdapter):
         self.config = {}
         self.proxy_manager = {}
 
-        super(HTTPAdapter, self).__init__()
+        super().__init__()
 
         self._pool_connections = pool_connections
         self._pool_maxsize = pool_maxsize
@@ -141,10 +167,13 @@ class HTTPAdapter(BaseAdapter):
         for attr, value in state.items():
             setattr(self, attr, value)
 
-        self.init_poolmanager(self._pool_connections, self._pool_maxsize,
-                              block=self._pool_block)
+        self.init_poolmanager(
+            self._pool_connections, self._pool_maxsize, block=self._pool_block
+        )
 
-    def init_poolmanager(self, connections, maxsize, block=DEFAULT_POOLBLOCK, **pool_kwargs):
+    def init_poolmanager(
+        self, connections, maxsize, block=DEFAULT_POOLBLOCK, **pool_kwargs
+    ):
         """Initializes a urllib3 PoolManager.
 
         This method should not be called from user code, and is only
@@ -161,8 +190,13 @@ class HTTPAdapter(BaseAdapter):
         self._pool_maxsize = maxsize
         self._pool_block = block
 
-        self.poolmanager = PoolManager(num_pools=connections, maxsize=maxsize,
-                                       block=block, strict=True, **pool_kwargs)
+        self.poolmanager = PoolManager(
+            num_pools=connections,
+            maxsize=maxsize,
+            block=block,
+            strict=True,
+            **pool_kwargs,
+        )
 
     def proxy_manager_for(self, proxy, **proxy_kwargs):
         """Return urllib3 ProxyManager for the given proxy.
@@ -178,7 +212,7 @@ class HTTPAdapter(BaseAdapter):
         """
         if proxy in self.proxy_manager:
             manager = self.proxy_manager[proxy]
-        elif proxy.lower().startswith('socks'):
+        elif proxy.lower().startswith("socks"):
             username, password = get_auth_from_url(proxy)
             manager = self.proxy_manager[proxy] = SOCKSProxyManager(
                 proxy,
@@ -187,7 +221,7 @@ class HTTPAdapter(BaseAdapter):
                 num_pools=self._pool_connections,
                 maxsize=self._pool_maxsize,
                 block=self._pool_block,
-                **proxy_kwargs
+                **proxy_kwargs,
             )
         else:
             proxy_headers = self.proxy_headers(proxy)
@@ -197,7 +231,8 @@ class HTTPAdapter(BaseAdapter):
                 num_pools=self._pool_connections,
                 maxsize=self._pool_maxsize,
                 block=self._pool_block,
-                **proxy_kwargs)
+                **proxy_kwargs,
+            )
 
         return manager
 
@@ -213,7 +248,7 @@ class HTTPAdapter(BaseAdapter):
             to a CA bundle to use
         :param cert: The SSL certificate to verify.
         """
-        if url.lower().startswith('https') and verify:
+        if url.lower().startswith("https") and verify:
 
             cert_loc = None
 
@@ -225,17 +260,19 @@ class HTTPAdapter(BaseAdapter):
                 cert_loc = extract_zipped_paths(DEFAULT_CA_BUNDLE_PATH)
 
             if not cert_loc or not os.path.exists(cert_loc):
-                raise IOError("Could not find a suitable TLS CA certificate bundle, "
-                              "invalid path: {}".format(cert_loc))
+                raise OSError(
+                    f"Could not find a suitable TLS CA certificate bundle, "
+                    f"invalid path: {cert_loc}"
+                )
 
-            conn.cert_reqs = 'CERT_REQUIRED'
+            conn.cert_reqs = "CERT_REQUIRED"
 
             if not os.path.isdir(cert_loc):
                 conn.ca_certs = cert_loc
             else:
                 conn.ca_cert_dir = cert_loc
         else:
-            conn.cert_reqs = 'CERT_NONE'
+            conn.cert_reqs = "CERT_NONE"
             conn.ca_certs = None
             conn.ca_cert_dir = None
 
@@ -247,11 +284,14 @@ class HTTPAdapter(BaseAdapter):
                 conn.cert_file = cert
                 conn.key_file = None
             if conn.cert_file and not os.path.exists(conn.cert_file):
-                raise IOError("Could not find the TLS certificate file, "
-                              "invalid path: {}".format(conn.cert_file))
+                raise OSError(
+                    f"Could not find the TLS certificate file, "
+                    f"invalid path: {conn.cert_file}"
+                )
             if conn.key_file and not os.path.exists(conn.key_file):
-                raise IOError("Could not find the TLS key file, "
-                              "invalid path: {}".format(conn.key_file))
+                raise OSError(
+                    f"Could not find the TLS key file, invalid path: {conn.key_file}"
+                )
 
     def build_response(self, req, resp):
         """Builds a :class:`Response <requests.Response>` object from a urllib3
@@ -266,10 +306,10 @@ class HTTPAdapter(BaseAdapter):
         response = Response()
 
         # Fallback to None if there's no status_code, for whatever reason.
-        response.status_code = getattr(resp, 'status', None)
+        response.status_code = getattr(resp, "status", None)
 
         # Make headers case-insensitive.
-        response.headers = CaseInsensitiveDict(getattr(resp, 'headers', {}))
+        response.headers = CaseInsensitiveDict(getattr(resp, "headers", {}))
 
         # Set encoding.
         response.encoding = get_encoding_from_headers(response.headers)
@@ -277,7 +317,7 @@ class HTTPAdapter(BaseAdapter):
         response.reason = response.raw.reason
 
         if isinstance(req.url, bytes):
-            response.url = req.url.decode('utf-8')
+            response.url = req.url.decode("utf-8")
         else:
             response.url = req.url
 
@@ -302,11 +342,13 @@ class HTTPAdapter(BaseAdapter):
         proxy = select_proxy(url, proxies)
 
         if proxy:
-            proxy = prepend_scheme_if_needed(proxy, 'http')
+            proxy = prepend_scheme_if_needed(proxy, "http")
             proxy_url = parse_url(proxy)
             if not proxy_url.host:
-                raise InvalidProxyURL("Please check proxy URL. It is malformed"
-                                      " and could be missing the host.")
+                raise InvalidProxyURL(
+                    "Please check proxy URL. It is malformed "
+                    "and could be missing the host."
+                )
             proxy_manager = self.proxy_manager_for(proxy)
             conn = proxy_manager.connection_from_url(url)
         else:
@@ -344,11 +386,11 @@ class HTTPAdapter(BaseAdapter):
         proxy = select_proxy(request.url, proxies)
         scheme = urlparse(request.url).scheme
 
-        is_proxied_http_request = (proxy and scheme != 'https')
+        is_proxied_http_request = proxy and scheme != "https"
         using_socks_proxy = False
         if proxy:
             proxy_scheme = urlparse(proxy).scheme.lower()
-            using_socks_proxy = proxy_scheme.startswith('socks')
+            using_socks_proxy = proxy_scheme.startswith("socks")
 
         url = request.path_url
         if is_proxied_http_request and not using_socks_proxy:
@@ -387,12 +429,13 @@ class HTTPAdapter(BaseAdapter):
         username, password = get_auth_from_url(proxy)
 
         if username:
-            headers['Proxy-Authorization'] = _basic_auth_str(username,
-                                                             password)
+            headers["Proxy-Authorization"] = _basic_auth_str(username, password)
 
         return headers
 
-    def send(self, request, stream=False, timeout=None, verify=True, cert=None, proxies=None):
+    def send(
+        self, request, stream=False, timeout=None, verify=True, cert=None, proxies=None
+    ):
         """Sends PreparedRequest object. Returns Response object.
 
         :param request: The :class:`PreparedRequest <PreparedRequest>` being sent.
@@ -416,20 +459,26 @@ class HTTPAdapter(BaseAdapter):
 
         self.cert_verify(conn, request.url, verify, cert)
         url = self.request_url(request, proxies)
-        self.add_headers(request, stream=stream, timeout=timeout, verify=verify, cert=cert, proxies=proxies)
+        self.add_headers(
+            request,
+            stream=stream,
+            timeout=timeout,
+            verify=verify,
+            cert=cert,
+            proxies=proxies,
+        )
 
-        chunked = not (request.body is None or 'Content-Length' in request.headers)
+        chunked = not (request.body is None or "Content-Length" in request.headers)
 
         if isinstance(timeout, tuple):
             try:
                 connect, read = timeout
                 timeout = TimeoutSauce(connect=connect, read=read)
-            except ValueError as e:
-                # this may raise a string formatting error.
-                err = ("Invalid timeout {}. Pass a (connect, read) "
-                       "timeout tuple, or a single float to set "
-                       "both timeouts to the same value".format(timeout))
-                raise ValueError(err)
+            except ValueError:
+                raise ValueError(
+                    f"Invalid timeout {timeout}. Pass a (connect, read) timeout tuple, "
+                    f"or a single float to set both timeouts to the same value."
+                )
         elif isinstance(timeout, TimeoutSauce):
             pass
         else:
@@ -447,22 +496,24 @@ class HTTPAdapter(BaseAdapter):
                     preload_content=False,
                     decode_content=False,
                     retries=self.max_retries,
-                    timeout=timeout
+                    timeout=timeout,
                 )
 
             # Send the request.
             else:
-                if hasattr(conn, 'proxy_pool'):
+                if hasattr(conn, "proxy_pool"):
                     conn = conn.proxy_pool
 
                 low_conn = conn._get_conn(timeout=DEFAULT_POOL_TIMEOUT)
 
                 try:
-                    skip_host = 'Host' in request.headers
-                    low_conn.putrequest(request.method,
-                                        url,
-                                        skip_accept_encoding=True,
-                                        skip_host=skip_host)
+                    skip_host = "Host" in request.headers
+                    low_conn.putrequest(
+                        request.method,
+                        url,
+                        skip_accept_encoding=True,
+                        skip_host=skip_host,
+                    )
 
                     for header, value in request.headers.items():
                         low_conn.putheader(header, value)
@@ -470,34 +521,29 @@ class HTTPAdapter(BaseAdapter):
                     low_conn.endheaders()
 
                     for i in request.body:
-                        low_conn.send(hex(len(i))[2:].encode('utf-8'))
-                        low_conn.send(b'\r\n')
+                        low_conn.send(hex(len(i))[2:].encode("utf-8"))
+                        low_conn.send(b"\r\n")
                         low_conn.send(i)
-                        low_conn.send(b'\r\n')
-                    low_conn.send(b'0\r\n\r\n')
+                        low_conn.send(b"\r\n")
+                    low_conn.send(b"0\r\n\r\n")
 
                     # Receive the response from the server
-                    try:
-                        # For Python 2.7, use buffering of HTTP responses
-                        r = low_conn.getresponse(buffering=True)
-                    except TypeError:
-                        # For compatibility with Python 3.3+
-                        r = low_conn.getresponse()
+                    r = low_conn.getresponse()
 
                     resp = HTTPResponse.from_httplib(
                         r,
                         pool=conn,
                         connection=low_conn,
                         preload_content=False,
-                        decode_content=False
+                        decode_content=False,
                     )
-                except:
+                except Exception:
                     # If we hit any problems here, clean up the connection.
-                    # Then, reraise so that we can handle the actual exception.
+                    # Then, raise so that we can handle the actual exception.
                     low_conn.close()
                     raise
 
-        except (ProtocolError, socket.error) as err:
+        except (ProtocolError, OSError) as err:
             raise ConnectionError(err, request=request)
 
         except MaxRetryError as e:
diff --git a/lib/requests/api.py b/lib/requests/api.py
index 4cba90ee..2f71aaed 100644
--- a/lib/requests/api.py
+++ b/lib/requests/api.py
@@ -1,5 +1,3 @@
-# -*- coding: utf-8 -*-
-
 """
 requests.api
 ~~~~~~~~~~~~
@@ -72,7 +70,7 @@ def get(url, params=None, **kwargs):
     :rtype: requests.Response
     """
 
-    return request('get', url, params=params, **kwargs)
+    return request("get", url, params=params, **kwargs)
 
 
 def options(url, **kwargs):
@@ -84,7 +82,7 @@ def options(url, **kwargs):
     :rtype: requests.Response
     """
 
-    return request('options', url, **kwargs)
+    return request("options", url, **kwargs)
 
 
 def head(url, **kwargs):
@@ -98,8 +96,8 @@ def head(url, **kwargs):
     :rtype: requests.Response
     """
 
-    kwargs.setdefault('allow_redirects', False)
-    return request('head', url, **kwargs)
+    kwargs.setdefault("allow_redirects", False)
+    return request("head", url, **kwargs)
 
 
 def post(url, data=None, json=None, **kwargs):
@@ -114,7 +112,7 @@ def post(url, data=None, json=None, **kwargs):
     :rtype: requests.Response
     """
 
-    return request('post', url, data=data, json=json, **kwargs)
+    return request("post", url, data=data, json=json, **kwargs)
 
 
 def put(url, data=None, **kwargs):
@@ -129,7 +127,7 @@ def put(url, data=None, **kwargs):
     :rtype: requests.Response
     """
 
-    return request('put', url, data=data, **kwargs)
+    return request("put", url, data=data, **kwargs)
 
 
 def patch(url, data=None, **kwargs):
@@ -144,7 +142,7 @@ def patch(url, data=None, **kwargs):
     :rtype: requests.Response
     """
 
-    return request('patch', url, data=data, **kwargs)
+    return request("patch", url, data=data, **kwargs)
 
 
 def delete(url, **kwargs):
@@ -156,4 +154,4 @@ def delete(url, **kwargs):
     :rtype: requests.Response
     """
 
-    return request('delete', url, **kwargs)
+    return request("delete", url, **kwargs)
diff --git a/lib/requests/auth.py b/lib/requests/auth.py
index eeface39..9733686d 100644
--- a/lib/requests/auth.py
+++ b/lib/requests/auth.py
@@ -1,5 +1,3 @@
-# -*- coding: utf-8 -*-
-
 """
 requests.auth
 ~~~~~~~~~~~~~
@@ -7,22 +5,21 @@ requests.auth
 This module contains the authentication handlers for Requests.
 """
 
+import hashlib
 import os
 import re
-import time
-import hashlib
 import threading
+import time
 import warnings
-
 from base64 import b64encode
 
-from .compat import urlparse, str, basestring
-from .cookies import extract_cookies_to_jar
 from ._internal_utils import to_native_string
+from .compat import basestring, str, urlparse
+from .cookies import extract_cookies_to_jar
 from .utils import parse_dict_header
 
-CONTENT_TYPE_FORM_URLENCODED = 'application/x-www-form-urlencoded'
-CONTENT_TYPE_MULTI_PART = 'multipart/form-data'
+CONTENT_TYPE_FORM_URLENCODED = "application/x-www-form-urlencoded"
+CONTENT_TYPE_MULTI_PART = "multipart/form-data"
 
 
 def _basic_auth_str(username, password):
@@ -57,23 +54,23 @@ def _basic_auth_str(username, password):
     # -- End Removal --
 
     if isinstance(username, str):
-        username = username.encode('latin1')
+        username = username.encode("latin1")
 
     if isinstance(password, str):
-        password = password.encode('latin1')
+        password = password.encode("latin1")
 
-    authstr = 'Basic ' + to_native_string(
-        b64encode(b':'.join((username, password))).strip()
+    authstr = "Basic " + to_native_string(
+        b64encode(b":".join((username, password))).strip()
     )
 
     return authstr
 
 
-class AuthBase(object):
+class AuthBase:
     """Base class that all auth implementations derive from"""
 
     def __call__(self, r):
-        raise NotImplementedError('Auth hooks must be callable.')
+        raise NotImplementedError("Auth hooks must be callable.")
 
 
 class HTTPBasicAuth(AuthBase):
@@ -84,16 +81,18 @@ class HTTPBasicAuth(AuthBase):
         self.password = password
 
     def __eq__(self, other):
-        return all([
-            self.username == getattr(other, 'username', None),
-            self.password == getattr(other, 'password', None)
-        ])
+        return all(
+            [
+                self.username == getattr(other, "username", None),
+                self.password == getattr(other, "password", None),
+            ]
+        )
 
     def __ne__(self, other):
         return not self == other
 
     def __call__(self, r):
-        r.headers['Authorization'] = _basic_auth_str(self.username, self.password)
+        r.headers["Authorization"] = _basic_auth_str(self.username, self.password)
         return r
 
 
@@ -101,7 +100,7 @@ class HTTPProxyAuth(HTTPBasicAuth):
     """Attaches HTTP Proxy Authentication to a given Request object."""
 
     def __call__(self, r):
-        r.headers['Proxy-Authorization'] = _basic_auth_str(self.username, self.password)
+        r.headers["Proxy-Authorization"] = _basic_auth_str(self.username, self.password)
         return r
 
 
@@ -116,9 +115,9 @@ class HTTPDigestAuth(AuthBase):
 
     def init_per_thread_state(self):
         # Ensure state is initialized just once per-thread
-        if not hasattr(self._thread_local, 'init'):
+        if not hasattr(self._thread_local, "init"):
             self._thread_local.init = True
-            self._thread_local.last_nonce = ''
+            self._thread_local.last_nonce = ""
             self._thread_local.nonce_count = 0
             self._thread_local.chal = {}
             self._thread_local.pos = None
@@ -129,44 +128,52 @@ class HTTPDigestAuth(AuthBase):
         :rtype: str
         """
 
-        realm = self._thread_local.chal['realm']
-        nonce = self._thread_local.chal['nonce']
-        qop = self._thread_local.chal.get('qop')
-        algorithm = self._thread_local.chal.get('algorithm')
-        opaque = self._thread_local.chal.get('opaque')
+        realm = self._thread_local.chal["realm"]
+        nonce = self._thread_local.chal["nonce"]
+        qop = self._thread_local.chal.get("qop")
+        algorithm = self._thread_local.chal.get("algorithm")
+        opaque = self._thread_local.chal.get("opaque")
         hash_utf8 = None
 
         if algorithm is None:
-            _algorithm = 'MD5'
+            _algorithm = "MD5"
         else:
             _algorithm = algorithm.upper()
         # lambdas assume digest modules are imported at the top level
-        if _algorithm == 'MD5' or _algorithm == 'MD5-SESS':
+        if _algorithm == "MD5" or _algorithm == "MD5-SESS":
+
             def md5_utf8(x):
                 if isinstance(x, str):
-                    x = x.encode('utf-8')
+                    x = x.encode("utf-8")
                 return hashlib.md5(x).hexdigest()
+
             hash_utf8 = md5_utf8
-        elif _algorithm == 'SHA':
+        elif _algorithm == "SHA":
+
             def sha_utf8(x):
                 if isinstance(x, str):
-                    x = x.encode('utf-8')
+                    x = x.encode("utf-8")
                 return hashlib.sha1(x).hexdigest()
+
             hash_utf8 = sha_utf8
-        elif _algorithm == 'SHA-256':
+        elif _algorithm == "SHA-256":
+
             def sha256_utf8(x):
                 if isinstance(x, str):
-                    x = x.encode('utf-8')
+                    x = x.encode("utf-8")
                 return hashlib.sha256(x).hexdigest()
+
             hash_utf8 = sha256_utf8
-        elif _algorithm == 'SHA-512':
+        elif _algorithm == "SHA-512":
+
             def sha512_utf8(x):
                 if isinstance(x, str):
-                    x = x.encode('utf-8')
+                    x = x.encode("utf-8")
                 return hashlib.sha512(x).hexdigest()
+
             hash_utf8 = sha512_utf8
 
-        KD = lambda s, d: hash_utf8("%s:%s" % (s, d))
+        KD = lambda s, d: hash_utf8(f"{s}:{d}")  # noqa:E731
 
         if hash_utf8 is None:
             return None
@@ -177,10 +184,10 @@ class HTTPDigestAuth(AuthBase):
         #: path is request-uri defined in RFC 2616 which should not be empty
         path = p_parsed.path or "/"
         if p_parsed.query:
-            path += '?' + p_parsed.query
+            path += f"?{p_parsed.query}"
 
-        A1 = '%s:%s:%s' % (self.username, realm, self.password)
-        A2 = '%s:%s' % (method, path)
+        A1 = f"{self.username}:{realm}:{self.password}"
+        A2 = f"{method}:{path}"
 
         HA1 = hash_utf8(A1)
         HA2 = hash_utf8(A2)
@@ -189,22 +196,20 @@ class HTTPDigestAuth(AuthBase):
             self._thread_local.nonce_count += 1
         else:
             self._thread_local.nonce_count = 1
-        ncvalue = '%08x' % self._thread_local.nonce_count
-        s = str(self._thread_local.nonce_count).encode('utf-8')
-        s += nonce.encode('utf-8')
-        s += time.ctime().encode('utf-8')
+        ncvalue = f"{self._thread_local.nonce_count:08x}"
+        s = str(self._thread_local.nonce_count).encode("utf-8")
+        s += nonce.encode("utf-8")
+        s += time.ctime().encode("utf-8")
         s += os.urandom(8)
 
-        cnonce = (hashlib.sha1(s).hexdigest()[:16])
-        if _algorithm == 'MD5-SESS':
-            HA1 = hash_utf8('%s:%s:%s' % (HA1, nonce, cnonce))
+        cnonce = hashlib.sha1(s).hexdigest()[:16]
+        if _algorithm == "MD5-SESS":
+            HA1 = hash_utf8(f"{HA1}:{nonce}:{cnonce}")
 
         if not qop:
-            respdig = KD(HA1, "%s:%s" % (nonce, HA2))
-        elif qop == 'auth' or 'auth' in qop.split(','):
-            noncebit = "%s:%s:%s:%s:%s" % (
-                nonce, ncvalue, cnonce, 'auth', HA2
-            )
+            respdig = KD(HA1, f"{nonce}:{HA2}")
+        elif qop == "auth" or "auth" in qop.split(","):
+            noncebit = f"{nonce}:{ncvalue}:{cnonce}:auth:{HA2}"
             respdig = KD(HA1, noncebit)
         else:
             # XXX handle auth-int.
@@ -213,18 +218,20 @@ class HTTPDigestAuth(AuthBase):
         self._thread_local.last_nonce = nonce
 
         # XXX should the partial digests be encoded too?
-        base = 'username="%s", realm="%s", nonce="%s", uri="%s", ' \
-               'response="%s"' % (self.username, realm, nonce, path, respdig)
+        base = (
+            f'username="{self.username}", realm="{realm}", nonce="{nonce}", '
+            f'uri="{path}", response="{respdig}"'
+        )
         if opaque:
-            base += ', opaque="%s"' % opaque
+            base += f', opaque="{opaque}"'
         if algorithm:
-            base += ', algorithm="%s"' % algorithm
+            base += f', algorithm="{algorithm}"'
         if entdig:
-            base += ', digest="%s"' % entdig
+            base += f', digest="{entdig}"'
         if qop:
-            base += ', qop="auth", nc=%s, cnonce="%s"' % (ncvalue, cnonce)
+            base += f', qop="auth", nc={ncvalue}, cnonce="{cnonce}"'
 
-        return 'Digest %s' % (base)
+        return f"Digest {base}"
 
     def handle_redirect(self, r, **kwargs):
         """Reset num_401_calls counter on redirects."""
@@ -248,13 +255,13 @@ class HTTPDigestAuth(AuthBase):
             # Rewind the file position indicator of the body to where
             # it was to resend the request.
             r.request.body.seek(self._thread_local.pos)
-        s_auth = r.headers.get('www-authenticate', '')
+        s_auth = r.headers.get("www-authenticate", "")
 
-        if 'digest' in s_auth.lower() and self._thread_local.num_401_calls < 2:
+        if "digest" in s_auth.lower() and self._thread_local.num_401_calls < 2:
 
             self._thread_local.num_401_calls += 1
-            pat = re.compile(r'digest ', flags=re.IGNORECASE)
-            self._thread_local.chal = parse_dict_header(pat.sub('', s_auth, count=1))
+            pat = re.compile(r"digest ", flags=re.IGNORECASE)
+            self._thread_local.chal = parse_dict_header(pat.sub("", s_auth, count=1))
 
             # Consume content and release the original connection
             # to allow our new request to reuse the same one.
@@ -264,8 +271,9 @@ class HTTPDigestAuth(AuthBase):
             extract_cookies_to_jar(prep._cookies, r.request, r.raw)
             prep.prepare_cookies(prep._cookies)
 
-            prep.headers['Authorization'] = self.build_digest_header(
-                prep.method, prep.url)
+            prep.headers["Authorization"] = self.build_digest_header(
+                prep.method, prep.url
+            )
             _r = r.connection.send(prep, **kwargs)
             _r.history.append(r)
             _r.request = prep
@@ -280,7 +288,7 @@ class HTTPDigestAuth(AuthBase):
         self.init_per_thread_state()
         # If we have a saved nonce, skip the 401
         if self._thread_local.last_nonce:
-            r.headers['Authorization'] = self.build_digest_header(r.method, r.url)
+            r.headers["Authorization"] = self.build_digest_header(r.method, r.url)
         try:
             self._thread_local.pos = r.body.tell()
         except AttributeError:
@@ -289,17 +297,19 @@ class HTTPDigestAuth(AuthBase):
             # file position of the previous body. Ensure it's set to
             # None.
             self._thread_local.pos = None
-        r.register_hook('response', self.handle_401)
-        r.register_hook('response', self.handle_redirect)
+        r.register_hook("response", self.handle_401)
+        r.register_hook("response", self.handle_redirect)
         self._thread_local.num_401_calls = 1
 
         return r
 
     def __eq__(self, other):
-        return all([
-            self.username == getattr(other, 'username', None),
-            self.password == getattr(other, 'password', None)
-        ])
+        return all(
+            [
+                self.username == getattr(other, "username", None),
+                self.password == getattr(other, "password", None),
+            ]
+        )
 
     def __ne__(self, other):
         return not self == other
diff --git a/lib/requests/certs.py b/lib/requests/certs.py
index d1a378d7..be422c3e 100644
--- a/lib/requests/certs.py
+++ b/lib/requests/certs.py
@@ -1,5 +1,4 @@
 #!/usr/bin/env python
-# -*- coding: utf-8 -*-
 
 """
 requests.certs
@@ -14,5 +13,5 @@ packaged CA bundle.
 """
 from certifi import where
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     print(where())
diff --git a/lib/requests/compat.py b/lib/requests/compat.py
index 029ae62a..6776163c 100644
--- a/lib/requests/compat.py
+++ b/lib/requests/compat.py
@@ -1,11 +1,10 @@
-# -*- coding: utf-8 -*-
-
 """
 requests.compat
 ~~~~~~~~~~~~~~~
 
-This module handles import compatibility issues between Python 2 and
-Python 3.
+This module previously handled import compatibility issues
+between Python 2 and Python 3. It remains for backwards
+compatibility until the next major version.
 """
 
 try:
@@ -23,59 +22,58 @@ import sys
 _ver = sys.version_info
 
 #: Python 2.x?
-is_py2 = (_ver[0] == 2)
+is_py2 = _ver[0] == 2
 
 #: Python 3.x?
-is_py3 = (_ver[0] == 3)
+is_py3 = _ver[0] == 3
 
+# json/simplejson module import resolution
 has_simplejson = False
 try:
     import simplejson as json
+
     has_simplejson = True
 except ImportError:
     import json
 
-# ---------
-# Specifics
-# ---------
+if has_simplejson:
+    from simplejson import JSONDecodeError
+else:
+    from json import JSONDecodeError
 
-if is_py2:
-    from urllib import (
-        quote, unquote, quote_plus, unquote_plus, urlencode, getproxies,
-        proxy_bypass, proxy_bypass_environment, getproxies_environment)
-    from urlparse import urlparse, urlunparse, urljoin, urlsplit, urldefrag
-    from urllib2 import parse_http_list
-    import cookielib
-    from Cookie import Morsel
-    from StringIO import StringIO
-    # Keep OrderedDict for backwards compatibility.
-    from collections import Callable, Mapping, MutableMapping, OrderedDict
+# Keep OrderedDict for backwards compatibility.
+from collections import OrderedDict
+from collections.abc import Callable, Mapping, MutableMapping
+from http import cookiejar as cookielib
+from http.cookies import Morsel
+from io import StringIO
 
-    builtin_str = str
-    bytes = str
-    str = unicode
-    basestring = basestring
-    numeric_types = (int, long, float)
-    integer_types = (int, long)
-    JSONDecodeError = ValueError
+# --------------
+# Legacy Imports
+# --------------
+from urllib.parse import (
+    quote,
+    quote_plus,
+    unquote,
+    unquote_plus,
+    urldefrag,
+    urlencode,
+    urljoin,
+    urlparse,
+    urlsplit,
+    urlunparse,
+)
+from urllib.request import (
+    getproxies,
+    getproxies_environment,
+    parse_http_list,
+    proxy_bypass,
+    proxy_bypass_environment,
+)
 
-elif is_py3:
-    from urllib.parse import urlparse, urlunparse, urljoin, urlsplit, urlencode, quote, unquote, quote_plus, unquote_plus, urldefrag
-    from urllib.request import parse_http_list, getproxies, proxy_bypass, proxy_bypass_environment, getproxies_environment
-    from http import cookiejar as cookielib
-    from http.cookies import Morsel
-    from io import StringIO
-    # Keep OrderedDict for backwards compatibility.
-    from collections import OrderedDict
-    from collections.abc import Callable, Mapping, MutableMapping
-    if has_simplejson:
-        from simplejson import JSONDecodeError
-    else:
-        from json import JSONDecodeError
-
-    builtin_str = str
-    str = str
-    bytes = bytes
-    basestring = (str, bytes)
-    numeric_types = (int, float)
-    integer_types = (int,)
+builtin_str = str
+str = str
+bytes = bytes
+basestring = (str, bytes)
+numeric_types = (int, float)
+integer_types = (int,)
diff --git a/lib/requests/cookies.py b/lib/requests/cookies.py
index 56fccd9c..bf54ab23 100644
--- a/lib/requests/cookies.py
+++ b/lib/requests/cookies.py
@@ -1,5 +1,3 @@
-# -*- coding: utf-8 -*-
-
 """
 requests.cookies
 ~~~~~~~~~~~~~~~~
@@ -9,12 +7,12 @@ Compatibility code to be able to use `cookielib.CookieJar` with requests.
 requests.utils imports from here, so be careful with imports.
 """
 
+import calendar
 import copy
 import time
-import calendar
 
 from ._internal_utils import to_native_string
-from .compat import cookielib, urlparse, urlunparse, Morsel, MutableMapping
+from .compat import Morsel, MutableMapping, cookielib, urlparse, urlunparse
 
 try:
     import threading
@@ -22,7 +20,7 @@ except ImportError:
     import dummy_threading as threading
 
 
-class MockRequest(object):
+class MockRequest:
     """Wraps a `requests.Request` to mimic a `urllib2.Request`.
 
     The code in `cookielib.CookieJar` expects this interface in order to correctly
@@ -51,16 +49,22 @@ class MockRequest(object):
     def get_full_url(self):
         # Only return the response's URL if the user hadn't set the Host
         # header
-        if not self._r.headers.get('Host'):
+        if not self._r.headers.get("Host"):
             return self._r.url
         # If they did set it, retrieve it and reconstruct the expected domain
-        host = to_native_string(self._r.headers['Host'], encoding='utf-8')
+        host = to_native_string(self._r.headers["Host"], encoding="utf-8")
         parsed = urlparse(self._r.url)
         # Reconstruct the URL as we expect it
-        return urlunparse([
-            parsed.scheme, host, parsed.path, parsed.params, parsed.query,
-            parsed.fragment
-        ])
+        return urlunparse(
+            [
+                parsed.scheme,
+                host,
+                parsed.path,
+                parsed.params,
+                parsed.query,
+                parsed.fragment,
+            ]
+        )
 
     def is_unverifiable(self):
         return True
@@ -73,7 +77,9 @@ class MockRequest(object):
 
     def add_header(self, key, val):
         """cookielib has no legitimate use for this method; add it back if you find one."""
-        raise NotImplementedError("Cookie headers should be added with add_unredirected_header()")
+        raise NotImplementedError(
+            "Cookie headers should be added with add_unredirected_header()"
+        )
 
     def add_unredirected_header(self, name, value):
         self._new_headers[name] = value
@@ -94,7 +100,7 @@ class MockRequest(object):
         return self.get_host()
 
 
-class MockResponse(object):
+class MockResponse:
     """Wraps a `httplib.HTTPMessage` to mimic a `urllib.addinfourl`.
 
     ...what? Basically, expose the parsed HTTP headers from the server response
@@ -122,8 +128,7 @@ def extract_cookies_to_jar(jar, request, response):
     :param request: our own requests.Request object
     :param response: urllib3.HTTPResponse object
     """
-    if not (hasattr(response, '_original_response') and
-            response._original_response):
+    if not (hasattr(response, "_original_response") and response._original_response):
         return
     # the _original_response field is the wrapped httplib.HTTPResponse object,
     req = MockRequest(request)
@@ -140,7 +145,7 @@ def get_cookie_header(jar, request):
     """
     r = MockRequest(request)
     jar.add_cookie_header(r)
-    return r.get_new_headers().get('Cookie')
+    return r.get_new_headers().get("Cookie")
 
 
 def remove_cookie_by_name(cookiejar, name, domain=None, path=None):
@@ -205,7 +210,9 @@ class RequestsCookieJar(cookielib.CookieJar, MutableMapping):
         """
         # support client code that unsets cookies by assignment of a None value:
         if value is None:
-            remove_cookie_by_name(self, name, domain=kwargs.get('domain'), path=kwargs.get('path'))
+            remove_cookie_by_name(
+                self, name, domain=kwargs.get("domain"), path=kwargs.get("path")
+            )
             return
 
         if isinstance(value, Morsel):
@@ -305,16 +312,15 @@ class RequestsCookieJar(cookielib.CookieJar, MutableMapping):
         """
         dictionary = {}
         for cookie in iter(self):
-            if (
-                (domain is None or cookie.domain == domain) and
-                (path is None or cookie.path == path)
+            if (domain is None or cookie.domain == domain) and (
+                path is None or cookie.path == path
             ):
                 dictionary[cookie.name] = cookie.value
         return dictionary
 
     def __contains__(self, name):
         try:
-            return super(RequestsCookieJar, self).__contains__(name)
+            return super().__contains__(name)
         except CookieConflictError:
             return True
 
@@ -341,9 +347,13 @@ class RequestsCookieJar(cookielib.CookieJar, MutableMapping):
         remove_cookie_by_name(self, name)
 
     def set_cookie(self, cookie, *args, **kwargs):
-        if hasattr(cookie.value, 'startswith') and cookie.value.startswith('"') and cookie.value.endswith('"'):
-            cookie.value = cookie.value.replace('\\"', '')
-        return super(RequestsCookieJar, self).set_cookie(cookie, *args, **kwargs)
+        if (
+            hasattr(cookie.value, "startswith")
+            and cookie.value.startswith('"')
+            and cookie.value.endswith('"')
+        ):
+            cookie.value = cookie.value.replace('\\"', "")
+        return super().set_cookie(cookie, *args, **kwargs)
 
     def update(self, other):
         """Updates this jar with cookies from another CookieJar or dict-like"""
@@ -351,7 +361,7 @@ class RequestsCookieJar(cookielib.CookieJar, MutableMapping):
             for cookie in other:
                 self.set_cookie(copy.copy(cookie))
         else:
-            super(RequestsCookieJar, self).update(other)
+            super().update(other)
 
     def _find(self, name, domain=None, path=None):
         """Requests uses this method internally to get cookie values.
@@ -371,7 +381,7 @@ class RequestsCookieJar(cookielib.CookieJar, MutableMapping):
                     if path is None or cookie.path == path:
                         return cookie.value
 
-        raise KeyError('name=%r, domain=%r, path=%r' % (name, domain, path))
+        raise KeyError(f"name={name!r}, domain={domain!r}, path={path!r}")
 
     def _find_no_duplicates(self, name, domain=None, path=None):
         """Both ``__get_item__`` and ``get`` call this function: it's never
@@ -390,25 +400,29 @@ class RequestsCookieJar(cookielib.CookieJar, MutableMapping):
             if cookie.name == name:
                 if domain is None or cookie.domain == domain:
                     if path is None or cookie.path == path:
-                        if toReturn is not None:  # if there are multiple cookies that meet passed in criteria
-                            raise CookieConflictError('There are multiple cookies with name, %r' % (name))
-                        toReturn = cookie.value  # we will eventually return this as long as no cookie conflict
+                        if toReturn is not None:
+                            # if there are multiple cookies that meet passed in criteria
+                            raise CookieConflictError(
+                                f"There are multiple cookies with name, {name!r}"
+                            )
+                        # we will eventually return this as long as no cookie conflict
+                        toReturn = cookie.value
 
         if toReturn:
             return toReturn
-        raise KeyError('name=%r, domain=%r, path=%r' % (name, domain, path))
+        raise KeyError(f"name={name!r}, domain={domain!r}, path={path!r}")
 
     def __getstate__(self):
         """Unlike a normal CookieJar, this class is pickleable."""
         state = self.__dict__.copy()
         # remove the unpickleable RLock object
-        state.pop('_cookies_lock')
+        state.pop("_cookies_lock")
         return state
 
     def __setstate__(self, state):
         """Unlike a normal CookieJar, this class is pickleable."""
         self.__dict__.update(state)
-        if '_cookies_lock' not in self.__dict__:
+        if "_cookies_lock" not in self.__dict__:
             self._cookies_lock = threading.RLock()
 
     def copy(self):
@@ -427,7 +441,7 @@ def _copy_cookie_jar(jar):
     if jar is None:
         return None
 
-    if hasattr(jar, 'copy'):
+    if hasattr(jar, "copy"):
         # We're dealing with an instance of RequestsCookieJar
         return jar.copy()
     # We're dealing with a generic CookieJar instance
@@ -445,31 +459,32 @@ def create_cookie(name, value, **kwargs):
     and sent on every request (this is sometimes called a "supercookie").
     """
     result = {
-        'version': 0,
-        'name': name,
-        'value': value,
-        'port': None,
-        'domain': '',
-        'path': '/',
-        'secure': False,
-        'expires': None,
-        'discard': True,
-        'comment': None,
-        'comment_url': None,
-        'rest': {'HttpOnly': None},
-        'rfc2109': False,
+        "version": 0,
+        "name": name,
+        "value": value,
+        "port": None,
+        "domain": "",
+        "path": "/",
+        "secure": False,
+        "expires": None,
+        "discard": True,
+        "comment": None,
+        "comment_url": None,
+        "rest": {"HttpOnly": None},
+        "rfc2109": False,
     }
 
     badargs = set(kwargs) - set(result)
     if badargs:
-        err = 'create_cookie() got unexpected keyword arguments: %s'
-        raise TypeError(err % list(badargs))
+        raise TypeError(
+            f"create_cookie() got unexpected keyword arguments: {list(badargs)}"
+        )
 
     result.update(kwargs)
-    result['port_specified'] = bool(result['port'])
-    result['domain_specified'] = bool(result['domain'])
-    result['domain_initial_dot'] = result['domain'].startswith('.')
-    result['path_specified'] = bool(result['path'])
+    result["port_specified"] = bool(result["port"])
+    result["domain_specified"] = bool(result["domain"])
+    result["domain_initial_dot"] = result["domain"].startswith(".")
+    result["path_specified"] = bool(result["path"])
 
     return cookielib.Cookie(**result)
 
@@ -478,30 +493,28 @@ def morsel_to_cookie(morsel):
     """Convert a Morsel object into a Cookie containing the one k/v pair."""
 
     expires = None
-    if morsel['max-age']:
+    if morsel["max-age"]:
         try:
-            expires = int(time.time() + int(morsel['max-age']))
+            expires = int(time.time() + int(morsel["max-age"]))
         except ValueError:
-            raise TypeError('max-age: %s must be integer' % morsel['max-age'])
-    elif morsel['expires']:
-        time_template = '%a, %d-%b-%Y %H:%M:%S GMT'
-        expires = calendar.timegm(
-            time.strptime(morsel['expires'], time_template)
-        )
+            raise TypeError(f"max-age: {morsel['max-age']} must be integer")
+    elif morsel["expires"]:
+        time_template = "%a, %d-%b-%Y %H:%M:%S GMT"
+        expires = calendar.timegm(time.strptime(morsel["expires"], time_template))
     return create_cookie(
-        comment=morsel['comment'],
-        comment_url=bool(morsel['comment']),
+        comment=morsel["comment"],
+        comment_url=bool(morsel["comment"]),
         discard=False,
-        domain=morsel['domain'],
+        domain=morsel["domain"],
         expires=expires,
         name=morsel.key,
-        path=morsel['path'],
+        path=morsel["path"],
         port=None,
-        rest={'HttpOnly': morsel['httponly']},
+        rest={"HttpOnly": morsel["httponly"]},
         rfc2109=False,
-        secure=bool(morsel['secure']),
+        secure=bool(morsel["secure"]),
         value=morsel.value,
-        version=morsel['version'] or 0,
+        version=morsel["version"] or 0,
     )
 
 
@@ -534,11 +547,10 @@ def merge_cookies(cookiejar, cookies):
     :rtype: CookieJar
     """
     if not isinstance(cookiejar, cookielib.CookieJar):
-        raise ValueError('You can only merge into CookieJar')
+        raise ValueError("You can only merge into CookieJar")
 
     if isinstance(cookies, dict):
-        cookiejar = cookiejar_from_dict(
-            cookies, cookiejar=cookiejar, overwrite=False)
+        cookiejar = cookiejar_from_dict(cookies, cookiejar=cookiejar, overwrite=False)
     elif isinstance(cookies, cookielib.CookieJar):
         try:
             cookiejar.update(cookies)
diff --git a/lib/requests/exceptions.py b/lib/requests/exceptions.py
index 79697635..e1cedf88 100644
--- a/lib/requests/exceptions.py
+++ b/lib/requests/exceptions.py
@@ -1,5 +1,3 @@
-# -*- coding: utf-8 -*-
-
 """
 requests.exceptions
 ~~~~~~~~~~~~~~~~~~~
@@ -18,13 +16,12 @@ class RequestException(IOError):
 
     def __init__(self, *args, **kwargs):
         """Initialize RequestException with `request` and `response` objects."""
-        response = kwargs.pop('response', None)
+        response = kwargs.pop("response", None)
         self.response = response
-        self.request = kwargs.pop('request', None)
-        if (response is not None and not self.request and
-                hasattr(response, 'request')):
+        self.request = kwargs.pop("request", None)
+        if response is not None and not self.request and hasattr(response, "request"):
             self.request = self.response.request
-        super(RequestException, self).__init__(*args, **kwargs)
+        super().__init__(*args, **kwargs)
 
 
 class InvalidJSONError(RequestException):
@@ -34,6 +31,16 @@ class InvalidJSONError(RequestException):
 class JSONDecodeError(InvalidJSONError, CompatJSONDecodeError):
     """Couldn't decode the text into json"""
 
+    def __init__(self, *args, **kwargs):
+        """
+        Construct the JSONDecodeError instance first with all
+        args. Then use it's args to construct the IOError so that
+        the json specific args aren't used as IOError specific args
+        and the error message from JSONDecodeError is preserved.
+        """
+        CompatJSONDecodeError.__init__(self, *args)
+        InvalidJSONError.__init__(self, *self.args, **kwargs)
+
 
 class HTTPError(RequestException):
     """An HTTP error occurred."""
@@ -118,6 +125,7 @@ class RetryError(RequestException):
 class UnrewindableBodyError(RequestException):
     """Requests encountered an error when trying to rewind a body."""
 
+
 # Warnings
 
 
diff --git a/lib/requests/help.py b/lib/requests/help.py
index 4cd6389f..8fbcd656 100644
--- a/lib/requests/help.py
+++ b/lib/requests/help.py
@@ -1,10 +1,9 @@
 """Module containing bug report helper(s)."""
-from __future__ import print_function
 
 import json
 import platform
-import sys
 import ssl
+import sys
 
 import idna
 import urllib3
@@ -28,16 +27,16 @@ except ImportError:
     OpenSSL = None
     cryptography = None
 else:
-    import OpenSSL
     import cryptography
+    import OpenSSL
 
 
 def _implementation():
     """Return a dict with the Python implementation and version.
 
     Provide both the name and the version of the Python implementation
-    currently running. For example, on CPython 2.7.5 it will return
-    {'name': 'CPython', 'version': '2.7.5'}.
+    currently running. For example, on CPython 3.10.3 it will return
+    {'name': 'CPython', 'version': '3.10.3'}.
 
     This function works best on CPython and PyPy: in particular, it probably
     doesn't work for Jython or IronPython. Future investigation should be done
@@ -45,83 +44,83 @@ def _implementation():
     """
     implementation = platform.python_implementation()
 
-    if implementation == 'CPython':
+    if implementation == "CPython":
         implementation_version = platform.python_version()
-    elif implementation == 'PyPy':
-        implementation_version = '%s.%s.%s' % (sys.pypy_version_info.major,
-                                               sys.pypy_version_info.minor,
-                                               sys.pypy_version_info.micro)
-        if sys.pypy_version_info.releaselevel != 'final':
-            implementation_version = ''.join([
-                implementation_version, sys.pypy_version_info.releaselevel
-            ])
-    elif implementation == 'Jython':
+    elif implementation == "PyPy":
+        implementation_version = "{}.{}.{}".format(
+            sys.pypy_version_info.major,
+            sys.pypy_version_info.minor,
+            sys.pypy_version_info.micro,
+        )
+        if sys.pypy_version_info.releaselevel != "final":
+            implementation_version = "".join(
+                [implementation_version, sys.pypy_version_info.releaselevel]
+            )
+    elif implementation == "Jython":
         implementation_version = platform.python_version()  # Complete Guess
-    elif implementation == 'IronPython':
+    elif implementation == "IronPython":
         implementation_version = platform.python_version()  # Complete Guess
     else:
-        implementation_version = 'Unknown'
+        implementation_version = "Unknown"
 
-    return {'name': implementation, 'version': implementation_version}
+    return {"name": implementation, "version": implementation_version}
 
 
 def info():
     """Generate information for a bug report."""
     try:
         platform_info = {
-            'system': platform.system(),
-            'release': platform.release(),
+            "system": platform.system(),
+            "release": platform.release(),
         }
-    except IOError:
+    except OSError:
         platform_info = {
-            'system': 'Unknown',
-            'release': 'Unknown',
+            "system": "Unknown",
+            "release": "Unknown",
         }
 
     implementation_info = _implementation()
-    urllib3_info = {'version': urllib3.__version__}
-    charset_normalizer_info = {'version': None}
-    chardet_info = {'version': None}
+    urllib3_info = {"version": urllib3.__version__}
+    charset_normalizer_info = {"version": None}
+    chardet_info = {"version": None}
     if charset_normalizer:
-        charset_normalizer_info = {'version': charset_normalizer.__version__}
+        charset_normalizer_info = {"version": charset_normalizer.__version__}
     if chardet:
-        chardet_info = {'version': chardet.__version__}
+        chardet_info = {"version": chardet.__version__}
 
     pyopenssl_info = {
-        'version': None,
-        'openssl_version': '',
+        "version": None,
+        "openssl_version": "",
     }
     if OpenSSL:
         pyopenssl_info = {
-            'version': OpenSSL.__version__,
-            'openssl_version': '%x' % OpenSSL.SSL.OPENSSL_VERSION_NUMBER,
+            "version": OpenSSL.__version__,
+            "openssl_version": f"{OpenSSL.SSL.OPENSSL_VERSION_NUMBER:x}",
         }
     cryptography_info = {
-        'version': getattr(cryptography, '__version__', ''),
+        "version": getattr(cryptography, "__version__", ""),
     }
     idna_info = {
-        'version': getattr(idna, '__version__', ''),
+        "version": getattr(idna, "__version__", ""),
     }
 
     system_ssl = ssl.OPENSSL_VERSION_NUMBER
-    system_ssl_info = {
-        'version': '%x' % system_ssl if system_ssl is not None else ''
-    }
+    system_ssl_info = {"version": f"{system_ssl:x}" if system_ssl is not None else ""}
 
     return {
-        'platform': platform_info,
-        'implementation': implementation_info,
-        'system_ssl': system_ssl_info,
-        'using_pyopenssl': pyopenssl is not None,
-        'using_charset_normalizer': chardet is None,
-        'pyOpenSSL': pyopenssl_info,
-        'urllib3': urllib3_info,
-        'chardet': chardet_info,
-        'charset_normalizer': charset_normalizer_info,
-        'cryptography': cryptography_info,
-        'idna': idna_info,
-        'requests': {
-            'version': requests_version,
+        "platform": platform_info,
+        "implementation": implementation_info,
+        "system_ssl": system_ssl_info,
+        "using_pyopenssl": pyopenssl is not None,
+        "using_charset_normalizer": chardet is None,
+        "pyOpenSSL": pyopenssl_info,
+        "urllib3": urllib3_info,
+        "chardet": chardet_info,
+        "charset_normalizer": charset_normalizer_info,
+        "cryptography": cryptography_info,
+        "idna": idna_info,
+        "requests": {
+            "version": requests_version,
         },
     }
 
@@ -131,5 +130,5 @@ def main():
     print(json.dumps(info(), sort_keys=True, indent=2))
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     main()
diff --git a/lib/requests/hooks.py b/lib/requests/hooks.py
index 7a51f212..d181ba2e 100644
--- a/lib/requests/hooks.py
+++ b/lib/requests/hooks.py
@@ -1,5 +1,3 @@
-# -*- coding: utf-8 -*-
-
 """
 requests.hooks
 ~~~~~~~~~~~~~~
@@ -11,12 +9,13 @@ Available hooks:
 ``response``:
     The response generated from a Request.
 """
-HOOKS = ['response']
+HOOKS = ["response"]
 
 
 def default_hooks():
     return {event: [] for event in HOOKS}
 
+
 # TODO: response is the only one
 
 
@@ -25,7 +24,7 @@ def dispatch_hook(key, hooks, hook_data, **kwargs):
     hooks = hooks or {}
     hooks = hooks.get(key)
     if hooks:
-        if hasattr(hooks, '__call__'):
+        if hasattr(hooks, "__call__"):
             hooks = [hooks]
         for hook in hooks:
             _hook_data = hook(hook_data, **kwargs)
diff --git a/lib/requests/models.py b/lib/requests/models.py
index dfbea854..3cd49f5b 100644
--- a/lib/requests/models.py
+++ b/lib/requests/models.py
@@ -1,5 +1,3 @@
-# -*- coding: utf-8 -*-
-
 """
 requests.models
 ~~~~~~~~~~~~~~~
@@ -8,48 +6,72 @@ This module contains the primary objects that power Requests.
 """
 
 import datetime
-import sys
 
 # Import encoding now, to avoid implicit import later.
 # Implicit import within threads may cause LookupError when standard library is in a ZIP,
 # such as in Embedded Python. See https://github.com/psf/requests/issues/3578.
-import encodings.idna
+import encodings.idna  # noqa: F401
+from io import UnsupportedOperation
 
+from urllib3.exceptions import (
+    DecodeError,
+    LocationParseError,
+    ProtocolError,
+    ReadTimeoutError,
+    SSLError,
+)
 from urllib3.fields import RequestField
 from urllib3.filepost import encode_multipart_formdata
 from urllib3.util import parse_url
-from urllib3.exceptions import (
-    DecodeError, ReadTimeoutError, ProtocolError, LocationParseError)
 
-from io import UnsupportedOperation
-from .hooks import default_hooks
-from .structures import CaseInsensitiveDict
-
-from .auth import HTTPBasicAuth
-from .cookies import cookiejar_from_dict, get_cookie_header, _copy_cookie_jar
-from .exceptions import (
-    HTTPError, MissingSchema, InvalidURL, ChunkedEncodingError,
-    ContentDecodingError, ConnectionError, StreamConsumedError,
-    InvalidJSONError)
-from .exceptions import JSONDecodeError as RequestsJSONDecodeError
 from ._internal_utils import to_native_string, unicode_is_ascii
-from .utils import (
-    guess_filename, get_auth_from_url, requote_uri,
-    stream_decode_response_unicode, to_key_val_list, parse_header_links,
-    iter_slices, guess_json_utf, super_len, check_header_validity)
+from .auth import HTTPBasicAuth
 from .compat import (
-    Callable, Mapping,
-    cookielib, urlunparse, urlsplit, urlencode, str, bytes,
-    is_py2, chardet, builtin_str, basestring, JSONDecodeError)
+    Callable,
+    JSONDecodeError,
+    Mapping,
+    basestring,
+    builtin_str,
+    chardet,
+    cookielib,
+)
 from .compat import json as complexjson
+from .compat import urlencode, urlsplit, urlunparse
+from .cookies import _copy_cookie_jar, cookiejar_from_dict, get_cookie_header
+from .exceptions import (
+    ChunkedEncodingError,
+    ConnectionError,
+    ContentDecodingError,
+    HTTPError,
+    InvalidJSONError,
+    InvalidURL,
+)
+from .exceptions import JSONDecodeError as RequestsJSONDecodeError
+from .exceptions import MissingSchema
+from .exceptions import SSLError as RequestsSSLError
+from .exceptions import StreamConsumedError
+from .hooks import default_hooks
 from .status_codes import codes
+from .structures import CaseInsensitiveDict
+from .utils import (
+    check_header_validity,
+    get_auth_from_url,
+    guess_filename,
+    guess_json_utf,
+    iter_slices,
+    parse_header_links,
+    requote_uri,
+    stream_decode_response_unicode,
+    super_len,
+    to_key_val_list,
+)
 
 #: The set of HTTP status codes that indicate an automatically
 #: processable redirect.
 REDIRECT_STATI = (
-    codes.moved,               # 301
-    codes.found,               # 302
-    codes.other,               # 303
+    codes.moved,  # 301
+    codes.found,  # 302
+    codes.other,  # 303
     codes.temporary_redirect,  # 307
     codes.permanent_redirect,  # 308
 )
@@ -59,7 +81,7 @@ CONTENT_CHUNK_SIZE = 10 * 1024
 ITER_CHUNK_SIZE = 512
 
 
-class RequestEncodingMixin(object):
+class RequestEncodingMixin:
     @property
     def path_url(self):
         """Build the path URL to use."""
@@ -70,16 +92,16 @@ class RequestEncodingMixin(object):
 
         path = p.path
         if not path:
-            path = '/'
+            path = "/"
 
         url.append(path)
 
         query = p.query
         if query:
-            url.append('?')
+            url.append("?")
             url.append(query)
 
-        return ''.join(url)
+        return "".join(url)
 
     @staticmethod
     def _encode_params(data):
@@ -92,18 +114,21 @@ class RequestEncodingMixin(object):
 
         if isinstance(data, (str, bytes)):
             return data
-        elif hasattr(data, 'read'):
+        elif hasattr(data, "read"):
             return data
-        elif hasattr(data, '__iter__'):
+        elif hasattr(data, "__iter__"):
             result = []
             for k, vs in to_key_val_list(data):
-                if isinstance(vs, basestring) or not hasattr(vs, '__iter__'):
+                if isinstance(vs, basestring) or not hasattr(vs, "__iter__"):
                     vs = [vs]
                 for v in vs:
                     if v is not None:
                         result.append(
-                            (k.encode('utf-8') if isinstance(k, str) else k,
-                             v.encode('utf-8') if isinstance(v, str) else v))
+                            (
+                                k.encode("utf-8") if isinstance(k, str) else k,
+                                v.encode("utf-8") if isinstance(v, str) else v,
+                            )
+                        )
             return urlencode(result, doseq=True)
         else:
             return data
@@ -118,7 +143,7 @@ class RequestEncodingMixin(object):
         The tuples may be 2-tuples (filename, fileobj), 3-tuples (filename, fileobj, contentype)
         or 4-tuples (filename, fileobj, contentype, custom_headers).
         """
-        if (not files):
+        if not files:
             raise ValueError("Files must be provided.")
         elif isinstance(data, basestring):
             raise ValueError("Data must not be a string.")
@@ -128,7 +153,7 @@ class RequestEncodingMixin(object):
         files = to_key_val_list(files or {})
 
         for field, val in fields:
-            if isinstance(val, basestring) or not hasattr(val, '__iter__'):
+            if isinstance(val, basestring) or not hasattr(val, "__iter__"):
                 val = [val]
             for v in val:
                 if v is not None:
@@ -137,8 +162,13 @@ class RequestEncodingMixin(object):
                         v = str(v)
 
                     new_fields.append(
-                        (field.decode('utf-8') if isinstance(field, bytes) else field,
-                         v.encode('utf-8') if isinstance(v, str) else v))
+                        (
+                            field.decode("utf-8")
+                            if isinstance(field, bytes)
+                            else field,
+                            v.encode("utf-8") if isinstance(v, str) else v,
+                        )
+                    )
 
         for (k, v) in files:
             # support for explicit filename
@@ -157,7 +187,7 @@ class RequestEncodingMixin(object):
 
             if isinstance(fp, (str, bytes, bytearray)):
                 fdata = fp
-            elif hasattr(fp, 'read'):
+            elif hasattr(fp, "read"):
                 fdata = fp.read()
             elif fp is None:
                 continue
@@ -173,16 +203,16 @@ class RequestEncodingMixin(object):
         return body, content_type
 
 
-class RequestHooksMixin(object):
+class RequestHooksMixin:
     def register_hook(self, event, hook):
         """Properly register a hook."""
 
         if event not in self.hooks:
-            raise ValueError('Unsupported event specified, with event name "%s"' % (event))
+            raise ValueError(f'Unsupported event specified, with event name "{event}"')
 
         if isinstance(hook, Callable):
             self.hooks[event].append(hook)
-        elif hasattr(hook, '__iter__'):
+        elif hasattr(hook, "__iter__"):
             self.hooks[event].extend(h for h in hook if isinstance(h, Callable))
 
     def deregister_hook(self, event, hook):
@@ -225,9 +255,19 @@ class Request(RequestHooksMixin):
       <PreparedRequest [GET]>
     """
 
-    def __init__(self,
-            method=None, url=None, headers=None, files=None, data=None,
-            params=None, auth=None, cookies=None, hooks=None, json=None):
+    def __init__(
+        self,
+        method=None,
+        url=None,
+        headers=None,
+        files=None,
+        data=None,
+        params=None,
+        auth=None,
+        cookies=None,
+        hooks=None,
+        json=None,
+    ):
 
         # Default empty dicts for dict params.
         data = [] if data is None else data
@@ -251,7 +291,7 @@ class Request(RequestHooksMixin):
         self.cookies = cookies
 
     def __repr__(self):
-        return '<Request [%s]>' % (self.method)
+        return f"<Request [{self.method}]>"
 
     def prepare(self):
         """Constructs a :class:`PreparedRequest <PreparedRequest>` for transmission and returns it."""
@@ -309,9 +349,19 @@ class PreparedRequest(RequestEncodingMixin, RequestHooksMixin):
         #: integer denoting starting position of a readable file-like body.
         self._body_position = None
 
-    def prepare(self,
-            method=None, url=None, headers=None, files=None, data=None,
-            params=None, auth=None, cookies=None, hooks=None, json=None):
+    def prepare(
+        self,
+        method=None,
+        url=None,
+        headers=None,
+        files=None,
+        data=None,
+        params=None,
+        auth=None,
+        cookies=None,
+        hooks=None,
+        json=None,
+    ):
         """Prepares the entire request with the given parameters."""
 
         self.prepare_method(method)
@@ -328,7 +378,7 @@ class PreparedRequest(RequestEncodingMixin, RequestHooksMixin):
         self.prepare_hooks(hooks)
 
     def __repr__(self):
-        return '<PreparedRequest [%s]>' % (self.method)
+        return f"<PreparedRequest [{self.method}]>"
 
     def copy(self):
         p = PreparedRequest()
@@ -352,7 +402,7 @@ class PreparedRequest(RequestEncodingMixin, RequestHooksMixin):
         import idna
 
         try:
-            host = idna.encode(host, uts46=True).decode('utf-8')
+            host = idna.encode(host, uts46=True).decode("utf-8")
         except idna.IDNAError:
             raise UnicodeError
         return host
@@ -365,9 +415,9 @@ class PreparedRequest(RequestEncodingMixin, RequestHooksMixin):
         #: on python 3.x.
         #: https://github.com/psf/requests/pull/2238
         if isinstance(url, bytes):
-            url = url.decode('utf8')
+            url = url.decode("utf8")
         else:
-            url = unicode(url) if is_py2 else str(url)
+            url = str(url)
 
         # Remove leading whitespaces from url
         url = url.lstrip()
@@ -375,7 +425,7 @@ class PreparedRequest(RequestEncodingMixin, RequestHooksMixin):
         # Don't do any URL preparation for non-HTTP schemes like `mailto`,
         # `data` etc to work around exceptions from `url_parse`, which
         # handles RFC 3986 only.
-        if ':' in url and not url.lower().startswith('http'):
+        if ":" in url and not url.lower().startswith("http"):
             self.url = url
             return
 
@@ -386,13 +436,13 @@ class PreparedRequest(RequestEncodingMixin, RequestHooksMixin):
             raise InvalidURL(*e.args)
 
         if not scheme:
-            error = ("Invalid URL {0!r}: No scheme supplied. Perhaps you meant http://{0}?")
-            error = error.format(to_native_string(url, 'utf8'))
-
-            raise MissingSchema(error)
+            raise MissingSchema(
+                f"Invalid URL {url!r}: No scheme supplied. "
+                f"Perhaps you meant http://{url}?"
+            )
 
         if not host:
-            raise InvalidURL("Invalid URL %r: No host supplied" % url)
+            raise InvalidURL(f"Invalid URL {url!r}: No host supplied")
 
         # In general, we want to try IDNA encoding the hostname if the string contains
         # non-ASCII characters. This allows users to automatically get the correct IDNA
@@ -402,33 +452,21 @@ class PreparedRequest(RequestEncodingMixin, RequestHooksMixin):
             try:
                 host = self._get_idna_encoded_host(host)
             except UnicodeError:
-                raise InvalidURL('URL has an invalid label.')
-        elif host.startswith((u'*', u'.')):
-            raise InvalidURL('URL has an invalid label.')
+                raise InvalidURL("URL has an invalid label.")
+        elif host.startswith(("*", ".")):
+            raise InvalidURL("URL has an invalid label.")
 
         # Carefully reconstruct the network location
-        netloc = auth or ''
+        netloc = auth or ""
         if netloc:
-            netloc += '@'
+            netloc += "@"
         netloc += host
         if port:
-            netloc += ':' + str(port)
+            netloc += f":{port}"
 
         # Bare domains aren't valid URLs.
         if not path:
-            path = '/'
-
-        if is_py2:
-            if isinstance(scheme, str):
-                scheme = scheme.encode('utf-8')
-            if isinstance(netloc, str):
-                netloc = netloc.encode('utf-8')
-            if isinstance(path, str):
-                path = path.encode('utf-8')
-            if isinstance(query, str):
-                query = query.encode('utf-8')
-            if isinstance(fragment, str):
-                fragment = fragment.encode('utf-8')
+            path = "/"
 
         if isinstance(params, (str, bytes)):
             params = to_native_string(params)
@@ -436,7 +474,7 @@ class PreparedRequest(RequestEncodingMixin, RequestHooksMixin):
         enc_params = self._encode_params(params)
         if enc_params:
             if query:
-                query = '%s&%s' % (query, enc_params)
+                query = f"{query}&{enc_params}"
             else:
                 query = enc_params
 
@@ -467,7 +505,7 @@ class PreparedRequest(RequestEncodingMixin, RequestHooksMixin):
         if not data and json is not None:
             # urllib3 requires a bytes-like body. Python 2's json.dumps
             # provides this natively, but Python 3 gives a Unicode string.
-            content_type = 'application/json'
+            content_type = "application/json"
 
             try:
                 body = complexjson.dumps(json, allow_nan=False)
@@ -475,12 +513,14 @@ class PreparedRequest(RequestEncodingMixin, RequestHooksMixin):
                 raise InvalidJSONError(ve, request=self)
 
             if not isinstance(body, bytes):
-                body = body.encode('utf-8')
+                body = body.encode("utf-8")
 
-        is_stream = all([
-            hasattr(data, '__iter__'),
-            not isinstance(data, (basestring, list, tuple, Mapping))
-        ])
+        is_stream = all(
+            [
+                hasattr(data, "__iter__"),
+                not isinstance(data, (basestring, list, tuple, Mapping)),
+            ]
+        )
 
         if is_stream:
             try:
@@ -490,24 +530,26 @@ class PreparedRequest(RequestEncodingMixin, RequestHooksMixin):
 
             body = data
 
-            if getattr(body, 'tell', None) is not None:
+            if getattr(body, "tell", None) is not None:
                 # Record the current file position before reading.
                 # This will allow us to rewind a file in the event
                 # of a redirect.
                 try:
                     self._body_position = body.tell()
-                except (IOError, OSError):
+                except OSError:
                     # This differentiates from None, allowing us to catch
                     # a failed `tell()` later when trying to rewind the body
                     self._body_position = object()
 
             if files:
-                raise NotImplementedError('Streamed bodies and files are mutually exclusive.')
+                raise NotImplementedError(
+                    "Streamed bodies and files are mutually exclusive."
+                )
 
             if length:
-                self.headers['Content-Length'] = builtin_str(length)
+                self.headers["Content-Length"] = builtin_str(length)
             else:
-                self.headers['Transfer-Encoding'] = 'chunked'
+                self.headers["Transfer-Encoding"] = "chunked"
         else:
             # Multi-part file uploads.
             if files:
@@ -515,16 +557,16 @@ class PreparedRequest(RequestEncodingMixin, RequestHooksMixin):
             else:
                 if data:
                     body = self._encode_params(data)
-                    if isinstance(data, basestring) or hasattr(data, 'read'):
+                    if isinstance(data, basestring) or hasattr(data, "read"):
                         content_type = None
                     else:
-                        content_type = 'application/x-www-form-urlencoded'
+                        content_type = "application/x-www-form-urlencoded"
 
             self.prepare_content_length(body)
 
             # Add content-type if it wasn't explicitly provided.
-            if content_type and ('content-type' not in self.headers):
-                self.headers['Content-Type'] = content_type
+            if content_type and ("content-type" not in self.headers):
+                self.headers["Content-Type"] = content_type
 
         self.body = body
 
@@ -535,13 +577,16 @@ class PreparedRequest(RequestEncodingMixin, RequestHooksMixin):
             if length:
                 # If length exists, set it. Otherwise, we fallback
                 # to Transfer-Encoding: chunked.
-                self.headers['Content-Length'] = builtin_str(length)
-        elif self.method not in ('GET', 'HEAD') and self.headers.get('Content-Length') is None:
+                self.headers["Content-Length"] = builtin_str(length)
+        elif (
+            self.method not in ("GET", "HEAD")
+            and self.headers.get("Content-Length") is None
+        ):
             # Set Content-Length to 0 for methods that can have a body
             # but don't provide one. (i.e. not GET or HEAD)
-            self.headers['Content-Length'] = '0'
+            self.headers["Content-Length"] = "0"
 
-    def prepare_auth(self, auth, url=''):
+    def prepare_auth(self, auth, url=""):
         """Prepares the given HTTP auth data."""
 
         # If no Auth is explicitly provided, extract it from the URL first.
@@ -581,7 +626,7 @@ class PreparedRequest(RequestEncodingMixin, RequestHooksMixin):
 
         cookie_header = get_cookie_header(self._cookies, self)
         if cookie_header is not None:
-            self.headers['Cookie'] = cookie_header
+            self.headers["Cookie"] = cookie_header
 
     def prepare_hooks(self, hooks):
         """Prepares the given hooks."""
@@ -593,14 +638,22 @@ class PreparedRequest(RequestEncodingMixin, RequestHooksMixin):
             self.register_hook(event, hooks[event])
 
 
-class Response(object):
+class Response:
     """The :class:`Response <Response>` object, which contains a
     server's response to an HTTP request.
     """
 
     __attrs__ = [
-        '_content', 'status_code', 'headers', 'url', 'history',
-        'encoding', 'reason', 'cookies', 'elapsed', 'request'
+        "_content",
+        "status_code",
+        "headers",
+        "url",
+        "history",
+        "encoding",
+        "reason",
+        "cookies",
+        "elapsed",
+        "request",
     ]
 
     def __init__(self):
@@ -669,11 +722,11 @@ class Response(object):
             setattr(self, name, value)
 
         # pickled objects do not have .raw
-        setattr(self, '_content_consumed', True)
-        setattr(self, 'raw', None)
+        setattr(self, "_content_consumed", True)
+        setattr(self, "raw", None)
 
     def __repr__(self):
-        return '<Response [%s]>' % (self.status_code)
+        return f"<Response [{self.status_code}]>"
 
     def __bool__(self):
         """Returns True if :attr:`status_code` is less than 400.
@@ -719,12 +772,15 @@ class Response(object):
         """True if this Response is a well-formed HTTP redirect that could have
         been processed automatically (by :meth:`Session.resolve_redirects`).
         """
-        return ('location' in self.headers and self.status_code in REDIRECT_STATI)
+        return "location" in self.headers and self.status_code in REDIRECT_STATI
 
     @property
     def is_permanent_redirect(self):
         """True if this Response one of the permanent versions of redirect."""
-        return ('location' in self.headers and self.status_code in (codes.moved_permanently, codes.permanent_redirect))
+        return "location" in self.headers and self.status_code in (
+            codes.moved_permanently,
+            codes.permanent_redirect,
+        )
 
     @property
     def next(self):
@@ -734,7 +790,7 @@ class Response(object):
     @property
     def apparent_encoding(self):
         """The apparent encoding, provided by the charset_normalizer or chardet libraries."""
-        return chardet.detect(self.content)['encoding']
+        return chardet.detect(self.content)["encoding"]
 
     def iter_content(self, chunk_size=1, decode_unicode=False):
         """Iterates over the response data.  When stream=True is set on the
@@ -755,16 +811,17 @@ class Response(object):
 
         def generate():
             # Special case for urllib3.
-            if hasattr(self.raw, 'stream'):
+            if hasattr(self.raw, "stream"):
                 try:
-                    for chunk in self.raw.stream(chunk_size, decode_content=True):
-                        yield chunk
+                    yield from self.raw.stream(chunk_size, decode_content=True)
                 except ProtocolError as e:
                     raise ChunkedEncodingError(e)
                 except DecodeError as e:
                     raise ContentDecodingError(e)
                 except ReadTimeoutError as e:
                     raise ConnectionError(e)
+                except SSLError as e:
+                    raise RequestsSSLError(e)
             else:
                 # Standard file-like object.
                 while True:
@@ -778,7 +835,9 @@ class Response(object):
         if self._content_consumed and isinstance(self._content, bool):
             raise StreamConsumedError()
         elif chunk_size is not None and not isinstance(chunk_size, int):
-            raise TypeError("chunk_size must be an int, it is instead a %s." % type(chunk_size))
+            raise TypeError(
+                f"chunk_size must be an int, it is instead a {type(chunk_size)}."
+            )
         # simulate reading small chunks of the content
         reused_chunks = iter_slices(self._content, chunk_size)
 
@@ -791,7 +850,9 @@ class Response(object):
 
         return chunks
 
-    def iter_lines(self, chunk_size=ITER_CHUNK_SIZE, decode_unicode=False, delimiter=None):
+    def iter_lines(
+        self, chunk_size=ITER_CHUNK_SIZE, decode_unicode=False, delimiter=None
+    ):
         """Iterates over the response data, one line at a time.  When
         stream=True is set on the request, this avoids reading the
         content at once into memory for large responses.
@@ -801,7 +862,9 @@ class Response(object):
 
         pending = None
 
-        for chunk in self.iter_content(chunk_size=chunk_size, decode_unicode=decode_unicode):
+        for chunk in self.iter_content(
+            chunk_size=chunk_size, decode_unicode=decode_unicode
+        ):
 
             if pending is not None:
                 chunk = pending + chunk
@@ -816,8 +879,7 @@ class Response(object):
             else:
                 pending = None
 
-            for line in lines:
-                yield line
+            yield from lines
 
         if pending is not None:
             yield pending
@@ -829,13 +891,12 @@ class Response(object):
         if self._content is False:
             # Read the contents.
             if self._content_consumed:
-                raise RuntimeError(
-                    'The content for this response was already consumed')
+                raise RuntimeError("The content for this response was already consumed")
 
             if self.status_code == 0 or self.raw is None:
                 self._content = None
             else:
-                self._content = b''.join(self.iter_content(CONTENT_CHUNK_SIZE)) or b''
+                self._content = b"".join(self.iter_content(CONTENT_CHUNK_SIZE)) or b""
 
         self._content_consumed = True
         # don't need to release the connection; that's been handled by urllib3
@@ -860,7 +921,7 @@ class Response(object):
         encoding = self.encoding
 
         if not self.content:
-            return str('')
+            return ""
 
         # Fallback to auto-detected encoding.
         if self.encoding is None:
@@ -868,7 +929,7 @@ class Response(object):
 
         # Decode unicode from given encoding.
         try:
-            content = str(self.content, encoding, errors='replace')
+            content = str(self.content, encoding, errors="replace")
         except (LookupError, TypeError):
             # A LookupError is raised if the encoding was not found which could
             # indicate a misspelling or similar mistake.
@@ -876,7 +937,7 @@ class Response(object):
             # A TypeError can be raised if encoding is None
             #
             # So we try blindly encoding.
-            content = str(self.content, errors='replace')
+            content = str(self.content, errors="replace")
 
         return content
 
@@ -896,65 +957,65 @@ class Response(object):
             encoding = guess_json_utf(self.content)
             if encoding is not None:
                 try:
-                    return complexjson.loads(
-                        self.content.decode(encoding), **kwargs
-                    )
+                    return complexjson.loads(self.content.decode(encoding), **kwargs)
                 except UnicodeDecodeError:
                     # Wrong UTF codec detected; usually because it's not UTF-8
                     # but some other 8-bit codec.  This is an RFC violation,
                     # and the server didn't bother to tell us what codec *was*
                     # used.
                     pass
+                except JSONDecodeError as e:
+                    raise RequestsJSONDecodeError(e.msg, e.doc, e.pos)
 
         try:
             return complexjson.loads(self.text, **kwargs)
         except JSONDecodeError as e:
             # Catch JSON-related errors and raise as requests.JSONDecodeError
             # This aliases json.JSONDecodeError and simplejson.JSONDecodeError
-            if is_py2: # e is a ValueError
-                raise RequestsJSONDecodeError(e.message)
-            else:
-                raise RequestsJSONDecodeError(e.msg, e.doc, e.pos)
+            raise RequestsJSONDecodeError(e.msg, e.doc, e.pos)
 
     @property
     def links(self):
         """Returns the parsed header links of the response, if any."""
 
-        header = self.headers.get('link')
+        header = self.headers.get("link")
 
-        # l = MultiDict()
-        l = {}
+        resolved_links = {}
 
         if header:
             links = parse_header_links(header)
 
             for link in links:
-                key = link.get('rel') or link.get('url')
-                l[key] = link
+                key = link.get("rel") or link.get("url")
+                resolved_links[key] = link
 
-        return l
+        return resolved_links
 
     def raise_for_status(self):
         """Raises :class:`HTTPError`, if one occurred."""
 
-        http_error_msg = ''
+        http_error_msg = ""
         if isinstance(self.reason, bytes):
             # We attempt to decode utf-8 first because some servers
             # choose to localize their reason strings. If the string
             # isn't utf-8, we fall back to iso-8859-1 for all other
             # encodings. (See PR #3538)
             try:
-                reason = self.reason.decode('utf-8')
+                reason = self.reason.decode("utf-8")
             except UnicodeDecodeError:
-                reason = self.reason.decode('iso-8859-1')
+                reason = self.reason.decode("iso-8859-1")
         else:
             reason = self.reason
 
         if 400 <= self.status_code < 500:
-            http_error_msg = u'%s Client Error: %s for url: %s' % (self.status_code, reason, self.url)
+            http_error_msg = (
+                f"{self.status_code} Client Error: {reason} for url: {self.url}"
+            )
 
         elif 500 <= self.status_code < 600:
-            http_error_msg = u'%s Server Error: %s for url: %s' % (self.status_code, reason, self.url)
+            http_error_msg = (
+                f"{self.status_code} Server Error: {reason} for url: {self.url}"
+            )
 
         if http_error_msg:
             raise HTTPError(http_error_msg, response=self)
@@ -968,6 +1029,6 @@ class Response(object):
         if not self._content_consumed:
             self.raw.close()
 
-        release_conn = getattr(self.raw, 'release_conn', None)
+        release_conn = getattr(self.raw, "release_conn", None)
         if release_conn is not None:
             release_conn()
diff --git a/lib/requests/packages.py b/lib/requests/packages.py
index 00196bff..77c45c9e 100644
--- a/lib/requests/packages.py
+++ b/lib/requests/packages.py
@@ -3,24 +3,26 @@ import sys
 try:
     import chardet
 except ImportError:
-    import charset_normalizer as chardet
     import warnings
 
-    warnings.filterwarnings('ignore', 'Trying to detect', module='charset_normalizer')
+    import charset_normalizer as chardet
+
+    warnings.filterwarnings("ignore", "Trying to detect", module="charset_normalizer")
 
 # This code exists for backwards compatibility reasons.
 # I don't like it either. Just look the other way. :)
 
-for package in ('urllib3', 'idna'):
+for package in ("urllib3", "idna"):
     locals()[package] = __import__(package)
     # This traversal is apparently necessary such that the identities are
     # preserved (requests.packages.urllib3.* is urllib3.*)
     for mod in list(sys.modules):
-        if mod == package or mod.startswith(package + '.'):
-            sys.modules['requests.packages.' + mod] = sys.modules[mod]
+        if mod == package or mod.startswith(f"{package}."):
+            sys.modules[f"requests.packages.{mod}"] = sys.modules[mod]
 
 target = chardet.__name__
 for mod in list(sys.modules):
-    if mod == target or mod.startswith(target + '.'):
-        sys.modules['requests.packages.' + target.replace(target, 'chardet')] = sys.modules[mod]
+    if mod == target or mod.startswith(f"{target}."):
+        target = target.replace(target, "chardet")
+        sys.modules[f"requests.packages.{target}"] = sys.modules[mod]
 # Kinda cool, though, right?
diff --git a/lib/requests/sessions.py b/lib/requests/sessions.py
index 3f59cab9..6cb3b4da 100644
--- a/lib/requests/sessions.py
+++ b/lib/requests/sessions.py
@@ -1,5 +1,3 @@
-# -*- coding: utf-8 -*-
-
 """
 requests.sessions
 ~~~~~~~~~~~~~~~~~
@@ -10,39 +8,52 @@ requests (cookies, auth, proxies).
 import os
 import sys
 import time
-from datetime import timedelta
 from collections import OrderedDict
+from datetime import timedelta
 
-from .auth import _basic_auth_str
-from .compat import cookielib, is_py3, urljoin, urlparse, Mapping
-from .cookies import (
-    cookiejar_from_dict, extract_cookies_to_jar, RequestsCookieJar, merge_cookies)
-from .models import Request, PreparedRequest, DEFAULT_REDIRECT_LIMIT
-from .hooks import default_hooks, dispatch_hook
 from ._internal_utils import to_native_string
-from .utils import to_key_val_list, default_headers, DEFAULT_PORTS
-from .exceptions import (
-    TooManyRedirects, InvalidSchema, ChunkedEncodingError, ContentDecodingError)
-
-from .structures import CaseInsensitiveDict
 from .adapters import HTTPAdapter
-
-from .utils import (
-    requote_uri, get_environ_proxies, get_netrc_auth, should_bypass_proxies,
-    get_auth_from_url, rewind_body, resolve_proxies
+from .auth import _basic_auth_str
+from .compat import Mapping, cookielib, urljoin, urlparse
+from .cookies import (
+    RequestsCookieJar,
+    cookiejar_from_dict,
+    extract_cookies_to_jar,
+    merge_cookies,
 )
-
-from .status_codes import codes
+from .exceptions import (
+    ChunkedEncodingError,
+    ContentDecodingError,
+    InvalidSchema,
+    TooManyRedirects,
+)
+from .hooks import default_hooks, dispatch_hook
 
 # formerly defined here, reexposed here for backward compatibility
-from .models import REDIRECT_STATI
+from .models import (  # noqa: F401
+    DEFAULT_REDIRECT_LIMIT,
+    REDIRECT_STATI,
+    PreparedRequest,
+    Request,
+)
+from .status_codes import codes
+from .structures import CaseInsensitiveDict
+from .utils import (  # noqa: F401
+    DEFAULT_PORTS,
+    default_headers,
+    get_auth_from_url,
+    get_environ_proxies,
+    get_netrc_auth,
+    requote_uri,
+    resolve_proxies,
+    rewind_body,
+    should_bypass_proxies,
+    to_key_val_list,
+)
 
 # Preferred clock, based on which one is more accurate on a given system.
-if sys.platform == 'win32':
-    try:  # Python 3.4+
-        preferred_clock = time.perf_counter
-    except AttributeError:  # Earlier than Python 3.
-        preferred_clock = time.clock
+if sys.platform == "win32":
+    preferred_clock = time.perf_counter
 else:
     preferred_clock = time.time
 
@@ -61,8 +72,7 @@ def merge_setting(request_setting, session_setting, dict_class=OrderedDict):
 
     # Bypass if not a dictionary (e.g. verify)
     if not (
-            isinstance(session_setting, Mapping) and
-            isinstance(request_setting, Mapping)
+        isinstance(session_setting, Mapping) and isinstance(request_setting, Mapping)
     ):
         return request_setting
 
@@ -84,17 +94,16 @@ def merge_hooks(request_hooks, session_hooks, dict_class=OrderedDict):
     This is necessary because when request_hooks == {'response': []}, the
     merge breaks Session hooks entirely.
     """
-    if session_hooks is None or session_hooks.get('response') == []:
+    if session_hooks is None or session_hooks.get("response") == []:
         return request_hooks
 
-    if request_hooks is None or request_hooks.get('response') == []:
+    if request_hooks is None or request_hooks.get("response") == []:
         return session_hooks
 
     return merge_setting(request_hooks, session_hooks, dict_class)
 
 
-class SessionRedirectMixin(object):
-
+class SessionRedirectMixin:
     def get_redirect_target(self, resp):
         """Receives a Response. Returns a redirect URI or ``None``"""
         # Due to the nature of how requests processes redirects this method will
@@ -104,16 +113,15 @@ class SessionRedirectMixin(object):
         # to cache the redirect location onto the response object as a private
         # attribute.
         if resp.is_redirect:
-            location = resp.headers['location']
+            location = resp.headers["location"]
             # Currently the underlying http module on py3 decode headers
             # in latin1, but empirical evidence suggests that latin1 is very
             # rarely used with non-ASCII characters in HTTP headers.
             # It is more likely to get UTF8 header rather than latin1.
             # This causes incorrect handling of UTF8 encoded location headers.
             # To solve this, we re-encode the location in latin1.
-            if is_py3:
-                location = location.encode('latin1')
-            return to_native_string(location, 'utf8')
+            location = location.encode("latin1")
+            return to_native_string(location, "utf8")
         return None
 
     def should_strip_auth(self, old_url, new_url):
@@ -126,23 +134,40 @@ class SessionRedirectMixin(object):
         # ports. This isn't specified by RFC 7235, but is kept to avoid
         # breaking backwards compatibility with older versions of requests
         # that allowed any redirects on the same host.
-        if (old_parsed.scheme == 'http' and old_parsed.port in (80, None)
-                and new_parsed.scheme == 'https' and new_parsed.port in (443, None)):
+        if (
+            old_parsed.scheme == "http"
+            and old_parsed.port in (80, None)
+            and new_parsed.scheme == "https"
+            and new_parsed.port in (443, None)
+        ):
             return False
 
         # Handle default port usage corresponding to scheme.
         changed_port = old_parsed.port != new_parsed.port
         changed_scheme = old_parsed.scheme != new_parsed.scheme
         default_port = (DEFAULT_PORTS.get(old_parsed.scheme, None), None)
-        if (not changed_scheme and old_parsed.port in default_port
-                and new_parsed.port in default_port):
+        if (
+            not changed_scheme
+            and old_parsed.port in default_port
+            and new_parsed.port in default_port
+        ):
             return False
 
         # Standard case: root URI must match
         return changed_port or changed_scheme
 
-    def resolve_redirects(self, resp, req, stream=False, timeout=None,
-                          verify=True, cert=None, proxies=None, yield_requests=False, **adapter_kwargs):
+    def resolve_redirects(
+        self,
+        resp,
+        req,
+        stream=False,
+        timeout=None,
+        verify=True,
+        cert=None,
+        proxies=None,
+        yield_requests=False,
+        **adapter_kwargs,
+    ):
         """Receives a Response. Returns a generator of Responses or Requests."""
 
         hist = []  # keep track of history
@@ -163,19 +188,21 @@ class SessionRedirectMixin(object):
                 resp.raw.read(decode_content=False)
 
             if len(resp.history) >= self.max_redirects:
-                raise TooManyRedirects('Exceeded {} redirects.'.format(self.max_redirects), response=resp)
+                raise TooManyRedirects(
+                    f"Exceeded {self.max_redirects} redirects.", response=resp
+                )
 
             # Release the connection back into the pool.
             resp.close()
 
             # Handle redirection without scheme (see: RFC 1808 Section 4)
-            if url.startswith('//'):
+            if url.startswith("//"):
                 parsed_rurl = urlparse(resp.url)
-                url = ':'.join([to_native_string(parsed_rurl.scheme), url])
+                url = ":".join([to_native_string(parsed_rurl.scheme), url])
 
             # Normalize url case and attach previous fragment if needed (RFC 7231 7.1.2)
             parsed = urlparse(url)
-            if parsed.fragment == '' and previous_fragment:
+            if parsed.fragment == "" and previous_fragment:
                 parsed = parsed._replace(fragment=previous_fragment)
             elif parsed.fragment:
                 previous_fragment = parsed.fragment
@@ -194,15 +221,18 @@ class SessionRedirectMixin(object):
             self.rebuild_method(prepared_request, resp)
 
             # https://github.com/psf/requests/issues/1084
-            if resp.status_code not in (codes.temporary_redirect, codes.permanent_redirect):
+            if resp.status_code not in (
+                codes.temporary_redirect,
+                codes.permanent_redirect,
+            ):
                 # https://github.com/psf/requests/issues/3490
-                purged_headers = ('Content-Length', 'Content-Type', 'Transfer-Encoding')
+                purged_headers = ("Content-Length", "Content-Type", "Transfer-Encoding")
                 for header in purged_headers:
                     prepared_request.headers.pop(header, None)
                 prepared_request.body = None
 
             headers = prepared_request.headers
-            headers.pop('Cookie', None)
+            headers.pop("Cookie", None)
 
             # Extract any cookies sent on the response to the cookiejar
             # in the new request. Because we've mutated our copied prepared
@@ -218,9 +248,8 @@ class SessionRedirectMixin(object):
             # A failed tell() sets `_body_position` to `object()`. This non-None
             # value ensures `rewindable` will be True, allowing us to raise an
             # UnrewindableBodyError, instead of hanging the connection.
-            rewindable = (
-                prepared_request._body_position is not None and
-                ('Content-Length' in headers or 'Transfer-Encoding' in headers)
+            rewindable = prepared_request._body_position is not None and (
+                "Content-Length" in headers or "Transfer-Encoding" in headers
             )
 
             # Attempt to rewind consumed file-like object.
@@ -242,7 +271,7 @@ class SessionRedirectMixin(object):
                     cert=cert,
                     proxies=proxies,
                     allow_redirects=False,
-                    **adapter_kwargs
+                    **adapter_kwargs,
                 )
 
                 extract_cookies_to_jar(self.cookies, prepared_request, resp.raw)
@@ -259,10 +288,12 @@ class SessionRedirectMixin(object):
         headers = prepared_request.headers
         url = prepared_request.url
 
-        if 'Authorization' in headers and self.should_strip_auth(response.request.url, url):
+        if "Authorization" in headers and self.should_strip_auth(
+            response.request.url, url
+        ):
             # If we get redirected to a new host, we should strip out any
             # authentication headers.
-            del headers['Authorization']
+            del headers["Authorization"]
 
         # .netrc might have more auth for us on our new host.
         new_auth = get_netrc_auth(url) if self.trust_env else None
@@ -285,8 +316,8 @@ class SessionRedirectMixin(object):
         scheme = urlparse(prepared_request.url).scheme
         new_proxies = resolve_proxies(prepared_request, proxies, self.trust_env)
 
-        if 'Proxy-Authorization' in headers:
-            del headers['Proxy-Authorization']
+        if "Proxy-Authorization" in headers:
+            del headers["Proxy-Authorization"]
 
         try:
             username, password = get_auth_from_url(new_proxies[scheme])
@@ -294,7 +325,7 @@ class SessionRedirectMixin(object):
             username, password = None, None
 
         if username and password:
-            headers['Proxy-Authorization'] = _basic_auth_str(username, password)
+            headers["Proxy-Authorization"] = _basic_auth_str(username, password)
 
         return new_proxies
 
@@ -305,18 +336,18 @@ class SessionRedirectMixin(object):
         method = prepared_request.method
 
         # https://tools.ietf.org/html/rfc7231#section-6.4.4
-        if response.status_code == codes.see_other and method != 'HEAD':
-            method = 'GET'
+        if response.status_code == codes.see_other and method != "HEAD":
+            method = "GET"
 
         # Do what the browsers do, despite standards...
         # First, turn 302s into GETs.
-        if response.status_code == codes.found and method != 'HEAD':
-            method = 'GET'
+        if response.status_code == codes.found and method != "HEAD":
+            method = "GET"
 
         # Second, if a POST is responded to with a 301, turn it into a GET.
         # This bizarre behaviour is explained in Issue 1704.
-        if response.status_code == codes.moved and method == 'POST':
-            method = 'GET'
+        if response.status_code == codes.moved and method == "POST":
+            method = "GET"
 
         prepared_request.method = method
 
@@ -341,9 +372,18 @@ class Session(SessionRedirectMixin):
     """
 
     __attrs__ = [
-        'headers', 'cookies', 'auth', 'proxies', 'hooks', 'params', 'verify',
-        'cert', 'adapters', 'stream', 'trust_env',
-        'max_redirects',
+        "headers",
+        "cookies",
+        "auth",
+        "proxies",
+        "hooks",
+        "params",
+        "verify",
+        "cert",
+        "adapters",
+        "stream",
+        "trust_env",
+        "max_redirects",
     ]
 
     def __init__(self):
@@ -405,8 +445,8 @@ class Session(SessionRedirectMixin):
 
         # Default connection adapters.
         self.adapters = OrderedDict()
-        self.mount('https://', HTTPAdapter())
-        self.mount('http://', HTTPAdapter())
+        self.mount("https://", HTTPAdapter())
+        self.mount("http://", HTTPAdapter())
 
     def __enter__(self):
         return self
@@ -432,7 +472,8 @@ class Session(SessionRedirectMixin):
 
         # Merge with session cookies
         merged_cookies = merge_cookies(
-            merge_cookies(RequestsCookieJar(), self.cookies), cookies)
+            merge_cookies(RequestsCookieJar(), self.cookies), cookies
+        )
 
         # Set environment's basic authentication if not explicitly set.
         auth = request.auth
@@ -446,7 +487,9 @@ class Session(SessionRedirectMixin):
             files=request.files,
             data=request.data,
             json=request.json,
-            headers=merge_setting(request.headers, self.headers, dict_class=CaseInsensitiveDict),
+            headers=merge_setting(
+                request.headers, self.headers, dict_class=CaseInsensitiveDict
+            ),
             params=merge_setting(request.params, self.params),
             auth=merge_setting(auth, self.auth),
             cookies=merged_cookies,
@@ -454,10 +497,25 @@ class Session(SessionRedirectMixin):
         )
         return p
 
-    def request(self, method, url,
-            params=None, data=None, headers=None, cookies=None, files=None,
-            auth=None, timeout=None, allow_redirects=True, proxies=None,
-            hooks=None, stream=None, verify=None, cert=None, json=None):
+    def request(
+        self,
+        method,
+        url,
+        params=None,
+        data=None,
+        headers=None,
+        cookies=None,
+        files=None,
+        auth=None,
+        timeout=None,
+        allow_redirects=True,
+        proxies=None,
+        hooks=None,
+        stream=None,
+        verify=None,
+        cert=None,
+        json=None,
+    ):
         """Constructs a :class:`Request <Request>`, prepares it and sends it.
         Returns :class:`Response <Response>` object.
 
@@ -493,7 +551,7 @@ class Session(SessionRedirectMixin):
             ``False``, requests will accept any TLS certificate presented by
             the server, and will ignore hostname mismatches and/or expired
             certificates, which will make your application vulnerable to
-            man-in-the-middle (MitM) attacks. Setting verify to ``False`` 
+            man-in-the-middle (MitM) attacks. Setting verify to ``False``
             may be useful during local development or testing.
         :param cert: (optional) if String, path to ssl client cert file (.pem).
             If Tuple, ('cert', 'key') pair.
@@ -522,8 +580,8 @@ class Session(SessionRedirectMixin):
 
         # Send the request.
         send_kwargs = {
-            'timeout': timeout,
-            'allow_redirects': allow_redirects,
+            "timeout": timeout,
+            "allow_redirects": allow_redirects,
         }
         send_kwargs.update(settings)
         resp = self.send(prep, **send_kwargs)
@@ -538,8 +596,8 @@ class Session(SessionRedirectMixin):
         :rtype: requests.Response
         """
 
-        kwargs.setdefault('allow_redirects', True)
-        return self.request('GET', url, **kwargs)
+        kwargs.setdefault("allow_redirects", True)
+        return self.request("GET", url, **kwargs)
 
     def options(self, url, **kwargs):
         r"""Sends a OPTIONS request. Returns :class:`Response` object.
@@ -549,8 +607,8 @@ class Session(SessionRedirectMixin):
         :rtype: requests.Response
         """
 
-        kwargs.setdefault('allow_redirects', True)
-        return self.request('OPTIONS', url, **kwargs)
+        kwargs.setdefault("allow_redirects", True)
+        return self.request("OPTIONS", url, **kwargs)
 
     def head(self, url, **kwargs):
         r"""Sends a HEAD request. Returns :class:`Response` object.
@@ -560,8 +618,8 @@ class Session(SessionRedirectMixin):
         :rtype: requests.Response
         """
 
-        kwargs.setdefault('allow_redirects', False)
-        return self.request('HEAD', url, **kwargs)
+        kwargs.setdefault("allow_redirects", False)
+        return self.request("HEAD", url, **kwargs)
 
     def post(self, url, data=None, json=None, **kwargs):
         r"""Sends a POST request. Returns :class:`Response` object.
@@ -574,7 +632,7 @@ class Session(SessionRedirectMixin):
         :rtype: requests.Response
         """
 
-        return self.request('POST', url, data=data, json=json, **kwargs)
+        return self.request("POST", url, data=data, json=json, **kwargs)
 
     def put(self, url, data=None, **kwargs):
         r"""Sends a PUT request. Returns :class:`Response` object.
@@ -586,7 +644,7 @@ class Session(SessionRedirectMixin):
         :rtype: requests.Response
         """
 
-        return self.request('PUT', url, data=data, **kwargs)
+        return self.request("PUT", url, data=data, **kwargs)
 
     def patch(self, url, data=None, **kwargs):
         r"""Sends a PATCH request. Returns :class:`Response` object.
@@ -598,7 +656,7 @@ class Session(SessionRedirectMixin):
         :rtype: requests.Response
         """
 
-        return self.request('PATCH', url, data=data, **kwargs)
+        return self.request("PATCH", url, data=data, **kwargs)
 
     def delete(self, url, **kwargs):
         r"""Sends a DELETE request. Returns :class:`Response` object.
@@ -608,7 +666,7 @@ class Session(SessionRedirectMixin):
         :rtype: requests.Response
         """
 
-        return self.request('DELETE', url, **kwargs)
+        return self.request("DELETE", url, **kwargs)
 
     def send(self, request, **kwargs):
         """Send a given PreparedRequest.
@@ -617,22 +675,20 @@ class Session(SessionRedirectMixin):
         """
         # Set defaults that the hooks can utilize to ensure they always have
         # the correct parameters to reproduce the previous request.
-        kwargs.setdefault('stream', self.stream)
-        kwargs.setdefault('verify', self.verify)
-        kwargs.setdefault('cert', self.cert)
-        if 'proxies' not in kwargs:
-            kwargs['proxies'] = resolve_proxies(
-                request, self.proxies, self.trust_env
-            )
+        kwargs.setdefault("stream", self.stream)
+        kwargs.setdefault("verify", self.verify)
+        kwargs.setdefault("cert", self.cert)
+        if "proxies" not in kwargs:
+            kwargs["proxies"] = resolve_proxies(request, self.proxies, self.trust_env)
 
         # It's possible that users might accidentally send a Request object.
         # Guard against that specific failure case.
         if isinstance(request, Request):
-            raise ValueError('You can only send PreparedRequests.')
+            raise ValueError("You can only send PreparedRequests.")
 
         # Set up variables needed for resolve_redirects and dispatching of hooks
-        allow_redirects = kwargs.pop('allow_redirects', True)
-        stream = kwargs.get('stream')
+        allow_redirects = kwargs.pop("allow_redirects", True)
+        stream = kwargs.get("stream")
         hooks = request.hooks
 
         # Get the appropriate adapter to use
@@ -649,7 +705,7 @@ class Session(SessionRedirectMixin):
         r.elapsed = timedelta(seconds=elapsed)
 
         # Response manipulation hooks
-        r = dispatch_hook('response', hooks, r, **kwargs)
+        r = dispatch_hook("response", hooks, r, **kwargs)
 
         # Persist cookies
         if r.history:
@@ -679,7 +735,9 @@ class Session(SessionRedirectMixin):
         # If redirects aren't being followed, store the response on the Request for Response.next().
         if not allow_redirects:
             try:
-                r._next = next(self.resolve_redirects(r, request, yield_requests=True, **kwargs))
+                r._next = next(
+                    self.resolve_redirects(r, request, yield_requests=True, **kwargs)
+                )
             except StopIteration:
                 pass
 
@@ -697,16 +755,19 @@ class Session(SessionRedirectMixin):
         # Gather clues from the surrounding environment.
         if self.trust_env:
             # Set environment's proxies.
-            no_proxy = proxies.get('no_proxy') if proxies is not None else None
+            no_proxy = proxies.get("no_proxy") if proxies is not None else None
             env_proxies = get_environ_proxies(url, no_proxy=no_proxy)
             for (k, v) in env_proxies.items():
                 proxies.setdefault(k, v)
 
-            # Look for requests environment configuration and be compatible
-            # with cURL.
+            # Look for requests environment configuration
+            # and be compatible with cURL.
             if verify is True or verify is None:
-                verify = (os.environ.get('REQUESTS_CA_BUNDLE') or
-                          os.environ.get('CURL_CA_BUNDLE'))
+                verify = (
+                    os.environ.get("REQUESTS_CA_BUNDLE")
+                    or os.environ.get("CURL_CA_BUNDLE")
+                    or verify
+                )
 
         # Merge all the kwargs.
         proxies = merge_setting(proxies, self.proxies)
@@ -714,8 +775,7 @@ class Session(SessionRedirectMixin):
         verify = merge_setting(verify, self.verify)
         cert = merge_setting(cert, self.cert)
 
-        return {'verify': verify, 'proxies': proxies, 'stream': stream,
-                'cert': cert}
+        return {"proxies": proxies, "stream": stream, "verify": verify, "cert": cert}
 
     def get_adapter(self, url):
         """
@@ -729,7 +789,7 @@ class Session(SessionRedirectMixin):
                 return adapter
 
         # Nothing matches :-/
-        raise InvalidSchema("No connection adapters were found for {!r}".format(url))
+        raise InvalidSchema(f"No connection adapters were found for {url!r}")
 
     def close(self):
         """Closes all adapters and as such the session"""
diff --git a/lib/requests/status_codes.py b/lib/requests/status_codes.py
index d80a7cd4..4bd072be 100644
--- a/lib/requests/status_codes.py
+++ b/lib/requests/status_codes.py
@@ -1,5 +1,3 @@
-# -*- coding: utf-8 -*-
-
 r"""
 The ``codes`` object defines a mapping from common names for HTTP statuses
 to their numerical codes, accessible either as attributes or as dictionary
@@ -23,101 +21,108 @@ the names are allowed. For example, ``codes.ok``, ``codes.OK``, and
 from .structures import LookupDict
 
 _codes = {
-
     # Informational.
-    100: ('continue',),
-    101: ('switching_protocols',),
-    102: ('processing',),
-    103: ('checkpoint',),
-    122: ('uri_too_long', 'request_uri_too_long'),
-    200: ('ok', 'okay', 'all_ok', 'all_okay', 'all_good', '\\o/', '✓'),
-    201: ('created',),
-    202: ('accepted',),
-    203: ('non_authoritative_info', 'non_authoritative_information'),
-    204: ('no_content',),
-    205: ('reset_content', 'reset'),
-    206: ('partial_content', 'partial'),
-    207: ('multi_status', 'multiple_status', 'multi_stati', 'multiple_stati'),
-    208: ('already_reported',),
-    226: ('im_used',),
-
+    100: ("continue",),
+    101: ("switching_protocols",),
+    102: ("processing",),
+    103: ("checkpoint",),
+    122: ("uri_too_long", "request_uri_too_long"),
+    200: ("ok", "okay", "all_ok", "all_okay", "all_good", "\\o/", "✓"),
+    201: ("created",),
+    202: ("accepted",),
+    203: ("non_authoritative_info", "non_authoritative_information"),
+    204: ("no_content",),
+    205: ("reset_content", "reset"),
+    206: ("partial_content", "partial"),
+    207: ("multi_status", "multiple_status", "multi_stati", "multiple_stati"),
+    208: ("already_reported",),
+    226: ("im_used",),
     # Redirection.
-    300: ('multiple_choices',),
-    301: ('moved_permanently', 'moved', '\\o-'),
-    302: ('found',),
-    303: ('see_other', 'other'),
-    304: ('not_modified',),
-    305: ('use_proxy',),
-    306: ('switch_proxy',),
-    307: ('temporary_redirect', 'temporary_moved', 'temporary'),
-    308: ('permanent_redirect',
-          'resume_incomplete', 'resume',),  # These 2 to be removed in 3.0
-
+    300: ("multiple_choices",),
+    301: ("moved_permanently", "moved", "\\o-"),
+    302: ("found",),
+    303: ("see_other", "other"),
+    304: ("not_modified",),
+    305: ("use_proxy",),
+    306: ("switch_proxy",),
+    307: ("temporary_redirect", "temporary_moved", "temporary"),
+    308: (
+        "permanent_redirect",
+        "resume_incomplete",
+        "resume",
+    ),  # "resume" and "resume_incomplete" to be removed in 3.0
     # Client Error.
-    400: ('bad_request', 'bad'),
-    401: ('unauthorized',),
-    402: ('payment_required', 'payment'),
-    403: ('forbidden',),
-    404: ('not_found', '-o-'),
-    405: ('method_not_allowed', 'not_allowed'),
-    406: ('not_acceptable',),
-    407: ('proxy_authentication_required', 'proxy_auth', 'proxy_authentication'),
-    408: ('request_timeout', 'timeout'),
-    409: ('conflict',),
-    410: ('gone',),
-    411: ('length_required',),
-    412: ('precondition_failed', 'precondition'),
-    413: ('request_entity_too_large',),
-    414: ('request_uri_too_large',),
-    415: ('unsupported_media_type', 'unsupported_media', 'media_type'),
-    416: ('requested_range_not_satisfiable', 'requested_range', 'range_not_satisfiable'),
-    417: ('expectation_failed',),
-    418: ('im_a_teapot', 'teapot', 'i_am_a_teapot'),
-    421: ('misdirected_request',),
-    422: ('unprocessable_entity', 'unprocessable'),
-    423: ('locked',),
-    424: ('failed_dependency', 'dependency'),
-    425: ('unordered_collection', 'unordered'),
-    426: ('upgrade_required', 'upgrade'),
-    428: ('precondition_required', 'precondition'),
-    429: ('too_many_requests', 'too_many'),
-    431: ('header_fields_too_large', 'fields_too_large'),
-    444: ('no_response', 'none'),
-    449: ('retry_with', 'retry'),
-    450: ('blocked_by_windows_parental_controls', 'parental_controls'),
-    451: ('unavailable_for_legal_reasons', 'legal_reasons'),
-    499: ('client_closed_request',),
-
+    400: ("bad_request", "bad"),
+    401: ("unauthorized",),
+    402: ("payment_required", "payment"),
+    403: ("forbidden",),
+    404: ("not_found", "-o-"),
+    405: ("method_not_allowed", "not_allowed"),
+    406: ("not_acceptable",),
+    407: ("proxy_authentication_required", "proxy_auth", "proxy_authentication"),
+    408: ("request_timeout", "timeout"),
+    409: ("conflict",),
+    410: ("gone",),
+    411: ("length_required",),
+    412: ("precondition_failed", "precondition"),
+    413: ("request_entity_too_large",),
+    414: ("request_uri_too_large",),
+    415: ("unsupported_media_type", "unsupported_media", "media_type"),
+    416: (
+        "requested_range_not_satisfiable",
+        "requested_range",
+        "range_not_satisfiable",
+    ),
+    417: ("expectation_failed",),
+    418: ("im_a_teapot", "teapot", "i_am_a_teapot"),
+    421: ("misdirected_request",),
+    422: ("unprocessable_entity", "unprocessable"),
+    423: ("locked",),
+    424: ("failed_dependency", "dependency"),
+    425: ("unordered_collection", "unordered"),
+    426: ("upgrade_required", "upgrade"),
+    428: ("precondition_required", "precondition"),
+    429: ("too_many_requests", "too_many"),
+    431: ("header_fields_too_large", "fields_too_large"),
+    444: ("no_response", "none"),
+    449: ("retry_with", "retry"),
+    450: ("blocked_by_windows_parental_controls", "parental_controls"),
+    451: ("unavailable_for_legal_reasons", "legal_reasons"),
+    499: ("client_closed_request",),
     # Server Error.
-    500: ('internal_server_error', 'server_error', '/o\\', '✗'),
-    501: ('not_implemented',),
-    502: ('bad_gateway',),
-    503: ('service_unavailable', 'unavailable'),
-    504: ('gateway_timeout',),
-    505: ('http_version_not_supported', 'http_version'),
-    506: ('variant_also_negotiates',),
-    507: ('insufficient_storage',),
-    509: ('bandwidth_limit_exceeded', 'bandwidth'),
-    510: ('not_extended',),
-    511: ('network_authentication_required', 'network_auth', 'network_authentication'),
+    500: ("internal_server_error", "server_error", "/o\\", "✗"),
+    501: ("not_implemented",),
+    502: ("bad_gateway",),
+    503: ("service_unavailable", "unavailable"),
+    504: ("gateway_timeout",),
+    505: ("http_version_not_supported", "http_version"),
+    506: ("variant_also_negotiates",),
+    507: ("insufficient_storage",),
+    509: ("bandwidth_limit_exceeded", "bandwidth"),
+    510: ("not_extended",),
+    511: ("network_authentication_required", "network_auth", "network_authentication"),
 }
 
-codes = LookupDict(name='status_codes')
+codes = LookupDict(name="status_codes")
+
 
 def _init():
     for code, titles in _codes.items():
         for title in titles:
             setattr(codes, title, code)
-            if not title.startswith(('\\', '/')):
+            if not title.startswith(("\\", "/")):
                 setattr(codes, title.upper(), code)
 
     def doc(code):
-        names = ', '.join('``%s``' % n for n in _codes[code])
-        return '* %d: %s' % (code, names)
+        names = ", ".join(f"``{n}``" for n in _codes[code])
+        return "* %d: %s" % (code, names)
 
     global __doc__
-    __doc__ = (__doc__ + '\n' +
-               '\n'.join(doc(code) for code in sorted(_codes))
-               if __doc__ is not None else None)
+    __doc__ = (
+        __doc__ + "\n" + "\n".join(doc(code) for code in sorted(_codes))
+        if __doc__ is not None
+        else None
+    )
+
 
 _init()
diff --git a/lib/requests/structures.py b/lib/requests/structures.py
index 8ee0ba7a..188e13e4 100644
--- a/lib/requests/structures.py
+++ b/lib/requests/structures.py
@@ -1,5 +1,3 @@
-# -*- coding: utf-8 -*-
-
 """
 requests.structures
 ~~~~~~~~~~~~~~~~~~~
@@ -64,11 +62,7 @@ class CaseInsensitiveDict(MutableMapping):
 
     def lower_items(self):
         """Like iteritems(), but with all lowercase keys."""
-        return (
-            (lowerkey, keyval[1])
-            for (lowerkey, keyval)
-            in self._store.items()
-        )
+        return ((lowerkey, keyval[1]) for (lowerkey, keyval) in self._store.items())
 
     def __eq__(self, other):
         if isinstance(other, Mapping):
@@ -91,10 +85,10 @@ class LookupDict(dict):
 
     def __init__(self, name=None):
         self.name = name
-        super(LookupDict, self).__init__()
+        super().__init__()
 
     def __repr__(self):
-        return '<lookup \'%s\'>' % (self.name)
+        return f"<lookup '{self.name}'>"
 
     def __getitem__(self, key):
         # We allow fall-through here, so values default to None
diff --git a/lib/requests/utils.py b/lib/requests/utils.py
index 153776c7..ad535838 100644
--- a/lib/requests/utils.py
+++ b/lib/requests/utils.py
@@ -1,5 +1,3 @@
-# -*- coding: utf-8 -*-
-
 """
 requests.utils
 ~~~~~~~~~~~~~~
@@ -20,28 +18,46 @@ import tempfile
 import warnings
 import zipfile
 from collections import OrderedDict
-from urllib3.util import make_headers
-from urllib3.util import parse_url
 
-from .__version__ import __version__
+from urllib3.util import make_headers, parse_url
+
 from . import certs
+from .__version__ import __version__
+
 # to_native_string is unused here, but imported here for backwards compatibility
-from ._internal_utils import to_native_string
+from ._internal_utils import HEADER_VALIDATORS, to_native_string  # noqa: F401
+from .compat import (
+    Mapping,
+    basestring,
+    bytes,
+    getproxies,
+    getproxies_environment,
+    integer_types,
+)
 from .compat import parse_http_list as _parse_list_header
 from .compat import (
-    quote, urlparse, bytes, str, unquote, getproxies,
-    proxy_bypass, urlunparse, basestring, integer_types, is_py3,
-    proxy_bypass_environment, getproxies_environment, Mapping)
+    proxy_bypass,
+    proxy_bypass_environment,
+    quote,
+    str,
+    unquote,
+    urlparse,
+    urlunparse,
+)
 from .cookies import cookiejar_from_dict
-from .structures import CaseInsensitiveDict
 from .exceptions import (
-    InvalidURL, InvalidHeader, FileModeWarning, UnrewindableBodyError)
+    FileModeWarning,
+    InvalidHeader,
+    InvalidURL,
+    UnrewindableBodyError,
+)
+from .structures import CaseInsensitiveDict
 
-NETRC_FILES = ('.netrc', '_netrc')
+NETRC_FILES = (".netrc", "_netrc")
 
 DEFAULT_CA_BUNDLE_PATH = certs.where()
 
-DEFAULT_PORTS = {'http': 80, 'https': 443}
+DEFAULT_PORTS = {"http": 80, "https": 443}
 
 # Ensure that ', ' is used to preserve previous delimiter behavior.
 DEFAULT_ACCEPT_ENCODING = ", ".join(
@@ -49,28 +65,25 @@ DEFAULT_ACCEPT_ENCODING = ", ".join(
 )
 
 
-if sys.platform == 'win32':
+if sys.platform == "win32":
     # provide a proxy_bypass version on Windows without DNS lookups
 
     def proxy_bypass_registry(host):
         try:
-            if is_py3:
-                import winreg
-            else:
-                import _winreg as winreg
+            import winreg
         except ImportError:
             return False
 
         try:
-            internetSettings = winreg.OpenKey(winreg.HKEY_CURRENT_USER,
-                r'Software\Microsoft\Windows\CurrentVersion\Internet Settings')
+            internetSettings = winreg.OpenKey(
+                winreg.HKEY_CURRENT_USER,
+                r"Software\Microsoft\Windows\CurrentVersion\Internet Settings",
+            )
             # ProxyEnable could be REG_SZ or REG_DWORD, normalizing it
-            proxyEnable = int(winreg.QueryValueEx(internetSettings,
-                                              'ProxyEnable')[0])
+            proxyEnable = int(winreg.QueryValueEx(internetSettings, "ProxyEnable")[0])
             # ProxyOverride is almost always a string
-            proxyOverride = winreg.QueryValueEx(internetSettings,
-                                                'ProxyOverride')[0]
-        except OSError:
+            proxyOverride = winreg.QueryValueEx(internetSettings, "ProxyOverride")[0]
+        except (OSError, ValueError):
             return False
         if not proxyEnable or not proxyOverride:
             return False
@@ -78,15 +91,15 @@ if sys.platform == 'win32':
         # make a check value list from the registry entry: replace the
         # '<local>' string by the localhost entry and the corresponding
         # canonical entry.
-        proxyOverride = proxyOverride.split(';')
+        proxyOverride = proxyOverride.split(";")
         # now check if we match one of the registry values.
         for test in proxyOverride:
-            if test == '<local>':
-                if '.' not in host:
+            if test == "<local>":
+                if "." not in host:
                     return True
-            test = test.replace(".", r"\.")     # mask dots
-            test = test.replace("*", r".*")     # change glob sequence
-            test = test.replace("?", r".")      # change glob char
+            test = test.replace(".", r"\.")  # mask dots
+            test = test.replace("*", r".*")  # change glob sequence
+            test = test.replace("?", r".")  # change glob char
             if re.match(test, host, re.I):
                 return True
         return False
@@ -106,7 +119,7 @@ if sys.platform == 'win32':
 def dict_to_sequence(d):
     """Returns an internal sequence dictionary update."""
 
-    if hasattr(d, 'items'):
+    if hasattr(d, "items"):
         d = d.items()
 
     return d
@@ -116,13 +129,13 @@ def super_len(o):
     total_length = None
     current_position = 0
 
-    if hasattr(o, '__len__'):
+    if hasattr(o, "__len__"):
         total_length = len(o)
 
-    elif hasattr(o, 'len'):
+    elif hasattr(o, "len"):
         total_length = o.len
 
-    elif hasattr(o, 'fileno'):
+    elif hasattr(o, "fileno"):
         try:
             fileno = o.fileno()
         except (io.UnsupportedOperation, AttributeError):
@@ -135,21 +148,23 @@ def super_len(o):
 
             # Having used fstat to determine the file length, we need to
             # confirm that this file was opened up in binary mode.
-            if 'b' not in o.mode:
-                warnings.warn((
-                    "Requests has determined the content-length for this "
-                    "request using the binary size of the file: however, the "
-                    "file has been opened in text mode (i.e. without the 'b' "
-                    "flag in the mode). This may lead to an incorrect "
-                    "content-length. In Requests 3.0, support will be removed "
-                    "for files in text mode."),
-                    FileModeWarning
+            if "b" not in o.mode:
+                warnings.warn(
+                    (
+                        "Requests has determined the content-length for this "
+                        "request using the binary size of the file: however, the "
+                        "file has been opened in text mode (i.e. without the 'b' "
+                        "flag in the mode). This may lead to an incorrect "
+                        "content-length. In Requests 3.0, support will be removed "
+                        "for files in text mode."
+                    ),
+                    FileModeWarning,
                 )
 
-    if hasattr(o, 'tell'):
+    if hasattr(o, "tell"):
         try:
             current_position = o.tell()
-        except (OSError, IOError):
+        except OSError:
             # This can happen in some weird situations, such as when the file
             # is actually a special file descriptor like stdin. In this
             # instance, we don't know what the length is, so set it to zero and
@@ -157,7 +172,7 @@ def super_len(o):
             if total_length is not None:
                 current_position = total_length
         else:
-            if hasattr(o, 'seek') and total_length is None:
+            if hasattr(o, "seek") and total_length is None:
                 # StringIO and BytesIO have seek but no usable fileno
                 try:
                     # seek to end of file
@@ -167,7 +182,7 @@ def super_len(o):
                     # seek back to current position to support
                     # partially read file-like objects
                     o.seek(current_position or 0)
-                except (OSError, IOError):
+                except OSError:
                     total_length = 0
 
     if total_length is None:
@@ -179,14 +194,14 @@ def super_len(o):
 def get_netrc_auth(url, raise_errors=False):
     """Returns the Requests tuple auth for a given url from netrc."""
 
-    netrc_file = os.environ.get('NETRC')
+    netrc_file = os.environ.get("NETRC")
     if netrc_file is not None:
         netrc_locations = (netrc_file,)
     else:
-        netrc_locations = ('~/{}'.format(f) for f in NETRC_FILES)
+        netrc_locations = (f"~/{f}" for f in NETRC_FILES)
 
     try:
-        from netrc import netrc, NetrcParseError
+        from netrc import NetrcParseError, netrc
 
         netrc_path = None
 
@@ -211,18 +226,18 @@ def get_netrc_auth(url, raise_errors=False):
 
         # Strip port numbers from netloc. This weird `if...encode`` dance is
         # used for Python 3.2, which doesn't support unicode literals.
-        splitstr = b':'
+        splitstr = b":"
         if isinstance(url, str):
-            splitstr = splitstr.decode('ascii')
+            splitstr = splitstr.decode("ascii")
         host = ri.netloc.split(splitstr)[0]
 
         try:
             _netrc = netrc(netrc_path).authenticators(host)
             if _netrc:
                 # Return with login / password
-                login_i = (0 if _netrc[0] else 1)
+                login_i = 0 if _netrc[0] else 1
                 return (_netrc[login_i], _netrc[2])
-        except (NetrcParseError, IOError):
+        except (NetrcParseError, OSError):
             # If there was a parsing error or a permissions issue reading the file,
             # we'll just skip netrc auth unless explicitly asked to raise errors.
             if raise_errors:
@@ -235,9 +250,8 @@ def get_netrc_auth(url, raise_errors=False):
 
 def guess_filename(obj):
     """Tries to guess the filename of the given object."""
-    name = getattr(obj, 'name', None)
-    if (name and isinstance(name, basestring) and name[0] != '<' and
-            name[-1] != '>'):
+    name = getattr(obj, "name", None)
+    if name and isinstance(name, basestring) and name[0] != "<" and name[-1] != ">":
         return os.path.basename(name)
 
 
@@ -259,7 +273,7 @@ def extract_zipped_paths(path):
             # If we don't check for an empty prefix after the split (in other words, archive remains unchanged after the split),
             # we _can_ end up in an infinite loop on a rare corner case affecting a small number of users
             break
-        member = '/'.join([prefix, member])
+        member = "/".join([prefix, member])
 
     if not zipfile.is_zipfile(archive):
         return path
@@ -270,7 +284,7 @@ def extract_zipped_paths(path):
 
     # we have a valid zip archive and a valid member of that archive
     tmp = tempfile.gettempdir()
-    extracted_path = os.path.join(tmp, member.split('/')[-1])
+    extracted_path = os.path.join(tmp, member.split("/")[-1])
     if not os.path.exists(extracted_path):
         # use read + write to avoid the creating nested folders, we only want the file, avoids mkdir racing condition
         with atomic_open(extracted_path) as file_handler:
@@ -281,12 +295,11 @@ def extract_zipped_paths(path):
 @contextlib.contextmanager
 def atomic_open(filename):
     """Write a file to the disk in an atomic fashion"""
-    replacer = os.rename if sys.version_info[0] == 2 else os.replace
     tmp_descriptor, tmp_name = tempfile.mkstemp(dir=os.path.dirname(filename))
     try:
-        with os.fdopen(tmp_descriptor, 'wb') as tmp_handler:
+        with os.fdopen(tmp_descriptor, "wb") as tmp_handler:
             yield tmp_handler
-        replacer(tmp_name, filename)
+        os.replace(tmp_name, filename)
     except BaseException:
         os.remove(tmp_name)
         raise
@@ -314,7 +327,7 @@ def from_key_val_list(value):
         return None
 
     if isinstance(value, (str, bytes, bool, int)):
-        raise ValueError('cannot encode objects that are not 2-tuples')
+        raise ValueError("cannot encode objects that are not 2-tuples")
 
     return OrderedDict(value)
 
@@ -340,7 +353,7 @@ def to_key_val_list(value):
         return None
 
     if isinstance(value, (str, bytes, bool, int)):
-        raise ValueError('cannot encode objects that are not 2-tuples')
+        raise ValueError("cannot encode objects that are not 2-tuples")
 
     if isinstance(value, Mapping):
         value = value.items()
@@ -405,10 +418,10 @@ def parse_dict_header(value):
     """
     result = {}
     for item in _parse_list_header(value):
-        if '=' not in item:
+        if "=" not in item:
             result[item] = None
             continue
-        name, value = item.split('=', 1)
+        name, value = item.split("=", 1)
         if value[:1] == value[-1:] == '"':
             value = unquote_header_value(value[1:-1])
         result[name] = value
@@ -436,8 +449,8 @@ def unquote_header_value(value, is_filename=False):
         # replace sequence below on a UNC path has the effect of turning
         # the leading double slash into a single slash and then
         # _fix_ie_filename() doesn't work correctly.  See #458.
-        if not is_filename or value[:2] != '\\\\':
-            return value.replace('\\\\', '\\').replace('\\"', '"')
+        if not is_filename or value[:2] != "\\\\":
+            return value.replace("\\\\", "\\").replace('\\"', '"')
     return value
 
 
@@ -472,19 +485,24 @@ def get_encodings_from_content(content):
 
     :param content: bytestring to extract encodings from.
     """
-    warnings.warn((
-        'In requests 3.0, get_encodings_from_content will be removed. For '
-        'more information, please see the discussion on issue #2266. (This'
-        ' warning should only appear once.)'),
-        DeprecationWarning)
+    warnings.warn(
+        (
+            "In requests 3.0, get_encodings_from_content will be removed. For "
+            "more information, please see the discussion on issue #2266. (This"
+            " warning should only appear once.)"
+        ),
+        DeprecationWarning,
+    )
 
     charset_re = re.compile(r'<meta.*?charset=["\']*(.+?)["\'>]', flags=re.I)
     pragma_re = re.compile(r'<meta.*?content=["\']*;?charset=(.+?)["\'>]', flags=re.I)
     xml_re = re.compile(r'^<\?xml.*?encoding=["\']*(.+?)["\'>]')
 
-    return (charset_re.findall(content) +
-            pragma_re.findall(content) +
-            xml_re.findall(content))
+    return (
+        charset_re.findall(content)
+        + pragma_re.findall(content)
+        + xml_re.findall(content)
+    )
 
 
 def _parse_content_type_header(header):
@@ -495,7 +513,7 @@ def _parse_content_type_header(header):
          parameters
     """
 
-    tokens = header.split(';')
+    tokens = header.split(";")
     content_type, params = tokens[0].strip(), tokens[1:]
     params_dict = {}
     items_to_strip = "\"' "
@@ -507,7 +525,7 @@ def _parse_content_type_header(header):
             index_of_equals = param.find("=")
             if index_of_equals != -1:
                 key = param[:index_of_equals].strip(items_to_strip)
-                value = param[index_of_equals + 1:].strip(items_to_strip)
+                value = param[index_of_equals + 1 :].strip(items_to_strip)
             params_dict[key.lower()] = value
     return content_type, params_dict
 
@@ -519,38 +537,37 @@ def get_encoding_from_headers(headers):
     :rtype: str
     """
 
-    content_type = headers.get('content-type')
+    content_type = headers.get("content-type")
 
     if not content_type:
         return None
 
     content_type, params = _parse_content_type_header(content_type)
 
-    if 'charset' in params:
-        return params['charset'].strip("'\"")
+    if "charset" in params:
+        return params["charset"].strip("'\"")
 
-    if 'text' in content_type:
-        return 'ISO-8859-1'
+    if "text" in content_type:
+        return "ISO-8859-1"
 
-    if 'application/json' in content_type:
+    if "application/json" in content_type:
         # Assume UTF-8 based on RFC 4627: https://www.ietf.org/rfc/rfc4627.txt since the charset was unset
-        return 'utf-8'
+        return "utf-8"
 
 
 def stream_decode_response_unicode(iterator, r):
-    """Stream decodes a iterator."""
+    """Stream decodes an iterator."""
 
     if r.encoding is None:
-        for item in iterator:
-            yield item
+        yield from iterator
         return
 
-    decoder = codecs.getincrementaldecoder(r.encoding)(errors='replace')
+    decoder = codecs.getincrementaldecoder(r.encoding)(errors="replace")
     for chunk in iterator:
         rv = decoder.decode(chunk)
         if rv:
             yield rv
-    rv = decoder.decode(b'', final=True)
+    rv = decoder.decode(b"", final=True)
     if rv:
         yield rv
 
@@ -561,7 +578,7 @@ def iter_slices(string, slice_length):
     if slice_length is None or slice_length <= 0:
         slice_length = len(string)
     while pos < len(string):
-        yield string[pos:pos + slice_length]
+        yield string[pos : pos + slice_length]
         pos += slice_length
 
 
@@ -577,11 +594,14 @@ def get_unicode_from_response(r):
 
     :rtype: str
     """
-    warnings.warn((
-        'In requests 3.0, get_unicode_from_response will be removed. For '
-        'more information, please see the discussion on issue #2266. (This'
-        ' warning should only appear once.)'),
-        DeprecationWarning)
+    warnings.warn(
+        (
+            "In requests 3.0, get_unicode_from_response will be removed. For "
+            "more information, please see the discussion on issue #2266. (This"
+            " warning should only appear once.)"
+        ),
+        DeprecationWarning,
+    )
 
     tried_encodings = []
 
@@ -596,14 +616,15 @@ def get_unicode_from_response(r):
 
     # Fall back:
     try:
-        return str(r.content, encoding, errors='replace')
+        return str(r.content, encoding, errors="replace")
     except TypeError:
         return r.content
 
 
 # The unreserved URI characters (RFC 3986)
 UNRESERVED_SET = frozenset(
-    "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz" + "0123456789-._~")
+    "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz" + "0123456789-._~"
+)
 
 
 def unquote_unreserved(uri):
@@ -612,22 +633,22 @@ def unquote_unreserved(uri):
 
     :rtype: str
     """
-    parts = uri.split('%')
+    parts = uri.split("%")
     for i in range(1, len(parts)):
         h = parts[i][0:2]
         if len(h) == 2 and h.isalnum():
             try:
                 c = chr(int(h, 16))
             except ValueError:
-                raise InvalidURL("Invalid percent-escape sequence: '%s'" % h)
+                raise InvalidURL(f"Invalid percent-escape sequence: '{h}'")
 
             if c in UNRESERVED_SET:
                 parts[i] = c + parts[i][2:]
             else:
-                parts[i] = '%' + parts[i]
+                parts[i] = f"%{parts[i]}"
         else:
-            parts[i] = '%' + parts[i]
-    return ''.join(parts)
+            parts[i] = f"%{parts[i]}"
+    return "".join(parts)
 
 
 def requote_uri(uri):
@@ -660,10 +681,10 @@ def address_in_network(ip, net):
 
     :rtype: bool
     """
-    ipaddr = struct.unpack('=L', socket.inet_aton(ip))[0]
-    netaddr, bits = net.split('/')
-    netmask = struct.unpack('=L', socket.inet_aton(dotted_netmask(int(bits))))[0]
-    network = struct.unpack('=L', socket.inet_aton(netaddr))[0] & netmask
+    ipaddr = struct.unpack("=L", socket.inet_aton(ip))[0]
+    netaddr, bits = net.split("/")
+    netmask = struct.unpack("=L", socket.inet_aton(dotted_netmask(int(bits))))[0]
+    network = struct.unpack("=L", socket.inet_aton(netaddr))[0] & netmask
     return (ipaddr & netmask) == (network & netmask)
 
 
@@ -674,8 +695,8 @@ def dotted_netmask(mask):
 
     :rtype: str
     """
-    bits = 0xffffffff ^ (1 << 32 - mask) - 1
-    return socket.inet_ntoa(struct.pack('>I', bits))
+    bits = 0xFFFFFFFF ^ (1 << 32 - mask) - 1
+    return socket.inet_ntoa(struct.pack(">I", bits))
 
 
 def is_ipv4_address(string_ip):
@@ -684,7 +705,7 @@ def is_ipv4_address(string_ip):
     """
     try:
         socket.inet_aton(string_ip)
-    except socket.error:
+    except OSError:
         return False
     return True
 
@@ -695,9 +716,9 @@ def is_valid_cidr(string_network):
 
     :rtype: bool
     """
-    if string_network.count('/') == 1:
+    if string_network.count("/") == 1:
         try:
-            mask = int(string_network.split('/')[1])
+            mask = int(string_network.split("/")[1])
         except ValueError:
             return False
 
@@ -705,8 +726,8 @@ def is_valid_cidr(string_network):
             return False
 
         try:
-            socket.inet_aton(string_network.split('/')[0])
-        except socket.error:
+            socket.inet_aton(string_network.split("/")[0])
+        except OSError:
             return False
     else:
         return False
@@ -743,13 +764,14 @@ def should_bypass_proxies(url, no_proxy):
     """
     # Prioritize lowercase environment variables over uppercase
     # to keep a consistent behaviour with other http projects (curl, wget).
-    get_proxy = lambda k: os.environ.get(k) or os.environ.get(k.upper())
+    def get_proxy(key):
+        return os.environ.get(key) or os.environ.get(key.upper())
 
     # First check whether no_proxy is defined. If it is, check that the URL
     # we're getting isn't in the no_proxy list.
     no_proxy_arg = no_proxy
     if no_proxy is None:
-        no_proxy = get_proxy('no_proxy')
+        no_proxy = get_proxy("no_proxy")
     parsed = urlparse(url)
 
     if parsed.hostname is None:
@@ -759,9 +781,7 @@ def should_bypass_proxies(url, no_proxy):
     if no_proxy:
         # We need to check whether we match here. We need to see if we match
         # the end of the hostname, both with and without the port.
-        no_proxy = (
-            host for host in no_proxy.replace(' ', '').split(',') if host
-        )
+        no_proxy = (host for host in no_proxy.replace(" ", "").split(",") if host)
 
         if is_ipv4_address(parsed.hostname):
             for proxy_ip in no_proxy:
@@ -775,7 +795,7 @@ def should_bypass_proxies(url, no_proxy):
         else:
             host_with_port = parsed.hostname
             if parsed.port:
-                host_with_port += ':{}'.format(parsed.port)
+                host_with_port += f":{parsed.port}"
 
             for host in no_proxy:
                 if parsed.hostname.endswith(host) or host_with_port.endswith(host):
@@ -783,7 +803,7 @@ def should_bypass_proxies(url, no_proxy):
                     # to apply the proxies on this URL.
                     return True
 
-    with set_environ('no_proxy', no_proxy_arg):
+    with set_environ("no_proxy", no_proxy_arg):
         # parsed.hostname can be `None` in cases such as a file URI.
         try:
             bypass = proxy_bypass(parsed.hostname)
@@ -817,13 +837,13 @@ def select_proxy(url, proxies):
     proxies = proxies or {}
     urlparts = urlparse(url)
     if urlparts.hostname is None:
-        return proxies.get(urlparts.scheme, proxies.get('all'))
+        return proxies.get(urlparts.scheme, proxies.get("all"))
 
     proxy_keys = [
-        urlparts.scheme + '://' + urlparts.hostname,
+        urlparts.scheme + "://" + urlparts.hostname,
         urlparts.scheme,
-        'all://' + urlparts.hostname,
-        'all',
+        "all://" + urlparts.hostname,
+        "all",
     ]
     proxy = None
     for proxy_key in proxy_keys:
@@ -848,13 +868,13 @@ def resolve_proxies(request, proxies, trust_env=True):
     proxies = proxies if proxies is not None else {}
     url = request.url
     scheme = urlparse(url).scheme
-    no_proxy = proxies.get('no_proxy')
+    no_proxy = proxies.get("no_proxy")
     new_proxies = proxies.copy()
 
     if trust_env and not should_bypass_proxies(url, no_proxy=no_proxy):
         environ_proxies = get_environ_proxies(url, no_proxy=no_proxy)
 
-        proxy = environ_proxies.get(scheme, environ_proxies.get('all'))
+        proxy = environ_proxies.get(scheme, environ_proxies.get("all"))
 
         if proxy:
             new_proxies.setdefault(scheme, proxy)
@@ -867,19 +887,21 @@ def default_user_agent(name="python-requests"):
 
     :rtype: str
     """
-    return '%s/%s' % (name, __version__)
+    return f"{name}/{__version__}"
 
 
 def default_headers():
     """
     :rtype: requests.structures.CaseInsensitiveDict
     """
-    return CaseInsensitiveDict({
-        'User-Agent': default_user_agent(),
-        'Accept-Encoding': DEFAULT_ACCEPT_ENCODING,
-        'Accept': '*/*',
-        'Connection': 'keep-alive',
-    })
+    return CaseInsensitiveDict(
+        {
+            "User-Agent": default_user_agent(),
+            "Accept-Encoding": DEFAULT_ACCEPT_ENCODING,
+            "Accept": "*/*",
+            "Connection": "keep-alive",
+        }
+    )
 
 
 def parse_header_links(value):
@@ -892,23 +914,23 @@ def parse_header_links(value):
 
     links = []
 
-    replace_chars = ' \'"'
+    replace_chars = " '\""
 
     value = value.strip(replace_chars)
     if not value:
         return links
 
-    for val in re.split(', *<', value):
+    for val in re.split(", *<", value):
         try:
-            url, params = val.split(';', 1)
+            url, params = val.split(";", 1)
         except ValueError:
-            url, params = val, ''
+            url, params = val, ""
 
-        link = {'url': url.strip('<> \'"')}
+        link = {"url": url.strip("<> '\"")}
 
-        for param in params.split(';'):
+        for param in params.split(";"):
             try:
-                key, value = param.split('=')
+                key, value = param.split("=")
             except ValueError:
                 break
 
@@ -920,7 +942,7 @@ def parse_header_links(value):
 
 
 # Null bytes; no need to recreate these on each call to guess_json_utf
-_null = '\x00'.encode('ascii')  # encoding to ASCII for Python 3
+_null = "\x00".encode("ascii")  # encoding to ASCII for Python 3
 _null2 = _null * 2
 _null3 = _null * 3
 
@@ -934,25 +956,25 @@ def guess_json_utf(data):
     # determine the encoding. Also detect a BOM, if present.
     sample = data[:4]
     if sample in (codecs.BOM_UTF32_LE, codecs.BOM_UTF32_BE):
-        return 'utf-32'     # BOM included
+        return "utf-32"  # BOM included
     if sample[:3] == codecs.BOM_UTF8:
-        return 'utf-8-sig'  # BOM included, MS style (discouraged)
+        return "utf-8-sig"  # BOM included, MS style (discouraged)
     if sample[:2] in (codecs.BOM_UTF16_LE, codecs.BOM_UTF16_BE):
-        return 'utf-16'     # BOM included
+        return "utf-16"  # BOM included
     nullcount = sample.count(_null)
     if nullcount == 0:
-        return 'utf-8'
+        return "utf-8"
     if nullcount == 2:
-        if sample[::2] == _null2:   # 1st and 3rd are null
-            return 'utf-16-be'
+        if sample[::2] == _null2:  # 1st and 3rd are null
+            return "utf-16-be"
         if sample[1::2] == _null2:  # 2nd and 4th are null
-            return 'utf-16-le'
+            return "utf-16-le"
         # Did not detect 2 valid UTF-16 ascii-range characters
     if nullcount == 3:
         if sample[:3] == _null3:
-            return 'utf-32-be'
+            return "utf-32-be"
         if sample[1:] == _null3:
-            return 'utf-32-le'
+            return "utf-32-le"
         # Did not detect a valid UTF-32 ascii-range character
     return None
 
@@ -977,13 +999,13 @@ def prepend_scheme_if_needed(url, new_scheme):
     if auth:
         # parse_url doesn't provide the netloc with auth
         # so we'll add it ourselves.
-        netloc = '@'.join([auth, netloc])
+        netloc = "@".join([auth, netloc])
     if scheme is None:
         scheme = new_scheme
     if path is None:
-        path = ''
+        path = ""
 
-    return urlunparse((scheme, netloc, path, '', query, fragment))
+    return urlunparse((scheme, netloc, path, "", query, fragment))
 
 
 def get_auth_from_url(url):
@@ -997,35 +1019,36 @@ def get_auth_from_url(url):
     try:
         auth = (unquote(parsed.username), unquote(parsed.password))
     except (AttributeError, TypeError):
-        auth = ('', '')
+        auth = ("", "")
 
     return auth
 
 
-# Moved outside of function to avoid recompile every call
-_CLEAN_HEADER_REGEX_BYTE = re.compile(b'^\\S[^\\r\\n]*$|^$')
-_CLEAN_HEADER_REGEX_STR = re.compile(r'^\S[^\r\n]*$|^$')
-
-
 def check_header_validity(header):
-    """Verifies that header value is a string which doesn't contain
-    leading whitespace or return characters. This prevents unintended
-    header injection.
+    """Verifies that header parts don't contain leading whitespace
+    reserved characters, or return characters.
 
     :param header: tuple, in the format (name, value).
     """
     name, value = header
 
-    if isinstance(value, bytes):
-        pat = _CLEAN_HEADER_REGEX_BYTE
-    else:
-        pat = _CLEAN_HEADER_REGEX_STR
-    try:
-        if not pat.match(value):
-            raise InvalidHeader("Invalid return character or leading space in header: %s" % name)
-    except TypeError:
-        raise InvalidHeader("Value for header {%s: %s} must be of type str or "
-                            "bytes, not %s" % (name, value, type(value)))
+    for part in header:
+        if type(part) not in HEADER_VALIDATORS:
+            raise InvalidHeader(
+                f"Header part ({part!r}) from {{{name!r}: {value!r}}} must be "
+                f"of type str or bytes, not {type(part)}"
+            )
+
+    _validate_header_part(name, "name", HEADER_VALIDATORS[type(name)][0])
+    _validate_header_part(value, "value", HEADER_VALIDATORS[type(value)][1])
+
+
+def _validate_header_part(header_part, header_kind, validator):
+    if not validator.match(header_part):
+        raise InvalidHeader(
+            f"Invalid leading whitespace, reserved character(s), or return"
+            f"character(s) in header {header_kind}: {header_part!r}"
+        )
 
 
 def urldefragauth(url):
@@ -1040,21 +1063,24 @@ def urldefragauth(url):
     if not netloc:
         netloc, path = path, netloc
 
-    netloc = netloc.rsplit('@', 1)[-1]
+    netloc = netloc.rsplit("@", 1)[-1]
 
-    return urlunparse((scheme, netloc, path, params, query, ''))
+    return urlunparse((scheme, netloc, path, params, query, ""))
 
 
 def rewind_body(prepared_request):
     """Move file pointer back to its recorded starting position
     so it can be read again on redirect.
     """
-    body_seek = getattr(prepared_request.body, 'seek', None)
-    if body_seek is not None and isinstance(prepared_request._body_position, integer_types):
+    body_seek = getattr(prepared_request.body, "seek", None)
+    if body_seek is not None and isinstance(
+        prepared_request._body_position, integer_types
+    ):
         try:
             body_seek(prepared_request._body_position)
-        except (IOError, OSError):
-            raise UnrewindableBodyError("An error occurred when rewinding request "
-                                        "body for redirect.")
+        except OSError:
+            raise UnrewindableBodyError(
+                "An error occurred when rewinding request body for redirect."
+            )
     else:
         raise UnrewindableBodyError("Unable to rewind request body for redirect.")
diff --git a/lib/urllib3/__init__.py b/lib/urllib3/__init__.py
index fe86b59d..c6fa3821 100644
--- a/lib/urllib3/__init__.py
+++ b/lib/urllib3/__init__.py
@@ -19,6 +19,23 @@ from .util.retry import Retry
 from .util.timeout import Timeout
 from .util.url import get_host
 
+# === NOTE TO REPACKAGERS AND VENDORS ===
+# Please delete this block, this logic is only
+# for urllib3 being distributed via PyPI.
+# See: https://github.com/urllib3/urllib3/issues/2680
+try:
+    import urllib3_secure_extra  # type: ignore # noqa: F401
+except ImportError:
+    pass
+else:
+    warnings.warn(
+        "'urllib3[secure]' extra is deprecated and will be removed "
+        "in a future release of urllib3 2.x. Read more in this issue: "
+        "https://github.com/urllib3/urllib3/issues/2680",
+        category=DeprecationWarning,
+        stacklevel=2,
+    )
+
 __author__ = "Andrey Petrov (andrey.petrov@shazow.net)"
 __license__ = "MIT"
 __version__ = __version__
diff --git a/lib/urllib3/_version.py b/lib/urllib3/_version.py
index d905b697..6fbc84b3 100644
--- a/lib/urllib3/_version.py
+++ b/lib/urllib3/_version.py
@@ -1,2 +1,2 @@
 # This file is protected via CODEOWNERS
-__version__ = "1.26.9"
+__version__ = "1.26.12"
diff --git a/lib/urllib3/connection.py b/lib/urllib3/connection.py
index 7bf395bd..10fb36c4 100644
--- a/lib/urllib3/connection.py
+++ b/lib/urllib3/connection.py
@@ -68,7 +68,7 @@ port_by_scheme = {"http": 80, "https": 443}
 
 # When it comes time to update this value as a part of regular maintenance
 # (ie test_recent_date is failing) update it to ~6 months before the current date.
-RECENT_DATE = datetime.date(2020, 7, 1)
+RECENT_DATE = datetime.date(2022, 1, 1)
 
 _CONTAINS_CONTROL_CHAR_RE = re.compile(r"[^-!#$%&'*+.^_`|~0-9a-zA-Z]")
 
diff --git a/lib/urllib3/connectionpool.py b/lib/urllib3/connectionpool.py
index 15bffcb2..96339e90 100644
--- a/lib/urllib3/connectionpool.py
+++ b/lib/urllib3/connectionpool.py
@@ -767,6 +767,8 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
                 isinstance(e, BaseSSLError)
                 and self.proxy
                 and _is_ssl_error_message_from_http_proxy(e)
+                and conn.proxy
+                and conn.proxy.scheme == "https"
             ):
                 e = ProxyError(
                     "Your proxy appears to only use HTTP and not HTTPS, "
diff --git a/lib/urllib3/contrib/pyopenssl.py b/lib/urllib3/contrib/pyopenssl.py
index def83afd..50a07d59 100644
--- a/lib/urllib3/contrib/pyopenssl.py
+++ b/lib/urllib3/contrib/pyopenssl.py
@@ -73,11 +73,20 @@ except ImportError:  # Platform-specific: Python 3
 import logging
 import ssl
 import sys
+import warnings
 
 from .. import util
 from ..packages import six
 from ..util.ssl_ import PROTOCOL_TLS_CLIENT
 
+warnings.warn(
+    "'urllib3.contrib.pyopenssl' module is deprecated and will be removed "
+    "in a future release of urllib3 2.x. Read more in this issue: "
+    "https://github.com/urllib3/urllib3/issues/2680",
+    category=DeprecationWarning,
+    stacklevel=2,
+)
+
 __all__ = ["inject_into_urllib3", "extract_from_urllib3"]
 
 # SNI always works.
@@ -406,7 +415,6 @@ if _fileobject:  # Platform-specific: Python 2
         self._makefile_refs += 1
         return _fileobject(self, mode, bufsize, close=True)
 
-
 else:  # Platform-specific: Python 3
     makefile = backport_makefile
 
diff --git a/lib/urllib3/contrib/securetransport.py b/lib/urllib3/contrib/securetransport.py
index 554c015f..6c46a3b9 100644
--- a/lib/urllib3/contrib/securetransport.py
+++ b/lib/urllib3/contrib/securetransport.py
@@ -770,7 +770,6 @@ if _fileobject:  # Platform-specific: Python 2
         self._makefile_refs += 1
         return _fileobject(self, mode, bufsize, close=True)
 
-
 else:  # Platform-specific: Python 3
 
     def makefile(self, mode="r", buffering=None, *args, **kwargs):
diff --git a/lib/urllib3/packages/six.py b/lib/urllib3/packages/six.py
index ba50acb0..f099a3dc 100644
--- a/lib/urllib3/packages/six.py
+++ b/lib/urllib3/packages/six.py
@@ -772,7 +772,6 @@ if PY3:
             value = None
             tb = None
 
-
 else:
 
     def exec_(_code_, _globs_=None, _locs_=None):
diff --git a/lib/urllib3/response.py b/lib/urllib3/response.py
index fdb50ddb..01f08eee 100644
--- a/lib/urllib3/response.py
+++ b/lib/urllib3/response.py
@@ -2,6 +2,7 @@ from __future__ import absolute_import
 
 import io
 import logging
+import sys
 import zlib
 from contextlib import contextmanager
 from socket import error as SocketError
@@ -15,6 +16,7 @@ try:
 except ImportError:
     brotli = None
 
+from . import util
 from ._collections import HTTPHeaderDict
 from .connection import BaseSSLError, HTTPException
 from .exceptions import (
@@ -481,6 +483,54 @@ class HTTPResponse(io.IOBase):
             if self._original_response and self._original_response.isclosed():
                 self.release_conn()
 
+    def _fp_read(self, amt):
+        """
+        Read a response with the thought that reading the number of bytes
+        larger than can fit in a 32-bit int at a time via SSL in some
+        known cases leads to an overflow error that has to be prevented
+        if `amt` or `self.length_remaining` indicate that a problem may
+        happen.
+
+        The known cases:
+          * 3.8 <= CPython < 3.9.7 because of a bug
+            https://github.com/urllib3/urllib3/issues/2513#issuecomment-1152559900.
+          * urllib3 injected with pyOpenSSL-backed SSL-support.
+          * CPython < 3.10 only when `amt` does not fit 32-bit int.
+        """
+        assert self._fp
+        c_int_max = 2 ** 31 - 1
+        if (
+            (
+                (amt and amt > c_int_max)
+                or (self.length_remaining and self.length_remaining > c_int_max)
+            )
+            and not util.IS_SECURETRANSPORT
+            and (util.IS_PYOPENSSL or sys.version_info < (3, 10))
+        ):
+            buffer = io.BytesIO()
+            # Besides `max_chunk_amt` being a maximum chunk size, it
+            # affects memory overhead of reading a response by this
+            # method in CPython.
+            # `c_int_max` equal to 2 GiB - 1 byte is the actual maximum
+            # chunk size that does not lead to an overflow error, but
+            # 256 MiB is a compromise.
+            max_chunk_amt = 2 ** 28
+            while amt is None or amt != 0:
+                if amt is not None:
+                    chunk_amt = min(amt, max_chunk_amt)
+                    amt -= chunk_amt
+                else:
+                    chunk_amt = max_chunk_amt
+                data = self._fp.read(chunk_amt)
+                if not data:
+                    break
+                buffer.write(data)
+                del data  # to reduce peak memory usage by `max_chunk_amt`.
+            return buffer.getvalue()
+        else:
+            # StringIO doesn't like amt=None
+            return self._fp.read(amt) if amt is not None else self._fp.read()
+
     def read(self, amt=None, decode_content=None, cache_content=False):
         """
         Similar to :meth:`http.client.HTTPResponse.read`, but with two additional
@@ -513,13 +563,11 @@ class HTTPResponse(io.IOBase):
         fp_closed = getattr(self._fp, "closed", False)
 
         with self._error_catcher():
+            data = self._fp_read(amt) if not fp_closed else b""
             if amt is None:
-                # cStringIO doesn't like amt=None
-                data = self._fp.read() if not fp_closed else b""
                 flush_decoder = True
             else:
                 cache_content = False
-                data = self._fp.read(amt) if not fp_closed else b""
                 if (
                     amt != 0 and not data
                 ):  # Platform-specific: Buggy versions of Python.
diff --git a/lib/urllib3/util/url.py b/lib/urllib3/util/url.py
index 81a03da9..b667c160 100644
--- a/lib/urllib3/util/url.py
+++ b/lib/urllib3/util/url.py
@@ -279,6 +279,9 @@ def _normalize_host(host, scheme):
         if scheme in NORMALIZABLE_SCHEMES:
             is_ipv6 = IPV6_ADDRZ_RE.match(host)
             if is_ipv6:
+                # IPv6 hosts of the form 'a::b%zone' are encoded in a URL as
+                # such per RFC 6874: 'a::b%25zone'. Unquote the ZoneID
+                # separator as necessary to return a valid RFC 4007 scoped IP.
                 match = ZONE_ID_RE.search(host)
                 if match:
                     start, end = match.span(1)
@@ -331,7 +334,7 @@ def parse_url(url):
     """
     Given a url, return a parsed :class:`.Url` namedtuple. Best-effort is
     performed to parse incomplete urls. Fields not provided will be None.
-    This parser is RFC 3986 compliant.
+    This parser is RFC 3986 and RFC 6874 compliant.
 
     The parser logic and helper functions are based heavily on
     work done in the ``rfc3986`` module.
diff --git a/lib/urllib3/util/wait.py b/lib/urllib3/util/wait.py
index c280646c..21b4590b 100644
--- a/lib/urllib3/util/wait.py
+++ b/lib/urllib3/util/wait.py
@@ -42,7 +42,6 @@ if sys.version_info >= (3, 5):
     def _retry_on_intr(fn, timeout):
         return fn(timeout)
 
-
 else:
     # Old and broken Pythons.
     def _retry_on_intr(fn, timeout):
diff --git a/requirements.txt b/requirements.txt
index 10edc91e..4d6f3505 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -35,7 +35,7 @@ pyparsing==3.0.9
 python-dateutil==2.8.2
 python-twitter==3.5
 pytz==2022.1
-requests==2.27.1
+requests==2.28.1
 requests-oauthlib==1.3.1
 rumps==0.3.0; platform_system == "Darwin"
 simplejson==3.17.6

From 76649be6e4992714cf727b2cd55095c37e0235aa Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 12 Nov 2022 17:14:13 -0800
Subject: [PATCH 215/743] Bump tempora from 5.0.1 to 5.0.2 (#1795)

Bumps [tempora](https://github.com/jaraco/tempora) from 5.0.1 to 5.0.2.
- [Release notes](https://github.com/jaraco/tempora/releases)
- [Changelog](https://github.com/jaraco/tempora/blob/main/CHANGES.rst)
- [Commits](https://github.com/jaraco/tempora/compare/v5.0.1...v5.0.2)

---
updated-dependencies:
- dependency-name: tempora
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements.txt b/requirements.txt
index 4d6f3505..ea2263ac 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -41,7 +41,7 @@ rumps==0.3.0; platform_system == "Darwin"
 simplejson==3.17.6
 six==1.16.0
 soupsieve==2.3.2.post1
-tempora==5.0.1
+tempora==5.0.2
 tokenize-rt==4.2.1
 tzdata==2022.1
 tzlocal==4.2

From 58aab24c286858158d66ef15bc303162179bc6a6 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 12 Nov 2022 17:18:11 -0800
Subject: [PATCH 216/743] Bump arrow from 1.2.2 to 1.2.3 (#1829)

* Bump arrow from 1.2.2 to 1.2.3

Bumps [arrow](https://github.com/arrow-py/arrow) from 1.2.2 to 1.2.3.
- [Release notes](https://github.com/arrow-py/arrow/releases)
- [Changelog](https://github.com/arrow-py/arrow/blob/master/CHANGELOG.rst)
- [Commits](https://github.com/arrow-py/arrow/compare/1.2.2...1.2.3)

---
updated-dependencies:
- dependency-name: arrow
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

* Update arrow==1.2.3

Signed-off-by: dependabot[bot] <support@github.com>
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/arrow/_version.py  |   2 +-
 lib/arrow/arrow.py     |   6 +-
 lib/arrow/constants.py |  12 +-
 lib/arrow/locales.py   | 585 ++++++++++++++++++++++++++++++++++++-----
 requirements.txt       |   2 +-
 5 files changed, 540 insertions(+), 67 deletions(-)

diff --git a/lib/arrow/_version.py b/lib/arrow/_version.py
index bc86c944..10aa336c 100644
--- a/lib/arrow/_version.py
+++ b/lib/arrow/_version.py
@@ -1 +1 @@
-__version__ = "1.2.2"
+__version__ = "1.2.3"
diff --git a/lib/arrow/arrow.py b/lib/arrow/arrow.py
index 21b0347f..1ede107f 100644
--- a/lib/arrow/arrow.py
+++ b/lib/arrow/arrow.py
@@ -1384,7 +1384,7 @@ class Arrow:
                 search_string = search_string.format(r"\d+")
 
                 # Create search pattern and find within string
-                pattern = re.compile(fr"(^|\b|\d){search_string}")
+                pattern = re.compile(rf"(^|\b|\d){search_string}")
                 match = pattern.search(input_string)
 
                 # If there is no match continue to next iteration
@@ -1426,12 +1426,12 @@ class Arrow:
         # Sign logic
         future_string = locale_obj.future
         future_string = future_string.format(".*")
-        future_pattern = re.compile(fr"^{future_string}$")
+        future_pattern = re.compile(rf"^{future_string}$")
         future_pattern_match = future_pattern.findall(input_string)
 
         past_string = locale_obj.past
         past_string = past_string.format(".*")
-        past_pattern = re.compile(fr"^{past_string}$")
+        past_pattern = re.compile(rf"^{past_string}$")
         past_pattern_match = past_pattern.findall(input_string)
 
         # If a string contains the now unit, there will be no relative units, hence the need to check if the now unit
diff --git a/lib/arrow/constants.py b/lib/arrow/constants.py
index 1189d07c..53d163b9 100644
--- a/lib/arrow/constants.py
+++ b/lib/arrow/constants.py
@@ -21,7 +21,7 @@ except (OverflowError, ValueError, OSError):  # pragma: no cover
     # Must get max value of ctime on Windows based on architecture (x32 vs x64)
     # https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/ctime-ctime32-ctime64-wctime-wctime32-wctime64
     # Note: this may occur on both 32-bit Linux systems (issue #930) along with Windows systems
-    is_64bits = sys.maxsize > 2 ** 32
+    is_64bits = sys.maxsize > 2**32
     _MAX_TIMESTAMP = (
         datetime(3000, 1, 1, 23, 59, 59, 999999).timestamp()
         if is_64bits
@@ -162,6 +162,16 @@ DEHUMANIZE_LOCALES = {
     "ta-lk",
     "ur",
     "ur-pk",
+    "ka",
+    "ka-ge",
     "kk",
     "kk-kz",
+    # "lo",
+    # "lo-la",
+    "am",
+    "am-et",
+    "hy-am",
+    "hy",
+    "uz",
+    "uz-uz",
 }
diff --git a/lib/arrow/locales.py b/lib/arrow/locales.py
index b7fb0d32..3627497f 100644
--- a/lib/arrow/locales.py
+++ b/lib/arrow/locales.py
@@ -45,7 +45,6 @@ _TimeFrameElements = Union[
     str, Sequence[str], Mapping[str, str], Mapping[str, Sequence[str]]
 ]
 
-
 _locale_map: Dict[str, Type["Locale"]] = {}
 
 
@@ -296,7 +295,6 @@ class Locale:
 
 
 class EnglishLocale(Locale):
-
     names = [
         "en",
         "en-us",
@@ -560,7 +558,6 @@ class SpanishLocale(Locale):
 
 
 class FrenchBaseLocale(Locale):
-
     past = "il y a {0}"
     future = "dans {0}"
     and_word = "et"
@@ -622,7 +619,6 @@ class FrenchBaseLocale(Locale):
 
 
 class FrenchLocale(FrenchBaseLocale, Locale):
-
     names = ["fr", "fr-fr"]
 
     month_abbreviations = [
@@ -643,7 +639,6 @@ class FrenchLocale(FrenchBaseLocale, Locale):
 
 
 class FrenchCanadianLocale(FrenchBaseLocale, Locale):
-
     names = ["fr-ca"]
 
     month_abbreviations = [
@@ -664,7 +659,6 @@ class FrenchCanadianLocale(FrenchBaseLocale, Locale):
 
 
 class GreekLocale(Locale):
-
     names = ["el", "el-gr"]
 
     past = "{0} πριν"
@@ -734,7 +728,6 @@ class GreekLocale(Locale):
 
 
 class JapaneseLocale(Locale):
-
     names = ["ja", "ja-jp"]
 
     past = "{0}前"
@@ -795,7 +788,6 @@ class JapaneseLocale(Locale):
 
 
 class SwedishLocale(Locale):
-
     names = ["sv", "sv-se"]
 
     past = "för {0} sen"
@@ -865,7 +857,6 @@ class SwedishLocale(Locale):
 
 
 class FinnishLocale(Locale):
-
     names = ["fi", "fi-fi"]
 
     # The finnish grammar is very complex, and its hard to convert
@@ -952,7 +943,6 @@ class FinnishLocale(Locale):
 
 
 class ChineseCNLocale(Locale):
-
     names = ["zh", "zh-cn"]
 
     past = "{0}前"
@@ -1012,7 +1002,6 @@ class ChineseCNLocale(Locale):
 
 
 class ChineseTWLocale(Locale):
-
     names = ["zh-tw"]
 
     past = "{0}前"
@@ -1073,7 +1062,6 @@ class ChineseTWLocale(Locale):
 
 
 class HongKongLocale(Locale):
-
     names = ["zh-hk"]
 
     past = "{0}前"
@@ -1133,7 +1121,6 @@ class HongKongLocale(Locale):
 
 
 class KoreanLocale(Locale):
-
     names = ["ko", "ko-kr"]
 
     past = "{0} 전"
@@ -1229,7 +1216,6 @@ class KoreanLocale(Locale):
 
 # derived locale types & implementations.
 class DutchLocale(Locale):
-
     names = ["nl", "nl-nl"]
 
     past = "{0} geleden"
@@ -1318,7 +1304,6 @@ class SlavicBaseLocale(Locale):
 
 
 class BelarusianLocale(SlavicBaseLocale):
-
     names = ["be", "be-by"]
 
     past = "{0} таму"
@@ -1397,7 +1382,6 @@ class BelarusianLocale(SlavicBaseLocale):
 
 
 class PolishLocale(SlavicBaseLocale):
-
     names = ["pl", "pl-pl"]
 
     past = "{0} temu"
@@ -1488,7 +1472,6 @@ class PolishLocale(SlavicBaseLocale):
 
 
 class RussianLocale(SlavicBaseLocale):
-
     names = ["ru", "ru-ru"]
 
     past = "{0} назад"
@@ -1579,7 +1562,6 @@ class RussianLocale(SlavicBaseLocale):
 
 
 class AfrikaansLocale(Locale):
-
     names = ["af", "af-nl"]
 
     past = "{0} gelede"
@@ -1646,7 +1628,6 @@ class AfrikaansLocale(Locale):
 
 
 class BulgarianLocale(SlavicBaseLocale):
-
     names = ["bg", "bg-bg"]
 
     past = "{0} назад"
@@ -1725,7 +1706,6 @@ class BulgarianLocale(SlavicBaseLocale):
 
 
 class UkrainianLocale(SlavicBaseLocale):
-
     names = ["ua", "uk", "uk-ua"]
 
     past = "{0} тому"
@@ -1903,7 +1883,6 @@ class MacedonianLocale(SlavicBaseLocale):
 
 
 class GermanBaseLocale(Locale):
-
     past = "vor {0}"
     future = "in {0}"
     and_word = "und"
@@ -2009,17 +1988,14 @@ class GermanBaseLocale(Locale):
 
 
 class GermanLocale(GermanBaseLocale, Locale):
-
     names = ["de", "de-de"]
 
 
 class SwissLocale(GermanBaseLocale, Locale):
-
     names = ["de-ch"]
 
 
 class AustrianLocale(GermanBaseLocale, Locale):
-
     names = ["de-at"]
 
     month_names = [
@@ -2040,7 +2016,6 @@ class AustrianLocale(GermanBaseLocale, Locale):
 
 
 class NorwegianLocale(Locale):
-
     names = ["nb", "nb-no"]
 
     past = "for {0} siden"
@@ -2112,7 +2087,6 @@ class NorwegianLocale(Locale):
 
 
 class NewNorwegianLocale(Locale):
-
     names = ["nn", "nn-no"]
 
     past = "for {0} sidan"
@@ -2259,7 +2233,6 @@ class BrazilianPortugueseLocale(PortugueseLocale):
 
 
 class TagalogLocale(Locale):
-
     names = ["tl", "tl-ph"]
 
     past = "nakaraang {0}"
@@ -2333,7 +2306,6 @@ class TagalogLocale(Locale):
 
 
 class VietnameseLocale(Locale):
-
     names = ["vi", "vi-vn"]
 
     past = "{0} trước"
@@ -2402,7 +2374,6 @@ class VietnameseLocale(Locale):
 
 
 class TurkishLocale(Locale):
-
     names = ["tr", "tr-tr"]
 
     past = "{0} önce"
@@ -2474,7 +2445,6 @@ class TurkishLocale(Locale):
 
 
 class AzerbaijaniLocale(Locale):
-
     names = ["az", "az-az"]
 
     past = "{0} əvvəl"
@@ -2862,23 +2832,24 @@ class IcelandicLocale(Locale):
 
 
 class DanishLocale(Locale):
-
     names = ["da", "da-dk"]
 
     past = "for {0} siden"
-    future = "efter {0}"
+    future = "om {0}"
     and_word = "og"
 
     timeframes = {
         "now": "lige nu",
         "second": "et sekund",
-        "seconds": "{0} et par sekunder",
+        "seconds": "{0} sekunder",
         "minute": "et minut",
         "minutes": "{0} minutter",
         "hour": "en time",
         "hours": "{0} timer",
         "day": "en dag",
         "days": "{0} dage",
+        "week": "en uge",
+        "weeks": "{0} uger",
         "month": "en måned",
         "months": "{0} måneder",
         "year": "et år",
@@ -2928,9 +2899,11 @@ class DanishLocale(Locale):
     ]
     day_abbreviations = ["", "man", "tir", "ons", "tor", "fre", "lør", "søn"]
 
+    def _ordinal_number(self, n: int) -> str:
+        return f"{n}."
+
 
 class MalayalamLocale(Locale):
-
     names = ["ml"]
 
     past = "{0} മുമ്പ്"
@@ -3004,7 +2977,6 @@ class MalayalamLocale(Locale):
 
 
 class HindiLocale(Locale):
-
     names = ["hi", "hi-in"]
 
     past = "{0} पहले"
@@ -3333,7 +3305,6 @@ class SlovakLocale(Locale):
 
 
 class FarsiLocale(Locale):
-
     names = ["fa", "fa-ir"]
 
     past = "{0} قبل"
@@ -3407,7 +3378,6 @@ class FarsiLocale(Locale):
 
 
 class HebrewLocale(Locale):
-
     names = ["he", "he-il"]
 
     past = "לפני {0}"
@@ -3518,7 +3488,6 @@ class HebrewLocale(Locale):
 
 
 class MarathiLocale(Locale):
-
     names = ["mr"]
 
     past = "{0} आधी"
@@ -3725,7 +3694,6 @@ class BasqueLocale(Locale):
 
 
 class HungarianLocale(Locale):
-
     names = ["hu", "hu-hu"]
 
     past = "{0} ezelőtt"
@@ -3877,7 +3845,6 @@ class EsperantoLocale(Locale):
 
 
 class ThaiLocale(Locale):
-
     names = ["th", "th-th"]
 
     past = "{0} ที่ผ่านมา"
@@ -3966,8 +3933,115 @@ class ThaiLocale(Locale):
         return relative_string
 
 
-class BengaliLocale(Locale):
+class LaotianLocale(Locale):
 
+    names = ["lo", "lo-la"]
+
+    past = "{0} ກ່ອນຫນ້ານີ້"
+    future = "ໃນ {0}"
+
+    timeframes = {
+        "now": "ດຽວນີ້",
+        "second": "ວິນາທີ",
+        "seconds": "{0} ວິນາທີ",
+        "minute": "ນາທີ",
+        "minutes": "{0} ນາທີ",
+        "hour": "ຊົ່ວໂມງ",
+        "hours": "{0} ຊົ່ວໂມງ",
+        "day": "ມື້",
+        "days": "{0} ມື້",
+        "week": "ອາທິດ",
+        "weeks": "{0} ອາທິດ",
+        "month": "ເດືອນ",
+        "months": "{0} ເດືອນ",
+        "year": "ປີ",
+        "years": "{0} ປີ",
+    }
+
+    month_names = [
+        "",
+        "ມັງກອນ",  # mangkon
+        "ກຸມພາ",  # kumpha
+        "ມີນາ",  # mina
+        "ເມສາ",  # mesa
+        "ພຶດສະພາ",  # phudsapha
+        "ມິຖຸນາ",  # mithuna
+        "ກໍລະກົດ",  # kolakod
+        "ສິງຫາ",  # singha
+        "ກັນຍາ",  # knaia
+        "ຕຸລາ",  # tula
+        "ພະຈິກ",  # phachik
+        "ທັນວາ",  # thanuaa
+    ]
+    month_abbreviations = [
+        "",
+        "ມັງກອນ",
+        "ກຸມພາ",
+        "ມີນາ",
+        "ເມສາ",
+        "ພຶດສະພາ",
+        "ມິຖຸນາ",
+        "ກໍລະກົດ",
+        "ສິງຫາ",
+        "ກັນຍາ",
+        "ຕຸລາ",
+        "ພະຈິກ",
+        "ທັນວາ",
+    ]
+
+    day_names = [
+        "",
+        "ວັນຈັນ",  # vanchan
+        "ວັນອັງຄານ",  # vnoangkhan
+        "ວັນພຸດ",  # vanphud
+        "ວັນພະຫັດ",  # vanphahad
+        "ວັນ​ສຸກ",  # vansuk
+        "ວັນເສົາ",  # vansao
+        "ວັນອາທິດ",  # vnoathid
+    ]
+    day_abbreviations = [
+        "",
+        "ວັນຈັນ",
+        "ວັນອັງຄານ",
+        "ວັນພຸດ",
+        "ວັນພະຫັດ",
+        "ວັນ​ສຸກ",
+        "ວັນເສົາ",
+        "ວັນອາທິດ",
+    ]
+
+    BE_OFFSET = 543
+
+    def year_full(self, year: int) -> str:
+        """Lao always use Buddhist Era (BE) which is CE + 543"""
+        year += self.BE_OFFSET
+        return f"{year:04d}"
+
+    def year_abbreviation(self, year: int) -> str:
+        """Lao always use Buddhist Era (BE) which is CE + 543"""
+        year += self.BE_OFFSET
+        return f"{year:04d}"[2:]
+
+    def _format_relative(
+        self,
+        humanized: str,
+        timeframe: TimeFrameLiteral,
+        delta: Union[float, int],
+    ) -> str:
+        """Lao normally doesn't have any space between words"""
+        if timeframe == "now":
+            return humanized
+
+        direction = self.past if delta < 0 else self.future
+        relative_string = direction.format(humanized)
+
+        if timeframe == "seconds":
+            relative_string = relative_string.replace(" ", "")
+
+        return relative_string
+
+
+class BengaliLocale(Locale):
     names = ["bn", "bn-bd", "bn-in"]
 
     past = "{0} আগে"
@@ -4048,7 +4122,6 @@ class BengaliLocale(Locale):
 
 
 class RomanshLocale(Locale):
-
     names = ["rm", "rm-ch"]
 
     past = "avant {0}"
@@ -4255,7 +4328,6 @@ class SlovenianLocale(Locale):
 
 
 class IndonesianLocale(Locale):
-
     names = ["id", "id-id"]
 
     past = "{0} yang lalu"
@@ -4475,7 +4547,6 @@ class EstonianLocale(Locale):
 
 
 class LatvianLocale(Locale):
-
     names = ["lv", "lv-lv"]
 
     past = "pirms {0}"
@@ -4556,7 +4627,6 @@ class LatvianLocale(Locale):
 
 
 class SwahiliLocale(Locale):
-
     names = [
         "sw",
         "sw-ke",
@@ -4641,7 +4711,6 @@ class SwahiliLocale(Locale):
 
 
 class CroatianLocale(Locale):
-
     names = ["hr", "hr-hr"]
 
     past = "prije {0}"
@@ -4733,7 +4802,6 @@ class CroatianLocale(Locale):
 
 
 class LatinLocale(Locale):
-
     names = ["la", "la-va"]
 
     past = "ante {0}"
@@ -4814,7 +4882,6 @@ class LatinLocale(Locale):
 
 
 class LithuanianLocale(Locale):
-
     names = ["lt", "lt-lt"]
 
     past = "prieš {0}"
@@ -4895,7 +4962,6 @@ class LithuanianLocale(Locale):
 
 
 class MalayLocale(Locale):
-
     names = ["ms", "ms-my", "ms-bn"]
 
     past = "{0} yang lalu"
@@ -4976,7 +5042,6 @@ class MalayLocale(Locale):
 
 
 class MalteseLocale(Locale):
-
     names = ["mt", "mt-mt"]
 
     past = "{0} ilu"
@@ -5068,7 +5133,6 @@ class MalteseLocale(Locale):
 
 
 class SamiLocale(Locale):
-
     names = ["se", "se-fi", "se-no", "se-se"]
 
     past = "{0} dassái"
@@ -5148,7 +5212,6 @@ class SamiLocale(Locale):
 
 
 class OdiaLocale(Locale):
-
     names = ["or", "or-in"]
 
     past = "{0} ପୂର୍ବେ"
@@ -5239,7 +5302,6 @@ class OdiaLocale(Locale):
 
 
 class SerbianLocale(Locale):
-
     names = ["sr", "sr-rs", "sr-sp"]
 
     past = "pre {0}"
@@ -5331,7 +5393,6 @@ class SerbianLocale(Locale):
 
 
 class LuxembourgishLocale(Locale):
-
     names = ["lb", "lb-lu"]
 
     past = "virun {0}"
@@ -5422,7 +5483,6 @@ class LuxembourgishLocale(Locale):
         delta: Union[int, float] = 0,
         only_distance: bool = False,
     ) -> str:
-
         if not only_distance:
             return super().describe(timeframe, delta, only_distance)
 
@@ -5433,7 +5493,6 @@ class LuxembourgishLocale(Locale):
 
 
 class ZuluLocale(Locale):
-
     names = ["zu", "zu-za"]
 
     past = "{0} edlule"
@@ -5531,7 +5590,6 @@ class ZuluLocale(Locale):
 
 
 class TamilLocale(Locale):
-
     names = ["ta", "ta-in", "ta-lk"]
 
     past = "{0} நேரத்திற்கு முன்பு"
@@ -5619,7 +5677,6 @@ class TamilLocale(Locale):
 
 
 class AlbanianLocale(Locale):
-
     names = ["sq", "sq-al"]
 
     past = "{0} më parë"
@@ -5699,8 +5756,91 @@ class AlbanianLocale(Locale):
     ]
 
 
-class SinhalaLocale(Locale):
+class GeorgianLocale(Locale):
+    names = ["ka", "ka-ge"]
 
+    past = "{0} წინ"  # ts’in
+    future = "{0} შემდეგ"  # shemdeg
+    and_word = "და"  # da
+
+    timeframes = {
+        "now": "ახლა",  # akhla
+        # When a cardinal qualifies a noun, it stands in the singular
+        "second": "წამის",  # ts’amis
+        "seconds": "{0} წამის",
+        "minute": "წუთის",  # ts’utis
+        "minutes": "{0} წუთის",
+        "hour": "საათის",  # saatis
+        "hours": "{0} საათის",
+        "day": "დღის",  # dghis
+        "days": "{0} დღის",
+        "week": "კვირის",  # k’viris
+        "weeks": "{0} კვირის",
+        "month": "თვის",  # tvis
+        "months": "{0} თვის",
+        "year": "წლის",  # ts’lis
+        "years": "{0} წლის",
+    }
+
+    month_names = [
+        # modern month names
+        "",
+        "იანვარი",  # Ianvari
+        "თებერვალი",  # Tebervali
+        "მარტი",  # Mart'i
+        "აპრილი",  # Ap'rili
+        "მაისი",  # Maisi
+        "ივნისი",  # Ivnisi
+        "ივლისი",  # Ivlisi
+        "აგვისტო",  # Agvist'o
+        "სექტემბერი",  # Sekt'emberi
+        "ოქტომბერი",  # Okt'omberi
+        "ნოემბერი",  # Noemberi
+        "დეკემბერი",  # Dek'emberi
+    ]
+
+    month_abbreviations = [
+        # no abbr. found yet
+        "",
+        "იანვარი",  # Ianvari
+        "თებერვალი",  # Tebervali
+        "მარტი",  # Mart'i
+        "აპრილი",  # Ap'rili
+        "მაისი",  # Maisi
+        "ივნისი",  # Ivnisi
+        "ივლისი",  # Ivlisi
+        "აგვისტო",  # Agvist'o
+        "სექტემბერი",  # Sekt'emberi
+        "ოქტომბერი",  # Okt'omberi
+        "ნოემბერი",  # Noemberi
+        "დეკემბერი",  # Dek'emberi
+    ]
+
+    day_names = [
+        "",
+        "ორშაბათი",  # orshabati
+        "სამშაბათი",  # samshabati
+        "ოთხშაბათი",  # otkhshabati
+        "ხუთშაბათი",  # khutshabati
+        "პარასკევი",  # p’arask’evi
+        "შაბათი",  # shabati
+        # "k’vira" also serves as week; to avoid confusion "k’vira-dge" can be used for Sunday
+        "კვირა",  # k’vira
+    ]
+
+    day_abbreviations = [
+        "",
+        "ორშაბათი",  # orshabati
+        "სამშაბათი",  # samshabati
+        "ოთხშაბათი",  # otkhshabati
+        "ხუთშაბათი",  # khutshabati
+        "პარასკევი",  # p’arask’evi
+        "შაბათი",  # shabati
+        "კვირა",  # k’vira
+    ]
+
+
+class SinhalaLocale(Locale):
     names = ["si", "si-lk"]
 
     past = "{0}ට පෙර"
@@ -5864,7 +6004,6 @@ class SinhalaLocale(Locale):
 
 
 class UrduLocale(Locale):
-
     names = ["ur", "ur-pk"]
 
     past = "پہلے {0}"
@@ -5945,7 +6084,6 @@ class UrduLocale(Locale):
 
 
 class KazakhLocale(Locale):
-
     names = ["kk", "kk-kz"]
 
     past = "{0} бұрын"
@@ -6010,3 +6148,328 @@ class KazakhLocale(Locale):
         "Жексенбі",
     ]
     day_abbreviations = ["", "Дс", "Сс", "Ср", "Бс", "Жм", "Сб", "Жс"]
+
+
+class AmharicLocale(Locale):
+    names = ["am", "am-et"]
+
+    past = "{0} በፊት"
+    future = "{0} ውስጥ"
+    and_word = "እና"
+
+    timeframes: ClassVar[Mapping[TimeFrameLiteral, Union[Mapping[str, str], str]]] = {
+        "now": "አሁን",
+        "second": {
+            "past": "ከአንድ ሰከንድ",
+            "future": "በአንድ ሰከንድ",
+        },
+        "seconds": {
+            "past": "ከ {0} ሰከንድ",
+            "future": "በ {0} ሰከንድ",
+        },
+        "minute": {
+            "past": "ከአንድ ደቂቃ",
+            "future": "በአንድ ደቂቃ",
+        },
+        "minutes": {
+            "past": "ከ {0} ደቂቃዎች",
+            "future": "በ {0} ደቂቃዎች",
+        },
+        "hour": {
+            "past": "ከአንድ ሰዓት",
+            "future": "በአንድ ሰዓት",
+        },
+        "hours": {
+            "past": "ከ {0} ሰዓታት",
+            "future": "በ {0} ሰከንድ",
+        },
+        "day": {
+            "past": "ከአንድ ቀን",
+            "future": "በአንድ ቀን",
+        },
+        "days": {
+            "past": "ከ {0} ቀናት",
+            "future": "በ {0} ቀናት",
+        },
+        "week": {
+            "past": "ከአንድ ሳምንት",
+            "future": "በአንድ ሳምንት",
+        },
+        "weeks": {
+            "past": "ከ {0} ሳምንታት",
+            "future": "በ {0} ሳምንታት",
+        },
+        "month": {
+            "past": "ከአንድ ወር",
+            "future": "በአንድ ወር",
+        },
+        "months": {
+            "past": "ከ {0} ወር",
+            "future": "በ {0} ወራት",
+        },
+        "year": {
+            "past": "ከአንድ አመት",
+            "future": "በአንድ አመት",
+        },
+        "years": {
+            "past": "ከ {0} ዓመታት",
+            "future": "በ {0} ዓመታት",
+        },
+    }
+    # Amharic: the general format to describe timeframe is different from past and future,
+    # so we do not copy the original timeframes dictionary
+    timeframes_only_distance = {
+        "second": "አንድ ሰከንድ",
+        "seconds": "{0} ሰከንድ",
+        "minute": "አንድ ደቂቃ",
+        "minutes": "{0} ደቂቃዎች",
+        "hour": "አንድ ሰዓት",
+        "hours": "{0} ሰዓት",
+        "day": "አንድ ቀን",
+        "days": "{0} ቀናት",
+        "week": "አንድ ሳምንት",
+        "weeks": "{0} ሳምንት",
+        "month": "አንድ ወር",
+        "months": "{0} ወራት",
+        "year": "አንድ አመት",
+        "years": "{0} ዓመታት",
+    }
+
+    month_names = [
+        "",
+        "ጃንዩወሪ",
+        "ፌብሩወሪ",
+        "ማርች",
+        "ኤፕሪል",
+        "ሜይ",
+        "ጁን",
+        "ጁላይ",
+        "ኦገስት",
+        "ሴፕቴምበር",
+        "ኦክቶበር",
+        "ኖቬምበር",
+        "ዲሴምበር",
+    ]
+
+    month_abbreviations = [
+        "",
+        "ጃንዩ",
+        "ፌብሩ",
+        "ማርች",
+        "ኤፕሪ",
+        "ሜይ",
+        "ጁን",
+        "ጁላይ",
+        "ኦገስ",
+        "ሴፕቴ",
+        "ኦክቶ",
+        "ኖቬም",
+        "ዲሴም",
+    ]
+
+    day_names = [
+        "",
+        "ሰኞ",
+        "ማክሰኞ",
+        "ረቡዕ",
+        "ሐሙስ",
+        "ዓርብ",
+        "ቅዳሜ",
+        "እሑድ",
+    ]
+    day_abbreviations = ["", "እ", "ሰ", "ማ", "ረ", "ሐ", "ዓ", "ቅ"]
+
+    def _ordinal_number(self, n: int) -> str:
+        return f"{n}ኛ"
+
+    def _format_timeframe(self, timeframe: TimeFrameLiteral, delta: int) -> str:
+        """
+        Amharic awares time frame format function, takes into account
+        the differences between general, past, and future forms (three different suffixes).
+        """
+        abs_delta = abs(delta)
+        form = self.timeframes[timeframe]
+
+        if isinstance(form, str):
+            return form.format(abs_delta)
+
+        if delta > 0:
+            key = "future"
+        else:
+            key = "past"
+        form = form[key]
+
+        return form.format(abs_delta)
+
+    def describe(
+        self,
+        timeframe: TimeFrameLiteral,
+        delta: Union[float, int] = 1,  # key is always future when only_distance=False
+        only_distance: bool = False,
+    ) -> str:
+        """Describes a delta within a timeframe in plain language.
+
+        :param timeframe: a string representing a timeframe.
+        :param delta: a quantity representing a delta in a timeframe.
+        :param only_distance: return only distance eg: "11 seconds" without "in" or "ago" keywords
+        """
+
+        if not only_distance:
+            return super().describe(timeframe, delta, only_distance)
+        humanized = self.timeframes_only_distance[timeframe].format(trunc(abs(delta)))
+
+        return humanized
+
+
+class ArmenianLocale(Locale):
+    names = ["hy", "hy-am"]
+    past = "{0} առաջ"
+    future = "{0}ից"
+    and_word = "Եվ"  # Yev
+
+    timeframes = {
+        "now": "հիմա",
+        "second": "վայրկյան",
+        "seconds": "{0} վայրկյան",
+        "minute": "րոպե",
+        "minutes": "{0} րոպե",
+        "hour": "ժամ",
+        "hours": "{0} ժամ",
+        "day": "օր",
+        "days": "{0} օր",
+        "month": "ամիս",
+        "months": "{0} ամիս",
+        "year": "տարին",
+        "years": "{0} տարին",
+        "week": "շաբաթ",
+        "weeks": "{0} շաբաթ",
+    }
+
+    meridians = {
+        "am": "Ամ",
+        "pm": "պ.մ.",
+        "AM": "Ամ",
+        "PM": "պ.մ.",
+    }
+
+    month_names = [
+        "",
+        "հունվար",
+        "փետրվար",
+        "մարտ",
+        "ապրիլ",
+        "մայիս",
+        "հունիս",
+        "հուլիս",
+        "օգոստոս",
+        "սեպտեմբեր",
+        "հոկտեմբեր",
+        "նոյեմբեր",
+        "դեկտեմբեր",
+    ]
+
+    month_abbreviations = [
+        "",
+        "հունվար",
+        "փետրվար",
+        "մարտ",
+        "ապրիլ",
+        "մայիս",
+        "հունիս",
+        "հուլիս",
+        "օգոստոս",
+        "սեպտեմբեր",
+        "հոկտեմբեր",
+        "նոյեմբեր",
+        "դեկտեմբեր",
+    ]
+
+    day_names = [
+        "",
+        "երկուշաբթի",
+        "երեքշաբթի",
+        "չորեքշաբթի",
+        "հինգշաբթի",
+        "ուրբաթ",
+        "շաբաթ",
+        "կիրակի",
+    ]
+
+    day_abbreviations = [
+        "",
+        "երկ.",
+        "երեք.",
+        "չորեք.",
+        "հինգ.",
+        "ուրբ.",
+        "շաբ.",
+        "կիր.",
+    ]
+
+
+class UzbekLocale(Locale):
+    names = ["uz", "uz-uz"]
+    past = "{0}dan avval"
+    future = "{0}dan keyin"
+    timeframes = {
+        "now": "hozir",
+        "second": "bir soniya",
+        "seconds": "{0} soniya",
+        "minute": "bir daqiqa",
+        "minutes": "{0} daqiqa",
+        "hour": "bir soat",
+        "hours": "{0} soat",
+        "day": "bir kun",
+        "days": "{0} kun",
+        "week": "bir hafta",
+        "weeks": "{0} hafta",
+        "month": "bir oy",
+        "months": "{0} oy",
+        "year": "bir yil",
+        "years": "{0} yil",
+    }
+
+    month_names = [
+        "",
+        "Yanvar",
+        "Fevral",
+        "Mart",
+        "Aprel",
+        "May",
+        "Iyun",
+        "Iyul",
+        "Avgust",
+        "Sentyabr",
+        "Oktyabr",
+        "Noyabr",
+        "Dekabr",
+    ]
+
+    month_abbreviations = [
+        "",
+        "Yan",
+        "Fev",
+        "Mar",
+        "Apr",
+        "May",
+        "Iyn",
+        "Iyl",
+        "Avg",
+        "Sen",
+        "Okt",
+        "Noy",
+        "Dek",
+    ]
+
+    day_names = [
+        "",
+        "Dushanba",
+        "Seshanba",
+        "Chorshanba",
+        "Payshanba",
+        "Juma",
+        "Shanba",
+        "Yakshanba",
+    ]
+
+    day_abbreviations = ["", "Dush", "Sesh", "Chor", "Pay", "Jum", "Shan", "Yak"]
diff --git a/requirements.txt b/requirements.txt
index ea2263ac..fd8a848c 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,6 +1,6 @@
 appdirs==1.4.4
 apscheduler==3.9.1
-arrow==1.2.2
+arrow==1.2.3
 backports.csv==1.0.7
 backports.functools-lru-cache==1.6.4
 backports.zoneinfo==0.2.1

From d26ce224ce270fb106f747f2b1008fbe9e9e62f9 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 12 Nov 2022 17:19:17 -0800
Subject: [PATCH 217/743] Bump mako from 1.2.0 to 1.2.3 (#1845)

* Bump mako from 1.2.0 to 1.2.3

Bumps [mako](https://github.com/sqlalchemy/mako) from 1.2.0 to 1.2.3.
- [Release notes](https://github.com/sqlalchemy/mako/releases)
- [Changelog](https://github.com/sqlalchemy/mako/blob/main/CHANGES)
- [Commits](https://github.com/sqlalchemy/mako/commits)

---
updated-dependencies:
- dependency-name: mako
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

* Update mako==1.2.3

Signed-off-by: dependabot[bot] <support@github.com>
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/mako/__init__.py          |  4 ++--
 lib/mako/_ast_util.py         |  2 +-
 lib/mako/ast.py               |  2 +-
 lib/mako/cache.py             |  2 +-
 lib/mako/cmd.py               |  2 +-
 lib/mako/codegen.py           |  2 +-
 lib/mako/compat.py            |  2 +-
 lib/mako/exceptions.py        |  2 +-
 lib/mako/ext/autohandler.py   |  2 +-
 lib/mako/ext/babelplugin.py   |  2 +-
 lib/mako/ext/beaker_cache.py  |  2 +-
 lib/mako/ext/extract.py       |  2 +-
 lib/mako/ext/linguaplugin.py  |  2 +-
 lib/mako/ext/preprocessors.py |  2 +-
 lib/mako/ext/pygmentplugin.py |  2 +-
 lib/mako/ext/turbogears.py    |  2 +-
 lib/mako/filters.py           |  2 +-
 lib/mako/lexer.py             | 23 +++++++++++++----------
 lib/mako/lookup.py            |  2 +-
 lib/mako/parsetree.py         |  2 +-
 lib/mako/pygen.py             | 28 +++++++++++++++++++---------
 lib/mako/pyparser.py          |  2 +-
 lib/mako/template.py          |  2 +-
 lib/mako/testing/fixtures.py  | 10 ++++++++++
 lib/mako/util.py              |  2 +-
 requirements.txt              |  2 +-
 26 files changed, 66 insertions(+), 43 deletions(-)

diff --git a/lib/mako/__init__.py b/lib/mako/__init__.py
index 5ae55011..3d7dcb6d 100644
--- a/lib/mako/__init__.py
+++ b/lib/mako/__init__.py
@@ -1,8 +1,8 @@
 # mako/__init__.py
-# Copyright 2006-2021 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2022 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
 
 
-__version__ = "1.2.0"
+__version__ = "1.2.3"
diff --git a/lib/mako/_ast_util.py b/lib/mako/_ast_util.py
index b8615335..95742835 100644
--- a/lib/mako/_ast_util.py
+++ b/lib/mako/_ast_util.py
@@ -1,5 +1,5 @@
 # mako/_ast_util.py
-# Copyright 2006-2021 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2022 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
diff --git a/lib/mako/ast.py b/lib/mako/ast.py
index f879e8b4..a3f3ee3e 100644
--- a/lib/mako/ast.py
+++ b/lib/mako/ast.py
@@ -1,5 +1,5 @@
 # mako/ast.py
-# Copyright 2006-2021 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2022 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
diff --git a/lib/mako/cache.py b/lib/mako/cache.py
index d77be271..db21bb3e 100644
--- a/lib/mako/cache.py
+++ b/lib/mako/cache.py
@@ -1,5 +1,5 @@
 # mako/cache.py
-# Copyright 2006-2021 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2022 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
diff --git a/lib/mako/cmd.py b/lib/mako/cmd.py
index 7592fb27..93a6733f 100755
--- a/lib/mako/cmd.py
+++ b/lib/mako/cmd.py
@@ -1,5 +1,5 @@
 # mako/cmd.py
-# Copyright 2006-2021 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2022 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
diff --git a/lib/mako/codegen.py b/lib/mako/codegen.py
index c897f0ff..a9dbcb67 100644
--- a/lib/mako/codegen.py
+++ b/lib/mako/codegen.py
@@ -1,5 +1,5 @@
 # mako/codegen.py
-# Copyright 2006-2021 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2022 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
diff --git a/lib/mako/compat.py b/lib/mako/compat.py
index 68bc03b1..48df30d6 100644
--- a/lib/mako/compat.py
+++ b/lib/mako/compat.py
@@ -1,5 +1,5 @@
 # mako/compat.py
-# Copyright 2006-2021 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2022 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
diff --git a/lib/mako/exceptions.py b/lib/mako/exceptions.py
index a0a5feca..31c695fd 100644
--- a/lib/mako/exceptions.py
+++ b/lib/mako/exceptions.py
@@ -1,5 +1,5 @@
 # mako/exceptions.py
-# Copyright 2006-2021 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2022 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
diff --git a/lib/mako/ext/autohandler.py b/lib/mako/ext/autohandler.py
index e8fdac89..5bcfc285 100644
--- a/lib/mako/ext/autohandler.py
+++ b/lib/mako/ext/autohandler.py
@@ -1,5 +1,5 @@
 # ext/autohandler.py
-# Copyright 2006-2021 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2022 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
diff --git a/lib/mako/ext/babelplugin.py b/lib/mako/ext/babelplugin.py
index f015ec25..907d0b80 100644
--- a/lib/mako/ext/babelplugin.py
+++ b/lib/mako/ext/babelplugin.py
@@ -1,5 +1,5 @@
 # ext/babelplugin.py
-# Copyright 2006-2021 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2022 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
diff --git a/lib/mako/ext/beaker_cache.py b/lib/mako/ext/beaker_cache.py
index a40b09cf..9aa35b06 100644
--- a/lib/mako/ext/beaker_cache.py
+++ b/lib/mako/ext/beaker_cache.py
@@ -1,5 +1,5 @@
 # ext/beaker_cache.py
-# Copyright 2006-2021 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2022 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
diff --git a/lib/mako/ext/extract.py b/lib/mako/ext/extract.py
index 74d067d8..9d33ee18 100644
--- a/lib/mako/ext/extract.py
+++ b/lib/mako/ext/extract.py
@@ -1,5 +1,5 @@
 # ext/extract.py
-# Copyright 2006-2021 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2022 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
diff --git a/lib/mako/ext/linguaplugin.py b/lib/mako/ext/linguaplugin.py
index 4cce6262..efb04c70 100644
--- a/lib/mako/ext/linguaplugin.py
+++ b/lib/mako/ext/linguaplugin.py
@@ -1,5 +1,5 @@
 # ext/linguaplugin.py
-# Copyright 2006-2021 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2022 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
diff --git a/lib/mako/ext/preprocessors.py b/lib/mako/ext/preprocessors.py
index 6855eeb4..80403ecd 100644
--- a/lib/mako/ext/preprocessors.py
+++ b/lib/mako/ext/preprocessors.py
@@ -1,5 +1,5 @@
 # ext/preprocessors.py
-# Copyright 2006-2021 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2022 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
diff --git a/lib/mako/ext/pygmentplugin.py b/lib/mako/ext/pygmentplugin.py
index 38d6a71b..9acbf4cd 100644
--- a/lib/mako/ext/pygmentplugin.py
+++ b/lib/mako/ext/pygmentplugin.py
@@ -1,5 +1,5 @@
 # ext/pygmentplugin.py
-# Copyright 2006-2021 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2022 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
diff --git a/lib/mako/ext/turbogears.py b/lib/mako/ext/turbogears.py
index 413d9f74..2ebf0746 100644
--- a/lib/mako/ext/turbogears.py
+++ b/lib/mako/ext/turbogears.py
@@ -1,5 +1,5 @@
 # ext/turbogears.py
-# Copyright 2006-2021 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2022 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
diff --git a/lib/mako/filters.py b/lib/mako/filters.py
index 26edd8ee..af202f3f 100644
--- a/lib/mako/filters.py
+++ b/lib/mako/filters.py
@@ -1,5 +1,5 @@
 # mako/filters.py
-# Copyright 2006-2021 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2022 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
diff --git a/lib/mako/lexer.py b/lib/mako/lexer.py
index 527c4b51..75182f85 100644
--- a/lib/mako/lexer.py
+++ b/lib/mako/lexer.py
@@ -1,5 +1,5 @@
 # mako/lexer.py
-# Copyright 2006-2021 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2022 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
@@ -74,12 +74,11 @@ class Lexer:
             (start, end) = match.span()
             self.match_position = end + 1 if end == start else end
             self.matched_lineno = self.lineno
-            lines = re.findall(r"\n", self.text[mp : self.match_position])
             cp = mp - 1
-            while cp >= 0 and cp < self.textlength and self.text[cp] != "\n":
-                cp -= 1
+            if cp >= 0 and cp < self.textlength:
+                cp = self.text[: cp + 1].rfind("\n")
             self.matched_charpos = mp - cp
-            self.lineno += len(lines)
+            self.lineno += self.text[mp : self.match_position].count("\n")
         return match
 
     def parse_until_text(self, watch_nesting, *text):
@@ -273,20 +272,24 @@ class Lexer:
         return self.template
 
     def match_tag_start(self):
-        match = self.match(
-            r"""
+        reg = r"""
             \<%     # opening tag
 
             ([\w\.\:]+)   # keyword
 
-            ((?:\s+\w+|\s*=\s*|".*?"|'.*?')*)  # attrname, = \
+            ((?:\s+\w+|\s*=\s*|"[^"]*?"|'[^']*?'|\s*,\s*)*)  # attrname, = \
                                                #        sign, string expression
+                                               # comma is for backwards compat
+                                               # identified in #366
 
             \s*     # more whitespace
 
             (/)?>   # closing
 
-            """,
+        """
+
+        match = self.match(
+            reg,
             re.I | re.S | re.X,
         )
 
@@ -319,7 +322,7 @@ class Lexer:
         return True
 
     def match_tag_end(self):
-        match = self.match(r"\</%[\t ]*(.+?)[\t ]*>")
+        match = self.match(r"\</%[\t ]*([^\t ]+?)[\t ]*>")
         if match:
             if not len(self.tag):
                 raise exceptions.SyntaxException(
diff --git a/lib/mako/lookup.py b/lib/mako/lookup.py
index 7afe242b..f7410ce3 100644
--- a/lib/mako/lookup.py
+++ b/lib/mako/lookup.py
@@ -1,5 +1,5 @@
 # mako/lookup.py
-# Copyright 2006-2021 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2022 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
diff --git a/lib/mako/parsetree.py b/lib/mako/parsetree.py
index 2135769f..c5a12d1d 100644
--- a/lib/mako/parsetree.py
+++ b/lib/mako/parsetree.py
@@ -1,5 +1,5 @@
 # mako/parsetree.py
-# Copyright 2006-2021 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2022 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
diff --git a/lib/mako/pygen.py b/lib/mako/pygen.py
index 46b0b52f..57c69793 100644
--- a/lib/mako/pygen.py
+++ b/lib/mako/pygen.py
@@ -1,5 +1,5 @@
 # mako/pygen.py
-# Copyright 2006-2021 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2022 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
@@ -43,6 +43,15 @@ class PythonPrinter:
         # source lines
         self.source_map = {}
 
+        self._re_space_comment = re.compile(r"^\s*#")
+        self._re_space = re.compile(r"^\s*$")
+        self._re_indent = re.compile(r":[ \t]*(?:#.*)?$")
+        self._re_compound = re.compile(r"^\s*(if|try|elif|while|for|with)")
+        self._re_indent_keyword = re.compile(
+            r"^\s*(def|class|else|elif|except|finally)"
+        )
+        self._re_unindentor = re.compile(r"^\s*(else|elif|except|finally).*\:")
+
     def _update_lineno(self, num):
         self.lineno += num
 
@@ -86,8 +95,8 @@ class PythonPrinter:
 
         if (
             line is None
-            or re.match(r"^\s*#", line)
-            or re.match(r"^\s*$", line)
+            or self._re_space_comment.match(line)
+            or self._re_space.match(line)
         ):
             hastext = False
         else:
@@ -121,12 +130,12 @@ class PythonPrinter:
         # note that a line can both decrase (before printing) and
         # then increase (after printing) the indentation level.
 
-        if re.search(r":[ \t]*(?:#.*)?$", line):
+        if self._re_indent.search(line):
             # increment indentation count, and also
             # keep track of what the keyword was that indented us,
             # if it is a python compound statement keyword
             # where we might have to look for an "unindent" keyword
-            match = re.match(r"^\s*(if|try|elif|while|for|with)", line)
+            match = self._re_compound.match(line)
             if match:
                 # its a "compound" keyword, so we will check for "unindentors"
                 indentor = match.group(1)
@@ -137,9 +146,7 @@ class PythonPrinter:
                 # its not a "compound" keyword.  but lets also
                 # test for valid Python keywords that might be indenting us,
                 # else assume its a non-indenting line
-                m2 = re.match(
-                    r"^\s*(def|class|else|elif|except|finally)", line
-                )
+                m2 = self._re_indent_keyword.match(line)
                 if m2:
                     self.indent += 1
                     self.indent_detail.append(indentor)
@@ -167,7 +174,7 @@ class PythonPrinter:
 
         # if the current line doesnt have one of the "unindentor" keywords,
         # return False
-        match = re.match(r"^\s*(else|elif|except|finally).*\:", line)
+        match = self._re_unindentor.match(line)
         # if True, whitespace matches up, we have a compound indentor,
         # and this line has an unindentor, this
         # is probably good enough
@@ -193,6 +200,9 @@ class PythonPrinter:
 
         stripspace is a string of space that will be truncated from the
         start of the line before indenting."""
+        if stripspace == "":
+            # Fast path optimization.
+            return self.indentstring * self.indent + line
 
         return re.sub(
             r"^%s" % stripspace, self.indentstring * self.indent, line
diff --git a/lib/mako/pyparser.py b/lib/mako/pyparser.py
index 5c55505b..d9b090c6 100644
--- a/lib/mako/pyparser.py
+++ b/lib/mako/pyparser.py
@@ -1,5 +1,5 @@
 # mako/pyparser.py
-# Copyright 2006-2021 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2022 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
diff --git a/lib/mako/template.py b/lib/mako/template.py
index bbbe73cb..8c70731d 100644
--- a/lib/mako/template.py
+++ b/lib/mako/template.py
@@ -1,5 +1,5 @@
 # mako/template.py
-# Copyright 2006-2021 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2022 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
diff --git a/lib/mako/testing/fixtures.py b/lib/mako/testing/fixtures.py
index c9379c0c..01e99617 100644
--- a/lib/mako/testing/fixtures.py
+++ b/lib/mako/testing/fixtures.py
@@ -80,6 +80,16 @@ class TemplateTest:
             output = filters(output)
         eq_(output, expected)
 
+    def indicates_unbound_local_error(self, rendered_output, unbound_var):
+        var = f"&#39;{unbound_var}&#39;"
+        error_msgs = (
+            # < 3.11
+            f"local variable {var} referenced before assignment",
+            # >= 3.11
+            f"cannot access local variable {var} where it is not associated",
+        )
+        return any((msg in rendered_output) for msg in error_msgs)
+
 
 class PlainCacheImpl(CacheImpl):
     """Simple memory cache impl so that tests which
diff --git a/lib/mako/util.py b/lib/mako/util.py
index 74c8b9eb..5fb683b4 100644
--- a/lib/mako/util.py
+++ b/lib/mako/util.py
@@ -1,5 +1,5 @@
 # mako/util.py
-# Copyright 2006-2021 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2022 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
diff --git a/requirements.txt b/requirements.txt
index fd8a848c..2f22fe04 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -22,7 +22,7 @@ importlib-metadata==5.0.0
 importlib-resources==5.10.0
 git+https://github.com/Tautulli/ipwhois.git@master#egg=ipwhois
 IPy==1.01
-Mako==1.2.0
+Mako==1.2.3
 MarkupSafe==2.1.1
 musicbrainzngs==0.7.1
 packaging==21.3

From c2f47a52b4965d8fd350aa140e8f9ed37c530edc Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 12 Nov 2022 17:23:34 -0800
Subject: [PATCH 218/743] Bump httpagentparser from 1.9.2 to 1.9.5 (#1869)

* Bump httpagentparser from 1.9.2 to 1.9.5

Bumps [httpagentparser](https://github.com/shon/httpagentparser) from 1.9.2 to 1.9.5.
- [Release notes](https://github.com/shon/httpagentparser/releases)
- [Commits](https://github.com/shon/httpagentparser/commits)

---
updated-dependencies:
- dependency-name: httpagentparser
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

* Update httpagentparser==1.9.5

Signed-off-by: dependabot[bot] <support@github.com>
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/httpagentparser/__init__.py | 10 +++++-----
 requirements.txt                |  2 +-
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/lib/httpagentparser/__init__.py b/lib/httpagentparser/__init__.py
index 0e30e617..7338e197 100644
--- a/lib/httpagentparser/__init__.py
+++ b/lib/httpagentparser/__init__.py
@@ -8,7 +8,7 @@ Tries to
     * assist python web apps to detect clients.
 """
 
-__version__ = '1.9.2'
+__version__ = '1.9.5'
 
 
 class DetectorsHub(dict):
@@ -218,7 +218,7 @@ class WOSBrowser(Browser):
 
 class Safari(Browser):
     look_for = "Safari"
-    skip_if_found = ["Edge", "YaBrowser"]
+    skip_if_found = ["Edge", "YaBrowser", "FxiOS"]
 
     def checkWords(self, agent):
         unless_list = ["Chrome", "OmniWeb", "wOSBrowser", "Android", "CriOS"]
@@ -408,7 +408,7 @@ class AndroidBrowser(Browser):
 
 
 class Firefox(Browser):
-    look_for = "Firefox"
+    look_for = ["Firefox", "FxiOS"]
     version_markers = [('/', '')]
     skip_if_found = ["SeaMonkey", "web/snippet"]
 
@@ -557,7 +557,7 @@ class Chrome(Browser):
         part = agent.split(word + self.version_markers[0])[-1]
         version = part.split(self.version_markers[1])[0]
         if '+' in version:
-            version = part.split('+')[0]
+            version = version.split('+')[0]
         return version.strip()
 
 class YaBrowser(Browser):
@@ -569,7 +569,7 @@ class YaBrowser(Browser):
         part = agent.split(word + self.version_markers[0])[-1]
         version = part.split(self.version_markers[1])[0]
         if '+' in version:
-            version = part.split('+')[0]
+            version = version.split('+')[0]
         return version.strip()
 
 class ChromeiOS(Browser):
diff --git a/requirements.txt b/requirements.txt
index 2f22fe04..4ea307df 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -16,7 +16,7 @@ facebook-sdk==3.1.0
 future==0.18.2
 gntp==1.0.3
 html5lib==1.1
-httpagentparser==1.9.2
+httpagentparser==1.9.5
 idna==3.4
 importlib-metadata==5.0.0
 importlib-resources==5.10.0

From 8a4cb13b18540ab8e10e6e83db53298d7c0f5410 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 12 Nov 2022 17:25:54 -0800
Subject: [PATCH 219/743] Bump tzdata from 2022.1 to 2022.6 (#1878)

* Bump tzdata from 2022.1 to 2022.6

Bumps [tzdata](https://github.com/python/tzdata) from 2022.1 to 2022.6.
- [Release notes](https://github.com/python/tzdata/releases)
- [Changelog](https://github.com/python/tzdata/blob/master/NEWS.md)
- [Commits](https://github.com/python/tzdata/compare/2022.1...2022.6)

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

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

* Update tzdata==2022.6

Signed-off-by: dependabot[bot] <support@github.com>
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/tzdata/__init__.py                     |   4 +-
 lib/tzdata/zoneinfo/America/Bahia_Banderas | Bin 530 -> 728 bytes
 lib/tzdata/zoneinfo/America/Chihuahua      | Bin 340 -> 691 bytes
 lib/tzdata/zoneinfo/America/Ensenada       | Bin 1025 -> 1025 bytes
 lib/tzdata/zoneinfo/America/Hermosillo     | Bin 286 -> 286 bytes
 lib/tzdata/zoneinfo/America/Matamoros      | Bin 437 -> 437 bytes
 lib/tzdata/zoneinfo/America/Mazatlan       | Bin 367 -> 718 bytes
 lib/tzdata/zoneinfo/America/Merida         | Bin 303 -> 654 bytes
 lib/tzdata/zoneinfo/America/Mexico_City    | Bin 412 -> 773 bytes
 lib/tzdata/zoneinfo/America/Monterrey      | Bin 293 -> 644 bytes
 lib/tzdata/zoneinfo/America/Nipigon        | Bin 835 -> 1717 bytes
 lib/tzdata/zoneinfo/America/Ojinaga        | Bin 484 -> 691 bytes
 lib/tzdata/zoneinfo/America/Punta_Arenas   | Bin 1209 -> 1218 bytes
 lib/tzdata/zoneinfo/America/Rainy_River    | Bin 835 -> 1294 bytes
 lib/tzdata/zoneinfo/America/Santa_Isabel   | Bin 1025 -> 1025 bytes
 lib/tzdata/zoneinfo/America/Santiago       | Bin 1282 -> 1354 bytes
 lib/tzdata/zoneinfo/America/Thunder_Bay    | Bin 881 -> 1717 bytes
 lib/tzdata/zoneinfo/America/Tijuana        | Bin 1025 -> 1025 bytes
 lib/tzdata/zoneinfo/Antarctica/Vostok      | Bin 133 -> 133 bytes
 lib/tzdata/zoneinfo/Arctic/Longyearbyen    | Bin 676 -> 705 bytes
 lib/tzdata/zoneinfo/Asia/Amman             | Bin 922 -> 928 bytes
 lib/tzdata/zoneinfo/Asia/Brunei            | Bin 154 -> 320 bytes
 lib/tzdata/zoneinfo/Asia/Damascus          | Bin 1047 -> 1234 bytes
 lib/tzdata/zoneinfo/Asia/Gaza              | Bin 1240 -> 1258 bytes
 lib/tzdata/zoneinfo/Asia/Hebron            | Bin 1258 -> 1276 bytes
 lib/tzdata/zoneinfo/Asia/Ho_Chi_Minh       | Bin 236 -> 236 bytes
 lib/tzdata/zoneinfo/Asia/Kuala_Lumpur      | Bin 256 -> 256 bytes
 lib/tzdata/zoneinfo/Asia/Saigon            | Bin 236 -> 236 bytes
 lib/tzdata/zoneinfo/Asia/Tehran            | Bin 2004 -> 812 bytes
 lib/tzdata/zoneinfo/Atlantic/Jan_Mayen     | Bin 676 -> 705 bytes
 lib/tzdata/zoneinfo/Atlantic/Reykjavik     | Bin 753 -> 130 bytes
 lib/tzdata/zoneinfo/Chile/Continental      | Bin 1282 -> 1354 bytes
 lib/tzdata/zoneinfo/Chile/EasterIsland     | Bin 1102 -> 1174 bytes
 lib/tzdata/zoneinfo/Eire                   | Bin 1496 -> 1496 bytes
 lib/tzdata/zoneinfo/Europe/Amsterdam       | Bin 1071 -> 1103 bytes
 lib/tzdata/zoneinfo/Europe/Copenhagen      | Bin 623 -> 705 bytes
 lib/tzdata/zoneinfo/Europe/Dublin          | Bin 1496 -> 1496 bytes
 lib/tzdata/zoneinfo/Europe/Kyiv            | Bin 0 -> 558 bytes
 lib/tzdata/zoneinfo/Europe/Luxembourg      | Bin 1087 -> 1103 bytes
 lib/tzdata/zoneinfo/Europe/Monaco          | Bin 1114 -> 1105 bytes
 lib/tzdata/zoneinfo/Europe/Oslo            | Bin 676 -> 705 bytes
 lib/tzdata/zoneinfo/Europe/Simferopol      | Bin 865 -> 865 bytes
 lib/tzdata/zoneinfo/Europe/Stockholm       | Bin 497 -> 705 bytes
 lib/tzdata/zoneinfo/Europe/Uzhgorod        | Bin 539 -> 558 bytes
 lib/tzdata/zoneinfo/Europe/Zaporozhye      | Bin 569 -> 558 bytes
 lib/tzdata/zoneinfo/Iceland                | Bin 753 -> 130 bytes
 lib/tzdata/zoneinfo/Indian/Christmas       | Bin 133 -> 152 bytes
 lib/tzdata/zoneinfo/Indian/Cocos           | Bin 140 -> 187 bytes
 lib/tzdata/zoneinfo/Indian/Kerguelen       | Bin 133 -> 152 bytes
 lib/tzdata/zoneinfo/Indian/Mahe            | Bin 133 -> 133 bytes
 lib/tzdata/zoneinfo/Indian/Reunion         | Bin 133 -> 133 bytes
 lib/tzdata/zoneinfo/Iran                   | Bin 2004 -> 812 bytes
 lib/tzdata/zoneinfo/Mexico/BajaNorte       | Bin 1025 -> 1025 bytes
 lib/tzdata/zoneinfo/Mexico/BajaSur         | Bin 367 -> 718 bytes
 lib/tzdata/zoneinfo/Mexico/General         | Bin 412 -> 773 bytes
 lib/tzdata/zoneinfo/Pacific/Chuuk          | Bin 195 -> 154 bytes
 lib/tzdata/zoneinfo/Pacific/Easter         | Bin 1102 -> 1174 bytes
 lib/tzdata/zoneinfo/Pacific/Fiji           | Bin 428 -> 396 bytes
 lib/tzdata/zoneinfo/Pacific/Funafuti       | Bin 134 -> 134 bytes
 lib/tzdata/zoneinfo/Pacific/Majuro         | Bin 218 -> 134 bytes
 lib/tzdata/zoneinfo/Pacific/Pohnpei        | Bin 214 -> 134 bytes
 lib/tzdata/zoneinfo/Pacific/Ponape         | Bin 214 -> 134 bytes
 lib/tzdata/zoneinfo/Pacific/Truk           | Bin 195 -> 154 bytes
 lib/tzdata/zoneinfo/Pacific/Wake           | Bin 134 -> 134 bytes
 lib/tzdata/zoneinfo/Pacific/Wallis         | Bin 134 -> 134 bytes
 lib/tzdata/zoneinfo/Pacific/Yap            | Bin 195 -> 154 bytes
 lib/tzdata/zoneinfo/leapseconds            |   8 +-
 lib/tzdata/zoneinfo/tzdata.zi              | 773 +++++++--------------
 lib/tzdata/zoneinfo/zone.tab               |   9 +-
 lib/tzdata/zoneinfo/zone1970.tab           |  80 ++-
 lib/tzdata/zones                           | 345 ++++-----
 requirements.txt                           |   2 +-
 72 files changed, 487 insertions(+), 734 deletions(-)
 create mode 100644 lib/tzdata/zoneinfo/Europe/Kyiv

diff --git a/lib/tzdata/__init__.py b/lib/tzdata/__init__.py
index 7e6440bb..c3851325 100644
--- a/lib/tzdata/__init__.py
+++ b/lib/tzdata/__init__.py
@@ -1,6 +1,6 @@
 # IANA versions like 2020a are not valid PEP 440 identifiers; the recommended
 # way to translate the version is to use YYYY.n where `n` is a 0-based index.
-__version__ = "2022.1"
+__version__ = "2022.6"
 
 # This exposes the original IANA version number.
-IANA_VERSION = "2022a"
+IANA_VERSION = "2022f"
diff --git a/lib/tzdata/zoneinfo/America/Bahia_Banderas b/lib/tzdata/zoneinfo/America/Bahia_Banderas
index cbe22a7622d82eca2b7d6333842a91fc0c3e2772..48faea2ecefa7dca89c7b2f5e0bfec6b47becf69 100644
GIT binary patch
delta 336
zcmbQla)Wh37^D5ha0kYE1|aaAp$VcG{MLN^0HXaXxIq*{K+knBKQK|f0mKi=*$L(c
zJ92{gAwILg{7{A0V1AfREtnt9a2Cvu5S>*3)W#6;U_F>0`Lzbjk2)|B%#XerR}U75
zS-B3Rjv;od1DGGzIRVU%pQ;4rCuA0Z`H6LQA3%&G&k!&_IZojNBNHPt5VHVD+>n(C
z2Xtoo|9>vfFd#XBf#v`I)e9InKqMp2|Ns3B3<CfE@7%yB;^P~_;2Rvm;0(mRE+Gs7
NAU2TZ0t%RM0RUwJN`n9Z

delta 136
zcmcb?I*DaM7^C{ea0kX}MkX+1W@NzwS(*O-pBuu!03;_cu>AkOdI1B+|Ns3B3_Kt<
zqrm_FJ2x<j`1pn}_y&hCI0JD25c|3S*+9$%6fgrabbL+p4D}3jd<_lsO!W-70D1=^
Al>h($

diff --git a/lib/tzdata/zoneinfo/America/Chihuahua b/lib/tzdata/zoneinfo/America/Chihuahua
index e1780a5750e39be0849b70a08c4ace57037c1377..5e0a54f00468f11913f12aaab341b1fabd9aded6 100644
GIT binary patch
literal 691
zcmb8p%PT}t90%}o$B3pWlSr}=N=acb-j6ZE80LCjj5kB1gd*8s7E+`PrIhDJc_gzj
z2xVzQQOaXuAtVbaA?Y~3uRlP}>36=r&*^t=SE=b})3ZO9Bqpe6DStmn7h~R{0=QT!
zp2r@_t=FzwN>5v56XlNS9J#AC{O0%Q3w=MXy`O^VdwqK-<1KaymQeNtCr0M$$Oiqj
zlQPLC3Qi7rC$i)REu8Xo1*g9GyQoR?oWbdC4V<yR0B24<!&!5~aCY}8Y#f<$(nU_O
z8#c8L!seK1IM>_==lS))mIxzk`Iyp)XUwV&hpm^raKW87T)0~S+fKr0jLEY}aM7k3
zE*=PmOD68&(&j`LHD#U0aJexER&48VMd&A789f14u^ZSPxay<}`|TlI{WcEQ94*1M
z7oBk3+JTPd>bHyFhOtGsaV8dS>Ttr%Lo$sqht&bMG{i7TC3#6Iwb)*w`PWu)J}-Wl
l^92`EbH1_6eCd?5obS0MolRDlT&^&aDA_Dhlt#dy`2n!Kl1u;q

delta 105
zcmdnYdWC617^CpS@CC7qOd!Y%ge;6u`2YW$9tMX0|L0C%VEO-l^#TTt|NnPxVB`U@
r83lZNLl}I6Ll~Sv*agT2VlJS7Igp{_YoceUXQ1P2XrO1RXTSvjk4qlG

diff --git a/lib/tzdata/zoneinfo/America/Ensenada b/lib/tzdata/zoneinfo/America/Ensenada
index 19ccd3576d46b262f8b9f00b302f67bb4d26c4d4..e8be26b139e653e1b07a3db14ea34bd290441947 100644
GIT binary patch
delta 13
UcmZqVXyllX%JiaOWBM#+03quI7XSbN

delta 13
UcmZqVXyllX%Ji*aWBM#+03weCH2?qr

diff --git a/lib/tzdata/zoneinfo/America/Hermosillo b/lib/tzdata/zoneinfo/America/Hermosillo
index 8283239ecab21c798596cbce5a1cc109ca38bfd8..5c92e2967e7cc5a0e3567ed0321f15b8b3a6b6f8 100644
GIT binary patch
delta 75
zcmbQoG>>V*Ef;1+CPo%UW-$E!fBFvwhX4QPPGDg9|9|xY1`ZI($n*bye*=Snk8cQr
WZ*T~MGZ6c_gfIjEX)d6EITrx%ju~wL

delta 75
zcmbQoG>>V*Ef*$6CPrpP7BKw(fBFvwhX4QPPGDg9|9|xY29E##`x_W|Kx{?<AKwrL
W-{24iXCMv$VqcdK1}>n0ITrx$m>F&W

diff --git a/lib/tzdata/zoneinfo/America/Matamoros b/lib/tzdata/zoneinfo/America/Matamoros
index 722751b20e520f67e9b1b2dedcef6f061334b496..88cabcd1528c678db4e1ab1218e9dd6c032ed901 100644
GIT binary patch
delta 14
VcmdnWyp?%FBO}w28IzkCjQ}YS1u6gl

delta 14
VcmdnWyp?%FBO}uyhsn*1MgS*F1keBg

diff --git a/lib/tzdata/zoneinfo/America/Mazatlan b/lib/tzdata/zoneinfo/America/Mazatlan
index 4c819fab0247e15f1ff9b6c76108c7290e536699..97d4d36c137fce3b89da84ba2b27dc17a86a15cb 100644
GIT binary patch
literal 718
zcmWHE%1kq2AP5+NDnJ+nLI`WI2P$I)Vv+wquyost0ua6aQ{Dp*y)7*)0Yq<iz67Rs
z@R&j9zil5t;-_B~g84TlZutPRkAb0}0Yn<6w+Mh}qhhfJ5N+(92IiXt{Q&b#)jhy`
zGoxEzzB#)Vm~SEd9i*JW;yDkPZ~6Nsm~Zt}Xaa~~z3n2HZ?l05%(vY=7tFWoe*@;*
z&#nja9rDkC`Hn5K8$be1{u{u2=agD7-$j2CnD6Qm59Yh^mw@^1Dvn^j`;UnNKy3`3
zEXrWM=Z#`8-|Go0nD4zK6wLQIs{~TU;5)+{%=cT%0_OWyNP_tRJ<q`Wz(mstAVyHm
z2{1p{Q5?(<@mU4thbsI8^TTv{!2EEA+hBf#=!yoAK*WQ+V1DG+E-*jpz<e-2`f3iC
zAG30g07zZzRzEO5u5%ukA3xOq%umQ{0P_>;d_l?>l01{Z{Ny-&21X`EW*}w(lH|bu
z|L52+F#P{NcLD>;|NpBOFmQlKMxOuw`x_Vpe0)O~e1k(6oPpTaC4?aWNOJ)N%((yu
C7@)rZ

delta 108
zcmX@d`krY*7^B$4@Er+^Okl{&$bt<2|DR*S!0`Y7+zAXU|NpOEz`*hUe}4l54~Weu
r;Nu&@;2Rvm;0(k8K<w)h!oUR-Fb6Vpd`<KW^$c`;4Gr{6^$fTGn#3N9

diff --git a/lib/tzdata/zoneinfo/America/Merida b/lib/tzdata/zoneinfo/America/Merida
index d3b0ca12c95f35897fb64cd7098b6320a3c5db34..e5de1131dc48e5d652c7bd6a77be22a2e9b500cc 100644
GIT binary patch
literal 654
zcmbWu-z$S*6bJD0vcf1zq_|j8Qc8xgVKy6YV`G~aGtB14v{GA?T%eVul%E$$+(@|)
znH!7T$fdXxxsXy4H@jJs<@G$@e?U1;=Q-zdI!AH`{A&6$1h&DGhxGS}maQpR=EyAe
zV~<|eQ~u%|YJs)g&Rsb^%?qig(nGvfi7sBK+W8LGl<HuO`Ub8|D}w6^-{QQfd;Nj6
z-`B7%p$PLqee4Quh$i92i&a>^_5?TWgkVGP5;jIwLhOv1JNIDIXb?76MBo;)18&Xs
z!(vGlEPgEz4~rrXwmgi%Z7-j2`<Vz^Z*$|kv2B&X9Y+bcb0!nEFW<usUul>RoD=78
zmoWpDtUGYG>I3d6pM!hp7Ix)rhu9gpo}+MIVitB^ZovI_9(ds3n6J^`sR8yZt;0i`
z#jrOp3H#>tao!ADBzVN5iVG=1>c5^WA0~;|ze@^PK0l#!{tH=Fn?$BAiCS2i%n~UX
GG|FFBrF|3t

delta 52
xcmeBUUC%Tjj8R}>c!vNZ6C*P+oSeX<E9~qNqT_3#XQ*eO<7;T3XR2qw1pxVT2>Jj3

diff --git a/lib/tzdata/zoneinfo/America/Mexico_City b/lib/tzdata/zoneinfo/America/Mexico_City
index ffcf8bee10e5aa57dff8bb5764de94d73eab348d..80a415c70ca3d94aa25bbc1e90f3ed169943a704 100644
GIT binary patch
literal 773
zcmWHE%1kq2AP5+NDnJ+nLI`Vd0V-nyVu}Aiuyost0ua6aQ{Dp*y)7*)0Yq<iz67Rs
z@R&j9zil5t;z#do0P~McHwggoPlkSc0H$Bv1@q4{9Ru^vZw~|WZ_N}1^KX|mUjVt!
zFue>!F&Gtd6o6=B_XrThU=s8S%r{lH0`tv`&Vc#m>@r}!h4hOLAcn=We_+1l?^9sD
z)mN4Vkbw2JLtwtm`afX4?e0D>->&~2m~TJ30L*vDKLF-Cw)7SNwJ|vPF9P$OQ}V%l
z7yTA6-_<1$%y;8Y1M}TgjKO^OAI%IP;K?Ei=6l{q1@pZge+ToucesQ3K4*nLfEd0r
zG{JnoHDAGe{|as}KcMG2m>-y^-T)E^%Gn9#2Rm|t`5`{D!TeB#*I<5_PA!-p&TtmY
zj}V<z0My11@nAieANjQg%#S)S5zLRi8VBabtXv0D#t^&J0nCr<oB-y>PgMf*6Ecgy
z{KPuD4<JU8X9$>|9H;Psk%^I+k%<KeS-~WTMJoLNe=!dO!~g$tCor)5|G#<x0|$s?
m<oW-9=LSXrFe&2W8^Yil9KzrX#J(;-8id0`7`T7}W?TSv0M(fQ

delta 121
zcmZo=o5MUIj8mF{fq@l>MJC4INM&RKL1rLi0h1sW6#oCen1_Mk|NprY7+C)QU%h~V
z<NyDi8yI=Oq=1ia2!n5M2!k^Sy8v-`2m=?8V+Q2t_?qY$>KW+x8XD-C>KSkW0I_Z!
AdjJ3c

diff --git a/lib/tzdata/zoneinfo/America/Monterrey b/lib/tzdata/zoneinfo/America/Monterrey
index dea9e3f5864fd19796de89bb456eaa54ee90cc38..a5822e2c626ae1927cb2dfc201c9561430cdd581 100644
GIT binary patch
literal 644
zcmWHE%1kq2AP5+NDnJ+nLI`WI1S(?&VxIp%uyot41R$G1DfA<VVo=W7`vF87rk8;z
z2BTt*0uXKN9s!~lOoCp4`KIbtV7{5r88F|RT?WjzkbVKyZ}IFOm~Z*}6qs-Im8AhB
zV7=`Sm~XTG514PeyARB_>%Rx)+s`fl^BwXJfccIsy#+vR3{L)wz<lSFd@$cdzXi;9
zbqNIX-T2eMe0LRNFyH-0GXn^CvWSBDo;Om#e6Ppf!F=x>?qI&pS>X>LhVKkbFyC*@
zS1{kdf*Z^a=(!H&2PUdFfCPeac7plAj+|hAh|g>=KUCp0m>;H73+9J2oCWhEL}wKM
zwJ}6ISP$k$eysuXqYg|2^P{iEf%!2j*MXEV#BOx}^W!=vfcf!LmB9Rj%px#9vCi%T
zh>_$O0_G>jDSTjLA`|}qzwiqK!~g%Q7cj8=|G#qsBZrS~2!nGl5W9phZ~+-+TmbPr
Bc~t-a

delta 52
vcmZo+UCJ~ej8R}>c!vNZ6DpjXz@#kf>=L5mYoceUXQ1P2XrO1RXTSvj^UMg<

diff --git a/lib/tzdata/zoneinfo/America/Nipigon b/lib/tzdata/zoneinfo/America/Nipigon
index b9f67a9f9495e155418baa8bacbebe278aca70f9..fe6be8ea8c97db1c1d99c4198f4b9b024e3aba4c 100644
GIT binary patch
delta 874
zcmW;LT}V@L7zXguX|9NJnA+8Xx+qt)CP+6LI0z;M%epY^OV5QA5wt^;E-(-DB|>4b
z)u2Kvt?9JZ)ajO{=2z=#;`~bdIM!OGYaJ~=GPkw&IdFLRJ@5bja&Aty+_~lc389{0
zn7G)R6pcNXL&hLwh0DZKR=%6#D4&(?_fS56?9fuaFv}&%s+?N5`p#MSrOJr&ug+z{
z*3CynI#;9H3D*QuVVm+3PrYqO(BnegS{;gdrv`pKeh+^0Fafr=8Q`}iYAkR(Jq|aV
zKZ1E<aT?r|wGVclNrszK;^CHzW!NQ`VE3*>i9WzB1O`yF$`(<ydP5=&+WaH%dwW0J
z-s6Tl${XO$>L>6AgBk9+bsg@`E`)mu^5I@hF5IUt=4tOoMLO(J=fMwdCJEI0uKIC)
zP&<M7P>!vi`r#c_os=U7?!u$YZTNHYC3q~YP)qZ%h?S=tPrSk*C(Gc8+8gj>`$c%F
ztN<1(^zifroq*y?i3Y{j!z$RHmjHj;vk4AlsU=$ced}(KawbIq|Jb$w&&ucF*`+~v
zF5rWM!_Dx|J|`UN@NsnimwkYzlqv-$iuv*;6bpg{{%v>!|H;1wFJ>FzrOeatvgQ=L
zqAC(;(O<<ucy;4Rcy%RLqW<4Z2D~<!4u?J4;fPBKM-N$}V(bTC7)wN=SXVkNQnE!N
yyq=G6WEmIcDdUcb9Hm@41#d|0;v5zwYwBh9ni^T1$s0>A8!wASon}**)%^#bm43kh

delta 73
zcmdnWdzfuPn5Gv40|P4%i~I+IqIZoBAbQ@8$ps*K{;t;vAo|1)&w$D286`F^XO>}N
UVrH5Ak=2Fe|NpfPlk?f!0BW}-ZU6uP

diff --git a/lib/tzdata/zoneinfo/America/Ojinaga b/lib/tzdata/zoneinfo/America/Ojinaga
index da0909cb212fa80d41fa62315b4dbcce6b0c4e42..560b8674f7e16a7e117f4e0c5f9a6a13adc1867a 100644
GIT binary patch
delta 331
zcmaFDyqR@E7^BU`a0SMC1|aac7SjNteQVk$fM~yMb`2ofKPD5*516I^<_Fq%gZV*a
zOkjSnj4qfT68Z$p5Bb9n=7*Uc1M|b4>Ig6ZL4@365XBI2ln>00{C5=0k6QAf9xM=j
zZ#h^XrsWctAG@y;%#Tai0_Mlh%Lelkd@oD@F%sL`8$fiD?j|rlIZmH}k%^I+k%<Ke
znSl&qp&eKu)BpeTWEdF!|DQX7f#v`I)e9InKqMp2|NlETFbeqihA{XBhcGw;v9Ak|
L24XHC$BYXAT+~GK

delta 122
zcmdnY`h<Bx7^CvWa0SL(MkWws20|7_9Pt1Dc`^(P|NqaOz`*kV|LO${9RL6C+`z~K
sVlxW(_=Yg}28S>>gRl#b4a8hP0dpWj$JbcTNY6mW*U(VUP|tu10JrWQN&o-=

diff --git a/lib/tzdata/zoneinfo/America/Punta_Arenas b/lib/tzdata/zoneinfo/America/Punta_Arenas
index c04210406f7bd23172481db68ae2f7f9dcd8e9d2..aa839ea7d42eb9822002e66322c4ae195f1644b5 100644
GIT binary patch
delta 26
icmdnVd5CjD7-Q+g@Hs43#2-6se6PgJ$TC@wWd#6=&<UCV

delta 29
lcmX@axs!837-PxA@HrcQ%P})DO;%)ynyk;lHo2O`9RQyS33LDe

diff --git a/lib/tzdata/zoneinfo/America/Rainy_River b/lib/tzdata/zoneinfo/America/Rainy_River
index d6ddda4822d317e63da3668751aecec67627d008..7e646d18e18851bfde743b379e52df4ec5b5a20f 100644
GIT binary patch
literal 1294
zcmciBZ!FYt0LSs~`O}?4B&X{LQQZ!myYnZ1OJT+`;uO_dnv$NlRLleVwQTVyQY*W4
z(LBi7!mRn%q?p;t8W*|fx+IxDC2aZEUBB<=*K^PM-oC%r_x=6-dGg(<Pv%`vkxd7W
zeS%Ip)SJIj!aiopPFD*%awePZQnkEw6YS|orRv)180w>rRSorZZ6vxUrEG!rn{qRH
z$afj{hqCRkuP?ty=>7NUXVJqM!{`z30rZEER`e)oL>ojkXoIN=Jx2KGvHsKOapQf4
ze(zI5rG{$kDn@^<C_tNZr_f*W)aZ%QX!O^_Q1s*(FZ4H=7(JB`Md)|Fy96&#r=_0g
z=|wm644<H923OFtQxoX9kzVwCUoZMc)eH1eemz6Kv#dOaUUf=BuL%nA+}cVmT%XQ_
z8>5NvPk#h7xA{ZM6AyZPggkHryjx~yRrC{DUzRX*VUukSZBsYkmY8|SR~Vtd`yI4%
z?uJ6r%(?Iw+MBAOgW)Bi!?F7sdTV<f+Nt3VbgsDxw^dw)F2(2J_PpcJH7fy%62qWd
zxD4))Nuby#o}r7Kf(^99N{W^&ilO_29rPGngS%eMLeJ)L=v6lWy$hWP9lLKdqJ1)c
zp?xpCg?mEuaBtExxKH#PO8qK1&4UbG$b<!GnXv`!H={=Tcilq==rwS^t_aFo(qLd|
z7F1LRLuGCup+j}W4IPw_i4IO%L5D~q(4nf2=mUK2T*KUdV?S()JJ;}a13IG51S7{f
zVN@e`uF;(j(FbpH=Xywc9UYU;o$KK;Ekiesq;TgNn^S_03oL{2amO_5Z4$rKO00PJ
zS=;<uaQUCE7EApc{Y$ks@oX%Xr?o_YwF9osN0ZegHjbU?>^#BFR5cN@5z1}`BnQb=
Oaz#M0QYlx;6~e!?Qp8jM

literal 835
zcmbu)%P(AU6bJC%4AL=_QI9fcy=sh(Yi7I#t$NHvh)Ev?Wu=HlH*P#*BUd7!i?#{1
z5D6U{kv8#)sEXI7X;dOuH6CFjjfD)lsFJyU=lc&>^mlW9=X_4SH#gT&)lhF{Hy#B~
zP|<PR{7Ny8dGQL8`Dr@oNuWOb)hSUQ`F0^v|M9n?n)=UPH}+exf3V+r<?W*HsG>F`
z>fV}Zk-C~qN$9SRu+Kq1?E7mH`P(b4u-|+i>_6T|ai$q;fdk&Qz;`;z;lPG+IH=MB
z2Nzl3kW4LnSFeRbV=_b<!c<qVRv89s&q5_ygdbkQ5u5+u$kjdg-qbF9-?<D&wfR$=
zMRz&jn6gti_RXS;hPbqC_(Aaq93MOj>k_+QoqJQFg<f3?>-T5i#A6%$aA^QGY}bgC
zOB!y6g&8ZH+*t`5`{QBL>o$rpbF&IgDSQd1zBq={bXjn^c^%HU6#-kqf4gX~9J%4l
z%QZOb`vIK2^96o1aV62>@xpsJ=fghyWJrW_8&}}G?sp>P@}G{v1$B+EHMtwMS)aqU
z^EsweC>0)_bpP)o%VYd^WqE#5;VH|XKQR?%U)-7!yMq;2d6n|2;PuSG)Ew!2X|SgV
PX2EE%n@oa9FsiQsrggfN

diff --git a/lib/tzdata/zoneinfo/America/Santa_Isabel b/lib/tzdata/zoneinfo/America/Santa_Isabel
index 19ccd3576d46b262f8b9f00b302f67bb4d26c4d4..e8be26b139e653e1b07a3db14ea34bd290441947 100644
GIT binary patch
delta 13
UcmZqVXyllX%JiaOWBM#+03quI7XSbN

delta 13
UcmZqVXyllX%Ji*aWBM#+03weCH2?qr

diff --git a/lib/tzdata/zoneinfo/America/Santiago b/lib/tzdata/zoneinfo/America/Santiago
index cde8dbbf049e1bbeabf3bc757828aa1884e673c6..d3fc9b8343369abf5f14be781397f426c5969608 100644
GIT binary patch
delta 117
zcmZqTI>j|1jIn8A_)=!^s|FkY8!(4506}a?%>fV{*Xg+dM8}839RSe@nc84}qKN~T
vpXA94<|oU>I)LO;G~RDuWMX7yWMP6qW+rA<7N*GoERmDrSwtqUWQha-$UGTw

delta 49
zcmX@b)x<R+jInBB_)=!+lN&bvH((ZJWMX7yWMP6qW+rA<W~Rv#SQ00{Wr+m<N`VW1

diff --git a/lib/tzdata/zoneinfo/America/Thunder_Bay b/lib/tzdata/zoneinfo/America/Thunder_Bay
index fcb032804311d539236b5b2e94746935b20d6a11..fe6be8ea8c97db1c1d99c4198f4b9b024e3aba4c 100644
GIT binary patch
literal 1717
zcmb`{`%hD690u?gM8tvuauF3L>a-N0Eg)XNjXFVwTgADO;SG<5L2$`9af+BI>V_hT
zhAg0FbHT|)F6t_16$ay?h!_(^@CHLXC}WPBM^seMcJKGuA7D)OZQk?r^PcBD{i(;W
zIx#+gy>qO1gBFe9-A7LG+GxI9Eqpc)r1VkdlxK;Q$A0e>D1S{?H&Pz|xl~7)n{6vo
z=0z97`TN$v1>Py>pNJ2I3mukA)GJy#9WLtA!X=(pMcOa9tw;alo0IS<lLkKBeh~ic
zkTYzoN`lX%`r&-(FJHiA3CnQ*?2bVAT!b%dTI&X%SB{4-guH~yZDqJ(mWxckU(wwR
zSK7RQD{l-)v|rVA7yiT81XtHrz%`j=aBcokxGpIhzL>TXz7&-V*T=1gFKc4p2K^3^
zo_obH7;f~7g|F?Gk<Bxo|ChoD?ze31lBs`7cOSkTUD8Cp<CRxSc{k_)e2?vgTiw2e
z+X9nybid79C{nh&Y!Q$h8Swq$@8OQ>Z{P<Raj=x5hdUFO!Vgn5@S{j?xGUBf{!68R
zyCeK$dhXv7W=oWhm5%T~?t^fT?NhjC=oZ}D-2(UBIS=<YnBak$7J<$`F*b{o@-Y+q
zH1ixhxa$b~Ea@=(eEoL#MN|qr6uJg}saXxb^4=!Vb6z_xf`{!^!Nad&WZEBj90I?&
z7Yx5`oC=%EJz-0sMdJSj#*Ua}3aj)^iPCzT1dkHU0@+4*D^iYLAqkYWx(DzW?M2wm
zs}3IPln*Od9;}e}!S>Q#*r7F7VtmHcCcxt>(qPBpA7t8h`Y9fE&iERhu>DimB{2ea
zUF8G2MXF%;g%0pUl|Ae+LnSailkEE8$=3Gp<Uxf<`%^mmVb7a=@YK2+@CT*W;c3T9
zVXtI{^V9ca!84*C!ZSA+CC2B&pn7=LvLE5uZYN-+&v&rWd`YC9N)ZjKItpN)p84>c
z>U7w*#USt+^UFzu)o16yn$*u=ZI%b@pO7F^FJSX992gM^&t2IL2Px;k^8%{j`D4bx
z3#PP5jL(AZC-B0NDmb{|CLHo-4!p=XAX4w6%H8nCnN4u$(T%V!sSIA6woBkO_DNJW
zyd-V|9HvQz!^4)q;m?X>YpeJ9jIw#3_W#|rSWMZB@%L4&l?{JOo?&+Q?trV)=XwJR
i598}gzP{pXg@GwJg7~JdK2RN?*81xG{nh?zt>RzxQxqHk

delta 187
zcmdnW`;l!zn4}*A0|OfnOZ*3dqIXR?Ai7_r`oZM$j1rU6nN2pYW)@+pXJle#VPd5g
z{QrMV2m{0a|Em`;u>AkOa{~j%|NqAiF!F#&0Wc}z;~T=@92~;n3c{S>Kq3H$T_(?F
GlL7!JbT8ll

diff --git a/lib/tzdata/zoneinfo/America/Tijuana b/lib/tzdata/zoneinfo/America/Tijuana
index 19ccd3576d46b262f8b9f00b302f67bb4d26c4d4..e8be26b139e653e1b07a3db14ea34bd290441947 100644
GIT binary patch
delta 13
UcmZqVXyllX%JiaOWBM#+03quI7XSbN

delta 13
UcmZqVXyllX%Ji*aWBM#+03weCH2?qr

diff --git a/lib/tzdata/zoneinfo/Antarctica/Vostok b/lib/tzdata/zoneinfo/Antarctica/Vostok
index 6e3290717e5a5586705b53043e3c6cbc07d140f1..69ff7f6fb4973efb1185cad9f553f8c770c75934 100644
GIT binary patch
delta 41
tcmZo=Y-OB~thC|Zt`tTFh9DURAP7ldVDa${VbC@(W8ks@l6JagTma-g2^9bU

delta 41
pcmZo=Y-OB~tn@OXvw@KT3PKVXSab~x7_<${7`SYJq@AuA7XZRF2gLvY

diff --git a/lib/tzdata/zoneinfo/Arctic/Longyearbyen b/lib/tzdata/zoneinfo/Arctic/Longyearbyen
index dfc509570a5be7ea90f64610ad5ca5a58fa3d172..465546bd396ae5eb75076f13ba9c29b0c926c835 100644
GIT binary patch
delta 246
zcmZ3&dXRNOn5PW`0|N^X3;hRz{6&dBK=f=L@dPk^_0|UvJ?G}S2_SmzlC5BR-p&bN
zdVb4vFnxlvaKglTla!0wrZIrjU5eP(0HzoE3xMd$$<knTSG<+M^i|7?3Lx>T>CYkj
z6~$nE*EF|))nC_<0@F7*r-A94Ob5a0ZoaG#*sRVd#>mdh$OMGUlMR^EH5eFpI)FZ4
jkWpX+`h-t_fs=tj%Yc#B$2Ww**)<qMfUxi6HYPa$RMd#{

delta 260
zcmX@ex`cH?n5Gp20|PS<^Zo~dqIW7eAbPg?V+JsNr8)sbpV;o3Fmb*~{iP&!0TBQ7
zdW8uf`ppU-F#qigTQL2uLk~>9uaF1RA2I~M^v4KBF#XB>6PW&N{uoSuQNIGFzlt9P
z)87O>OaPhtU7roi|Ni091fbg(gneBEfYfFuMsCK*`Aj@Wn8TWZflCCWNJfE?g@J)j
ofPvG;H-y32H5f#MFmM40T|*F8$JbcTRL?-i*U$h&>l<?c0K>O{w*UYD

diff --git a/lib/tzdata/zoneinfo/Asia/Amman b/lib/tzdata/zoneinfo/Asia/Amman
index d97d308d7afdd2e5c81a9895c2062706f9b4b1ce..a3f9dff57148554c4207d71df64851aee2b28b19 100644
GIT binary patch
delta 97
zcmbQmzJPr~7-u*G0|N^X3vP^G!6X1=FeHipe*mJBqy8sM7G(CGtia4|%*?=`xB(=p
nWxxnjE~CJ}31Tzw`uK)0xVi>|h!6&C17ij*8z5<?Ys>`zu+b5%

delta 91
zcmZ3$K8t-q7-uL00|PS<^KOh^!8BQs*=MpoGp8K`gW?9DAcK|xBMSqAi~<9vk8cQr
lt7|Zb2w~s?61qkpu8yyfo~fRRzLANJub}~uX{v9?1pp&u5nccQ

diff --git a/lib/tzdata/zoneinfo/Asia/Brunei b/lib/tzdata/zoneinfo/Asia/Brunei
index e67b411b9f5af9cf6b85aa51051f76b57d972afa..59bc6e40b7bb0b4eb199dd8c17f416ee00ca4158 100644
GIT binary patch
literal 320
zcmWHE%1kq2AP5+NDnJ+nLI`US0xDw#Vu}Aiu(peB0*Ky~?%n~S_gAYofa%ZD0U-Kd
z>>4ot;ME0S{$aZZ3?T8t+b&-K(MJ`8!SY9Eu!H4~GrEK2k5^iO<xf051LmKM-Vf%V
zI`SW^{<O_!u=>*zBf#>PJaRuUGBcq-7G?&9^a7BtGAkHZ7#K<o7`Yf23K|#$7#Qj%
gFo^j0hA?Owm>U}aNed$|31nF^aM=L)cDfc^0DJ^|K>z>%

delta 75
zcmX@WG>dUUm<tmF0|PS<^Zf^cwOvduAbMB2dj}&>CVLN1h9R?pfrWvgpn-wQ$2WvQ
U+rZq|07zOeaM=J!J6#Jd0HvT61ONa4

diff --git a/lib/tzdata/zoneinfo/Asia/Damascus b/lib/tzdata/zoneinfo/Asia/Damascus
index 168ef9baa47ee3db368ded8a8ad1385491b3631f..bd1624de5148d5670e4585dfcb445d8b270c02df 100644
GIT binary patch
delta 258
zcmbQvafx$67-uB|0|N^X3vP^;V6F!;82n3aCxGaH&J_V5Ixu8!0*DUE>;m(HP3D97
zAwkP7fW$*Z8o~T9qYf}X>`OA3A0d<l=11JEf4~3)k)M3P{HVQ&V1D!^Jup9Jt}~b)
zyGg(hED%?#3Koc;ts4N;$B+=q4(2CT^Mm<GHZQ^a<fxAUlN*^MCr@COH)dvFP~re8
pX3#QV1o}rtfq@gmX5jVl4PkI~4F(Y*4B7_93|uxq(oWZy3jmLgH^2Y@

delta 86
zcmcb_Ih|ud7-upA0|PS<^KOinV4iHql5ESspu_<bV9+vPWMN>CQDETo@eN^cbqxj)
cAq-qVLe~hy)$ujfGu1QIH_-7lG=Q+U0Ggl=i~s-t

diff --git a/lib/tzdata/zoneinfo/Asia/Gaza b/lib/tzdata/zoneinfo/Asia/Gaza
index effc4df50f5329f56b8d357e9c117cca031fed62..bed968e7ecb2a6ac44642b400c85927105ab43ea 100644
GIT binary patch
delta 56
zcmcb?`HFKw7-Pl8@Eyzo3_y@%-}3-OC&$Enm@LSmFj=1^Y;rS;JD;h6j<2DCo{64`
IzNrBh0OJ7<6#xJL

delta 39
vcmaFGd4qF87-QMS@Ey#P6<HJ}+p~mCp3dURXKtk9YiOWnqGzISWXc5q2#yOO

diff --git a/lib/tzdata/zoneinfo/Asia/Hebron b/lib/tzdata/zoneinfo/Asia/Hebron
index aa52bd263c4852f465d8bff4ccea233775486a54..3ce1bac63134c393682a2a91f5d13c7b05ab2db4 100644
GIT binary patch
delta 56
zcmaFG`G<2t7-QAO@Dt1e3_y@%-}3-OC&$Enn5@X6Fxj3ZV)9fLcRo`C9bZEOJrg|>
IeNzK20P<@Oe*gdg

delta 39
vcmeyv`HFKw7-Pl8@Dt3F4OtW>`?Ew$UdiIhXKtk9YiOWnqGzISWXc5q6k-dD

diff --git a/lib/tzdata/zoneinfo/Asia/Ho_Chi_Minh b/lib/tzdata/zoneinfo/Asia/Ho_Chi_Minh
index 7ca99725028879bc5ed9ee294795b4d20229f83c..de53596d6819e9e2d313be0ec246dc8d596ef812 100644
GIT binary patch
delta 17
ZcmaFE_=a&p8e`YQbZ@5QZxgpz002U|2X_Df

delta 17
YcmaFE_=a&p8e_x6bZ@2<hKXA&06v2TcmMzZ

diff --git a/lib/tzdata/zoneinfo/Asia/Kuala_Lumpur b/lib/tzdata/zoneinfo/Asia/Kuala_Lumpur
index e93dd5141bcad38d256cb53b7bc5a7637d9ac77a..350d77e28ee770be54bff6aea7f03ebbb82effaa 100644
GIT binary patch
delta 18
ZcmZo*YG9g>$`rhKV!9JkV(i4#p#V8N27Lek

delta 18
ZcmZo*YG9g>$`rb4V!9JkeAvX*p#V8@27Lek

diff --git a/lib/tzdata/zoneinfo/Asia/Saigon b/lib/tzdata/zoneinfo/Asia/Saigon
index 7ca99725028879bc5ed9ee294795b4d20229f83c..de53596d6819e9e2d313be0ec246dc8d596ef812 100644
GIT binary patch
delta 17
ZcmaFE_=a&p8e`YQbZ@5QZxgpz002U|2X_Df

delta 17
YcmaFE_=a&p8e_x6bZ@2<hKXA&06v2TcmMzZ

diff --git a/lib/tzdata/zoneinfo/Asia/Tehran b/lib/tzdata/zoneinfo/Asia/Tehran
index f1555f0032f55d90a01db26c09d50bb5deaff5c5..824acb0426faaf659a7f209dda6e1ffd0f3ce2ec 100644
GIT binary patch
delta 235
zcmcb@zlLo>n5R1f0|Ofn%lrp|Svj>QK=giwGaf)O2Hq(y79g5$t?&*I&0ksU0HOsn
zP8|T#Z>=0awBXu39vi3sV610kW@2SwWoDufGB6l`?FEu73=H-jj2sLMh87Hb3=D1o
uj3NvS77h#&KE5FgAwaBcU}9_lB#nWjn6`l_NPvOM1}tEwYiwm~zy$zTlqMhm

literal 2004
zcmdVZ>r+&90Eh8|pfHAFEEP3QFcCokvg{(ef?R?W1mz|y#YF=XganFP38J8}Bmo74
z2?>Y+g@6S?KniI>v0M_2iv%=g&WJNGI3v!OIzwll{s3QhcFz8I&gXkx><dD|<6~vQ
z6E7Wcp}n<N$dg~uh_f}~y>UgnDi3B4XwPdi#sk{-*Izj6qdkq%>^!vRhGGvX=b|(H
zbZ8tq<88iO+UF9*0&QaV3~g<mL0ivM(XS4jreEuQiMDAT_0hg(Tcc8HPrG7Wd{fQ|
z+&)=>OQU;mhrk3}=6M&F%a&+I%XE6Pi3NM7HI3|@?yGRc?O9woS%7cRY`~qnjcAvq
za(Zi}Cwtez0rqZL8Mu4mW85RM5q~|v9`|(LM0+{3)802V?0qHz*zf4~r+queX}^YC
z_B$)|+3(8l!2L5_@PGsJcwj^l9^{uu2fN;*ciYyo4>7Z1AG&TFR|(;`YRLc(`>Pm#
zbF7Gdt4~6Qw_Rc%QNNviWZ5zvrOw3nq+8*8<67{y!<y-6Ul|>vyup5-O)UF&UXbAX
z4J+{dkG%2N#SuJiZkRqW8cfIcuCPyN&13)W899Eiv>Q*%jm48v7x3hmO8mW0bNu~n
zW^{_8o=$xwn0=b*b@u7{YCQd+A)YbcjejuXj(<4hMjz_wqcfXR*k@HgV1Kx%9?#CP
z!H*<O<42?S;yFQk=v=Q`^f6fp`{S0+vHwWYkLRuN!}FFO;Og5)@cgN4`r|=e`b1YN
z`+_C~`%fxv;e~|>cu|%qUYuBse;QRqe->y#m$;3xFLh9{FEiJ}KQ}JG%XJiZ`Mn<e
z<lh(RFD5<dQ+;>YS9E5uuWYcuzdY55pUw}%s}9ZK)$y}*O=Jvx#?Od-t!p{^v$kIN
zS1)Stx^@5k|JSWN#_N|Jv2VDUOMg9P&;FY$9qb$1V(@cy^LSI)NxWIT5pPM;;OFB4
z@NdKX>F;)o)2+&5?AvS%*nj_g2i|Vzg10}sgLf<@<3G$L(VbV9>8{>d_T8;k?0>A8
zz%P_W;1_cZ@SfCSymwy_{gX;UUwY#*`^yS%_CH%L<5x^G@jiWPyzig$c>kRi`j=Tb
z{p;Wj_5(e!>^03M_+WJ<K2+q54<8-DN0Nu>-(rI4t3d+$Q7<+7F_|2{_HsA=yCe=D
zU%iNr-(R37=2Pg&DKqv{ntJxvyLRK#=ce&LD%AK)p&>qd_$hiWsf7MB%H2n2m7cEN
zs@4Dhk040-(c-tBAUG%m13}mxsIy)WlpcbyAc#Np*`2#Wgb?wzk;>&#@q4p)J8EyS
h)^6pgo1NTQE*1Y4pSjukDz@0m9BqANPIB>F`!C5Zup|Hg

diff --git a/lib/tzdata/zoneinfo/Atlantic/Jan_Mayen b/lib/tzdata/zoneinfo/Atlantic/Jan_Mayen
index dfc509570a5be7ea90f64610ad5ca5a58fa3d172..465546bd396ae5eb75076f13ba9c29b0c926c835 100644
GIT binary patch
delta 246
zcmZ3&dXRNOn5PW`0|N^X3;hRz{6&dBK=f=L@dPk^_0|UvJ?G}S2_SmzlC5BR-p&bN
zdVb4vFnxlvaKglTla!0wrZIrjU5eP(0HzoE3xMd$$<knTSG<+M^i|7?3Lx>T>CYkj
z6~$nE*EF|))nC_<0@F7*r-A94Ob5a0ZoaG#*sRVd#>mdh$OMGUlMR^EH5eFpI)FZ4
jkWpX+`h-t_fs=tj%Yc#B$2Ww**)<qMfUxi6HYPa$RMd#{

delta 260
zcmX@ex`cH?n5Gp20|PS<^Zo~dqIW7eAbPg?V+JsNr8)sbpV;o3Fmb*~{iP&!0TBQ7
zdW8uf`ppU-F#qigTQL2uLk~>9uaF1RA2I~M^v4KBF#XB>6PW&N{uoSuQNIGFzlt9P
z)87O>OaPhtU7roi|Ni091fbg(gneBEfYfFuMsCK*`Aj@Wn8TWZflCCWNJfE?g@J)j
ofPvG;H-y32H5f#MFmM40T|*F8$JbcTRL?-i*U$h&>l<?c0K>O{w*UYD

diff --git a/lib/tzdata/zoneinfo/Atlantic/Reykjavik b/lib/tzdata/zoneinfo/Atlantic/Reykjavik
index 2451aca76d7c555b06d358c2e30799c9b599fd1e..8906e88c819d9ad3b794eb6356a240a74a95ffae 100644
GIT binary patch
delta 51
xcmey!+Qc{^Oox$yfq@B#IsOB|q-T>n82|tOV*wNZ0Tv(M5C(T3<^mE1TmY~%4;=si

literal 753
zcmbu->nlTH90%|-V`(I%CKMAxEj5>vBAMF@_Ci~UH(Npxg~&TJR&oh1cr}c?l3OW7
zd!ZCDw_!8GTxWAPmznEvp6~tuFFdE`e9!0i`#qgH9a&L%Sv>XUVlfkBlO_B6NG3Dp
z$!vd`SsjWN4M}xxC`EEW-_}ENur|M$<dA`lIgM0>{_t!P`lBh)=#S3Tp}!;vMt?aq
znorIxn**mwu0&;Mkc&~M>o@{fH!eo59j>Fk-WdsRXs6)KN)EiG?uGTac6eJgf!q<U
zB6mx>k%nYFpS;JIRRiw@&A=vs6gIv0!Dhc|ckVYJ53GUcAI=rRM;nPq%Sb)y$CEtx
zL|FizcDdlQ;$--|$_!tKLtv{!3txtR!?q+7((V(C`W0^;zPkQ`ubpc6X4L}U8XMue
zu?6^kRslb>kHC-p?(gQPXoa7e<j7~K26Hd+boezv2|Lpw;J1Jh*cIjlyPmV*_a7Vl
zu@eJ-+S$l2Z5H2y_3w*K(>Ds{Ut<=_lcpVylsDj;Cy`M?k%)>F#ZfuTGncuExWA5R
Bu;Bmz

diff --git a/lib/tzdata/zoneinfo/Chile/Continental b/lib/tzdata/zoneinfo/Chile/Continental
index cde8dbbf049e1bbeabf3bc757828aa1884e673c6..d3fc9b8343369abf5f14be781397f426c5969608 100644
GIT binary patch
delta 117
zcmZqTI>j|1jIn8A_)=!^s|FkY8!(4506}a?%>fV{*Xg+dM8}839RSe@nc84}qKN~T
vpXA94<|oU>I)LO;G~RDuWMX7yWMP6qW+rA<7N*GoERmDrSwtqUWQha-$UGTw

delta 49
zcmX@b)x<R+jInBB_)=!+lN&bvH((ZJWMX7yWMP6qW+rA<W~Rv#SQ00{Wr+m<N`VW1

diff --git a/lib/tzdata/zoneinfo/Chile/EasterIsland b/lib/tzdata/zoneinfo/Chile/EasterIsland
index d29bcd68b0202ab8deefa1537cb12b03e057a521..54dff005b876339f5c1ff3dc0aeae1519c29b368 100644
GIT binary patch
delta 88
zcmX@dF^zLV7-QbXa0_O81|WznsW||m<2pSzfav&;xC0<MAyXU7Pc(4=^OHPz!Te;|
YSO<`NipKlNeaz{T_cL=${>mH)0Kl^r5C8xG

delta 20
ccmbQnd5&X37-QPTa0}+i=b6(c+p<Ig08GjT{r~^~

diff --git a/lib/tzdata/zoneinfo/Eire b/lib/tzdata/zoneinfo/Eire
index 4a45ea8f73f8e2a3f0b7a9ee4e387745fa859c3d..17d2b1582df89d5794f20fb028956dd9da154922 100644
GIT binary patch
delta 18
Zcmcb?eS>>K8so=}=_0I*{F7@~V*o{324DaH

delta 18
Zcmcb?eS>>K8snXf=_0I*DwAtiV*o_l24DaH

diff --git a/lib/tzdata/zoneinfo/Europe/Amsterdam b/lib/tzdata/zoneinfo/Europe/Amsterdam
index 4a6fa1d4945d6646652e2972ee8b632ca64c00cc..31973271d2f87f7e9df4e8b0a1481f09a9e5407d 100644
GIT binary patch
literal 1103
zcmb8t{Yz6(7zgk>-LhoqO>@p^wOVUsb1!a_h#+h32XiZ-QDS9*B1JEZAyHA0FetGf
zW&{eewrsjAon_86r)6eal=d>U96^wjMNn1*(l2(O@BRSmT+aF2?{l7e;9jn^^iX9k
zGw<MW9W-fJ=YOP<Yg@og$s9L!b-({a9{n6<$cBQ#bEHcsx54q~4B0s8cam4U0eH37
z3EhtRn4_~A+V>o2o*}QD?X!_hsubkwr_9i6sD{mDGVHg=4ah!)3*N})!PbN`F~8|;
zbk5D`{m8f86vMXA7TEsO2mL-7?C|WcQUC4p0^~b2hheA9?4kNydnfEFR>44Fsg&y7
z8W#Cp?s3?Y{4?g<6zu&z2JcVQN~yo^?GG3Xe}Mfx5jfzk@zDN*h5+(IS0)@hQ4b#-
zya0zvPQu5V)gI~}-mnMx$;Lq#Dw#k%6kP<v+cHppK3&98|43`PlN@a_BEPt#hcAzn
zq5jG)LVmqHA30K&k33c+bJBmZ*jo;hY9%b?WQPfvt;&N-DikoqDu$_+0+#xg>i!_7
z$-Y8S>N}VoKN9oT02EJkz>J6oN`~rSX0V^7bF$j}a9N`pF2Cr6D^6EK=@C0zxwjmy
zGFzc+lL@X?=0SOu0<IB?p+aDE()o(tdbswZ9IhJ|!R+A#xV~!^D!pG|&gCdnIi5jv
zRS;?_+M#yeB+HA7=i`bK{QDJq;y+e~;Y;WZxRp;b3mGPfWrW-}lk!-)=cSn~R%R<V
icblw?5pyR6Zb{@~j@HQCDlIydL8Vbzv>H;aOZ*G`0?%at

literal 1071
zcmb8s?MqWp90%|_-CD>^Z?opIWv;buxjFBgjb8LZnS&xHt1c4eqEL*$7i*31MG%G2
zi}qp-p(0Du*)pcihib#khtv$rWrd-`S4l`@7DQydsdK*j1FUm6=X1X2ocrT)uULJq
zzL;6JNyrU4XcO0e<P5ncCqwgxv^2%h2I^hbxB}<i*HBv)A}sY@U<BR|>R{_FC2aGR
zdFlCsi)+a3E-i9LRT4SikRf+kV#p75Cy|5v7<_bU33kalQm$6BwBF<8Ysew~19E8U
zEOPgkdgPwqVdUP#9T>i@hkbo{u-|ovrF91U$Kar&06w{ps{2%6k)MfC7|B|N(b7gQ
zeJ=WS7I{c@9(ibf1;&1LVm}^9AP*<!;mGYU9F05SSfd|44^F3CbmDuCpYXV7{fWyH
zaPmMEd~y2cH@ZKial@D8{SKO6Eg#{iGhI18YNFkW{MugvXRqqu8@Cd^tt|D?|Gz0v
z3o~!zax`Z(*^oJp1#Yh6p+Z!_Y<oFJ?`<*vM&7FZ43*i7FeiN`<@aHzTIz+{-nGHp
z@tbgaEY8t7>QE2d(b5X@ygs<|(iNEB;D(x-TDYr1gxZ5PxZ7ZXIyDdXuqw#QtUg+w
z|4{<>e$>Hzb4pk+DTn&OHE0NYf`!dVXl$B>MV=TG>bjxHxxl4K{=G}nY2P6Gug);i
zX8Q7qfJBP*Mly#Pmh6m56bzHeF)H%u@+ImDyU0`?7nw4mUJ!}}GMmV3wTWbqgAB4N
VG|{EOZZ_^W3I@ALpca`k{sL)%tV93+

diff --git a/lib/tzdata/zoneinfo/Europe/Copenhagen b/lib/tzdata/zoneinfo/Europe/Copenhagen
index 45984a7599d238b389829ef9d63e5c5c0609e785..465546bd396ae5eb75076f13ba9c29b0c926c835 100644
GIT binary patch
delta 292
zcmaFQa*%aGn5PW`0|N^X3;hRz{6&dBK=f=L@dPk^_0|UvJ?G}S2_SmzlC5BR-p&bN
zdVb4vFnxlvaKglPljMurrZIrjU5eP(0HzoE3xMd$$<knTSG<+M^i|7?3Lx>T>CYkj
z6~$nE*EF|))nC_<0@F7*r-A94Ob5a0ZoaJ8_>Pk?g^3XvGJ|;#5?LHOn}LC+1L$7{
j83jh5zxf0hI2jnU3>bNRd_x$VU4uac2>VVBWRe2_LkWpb

delta 237
zcmX@e`krM%n4vKP0|N^X3;qX!%(nAeKy)F`dlL{nTdpSoOkdr10Ysm04lkHE-^BQm
ziogUA|8ixk0EoUKy%x;B8n+hAzk2@xn7;0Q5-fgw|DnxhjGT-WjLb}=LIwuzGeGx&
zNT54q6c{-e82AJjczt|B7@R@aH5f#MFmM40T|*F8$JbcTRL?-i*U$h&>l<?c06N`Q
A-~a#s

diff --git a/lib/tzdata/zoneinfo/Europe/Dublin b/lib/tzdata/zoneinfo/Europe/Dublin
index 4a45ea8f73f8e2a3f0b7a9ee4e387745fa859c3d..17d2b1582df89d5794f20fb028956dd9da154922 100644
GIT binary patch
delta 18
Zcmcb?eS>>K8so=}=_0I*{F7@~V*o{324DaH

delta 18
Zcmcb?eS>>K8snXf=_0I*DwAtiV*o_l24DaH

diff --git a/lib/tzdata/zoneinfo/Europe/Kyiv b/lib/tzdata/zoneinfo/Europe/Kyiv
new file mode 100644
index 0000000000000000000000000000000000000000..4e026859fdee32dd3f77a25274c5ccbebe0ee554
GIT binary patch
literal 558
zcmWHE%1kq2AP5+NDnJ+nLI`V72P)$LVx|8;5Vq}j3W#1Mxg1PyT_TwP;-5OJcL7A7
zdG0L$qR*}rp8%rIEpi6)&z)US0J2Y1efb3tEhcft0Yr;)+ztTKzxWS;Xo**RV0p>g
z&JG~H)S1a(zVx02A3%JWH50+K?3^YrE!R^FrsZo=z_db6D414^aRbvzKIULr*+v6Q
ztLR9AX;m36Fs;V@8$$OgJOG)m@l?D4L~CB<0MlAWeu8Q3Ew8||&XU_;T6fABFs;|J
z7fkDytOL^qDf7X!VeDxJ5HKp*BEZPR%*w*b!pw#V*_jX!=(#x{EkKe5NGgB=UCV%h
zhk=1lfI$Ex!YIPPVBx?h2@+?N_3;g1@CIU6*ANEZU~dLzAnoiL4C1%|1%V7Mpp>o=
Xh^gaitY@lcpl__>YiIywnQ#FBI>mn0

literal 0
HcmV?d00001

diff --git a/lib/tzdata/zoneinfo/Europe/Luxembourg b/lib/tzdata/zoneinfo/Europe/Luxembourg
index 682bcbf61ac74f99905a5ea01072d5868a5a0189..31973271d2f87f7e9df4e8b0a1481f09a9e5407d 100644
GIT binary patch
delta 413
zcmdnbah_vBSbZ7;0|OfnOZ^9eux<CBf#}>9Cm2BV3>VJ^5IvhmwE#?Cz4ZY^&$+p7
z0*IcwWGk4Sw{rrRp5HPZLZAC#0Fqyju=E3nURbxg07Ng+69V%WSNVYHC8qU_V8+ro
zWw3%}s-|H6a`o9@dW9Avm|n?V3!&ec6o3p`^*kQTUwu6QOs_fa2&UJbTn?t!EmsE9
z>lgSJfYfhjX9e>&c4mX=O$9y+K;oO3i#9Eo?9RBA$xCwbKSnj?ytoOQ)tMp~O&OV(
zS-_Bqm3TOL0<+TO1<d?53=Aw%z(56&EFhYJgMoohfPsgBK}La50K{e#_3;g1a023R
S*AND0Fb)QBf+s7o$N>P+xY+yv

delta 414
zcmX@lv7ci?SbYiu0|Pq{i~R?JmPKp#fauwBJqcj?>a7nTdd{om4?y(XB{K^^^t_!D
zCV=SqEz=?NgCk(^1qn+(fW#NpJzW5z7wHLs`HQPE1wi~Irj20!(m4AGApSDddQ-5#
za`jaVAb}NHj9~ss_E`cT{>pbI1t5CW^E|Np>Klu|{58h|!2Go*mxI->TW$pAuV3H~
zmfz4W0_Jb*%m&MEDlljOnX|d511!HKKyLwvzjbm7;|eAxgUNhMYRvf?1U8#9MKH26
zF@oXb3(TsM?=!RKv#|mpR1hLXfMj4`Jpv3<1{noL76t}B0R~PG$;b;5V-Nz107;-M
Zua9pCgR^TehzMZ_2Qk83CmXWJ0RT7%(QN<#

diff --git a/lib/tzdata/zoneinfo/Europe/Monaco b/lib/tzdata/zoneinfo/Europe/Monaco
index f30dfc7014f46670a12fab61dbd74d3b0349afbe..00a27264c2cb3e28f2f46e5c267e12d575236a9d 100644
GIT binary patch
delta 185
zcmcb`agk#}m_#ZA0|Pq{%l`+0?31(4gXoC~0UPsr8Cg!`s6Uv@&!o!i|M0<PeWuBb
z^{gyF$i~D5qKJbG3`~YV^FbsF0|TD`BL|4bzzbqC2r@9pC@_kGNhu%S5QYFC4tEU(
U5g`oDU<~E}g}H#-$xbX104w+-V*mgE

delta 201
zcmcb}af@R@m_!-_0|Pq{%l`+0Ji+->K=i~4?u~i9j3TGRqd$Q7ryhko0MVz{W`3Cb
zpHX$Q4pSeaISUgMvau2i85r2!O#Z+u<}IVZD9FG7B*hpQ_yicFeSAY00)RN&H5f#I
iFp%dA;yD9(TtGtC5X9B-HP$oLGtluhGyu{1##{i?yfp6s

diff --git a/lib/tzdata/zoneinfo/Europe/Oslo b/lib/tzdata/zoneinfo/Europe/Oslo
index dfc509570a5be7ea90f64610ad5ca5a58fa3d172..465546bd396ae5eb75076f13ba9c29b0c926c835 100644
GIT binary patch
delta 246
zcmZ3&dXRNOn5PW`0|N^X3;hRz{6&dBK=f=L@dPk^_0|UvJ?G}S2_SmzlC5BR-p&bN
zdVb4vFnxlvaKglTla!0wrZIrjU5eP(0HzoE3xMd$$<knTSG<+M^i|7?3Lx>T>CYkj
z6~$nE*EF|))nC_<0@F7*r-A94Ob5a0ZoaG#*sRVd#>mdh$OMGUlMR^EH5eFpI)FZ4
jkWpX+`h-t_fs=tj%Yc#B$2Ww**)<qMfUxi6HYPa$RMd#{

delta 260
zcmX@ex`cH?n5Gp20|PS<^Zo~dqIW7eAbPg?V+JsNr8)sbpV;o3Fmb*~{iP&!0TBQ7
zdW8uf`ppU-F#qigTQL2uLk~>9uaF1RA2I~M^v4KBF#XB>6PW&N{uoSuQNIGFzlt9P
z)87O>OaPhtU7roi|Ni091fbg(gneBEfYfFuMsCK*`Aj@Wn8TWZflCCWNJfE?g@J)j
ofPvG;H-y32H5f#MFmM40T|*F8$JbcTRL?-i*U$h&>l<?c0K>O{w*UYD

diff --git a/lib/tzdata/zoneinfo/Europe/Simferopol b/lib/tzdata/zoneinfo/Europe/Simferopol
index 40d23c029a647297b4901286652d2db5407d32dd..298b8326ca7ab3e86b5f508fd06fc744b4a142f6 100644
GIT binary patch
delta 31
icmaFJ_K<BuDWlN(0tO(^FIfPl4N@i+Y;I?~#RveLWC?@-

delta 31
icmaFJ_K<BuDWg!U0|OA~m$U?cXoHk=ht2Jbw-^DA)CiOS

diff --git a/lib/tzdata/zoneinfo/Europe/Stockholm b/lib/tzdata/zoneinfo/Europe/Stockholm
index dd3eb32278521a84d7821b573b0111089d27bc15..465546bd396ae5eb75076f13ba9c29b0c926c835 100644
GIT binary patch
delta 369
zcmey!e2{fQSiKDc0|N^X3;hRz{6&dBK=f=L@dPk^_0|UvJ?G}S2_SmzlC5BR-p&bN
zdVb4vFnxlv5KNzW?kxaPcXp*Xn161OGnjvVk_ni;(4-2cFBXYG=xs^U7(f~>MeJ(;
z(+mB<5|@*uCxG}@yp_T9Rm+PCApX_#=MesiVz9nznp?o?uj@#G=^LEW!1PU~gJ5+x
zUsecgtmj~?XJSN#%wQgbL>9-+W?<my0EQ5Qi~=Jtr1%6FI2jnU3>bNRd_x$VU4uac
f2m^UsK$fl{NKD7qSkF|?K*!h607NtE8*>2wX{WQ5

delta 160
zcmX@e`jL4;n5HTN0|N^X3;qX!kgM~jfasdg;v^6~TdpSoOkchAVY4|S2V)i^6Ek7R
zz##AjXe0xl9LQ)s0R|2R1{noL9v|NjhG5qa24^r14q@N|vUCldU4uh(e2w)?^$c`;
L4GloFzA+a7R`V$I

diff --git a/lib/tzdata/zoneinfo/Europe/Uzhgorod b/lib/tzdata/zoneinfo/Europe/Uzhgorod
index d4c35914191fa2dd7a3e07105af0d4494681badb..4e026859fdee32dd3f77a25274c5ccbebe0ee554 100644
GIT binary patch
delta 215
zcmbQuvW{g!n5H@d0|N&TEByz8ux-avK=dlf<zRa263GM*|I}H%3lsBYSk9eYQ801-
zRAKJlAAnjI)Or;jfM|`U;tiAS8H4JXSy@<FnAtEPI}-vjFv!dS=>n20KvDr@y_Nw3
z4+8_A0D}NXgi(Zn!NP%25+u$j>*E{3;0?sCt|1J*!QKqcK-$?g7{qY_3IZ8iKq*}#
KSJ%m`Okx0ics4lz

delta 182
zcmZ3-GMi;Wn4}s50|Pq{%l!v}talqEK=cXD!U+@WWkk+TG7$jrFD#t*07PGW`uD@c
z`BS-j^*#W#FsOfZS}@t2F({3Z2?$x3F(4x=8yqq)h`a!4;uBzCVPKF^VB}z6uyA1H
qWnj=UU=Rd}Fo=TKjFLXSAq>v0ARHXR;2Z1$#NG_9t|61Tm{b7oJuwLY

diff --git a/lib/tzdata/zoneinfo/Europe/Zaporozhye b/lib/tzdata/zoneinfo/Europe/Zaporozhye
index 71819a5adde17f48dc381d917a7327f04becaa43..4e026859fdee32dd3f77a25274c5ccbebe0ee554 100644
GIT binary patch
delta 144
zcmdnVvW{g!n1(t70|N&TEByz8ux-avK=dlf<zRa263GM*|I}H%iFI;JXID&|H<w4P
zSK$Fr1B1p>@rKF%jM>iYObE!pATtLf2_#v7qyornEdvG~1_nL>1_6)=qX+|og#)7`
SNSsmD$2Ww*+c#tqlO+JYmnuR4

delta 156
zcmZ3-vXf;(n1%)e0|N&TtNaIoux*DqK=dlf#RedH>k`QX5PfRZ^NDqGOna|QoHtiQ
zomIU6sDVNKs|1+Vc=9%2vO8n88#6l-0x~ct`~ay^xWK@|z#yZ*z{S9zWx&A4z`!TK
hAOsR&6k}kpaA1@Mi8IRk_=YfO8yFcGO#aGf2>|!5EnENq

diff --git a/lib/tzdata/zoneinfo/Iceland b/lib/tzdata/zoneinfo/Iceland
index 2451aca76d7c555b06d358c2e30799c9b599fd1e..8906e88c819d9ad3b794eb6356a240a74a95ffae 100644
GIT binary patch
delta 51
xcmey!+Qc{^Oox$yfq@B#IsOB|q-T>n82|tOV*wNZ0Tv(M5C(T3<^mE1TmY~%4;=si

literal 753
zcmbu->nlTH90%|-V`(I%CKMAxEj5>vBAMF@_Ci~UH(Npxg~&TJR&oh1cr}c?l3OW7
zd!ZCDw_!8GTxWAPmznEvp6~tuFFdE`e9!0i`#qgH9a&L%Sv>XUVlfkBlO_B6NG3Dp
z$!vd`SsjWN4M}xxC`EEW-_}ENur|M$<dA`lIgM0>{_t!P`lBh)=#S3Tp}!;vMt?aq
znorIxn**mwu0&;Mkc&~M>o@{fH!eo59j>Fk-WdsRXs6)KN)EiG?uGTac6eJgf!q<U
zB6mx>k%nYFpS;JIRRiw@&A=vs6gIv0!Dhc|ckVYJ53GUcAI=rRM;nPq%Sb)y$CEtx
zL|FizcDdlQ;$--|$_!tKLtv{!3txtR!?q+7((V(C`W0^;zPkQ`ubpc6X4L}U8XMue
zu?6^kRslb>kHC-p?(gQPXoa7e<j7~K26Hd+boezv2|Lpw;J1Jh*cIjlyPmV*_a7Vl
zu@eJ-+S$l2Z5H2y_3w*K(>Ds{Ut<=_lcpVylsDj;Cy`M?k%)>F#ZfuTGncuExWA5R
Bu;Bmz

diff --git a/lib/tzdata/zoneinfo/Indian/Christmas b/lib/tzdata/zoneinfo/Indian/Christmas
index 766024b36c50c66e097b9811e5650468b1695746..ed687d2985c208171adcaa3401496b05325edca4 100644
GIT binary patch
delta 73
zcmZo=oWVFD%!!GCfq@x_dHw@I*tXUqAbL?&`VmH;Oq>l+21K$jFeDW)aQOI!FgO9R
Qwt+bVmkp4#(>3P;0D~tK*Z=?k

delta 54
zcmbQi*vdE|OrMc~fq@B#IsOAdvDnHdK!Ic#pa4Ts0RxMVZwQ07fjI-04Un|cHRl2V
Dg2)W3

diff --git a/lib/tzdata/zoneinfo/Indian/Cocos b/lib/tzdata/zoneinfo/Indian/Cocos
index 117503410ce98195cd30ca4f63777465b2991e13..14b2ad09ead50a62d5e2b426396c51f9beb293be 100644
GIT binary patch
literal 187
zcmWHE%1kq2AP5+NDnJ+nLI`VN0V)Gwq5nV-wypCbh+g=qI1ogi{`5xzL|>eh{(+H+
znTdfRN*`n{kOb<9&S2nRV5pnGz~|!|!Vm<++6HFE20+r1fy)NWw$nAUGB)4>0PImF
AssI20

delta 61
zcmdnZ*uyv>%#4wNfq@B#x&8w|O{m%upg`0epa4U31_O(aZwQ07ftj%Z1D6e$w$nAU
IGB)4>0P*||YXATM

diff --git a/lib/tzdata/zoneinfo/Indian/Kerguelen b/lib/tzdata/zoneinfo/Indian/Kerguelen
index 8ce93e01247e18c9d97ac51b19f618b80bfd9c95..58a82e4eb701ecb0413f908c57080646be392bba 100644
GIT binary patch
delta 73
zcmZo=oWVFD%!!GCfq@x_dHw@I*tYo+Ao{KT;TeoT8J8D884$_Bz~C0Zz~SQ?!r%+U
Q+6JZ!TsA<`PS=zR0FqA?a{vGU

delta 54
zcmbQi*vdE|OrMc~fq@B#IsOB|t;D1TkN_CC1u(Ga8W=EW8<;Y1*#Jp9T~jUqZ1D?`

diff --git a/lib/tzdata/zoneinfo/Indian/Mahe b/lib/tzdata/zoneinfo/Indian/Mahe
index e7fccf8296e7eb93c2d49f26570f68be2eeeb475..58d75bc26eec90272e97696f40483eb56c2b8b45 100644
GIT binary patch
delta 19
bcmZo=Y-OB~%(?K>%oU6b48}Jm=12knMi&PE

delta 19
acmZo=Y-OB~%-LDb-onVhVEkudjwAp%o(19n

diff --git a/lib/tzdata/zoneinfo/Indian/Reunion b/lib/tzdata/zoneinfo/Indian/Reunion
index 248a7c93a52b8bee6e7dea4f513025894ae6a397..58d75bc26eec90272e97696f40483eb56c2b8b45 100644
GIT binary patch
delta 19
bcmZo=Y-OB~%(?K>%oU6b48}Jm=12knMi&PE

delta 19
acmZo=Y-OB~%sKIlWdkDvg9*dL97zB>G6iY?

diff --git a/lib/tzdata/zoneinfo/Iran b/lib/tzdata/zoneinfo/Iran
index f1555f0032f55d90a01db26c09d50bb5deaff5c5..824acb0426faaf659a7f209dda6e1ffd0f3ce2ec 100644
GIT binary patch
delta 235
zcmcb@zlLo>n5R1f0|Ofn%lrp|Svj>QK=giwGaf)O2Hq(y79g5$t?&*I&0ksU0HOsn
zP8|T#Z>=0awBXu39vi3sV610kW@2SwWoDufGB6l`?FEu73=H-jj2sLMh87Hb3=D1o
uj3NvS77h#&KE5FgAwaBcU}9_lB#nWjn6`l_NPvOM1}tEwYiwm~zy$zTlqMhm

literal 2004
zcmdVZ>r+&90Eh8|pfHAFEEP3QFcCokvg{(ef?R?W1mz|y#YF=XganFP38J8}Bmo74
z2?>Y+g@6S?KniI>v0M_2iv%=g&WJNGI3v!OIzwll{s3QhcFz8I&gXkx><dD|<6~vQ
z6E7Wcp}n<N$dg~uh_f}~y>UgnDi3B4XwPdi#sk{-*Izj6qdkq%>^!vRhGGvX=b|(H
zbZ8tq<88iO+UF9*0&QaV3~g<mL0ivM(XS4jreEuQiMDAT_0hg(Tcc8HPrG7Wd{fQ|
z+&)=>OQU;mhrk3}=6M&F%a&+I%XE6Pi3NM7HI3|@?yGRc?O9woS%7cRY`~qnjcAvq
za(Zi}Cwtez0rqZL8Mu4mW85RM5q~|v9`|(LM0+{3)802V?0qHz*zf4~r+queX}^YC
z_B$)|+3(8l!2L5_@PGsJcwj^l9^{uu2fN;*ciYyo4>7Z1AG&TFR|(;`YRLc(`>Pm#
zbF7Gdt4~6Qw_Rc%QNNviWZ5zvrOw3nq+8*8<67{y!<y-6Ul|>vyup5-O)UF&UXbAX
z4J+{dkG%2N#SuJiZkRqW8cfIcuCPyN&13)W899Eiv>Q*%jm48v7x3hmO8mW0bNu~n
zW^{_8o=$xwn0=b*b@u7{YCQd+A)YbcjejuXj(<4hMjz_wqcfXR*k@HgV1Kx%9?#CP
z!H*<O<42?S;yFQk=v=Q`^f6fp`{S0+vHwWYkLRuN!}FFO;Og5)@cgN4`r|=e`b1YN
z`+_C~`%fxv;e~|>cu|%qUYuBse;QRqe->y#m$;3xFLh9{FEiJ}KQ}JG%XJiZ`Mn<e
z<lh(RFD5<dQ+;>YS9E5uuWYcuzdY55pUw}%s}9ZK)$y}*O=Jvx#?Od-t!p{^v$kIN
zS1)Stx^@5k|JSWN#_N|Jv2VDUOMg9P&;FY$9qb$1V(@cy^LSI)NxWIT5pPM;;OFB4
z@NdKX>F;)o)2+&5?AvS%*nj_g2i|Vzg10}sgLf<@<3G$L(VbV9>8{>d_T8;k?0>A8
zz%P_W;1_cZ@SfCSymwy_{gX;UUwY#*`^yS%_CH%L<5x^G@jiWPyzig$c>kRi`j=Tb
z{p;Wj_5(e!>^03M_+WJ<K2+q54<8-DN0Nu>-(rI4t3d+$Q7<+7F_|2{_HsA=yCe=D
zU%iNr-(R37=2Pg&DKqv{ntJxvyLRK#=ce&LD%AK)p&>qd_$hiWsf7MB%H2n2m7cEN
zs@4Dhk040-(c-tBAUG%m13}mxsIy)WlpcbyAc#Np*`2#Wgb?wzk;>&#@q4p)J8EyS
h)^6pgo1NTQE*1Y4pSjukDz@0m9BqANPIB>F`!C5Zup|Hg

diff --git a/lib/tzdata/zoneinfo/Mexico/BajaNorte b/lib/tzdata/zoneinfo/Mexico/BajaNorte
index 19ccd3576d46b262f8b9f00b302f67bb4d26c4d4..e8be26b139e653e1b07a3db14ea34bd290441947 100644
GIT binary patch
delta 13
UcmZqVXyllX%JiaOWBM#+03quI7XSbN

delta 13
UcmZqVXyllX%Ji*aWBM#+03weCH2?qr

diff --git a/lib/tzdata/zoneinfo/Mexico/BajaSur b/lib/tzdata/zoneinfo/Mexico/BajaSur
index 4c819fab0247e15f1ff9b6c76108c7290e536699..97d4d36c137fce3b89da84ba2b27dc17a86a15cb 100644
GIT binary patch
literal 718
zcmWHE%1kq2AP5+NDnJ+nLI`WI2P$I)Vv+wquyost0ua6aQ{Dp*y)7*)0Yq<iz67Rs
z@R&j9zil5t;-_B~g84TlZutPRkAb0}0Yn<6w+Mh}qhhfJ5N+(92IiXt{Q&b#)jhy`
zGoxEzzB#)Vm~SEd9i*JW;yDkPZ~6Nsm~Zt}Xaa~~z3n2HZ?l05%(vY=7tFWoe*@;*
z&#nja9rDkC`Hn5K8$be1{u{u2=agD7-$j2CnD6Qm59Yh^mw@^1Dvn^j`;UnNKy3`3
zEXrWM=Z#`8-|Go0nD4zK6wLQIs{~TU;5)+{%=cT%0_OWyNP_tRJ<q`Wz(mstAVyHm
z2{1p{Q5?(<@mU4thbsI8^TTv{!2EEA+hBf#=!yoAK*WQ+V1DG+E-*jpz<e-2`f3iC
zAG30g07zZzRzEO5u5%ukA3xOq%umQ{0P_>;d_l?>l01{Z{Ny-&21X`EW*}w(lH|bu
z|L52+F#P{NcLD>;|NpBOFmQlKMxOuw`x_Vpe0)O~e1k(6oPpTaC4?aWNOJ)N%((yu
C7@)rZ

delta 108
zcmX@d`krY*7^B$4@Er+^Okl{&$bt<2|DR*S!0`Y7+zAXU|NpOEz`*hUe}4l54~Weu
r;Nu&@;2Rvm;0(k8K<w)h!oUR-Fb6Vpd`<KW^$c`;4Gr{6^$fTGn#3N9

diff --git a/lib/tzdata/zoneinfo/Mexico/General b/lib/tzdata/zoneinfo/Mexico/General
index ffcf8bee10e5aa57dff8bb5764de94d73eab348d..80a415c70ca3d94aa25bbc1e90f3ed169943a704 100644
GIT binary patch
literal 773
zcmWHE%1kq2AP5+NDnJ+nLI`Vd0V-nyVu}Aiuyost0ua6aQ{Dp*y)7*)0Yq<iz67Rs
z@R&j9zil5t;z#do0P~McHwggoPlkSc0H$Bv1@q4{9Ru^vZw~|WZ_N}1^KX|mUjVt!
zFue>!F&Gtd6o6=B_XrThU=s8S%r{lH0`tv`&Vc#m>@r}!h4hOLAcn=We_+1l?^9sD
z)mN4Vkbw2JLtwtm`afX4?e0D>->&~2m~TJ30L*vDKLF-Cw)7SNwJ|vPF9P$OQ}V%l
z7yTA6-_<1$%y;8Y1M}TgjKO^OAI%IP;K?Ei=6l{q1@pZge+ToucesQ3K4*nLfEd0r
zG{JnoHDAGe{|as}KcMG2m>-y^-T)E^%Gn9#2Rm|t`5`{D!TeB#*I<5_PA!-p&TtmY
zj}V<z0My11@nAieANjQg%#S)S5zLRi8VBabtXv0D#t^&J0nCr<oB-y>PgMf*6Ecgy
z{KPuD4<JU8X9$>|9H;Psk%^I+k%<KeS-~WTMJoLNe=!dO!~g$tCor)5|G#<x0|$s?
m<oW-9=LSXrFe&2W8^Yil9KzrX#J(;-8id0`7`T7}W?TSv0M(fQ

delta 121
zcmZo=o5MUIj8mF{fq@l>MJC4INM&RKL1rLi0h1sW6#oCen1_Mk|NprY7+C)QU%h~V
z<NyDi8yI=Oq=1ia2!n5M2!k^Sy8v-`2m=?8V+Q2t_?qY$>KW+x8XD-C>KSkW0I_Z!
AdjJ3c

diff --git a/lib/tzdata/zoneinfo/Pacific/Chuuk b/lib/tzdata/zoneinfo/Pacific/Chuuk
index ea3fb5cd3c9e5e132c19a5320516dbc45a089135..5d8fc3a1b253d1df3a0184013469c6e46f6f6f75 100644
GIT binary patch
delta 75
zcmX@iIE!&Ym<tmF0|PS<^Zo~dux(KsAiC)7k_n7Jna&?T8HUae3@i)`Jqs8(eSAY0
V0(^mlwxIz7mkp4#(={~U0s!qo7b*Y%

literal 195
zcmWHE%1kq2AP5+NDnJ+nLI`VN11e(yVxIp%Ao6g(35c#UQ`-WfX9zBS0HPOI{`>%<
zPrl+x0MVBO`93f*F$3ZM|2AhpHud>{$esltv+5==aQOI!FlZYZFlZZCGH}@dS$4XH
G23!C=%Q2|{

diff --git a/lib/tzdata/zoneinfo/Pacific/Easter b/lib/tzdata/zoneinfo/Pacific/Easter
index d29bcd68b0202ab8deefa1537cb12b03e057a521..54dff005b876339f5c1ff3dc0aeae1519c29b368 100644
GIT binary patch
delta 88
zcmX@dF^zLV7-QbXa0_O81|WznsW||m<2pSzfav&;xC0<MAyXU7Pc(4=^OHPz!Te;|
YSO<`NipKlNeaz{T_cL=${>mH)0Kl^r5C8xG

delta 20
ccmbQnd5&X37-QPTa0}+i=b6(c+p<Ig08GjT{r~^~

diff --git a/lib/tzdata/zoneinfo/Pacific/Fiji b/lib/tzdata/zoneinfo/Pacific/Fiji
index 8b2dd52b1727a2ac1ccec600962d0b697b5fb361..610b850b1dec4966d570eb36f9a8b35fd6aacd68 100644
GIT binary patch
delta 48
zcmZ3(+{4To5|x=|G*M7&q5}Iw1=fk`0*p`|6NBu;@DGy%8D$umCg(D$Gjag{GrJ42

delta 90
zcmeBSUc<~95|x=|JW)_=q5}Iw1=fk`0*p`|6NB8u@DCgeK#-ij?7`$fM&Zc`j4U9`
i%*ezzIfYSO!baQB*iOgS&`{4v&j3gRDPw(0OD+KR?i9QL

diff --git a/lib/tzdata/zoneinfo/Pacific/Funafuti b/lib/tzdata/zoneinfo/Pacific/Funafuti
index 78ab35b6b02f38fdc95fe9afd1618a97fe717313..6bc216823e007c8dbdd6a5e8402b2e0cc5eaf3fc 100644
GIT binary patch
delta 17
YcmZo;Y-5~|$}V(<k%3{6$;2Ef04vV~*8l(j

delta 17
YcmZo;Y-5~|%FgqLk%3_a%fuWh04$*d*8l(j

diff --git a/lib/tzdata/zoneinfo/Pacific/Majuro b/lib/tzdata/zoneinfo/Pacific/Majuro
index 9228ee02ede240cc6c5831c8e54ed8216216ff23..6bc216823e007c8dbdd6a5e8402b2e0cc5eaf3fc 100644
GIT binary patch
delta 55
zcmcb`*v2>^%z%-Bfq@B#IsOAdote-Xpui#%pa8>)0}L!az99_ShDHorHbBx&*U*Ry
E0Hae4d;kCd

literal 218
zcmWHE%1kq2AP5+NDnJ+nLI`VN2P$I)Vv+wqP-iC60HS9IPQ3u47g+xM0HP1RH3joe
zzT!#%@z2}37l7#hZPEdZOpMG-j4TWc3mSmNFwEM(0A$xqVBlb2=vlzP!@#iO0E2*!
dZwQ07p&^5|fhCYO0AeEsE*l_er)y}$1pw{IITio_

diff --git a/lib/tzdata/zoneinfo/Pacific/Pohnpei b/lib/tzdata/zoneinfo/Pacific/Pohnpei
index b92b254a9af107fc4e40c4ca38d1ddc110effefc..720c679017404f9b9ecec0687c09a879abf6d256 100644
GIT binary patch
delta 55
zcmcb{*v2>^%z%-Bfq@B#IsOB|6o2C$pup5GKmmqX8yHx8d_x$t4GkH%Y=ESluAw0p
E0JTUC8UO$Q

literal 214
zcmWHE%1kq2AP5+NDnJ+nLI`VN2P$I)VuAlaAo6gh4v4NZQ&<C{X9!Nc0HPOI{`>%<
z556@8^H09wN&xXM3G#hlWMXDwVP^XO-{}g-$|)fra@Gb076yj82@D(z3_S}Nczk?A
Z7_<!y8MF;7fwTbwmkp3-r)y})1psQ?Iw=4E

diff --git a/lib/tzdata/zoneinfo/Pacific/Ponape b/lib/tzdata/zoneinfo/Pacific/Ponape
index b92b254a9af107fc4e40c4ca38d1ddc110effefc..720c679017404f9b9ecec0687c09a879abf6d256 100644
GIT binary patch
delta 55
zcmcb{*v2>^%z%-Bfq@B#IsOB|6o2C$pup5GKmmqX8yHx8d_x$t4GkH%Y=ESluAw0p
E0JTUC8UO$Q

literal 214
zcmWHE%1kq2AP5+NDnJ+nLI`VN2P$I)VuAlaAo6gh4v4NZQ&<C{X9!Nc0HPOI{`>%<
z556@8^H09wN&xXM3G#hlWMXDwVP^XO-{}g-$|)fra@Gb076yj82@D(z3_S}Nczk?A
Z7_<!y8MF;7fwTbwmkp3-r)y})1psQ?Iw=4E

diff --git a/lib/tzdata/zoneinfo/Pacific/Truk b/lib/tzdata/zoneinfo/Pacific/Truk
index ea3fb5cd3c9e5e132c19a5320516dbc45a089135..5d8fc3a1b253d1df3a0184013469c6e46f6f6f75 100644
GIT binary patch
delta 75
zcmX@iIE!&Ym<tmF0|PS<^Zo~dux(KsAiC)7k_n7Jna&?T8HUae3@i)`Jqs8(eSAY0
V0(^mlwxIz7mkp4#(={~U0s!qo7b*Y%

literal 195
zcmWHE%1kq2AP5+NDnJ+nLI`VN11e(yVxIp%Ao6g(35c#UQ`-WfX9zBS0HPOI{`>%<
zPrl+x0MVBO`93f*F$3ZM|2AhpHud>{$esltv+5==aQOI!FlZYZFlZZCGH}@dS$4XH
G23!C=%Q2|{

diff --git a/lib/tzdata/zoneinfo/Pacific/Wake b/lib/tzdata/zoneinfo/Pacific/Wake
index 71cca8877d33561091fe0faf319f3d3a4f14bbc4..6bc216823e007c8dbdd6a5e8402b2e0cc5eaf3fc 100644
GIT binary patch
delta 16
XcmZo;Y-5~|$|iJ%k%3{+#B6B*Cujts

delta 16
XcmZo;Y-5~|$|iA!k%3{(#B6B*Cx!%~

diff --git a/lib/tzdata/zoneinfo/Pacific/Wallis b/lib/tzdata/zoneinfo/Pacific/Wallis
index 4bce893003069bd2f7a3602b674c1ebf9aa55bac..6bc216823e007c8dbdd6a5e8402b2e0cc5eaf3fc 100644
GIT binary patch
delta 17
YcmZo;Y-5~|$}V(<k%3{6$;2Ef04vV~*8l(j

delta 17
YcmZo;Y-5~|%FeNZk%3`N#Kasa04nJO*8l(j

diff --git a/lib/tzdata/zoneinfo/Pacific/Yap b/lib/tzdata/zoneinfo/Pacific/Yap
index ea3fb5cd3c9e5e132c19a5320516dbc45a089135..5d8fc3a1b253d1df3a0184013469c6e46f6f6f75 100644
GIT binary patch
delta 75
zcmX@iIE!&Ym<tmF0|PS<^Zo~dux(KsAiC)7k_n7Jna&?T8HUae3@i)`Jqs8(eSAY0
V0(^mlwxIz7mkp4#(={~U0s!qo7b*Y%

literal 195
zcmWHE%1kq2AP5+NDnJ+nLI`VN11e(yVxIp%Ao6g(35c#UQ`-WfX9zBS0HPOI{`>%<
zPrl+x0MVBO`93f*F$3ZM|2AhpHud>{$esltv+5==aQOI!FlZYZFlZZCGH}@dS$4XH
G23!C=%Q2|{

diff --git a/lib/tzdata/zoneinfo/leapseconds b/lib/tzdata/zoneinfo/leapseconds
index ffa5eb80..6826ac4a 100644
--- a/lib/tzdata/zoneinfo/leapseconds
+++ b/lib/tzdata/zoneinfo/leapseconds
@@ -72,11 +72,11 @@ Leap	2016	Dec	31	23:59:60	+	S
 # Any additional leap seconds will come after this.
 # This Expires line is commented out for now,
 # so that pre-2020a zic implementations do not reject this file.
-#Expires 2022	Dec	28	00:00:00
+#Expires 2023	Jun	28	00:00:00
 
 # POSIX timestamps for the data in this file:
 #updated 1467936000 (2016-07-08 00:00:00 UTC)
-#expires 1672185600 (2022-12-28 00:00:00 UTC)
+#expires 1687910400 (2023-06-28 00:00:00 UTC)
 
-#	Updated through IERS Bulletin C63
-#	File expires on:  28 December 2022
+#	Updated through IERS Bulletin C64
+#	File expires on:  28 June 2023
diff --git a/lib/tzdata/zoneinfo/tzdata.zi b/lib/tzdata/zoneinfo/tzdata.zi
index c38197ea..a36449f4 100644
--- a/lib/tzdata/zoneinfo/tzdata.zi
+++ b/lib/tzdata/zoneinfo/tzdata.zi
@@ -1,4 +1,4 @@
-# version 2022a
+# version 2022f
 # This zic input file is in the public domain.
 R d 1916 o - Jun 14 23s 1 S
 R d 1916 1919 - O Su>=1 23s 0 -
@@ -43,16 +43,6 @@ Z Africa/Ndjamena 1:0:12 - LMT 1912
 1 - WAT
 Z Africa/Abidjan -0:16:8 - LMT 1912
 0 - GMT
-L Africa/Abidjan Africa/Accra
-L Africa/Abidjan Africa/Bamako
-L Africa/Abidjan Africa/Banjul
-L Africa/Abidjan Africa/Conakry
-L Africa/Abidjan Africa/Dakar
-L Africa/Abidjan Africa/Freetown
-L Africa/Abidjan Africa/Lome
-L Africa/Abidjan Africa/Nouakchott
-L Africa/Abidjan Africa/Ouagadougou
-L Africa/Abidjan Atlantic/St_Helena
 R K 1940 o - Jul 15 0 1 S
 R K 1940 o - O 1 0 0 -
 R K 1941 o - Ap 15 0 1 S
@@ -96,15 +86,6 @@ Z Africa/Nairobi 2:27:16 - LMT 1908 May
 2:30 - +0230 1936 D 31 24
 2:45 - +0245 1942 Jul 31 24
 3 - EAT
-L Africa/Nairobi Africa/Addis_Ababa
-L Africa/Nairobi Africa/Asmara
-L Africa/Nairobi Africa/Dar_es_Salaam
-L Africa/Nairobi Africa/Djibouti
-L Africa/Nairobi Africa/Kampala
-L Africa/Nairobi Africa/Mogadishu
-L Africa/Nairobi Indian/Antananarivo
-L Africa/Nairobi Indian/Comoro
-L Africa/Nairobi Indian/Mayotte
 Z Africa/Monrovia -0:43:8 - LMT 1882
 -0:43:8 - MMT 1919 Mar
 -0:44:30 - MMT 1972 Ja 7
@@ -335,13 +316,6 @@ Z Africa/El_Aaiun -0:52:48 - LMT 1934
 1 M +01/+00
 Z Africa/Maputo 2:10:20 - LMT 1903 Mar
 2 - CAT
-L Africa/Maputo Africa/Blantyre
-L Africa/Maputo Africa/Bujumbura
-L Africa/Maputo Africa/Gaborone
-L Africa/Maputo Africa/Harare
-L Africa/Maputo Africa/Kigali
-L Africa/Maputo Africa/Lubumbashi
-L Africa/Maputo Africa/Lusaka
 R NA 1994 o - Mar 21 0 -1 WAT
 R NA 1994 2017 - S Su>=1 2 0 CAT
 R NA 1995 2017 - Ap Su>=1 2 -1 WAT
@@ -356,31 +330,16 @@ Z Africa/Lagos 0:13:35 - LMT 1905 Jul
 0:13:35 - LMT 1914
 0:30 - +0030 1919 S
 1 - WAT
-L Africa/Lagos Africa/Bangui
-L Africa/Lagos Africa/Brazzaville
-L Africa/Lagos Africa/Douala
-L Africa/Lagos Africa/Kinshasa
-L Africa/Lagos Africa/Libreville
-L Africa/Lagos Africa/Luanda
-L Africa/Lagos Africa/Malabo
-L Africa/Lagos Africa/Niamey
-L Africa/Lagos Africa/Porto-Novo
-Z Indian/Reunion 3:41:52 - LMT 1911 Jun
-4 - +04
 Z Africa/Sao_Tome 0:26:56 - LMT 1884
 -0:36:45 - LMT 1912 Ja 1 0u
 0 - GMT 2018 Ja 1 1
 1 - WAT 2019 Ja 1 2
 0 - GMT
-Z Indian/Mahe 3:41:48 - LMT 1907
-4 - +04
 R SA 1942 1943 - S Su>=15 2 1 -
 R SA 1943 1944 - Mar Su>=15 2 0 -
 Z Africa/Johannesburg 1:52 - LMT 1892 F 8
 1:30 - SAST 1903 Mar
 2 SA SAST
-L Africa/Johannesburg Africa/Maseru
-L Africa/Johannesburg Africa/Mbabane
 R SD 1970 o - May 1 0 1 S
 R SD 1970 1985 - O 15 0 0 -
 R SD 1971 o - Ap 30 0 1 S
@@ -445,14 +404,10 @@ Z Antarctica/Davis 0 - -00 1957 Ja 13
 Z Antarctica/Mawson 0 - -00 1954 F 13
 6 - +06 2009 O 18 2
 5 - +05
-Z Indian/Kerguelen 0 - -00 1950
-5 - +05
 R Tr 2005 ma - Mar lastSu 1u 2 +02
 R Tr 2004 ma - O lastSu 1u 0 +00
 Z Antarctica/Troll 0 - -00 2005 F 12
 0 Tr %s
-Z Antarctica/Vostok 0 - -00 1957 D 16
-6 - +06
 Z Antarctica/Rothera 0 - -00 1976 D
 -3 - -03
 Z Asia/Kabul 4:36:48 - LMT 1890
@@ -491,9 +446,6 @@ Z Asia/Thimphu 5:58:36 - LMT 1947 Au 15
 Z Indian/Chagos 4:49:40 - LMT 1907
 5 - +05 1996
 6 - +06
-Z Asia/Brunei 7:39:40 - LMT 1926 Mar
-7:30 - +0730 1933
-8 - +08
 Z Asia/Yangon 6:24:47 - LMT 1880
 6:24:47 - RMT 1920
 6:30 - +0630 1942 May
@@ -535,7 +487,7 @@ R HK 1965 1976 - O Su>=16 3:30 0 -
 R HK 1973 o - D 30 3:30 1 S
 R HK 1979 o - May 13 3:30 1 S
 R HK 1979 o - O 21 3:30 0 -
-Z Asia/Hong_Kong 7:36:42 - LMT 1904 O 30 0:36:42
+Z Asia/Hong_Kong 7:36:42 - LMT 1904 O 29 17u
 8 - HKT 1941 Jun 15 3
 8 1 HKST 1941 O 1 4
 8 0:30 HKWT 1941 D 25
@@ -608,7 +560,6 @@ Z Asia/Famagusta 2:15:48 - LMT 1921 N 14
 2 E EE%sT 2016 S 8
 3 - +03 2017 O 29 1u
 2 E EE%sT
-L Asia/Nicosia Europe/Nicosia
 Z Asia/Tbilisi 2:59:11 - LMT 1880
 2:59:11 - TBMT 1924 May 2
 3 - +03 1957 Mar
@@ -634,7 +585,7 @@ Z Asia/Kolkata 5:53:28 - LMT 1854 Jun 28
 5:30 1 +0630 1945 O 15
 5:30 - IST
 Z Asia/Jakarta 7:7:12 - LMT 1867 Au 10
-7:7:12 - BMT 1923 D 31 23:47:12
+7:7:12 - BMT 1923 D 31 16:40u
 7:20 - +0720 1932 N
 7:30 - +0730 1942 Mar 23
 9 - +09 1945 S 23
@@ -660,9 +611,14 @@ Z Asia/Jayapura 9:22:48 - LMT 1932 N
 9 - +09 1944 S
 9:30 - +0930 1964
 9 - WIT
-R i 1978 1980 - Mar 20 24 1 -
-R i 1978 o - O 20 24 0 -
+R i 1910 o - Ja 1 0 0 -
+R i 1977 o - Mar 21 23 1 -
+R i 1977 o - O 20 24 0 -
+R i 1978 o - Mar 24 24 1 -
+R i 1978 o - Au 5 1 0 -
+R i 1979 o - May 26 24 1 -
 R i 1979 o - S 18 24 0 -
+R i 1980 o - Mar 20 24 1 -
 R i 1980 o - S 22 24 0 -
 R i 1991 o - May 2 24 1 -
 R i 1992 1995 - Mar 21 24 1 -
@@ -693,77 +649,11 @@ R i 2017 2019 - Mar 21 24 1 -
 R i 2017 2019 - S 21 24 0 -
 R i 2020 o - Mar 20 24 1 -
 R i 2020 o - S 20 24 0 -
-R i 2021 2023 - Mar 21 24 1 -
-R i 2021 2023 - S 21 24 0 -
-R i 2024 o - Mar 20 24 1 -
-R i 2024 o - S 20 24 0 -
-R i 2025 2027 - Mar 21 24 1 -
-R i 2025 2027 - S 21 24 0 -
-R i 2028 2029 - Mar 20 24 1 -
-R i 2028 2029 - S 20 24 0 -
-R i 2030 2031 - Mar 21 24 1 -
-R i 2030 2031 - S 21 24 0 -
-R i 2032 2033 - Mar 20 24 1 -
-R i 2032 2033 - S 20 24 0 -
-R i 2034 2035 - Mar 21 24 1 -
-R i 2034 2035 - S 21 24 0 -
-R i 2036 2037 - Mar 20 24 1 -
-R i 2036 2037 - S 20 24 0 -
-R i 2038 2039 - Mar 21 24 1 -
-R i 2038 2039 - S 21 24 0 -
-R i 2040 2041 - Mar 20 24 1 -
-R i 2040 2041 - S 20 24 0 -
-R i 2042 2043 - Mar 21 24 1 -
-R i 2042 2043 - S 21 24 0 -
-R i 2044 2045 - Mar 20 24 1 -
-R i 2044 2045 - S 20 24 0 -
-R i 2046 2047 - Mar 21 24 1 -
-R i 2046 2047 - S 21 24 0 -
-R i 2048 2049 - Mar 20 24 1 -
-R i 2048 2049 - S 20 24 0 -
-R i 2050 2051 - Mar 21 24 1 -
-R i 2050 2051 - S 21 24 0 -
-R i 2052 2053 - Mar 20 24 1 -
-R i 2052 2053 - S 20 24 0 -
-R i 2054 2055 - Mar 21 24 1 -
-R i 2054 2055 - S 21 24 0 -
-R i 2056 2057 - Mar 20 24 1 -
-R i 2056 2057 - S 20 24 0 -
-R i 2058 2059 - Mar 21 24 1 -
-R i 2058 2059 - S 21 24 0 -
-R i 2060 2062 - Mar 20 24 1 -
-R i 2060 2062 - S 20 24 0 -
-R i 2063 o - Mar 21 24 1 -
-R i 2063 o - S 21 24 0 -
-R i 2064 2066 - Mar 20 24 1 -
-R i 2064 2066 - S 20 24 0 -
-R i 2067 o - Mar 21 24 1 -
-R i 2067 o - S 21 24 0 -
-R i 2068 2070 - Mar 20 24 1 -
-R i 2068 2070 - S 20 24 0 -
-R i 2071 o - Mar 21 24 1 -
-R i 2071 o - S 21 24 0 -
-R i 2072 2074 - Mar 20 24 1 -
-R i 2072 2074 - S 20 24 0 -
-R i 2075 o - Mar 21 24 1 -
-R i 2075 o - S 21 24 0 -
-R i 2076 2078 - Mar 20 24 1 -
-R i 2076 2078 - S 20 24 0 -
-R i 2079 o - Mar 21 24 1 -
-R i 2079 o - S 21 24 0 -
-R i 2080 2082 - Mar 20 24 1 -
-R i 2080 2082 - S 20 24 0 -
-R i 2083 o - Mar 21 24 1 -
-R i 2083 o - S 21 24 0 -
-R i 2084 2086 - Mar 20 24 1 -
-R i 2084 2086 - S 20 24 0 -
-R i 2087 o - Mar 21 24 1 -
-R i 2087 o - S 21 24 0 -
-R i 2088 ma - Mar 20 24 1 -
-R i 2088 ma - S 20 24 0 -
+R i 2021 2022 - Mar 21 24 1 -
+R i 2021 2022 - S 21 24 0 -
 Z Asia/Tehran 3:25:44 - LMT 1916
-3:25:44 - TMT 1946
-3:30 - +0330 1977 N
+3:25:44 - TMT 1935 Jun 13
+3:30 i +0330/+0430 1977 O 20 24
 4 i +04/+05 1979
 3:30 i +0330/+0430
 R IQ 1982 o - May 1 0 1 -
@@ -902,10 +792,11 @@ R J 2005 o - S lastF 0s 0 -
 R J 2006 2011 - O lastF 0s 0 -
 R J 2013 o - D 20 0 0 -
 R J 2014 2021 - Mar lastTh 24 1 S
-R J 2014 ma - O lastF 0s 0 -
-R J 2022 ma - F lastTh 24 1 S
+R J 2014 2022 - O lastF 0s 0 -
+R J 2022 o - F lastTh 24 1 S
 Z Asia/Amman 2:23:44 - LMT 1931
-2 J EE%sT
+2 J EE%sT 2022 O 28 0s
+3 - +03
 Z Asia/Almaty 5:7:48 - LMT 1924 May 2
 5 - +05 1930 Jun 21
 6 R +06/+07 1991 Mar 31 2s
@@ -1034,15 +925,6 @@ Z Asia/Beirut 2:22 - LMT 1880
 2 l EE%sT
 R NB 1935 1941 - S 14 0 0:20 -
 R NB 1935 1941 - D 14 0 0 -
-Z Asia/Kuala_Lumpur 6:46:46 - LMT 1901
-6:55:25 - SMT 1905 Jun
-7 - +07 1933
-7 0:20 +0720 1936
-7:20 - +0720 1941 S
-7:30 - +0730 1942 F 16
-9 - +09 1945 S 12
-7:30 - +0730 1982
-8 - +08
 Z Asia/Kuching 7:21:20 - LMT 1926 Mar
 7:30 - +0730 1933
 8 NB +08/+0820 1942 F 16
@@ -1107,14 +989,16 @@ R P 2013 o - S 27 0 0 -
 R P 2014 o - O 24 0 0 -
 R P 2015 o - Mar 28 0 1 S
 R P 2015 o - O 23 1 0 -
-R P 2016 2018 - Mar Sa>=24 1 1 S
-R P 2016 2018 - O Sa>=24 1 0 -
+R P 2016 2018 - Mar Sa<=30 1 1 S
+R P 2016 2018 - O Sa<=30 1 0 -
 R P 2019 o - Mar 29 0 1 S
-R P 2019 o - O Sa>=24 0 0 -
-R P 2020 2021 - Mar Sa>=24 0 1 S
+R P 2019 o - O Sa<=30 0 0 -
+R P 2020 2021 - Mar Sa<=30 0 1 S
 R P 2020 o - O 24 1 0 -
-R P 2021 ma - O F>=23 1 0 -
-R P 2022 ma - Mar Su>=25 0 1 S
+R P 2021 o - O 29 1 0 -
+R P 2022 o - Mar 27 0 1 S
+R P 2022 ma - O Sa<=30 2 0 -
+R P 2023 ma - Mar Sa<=30 2 1 S
 Z Asia/Gaza 2:17:52 - LMT 1900 O
 2 Z EET/EEST 1948 May 15
 2 K EE%sT 1967 Jun 5
@@ -1147,12 +1031,8 @@ Z Asia/Manila -15:56 - LMT 1844 D 31
 Z Asia/Qatar 3:26:8 - LMT 1920
 4 - +04 1972 Jun
 3 - +03
-L Asia/Qatar Asia/Bahrain
 Z Asia/Riyadh 3:6:52 - LMT 1947 Mar 14
 3 - +03
-L Asia/Riyadh Antarctica/Syowa
-L Asia/Riyadh Asia/Aden
-L Asia/Riyadh Asia/Kuwait
 Z Asia/Singapore 6:55:25 - LMT 1901
 6:55:25 - SMT 1905 Jun
 7 - +07 1933
@@ -1210,20 +1090,19 @@ R S 2008 o - Ap F>=1 0 1 S
 R S 2008 o - N 1 0 0 -
 R S 2009 o - Mar lastF 0 1 S
 R S 2010 2011 - Ap F>=1 0 1 S
-R S 2012 ma - Mar lastF 0 1 S
-R S 2009 ma - O lastF 0 0 -
+R S 2012 2022 - Mar lastF 0 1 S
+R S 2009 2022 - O lastF 0 0 -
 Z Asia/Damascus 2:25:12 - LMT 1920
-2 S EE%sT
+2 S EE%sT 2022 O 28
+3 - +03
 Z Asia/Dushanbe 4:35:12 - LMT 1924 May 2
 5 - +05 1930 Jun 21
 6 R +06/+07 1991 Mar 31 2s
-5 1 +05/+06 1991 S 9 2s
+5 1 +06 1991 S 9 2s
 5 - +05
 Z Asia/Bangkok 6:42:4 - LMT 1880
 6:42:4 - BMT 1920 Ap
 7 - +07
-L Asia/Bangkok Asia/Phnom_Penh
-L Asia/Bangkok Asia/Vientiane
 Z Asia/Ashgabat 3:53:32 - LMT 1924 May 2
 4 - +04 1930 Jun 21
 5 R +05/+06 1991 Mar 31 2
@@ -1231,7 +1110,6 @@ Z Asia/Ashgabat 3:53:32 - LMT 1924 May 2
 5 - +05
 Z Asia/Dubai 3:41:12 - LMT 1920
 4 - +04
-L Asia/Dubai Asia/Muscat
 Z Asia/Samarkand 4:27:53 - LMT 1924 May 2
 4 - +04 1930 Jun 21
 5 - +05 1981 Ap
@@ -1244,7 +1122,7 @@ Z Asia/Tashkent 4:37:11 - LMT 1924 May 2
 6 R +06/+07 1991 Mar 31 2
 5 R +05/+06 1992
 5 - +05
-Z Asia/Ho_Chi_Minh 7:6:40 - LMT 1906 Jul
+Z Asia/Ho_Chi_Minh 7:6:30 - LMT 1906 Jul
 7:6:30 - PLMT 1911 May
 7 - +07 1942 D 31 23
 8 - +08 1945 Mar 14 23
@@ -1407,10 +1285,6 @@ Z Antarctica/Macquarie 0 - -00 1899 N
 10 AT AE%sT 2010
 10 1 AEDT 2011
 10 AT AE%sT
-Z Indian/Christmas 7:2:52 - LMT 1895 F
-7 - +07
-Z Indian/Cocos 6:27:40 - LMT 1900
-6:30 - +0630
 R FJ 1998 1999 - N Su>=1 2 1 -
 R FJ 1999 2000 - F lastSu 3 0 -
 R FJ 2009 o - N 29 2 1 -
@@ -1423,8 +1297,6 @@ R FJ 2014 2018 - N Su>=1 2 1 -
 R FJ 2015 2021 - Ja Su>=12 3 0 -
 R FJ 2019 o - N Su>=8 2 1 -
 R FJ 2020 o - D 20 2 1 -
-R FJ 2022 ma - N Su>=8 2 1 -
-R FJ 2023 ma - Ja Su>=12 3 0 -
 Z Pacific/Fiji 11:55:44 - LMT 1915 O 26
 12 FJ +12/+13
 Z Pacific/Gambier -8:59:48 - LMT 1912 O
@@ -1453,7 +1325,6 @@ Z Pacific/Guam -14:21 - LMT 1844 D 31
 9 - +09 1944 Jul 31
 10 Gu G%sT 2000 D 23
 10 - ChST
-L Pacific/Guam Pacific/Saipan
 Z Pacific/Tarawa 11:32:4 - LMT 1901
 12 - +12
 Z Pacific/Kanton 0 - -00 1937 Au 31
@@ -1464,14 +1335,6 @@ Z Pacific/Kiritimati -10:29:20 - LMT 1901
 -10:40 - -1040 1979 O
 -10 - -10 1994 D 31
 14 - +14
-Z Pacific/Majuro 11:24:48 - LMT 1901
-11 - +11 1914 O
-9 - +09 1919 F
-11 - +11 1937
-10 - +10 1941 Ap
-9 - +09 1944 Ja 30
-11 - +11 1969 O
-12 - +12
 Z Pacific/Kwajalein 11:9:20 - LMT 1901
 11 - +11 1937
 10 - +10 1941 Ap
@@ -1479,21 +1342,6 @@ Z Pacific/Kwajalein 11:9:20 - LMT 1901
 11 - +11 1969 O
 -12 - -12 1993 Au 20 24
 12 - +12
-Z Pacific/Chuuk -13:52:52 - LMT 1844 D 31
-10:7:8 - LMT 1901
-10 - +10 1914 O
-9 - +09 1919 F
-10 - +10 1941 Ap
-9 - +09 1945 Au
-10 - +10
-Z Pacific/Pohnpei -13:27:8 - LMT 1844 D 31
-10:32:52 - LMT 1901
-11 - +11 1914 O
-9 - +09 1919 F
-11 - +11 1937
-10 - +10 1941 Ap
-9 - +09 1945 Au
-11 - +11
 Z Pacific/Kosrae -13:8:4 - LMT 1844 D 31
 10:51:56 - LMT 1901
 11 - +11 1914 O
@@ -1546,7 +1394,6 @@ Z Pacific/Auckland 11:39:4 - LMT 1868 N 2
 Z Pacific/Chatham 12:13:48 - LMT 1868 N 2
 12:15 - +1215 1946
 12:45 k +1245/+1345
-L Pacific/Auckland Antarctica/McMurdo
 R CK 1978 o - N 12 0 0:30 -
 R CK 1979 1991 - Mar Su>=1 0 0 -
 R CK 1979 1990 - O lastSu 0 0:30 -
@@ -1570,7 +1417,6 @@ Z Pacific/Palau -15:2:4 - LMT 1844 D 31
 Z Pacific/Port_Moresby 9:48:40 - LMT 1880
 9:48:32 - PMMT 1895
 10 - +10
-L Pacific/Port_Moresby Antarctica/DumontDUrville
 Z Pacific/Bougainville 10:22:16 - LMT 1880
 9:48:32 - PMMT 1895
 10 - +10 1942 Jul
@@ -1583,7 +1429,6 @@ Z Pacific/Pitcairn -8:40:20 - LMT 1901
 Z Pacific/Pago_Pago 12:37:12 - LMT 1892 Jul 5
 -11:22:48 - LMT 1911
 -11 - SST
-L Pacific/Pago_Pago Pacific/Midway
 R WS 2010 o - S lastSu 0 1 -
 R WS 2011 o - Ap Sa>=1 4 0 -
 R WS 2011 o - S lastSa 3 1 -
@@ -1609,10 +1454,6 @@ Z Pacific/Tongatapu 12:19:12 - LMT 1945 S 10
 12:20 - +1220 1961
 13 - +13 1999
 13 TO +13/+14
-Z Pacific/Funafuti 11:56:52 - LMT 1901
-12 - +12
-Z Pacific/Wake 11:6:28 - LMT 1901
-12 - +12
 R VU 1973 o - D 22 12u 1 -
 R VU 1974 o - Mar 30 12u 0 -
 R VU 1983 1991 - S Sa>=22 24 1 -
@@ -1621,8 +1462,6 @@ R VU 1992 1993 - Ja Sa>=22 24 0 -
 R VU 1992 o - O Sa>=22 24 1 -
 Z Pacific/Efate 11:13:16 - LMT 1912 Ja 13
 11 VU +11/+12
-Z Pacific/Wallis 12:15:20 - LMT 1901
-12 - +12
 R G 1916 o - May 21 2s 1 BST
 R G 1916 o - O 1 2s 0 GMT
 R G 1917 o - Ap 8 2s 1 BST
@@ -1688,14 +1527,11 @@ R G 1972 1980 - O Su>=23 2s 0 GMT
 R G 1981 1995 - Mar lastSu 1u 1 BST
 R G 1981 1989 - O Su>=23 1u 0 GMT
 R G 1990 1995 - O Su>=22 1u 0 GMT
-Z Europe/London -0:1:15 - LMT 1847 D 1 0s
+Z Europe/London -0:1:15 - LMT 1847 D
 0 G %s 1968 O 27
 1 - BST 1971 O 31 2u
 0 G %s 1996
 0 E GMT/BST
-L Europe/London Europe/Jersey
-L Europe/London Europe/Guernsey
-L Europe/London Europe/Isle_of_Man
 R IE 1971 o - O 31 2u -1 -
 R IE 1972 1980 - Mar Su>=16 2u 0 -
 R IE 1972 1980 - O Su>=23 2u -1 -
@@ -1703,7 +1539,7 @@ R IE 1981 ma - Mar lastSu 1u 0 -
 R IE 1981 1989 - O Su>=23 1u -1 -
 R IE 1990 1995 - O Su>=22 1u -1 -
 R IE 1996 ma - O lastSu 1u -1 -
-Z Europe/Dublin -0:25 - LMT 1880 Au 2
+Z Europe/Dublin -0:25:21 - LMT 1880 Au 2
 -0:25:21 - DMT 1916 May 21 2s
 -0:25:21 1 IST 1916 O 1 2s
 0 G %s 1921 D 6
@@ -1899,23 +1735,6 @@ Z Europe/Prague 0:57:44 - LMT 1850
 1 -1 GMT 1947 F 23 2
 1 CZ CE%sT 1979
 1 E CE%sT
-R D 1916 o - May 14 23 1 S
-R D 1916 o - S 30 23 0 -
-R D 1940 o - May 15 0 1 S
-R D 1945 o - Ap 2 2s 1 S
-R D 1945 o - Au 15 2s 0 -
-R D 1946 o - May 1 2s 1 S
-R D 1946 o - S 1 2s 0 -
-R D 1947 o - May 4 2s 1 S
-R D 1947 o - Au 10 2s 0 -
-R D 1948 o - May 9 2s 1 S
-R D 1948 o - Au 8 2s 0 -
-Z Europe/Copenhagen 0:50:20 - LMT 1890
-0:50:20 - CMT 1894
-1 D CE%sT 1942 N 2 2s
-1 c CE%sT 1945 Ap 2 2
-1 D CE%sT 1980
-1 E CE%sT
 Z Atlantic/Faroe -0:27:4 - LMT 1908 Ja 11
 0 - WET 1981
 0 E WE%sT
@@ -1959,7 +1778,6 @@ Z Europe/Helsinki 1:39:49 - LMT 1878 May 31
 1:39:49 - HMT 1921 May
 2 FI EE%sT 1983
 2 E EE%sT
-L Europe/Helsinki Europe/Mariehamn
 R F 1916 o - Jun 14 23s 1 S
 R F 1916 1919 - O Su>=1 23s 0 -
 R F 1917 o - Mar 24 23s 1 S
@@ -2025,8 +1843,7 @@ Z Europe/Berlin 0:53:28 - LMT 1893 Ap
 1 So CE%sT 1946
 1 DE CE%sT 1980
 1 E CE%sT
-L Europe/Zurich Europe/Busingen
-Z Europe/Gibraltar -0:21:24 - LMT 1880 Au 2 0s
+Z Europe/Gibraltar -0:21:24 - LMT 1880 Au 2
 0 G %s 1957 Ap 14 2
 1 - CET 1982
 1 E CE%sT
@@ -2080,25 +1897,6 @@ Z Europe/Budapest 1:16:20 - LMT 1890 N
 1 c CE%sT 1945
 1 h CE%sT 1984
 1 E CE%sT
-R w 1917 1919 - F 19 23 1 -
-R w 1917 o - O 21 1 0 -
-R w 1918 1919 - N 16 1 0 -
-R w 1921 o - Mar 19 23 1 -
-R w 1921 o - Jun 23 1 0 -
-R w 1939 o - Ap 29 23 1 -
-R w 1939 o - O 29 2 0 -
-R w 1940 o - F 25 2 1 -
-R w 1940 1941 - N Su>=2 1s 0 -
-R w 1941 1942 - Mar Su>=2 1s 1 -
-R w 1943 1946 - Mar Su>=1 1s 1 -
-R w 1942 1948 - O Su>=22 1s 0 -
-R w 1947 1967 - Ap Su>=1 1s 1 -
-R w 1949 o - O 30 1s 0 -
-R w 1950 1966 - O Su>=22 1s 0 -
-R w 1967 o - O 29 1s 0 -
-Z Atlantic/Reykjavik -1:28 - LMT 1908
--1 w -01/+00 1968 Ap 7 1s
-0 - GMT
 R I 1916 o - Jun 3 24 1 S
 R I 1916 1917 - S 30 24 0 -
 R I 1917 o - Mar 31 24 1 S
@@ -2141,13 +1939,11 @@ R I 1977 1979 - May Su>=22 0s 1 S
 R I 1978 o - O 1 0s 0 -
 R I 1979 o - S 30 0s 0 -
 Z Europe/Rome 0:49:56 - LMT 1866 D 12
-0:49:56 - RMT 1893 O 31 23:49:56
+0:49:56 - RMT 1893 O 31 23u
 1 I CE%sT 1943 S 10
 1 c CE%sT 1944 Jun 4
 1 I CE%sT 1980
 1 E CE%sT
-L Europe/Rome Europe/Vatican
-L Europe/Rome Europe/San_Marino
 R LV 1989 1996 - Mar lastSu 2s 1 S
 R LV 1989 1996 - S lastSu 2s 0 -
 Z Europe/Riga 1:36:34 - LMT 1880
@@ -2165,7 +1961,6 @@ Z Europe/Riga 1:36:34 - LMT 1880
 2 E EE%sT 2000 F 29
 2 - EET 2001 Ja 2
 2 E EE%sT
-L Europe/Zurich Europe/Vaduz
 Z Europe/Vilnius 1:41:16 - LMT 1880
 1:24 - WMT 1917
 1:35:36 - KMT 1919 O 10
@@ -2181,36 +1976,6 @@ Z Europe/Vilnius 1:41:16 - LMT 1880
 1 E CE%sT 1999 O 31 1u
 2 - EET 2003
 2 E EE%sT
-R LX 1916 o - May 14 23 1 S
-R LX 1916 o - O 1 1 0 -
-R LX 1917 o - Ap 28 23 1 S
-R LX 1917 o - S 17 1 0 -
-R LX 1918 o - Ap M>=15 2s 1 S
-R LX 1918 o - S M>=15 2s 0 -
-R LX 1919 o - Mar 1 23 1 S
-R LX 1919 o - O 5 3 0 -
-R LX 1920 o - F 14 23 1 S
-R LX 1920 o - O 24 2 0 -
-R LX 1921 o - Mar 14 23 1 S
-R LX 1921 o - O 26 2 0 -
-R LX 1922 o - Mar 25 23 1 S
-R LX 1922 o - O Su>=2 1 0 -
-R LX 1923 o - Ap 21 23 1 S
-R LX 1923 o - O Su>=2 2 0 -
-R LX 1924 o - Mar 29 23 1 S
-R LX 1924 1928 - O Su>=2 1 0 -
-R LX 1925 o - Ap 5 23 1 S
-R LX 1926 o - Ap 17 23 1 S
-R LX 1927 o - Ap 9 23 1 S
-R LX 1928 o - Ap 14 23 1 S
-R LX 1929 o - Ap 20 23 1 S
-Z Europe/Luxembourg 0:24:36 - LMT 1904 Jun
-1 LX CE%sT 1918 N 25
-0 LX WE%sT 1929 O 6 2s
-0 b WE%sT 1940 May 14 3
-1 c WE%sT 1944 S 18 3
-1 b CE%sT 1977
-1 E CE%sT
 R MT 1973 o - Mar 31 0s 1 S
 R MT 1973 o - S 29 0s 0 -
 R MT 1974 o - Ap 21 0s 1 S
@@ -2218,7 +1983,7 @@ R MT 1974 o - S 16 0s 0 -
 R MT 1975 1979 - Ap Su>=15 2 1 S
 R MT 1975 1980 - S Su>=15 2 0 -
 R MT 1980 o - Mar 31 2 1 S
-Z Europe/Malta 0:58:4 - LMT 1893 N 2 0s
+Z Europe/Malta 0:58:4 - LMT 1893 N 2
 1 I CE%sT 1973 Mar 31
 1 MT CE%sT 1981
 1 E CE%sT
@@ -2234,50 +1999,6 @@ Z Europe/Chisinau 1:55:20 - LMT 1880
 2 R EE%sT 1992
 2 e EE%sT 1997
 2 MD EE%sT
-Z Europe/Monaco 0:29:32 - LMT 1892 Jun
-0:9:21 - PMT 1911 Mar 29
-0 F WE%sT 1945 S 16 3
-1 F CE%sT 1977
-1 E CE%sT
-R N 1916 o - May 1 0 1 NST
-R N 1916 o - O 1 0 0 AMT
-R N 1917 o - Ap 16 2s 1 NST
-R N 1917 o - S 17 2s 0 AMT
-R N 1918 1921 - Ap M>=1 2s 1 NST
-R N 1918 1921 - S lastM 2s 0 AMT
-R N 1922 o - Mar lastSu 2s 1 NST
-R N 1922 1936 - O Su>=2 2s 0 AMT
-R N 1923 o - Jun F>=1 2s 1 NST
-R N 1924 o - Mar lastSu 2s 1 NST
-R N 1925 o - Jun F>=1 2s 1 NST
-R N 1926 1931 - May 15 2s 1 NST
-R N 1932 o - May 22 2s 1 NST
-R N 1933 1936 - May 15 2s 1 NST
-R N 1937 o - May 22 2s 1 NST
-R N 1937 o - Jul 1 0 1 S
-R N 1937 1939 - O Su>=2 2s 0 -
-R N 1938 1939 - May 15 2s 1 S
-R N 1945 o - Ap 2 2s 1 S
-R N 1945 o - S 16 2s 0 -
-Z Europe/Amsterdam 0:19:32 - LMT 1835
-0:19:32 N %s 1937 Jul
-0:20 N +0020/+0120 1940 May 16
-1 c CE%sT 1945 Ap 2 2
-1 N CE%sT 1977
-1 E CE%sT
-R NO 1916 o - May 22 1 1 S
-R NO 1916 o - S 30 0 0 -
-R NO 1945 o - Ap 2 2s 1 S
-R NO 1945 o - O 1 2s 0 -
-R NO 1959 1964 - Mar Su>=15 2s 1 S
-R NO 1959 1965 - S Su>=15 2s 0 -
-R NO 1965 o - Ap 25 2s 1 S
-Z Europe/Oslo 0:43 - LMT 1895
-1 NO CE%sT 1940 Au 10 23
-1 c CE%sT 1945 Ap 2 2
-1 NO CE%sT 1980
-1 E CE%sT
-L Europe/Oslo Arctic/Longyearbyen
 R O 1918 1919 - S 16 2s 0 -
 R O 1919 o - Ap 15 2s 1 S
 R O 1944 o - Ap 3 2s 1 S
@@ -2434,9 +2155,8 @@ Z Europe/Simferopol 2:16:24 - LMT 1880
 3 - MSK 1990 Jul 1 2
 2 - EET 1992 Mar 20
 2 c EE%sT 1994 May
-3 e MSK/MSD 1996 Mar 31 0s
+3 c MSK/MSD 1996 Mar 31 0s
 3 1 MSD 1996 O 27 3s
-3 R MSK/MSD 1997
 3 - MSK 1997 Mar lastSu 1u
 2 E EE%sT 2014 Mar 30 2
 4 - MSK 2014 O 26 2s
@@ -2647,12 +2367,6 @@ Z Europe/Belgrade 1:22 - LMT 1884
 1 1 CEST 1945 S 16 2s
 1 - CET 1982 N 27
 1 E CE%sT
-L Europe/Belgrade Europe/Ljubljana
-L Europe/Belgrade Europe/Podgorica
-L Europe/Belgrade Europe/Sarajevo
-L Europe/Belgrade Europe/Skopje
-L Europe/Belgrade Europe/Zagreb
-L Europe/Prague Europe/Bratislava
 R s 1918 o - Ap 15 23 1 S
 R s 1918 1919 - O 6 24s 0 -
 R s 1919 o - Ap 6 23 1 S
@@ -2692,11 +2406,11 @@ R Sp 1976 o - Au 1 0 0 -
 R Sp 1977 o - S 28 0 0 -
 R Sp 1978 o - Jun 1 0 1 S
 R Sp 1978 o - Au 4 0 0 -
-Z Europe/Madrid -0:14:44 - LMT 1900 D 31 23:45:16
+Z Europe/Madrid -0:14:44 - LMT 1901 Ja 1 0u
 0 s WE%sT 1940 Mar 16 23
 1 s CE%sT 1979
 1 E CE%sT
-Z Africa/Ceuta -0:21:16 - LMT 1900 D 31 23:38:44
+Z Africa/Ceuta -0:21:16 - LMT 1901 Ja 1 0u
 0 - WET 1918 May 6 23
 0 1 WEST 1918 O 7 23
 0 - WET 1924
@@ -2710,12 +2424,6 @@ Z Atlantic/Canary -1:1:36 - LMT 1922 Mar
 0 - WET 1980 Ap 6 0s
 0 1 WEST 1980 S 28 1u
 0 E WE%sT
-Z Europe/Stockholm 1:12:12 - LMT 1879
-1:0:14 - SET 1900
-1 - CET 1916 May 14 23
-1 1 CEST 1916 O 1 1
-1 - CET 1980
-1 E CE%sT
 R CH 1941 1942 - May M>=1 1 1 S
 R CH 1941 1942 - O M>=1 2 0 -
 Z Europe/Zurich 0:34:8 - LMT 1853 Jul 16
@@ -2780,8 +2488,7 @@ Z Europe/Istanbul 1:55:52 - LMT 1880
 2 1 EEST 2015 N 8 1u
 2 E EE%sT 2016 S 7
 3 - +03
-L Europe/Istanbul Asia/Istanbul
-Z Europe/Kiev 2:2:4 - LMT 1880
+Z Europe/Kyiv 2:2:4 - LMT 1880
 2:2:4 - KMT 1924 May 2
 2 - EET 1930 Jun 21
 3 - MSK 1941 S 20
@@ -2790,26 +2497,6 @@ Z Europe/Kiev 2:2:4 - LMT 1880
 2 1 EEST 1991 S 29 3
 2 c EE%sT 1996 May 13
 2 E EE%sT
-Z Europe/Uzhgorod 1:29:12 - LMT 1890 O
-1 - CET 1940
-1 c CE%sT 1944 O
-1 1 CEST 1944 O 26
-1 - CET 1945 Jun 29
-3 R MSK/MSD 1990
-3 - MSK 1990 Jul 1 2
-1 - CET 1991 Mar 31 3
-2 - EET 1992 Mar 20
-2 c EE%sT 1996 May 13
-2 E EE%sT
-Z Europe/Zaporozhye 2:20:40 - LMT 1880
-2:20 - +0220 1924 May 2
-2 - EET 1930 Jun 21
-3 - MSK 1941 Au 25
-1 c CE%sT 1943 O 25
-3 R MSK/MSD 1991 Mar 31 2
-2 e EE%sT 1992 Mar 20
-2 c EE%sT 1996 May 13
-2 E EE%sT
 R u 1918 1919 - Mar lastSu 2 1 D
 R u 1918 1919 - O lastSu 2 0 S
 R u 1942 o - F 9 2 1 W
@@ -2835,7 +2522,7 @@ R NY 1920 o - O lastSu 2 0 S
 R NY 1921 1966 - Ap lastSu 2 1 D
 R NY 1921 1954 - S lastSu 2 0 S
 R NY 1955 1966 - O lastSu 2 0 S
-Z America/New_York -4:56:2 - LMT 1883 N 18 12:3:58
+Z America/New_York -4:56:2 - LMT 1883 N 18 17u
 -5 u E%sT 1920
 -5 NY E%sT 1942
 -5 u E%sT 1946
@@ -2847,7 +2534,7 @@ R Ch 1921 o - Mar lastSu 2 1 D
 R Ch 1922 1966 - Ap lastSu 2 1 D
 R Ch 1922 1954 - S lastSu 2 0 S
 R Ch 1955 1966 - O lastSu 2 0 S
-Z America/Chicago -5:50:36 - LMT 1883 N 18 12:9:24
+Z America/Chicago -5:50:36 - LMT 1883 N 18 18u
 -6 u C%sT 1920
 -6 Ch C%sT 1936 Mar 1 2
 -5 - EST 1936 N 15 2
@@ -2855,13 +2542,13 @@ Z America/Chicago -5:50:36 - LMT 1883 N 18 12:9:24
 -6 u C%sT 1946
 -6 Ch C%sT 1967
 -6 u C%sT
-Z America/North_Dakota/Center -6:45:12 - LMT 1883 N 18 12:14:48
+Z America/North_Dakota/Center -6:45:12 - LMT 1883 N 18 19u
 -7 u M%sT 1992 O 25 2
 -6 u C%sT
-Z America/North_Dakota/New_Salem -6:45:39 - LMT 1883 N 18 12:14:21
+Z America/North_Dakota/New_Salem -6:45:39 - LMT 1883 N 18 19u
 -7 u M%sT 2003 O 26 2
 -6 u C%sT
-Z America/North_Dakota/Beulah -6:47:7 - LMT 1883 N 18 12:12:53
+Z America/North_Dakota/Beulah -6:47:7 - LMT 1883 N 18 19u
 -7 u M%sT 2010 N 7 2
 -6 u C%sT
 R De 1920 1921 - Mar lastSu 2 1 D
@@ -2869,7 +2556,7 @@ R De 1920 o - O lastSu 2 0 S
 R De 1921 o - May 22 2 0 S
 R De 1965 1966 - Ap lastSu 2 1 D
 R De 1965 1966 - O lastSu 2 0 S
-Z America/Denver -6:59:56 - LMT 1883 N 18 12:0:4
+Z America/Denver -6:59:56 - LMT 1883 N 18 19u
 -7 u M%sT 1920
 -7 De M%sT 1942
 -7 u M%sT 1946
@@ -2880,7 +2567,7 @@ R CA 1949 o - Ja 1 2 0 S
 R CA 1950 1966 - Ap lastSu 1 1 D
 R CA 1950 1961 - S lastSu 2 0 S
 R CA 1962 1966 - O lastSu 2 0 S
-Z America/Los_Angeles -7:52:58 - LMT 1883 N 18 12:7:2
+Z America/Los_Angeles -7:52:58 - LMT 1883 N 18 20u
 -8 u P%sT 1946
 -8 CA P%sT 1967
 -8 u P%sT
@@ -2950,15 +2637,14 @@ Z Pacific/Honolulu -10:31:26 - LMT 1896 Ja 13 12
 -10:30 1 HDT 1933 May 21 12
 -10:30 u H%sT 1947 Jun 8 2
 -10 - HST
-Z America/Phoenix -7:28:18 - LMT 1883 N 18 11:31:42
+Z America/Phoenix -7:28:18 - LMT 1883 N 18 19u
 -7 u M%sT 1944 Ja 1 0:1
 -7 - MST 1944 Ap 1 0:1
 -7 u M%sT 1944 O 1 0:1
 -7 - MST 1967
 -7 u M%sT 1968 Mar 21
 -7 - MST
-L America/Phoenix America/Creston
-Z America/Boise -7:44:49 - LMT 1883 N 18 12:15:11
+Z America/Boise -7:44:49 - LMT 1883 N 18 20u
 -8 u P%sT 1923 May 13 2
 -7 u M%sT 1974
 -7 - MST 1974 F 3 2
@@ -2966,7 +2652,7 @@ Z America/Boise -7:44:49 - LMT 1883 N 18 12:15:11
 R In 1941 o - Jun 22 2 1 D
 R In 1941 1954 - S lastSu 2 0 S
 R In 1946 1954 - Ap lastSu 2 1 D
-Z America/Indiana/Indianapolis -5:44:38 - LMT 1883 N 18 12:15:22
+Z America/Indiana/Indianapolis -5:44:38 - LMT 1883 N 18 18u
 -6 u C%sT 1920
 -6 In C%sT 1942
 -6 u C%sT 1946
@@ -2981,7 +2667,7 @@ R Ma 1951 o - Ap lastSu 2 1 D
 R Ma 1951 o - S lastSu 2 0 S
 R Ma 1954 1960 - Ap lastSu 2 1 D
 R Ma 1954 1960 - S lastSu 2 0 S
-Z America/Indiana/Marengo -5:45:23 - LMT 1883 N 18 12:14:37
+Z America/Indiana/Marengo -5:45:23 - LMT 1883 N 18 18u
 -6 u C%sT 1951
 -6 Ma C%sT 1961 Ap 30 2
 -5 - EST 1969
@@ -2999,7 +2685,7 @@ R V 1956 1963 - Ap lastSu 2 1 D
 R V 1960 o - O lastSu 2 0 S
 R V 1961 o - S lastSu 2 0 S
 R V 1962 1963 - O lastSu 2 0 S
-Z America/Indiana/Vincennes -5:50:7 - LMT 1883 N 18 12:9:53
+Z America/Indiana/Vincennes -5:50:7 - LMT 1883 N 18 18u
 -6 u C%sT 1946
 -6 V C%sT 1964 Ap 26 2
 -5 - EST 1969
@@ -3011,7 +2697,7 @@ R Pe 1955 o - May 1 0 1 D
 R Pe 1955 1960 - S lastSu 2 0 S
 R Pe 1956 1963 - Ap lastSu 2 1 D
 R Pe 1961 1963 - O lastSu 2 0 S
-Z America/Indiana/Tell_City -5:47:3 - LMT 1883 N 18 12:12:57
+Z America/Indiana/Tell_City -5:47:3 - LMT 1883 N 18 18u
 -6 u C%sT 1946
 -6 Pe C%sT 1964 Ap 26 2
 -5 - EST 1967 O 29 2
@@ -3023,7 +2709,7 @@ R Pi 1955 o - May 1 0 1 D
 R Pi 1955 1960 - S lastSu 2 0 S
 R Pi 1956 1964 - Ap lastSu 2 1 D
 R Pi 1961 1964 - O lastSu 2 0 S
-Z America/Indiana/Petersburg -5:49:7 - LMT 1883 N 18 12:10:53
+Z America/Indiana/Petersburg -5:49:7 - LMT 1883 N 18 18u
 -6 u C%sT 1955
 -6 Pi C%sT 1965 Ap 25 2
 -5 - EST 1966 O 30 2
@@ -3036,7 +2722,7 @@ R St 1947 1954 - S lastSu 2 0 S
 R St 1955 1956 - O lastSu 2 0 S
 R St 1957 1958 - S lastSu 2 0 S
 R St 1959 1961 - O lastSu 2 0 S
-Z America/Indiana/Knox -5:46:30 - LMT 1883 N 18 12:13:30
+Z America/Indiana/Knox -5:46:30 - LMT 1883 N 18 18u
 -6 u C%sT 1947
 -6 St C%sT 1962 Ap 29 2
 -5 - EST 1963 O 27 2
@@ -3047,7 +2733,7 @@ R Pu 1946 1960 - Ap lastSu 2 1 D
 R Pu 1946 1954 - S lastSu 2 0 S
 R Pu 1955 1956 - O lastSu 2 0 S
 R Pu 1957 1960 - S lastSu 2 0 S
-Z America/Indiana/Winamac -5:46:25 - LMT 1883 N 18 12:13:35
+Z America/Indiana/Winamac -5:46:25 - LMT 1883 N 18 18u
 -6 u C%sT 1946
 -6 Pu C%sT 1961 Ap 30 2
 -5 - EST 1969
@@ -3055,7 +2741,7 @@ Z America/Indiana/Winamac -5:46:25 - LMT 1883 N 18 12:13:35
 -5 - EST 2006 Ap 2 2
 -6 u C%sT 2007 Mar 11 2
 -5 u E%sT
-Z America/Indiana/Vevay -5:40:16 - LMT 1883 N 18 12:19:44
+Z America/Indiana/Vevay -5:40:16 - LMT 1883 N 18 18u
 -6 u C%sT 1954 Ap 25 2
 -5 - EST 1969
 -5 u E%sT 1973
@@ -3070,7 +2756,7 @@ R v 1946 o - Jun 2 2 0 S
 R v 1950 1961 - Ap lastSu 2 1 D
 R v 1950 1955 - S lastSu 2 0 S
 R v 1956 1961 - O lastSu 2 0 S
-Z America/Kentucky/Louisville -5:43:2 - LMT 1883 N 18 12:16:58
+Z America/Kentucky/Louisville -5:43:2 - LMT 1883 N 18 18u
 -6 u C%sT 1921
 -6 v C%sT 1942
 -6 u C%sT 1946
@@ -3079,7 +2765,7 @@ Z America/Kentucky/Louisville -5:43:2 - LMT 1883 N 18 12:16:58
 -5 u E%sT 1974 Ja 6 2
 -6 1 CDT 1974 O 27 2
 -5 u E%sT
-Z America/Kentucky/Monticello -5:39:24 - LMT 1883 N 18 12:20:36
+Z America/Kentucky/Monticello -5:39:24 - LMT 1883 N 18 18u
 -6 u C%sT 1946
 -6 - CST 1968
 -6 u C%sT 2000 O 29 2
@@ -3256,22 +2942,6 @@ Z America/Toronto -5:17:32 - LMT 1895
 -5 C E%sT 1946
 -5 t E%sT 1974
 -5 C E%sT
-L America/Toronto America/Nassau
-Z America/Thunder_Bay -5:57 - LMT 1895
--6 - CST 1910
--5 - EST 1942
--5 C E%sT 1970
--5 t E%sT 1973
--5 - EST 1974
--5 C E%sT
-Z America/Nipigon -5:53:4 - LMT 1895
--5 C E%sT 1940 S 29
--5 1 EDT 1942 F 9 2s
--5 C E%sT
-Z America/Rainy_River -6:18:16 - LMT 1895
--6 C C%sT 1940 S 29
--6 1 CDT 1942 F 9 2s
--6 C C%sT
 R W 1916 o - Ap 23 0 1 D
 R W 1916 o - S 17 0 0 S
 R W 1918 o - Ap 14 2 1 D
@@ -3421,6 +3091,8 @@ Z America/Dawson -9:17:40 - LMT 1900 Au 20
 -8 Y P%sT 1980
 -8 C P%sT 2020 N
 -7 - MST
+R m 1931 o - May 1 23 1 D
+R m 1931 o - O 1 0 0 S
 R m 1939 o - F 5 0 1 D
 R m 1939 o - Jun 25 0 0 S
 R m 1940 o - D 9 0 1 D
@@ -3433,89 +3105,79 @@ R m 1996 2000 - Ap Su>=1 2 1 D
 R m 1996 2000 - O lastSu 2 0 S
 R m 2001 o - May Su>=1 2 1 D
 R m 2001 o - S lastSu 2 0 S
-R m 2002 ma - Ap Su>=1 2 1 D
-R m 2002 ma - O lastSu 2 0 S
-Z America/Cancun -5:47:4 - LMT 1922 Ja 1 0:12:56
+R m 2002 2022 - Ap Su>=1 2 1 D
+R m 2002 2022 - O lastSu 2 0 S
+Z America/Cancun -5:47:4 - LMT 1922 Ja 1 6u
 -6 - CST 1981 D 23
 -5 m E%sT 1998 Au 2 2
 -6 m C%sT 2015 F 1 2
 -5 - EST
-Z America/Merida -5:58:28 - LMT 1922 Ja 1 0:1:32
+Z America/Merida -5:58:28 - LMT 1922 Ja 1 6u
 -6 - CST 1981 D 23
 -5 - EST 1982 D 2
 -6 m C%sT
-Z America/Matamoros -6:40 - LMT 1921 D 31 23:20
+Z America/Matamoros -6:30 - LMT 1922 Ja 1 6u
 -6 - CST 1988
 -6 u C%sT 1989
 -6 m C%sT 2010
 -6 u C%sT
-Z America/Monterrey -6:41:16 - LMT 1921 D 31 23:18:44
+Z America/Monterrey -6:41:16 - LMT 1922 Ja 1 6u
 -6 - CST 1988
 -6 u C%sT 1989
 -6 m C%sT
-Z America/Mexico_City -6:36:36 - LMT 1922 Ja 1 0:23:24
+Z America/Mexico_City -6:36:36 - LMT 1922 Ja 1 7u
 -7 - MST 1927 Jun 10 23
 -6 - CST 1930 N 15
--7 - MST 1931 May 1 23
--6 - CST 1931 O
--7 - MST 1932 Ap
+-7 m M%sT 1932 Ap
 -6 m C%sT 2001 S 30 2
 -6 - CST 2002 F 20
 -6 m C%sT
-Z America/Ojinaga -6:57:40 - LMT 1922 Ja 1 0:2:20
+Z America/Ojinaga -6:57:40 - LMT 1922 Ja 1 7u
 -7 - MST 1927 Jun 10 23
 -6 - CST 1930 N 15
--7 - MST 1931 May 1 23
--6 - CST 1931 O
--7 - MST 1932 Ap
+-7 m M%sT 1932 Ap
 -6 - CST 1996
 -6 m C%sT 1998
 -6 - CST 1998 Ap Su>=1 3
 -7 m M%sT 2010
--7 u M%sT
-Z America/Chihuahua -7:4:20 - LMT 1921 D 31 23:55:40
+-7 u M%sT 2022 O 30 2
+-6 - CST
+Z America/Chihuahua -7:4:20 - LMT 1922 Ja 1 7u
 -7 - MST 1927 Jun 10 23
 -6 - CST 1930 N 15
--7 - MST 1931 May 1 23
--6 - CST 1931 O
--7 - MST 1932 Ap
+-7 m M%sT 1932 Ap
 -6 - CST 1996
 -6 m C%sT 1998
 -6 - CST 1998 Ap Su>=1 3
--7 m M%sT
-Z America/Hermosillo -7:23:52 - LMT 1921 D 31 23:36:8
+-7 m M%sT 2022 O 30 2
+-6 - CST
+Z America/Hermosillo -7:23:52 - LMT 1922 Ja 1 7u
 -7 - MST 1927 Jun 10 23
 -6 - CST 1930 N 15
--7 - MST 1931 May 1 23
--6 - CST 1931 O
--7 - MST 1932 Ap
+-7 m M%sT 1932 Ap
 -6 - CST 1942 Ap 24
 -7 - MST 1949 Ja 14
 -8 - PST 1970
 -7 m M%sT 1999
 -7 - MST
-Z America/Mazatlan -7:5:40 - LMT 1921 D 31 23:54:20
+Z America/Mazatlan -7:5:40 - LMT 1922 Ja 1 7u
 -7 - MST 1927 Jun 10 23
 -6 - CST 1930 N 15
--7 - MST 1931 May 1 23
--6 - CST 1931 O
--7 - MST 1932 Ap
+-7 m M%sT 1932 Ap
 -6 - CST 1942 Ap 24
 -7 - MST 1949 Ja 14
 -8 - PST 1970
 -7 m M%sT
-Z America/Bahia_Banderas -7:1 - LMT 1921 D 31 23:59
+Z America/Bahia_Banderas -7:1 - LMT 1922 Ja 1 7u
 -7 - MST 1927 Jun 10 23
 -6 - CST 1930 N 15
--7 - MST 1931 May 1 23
--6 - CST 1931 O
--7 - MST 1932 Ap
+-7 m M%sT 1932 Ap
 -6 - CST 1942 Ap 24
 -7 - MST 1949 Ja 14
 -8 - PST 1970
 -7 m M%sT 2010 Ap 4 2
 -6 m C%sT
-Z America/Tijuana -7:48:4 - LMT 1922 Ja 1 0:11:56
+Z America/Tijuana -7:48:4 - LMT 1922 Ja 1 7u
 -7 - MST 1924
 -8 - PST 1927 Jun 10 23
 -7 - MST 1930 N 15
@@ -3707,31 +3369,10 @@ Z America/Managua -5:45:8 - LMT 1890
 Z America/Panama -5:18:8 - LMT 1890
 -5:19:36 - CMT 1908 Ap 22
 -5 - EST
-L America/Panama America/Atikokan
-L America/Panama America/Cayman
 Z America/Puerto_Rico -4:24:25 - LMT 1899 Mar 28 12
 -4 - AST 1942 May 3
 -4 u A%sT 1946
 -4 - AST
-L America/Puerto_Rico America/Anguilla
-L America/Puerto_Rico America/Antigua
-L America/Puerto_Rico America/Aruba
-L America/Puerto_Rico America/Curacao
-L America/Puerto_Rico America/Blanc-Sablon
-L America/Puerto_Rico America/Dominica
-L America/Puerto_Rico America/Grenada
-L America/Puerto_Rico America/Guadeloupe
-L America/Puerto_Rico America/Kralendijk
-L America/Puerto_Rico America/Lower_Princes
-L America/Puerto_Rico America/Marigot
-L America/Puerto_Rico America/Montserrat
-L America/Puerto_Rico America/Port_of_Spain
-L America/Puerto_Rico America/St_Barthelemy
-L America/Puerto_Rico America/St_Kitts
-L America/Puerto_Rico America/St_Lucia
-L America/Puerto_Rico America/St_Thomas
-L America/Puerto_Rico America/St_Vincent
-L America/Puerto_Rico America/Tortola
 Z America/Miquelon -3:44:40 - LMT 1911 May 15
 -4 - AST 1980 May
 -3 - -03 1987
@@ -4089,7 +3730,9 @@ R x 2012 2014 - S Su>=2 4u 1 -
 R x 2016 2018 - May Su>=9 3u 0 -
 R x 2016 2018 - Au Su>=9 4u 1 -
 R x 2019 ma - Ap Su>=2 3u 0 -
-R x 2019 ma - S Su>=2 4u 1 -
+R x 2019 2021 - S Su>=2 4u 1 -
+R x 2022 o - S Su>=9 4u 1 -
+R x 2023 ma - S Su>=2 4u 1 -
 Z America/Santiago -4:42:45 - LMT 1890
 -4:42:45 - SMT 1910 Ja 10
 -5 - -05 1916 Jul
@@ -4099,9 +3742,9 @@ Z America/Santiago -4:42:45 - LMT 1890
 -5 x -05/-04 1932 S
 -4 - -04 1942 Jun
 -5 - -05 1942 Au
--4 - -04 1946 Jul 15
--4 1 -03 1946 S
--4 - -04 1947 Ap
+-4 - -04 1946 Jul 14 24
+-4 1 -03 1946 Au 28 24
+-5 1 -04 1947 Mar 31 24
 -5 - -05 1947 May 21 23
 -4 x -04/-03
 Z America/Punta_Arenas -4:43:40 - LMT 1890
@@ -4113,7 +3756,8 @@ Z America/Punta_Arenas -4:43:40 - LMT 1890
 -5 x -05/-04 1932 S
 -4 - -04 1942 Jun
 -5 - -05 1942 Au
--4 - -04 1947 Ap
+-4 - -04 1946 Au 28 24
+-5 1 -04 1947 Mar 31 24
 -5 - -05 1947 May 21 23
 -4 x -04/-03 2016 D 4
 -3 - -03
@@ -4277,15 +3921,9 @@ Z America/Caracas -4:27:44 - LMT 1890
 -4 - -04 2007 D 9 3
 -4:30 - -0430 2016 May 1 2:30
 -4 - -04
-Z Etc/GMT 0 - GMT
 Z Etc/UTC 0 - UTC
+Z Etc/GMT 0 - GMT
 L Etc/GMT GMT
-L Etc/UTC Etc/Universal
-L Etc/UTC Etc/Zulu
-L Etc/GMT Etc/Greenwich
-L Etc/GMT Etc/GMT-0
-L Etc/GMT Etc/GMT+0
-L Etc/GMT Etc/GMT0
 Z Etc/GMT-14 14 - +14
 Z Etc/GMT-13 13 - +13
 Z Etc/GMT-12 12 - +12
@@ -4313,49 +3951,7 @@ Z Etc/GMT+10 -10 - -10
 Z Etc/GMT+11 -11 - -11
 Z Etc/GMT+12 -12 - -12
 Z Factory 0 - -00
-L Africa/Nairobi Africa/Asmera
-L Africa/Abidjan Africa/Timbuktu
-L America/Argentina/Catamarca America/Argentina/ComodRivadavia
-L America/Adak America/Atka
-L America/Argentina/Buenos_Aires America/Buenos_Aires
-L America/Argentina/Catamarca America/Catamarca
-L America/Panama America/Coral_Harbour
-L America/Argentina/Cordoba America/Cordoba
-L America/Tijuana America/Ensenada
-L America/Indiana/Indianapolis America/Fort_Wayne
-L America/Nuuk America/Godthab
-L America/Indiana/Indianapolis America/Indianapolis
-L America/Argentina/Jujuy America/Jujuy
-L America/Indiana/Knox America/Knox_IN
-L America/Kentucky/Louisville America/Louisville
-L America/Argentina/Mendoza America/Mendoza
-L America/Toronto America/Montreal
-L America/Rio_Branco America/Porto_Acre
-L America/Argentina/Cordoba America/Rosario
-L America/Tijuana America/Santa_Isabel
-L America/Denver America/Shiprock
-L America/Puerto_Rico America/Virgin
-L Pacific/Auckland Antarctica/South_Pole
-L Asia/Ashgabat Asia/Ashkhabad
-L Asia/Kolkata Asia/Calcutta
-L Asia/Shanghai Asia/Chongqing
-L Asia/Shanghai Asia/Chungking
-L Asia/Dhaka Asia/Dacca
-L Asia/Shanghai Asia/Harbin
-L Asia/Urumqi Asia/Kashgar
-L Asia/Kathmandu Asia/Katmandu
-L Asia/Macau Asia/Macao
-L Asia/Yangon Asia/Rangoon
-L Asia/Ho_Chi_Minh Asia/Saigon
-L Asia/Jerusalem Asia/Tel_Aviv
-L Asia/Thimphu Asia/Thimbu
-L Asia/Makassar Asia/Ujung_Pandang
-L Asia/Ulaanbaatar Asia/Ulan_Bator
-L Atlantic/Faroe Atlantic/Faeroe
-L Europe/Oslo Atlantic/Jan_Mayen
 L Australia/Sydney Australia/ACT
-L Australia/Sydney Australia/Canberra
-L Australia/Hobart Australia/Currie
 L Australia/Lord_Howe Australia/LHI
 L Australia/Sydney Australia/NSW
 L Australia/Darwin Australia/North
@@ -4382,9 +3978,13 @@ L Pacific/Easter Chile/EasterIsland
 L America/Havana Cuba
 L Africa/Cairo Egypt
 L Europe/Dublin Eire
+L Etc/GMT Etc/GMT+0
+L Etc/GMT Etc/GMT-0
+L Etc/GMT Etc/GMT0
+L Etc/GMT Etc/Greenwich
 L Etc/UTC Etc/UCT
-L Europe/London Europe/Belfast
-L Europe/Chisinau Europe/Tiraspol
+L Etc/UTC Etc/Universal
+L Etc/UTC Etc/Zulu
 L Europe/London GB
 L Europe/London GB-Eire
 L Etc/GMT GMT+0
@@ -4392,7 +3992,7 @@ L Etc/GMT GMT-0
 L Etc/GMT GMT0
 L Etc/GMT Greenwich
 L Asia/Hong_Kong Hongkong
-L Atlantic/Reykjavik Iceland
+L Africa/Abidjan Iceland
 L Asia/Tehran Iran
 L Asia/Jerusalem Israel
 L America/Jamaica Jamaica
@@ -4406,12 +4006,6 @@ L Pacific/Auckland NZ
 L Pacific/Chatham NZ-CHAT
 L America/Denver Navajo
 L Asia/Shanghai PRC
-L Pacific/Kanton Pacific/Enderbury
-L Pacific/Honolulu Pacific/Johnston
-L Pacific/Pohnpei Pacific/Ponape
-L Pacific/Pago_Pago Pacific/Samoa
-L Pacific/Chuuk Pacific/Truk
-L Pacific/Chuuk Pacific/Yap
 L Europe/Warsaw Poland
 L Europe/Lisbon Portugal
 L Asia/Taipei ROC
@@ -4435,3 +4029,168 @@ L Etc/UTC UTC
 L Etc/UTC Universal
 L Europe/Moscow W-SU
 L Etc/UTC Zulu
+L America/Argentina/Buenos_Aires America/Buenos_Aires
+L America/Argentina/Catamarca America/Catamarca
+L America/Argentina/Cordoba America/Cordoba
+L America/Indiana/Indianapolis America/Indianapolis
+L America/Argentina/Jujuy America/Jujuy
+L America/Indiana/Knox America/Knox_IN
+L America/Kentucky/Louisville America/Louisville
+L America/Argentina/Mendoza America/Mendoza
+L America/Puerto_Rico America/Virgin
+L Pacific/Pago_Pago Pacific/Samoa
+L Africa/Abidjan Africa/Accra
+L Africa/Nairobi Africa/Addis_Ababa
+L Africa/Nairobi Africa/Asmara
+L Africa/Abidjan Africa/Bamako
+L Africa/Lagos Africa/Bangui
+L Africa/Abidjan Africa/Banjul
+L Africa/Maputo Africa/Blantyre
+L Africa/Lagos Africa/Brazzaville
+L Africa/Maputo Africa/Bujumbura
+L Africa/Abidjan Africa/Conakry
+L Africa/Abidjan Africa/Dakar
+L Africa/Nairobi Africa/Dar_es_Salaam
+L Africa/Nairobi Africa/Djibouti
+L Africa/Lagos Africa/Douala
+L Africa/Abidjan Africa/Freetown
+L Africa/Maputo Africa/Gaborone
+L Africa/Maputo Africa/Harare
+L Africa/Nairobi Africa/Kampala
+L Africa/Maputo Africa/Kigali
+L Africa/Lagos Africa/Kinshasa
+L Africa/Lagos Africa/Libreville
+L Africa/Abidjan Africa/Lome
+L Africa/Lagos Africa/Luanda
+L Africa/Maputo Africa/Lubumbashi
+L Africa/Maputo Africa/Lusaka
+L Africa/Lagos Africa/Malabo
+L Africa/Johannesburg Africa/Maseru
+L Africa/Johannesburg Africa/Mbabane
+L Africa/Nairobi Africa/Mogadishu
+L Africa/Lagos Africa/Niamey
+L Africa/Abidjan Africa/Nouakchott
+L Africa/Abidjan Africa/Ouagadougou
+L Africa/Lagos Africa/Porto-Novo
+L America/Puerto_Rico America/Anguilla
+L America/Puerto_Rico America/Antigua
+L America/Puerto_Rico America/Aruba
+L America/Panama America/Atikokan
+L America/Puerto_Rico America/Blanc-Sablon
+L America/Panama America/Cayman
+L America/Phoenix America/Creston
+L America/Puerto_Rico America/Curacao
+L America/Puerto_Rico America/Dominica
+L America/Puerto_Rico America/Grenada
+L America/Puerto_Rico America/Guadeloupe
+L America/Puerto_Rico America/Kralendijk
+L America/Puerto_Rico America/Lower_Princes
+L America/Puerto_Rico America/Marigot
+L America/Puerto_Rico America/Montserrat
+L America/Toronto America/Nassau
+L America/Puerto_Rico America/Port_of_Spain
+L America/Puerto_Rico America/St_Barthelemy
+L America/Puerto_Rico America/St_Kitts
+L America/Puerto_Rico America/St_Lucia
+L America/Puerto_Rico America/St_Thomas
+L America/Puerto_Rico America/St_Vincent
+L America/Puerto_Rico America/Tortola
+L Pacific/Port_Moresby Antarctica/DumontDUrville
+L Pacific/Auckland Antarctica/McMurdo
+L Asia/Riyadh Antarctica/Syowa
+L Asia/Urumqi Antarctica/Vostok
+L Europe/Berlin Arctic/Longyearbyen
+L Asia/Riyadh Asia/Aden
+L Asia/Qatar Asia/Bahrain
+L Asia/Kuching Asia/Brunei
+L Asia/Singapore Asia/Kuala_Lumpur
+L Asia/Riyadh Asia/Kuwait
+L Asia/Dubai Asia/Muscat
+L Asia/Bangkok Asia/Phnom_Penh
+L Asia/Bangkok Asia/Vientiane
+L Africa/Abidjan Atlantic/Reykjavik
+L Africa/Abidjan Atlantic/St_Helena
+L Europe/Brussels Europe/Amsterdam
+L Europe/Prague Europe/Bratislava
+L Europe/Zurich Europe/Busingen
+L Europe/Berlin Europe/Copenhagen
+L Europe/London Europe/Guernsey
+L Europe/London Europe/Isle_of_Man
+L Europe/London Europe/Jersey
+L Europe/Belgrade Europe/Ljubljana
+L Europe/Brussels Europe/Luxembourg
+L Europe/Helsinki Europe/Mariehamn
+L Europe/Paris Europe/Monaco
+L Europe/Berlin Europe/Oslo
+L Europe/Belgrade Europe/Podgorica
+L Europe/Rome Europe/San_Marino
+L Europe/Belgrade Europe/Sarajevo
+L Europe/Belgrade Europe/Skopje
+L Europe/Berlin Europe/Stockholm
+L Europe/Zurich Europe/Vaduz
+L Europe/Rome Europe/Vatican
+L Europe/Belgrade Europe/Zagreb
+L Africa/Nairobi Indian/Antananarivo
+L Asia/Bangkok Indian/Christmas
+L Asia/Yangon Indian/Cocos
+L Africa/Nairobi Indian/Comoro
+L Indian/Maldives Indian/Kerguelen
+L Asia/Dubai Indian/Mahe
+L Africa/Nairobi Indian/Mayotte
+L Asia/Dubai Indian/Reunion
+L Pacific/Port_Moresby Pacific/Chuuk
+L Pacific/Tarawa Pacific/Funafuti
+L Pacific/Tarawa Pacific/Majuro
+L Pacific/Pago_Pago Pacific/Midway
+L Pacific/Guadalcanal Pacific/Pohnpei
+L Pacific/Guam Pacific/Saipan
+L Pacific/Tarawa Pacific/Wake
+L Pacific/Tarawa Pacific/Wallis
+L Africa/Abidjan Africa/Timbuktu
+L America/Argentina/Catamarca America/Argentina/ComodRivadavia
+L America/Adak America/Atka
+L America/Panama America/Coral_Harbour
+L America/Tijuana America/Ensenada
+L America/Indiana/Indianapolis America/Fort_Wayne
+L America/Toronto America/Montreal
+L America/Toronto America/Nipigon
+L America/Rio_Branco America/Porto_Acre
+L America/Winnipeg America/Rainy_River
+L America/Argentina/Cordoba America/Rosario
+L America/Tijuana America/Santa_Isabel
+L America/Denver America/Shiprock
+L America/Toronto America/Thunder_Bay
+L Pacific/Auckland Antarctica/South_Pole
+L Asia/Shanghai Asia/Chongqing
+L Asia/Shanghai Asia/Harbin
+L Asia/Urumqi Asia/Kashgar
+L Asia/Jerusalem Asia/Tel_Aviv
+L Europe/Berlin Atlantic/Jan_Mayen
+L Australia/Sydney Australia/Canberra
+L Australia/Hobart Australia/Currie
+L Europe/London Europe/Belfast
+L Europe/Chisinau Europe/Tiraspol
+L Europe/Kyiv Europe/Uzhgorod
+L Europe/Kyiv Europe/Zaporozhye
+L Pacific/Kanton Pacific/Enderbury
+L Pacific/Honolulu Pacific/Johnston
+L Pacific/Port_Moresby Pacific/Yap
+L Africa/Nairobi Africa/Asmera
+L America/Nuuk America/Godthab
+L Asia/Ashgabat Asia/Ashkhabad
+L Asia/Kolkata Asia/Calcutta
+L Asia/Shanghai Asia/Chungking
+L Asia/Dhaka Asia/Dacca
+L Europe/Istanbul Asia/Istanbul
+L Asia/Kathmandu Asia/Katmandu
+L Asia/Macau Asia/Macao
+L Asia/Yangon Asia/Rangoon
+L Asia/Ho_Chi_Minh Asia/Saigon
+L Asia/Thimphu Asia/Thimbu
+L Asia/Makassar Asia/Ujung_Pandang
+L Asia/Ulaanbaatar Asia/Ulan_Bator
+L Atlantic/Faroe Atlantic/Faeroe
+L Europe/Kyiv Europe/Kiev
+L Asia/Nicosia Europe/Nicosia
+L Pacific/Guadalcanal Pacific/Ponape
+L Pacific/Port_Moresby Pacific/Truk
diff --git a/lib/tzdata/zoneinfo/zone.tab b/lib/tzdata/zoneinfo/zone.tab
index 086458fb..2636e21a 100644
--- a/lib/tzdata/zoneinfo/zone.tab
+++ b/lib/tzdata/zoneinfo/zone.tab
@@ -114,13 +114,10 @@ CA	+4606-06447	America/Moncton	Atlantic - New Brunswick
 CA	+5320-06025	America/Goose_Bay	Atlantic - Labrador (most areas)
 CA	+5125-05707	America/Blanc-Sablon	AST - QC (Lower North Shore)
 CA	+4339-07923	America/Toronto	Eastern - ON, QC (most areas)
-CA	+4901-08816	America/Nipigon	Eastern - ON, QC (no DST 1967-73)
-CA	+4823-08915	America/Thunder_Bay	Eastern - ON (Thunder Bay)
 CA	+6344-06828	America/Iqaluit	Eastern - NU (most east areas)
 CA	+6608-06544	America/Pangnirtung	Eastern - NU (Pangnirtung)
 CA	+484531-0913718	America/Atikokan	EST - ON (Atikokan); NU (Coral H)
 CA	+4953-09709	America/Winnipeg	Central - ON (west); Manitoba
-CA	+4843-09434	America/Rainy_River	Central - ON (Rainy R, Ft Frances)
 CA	+744144-0944945	America/Resolute	Central - NU (Resolute)
 CA	+624900-0920459	America/Rankin_Inlet	Central - NU (central)
 CA	+5024-10439	America/Regina	CST - SK (most areas)
@@ -130,7 +127,7 @@ CA	+690650-1050310	America/Cambridge_Bay	Mountain - NU (west)
 CA	+6227-11421	America/Yellowknife	Mountain - NT (central)
 CA	+682059-1334300	America/Inuvik	Mountain - NT (west)
 CA	+4906-11631	America/Creston	MST - BC (Creston)
-CA	+5946-12014	America/Dawson_Creek	MST - BC (Dawson Cr, Ft St John)
+CA	+5546-12014	America/Dawson_Creek	MST - BC (Dawson Cr, Ft St John)
 CA	+5848-12242	America/Fort_Nelson	MST - BC (Ft Nelson)
 CA	+6043-13503	America/Whitehorse	MST - Yukon (east)
 CA	+6404-13925	America/Dawson	MST - Yukon (west)
@@ -400,9 +397,7 @@ TT	+1039-06131	America/Port_of_Spain
 TV	-0831+17913	Pacific/Funafuti
 TW	+2503+12130	Asia/Taipei
 TZ	-0648+03917	Africa/Dar_es_Salaam
-UA	+5026+03031	Europe/Kiev	Ukraine (most areas)
-UA	+4837+02218	Europe/Uzhgorod	Transcarpathia
-UA	+4750+03510	Europe/Zaporozhye	Zaporozhye and east Lugansk
+UA	+5026+03031	Europe/Kyiv	Ukraine (most areas)
 UG	+0019+03225	Africa/Kampala
 UM	+2813-17722	Pacific/Midway	Midway Islands
 UM	+1917+16637	Pacific/Wake	Wake Island
diff --git a/lib/tzdata/zoneinfo/zone1970.tab b/lib/tzdata/zoneinfo/zone1970.tab
index c614be81..75372e3f 100644
--- a/lib/tzdata/zoneinfo/zone1970.tab
+++ b/lib/tzdata/zoneinfo/zone1970.tab
@@ -34,7 +34,7 @@
 #country-
 #codes	coordinates	TZ	comments
 AD	+4230+00131	Europe/Andorra
-AE,OM	+2518+05518	Asia/Dubai
+AE,OM,RE,SC,TF	+2518+05518	Asia/Dubai	UAE, Oman, Réunion, Seychelles, Crozet, Scattered Is
 AF	+3431+06912	Asia/Kabul
 AL	+4120+01950	Europe/Tirane
 AM	+4011+04430	Asia/Yerevan
@@ -44,7 +44,6 @@ AQ	-6736+06253	Antarctica/Mawson	Mawson
 AQ	-6448-06406	Antarctica/Palmer	Palmer
 AQ	-6734-06808	Antarctica/Rothera	Rothera
 AQ	-720041+0023206	Antarctica/Troll	Troll
-AQ	-7824+10654	Antarctica/Vostok	Vostok
 AR	-3436-05827	America/Argentina/Buenos_Aires	Buenos Aires (BA, CF)
 AR	-3124-06411	America/Argentina/Cordoba	Argentina (most areas: CB, CC, CN, ER, FM, MN, SE, SF)
 AR	-2447-06525	America/Argentina/Salta	Salta (SA, LP, NQ, RN)
@@ -74,10 +73,9 @@ AU	-3143+12852	Australia/Eucla	Western Australia (Eucla)
 AZ	+4023+04951	Asia/Baku
 BB	+1306-05937	America/Barbados
 BD	+2343+09025	Asia/Dhaka
-BE	+5050+00420	Europe/Brussels
+BE,LU,NL	+5050+00420	Europe/Brussels
 BG	+4241+02319	Europe/Sofia
 BM	+3217-06446	Atlantic/Bermuda
-BN	+0456+11455	Asia/Brunei
 BO	-1630-06809	America/La_Paz
 BR	-0351-03225	America/Noronha	Atlantic islands
 BR	-0127-04829	America/Belem	Pará (east); Amapá
@@ -104,12 +102,9 @@ CA	+4612-05957	America/Glace_Bay	Atlantic - NS (Cape Breton)
 CA	+4606-06447	America/Moncton	Atlantic - New Brunswick
 CA	+5320-06025	America/Goose_Bay	Atlantic - Labrador (most areas)
 CA,BS	+4339-07923	America/Toronto	Eastern - ON, QC (most areas), Bahamas
-CA	+4901-08816	America/Nipigon	Eastern - ON, QC (no DST 1967-73)
-CA	+4823-08915	America/Thunder_Bay	Eastern - ON (Thunder Bay)
 CA	+6344-06828	America/Iqaluit	Eastern - NU (most east areas)
 CA	+6608-06544	America/Pangnirtung	Eastern - NU (Pangnirtung)
 CA	+4953-09709	America/Winnipeg	Central - ON (west); Manitoba
-CA	+4843-09434	America/Rainy_River	Central - ON (Rainy R, Ft Frances)
 CA	+744144-0944945	America/Resolute	Central - NU (Resolute)
 CA	+624900-0920459	America/Rankin_Inlet	Central - NU (central)
 CA	+5024-10439	America/Regina	CST - SK (most areas)
@@ -118,30 +113,27 @@ CA	+5333-11328	America/Edmonton	Mountain - AB; BC (E); SK (W)
 CA	+690650-1050310	America/Cambridge_Bay	Mountain - NU (west)
 CA	+6227-11421	America/Yellowknife	Mountain - NT (central)
 CA	+682059-1334300	America/Inuvik	Mountain - NT (west)
-CA	+5946-12014	America/Dawson_Creek	MST - BC (Dawson Cr, Ft St John)
+CA	+5546-12014	America/Dawson_Creek	MST - BC (Dawson Cr, Ft St John)
 CA	+5848-12242	America/Fort_Nelson	MST - BC (Ft Nelson)
 CA	+6043-13503	America/Whitehorse	MST - Yukon (east)
 CA	+6404-13925	America/Dawson	MST - Yukon (west)
 CA	+4916-12307	America/Vancouver	Pacific - BC (most areas)
-CC	-1210+09655	Indian/Cocos
 CH,DE,LI	+4723+00832	Europe/Zurich	Swiss time
-CI,BF,GH,GM,GN,ML,MR,SH,SL,SN,TG	+0519-00402	Africa/Abidjan
+CI,BF,GH,GM,GN,IS,ML,MR,SH,SL,SN,TG	+0519-00402	Africa/Abidjan
 CK	-2114-15946	Pacific/Rarotonga
 CL	-3327-07040	America/Santiago	Chile (most areas)
 CL	-5309-07055	America/Punta_Arenas	Region of Magallanes
 CL	-2709-10926	Pacific/Easter	Easter Island
 CN	+3114+12128	Asia/Shanghai	Beijing Time
-CN	+4348+08735	Asia/Urumqi	Xinjiang Time
+CN,AQ	+4348+08735	Asia/Urumqi	Xinjiang Time, Vostok
 CO	+0436-07405	America/Bogota
 CR	+0956-08405	America/Costa_Rica
 CU	+2308-08222	America/Havana
 CV	+1455-02331	Atlantic/Cape_Verde
-CX	-1025+10543	Indian/Christmas
 CY	+3510+03322	Asia/Nicosia	Cyprus (most areas)
 CY	+3507+03357	Asia/Famagusta	Northern Cyprus
 CZ,SK	+5005+01426	Europe/Prague
-DE	+5230+01322	Europe/Berlin	Germany (most areas)
-DK	+5540+01235	Europe/Copenhagen
+DE,DK,NO,SE,SJ	+5230+01322	Europe/Berlin	Germany (most areas), Scandinavia
 DO	+1828-06954	America/Santo_Domingo
 DZ	+3647+00303	Africa/Algiers
 EC	-0210-07950	America/Guayaquil	Ecuador (mainland)
@@ -155,11 +147,9 @@ ES	+2806-01524	Atlantic/Canary	Canary Islands
 FI,AX	+6010+02458	Europe/Helsinki
 FJ	-1808+17825	Pacific/Fiji
 FK	-5142-05751	Atlantic/Stanley
-FM	+0725+15147	Pacific/Chuuk	Chuuk/Truk, Yap
-FM	+0658+15813	Pacific/Pohnpei	Pohnpei/Ponape
 FM	+0519+16259	Pacific/Kosrae	Kosrae
 FO	+6201-00646	Atlantic/Faroe
-FR	+4852+00220	Europe/Paris
+FR,MC	+4852+00220	Europe/Paris
 GB,GG,IM,JE	+513030-0000731	Europe/London
 GE	+4143+04449	Asia/Tbilisi
 GF	+0456-05220	America/Cayenne
@@ -188,14 +178,13 @@ IN	+2232+08822	Asia/Kolkata
 IO	-0720+07225	Indian/Chagos
 IQ	+3321+04425	Asia/Baghdad
 IR	+3540+05126	Asia/Tehran
-IS	+6409-02151	Atlantic/Reykjavik
 IT,SM,VA	+4154+01229	Europe/Rome
 JM	+175805-0764736	America/Jamaica
 JO	+3157+03556	Asia/Amman
 JP	+353916+1394441	Asia/Tokyo
 KE,DJ,ER,ET,KM,MG,SO,TZ,UG,YT	-0117+03649	Africa/Nairobi
 KG	+4254+07436	Asia/Bishkek
-KI	+0125+17300	Pacific/Tarawa	Gilbert Islands
+KI,MH,TV,UM,WF	+0125+17300	Pacific/Tarawa	Gilberts, Marshalls, Tuvalu, Wallis & Futuna, Wake
 KI	-0247-17143	Pacific/Kanton	Phoenix Islands
 KI	+0152-15720	Pacific/Kiritimati	Line Islands
 KP	+3901+12545	Asia/Pyongyang
@@ -211,15 +200,12 @@ LB	+3353+03530	Asia/Beirut
 LK	+0656+07951	Asia/Colombo
 LR	+0618-01047	Africa/Monrovia
 LT	+5441+02519	Europe/Vilnius
-LU	+4936+00609	Europe/Luxembourg
 LV	+5657+02406	Europe/Riga
 LY	+3254+01311	Africa/Tripoli
 MA	+3339-00735	Africa/Casablanca
-MC	+4342+00723	Europe/Monaco
 MD	+4700+02850	Europe/Chisinau
-MH	+0709+17112	Pacific/Majuro	Marshall Islands (most areas)
 MH	+0905+16720	Pacific/Kwajalein	Kwajalein
-MM	+1647+09610	Asia/Yangon
+MM,CC	+1647+09610	Asia/Yangon
 MN	+4755+10653	Asia/Ulaanbaatar	Mongolia (most areas)
 MN	+4801+09139	Asia/Hovd	Bayan-Ölgii, Govi-Altai, Hovd, Uvs, Zavkhan
 MN	+4804+11430	Asia/Choibalsan	Dornod, Sükhbaatar
@@ -227,7 +213,7 @@ MO	+221150+1133230	Asia/Macau
 MQ	+1436-06105	America/Martinique
 MT	+3554+01431	Europe/Malta
 MU	-2010+05730	Indian/Mauritius
-MV	+0410+07330	Indian/Maldives
+MV,TF	+0410+07330	Indian/Maldives	Maldives, Kerguelen, St Paul I, Amsterdam I
 MX	+1924-09909	America/Mexico_City	Central Time
 MX	+2105-08646	America/Cancun	Eastern Standard Time - Quintana Roo
 MX	+2058-08937	America/Merida	Central Time - Campeche, Yucatán
@@ -239,16 +225,13 @@ MX	+2934-10425	America/Ojinaga	Mountain Time US - Chihuahua (US border)
 MX	+2904-11058	America/Hermosillo	Mountain Standard Time - Sonora
 MX	+3232-11701	America/Tijuana	Pacific Time US - Baja California
 MX	+2048-10515	America/Bahia_Banderas	Central Time - Bahía de Banderas
-MY	+0310+10142	Asia/Kuala_Lumpur	Malaysia (peninsula)
-MY	+0133+11020	Asia/Kuching	Sabah, Sarawak
+MY,BN	+0133+11020	Asia/Kuching	Sabah, Sarawak, Brunei
 MZ,BI,BW,CD,MW,RW,ZM,ZW	-2558+03235	Africa/Maputo	Central Africa Time
 NA	-2234+01706	Africa/Windhoek
 NC	-2216+16627	Pacific/Noumea
 NF	-2903+16758	Pacific/Norfolk
 NG,AO,BJ,CD,CF,CG,CM,GA,GQ,NE	+0627+00324	Africa/Lagos	West Africa Time
 NI	+1209-08617	America/Managua
-NL	+5222+00454	Europe/Amsterdam
-NO,SJ	+5955+01045	Europe/Oslo
 NP	+2743+08519	Asia/Kathmandu
 NR	-0031+16655	Pacific/Nauru
 NU	-1901-16955	Pacific/Niue
@@ -259,7 +242,7 @@ PE	-1203-07703	America/Lima
 PF	-1732-14934	Pacific/Tahiti	Society Islands
 PF	-0900-13930	Pacific/Marquesas	Marquesas Islands
 PF	-2308-13457	Pacific/Gambier	Gambier Islands
-PG,AQ	-0930+14710	Pacific/Port_Moresby	Papua New Guinea (most areas), Dumont d'Urville
+PG,AQ,FM	-0930+14710	Pacific/Port_Moresby	Papua New Guinea (most areas), Chuuk, Yap, Dumont d'Urville
 PG	-0613+15534	Pacific/Bougainville	Bougainville
 PH	+1435+12100	Asia/Manila
 PK	+2452+06703	Asia/Karachi
@@ -275,7 +258,6 @@ PT	+3744-02540	Atlantic/Azores	Azores
 PW	+0720+13429	Pacific/Palau
 PY	-2516-05740	America/Asuncion
 QA,BH	+2517+05132	Asia/Qatar
-RE,TF	-2052+05528	Indian/Reunion	Réunion, Crozet, Scattered Islands
 RO	+4426+02606	Europe/Bucharest
 RS,BA,HR,ME,MK,SI	+4450+02030	Europe/Belgrade
 RU	+5443+02030	Europe/Kaliningrad	MSK-01 - Kaliningrad
@@ -307,10 +289,8 @@ RU	+6728+15343	Asia/Srednekolymsk	MSK+08 - Sakha (E); North Kuril Is
 RU	+5301+15839	Asia/Kamchatka	MSK+09 - Kamchatka
 RU	+6445+17729	Asia/Anadyr	MSK+09 - Bering Sea
 SA,AQ,KW,YE	+2438+04643	Asia/Riyadh	Arabia, Syowa
-SB	-0932+16012	Pacific/Guadalcanal
-SC	-0440+05528	Indian/Mahe
+SB,FM	-0932+16012	Pacific/Guadalcanal	Solomons, Pohnpei
 SD	+1536+03232	Africa/Khartoum
-SE	+5920+01803	Europe/Stockholm
 SG,MY	+0117+10351	Asia/Singapore	Singapore, peninsular Malaysia
 SR	+0550-05510	America/Paramaribo
 SS	+0451+03137	Africa/Juba
@@ -319,8 +299,7 @@ SV	+1342-08912	America/El_Salvador
 SY	+3330+03618	Asia/Damascus
 TC	+2128-07108	America/Grand_Turk
 TD	+1207+01503	Africa/Ndjamena
-TF	-492110+0701303	Indian/Kerguelen	Kerguelen, St Paul Island, Amsterdam Island
-TH,KH,LA,VN	+1345+10031	Asia/Bangkok	Indochina (most areas)
+TH,CX,KH,LA,VN	+1345+10031	Asia/Bangkok	Indochina (most areas)
 TJ	+3835+06848	Asia/Dushanbe
 TK	-0922-17114	Pacific/Fakaofo
 TL	-0833+12535	Asia/Dili
@@ -328,12 +307,8 @@ TM	+3757+05823	Asia/Ashgabat
 TN	+3648+01011	Africa/Tunis
 TO	-210800-1751200	Pacific/Tongatapu
 TR	+4101+02858	Europe/Istanbul
-TV	-0831+17913	Pacific/Funafuti
 TW	+2503+12130	Asia/Taipei
-UA	+5026+03031	Europe/Kiev	Ukraine (most areas)
-UA	+4837+02218	Europe/Uzhgorod	Transcarpathia
-UA	+4750+03510	Europe/Zaporozhye	Zaporozhye and east Lugansk
-UM	+1917+16637	Pacific/Wake	Wake Island
+UA	+5026+03031	Europe/Kyiv	Ukraine (most areas)
 US	+404251-0740023	America/New_York	Eastern (most areas)
 US	+421953-0830245	America/Detroit	Eastern - MI (most areas)
 US	+381515-0854534	America/Kentucky/Louisville	Eastern - KY (Louisville area)
@@ -369,6 +344,29 @@ UZ	+4120+06918	Asia/Tashkent	Uzbekistan (east)
 VE	+1030-06656	America/Caracas
 VN	+1045+10640	Asia/Ho_Chi_Minh	Vietnam (south)
 VU	-1740+16825	Pacific/Efate
-WF	-1318-17610	Pacific/Wallis
 WS	-1350-17144	Pacific/Apia
 ZA,LS,SZ	-2615+02800	Africa/Johannesburg
+#
+# The next section contains experimental tab-separated comments for
+# use by user agents like tzselect that identify continents and oceans.
+#
+# For example, the comment "#@AQ<tab>Antarctica/" means the country code
+# AQ is in the continent Antarctica regardless of the Zone name,
+# so Pacific/Auckland should be listed under Antarctica as well as
+# under the Pacific because its line's country codes include AQ.
+#
+# If more than one country code is affected each is listed separated
+# by commas, e.g., #@IS,SH<tab>Atlantic/".  If a country code is in
+# more than one continent or ocean, each is listed separated by
+# commas, e.g., the second column of "#@CY,TR<tab>Asia/,Europe/".
+#
+# These experimental comments are present only for country codes where
+# the continent or ocean is not already obvious from the Zone name.
+# For example, there is no such comment for RU since it already
+# corresponds to Zone names starting with both "Europe/" and "Asia/".
+#
+#@AQ	Antarctica/
+#@IS,SH	Atlantic/
+#@CY,TR	Asia/,Europe/
+#@SJ	Arctic/
+#@CC,CX,KM,MG,YT	Indian/
diff --git a/lib/tzdata/zones b/lib/tzdata/zones
index e45aaa80..d8ec444a 100644
--- a/lib/tzdata/zones
+++ b/lib/tzdata/zones
@@ -2,67 +2,26 @@ Africa/Algiers
 Atlantic/Cape_Verde
 Africa/Ndjamena
 Africa/Abidjan
-Africa/Accra
-Africa/Bamako
-Africa/Banjul
-Africa/Conakry
-Africa/Dakar
-Africa/Freetown
-Africa/Lome
-Africa/Nouakchott
-Africa/Ouagadougou
-Atlantic/St_Helena
 Africa/Cairo
 Africa/Bissau
 Africa/Nairobi
-Africa/Addis_Ababa
-Africa/Asmara
-Africa/Dar_es_Salaam
-Africa/Djibouti
-Africa/Kampala
-Africa/Mogadishu
-Indian/Antananarivo
-Indian/Comoro
-Indian/Mayotte
 Africa/Monrovia
 Africa/Tripoli
 Indian/Mauritius
 Africa/Casablanca
 Africa/El_Aaiun
 Africa/Maputo
-Africa/Blantyre
-Africa/Bujumbura
-Africa/Gaborone
-Africa/Harare
-Africa/Kigali
-Africa/Lubumbashi
-Africa/Lusaka
 Africa/Windhoek
 Africa/Lagos
-Africa/Bangui
-Africa/Brazzaville
-Africa/Douala
-Africa/Kinshasa
-Africa/Libreville
-Africa/Luanda
-Africa/Malabo
-Africa/Niamey
-Africa/Porto-Novo
-Indian/Reunion
 Africa/Sao_Tome
-Indian/Mahe
 Africa/Johannesburg
-Africa/Maseru
-Africa/Mbabane
 Africa/Khartoum
 Africa/Juba
 Africa/Tunis
 Antarctica/Casey
 Antarctica/Davis
 Antarctica/Mawson
-Indian/Kerguelen
 Antarctica/Troll
-Antarctica/Vostok
 Antarctica/Rothera
 Asia/Kabul
 Asia/Yerevan
@@ -70,7 +29,6 @@ Asia/Baku
 Asia/Dhaka
 Asia/Thimphu
 Indian/Chagos
-Asia/Brunei
 Asia/Yangon
 Asia/Shanghai
 Asia/Urumqi
@@ -79,7 +37,6 @@ Asia/Taipei
 Asia/Macau
 Asia/Nicosia
 Asia/Famagusta
-Europe/Nicosia
 Asia/Tbilisi
 Asia/Dili
 Asia/Kolkata
@@ -103,7 +60,6 @@ Asia/Bishkek
 Asia/Seoul
 Asia/Pyongyang
 Asia/Beirut
-Asia/Kuala_Lumpur
 Asia/Kuching
 Indian/Maldives
 Asia/Hovd
@@ -115,21 +71,14 @@ Asia/Gaza
 Asia/Hebron
 Asia/Manila
 Asia/Qatar
-Asia/Bahrain
 Asia/Riyadh
-Antarctica/Syowa
-Asia/Aden
-Asia/Kuwait
 Asia/Singapore
 Asia/Colombo
 Asia/Damascus
 Asia/Dushanbe
 Asia/Bangkok
-Asia/Phnom_Penh
-Asia/Vientiane
 Asia/Ashgabat
 Asia/Dubai
-Asia/Muscat
 Asia/Samarkand
 Asia/Tashkent
 Asia/Ho_Chi_Minh
@@ -145,49 +94,34 @@ Australia/Sydney
 Australia/Broken_Hill
 Australia/Lord_Howe
 Antarctica/Macquarie
-Indian/Christmas
-Indian/Cocos
 Pacific/Fiji
 Pacific/Gambier
 Pacific/Marquesas
 Pacific/Tahiti
 Pacific/Guam
-Pacific/Saipan
 Pacific/Tarawa
 Pacific/Kanton
 Pacific/Kiritimati
-Pacific/Majuro
 Pacific/Kwajalein
-Pacific/Chuuk
-Pacific/Pohnpei
 Pacific/Kosrae
 Pacific/Nauru
 Pacific/Noumea
 Pacific/Auckland
 Pacific/Chatham
-Antarctica/McMurdo
 Pacific/Rarotonga
 Pacific/Niue
 Pacific/Norfolk
 Pacific/Palau
 Pacific/Port_Moresby
-Antarctica/DumontDUrville
 Pacific/Bougainville
 Pacific/Pitcairn
 Pacific/Pago_Pago
-Pacific/Midway
 Pacific/Apia
 Pacific/Guadalcanal
 Pacific/Fakaofo
 Pacific/Tongatapu
-Pacific/Funafuti
-Pacific/Wake
 Pacific/Efate
-Pacific/Wallis
 Europe/London
-Europe/Jersey
-Europe/Guernsey
-Europe/Isle_of_Man
 Europe/Dublin
 WET
 CET
@@ -200,7 +134,6 @@ Europe/Minsk
 Europe/Brussels
 Europe/Sofia
 Europe/Prague
-Europe/Copenhagen
 Atlantic/Faroe
 America/Danmarkshavn
 America/Scoresbysund
@@ -208,27 +141,16 @@ America/Nuuk
 America/Thule
 Europe/Tallinn
 Europe/Helsinki
-Europe/Mariehamn
 Europe/Paris
 Europe/Berlin
-Europe/Busingen
 Europe/Gibraltar
 Europe/Athens
 Europe/Budapest
-Atlantic/Reykjavik
 Europe/Rome
-Europe/Vatican
-Europe/San_Marino
 Europe/Riga
-Europe/Vaduz
 Europe/Vilnius
-Europe/Luxembourg
 Europe/Malta
 Europe/Chisinau
-Europe/Monaco
-Europe/Amsterdam
-Europe/Oslo
-Arctic/Longyearbyen
 Europe/Warsaw
 Europe/Lisbon
 Atlantic/Azores
@@ -262,22 +184,12 @@ Asia/Ust-Nera
 Asia/Kamchatka
 Asia/Anadyr
 Europe/Belgrade
-Europe/Ljubljana
-Europe/Podgorica
-Europe/Sarajevo
-Europe/Skopje
-Europe/Zagreb
-Europe/Bratislava
 Europe/Madrid
 Africa/Ceuta
 Atlantic/Canary
-Europe/Stockholm
 Europe/Zurich
 Europe/Istanbul
-Asia/Istanbul
-Europe/Kiev
-Europe/Uzhgorod
-Europe/Zaporozhye
+Europe/Kyiv
 EST
 MST
 HST
@@ -301,7 +213,6 @@ America/Nome
 America/Adak
 Pacific/Honolulu
 America/Phoenix
-America/Creston
 America/Boise
 America/Indiana/Indianapolis
 America/Indiana/Marengo
@@ -321,10 +232,6 @@ America/Halifax
 America/Glace_Bay
 America/Moncton
 America/Toronto
-America/Nassau
-America/Thunder_Bay
-America/Nipigon
-America/Rainy_River
 America/Winnipeg
 America/Regina
 America/Swift_Current
@@ -366,28 +273,7 @@ America/Jamaica
 America/Martinique
 America/Managua
 America/Panama
-America/Atikokan
-America/Cayman
 America/Puerto_Rico
-America/Anguilla
-America/Antigua
-America/Aruba
-America/Curacao
-America/Blanc-Sablon
-America/Dominica
-America/Grenada
-America/Guadeloupe
-America/Kralendijk
-America/Lower_Princes
-America/Marigot
-America/Montserrat
-America/Port_of_Spain
-America/St_Barthelemy
-America/St_Kitts
-America/St_Lucia
-America/St_Thomas
-America/St_Vincent
-America/Tortola
 America/Miquelon
 America/Grand_Turk
 America/Argentina/Buenos_Aires
@@ -435,15 +321,9 @@ Atlantic/South_Georgia
 America/Paramaribo
 America/Montevideo
 America/Caracas
-Etc/GMT
 Etc/UTC
+Etc/GMT
 GMT
-Etc/Universal
-Etc/Zulu
-Etc/Greenwich
-Etc/GMT-0
-Etc/GMT+0
-Etc/GMT0
 Etc/GMT-14
 Etc/GMT-13
 Etc/GMT-12
@@ -471,49 +351,7 @@ Etc/GMT+10
 Etc/GMT+11
 Etc/GMT+12
 Factory
-Africa/Asmera
-Africa/Timbuktu
-America/Argentina/ComodRivadavia
-America/Atka
-America/Buenos_Aires
-America/Catamarca
-America/Coral_Harbour
-America/Cordoba
-America/Ensenada
-America/Fort_Wayne
-America/Godthab
-America/Indianapolis
-America/Jujuy
-America/Knox_IN
-America/Louisville
-America/Mendoza
-America/Montreal
-America/Porto_Acre
-America/Rosario
-America/Santa_Isabel
-America/Shiprock
-America/Virgin
-Antarctica/South_Pole
-Asia/Ashkhabad
-Asia/Calcutta
-Asia/Chongqing
-Asia/Chungking
-Asia/Dacca
-Asia/Harbin
-Asia/Kashgar
-Asia/Katmandu
-Asia/Macao
-Asia/Rangoon
-Asia/Saigon
-Asia/Tel_Aviv
-Asia/Thimbu
-Asia/Ujung_Pandang
-Asia/Ulan_Bator
-Atlantic/Faeroe
-Atlantic/Jan_Mayen
 Australia/ACT
-Australia/Canberra
-Australia/Currie
 Australia/LHI
 Australia/NSW
 Australia/North
@@ -540,9 +378,13 @@ Chile/EasterIsland
 Cuba
 Egypt
 Eire
+Etc/GMT+0
+Etc/GMT-0
+Etc/GMT0
+Etc/Greenwich
 Etc/UCT
-Europe/Belfast
-Europe/Tiraspol
+Etc/Universal
+Etc/Zulu
 GB
 GB-Eire
 GMT+0
@@ -564,12 +406,6 @@ NZ
 NZ-CHAT
 Navajo
 PRC
-Pacific/Enderbury
-Pacific/Johnston
-Pacific/Ponape
-Pacific/Samoa
-Pacific/Truk
-Pacific/Yap
 Poland
 Portugal
 ROC
@@ -593,3 +429,168 @@ UTC
 Universal
 W-SU
 Zulu
+America/Buenos_Aires
+America/Catamarca
+America/Cordoba
+America/Indianapolis
+America/Jujuy
+America/Knox_IN
+America/Louisville
+America/Mendoza
+America/Virgin
+Pacific/Samoa
+Africa/Accra
+Africa/Addis_Ababa
+Africa/Asmara
+Africa/Bamako
+Africa/Bangui
+Africa/Banjul
+Africa/Blantyre
+Africa/Brazzaville
+Africa/Bujumbura
+Africa/Conakry
+Africa/Dakar
+Africa/Dar_es_Salaam
+Africa/Djibouti
+Africa/Douala
+Africa/Freetown
+Africa/Gaborone
+Africa/Harare
+Africa/Kampala
+Africa/Kigali
+Africa/Kinshasa
+Africa/Libreville
+Africa/Lome
+Africa/Luanda
+Africa/Lubumbashi
+Africa/Lusaka
+Africa/Malabo
+Africa/Maseru
+Africa/Mbabane
+Africa/Mogadishu
+Africa/Niamey
+Africa/Nouakchott
+Africa/Ouagadougou
+Africa/Porto-Novo
+America/Anguilla
+America/Antigua
+America/Aruba
+America/Atikokan
+America/Blanc-Sablon
+America/Cayman
+America/Creston
+America/Curacao
+America/Dominica
+America/Grenada
+America/Guadeloupe
+America/Kralendijk
+America/Lower_Princes
+America/Marigot
+America/Montserrat
+America/Nassau
+America/Port_of_Spain
+America/St_Barthelemy
+America/St_Kitts
+America/St_Lucia
+America/St_Thomas
+America/St_Vincent
+America/Tortola
+Antarctica/DumontDUrville
+Antarctica/McMurdo
+Antarctica/Syowa
+Antarctica/Vostok
+Arctic/Longyearbyen
+Asia/Aden
+Asia/Bahrain
+Asia/Brunei
+Asia/Kuala_Lumpur
+Asia/Kuwait
+Asia/Muscat
+Asia/Phnom_Penh
+Asia/Vientiane
+Atlantic/Reykjavik
+Atlantic/St_Helena
+Europe/Amsterdam
+Europe/Bratislava
+Europe/Busingen
+Europe/Copenhagen
+Europe/Guernsey
+Europe/Isle_of_Man
+Europe/Jersey
+Europe/Ljubljana
+Europe/Luxembourg
+Europe/Mariehamn
+Europe/Monaco
+Europe/Oslo
+Europe/Podgorica
+Europe/San_Marino
+Europe/Sarajevo
+Europe/Skopje
+Europe/Stockholm
+Europe/Vaduz
+Europe/Vatican
+Europe/Zagreb
+Indian/Antananarivo
+Indian/Christmas
+Indian/Cocos
+Indian/Comoro
+Indian/Kerguelen
+Indian/Mahe
+Indian/Mayotte
+Indian/Reunion
+Pacific/Chuuk
+Pacific/Funafuti
+Pacific/Majuro
+Pacific/Midway
+Pacific/Pohnpei
+Pacific/Saipan
+Pacific/Wake
+Pacific/Wallis
+Africa/Timbuktu
+America/Argentina/ComodRivadavia
+America/Atka
+America/Coral_Harbour
+America/Ensenada
+America/Fort_Wayne
+America/Montreal
+America/Nipigon
+America/Porto_Acre
+America/Rainy_River
+America/Rosario
+America/Santa_Isabel
+America/Shiprock
+America/Thunder_Bay
+Antarctica/South_Pole
+Asia/Chongqing
+Asia/Harbin
+Asia/Kashgar
+Asia/Tel_Aviv
+Atlantic/Jan_Mayen
+Australia/Canberra
+Australia/Currie
+Europe/Belfast
+Europe/Tiraspol
+Europe/Uzhgorod
+Europe/Zaporozhye
+Pacific/Enderbury
+Pacific/Johnston
+Pacific/Yap
+Africa/Asmera
+America/Godthab
+Asia/Ashkhabad
+Asia/Calcutta
+Asia/Chungking
+Asia/Dacca
+Asia/Istanbul
+Asia/Katmandu
+Asia/Macao
+Asia/Rangoon
+Asia/Saigon
+Asia/Thimbu
+Asia/Ujung_Pandang
+Asia/Ulan_Bator
+Atlantic/Faeroe
+Europe/Kiev
+Europe/Nicosia
+Pacific/Ponape
+Pacific/Truk
diff --git a/requirements.txt b/requirements.txt
index 4ea307df..20c27a1d 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -43,7 +43,7 @@ six==1.16.0
 soupsieve==2.3.2.post1
 tempora==5.0.2
 tokenize-rt==4.2.1
-tzdata==2022.1
+tzdata==2022.6
 tzlocal==4.2
 urllib3==1.26.12
 webencodings==0.5.1

From a5ccc9a1a3d3f4e74b9b90a0a10fcc55027f4026 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 12 Nov 2022 17:26:45 -0800
Subject: [PATCH 220/743] Bump pytz from 2022.1 to 2022.6 (#1880)

* Bump pytz from 2022.1 to 2022.6

Bumps [pytz](https://github.com/stub42/pytz) from 2022.1 to 2022.6.
- [Release notes](https://github.com/stub42/pytz/releases)
- [Commits](https://github.com/stub42/pytz/compare/release_2022.1...release_2022.6)

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

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

* Update pytz==2022.6

Signed-off-by: dependabot[bot] <support@github.com>
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/pytz/__init__.py                          |  14 +-
 lib/pytz/zoneinfo/Africa/Ceuta                | Bin 2036 -> 2052 bytes
 lib/pytz/zoneinfo/America/Araguaina           | Bin 884 -> 870 bytes
 .../zoneinfo/America/Argentina/Buenos_Aires   | Bin 1076 -> 1062 bytes
 lib/pytz/zoneinfo/America/Argentina/Catamarca | Bin 1076 -> 1062 bytes
 .../zoneinfo/America/Argentina/ComodRivadavia | Bin 1076 -> 1062 bytes
 lib/pytz/zoneinfo/America/Argentina/Cordoba   | Bin 1076 -> 1062 bytes
 lib/pytz/zoneinfo/America/Argentina/Jujuy     | Bin 1048 -> 1034 bytes
 lib/pytz/zoneinfo/America/Argentina/La_Rioja  | Bin 1090 -> 1076 bytes
 lib/pytz/zoneinfo/America/Argentina/Mendoza   | Bin 1076 -> 1062 bytes
 .../zoneinfo/America/Argentina/Rio_Gallegos   | Bin 1076 -> 1062 bytes
 lib/pytz/zoneinfo/America/Argentina/Salta     | Bin 1048 -> 1034 bytes
 lib/pytz/zoneinfo/America/Argentina/San_Juan  | Bin 1090 -> 1076 bytes
 lib/pytz/zoneinfo/America/Argentina/San_Luis  | Bin 1102 -> 1088 bytes
 lib/pytz/zoneinfo/America/Argentina/Tucuman   | Bin 1104 -> 1090 bytes
 lib/pytz/zoneinfo/America/Argentina/Ushuaia   | Bin 1076 -> 1062 bytes
 lib/pytz/zoneinfo/America/Asuncion            | Bin 2044 -> 2030 bytes
 lib/pytz/zoneinfo/America/Bahia               | Bin 1024 -> 1010 bytes
 lib/pytz/zoneinfo/America/Bahia_Banderas      | Bin 1546 -> 1152 bytes
 lib/pytz/zoneinfo/America/Belem               | Bin 576 -> 562 bytes
 lib/pytz/zoneinfo/America/Boa_Vista           | Bin 632 -> 618 bytes
 lib/pytz/zoneinfo/America/Bogota              | Bin 246 -> 232 bytes
 lib/pytz/zoneinfo/America/Boise               | Bin 2394 -> 2410 bytes
 lib/pytz/zoneinfo/America/Buenos_Aires        | Bin 1076 -> 1062 bytes
 lib/pytz/zoneinfo/America/Campo_Grande        | Bin 1444 -> 1430 bytes
 lib/pytz/zoneinfo/America/Cancun              | Bin 782 -> 834 bytes
 lib/pytz/zoneinfo/America/Caracas             | Bin 264 -> 250 bytes
 lib/pytz/zoneinfo/America/Catamarca           | Bin 1076 -> 1062 bytes
 lib/pytz/zoneinfo/America/Cayenne             | Bin 198 -> 184 bytes
 lib/pytz/zoneinfo/America/Chicago             | Bin 3576 -> 3592 bytes
 lib/pytz/zoneinfo/America/Chihuahua           | Bin 1484 -> 1102 bytes
 lib/pytz/zoneinfo/America/Cordoba             | Bin 1076 -> 1062 bytes
 lib/pytz/zoneinfo/America/Creston             | Bin 328 -> 360 bytes
 lib/pytz/zoneinfo/America/Cuiaba              | Bin 1416 -> 1402 bytes
 lib/pytz/zoneinfo/America/Denver              | Bin 2444 -> 2460 bytes
 lib/pytz/zoneinfo/America/Eirunepe            | Bin 656 -> 642 bytes
 lib/pytz/zoneinfo/America/Ensenada            | Bin 2342 -> 2374 bytes
 lib/pytz/zoneinfo/America/Fort_Wayne          | Bin 1666 -> 1682 bytes
 lib/pytz/zoneinfo/America/Fortaleza           | Bin 716 -> 702 bytes
 lib/pytz/zoneinfo/America/Godthab             | Bin 1878 -> 1864 bytes
 lib/pytz/zoneinfo/America/Guayaquil           | Bin 246 -> 232 bytes
 lib/pytz/zoneinfo/America/Guyana              | Bin 262 -> 248 bytes
 lib/pytz/zoneinfo/America/Hermosillo          | Bin 416 -> 456 bytes
 .../zoneinfo/America/Indiana/Indianapolis     | Bin 1666 -> 1682 bytes
 lib/pytz/zoneinfo/America/Indiana/Knox        | Bin 2428 -> 2444 bytes
 lib/pytz/zoneinfo/America/Indiana/Marengo     | Bin 1722 -> 1738 bytes
 lib/pytz/zoneinfo/America/Indiana/Petersburg  | Bin 1904 -> 1920 bytes
 lib/pytz/zoneinfo/America/Indiana/Tell_City   | Bin 1684 -> 1700 bytes
 lib/pytz/zoneinfo/America/Indiana/Vevay       | Bin 1414 -> 1430 bytes
 lib/pytz/zoneinfo/America/Indiana/Vincennes   | Bin 1694 -> 1710 bytes
 lib/pytz/zoneinfo/America/Indiana/Winamac     | Bin 1778 -> 1794 bytes
 lib/pytz/zoneinfo/America/Indianapolis        | Bin 1666 -> 1682 bytes
 lib/pytz/zoneinfo/America/Jujuy               | Bin 1048 -> 1034 bytes
 lib/pytz/zoneinfo/America/Kentucky/Louisville | Bin 2772 -> 2788 bytes
 lib/pytz/zoneinfo/America/Kentucky/Monticello | Bin 2352 -> 2368 bytes
 lib/pytz/zoneinfo/America/Knox_IN             | Bin 2428 -> 2444 bytes
 lib/pytz/zoneinfo/America/La_Paz              | Bin 232 -> 218 bytes
 lib/pytz/zoneinfo/America/Lima                | Bin 406 -> 392 bytes
 lib/pytz/zoneinfo/America/Los_Angeles         | Bin 2836 -> 2852 bytes
 lib/pytz/zoneinfo/America/Louisville          | Bin 2772 -> 2788 bytes
 lib/pytz/zoneinfo/America/Maceio              | Bin 744 -> 730 bytes
 lib/pytz/zoneinfo/America/Manaus              | Bin 604 -> 590 bytes
 lib/pytz/zoneinfo/America/Matamoros           | Bin 1390 -> 1418 bytes
 lib/pytz/zoneinfo/America/Mazatlan            | Bin 1526 -> 1128 bytes
 lib/pytz/zoneinfo/America/Mendoza             | Bin 1076 -> 1062 bytes
 lib/pytz/zoneinfo/America/Merida              | Bin 1422 -> 1004 bytes
 lib/pytz/zoneinfo/America/Mexico_City         | Bin 1584 -> 1222 bytes
 lib/pytz/zoneinfo/America/Miquelon            | Bin 1666 -> 1652 bytes
 lib/pytz/zoneinfo/America/Monterrey           | Bin 1390 -> 980 bytes
 lib/pytz/zoneinfo/America/Montevideo          | Bin 1510 -> 1496 bytes
 lib/pytz/zoneinfo/America/New_York            | Bin 3536 -> 3552 bytes
 lib/pytz/zoneinfo/America/Nipigon             | Bin 2122 -> 3494 bytes
 lib/pytz/zoneinfo/America/Noronha             | Bin 716 -> 702 bytes
 lib/pytz/zoneinfo/America/North_Dakota/Beulah | Bin 2380 -> 2396 bytes
 lib/pytz/zoneinfo/America/North_Dakota/Center | Bin 2380 -> 2396 bytes
 .../zoneinfo/America/North_Dakota/New_Salem   | Bin 2380 -> 2396 bytes
 lib/pytz/zoneinfo/America/Nuuk                | Bin 1878 -> 1864 bytes
 lib/pytz/zoneinfo/America/Ojinaga             | Bin 1484 -> 1102 bytes
 lib/pytz/zoneinfo/America/Paramaribo          | Bin 262 -> 248 bytes
 lib/pytz/zoneinfo/America/Phoenix             | Bin 328 -> 360 bytes
 lib/pytz/zoneinfo/America/Porto_Acre          | Bin 628 -> 614 bytes
 lib/pytz/zoneinfo/America/Porto_Velho         | Bin 576 -> 562 bytes
 lib/pytz/zoneinfo/America/Punta_Arenas        | Bin 1902 -> 1902 bytes
 lib/pytz/zoneinfo/America/Rainy_River         | Bin 2122 -> 2868 bytes
 lib/pytz/zoneinfo/America/Recife              | Bin 716 -> 702 bytes
 lib/pytz/zoneinfo/America/Rio_Branco          | Bin 628 -> 614 bytes
 lib/pytz/zoneinfo/America/Rosario             | Bin 1076 -> 1062 bytes
 lib/pytz/zoneinfo/America/Santa_Isabel        | Bin 2342 -> 2374 bytes
 lib/pytz/zoneinfo/America/Santarem            | Bin 602 -> 588 bytes
 lib/pytz/zoneinfo/America/Santiago            | Bin 2529 -> 2515 bytes
 lib/pytz/zoneinfo/America/Sao_Paulo           | Bin 1444 -> 1430 bytes
 lib/pytz/zoneinfo/America/Scoresbysund        | Bin 1916 -> 1902 bytes
 lib/pytz/zoneinfo/America/Shiprock            | Bin 2444 -> 2460 bytes
 lib/pytz/zoneinfo/America/Thunder_Bay         | Bin 2202 -> 3494 bytes
 lib/pytz/zoneinfo/America/Tijuana             | Bin 2342 -> 2374 bytes
 lib/pytz/zoneinfo/Antarctica/Casey            | Bin 384 -> 370 bytes
 lib/pytz/zoneinfo/Antarctica/Davis            | Bin 297 -> 283 bytes
 lib/pytz/zoneinfo/Antarctica/DumontDUrville   | Bin 186 -> 172 bytes
 lib/pytz/zoneinfo/Antarctica/Mawson           | Bin 199 -> 185 bytes
 lib/pytz/zoneinfo/Antarctica/Palmer           | Bin 1418 -> 1404 bytes
 lib/pytz/zoneinfo/Antarctica/Rothera          | Bin 164 -> 150 bytes
 lib/pytz/zoneinfo/Antarctica/Syowa            | Bin 165 -> 151 bytes
 lib/pytz/zoneinfo/Antarctica/Troll            | Bin 1162 -> 1148 bytes
 lib/pytz/zoneinfo/Antarctica/Vostok           | Bin 165 -> 151 bytes
 lib/pytz/zoneinfo/Arctic/Longyearbyen         | Bin 2228 -> 2298 bytes
 lib/pytz/zoneinfo/Asia/Aden                   | Bin 165 -> 151 bytes
 lib/pytz/zoneinfo/Asia/Almaty                 | Bin 997 -> 983 bytes
 lib/pytz/zoneinfo/Asia/Amman                  | Bin 1853 -> 1433 bytes
 lib/pytz/zoneinfo/Asia/Anadyr                 | Bin 1188 -> 1174 bytes
 lib/pytz/zoneinfo/Asia/Aqtau                  | Bin 983 -> 969 bytes
 lib/pytz/zoneinfo/Asia/Aqtobe                 | Bin 1011 -> 997 bytes
 lib/pytz/zoneinfo/Asia/Ashgabat               | Bin 619 -> 605 bytes
 lib/pytz/zoneinfo/Asia/Ashkhabad              | Bin 619 -> 605 bytes
 lib/pytz/zoneinfo/Asia/Atyrau                 | Bin 991 -> 977 bytes
 lib/pytz/zoneinfo/Asia/Baghdad                | Bin 983 -> 969 bytes
 lib/pytz/zoneinfo/Asia/Bahrain                | Bin 199 -> 185 bytes
 lib/pytz/zoneinfo/Asia/Baku                   | Bin 1227 -> 1213 bytes
 lib/pytz/zoneinfo/Asia/Bangkok                | Bin 199 -> 185 bytes
 lib/pytz/zoneinfo/Asia/Barnaul                | Bin 1221 -> 1207 bytes
 lib/pytz/zoneinfo/Asia/Bishkek                | Bin 983 -> 969 bytes
 lib/pytz/zoneinfo/Asia/Brunei                 | Bin 203 -> 469 bytes
 lib/pytz/zoneinfo/Asia/Chita                  | Bin 1221 -> 1207 bytes
 lib/pytz/zoneinfo/Asia/Choibalsan             | Bin 949 -> 935 bytes
 lib/pytz/zoneinfo/Asia/Colombo                | Bin 372 -> 358 bytes
 lib/pytz/zoneinfo/Asia/Dacca                  | Bin 337 -> 323 bytes
 lib/pytz/zoneinfo/Asia/Damascus               | Bin 2294 -> 1873 bytes
 lib/pytz/zoneinfo/Asia/Dhaka                  | Bin 337 -> 323 bytes
 lib/pytz/zoneinfo/Asia/Dili                   | Bin 227 -> 213 bytes
 lib/pytz/zoneinfo/Asia/Dubai                  | Bin 165 -> 151 bytes
 lib/pytz/zoneinfo/Asia/Dushanbe               | Bin 591 -> 577 bytes
 lib/pytz/zoneinfo/Asia/Gaza                   | Bin 2422 -> 2422 bytes
 lib/pytz/zoneinfo/Asia/Hebron                 | Bin 2450 -> 2450 bytes
 lib/pytz/zoneinfo/Asia/Ho_Chi_Minh            | Bin 351 -> 337 bytes
 lib/pytz/zoneinfo/Asia/Hong_Kong              | Bin 1203 -> 1233 bytes
 lib/pytz/zoneinfo/Asia/Hovd                   | Bin 891 -> 877 bytes
 lib/pytz/zoneinfo/Asia/Irkutsk                | Bin 1243 -> 1229 bytes
 lib/pytz/zoneinfo/Asia/Istanbul               | Bin 1947 -> 1933 bytes
 lib/pytz/zoneinfo/Asia/Jakarta                | Bin 355 -> 383 bytes
 lib/pytz/zoneinfo/Asia/Kabul                  | Bin 208 -> 194 bytes
 lib/pytz/zoneinfo/Asia/Kamchatka              | Bin 1166 -> 1152 bytes
 lib/pytz/zoneinfo/Asia/Kashgar                | Bin 165 -> 151 bytes
 lib/pytz/zoneinfo/Asia/Kathmandu              | Bin 212 -> 198 bytes
 lib/pytz/zoneinfo/Asia/Katmandu               | Bin 212 -> 198 bytes
 lib/pytz/zoneinfo/Asia/Khandyga               | Bin 1271 -> 1257 bytes
 lib/pytz/zoneinfo/Asia/Krasnoyarsk            | Bin 1207 -> 1193 bytes
 lib/pytz/zoneinfo/Asia/Kuala_Lumpur           | Bin 383 -> 369 bytes
 lib/pytz/zoneinfo/Asia/Kuching                | Bin 483 -> 469 bytes
 lib/pytz/zoneinfo/Asia/Kuwait                 | Bin 165 -> 151 bytes
 lib/pytz/zoneinfo/Asia/Magadan                | Bin 1222 -> 1208 bytes
 lib/pytz/zoneinfo/Asia/Muscat                 | Bin 165 -> 151 bytes
 lib/pytz/zoneinfo/Asia/Novokuznetsk           | Bin 1165 -> 1151 bytes
 lib/pytz/zoneinfo/Asia/Novosibirsk            | Bin 1221 -> 1207 bytes
 lib/pytz/zoneinfo/Asia/Omsk                   | Bin 1207 -> 1193 bytes
 lib/pytz/zoneinfo/Asia/Oral                   | Bin 1005 -> 991 bytes
 lib/pytz/zoneinfo/Asia/Phnom_Penh             | Bin 199 -> 185 bytes
 lib/pytz/zoneinfo/Asia/Qatar                  | Bin 199 -> 185 bytes
 lib/pytz/zoneinfo/Asia/Qostanay               | Bin 1011 -> 997 bytes
 lib/pytz/zoneinfo/Asia/Qyzylorda              | Bin 1025 -> 1011 bytes
 lib/pytz/zoneinfo/Asia/Rangoon                | Bin 268 -> 254 bytes
 lib/pytz/zoneinfo/Asia/Riyadh                 | Bin 165 -> 151 bytes
 lib/pytz/zoneinfo/Asia/Saigon                 | Bin 351 -> 337 bytes
 lib/pytz/zoneinfo/Asia/Sakhalin               | Bin 1202 -> 1188 bytes
 lib/pytz/zoneinfo/Asia/Samarkand              | Bin 577 -> 563 bytes
 lib/pytz/zoneinfo/Asia/Singapore              | Bin 383 -> 369 bytes
 lib/pytz/zoneinfo/Asia/Srednekolymsk          | Bin 1208 -> 1194 bytes
 lib/pytz/zoneinfo/Asia/Tashkent               | Bin 591 -> 577 bytes
 lib/pytz/zoneinfo/Asia/Tbilisi                | Bin 1035 -> 1021 bytes
 lib/pytz/zoneinfo/Asia/Tehran                 | Bin 2582 -> 1248 bytes
 lib/pytz/zoneinfo/Asia/Thimbu                 | Bin 203 -> 189 bytes
 lib/pytz/zoneinfo/Asia/Thimphu                | Bin 203 -> 189 bytes
 lib/pytz/zoneinfo/Asia/Tomsk                  | Bin 1221 -> 1207 bytes
 lib/pytz/zoneinfo/Asia/Ulaanbaatar            | Bin 891 -> 877 bytes
 lib/pytz/zoneinfo/Asia/Ulan_Bator             | Bin 891 -> 877 bytes
 lib/pytz/zoneinfo/Asia/Urumqi                 | Bin 165 -> 151 bytes
 lib/pytz/zoneinfo/Asia/Ust-Nera               | Bin 1252 -> 1238 bytes
 lib/pytz/zoneinfo/Asia/Vientiane              | Bin 199 -> 185 bytes
 lib/pytz/zoneinfo/Asia/Vladivostok            | Bin 1208 -> 1194 bytes
 lib/pytz/zoneinfo/Asia/Yakutsk                | Bin 1207 -> 1193 bytes
 lib/pytz/zoneinfo/Asia/Yangon                 | Bin 268 -> 254 bytes
 lib/pytz/zoneinfo/Asia/Yekaterinburg          | Bin 1243 -> 1229 bytes
 lib/pytz/zoneinfo/Asia/Yerevan                | Bin 1151 -> 1137 bytes
 lib/pytz/zoneinfo/Atlantic/Azores             | Bin 3512 -> 3498 bytes
 lib/pytz/zoneinfo/Atlantic/Cape_Verde         | Bin 270 -> 256 bytes
 lib/pytz/zoneinfo/Atlantic/Jan_Mayen          | Bin 2228 -> 2298 bytes
 lib/pytz/zoneinfo/Atlantic/Reykjavik          | Bin 1162 -> 148 bytes
 lib/pytz/zoneinfo/Atlantic/South_Georgia      | Bin 164 -> 150 bytes
 lib/pytz/zoneinfo/Atlantic/Stanley            | Bin 1214 -> 1200 bytes
 lib/pytz/zoneinfo/Australia/Eucla             | Bin 470 -> 456 bytes
 lib/pytz/zoneinfo/Australia/LHI               | Bin 1860 -> 1846 bytes
 lib/pytz/zoneinfo/Australia/Lord_Howe         | Bin 1860 -> 1846 bytes
 lib/pytz/zoneinfo/Brazil/Acre                 | Bin 628 -> 614 bytes
 lib/pytz/zoneinfo/Brazil/DeNoronha            | Bin 716 -> 702 bytes
 lib/pytz/zoneinfo/Brazil/East                 | Bin 1444 -> 1430 bytes
 lib/pytz/zoneinfo/Brazil/West                 | Bin 604 -> 590 bytes
 lib/pytz/zoneinfo/Chile/Continental           | Bin 2529 -> 2515 bytes
 lib/pytz/zoneinfo/Chile/EasterIsland          | Bin 2233 -> 2219 bytes
 lib/pytz/zoneinfo/Eire                        | Bin 3492 -> 3492 bytes
 lib/pytz/zoneinfo/Europe/Amsterdam            | Bin 2910 -> 2933 bytes
 lib/pytz/zoneinfo/Europe/Astrakhan            | Bin 1165 -> 1151 bytes
 lib/pytz/zoneinfo/Europe/Belfast              | Bin 3648 -> 3664 bytes
 lib/pytz/zoneinfo/Europe/Copenhagen           | Bin 2137 -> 2298 bytes
 lib/pytz/zoneinfo/Europe/Dublin               | Bin 3492 -> 3492 bytes
 lib/pytz/zoneinfo/Europe/Gibraltar            | Bin 3052 -> 3068 bytes
 lib/pytz/zoneinfo/Europe/Guernsey             | Bin 3648 -> 3664 bytes
 lib/pytz/zoneinfo/Europe/Isle_of_Man          | Bin 3648 -> 3664 bytes
 lib/pytz/zoneinfo/Europe/Istanbul             | Bin 1947 -> 1933 bytes
 lib/pytz/zoneinfo/Europe/Jersey               | Bin 3648 -> 3664 bytes
 lib/pytz/zoneinfo/Europe/Kirov                | Bin 1153 -> 1139 bytes
 lib/pytz/zoneinfo/Europe/Kyiv                 | Bin 0 -> 2120 bytes
 lib/pytz/zoneinfo/Europe/London               | Bin 3648 -> 3664 bytes
 lib/pytz/zoneinfo/Europe/Luxembourg           | Bin 2946 -> 2933 bytes
 lib/pytz/zoneinfo/Europe/Madrid               | Bin 2614 -> 2614 bytes
 lib/pytz/zoneinfo/Europe/Malta                | Bin 2620 -> 2620 bytes
 lib/pytz/zoneinfo/Europe/Minsk                | Bin 1321 -> 1307 bytes
 lib/pytz/zoneinfo/Europe/Monaco               | Bin 2944 -> 2962 bytes
 lib/pytz/zoneinfo/Europe/Oslo                 | Bin 2228 -> 2298 bytes
 lib/pytz/zoneinfo/Europe/Rome                 | Bin 2641 -> 2641 bytes
 lib/pytz/zoneinfo/Europe/Samara               | Bin 1215 -> 1201 bytes
 lib/pytz/zoneinfo/Europe/San_Marino           | Bin 2641 -> 2641 bytes
 lib/pytz/zoneinfo/Europe/Saratov              | Bin 1183 -> 1169 bytes
 lib/pytz/zoneinfo/Europe/Simferopol           | Bin 1469 -> 1469 bytes
 lib/pytz/zoneinfo/Europe/Stockholm            | Bin 1909 -> 2298 bytes
 lib/pytz/zoneinfo/Europe/Ulyanovsk            | Bin 1267 -> 1253 bytes
 lib/pytz/zoneinfo/Europe/Uzhgorod             | Bin 2066 -> 2120 bytes
 lib/pytz/zoneinfo/Europe/Vatican              | Bin 2641 -> 2641 bytes
 lib/pytz/zoneinfo/Europe/Volgograd            | Bin 1165 -> 1151 bytes
 lib/pytz/zoneinfo/Europe/Zaporozhye           | Bin 2138 -> 2120 bytes
 lib/pytz/zoneinfo/GB                          | Bin 3648 -> 3664 bytes
 lib/pytz/zoneinfo/GB-Eire                     | Bin 3648 -> 3664 bytes
 lib/pytz/zoneinfo/Hongkong                    | Bin 1203 -> 1233 bytes
 lib/pytz/zoneinfo/Iceland                     | Bin 1162 -> 148 bytes
 lib/pytz/zoneinfo/Indian/Chagos               | Bin 199 -> 185 bytes
 lib/pytz/zoneinfo/Indian/Christmas            | Bin 165 -> 185 bytes
 lib/pytz/zoneinfo/Indian/Cocos                | Bin 174 -> 254 bytes
 lib/pytz/zoneinfo/Indian/Kerguelen            | Bin 165 -> 185 bytes
 lib/pytz/zoneinfo/Indian/Mahe                 | Bin 165 -> 151 bytes
 lib/pytz/zoneinfo/Indian/Maldives             | Bin 199 -> 185 bytes
 lib/pytz/zoneinfo/Indian/Mauritius            | Bin 241 -> 227 bytes
 lib/pytz/zoneinfo/Indian/Reunion              | Bin 165 -> 151 bytes
 lib/pytz/zoneinfo/Iran                        | Bin 2582 -> 1248 bytes
 lib/pytz/zoneinfo/Kwajalein                   | Bin 316 -> 302 bytes
 lib/pytz/zoneinfo/Mexico/BajaNorte            | Bin 2342 -> 2374 bytes
 lib/pytz/zoneinfo/Mexico/BajaSur              | Bin 1526 -> 1128 bytes
 lib/pytz/zoneinfo/Mexico/General              | Bin 1584 -> 1222 bytes
 lib/pytz/zoneinfo/NZ-CHAT                     | Bin 2068 -> 2054 bytes
 lib/pytz/zoneinfo/Navajo                      | Bin 2444 -> 2460 bytes
 lib/pytz/zoneinfo/Pacific/Apia                | Bin 612 -> 598 bytes
 lib/pytz/zoneinfo/Pacific/Bougainville        | Bin 268 -> 254 bytes
 lib/pytz/zoneinfo/Pacific/Chatham             | Bin 2068 -> 2054 bytes
 lib/pytz/zoneinfo/Pacific/Chuuk               | Bin 269 -> 172 bytes
 lib/pytz/zoneinfo/Pacific/Easter              | Bin 2233 -> 2219 bytes
 lib/pytz/zoneinfo/Pacific/Efate               | Bin 538 -> 524 bytes
 lib/pytz/zoneinfo/Pacific/Enderbury           | Bin 234 -> 220 bytes
 lib/pytz/zoneinfo/Pacific/Fakaofo             | Bin 200 -> 186 bytes
 lib/pytz/zoneinfo/Pacific/Fiji                | Bin 1049 -> 564 bytes
 lib/pytz/zoneinfo/Pacific/Funafuti            | Bin 166 -> 152 bytes
 lib/pytz/zoneinfo/Pacific/Galapagos           | Bin 238 -> 224 bytes
 lib/pytz/zoneinfo/Pacific/Gambier             | Bin 164 -> 150 bytes
 lib/pytz/zoneinfo/Pacific/Guadalcanal         | Bin 166 -> 152 bytes
 lib/pytz/zoneinfo/Pacific/Kanton              | Bin 234 -> 220 bytes
 lib/pytz/zoneinfo/Pacific/Kiritimati          | Bin 238 -> 224 bytes
 lib/pytz/zoneinfo/Pacific/Kosrae              | Bin 351 -> 337 bytes
 lib/pytz/zoneinfo/Pacific/Kwajalein           | Bin 316 -> 302 bytes
 lib/pytz/zoneinfo/Pacific/Majuro              | Bin 310 -> 152 bytes
 lib/pytz/zoneinfo/Pacific/Marquesas           | Bin 173 -> 159 bytes
 lib/pytz/zoneinfo/Pacific/Nauru               | Bin 252 -> 238 bytes
 lib/pytz/zoneinfo/Pacific/Niue                | Bin 203 -> 189 bytes
 lib/pytz/zoneinfo/Pacific/Norfolk             | Bin 880 -> 866 bytes
 lib/pytz/zoneinfo/Pacific/Noumea              | Bin 304 -> 290 bytes
 lib/pytz/zoneinfo/Pacific/Palau               | Bin 180 -> 166 bytes
 lib/pytz/zoneinfo/Pacific/Pitcairn            | Bin 202 -> 188 bytes
 lib/pytz/zoneinfo/Pacific/Pohnpei             | Bin 303 -> 152 bytes
 lib/pytz/zoneinfo/Pacific/Ponape              | Bin 303 -> 152 bytes
 lib/pytz/zoneinfo/Pacific/Port_Moresby        | Bin 186 -> 172 bytes
 lib/pytz/zoneinfo/Pacific/Rarotonga           | Bin 603 -> 589 bytes
 lib/pytz/zoneinfo/Pacific/Tahiti              | Bin 165 -> 151 bytes
 lib/pytz/zoneinfo/Pacific/Tarawa              | Bin 166 -> 152 bytes
 lib/pytz/zoneinfo/Pacific/Tongatapu           | Bin 372 -> 358 bytes
 lib/pytz/zoneinfo/Pacific/Truk                | Bin 269 -> 172 bytes
 lib/pytz/zoneinfo/Pacific/Wake                | Bin 166 -> 152 bytes
 lib/pytz/zoneinfo/Pacific/Wallis              | Bin 166 -> 152 bytes
 lib/pytz/zoneinfo/Pacific/Yap                 | Bin 269 -> 172 bytes
 lib/pytz/zoneinfo/Singapore                   | Bin 383 -> 369 bytes
 lib/pytz/zoneinfo/Turkey                      | Bin 1947 -> 1933 bytes
 lib/pytz/zoneinfo/US/Arizona                  | Bin 328 -> 360 bytes
 lib/pytz/zoneinfo/US/Central                  | Bin 3576 -> 3592 bytes
 lib/pytz/zoneinfo/US/East-Indiana             | Bin 1666 -> 1682 bytes
 lib/pytz/zoneinfo/US/Eastern                  | Bin 3536 -> 3552 bytes
 lib/pytz/zoneinfo/US/Indiana-Starke           | Bin 2428 -> 2444 bytes
 lib/pytz/zoneinfo/US/Mountain                 | Bin 2444 -> 2460 bytes
 lib/pytz/zoneinfo/US/Pacific                  | Bin 2836 -> 2852 bytes
 lib/pytz/zoneinfo/leapseconds                 |   8 +-
 lib/pytz/zoneinfo/tzdata.zi                   | 771 ++++++------------
 lib/pytz/zoneinfo/zone.tab                    |   9 +-
 lib/pytz/zoneinfo/zone1970.tab                |  80 +-
 requirements.txt                              |   2 +-
 296 files changed, 316 insertions(+), 568 deletions(-)
 create mode 100644 lib/pytz/zoneinfo/Europe/Kyiv

diff --git a/lib/pytz/__init__.py b/lib/pytz/__init__.py
index 900e8caa..2e4dc394 100644
--- a/lib/pytz/__init__.py
+++ b/lib/pytz/__init__.py
@@ -22,8 +22,8 @@ from pytz.tzfile import build_tzinfo
 
 
 # The IANA (nee Olson) database is updated several times a year.
-OLSON_VERSION = '2022a'
-VERSION = '2022.1'  # pip compatible version number.
+OLSON_VERSION = '2022f'
+VERSION = '2022.6'  # pip compatible version number.
 __version__ = VERSION
 
 OLSEN_VERSION = OLSON_VERSION  # Old releases had this misspelling
@@ -86,7 +86,7 @@ def open_resource(name):
     """
     name_parts = name.lstrip('/').split('/')
     for part in name_parts:
-        if part == os.path.pardir or os.path.sep in part:
+        if part == os.path.pardir or os.sep in part:
             raise ValueError('Bad path segment: %r' % part)
     zoneinfo_dir = os.environ.get('PYTZ_TZDATADIR', None)
     if zoneinfo_dir is not None:
@@ -964,6 +964,7 @@ all_timezones = \
  'Europe/Kaliningrad',
  'Europe/Kiev',
  'Europe/Kirov',
+ 'Europe/Kyiv',
  'Europe/Lisbon',
  'Europe/Ljubljana',
  'Europe/London',
@@ -1266,7 +1267,6 @@ common_timezones = \
  'America/Montserrat',
  'America/Nassau',
  'America/New_York',
- 'America/Nipigon',
  'America/Nome',
  'America/Noronha',
  'America/North_Dakota/Beulah',
@@ -1283,7 +1283,6 @@ common_timezones = \
  'America/Porto_Velho',
  'America/Puerto_Rico',
  'America/Punta_Arenas',
- 'America/Rainy_River',
  'America/Rankin_Inlet',
  'America/Recife',
  'America/Regina',
@@ -1304,7 +1303,6 @@ common_timezones = \
  'America/Swift_Current',
  'America/Tegucigalpa',
  'America/Thule',
- 'America/Thunder_Bay',
  'America/Tijuana',
  'America/Toronto',
  'America/Tortola',
@@ -1456,8 +1454,8 @@ common_timezones = \
  'Europe/Istanbul',
  'Europe/Jersey',
  'Europe/Kaliningrad',
- 'Europe/Kiev',
  'Europe/Kirov',
+ 'Europe/Kyiv',
  'Europe/Lisbon',
  'Europe/Ljubljana',
  'Europe/London',
@@ -1485,7 +1483,6 @@ common_timezones = \
  'Europe/Tallinn',
  'Europe/Tirane',
  'Europe/Ulyanovsk',
- 'Europe/Uzhgorod',
  'Europe/Vaduz',
  'Europe/Vatican',
  'Europe/Vienna',
@@ -1493,7 +1490,6 @@ common_timezones = \
  'Europe/Volgograd',
  'Europe/Warsaw',
  'Europe/Zagreb',
- 'Europe/Zaporozhye',
  'Europe/Zurich',
  'GMT',
  'Indian/Antananarivo',
diff --git a/lib/pytz/zoneinfo/Africa/Ceuta b/lib/pytz/zoneinfo/Africa/Ceuta
index 850c8f06fa7918684e67e9ab8192ac933dac90b3..b41ec4f81ab104943e84105246f0e5d0157e6e2e 100644
GIT binary patch
delta 355
zcmeyu-y$$UT#$o-fdPa;pbm&RHfsE1tY>CofkI{`C}d@0rw{!9|M%oxcJayc*me0C
h85kHD7=Z}nJVr)r?%gcG{Ed0AIG7Xe;K`TRl>qDm8+8Bx

delta 375
zcmZn>_`*LyT#%iCfdPa;pbm)HH){N2tY>6mhC)UrC}d$}qYwQ5|2IDi*gXskK$=g0
pkz?{MCVgH821W)(Mz91UBQ}?BR$%_dJQ$r03}3L*CqH6W0syr~7{34j

diff --git a/lib/pytz/zoneinfo/America/Araguaina b/lib/pytz/zoneinfo/America/Araguaina
index 49381b4108b1827f24ad7d2c18064a22624092e7..919723dc2ca581b4f95154d4192d8f732cc55a45 100644
GIT binary patch
delta 44
scmeyu_Ka<UGNbWCl`E4N^_dx&7$@s9Ix!k=E@E83h!ByVoWslk02qx5)c^nh

delta 60
zcmaFH_JwVNGNZ{vl`Aau|NsA=EXb@sS%H~lvOTl>WKTw*%;sFi1&kaFK!7H%4giVn
B6Jr1X

diff --git a/lib/pytz/zoneinfo/America/Argentina/Buenos_Aires b/lib/pytz/zoneinfo/America/Argentina/Buenos_Aires
index 260f86a9180677d86fc3280b06f01d6a6cd91c94..cc82e69898f161842b5001f10a84d3ac127c5c6f 100644
GIT binary patch
delta 58
zcmdnOv5aGaGNbK8l|PJ(lMgb>Pj+DBn*4xScybbBG^6e2eT*L%F(fP|>#%SD03{_6
Awg3PC

delta 52
ycmZ3+v4vxTGNau@l|L-?|NsA=tiWhHIfgNY(Qflj#t)1f3_yS+ZaG<wg#!Q-zY@a$

diff --git a/lib/pytz/zoneinfo/America/Argentina/Catamarca b/lib/pytz/zoneinfo/America/Argentina/Catamarca
index 0ae222a2f8bb2fb1b7abe17d08e076674c51541d..7268eb3738e5b3ba906f962533f48016cf3dcabc 100644
GIT binary patch
delta 58
zcmdnOv5aGaGNbK8l|PJ(lMgb>Pj+DBn*4xScybbBG^6e2eT*L%F(fP|>#%SD03{_6
Awg3PC

delta 52
ycmZ3+v4vxTGNau@l|L-?|NsA=tiWhHIfgNY(Qflj#t)1f3_yS+ZaG<wg#!Q-zY@a$

diff --git a/lib/pytz/zoneinfo/America/Argentina/ComodRivadavia b/lib/pytz/zoneinfo/America/Argentina/ComodRivadavia
index 0ae222a2f8bb2fb1b7abe17d08e076674c51541d..7268eb3738e5b3ba906f962533f48016cf3dcabc 100644
GIT binary patch
delta 58
zcmdnOv5aGaGNbK8l|PJ(lMgb>Pj+DBn*4xScybbBG^6e2eT*L%F(fP|>#%SD03{_6
Awg3PC

delta 52
ycmZ3+v4vxTGNau@l|L-?|NsA=tiWhHIfgNY(Qflj#t)1f3_yS+ZaG<wg#!Q-zY@a$

diff --git a/lib/pytz/zoneinfo/America/Argentina/Cordoba b/lib/pytz/zoneinfo/America/Argentina/Cordoba
index da4c23a545b3603bcdd4555ba8feba117802e7b4..2ad6ea5db204d599266412558f5a1fae076fc41a 100644
GIT binary patch
delta 58
zcmdnOv5aGaGNbK8l|PJ(lMgb>Pj+DBn*4xScybbBG^6e2eT*L%F(fP|>#%SD03{_6
Awg3PC

delta 52
ycmZ3+v4vxTGNau@l|L-?|NsA=tiWhHIfgNY(Qflj#t)1f3_yS+ZaG<wg#!Q-zY@a$

diff --git a/lib/pytz/zoneinfo/America/Argentina/Jujuy b/lib/pytz/zoneinfo/America/Argentina/Jujuy
index 604b85663672d83658f331a69cc8f41cf2a2b5a1..7ca0b46f680b80780981aab0699e64dd04070fe7 100644
GIT binary patch
delta 54
xcmbQi(Zw-AnbCTp$`?k)$%>4slMNVICc7~TPL5!VX0+bCh4BF+n#2ue2LO?-4r2fS

delta 70
zcmeC;n87hYnbBsV$`{u9|Ns9pPF7@8oNU0zF?lDm;N+9cmXo^~fzq4TGd^JCWB>we
GiW~uI?ibSl

diff --git a/lib/pytz/zoneinfo/America/Argentina/La_Rioja b/lib/pytz/zoneinfo/America/Argentina/La_Rioja
index 2218e36bfdb95ea041b166f183895a6ca4871ab1..a6a6694f3317a25e7bc4c66502e9f396fa106509 100644
GIT binary patch
delta 58
xcmX@av4vxTGNau>6-GwJ$%c%IlN}g2CckACnaspuF?l{CP-^pG#vhoH4gl2552OG9

delta 70
zcmdnOafoArGNb)M6-L(j|Ns9pPCm#iKiPqiYw`nTk;#dSF^u+`_c8up<YWK>YzizV
I>#%SD0DbWn`2YX_

diff --git a/lib/pytz/zoneinfo/America/Argentina/Mendoza b/lib/pytz/zoneinfo/America/Argentina/Mendoza
index f9e677f171b3900dfd978eb8ea2aa226557d2c5b..3232c80e2003489921578f7acbabc73fb9148205 100644
GIT binary patch
delta 58
zcmdnOv5aGaGNbK8l|PJ(lMgb>Pj+DBn*4xScybbBG^6e2eT*L%F(fP|>#%SD03{_6
Awg3PC

delta 52
ycmZ3+v4vxTGNau@l|L-?|NsA=tiWhHIfgNY(Qflj#t)1f3_yS+ZaG<wg#!Q-zY@a$

diff --git a/lib/pytz/zoneinfo/America/Argentina/Rio_Gallegos b/lib/pytz/zoneinfo/America/Argentina/Rio_Gallegos
index c36587e1c292673fa537cecf729f4c873d375c9a..8b1a2816ab136098d10a3d294993ea56b6c432dc 100644
GIT binary patch
delta 58
zcmdnOv5aGaGNbK8l|PJ(lMgb>Pj+DBn*4xScybbBG^6e2eT*L%F(fP|>#%SD03{_6
Awg3PC

delta 52
ycmZ3+v4vxTGNau@l|L-?|NsA=tiWhHIfgNY(Qflj#t)1f3_yS+ZaG<wg#!Q-zY@a$

diff --git a/lib/pytz/zoneinfo/America/Argentina/Salta b/lib/pytz/zoneinfo/America/Argentina/Salta
index 0e797f2215ab398bc59b8e4d60e5260fcb365c3b..7072dec22958ad5ac74ba3457a178a4faadaf570 100644
GIT binary patch
delta 54
xcmbQi(Zw-AnbCTp$`?k)$%>4slMNVICc7~TPL5!VX0+bCh4BF+n#2ue2LO?-4r2fS

delta 70
zcmeC;n87hYnbBsV$`{u9|Ns9pPF7@8oNU0zF?lDm;N+9cmXo^~fzq4TGd^JCWB>we
GiW~uI?ibSl

diff --git a/lib/pytz/zoneinfo/America/Argentina/San_Juan b/lib/pytz/zoneinfo/America/Argentina/San_Juan
index 2698495bb3f953685e45edb916798cd24f772664..f3e185c3ab516065c52557aaceaaeacae1f8b221 100644
GIT binary patch
delta 58
xcmX@av4vxTGNau>6-GwJ$%c%IlN}g2CckACnaspuF?l{CP-^pG#vhoH4gl2552OG9

delta 70
zcmdnOafoArGNb)M6-L(j|Ns9pPCm#iKiPqiYw`nTk;#dSF^u+`_c8up<YWK>YzizV
I>#%SD0DbWn`2YX_

diff --git a/lib/pytz/zoneinfo/America/Argentina/San_Luis b/lib/pytz/zoneinfo/America/Argentina/San_Luis
index fe50f6211cff908f21257cb42259fe2692abdc4e..2d1da3ae3d6f9c6f92a8ddf01c2ff51ae28e4de2 100644
GIT binary patch
delta 58
xcmX@dae!ljGNau>6-GwJ$%c%IlN}g2CVyrYnasgrH+d-|P-^o@#vhoHZUEih59|N{

delta 75
zcmX@WagJkxGNb)M6-L(j|Ns9pPCm%2I@y7dWwIZm$mB%EBu4wqM;L!Faxwq`HU;(^
MTsFD}#&*VB0NCFbi2wiq

diff --git a/lib/pytz/zoneinfo/America/Argentina/Tucuman b/lib/pytz/zoneinfo/America/Argentina/Tucuman
index c954000ba9b28204cc3223628d13e9dcfa4b6eb0..c6449f582a7804ecf66858a7fceda207c5d979be 100644
GIT binary patch
delta 38
ocmcb>afoArGNb)Q6&A+H7ntoQ3$R#BUcv|zS$u+#2`b_M0O~Odi2wiq

delta 70
zcmX@aae-rkGNZ#r6&6O;`v3p`Gfp;SRGjR<$T9gXv*=_-7R$-=8G-VP4>K}xG5`TK
GHI4u*1{K!;

diff --git a/lib/pytz/zoneinfo/America/Argentina/Ushuaia b/lib/pytz/zoneinfo/America/Argentina/Ushuaia
index 3643628a24723239a13d61b2215c907cdba03985..e74ce049c793c96e855ebb15779887a48622bf26 100644
GIT binary patch
delta 58
zcmdnOv5aGaGNbK8l|PJ(lMgb>Pj+DBn*4xScybbBG^6e2eT*L%F(fP|>#%SD03{_6
Awg3PC

delta 52
ycmZ3+v4vxTGNau@l|L-?|NsA=tiWhHIfgNY(Qflj#t)1f3_yS+ZaG<wg#!Q-zY@a$

diff --git a/lib/pytz/zoneinfo/America/Asuncion b/lib/pytz/zoneinfo/America/Asuncion
index 2f3bbda6d3586a2ef5b94bc28ff37906fbc758f5..891279d4db7f89ee8cf063b64b6e87a29ea86821 100644
GIT binary patch
delta 55
xcmeyv|BioxGGpUL6&@yLMkeOThU{gN{h2r>uV6Qs{E7)Evzd=sfCWt|1OTv{4wV1^

delta 53
zcmaFI|A&8qGGo(56&@y*`v3p`Pc~p`oV<Z4g0X2cC$j(x2LliwiJMM7$F2YXA$Jp}

diff --git a/lib/pytz/zoneinfo/America/Bahia b/lib/pytz/zoneinfo/America/Bahia
index 15808d30fb1bb250cce195a00a2d7dca321df7d3..0b65e49fca21f1be92c3ab0dfa4cd05137f028b2 100644
GIT binary patch
delta 51
ycmZqR_{2UznbCHl%Ad&#m@SzZnHVQ0GCDEZZeGIpfe}eao`cIq*TC4$m<s@k&<#5P

delta 63
zcmeyw-oP<InbB^d${&{c|Ns9_p2%#?#K<%`hS7=9Zu5M`4~!fPK!7SG&%tG*YhY|=
G%mo12FBB92

diff --git a/lib/pytz/zoneinfo/America/Bahia_Banderas b/lib/pytz/zoneinfo/America/Bahia_Banderas
index 896af3f56abd712e2fa85d69592bd33b88d364bc..ae4a8a754617b8b918daffb6a45a067df2fd2fe6 100644
GIT binary patch
delta 290
zcmeC;Y2ch7F37>azyQJ^U=PF`3pE(+7@1g@S(sQ@fh2Co#)Jb-Ue7AZzj^^9&;S2(
zCor)5|KH!hF!?O2q>Qgi2tz<{2!k__W?%$c38%3+Wpg^yA6hv^37=!QoP$HmxBxv8
BBt-xK

delta 727
zcmbV}ODIH90EW-GX2LWz$fJ~n9W|~yHD+O<G@1=ZVr-P8m@&rVjK?&d_momBJhE1#
zP)cOwu{B%8%9Ne5bXZAro&RPr3zYd!r|)!@-zN%J-5V9fBx}9uoxfW{&4Jng8En#I
zq@+_ss~%<a)h~uV(=v8jE`}ctW&HF_jHIvm=w?QY?H};*#FgO7D?HJ2PbMO9KG}Fl
zrb3KQS8kJJeM~0bO_K7o%2cMG%ski0*^3~VyYa~Ry*{yU{2~{ZnuWP`C#hzi?mX)F
z<2bdP&Q`UfOkWqoZCOV<w8*l~PiQILq@az33F``zpt>FEvKIAL_a{GRPxOPDum(#Q
zOo6Zk!kA5E4TL!m_COc}VG)E$5H>*=1z{D0SrB$HW!SVopc#W|5V|oax2d#aP;XP|
z$B+O-1`H`c<N%QbL>4eB&3BphU-IM>Msp%f=znQks#QQW@-n~f(+w~48G3_mxV`{m
CUaPPG

diff --git a/lib/pytz/zoneinfo/America/Belem b/lib/pytz/zoneinfo/America/Belem
index 60b5924dc12f14c274073b1fe4ccc590b742da5a..0ae1202682c94ee52f74a795099f6a11d34e0d1e 100644
GIT binary patch
delta 46
vcmX@WvWaDaGNbH7m6}ORlFW=uj1vz!G0IM6Vf+B+%X4tq=o%Q?8FK*u8lDR2

delta 59
zcmdnQa)4!mGNar?l^T}%|Ns9_{>UiJ#K<&pj}uVr{|62RAV3k9=isu@H88d_<^lkw
Cp%lLW

diff --git a/lib/pytz/zoneinfo/America/Boa_Vista b/lib/pytz/zoneinfo/America/Boa_Vista
index 978c33100fb2d9b14c1faa581890c16c8747b42b..08d518b151425f85458727fbf69f6e601f12be86 100644
GIT binary patch
delta 37
mcmeyt@``1GGNa-|m7d84Op23(nB*pY0rEFXFbXh2MbrS}2MUG&

delta 85
zcmaFG@`Gi9GNaN&l^&M*|Ns9_He?c>?7+kV!%U1!6E8S1Ds2{K6kz0F00Nw<<T<!(
KbPY`GOt=7V6&Fze

diff --git a/lib/pytz/zoneinfo/America/Bogota b/lib/pytz/zoneinfo/America/Bogota
index b2647d7a837637d3b85d4bc85f83c88982597faf..c274baee5f2212756cb10a477d90b1aedda1468b 100644
GIT binary patch
delta 53
zcmeyy_=0hQvJ49Y0|N*PGysVi5upWI%*6rP`(hm!nVBXY)ts2C%*Zlvq6RaVYX|^L
C@eKF?

delta 67
zcmaFC_>FObvLY)30|N^X3p4<U84;lcTFk`(+WTT1>i_@$&&bTgJkj2Vk#%B^1`kl4
L0U@Y4@c{<_Uab>o

diff --git a/lib/pytz/zoneinfo/America/Boise b/lib/pytz/zoneinfo/America/Boise
index f8d54e27479149d35f6ddff12f709096f08bfac3..aad1d991c49c2e0fa28be3da4de447af33c8df1c 100644
GIT binary patch
delta 429
zcmca5^h#)gxF81u0|N+yz;qzy*r<`fRL{)F#K^?P!pg=zAW#dJwg3N5=4W8||9|cT
qMwb8o`x_WICTla>axyY7f<3@EIiFb?(@UFYGw)#;x_+|blmP&We<l<F

delta 415
zcmaDQbW3Q0xF9<N0|N+yz;qyH->8wmRL{f+gsjXgtZV}URd8AR|Nmru28RFt=T2Z`
inQX{x%gw+Db~%W`=9$flnfI^^8Q-u&eKXmQQw9LlG#*+2

diff --git a/lib/pytz/zoneinfo/America/Buenos_Aires b/lib/pytz/zoneinfo/America/Buenos_Aires
index 260f86a9180677d86fc3280b06f01d6a6cd91c94..cc82e69898f161842b5001f10a84d3ac127c5c6f 100644
GIT binary patch
delta 58
zcmdnOv5aGaGNbK8l|PJ(lMgb>Pj+DBn*4xScybbBG^6e2eT*L%F(fP|>#%SD03{_6
Awg3PC

delta 52
ycmZ3+v4vxTGNau@l|L-?|NsA=tiWhHIfgNY(Qflj#t)1f3_yS+ZaG<wg#!Q-zY@a$

diff --git a/lib/pytz/zoneinfo/America/Campo_Grande b/lib/pytz/zoneinfo/America/Campo_Grande
index 81206247d9efa7d3dd10dd9e88c669718d86cc50..53b3330fac2bd64c02d8dc171c722ec491bea41d 100644
GIT binary patch
delta 47
tcmZ3&J&k*UGGp{cl@i9u3mC(h8JQR-*Rsk_7Gna6Znk22z=R~M4gfe)3^@P*

delta 61
zcmbQny@Y#$GGoj}l@dml`v3p`PgZ30pKQR&GdZ7CezG7FP-?R&(*q_B1|UF_R|f!l
CG83%;

diff --git a/lib/pytz/zoneinfo/America/Cancun b/lib/pytz/zoneinfo/America/Cancun
index f907f0a5ba77b9ec845c450cd535ee589b46c5ad..e7acbff18a2469c79f4ce77064adeb189d60bf10 100644
GIT binary patch
delta 236
zcmeBUJH$3YT#%iCfdPa;KnsZ3Cu(d~Vr3x&C;pW-TD^dQ<^TVk8yE#ZBm<9+ZwP~P
na0r8|3lIZoXCTeM2sRl?VY6>@1Y<NKaW-0zZX*}aA*NgargkOt

delta 186
zcmX@a*2gwMT#x|?XaU)*6E!v~u`m*XlixE*OYGdhDB$B8!r&Yn!r<xx#6a2^NMkd0
Ua}i@SBasHn;WC&DXoD#i0JuLFng9R*

diff --git a/lib/pytz/zoneinfo/America/Caracas b/lib/pytz/zoneinfo/America/Caracas
index eedf725e8de1a61c4db886ce8b8b60fb4ee91c77..3f3ebc9c410fe2a33ad26a5d02bb99b9503e1f72 100644
GIT binary patch
delta 59
zcmeBR`o%awS&@~2fq?~xg&KgwWH}w1Z!_L_xJOSa2v=QMz{teRG||(Kk#*t>0~QEJ
IdlDlD0ImiOL;wH)

delta 73
zcmeyx*ugYGS&fZ>fq?~xg&KgwWH}w1Z!_L_xJOSa2v=QMQ2+n`e?}%|CgzF9wI}8)
RGqO#bY`_at$ABbZ3;+=@7PbHY

diff --git a/lib/pytz/zoneinfo/America/Catamarca b/lib/pytz/zoneinfo/America/Catamarca
index 0ae222a2f8bb2fb1b7abe17d08e076674c51541d..7268eb3738e5b3ba906f962533f48016cf3dcabc 100644
GIT binary patch
delta 58
zcmdnOv5aGaGNbK8l|PJ(lMgb>Pj+DBn*4xScybbBG^6e2eT*L%F(fP|>#%SD03{_6
Awg3PC

delta 52
ycmZ3+v4vxTGNau@l|L-?|NsA=tiWhHIfgNY(Qflj#t)1f3_yS+ZaG<wg#!Q-zY@a$

diff --git a/lib/pytz/zoneinfo/America/Cayenne b/lib/pytz/zoneinfo/America/Cayenne
index e5bc06fdbe5a3062f90274a6b5cc5c56e2d74d5f..e898594276143fa4cfd5d3815c4598b9e58dba07 100644
GIT binary patch
delta 41
vcmX@cxPx(mvJevk0|PS<^Gy7rJ>mCZ(*ukX=gUuwRAywFSS!H@<fsDx@v{sm

delta 75
zcmdnNc#Ls^vN$sX0|N;2O#Grf;rC(F1NHy^|7T>HI8lCLh_W(V7AW{1qyj{PQ~`A`
K)C1WdmFfTs?;ijF

diff --git a/lib/pytz/zoneinfo/America/Chicago b/lib/pytz/zoneinfo/America/Chicago
index a5b1617c7f70bfc77b7d504aaa3f23603082c3cb..c6981a06b1d9c26f447518efe265a6454726eae7 100644
GIT binary patch
delta 155
zcmew%-61nUT#$o-fdPa;;0+LSY}DAo%*Z_XA+y3{1r`=Q7A8hGWM!Ky$g+KMAFtTt
idA#Plj0_Aw1SS|6uo<=4fi;DlD6=@>W=+1sD+2%_Qx^~b

delta 139
zcmeB>`5`?)T#%iCfdPa;;0+M7Z`9brJXw%Mm5-T;5e`{cfkN9SA7c@l{D{Snn}LB5
atN}=2Gh(v`YYIC7Gk|u2&6xa#R|Wu-P87-j

diff --git a/lib/pytz/zoneinfo/America/Chihuahua b/lib/pytz/zoneinfo/America/Chihuahua
index 8ed5f93b02001a63ce43dd221ff48cc5faa6752e..e0910396704ffda1d7f39e70a369249aeb4b0353 100644
GIT binary patch
delta 350
zcmX@ZeU4*-xF81u0|N+yfDI6HOw{;N&&b5W%)-P9gv>w&Ns#IP|2aJj4FCVnoxs5I
z|NrU*3>+Ymkq0KSa|5FQOavtB;~T=@8yv#m48*=JK-wilkb!{_>>xOe&7qt9n4T~W
Rv{S|5PJ}s`3+NFuE&$YlNcjK&

literal 1484
zcmd6mduYvJ9EZP$<I-B~B@!aB60Nhd*@c<0?J#3!V>_EU!;az1*wtoj*t|t68r~^U
zb1M;+w$v_e<u9R-Y2}iV#F8RfZmpl+bNsKAKYZTap10rc-{<l9%Yw1;$NBBQqwPE4
ze9vHY=jX~-J;8!NZ+d^AFFYa8H{9|mrnFvSYsXg4%P5q%-1pV-vzM!c*ylQN%v?2p
z>Q|ZnE?h16`Am|A#+!vbk0rS)%q+TbN>Yw|FpJyw%95&wCUt+iPRr>s>6@FhC;F&a
z>M7RCBI-;=WU9{i)}}I@vvlUuTD9WMD7~^TUu8X*Dc%!_D*K94avCP9RjqGj^~QLU
zTYgvaQYRT-)@8|`@!b?ewaOZKVG1W+)P=8ZnYBX)wg2`RQ#4Sn*Il}))^}&?4F^uE
z;$v<dDAQ_VvsX$oOVp+f(Xx4tM{P+NC&BRnQ#$R7lzvV#TZadvtUuChd)X`7uZ}k5
zcb@2qwn0;Qp<7qg+&9%N$90YWo!Sv>)U`?XRNb;7y>m*3s*i4v`X7f>Lxf)%o>!^H
zkIAy@`f9cN(RA5!uEI2RiZt)bF?$cc7RLzANc%V)|Mpnc$yO1|I%ULZSsiC(tYuy6
za)k4CsNdhSygu>f`6Qj|vETOf{e>l#Jxqbv0x<?+4aA%fZF_JJgBTV;Ok&ssF$!W8
z#4LziA=-vPEMu4kv5jFI#5#s~5c?PgLM()s2(b}jB*aRHnGicev<-z=8lr6~#8!y0
z5NjFcLhNN246&GDGQ?(v(GaT{W<%^|7!I*KMB8+T?GWQ3)<evP*bgZHQURm{NDYi4
zAXPBRfYiY#1X4+eb}5ir7{x%UVUz=@2T~BEB1lP)njl3%s)CdSsS8pVq_Pn0(jc{k
sXcq^mj!_<@K1P9%3K=EB|Fgz0JI_Qr%P4Q0E5_xH^2WGb@h*4RFJJn4nE(I)

diff --git a/lib/pytz/zoneinfo/America/Cordoba b/lib/pytz/zoneinfo/America/Cordoba
index da4c23a545b3603bcdd4555ba8feba117802e7b4..2ad6ea5db204d599266412558f5a1fae076fc41a 100644
GIT binary patch
delta 58
zcmdnOv5aGaGNbK8l|PJ(lMgb>Pj+DBn*4xScybbBG^6e2eT*L%F(fP|>#%SD03{_6
Awg3PC

delta 52
ycmZ3+v4vxTGNau@l|L-?|NsA=tiWhHIfgNY(Qflj#t)1f3_yS+ZaG<wg#!Q-zY@a$

diff --git a/lib/pytz/zoneinfo/America/Creston b/lib/pytz/zoneinfo/America/Creston
index ac6bb0c78291f1e341f42c34639458fb385bf8ed..ab37e845566aa95659b7b85be0051d0c67a7e53a 100644
GIT binary patch
delta 134
zcmX@X^nz)ExF9P70|N+y05=e`PSh}9WSK0$sHE`!|J(@-96r7w48ATv91O(aAz+1!
WAd(TQ?#(d}-D-q%a{&!B=K=r{d=}#X

delta 102
zcmaFCbb@JuxF7=(;0Cf;CTbWkGEG)sR1)y<4Po$g0pegF4i90#s`_vYM70>YYA&EQ
Gb1ncA<q&TG

diff --git a/lib/pytz/zoneinfo/America/Cuiaba b/lib/pytz/zoneinfo/America/Cuiaba
index 9bea3d4079f4449d5bed22b81404b5ee2ab6394a..26e97f6ebfc60c1517244840b77dbaedcbfabaaa 100644
GIT binary patch
delta 47
tcmeC+{>3#xnK5#sN)F>>0oK6D>lryFC$Y*+=3xSgZZ=@Lz=R~M1^`pH4SWCq

delta 66
zcmeyx)xkYMnK5dkN)97S{r~^}Co{4JPZnThoBV>&i7{%kHq!+r4hA4VlauG*ve7j#
Iu`}TU00TG_;Q#;t

diff --git a/lib/pytz/zoneinfo/America/Denver b/lib/pytz/zoneinfo/America/Denver
index 5fbe26b1d93d1acb2561c390c1e097d07f1a262e..abb2b974a47eb3e5c8b4f5d4370baf4898b239ab 100644
GIT binary patch
delta 145
zcmeAXo+CU#T#$`{fdPa;U>*>&ZPch?;$~)Kf<PA5$s3s_PB!Bdn;gKb&dJEY2vh?k
pvFY5rjQI--F0G1itz5prA?Cg=Av(UsdPaH%I=+U6dWL!iTmY8~6#xJL

delta 141
zcmbOu+#@_eT#%K4fdPa;U>*>&Zq%q@;$~umLS~l98<{3fw&N6=9K)>0&cFy#$B0ee
n=5@?pSa4~Shic^V4GuB)bqUe&HP$oIGtluhG}JTHGvERMYMd1i

diff --git a/lib/pytz/zoneinfo/America/Eirunepe b/lib/pytz/zoneinfo/America/Eirunepe
index 39d6daeb9b6dd3b225b0ddacceb6984e8204ac7d..d4c46e3091fe37b7db8d8b67d383302cd667987e 100644
GIT binary patch
delta 43
qcmbQh+Qd3RnNe|~O3!2mCh3Xi*(S#^X-#4T3T;+l6ktRM8UX+edkf+K

delta 65
zcmZo-oxnOlnNew?N)Jo@|Ns9d8#2kVFfuVSO}ya8sI*z0QGk(y0SM6Kv^ltJbPY`H
GOt}DppAoeH

diff --git a/lib/pytz/zoneinfo/America/Ensenada b/lib/pytz/zoneinfo/America/Ensenada
index ada6bf78b2815d3d99c97d521ab9a6b35c8af8c3..63dfdf48a68d02240737ecd6af081e02eb0b6317 100644
GIT binary patch
delta 551
zcmZ1`bWCW1xFiPy0|N+yz*Haxu_cyndr`2_Ac(1+nTdsol?_M?49vl1?f?Iid>9!1
z|DQX7f#v`I{ssmP7<=vnMjjBGQ2<PeKxBP<Ll}I6Ll^=;*ae8gfjA(9fq@a^XCMKk
cCy2{p4UGRl01A-J6PXvWjHnQq%*QDK004qi$p8QV

delta 519
zcmX>mv`lD%xFj0`0|N+yz*Haxu_cyn`_{10Ac(1+k%^g!g%wB)42;2M?f?Iid>9!1
z|DQX7f#v`I{ssmP5Sx()ObUQW5g*?W2H)Tih5!(D0pf5V4hR8xl7WE{LQW8u#p?P0
VKmZDW%?p_qu?*`Fn5@Ss0RTUKN9O<l

diff --git a/lib/pytz/zoneinfo/America/Fort_Wayne b/lib/pytz/zoneinfo/America/Fort_Wayne
index 09511ccdcf97a5baa8e1b0eb75e040eee6b6e0c4..a84b6e99671f7305d1c459956e16a4dd772fc60e 100644
GIT binary patch
delta 321
zcmZqToy0pqT#$o-fdPa;AQ^}`Hfl^@<YZ=K0znqm$p;yQBiWeP*r@>j|6gy#!0`Y7
z&JBz#|NpOEz`!wCoynG$k%19xJDA4iqRrEpWSHscBvlkAak&PEn7X=z==d7z8R;45
N_!=7O8R{8u0RTxGC_n%J

delta 305
zcmbQl+r&FTT#%iCfdPa;AQ_0+H)>2^<YZz5LuQuA2N{KfS(#Ybr~v=}UvI_0@c;kL
z4U8<44cKhC85qIVf+%b***u>~hM7K2QATnKmuql{sjEwfj<2zvk)DB$uc4uyp`HO3
E0D)T}6aWAK

diff --git a/lib/pytz/zoneinfo/America/Fortaleza b/lib/pytz/zoneinfo/America/Fortaleza
index be57dc20b46142787cbd820e0d1c927d2f02f046..bee1a95152cbc37db7117d996d370ff9d3f11f79 100644
GIT binary patch
delta 42
qcmX@Zx{q~&GNbxLl_irKm{b`VCog4^pDe@(6xwXY=)edUR0jYB{tFiX

delta 55
zcmdnTdWLm^GNZ;sl_f0o|NsA=T*#z8@tqT+#%4oC2SyGCAV3Jqb8y+{8W`Ida{&NJ
CNE0sr

diff --git a/lib/pytz/zoneinfo/America/Godthab b/lib/pytz/zoneinfo/America/Godthab
index 0160308bf63690a6dee51c3c8849f494a47186c2..0d2149cc0033785b517624400583fb9edf2ff2ec 100644
GIT binary patch
delta 53
wcmcb{cY<$%GGpmRl{<_~j4YEUu;nu|Gciy8&t^J#9TQMu^ChMY%&0Qq0J}~PyZ`_I

delta 51
xcmX@Xca3j?GGp0Bl{<_q_5c6>pTtx;`6HX@<dsZ7(amR>HZXHA00BZO8~`r?6<PoQ

diff --git a/lib/pytz/zoneinfo/America/Guayaquil b/lib/pytz/zoneinfo/America/Guayaquil
index 0559a7a4a4288d7e3c3b1bcf47c57a7ea82be2ef..40831be11e0ab028ada80cecf5fdc0e2a233ee17 100644
GIT binary patch
delta 53
zcmeyy_=0hQvJ49Y0|N*PGysWhOPnOM#r|B-E_~*|$jmhHsOH36Wk!~X6E&E@TtfhG
CZ4OWX

delta 67
zcmaFC_>FObvLY)30|N^X3p4<UZA+Xaw8j2h&@O!DQ2+n`e@12|=85(`jI0xTG<bmW
L3<yEZi4Qmcl=&3E

diff --git a/lib/pytz/zoneinfo/America/Guyana b/lib/pytz/zoneinfo/America/Guyana
index 7af58e502329b9625a9a9a34268e4f024b545b0f..9b7036723053b8e8e3888b0497528fe714b5b735 100644
GIT binary patch
delta 53
zcmZo;`oTCsS%!syfq@l>g(k`Jx6im)?Z8#fx<~V>!vRJn=80zwCzdKRvP_(*!3^eF
F0swg34%z?!

delta 64
zcmeyt*v2$LS&@~2fdPbtCdu-*&$wCbz*Wz>NAs$~f%^ad|1&Z%GfuP*VPu^+MS};Z
KhygCR-x2_2GZZ}l

diff --git a/lib/pytz/zoneinfo/America/Hermosillo b/lib/pytz/zoneinfo/America/Hermosillo
index 791a9fa2b38729ff10032f9e1f021754c76c87f5..86bd1a20a3fca3908723ffbe0201d3b162474066 100644
GIT binary patch
literal 456
zcmWHE%1kq2zyRz(5fBCeejo<1MV4-RQLz3~-h*vvVF}xvFD2~YF-zF-x9!8}SA_{T
zCT{t_z);X&nBF2_R4mqD?4BlI67-|NRNX_s%;;7FBNGcV3lj?~kOaa1|EK?8VEF%k
z?gR!Pd-Vba4iL%60~6_QU=V<?eSAY0e1k(6oPpTaC4?aWNHZ{k+y$dTNbtgcAOLv-
zM1#BnqCwsP(I78@XppzSG|+1x8st3?4e=t#-hu`Y3Gyn426-1mgS-r)LEZ+@Ag_aH
M8hf7$7&_)$0Qr5DMgRZ+

delta 196
zcmX@XynuOvxF7=(;0LnVCTcjjGBN=nGb0Na{{KJy2Lr?Z|8plWu>AkOdI1B+|Ns3B
q3_Kt<qX0zQ$2Ww*H#mgB8HfXb*w-b50juG!>%6IAI2X`1b1ncT7C5Z{

diff --git a/lib/pytz/zoneinfo/America/Indiana/Indianapolis b/lib/pytz/zoneinfo/America/Indiana/Indianapolis
index 09511ccdcf97a5baa8e1b0eb75e040eee6b6e0c4..a84b6e99671f7305d1c459956e16a4dd772fc60e 100644
GIT binary patch
delta 321
zcmZqToy0pqT#$o-fdPa;AQ^}`Hfl^@<YZ=K0znqm$p;yQBiWeP*r@>j|6gy#!0`Y7
z&JBz#|NpOEz`!wCoynG$k%19xJDA4iqRrEpWSHscBvlkAak&PEn7X=z==d7z8R;45
N_!=7O8R{8u0RTxGC_n%J

delta 305
zcmbQl+r&FTT#%iCfdPa;AQ_0+H)>2^<YZz5LuQuA2N{KfS(#Ybr~v=}UvI_0@c;kL
z4U8<44cKhC85qIVf+%b***u>~hM7K2QATnKmuql{sjEwfj<2zvk)DB$uc4uyp`HO3
E0D)T}6aWAK

diff --git a/lib/pytz/zoneinfo/America/Indiana/Knox b/lib/pytz/zoneinfo/America/Indiana/Knox
index fcd408d74df43310a9a85c475f83d545f6d75911..025d132dd48ba978c6fedf86d70173127be49d49 100644
GIT binary patch
delta 152
zcmew()FV7WT#$o-fdPa;U=|Q_Y}CkMVrOM!Vq{`wnS78*o{??xM<yd6`GLu9vJSHn
n%jyLT9Fu*RHMtqVniv>?G&X}aFJr#KLX=4yFq0-Ha!LaLn_U^_

delta 138
zcmeAX{v$L&T#%iCfdPa;U=|RwZ`8<PVrOCmLS~l92bts<StoyFG6IqxnCvF&Fe^=V
f;#B7ZD`#M2V8CX==5@?hSO^)x1~FoCA*VC|8HE=u

diff --git a/lib/pytz/zoneinfo/America/Indiana/Marengo b/lib/pytz/zoneinfo/America/Indiana/Marengo
index 1abf75e7e864625b975feebdd0b232d0de624b27..677bbff6a9d89180cfd2dd3279a1c412610b6540 100644
GIT binary patch
delta 311
zcmdnRdy030xF81u0|N+yKspd}Y}8o5n9j<`#K^?V0who&8#^2_!dVD0QdyJrnG{%7
kFJR!9?8~If!3cH)1LNcdCMisJZC=e}!#uzao6jZ<0Fwh0#Q*>R

delta 262
zcmX@byNh>%xF9<N0|N+yKspe!Z`4@8$jCJL1FN_{D;pd#!dVD0QdyJrnG`11uxWFG
cEn{G0V8CYo=FLnt%(Qg?8^i&V*Rx3j00VRs9{>OV

diff --git a/lib/pytz/zoneinfo/America/Indiana/Petersburg b/lib/pytz/zoneinfo/America/Indiana/Petersburg
index 0133548ecac014f4b37f0abcd471a5a6b4e7ed5f..3082de00c2e0bfe89d4ac5e093d9e5921aa63610 100644
GIT binary patch
delta 316
zcmeys*T6qPT#$o-fdPa;pah6HHfmg9WMrK@kxe>+jfoK(WCMz_u~Psi7ceQXtX{yt
zF}aUPmxB>(Hv{A3gG^GG&e{BiX$dnu-J=Y150K_^4GuANbqUe&HP$oIGtluhG}JTH
HGvERMlF}S;

delta 275
zcmZqR|G+mvT#%iCfdPa;pah87H)>pAWMrEBmr<ILb@D<sVHZXwMph7JqX14WU{aWD
z#IDT=wuga{fdQM<o4+tEVWyegig3HRT!TYQU0p(Se2w*t^bB--4Gr}S^$fTGa?cvd

diff --git a/lib/pytz/zoneinfo/America/Indiana/Tell_City b/lib/pytz/zoneinfo/America/Indiana/Tell_City
index 7bbb653cd7ce09d88f8a1701853bfe92ac7db0c4..103c5cb31795edc15d548ef4ca71f1e04e2996b5 100644
GIT binary patch
delta 168
zcmbQjyM%XwxF8n;0|N+yKoSshZPe&tWM^e$Vq{`wnf#DZn1c<-WM^Y%oBV*)V)6$@
sj>!^i3M{J^FmOyZW3%LE1nUG6j9?Zv6E`nn5@9CZNG^ntlgrs;0pmRwRsaA1

delta 123
zcmZ3&JB4?GxF9D30|N+yKoSshZq(>uWMrDWpH-5Bm5Gswjg^gc@&nd{$u>;p9AH&I
WVsb5$45rS_tC&QX32JR;lLY`ZDiLD<

diff --git a/lib/pytz/zoneinfo/America/Indiana/Vevay b/lib/pytz/zoneinfo/America/Indiana/Vevay
index d236b7c07726828984d3afbfa872b3abeae3e809..315b4c45aef1f241d025900544133c085fe4f69d 100644
GIT binary patch
delta 268
zcmZqUp2j^vT#$o-fdPa;AP|T-Hfne<2C_0TF)}f;FtM>y2~Ix9sKBy%0RzY6`;5BW
dj9}{+7=bi4Cv3K5>S3a>8#rKYn4HZj4FDe?6r%tD

delta 254
zcmbQn-NrpZT#%iCfdPa;AP|VzH)?n=1~M@MAu|gTD;t&I<b#X~lRa3qIl&e&FfuS;
VvwO2EQx6mEEN6pQKDnAz8UXO=5Iq0@

diff --git a/lib/pytz/zoneinfo/America/Indiana/Vincennes b/lib/pytz/zoneinfo/America/Indiana/Vincennes
index c818929d19b2ca5925c181696f02a2ba93a7009a..35a24133446b9ee1e8f8a7931519d93517130315 100644
GIT binary patch
delta 279
zcmbQoyN-8)xF81u0|N+yKq?S(Y}A;+$jCbRAfvo18#@p(GBJW_5Stu0S(QnFW%U9E
zj>!RRy4;Llix?PzG&ajOFJ#hTrkU-^NVapi28Wosx`gQX8tWP98R+;L8tNJ98E^pr
DDjgYo

delta 264
zcmZ3-JCApQxF9<N0|N+yKq?TkZ`7E<$jCJLAfvo1D;p3pGBJW_5Stu0*@{hJasrz+
z8`uhl$#qOpn3ir{$)v+f3tJT-wlXp>aJdGDn7X=z==d7z8R;45_!=7O8R{8u0RU^z
B7Y+ab

diff --git a/lib/pytz/zoneinfo/America/Indiana/Winamac b/lib/pytz/zoneinfo/America/Indiana/Winamac
index 630935c1e1a8c1a87e728fc1dcc4c930e81b30e9..6d4e19377e9f70c3782daa223753c640c60ab1eb 100644
GIT binary patch
delta 279
zcmeyw+r&3PT#$o-fdPa;ARCA|Hfn5OWMrKz!=~!W#twvxOdyhcIJu2Yfo1gq29C*z
zOuF2RV2c<SfiyPDH}7YPVWyew%1E|zxdw-ry1Inu_!{dO=^5zw8XD>u>KSkW04i-6
A(*OVf

delta 281
zcmZqT`@}mzT#%iCfdPa;ARCC;H)?EPWM^UoLS~l94;f|M8JSqwfRK?1M3N6D_pvEV
z&ScW&1Y5<x$iRTj_RYtcVwh=Zy&~LtF4y1?Q&*P|9baQTBRvBhUqeGZLp=j70K?xH
APXGV_

diff --git a/lib/pytz/zoneinfo/America/Indianapolis b/lib/pytz/zoneinfo/America/Indianapolis
index 09511ccdcf97a5baa8e1b0eb75e040eee6b6e0c4..a84b6e99671f7305d1c459956e16a4dd772fc60e 100644
GIT binary patch
delta 321
zcmZqToy0pqT#$o-fdPa;AQ^}`Hfl^@<YZ=K0znqm$p;yQBiWeP*r@>j|6gy#!0`Y7
z&JBz#|NpOEz`!wCoynG$k%19xJDA4iqRrEpWSHscBvlkAak&PEn7X=z==d7z8R;45
N_!=7O8R{8u0RTxGC_n%J

delta 305
zcmbQl+r&FTT#%iCfdPa;AQ_0+H)>2^<YZz5LuQuA2N{KfS(#Ybr~v=}UvI_0@c;kL
z4U8<44cKhC85qIVf+%b***u>~hM7K2QATnKmuql{sjEwfj<2zvk)DB$uc4uyp`HO3
E0D)T}6aWAK

diff --git a/lib/pytz/zoneinfo/America/Jujuy b/lib/pytz/zoneinfo/America/Jujuy
index 604b85663672d83658f331a69cc8f41cf2a2b5a1..7ca0b46f680b80780981aab0699e64dd04070fe7 100644
GIT binary patch
delta 54
xcmbQi(Zw-AnbCTp$`?k)$%>4slMNVICc7~TPL5!VX0+bCh4BF+n#2ue2LO?-4r2fS

delta 70
zcmeC;n87hYnbBsV$`{u9|Ns9pPF7@8oNU0zF?lDm;N+9cmXo^~fzq4TGd^JCWB>we
GiW~uI?ibSl

diff --git a/lib/pytz/zoneinfo/America/Kentucky/Louisville b/lib/pytz/zoneinfo/America/Kentucky/Louisville
index 177836e4fd98399bd4cdda410648cc286408b95b..3a335b37165d2b3d6a09a1716cb158e272087c9f 100644
GIT binary patch
delta 443
zcmca2`b2bsxF81u0|N+yz$PH(*r;)aiJO^`2?AMICm-aLs%K+If{aLPWO3TD6;O@-
z|9|}~28RFtcWz*0`Tu|Q0tSxBC0w?=j0}umZ-8lRUfZn1GKF<W`i&Frx5+!WWB?Uw
BE5HB%

delta 413
zcmaDNdPQ`CxF9<N0|N+yz$PGO->7khiJOTL3Yl3ZGcrrmGcmHVAwg6gvJ7q50_et0
jF5nWGe1O@Moq-YT^2z_0r7^v-S&L-~>(KMd2`(7`-!B-s

diff --git a/lib/pytz/zoneinfo/America/Kentucky/Monticello b/lib/pytz/zoneinfo/America/Kentucky/Monticello
index 438e3eab4a6e581c6f5e7661098bf07b1a000593..576f16bb2b21a7e0871a7222241ad65e533bb93a 100644
GIT binary patch
delta 290
zcmdlWbU<i=xF81u0|N+yz!V_n*r*Z0#K=0?ki)~9osDX6vH-IJ%jyLT9Fz5!bvYQp
z)-f<nPGpwCbiw8x<|QmNc7ig@2|$|5H8{l7)g?s7*I3U;&p^l5&`{4%&wvX6<Ea_i

delta 277
zcmX>gv_WWsxF9<N0|N+yz!V^6->4D7#K<(cmdV4Ljg@L}vH-Kf<WC&hoM4L>7#SF_
p*}ZuR^AZ-?S*{4ToXa&h#MIR#M90@y&q&We$JfwM&rr{R3jlie7(M_1

diff --git a/lib/pytz/zoneinfo/America/Knox_IN b/lib/pytz/zoneinfo/America/Knox_IN
index fcd408d74df43310a9a85c475f83d545f6d75911..025d132dd48ba978c6fedf86d70173127be49d49 100644
GIT binary patch
delta 152
zcmew()FV7WT#$o-fdPa;U=|Q_Y}CkMVrOM!Vq{`wnS78*o{??xM<yd6`GLu9vJSHn
n%jyLT9Fu*RHMtqVniv>?G&X}aFJr#KLX=4yFq0-Ha!LaLn_U^_

delta 138
zcmeAX{v$L&T#%iCfdPa;U=|RwZ`8<PVrOCmLS~l92bts<StoyFG6IqxnCvF&Fe^=V
f;#B7ZD`#M2V8CX==5@?hSO^)x1~FoCA*VC|8HE=u

diff --git a/lib/pytz/zoneinfo/America/La_Paz b/lib/pytz/zoneinfo/America/La_Paz
index a10137243577a8b312dc463571c4c94ecd3bf1f1..374586ea67601c4512b52859ff4e73bb30dbecc0 100644
GIT binary patch
delta 47
ycmaFCc#Cm@vN$sX0|N^X3p4<U9dgs2?09$e3M11*dml#Ti9HHTAg1QT2OIz}j}4pv

delta 67
zcmcb`_=0hQvJ49Y0|N*PGysVma?_sdcz5+m{r~^}8JU<TTKO=tOl()+21+r&#WXp%
LY;+Aw>`b@-%m@^H

diff --git a/lib/pytz/zoneinfo/America/Lima b/lib/pytz/zoneinfo/America/Lima
index 3c6529b7567f032882863fcd48b790e0988261bf..c13bb6be45a3be6cc747d056c571623528dc1e34 100644
GIT binary patch
delta 58
mcmbQn+`&9SnNeV(iU&U<GZQkL*x&&aKiPpPt~$Aokpln>00{U1

delta 69
tcmeBRp2j>unNe_}iib%3|Ns9PnVC@F#A*+q<dF^u1|YzuU~)90E&xd^4!8gS

diff --git a/lib/pytz/zoneinfo/America/Los_Angeles b/lib/pytz/zoneinfo/America/Los_Angeles
index 9dad4f4c75b373635ccbe634798f8d9e587e36c1..610e7af5fc13d9784de30d272c7c39d7938873a0 100644
GIT binary patch
delta 134
zcmbOtwnS`#xF8z?0|N+yz%C$W+o<t|iJg^^iIIt!WwIdG`pE`B`T&<4+yDRl4GbKU
f?{P`8GlEnzGGf!d*@)!|D*^p%5dD*Xb4daKf-xG6

delta 89
zcmZ1?HbrcLxF9P70|N+yz%C$W-Kg<~iIHhCKiBoiZ@45`K;n}HStKwOZnk2%!iuhv
Hn_Ch9qWcdk

diff --git a/lib/pytz/zoneinfo/America/Louisville b/lib/pytz/zoneinfo/America/Louisville
index 177836e4fd98399bd4cdda410648cc286408b95b..3a335b37165d2b3d6a09a1716cb158e272087c9f 100644
GIT binary patch
delta 443
zcmca2`b2bsxF81u0|N+yz$PH(*r;)aiJO^`2?AMICm-aLs%K+If{aLPWO3TD6;O@-
z|9|}~28RFtcWz*0`Tu|Q0tSxBC0w?=j0}umZ-8lRUfZn1GKF<W`i&Frx5+!WWB?Uw
BE5HB%

delta 413
zcmaDNdPQ`CxF9<N0|N+yz$PGO->7khiJOTL3Yl3ZGcrrmGcmHVAwg6gvJ7q50_et0
jF5nWGe1O@Moq-YT^2z_0r7^v-S&L-~>(KMd2`(7`-!B-s

diff --git a/lib/pytz/zoneinfo/America/Maceio b/lib/pytz/zoneinfo/America/Maceio
index bc8b951d2e880182a369cba8fae1270e40694aaa..437a47310ec174736b0efbbe9e7e9a8cc26c150c 100644
GIT binary patch
delta 44
rcmaFCdW&^}GNa~1l{J$WFey%a&oTKBliXw(MxfYc2gU$Kgs2(-UTqHh

delta 63
zcmcb``hs<WGNaZ+l{GB&|NsA=JdsIx@&YEdi9ehewKiKb1~76k00F9$JO`JJu7R<g
GF&6+2eilyv

diff --git a/lib/pytz/zoneinfo/America/Manaus b/lib/pytz/zoneinfo/America/Manaus
index 63d58f80f556e1c3135d6dbcb2a2dfc6f61b4fc9..2708baea5af1d5169a1cebd00c4762d6bb937fda 100644
GIT binary patch
delta 46
vcmcb^a*kz!GNb%Nm6nMcq?s9+7$=@~Vw7LZ$H)lh%X4tq=o*;VnQ#FBI=l<a

delta 58
zcmX@da))JtGNZyol@^xz|Ns9_7Gx5itiZ%ES)ECK;!~i+VopXz4hA4VlT`-*LA4Ry

diff --git a/lib/pytz/zoneinfo/America/Matamoros b/lib/pytz/zoneinfo/America/Matamoros
index 047968dfff4dba196d5c9695e79cf28395d9a0aa..bbe04e86610a302d0a4deb36dd56f17673f2d3dc 100644
GIT binary patch
delta 339
zcmaFI)x|wQT#$u<fdPa;ARLHUHfkg>)-yBF0RI2KWCjDn|NpBOFtGgpzjFg42ZZh8
z8^Yim48$%W3=E7wH!w0WFko}qW>uzrOatvUDFy~Epli*5uGR51)-%#G(D5}i)HBpG
G-~s^A11?_x

delta 314
zcmeC;e#bRIT#x|?gag^k8#R&`>lvA70RR7A<iNo2|NrU*3@rcu@7%!1;o}>^;2aFZ
rE+GsdQJHB*P{&N<;l^~>W@Dy(OatLEE}#?5fKJr$HP)M4$I1f$jl(A4

diff --git a/lib/pytz/zoneinfo/America/Mazatlan b/lib/pytz/zoneinfo/America/Mazatlan
index e4a785743d75f939c3e4798ebe7c79d38e4cfd08..06fa22749d0a3157b5a693f0797086f78e1201c5 100644
GIT binary patch
delta 340
zcmeyy{eokHxF9<N0|N+yfISeiFVtYHXJlewW?^Ds1(M{z|NrOMFfjc8KX(EH%m4qY
z7cg*uNJbu*NPh!^0EF%18^Yil9KzrX#J(;e3;{rzfsqI78U{u%h0TqdW10R8xGRN_
LUC9OXg*g`houxpM

delta 741
zcmcJM%_~Gv9EN|FX_|(bGd4<*g#|TTGet_11(TH<n!6e)3ub(cF+Qd{zV0byhht?!
zk+PYEA}N1>Vx!20Y;4R<Q5K@(yw|8%SXl6$PS5EqpC|8mEfbY~Dq6pKyLam~d$1wG
zhT8lTuNV-C>K95pw~OJA8ydN)6QlPhG<N6~<7d}AxsewW`^P+$z7Ufun>-zRWK;1h
zpKd*8Go5{WwkpRmjTU9zR+;6Ck#(D5*{3kgo%XW%%NknPONzw<qNU|-VXr-qR^lAH
zRCE2qk#Z|cB;~dsmz233@<_SPsT^;Oef@VCCK<k{Nge9;sB1(_`bpE#o%XKTkOx^H
zgkg{dLYzY-4}?Gr5<!T>AQOa85K=*i1tAxNU=Wf)CEDhAz%~fuAgqHh?@-wXQNW?9
z0HOqj8X$^br~;x4hB{zTp+X@0k1PGUP$5w5cOkD4HCt4wfYGFf^kBdU1@&e<==}t7
Cn5S<5

diff --git a/lib/pytz/zoneinfo/America/Mendoza b/lib/pytz/zoneinfo/America/Mendoza
index f9e677f171b3900dfd978eb8ea2aa226557d2c5b..3232c80e2003489921578f7acbabc73fb9148205 100644
GIT binary patch
delta 58
zcmdnOv5aGaGNbK8l|PJ(lMgb>Pj+DBn*4xScybbBG^6e2eT*L%F(fP|>#%SD03{_6
Awg3PC

delta 52
ycmZ3+v4vxTGNau@l|L-?|NsA=tiWhHIfgNY(Qflj#t)1f3_yS+ZaG<wg#!Q-zY@a$

diff --git a/lib/pytz/zoneinfo/America/Merida b/lib/pytz/zoneinfo/America/Merida
index ea852da33a81478433a389e2b4da03b425d9f764..17654cb59991e52537f87d9d9a2b56396f9c5c7e 100644
GIT binary patch
delta 196
zcmeC<e#1UNoR^h>fdPa;z;dF>8%ste7G|>G<ok?zTnvmLgFpnj*_#cSE-+GNx&Xp-
KF6ZD7GcEv|yA5Fg

delta 618
zcmb`@J4ixN9LMo<bqI_Q8Y+UemcVXTFo%X9j3DAdln}H;P@37}*h93}JrM*gk~lX-
zk4cEOYR$E%DWR=V=+qQJ(EVN-q}ktr`-QvxKeeVp^KpBNsM}PryXMUGM8*7|PbXR@
zRI=+$CqE-<;isZgPi<=P^-`y=zSL6XUM?4_YUTVwu4e9(JUo(_=@+q<NXzwsTd^@>
z%gxRck?l+A?6)Iw!7-hy&Wikduim<eiS37=-Z`C7yX6nPcQB-!!m~DfhTnbTd>Z*m
zWxrY4H~w9EeP%ow4!3hJ<7Ud;l-s?!_frfg4ipQD2gQWqLb0LvP>d)}%(Zg7AAm8?
zC~yosuPz`1(W?u|z@&gOP${q!TnaF)L;mv}Z5TAj9f8<nJQ^F0hwO+MHm#5yw#<Ih
G3j6{IH;Zuq

diff --git a/lib/pytz/zoneinfo/America/Mexico_City b/lib/pytz/zoneinfo/America/Mexico_City
index e7fb6f2953d123efbc2550f450decd794b017d4f..68176daa4976b015fb79026f3053e74e4a7457ab 100644
GIT binary patch
delta 383
zcmdnMbBuF>xF`n$0|N+yfC~_V*b*Cc1Q_cXnOK-vm{@_34NQVqq{9FI7xOSM{Qp09
z0t3tc|Em`;aDYfg9+=3^4U7W+{{u-8h^&uq2!n5M2!nHQh%AGz3y=ZA;UNqRj35UB
a0hGq&^35eo3QPm-bY;9w=K^}pj0*tXyh%?0

delta 714
zcmcJMJxBs!9EaaKZAb(qvLGm01G^N=p&<yPrEW<faEYQcvybab?DGzSpe2gtrl6Wa
zY3gImHK-|}t-ZIV2*Tb+8eD4gcl_@;ZhW3nW5Ija8W1&`RNoEinu|fdW>0lR#dN<e
zQ%$2zy8TtAKO)Y|cS&X*Tb$XK3z;o`I&-CaYyPP0ES#NNi%WNowYP6AC7;D|Dr>Fu
z-HO#A(^_jg5xJg>%zfD+?;Do+@`PA_>y{fgF|qmJlUt|b&i3WI+}Ry)?1Lw%={&Ba
z?$X`r>hK)fTA<^)pm{45_4bdL31P+)BE}7>8%v14%v`zkPTj^CdKiiznjosGRJtI_
zAle}6Ao?H*AsQhnAvz&SAzGPIYgd2Zm*E)Vnc=!h<(uKWO68s59^#+T0MY@{0@4H4
hH2F;uuTzug|4lq9P*ep9nh_&xgo0)`Wb_&#&kx-$oP_`Y

diff --git a/lib/pytz/zoneinfo/America/Miquelon b/lib/pytz/zoneinfo/America/Miquelon
index b924b7100438cfacf25c56c494fd1abf3f262100..5eccd861071d4eccb76fe0d8f5195bd1a7f646b7 100644
GIT binary patch
delta 39
pcmZqT{lYUrnK5Id$_mEG7Z@`p+p%d(PGka#Y;I-pV1^30000e@4C4R*

delta 63
zcmeyu)5JSLnK5&t$_hr-`v3p`Gfuw9m^}FbBg<rcHqFT~OhCEK4NM-)oD4vKuD}%l
D^fDH&

diff --git a/lib/pytz/zoneinfo/America/Monterrey b/lib/pytz/zoneinfo/America/Monterrey
index a8928c8dc94aaebfaf9cdeb93011d41b482a4cc6..5eb723c80949d0cf2a99603ea6aba4688ade6b21 100644
GIT binary patch
delta 262
zcmaFIb%lL`xF8Dy0|N+yfF%&KOw@Rh%E-h_9{m4*;THym|NmDnU|{+Gf9D294hY-F
kH-y1C7>Hd$7#J9V)&Ma!%Qvesong$Ti}hSU_n2`30D`e9)&Kwi

delta 675
zcmb`^&nv@m9LMp`7e%`)4wQ1I=4-3j!9i(q;d^1FT%_2{nD6{p^Yi;DrCelxz={+~
ziJbhn+DR!~tlS)&_>hB?zP`_|9d?iluW$Q4zwP*V-&Q_(HtMQH$@-n|@@(UyHQW>u
zBkg4>TGK0I4G${z8kD1-c@@8|m1FmNDsl8K$MYBFM7AK4JG<s&>Rg(uYi4TTPE17;
z=5*VcnCUXi+4`JFx5QQY!x9;9x5^ZT#N2bUnm-MTg)6UG+#Zxm2QO-Qr9)clH%cpW
zpX7J`?`_*#Z$jAi{-&s~?UO^Ts>g_kaG&$*jEJ8Uj&s_jW?_Q`!-HZ%adGR|P<$vx
z6eo%m#fxG_aiiE#{3wRZakSh&z+`|@P#Lgp9b5*mTL+l|O~Gb>Q_v~!6nt88fTFxr
fyvN@U@%sTh&Lu+5C45Fu59ofM5%BA+y5I8!tF@v%

diff --git a/lib/pytz/zoneinfo/America/Montevideo b/lib/pytz/zoneinfo/America/Montevideo
index 2f357bcf50da794541a518510777bd5c470b9b77..e7bbfbb8c332fee14ae1b4aa07cc4d128e6a3ca7 100644
GIT binary patch
delta 39
qcmaFHeS>>~GGo|Al?2Ag9gJa<?=!YChHXw|+Q9_nCQZJ_$^if&(GG6_

delta 53
ycmcb?{fv8pGGq8gl>|nX`v3p`PnKW}o1Dv<JlTc`D7-m=X$KPr0}vp|Wdi^beG?e~

diff --git a/lib/pytz/zoneinfo/America/New_York b/lib/pytz/zoneinfo/America/New_York
index 2f75480e069b60b6c58a9137c7eebd4796f74226..a8b9ab1992257d721ad627b14f535c3d4b020888 100644
GIT binary patch
delta 139
zcmca0{XlwxxF8z?0|N+yz#AZD+o-XHnUQ(&L>>bs7S_pvEZZkn@rq6E;#KElWMBj;
r0Fv0WZPsB;VaKXZ5w4HRH8{l7)g?s7*I3U;&p^l5&`{4%&wvX6q0|@_

delta 131
zcmaDLeL;GHxF9P70|N+yz#AZD-KepJd9omjArmtTklH@^7>n5CM=Xl$42&QpjM%hn
mHepR+$D&6bs)x%pIK<S|B}B*9SkFk$K*!h6P|r}$fC~UHpBN4R

diff --git a/lib/pytz/zoneinfo/America/Nipigon b/lib/pytz/zoneinfo/America/Nipigon
index f6a856e693420d6d989c45acff2c48b60db69186..6752c5b05285678b86aea170f0921fc5f5e57738 100644
GIT binary patch
delta 1350
zcmZwGSx8h-9LMoV$C;?e%IqbBLQIQnga|}~=BW+LdWdZGJVX&e9@;c8Cn~d`Fc>SS
zusxR+vl`PhwcYBWLDMYMj%DVS9osCIneO*K_0WLxxm*~0_<w&d#$B0wEZo&;u~>qP
zzlnQ|uiR3%JbSNOoXeVBbN*DZ^FoeIUtCe(ymWA#z8sY%u56sI^TsSy`3t7${GJ$9
z81`Hi)+dOoLs#WBk3(E<Ix24*A1{h3Qsm8yXjOb>xxBS$iMX9UN8VXDOL*3X%96;j
z;%<DuEVXG-7U2rfW$m@1-1<|Ozv@*LZEy7bBCo1^T&AnCZ>j1_r}cxB9QE+P9{nhB
zmwLP*SwC?ksiz6)@>y`4s)=4NUmnu3HvEUI6@#j7XPbWQY*zIv3cU?eFIK;qd&Jvl
z$*g`Gy4Cw`&MxOWU!H6V*&&)*4$J0(eWJxxxkbJ|yg{hk1lhWIf%uT&kRKOEiMI9Q
z<);~=MEk;M{dvN4)e#x2J12cpUA8{m_3O3jZm-il4JGQ!Q;+VgsuN#}YNbBw5q;Tr
z<Tuwz@jc~){E@s{{7g)fzvizI{f^c0cT}qS6Fg52j9jG#ekbX{j(8O_)EK9SYo;h)
zX_)rs`IY6QPmjoIRRO6=2TGr?ieVYFObMIwy|l+X6vd0I0q#uuO!s#Ce)lnZtkv)L
z<hTdyvF_1<|6J2=e75zb^&nS8E{j|jxiE5N<kHBsk&7c&M=p<C-_$4oslc?}m0<pW
z9C$$zNES#MNFGQcNG3=sNG?b+NH$11NIpnHSQZhYO<hJxJdl&Akra{@k`|H|k{FU1
zk{Xg5k{ps9k{*&Dk|2^Hx@eIHdNehfM7l)UMEXP;MLI=VMS4Y=H8r|L+BG%$MH<Ey
zBVz-XpO$$+&q&iq*GSt)-$>&~=Sb^F?@04V_ohbsNdL$NkR9;<{fvPZ3<4PiG7MxK
z$Uu;hAVWdMf(!;34Kf^LJf_BgkP#s}@~<==7!xndLGi$-_!z?i#)S+F85uG(WNgUb
QkkQ>v3A9@Ox4LD20f+35WB>pF

delta 136
zcmZ1`eM(@0vT8d60|P4%i!=a<c{?T-%-{7o;lvNmfYTix3N9&sDY%sI`@!Z5j4Vt{
z%q)`^@-(vi|G(B@@?Mr`O}N(oKv49q(E&t*i~!LfV?Z>>sL2!ABsOPqu&|&RVKKRn
GR{{X=lRq8+

diff --git a/lib/pytz/zoneinfo/America/Noronha b/lib/pytz/zoneinfo/America/Noronha
index f140726f2a6945357b325f0bb452dce7557bbff7..73b4b336ab55544e6061409261c16cacc39aff61 100644
GIT binary patch
delta 42
qcmX@Zx{q~&GNbxLl_irKm{b`VCog4^pDe@(6xwXY=)edUR0jYB{tFiX

delta 55
zcmdnTdWLm^GNZ;sl_f0o|NsA=T*#z8@tqT+#%4oC2SyGCAV3Jqb8y+{8W`CbaRC5H
CLK7_j

diff --git a/lib/pytz/zoneinfo/America/North_Dakota/Beulah b/lib/pytz/zoneinfo/America/North_Dakota/Beulah
index 246345dde7cada7b0de81cc23fabc66b60d51e79..33e317e25b127335de68052f57d33ceed620524e 100644
GIT binary patch
delta 228
zcmX>jbVq1{xF81u0|N+yz%(G{*r*Z1#K=0?n<LJgosBFw`2mLl%iIYJ9FzZX=yEfH
bjb>m3(%7uqJdJq^3l;6-fY~?MkW(4}upJlH

delta 234
zcmca3bVg``xF9<N0|N+yz%(Fc->4D8#LmPBgv>0HCo%<1p3lT)&c;d>oGitxFxi1w
en-gq210w?iHXAq3W8T6-Z7bOzR!(;0lm-BFLKNHp

diff --git a/lib/pytz/zoneinfo/America/North_Dakota/Center b/lib/pytz/zoneinfo/America/North_Dakota/Center
index 1fa0703778034551487b7b55d80d41ad220f2102..17fe13bcc1c73ecbc6738499667816f54c164e39 100644
GIT binary patch
delta 300
zcmX>jbVq1{xF81u0|N+yz%(G{*r*Z1#K=0?o5L!aosDL2@&gV9mbnucI41w&(B)<X
bThG7<q_H_^^EBoyEOd4g2h2^A4LPL&B77OD

delta 306
zcmca3bVg``xF9<N0|N+yz%(Fc->4D8#LmPBgv>0HCo<_xp3lS<&BjVII9ZBWVX_0W
eHYeB#42%p6*j%-F9`hEKfp8WZ#95OaIi&&Mm=<UN

diff --git a/lib/pytz/zoneinfo/America/North_Dakota/New_Salem b/lib/pytz/zoneinfo/America/North_Dakota/New_Salem
index 123f2aeecfc88f2e543f99d6a859e02788170852..12dbe801aeb06823483525727f6f6695dec1bc24 100644
GIT binary patch
delta 256
zcmX>jbVq1{xF81u0|N+yz%(G{*r*Z1#K=0?n<K!Los9}`@&gV9mbnucI41w&(B)<X
bTg1Q!q_J7Pc^dN;7Mj`40keIwA*VC|TP+xj

delta 262
zcmca3bVg``xF9<N0|N+yz%(Fc->4D8#LmPBgv>0HCo;KAp3lVQ%En3sI9ZBWVX_0W
eHYeCJ21W)3Z1!)S$GnAwwhmx}IAF3Pr!)W`XBBn;

diff --git a/lib/pytz/zoneinfo/America/Nuuk b/lib/pytz/zoneinfo/America/Nuuk
index 0160308bf63690a6dee51c3c8849f494a47186c2..0d2149cc0033785b517624400583fb9edf2ff2ec 100644
GIT binary patch
delta 53
wcmcb{cY<$%GGpmRl{<_~j4YEUu;nu|Gciy8&t^J#9TQMu^ChMY%&0Qq0J}~PyZ`_I

delta 51
xcmX@Xca3j?GGp0Bl{<_q_5c6>pTtx;`6HX@<dsZ7(amR>HZXHA00BZO8~`r?6<PoQ

diff --git a/lib/pytz/zoneinfo/America/Ojinaga b/lib/pytz/zoneinfo/America/Ojinaga
index fc4a03e36931bbca9b00e0344d3659e4af700be5..f81827e840b0156317cd9a6e85d49160aa5127bd 100644
GIT binary patch
delta 356
zcmX@ZeU4*-xF81u0|N+yfDI6HOw{;TAE(d2$i%|T!o&)M%s>W7km>*bc`^(P|NqaO
zz`*kV|LO${93YaB2PU#}1ET;;1SIR@8^Yil9KzrX#J(;e3?j}zf`Jk2COD1Ft(*Or
S9x@KJYo)NcmJ8??GcEwh+etS7

literal 1484
zcmd7RT}V@59LMp;vJ^2rL_wfLP#}aZH}f^KOlz4gOV?Uvx=J0((v>o-e0d;Ay7DPR
z0#gc-E+Q0>WdwF*cZGQo7Gy#8LKIjK38ts#d%6#TF8Uu1pTl<h{kbawbq?{ztI+?h
z)bE<X@W<fLw}v<2I*;#u!IW<-Hp4fzczMq54+%$8bTG~76<f<b1=ExE8X1n4GBawk
zk(Ka6WPOM=vKL;6obRjEw(v8NI~=37KkOHI-JjKtz7Dao@u|x1?324nhgCsMn=IUN
zP3<nMmV4rxm2*?Rbk1KjiXu14qUk1M-|Pxmd}C0RJg=0l)-JU_oF_{w1L{EU26-^I
zSe1pA$@0V$<vuhk-9O`%C;hSXyh}E`>)#6RM4WMCX+l)oo->Zl+!2+XQ^v9JE264q
z)Tkb)7e3ddI^NYKPo#{flm39LS=FOzoyD^DOGx>XQl$ThR|TTtW#C?pI`#gmtnWQ+
zoSuvmXF}OV!_b^)^duO;?kRCLebG4AI4YXfzBZamdqwlof(m7g$k5Cy)v~Tfwv0bg
z=jTK6!oV$caoQ_e+b^lMu^ic6RjWF#C(4LrJj?YH8S!r)(;P??!ZiDph&0W+H$}8*
zJ{XRO<vYUo{d<YaEnMYpQNUZMzxC_>i%Lv=l!DZP6oXWQlw+yup*;%Xs0b;Eqb8&%
zq$;E=q%KQc7*ZKWX-I7x#Ua&kl!w&EQ6N$wQX*0#QY2C(QYKQTr7jey)KZs<)QS{~
zREw00)Qc31RE(62)Ql93RBfrtM(VcIg(H<)>e7+gIf_TB=O`bkpJM^Y3OJU4tN~dB
zvI=Aw$T}?bLXeeM>ZKrSvDAw}R)Z`DSr5m8kQH$(30V`zqL5W_EDKqerCu1aGE2QQ
vWNnsuamebB<ss`s7Kp46St9<QYmCwJ%+#|?cBR=Iw$x;o-EOnnQe%DrGnt91

diff --git a/lib/pytz/zoneinfo/America/Paramaribo b/lib/pytz/zoneinfo/America/Paramaribo
index bc8a6edf1331b6912c26e81078b00c8e5d87ffdf..f1b82b4f9a546fd067cf043ba5d35da6fbe41fbe 100644
GIT binary patch
delta 53
zcmZo;`oTCsS%!syfq@l>g(kB0?bxT~edJP-&KBu?hC3LUm?xe!oLH*N$TD%J1~Zsz
F2>_QL56S=l

delta 64
zcmeyt*v2$LS&@~2fdPbtCbIVJ*r(-v<WiE(7U_M4JL>=c|If(8%renFgpqaP6b&Ar
KA_lnNeoFw392GMF

diff --git a/lib/pytz/zoneinfo/America/Phoenix b/lib/pytz/zoneinfo/America/Phoenix
index ac6bb0c78291f1e341f42c34639458fb385bf8ed..ab37e845566aa95659b7b85be0051d0c67a7e53a 100644
GIT binary patch
delta 134
zcmX@X^nz)ExF9P70|N+y05=e`PSh}9WSK0$sHE`!|J(@-96r7w48ATv91O(aAz+1!
WAd(TQ?#(d}-D-q%a{&!B=K=r{d=}#X

delta 102
zcmaFCbb@JuxF7=(;0Cf;CTbWkGEG)sR1)y<4Po$g0pegF4i90#s`_vYM70>YYA&EQ
Gb1ncA<q&TG

diff --git a/lib/pytz/zoneinfo/America/Porto_Acre b/lib/pytz/zoneinfo/America/Porto_Acre
index a374cb43d98bfbd06c82ca306a74f96993fd5657..cdda168cb97b1d45a4f1b7791a74523b74c88e6d 100644
GIT binary patch
delta 46
rcmeyu@{DDIGNb%Nm6nMcBv~1m7@3$SJ2Gic{00<UEXBx(ENTn@G*}B#

delta 61
zcmaFH@`YuBGNZyol@^xz|Ns9_+#ot}KigyjCYFiE{1_D$i!w5DFaQC%oc826CJq4T
C_!ip$

diff --git a/lib/pytz/zoneinfo/America/Porto_Velho b/lib/pytz/zoneinfo/America/Porto_Velho
index 2e873a5aa868c5605443c48510646f1408d58c4a..e00398602c634e6f1e9c0bc0e12b064f343ffe0c 100644
GIT binary patch
delta 46
vcmX@WvWaDaGNbH7m6}ORlFW=uj1vz!G0IM6Vf+B+%X4tq=o*;VnQ#FB8l(#A

delta 59
zcmdnQa)4!mGNar?l^T}%|Ns9_{>UiJ#K<&pj}uVr{|62RAV3k9=isu@H88O=;Q|1r
Crxd{e

diff --git a/lib/pytz/zoneinfo/America/Punta_Arenas b/lib/pytz/zoneinfo/America/Punta_Arenas
index 13bd1d9a7755df59c009b4c4e5fbe44257e7ab51..411a839b84d3c629bf7eb623024077efe614ed07 100644
GIT binary patch
delta 85
zcmaFI_l|Eu3Ck7n#||4yIv9l+nHZTFS(spunTeTY@_M$U$wKTQlTR`o04v<w$}GT)
HM`a8Eej5@Y

delta 85
zcmaFI_l|Eu$;OHfMzQ+;|Nk>GF)}l<Fu@=*6Z7N^Y)O*^*+VCvWIC{UA~O%O6ax_8
HRT~Qc6G9aQ

diff --git a/lib/pytz/zoneinfo/America/Rainy_River b/lib/pytz/zoneinfo/America/Rainy_River
index ea66099155ca930810062eebcfbc7fc99e97097f..ac40299f6b27043e8f2454ac594b0ec184c1a237 100644
GIT binary patch
literal 2868
zcmeH|ZA_JA9EbnMHxNb5#0UvYD~2Khis1`osbi1`>Jd@M)G)*{9^X)W!GDX1ep0i1
z8Aa--<yxV0DQY8Ab8h7vq9kdAsN_`gN!>yvPWN?JTU&l{>tnyO`?;R;d^qQPIoIW#
zp7&au{A+&Z35Ojthx=Y?E~TFP4W&m9rk7Rj&<_vZb&hNwsYla_-EY^n>FNG=oYS*9
zyESX)%9+VC-Lq59N^Reh?)UNg<(yQwbwS&tu3@8l-hABo6WQ*C`Yrn7t_@CoRiXa0
zZlTjqmZcZ-yiQ|LqFzcK=3Jf;u2&+1ou;Hw@^jCj?$wAexq7R&d(HfsYt=38^`=I-
zQG3j7K7LGo+4!Y<JHK4-#Ljl_c2CiJ{snTcC0FiW&6L)2$@2S&5z<yUP<)?+ifj!O
zPf44!TY6L4F9^{Nv$|-<^j7UOx>@~V>eavRDec_jum;E;4RCjAmxfK+weBkkJiJ7^
z9oQk=cfBJ$w!JNntXnKS3+KqAc^T4cT9O1MCrIz%k@8q%hy?c=r;q!$N=Um14Y?Jp
zeHuG!X!SjP;_K@gw&#L|?>MP_3%bjbZ&hf&DZfhpdEd!X@ip>v%IES-&=(RhV1q=o
zRcmCxLW!*3s{^iiWnk5N8dc-ypt7YJy?2rhE}Et>n}%v^Zh^!t>a9bPGG*wb7LAV>
zA;aQ+&}aQZC85u6lF-y9!|&J0h~o`1^86tgRne-6hdz+!*4OLvrK@Fh{$YKgxKv+E
z+o@x6R_WNm#X4^6L}%RX{gO0jzME9DO_BrC+~mD0B&9jled+xzI=*&-le)4{C+v%H
z(z3HOeREG|;;2NOwB(L6IW%0oQ)(S=t4A~9E1irhVUihk#?AajWLn!kcY1lFWYuqV
zvx|?(%T>$W895)zD`na4%+w<~tEAAGJ*Zq?&CPOh0@vuAq(o;<^IXl12zPQ%rf8m@
z$I1IFO6N6Qa$et@EN`6hx$_GK%9|Az-TaI|an>Jo7sTI`h4~-3i-M|UaaxJHxUE?W
z63U%|`ct|rc#X5HYL6DS%ypKRZPFFzQk<1VOLSFblv6Zgs;=JJ&1vVcul61Oy7}|%
zgRUJr{kN|NeaFK*^ZCkei1>U5c6&Pbe4lO?e|z86UVHrW`S?_?j2UarWOJsPlkPSD
zZV`{iV<F;w2s8N1axU+F7h(uYV+n{UAhv)Q17Zz`IUx41GzNiK1Y#11O&~^rSOsDh
zh+Qm=VIY>VG^T;r24WnDbs*+}*au=Dh=m{~g4hURB#4zDW`fws(ijS2DNAE2h^-*T
zf>;Y;E{MG#27_1(Vlqo(Gl<b3R)d%gTDx(B;h3=;!*mSWF^mVX9>jbQ`#}r{u^_~R
z5F1(=BSNeQF(bo{5JNI7$uK3umJDMutjRDZ!=4O-GAzn4Da57>qgooPLd*)WE5xu6
z%R)>Gu`R>65bH9`%djuQzzhpBOl)av3^B5$u`<NW3_C*%4Y4%D)DT-kj193i!`u*i
zGYk%~IK$)+n=_1VX{^pLJHze_!!s-oF+Icf5aTnf4>3Q){*VGdDgY^grKtg<2$rS_
zj51i7Ixq?WsRX1HkXk^B0jUP09FTfI3IeGJq$HN6CXk|7nyN6$VrlBaC=8@BjM6}A
z!zd1<I*jr_>H{edq(YDqL23jklBKB<q)e8kPLM)bno2=R1*sLISdeNl$_1$xqhOGV
zF-iuh8KY>HrfQI~S(>^*3TJ652Pqw-c97yhss||_q<--K0{&gV029YyCX!L9L!#rN
PW1>=HW20lEV*>sFRXeOf

literal 2122
zcmds%T};(w9LJwSHjzZhq!0;wDG5CwU?`gOCX7KI@#S~`A@c=8EaR8LNz~})#-uLN
zP0DmNj7GIqO^Ib#i|lo+mocQdTE(=MYi`t2d11*oJ)h^ctFGGm{`Wke|Nb}U=6pWk
zbq)9Dn}6(T_l3jS-Qj(zx~sFVOOL(%r+j+3a>M73kLj7&m*mXG2{wMlfKEtyLlR7n
zCfKLsnsXgG@tYGi@pQ9JI(5iSe&vu!I@)BfeWJ-sX^GhD8X{(Db)iizD>T<HPPI2=
zrJ9ski)32-s7Z~RCaJ%t==AefByI37z486;CB5f6&FFehW<)2OnftnA*4p39>}~Jb
zn+k@^&E?1Joa8r6=G=WYb8Jwv5;ohc;a;74vBb{ne_De>n<TsQ5zXl>mievKn%gl)
z^6H}|e`mZbD6KNLuD&P*nM=&V{4ZqD_%u^E{byTvVazPP@|j)o$vJb|x3Afy$49m3
zodfpvgTs2qvtsXTJgs-NJt=oryr9eK8l`xCo0b%>l9E5(GNswuZRyZaQ<hj^%X;^i
z@{v4y&vVb{^0O->w6{f9oXnMq+8SMXc#5oATBNI+FUgv;3=OY6E8)?AMhf~Q@>9C0
zO8?4MeQZqi*h#yt`v+4qe8kqaePr(K-)+~|y=3m|thF0LALz#R7TJ{Dt()s>q%Lv4
zZYeF2EhAgCJ~Kn=zbw~=@d0UgJ*e9*{3s6`E;A1f#O(IyJoC`;^R_XPXyo9B_ThqG
z&5p(w?at&u(^S!Jo5n^oTG%bo;Q`&1vR`)f_h`%It+KnbL-%}LE_+*>_0hhdw63qz
z$Bs;rxIkRss&U-^=@W~+TxCowcIrf6TrBqL^CsTEPxN=v@=(|;D|Tm%JC*LN47<Oy
zF#&&t|Ah)Mw;jK<-vUtrq6I_^h#n9{Je?-|5UN0QfhgnYw1KDt(FdXsL?ehw44oiK
zF|>lH#n20)7(+9NY7E^V$}zO_bm~F$gD42m5TYVPM~IRPEg@<$^n@tN&=jI7Lsw6y
zEJRyRr!GWah{6z!Au2<3hA0iu8lpBsZ;0Xy%^|8YbcZO<(B9Lj&(I%|07eENDS+ev
zk_1Q=AZdW)0g?zvCLpPR<igV>gOLqSmkvfgJY7N<8G)n(k`qW$AX$N=1(Fv?Vj!7;
zqy~~3PnR4>c065r82RyZ31Vajk|IWqAW33m36ds8o*;>WWD1fhNUk8sf@I6nr3;cT
zPnR%A#ynlhAUT61jgd7-+8B9*B#x0eNa`55gCviUJx`ZDNd7!s0wEdnbSZ@75Rybl
m79nYb<Pnlc_&>>Hf~)63SJ7Z-K~8>7ZZMRWmy?&1oA5XN!8Dlw

diff --git a/lib/pytz/zoneinfo/America/Recife b/lib/pytz/zoneinfo/America/Recife
index d7abb168a7434579852b7533fe062fed9297ec2b..5bf6c211c19b7cd37107a2e3b317c2a7195c2947 100644
GIT binary patch
delta 42
qcmX@Zx{q~&GNbxLl_irKm{b`VCog4^pDe@(6xwXY=)edUR0jYB{tFiX

delta 55
zcmdnTdWLm^GNZ;sl_f0o|NsA=T*#z8@tqT+#%4oC2SyGCAV3Jqb8y+{8W`Ida{&NJ
CNE0sr

diff --git a/lib/pytz/zoneinfo/America/Rio_Branco b/lib/pytz/zoneinfo/America/Rio_Branco
index a374cb43d98bfbd06c82ca306a74f96993fd5657..cdda168cb97b1d45a4f1b7791a74523b74c88e6d 100644
GIT binary patch
delta 46
rcmeyu@{DDIGNb%Nm6nMcBv~1m7@3$SJ2Gic{00<UEXBx(ENTn@G*}B#

delta 61
zcmaFH@`YuBGNZyol@^xz|Ns9_+#ot}KigyjCYFiE{1_D$i!w5DFaQC%oc826CJq4T
C_!ip$

diff --git a/lib/pytz/zoneinfo/America/Rosario b/lib/pytz/zoneinfo/America/Rosario
index da4c23a545b3603bcdd4555ba8feba117802e7b4..2ad6ea5db204d599266412558f5a1fae076fc41a 100644
GIT binary patch
delta 58
zcmdnOv5aGaGNbK8l|PJ(lMgb>Pj+DBn*4xScybbBG^6e2eT*L%F(fP|>#%SD03{_6
Awg3PC

delta 52
ycmZ3+v4vxTGNau@l|L-?|NsA=tiWhHIfgNY(Qflj#t)1f3_yS+ZaG<wg#!Q-zY@a$

diff --git a/lib/pytz/zoneinfo/America/Santa_Isabel b/lib/pytz/zoneinfo/America/Santa_Isabel
index ada6bf78b2815d3d99c97d521ab9a6b35c8af8c3..63dfdf48a68d02240737ecd6af081e02eb0b6317 100644
GIT binary patch
delta 551
zcmZ1`bWCW1xFiPy0|N+yz*Haxu_cyndr`2_Ac(1+nTdsol?_M?49vl1?f?Iid>9!1
z|DQX7f#v`I{ssmP7<=vnMjjBGQ2<PeKxBP<Ll}I6Ll^=;*ae8gfjA(9fq@a^XCMKk
cCy2{p4UGRl01A-J6PXvWjHnQq%*QDK004qi$p8QV

delta 519
zcmX>mv`lD%xFj0`0|N+yz*Haxu_cyn`_{10Ac(1+k%^g!g%wB)42;2M?f?Iid>9!1
z|DQX7f#v`I{ssmP5Sx()ObUQW5g*?W2H)Tih5!(D0pf5V4hR8xl7WE{LQW8u#p?P0
VKmZDW%?p_qu?*`Fn5@Ss0RTUKN9O<l

diff --git a/lib/pytz/zoneinfo/America/Santarem b/lib/pytz/zoneinfo/America/Santarem
index c28f36063bd264e932a1910861e884d2a1669b00..001638c2f2a964eb2cc75660f66a1bcc447d7a57 100644
GIT binary patch
delta 42
pcmcb`a)xDsGNar?m4?ZJOwvq@Op|q)R42X$3Qgu`{DBbD1pxVT3UL4c

delta 106
zcmX@Za*JhxGNb%Nl?J8y|Ns9pG2(&D6AyYY%1`EE{GrAG1jMLU<>0c>H88d_<^ljs
CH4$|H

diff --git a/lib/pytz/zoneinfo/America/Santiago b/lib/pytz/zoneinfo/America/Santiago
index aa2906063f3bb2be42e800c208c6a4453a610031..010c6bd04cae79078540da560ce38400bfe0ade6 100644
GIT binary patch
delta 108
zcmaDTd|7ycGUNP-Dxu8cR}D7SY-D7Xjdhr8z*Hf^$i&FZ$if7J%uLLzERzo~bx-zT
eE@zxS`3Un;ke1CkEUC<3Jy+O2;MSAFSqcEH7#P3+

delta 136
zcmcaC{7`s;GUI}YDxu8MCpT=Y*~rK&qI6)g0aJxk{r~^}8JQTF8CjTMkeP{@6^JK4
s<fxtefrDpqENAHC*~~!wllL<(1sSk8oh6kSY{Gf=4{{7ZK$IzE0L*?R#sB~S

diff --git a/lib/pytz/zoneinfo/America/Sao_Paulo b/lib/pytz/zoneinfo/America/Sao_Paulo
index 13ff083869a9ac8476775587de8476654a100017..67935ff4da8f527e03cd05ed2aa20e601e10f921 100644
GIT binary patch
delta 47
tcmZ3&J&k*UGGp{cl@i9u3mC(h8JQR-*Rsk_7Gna6Znk22z=R~M4gfe)3^@P*

delta 61
zcmbQny@Y#$GGoj}l@dml`v3p`PgZ30pKQR&GdZ7CezG7FP-?R&(*q_B1|UF_R|f!l
CG83%;

diff --git a/lib/pytz/zoneinfo/America/Scoresbysund b/lib/pytz/zoneinfo/America/Scoresbysund
index e20e9e1c4272adc40c07562bb3d6767cb056b550..286d13216eb3b14bf9fec1fceebf2fe731472d39 100644
GIT binary patch
delta 39
qcmeyv_l|FZGGpmRl{<`+=dqPeu42k&EZzK!X#+Eq>oGZoT>$_+kPhVl

delta 53
ycmaFI_lIwSGGp0Bl{<_q_5c6>pFEMRbTTWu=j6RiK;g{~nKm$UFaQCPTqXcnkQGV*

diff --git a/lib/pytz/zoneinfo/America/Shiprock b/lib/pytz/zoneinfo/America/Shiprock
index 5fbe26b1d93d1acb2561c390c1e097d07f1a262e..abb2b974a47eb3e5c8b4f5d4370baf4898b239ab 100644
GIT binary patch
delta 145
zcmeAXo+CU#T#$`{fdPa;U>*>&ZPch?;$~)Kf<PA5$s3s_PB!Bdn;gKb&dJEY2vh?k
pvFY5rjQI--F0G1itz5prA?Cg=Av(UsdPaH%I=+U6dWL!iTmY8~6#xJL

delta 141
zcmbOu+#@_eT#%K4fdPa;U>*>&Zq%q@;$~umLS~l98<{3fw&N6=9K)>0&cFy#$B0ee
n=5@?pSa4~Shic^V4GuB)bqUe&HP$oIGtluhG}JTHGvERMYMd1i

diff --git a/lib/pytz/zoneinfo/America/Thunder_Bay b/lib/pytz/zoneinfo/America/Thunder_Bay
index e504c9acf198fbd447221f120354774e46dbbcc0..6752c5b05285678b86aea170f0921fc5f5e57738 100644
GIT binary patch
literal 3494
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

delta 538
zcmZ1`Jxg$cxCR>o0|N+yKsOMB*b)suqF<%@!Rd|<1(%e+6kJO9J$XH&<l+mAO!bUR
z%q&c-0|rBot^WUiO$Y<S|NpBOFtGgpzjFfv$N&Gw4>0n8NdYh^;^P~_;2a#n;0nUw
zKpX(XE<kNSzz8KLh^t}^hyOrO^sY$<M1#U(@<cX?$(kG{n{zq-Fb~U+nB2!J0RZuE
BTpR!Z

diff --git a/lib/pytz/zoneinfo/America/Tijuana b/lib/pytz/zoneinfo/America/Tijuana
index ada6bf78b2815d3d99c97d521ab9a6b35c8af8c3..63dfdf48a68d02240737ecd6af081e02eb0b6317 100644
GIT binary patch
delta 551
zcmZ1`bWCW1xFiPy0|N+yz*Haxu_cyndr`2_Ac(1+nTdsol?_M?49vl1?f?Iid>9!1
z|DQX7f#v`I{ssmP7<=vnMjjBGQ2<PeKxBP<Ll}I6Ll^=;*ae8gfjA(9fq@a^XCMKk
cCy2{p4UGRl01A-J6PXvWjHnQq%*QDK004qi$p8QV

delta 519
zcmX>mv`lD%xFj0`0|N+yz*Haxu_cyn`_{10Ac(1+k%^g!g%wB)42;2M?f?Iid>9!1
z|DQX7f#v`I{ssmP5Sx()ObUQW5g*?W2H)Tih5!(D0pf5V4hR8xl7WE{LQW8u#p?P0
VKmZDW%?p_qu?*`Fn5@Ss0RTUKN9O<l

diff --git a/lib/pytz/zoneinfo/Antarctica/Casey b/lib/pytz/zoneinfo/Antarctica/Casey
index cbcbe4e339d934f57725542db534641292fd077c..4b98133d7af497a840e2630bc72a02439c4d774f 100644
GIT binary patch
delta 51
ocmZo*{=_svnUQCriUl_#6C)Ed5Ch?4M@G|$3qj&XGtk8C0r%1fod5s;

delta 71
zcmeyw)WAGJnUQy*iiJS^|Ns9PnHZUvffxiQrbhrJ4rGWh00E|?DHoTGwxOY&uAw0p
E0GuEYVgLXD

diff --git a/lib/pytz/zoneinfo/Antarctica/Davis b/lib/pytz/zoneinfo/Antarctica/Davis
index 916f2c25926bf444b7c366110a29a3fafb17fbc0..d4d47b24647bcabc981440f0859e94228428798d 100644
GIT binary patch
delta 36
kcmZ3<G@EIHG9&v$6%{r{21X`krisA;K<*L;827Uo0EhhtW&i*H

delta 60
zcmbQuw32CpG9$-C6&3FK|Ns9pGB7eRGcix}3jm7Eci?9L0u*swPA(g519LlFb1nb_
Cj1Nfw

diff --git a/lib/pytz/zoneinfo/Antarctica/DumontDUrville b/lib/pytz/zoneinfo/Antarctica/DumontDUrville
index 920ad27e629e350c1baac8537bb639a59fd19039..7be2474dd91c8a7da181fcda09d838254b890d75 100644
GIT binary patch
delta 33
mcmdnRxQ20pGA|<o0|OHfb2I>niKZ5eOcV1Y7#Sx{&;kHsg9aG@

delta 67
zcmZ3(xQlUuvJevk0|N+iGysYE|Ns9pPBgGkW(IOVm=`GUKWtkR2Z%0uyJP}T45Er@
HVv`mCnC%!F

diff --git a/lib/pytz/zoneinfo/Antarctica/Mawson b/lib/pytz/zoneinfo/Antarctica/Mawson
index b32e7fd6c6a3faddaa98dec06b88dcca3574486f..6d93f6e1d3f76bcb6325f503958d19798b098fa0 100644
GIT binary patch
delta 41
ucmX@kxRY^$vJevk0|PS<^E^^8YVf+H<iI#_zWl^UWk#lnwGxa#js^hEEDCb~

literal 199
zcmWHE%1kq2zzdjxvLMX!NWrMV>z0y3{r~^}8JU=1nnDs7SQr@G0vI@S4Gb8x4a|Vp
flp%x!gMsG#2N@1B5o7^~Cdv{n8=zHox~5zJ1<D+K

diff --git a/lib/pytz/zoneinfo/Antarctica/Palmer b/lib/pytz/zoneinfo/Antarctica/Palmer
index 3dd85f84ff48fb8553b4a964659872ae1fb7d33d..9c8fd317e0537afd4066001f6700cd6490fbe5a8 100644
GIT binary patch
delta 39
pcmeC;{=+pvnK5XiN&w^J`z%3|jaUOFOEUpQHrq4JV1f!o009073`hU~

delta 58
zcmeyv)x|wQnK5{yN&q8E{r~^}Czmh=O+Lz4!Wg{SifIND2Lliwi3f6U+2|S=+Zl5K
E0EF-qE&u=k

diff --git a/lib/pytz/zoneinfo/Antarctica/Rothera b/lib/pytz/zoneinfo/Antarctica/Rothera
index 8b2430a20eb481b488fccd5f1a966d06bfa214b9..241cc44d507c50777f7225df197765e522f22313 100644
GIT binary patch
literal 150
zcmWHE%1kq2zzZ0GvP?kC!ONt}0OA0_|NmDnFtF$v7%=D>7&C;BU<gPzPJ_5?fX3Mw
Ga{&Om6b{G$

literal 164
zcmWHE%1kq2zzdjwvLMXC%cRRt|NsAgMn;JG|NpOEU|`WTFksL%FlGoL!6cA=kZB-*
N+e9uKpt*L&TmTbL6~q7l

diff --git a/lib/pytz/zoneinfo/Antarctica/Syowa b/lib/pytz/zoneinfo/Antarctica/Syowa
index 2aea25f8c210369e0b805d0dd5f0e899190c2340..8c8062471dce91a5be827d6908795ee7391a4afc 100644
GIT binary patch
literal 151
zcmWHE%1kq2zzZ0GvP?kCaaG!E3y`CI2BciefPuxwH-tgkz?dO~1VjD<0ZxOsY=Fku
I=^AqZ09*+YLjV8(

delta 61
ycmbQvxRh~%vJevk0|N+iT$MK4Qvd(|f5wRh7E*9gpum5S3{V9FR919iA1448Z4=i3

diff --git a/lib/pytz/zoneinfo/Antarctica/Troll b/lib/pytz/zoneinfo/Antarctica/Troll
index 5e565da2f6b138b70179cb7e72347163ab44b6ab..a1dcea14de9cfb95311ebe94e8a1096c27800941 100644
GIT binary patch
delta 51
wcmeC;{KGLpnbCQpiU=bk^JGUxJ7z{E#>w@J0gTR@FEA=Fp$O_u&R|gj06HTJV*mgE

delta 61
zcmeyv(ZxAInbBpViU=cX{r~^}nI}6kT1{f%n5@g9J9#-HP-^pOMg=BL1|UF__XhxO
C;1ehS

diff --git a/lib/pytz/zoneinfo/Antarctica/Vostok b/lib/pytz/zoneinfo/Antarctica/Vostok
index 728305305df3d82fca7829ff3e9581583758dbeb..62bdcac14db3f464ff561e32db2c6b55c0cb1866 100644
GIT binary patch
literal 151
zcmWHE%1kq2zzZ0GvP?kCvEkpY6d)%^2BbVBfq})xH-tgkz>Fb;1VjD<0ZxOsY=Fku
I>6&o?0LBIr)c^nh

literal 165
zcmWHE%1kq2zzdjwvLMXyGNQAg{{R2~jEpe#AqfmDx&{Ue+6HC}AtaatG~_?XG>|#C
OP2{oxnro+P#svVn4Hz*1

diff --git a/lib/pytz/zoneinfo/Arctic/Longyearbyen b/lib/pytz/zoneinfo/Arctic/Longyearbyen
index 15a34c3cedb7c9ca519c195f5ec0ce9d8d1885a5..7f6d958f8630cba512d8e58ca8edfbd516291522 100644
GIT binary patch
delta 734
zcmdlY_)BntxG5(C0|N+yKtB+J*g_3JVm6O>!tATJKFqnfZo=FpTPMuhIbp*5mgy5t
za28IOXd_{AaoaS8OA-4TE-myIxST9K;flBNgsYYp6|SZ~pKx_WF~c>@Edtkdqy%no
zP7}Dvba2AWmlXmVCtPN%XJ&yzRz?t;4NS7IbI=8vqgcbhz|#TrEQ5>!BMSoqp8&}J
z$ZRbGMqUO65IMP!LsG!m)i(sBoRJZT7#SEQYctD*VhzIoK#;#E@dt<o1tpjU1}BIH
z1u2LI1uKXK1ucjM1uuvO1@YuMW|I_97=r{r;S8pMVGW`|;SHieVGg1};SQ#OVGpK(
l;SZugaR8!0@c^PhaRH)1@d2iRak5#BWij*cij;{Q$^ZmM#U%g$

delta 675
zcmew*xJ7V+xGFmX0|N+yKrax3*t`uuVz&BYhS^uD6HaXRO_=B-VRI>oUEuY4g$Zv~
z_z1k6VJq;iLr>s+g}lIr3;}_U5sU(#+&>9?Hh(PeMg5AvSMj3)-vmBP_^!_;@cqN3
z2^(izW~^sqX2Akk+2{l{kt||h;1U6PkwHd*k%fVQPk@0FMuJ2pD>6%hf`JhTCVMf<
znPLs2|3FamP9+CKgTe|-1H%hMgTid`US^YeP@sVXKmiA$L4gONK>-M&L4gROK>-P(
zL4gUPK>-S)L4gXQK>-V*L4gaRK>-Y+L4gdSK>-b>fq@P3n6R&l0Fc_8z%qk*hz9(1
G4rKsw<fyp-

diff --git a/lib/pytz/zoneinfo/Asia/Aden b/lib/pytz/zoneinfo/Asia/Aden
index 2aea25f8c210369e0b805d0dd5f0e899190c2340..8c8062471dce91a5be827d6908795ee7391a4afc 100644
GIT binary patch
literal 151
zcmWHE%1kq2zzZ0GvP?kCaaG!E3y`CI2BciefPuxwH-tgkz?dO~1VjD<0ZxOsY=Fku
I=^AqZ09*+YLjV8(

delta 61
ycmbQvxRh~%vJevk0|N+iT$MK4Qvd(|f5wRh7E*9gpum5S3{V9FR919iA1448Z4=i3

diff --git a/lib/pytz/zoneinfo/Asia/Almaty b/lib/pytz/zoneinfo/Asia/Almaty
index a4b00779005803d665d613e326bb77d86f45ebd8..91c916a3a5d7949cc304532fe3fb2eac117ab2ef 100644
GIT binary patch
delta 36
ocmaFLew}@SGNbWCl`9kf7*94}tYkFayozxFBZL<=`3^HD00&?VzyJUM

delta 50
xcmcc4{*--!GNZ{vl`Aau|NsA=_``Uz7Go8o$>ybu3m7>VfB+#JKKUFoCjcF56rlhB

diff --git a/lib/pytz/zoneinfo/Asia/Amman b/lib/pytz/zoneinfo/Asia/Amman
index 5dcf7e0977ba0faf59f44e2891d2eb39b11ba1f6..0a8e350a334bbee29b155fb9944c6831460d973e 100644
GIT binary patch
delta 158
zcmdnXH<NpUv>+P;1cU=A5L<AgP7LGZMmDL*0!$o}XS10wvQB=-CMV0lpk=_o>*E{3
p;OZI-B0?Cn4U9p085tR|nX~yK(+(y~gVgXE#AO3C)K1r!3jlD)8rc8<

delta 594
zcma*jze@sP9LI4V<%skWa;w1R<kIfYhNc$7K!?b&;R~Xd{mx9ZUl;U)#^74o0$Um*
zf|j6iiv9?{(iE6$Tl9P$m!OF5fqOmNO`rF9;68Xd)USEE&!z<TzH4JnIJu7&=O<c}
z=TEW+8)QE)6@5)EUOdsl>mx7jU(!;e&dYR6EA=B@ot&q&1Dn@J4!M+@=8fJ0m(v9*
zzoochq^R;7;i?{?>Xpv5woY3o9o~NF&`v2pySIMcn|UYatj%7bj@zRRxM6L4*eCux
zZc~Iq=}gv>OwQt!#TFrcn{_kgz4JQwk8Ke9lyW1)PNm!mu~#WKL+pmw4zVAi0YnFg
z77#ro9yEcni=!@xgAWL#l#w7pDP=5(U`iPcA{<0Kh=33gAwojLgx`X8vkEt;h5p;s
e{Mpqn3y)f8ZDg!yA{vibaU)}n$!j8J`o93TotuCF

diff --git a/lib/pytz/zoneinfo/Asia/Anadyr b/lib/pytz/zoneinfo/Asia/Anadyr
index 6ed8b7cb07634b9d669c6c36448fb8df0fdb32a3..35c531c0709fabace97e52cacef74b4cfbbcd820 100644
GIT binary patch
delta 39
qcmZ3&IgN9IGNZ#r6%NM928<4q3mIz}9X7vb<Y0nwqbAQ{;Q|2Qs|zsz

delta 53
ycmbQnxrB3qGNa>06%Iz0`v3p`Pu5{{m~6-rJ^2_TP<ZnzMh+$p1|UF^O9cSs91+_9

diff --git a/lib/pytz/zoneinfo/Asia/Aqtau b/lib/pytz/zoneinfo/Asia/Aqtau
index e2d0f919541fc9d64f01d8c6128c7e73a94869cf..0e1c16d32eca7652aa7e1392e606cf5b54e26bc5 100644
GIT binary patch
delta 36
ocmcc4ev*BHGNaK%l?xMp7){n@tYkFWyp(YUBZL<=`5ZGR0089;ZvX%Q

delta 52
xcmX@few}@SGNbWCl?yEO|NsA=Y{6_aIg>ejat$L;bn^nn8H^kZK!7Bd000op6DR-x

diff --git a/lib/pytz/zoneinfo/Asia/Aqtobe b/lib/pytz/zoneinfo/Asia/Aqtobe
index 06f0a13a662aacfa70c489d2fec5276362576089..3b5d6eb41883a7b32819f387b4c03c93e9d489cf 100644
GIT binary patch
delta 42
ucmey&{*--!GNbWCl`9kf7*94}Y+y9rypeGMBZL>r$z`K$U}~pp$^`&f_YMC5

delta 52
xcmaFL{+WG(GNZ{vl`Aau|NsA=?89t4xsEw*at9+&bn_a<1&kaFK!7Bd4ge;@6X*Z{

diff --git a/lib/pytz/zoneinfo/Asia/Ashgabat b/lib/pytz/zoneinfo/Asia/Ashgabat
index 73891af1ee95a4d5d602967fd5a965c8a7ec1327..2bd1cb3da0f5a11024f1609b09ae68645e6ae75c 100644
GIT binary patch
delta 83
zcmaFOa+hU-GNa@~l^h91W+n(^VMT&$>=V}(GfGZYWW0b!MF1z4jkbZQovtYt0Qocv
A4gdfE

delta 53
zcmcc1@|tCWGNaT)l^mA(|Ns9_oFF-IMKPn)WEsW_91K7J7YyL!ve7m$wbM1_0sub1
B6OjM_

diff --git a/lib/pytz/zoneinfo/Asia/Ashkhabad b/lib/pytz/zoneinfo/Asia/Ashkhabad
index 73891af1ee95a4d5d602967fd5a965c8a7ec1327..2bd1cb3da0f5a11024f1609b09ae68645e6ae75c 100644
GIT binary patch
delta 83
zcmaFOa+hU-GNa@~l^h91W+n(^VMT&$>=V}(GfGZYWW0b!MF1z4jkbZQovtYt0Qocv
A4gdfE

delta 53
zcmcc1@|tCWGNaT)l^mA(|Ns9_oFF-IMKPn)WEsW_91K7J7YyL!ve7m$wbM1_0sub1
B6OjM_

diff --git a/lib/pytz/zoneinfo/Asia/Atyrau b/lib/pytz/zoneinfo/Asia/Atyrau
index 8b5153e0545f550c6f9b0da9ce134a8a7a4ebe36..e7ea9c545a56ae0b0fabd02e47748004a6d87c3b 100644
GIT binary patch
delta 38
ocmcc5evy5GGNaK%l?#(SnT;mbFh@;pWdsUrUdcFv5h|1n00DXok^lez

delta 52
xcmcb}exH4UGNbWCl?yEO|NsA=Y{P6cIhQ$laswk!bn_C%8H^kZK!7Bd0st0e6IcKM

diff --git a/lib/pytz/zoneinfo/Asia/Baghdad b/lib/pytz/zoneinfo/Asia/Baghdad
index f7162edf93c28193436cc379c0dfe4185e368a42..c0e607234a07cd2650aabc1fd022bd5d4f99b175 100644
GIT binary patch
delta 38
pcmcc4ev*BHGNai<l?Rh!naw8KGsZHSZJx`xgAvNLntYC#69E5I3~K-Y

delta 52
ycmX@few}@SGNbuKl?N>K|NsA=9KdWg*^)7i(R}j^#vP0t3_yS+Zaw(`GbaETMH4yz

diff --git a/lib/pytz/zoneinfo/Asia/Bahrain b/lib/pytz/zoneinfo/Asia/Bahrain
index 63188b269d077e29f48a42a03c2a52aefdb61320..098997e7dd972ca4acedc535c4a645ee966baa33 100644
GIT binary patch
delta 41
ucmX@kxRY^$vJevk0|PS<^DO){*MOyK(gDVa^W`T-Dl;-otd(E{ax?(rk_&kN

delta 75
zcmdnVc${&9vN$sX0|N;2Ec`UrfTe5Ff%^ad|1&a8oG3prL|GXw3l#hhQUO%S08#~_
HVJbBMjb$03

diff --git a/lib/pytz/zoneinfo/Asia/Baku b/lib/pytz/zoneinfo/Asia/Baku
index a0de74b958e42ade6f93ec0c4bc06ae714d5c606..ae0ce4e7c3d273b537fa3653784e73be68ebb441 100644
GIT binary patch
delta 39
pcmX@jxtDW-GNaQ*6#>S{@+?l1lUNca-)01gZ2r$E!2}h`1OV{@3&a2b

delta 59
zcmdnXd75*AGNbcG6#+(;`v3p`Pc~t6nq11*!sxvD7o!9d2Lliwi6?S$*=QS>*y);Z
F0RV9)6B+;j

diff --git a/lib/pytz/zoneinfo/Asia/Bangkok b/lib/pytz/zoneinfo/Asia/Bangkok
index c292ac5b5f489a88bf10a1263b14e7412479d9e7..fa799db39e7625dd74bd9caa5c29b4819a7cbd3f 100644
GIT binary patch
delta 41
tcmX@kxRY^$vJevk0|PS<^E3d7MOo=b7$?q`pBSmk$TYE5f)U8k006%G3Ge^_

delta 75
zcmdnVc${&9vN$sX0|N;2GysW3S?NdW|NsBb$TV@H{KODtWw<O*@PF90)*~Pqqzb5*
Lp&rNvsnh@fh8!GV

diff --git a/lib/pytz/zoneinfo/Asia/Barnaul b/lib/pytz/zoneinfo/Asia/Barnaul
index 759592a255408caf354d0c4a2e406ee5a1638181..2f6b8101d474642410af84260fb2b88c493945b1 100644
GIT binary patch
delta 39
qcmX@gxt()@GNbcG6%oeCHjK`b8yG7Yoj3ntRA7Q~!zS-x;RFEkJPZ8*

delta 53
zcmdnad6aX4GNa2z6%j_3`v3p`Pqtumo?OLP#pts6E29Dv2LliwiHA>K$HEB!15y&+

diff --git a/lib/pytz/zoneinfo/Asia/Bishkek b/lib/pytz/zoneinfo/Asia/Bishkek
index f6e20dd3a85eadd3dcc28cf59f3acc5b95584f0e..547fd5e1bd16152073f7237ad265b5c643e7cbfe 100644
GIT binary patch
delta 38
ocmcc4ev*BHGNZ{vl^c@-nN23QF?&p|WdsUrUdXtD5h@f2007nuk^lez

delta 50
xcmX@few}@SGNb84l^ZPe|NsA=_{U_jK4T7}>E=0%D;PN#fB+%vIr#uHCjb~?6m$Rp

diff --git a/lib/pytz/zoneinfo/Asia/Brunei b/lib/pytz/zoneinfo/Asia/Brunei
index 3dab0abf4ed950f46a23282c59f6f6fa3b6ba758..098c6a0b0afc2c3ef3a6937104d270074ff2a9b6 100644
GIT binary patch
literal 469
zcmWHE%1kq2zzc+cvTQ&sv9^nC!mf1pj{Vi@4f{V!2ONxD({S+Wf`G$z4;T(_yL{oO
zf^fsp8SDYa8QmF<S6W>-@%RkG$>{wTP96E*aN6c`!0Cw*43|7|KQJ;gp+FX928Q$k
zkQ*{97+4q>N(~sf7#Io~7z7v?>LxIVK-fOMAq?6E=Eep<(!vN#0$G*}Atd<VKM;U?
z0ir=Z0ns4efN7wQKs3l#U>fK%5DoGjm<IX~M1y<@rhz^M(IDS~X`qimG|1N=8su{j
c4e~vR2895a28IHNrhZ6p*#JYvPS=7901$1h;{X5v

literal 203
zcmWHE%1kq2zzdjxvLMX2wu{MSSGs#g{r~^}8JU<E7_#?(G-g&XurM$bG%#@a_=YfO
o8<-m#07(mm5E6_An)n}NJctHa0W!B9$R@%XE*qd_cDfc^0Q8R~*8l(j

diff --git a/lib/pytz/zoneinfo/Asia/Chita b/lib/pytz/zoneinfo/Asia/Chita
index c4149c05ce2638c976aec0d18eb7567c7276bc80..75b3d7b3a6b3bf2b7459532fce1142912b897efd 100644
GIT binary patch
delta 39
pcmX@gxt()@GNaQ*6#>S{GAvG$<5^-S-(UoaZ2rS2!2}gb0|4#w3!nf1

delta 53
ycmdnad6aX4GNbcG6#+(;`v3p`Pv&QFnjF9qH~BInP<ZoqMhPYk1|UF^O9ue>e-dT@

diff --git a/lib/pytz/zoneinfo/Asia/Choibalsan b/lib/pytz/zoneinfo/Asia/Choibalsan
index e48daa82435078a2a731225ee963b30a48f78ce1..c5f4bb0b3858f7078b35cb7a63021d7dc0262605 100644
GIT binary patch
delta 56
ycmdnWzMOr6GNbWCl`Bk)Op_S3*jSjESeaNS>oX=X8gHJ&xPTE|+<x*JW=;TEU<)Du

delta 72
zcmZ3^zLkA~GNZ{vl`CxZ|NsAIWSVTqti{g4%)|<WljE7~CucGO<u~^-E@0$h00OM4
FJOKUG60iUO

diff --git a/lib/pytz/zoneinfo/Asia/Colombo b/lib/pytz/zoneinfo/Asia/Colombo
index 62c64d85dfbdc41ae8e78bc8304ceb35b16b4255..353fe2aa3564c79809e05e12711f90669e5e2388 100644
GIT binary patch
delta 43
ocmeyu^o(hOG9$-C6%BSqCT12UR<_BqjGhx0g2aw`Ac=(o0N20>vH$=8

delta 57
wcmaFH^o41HG9%|i6%C&H|Ns9pGBL9-v9d8u=4bSrI0qzgz(arm2+$<M0rheZm;e9(

diff --git a/lib/pytz/zoneinfo/Asia/Dacca b/lib/pytz/zoneinfo/Asia/Dacca
index b11c92841068c12a5d0102402127ff4537a66899..3cf597d83f90403132573d78247e6d02e66d0583 100644
GIT binary patch
delta 41
mcmcb}beL&^G9&v$6%{r{CT1oU*2(OQjuWSVgmyR}guDQ|P6zb>

delta 60
zcmX@ibdhO-G9$-C6&3FK|Ns9pGBGo;u(C|_O96^)cHn0K0u*saPA(g512a2aGcEuf
C`w!&+

diff --git a/lib/pytz/zoneinfo/Asia/Damascus b/lib/pytz/zoneinfo/Asia/Damascus
index d9104a7ab8cb13b4c87eb25ff633b03ec12ddd81..afd956c878856e0e239887963b32ddb8327ccf38 100644
GIT binary patch
delta 140
zcmew+c#&^{GG`?N0|N^X3vSeT!Z>*XQ-u~Y1A`I=P=rCtfDtGoqrkukVl(ji_=YgJ
jx(0)Y5C&}nV+LgHo3oftFoX0P6R)4k255?%t}zz?s(u!~

delta 532
zcmaLTJxjwt0LJl4qGF2{L_v^Ji;9E9npV109J@7gU<cg}d?~FOtuL{@W^k1v#Fq~s
zF5*(E_yI%^U9LEED+ekFf}2hv-jfbGNl1PnWVq*F34FF4^!iQ+A)35fOZv0oO!qgj
znZzTVZG2^!t}B{(xo26e!n3y*EcaCAb7w_1e{;kais!;QUFVC|zF69u<oPj6EKiN_
zl?WB9sR_CkhzVOyQ2V_@6k39`P>r&Uw{N<6-Ojci1l>OVU^|yzeAlir=di|A#k<^2
zHSdPi?hqk8&GJxWz)%_p35JO;Wu{3oIgUr#EvbFK2QSyuJI%r0I6cGyh!qe^JmngQ
zMV@jM#4?C=5DOtzLM(+?3$YktHI&O8?*r!J0}?=FfJosfb3i2VlvyCsK;(f)1d$0M
p6+|xhCs{q5;)c{5%8mYCj`(H1!5Bj7=5Qn)i4PgN88zx}{vXvkm@)tW

diff --git a/lib/pytz/zoneinfo/Asia/Dhaka b/lib/pytz/zoneinfo/Asia/Dhaka
index b11c92841068c12a5d0102402127ff4537a66899..3cf597d83f90403132573d78247e6d02e66d0583 100644
GIT binary patch
delta 41
mcmcb}beL&^G9&v$6%{r{CT1oU*2(OQjuWSVgmyR}guDQ|P6zb>

delta 60
zcmX@ibdhO-G9$-C6&3FK|Ns9pGBGo;u(C|_O96^)cHn0K0u*saPA(g512a2aGcEuf
C`w!&+

diff --git a/lib/pytz/zoneinfo/Asia/Dili b/lib/pytz/zoneinfo/Asia/Dili
index 30943bbd0a8251404c407cde82243294071baf22..c1af113af0a87e5c96033c83f199161062073bf0 100644
GIT binary patch
delta 53
zcmaFNc$IO2vJ49Y0|PS<^Gtdsapd$&qYvD#3<@j{&tza^Vw|{JeqypRBg@2g4Q4P`
F0|2jF59a^?

delta 67
zcmcc0_?U5mvLY)30|PS<^Gtdsapd$&qYvD#3<@j{&t$0o|NlQD6C=|^dnZQLiA@?j
NKt)J`@)OT+0s!rg7GD4W

diff --git a/lib/pytz/zoneinfo/Asia/Dubai b/lib/pytz/zoneinfo/Asia/Dubai
index fc0a589e2b22acd9a76e402f0e7ef3c7b0547148..b3ac791aef4e73d6d644c40c614f37f15d462cdd 100644
GIT binary patch
literal 151
zcmWHE%1kq2zzZ0GvP?kCvGCK(6+n*h4UlpR2L=`&-w+0E0~3Z25)And1UL=ivH==r
Ir)$Cm0Qy}Np8x;=

delta 61
ycmbQvxRh~%vJevk0|N+iEc`TcMg9N({~0G5SV+M|fdc<QGC&m!P+8H5eVhPN`xVOo

diff --git a/lib/pytz/zoneinfo/Asia/Dushanbe b/lib/pytz/zoneinfo/Asia/Dushanbe
index 82d85b8c1b387ffc54acf509ac75220465b64d4c..89e875beaef780b2ceae08ee4703cd813f33d6a4 100644
GIT binary patch
delta 34
lcmX@la*$<$GNZ&qm5hlKBqsl3^qBY&$ek?8cml!?1OVIO4B!9&

delta 48
ucmX@ea-L;^GNa@~l?;~p|Ns9_?2(xKp3!sS8=%-^0mc&?3_yU82m%1xL=(6G

diff --git a/lib/pytz/zoneinfo/Asia/Gaza b/lib/pytz/zoneinfo/Asia/Gaza
index 266981aaf2e79f5ab7f494c21b785b3531c0bc59..22c47593d4698743bc60ad98e60e45e3c48da7b1 100644
GIT binary patch
delta 420
zcmXw#yDtP$7)S5UNGu6rOA&>dossM&Bnkz(jZP&L#w^z3dTqvYZbT#^DveShL?I;G
zi$=B*e*n=T3h`B|*}^@O_}${%@|>@hsb%h(oOohVg02BGGdLt+<G3nzc1!WIU(MDV
zWUktw=3hRfbXivmkFH)kd{avo?|M0WQ2L;%SH@n=YH+RBynC}ge5^Ox&P}=ZO3FX`
zCTcm7=s7T(-zC|)9W~oe1=%^9R=YQz>_sCgK4}*><)luh(!Z71{c;gecE~`4AW{sm
zgjS9r2$5unLSz}j5NU=uM4k}<iGVRBe5ipGL8>5S32hyuFrlr4ltOAD#gJ-7Ii#Nb
bU%;_fu&)xPom6Yy?<w^8*<3c~<^ASA0d#`R

delta 420
zcmXxgy-Pw-7{_t%y~`~m%C?sF5>qjP)|MI~T3vde^7f{^i!aq3A`%>1a+V-yksSI1
zT!I#tmZqo8AR-7ATI_r;bk6WO<L`TVkzS-RWc%rXY)s~KbN*d2ZdJUAmUx}4Z2jKJ
z_VbGDyj{!geM0tHb<I}BC0D=FeXlDAm!2N3j_J|*k{-u@^kiXLPe)%hA6=CE_mdXF
zQ&MQxwD=j8QlqTpmoGW1-OBkxTP}(v@vD#GShjVu=JuPu^WiWgWDaAHLC7d%SfCk)
z3`9mELy@t_U}Q8h92t)U7(zs#PYDldkRqfCDGM}pNMWF<L`sobq!_72%8`2f{{h?l
Yg1OC%Yg;38$>?$-9!teiGs)TEKhB4WQvd(}

diff --git a/lib/pytz/zoneinfo/Asia/Hebron b/lib/pytz/zoneinfo/Asia/Hebron
index 0078bf01c3db4a013a599ca995fbb72b81460a47..0ee464803029ae4885814acae9e3291771401e62 100644
GIT binary patch
delta 419
zcmXw#y)Q#i7>7@9n+OR~-9!v#datBSNDKySjm;z$SBv^Mist&Ldm<tckw`l*8iW{x
z#4Z-;B>n(m!zA8x?%+H(@jJuwj?Z(dscPyz>4eiW;`a`lxsg%Hw@j%*PoEUNhtzyC
zAq(|xwfOcW#jB=TdXDSm!w<D``Ked)Pf8!u_1fgSDfu^g-F-A0W5;^4^TLz|uBH6D
zZ-VwC30{4(^;4AXy9u-Nl9S!@Syj1pWiJ?4;Ym{BF(>wL>NFBaC_6+TG7uq#R75Mr
zkb?*^Bq5><S%@%08Y0e+hXlZo3JyvjHIO1mRYY3`sf%a}A(fC)NG+t8Q4J|)|Miaj
b0sCraPNP<8?dr&S{kcIeok?fhtk?DjY50Ot

delta 419
zcmXxgy-Pw-7{_rvHdIJtcWY@cF%=_dZK)xmwdsM%+nZKa;!AZ0i2|3<p`0ZMT11Eb
z0GFV}rKRa<YlsM=rKQgILgx&hGycA(=G2^4#CWT}vOba3jk#Az4_3t;?~41Dk<Fi5
z*?L@-?UxJLxl71yx2c&+N3zXx-E+TXzvAk_N<?#Oi+ULU(xdq)Jsy45d~`wbpAT9H
zPfDTJ(BgYoO0BY%pFZTIaU-YqJvl3u#H+R?6g0ukmFW*KB47_gkTJ+0WR$NRhKxf7
zA|sKZ$XH}BG8!3<jJE^`K#vL@lpr-o5mM!A%aA%>TZmL5rARGOj8r4#_+M}A57=A3
YHvM{TXl!IQ8C^=mW2snbIyp1^2R@pK*Z=?k

diff --git a/lib/pytz/zoneinfo/Asia/Ho_Chi_Minh b/lib/pytz/zoneinfo/Asia/Ho_Chi_Minh
index e2934e371b6d5cf80244d8d55594f7094bc9cbb8..a213d290e1a920271e924506a57191f1f4bfc4c0 100644
GIT binary patch
delta 83
zcmcc5bdhO-GA}0s0|Ofni+1!lcTF@<;ALcDW?^CmLI#H9Z<7@nO(#xQ7KE$%4+LP9
KryVd<+5rIf4HGE<

delta 102
zcmcb}bf0O0GA|bc0|Ofni+1!lH%v585UT(G|34!WGYb<l5Hc|^q%cg3jSz$@1Iqpf
ZD?R2Q2GquYO}Qy2myNc8xt*>#7XUC&82|tP

diff --git a/lib/pytz/zoneinfo/Asia/Hong_Kong b/lib/pytz/zoneinfo/Asia/Hong_Kong
index 23d0375fba3377a3d513d849c0d29c82ad2add64..f9f7b134dd5c35e4718c6fa3697024cb95442c53 100644
GIT binary patch
delta 254
zcmdnYd69F1xF81u0|N+yfGZGlY}AlpbYy2@WdlMc7-VN65l(Jp)M8^`C}?0{nY^A+
joSzYBG$W7z(LjLB;>}+e4Vb8IvlyDqTpr#bx)xjj?LQI_

delta 260
zcmcb}xtVi<xF7=%u!9I7a0O!ajT$nHj*LvKY(U5agN#fh!pW_STCzUAAq*bgARG)L
h!b2FmfDABTWW;9oW@aV>ChAzOg4c2`ptE!>xBwX#6}|uf

diff --git a/lib/pytz/zoneinfo/Asia/Hovd b/lib/pytz/zoneinfo/Asia/Hovd
index 4cb800a9187901afa985f1ae67565d654021cabc..8b9abca344daf199b554888fc4fff562a7a18e4a 100644
GIT binary patch
delta 56
zcmey(_LgmeGNaK%l?#lFlNlK`CkrrgOx9-fW;EJd&Nzb+MNos2%SPM4+)me=3jn0T
B46OhF

delta 62
zcmaFM_M2^jGNbWCl?$x(|NsAIoGi$!Jz0Q}ZL&49=43xcpw#9f#u<#93_yUczz6`M
Cxf50Z

diff --git a/lib/pytz/zoneinfo/Asia/Irkutsk b/lib/pytz/zoneinfo/Asia/Irkutsk
index 4dcbbb7ea21e193cd2e2578a17bc955caea227a4..e74a4d3f6b3a799b0fd12272c3aae0f084fb2783 100644
GIT binary patch
delta 45
vcmcc3d6sj6GNaQ*6#>S{7K~1ls~Ni)oi?*GNiadV8Jt`;+6ESOx)xjjC#MT+

delta 53
ycmX@hd7E>BGNbcG6#+(;`v3p`PnKeFnjFoNIr$zVP<S&FlLQk70}vp|6#)SAArb2U

diff --git a/lib/pytz/zoneinfo/Asia/Istanbul b/lib/pytz/zoneinfo/Asia/Istanbul
index 508446bb6aee2841ab88e82607a6ad6e748e7db7..7c2336dd80c3c9cbf71cb53d2b2c1f89a65a8ba5 100644
GIT binary patch
delta 59
zcmbQu-^)KinX!1I$`wXN#>tFKT9Xg3u}r?h<}z84y>RkFCZODAR^|oF7?M>07Q+#g

delta 58
zcmeC>pUpo(nXzP}$`wYI`v3p`PhP-QJUNSLDr3ne<^{|g3_yS+T*S#`qitYpr)$gw
E0G=%r%m4rY

diff --git a/lib/pytz/zoneinfo/Asia/Jakarta b/lib/pytz/zoneinfo/Asia/Jakarta
index 5baa3a8f2ed24f68c49bd7e3ccd4772a8e734414..ec4bd5747a8c9c528dfd22c8e3171851784ade59 100644
GIT binary patch
delta 63
tcmaFN^q*;hI4e5?0|Wa+nI=9421Xzg2*4CvX4fK7R2i;tPbXb-E&wa^2lxO0

delta 34
gcmey*^q6UaI4c7POq6MYGfymH=L+|9(lzG-0Fo^S$^ZZW

diff --git a/lib/pytz/zoneinfo/Asia/Kabul b/lib/pytz/zoneinfo/Asia/Kabul
index d19b9bd51d701d8bfe7b3e95c9f6f3c736a9aeee..661efc83294edbe5f615daa87a1f4a5590aae167 100644
GIT binary patch
delta 41
tcmcb>c!+U=vJevk0|PS<^ECj83qP+rFiu>kI5Aq8k!fPR1S6264*<|)3cdgU

delta 87
zcmX@ac!6<(vN$sX0|N;2H2{eVKd(E~|NsA=k!hl-i!xjaDDpqEZPo%14N?MB$xshu
XgOn-qaoK1am>3(_>6%y>8*l*t8x9_Z

diff --git a/lib/pytz/zoneinfo/Asia/Kamchatka b/lib/pytz/zoneinfo/Asia/Kamchatka
index 3e80b4e09f792e37422ffafe42355aeb3e6940eb..99776f515fd53a86a6886311d91ff33b401396c3 100644
GIT binary patch
delta 46
wcmeC<Y~Y-r%;>ODg@bXj0i(m@LdGIShs{qIIhdeae=aT?Z9^kFT|*--03ntOUjP6A

delta 60
zcmZqR?BkrE%;>mLg@ci${{R2~lXVy!CTBAiGdga*&&a{V!2kqE;sIP-Hrj?pcDjZ}
FTmV^g5>5aB

diff --git a/lib/pytz/zoneinfo/Asia/Kashgar b/lib/pytz/zoneinfo/Asia/Kashgar
index faa14d92d58fa883c4203022e091dc9154ac92dc..62bdcac14db3f464ff561e32db2c6b55c0cb1866 100644
GIT binary patch
literal 151
zcmWHE%1kq2zzZ0GvP?kCvEkpY6d)%^2BbVBfq})xH-tgkz>Fb;1VjD<0ZxOsY=Fku
I>6&o?0LBIr)c^nh

delta 61
ycmbQvxRh~%vJevk0|N+iZ1}e;rT+i_|BMq2ETrI~K!N`t8K4RVsI2J3K288p_Z7PU

diff --git a/lib/pytz/zoneinfo/Asia/Kathmandu b/lib/pytz/zoneinfo/Asia/Kathmandu
index a5d510753f02d5dedcf1ffac153558466dca9b99..751cf4a8939e898f8abe4358a98b2a5f59f65e21 100644
GIT binary patch
delta 41
ucmcb@c#Ls^vJevk0|PS<3oQIp+af1nu!3=-l^Y||#6}55AWM1TF+Kp)#0sqd

delta 52
zcmX@cc!hC-vN$sX0|N*PEc{g4A}3+6qW=H?|BOr%P2CuoC)P-C0i_tALQ@R^mJSfJ

diff --git a/lib/pytz/zoneinfo/Asia/Katmandu b/lib/pytz/zoneinfo/Asia/Katmandu
index a5d510753f02d5dedcf1ffac153558466dca9b99..751cf4a8939e898f8abe4358a98b2a5f59f65e21 100644
GIT binary patch
delta 41
ucmcb@c#Ls^vJevk0|PS<3oQIp+af1nu!3=-l^Y||#6}55AWM1TF+Kp)#0sqd

delta 52
zcmX@cc!hC-vN$sX0|N*PEc{g4A}3+6qW=H?|BOr%P2CuoC)P-C0i_tALQ@R^mJSfJ

diff --git a/lib/pytz/zoneinfo/Asia/Khandyga b/lib/pytz/zoneinfo/Asia/Khandyga
index 72bea64ba83546e72ff9d6a4f9a9e64cc2d93b47..7cdc99a9803f4e1ce3c5f7f9e6cd761f178536ae 100644
GIT binary patch
delta 39
qcmey)`I2*jGNbcG6%oeCHjK`b8yF`sI&T(cQec8|^C!P!;RFEnx(nX`

delta 53
ycmaFK`JHouGNa2z6%j_3`v3p`Pu62`o?O6EF!>cDP<S&RlL8Y50}vp|RRRDBV-l+X

diff --git a/lib/pytz/zoneinfo/Asia/Krasnoyarsk b/lib/pytz/zoneinfo/Asia/Krasnoyarsk
index 30c6f165052efa4fbc176cbcf19b626b1615d88b..4c27b2decd1159cf47285f0b18b5ed5178641e82 100644
GIT binary patch
delta 39
pcmdnaxsr2&GNa>06&}XP{49=>16g7xUuFb~Z2rzDzyuXa0|4b43p4-#

delta 53
zcmZ3<xt()@GNaQ*6&^;G`v3p`Pc~q5oLs=z$mq2B6QckV2LliwiN{S|z`_Xt_i_?@

diff --git a/lib/pytz/zoneinfo/Asia/Kuala_Lumpur b/lib/pytz/zoneinfo/Asia/Kuala_Lumpur
index 612b01e71cf873b7f8a80d25d7906d77aa91ca5c..adb41cf4caca6096052d7a82cf6adb568f3cee3a 100644
GIT binary patch
delta 74
zcmey*^pR<TG9$-C6%8InCT12^Hdb~9hQ!#3vH5}=3=9k)tneQQ>db-{PrPe^rpSkr
N%SPM4!cNzM3jmIV5f=ae

delta 83
zcmey!^q*;hG9%|i6%E1q|Ns9pGBLBTvazzWGcd%5O_pKwnYct*kduLdfdhyYfC~QC
SnT4*Jc*8;z$Y;Q&BNPAv1s75P

diff --git a/lib/pytz/zoneinfo/Asia/Kuching b/lib/pytz/zoneinfo/Asia/Kuching
index c86750cb7d512966b1a8b19cb44531a618b00930..098c6a0b0afc2c3ef3a6937104d270074ff2a9b6 100644
GIT binary patch
delta 63
ncmaFNe3f~EGNaH$l>k9TW+oKKGI=he?Zo3C+1E3$%DMpnap($(

delta 77
wcmcc0{Fr%yGNbTBl>o8&|Ns9pGBcq-7Us$QjJ6XGfs{O(A;ka$IF-2p00jyWaR2}S

diff --git a/lib/pytz/zoneinfo/Asia/Kuwait b/lib/pytz/zoneinfo/Asia/Kuwait
index 2aea25f8c210369e0b805d0dd5f0e899190c2340..8c8062471dce91a5be827d6908795ee7391a4afc 100644
GIT binary patch
literal 151
zcmWHE%1kq2zzZ0GvP?kCaaG!E3y`CI2BciefPuxwH-tgkz?dO~1VjD<0ZxOsY=Fku
I=^AqZ09*+YLjV8(

delta 61
ycmbQvxRh~%vJevk0|N+iT$MK4Qvd(|f5wRh7E*9gpum5S3{V9FR919iA1448Z4=i3

diff --git a/lib/pytz/zoneinfo/Asia/Magadan b/lib/pytz/zoneinfo/Asia/Magadan
index b4fcac18e3540f029f01bbf2751045b3983d96fa..70c198baf743457c58a8fe4d1f28186d8541a505 100644
GIT binary patch
delta 39
pcmX@cxr1|pGNaQ*6#>S{GAvG$<5^-S-(UoaZ2rS2!2}gb2LSFs3!?x4

delta 53
ycmdnNd5m*{GNbcG6#+(;`v3p`Pv&QFnjF9qH~BInP<ZoqMhPYk1|UF^%K!lQ=n`oF

diff --git a/lib/pytz/zoneinfo/Asia/Muscat b/lib/pytz/zoneinfo/Asia/Muscat
index fc0a589e2b22acd9a76e402f0e7ef3c7b0547148..b3ac791aef4e73d6d644c40c614f37f15d462cdd 100644
GIT binary patch
literal 151
zcmWHE%1kq2zzZ0GvP?kCvGCK(6+n*h4UlpR2L=`&-w+0E0~3Z25)And1UL=ivH==r
Ir)$Cm0Qy}Np8x;=

delta 61
ycmbQvxRh~%vJevk0|N+iEc`TcMg9N({~0G5SV+M|fdc<QGC&m!P+8H5eVhPN`xVOo

diff --git a/lib/pytz/zoneinfo/Asia/Novokuznetsk b/lib/pytz/zoneinfo/Asia/Novokuznetsk
index d983276119c95872882589a9fdd829eb1f86f606..a5e1b79600d21019a3b93f3e2d796129d9b1d655 100644
GIT binary patch
delta 45
vcmeC>{Le8#nbBdR3J2q414f6*g^Wdv4x67aaxg);{+wJk+6Lx!y5?K}D<TWC

delta 59
zcmey*(aSkOnbC2h3I`)g{r~^}C+jdeOwML3W^~+qpOJ%!g8>MT!~;0FY_tu`?R3q#
E0AuA6q5uE@

diff --git a/lib/pytz/zoneinfo/Asia/Novosibirsk b/lib/pytz/zoneinfo/Asia/Novosibirsk
index e0ee5fcea981010008b7b9dc3af1cdd53363128c..4ac7582ad5ee895bf9b354436142fd7ece1996ee 100644
GIT binary patch
delta 39
qcmX@gxt()@GNbcG6%oeCHjK`b8yG7Yoj3ntRA7Q~!zS-x;RFEkJPZ8*

delta 53
zcmdnad6aX4GNa2z6%j_3`v3p`Pqtumo?OLP#pts6E29Dv2LliwiHA>K$HEB!15y&+

diff --git a/lib/pytz/zoneinfo/Asia/Omsk b/lib/pytz/zoneinfo/Asia/Omsk
index b29b7693118fb1ed214adb8a4e686172d0914b2f..16c5f3cfed75151d50ffc2dc483ac6279816a01f 100644
GIT binary patch
delta 39
pcmdnaxsr2&GNa>06&}XP{49=>16g7xUuFb~Z2rzDzyuXa0|4b43p4-#

delta 53
zcmZ3<xt()@GNaQ*6&^;G`v3p`Pc~q5oLs=z$mq2B6QckV2LliwiN{S|z`_Xt_i_?@

diff --git a/lib/pytz/zoneinfo/Asia/Oral b/lib/pytz/zoneinfo/Asia/Oral
index ad1f9ca1ca321f6852d1d654d1fb0b14c556330f..3b9ecacf6eef72366df1cc847c0d4666efc8a48c 100644
GIT binary patch
delta 42
ucmaFMexH4UGNbWCl`9kf7*94}tYtLbypC}JBZL>l$z`K$U}~pp$^`&dU=8X3

delta 52
xcmcc5{+4}$GNZ{vl`Aau|NsA=?8$6Axtck8aw{WHbn{Ba1&kaFK!7Bd0stbB6T|=j

diff --git a/lib/pytz/zoneinfo/Asia/Phnom_Penh b/lib/pytz/zoneinfo/Asia/Phnom_Penh
index c292ac5b5f489a88bf10a1263b14e7412479d9e7..fa799db39e7625dd74bd9caa5c29b4819a7cbd3f 100644
GIT binary patch
delta 41
tcmX@kxRY^$vJevk0|PS<^E3d7MOo=b7$?q`pBSmk$TYE5f)U8k006%G3Ge^_

delta 75
zcmdnVc${&9vN$sX0|N;2GysW3S?NdW|NsBb$TV@H{KODtWw<O*@PF90)*~Pqqzb5*
Lp&rNvsnh@fh8!GV

diff --git a/lib/pytz/zoneinfo/Asia/Qatar b/lib/pytz/zoneinfo/Asia/Qatar
index 63188b269d077e29f48a42a03c2a52aefdb61320..098997e7dd972ca4acedc535c4a645ee966baa33 100644
GIT binary patch
delta 41
ucmX@kxRY^$vJevk0|PS<^DO){*MOyK(gDVa^W`T-Dl;-otd(E{ax?(rk_&kN

delta 75
zcmdnVc${&9vN$sX0|N;2Ec`UrfTe5Ff%^ad|1&a8oG3prL|GXw3l#hhQUO%S08#~_
HVJbBMjb$03

diff --git a/lib/pytz/zoneinfo/Asia/Qostanay b/lib/pytz/zoneinfo/Asia/Qostanay
index 73b9d963efc99f7af196755a6b2be015d9cb7a67..f8baf676496adea298f078d6d5931ba7aa64e902 100644
GIT binary patch
delta 42
ucmey&{*--!GNbWCl`9kf7*94}Y+y9rypeGMBZL>r$z`K$U}mRl#svUb{tf{E

delta 52
xcmaFL{+WG(GNZ{vl`Aau|NsA=?89t4xsEw*at9+&bn_a<1&kaFK!7Bd4ge;@6X*Z{

diff --git a/lib/pytz/zoneinfo/Asia/Qyzylorda b/lib/pytz/zoneinfo/Asia/Qyzylorda
index c2fe4c144c82b300ff126ed44098ee2bf8d752d3..27b522a7d5e24eafdf29dd541ebbca69ce4db7b8 100644
GIT binary patch
delta 36
ncmZqV_{=^*nbBmT%8f~kCX;6~$4;Ka2;^_x#<+qJB9aCG=6(!4

delta 56
zcmey&-pDaQnbCBj$_<wK|Ns9_{9`g%pRtkAbn`~W6^tAVK!6aA<K(i@HZZl*HRS>T
Di;5Jo

diff --git a/lib/pytz/zoneinfo/Asia/Rangoon b/lib/pytz/zoneinfo/Asia/Rangoon
index dd77395b05a89b875683f8aa82062748f2ed504c..eef37b42e8a0e7179f8113bea01f4a71d668e8ef 100644
GIT binary patch
delta 53
zcmeBS`o}myS%!syfq@l>g&Kgw!cWD4r$7CXxHv2Q10xgj#IuGIOO+W}CeGAg26OEJ
Dq)-r@

delta 64
zcmeyz*uykIS&@~2fdPbt8i2&YPsM?!KmC!oI4k`_{r~^}8JU=wCfbKEvQC_$!2^_M
JfD7)o2LPku76JeO

diff --git a/lib/pytz/zoneinfo/Asia/Riyadh b/lib/pytz/zoneinfo/Asia/Riyadh
index 2aea25f8c210369e0b805d0dd5f0e899190c2340..8c8062471dce91a5be827d6908795ee7391a4afc 100644
GIT binary patch
literal 151
zcmWHE%1kq2zzZ0GvP?kCaaG!E3y`CI2BciefPuxwH-tgkz?dO~1VjD<0ZxOsY=Fku
I=^AqZ09*+YLjV8(

delta 61
ycmbQvxRh~%vJevk0|N+iT$MK4Qvd(|f5wRh7E*9gpum5S3{V9FR919iA1448Z4=i3

diff --git a/lib/pytz/zoneinfo/Asia/Saigon b/lib/pytz/zoneinfo/Asia/Saigon
index e2934e371b6d5cf80244d8d55594f7094bc9cbb8..a213d290e1a920271e924506a57191f1f4bfc4c0 100644
GIT binary patch
delta 83
zcmcc5bdhO-GA}0s0|Ofni+1!lcTF@<;ALcDW?^CmLI#H9Z<7@nO(#xQ7KE$%4+LP9
KryVd<+5rIf4HGE<

delta 102
zcmcb}bf0O0GA|bc0|Ofni+1!lH%v585UT(G|34!WGYb<l5Hc|^q%cg3jSz$@1Iqpf
ZD?R2Q2GquYO}Qy2myNc8xt*>#7XUC&82|tP

diff --git a/lib/pytz/zoneinfo/Asia/Sakhalin b/lib/pytz/zoneinfo/Asia/Sakhalin
index 485459ce0397787a099064952c66989712ae707f..beb77b449654decdfec1f6bfc16fafc8bc8ceeaa 100644
GIT binary patch
delta 46
wcmdnQxrB3qGNaQ*6#>S{7K~1ls~O7}oi=}Blwg8#gSohDv<(gIbPWx;05+%#{{R30

delta 53
ycmZ3&xruXvGNbcG6#+(;`v3p`PiAFtn(W3BGWjGUP<ZoOMhPYk1|UF^ivs}a#1ZiT

diff --git a/lib/pytz/zoneinfo/Asia/Samarkand b/lib/pytz/zoneinfo/Asia/Samarkand
index 030d47ce0785f3bdb75314e0d03fb20c3e0172d5..8a93767bfef2cecbeee15db413a0a7c277e761a1 100644
GIT binary patch
delta 39
scmX@evYBOqGNZ&qm5hlKBqpv*VU(E6$9MwFcI4!;(Kax((>3J+00z<v{Qv*}

delta 50
vcmdnYa*$<$GNa@~l?;~p|Ns9_zQ`ys`30lX#HT>P$()QQI2eEcNyZxh_%;**

diff --git a/lib/pytz/zoneinfo/Asia/Singapore b/lib/pytz/zoneinfo/Asia/Singapore
index 2364b2178b03853b1771cb3f34b964fdb82e2e91..adb41cf4caca6096052d7a82cf6adb568f3cee3a 100644
GIT binary patch
delta 48
ucmey*^pR<TG9$-C6%BSqCT12^Hr9y|B|!dJ4+KAulgmciz`{<~f(rl%0tux6

delta 57
wcmey!^q*;hG9%|i6%C&H|Ns9pGBLBTvazyH7H15cxCA6|!b5-o2+$;>0RJ%$=>Px#

diff --git a/lib/pytz/zoneinfo/Asia/Srednekolymsk b/lib/pytz/zoneinfo/Asia/Srednekolymsk
index 261a9832b3ee4bda7c9935b566a7f7f0e6489e97..d21e7eeed5408affb3277bde903d6f5f2090ea61 100644
GIT binary patch
delta 39
pcmdnNxr%dwGNa>06&}XP{49=>16g7xUuFb~Z2rzDzyuXa2LR=03pW4&

delta 53
zcmZ3*xr1|pGNaQ*6&^;G`v3p`Pc~q5oLs=z$mq2B6QckV2LliwiN{S|z`_Lp_uCSF

diff --git a/lib/pytz/zoneinfo/Asia/Tashkent b/lib/pytz/zoneinfo/Asia/Tashkent
index 32a9d7d0c9cbfa841cc4e922fd1b486a34b57370..a9f6cd93c849c8b1677bc54f8bb836c91b40d63d 100644
GIT binary patch
delta 34
lcmX@la*$<$GNZ&qm5hlKBqsl3^qBY&$ek?8cml!?1OVIO4B!9&

delta 48
ucmX@ea-L;^GNa@~l?;~p|Ns9_?2(xKp3!sS8=%-^0mc&?3_yU82m%1xL=(6G

diff --git a/lib/pytz/zoneinfo/Asia/Tbilisi b/lib/pytz/zoneinfo/Asia/Tbilisi
index b608d79748884c4a8271e695fe4ed992a91fea65..3b131bb10e100bc2dd619d57367a4e43c86e5316 100644
GIT binary patch
delta 36
ncmeC?_{%;)nbBmT%8f~kCX*L1CrzHt2;^_x&A5UQB9aXN>Y@y9

delta 52
xcmey%-pw&VnbCBj$_<wK|Ns9_j$<~NJdrth@+3x}=;m#VD;PN#fB;D@2LK@+6cGRb

diff --git a/lib/pytz/zoneinfo/Asia/Tehran b/lib/pytz/zoneinfo/Asia/Tehran
index 8cec5ad7de2f2c14dd4b0a6c375d7198ef7429b6..cc2a2c219b0c893cfa8187e962028eb19ea3425d 100644
GIT binary patch
delta 444
zcmbOx@_=)KvZgx&0|N&T%goBDJ+YtRj0f)&7Yn|%!aMjYiyZ_sP8|?<Yvmxgc8|wI
zk3aQ{%uK8-tjtUlLIwr{3!s%Cl7)f6-h&b707DA~J_ZK207el81`7uU31o2}-w=in
zAQsU!Ffle@&^9mzlcqqH3Bv?sPq-ic0|Ce%AR6QskR>4hfM}4PKs3l-AR6R1Fb(t{
fhz9v_^C_kuj05dUC2YRrvH|<rPS@DV*nkTF!0thn

literal 2582
zcmchYYfP499L66Mg&7_KDr+uXW>A2@`>OBl2?$bdK?RXRc}!GL6DS2rJfewdKnY<&
ziidzg(ZV2aQb-f(1|iY#6i{Yv;wHmQ+)Ul*xi06|`jWw(_s5^>8hp8adm?8ojk6g4
z__fGP9n5D)!Sc2GT&uGlaBROEnCulWC_BJsQ0KUSC!^xE^P~{vV!Nqby`EC;!&0?-
z>u&Y(>0SDjnirHuS+n%q6D_>5d+U)Kwkq!=oAg;wEque5X-nWOWwmtaQ6o~+XxHI#
zOy5#5=1#P>U2jw3!Zta!evlYfHBgQ}m?tI_1nP;ITKTO`mHr72M8KR<{c4!E3iKbT
zgM2Gg@YQ-L&xeUAb<<_Y(H0R}lCG!bJE&<}D&_RF@gi(VhYp{esAhyF=!l88)lAQQ
zGIFS!i0a>>qm5ZAy30|<{E;nQKbs}rsC5yuj-1f5izll&x!rPZMw*zH;-=@vA5w3|
zl<5T_78NV5$b}wpV$pLhda+Z!T6{lP#&tG{`1VG*q&Y$?t?ALr$~UXG_FCogoGOu!
z9;Xvm-c(7k1@i5vVd9-hL*)uvu~_+1giaoONu@Ys$dr3dBDJGRzuW4s-aGB5S5?=l
zw6Ya)b>UsHCaYMl-Qc0tC0>^67t9xSz3hA2_v-UlzYW7jU>)YCy<zwY!_hD%huaM>
z3=v>B8-~BMd-~z;r%sDBBF)Fc$7=O4KS!I-C_LsB`R^-hc(k$}^9xG@u{Qj7EDpr#
zKrD|m*9T&OAXW%si6GVpVv(e|N)XEgu}%;R1+h{PO9io35Q_z|S`f<xv0e}h2C-rg
zO9ruK(p)r%RfAYIh;@TlIEa;lSUQNcgIGL>)q_|*i1mXo0E7h~OaNg62qQpP0m2Lr
zc7QMhge4$M0bvUWV?bB~!W<CxfG`MzMWksG2%A6{1;Q#2W`VE^gkc~o17R8n+dvox
z!a5M<fv^vRfgmg-O%p-b2*OAZR)R1Sgq<J^1z{-&Q$g4Y!dMX2f-o0^y&wz*VKE4k
zNz-N!MuV^#gxMhM24Oe|%R!h9!gdhGgRmalFk>F?^q_0JH(Iu{ziGrX?7#0)$9!|&
zQ0AMv?=sK0zK;2pi)(p*(9oOrR#ndawu3hIKg_?zJTr3{^Q_f_nP(>yGXH4qZr&e<
z59htzubKTE-)Q!8huJg##CaR@JUbinyxY~xcl>#r_oo*EdGD;f#eV+LRQ3x>hBN<c
zXDRbtTVj~+Ue(ULaA_OwJ#%7t?+qQu{=SKM?C<vsV*dH_^~{U<KlHz-=K=HLuKVnl
zTutZw#aVCmzdTjRe(8}|<_C&8m><mD!MrSE2=hb9^~?{)hcW*uW;*Y$r?l`c7aQ3>
z;^D~tH_uiwuW%aAyyD&s=9QgE%)f0<<bCu^H*Zz5kNv80H}=2VbDsIJoY~Ber#mvQ
zUYX6jW?>fZ@1tFKpLp#g`zLL|?Ef&LoB651Y0PUK+?m(@b(neGjYGVDY_szIso@Iy
zx;l>i`Z8DM4TS~FPiF-)Z(QHRyeX-X_s_8rywA)q*l!NXVE?Se%KY4mRm^{JiD%x@
zr;~ZhotwPRcdX!j;o?yCFV+{ce@V?`e)+&<=D+4=FmKItV&1mq3Eu6A+j;*s*Ps30
y!|MK*x8&n}2S57j|INF&-vqv){k*K>tUl(?=KI;tGsHI5+cL^C#4^Tevftk%?{cC5

diff --git a/lib/pytz/zoneinfo/Asia/Thimbu b/lib/pytz/zoneinfo/Asia/Thimbu
index fe409c7a2a40294af6bae4523492be88d38a97bc..95a9de9657f5b8b15aacb6e05c085c7e11bb8f55 100644
GIT binary patch
delta 41
ucmX@jxR-H)vJevk0|PS<^Id%=TB4ZfyMl4zLdA*E%8X1C>m?Y094!FbUJD8U

literal 203
zcmWHE%1kq2zzdjxvLMWN^_ggiVxsSg`v3p`GcqwTFof`cH2Ov`umIT!3|v0GAq?6E
krp5+9(u^U51fzi_{s$QkG7n@0h$hk+E*qd_cDiO<0C>Y6?EnA(

diff --git a/lib/pytz/zoneinfo/Asia/Thimphu b/lib/pytz/zoneinfo/Asia/Thimphu
index fe409c7a2a40294af6bae4523492be88d38a97bc..95a9de9657f5b8b15aacb6e05c085c7e11bb8f55 100644
GIT binary patch
delta 41
ucmX@jxR-H)vJevk0|PS<^Id%=TB4ZfyMl4zLdA*E%8X1C>m?Y094!FbUJD8U

literal 203
zcmWHE%1kq2zzdjxvLMWN^_ggiVxsSg`v3p`GcqwTFof`cH2Ov`umIT!3|v0GAq?6E
krp5+9(u^U51fzi_{s$QkG7n@0h$hk+E*qd_cDiO<0C>Y6?EnA(

diff --git a/lib/pytz/zoneinfo/Asia/Tomsk b/lib/pytz/zoneinfo/Asia/Tomsk
index 670e2ad2ce22f08d496b42363caa2e424121b20c..a6e494a78cef4baaa30d06cea4186391788eb30b 100644
GIT binary patch
delta 39
qcmX@gxt()@GNbcG6%oeCHjK`b8yG7Yoj3ntRA7Q~!zS-x;RFEkJPZ8*

delta 53
zcmdnad6aX4GNa2z6%j_3`v3p`Pqtumo?OLP#pts6E29Dv2LliwiHA>K$HEB!15y&+

diff --git a/lib/pytz/zoneinfo/Asia/Ulaanbaatar b/lib/pytz/zoneinfo/Asia/Ulaanbaatar
index 2e20cc3a438bb2076bfc1856045075dd041cad3d..2aa5cc4b84d369b03684c30cdb66b7abf087f467 100644
GIT binary patch
delta 56
zcmey(_LgmeGNaK%l?#lFlNlK`CkrrgOx9-fW;EJd&Nzb+MNos2%SPM4!cNzM3jn0a
B46gtH

delta 62
zcmaFM_M2^jGNbWCl?$x(|NsAIoGi$!Jz0Q}ZL&49=43xcpw#9f#u<#93_yUczz6`M
Cxf50Z

diff --git a/lib/pytz/zoneinfo/Asia/Ulan_Bator b/lib/pytz/zoneinfo/Asia/Ulan_Bator
index 2e20cc3a438bb2076bfc1856045075dd041cad3d..2aa5cc4b84d369b03684c30cdb66b7abf087f467 100644
GIT binary patch
delta 56
zcmey(_LgmeGNaK%l?#lFlNlK`CkrrgOx9-fW;EJd&Nzb+MNos2%SPM4!cNzM3jn0a
B46gtH

delta 62
zcmaFM_M2^jGNbWCl?$x(|NsAIoGi$!Jz0Q}ZL&49=43xcpw#9f#u<#93_yUczz6`M
Cxf50Z

diff --git a/lib/pytz/zoneinfo/Asia/Urumqi b/lib/pytz/zoneinfo/Asia/Urumqi
index faa14d92d58fa883c4203022e091dc9154ac92dc..62bdcac14db3f464ff561e32db2c6b55c0cb1866 100644
GIT binary patch
literal 151
zcmWHE%1kq2zzZ0GvP?kCvEkpY6d)%^2BbVBfq})xH-tgkz>Fb;1VjD<0ZxOsY=Fku
I>6&o?0LBIr)c^nh

delta 61
ycmbQvxRh~%vJevk0|N+iZ1}e;rT+i_|BMq2ETrI~K!N`t8K4RVsI2J3K288p_Z7PU

diff --git a/lib/pytz/zoneinfo/Asia/Ust-Nera b/lib/pytz/zoneinfo/Asia/Ust-Nera
index 9e4a78f6a547de2a91e728ac4ab5ffa4884105b4..d05726aba9fd67bf230290b3e2d74b75e46ee214 100644
GIT binary patch
delta 39
pcmaFDd5v>|GNaQ*6#>S{+AL0!^H_2wKW7ArZ02T?V1f#j0RZuq3s?XE

delta 53
ycmcb{`Gj+VGNbcG6#+(;`v3p`PnKhGnjFuPJNXeKP<S&NlLQk70}vp|l>-3zG7=sD

diff --git a/lib/pytz/zoneinfo/Asia/Vientiane b/lib/pytz/zoneinfo/Asia/Vientiane
index c292ac5b5f489a88bf10a1263b14e7412479d9e7..fa799db39e7625dd74bd9caa5c29b4819a7cbd3f 100644
GIT binary patch
delta 41
tcmX@kxRY^$vJevk0|PS<^E3d7MOo=b7$?q`pBSmk$TYE5f)U8k006%G3Ge^_

delta 75
zcmdnVc${&9vN$sX0|N;2GysW3S?NdW|NsBb$TV@H{KODtWw<O*@PF90)*~Pqqzb5*
Lp&rNvsnh@fh8!GV

diff --git a/lib/pytz/zoneinfo/Asia/Vladivostok b/lib/pytz/zoneinfo/Asia/Vladivostok
index 8ab253ce73555cbbf42ec67a8560acef080fc480..274a10b43d8089ed522daf9ded5b6aa3653075c9 100644
GIT binary patch
delta 39
pcmdnNxr%dwGNa>06&}XP{49=>16g7xUuFb~Z2rzDzyuXa2LR=03pW4&

delta 53
zcmZ3*xr1|pGNaQ*6&^;G`v3p`Pc~q5oLs=z$mq2B6QckV2LliwiN{S|z`_Lp_uCSF

diff --git a/lib/pytz/zoneinfo/Asia/Yakutsk b/lib/pytz/zoneinfo/Asia/Yakutsk
index c815e99b1a8f2d4b9bd45d3a6f39c95db5bbf563..ae65a5f9b94d196b29b68ddec7862e098d829b59 100644
GIT binary patch
delta 39
pcmdnaxsr2&GNa>06&}XP{49=>16g7xUuFb~Z2rzDzyuXa0|4b43p4-#

delta 53
zcmZ3<xt()@GNaQ*6&^;G`v3p`Pc~q5oLs=z$mq2B6QckV2LliwiN{S|z`_Xt_i_?@

diff --git a/lib/pytz/zoneinfo/Asia/Yangon b/lib/pytz/zoneinfo/Asia/Yangon
index dd77395b05a89b875683f8aa82062748f2ed504c..eef37b42e8a0e7179f8113bea01f4a71d668e8ef 100644
GIT binary patch
delta 53
zcmeBS`o}myS%!syfq@l>g&Kgw!cWD4r$7CXxHv2Q10xgj#IuGIOO+W}CeGAg26OEJ
Dq)-r@

delta 64
zcmeyz*uykIS&@~2fdPbt8i2&YPsM?!KmC!oI4k`_{r~^}8JU=wCfbKEvQC_$!2^_M
JfD7)o2LPku76JeO

diff --git a/lib/pytz/zoneinfo/Asia/Yekaterinburg b/lib/pytz/zoneinfo/Asia/Yekaterinburg
index 6958d7edddb85d298c5f2b890b21d9ca2056e9c5..d4d19ccf1e91121589a7cabff444bc916f67f9ce 100644
GIT binary patch
delta 45
vcmcc3d6sj6GNaQ*6#>S{7K~1ls~Ni)oi?*GNiadV8Jt`;+6Ja}x~5zJCz1<h

delta 53
ycmX@hd7E>BGNbcG6#+(;`v3p`PnKeFnjFoNIr$zVP<S&FlLQk70}vp|6#)SAArb2U

diff --git a/lib/pytz/zoneinfo/Asia/Yerevan b/lib/pytz/zoneinfo/Asia/Yerevan
index 250bfe020ada912671d670e77403a269c74b658e..0d5f6853ac79c41fcb445a23062a27aca9e471f3 100644
GIT binary patch
delta 38
ncmey*@sVSKGNau>6~@UAne8Sku!K$C%Lo+M{E+bnOeh`z4rL98

delta 48
wcmey!@t<RYGNb)M6-Ji&|Ns9_R$;W8oXA+kXutUm;}1p-1|Wco3$i2t0Lk1D>Hq)$

diff --git a/lib/pytz/zoneinfo/Atlantic/Azores b/lib/pytz/zoneinfo/Atlantic/Azores
index 00a564fe4c6bd24337793b551c8b05ec58cc6589..10232ab38ec595b889167a3f0f037a940ef2ac98 100644
GIT binary patch
delta 38
pcmdlXy-Iq5GUNS?DlN>D*D&9o+{3b%@%~~1R(2?_Ve$-K1pqJq4@v+4

delta 68
zcmZ1_y+e9}GUJ1dDlN<$_5c6>XJlhyo@~gYJ~@nM%VbX8#>wogK<UNWtn54tK!8Qb
FLI59<72W^<

diff --git a/lib/pytz/zoneinfo/Atlantic/Cape_Verde b/lib/pytz/zoneinfo/Atlantic/Cape_Verde
index e2a49d248de086306d2dd16a2b2d497a008c8f07..0d0d31a2f092d03f8512ed9c34f36a3f3f21209b 100644
GIT binary patch
delta 53
zcmeBUYG9h6EW^UUz`zQ`Jd>WST5x9S9ED3IH3Hn?-yIm4m?vH|omi>N$TD%R1~Zsz
F3jmi*56%Dp

delta 73
zcmZo*>SLOqtjNm1zyQKLlb)?waAxWpg-azh0^H)?9qRx8|If(8%renFf{}IN3=JNj
SA_jz@DF>I0u7RPQAr}Bk4i)$S

diff --git a/lib/pytz/zoneinfo/Atlantic/Jan_Mayen b/lib/pytz/zoneinfo/Atlantic/Jan_Mayen
index 15a34c3cedb7c9ca519c195f5ec0ce9d8d1885a5..7f6d958f8630cba512d8e58ca8edfbd516291522 100644
GIT binary patch
delta 734
zcmdlY_)BntxG5(C0|N+yKtB+J*g_3JVm6O>!tATJKFqnfZo=FpTPMuhIbp*5mgy5t
za28IOXd_{AaoaS8OA-4TE-myIxST9K;flBNgsYYp6|SZ~pKx_WF~c>@Edtkdqy%no
zP7}Dvba2AWmlXmVCtPN%XJ&yzRz?t;4NS7IbI=8vqgcbhz|#TrEQ5>!BMSoqp8&}J
z$ZRbGMqUO65IMP!LsG!m)i(sBoRJZT7#SEQYctD*VhzIoK#;#E@dt<o1tpjU1}BIH
z1u2LI1uKXK1ucjM1uuvO1@YuMW|I_97=r{r;S8pMVGW`|;SHieVGg1};SQ#OVGpK(
l;SZugaR8!0@c^PhaRH)1@d2iRak5#BWij*cij;{Q$^ZmM#U%g$

delta 675
zcmew*xJ7V+xGFmX0|N+yKrax3*t`uuVz&BYhS^uD6HaXRO_=B-VRI>oUEuY4g$Zv~
z_z1k6VJq;iLr>s+g}lIr3;}_U5sU(#+&>9?Hh(PeMg5AvSMj3)-vmBP_^!_;@cqN3
z2^(izW~^sqX2Akk+2{l{kt||h;1U6PkwHd*k%fVQPk@0FMuJ2pD>6%hf`JhTCVMf<
znPLs2|3FamP9+CKgTe|-1H%hMgTid`US^YeP@sVXKmiA$L4gONK>-M&L4gROK>-P(
zL4gUPK>-S)L4gXQK>-V*L4gaRK>-Y+L4gdSK>-b>fq@P3n6R&l0Fc_8z%qk*hz9(1
G4rKsw<fyp-

diff --git a/lib/pytz/zoneinfo/Atlantic/Reykjavik b/lib/pytz/zoneinfo/Atlantic/Reykjavik
index 10e0fc8190a401f67b861ced3b8b16401432a565..28b32ab2e0b9053f39a91d9f28b6072e41423954 100644
GIT binary patch
literal 148
zcmWHE%1kq2zzZ0GvP?kCG3nVP561uh|5!kkv-tRiFt`J82nmM#2LhZ1aRE&;-~s@2
CSQl9U

literal 1162
zcmc)IO-K}R7{~FMc3s3G76L_sdZN@of-OT3ifGF^)E;6NqAo5`K~YdqbStrh=!Nu9
zr>&mEQ}hObVC*3X5;d*O)NM6;HCOFLvurJE`hUluOP9Jdf0)lObDQ5cvUS(aW!4`r
z-><i8jXe8LMUQE$Zk}}^aiaF(flXDHx;%aj*I1Vu%W4}|6jwDg9rWJ|6<EzHi={c0
zceABvjkeq^k~UwVwp|VC{l0c-KfOph;y2{M9-lsp)k$JQS|8P1)6SAseZ1qWc9kcj
zyJElg<lmBHVOW!s=Oi_IpQN4~mfnFp?Q7a1Pdk=NfBhkSc0E^~S8vuAXEO3~Te-g4
zo08YTxjGPv%bNw?b+9a{>6ryGlzUr;hNonBBBmp){qnZ^h`zgWN8UF^^~1?}89g7=
zvE9ez<IzeP537EvTrHnVt94@4LisXhyJqHRNoIVVPW~8_ubqqaTiT;j@d}w?|2`h?
zKb<Vc8HrB+XWQ#IW208~^qqIM*ZneUV<=*k1OnEQz*1|ydFGRCNB&|t$6Tz3EQqX#
zEQzd%EQ+j(EbD64MHWU@b~Q^QYrC4ok=0$z^2qu~0Z0W%2}lh{5l9tC8Au&SAxI@i
zDM&4@rWm9eS5ppB4^j|P5mFLT6H*jX6;c*b7g88f8B!Wj8&VunovSGisSha-sSqg<
rsSzm>sS+s@sS_y_sT3&{sTC;}sn*q$i`0u0j8u&OzvLVfbs*;_NO)Hd

diff --git a/lib/pytz/zoneinfo/Atlantic/South_Georgia b/lib/pytz/zoneinfo/Atlantic/South_Georgia
index 446660861227aa8ceb7084f48c3b2654ea64f4dc..a2b59a9d1088690cb2f9ad9011bfa59e6cb5c658 100644
GIT binary patch
delta 44
ocmZ3&IE`_FGA|<o0|OHfb2I>niKZ5UaDo3oklFV4z{GZ00J1I%e*gdg

delta 61
ycmbQnxP)<nvJevk0|N+iGysYE|Ns9pPBgHPf{OwL{%5xRJph!1$%;<w;{X8aFB41v

diff --git a/lib/pytz/zoneinfo/Atlantic/Stanley b/lib/pytz/zoneinfo/Atlantic/Stanley
index 88077f110715ac1e349708821ac1e00f35bf6395..1527d0e1a762674748735a95b6c3034d162f4240 100644
GIT binary patch
delta 44
ucmdnTxq)+nGNao@6$Qr0hAeKA`xz4%-8O$@v|xgA?Krq>bPbH{jJW_P5DW1D

delta 49
wcmdnMxsP*#GNb!O6$M6?`v3p`Pj+E+o7~Bm#OS{H4Wk7U2Llkm#WPvl0lLf)ng9R*

diff --git a/lib/pytz/zoneinfo/Australia/Eucla b/lib/pytz/zoneinfo/Australia/Eucla
index 3bf1171caddd7882d8a438f1d5eca0026549be08..1551e96cbc3de5565356954b61aac3c4388e90db 100644
GIT binary patch
delta 64
mcmcb{e1ds`GNbTBl@K9jMkX{ku|EJP^<V*3Dc#8@82JEH8VVf%

delta 79
ucmX@Xe2sa6GNZ^ul@Rgz|Ns9pGcuvW$-Rua6SsrZ++HBf00g+zSpxtK9}yA&

diff --git a/lib/pytz/zoneinfo/Australia/LHI b/lib/pytz/zoneinfo/Australia/LHI
index 9e04a80ecea45473faabeb609eb06cfe62193d48..069a95ad686c1139e2ff2b9ce94dc5ef5bc98c67 100644
GIT binary patch
delta 39
qcmX@Yw~cRtGGp;Zl`D*s|1cI$E?|mcEZ%&YX#q2oYd%?yT@3&-Iu3pS

delta 53
zcmdnScZ6?(GGoa`l`D)a_5c6>pZtTdcybm~G-Ju;V@wN}IT(NdN!((x0J|ChTs{?F

diff --git a/lib/pytz/zoneinfo/Australia/Lord_Howe b/lib/pytz/zoneinfo/Australia/Lord_Howe
index 9e04a80ecea45473faabeb609eb06cfe62193d48..069a95ad686c1139e2ff2b9ce94dc5ef5bc98c67 100644
GIT binary patch
delta 39
qcmX@Yw~cRtGGp;Zl`D*s|1cI$E?|mcEZ%&YX#q2oYd%?yT@3&-Iu3pS

delta 53
zcmdnScZ6?(GGoa`l`D)a_5c6>pZtTdcybm~G-Ju;V@wN}IT(NdN!((x0J|ChTs{?F

diff --git a/lib/pytz/zoneinfo/Brazil/Acre b/lib/pytz/zoneinfo/Brazil/Acre
index a374cb43d98bfbd06c82ca306a74f96993fd5657..cdda168cb97b1d45a4f1b7791a74523b74c88e6d 100644
GIT binary patch
delta 46
rcmeyu@{DDIGNb%Nm6nMcBv~1m7@3$SJ2Gic{00<UEXBx(ENTn@G*}B#

delta 61
zcmaFH@`YuBGNZyol@^xz|Ns9_+#ot}KigyjCYFiE{1_D$i!w5DFaQC%oc826CJq4T
C_!ip$

diff --git a/lib/pytz/zoneinfo/Brazil/DeNoronha b/lib/pytz/zoneinfo/Brazil/DeNoronha
index f140726f2a6945357b325f0bb452dce7557bbff7..73b4b336ab55544e6061409261c16cacc39aff61 100644
GIT binary patch
delta 42
qcmX@Zx{q~&GNbxLl_irKm{b`VCog4^pDe@(6xwXY=)edUR0jYB{tFiX

delta 55
zcmdnTdWLm^GNZ;sl_f0o|NsA=T*#z8@tqT+#%4oC2SyGCAV3Jqb8y+{8W`CbaRC5H
CLK7_j

diff --git a/lib/pytz/zoneinfo/Brazil/East b/lib/pytz/zoneinfo/Brazil/East
index 13ff083869a9ac8476775587de8476654a100017..67935ff4da8f527e03cd05ed2aa20e601e10f921 100644
GIT binary patch
delta 47
tcmZ3&J&k*UGGp{cl@i9u3mC(h8JQR-*Rsk_7Gna6Znk22z=R~M4gfe)3^@P*

delta 61
zcmbQny@Y#$GGoj}l@dml`v3p`PgZ30pKQR&GdZ7CezG7FP-?R&(*q_B1|UF_R|f!l
CG83%;

diff --git a/lib/pytz/zoneinfo/Brazil/West b/lib/pytz/zoneinfo/Brazil/West
index 63d58f80f556e1c3135d6dbcb2a2dfc6f61b4fc9..2708baea5af1d5169a1cebd00c4762d6bb937fda 100644
GIT binary patch
delta 46
vcmcb^a*kz!GNb%Nm6nMcq?s9+7$=@~Vw7LZ$H)lh%X4tq=o*;VnQ#FBI=l<a

delta 58
zcmX@da))JtGNZyol@^xz|Ns9_7Gx5itiZ%ES)ECK;!~i+VopXz4hA4VlT`-*LA4Ry

diff --git a/lib/pytz/zoneinfo/Chile/Continental b/lib/pytz/zoneinfo/Chile/Continental
index aa2906063f3bb2be42e800c208c6a4453a610031..010c6bd04cae79078540da560ce38400bfe0ade6 100644
GIT binary patch
delta 108
zcmaDTd|7ycGUNP-Dxu8cR}D7SY-D7Xjdhr8z*Hf^$i&FZ$if7J%uLLzERzo~bx-zT
eE@zxS`3Un;ke1CkEUC<3Jy+O2;MSAFSqcEH7#P3+

delta 136
zcmcaC{7`s;GUI}YDxu8MCpT=Y*~rK&qI6)g0aJxk{r~^}8JQTF8CjTMkeP{@6^JK4
s<fxtefrDpqENAHC*~~!wllL<(1sSk8oh6kSY{Gf=4{{7ZK$IzE0L*?R#sB~S

diff --git a/lib/pytz/zoneinfo/Chile/EasterIsland b/lib/pytz/zoneinfo/Chile/EasterIsland
index cae3744096402e8a452336544edf96ca9ae5ad8d..184cb6a83b3392d0492c42297531c85e7e38c4f5 100644
GIT binary patch
delta 55
zcmdlfxLR<6GGq5fm7R>tvat@6A23!-KEU2R*@wetvI#R#W^)8{E;Cr_1ltFwR4xD)
CWD`^X

delta 81
zcmZ22xKnU~GGot1m7R>tB1#7)KVYn2tN;K1KO@WJ1SZkR`Aj8~Z8>}=>oWrtZ4PG6
SWd^G{%=Uqc0SGWu<^cejdK>Qm

diff --git a/lib/pytz/zoneinfo/Eire b/lib/pytz/zoneinfo/Eire
index 1d994902db21814a626e42639d7a96b18ee73756..c729def42fc0822e6b24f7bf503c67cc7e6965f0 100644
GIT binary patch
delta 30
jcmZ1?y+nG$VirdJ$p*X;lmD<7Gk)A`!1|vZEKmXfqcjQ#

delta 30
jcmZ1?y+nG$Virb~$p*X;lmD<7Gv3*3!1|vZEKmXfq;Cox

diff --git a/lib/pytz/zoneinfo/Europe/Amsterdam b/lib/pytz/zoneinfo/Europe/Amsterdam
index c3ff07b436aedf662eae60f50668f5abcdb172b6..40d7124e5346af056c75e2f7012a51d94e8154b7 100644
GIT binary patch
delta 1394
zcmbu8O-NKx7>3VvX8gx)MI%|nA(5hmNhw5|EE6)Vge0ZFS_V-JE~0`OgTSQCEf)$?
zc{0uH$4t}4?9cu*D9bb}7X<}bn>qzSo0!gXCkd>D=y&G3&pCI#duK7v`_})%@1zEk
zgb*|pHqG8&X)bkZ3o1j&8G+EtQGN1Ft8=Qc(>dMkIQ2(ro%(^FS!zd<K69ui(2zMx
zpFL2d8*>iprt<W_xr`j$yeOp4FR^q>+(F&)B|C6oY`ebrs#ss@TdglYZq}{M>H3P=
z6lkjo`t;T6UAjF`q&h0v)wSYG)mgArc4gV>`m(($Jmb3xM?R?Tufyub$T8XT`kTDj
z|6bk-56Rp0)#^@Nr@R}QCwuqR%6mJH%KK&e<%3mA)x#Cr<fE0nvaf7J^^GQ|{`GU^
zld(ekX-ldz(2!?8JCSWa-&5`krd0Ut7aMb(q2sysaAA7KZ0oZXv|@ZQ9<Rq69~(F6
z#e8%nBu;Y$r~CpTylLjIqr5_-*dktt`O-?BxVL7G&qOEx&J=AZ5sORnOGKXAn@dD#
zzPXsPEb}qtKIxt<qmOyDps8-t?9(EqwsgJw2zP(#7Z9BwO1U&zLDYii1yKy5nM<P@
zL^p_X5bYw7U?hTj+`vDGgAflPE<${SIO)=O32_tRC&W>Rrw~^mzQVRDpL<4Iem{b{
ze1X3ZhanzAT!#1zaoVNv8sav@Z;0a%&mpcue1|v>@qQf}<c9<R5&}pNAYp(60ul<B
zCK!-#)co>gEHr`OJZLfj$ps`EkbGpv4th*JJh2|H&+AKwi=XsjKDrW<rniDqe|$V3
uCMG5zrc6LgOpLWA0`|ncHD`P#I{9a2xp{z`tTFxHsQi-^Vb$a&E%*)Q#1~5d

literal 2910
zcmeIzdrVe!9LMqJQAndBe#Hb*yhVf;#0OAPlavt61VVixQt*<9T4adCur#`;wffC{
zb1ZXe-VoFwqTy|T_ghoRYLuF;O;>g?ax<saT>ai>Yt8jftv~vwb2z`(+2LP!fBX|>
z<;Q#ea<#Kxc)059!+XzH?Xkj%y|SYD^PH7ucRQ;p_BkI^MLDaNg*t0A*{m(O>8vY^
zH0!g@ITe|KW<z3wQyDeUR7D>!8z)^do7${5n_4C~n=dai)zKH7>SHs^mLKz-nyS%e
zYtwR5`(|IWZCf|9z3?&T!=>Y#y39V#j=77>PM_oK^6znWw{LOw3@<f%emd>chtDzf
zXRerrTN|9l-A!iixie<p`?Y3&W3D++y3`!3I$;i;&&@fMU0is$>~P_cL0N@Ir`))D
ztY^{H<0H0bp1eFpPHhU)rgbUu@zMcu`t>OJq$pHA%^0rjDyC`hJDsKd!c>*wMD36l
zts(w!?U+77?oIebJ4ODWp&id_SnE?7c5SbQU)rkoeYQqBA9`22G&D*?b&Yggxmvmz
zmG1LjlO6>{(lck8+@I!`$f2q7Kun@UMMTSkPPjw|rfBr_0ov>9DDB-Gs(p^M(Y|#z
zHKyV_?N@$IV;7##{>2UI%iE%Hxo0K5s7?}+>Se&V_hew#RgxHADv7ttWKfrK9du!;
z4F0u5hcu?h!(V3W(8|f0R6j%?S)8oHRz&FV{76k+I9MJX8K^0FU1UVmWlc@FEh7Uz
z(ovCL$*7iZWOVBTGP>!wJbr1tjH%fyX(#t-`Vu1<)ob;M*|R0nyrE;CdRxa8OxN)b
z6{tULls*}jp;<A#HS2~?vpbEH>@Py}>Fd2@!p@&{Vsnt>tmz=Rbys9k*)^G5-Xv2d
zH_Oxo-|I8OcFDBdlbY9kxlB*0(fqbMbVgUz8Q(6`nYW8{*714z>;=C*w{fBt9GxT2
zzm=r3E62+VGrMcy;(;<}>`*Dn50klZ-K046mb}=(BPIPiY01@#QW|_iOHUt`c`ax4
zrP@k)xv5^~FF&XYYF6nh^D4A#Ntw3twrU;lH}5uqciB6r?cMHukMm#M9#25I{WtW4
zRCoj2_qKPw2h@5T`(?j3<c~90JmDTsL=SJoohRSZ(*2%{@qSOTwXe??@3Uu|JyTNs
z_OZXPm)BnQ;OEcF>-GPGaQtSkRv}{xkbt<_h#(<BVuAz(i3$=HBrZr`kjNmRL1Kdh
z2Z;_69wa`lHb6*(kPx}r7$HGIqJ)GAi4zhiBvMGIkXRwXLZXF)3yBvJFjpHfBxJ5O
zW=PPGs3BoP;)Vnci5wC-R~tJdcu4e+@FDR-0*FKq2_X_gB#1~9kuV~0L;}g*0g*&P
ziNq2KCK62~oJc&8fFcn^LW;!H)dm%bDiT&Cu1H{!$ReRdVv7V9i7paeB)&+1kq9Fp
zMq-Qv+0{lF2{RIBB+y8tkx(PCMuLq*8wocOZzSMI#F3CAF-L;#YNL*X-POh&2|N;c
zB=kt^k>DfIN5YT99~l5-1dt&>#sC=vWE7BLaJA!r41}v431ldcu|Ng`84YAOknunU
z1Q`)zNRTl>1_c=vWLRA7xF7@LYDWec8f0vc!9hj`86ISOkO4wQ2pJ+|jF3S>MhO`v
zWSo$Ja<wCc3>7j~$Y3F(g$x%mUdVtUBZdqaGG@r2A)|&28!~Rlz`5FyLx#@PjvX?1
t$mk)%hm0RGfXE2q|3eu3?}jkQj%B|%)-onNA$DM_FD5<Chy4?Reh2>ZkT3uM

diff --git a/lib/pytz/zoneinfo/Europe/Astrakhan b/lib/pytz/zoneinfo/Europe/Astrakhan
index 73a4d013fcb82c2beb6f885f359b9ca20da054e7..a41624f5df9698d78049008a2bd8a77395c0480a 100644
GIT binary patch
delta 45
vcmeC>{Le8#nbBdR3J2q414f6*g^Wdv4x67aaxg);{+wJk+6E?ex+YuzD-8>+

delta 59
zcmey*(aSkOnbC2h3I`)g{r~^}C+jdeOwML3W^~+qpOJ%!g8>MT!~;0FY_ttb>~u}I
E0AtV+oB#j-

diff --git a/lib/pytz/zoneinfo/Europe/Belfast b/lib/pytz/zoneinfo/Europe/Belfast
index ac02a81440f47a67b9f01d3fbcdb085266d20894..5ad74220e83e6c30a0aeefda4a00271b8ebdfcad 100644
GIT binary patch
delta 400
zcmX>gb3tZ;xF81u0|N+yz$YN)*r;)anUQ5OBa7-}0T!Ogvb<LHtn7?T=#Y(_eh_Na
r<h#65EFdRN{>P%h&A`YAax(*v#^#O9;jB~Ghk!p=K>nC4&!-3g+QS@C

delta 417
zcmca0b3kT-xF9<N0|N+yz$YMP->7khc`_rf%47i+zR7AVR`o1wj7;c|m5pvt9%|M9
w|Npmw9LXoZ$O57nI2agY6c~9Xv#@F~F)~gzV3ou4%;tF3DeObhH~M^v0I^FR`v3p{

diff --git a/lib/pytz/zoneinfo/Europe/Copenhagen b/lib/pytz/zoneinfo/Europe/Copenhagen
index 776be6e4a6d5a054152135a1ad149576052f49a1..7f6d958f8630cba512d8e58ca8edfbd516291522 100644
GIT binary patch
delta 779
zcmca9@Jn!lxG5(C0|N+yKtB+J*g_3JVm6O>!tATJKFqnfZo=FpTPMuhIbp*5mgy5t
za28IOXd_{KaoaS8OA-4TE-myIxST9K;flBNgsYYp6|SZ~pKx_WF~c>@Edtkdqy%no
zP7}Dvba2AWmlYfHuQ1j#v%n!MBZ$ogCRx}y=mOJGtYKi_=>YnbK}La*g@J)j0OWmS
zww3`SF9QRFM2P$NhA=q027?F?2J(P_kr9X(K`bC(WSk%#iZy8e13~_x#2+9U6vSW}
z7|b9V6x1LZ6x<*h6yzWp6zm`x6!eqhm`##FVGj}jg+G`E#sP>1#RG^2#RZ54#Rr%M
z#tE1P#tVoB#SMrC#Se%E#Sw@G#S@r*S+V&j^Fro&CPpTBY_TxYJ-(9AlLYnSYqBYa
F3IMIY$*2GT

delta 593
zcmew*cvE14xGFmX0|N+yKr0Y~*t`uuVzyjQ!tAU2E}U=<FPP{fA$>_jV8Z3fR)H(h
zYbRWdTPtw&{sV#Q?k6W)-+yT1^ec?@jLa-Zkd=+jP!VV$0|WONpvxI#6c||;82AJj
zIAJ76WU?Z&B*=G+Krq>hS<aRN$N^yxXaiypTkt;+WVW5(0-_6f-kX4EP*8wrU~qtF
zP>@XC%WPr{3KNh3C|p1^C~QD9D15*)FpNMnD4f9b{zIEXSQat^1B;27iG>vjva!<<
v20$%?1sE{cfB^;!Bw!E#gN+wPLPQYaKE5Fg&LHd>3?f26AqNT1YaA*7HVb)=

diff --git a/lib/pytz/zoneinfo/Europe/Dublin b/lib/pytz/zoneinfo/Europe/Dublin
index 1d994902db21814a626e42639d7a96b18ee73756..c729def42fc0822e6b24f7bf503c67cc7e6965f0 100644
GIT binary patch
delta 30
jcmZ1?y+nG$VirdJ$p*X;lmD<7Gk)A`!1|vZEKmXfqcjQ#

delta 30
jcmZ1?y+nG$Virb~$p*X;lmD<7Gv3*3!1|vZEKmXfq;Cox

diff --git a/lib/pytz/zoneinfo/Europe/Gibraltar b/lib/pytz/zoneinfo/Europe/Gibraltar
index 117aadb8364cd7901388098503f4538c7b445aeb..a38f11ffdf2a9e538695ea8cae20b1d2c04164af 100644
GIT binary patch
delta 384
zcmaDO{zrU*xF81u0|N+yz%d}^*r*}H%*ZnNAeZLk1ZIxOueg-!S=rd>3;+NB^#|l2
xJ^@A+28PK!+&n;vfn)MCZbNPcMn;en1CYk%{LL*aCTxS){VX8&Pd>@53;^rsCF=kH

delta 349
zcmew({ziO)xF9<N0|N+yz%d|Z->4zO%*ZtPAXi8|3o9Fa;s5`?{(v09C&0+Uz%W^Y
fg=exBi#`)0<K$QtIZUT+?qM-u8+>lP$*l|kfy*9)

diff --git a/lib/pytz/zoneinfo/Europe/Guernsey b/lib/pytz/zoneinfo/Europe/Guernsey
index ac02a81440f47a67b9f01d3fbcdb085266d20894..5ad74220e83e6c30a0aeefda4a00271b8ebdfcad 100644
GIT binary patch
delta 400
zcmX>gb3tZ;xF81u0|N+yz$YN)*r;)anUQ5OBa7-}0T!Ogvb<LHtn7?T=#Y(_eh_Na
r<h#65EFdRN{>P%h&A`YAax(*v#^#O9;jB~Ghk!p=K>nC4&!-3g+QS@C

delta 417
zcmca0b3kT-xF9<N0|N+yz$YMP->7khc`_rf%47i+zR7AVR`o1wj7;c|m5pvt9%|M9
w|Npmw9LXoZ$O57nI2agY6c~9Xv#@F~F)~gzV3ou4%;tF3DeObhH~M^v0I^FR`v3p{

diff --git a/lib/pytz/zoneinfo/Europe/Isle_of_Man b/lib/pytz/zoneinfo/Europe/Isle_of_Man
index ac02a81440f47a67b9f01d3fbcdb085266d20894..5ad74220e83e6c30a0aeefda4a00271b8ebdfcad 100644
GIT binary patch
delta 400
zcmX>gb3tZ;xF81u0|N+yz$YN)*r;)anUQ5OBa7-}0T!Ogvb<LHtn7?T=#Y(_eh_Na
r<h#65EFdRN{>P%h&A`YAax(*v#^#O9;jB~Ghk!p=K>nC4&!-3g+QS@C

delta 417
zcmca0b3kT-xF9<N0|N+yz$YMP->7khc`_rf%47i+zR7AVR`o1wj7;c|m5pvt9%|M9
w|Npmw9LXoZ$O57nI2agY6c~9Xv#@F~F)~gzV3ou4%;tF3DeObhH~M^v0I^FR`v3p{

diff --git a/lib/pytz/zoneinfo/Europe/Istanbul b/lib/pytz/zoneinfo/Europe/Istanbul
index 508446bb6aee2841ab88e82607a6ad6e748e7db7..7c2336dd80c3c9cbf71cb53d2b2c1f89a65a8ba5 100644
GIT binary patch
delta 59
zcmbQu-^)KinX!1I$`wXN#>tFKT9Xg3u}r?h<}z84y>RkFCZODAR^|oF7?M>07Q+#g

delta 58
zcmeC>pUpo(nXzP}$`wYI`v3p`PhP-QJUNSLDr3ne<^{|g3_yS+T*S#`qitYpr)$gw
E0G=%r%m4rY

diff --git a/lib/pytz/zoneinfo/Europe/Jersey b/lib/pytz/zoneinfo/Europe/Jersey
index ac02a81440f47a67b9f01d3fbcdb085266d20894..5ad74220e83e6c30a0aeefda4a00271b8ebdfcad 100644
GIT binary patch
delta 400
zcmX>gb3tZ;xF81u0|N+yz$YN)*r;)anUQ5OBa7-}0T!Ogvb<LHtn7?T=#Y(_eh_Na
r<h#65EFdRN{>P%h&A`YAax(*v#^#O9;jB~Ghk!p=K>nC4&!-3g+QS@C

delta 417
zcmca0b3kT-xF9<N0|N+yz$YMP->7khc`_rf%47i+zR7AVR`o1wj7;c|m5pvt9%|M9
w|Npmw9LXoZ$O57nI2agY6c~9Xv#@F~F)~gzV3ou4%;tF3DeObhH~M^v0I^FR`v3p{

diff --git a/lib/pytz/zoneinfo/Europe/Kirov b/lib/pytz/zoneinfo/Europe/Kirov
index a3b5320a0bd139c07b8642c4efd7b98f57c6e8dd..61e17f2b5697fd42477f1acb30411c5ab1ba83c3 100644
GIT binary patch
delta 44
ucmZqV{LC>ynbCfu3Jc?89Y*`fIgG`O_KP1dGC_F(oLn~A2F7-}##{gzk_%q|

delta 52
xcmey&(a1SLnbBdR3JW7k{r~^}C*NkapDf7|IC(oGP<ZieMkWphAV89e0s!|%67v86

diff --git a/lib/pytz/zoneinfo/Europe/Kyiv b/lib/pytz/zoneinfo/Europe/Kyiv
new file mode 100644
index 0000000000000000000000000000000000000000..52efea88065b220e44fd876de3bf3090fe62cc79
GIT binary patch
literal 2120
zcmeIye@xVM9LMqR1=MvKzHQNY0YZ|7cESOoXpq=>FoQFdlSn1BPShe&GzO*dT{+hp
zxwn(mT)M0nnscl_(EcFTkGZlsZubvsja;o(HrCvCtLDtH`aHkw=9+)C^=F^&zTe09
zjxqk>^^9%U(Oz!daAufqxH-M%=6#NB9;X5);%5c}o4*(<NhK~d$k@AnO}-tL<k-ob
zIrpAO-8t)<TEBN<jsK4sAI+M~P6Z~ywRa^Br*c0y?&O_5<m4ZH(V5-9+bP%^cM3b!
zJ9lrYbLKQIaf+&ooqK`-XKtR)nK$j4Gw;>H?}~r)+w;f0_JZ?Q?fXV1?cm^qy>K95
zm+U`hm+l$1L-9B5veqxH@~#o7s2P<->t2(}{A04Xyhj#K^+{FkfL2}HB1^Az>#}oU
zxqqTXtB2aOW^|c8aA1Wle<M$8+lzF?{-yF@U6zL9xw3NZC5?oqq%P}otuOjk>M#E!
zt1>>8RmltT&=2oO!|*9-Onj)(gZ;Al^jrFHXQ!;`e@WLq@`|qO*s4uSIyBZ;uj~D*
zwK+Ino3DhlC8thWzPeo>{k>Q=oc&EVj{9WO@tM*(@{2sy_p7uGBxQ5kxNO-ssgEyz
zU!G`9XuRNvY^@pAcJCS8man?)=ht=nRG03!(5p{gjOkM+H)_YHyX5JYYqWEyNuJqW
zpgRv#%C5E5($(&l-DR_7PvojRJJXWx(j4t}zL%ctE83GfFTIz)*5}?ElIN47y7$N@
zx^MWHzR)|UeFyv0b5q96nOT_`xBPv1Z@qr`rcF;@w`Kq5mu2N0HUD2cGtINm@><q{
zkTu=1vc(d<@!XMqR@Hg}>7S<GJ^9yv>!0t9(U{d>?noqNMVlI|urVBI;=@YwrFr3a
zJnro=$Nijscs#LxF_AybX+HZ|9GMC-7i2QXY>??7^Kms3;;%9zWJ<`KT+O7ASs~Lx
z=7mfQnHe%QWNyghkl7*AL*|D}5Sbw|MP!byW|GJ(k!d3HL?(*N6qzbAS7frtY?0}5
zm@hJ6WX8ypkvY4XNh7m%HPc4sjZ7SwIWl!*?#Sek*(1|O=8q%*$pDf9BnL<mkSw^G
zG$46!HHknnfusV-1(FOT8%R2kd>{!yGJ>Q8$qAAaBrC2aEl6HmO=6JDAgMuegCqyZ
z4w4=uKS+X*3?V5(a)cxa$r6$#Bu}m;QAnncR3W)Sl7(aoNf(kYBw<L#kdz@gLz0GM
z4M`i4H&>H5By+ANbx7`z<RRHZ(ud>^Ng)28L65274H@*Ael9Ghm%(U7No7f>v?3TS
K3%PHLe18GfyY{F6

literal 0
HcmV?d00001

diff --git a/lib/pytz/zoneinfo/Europe/London b/lib/pytz/zoneinfo/Europe/London
index ac02a81440f47a67b9f01d3fbcdb085266d20894..5ad74220e83e6c30a0aeefda4a00271b8ebdfcad 100644
GIT binary patch
delta 400
zcmX>gb3tZ;xF81u0|N+yz$YN)*r;)anUQ5OBa7-}0T!Ogvb<LHtn7?T=#Y(_eh_Na
r<h#65EFdRN{>P%h&A`YAax(*v#^#O9;jB~Ghk!p=K>nC4&!-3g+QS@C

delta 417
zcmca0b3kT-xF9<N0|N+yz$YMP->7khc`_rf%47i+zR7AVR`o1wj7;c|m5pvt9%|M9
w|Npmw9LXoZ$O57nI2agY6c~9Xv#@F~F)~gzV3ou4%;tF3DeObhH~M^v0I^FR`v3p{

diff --git a/lib/pytz/zoneinfo/Europe/Luxembourg b/lib/pytz/zoneinfo/Europe/Luxembourg
index c4ca733f5345df24e5286b70464a6c0498353372..40d7124e5346af056c75e2f7012a51d94e8154b7 100644
GIT binary patch
delta 1110
zcmbu7&r2Io5Xaxk?j|vcu7U=o2SIE_G>vEu9yNN<CbY#+@uIy;W$`HJ+9F7ATRkYm
zAM4K;+ghtwD*gdlXss8K_R^brDsvIMt@GV96ru;wnVtQ-w>xhSJD)efi!v){<_jTE
zh_75&myPmmx~*e0Sx{{xkAKt5uMKN<dB>XDwXFHEDQo`lGHkzGp@oq>V=+`hOG7bQ
zj=ZLo-YR3YIzp*ONm{Fwl=cl%`fro5e%43tPoB|-{TBN8EkzrtD*9wUH8#f!HTwLv
zpSFycy*;>Pzq5OSo#mC^&z|T%(n0HRF{=NZXwr`cdaZ3;UP@DXG>@Vxs^9Cob)r9$
zd4YSTdFKxZp;qu;MW{j)>cTI?gGyPDyOzb-o=oTeo>)8~YP#DKBI;IGLUgzDjYCSl
zINX!&Uh-u5(*lLq<-)qc;dt@o&nfuo{6K)1G>B=t<cWirI*7@Gm_7&tT(SiqOaNg6
z2qPTFbR1}b2T%iq9v~C}p$Q08K<MI<l>wm*2z5Z{141DX8i7y=+#J{3J&baS_yM%S
z3#c{OqwRP)%O`d3Lj^iDdr4uP6tALcs+Q;T-#XEs$w2=7(!BfetWRte`^3RMu~j@|
yHb&1~%hGI5rt@FVb3OpATDfjC>zY~+Ex-cSH$+*!x_DzK5(?MF8^Yk@#=sTA<3#)b

delta 1063
zcmeH_KS%;m9LL|~pYTjMM3kV!rGkbyLR$l+siGi3TEaDiIvN|YLMWl(>V_yQ%{0@p
zG=m5lg$Vk$1kvOYLPNYIXuIC``U8PWQ%mphexKjHcYol%pI67cQ+7tIgb*x@Q?}4M
zqN&1p+_e;n-#^lg=WKN|y(Vp)$#NpPDkrKHDH+Pp?U|=!s>?=qrpJY}caCPpdga|V
zFU@x3$zCT%bB*gl?!_bJYZGMuAtfDL43olTmL6ui$x(7hDlXVbDaMECu_VrxrxvB<
z^r+J(y02>e!gbCm-=zG)?TSaZn=A@tJNL%5HgIg}^hQIysffHIVm9$6p53C;H(CB*
zMzoI-VyNJ6wzxSx`=0_a{p_s*XTdqKebtX0b|>3mPqEYQ`uT=|!2t31ji3Zb5KWLZ
zY;YVFt7v%bg<4TWeRKV6RW^_>h>SI|oIzv_B5x3xgUDSY%N|7jARGYU0SFgB_@Js0
zRfQDTfEXa;03iqnNi;H1K*$0@7!cBc5C?=jAOr#-5m<_awR5<HYxtxpLBmOdPgE?%
Tb{!<@F;d;XM8A<JXm-5=&I2z$

diff --git a/lib/pytz/zoneinfo/Europe/Madrid b/lib/pytz/zoneinfo/Europe/Madrid
index 16f6420ab7efc7ceac3b0e42fe37836185cfc463..53f4cd101c18058a1ee4d4b9d1184ada11d74232 100644
GIT binary patch
delta 50
ocmdlcvQ1>ec4i?)1_nkTU;qLL!8k!@^H*kJHXdY|$s$}z0L+pGegFUf

delta 50
qcmdlcvQ1>ec4i?41_nkT08$XZ$T&e~^H*kJHXa}!E;Ct#O9=qXGzNMA

diff --git a/lib/pytz/zoneinfo/Europe/Malta b/lib/pytz/zoneinfo/Europe/Malta
index bf2452da40314be196f61e6a7cdd48eaf5c426f3..1d1a7bcfcbbf37ff1ad7025f9843d0d2d8cb06d4 100644
GIT binary patch
delta 24
gcmdlZvPWdY1tvzO%@>&x*%+B7Uu1eaS%FIi0B@WKLI3~&

delta 24
gcmdlZvPWdY1tv!3%@>&x*%+B8Uu1eaS%FIi0B^MjL;wH)

diff --git a/lib/pytz/zoneinfo/Europe/Minsk b/lib/pytz/zoneinfo/Europe/Minsk
index 453306c07566a94c0c391024fb16ee36245a0a40..3731e40d8634c4d58ddb3378d828c92948f06d67 100644
GIT binary patch
delta 39
pcmZ3<HJfXKGNa2z6$!@44va37=d(0UW@7@1Y}R7ZV1f#D0RY_w3i1E|

delta 53
ycmbQuwUTRsGNbE86$wU``v3p`PxfVTnLL4|X)+@dP<XQ{lLiw90}vp|bprt4l@am)

diff --git a/lib/pytz/zoneinfo/Europe/Monaco b/lib/pytz/zoneinfo/Europe/Monaco
index adbe45d1c1db7287345b1826a356732075a38c51..7d366c6098c49ecd546e1cc1538919e1414a3aee 100644
GIT binary patch
delta 639
zcmZn=pCmp(T!xo{fdPa;U<VL`*zyfPVq!wTMB}3pCvwyuoO$joaCW8mgma6W1<p@0
z5xC(0@WEyg#=ne=tdkwM)FvA+bJeqOu(7kTbFy%9ad2_-&>g}oWME)2ocxhXCLQ7x
zJ^=<n1_l`gMo}bEih%)H9K`nV4PgiX;&9hs5D~)Q48~v%P?&*%kr9Hy3?Lr@7#Sys
zt6&Ym|3Hv^a`t%;4GhW6)hxY?ETFKQEW@VC3<^IRwx7&{H~eCN9t3&}Ih^33NOAa0
Ij^tJc0Km^v>Hq)$

delta 616
zcmbOv-XK0fT!x#0fdPa;U?&iR*zyfPVqyjNMB}3}r^KT_oO%@U;Pl$e4`-fx3!Ggk
zKH=OVXMyvROawLyF#cs^WSi{Br7>B7nWLVC6$UxjIXJoK4S8S|GBB{cnS6p-#z#hh
zQ4r`A1_oXR1|VCEfq_qeK^mFu;~T;d0L0<0!5{*Jfjnmr&l$*LU|?hf8^Fjo*?~n#
z1#4*i2ZB7o`BOkNFw{1;vGg*EfWi$V017)04GO=>;%us$UD&=bkC-sa=2iy)o^)S3

diff --git a/lib/pytz/zoneinfo/Europe/Oslo b/lib/pytz/zoneinfo/Europe/Oslo
index 15a34c3cedb7c9ca519c195f5ec0ce9d8d1885a5..7f6d958f8630cba512d8e58ca8edfbd516291522 100644
GIT binary patch
delta 734
zcmdlY_)BntxG5(C0|N+yKtB+J*g_3JVm6O>!tATJKFqnfZo=FpTPMuhIbp*5mgy5t
za28IOXd_{AaoaS8OA-4TE-myIxST9K;flBNgsYYp6|SZ~pKx_WF~c>@Edtkdqy%no
zP7}Dvba2AWmlXmVCtPN%XJ&yzRz?t;4NS7IbI=8vqgcbhz|#TrEQ5>!BMSoqp8&}J
z$ZRbGMqUO65IMP!LsG!m)i(sBoRJZT7#SEQYctD*VhzIoK#;#E@dt<o1tpjU1}BIH
z1u2LI1uKXK1ucjM1uuvO1@YuMW|I_97=r{r;S8pMVGW`|;SHieVGg1};SQ#OVGpK(
l;SZugaR8!0@c^PhaRH)1@d2iRak5#BWij*cij;{Q$^ZmM#U%g$

delta 675
zcmew*xJ7V+xGFmX0|N+yKrax3*t`uuVz&BYhS^uD6HaXRO_=B-VRI>oUEuY4g$Zv~
z_z1k6VJq;iLr>s+g}lIr3;}_U5sU(#+&>9?Hh(PeMg5AvSMj3)-vmBP_^!_;@cqN3
z2^(izW~^sqX2Akk+2{l{kt||h;1U6PkwHd*k%fVQPk@0FMuJ2pD>6%hf`JhTCVMf<
znPLs2|3FamP9+CKgTe|-1H%hMgTid`US^YeP@sVXKmiA$L4gONK>-M&L4gROK>-P(
zL4gUPK>-S)L4gXQK>-V*L4gaRK>-Y+L4gdSK>-b>fq@P3n6R&l0Fc_8z%qk*hz9(1
G4rKsw<fyp-

diff --git a/lib/pytz/zoneinfo/Europe/Rome b/lib/pytz/zoneinfo/Europe/Rome
index ac4c16342b5bbfa4c58a26f57db33b95f5b3e533..32b2899a306dde401fa2e3952d06f5f4d9952bed 100644
GIT binary patch
delta 72
zcmca8a#3W%1tvz;$rqVSCJQiUPL^lpo?OYSz{MxPz{$WMqrk|rc`@@0Rz|kTHk>At
W3ptB{tS6jmAbDP}JjY}aE?WSqBoF%l

delta 72
zcmca8a#3W%1tvzO$rqVSCJQiUPL^lpo?OYSz$K%=$il$DC&0kDc`@@0Rz~K@Hk>At
Y3ptA!*(X2YR0GL#faQ57i*VTj0IF6G_5c6?

diff --git a/lib/pytz/zoneinfo/Europe/Samara b/lib/pytz/zoneinfo/Europe/Samara
index 97d5dd9e6ed7fc924c9bcb514f991cc8b52061b3..d0ea2f25e9b4acaf3167a09a1c647943425e51b1 100644
GIT binary patch
delta 45
vcmdnbxsh{%GNZ#r6%NM928<4q3mLl^9X9`E<Y0nwGdQ_yv<*z`bWOMbEUF9L

delta 51
xcmdnUxu0`_GNa>06%Iz0`v3p`PhxSHY|oN8`3fUYbn_2J4kiu;AV5eJ0RY!q5)c3Y

diff --git a/lib/pytz/zoneinfo/Europe/San_Marino b/lib/pytz/zoneinfo/Europe/San_Marino
index ac4c16342b5bbfa4c58a26f57db33b95f5b3e533..32b2899a306dde401fa2e3952d06f5f4d9952bed 100644
GIT binary patch
delta 72
zcmca8a#3W%1tvz;$rqVSCJQiUPL^lpo?OYSz{MxPz{$WMqrk|rc`@@0Rz|kTHk>At
W3ptB{tS6jmAbDP}JjY}aE?WSqBoF%l

delta 72
zcmca8a#3W%1tvzO$rqVSCJQiUPL^lpo?OYSz$K%=$il$DC&0kDc`@@0Rz~K@Hk>At
Y3ptA!*(X2YR0GL#faQ57i*VTj0IF6G_5c6?

diff --git a/lib/pytz/zoneinfo/Europe/Saratov b/lib/pytz/zoneinfo/Europe/Saratov
index 8fd5f6d4b881457d13fdcdd35abb6fc5429d7084..a863913358adb7a9118fcc48a6a5dcfba5f9914b 100644
GIT binary patch
delta 45
vcmbQwIgxXMGNZ#r6%NM928<4q3mK~!9X7vZ<Y0nwBRIKiv<*z`bWOMb9r_Dx

delta 53
ycmbQpIiGWaGNa>06%Iz0`v3p`PyWE{Fj=1^a`F*Ipz!7wj2uiH3_yS+mjnO;x)V?U

diff --git a/lib/pytz/zoneinfo/Europe/Simferopol b/lib/pytz/zoneinfo/Europe/Simferopol
index 29107a07cb2e192f0c33889e726e6fbddd2cb867..4bf24de1d9f8ebc410f120aa83d98b7e41d1e6c4 100644
GIT binary patch
delta 77
zcmdnXy_b8!Hm>yr`Xvhr3{oZ*OgylQm4g!qCpR)GOcr2Ww%L`*iBV{M0Rs?#6oF`v
O!p$?8gBVeit_1+l0~Qtl

delta 77
zcmdnXy_b8!Hm+6&{gRddgOqfKi3fJEGP5&ta!hVyRG2Klx@@y6lM|y*s{;cNfE0mf
PkiyL~nS&Tnl&%E;bk7tX

diff --git a/lib/pytz/zoneinfo/Europe/Stockholm b/lib/pytz/zoneinfo/Europe/Stockholm
index f3e0c7f0f25f0a7290e56281c91190e3611498a7..7f6d958f8630cba512d8e58ca8edfbd516291522 100644
GIT binary patch
delta 878
zcmc(dzb`{k6vxkfE%l_D%b*DznuvisO&cW4jj3J?3`Qbit6=H&8Zp@1v`G#1voWv`
zg2W=R8T{xg5A_c;-7FHZJokGgh*)v%JLhxWU0(A2yyw7cqX=3$5us5_vavU%<;eSk
zV|nNCX{Ed?R=1AC+KCYB3(MkMpAi?81i#z~imO7LUuSxFalW0~v(4N-&QWRfG+o*p
z;x`km;x^GHoPIm(OjU%lJx6yPhy31X;SYL_m$frdu4*a1-&bUo#x#%j<J2(hwQ72O
zb-#Zmzkh<rzbHeXP?&j%0vx$~-8-YKf#`jH-Vd516dxGIK+88-jLC;#%kF8Rp96Pg
zO&7*rKm@NS!v`S%gai;GK*#_g1cVe2VnE0NAqa#d*G;-EOyL5yKp0b$)<Bp8VGo2s
zMQKq{ngn4Jgi#PyL6}vnruczp!}H&Atv`{gOxH{CT`~LuhS?qIjYJJI7R@GozBiK7
B{kZ@D

delta 461
zcmew*_?2&hxFRb90|N+yKsgYD*t`uuVzyjQ!tATJK5U$Efw7*EiIJIw{*Zw|;0@3z
z3>tg_3@i)`G75|wFcKu<;~T=@><YrcAs}UpjFWwsWlY(COb`Zv3Lplt1^)v<$kq8%
zKy*!LaT16Ic@azly}3D*WdSqLpUg}wtn`OakD4&>$$>ly^c=*aJYeqvNstK0yTM@Z
MBD@Up^9>Fq0MAD_fB*mh

diff --git a/lib/pytz/zoneinfo/Europe/Ulyanovsk b/lib/pytz/zoneinfo/Europe/Ulyanovsk
index 7b61bdc522b5b7f4397fdb9246185f4d972f4b6c..d668233b37f268a745e995177195b06ffab1e69b 100644
GIT binary patch
delta 45
vcmey&`IK{lGNaQ*6#>S{7K~1ls~M*=I&Btal3;>zOE|e~v<*z`bWOMbGLH+m

delta 53
ycmaFL`I&QqGNbcG6#+(;`v3p`PgY}bnw-v3I{6hNP<S&RlLQk70}vp|)d2tmC=z=B

diff --git a/lib/pytz/zoneinfo/Europe/Uzhgorod b/lib/pytz/zoneinfo/Europe/Uzhgorod
index 0eb21501d9241268b7e5593c81bd02272b77c9cb..52efea88065b220e44fd876de3bf3090fe62cc79 100644
GIT binary patch
delta 722
zcmbOva6({$xG6sa0|N+yKqU}^*h&pRVwL3bl&wo76HcAgyKv^Yx4_wz;uFp-auzsu
zc16KNA5U)X-yhU^6&`3j6>r!$r<k#xjfItknH>T-I1!MGn+FDY`KS&V7-Z%E9m^n7
zKZk(@NGULIFfeEtFz_%i@Ch&ofJ7KYV5Efuqa;ig#%7d7=t5=t_=Yfe1F@@X2!n61
zH-j^fc6JR0aa@3cKn4gfGJ-MV<X=pDli8T1L$L<ve;^3kc02_{g8~*rg8~;sg8~>t
wg8~^ug8~{vg8~~&0|R_=8S_+OV2Fck1cf??28H})F_y<nqd^Z0`VZ_%09d<(WB>pF

delta 627
zcmX>hFiBv7xG66K0|N+yKm`zk*m4a(;sj^mgfq{*1<tM%pKxxGv%vXDCIS~0&U<k2
z>E90%eLUHF^**S7by~1-K`~=J6EhPdD+>g&vBM!F2PYR4a`R9fGBAj|0J@WbPau(j
zg@Hjvfsq5m0kJI{7=ixKGGGvdkq{9X1qM-&2%{uOJ&27E@$n5|aCQaZ;1CAiU>6|v
zW^e@xxB>+x^KwW|R%Dh`#Ts1yfgtPM1_=-i3bx7l%rYXN@B#^d!VE-%!fkRt^HgqN
Wz=50%3cStcERUH+Na$&BC;$K`US-k%

diff --git a/lib/pytz/zoneinfo/Europe/Vatican b/lib/pytz/zoneinfo/Europe/Vatican
index ac4c16342b5bbfa4c58a26f57db33b95f5b3e533..32b2899a306dde401fa2e3952d06f5f4d9952bed 100644
GIT binary patch
delta 72
zcmca8a#3W%1tvz;$rqVSCJQiUPL^lpo?OYSz{MxPz{$WMqrk|rc`@@0Rz|kTHk>At
W3ptB{tS6jmAbDP}JjY}aE?WSqBoF%l

delta 72
zcmca8a#3W%1tvzO$rqVSCJQiUPL^lpo?OYSz$K%=$il$DC&0kDc`@@0Rz~K@Hk>At
Y3ptA!*(X2YR0GL#faQ57i*VTj0IF6G_5c6?

diff --git a/lib/pytz/zoneinfo/Europe/Volgograd b/lib/pytz/zoneinfo/Europe/Volgograd
index 11739ac271da2b623bef49ea64908820b7ca05fd..5539bac6ced7d584136fc705e8dcb80b300ad6b4 100644
GIT binary patch
delta 39
pcmeC>{Le8#nbC2h3J>GtU(Ak^ZCE@e?_&gtY<|QjzyuWv1ONj547C6N

delta 59
zcmey*(aSkOnbB#Z3J)Vo{r~^}CmS$2PA*`~VRYJjmr;O;g8>MT#63B=Y_tuG?R1T~
E0A^wmtN;K2

diff --git a/lib/pytz/zoneinfo/Europe/Zaporozhye b/lib/pytz/zoneinfo/Europe/Zaporozhye
index f0406c12a6b519347d6a7c091424da9d0f241236..52efea88065b220e44fd876de3bf3090fe62cc79 100644
GIT binary patch
delta 406
zcmca5a6({$vPLBX0|P%0D>VR#Rg%k7wl0xOICWO<!kOpZ0%uo>PdK;8S>W8+6%)OE
zIn;U;9%wujZ`in`n~|G~n+FCb2eSK54q#$QWMGh)12hIivH(d11`Y-WEdvG~1_nL>
z1_6)=qX>+&aA1^#$->x-vIt$MY#-kc25;Yx$sd_wJm60L4+LS`j;DZVkkdgl$oU`|
v<OL87@&<?oc?Cp+yaT4su9!TPc`gsgPar3Q{I%JQ<u}uSdCYRM4Tl^6y6|jU

delta 399
zcmX>ha7$o<vPKmH0|P%0t26+KRg#Mhwl0xOIJN5eg)`5+1<tM%pKxxGv%tB%*Cu-V
z@~E?_7pQ-gDA0KFHelm|ZblvsE+%dsD4gub?mszzoh6xpLE#6`ECz)O3@i)`G71b_
z3=CQZ415d>d;$zYAQ46}7-`|aC=HW^u^Ht-A|Mi?7iI#ZypL}PgSLT@k-_AT?3R<2
znUP%o9|*#>9p(VhAYXuJkWWA~&^MFwnB|!EUYp#<JXZwd3y}LjJ^|4n-)uH#`OP$t
H-U$Z))3sV>

diff --git a/lib/pytz/zoneinfo/GB b/lib/pytz/zoneinfo/GB
index ac02a81440f47a67b9f01d3fbcdb085266d20894..5ad74220e83e6c30a0aeefda4a00271b8ebdfcad 100644
GIT binary patch
delta 400
zcmX>gb3tZ;xF81u0|N+yz$YN)*r;)anUQ5OBa7-}0T!Ogvb<LHtn7?T=#Y(_eh_Na
r<h#65EFdRN{>P%h&A`YAax(*v#^#O9;jB~Ghk!p=K>nC4&!-3g+QS@C

delta 417
zcmca0b3kT-xF9<N0|N+yz$YMP->7khc`_rf%47i+zR7AVR`o1wj7;c|m5pvt9%|M9
w|Npmw9LXoZ$O57nI2agY6c~9Xv#@F~F)~gzV3ou4%;tF3DeObhH~M^v0I^FR`v3p{

diff --git a/lib/pytz/zoneinfo/GB-Eire b/lib/pytz/zoneinfo/GB-Eire
index ac02a81440f47a67b9f01d3fbcdb085266d20894..5ad74220e83e6c30a0aeefda4a00271b8ebdfcad 100644
GIT binary patch
delta 400
zcmX>gb3tZ;xF81u0|N+yz$YN)*r;)anUQ5OBa7-}0T!Ogvb<LHtn7?T=#Y(_eh_Na
r<h#65EFdRN{>P%h&A`YAax(*v#^#O9;jB~Ghk!p=K>nC4&!-3g+QS@C

delta 417
zcmca0b3kT-xF9<N0|N+yz$YMP->7khc`_rf%47i+zR7AVR`o1wj7;c|m5pvt9%|M9
w|Npmw9LXoZ$O57nI2agY6c~9Xv#@F~F)~gzV3ou4%;tF3DeObhH~M^v0I^FR`v3p{

diff --git a/lib/pytz/zoneinfo/Hongkong b/lib/pytz/zoneinfo/Hongkong
index 23d0375fba3377a3d513d849c0d29c82ad2add64..f9f7b134dd5c35e4718c6fa3697024cb95442c53 100644
GIT binary patch
delta 254
zcmdnYd69F1xF81u0|N+yfGZGlY}AlpbYy2@WdlMc7-VN65l(Jp)M8^`C}?0{nY^A+
joSzYBG$W7z(LjLB;>}+e4Vb8IvlyDqTpr#bx)xjj?LQI_

delta 260
zcmcb}xtVi<xF7=%u!9I7a0O!ajT$nHj*LvKY(U5agN#fh!pW_STCzUAAq*bgARG)L
h!b2FmfDABTWW;9oW@aV>ChAzOg4c2`ptE!>xBwX#6}|uf

diff --git a/lib/pytz/zoneinfo/Iceland b/lib/pytz/zoneinfo/Iceland
index 10e0fc8190a401f67b861ced3b8b16401432a565..28b32ab2e0b9053f39a91d9f28b6072e41423954 100644
GIT binary patch
literal 148
zcmWHE%1kq2zzZ0GvP?kCG3nVP561uh|5!kkv-tRiFt`J82nmM#2LhZ1aRE&;-~s@2
CSQl9U

literal 1162
zcmc)IO-K}R7{~FMc3s3G76L_sdZN@of-OT3ifGF^)E;6NqAo5`K~YdqbStrh=!Nu9
zr>&mEQ}hObVC*3X5;d*O)NM6;HCOFLvurJE`hUluOP9Jdf0)lObDQ5cvUS(aW!4`r
z-><i8jXe8LMUQE$Zk}}^aiaF(flXDHx;%aj*I1Vu%W4}|6jwDg9rWJ|6<EzHi={c0
zceABvjkeq^k~UwVwp|VC{l0c-KfOph;y2{M9-lsp)k$JQS|8P1)6SAseZ1qWc9kcj
zyJElg<lmBHVOW!s=Oi_IpQN4~mfnFp?Q7a1Pdk=NfBhkSc0E^~S8vuAXEO3~Te-g4
zo08YTxjGPv%bNw?b+9a{>6ryGlzUr;hNonBBBmp){qnZ^h`zgWN8UF^^~1?}89g7=
zvE9ez<IzeP537EvTrHnVt94@4LisXhyJqHRNoIVVPW~8_ubqqaTiT;j@d}w?|2`h?
zKb<Vc8HrB+XWQ#IW208~^qqIM*ZneUV<=*k1OnEQz*1|ydFGRCNB&|t$6Tz3EQqX#
zEQzd%EQ+j(EbD64MHWU@b~Q^QYrC4ok=0$z^2qu~0Z0W%2}lh{5l9tC8Au&SAxI@i
zDM&4@rWm9eS5ppB4^j|P5mFLT6H*jX6;c*b7g88f8B!Wj8&VunovSGisSha-sSqg<
rsSzm>sS+s@sS_y_sT3&{sTC;}sn*q$i`0u0j8u&OzvLVfbs*;_NO)Hd

diff --git a/lib/pytz/zoneinfo/Indian/Chagos b/lib/pytz/zoneinfo/Indian/Chagos
index 93d6dda50f579093f25617c77081ae99c8631ea5..a5554816e2928c2bd5d02e032bbeb1e1cb101009 100644
GIT binary patch
delta 41
ucmX@kxRY^$vJevk0|PS<^K{mIpJVXs?gqw*^W`T-Dl;-otd(E{ax?(;^$d0Z

delta 75
zcmdnVc${&9vN$sX0|N;2bk=>JWAN<mhWh{i|1&a8oG3prL|GXw3l#hhQUO%S08#~_
HVJbBM(zzR(

diff --git a/lib/pytz/zoneinfo/Indian/Christmas b/lib/pytz/zoneinfo/Indian/Christmas
index d18c3810d97bbd424dc3c8fa98de46bfa08c3fa8..fa799db39e7625dd74bd9caa5c29b4819a7cbd3f 100644
GIT binary patch
literal 185
zcmWHE%1kq2zzdjwvdlot(*PtEWu+fs1d7Dj068F%g@GZdfPuruH-y0nh_wyO8A3=f
Y^FI)TZEHOOqKPq^%LZtJovt|-06W1QE&u=k

literal 165
zcmWHE%1kq2zzdjwvLMXS03_=F|Nqa($iR>+1LQCy6)>>)_=YfO8<;bMkYEzfkpIPE
TE1!VOz-=Oz4bWUWU2`q~S7aD5

diff --git a/lib/pytz/zoneinfo/Indian/Cocos b/lib/pytz/zoneinfo/Indian/Cocos
index f8116e7025cadc709bbd995905e88c92ed03642a..eef37b42e8a0e7179f8113bea01f4a71d668e8ef 100644
GIT binary patch
literal 254
zcmWHE%1kq2zzbM_vaCQX)Bq$Feku+;{ppXy#aZbe7@3%v7#O1Tfx;jXs4hB#frEje
zZUO@zgze)S!Vm<++6HFE20+r1A%q0`{sTeSw$6(n8e}hs2H6dw$+e%$2J99)T{A0V
G11<oC<~K0_

literal 174
zcmWHE%1kq2zzdjwvLMXW03_=F|Nqa($iNVF2gqTF&R}5i@eN_nHZU_bU<e_>ETA#}
YYeLnQfK0(>CYKG^Y&%^uD`NvL0F6i*%m4rY

diff --git a/lib/pytz/zoneinfo/Indian/Kerguelen b/lib/pytz/zoneinfo/Indian/Kerguelen
index cde4cf7ea7086a3fa3609566ff03e9425b096f36..555728b1a0187cc0ac63b8fe45c44bd1e0957918 100644
GIT binary patch
literal 185
zcmWHE%1kq2zzdjwvdlot(*Pvi>K~rL2o!O70px&476t~l00s^p-w+00Al5c8We6d`
Y%>O_Twr#!yh$hBtE*qc?cDklq0OTbe`Tzg`

literal 165
zcmWHE%1kq2zzdjwvLMWHD>12|{{R2~jEpe#ZUGD|x&{Ue+6JZ!AtaatG~_?XG>|#C
OP2{oxnro+P$^`(9>=%~+

diff --git a/lib/pytz/zoneinfo/Indian/Mahe b/lib/pytz/zoneinfo/Indian/Mahe
index 208f9386bdad172305a48f6ab7e70ac3e1ca0e1e..b3ac791aef4e73d6d644c40c614f37f15d462cdd 100644
GIT binary patch
literal 151
zcmWHE%1kq2zzZ0GvP?kCvGCK(6+n*h4UlpR2L=`&-w+0E0~3Z25)And1UL=ivH==r
Ir)$Cm0Qy}Np8x;=

literal 165
zcmWHE%1kq2zzdjwvLMXSS<l{5|NsAgMn(n(<3Auh77h$7KE5Fg+6E>JAtaatG~_?X
SG>{p%P2{oxnro+P!UX{Gdl_K>

diff --git a/lib/pytz/zoneinfo/Indian/Maldives b/lib/pytz/zoneinfo/Indian/Maldives
index 7c839cfa9bd62842cf23f01d5195b239bc5a437c..555728b1a0187cc0ac63b8fe45c44bd1e0957918 100644
GIT binary patch
delta 41
tcmX@kxRY^$vJevk0|PS<^E3d7xB7=?FixB=KQU67k!fPB1S6260RY583NQcw

delta 75
zcmdnVc${&9vN$sX0|N;2GysXW`iE!K|NsA=k!j*Y`H3OQ%5Yhr;Qz2~^CdtuNEJ{q
LLp_iUQmFv|i?|$4

diff --git a/lib/pytz/zoneinfo/Indian/Mauritius b/lib/pytz/zoneinfo/Indian/Mauritius
index 17f26169904928e4061e4ee58bdf7a6c62001524..212d4b2e2afaed06110a1acff4fdb6bd6103b4ff 100644
GIT binary patch
delta 56
zcmey!_?U5mvLY)30|PS<^K{m;&X8bz>mYHv$iS0%+5^vX{TG-RnHVQ}Ix(_N>@i>g
Ib53di0JY2yd;kCd

delta 73
zcmaFN_>pmfvKku$0|PS<^K{m;&X8bz>mYHv$iS0%+5^vX{TJ&0|Nqa#2!s=N%TG*J
RW@MY#Zomsv%zz}J0RUEr7ux^;

diff --git a/lib/pytz/zoneinfo/Indian/Reunion b/lib/pytz/zoneinfo/Indian/Reunion
index dfe08313dffde345044d5053e3359f92163d3e38..b3ac791aef4e73d6d644c40c614f37f15d462cdd 100644
GIT binary patch
literal 151
zcmWHE%1kq2zzZ0GvP?kCvGCK(6+n*h4UlpR2L=`&-w+0E0~3Z25)And1UL=ivH==r
Ir)$Cm0Qy}Np8x;=

literal 165
zcmWHE%1kq2zzdjwvLMVc@r-3d{r~^}85tQEOu$+!92i)9d_x$t4NMq9NH7U#$bXP&
RAVYAQ$YldG*G|`j3jo2r7;yjq

diff --git a/lib/pytz/zoneinfo/Iran b/lib/pytz/zoneinfo/Iran
index 8cec5ad7de2f2c14dd4b0a6c375d7198ef7429b6..cc2a2c219b0c893cfa8187e962028eb19ea3425d 100644
GIT binary patch
delta 444
zcmbOx@_=)KvZgx&0|N&T%goBDJ+YtRj0f)&7Yn|%!aMjYiyZ_sP8|?<Yvmxgc8|wI
zk3aQ{%uK8-tjtUlLIwr{3!s%Cl7)f6-h&b707DA~J_ZK207el81`7uU31o2}-w=in
zAQsU!Ffle@&^9mzlcqqH3Bv?sPq-ic0|Ce%AR6QskR>4hfM}4PKs3l-AR6R1Fb(t{
fhz9v_^C_kuj05dUC2YRrvH|<rPS@DV*nkTF!0thn

literal 2582
zcmchYYfP499L66Mg&7_KDr+uXW>A2@`>OBl2?$bdK?RXRc}!GL6DS2rJfewdKnY<&
ziidzg(ZV2aQb-f(1|iY#6i{Yv;wHmQ+)Ul*xi06|`jWw(_s5^>8hp8adm?8ojk6g4
z__fGP9n5D)!Sc2GT&uGlaBROEnCulWC_BJsQ0KUSC!^xE^P~{vV!Nqby`EC;!&0?-
z>u&Y(>0SDjnirHuS+n%q6D_>5d+U)Kwkq!=oAg;wEque5X-nWOWwmtaQ6o~+XxHI#
zOy5#5=1#P>U2jw3!Zta!evlYfHBgQ}m?tI_1nP;ITKTO`mHr72M8KR<{c4!E3iKbT
zgM2Gg@YQ-L&xeUAb<<_Y(H0R}lCG!bJE&<}D&_RF@gi(VhYp{esAhyF=!l88)lAQQ
zGIFS!i0a>>qm5ZAy30|<{E;nQKbs}rsC5yuj-1f5izll&x!rPZMw*zH;-=@vA5w3|
zl<5T_78NV5$b}wpV$pLhda+Z!T6{lP#&tG{`1VG*q&Y$?t?ALr$~UXG_FCogoGOu!
z9;Xvm-c(7k1@i5vVd9-hL*)uvu~_+1giaoONu@Ys$dr3dBDJGRzuW4s-aGB5S5?=l
zw6Ya)b>UsHCaYMl-Qc0tC0>^67t9xSz3hA2_v-UlzYW7jU>)YCy<zwY!_hD%huaM>
z3=v>B8-~BMd-~z;r%sDBBF)Fc$7=O4KS!I-C_LsB`R^-hc(k$}^9xG@u{Qj7EDpr#
zKrD|m*9T&OAXW%si6GVpVv(e|N)XEgu}%;R1+h{PO9io35Q_z|S`f<xv0e}h2C-rg
zO9ruK(p)r%RfAYIh;@TlIEa;lSUQNcgIGL>)q_|*i1mXo0E7h~OaNg62qQpP0m2Lr
zc7QMhge4$M0bvUWV?bB~!W<CxfG`MzMWksG2%A6{1;Q#2W`VE^gkc~o17R8n+dvox
z!a5M<fv^vRfgmg-O%p-b2*OAZR)R1Sgq<J^1z{-&Q$g4Y!dMX2f-o0^y&wz*VKE4k
zNz-N!MuV^#gxMhM24Oe|%R!h9!gdhGgRmalFk>F?^q_0JH(Iu{ziGrX?7#0)$9!|&
zQ0AMv?=sK0zK;2pi)(p*(9oOrR#ndawu3hIKg_?zJTr3{^Q_f_nP(>yGXH4qZr&e<
z59htzubKTE-)Q!8huJg##CaR@JUbinyxY~xcl>#r_oo*EdGD;f#eV+LRQ3x>hBN<c
zXDRbtTVj~+Ue(ULaA_OwJ#%7t?+qQu{=SKM?C<vsV*dH_^~{U<KlHz-=K=HLuKVnl
zTutZw#aVCmzdTjRe(8}|<_C&8m><mD!MrSE2=hb9^~?{)hcW*uW;*Y$r?l`c7aQ3>
z;^D~tH_uiwuW%aAyyD&s=9QgE%)f0<<bCu^H*Zz5kNv80H}=2VbDsIJoY~Ber#mvQ
zUYX6jW?>fZ@1tFKpLp#g`zLL|?Ef&LoB651Y0PUK+?m(@b(neGjYGVDY_szIso@Iy
zx;l>i`Z8DM4TS~FPiF-)Z(QHRyeX-X_s_8rywA)q*l!NXVE?Se%KY4mRm^{JiD%x@
zr;~ZhotwPRcdX!j;o?yCFV+{ce@V?`e)+&<=D+4=FmKItV&1mq3Eu6A+j;*s*Ps30
y!|MK*x8&n}2S57j|INF&-vqv){k*K>tUl(?=KI;tGsHI5+cL^C#4^Tevftk%?{cC5

diff --git a/lib/pytz/zoneinfo/Kwajalein b/lib/pytz/zoneinfo/Kwajalein
index 1a7975fad7f7e96f7101eb3c64c9b420eeebb621..1887a607422edd499fdf24afe91a04294f1caf6f 100644
GIT binary patch
delta 45
tcmdnPw2o<lG9%kW6$MsCCT2#KiGB${-g*ld&z6hJM%&QHPS?<g3jo>22(ADC

delta 59
zcmZ3-w1;VeG9&v$6$P&P|Ns9pGBGo<uuk+$01B<L;9~#+WMNw_E*ot_BRgF~BQ5|6
CdJnMx

diff --git a/lib/pytz/zoneinfo/Mexico/BajaNorte b/lib/pytz/zoneinfo/Mexico/BajaNorte
index ada6bf78b2815d3d99c97d521ab9a6b35c8af8c3..63dfdf48a68d02240737ecd6af081e02eb0b6317 100644
GIT binary patch
delta 551
zcmZ1`bWCW1xFiPy0|N+yz*Haxu_cyndr`2_Ac(1+nTdsol?_M?49vl1?f?Iid>9!1
z|DQX7f#v`I{ssmP7<=vnMjjBGQ2<PeKxBP<Ll}I6Ll^=;*ae8gfjA(9fq@a^XCMKk
cCy2{p4UGRl01A-J6PXvWjHnQq%*QDK004qi$p8QV

delta 519
zcmX>mv`lD%xFj0`0|N+yz*Haxu_cyn`_{10Ac(1+k%^g!g%wB)42;2M?f?Iid>9!1
z|DQX7f#v`I{ssmP5Sx()ObUQW5g*?W2H)Tih5!(D0pf5V4hR8xl7WE{LQW8u#p?P0
VKmZDW%?p_qu?*`Fn5@Ss0RTUKN9O<l

diff --git a/lib/pytz/zoneinfo/Mexico/BajaSur b/lib/pytz/zoneinfo/Mexico/BajaSur
index e4a785743d75f939c3e4798ebe7c79d38e4cfd08..06fa22749d0a3157b5a693f0797086f78e1201c5 100644
GIT binary patch
delta 340
zcmeyy{eokHxF9<N0|N+yfISeiFVtYHXJlewW?^Ds1(M{z|NrOMFfjc8KX(EH%m4qY
z7cg*uNJbu*NPh!^0EF%18^Yil9KzrX#J(;e3;{rzfsqI78U{u%h0TqdW10R8xGRN_
LUC9OXg*g`houxpM

delta 741
zcmcJM%_~Gv9EN|FX_|(bGd4<*g#|TTGet_11(TH<n!6e)3ub(cF+Qd{zV0byhht?!
zk+PYEA}N1>Vx!20Y;4R<Q5K@(yw|8%SXl6$PS5EqpC|8mEfbY~Dq6pKyLam~d$1wG
zhT8lTuNV-C>K95pw~OJA8ydN)6QlPhG<N6~<7d}AxsewW`^P+$z7Ufun>-zRWK;1h
zpKd*8Go5{WwkpRmjTU9zR+;6Ck#(D5*{3kgo%XW%%NknPONzw<qNU|-VXr-qR^lAH
zRCE2qk#Z|cB;~dsmz233@<_SPsT^;Oef@VCCK<k{Nge9;sB1(_`bpE#o%XKTkOx^H
zgkg{dLYzY-4}?Gr5<!T>AQOa85K=*i1tAxNU=Wf)CEDhAz%~fuAgqHh?@-wXQNW?9
z0HOqj8X$^br~;x4hB{zTp+X@0k1PGUP$5w5cOkD4HCt4wfYGFf^kBdU1@&e<==}t7
Cn5S<5

diff --git a/lib/pytz/zoneinfo/Mexico/General b/lib/pytz/zoneinfo/Mexico/General
index e7fb6f2953d123efbc2550f450decd794b017d4f..68176daa4976b015fb79026f3053e74e4a7457ab 100644
GIT binary patch
delta 383
zcmdnMbBuF>xF`n$0|N+yfC~_V*b*Cc1Q_cXnOK-vm{@_34NQVqq{9FI7xOSM{Qp09
z0t3tc|Em`;aDYfg9+=3^4U7W+{{u-8h^&uq2!n5M2!nHQh%AGz3y=ZA;UNqRj35UB
a0hGq&^35eo3QPm-bY;9w=K^}pj0*tXyh%?0

delta 714
zcmcJMJxBs!9EaaKZAb(qvLGm01G^N=p&<yPrEW<faEYQcvybab?DGzSpe2gtrl6Wa
zY3gImHK-|}t-ZIV2*Tb+8eD4gcl_@;ZhW3nW5Ija8W1&`RNoEinu|fdW>0lR#dN<e
zQ%$2zy8TtAKO)Y|cS&X*Tb$XK3z;o`I&-CaYyPP0ES#NNi%WNowYP6AC7;D|Dr>Fu
z-HO#A(^_jg5xJg>%zfD+?;Do+@`PA_>y{fgF|qmJlUt|b&i3WI+}Ry)?1Lw%={&Ba
z?$X`r>hK)fTA<^)pm{45_4bdL31P+)BE}7>8%v14%v`zkPTj^CdKiiznjosGRJtI_
zAle}6Ao?H*AsQhnAvz&SAzGPIYgd2Zm*E)Vnc=!h<(uKWO68s59^#+T0MY@{0@4H4
hH2F;uuTzug|4lq9P*ep9nh_&xgo0)`Wb_&#&kx-$oP_`Y

diff --git a/lib/pytz/zoneinfo/NZ-CHAT b/lib/pytz/zoneinfo/NZ-CHAT
index c00410988272dec2ae70ede88720b4a46146a4d1..bde46cf7e4b7909714b93cee39a5d953387d756c 100644
GIT binary patch
delta 53
wcmbOt&?YcJnXz%B3J((#Bg<q%_Ug$F>@1VlvRh7m&jgg%EX*vxf+~{^0C*@3-2eap

delta 53
zcmZn@m?AJinXzf33J()Y{r~^}CmS#|PTs&2%h<G;k6D0)g8>MT#H}XZVAlfx_~8=(

diff --git a/lib/pytz/zoneinfo/Navajo b/lib/pytz/zoneinfo/Navajo
index 5fbe26b1d93d1acb2561c390c1e097d07f1a262e..abb2b974a47eb3e5c8b4f5d4370baf4898b239ab 100644
GIT binary patch
delta 145
zcmeAXo+CU#T#$`{fdPa;U>*>&ZPch?;$~)Kf<PA5$s3s_PB!Bdn;gKb&dJEY2vh?k
pvFY5rjQI--F0G1itz5prA?Cg=Av(UsdPaH%I=+U6dWL!iTmY8~6#xJL

delta 141
zcmbOu+#@_eT#%K4fdPa;U>*>&Zq%q@;$~umLS~l98<{3fw&N6=9K)>0&cFy#$B0ee
n=5@?pSa4~Shic^V4GuB)bqUe&HP$oIGtluhG}JTHGvERMYMd1i

diff --git a/lib/pytz/zoneinfo/Pacific/Apia b/lib/pytz/zoneinfo/Pacific/Apia
index 999c367c3f201c957a8ab746ad89669c4c9ed5ca..e592a68e53f6215de9e1d1ac61ce062a333283c0 100644
GIT binary patch
delta 36
mcmaFDa*btzGNaT)m4eB?8KowRF}Y0q4&+akX1oCv@B;wr`V2h)

delta 49
wcmcb{@`PoAGNbfFl>(Of|Ns9_e#a;^acu^p^kgx{8ypNkfDm<^?8C$b0Q6!Lr2qf`

diff --git a/lib/pytz/zoneinfo/Pacific/Bougainville b/lib/pytz/zoneinfo/Pacific/Bougainville
index 2892d268094ea785b045e53cb441a551672aabd0..c535acdabda1b6ed96420e589d4f6868d23d8933 100644
GIT binary patch
delta 51
zcmeBS`o}myS%!syfdPaC8i2$ZXS0M$+BqLW=3Q@KWMZ7?;={-~aiReWBNH>z#B+84
DNWKkX

delta 65
zcmeyz*uykIS&@~2fq?~x1sZ_F8E3PEOWHXfLgrm>sQ>@}KO++(^F(_eMz)DP2E0Id
N28bXt6U)Q{b^vqU6j=ZO

diff --git a/lib/pytz/zoneinfo/Pacific/Chatham b/lib/pytz/zoneinfo/Pacific/Chatham
index c00410988272dec2ae70ede88720b4a46146a4d1..bde46cf7e4b7909714b93cee39a5d953387d756c 100644
GIT binary patch
delta 53
wcmbOt&?YcJnXz%B3J((#Bg<q%_Ug$F>@1VlvRh7m&jgg%EX*vxf+~{^0C*@3-2eap

delta 53
zcmZn@m?AJinXzf33J()Y{r~^}CmS#|PTs&2%h<G;k6D0)g8>MT#H}XZVAlfx_~8=(

diff --git a/lib/pytz/zoneinfo/Pacific/Chuuk b/lib/pytz/zoneinfo/Pacific/Chuuk
index 07c84b7110ad9589810b916390aedc7ef498f423..7be2474dd91c8a7da181fcda09d838254b890d75 100644
GIT binary patch
literal 172
zcmWHE%1kq2zzZ0GvP?kC(EucXoX#IWnxSU_1B;Ju2!pnv0YeC3LqG;F12OM^APCzQ
n#Q~y=-Y%KI2$X@C*!h8h1#B)S$lL&5sNq~TKr8HY4Gp*eA?O^n

literal 269
zcmWHE%1kq2zzf)bvMfN%(*Pu92rhoG!1CvZldrfEE(!8|sQ>@}KO++mGXDQ>a|Wn@
zp=SX|b=?F84hY-FH-tgk(11bPz>*<^ux;!>BUpi$2Waqrk%#+DKy;m%+7=KEvK>T&
qTmYg$t^m;>mw@c92eKKNn1PT9=A1qskOV$QaoGT!XQyjuzy$!|p-bif

diff --git a/lib/pytz/zoneinfo/Pacific/Easter b/lib/pytz/zoneinfo/Pacific/Easter
index cae3744096402e8a452336544edf96ca9ae5ad8d..184cb6a83b3392d0492c42297531c85e7e38c4f5 100644
GIT binary patch
delta 55
zcmdlfxLR<6GGq5fm7R>tvat@6A23!-KEU2R*@wetvI#R#W^)8{E;Cr_1ltFwR4xD)
CWD`^X

delta 81
zcmZ22xKnU~GGot1m7R>tB1#7)KVYn2tN;K1KO@WJ1SZkR`Aj8~Z8>}=>oWrtZ4PG6
SWd^G{%=Uqc0SGWu<^cejdK>Qm

diff --git a/lib/pytz/zoneinfo/Pacific/Efate b/lib/pytz/zoneinfo/Pacific/Efate
index d8d4093bc804be0730b5f5f530db42d55991afbf..777325fc6c6da8795d89aed5206c60f8bf80b0ab 100644
GIT binary patch
delta 73
ocmbQm(!(-AnNfVAN{Sc@BNH<V2Aq7G(RAVskdi+Ka4WF~0IFIG6aWAK

delta 93
zcmeBSnZ+_enNeb*N{V#-|NsA47@3$^FyX{`5kNKH56CkB0bX^cTwFHVhK6>!hK5`K
DwiFTI

diff --git a/lib/pytz/zoneinfo/Pacific/Enderbury b/lib/pytz/zoneinfo/Pacific/Enderbury
index 39b786e9601e1a0bc98aca6d8a55a97127775046..b1c4b0734483033722c28c8b2884ac9dddd2ab45 100644
GIT binary patch
delta 47
zcmaFGc!zO<vN$sX0|N^X3mn$D-5?akazLNeaswmNM0+1b=7~KDOdzJ_#0Oje7x)Yo

delta 69
zcmcb^_=<6YvJ49Y0|N*P9M-wrAQZ-OK%doeL;e5%{~4K>CtCS1vP^7O;0DSwz{NDV
OxNNiyjqP*|jky53i4#%)

diff --git a/lib/pytz/zoneinfo/Pacific/Fakaofo b/lib/pytz/zoneinfo/Pacific/Fakaofo
index e40307f6aab2a169bb957979f5580affb379131e..4905ea72b1640ca67e35b06395e1c700dffa8d21 100644
GIT binary patch
delta 41
tcmX@XxQlUuvJevk0|PS<^E3bnzrQm#FixB=KQU67k!fPB1S6262>`}23Qzz5

delta 75
zcmdnRc!F_)vN$sX0|N;2Gyn;|zcV+~|NsA=k!j*Y`H3OQ%5Yhr;Qu=F&<>y?uqqG@
HQ>h66Ksgv*

diff --git a/lib/pytz/zoneinfo/Pacific/Fiji b/lib/pytz/zoneinfo/Pacific/Fiji
index af07ac8faecad5ceddcff91412539c8c3648fa0a..acf8091ac85151a6c887e2b5049ee40754b7b0d3 100644
GIT binary patch
delta 108
zcmbQqv4uq?Bq}q_hygE<ov2bX*?>`YauTDG0wJ}NmoR>SDwgBove7m)vePv*;sOAK
CSq!!S

delta 497
zcmZY5u}cDR7{>8a65<N{1M;Y-&D8F0l0w=o8VbUu7sN!Z6cf)(J7{V(k!lNx{(%e{
z8pN?JS{mPG2XmLM_xVLr$HC_}zTc-ebvqr{-OnA^txv<RC0ff3H(h+-^x%my+n1c_
zUQ;%f=j_EP<${}>D|9$NigF?8@Zm?2j>0KEevVLaW{pcXK`IRmE<0l?zj|ERd#6e-
zMAeNESKHrITX^Hz2~%Br<oeEl&bY%3`<|M8htETOcJET`PPzehJ<n^8eREg-S@r9!
zmnGldf!>#^$%iAAawx>HN;w$fXr&wualBFjAR-__AYvebAfh0`AmWrm!(}{BsgzQP
zTBQ_2R4b(%qFyNrK&+sYB_P&-SOj7fh-DzwQBL&k@8kbU^Nad=*t8N6(-Q5(%9d$H
Nt>~&K*s*wA{{hxjtY-iK

diff --git a/lib/pytz/zoneinfo/Pacific/Funafuti b/lib/pytz/zoneinfo/Pacific/Funafuti
index ea728637ac1fa43f2d73469151c688468b34c3e3..47661d40a4188eb39e8d52e5af8ab23ef7f23766 100644
GIT binary patch
literal 152
zcmWHE%1kq2zzZ0GvP?kC(EucXoJA%;nqkEO1{NRR5C&~SBZd$X4EYZPb!I|muo}c=
M12oP~*U*Ry06;Jjs{jB1

literal 166
zcmWHE%1kq2zzdjwvLMXS03_=F|Nqa($iT3I1;}Aoae#rv$2WvQ+t7$1gang-hWxKH
U<M{(J1GkA>Hb8UjbPbKT0Kp&`eE<Le

diff --git a/lib/pytz/zoneinfo/Pacific/Galapagos b/lib/pytz/zoneinfo/Pacific/Galapagos
index 31f0921ea04cd201675b613082fb4b0b0b91941c..40051ddf63a32d79e5233b916e3911d6dc3ef759 100644
GIT binary patch
delta 53
zcmaFI_<(VOvJ49Y0|N;2Y+K^fASZDoKwF&afp+1S07hn}i3e3DW-2qXOzhQQ26J@*
Df%y)d

delta 73
zcmaFB_>OUcvLY)30|N^X^K4t<(;z2tBtTo7>w$LRmw@{J|Nk>GGcixJ_h4k5*rCA#
TRK$P~ROR5Z(KRr$GvfjPB*hf}

diff --git a/lib/pytz/zoneinfo/Pacific/Gambier b/lib/pytz/zoneinfo/Pacific/Gambier
index e1fc3daa55eb2bc8c5d6a78bd77a01d193a821a7..84acaf41520d2d302f75e300e2b47c5527218df4 100644
GIT binary patch
literal 150
zcmWHE%1kq2zzZ0GvP?kCF(tr*h4KIY#u^3&AX&h`;^P~_ple{s5JG|>|A7FfL0mRK
I<LoTC03XyE5&!@I

delta 61
ycmbQnxP)<nvJevk0|N+iObPH{ssI1~KjTCL3n{oLP~bmE2B?AoDl0m%j{^Yj(-MFH

diff --git a/lib/pytz/zoneinfo/Pacific/Guadalcanal b/lib/pytz/zoneinfo/Pacific/Guadalcanal
index 7e9d10a100f9cbe796d99945dd60e0430dced523..1ab8353464ddb93947f871f07cfd12540373269c 100644
GIT binary patch
literal 152
zcmWHE%1kq2zzZ0GvP?kCF~#4w2gsTF1*Ck|1_l-%-w+0ELqmoT5)And1UL=ivH==r
Jr)y})1pozy6$1bO

delta 61
ycmbQixQuavvJevk0|N+iOz}7FssI1~KjTCL3n{oLP~bmE2B?AoDl0m%j|%__dJ}2@

diff --git a/lib/pytz/zoneinfo/Pacific/Kanton b/lib/pytz/zoneinfo/Pacific/Kanton
index 39b786e9601e1a0bc98aca6d8a55a97127775046..b1c4b0734483033722c28c8b2884ac9dddd2ab45 100644
GIT binary patch
delta 47
zcmaFGc!zO<vN$sX0|N^X3mn$D-5?akazLNeaswmNM0+1b=7~KDOdzJ_#0Oje7x)Yo

delta 69
zcmcb^_=<6YvJ49Y0|N*P9M-wrAQZ-OK%doeL;e5%{~4K>CtCS1vP^7O;0DSwz{NDV
OxNNiyjqP*|jky53i4#%)

diff --git a/lib/pytz/zoneinfo/Pacific/Kiritimati b/lib/pytz/zoneinfo/Pacific/Kiritimati
index 7cae0cb7562e5c0f9fa46913b71a5c3628c01bbf..b4c6037a2d2a8f89539c3df05c32b6f52b1b1e92 100644
GIT binary patch
delta 55
zcmaFI_<(VOvN$sX0|N^X3pId<&`%8dtlA40nI_u%F)~l=Q(yuywYj)#v<*${bPY|o
E05(+$ssI20

delta 61
zcmaFB_>OUcvJ49Y0|N*PHGqiFPYn93+6(Ic|Nqa(#5{4e_QX_WMwW@43fw?h2Dq>(
E0PXb=(EtDd

diff --git a/lib/pytz/zoneinfo/Pacific/Kosrae b/lib/pytz/zoneinfo/Pacific/Kosrae
index a584aae5eb8187f88600e97b6d6c764245a37e65..0666fb0dd161cb732b29f84d49c49cc985a3559a 100644
GIT binary patch
delta 49
zcmcc5bdhO-G9$-C6%8InCPro^Mi$2Z|J{8iD>9l)oT$vmIdN+M2O|?R6ALpF>tr!T
FPXI0V3fTYv

delta 54
zcmcb}bf0O0G9%|i6%C&H|Ns9pGBGkUF|sgD431&snz$iAkO2rF63k32%uK9IlQ|eY
E0la1oOaK4?

diff --git a/lib/pytz/zoneinfo/Pacific/Kwajalein b/lib/pytz/zoneinfo/Pacific/Kwajalein
index 1a7975fad7f7e96f7101eb3c64c9b420eeebb621..1887a607422edd499fdf24afe91a04294f1caf6f 100644
GIT binary patch
delta 45
tcmdnPw2o<lG9%kW6$MsCCT2#KiGB${-g*ld&z6hJM%&QHPS?<g3jo>22(ADC

delta 59
zcmZ3-w1;VeG9&v$6$P&P|Ns9pGBGo<uuk+$01B<L;9~#+WMNw_E*ot_BRgF~BQ5|6
CdJnMx

diff --git a/lib/pytz/zoneinfo/Pacific/Majuro b/lib/pytz/zoneinfo/Pacific/Majuro
index 9ef8374de4fa73cd2a3359d3c3886b11643a7146..47661d40a4188eb39e8d52e5af8ab23ef7f23766 100644
GIT binary patch
literal 152
zcmWHE%1kq2zzZ0GvP?kC(EucXoJA%;nqkEO1{NRR5C&~SBZd$X4EYZPb!I|muo}c=
M12oP~*U*Ry06;Jjs{jB1

literal 310
zcmWHE%1kq2zzaBlvaCQX(f}l82u{7Q!1CvZgKteQoP5QVaNgFv;D4KRK>h#!{~4JW
znVA?_SQr=<fRr-K+Q0y0*G*smn$WX=fro)%#Q_EZAKwrLZ9_u_Z39anZ2-hZ3?U@A
z0%+0yIx~?55Djt-hz7X`M1x!fqCqYL(O}ns7(f?-TvQKalJ80`8=zb5bPbKT0DetZ
Aa{vGU

diff --git a/lib/pytz/zoneinfo/Pacific/Marquesas b/lib/pytz/zoneinfo/Pacific/Marquesas
index 74d6792bf6fcb791bfc0af1f827737f612abef67..f546c03f96b24859521aab5b9997bfc5dd124ead 100644
GIT binary patch
delta 44
mcmZ3>IG=HXGA|<o0|OHfb4>~G@tA08B?uSz4+LPrP89&ju?u7X

delta 72
zcmbQwxR!B(vJevk0|N+iO$qSvsQ>@}KjTCLD=D}rP~bmE2B?AoDl5**Wut3gX>4F;
JX=QA{1pwL56m0+i

diff --git a/lib/pytz/zoneinfo/Pacific/Nauru b/lib/pytz/zoneinfo/Pacific/Nauru
index acec0429f147f40279107a48cb85c3b0e9f56c94..3339b6cf86d6e98ba70c9bd6cab3dbf50588acd2 100644
GIT binary patch
delta 53
zcmeyv_>OUcvJ49Y0|N*PEq<=ea%RHI6PKLTKL{$Wc)`fTIPtjl#C&B&mWh)!n893A
E0L%yx82|tP

delta 75
zcmaFI_=j<VvLY)30|N^X3oU-G&2nbK%M+KJ)jtR-u6R-Z|NnnRCPwCo_I`}46Z<rH
VfQlFpg4$eMHrj?pcDjZ}Tma2p7rp=h

diff --git a/lib/pytz/zoneinfo/Pacific/Niue b/lib/pytz/zoneinfo/Pacific/Niue
index 89117b377325529e65994174eb5a2fe90e1f39ff..f76972f8849a7d6ed8c3e2649b02f44de891094f 100644
GIT binary patch
delta 41
ucmX@jxR-H)vJevk0|PS<^W9&V<@0sfjs(Vu3l%3uD>E`pte0Q}a<l;RybL%1

literal 203
zcmWHE%1kq2zzdjxvLMWNe_@u-*JV2r>i_@$&&b5||9`?31_mIxfPv-z|I`2mE+5|z
p23<o#BLfi05JG~{KokFij0e#mD?kpa2eOH<hRX(MnVq2_7XTJlG)@2j

diff --git a/lib/pytz/zoneinfo/Pacific/Norfolk b/lib/pytz/zoneinfo/Pacific/Norfolk
index 53c1aad4e0a541ee3c2c4c6de33a79ca93a7d244..3b4186d61152629b764efc4222e41647b65f7fbb 100644
GIT binary patch
delta 52
vcmeys_K0nQGNaZ+l?^P6Ow243A1F=yz%rSU*?)2nBT#&E8Dj(^s!TorpHmMJ

delta 64
zcmaFF_JM7JGNblHl?@#A|NsAIWMXESe340M;s=(Ae~THlHy1KSF!C?}0fubAWG7|?
E034(j-T(jq

diff --git a/lib/pytz/zoneinfo/Pacific/Noumea b/lib/pytz/zoneinfo/Pacific/Noumea
index 931a1a306f70eb0c7578a65425086270c6ea2b88..959cc8cd26f8a7b10a70e0f93bf3b3c9bbc680d2 100644
GIT binary patch
delta 39
kcmdnMw1{bfG9&v$6%{rnMj&LK_|0HqGe~5)16;%k0Jc^MJOBUy

delta 61
zcmZ3)w1H`YG9$-C6&3FK|Ns9pF#;ho%S69mpx7b@eg+^w5jWuCve7m)w9_>-<N^Q}
C`45c%

diff --git a/lib/pytz/zoneinfo/Pacific/Palau b/lib/pytz/zoneinfo/Pacific/Palau
index 146b35152aaeffb5940d30910ba37703f4096285..1cbebe28afd90c0a2e02786655e18a157284a412 100644
GIT binary patch
delta 33
mcmdnOxQuavGA|<o0|OHfb2I>niKZ5eOcV1Y7#Sx{Pyqm8{RRgB

delta 67
zcmZ3+xP@_ovJevk0|N+iGysYE|Ns9pPBgGkW(IOVm;)&AU*zHW91vY+X7&as22sT{
Hu}K90ncNr&

diff --git a/lib/pytz/zoneinfo/Pacific/Pitcairn b/lib/pytz/zoneinfo/Pacific/Pitcairn
index ef91b061bb145b2658d49fd5065ed74b1a6cf6f7..5ee90e70203d72484b8752475c86139671bcb102 100644
GIT binary patch
delta 41
scmX@bxQB6qvJevk0|PS<^EChoQx_)=#)%6RCq^qXGEJ<PU<7hB0i>h|j{pDw

literal 202
zcmWHE%1kq2zzdjxvLMXY03=LZoH*+L|Nqa(#Pt7v8xI4+|Nk8o3@rcu_ct(b`S^w~
n=o(lU8-PfL5E6_An)tuYT<;6e2Cx+%nn-K7Y=D;8S#SXWD_|-E

diff --git a/lib/pytz/zoneinfo/Pacific/Pohnpei b/lib/pytz/zoneinfo/Pacific/Pohnpei
index c298ddd4debb649220e5dfde60948591bc6a3501..1ab8353464ddb93947f871f07cfd12540373269c 100644
GIT binary patch
literal 152
zcmWHE%1kq2zzZ0GvP?kCF~#4w2gsTF1*Ck|1_l-%-w+0ELqmoT5)And1UL=ivH==r
Jr)y})1pozy6$1bO

literal 303
zcmWHE%1kq2zzf)cvaCQX&;TT62u{7Q!1CvZgKteQoP5QVa7mEwL;e5%{~4JWnVA?F
z|NnQo0#wB?YXbud14G>e1`Y;>o&^j%5D_2W5C&~SLk4XFOCW8)5JK2;pne86AQk}H
z@n7WOP8|?kXQr?QM1vdyqCpM<(I7{GXpqA|G{|uv*VF^qj7-c-EX+(yFc(e<0m%^O
OPA(gutL=0R4Y>eZAz3j1

diff --git a/lib/pytz/zoneinfo/Pacific/Ponape b/lib/pytz/zoneinfo/Pacific/Ponape
index c298ddd4debb649220e5dfde60948591bc6a3501..1ab8353464ddb93947f871f07cfd12540373269c 100644
GIT binary patch
literal 152
zcmWHE%1kq2zzZ0GvP?kCF~#4w2gsTF1*Ck|1_l-%-w+0ELqmoT5)And1UL=ivH==r
Jr)y})1pozy6$1bO

literal 303
zcmWHE%1kq2zzf)cvaCQX&;TT62u{7Q!1CvZgKteQoP5QVa7mEwL;e5%{~4JWnVA?F
z|NnQo0#wB?YXbud14G>e1`Y;>o&^j%5D_2W5C&~SLk4XFOCW8)5JK2;pne86AQk}H
z@n7WOP8|?kXQr?QM1vdyqCpM<(I7{GXpqA|G{|uv*VF^qj7-c-EX+(yFc(e<0m%^O
OPA(gutL=0R4Y>eZAz3j1

diff --git a/lib/pytz/zoneinfo/Pacific/Port_Moresby b/lib/pytz/zoneinfo/Pacific/Port_Moresby
index 920ad27e629e350c1baac8537bb639a59fd19039..7be2474dd91c8a7da181fcda09d838254b890d75 100644
GIT binary patch
delta 33
mcmdnRxQ20pGA|<o0|OHfb2I>niKZ5eOcV1Y7#Sx{&;kHsg9aG@

delta 67
zcmZ3(xQlUuvJevk0|N+iGysYE|Ns9pPBgGkW(IOVm=`GUKWtkR2Z%0uyJP}T45Er@
HVv`mCnC%!F

diff --git a/lib/pytz/zoneinfo/Pacific/Rarotonga b/lib/pytz/zoneinfo/Pacific/Rarotonga
index eea37aba3724b3517c275dffd57e49bed205c5e0..184a87c112b99536acbafa1ec7aba52c7a94b549 100644
GIT binary patch
delta 34
lcmcc3a+YO+GNa5ym5PZAWF{*x8BKf-<W3f5d;#HG0|3u}3vK`a

delta 58
zcmX@ha+_s>GNbH7l?t}{|Ns9pGEH0{!NkHmS&+$i;wzxUWIo0hTns>fCTjx#NpKQk

diff --git a/lib/pytz/zoneinfo/Pacific/Tahiti b/lib/pytz/zoneinfo/Pacific/Tahiti
index 442b8eb5a438985092d8657ebcabe8859037482a..481edd30580f00eccf69de4f1c332fc048210011 100644
GIT binary patch
literal 151
zcmWHE%1kq2zzZ0GvP?kCF(n{$2jl<$#U~gTfMfy#i;r&zgRY?gLkJ0m{09P@265Q{
Kjk7Z}-~s@xxEtgE

delta 61
ycmbQvxRh~%vJevk0|N+iObH0xQUCw{f5wRh7E*9gpum5S3{V9FR919iA144DFBAm;

diff --git a/lib/pytz/zoneinfo/Pacific/Tarawa b/lib/pytz/zoneinfo/Pacific/Tarawa
index 3db6c750333fa6dc1efc84b1abc24528fbc00b0b..47661d40a4188eb39e8d52e5af8ab23ef7f23766 100644
GIT binary patch
literal 152
zcmWHE%1kq2zzZ0GvP?kC(EucXoJA%;nqkEO1{NRR5C&~SBZd$X4EYZPb!I|muo}c=
M12oP~*U*Ry06;Jjs{jB1

delta 61
ycmbQixQuavvJevk0|N+iGysYE|Ns9pPBgHPf{OwL{@0laodHV1WJM?TaRC6>H4-=g

diff --git a/lib/pytz/zoneinfo/Pacific/Tongatapu b/lib/pytz/zoneinfo/Pacific/Tongatapu
index c2e5999bb2cbfb7a8059004f8a593d454b49d3be..c8824ab5434985650f33e12eace1981f8b116207 100644
GIT binary patch
delta 47
ocmeyu^o(hOG9%YS6$4I2CT12^CLo-w%V;}sK1lR%1d6CT0P;u(-T(jq

delta 61
wcmaFH^o41HG9&jy6$8Hd|Ns9pGBLBTGJ)V^c}Clbvp`b&B7_)#07Kdx049$Q!~g&Q

diff --git a/lib/pytz/zoneinfo/Pacific/Truk b/lib/pytz/zoneinfo/Pacific/Truk
index 07c84b7110ad9589810b916390aedc7ef498f423..7be2474dd91c8a7da181fcda09d838254b890d75 100644
GIT binary patch
literal 172
zcmWHE%1kq2zzZ0GvP?kC(EucXoX#IWnxSU_1B;Ju2!pnv0YeC3LqG;F12OM^APCzQ
n#Q~y=-Y%KI2$X@C*!h8h1#B)S$lL&5sNq~TKr8HY4Gp*eA?O^n

literal 269
zcmWHE%1kq2zzf)bvMfN%(*Pu92rhoG!1CvZldrfEE(!8|sQ>@}KO++mGXDQ>a|Wn@
zp=SX|b=?F84hY-FH-tgk(11bPz>*<^ux;!>BUpi$2Waqrk%#+DKy;m%+7=KEvK>T&
qTmYg$t^m;>mw@c92eKKNn1PT9=A1qskOV$QaoGT!XQyjuzy$!|p-bif

diff --git a/lib/pytz/zoneinfo/Pacific/Wake b/lib/pytz/zoneinfo/Pacific/Wake
index c9e310670f07e9e577791bfa19fefde61351fcdf..47661d40a4188eb39e8d52e5af8ab23ef7f23766 100644
GIT binary patch
literal 152
zcmWHE%1kq2zzZ0GvP?kC(EucXoJA%;nqkEO1{NRR5C&~SBZd$X4EYZPb!I|muo}c=
M12oP~*U*Ry06;Jjs{jB1

literal 166
zcmWHE%1kq2zzdjwvLMXS03_=F|Nqa($iOhi1ju1nae#rv$2WvQ+t7$1gang-hWxKH
UlQ;u11GkA>Hb8UjbPbKT0M2k3p#T5?

diff --git a/lib/pytz/zoneinfo/Pacific/Wallis b/lib/pytz/zoneinfo/Pacific/Wallis
index b35344b312c6ca690c0f79a858c3995a05c71ff3..47661d40a4188eb39e8d52e5af8ab23ef7f23766 100644
GIT binary patch
literal 152
zcmWHE%1kq2zzZ0GvP?kC(EucXoJA%;nqkEO1{NRR5C&~SBZd$X4EYZPb!I|muo}c=
M12oP~*U*Ry06;Jjs{jB1

literal 166
zcmWHE%1kq2zzdjwvLMXS03_=F|Nqa($iT2B0?1)lae#rv$2WvQ+t7$1gang-hWxKH
U<5&SQ1GkA>Hb8UjbPbKT0O8CT)c^nh

diff --git a/lib/pytz/zoneinfo/Pacific/Yap b/lib/pytz/zoneinfo/Pacific/Yap
index 07c84b7110ad9589810b916390aedc7ef498f423..7be2474dd91c8a7da181fcda09d838254b890d75 100644
GIT binary patch
literal 172
zcmWHE%1kq2zzZ0GvP?kC(EucXoX#IWnxSU_1B;Ju2!pnv0YeC3LqG;F12OM^APCzQ
n#Q~y=-Y%KI2$X@C*!h8h1#B)S$lL&5sNq~TKr8HY4Gp*eA?O^n

literal 269
zcmWHE%1kq2zzf)bvMfN%(*Pu92rhoG!1CvZldrfEE(!8|sQ>@}KO++mGXDQ>a|Wn@
zp=SX|b=?F84hY-FH-tgk(11bPz>*<^ux;!>BUpi$2Waqrk%#+DKy;m%+7=KEvK>T&
qTmYg$t^m;>mw@c92eKKNn1PT9=A1qskOV$QaoGT!XQyjuzy$!|p-bif

diff --git a/lib/pytz/zoneinfo/Singapore b/lib/pytz/zoneinfo/Singapore
index 2364b2178b03853b1771cb3f34b964fdb82e2e91..adb41cf4caca6096052d7a82cf6adb568f3cee3a 100644
GIT binary patch
delta 48
ucmey*^pR<TG9$-C6%BSqCT12^Hr9y|B|!dJ4+KAulgmciz`{<~f(rl%0tux6

delta 57
wcmey!^q*;hG9%|i6%C&H|Ns9pGBLBTvazyH7H15cxCA6|!b5-o2+$;>0RJ%$=>Px#

diff --git a/lib/pytz/zoneinfo/Turkey b/lib/pytz/zoneinfo/Turkey
index 508446bb6aee2841ab88e82607a6ad6e748e7db7..7c2336dd80c3c9cbf71cb53d2b2c1f89a65a8ba5 100644
GIT binary patch
delta 59
zcmbQu-^)KinX!1I$`wXN#>tFKT9Xg3u}r?h<}z84y>RkFCZODAR^|oF7?M>07Q+#g

delta 58
zcmeC>pUpo(nXzP}$`wYI`v3p`PhP-QJUNSLDr3ne<^{|g3_yS+T*S#`qitYpr)$gw
E0G=%r%m4rY

diff --git a/lib/pytz/zoneinfo/US/Arizona b/lib/pytz/zoneinfo/US/Arizona
index ac6bb0c78291f1e341f42c34639458fb385bf8ed..ab37e845566aa95659b7b85be0051d0c67a7e53a 100644
GIT binary patch
delta 134
zcmX@X^nz)ExF9P70|N+y05=e`PSh}9WSK0$sHE`!|J(@-96r7w48ATv91O(aAz+1!
WAd(TQ?#(d}-D-q%a{&!B=K=r{d=}#X

delta 102
zcmaFCbb@JuxF7=(;0Cf;CTbWkGEG)sR1)y<4Po$g0pegF4i90#s`_vYM70>YYA&EQ
Gb1ncA<q&TG

diff --git a/lib/pytz/zoneinfo/US/Central b/lib/pytz/zoneinfo/US/Central
index a5b1617c7f70bfc77b7d504aaa3f23603082c3cb..c6981a06b1d9c26f447518efe265a6454726eae7 100644
GIT binary patch
delta 155
zcmew%-61nUT#$o-fdPa;;0+LSY}DAo%*Z_XA+y3{1r`=Q7A8hGWM!Ky$g+KMAFtTt
idA#Plj0_Aw1SS|6uo<=4fi;DlD6=@>W=+1sD+2%_Qx^~b

delta 139
zcmeB>`5`?)T#%iCfdPa;;0+M7Z`9brJXw%Mm5-T;5e`{cfkN9SA7c@l{D{Snn}LB5
atN}=2Gh(v`YYIC7Gk|u2&6xa#R|Wu-P87-j

diff --git a/lib/pytz/zoneinfo/US/East-Indiana b/lib/pytz/zoneinfo/US/East-Indiana
index 09511ccdcf97a5baa8e1b0eb75e040eee6b6e0c4..a84b6e99671f7305d1c459956e16a4dd772fc60e 100644
GIT binary patch
delta 321
zcmZqToy0pqT#$o-fdPa;AQ^}`Hfl^@<YZ=K0znqm$p;yQBiWeP*r@>j|6gy#!0`Y7
z&JBz#|NpOEz`!wCoynG$k%19xJDA4iqRrEpWSHscBvlkAak&PEn7X=z==d7z8R;45
N_!=7O8R{8u0RTxGC_n%J

delta 305
zcmbQl+r&FTT#%iCfdPa;AQ_0+H)>2^<YZz5LuQuA2N{KfS(#Ybr~v=}UvI_0@c;kL
z4U8<44cKhC85qIVf+%b***u>~hM7K2QATnKmuql{sjEwfj<2zvk)DB$uc4uyp`HO3
E0D)T}6aWAK

diff --git a/lib/pytz/zoneinfo/US/Eastern b/lib/pytz/zoneinfo/US/Eastern
index 2f75480e069b60b6c58a9137c7eebd4796f74226..a8b9ab1992257d721ad627b14f535c3d4b020888 100644
GIT binary patch
delta 139
zcmca0{XlwxxF8z?0|N+yz#AZD+o-XHnUQ(&L>>bs7S_pvEZZkn@rq6E;#KElWMBj;
r0Fv0WZPsB;VaKXZ5w4HRH8{l7)g?s7*I3U;&p^l5&`{4%&wvX6q0|@_

delta 131
zcmaDLeL;GHxF9P70|N+yz#AZD-KepJd9omjArmtTklH@^7>n5CM=Xl$42&QpjM%hn
mHepR+$D&6bs)x%pIK<S|B}B*9SkFk$K*!h6P|r}$fC~UHpBN4R

diff --git a/lib/pytz/zoneinfo/US/Indiana-Starke b/lib/pytz/zoneinfo/US/Indiana-Starke
index fcd408d74df43310a9a85c475f83d545f6d75911..025d132dd48ba978c6fedf86d70173127be49d49 100644
GIT binary patch
delta 152
zcmew()FV7WT#$o-fdPa;U=|Q_Y}CkMVrOM!Vq{`wnS78*o{??xM<yd6`GLu9vJSHn
n%jyLT9Fu*RHMtqVniv>?G&X}aFJr#KLX=4yFq0-Ha!LaLn_U^_

delta 138
zcmeAX{v$L&T#%iCfdPa;U=|RwZ`8<PVrOCmLS~l92bts<StoyFG6IqxnCvF&Fe^=V
f;#B7ZD`#M2V8CX==5@?hSO^)x1~FoCA*VC|8HE=u

diff --git a/lib/pytz/zoneinfo/US/Mountain b/lib/pytz/zoneinfo/US/Mountain
index 5fbe26b1d93d1acb2561c390c1e097d07f1a262e..abb2b974a47eb3e5c8b4f5d4370baf4898b239ab 100644
GIT binary patch
delta 145
zcmeAXo+CU#T#$`{fdPa;U>*>&ZPch?;$~)Kf<PA5$s3s_PB!Bdn;gKb&dJEY2vh?k
pvFY5rjQI--F0G1itz5prA?Cg=Av(UsdPaH%I=+U6dWL!iTmY8~6#xJL

delta 141
zcmbOu+#@_eT#%K4fdPa;U>*>&Zq%q@;$~umLS~l98<{3fw&N6=9K)>0&cFy#$B0ee
n=5@?pSa4~Shic^V4GuB)bqUe&HP$oIGtluhG}JTHGvERMYMd1i

diff --git a/lib/pytz/zoneinfo/US/Pacific b/lib/pytz/zoneinfo/US/Pacific
index 9dad4f4c75b373635ccbe634798f8d9e587e36c1..610e7af5fc13d9784de30d272c7c39d7938873a0 100644
GIT binary patch
delta 134
zcmbOtwnS`#xF8z?0|N+yz%C$W+o<t|iJg^^iIIt!WwIdG`pE`B`T&<4+yDRl4GbKU
f?{P`8GlEnzGGf!d*@)!|D*^p%5dD*Xb4daKf-xG6

delta 89
zcmZ1?HbrcLxF9P70|N+yz%C$W-Kg<~iIHhCKiBoiZ@45`K;n}HStKwOZnk2%!iuhv
Hn_Ch9qWcdk

diff --git a/lib/pytz/zoneinfo/leapseconds b/lib/pytz/zoneinfo/leapseconds
index ffa5eb80..6826ac4a 100644
--- a/lib/pytz/zoneinfo/leapseconds
+++ b/lib/pytz/zoneinfo/leapseconds
@@ -72,11 +72,11 @@ Leap	2016	Dec	31	23:59:60	+	S
 # Any additional leap seconds will come after this.
 # This Expires line is commented out for now,
 # so that pre-2020a zic implementations do not reject this file.
-#Expires 2022	Dec	28	00:00:00
+#Expires 2023	Jun	28	00:00:00
 
 # POSIX timestamps for the data in this file:
 #updated 1467936000 (2016-07-08 00:00:00 UTC)
-#expires 1672185600 (2022-12-28 00:00:00 UTC)
+#expires 1687910400 (2023-06-28 00:00:00 UTC)
 
-#	Updated through IERS Bulletin C63
-#	File expires on:  28 December 2022
+#	Updated through IERS Bulletin C64
+#	File expires on:  28 June 2023
diff --git a/lib/pytz/zoneinfo/tzdata.zi b/lib/pytz/zoneinfo/tzdata.zi
index e21fc920..d8c78d47 100644
--- a/lib/pytz/zoneinfo/tzdata.zi
+++ b/lib/pytz/zoneinfo/tzdata.zi
@@ -43,16 +43,6 @@ Z Africa/Ndjamena 1:0:12 - LMT 1912
 1 - WAT
 Z Africa/Abidjan -0:16:8 - LMT 1912
 0 - GMT
-L Africa/Abidjan Africa/Accra
-L Africa/Abidjan Africa/Bamako
-L Africa/Abidjan Africa/Banjul
-L Africa/Abidjan Africa/Conakry
-L Africa/Abidjan Africa/Dakar
-L Africa/Abidjan Africa/Freetown
-L Africa/Abidjan Africa/Lome
-L Africa/Abidjan Africa/Nouakchott
-L Africa/Abidjan Africa/Ouagadougou
-L Africa/Abidjan Atlantic/St_Helena
 R K 1940 o - Jul 15 0 1 S
 R K 1940 o - O 1 0 0 -
 R K 1941 o - Ap 15 0 1 S
@@ -96,15 +86,6 @@ Z Africa/Nairobi 2:27:16 - LMT 1908 May
 2:30 - +0230 1936 D 31 24
 2:45 - +0245 1942 Jul 31 24
 3 - EAT
-L Africa/Nairobi Africa/Addis_Ababa
-L Africa/Nairobi Africa/Asmara
-L Africa/Nairobi Africa/Dar_es_Salaam
-L Africa/Nairobi Africa/Djibouti
-L Africa/Nairobi Africa/Kampala
-L Africa/Nairobi Africa/Mogadishu
-L Africa/Nairobi Indian/Antananarivo
-L Africa/Nairobi Indian/Comoro
-L Africa/Nairobi Indian/Mayotte
 Z Africa/Monrovia -0:43:8 - LMT 1882
 -0:43:8 - MMT 1919 Mar
 -0:44:30 - MMT 1972 Ja 7
@@ -335,13 +316,6 @@ Z Africa/El_Aaiun -0:52:48 - LMT 1934
 1 M +01/+00
 Z Africa/Maputo 2:10:20 - LMT 1903 Mar
 2 - CAT
-L Africa/Maputo Africa/Blantyre
-L Africa/Maputo Africa/Bujumbura
-L Africa/Maputo Africa/Gaborone
-L Africa/Maputo Africa/Harare
-L Africa/Maputo Africa/Kigali
-L Africa/Maputo Africa/Lubumbashi
-L Africa/Maputo Africa/Lusaka
 R NA 1994 o - Mar 21 0 -1 WAT
 R NA 1994 2017 - S Su>=1 2 0 CAT
 R NA 1995 2017 - Ap Su>=1 2 -1 WAT
@@ -356,31 +330,16 @@ Z Africa/Lagos 0:13:35 - LMT 1905 Jul
 0:13:35 - LMT 1914
 0:30 - +0030 1919 S
 1 - WAT
-L Africa/Lagos Africa/Bangui
-L Africa/Lagos Africa/Brazzaville
-L Africa/Lagos Africa/Douala
-L Africa/Lagos Africa/Kinshasa
-L Africa/Lagos Africa/Libreville
-L Africa/Lagos Africa/Luanda
-L Africa/Lagos Africa/Malabo
-L Africa/Lagos Africa/Niamey
-L Africa/Lagos Africa/Porto-Novo
-Z Indian/Reunion 3:41:52 - LMT 1911 Jun
-4 - +04
 Z Africa/Sao_Tome 0:26:56 - LMT 1884
 -0:36:45 - LMT 1912 Ja 1 0u
 0 - GMT 2018 Ja 1 1
 1 - WAT 2019 Ja 1 2
 0 - GMT
-Z Indian/Mahe 3:41:48 - LMT 1907
-4 - +04
 R SA 1942 1943 - S Su>=15 2 1 -
 R SA 1943 1944 - Mar Su>=15 2 0 -
 Z Africa/Johannesburg 1:52 - LMT 1892 F 8
 1:30 - SAST 1903 Mar
 2 SA SAST
-L Africa/Johannesburg Africa/Maseru
-L Africa/Johannesburg Africa/Mbabane
 R SD 1970 o - May 1 0 1 S
 R SD 1970 1985 - O 15 0 0 -
 R SD 1971 o - Ap 30 0 1 S
@@ -445,14 +404,10 @@ Z Antarctica/Davis 0 - -00 1957 Ja 13
 Z Antarctica/Mawson 0 - -00 1954 F 13
 6 - +06 2009 O 18 2
 5 - +05
-Z Indian/Kerguelen 0 - -00 1950
-5 - +05
 R Tr 2005 ma - Mar lastSu 1u 2 +02
 R Tr 2004 ma - O lastSu 1u 0 +00
 Z Antarctica/Troll 0 - -00 2005 F 12
 0 Tr %s
-Z Antarctica/Vostok 0 - -00 1957 D 16
-6 - +06
 Z Antarctica/Rothera 0 - -00 1976 D
 -3 - -03
 Z Asia/Kabul 4:36:48 - LMT 1890
@@ -491,9 +446,6 @@ Z Asia/Thimphu 5:58:36 - LMT 1947 Au 15
 Z Indian/Chagos 4:49:40 - LMT 1907
 5 - +05 1996
 6 - +06
-Z Asia/Brunei 7:39:40 - LMT 1926 Mar
-7:30 - +0730 1933
-8 - +08
 Z Asia/Yangon 6:24:47 - LMT 1880
 6:24:47 - RMT 1920
 6:30 - +0630 1942 May
@@ -535,7 +487,7 @@ R HK 1965 1976 - O Su>=16 3:30 0 -
 R HK 1973 o - D 30 3:30 1 S
 R HK 1979 o - May 13 3:30 1 S
 R HK 1979 o - O 21 3:30 0 -
-Z Asia/Hong_Kong 7:36:42 - LMT 1904 O 30 0:36:42
+Z Asia/Hong_Kong 7:36:42 - LMT 1904 O 29 17u
 8 - HKT 1941 Jun 15 3
 8 1 HKST 1941 O 1 4
 8 0:30 HKWT 1941 D 25
@@ -608,7 +560,6 @@ Z Asia/Famagusta 2:15:48 - LMT 1921 N 14
 2 E EE%sT 2016 S 8
 3 - +03 2017 O 29 1u
 2 E EE%sT
-L Asia/Nicosia Europe/Nicosia
 Z Asia/Tbilisi 2:59:11 - LMT 1880
 2:59:11 - TBMT 1924 May 2
 3 - +03 1957 Mar
@@ -634,7 +585,7 @@ Z Asia/Kolkata 5:53:28 - LMT 1854 Jun 28
 5:30 1 +0630 1945 O 15
 5:30 - IST
 Z Asia/Jakarta 7:7:12 - LMT 1867 Au 10
-7:7:12 - BMT 1923 D 31 23:47:12
+7:7:12 - BMT 1923 D 31 16:40u
 7:20 - +0720 1932 N
 7:30 - +0730 1942 Mar 23
 9 - +09 1945 S 23
@@ -660,9 +611,14 @@ Z Asia/Jayapura 9:22:48 - LMT 1932 N
 9 - +09 1944 S
 9:30 - +0930 1964
 9 - WIT
-R i 1978 1980 - Mar 20 24 1 -
-R i 1978 o - O 20 24 0 -
+R i 1910 o - Ja 1 0 0 -
+R i 1977 o - Mar 21 23 1 -
+R i 1977 o - O 20 24 0 -
+R i 1978 o - Mar 24 24 1 -
+R i 1978 o - Au 5 1 0 -
+R i 1979 o - May 26 24 1 -
 R i 1979 o - S 18 24 0 -
+R i 1980 o - Mar 20 24 1 -
 R i 1980 o - S 22 24 0 -
 R i 1991 o - May 2 24 1 -
 R i 1992 1995 - Mar 21 24 1 -
@@ -693,77 +649,11 @@ R i 2017 2019 - Mar 21 24 1 -
 R i 2017 2019 - S 21 24 0 -
 R i 2020 o - Mar 20 24 1 -
 R i 2020 o - S 20 24 0 -
-R i 2021 2023 - Mar 21 24 1 -
-R i 2021 2023 - S 21 24 0 -
-R i 2024 o - Mar 20 24 1 -
-R i 2024 o - S 20 24 0 -
-R i 2025 2027 - Mar 21 24 1 -
-R i 2025 2027 - S 21 24 0 -
-R i 2028 2029 - Mar 20 24 1 -
-R i 2028 2029 - S 20 24 0 -
-R i 2030 2031 - Mar 21 24 1 -
-R i 2030 2031 - S 21 24 0 -
-R i 2032 2033 - Mar 20 24 1 -
-R i 2032 2033 - S 20 24 0 -
-R i 2034 2035 - Mar 21 24 1 -
-R i 2034 2035 - S 21 24 0 -
-R i 2036 2037 - Mar 20 24 1 -
-R i 2036 2037 - S 20 24 0 -
-R i 2038 2039 - Mar 21 24 1 -
-R i 2038 2039 - S 21 24 0 -
-R i 2040 2041 - Mar 20 24 1 -
-R i 2040 2041 - S 20 24 0 -
-R i 2042 2043 - Mar 21 24 1 -
-R i 2042 2043 - S 21 24 0 -
-R i 2044 2045 - Mar 20 24 1 -
-R i 2044 2045 - S 20 24 0 -
-R i 2046 2047 - Mar 21 24 1 -
-R i 2046 2047 - S 21 24 0 -
-R i 2048 2049 - Mar 20 24 1 -
-R i 2048 2049 - S 20 24 0 -
-R i 2050 2051 - Mar 21 24 1 -
-R i 2050 2051 - S 21 24 0 -
-R i 2052 2053 - Mar 20 24 1 -
-R i 2052 2053 - S 20 24 0 -
-R i 2054 2055 - Mar 21 24 1 -
-R i 2054 2055 - S 21 24 0 -
-R i 2056 2057 - Mar 20 24 1 -
-R i 2056 2057 - S 20 24 0 -
-R i 2058 2059 - Mar 21 24 1 -
-R i 2058 2059 - S 21 24 0 -
-R i 2060 2062 - Mar 20 24 1 -
-R i 2060 2062 - S 20 24 0 -
-R i 2063 o - Mar 21 24 1 -
-R i 2063 o - S 21 24 0 -
-R i 2064 2066 - Mar 20 24 1 -
-R i 2064 2066 - S 20 24 0 -
-R i 2067 o - Mar 21 24 1 -
-R i 2067 o - S 21 24 0 -
-R i 2068 2070 - Mar 20 24 1 -
-R i 2068 2070 - S 20 24 0 -
-R i 2071 o - Mar 21 24 1 -
-R i 2071 o - S 21 24 0 -
-R i 2072 2074 - Mar 20 24 1 -
-R i 2072 2074 - S 20 24 0 -
-R i 2075 o - Mar 21 24 1 -
-R i 2075 o - S 21 24 0 -
-R i 2076 2078 - Mar 20 24 1 -
-R i 2076 2078 - S 20 24 0 -
-R i 2079 o - Mar 21 24 1 -
-R i 2079 o - S 21 24 0 -
-R i 2080 2082 - Mar 20 24 1 -
-R i 2080 2082 - S 20 24 0 -
-R i 2083 o - Mar 21 24 1 -
-R i 2083 o - S 21 24 0 -
-R i 2084 2086 - Mar 20 24 1 -
-R i 2084 2086 - S 20 24 0 -
-R i 2087 o - Mar 21 24 1 -
-R i 2087 o - S 21 24 0 -
-R i 2088 ma - Mar 20 24 1 -
-R i 2088 ma - S 20 24 0 -
+R i 2021 2022 - Mar 21 24 1 -
+R i 2021 2022 - S 21 24 0 -
 Z Asia/Tehran 3:25:44 - LMT 1916
-3:25:44 - TMT 1946
-3:30 - +0330 1977 N
+3:25:44 - TMT 1935 Jun 13
+3:30 i +0330/+0430 1977 O 20 24
 4 i +04/+05 1979
 3:30 i +0330/+0430
 R IQ 1982 o - May 1 0 1 -
@@ -902,10 +792,11 @@ R J 2005 o - S lastF 0s 0 -
 R J 2006 2011 - O lastF 0s 0 -
 R J 2013 o - D 20 0 0 -
 R J 2014 2021 - Mar lastTh 24 1 S
-R J 2014 ma - O lastF 0s 0 -
-R J 2022 ma - F lastTh 24 1 S
+R J 2014 2022 - O lastF 0s 0 -
+R J 2022 o - F lastTh 24 1 S
 Z Asia/Amman 2:23:44 - LMT 1931
-2 J EE%sT
+2 J EE%sT 2022 O 28 0s
+3 - +03
 Z Asia/Almaty 5:7:48 - LMT 1924 May 2
 5 - +05 1930 Jun 21
 6 R +06/+07 1991 Mar 31 2s
@@ -1034,15 +925,6 @@ Z Asia/Beirut 2:22 - LMT 1880
 2 l EE%sT
 R NB 1935 1941 - S 14 0 0:20 -
 R NB 1935 1941 - D 14 0 0 -
-Z Asia/Kuala_Lumpur 6:46:46 - LMT 1901
-6:55:25 - SMT 1905 Jun
-7 - +07 1933
-7 0:20 +0720 1936
-7:20 - +0720 1941 S
-7:30 - +0730 1942 F 16
-9 - +09 1945 S 12
-7:30 - +0730 1982
-8 - +08
 Z Asia/Kuching 7:21:20 - LMT 1926 Mar
 7:30 - +0730 1933
 8 NB +08/+0820 1942 F 16
@@ -1107,14 +989,16 @@ R P 2013 o - S 27 0 0 -
 R P 2014 o - O 24 0 0 -
 R P 2015 o - Mar 28 0 1 S
 R P 2015 o - O 23 1 0 -
-R P 2016 2018 - Mar Sa>=24 1 1 S
-R P 2016 2018 - O Sa>=24 1 0 -
+R P 2016 2018 - Mar Sa<=30 1 1 S
+R P 2016 2018 - O Sa<=30 1 0 -
 R P 2019 o - Mar 29 0 1 S
-R P 2019 o - O Sa>=24 0 0 -
-R P 2020 2021 - Mar Sa>=24 0 1 S
+R P 2019 o - O Sa<=30 0 0 -
+R P 2020 2021 - Mar Sa<=30 0 1 S
 R P 2020 o - O 24 1 0 -
-R P 2021 ma - O F>=23 1 0 -
-R P 2022 ma - Mar Su>=25 0 1 S
+R P 2021 o - O 29 1 0 -
+R P 2022 o - Mar 27 0 1 S
+R P 2022 ma - O Sa<=30 2 0 -
+R P 2023 ma - Mar Sa<=30 2 1 S
 Z Asia/Gaza 2:17:52 - LMT 1900 O
 2 Z EET/EEST 1948 May 15
 2 K EE%sT 1967 Jun 5
@@ -1147,12 +1031,8 @@ Z Asia/Manila -15:56 - LMT 1844 D 31
 Z Asia/Qatar 3:26:8 - LMT 1920
 4 - +04 1972 Jun
 3 - +03
-L Asia/Qatar Asia/Bahrain
 Z Asia/Riyadh 3:6:52 - LMT 1947 Mar 14
 3 - +03
-L Asia/Riyadh Antarctica/Syowa
-L Asia/Riyadh Asia/Aden
-L Asia/Riyadh Asia/Kuwait
 Z Asia/Singapore 6:55:25 - LMT 1901
 6:55:25 - SMT 1905 Jun
 7 - +07 1933
@@ -1210,20 +1090,19 @@ R S 2008 o - Ap F>=1 0 1 S
 R S 2008 o - N 1 0 0 -
 R S 2009 o - Mar lastF 0 1 S
 R S 2010 2011 - Ap F>=1 0 1 S
-R S 2012 ma - Mar lastF 0 1 S
-R S 2009 ma - O lastF 0 0 -
+R S 2012 2022 - Mar lastF 0 1 S
+R S 2009 2022 - O lastF 0 0 -
 Z Asia/Damascus 2:25:12 - LMT 1920
-2 S EE%sT
+2 S EE%sT 2022 O 28
+3 - +03
 Z Asia/Dushanbe 4:35:12 - LMT 1924 May 2
 5 - +05 1930 Jun 21
 6 R +06/+07 1991 Mar 31 2s
-5 1 +05/+06 1991 S 9 2s
+5 1 +06 1991 S 9 2s
 5 - +05
 Z Asia/Bangkok 6:42:4 - LMT 1880
 6:42:4 - BMT 1920 Ap
 7 - +07
-L Asia/Bangkok Asia/Phnom_Penh
-L Asia/Bangkok Asia/Vientiane
 Z Asia/Ashgabat 3:53:32 - LMT 1924 May 2
 4 - +04 1930 Jun 21
 5 R +05/+06 1991 Mar 31 2
@@ -1231,7 +1110,6 @@ Z Asia/Ashgabat 3:53:32 - LMT 1924 May 2
 5 - +05
 Z Asia/Dubai 3:41:12 - LMT 1920
 4 - +04
-L Asia/Dubai Asia/Muscat
 Z Asia/Samarkand 4:27:53 - LMT 1924 May 2
 4 - +04 1930 Jun 21
 5 - +05 1981 Ap
@@ -1244,7 +1122,7 @@ Z Asia/Tashkent 4:37:11 - LMT 1924 May 2
 6 R +06/+07 1991 Mar 31 2
 5 R +05/+06 1992
 5 - +05
-Z Asia/Ho_Chi_Minh 7:6:40 - LMT 1906 Jul
+Z Asia/Ho_Chi_Minh 7:6:30 - LMT 1906 Jul
 7:6:30 - PLMT 1911 May
 7 - +07 1942 D 31 23
 8 - +08 1945 Mar 14 23
@@ -1407,10 +1285,6 @@ Z Antarctica/Macquarie 0 - -00 1899 N
 10 AT AE%sT 2010
 10 1 AEDT 2011
 10 AT AE%sT
-Z Indian/Christmas 7:2:52 - LMT 1895 F
-7 - +07
-Z Indian/Cocos 6:27:40 - LMT 1900
-6:30 - +0630
 R FJ 1998 1999 - N Su>=1 2 1 -
 R FJ 1999 2000 - F lastSu 3 0 -
 R FJ 2009 o - N 29 2 1 -
@@ -1423,8 +1297,6 @@ R FJ 2014 2018 - N Su>=1 2 1 -
 R FJ 2015 2021 - Ja Su>=12 3 0 -
 R FJ 2019 o - N Su>=8 2 1 -
 R FJ 2020 o - D 20 2 1 -
-R FJ 2022 ma - N Su>=8 2 1 -
-R FJ 2023 ma - Ja Su>=12 3 0 -
 Z Pacific/Fiji 11:55:44 - LMT 1915 O 26
 12 FJ +12/+13
 Z Pacific/Gambier -8:59:48 - LMT 1912 O
@@ -1453,7 +1325,6 @@ Z Pacific/Guam -14:21 - LMT 1844 D 31
 9 - +09 1944 Jul 31
 10 Gu G%sT 2000 D 23
 10 - ChST
-L Pacific/Guam Pacific/Saipan
 Z Pacific/Tarawa 11:32:4 - LMT 1901
 12 - +12
 Z Pacific/Kanton 0 - -00 1937 Au 31
@@ -1464,14 +1335,6 @@ Z Pacific/Kiritimati -10:29:20 - LMT 1901
 -10:40 - -1040 1979 O
 -10 - -10 1994 D 31
 14 - +14
-Z Pacific/Majuro 11:24:48 - LMT 1901
-11 - +11 1914 O
-9 - +09 1919 F
-11 - +11 1937
-10 - +10 1941 Ap
-9 - +09 1944 Ja 30
-11 - +11 1969 O
-12 - +12
 Z Pacific/Kwajalein 11:9:20 - LMT 1901
 11 - +11 1937
 10 - +10 1941 Ap
@@ -1479,21 +1342,6 @@ Z Pacific/Kwajalein 11:9:20 - LMT 1901
 11 - +11 1969 O
 -12 - -12 1993 Au 20 24
 12 - +12
-Z Pacific/Chuuk -13:52:52 - LMT 1844 D 31
-10:7:8 - LMT 1901
-10 - +10 1914 O
-9 - +09 1919 F
-10 - +10 1941 Ap
-9 - +09 1945 Au
-10 - +10
-Z Pacific/Pohnpei -13:27:8 - LMT 1844 D 31
-10:32:52 - LMT 1901
-11 - +11 1914 O
-9 - +09 1919 F
-11 - +11 1937
-10 - +10 1941 Ap
-9 - +09 1945 Au
-11 - +11
 Z Pacific/Kosrae -13:8:4 - LMT 1844 D 31
 10:51:56 - LMT 1901
 11 - +11 1914 O
@@ -1546,7 +1394,6 @@ Z Pacific/Auckland 11:39:4 - LMT 1868 N 2
 Z Pacific/Chatham 12:13:48 - LMT 1868 N 2
 12:15 - +1215 1946
 12:45 k +1245/+1345
-L Pacific/Auckland Antarctica/McMurdo
 R CK 1978 o - N 12 0 0:30 -
 R CK 1979 1991 - Mar Su>=1 0 0 -
 R CK 1979 1990 - O lastSu 0 0:30 -
@@ -1570,7 +1417,6 @@ Z Pacific/Palau -15:2:4 - LMT 1844 D 31
 Z Pacific/Port_Moresby 9:48:40 - LMT 1880
 9:48:32 - PMMT 1895
 10 - +10
-L Pacific/Port_Moresby Antarctica/DumontDUrville
 Z Pacific/Bougainville 10:22:16 - LMT 1880
 9:48:32 - PMMT 1895
 10 - +10 1942 Jul
@@ -1583,7 +1429,6 @@ Z Pacific/Pitcairn -8:40:20 - LMT 1901
 Z Pacific/Pago_Pago 12:37:12 - LMT 1892 Jul 5
 -11:22:48 - LMT 1911
 -11 - SST
-L Pacific/Pago_Pago Pacific/Midway
 R WS 2010 o - S lastSu 0 1 -
 R WS 2011 o - Ap Sa>=1 4 0 -
 R WS 2011 o - S lastSa 3 1 -
@@ -1609,10 +1454,6 @@ Z Pacific/Tongatapu 12:19:12 - LMT 1945 S 10
 12:20 - +1220 1961
 13 - +13 1999
 13 TO +13/+14
-Z Pacific/Funafuti 11:56:52 - LMT 1901
-12 - +12
-Z Pacific/Wake 11:6:28 - LMT 1901
-12 - +12
 R VU 1973 o - D 22 12u 1 -
 R VU 1974 o - Mar 30 12u 0 -
 R VU 1983 1991 - S Sa>=22 24 1 -
@@ -1621,8 +1462,6 @@ R VU 1992 1993 - Ja Sa>=22 24 0 -
 R VU 1992 o - O Sa>=22 24 1 -
 Z Pacific/Efate 11:13:16 - LMT 1912 Ja 13
 11 VU +11/+12
-Z Pacific/Wallis 12:15:20 - LMT 1901
-12 - +12
 R G 1916 o - May 21 2s 1 BST
 R G 1916 o - O 1 2s 0 GMT
 R G 1917 o - Ap 8 2s 1 BST
@@ -1688,14 +1527,11 @@ R G 1972 1980 - O Su>=23 2s 0 GMT
 R G 1981 1995 - Mar lastSu 1u 1 BST
 R G 1981 1989 - O Su>=23 1u 0 GMT
 R G 1990 1995 - O Su>=22 1u 0 GMT
-Z Europe/London -0:1:15 - LMT 1847 D 1 0s
+Z Europe/London -0:1:15 - LMT 1847 D
 0 G %s 1968 O 27
 1 - BST 1971 O 31 2u
 0 G %s 1996
 0 E GMT/BST
-L Europe/London Europe/Jersey
-L Europe/London Europe/Guernsey
-L Europe/London Europe/Isle_of_Man
 R IE 1971 o - O 31 2u -1 -
 R IE 1972 1980 - Mar Su>=16 2u 0 -
 R IE 1972 1980 - O Su>=23 2u -1 -
@@ -1703,7 +1539,7 @@ R IE 1981 ma - Mar lastSu 1u 0 -
 R IE 1981 1989 - O Su>=23 1u -1 -
 R IE 1990 1995 - O Su>=22 1u -1 -
 R IE 1996 ma - O lastSu 1u -1 -
-Z Europe/Dublin -0:25 - LMT 1880 Au 2
+Z Europe/Dublin -0:25:21 - LMT 1880 Au 2
 -0:25:21 - DMT 1916 May 21 2s
 -0:25:21 1 IST 1916 O 1 2s
 0 G %s 1921 D 6
@@ -1899,23 +1735,6 @@ Z Europe/Prague 0:57:44 - LMT 1850
 1 -1 GMT 1947 F 23 2
 1 CZ CE%sT 1979
 1 E CE%sT
-R D 1916 o - May 14 23 1 S
-R D 1916 o - S 30 23 0 -
-R D 1940 o - May 15 0 1 S
-R D 1945 o - Ap 2 2s 1 S
-R D 1945 o - Au 15 2s 0 -
-R D 1946 o - May 1 2s 1 S
-R D 1946 o - S 1 2s 0 -
-R D 1947 o - May 4 2s 1 S
-R D 1947 o - Au 10 2s 0 -
-R D 1948 o - May 9 2s 1 S
-R D 1948 o - Au 8 2s 0 -
-Z Europe/Copenhagen 0:50:20 - LMT 1890
-0:50:20 - CMT 1894
-1 D CE%sT 1942 N 2 2s
-1 c CE%sT 1945 Ap 2 2
-1 D CE%sT 1980
-1 E CE%sT
 Z Atlantic/Faroe -0:27:4 - LMT 1908 Ja 11
 0 - WET 1981
 0 E WE%sT
@@ -1959,7 +1778,6 @@ Z Europe/Helsinki 1:39:49 - LMT 1878 May 31
 1:39:49 - HMT 1921 May
 2 FI EE%sT 1983
 2 E EE%sT
-L Europe/Helsinki Europe/Mariehamn
 R F 1916 o - Jun 14 23s 1 S
 R F 1916 1919 - O Su>=1 23s 0 -
 R F 1917 o - Mar 24 23s 1 S
@@ -2025,8 +1843,7 @@ Z Europe/Berlin 0:53:28 - LMT 1893 Ap
 1 So CE%sT 1946
 1 DE CE%sT 1980
 1 E CE%sT
-L Europe/Zurich Europe/Busingen
-Z Europe/Gibraltar -0:21:24 - LMT 1880 Au 2 0s
+Z Europe/Gibraltar -0:21:24 - LMT 1880 Au 2
 0 G %s 1957 Ap 14 2
 1 - CET 1982
 1 E CE%sT
@@ -2080,25 +1897,6 @@ Z Europe/Budapest 1:16:20 - LMT 1890 N
 1 c CE%sT 1945
 1 h CE%sT 1984
 1 E CE%sT
-R w 1917 1919 - F 19 23 1 -
-R w 1917 o - O 21 1 0 -
-R w 1918 1919 - N 16 1 0 -
-R w 1921 o - Mar 19 23 1 -
-R w 1921 o - Jun 23 1 0 -
-R w 1939 o - Ap 29 23 1 -
-R w 1939 o - O 29 2 0 -
-R w 1940 o - F 25 2 1 -
-R w 1940 1941 - N Su>=2 1s 0 -
-R w 1941 1942 - Mar Su>=2 1s 1 -
-R w 1943 1946 - Mar Su>=1 1s 1 -
-R w 1942 1948 - O Su>=22 1s 0 -
-R w 1947 1967 - Ap Su>=1 1s 1 -
-R w 1949 o - O 30 1s 0 -
-R w 1950 1966 - O Su>=22 1s 0 -
-R w 1967 o - O 29 1s 0 -
-Z Atlantic/Reykjavik -1:28 - LMT 1908
--1 w -01/+00 1968 Ap 7 1s
-0 - GMT
 R I 1916 o - Jun 3 24 1 S
 R I 1916 1917 - S 30 24 0 -
 R I 1917 o - Mar 31 24 1 S
@@ -2141,13 +1939,11 @@ R I 1977 1979 - May Su>=22 0s 1 S
 R I 1978 o - O 1 0s 0 -
 R I 1979 o - S 30 0s 0 -
 Z Europe/Rome 0:49:56 - LMT 1866 D 12
-0:49:56 - RMT 1893 O 31 23:49:56
+0:49:56 - RMT 1893 O 31 23u
 1 I CE%sT 1943 S 10
 1 c CE%sT 1944 Jun 4
 1 I CE%sT 1980
 1 E CE%sT
-L Europe/Rome Europe/Vatican
-L Europe/Rome Europe/San_Marino
 R LV 1989 1996 - Mar lastSu 2s 1 S
 R LV 1989 1996 - S lastSu 2s 0 -
 Z Europe/Riga 1:36:34 - LMT 1880
@@ -2165,7 +1961,6 @@ Z Europe/Riga 1:36:34 - LMT 1880
 2 E EE%sT 2000 F 29
 2 - EET 2001 Ja 2
 2 E EE%sT
-L Europe/Zurich Europe/Vaduz
 Z Europe/Vilnius 1:41:16 - LMT 1880
 1:24 - WMT 1917
 1:35:36 - KMT 1919 O 10
@@ -2181,36 +1976,6 @@ Z Europe/Vilnius 1:41:16 - LMT 1880
 1 E CE%sT 1999 O 31 1u
 2 - EET 2003
 2 E EE%sT
-R LX 1916 o - May 14 23 1 S
-R LX 1916 o - O 1 1 0 -
-R LX 1917 o - Ap 28 23 1 S
-R LX 1917 o - S 17 1 0 -
-R LX 1918 o - Ap M>=15 2s 1 S
-R LX 1918 o - S M>=15 2s 0 -
-R LX 1919 o - Mar 1 23 1 S
-R LX 1919 o - O 5 3 0 -
-R LX 1920 o - F 14 23 1 S
-R LX 1920 o - O 24 2 0 -
-R LX 1921 o - Mar 14 23 1 S
-R LX 1921 o - O 26 2 0 -
-R LX 1922 o - Mar 25 23 1 S
-R LX 1922 o - O Su>=2 1 0 -
-R LX 1923 o - Ap 21 23 1 S
-R LX 1923 o - O Su>=2 2 0 -
-R LX 1924 o - Mar 29 23 1 S
-R LX 1924 1928 - O Su>=2 1 0 -
-R LX 1925 o - Ap 5 23 1 S
-R LX 1926 o - Ap 17 23 1 S
-R LX 1927 o - Ap 9 23 1 S
-R LX 1928 o - Ap 14 23 1 S
-R LX 1929 o - Ap 20 23 1 S
-Z Europe/Luxembourg 0:24:36 - LMT 1904 Jun
-1 LX CE%sT 1918 N 25
-0 LX WE%sT 1929 O 6 2s
-0 b WE%sT 1940 May 14 3
-1 c WE%sT 1944 S 18 3
-1 b CE%sT 1977
-1 E CE%sT
 R MT 1973 o - Mar 31 0s 1 S
 R MT 1973 o - S 29 0s 0 -
 R MT 1974 o - Ap 21 0s 1 S
@@ -2218,7 +1983,7 @@ R MT 1974 o - S 16 0s 0 -
 R MT 1975 1979 - Ap Su>=15 2 1 S
 R MT 1975 1980 - S Su>=15 2 0 -
 R MT 1980 o - Mar 31 2 1 S
-Z Europe/Malta 0:58:4 - LMT 1893 N 2 0s
+Z Europe/Malta 0:58:4 - LMT 1893 N 2
 1 I CE%sT 1973 Mar 31
 1 MT CE%sT 1981
 1 E CE%sT
@@ -2234,50 +1999,6 @@ Z Europe/Chisinau 1:55:20 - LMT 1880
 2 R EE%sT 1992
 2 e EE%sT 1997
 2 MD EE%sT
-Z Europe/Monaco 0:29:32 - LMT 1892 Jun
-0:9:21 - PMT 1911 Mar 29
-0 F WE%sT 1945 S 16 3
-1 F CE%sT 1977
-1 E CE%sT
-R N 1916 o - May 1 0 1 NST
-R N 1916 o - O 1 0 0 AMT
-R N 1917 o - Ap 16 2s 1 NST
-R N 1917 o - S 17 2s 0 AMT
-R N 1918 1921 - Ap M>=1 2s 1 NST
-R N 1918 1921 - S lastM 2s 0 AMT
-R N 1922 o - Mar lastSu 2s 1 NST
-R N 1922 1936 - O Su>=2 2s 0 AMT
-R N 1923 o - Jun F>=1 2s 1 NST
-R N 1924 o - Mar lastSu 2s 1 NST
-R N 1925 o - Jun F>=1 2s 1 NST
-R N 1926 1931 - May 15 2s 1 NST
-R N 1932 o - May 22 2s 1 NST
-R N 1933 1936 - May 15 2s 1 NST
-R N 1937 o - May 22 2s 1 NST
-R N 1937 o - Jul 1 0 1 S
-R N 1937 1939 - O Su>=2 2s 0 -
-R N 1938 1939 - May 15 2s 1 S
-R N 1945 o - Ap 2 2s 1 S
-R N 1945 o - S 16 2s 0 -
-Z Europe/Amsterdam 0:19:32 - LMT 1835
-0:19:32 N %s 1937 Jul
-0:20 N +0020/+0120 1940 May 16
-1 c CE%sT 1945 Ap 2 2
-1 N CE%sT 1977
-1 E CE%sT
-R NO 1916 o - May 22 1 1 S
-R NO 1916 o - S 30 0 0 -
-R NO 1945 o - Ap 2 2s 1 S
-R NO 1945 o - O 1 2s 0 -
-R NO 1959 1964 - Mar Su>=15 2s 1 S
-R NO 1959 1965 - S Su>=15 2s 0 -
-R NO 1965 o - Ap 25 2s 1 S
-Z Europe/Oslo 0:43 - LMT 1895
-1 NO CE%sT 1940 Au 10 23
-1 c CE%sT 1945 Ap 2 2
-1 NO CE%sT 1980
-1 E CE%sT
-L Europe/Oslo Arctic/Longyearbyen
 R O 1918 1919 - S 16 2s 0 -
 R O 1919 o - Ap 15 2s 1 S
 R O 1944 o - Ap 3 2s 1 S
@@ -2434,9 +2155,8 @@ Z Europe/Simferopol 2:16:24 - LMT 1880
 3 - MSK 1990 Jul 1 2
 2 - EET 1992 Mar 20
 2 c EE%sT 1994 May
-3 e MSK/MSD 1996 Mar 31 0s
+3 c MSK/MSD 1996 Mar 31 0s
 3 1 MSD 1996 O 27 3s
-3 R MSK/MSD 1997
 3 - MSK 1997 Mar lastSu 1u
 2 E EE%sT 2014 Mar 30 2
 4 - MSK 2014 O 26 2s
@@ -2647,12 +2367,6 @@ Z Europe/Belgrade 1:22 - LMT 1884
 1 1 CEST 1945 S 16 2s
 1 - CET 1982 N 27
 1 E CE%sT
-L Europe/Belgrade Europe/Ljubljana
-L Europe/Belgrade Europe/Podgorica
-L Europe/Belgrade Europe/Sarajevo
-L Europe/Belgrade Europe/Skopje
-L Europe/Belgrade Europe/Zagreb
-L Europe/Prague Europe/Bratislava
 R s 1918 o - Ap 15 23 1 S
 R s 1918 1919 - O 6 24s 0 -
 R s 1919 o - Ap 6 23 1 S
@@ -2692,11 +2406,11 @@ R Sp 1976 o - Au 1 0 0 -
 R Sp 1977 o - S 28 0 0 -
 R Sp 1978 o - Jun 1 0 1 S
 R Sp 1978 o - Au 4 0 0 -
-Z Europe/Madrid -0:14:44 - LMT 1900 D 31 23:45:16
+Z Europe/Madrid -0:14:44 - LMT 1901 Ja 1 0u
 0 s WE%sT 1940 Mar 16 23
 1 s CE%sT 1979
 1 E CE%sT
-Z Africa/Ceuta -0:21:16 - LMT 1900 D 31 23:38:44
+Z Africa/Ceuta -0:21:16 - LMT 1901 Ja 1 0u
 0 - WET 1918 May 6 23
 0 1 WEST 1918 O 7 23
 0 - WET 1924
@@ -2710,12 +2424,6 @@ Z Atlantic/Canary -1:1:36 - LMT 1922 Mar
 0 - WET 1980 Ap 6 0s
 0 1 WEST 1980 S 28 1u
 0 E WE%sT
-Z Europe/Stockholm 1:12:12 - LMT 1879
-1:0:14 - SET 1900
-1 - CET 1916 May 14 23
-1 1 CEST 1916 O 1 1
-1 - CET 1980
-1 E CE%sT
 R CH 1941 1942 - May M>=1 1 1 S
 R CH 1941 1942 - O M>=1 2 0 -
 Z Europe/Zurich 0:34:8 - LMT 1853 Jul 16
@@ -2780,8 +2488,7 @@ Z Europe/Istanbul 1:55:52 - LMT 1880
 2 1 EEST 2015 N 8 1u
 2 E EE%sT 2016 S 7
 3 - +03
-L Europe/Istanbul Asia/Istanbul
-Z Europe/Kiev 2:2:4 - LMT 1880
+Z Europe/Kyiv 2:2:4 - LMT 1880
 2:2:4 - KMT 1924 May 2
 2 - EET 1930 Jun 21
 3 - MSK 1941 S 20
@@ -2790,26 +2497,6 @@ Z Europe/Kiev 2:2:4 - LMT 1880
 2 1 EEST 1991 S 29 3
 2 c EE%sT 1996 May 13
 2 E EE%sT
-Z Europe/Uzhgorod 1:29:12 - LMT 1890 O
-1 - CET 1940
-1 c CE%sT 1944 O
-1 1 CEST 1944 O 26
-1 - CET 1945 Jun 29
-3 R MSK/MSD 1990
-3 - MSK 1990 Jul 1 2
-1 - CET 1991 Mar 31 3
-2 - EET 1992 Mar 20
-2 c EE%sT 1996 May 13
-2 E EE%sT
-Z Europe/Zaporozhye 2:20:40 - LMT 1880
-2:20 - +0220 1924 May 2
-2 - EET 1930 Jun 21
-3 - MSK 1941 Au 25
-1 c CE%sT 1943 O 25
-3 R MSK/MSD 1991 Mar 31 2
-2 e EE%sT 1992 Mar 20
-2 c EE%sT 1996 May 13
-2 E EE%sT
 R u 1918 1919 - Mar lastSu 2 1 D
 R u 1918 1919 - O lastSu 2 0 S
 R u 1942 o - F 9 2 1 W
@@ -2835,7 +2522,7 @@ R NY 1920 o - O lastSu 2 0 S
 R NY 1921 1966 - Ap lastSu 2 1 D
 R NY 1921 1954 - S lastSu 2 0 S
 R NY 1955 1966 - O lastSu 2 0 S
-Z America/New_York -4:56:2 - LMT 1883 N 18 12:3:58
+Z America/New_York -4:56:2 - LMT 1883 N 18 17u
 -5 u E%sT 1920
 -5 NY E%sT 1942
 -5 u E%sT 1946
@@ -2847,7 +2534,7 @@ R Ch 1921 o - Mar lastSu 2 1 D
 R Ch 1922 1966 - Ap lastSu 2 1 D
 R Ch 1922 1954 - S lastSu 2 0 S
 R Ch 1955 1966 - O lastSu 2 0 S
-Z America/Chicago -5:50:36 - LMT 1883 N 18 12:9:24
+Z America/Chicago -5:50:36 - LMT 1883 N 18 18u
 -6 u C%sT 1920
 -6 Ch C%sT 1936 Mar 1 2
 -5 - EST 1936 N 15 2
@@ -2855,13 +2542,13 @@ Z America/Chicago -5:50:36 - LMT 1883 N 18 12:9:24
 -6 u C%sT 1946
 -6 Ch C%sT 1967
 -6 u C%sT
-Z America/North_Dakota/Center -6:45:12 - LMT 1883 N 18 12:14:48
+Z America/North_Dakota/Center -6:45:12 - LMT 1883 N 18 19u
 -7 u M%sT 1992 O 25 2
 -6 u C%sT
-Z America/North_Dakota/New_Salem -6:45:39 - LMT 1883 N 18 12:14:21
+Z America/North_Dakota/New_Salem -6:45:39 - LMT 1883 N 18 19u
 -7 u M%sT 2003 O 26 2
 -6 u C%sT
-Z America/North_Dakota/Beulah -6:47:7 - LMT 1883 N 18 12:12:53
+Z America/North_Dakota/Beulah -6:47:7 - LMT 1883 N 18 19u
 -7 u M%sT 2010 N 7 2
 -6 u C%sT
 R De 1920 1921 - Mar lastSu 2 1 D
@@ -2869,7 +2556,7 @@ R De 1920 o - O lastSu 2 0 S
 R De 1921 o - May 22 2 0 S
 R De 1965 1966 - Ap lastSu 2 1 D
 R De 1965 1966 - O lastSu 2 0 S
-Z America/Denver -6:59:56 - LMT 1883 N 18 12:0:4
+Z America/Denver -6:59:56 - LMT 1883 N 18 19u
 -7 u M%sT 1920
 -7 De M%sT 1942
 -7 u M%sT 1946
@@ -2880,7 +2567,7 @@ R CA 1949 o - Ja 1 2 0 S
 R CA 1950 1966 - Ap lastSu 1 1 D
 R CA 1950 1961 - S lastSu 2 0 S
 R CA 1962 1966 - O lastSu 2 0 S
-Z America/Los_Angeles -7:52:58 - LMT 1883 N 18 12:7:2
+Z America/Los_Angeles -7:52:58 - LMT 1883 N 18 20u
 -8 u P%sT 1946
 -8 CA P%sT 1967
 -8 u P%sT
@@ -2950,15 +2637,14 @@ Z Pacific/Honolulu -10:31:26 - LMT 1896 Ja 13 12
 -10:30 1 HDT 1933 May 21 12
 -10:30 u H%sT 1947 Jun 8 2
 -10 - HST
-Z America/Phoenix -7:28:18 - LMT 1883 N 18 11:31:42
+Z America/Phoenix -7:28:18 - LMT 1883 N 18 19u
 -7 u M%sT 1944 Ja 1 0:1
 -7 - MST 1944 Ap 1 0:1
 -7 u M%sT 1944 O 1 0:1
 -7 - MST 1967
 -7 u M%sT 1968 Mar 21
 -7 - MST
-L America/Phoenix America/Creston
-Z America/Boise -7:44:49 - LMT 1883 N 18 12:15:11
+Z America/Boise -7:44:49 - LMT 1883 N 18 20u
 -8 u P%sT 1923 May 13 2
 -7 u M%sT 1974
 -7 - MST 1974 F 3 2
@@ -2966,7 +2652,7 @@ Z America/Boise -7:44:49 - LMT 1883 N 18 12:15:11
 R In 1941 o - Jun 22 2 1 D
 R In 1941 1954 - S lastSu 2 0 S
 R In 1946 1954 - Ap lastSu 2 1 D
-Z America/Indiana/Indianapolis -5:44:38 - LMT 1883 N 18 12:15:22
+Z America/Indiana/Indianapolis -5:44:38 - LMT 1883 N 18 18u
 -6 u C%sT 1920
 -6 In C%sT 1942
 -6 u C%sT 1946
@@ -2981,7 +2667,7 @@ R Ma 1951 o - Ap lastSu 2 1 D
 R Ma 1951 o - S lastSu 2 0 S
 R Ma 1954 1960 - Ap lastSu 2 1 D
 R Ma 1954 1960 - S lastSu 2 0 S
-Z America/Indiana/Marengo -5:45:23 - LMT 1883 N 18 12:14:37
+Z America/Indiana/Marengo -5:45:23 - LMT 1883 N 18 18u
 -6 u C%sT 1951
 -6 Ma C%sT 1961 Ap 30 2
 -5 - EST 1969
@@ -2999,7 +2685,7 @@ R V 1956 1963 - Ap lastSu 2 1 D
 R V 1960 o - O lastSu 2 0 S
 R V 1961 o - S lastSu 2 0 S
 R V 1962 1963 - O lastSu 2 0 S
-Z America/Indiana/Vincennes -5:50:7 - LMT 1883 N 18 12:9:53
+Z America/Indiana/Vincennes -5:50:7 - LMT 1883 N 18 18u
 -6 u C%sT 1946
 -6 V C%sT 1964 Ap 26 2
 -5 - EST 1969
@@ -3011,7 +2697,7 @@ R Pe 1955 o - May 1 0 1 D
 R Pe 1955 1960 - S lastSu 2 0 S
 R Pe 1956 1963 - Ap lastSu 2 1 D
 R Pe 1961 1963 - O lastSu 2 0 S
-Z America/Indiana/Tell_City -5:47:3 - LMT 1883 N 18 12:12:57
+Z America/Indiana/Tell_City -5:47:3 - LMT 1883 N 18 18u
 -6 u C%sT 1946
 -6 Pe C%sT 1964 Ap 26 2
 -5 - EST 1967 O 29 2
@@ -3023,7 +2709,7 @@ R Pi 1955 o - May 1 0 1 D
 R Pi 1955 1960 - S lastSu 2 0 S
 R Pi 1956 1964 - Ap lastSu 2 1 D
 R Pi 1961 1964 - O lastSu 2 0 S
-Z America/Indiana/Petersburg -5:49:7 - LMT 1883 N 18 12:10:53
+Z America/Indiana/Petersburg -5:49:7 - LMT 1883 N 18 18u
 -6 u C%sT 1955
 -6 Pi C%sT 1965 Ap 25 2
 -5 - EST 1966 O 30 2
@@ -3036,7 +2722,7 @@ R St 1947 1954 - S lastSu 2 0 S
 R St 1955 1956 - O lastSu 2 0 S
 R St 1957 1958 - S lastSu 2 0 S
 R St 1959 1961 - O lastSu 2 0 S
-Z America/Indiana/Knox -5:46:30 - LMT 1883 N 18 12:13:30
+Z America/Indiana/Knox -5:46:30 - LMT 1883 N 18 18u
 -6 u C%sT 1947
 -6 St C%sT 1962 Ap 29 2
 -5 - EST 1963 O 27 2
@@ -3047,7 +2733,7 @@ R Pu 1946 1960 - Ap lastSu 2 1 D
 R Pu 1946 1954 - S lastSu 2 0 S
 R Pu 1955 1956 - O lastSu 2 0 S
 R Pu 1957 1960 - S lastSu 2 0 S
-Z America/Indiana/Winamac -5:46:25 - LMT 1883 N 18 12:13:35
+Z America/Indiana/Winamac -5:46:25 - LMT 1883 N 18 18u
 -6 u C%sT 1946
 -6 Pu C%sT 1961 Ap 30 2
 -5 - EST 1969
@@ -3055,7 +2741,7 @@ Z America/Indiana/Winamac -5:46:25 - LMT 1883 N 18 12:13:35
 -5 - EST 2006 Ap 2 2
 -6 u C%sT 2007 Mar 11 2
 -5 u E%sT
-Z America/Indiana/Vevay -5:40:16 - LMT 1883 N 18 12:19:44
+Z America/Indiana/Vevay -5:40:16 - LMT 1883 N 18 18u
 -6 u C%sT 1954 Ap 25 2
 -5 - EST 1969
 -5 u E%sT 1973
@@ -3070,7 +2756,7 @@ R v 1946 o - Jun 2 2 0 S
 R v 1950 1961 - Ap lastSu 2 1 D
 R v 1950 1955 - S lastSu 2 0 S
 R v 1956 1961 - O lastSu 2 0 S
-Z America/Kentucky/Louisville -5:43:2 - LMT 1883 N 18 12:16:58
+Z America/Kentucky/Louisville -5:43:2 - LMT 1883 N 18 18u
 -6 u C%sT 1921
 -6 v C%sT 1942
 -6 u C%sT 1946
@@ -3079,7 +2765,7 @@ Z America/Kentucky/Louisville -5:43:2 - LMT 1883 N 18 12:16:58
 -5 u E%sT 1974 Ja 6 2
 -6 1 CDT 1974 O 27 2
 -5 u E%sT
-Z America/Kentucky/Monticello -5:39:24 - LMT 1883 N 18 12:20:36
+Z America/Kentucky/Monticello -5:39:24 - LMT 1883 N 18 18u
 -6 u C%sT 1946
 -6 - CST 1968
 -6 u C%sT 2000 O 29 2
@@ -3256,22 +2942,6 @@ Z America/Toronto -5:17:32 - LMT 1895
 -5 C E%sT 1946
 -5 t E%sT 1974
 -5 C E%sT
-L America/Toronto America/Nassau
-Z America/Thunder_Bay -5:57 - LMT 1895
--6 - CST 1910
--5 - EST 1942
--5 C E%sT 1970
--5 t E%sT 1973
--5 - EST 1974
--5 C E%sT
-Z America/Nipigon -5:53:4 - LMT 1895
--5 C E%sT 1940 S 29
--5 1 EDT 1942 F 9 2s
--5 C E%sT
-Z America/Rainy_River -6:18:16 - LMT 1895
--6 C C%sT 1940 S 29
--6 1 CDT 1942 F 9 2s
--6 C C%sT
 R W 1916 o - Ap 23 0 1 D
 R W 1916 o - S 17 0 0 S
 R W 1918 o - Ap 14 2 1 D
@@ -3421,6 +3091,8 @@ Z America/Dawson -9:17:40 - LMT 1900 Au 20
 -8 Y P%sT 1980
 -8 C P%sT 2020 N
 -7 - MST
+R m 1931 o - May 1 23 1 D
+R m 1931 o - O 1 0 0 S
 R m 1939 o - F 5 0 1 D
 R m 1939 o - Jun 25 0 0 S
 R m 1940 o - D 9 0 1 D
@@ -3433,89 +3105,79 @@ R m 1996 2000 - Ap Su>=1 2 1 D
 R m 1996 2000 - O lastSu 2 0 S
 R m 2001 o - May Su>=1 2 1 D
 R m 2001 o - S lastSu 2 0 S
-R m 2002 ma - Ap Su>=1 2 1 D
-R m 2002 ma - O lastSu 2 0 S
-Z America/Cancun -5:47:4 - LMT 1922 Ja 1 0:12:56
+R m 2002 2022 - Ap Su>=1 2 1 D
+R m 2002 2022 - O lastSu 2 0 S
+Z America/Cancun -5:47:4 - LMT 1922 Ja 1 6u
 -6 - CST 1981 D 23
 -5 m E%sT 1998 Au 2 2
 -6 m C%sT 2015 F 1 2
 -5 - EST
-Z America/Merida -5:58:28 - LMT 1922 Ja 1 0:1:32
+Z America/Merida -5:58:28 - LMT 1922 Ja 1 6u
 -6 - CST 1981 D 23
 -5 - EST 1982 D 2
 -6 m C%sT
-Z America/Matamoros -6:40 - LMT 1921 D 31 23:20
+Z America/Matamoros -6:30 - LMT 1922 Ja 1 6u
 -6 - CST 1988
 -6 u C%sT 1989
 -6 m C%sT 2010
 -6 u C%sT
-Z America/Monterrey -6:41:16 - LMT 1921 D 31 23:18:44
+Z America/Monterrey -6:41:16 - LMT 1922 Ja 1 6u
 -6 - CST 1988
 -6 u C%sT 1989
 -6 m C%sT
-Z America/Mexico_City -6:36:36 - LMT 1922 Ja 1 0:23:24
+Z America/Mexico_City -6:36:36 - LMT 1922 Ja 1 7u
 -7 - MST 1927 Jun 10 23
 -6 - CST 1930 N 15
--7 - MST 1931 May 1 23
--6 - CST 1931 O
--7 - MST 1932 Ap
+-7 m M%sT 1932 Ap
 -6 m C%sT 2001 S 30 2
 -6 - CST 2002 F 20
 -6 m C%sT
-Z America/Ojinaga -6:57:40 - LMT 1922 Ja 1 0:2:20
+Z America/Ojinaga -6:57:40 - LMT 1922 Ja 1 7u
 -7 - MST 1927 Jun 10 23
 -6 - CST 1930 N 15
--7 - MST 1931 May 1 23
--6 - CST 1931 O
--7 - MST 1932 Ap
+-7 m M%sT 1932 Ap
 -6 - CST 1996
 -6 m C%sT 1998
 -6 - CST 1998 Ap Su>=1 3
 -7 m M%sT 2010
--7 u M%sT
-Z America/Chihuahua -7:4:20 - LMT 1921 D 31 23:55:40
+-7 u M%sT 2022 O 30 2
+-6 - CST
+Z America/Chihuahua -7:4:20 - LMT 1922 Ja 1 7u
 -7 - MST 1927 Jun 10 23
 -6 - CST 1930 N 15
--7 - MST 1931 May 1 23
--6 - CST 1931 O
--7 - MST 1932 Ap
+-7 m M%sT 1932 Ap
 -6 - CST 1996
 -6 m C%sT 1998
 -6 - CST 1998 Ap Su>=1 3
--7 m M%sT
-Z America/Hermosillo -7:23:52 - LMT 1921 D 31 23:36:8
+-7 m M%sT 2022 O 30 2
+-6 - CST
+Z America/Hermosillo -7:23:52 - LMT 1922 Ja 1 7u
 -7 - MST 1927 Jun 10 23
 -6 - CST 1930 N 15
--7 - MST 1931 May 1 23
--6 - CST 1931 O
--7 - MST 1932 Ap
+-7 m M%sT 1932 Ap
 -6 - CST 1942 Ap 24
 -7 - MST 1949 Ja 14
 -8 - PST 1970
 -7 m M%sT 1999
 -7 - MST
-Z America/Mazatlan -7:5:40 - LMT 1921 D 31 23:54:20
+Z America/Mazatlan -7:5:40 - LMT 1922 Ja 1 7u
 -7 - MST 1927 Jun 10 23
 -6 - CST 1930 N 15
--7 - MST 1931 May 1 23
--6 - CST 1931 O
--7 - MST 1932 Ap
+-7 m M%sT 1932 Ap
 -6 - CST 1942 Ap 24
 -7 - MST 1949 Ja 14
 -8 - PST 1970
 -7 m M%sT
-Z America/Bahia_Banderas -7:1 - LMT 1921 D 31 23:59
+Z America/Bahia_Banderas -7:1 - LMT 1922 Ja 1 7u
 -7 - MST 1927 Jun 10 23
 -6 - CST 1930 N 15
--7 - MST 1931 May 1 23
--6 - CST 1931 O
--7 - MST 1932 Ap
+-7 m M%sT 1932 Ap
 -6 - CST 1942 Ap 24
 -7 - MST 1949 Ja 14
 -8 - PST 1970
 -7 m M%sT 2010 Ap 4 2
 -6 m C%sT
-Z America/Tijuana -7:48:4 - LMT 1922 Ja 1 0:11:56
+Z America/Tijuana -7:48:4 - LMT 1922 Ja 1 7u
 -7 - MST 1924
 -8 - PST 1927 Jun 10 23
 -7 - MST 1930 N 15
@@ -3707,31 +3369,10 @@ Z America/Managua -5:45:8 - LMT 1890
 Z America/Panama -5:18:8 - LMT 1890
 -5:19:36 - CMT 1908 Ap 22
 -5 - EST
-L America/Panama America/Atikokan
-L America/Panama America/Cayman
 Z America/Puerto_Rico -4:24:25 - LMT 1899 Mar 28 12
 -4 - AST 1942 May 3
 -4 u A%sT 1946
 -4 - AST
-L America/Puerto_Rico America/Anguilla
-L America/Puerto_Rico America/Antigua
-L America/Puerto_Rico America/Aruba
-L America/Puerto_Rico America/Curacao
-L America/Puerto_Rico America/Blanc-Sablon
-L America/Puerto_Rico America/Dominica
-L America/Puerto_Rico America/Grenada
-L America/Puerto_Rico America/Guadeloupe
-L America/Puerto_Rico America/Kralendijk
-L America/Puerto_Rico America/Lower_Princes
-L America/Puerto_Rico America/Marigot
-L America/Puerto_Rico America/Montserrat
-L America/Puerto_Rico America/Port_of_Spain
-L America/Puerto_Rico America/St_Barthelemy
-L America/Puerto_Rico America/St_Kitts
-L America/Puerto_Rico America/St_Lucia
-L America/Puerto_Rico America/St_Thomas
-L America/Puerto_Rico America/St_Vincent
-L America/Puerto_Rico America/Tortola
 Z America/Miquelon -3:44:40 - LMT 1911 May 15
 -4 - AST 1980 May
 -3 - -03 1987
@@ -4089,7 +3730,9 @@ R x 2012 2014 - S Su>=2 4u 1 -
 R x 2016 2018 - May Su>=9 3u 0 -
 R x 2016 2018 - Au Su>=9 4u 1 -
 R x 2019 ma - Ap Su>=2 3u 0 -
-R x 2019 ma - S Su>=2 4u 1 -
+R x 2019 2021 - S Su>=2 4u 1 -
+R x 2022 o - S Su>=9 4u 1 -
+R x 2023 ma - S Su>=2 4u 1 -
 Z America/Santiago -4:42:45 - LMT 1890
 -4:42:45 - SMT 1910 Ja 10
 -5 - -05 1916 Jul
@@ -4099,9 +3742,9 @@ Z America/Santiago -4:42:45 - LMT 1890
 -5 x -05/-04 1932 S
 -4 - -04 1942 Jun
 -5 - -05 1942 Au
--4 - -04 1946 Jul 15
--4 1 -03 1946 S
--4 - -04 1947 Ap
+-4 - -04 1946 Jul 14 24
+-4 1 -03 1946 Au 28 24
+-5 1 -04 1947 Mar 31 24
 -5 - -05 1947 May 21 23
 -4 x -04/-03
 Z America/Punta_Arenas -4:43:40 - LMT 1890
@@ -4113,7 +3756,8 @@ Z America/Punta_Arenas -4:43:40 - LMT 1890
 -5 x -05/-04 1932 S
 -4 - -04 1942 Jun
 -5 - -05 1942 Au
--4 - -04 1947 Ap
+-4 - -04 1946 Au 28 24
+-5 1 -04 1947 Mar 31 24
 -5 - -05 1947 May 21 23
 -4 x -04/-03 2016 D 4
 -3 - -03
@@ -4277,15 +3921,9 @@ Z America/Caracas -4:27:44 - LMT 1890
 -4 - -04 2007 D 9 3
 -4:30 - -0430 2016 May 1 2:30
 -4 - -04
-Z Etc/GMT 0 - GMT
 Z Etc/UTC 0 - UTC
+Z Etc/GMT 0 - GMT
 L Etc/GMT GMT
-L Etc/UTC Etc/Universal
-L Etc/UTC Etc/Zulu
-L Etc/GMT Etc/Greenwich
-L Etc/GMT Etc/GMT-0
-L Etc/GMT Etc/GMT+0
-L Etc/GMT Etc/GMT0
 Z Etc/GMT-14 14 - +14
 Z Etc/GMT-13 13 - +13
 Z Etc/GMT-12 12 - +12
@@ -4313,49 +3951,7 @@ Z Etc/GMT+10 -10 - -10
 Z Etc/GMT+11 -11 - -11
 Z Etc/GMT+12 -12 - -12
 Z Factory 0 - -00
-L Africa/Nairobi Africa/Asmera
-L Africa/Abidjan Africa/Timbuktu
-L America/Argentina/Catamarca America/Argentina/ComodRivadavia
-L America/Adak America/Atka
-L America/Argentina/Buenos_Aires America/Buenos_Aires
-L America/Argentina/Catamarca America/Catamarca
-L America/Panama America/Coral_Harbour
-L America/Argentina/Cordoba America/Cordoba
-L America/Tijuana America/Ensenada
-L America/Indiana/Indianapolis America/Fort_Wayne
-L America/Nuuk America/Godthab
-L America/Indiana/Indianapolis America/Indianapolis
-L America/Argentina/Jujuy America/Jujuy
-L America/Indiana/Knox America/Knox_IN
-L America/Kentucky/Louisville America/Louisville
-L America/Argentina/Mendoza America/Mendoza
-L America/Toronto America/Montreal
-L America/Rio_Branco America/Porto_Acre
-L America/Argentina/Cordoba America/Rosario
-L America/Tijuana America/Santa_Isabel
-L America/Denver America/Shiprock
-L America/Puerto_Rico America/Virgin
-L Pacific/Auckland Antarctica/South_Pole
-L Asia/Ashgabat Asia/Ashkhabad
-L Asia/Kolkata Asia/Calcutta
-L Asia/Shanghai Asia/Chongqing
-L Asia/Shanghai Asia/Chungking
-L Asia/Dhaka Asia/Dacca
-L Asia/Shanghai Asia/Harbin
-L Asia/Urumqi Asia/Kashgar
-L Asia/Kathmandu Asia/Katmandu
-L Asia/Macau Asia/Macao
-L Asia/Yangon Asia/Rangoon
-L Asia/Ho_Chi_Minh Asia/Saigon
-L Asia/Jerusalem Asia/Tel_Aviv
-L Asia/Thimphu Asia/Thimbu
-L Asia/Makassar Asia/Ujung_Pandang
-L Asia/Ulaanbaatar Asia/Ulan_Bator
-L Atlantic/Faroe Atlantic/Faeroe
-L Europe/Oslo Atlantic/Jan_Mayen
 L Australia/Sydney Australia/ACT
-L Australia/Sydney Australia/Canberra
-L Australia/Hobart Australia/Currie
 L Australia/Lord_Howe Australia/LHI
 L Australia/Sydney Australia/NSW
 L Australia/Darwin Australia/North
@@ -4382,9 +3978,13 @@ L Pacific/Easter Chile/EasterIsland
 L America/Havana Cuba
 L Africa/Cairo Egypt
 L Europe/Dublin Eire
+L Etc/GMT Etc/GMT+0
+L Etc/GMT Etc/GMT-0
+L Etc/GMT Etc/GMT0
+L Etc/GMT Etc/Greenwich
 L Etc/UTC Etc/UCT
-L Europe/London Europe/Belfast
-L Europe/Chisinau Europe/Tiraspol
+L Etc/UTC Etc/Universal
+L Etc/UTC Etc/Zulu
 L Europe/London GB
 L Europe/London GB-Eire
 L Etc/GMT GMT+0
@@ -4392,7 +3992,7 @@ L Etc/GMT GMT-0
 L Etc/GMT GMT0
 L Etc/GMT Greenwich
 L Asia/Hong_Kong Hongkong
-L Atlantic/Reykjavik Iceland
+L Africa/Abidjan Iceland
 L Asia/Tehran Iran
 L Asia/Jerusalem Israel
 L America/Jamaica Jamaica
@@ -4406,12 +4006,6 @@ L Pacific/Auckland NZ
 L Pacific/Chatham NZ-CHAT
 L America/Denver Navajo
 L Asia/Shanghai PRC
-L Pacific/Kanton Pacific/Enderbury
-L Pacific/Honolulu Pacific/Johnston
-L Pacific/Pohnpei Pacific/Ponape
-L Pacific/Pago_Pago Pacific/Samoa
-L Pacific/Chuuk Pacific/Truk
-L Pacific/Chuuk Pacific/Yap
 L Europe/Warsaw Poland
 L Europe/Lisbon Portugal
 L Asia/Taipei ROC
@@ -4435,3 +4029,168 @@ L Etc/UTC UTC
 L Etc/UTC Universal
 L Europe/Moscow W-SU
 L Etc/UTC Zulu
+L America/Argentina/Buenos_Aires America/Buenos_Aires
+L America/Argentina/Catamarca America/Catamarca
+L America/Argentina/Cordoba America/Cordoba
+L America/Indiana/Indianapolis America/Indianapolis
+L America/Argentina/Jujuy America/Jujuy
+L America/Indiana/Knox America/Knox_IN
+L America/Kentucky/Louisville America/Louisville
+L America/Argentina/Mendoza America/Mendoza
+L America/Puerto_Rico America/Virgin
+L Pacific/Pago_Pago Pacific/Samoa
+L Africa/Abidjan Africa/Accra
+L Africa/Nairobi Africa/Addis_Ababa
+L Africa/Nairobi Africa/Asmara
+L Africa/Abidjan Africa/Bamako
+L Africa/Lagos Africa/Bangui
+L Africa/Abidjan Africa/Banjul
+L Africa/Maputo Africa/Blantyre
+L Africa/Lagos Africa/Brazzaville
+L Africa/Maputo Africa/Bujumbura
+L Africa/Abidjan Africa/Conakry
+L Africa/Abidjan Africa/Dakar
+L Africa/Nairobi Africa/Dar_es_Salaam
+L Africa/Nairobi Africa/Djibouti
+L Africa/Lagos Africa/Douala
+L Africa/Abidjan Africa/Freetown
+L Africa/Maputo Africa/Gaborone
+L Africa/Maputo Africa/Harare
+L Africa/Nairobi Africa/Kampala
+L Africa/Maputo Africa/Kigali
+L Africa/Lagos Africa/Kinshasa
+L Africa/Lagos Africa/Libreville
+L Africa/Abidjan Africa/Lome
+L Africa/Lagos Africa/Luanda
+L Africa/Maputo Africa/Lubumbashi
+L Africa/Maputo Africa/Lusaka
+L Africa/Lagos Africa/Malabo
+L Africa/Johannesburg Africa/Maseru
+L Africa/Johannesburg Africa/Mbabane
+L Africa/Nairobi Africa/Mogadishu
+L Africa/Lagos Africa/Niamey
+L Africa/Abidjan Africa/Nouakchott
+L Africa/Abidjan Africa/Ouagadougou
+L Africa/Lagos Africa/Porto-Novo
+L America/Puerto_Rico America/Anguilla
+L America/Puerto_Rico America/Antigua
+L America/Puerto_Rico America/Aruba
+L America/Panama America/Atikokan
+L America/Puerto_Rico America/Blanc-Sablon
+L America/Panama America/Cayman
+L America/Phoenix America/Creston
+L America/Puerto_Rico America/Curacao
+L America/Puerto_Rico America/Dominica
+L America/Puerto_Rico America/Grenada
+L America/Puerto_Rico America/Guadeloupe
+L America/Puerto_Rico America/Kralendijk
+L America/Puerto_Rico America/Lower_Princes
+L America/Puerto_Rico America/Marigot
+L America/Puerto_Rico America/Montserrat
+L America/Toronto America/Nassau
+L America/Puerto_Rico America/Port_of_Spain
+L America/Puerto_Rico America/St_Barthelemy
+L America/Puerto_Rico America/St_Kitts
+L America/Puerto_Rico America/St_Lucia
+L America/Puerto_Rico America/St_Thomas
+L America/Puerto_Rico America/St_Vincent
+L America/Puerto_Rico America/Tortola
+L Pacific/Port_Moresby Antarctica/DumontDUrville
+L Pacific/Auckland Antarctica/McMurdo
+L Asia/Riyadh Antarctica/Syowa
+L Asia/Urumqi Antarctica/Vostok
+L Europe/Berlin Arctic/Longyearbyen
+L Asia/Riyadh Asia/Aden
+L Asia/Qatar Asia/Bahrain
+L Asia/Kuching Asia/Brunei
+L Asia/Singapore Asia/Kuala_Lumpur
+L Asia/Riyadh Asia/Kuwait
+L Asia/Dubai Asia/Muscat
+L Asia/Bangkok Asia/Phnom_Penh
+L Asia/Bangkok Asia/Vientiane
+L Africa/Abidjan Atlantic/Reykjavik
+L Africa/Abidjan Atlantic/St_Helena
+L Europe/Brussels Europe/Amsterdam
+L Europe/Prague Europe/Bratislava
+L Europe/Zurich Europe/Busingen
+L Europe/Berlin Europe/Copenhagen
+L Europe/London Europe/Guernsey
+L Europe/London Europe/Isle_of_Man
+L Europe/London Europe/Jersey
+L Europe/Belgrade Europe/Ljubljana
+L Europe/Brussels Europe/Luxembourg
+L Europe/Helsinki Europe/Mariehamn
+L Europe/Paris Europe/Monaco
+L Europe/Berlin Europe/Oslo
+L Europe/Belgrade Europe/Podgorica
+L Europe/Rome Europe/San_Marino
+L Europe/Belgrade Europe/Sarajevo
+L Europe/Belgrade Europe/Skopje
+L Europe/Berlin Europe/Stockholm
+L Europe/Zurich Europe/Vaduz
+L Europe/Rome Europe/Vatican
+L Europe/Belgrade Europe/Zagreb
+L Africa/Nairobi Indian/Antananarivo
+L Asia/Bangkok Indian/Christmas
+L Asia/Yangon Indian/Cocos
+L Africa/Nairobi Indian/Comoro
+L Indian/Maldives Indian/Kerguelen
+L Asia/Dubai Indian/Mahe
+L Africa/Nairobi Indian/Mayotte
+L Asia/Dubai Indian/Reunion
+L Pacific/Port_Moresby Pacific/Chuuk
+L Pacific/Tarawa Pacific/Funafuti
+L Pacific/Tarawa Pacific/Majuro
+L Pacific/Pago_Pago Pacific/Midway
+L Pacific/Guadalcanal Pacific/Pohnpei
+L Pacific/Guam Pacific/Saipan
+L Pacific/Tarawa Pacific/Wake
+L Pacific/Tarawa Pacific/Wallis
+L Africa/Abidjan Africa/Timbuktu
+L America/Argentina/Catamarca America/Argentina/ComodRivadavia
+L America/Adak America/Atka
+L America/Panama America/Coral_Harbour
+L America/Tijuana America/Ensenada
+L America/Indiana/Indianapolis America/Fort_Wayne
+L America/Toronto America/Montreal
+L America/Toronto America/Nipigon
+L America/Rio_Branco America/Porto_Acre
+L America/Winnipeg America/Rainy_River
+L America/Argentina/Cordoba America/Rosario
+L America/Tijuana America/Santa_Isabel
+L America/Denver America/Shiprock
+L America/Toronto America/Thunder_Bay
+L Pacific/Auckland Antarctica/South_Pole
+L Asia/Shanghai Asia/Chongqing
+L Asia/Shanghai Asia/Harbin
+L Asia/Urumqi Asia/Kashgar
+L Asia/Jerusalem Asia/Tel_Aviv
+L Europe/Berlin Atlantic/Jan_Mayen
+L Australia/Sydney Australia/Canberra
+L Australia/Hobart Australia/Currie
+L Europe/London Europe/Belfast
+L Europe/Chisinau Europe/Tiraspol
+L Europe/Kyiv Europe/Uzhgorod
+L Europe/Kyiv Europe/Zaporozhye
+L Pacific/Kanton Pacific/Enderbury
+L Pacific/Honolulu Pacific/Johnston
+L Pacific/Port_Moresby Pacific/Yap
+L Africa/Nairobi Africa/Asmera
+L America/Nuuk America/Godthab
+L Asia/Ashgabat Asia/Ashkhabad
+L Asia/Kolkata Asia/Calcutta
+L Asia/Shanghai Asia/Chungking
+L Asia/Dhaka Asia/Dacca
+L Europe/Istanbul Asia/Istanbul
+L Asia/Kathmandu Asia/Katmandu
+L Asia/Macau Asia/Macao
+L Asia/Yangon Asia/Rangoon
+L Asia/Ho_Chi_Minh Asia/Saigon
+L Asia/Thimphu Asia/Thimbu
+L Asia/Makassar Asia/Ujung_Pandang
+L Asia/Ulaanbaatar Asia/Ulan_Bator
+L Atlantic/Faroe Atlantic/Faeroe
+L Europe/Kyiv Europe/Kiev
+L Asia/Nicosia Europe/Nicosia
+L Pacific/Guadalcanal Pacific/Ponape
+L Pacific/Port_Moresby Pacific/Truk
diff --git a/lib/pytz/zoneinfo/zone.tab b/lib/pytz/zoneinfo/zone.tab
index 086458fb..2636e21a 100644
--- a/lib/pytz/zoneinfo/zone.tab
+++ b/lib/pytz/zoneinfo/zone.tab
@@ -114,13 +114,10 @@ CA	+4606-06447	America/Moncton	Atlantic - New Brunswick
 CA	+5320-06025	America/Goose_Bay	Atlantic - Labrador (most areas)
 CA	+5125-05707	America/Blanc-Sablon	AST - QC (Lower North Shore)
 CA	+4339-07923	America/Toronto	Eastern - ON, QC (most areas)
-CA	+4901-08816	America/Nipigon	Eastern - ON, QC (no DST 1967-73)
-CA	+4823-08915	America/Thunder_Bay	Eastern - ON (Thunder Bay)
 CA	+6344-06828	America/Iqaluit	Eastern - NU (most east areas)
 CA	+6608-06544	America/Pangnirtung	Eastern - NU (Pangnirtung)
 CA	+484531-0913718	America/Atikokan	EST - ON (Atikokan); NU (Coral H)
 CA	+4953-09709	America/Winnipeg	Central - ON (west); Manitoba
-CA	+4843-09434	America/Rainy_River	Central - ON (Rainy R, Ft Frances)
 CA	+744144-0944945	America/Resolute	Central - NU (Resolute)
 CA	+624900-0920459	America/Rankin_Inlet	Central - NU (central)
 CA	+5024-10439	America/Regina	CST - SK (most areas)
@@ -130,7 +127,7 @@ CA	+690650-1050310	America/Cambridge_Bay	Mountain - NU (west)
 CA	+6227-11421	America/Yellowknife	Mountain - NT (central)
 CA	+682059-1334300	America/Inuvik	Mountain - NT (west)
 CA	+4906-11631	America/Creston	MST - BC (Creston)
-CA	+5946-12014	America/Dawson_Creek	MST - BC (Dawson Cr, Ft St John)
+CA	+5546-12014	America/Dawson_Creek	MST - BC (Dawson Cr, Ft St John)
 CA	+5848-12242	America/Fort_Nelson	MST - BC (Ft Nelson)
 CA	+6043-13503	America/Whitehorse	MST - Yukon (east)
 CA	+6404-13925	America/Dawson	MST - Yukon (west)
@@ -400,9 +397,7 @@ TT	+1039-06131	America/Port_of_Spain
 TV	-0831+17913	Pacific/Funafuti
 TW	+2503+12130	Asia/Taipei
 TZ	-0648+03917	Africa/Dar_es_Salaam
-UA	+5026+03031	Europe/Kiev	Ukraine (most areas)
-UA	+4837+02218	Europe/Uzhgorod	Transcarpathia
-UA	+4750+03510	Europe/Zaporozhye	Zaporozhye and east Lugansk
+UA	+5026+03031	Europe/Kyiv	Ukraine (most areas)
 UG	+0019+03225	Africa/Kampala
 UM	+2813-17722	Pacific/Midway	Midway Islands
 UM	+1917+16637	Pacific/Wake	Wake Island
diff --git a/lib/pytz/zoneinfo/zone1970.tab b/lib/pytz/zoneinfo/zone1970.tab
index c614be81..75372e3f 100644
--- a/lib/pytz/zoneinfo/zone1970.tab
+++ b/lib/pytz/zoneinfo/zone1970.tab
@@ -34,7 +34,7 @@
 #country-
 #codes	coordinates	TZ	comments
 AD	+4230+00131	Europe/Andorra
-AE,OM	+2518+05518	Asia/Dubai
+AE,OM,RE,SC,TF	+2518+05518	Asia/Dubai	UAE, Oman, Réunion, Seychelles, Crozet, Scattered Is
 AF	+3431+06912	Asia/Kabul
 AL	+4120+01950	Europe/Tirane
 AM	+4011+04430	Asia/Yerevan
@@ -44,7 +44,6 @@ AQ	-6736+06253	Antarctica/Mawson	Mawson
 AQ	-6448-06406	Antarctica/Palmer	Palmer
 AQ	-6734-06808	Antarctica/Rothera	Rothera
 AQ	-720041+0023206	Antarctica/Troll	Troll
-AQ	-7824+10654	Antarctica/Vostok	Vostok
 AR	-3436-05827	America/Argentina/Buenos_Aires	Buenos Aires (BA, CF)
 AR	-3124-06411	America/Argentina/Cordoba	Argentina (most areas: CB, CC, CN, ER, FM, MN, SE, SF)
 AR	-2447-06525	America/Argentina/Salta	Salta (SA, LP, NQ, RN)
@@ -74,10 +73,9 @@ AU	-3143+12852	Australia/Eucla	Western Australia (Eucla)
 AZ	+4023+04951	Asia/Baku
 BB	+1306-05937	America/Barbados
 BD	+2343+09025	Asia/Dhaka
-BE	+5050+00420	Europe/Brussels
+BE,LU,NL	+5050+00420	Europe/Brussels
 BG	+4241+02319	Europe/Sofia
 BM	+3217-06446	Atlantic/Bermuda
-BN	+0456+11455	Asia/Brunei
 BO	-1630-06809	America/La_Paz
 BR	-0351-03225	America/Noronha	Atlantic islands
 BR	-0127-04829	America/Belem	Pará (east); Amapá
@@ -104,12 +102,9 @@ CA	+4612-05957	America/Glace_Bay	Atlantic - NS (Cape Breton)
 CA	+4606-06447	America/Moncton	Atlantic - New Brunswick
 CA	+5320-06025	America/Goose_Bay	Atlantic - Labrador (most areas)
 CA,BS	+4339-07923	America/Toronto	Eastern - ON, QC (most areas), Bahamas
-CA	+4901-08816	America/Nipigon	Eastern - ON, QC (no DST 1967-73)
-CA	+4823-08915	America/Thunder_Bay	Eastern - ON (Thunder Bay)
 CA	+6344-06828	America/Iqaluit	Eastern - NU (most east areas)
 CA	+6608-06544	America/Pangnirtung	Eastern - NU (Pangnirtung)
 CA	+4953-09709	America/Winnipeg	Central - ON (west); Manitoba
-CA	+4843-09434	America/Rainy_River	Central - ON (Rainy R, Ft Frances)
 CA	+744144-0944945	America/Resolute	Central - NU (Resolute)
 CA	+624900-0920459	America/Rankin_Inlet	Central - NU (central)
 CA	+5024-10439	America/Regina	CST - SK (most areas)
@@ -118,30 +113,27 @@ CA	+5333-11328	America/Edmonton	Mountain - AB; BC (E); SK (W)
 CA	+690650-1050310	America/Cambridge_Bay	Mountain - NU (west)
 CA	+6227-11421	America/Yellowknife	Mountain - NT (central)
 CA	+682059-1334300	America/Inuvik	Mountain - NT (west)
-CA	+5946-12014	America/Dawson_Creek	MST - BC (Dawson Cr, Ft St John)
+CA	+5546-12014	America/Dawson_Creek	MST - BC (Dawson Cr, Ft St John)
 CA	+5848-12242	America/Fort_Nelson	MST - BC (Ft Nelson)
 CA	+6043-13503	America/Whitehorse	MST - Yukon (east)
 CA	+6404-13925	America/Dawson	MST - Yukon (west)
 CA	+4916-12307	America/Vancouver	Pacific - BC (most areas)
-CC	-1210+09655	Indian/Cocos
 CH,DE,LI	+4723+00832	Europe/Zurich	Swiss time
-CI,BF,GH,GM,GN,ML,MR,SH,SL,SN,TG	+0519-00402	Africa/Abidjan
+CI,BF,GH,GM,GN,IS,ML,MR,SH,SL,SN,TG	+0519-00402	Africa/Abidjan
 CK	-2114-15946	Pacific/Rarotonga
 CL	-3327-07040	America/Santiago	Chile (most areas)
 CL	-5309-07055	America/Punta_Arenas	Region of Magallanes
 CL	-2709-10926	Pacific/Easter	Easter Island
 CN	+3114+12128	Asia/Shanghai	Beijing Time
-CN	+4348+08735	Asia/Urumqi	Xinjiang Time
+CN,AQ	+4348+08735	Asia/Urumqi	Xinjiang Time, Vostok
 CO	+0436-07405	America/Bogota
 CR	+0956-08405	America/Costa_Rica
 CU	+2308-08222	America/Havana
 CV	+1455-02331	Atlantic/Cape_Verde
-CX	-1025+10543	Indian/Christmas
 CY	+3510+03322	Asia/Nicosia	Cyprus (most areas)
 CY	+3507+03357	Asia/Famagusta	Northern Cyprus
 CZ,SK	+5005+01426	Europe/Prague
-DE	+5230+01322	Europe/Berlin	Germany (most areas)
-DK	+5540+01235	Europe/Copenhagen
+DE,DK,NO,SE,SJ	+5230+01322	Europe/Berlin	Germany (most areas), Scandinavia
 DO	+1828-06954	America/Santo_Domingo
 DZ	+3647+00303	Africa/Algiers
 EC	-0210-07950	America/Guayaquil	Ecuador (mainland)
@@ -155,11 +147,9 @@ ES	+2806-01524	Atlantic/Canary	Canary Islands
 FI,AX	+6010+02458	Europe/Helsinki
 FJ	-1808+17825	Pacific/Fiji
 FK	-5142-05751	Atlantic/Stanley
-FM	+0725+15147	Pacific/Chuuk	Chuuk/Truk, Yap
-FM	+0658+15813	Pacific/Pohnpei	Pohnpei/Ponape
 FM	+0519+16259	Pacific/Kosrae	Kosrae
 FO	+6201-00646	Atlantic/Faroe
-FR	+4852+00220	Europe/Paris
+FR,MC	+4852+00220	Europe/Paris
 GB,GG,IM,JE	+513030-0000731	Europe/London
 GE	+4143+04449	Asia/Tbilisi
 GF	+0456-05220	America/Cayenne
@@ -188,14 +178,13 @@ IN	+2232+08822	Asia/Kolkata
 IO	-0720+07225	Indian/Chagos
 IQ	+3321+04425	Asia/Baghdad
 IR	+3540+05126	Asia/Tehran
-IS	+6409-02151	Atlantic/Reykjavik
 IT,SM,VA	+4154+01229	Europe/Rome
 JM	+175805-0764736	America/Jamaica
 JO	+3157+03556	Asia/Amman
 JP	+353916+1394441	Asia/Tokyo
 KE,DJ,ER,ET,KM,MG,SO,TZ,UG,YT	-0117+03649	Africa/Nairobi
 KG	+4254+07436	Asia/Bishkek
-KI	+0125+17300	Pacific/Tarawa	Gilbert Islands
+KI,MH,TV,UM,WF	+0125+17300	Pacific/Tarawa	Gilberts, Marshalls, Tuvalu, Wallis & Futuna, Wake
 KI	-0247-17143	Pacific/Kanton	Phoenix Islands
 KI	+0152-15720	Pacific/Kiritimati	Line Islands
 KP	+3901+12545	Asia/Pyongyang
@@ -211,15 +200,12 @@ LB	+3353+03530	Asia/Beirut
 LK	+0656+07951	Asia/Colombo
 LR	+0618-01047	Africa/Monrovia
 LT	+5441+02519	Europe/Vilnius
-LU	+4936+00609	Europe/Luxembourg
 LV	+5657+02406	Europe/Riga
 LY	+3254+01311	Africa/Tripoli
 MA	+3339-00735	Africa/Casablanca
-MC	+4342+00723	Europe/Monaco
 MD	+4700+02850	Europe/Chisinau
-MH	+0709+17112	Pacific/Majuro	Marshall Islands (most areas)
 MH	+0905+16720	Pacific/Kwajalein	Kwajalein
-MM	+1647+09610	Asia/Yangon
+MM,CC	+1647+09610	Asia/Yangon
 MN	+4755+10653	Asia/Ulaanbaatar	Mongolia (most areas)
 MN	+4801+09139	Asia/Hovd	Bayan-Ölgii, Govi-Altai, Hovd, Uvs, Zavkhan
 MN	+4804+11430	Asia/Choibalsan	Dornod, Sükhbaatar
@@ -227,7 +213,7 @@ MO	+221150+1133230	Asia/Macau
 MQ	+1436-06105	America/Martinique
 MT	+3554+01431	Europe/Malta
 MU	-2010+05730	Indian/Mauritius
-MV	+0410+07330	Indian/Maldives
+MV,TF	+0410+07330	Indian/Maldives	Maldives, Kerguelen, St Paul I, Amsterdam I
 MX	+1924-09909	America/Mexico_City	Central Time
 MX	+2105-08646	America/Cancun	Eastern Standard Time - Quintana Roo
 MX	+2058-08937	America/Merida	Central Time - Campeche, Yucatán
@@ -239,16 +225,13 @@ MX	+2934-10425	America/Ojinaga	Mountain Time US - Chihuahua (US border)
 MX	+2904-11058	America/Hermosillo	Mountain Standard Time - Sonora
 MX	+3232-11701	America/Tijuana	Pacific Time US - Baja California
 MX	+2048-10515	America/Bahia_Banderas	Central Time - Bahía de Banderas
-MY	+0310+10142	Asia/Kuala_Lumpur	Malaysia (peninsula)
-MY	+0133+11020	Asia/Kuching	Sabah, Sarawak
+MY,BN	+0133+11020	Asia/Kuching	Sabah, Sarawak, Brunei
 MZ,BI,BW,CD,MW,RW,ZM,ZW	-2558+03235	Africa/Maputo	Central Africa Time
 NA	-2234+01706	Africa/Windhoek
 NC	-2216+16627	Pacific/Noumea
 NF	-2903+16758	Pacific/Norfolk
 NG,AO,BJ,CD,CF,CG,CM,GA,GQ,NE	+0627+00324	Africa/Lagos	West Africa Time
 NI	+1209-08617	America/Managua
-NL	+5222+00454	Europe/Amsterdam
-NO,SJ	+5955+01045	Europe/Oslo
 NP	+2743+08519	Asia/Kathmandu
 NR	-0031+16655	Pacific/Nauru
 NU	-1901-16955	Pacific/Niue
@@ -259,7 +242,7 @@ PE	-1203-07703	America/Lima
 PF	-1732-14934	Pacific/Tahiti	Society Islands
 PF	-0900-13930	Pacific/Marquesas	Marquesas Islands
 PF	-2308-13457	Pacific/Gambier	Gambier Islands
-PG,AQ	-0930+14710	Pacific/Port_Moresby	Papua New Guinea (most areas), Dumont d'Urville
+PG,AQ,FM	-0930+14710	Pacific/Port_Moresby	Papua New Guinea (most areas), Chuuk, Yap, Dumont d'Urville
 PG	-0613+15534	Pacific/Bougainville	Bougainville
 PH	+1435+12100	Asia/Manila
 PK	+2452+06703	Asia/Karachi
@@ -275,7 +258,6 @@ PT	+3744-02540	Atlantic/Azores	Azores
 PW	+0720+13429	Pacific/Palau
 PY	-2516-05740	America/Asuncion
 QA,BH	+2517+05132	Asia/Qatar
-RE,TF	-2052+05528	Indian/Reunion	Réunion, Crozet, Scattered Islands
 RO	+4426+02606	Europe/Bucharest
 RS,BA,HR,ME,MK,SI	+4450+02030	Europe/Belgrade
 RU	+5443+02030	Europe/Kaliningrad	MSK-01 - Kaliningrad
@@ -307,10 +289,8 @@ RU	+6728+15343	Asia/Srednekolymsk	MSK+08 - Sakha (E); North Kuril Is
 RU	+5301+15839	Asia/Kamchatka	MSK+09 - Kamchatka
 RU	+6445+17729	Asia/Anadyr	MSK+09 - Bering Sea
 SA,AQ,KW,YE	+2438+04643	Asia/Riyadh	Arabia, Syowa
-SB	-0932+16012	Pacific/Guadalcanal
-SC	-0440+05528	Indian/Mahe
+SB,FM	-0932+16012	Pacific/Guadalcanal	Solomons, Pohnpei
 SD	+1536+03232	Africa/Khartoum
-SE	+5920+01803	Europe/Stockholm
 SG,MY	+0117+10351	Asia/Singapore	Singapore, peninsular Malaysia
 SR	+0550-05510	America/Paramaribo
 SS	+0451+03137	Africa/Juba
@@ -319,8 +299,7 @@ SV	+1342-08912	America/El_Salvador
 SY	+3330+03618	Asia/Damascus
 TC	+2128-07108	America/Grand_Turk
 TD	+1207+01503	Africa/Ndjamena
-TF	-492110+0701303	Indian/Kerguelen	Kerguelen, St Paul Island, Amsterdam Island
-TH,KH,LA,VN	+1345+10031	Asia/Bangkok	Indochina (most areas)
+TH,CX,KH,LA,VN	+1345+10031	Asia/Bangkok	Indochina (most areas)
 TJ	+3835+06848	Asia/Dushanbe
 TK	-0922-17114	Pacific/Fakaofo
 TL	-0833+12535	Asia/Dili
@@ -328,12 +307,8 @@ TM	+3757+05823	Asia/Ashgabat
 TN	+3648+01011	Africa/Tunis
 TO	-210800-1751200	Pacific/Tongatapu
 TR	+4101+02858	Europe/Istanbul
-TV	-0831+17913	Pacific/Funafuti
 TW	+2503+12130	Asia/Taipei
-UA	+5026+03031	Europe/Kiev	Ukraine (most areas)
-UA	+4837+02218	Europe/Uzhgorod	Transcarpathia
-UA	+4750+03510	Europe/Zaporozhye	Zaporozhye and east Lugansk
-UM	+1917+16637	Pacific/Wake	Wake Island
+UA	+5026+03031	Europe/Kyiv	Ukraine (most areas)
 US	+404251-0740023	America/New_York	Eastern (most areas)
 US	+421953-0830245	America/Detroit	Eastern - MI (most areas)
 US	+381515-0854534	America/Kentucky/Louisville	Eastern - KY (Louisville area)
@@ -369,6 +344,29 @@ UZ	+4120+06918	Asia/Tashkent	Uzbekistan (east)
 VE	+1030-06656	America/Caracas
 VN	+1045+10640	Asia/Ho_Chi_Minh	Vietnam (south)
 VU	-1740+16825	Pacific/Efate
-WF	-1318-17610	Pacific/Wallis
 WS	-1350-17144	Pacific/Apia
 ZA,LS,SZ	-2615+02800	Africa/Johannesburg
+#
+# The next section contains experimental tab-separated comments for
+# use by user agents like tzselect that identify continents and oceans.
+#
+# For example, the comment "#@AQ<tab>Antarctica/" means the country code
+# AQ is in the continent Antarctica regardless of the Zone name,
+# so Pacific/Auckland should be listed under Antarctica as well as
+# under the Pacific because its line's country codes include AQ.
+#
+# If more than one country code is affected each is listed separated
+# by commas, e.g., #@IS,SH<tab>Atlantic/".  If a country code is in
+# more than one continent or ocean, each is listed separated by
+# commas, e.g., the second column of "#@CY,TR<tab>Asia/,Europe/".
+#
+# These experimental comments are present only for country codes where
+# the continent or ocean is not already obvious from the Zone name.
+# For example, there is no such comment for RU since it already
+# corresponds to Zone names starting with both "Europe/" and "Asia/".
+#
+#@AQ	Antarctica/
+#@IS,SH	Atlantic/
+#@CY,TR	Asia/,Europe/
+#@SJ	Arctic/
+#@CC,CX,KM,MG,YT	Indian/
diff --git a/requirements.txt b/requirements.txt
index 20c27a1d..877a8aca 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -34,7 +34,7 @@ PyJWT==2.4.0
 pyparsing==3.0.9
 python-dateutil==2.8.2
 python-twitter==3.5
-pytz==2022.1
+pytz==2022.6
 requests==2.28.1
 requests-oauthlib==1.3.1
 rumps==0.3.0; platform_system == "Darwin"

From 3af08f0d07132bfd505a0d03231c9a62651cc617 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 12 Nov 2022 17:29:02 -0800
Subject: [PATCH 221/743] Bump websocket-client from 1.3.2 to 1.4.2 (#1886)

* Bump websocket-client from 1.3.2 to 1.4.2

Bumps [websocket-client](https://github.com/websocket-client/websocket-client) from 1.3.2 to 1.4.2.
- [Release notes](https://github.com/websocket-client/websocket-client/releases)
- [Changelog](https://github.com/websocket-client/websocket-client/blob/master/ChangeLog)
- [Commits](https://github.com/websocket-client/websocket-client/compare/v1.3.2...v1.4.2)

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

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

* Update websocket-client==1.4.2

Signed-off-by: dependabot[bot] <support@github.com>
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/websocket/__init__.py             |   4 +-
 lib/websocket/_app.py                 | 190 +++++++++++++++++---------
 lib/websocket/_core.py                |  15 +-
 lib/websocket/_handshake.py           |  15 +-
 lib/websocket/_http.py                |  21 ++-
 lib/websocket/_logging.py             |   8 +-
 lib/websocket/tests/test_app.py       |   9 +-
 lib/websocket/tests/test_http.py      |  12 +-
 lib/websocket/tests/test_websocket.py |   2 +-
 requirements.txt                      |   2 +-
 10 files changed, 177 insertions(+), 101 deletions(-)

diff --git a/lib/websocket/__init__.py b/lib/websocket/__init__.py
index a5a39502..588a8f21 100644
--- a/lib/websocket/__init__.py
+++ b/lib/websocket/__init__.py
@@ -17,10 +17,10 @@ See the License for the specific language governing permissions and
 limitations under the License.
 """
 from ._abnf import *
-from ._app import WebSocketApp
+from ._app import WebSocketApp, setReconnect
 from ._core import *
 from ._exceptions import *
 from ._logging import *
 from ._socket import *
 
-__version__ = "1.3.2"
+__version__ = "1.4.2"
diff --git a/lib/websocket/_app.py b/lib/websocket/_app.py
index da49ec78..e0a88e2f 100644
--- a/lib/websocket/_app.py
+++ b/lib/websocket/_app.py
@@ -1,9 +1,11 @@
+import inspect
 import selectors
 import sys
 import threading
 import time
 import traceback
 from ._abnf import ABNF
+from ._url import parse_url
 from ._core import WebSocket, getdefaulttimeout
 from ._exceptions import *
 from . import _logging
@@ -29,15 +31,40 @@ limitations under the License.
 
 __all__ = ["WebSocketApp"]
 
+RECONNECT = 0
 
-class Dispatcher:
+
+def setReconnect(reconnectInterval):
+    global RECONNECT
+    RECONNECT = reconnectInterval
+
+
+class DispatcherBase:
     """
-    Dispatcher
+    DispatcherBase
     """
     def __init__(self, app, ping_timeout):
         self.app = app
         self.ping_timeout = ping_timeout
 
+    def timeout(self, seconds, callback):
+        time.sleep(seconds)
+        callback()
+
+    def reconnect(self, seconds, reconnector):
+        try:
+            while True:
+                _logging.info("reconnect() - retrying in %s seconds [%s frames in stack]" % (seconds, len(inspect.stack())))
+                time.sleep(seconds)
+                reconnector(reconnecting=True)
+        except KeyboardInterrupt as e:
+            _logging.info("User exited %s" % (e,))
+
+
+class Dispatcher(DispatcherBase):
+    """
+    Dispatcher
+    """
     def read(self, sock, read_callback, check_callback):
         while self.app.keep_running:
             sel = selectors.DefaultSelector()
@@ -51,14 +78,10 @@ class Dispatcher:
             sel.close()
 
 
-class SSLDispatcher:
+class SSLDispatcher(DispatcherBase):
     """
     SSLDispatcher
     """
-    def __init__(self, app, ping_timeout):
-        self.app = app
-        self.ping_timeout = ping_timeout
-
     def read(self, sock, read_callback, check_callback):
         while self.app.keep_running:
             r = self.select()
@@ -90,10 +113,17 @@ class WrappedDispatcher:
         self.app = app
         self.ping_timeout = ping_timeout
         self.dispatcher = dispatcher
+        dispatcher.signal(2, dispatcher.abort)  # keyboard interrupt
 
     def read(self, sock, read_callback, check_callback):
         self.dispatcher.read(sock, read_callback)
-        self.ping_timeout and self.dispatcher.timeout(self.ping_timeout, check_callback)
+        self.ping_timeout and self.timeout(self.ping_timeout, check_callback)
+
+    def timeout(self, seconds, callback):
+        self.dispatcher.timeout(seconds, callback)
+
+    def reconnect(self, seconds, reconnector):
+        self.timeout(seconds, reconnector)
 
 
 class WebSocketApp:
@@ -186,6 +216,7 @@ class WebSocketApp:
         self.last_pong_tm = 0
         self.subprotocols = subprotocols
         self.prepared_socket = socket
+        self.has_errored = False
 
     def send(self, data, opcode=ABNF.OPCODE_TEXT):
         """
@@ -228,9 +259,10 @@ class WebSocketApp:
                     ping_payload="",
                     http_proxy_host=None, http_proxy_port=None,
                     http_no_proxy=None, http_proxy_auth=None,
+                    http_proxy_timeout=None,
                     skip_utf8_validation=False,
                     host=None, origin=None, dispatcher=None,
-                    suppress_origin=False, proxy_type=None):
+                    suppress_origin=False, proxy_type=None, reconnect=None):
         """
         Run event loop for WebSocket framework.
 
@@ -258,6 +290,10 @@ class WebSocketApp:
             HTTP proxy port. If not set, set to 80.
         http_no_proxy: list
             Whitelisted host names that don't use the proxy.
+        http_proxy_timeout: int or float
+            HTTP proxy timeout, default is 60 sec as per python-socks.
+        http_proxy_auth: tuple
+            HTTP proxy auth information. tuple of username and password. Default is None.
         skip_utf8_validation: bool
             skip utf8 validation.
         host: str
@@ -268,6 +304,10 @@ class WebSocketApp:
             customize reading data from socket.
         suppress_origin: bool
             suppress outputting origin header.
+        proxy_type: str
+            type of proxy from: http, socks4, socks4a, socks5, socks5h
+        reconnect: int
+            delay interval when reconnecting
 
         Returns
         -------
@@ -276,6 +316,9 @@ class WebSocketApp:
             True if any other exception was raised during a loop.
         """
 
+        if reconnect is None:
+            reconnect = RECONNECT
+
         if ping_timeout is not None and ping_timeout <= 0:
             raise WebSocketException("Ensure ping_timeout > 0")
         if ping_interval is not None and ping_interval < 0:
@@ -317,84 +360,105 @@ class WebSocketApp:
             # Finally call the callback AFTER all teardown is complete
             self._callback(self.on_close, close_status_code, close_reason)
 
-        try:
+        def setSock(reconnecting=False):
             self.sock = WebSocket(
                 self.get_mask_key, sockopt=sockopt, sslopt=sslopt,
                 fire_cont_frame=self.on_cont_message is not None,
                 skip_utf8_validation=skip_utf8_validation,
                 enable_multithread=True)
             self.sock.settimeout(getdefaulttimeout())
-            self.sock.connect(
-                self.url, header=self.header, cookie=self.cookie,
-                http_proxy_host=http_proxy_host,
-                http_proxy_port=http_proxy_port, http_no_proxy=http_no_proxy,
-                http_proxy_auth=http_proxy_auth, subprotocols=self.subprotocols,
-                host=host, origin=origin, suppress_origin=suppress_origin,
-                proxy_type=proxy_type, socket=self.prepared_socket)
-            dispatcher = self.create_dispatcher(ping_timeout, dispatcher)
+            try:
+                self.sock.connect(
+                    self.url, header=self.header, cookie=self.cookie,
+                    http_proxy_host=http_proxy_host,
+                    http_proxy_port=http_proxy_port, http_no_proxy=http_no_proxy,
+                    http_proxy_auth=http_proxy_auth, http_proxy_timeout=http_proxy_timeout,
+                    subprotocols=self.subprotocols,
+                    host=host, origin=origin, suppress_origin=suppress_origin,
+                    proxy_type=proxy_type, socket=self.prepared_socket)
 
-            self._callback(self.on_open)
+                self._callback(self.on_open)
 
-            if ping_interval:
-                event = threading.Event()
-                thread = threading.Thread(
-                    target=self._send_ping, args=(ping_interval, event, ping_payload))
-                thread.daemon = True
-                thread.start()
+                _logging.warning("websocket connected")
+                dispatcher.read(self.sock.sock, read, check)
+            except (WebSocketConnectionClosedException, ConnectionRefusedError, KeyboardInterrupt, SystemExit, Exception) as e:
+                _logging.error("%s - %s" % (e, reconnect and "reconnecting" or "goodbye"))
+                reconnecting or handleDisconnect(e)
 
-            def read():
-                if not self.keep_running:
-                    return teardown()
+        def read():
+            if not self.keep_running:
+                return teardown()
 
+            try:
                 op_code, frame = self.sock.recv_data_frame(True)
-                if op_code == ABNF.OPCODE_CLOSE:
-                    return teardown(frame)
-                elif op_code == ABNF.OPCODE_PING:
-                    self._callback(self.on_ping, frame.data)
-                elif op_code == ABNF.OPCODE_PONG:
-                    self.last_pong_tm = time.time()
-                    self._callback(self.on_pong, frame.data)
-                elif op_code == ABNF.OPCODE_CONT and self.on_cont_message:
-                    self._callback(self.on_data, frame.data,
-                                   frame.opcode, frame.fin)
-                    self._callback(self.on_cont_message,
-                                   frame.data, frame.fin)
+            except (WebSocketConnectionClosedException, KeyboardInterrupt) as e:
+                if custom_dispatcher:
+                    return handleDisconnect(e)
                 else:
-                    data = frame.data
-                    if op_code == ABNF.OPCODE_TEXT:
-                        data = data.decode("utf-8")
-                    self._callback(self.on_data, data, frame.opcode, True)
-                    self._callback(self.on_message, data)
+                    raise e
+            if op_code == ABNF.OPCODE_CLOSE:
+                return teardown(frame)
+            elif op_code == ABNF.OPCODE_PING:
+                self._callback(self.on_ping, frame.data)
+            elif op_code == ABNF.OPCODE_PONG:
+                self.last_pong_tm = time.time()
+                self._callback(self.on_pong, frame.data)
+            elif op_code == ABNF.OPCODE_CONT and self.on_cont_message:
+                self._callback(self.on_data, frame.data,
+                               frame.opcode, frame.fin)
+                self._callback(self.on_cont_message,
+                               frame.data, frame.fin)
+            else:
+                data = frame.data
+                if op_code == ABNF.OPCODE_TEXT:
+                    data = data.decode("utf-8")
+                self._callback(self.on_data, data, frame.opcode, True)
+                self._callback(self.on_message, data)
 
-                return True
+            return True
 
-            def check():
-                if (ping_timeout):
-                    has_timeout_expired = time.time() - self.last_ping_tm > ping_timeout
-                    has_pong_not_arrived_after_last_ping = self.last_pong_tm - self.last_ping_tm < 0
-                    has_pong_arrived_too_late = self.last_pong_tm - self.last_ping_tm > ping_timeout
+        def check():
+            if (ping_timeout):
+                has_timeout_expired = time.time() - self.last_ping_tm > ping_timeout
+                has_pong_not_arrived_after_last_ping = self.last_pong_tm - self.last_ping_tm < 0
+                has_pong_arrived_too_late = self.last_pong_tm - self.last_ping_tm > ping_timeout
 
-                    if (self.last_ping_tm and
-                            has_timeout_expired and
-                            (has_pong_not_arrived_after_last_ping or has_pong_arrived_too_late)):
-                        raise WebSocketTimeoutException("ping/pong timed out")
-                return True
+                if (self.last_ping_tm and
+                        has_timeout_expired and
+                        (has_pong_not_arrived_after_last_ping or has_pong_arrived_too_late)):
+                    raise WebSocketTimeoutException("ping/pong timed out")
+            return True
 
-            dispatcher.read(self.sock.sock, read, check)
-            return False
-        except (Exception, KeyboardInterrupt, SystemExit) as e:
+        def handleDisconnect(e):
+            self.has_errored = True
             self._callback(self.on_error, e)
             if isinstance(e, SystemExit):
                 # propagate SystemExit further
                 raise
-            teardown()
-            return not isinstance(e, KeyboardInterrupt)
+            if reconnect and not isinstance(e, KeyboardInterrupt):
+                _logging.info("websocket disconnected (retrying in %s seconds) [%s frames in stack]" % (reconnect, len(inspect.stack())))
+                dispatcher.reconnect(reconnect, setSock)
+            else:
+                teardown()
 
-    def create_dispatcher(self, ping_timeout, dispatcher=None):
+        custom_dispatcher = bool(dispatcher)
+        dispatcher = self.create_dispatcher(ping_timeout, dispatcher, parse_url(self.url)[3])
+
+        if ping_interval:
+            event = threading.Event()
+            thread = threading.Thread(
+                target=self._send_ping, args=(ping_interval, event, ping_payload))
+            thread.daemon = True
+            thread.start()
+
+        setSock()
+        return self.has_errored
+
+    def create_dispatcher(self, ping_timeout, dispatcher=None, is_ssl=False):
         if dispatcher:  # If custom dispatcher is set, use WrappedDispatcher
             return WrappedDispatcher(self, ping_timeout, dispatcher)
         timeout = ping_timeout or 10
-        if self.sock.is_ssl():
+        if is_ssl:
             return SSLDispatcher(self, timeout)
 
         return Dispatcher(self, timeout)
diff --git a/lib/websocket/_core.py b/lib/websocket/_core.py
index c36b7800..1d688294 100644
--- a/lib/websocket/_core.py
+++ b/lib/websocket/_core.py
@@ -46,8 +46,11 @@ class WebSocket:
 
     >>> import websocket
     >>> ws = websocket.WebSocket()
-    >>> ws.connect("ws://echo.websocket.org")
+    >>> ws.connect("ws://echo.websocket.events")
+    >>> ws.recv()
+    'echo.websocket.events sponsored by Lob.com'
     >>> ws.send("Hello, Server")
+    19
     >>> ws.recv()
     'Hello, Server'
     >>> ws.close()
@@ -203,7 +206,7 @@ class WebSocket:
         If you set "header" list object, you can set your own custom header.
 
         >>> ws = WebSocket()
-        >>> ws.connect("ws://echo.websocket.org/",
+        >>> ws.connect("ws://echo.websocket.events",
                 ...     header=["User-Agent: MyProgram",
                 ...             "x-custom: header"])
 
@@ -233,6 +236,8 @@ class WebSocket:
             Whitelisted host names that don't use the proxy.
         http_proxy_auth: tuple
             HTTP proxy auth information. Tuple of username and password. Default is None.
+        http_proxy_timeout: int or float
+            HTTP proxy timeout, default is 60 sec as per python-socks.
         redirect_limit: int
             Number of redirects to follow.
         subprotocols: list
@@ -281,7 +286,7 @@ class WebSocket:
         """
         Send the data frame.
 
-        >>> ws = create_connection("ws://echo.websocket.org/")
+        >>> ws = create_connection("ws://echo.websocket.events")
         >>> frame = ABNF.create_frame("Hello", ABNF.OPCODE_TEXT)
         >>> ws.send_frame(frame)
         >>> cont_frame = ABNF.create_frame("My name is ", ABNF.OPCODE_CONT, 0)
@@ -541,7 +546,7 @@ def create_connection(url, timeout=None, class_=WebSocket, **options):
     You can customize using 'options'.
     If you set "header" list object, you can set your own custom header.
 
-    >>> conn = create_connection("ws://echo.websocket.org/",
+    >>> conn = create_connection("ws://echo.websocket.events",
          ...     header=["User-Agent: MyProgram",
          ...             "x-custom: header"])
 
@@ -572,6 +577,8 @@ def create_connection(url, timeout=None, class_=WebSocket, **options):
         Whitelisted host names that don't use the proxy.
     http_proxy_auth: tuple
         HTTP proxy auth information. tuple of username and password. Default is None.
+    http_proxy_timeout: int or float
+        HTTP proxy timeout, default is 60 sec as per python-socks.
     enable_multithread: bool
         Enable lock for multithread.
     redirect_limit: int
diff --git a/lib/websocket/_handshake.py b/lib/websocket/_handshake.py
index f032c4b5..07a4cfb2 100644
--- a/lib/websocket/_handshake.py
+++ b/lib/websocket/_handshake.py
@@ -81,7 +81,7 @@ def _get_handshake_headers(resource, url, host, port, options):
         hostport = _pack_hostname(host)
     else:
         hostport = "%s:%d" % (_pack_hostname(host), port)
-    if "host" in options and options["host"] is not None:
+    if options.get("host"):
         headers.append("Host: %s" % options["host"])
     else:
         headers.append("Host: %s" % hostport)
@@ -89,7 +89,7 @@ def _get_handshake_headers(resource, url, host, port, options):
     # scheme indicates whether http or https is used in Origin
     # The same approach is used in parse_url of _url.py to set default port
     scheme, url = url.split(":", 1)
-    if "suppress_origin" not in options or not options["suppress_origin"]:
+    if not options.get("suppress_origin"):
         if "origin" in options and options["origin"] is not None:
             headers.append("Origin: %s" % options["origin"])
         elif scheme == "wss":
@@ -100,16 +100,15 @@ def _get_handshake_headers(resource, url, host, port, options):
     key = _create_sec_websocket_key()
 
     # Append Sec-WebSocket-Key & Sec-WebSocket-Version if not manually specified
-    if 'header' not in options or 'Sec-WebSocket-Key' not in options['header']:
-        key = _create_sec_websocket_key()
+    if not options.get('header') or 'Sec-WebSocket-Key' not in options['header']:
         headers.append("Sec-WebSocket-Key: %s" % key)
     else:
         key = options['header']['Sec-WebSocket-Key']
 
-    if 'header' not in options or 'Sec-WebSocket-Version' not in options['header']:
+    if not options.get('header') or 'Sec-WebSocket-Version' not in options['header']:
         headers.append("Sec-WebSocket-Version: %s" % VERSION)
 
-    if 'connection' not in options or options['connection'] is None:
+    if not options.get('connection'):
         headers.append('Connection: Upgrade')
     else:
         headers.append(options['connection'])
@@ -118,8 +117,8 @@ def _get_handshake_headers(resource, url, host, port, options):
     if subprotocols:
         headers.append("Sec-WebSocket-Protocol: %s" % ",".join(subprotocols))
 
-    if "header" in options:
-        header = options["header"]
+    header = options.get("header")
+    if header:
         if isinstance(header, dict):
             header = [
                 ": ".join([k, v])
diff --git a/lib/websocket/_http.py b/lib/websocket/_http.py
index 04f32f5a..17d3f8aa 100644
--- a/lib/websocket/_http.py
+++ b/lib/websocket/_http.py
@@ -23,7 +23,7 @@ import sys
 
 from ._exceptions import *
 from ._logging import *
-from ._socket import*
+from ._socket import *
 from ._ssl_compat import *
 from ._url import *
 
@@ -59,7 +59,7 @@ class proxy_info:
             self.no_proxy = options.get("http_no_proxy", None)
             self.proxy_protocol = options.get("proxy_type", "http")
             # Note: If timeout not specified, default python-socks timeout is 60 seconds
-            self.proxy_timeout = options.get("timeout", None)
+            self.proxy_timeout = options.get("http_proxy_timeout", None)
             if self.proxy_protocol not in ['http', 'socks4', 'socks4a', 'socks5', 'socks5h']:
                 raise ProxyError("Only http, socks4, socks5 proxy protocols are supported")
         else:
@@ -114,22 +114,22 @@ def connect(url, options, proxy, socket):
     if proxy.proxy_host and not socket and not (proxy.proxy_protocol == "http"):
         return _start_proxied_socket(url, options, proxy)
 
-    hostname, port, resource, is_secure = parse_url(url)
+    hostname, port_from_url, resource, is_secure = parse_url(url)
 
     if socket:
-        return socket, (hostname, port, resource)
+        return socket, (hostname, port_from_url, resource)
 
     addrinfo_list, need_tunnel, auth = _get_addrinfo_list(
-        hostname, port, is_secure, proxy)
+        hostname, port_from_url, is_secure, proxy)
     if not addrinfo_list:
         raise WebSocketException(
-            "Host not found.: " + hostname + ":" + str(port))
+            "Host not found.: " + hostname + ":" + str(port_from_url))
 
     sock = None
     try:
         sock = _open_socket(addrinfo_list, options.sockopt, options.timeout)
         if need_tunnel:
-            sock = _tunnel(sock, hostname, port, auth)
+            sock = _tunnel(sock, hostname, port_from_url, auth)
 
         if is_secure:
             if HAVE_SSL:
@@ -137,7 +137,7 @@ def connect(url, options, proxy, socket):
             else:
                 raise WebSocketException("SSL not available.")
 
-        return sock, (hostname, port, resource)
+        return sock, (hostname, port_from_url, resource)
     except:
         if sock:
             sock.close()
@@ -184,17 +184,16 @@ def _open_socket(addrinfo_list, sockopt, timeout):
             try:
                 sock.connect(address)
             except socket.error as error:
+                sock.close()
                 error.remote_ip = str(address[0])
                 try:
                     eConnRefused = (errno.ECONNREFUSED, errno.WSAECONNREFUSED, errno.ENETUNREACH)
-                except:
+                except AttributeError:
                     eConnRefused = (errno.ECONNREFUSED, errno.ENETUNREACH)
                 if error.errno in eConnRefused:
                     err = error
                     continue
                 else:
-                    if sock:
-                        sock.close()
                     raise error
             else:
                 break
diff --git a/lib/websocket/_logging.py b/lib/websocket/_logging.py
index df690dcc..3921111d 100644
--- a/lib/websocket/_logging.py
+++ b/lib/websocket/_logging.py
@@ -35,7 +35,7 @@ __all__ = ["enableTrace", "dump", "error", "warning", "debug", "trace",
            "isEnabledForError", "isEnabledForDebug", "isEnabledForTrace"]
 
 
-def enableTrace(traceable, handler=logging.StreamHandler()):
+def enableTrace(traceable, handler=logging.StreamHandler(), level="DEBUG"):
     """
     Turn on/off the traceability.
 
@@ -48,7 +48,7 @@ def enableTrace(traceable, handler=logging.StreamHandler()):
     _traceEnabled = traceable
     if traceable:
         _logger.addHandler(handler)
-        _logger.setLevel(logging.DEBUG)
+        _logger.setLevel(getattr(logging, level))
 
 
 def dump(title, message):
@@ -70,6 +70,10 @@ def debug(msg):
     _logger.debug(msg)
 
 
+def info(msg):
+    _logger.info(msg)
+
+
 def trace(msg):
     if _traceEnabled:
         _logger.debug(msg)
diff --git a/lib/websocket/tests/test_app.py b/lib/websocket/tests/test_app.py
index ac2a7dd5..5526d3ec 100644
--- a/lib/websocket/tests/test_app.py
+++ b/lib/websocket/tests/test_app.py
@@ -80,7 +80,8 @@ class WebSocketAppTest(unittest.TestCase):
         app = ws.WebSocketApp('ws://127.0.0.1:' + LOCAL_WS_SERVER_PORT, on_open=on_open, on_close=on_close, on_message=on_message)
         app.run_forever()
 
-    @unittest.skipUnless(TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled")
+#    @unittest.skipUnless(TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled")
+    @unittest.skipUnless(False, "Test disabled for now (requires rel)")
     def testRunForeverDispatcher(self):
         """ A WebSocketApp should keep running as long as its self.keep_running
         is not False (in the boolean context).
@@ -98,7 +99,9 @@ class WebSocketAppTest(unittest.TestCase):
             self.close()
 
         app = ws.WebSocketApp('ws://127.0.0.1:' + LOCAL_WS_SERVER_PORT, on_open=on_open, on_message=on_message)
-        app.run_forever(dispatcher="Dispatcher")
+        app.run_forever(dispatcher="Dispatcher")  # doesn't work
+#        app.run_forever(dispatcher=rel)          # would work
+#        rel.dispatch()
 
     @unittest.skipUnless(TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled")
     def testRunForeverTeardownCleanExit(self):
@@ -188,7 +191,7 @@ class WebSocketAppTest(unittest.TestCase):
         """ Test WebSocketApp binary opcode
         """
         # The lack of wss:// in the URL below is on purpose
-        app = ws.WebSocketApp('streaming.vn.teslamotors.com/streaming/')
+        app = ws.WebSocketApp('wss://streaming.vn.teslamotors.com/streaming/')
         app.run_forever(ping_interval=2, ping_timeout=1, ping_payload="Ping payload")
 
     @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled")
diff --git a/lib/websocket/tests/test_http.py b/lib/websocket/tests/test_http.py
index 649e0fe6..ffcbde25 100644
--- a/lib/websocket/tests/test_http.py
+++ b/lib/websocket/tests/test_http.py
@@ -105,15 +105,15 @@ class HttpTest(unittest.TestCase):
         if ws._http.HAVE_PYTHON_SOCKS:
             # Need this check, otherwise case where python_socks is not installed triggers
             # websocket._exceptions.WebSocketException: Python Socks is needed for SOCKS proxying but is not available
-            self.assertRaises((ProxyTimeoutError, OSError), _start_proxied_socket, "wss://example.com", OptsList(), proxy_info(http_proxy_host="example.com", http_proxy_port="8080", proxy_type="socks4", timeout=1))
-            self.assertRaises((ProxyTimeoutError, OSError), _start_proxied_socket, "wss://example.com", OptsList(), proxy_info(http_proxy_host="example.com", http_proxy_port="8080", proxy_type="socks4a", timeout=1))
-            self.assertRaises((ProxyTimeoutError, OSError), _start_proxied_socket, "wss://example.com", OptsList(), proxy_info(http_proxy_host="example.com", http_proxy_port="8080", proxy_type="socks5", timeout=1))
-            self.assertRaises((ProxyTimeoutError, OSError), _start_proxied_socket, "wss://example.com", OptsList(), proxy_info(http_proxy_host="example.com", http_proxy_port="8080", proxy_type="socks5h", timeout=1))
-            self.assertRaises(ProxyConnectionError, connect, "wss://example.com", OptsList(), proxy_info(http_proxy_host="127.0.0.1", http_proxy_port=9999, proxy_type="socks4", timeout=1), None)
+            self.assertRaises((ProxyTimeoutError, OSError), _start_proxied_socket, "wss://example.com", OptsList(), proxy_info(http_proxy_host="example.com", http_proxy_port="8080", proxy_type="socks4", http_proxy_timeout=1))
+            self.assertRaises((ProxyTimeoutError, OSError), _start_proxied_socket, "wss://example.com", OptsList(), proxy_info(http_proxy_host="example.com", http_proxy_port="8080", proxy_type="socks4a", http_proxy_timeout=1))
+            self.assertRaises((ProxyTimeoutError, OSError), _start_proxied_socket, "wss://example.com", OptsList(), proxy_info(http_proxy_host="example.com", http_proxy_port="8080", proxy_type="socks5", http_proxy_timeout=1))
+            self.assertRaises((ProxyTimeoutError, OSError), _start_proxied_socket, "wss://example.com", OptsList(), proxy_info(http_proxy_host="example.com", http_proxy_port="8080", proxy_type="socks5h", http_proxy_timeout=1))
+            self.assertRaises(ProxyConnectionError, connect, "wss://example.com", OptsList(), proxy_info(http_proxy_host="127.0.0.1", http_proxy_port=9999, proxy_type="socks4", http_proxy_timeout=1), None)
 
         self.assertRaises(TypeError, _get_addrinfo_list, None, 80, True, proxy_info(http_proxy_host="127.0.0.1", http_proxy_port="9999", proxy_type="http"))
         self.assertRaises(TypeError, _get_addrinfo_list, None, 80, True, proxy_info(http_proxy_host="127.0.0.1", http_proxy_port="9999", proxy_type="http"))
-        self.assertRaises(socket.timeout, connect, "wss://google.com", OptsList(), proxy_info(http_proxy_host="8.8.8.8", http_proxy_port=9999, proxy_type="http", timeout=1), None)
+        self.assertRaises(socket.timeout, connect, "wss://google.com", OptsList(), proxy_info(http_proxy_host="8.8.8.8", http_proxy_port=9999, proxy_type="http", http_proxy_timeout=1), None)
         self.assertEqual(
             connect("wss://google.com", OptsList(), proxy_info(http_proxy_host="8.8.8.8", http_proxy_port=8080, proxy_type="http"), True),
             (True, ("google.com", 443, "/")))
diff --git a/lib/websocket/tests/test_websocket.py b/lib/websocket/tests/test_websocket.py
index ae42ab54..d47d73e5 100644
--- a/lib/websocket/tests/test_websocket.py
+++ b/lib/websocket/tests/test_websocket.py
@@ -432,7 +432,7 @@ class HandshakeTest(unittest.TestCase):
         self.assertRaises(ws._exceptions.WebSocketBadStatusException,
                           websock3.connect, "wss://api.bitfinex.com/ws/2", cookie="chocolate",
                           origin="testing_websockets.com",
-                          host="echo.websocket.org/websocket-client-test",
+                          host="echo.websocket.events/websocket-client-test",
                           subprotocols=["testproto"],
                           connection="Upgrade",
                           header={"CustomHeader1":"123",
diff --git a/requirements.txt b/requirements.txt
index 877a8aca..c505d8ae 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -47,7 +47,7 @@ tzdata==2022.6
 tzlocal==4.2
 urllib3==1.26.12
 webencodings==0.5.1
-websocket-client==1.3.2
+websocket-client==1.4.2
 xmltodict==0.13.0
 zipp==3.10.0
 

From e79da07973fa3981d172507846b2a0fb68346baf Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 12 Nov 2022 17:29:35 -0800
Subject: [PATCH 222/743] Bump plexapi from 4.12.1 to 4.13.1 (#1888)

Bumps [plexapi](https://github.com/pkkid/python-plexapi) from 4.12.1 to 4.13.1.
- [Release notes](https://github.com/pkkid/python-plexapi/releases)
- [Commits](https://github.com/pkkid/python-plexapi/compare/4.12.1...4.13.1)

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

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

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 lib/plexapi/audio.py      |  58 ++-
 lib/plexapi/base.py       | 212 +++++++---
 lib/plexapi/client.py     |  27 +-
 lib/plexapi/collection.py |  90 ++---
 lib/plexapi/config.py     |   2 +-
 lib/plexapi/const.py      |   4 +-
 lib/plexapi/library.py    | 786 ++++++++++++++++++++++++++++++--------
 lib/plexapi/media.py      |  70 ++--
 lib/plexapi/mixins.py     | 199 ++++++----
 lib/plexapi/myplex.py     | 321 +++++++++++++---
 lib/plexapi/photo.py      |  31 +-
 lib/plexapi/playlist.py   |  61 ++-
 lib/plexapi/playqueue.py  |  54 ++-
 lib/plexapi/server.py     |  99 ++---
 lib/plexapi/settings.py   |  18 +-
 lib/plexapi/sonos.py      |   4 +-
 lib/plexapi/sync.py       |  11 +-
 lib/plexapi/utils.py      | 183 +++++++--
 lib/plexapi/video.py      | 283 ++++++++------
 requirements.txt          |   2 +-
 20 files changed, 1791 insertions(+), 724 deletions(-)

diff --git a/lib/plexapi/audio.py b/lib/plexapi/audio.py
index 621183b3..ff9e1e1a 100644
--- a/lib/plexapi/audio.py
+++ b/lib/plexapi/audio.py
@@ -3,10 +3,10 @@ import os
 from urllib.parse import quote_plus
 
 from plexapi import media, utils
-from plexapi.base import Playable, PlexPartialObject
-from plexapi.exceptions import BadRequest
+from plexapi.base import Playable, PlexPartialObject, PlexSession
+from plexapi.exceptions import BadRequest, NotFound
 from plexapi.mixins import (
-    AdvancedSettingsMixin, SplitMergeMixin, UnmatchMatchMixin, ExtrasMixin, HubsMixin, RatingMixin,
+    AdvancedSettingsMixin, SplitMergeMixin, UnmatchMatchMixin, ExtrasMixin, HubsMixin, PlayedUnplayedMixin, RatingMixin,
     ArtUrlMixin, ArtMixin, PosterUrlMixin, PosterMixin, ThemeMixin, ThemeUrlMixin,
     OriginallyAvailableMixin, SortTitleMixin, StudioMixin, SummaryMixin, TitleMixin,
     TrackArtistMixin, TrackDiscNumberMixin, TrackNumberMixin,
@@ -15,7 +15,7 @@ from plexapi.mixins import (
 from plexapi.playlist import Playlist
 
 
-class Audio(PlexPartialObject):
+class Audio(PlexPartialObject, PlayedUnplayedMixin):
     """ Base class for all audio objects including :class:`~plexapi.audio.Artist`,
         :class:`~plexapi.audio.Album`, and :class:`~plexapi.audio.Track`.
 
@@ -46,7 +46,6 @@ class Audio(PlexPartialObject):
             userRating (float): Rating of the item (0.0 - 10.0) equaling (0 stars - 5 stars).
             viewCount (int): Count of times the item was played.
     """
-
     METADATA_TYPE = 'track'
 
     def _loadData(self, data):
@@ -121,7 +120,7 @@ class Audio(PlexPartialObject):
 
         section = self._server.library.sectionByID(self.librarySectionID)
 
-        sync_item.location = 'library://%s/item/%s' % (section.uuid, quote_plus(self.key))
+        sync_item.location = f'library://{section.uuid}/item/{quote_plus(self.key)}'
         sync_item.policy = Policy.create(limit)
         sync_item.mediaSettings = MediaSettings.createMusic(bitrate)
 
@@ -146,6 +145,7 @@ class Artist(
             collections (List<:class:`~plexapi.media.Collection`>): List of collection objects.
             countries (List<:class:`~plexapi.media.Country`>): List country objects.
             genres (List<:class:`~plexapi.media.Genre`>): List of genre objects.
+            guids (List<:class:`~plexapi.media.Guid`>): List of guid objects.
             key (str): API URL (/library/metadata/<ratingkey>).
             labels (List<:class:`~plexapi.media.Label`>): List of label objects.
             locations (List<str>): List of folder paths where the artist is found on disk.
@@ -163,6 +163,7 @@ class Artist(
         self.collections = self.findItems(data, media.Collection)
         self.countries = self.findItems(data, media.Country)
         self.genres = self.findItems(data, media.Genre)
+        self.guids = self.findItems(data, media.Guid)
         self.key = self.key.replace('/children', '')  # FIX_BUG_50
         self.labels = self.findItems(data, media.Label)
         self.locations = self.listAttrs(data, 'path', etag='Location')
@@ -180,13 +181,14 @@ class Artist(
             Parameters:
                 title (str): Title of the album to return.
         """
-        key = f"/library/sections/{self.librarySectionID}/all?artist.id={self.ratingKey}&type=9"
-        return self.fetchItem(key, Album, title__iexact=title)
+        try:
+            return self.section().search(title, libtype='album', filters={'artist.id': self.ratingKey})[0]
+        except IndexError:
+            raise NotFound(f"Unable to find album '{title}'") from None
 
     def albums(self, **kwargs):
         """ Returns a list of :class:`~plexapi.audio.Album` objects by the artist. """
-        key = f"/library/sections/{self.librarySectionID}/all?artist.id={self.ratingKey}&type=9"
-        return self.fetchItems(key, Album, **kwargs)
+        return self.section().search(libtype='album', filters={'artist.id': self.ratingKey}, **kwargs)
 
     def track(self, title=None, album=None, track=None):
         """ Returns the :class:`~plexapi.audio.Track` that matches the specified title.
@@ -199,7 +201,7 @@ class Artist(
             Raises:
                 :exc:`~plexapi.exceptions.BadRequest`: If title or album and track parameters are missing.
         """
-        key = '/library/metadata/%s/allLeaves' % self.ratingKey
+        key = f'{self.key}/allLeaves'
         if title is not None:
             return self.fetchItem(key, Track, title__iexact=title)
         elif album is not None and track is not None:
@@ -208,7 +210,7 @@ class Artist(
 
     def tracks(self, **kwargs):
         """ Returns a list of :class:`~plexapi.audio.Track` objects by the artist. """
-        key = '/library/metadata/%s/allLeaves' % self.ratingKey
+        key = f'{self.key}/allLeaves'
         return self.fetchItems(key, Track, **kwargs)
 
     def get(self, title=None, album=None, track=None):
@@ -233,7 +235,7 @@ class Artist(
 
     def station(self):
         """ Returns a :class:`~plexapi.playlist.Playlist` artist radio station or `None`. """
-        key = '%s?includeStations=1' % self.key
+        key = f'{self.key}?includeStations=1'
         return next(iter(self.fetchItems(key, cls=Playlist, rtag="Stations")), None)
 
 
@@ -253,6 +255,7 @@ class Album(
             collections (List<:class:`~plexapi.media.Collection`>): List of collection objects.
             formats (List<:class:`~plexapi.media.Format`>): List of format objects.
             genres (List<:class:`~plexapi.media.Genre`>): List of genre objects.
+            guids (List<:class:`~plexapi.media.Guid`>): List of guid objects.
             key (str): API URL (/library/metadata/<ratingkey>).
             labels (List<:class:`~plexapi.media.Label`>): List of label objects.
             leafCount (int): Number of items in the album view.
@@ -280,6 +283,7 @@ class Album(
         self.collections = self.findItems(data, media.Collection)
         self.formats = self.findItems(data, media.Format)
         self.genres = self.findItems(data, media.Genre)
+        self.guids = self.findItems(data, media.Guid)
         self.key = self.key.replace('/children', '')  # FIX_BUG_50
         self.labels = self.findItems(data, media.Label)
         self.leafCount = utils.cast(int, data.attrib.get('leafCount'))
@@ -312,7 +316,7 @@ class Album(
             Raises:
                 :exc:`~plexapi.exceptions.BadRequest`: If title or track parameter is missing.
         """
-        key = '/library/metadata/%s/children' % self.ratingKey
+        key = f'{self.key}/children'
         if title is not None and not isinstance(title, int):
             return self.fetchItem(key, Track, title__iexact=title)
         elif track is not None or isinstance(title, int):
@@ -325,7 +329,7 @@ class Album(
 
     def tracks(self, **kwargs):
         """ Returns a list of :class:`~plexapi.audio.Track` objects in the album. """
-        key = '/library/metadata/%s/children' % self.ratingKey
+        key = f'{self.key}/children'
         return self.fetchItems(key, Track, **kwargs)
 
     def get(self, title=None, track=None):
@@ -352,7 +356,7 @@ class Album(
 
     def _defaultSyncTitle(self):
         """ Returns str, default title for a new syncItem. """
-        return '%s - %s' % (self.parentTitle, self.title)
+        return f'{self.parentTitle} - {self.title}'
 
 
 @utils.registerPlexObject
@@ -380,6 +384,7 @@ class Track(
             grandparentThumb (str): URL to album artist thumbnail image
                 (/library/metadata/<grandparentRatingKey>/thumb/<thumbid>).
             grandparentTitle (str): Name of the album artist for the track.
+            guids (List<:class:`~plexapi.media.Guid`>): List of guid objects.
             labels (List<:class:`~plexapi.media.Label`>): List of label objects.
             media (List<:class:`~plexapi.media.Media`>): List of media objects.
             originalTitle (str): The artist for the track.
@@ -390,7 +395,7 @@ class Track(
             parentThumb (str): URL to album thumbnail image (/library/metadata/<parentRatingKey>/thumb/<thumbid>).
             parentTitle (str): Name of the album for the track.
             primaryExtraKey (str) API URL for the primary extra for the track.
-            ratingCount (int): Number of ratings contributing to the rating score.
+            ratingCount (int): Number of listeners who have scrobbled this track, as reported by Last.fm.
             skipCount (int): Number of times the track has been skipped.
             viewOffset (int): View offset in milliseconds.
             year (int): Year the track was released.
@@ -412,6 +417,7 @@ class Track(
         self.grandparentTheme = data.attrib.get('grandparentTheme')
         self.grandparentThumb = data.attrib.get('grandparentThumb')
         self.grandparentTitle = data.attrib.get('grandparentTitle')
+        self.guids = self.findItems(data, media.Guid)
         self.labels = self.findItems(data, media.Label)
         self.media = self.findItems(data, media.Media)
         self.originalTitle = data.attrib.get('originalTitle')
@@ -429,8 +435,7 @@ class Track(
 
     def _prettyfilename(self):
         """ Returns a filename for use in download. """
-        return '%s - %s - %s - %s' % (
-            self.grandparentTitle, self.parentTitle, str(self.trackNumber).zfill(2), self.title)
+        return f'{self.grandparentTitle} - {self.parentTitle} - {str(self.trackNumber).zfill(2)} - {self.title}'
 
     def album(self):
         """ Return the track's :class:`~plexapi.audio.Album`. """
@@ -457,8 +462,21 @@ class Track(
 
     def _defaultSyncTitle(self):
         """ Returns str, default title for a new syncItem. """
-        return '%s - %s - %s' % (self.grandparentTitle, self.parentTitle, self.title)
+        return f'{self.grandparentTitle} - {self.parentTitle} - {self.title}'
 
     def _getWebURL(self, base=None):
         """ Get the Plex Web URL with the correct parameters. """
         return self._server._buildWebURL(base=base, endpoint='details', key=self.parentKey)
+
+
+@utils.registerPlexObject
+class TrackSession(PlexSession, Track):
+    """ Represents a single Track session
+        loaded from :func:`~plexapi.server.PlexServer.sessions`.
+    """
+    _SESSIONTYPE = True
+
+    def _loadData(self, data):
+        """ Load attribute values from Plex XML response. """
+        Track._loadData(self, data)
+        PlexSession._loadData(self, data)
diff --git a/lib/plexapi/base.py b/lib/plexapi/base.py
index e80b540f..2cb78c53 100644
--- a/lib/plexapi/base.py
+++ b/lib/plexapi/base.py
@@ -1,15 +1,14 @@
 # -*- coding: utf-8 -*-
 import re
 import weakref
-from urllib.parse import quote_plus, urlencode
+from urllib.parse import urlencode
 from xml.etree import ElementTree
 
 from plexapi import log, utils
 from plexapi.exceptions import BadRequest, NotFound, UnknownType, Unsupported
 
 USER_DONT_RELOAD_FOR_KEYS = set()
-_DONT_RELOAD_FOR_KEYS = {'key', 'session'}
-_DONT_OVERWRITE_SESSION_KEYS = {'usernames', 'players', 'transcodeSessions', 'session'}
+_DONT_RELOAD_FOR_KEYS = {'key'}
 OPERATORS = {
     'exact': lambda v, q: v == q,
     'iexact': lambda v, q: v.lower() == q.lower(),
@@ -58,15 +57,11 @@ class PlexObject:
         self._details_key = self._buildDetailsKey()
 
     def __repr__(self):
-        uid = self._clean(self.firstAttr('_baseurl', 'key', 'id', 'playQueueID', 'uri'))
+        uid = self._clean(self.firstAttr('_baseurl', 'ratingKey', 'id', 'key', 'playQueueID', 'uri'))
         name = self._clean(self.firstAttr('title', 'name', 'username', 'product', 'tag', 'value'))
-        return '<%s>' % ':'.join([p for p in [self.__class__.__name__, uid, name] if p])
+        return f"<{':'.join([p for p in [self.__class__.__name__, uid, name] if p])}>"
 
     def __setattr__(self, attr, value):
-        # Don't overwrite session specific attr with []
-        if attr in _DONT_OVERWRITE_SESSION_KEYS and value == []:
-            value = getattr(self, attr, [])
-
         overwriteNone = self.__dict__.get('_overwriteNone')
         # Don't overwrite an attr with None unless it's a private variable or overwrite None is True
         if value is not None or attr.startswith('_') or attr not in self.__dict__ or overwriteNone:
@@ -89,12 +84,14 @@ class PlexObject:
             return cls(self._server, elem, initpath, parent=self)
         # cls is not specified, try looking it up in PLEXOBJECTS
         etype = elem.attrib.get('streamType', elem.attrib.get('tagType', elem.attrib.get('type')))
-        ehash = '%s.%s' % (elem.tag, etype) if etype else elem.tag
+        ehash = f'{elem.tag}.{etype}' if etype else elem.tag
+        if initpath == '/status/sessions':
+            ehash = f"{ehash}.{'session'}"
         ecls = utils.PLEXOBJECTS.get(ehash, utils.PLEXOBJECTS.get(elem.tag))
         # log.debug('Building %s as %s', elem.tag, ecls.__name__)
         if ecls is not None:
             return ecls(self._server, elem, initpath)
-        raise UnknownType("Unknown library type <%s type='%s'../>" % (elem.tag, etype))
+        raise UnknownType(f"Unknown library type <{elem.tag} type='{etype}'../>")
 
     def _buildItemOrNone(self, elem, cls=None, initpath=None):
         """ Calls :func:`~plexapi.base.PlexObject._buildItem` but returns
@@ -170,17 +167,19 @@ class PlexObject:
         if ekey is None:
             raise BadRequest('ekey was not provided')
         if isinstance(ekey, int):
-            ekey = '/library/metadata/%s' % ekey
+            ekey = f'/library/metadata/{ekey}'
+
         data = self._server.query(ekey)
-        librarySectionID = utils.cast(int, data.attrib.get('librarySectionID'))
-        for elem in data:
-            if self._checkAttrs(elem, **kwargs):
-                item = self._buildItem(elem, cls, ekey)
-                if librarySectionID:
-                    item.librarySectionID = librarySectionID
-                return item
+        item = self.findItem(data, cls, ekey, **kwargs)
+
+        if item:
+            librarySectionID = utils.cast(int, data.attrib.get('librarySectionID'))
+            if librarySectionID:
+                item.librarySectionID = librarySectionID
+            return item
+
         clsname = cls.__name__ if cls else 'None'
-        raise NotFound('Unable to find elem: cls=%s, attrs=%s' % (clsname, kwargs))
+        raise NotFound(f'Unable to find elem: cls={clsname}, attrs={kwargs}')
 
     def fetchItems(self, ekey, cls=None, container_start=None, container_size=None, **kwargs):
         """ Load the specified key to find and build all items with the specified tag
@@ -256,15 +255,16 @@ class PlexObject:
                     fetchItem(ekey, Media__Part__file__startswith="D:\\Movies")
 
         """
-        url_kw = {}
-        if container_start is not None:
-            url_kw["X-Plex-Container-Start"] = container_start
-        if container_size is not None:
-            url_kw["X-Plex-Container-Size"] = container_size
-
         if ekey is None:
             raise BadRequest('ekey was not provided')
-        data = self._server.query(ekey, params=url_kw)
+
+        params = {}
+        if container_start is not None:
+            params["X-Plex-Container-Start"] = container_start
+        if container_size is not None:
+            params["X-Plex-Container-Size"] = container_size
+
+        data = self._server.query(ekey, params=params)
         items = self.findItems(data, cls, ekey, **kwargs)
 
         librarySectionID = utils.cast(int, data.attrib.get('librarySectionID'))
@@ -273,6 +273,25 @@ class PlexObject:
                 item.librarySectionID = librarySectionID
         return items
 
+    def findItem(self, data, cls=None, initpath=None, rtag=None, **kwargs):
+        """ Load the specified data to find and build the first items with the specified tag
+            and attrs. See :func:`~plexapi.base.PlexObject.fetchItem` for more details
+            on how this is used.
+        """
+        # filter on cls attrs if specified
+        if cls and cls.TAG and 'tag' not in kwargs:
+            kwargs['etag'] = cls.TAG
+        if cls and cls.TYPE and 'type' not in kwargs:
+            kwargs['type'] = cls.TYPE
+        # rtag to iter on a specific root tag
+        if rtag:
+            data = next(data.iter(rtag), [])
+        # loop through all data elements to find matches
+        for elem in data:
+            if self._checkAttrs(elem, **kwargs):
+                item = self._buildItemOrNone(elem, cls, initpath)
+                return item
+
     def findItems(self, data, cls=None, initpath=None, rtag=None, **kwargs):
         """ Load the specified data to find and build all items with the specified tag
             and attrs. See :func:`~plexapi.base.PlexObject.fetchItem` for more details
@@ -309,7 +328,7 @@ class PlexObject:
         if rtag:
             data = next(utils.iterXMLBFS(data, rtag), [])
         for elem in data:
-            kwargs['%s__exists' % attr] = True
+            kwargs[f'{attr}__exists'] = True
             if self._checkAttrs(elem, **kwargs):
                 results.append(elem.attrib.get(attr))
         return results
@@ -380,7 +399,7 @@ class PlexObject:
 
     def _getAttrOperator(self, attr):
         for op, operator in OPERATORS.items():
-            if attr.endswith('__%s' % op):
+            if attr.endswith(f'__{op}'):
                 attr = attr.rsplit('__', 1)[0]
                 return attr, op, operator
         # default to exact match
@@ -468,16 +487,16 @@ class PlexPartialObject(PlexObject):
         value = super(PlexPartialObject, self).__getattribute__(attr)
         # Check a few cases where we don't want to reload
         if attr in _DONT_RELOAD_FOR_KEYS: return value
-        if attr in _DONT_OVERWRITE_SESSION_KEYS: return value
         if attr in USER_DONT_RELOAD_FOR_KEYS: return value
         if attr.startswith('_'): return value
         if value not in (None, []): return value
         if self.isFullObject(): return value
+        if isinstance(self, PlexSession): return value
         if self._autoReload is False: return value
         # Log the reload.
         clsname = self.__class__.__name__
         title = self.__dict__.get('title', self.__dict__.get('name'))
-        objname = "%s '%s'" % (clsname, title) if title else clsname
+        objname = f"{clsname} '{title}'" if title else clsname
         log.debug("Reloading %s for attr '%s'", objname, attr)
         # Reload and return the value
         self._reload(_overwriteNone=False)
@@ -502,7 +521,7 @@ class PlexPartialObject(PlexObject):
             * Generate intro video markers: Detects show intros, exposing the
                 'Skip Intro' button in clients.
         """
-        key = '/%s/analyze' % self.key.lstrip('/')
+        key = f"/{self.key.lstrip('/')}/analyze"
         self._server.query(key, method=self._server._session.put)
 
     def isFullObject(self):
@@ -528,8 +547,7 @@ class PlexPartialObject(PlexObject):
         if 'type' not in kwargs:
             kwargs['type'] = utils.searchType(self._searchType)
 
-        part = '/library/sections/%s/all%s' % (self.librarySectionID,
-                                               utils.joinArgs(kwargs))
+        part = f'/library/sections/{self.librarySectionID}/all{utils.joinArgs(kwargs)}'
         self._server.query(part, method=self._server._session.put)
         return self
 
@@ -608,7 +626,7 @@ class PlexPartialObject(PlexObject):
                 the refresh process is interrupted (the Server is turned off, internet
                 connection dies, etc).
         """
-        key = '%s/refresh' % self.key
+        key = f'{self.key}/refresh'
         self._server.query(key, method=self._server._session.put)
 
     def section(self):
@@ -655,12 +673,6 @@ class Playable:
         Albums which are all not playable.
 
         Attributes:
-            sessionKey (int): Active session key.
-            usernames (str): Username of the person playing this item (for active sessions).
-            players (:class:`~plexapi.client.PlexClient`): Client objects playing this item (for active sessions).
-            session (:class:`~plexapi.media.Session`): Session object, for a playing media file.
-            transcodeSessions (:class:`~plexapi.media.TranscodeSession`): Transcode Session object
-                if item is being transcoded (None otherwise).
             viewedAt (datetime): Datetime item was last viewed (history).
             accountID (int): The associated :class:`~plexapi.server.SystemAccount` ID.
             deviceID (int): The associated :class:`~plexapi.server.SystemDevice` ID.
@@ -669,11 +681,6 @@ class Playable:
     """
 
     def _loadData(self, data):
-        self.sessionKey = utils.cast(int, data.attrib.get('sessionKey'))            # session
-        self.usernames = self.listAttrs(data, 'title', etag='User')                 # session
-        self.players = self.findItems(data, etag='Player')                          # session
-        self.transcodeSessions = self.findItems(data, etag='TranscodeSession')      # session
-        self.session = self.findItems(data, etag='Session')                         # session
         self.viewedAt = utils.toDatetime(data.attrib.get('viewedAt'))               # history
         self.accountID = utils.cast(int, data.attrib.get('accountID'))              # history
         self.deviceID = utils.cast(int, data.attrib.get('deviceID'))                # history
@@ -692,7 +699,7 @@ class Playable:
                 :exc:`~plexapi.exceptions.Unsupported`: When the item doesn't support fetching a stream URL.
         """
         if self.TYPE not in ('movie', 'episode', 'track', 'clip'):
-            raise Unsupported('Fetching stream URL for %s is unsupported.' % self.TYPE)
+            raise Unsupported(f'Fetching stream URL for {self.TYPE} is unsupported.')
         mvb = params.get('maxVideoBitrate')
         vr = params.get('videoResolution', '')
         params = {
@@ -710,8 +717,10 @@ class Playable:
         streamtype = 'audio' if self.TYPE in ('track', 'album') else 'video'
         # sort the keys since the randomness fucks with my tests..
         sorted_params = sorted(params.items(), key=lambda val: val[0])
-        return self._server.url('/%s/:/transcode/universal/start.m3u8?%s' %
-            (streamtype, urlencode(sorted_params)), includeToken=True)
+        return self._server.url(
+            f'/{streamtype}/:/transcode/universal/start.m3u8?{urlencode(sorted_params)}',
+            includeToken=True
+        )
 
     def iterParts(self):
         """ Iterates over the parts of this media item. """
@@ -751,7 +760,7 @@ class Playable:
 
         for part in parts:
             if not keep_original_name:
-                filename = utils.cleanFilename('%s.%s' % (self._prettyfilename(), part.container))
+                filename = utils.cleanFilename(f'{self._prettyfilename()}.{part.container}')
             else:
                 filename = part.file
 
@@ -759,7 +768,7 @@ class Playable:
                 # So this seems to be a a lot slower but allows transcode.
                 download_url = self.getStreamURL(**kwargs)
             else:
-                download_url = self._server.url('%s?download=1' % part.key)
+                download_url = self._server.url(f'{part.key}?download=1')
 
             filepath = utils.download(
                 download_url,
@@ -774,24 +783,19 @@ class Playable:
 
         return filepaths
 
-    def stop(self, reason=''):
-        """ Stop playback for a media item. """
-        key = '/status/sessions/terminate?sessionId=%s&reason=%s' % (self.session[0].id, quote_plus(reason))
-        return self._server.query(key)
-
     def updateProgress(self, time, state='stopped'):
         """ Set the watched progress for this video.
 
-        Note that setting the time to 0 will not work.
-        Use `markWatched` or `markUnwatched` to achieve
-        that goal.
+            Note that setting the time to 0 will not work.
+            Use :func:`~plexapi.mixins.PlayedMixin.markPlayed` or
+            :func:`~plexapi.mixins.PlayedMixin.markUnplayed` to achieve
+            that goal.
 
             Parameters:
                 time (int): milliseconds watched
                 state (string): state of the video, default 'stopped'
         """
-        key = '/:/progress?key=%s&identifier=com.plexapp.plugins.library&time=%d&state=%s' % (self.ratingKey,
-                                                                                              time, state)
+        key = f'/:/progress?key={self.ratingKey}&identifier=com.plexapp.plugins.library&time={time}&state={state}'
         self._server.query(key)
         self._reload(_overwriteNone=False)
 
@@ -808,12 +812,94 @@ class Playable:
             durationStr = durationStr + str(duration)
         else:
             durationStr = durationStr + str(self.duration)
-        key = '/:/timeline?ratingKey=%s&key=%s&identifier=com.plexapp.plugins.library&time=%d&state=%s%s'
-        key %= (self.ratingKey, self.key, time, state, durationStr)
+        key = (f'/:/timeline?ratingKey={self.ratingKey}&key={self.key}&'
+               f'identifier=com.plexapp.plugins.library&time={int(time)}&state={state}{durationStr}')
         self._server.query(key)
         self._reload(_overwriteNone=False)
 
 
+class PlexSession(object):
+    """ This is a general place to store functions specific to media that is a Plex Session.
+
+        Attributes:
+            live (bool): True if this is a live tv session.
+            player (:class:`~plexapi.client.PlexClient`): PlexClient object for the session.
+            session (:class:`~plexapi.media.Session`): Session object for the session
+                if the session is using bandwidth (None otherwise).
+            sessionKey (int): The session key for the session.
+            transcodeSession (:class:`~plexapi.media.TranscodeSession`): TranscodeSession object
+                if item is being transcoded (None otherwise).
+    """
+
+    def _loadData(self, data):
+        self.live = utils.cast(bool, data.attrib.get('live', '0'))
+        self.player = self.findItem(data, etag='Player')
+        self.session = self.findItem(data, etag='Session')
+        self.sessionKey = utils.cast(int, data.attrib.get('sessionKey'))
+        self.transcodeSession = self.findItem(data, etag='TranscodeSession')
+
+        user = data.find('User')
+        self._username = user.attrib.get('title')
+        self._userId = utils.cast(int, user.attrib.get('id'))
+        self._user = None  # Cache for user object
+
+        # For backwards compatibility
+        self.players = [self.player] if self.player else []
+        self.sessions = [self.session] if self.session else []
+        self.transcodeSessions = [self.transcodeSession] if self.transcodeSession else []
+        self.usernames = [self._username] if self._username else []
+
+    @property
+    def user(self):
+        """ Returns the :class:`~plexapi.myplex.MyPlexAccount` object (for admin)
+            or :class:`~plexapi.myplex.MyPlexUser` object (for users) for this session.
+        """
+        if self._user is None:
+            myPlexAccount = self._server.myPlexAccount()
+            if self._userId == 1:
+                self._user = myPlexAccount
+            else:
+                self._user = myPlexAccount.user(self._username)
+        return self._user
+
+    def reload(self):
+        """ Reload the data for the session.
+            Note: This will return the object as-is if the session is no longer active.
+        """
+        return self._reload()
+
+    def _reload(self, _autoReload=False, **kwargs):
+        """ Perform the actual reload. """
+        # Do not auto reload sessions
+        if _autoReload:
+            return self
+
+        key = self._initpath
+        data = self._server.query(key)
+        for elem in data:
+            if elem.attrib.get('sessionKey') == str(self.sessionKey):
+                self._loadData(elem)
+                break
+        return self
+
+    def source(self):
+        """ Return the source media object for the session. """
+        return self.fetchItem(self._details_key)
+
+    def stop(self, reason=''):
+        """ Stop playback for the session.
+        
+            Parameters:
+                reason (str): Message displayed to the user for stopping playback.
+        """
+        params = {
+            'sessionId': self.session.id,
+            'reason': reason,
+        }
+        key = '/status/sessions/terminate'
+        return self._server.query(key, params=params)
+
+
 class MediaContainer(PlexObject):
     """ Represents a single MediaContainer.
 
diff --git a/lib/plexapi/client.py b/lib/plexapi/client.py
index cc976a58..b23518ad 100644
--- a/lib/plexapi/client.py
+++ b/lib/plexapi/client.py
@@ -94,7 +94,7 @@ class PlexClient(PlexObject):
         self._initpath = self.key
         data = self.query(self.key, timeout=timeout)
         if not data:
-            raise NotFound("Client not found at %s" % self._baseurl)
+            raise NotFound(f"Client not found at {self._baseurl}")
         if self._clientIdentifier:
             client = next(
                 (
@@ -106,8 +106,7 @@ class PlexClient(PlexObject):
             )
             if client is None:
                 raise NotFound(
-                    "Client with identifier %s not found at %s"
-                    % (self._clientIdentifier, self._baseurl)
+                    f"Client with identifier {self._clientIdentifier} not found at {self._baseurl}"
                 )
         else:
             client = data[0]
@@ -136,12 +135,15 @@ class PlexClient(PlexObject):
         # Add this in next breaking release.
         # if self._initpath == 'status/sessions':
         self.device = data.attrib.get('device')         # session
+        self.profile = data.attrib.get('profile')       # session
         self.model = data.attrib.get('model')           # session
         self.state = data.attrib.get('state')           # session
         self.vendor = data.attrib.get('vendor')         # session
         self.version = data.attrib.get('version')       # session
-        self.local = utils.cast(bool, data.attrib.get('local', 0))
-        self.address = data.attrib.get('address')        # session
+        self.local = utils.cast(bool, data.attrib.get('local', 0))  # session
+        self.relayed = utils.cast(bool, data.attrib.get('relayed', 0))  # session
+        self.secure = utils.cast(bool, data.attrib.get('secure', 0))  # session
+        self.address = data.attrib.get('address')       # session
         self.remotePublicAddress = data.attrib.get('remotePublicAddress')
         self.userID = data.attrib.get('userID')
 
@@ -183,7 +185,7 @@ class PlexClient(PlexObject):
         if response.status_code not in (200, 201, 204):
             codename = codes.get(response.status_code)[0]
             errtext = response.text.replace('\n', ' ')
-            message = '(%s) %s; %s %s' % (response.status_code, codename, response.url, errtext)
+            message = f'({response.status_code}) {codename}; {response.url} {errtext}'
             if response.status_code == 401:
                 raise Unauthorized(message)
             elif response.status_code == 404:
@@ -210,8 +212,7 @@ class PlexClient(PlexObject):
         controller = command.split('/')[0]
         headers = {'X-Plex-Target-Client-Identifier': self.machineIdentifier}
         if controller not in self.protocolCapabilities:
-            log.debug("Client %s doesn't support %s controller."
-                      "What your trying might not work" % (self.title, controller))
+            log.debug("Client %s doesn't support %s controller. What your trying might not work", self.title, controller)
 
         proxy = self._proxyThroughServer if proxy is None else proxy
         query = self._server.query if proxy else self.query
@@ -225,7 +226,7 @@ class PlexClient(PlexObject):
             self.sendCommand(ClientTimeline.key, wait=0)
 
         params['commandID'] = self._nextCommandId()
-        key = '/player/%s%s' % (command, utils.joinArgs(params))
+        key = f'/player/{command}{utils.joinArgs(params)}'
 
         try:
             return query(key, headers=headers)
@@ -250,8 +251,8 @@ class PlexClient(PlexObject):
             raise BadRequest('PlexClient object missing baseurl.')
         if self._token and (includeToken or self._showSecrets):
             delim = '&' if '?' in key else '?'
-            return '%s%s%sX-Plex-Token=%s' % (self._baseurl, key, delim, self._token)
-        return '%s%s' % (self._baseurl, key)
+            return f'{self._baseurl}{key}{delim}X-Plex-Token={self._token}'
+        return f'{self._baseurl}{key}'
 
     # ---------------------
     # Navigation Commands
@@ -514,7 +515,7 @@ class PlexClient(PlexObject):
             'offset': offset,
             'key': media.key or playqueue.selectedItem.key,
             'type': mediatype,
-            'containerKey': '/playQueues/%s?window=100&own=1' % playqueue.playQueueID,
+            'containerKey': f'/playQueues/{playqueue.playQueueID}?window=100&own=1',
             **params,
         }
         token = media._server.createToken()
@@ -620,7 +621,7 @@ class ClientTimeline(PlexObject):
         self.protocol = data.attrib.get('protocol')
         self.providerIdentifier = data.attrib.get('providerIdentifier')
         self.ratingKey = utils.cast(int, data.attrib.get('ratingKey'))
-        self.repeat = utils.cast(bool, data.attrib.get('repeat'))
+        self.repeat = utils.cast(int, data.attrib.get('repeat'))
         self.seekRange = data.attrib.get('seekRange')
         self.shuffle = utils.cast(bool, data.attrib.get('shuffle'))
         self.state = data.attrib.get('state')
diff --git a/lib/plexapi/collection.py b/lib/plexapi/collection.py
index 44f1e1f7..ff26cf32 100644
--- a/lib/plexapi/collection.py
+++ b/lib/plexapi/collection.py
@@ -4,7 +4,7 @@ from urllib.parse import quote_plus
 from plexapi import media, utils
 from plexapi.base import PlexPartialObject
 from plexapi.exceptions import BadRequest, NotFound, Unsupported
-from plexapi.library import LibrarySection
+from plexapi.library import LibrarySection, ManagedHub
 from plexapi.mixins import (
     AdvancedSettingsMixin, SmartFilterMixin, HubsMixin, RatingMixin,
     ArtMixin, PosterMixin, ThemeMixin,
@@ -184,16 +184,28 @@ class Collection(
         for item in self.items():
             if item.title.lower() == title.lower():
                 return item
-        raise NotFound('Item with title "%s" not found in the collection' % title)
+        raise NotFound(f'Item with title "{title}" not found in the collection')
 
     def items(self):
         """ Returns a list of all items in the collection. """
         if self._items is None:
-            key = '%s/children' % self.key
+            key = f'{self.key}/children'
             items = self.fetchItems(key)
             self._items = items
         return self._items
 
+    def visibility(self):
+        """ Returns the :class:`~plexapi.library.ManagedHub` for this collection. """
+        key = f'/hubs/sections/{self.librarySectionID}/manage?metadataItemId={self.ratingKey}'
+        data = self._server.query(key)
+        hub = self.findItem(data, cls=ManagedHub)
+        if hub is None:
+            hub = ManagedHub(self._server, data, parent=self)
+            hub.identifier = f'custom.collection.{self.librarySectionID}.{self.ratingKey}'
+            hub.title = self.title
+            hub._promoted = False
+        return hub
+
     def get(self, title):
         """ Alias to :func:`~plexapi.library.Collection.item`. """
         return self.item(title)
@@ -221,8 +233,8 @@ class Collection(
         }
         key = user_dict.get(user)
         if key is None:
-            raise BadRequest('Unknown collection filtering user: %s. Options %s' % (user, list(user_dict)))
-        self.editAdvanced(collectionFilterBasedOnUser=key)
+            raise BadRequest(f'Unknown collection filtering user: {user}. Options {list(user_dict)}')
+        return self.editAdvanced(collectionFilterBasedOnUser=key)
 
     def modeUpdate(self, mode=None):
         """ Update the collection mode advanced setting.
@@ -248,8 +260,8 @@ class Collection(
         }
         key = mode_dict.get(mode)
         if key is None:
-            raise BadRequest('Unknown collection mode: %s. Options %s' % (mode, list(mode_dict)))
-        self.editAdvanced(collectionMode=key)
+            raise BadRequest(f'Unknown collection mode: {mode}. Options {list(mode_dict)}')
+        return self.editAdvanced(collectionMode=key)
 
     def sortUpdate(self, sort=None):
         """ Update the collection order advanced setting.
@@ -276,8 +288,8 @@ class Collection(
         }
         key = sort_dict.get(sort)
         if key is None:
-            raise BadRequest('Unknown sort dir: %s. Options: %s' % (sort, list(sort_dict)))
-        self.editAdvanced(collectionSort=key)
+            raise BadRequest(f'Unknown sort dir: {sort}. Options: {list(sort_dict)}')
+        return self.editAdvanced(collectionSort=key)
 
     def addItems(self, items):
         """ Add items to the collection.
@@ -298,17 +310,16 @@ class Collection(
         ratingKeys = []
         for item in items:
             if item.type != self.subtype:  # pragma: no cover
-                raise BadRequest('Can not mix media types when building a collection: %s and %s' %
-                    (self.subtype, item.type))
+                raise BadRequest(f'Can not mix media types when building a collection: {self.subtype} and {item.type}')
             ratingKeys.append(str(item.ratingKey))
 
         ratingKeys = ','.join(ratingKeys)
-        uri = '%s/library/metadata/%s' % (self._server._uriRoot(), ratingKeys)
+        uri = f'{self._server._uriRoot()}/library/metadata/{ratingKeys}'
 
-        key = '%s/items%s' % (self.key, utils.joinArgs({
-            'uri': uri
-        }))
+        args = {'uri': uri}
+        key = f"{self.key}/items{utils.joinArgs(args)}"
         self._server.query(key, method=self._server._session.put)
+        return self
 
     def removeItems(self, items):
         """ Remove items from the collection.
@@ -327,17 +338,18 @@ class Collection(
             items = [items]
 
         for item in items:
-            key = '%s/items/%s' % (self.key, item.ratingKey)
+            key = f'{self.key}/items/{item.ratingKey}'
             self._server.query(key, method=self._server._session.delete)
+        return self
 
     def moveItem(self, item, after=None):
         """ Move an item to a new position in the collection.
 
             Parameters:
-                items (obj): :class:`~plexapi.audio.Audio`, :class:`~plexapi.video.Video`,
-                    or :class:`~plexapi.photo.Photo` objects to be moved in the collection.
+                item (obj): :class:`~plexapi.audio.Audio`, :class:`~plexapi.video.Video`,
+                    or :class:`~plexapi.photo.Photo` object to be moved in the collection.
                 after (obj): :class:`~plexapi.audio.Audio`, :class:`~plexapi.video.Video`,
-                    or :class:`~plexapi.photo.Photo` objects to move the item after in the collection.
+                    or :class:`~plexapi.photo.Photo` object to move the item after in the collection.
 
             Raises:
                 :class:`plexapi.exceptions.BadRequest`: When trying to move items in a smart collection.
@@ -345,12 +357,13 @@ class Collection(
         if self.smart:
             raise BadRequest('Cannot move items in a smart collection.')
 
-        key = '%s/items/%s/move' % (self.key, item.ratingKey)
+        key = f'{self.key}/items/{item.ratingKey}/move'
 
         if after:
-            key += '?after=%s' % after.ratingKey
+            key += f'?after={after.ratingKey}'
 
         self._server.query(key, method=self._server._session.put)
+        return self
 
     def updateFilters(self, libtype=None, limit=None, sort=None, filters=None, **kwargs):
         """ Update the filters for a smart collection.
@@ -376,12 +389,12 @@ class Collection(
         section = self.section()
         searchKey = section._buildSearchKey(
             sort=sort, libtype=libtype, limit=limit, filters=filters, **kwargs)
-        uri = '%s%s' % (self._server._uriRoot(), searchKey)
+        uri = f'{self._server._uriRoot()}{searchKey}'
 
-        key = '%s/items%s' % (self.key, utils.joinArgs({
-            'uri': uri
-        }))
+        args = {'uri': uri}
+        key = f"{self.key}/items{utils.joinArgs(args)}"
         self._server.query(key, method=self._server._session.put)
+        return self
 
     @deprecated('use editTitle, editSortTitle, editContentRating, and editSummary instead')
     def edit(self, title=None, titleSort=None, contentRating=None, summary=None, **kwargs):
@@ -438,15 +451,10 @@ class Collection(
             ratingKeys.append(str(item.ratingKey))
 
         ratingKeys = ','.join(ratingKeys)
-        uri = '%s/library/metadata/%s' % (server._uriRoot(), ratingKeys)
+        uri = f'{server._uriRoot()}/library/metadata/{ratingKeys}'
 
-        key = '/library/collections%s' % utils.joinArgs({
-            'uri': uri,
-            'type': utils.searchType(itemType),
-            'title': title,
-            'smart': 0,
-            'sectionId': section.key
-        })
+        args = {'uri': uri, 'type': utils.searchType(itemType), 'title': title, 'smart': 0, 'sectionId': section.key}
+        key = f"/library/collections{utils.joinArgs(args)}"
         data = server.query(key, method=server._session.post)[0]
         return cls(server, data, initpath=key)
 
@@ -460,15 +468,10 @@ class Collection(
 
         searchKey = section._buildSearchKey(
             sort=sort, libtype=libtype, limit=limit, filters=filters, **kwargs)
-        uri = '%s%s' % (server._uriRoot(), searchKey)
+        uri = f'{server._uriRoot()}{searchKey}'
 
-        key = '/library/collections%s' % utils.joinArgs({
-            'uri': uri,
-            'type': utils.searchType(libtype),
-            'title': title,
-            'smart': 1,
-            'sectionId': section.key
-        })
+        args = {'uri': uri, 'type': utils.searchType(libtype), 'title': title, 'smart': 1, 'sectionId': section.key}
+        key = f"/library/collections{utils.joinArgs(args)}"
         data = server.query(key, method=server._session.post)[0]
         return cls(server, data, initpath=key)
 
@@ -547,9 +550,8 @@ class Collection(
         sync_item.metadataType = self.metadataType
         sync_item.machineIdentifier = self._server.machineIdentifier
 
-        sync_item.location = 'library:///directory/%s' % quote_plus(
-            '%s/children?excludeAllLeaves=1' % (self.key)
-        )
+        key = quote_plus(f'{self.key}/children?excludeAllLeaves=1')
+        sync_item.location = f'library:///directory/{key}'
         sync_item.policy = Policy.create(limit, unwatched)
 
         if self.isVideo:
diff --git a/lib/plexapi/config.py b/lib/plexapi/config.py
index 77bb8953..3b93f869 100644
--- a/lib/plexapi/config.py
+++ b/lib/plexapi/config.py
@@ -29,7 +29,7 @@ class PlexConfig(ConfigParser):
         """
         try:
             # First: check environment variable is set
-            envkey = 'PLEXAPI_%s' % key.upper().replace('.', '_')
+            envkey = f"PLEXAPI_{key.upper().replace('.', '_')}"
             value = os.environ.get(envkey)
             if value is None:
                 # Second: check the config file has attr
diff --git a/lib/plexapi/const.py b/lib/plexapi/const.py
index 250389fb..8ac71b57 100644
--- a/lib/plexapi/const.py
+++ b/lib/plexapi/const.py
@@ -3,7 +3,7 @@
 
 # Library version
 MAJOR_VERSION = 4
-MINOR_VERSION = 11
-PATCH_VERSION = 2
+MINOR_VERSION = 13
+PATCH_VERSION = 1
 __short_version__ = f"{MAJOR_VERSION}.{MINOR_VERSION}"
 __version__ = f"{__short_version__}.{PATCH_VERSION}"
diff --git a/lib/plexapi/library.py b/lib/plexapi/library.py
index 41892ef9..647a89f0 100644
--- a/lib/plexapi/library.py
+++ b/lib/plexapi/library.py
@@ -1,7 +1,7 @@
 # -*- coding: utf-8 -*-
 import re
 from datetime import datetime
-from urllib.parse import quote, quote_plus, urlencode
+from urllib.parse import quote_plus, urlencode
 
 from plexapi import X_PLEX_CONTAINER_SIZE, log, media, utils
 from plexapi.base import OPERATORS, PlexObject
@@ -65,7 +65,7 @@ class Library(PlexObject):
         try:
             return self._sectionsByTitle[normalized_title]
         except KeyError:
-            raise NotFound('Invalid library section: %s' % title) from None
+            raise NotFound(f'Invalid library section: {title}') from None
 
     def sectionByID(self, sectionID):
         """ Returns the :class:`~plexapi.library.LibrarySection` that matches the specified sectionID.
@@ -81,7 +81,7 @@ class Library(PlexObject):
         try:
             return self._sectionsByID[sectionID]
         except KeyError:
-            raise NotFound('Invalid library sectionID: %s' % sectionID) from None
+            raise NotFound(f'Invalid library sectionID: {sectionID}') from None
 
     def hubs(self, sectionID=None, identifier=None, **kwargs):
         """ Returns a list of :class:`~plexapi.library.Hub` across all library sections.
@@ -102,7 +102,7 @@ class Library(PlexObject):
             if not isinstance(identifier, list):
                 identifier = [identifier]
             kwargs['identifier'] = ",".join(identifier)
-        key = '/hubs%s' % utils.joinArgs(kwargs)
+        key = f'/hubs{utils.joinArgs(kwargs)}'
         return self.fetchItems(key)
 
     def all(self, **kwargs):
@@ -139,7 +139,7 @@ class Library(PlexObject):
             args['type'] = utils.searchType(libtype)
         for attr, value in kwargs.items():
             args[attr] = value
-        key = '/library/all%s' % utils.joinArgs(args)
+        key = f'/library/all{utils.joinArgs(args)}'
         return self.fetchItems(key)
 
     def cleanBundles(self):
@@ -150,11 +150,13 @@ class Library(PlexObject):
         """
         # TODO: Should this check the response for success or the correct mediaprefix?
         self._server.query('/library/clean/bundles?async=1', method=self._server._session.put)
+        return self
 
     def emptyTrash(self):
         """ If a library has items in the Library Trash, use this option to empty the Trash. """
         for section in self.sections():
             section.emptyTrash()
+        return self
 
     def optimize(self):
         """ The Optimize option cleans up the server database from unused or fragmented data.
@@ -162,21 +164,25 @@ class Library(PlexObject):
             library, you may like to optimize the database.
         """
         self._server.query('/library/optimize?async=1', method=self._server._session.put)
+        return self
 
     def update(self):
         """ Scan this library for new items."""
         self._server.query('/library/sections/all/refresh')
+        return self
 
     def cancelUpdate(self):
         """ Cancel a library update. """
         key = '/library/sections/all/refresh'
         self._server.query(key, method=self._server._session.delete)
+        return self
 
     def refresh(self):
         """ Forces a download of fresh media information from the internet.
             This can take a long time. Any locked fields are not modified.
         """
         self._server.query('/library/sections/all/refresh?force=1')
+        return self
 
     def deleteMediaPreviews(self):
         """ Delete the preview thumbnails for the all sections. This cannot be
@@ -184,6 +190,7 @@ class Library(PlexObject):
         """
         for section in self.sections():
             section.deleteMediaPreviews()
+        return self
 
     def add(self, name='', type='', agent='', scanner='', location='', language='en', *args, **kwargs):
         """ Simplified add for the most common options.
@@ -336,11 +343,11 @@ class Library(PlexObject):
         locations = []
         for path in location:
             if not self._server.isBrowsable(path):
-                raise BadRequest('Path: %s does not exist.' % path)
+                raise BadRequest(f'Path: {path} does not exist.')
             locations.append(('location', path))
 
-        part = '/library/sections?name=%s&type=%s&agent=%s&scanner=%s&language=%s&%s' % (
-            quote_plus(name), type, agent, quote_plus(scanner), language, urlencode(locations, doseq=True)) # noqa E126
+        part = (f'/library/sections?name={quote_plus(name)}&type={type}&agent={agent}'
+                f'&scanner={quote_plus(scanner)}&language={language}&{urlencode(locations, doseq=True)}')
         if kwargs:
             part += urlencode(kwargs)
         return self._server.query(part, method=self._server._session.post)
@@ -356,6 +363,16 @@ class Library(PlexObject):
             hist.extend(section.history(maxresults=maxresults, mindate=mindate))
         return hist
 
+    def tags(self, tag):
+        """ Returns a list of :class:`~plexapi.library.LibraryMediaTag` objects for the specified tag.
+
+            Parameters:
+                tag (str): Tag name (see :data:`~plexapi.utils.TAGTYPES`).
+        """
+        tagType = utils.tagType(tag)
+        data = self._server.query(f'/library/tags?type={tagType}')
+        return self.findItems(data)
+
 
 class LibrarySection(PlexObject):
     """ Base class for a single library section.
@@ -466,8 +483,8 @@ class LibrarySection(PlexObject):
         xpath = (
             './MediaProvider[@identifier="com.plexapp.plugins.library"]'
             '/Feature[@type="content"]'
-            '/Directory[@id="%s"]'
-        ) % self.key
+            f'/Directory[@id="{self.key}"]'
+        )
         directory = next(iter(data.findall(xpath)), None)
         if directory:
             self._totalDuration = utils.cast(int, directory.attrib.get('durationTotal'))
@@ -495,16 +512,16 @@ class LibrarySection(PlexObject):
                 args['clusterZoomLevel'] = 1
             else:
                 args['type'] = utils.searchType(libtype)
-        part = '/library/sections/%s/all%s' % (self.key, utils.joinArgs(args))
+        part = f'/library/sections/{self.key}/all{utils.joinArgs(args)}'
         data = self._server.query(part)
         return utils.cast(int, data.attrib.get("totalSize"))
 
     def delete(self):
         """ Delete a library section. """
         try:
-            return self._server.query('/library/sections/%s' % self.key, method=self._server._session.delete)
+            return self._server.query(f'/library/sections/{self.key}', method=self._server._session.delete)
         except BadRequest:  # pragma: no cover
-            msg = 'Failed to delete library %s' % self.key
+            msg = f'Failed to delete library {self.key}'
             msg += 'You may need to allow this permission in your Plex settings.'
             log.error(msg)
             raise
@@ -532,13 +549,14 @@ class LibrarySection(PlexObject):
                 kwargs['location'] = [kwargs['location']]
             for path in kwargs.pop('location'):
                 if not self._server.isBrowsable(path):
-                    raise BadRequest('Path: %s does not exist.' % path)
+                    raise BadRequest(f'Path: {path} does not exist.')
                 locations.append(('location', path))
 
         params = list(kwargs.items()) + locations
 
-        part = '/library/sections/%s?agent=%s&%s' % (self.key, agent, urlencode(params, doseq=True))
+        part = f'/library/sections/{self.key}?agent={agent}&{urlencode(params, doseq=True)}'
         self._server.query(part, method=self._server._session.put)
+        return self
 
     def addLocations(self, location):
         """ Add a location to a library.
@@ -558,9 +576,9 @@ class LibrarySection(PlexObject):
             location = [location]
         for path in location:
             if not self._server.isBrowsable(path):
-                raise BadRequest('Path: %s does not exist.' % path)
+                raise BadRequest(f'Path: {path} does not exist.')
             locations.append(path)
-        self.edit(location=locations)
+        return self.edit(location=locations)
 
     def removeLocations(self, location):
         """ Remove a location from a library.
@@ -582,10 +600,10 @@ class LibrarySection(PlexObject):
             if path in locations:
                 locations.remove(path)
             else:
-                raise BadRequest('Path: %s does not exist in the library.' % location)
+                raise BadRequest(f'Path: {location} does not exist in the library.')
         if len(locations) == 0:
             raise BadRequest('You are unable to remove all locations from a library.')
-        self.edit(location=locations)
+        return self.edit(location=locations)
 
     def get(self, title):
         """ Returns the media item with the specified title.
@@ -596,8 +614,10 @@ class LibrarySection(PlexObject):
             Raises:
                 :exc:`~plexapi.exceptions.NotFound`: The title is not found in the library.
         """
-        key = '/library/sections/%s/all?includeGuids=1&title=%s' % (self.key, quote(title, safe=''))
-        return self.fetchItem(key, title__iexact=title)
+        try:
+            return self.search(title)[0]
+        except IndexError:
+            raise NotFound(f"Unable to find item '{title}'") from None
 
     def getGuid(self, guid):
         """ Returns the media item with the specified external Plex, IMDB, TMDB, or TVDB ID.
@@ -642,7 +662,7 @@ class LibrarySection(PlexObject):
                 match = dummy.matches(agent=self.agent, title=guid.replace('://', '-'))
                 return self.search(guid=match[0].guid)[0]
         except IndexError:
-            raise NotFound("Guid '%s' is not found in the library" % guid) from None
+            raise NotFound(f"Guid '{guid}' is not found in the library") from None
 
     def all(self, libtype=None, **kwargs):
         """ Returns a list of all items from this library section.
@@ -654,13 +674,25 @@ class LibrarySection(PlexObject):
     def folders(self):
         """ Returns a list of available :class:`~plexapi.library.Folder` for this library section.
         """
-        key = '/library/sections/%s/folder' % self.key
+        key = f'/library/sections/{self.key}/folder'
         return self.fetchItems(key, Folder)
 
+    def managedHubs(self):
+        """ Returns a list of available :class:`~plexapi.library.ManagedHub` for this library section.
+        """
+        key = f'/hubs/sections/{self.key}/manage'
+        return self.fetchItems(key, ManagedHub)
+
+    def resetManagedHubs(self):
+        """ Reset the managed hub customizations for this library section.
+        """
+        key = f'/hubs/sections/{self.key}/manage'
+        self._server.query(key, method=self._server._session.delete)
+
     def hubs(self):
         """ Returns a list of available :class:`~plexapi.library.Hub` for this library section.
         """
-        key = '/hubs/sections/%s?includeStations=1' % self.key
+        key = f'/hubs/sections/{self.key}?includeStations=1'
         return self.fetchItems(key)
 
     def agents(self):
@@ -670,7 +702,7 @@ class LibrarySection(PlexObject):
 
     def settings(self):
         """ Returns a list of all library settings. """
-        key = '/library/sections/%s/prefs' % self.key
+        key = f'/library/sections/{self.key}/prefs'
         data = self._server.query(key)
         return self.findItems(data, cls=Setting)
 
@@ -678,7 +710,7 @@ class LibrarySection(PlexObject):
         """ Edit a library's advanced settings. """
         data = {}
         idEnums = {}
-        key = 'prefs[%s]'
+        key = 'prefs[{}]'
 
         for setting in self.settings():
             if setting.type != 'bool':
@@ -690,35 +722,36 @@ class LibrarySection(PlexObject):
             try:
                 enums = idEnums[settingID]
             except KeyError:
-                raise NotFound('%s not found in %s' % (value, list(idEnums.keys())))
+                raise NotFound(f'{value} not found in {list(idEnums.keys())}')
             if value in enums:
-                data[key % settingID] = value
+                data[key.format(settingID)] = value
             else:
-                raise NotFound('%s not found in %s' % (value, enums))
+                raise NotFound(f'{value} not found in {enums}')
 
-        self.edit(**data)
+        return self.edit(**data)
 
     def defaultAdvanced(self):
         """ Edit all of library's advanced settings to default. """
         data = {}
-        key = 'prefs[%s]'
+        key = 'prefs[{}]'
         for setting in self.settings():
             if setting.type == 'bool':
-                data[key % setting.id] = int(setting.default)
+                data[key.format(setting.id)] = int(setting.default)
             else:
-                data[key % setting.id] = setting.default
+                data[key.format(setting.id)] = setting.default
 
-        self.edit(**data)
+        return self.edit(**data)
 
     def _lockUnlockAllField(self, field, libtype=None, locked=True):
         """ Lock or unlock a field for all items in the library. """
         libtype = libtype or self.TYPE
         args = {
             'type': utils.searchType(libtype),
-            '%s.locked' % field: int(locked)
+            f'{field}.locked': int(locked)
         }
-        key = '/library/sections/%s/all%s' % (self.key, utils.joinArgs(args))
+        key = f'/library/sections/{self.key}/all{utils.joinArgs(args)}'
         self._server.query(key, method=self._server._session.put)
+        return self
 
     def lockAllField(self, field, libtype=None):
         """ Lock a field for all items in the library.
@@ -728,7 +761,7 @@ class LibrarySection(PlexObject):
                 libtype (str, optional): The library type to lock (movie, show, season, episode,
                     artist, album, track, photoalbum, photo). Default is the main library type.
         """
-        self._lockUnlockAllField(field, libtype=libtype, locked=True)
+        return self._lockUnlockAllField(field, libtype=libtype, locked=True)
 
     def unlockAllField(self, field, libtype=None):
         """ Unlock a field for all items in the library.
@@ -738,17 +771,17 @@ class LibrarySection(PlexObject):
                 libtype (str, optional): The library type to lock (movie, show, season, episode,
                     artist, album, track, photoalbum, photo). Default is the main library type.
         """
-        self._lockUnlockAllField(field, libtype=libtype, locked=False)
+        return self._lockUnlockAllField(field, libtype=libtype, locked=False)
 
     def timeline(self):
         """ Returns a timeline query for this library section. """
-        key = '/library/sections/%s/timeline' % self.key
+        key = f'/library/sections/{self.key}/timeline'
         data = self._server.query(key)
         return LibraryTimeline(self, data)
 
     def onDeck(self):
         """ Returns a list of media items on deck from this library section. """
-        key = '/library/sections/%s/onDeck' % self.key
+        key = f'/library/sections/{self.key}/onDeck'
         return self.fetchItems(key)
 
     def recentlyAdded(self, maxresults=50, libtype=None):
@@ -763,20 +796,22 @@ class LibrarySection(PlexObject):
         return self.search(sort='addedAt:desc', maxresults=maxresults, libtype=libtype)
 
     def firstCharacter(self):
-        key = '/library/sections/%s/firstCharacter' % self.key
+        key = f'/library/sections/{self.key}/firstCharacter'
         return self.fetchItems(key, cls=FirstCharacter)
 
     def analyze(self):
         """ Run an analysis on all of the items in this library section. See
             See :func:`~plexapi.base.PlexPartialObject.analyze` for more details.
         """
-        key = '/library/sections/%s/analyze' % self.key
+        key = f'/library/sections/{self.key}/analyze'
         self._server.query(key, method=self._server._session.put)
+        return self
 
     def emptyTrash(self):
         """ If a section has items in the Trash, use this option to empty the Trash. """
-        key = '/library/sections/%s/emptyTrash' % self.key
+        key = f'/library/sections/{self.key}/emptyTrash'
         self._server.query(key, method=self._server._session.put)
+        return self
 
     def update(self, path=None):
         """ Scan this section for new media.
@@ -784,47 +819,55 @@ class LibrarySection(PlexObject):
             Parameters:
                 path (str, optional): Full path to folder to scan.
         """
-        key = '/library/sections/%s/refresh' % self.key
+        key = f'/library/sections/{self.key}/refresh'
         if path is not None:
-            key += '?path=%s' % quote_plus(path)
+            key += f'?path={quote_plus(path)}'
         self._server.query(key)
+        return self
 
     def cancelUpdate(self):
         """ Cancel update of this Library Section. """
-        key = '/library/sections/%s/refresh' % self.key
+        key = f'/library/sections/{self.key}/refresh'
         self._server.query(key, method=self._server._session.delete)
+        return self
 
     def refresh(self):
         """ Forces a download of fresh media information from the internet.
             This can take a long time. Any locked fields are not modified.
         """
-        key = '/library/sections/%s/refresh?force=1' % self.key
+        key = f'/library/sections/{self.key}/refresh?force=1'
         self._server.query(key)
+        return self
 
     def deleteMediaPreviews(self):
         """ Delete the preview thumbnails for items in this library. This cannot
             be undone. Recreating media preview files can take hours or even days.
         """
-        key = '/library/sections/%s/indexes' % self.key
+        key = f'/library/sections/{self.key}/indexes'
         self._server.query(key, method=self._server._session.delete)
+        return self
 
     def _loadFilters(self):
         """ Retrieves and caches the list of :class:`~plexapi.library.FilteringType` and
             list of :class:`~plexapi.library.FilteringFieldType` for this library section.
         """
-        _key = ('/library/sections/%s/%s?includeMeta=1&includeAdvanced=1'
-               '&X-Plex-Container-Start=0&X-Plex-Container-Size=0')
+        _key = ('/library/sections/{key}/{filter}?includeMeta=1&includeAdvanced=1'
+                '&X-Plex-Container-Start=0&X-Plex-Container-Size=0')
                
-        key = _key % (self.key, 'all')
+        key = _key.format(key=self.key, filter='all')
         data = self._server.query(key)
         self._filterTypes = self.findItems(data, FilteringType, rtag='Meta')
         self._fieldTypes = self.findItems(data, FilteringFieldType, rtag='Meta')
 
         if self.TYPE != 'photo':  # No collections for photo library
-            key = _key % (self.key, 'collections')
+            key = _key.format(key=self.key, filter='collections')
             data = self._server.query(key)
             self._filterTypes.extend(self.findItems(data, FilteringType, rtag='Meta'))
 
+        # Manually add guid field type, only allowing "is" operator
+        guidFieldType = '<FieldType type="guid"><Operator key="=" title="is"/></FieldType>'
+        self._fieldTypes.append(self._manuallyLoadXML(guidFieldType, FilteringFieldType))
+
     def filterTypes(self):
         """ Returns a list of available :class:`~plexapi.library.FilteringType` for this library section. """
         if self._filterTypes is None:
@@ -846,9 +889,8 @@ class LibrarySection(PlexObject):
             return next(f for f in self.filterTypes() if f.type == libtype)
         except StopIteration:
             availableLibtypes = [f.type for f in self.filterTypes()]
-            raise NotFound('Unknown libtype "%s" for this library. '
-                           'Available libtypes: %s'
-                           % (libtype, availableLibtypes)) from None
+            raise NotFound(f'Unknown libtype "{libtype}" for this library. '
+                           f'Available libtypes: {availableLibtypes}') from None
 
     def fieldTypes(self):
         """ Returns a list of available :class:`~plexapi.library.FilteringFieldType` for this library section. """
@@ -870,9 +912,8 @@ class LibrarySection(PlexObject):
             return next(f for f in self.fieldTypes() if f.type == fieldType)
         except StopIteration:
             availableFieldTypes = [f.type for f in self.fieldTypes()]
-            raise NotFound('Unknown field type "%s" for this library. '
-                           'Available field types: %s'
-                           % (fieldType, availableFieldTypes)) from None
+            raise NotFound(f'Unknown field type "{fieldType}" for this library. '
+                           f'Available field types: {availableFieldTypes}') from None
 
     def listFilters(self, libtype=None):
         """ Returns a list of available :class:`~plexapi.library.FilteringFilter` for a specified libtype.
@@ -947,7 +988,7 @@ class LibrarySection(PlexObject):
                     field = 'genre'  # Available filter field from listFields()
                     filterField = next(f for f in library.listFields() if f.key.endswith(field))
                     availableOperators = [o.key for o in library.listOperators(filterField.type)]
-                    print("Available operators for %s:" % field, availableOperators)
+                    print(f"Available operators for {field}:", availableOperators)
 
         """
         return self.getFieldType(fieldType).operators
@@ -974,22 +1015,21 @@ class LibrarySection(PlexObject):
 
                     field = 'genre'  # Available filter field from listFilters()
                     availableChoices = [f.title for f in library.listFilterChoices(field)]
-                    print("Available choices for %s:" % field, availableChoices)
+                    print(f"Available choices for {field}:", availableChoices)
 
         """
         if isinstance(field, str):
             match = re.match(r'(?:([a-zA-Z]*)\.)?([a-zA-Z]+)', field)
             if not match:
-                raise BadRequest('Invalid filter field: %s' % field)
+                raise BadRequest(f'Invalid filter field: {field}')
             _libtype, field = match.groups()
             libtype = _libtype or libtype or self.TYPE
             try:
                 field = next(f for f in self.listFilters(libtype) if f.filter == field)
             except StopIteration:
                 availableFilters = [f.filter for f in self.listFilters(libtype)]
-                raise NotFound('Unknown filter field "%s" for libtype "%s". '
-                               'Available filters: %s'
-                               % (field, libtype, availableFilters)) from None
+                raise NotFound(f'Unknown filter field "{field}" for libtype "{libtype}". '
+                               f'Available filters: {availableFilters}') from None
                 
         data = self._server.query(field.key)
         return self.findItems(data, FilterChoice)
@@ -1000,7 +1040,7 @@ class LibrarySection(PlexObject):
         """
         match = re.match(r'(?:([a-zA-Z]*)\.)?([a-zA-Z]+)([!<>=&]*)', field)
         if not match:
-            raise BadRequest('Invalid filter field: %s' % field)
+            raise BadRequest(f'Invalid filter field: {field}')
         _libtype, field, operator = match.groups()
         libtype = _libtype or libtype or self.TYPE
 
@@ -1014,9 +1054,8 @@ class LibrarySection(PlexObject):
                         break
             else:
                 availableFields = [f.key for f in self.listFields(libtype)]
-                raise NotFound('Unknown filter field "%s" for libtype "%s". '
-                               'Available filter fields: %s'
-                               % (field, libtype, availableFields)) from None
+                raise NotFound(f'Unknown filter field "{field}" for libtype "{libtype}". '
+                               f'Available filter fields: {availableFields}') from None
 
         field = filterField.key
         operator = self._validateFieldOperator(filterField, operator)
@@ -1047,9 +1086,8 @@ class LibrarySection(PlexObject):
             next(o for o in fieldType.operators if o.key == operator)
         except StopIteration:
             availableOperators = [o.key for o in self.listOperators(filterField.type)]
-            raise NotFound('Unknown operator "%s" for filter field "%s". '
-                           'Available operators: %s'
-                           % (operator, filterField.key, availableOperators)) from None
+            raise NotFound(f'Unknown operator "{operator}" for filter field "{filterField.key}". '
+                           f'Available operators: {availableOperators}') from None
 
         return '&=' if and_operator else operator
 
@@ -1077,8 +1115,8 @@ class LibrarySection(PlexObject):
                     value = self._validateFieldValueTag(value, filterField, libtype)
                 results.append(str(value))
         except (ValueError, AttributeError):
-            raise BadRequest('Invalid value "%s" for filter field "%s", value should be type %s'
-                             % (value, filterField.key, fieldType.type)) from None
+            raise BadRequest(f'Invalid value "{value}" for filter field "{filterField.key}", '
+                             f'value should be type {fieldType.type}') from None
     
         return results
 
@@ -1100,7 +1138,7 @@ class LibrarySection(PlexObject):
         """
         if isinstance(value, FilterChoice):
             return value.key
-        if isinstance(value, media.MediaTag):
+        if isinstance(value, (media.MediaTag, LibraryMediaTag)):
             value = str(value.id or value.tag)
         else:
             value = str(value)
@@ -1131,11 +1169,11 @@ class LibrarySection(PlexObject):
             Returns the validated sort field string.
         """
         if isinstance(sort, FilteringSort):
-            return '%s.%s:%s' % (libtype or self.TYPE, sort.key, sort.defaultDirection)
+            return f'{libtype or self.TYPE}.{sort.key}:{sort.defaultDirection}'
 
         match = re.match(r'(?:([a-zA-Z]*)\.)?([a-zA-Z]+):?([a-zA-Z]*)', sort.strip())
         if not match:
-            raise BadRequest('Invalid filter sort: %s' % sort)
+            raise BadRequest(f'Invalid filter sort: {sort}')
         _libtype, sortField, sortDir = match.groups()
         libtype = _libtype or libtype or self.TYPE
 
@@ -1143,19 +1181,16 @@ class LibrarySection(PlexObject):
             filterSort = next(f for f in self.listSorts(libtype) if f.key == sortField)
         except StopIteration:
             availableSorts = [f.key for f in self.listSorts(libtype)]
-            raise NotFound('Unknown sort field "%s" for libtype "%s". '
-                           'Available sort fields: %s'
-                           % (sortField, libtype, availableSorts)) from None
+            raise NotFound(f'Unknown sort field "{sortField}" for libtype "{libtype}". '
+                           f'Available sort fields: {availableSorts}') from None
 
         sortField = libtype + '.' + filterSort.key
 
         availableDirections = ['', 'asc', 'desc', 'nullsLast']
         if sortDir not in availableDirections:
-            raise NotFound('Unknown sort direction "%s". '
-                           'Available sort directions: %s'
-                           % (sortDir, availableDirections))
+            raise NotFound(f'Unknown sort direction "{sortDir}". Available sort directions: {availableDirections}')
 
-        return '%s:%s' % (sortField, sortDir) if sortDir else sortField
+        return f'{sortField}:{sortDir}' if sortDir else sortField
 
     def _validateAdvancedSearch(self, filters, libtype):
         """ Validates an advanced search filter dictionary.
@@ -1177,7 +1212,7 @@ class LibrarySection(PlexObject):
 
                 for value in values:
                     validatedFilters.extend(self._validateAdvancedSearch(value, libtype))
-                    validatedFilters.append('%s=1' % field.lower())
+                    validatedFilters.append(f'{field.lower()}=1')
 
                 del validatedFilters[-1]
                 validatedFilters.append('pop=1')
@@ -1216,7 +1251,7 @@ class LibrarySection(PlexObject):
         joined_args = utils.joinArgs(args).lstrip('?')
         joined_filter_args = '&'.join(filter_args) if filter_args else ''
         params = '&'.join([joined_args, joined_filter_args]).strip('&')
-        key = '/library/sections/%s/all?%s' % (self.key, params)
+        key = f'/library/sections/{self.key}/all?{params}'
 
         if returnKwargs:
             return key, kwargs
@@ -1374,48 +1409,47 @@ class LibrarySection(PlexObject):
 
             **Using Plex Operators**
 
-            Operators can be appended to the filter field to narrow down results with more granularity. If no
-            operator is specified, the default operator is assumed to be ``=``. The following is a list of
-            possible operators depending on the data type of the filter being applied. A special ``&`` operator
-            can also be used to ``AND`` together a list of values.
+            Operators can be appended to the filter field to narrow down results with more granularity.
+            The following is a list of possible operators depending on the data type of the filter being applied.
+            A special ``&`` operator can also be used to ``AND`` together a list of values.
 
             Type: :class:`~plexapi.media.MediaTag` or *subtitleLanguage* or *audioLanguage*
 
-            * ``=``: ``is``
-            * ``!=``: ``is not``
+            * no operator: ``is``
+            * ``!``: ``is not``
 
             Type: *int*
 
-            * ``=``: ``is``
-            * ``!=``: ``is not``
-            * ``>>=``: ``is greater than``
-            * ``<<=``: ``is less than``
+            * no operator: ``is``
+            * ``!``: ``is not``
+            * ``>>``: ``is greater than``
+            * ``<<``: ``is less than``
 
             Type: *str*
 
-            * ``=``: ``contains``
-            * ``!=``: ``does not contain``
-            * ``==``: ``is``
-            * ``!==``: ``is not``
-            * ``<=``: ``begins with``
-            * ``>=``: ``ends with``
+            * no operator: ``contains``
+            * ``!``: ``does not contain``
+            * ``=``: ``is``
+            * ``!=``: ``is not``
+            * ``<``: ``begins with``
+            * ``>``: ``ends with``
 
             Type: *bool*
 
-            * ``=``: ``is true``
-            * ``!=``: ``is false``
+            * no operator: ``is true``
+            * ``!``: ``is false``
 
             Type: *datetime*
 
-            * ``<<=``: ``is before``
-            * ``>>=``: ``is after``
+            * ``<<``: ``is before``
+            * ``>>``: ``is after``
 
-            Type: *resolution*
+            Type: *resolution* or *guid*
 
-            * ``=``: ``is``
+            * no operator: ``is``
 
             Operators cannot be included directly in the function parameters so the filters
-            must be provided as a filters dictionary. The trailing ``=`` on the operator may be excluded.
+            must be provided as a filters dictionary.
 
             Examples:
 
@@ -1593,7 +1627,7 @@ class LibrarySection(PlexObject):
 
         key = self._buildSearchKey(title=title, sort=sort, libtype=libtype, **kwargs)
 
-        sync_item.location = 'library://%s/directory/%s' % (self.uuid, quote_plus(key))
+        sync_item.location = f'library://{self.uuid}/directory/{quote_plus(key)}'
         sync_item.policy = policy
         sync_item.mediaSettings = mediaSettings
 
@@ -1628,7 +1662,7 @@ class LibrarySection(PlexObject):
         try:
             return self.collections(title=title, title__iexact=title)[0]
         except IndexError:
-            raise NotFound('Unable to find collection with title "%s".' % title) from None
+            raise NotFound(f'Unable to find collection with title "{title}".') from None
 
     def collections(self, **kwargs):
         """ Returns a list of collections from this library section.
@@ -1657,7 +1691,7 @@ class LibrarySection(PlexObject):
         try:
             return self.playlists(title=title, title__iexact=title)[0]
         except IndexError:
-            raise NotFound('Unable to find playlist with title "%s".' % title) from None
+            raise NotFound(f'Unable to find playlist with title "{title}".') from None
 
     def playlists(self, sort=None, **kwargs):
         """ Returns a list of playlists from this library section. """
@@ -1848,7 +1882,7 @@ class MusicSection(LibrarySection):
 
     def albums(self):
         """ Returns a list of :class:`~plexapi.audio.Album` objects in this section. """
-        key = '/library/sections/%s/albums' % self.key
+        key = f'/library/sections/{self.key}/albums'
         return self.fetchItems(key)
 
     def stations(self):
@@ -2110,10 +2144,11 @@ class Hub(PlexObject):
         return self._section
 
 
-class HubMediaTag(PlexObject):
-    """ Base class of hub media tag search results.
+class LibraryMediaTag(PlexObject):
+    """ Base class of library media tags.
 
         Attributes:
+            TAG (str): 'Directory'
             count (int): The number of items where this tag is found.
             filter (str): The URL filter for the tag.
             id (int): The id of the tag.
@@ -2156,53 +2191,33 @@ class HubMediaTag(PlexObject):
     def items(self, *args, **kwargs):
         """ Return the list of items within this tag. """
         if not self.key:
-            raise BadRequest('Key is not defined for this tag: %s' % self.tag)
+            raise BadRequest(f'Key is not defined for this tag: {self.tag}')
         return self.fetchItems(self.key)
 
 
 @utils.registerPlexObject
-class Tag(HubMediaTag):
-    """ Represents a single Tag hub search media tag.
+class Aperture(LibraryMediaTag):
+    """ Represents a single Aperture library media tag.
 
         Attributes:
-            TAGTYPE (int): 0
+            TAGTYPE (int): 202
     """
-    TAGTYPE = 0
+    TAGTYPE = 202
 
 
 @utils.registerPlexObject
-class Genre(HubMediaTag):
-    """ Represents a single Genre hub search media tag.
+class Art(LibraryMediaTag):
+    """ Represents a single Art library media tag.
 
         Attributes:
-            TAGTYPE (int): 1
+            TAGTYPE (int): 313
     """
-    TAGTYPE = 1
+    TAGTYPE = 313
 
 
 @utils.registerPlexObject
-class Director(HubMediaTag):
-    """ Represents a single Director hub search media tag.
-
-        Attributes:
-            TAGTYPE (int): 4
-    """
-    TAGTYPE = 4
-
-
-@utils.registerPlexObject
-class Actor(HubMediaTag):
-    """ Represents a single Actor hub search media tag.
-
-        Attributes:
-            TAGTYPE (int): 6
-    """
-    TAGTYPE = 6
-
-
-@utils.registerPlexObject
-class AutoTag(HubMediaTag):
-    """ Represents a single AutoTag hub search media tag.
+class Autotag(LibraryMediaTag):
+    """ Represents a single Autotag library media tag.
 
         Attributes:
             TAGTYPE (int): 207
@@ -2211,8 +2226,210 @@ class AutoTag(HubMediaTag):
 
 
 @utils.registerPlexObject
-class Place(HubMediaTag):
-    """ Represents a single Place hub search media tag.
+class Banner(LibraryMediaTag):
+    """ Represents a single Banner library media tag.
+
+        Attributes:
+            TAGTYPE (int): 311
+    """
+    TAGTYPE = 311
+
+
+@utils.registerPlexObject
+class Chapter(LibraryMediaTag):
+    """ Represents a single Chapter library media tag.
+
+        Attributes:
+            TAGTYPE (int): 9
+    """
+    TAGTYPE = 9
+
+
+@utils.registerPlexObject
+class Collection(LibraryMediaTag):
+    """ Represents a single Collection library media tag.
+
+        Attributes:
+            TAGTYPE (int): 2
+    """
+    TAGTYPE = 2
+
+
+@utils.registerPlexObject
+class Concert(LibraryMediaTag):
+    """ Represents a single Concert library media tag.
+
+        Attributes:
+            TAGTYPE (int): 306
+    """
+    TAGTYPE = 306
+
+
+@utils.registerPlexObject
+class Country(LibraryMediaTag):
+    """ Represents a single Country library media tag.
+
+        Attributes:
+            TAGTYPE (int): 8
+    """
+    TAGTYPE = 8
+
+
+@utils.registerPlexObject
+class Device(LibraryMediaTag):
+    """ Represents a single Device library media tag.
+
+        Attributes:
+            TAGTYPE (int): 206
+    """
+    TAGTYPE = 206
+
+
+@utils.registerPlexObject
+class Director(LibraryMediaTag):
+    """ Represents a single Director library media tag.
+
+        Attributes:
+            TAGTYPE (int): 4
+    """
+    TAGTYPE = 4
+
+
+@utils.registerPlexObject
+class Exposure(LibraryMediaTag):
+    """ Represents a single Exposure library media tag.
+
+        Attributes:
+            TAGTYPE (int): 203
+    """
+    TAGTYPE = 203
+
+
+@utils.registerPlexObject
+class Format(LibraryMediaTag):
+    """ Represents a single Format library media tag.
+
+        Attributes:
+            TAGTYPE (int): 302
+    """
+    TAGTYPE = 302
+
+
+@utils.registerPlexObject
+class Genre(LibraryMediaTag):
+    """ Represents a single Genre library media tag.
+
+        Attributes:
+            TAGTYPE (int): 1
+    """
+    TAGTYPE = 1
+
+
+@utils.registerPlexObject
+class Guid(LibraryMediaTag):
+    """ Represents a single Guid library media tag.
+
+        Attributes:
+            TAGTYPE (int): 314
+    """
+    TAGTYPE = 314
+
+
+@utils.registerPlexObject
+class ISO(LibraryMediaTag):
+    """ Represents a single ISO library media tag.
+
+        Attributes:
+            TAGTYPE (int): 204
+    """
+    TAGTYPE = 204
+
+
+@utils.registerPlexObject
+class Label(LibraryMediaTag):
+    """ Represents a single Label library media tag.
+
+        Attributes:
+            TAGTYPE (int): 11
+    """
+    TAGTYPE = 11
+
+
+@utils.registerPlexObject
+class Lens(LibraryMediaTag):
+    """ Represents a single Lens library media tag.
+
+        Attributes:
+            TAGTYPE (int): 205
+    """
+    TAGTYPE = 205
+
+
+@utils.registerPlexObject
+class Make(LibraryMediaTag):
+    """ Represents a single Make library media tag.
+
+        Attributes:
+            TAGTYPE (int): 200
+    """
+    TAGTYPE = 200
+
+
+@utils.registerPlexObject
+class Marker(LibraryMediaTag):
+    """ Represents a single Marker library media tag.
+
+        Attributes:
+            TAGTYPE (int): 12
+    """
+    TAGTYPE = 12
+
+
+@utils.registerPlexObject
+class MediaProcessingTarget(LibraryMediaTag):
+    """ Represents a single MediaProcessingTarget library media tag.
+
+        Attributes:
+            TAG (str): 'Tag'
+            TAGTYPE (int): 42
+    """
+    TAG = 'Tag'
+    TAGTYPE = 42
+
+
+@utils.registerPlexObject
+class Model(LibraryMediaTag):
+    """ Represents a single Model library media tag.
+
+        Attributes:
+            TAGTYPE (int): 201
+    """
+    TAGTYPE = 201
+
+
+@utils.registerPlexObject
+class Mood(LibraryMediaTag):
+    """ Represents a single Mood library media tag.
+
+        Attributes:
+            TAGTYPE (int): 300
+    """
+    TAGTYPE = 300
+
+
+@utils.registerPlexObject
+class Network(LibraryMediaTag):
+    """ Represents a single Network library media tag.
+
+        Attributes:
+            TAGTYPE (int): 319
+    """
+    TAGTYPE = 319
+
+
+@utils.registerPlexObject
+class Place(LibraryMediaTag):
+    """ Represents a single Place library media tag.
 
         Attributes:
             TAGTYPE (int): 400
@@ -2220,6 +2437,116 @@ class Place(HubMediaTag):
     TAGTYPE = 400
 
 
+@utils.registerPlexObject
+class Poster(LibraryMediaTag):
+    """ Represents a single Poster library media tag.
+
+        Attributes:
+            TAGTYPE (int): 312
+    """
+    TAGTYPE = 312
+
+
+@utils.registerPlexObject
+class Producer(LibraryMediaTag):
+    """ Represents a single Producer library media tag.
+
+        Attributes:
+            TAGTYPE (int): 7
+    """
+    TAGTYPE = 7
+
+
+@utils.registerPlexObject
+class RatingImage(LibraryMediaTag):
+    """ Represents a single RatingImage library media tag.
+
+        Attributes:
+            TAGTYPE (int): 316
+    """
+    TAGTYPE = 316
+
+
+@utils.registerPlexObject
+class Review(LibraryMediaTag):
+    """ Represents a single Review library media tag.
+
+        Attributes:
+            TAGTYPE (int): 10
+    """
+    TAGTYPE = 10
+
+
+@utils.registerPlexObject
+class Role(LibraryMediaTag):
+    """ Represents a single Role library media tag.
+
+        Attributes:
+            TAGTYPE (int): 6
+    """
+    TAGTYPE = 6
+
+
+@utils.registerPlexObject
+class Similar(LibraryMediaTag):
+    """ Represents a single Similar library media tag.
+
+        Attributes:
+            TAGTYPE (int): 305
+    """
+    TAGTYPE = 305
+
+
+@utils.registerPlexObject
+class Studio(LibraryMediaTag):
+    """ Represents a single Studio library media tag.
+
+        Attributes:
+            TAGTYPE (int): 318
+    """
+    TAGTYPE = 318
+
+
+@utils.registerPlexObject
+class Style(LibraryMediaTag):
+    """ Represents a single Style library media tag.
+
+        Attributes:
+            TAGTYPE (int): 301
+    """
+    TAGTYPE = 301
+
+
+@utils.registerPlexObject
+class Tag(LibraryMediaTag):
+    """ Represents a single Tag library media tag.
+
+        Attributes:
+            TAGTYPE (int): 0
+    """
+    TAGTYPE = 0
+
+
+@utils.registerPlexObject
+class Theme(LibraryMediaTag):
+    """ Represents a single Theme library media tag.
+
+        Attributes:
+            TAGTYPE (int): 317
+    """
+    TAGTYPE = 317
+
+
+@utils.registerPlexObject
+class Writer(LibraryMediaTag):
+    """ Represents a single Writer library media tag.
+
+        Attributes:
+            TAGTYPE (int): 5
+    """
+    TAGTYPE = 5
+
+
 class FilteringType(PlexObject):
     """ Represents a single filtering Type object for a library.
 
@@ -2237,7 +2564,7 @@ class FilteringType(PlexObject):
 
     def __repr__(self):
         _type = self._clean(self.firstAttr('type'))
-        return '<%s>' % ':'.join([p for p in [self.__class__.__name__, _type] if p])
+        return f"<{':'.join([p for p in [self.__class__.__name__, _type] if p])}>"
 
     def _loadData(self, data):
         self._data = data
@@ -2288,12 +2615,13 @@ class FilteringType(PlexObject):
 
         manualFilters = []
         for filterTag, filterType, filterTitle in additionalFilters:
-            filterKey = '/library/sections/%s/%s?type=%s' % (
-                self._librarySectionID, filterTag, utils.searchType(self.type)
-            )
+            filterKey = f'/library/sections/{self._librarySectionID}/{filterTag}?type={utils.searchType(self.type)}'
             filterXML = (
-                '<Filter filter="%s" filterType="%s" key="%s" title="%s" type="filter" />'
-                % (filterTag, filterType, filterKey, filterTitle)
+                f'<Filter filter="{filterTag}" '
+                f'filterType="{filterType}" '
+                f'key="{filterKey}" '
+                f'title="{filterTitle}" '
+                f'type="filter" />'
             )
             manualFilters.append(self._manuallyLoadXML(filterXML, FilteringFilter))
 
@@ -2307,7 +2635,7 @@ class FilteringType(PlexObject):
         additionalSorts = [
             ('guid', 'asc', 'Guid'),
             ('id', 'asc', 'Rating Key'),
-            ('index', 'asc', '%s Number' % self.type.capitalize()),
+            ('index', 'asc', f'{self.type.capitalize()} Number'),
             ('summary', 'asc', 'Summary'),
             ('tagline', 'asc', 'Tagline'),
             ('updatedAt', 'asc', 'Date Updated')
@@ -2334,8 +2662,10 @@ class FilteringType(PlexObject):
         manualSorts = []
         for sortField, sortDir, sortTitle in additionalSorts:
             sortXML = (
-                '<Sort defaultDirection="%s" descKey="%s:desc" key="%s" title="%s" />'
-                % (sortDir, sortField, sortField, sortTitle)
+                f'<Sort defaultDirection="{sortDir}" '
+                f'descKey="{sortField}:desc" '
+                f'key="{sortField}" '
+                f'title="{sortTitle}" />'
             )
             manualSorts.append(self._manuallyLoadXML(sortXML, FilteringSort))
 
@@ -2347,10 +2677,10 @@ class FilteringType(PlexObject):
         """
         # Fields: (key, type, title)
         additionalFields = [
-            ('guid', 'string', 'Guid'),
+            ('guid', 'guid', 'Guid'),
             ('id', 'integer', 'Rating Key'),
-            ('index', 'integer', '%s Number' % self.type.capitalize()),
-            ('lastRatedAt', 'date', '%s Last Rated' % self.type.capitalize()),
+            ('index', 'integer', f'{self.type.capitalize()} Number'),
+            ('lastRatedAt', 'date', f'{self.type.capitalize()} Last Rated'),
             ('updatedAt', 'date', 'Date Updated')
         ]
 
@@ -2403,8 +2733,9 @@ class FilteringType(PlexObject):
         manualFields = []
         for field, fieldType, fieldTitle in additionalFields:
             fieldXML = (
-                '<Field key="%s%s" title="%s" type="%s"/>'
-                % (prefix, field, fieldTitle, fieldType)
+                f'<Field key="{prefix}{field}" '
+                f'title="{fieldTitle}" '
+                f'type="{fieldType}"/>'
             )
             manualFields.append(self._manuallyLoadXML(fieldXML, FilteringField))
 
@@ -2495,7 +2826,7 @@ class FilteringFieldType(PlexObject):
 
     def __repr__(self):
         _type = self._clean(self.firstAttr('type'))
-        return '<%s>' % ':'.join([p for p in [self.__class__.__name__, _type] if p])
+        return f"<{':'.join([p for p in [self.__class__.__name__, _type] if p])}>"
 
     def _loadData(self, data):
         """ Load attribute values from Plex XML response. """
@@ -2546,6 +2877,137 @@ class FilterChoice(PlexObject):
         self.type = data.attrib.get('type')
 
 
+class ManagedHub(PlexObject):
+    """ Represents a Managed Hub (recommendation) inside a library.
+
+        Attributes:
+            TAG (str): 'Hub'
+            deletable (bool): True if the Hub can be deleted (promoted collection).
+            homeVisibility (str): Promoted home visibility (none, all, admin, or shared).
+            identifier (str): Hub identifier for the managed hub.
+            promotedToOwnHome (bool): Promoted to own home.
+            promotedToRecommended (bool): Promoted to recommended.
+            promotedToSharedHome (bool): Promoted to shared home.
+            recommendationsVisibility (str): Promoted recommendation visibility (none or all).
+            title (str): Title of managed hub.
+    """
+    TAG = 'Hub'
+
+    def _loadData(self, data):
+        """ Load attribute values from Plex XML response. """
+        self._data = data
+        self.deletable = utils.cast(bool, data.attrib.get('deletable', True))
+        self.homeVisibility = data.attrib.get('homeVisibility', 'none')
+        self.identifier = data.attrib.get('identifier')
+        self.promotedToOwnHome = utils.cast(bool, data.attrib.get('promotedToOwnHome', False))
+        self.promotedToRecommended = utils.cast(bool, data.attrib.get('promotedToRecommended', False))
+        self.promotedToSharedHome = utils.cast(bool, data.attrib.get('promotedToSharedHome', False))
+        self.recommendationsVisibility = data.attrib.get('recommendationsVisibility', 'none')
+        self.title = data.attrib.get('title')
+        self._promoted = True  # flag to indicate if this hub has been promoted on the list of managed recommendations
+
+        parent = self._parent()
+        self.librarySectionID = parent.key if isinstance(parent, LibrarySection) else parent.librarySectionID
+
+    def reload(self):
+        """ Reload the data for this managed hub. """
+        key = f'/hubs/sections/{self.librarySectionID}/manage'
+        hub = self.fetchItem(key, self.__class__, identifier=self.identifier)
+        self.__dict__.update(hub.__dict__)
+        return self
+
+    def move(self, after=None):
+        """ Move a managed hub to a new position in the library's Managed Recommendations.
+
+            Parameters:
+                after (obj): :class:`~plexapi.library.ManagedHub` object to move the item after in the collection.
+
+            Raises:
+                :class:`plexapi.exceptions.BadRequest`: When trying to move a Hub that is not a Managed Recommendation.
+        """
+        if not self._promoted:
+            raise BadRequest('Collection must be a Managed Recommendation to be moved')
+        key = f'/hubs/sections/{self.librarySectionID}/manage/{self.identifier}/move'
+        if after:
+            key = f'{key}?after={after.identifier}'
+        self._server.query(key, method=self._server._session.put)
+
+    def remove(self):
+        """ Removes a managed hub from the library's Managed Recommendations.
+
+            Raises:
+                :class:`plexapi.exceptions.BadRequest`: When trying to remove a Hub that is not a Managed Recommendation
+                    or when the Hub cannot be removed.
+        """
+        if not self._promoted:
+            raise BadRequest('Collection must be a Managed Recommendation to be removed')
+        if not self.deletable:
+            raise BadRequest(f'{self.title} managed hub cannot be removed' % self.title)
+        key = f'/hubs/sections/{self.librarySectionID}/manage/{self.identifier}'
+        self._server.query(key, method=self._server._session.delete)
+
+    def updateVisibility(self, recommended=None, home=None, shared=None):
+        """ Update the managed hub's visibility settings.
+
+            Parameters:
+                recommended (bool): True to make visible on your Library Recommended page. False to hide. Default None.
+                home (bool): True to make visible on your Home page. False to hide. Default None.
+                shared (bool): True to make visible on your Friends' Home page. False to hide. Default None.
+
+            Example:
+
+                .. code-block:: python
+
+                    managedHub.updateVisibility(recommended=True, home=True, shared=False).reload()
+                    # or using chained methods
+                    managedHub.promoteRecommended().promoteHome().demoteShared().reload()
+        """
+        params = {
+            'promotedToRecommended': int(self.promotedToRecommended),
+            'promotedToOwnHome': int(self.promotedToOwnHome),
+            'promotedToSharedHome': int(self.promotedToSharedHome),
+        }
+        if recommended is not None:
+            params['promotedToRecommended'] = int(recommended)
+        if home is not None:
+            params['promotedToOwnHome'] = int(home)
+        if shared is not None:
+            params['promotedToSharedHome'] = int(shared)
+
+        if not self._promoted:
+            params['metadataItemId'] = self.identifier.rsplit('.')[-1]
+            key = f'/hubs/sections/{self.librarySectionID}/manage'
+            self._server.query(key, method=self._server._session.post, params=params)
+        else:
+            key = f'/hubs/sections/{self.librarySectionID}/manage/{self.identifier}'
+            self._server.query(key, method=self._server._session.put, params=params)
+        return self.reload()
+
+    def promoteRecommended(self):
+        """ Show the managed hub on your Library Recommended Page. """
+        return self.updateVisibility(recommended=True)
+
+    def demoteRecommended(self):
+        """ Hide the managed hub on your Library Recommended Page. """
+        return self.updateVisibility(recommended=False)
+
+    def promoteHome(self):
+        """ Show the managed hub on your Home Page. """
+        return self.updateVisibility(home=True)
+
+    def demoteHome(self):
+        """ Hide the manged hub on your Home Page. """
+        return self.updateVisibility(home=False)
+
+    def promoteShared(self):
+        """ Show the managed hub on your Friends' Home Page. """
+        return self.updateVisibility(shared=True)
+
+    def demoteShared(self):
+        """ Hide the managed hub on your Friends' Home Page. """
+        return self.updateVisibility(shared=False)
+
+
 class Folder(PlexObject):
     """ Represents a Folder inside a library.
 
diff --git a/lib/plexapi/media.py b/lib/plexapi/media.py
index 23ac7700..ccdf9fab 100644
--- a/lib/plexapi/media.py
+++ b/lib/plexapi/media.py
@@ -64,6 +64,7 @@ class Media(PlexObject):
         self.optimizedForStreaming = utils.cast(bool, data.attrib.get('optimizedForStreaming'))
         self.parts = self.findItems(data, MediaPart)
         self.proxyType = utils.cast(int, data.attrib.get('proxyType'))
+        self.selected = utils.cast(bool, data.attrib.get('selected'))
         self.target = data.attrib.get('target')
         self.title = data.attrib.get('title')
         self.videoCodec = data.attrib.get('videoCodec')
@@ -71,6 +72,7 @@ class Media(PlexObject):
         self.videoProfile = data.attrib.get('videoProfile')
         self.videoResolution = data.attrib.get('videoResolution')
         self.width = utils.cast(int, data.attrib.get('width'))
+        self.uuid = data.attrib.get('uuid')
 
         if self._isChildOf(etag='Photo'):
             self.aperture = data.attrib.get('aperture')
@@ -89,12 +91,11 @@ class Media(PlexObject):
         return self.proxyType == utils.SEARCHTYPES['optimizedVersion']
 
     def delete(self):
-        part = '%s/media/%s' % (self._parentKey, self.id)
+        part = f'{self._parentKey}/media/{self.id}'
         try:
             return self._server.query(part, method=self._server._session.delete)
         except BadRequest:
-            log.error("Failed to delete %s. This could be because you haven't allowed "
-                      "items to be deleted" % part)
+            log.error("Failed to delete %s. This could be because you haven't allowed items to be deleted", part)
             raise
 
 
@@ -146,7 +147,9 @@ class MediaPart(PlexObject):
         self.key = data.attrib.get('key')
         self.optimizedForStreaming = utils.cast(bool, data.attrib.get('optimizedForStreaming'))
         self.packetLength = utils.cast(int, data.attrib.get('packetLength'))
+        self.protocol = data.attrib.get('protocol')
         self.requiredBandwidths = data.attrib.get('requiredBandwidths')
+        self.selected = utils.cast(bool, data.attrib.get('selected'))
         self.size = utils.cast(int, data.attrib.get('size'))
         self.streams = self._buildStreams(data)
         self.syncItemId = utils.cast(int, data.attrib.get('syncItemId'))
@@ -188,10 +191,11 @@ class MediaPart(PlexObject):
                 stream (:class:`~plexapi.media.AudioStream`): AudioStream to set as default
         """
         if isinstance(stream, AudioStream):
-            key = "/library/parts/%d?audioStreamID=%d&allParts=1" % (self.id, stream.id)
+            key = f"/library/parts/{self.id}?audioStreamID={stream.id}&allParts=1"
         else:
-            key = "/library/parts/%d?audioStreamID=%d&allParts=1" % (self.id, stream)
+            key = f"/library/parts/{self.id}?audioStreamID={stream}&allParts=1"
         self._server.query(key, method=self._server._session.put)
+        return self
 
     def setDefaultSubtitleStream(self, stream):
         """ Set the default :class:`~plexapi.media.SubtitleStream` for this MediaPart.
@@ -200,15 +204,17 @@ class MediaPart(PlexObject):
                 stream (:class:`~plexapi.media.SubtitleStream`): SubtitleStream to set as default.
         """
         if isinstance(stream, SubtitleStream):
-            key = "/library/parts/%d?subtitleStreamID=%d&allParts=1" % (self.id, stream.id)
+            key = f"/library/parts/{self.id}?subtitleStreamID={stream.id}&allParts=1"
         else:
-            key = "/library/parts/%d?subtitleStreamID=%d&allParts=1" % (self.id, stream)
+            key = f"/library/parts/{self.id}?subtitleStreamID={stream}&allParts=1"
         self._server.query(key, method=self._server._session.put)
+        return self
 
     def resetDefaultSubtitleStream(self):
         """ Set default subtitle of this MediaPart to 'none'. """
-        key = "/library/parts/%d?subtitleStreamID=0&allParts=1" % (self.id)
+        key = f"/library/parts/{self.id}?subtitleStreamID=0&allParts=1"
         self._server.query(key, method=self._server._session.put)
+        return self
 
 
 class MediaPartStream(PlexObject):
@@ -225,6 +231,7 @@ class MediaPartStream(PlexObject):
             index (int): The index of the stream.
             language (str): The language of the stream (ex: English, ไทย).
             languageCode (str): The ASCII language code of the stream (ex: eng, tha).
+            languageTag (str): The two letter language tag of the stream (ex: en, fr).
             requiredBandwidths (str): The required bandwidths to stream the file.
             selected (bool): True if this stream is selected.
             streamType (int): The stream type (1= :class:`~plexapi.media.VideoStream`,
@@ -238,14 +245,17 @@ class MediaPartStream(PlexObject):
         self._data = data
         self.bitrate = utils.cast(int, data.attrib.get('bitrate'))
         self.codec = data.attrib.get('codec')
+        self.decision = data.attrib.get('decision')
         self.default = utils.cast(bool, data.attrib.get('default'))
         self.displayTitle = data.attrib.get('displayTitle')
         self.extendedDisplayTitle = data.attrib.get('extendedDisplayTitle')
-        self.key = data.attrib.get('key')
         self.id = utils.cast(int, data.attrib.get('id'))
         self.index = utils.cast(int, data.attrib.get('index', '-1'))
+        self.key = data.attrib.get('key')
         self.language = data.attrib.get('language')
         self.languageCode = data.attrib.get('languageCode')
+        self.languageTag = data.attrib.get('languageTag')
+        self.location = data.attrib.get('location')
         self.requiredBandwidths = data.attrib.get('requiredBandwidths')
         self.selected = utils.cast(bool, data.attrib.get('selected', '0'))
         self.streamType = utils.cast(int, data.attrib.get('streamType'))
@@ -570,22 +580,22 @@ class Optimized(PlexObject):
         """ Returns a list of all :class:`~plexapi.media.Video` objects
             in this optimized item.
         """
-        key = '%s/%s/items' % (self._initpath, self.id)
+        key = f'{self._initpath}/{self.id}/items'
         return self.fetchItems(key)
 
     def remove(self):
         """ Remove an Optimized item"""
-        key = '%s/%s' % (self._initpath, self.id)
+        key = f'{self._initpath}/{self.id}'
         self._server.query(key, method=self._server._session.delete)
 
     def rename(self, title):
         """ Rename an Optimized item"""
-        key = '%s/%s?Item[title]=%s' % (self._initpath, self.id, title)
+        key = f'{self._initpath}/{self.id}?Item[title]={title}'
         self._server.query(key, method=self._server._session.put)
 
     def reprocess(self, ratingKey):
         """ Reprocess a removed Conversion item that is still a listed Optimize item"""
-        key = '%s/%s/%s/enable' % (self._initpath, self.id, ratingKey)
+        key = f'{self._initpath}/{self.id}/{ratingKey}/enable'
         self._server.query(key, method=self._server._session.put)
 
 
@@ -631,7 +641,7 @@ class Conversion(PlexObject):
 
     def remove(self):
         """ Remove Conversion from queue """
-        key = '/playlists/%s/items/%s/%s/disable' % (self.playlistID, self.generatorID, self.ratingKey)
+        key = f'/playlists/{self.playlistID}/items/{self.generatorID}/{self.ratingKey}/disable'
         self._server.query(key, method=self._server._session.put)
 
     def move(self, after):
@@ -646,7 +656,7 @@ class Conversion(PlexObject):
                         conversions[3].move(conversions[1].playQueueItemID)
         """
 
-        key = '%s/items/%s/move?after=%s' % (self._initpath, self.playQueueItemID, after)
+        key = f'{self._initpath}/items/{self.playQueueItemID}/move?after={after}'
         self._server.query(key, method=self._server._session.put)
 
 
@@ -665,6 +675,10 @@ class MediaTag(PlexObject):
             thumb (str): URL to thumbnail image for :class:`~plexapi.media.Role` only.
     """
 
+    def __str__(self):
+        """ Returns the tag name. """
+        return self.tag
+
     def _loadData(self, data):
         """ Load attribute values from Plex XML response. """
         self._data = data
@@ -682,14 +696,12 @@ class MediaTag(PlexObject):
         self._parentType = parent.TYPE
 
         if self._librarySectionKey and self.filter:
-            self.key = '%s/all?%s&type=%s' % (
-                self._librarySectionKey, self.filter, utils.searchType(self._parentType))
+            self.key = f'{self._librarySectionKey}/all?{self.filter}&type={utils.searchType(self._parentType)}'
 
     def items(self):
         """ Return the list of items within this tag. """
         if not self.key:
-            raise BadRequest('Key is not defined for this tag: %s. '
-                             'Reload the parent object.' % self.tag)
+            raise BadRequest(f'Key is not defined for this tag: {self.tag}. Reload the parent object.')
         return self.fetchItems(self.key)
 
 
@@ -707,7 +719,7 @@ class Collection(MediaTag):
     def collection(self):
         """ Return the :class:`~plexapi.collection.Collection` object for this collection tag.
         """
-        key = '%s/collections' % self._librarySectionKey
+        key = f'{self._librarySectionKey}/collections'
         return self.fetchItem(key, etag='Directory', index=self.id)
 
 
@@ -871,7 +883,7 @@ class GuidTag(PlexObject):
     """ Base class for guid tags used only for Guids, as they contain only a string identifier
 
         Attributes:
-            id (id): The guid for external metadata sources (e.g. IMDB, TMDB, TVDB).
+            id (id): The guid for external metadata sources (e.g. IMDB, TMDB, TVDB, MBID).
     """
 
     def _loadData(self, data):
@@ -938,7 +950,7 @@ class BaseResource(PlexObject):
 
     def select(self):
         key = self._initpath[:-1]
-        data = '%s?url=%s' % (key, quote_plus(self.ratingKey))
+        data = f'{key}?url={quote_plus(self.ratingKey)}'
         try:
             self._server.query(data, method=self._server._session.put)
         except xml.etree.ElementTree.ParseError:
@@ -967,7 +979,7 @@ class Theme(BaseResource):
 
 @utils.registerPlexObject
 class Chapter(PlexObject):
-    """ Represents a single Writer media tag.
+    """ Represents a single Chapter media tag.
 
         Attributes:
             TAG (str): 'Chapter'
@@ -998,8 +1010,8 @@ class Marker(PlexObject):
         name = self._clean(self.firstAttr('type'))
         start = utils.millisecondToHumanstr(self._clean(self.firstAttr('start')))
         end = utils.millisecondToHumanstr(self._clean(self.firstAttr('end')))
-        offsets = '%s-%s' % (start, end)
-        return '<%s>' % ':'.join([self.__class__.__name__, name, offsets])
+        offsets = f'{start}-{end}'
+        return f"<{':'.join([self.__class__.__name__, name, offsets])}>"
 
     def _loadData(self, data):
         self._data = data
@@ -1036,7 +1048,7 @@ class SearchResult(PlexObject):
     def __repr__(self):
         name = self._clean(self.firstAttr('name'))
         score = self._clean(self.firstAttr('score'))
-        return '<%s>' % ':'.join([p for p in [self.__class__.__name__, name, score] if p])
+        return f"<{':'.join([p for p in [self.__class__.__name__, name, score] if p])}>"
 
     def _loadData(self, data):
         self._data = data
@@ -1058,7 +1070,7 @@ class Agent(PlexObject):
 
     def __repr__(self):
         uid = self._clean(self.firstAttr('shortIdentifier'))
-        return '<%s>' % ':'.join([p for p in [self.__class__.__name__, uid] if p])
+        return f"<{':'.join([p for p in [self.__class__.__name__, uid] if p])}>"
 
     def _loadData(self, data):
         self._data = data
@@ -1082,7 +1094,7 @@ class Agent(PlexObject):
         return self.languageCodes
 
     def settings(self):
-        key = '/:/plugins/%s/prefs' % self.identifier
+        key = f'/:/plugins/{self.identifier}/prefs'
         data = self._server.query(key)
         return self.findItems(data, cls=settings.Setting)
 
@@ -1101,7 +1113,7 @@ class AgentMediaType(Agent):
 
     def __repr__(self):
         uid = self._clean(self.firstAttr('name'))
-        return '<%s>' % ':'.join([p for p in [self.__class__.__name__, uid] if p])
+        return f"<{':'.join([p for p in [self.__class__.__name__, uid] if p])}>"
 
     def _loadData(self, data):
         self.languageCodes = self.listAttrs(data, 'code', etag='Language')
diff --git a/lib/plexapi/mixins.py b/lib/plexapi/mixins.py
index 4a6e1f0c..16414cf5 100644
--- a/lib/plexapi/mixins.py
+++ b/lib/plexapi/mixins.py
@@ -27,37 +27,38 @@ class AdvancedSettingsMixin:
             return next(p for p in prefs if p.id == pref)
         except StopIteration:
             availablePrefs = [p.id for p in prefs]
-            raise NotFound('Unknown preference "%s" for %s. '
-                           'Available preferences: %s'
-                           % (pref, self.TYPE, availablePrefs)) from None
+            raise NotFound(f'Unknown preference "{pref}" for {self.TYPE}. '
+                           f'Available preferences: {availablePrefs}') from None
 
     def editAdvanced(self, **kwargs):
         """ Edit a Plex object's advanced settings. """
         data = {}
-        key = '%s/prefs?' % self.key
+        key = f'{self.key}/prefs?'
         preferences = {pref.id: pref for pref in self.preferences() if pref.enumValues}
         for settingID, value in kwargs.items():
             try:
                 pref = preferences[settingID]
             except KeyError:
-                raise NotFound('%s not found in %s' % (value, list(preferences.keys())))
+                raise NotFound(f'{value} not found in {list(preferences.keys())}')
             
             enumValues = pref.enumValues
             if enumValues.get(value, enumValues.get(str(value))):
                 data[settingID] = value
             else:
-                raise NotFound('%s not found in %s' % (value, list(enumValues)))
+                raise NotFound(f'{value} not found in {list(enumValues)}')
         url = key + urlencode(data)
         self._server.query(url, method=self._server._session.put)
+        return self
 
     def defaultAdvanced(self):
         """ Edit all of a Plex object's advanced settings to default. """
         data = {}
-        key = '%s/prefs?' % self.key
+        key = f'{self.key}/prefs?'
         for preference in self.preferences():
             data[preference.id] = preference.default
         url = key + urlencode(data)
         self._server.query(url, method=self._server._session.put)
+        return self
 
 
 class SmartFilterMixin:
@@ -125,8 +126,9 @@ class SplitMergeMixin:
 
     def split(self):
         """ Split duplicated Plex object into separate objects. """
-        key = '/library/metadata/%s/split' % self.ratingKey
-        return self._server.query(key, method=self._server._session.put)
+        key = f'{self.key}/split'
+        self._server.query(key, method=self._server._session.put)
+        return self
 
     def merge(self, ratingKeys):
         """ Merge other Plex objects into the current object.
@@ -137,8 +139,9 @@ class SplitMergeMixin:
         if not isinstance(ratingKeys, list):
             ratingKeys = str(ratingKeys).split(',')
 
-        key = '%s/merge?ids=%s' % (self.key, ','.join([str(r) for r in ratingKeys]))
-        return self._server.query(key, method=self._server._session.put)
+        key = f"{self.key}/merge?ids={','.join([str(r) for r in ratingKeys])}"
+        self._server.query(key, method=self._server._session.put)
+        return self
 
 
 class UnmatchMatchMixin:
@@ -146,7 +149,7 @@ class UnmatchMatchMixin:
 
     def unmatch(self):
         """ Unmatches metadata match from object. """
-        key = '/library/metadata/%s/unmatch' % self.ratingKey
+        key = f'{self.key}/unmatch'
         self._server.query(key, method=self._server._session.put)
 
     def matches(self, agent=None, title=None, year=None, language=None):
@@ -177,7 +180,7 @@ class UnmatchMatchMixin:
 
                 For 2 to 7, the agent and language is automatically filled in
         """
-        key = '/library/metadata/%s/matches' % self.ratingKey
+        key = f'{self.key}/matches'
         params = {'manual': 1}
 
         if agent and not any([title, year, language]):
@@ -191,7 +194,7 @@ class UnmatchMatchMixin:
                     params['title'] = title
 
                 if year is None:
-                    params['year'] = self.year
+                    params['year'] = getattr(self, 'year', '')
                 else:
                     params['year'] = year
 
@@ -216,13 +219,13 @@ class UnmatchMatchMixin:
                     ~plexapi.base.matches()
                 agent (str): Agent name to be used (imdb, thetvdb, themoviedb, etc.)
         """
-        key = '/library/metadata/%s/match' % self.ratingKey
+        key = f'{self.key}/match'
         if auto:
             autoMatch = self.matches(agent=agent)
             if autoMatch:
                 searchResult = autoMatch[0]
             else:
-                raise NotFound('No matches found using this agent: (%s:%s)' % (agent, autoMatch))
+                raise NotFound(f'No matches found using this agent: ({agent}:{autoMatch})')
         elif not searchResult:
             raise NotFound('fixMatch() requires either auto=True or '
                            'searchResult=:class:`~plexapi.media.SearchResult`.')
@@ -232,6 +235,7 @@ class UnmatchMatchMixin:
 
         data = key + '?' + urlencode(params)
         self._server.query(data, method=self._server._session.put)
+        return self
 
 
 class ExtrasMixin:
@@ -250,8 +254,48 @@ class HubsMixin:
     def hubs(self):
         """ Returns a list of :class:`~plexapi.library.Hub` objects. """
         from plexapi.library import Hub
-        data = self._server.query(self._details_key)
-        return self.findItems(data, Hub, rtag='Related')
+        key = f'{self.key}/related'
+        data = self._server.query(key)
+        return self.findItems(data, Hub)
+
+
+class PlayedUnplayedMixin:
+    """ Mixin for Plex objects that can be marked played and unplayed. """
+
+    @property
+    def isPlayed(self):
+        """ Returns True if this video is played. """
+        return bool(self.viewCount > 0) if self.viewCount else False
+
+    def markPlayed(self):
+        """ Mark the Plex object as played. """
+        key = '/:/scrobble'
+        params = {'key': self.ratingKey, 'identifier': 'com.plexapp.plugins.library'}
+        self._server.query(key, params=params)
+        return self
+
+    def markUnplayed(self):
+        """ Mark the Plex object as unplayed. """
+        key = '/:/unscrobble'
+        params = {'key': self.ratingKey, 'identifier': 'com.plexapp.plugins.library'}
+        self._server.query(key, params=params)
+        return self
+
+    @property
+    @deprecated('use "isPlayed" instead', stacklevel=3)
+    def isWatched(self):
+        """ Returns True if the show is watched. """
+        return self.isPlayed
+
+    @deprecated('use "markPlayed" instead')
+    def markWatched(self):
+        """ Mark the video as played. """
+        self.markPlayed()
+
+    @deprecated('use "markUnplayed" instead')
+    def markUnwatched(self):
+        """ Mark the video as unplayed. """
+        self.markUnplayed()
 
 
 class RatingMixin:
@@ -270,8 +314,9 @@ class RatingMixin:
             rating = -1
         elif not isinstance(rating, (int, float)) or rating < 0 or rating > 10:
             raise BadRequest('Rating must be between 0 to 10.')
-        key = '/:/rate?key=%s&identifier=com.plexapp.plugins.library&rating=%s' % (self.ratingKey, rating)
+        key = f'/:/rate?key={self.ratingKey}&identifier=com.plexapp.plugins.library&rating={rating}'
         self._server.query(key, method=self._server._session.put)
+        return self
 
 
 class ArtUrlMixin:
@@ -289,7 +334,7 @@ class ArtMixin(ArtUrlMixin):
 
     def arts(self):
         """ Returns list of available :class:`~plexapi.media.Art` objects. """
-        return self.fetchItems('/library/metadata/%s/arts' % self.ratingKey, cls=media.Art)
+        return self.fetchItems(f'/library/metadata/{self.ratingKey}/arts', cls=media.Art)
 
     def uploadArt(self, url=None, filepath=None):
         """ Upload a background artwork from a url or filepath.
@@ -299,12 +344,13 @@ class ArtMixin(ArtUrlMixin):
                 filepath (str): The full file path the the image to upload.
         """
         if url:
-            key = '/library/metadata/%s/arts?url=%s' % (self.ratingKey, quote_plus(url))
+            key = f'/library/metadata/{self.ratingKey}/arts?url={quote_plus(url)}'
             self._server.query(key, method=self._server._session.post)
         elif filepath:
-            key = '/library/metadata/%s/arts?' % self.ratingKey
+            key = f'/library/metadata/{self.ratingKey}/arts'
             data = open(filepath, 'rb').read()
             self._server.query(key, method=self._server._session.post, data=data)
+        return self
 
     def setArt(self, art):
         """ Set the background artwork for a Plex object.
@@ -313,6 +359,7 @@ class ArtMixin(ArtUrlMixin):
                 art (:class:`~plexapi.media.Art`): The art object to select.
         """
         art.select()
+        return self
 
     def lockArt(self):
         """ Lock the background artwork for a Plex object. """
@@ -338,7 +385,7 @@ class BannerMixin(BannerUrlMixin):
 
     def banners(self):
         """ Returns list of available :class:`~plexapi.media.Banner` objects. """
-        return self.fetchItems('/library/metadata/%s/banners' % self.ratingKey, cls=media.Banner)
+        return self.fetchItems(f'/library/metadata/{self.ratingKey}/banners', cls=media.Banner)
 
     def uploadBanner(self, url=None, filepath=None):
         """ Upload a banner from a url or filepath.
@@ -348,12 +395,13 @@ class BannerMixin(BannerUrlMixin):
                 filepath (str): The full file path the the image to upload.
         """
         if url:
-            key = '/library/metadata/%s/banners?url=%s' % (self.ratingKey, quote_plus(url))
+            key = f'/library/metadata/{self.ratingKey}/banners?url={quote_plus(url)}'
             self._server.query(key, method=self._server._session.post)
         elif filepath:
-            key = '/library/metadata/%s/banners?' % self.ratingKey
+            key = f'/library/metadata/{self.ratingKey}/banners'
             data = open(filepath, 'rb').read()
             self._server.query(key, method=self._server._session.post, data=data)
+        return self
 
     def setBanner(self, banner):
         """ Set the banner for a Plex object.
@@ -362,6 +410,7 @@ class BannerMixin(BannerUrlMixin):
                 banner (:class:`~plexapi.media.Banner`): The banner object to select.
         """
         banner.select()
+        return self
 
     def lockBanner(self):
         """ Lock the banner for a Plex object. """
@@ -392,7 +441,7 @@ class PosterMixin(PosterUrlMixin):
 
     def posters(self):
         """ Returns list of available :class:`~plexapi.media.Poster` objects. """
-        return self.fetchItems('/library/metadata/%s/posters' % self.ratingKey, cls=media.Poster)
+        return self.fetchItems(f'/library/metadata/{self.ratingKey}/posters', cls=media.Poster)
 
     def uploadPoster(self, url=None, filepath=None):
         """ Upload a poster from a url or filepath.
@@ -402,12 +451,13 @@ class PosterMixin(PosterUrlMixin):
                 filepath (str): The full file path the the image to upload.
         """
         if url:
-            key = '/library/metadata/%s/posters?url=%s' % (self.ratingKey, quote_plus(url))
+            key = f'/library/metadata/{self.ratingKey}/posters?url={quote_plus(url)}'
             self._server.query(key, method=self._server._session.post)
         elif filepath:
-            key = '/library/metadata/%s/posters?' % self.ratingKey
+            key = f'/library/metadata/{self.ratingKey}/posters'
             data = open(filepath, 'rb').read()
             self._server.query(key, method=self._server._session.post, data=data)
+        return self
 
     def setPoster(self, poster):
         """ Set the poster for a Plex object.
@@ -416,6 +466,7 @@ class PosterMixin(PosterUrlMixin):
                 poster (:class:`~plexapi.media.Poster`): The poster object to select.
         """
         poster.select()
+        return self
 
     def lockPoster(self):
         """ Lock the poster for a Plex object. """
@@ -441,7 +492,7 @@ class ThemeMixin(ThemeUrlMixin):
 
     def themes(self):
         """ Returns list of available :class:`~plexapi.media.Theme` objects. """
-        return self.fetchItems('/library/metadata/%s/themes' % self.ratingKey, cls=media.Theme)
+        return self.fetchItems(f'/library/metadata/{self.ratingKey}/themes', cls=media.Theme)
 
     def uploadTheme(self, url=None, filepath=None):
         """ Upload a theme from url or filepath.
@@ -453,12 +504,13 @@ class ThemeMixin(ThemeUrlMixin):
                 filepath (str): The full file path to the theme to upload.
         """
         if url:
-            key = '/library/metadata/%s/themes?url=%s' % (self.ratingKey, quote_plus(url))
+            key = f'/library/metadata/{self.ratingKey}/themes?url={quote_plus(url)}'
             self._server.query(key, method=self._server._session.post)
         elif filepath:
-            key = '/library/metadata/%s/themes?' % self.ratingKey
+            key = f'/library/metadata/{self.ratingKey}/themes'
             data = open(filepath, 'rb').read()
             self._server.query(key, method=self._server._session.post, data=data)
+        return self
 
     def setTheme(self, theme):
         raise NotImplementedError(
@@ -468,11 +520,11 @@ class ThemeMixin(ThemeUrlMixin):
 
     def lockTheme(self):
         """ Lock the theme for a Plex object. """
-        self._edit(**{'theme.locked': 1})
+        return self._edit(**{'theme.locked': 1})
 
     def unlockTheme(self):
         """ Unlock the theme for a Plex object. """
-        self._edit(**{'theme.locked': 0})
+        return self._edit(**{'theme.locked': 0})
 
 
 class EditFieldMixin:
@@ -496,8 +548,8 @@ class EditFieldMixin:
 
         """
         edits = {
-            '%s.value' % field: value or '',
-            '%s.locked' % field: 1 if locked else 0
+            f'{field}.value': value or '',
+            f'{field}.locked': 1 if locked else 0
         }
         edits.update(kwargs)
         return self._edit(**edits)
@@ -516,6 +568,19 @@ class ContentRatingMixin(EditFieldMixin):
         return self.editField('contentRating', contentRating, locked=locked)
 
 
+class EditionTitleMixin(EditFieldMixin):
+    """ Mixin for Plex objects that can have an edition title. """
+
+    def editEditionTitle(self, editionTitle, locked=True):
+        """ Edit the edition title. Plex Pass is required to edit this field.
+
+            Parameters:
+                editionTitle (str): The new value.
+                locked (bool): True (default) to lock the field, False to unlock the field.
+        """
+        return self.editField('editionTitle', editionTitle, locked=locked)
+
+
 class OriginallyAvailableMixin(EditFieldMixin):
     """ Mixin for Plex objects that can have an originally available date. """
 
@@ -680,7 +745,7 @@ class EditTagsMixin:
 
             Parameters:
                 tag (str): Name of the tag to edit.
-                items (List<str>): List of tags to add or remove.
+                items (List<str> or List<:class:`~plexapi.media.MediaTag`>): List of tags to add or remove.
                 locked (bool): True (default) to lock the tags, False to unlock the tags.
                 remove (bool): True to remove the tags in items.
 
@@ -695,9 +760,11 @@ class EditTagsMixin:
         if not isinstance(items, list):
             items = [items]
 
-        value = getattr(self, self._tagPlural(tag))
-        existing_tags = [t.tag for t in value if t and remove is False]
-        edits = self._tagHelper(self._tagSingular(tag), existing_tags + items, locked, remove)
+        if not remove:
+            tags = getattr(self, self._tagPlural(tag))
+            items = tags + items
+
+        edits = self._tagHelper(self._tagSingular(tag), items, locked, remove)
         edits.update(kwargs)
         return self._edit(**edits)
 
@@ -730,15 +797,15 @@ class EditTagsMixin:
             items = [items]
 
         data = {
-            '%s.locked' % tag: 1 if locked else 0
+            f'{tag}.locked': 1 if locked else 0
         }
 
         if remove:
-            tagname = '%s[].tag.tag-' % tag
-            data[tagname] = ','.join(items)
+            tagname = f'{tag}[].tag.tag-'
+            data[tagname] = ','.join([str(t) for t in items])
         else:
             for i, item in enumerate(items):
-                tagname = '%s[%s].tag.tag' % (tag, i)
+                tagname = f'{str(tag)}[{i}].tag.tag'
                 data[tagname] = item
 
         return data
@@ -751,7 +818,7 @@ class CollectionMixin(EditTagsMixin):
         """ Add a collection tag(s).
 
             Parameters:
-                collections (list): List of strings.
+                collections (List<str> or List<:class:`~plexapi.media.MediaTag`>): List of tags.
                 locked (bool): True (default) to lock the field, False to unlock the field.
         """
         return self.editTags('collection', collections, locked=locked)
@@ -760,7 +827,7 @@ class CollectionMixin(EditTagsMixin):
         """ Remove a collection tag(s).
 
             Parameters:
-                collections (list): List of strings.
+                collections (List<str> or List<:class:`~plexapi.media.MediaTag`>): List of tags.
                 locked (bool): True (default) to lock the field, False to unlock the field.
         """
         return self.editTags('collection', collections, locked=locked, remove=True)
@@ -773,7 +840,7 @@ class CountryMixin(EditTagsMixin):
         """ Add a country tag(s).
 
             Parameters:
-                countries (list): List of strings.
+                countries (List<str> or List<:class:`~plexapi.media.MediaTag`>): List of tags.
                 locked (bool): True (default) to lock the field, False to unlock the field.
         """
         return self.editTags('country', countries, locked=locked)
@@ -782,7 +849,7 @@ class CountryMixin(EditTagsMixin):
         """ Remove a country tag(s).
 
             Parameters:
-                countries (list): List of strings.
+                countries (List<str> or List<:class:`~plexapi.media.MediaTag`>): List of tags.
                 locked (bool): True (default) to lock the field, False to unlock the field.
         """
         return self.editTags('country', countries, locked=locked, remove=True)
@@ -795,7 +862,7 @@ class DirectorMixin(EditTagsMixin):
         """ Add a director tag(s).
 
             Parameters:
-                directors (list): List of strings.
+                directors (List<str> or List<:class:`~plexapi.media.MediaTag`>): List of tags.
                 locked (bool): True (default) to lock the field, False to unlock the field.
         """
         return self.editTags('director', directors, locked=locked)
@@ -804,7 +871,7 @@ class DirectorMixin(EditTagsMixin):
         """ Remove a director tag(s).
 
             Parameters:
-                directors (list): List of strings.
+                directors (List<str> or List<:class:`~plexapi.media.MediaTag`>): List of tags.
                 locked (bool): True (default) to lock the field, False to unlock the field.
         """
         return self.editTags('director', directors, locked=locked, remove=True)
@@ -817,7 +884,7 @@ class GenreMixin(EditTagsMixin):
         """ Add a genre tag(s).
 
             Parameters:
-                genres (list): List of strings.
+                genres (List<str> or List<:class:`~plexapi.media.MediaTag`>): List of tags.
                 locked (bool): True (default) to lock the field, False to unlock the field.
         """
         return self.editTags('genre', genres, locked=locked)
@@ -826,7 +893,7 @@ class GenreMixin(EditTagsMixin):
         """ Remove a genre tag(s).
 
             Parameters:
-                genres (list): List of strings.
+                genres (List<str> or List<:class:`~plexapi.media.MediaTag`>): List of tags.
                 locked (bool): True (default) to lock the field, False to unlock the field.
         """
         return self.editTags('genre', genres, locked=locked, remove=True)
@@ -839,7 +906,7 @@ class LabelMixin(EditTagsMixin):
         """ Add a label tag(s).
 
             Parameters:
-                labels (list): List of strings.
+                labels (List<str> or List<:class:`~plexapi.media.MediaTag`>): List of tags.
                 locked (bool): True (default) to lock the field, False to unlock the field.
         """
         return self.editTags('label', labels, locked=locked)
@@ -848,7 +915,7 @@ class LabelMixin(EditTagsMixin):
         """ Remove a label tag(s).
 
             Parameters:
-                labels (list): List of strings.
+                labels (List<str> or List<:class:`~plexapi.media.MediaTag`>): List of tags.
                 locked (bool): True (default) to lock the field, False to unlock the field.
         """
         return self.editTags('label', labels, locked=locked, remove=True)
@@ -861,7 +928,7 @@ class MoodMixin(EditTagsMixin):
         """ Add a mood tag(s).
 
             Parameters:
-                moods (list): List of strings.
+                moods (List<str> or List<:class:`~plexapi.media.MediaTag`>): List of tags.
                 locked (bool): True (default) to lock the field, False to unlock the field.
         """
         return self.editTags('mood', moods, locked=locked)
@@ -870,7 +937,7 @@ class MoodMixin(EditTagsMixin):
         """ Remove a mood tag(s).
 
             Parameters:
-                moods (list): List of strings.
+                moods (List<str> or List<:class:`~plexapi.media.MediaTag`>): List of tags.
                 locked (bool): True (default) to lock the field, False to unlock the field.
         """
         return self.editTags('mood', moods, locked=locked, remove=True)
@@ -883,7 +950,7 @@ class ProducerMixin(EditTagsMixin):
         """ Add a producer tag(s).
 
             Parameters:
-                producers (list): List of strings.
+                producers (List<str> or List<:class:`~plexapi.media.MediaTag`>): List of tags.
                 locked (bool): True (default) to lock the field, False to unlock the field.
         """
         return self.editTags('producer', producers, locked=locked)
@@ -892,7 +959,7 @@ class ProducerMixin(EditTagsMixin):
         """ Remove a producer tag(s).
 
             Parameters:
-                producers (list): List of strings.
+                producers (List<str> or List<:class:`~plexapi.media.MediaTag`>): List of tags.
                 locked (bool): True (default) to lock the field, False to unlock the field.
         """
         return self.editTags('producer', producers, locked=locked, remove=True)
@@ -905,7 +972,7 @@ class SimilarArtistMixin(EditTagsMixin):
         """ Add a similar artist tag(s).
 
             Parameters:
-                artists (list): List of strings.
+                artists (List<str> or List<:class:`~plexapi.media.MediaTag`>): List of tags.
                 locked (bool): True (default) to lock the field, False to unlock the field.
         """
         return self.editTags('similar', artists, locked=locked)
@@ -914,7 +981,7 @@ class SimilarArtistMixin(EditTagsMixin):
         """ Remove a similar artist tag(s).
 
             Parameters:
-                artists (list): List of strings.
+                artists (List<str> or List<:class:`~plexapi.media.MediaTag`>): List of tags.
                 locked (bool): True (default) to lock the field, False to unlock the field.
         """
         return self.editTags('similar', artists, locked=locked, remove=True)
@@ -927,7 +994,7 @@ class StyleMixin(EditTagsMixin):
         """ Add a style tag(s).
 
             Parameters:
-                styles (list): List of strings.
+                styles (List<str> or List<:class:`~plexapi.media.MediaTag`>): List of tags.
                 locked (bool): True (default) to lock the field, False to unlock the field.
         """
         return self.editTags('style', styles, locked=locked)
@@ -936,7 +1003,7 @@ class StyleMixin(EditTagsMixin):
         """ Remove a style tag(s).
 
             Parameters:
-                styles (list): List of strings.
+                styles (List<str> or List<:class:`~plexapi.media.MediaTag`>): List of tags.
                 locked (bool): True (default) to lock the field, False to unlock the field.
         """
         return self.editTags('style', styles, locked=locked, remove=True)
@@ -949,7 +1016,7 @@ class TagMixin(EditTagsMixin):
         """ Add a tag(s).
 
             Parameters:
-                tags (list): List of strings.
+                tags (List<str> or List<:class:`~plexapi.media.MediaTag`>): List of tags.
                 locked (bool): True (default) to lock the field, False to unlock the field.
         """
         return self.editTags('tag', tags, locked=locked)
@@ -958,7 +1025,7 @@ class TagMixin(EditTagsMixin):
         """ Remove a tag(s).
 
             Parameters:
-                tags (list): List of strings.
+                tags (List<str> or List<:class:`~plexapi.media.MediaTag`>): List of tags.
                 locked (bool): True (default) to lock the field, False to unlock the field.
         """
         return self.editTags('tag', tags, locked=locked, remove=True)
@@ -971,7 +1038,7 @@ class WriterMixin(EditTagsMixin):
         """ Add a writer tag(s).
 
             Parameters:
-                writers (list): List of strings.
+                writers (List<str> or List<:class:`~plexapi.media.MediaTag`>): List of tags.
                 locked (bool): True (default) to lock the field, False to unlock the field.
         """
         return self.editTags('writer', writers, locked=locked)
@@ -980,7 +1047,7 @@ class WriterMixin(EditTagsMixin):
         """ Remove a writer tag(s).
 
             Parameters:
-                writers (list): List of strings.
+                writers (List<str> or List<:class:`~plexapi.media.MediaTag`>): List of tags.
                 locked (bool): True (default) to lock the field, False to unlock the field.
         """
         return self.editTags('writer', writers, locked=locked, remove=True)
@@ -1016,6 +1083,7 @@ class WatchlistMixin:
         except AttributeError:
             account = self._server
         account.addToWatchlist(self)
+        return self
 
     def removeFromWatchlist(self, account=None):
         """ Remove this item from the specified user's watchlist.
@@ -1030,6 +1098,7 @@ class WatchlistMixin:
         except AttributeError:
             account = self._server
         account.removeFromWatchlist(self)
+        return self
 
     def streamingServices(self, account=None):
         """ Return a list of :class:`~plexapi.media.Availability`
diff --git a/lib/plexapi/myplex.py b/lib/plexapi/myplex.py
index b7e72d0f..7bfbe7ab 100644
--- a/lib/plexapi/myplex.py
+++ b/lib/plexapi/myplex.py
@@ -3,11 +3,12 @@ import copy
 import html
 import threading
 import time
+from urllib.parse import parse_qsl, urlencode, urlsplit, urlunsplit
 from xml.etree import ElementTree
 
 import requests
-from plexapi import (BASE_HEADERS, CONFIG, TIMEOUT, X_PLEX_ENABLE_FAST_CONNECT,
-                     X_PLEX_IDENTIFIER, log, logfilter, utils)
+from plexapi import (BASE_HEADERS, CONFIG, TIMEOUT, X_PLEX_CONTAINER_SIZE,
+                     X_PLEX_ENABLE_FAST_CONNECT, X_PLEX_IDENTIFIER, log, logfilter, utils)
 from plexapi.base import PlexObject
 from plexapi.client import PlexClient
 from plexapi.exceptions import BadRequest, NotFound, Unauthorized
@@ -47,6 +48,7 @@ class MyPlexAccount(PlexObject):
             locale (str): Your Plex locale
             mailing_list_status (str): Your current mailing list status.
             maxHomeSize (int): Unknown.
+            pin (str): The hashed Plex Home PIN.
             queueEmail (str): Email address to add items to your `Watch Later` queue.
             queueUid (str): Unknown.
             restricted (bool): Unknown.
@@ -65,16 +67,19 @@ class MyPlexAccount(PlexObject):
             _session (obj): Requests session object used to access this client.
     """
     FRIENDINVITE = 'https://plex.tv/api/servers/{machineId}/shared_servers'                     # post with data
+    HOMEUSERS = 'https://plex.tv/api/home/users'
     HOMEUSERCREATE = 'https://plex.tv/api/home/users?title={title}'                             # post with data
     EXISTINGUSER = 'https://plex.tv/api/home/users?invitedEmail={username}'                     # post with data
     FRIENDSERVERS = 'https://plex.tv/api/servers/{machineId}/shared_servers/{serverId}'         # put with data
     PLEXSERVERS = 'https://plex.tv/api/servers/{machineId}'                                     # get
     FRIENDUPDATE = 'https://plex.tv/api/friends/{userId}'                                       # put with args, delete
-    REMOVEHOMEUSER = 'https://plex.tv/api/home/users/{userId}'                                  # delete
+    HOMEUSER = 'https://plex.tv/api/home/users/{userId}'                                        # delete, put
+    MANAGEDHOMEUSER = 'https://plex.tv/api/v2/home/users/restricted/{userId}'                   # put
     SIGNIN = 'https://plex.tv/users/sign_in.xml'                                                # get with auth
     WEBHOOKS = 'https://plex.tv/api/v2/user/webhooks'                                           # get, post with data
     OPTOUTS = 'https://plex.tv/api/v2/user/{userUUID}/settings/opt_outs'                        # get
     LINK = 'https://plex.tv/api/v2/pins/link'                                                   # put
+    VIEWSTATESYNC = 'https://plex.tv/api/v2/user/view_state_sync'                               # put
     # Hub sections
     VOD = 'https://vod.provider.plex.tv'                                                        # get
     MUSIC = 'https://music.provider.plex.tv'                                                    # get
@@ -115,6 +120,7 @@ class MyPlexAccount(PlexObject):
         self.locale = data.attrib.get('locale')
         self.mailing_list_status = data.attrib.get('mailing_list_status')
         self.maxHomeSize = utils.cast(int, data.attrib.get('maxHomeSize'))
+        self.pin = data.attrib.get('pin')
         self.queueEmail = data.attrib.get('queueEmail')
         self.queueUid = data.attrib.get('queueUid')
         self.restricted = utils.cast(bool, data.attrib.get('restricted'))
@@ -150,7 +156,7 @@ class MyPlexAccount(PlexObject):
         for device in self.devices():
             if (name and device.name.lower() == name.lower() or device.clientIdentifier == clientId):
                 return device
-        raise NotFound('Unable to find device %s' % name)
+        raise NotFound(f'Unable to find device {name}')
 
     def devices(self):
         """ Returns a list of all :class:`~plexapi.myplex.MyPlexDevice` objects connected to the server. """
@@ -174,7 +180,7 @@ class MyPlexAccount(PlexObject):
         if response.status_code not in (200, 201, 204):  # pragma: no cover
             codename = codes.get(response.status_code)[0]
             errtext = response.text.replace('\n', ' ')
-            message = '(%s) %s; %s %s' % (response.status_code, codename, response.url, errtext)
+            message = f'({response.status_code}) {codename}; {response.url} {errtext}'
             if response.status_code == 401:
                 raise Unauthorized(message)
             elif response.status_code == 404:
@@ -195,7 +201,7 @@ class MyPlexAccount(PlexObject):
         for resource in self.resources():
             if resource.name.lower() == name.lower():
                 return resource
-        raise NotFound('Unable to find resource %s' % name)
+        raise NotFound(f'Unable to find resource {name}')
 
     def resources(self):
         """ Returns a list of all :class:`~plexapi.myplex.MyPlexResource` objects connected to the server. """
@@ -366,7 +372,8 @@ class MyPlexAccount(PlexObject):
         """ Remove the specified user from your friends.
 
             Parameters:
-                user (str): :class:`~plexapi.myplex.MyPlexUser`, username, or email of the user to be removed.
+                user (:class:`~plexapi.myplex.MyPlexUser` or str): :class:`~plexapi.myplex.MyPlexUser`,
+                    username, or email of the user to be removed.
         """
         user = user if isinstance(user, MyPlexUser) else self.user(user)
         url = self.FRIENDUPDATE.format(userId=user.id)
@@ -376,17 +383,89 @@ class MyPlexAccount(PlexObject):
         """ Remove the specified user from your home users.
 
             Parameters:
-                user (str): :class:`~plexapi.myplex.MyPlexUser`, username, or email of the user to be removed.
+                user (:class:`~plexapi.myplex.MyPlexUser` or str): :class:`~plexapi.myplex.MyPlexUser`,
+                    username, or email of the user to be removed.
         """
         user = user if isinstance(user, MyPlexUser) else self.user(user)
-        url = self.REMOVEHOMEUSER.format(userId=user.id)
+        url = self.HOMEUSER.format(userId=user.id)
         return self.query(url, self._session.delete)
 
-    def acceptInvite(self, user):
-        """ Accept a pending firend invite from the specified user.
+    def switchHomeUser(self, user):
+        """ Returns a new :class:`~plexapi.myplex.MyPlexAccount` object switched to the given home user.
 
             Parameters:
-                user (str): :class:`~plexapi.myplex.MyPlexInvite`, username, or email of the friend invite to accept.
+                user (:class:`~plexapi.myplex.MyPlexUser` or str): :class:`~plexapi.myplex.MyPlexUser`,
+                    username, or email of the home user to switch to.
+
+            Example:
+
+                .. code-block:: python
+
+                    from plexapi.myplex import MyPlexAccount
+                    # Login to a Plex Home account
+                    account = MyPlexAccount('<USERNAME>', '<PASSWORD>')
+                    # Switch to a different Plex Home user
+                    userAccount = account.switchHomeUser('Username')
+
+        """
+        user = user if isinstance(user, MyPlexUser) else self.user(user)
+        url = f'{self.HOMEUSERS}/{user.id}/switch'
+        data = self.query(url, self._session.post)
+        userToken = data.attrib.get('authenticationToken')
+        return MyPlexAccount(token=userToken)
+
+    def setPin(self, newPin, currentPin=None):
+        """ Set a new Plex Home PIN for the account.
+
+            Parameters:
+                newPin (str): New PIN to set for the account.
+                currentPin (str): Current PIN for the account (required to change the PIN).
+        """
+        url = self.HOMEUSER.format(userId=self.id)
+        params = {'pin': newPin}
+        if currentPin:
+            params['currentPin'] = currentPin
+        return self.query(url, self._session.put, params=params)
+
+    def removePin(self, currentPin):
+        """ Remove the Plex Home PIN for the account.
+
+            Parameters:
+                currentPin (str): Current PIN for the account (required to remove the PIN).
+        """
+        return self.setPin('', currentPin)
+
+    def setManagedUserPin(self, user, newPin):
+        """ Set a new Plex Home PIN for a managed home user. This must be done from the Plex Home admin account.
+
+            Parameters:
+                user (:class:`~plexapi.myplex.MyPlexUser` or str): :class:`~plexapi.myplex.MyPlexUser`
+                    or username of the managed home user.
+                newPin (str): New PIN to set for the managed home user.
+        """
+        user = user if isinstance(user, MyPlexUser) else self.user(user)
+        url = self.MANAGEDHOMEUSER.format(userId=user.id)
+        params = {'pin': newPin}
+        return self.query(url, self._session.post, params=params)
+
+    def removeManagedUserPin(self, user):
+        """ Remove the Plex Home PIN for a managed home user. This must be done from the Plex Home admin account.
+
+            Parameters:
+                user (:class:`~plexapi.myplex.MyPlexUser` or str): :class:`~plexapi.myplex.MyPlexUser`
+                    or username of the managed home user.
+        """
+        user = user if isinstance(user, MyPlexUser) else self.user(user)
+        url = self.MANAGEDHOMEUSER.format(userId=user.id)
+        params = {'removePin': 1}
+        return self.query(url, self._session.post, params=params)
+
+    def acceptInvite(self, user):
+        """ Accept a pending friend invite from the specified user.
+
+            Parameters:
+                user (:class:`~plexapi.myplex.MyPlexInvite` or str): :class:`~plexapi.myplex.MyPlexInvite`,
+                    username, or email of the friend invite to accept.
         """
         invite = user if isinstance(user, MyPlexInvite) else self.pendingInvite(user, includeSent=False)
         params = {
@@ -394,14 +473,15 @@ class MyPlexAccount(PlexObject):
             'home': int(invite.home),
             'server': int(invite.server)
         }
-        url = MyPlexInvite.REQUESTS + '/%s' % invite.id + utils.joinArgs(params)
+        url = MyPlexInvite.REQUESTS + f'/{invite.id}' + utils.joinArgs(params)
         return self.query(url, self._session.put)
 
     def cancelInvite(self, user):
         """ Cancel a pending firend invite for the specified user.
 
             Parameters:
-                user (str): :class:`~plexapi.myplex.MyPlexInvite`, username, or email of the friend invite to cancel.
+                user (:class:`~plexapi.myplex.MyPlexInvite` or str): :class:`~plexapi.myplex.MyPlexInvite`,
+                    username, or email of the friend invite to cancel.
         """
         invite = user if isinstance(user, MyPlexInvite) else self.pendingInvite(user, includeReceived=False)
         params = {
@@ -409,7 +489,7 @@ class MyPlexAccount(PlexObject):
             'home': int(invite.home),
             'server': int(invite.server)
         }
-        url = MyPlexInvite.REQUESTED + '/%s' % invite.id + utils.joinArgs(params)
+        url = MyPlexInvite.REQUESTED + f'/{invite.id}' + utils.joinArgs(params)
         return self.query(url, self._session.delete)
 
     def updateFriend(self, user, server, sections=None, removeSections=False, allowSync=None, allowCameraUpload=None,
@@ -497,7 +577,7 @@ class MyPlexAccount(PlexObject):
                     (user.username.lower(), user.email.lower(), str(user.id))):
                 return user
 
-        raise NotFound('Unable to find user %s' % username)
+        raise NotFound(f'Unable to find user {username}')
 
     def users(self):
         """ Returns a list of all :class:`~plexapi.myplex.MyPlexUser` objects connected to your account.
@@ -520,7 +600,7 @@ class MyPlexAccount(PlexObject):
                     (invite.username.lower(), invite.email.lower(), str(invite.id))):
                 return invite
         
-        raise NotFound('Unable to find invite %s' % username)
+        raise NotFound(f'Unable to find invite {username}')
 
     def pendingInvites(self, includeSent=True, includeReceived=True):
         """ Returns a list of all :class:`~plexapi.myplex.MyPlexInvite` objects connected to your account.
@@ -545,7 +625,7 @@ class MyPlexAccount(PlexObject):
         # Get a list of all section ids for looking up each section.
         allSectionIds = {}
         machineIdentifier = server.machineIdentifier if isinstance(server, PlexServer) else server
-        url = self.PLEXSERVERS.replace('{machineId}', machineIdentifier)
+        url = self.PLEXSERVERS.format(machineId=machineIdentifier)
         data = self.query(url, self._session.get)
         for elem in data[0]:
             _id = utils.cast(int, elem.attrib.get('id'))
@@ -567,8 +647,8 @@ class MyPlexAccount(PlexObject):
         values = []
         for key, vals in filterDict.items():
             if key not in ('contentRating', 'label', 'contentRating!', 'label!'):
-                raise BadRequest('Unknown filter key: %s', key)
-            values.append('%s=%s' % (key, '%2C'.join(vals)))
+                raise BadRequest(f'Unknown filter key: {key}')
+            values.append(f"{key}={'%2C'.join(vals)}")
         return '|'.join(values)
 
     def addWebhook(self, url):
@@ -579,12 +659,12 @@ class MyPlexAccount(PlexObject):
     def deleteWebhook(self, url):
         urls = copy.copy(self._webhooks)
         if url not in urls:
-            raise BadRequest('Webhook does not exist: %s' % url)
+            raise BadRequest(f'Webhook does not exist: {url}')
         urls.remove(url)
         return self.setWebhooks(urls)
 
     def setWebhooks(self, urls):
-        log.info('Setting webhooks: %s' % urls)
+        log.info('Setting webhooks: %s', urls)
         data = {'urls[]': urls} if len(urls) else {'urls': ''}
         data = self.query(self.WEBHOOKS, self._session.post, data=data)
         self._webhooks = self.listAttrs(data, 'url', etag='webhook')
@@ -655,7 +735,7 @@ class MyPlexAccount(PlexObject):
                     break
 
             if not client:
-                raise BadRequest('Unable to find client by clientId=%s', clientId)
+                raise BadRequest(f'Unable to find client by clientId={clientId}')
 
         if 'sync-target' not in client.provides:
             raise BadRequest("Received client doesn't provides sync-target")
@@ -694,7 +774,7 @@ class MyPlexAccount(PlexObject):
         if response.status_code not in (200, 201, 204):  # pragma: no cover
             codename = codes.get(response.status_code)[0]
             errtext = response.text.replace('\n', ' ')
-            raise BadRequest('(%s) %s %s; %s' % (response.status_code, codename, response.url, errtext))
+            raise BadRequest(f'({response.status_code}) {codename} {response.url}; {errtext}')
         return response.json()['token']
 
     def history(self, maxresults=9999999, mindate=None):
@@ -730,7 +810,7 @@ class MyPlexAccount(PlexObject):
         data = self.query(f'{self.MUSIC}/hubs')
         return self.findItems(data)
 
-    def watchlist(self, filter=None, sort=None, libtype=None, **kwargs):
+    def watchlist(self, filter=None, sort=None, libtype=None, maxresults=9999999, **kwargs):
         """ Returns a list of :class:`~plexapi.video.Movie` and :class:`~plexapi.video.Show` items in the user's watchlist.
             Note: The objects returned are from Plex's online metadata. To get the matching item on a Plex server,
             search for the media using the guid.
@@ -742,6 +822,7 @@ class MyPlexAccount(PlexObject):
                     ``titleSort`` (Title), ``originallyAvailableAt`` (Release Date), or ``rating`` (Critic Rating).
                     ``dir`` can be ``asc`` or ``desc``.
                 libtype (str, optional): 'movie' or 'show' to only return movies or shows, otherwise return all items.
+                maxresults (int, optional): Only return the specified number of results.
                 **kwargs (dict): Additional custom filters to apply to the search results.
 
 
@@ -769,9 +850,18 @@ class MyPlexAccount(PlexObject):
         if libtype:
             params['type'] = utils.searchType(libtype)
 
+        params['X-Plex-Container-Start'] = 0
+        params['X-Plex-Container-Size'] = min(X_PLEX_CONTAINER_SIZE, maxresults)
         params.update(kwargs)
-        data = self.query(f'{self.METADATA}/library/sections/watchlist/{filter}', params=params)
-        return self.findItems(data)
+
+        results, subresults = [], '_init'
+        while subresults and maxresults > len(results):
+            data = self.query(f'{self.METADATA}/library/sections/watchlist/{filter}', params=params)
+            subresults = self.findItems(data)
+            results += subresults[:maxresults - len(results)]
+            params['X-Plex-Container-Start'] += params['X-Plex-Container-Size']
+
+        return self._toOnlineMetadata(results)
 
     def onWatchlist(self, item):
         """ Returns True if the item is on the user's watchlist.
@@ -780,9 +870,7 @@ class MyPlexAccount(PlexObject):
                 item (:class:`~plexapi.video.Movie` or :class:`~plexapi.video.Show`): Item to check
                     if it is on the user's watchlist.
         """
-        ratingKey = item.guid.rsplit('/', 1)[-1]
-        data = self.query(f"{self.METADATA}/library/metadata/{ratingKey}/userState")
-        return bool(data.find('UserState').attrib.get('watchlistedAt'))
+        return bool(self.userState(item).watchlistedAt)
 
     def addToWatchlist(self, items):
         """ Add media items to the user's watchlist
@@ -800,9 +888,10 @@ class MyPlexAccount(PlexObject):
         
         for item in items:
             if self.onWatchlist(item):
-                raise BadRequest('"%s" is already on the watchlist' % item.title)
+                raise BadRequest(f'"{item.title}" is already on the watchlist')
             ratingKey = item.guid.rsplit('/', 1)[-1]
             self.query(f'{self.METADATA}/actions/addToWatchlist?ratingKey={ratingKey}', method=self._session.put)
+        return self
 
     def removeFromWatchlist(self, items):
         """ Remove media items from the user's watchlist
@@ -820,33 +909,49 @@ class MyPlexAccount(PlexObject):
         
         for item in items:
             if not self.onWatchlist(item):
-                raise BadRequest('"%s" is not on the watchlist' % item.title)
+                raise BadRequest(f'"{item.title}" is not on the watchlist')
             ratingKey = item.guid.rsplit('/', 1)[-1]
             self.query(f'{self.METADATA}/actions/removeFromWatchlist?ratingKey={ratingKey}', method=self._session.put)
+        return self
 
-    def searchDiscover(self, query, limit=30):
+    def userState(self, item):
+        """ Returns a :class:`~plexapi.myplex.UserState` object for the specified item.
+
+            Parameters:
+                item (:class:`~plexapi.video.Movie` or :class:`~plexapi.video.Show`): Item to return the user state.
+        """
+        ratingKey = item.guid.rsplit('/', 1)[-1]
+        data = self.query(f"{self.METADATA}/library/metadata/{ratingKey}/userState")
+        return self.findItem(data, cls=UserState)
+
+    def searchDiscover(self, query, limit=30, libtype=None):
         """ Search for movies and TV shows in Discover.
             Returns a list of :class:`~plexapi.video.Movie` and :class:`~plexapi.video.Show` objects.
 
             Parameters:
                 query (str): Search query.
                 limit (int, optional): Limit to the specified number of results. Default 30.
+                libtype (str, optional): 'movie' or 'show' to only return movies or shows, otherwise return all items.
         """
+        libtypes = {'movie': 'movies', 'show': 'tv'}
+        libtype = libtypes.get(libtype, 'movies,tv')
+
         headers = {
             'Accept': 'application/json'
         }
         params = {
             'query': query,
             'limit ': limit,
-            'searchTypes': 'movies,tv',
+            'searchTypes': libtype,
             'includeMetadata': 1
         }
 
         data = self.query(f'{self.METADATA}/library/search', headers=headers, params=params)
-        searchResults = data['MediaContainer'].get('SearchResult', [])
+        searchResults = data['MediaContainer'].get('SearchResults', [])
+        searchResult = next((s.get('SearchResult', []) for s in searchResults if s.get('id') == 'external'), [])
 
         results = []
-        for result in searchResults:
+        for result in searchResult:
             metadata = result['Metadata']
             type = metadata['type']
             if type == 'movie':
@@ -859,7 +964,33 @@ class MyPlexAccount(PlexObject):
             xml = f'<{tag} {attrs}/>'
             results.append(self._manuallyLoadXML(xml))
 
-        return results
+        return self._toOnlineMetadata(results)
+
+    @property
+    def viewStateSync(self):
+        """ Returns True or False if syncing of watch state and ratings
+            is enabled or disabled, respectively, for the account.
+        """
+        headers = {'Accept': 'application/json'}
+        data = self.query(self.VIEWSTATESYNC, headers=headers)
+        return data.get('consent')
+
+    def enableViewStateSync(self):
+        """ Enable syncing of watch state and ratings for the account. """
+        self._updateViewStateSync(True)
+
+    def disableViewStateSync(self):
+        """ Disable syncing of watch state and ratings for the account. """
+        self._updateViewStateSync(False)
+
+    def _updateViewStateSync(self, consent):
+        """ Enable or disable syncing of watch state and ratings for the account.
+
+            Parameters:
+                consent (bool): True to enable, False to disable.
+        """
+        params = {'consent': consent}
+        self.query(self.VIEWSTATESYNC, method=self._session.put, params=params)
 
     def link(self, pin):
         """ Link a device to the account using a pin code.
@@ -874,6 +1005,26 @@ class MyPlexAccount(PlexObject):
         data = {'code': pin}
         self.query(self.LINK, self._session.put, headers=headers, data=data)
 
+    def _toOnlineMetadata(self, objs):
+        """ Convert a list of media objects to online metadata objects. """
+        # TODO: Add proper support for metadata.provider.plex.tv
+        # Temporary workaround to allow reloading and browsing of online media objects
+        server = PlexServer(self.METADATA, self._token)
+
+        if not isinstance(objs, list):
+            objs = [objs]
+        for obj in objs:
+            obj._server = server
+
+            # Parse details key to modify query string
+            url = urlsplit(obj._details_key)
+            query = dict(parse_qsl(url.query))
+            query['includeUserState'] = 1
+            query.pop('includeFields', None)
+            obj._details_key = urlunsplit((url.scheme, url.netloc, url.path, urlencode(query), url.fragment))
+
+        return objs
+
 
 class MyPlexUser(PlexObject):
     """ This object represents non-signed in users such as friends and linked
@@ -937,7 +1088,7 @@ class MyPlexUser(PlexObject):
                 if utils.cast(int, item.attrib.get('userID')) == self.id:
                     return item.attrib.get('accessToken')
         except Exception:
-            log.exception('Failed to get access token for %s' % self.title)
+            log.exception('Failed to get access token for %s', self.title)
 
     def server(self, name):
         """ Returns the :class:`~plexapi.myplex.MyPlexServerShare` that matches the name specified.
@@ -949,7 +1100,7 @@ class MyPlexUser(PlexObject):
             if name.lower() == server.name.lower():
                 return server
 
-        raise NotFound('Unable to find server %s' % name)
+        raise NotFound(f'Unable to find server {name}')
 
     def history(self, maxresults=9999999, mindate=None):
         """ Get all Play History for a user in all shared servers.
@@ -1077,7 +1228,7 @@ class MyPlexServerShare(PlexObject):
             if name.lower() == section.title.lower():
                 return section
 
-        raise NotFound('Unable to find section %s' % name)
+        raise NotFound(f'Unable to find section {name}')
 
     def sections(self):
         """ Returns a list of all :class:`~plexapi.myplex.Section` objects shared with this user.
@@ -1158,7 +1309,6 @@ class MyPlexResource(PlexObject):
     def preferred_connections(
         self,
         ssl=None,
-        timeout=None,
         locations=DEFAULT_LOCATION_ORDER,
         schemes=DEFAULT_SCHEME_ORDER,
     ):
@@ -1170,7 +1320,6 @@ class MyPlexResource(PlexObject):
                 ssl (bool, optional): Set True to only connect to HTTPS connections. Set False to
                     only connect to HTTP connections. Set None (default) to connect to any
                     HTTP or HTTPS connection.
-                timeout (int, optional): The timeout in seconds to attempt each connection.
         """
         connections_dict = {location: {scheme: [] for scheme in schemes} for location in locations}
         for connection in self.connections:
@@ -1212,7 +1361,7 @@ class MyPlexResource(PlexObject):
             Raises:
                 :exc:`~plexapi.exceptions.NotFound`: When unable to connect to any addresses for this resource.
         """
-        connections = self.preferred_connections(ssl, timeout, locations, schemes)
+        connections = self.preferred_connections(ssl, locations, schemes)
         # Try connecting to all known resource connections in parallel, but
         # only return the first server (in order) that provides a response.
         cls = PlexServer if 'server' in self.provides else PlexClient
@@ -1244,7 +1393,7 @@ class ResourceConnection(PlexObject):
         self.port = utils.cast(int, data.attrib.get('port'))
         self.uri = data.attrib.get('uri')
         self.local = utils.cast(bool, data.attrib.get('local'))
-        self.httpuri = 'http://%s:%s' % (self.address, self.port)
+        self.httpuri = f'http://{self.address}:{self.port}'
         self.relay = utils.cast(bool, data.attrib.get('relay'))
 
 
@@ -1318,7 +1467,7 @@ class MyPlexDevice(PlexObject):
 
     def delete(self):
         """ Remove this device from your account. """
-        key = 'https://plex.tv/devices/%s.xml' % self.id
+        key = f'https://plex.tv/devices/{self.id}.xml'
         self._server.query(key, self._server._session.delete)
 
     def syncItems(self):
@@ -1355,11 +1504,12 @@ class MyPlexPinLogin:
             session (requests.Session, optional): Use your own session object if you want to
                 cache the http responses from PMS
             requestTimeout (int): timeout in seconds on initial connect to plex.tv (default config.TIMEOUT).
+            headers (dict): A dict of X-Plex headers to send with requests.
+            oauth (bool): True to use Plex OAuth instead of PIN login.
 
         Attributes:
             PINS (str): 'https://plex.tv/api/v2/pins'
             CHECKPINS (str): 'https://plex.tv/api/v2/pins/{pinid}'
-            LINK (str): 'https://plex.tv/api/v2/pins/link'
             POLLINTERVAL (int): 1
             finished (bool): Whether the pin login has finished or not.
             expired (bool): Whether the pin login has expired or not.
@@ -1370,12 +1520,13 @@ class MyPlexPinLogin:
     CHECKPINS = 'https://plex.tv/api/v2/pins/{pinid}'  # get
     POLLINTERVAL = 1
 
-    def __init__(self, session=None, requestTimeout=None, headers=None):
+    def __init__(self, session=None, requestTimeout=None, headers=None, oauth=False):
         super(MyPlexPinLogin, self).__init__()
         self._session = session or requests.Session()
         self._requestTimeout = requestTimeout or TIMEOUT
         self.headers = headers
 
+        self._oauth = oauth
         self._loginTimeout = None
         self._callback = None
         self._thread = None
@@ -1390,8 +1541,36 @@ class MyPlexPinLogin:
 
     @property
     def pin(self):
+        """ Return the 4 character PIN used for linking a device at https://plex.tv/link. """
+        if self._oauth:
+            raise BadRequest('Cannot use PIN for Plex OAuth login')
         return self._code
 
+    def oauthUrl(self, forwardUrl=None):
+        """ Return the Plex OAuth url for login.
+
+            Parameters:
+                forwardUrl (str, optional): The url to redirect the client to after login.
+        """
+        if not self._oauth:
+            raise BadRequest('Must use "MyPlexPinLogin(oauth=True)" for Plex OAuth login.')
+
+        headers = self._headers()
+        params = {
+            'clientID': headers['X-Plex-Client-Identifier'],
+            'context[device][product]': headers['X-Plex-Product'],
+            'context[device][version]': headers['X-Plex-Version'],
+            'context[device][platform]': headers['X-Plex-Platform'],
+            'context[device][platformVersion]': headers['X-Plex-Platform-Version'],
+            'context[device][device]': headers['X-Plex-Device'],
+            'context[device][deviceName]': headers['X-Plex-Device-Name'],
+            'code': self._code
+        }
+        if forwardUrl:
+            params['forwardUrl'] = forwardUrl
+
+        return f'https://app.plex.tv/auth/#!?{urlencode(params)}'
+
     def run(self, callback=None, timeout=None):
         """ Starts the thread which monitors the PIN login state.
             Parameters:
@@ -1455,7 +1634,13 @@ class MyPlexPinLogin:
 
     def _getCode(self):
         url = self.PINS
-        response = self._query(url, self._session.post)
+
+        if self._oauth:
+            params = {'strong': True}
+        else:
+            params = None
+
+        response = self._query(url, self._session.post, params=params)
         if not response:
             return None
 
@@ -1520,7 +1705,7 @@ class MyPlexPinLogin:
         if not response.ok:  # pragma: no cover
             codename = codes.get(response.status_code)[0]
             errtext = response.text.replace('\n', ' ')
-            raise BadRequest('(%s) %s %s; %s' % (response.status_code, codename, response.url, errtext))
+            raise BadRequest(f'({response.status_code}) {codename} {response.url}; {errtext}')
         data = response.text.encode('utf8')
         return ElementTree.fromstring(data) if data.strip() else None
 
@@ -1564,7 +1749,7 @@ def _chooseConnection(ctype, name, results):
     if results:
         log.debug('Connecting to %s: %s?X-Plex-Token=%s', ctype, results[0]._baseurl, results[0]._token)
         return results[0]
-    raise NotFound('Unable to connect to %s: %s' % (ctype.lower(), name))
+    raise NotFound(f'Unable to connect to {ctype.lower()}: {name}')
 
 
 class AccountOptOut(PlexObject):
@@ -1593,8 +1778,8 @@ class AccountOptOut(PlexObject):
                 :exc:`~plexapi.exceptions.NotFound`: ``option`` str not found in CHOICES.
         """
         if option not in self.CHOICES:
-            raise NotFound('%s not found in available choices: %s' % (option, self.CHOICES))
-        url = self._server.OPTOUTS % {'userUUID': self._server.uuid}
+            raise NotFound(f'{option} not found in available choices: {self.CHOICES}')
+        url = self._server.OPTOUTS.format(userUUID=self._server.uuid)
         params = {'key': self.key, 'value': option}
         self._server.query(url, method=self._server._session.post, params=params)
         self.value = option  # assume query successful and set the value to option
@@ -1614,5 +1799,35 @@ class AccountOptOut(PlexObject):
                 :exc:`~plexapi.exceptions.BadRequest`: When trying to opt out music.
         """
         if self.key == 'tv.plex.provider.music':
-            raise BadRequest('%s does not have the option to opt out managed users.' % self.key)
+            raise BadRequest(f'{self.key} does not have the option to opt out managed users.')
         self._updateOptOut('opt_out_managed')
+
+
+class UserState(PlexObject):
+    """ Represents a single UserState
+
+        Attributes:
+            TAG (str): UserState
+            lastViewedAt (datetime): Datetime the item was last played.
+            ratingKey (str): Unique key identifying the item.
+            type (str): The media type of the item.
+            viewCount (int): Count of times the item was played.
+            viewedLeafCount (int): Number of items marked as played in the show/season.
+            viewOffset (int): Time offset in milliseconds from the start of the content
+            viewState (bool): True or False if the item has been played.
+            watchlistedAt (datetime): Datetime the item was added to the watchlist.
+    """
+    TAG = 'UserState'
+
+    def __repr__(self):
+        return f'<{self.__class__.__name__}:{self.ratingKey}>'
+
+    def _loadData(self, data):
+        self.lastViewedAt = utils.toDatetime(data.attrib.get('lastViewedAt'))
+        self.ratingKey = data.attrib.get('ratingKey')
+        self.type = data.attrib.get('type')
+        self.viewCount = utils.cast(int, data.attrib.get('viewCount', 0))
+        self.viewedLeafCount = utils.cast(int, data.attrib.get('viewedLeafCount', 0))
+        self.viewOffset = utils.cast(int, data.attrib.get('viewOffset', 0))
+        self.viewState = data.attrib.get('viewState') == 'complete'
+        self.watchlistedAt = utils.toDatetime(data.attrib.get('watchlistedAt'))
diff --git a/lib/plexapi/photo.py b/lib/plexapi/photo.py
index cb6329ea..28556650 100644
--- a/lib/plexapi/photo.py
+++ b/lib/plexapi/photo.py
@@ -3,7 +3,7 @@ import os
 from urllib.parse import quote_plus
 
 from plexapi import media, utils, video
-from plexapi.base import Playable, PlexPartialObject
+from plexapi.base import Playable, PlexPartialObject, PlexSession
 from plexapi.exceptions import BadRequest
 from plexapi.mixins import (
     RatingMixin,
@@ -79,12 +79,12 @@ class Photoalbum(
             Parameters:
                 title (str): Title of the photo album to return.
         """
-        key = '/library/metadata/%s/children' % self.ratingKey
+        key = f'{self.key}/children'
         return self.fetchItem(key, Photoalbum, title__iexact=title)
 
     def albums(self, **kwargs):
         """ Returns a list of :class:`~plexapi.photo.Photoalbum` objects in the album. """
-        key = '/library/metadata/%s/children' % self.ratingKey
+        key = f'{self.key}/children'
         return self.fetchItems(key, Photoalbum, **kwargs)
 
     def photo(self, title):
@@ -93,12 +93,12 @@ class Photoalbum(
             Parameters:
                 title (str): Title of the photo to return.
         """
-        key = '/library/metadata/%s/children' % self.ratingKey
+        key = f'{self.key}/children'
         return self.fetchItem(key, Photo, title__iexact=title)
 
     def photos(self, **kwargs):
         """ Returns a list of :class:`~plexapi.photo.Photo` objects in the album. """
-        key = '/library/metadata/%s/children' % self.ratingKey
+        key = f'{self.key}/children'
         return self.fetchItems(key, Photo, **kwargs)
 
     def clip(self, title):
@@ -107,12 +107,12 @@ class Photoalbum(
             Parameters:
                 title (str): Title of the clip to return.
         """
-        key = '/library/metadata/%s/children' % self.ratingKey
+        key = f'{self.key}/children'
         return self.fetchItem(key, video.Clip, title__iexact=title)
 
     def clips(self, **kwargs):
         """ Returns a list of :class:`~plexapi.video.Clip` objects in the album. """
-        key = '/library/metadata/%s/children' % self.ratingKey
+        key = f'{self.key}/children'
         return self.fetchItems(key, video.Clip, **kwargs)
 
     def get(self, title):
@@ -226,7 +226,7 @@ class Photo(
     def _prettyfilename(self):
         """ Returns a filename for use in download. """
         if self.parentTitle:
-            return '%s - %s' % (self.parentTitle, self.title)
+            return f'{self.parentTitle} - {self.title}'
         return self.title
 
     def photoalbum(self):
@@ -282,7 +282,7 @@ class Photo(
 
         section = self.section()
 
-        sync_item.location = 'library://%s/item/%s' % (section.uuid, quote_plus(self.key))
+        sync_item.location = f'library://{section.uuid}/item/{quote_plus(self.key)}'
         sync_item.policy = Policy.create(limit)
         sync_item.mediaSettings = MediaSettings.createPhoto(resolution)
 
@@ -291,3 +291,16 @@ class Photo(
     def _getWebURL(self, base=None):
         """ Get the Plex Web URL with the correct parameters. """
         return self._server._buildWebURL(base=base, endpoint='details', key=self.parentKey, legacy=1)
+
+
+@utils.registerPlexObject
+class PhotoSession(PlexSession, Photo):
+    """ Represents a single Photo session
+        loaded from :func:`~plexapi.server.PlexServer.sessions`.
+    """
+    _SESSIONTYPE = True
+
+    def _loadData(self, data):
+        """ Load attribute values from Plex XML response. """
+        Photo._loadData(self, data)
+        PlexSession._loadData(self, data)
diff --git a/lib/plexapi/playlist.py b/lib/plexapi/playlist.py
index 5241e261..b4174c84 100644
--- a/lib/plexapi/playlist.py
+++ b/lib/plexapi/playlist.py
@@ -127,7 +127,7 @@ class Playlist(
         for _item in self.items():
             if _item.ratingKey == item.ratingKey:
                 return _item.playlistItemID
-        raise NotFound('Item with title "%s" not found in the playlist' % item.title)
+        raise NotFound(f'Item with title "{item.title}" not found in the playlist')
 
     def filters(self):
         """ Returns the search filter dict for smart playlist.
@@ -177,14 +177,14 @@ class Playlist(
         for item in self.items():
             if item.title.lower() == title.lower():
                 return item
-        raise NotFound('Item with title "%s" not found in the playlist' % title)
+        raise NotFound(f'Item with title "{title}" not found in the playlist')
 
     def items(self):
         """ Returns a list of all items in the playlist. """
         if self.radio:
             return []
         if self._items is None:
-            key = '%s/items' % self.key
+            key = f'{self.key}/items'
             items = self.fetchItems(key)
             self._items = items
         return self._items
@@ -212,17 +212,17 @@ class Playlist(
         ratingKeys = []
         for item in items:
             if item.listType != self.playlistType:  # pragma: no cover
-                raise BadRequest('Can not mix media types when building a playlist: %s and %s' %
-                    (self.playlistType, item.listType))
+                raise BadRequest(f'Can not mix media types when building a playlist: '
+                                 f'{self.playlistType} and {item.listType}')
             ratingKeys.append(str(item.ratingKey))
 
         ratingKeys = ','.join(ratingKeys)
-        uri = '%s/library/metadata/%s' % (self._server._uriRoot(), ratingKeys)
+        uri = f'{self._server._uriRoot()}/library/metadata/{ratingKeys}'
 
-        key = '%s/items%s' % (self.key, utils.joinArgs({
-            'uri': uri
-        }))
+        args = {'uri': uri}
+        key = f"{self.key}/items{utils.joinArgs(args)}"
         self._server.query(key, method=self._server._session.put)
+        return self
 
     @deprecated('use "removeItems" instead', stacklevel=3)
     def removeItem(self, item):
@@ -247,8 +247,9 @@ class Playlist(
 
         for item in items:
             playlistItemID = self._getPlaylistItemID(item)
-            key = '%s/items/%s' % (self.key, playlistItemID)
+            key = f'{self.key}/items/{playlistItemID}'
             self._server.query(key, method=self._server._session.delete)
+        return self
 
     def moveItem(self, item, after=None):
         """ Move an item to a new position in the playlist.
@@ -267,13 +268,14 @@ class Playlist(
             raise BadRequest('Cannot move items in a smart playlist.')
 
         playlistItemID = self._getPlaylistItemID(item)
-        key = '%s/items/%s/move' % (self.key, playlistItemID)
+        key = f'{self.key}/items/{playlistItemID}/move'
 
         if after:
             afterPlaylistItemID = self._getPlaylistItemID(after)
-            key += '?after=%s' % afterPlaylistItemID
+            key += f'?after={afterPlaylistItemID}'
 
         self._server.query(key, method=self._server._session.put)
+        return self
 
     def updateFilters(self, limit=None, sort=None, filters=None, **kwargs):
         """ Update the filters for a smart playlist.
@@ -297,17 +299,18 @@ class Playlist(
         section = self.section()
         searchKey = section._buildSearchKey(
             sort=sort, libtype=section.METADATA_TYPE, limit=limit, filters=filters, **kwargs)
-        uri = '%s%s' % (self._server._uriRoot(), searchKey)
+        uri = f'{self._server._uriRoot()}{searchKey}'
 
-        key = '%s/items%s' % (self.key, utils.joinArgs({
-            'uri': uri
-        }))
+        args = {'uri': uri}
+        key = f"{self.key}/items{utils.joinArgs(args)}"
         self._server.query(key, method=self._server._session.put)
+        return self
 
     def _edit(self, **kwargs):
         """ Actually edit the playlist. """
-        key = '%s%s' % (self.key, utils.joinArgs(kwargs))
+        key = f'{self.key}{utils.joinArgs(kwargs)}'
         self._server.query(key, method=self._server._session.put)
+        return self
 
     def edit(self, title=None, summary=None):
         """ Edit the playlist.
@@ -321,7 +324,7 @@ class Playlist(
             args['title'] = title
         if summary:
             args['summary'] = summary
-        self._edit(**args)
+        return self._edit(**args)
 
     def delete(self):
         """ Delete the playlist. """
@@ -348,14 +351,10 @@ class Playlist(
             ratingKeys.append(str(item.ratingKey))
 
         ratingKeys = ','.join(ratingKeys)
-        uri = '%s/library/metadata/%s' % (server._uriRoot(), ratingKeys)
+        uri = f'{server._uriRoot()}/library/metadata/{ratingKeys}'
 
-        key = '/playlists%s' % utils.joinArgs({
-            'uri': uri,
-            'type': listType,
-            'title': title,
-            'smart': 0
-        })
+        args = {'uri': uri, 'type': listType, 'title': title, 'smart': 0}
+        key = f"/playlists{utils.joinArgs(args)}"
         data = server.query(key, method=server._session.post)[0]
         return cls(server, data, initpath=key)
 
@@ -369,14 +368,10 @@ class Playlist(
 
         searchKey = section._buildSearchKey(
             sort=sort, libtype=libtype, limit=limit, filters=filters, **kwargs)
-        uri = '%s%s' % (server._uriRoot(), searchKey)
+        uri = f'{server._uriRoot()}{searchKey}'
 
-        key = '/playlists%s' % utils.joinArgs({
-            'uri': uri,
-            'type': section.CONTENT_TYPE,
-            'title': title,
-            'smart': 1,
-        })
+        args = {'uri': uri, 'type': section.CONTENT_TYPE, 'title': title, 'smart': 1}
+        key = f"/playlists{utils.joinArgs(args)}"
         data = server.query(key, method=server._session.post)[0]
         return cls(server, data, initpath=key)
 
@@ -465,7 +460,7 @@ class Playlist(
         sync_item.metadataType = self.metadataType
         sync_item.machineIdentifier = self._server.machineIdentifier
 
-        sync_item.location = 'playlist:///%s' % quote_plus(self.guid)
+        sync_item.location = f'playlist:///{quote_plus(self.guid)}'
         sync_item.policy = Policy.create(limit, unwatched)
 
         if self.isVideo:
diff --git a/lib/plexapi/playqueue.py b/lib/plexapi/playqueue.py
index 6697532a..6f4646dc 100644
--- a/lib/plexapi/playqueue.py
+++ b/lib/plexapi/playqueue.py
@@ -3,7 +3,7 @@ from urllib.parse import quote_plus
 
 from plexapi import utils
 from plexapi.base import PlexObject
-from plexapi.exceptions import BadRequest, Unsupported
+from plexapi.exceptions import BadRequest
 
 
 class PlayQueue(PlexObject):
@@ -13,7 +13,7 @@ class PlayQueue(PlexObject):
         TAG (str): 'PlayQueue'
         TYPE (str): 'playqueue'
         identifier (str): com.plexapp.plugins.library
-        items (list): List of :class:`~plexapi.media.Media` or :class:`~plexapi.playlist.Playlist`
+        items (list): List of :class:`~plexapi.base.Playable` or :class:`~plexapi.playlist.Playlist`
         mediaTagPrefix (str): Fx /system/bundle/media/flags/
         mediaTagVersion (int): Fx 1485957738
         playQueueID (int): ID of the PlayQueue.
@@ -27,7 +27,7 @@ class PlayQueue(PlexObject):
         playQueueSourceURI (str): Original URI used to create the PlayQueue.
         playQueueTotalCount (int): How many items in the PlayQueue.
         playQueueVersion (int): Version of the PlayQueue. Increments every time a change is made to the PlayQueue.
-        selectedItem (:class:`~plexapi.media.Media`): Media object for the currently selected item.
+        selectedItem (:class:`~plexapi.base.Playable`): Media object for the currently selected item.
         _server (:class:`~plexapi.server.PlexServer`): PlexServer associated with the PlayQueue.
         size (int): Alias for playQueueTotalCount.
     """
@@ -90,10 +90,10 @@ class PlayQueue(PlexObject):
             return matches[0]
         elif len(matches) > 1:
             raise BadRequest(
-                "{item} occurs multiple times in this PlayQueue, provide exact item".format(item=item)
+                f"{item} occurs multiple times in this PlayQueue, provide exact item"
             )
         else:
-            raise BadRequest("{item} not valid for this PlayQueue".format(item=item))
+            raise BadRequest(f"{item} not valid for this PlayQueue")
 
     @classmethod
     def get(
@@ -128,7 +128,7 @@ class PlayQueue(PlexObject):
         if center:
             args["center"] = center
 
-        path = "/playQueues/{playQueueID}{args}".format(playQueueID=playQueueID, args=utils.joinArgs(args))
+        path = f"/playQueues/{playQueueID}{utils.joinArgs(args)}"
         data = server.query(path, method=server._session.get)
         c = cls(server, data, initpath=path)
         c._server = server
@@ -150,9 +150,9 @@ class PlayQueue(PlexObject):
 
         Parameters:
             server (:class:`~plexapi.server.PlexServer`): Server you are connected to.
-            items (:class:`~plexapi.media.Media` or :class:`~plexapi.playlist.Playlist`):
+            items (:class:`~plexapi.base.Playable` or :class:`~plexapi.playlist.Playlist`):
                 A media item, list of media items, or Playlist.
-            startItem (:class:`~plexapi.media.Media`, optional):
+            startItem (:class:`~plexapi.base.Playable`, optional):
                 Media item in the PlayQueue where playback should begin.
             shuffle (int, optional): Start the playqueue shuffled.
             repeat (int, optional): Start the playqueue shuffled.
@@ -171,8 +171,8 @@ class PlayQueue(PlexObject):
 
         if isinstance(items, list):
             item_keys = ",".join([str(x.ratingKey) for x in items])
-            uri_args = quote_plus("/library/metadata/{item_keys}".format(item_keys=item_keys))
-            args["uri"] = "library:///directory/{uri_args}".format(uri_args=uri_args)
+            uri_args = quote_plus(f"/library/metadata/{item_keys}")
+            args["uri"] = f"library:///directory/{uri_args}"
             args["type"] = items[0].listType
         elif items.type == "playlist":
             args["type"] = items.playlistType
@@ -183,15 +183,14 @@ class PlayQueue(PlexObject):
         else:
             uuid = items.section().uuid
             args["type"] = items.listType
-            args["uri"] = "library://{uuid}/item/{key}".format(uuid=uuid, key=items.key)
+            args["uri"] = f"library://{uuid}/item/{items.key}"
 
         if startItem:
             args["key"] = startItem.key
 
-        path = "/playQueues{args}".format(args=utils.joinArgs(args))
+        path = f"/playQueues{utils.joinArgs(args)}"
         data = server.query(path, method=server._session.post)
         c = cls(server, data, initpath=path)
-        c.playQueueType = args["type"]
         c._server = server
         return c
 
@@ -227,7 +226,6 @@ class PlayQueue(PlexObject):
         path = f"/playQueues{utils.joinArgs(args)}"
         data = server.query(path, method=server._session.post)
         c = cls(server, data, initpath=path)
-        c.playQueueType = args["type"]
         c._server = server
         return c
 
@@ -237,7 +235,7 @@ class PlayQueue(PlexObject):
         Items can only be added to the section immediately following the current playing item.
 
         Parameters:
-            item (:class:`~plexapi.media.Media` or :class:`~plexapi.playlist.Playlist`): Single media item or Playlist.
+            item (:class:`~plexapi.base.Playable` or :class:`~plexapi.playlist.Playlist`): Single media item or Playlist.
             playNext (bool, optional): If True, add this item to the front of the "Up Next" section.
                 If False, the item will be appended to the end of the "Up Next" section.
                 Only has an effect if an item has already been added to the "Up Next" section.
@@ -250,21 +248,17 @@ class PlayQueue(PlexObject):
         args = {}
         if item.type == "playlist":
             args["playlistID"] = item.ratingKey
-            itemType = item.playlistType
         else:
             uuid = item.section().uuid
-            itemType = item.listType
-            args["uri"] = "library://{uuid}/item{key}".format(uuid=uuid, key=item.key)
-
-        if itemType != self.playQueueType:
-            raise Unsupported("Item type does not match PlayQueue type")
+            args["uri"] = f"library://{uuid}/item{item.key}"
 
         if playNext:
             args["next"] = 1
 
-        path = "/playQueues/{playQueueID}{args}".format(playQueueID=self.playQueueID, args=utils.joinArgs(args))
+        path = f"/playQueues/{self.playQueueID}{utils.joinArgs(args)}"
         data = self._server.query(path, method=self._server._session.put)
         self._loadData(data)
+        return self
 
     def moveItem(self, item, after=None, refresh=True):
         """
@@ -290,11 +284,10 @@ class PlayQueue(PlexObject):
                 after = self.getQueueItem(after)
             args["after"] = after.playQueueItemID
 
-        path = "/playQueues/{playQueueID}/items/{playQueueItemID}/move{args}".format(
-            playQueueID=self.playQueueID, playQueueItemID=item.playQueueItemID, args=utils.joinArgs(args)
-        )
+        path = f"/playQueues/{self.playQueueID}/items/{item.playQueueItemID}/move{utils.joinArgs(args)}"
         data = self._server.query(path, method=self._server._session.put)
         self._loadData(data)
+        return self
 
     def removeItem(self, item, refresh=True):
         """Remove an item from the PlayQueue.
@@ -309,20 +302,21 @@ class PlayQueue(PlexObject):
         if item not in self:
             item = self.getQueueItem(item)
 
-        path = "/playQueues/{playQueueID}/items/{playQueueItemID}".format(
-            playQueueID=self.playQueueID, playQueueItemID=item.playQueueItemID
-        )
+        path = f"/playQueues/{self.playQueueID}/items/{item.playQueueItemID}"
         data = self._server.query(path, method=self._server._session.delete)
         self._loadData(data)
+        return self
 
     def clear(self):
         """Remove all items from the PlayQueue."""
-        path = "/playQueues/{playQueueID}/items".format(playQueueID=self.playQueueID)
+        path = f"/playQueues/{self.playQueueID}/items"
         data = self._server.query(path, method=self._server._session.delete)
         self._loadData(data)
+        return self
 
     def refresh(self):
         """Refresh the PlayQueue from the Plex server."""
-        path = "/playQueues/{playQueueID}".format(playQueueID=self.playQueueID)
+        path = f"/playQueues/{self.playQueueID}"
         data = self._server.query(path, method=self._server._session.get)
         self._loadData(data)
+        return self
diff --git a/lib/plexapi/server.py b/lib/plexapi/server.py
index e5c36ad6..168efd40 100644
--- a/lib/plexapi/server.py
+++ b/lib/plexapi/server.py
@@ -171,7 +171,7 @@ class PlexServer(PlexObject):
         return headers
 
     def _uriRoot(self):
-        return 'server://%s/com.plexapp.plugins.library' % self.machineIdentifier
+        return f'server://{self.machineIdentifier}/com.plexapp.plugins.library'
 
     @property
     def library(self):
@@ -232,7 +232,7 @@ class PlexServer(PlexObject):
         """ Returns a list of :class:`~plexapi.media.Agent` objects this server has available. """
         key = '/system/agents'
         if mediaType:
-            key += '?mediaType=%s' % utils.searchType(mediaType)
+            key += f'?mediaType={utils.searchType(mediaType)}'
         return self.fetchItems(key)
 
     def createToken(self, type='delegation', scope='all'):
@@ -240,7 +240,7 @@ class PlexServer(PlexObject):
         if not self._token:
             # Handle unclaimed servers
             return None
-        q = self.query('/security/token?type=%s&scope=%s' % (type, scope))
+        q = self.query(f'/security/token?type={type}&scope={scope}')
         return q.attrib.get('token')
 
     def switchUser(self, username, session=None, timeout=None):
@@ -291,7 +291,7 @@ class PlexServer(PlexObject):
         try:
             return next(account for account in self.systemAccounts() if account.id == accountID)
         except StopIteration:
-            raise NotFound('Unknown account with accountID=%s' % accountID) from None
+            raise NotFound(f'Unknown account with accountID={accountID}') from None
 
     def systemDevices(self):
         """ Returns a list of :class:`~plexapi.server.SystemDevice` objects this server contains. """
@@ -309,7 +309,7 @@ class PlexServer(PlexObject):
         try:
             return next(device for device in self.systemDevices() if device.id == deviceID)
         except StopIteration:
-            raise NotFound('Unknown device with deviceID=%s' % deviceID) from None
+            raise NotFound(f'Unknown device with deviceID={deviceID}') from None
 
     def myPlexAccount(self):
         """ Returns a :class:`~plexapi.myplex.MyPlexAccount` object using the same
@@ -351,7 +351,7 @@ class PlexServer(PlexObject):
             key = path.key
         elif path is not None:
             base64path = utils.base64str(path)
-            key = '/services/browse/%s' % base64path
+            key = f'/services/browse/{base64path}'
         else:
             key = '/services/browse'
         if includeFiles:
@@ -406,7 +406,7 @@ class PlexServer(PlexObject):
                 log.warning('%s did not advertise a port, checking plex.tv.', elem.attrib.get('name'))
                 ports = self._myPlexClientPorts() if ports is None else ports
                 port = ports.get(elem.attrib.get('machineIdentifier'))
-            baseurl = 'http://%s:%s' % (elem.attrib['host'], port)
+            baseurl = f"http://{elem.attrib['host']}:{port}"
             items.append(PlexClient(baseurl=baseurl, server=self,
                                     token=self._token, data=elem, connect=False))
 
@@ -425,7 +425,7 @@ class PlexServer(PlexObject):
             if client and client.title == name:
                 return client
 
-        raise NotFound('Unknown client name: %s' % name)
+        raise NotFound(f'Unknown client name: {name}')
 
     def createCollection(self, title, section, items=None, smart=False, limit=None,
                          libtype=None, sort=None, filters=None, **kwargs):
@@ -547,6 +547,7 @@ class PlexServer(PlexObject):
                 f'Invalid butler task: {task}. Available tasks are: {validTasks}'
             )
         self.query(f'/butler/{task}', method=self._session.post)
+        return self
 
     @deprecated('use "checkForUpdate" instead')
     def check_for_update(self, force=True, download=False):
@@ -559,7 +560,7 @@ class PlexServer(PlexObject):
                 force (bool): Force server to check for new releases
                 download (bool): Download if a update is available.
         """
-        part = '/updater/check?download=%s' % (1 if download else 0)
+        part = f'/updater/check?download={1 if download else 0}'
         if force:
             self.query(part, method=self._session.put)
         releases = self.fetchItems('/updater/status')
@@ -608,7 +609,7 @@ class PlexServer(PlexObject):
         args['X-Plex-Container-Start'] = 0
         args['X-Plex-Container-Size'] = min(X_PLEX_CONTAINER_SIZE, maxresults)
         while subresults and maxresults > len(results):
-            key = '/status/sessions/history/all%s' % utils.joinArgs(args)
+            key = f'/status/sessions/history/all{utils.joinArgs(args)}'
             subresults = self.fetchItems(key)
             results += subresults[:maxresults - len(results)]
             args['X-Plex-Container-Start'] += args['X-Plex-Container-Size']
@@ -635,7 +636,7 @@ class PlexServer(PlexObject):
             # TODO: Automatically retrieve and validate sort field similar to LibrarySection.search()
             args['sort'] = sort
 
-        key = '/playlists%s' % utils.joinArgs(args)
+        key = f'/playlists{utils.joinArgs(args)}'
         return self.fetchItems(key, **kwargs)
 
     def playlist(self, title):
@@ -650,7 +651,7 @@ class PlexServer(PlexObject):
         try:
             return self.playlists(title=title, title__iexact=title)[0]
         except IndexError:
-            raise NotFound('Unable to find playlist with title "%s".' % title) from None
+            raise NotFound(f'Unable to find playlist with title "{title}".') from None
 
     def optimizedItems(self, removeAll=None):
         """ Returns list of all :class:`~plexapi.media.Optimized` objects connected to server. """
@@ -659,7 +660,7 @@ class PlexServer(PlexObject):
             self.query(key, method=self._server._session.delete)
         else:
             backgroundProcessing = self.fetchItem('/playlists?type=42')
-            return self.fetchItems('%s/items' % backgroundProcessing.key, cls=Optimized)
+            return self.fetchItems(f'{backgroundProcessing.key}/items', cls=Optimized)
 
     @deprecated('use "plexapi.media.Optimized.items()" instead')
     def optimizedItem(self, optimizedID):
@@ -668,7 +669,7 @@ class PlexServer(PlexObject):
         """
 
         backgroundProcessing = self.fetchItem('/playlists?type=42')
-        return self.fetchItem('%s/items/%s/items' % (backgroundProcessing.key, optimizedID))
+        return self.fetchItem(f'{backgroundProcessing.key}/items/{optimizedID}/items')
 
     def conversions(self, pause=None):
         """ Returns list of all :class:`~plexapi.media.Conversion` objects connected to server. """
@@ -697,7 +698,7 @@ class PlexServer(PlexObject):
         if response.status_code not in (200, 201, 204):
             codename = codes.get(response.status_code)[0]
             errtext = response.text.replace('\n', ' ')
-            message = '(%s) %s; %s %s' % (response.status_code, codename, response.url, errtext)
+            message = f'({response.status_code}) {codename}; {response.url} {errtext}'
             if response.status_code == 401:
                 raise Unauthorized(message)
             elif response.status_code == 404:
@@ -736,7 +737,7 @@ class PlexServer(PlexObject):
             params['limit'] = limit
         if sectionId:
             params['sectionId'] = sectionId
-        key = '/hubs/search?%s' % urlencode(params)
+        key = f'/hubs/search?{urlencode(params)}'
         for hub in self.fetchItems(key, Hub):
             if mediatype:
                 if hub.type == mediatype:
@@ -753,21 +754,27 @@ class PlexServer(PlexObject):
         """ Returns a list of all active :class:`~plexapi.media.TranscodeSession` objects. """
         return self.fetchItems('/transcode/sessions')
 
-    def startAlertListener(self, callback=None):
+    def startAlertListener(self, callback=None, callbackError=None):
         """ Creates a websocket connection to the Plex Server to optionally receive
             notifications. These often include messages from Plex about media scans
             as well as updates to currently running Transcode Sessions.
 
-            NOTE: You need websocket-client installed in order to use this feature.
-            >> pip install websocket-client
+            Returns a new :class:`~plexapi.alert.AlertListener` object.
+
+            Note: ``websocket-client`` must be installed in order to use this feature.
+
+            .. code-block:: python
+
+                >> pip install websocket-client
 
             Parameters:
                 callback (func): Callback function to call on received messages.
+                callbackError (func): Callback function to call on errors.
 
             Raises:
                 :exc:`~plexapi.exception.Unsupported`: Websocket-client not installed.
         """
-        notifier = AlertListener(self, callback)
+        notifier = AlertListener(self, callback, callbackError)
         notifier.start()
         return notifier
 
@@ -809,7 +816,7 @@ class PlexServer(PlexObject):
         if imageFormat is not None:
             params['format'] = imageFormat.lower()
 
-        key = '/photo/:/transcode%s' % utils.joinArgs(params)
+        key = f'/photo/:/transcode{utils.joinArgs(params)}'
         return self.url(key, includeToken=True)
 
     def url(self, key, includeToken=None):
@@ -818,8 +825,8 @@ class PlexServer(PlexObject):
         """
         if self._token and (includeToken or self._showSecrets):
             delim = '&' if '?' in key else '?'
-            return '%s%s%sX-Plex-Token=%s' % (self._baseurl, key, delim, self._token)
-        return '%s%s' % (self._baseurl, key)
+            return f'{self._baseurl}{key}{delim}X-Plex-Token={self._token}'
+        return f'{self._baseurl}{key}'
 
     def refreshSynclist(self):
         """ Force PMS to download new SyncList from Plex.tv. """
@@ -853,7 +860,7 @@ class PlexServer(PlexObject):
             log.debug('Plex is currently not allowed to delete media. Toggle set to not allow, exiting.')
             raise BadRequest('Plex is currently not allowed to delete media. Toggle set to not allow, exiting.')
         value = 1 if toggle is True else 0
-        return self.query('/:/prefs?allowMediaDeletion=%s' % value, self._session.put)
+        return self.query(f'/:/prefs?allowMediaDeletion={value}', self._session.put)
 
     def bandwidth(self, timespan=None, **kwargs):
         """ Returns a list of :class:`~plexapi.server.StatisticsBandwidth` objects
@@ -904,8 +911,7 @@ class PlexServer(PlexObject):
                         gigabytes = round(bandwidth.bytes / 1024**3, 3)
                         local = 'local' if bandwidth.lan else 'remote'
                         date = bandwidth.at.strftime('%Y-%m-%d')
-                        print('%s used %s GB of %s bandwidth on %s from %s'
-                              % (account.name, gigabytes, local, date, device.name))
+                        print(f'{account.name} used {gigabytes} GB of {local} bandwidth on {date} from {device.name}')
 
         """
         params = {}
@@ -923,19 +929,19 @@ class PlexServer(PlexObject):
             try:
                 params['timespan'] = timespans[timespan]
             except KeyError:
-                raise BadRequest('Invalid timespan specified: %s. '
-                    'Available timespans: %s' % (timespan, ', '.join(timespans.keys())))
+                raise BadRequest(f"Invalid timespan specified: {timespan}. "
+                                 f"Available timespans: {', '.join(timespans.keys())}")
 
         filters = {'accountID', 'at', 'at<', 'at>', 'bytes', 'bytes<', 'bytes>', 'deviceID', 'lan'}
 
         for key, value in kwargs.items():
             if key not in filters:
-                raise BadRequest('Unknown filter: %s=%s' % (key, value))
+                raise BadRequest(f'Unknown filter: {key}={value}')
             if key.startswith('at'):
                 try:
                     value = utils.cast(int, value.timestamp())
                 except AttributeError:
-                    raise BadRequest('Time frame filter must be a datetime object: %s=%s' % (key, value))
+                    raise BadRequest(f'Time frame filter must be a datetime object: {key}={value}')
             elif key.startswith('bytes') or key == 'lan':
                 value = utils.cast(int, value)
             elif key == 'accountID':
@@ -943,7 +949,7 @@ class PlexServer(PlexObject):
                     value = 1  # The admin account is accountID=1
             params[key] = value
 
-        key = '/statistics/bandwidth?%s' % urlencode(params)
+        key = f'/statistics/bandwidth?{urlencode(params)}'
         return self.fetchItems(key, StatisticsBandwidth)
 
     def resources(self):
@@ -966,13 +972,9 @@ class PlexServer(PlexObject):
             base = 'https://app.plex.tv/desktop/'
 
         if endpoint:
-            return '%s#!/server/%s/%s%s' % (
-                base, self.machineIdentifier, endpoint, utils.joinArgs(kwargs)
-            )
+            return f'{base}#!/server/{self.machineIdentifier}/{endpoint}{utils.joinArgs(kwargs)}'
         else:
-            return '%s#!/media/%s/com.plexapp.plugins.library%s' % (
-                base, self.machineIdentifier, utils.joinArgs(kwargs)
-            )
+            return f'{base}#!/media/{self.machineIdentifier}/com.plexapp.plugins.library{utils.joinArgs(kwargs)}'
 
     def getWebURL(self, base=None, playlistTab=None):
         """ Returns the Plex Web URL for the server.
@@ -983,7 +985,7 @@ class PlexServer(PlexObject):
                 playlistTab (str): The playlist tab (audio, video, photo). Only used for the playlist URL.
         """
         if playlistTab is not None:
-            params = {'source': 'playlists', 'pivot': 'playlists.%s' % playlistTab}
+            params = {'source': 'playlists', 'pivot': f'playlists.{playlistTab}'}
         else:
             params = {'key': '/hubs', 'pageType': 'hub'}
         return self._buildWebURL(base=base, **params)
@@ -1115,7 +1117,7 @@ class SystemDevice(PlexObject):
         self.clientIdentifier = data.attrib.get('clientIdentifier')
         self.createdAt = utils.toDatetime(data.attrib.get('createdAt'))
         self.id = utils.cast(int, data.attrib.get('id'))
-        self.key = '/devices/%s' % self.id
+        self.key = f'/devices/{self.id}'
         self.name = data.attrib.get('name')
         self.platform = data.attrib.get('platform')
 
@@ -1146,12 +1148,14 @@ class StatisticsBandwidth(PlexObject):
         self.timespan = utils.cast(int, data.attrib.get('timespan'))
 
     def __repr__(self):
-        return '<%s>' % ':'.join([p for p in [
-            self.__class__.__name__,
-            self._clean(self.accountID),
-            self._clean(self.deviceID),
-            self._clean(int(self.at.timestamp()))
-        ] if p])
+        return '<{}>'.format(
+            ':'.join([p for p in [
+                self.__class__.__name__,
+                self._clean(self.accountID),
+                self._clean(self.deviceID),
+                self._clean(int(self.at.timestamp()))
+            ] if p])
+        )
 
     def account(self):
         """ Returns the :class:`~plexapi.server.SystemAccount` associated with the bandwidth data. """
@@ -1186,10 +1190,7 @@ class StatisticsResources(PlexObject):
         self.timespan = utils.cast(int, data.attrib.get('timespan'))
 
     def __repr__(self):
-        return '<%s>' % ':'.join([p for p in [
-            self.__class__.__name__,
-            self._clean(int(self.at.timestamp()))
-        ] if p])
+        return f"<{':'.join([p for p in [self.__class__.__name__, self._clean(int(self.at.timestamp()))] if p])}>"
 
 
 @utils.registerPlexObject
diff --git a/lib/plexapi/settings.py b/lib/plexapi/settings.py
index e0adba00..b6b4d2e6 100644
--- a/lib/plexapi/settings.py
+++ b/lib/plexapi/settings.py
@@ -51,7 +51,7 @@ class Settings(PlexObject):
         id = utils.lowerFirst(id)
         if id in self._settings:
             return self._settings[id]
-        raise NotFound('Invalid setting id: %s' % id)
+        raise NotFound(f'Invalid setting id: {id}')
 
     def groups(self):
         """ Returns a dict of lists for all :class:`~plexapi.settings.Setting`
@@ -77,12 +77,12 @@ class Settings(PlexObject):
         params = {}
         for setting in self.all():
             if setting._setValue:
-                log.info('Saving PlexServer setting %s = %s' % (setting.id, setting._setValue))
+                log.info('Saving PlexServer setting %s = %s', setting.id, setting._setValue)
                 params[setting.id] = quote(setting._setValue)
         if not params:
             raise BadRequest('No setting have been modified.')
-        querystr = '&'.join(['%s=%s' % (k, v) for k, v in params.items()])
-        url = '%s?%s' % (self.key, querystr)
+        querystr = '&'.join([f'{k}={v}' for k, v in params.items()])
+        url = f'{self.key}?{querystr}'
         self._server.query(url, self._server._session.put)
         self.reload()
 
@@ -149,16 +149,16 @@ class Setting(PlexObject):
         # check a few things up front
         if not isinstance(value, self.TYPES[self.type]['type']):
             badtype = type(value).__name__
-            raise BadRequest('Invalid value for %s: a %s is required, not %s' % (self.id, self.type, badtype))
+            raise BadRequest(f'Invalid value for {self.id}: a {self.type} is required, not {badtype}')
         if self.enumValues and value not in self.enumValues:
-            raise BadRequest('Invalid value for %s: %s not in %s' % (self.id, value, list(self.enumValues)))
+            raise BadRequest(f'Invalid value for {self.id}: {value} not in {list(self.enumValues)}')
         # store value off to the side until we call settings.save()
         tostr = self.TYPES[self.type]['tostr']
         self._setValue = tostr(value)
 
     def toUrl(self):
         """Helper for urls"""
-        return '%s=%s' % (self.id, self._value or self.value)
+        return f'{self.id}={self._value or self.value}'
 
 
 @utils.registerPlexObject
@@ -174,6 +174,6 @@ class Preferences(Setting):
 
     def _default(self):
         """ Set the default value for this setting."""
-        key = '%s/prefs?' % self._initpath
-        url = key + '%s=%s' % (self.id, self.default)
+        key = f'{self._initpath}/prefs?'
+        url = key + f'{self.id}={self.default}'
         self._server.query(url, method=self._server._session.put)
diff --git a/lib/plexapi/sonos.py b/lib/plexapi/sonos.py
index 35956b99..a7a57f4d 100644
--- a/lib/plexapi/sonos.py
+++ b/lib/plexapi/sonos.py
@@ -96,9 +96,7 @@ class PlexSonosClient(PlexClient):
                 {
                     "type": "music",
                     "providerIdentifier": "com.plexapp.plugins.library",
-                    "containerKey": "/playQueues/{}?own=1".format(
-                        playqueue.playQueueID
-                    ),
+                    "containerKey": f"/playQueues/{playqueue.playQueueID}?own=1",
                     "key": media.key,
                     "offset": offset,
                     "machineIdentifier": media._server.machineIdentifier,
diff --git a/lib/plexapi/sync.py b/lib/plexapi/sync.py
index 0a02f4e9..66468c30 100644
--- a/lib/plexapi/sync.py
+++ b/lib/plexapi/sync.py
@@ -81,13 +81,13 @@ class SyncItem(PlexObject):
         """ Returns :class:`~plexapi.myplex.MyPlexResource` with server of current item. """
         server = [s for s in self._server.resources() if s.clientIdentifier == self.machineIdentifier]
         if len(server) == 0:
-            raise NotFound('Unable to find server with uuid %s' % self.machineIdentifier)
+            raise NotFound(f'Unable to find server with uuid {self.machineIdentifier}')
         return server[0]
 
     def getMedia(self):
         """ Returns list of :class:`~plexapi.base.Playable` which belong to this sync item. """
         server = self.server().connect()
-        key = '/sync/items/%s' % self.id
+        key = f'/sync/items/{self.id}'
         return server.fetchItems(key)
 
     def markDownloaded(self, media):
@@ -97,7 +97,7 @@ class SyncItem(PlexObject):
             Parameters:
                 media (base.Playable): the media to be marked as downloaded.
         """
-        url = '/sync/%s/item/%s/downloaded' % (self.clientIdentifier, media.ratingKey)
+        url = f'/sync/{self.clientIdentifier}/item/{media.ratingKey}/downloaded'
         media._server.query(url, method=requests.put)
 
     def delete(self):
@@ -159,13 +159,14 @@ class Status:
         self.itemsCount = plexapi.utils.cast(int, itemsCount)
 
     def __repr__(self):
-        return '<%s>:%s' % (self.__class__.__name__, dict(
+        d = dict(
             itemsCount=self.itemsCount,
             itemsCompleteCount=self.itemsCompleteCount,
             itemsDownloadedCount=self.itemsDownloadedCount,
             itemsReadyCount=self.itemsReadyCount,
             itemsSuccessfulCount=self.itemsSuccessfulCount
-        ))
+        )
+        return f'<{self.__class__.__name__}>:{d}'
 
 
 class MediaSettings:
diff --git a/lib/plexapi/utils.py b/lib/plexapi/utils.py
index 9c43b23a..36827311 100644
--- a/lib/plexapi/utils.py
+++ b/lib/plexapi/utils.py
@@ -1,6 +1,7 @@
 # -*- coding: utf-8 -*-
 import base64
 import functools
+import json
 import logging
 import os
 import re
@@ -26,10 +27,66 @@ except ImportError:
 log = logging.getLogger('plexapi')
 
 # Search Types - Plex uses these to filter specific media types when searching.
-# Library Types - Populated at runtime
-SEARCHTYPES = {'movie': 1, 'show': 2, 'season': 3, 'episode': 4, 'trailer': 5, 'comic': 6, 'person': 7,
-               'artist': 8, 'album': 9, 'track': 10, 'picture': 11, 'clip': 12, 'photo': 13, 'photoalbum': 14,
-               'playlist': 15, 'playlistFolder': 16, 'collection': 18, 'optimizedVersion': 42, 'userPlaylistItem': 1001}
+SEARCHTYPES = {
+    'movie': 1,
+    'show': 2,
+    'season': 3,
+    'episode': 4,
+    'trailer': 5,
+    'comic': 6,
+    'person': 7,
+    'artist': 8,
+    'album': 9,
+    'track': 10,
+    'picture': 11,
+    'clip': 12,
+    'photo': 13,
+    'photoalbum': 14,
+    'playlist': 15,
+    'playlistFolder': 16,
+    'collection': 18,
+    'optimizedVersion': 42,
+    'userPlaylistItem': 1001,
+}
+# Tag Types - Plex uses these to filter specific tags when searching.
+TAGTYPES = {
+    'tag': 0,
+    'genre': 1,
+    'collection': 2,
+    'director': 4,
+    'writer': 5,
+    'role': 6,
+    'producer': 7,
+    'country': 8,
+    'chapter': 9,
+    'review': 10,
+    'label': 11,
+    'marker': 12,
+    'mediaProcessingTarget': 42,
+    'make': 200,
+    'model': 201,
+    'aperture': 202,
+    'exposure': 203,
+    'iso': 204,
+    'lens': 205,
+    'device': 206,
+    'autotag': 207,
+    'mood': 300,
+    'style': 301,
+    'format': 302,
+    'similar': 305,
+    'concert': 306,
+    'banner': 311,
+    'poster': 312,
+    'art': 313,
+    'guid': 314,
+    'ratingImage': 316,
+    'theme': 317,
+    'studio': 318,
+    'network': 319,
+    'place': 400,
+}
+# Plex Objects - Populated at runtime
 PLEXOBJECTS = {}
 
 
@@ -60,10 +117,12 @@ def registerPlexObject(cls):
         buildItem() below for an example.
     """
     etype = getattr(cls, 'STREAMTYPE', getattr(cls, 'TAGTYPE', cls.TYPE))
-    ehash = '%s.%s' % (cls.TAG, etype) if etype else cls.TAG
+    ehash = f'{cls.TAG}.{etype}' if etype else cls.TAG
+    if getattr(cls, '_SESSIONTYPE', None):
+        ehash = f"{ehash}.{'session'}"
     if ehash in PLEXOBJECTS:
-        raise Exception('Ambiguous PlexObject definition %s(tag=%s, type=%s) with %s' %
-            (cls.__name__, cls.TAG, etype, PLEXOBJECTS[ehash].__name__))
+        raise Exception(f'Ambiguous PlexObject definition {cls.__name__}(tag={cls.TAG}, type={etype}) '
+                        f'with {PLEXOBJECTS[ehash].__name__}')
     PLEXOBJECTS[ehash] = cls
     return cls
 
@@ -106,8 +165,8 @@ def joinArgs(args):
     arglist = []
     for key in sorted(args, key=lambda x: x.lower()):
         value = str(args[key])
-        arglist.append('%s=%s' % (key, quote(value, safe='')))
-    return '?%s' % '&'.join(arglist)
+        arglist.append(f"{key}={quote(value, safe='')}")
+    return f"?{'&'.join(arglist)}"
 
 
 def lowerFirst(s):
@@ -149,8 +208,7 @@ def searchType(libtype):
     """ Returns the integer value of the library string type.
 
         Parameters:
-            libtype (str): LibType to lookup (movie, show, season, episode, artist, album, track,
-                                              collection)
+            libtype (str): LibType to lookup (See :data:`~plexapi.utils.SEARCHTYPES`)
 
         Raises:
             :exc:`~plexapi.exceptions.NotFound`: Unknown libtype
@@ -160,7 +218,7 @@ def searchType(libtype):
         return libtype
     if SEARCHTYPES.get(libtype) is not None:
         return SEARCHTYPES[libtype]
-    raise NotFound('Unknown libtype: %s' % libtype)
+    raise NotFound(f'Unknown libtype: {libtype}')
 
 
 def reverseSearchType(libtype):
@@ -178,7 +236,42 @@ def reverseSearchType(libtype):
     for k, v in SEARCHTYPES.items():
         if libtype == v:
             return k
-    raise NotFound('Unknown libtype: %s' % libtype)
+    raise NotFound(f'Unknown libtype: {libtype}')
+
+
+def tagType(tag):
+    """ Returns the integer value of the library tag type.
+
+        Parameters:
+            tag (str): Tag to lookup (See :data:`~plexapi.utils.TAGTYPES`)
+
+        Raises:
+            :exc:`~plexapi.exceptions.NotFound`: Unknown tag
+    """
+    tag = str(tag)
+    if tag in [str(v) for v in TAGTYPES.values()]:
+        return tag
+    if TAGTYPES.get(tag) is not None:
+        return TAGTYPES[tag]
+    raise NotFound(f'Unknown tag: {tag}')
+
+
+def reverseTagType(tag):
+    """ Returns the string value of the library tag type.
+
+        Parameters:
+            tag (int): Integer value of the library tag type.
+
+        Raises:
+            :exc:`~plexapi.exceptions.NotFound`: Unknown tag
+    """
+    if tag in TAGTYPES:
+        return tag
+    tag = int(tag)
+    for k, v in TAGTYPES.items():
+        if tag == v:
+            return k
+    raise NotFound(f'Unknown tag: {tag}')
 
 
 def threaded(callback, listargs):
@@ -255,7 +348,7 @@ def toList(value, itemcast=None, delim=','):
 
 
 def cleanFilename(filename, replace='_'):
-    whitelist = "-_.()[] {}{}".format(string.ascii_letters, string.digits)
+    whitelist = f"-_.()[] {string.ascii_letters}{string.digits}"
     cleaned_filename = unicodedata.normalize('NFKD', filename).encode('ASCII', 'ignore').decode()
     cleaned_filename = ''.join(c if c in whitelist else replace for c in cleaned_filename)
     return cleaned_filename
@@ -283,11 +376,11 @@ def downloadSessionImages(server, filename=None, height=150, width=150,
             if media.thumb:
                 url = media.thumb
             if part.indexes:  # always use bif images if available.
-                url = '/library/parts/%s/indexes/%s/%s' % (part.id, part.indexes.lower(), media.viewOffset)
+                url = f'/library/parts/{part.id}/indexes/{part.indexes.lower()}/{media.viewOffset}'
         if url:
             if filename is None:
                 prettyname = media._prettyfilename()
-                filename = 'session_transcode_%s_%s_%s' % (media.usernames[0], prettyname, int(time.time()))
+                filename = f'session_transcode_{media.usernames[0]}_{prettyname}_{int(time.time())}'
             url = server.transcodeImage(url, height, width, opacity, saturation)
             filepath = download(url, filename=filename)
             info['username'] = {'filepath': filepath, 'url': url}
@@ -374,13 +467,13 @@ def getMyPlexAccount(opts=None):  # pragma: no cover
     from plexapi.myplex import MyPlexAccount
     # 1. Check command-line options
     if opts and opts.username and opts.password:
-        print('Authenticating with Plex.tv as %s..' % opts.username)
+        print(f'Authenticating with Plex.tv as {opts.username}..')
         return MyPlexAccount(opts.username, opts.password)
     # 2. Check Plexconfig (environment variables and config.ini)
     config_username = CONFIG.get('auth.myplex_username')
     config_password = CONFIG.get('auth.myplex_password')
     if config_username and config_password:
-        print('Authenticating with Plex.tv as %s..' % config_username)
+        print(f'Authenticating with Plex.tv as {config_username}..')
         return MyPlexAccount(config_username, config_password)
     config_token = CONFIG.get('auth.server_token')
     if config_token:
@@ -389,12 +482,12 @@ def getMyPlexAccount(opts=None):  # pragma: no cover
     # 3. Prompt for username and password on the command line
     username = input('What is your plex.tv username: ')
     password = getpass('What is your plex.tv password: ')
-    print('Authenticating with Plex.tv as %s..' % username)
+    print(f'Authenticating with Plex.tv as {username}..')
     return MyPlexAccount(username, password)
 
 
 def createMyPlexDevice(headers, account, timeout=10):  # pragma: no cover
-    """ Helper function to create a new MyPlexDevice.
+    """ Helper function to create a new MyPlexDevice. Returns a new MyPlexDevice instance.
 
         Parameters:
             headers (dict): Provide the X-Plex- headers for the new device.
@@ -417,6 +510,33 @@ def createMyPlexDevice(headers, account, timeout=10):  # pragma: no cover
     return account.device(clientId=clientIdentifier)
 
 
+def plexOAuth(headers, forwardUrl=None, timeout=120):  # pragma: no cover
+    """ Helper function for Plex OAuth login. Returns a new MyPlexAccount instance.
+
+        Parameters:
+            headers (dict): Provide the X-Plex- headers for the new device.
+                A unique X-Plex-Client-Identifier is required.
+            forwardUrl (str, optional): The url to redirect the client to after login.
+            timeout (int, optional): Timeout in seconds to wait for device login. Default 120 seconds.
+    """
+    from plexapi.myplex import MyPlexAccount, MyPlexPinLogin
+
+    if 'X-Plex-Client-Identifier' not in headers:
+        raise BadRequest('The X-Plex-Client-Identifier header is required.')
+
+    pinlogin = MyPlexPinLogin(headers=headers, oauth=True)
+    print('Login to Plex at the following url:')
+    print(pinlogin.oauthUrl(forwardUrl))
+    pinlogin.run(timeout=timeout)
+    pinlogin.waitForLogin()
+
+    if pinlogin.token:
+        print('Login successful!')
+        return MyPlexAccount(token=pinlogin.token)
+    else:
+        print('Login failed.')
+
+
 def choose(msg, items, attr):  # pragma: no cover
     """ Command line helper to display a list of choices, asking the
         user to choose one of the options.
@@ -428,12 +548,12 @@ def choose(msg, items, attr):  # pragma: no cover
     print()
     for index, i in enumerate(items):
         name = attr(i) if callable(attr) else getattr(i, attr)
-        print('  %s: %s' % (index, name))
+        print(f'  {index}: {name}')
     print()
     # Request choice from the user
     while True:
         try:
-            inp = input('%s: ' % msg)
+            inp = input(f'{msg}: ')
             if any(s in inp for s in (':', '::', '-')):
                 idx = slice(*map(lambda x: int(x.strip()) if x.strip() else None, inp.split(':')))
                 return items[idx]
@@ -452,8 +572,7 @@ def getAgentIdentifier(section, agent):
         if agent in identifiers:
             return ag.identifier
         agents += identifiers
-    raise NotFound('Could not find "%s" in agents list (%s)' %
-                   (agent, ', '.join(agents)))
+    raise NotFound(f"Could not find \"{agent}\" in agents list ({', '.join(agents)})")
 
 
 def base64str(text):
@@ -467,7 +586,7 @@ def deprecated(message, stacklevel=2):
         when the function is used."""
         @functools.wraps(func)
         def wrapper(*args, **kwargs):
-            msg = 'Call to deprecated function or method "%s", %s.' % (func.__name__, message)
+            msg = f'Call to deprecated function or method "{func.__name__}", {message}.'
             warnings.warn(msg, category=DeprecationWarning, stacklevel=stacklevel)
             log.warning(msg)
             return func(*args, **kwargs)
@@ -485,3 +604,17 @@ def iterXMLBFS(root, tag=None):
         if tag is None or node.tag == tag:
             yield node
         queue.extend(list(node))
+
+
+def toJson(obj, **kwargs):
+    """ Convert an object to a JSON string.
+
+        Parameters:
+            obj (object): The object to convert.
+            **kwargs (dict): Keyword arguments to pass to ``json.dumps()``.
+    """
+    def serialize(obj):
+        if isinstance(obj, datetime):
+            return obj.isoformat()
+        return {k: v for k, v in obj.__dict__.items() if not k.startswith('_')}
+    return json.dumps(obj, default=serialize, **kwargs)
diff --git a/lib/plexapi/video.py b/lib/plexapi/video.py
index 95f8336d..0d664c14 100644
--- a/lib/plexapi/video.py
+++ b/lib/plexapi/video.py
@@ -1,21 +1,21 @@
 # -*- coding: utf-8 -*-
 import os
-from urllib.parse import quote_plus, urlencode
+from urllib.parse import quote_plus
 
 from plexapi import media, utils
-from plexapi.base import Playable, PlexPartialObject
+from plexapi.base import Playable, PlexPartialObject, PlexSession
 from plexapi.exceptions import BadRequest
 from plexapi.mixins import (
-    AdvancedSettingsMixin, SplitMergeMixin, UnmatchMatchMixin, ExtrasMixin, HubsMixin, RatingMixin,
+    AdvancedSettingsMixin, SplitMergeMixin, UnmatchMatchMixin, ExtrasMixin, HubsMixin, PlayedUnplayedMixin, RatingMixin,
     ArtUrlMixin, ArtMixin, BannerMixin, PosterUrlMixin, PosterMixin, ThemeUrlMixin, ThemeMixin,
-    ContentRatingMixin, OriginallyAvailableMixin, OriginalTitleMixin, SortTitleMixin, StudioMixin,
+    ContentRatingMixin, EditionTitleMixin, OriginallyAvailableMixin, OriginalTitleMixin, SortTitleMixin, StudioMixin,
     SummaryMixin, TaglineMixin, TitleMixin,
     CollectionMixin, CountryMixin, DirectorMixin, GenreMixin, LabelMixin, ProducerMixin, WriterMixin,
     WatchlistMixin
 )
 
 
-class Video(PlexPartialObject):
+class Video(PlexPartialObject, PlayedUnplayedMixin):
     """ Base class for all video objects including :class:`~plexapi.video.Movie`,
         :class:`~plexapi.video.Show`, :class:`~plexapi.video.Season`,
         :class:`~plexapi.video.Episode`, and :class:`~plexapi.video.Clip`.
@@ -71,25 +71,10 @@ class Video(PlexPartialObject):
         self.userRating = utils.cast(float, data.attrib.get('userRating'))
         self.viewCount = utils.cast(int, data.attrib.get('viewCount', 0))
 
-    @property
-    def isWatched(self):
-        """ Returns True if this video is watched. """
-        return bool(self.viewCount > 0) if self.viewCount else False
-
     def url(self, part):
         """ Returns the full url for something. Typically used for getting a specific image. """
         return self._server.url(part, includeToken=True) if part else None
 
-    def markWatched(self):
-        """ Mark the video as played. """
-        key = '/:/scrobble?key=%s&identifier=com.plexapp.plugins.library' % self.ratingKey
-        self._server.query(key)
-
-    def markUnwatched(self):
-        """ Mark the video as unplayed. """
-        key = '/:/unscrobble?key=%s&identifier=com.plexapp.plugins.library' % self.ratingKey
-        self._server.query(key)
-
     def augmentation(self):
         """ Returns a list of :class:`~plexapi.library.Hub` objects.
             Augmentation returns hub items relating to online media sources
@@ -132,7 +117,7 @@ class Video(PlexPartialObject):
 
     def uploadSubtitles(self, filepath):
         """ Upload Subtitle file for video. """
-        url = '%s/subtitles' % self.key
+        url = f'{self.key}/subtitles'
         filename = os.path.basename(filepath)
         subFormat = os.path.splitext(filepath)[1][1:]
         with open(filepath, 'rb') as subfile:
@@ -141,6 +126,7 @@ class Video(PlexPartialObject):
                       }
             headers = {'Accept': 'text/plain, */*'}
             self._server.query(url, self._server._session.post, data=subfile, params=params, headers=headers)
+        return self
 
     def removeSubtitles(self, streamID=None, streamTitle=None):
         """ Remove Subtitle from movie's subtitles listing.
@@ -151,74 +137,103 @@ class Video(PlexPartialObject):
         for stream in self.subtitleStreams():
             if streamID == stream.id or streamTitle == stream.title:
                 self._server.query(stream.key, self._server._session.delete)
+        return self
 
-    def optimize(self, title=None, target="", targetTagID=None, locationID=-1, policyScope='all',
-                 policyValue="", policyUnwatched=0, videoQuality=None, deviceProfile=None):
-        """ Optimize item
+    def optimize(self, title='', target='', deviceProfile='', videoQuality=None,
+                 locationID=-1, limit=None, unwatched=False):
+        """ Create an optimized version of the video.
 
-            locationID (int): -1 in folder with original items
-                               2 library path id
-                                 library path id is found in library.locations[i].id
+            Parameters:
+                title (str, optional): Title of the optimized video.
+                target (str, optional): Target quality profile:
+                    "Optimized for Mobile" ("mobile"), "Optimized for TV" ("tv"), "Original Quality" ("original"),
+                    or custom quality profile name (default  "Custom: {deviceProfile}").
+                deviceProfile (str, optional): Custom quality device profile:
+                    "Android", "iOS", "Universal Mobile", "Universal TV", "Windows Phone", "Windows", "Xbox One".
+                    Required if ``target`` is custom.
+                videoQuality (int, optional): Index of the quality profile, one of ``VIDEO_QUALITY_*``
+                    values defined in the :mod:`~plexapi.sync` module. Only used if ``target`` is custom.
+                locationID (int or :class:`~plexapi.library.Location`, optional): Default -1 for
+                    "In folder with original items", otherwise a :class:`~plexapi.library.Location` object or ID.
+                    See examples below.
+                limit (int, optional): Maximum count of items to optimize, unlimited if ``None``.
+                unwatched (bool, optional): ``True`` to only optimized unwatched videos.
 
-            target (str): custom quality name.
-                          if none provided use "Custom: {deviceProfile}"
-
-            targetTagID (int):  Default quality settings
-                                1 Mobile
-                                2 TV
-                                3 Original Quality
-
-            deviceProfile (str): Android, IOS, Universal TV, Universal Mobile, Windows Phone,
-                                    Windows, Xbox One
+            Raises:
+                :exc:`~plexapi.exceptions.BadRequest`: Unknown quality profile target
+                    or missing deviceProfile and videoQuality.
+                :exc:`~plexapi.exceptions.BadRequest`: Unknown location ID.
 
             Example:
-                Optimize for Mobile
-                   item.optimize(targetTagID="Mobile") or item.optimize(targetTagID=1")
-                Optimize for Android 10 MBPS 1080p
-                   item.optimize(deviceProfile="Android", videoQuality=10)
-                Optimize for IOS Original Quality
-                   item.optimize(deviceProfile="IOS", videoQuality=-1)
 
-            * see sync.py VIDEO_QUALITIES for additional information for using videoQuality
+                .. code-block:: python
+
+                # Optimize for mobile using defaults
+                video.optimize(target="mobile")
+
+                # Optimize for Android at 10 Mbps 1080p
+                from plexapi.sync import VIDEO_QUALITY_10_MBPS_1080p
+                video.optimize(deviceProfile="Android", videoQuality=sync.VIDEO_QUALITY_10_MBPS_1080p)
+
+                # Optimize for iOS at original quality in library location
+                from plexapi.sync import VIDEO_QUALITY_ORIGINAL
+                locations = plex.library.section("Movies")._locations()
+                video.optimize(deviceProfile="iOS", videoQuality=VIDEO_QUALITY_ORIGINAL, locationID=locations[0])
+
+                # Optimize for tv the next 5 unwatched episodes
+                show.optimize(target="tv", limit=5, unwatched=True)
+
         """
-        tagValues = [1, 2, 3]
-        tagKeys = ["Mobile", "TV", "Original Quality"]
-        tagIDs = tagKeys + tagValues
-
-        if targetTagID not in tagIDs and (deviceProfile is None or videoQuality is None):
-            raise BadRequest('Unexpected or missing quality profile.')
-
-        libraryLocationIDs = [location.id for location in self.section()._locations()]
-        libraryLocationIDs.append(-1)
-
-        if locationID not in libraryLocationIDs:
-            raise BadRequest('Unexpected library path ID. %s not in %s' %
-                             (locationID, libraryLocationIDs))
-
-        if isinstance(targetTagID, str):
-            tagIndex = tagKeys.index(targetTagID)
-            targetTagID = tagValues[tagIndex]
-
-        if title is None:
-            title = self.title
+        from plexapi.library import Location
+        from plexapi.sync import Policy, MediaSettings
 
         backgroundProcessing = self.fetchItem('/playlists?type=42')
-        key = '%s/items?' % backgroundProcessing.key
+        key = f'{backgroundProcessing.key}/items'
+
+        tags = {t.tag.lower(): t.id for t in self._server.library.tags('mediaProcessingTarget')}
+        # Additional keys for shorthand values
+        tags['mobile'] = tags['optimized for mobile']
+        tags['tv'] = tags['optimized for tv']
+        tags['original'] = tags['original quality']
+
+        targetTagID = tags.get(target.lower(), '')
+        if not targetTagID and (not deviceProfile or videoQuality is None):
+            raise BadRequest('Unknown quality profile target or missing deviceProfile and videoQuality.')
+        if targetTagID:
+            target = ''
+        elif deviceProfile and not target:
+            target = f'Custom: {deviceProfile}'
+
+        section = self.section()
+        libraryLocationIDs = [-1] + [location.id for location in section._locations()]
+        if isinstance(locationID, Location):
+            locationID = locationID.id
+        if locationID not in libraryLocationIDs:
+            raise BadRequest(f'Unknown location ID "{locationID}" not in {libraryLocationIDs}')
+
+        if isinstance(self, (Show, Season)):
+            uri = f'library:///directory/{quote_plus(f"{self.key}/children")}'
+        else:
+            uri = f'library://{section.uuid}/item/{quote_plus(self.key)}'
+
+        policy = Policy.create(limit, unwatched)
+
         params = {
             'Item[type]': 42,
+            'Item[title]': title or self._defaultSyncTitle(),
             'Item[target]': target,
-            'Item[targetTagID]': targetTagID if targetTagID else '',
+            'Item[targetTagID]': targetTagID,
             'Item[locationID]': locationID,
-            'Item[Policy][scope]': policyScope,
-            'Item[Policy][value]': policyValue,
-            'Item[Policy][unwatched]': policyUnwatched
+            'Item[Location][uri]': uri,
+            'Item[Policy][scope]': policy.scope,
+            'Item[Policy][value]': str(policy.value),
+            'Item[Policy][unwatched]': str(int(policy.unwatched)),
         }
 
         if deviceProfile:
             params['Item[Device][profile]'] = deviceProfile
 
         if videoQuality:
-            from plexapi.sync import MediaSettings
             mediaSettings = MediaSettings.createVideo(videoQuality)
             params['Item[MediaSettings][videoQuality]'] = mediaSettings.videoQuality
             params['Item[MediaSettings][videoResolution]'] = mediaSettings.videoResolution
@@ -227,14 +242,11 @@ class Video(PlexPartialObject):
             params['Item[MediaSettings][subtitleSize]'] = ''
             params['Item[MediaSettings][musicBitrate]'] = ''
             params['Item[MediaSettings][photoQuality]'] = ''
+            params['Item[MediaSettings][photoResolution]'] = ''
 
-        titleParam = {'Item[title]': title}
-        section = self._server.library.sectionByID(self.librarySectionID)
-        params['Item[Location][uri]'] = 'library://' + section.uuid + '/item/' + \
-                                        quote_plus(self.key + '?includeExternalMedia=1')
-
-        data = key + urlencode(params) + '&' + urlencode(titleParam)
-        return self._server.query(data, method=self._server._session.put)
+        url = key + utils.joinArgs(params)
+        self._server.query(url, method=self._server._session.put)
+        return self
 
     def sync(self, videoQuality, client=None, clientId=None, limit=None, unwatched=False, title=None):
         """ Add current video (movie, tv-show, season or episode) as sync item for specified device.
@@ -267,7 +279,7 @@ class Video(PlexPartialObject):
 
         section = self._server.library.sectionByID(self.librarySectionID)
 
-        sync_item.location = 'library://%s/item/%s' % (section.uuid, quote_plus(self.key))
+        sync_item.location = f'library://{section.uuid}/item/{quote_plus(self.key)}'
         sync_item.policy = Policy.create(limit, unwatched)
         sync_item.mediaSettings = MediaSettings.createVideo(videoQuality)
 
@@ -279,7 +291,7 @@ class Movie(
     Video, Playable,
     AdvancedSettingsMixin, SplitMergeMixin, UnmatchMatchMixin, ExtrasMixin, HubsMixin, RatingMixin,
     ArtMixin, PosterMixin, ThemeMixin,
-    ContentRatingMixin, OriginallyAvailableMixin, OriginalTitleMixin, SortTitleMixin, StudioMixin,
+    ContentRatingMixin, EditionTitleMixin, OriginallyAvailableMixin, OriginalTitleMixin, SortTitleMixin, StudioMixin,
     SummaryMixin, TaglineMixin, TitleMixin,
     CollectionMixin, CountryMixin, DirectorMixin, GenreMixin, LabelMixin, ProducerMixin, WriterMixin,
     WatchlistMixin
@@ -298,6 +310,7 @@ class Movie(
             countries (List<:class:`~plexapi.media.Country`>): List of countries objects.
             directors (List<:class:`~plexapi.media.Director`>): List of director objects.
             duration (int): Duration of the movie in milliseconds.
+            editionTitle (str): The edition title of the movie (e.g. Director's Cut, Extended Edition, etc.).
             genres (List<:class:`~plexapi.media.Genre`>): List of genre objects.
             guids (List<:class:`~plexapi.media.Guid`>): List of guid objects.
             labels (List<:class:`~plexapi.media.Label`>): List of label objects.
@@ -338,6 +351,7 @@ class Movie(
         self.countries = self.findItems(data, media.Country)
         self.directors = self.findItems(data, media.Director)
         self.duration = utils.cast(int, data.attrib.get('duration'))
+        self.editionTitle = data.attrib.get('editionTitle')
         self.genres = self.findItems(data, media.Genre)
         self.guids = self.findItems(data, media.Guid)
         self.labels = self.findItems(data, media.Label)
@@ -381,13 +395,23 @@ class Movie(
 
     def _prettyfilename(self):
         """ Returns a filename for use in download. """
-        return '%s (%s)' % (self.title, self.year)
+        return f'{self.title} ({self.year})'
 
     def reviews(self):
         """ Returns a list of :class:`~plexapi.media.Review` objects. """
         data = self._server.query(self._details_key)
         return self.findItems(data, media.Review, rtag='Video')
 
+    def editions(self):
+        """ Returns a list of :class:`~plexapi.video.Movie` objects
+            for other editions of the same movie.
+        """
+        filters = {
+            'guid': self.guid,
+            'id!': self.ratingKey
+        }
+        return self.section().search(filters=filters)
+
 
 @utils.registerPlexObject
 class Show(
@@ -499,8 +523,8 @@ class Show(
         return self.roles
 
     @property
-    def isWatched(self):
-        """ Returns True if the show is fully watched. """
+    def isPlayed(self):
+        """ Returns True if the show is fully played. """
         return bool(self.viewedLeafCount == self.leafCount)
 
     def onDeck(self):
@@ -520,7 +544,7 @@ class Show(
             Raises:
                 :exc:`~plexapi.exceptions.BadRequest`: If title or season parameter is missing.
         """
-        key = '/library/metadata/%s/children?excludeAllLeaves=1' % self.ratingKey
+        key = f'{self.key}/children?excludeAllLeaves=1'
         if title is not None and not isinstance(title, int):
             return self.fetchItem(key, Season, title__iexact=title)
         elif season is not None or isinstance(title, int):
@@ -533,8 +557,8 @@ class Show(
 
     def seasons(self, **kwargs):
         """ Returns a list of :class:`~plexapi.video.Season` objects in the show. """
-        key = '/library/metadata/%s/children?excludeAllLeaves=1' % self.ratingKey
-        return self.fetchItems(key, Season, **kwargs)
+        key = f'{self.key}/children?excludeAllLeaves=1'
+        return self.fetchItems(key, Season, container_size=self.childCount, **kwargs)
 
     def episode(self, title=None, season=None, episode=None):
         """ Find a episode using a title or season and episode.
@@ -547,7 +571,7 @@ class Show(
             Raises:
                 :exc:`~plexapi.exceptions.BadRequest`: If title or season and episode parameters are missing.
         """
-        key = '/library/metadata/%s/allLeaves' % self.ratingKey
+        key = f'{self.key}/allLeaves'
         if title is not None:
             return self.fetchItem(key, Episode, title__iexact=title)
         elif season is not None and episode is not None:
@@ -556,7 +580,7 @@ class Show(
 
     def episodes(self, **kwargs):
         """ Returns a list of :class:`~plexapi.video.Episode` objects in the show. """
-        key = '/library/metadata/%s/allLeaves' % self.ratingKey
+        key = f'{self.key}/allLeaves'
         return self.fetchItems(key, Episode, **kwargs)
 
     def get(self, title=None, season=None, episode=None):
@@ -583,7 +607,7 @@ class Show(
         """
         filepaths = []
         for episode in self.episodes():
-            _savepath = os.path.join(savepath, 'Season %s' % str(episode.seasonNumber).zfill(2)) if subfolders else savepath
+            _savepath = os.path.join(savepath, f'Season {str(episode.seasonNumber).zfill(2)}') if subfolders else savepath
             filepaths += episode.download(_savepath, keep_original_name, **kwargs)
         return filepaths
 
@@ -647,15 +671,17 @@ class Season(
             yield episode
 
     def __repr__(self):
-        return '<%s>' % ':'.join([p for p in [
-            self.__class__.__name__,
-            self.key.replace('/library/metadata/', '').replace('/children', ''),
-            '%s-s%s' % (self.parentTitle.replace(' ', '-')[:20], self.seasonNumber),
-        ] if p])
+        return '<{}>'.format(
+            ':'.join([p for p in [
+                self.__class__.__name__,
+                self.key.replace('/library/metadata/', '').replace('/children', ''),
+                f"{self.parentTitle.replace(' ', '-')[:20]}-{self.seasonNumber}",
+            ] if p])
+        )
 
     @property
-    def isWatched(self):
-        """ Returns True if the season is fully watched. """
+    def isPlayed(self):
+        """ Returns True if the season is fully played. """
         return bool(self.viewedLeafCount == self.leafCount)
 
     @property
@@ -665,7 +691,7 @@ class Season(
 
     def episodes(self, **kwargs):
         """ Returns a list of :class:`~plexapi.video.Episode` objects in the season. """
-        key = '/library/metadata/%s/children' % self.ratingKey
+        key = f'{self.key}/children'
         return self.fetchItems(key, Episode, **kwargs)
 
     def episode(self, title=None, episode=None):
@@ -678,7 +704,7 @@ class Season(
             Raises:
                 :exc:`~plexapi.exceptions.BadRequest`: If title or episode parameter is missing.
         """
-        key = '/library/metadata/%s/children' % self.ratingKey
+        key = f'{self.key}/children'
         if title is not None and not isinstance(title, int):
             return self.fetchItem(key, Episode, title__iexact=title)
         elif episode is not None or isinstance(title, int):
@@ -728,7 +754,7 @@ class Season(
 
     def _defaultSyncTitle(self):
         """ Returns str, default title for a new syncItem. """
-        return '%s - %s' % (self.parentTitle, self.title)
+        return f'{self.parentTitle} - {self.title}'
 
 
 @utils.registerPlexObject
@@ -835,18 +861,20 @@ class Episode(
             if not self.parentRatingKey and self.grandparentRatingKey:
                 self.parentRatingKey = self.show().season(season=self.parentIndex).ratingKey
             if self.parentRatingKey:
-                self.parentKey = '/library/metadata/%s' % self.parentRatingKey
+                self.parentKey = f'/library/metadata/{self.parentRatingKey}'
 
     def __repr__(self):
-        return '<%s>' % ':'.join([p for p in [
-            self.__class__.__name__,
-            self.key.replace('/library/metadata/', '').replace('/children', ''),
-            '%s-%s' % (self.grandparentTitle.replace(' ', '-')[:20], self.seasonEpisode),
-        ] if p])
+        return '<{}>'.format(
+            ':'.join([p for p in [
+                self.__class__.__name__,
+                self.key.replace('/library/metadata/', '').replace('/children', ''),
+                f"{self.grandparentTitle.replace(' ', '-')[:20]}-{self.seasonEpisode}",
+            ] if p])
+        )
 
     def _prettyfilename(self):
         """ Returns a filename for use in download. """
-        return '%s - %s - %s' % (self.grandparentTitle, self.seasonEpisode, self.title)
+        return f'{self.grandparentTitle} - {self.seasonEpisode} - {self.title}'
 
     @property
     def actors(self):
@@ -878,7 +906,7 @@ class Episode(
     @property
     def seasonEpisode(self):
         """ Returns the s00e00 string containing the season and episode numbers. """
-        return 's%se%s' % (str(self.seasonNumber).zfill(2), str(self.episodeNumber).zfill(2))
+        return f's{str(self.seasonNumber).zfill(2)}e{str(self.episodeNumber).zfill(2)}'
 
     @property
     def hasCommercialMarker(self):
@@ -905,7 +933,7 @@ class Episode(
 
     def _defaultSyncTitle(self):
         """ Returns str, default title for a new syncItem. """
-        return '%s - %s - (%s) %s' % (self.grandparentTitle, self.parentTitle, self.seasonEpisode, self.title)
+        return f'{self.grandparentTitle} - {self.parentTitle} - ({self.seasonEpisode}) {self.title}'
 
 
 @utils.registerPlexObject
@@ -979,4 +1007,43 @@ class Extra(Clip):
 
     def _prettyfilename(self):
         """ Returns a filename for use in download. """
-        return '%s (%s)' % (self.title, self.subtype)
+        return f'{self.title} ({self.subtype})'
+
+
+@utils.registerPlexObject
+class MovieSession(PlexSession, Movie):
+    """ Represents a single Movie session
+        loaded from :func:`~plexapi.server.PlexServer.sessions`.
+    """
+    _SESSIONTYPE = True
+
+    def _loadData(self, data):
+        """ Load attribute values from Plex XML response. """
+        Movie._loadData(self, data)
+        PlexSession._loadData(self, data)
+
+
+@utils.registerPlexObject
+class EpisodeSession(PlexSession, Episode):
+    """ Represents a single Episode session
+        loaded from :func:`~plexapi.server.PlexServer.sessions`.
+    """
+    _SESSIONTYPE = True
+
+    def _loadData(self, data):
+        """ Load attribute values from Plex XML response. """
+        Episode._loadData(self, data)
+        PlexSession._loadData(self, data)
+
+
+@utils.registerPlexObject
+class ClipSession(PlexSession, Clip):
+    """ Represents a single Clip session
+        loaded from :func:`~plexapi.server.PlexServer.sessions`.
+    """
+    _SESSIONTYPE = True
+
+    def _loadData(self, data):
+        """ Load attribute values from Plex XML response. """
+        Clip._loadData(self, data)
+        PlexSession._loadData(self, data)
diff --git a/requirements.txt b/requirements.txt
index c505d8ae..a0dcd531 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -27,7 +27,7 @@ MarkupSafe==2.1.1
 musicbrainzngs==0.7.1
 packaging==21.3
 paho-mqtt==1.6.1
-plexapi==4.12.1
+plexapi==4.13.1
 portend==3.1.0
 profilehooks==1.12.0
 PyJWT==2.4.0

From 76cc56a215e7cb9c2ff0b551e0d69c064e965bf9 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 12 Nov 2022 17:53:03 -0800
Subject: [PATCH 223/743] Bump cherrypy from 18.6.1 to 18.8.0 (#1796)

* Bump cherrypy from 18.6.1 to 18.8.0

Bumps [cherrypy](https://github.com/cherrypy/cherrypy) from 18.6.1 to 18.8.0.
- [Release notes](https://github.com/cherrypy/cherrypy/releases)
- [Changelog](https://github.com/cherrypy/cherrypy/blob/main/CHANGES.rst)
- [Commits](https://github.com/cherrypy/cherrypy/compare/v18.6.1...v18.8.0)

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

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

* Update cherrypy==18.8.0

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
---
 lib/autocommand/__init__.py                 |   27 +
 lib/autocommand/autoasync.py                |  140 +
 lib/autocommand/autocommand.py              |   70 +
 lib/autocommand/automain.py                 |   59 +
 lib/autocommand/autoparse.py                |  333 ++
 lib/autocommand/errors.py                   |   23 +
 lib/cherrypy/_cpdispatch.py                 |    8 +-
 lib/cherrypy/_cperror.py                    |    5 +-
 lib/cherrypy/_cpmodpy.py                    |    5 +-
 lib/cherrypy/_cprequest.py                  |    7 +-
 lib/cherrypy/lib/auth_digest.py             |   13 +-
 lib/cherrypy/lib/covercp.py                 |    5 +-
 lib/cherrypy/lib/httputil.py                |   30 +
 lib/cherrypy/lib/reprconf.py                |    5 +-
 lib/cherrypy/lib/sessions.py                |   10 +-
 lib/cherrypy/process/plugins.py             |    3 +-
 lib/cherrypy/test/helper.py                 |    3 +-
 lib/cherrypy/test/logtest.py                |   33 +-
 lib/cherrypy/test/modfastcgi.py             |    7 +-
 lib/cherrypy/test/modfcgid.py               |    7 +-
 lib/cherrypy/test/modpy.py                  |    7 +-
 lib/cherrypy/test/modwsgi.py                |    7 +-
 lib/cherrypy/test/test_auth_basic.py        |    2 +-
 lib/cherrypy/test/test_auth_digest.py       |    2 +-
 lib/cherrypy/test/test_core.py              |    5 +-
 lib/cherrypy/test/test_encoding.py          |    2 +-
 lib/cherrypy/test/test_logging.py           |    4 +-
 lib/cherrypy/test/test_request_obj.py       |   16 +-
 lib/cherrypy/test/test_states.py            |   11 +-
 lib/cherrypy/test/test_tutorials.py         |    4 +-
 lib/cherrypy/tutorial/pdf_file.pdf          |  Bin 85698 -> 11961 bytes
 lib/cherrypy/tutorial/tut04_complex_site.py |    4 +-
 lib/inflect/__init__.py                     | 3991 +++++++++++++++++++
 lib/inflect/py.typed                        |    0
 lib/jaraco/classes/properties.py            |   11 +-
 lib/jaraco/collections.py                   |  100 +-
 lib/jaraco/text/__init__.py                 |   46 +-
 lib/jaraco/text/layouts.py                  |   25 +
 lib/jaraco/text/show-newlines.py            |   33 +
 lib/jaraco/text/to-dvorak.py                |    6 +
 lib/jaraco/text/to-qwerty.py                |    6 +
 lib/more_itertools/__init__.py              |    4 +-
 lib/more_itertools/more.py                  |  226 +-
 lib/more_itertools/more.pyi                 |   36 +-
 lib/more_itertools/recipes.py               |  175 +-
 lib/more_itertools/recipes.pyi              |   26 +-
 lib/pydantic/__init__.py                    |  131 +
 lib/pydantic/_hypothesis_plugin.py          |  386 ++
 lib/pydantic/annotated_types.py             |   72 +
 lib/pydantic/class_validators.py            |  342 ++
 lib/pydantic/color.py                       |  494 +++
 lib/pydantic/config.py                      |  192 +
 lib/pydantic/dataclasses.py                 |  479 +++
 lib/pydantic/datetime_parse.py              |  248 ++
 lib/pydantic/decorator.py                   |  264 ++
 lib/pydantic/env_settings.py                |  346 ++
 lib/pydantic/error_wrappers.py              |  162 +
 lib/pydantic/errors.py                      |  646 +++
 lib/pydantic/fields.py                      | 1247 ++++++
 lib/pydantic/generics.py                    |  364 ++
 lib/pydantic/json.py                        |  112 +
 lib/pydantic/main.py                        | 1109 ++++++
 lib/pydantic/mypy.py                        |  850 ++++
 lib/pydantic/networks.py                    |  736 ++++
 lib/pydantic/parse.py                       |   66 +
 lib/pydantic/py.typed                       |    0
 lib/pydantic/schema.py                      | 1153 ++++++
 lib/pydantic/tools.py                       |   92 +
 lib/pydantic/types.py                       | 1187 ++++++
 lib/pydantic/typing.py                      |  602 +++
 lib/pydantic/utils.py                       |  841 ++++
 lib/pydantic/validators.py                  |  765 ++++
 lib/pydantic/version.py                     |   38 +
 lib/typing_extensions.py                    | 2021 +++++-----
 requirements.txt                            |    2 +-
 75 files changed, 19150 insertions(+), 1339 deletions(-)
 create mode 100644 lib/autocommand/__init__.py
 create mode 100644 lib/autocommand/autoasync.py
 create mode 100644 lib/autocommand/autocommand.py
 create mode 100644 lib/autocommand/automain.py
 create mode 100644 lib/autocommand/autoparse.py
 create mode 100644 lib/autocommand/errors.py
 create mode 100644 lib/inflect/__init__.py
 create mode 100644 lib/inflect/py.typed
 create mode 100644 lib/jaraco/text/layouts.py
 create mode 100644 lib/jaraco/text/show-newlines.py
 create mode 100644 lib/jaraco/text/to-dvorak.py
 create mode 100644 lib/jaraco/text/to-qwerty.py
 create mode 100644 lib/pydantic/__init__.py
 create mode 100644 lib/pydantic/_hypothesis_plugin.py
 create mode 100644 lib/pydantic/annotated_types.py
 create mode 100644 lib/pydantic/class_validators.py
 create mode 100644 lib/pydantic/color.py
 create mode 100644 lib/pydantic/config.py
 create mode 100644 lib/pydantic/dataclasses.py
 create mode 100644 lib/pydantic/datetime_parse.py
 create mode 100644 lib/pydantic/decorator.py
 create mode 100644 lib/pydantic/env_settings.py
 create mode 100644 lib/pydantic/error_wrappers.py
 create mode 100644 lib/pydantic/errors.py
 create mode 100644 lib/pydantic/fields.py
 create mode 100644 lib/pydantic/generics.py
 create mode 100644 lib/pydantic/json.py
 create mode 100644 lib/pydantic/main.py
 create mode 100644 lib/pydantic/mypy.py
 create mode 100644 lib/pydantic/networks.py
 create mode 100644 lib/pydantic/parse.py
 create mode 100644 lib/pydantic/py.typed
 create mode 100644 lib/pydantic/schema.py
 create mode 100644 lib/pydantic/tools.py
 create mode 100644 lib/pydantic/types.py
 create mode 100644 lib/pydantic/typing.py
 create mode 100644 lib/pydantic/utils.py
 create mode 100644 lib/pydantic/validators.py
 create mode 100644 lib/pydantic/version.py

diff --git a/lib/autocommand/__init__.py b/lib/autocommand/__init__.py
new file mode 100644
index 00000000..73fbfca6
--- /dev/null
+++ b/lib/autocommand/__init__.py
@@ -0,0 +1,27 @@
+# Copyright 2014-2016 Nathan West
+#
+# This file is part of autocommand.
+#
+# autocommand is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# autocommand is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with autocommand.  If not, see <http://www.gnu.org/licenses/>.
+
+# flake8 flags all these imports as unused, hence the NOQAs everywhere.
+
+from .automain import automain  # NOQA
+from .autoparse import autoparse, smart_open  # NOQA
+from .autocommand import autocommand  # NOQA
+
+try:
+    from .autoasync import autoasync  # NOQA
+except ImportError:  # pragma: no cover
+    pass
diff --git a/lib/autocommand/autoasync.py b/lib/autocommand/autoasync.py
new file mode 100644
index 00000000..3c8ebdcf
--- /dev/null
+++ b/lib/autocommand/autoasync.py
@@ -0,0 +1,140 @@
+# Copyright 2014-2015 Nathan West
+#
+# This file is part of autocommand.
+#
+# autocommand is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# autocommand is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with autocommand.  If not, see <http://www.gnu.org/licenses/>.
+
+from asyncio import get_event_loop, iscoroutine
+from functools import wraps
+from inspect import signature
+
+
+def _launch_forever_coro(coro, args, kwargs, loop):
+    '''
+    This helper function launches an async main function that was tagged with
+    forever=True. There are two possibilities:
+
+    - The function is a normal function, which handles initializing the event
+      loop, which is then run forever
+    - The function is a coroutine, which needs to be scheduled in the event
+      loop, which is then run forever
+      - There is also the possibility that the function is a normal function
+        wrapping a coroutine function
+
+    The function is therefore called unconditionally and scheduled in the event
+    loop if the return value is a coroutine object.
+
+    The reason this is a separate function is to make absolutely sure that all
+    the objects created are garbage collected after all is said and done; we
+    do this to ensure that any exceptions raised in the tasks are collected
+    ASAP.
+    '''
+
+    # Personal note: I consider this an antipattern, as it relies on the use of
+    # unowned resources. The setup function dumps some stuff into the event
+    # loop where it just whirls in the ether without a well defined owner or
+    # lifetime. For this reason, there's a good chance I'll remove the
+    # forever=True feature from autoasync at some point in the future.
+    thing = coro(*args, **kwargs)
+    if iscoroutine(thing):
+        loop.create_task(thing)
+
+
+def autoasync(coro=None, *, loop=None, forever=False, pass_loop=False):
+    '''
+    Convert an asyncio coroutine into a function which, when called, is
+    evaluted in an event loop, and the return value returned. This is intented
+    to make it easy to write entry points into asyncio coroutines, which
+    otherwise need to be explictly evaluted with an event loop's
+    run_until_complete.
+
+    If `loop` is given, it is used as the event loop to run the coro in. If it
+    is None (the default), the loop is retreived using asyncio.get_event_loop.
+    This call is defered until the decorated function is called, so that
+    callers can install custom event loops or event loop policies after
+    @autoasync is applied.
+
+    If `forever` is True, the loop is run forever after the decorated coroutine
+    is finished. Use this for servers created with asyncio.start_server and the
+    like.
+
+    If `pass_loop` is True, the event loop object is passed into the coroutine
+    as the `loop` kwarg when the wrapper function is called. In this case, the
+    wrapper function's __signature__ is updated to remove this parameter, so
+    that autoparse can still be used on it without generating a parameter for
+    `loop`.
+
+    This coroutine can be called with ( @autoasync(...) ) or without
+    ( @autoasync ) arguments.
+
+    Examples:
+
+    @autoasync
+    def get_file(host, port):
+        reader, writer = yield from asyncio.open_connection(host, port)
+        data = reader.read()
+        sys.stdout.write(data.decode())
+
+    get_file(host, port)
+
+    @autoasync(forever=True, pass_loop=True)
+    def server(host, port, loop):
+        yield_from loop.create_server(Proto, host, port)
+
+    server('localhost', 8899)
+
+    '''
+    if coro is None:
+        return lambda c: autoasync(
+            c, loop=loop,
+            forever=forever,
+            pass_loop=pass_loop)
+
+    # The old and new signatures are required to correctly bind the loop
+    # parameter in 100% of cases, even if it's a positional parameter.
+    # NOTE: A future release will probably require the loop parameter to be
+    # a kwonly parameter.
+    if pass_loop:
+        old_sig = signature(coro)
+        new_sig = old_sig.replace(parameters=(
+            param for name, param in old_sig.parameters.items()
+            if name != "loop"))
+
+    @wraps(coro)
+    def autoasync_wrapper(*args, **kwargs):
+        # Defer the call to get_event_loop so that, if a custom policy is
+        # installed after the autoasync decorator, it is respected at call time
+        local_loop = get_event_loop() if loop is None else loop
+
+        # Inject the 'loop' argument. We have to use this signature binding to
+        # ensure it's injected in the correct place (positional, keyword, etc)
+        if pass_loop:
+            bound_args = old_sig.bind_partial()
+            bound_args.arguments.update(
+                loop=local_loop,
+                **new_sig.bind(*args, **kwargs).arguments)
+            args, kwargs = bound_args.args, bound_args.kwargs
+
+        if forever:
+            _launch_forever_coro(coro, args, kwargs, local_loop)
+            local_loop.run_forever()
+        else:
+            return local_loop.run_until_complete(coro(*args, **kwargs))
+
+    # Attach the updated signature. This allows 'pass_loop' to be used with
+    # autoparse
+    if pass_loop:
+        autoasync_wrapper.__signature__ = new_sig
+
+    return autoasync_wrapper
diff --git a/lib/autocommand/autocommand.py b/lib/autocommand/autocommand.py
new file mode 100644
index 00000000..097e86de
--- /dev/null
+++ b/lib/autocommand/autocommand.py
@@ -0,0 +1,70 @@
+# Copyright 2014-2015 Nathan West
+#
+# This file is part of autocommand.
+#
+# autocommand is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# autocommand is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with autocommand.  If not, see <http://www.gnu.org/licenses/>.
+
+from .autoparse import autoparse
+from .automain import automain
+try:
+    from .autoasync import autoasync
+except ImportError:  # pragma: no cover
+    pass
+
+
+def autocommand(
+        module, *,
+        description=None,
+        epilog=None,
+        add_nos=False,
+        parser=None,
+        loop=None,
+        forever=False,
+        pass_loop=False):
+
+    if callable(module):
+        raise TypeError('autocommand requires a module name argument')
+
+    def autocommand_decorator(func):
+        # Step 1: if requested, run it all in an asyncio event loop. autoasync
+        # patches the __signature__ of the decorated function, so that in the
+        # event that pass_loop is True, the `loop` parameter of the original
+        # function will *not* be interpreted as a command-line argument by
+        # autoparse
+        if loop is not None or forever or pass_loop:
+            func = autoasync(
+                func,
+                loop=None if loop is True else loop,
+                pass_loop=pass_loop,
+                forever=forever)
+
+        # Step 2: create parser. We do this second so that the arguments are
+        # parsed and passed *before* entering the asyncio event loop, if it
+        # exists. This simplifies the stack trace and ensures errors are
+        # reported earlier. It also ensures that errors raised during parsing &
+        # passing are still raised if `forever` is True.
+        func = autoparse(
+            func,
+            description=description,
+            epilog=epilog,
+            add_nos=add_nos,
+            parser=parser)
+
+        # Step 3: call the function automatically if __name__ == '__main__' (or
+        # if True was provided)
+        func = automain(module)(func)
+
+        return func
+
+    return autocommand_decorator
diff --git a/lib/autocommand/automain.py b/lib/autocommand/automain.py
new file mode 100644
index 00000000..6cc45db6
--- /dev/null
+++ b/lib/autocommand/automain.py
@@ -0,0 +1,59 @@
+# Copyright 2014-2015 Nathan West
+#
+# This file is part of autocommand.
+#
+# autocommand is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# autocommand is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with autocommand.  If not, see <http://www.gnu.org/licenses/>.
+
+import sys
+from .errors import AutocommandError
+
+
+class AutomainRequiresModuleError(AutocommandError, TypeError):
+    pass
+
+
+def automain(module, *, args=(), kwargs=None):
+    '''
+    This decorator automatically invokes a function if the module is being run
+    as the "__main__" module. Optionally, provide args or kwargs with which to
+    call the function. If `module` is "__main__", the function is called, and
+    the program is `sys.exit`ed with the return value. You can also pass `True`
+    to cause the function to be called unconditionally. If the function is not
+    called, it is returned unchanged by the decorator.
+
+    Usage:
+
+    @automain(__name__)  # Pass __name__ to check __name__=="__main__"
+    def main():
+        ...
+
+    If __name__ is "__main__" here, the main function is called, and then
+    sys.exit called with the return value.
+    '''
+
+    # Check that @automain(...) was called, rather than @automain
+    if callable(module):
+        raise AutomainRequiresModuleError(module)
+
+    if module == '__main__' or module is True:
+        if kwargs is None:
+            kwargs = {}
+
+        # Use a function definition instead of a lambda for a neater traceback
+        def automain_decorator(main):
+            sys.exit(main(*args, **kwargs))
+
+        return automain_decorator
+    else:
+        return lambda main: main
diff --git a/lib/autocommand/autoparse.py b/lib/autocommand/autoparse.py
new file mode 100644
index 00000000..0276a3fa
--- /dev/null
+++ b/lib/autocommand/autoparse.py
@@ -0,0 +1,333 @@
+# Copyright 2014-2015 Nathan West
+#
+# This file is part of autocommand.
+#
+# autocommand is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# autocommand is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with autocommand.  If not, see <http://www.gnu.org/licenses/>.
+
+import sys
+from re import compile as compile_regex
+from inspect import signature, getdoc, Parameter
+from argparse import ArgumentParser
+from contextlib import contextmanager
+from functools import wraps
+from io import IOBase
+from autocommand.errors import AutocommandError
+
+
+_empty = Parameter.empty
+
+
+class AnnotationError(AutocommandError):
+    '''Annotation error: annotation must be a string, type, or tuple of both'''
+
+
+class PositionalArgError(AutocommandError):
+    '''
+    Postional Arg Error: autocommand can't handle postional-only parameters
+    '''
+
+
+class KWArgError(AutocommandError):
+    '''kwarg Error: autocommand can't handle a **kwargs parameter'''
+
+
+class DocstringError(AutocommandError):
+    '''Docstring error'''
+
+
+class TooManySplitsError(DocstringError):
+    '''
+    The docstring had too many ---- section splits. Currently we only support
+    using up to a single split, to split the docstring into description and
+    epilog parts.
+    '''
+
+
+def _get_type_description(annotation):
+    '''
+    Given an annotation, return the (type, description) for the parameter.
+    If you provide an annotation that is somehow both a string and a callable,
+    the behavior is undefined.
+    '''
+    if annotation is _empty:
+        return None, None
+    elif callable(annotation):
+        return annotation, None
+    elif isinstance(annotation, str):
+        return None, annotation
+    elif isinstance(annotation, tuple):
+        try:
+            arg1, arg2 = annotation
+        except ValueError as e:
+            raise AnnotationError(annotation) from e
+        else:
+            if callable(arg1) and isinstance(arg2, str):
+                return arg1, arg2
+            elif isinstance(arg1, str) and callable(arg2):
+                return arg2, arg1
+
+    raise AnnotationError(annotation)
+
+
+def _add_arguments(param, parser, used_char_args, add_nos):
+    '''
+    Add the argument(s) to an ArgumentParser (using add_argument) for a given
+    parameter. used_char_args is the set of -short options currently already in
+    use, and is updated (if necessary) by this function. If add_nos is True,
+    this will also add an inverse switch for all boolean options. For
+    instance, for the boolean parameter "verbose", this will create --verbose
+    and --no-verbose.
+    '''
+
+    # Impl note: This function is kept separate from make_parser because it's
+    # already very long and I wanted to separate out as much as possible into
+    # its own call scope, to prevent even the possibility of suble mutation
+    # bugs.
+    if param.kind is param.POSITIONAL_ONLY:
+        raise PositionalArgError(param)
+    elif param.kind is param.VAR_KEYWORD:
+        raise KWArgError(param)
+
+    # These are the kwargs for the add_argument function.
+    arg_spec = {}
+    is_option = False
+
+    # Get the type and default from the annotation.
+    arg_type, description = _get_type_description(param.annotation)
+
+    # Get the default value
+    default = param.default
+
+    # If there is no explicit type, and the default is present and not None,
+    # infer the type from the default.
+    if arg_type is None and default not in {_empty, None}:
+        arg_type = type(default)
+
+    # Add default. The presence of a default means this is an option, not an
+    # argument.
+    if default is not _empty:
+        arg_spec['default'] = default
+        is_option = True
+
+    # Add the type
+    if arg_type is not None:
+        # Special case for bool: make it just a --switch
+        if arg_type is bool:
+            if not default or default is _empty:
+                arg_spec['action'] = 'store_true'
+            else:
+                arg_spec['action'] = 'store_false'
+
+            # Switches are always options
+            is_option = True
+
+        # Special case for file types: make it a string type, for filename
+        elif isinstance(default, IOBase):
+            arg_spec['type'] = str
+
+        # TODO: special case for list type.
+        #   - How to specificy type of list members?
+        #       - param: [int]
+        #       - param: int =[]
+        #   - action='append' vs nargs='*'
+
+        else:
+            arg_spec['type'] = arg_type
+
+    # nargs: if the signature includes *args, collect them as trailing CLI
+    # arguments in a list. *args can't have a default value, so it can never be
+    # an option.
+    if param.kind is param.VAR_POSITIONAL:
+        # TODO: consider depluralizing metavar/name here.
+        arg_spec['nargs'] = '*'
+
+    # Add description.
+    if description is not None:
+        arg_spec['help'] = description
+
+    # Get the --flags
+    flags = []
+    name = param.name
+
+    if is_option:
+        # Add the first letter as a -short option.
+        for letter in name[0], name[0].swapcase():
+            if letter not in used_char_args:
+                used_char_args.add(letter)
+                flags.append('-{}'.format(letter))
+                break
+
+        # If the parameter is a --long option, or is a -short option that
+        # somehow failed to get a flag, add it.
+        if len(name) > 1 or not flags:
+            flags.append('--{}'.format(name))
+
+        arg_spec['dest'] = name
+    else:
+        flags.append(name)
+
+    parser.add_argument(*flags, **arg_spec)
+
+    # Create the --no- version for boolean switches
+    if add_nos and arg_type is bool:
+        parser.add_argument(
+            '--no-{}'.format(name),
+            action='store_const',
+            dest=name,
+            const=default if default is not _empty else False)
+
+
+def make_parser(func_sig, description, epilog, add_nos):
+    '''
+    Given the signature of a function, create an ArgumentParser
+    '''
+    parser = ArgumentParser(description=description, epilog=epilog)
+
+    used_char_args = {'h'}
+
+    # Arange the params so that single-character arguments are first. This
+    # esnures they don't have to get --long versions. sorted is stable, so the
+    # parameters will otherwise still be in relative order.
+    params = sorted(
+        func_sig.parameters.values(),
+        key=lambda param: len(param.name) > 1)
+
+    for param in params:
+        _add_arguments(param, parser, used_char_args, add_nos)
+
+    return parser
+
+
+_DOCSTRING_SPLIT = compile_regex(r'\n\s*-{4,}\s*\n')
+
+
+def parse_docstring(docstring):
+    '''
+    Given a docstring, parse it into a description and epilog part
+    '''
+    if docstring is None:
+        return '', ''
+
+    parts = _DOCSTRING_SPLIT.split(docstring)
+
+    if len(parts) == 1:
+        return docstring, ''
+    elif len(parts) == 2:
+        return parts[0], parts[1]
+    else:
+        raise TooManySplitsError()
+
+
+def autoparse(
+        func=None, *,
+        description=None,
+        epilog=None,
+        add_nos=False,
+        parser=None):
+    '''
+    This decorator converts a function that takes normal arguments into a
+    function which takes a single optional argument, argv, parses it using an
+    argparse.ArgumentParser, and calls the underlying function with the parsed
+    arguments. If it is not given, sys.argv[1:] is used. This is so that the
+    function can be used as a setuptools entry point, as well as a normal main
+    function. sys.argv[1:] is not evaluated until the function is called, to
+    allow injecting different arguments for testing.
+
+    It uses the argument signature of the function to create an
+    ArgumentParser. Parameters without defaults become positional parameters,
+    while parameters *with* defaults become --options. Use annotations to set
+    the type of the parameter.
+
+    The `desctiption` and `epilog` parameters corrospond to the same respective
+    argparse parameters. If no description is given, it defaults to the
+    decorated functions's docstring, if present.
+
+    If add_nos is True, every boolean option (that is, every parameter with a
+    default of True/False or a type of bool) will have a --no- version created
+    as well, which inverts the option. For instance, the --verbose option will
+    have a --no-verbose counterpart. These are not mutually exclusive-
+    whichever one appears last in the argument list will have precedence.
+
+    If a parser is given, it is used instead of one generated from the function
+    signature. In this case, no parser is created; instead, the given parser is
+    used to parse the argv argument. The parser's results' argument names must
+    match up with the parameter names of the decorated function.
+
+    The decorated function is attached to the result as the `func` attribute,
+    and the parser is attached as the `parser` attribute.
+    '''
+
+    # If @autoparse(...) is used instead of @autoparse
+    if func is None:
+        return lambda f: autoparse(
+            f, description=description,
+            epilog=epilog,
+            add_nos=add_nos,
+            parser=parser)
+
+    func_sig = signature(func)
+
+    docstr_description, docstr_epilog = parse_docstring(getdoc(func))
+
+    if parser is None:
+        parser = make_parser(
+            func_sig,
+            description or docstr_description,
+            epilog or docstr_epilog,
+            add_nos)
+
+    @wraps(func)
+    def autoparse_wrapper(argv=None):
+        if argv is None:
+            argv = sys.argv[1:]
+
+        # Get empty argument binding, to fill with parsed arguments. This
+        # object does all the heavy lifting of turning named arguments into
+        # into correctly bound *args and **kwargs.
+        parsed_args = func_sig.bind_partial()
+        parsed_args.arguments.update(vars(parser.parse_args(argv)))
+
+        return func(*parsed_args.args, **parsed_args.kwargs)
+
+    # TODO: attach an updated __signature__ to autoparse_wrapper, just in case.
+
+    # Attach the wrapped function and parser, and return the wrapper.
+    autoparse_wrapper.func = func
+    autoparse_wrapper.parser = parser
+    return autoparse_wrapper
+
+
+@contextmanager
+def smart_open(filename_or_file, *args, **kwargs):
+    '''
+    This context manager allows you to open a filename, if you want to default
+    some already-existing file object, like sys.stdout, which shouldn't be
+    closed at the end of the context. If the filename argument is a str, bytes,
+    or int, the file object is created via a call to open with the given *args
+    and **kwargs, sent to the context, and closed at the end of the context,
+    just like "with open(filename) as f:". If it isn't one of the openable
+    types, the object simply sent to the context unchanged, and left unclosed
+    at the end of the context. Example:
+
+        def work_with_file(name=sys.stdout):
+            with smart_open(name) as f:
+                # Works correctly if name is a str filename or sys.stdout
+                print("Some stuff", file=f)
+                # If it was a filename, f is closed at the end here.
+    '''
+    if isinstance(filename_or_file, (str, bytes, int)):
+        with open(filename_or_file, *args, **kwargs) as file:
+            yield file
+    else:
+        yield filename_or_file
diff --git a/lib/autocommand/errors.py b/lib/autocommand/errors.py
new file mode 100644
index 00000000..25706073
--- /dev/null
+++ b/lib/autocommand/errors.py
@@ -0,0 +1,23 @@
+# Copyright 2014-2016 Nathan West
+#
+# This file is part of autocommand.
+#
+# autocommand is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# autocommand is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with autocommand.  If not, see <http://www.gnu.org/licenses/>.
+
+
+class AutocommandError(Exception):
+    '''Base class for autocommand exceptions'''
+    pass
+
+# Individual modules will define errors specific to that module.
diff --git a/lib/cherrypy/_cpdispatch.py b/lib/cherrypy/_cpdispatch.py
index 83eb79cb..5c506e99 100644
--- a/lib/cherrypy/_cpdispatch.py
+++ b/lib/cherrypy/_cpdispatch.py
@@ -206,12 +206,8 @@ except ImportError:
     def test_callable_spec(callable, args, kwargs):  # noqa: F811
         return None
 else:
-    getargspec = inspect.getargspec
-    # Python 3 requires using getfullargspec if
-    # keyword-only arguments are present
-    if hasattr(inspect, 'getfullargspec'):
-        def getargspec(callable):
-            return inspect.getfullargspec(callable)[:4]
+    def getargspec(callable):
+        return inspect.getfullargspec(callable)[:4]
 
 
 class LateParamPageHandler(PageHandler):
diff --git a/lib/cherrypy/_cperror.py b/lib/cherrypy/_cperror.py
index 4e727682..f6ff2913 100644
--- a/lib/cherrypy/_cperror.py
+++ b/lib/cherrypy/_cperror.py
@@ -466,7 +466,7 @@ _HTTPErrorTemplate = '''<!DOCTYPE html PUBLIC
         <pre id="traceback">%(traceback)s</pre>
     <div id="powered_by">
       <span>
-        Powered by <a href="http://www.cherrypy.org">CherryPy %(version)s</a>
+        Powered by <a href="http://www.cherrypy.dev">CherryPy %(version)s</a>
       </span>
     </div>
     </body>
@@ -532,7 +532,8 @@ def get_error_page(status, **kwargs):
                     return result
             else:
                 # Load the template from this path.
-                template = io.open(error_page, newline='').read()
+                with io.open(error_page, newline='') as f:
+                    template = f.read()
         except Exception:
             e = _format_exception(*_exc_info())[-1]
             m = kwargs['message']
diff --git a/lib/cherrypy/_cpmodpy.py b/lib/cherrypy/_cpmodpy.py
index 0e608c48..a08f0ed9 100644
--- a/lib/cherrypy/_cpmodpy.py
+++ b/lib/cherrypy/_cpmodpy.py
@@ -339,11 +339,8 @@ LoadModule python_module modules/mod_python.so
                                      }
 
         mpconf = os.path.join(os.path.dirname(__file__), 'cpmodpy.conf')
-        f = open(mpconf, 'wb')
-        try:
+        with open(mpconf, 'wb') as f:
             f.write(conf_data)
-        finally:
-            f.close()
 
         response = read_process(self.apache_path, '-k start -f %s' % mpconf)
         self.ready = True
diff --git a/lib/cherrypy/_cprequest.py b/lib/cherrypy/_cprequest.py
index 9b86bd67..a661112c 100644
--- a/lib/cherrypy/_cprequest.py
+++ b/lib/cherrypy/_cprequest.py
@@ -169,7 +169,7 @@ def request_namespace(k, v):
 def response_namespace(k, v):
     """Attach response attributes declared in config."""
     # Provides config entries to set default response headers
-    # http://cherrypy.org/ticket/889
+    # http://cherrypy.dev/ticket/889
     if k[:8] == 'headers.':
         cherrypy.serving.response.headers[k.split('.', 1)[1]] = v
     else:
@@ -252,7 +252,7 @@ class Request(object):
     The query component of the Request-URI, a string of information to be
     interpreted by the resource. The query portion of a URI follows the
     path component, and is separated by a '?'. For example, the URI
-    'http://www.cherrypy.org/wiki?a=3&b=4' has the query component,
+    'http://www.cherrypy.dev/wiki?a=3&b=4' has the query component,
     'a=3&b=4'."""
 
     query_string_encoding = 'utf8'
@@ -742,6 +742,9 @@ class Request(object):
             if self.protocol >= (1, 1):
                 msg = "HTTP/1.1 requires a 'Host' request header."
                 raise cherrypy.HTTPError(400, msg)
+        else:
+            headers['Host'] = httputil.SanitizedHost(dict.get(headers, 'Host'))
+
         host = dict.get(headers, 'Host')
         if not host:
             host = self.local.name or self.local.ip
diff --git a/lib/cherrypy/lib/auth_digest.py b/lib/cherrypy/lib/auth_digest.py
index fbb5df64..981e9a5d 100644
--- a/lib/cherrypy/lib/auth_digest.py
+++ b/lib/cherrypy/lib/auth_digest.py
@@ -101,13 +101,12 @@ def get_ha1_file_htdigest(filename):
     """
     def get_ha1(realm, username):
         result = None
-        f = open(filename, 'r')
-        for line in f:
-            u, r, ha1 = line.rstrip().split(':')
-            if u == username and r == realm:
-                result = ha1
-                break
-        f.close()
+        with open(filename, 'r') as f:
+            for line in f:
+                u, r, ha1 = line.rstrip().split(':')
+                if u == username and r == realm:
+                    result = ha1
+                    break
         return result
 
     return get_ha1
diff --git a/lib/cherrypy/lib/covercp.py b/lib/cherrypy/lib/covercp.py
index 3e219713..6c3871fc 100644
--- a/lib/cherrypy/lib/covercp.py
+++ b/lib/cherrypy/lib/covercp.py
@@ -334,9 +334,10 @@ class CoverStats(object):
         yield '</body></html>'
 
     def annotated_file(self, filename, statements, excluded, missing):
-        source = open(filename, 'r')
+        with open(filename, 'r') as source:
+            lines = source.readlines()
         buffer = []
-        for lineno, line in enumerate(source.readlines()):
+        for lineno, line in enumerate(lines):
             lineno += 1
             line = line.strip('\n\r')
             empty_the_buffer = True
diff --git a/lib/cherrypy/lib/httputil.py b/lib/cherrypy/lib/httputil.py
index eedf8d89..ced310a0 100644
--- a/lib/cherrypy/lib/httputil.py
+++ b/lib/cherrypy/lib/httputil.py
@@ -516,3 +516,33 @@ class Host(object):
 
     def __repr__(self):
         return 'httputil.Host(%r, %r, %r)' % (self.ip, self.port, self.name)
+
+
+class SanitizedHost(str):
+    r"""
+    Wraps a raw host header received from the network in
+    a sanitized version that elides dangerous characters.
+
+    >>> SanitizedHost('foo\nbar')
+    'foobar'
+    >>> SanitizedHost('foo\nbar').raw
+    'foo\nbar'
+
+    A SanitizedInstance is only returned if sanitization was performed.
+
+    >>> isinstance(SanitizedHost('foobar'), SanitizedHost)
+    False
+    """
+    dangerous = re.compile(r'[\n\r]')
+
+    def __new__(cls, raw):
+        sanitized = cls._sanitize(raw)
+        if sanitized == raw:
+            return raw
+        instance = super().__new__(cls, sanitized)
+        instance.raw = raw
+        return instance
+
+    @classmethod
+    def _sanitize(cls, raw):
+        return cls.dangerous.sub('', raw)
diff --git a/lib/cherrypy/lib/reprconf.py b/lib/cherrypy/lib/reprconf.py
index 3976652e..76381d7b 100644
--- a/lib/cherrypy/lib/reprconf.py
+++ b/lib/cherrypy/lib/reprconf.py
@@ -163,11 +163,8 @@ class Parser(configparser.ConfigParser):
             #     fp = open(filename)
             # except IOError:
             #     continue
-            fp = open(filename)
-            try:
+            with open(filename) as fp:
                 self._read(fp, filename)
-            finally:
-                fp.close()
 
     def as_dict(self, raw=False, vars=None):
         """Convert an INI file to a dictionary"""
diff --git a/lib/cherrypy/lib/sessions.py b/lib/cherrypy/lib/sessions.py
index 5b3328f2..0f56a4fa 100644
--- a/lib/cherrypy/lib/sessions.py
+++ b/lib/cherrypy/lib/sessions.py
@@ -516,11 +516,8 @@ class FileSession(Session):
         if path is None:
             path = self._get_file_path()
         try:
-            f = open(path, 'rb')
-            try:
+            with open(path, 'rb') as f:
                 return pickle.load(f)
-            finally:
-                f.close()
         except (IOError, EOFError):
             e = sys.exc_info()[1]
             if self.debug:
@@ -531,11 +528,8 @@ class FileSession(Session):
     def _save(self, expiration_time):
         assert self.locked, ('The session was saved without being locked.  '
                              "Check your tools' priority levels.")
-        f = open(self._get_file_path(), 'wb')
-        try:
+        with open(self._get_file_path(), 'wb') as f:
             pickle.dump((self._data, expiration_time), f, self.pickle_protocol)
-        finally:
-            f.close()
 
     def _delete(self):
         assert self.locked, ('The session deletion without being locked.  '
diff --git a/lib/cherrypy/process/plugins.py b/lib/cherrypy/process/plugins.py
index 2a9952de..e96fb1ce 100644
--- a/lib/cherrypy/process/plugins.py
+++ b/lib/cherrypy/process/plugins.py
@@ -436,7 +436,8 @@ class PIDFile(SimplePlugin):
         if self.finalized:
             self.bus.log('PID %r already written to %r.' % (pid, self.pidfile))
         else:
-            open(self.pidfile, 'wb').write(ntob('%s\n' % pid, 'utf8'))
+            with open(self.pidfile, 'wb') as f:
+                f.write(ntob('%s\n' % pid, 'utf8'))
             self.bus.log('PID %r written to %r.' % (pid, self.pidfile))
             self.finalized = True
     start.priority = 70
diff --git a/lib/cherrypy/test/helper.py b/lib/cherrypy/test/helper.py
index c1ca4535..cae49533 100644
--- a/lib/cherrypy/test/helper.py
+++ b/lib/cherrypy/test/helper.py
@@ -505,7 +505,8 @@ server.ssl_private_key: r'%s'
 
     def get_pid(self):
         if self.daemonize:
-            return int(open(self.pid_file, 'rb').read())
+            with open(self.pid_file, 'rb') as f:
+                return int(f.read())
         return self._proc.pid
 
     def join(self):
diff --git a/lib/cherrypy/test/logtest.py b/lib/cherrypy/test/logtest.py
index 344be987..112bdc25 100644
--- a/lib/cherrypy/test/logtest.py
+++ b/lib/cherrypy/test/logtest.py
@@ -97,7 +97,8 @@ class LogCase(object):
 
     def emptyLog(self):
         """Overwrite self.logfile with 0 bytes."""
-        open(self.logfile, 'wb').write('')
+        with open(self.logfile, 'wb') as f:
+            f.write('')
 
     def markLog(self, key=None):
         """Insert a marker line into the log and set self.lastmarker."""
@@ -105,10 +106,11 @@ class LogCase(object):
             key = str(time.time())
         self.lastmarker = key
 
-        open(self.logfile, 'ab+').write(
-            b'%s%s\n'
-            % (self.markerPrefix, key.encode('utf-8'))
-        )
+        with open(self.logfile, 'ab+') as f:
+            f.write(
+                b'%s%s\n'
+                % (self.markerPrefix, key.encode('utf-8'))
+            )
 
     def _read_marked_region(self, marker=None):
         """Return lines from self.logfile in the marked region.
@@ -122,20 +124,23 @@ class LogCase(object):
         logfile = self.logfile
         marker = marker or self.lastmarker
         if marker is None:
-            return open(logfile, 'rb').readlines()
+            with open(logfile, 'rb') as f:
+                return f.readlines()
 
         if isinstance(marker, str):
             marker = marker.encode('utf-8')
         data = []
         in_region = False
-        for line in open(logfile, 'rb'):
-            if in_region:
-                if line.startswith(self.markerPrefix) and marker not in line:
-                    break
-                else:
-                    data.append(line)
-            elif marker in line:
-                in_region = True
+        with open(logfile, 'rb') as f:
+            for line in f:
+                if in_region:
+                    if (line.startswith(self.markerPrefix)
+                            and marker not in line):
+                        break
+                    else:
+                        data.append(line)
+                elif marker in line:
+                    in_region = True
         return data
 
     def assertInLog(self, line, marker=None):
diff --git a/lib/cherrypy/test/modfastcgi.py b/lib/cherrypy/test/modfastcgi.py
index 79ec3d18..16927d3c 100644
--- a/lib/cherrypy/test/modfastcgi.py
+++ b/lib/cherrypy/test/modfastcgi.py
@@ -14,7 +14,7 @@ KNOWN BUGS
 
 1. Apache processes Range headers automatically; CherryPy's truncated
     output is then truncated again by Apache. See test_core.testRanges.
-    This was worked around in http://www.cherrypy.org/changeset/1319.
+    This was worked around in http://www.cherrypy.dev/changeset/1319.
 2. Apache does not allow custom HTTP methods like CONNECT as per the spec.
     See test_core.testHTTPMethods.
 3. Max request header and body settings do not work with Apache.
@@ -112,15 +112,12 @@ class ModFCGISupervisor(helper.LocalWSGISupervisor):
             fcgiconf = os.path.join(curdir, fcgiconf)
 
         # Write the Apache conf file.
-        f = open(fcgiconf, 'wb')
-        try:
+        with open(fcgiconf, 'wb') as f:
             server = repr(os.path.join(curdir, 'fastcgi.pyc'))[1:-1]
             output = self.template % {'port': self.port, 'root': curdir,
                                       'server': server}
             output = output.replace('\r\n', '\n')
             f.write(output)
-        finally:
-            f.close()
 
         result = read_process(APACHE_PATH, '-k start -f %s' % fcgiconf)
         if result:
diff --git a/lib/cherrypy/test/modfcgid.py b/lib/cherrypy/test/modfcgid.py
index d101bd67..6dd48a94 100644
--- a/lib/cherrypy/test/modfcgid.py
+++ b/lib/cherrypy/test/modfcgid.py
@@ -14,7 +14,7 @@ KNOWN BUGS
 
 1. Apache processes Range headers automatically; CherryPy's truncated
     output is then truncated again by Apache. See test_core.testRanges.
-    This was worked around in http://www.cherrypy.org/changeset/1319.
+    This was worked around in http://www.cherrypy.dev/changeset/1319.
 2. Apache does not allow custom HTTP methods like CONNECT as per the spec.
     See test_core.testHTTPMethods.
 3. Max request header and body settings do not work with Apache.
@@ -101,15 +101,12 @@ class ModFCGISupervisor(helper.LocalSupervisor):
             fcgiconf = os.path.join(curdir, fcgiconf)
 
         # Write the Apache conf file.
-        f = open(fcgiconf, 'wb')
-        try:
+        with open(fcgiconf, 'wb') as f:
             server = repr(os.path.join(curdir, 'fastcgi.pyc'))[1:-1]
             output = self.template % {'port': self.port, 'root': curdir,
                                       'server': server}
             output = ntob(output.replace('\r\n', '\n'))
             f.write(output)
-        finally:
-            f.close()
 
         result = read_process(APACHE_PATH, '-k start -f %s' % fcgiconf)
         if result:
diff --git a/lib/cherrypy/test/modpy.py b/lib/cherrypy/test/modpy.py
index 7c288d2c..f4f68523 100644
--- a/lib/cherrypy/test/modpy.py
+++ b/lib/cherrypy/test/modpy.py
@@ -15,7 +15,7 @@ KNOWN BUGS
 
 1. Apache processes Range headers automatically; CherryPy's truncated
     output is then truncated again by Apache. See test_core.testRanges.
-    This was worked around in http://www.cherrypy.org/changeset/1319.
+    This was worked around in http://www.cherrypy.dev/changeset/1319.
 2. Apache does not allow custom HTTP methods like CONNECT as per the spec.
     See test_core.testHTTPMethods.
 3. Max request header and body settings do not work with Apache.
@@ -107,13 +107,10 @@ class ModPythonSupervisor(helper.Supervisor):
         if not os.path.isabs(mpconf):
             mpconf = os.path.join(curdir, mpconf)
 
-        f = open(mpconf, 'wb')
-        try:
+        with open(mpconf, 'wb') as f:
             f.write(self.template %
                     {'port': self.port, 'modulename': modulename,
                      'host': self.host})
-        finally:
-            f.close()
 
         result = read_process(APACHE_PATH, '-k start -f %s' % mpconf)
         if result:
diff --git a/lib/cherrypy/test/modwsgi.py b/lib/cherrypy/test/modwsgi.py
index da7d240b..c3216284 100644
--- a/lib/cherrypy/test/modwsgi.py
+++ b/lib/cherrypy/test/modwsgi.py
@@ -11,7 +11,7 @@ KNOWN BUGS
 
 1. Apache processes Range headers automatically; CherryPy's truncated
     output is then truncated again by Apache. See test_core.testRanges.
-    This was worked around in http://www.cherrypy.org/changeset/1319.
+    This was worked around in http://www.cherrypy.dev/changeset/1319.
 2. Apache does not allow custom HTTP methods like CONNECT as per the spec.
     See test_core.testHTTPMethods.
 3. Max request header and body settings do not work with Apache.
@@ -109,14 +109,11 @@ class ModWSGISupervisor(helper.Supervisor):
         if not os.path.isabs(mpconf):
             mpconf = os.path.join(curdir, mpconf)
 
-        f = open(mpconf, 'wb')
-        try:
+        with open(mpconf, 'wb') as f:
             output = (self.template %
                       {'port': self.port, 'testmod': modulename,
                        'curdir': curdir})
             f.write(output)
-        finally:
-            f.close()
 
         result = read_process(APACHE_PATH, '-k start -f %s' % mpconf)
         if result:
diff --git a/lib/cherrypy/test/test_auth_basic.py b/lib/cherrypy/test/test_auth_basic.py
index d7e69a9b..f178f8f9 100644
--- a/lib/cherrypy/test/test_auth_basic.py
+++ b/lib/cherrypy/test/test_auth_basic.py
@@ -1,4 +1,4 @@
-# This file is part of CherryPy <http://www.cherrypy.org/>
+# This file is part of CherryPy <http://www.cherrypy.dev/>
 # -*- coding: utf-8 -*-
 # vim:ts=4:sw=4:expandtab:fileencoding=utf-8
 
diff --git a/lib/cherrypy/test/test_auth_digest.py b/lib/cherrypy/test/test_auth_digest.py
index 745f89e6..4b7b5298 100644
--- a/lib/cherrypy/test/test_auth_digest.py
+++ b/lib/cherrypy/test/test_auth_digest.py
@@ -1,4 +1,4 @@
-# This file is part of CherryPy <http://www.cherrypy.org/>
+# This file is part of CherryPy <http://www.cherrypy.dev/>
 # -*- coding: utf-8 -*-
 # vim:ts=4:sw=4:expandtab:fileencoding=utf-8
 
diff --git a/lib/cherrypy/test/test_core.py b/lib/cherrypy/test/test_core.py
index 6fde3a97..42460b3f 100644
--- a/lib/cherrypy/test/test_core.py
+++ b/lib/cherrypy/test/test_core.py
@@ -586,9 +586,8 @@ class CoreRequestHandlingTest(helper.CPWebCase):
     def testFavicon(self):
         # favicon.ico is served by staticfile.
         icofilename = os.path.join(localDir, '../favicon.ico')
-        icofile = open(icofilename, 'rb')
-        data = icofile.read()
-        icofile.close()
+        with open(icofilename, 'rb') as icofile:
+            data = icofile.read()
 
         self.getPage('/favicon.ico')
         self.assertBody(data)
diff --git a/lib/cherrypy/test/test_encoding.py b/lib/cherrypy/test/test_encoding.py
index 882d7a5b..6075103d 100644
--- a/lib/cherrypy/test/test_encoding.py
+++ b/lib/cherrypy/test/test_encoding.py
@@ -46,7 +46,7 @@ class EncodingTests(helper.CPWebCase):
                 #  any part which is unicode (even ascii), the response
                 #  should not fail.
                 cherrypy.response.cookie['candy'] = 'bar'
-                cherrypy.response.cookie['candy']['domain'] = 'cherrypy.org'
+                cherrypy.response.cookie['candy']['domain'] = 'cherrypy.dev'
                 cherrypy.response.headers[
                     'Some-Header'] = 'My d\xc3\xb6g has fleas'
                 cherrypy.response.headers[
diff --git a/lib/cherrypy/test/test_logging.py b/lib/cherrypy/test/test_logging.py
index 5308fb72..2d4aa56f 100644
--- a/lib/cherrypy/test/test_logging.py
+++ b/lib/cherrypy/test/test_logging.py
@@ -113,7 +113,7 @@ def test_normal_return(log_tracker, server):
     resp = requests.get(
         'http://%s:%s/as_string' % (host, port),
         headers={
-            'Referer': 'http://www.cherrypy.org/',
+            'Referer': 'http://www.cherrypy.dev/',
             'User-Agent': 'Mozilla/5.0',
         },
     )
@@ -135,7 +135,7 @@ def test_normal_return(log_tracker, server):
     log_tracker.assertLog(
         -1,
         '] "GET /as_string HTTP/1.1" 200 %s '
-        '"http://www.cherrypy.org/" "Mozilla/5.0"'
+        '"http://www.cherrypy.dev/" "Mozilla/5.0"'
         % content_length,
     )
 
diff --git a/lib/cherrypy/test/test_request_obj.py b/lib/cherrypy/test/test_request_obj.py
index 31023e8f..2478aabe 100644
--- a/lib/cherrypy/test/test_request_obj.py
+++ b/lib/cherrypy/test/test_request_obj.py
@@ -342,7 +342,7 @@ class RequestObjectTests(helper.CPWebCase):
         self.assertBody('/pathinfo/foo/bar')
 
     def testAbsoluteURIPathInfo(self):
-        # http://cherrypy.org/ticket/1061
+        # http://cherrypy.dev/ticket/1061
         self.getPage('http://localhost/pathinfo/foo/bar')
         self.assertBody('/pathinfo/foo/bar')
 
@@ -375,10 +375,10 @@ class RequestObjectTests(helper.CPWebCase):
 
         # Make sure that encoded = and & get parsed correctly
         self.getPage(
-            '/params/code?url=http%3A//cherrypy.org/index%3Fa%3D1%26b%3D2')
+            '/params/code?url=http%3A//cherrypy.dev/index%3Fa%3D1%26b%3D2')
         self.assertBody('args: %s kwargs: %s' %
                         (('code',),
-                         [('url', ntou('http://cherrypy.org/index?a=1&b=2'))]))
+                         [('url', ntou('http://cherrypy.dev/index?a=1&b=2'))]))
 
         # Test coordinates sent by <img ismap>
         self.getPage('/params/ismap?223,114')
@@ -756,6 +756,16 @@ class RequestObjectTests(helper.CPWebCase):
                      headers=[('Content-type', 'application/json')])
         self.assertBody('application/json')
 
+    def test_dangerous_host(self):
+        """
+        Dangerous characters like newlines should be elided.
+        Ref #1974.
+        """
+        # foo\nbar
+        encoded = '=?iso-8859-1?q?foo=0Abar?='
+        self.getPage('/headers/Host', headers=[('Host', encoded)])
+        self.assertBody('foobar')
+
     def test_basic_HTTPMethods(self):
         helper.webtest.methods_with_bodies = ('POST', 'PUT', 'PROPFIND',
                                               'PATCH')
diff --git a/lib/cherrypy/test/test_states.py b/lib/cherrypy/test/test_states.py
index 28dd6510..d59a4d87 100644
--- a/lib/cherrypy/test/test_states.py
+++ b/lib/cherrypy/test/test_states.py
@@ -424,11 +424,12 @@ test_case_name: "test_signal_handler_unsubscribe"
         p.join()
 
         # Assert the old handler ran.
-        log_lines = list(open(p.error_log, 'rb'))
-        assert any(
-            line.endswith(b'I am an old SIGTERM handler.\n')
-            for line in log_lines
-        )
+        with open(p.error_log, 'rb') as f:
+            log_lines = list(f)
+            assert any(
+                line.endswith(b'I am an old SIGTERM handler.\n')
+                for line in log_lines
+            )
 
 
 def test_safe_wait_INADDR_ANY():  # pylint: disable=invalid-name
diff --git a/lib/cherrypy/test/test_tutorials.py b/lib/cherrypy/test/test_tutorials.py
index 39ca4d6f..390caac8 100644
--- a/lib/cherrypy/test/test_tutorials.py
+++ b/lib/cherrypy/test/test_tutorials.py
@@ -78,7 +78,7 @@ class TutorialTest(helper.CPWebCase):
 
             <ul>
                 <li><a href="http://del.icio.us">del.icio.us</a></li>
-                <li><a href="http://www.cherrypy.org">CherryPy</a></li>
+                <li><a href="http://www.cherrypy.dev">CherryPy</a></li>
             </ul>
 
             <p>[<a href="../">Return to links page</a>]</p>'''
@@ -166,7 +166,7 @@ class TutorialTest(helper.CPWebCase):
         self.assertHeader('Content-Disposition',
                           # Make sure the filename is quoted.
                           'attachment; filename="pdf_file.pdf"')
-        self.assertEqual(len(self.body), 85698)
+        self.assertEqual(len(self.body), 11961)
 
     def test10HTTPErrors(self):
         self.setup_tutorial('tut10_http_errors', 'HTTPErrorDemo')
diff --git a/lib/cherrypy/tutorial/pdf_file.pdf b/lib/cherrypy/tutorial/pdf_file.pdf
index 38b4f15eabdd65d4a674cb32034361245aa7b97e..226dfe18f73406a8f56c1a4b3508ca5e3601853f 100644
GIT binary patch
literal 11961
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

literal 85698
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

diff --git a/lib/cherrypy/tutorial/tut04_complex_site.py b/lib/cherrypy/tutorial/tut04_complex_site.py
index 3caa1775..fe04054f 100644
--- a/lib/cherrypy/tutorial/tut04_complex_site.py
+++ b/lib/cherrypy/tutorial/tut04_complex_site.py
@@ -53,7 +53,7 @@ class LinksPage:
 
             <ul>
                 <li>
-                    <a href="http://www.cherrypy.org">The CherryPy Homepage</a>
+                    <a href="http://www.cherrypy.dev">The CherryPy Homepage</a>
                 </li>
                 <li>
                     <a href="http://www.python.org">The Python Homepage</a>
@@ -77,7 +77,7 @@ class ExtraLinksPage:
 
             <ul>
                 <li><a href="http://del.icio.us">del.icio.us</a></li>
-                <li><a href="http://www.cherrypy.org">CherryPy</a></li>
+                <li><a href="http://www.cherrypy.dev">CherryPy</a></li>
             </ul>
 
             <p>[<a href="../">Return to links page</a>]</p>'''
diff --git a/lib/inflect/__init__.py b/lib/inflect/__init__.py
new file mode 100644
index 00000000..78d2e33c
--- /dev/null
+++ b/lib/inflect/__init__.py
@@ -0,0 +1,3991 @@
+"""
+inflect: english language inflection
+ - correctly generate plurals, ordinals, indefinite articles
+ - convert numbers to words
+
+Copyright (C) 2010 Paul Dyson
+
+Based upon the Perl module
+`Lingua::EN::Inflect <https://metacpan.org/pod/Lingua::EN::Inflect>`_.
+
+methods:
+    classical inflect
+    plural plural_noun plural_verb plural_adj singular_noun no num a an
+    compare compare_nouns compare_verbs compare_adjs
+    present_participle
+    ordinal
+    number_to_words
+    join
+    defnoun defverb defadj defa defan
+
+INFLECTIONS:
+    classical inflect
+    plural plural_noun plural_verb plural_adj singular_noun compare
+    no num a an present_participle
+
+PLURALS:
+    classical inflect
+    plural plural_noun plural_verb plural_adj singular_noun no num
+    compare compare_nouns compare_verbs compare_adjs
+
+COMPARISONS:
+    classical
+    compare compare_nouns compare_verbs compare_adjs
+
+ARTICLES:
+    classical inflect num a an
+
+NUMERICAL:
+    ordinal number_to_words
+
+USER_DEFINED:
+    defnoun defverb defadj defa defan
+
+Exceptions:
+ UnknownClassicalModeError
+ BadNumValueError
+ BadChunkingOptionError
+ NumOutOfRangeError
+ BadUserDefinedPatternError
+ BadRcFileError
+ BadGenderError
+
+"""
+
+import ast
+import re
+import functools
+import collections
+import contextlib
+from typing import (
+    Dict,
+    Union,
+    Optional,
+    Iterable,
+    List,
+    Match,
+    Tuple,
+    Callable,
+    Sequence,
+    cast,
+    Any,
+)
+from numbers import Number
+
+
+from pydantic import Field, validate_arguments
+from pydantic.typing import Annotated
+
+
+class UnknownClassicalModeError(Exception):
+    pass
+
+
+class BadNumValueError(Exception):
+    pass
+
+
+class BadChunkingOptionError(Exception):
+    pass
+
+
+class NumOutOfRangeError(Exception):
+    pass
+
+
+class BadUserDefinedPatternError(Exception):
+    pass
+
+
+class BadRcFileError(Exception):
+    pass
+
+
+class BadGenderError(Exception):
+    pass
+
+
+STDOUT_ON = False
+
+
+def print3(txt: str) -> None:
+    if STDOUT_ON:
+        print(txt)
+
+
+def enclose(s: str) -> str:
+    return f"(?:{s})"
+
+
+def joinstem(cutpoint: Optional[int] = 0, words: Optional[Iterable[str]] = None) -> str:
+    """
+    Join stem of each word in words into a string for regex.
+
+    Each word is truncated at cutpoint.
+
+    Cutpoint is usually negative indicating the number of letters to remove
+    from the end of each word.
+
+    >>> joinstem(-2, ["ephemeris", "iris", ".*itis"])
+    '(?:ephemer|ir|.*it)'
+
+    >>> joinstem(None, ["ephemeris"])
+    '(?:ephemeris)'
+
+    >>> joinstem(5, None)
+    '(?:)'
+    """
+    return enclose("|".join(w[:cutpoint] for w in words or []))
+
+
+def bysize(words: Iterable[str]) -> Dict[int, set]:
+    """
+    From a list of words, return a dict of sets sorted by word length.
+
+    >>> words = ['ant', 'cat', 'dog', 'pig', 'frog', 'goat', 'horse', 'elephant']
+    >>> ret = bysize(words)
+    >>> sorted(ret[3])
+    ['ant', 'cat', 'dog', 'pig']
+    >>> ret[5]
+    {'horse'}
+    """
+    res: Dict[int, set] = collections.defaultdict(set)
+    for w in words:
+        res[len(w)].add(w)
+    return res
+
+
+def make_pl_si_lists(
+    lst: Iterable[str],
+    plending: str,
+    siendingsize: Optional[int],
+    dojoinstem: bool = True,
+):
+    """
+    given a list of singular words: lst
+
+    an ending to append to make the plural: plending
+
+    the number of characters to remove from the singular
+    before appending plending: siendingsize
+
+    a flag whether to create a joinstem: dojoinstem
+
+    return:
+    a list of pluralised words: si_list (called si because this is what you need to
+    look for to make the singular)
+
+    the pluralised words as a dict of sets sorted by word length: si_bysize
+    the singular words as a dict of sets sorted by word length: pl_bysize
+    if dojoinstem is True: a regular expression that matches any of the stems: stem
+    """
+    if siendingsize is not None:
+        siendingsize = -siendingsize
+    si_list = [w[:siendingsize] + plending for w in lst]
+    pl_bysize = bysize(lst)
+    si_bysize = bysize(si_list)
+    if dojoinstem:
+        stem = joinstem(siendingsize, lst)
+        return si_list, si_bysize, pl_bysize, stem
+    else:
+        return si_list, si_bysize, pl_bysize
+
+
+# 1. PLURALS
+
+pl_sb_irregular_s = {
+    "corpus": "corpuses|corpora",
+    "opus": "opuses|opera",
+    "genus": "genera",
+    "mythos": "mythoi",
+    "penis": "penises|penes",
+    "testis": "testes",
+    "atlas": "atlases|atlantes",
+    "yes": "yeses",
+}
+
+pl_sb_irregular = {
+    "child": "children",
+    "chili": "chilis|chilies",
+    "brother": "brothers|brethren",
+    "infinity": "infinities|infinity",
+    "loaf": "loaves",
+    "lore": "lores|lore",
+    "hoof": "hoofs|hooves",
+    "beef": "beefs|beeves",
+    "thief": "thiefs|thieves",
+    "money": "monies",
+    "mongoose": "mongooses",
+    "ox": "oxen",
+    "cow": "cows|kine",
+    "graffito": "graffiti",
+    "octopus": "octopuses|octopodes",
+    "genie": "genies|genii",
+    "ganglion": "ganglions|ganglia",
+    "trilby": "trilbys",
+    "turf": "turfs|turves",
+    "numen": "numina",
+    "atman": "atmas",
+    "occiput": "occiputs|occipita",
+    "sabretooth": "sabretooths",
+    "sabertooth": "sabertooths",
+    "lowlife": "lowlifes",
+    "flatfoot": "flatfoots",
+    "tenderfoot": "tenderfoots",
+    "romany": "romanies",
+    "jerry": "jerries",
+    "mary": "maries",
+    "talouse": "talouses",
+    "rom": "roma",
+    "carmen": "carmina",
+}
+
+pl_sb_irregular.update(pl_sb_irregular_s)
+# pl_sb_irregular_keys = enclose('|'.join(pl_sb_irregular.keys()))
+
+pl_sb_irregular_caps = {
+    "Romany": "Romanies",
+    "Jerry": "Jerrys",
+    "Mary": "Marys",
+    "Rom": "Roma",
+}
+
+pl_sb_irregular_compound = {"prima donna": "prima donnas|prime donne"}
+
+si_sb_irregular = {v: k for (k, v) in pl_sb_irregular.items()}
+for k in list(si_sb_irregular):
+    if "|" in k:
+        k1, k2 = k.split("|")
+        si_sb_irregular[k1] = si_sb_irregular[k2] = si_sb_irregular[k]
+        del si_sb_irregular[k]
+si_sb_irregular_caps = {v: k for (k, v) in pl_sb_irregular_caps.items()}
+si_sb_irregular_compound = {v: k for (k, v) in pl_sb_irregular_compound.items()}
+for k in list(si_sb_irregular_compound):
+    if "|" in k:
+        k1, k2 = k.split("|")
+        si_sb_irregular_compound[k1] = si_sb_irregular_compound[
+            k2
+        ] = si_sb_irregular_compound[k]
+        del si_sb_irregular_compound[k]
+
+# si_sb_irregular_keys = enclose('|'.join(si_sb_irregular.keys()))
+
+# Z's that don't double
+
+pl_sb_z_zes_list = ("quartz", "topaz")
+pl_sb_z_zes_bysize = bysize(pl_sb_z_zes_list)
+
+pl_sb_ze_zes_list = ("snooze",)
+pl_sb_ze_zes_bysize = bysize(pl_sb_ze_zes_list)
+
+
+# CLASSICAL "..is" -> "..ides"
+
+pl_sb_C_is_ides_complete = [
+    # GENERAL WORDS...
+    "ephemeris",
+    "iris",
+    "clitoris",
+    "chrysalis",
+    "epididymis",
+]
+
+pl_sb_C_is_ides_endings = [
+    # INFLAMATIONS...
+    "itis"
+]
+
+pl_sb_C_is_ides = joinstem(
+    -2, pl_sb_C_is_ides_complete + [f".*{w}" for w in pl_sb_C_is_ides_endings]
+)
+
+pl_sb_C_is_ides_list = pl_sb_C_is_ides_complete + pl_sb_C_is_ides_endings
+
+(
+    si_sb_C_is_ides_list,
+    si_sb_C_is_ides_bysize,
+    pl_sb_C_is_ides_bysize,
+) = make_pl_si_lists(pl_sb_C_is_ides_list, "ides", 2, dojoinstem=False)
+
+
+# CLASSICAL "..a" -> "..ata"
+
+pl_sb_C_a_ata_list = (
+    "anathema",
+    "bema",
+    "carcinoma",
+    "charisma",
+    "diploma",
+    "dogma",
+    "drama",
+    "edema",
+    "enema",
+    "enigma",
+    "lemma",
+    "lymphoma",
+    "magma",
+    "melisma",
+    "miasma",
+    "oedema",
+    "sarcoma",
+    "schema",
+    "soma",
+    "stigma",
+    "stoma",
+    "trauma",
+    "gumma",
+    "pragma",
+)
+
+(
+    si_sb_C_a_ata_list,
+    si_sb_C_a_ata_bysize,
+    pl_sb_C_a_ata_bysize,
+    pl_sb_C_a_ata,
+) = make_pl_si_lists(pl_sb_C_a_ata_list, "ata", 1)
+
+# UNCONDITIONAL "..a" -> "..ae"
+
+pl_sb_U_a_ae_list = (
+    "alumna",
+    "alga",
+    "vertebra",
+    "persona",
+    "vita",
+)
+(
+    si_sb_U_a_ae_list,
+    si_sb_U_a_ae_bysize,
+    pl_sb_U_a_ae_bysize,
+    pl_sb_U_a_ae,
+) = make_pl_si_lists(pl_sb_U_a_ae_list, "e", None)
+
+# CLASSICAL "..a" -> "..ae"
+
+pl_sb_C_a_ae_list = (
+    "amoeba",
+    "antenna",
+    "formula",
+    "hyperbola",
+    "medusa",
+    "nebula",
+    "parabola",
+    "abscissa",
+    "hydra",
+    "nova",
+    "lacuna",
+    "aurora",
+    "umbra",
+    "flora",
+    "fauna",
+)
+(
+    si_sb_C_a_ae_list,
+    si_sb_C_a_ae_bysize,
+    pl_sb_C_a_ae_bysize,
+    pl_sb_C_a_ae,
+) = make_pl_si_lists(pl_sb_C_a_ae_list, "e", None)
+
+
+# CLASSICAL "..en" -> "..ina"
+
+pl_sb_C_en_ina_list = ("stamen", "foramen", "lumen")
+
+(
+    si_sb_C_en_ina_list,
+    si_sb_C_en_ina_bysize,
+    pl_sb_C_en_ina_bysize,
+    pl_sb_C_en_ina,
+) = make_pl_si_lists(pl_sb_C_en_ina_list, "ina", 2)
+
+
+# UNCONDITIONAL "..um" -> "..a"
+
+pl_sb_U_um_a_list = (
+    "bacterium",
+    "agendum",
+    "desideratum",
+    "erratum",
+    "stratum",
+    "datum",
+    "ovum",
+    "extremum",
+    "candelabrum",
+)
+(
+    si_sb_U_um_a_list,
+    si_sb_U_um_a_bysize,
+    pl_sb_U_um_a_bysize,
+    pl_sb_U_um_a,
+) = make_pl_si_lists(pl_sb_U_um_a_list, "a", 2)
+
+# CLASSICAL "..um" -> "..a"
+
+pl_sb_C_um_a_list = (
+    "maximum",
+    "minimum",
+    "momentum",
+    "optimum",
+    "quantum",
+    "cranium",
+    "curriculum",
+    "dictum",
+    "phylum",
+    "aquarium",
+    "compendium",
+    "emporium",
+    "encomium",
+    "gymnasium",
+    "honorarium",
+    "interregnum",
+    "lustrum",
+    "memorandum",
+    "millennium",
+    "rostrum",
+    "spectrum",
+    "speculum",
+    "stadium",
+    "trapezium",
+    "ultimatum",
+    "medium",
+    "vacuum",
+    "velum",
+    "consortium",
+    "arboretum",
+)
+
+(
+    si_sb_C_um_a_list,
+    si_sb_C_um_a_bysize,
+    pl_sb_C_um_a_bysize,
+    pl_sb_C_um_a,
+) = make_pl_si_lists(pl_sb_C_um_a_list, "a", 2)
+
+
+# UNCONDITIONAL "..us" -> "i"
+
+pl_sb_U_us_i_list = (
+    "alumnus",
+    "alveolus",
+    "bacillus",
+    "bronchus",
+    "locus",
+    "nucleus",
+    "stimulus",
+    "meniscus",
+    "sarcophagus",
+)
+(
+    si_sb_U_us_i_list,
+    si_sb_U_us_i_bysize,
+    pl_sb_U_us_i_bysize,
+    pl_sb_U_us_i,
+) = make_pl_si_lists(pl_sb_U_us_i_list, "i", 2)
+
+# CLASSICAL "..us" -> "..i"
+
+pl_sb_C_us_i_list = (
+    "focus",
+    "radius",
+    "genius",
+    "incubus",
+    "succubus",
+    "nimbus",
+    "fungus",
+    "nucleolus",
+    "stylus",
+    "torus",
+    "umbilicus",
+    "uterus",
+    "hippopotamus",
+    "cactus",
+)
+
+(
+    si_sb_C_us_i_list,
+    si_sb_C_us_i_bysize,
+    pl_sb_C_us_i_bysize,
+    pl_sb_C_us_i,
+) = make_pl_si_lists(pl_sb_C_us_i_list, "i", 2)
+
+
+# CLASSICAL "..us" -> "..us"  (ASSIMILATED 4TH DECLENSION LATIN NOUNS)
+
+pl_sb_C_us_us = (
+    "status",
+    "apparatus",
+    "prospectus",
+    "sinus",
+    "hiatus",
+    "impetus",
+    "plexus",
+)
+pl_sb_C_us_us_bysize = bysize(pl_sb_C_us_us)
+
+# UNCONDITIONAL "..on" -> "a"
+
+pl_sb_U_on_a_list = (
+    "criterion",
+    "perihelion",
+    "aphelion",
+    "phenomenon",
+    "prolegomenon",
+    "noumenon",
+    "organon",
+    "asyndeton",
+    "hyperbaton",
+)
+(
+    si_sb_U_on_a_list,
+    si_sb_U_on_a_bysize,
+    pl_sb_U_on_a_bysize,
+    pl_sb_U_on_a,
+) = make_pl_si_lists(pl_sb_U_on_a_list, "a", 2)
+
+# CLASSICAL "..on" -> "..a"
+
+pl_sb_C_on_a_list = ("oxymoron",)
+
+(
+    si_sb_C_on_a_list,
+    si_sb_C_on_a_bysize,
+    pl_sb_C_on_a_bysize,
+    pl_sb_C_on_a,
+) = make_pl_si_lists(pl_sb_C_on_a_list, "a", 2)
+
+
+# CLASSICAL "..o" -> "..i"  (BUT NORMALLY -> "..os")
+
+pl_sb_C_o_i = [
+    "solo",
+    "soprano",
+    "basso",
+    "alto",
+    "contralto",
+    "tempo",
+    "piano",
+    "virtuoso",
+]  # list not tuple so can concat for pl_sb_U_o_os
+
+pl_sb_C_o_i_bysize = bysize(pl_sb_C_o_i)
+si_sb_C_o_i_bysize = bysize([f"{w[:-1]}i" for w in pl_sb_C_o_i])
+
+pl_sb_C_o_i_stems = joinstem(-1, pl_sb_C_o_i)
+
+# ALWAYS "..o" -> "..os"
+
+pl_sb_U_o_os_complete = {"ado", "ISO", "NATO", "NCO", "NGO", "oto"}
+si_sb_U_o_os_complete = {f"{w}s" for w in pl_sb_U_o_os_complete}
+
+
+pl_sb_U_o_os_endings = [
+    "aficionado",
+    "aggro",
+    "albino",
+    "allegro",
+    "ammo",
+    "Antananarivo",
+    "archipelago",
+    "armadillo",
+    "auto",
+    "avocado",
+    "Bamako",
+    "Barquisimeto",
+    "bimbo",
+    "bingo",
+    "Biro",
+    "bolero",
+    "Bolzano",
+    "bongo",
+    "Boto",
+    "burro",
+    "Cairo",
+    "canto",
+    "cappuccino",
+    "casino",
+    "cello",
+    "Chicago",
+    "Chimango",
+    "cilantro",
+    "cochito",
+    "coco",
+    "Colombo",
+    "Colorado",
+    "commando",
+    "concertino",
+    "contango",
+    "credo",
+    "crescendo",
+    "cyano",
+    "demo",
+    "ditto",
+    "Draco",
+    "dynamo",
+    "embryo",
+    "Esperanto",
+    "espresso",
+    "euro",
+    "falsetto",
+    "Faro",
+    "fiasco",
+    "Filipino",
+    "flamenco",
+    "furioso",
+    "generalissimo",
+    "Gestapo",
+    "ghetto",
+    "gigolo",
+    "gizmo",
+    "Greensboro",
+    "gringo",
+    "Guaiabero",
+    "guano",
+    "gumbo",
+    "gyro",
+    "hairdo",
+    "hippo",
+    "Idaho",
+    "impetigo",
+    "inferno",
+    "info",
+    "intermezzo",
+    "intertrigo",
+    "Iquico",
+    "jumbo",
+    "junto",
+    "Kakapo",
+    "kilo",
+    "Kinkimavo",
+    "Kokako",
+    "Kosovo",
+    "Lesotho",
+    "libero",
+    "libido",
+    "libretto",
+    "lido",
+    "Lilo",
+    "limbo",
+    "limo",
+    "lineno",
+    "lingo",
+    "lino",
+    "livedo",
+    "loco",
+    "logo",
+    "lumbago",
+    "macho",
+    "macro",
+    "mafioso",
+    "magneto",
+    "magnifico",
+    "Majuro",
+    "Malabo",
+    "manifesto",
+    "Maputo",
+    "Maracaibo",
+    "medico",
+    "memo",
+    "metro",
+    "Mexico",
+    "micro",
+    "Milano",
+    "Monaco",
+    "mono",
+    "Montenegro",
+    "Morocco",
+    "Muqdisho",
+    "myo",
+    "neutrino",
+    "Ningbo",
+    "octavo",
+    "oregano",
+    "Orinoco",
+    "Orlando",
+    "Oslo",
+    "panto",
+    "Paramaribo",
+    "Pardusco",
+    "pedalo",
+    "photo",
+    "pimento",
+    "pinto",
+    "pleco",
+    "Pluto",
+    "pogo",
+    "polo",
+    "poncho",
+    "Porto-Novo",
+    "Porto",
+    "pro",
+    "psycho",
+    "pueblo",
+    "quarto",
+    "Quito",
+    "repo",
+    "rhino",
+    "risotto",
+    "rococo",
+    "rondo",
+    "Sacramento",
+    "saddo",
+    "sago",
+    "salvo",
+    "Santiago",
+    "Sapporo",
+    "Sarajevo",
+    "scherzando",
+    "scherzo",
+    "silo",
+    "sirocco",
+    "sombrero",
+    "staccato",
+    "sterno",
+    "stucco",
+    "stylo",
+    "sumo",
+    "Taiko",
+    "techno",
+    "terrazzo",
+    "testudo",
+    "timpano",
+    "tiro",
+    "tobacco",
+    "Togo",
+    "Tokyo",
+    "torero",
+    "Torino",
+    "Toronto",
+    "torso",
+    "tremolo",
+    "typo",
+    "tyro",
+    "ufo",
+    "UNESCO",
+    "vaquero",
+    "vermicello",
+    "verso",
+    "vibrato",
+    "violoncello",
+    "Virgo",
+    "weirdo",
+    "WHO",
+    "WTO",
+    "Yamoussoukro",
+    "yo-yo",
+    "zero",
+    "Zibo",
+] + pl_sb_C_o_i
+
+pl_sb_U_o_os_bysize = bysize(pl_sb_U_o_os_endings)
+si_sb_U_o_os_bysize = bysize([f"{w}s" for w in pl_sb_U_o_os_endings])
+
+
+# UNCONDITIONAL "..ch" -> "..chs"
+
+pl_sb_U_ch_chs_list = ("czech", "eunuch", "stomach")
+
+(
+    si_sb_U_ch_chs_list,
+    si_sb_U_ch_chs_bysize,
+    pl_sb_U_ch_chs_bysize,
+    pl_sb_U_ch_chs,
+) = make_pl_si_lists(pl_sb_U_ch_chs_list, "s", None)
+
+
+# UNCONDITIONAL "..[ei]x" -> "..ices"
+
+pl_sb_U_ex_ices_list = ("codex", "murex", "silex")
+(
+    si_sb_U_ex_ices_list,
+    si_sb_U_ex_ices_bysize,
+    pl_sb_U_ex_ices_bysize,
+    pl_sb_U_ex_ices,
+) = make_pl_si_lists(pl_sb_U_ex_ices_list, "ices", 2)
+
+pl_sb_U_ix_ices_list = ("radix", "helix")
+(
+    si_sb_U_ix_ices_list,
+    si_sb_U_ix_ices_bysize,
+    pl_sb_U_ix_ices_bysize,
+    pl_sb_U_ix_ices,
+) = make_pl_si_lists(pl_sb_U_ix_ices_list, "ices", 2)
+
+# CLASSICAL "..[ei]x" -> "..ices"
+
+pl_sb_C_ex_ices_list = (
+    "vortex",
+    "vertex",
+    "cortex",
+    "latex",
+    "pontifex",
+    "apex",
+    "index",
+    "simplex",
+)
+
+(
+    si_sb_C_ex_ices_list,
+    si_sb_C_ex_ices_bysize,
+    pl_sb_C_ex_ices_bysize,
+    pl_sb_C_ex_ices,
+) = make_pl_si_lists(pl_sb_C_ex_ices_list, "ices", 2)
+
+
+pl_sb_C_ix_ices_list = ("appendix",)
+
+(
+    si_sb_C_ix_ices_list,
+    si_sb_C_ix_ices_bysize,
+    pl_sb_C_ix_ices_bysize,
+    pl_sb_C_ix_ices,
+) = make_pl_si_lists(pl_sb_C_ix_ices_list, "ices", 2)
+
+
+# ARABIC: ".." -> "..i"
+
+pl_sb_C_i_list = ("afrit", "afreet", "efreet")
+
+(si_sb_C_i_list, si_sb_C_i_bysize, pl_sb_C_i_bysize, pl_sb_C_i) = make_pl_si_lists(
+    pl_sb_C_i_list, "i", None
+)
+
+
+# HEBREW: ".." -> "..im"
+
+pl_sb_C_im_list = ("goy", "seraph", "cherub")
+
+(si_sb_C_im_list, si_sb_C_im_bysize, pl_sb_C_im_bysize, pl_sb_C_im) = make_pl_si_lists(
+    pl_sb_C_im_list, "im", None
+)
+
+
+# UNCONDITIONAL "..man" -> "..mans"
+
+pl_sb_U_man_mans_list = """
+    ataman caiman cayman ceriman
+    desman dolman farman harman hetman
+    human leman ottoman shaman talisman
+""".split()
+pl_sb_U_man_mans_caps_list = """
+    Alabaman Bahaman Burman German
+    Hiroshiman Liman Nakayaman Norman Oklahoman
+    Panaman Roman Selman Sonaman Tacoman Yakiman
+    Yokohaman Yuman
+""".split()
+
+(
+    si_sb_U_man_mans_list,
+    si_sb_U_man_mans_bysize,
+    pl_sb_U_man_mans_bysize,
+) = make_pl_si_lists(pl_sb_U_man_mans_list, "s", None, dojoinstem=False)
+(
+    si_sb_U_man_mans_caps_list,
+    si_sb_U_man_mans_caps_bysize,
+    pl_sb_U_man_mans_caps_bysize,
+) = make_pl_si_lists(pl_sb_U_man_mans_caps_list, "s", None, dojoinstem=False)
+
+# UNCONDITIONAL "..louse" -> "..lice"
+pl_sb_U_louse_lice_list = ("booklouse", "grapelouse", "louse", "woodlouse")
+
+(
+    si_sb_U_louse_lice_list,
+    si_sb_U_louse_lice_bysize,
+    pl_sb_U_louse_lice_bysize,
+) = make_pl_si_lists(pl_sb_U_louse_lice_list, "lice", 5, dojoinstem=False)
+
+pl_sb_uninflected_s_complete = [
+    # PAIRS OR GROUPS SUBSUMED TO A SINGULAR...
+    "breeches",
+    "britches",
+    "pajamas",
+    "pyjamas",
+    "clippers",
+    "gallows",
+    "hijinks",
+    "headquarters",
+    "pliers",
+    "scissors",
+    "testes",
+    "herpes",
+    "pincers",
+    "shears",
+    "proceedings",
+    "trousers",
+    # UNASSIMILATED LATIN 4th DECLENSION
+    "cantus",
+    "coitus",
+    "nexus",
+    # RECENT IMPORTS...
+    "contretemps",
+    "corps",
+    "debris",
+    "siemens",
+    # DISEASES
+    "mumps",
+    # MISCELLANEOUS OTHERS...
+    "diabetes",
+    "jackanapes",
+    "series",
+    "species",
+    "subspecies",
+    "rabies",
+    "chassis",
+    "innings",
+    "news",
+    "mews",
+    "haggis",
+]
+
+pl_sb_uninflected_s_endings = [
+    # RECENT IMPORTS...
+    "ois",
+    # DISEASES
+    "measles",
+]
+
+pl_sb_uninflected_s = pl_sb_uninflected_s_complete + [
+    f".*{w}" for w in pl_sb_uninflected_s_endings
+]
+
+pl_sb_uninflected_herd = (
+    # DON'T INFLECT IN CLASSICAL MODE, OTHERWISE NORMAL INFLECTION
+    "wildebeest",
+    "swine",
+    "eland",
+    "bison",
+    "buffalo",
+    "cattle",
+    "elk",
+    "rhinoceros",
+    "zucchini",
+    "caribou",
+    "dace",
+    "grouse",
+    "guinea fowl",
+    "guinea-fowl",
+    "haddock",
+    "hake",
+    "halibut",
+    "herring",
+    "mackerel",
+    "pickerel",
+    "pike",
+    "roe",
+    "seed",
+    "shad",
+    "snipe",
+    "teal",
+    "turbot",
+    "water fowl",
+    "water-fowl",
+)
+
+pl_sb_uninflected_complete = [
+    # SOME FISH AND HERD ANIMALS
+    "tuna",
+    "salmon",
+    "mackerel",
+    "trout",
+    "bream",
+    "sea-bass",
+    "sea bass",
+    "carp",
+    "cod",
+    "flounder",
+    "whiting",
+    "moose",
+    # OTHER ODDITIES
+    "graffiti",
+    "djinn",
+    "samuri",
+    "offspring",
+    "pence",
+    "quid",
+    "hertz",
+] + pl_sb_uninflected_s_complete
+# SOME WORDS ENDING IN ...s (OFTEN PAIRS TAKEN AS A WHOLE)
+
+pl_sb_uninflected_caps = [
+    # ALL NATIONALS ENDING IN -ese
+    "Portuguese",
+    "Amoyese",
+    "Borghese",
+    "Congoese",
+    "Faroese",
+    "Foochowese",
+    "Genevese",
+    "Genoese",
+    "Gilbertese",
+    "Hottentotese",
+    "Kiplingese",
+    "Kongoese",
+    "Lucchese",
+    "Maltese",
+    "Nankingese",
+    "Niasese",
+    "Pekingese",
+    "Piedmontese",
+    "Pistoiese",
+    "Sarawakese",
+    "Shavese",
+    "Vermontese",
+    "Wenchowese",
+    "Yengeese",
+]
+
+
+pl_sb_uninflected_endings = [
+    # UNCOUNTABLE NOUNS
+    "butter",
+    "cash",
+    "furniture",
+    "information",
+    # SOME FISH AND HERD ANIMALS
+    "fish",
+    "deer",
+    "sheep",
+    # ALL NATIONALS ENDING IN -ese
+    "nese",
+    "rese",
+    "lese",
+    "mese",
+    # DISEASES
+    "pox",
+    # OTHER ODDITIES
+    "craft",
+] + pl_sb_uninflected_s_endings
+# SOME WORDS ENDING IN ...s (OFTEN PAIRS TAKEN AS A WHOLE)
+
+
+pl_sb_uninflected_bysize = bysize(pl_sb_uninflected_endings)
+
+
+# SINGULAR WORDS ENDING IN ...s (ALL INFLECT WITH ...es)
+
+pl_sb_singular_s_complete = [
+    "acropolis",
+    "aegis",
+    "alias",
+    "asbestos",
+    "bathos",
+    "bias",
+    "bronchitis",
+    "bursitis",
+    "caddis",
+    "cannabis",
+    "canvas",
+    "chaos",
+    "cosmos",
+    "dais",
+    "digitalis",
+    "epidermis",
+    "ethos",
+    "eyas",
+    "gas",
+    "glottis",
+    "hubris",
+    "ibis",
+    "lens",
+    "mantis",
+    "marquis",
+    "metropolis",
+    "pathos",
+    "pelvis",
+    "polis",
+    "rhinoceros",
+    "sassafras",
+    "trellis",
+] + pl_sb_C_is_ides_complete
+
+
+pl_sb_singular_s_endings = ["ss", "us"] + pl_sb_C_is_ides_endings
+
+pl_sb_singular_s_bysize = bysize(pl_sb_singular_s_endings)
+
+si_sb_singular_s_complete = [f"{w}es" for w in pl_sb_singular_s_complete]
+si_sb_singular_s_endings = [f"{w}es" for w in pl_sb_singular_s_endings]
+si_sb_singular_s_bysize = bysize(si_sb_singular_s_endings)
+
+pl_sb_singular_s_es = ["[A-Z].*es"]
+
+pl_sb_singular_s = enclose(
+    "|".join(
+        pl_sb_singular_s_complete
+        + [f".*{w}" for w in pl_sb_singular_s_endings]
+        + pl_sb_singular_s_es
+    )
+)
+
+
+# PLURALS ENDING IN uses -> use
+
+
+si_sb_ois_oi_case = ("Bolshois", "Hanois")
+
+si_sb_uses_use_case = ("Betelgeuses", "Duses", "Meuses", "Syracuses", "Toulouses")
+
+si_sb_uses_use = (
+    "abuses",
+    "applauses",
+    "blouses",
+    "carouses",
+    "causes",
+    "chartreuses",
+    "clauses",
+    "contuses",
+    "douses",
+    "excuses",
+    "fuses",
+    "grouses",
+    "hypotenuses",
+    "masseuses",
+    "menopauses",
+    "misuses",
+    "muses",
+    "overuses",
+    "pauses",
+    "peruses",
+    "profuses",
+    "recluses",
+    "reuses",
+    "ruses",
+    "souses",
+    "spouses",
+    "suffuses",
+    "transfuses",
+    "uses",
+)
+
+si_sb_ies_ie_case = (
+    "Addies",
+    "Aggies",
+    "Allies",
+    "Amies",
+    "Angies",
+    "Annies",
+    "Annmaries",
+    "Archies",
+    "Arties",
+    "Aussies",
+    "Barbies",
+    "Barries",
+    "Basies",
+    "Bennies",
+    "Bernies",
+    "Berties",
+    "Bessies",
+    "Betties",
+    "Billies",
+    "Blondies",
+    "Bobbies",
+    "Bonnies",
+    "Bowies",
+    "Brandies",
+    "Bries",
+    "Brownies",
+    "Callies",
+    "Carnegies",
+    "Carries",
+    "Cassies",
+    "Charlies",
+    "Cheries",
+    "Christies",
+    "Connies",
+    "Curies",
+    "Dannies",
+    "Debbies",
+    "Dixies",
+    "Dollies",
+    "Donnies",
+    "Drambuies",
+    "Eddies",
+    "Effies",
+    "Ellies",
+    "Elsies",
+    "Eries",
+    "Ernies",
+    "Essies",
+    "Eugenies",
+    "Fannies",
+    "Flossies",
+    "Frankies",
+    "Freddies",
+    "Gillespies",
+    "Goldies",
+    "Gracies",
+    "Guthries",
+    "Hallies",
+    "Hatties",
+    "Hetties",
+    "Hollies",
+    "Jackies",
+    "Jamies",
+    "Janies",
+    "Jannies",
+    "Jeanies",
+    "Jeannies",
+    "Jennies",
+    "Jessies",
+    "Jimmies",
+    "Jodies",
+    "Johnies",
+    "Johnnies",
+    "Josies",
+    "Julies",
+    "Kalgoorlies",
+    "Kathies",
+    "Katies",
+    "Kellies",
+    "Kewpies",
+    "Kristies",
+    "Laramies",
+    "Lassies",
+    "Lauries",
+    "Leslies",
+    "Lessies",
+    "Lillies",
+    "Lizzies",
+    "Lonnies",
+    "Lories",
+    "Lorries",
+    "Lotties",
+    "Louies",
+    "Mackenzies",
+    "Maggies",
+    "Maisies",
+    "Mamies",
+    "Marcies",
+    "Margies",
+    "Maries",
+    "Marjories",
+    "Matties",
+    "McKenzies",
+    "Melanies",
+    "Mickies",
+    "Millies",
+    "Minnies",
+    "Mollies",
+    "Mounties",
+    "Nannies",
+    "Natalies",
+    "Nellies",
+    "Netties",
+    "Ollies",
+    "Ozzies",
+    "Pearlies",
+    "Pottawatomies",
+    "Reggies",
+    "Richies",
+    "Rickies",
+    "Robbies",
+    "Ronnies",
+    "Rosalies",
+    "Rosemaries",
+    "Rosies",
+    "Roxies",
+    "Rushdies",
+    "Ruthies",
+    "Sadies",
+    "Sallies",
+    "Sammies",
+    "Scotties",
+    "Selassies",
+    "Sherries",
+    "Sophies",
+    "Stacies",
+    "Stefanies",
+    "Stephanies",
+    "Stevies",
+    "Susies",
+    "Sylvies",
+    "Tammies",
+    "Terries",
+    "Tessies",
+    "Tommies",
+    "Tracies",
+    "Trekkies",
+    "Valaries",
+    "Valeries",
+    "Valkyries",
+    "Vickies",
+    "Virgies",
+    "Willies",
+    "Winnies",
+    "Wylies",
+    "Yorkies",
+)
+
+si_sb_ies_ie = (
+    "aeries",
+    "baggies",
+    "belies",
+    "biggies",
+    "birdies",
+    "bogies",
+    "bonnies",
+    "boogies",
+    "bookies",
+    "bourgeoisies",
+    "brownies",
+    "budgies",
+    "caddies",
+    "calories",
+    "camaraderies",
+    "cockamamies",
+    "collies",
+    "cookies",
+    "coolies",
+    "cooties",
+    "coteries",
+    "crappies",
+    "curies",
+    "cutesies",
+    "dogies",
+    "eyries",
+    "floozies",
+    "footsies",
+    "freebies",
+    "genies",
+    "goalies",
+    "groupies",
+    "hies",
+    "jalousies",
+    "junkies",
+    "kiddies",
+    "laddies",
+    "lassies",
+    "lies",
+    "lingeries",
+    "magpies",
+    "menageries",
+    "mommies",
+    "movies",
+    "neckties",
+    "newbies",
+    "nighties",
+    "oldies",
+    "organdies",
+    "overlies",
+    "pies",
+    "pinkies",
+    "pixies",
+    "potpies",
+    "prairies",
+    "quickies",
+    "reveries",
+    "rookies",
+    "rotisseries",
+    "softies",
+    "sorties",
+    "species",
+    "stymies",
+    "sweeties",
+    "ties",
+    "underlies",
+    "unties",
+    "veggies",
+    "vies",
+    "yuppies",
+    "zombies",
+)
+
+
+si_sb_oes_oe_case = (
+    "Chloes",
+    "Crusoes",
+    "Defoes",
+    "Faeroes",
+    "Ivanhoes",
+    "Joes",
+    "McEnroes",
+    "Moes",
+    "Monroes",
+    "Noes",
+    "Poes",
+    "Roscoes",
+    "Tahoes",
+    "Tippecanoes",
+    "Zoes",
+)
+
+si_sb_oes_oe = (
+    "aloes",
+    "backhoes",
+    "canoes",
+    "does",
+    "floes",
+    "foes",
+    "hoes",
+    "mistletoes",
+    "oboes",
+    "pekoes",
+    "roes",
+    "sloes",
+    "throes",
+    "tiptoes",
+    "toes",
+    "woes",
+)
+
+si_sb_z_zes = ("quartzes", "topazes")
+
+si_sb_zzes_zz = ("buzzes", "fizzes", "frizzes", "razzes")
+
+si_sb_ches_che_case = (
+    "Andromaches",
+    "Apaches",
+    "Blanches",
+    "Comanches",
+    "Nietzsches",
+    "Porsches",
+    "Roches",
+)
+
+si_sb_ches_che = (
+    "aches",
+    "avalanches",
+    "backaches",
+    "bellyaches",
+    "caches",
+    "cloches",
+    "creches",
+    "douches",
+    "earaches",
+    "fiches",
+    "headaches",
+    "heartaches",
+    "microfiches",
+    "niches",
+    "pastiches",
+    "psyches",
+    "quiches",
+    "stomachaches",
+    "toothaches",
+    "tranches",
+)
+
+si_sb_xes_xe = ("annexes", "axes", "deluxes", "pickaxes")
+
+si_sb_sses_sse_case = ("Hesses", "Jesses", "Larousses", "Matisses")
+si_sb_sses_sse = (
+    "bouillabaisses",
+    "crevasses",
+    "demitasses",
+    "impasses",
+    "mousses",
+    "posses",
+)
+
+si_sb_ves_ve_case = (
+    # *[nwl]ives -> [nwl]live
+    "Clives",
+    "Palmolives",
+)
+si_sb_ves_ve = (
+    # *[^d]eaves -> eave
+    "interweaves",
+    "weaves",
+    # *[nwl]ives -> [nwl]live
+    "olives",
+    # *[eoa]lves -> [eoa]lve
+    "bivalves",
+    "dissolves",
+    "resolves",
+    "salves",
+    "twelves",
+    "valves",
+)
+
+
+plverb_special_s = enclose(
+    "|".join(
+        [pl_sb_singular_s]
+        + pl_sb_uninflected_s
+        + list(pl_sb_irregular_s)
+        + ["(.*[csx])is", "(.*)ceps", "[A-Z].*s"]
+    )
+)
+
+_pl_sb_postfix_adj_defn = (
+    ("general", enclose(r"(?!major|lieutenant|brigadier|adjutant|.*star)\S+")),
+    ("martial", enclose("court")),
+    ("force", enclose("pound")),
+)
+
+pl_sb_postfix_adj: Iterable[str] = (
+    enclose(val + f"(?=(?:-|\\s+){key})") for key, val in _pl_sb_postfix_adj_defn
+)
+
+pl_sb_postfix_adj_stems = f"({'|'.join(pl_sb_postfix_adj)})(.*)"
+
+
+# PLURAL WORDS ENDING IS es GO TO SINGULAR is
+
+si_sb_es_is = (
+    "amanuenses",
+    "amniocenteses",
+    "analyses",
+    "antitheses",
+    "apotheoses",
+    "arterioscleroses",
+    "atheroscleroses",
+    "axes",
+    # 'bases', # bases -> basis
+    "catalyses",
+    "catharses",
+    "chasses",
+    "cirrhoses",
+    "cocces",
+    "crises",
+    "diagnoses",
+    "dialyses",
+    "diereses",
+    "electrolyses",
+    "emphases",
+    "exegeses",
+    "geneses",
+    "halitoses",
+    "hydrolyses",
+    "hypnoses",
+    "hypotheses",
+    "hystereses",
+    "metamorphoses",
+    "metastases",
+    "misdiagnoses",
+    "mitoses",
+    "mononucleoses",
+    "narcoses",
+    "necroses",
+    "nemeses",
+    "neuroses",
+    "oases",
+    "osmoses",
+    "osteoporoses",
+    "paralyses",
+    "parentheses",
+    "parthenogeneses",
+    "periphrases",
+    "photosyntheses",
+    "probosces",
+    "prognoses",
+    "prophylaxes",
+    "prostheses",
+    "preces",
+    "psoriases",
+    "psychoanalyses",
+    "psychokineses",
+    "psychoses",
+    "scleroses",
+    "scolioses",
+    "sepses",
+    "silicoses",
+    "symbioses",
+    "synopses",
+    "syntheses",
+    "taxes",
+    "telekineses",
+    "theses",
+    "thromboses",
+    "tuberculoses",
+    "urinalyses",
+)
+
+pl_prep_list = """
+    about above across after among around at athwart before behind
+    below beneath beside besides between betwixt beyond but by
+    during except for from in into near of off on onto out over
+    since till to under until unto upon with""".split()
+
+pl_prep_list_da = pl_prep_list + ["de", "du", "da"]
+
+pl_prep_bysize = bysize(pl_prep_list_da)
+
+pl_prep = enclose("|".join(pl_prep_list_da))
+
+pl_sb_prep_dual_compound = fr"(.*?)((?:-|\s+)(?:{pl_prep})(?:-|\s+))a(?:-|\s+)(.*)"
+
+
+singular_pronoun_genders = {
+    "neuter",
+    "feminine",
+    "masculine",
+    "gender-neutral",
+    "feminine or masculine",
+    "masculine or feminine",
+}
+
+pl_pron_nom = {
+    # NOMINATIVE    REFLEXIVE
+    "i": "we",
+    "myself": "ourselves",
+    "you": "you",
+    "yourself": "yourselves",
+    "she": "they",
+    "herself": "themselves",
+    "he": "they",
+    "himself": "themselves",
+    "it": "they",
+    "itself": "themselves",
+    "they": "they",
+    "themself": "themselves",
+    #   POSSESSIVE
+    "mine": "ours",
+    "yours": "yours",
+    "hers": "theirs",
+    "his": "theirs",
+    "its": "theirs",
+    "theirs": "theirs",
+}
+
+si_pron: Dict[str, Dict[str, Union[str, Dict[str, str]]]] = {
+    "nom": {v: k for (k, v) in pl_pron_nom.items()}
+}
+si_pron["nom"]["we"] = "I"
+
+
+pl_pron_acc = {
+    # ACCUSATIVE    REFLEXIVE
+    "me": "us",
+    "myself": "ourselves",
+    "you": "you",
+    "yourself": "yourselves",
+    "her": "them",
+    "herself": "themselves",
+    "him": "them",
+    "himself": "themselves",
+    "it": "them",
+    "itself": "themselves",
+    "them": "them",
+    "themself": "themselves",
+}
+
+pl_pron_acc_keys = enclose("|".join(pl_pron_acc))
+pl_pron_acc_keys_bysize = bysize(pl_pron_acc)
+
+si_pron["acc"] = {v: k for (k, v) in pl_pron_acc.items()}
+
+for _thecase, _plur, _gend, _sing in (
+    ("nom", "they", "neuter", "it"),
+    ("nom", "they", "feminine", "she"),
+    ("nom", "they", "masculine", "he"),
+    ("nom", "they", "gender-neutral", "they"),
+    ("nom", "they", "feminine or masculine", "she or he"),
+    ("nom", "they", "masculine or feminine", "he or she"),
+    ("nom", "themselves", "neuter", "itself"),
+    ("nom", "themselves", "feminine", "herself"),
+    ("nom", "themselves", "masculine", "himself"),
+    ("nom", "themselves", "gender-neutral", "themself"),
+    ("nom", "themselves", "feminine or masculine", "herself or himself"),
+    ("nom", "themselves", "masculine or feminine", "himself or herself"),
+    ("nom", "theirs", "neuter", "its"),
+    ("nom", "theirs", "feminine", "hers"),
+    ("nom", "theirs", "masculine", "his"),
+    ("nom", "theirs", "gender-neutral", "theirs"),
+    ("nom", "theirs", "feminine or masculine", "hers or his"),
+    ("nom", "theirs", "masculine or feminine", "his or hers"),
+    ("acc", "them", "neuter", "it"),
+    ("acc", "them", "feminine", "her"),
+    ("acc", "them", "masculine", "him"),
+    ("acc", "them", "gender-neutral", "them"),
+    ("acc", "them", "feminine or masculine", "her or him"),
+    ("acc", "them", "masculine or feminine", "him or her"),
+    ("acc", "themselves", "neuter", "itself"),
+    ("acc", "themselves", "feminine", "herself"),
+    ("acc", "themselves", "masculine", "himself"),
+    ("acc", "themselves", "gender-neutral", "themself"),
+    ("acc", "themselves", "feminine or masculine", "herself or himself"),
+    ("acc", "themselves", "masculine or feminine", "himself or herself"),
+):
+    try:
+        si_pron[_thecase][_plur][_gend] = _sing  # type: ignore
+    except TypeError:
+        si_pron[_thecase][_plur] = {}
+        si_pron[_thecase][_plur][_gend] = _sing  # type: ignore
+
+
+si_pron_acc_keys = enclose("|".join(si_pron["acc"]))
+si_pron_acc_keys_bysize = bysize(si_pron["acc"])
+
+
+def get_si_pron(thecase, word, gender) -> str:
+    try:
+        sing = si_pron[thecase][word]
+    except KeyError:
+        raise  # not a pronoun
+    try:
+        return sing[gender]  # has several types due to gender
+    except TypeError:
+        return cast(str, sing)  # answer independent of gender
+
+
+# These dictionaries group verbs by first, second and third person
+# conjugations.
+
+plverb_irregular_pres = {
+    "am": "are",
+    "are": "are",
+    "is": "are",
+    "was": "were",
+    "were": "were",
+    "was": "were",
+    "have": "have",
+    "have": "have",
+    "has": "have",
+    "do": "do",
+    "do": "do",
+    "does": "do",
+}
+
+plverb_ambiguous_pres = {
+    "act": "act",
+    "act": "act",
+    "acts": "act",
+    "blame": "blame",
+    "blame": "blame",
+    "blames": "blame",
+    "can": "can",
+    "can": "can",
+    "can": "can",
+    "must": "must",
+    "must": "must",
+    "must": "must",
+    "fly": "fly",
+    "fly": "fly",
+    "flies": "fly",
+    "copy": "copy",
+    "copy": "copy",
+    "copies": "copy",
+    "drink": "drink",
+    "drink": "drink",
+    "drinks": "drink",
+    "fight": "fight",
+    "fight": "fight",
+    "fights": "fight",
+    "fire": "fire",
+    "fire": "fire",
+    "fires": "fire",
+    "like": "like",
+    "like": "like",
+    "likes": "like",
+    "look": "look",
+    "look": "look",
+    "looks": "look",
+    "make": "make",
+    "make": "make",
+    "makes": "make",
+    "reach": "reach",
+    "reach": "reach",
+    "reaches": "reach",
+    "run": "run",
+    "run": "run",
+    "runs": "run",
+    "sink": "sink",
+    "sink": "sink",
+    "sinks": "sink",
+    "sleep": "sleep",
+    "sleep": "sleep",
+    "sleeps": "sleep",
+    "view": "view",
+    "view": "view",
+    "views": "view",
+}
+
+plverb_ambiguous_pres_keys = re.compile(
+    fr"^({enclose('|'.join(plverb_ambiguous_pres))})((\s.*)?)$", re.IGNORECASE
+)
+
+
+plverb_irregular_non_pres = (
+    "did",
+    "had",
+    "ate",
+    "made",
+    "put",
+    "spent",
+    "fought",
+    "sank",
+    "gave",
+    "sought",
+    "shall",
+    "could",
+    "ought",
+    "should",
+)
+
+plverb_ambiguous_non_pres = re.compile(
+    r"^((?:thought|saw|bent|will|might|cut))((\s.*)?)$", re.IGNORECASE
+)
+
+# "..oes" -> "..oe" (the rest are "..oes" -> "o")
+
+pl_v_oes_oe = ("canoes", "floes", "oboes", "roes", "throes", "woes")
+pl_v_oes_oe_endings_size4 = ("hoes", "toes")
+pl_v_oes_oe_endings_size5 = ("shoes",)
+
+
+pl_count_zero = ("0", "no", "zero", "nil")
+
+
+pl_count_one = ("1", "a", "an", "one", "each", "every", "this", "that")
+
+pl_adj_special = {"a": "some", "an": "some", "this": "these", "that": "those"}
+
+pl_adj_special_keys = re.compile(
+    fr"^({enclose('|'.join(pl_adj_special))})$", re.IGNORECASE
+)
+
+pl_adj_poss = {
+    "my": "our",
+    "your": "your",
+    "its": "their",
+    "her": "their",
+    "his": "their",
+    "their": "their",
+}
+
+pl_adj_poss_keys = re.compile(fr"^({enclose('|'.join(pl_adj_poss))})$", re.IGNORECASE)
+
+
+# 2. INDEFINITE ARTICLES
+
+# THIS PATTERN MATCHES STRINGS OF CAPITALS STARTING WITH A "VOWEL-SOUND"
+# CONSONANT FOLLOWED BY ANOTHER CONSONANT, AND WHICH ARE NOT LIKELY
+# TO BE REAL WORDS (OH, ALL RIGHT THEN, IT'S JUST MAGIC!)
+
+A_abbrev = re.compile(
+    r"""
+(?! FJO | [HLMNS]Y.  | RY[EO] | SQU
+  | ( F[LR]? | [HL] | MN? | N | RH? | S[CHKLMNPTVW]? | X(YL)?) [AEIOU])
+[FHLMNRSX][A-Z]
+""",
+    re.VERBOSE,
+)
+
+# THIS PATTERN CODES THE BEGINNINGS OF ALL ENGLISH WORDS BEGINING WITH A
+# 'y' FOLLOWED BY A CONSONANT. ANY OTHER Y-CONSONANT PREFIX THEREFORE
+# IMPLIES AN ABBREVIATION.
+
+A_y_cons = re.compile(r"^(y(b[lor]|cl[ea]|fere|gg|p[ios]|rou|tt))", re.IGNORECASE)
+
+# EXCEPTIONS TO EXCEPTIONS
+
+A_explicit_a = re.compile(r"^((?:unabomber|unanimous|US))", re.IGNORECASE)
+
+A_explicit_an = re.compile(
+    r"^((?:euler|hour(?!i)|heir|honest|hono[ur]|mpeg))", re.IGNORECASE
+)
+
+A_ordinal_an = re.compile(r"^([aefhilmnorsx]-?th)", re.IGNORECASE)
+
+A_ordinal_a = re.compile(r"^([bcdgjkpqtuvwyz]-?th)", re.IGNORECASE)
+
+
+# NUMERICAL INFLECTIONS
+
+nth = {
+    0: "th",
+    1: "st",
+    2: "nd",
+    3: "rd",
+    4: "th",
+    5: "th",
+    6: "th",
+    7: "th",
+    8: "th",
+    9: "th",
+    11: "th",
+    12: "th",
+    13: "th",
+}
+nth_suff = set(nth.values())
+
+ordinal = dict(
+    ty="tieth",
+    one="first",
+    two="second",
+    three="third",
+    five="fifth",
+    eight="eighth",
+    nine="ninth",
+    twelve="twelfth",
+)
+
+ordinal_suff = re.compile(fr"({'|'.join(ordinal)})\Z")
+
+
+# NUMBERS
+
+unit = ["", "one", "two", "three", "four", "five", "six", "seven", "eight", "nine"]
+teen = [
+    "ten",
+    "eleven",
+    "twelve",
+    "thirteen",
+    "fourteen",
+    "fifteen",
+    "sixteen",
+    "seventeen",
+    "eighteen",
+    "nineteen",
+]
+ten = [
+    "",
+    "",
+    "twenty",
+    "thirty",
+    "forty",
+    "fifty",
+    "sixty",
+    "seventy",
+    "eighty",
+    "ninety",
+]
+mill = [
+    " ",
+    " thousand",
+    " million",
+    " billion",
+    " trillion",
+    " quadrillion",
+    " quintillion",
+    " sextillion",
+    " septillion",
+    " octillion",
+    " nonillion",
+    " decillion",
+]
+
+
+# SUPPORT CLASSICAL PLURALIZATIONS
+
+def_classical = dict(
+    all=False, zero=False, herd=False, names=True, persons=False, ancient=False
+)
+
+all_classical = {k: True for k in def_classical}
+no_classical = {k: False for k in def_classical}
+
+
+# Maps strings to built-in constant types
+string_to_constant = {"True": True, "False": False, "None": None}
+
+
+# Pre-compiled regular expression objects
+DOLLAR_DIGITS = re.compile(r"\$(\d+)")
+FUNCTION_CALL = re.compile(r"((\w+)\([^)]*\)*)", re.IGNORECASE)
+PARTITION_WORD = re.compile(r"\A(\s*)(.+?)(\s*)\Z")
+PL_SB_POSTFIX_ADJ_STEMS_RE = re.compile(
+    fr"^(?:{pl_sb_postfix_adj_stems})$", re.IGNORECASE
+)
+PL_SB_PREP_DUAL_COMPOUND_RE = re.compile(
+    fr"^(?:{pl_sb_prep_dual_compound})$", re.IGNORECASE
+)
+DENOMINATOR = re.compile(r"(?P<denominator>.+)( (per|a) .+)")
+PLVERB_SPECIAL_S_RE = re.compile(fr"^({plverb_special_s})$")
+WHITESPACE = re.compile(r"\s")
+ENDS_WITH_S = re.compile(r"^(.*[^s])s$", re.IGNORECASE)
+ENDS_WITH_APOSTROPHE_S = re.compile(r"^(.*)'s?$")
+INDEFINITE_ARTICLE_TEST = re.compile(r"\A(\s*)(?:an?\s+)?(.+?)(\s*)\Z", re.IGNORECASE)
+SPECIAL_AN = re.compile(r"^[aefhilmnorsx]$", re.IGNORECASE)
+SPECIAL_A = re.compile(r"^[bcdgjkpqtuvwyz]$", re.IGNORECASE)
+SPECIAL_ABBREV_AN = re.compile(r"^[aefhilmnorsx][.-]", re.IGNORECASE)
+SPECIAL_ABBREV_A = re.compile(r"^[a-z][.-]", re.IGNORECASE)
+CONSONANTS = re.compile(r"^[^aeiouy]", re.IGNORECASE)
+ARTICLE_SPECIAL_EU = re.compile(r"^e[uw]", re.IGNORECASE)
+ARTICLE_SPECIAL_ONCE = re.compile(r"^onc?e\b", re.IGNORECASE)
+ARTICLE_SPECIAL_ONETIME = re.compile(r"^onetime\b", re.IGNORECASE)
+ARTICLE_SPECIAL_UNIT = re.compile(r"^uni([^nmd]|mo)", re.IGNORECASE)
+ARTICLE_SPECIAL_UBA = re.compile(r"^u[bcfghjkqrst][aeiou]", re.IGNORECASE)
+ARTICLE_SPECIAL_UKR = re.compile(r"^ukr", re.IGNORECASE)
+SPECIAL_CAPITALS = re.compile(r"^U[NK][AIEO]?")
+VOWELS = re.compile(r"^[aeiou]", re.IGNORECASE)
+
+DIGIT_GROUP = re.compile(r"(\d)")
+TWO_DIGITS = re.compile(r"(\d)(\d)")
+THREE_DIGITS = re.compile(r"(\d)(\d)(\d)")
+THREE_DIGITS_WORD = re.compile(r"(\d)(\d)(\d)(?=\D*\Z)")
+TWO_DIGITS_WORD = re.compile(r"(\d)(\d)(?=\D*\Z)")
+ONE_DIGIT_WORD = re.compile(r"(\d)(?=\D*\Z)")
+
+FOUR_DIGIT_COMMA = re.compile(r"(\d)(\d{3}(?:,|\Z))")
+NON_DIGIT = re.compile(r"\D")
+WHITESPACES_COMMA = re.compile(r"\s+,")
+COMMA_WORD = re.compile(r", (\S+)\s+\Z")
+WHITESPACES = re.compile(r"\s+")
+
+
+PRESENT_PARTICIPLE_REPLACEMENTS = (
+    (re.compile(r"ie$"), r"y"),
+    (
+        re.compile(r"ue$"),
+        r"u",
+    ),  # TODO: isn't ue$ -> u encompassed in the following rule?
+    (re.compile(r"([auy])e$"), r"\g<1>"),
+    (re.compile(r"ski$"), r"ski"),
+    (re.compile(r"[^b]i$"), r""),
+    (re.compile(r"^(are|were)$"), r"be"),
+    (re.compile(r"^(had)$"), r"hav"),
+    (re.compile(r"^(hoe)$"), r"\g<1>"),
+    (re.compile(r"([^e])e$"), r"\g<1>"),
+    (re.compile(r"er$"), r"er"),
+    (re.compile(r"([^aeiou][aeiouy]([bdgmnprst]))$"), r"\g<1>\g<2>"),
+)
+
+DIGIT = re.compile(r"\d")
+
+
+class Words(str):
+    lowered: str
+    split_: List[str]
+    first: str
+    last: str
+
+    def __init__(self, orig) -> None:
+        self.lowered = self.lower()
+        self.split_ = self.split()
+        self.first = self.split_[0]
+        self.last = self.split_[-1]
+
+
+Word = Annotated[str, Field(min_length=1)]
+Falsish = Any  # ideally, falsish would only validate on bool(value) is False
+
+
+class engine:
+    def __init__(self) -> None:
+
+        self.classical_dict = def_classical.copy()
+        self.persistent_count: Optional[int] = None
+        self.mill_count = 0
+        self.pl_sb_user_defined: List[str] = []
+        self.pl_v_user_defined: List[str] = []
+        self.pl_adj_user_defined: List[str] = []
+        self.si_sb_user_defined: List[str] = []
+        self.A_a_user_defined: List[str] = []
+        self.thegender = "neuter"
+        self.__number_args: Optional[Dict[str, str]] = None
+
+    @property
+    def _number_args(self):
+        return cast(Dict[str, str], self.__number_args)
+
+    @_number_args.setter
+    def _number_args(self, val):
+        self.__number_args = val
+
+    deprecated_methods = dict(
+        pl="plural",
+        plnoun="plural_noun",
+        plverb="plural_verb",
+        pladj="plural_adj",
+        sinoun="single_noun",
+        prespart="present_participle",
+        numwords="number_to_words",
+        plequal="compare",
+        plnounequal="compare_nouns",
+        plverbequal="compare_verbs",
+        pladjequal="compare_adjs",
+        wordlist="join",
+    )
+
+    def __getattr__(self, meth):
+        if meth in self.deprecated_methods:
+            print3(f"{meth}() deprecated, use {self.deprecated_methods[meth]}()")
+            raise DeprecationWarning
+        raise AttributeError
+
+    def defnoun(self, singular: str, plural: str) -> int:
+        """
+        Set the noun plural of singular to plural.
+
+        """
+        self.checkpat(singular)
+        self.checkpatplural(plural)
+        self.pl_sb_user_defined.extend((singular, plural))
+        self.si_sb_user_defined.extend((plural, singular))
+        return 1
+
+    def defverb(self, s1: str, p1: str, s2: str, p2: str, s3: str, p3: str) -> int:
+        """
+        Set the verb plurals for s1, s2 and s3 to p1, p2 and p3 respectively.
+
+        Where 1, 2 and 3 represent the 1st, 2nd and 3rd person forms of the verb.
+
+        """
+        self.checkpat(s1)
+        self.checkpat(s2)
+        self.checkpat(s3)
+        self.checkpatplural(p1)
+        self.checkpatplural(p2)
+        self.checkpatplural(p3)
+        self.pl_v_user_defined.extend((s1, p1, s2, p2, s3, p3))
+        return 1
+
+    def defadj(self, singular: str, plural: str) -> int:
+        """
+        Set the adjective plural of singular to plural.
+
+        """
+        self.checkpat(singular)
+        self.checkpatplural(plural)
+        self.pl_adj_user_defined.extend((singular, plural))
+        return 1
+
+    def defa(self, pattern: str) -> int:
+        """
+        Define the indefinite article as 'a' for words matching pattern.
+
+        """
+        self.checkpat(pattern)
+        self.A_a_user_defined.extend((pattern, "a"))
+        return 1
+
+    def defan(self, pattern: str) -> int:
+        """
+        Define the indefinite article as 'an' for words matching pattern.
+
+        """
+        self.checkpat(pattern)
+        self.A_a_user_defined.extend((pattern, "an"))
+        return 1
+
+    def checkpat(self, pattern: Optional[str]) -> None:
+        """
+        check for errors in a regex pattern
+        """
+        if pattern is None:
+            return
+        try:
+            re.match(pattern, "")
+        except re.error:
+            print3(f"\nBad user-defined singular pattern:\n\t{pattern}\n")
+            raise BadUserDefinedPatternError
+
+    def checkpatplural(self, pattern: str) -> None:
+        """
+        check for errors in a regex replace pattern
+        """
+        return
+
+    @validate_arguments
+    def ud_match(self, word: Word, wordlist: Sequence[Optional[Word]]) -> Optional[str]:
+        for i in range(len(wordlist) - 2, -2, -2):  # backwards through even elements
+            mo = re.search(fr"^{wordlist[i]}$", word, re.IGNORECASE)
+            if mo:
+                if wordlist[i + 1] is None:
+                    return None
+                pl = DOLLAR_DIGITS.sub(
+                    r"\\1", cast(Word, wordlist[i + 1])
+                )  # change $n to \n for expand
+                return mo.expand(pl)
+        return None
+
+    def classical(self, **kwargs) -> None:
+        """
+        turn classical mode on and off for various categories
+
+        turn on all classical modes:
+        classical()
+        classical(all=True)
+
+        turn on or off specific claassical modes:
+        e.g.
+        classical(herd=True)
+        classical(names=False)
+
+        By default all classical modes are off except names.
+
+        unknown value in args or key in kwargs raises
+        exception: UnknownClasicalModeError
+
+        """
+        if not kwargs:
+            self.classical_dict = all_classical.copy()
+            return
+        if "all" in kwargs:
+            if kwargs["all"]:
+                self.classical_dict = all_classical.copy()
+            else:
+                self.classical_dict = no_classical.copy()
+
+        for k, v in kwargs.items():
+            if k in def_classical:
+                self.classical_dict[k] = v
+            else:
+                raise UnknownClassicalModeError
+
+    def num(
+        self, count: Optional[int] = None, show: Optional[int] = None
+    ) -> str:  # (;$count,$show)
+        """
+        Set the number to be used in other method calls.
+
+        Returns count.
+
+        Set show to False to return '' instead.
+
+        """
+        if count is not None:
+            try:
+                self.persistent_count = int(count)
+            except ValueError:
+                raise BadNumValueError
+            if (show is None) or show:
+                return str(count)
+        else:
+            self.persistent_count = None
+        return ""
+
+    def gender(self, gender: str) -> None:
+        """
+        set the gender for the singular of plural pronouns
+
+        can be one of:
+        'neuter'                ('they' -> 'it')
+        'feminine'              ('they' -> 'she')
+        'masculine'             ('they' -> 'he')
+        'gender-neutral'        ('they' -> 'they')
+        'feminine or masculine' ('they' -> 'she or he')
+        'masculine or feminine' ('they' -> 'he or she')
+        """
+        if gender in singular_pronoun_genders:
+            self.thegender = gender
+        else:
+            raise BadGenderError
+
+    def _get_value_from_ast(self, obj):
+        """
+        Return the value of the ast object.
+        """
+        if isinstance(obj, ast.Num):
+            return obj.n
+        elif isinstance(obj, ast.Str):
+            return obj.s
+        elif isinstance(obj, ast.List):
+            return [self._get_value_from_ast(e) for e in obj.elts]
+        elif isinstance(obj, ast.Tuple):
+            return tuple([self._get_value_from_ast(e) for e in obj.elts])
+
+        # None, True and False are NameConstants in Py3.4 and above.
+        elif isinstance(obj, ast.NameConstant):
+            return obj.value
+
+        # Probably passed a variable name.
+        # Or passed a single word without wrapping it in quotes as an argument
+        # ex: p.inflect("I plural(see)") instead of p.inflect("I plural('see')")
+        raise NameError(f"name '{obj.id}' is not defined")
+
+    def _string_to_substitute(
+        self, mo: Match, methods_dict: Dict[str, Callable]
+    ) -> str:
+        """
+        Return the string to be substituted for the match.
+        """
+        matched_text, f_name = mo.groups()
+        # matched_text is the complete match string. e.g. plural_noun(cat)
+        # f_name is the function name. e.g. plural_noun
+
+        # Return matched_text if function name is not in methods_dict
+        if f_name not in methods_dict:
+            return matched_text
+
+        # Parse the matched text
+        a_tree = ast.parse(matched_text)
+
+        # get the args and kwargs from ast objects
+        args_list = [
+            self._get_value_from_ast(a)
+            for a in a_tree.body[0].value.args  # type: ignore[attr-defined]
+        ]
+        kwargs_list = {
+            kw.arg: self._get_value_from_ast(kw.value)
+            for kw in a_tree.body[0].value.keywords  # type: ignore[attr-defined]
+        }
+
+        # Call the corresponding function
+        return methods_dict[f_name](*args_list, **kwargs_list)
+
+    # 0. PERFORM GENERAL INFLECTIONS IN A STRING
+
+    @validate_arguments
+    def inflect(self, text: Word) -> str:
+        """
+        Perform inflections in a string.
+
+        e.g. inflect('The plural of cat is plural(cat)') returns
+        'The plural of cat is cats'
+
+        can use plural, plural_noun, plural_verb, plural_adj,
+        singular_noun, a, an, no, ordinal, number_to_words,
+        and prespart
+
+        """
+        save_persistent_count = self.persistent_count
+
+        # Dictionary of allowed methods
+        methods_dict: Dict[str, Callable] = {
+            "plural": self.plural,
+            "plural_adj": self.plural_adj,
+            "plural_noun": self.plural_noun,
+            "plural_verb": self.plural_verb,
+            "singular_noun": self.singular_noun,
+            "a": self.a,
+            "an": self.a,
+            "no": self.no,
+            "ordinal": self.ordinal,
+            "number_to_words": self.number_to_words,
+            "present_participle": self.present_participle,
+            "num": self.num,
+        }
+
+        # Regular expression to find Python's function call syntax
+        output = FUNCTION_CALL.sub(
+            lambda mo: self._string_to_substitute(mo, methods_dict), text
+        )
+        self.persistent_count = save_persistent_count
+        return output
+
+    # ## PLURAL SUBROUTINES
+
+    def postprocess(self, orig: str, inflected) -> str:
+        inflected = str(inflected)
+        if "|" in inflected:
+            word_options = inflected.split("|")
+            # When two parts of a noun need to be pluralized
+            if len(word_options[0].split(" ")) == len(word_options[1].split(" ")):
+                result = inflected.split("|")[self.classical_dict["all"]].split(" ")
+            # When only the last part of the noun needs to be pluralized
+            else:
+                result = inflected.split(" ")
+                for index, word in enumerate(result):
+                    if "|" in word:
+                        result[index] = word.split("|")[self.classical_dict["all"]]
+        else:
+            result = inflected.split(" ")
+
+        # Try to fix word wise capitalization
+        for index, word in enumerate(orig.split(" ")):
+            if word == "I":
+                # Is this the only word for exceptions like this
+                # Where the original is fully capitalized
+                # without 'meaning' capitalization?
+                # Also this fails to handle a capitalizaion in context
+                continue
+            if word.capitalize() == word:
+                result[index] = result[index].capitalize()
+            if word == word.upper():
+                result[index] = result[index].upper()
+        return " ".join(result)
+
+    def partition_word(self, text: str) -> Tuple[str, str, str]:
+        mo = PARTITION_WORD.search(text)
+        if mo:
+            return mo.group(1), mo.group(2), mo.group(3)
+        else:
+            return "", "", ""
+
+    @validate_arguments
+    def plural(self, text: Word, count: Optional[Union[str, int, Any]] = None) -> str:
+        """
+        Return the plural of text.
+
+        If count supplied, then return text if count is one of:
+            1, a, an, one, each, every, this, that
+
+        otherwise return the plural.
+
+        Whitespace at the start and end is preserved.
+
+        """
+        pre, word, post = self.partition_word(text)
+        if not word:
+            return text
+        plural = self.postprocess(
+            word,
+            self._pl_special_adjective(word, count)
+            or self._pl_special_verb(word, count)
+            or self._plnoun(word, count),
+        )
+        return f"{pre}{plural}{post}"
+
+    @validate_arguments
+    def plural_noun(
+        self, text: Word, count: Optional[Union[str, int, Any]] = None
+    ) -> str:
+        """
+        Return the plural of text, where text is a noun.
+
+        If count supplied, then return text if count is one of:
+            1, a, an, one, each, every, this, that
+
+        otherwise return the plural.
+
+        Whitespace at the start and end is preserved.
+
+        """
+        pre, word, post = self.partition_word(text)
+        if not word:
+            return text
+        plural = self.postprocess(word, self._plnoun(word, count))
+        return f"{pre}{plural}{post}"
+
+    @validate_arguments
+    def plural_verb(
+        self, text: Word, count: Optional[Union[str, int, Any]] = None
+    ) -> str:
+        """
+        Return the plural of text, where text is a verb.
+
+        If count supplied, then return text if count is one of:
+            1, a, an, one, each, every, this, that
+
+        otherwise return the plural.
+
+        Whitespace at the start and end is preserved.
+
+        """
+        pre, word, post = self.partition_word(text)
+        if not word:
+            return text
+        plural = self.postprocess(
+            word,
+            self._pl_special_verb(word, count) or self._pl_general_verb(word, count),
+        )
+        return f"{pre}{plural}{post}"
+
+    @validate_arguments
+    def plural_adj(
+        self, text: Word, count: Optional[Union[str, int, Any]] = None
+    ) -> str:
+        """
+        Return the plural of text, where text is an adjective.
+
+        If count supplied, then return text if count is one of:
+            1, a, an, one, each, every, this, that
+
+        otherwise return the plural.
+
+        Whitespace at the start and end is preserved.
+
+        """
+        pre, word, post = self.partition_word(text)
+        if not word:
+            return text
+        plural = self.postprocess(word, self._pl_special_adjective(word, count) or word)
+        return f"{pre}{plural}{post}"
+
+    @validate_arguments
+    def compare(self, word1: Word, word2: Word) -> Union[str, bool]:
+        """
+        compare word1 and word2 for equality regardless of plurality
+
+        return values:
+        eq - the strings are equal
+        p:s - word1 is the plural of word2
+        s:p - word2 is the plural of word1
+        p:p - word1 and word2 are two different plural forms of the one word
+        False - otherwise
+
+        >>> compare = engine().compare
+        >>> compare("egg", "eggs")
+        's:p'
+        >>> compare('egg', 'egg')
+        'eq'
+
+        Words should not be empty.
+
+        >>> compare('egg', '')
+        Traceback (most recent call last):
+        ...
+        pydantic.error_wrappers.ValidationError: 1 validation error for Compare
+        word2
+          ensure this value has at least 1 characters...
+        """
+        norms = self.plural_noun, self.plural_verb, self.plural_adj
+        results = (self._plequal(word1, word2, norm) for norm in norms)
+        return next(filter(None, results), False)
+
+    @validate_arguments
+    def compare_nouns(self, word1: Word, word2: Word) -> Union[str, bool]:
+        """
+        compare word1 and word2 for equality regardless of plurality
+        word1 and word2 are to be treated as nouns
+
+        return values:
+        eq - the strings are equal
+        p:s - word1 is the plural of word2
+        s:p - word2 is the plural of word1
+        p:p - word1 and word2 are two different plural forms of the one word
+        False - otherwise
+
+        """
+        return self._plequal(word1, word2, self.plural_noun)
+
+    @validate_arguments
+    def compare_verbs(self, word1: Word, word2: Word) -> Union[str, bool]:
+        """
+        compare word1 and word2 for equality regardless of plurality
+        word1 and word2 are to be treated as verbs
+
+        return values:
+        eq - the strings are equal
+        p:s - word1 is the plural of word2
+        s:p - word2 is the plural of word1
+        p:p - word1 and word2 are two different plural forms of the one word
+        False - otherwise
+
+        """
+        return self._plequal(word1, word2, self.plural_verb)
+
+    @validate_arguments
+    def compare_adjs(self, word1: Word, word2: Word) -> Union[str, bool]:
+        """
+        compare word1 and word2 for equality regardless of plurality
+        word1 and word2 are to be treated as adjectives
+
+        return values:
+        eq - the strings are equal
+        p:s - word1 is the plural of word2
+        s:p - word2 is the plural of word1
+        p:p - word1 and word2 are two different plural forms of the one word
+        False - otherwise
+
+        """
+        return self._plequal(word1, word2, self.plural_adj)
+
+    @validate_arguments
+    def singular_noun(
+        self,
+        text: Word,
+        count: Optional[Union[int, str, Any]] = None,
+        gender: Optional[str] = None,
+    ) -> Union[str, bool]:
+        """
+        Return the singular of text, where text is a plural noun.
+
+        If count supplied, then return the singular if count is one of:
+            1, a, an, one, each, every, this, that or if count is None
+
+        otherwise return text unchanged.
+
+        Whitespace at the start and end is preserved.
+
+        >>> p = engine()
+        >>> p.singular_noun('horses')
+        'horse'
+        >>> p.singular_noun('knights')
+        'knight'
+
+        Returns False when a singular noun is passed.
+
+        >>> p.singular_noun('horse')
+        False
+        >>> p.singular_noun('knight')
+        False
+        >>> p.singular_noun('soldier')
+        False
+
+        """
+        pre, word, post = self.partition_word(text)
+        if not word:
+            return text
+        sing = self._sinoun(word, count=count, gender=gender)
+        if sing is not False:
+            plural = self.postprocess(word, sing)
+            return f"{pre}{plural}{post}"
+        return False
+
+    def _plequal(self, word1: str, word2: str, pl) -> Union[str, bool]:  # noqa: C901
+        classval = self.classical_dict.copy()
+        self.classical_dict = all_classical.copy()
+        if word1 == word2:
+            return "eq"
+        if word1 == pl(word2):
+            return "p:s"
+        if pl(word1) == word2:
+            return "s:p"
+        self.classical_dict = no_classical.copy()
+        if word1 == pl(word2):
+            return "p:s"
+        if pl(word1) == word2:
+            return "s:p"
+        self.classical_dict = classval.copy()
+
+        if pl == self.plural or pl == self.plural_noun:
+            if self._pl_check_plurals_N(word1, word2):
+                return "p:p"
+            if self._pl_check_plurals_N(word2, word1):
+                return "p:p"
+        if pl == self.plural or pl == self.plural_adj:
+            if self._pl_check_plurals_adj(word1, word2):
+                return "p:p"
+        return False
+
+    def _pl_reg_plurals(self, pair: str, stems: str, end1: str, end2: str) -> bool:
+        pattern = fr"({stems})({end1}\|\1{end2}|{end2}\|\1{end1})"
+        return bool(re.search(pattern, pair))
+
+    def _pl_check_plurals_N(self, word1: str, word2: str) -> bool:
+        stem_endings = (
+            (pl_sb_C_a_ata, "as", "ata"),
+            (pl_sb_C_is_ides, "is", "ides"),
+            (pl_sb_C_a_ae, "s", "e"),
+            (pl_sb_C_en_ina, "ens", "ina"),
+            (pl_sb_C_um_a, "ums", "a"),
+            (pl_sb_C_us_i, "uses", "i"),
+            (pl_sb_C_on_a, "ons", "a"),
+            (pl_sb_C_o_i_stems, "os", "i"),
+            (pl_sb_C_ex_ices, "exes", "ices"),
+            (pl_sb_C_ix_ices, "ixes", "ices"),
+            (pl_sb_C_i, "s", "i"),
+            (pl_sb_C_im, "s", "im"),
+            (".*eau", "s", "x"),
+            (".*ieu", "s", "x"),
+            (".*tri", "xes", "ces"),
+            (".{2,}[yia]n", "xes", "ges"),
+        )
+
+        words = map(Words, (word1, word2))
+        pair = "|".join(word.last for word in words)
+
+        return (
+            pair in pl_sb_irregular_s.values()
+            or pair in pl_sb_irregular.values()
+            or pair in pl_sb_irregular_caps.values()
+            or any(
+                self._pl_reg_plurals(pair, stems, end1, end2)
+                for stems, end1, end2 in stem_endings
+            )
+        )
+
+    def _pl_check_plurals_adj(self, word1: str, word2: str) -> bool:
+        word1a = word1[: word1.rfind("'")] if word1.endswith(("'s", "'")) else ""
+        word2a = word2[: word2.rfind("'")] if word2.endswith(("'s", "'")) else ""
+
+        return (
+            bool(word1a)
+            and bool(word2a)
+            and (
+                self._pl_check_plurals_N(word1a, word2a)
+                or self._pl_check_plurals_N(word2a, word1a)
+            )
+        )
+
+    def get_count(self, count: Optional[Union[str, int]] = None) -> Union[str, int]:
+        if count is None and self.persistent_count is not None:
+            count = self.persistent_count
+
+        if count is not None:
+            count = (
+                1
+                if (
+                    (str(count) in pl_count_one)
+                    or (
+                        self.classical_dict["zero"]
+                        and str(count).lower() in pl_count_zero
+                    )
+                )
+                else 2
+            )
+        else:
+            count = ""
+        return count
+
+    # @profile
+    def _plnoun(  # noqa: C901
+        self, word: str, count: Optional[Union[str, int]] = None
+    ) -> str:
+        count = self.get_count(count)
+
+        # DEFAULT TO PLURAL
+
+        if count == 1:
+            return word
+
+        # HANDLE USER-DEFINED NOUNS
+
+        value = self.ud_match(word, self.pl_sb_user_defined)
+        if value is not None:
+            return value
+
+        # HANDLE EMPTY WORD, SINGULAR COUNT AND UNINFLECTED PLURALS
+
+        if word == "":
+            return word
+
+        word = Words(word)
+
+        if word.last.lower() in pl_sb_uninflected_complete:
+            return word
+
+        if word in pl_sb_uninflected_caps:
+            return word
+
+        for k, v in pl_sb_uninflected_bysize.items():
+            if word.lowered[-k:] in v:
+                return word
+
+        if self.classical_dict["herd"] and word.last.lower() in pl_sb_uninflected_herd:
+            return word
+
+        # HANDLE COMPOUNDS ("Governor General", "mother-in-law", "aide-de-camp", ETC.)
+
+        mo = PL_SB_POSTFIX_ADJ_STEMS_RE.search(word)
+        if mo and mo.group(2) != "":
+            return f"{self._plnoun(mo.group(1), 2)}{mo.group(2)}"
+
+        if " a " in word.lowered or "-a-" in word.lowered:
+            mo = PL_SB_PREP_DUAL_COMPOUND_RE.search(word)
+            if mo and mo.group(2) != "" and mo.group(3) != "":
+                return (
+                    f"{self._plnoun(mo.group(1), 2)}"
+                    f"{mo.group(2)}"
+                    f"{self._plnoun(mo.group(3))}"
+                )
+
+        if len(word.split_) >= 3:
+            for numword in range(1, len(word.split_) - 1):
+                if word.split_[numword] in pl_prep_list_da:
+                    return " ".join(
+                        word.split_[: numword - 1]
+                        + [self._plnoun(word.split_[numword - 1], 2)]
+                        + word.split_[numword:]
+                    )
+
+        # only pluralize denominators in units
+        mo = DENOMINATOR.search(word.lowered)
+        if mo:
+            index = len(mo.group("denominator"))
+            return f"{self._plnoun(word[:index])}{word[index:]}"
+
+        # handle units given in degrees (only accept if
+        # there is no more than one word following)
+        # degree Celsius => degrees Celsius but degree
+        # fahrenheit hour => degree fahrenheit hours
+        if len(word.split_) >= 2 and word.split_[-2] == "degree":
+            return " ".join([self._plnoun(word.first)] + word.split_[1:])
+
+        with contextlib.suppress(ValueError):
+            return self._handle_prepositional_phrase(
+                word.lowered,
+                functools.partial(self._plnoun, count=2),
+                '-',
+            )
+
+        # HANDLE PRONOUNS
+
+        for k, v in pl_pron_acc_keys_bysize.items():
+            if word.lowered[-k:] in v:  # ends with accusative pronoun
+                for pk, pv in pl_prep_bysize.items():
+                    if word.lowered[:pk] in pv:  # starts with a prep
+                        if word.lowered.split() == [
+                            word.lowered[:pk],
+                            word.lowered[-k:],
+                        ]:
+                            # only whitespace in between
+                            return word.lowered[:-k] + pl_pron_acc[word.lowered[-k:]]
+
+        try:
+            return pl_pron_nom[word.lowered]
+        except KeyError:
+            pass
+
+        try:
+            return pl_pron_acc[word.lowered]
+        except KeyError:
+            pass
+
+        # HANDLE ISOLATED IRREGULAR PLURALS
+
+        if word.last in pl_sb_irregular_caps:
+            llen = len(word.last)
+            return f"{word[:-llen]}{pl_sb_irregular_caps[word.last]}"
+
+        lowered_last = word.last.lower()
+        if lowered_last in pl_sb_irregular:
+            llen = len(lowered_last)
+            return f"{word[:-llen]}{pl_sb_irregular[lowered_last]}"
+
+        dash_split = word.lowered.split('-')
+        if (" ".join(dash_split[-2:])).lower() in pl_sb_irregular_compound:
+            llen = len(
+                " ".join(dash_split[-2:])
+            )  # TODO: what if 2 spaces between these words?
+            return (
+                f"{word[:-llen]}"
+                f"{pl_sb_irregular_compound[(' '.join(dash_split[-2:])).lower()]}"
+            )
+
+        if word.lowered[-3:] == "quy":
+            return f"{word[:-1]}ies"
+
+        if word.lowered[-6:] == "person":
+            if self.classical_dict["persons"]:
+                return f"{word}s"
+            else:
+                return f"{word[:-4]}ople"
+
+        # HANDLE FAMILIES OF IRREGULAR PLURALS
+
+        if word.lowered[-3:] == "man":
+            for k, v in pl_sb_U_man_mans_bysize.items():
+                if word.lowered[-k:] in v:
+                    return f"{word}s"
+            for k, v in pl_sb_U_man_mans_caps_bysize.items():
+                if word[-k:] in v:
+                    return f"{word}s"
+            return f"{word[:-3]}men"
+        if word.lowered[-5:] == "mouse":
+            return f"{word[:-5]}mice"
+        if word.lowered[-5:] == "louse":
+            v = pl_sb_U_louse_lice_bysize.get(len(word))
+            if v and word.lowered in v:
+                return f"{word[:-5]}lice"
+            return f"{word}s"
+        if word.lowered[-5:] == "goose":
+            return f"{word[:-5]}geese"
+        if word.lowered[-5:] == "tooth":
+            return f"{word[:-5]}teeth"
+        if word.lowered[-4:] == "foot":
+            return f"{word[:-4]}feet"
+        if word.lowered[-4:] == "taco":
+            return f"{word[:-5]}tacos"
+
+        if word.lowered == "die":
+            return "dice"
+
+        # HANDLE UNASSIMILATED IMPORTS
+
+        if word.lowered[-4:] == "ceps":
+            return word
+        if word.lowered[-4:] == "zoon":
+            return f"{word[:-2]}a"
+        if word.lowered[-3:] in ("cis", "sis", "xis"):
+            return f"{word[:-2]}es"
+
+        for lastlet, d, numend, post in (
+            ("h", pl_sb_U_ch_chs_bysize, None, "s"),
+            ("x", pl_sb_U_ex_ices_bysize, -2, "ices"),
+            ("x", pl_sb_U_ix_ices_bysize, -2, "ices"),
+            ("m", pl_sb_U_um_a_bysize, -2, "a"),
+            ("s", pl_sb_U_us_i_bysize, -2, "i"),
+            ("n", pl_sb_U_on_a_bysize, -2, "a"),
+            ("a", pl_sb_U_a_ae_bysize, None, "e"),
+        ):
+            if word.lowered[-1] == lastlet:  # this test to add speed
+                for k, v in d.items():
+                    if word.lowered[-k:] in v:
+                        return word[:numend] + post
+
+        # HANDLE INCOMPLETELY ASSIMILATED IMPORTS
+
+        if self.classical_dict["ancient"]:
+            if word.lowered[-4:] == "trix":
+                return f"{word[:-1]}ces"
+            if word.lowered[-3:] in ("eau", "ieu"):
+                return f"{word}x"
+            if word.lowered[-3:] in ("ynx", "inx", "anx") and len(word) > 4:
+                return f"{word[:-1]}ges"
+
+            for lastlet, d, numend, post in (
+                ("n", pl_sb_C_en_ina_bysize, -2, "ina"),
+                ("x", pl_sb_C_ex_ices_bysize, -2, "ices"),
+                ("x", pl_sb_C_ix_ices_bysize, -2, "ices"),
+                ("m", pl_sb_C_um_a_bysize, -2, "a"),
+                ("s", pl_sb_C_us_i_bysize, -2, "i"),
+                ("s", pl_sb_C_us_us_bysize, None, ""),
+                ("a", pl_sb_C_a_ae_bysize, None, "e"),
+                ("a", pl_sb_C_a_ata_bysize, None, "ta"),
+                ("s", pl_sb_C_is_ides_bysize, -1, "des"),
+                ("o", pl_sb_C_o_i_bysize, -1, "i"),
+                ("n", pl_sb_C_on_a_bysize, -2, "a"),
+            ):
+                if word.lowered[-1] == lastlet:  # this test to add speed
+                    for k, v in d.items():
+                        if word.lowered[-k:] in v:
+                            return word[:numend] + post
+
+            for d, numend, post in (
+                (pl_sb_C_i_bysize, None, "i"),
+                (pl_sb_C_im_bysize, None, "im"),
+            ):
+                for k, v in d.items():
+                    if word.lowered[-k:] in v:
+                        return word[:numend] + post
+
+        # HANDLE SINGULAR NOUNS ENDING IN ...s OR OTHER SILIBANTS
+
+        if lowered_last in pl_sb_singular_s_complete:
+            return f"{word}es"
+
+        for k, v in pl_sb_singular_s_bysize.items():
+            if word.lowered[-k:] in v:
+                return f"{word}es"
+
+        if word.lowered[-2:] == "es" and word[0] == word[0].upper():
+            return f"{word}es"
+
+        if word.lowered[-1] == "z":
+            for k, v in pl_sb_z_zes_bysize.items():
+                if word.lowered[-k:] in v:
+                    return f"{word}es"
+
+            if word.lowered[-2:-1] != "z":
+                return f"{word}zes"
+
+        if word.lowered[-2:] == "ze":
+            for k, v in pl_sb_ze_zes_bysize.items():
+                if word.lowered[-k:] in v:
+                    return f"{word}s"
+
+        if word.lowered[-2:] in ("ch", "sh", "zz", "ss") or word.lowered[-1] == "x":
+            return f"{word}es"
+
+        # HANDLE ...f -> ...ves
+
+        if word.lowered[-3:] in ("elf", "alf", "olf"):
+            return f"{word[:-1]}ves"
+        if word.lowered[-3:] == "eaf" and word.lowered[-4:-3] != "d":
+            return f"{word[:-1]}ves"
+        if word.lowered[-4:] in ("nife", "life", "wife"):
+            return f"{word[:-2]}ves"
+        if word.lowered[-3:] == "arf":
+            return f"{word[:-1]}ves"
+
+        # HANDLE ...y
+
+        if word.lowered[-1] == "y":
+            if word.lowered[-2:-1] in "aeiou" or len(word) == 1:
+                return f"{word}s"
+
+            if self.classical_dict["names"]:
+                if word.lowered[-1] == "y" and word[0] == word[0].upper():
+                    return f"{word}s"
+
+            return f"{word[:-1]}ies"
+
+        # HANDLE ...o
+
+        if lowered_last in pl_sb_U_o_os_complete:
+            return f"{word}s"
+
+        for k, v in pl_sb_U_o_os_bysize.items():
+            if word.lowered[-k:] in v:
+                return f"{word}s"
+
+        if word.lowered[-2:] in ("ao", "eo", "io", "oo", "uo"):
+            return f"{word}s"
+
+        if word.lowered[-1] == "o":
+            return f"{word}es"
+
+        # OTHERWISE JUST ADD ...s
+
+        return f"{word}s"
+
+    @classmethod
+    def _handle_prepositional_phrase(cls, phrase, transform, sep):
+        """
+        Given a word or phrase possibly separated by sep, parse out
+        the prepositional phrase and apply the transform to the word
+        preceding the prepositional phrase.
+
+        Raise ValueError if the pivot is not found or if at least two
+        separators are not found.
+
+        >>> engine._handle_prepositional_phrase("man-of-war", str.upper, '-')
+        'MAN-of-war'
+        >>> engine._handle_prepositional_phrase("man of war", str.upper, ' ')
+        'MAN of war'
+        """
+        parts = phrase.split(sep)
+        if len(parts) < 3:
+            raise ValueError("Cannot handle words with fewer than two separators")
+
+        pivot = cls._find_pivot(parts, pl_prep_list_da)
+
+        transformed = transform(parts[pivot - 1]) or parts[pivot - 1]
+        return " ".join(
+            parts[: pivot - 1] + [sep.join([transformed, parts[pivot], ''])]
+        ) + " ".join(parts[(pivot + 1) :])
+
+    @staticmethod
+    def _find_pivot(words, candidates):
+        pivots = (
+            index for index in range(1, len(words) - 1) if words[index] in candidates
+        )
+        try:
+            return next(pivots)
+        except StopIteration:
+            raise ValueError("No pivot found")
+
+    def _pl_special_verb(  # noqa: C901
+        self, word: str, count: Optional[Union[str, int]] = None
+    ) -> Union[str, bool]:
+        if self.classical_dict["zero"] and str(count).lower() in pl_count_zero:
+            return False
+        count = self.get_count(count)
+
+        if count == 1:
+            return word
+
+        # HANDLE USER-DEFINED VERBS
+
+        value = self.ud_match(word, self.pl_v_user_defined)
+        if value is not None:
+            return value
+
+        # HANDLE IRREGULAR PRESENT TENSE (SIMPLE AND COMPOUND)
+
+        try:
+            words = Words(word)
+        except IndexError:
+            return False  # word is ''
+
+        if words.first in plverb_irregular_pres:
+            return f"{plverb_irregular_pres[words.first]}{words[len(words.first) :]}"
+
+        # HANDLE IRREGULAR FUTURE, PRETERITE AND PERFECT TENSES
+
+        if words.first in plverb_irregular_non_pres:
+            return word
+
+        # HANDLE PRESENT NEGATIONS (SIMPLE AND COMPOUND)
+
+        if words.first.endswith("n't") and words.first[:-3] in plverb_irregular_pres:
+            return (
+                f"{plverb_irregular_pres[words.first[:-3]]}n't"
+                f"{words[len(words.first) :]}"
+            )
+
+        if words.first.endswith("n't"):
+            return word
+
+        # HANDLE SPECIAL CASES
+
+        mo = PLVERB_SPECIAL_S_RE.search(word)
+        if mo:
+            return False
+        if WHITESPACE.search(word):
+            return False
+
+        if words.lowered == "quizzes":
+            return "quiz"
+
+        # HANDLE STANDARD 3RD PERSON (CHOP THE ...(e)s OFF SINGLE WORDS)
+
+        if (
+            words.lowered[-4:] in ("ches", "shes", "zzes", "sses")
+            or words.lowered[-3:] == "xes"
+        ):
+            return words[:-2]
+
+        if words.lowered[-3:] == "ies" and len(words) > 3:
+            return words.lowered[:-3] + "y"
+
+        if (
+            words.last.lower() in pl_v_oes_oe
+            or words.lowered[-4:] in pl_v_oes_oe_endings_size4
+            or words.lowered[-5:] in pl_v_oes_oe_endings_size5
+        ):
+            return words[:-1]
+
+        if words.lowered.endswith("oes") and len(words) > 3:
+            return words.lowered[:-2]
+
+        mo = ENDS_WITH_S.search(words)
+        if mo:
+            return mo.group(1)
+
+        # OTHERWISE, A REGULAR VERB (HANDLE ELSEWHERE)
+
+        return False
+
+    def _pl_general_verb(
+        self, word: str, count: Optional[Union[str, int]] = None
+    ) -> str:
+        count = self.get_count(count)
+
+        if count == 1:
+            return word
+
+        # HANDLE AMBIGUOUS PRESENT TENSES  (SIMPLE AND COMPOUND)
+
+        mo = plverb_ambiguous_pres_keys.search(word)
+        if mo:
+            return f"{plverb_ambiguous_pres[mo.group(1).lower()]}{mo.group(2)}"
+
+        # HANDLE AMBIGUOUS PRETERITE AND PERFECT TENSES
+
+        mo = plverb_ambiguous_non_pres.search(word)
+        if mo:
+            return word
+
+        # OTHERWISE, 1st OR 2ND PERSON IS UNINFLECTED
+
+        return word
+
+    def _pl_special_adjective(
+        self, word: str, count: Optional[Union[str, int]] = None
+    ) -> Union[str, bool]:
+        count = self.get_count(count)
+
+        if count == 1:
+            return word
+
+        # HANDLE USER-DEFINED ADJECTIVES
+
+        value = self.ud_match(word, self.pl_adj_user_defined)
+        if value is not None:
+            return value
+
+        # HANDLE KNOWN CASES
+
+        mo = pl_adj_special_keys.search(word)
+        if mo:
+            return pl_adj_special[mo.group(1).lower()]
+
+        # HANDLE POSSESSIVES
+
+        mo = pl_adj_poss_keys.search(word)
+        if mo:
+            return pl_adj_poss[mo.group(1).lower()]
+
+        mo = ENDS_WITH_APOSTROPHE_S.search(word)
+        if mo:
+            pl = self.plural_noun(mo.group(1))
+            trailing_s = "" if pl[-1] == "s" else "s"
+            return f"{pl}'{trailing_s}"
+
+        # OTHERWISE, NO IDEA
+
+        return False
+
+    # @profile
+    def _sinoun(  # noqa: C901
+        self,
+        word: str,
+        count: Optional[Union[str, int]] = None,
+        gender: Optional[str] = None,
+    ) -> Union[str, bool]:
+        count = self.get_count(count)
+
+        # DEFAULT TO PLURAL
+
+        if count == 2:
+            return word
+
+        # SET THE GENDER
+
+        try:
+            if gender is None:
+                gender = self.thegender
+            elif gender not in singular_pronoun_genders:
+                raise BadGenderError
+        except (TypeError, IndexError):
+            raise BadGenderError
+
+        # HANDLE USER-DEFINED NOUNS
+
+        value = self.ud_match(word, self.si_sb_user_defined)
+        if value is not None:
+            return value
+
+        # HANDLE EMPTY WORD, SINGULAR COUNT AND UNINFLECTED PLURALS
+
+        if word == "":
+            return word
+
+        if word in si_sb_ois_oi_case:
+            return word[:-1]
+
+        words = Words(word)
+
+        if words.last.lower() in pl_sb_uninflected_complete:
+            return word
+
+        if word in pl_sb_uninflected_caps:
+            return word
+
+        for k, v in pl_sb_uninflected_bysize.items():
+            if words.lowered[-k:] in v:
+                return word
+
+        if self.classical_dict["herd"] and words.last.lower() in pl_sb_uninflected_herd:
+            return word
+
+        if words.last.lower() in pl_sb_C_us_us:
+            return word if self.classical_dict["ancient"] else False
+
+        # HANDLE COMPOUNDS ("Governor General", "mother-in-law", "aide-de-camp", ETC.)
+
+        mo = PL_SB_POSTFIX_ADJ_STEMS_RE.search(word)
+        if mo and mo.group(2) != "":
+            return f"{self._sinoun(mo.group(1), 1, gender=gender)}{mo.group(2)}"
+
+        with contextlib.suppress(ValueError):
+            return self._handle_prepositional_phrase(
+                words.lowered,
+                functools.partial(self._sinoun, count=1, gender=gender),
+                ' ',
+            )
+
+        with contextlib.suppress(ValueError):
+            return self._handle_prepositional_phrase(
+                words.lowered,
+                functools.partial(self._sinoun, count=1, gender=gender),
+                '-',
+            )
+
+        # HANDLE PRONOUNS
+
+        for k, v in si_pron_acc_keys_bysize.items():
+            if words.lowered[-k:] in v:  # ends with accusative pronoun
+                for pk, pv in pl_prep_bysize.items():
+                    if words.lowered[:pk] in pv:  # starts with a prep
+                        if words.lowered.split() == [
+                            words.lowered[:pk],
+                            words.lowered[-k:],
+                        ]:
+                            # only whitespace in between
+                            return words.lowered[:-k] + get_si_pron(
+                                "acc", words.lowered[-k:], gender
+                            )
+
+        try:
+            return get_si_pron("nom", words.lowered, gender)
+        except KeyError:
+            pass
+
+        try:
+            return get_si_pron("acc", words.lowered, gender)
+        except KeyError:
+            pass
+
+        # HANDLE ISOLATED IRREGULAR PLURALS
+
+        if words.last in si_sb_irregular_caps:
+            llen = len(words.last)
+            return "{}{}".format(word[:-llen], si_sb_irregular_caps[words.last])
+
+        if words.last.lower() in si_sb_irregular:
+            llen = len(words.last.lower())
+            return "{}{}".format(word[:-llen], si_sb_irregular[words.last.lower()])
+
+        dash_split = words.lowered.split("-")
+        if (" ".join(dash_split[-2:])).lower() in si_sb_irregular_compound:
+            llen = len(
+                " ".join(dash_split[-2:])
+            )  # TODO: what if 2 spaces between these words?
+            return "{}{}".format(
+                word[:-llen],
+                si_sb_irregular_compound[(" ".join(dash_split[-2:])).lower()],
+            )
+
+        if words.lowered[-5:] == "quies":
+            return word[:-3] + "y"
+
+        if words.lowered[-7:] == "persons":
+            return word[:-1]
+        if words.lowered[-6:] == "people":
+            return word[:-4] + "rson"
+
+        # HANDLE FAMILIES OF IRREGULAR PLURALS
+
+        if words.lowered[-4:] == "mans":
+            for k, v in si_sb_U_man_mans_bysize.items():
+                if words.lowered[-k:] in v:
+                    return word[:-1]
+            for k, v in si_sb_U_man_mans_caps_bysize.items():
+                if word[-k:] in v:
+                    return word[:-1]
+        if words.lowered[-3:] == "men":
+            return word[:-3] + "man"
+        if words.lowered[-4:] == "mice":
+            return word[:-4] + "mouse"
+        if words.lowered[-4:] == "lice":
+            v = si_sb_U_louse_lice_bysize.get(len(word))
+            if v and words.lowered in v:
+                return word[:-4] + "louse"
+        if words.lowered[-5:] == "geese":
+            return word[:-5] + "goose"
+        if words.lowered[-5:] == "teeth":
+            return word[:-5] + "tooth"
+        if words.lowered[-4:] == "feet":
+            return word[:-4] + "foot"
+
+        if words.lowered == "dice":
+            return "die"
+
+        # HANDLE UNASSIMILATED IMPORTS
+
+        if words.lowered[-4:] == "ceps":
+            return word
+        if words.lowered[-3:] == "zoa":
+            return word[:-1] + "on"
+
+        for lastlet, d, unass_numend, post in (
+            ("s", si_sb_U_ch_chs_bysize, -1, ""),
+            ("s", si_sb_U_ex_ices_bysize, -4, "ex"),
+            ("s", si_sb_U_ix_ices_bysize, -4, "ix"),
+            ("a", si_sb_U_um_a_bysize, -1, "um"),
+            ("i", si_sb_U_us_i_bysize, -1, "us"),
+            ("a", si_sb_U_on_a_bysize, -1, "on"),
+            ("e", si_sb_U_a_ae_bysize, -1, ""),
+        ):
+            if words.lowered[-1] == lastlet:  # this test to add speed
+                for k, v in d.items():
+                    if words.lowered[-k:] in v:
+                        return word[:unass_numend] + post
+
+        # HANDLE INCOMPLETELY ASSIMILATED IMPORTS
+
+        if self.classical_dict["ancient"]:
+
+            if words.lowered[-6:] == "trices":
+                return word[:-3] + "x"
+            if words.lowered[-4:] in ("eaux", "ieux"):
+                return word[:-1]
+            if words.lowered[-5:] in ("ynges", "inges", "anges") and len(word) > 6:
+                return word[:-3] + "x"
+
+            for lastlet, d, class_numend, post in (
+                ("a", si_sb_C_en_ina_bysize, -3, "en"),
+                ("s", si_sb_C_ex_ices_bysize, -4, "ex"),
+                ("s", si_sb_C_ix_ices_bysize, -4, "ix"),
+                ("a", si_sb_C_um_a_bysize, -1, "um"),
+                ("i", si_sb_C_us_i_bysize, -1, "us"),
+                ("s", pl_sb_C_us_us_bysize, None, ""),
+                ("e", si_sb_C_a_ae_bysize, -1, ""),
+                ("a", si_sb_C_a_ata_bysize, -2, ""),
+                ("s", si_sb_C_is_ides_bysize, -3, "s"),
+                ("i", si_sb_C_o_i_bysize, -1, "o"),
+                ("a", si_sb_C_on_a_bysize, -1, "on"),
+                ("m", si_sb_C_im_bysize, -2, ""),
+                ("i", si_sb_C_i_bysize, -1, ""),
+            ):
+                if words.lowered[-1] == lastlet:  # this test to add speed
+                    for k, v in d.items():
+                        if words.lowered[-k:] in v:
+                            return word[:class_numend] + post
+
+        # HANDLE PLURLS ENDING IN uses -> use
+
+        if (
+            words.lowered[-6:] == "houses"
+            or word in si_sb_uses_use_case
+            or words.last.lower() in si_sb_uses_use
+        ):
+            return word[:-1]
+
+        # HANDLE PLURLS ENDING IN ies -> ie
+
+        if word in si_sb_ies_ie_case or words.last.lower() in si_sb_ies_ie:
+            return word[:-1]
+
+        # HANDLE PLURLS ENDING IN oes -> oe
+
+        if (
+            words.lowered[-5:] == "shoes"
+            or word in si_sb_oes_oe_case
+            or words.last.lower() in si_sb_oes_oe
+        ):
+            return word[:-1]
+
+        # HANDLE SINGULAR NOUNS ENDING IN ...s OR OTHER SILIBANTS
+
+        if word in si_sb_sses_sse_case or words.last.lower() in si_sb_sses_sse:
+            return word[:-1]
+
+        if words.last.lower() in si_sb_singular_s_complete:
+            return word[:-2]
+
+        for k, v in si_sb_singular_s_bysize.items():
+            if words.lowered[-k:] in v:
+                return word[:-2]
+
+        if words.lowered[-4:] == "eses" and word[0] == word[0].upper():
+            return word[:-2]
+
+        if words.last.lower() in si_sb_z_zes:
+            return word[:-2]
+
+        if words.last.lower() in si_sb_zzes_zz:
+            return word[:-2]
+
+        if words.lowered[-4:] == "zzes":
+            return word[:-3]
+
+        if word in si_sb_ches_che_case or words.last.lower() in si_sb_ches_che:
+            return word[:-1]
+
+        if words.lowered[-4:] in ("ches", "shes"):
+            return word[:-2]
+
+        if words.last.lower() in si_sb_xes_xe:
+            return word[:-1]
+
+        if words.lowered[-3:] == "xes":
+            return word[:-2]
+
+        # HANDLE ...f -> ...ves
+
+        if word in si_sb_ves_ve_case or words.last.lower() in si_sb_ves_ve:
+            return word[:-1]
+
+        if words.lowered[-3:] == "ves":
+            if words.lowered[-5:-3] in ("el", "al", "ol"):
+                return word[:-3] + "f"
+            if words.lowered[-5:-3] == "ea" and word[-6:-5] != "d":
+                return word[:-3] + "f"
+            if words.lowered[-5:-3] in ("ni", "li", "wi"):
+                return word[:-3] + "fe"
+            if words.lowered[-5:-3] == "ar":
+                return word[:-3] + "f"
+
+        # HANDLE ...y
+
+        if words.lowered[-2:] == "ys":
+            if len(words.lowered) > 2 and words.lowered[-3] in "aeiou":
+                return word[:-1]
+
+            if self.classical_dict["names"]:
+                if words.lowered[-2:] == "ys" and word[0] == word[0].upper():
+                    return word[:-1]
+
+        if words.lowered[-3:] == "ies":
+            return word[:-3] + "y"
+
+        # HANDLE ...o
+
+        if words.lowered[-2:] == "os":
+
+            if words.last.lower() in si_sb_U_o_os_complete:
+                return word[:-1]
+
+            for k, v in si_sb_U_o_os_bysize.items():
+                if words.lowered[-k:] in v:
+                    return word[:-1]
+
+            if words.lowered[-3:] in ("aos", "eos", "ios", "oos", "uos"):
+                return word[:-1]
+
+        if words.lowered[-3:] == "oes":
+            return word[:-2]
+
+        # UNASSIMILATED IMPORTS FINAL RULE
+
+        if word in si_sb_es_is:
+            return word[:-2] + "is"
+
+        # OTHERWISE JUST REMOVE ...s
+
+        if words.lowered[-1] == "s":
+            return word[:-1]
+
+        # COULD NOT FIND SINGULAR
+
+        return False
+
+    # ADJECTIVES
+
+    @validate_arguments
+    def a(self, text: Word, count: Optional[Union[int, str, Any]] = 1) -> str:
+        """
+        Return the appropriate indefinite article followed by text.
+
+        The indefinite article is either 'a' or 'an'.
+
+        If count is not one, then return count followed by text
+        instead of 'a' or 'an'.
+
+        Whitespace at the start and end is preserved.
+
+        """
+        mo = INDEFINITE_ARTICLE_TEST.search(text)
+        if mo:
+            word = mo.group(2)
+            if not word:
+                return text
+            pre = mo.group(1)
+            post = mo.group(3)
+            result = self._indef_article(word, count)
+            return f"{pre}{result}{post}"
+        return ""
+
+    an = a
+
+    _indef_article_cases = (
+        # HANDLE ORDINAL FORMS
+        (A_ordinal_a, "a"),
+        (A_ordinal_an, "an"),
+        # HANDLE SPECIAL CASES
+        (A_explicit_an, "an"),
+        (SPECIAL_AN, "an"),
+        (SPECIAL_A, "a"),
+        # HANDLE ABBREVIATIONS
+        (A_abbrev, "an"),
+        (SPECIAL_ABBREV_AN, "an"),
+        (SPECIAL_ABBREV_A, "a"),
+        # HANDLE CONSONANTS
+        (CONSONANTS, "a"),
+        # HANDLE SPECIAL VOWEL-FORMS
+        (ARTICLE_SPECIAL_EU, "a"),
+        (ARTICLE_SPECIAL_ONCE, "a"),
+        (ARTICLE_SPECIAL_ONETIME, "a"),
+        (ARTICLE_SPECIAL_UNIT, "a"),
+        (ARTICLE_SPECIAL_UBA, "a"),
+        (ARTICLE_SPECIAL_UKR, "a"),
+        (A_explicit_a, "a"),
+        # HANDLE SPECIAL CAPITALS
+        (SPECIAL_CAPITALS, "a"),
+        # HANDLE VOWELS
+        (VOWELS, "an"),
+        # HANDLE y...
+        # (BEFORE CERTAIN CONSONANTS IMPLIES (UNNATURALIZED) "i.." SOUND)
+        (A_y_cons, "an"),
+    )
+
+    def _indef_article(self, word: str, count: Union[int, str, Any]) -> str:
+        mycount = self.get_count(count)
+
+        if mycount != 1:
+            return f"{count} {word}"
+
+        # HANDLE USER-DEFINED VARIANTS
+
+        value = self.ud_match(word, self.A_a_user_defined)
+        if value is not None:
+            return f"{value} {word}"
+
+        matches = (
+            f'{article} {word}'
+            for regexen, article in self._indef_article_cases
+            if regexen.search(word)
+        )
+
+        # OTHERWISE, GUESS "a"
+        fallback = f'a {word}'
+        return next(matches, fallback)
+
+    # 2. TRANSLATE ZERO-QUANTIFIED $word TO "no plural($word)"
+
+    @validate_arguments
+    def no(self, text: Word, count: Optional[Union[int, str]] = None) -> str:
+        """
+        If count is 0, no, zero or nil, return 'no' followed by the plural
+        of text.
+
+        If count is one of:
+            1, a, an, one, each, every, this, that
+            return count followed by text.
+
+        Otherwise return count follow by the plural of text.
+
+        In the return value count is always followed by a space.
+
+        Whitespace at the start and end is preserved.
+
+        """
+        if count is None and self.persistent_count is not None:
+            count = self.persistent_count
+
+        if count is None:
+            count = 0
+        mo = PARTITION_WORD.search(text)
+        if mo:
+            pre = mo.group(1)
+            word = mo.group(2)
+            post = mo.group(3)
+        else:
+            pre = ""
+            word = ""
+            post = ""
+
+        if str(count).lower() in pl_count_zero:
+            count = 'no'
+        return f"{pre}{count} {self.plural(word, count)}{post}"
+
+    # PARTICIPLES
+
+    @validate_arguments
+    def present_participle(self, word: Word) -> str:
+        """
+        Return the present participle for word.
+
+        word is the 3rd person singular verb.
+
+        """
+        plv = self.plural_verb(word, 2)
+        ans = plv
+
+        for regexen, repl in PRESENT_PARTICIPLE_REPLACEMENTS:
+            ans, num = regexen.subn(repl, plv)
+            if num:
+                return f"{ans}ing"
+        return f"{ans}ing"
+
+    # NUMERICAL INFLECTIONS
+
+    @validate_arguments
+    def ordinal(self, num: Union[int, Word]) -> str:  # noqa: C901
+        """
+        Return the ordinal of num.
+
+        num can be an integer or text
+
+        e.g. ordinal(1) returns '1st'
+        ordinal('one') returns 'first'
+
+        """
+        if DIGIT.match(str(num)):
+            if isinstance(num, (int, float)):
+                n = int(num)
+            else:
+                if "." in str(num):
+                    try:
+                        # numbers after decimal,
+                        # so only need last one for ordinal
+                        n = int(num[-1])
+
+                    except ValueError:  # ends with '.', so need to use whole string
+                        n = int(num[:-1])
+                else:
+                    n = int(num)
+            try:
+                post = nth[n % 100]
+            except KeyError:
+                post = nth[n % 10]
+            return f"{num}{post}"
+        else:
+            # Mad props to Damian Conway (?) whose ordinal()
+            # algorithm is type-bendy enough to foil MyPy
+            str_num: str = num  # type:	ignore[assignment]
+            mo = ordinal_suff.search(str_num)
+            if mo:
+                post = ordinal[mo.group(1)]
+                rval = ordinal_suff.sub(post, str_num)
+            else:
+                rval = f"{str_num}th"
+            return rval
+
+    def millfn(self, ind: int = 0) -> str:
+        if ind > len(mill) - 1:
+            print3("number out of range")
+            raise NumOutOfRangeError
+        return mill[ind]
+
+    def unitfn(self, units: int, mindex: int = 0) -> str:
+        return f"{unit[units]}{self.millfn(mindex)}"
+
+    def tenfn(self, tens, units, mindex=0) -> str:
+        if tens != 1:
+            tens_part = ten[tens]
+            if tens and units:
+                hyphen = "-"
+            else:
+                hyphen = ""
+            unit_part = unit[units]
+            mill_part = self.millfn(mindex)
+            return f"{tens_part}{hyphen}{unit_part}{mill_part}"
+        return f"{teen[units]}{mill[mindex]}"
+
+    def hundfn(self, hundreds: int, tens: int, units: int, mindex: int) -> str:
+        if hundreds:
+            andword = f" {self._number_args['andword']} " if tens or units else ""
+            # use unit not unitfn as simpler
+            return (
+                f"{unit[hundreds]} hundred{andword}"
+                f"{self.tenfn(tens, units)}{self.millfn(mindex)}, "
+            )
+        if tens or units:
+            return f"{self.tenfn(tens, units)}{self.millfn(mindex)}, "
+        return ""
+
+    def group1sub(self, mo: Match) -> str:
+        units = int(mo.group(1))
+        if units == 1:
+            return f" {self._number_args['one']}, "
+        elif units:
+            return f"{unit[units]}, "
+        else:
+            return f" {self._number_args['zero']}, "
+
+    def group1bsub(self, mo: Match) -> str:
+        units = int(mo.group(1))
+        if units:
+            return f"{unit[units]}, "
+        else:
+            return f" {self._number_args['zero']}, "
+
+    def group2sub(self, mo: Match) -> str:
+        tens = int(mo.group(1))
+        units = int(mo.group(2))
+        if tens:
+            return f"{self.tenfn(tens, units)}, "
+        if units:
+            return f" {self._number_args['zero']} {unit[units]}, "
+        return f" {self._number_args['zero']} {self._number_args['zero']}, "
+
+    def group3sub(self, mo: Match) -> str:
+        hundreds = int(mo.group(1))
+        tens = int(mo.group(2))
+        units = int(mo.group(3))
+        if hundreds == 1:
+            hunword = f" {self._number_args['one']}"
+        elif hundreds:
+            hunword = str(unit[hundreds])
+        else:
+            hunword = f" {self._number_args['zero']}"
+        if tens:
+            tenword = self.tenfn(tens, units)
+        elif units:
+            tenword = f" {self._number_args['zero']} {unit[units]}"
+        else:
+            tenword = f" {self._number_args['zero']} {self._number_args['zero']}"
+        return f"{hunword} {tenword}, "
+
+    def hundsub(self, mo: Match) -> str:
+        ret = self.hundfn(
+            int(mo.group(1)), int(mo.group(2)), int(mo.group(3)), self.mill_count
+        )
+        self.mill_count += 1
+        return ret
+
+    def tensub(self, mo: Match) -> str:
+        return f"{self.tenfn(int(mo.group(1)), int(mo.group(2)), self.mill_count)}, "
+
+    def unitsub(self, mo: Match) -> str:
+        return f"{self.unitfn(int(mo.group(1)), self.mill_count)}, "
+
+    def enword(self, num: str, group: int) -> str:
+        # import pdb
+        # pdb.set_trace()
+
+        if group == 1:
+            num = DIGIT_GROUP.sub(self.group1sub, num)
+        elif group == 2:
+            num = TWO_DIGITS.sub(self.group2sub, num)
+            num = DIGIT_GROUP.sub(self.group1bsub, num, 1)
+        elif group == 3:
+            num = THREE_DIGITS.sub(self.group3sub, num)
+            num = TWO_DIGITS.sub(self.group2sub, num, 1)
+            num = DIGIT_GROUP.sub(self.group1sub, num, 1)
+        elif int(num) == 0:
+            num = self._number_args["zero"]
+        elif int(num) == 1:
+            num = self._number_args["one"]
+        else:
+            num = num.lstrip().lstrip("0")
+            self.mill_count = 0
+            # surely there's a better way to do the next bit
+            mo = THREE_DIGITS_WORD.search(num)
+            while mo:
+                num = THREE_DIGITS_WORD.sub(self.hundsub, num, 1)
+                mo = THREE_DIGITS_WORD.search(num)
+            num = TWO_DIGITS_WORD.sub(self.tensub, num, 1)
+            num = ONE_DIGIT_WORD.sub(self.unitsub, num, 1)
+        return num
+
+    @validate_arguments(config=dict(arbitrary_types_allowed=True))  # noqa: C901
+    def number_to_words(  # noqa: C901
+        self,
+        num: Union[Number, Word],
+        wantlist: bool = False,
+        group: int = 0,
+        comma: Union[Falsish, str] = ",",
+        andword: str = "and",
+        zero: str = "zero",
+        one: str = "one",
+        decimal: Union[Falsish, str] = "point",
+        threshold: Optional[int] = None,
+    ) -> Union[str, List[str]]:
+        """
+        Return a number in words.
+
+        group = 1, 2 or 3 to group numbers before turning into words
+        comma: define comma
+
+        andword:
+            word for 'and'. Can be set to ''.
+            e.g. "one hundred and one" vs "one hundred one"
+
+        zero: word for '0'
+        one: word for '1'
+        decimal: word for decimal point
+        threshold: numbers above threshold not turned into words
+
+        parameters not remembered from last call. Departure from Perl version.
+        """
+        self._number_args = {"andword": andword, "zero": zero, "one": one}
+        num = str(num)
+
+        # Handle "stylistic" conversions (up to a given threshold)...
+        if threshold is not None and float(num) > threshold:
+            spnum = num.split(".", 1)
+            while comma:
+                (spnum[0], n) = FOUR_DIGIT_COMMA.subn(r"\1,\2", spnum[0])
+                if n == 0:
+                    break
+            try:
+                return f"{spnum[0]}.{spnum[1]}"
+            except IndexError:
+                return str(spnum[0])
+
+        if group < 0 or group > 3:
+            raise BadChunkingOptionError
+        nowhite = num.lstrip()
+        if nowhite[0] == "+":
+            sign = "plus"
+        elif nowhite[0] == "-":
+            sign = "minus"
+        else:
+            sign = ""
+
+        if num in nth_suff:
+            num = zero
+
+        myord = num[-2:] in nth_suff
+        if myord:
+            num = num[:-2]
+        finalpoint = False
+        if decimal:
+            if group != 0:
+                chunks = num.split(".")
+            else:
+                chunks = num.split(".", 1)
+            if chunks[-1] == "":  # remove blank string if nothing after decimal
+                chunks = chunks[:-1]
+                finalpoint = True  # add 'point' to end of output
+        else:
+            chunks = [num]
+
+        first: Union[int, str, bool] = 1
+        loopstart = 0
+
+        if chunks[0] == "":
+            first = 0
+            if len(chunks) > 1:
+                loopstart = 1
+
+        for i in range(loopstart, len(chunks)):
+            chunk = chunks[i]
+            # remove all non numeric \D
+            chunk = NON_DIGIT.sub("", chunk)
+            if chunk == "":
+                chunk = "0"
+
+            if group == 0 and (first == 0 or first == ""):
+                chunk = self.enword(chunk, 1)
+            else:
+                chunk = self.enword(chunk, group)
+
+            if chunk[-2:] == ", ":
+                chunk = chunk[:-2]
+            chunk = WHITESPACES_COMMA.sub(",", chunk)
+
+            if group == 0 and first:
+                chunk = COMMA_WORD.sub(f" {andword} \\1", chunk)
+            chunk = WHITESPACES.sub(" ", chunk)
+            # chunk = re.sub(r"(\A\s|\s\Z)", self.blankfn, chunk)
+            chunk = chunk.strip()
+            if first:
+                first = ""
+            chunks[i] = chunk
+
+        numchunks = []
+        if first != 0:
+            numchunks = chunks[0].split(f"{comma} ")
+
+        if myord and numchunks:
+            # TODO: can this be just one re as it is in perl?
+            mo = ordinal_suff.search(numchunks[-1])
+            if mo:
+                numchunks[-1] = ordinal_suff.sub(ordinal[mo.group(1)], numchunks[-1])
+            else:
+                numchunks[-1] += "th"
+
+        for chunk in chunks[1:]:
+            numchunks.append(decimal)
+            numchunks.extend(chunk.split(f"{comma} "))
+
+        if finalpoint:
+            numchunks.append(decimal)
+
+        # wantlist: Perl list context. can explicitly specify in Python
+        if wantlist:
+            if sign:
+                numchunks = [sign] + numchunks
+            return numchunks
+        elif group:
+            signout = f"{sign} " if sign else ""
+            return f"{signout}{', '.join(numchunks)}"
+        else:
+            signout = f"{sign} " if sign else ""
+            num = f"{signout}{numchunks.pop(0)}"
+            if decimal is None:
+                first = True
+            else:
+                first = not num.endswith(decimal)
+            for nc in numchunks:
+                if nc == decimal:
+                    num += f" {nc}"
+                    first = 0
+                elif first:
+                    num += f"{comma} {nc}"
+                else:
+                    num += f" {nc}"
+            return num
+
+    # Join words with commas and a trailing 'and' (when appropriate)...
+
+    @validate_arguments
+    def join(
+        self,
+        words: Optional[Sequence[Word]],
+        sep: Optional[str] = None,
+        sep_spaced: bool = True,
+        final_sep: Optional[str] = None,
+        conj: str = "and",
+        conj_spaced: bool = True,
+    ) -> str:
+        """
+        Join words into a list.
+
+        e.g. join(['ant', 'bee', 'fly']) returns 'ant, bee, and fly'
+
+        options:
+        conj: replacement for 'and'
+        sep: separator. default ',', unless ',' is in the list then ';'
+        final_sep: final separator. default ',', unless ',' is in the list then ';'
+        conj_spaced: boolean. Should conj have spaces around it
+
+        """
+        if not words:
+            return ""
+        if len(words) == 1:
+            return words[0]
+
+        if conj_spaced:
+            if conj == "":
+                conj = " "
+            else:
+                conj = f" {conj} "
+
+        if len(words) == 2:
+            return f"{words[0]}{conj}{words[1]}"
+
+        if sep is None:
+            if "," in "".join(words):
+                sep = ";"
+            else:
+                sep = ","
+        if final_sep is None:
+            final_sep = sep
+
+        final_sep = f"{final_sep}{conj}"
+
+        if sep_spaced:
+            sep += " "
+
+        return f"{sep.join(words[0:-1])}{final_sep}{words[-1]}"
diff --git a/lib/inflect/py.typed b/lib/inflect/py.typed
new file mode 100644
index 00000000..e69de29b
diff --git a/lib/jaraco/classes/properties.py b/lib/jaraco/classes/properties.py
index 4fda4cb6..62f9e200 100644
--- a/lib/jaraco/classes/properties.py
+++ b/lib/jaraco/classes/properties.py
@@ -143,7 +143,7 @@ class classproperty:
             return super().__setattr__(key, value)
 
     def __init__(self, fget, fset=None):
-        self.fget = self._fix_function(fget)
+        self.fget = self._ensure_method(fget)
         self.fset = fset
         fset and self.setter(fset)
 
@@ -158,14 +158,13 @@ class classproperty:
         return self.fset.__get__(None, owner)(value)
 
     def setter(self, fset):
-        self.fset = self._fix_function(fset)
+        self.fset = self._ensure_method(fset)
         return self
 
     @classmethod
-    def _fix_function(cls, fn):
+    def _ensure_method(cls, fn):
         """
         Ensure fn is a classmethod or staticmethod.
         """
-        if not isinstance(fn, (classmethod, staticmethod)):
-            return classmethod(fn)
-        return fn
+        needs_method = not isinstance(fn, (classmethod, staticmethod))
+        return classmethod(fn) if needs_method else fn
diff --git a/lib/jaraco/collections.py b/lib/jaraco/collections.py
index 8323db78..db89b122 100644
--- a/lib/jaraco/collections.py
+++ b/lib/jaraco/collections.py
@@ -63,7 +63,7 @@ class Projection(collections.abc.Mapping):
         return len(tuple(iter(self)))
 
 
-class DictFilter(object):
+class DictFilter(collections.abc.Mapping):
     """
     Takes a dict, and simulates a sub-dict based on the keys.
 
@@ -92,15 +92,21 @@ class DictFilter(object):
     ...
     KeyError: 'e'
 
+    >>> 'e' in filtered
+    False
+
+    Pattern is useful for excluding keys with a prefix.
+
+    >>> filtered = DictFilter(sample, include_pattern=r'(?![ace])')
+    >>> dict(filtered)
+    {'b': 2, 'd': 4}
+
     Also note that DictFilter keeps a reference to the original dict, so
     if you modify the original dict, that could modify the filtered dict.
 
     >>> del sample['d']
-    >>> del sample['a']
-    >>> filtered == {'b': 2, 'c': 3}
-    True
-    >>> filtered != {'b': 2, 'c': 3}
-    False
+    >>> dict(filtered)
+    {'b': 2}
     """
 
     def __init__(self, dict, include_keys=[], include_pattern=None):
@@ -120,29 +126,18 @@ class DictFilter(object):
 
     @property
     def include_keys(self):
-        return self.specified_keys.union(self.pattern_keys)
-
-    def keys(self):
-        return self.include_keys.intersection(self.dict.keys())
-
-    def values(self):
-        return map(self.dict.get, self.keys())
+        return self.specified_keys | self.pattern_keys
 
     def __getitem__(self, i):
         if i not in self.include_keys:
             raise KeyError(i)
         return self.dict[i]
 
-    def items(self):
-        keys = self.keys()
-        values = map(self.dict.get, keys)
-        return zip(keys, values)
+    def __iter__(self):
+        return filter(self.include_keys.__contains__, self.dict.keys())
 
-    def __eq__(self, other):
-        return dict(self) == other
-
-    def __ne__(self, other):
-        return dict(self) != other
+    def __len__(self):
+        return len(list(self))
 
 
 def dict_map(function, dictionary):
@@ -167,7 +162,7 @@ class RangeMap(dict):
     the sorted list of keys.
 
     One may supply keyword parameters to be passed to the sort function used
-    to sort keys (i.e. cmp [python 2 only], keys, reverse) as sort_params.
+    to sort keys (i.e. key, reverse) as sort_params.
 
     Let's create a map that maps 1-3 -> 'a', 4-6 -> 'b'
 
@@ -220,6 +215,23 @@ class RangeMap(dict):
 
     >>> r.get(7, 'not found')
     'not found'
+
+    One often wishes to define the ranges by their left-most values,
+    which requires use of sort params and a key_match_comparator.
+
+    >>> r = RangeMap({1: 'a', 4: 'b'},
+    ...     sort_params=dict(reverse=True),
+    ...     key_match_comparator=operator.ge)
+    >>> r[1], r[2], r[3], r[4], r[5], r[6]
+    ('a', 'a', 'a', 'b', 'b', 'b')
+
+    That wasn't nearly as easy as before, so an alternate constructor
+    is provided:
+
+    >>> r = RangeMap.left({1: 'a', 4: 'b', 7: RangeMap.undefined_value})
+    >>> r[1], r[2], r[3], r[4], r[5], r[6]
+    ('a', 'a', 'a', 'b', 'b', 'b')
+
     """
 
     def __init__(self, source, sort_params={}, key_match_comparator=operator.le):
@@ -227,6 +239,12 @@ class RangeMap(dict):
         self.sort_params = sort_params
         self.match = key_match_comparator
 
+    @classmethod
+    def left(cls, source):
+        return cls(
+            source, sort_params=dict(reverse=True), key_match_comparator=operator.ge
+        )
+
     def __getitem__(self, item):
         sorted_keys = sorted(self.keys(), **self.sort_params)
         if isinstance(item, RangeMap.Item):
@@ -261,7 +279,7 @@ class RangeMap(dict):
         return (sorted_keys[RangeMap.first_item], sorted_keys[RangeMap.last_item])
 
     # some special values for the RangeMap
-    undefined_value = type(str('RangeValueUndefined'), (object,), {})()
+    undefined_value = type(str('RangeValueUndefined'), (), {})()
 
     class Item(int):
         "RangeMap Item"
@@ -370,7 +388,7 @@ class FoldedCaseKeyedDict(KeyTransformingDict):
     True
     >>> 'HELLO' in d
     True
-    >>> print(repr(FoldedCaseKeyedDict({'heLlo': 'world'})).replace("u'", "'"))
+    >>> print(repr(FoldedCaseKeyedDict({'heLlo': 'world'})))
     {'heLlo': 'world'}
     >>> d = FoldedCaseKeyedDict({'heLlo': 'world'})
     >>> print(d['hello'])
@@ -433,7 +451,7 @@ class FoldedCaseKeyedDict(KeyTransformingDict):
         return jaraco.text.FoldedCase(key)
 
 
-class DictAdapter(object):
+class DictAdapter:
     """
     Provide a getitem interface for attributes of an object.
 
@@ -452,7 +470,7 @@ class DictAdapter(object):
         return getattr(self.object, name)
 
 
-class ItemsAsAttributes(object):
+class ItemsAsAttributes:
     """
     Mix-in class to enable a mapping object to provide items as
     attributes.
@@ -561,7 +579,7 @@ class IdentityOverrideMap(dict):
         return key
 
 
-class DictStack(list, collections.abc.Mapping):
+class DictStack(list, collections.abc.MutableMapping):
     """
     A stack of dictionaries that behaves as a view on those dictionaries,
     giving preference to the last.
@@ -578,11 +596,12 @@ class DictStack(list, collections.abc.Mapping):
     >>> stack.push(dict(a=3))
     >>> stack['a']
     3
+    >>> stack['a'] = 4
     >>> set(stack.keys()) == set(['a', 'b', 'c'])
     True
-    >>> set(stack.items()) == set([('a', 3), ('b', 2), ('c', 2)])
+    >>> set(stack.items()) == set([('a', 4), ('b', 2), ('c', 2)])
     True
-    >>> dict(**stack) == dict(stack) == dict(a=3, c=2, b=2)
+    >>> dict(**stack) == dict(stack) == dict(a=4, c=2, b=2)
     True
     >>> d = stack.pop()
     >>> stack['a']
@@ -593,6 +612,9 @@ class DictStack(list, collections.abc.Mapping):
     >>> stack.get('b', None)
     >>> 'c' in stack
     True
+    >>> del stack['c']
+    >>> dict(stack)
+    {'a': 1}
     """
 
     def __iter__(self):
@@ -613,6 +635,18 @@ class DictStack(list, collections.abc.Mapping):
     def __len__(self):
         return len(list(iter(self)))
 
+    def __setitem__(self, key, item):
+        last = list.__getitem__(self, -1)
+        return last.__setitem__(key, item)
+
+    def __delitem__(self, key):
+        last = list.__getitem__(self, -1)
+        return last.__delitem__(key)
+
+    # workaround for mypy confusion
+    def pop(self, *args, **kwargs):
+        return list.pop(self, *args, **kwargs)
+
 
 class BijectiveMap(dict):
     """
@@ -855,7 +889,7 @@ class Enumeration(ItemsAsAttributes, BijectiveMap):
         return (self[name] for name in self.names)
 
 
-class Everything(object):
+class Everything:
     """
     A collection "containing" every possible thing.
 
@@ -896,7 +930,7 @@ class InstrumentedDict(collections.UserDict):  # type: ignore  # buggy mypy
         self.data = data
 
 
-class Least(object):
+class Least:
     """
     A value that is always lesser than any other
 
@@ -928,7 +962,7 @@ class Least(object):
     __gt__ = __ge__
 
 
-class Greatest(object):
+class Greatest:
     """
     A value that is always greater than any other
 
diff --git a/lib/jaraco/text/__init__.py b/lib/jaraco/text/__init__.py
index 5f75519a..e51101c2 100644
--- a/lib/jaraco/text/__init__.py
+++ b/lib/jaraco/text/__init__.py
@@ -66,7 +66,7 @@ class FoldedCase(str):
     >>> s in ["Hello World"]
     True
 
-    You may test for set inclusion, but candidate and elements
+    Allows testing for set inclusion, but candidate and elements
     must both be folded.
 
     >>> FoldedCase("Hello World") in {s}
@@ -92,37 +92,40 @@ class FoldedCase(str):
 
     >>> FoldedCase('hello') > FoldedCase('Hello')
     False
+
+    >>> FoldedCase('ß') == FoldedCase('ss')
+    True
     """
 
     def __lt__(self, other):
-        return self.lower() < other.lower()
+        return self.casefold() < other.casefold()
 
     def __gt__(self, other):
-        return self.lower() > other.lower()
+        return self.casefold() > other.casefold()
 
     def __eq__(self, other):
-        return self.lower() == other.lower()
+        return self.casefold() == other.casefold()
 
     def __ne__(self, other):
-        return self.lower() != other.lower()
+        return self.casefold() != other.casefold()
 
     def __hash__(self):
-        return hash(self.lower())
+        return hash(self.casefold())
 
     def __contains__(self, other):
-        return super().lower().__contains__(other.lower())
+        return super().casefold().__contains__(other.casefold())
 
     def in_(self, other):
         "Does self appear in other?"
         return self in FoldedCase(other)
 
-    # cache lower since it's likely to be called frequently.
+    # cache casefold since it's likely to be called frequently.
     @method_cache
-    def lower(self):
-        return super().lower()
+    def casefold(self):
+        return super().casefold()
 
     def index(self, sub):
-        return self.lower().index(sub.lower())
+        return self.casefold().index(sub.casefold())
 
     def split(self, splitter=' ', maxsplit=0):
         pattern = re.compile(re.escape(splitter), re.I)
@@ -277,7 +280,7 @@ class WordSet(tuple):
     >>> WordSet.parse("myABCClass")
     ('my', 'ABC', 'Class')
 
-    The result is a WordSet, so you can get the form you need.
+    The result is a WordSet, providing access to other forms.
 
     >>> WordSet.parse("myABCClass").underscore_separated()
     'my_ABC_Class'
@@ -598,3 +601,22 @@ def join_continuation(lines):
             except StopIteration:
                 return
         yield item
+
+
+def read_newlines(filename, limit=1024):
+    r"""
+    >>> tmp_path = getfixture('tmp_path')
+    >>> filename = tmp_path / 'out.txt'
+    >>> _ = filename.write_text('foo\n', newline='')
+    >>> read_newlines(filename)
+    '\n'
+    >>> _ = filename.write_text('foo\r\n', newline='')
+    >>> read_newlines(filename)
+    '\r\n'
+    >>> _ = filename.write_text('foo\r\nbar\nbing\r', newline='')
+    >>> read_newlines(filename)
+    ('\r', '\n', '\r\n')
+    """
+    with open(filename) as fp:
+        fp.read(limit)
+    return fp.newlines
diff --git a/lib/jaraco/text/layouts.py b/lib/jaraco/text/layouts.py
new file mode 100644
index 00000000..9636f0f7
--- /dev/null
+++ b/lib/jaraco/text/layouts.py
@@ -0,0 +1,25 @@
+qwerty = "-=qwertyuiop[]asdfghjkl;'zxcvbnm,./_+QWERTYUIOP{}ASDFGHJKL:\"ZXCVBNM<>?"
+dvorak = "[]',.pyfgcrl/=aoeuidhtns-;qjkxbmwvz{}\"<>PYFGCRL?+AOEUIDHTNS_:QJKXBMWVZ"
+
+
+to_dvorak = str.maketrans(qwerty, dvorak)
+to_qwerty = str.maketrans(dvorak, qwerty)
+
+
+def translate(input, translation):
+    """
+    >>> translate('dvorak', to_dvorak)
+    'ekrpat'
+    >>> translate('qwerty', to_qwerty)
+    'x,dokt'
+    """
+    return input.translate(translation)
+
+
+def _translate_stream(stream, translation):
+    """
+    >>> import io
+    >>> _translate_stream(io.StringIO('foo'), to_dvorak)
+    urr
+    """
+    print(translate(stream.read(), translation))
diff --git a/lib/jaraco/text/show-newlines.py b/lib/jaraco/text/show-newlines.py
new file mode 100644
index 00000000..2ba32062
--- /dev/null
+++ b/lib/jaraco/text/show-newlines.py
@@ -0,0 +1,33 @@
+import autocommand
+import inflect
+
+from more_itertools import always_iterable
+
+import jaraco.text
+
+
+def report_newlines(filename):
+    r"""
+    Report the newlines in the indicated file.
+
+    >>> tmp_path = getfixture('tmp_path')
+    >>> filename = tmp_path / 'out.txt'
+    >>> _ = filename.write_text('foo\nbar\n', newline='')
+    >>> report_newlines(filename)
+    newline is '\n'
+    >>> filename = tmp_path / 'out.txt'
+    >>> _ = filename.write_text('foo\nbar\r\n', newline='')
+    >>> report_newlines(filename)
+    newlines are ('\n', '\r\n')
+    """
+    newlines = jaraco.text.read_newlines(filename)
+    count = len(tuple(always_iterable(newlines)))
+    engine = inflect.engine()
+    print(
+        engine.plural_noun("newline", count),
+        engine.plural_verb("is", count),
+        repr(newlines),
+    )
+
+
+autocommand.autocommand(__name__)(report_newlines)
diff --git a/lib/jaraco/text/to-dvorak.py b/lib/jaraco/text/to-dvorak.py
new file mode 100644
index 00000000..a6d5da80
--- /dev/null
+++ b/lib/jaraco/text/to-dvorak.py
@@ -0,0 +1,6 @@
+import sys
+
+from . import layouts
+
+
+__name__ == '__main__' and layouts._translate_stream(sys.stdin, layouts.to_dvorak)
diff --git a/lib/jaraco/text/to-qwerty.py b/lib/jaraco/text/to-qwerty.py
new file mode 100644
index 00000000..abe27286
--- /dev/null
+++ b/lib/jaraco/text/to-qwerty.py
@@ -0,0 +1,6 @@
+import sys
+
+from . import layouts
+
+
+__name__ == '__main__' and layouts._translate_stream(sys.stdin, layouts.to_qwerty)
diff --git a/lib/more_itertools/__init__.py b/lib/more_itertools/__init__.py
index ea38bef1..557bfc20 100644
--- a/lib/more_itertools/__init__.py
+++ b/lib/more_itertools/__init__.py
@@ -1,4 +1,6 @@
+"""More routines for operating on iterables, beyond itertools"""
+
 from .more import *  # noqa
 from .recipes import *  # noqa
 
-__version__ = '8.12.0'
+__version__ = '9.0.0'
diff --git a/lib/more_itertools/more.py b/lib/more_itertools/more.py
index 630af973..7f73d6ed 100644
--- a/lib/more_itertools/more.py
+++ b/lib/more_itertools/more.py
@@ -2,9 +2,8 @@ import warnings
 
 from collections import Counter, defaultdict, deque, abc
 from collections.abc import Sequence
-from concurrent.futures import ThreadPoolExecutor
 from functools import partial, reduce, wraps
-from heapq import merge, heapify, heapreplace, heappop
+from heapq import heapify, heapreplace, heappop
 from itertools import (
     chain,
     compress,
@@ -27,12 +26,16 @@ from sys import hexversion, maxsize
 from time import monotonic
 
 from .recipes import (
+    _marker,
+    _zip_equal,
+    UnequalIterablesError,
     consume,
     flatten,
     pairwise,
     powerset,
     take,
     unique_everseen,
+    all_equal,
 )
 
 __all__ = [
@@ -49,9 +52,9 @@ __all__ = [
     'chunked_even',
     'circular_shifts',
     'collapse',
-    'collate',
     'combination_index',
     'consecutive_groups',
+    'constrained_batches',
     'consumer',
     'count_cycle',
     'countable',
@@ -67,6 +70,7 @@ __all__ = [
     'first',
     'groupby_transform',
     'ichunked',
+    'iequals',
     'ilen',
     'interleave',
     'interleave_evenly',
@@ -77,6 +81,7 @@ __all__ = [
     'iterate',
     'last',
     'locate',
+    'longest_common_prefix',
     'lstrip',
     'make_decorator',
     'map_except',
@@ -133,9 +138,6 @@ __all__ = [
 ]
 
 
-_marker = object()
-
-
 def chunked(iterable, n, strict=False):
     """Break *iterable* into lists of length *n*:
 
@@ -410,44 +412,6 @@ class peekable:
         return self._cache[index]
 
 
-def collate(*iterables, **kwargs):
-    """Return a sorted merge of the items from each of several already-sorted
-    *iterables*.
-
-        >>> list(collate('ACDZ', 'AZ', 'JKL'))
-        ['A', 'A', 'C', 'D', 'J', 'K', 'L', 'Z', 'Z']
-
-    Works lazily, keeping only the next value from each iterable in memory. Use
-    :func:`collate` to, for example, perform a n-way mergesort of items that
-    don't fit in memory.
-
-    If a *key* function is specified, the iterables will be sorted according
-    to its result:
-
-        >>> key = lambda s: int(s)  # Sort by numeric value, not by string
-        >>> list(collate(['1', '10'], ['2', '11'], key=key))
-        ['1', '2', '10', '11']
-
-
-    If the *iterables* are sorted in descending order, set *reverse* to
-    ``True``:
-
-        >>> list(collate([5, 3, 1], [4, 2, 0], reverse=True))
-        [5, 4, 3, 2, 1, 0]
-
-    If the elements of the passed-in iterables are out of order, you might get
-    unexpected results.
-
-    On Python 3.5+, this function is an alias for :func:`heapq.merge`.
-
-    """
-    warnings.warn(
-        "collate is no longer part of more_itertools, use heapq.merge",
-        DeprecationWarning,
-    )
-    return merge(*iterables, **kwargs)
-
-
 def consumer(func):
     """Decorator that automatically advances a PEP-342-style "reverse iterator"
     to its first yield point so you don't have to call ``next()`` on it
@@ -873,7 +837,9 @@ def windowed(seq, n, fillvalue=None, step=1):
             yield tuple(window)
 
     size = len(window)
-    if size < n:
+    if size == 0:
+        return
+    elif size < n:
         yield tuple(chain(window, repeat(fillvalue, n - size)))
     elif 0 < i < min(step, n):
         window += (fillvalue,) * i
@@ -1646,45 +1612,6 @@ def stagger(iterable, offsets=(-1, 0, 1), longest=False, fillvalue=None):
     )
 
 
-class UnequalIterablesError(ValueError):
-    def __init__(self, details=None):
-        msg = 'Iterables have different lengths'
-        if details is not None:
-            msg += (': index 0 has length {}; index {} has length {}').format(
-                *details
-            )
-
-        super().__init__(msg)
-
-
-def _zip_equal_generator(iterables):
-    for combo in zip_longest(*iterables, fillvalue=_marker):
-        for val in combo:
-            if val is _marker:
-                raise UnequalIterablesError()
-        yield combo
-
-
-def _zip_equal(*iterables):
-    # Check whether the iterables are all the same size.
-    try:
-        first_size = len(iterables[0])
-        for i, it in enumerate(iterables[1:], 1):
-            size = len(it)
-            if size != first_size:
-                break
-        else:
-            # If we didn't break out, we can use the built-in zip.
-            return zip(*iterables)
-
-        # If we did break out, there was a mismatch.
-        raise UnequalIterablesError(details=(first_size, i, size))
-    # If any one of the iterables didn't have a length, start reading
-    # them until one runs out.
-    except TypeError:
-        return _zip_equal_generator(iterables)
-
-
 def zip_equal(*iterables):
     """``zip`` the input *iterables* together, but raise
     ``UnequalIterablesError`` if they aren't all the same length.
@@ -1826,7 +1753,7 @@ def unzip(iterable):
     of the zipped *iterable*.
 
     The ``i``-th iterable contains the ``i``-th element from each element
-    of the zipped iterable. The first element is used to to determine the
+    of the zipped iterable. The first element is used to determine the
     length of the remaining elements.
 
         >>> iterable = [('a', 1), ('b', 2), ('c', 3), ('d', 4)]
@@ -2376,6 +2303,16 @@ def locate(iterable, pred=bool, window_size=None):
     return compress(count(), starmap(pred, it))
 
 
+def longest_common_prefix(iterables):
+    """Yield elements of the longest common prefix amongst given *iterables*.
+
+    >>> ''.join(longest_common_prefix(['abcd', 'abc', 'abf']))
+    'ab'
+
+    """
+    return (c[0] for c in takewhile(all_equal, zip(*iterables)))
+
+
 def lstrip(iterable, pred):
     """Yield the items from *iterable*, but strip any from the beginning
     for which *pred* returns ``True``.
@@ -2684,7 +2621,7 @@ def difference(iterable, func=sub, *, initial=None):
     if initial is not None:
         first = []
 
-    return chain(first, starmap(func, zip(b, a)))
+    return chain(first, map(func, b, a))
 
 
 class SequenceView(Sequence):
@@ -3327,6 +3264,27 @@ def only(iterable, default=None, too_long=None):
     return first_value
 
 
+class _IChunk:
+    def __init__(self, iterable, n):
+        self._it = islice(iterable, n)
+        self._cache = deque()
+
+    def fill_cache(self):
+        self._cache.extend(self._it)
+
+    def __iter__(self):
+        return self
+
+    def __next__(self):
+        try:
+            return next(self._it)
+        except StopIteration:
+            if self._cache:
+                return self._cache.popleft()
+            else:
+                raise
+
+
 def ichunked(iterable, n):
     """Break *iterable* into sub-iterables with *n* elements each.
     :func:`ichunked` is like :func:`chunked`, but it yields iterables
@@ -3348,20 +3306,39 @@ def ichunked(iterable, n):
     [8, 9, 10, 11]
 
     """
-    source = iter(iterable)
-
+    source = peekable(iter(iterable))
+    ichunk_marker = object()
     while True:
         # Check to see whether we're at the end of the source iterable
-        item = next(source, _marker)
-        if item is _marker:
+        item = source.peek(ichunk_marker)
+        if item is ichunk_marker:
             return
 
-        # Clone the source and yield an n-length slice
-        source, it = tee(chain([item], source))
-        yield islice(it, n)
+        chunk = _IChunk(source, n)
+        yield chunk
 
-        # Advance the source iterable
-        consume(source, n)
+        # Advance the source iterable and fill previous chunk's cache
+        chunk.fill_cache()
+
+
+def iequals(*iterables):
+    """Return ``True`` if all given *iterables* are equal to each other,
+    which means that they contain the same elements in the same order.
+
+    The function is useful for comparing iterables of different data types
+    or iterables that do not support equality checks.
+
+    >>> iequals("abc", ['a', 'b', 'c'], ('a', 'b', 'c'), iter("abc"))
+    True
+
+    >>> iequals("abc", "acb")
+    False
+
+    Not to be confused with :func:`all_equals`, which checks whether all
+    elements of iterable are equal to each other.
+
+    """
+    return all(map(all_equal, zip_longest(*iterables, fillvalue=object())))
 
 
 def distinct_combinations(iterable, r):
@@ -3656,7 +3633,10 @@ class callback_iter:
         self._aborted = False
         self._future = None
         self._wait_seconds = wait_seconds
-        self._executor = ThreadPoolExecutor(max_workers=1)
+        # Lazily import concurrent.future
+        self._executor = __import__(
+            'concurrent.futures'
+        ).futures.ThreadPoolExecutor(max_workers=1)
         self._iterator = self._reader()
 
     def __enter__(self):
@@ -3961,7 +3941,7 @@ def combination_index(element, iterable):
 
     n, _ = last(pool, default=(n, None))
 
-    # Python versiosn below 3.8 don't have math.comb
+    # Python versions below 3.8 don't have math.comb
     index = 1
     for i, j in enumerate(reversed(indexes), start=1):
         j = n - j
@@ -4114,7 +4094,7 @@ def zip_broadcast(*objects, scalar_types=(str, bytes), strict=False):
 
     If the *strict* keyword argument is ``True``, then
     ``UnequalIterablesError`` will be raised if any of the iterables have
-    different lengthss.
+    different lengths.
     """
 
     def is_scalar(obj):
@@ -4315,3 +4295,53 @@ def minmax(iterable_or_value, *others, key=None, default=_marker):
                 hi, hi_key = y, y_key
 
     return lo, hi
+
+
+def constrained_batches(
+    iterable, max_size, max_count=None, get_len=len, strict=True
+):
+    """Yield batches of items from *iterable* with a combined size limited by
+    *max_size*.
+
+    >>> iterable = [b'12345', b'123', b'12345678', b'1', b'1', b'12', b'1']
+    >>> list(constrained_batches(iterable, 10))
+    [(b'12345', b'123'), (b'12345678', b'1', b'1'), (b'12', b'1')]
+
+    If a *max_count* is supplied, the number of items per batch is also
+    limited:
+
+    >>> iterable = [b'12345', b'123', b'12345678', b'1', b'1', b'12', b'1']
+    >>> list(constrained_batches(iterable, 10, max_count = 2))
+    [(b'12345', b'123'), (b'12345678', b'1'), (b'1', b'12'), (b'1',)]
+
+    If a *get_len* function is supplied, use that instead of :func:`len` to
+    determine item size.
+
+    If *strict* is ``True``, raise ``ValueError`` if any single item is bigger
+    than *max_size*. Otherwise, allow single items to exceed *max_size*.
+    """
+    if max_size <= 0:
+        raise ValueError('maximum size must be greater than zero')
+
+    batch = []
+    batch_size = 0
+    batch_count = 0
+    for item in iterable:
+        item_len = get_len(item)
+        if strict and item_len > max_size:
+            raise ValueError('item size exceeds maximum size')
+
+        reached_count = batch_count == max_count
+        reached_size = item_len + batch_size > max_size
+        if batch_count and (reached_size or reached_count):
+            yield tuple(batch)
+            batch.clear()
+            batch_size = 0
+            batch_count = 0
+
+        batch.append(item)
+        batch_size += item_len
+        batch_count += 1
+
+    if batch:
+        yield tuple(batch)
diff --git a/lib/more_itertools/more.pyi b/lib/more_itertools/more.pyi
index fe7d4bdd..1413fae7 100644
--- a/lib/more_itertools/more.pyi
+++ b/lib/more_itertools/more.pyi
@@ -72,7 +72,6 @@ class peekable(Generic[_T], Iterator[_T]):
     @overload
     def __getitem__(self, index: slice) -> List[_T]: ...
 
-def collate(*iterables: Iterable[_T], **kwargs: Any) -> Iterable[_T]: ...
 def consumer(func: _GenFn) -> _GenFn: ...
 def ilen(iterable: Iterable[object]) -> int: ...
 def iterate(func: Callable[[_T], _T], start: _T) -> Iterator[_T]: ...
@@ -179,7 +178,7 @@ def padded(
     iterable: Iterable[_T],
     *,
     n: Optional[int] = ...,
-    next_multiple: bool = ...
+    next_multiple: bool = ...,
 ) -> Iterator[Optional[_T]]: ...
 @overload
 def padded(
@@ -225,7 +224,7 @@ def zip_equal(
     __iter1: Iterable[_T],
     __iter2: Iterable[_T],
     __iter3: Iterable[_T],
-    *iterables: Iterable[_T]
+    *iterables: Iterable[_T],
 ) -> Iterator[Tuple[_T, ...]]: ...
 @overload
 def zip_offset(
@@ -233,7 +232,7 @@ def zip_offset(
     *,
     offsets: _SizedIterable[int],
     longest: bool = ...,
-    fillvalue: None = None
+    fillvalue: None = None,
 ) -> Iterator[Tuple[Optional[_T1]]]: ...
 @overload
 def zip_offset(
@@ -242,7 +241,7 @@ def zip_offset(
     *,
     offsets: _SizedIterable[int],
     longest: bool = ...,
-    fillvalue: None = None
+    fillvalue: None = None,
 ) -> Iterator[Tuple[Optional[_T1], Optional[_T2]]]: ...
 @overload
 def zip_offset(
@@ -252,7 +251,7 @@ def zip_offset(
     *iterables: Iterable[_T],
     offsets: _SizedIterable[int],
     longest: bool = ...,
-    fillvalue: None = None
+    fillvalue: None = None,
 ) -> Iterator[Tuple[Optional[_T], ...]]: ...
 @overload
 def zip_offset(
@@ -420,7 +419,7 @@ def difference(
     iterable: Iterable[_T],
     func: Callable[[_T, _T], _U] = ...,
     *,
-    initial: None = ...
+    initial: None = ...,
 ) -> Iterator[Union[_T, _U]]: ...
 @overload
 def difference(
@@ -529,12 +528,12 @@ def distinct_combinations(
 def filter_except(
     validator: Callable[[Any], object],
     iterable: Iterable[_T],
-    *exceptions: Type[BaseException]
+    *exceptions: Type[BaseException],
 ) -> Iterator[_T]: ...
 def map_except(
     function: Callable[[Any], _U],
     iterable: Iterable[_T],
-    *exceptions: Type[BaseException]
+    *exceptions: Type[BaseException],
 ) -> Iterator[_U]: ...
 def map_if(
     iterable: Iterable[Any],
@@ -610,7 +609,7 @@ def zip_broadcast(
     scalar_types: Union[
         type, Tuple[Union[type, Tuple[Any, ...]], ...], None
     ] = ...,
-    strict: bool = ...
+    strict: bool = ...,
 ) -> Iterable[Tuple[_T, ...]]: ...
 def unique_in_window(
     iterable: Iterable[_T], n: int, key: Optional[Callable[[_T], _U]] = ...
@@ -640,7 +639,7 @@ def minmax(
     iterable_or_value: Iterable[_SupportsLessThanT],
     *,
     key: None = None,
-    default: _U
+    default: _U,
 ) -> Union[_U, Tuple[_SupportsLessThanT, _SupportsLessThanT]]: ...
 @overload
 def minmax(
@@ -653,12 +652,23 @@ def minmax(
 def minmax(
     iterable_or_value: _SupportsLessThanT,
     __other: _SupportsLessThanT,
-    *others: _SupportsLessThanT
+    *others: _SupportsLessThanT,
 ) -> Tuple[_SupportsLessThanT, _SupportsLessThanT]: ...
 @overload
 def minmax(
     iterable_or_value: _T,
     __other: _T,
     *others: _T,
-    key: Callable[[_T], _SupportsLessThan]
+    key: Callable[[_T], _SupportsLessThan],
 ) -> Tuple[_T, _T]: ...
+def longest_common_prefix(
+    iterables: Iterable[Iterable[_T]],
+) -> Iterator[_T]: ...
+def iequals(*iterables: Iterable[object]) -> bool: ...
+def constrained_batches(
+    iterable: Iterable[object],
+    max_size: int,
+    max_count: Optional[int] = ...,
+    get_len: Callable[[_T], object] = ...,
+    strict: bool = ...,
+) -> Iterator[Tuple[_T]]: ...
diff --git a/lib/more_itertools/recipes.py b/lib/more_itertools/recipes.py
index a2596423..85796207 100644
--- a/lib/more_itertools/recipes.py
+++ b/lib/more_itertools/recipes.py
@@ -7,11 +7,16 @@ Some backward-compatible usability improvements have been made.
 .. [1] http://docs.python.org/library/itertools.html#recipes
 
 """
-import warnings
+import math
+import operator
+
 from collections import deque
+from collections.abc import Sized
+from functools import reduce
 from itertools import (
     chain,
     combinations,
+    compress,
     count,
     cycle,
     groupby,
@@ -21,11 +26,11 @@ from itertools import (
     tee,
     zip_longest,
 )
-import operator
 from random import randrange, sample, choice
 
 __all__ = [
     'all_equal',
+    'batched',
     'before_and_after',
     'consume',
     'convolve',
@@ -41,6 +46,7 @@ __all__ = [
     'pad_none',
     'pairwise',
     'partition',
+    'polynomial_from_roots',
     'powerset',
     'prepend',
     'quantify',
@@ -50,7 +56,9 @@ __all__ = [
     'random_product',
     'repeatfunc',
     'roundrobin',
+    'sieve',
     'sliding_window',
+    'subslices',
     'tabulate',
     'tail',
     'take',
@@ -59,6 +67,8 @@ __all__ = [
     'unique_justseen',
 ]
 
+_marker = object()
+
 
 def take(n, iterable):
     """Return first *n* items of the iterable as a list.
@@ -102,7 +112,14 @@ def tail(n, iterable):
     ['E', 'F', 'G']
 
     """
-    return iter(deque(iterable, maxlen=n))
+    # If the given iterable has a length, then we can use islice to get its
+    # final elements. Note that if the iterable is not actually Iterable,
+    # either islice or deque will throw a TypeError. This is why we don't
+    # check if it is Iterable.
+    if isinstance(iterable, Sized):
+        yield from islice(iterable, max(0, len(iterable) - n), None)
+    else:
+        yield from iter(deque(iterable, maxlen=n))
 
 
 def consume(iterator, n=None):
@@ -284,20 +301,83 @@ else:
     pairwise.__doc__ = _pairwise.__doc__
 
 
-def grouper(iterable, n, fillvalue=None):
-    """Collect data into fixed-length chunks or blocks.
+class UnequalIterablesError(ValueError):
+    def __init__(self, details=None):
+        msg = 'Iterables have different lengths'
+        if details is not None:
+            msg += (': index 0 has length {}; index {} has length {}').format(
+                *details
+            )
 
-    >>> list(grouper('ABCDEFG', 3, 'x'))
+        super().__init__(msg)
+
+
+def _zip_equal_generator(iterables):
+    for combo in zip_longest(*iterables, fillvalue=_marker):
+        for val in combo:
+            if val is _marker:
+                raise UnequalIterablesError()
+        yield combo
+
+
+def _zip_equal(*iterables):
+    # Check whether the iterables are all the same size.
+    try:
+        first_size = len(iterables[0])
+        for i, it in enumerate(iterables[1:], 1):
+            size = len(it)
+            if size != first_size:
+                break
+        else:
+            # If we didn't break out, we can use the built-in zip.
+            return zip(*iterables)
+
+        # If we did break out, there was a mismatch.
+        raise UnequalIterablesError(details=(first_size, i, size))
+    # If any one of the iterables didn't have a length, start reading
+    # them until one runs out.
+    except TypeError:
+        return _zip_equal_generator(iterables)
+
+
+def grouper(iterable, n, incomplete='fill', fillvalue=None):
+    """Group elements from *iterable* into fixed-length groups of length *n*.
+
+    >>> list(grouper('ABCDEF', 3))
+    [('A', 'B', 'C'), ('D', 'E', 'F')]
+
+    The keyword arguments *incomplete* and *fillvalue* control what happens for
+    iterables whose length is not a multiple of *n*.
+
+    When *incomplete* is `'fill'`, the last group will contain instances of
+    *fillvalue*.
+
+    >>> list(grouper('ABCDEFG', 3, incomplete='fill', fillvalue='x'))
     [('A', 'B', 'C'), ('D', 'E', 'F'), ('G', 'x', 'x')]
 
+    When *incomplete* is `'ignore'`, the last group will not be emitted.
+
+    >>> list(grouper('ABCDEFG', 3, incomplete='ignore', fillvalue='x'))
+    [('A', 'B', 'C'), ('D', 'E', 'F')]
+
+    When *incomplete* is `'strict'`, a subclass of `ValueError` will be raised.
+
+    >>> it = grouper('ABCDEFG', 3, incomplete='strict')
+    >>> list(it)  # doctest: +IGNORE_EXCEPTION_DETAIL
+    Traceback (most recent call last):
+    ...
+    UnequalIterablesError
+
     """
-    if isinstance(iterable, int):
-        warnings.warn(
-            "grouper expects iterable as first parameter", DeprecationWarning
-        )
-        n, iterable = iterable, n
     args = [iter(iterable)] * n
-    return zip_longest(fillvalue=fillvalue, *args)
+    if incomplete == 'fill':
+        return zip_longest(*args, fillvalue=fillvalue)
+    if incomplete == 'strict':
+        return _zip_equal(*args)
+    if incomplete == 'ignore':
+        return zip(*args)
+    else:
+        raise ValueError('Expected fill, strict, or ignore')
 
 
 def roundrobin(*iterables):
@@ -658,11 +738,12 @@ def before_and_after(predicate, it):
                 transition.append(elem)
                 return
 
-    def remainder_iterator():
-        yield from transition
-        yield from it
+    # Note: this is different from itertools recipes to allow nesting
+    # before_and_after remainders into before_and_after again. See tests
+    # for an example.
+    remainder_iterator = chain(transition, it)
 
-    return true_iterator(), remainder_iterator()
+    return true_iterator(), remainder_iterator
 
 
 def triplewise(iterable):
@@ -696,3 +777,65 @@ def sliding_window(iterable, n):
     for x in it:
         window.append(x)
         yield tuple(window)
+
+
+def subslices(iterable):
+    """Return all contiguous non-empty subslices of *iterable*.
+
+        >>> list(subslices('ABC'))
+        [['A'], ['A', 'B'], ['A', 'B', 'C'], ['B'], ['B', 'C'], ['C']]
+
+    This is similar to :func:`substrings`, but emits items in a different
+    order.
+    """
+    seq = list(iterable)
+    slices = starmap(slice, combinations(range(len(seq) + 1), 2))
+    return map(operator.getitem, repeat(seq), slices)
+
+
+def polynomial_from_roots(roots):
+    """Compute a polynomial's coefficients from its roots.
+
+    >>> roots = [5, -4, 3]  # (x - 5) * (x + 4) * (x - 3)
+    >>> polynomial_from_roots(roots)  # x^3 - 4 * x^2 - 17 * x + 60
+    [1, -4, -17, 60]
+    """
+    # Use math.prod for Python 3.8+,
+    prod = getattr(math, 'prod', lambda x: reduce(operator.mul, x, 1))
+    roots = list(map(operator.neg, roots))
+    return [
+        sum(map(prod, combinations(roots, k))) for k in range(len(roots) + 1)
+    ]
+
+
+def sieve(n):
+    """Yield the primes less than n.
+
+    >>> list(sieve(30))
+    [2, 3, 5, 7, 11, 13, 17, 19, 23, 29]
+    """
+    isqrt = getattr(math, 'isqrt', lambda x: int(math.sqrt(x)))
+    limit = isqrt(n) + 1
+    data = bytearray([1]) * n
+    data[:2] = 0, 0
+    for p in compress(range(limit), data):
+        data[p + p : n : p] = bytearray(len(range(p + p, n, p)))
+
+    return compress(count(), data)
+
+
+def batched(iterable, n):
+    """Batch data into lists of length *n*. The last batch may be shorter.
+
+    >>> list(batched('ABCDEFG', 3))
+    [['A', 'B', 'C'], ['D', 'E', 'F'], ['G']]
+
+    This recipe is from the ``itertools`` docs. This library also provides
+    :func:`chunked`, which has a different implementation.
+    """
+    it = iter(iterable)
+    while True:
+        batch = list(islice(it, n))
+        if not batch:
+            break
+        yield batch
diff --git a/lib/more_itertools/recipes.pyi b/lib/more_itertools/recipes.pyi
index 4648a41b..29415c5a 100644
--- a/lib/more_itertools/recipes.pyi
+++ b/lib/more_itertools/recipes.pyi
@@ -6,6 +6,7 @@ from typing import (
     Iterator,
     List,
     Optional,
+    Sequence,
     Tuple,
     TypeVar,
     Union,
@@ -39,21 +40,11 @@ def repeatfunc(
     func: Callable[..., _U], times: Optional[int] = ..., *args: Any
 ) -> Iterator[_U]: ...
 def pairwise(iterable: Iterable[_T]) -> Iterator[Tuple[_T, _T]]: ...
-@overload
 def grouper(
-    iterable: Iterable[_T], n: int
-) -> Iterator[Tuple[Optional[_T], ...]]: ...
-@overload
-def grouper(
-    iterable: Iterable[_T], n: int, fillvalue: _U
-) -> Iterator[Tuple[Union[_T, _U], ...]]: ...
-@overload
-def grouper(  # Deprecated interface
-    iterable: int, n: Iterable[_T]
-) -> Iterator[Tuple[Optional[_T], ...]]: ...
-@overload
-def grouper(  # Deprecated interface
-    iterable: int, n: Iterable[_T], fillvalue: _U
+    iterable: Iterable[_T],
+    n: int,
+    incomplete: str = ...,
+    fillvalue: _U = ...,
 ) -> Iterator[Tuple[Union[_T, _U], ...]]: ...
 def roundrobin(*iterables: Iterable[_T]) -> Iterator[_T]: ...
 def partition(
@@ -110,3 +101,10 @@ def triplewise(iterable: Iterable[_T]) -> Iterator[Tuple[_T, _T, _T]]: ...
 def sliding_window(
     iterable: Iterable[_T], n: int
 ) -> Iterator[Tuple[_T, ...]]: ...
+def subslices(iterable: Iterable[_T]) -> Iterator[List[_T]]: ...
+def polynomial_from_roots(roots: Sequence[int]) -> List[int]: ...
+def sieve(n: int) -> Iterator[int]: ...
+def batched(
+    iterable: Iterable[_T],
+    n: int,
+) -> Iterator[List[_T]]: ...
diff --git a/lib/pydantic/__init__.py b/lib/pydantic/__init__.py
new file mode 100644
index 00000000..3bf1418f
--- /dev/null
+++ b/lib/pydantic/__init__.py
@@ -0,0 +1,131 @@
+# flake8: noqa
+from . import dataclasses
+from .annotated_types import create_model_from_namedtuple, create_model_from_typeddict
+from .class_validators import root_validator, validator
+from .config import BaseConfig, ConfigDict, Extra
+from .decorator import validate_arguments
+from .env_settings import BaseSettings
+from .error_wrappers import ValidationError
+from .errors import *
+from .fields import Field, PrivateAttr, Required
+from .main import *
+from .networks import *
+from .parse import Protocol
+from .tools import *
+from .types import *
+from .version import VERSION, compiled
+
+__version__ = VERSION
+
+# WARNING __all__ from .errors is not included here, it will be removed as an export here in v2
+# please use "from pydantic.errors import ..." instead
+__all__ = [
+    # annotated types utils
+    'create_model_from_namedtuple',
+    'create_model_from_typeddict',
+    # dataclasses
+    'dataclasses',
+    # class_validators
+    'root_validator',
+    'validator',
+    # config
+    'BaseConfig',
+    'ConfigDict',
+    'Extra',
+    # decorator
+    'validate_arguments',
+    # env_settings
+    'BaseSettings',
+    # error_wrappers
+    'ValidationError',
+    # fields
+    'Field',
+    'Required',
+    # main
+    'BaseModel',
+    'create_model',
+    'validate_model',
+    # network
+    'AnyUrl',
+    'AnyHttpUrl',
+    'FileUrl',
+    'HttpUrl',
+    'stricturl',
+    'EmailStr',
+    'NameEmail',
+    'IPvAnyAddress',
+    'IPvAnyInterface',
+    'IPvAnyNetwork',
+    'PostgresDsn',
+    'CockroachDsn',
+    'AmqpDsn',
+    'RedisDsn',
+    'MongoDsn',
+    'KafkaDsn',
+    'validate_email',
+    # parse
+    'Protocol',
+    # tools
+    'parse_file_as',
+    'parse_obj_as',
+    'parse_raw_as',
+    'schema_of',
+    'schema_json_of',
+    # types
+    'NoneStr',
+    'NoneBytes',
+    'StrBytes',
+    'NoneStrBytes',
+    'StrictStr',
+    'ConstrainedBytes',
+    'conbytes',
+    'ConstrainedList',
+    'conlist',
+    'ConstrainedSet',
+    'conset',
+    'ConstrainedFrozenSet',
+    'confrozenset',
+    'ConstrainedStr',
+    'constr',
+    'PyObject',
+    'ConstrainedInt',
+    'conint',
+    'PositiveInt',
+    'NegativeInt',
+    'NonNegativeInt',
+    'NonPositiveInt',
+    'ConstrainedFloat',
+    'confloat',
+    'PositiveFloat',
+    'NegativeFloat',
+    'NonNegativeFloat',
+    'NonPositiveFloat',
+    'FiniteFloat',
+    'ConstrainedDecimal',
+    'condecimal',
+    'ConstrainedDate',
+    'condate',
+    'UUID1',
+    'UUID3',
+    'UUID4',
+    'UUID5',
+    'FilePath',
+    'DirectoryPath',
+    'Json',
+    'JsonWrapper',
+    'SecretField',
+    'SecretStr',
+    'SecretBytes',
+    'StrictBool',
+    'StrictBytes',
+    'StrictInt',
+    'StrictFloat',
+    'PaymentCardNumber',
+    'PrivateAttr',
+    'ByteSize',
+    'PastDate',
+    'FutureDate',
+    # version
+    'compiled',
+    'VERSION',
+]
diff --git a/lib/pydantic/_hypothesis_plugin.py b/lib/pydantic/_hypothesis_plugin.py
new file mode 100644
index 00000000..a56d2b98
--- /dev/null
+++ b/lib/pydantic/_hypothesis_plugin.py
@@ -0,0 +1,386 @@
+"""
+Register Hypothesis strategies for Pydantic custom types.
+
+This enables fully-automatic generation of test data for most Pydantic classes.
+
+Note that this module has *no* runtime impact on Pydantic itself; instead it
+is registered as a setuptools entry point and Hypothesis will import it if
+Pydantic is installed.  See also:
+
+https://hypothesis.readthedocs.io/en/latest/strategies.html#registering-strategies-via-setuptools-entry-points
+https://hypothesis.readthedocs.io/en/latest/data.html#hypothesis.strategies.register_type_strategy
+https://hypothesis.readthedocs.io/en/latest/strategies.html#interaction-with-pytest-cov
+https://pydantic-docs.helpmanual.io/usage/types/#pydantic-types
+
+Note that because our motivation is to *improve user experience*, the strategies
+are always sound (never generate invalid data) but sacrifice completeness for
+maintainability (ie may be unable to generate some tricky but valid data).
+
+Finally, this module makes liberal use of `# type: ignore[<code>]` pragmas.
+This is because Hypothesis annotates `register_type_strategy()` with
+`(T, SearchStrategy[T])`, but in most cases we register e.g. `ConstrainedInt`
+to generate instances of the builtin `int` type which match the constraints.
+"""
+
+import contextlib
+import datetime
+import ipaddress
+import json
+import math
+from fractions import Fraction
+from typing import Callable, Dict, Type, Union, cast, overload
+
+import hypothesis.strategies as st
+
+import pydantic
+import pydantic.color
+import pydantic.types
+from pydantic.utils import lenient_issubclass
+
+# FilePath and DirectoryPath are explicitly unsupported, as we'd have to create
+# them on-disk, and that's unsafe in general without being told *where* to do so.
+#
+# URLs are unsupported because it's easy for users to define their own strategy for
+# "normal" URLs, and hard for us to define a general strategy which includes "weird"
+# URLs but doesn't also have unpredictable performance problems.
+#
+# conlist() and conset() are unsupported for now, because the workarounds for
+# Cython and Hypothesis to handle parametrized generic types are incompatible.
+# Once Cython can support 'normal' generics we'll revisit this.
+
+# Emails
+try:
+    import email_validator
+except ImportError:  # pragma: no cover
+    pass
+else:
+
+    def is_valid_email(s: str) -> bool:
+        # Hypothesis' st.emails() occasionally generates emails like 0@A0--0.ac
+        # that are invalid according to email-validator, so we filter those out.
+        try:
+            email_validator.validate_email(s, check_deliverability=False)
+            return True
+        except email_validator.EmailNotValidError:  # pragma: no cover
+            return False
+
+    # Note that these strategies deliberately stay away from any tricky Unicode
+    # or other encoding issues; we're just trying to generate *something* valid.
+    st.register_type_strategy(pydantic.EmailStr, st.emails().filter(is_valid_email))  # type: ignore[arg-type]
+    st.register_type_strategy(
+        pydantic.NameEmail,
+        st.builds(
+            '{} <{}>'.format,  # type: ignore[arg-type]
+            st.from_regex('[A-Za-z0-9_]+( [A-Za-z0-9_]+){0,5}', fullmatch=True),
+            st.emails().filter(is_valid_email),
+        ),
+    )
+
+# PyObject - dotted names, in this case taken from the math module.
+st.register_type_strategy(
+    pydantic.PyObject,  # type: ignore[arg-type]
+    st.sampled_from(
+        [cast(pydantic.PyObject, f'math.{name}') for name in sorted(vars(math)) if not name.startswith('_')]
+    ),
+)
+
+# CSS3 Colors; as name, hex, rgb(a) tuples or strings, or hsl strings
+_color_regexes = (
+    '|'.join(
+        (
+            pydantic.color.r_hex_short,
+            pydantic.color.r_hex_long,
+            pydantic.color.r_rgb,
+            pydantic.color.r_rgba,
+            pydantic.color.r_hsl,
+            pydantic.color.r_hsla,
+        )
+    )
+    # Use more precise regex patterns to avoid value-out-of-range errors
+    .replace(pydantic.color._r_sl, r'(?:(\d\d?(?:\.\d+)?|100(?:\.0+)?)%)')
+    .replace(pydantic.color._r_alpha, r'(?:(0(?:\.\d+)?|1(?:\.0+)?|\.\d+|\d{1,2}%))')
+    .replace(pydantic.color._r_255, r'(?:((?:\d|\d\d|[01]\d\d|2[0-4]\d|25[0-4])(?:\.\d+)?|255(?:\.0+)?))')
+)
+st.register_type_strategy(
+    pydantic.color.Color,
+    st.one_of(
+        st.sampled_from(sorted(pydantic.color.COLORS_BY_NAME)),
+        st.tuples(
+            st.integers(0, 255),
+            st.integers(0, 255),
+            st.integers(0, 255),
+            st.none() | st.floats(0, 1) | st.floats(0, 100).map('{}%'.format),
+        ),
+        st.from_regex(_color_regexes, fullmatch=True),
+    ),
+)
+
+
+# Card numbers, valid according to the Luhn algorithm
+
+
+def add_luhn_digit(card_number: str) -> str:
+    # See https://en.wikipedia.org/wiki/Luhn_algorithm
+    for digit in '0123456789':
+        with contextlib.suppress(Exception):
+            pydantic.PaymentCardNumber.validate_luhn_check_digit(card_number + digit)
+            return card_number + digit
+    raise AssertionError('Unreachable')  # pragma: no cover
+
+
+card_patterns = (
+    # Note that these patterns omit the Luhn check digit; that's added by the function above
+    '4[0-9]{14}',  # Visa
+    '5[12345][0-9]{13}',  # Mastercard
+    '3[47][0-9]{12}',  # American Express
+    '[0-26-9][0-9]{10,17}',  # other (incomplete to avoid overlap)
+)
+st.register_type_strategy(
+    pydantic.PaymentCardNumber,
+    st.from_regex('|'.join(card_patterns), fullmatch=True).map(add_luhn_digit),  # type: ignore[arg-type]
+)
+
+# UUIDs
+st.register_type_strategy(pydantic.UUID1, st.uuids(version=1))
+st.register_type_strategy(pydantic.UUID3, st.uuids(version=3))
+st.register_type_strategy(pydantic.UUID4, st.uuids(version=4))
+st.register_type_strategy(pydantic.UUID5, st.uuids(version=5))
+
+# Secrets
+st.register_type_strategy(pydantic.SecretBytes, st.binary().map(pydantic.SecretBytes))
+st.register_type_strategy(pydantic.SecretStr, st.text().map(pydantic.SecretStr))
+
+# IP addresses, networks, and interfaces
+st.register_type_strategy(pydantic.IPvAnyAddress, st.ip_addresses())  # type: ignore[arg-type]
+st.register_type_strategy(
+    pydantic.IPvAnyInterface,
+    st.from_type(ipaddress.IPv4Interface) | st.from_type(ipaddress.IPv6Interface),  # type: ignore[arg-type]
+)
+st.register_type_strategy(
+    pydantic.IPvAnyNetwork,
+    st.from_type(ipaddress.IPv4Network) | st.from_type(ipaddress.IPv6Network),  # type: ignore[arg-type]
+)
+
+# We hook into the con***() functions and the ConstrainedNumberMeta metaclass,
+# so here we only have to register subclasses for other constrained types which
+# don't go via those mechanisms.  Then there are the registration hooks below.
+st.register_type_strategy(pydantic.StrictBool, st.booleans())
+st.register_type_strategy(pydantic.StrictStr, st.text())
+
+
+# Constrained-type resolver functions
+#
+# For these ones, we actually want to inspect the type in order to work out a
+# satisfying strategy.  First up, the machinery for tracking resolver functions:
+
+RESOLVERS: Dict[type, Callable[[type], st.SearchStrategy]] = {}  # type: ignore[type-arg]
+
+
+@overload
+def _registered(typ: Type[pydantic.types.T]) -> Type[pydantic.types.T]:
+    pass
+
+
+@overload
+def _registered(typ: pydantic.types.ConstrainedNumberMeta) -> pydantic.types.ConstrainedNumberMeta:
+    pass
+
+
+def _registered(
+    typ: Union[Type[pydantic.types.T], pydantic.types.ConstrainedNumberMeta]
+) -> Union[Type[pydantic.types.T], pydantic.types.ConstrainedNumberMeta]:
+    # This function replaces the version in `pydantic.types`, in order to
+    # effect the registration of new constrained types so that Hypothesis
+    # can generate valid examples.
+    pydantic.types._DEFINED_TYPES.add(typ)
+    for supertype, resolver in RESOLVERS.items():
+        if issubclass(typ, supertype):
+            st.register_type_strategy(typ, resolver(typ))  # type: ignore
+            return typ
+    raise NotImplementedError(f'Unknown type {typ!r} has no resolver to register')  # pragma: no cover
+
+
+def resolves(
+    typ: Union[type, pydantic.types.ConstrainedNumberMeta]
+) -> Callable[[Callable[..., st.SearchStrategy]], Callable[..., st.SearchStrategy]]:  # type: ignore[type-arg]
+    def inner(f):  # type: ignore
+        assert f not in RESOLVERS
+        RESOLVERS[typ] = f
+        return f
+
+    return inner
+
+
+# Type-to-strategy resolver functions
+
+
+@resolves(pydantic.JsonWrapper)
+def resolve_json(cls):  # type: ignore[no-untyped-def]
+    try:
+        inner = st.none() if cls.inner_type is None else st.from_type(cls.inner_type)
+    except Exception:  # pragma: no cover
+        finite = st.floats(allow_infinity=False, allow_nan=False)
+        inner = st.recursive(
+            base=st.one_of(st.none(), st.booleans(), st.integers(), finite, st.text()),
+            extend=lambda x: st.lists(x) | st.dictionaries(st.text(), x),  # type: ignore
+        )
+    inner_type = getattr(cls, 'inner_type', None)
+    return st.builds(
+        cls.inner_type.json if lenient_issubclass(inner_type, pydantic.BaseModel) else json.dumps,
+        inner,
+        ensure_ascii=st.booleans(),
+        indent=st.none() | st.integers(0, 16),
+        sort_keys=st.booleans(),
+    )
+
+
+@resolves(pydantic.ConstrainedBytes)
+def resolve_conbytes(cls):  # type: ignore[no-untyped-def]  # pragma: no cover
+    min_size = cls.min_length or 0
+    max_size = cls.max_length
+    if not cls.strip_whitespace:
+        return st.binary(min_size=min_size, max_size=max_size)
+    # Fun with regex to ensure we neither start nor end with whitespace
+    repeats = '{{{},{}}}'.format(
+        min_size - 2 if min_size > 2 else 0,
+        max_size - 2 if (max_size or 0) > 2 else '',
+    )
+    if min_size >= 2:
+        pattern = rf'\W.{repeats}\W'
+    elif min_size == 1:
+        pattern = rf'\W(.{repeats}\W)?'
+    else:
+        assert min_size == 0
+        pattern = rf'(\W(.{repeats}\W)?)?'
+    return st.from_regex(pattern.encode(), fullmatch=True)
+
+
+@resolves(pydantic.ConstrainedDecimal)
+def resolve_condecimal(cls):  # type: ignore[no-untyped-def]
+    min_value = cls.ge
+    max_value = cls.le
+    if cls.gt is not None:
+        assert min_value is None, 'Set `gt` or `ge`, but not both'
+        min_value = cls.gt
+    if cls.lt is not None:
+        assert max_value is None, 'Set `lt` or `le`, but not both'
+        max_value = cls.lt
+    s = st.decimals(min_value, max_value, allow_nan=False, places=cls.decimal_places)
+    if cls.lt is not None:
+        s = s.filter(lambda d: d < cls.lt)
+    if cls.gt is not None:
+        s = s.filter(lambda d: cls.gt < d)
+    return s
+
+
+@resolves(pydantic.ConstrainedFloat)
+def resolve_confloat(cls):  # type: ignore[no-untyped-def]
+    min_value = cls.ge
+    max_value = cls.le
+    exclude_min = False
+    exclude_max = False
+
+    if cls.gt is not None:
+        assert min_value is None, 'Set `gt` or `ge`, but not both'
+        min_value = cls.gt
+        exclude_min = True
+    if cls.lt is not None:
+        assert max_value is None, 'Set `lt` or `le`, but not both'
+        max_value = cls.lt
+        exclude_max = True
+
+    if cls.multiple_of is None:
+        return st.floats(min_value, max_value, exclude_min=exclude_min, exclude_max=exclude_max, allow_nan=False)
+
+    if min_value is not None:
+        min_value = math.ceil(min_value / cls.multiple_of)
+        if exclude_min:
+            min_value = min_value + 1
+    if max_value is not None:
+        assert max_value >= cls.multiple_of, 'Cannot build model with max value smaller than multiple of'
+        max_value = math.floor(max_value / cls.multiple_of)
+        if exclude_max:
+            max_value = max_value - 1
+
+    return st.integers(min_value, max_value).map(lambda x: x * cls.multiple_of)
+
+
+@resolves(pydantic.ConstrainedInt)
+def resolve_conint(cls):  # type: ignore[no-untyped-def]
+    min_value = cls.ge
+    max_value = cls.le
+    if cls.gt is not None:
+        assert min_value is None, 'Set `gt` or `ge`, but not both'
+        min_value = cls.gt + 1
+    if cls.lt is not None:
+        assert max_value is None, 'Set `lt` or `le`, but not both'
+        max_value = cls.lt - 1
+
+    if cls.multiple_of is None or cls.multiple_of == 1:
+        return st.integers(min_value, max_value)
+
+    # These adjustments and the .map handle integer-valued multiples, while the
+    # .filter handles trickier cases as for confloat.
+    if min_value is not None:
+        min_value = math.ceil(Fraction(min_value) / Fraction(cls.multiple_of))
+    if max_value is not None:
+        max_value = math.floor(Fraction(max_value) / Fraction(cls.multiple_of))
+    return st.integers(min_value, max_value).map(lambda x: x * cls.multiple_of)
+
+
+@resolves(pydantic.ConstrainedDate)
+def resolve_condate(cls):  # type: ignore[no-untyped-def]
+    if cls.ge is not None:
+        assert cls.gt is None, 'Set `gt` or `ge`, but not both'
+        min_value = cls.ge
+    elif cls.gt is not None:
+        min_value = cls.gt + datetime.timedelta(days=1)
+    else:
+        min_value = datetime.date.min
+    if cls.le is not None:
+        assert cls.lt is None, 'Set `lt` or `le`, but not both'
+        max_value = cls.le
+    elif cls.lt is not None:
+        max_value = cls.lt - datetime.timedelta(days=1)
+    else:
+        max_value = datetime.date.max
+    return st.dates(min_value, max_value)
+
+
+@resolves(pydantic.ConstrainedStr)
+def resolve_constr(cls):  # type: ignore[no-untyped-def]  # pragma: no cover
+    min_size = cls.min_length or 0
+    max_size = cls.max_length
+
+    if cls.regex is None and not cls.strip_whitespace:
+        return st.text(min_size=min_size, max_size=max_size)
+
+    if cls.regex is not None:
+        strategy = st.from_regex(cls.regex)
+        if cls.strip_whitespace:
+            strategy = strategy.filter(lambda s: s == s.strip())
+    elif cls.strip_whitespace:
+        repeats = '{{{},{}}}'.format(
+            min_size - 2 if min_size > 2 else 0,
+            max_size - 2 if (max_size or 0) > 2 else '',
+        )
+        if min_size >= 2:
+            strategy = st.from_regex(rf'\W.{repeats}\W')
+        elif min_size == 1:
+            strategy = st.from_regex(rf'\W(.{repeats}\W)?')
+        else:
+            assert min_size == 0
+            strategy = st.from_regex(rf'(\W(.{repeats}\W)?)?')
+
+    if min_size == 0 and max_size is None:
+        return strategy
+    elif max_size is None:
+        return strategy.filter(lambda s: min_size <= len(s))
+    return strategy.filter(lambda s: min_size <= len(s) <= max_size)
+
+
+# Finally, register all previously-defined types, and patch in our new function
+for typ in list(pydantic.types._DEFINED_TYPES):
+    _registered(typ)
+pydantic.types._registered = _registered
+st.register_type_strategy(pydantic.Json, resolve_json)
diff --git a/lib/pydantic/annotated_types.py b/lib/pydantic/annotated_types.py
new file mode 100644
index 00000000..d333457f
--- /dev/null
+++ b/lib/pydantic/annotated_types.py
@@ -0,0 +1,72 @@
+import sys
+from typing import TYPE_CHECKING, Any, Dict, FrozenSet, NamedTuple, Type
+
+from .fields import Required
+from .main import BaseModel, create_model
+from .typing import is_typeddict, is_typeddict_special
+
+if TYPE_CHECKING:
+    from typing_extensions import TypedDict
+
+if sys.version_info < (3, 11):
+
+    def is_legacy_typeddict(typeddict_cls: Type['TypedDict']) -> bool:  # type: ignore[valid-type]
+        return is_typeddict(typeddict_cls) and type(typeddict_cls).__module__ == 'typing'
+
+else:
+
+    def is_legacy_typeddict(_: Any) -> Any:
+        return False
+
+
+def create_model_from_typeddict(
+    # Mypy bug: `Type[TypedDict]` is resolved as `Any` https://github.com/python/mypy/issues/11030
+    typeddict_cls: Type['TypedDict'],  # type: ignore[valid-type]
+    **kwargs: Any,
+) -> Type['BaseModel']:
+    """
+    Create a `BaseModel` based on the fields of a `TypedDict`.
+    Since `typing.TypedDict` in Python 3.8 does not store runtime information about optional keys,
+    we raise an error if this happens (see https://bugs.python.org/issue38834).
+    """
+    field_definitions: Dict[str, Any]
+
+    # Best case scenario: with python 3.9+ or when `TypedDict` is imported from `typing_extensions`
+    if not hasattr(typeddict_cls, '__required_keys__'):
+        raise TypeError(
+            'You should use `typing_extensions.TypedDict` instead of `typing.TypedDict` with Python < 3.9.2. '
+            'Without it, there is no way to differentiate required and optional fields when subclassed.'
+        )
+
+    if is_legacy_typeddict(typeddict_cls) and any(
+        is_typeddict_special(t) for t in typeddict_cls.__annotations__.values()
+    ):
+        raise TypeError(
+            'You should use `typing_extensions.TypedDict` instead of `typing.TypedDict` with Python < 3.11. '
+            'Without it, there is no way to reflect Required/NotRequired keys.'
+        )
+
+    required_keys: FrozenSet[str] = typeddict_cls.__required_keys__  # type: ignore[attr-defined]
+    field_definitions = {
+        field_name: (field_type, Required if field_name in required_keys else None)
+        for field_name, field_type in typeddict_cls.__annotations__.items()
+    }
+
+    return create_model(typeddict_cls.__name__, **kwargs, **field_definitions)
+
+
+def create_model_from_namedtuple(namedtuple_cls: Type['NamedTuple'], **kwargs: Any) -> Type['BaseModel']:
+    """
+    Create a `BaseModel` based on the fields of a named tuple.
+    A named tuple can be created with `typing.NamedTuple` and declared annotations
+    but also with `collections.namedtuple`, in this case we consider all fields
+    to have type `Any`.
+    """
+    # With python 3.10+, `__annotations__` always exists but can be empty hence the `getattr... or...` logic
+    namedtuple_annotations: Dict[str, Type[Any]] = getattr(namedtuple_cls, '__annotations__', None) or {
+        k: Any for k in namedtuple_cls._fields
+    }
+    field_definitions: Dict[str, Any] = {
+        field_name: (field_type, Required) for field_name, field_type in namedtuple_annotations.items()
+    }
+    return create_model(namedtuple_cls.__name__, **kwargs, **field_definitions)
diff --git a/lib/pydantic/class_validators.py b/lib/pydantic/class_validators.py
new file mode 100644
index 00000000..87190610
--- /dev/null
+++ b/lib/pydantic/class_validators.py
@@ -0,0 +1,342 @@
+import warnings
+from collections import ChainMap
+from functools import wraps
+from itertools import chain
+from types import FunctionType
+from typing import TYPE_CHECKING, Any, Callable, Dict, Iterable, List, Optional, Set, Tuple, Type, Union, overload
+
+from .errors import ConfigError
+from .typing import AnyCallable
+from .utils import ROOT_KEY, in_ipython
+
+if TYPE_CHECKING:
+    from .typing import AnyClassMethod
+
+
+class Validator:
+    __slots__ = 'func', 'pre', 'each_item', 'always', 'check_fields', 'skip_on_failure'
+
+    def __init__(
+        self,
+        func: AnyCallable,
+        pre: bool = False,
+        each_item: bool = False,
+        always: bool = False,
+        check_fields: bool = False,
+        skip_on_failure: bool = False,
+    ):
+        self.func = func
+        self.pre = pre
+        self.each_item = each_item
+        self.always = always
+        self.check_fields = check_fields
+        self.skip_on_failure = skip_on_failure
+
+
+if TYPE_CHECKING:
+    from inspect import Signature
+
+    from .config import BaseConfig
+    from .fields import ModelField
+    from .types import ModelOrDc
+
+    ValidatorCallable = Callable[[Optional[ModelOrDc], Any, Dict[str, Any], ModelField, Type[BaseConfig]], Any]
+    ValidatorsList = List[ValidatorCallable]
+    ValidatorListDict = Dict[str, List[Validator]]
+
+_FUNCS: Set[str] = set()
+VALIDATOR_CONFIG_KEY = '__validator_config__'
+ROOT_VALIDATOR_CONFIG_KEY = '__root_validator_config__'
+
+
+def validator(
+    *fields: str,
+    pre: bool = False,
+    each_item: bool = False,
+    always: bool = False,
+    check_fields: bool = True,
+    whole: bool = None,
+    allow_reuse: bool = False,
+) -> Callable[[AnyCallable], 'AnyClassMethod']:
+    """
+    Decorate methods on the class indicating that they should be used to validate fields
+    :param fields: which field(s) the method should be called on
+    :param pre: whether or not this validator should be called before the standard validators (else after)
+    :param each_item: for complex objects (sets, lists etc.) whether to validate individual elements rather than the
+      whole object
+    :param always: whether this method and other validators should be called even if the value is missing
+    :param check_fields: whether to check that the fields actually exist on the model
+    :param allow_reuse: whether to track and raise an error if another validator refers to the decorated function
+    """
+    if not fields:
+        raise ConfigError('validator with no fields specified')
+    elif isinstance(fields[0], FunctionType):
+        raise ConfigError(
+            "validators should be used with fields and keyword arguments, not bare. "  # noqa: Q000
+            "E.g. usage should be `@validator('<field_name>', ...)`"
+        )
+    elif not all(isinstance(field, str) for field in fields):
+        raise ConfigError(
+            "validator fields should be passed as separate string args. "  # noqa: Q000
+            "E.g. usage should be `@validator('<field_name_1>', '<field_name_2>', ...)`"
+        )
+
+    if whole is not None:
+        warnings.warn(
+            'The "whole" keyword argument is deprecated, use "each_item" (inverse meaning, default False) instead',
+            DeprecationWarning,
+        )
+        assert each_item is False, '"each_item" and "whole" conflict, remove "whole"'
+        each_item = not whole
+
+    def dec(f: AnyCallable) -> 'AnyClassMethod':
+        f_cls = _prepare_validator(f, allow_reuse)
+        setattr(
+            f_cls,
+            VALIDATOR_CONFIG_KEY,
+            (
+                fields,
+                Validator(func=f_cls.__func__, pre=pre, each_item=each_item, always=always, check_fields=check_fields),
+            ),
+        )
+        return f_cls
+
+    return dec
+
+
+@overload
+def root_validator(_func: AnyCallable) -> 'AnyClassMethod':
+    ...
+
+
+@overload
+def root_validator(
+    *, pre: bool = False, allow_reuse: bool = False, skip_on_failure: bool = False
+) -> Callable[[AnyCallable], 'AnyClassMethod']:
+    ...
+
+
+def root_validator(
+    _func: Optional[AnyCallable] = None, *, pre: bool = False, allow_reuse: bool = False, skip_on_failure: bool = False
+) -> Union['AnyClassMethod', Callable[[AnyCallable], 'AnyClassMethod']]:
+    """
+    Decorate methods on a model indicating that they should be used to validate (and perhaps modify) data either
+    before or after standard model parsing/validation is performed.
+    """
+    if _func:
+        f_cls = _prepare_validator(_func, allow_reuse)
+        setattr(
+            f_cls, ROOT_VALIDATOR_CONFIG_KEY, Validator(func=f_cls.__func__, pre=pre, skip_on_failure=skip_on_failure)
+        )
+        return f_cls
+
+    def dec(f: AnyCallable) -> 'AnyClassMethod':
+        f_cls = _prepare_validator(f, allow_reuse)
+        setattr(
+            f_cls, ROOT_VALIDATOR_CONFIG_KEY, Validator(func=f_cls.__func__, pre=pre, skip_on_failure=skip_on_failure)
+        )
+        return f_cls
+
+    return dec
+
+
+def _prepare_validator(function: AnyCallable, allow_reuse: bool) -> 'AnyClassMethod':
+    """
+    Avoid validators with duplicated names since without this, validators can be overwritten silently
+    which generally isn't the intended behaviour, don't run in ipython (see #312) or if allow_reuse is False.
+    """
+    f_cls = function if isinstance(function, classmethod) else classmethod(function)
+    if not in_ipython() and not allow_reuse:
+        ref = f_cls.__func__.__module__ + '.' + f_cls.__func__.__qualname__
+        if ref in _FUNCS:
+            raise ConfigError(f'duplicate validator function "{ref}"; if this is intended, set `allow_reuse=True`')
+        _FUNCS.add(ref)
+    return f_cls
+
+
+class ValidatorGroup:
+    def __init__(self, validators: 'ValidatorListDict') -> None:
+        self.validators = validators
+        self.used_validators = {'*'}
+
+    def get_validators(self, name: str) -> Optional[Dict[str, Validator]]:
+        self.used_validators.add(name)
+        validators = self.validators.get(name, [])
+        if name != ROOT_KEY:
+            validators += self.validators.get('*', [])
+        if validators:
+            return {v.func.__name__: v for v in validators}
+        else:
+            return None
+
+    def check_for_unused(self) -> None:
+        unused_validators = set(
+            chain.from_iterable(
+                (v.func.__name__ for v in self.validators[f] if v.check_fields)
+                for f in (self.validators.keys() - self.used_validators)
+            )
+        )
+        if unused_validators:
+            fn = ', '.join(unused_validators)
+            raise ConfigError(
+                f"Validators defined with incorrect fields: {fn} "  # noqa: Q000
+                f"(use check_fields=False if you're inheriting from the model and intended this)"
+            )
+
+
+def extract_validators(namespace: Dict[str, Any]) -> Dict[str, List[Validator]]:
+    validators: Dict[str, List[Validator]] = {}
+    for var_name, value in namespace.items():
+        validator_config = getattr(value, VALIDATOR_CONFIG_KEY, None)
+        if validator_config:
+            fields, v = validator_config
+            for field in fields:
+                if field in validators:
+                    validators[field].append(v)
+                else:
+                    validators[field] = [v]
+    return validators
+
+
+def extract_root_validators(namespace: Dict[str, Any]) -> Tuple[List[AnyCallable], List[Tuple[bool, AnyCallable]]]:
+    from inspect import signature
+
+    pre_validators: List[AnyCallable] = []
+    post_validators: List[Tuple[bool, AnyCallable]] = []
+    for name, value in namespace.items():
+        validator_config: Optional[Validator] = getattr(value, ROOT_VALIDATOR_CONFIG_KEY, None)
+        if validator_config:
+            sig = signature(validator_config.func)
+            args = list(sig.parameters.keys())
+            if args[0] == 'self':
+                raise ConfigError(
+                    f'Invalid signature for root validator {name}: {sig}, "self" not permitted as first argument, '
+                    f'should be: (cls, values).'
+                )
+            if len(args) != 2:
+                raise ConfigError(f'Invalid signature for root validator {name}: {sig}, should be: (cls, values).')
+            # check function signature
+            if validator_config.pre:
+                pre_validators.append(validator_config.func)
+            else:
+                post_validators.append((validator_config.skip_on_failure, validator_config.func))
+    return pre_validators, post_validators
+
+
+def inherit_validators(base_validators: 'ValidatorListDict', validators: 'ValidatorListDict') -> 'ValidatorListDict':
+    for field, field_validators in base_validators.items():
+        if field not in validators:
+            validators[field] = []
+        validators[field] += field_validators
+    return validators
+
+
+def make_generic_validator(validator: AnyCallable) -> 'ValidatorCallable':
+    """
+    Make a generic function which calls a validator with the right arguments.
+
+    Unfortunately other approaches (eg. return a partial of a function that builds the arguments) is slow,
+    hence this laborious way of doing things.
+
+    It's done like this so validators don't all need **kwargs in their signature, eg. any combination of
+    the arguments "values", "fields" and/or "config" are permitted.
+    """
+    from inspect import signature
+
+    sig = signature(validator)
+    args = list(sig.parameters.keys())
+    first_arg = args.pop(0)
+    if first_arg == 'self':
+        raise ConfigError(
+            f'Invalid signature for validator {validator}: {sig}, "self" not permitted as first argument, '
+            f'should be: (cls, value, values, config, field), "values", "config" and "field" are all optional.'
+        )
+    elif first_arg == 'cls':
+        # assume the second argument is value
+        return wraps(validator)(_generic_validator_cls(validator, sig, set(args[1:])))
+    else:
+        # assume the first argument was value which has already been removed
+        return wraps(validator)(_generic_validator_basic(validator, sig, set(args)))
+
+
+def prep_validators(v_funcs: Iterable[AnyCallable]) -> 'ValidatorsList':
+    return [make_generic_validator(f) for f in v_funcs if f]
+
+
+all_kwargs = {'values', 'field', 'config'}
+
+
+def _generic_validator_cls(validator: AnyCallable, sig: 'Signature', args: Set[str]) -> 'ValidatorCallable':
+    # assume the first argument is value
+    has_kwargs = False
+    if 'kwargs' in args:
+        has_kwargs = True
+        args -= {'kwargs'}
+
+    if not args.issubset(all_kwargs):
+        raise ConfigError(
+            f'Invalid signature for validator {validator}: {sig}, should be: '
+            f'(cls, value, values, config, field), "values", "config" and "field" are all optional.'
+        )
+
+    if has_kwargs:
+        return lambda cls, v, values, field, config: validator(cls, v, values=values, field=field, config=config)
+    elif args == set():
+        return lambda cls, v, values, field, config: validator(cls, v)
+    elif args == {'values'}:
+        return lambda cls, v, values, field, config: validator(cls, v, values=values)
+    elif args == {'field'}:
+        return lambda cls, v, values, field, config: validator(cls, v, field=field)
+    elif args == {'config'}:
+        return lambda cls, v, values, field, config: validator(cls, v, config=config)
+    elif args == {'values', 'field'}:
+        return lambda cls, v, values, field, config: validator(cls, v, values=values, field=field)
+    elif args == {'values', 'config'}:
+        return lambda cls, v, values, field, config: validator(cls, v, values=values, config=config)
+    elif args == {'field', 'config'}:
+        return lambda cls, v, values, field, config: validator(cls, v, field=field, config=config)
+    else:
+        # args == {'values', 'field', 'config'}
+        return lambda cls, v, values, field, config: validator(cls, v, values=values, field=field, config=config)
+
+
+def _generic_validator_basic(validator: AnyCallable, sig: 'Signature', args: Set[str]) -> 'ValidatorCallable':
+    has_kwargs = False
+    if 'kwargs' in args:
+        has_kwargs = True
+        args -= {'kwargs'}
+
+    if not args.issubset(all_kwargs):
+        raise ConfigError(
+            f'Invalid signature for validator {validator}: {sig}, should be: '
+            f'(value, values, config, field), "values", "config" and "field" are all optional.'
+        )
+
+    if has_kwargs:
+        return lambda cls, v, values, field, config: validator(v, values=values, field=field, config=config)
+    elif args == set():
+        return lambda cls, v, values, field, config: validator(v)
+    elif args == {'values'}:
+        return lambda cls, v, values, field, config: validator(v, values=values)
+    elif args == {'field'}:
+        return lambda cls, v, values, field, config: validator(v, field=field)
+    elif args == {'config'}:
+        return lambda cls, v, values, field, config: validator(v, config=config)
+    elif args == {'values', 'field'}:
+        return lambda cls, v, values, field, config: validator(v, values=values, field=field)
+    elif args == {'values', 'config'}:
+        return lambda cls, v, values, field, config: validator(v, values=values, config=config)
+    elif args == {'field', 'config'}:
+        return lambda cls, v, values, field, config: validator(v, field=field, config=config)
+    else:
+        # args == {'values', 'field', 'config'}
+        return lambda cls, v, values, field, config: validator(v, values=values, field=field, config=config)
+
+
+def gather_all_validators(type_: 'ModelOrDc') -> Dict[str, 'AnyClassMethod']:
+    all_attributes = ChainMap(*[cls.__dict__ for cls in type_.__mro__])  # type: ignore[arg-type,var-annotated]
+    return {
+        k: v
+        for k, v in all_attributes.items()
+        if hasattr(v, VALIDATOR_CONFIG_KEY) or hasattr(v, ROOT_VALIDATOR_CONFIG_KEY)
+    }
diff --git a/lib/pydantic/color.py b/lib/pydantic/color.py
new file mode 100644
index 00000000..6fdc9fb1
--- /dev/null
+++ b/lib/pydantic/color.py
@@ -0,0 +1,494 @@
+"""
+Color definitions are  used as per CSS3 specification:
+http://www.w3.org/TR/css3-color/#svg-color
+
+A few colors have multiple names referring to the sames colors, eg. `grey` and `gray` or `aqua` and `cyan`.
+
+In these cases the LAST color when sorted alphabetically takes preferences,
+eg. Color((0, 255, 255)).as_named() == 'cyan' because "cyan" comes after "aqua".
+"""
+import math
+import re
+from colorsys import hls_to_rgb, rgb_to_hls
+from typing import TYPE_CHECKING, Any, Dict, Optional, Tuple, Union, cast
+
+from .errors import ColorError
+from .utils import Representation, almost_equal_floats
+
+if TYPE_CHECKING:
+    from .typing import CallableGenerator, ReprArgs
+
+ColorTuple = Union[Tuple[int, int, int], Tuple[int, int, int, float]]
+ColorType = Union[ColorTuple, str]
+HslColorTuple = Union[Tuple[float, float, float], Tuple[float, float, float, float]]
+
+
+class RGBA:
+    """
+    Internal use only as a representation of a color.
+    """
+
+    __slots__ = 'r', 'g', 'b', 'alpha', '_tuple'
+
+    def __init__(self, r: float, g: float, b: float, alpha: Optional[float]):
+        self.r = r
+        self.g = g
+        self.b = b
+        self.alpha = alpha
+
+        self._tuple: Tuple[float, float, float, Optional[float]] = (r, g, b, alpha)
+
+    def __getitem__(self, item: Any) -> Any:
+        return self._tuple[item]
+
+
+# these are not compiled here to avoid import slowdown, they'll be compiled the first time they're used, then cached
+r_hex_short = r'\s*(?:#|0x)?([0-9a-f])([0-9a-f])([0-9a-f])([0-9a-f])?\s*'
+r_hex_long = r'\s*(?:#|0x)?([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})?\s*'
+_r_255 = r'(\d{1,3}(?:\.\d+)?)'
+_r_comma = r'\s*,\s*'
+r_rgb = fr'\s*rgb\(\s*{_r_255}{_r_comma}{_r_255}{_r_comma}{_r_255}\)\s*'
+_r_alpha = r'(\d(?:\.\d+)?|\.\d+|\d{1,2}%)'
+r_rgba = fr'\s*rgba\(\s*{_r_255}{_r_comma}{_r_255}{_r_comma}{_r_255}{_r_comma}{_r_alpha}\s*\)\s*'
+_r_h = r'(-?\d+(?:\.\d+)?|-?\.\d+)(deg|rad|turn)?'
+_r_sl = r'(\d{1,3}(?:\.\d+)?)%'
+r_hsl = fr'\s*hsl\(\s*{_r_h}{_r_comma}{_r_sl}{_r_comma}{_r_sl}\s*\)\s*'
+r_hsla = fr'\s*hsl\(\s*{_r_h}{_r_comma}{_r_sl}{_r_comma}{_r_sl}{_r_comma}{_r_alpha}\s*\)\s*'
+
+# colors where the two hex characters are the same, if all colors match this the short version of hex colors can be used
+repeat_colors = {int(c * 2, 16) for c in '0123456789abcdef'}
+rads = 2 * math.pi
+
+
+class Color(Representation):
+    __slots__ = '_original', '_rgba'
+
+    def __init__(self, value: ColorType) -> None:
+        self._rgba: RGBA
+        self._original: ColorType
+        if isinstance(value, (tuple, list)):
+            self._rgba = parse_tuple(value)
+        elif isinstance(value, str):
+            self._rgba = parse_str(value)
+        elif isinstance(value, Color):
+            self._rgba = value._rgba
+            value = value._original
+        else:
+            raise ColorError(reason='value must be a tuple, list or string')
+
+        # if we've got here value must be a valid color
+        self._original = value
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        field_schema.update(type='string', format='color')
+
+    def original(self) -> ColorType:
+        """
+        Original value passed to Color
+        """
+        return self._original
+
+    def as_named(self, *, fallback: bool = False) -> str:
+        if self._rgba.alpha is None:
+            rgb = cast(Tuple[int, int, int], self.as_rgb_tuple())
+            try:
+                return COLORS_BY_VALUE[rgb]
+            except KeyError as e:
+                if fallback:
+                    return self.as_hex()
+                else:
+                    raise ValueError('no named color found, use fallback=True, as_hex() or as_rgb()') from e
+        else:
+            return self.as_hex()
+
+    def as_hex(self) -> str:
+        """
+        Hex string representing the color can be 3, 4, 6 or 8 characters depending on whether the string
+        a "short" representation of the color is possible and whether there's an alpha channel.
+        """
+        values = [float_to_255(c) for c in self._rgba[:3]]
+        if self._rgba.alpha is not None:
+            values.append(float_to_255(self._rgba.alpha))
+
+        as_hex = ''.join(f'{v:02x}' for v in values)
+        if all(c in repeat_colors for c in values):
+            as_hex = ''.join(as_hex[c] for c in range(0, len(as_hex), 2))
+        return '#' + as_hex
+
+    def as_rgb(self) -> str:
+        """
+        Color as an rgb(<r>, <g>, <b>) or rgba(<r>, <g>, <b>, <a>) string.
+        """
+        if self._rgba.alpha is None:
+            return f'rgb({float_to_255(self._rgba.r)}, {float_to_255(self._rgba.g)}, {float_to_255(self._rgba.b)})'
+        else:
+            return (
+                f'rgba({float_to_255(self._rgba.r)}, {float_to_255(self._rgba.g)}, {float_to_255(self._rgba.b)}, '
+                f'{round(self._alpha_float(), 2)})'
+            )
+
+    def as_rgb_tuple(self, *, alpha: Optional[bool] = None) -> ColorTuple:
+        """
+        Color as an RGB or RGBA tuple; red, green and blue are in the range 0 to 255, alpha if included is
+        in the range 0 to 1.
+
+        :param alpha: whether to include the alpha channel, options are
+          None - (default) include alpha only if it's set (e.g. not None)
+          True - always include alpha,
+          False - always omit alpha,
+        """
+        r, g, b = (float_to_255(c) for c in self._rgba[:3])
+        if alpha is None:
+            if self._rgba.alpha is None:
+                return r, g, b
+            else:
+                return r, g, b, self._alpha_float()
+        elif alpha:
+            return r, g, b, self._alpha_float()
+        else:
+            # alpha is False
+            return r, g, b
+
+    def as_hsl(self) -> str:
+        """
+        Color as an hsl(<h>, <s>, <l>) or hsl(<h>, <s>, <l>, <a>) string.
+        """
+        if self._rgba.alpha is None:
+            h, s, li = self.as_hsl_tuple(alpha=False)  # type: ignore
+            return f'hsl({h * 360:0.0f}, {s:0.0%}, {li:0.0%})'
+        else:
+            h, s, li, a = self.as_hsl_tuple(alpha=True)  # type: ignore
+            return f'hsl({h * 360:0.0f}, {s:0.0%}, {li:0.0%}, {round(a, 2)})'
+
+    def as_hsl_tuple(self, *, alpha: Optional[bool] = None) -> HslColorTuple:
+        """
+        Color as an HSL or HSLA tuple, e.g. hue, saturation, lightness and optionally alpha; all elements are in
+        the range 0 to 1.
+
+        NOTE: this is HSL as used in HTML and most other places, not HLS as used in python's colorsys.
+
+        :param alpha: whether to include the alpha channel, options are
+          None - (default) include alpha only if it's set (e.g. not None)
+          True - always include alpha,
+          False - always omit alpha,
+        """
+        h, l, s = rgb_to_hls(self._rgba.r, self._rgba.g, self._rgba.b)
+        if alpha is None:
+            if self._rgba.alpha is None:
+                return h, s, l
+            else:
+                return h, s, l, self._alpha_float()
+        if alpha:
+            return h, s, l, self._alpha_float()
+        else:
+            # alpha is False
+            return h, s, l
+
+    def _alpha_float(self) -> float:
+        return 1 if self._rgba.alpha is None else self._rgba.alpha
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield cls
+
+    def __str__(self) -> str:
+        return self.as_named(fallback=True)
+
+    def __repr_args__(self) -> 'ReprArgs':
+        return [(None, self.as_named(fallback=True))] + [('rgb', self.as_rgb_tuple())]  # type: ignore
+
+    def __eq__(self, other: Any) -> bool:
+        return isinstance(other, Color) and self.as_rgb_tuple() == other.as_rgb_tuple()
+
+    def __hash__(self) -> int:
+        return hash(self.as_rgb_tuple())
+
+
+def parse_tuple(value: Tuple[Any, ...]) -> RGBA:
+    """
+    Parse a tuple or list as a color.
+    """
+    if len(value) == 3:
+        r, g, b = (parse_color_value(v) for v in value)
+        return RGBA(r, g, b, None)
+    elif len(value) == 4:
+        r, g, b = (parse_color_value(v) for v in value[:3])
+        return RGBA(r, g, b, parse_float_alpha(value[3]))
+    else:
+        raise ColorError(reason='tuples must have length 3 or 4')
+
+
+def parse_str(value: str) -> RGBA:
+    """
+    Parse a string to an RGBA tuple, trying the following formats (in this order):
+    * named color, see COLORS_BY_NAME below
+    * hex short eg. `<prefix>fff` (prefix can be `#`, `0x` or nothing)
+    * hex long eg. `<prefix>ffffff` (prefix can be `#`, `0x` or nothing)
+    * `rgb(<r>, <g>, <b>) `
+    * `rgba(<r>, <g>, <b>, <a>)`
+    """
+    value_lower = value.lower()
+    try:
+        r, g, b = COLORS_BY_NAME[value_lower]
+    except KeyError:
+        pass
+    else:
+        return ints_to_rgba(r, g, b, None)
+
+    m = re.fullmatch(r_hex_short, value_lower)
+    if m:
+        *rgb, a = m.groups()
+        r, g, b = (int(v * 2, 16) for v in rgb)
+        if a:
+            alpha: Optional[float] = int(a * 2, 16) / 255
+        else:
+            alpha = None
+        return ints_to_rgba(r, g, b, alpha)
+
+    m = re.fullmatch(r_hex_long, value_lower)
+    if m:
+        *rgb, a = m.groups()
+        r, g, b = (int(v, 16) for v in rgb)
+        if a:
+            alpha = int(a, 16) / 255
+        else:
+            alpha = None
+        return ints_to_rgba(r, g, b, alpha)
+
+    m = re.fullmatch(r_rgb, value_lower)
+    if m:
+        return ints_to_rgba(*m.groups(), None)  # type: ignore
+
+    m = re.fullmatch(r_rgba, value_lower)
+    if m:
+        return ints_to_rgba(*m.groups())  # type: ignore
+
+    m = re.fullmatch(r_hsl, value_lower)
+    if m:
+        h, h_units, s, l_ = m.groups()
+        return parse_hsl(h, h_units, s, l_)
+
+    m = re.fullmatch(r_hsla, value_lower)
+    if m:
+        h, h_units, s, l_, a = m.groups()
+        return parse_hsl(h, h_units, s, l_, parse_float_alpha(a))
+
+    raise ColorError(reason='string not recognised as a valid color')
+
+
+def ints_to_rgba(r: Union[int, str], g: Union[int, str], b: Union[int, str], alpha: Optional[float]) -> RGBA:
+    return RGBA(parse_color_value(r), parse_color_value(g), parse_color_value(b), parse_float_alpha(alpha))
+
+
+def parse_color_value(value: Union[int, str], max_val: int = 255) -> float:
+    """
+    Parse a value checking it's a valid int in the range 0 to max_val and divide by max_val to give a number
+    in the range 0 to 1
+    """
+    try:
+        color = float(value)
+    except ValueError:
+        raise ColorError(reason='color values must be a valid number')
+    if 0 <= color <= max_val:
+        return color / max_val
+    else:
+        raise ColorError(reason=f'color values must be in the range 0 to {max_val}')
+
+
+def parse_float_alpha(value: Union[None, str, float, int]) -> Optional[float]:
+    """
+    Parse a value checking it's a valid float in the range 0 to 1
+    """
+    if value is None:
+        return None
+    try:
+        if isinstance(value, str) and value.endswith('%'):
+            alpha = float(value[:-1]) / 100
+        else:
+            alpha = float(value)
+    except ValueError:
+        raise ColorError(reason='alpha values must be a valid float')
+
+    if almost_equal_floats(alpha, 1):
+        return None
+    elif 0 <= alpha <= 1:
+        return alpha
+    else:
+        raise ColorError(reason='alpha values must be in the range 0 to 1')
+
+
+def parse_hsl(h: str, h_units: str, sat: str, light: str, alpha: Optional[float] = None) -> RGBA:
+    """
+    Parse raw hue, saturation, lightness and alpha values and convert to RGBA.
+    """
+    s_value, l_value = parse_color_value(sat, 100), parse_color_value(light, 100)
+
+    h_value = float(h)
+    if h_units in {None, 'deg'}:
+        h_value = h_value % 360 / 360
+    elif h_units == 'rad':
+        h_value = h_value % rads / rads
+    else:
+        # turns
+        h_value = h_value % 1
+
+    r, g, b = hls_to_rgb(h_value, l_value, s_value)
+    return RGBA(r, g, b, alpha)
+
+
+def float_to_255(c: float) -> int:
+    return int(round(c * 255))
+
+
+COLORS_BY_NAME = {
+    'aliceblue': (240, 248, 255),
+    'antiquewhite': (250, 235, 215),
+    'aqua': (0, 255, 255),
+    'aquamarine': (127, 255, 212),
+    'azure': (240, 255, 255),
+    'beige': (245, 245, 220),
+    'bisque': (255, 228, 196),
+    'black': (0, 0, 0),
+    'blanchedalmond': (255, 235, 205),
+    'blue': (0, 0, 255),
+    'blueviolet': (138, 43, 226),
+    'brown': (165, 42, 42),
+    'burlywood': (222, 184, 135),
+    'cadetblue': (95, 158, 160),
+    'chartreuse': (127, 255, 0),
+    'chocolate': (210, 105, 30),
+    'coral': (255, 127, 80),
+    'cornflowerblue': (100, 149, 237),
+    'cornsilk': (255, 248, 220),
+    'crimson': (220, 20, 60),
+    'cyan': (0, 255, 255),
+    'darkblue': (0, 0, 139),
+    'darkcyan': (0, 139, 139),
+    'darkgoldenrod': (184, 134, 11),
+    'darkgray': (169, 169, 169),
+    'darkgreen': (0, 100, 0),
+    'darkgrey': (169, 169, 169),
+    'darkkhaki': (189, 183, 107),
+    'darkmagenta': (139, 0, 139),
+    'darkolivegreen': (85, 107, 47),
+    'darkorange': (255, 140, 0),
+    'darkorchid': (153, 50, 204),
+    'darkred': (139, 0, 0),
+    'darksalmon': (233, 150, 122),
+    'darkseagreen': (143, 188, 143),
+    'darkslateblue': (72, 61, 139),
+    'darkslategray': (47, 79, 79),
+    'darkslategrey': (47, 79, 79),
+    'darkturquoise': (0, 206, 209),
+    'darkviolet': (148, 0, 211),
+    'deeppink': (255, 20, 147),
+    'deepskyblue': (0, 191, 255),
+    'dimgray': (105, 105, 105),
+    'dimgrey': (105, 105, 105),
+    'dodgerblue': (30, 144, 255),
+    'firebrick': (178, 34, 34),
+    'floralwhite': (255, 250, 240),
+    'forestgreen': (34, 139, 34),
+    'fuchsia': (255, 0, 255),
+    'gainsboro': (220, 220, 220),
+    'ghostwhite': (248, 248, 255),
+    'gold': (255, 215, 0),
+    'goldenrod': (218, 165, 32),
+    'gray': (128, 128, 128),
+    'green': (0, 128, 0),
+    'greenyellow': (173, 255, 47),
+    'grey': (128, 128, 128),
+    'honeydew': (240, 255, 240),
+    'hotpink': (255, 105, 180),
+    'indianred': (205, 92, 92),
+    'indigo': (75, 0, 130),
+    'ivory': (255, 255, 240),
+    'khaki': (240, 230, 140),
+    'lavender': (230, 230, 250),
+    'lavenderblush': (255, 240, 245),
+    'lawngreen': (124, 252, 0),
+    'lemonchiffon': (255, 250, 205),
+    'lightblue': (173, 216, 230),
+    'lightcoral': (240, 128, 128),
+    'lightcyan': (224, 255, 255),
+    'lightgoldenrodyellow': (250, 250, 210),
+    'lightgray': (211, 211, 211),
+    'lightgreen': (144, 238, 144),
+    'lightgrey': (211, 211, 211),
+    'lightpink': (255, 182, 193),
+    'lightsalmon': (255, 160, 122),
+    'lightseagreen': (32, 178, 170),
+    'lightskyblue': (135, 206, 250),
+    'lightslategray': (119, 136, 153),
+    'lightslategrey': (119, 136, 153),
+    'lightsteelblue': (176, 196, 222),
+    'lightyellow': (255, 255, 224),
+    'lime': (0, 255, 0),
+    'limegreen': (50, 205, 50),
+    'linen': (250, 240, 230),
+    'magenta': (255, 0, 255),
+    'maroon': (128, 0, 0),
+    'mediumaquamarine': (102, 205, 170),
+    'mediumblue': (0, 0, 205),
+    'mediumorchid': (186, 85, 211),
+    'mediumpurple': (147, 112, 219),
+    'mediumseagreen': (60, 179, 113),
+    'mediumslateblue': (123, 104, 238),
+    'mediumspringgreen': (0, 250, 154),
+    'mediumturquoise': (72, 209, 204),
+    'mediumvioletred': (199, 21, 133),
+    'midnightblue': (25, 25, 112),
+    'mintcream': (245, 255, 250),
+    'mistyrose': (255, 228, 225),
+    'moccasin': (255, 228, 181),
+    'navajowhite': (255, 222, 173),
+    'navy': (0, 0, 128),
+    'oldlace': (253, 245, 230),
+    'olive': (128, 128, 0),
+    'olivedrab': (107, 142, 35),
+    'orange': (255, 165, 0),
+    'orangered': (255, 69, 0),
+    'orchid': (218, 112, 214),
+    'palegoldenrod': (238, 232, 170),
+    'palegreen': (152, 251, 152),
+    'paleturquoise': (175, 238, 238),
+    'palevioletred': (219, 112, 147),
+    'papayawhip': (255, 239, 213),
+    'peachpuff': (255, 218, 185),
+    'peru': (205, 133, 63),
+    'pink': (255, 192, 203),
+    'plum': (221, 160, 221),
+    'powderblue': (176, 224, 230),
+    'purple': (128, 0, 128),
+    'red': (255, 0, 0),
+    'rosybrown': (188, 143, 143),
+    'royalblue': (65, 105, 225),
+    'saddlebrown': (139, 69, 19),
+    'salmon': (250, 128, 114),
+    'sandybrown': (244, 164, 96),
+    'seagreen': (46, 139, 87),
+    'seashell': (255, 245, 238),
+    'sienna': (160, 82, 45),
+    'silver': (192, 192, 192),
+    'skyblue': (135, 206, 235),
+    'slateblue': (106, 90, 205),
+    'slategray': (112, 128, 144),
+    'slategrey': (112, 128, 144),
+    'snow': (255, 250, 250),
+    'springgreen': (0, 255, 127),
+    'steelblue': (70, 130, 180),
+    'tan': (210, 180, 140),
+    'teal': (0, 128, 128),
+    'thistle': (216, 191, 216),
+    'tomato': (255, 99, 71),
+    'turquoise': (64, 224, 208),
+    'violet': (238, 130, 238),
+    'wheat': (245, 222, 179),
+    'white': (255, 255, 255),
+    'whitesmoke': (245, 245, 245),
+    'yellow': (255, 255, 0),
+    'yellowgreen': (154, 205, 50),
+}
+
+COLORS_BY_VALUE = {v: k for k, v in COLORS_BY_NAME.items()}
diff --git a/lib/pydantic/config.py b/lib/pydantic/config.py
new file mode 100644
index 00000000..74687ca0
--- /dev/null
+++ b/lib/pydantic/config.py
@@ -0,0 +1,192 @@
+import json
+from enum import Enum
+from typing import TYPE_CHECKING, Any, Callable, Dict, ForwardRef, Optional, Tuple, Type, Union
+
+from typing_extensions import Literal, Protocol
+
+from .typing import AnyArgTCallable, AnyCallable
+from .utils import GetterDict
+from .version import compiled
+
+if TYPE_CHECKING:
+    from typing import overload
+
+    from .fields import ModelField
+    from .main import BaseModel
+
+    ConfigType = Type['BaseConfig']
+
+    class SchemaExtraCallable(Protocol):
+        @overload
+        def __call__(self, schema: Dict[str, Any]) -> None:
+            pass
+
+        @overload
+        def __call__(self, schema: Dict[str, Any], model_class: Type[BaseModel]) -> None:
+            pass
+
+else:
+    SchemaExtraCallable = Callable[..., None]
+
+__all__ = 'BaseConfig', 'ConfigDict', 'get_config', 'Extra', 'inherit_config', 'prepare_config'
+
+
+class Extra(str, Enum):
+    allow = 'allow'
+    ignore = 'ignore'
+    forbid = 'forbid'
+
+
+# https://github.com/cython/cython/issues/4003
+# Will be fixed with Cython 3 but still in alpha right now
+if not compiled:
+    from typing_extensions import TypedDict
+
+    class ConfigDict(TypedDict, total=False):
+        title: Optional[str]
+        anystr_lower: bool
+        anystr_strip_whitespace: bool
+        min_anystr_length: int
+        max_anystr_length: Optional[int]
+        validate_all: bool
+        extra: Extra
+        allow_mutation: bool
+        frozen: bool
+        allow_population_by_field_name: bool
+        use_enum_values: bool
+        fields: Dict[str, Union[str, Dict[str, str]]]
+        validate_assignment: bool
+        error_msg_templates: Dict[str, str]
+        arbitrary_types_allowed: bool
+        orm_mode: bool
+        getter_dict: Type[GetterDict]
+        alias_generator: Optional[Callable[[str], str]]
+        keep_untouched: Tuple[type, ...]
+        schema_extra: Union[Dict[str, object], 'SchemaExtraCallable']
+        json_loads: Callable[[str], object]
+        json_dumps: AnyArgTCallable[str]
+        json_encoders: Dict[Type[object], AnyCallable]
+        underscore_attrs_are_private: bool
+        allow_inf_nan: bool
+
+        # whether or not inherited models as fields should be reconstructed as base model
+        copy_on_model_validation: bool
+        # whether dataclass `__post_init__` should be run after validation
+        post_init_call: Literal['before_validation', 'after_validation']
+
+else:
+    ConfigDict = dict  # type: ignore
+
+
+class BaseConfig:
+    title: Optional[str] = None
+    anystr_lower: bool = False
+    anystr_upper: bool = False
+    anystr_strip_whitespace: bool = False
+    min_anystr_length: int = 0
+    max_anystr_length: Optional[int] = None
+    validate_all: bool = False
+    extra: Extra = Extra.ignore
+    allow_mutation: bool = True
+    frozen: bool = False
+    allow_population_by_field_name: bool = False
+    use_enum_values: bool = False
+    fields: Dict[str, Union[str, Dict[str, str]]] = {}
+    validate_assignment: bool = False
+    error_msg_templates: Dict[str, str] = {}
+    arbitrary_types_allowed: bool = False
+    orm_mode: bool = False
+    getter_dict: Type[GetterDict] = GetterDict
+    alias_generator: Optional[Callable[[str], str]] = None
+    keep_untouched: Tuple[type, ...] = ()
+    schema_extra: Union[Dict[str, Any], 'SchemaExtraCallable'] = {}
+    json_loads: Callable[[str], Any] = json.loads
+    json_dumps: Callable[..., str] = json.dumps
+    json_encoders: Dict[Union[Type[Any], str, ForwardRef], AnyCallable] = {}
+    underscore_attrs_are_private: bool = False
+    allow_inf_nan: bool = True
+
+    # whether inherited models as fields should be reconstructed as base model,
+    # and whether such a copy should be shallow or deep
+    copy_on_model_validation: Literal['none', 'deep', 'shallow'] = 'shallow'
+
+    # whether `Union` should check all allowed types before even trying to coerce
+    smart_union: bool = False
+    # whether dataclass `__post_init__` should be run before or after validation
+    post_init_call: Literal['before_validation', 'after_validation'] = 'before_validation'
+
+    @classmethod
+    def get_field_info(cls, name: str) -> Dict[str, Any]:
+        """
+        Get properties of FieldInfo from the `fields` property of the config class.
+        """
+
+        fields_value = cls.fields.get(name)
+
+        if isinstance(fields_value, str):
+            field_info: Dict[str, Any] = {'alias': fields_value}
+        elif isinstance(fields_value, dict):
+            field_info = fields_value
+        else:
+            field_info = {}
+
+        if 'alias' in field_info:
+            field_info.setdefault('alias_priority', 2)
+
+        if field_info.get('alias_priority', 0) <= 1 and cls.alias_generator:
+            alias = cls.alias_generator(name)
+            if not isinstance(alias, str):
+                raise TypeError(f'Config.alias_generator must return str, not {alias.__class__}')
+            field_info.update(alias=alias, alias_priority=1)
+        return field_info
+
+    @classmethod
+    def prepare_field(cls, field: 'ModelField') -> None:
+        """
+        Optional hook to check or modify fields during model creation.
+        """
+        pass
+
+
+def get_config(config: Union[ConfigDict, Type[object], None]) -> Type[BaseConfig]:
+    if config is None:
+        return BaseConfig
+
+    else:
+        config_dict = (
+            config
+            if isinstance(config, dict)
+            else {k: getattr(config, k) for k in dir(config) if not k.startswith('__')}
+        )
+
+        class Config(BaseConfig):
+            ...
+
+        for k, v in config_dict.items():
+            setattr(Config, k, v)
+        return Config
+
+
+def inherit_config(self_config: 'ConfigType', parent_config: 'ConfigType', **namespace: Any) -> 'ConfigType':
+    if not self_config:
+        base_classes: Tuple['ConfigType', ...] = (parent_config,)
+    elif self_config == parent_config:
+        base_classes = (self_config,)
+    else:
+        base_classes = self_config, parent_config
+
+    namespace['json_encoders'] = {
+        **getattr(parent_config, 'json_encoders', {}),
+        **getattr(self_config, 'json_encoders', {}),
+        **namespace.get('json_encoders', {}),
+    }
+
+    return type('Config', base_classes, namespace)
+
+
+def prepare_config(config: Type[BaseConfig], cls_name: str) -> None:
+    if not isinstance(config.extra, Extra):
+        try:
+            config.extra = Extra(config.extra)
+        except ValueError:
+            raise ValueError(f'"{cls_name}": {config.extra} is not a valid value for "extra"')
diff --git a/lib/pydantic/dataclasses.py b/lib/pydantic/dataclasses.py
new file mode 100644
index 00000000..68331127
--- /dev/null
+++ b/lib/pydantic/dataclasses.py
@@ -0,0 +1,479 @@
+"""
+The main purpose is to enhance stdlib dataclasses by adding validation
+A pydantic dataclass can be generated from scratch or from a stdlib one.
+
+Behind the scene, a pydantic dataclass is just like a regular one on which we attach
+a `BaseModel` and magic methods to trigger the validation of the data.
+`__init__` and `__post_init__` are hence overridden and have extra logic to be
+able to validate input data.
+
+When a pydantic dataclass is generated from scratch, it's just a plain dataclass
+with validation triggered at initialization
+
+The tricky part if for stdlib dataclasses that are converted after into pydantic ones e.g.
+
+```py
+@dataclasses.dataclass
+class M:
+    x: int
+
+ValidatedM = pydantic.dataclasses.dataclass(M)
+```
+
+We indeed still want to support equality, hashing, repr, ... as if it was the stdlib one!
+
+```py
+assert isinstance(ValidatedM(x=1), M)
+assert ValidatedM(x=1) == M(x=1)
+```
+
+This means we **don't want to create a new dataclass that inherits from it**
+The trick is to create a wrapper around `M` that will act as a proxy to trigger
+validation without altering default `M` behaviour.
+"""
+import sys
+from contextlib import contextmanager
+from functools import wraps
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    ClassVar,
+    Dict,
+    Generator,
+    Optional,
+    Set,
+    Type,
+    TypeVar,
+    Union,
+    overload,
+)
+
+from typing_extensions import dataclass_transform
+
+from .class_validators import gather_all_validators
+from .config import BaseConfig, ConfigDict, Extra, get_config
+from .error_wrappers import ValidationError
+from .errors import DataclassTypeError
+from .fields import Field, FieldInfo, Required, Undefined
+from .main import create_model, validate_model
+from .utils import ClassAttribute
+
+if TYPE_CHECKING:
+    from .main import BaseModel
+    from .typing import CallableGenerator, NoArgAnyCallable
+
+    DataclassT = TypeVar('DataclassT', bound='Dataclass')
+
+    DataclassClassOrWrapper = Union[Type['Dataclass'], 'DataclassProxy']
+
+    class Dataclass:
+        # stdlib attributes
+        __dataclass_fields__: ClassVar[Dict[str, Any]]
+        __dataclass_params__: ClassVar[Any]  # in reality `dataclasses._DataclassParams`
+        __post_init__: ClassVar[Callable[..., None]]
+
+        # Added by pydantic
+        __pydantic_run_validation__: ClassVar[bool]
+        __post_init_post_parse__: ClassVar[Callable[..., None]]
+        __pydantic_initialised__: ClassVar[bool]
+        __pydantic_model__: ClassVar[Type[BaseModel]]
+        __pydantic_validate_values__: ClassVar[Callable[['Dataclass'], None]]
+        __pydantic_has_field_info_default__: ClassVar[bool]  # whether a `pydantic.Field` is used as default value
+
+        def __init__(self, *args: object, **kwargs: object) -> None:
+            pass
+
+        @classmethod
+        def __get_validators__(cls: Type['Dataclass']) -> 'CallableGenerator':
+            pass
+
+        @classmethod
+        def __validate__(cls: Type['DataclassT'], v: Any) -> 'DataclassT':
+            pass
+
+
+__all__ = [
+    'dataclass',
+    'set_validation',
+    'create_pydantic_model_from_dataclass',
+    'is_builtin_dataclass',
+    'make_dataclass_validator',
+]
+
+_T = TypeVar('_T')
+
+if sys.version_info >= (3, 10):
+
+    @dataclass_transform(kw_only_default=True, field_descriptors=(Field, FieldInfo))
+    @overload
+    def dataclass(
+        *,
+        init: bool = True,
+        repr: bool = True,
+        eq: bool = True,
+        order: bool = False,
+        unsafe_hash: bool = False,
+        frozen: bool = False,
+        config: Union[ConfigDict, Type[object], None] = None,
+        validate_on_init: Optional[bool] = None,
+        kw_only: bool = ...,
+    ) -> Callable[[Type[_T]], 'DataclassClassOrWrapper']:
+        ...
+
+    @dataclass_transform(kw_only_default=True, field_descriptors=(Field, FieldInfo))
+    @overload
+    def dataclass(
+        _cls: Type[_T],
+        *,
+        init: bool = True,
+        repr: bool = True,
+        eq: bool = True,
+        order: bool = False,
+        unsafe_hash: bool = False,
+        frozen: bool = False,
+        config: Union[ConfigDict, Type[object], None] = None,
+        validate_on_init: Optional[bool] = None,
+        kw_only: bool = ...,
+    ) -> 'DataclassClassOrWrapper':
+        ...
+
+else:
+
+    @dataclass_transform(kw_only_default=True, field_descriptors=(Field, FieldInfo))
+    @overload
+    def dataclass(
+        *,
+        init: bool = True,
+        repr: bool = True,
+        eq: bool = True,
+        order: bool = False,
+        unsafe_hash: bool = False,
+        frozen: bool = False,
+        config: Union[ConfigDict, Type[object], None] = None,
+        validate_on_init: Optional[bool] = None,
+    ) -> Callable[[Type[_T]], 'DataclassClassOrWrapper']:
+        ...
+
+    @dataclass_transform(kw_only_default=True, field_descriptors=(Field, FieldInfo))
+    @overload
+    def dataclass(
+        _cls: Type[_T],
+        *,
+        init: bool = True,
+        repr: bool = True,
+        eq: bool = True,
+        order: bool = False,
+        unsafe_hash: bool = False,
+        frozen: bool = False,
+        config: Union[ConfigDict, Type[object], None] = None,
+        validate_on_init: Optional[bool] = None,
+    ) -> 'DataclassClassOrWrapper':
+        ...
+
+
+@dataclass_transform(kw_only_default=True, field_descriptors=(Field, FieldInfo))
+def dataclass(
+    _cls: Optional[Type[_T]] = None,
+    *,
+    init: bool = True,
+    repr: bool = True,
+    eq: bool = True,
+    order: bool = False,
+    unsafe_hash: bool = False,
+    frozen: bool = False,
+    config: Union[ConfigDict, Type[object], None] = None,
+    validate_on_init: Optional[bool] = None,
+    kw_only: bool = False,
+) -> Union[Callable[[Type[_T]], 'DataclassClassOrWrapper'], 'DataclassClassOrWrapper']:
+    """
+    Like the python standard lib dataclasses but with type validation.
+    The result is either a pydantic dataclass that will validate input data
+    or a wrapper that will trigger validation around a stdlib dataclass
+    to avoid modifying it directly
+    """
+    the_config = get_config(config)
+
+    def wrap(cls: Type[Any]) -> 'DataclassClassOrWrapper':
+        import dataclasses
+
+        if is_builtin_dataclass(cls) and _extra_dc_args(_cls) == _extra_dc_args(_cls.__bases__[0]):  # type: ignore
+            dc_cls_doc = ''
+            dc_cls = DataclassProxy(cls)
+            default_validate_on_init = False
+        else:
+            dc_cls_doc = cls.__doc__ or ''  # needs to be done before generating dataclass
+            if sys.version_info >= (3, 10):
+                dc_cls = dataclasses.dataclass(
+                    cls,
+                    init=init,
+                    repr=repr,
+                    eq=eq,
+                    order=order,
+                    unsafe_hash=unsafe_hash,
+                    frozen=frozen,
+                    kw_only=kw_only,
+                )
+            else:
+                dc_cls = dataclasses.dataclass(  # type: ignore
+                    cls, init=init, repr=repr, eq=eq, order=order, unsafe_hash=unsafe_hash, frozen=frozen
+                )
+            default_validate_on_init = True
+
+        should_validate_on_init = default_validate_on_init if validate_on_init is None else validate_on_init
+        _add_pydantic_validation_attributes(cls, the_config, should_validate_on_init, dc_cls_doc)
+        dc_cls.__pydantic_model__.__try_update_forward_refs__(**{cls.__name__: cls})
+        return dc_cls
+
+    if _cls is None:
+        return wrap
+
+    return wrap(_cls)
+
+
+@contextmanager
+def set_validation(cls: Type['DataclassT'], value: bool) -> Generator[Type['DataclassT'], None, None]:
+    original_run_validation = cls.__pydantic_run_validation__
+    try:
+        cls.__pydantic_run_validation__ = value
+        yield cls
+    finally:
+        cls.__pydantic_run_validation__ = original_run_validation
+
+
+class DataclassProxy:
+    __slots__ = '__dataclass__'
+
+    def __init__(self, dc_cls: Type['Dataclass']) -> None:
+        object.__setattr__(self, '__dataclass__', dc_cls)
+
+    def __call__(self, *args: Any, **kwargs: Any) -> Any:
+        with set_validation(self.__dataclass__, True):
+            return self.__dataclass__(*args, **kwargs)
+
+    def __getattr__(self, name: str) -> Any:
+        return getattr(self.__dataclass__, name)
+
+    def __instancecheck__(self, instance: Any) -> bool:
+        return isinstance(instance, self.__dataclass__)
+
+
+def _add_pydantic_validation_attributes(  # noqa: C901 (ignore complexity)
+    dc_cls: Type['Dataclass'],
+    config: Type[BaseConfig],
+    validate_on_init: bool,
+    dc_cls_doc: str,
+) -> None:
+    """
+    We need to replace the right method. If no `__post_init__` has been set in the stdlib dataclass
+    it won't even exist (code is generated on the fly by `dataclasses`)
+    By default, we run validation after `__init__` or `__post_init__` if defined
+    """
+    init = dc_cls.__init__
+
+    @wraps(init)
+    def handle_extra_init(self: 'Dataclass', *args: Any, **kwargs: Any) -> None:
+        if config.extra == Extra.ignore:
+            init(self, *args, **{k: v for k, v in kwargs.items() if k in self.__dataclass_fields__})
+
+        elif config.extra == Extra.allow:
+            for k, v in kwargs.items():
+                self.__dict__.setdefault(k, v)
+            init(self, *args, **{k: v for k, v in kwargs.items() if k in self.__dataclass_fields__})
+
+        else:
+            init(self, *args, **kwargs)
+
+    if hasattr(dc_cls, '__post_init__'):
+        post_init = dc_cls.__post_init__
+
+        @wraps(post_init)
+        def new_post_init(self: 'Dataclass', *args: Any, **kwargs: Any) -> None:
+            if config.post_init_call == 'before_validation':
+                post_init(self, *args, **kwargs)
+
+            if self.__class__.__pydantic_run_validation__:
+                self.__pydantic_validate_values__()
+                if hasattr(self, '__post_init_post_parse__'):
+                    self.__post_init_post_parse__(*args, **kwargs)
+
+            if config.post_init_call == 'after_validation':
+                post_init(self, *args, **kwargs)
+
+        setattr(dc_cls, '__init__', handle_extra_init)
+        setattr(dc_cls, '__post_init__', new_post_init)
+
+    else:
+
+        @wraps(init)
+        def new_init(self: 'Dataclass', *args: Any, **kwargs: Any) -> None:
+            handle_extra_init(self, *args, **kwargs)
+
+            if self.__class__.__pydantic_run_validation__:
+                self.__pydantic_validate_values__()
+
+            if hasattr(self, '__post_init_post_parse__'):
+                # We need to find again the initvars. To do that we use `__dataclass_fields__` instead of
+                # public method `dataclasses.fields`
+                import dataclasses
+
+                # get all initvars and their default values
+                initvars_and_values: Dict[str, Any] = {}
+                for i, f in enumerate(self.__class__.__dataclass_fields__.values()):
+                    if f._field_type is dataclasses._FIELD_INITVAR:  # type: ignore[attr-defined]
+                        try:
+                            # set arg value by default
+                            initvars_and_values[f.name] = args[i]
+                        except IndexError:
+                            initvars_and_values[f.name] = kwargs.get(f.name, f.default)
+
+                self.__post_init_post_parse__(**initvars_and_values)
+
+        setattr(dc_cls, '__init__', new_init)
+
+    setattr(dc_cls, '__pydantic_run_validation__', ClassAttribute('__pydantic_run_validation__', validate_on_init))
+    setattr(dc_cls, '__pydantic_initialised__', False)
+    setattr(dc_cls, '__pydantic_model__', create_pydantic_model_from_dataclass(dc_cls, config, dc_cls_doc))
+    setattr(dc_cls, '__pydantic_validate_values__', _dataclass_validate_values)
+    setattr(dc_cls, '__validate__', classmethod(_validate_dataclass))
+    setattr(dc_cls, '__get_validators__', classmethod(_get_validators))
+
+    if dc_cls.__pydantic_model__.__config__.validate_assignment and not dc_cls.__dataclass_params__.frozen:
+        setattr(dc_cls, '__setattr__', _dataclass_validate_assignment_setattr)
+
+
+def _get_validators(cls: 'DataclassClassOrWrapper') -> 'CallableGenerator':
+    yield cls.__validate__
+
+
+def _validate_dataclass(cls: Type['DataclassT'], v: Any) -> 'DataclassT':
+    with set_validation(cls, True):
+        if isinstance(v, cls):
+            v.__pydantic_validate_values__()
+            return v
+        elif isinstance(v, (list, tuple)):
+            return cls(*v)
+        elif isinstance(v, dict):
+            return cls(**v)
+        else:
+            raise DataclassTypeError(class_name=cls.__name__)
+
+
+def create_pydantic_model_from_dataclass(
+    dc_cls: Type['Dataclass'],
+    config: Type[Any] = BaseConfig,
+    dc_cls_doc: Optional[str] = None,
+) -> Type['BaseModel']:
+    import dataclasses
+
+    field_definitions: Dict[str, Any] = {}
+    for field in dataclasses.fields(dc_cls):
+        default: Any = Undefined
+        default_factory: Optional['NoArgAnyCallable'] = None
+        field_info: FieldInfo
+
+        if field.default is not dataclasses.MISSING:
+            default = field.default
+        elif field.default_factory is not dataclasses.MISSING:
+            default_factory = field.default_factory
+        else:
+            default = Required
+
+        if isinstance(default, FieldInfo):
+            field_info = default
+            dc_cls.__pydantic_has_field_info_default__ = True
+        else:
+            field_info = Field(default=default, default_factory=default_factory, **field.metadata)
+
+        field_definitions[field.name] = (field.type, field_info)
+
+    validators = gather_all_validators(dc_cls)
+    model: Type['BaseModel'] = create_model(
+        dc_cls.__name__,
+        __config__=config,
+        __module__=dc_cls.__module__,
+        __validators__=validators,
+        __cls_kwargs__={'__resolve_forward_refs__': False},
+        **field_definitions,
+    )
+    model.__doc__ = dc_cls_doc if dc_cls_doc is not None else dc_cls.__doc__ or ''
+    return model
+
+
+def _dataclass_validate_values(self: 'Dataclass') -> None:
+    # validation errors can occur if this function is called twice on an already initialised dataclass.
+    # for example if Extra.forbid is enabled, it would consider __pydantic_initialised__ an invalid extra property
+    if getattr(self, '__pydantic_initialised__'):
+        return
+    if getattr(self, '__pydantic_has_field_info_default__', False):
+        # We need to remove `FieldInfo` values since they are not valid as input
+        # It's ok to do that because they are obviously the default values!
+        input_data = {k: v for k, v in self.__dict__.items() if not isinstance(v, FieldInfo)}
+    else:
+        input_data = self.__dict__
+    d, _, validation_error = validate_model(self.__pydantic_model__, input_data, cls=self.__class__)
+    if validation_error:
+        raise validation_error
+    self.__dict__.update(d)
+    object.__setattr__(self, '__pydantic_initialised__', True)
+
+
+def _dataclass_validate_assignment_setattr(self: 'Dataclass', name: str, value: Any) -> None:
+    if self.__pydantic_initialised__:
+        d = dict(self.__dict__)
+        d.pop(name, None)
+        known_field = self.__pydantic_model__.__fields__.get(name, None)
+        if known_field:
+            value, error_ = known_field.validate(value, d, loc=name, cls=self.__class__)
+            if error_:
+                raise ValidationError([error_], self.__class__)
+
+    object.__setattr__(self, name, value)
+
+
+def _extra_dc_args(cls: Type[Any]) -> Set[str]:
+    return {
+        x
+        for x in dir(cls)
+        if x not in getattr(cls, '__dataclass_fields__', {}) and not (x.startswith('__') and x.endswith('__'))
+    }
+
+
+def is_builtin_dataclass(_cls: Type[Any]) -> bool:
+    """
+    Whether a class is a stdlib dataclass
+    (useful to discriminated a pydantic dataclass that is actually a wrapper around a stdlib dataclass)
+
+    we check that
+    - `_cls` is a dataclass
+    - `_cls` is not a processed pydantic dataclass (with a basemodel attached)
+    - `_cls` is not a pydantic dataclass inheriting directly from a stdlib dataclass
+    e.g.
+    ```
+    @dataclasses.dataclass
+    class A:
+        x: int
+
+    @pydantic.dataclasses.dataclass
+    class B(A):
+        y: int
+    ```
+    In this case, when we first check `B`, we make an extra check and look at the annotations ('y'),
+    which won't be a superset of all the dataclass fields (only the stdlib fields i.e. 'x')
+    """
+    import dataclasses
+
+    return (
+        dataclasses.is_dataclass(_cls)
+        and not hasattr(_cls, '__pydantic_model__')
+        and set(_cls.__dataclass_fields__).issuperset(set(getattr(_cls, '__annotations__', {})))
+    )
+
+
+def make_dataclass_validator(dc_cls: Type['Dataclass'], config: Type[BaseConfig]) -> 'CallableGenerator':
+    """
+    Create a pydantic.dataclass from a builtin dataclass to add type validation
+    and yield the validators
+    It retrieves the parameters of the dataclass and forwards them to the newly created dataclass
+    """
+    yield from _get_validators(dataclass(dc_cls, config=config, validate_on_init=False))
diff --git a/lib/pydantic/datetime_parse.py b/lib/pydantic/datetime_parse.py
new file mode 100644
index 00000000..cfd54593
--- /dev/null
+++ b/lib/pydantic/datetime_parse.py
@@ -0,0 +1,248 @@
+"""
+Functions to parse datetime objects.
+
+We're using regular expressions rather than time.strptime because:
+- They provide both validation and parsing.
+- They're more flexible for datetimes.
+- The date/datetime/time constructors produce friendlier error messages.
+
+Stolen from https://raw.githubusercontent.com/django/django/main/django/utils/dateparse.py at
+9718fa2e8abe430c3526a9278dd976443d4ae3c6
+
+Changed to:
+* use standard python datetime types not django.utils.timezone
+* raise ValueError when regex doesn't match rather than returning None
+* support parsing unix timestamps for dates and datetimes
+"""
+import re
+from datetime import date, datetime, time, timedelta, timezone
+from typing import Dict, Optional, Type, Union
+
+from . import errors
+
+date_expr = r'(?P<year>\d{4})-(?P<month>\d{1,2})-(?P<day>\d{1,2})'
+time_expr = (
+    r'(?P<hour>\d{1,2}):(?P<minute>\d{1,2})'
+    r'(?::(?P<second>\d{1,2})(?:\.(?P<microsecond>\d{1,6})\d{0,6})?)?'
+    r'(?P<tzinfo>Z|[+-]\d{2}(?::?\d{2})?)?$'
+)
+
+date_re = re.compile(f'{date_expr}$')
+time_re = re.compile(time_expr)
+datetime_re = re.compile(f'{date_expr}[T ]{time_expr}')
+
+standard_duration_re = re.compile(
+    r'^'
+    r'(?:(?P<days>-?\d+) (days?, )?)?'
+    r'((?:(?P<hours>-?\d+):)(?=\d+:\d+))?'
+    r'(?:(?P<minutes>-?\d+):)?'
+    r'(?P<seconds>-?\d+)'
+    r'(?:\.(?P<microseconds>\d{1,6})\d{0,6})?'
+    r'$'
+)
+
+# Support the sections of ISO 8601 date representation that are accepted by timedelta
+iso8601_duration_re = re.compile(
+    r'^(?P<sign>[-+]?)'
+    r'P'
+    r'(?:(?P<days>\d+(.\d+)?)D)?'
+    r'(?:T'
+    r'(?:(?P<hours>\d+(.\d+)?)H)?'
+    r'(?:(?P<minutes>\d+(.\d+)?)M)?'
+    r'(?:(?P<seconds>\d+(.\d+)?)S)?'
+    r')?'
+    r'$'
+)
+
+EPOCH = datetime(1970, 1, 1)
+# if greater than this, the number is in ms, if less than or equal it's in seconds
+# (in seconds this is 11th October 2603, in ms it's 20th August 1970)
+MS_WATERSHED = int(2e10)
+# slightly more than datetime.max in ns - (datetime.max - EPOCH).total_seconds() * 1e9
+MAX_NUMBER = int(3e20)
+StrBytesIntFloat = Union[str, bytes, int, float]
+
+
+def get_numeric(value: StrBytesIntFloat, native_expected_type: str) -> Union[None, int, float]:
+    if isinstance(value, (int, float)):
+        return value
+    try:
+        return float(value)
+    except ValueError:
+        return None
+    except TypeError:
+        raise TypeError(f'invalid type; expected {native_expected_type}, string, bytes, int or float')
+
+
+def from_unix_seconds(seconds: Union[int, float]) -> datetime:
+    if seconds > MAX_NUMBER:
+        return datetime.max
+    elif seconds < -MAX_NUMBER:
+        return datetime.min
+
+    while abs(seconds) > MS_WATERSHED:
+        seconds /= 1000
+    dt = EPOCH + timedelta(seconds=seconds)
+    return dt.replace(tzinfo=timezone.utc)
+
+
+def _parse_timezone(value: Optional[str], error: Type[Exception]) -> Union[None, int, timezone]:
+    if value == 'Z':
+        return timezone.utc
+    elif value is not None:
+        offset_mins = int(value[-2:]) if len(value) > 3 else 0
+        offset = 60 * int(value[1:3]) + offset_mins
+        if value[0] == '-':
+            offset = -offset
+        try:
+            return timezone(timedelta(minutes=offset))
+        except ValueError:
+            raise error()
+    else:
+        return None
+
+
+def parse_date(value: Union[date, StrBytesIntFloat]) -> date:
+    """
+    Parse a date/int/float/string and return a datetime.date.
+
+    Raise ValueError if the input is well formatted but not a valid date.
+    Raise ValueError if the input isn't well formatted.
+    """
+    if isinstance(value, date):
+        if isinstance(value, datetime):
+            return value.date()
+        else:
+            return value
+
+    number = get_numeric(value, 'date')
+    if number is not None:
+        return from_unix_seconds(number).date()
+
+    if isinstance(value, bytes):
+        value = value.decode()
+
+    match = date_re.match(value)  # type: ignore
+    if match is None:
+        raise errors.DateError()
+
+    kw = {k: int(v) for k, v in match.groupdict().items()}
+
+    try:
+        return date(**kw)
+    except ValueError:
+        raise errors.DateError()
+
+
+def parse_time(value: Union[time, StrBytesIntFloat]) -> time:
+    """
+    Parse a time/string and return a datetime.time.
+
+    Raise ValueError if the input is well formatted but not a valid time.
+    Raise ValueError if the input isn't well formatted, in particular if it contains an offset.
+    """
+    if isinstance(value, time):
+        return value
+
+    number = get_numeric(value, 'time')
+    if number is not None:
+        if number >= 86400:
+            # doesn't make sense since the time time loop back around to 0
+            raise errors.TimeError()
+        return (datetime.min + timedelta(seconds=number)).time()
+
+    if isinstance(value, bytes):
+        value = value.decode()
+
+    match = time_re.match(value)  # type: ignore
+    if match is None:
+        raise errors.TimeError()
+
+    kw = match.groupdict()
+    if kw['microsecond']:
+        kw['microsecond'] = kw['microsecond'].ljust(6, '0')
+
+    tzinfo = _parse_timezone(kw.pop('tzinfo'), errors.TimeError)
+    kw_: Dict[str, Union[None, int, timezone]] = {k: int(v) for k, v in kw.items() if v is not None}
+    kw_['tzinfo'] = tzinfo
+
+    try:
+        return time(**kw_)  # type: ignore
+    except ValueError:
+        raise errors.TimeError()
+
+
+def parse_datetime(value: Union[datetime, StrBytesIntFloat]) -> datetime:
+    """
+    Parse a datetime/int/float/string and return a datetime.datetime.
+
+    This function supports time zone offsets. When the input contains one,
+    the output uses a timezone with a fixed offset from UTC.
+
+    Raise ValueError if the input is well formatted but not a valid datetime.
+    Raise ValueError if the input isn't well formatted.
+    """
+    if isinstance(value, datetime):
+        return value
+
+    number = get_numeric(value, 'datetime')
+    if number is not None:
+        return from_unix_seconds(number)
+
+    if isinstance(value, bytes):
+        value = value.decode()
+
+    match = datetime_re.match(value)  # type: ignore
+    if match is None:
+        raise errors.DateTimeError()
+
+    kw = match.groupdict()
+    if kw['microsecond']:
+        kw['microsecond'] = kw['microsecond'].ljust(6, '0')
+
+    tzinfo = _parse_timezone(kw.pop('tzinfo'), errors.DateTimeError)
+    kw_: Dict[str, Union[None, int, timezone]] = {k: int(v) for k, v in kw.items() if v is not None}
+    kw_['tzinfo'] = tzinfo
+
+    try:
+        return datetime(**kw_)  # type: ignore
+    except ValueError:
+        raise errors.DateTimeError()
+
+
+def parse_duration(value: StrBytesIntFloat) -> timedelta:
+    """
+    Parse a duration int/float/string and return a datetime.timedelta.
+
+    The preferred format for durations in Django is '%d %H:%M:%S.%f'.
+
+    Also supports ISO 8601 representation.
+    """
+    if isinstance(value, timedelta):
+        return value
+
+    if isinstance(value, (int, float)):
+        # below code requires a string
+        value = f'{value:f}'
+    elif isinstance(value, bytes):
+        value = value.decode()
+
+    try:
+        match = standard_duration_re.match(value) or iso8601_duration_re.match(value)
+    except TypeError:
+        raise TypeError('invalid type; expected timedelta, string, bytes, int or float')
+
+    if not match:
+        raise errors.DurationError()
+
+    kw = match.groupdict()
+    sign = -1 if kw.pop('sign', '+') == '-' else 1
+    if kw.get('microseconds'):
+        kw['microseconds'] = kw['microseconds'].ljust(6, '0')
+
+    if kw.get('seconds') and kw.get('microseconds') and kw['seconds'].startswith('-'):
+        kw['microseconds'] = '-' + kw['microseconds']
+
+    kw_ = {k: float(v) for k, v in kw.items() if v is not None}
+
+    return sign * timedelta(**kw_)
diff --git a/lib/pydantic/decorator.py b/lib/pydantic/decorator.py
new file mode 100644
index 00000000..089aab65
--- /dev/null
+++ b/lib/pydantic/decorator.py
@@ -0,0 +1,264 @@
+from functools import wraps
+from typing import TYPE_CHECKING, Any, Callable, Dict, List, Mapping, Optional, Tuple, Type, TypeVar, Union, overload
+
+from . import validator
+from .config import Extra
+from .errors import ConfigError
+from .main import BaseModel, create_model
+from .typing import get_all_type_hints
+from .utils import to_camel
+
+__all__ = ('validate_arguments',)
+
+if TYPE_CHECKING:
+    from .typing import AnyCallable
+
+    AnyCallableT = TypeVar('AnyCallableT', bound=AnyCallable)
+    ConfigType = Union[None, Type[Any], Dict[str, Any]]
+
+
+@overload
+def validate_arguments(func: None = None, *, config: 'ConfigType' = None) -> Callable[['AnyCallableT'], 'AnyCallableT']:
+    ...
+
+
+@overload
+def validate_arguments(func: 'AnyCallableT') -> 'AnyCallableT':
+    ...
+
+
+def validate_arguments(func: Optional['AnyCallableT'] = None, *, config: 'ConfigType' = None) -> Any:
+    """
+    Decorator to validate the arguments passed to a function.
+    """
+
+    def validate(_func: 'AnyCallable') -> 'AnyCallable':
+        vd = ValidatedFunction(_func, config)
+
+        @wraps(_func)
+        def wrapper_function(*args: Any, **kwargs: Any) -> Any:
+            return vd.call(*args, **kwargs)
+
+        wrapper_function.vd = vd  # type: ignore
+        wrapper_function.validate = vd.init_model_instance  # type: ignore
+        wrapper_function.raw_function = vd.raw_function  # type: ignore
+        wrapper_function.model = vd.model  # type: ignore
+        return wrapper_function
+
+    if func:
+        return validate(func)
+    else:
+        return validate
+
+
+ALT_V_ARGS = 'v__args'
+ALT_V_KWARGS = 'v__kwargs'
+V_POSITIONAL_ONLY_NAME = 'v__positional_only'
+V_DUPLICATE_KWARGS = 'v__duplicate_kwargs'
+
+
+class ValidatedFunction:
+    def __init__(self, function: 'AnyCallableT', config: 'ConfigType'):  # noqa C901
+        from inspect import Parameter, signature
+
+        parameters: Mapping[str, Parameter] = signature(function).parameters
+
+        if parameters.keys() & {ALT_V_ARGS, ALT_V_KWARGS, V_POSITIONAL_ONLY_NAME, V_DUPLICATE_KWARGS}:
+            raise ConfigError(
+                f'"{ALT_V_ARGS}", "{ALT_V_KWARGS}", "{V_POSITIONAL_ONLY_NAME}" and "{V_DUPLICATE_KWARGS}" '
+                f'are not permitted as argument names when using the "{validate_arguments.__name__}" decorator'
+            )
+
+        self.raw_function = function
+        self.arg_mapping: Dict[int, str] = {}
+        self.positional_only_args = set()
+        self.v_args_name = 'args'
+        self.v_kwargs_name = 'kwargs'
+
+        type_hints = get_all_type_hints(function)
+        takes_args = False
+        takes_kwargs = False
+        fields: Dict[str, Tuple[Any, Any]] = {}
+        for i, (name, p) in enumerate(parameters.items()):
+            if p.annotation is p.empty:
+                annotation = Any
+            else:
+                annotation = type_hints[name]
+
+            default = ... if p.default is p.empty else p.default
+            if p.kind == Parameter.POSITIONAL_ONLY:
+                self.arg_mapping[i] = name
+                fields[name] = annotation, default
+                fields[V_POSITIONAL_ONLY_NAME] = List[str], None
+                self.positional_only_args.add(name)
+            elif p.kind == Parameter.POSITIONAL_OR_KEYWORD:
+                self.arg_mapping[i] = name
+                fields[name] = annotation, default
+                fields[V_DUPLICATE_KWARGS] = List[str], None
+            elif p.kind == Parameter.KEYWORD_ONLY:
+                fields[name] = annotation, default
+            elif p.kind == Parameter.VAR_POSITIONAL:
+                self.v_args_name = name
+                fields[name] = Tuple[annotation, ...], None
+                takes_args = True
+            else:
+                assert p.kind == Parameter.VAR_KEYWORD, p.kind
+                self.v_kwargs_name = name
+                fields[name] = Dict[str, annotation], None  # type: ignore
+                takes_kwargs = True
+
+        # these checks avoid a clash between "args" and a field with that name
+        if not takes_args and self.v_args_name in fields:
+            self.v_args_name = ALT_V_ARGS
+
+        # same with "kwargs"
+        if not takes_kwargs and self.v_kwargs_name in fields:
+            self.v_kwargs_name = ALT_V_KWARGS
+
+        if not takes_args:
+            # we add the field so validation below can raise the correct exception
+            fields[self.v_args_name] = List[Any], None
+
+        if not takes_kwargs:
+            # same with kwargs
+            fields[self.v_kwargs_name] = Dict[Any, Any], None
+
+        self.create_model(fields, takes_args, takes_kwargs, config)
+
+    def init_model_instance(self, *args: Any, **kwargs: Any) -> BaseModel:
+        values = self.build_values(args, kwargs)
+        return self.model(**values)
+
+    def call(self, *args: Any, **kwargs: Any) -> Any:
+        m = self.init_model_instance(*args, **kwargs)
+        return self.execute(m)
+
+    def build_values(self, args: Tuple[Any, ...], kwargs: Dict[str, Any]) -> Dict[str, Any]:
+        values: Dict[str, Any] = {}
+        if args:
+            arg_iter = enumerate(args)
+            while True:
+                try:
+                    i, a = next(arg_iter)
+                except StopIteration:
+                    break
+                arg_name = self.arg_mapping.get(i)
+                if arg_name is not None:
+                    values[arg_name] = a
+                else:
+                    values[self.v_args_name] = [a] + [a for _, a in arg_iter]
+                    break
+
+        var_kwargs: Dict[str, Any] = {}
+        wrong_positional_args = []
+        duplicate_kwargs = []
+        fields_alias = [
+            field.alias
+            for name, field in self.model.__fields__.items()
+            if name not in (self.v_args_name, self.v_kwargs_name)
+        ]
+        non_var_fields = set(self.model.__fields__) - {self.v_args_name, self.v_kwargs_name}
+        for k, v in kwargs.items():
+            if k in non_var_fields or k in fields_alias:
+                if k in self.positional_only_args:
+                    wrong_positional_args.append(k)
+                if k in values:
+                    duplicate_kwargs.append(k)
+                values[k] = v
+            else:
+                var_kwargs[k] = v
+
+        if var_kwargs:
+            values[self.v_kwargs_name] = var_kwargs
+        if wrong_positional_args:
+            values[V_POSITIONAL_ONLY_NAME] = wrong_positional_args
+        if duplicate_kwargs:
+            values[V_DUPLICATE_KWARGS] = duplicate_kwargs
+        return values
+
+    def execute(self, m: BaseModel) -> Any:
+        d = {k: v for k, v in m._iter() if k in m.__fields_set__ or m.__fields__[k].default_factory}
+        var_kwargs = d.pop(self.v_kwargs_name, {})
+
+        if self.v_args_name in d:
+            args_: List[Any] = []
+            in_kwargs = False
+            kwargs = {}
+            for name, value in d.items():
+                if in_kwargs:
+                    kwargs[name] = value
+                elif name == self.v_args_name:
+                    args_ += value
+                    in_kwargs = True
+                else:
+                    args_.append(value)
+            return self.raw_function(*args_, **kwargs, **var_kwargs)
+        elif self.positional_only_args:
+            args_ = []
+            kwargs = {}
+            for name, value in d.items():
+                if name in self.positional_only_args:
+                    args_.append(value)
+                else:
+                    kwargs[name] = value
+            return self.raw_function(*args_, **kwargs, **var_kwargs)
+        else:
+            return self.raw_function(**d, **var_kwargs)
+
+    def create_model(self, fields: Dict[str, Any], takes_args: bool, takes_kwargs: bool, config: 'ConfigType') -> None:
+        pos_args = len(self.arg_mapping)
+
+        class CustomConfig:
+            pass
+
+        if not TYPE_CHECKING:  # pragma: no branch
+            if isinstance(config, dict):
+                CustomConfig = type('Config', (), config)  # noqa: F811
+            elif config is not None:
+                CustomConfig = config  # noqa: F811
+
+        if hasattr(CustomConfig, 'fields') or hasattr(CustomConfig, 'alias_generator'):
+            raise ConfigError(
+                'Setting the "fields" and "alias_generator" property on custom Config for '
+                '@validate_arguments is not yet supported, please remove.'
+            )
+
+        class DecoratorBaseModel(BaseModel):
+            @validator(self.v_args_name, check_fields=False, allow_reuse=True)
+            def check_args(cls, v: Optional[List[Any]]) -> Optional[List[Any]]:
+                if takes_args or v is None:
+                    return v
+
+                raise TypeError(f'{pos_args} positional arguments expected but {pos_args + len(v)} given')
+
+            @validator(self.v_kwargs_name, check_fields=False, allow_reuse=True)
+            def check_kwargs(cls, v: Optional[Dict[str, Any]]) -> Optional[Dict[str, Any]]:
+                if takes_kwargs or v is None:
+                    return v
+
+                plural = '' if len(v) == 1 else 's'
+                keys = ', '.join(map(repr, v.keys()))
+                raise TypeError(f'unexpected keyword argument{plural}: {keys}')
+
+            @validator(V_POSITIONAL_ONLY_NAME, check_fields=False, allow_reuse=True)
+            def check_positional_only(cls, v: Optional[List[str]]) -> None:
+                if v is None:
+                    return
+
+                plural = '' if len(v) == 1 else 's'
+                keys = ', '.join(map(repr, v))
+                raise TypeError(f'positional-only argument{plural} passed as keyword argument{plural}: {keys}')
+
+            @validator(V_DUPLICATE_KWARGS, check_fields=False, allow_reuse=True)
+            def check_duplicate_kwargs(cls, v: Optional[List[str]]) -> None:
+                if v is None:
+                    return
+
+                plural = '' if len(v) == 1 else 's'
+                keys = ', '.join(map(repr, v))
+                raise TypeError(f'multiple values for argument{plural}: {keys}')
+
+            class Config(CustomConfig):
+                extra = getattr(CustomConfig, 'extra', Extra.forbid)
+
+        self.model = create_model(to_camel(self.raw_function.__name__), __base__=DecoratorBaseModel, **fields)
diff --git a/lib/pydantic/env_settings.py b/lib/pydantic/env_settings.py
new file mode 100644
index 00000000..e9988c01
--- /dev/null
+++ b/lib/pydantic/env_settings.py
@@ -0,0 +1,346 @@
+import os
+import warnings
+from pathlib import Path
+from typing import AbstractSet, Any, Callable, ClassVar, Dict, List, Mapping, Optional, Tuple, Type, Union
+
+from .config import BaseConfig, Extra
+from .fields import ModelField
+from .main import BaseModel
+from .typing import StrPath, display_as_type, get_origin, is_union
+from .utils import deep_update, path_type, sequence_like
+
+env_file_sentinel = str(object())
+
+SettingsSourceCallable = Callable[['BaseSettings'], Dict[str, Any]]
+DotenvType = Union[StrPath, List[StrPath], Tuple[StrPath, ...]]
+
+
+class SettingsError(ValueError):
+    pass
+
+
+class BaseSettings(BaseModel):
+    """
+    Base class for settings, allowing values to be overridden by environment variables.
+
+    This is useful in production for secrets you do not wish to save in code, it plays nicely with docker(-compose),
+    Heroku and any 12 factor app design.
+    """
+
+    def __init__(
+        __pydantic_self__,
+        _env_file: Optional[DotenvType] = env_file_sentinel,
+        _env_file_encoding: Optional[str] = None,
+        _env_nested_delimiter: Optional[str] = None,
+        _secrets_dir: Optional[StrPath] = None,
+        **values: Any,
+    ) -> None:
+        # Uses something other than `self` the first arg to allow "self" as a settable attribute
+        super().__init__(
+            **__pydantic_self__._build_values(
+                values,
+                _env_file=_env_file,
+                _env_file_encoding=_env_file_encoding,
+                _env_nested_delimiter=_env_nested_delimiter,
+                _secrets_dir=_secrets_dir,
+            )
+        )
+
+    def _build_values(
+        self,
+        init_kwargs: Dict[str, Any],
+        _env_file: Optional[DotenvType] = None,
+        _env_file_encoding: Optional[str] = None,
+        _env_nested_delimiter: Optional[str] = None,
+        _secrets_dir: Optional[StrPath] = None,
+    ) -> Dict[str, Any]:
+        # Configure built-in sources
+        init_settings = InitSettingsSource(init_kwargs=init_kwargs)
+        env_settings = EnvSettingsSource(
+            env_file=(_env_file if _env_file != env_file_sentinel else self.__config__.env_file),
+            env_file_encoding=(
+                _env_file_encoding if _env_file_encoding is not None else self.__config__.env_file_encoding
+            ),
+            env_nested_delimiter=(
+                _env_nested_delimiter if _env_nested_delimiter is not None else self.__config__.env_nested_delimiter
+            ),
+            env_prefix_len=len(self.__config__.env_prefix),
+        )
+        file_secret_settings = SecretsSettingsSource(secrets_dir=_secrets_dir or self.__config__.secrets_dir)
+        # Provide a hook to set built-in sources priority and add / remove sources
+        sources = self.__config__.customise_sources(
+            init_settings=init_settings, env_settings=env_settings, file_secret_settings=file_secret_settings
+        )
+        if sources:
+            return deep_update(*reversed([source(self) for source in sources]))
+        else:
+            # no one should mean to do this, but I think returning an empty dict is marginally preferable
+            # to an informative error and much better than a confusing error
+            return {}
+
+    class Config(BaseConfig):
+        env_prefix: str = ''
+        env_file: Optional[DotenvType] = None
+        env_file_encoding: Optional[str] = None
+        env_nested_delimiter: Optional[str] = None
+        secrets_dir: Optional[StrPath] = None
+        validate_all: bool = True
+        extra: Extra = Extra.forbid
+        arbitrary_types_allowed: bool = True
+        case_sensitive: bool = False
+
+        @classmethod
+        def prepare_field(cls, field: ModelField) -> None:
+            env_names: Union[List[str], AbstractSet[str]]
+            field_info_from_config = cls.get_field_info(field.name)
+
+            env = field_info_from_config.get('env') or field.field_info.extra.get('env')
+            if env is None:
+                if field.has_alias:
+                    warnings.warn(
+                        'aliases are no longer used by BaseSettings to define which environment variables to read. '
+                        'Instead use the "env" field setting. '
+                        'See https://pydantic-docs.helpmanual.io/usage/settings/#environment-variable-names',
+                        FutureWarning,
+                    )
+                env_names = {cls.env_prefix + field.name}
+            elif isinstance(env, str):
+                env_names = {env}
+            elif isinstance(env, (set, frozenset)):
+                env_names = env
+            elif sequence_like(env):
+                env_names = list(env)
+            else:
+                raise TypeError(f'invalid field env: {env!r} ({display_as_type(env)}); should be string, list or set')
+
+            if not cls.case_sensitive:
+                env_names = env_names.__class__(n.lower() for n in env_names)
+            field.field_info.extra['env_names'] = env_names
+
+        @classmethod
+        def customise_sources(
+            cls,
+            init_settings: SettingsSourceCallable,
+            env_settings: SettingsSourceCallable,
+            file_secret_settings: SettingsSourceCallable,
+        ) -> Tuple[SettingsSourceCallable, ...]:
+            return init_settings, env_settings, file_secret_settings
+
+        @classmethod
+        def parse_env_var(cls, field_name: str, raw_val: str) -> Any:
+            return cls.json_loads(raw_val)
+
+    # populated by the metaclass using the Config class defined above, annotated here to help IDEs only
+    __config__: ClassVar[Type[Config]]
+
+
+class InitSettingsSource:
+    __slots__ = ('init_kwargs',)
+
+    def __init__(self, init_kwargs: Dict[str, Any]):
+        self.init_kwargs = init_kwargs
+
+    def __call__(self, settings: BaseSettings) -> Dict[str, Any]:
+        return self.init_kwargs
+
+    def __repr__(self) -> str:
+        return f'InitSettingsSource(init_kwargs={self.init_kwargs!r})'
+
+
+class EnvSettingsSource:
+    __slots__ = ('env_file', 'env_file_encoding', 'env_nested_delimiter', 'env_prefix_len')
+
+    def __init__(
+        self,
+        env_file: Optional[DotenvType],
+        env_file_encoding: Optional[str],
+        env_nested_delimiter: Optional[str] = None,
+        env_prefix_len: int = 0,
+    ):
+        self.env_file: Optional[DotenvType] = env_file
+        self.env_file_encoding: Optional[str] = env_file_encoding
+        self.env_nested_delimiter: Optional[str] = env_nested_delimiter
+        self.env_prefix_len: int = env_prefix_len
+
+    def __call__(self, settings: BaseSettings) -> Dict[str, Any]:  # noqa C901
+        """
+        Build environment variables suitable for passing to the Model.
+        """
+        d: Dict[str, Any] = {}
+
+        if settings.__config__.case_sensitive:
+            env_vars: Mapping[str, Optional[str]] = os.environ
+        else:
+            env_vars = {k.lower(): v for k, v in os.environ.items()}
+
+        dotenv_vars = self._read_env_files(settings.__config__.case_sensitive)
+        if dotenv_vars:
+            env_vars = {**dotenv_vars, **env_vars}
+
+        for field in settings.__fields__.values():
+            env_val: Optional[str] = None
+            for env_name in field.field_info.extra['env_names']:
+                env_val = env_vars.get(env_name)
+                if env_val is not None:
+                    break
+
+            is_complex, allow_parse_failure = self.field_is_complex(field)
+            if is_complex:
+                if env_val is None:
+                    # field is complex but no value found so far, try explode_env_vars
+                    env_val_built = self.explode_env_vars(field, env_vars)
+                    if env_val_built:
+                        d[field.alias] = env_val_built
+                else:
+                    # field is complex and there's a value, decode that as JSON, then add explode_env_vars
+                    try:
+                        env_val = settings.__config__.parse_env_var(field.name, env_val)
+                    except ValueError as e:
+                        if not allow_parse_failure:
+                            raise SettingsError(f'error parsing env var "{env_name}"') from e
+
+                    if isinstance(env_val, dict):
+                        d[field.alias] = deep_update(env_val, self.explode_env_vars(field, env_vars))
+                    else:
+                        d[field.alias] = env_val
+            elif env_val is not None:
+                # simplest case, field is not complex, we only need to add the value if it was found
+                d[field.alias] = env_val
+
+        return d
+
+    def _read_env_files(self, case_sensitive: bool) -> Dict[str, Optional[str]]:
+        env_files = self.env_file
+        if env_files is None:
+            return {}
+
+        if isinstance(env_files, (str, os.PathLike)):
+            env_files = [env_files]
+
+        dotenv_vars = {}
+        for env_file in env_files:
+            env_path = Path(env_file).expanduser()
+            if env_path.is_file():
+                dotenv_vars.update(
+                    read_env_file(env_path, encoding=self.env_file_encoding, case_sensitive=case_sensitive)
+                )
+
+        return dotenv_vars
+
+    def field_is_complex(self, field: ModelField) -> Tuple[bool, bool]:
+        """
+        Find out if a field is complex, and if so whether JSON errors should be ignored
+        """
+        if field.is_complex():
+            allow_parse_failure = False
+        elif is_union(get_origin(field.type_)) and field.sub_fields and any(f.is_complex() for f in field.sub_fields):
+            allow_parse_failure = True
+        else:
+            return False, False
+
+        return True, allow_parse_failure
+
+    def explode_env_vars(self, field: ModelField, env_vars: Mapping[str, Optional[str]]) -> Dict[str, Any]:
+        """
+        Process env_vars and extract the values of keys containing env_nested_delimiter into nested dictionaries.
+
+        This is applied to a single field, hence filtering by env_var prefix.
+        """
+        prefixes = [f'{env_name}{self.env_nested_delimiter}' for env_name in field.field_info.extra['env_names']]
+        result: Dict[str, Any] = {}
+        for env_name, env_val in env_vars.items():
+            if not any(env_name.startswith(prefix) for prefix in prefixes):
+                continue
+            # we remove the prefix before splitting in case the prefix has characters in common with the delimiter
+            env_name_without_prefix = env_name[self.env_prefix_len :]
+            _, *keys, last_key = env_name_without_prefix.split(self.env_nested_delimiter)
+            env_var = result
+            for key in keys:
+                env_var = env_var.setdefault(key, {})
+            env_var[last_key] = env_val
+
+        return result
+
+    def __repr__(self) -> str:
+        return (
+            f'EnvSettingsSource(env_file={self.env_file!r}, env_file_encoding={self.env_file_encoding!r}, '
+            f'env_nested_delimiter={self.env_nested_delimiter!r})'
+        )
+
+
+class SecretsSettingsSource:
+    __slots__ = ('secrets_dir',)
+
+    def __init__(self, secrets_dir: Optional[StrPath]):
+        self.secrets_dir: Optional[StrPath] = secrets_dir
+
+    def __call__(self, settings: BaseSettings) -> Dict[str, Any]:
+        """
+        Build fields from "secrets" files.
+        """
+        secrets: Dict[str, Optional[str]] = {}
+
+        if self.secrets_dir is None:
+            return secrets
+
+        secrets_path = Path(self.secrets_dir).expanduser()
+
+        if not secrets_path.exists():
+            warnings.warn(f'directory "{secrets_path}" does not exist')
+            return secrets
+
+        if not secrets_path.is_dir():
+            raise SettingsError(f'secrets_dir must reference a directory, not a {path_type(secrets_path)}')
+
+        for field in settings.__fields__.values():
+            for env_name in field.field_info.extra['env_names']:
+                path = find_case_path(secrets_path, env_name, settings.__config__.case_sensitive)
+                if not path:
+                    # path does not exist, we curently don't return a warning for this
+                    continue
+
+                if path.is_file():
+                    secret_value = path.read_text().strip()
+                    if field.is_complex():
+                        try:
+                            secret_value = settings.__config__.parse_env_var(field.name, secret_value)
+                        except ValueError as e:
+                            raise SettingsError(f'error parsing env var "{env_name}"') from e
+
+                    secrets[field.alias] = secret_value
+                else:
+                    warnings.warn(
+                        f'attempted to load secret file "{path}" but found a {path_type(path)} instead.',
+                        stacklevel=4,
+                    )
+        return secrets
+
+    def __repr__(self) -> str:
+        return f'SecretsSettingsSource(secrets_dir={self.secrets_dir!r})'
+
+
+def read_env_file(
+    file_path: StrPath, *, encoding: str = None, case_sensitive: bool = False
+) -> Dict[str, Optional[str]]:
+    try:
+        from dotenv import dotenv_values
+    except ImportError as e:
+        raise ImportError('python-dotenv is not installed, run `pip install pydantic[dotenv]`') from e
+
+    file_vars: Dict[str, Optional[str]] = dotenv_values(file_path, encoding=encoding or 'utf8')
+    if not case_sensitive:
+        return {k.lower(): v for k, v in file_vars.items()}
+    else:
+        return file_vars
+
+
+def find_case_path(dir_path: Path, file_name: str, case_sensitive: bool) -> Optional[Path]:
+    """
+    Find a file within path's directory matching filename, optionally ignoring case.
+    """
+    for f in dir_path.iterdir():
+        if f.name == file_name:
+            return f
+        elif not case_sensitive and f.name.lower() == file_name.lower():
+            return f
+    return None
diff --git a/lib/pydantic/error_wrappers.py b/lib/pydantic/error_wrappers.py
new file mode 100644
index 00000000..5d3204f4
--- /dev/null
+++ b/lib/pydantic/error_wrappers.py
@@ -0,0 +1,162 @@
+import json
+from typing import TYPE_CHECKING, Any, Dict, Generator, List, Optional, Sequence, Tuple, Type, Union
+
+from .json import pydantic_encoder
+from .utils import Representation
+
+if TYPE_CHECKING:
+    from typing_extensions import TypedDict
+
+    from .config import BaseConfig
+    from .types import ModelOrDc
+    from .typing import ReprArgs
+
+    Loc = Tuple[Union[int, str], ...]
+
+    class _ErrorDictRequired(TypedDict):
+        loc: Loc
+        msg: str
+        type: str
+
+    class ErrorDict(_ErrorDictRequired, total=False):
+        ctx: Dict[str, Any]
+
+
+__all__ = 'ErrorWrapper', 'ValidationError'
+
+
+class ErrorWrapper(Representation):
+    __slots__ = 'exc', '_loc'
+
+    def __init__(self, exc: Exception, loc: Union[str, 'Loc']) -> None:
+        self.exc = exc
+        self._loc = loc
+
+    def loc_tuple(self) -> 'Loc':
+        if isinstance(self._loc, tuple):
+            return self._loc
+        else:
+            return (self._loc,)
+
+    def __repr_args__(self) -> 'ReprArgs':
+        return [('exc', self.exc), ('loc', self.loc_tuple())]
+
+
+# ErrorList is something like Union[List[Union[List[ErrorWrapper], ErrorWrapper]], ErrorWrapper]
+# but recursive, therefore just use:
+ErrorList = Union[Sequence[Any], ErrorWrapper]
+
+
+class ValidationError(Representation, ValueError):
+    __slots__ = 'raw_errors', 'model', '_error_cache'
+
+    def __init__(self, errors: Sequence[ErrorList], model: 'ModelOrDc') -> None:
+        self.raw_errors = errors
+        self.model = model
+        self._error_cache: Optional[List['ErrorDict']] = None
+
+    def errors(self) -> List['ErrorDict']:
+        if self._error_cache is None:
+            try:
+                config = self.model.__config__  # type: ignore
+            except AttributeError:
+                config = self.model.__pydantic_model__.__config__  # type: ignore
+            self._error_cache = list(flatten_errors(self.raw_errors, config))
+        return self._error_cache
+
+    def json(self, *, indent: Union[None, int, str] = 2) -> str:
+        return json.dumps(self.errors(), indent=indent, default=pydantic_encoder)
+
+    def __str__(self) -> str:
+        errors = self.errors()
+        no_errors = len(errors)
+        return (
+            f'{no_errors} validation error{"" if no_errors == 1 else "s"} for {self.model.__name__}\n'
+            f'{display_errors(errors)}'
+        )
+
+    def __repr_args__(self) -> 'ReprArgs':
+        return [('model', self.model.__name__), ('errors', self.errors())]
+
+
+def display_errors(errors: List['ErrorDict']) -> str:
+    return '\n'.join(f'{_display_error_loc(e)}\n  {e["msg"]} ({_display_error_type_and_ctx(e)})' for e in errors)
+
+
+def _display_error_loc(error: 'ErrorDict') -> str:
+    return ' -> '.join(str(e) for e in error['loc'])
+
+
+def _display_error_type_and_ctx(error: 'ErrorDict') -> str:
+    t = 'type=' + error['type']
+    ctx = error.get('ctx')
+    if ctx:
+        return t + ''.join(f'; {k}={v}' for k, v in ctx.items())
+    else:
+        return t
+
+
+def flatten_errors(
+    errors: Sequence[Any], config: Type['BaseConfig'], loc: Optional['Loc'] = None
+) -> Generator['ErrorDict', None, None]:
+    for error in errors:
+        if isinstance(error, ErrorWrapper):
+
+            if loc:
+                error_loc = loc + error.loc_tuple()
+            else:
+                error_loc = error.loc_tuple()
+
+            if isinstance(error.exc, ValidationError):
+                yield from flatten_errors(error.exc.raw_errors, config, error_loc)
+            else:
+                yield error_dict(error.exc, config, error_loc)
+        elif isinstance(error, list):
+            yield from flatten_errors(error, config, loc=loc)
+        else:
+            raise RuntimeError(f'Unknown error object: {error}')
+
+
+def error_dict(exc: Exception, config: Type['BaseConfig'], loc: 'Loc') -> 'ErrorDict':
+    type_ = get_exc_type(exc.__class__)
+    msg_template = config.error_msg_templates.get(type_) or getattr(exc, 'msg_template', None)
+    ctx = exc.__dict__
+    if msg_template:
+        msg = msg_template.format(**ctx)
+    else:
+        msg = str(exc)
+
+    d: 'ErrorDict' = {'loc': loc, 'msg': msg, 'type': type_}
+
+    if ctx:
+        d['ctx'] = ctx
+
+    return d
+
+
+_EXC_TYPE_CACHE: Dict[Type[Exception], str] = {}
+
+
+def get_exc_type(cls: Type[Exception]) -> str:
+    # slightly more efficient than using lru_cache since we don't need to worry about the cache filling up
+    try:
+        return _EXC_TYPE_CACHE[cls]
+    except KeyError:
+        r = _get_exc_type(cls)
+        _EXC_TYPE_CACHE[cls] = r
+        return r
+
+
+def _get_exc_type(cls: Type[Exception]) -> str:
+    if issubclass(cls, AssertionError):
+        return 'assertion_error'
+
+    base_name = 'type_error' if issubclass(cls, TypeError) else 'value_error'
+    if cls in (TypeError, ValueError):
+        # just TypeError or ValueError, no extra code
+        return base_name
+
+    # if it's not a TypeError or ValueError, we just take the lowercase of the exception name
+    # no chaining or snake case logic, use "code" for more complex error types.
+    code = getattr(cls, 'code', None) or cls.__name__.replace('Error', '').lower()
+    return base_name + '.' + code
diff --git a/lib/pydantic/errors.py b/lib/pydantic/errors.py
new file mode 100644
index 00000000..7bdafdd1
--- /dev/null
+++ b/lib/pydantic/errors.py
@@ -0,0 +1,646 @@
+from decimal import Decimal
+from pathlib import Path
+from typing import TYPE_CHECKING, Any, Callable, Sequence, Set, Tuple, Type, Union
+
+from .typing import display_as_type
+
+if TYPE_CHECKING:
+    from .typing import DictStrAny
+
+# explicitly state exports to avoid "from .errors import *" also importing Decimal, Path etc.
+__all__ = (
+    'PydanticTypeError',
+    'PydanticValueError',
+    'ConfigError',
+    'MissingError',
+    'ExtraError',
+    'NoneIsNotAllowedError',
+    'NoneIsAllowedError',
+    'WrongConstantError',
+    'NotNoneError',
+    'BoolError',
+    'BytesError',
+    'DictError',
+    'EmailError',
+    'UrlError',
+    'UrlSchemeError',
+    'UrlSchemePermittedError',
+    'UrlUserInfoError',
+    'UrlHostError',
+    'UrlHostTldError',
+    'UrlPortError',
+    'UrlExtraError',
+    'EnumError',
+    'IntEnumError',
+    'EnumMemberError',
+    'IntegerError',
+    'FloatError',
+    'PathError',
+    'PathNotExistsError',
+    'PathNotAFileError',
+    'PathNotADirectoryError',
+    'PyObjectError',
+    'SequenceError',
+    'ListError',
+    'SetError',
+    'FrozenSetError',
+    'TupleError',
+    'TupleLengthError',
+    'ListMinLengthError',
+    'ListMaxLengthError',
+    'ListUniqueItemsError',
+    'SetMinLengthError',
+    'SetMaxLengthError',
+    'FrozenSetMinLengthError',
+    'FrozenSetMaxLengthError',
+    'AnyStrMinLengthError',
+    'AnyStrMaxLengthError',
+    'StrError',
+    'StrRegexError',
+    'NumberNotGtError',
+    'NumberNotGeError',
+    'NumberNotLtError',
+    'NumberNotLeError',
+    'NumberNotMultipleError',
+    'DecimalError',
+    'DecimalIsNotFiniteError',
+    'DecimalMaxDigitsError',
+    'DecimalMaxPlacesError',
+    'DecimalWholeDigitsError',
+    'DateTimeError',
+    'DateError',
+    'DateNotInThePastError',
+    'DateNotInTheFutureError',
+    'TimeError',
+    'DurationError',
+    'HashableError',
+    'UUIDError',
+    'UUIDVersionError',
+    'ArbitraryTypeError',
+    'ClassError',
+    'SubclassError',
+    'JsonError',
+    'JsonTypeError',
+    'PatternError',
+    'DataclassTypeError',
+    'CallableError',
+    'IPvAnyAddressError',
+    'IPvAnyInterfaceError',
+    'IPvAnyNetworkError',
+    'IPv4AddressError',
+    'IPv6AddressError',
+    'IPv4NetworkError',
+    'IPv6NetworkError',
+    'IPv4InterfaceError',
+    'IPv6InterfaceError',
+    'ColorError',
+    'StrictBoolError',
+    'NotDigitError',
+    'LuhnValidationError',
+    'InvalidLengthForBrand',
+    'InvalidByteSize',
+    'InvalidByteSizeUnit',
+    'MissingDiscriminator',
+    'InvalidDiscriminator',
+)
+
+
+def cls_kwargs(cls: Type['PydanticErrorMixin'], ctx: 'DictStrAny') -> 'PydanticErrorMixin':
+    """
+    For built-in exceptions like ValueError or TypeError, we need to implement
+    __reduce__ to override the default behaviour (instead of __getstate__/__setstate__)
+    By default pickle protocol 2 calls `cls.__new__(cls, *args)`.
+    Since we only use kwargs, we need a little constructor to change that.
+    Note: the callable can't be a lambda as pickle looks in the namespace to find it
+    """
+    return cls(**ctx)
+
+
+class PydanticErrorMixin:
+    code: str
+    msg_template: str
+
+    def __init__(self, **ctx: Any) -> None:
+        self.__dict__ = ctx
+
+    def __str__(self) -> str:
+        return self.msg_template.format(**self.__dict__)
+
+    def __reduce__(self) -> Tuple[Callable[..., 'PydanticErrorMixin'], Tuple[Type['PydanticErrorMixin'], 'DictStrAny']]:
+        return cls_kwargs, (self.__class__, self.__dict__)
+
+
+class PydanticTypeError(PydanticErrorMixin, TypeError):
+    pass
+
+
+class PydanticValueError(PydanticErrorMixin, ValueError):
+    pass
+
+
+class ConfigError(RuntimeError):
+    pass
+
+
+class MissingError(PydanticValueError):
+    msg_template = 'field required'
+
+
+class ExtraError(PydanticValueError):
+    msg_template = 'extra fields not permitted'
+
+
+class NoneIsNotAllowedError(PydanticTypeError):
+    code = 'none.not_allowed'
+    msg_template = 'none is not an allowed value'
+
+
+class NoneIsAllowedError(PydanticTypeError):
+    code = 'none.allowed'
+    msg_template = 'value is not none'
+
+
+class WrongConstantError(PydanticValueError):
+    code = 'const'
+
+    def __str__(self) -> str:
+        permitted = ', '.join(repr(v) for v in self.permitted)  # type: ignore
+        return f'unexpected value; permitted: {permitted}'
+
+
+class NotNoneError(PydanticTypeError):
+    code = 'not_none'
+    msg_template = 'value is not None'
+
+
+class BoolError(PydanticTypeError):
+    msg_template = 'value could not be parsed to a boolean'
+
+
+class BytesError(PydanticTypeError):
+    msg_template = 'byte type expected'
+
+
+class DictError(PydanticTypeError):
+    msg_template = 'value is not a valid dict'
+
+
+class EmailError(PydanticValueError):
+    msg_template = 'value is not a valid email address'
+
+
+class UrlError(PydanticValueError):
+    code = 'url'
+
+
+class UrlSchemeError(UrlError):
+    code = 'url.scheme'
+    msg_template = 'invalid or missing URL scheme'
+
+
+class UrlSchemePermittedError(UrlError):
+    code = 'url.scheme'
+    msg_template = 'URL scheme not permitted'
+
+    def __init__(self, allowed_schemes: Set[str]):
+        super().__init__(allowed_schemes=allowed_schemes)
+
+
+class UrlUserInfoError(UrlError):
+    code = 'url.userinfo'
+    msg_template = 'userinfo required in URL but missing'
+
+
+class UrlHostError(UrlError):
+    code = 'url.host'
+    msg_template = 'URL host invalid'
+
+
+class UrlHostTldError(UrlError):
+    code = 'url.host'
+    msg_template = 'URL host invalid, top level domain required'
+
+
+class UrlPortError(UrlError):
+    code = 'url.port'
+    msg_template = 'URL port invalid, port cannot exceed 65535'
+
+
+class UrlExtraError(UrlError):
+    code = 'url.extra'
+    msg_template = 'URL invalid, extra characters found after valid URL: {extra!r}'
+
+
+class EnumMemberError(PydanticTypeError):
+    code = 'enum'
+
+    def __str__(self) -> str:
+        permitted = ', '.join(repr(v.value) for v in self.enum_values)  # type: ignore
+        return f'value is not a valid enumeration member; permitted: {permitted}'
+
+
+class IntegerError(PydanticTypeError):
+    msg_template = 'value is not a valid integer'
+
+
+class FloatError(PydanticTypeError):
+    msg_template = 'value is not a valid float'
+
+
+class PathError(PydanticTypeError):
+    msg_template = 'value is not a valid path'
+
+
+class _PathValueError(PydanticValueError):
+    def __init__(self, *, path: Path) -> None:
+        super().__init__(path=str(path))
+
+
+class PathNotExistsError(_PathValueError):
+    code = 'path.not_exists'
+    msg_template = 'file or directory at path "{path}" does not exist'
+
+
+class PathNotAFileError(_PathValueError):
+    code = 'path.not_a_file'
+    msg_template = 'path "{path}" does not point to a file'
+
+
+class PathNotADirectoryError(_PathValueError):
+    code = 'path.not_a_directory'
+    msg_template = 'path "{path}" does not point to a directory'
+
+
+class PyObjectError(PydanticTypeError):
+    msg_template = 'ensure this value contains valid import path or valid callable: {error_message}'
+
+
+class SequenceError(PydanticTypeError):
+    msg_template = 'value is not a valid sequence'
+
+
+class IterableError(PydanticTypeError):
+    msg_template = 'value is not a valid iterable'
+
+
+class ListError(PydanticTypeError):
+    msg_template = 'value is not a valid list'
+
+
+class SetError(PydanticTypeError):
+    msg_template = 'value is not a valid set'
+
+
+class FrozenSetError(PydanticTypeError):
+    msg_template = 'value is not a valid frozenset'
+
+
+class DequeError(PydanticTypeError):
+    msg_template = 'value is not a valid deque'
+
+
+class TupleError(PydanticTypeError):
+    msg_template = 'value is not a valid tuple'
+
+
+class TupleLengthError(PydanticValueError):
+    code = 'tuple.length'
+    msg_template = 'wrong tuple length {actual_length}, expected {expected_length}'
+
+    def __init__(self, *, actual_length: int, expected_length: int) -> None:
+        super().__init__(actual_length=actual_length, expected_length=expected_length)
+
+
+class ListMinLengthError(PydanticValueError):
+    code = 'list.min_items'
+    msg_template = 'ensure this value has at least {limit_value} items'
+
+    def __init__(self, *, limit_value: int) -> None:
+        super().__init__(limit_value=limit_value)
+
+
+class ListMaxLengthError(PydanticValueError):
+    code = 'list.max_items'
+    msg_template = 'ensure this value has at most {limit_value} items'
+
+    def __init__(self, *, limit_value: int) -> None:
+        super().__init__(limit_value=limit_value)
+
+
+class ListUniqueItemsError(PydanticValueError):
+    code = 'list.unique_items'
+    msg_template = 'the list has duplicated items'
+
+
+class SetMinLengthError(PydanticValueError):
+    code = 'set.min_items'
+    msg_template = 'ensure this value has at least {limit_value} items'
+
+    def __init__(self, *, limit_value: int) -> None:
+        super().__init__(limit_value=limit_value)
+
+
+class SetMaxLengthError(PydanticValueError):
+    code = 'set.max_items'
+    msg_template = 'ensure this value has at most {limit_value} items'
+
+    def __init__(self, *, limit_value: int) -> None:
+        super().__init__(limit_value=limit_value)
+
+
+class FrozenSetMinLengthError(PydanticValueError):
+    code = 'frozenset.min_items'
+    msg_template = 'ensure this value has at least {limit_value} items'
+
+    def __init__(self, *, limit_value: int) -> None:
+        super().__init__(limit_value=limit_value)
+
+
+class FrozenSetMaxLengthError(PydanticValueError):
+    code = 'frozenset.max_items'
+    msg_template = 'ensure this value has at most {limit_value} items'
+
+    def __init__(self, *, limit_value: int) -> None:
+        super().__init__(limit_value=limit_value)
+
+
+class AnyStrMinLengthError(PydanticValueError):
+    code = 'any_str.min_length'
+    msg_template = 'ensure this value has at least {limit_value} characters'
+
+    def __init__(self, *, limit_value: int) -> None:
+        super().__init__(limit_value=limit_value)
+
+
+class AnyStrMaxLengthError(PydanticValueError):
+    code = 'any_str.max_length'
+    msg_template = 'ensure this value has at most {limit_value} characters'
+
+    def __init__(self, *, limit_value: int) -> None:
+        super().__init__(limit_value=limit_value)
+
+
+class StrError(PydanticTypeError):
+    msg_template = 'str type expected'
+
+
+class StrRegexError(PydanticValueError):
+    code = 'str.regex'
+    msg_template = 'string does not match regex "{pattern}"'
+
+    def __init__(self, *, pattern: str) -> None:
+        super().__init__(pattern=pattern)
+
+
+class _NumberBoundError(PydanticValueError):
+    def __init__(self, *, limit_value: Union[int, float, Decimal]) -> None:
+        super().__init__(limit_value=limit_value)
+
+
+class NumberNotGtError(_NumberBoundError):
+    code = 'number.not_gt'
+    msg_template = 'ensure this value is greater than {limit_value}'
+
+
+class NumberNotGeError(_NumberBoundError):
+    code = 'number.not_ge'
+    msg_template = 'ensure this value is greater than or equal to {limit_value}'
+
+
+class NumberNotLtError(_NumberBoundError):
+    code = 'number.not_lt'
+    msg_template = 'ensure this value is less than {limit_value}'
+
+
+class NumberNotLeError(_NumberBoundError):
+    code = 'number.not_le'
+    msg_template = 'ensure this value is less than or equal to {limit_value}'
+
+
+class NumberNotFiniteError(PydanticValueError):
+    code = 'number.not_finite_number'
+    msg_template = 'ensure this value is a finite number'
+
+
+class NumberNotMultipleError(PydanticValueError):
+    code = 'number.not_multiple'
+    msg_template = 'ensure this value is a multiple of {multiple_of}'
+
+    def __init__(self, *, multiple_of: Union[int, float, Decimal]) -> None:
+        super().__init__(multiple_of=multiple_of)
+
+
+class DecimalError(PydanticTypeError):
+    msg_template = 'value is not a valid decimal'
+
+
+class DecimalIsNotFiniteError(PydanticValueError):
+    code = 'decimal.not_finite'
+    msg_template = 'value is not a valid decimal'
+
+
+class DecimalMaxDigitsError(PydanticValueError):
+    code = 'decimal.max_digits'
+    msg_template = 'ensure that there are no more than {max_digits} digits in total'
+
+    def __init__(self, *, max_digits: int) -> None:
+        super().__init__(max_digits=max_digits)
+
+
+class DecimalMaxPlacesError(PydanticValueError):
+    code = 'decimal.max_places'
+    msg_template = 'ensure that there are no more than {decimal_places} decimal places'
+
+    def __init__(self, *, decimal_places: int) -> None:
+        super().__init__(decimal_places=decimal_places)
+
+
+class DecimalWholeDigitsError(PydanticValueError):
+    code = 'decimal.whole_digits'
+    msg_template = 'ensure that there are no more than {whole_digits} digits before the decimal point'
+
+    def __init__(self, *, whole_digits: int) -> None:
+        super().__init__(whole_digits=whole_digits)
+
+
+class DateTimeError(PydanticValueError):
+    msg_template = 'invalid datetime format'
+
+
+class DateError(PydanticValueError):
+    msg_template = 'invalid date format'
+
+
+class DateNotInThePastError(PydanticValueError):
+    code = 'date.not_in_the_past'
+    msg_template = 'date is not in the past'
+
+
+class DateNotInTheFutureError(PydanticValueError):
+    code = 'date.not_in_the_future'
+    msg_template = 'date is not in the future'
+
+
+class TimeError(PydanticValueError):
+    msg_template = 'invalid time format'
+
+
+class DurationError(PydanticValueError):
+    msg_template = 'invalid duration format'
+
+
+class HashableError(PydanticTypeError):
+    msg_template = 'value is not a valid hashable'
+
+
+class UUIDError(PydanticTypeError):
+    msg_template = 'value is not a valid uuid'
+
+
+class UUIDVersionError(PydanticValueError):
+    code = 'uuid.version'
+    msg_template = 'uuid version {required_version} expected'
+
+    def __init__(self, *, required_version: int) -> None:
+        super().__init__(required_version=required_version)
+
+
+class ArbitraryTypeError(PydanticTypeError):
+    code = 'arbitrary_type'
+    msg_template = 'instance of {expected_arbitrary_type} expected'
+
+    def __init__(self, *, expected_arbitrary_type: Type[Any]) -> None:
+        super().__init__(expected_arbitrary_type=display_as_type(expected_arbitrary_type))
+
+
+class ClassError(PydanticTypeError):
+    code = 'class'
+    msg_template = 'a class is expected'
+
+
+class SubclassError(PydanticTypeError):
+    code = 'subclass'
+    msg_template = 'subclass of {expected_class} expected'
+
+    def __init__(self, *, expected_class: Type[Any]) -> None:
+        super().__init__(expected_class=display_as_type(expected_class))
+
+
+class JsonError(PydanticValueError):
+    msg_template = 'Invalid JSON'
+
+
+class JsonTypeError(PydanticTypeError):
+    code = 'json'
+    msg_template = 'JSON object must be str, bytes or bytearray'
+
+
+class PatternError(PydanticValueError):
+    code = 'regex_pattern'
+    msg_template = 'Invalid regular expression'
+
+
+class DataclassTypeError(PydanticTypeError):
+    code = 'dataclass'
+    msg_template = 'instance of {class_name}, tuple or dict expected'
+
+
+class CallableError(PydanticTypeError):
+    msg_template = '{value} is not callable'
+
+
+class EnumError(PydanticTypeError):
+    code = 'enum_instance'
+    msg_template = '{value} is not a valid Enum instance'
+
+
+class IntEnumError(PydanticTypeError):
+    code = 'int_enum_instance'
+    msg_template = '{value} is not a valid IntEnum instance'
+
+
+class IPvAnyAddressError(PydanticValueError):
+    msg_template = 'value is not a valid IPv4 or IPv6 address'
+
+
+class IPvAnyInterfaceError(PydanticValueError):
+    msg_template = 'value is not a valid IPv4 or IPv6 interface'
+
+
+class IPvAnyNetworkError(PydanticValueError):
+    msg_template = 'value is not a valid IPv4 or IPv6 network'
+
+
+class IPv4AddressError(PydanticValueError):
+    msg_template = 'value is not a valid IPv4 address'
+
+
+class IPv6AddressError(PydanticValueError):
+    msg_template = 'value is not a valid IPv6 address'
+
+
+class IPv4NetworkError(PydanticValueError):
+    msg_template = 'value is not a valid IPv4 network'
+
+
+class IPv6NetworkError(PydanticValueError):
+    msg_template = 'value is not a valid IPv6 network'
+
+
+class IPv4InterfaceError(PydanticValueError):
+    msg_template = 'value is not a valid IPv4 interface'
+
+
+class IPv6InterfaceError(PydanticValueError):
+    msg_template = 'value is not a valid IPv6 interface'
+
+
+class ColorError(PydanticValueError):
+    msg_template = 'value is not a valid color: {reason}'
+
+
+class StrictBoolError(PydanticValueError):
+    msg_template = 'value is not a valid boolean'
+
+
+class NotDigitError(PydanticValueError):
+    code = 'payment_card_number.digits'
+    msg_template = 'card number is not all digits'
+
+
+class LuhnValidationError(PydanticValueError):
+    code = 'payment_card_number.luhn_check'
+    msg_template = 'card number is not luhn valid'
+
+
+class InvalidLengthForBrand(PydanticValueError):
+    code = 'payment_card_number.invalid_length_for_brand'
+    msg_template = 'Length for a {brand} card must be {required_length}'
+
+
+class InvalidByteSize(PydanticValueError):
+    msg_template = 'could not parse value and unit from byte string'
+
+
+class InvalidByteSizeUnit(PydanticValueError):
+    msg_template = 'could not interpret byte unit: {unit}'
+
+
+class MissingDiscriminator(PydanticValueError):
+    code = 'discriminated_union.missing_discriminator'
+    msg_template = 'Discriminator {discriminator_key!r} is missing in value'
+
+
+class InvalidDiscriminator(PydanticValueError):
+    code = 'discriminated_union.invalid_discriminator'
+    msg_template = (
+        'No match for discriminator {discriminator_key!r} and value {discriminator_value!r} '
+        '(allowed values: {allowed_values})'
+    )
+
+    def __init__(self, *, discriminator_key: str, discriminator_value: Any, allowed_values: Sequence[Any]) -> None:
+        super().__init__(
+            discriminator_key=discriminator_key,
+            discriminator_value=discriminator_value,
+            allowed_values=', '.join(map(repr, allowed_values)),
+        )
diff --git a/lib/pydantic/fields.py b/lib/pydantic/fields.py
new file mode 100644
index 00000000..cecd3d20
--- /dev/null
+++ b/lib/pydantic/fields.py
@@ -0,0 +1,1247 @@
+import copy
+import re
+from collections import Counter as CollectionCounter, defaultdict, deque
+from collections.abc import Callable, Hashable as CollectionsHashable, Iterable as CollectionsIterable
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Counter,
+    DefaultDict,
+    Deque,
+    Dict,
+    ForwardRef,
+    FrozenSet,
+    Generator,
+    Iterable,
+    Iterator,
+    List,
+    Mapping,
+    Optional,
+    Pattern,
+    Sequence,
+    Set,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+)
+
+from typing_extensions import Annotated, Final
+
+from . import errors as errors_
+from .class_validators import Validator, make_generic_validator, prep_validators
+from .error_wrappers import ErrorWrapper
+from .errors import ConfigError, InvalidDiscriminator, MissingDiscriminator, NoneIsNotAllowedError
+from .types import Json, JsonWrapper
+from .typing import (
+    NoArgAnyCallable,
+    convert_generics,
+    display_as_type,
+    get_args,
+    get_origin,
+    is_finalvar,
+    is_literal_type,
+    is_new_type,
+    is_none_type,
+    is_typeddict,
+    is_typeddict_special,
+    is_union,
+    new_type_supertype,
+)
+from .utils import (
+    PyObjectStr,
+    Representation,
+    ValueItems,
+    get_discriminator_alias_and_values,
+    get_unique_discriminator_alias,
+    lenient_isinstance,
+    lenient_issubclass,
+    sequence_like,
+    smart_deepcopy,
+)
+from .validators import constant_validator, dict_validator, find_validators, validate_json
+
+Required: Any = Ellipsis
+
+T = TypeVar('T')
+
+
+class UndefinedType:
+    def __repr__(self) -> str:
+        return 'PydanticUndefined'
+
+    def __copy__(self: T) -> T:
+        return self
+
+    def __reduce__(self) -> str:
+        return 'Undefined'
+
+    def __deepcopy__(self: T, _: Any) -> T:
+        return self
+
+
+Undefined = UndefinedType()
+
+if TYPE_CHECKING:
+    from .class_validators import ValidatorsList
+    from .config import BaseConfig
+    from .error_wrappers import ErrorList
+    from .types import ModelOrDc
+    from .typing import AbstractSetIntStr, MappingIntStrAny, ReprArgs
+
+    ValidateReturn = Tuple[Optional[Any], Optional[ErrorList]]
+    LocStr = Union[Tuple[Union[int, str], ...], str]
+    BoolUndefined = Union[bool, UndefinedType]
+
+
+class FieldInfo(Representation):
+    """
+    Captures extra information about a field.
+    """
+
+    __slots__ = (
+        'default',
+        'default_factory',
+        'alias',
+        'alias_priority',
+        'title',
+        'description',
+        'exclude',
+        'include',
+        'const',
+        'gt',
+        'ge',
+        'lt',
+        'le',
+        'multiple_of',
+        'allow_inf_nan',
+        'max_digits',
+        'decimal_places',
+        'min_items',
+        'max_items',
+        'unique_items',
+        'min_length',
+        'max_length',
+        'allow_mutation',
+        'repr',
+        'regex',
+        'discriminator',
+        'extra',
+    )
+
+    # field constraints with the default value, it's also used in update_from_config below
+    __field_constraints__ = {
+        'min_length': None,
+        'max_length': None,
+        'regex': None,
+        'gt': None,
+        'lt': None,
+        'ge': None,
+        'le': None,
+        'multiple_of': None,
+        'allow_inf_nan': None,
+        'max_digits': None,
+        'decimal_places': None,
+        'min_items': None,
+        'max_items': None,
+        'unique_items': None,
+        'allow_mutation': True,
+    }
+
+    def __init__(self, default: Any = Undefined, **kwargs: Any) -> None:
+        self.default = default
+        self.default_factory = kwargs.pop('default_factory', None)
+        self.alias = kwargs.pop('alias', None)
+        self.alias_priority = kwargs.pop('alias_priority', 2 if self.alias is not None else None)
+        self.title = kwargs.pop('title', None)
+        self.description = kwargs.pop('description', None)
+        self.exclude = kwargs.pop('exclude', None)
+        self.include = kwargs.pop('include', None)
+        self.const = kwargs.pop('const', None)
+        self.gt = kwargs.pop('gt', None)
+        self.ge = kwargs.pop('ge', None)
+        self.lt = kwargs.pop('lt', None)
+        self.le = kwargs.pop('le', None)
+        self.multiple_of = kwargs.pop('multiple_of', None)
+        self.allow_inf_nan = kwargs.pop('allow_inf_nan', None)
+        self.max_digits = kwargs.pop('max_digits', None)
+        self.decimal_places = kwargs.pop('decimal_places', None)
+        self.min_items = kwargs.pop('min_items', None)
+        self.max_items = kwargs.pop('max_items', None)
+        self.unique_items = kwargs.pop('unique_items', None)
+        self.min_length = kwargs.pop('min_length', None)
+        self.max_length = kwargs.pop('max_length', None)
+        self.allow_mutation = kwargs.pop('allow_mutation', True)
+        self.regex = kwargs.pop('regex', None)
+        self.discriminator = kwargs.pop('discriminator', None)
+        self.repr = kwargs.pop('repr', True)
+        self.extra = kwargs
+
+    def __repr_args__(self) -> 'ReprArgs':
+
+        field_defaults_to_hide: Dict[str, Any] = {
+            'repr': True,
+            **self.__field_constraints__,
+        }
+
+        attrs = ((s, getattr(self, s)) for s in self.__slots__)
+        return [(a, v) for a, v in attrs if v != field_defaults_to_hide.get(a, None)]
+
+    def get_constraints(self) -> Set[str]:
+        """
+        Gets the constraints set on the field by comparing the constraint value with its default value
+
+        :return: the constraints set on field_info
+        """
+        return {attr for attr, default in self.__field_constraints__.items() if getattr(self, attr) != default}
+
+    def update_from_config(self, from_config: Dict[str, Any]) -> None:
+        """
+        Update this FieldInfo based on a dict from get_field_info, only fields which have not been set are dated.
+        """
+        for attr_name, value in from_config.items():
+            try:
+                current_value = getattr(self, attr_name)
+            except AttributeError:
+                # attr_name is not an attribute of FieldInfo, it should therefore be added to extra
+                # (except if extra already has this value!)
+                self.extra.setdefault(attr_name, value)
+            else:
+                if current_value is self.__field_constraints__.get(attr_name, None):
+                    setattr(self, attr_name, value)
+                elif attr_name == 'exclude':
+                    self.exclude = ValueItems.merge(value, current_value)
+                elif attr_name == 'include':
+                    self.include = ValueItems.merge(value, current_value, intersect=True)
+
+    def _validate(self) -> None:
+        if self.default is not Undefined and self.default_factory is not None:
+            raise ValueError('cannot specify both default and default_factory')
+
+
+def Field(
+    default: Any = Undefined,
+    *,
+    default_factory: Optional[NoArgAnyCallable] = None,
+    alias: str = None,
+    title: str = None,
+    description: str = None,
+    exclude: Union['AbstractSetIntStr', 'MappingIntStrAny', Any] = None,
+    include: Union['AbstractSetIntStr', 'MappingIntStrAny', Any] = None,
+    const: bool = None,
+    gt: float = None,
+    ge: float = None,
+    lt: float = None,
+    le: float = None,
+    multiple_of: float = None,
+    allow_inf_nan: bool = None,
+    max_digits: int = None,
+    decimal_places: int = None,
+    min_items: int = None,
+    max_items: int = None,
+    unique_items: bool = None,
+    min_length: int = None,
+    max_length: int = None,
+    allow_mutation: bool = True,
+    regex: str = None,
+    discriminator: str = None,
+    repr: bool = True,
+    **extra: Any,
+) -> Any:
+    """
+    Used to provide extra information about a field, either for the model schema or complex validation. Some arguments
+    apply only to number fields (``int``, ``float``, ``Decimal``) and some apply only to ``str``.
+
+    :param default: since this is replacing the field’s default, its first argument is used
+      to set the default, use ellipsis (``...``) to indicate the field is required
+    :param default_factory: callable that will be called when a default value is needed for this field
+      If both `default` and `default_factory` are set, an error is raised.
+    :param alias: the public name of the field
+    :param title: can be any string, used in the schema
+    :param description: can be any string, used in the schema
+    :param exclude: exclude this field while dumping.
+      Takes same values as the ``include`` and ``exclude`` arguments on the ``.dict`` method.
+    :param include: include this field while dumping.
+      Takes same values as the ``include`` and ``exclude`` arguments on the ``.dict`` method.
+    :param const: this field is required and *must* take it's default value
+    :param gt: only applies to numbers, requires the field to be "greater than". The schema
+      will have an ``exclusiveMinimum`` validation keyword
+    :param ge: only applies to numbers, requires the field to be "greater than or equal to". The
+      schema will have a ``minimum`` validation keyword
+    :param lt: only applies to numbers, requires the field to be "less than". The schema
+      will have an ``exclusiveMaximum`` validation keyword
+    :param le: only applies to numbers, requires the field to be "less than or equal to". The
+      schema will have a ``maximum`` validation keyword
+    :param multiple_of: only applies to numbers, requires the field to be "a multiple of". The
+      schema will have a ``multipleOf`` validation keyword
+    :param allow_inf_nan: only applies to numbers, allows the field to be NaN or infinity (+inf or -inf),
+        which is a valid Python float. Default True, set to False for compatibility with JSON.
+    :param max_digits: only applies to Decimals, requires the field to have a maximum number
+      of digits within the decimal. It does not include a zero before the decimal point or trailing decimal zeroes.
+    :param decimal_places: only applies to Decimals, requires the field to have at most a number of decimal places
+      allowed. It does not include trailing decimal zeroes.
+    :param min_items: only applies to lists, requires the field to have a minimum number of
+      elements. The schema will have a ``minItems`` validation keyword
+    :param max_items: only applies to lists, requires the field to have a maximum number of
+      elements. The schema will have a ``maxItems`` validation keyword
+    :param unique_items: only applies to lists, requires the field not to have duplicated
+      elements. The schema will have a ``uniqueItems`` validation keyword
+    :param min_length: only applies to strings, requires the field to have a minimum length. The
+      schema will have a ``maximum`` validation keyword
+    :param max_length: only applies to strings, requires the field to have a maximum length. The
+      schema will have a ``maxLength`` validation keyword
+    :param allow_mutation: a boolean which defaults to True. When False, the field raises a TypeError if the field is
+      assigned on an instance.  The BaseModel Config must set validate_assignment to True
+    :param regex: only applies to strings, requires the field match against a regular expression
+      pattern string. The schema will have a ``pattern`` validation keyword
+    :param discriminator: only useful with a (discriminated a.k.a. tagged) `Union` of sub models with a common field.
+      The `discriminator` is the name of this common field to shorten validation and improve generated schema
+    :param repr: show this field in the representation
+    :param **extra: any additional keyword arguments will be added as is to the schema
+    """
+    field_info = FieldInfo(
+        default,
+        default_factory=default_factory,
+        alias=alias,
+        title=title,
+        description=description,
+        exclude=exclude,
+        include=include,
+        const=const,
+        gt=gt,
+        ge=ge,
+        lt=lt,
+        le=le,
+        multiple_of=multiple_of,
+        allow_inf_nan=allow_inf_nan,
+        max_digits=max_digits,
+        decimal_places=decimal_places,
+        min_items=min_items,
+        max_items=max_items,
+        unique_items=unique_items,
+        min_length=min_length,
+        max_length=max_length,
+        allow_mutation=allow_mutation,
+        regex=regex,
+        discriminator=discriminator,
+        repr=repr,
+        **extra,
+    )
+    field_info._validate()
+    return field_info
+
+
+# used to be an enum but changed to int's for small performance improvement as less access overhead
+SHAPE_SINGLETON = 1
+SHAPE_LIST = 2
+SHAPE_SET = 3
+SHAPE_MAPPING = 4
+SHAPE_TUPLE = 5
+SHAPE_TUPLE_ELLIPSIS = 6
+SHAPE_SEQUENCE = 7
+SHAPE_FROZENSET = 8
+SHAPE_ITERABLE = 9
+SHAPE_GENERIC = 10
+SHAPE_DEQUE = 11
+SHAPE_DICT = 12
+SHAPE_DEFAULTDICT = 13
+SHAPE_COUNTER = 14
+SHAPE_NAME_LOOKUP = {
+    SHAPE_LIST: 'List[{}]',
+    SHAPE_SET: 'Set[{}]',
+    SHAPE_TUPLE_ELLIPSIS: 'Tuple[{}, ...]',
+    SHAPE_SEQUENCE: 'Sequence[{}]',
+    SHAPE_FROZENSET: 'FrozenSet[{}]',
+    SHAPE_ITERABLE: 'Iterable[{}]',
+    SHAPE_DEQUE: 'Deque[{}]',
+    SHAPE_DICT: 'Dict[{}]',
+    SHAPE_DEFAULTDICT: 'DefaultDict[{}]',
+    SHAPE_COUNTER: 'Counter[{}]',
+}
+
+MAPPING_LIKE_SHAPES: Set[int] = {SHAPE_DEFAULTDICT, SHAPE_DICT, SHAPE_MAPPING, SHAPE_COUNTER}
+
+
+class ModelField(Representation):
+    __slots__ = (
+        'type_',
+        'outer_type_',
+        'annotation',
+        'sub_fields',
+        'sub_fields_mapping',
+        'key_field',
+        'validators',
+        'pre_validators',
+        'post_validators',
+        'default',
+        'default_factory',
+        'required',
+        'final',
+        'model_config',
+        'name',
+        'alias',
+        'has_alias',
+        'field_info',
+        'discriminator_key',
+        'discriminator_alias',
+        'validate_always',
+        'allow_none',
+        'shape',
+        'class_validators',
+        'parse_json',
+    )
+
+    def __init__(
+        self,
+        *,
+        name: str,
+        type_: Type[Any],
+        class_validators: Optional[Dict[str, Validator]],
+        model_config: Type['BaseConfig'],
+        default: Any = None,
+        default_factory: Optional[NoArgAnyCallable] = None,
+        required: 'BoolUndefined' = Undefined,
+        final: bool = False,
+        alias: str = None,
+        field_info: Optional[FieldInfo] = None,
+    ) -> None:
+
+        self.name: str = name
+        self.has_alias: bool = alias is not None
+        self.alias: str = alias if alias is not None else name
+        self.annotation = type_
+        self.type_: Any = convert_generics(type_)
+        self.outer_type_: Any = type_
+        self.class_validators = class_validators or {}
+        self.default: Any = default
+        self.default_factory: Optional[NoArgAnyCallable] = default_factory
+        self.required: 'BoolUndefined' = required
+        self.final: bool = final
+        self.model_config = model_config
+        self.field_info: FieldInfo = field_info or FieldInfo(default)
+        self.discriminator_key: Optional[str] = self.field_info.discriminator
+        self.discriminator_alias: Optional[str] = self.discriminator_key
+
+        self.allow_none: bool = False
+        self.validate_always: bool = False
+        self.sub_fields: Optional[List[ModelField]] = None
+        self.sub_fields_mapping: Optional[Dict[str, 'ModelField']] = None  # used for discriminated union
+        self.key_field: Optional[ModelField] = None
+        self.validators: 'ValidatorsList' = []
+        self.pre_validators: Optional['ValidatorsList'] = None
+        self.post_validators: Optional['ValidatorsList'] = None
+        self.parse_json: bool = False
+        self.shape: int = SHAPE_SINGLETON
+        self.model_config.prepare_field(self)
+        self.prepare()
+
+    def get_default(self) -> Any:
+        return smart_deepcopy(self.default) if self.default_factory is None else self.default_factory()
+
+    @staticmethod
+    def _get_field_info(
+        field_name: str, annotation: Any, value: Any, config: Type['BaseConfig']
+    ) -> Tuple[FieldInfo, Any]:
+        """
+        Get a FieldInfo from a root typing.Annotated annotation, value, or config default.
+
+        The FieldInfo may be set in typing.Annotated or the value, but not both. If neither contain
+        a FieldInfo, a new one will be created using the config.
+
+        :param field_name: name of the field for use in error messages
+        :param annotation: a type hint such as `str` or `Annotated[str, Field(..., min_length=5)]`
+        :param value: the field's assigned value
+        :param config: the model's config object
+        :return: the FieldInfo contained in the `annotation`, the value, or a new one from the config.
+        """
+        field_info_from_config = config.get_field_info(field_name)
+
+        field_info = None
+        if get_origin(annotation) is Annotated:
+            field_infos = [arg for arg in get_args(annotation)[1:] if isinstance(arg, FieldInfo)]
+            if len(field_infos) > 1:
+                raise ValueError(f'cannot specify multiple `Annotated` `Field`s for {field_name!r}')
+            field_info = next(iter(field_infos), None)
+            if field_info is not None:
+                field_info = copy.copy(field_info)
+                field_info.update_from_config(field_info_from_config)
+                if field_info.default not in (Undefined, Required):
+                    raise ValueError(f'`Field` default cannot be set in `Annotated` for {field_name!r}')
+                if value is not Undefined and value is not Required:
+                    # check also `Required` because of `validate_arguments` that sets `...` as default value
+                    field_info.default = value
+
+        if isinstance(value, FieldInfo):
+            if field_info is not None:
+                raise ValueError(f'cannot specify `Annotated` and value `Field`s together for {field_name!r}')
+            field_info = value
+            field_info.update_from_config(field_info_from_config)
+        elif field_info is None:
+            field_info = FieldInfo(value, **field_info_from_config)
+        value = None if field_info.default_factory is not None else field_info.default
+        field_info._validate()
+        return field_info, value
+
+    @classmethod
+    def infer(
+        cls,
+        *,
+        name: str,
+        value: Any,
+        annotation: Any,
+        class_validators: Optional[Dict[str, Validator]],
+        config: Type['BaseConfig'],
+    ) -> 'ModelField':
+        from .schema import get_annotation_from_field_info
+
+        field_info, value = cls._get_field_info(name, annotation, value, config)
+        required: 'BoolUndefined' = Undefined
+        if value is Required:
+            required = True
+            value = None
+        elif value is not Undefined:
+            required = False
+        annotation = get_annotation_from_field_info(annotation, field_info, name, config.validate_assignment)
+
+        return cls(
+            name=name,
+            type_=annotation,
+            alias=field_info.alias,
+            class_validators=class_validators,
+            default=value,
+            default_factory=field_info.default_factory,
+            required=required,
+            model_config=config,
+            field_info=field_info,
+        )
+
+    def set_config(self, config: Type['BaseConfig']) -> None:
+        self.model_config = config
+        info_from_config = config.get_field_info(self.name)
+        config.prepare_field(self)
+        new_alias = info_from_config.get('alias')
+        new_alias_priority = info_from_config.get('alias_priority') or 0
+        if new_alias and new_alias_priority >= (self.field_info.alias_priority or 0):
+            self.field_info.alias = new_alias
+            self.field_info.alias_priority = new_alias_priority
+            self.alias = new_alias
+        new_exclude = info_from_config.get('exclude')
+        if new_exclude is not None:
+            self.field_info.exclude = ValueItems.merge(self.field_info.exclude, new_exclude)
+        new_include = info_from_config.get('include')
+        if new_include is not None:
+            self.field_info.include = ValueItems.merge(self.field_info.include, new_include, intersect=True)
+
+    @property
+    def alt_alias(self) -> bool:
+        return self.name != self.alias
+
+    def prepare(self) -> None:
+        """
+        Prepare the field but inspecting self.default, self.type_ etc.
+
+        Note: this method is **not** idempotent (because _type_analysis is not idempotent),
+        e.g. calling it it multiple times may modify the field and configure it incorrectly.
+        """
+        self._set_default_and_type()
+        if self.type_.__class__ is ForwardRef or self.type_.__class__ is DeferredType:
+            # self.type_ is currently a ForwardRef and there's nothing we can do now,
+            # user will need to call model.update_forward_refs()
+            return
+
+        self._type_analysis()
+        if self.required is Undefined:
+            self.required = True
+        if self.default is Undefined and self.default_factory is None:
+            self.default = None
+        self.populate_validators()
+
+    def _set_default_and_type(self) -> None:
+        """
+        Set the default value, infer the type if needed and check if `None` value is valid.
+        """
+        if self.default_factory is not None:
+            if self.type_ is Undefined:
+                raise errors_.ConfigError(
+                    f'you need to set the type of field {self.name!r} when using `default_factory`'
+                )
+            return
+
+        default_value = self.get_default()
+
+        if default_value is not None and self.type_ is Undefined:
+            self.type_ = default_value.__class__
+            self.outer_type_ = self.type_
+            self.annotation = self.type_
+
+        if self.type_ is Undefined:
+            raise errors_.ConfigError(f'unable to infer type for attribute "{self.name}"')
+
+        if self.required is False and default_value is None:
+            self.allow_none = True
+
+    def _type_analysis(self) -> None:  # noqa: C901 (ignore complexity)
+        # typing interface is horrible, we have to do some ugly checks
+        if lenient_issubclass(self.type_, JsonWrapper):
+            self.type_ = self.type_.inner_type
+            self.parse_json = True
+        elif lenient_issubclass(self.type_, Json):
+            self.type_ = Any
+            self.parse_json = True
+        elif isinstance(self.type_, TypeVar):
+            if self.type_.__bound__:
+                self.type_ = self.type_.__bound__
+            elif self.type_.__constraints__:
+                self.type_ = Union[self.type_.__constraints__]
+            else:
+                self.type_ = Any
+        elif is_new_type(self.type_):
+            self.type_ = new_type_supertype(self.type_)
+
+        if self.type_ is Any or self.type_ is object:
+            if self.required is Undefined:
+                self.required = False
+            self.allow_none = True
+            return
+        elif self.type_ is Pattern or self.type_ is re.Pattern:
+            # python 3.7 only, Pattern is a typing object but without sub fields
+            return
+        elif is_literal_type(self.type_):
+            return
+        elif is_typeddict(self.type_):
+            return
+
+        if is_finalvar(self.type_):
+            self.final = True
+
+            if self.type_ is Final:
+                self.type_ = Any
+            else:
+                self.type_ = get_args(self.type_)[0]
+
+            self._type_analysis()
+            return
+
+        origin = get_origin(self.type_)
+
+        if origin is Annotated or is_typeddict_special(origin):
+            self.type_ = get_args(self.type_)[0]
+            self._type_analysis()
+            return
+
+        if self.discriminator_key is not None and not is_union(origin):
+            raise TypeError('`discriminator` can only be used with `Union` type with more than one variant')
+
+        # add extra check for `collections.abc.Hashable` for python 3.10+ where origin is not `None`
+        if origin is None or origin is CollectionsHashable:
+            # field is not "typing" object eg. Union, Dict, List etc.
+            # allow None for virtual superclasses of NoneType, e.g. Hashable
+            if isinstance(self.type_, type) and isinstance(None, self.type_):
+                self.allow_none = True
+            return
+        elif origin is Callable:
+            return
+        elif is_union(origin):
+            types_ = []
+            for type_ in get_args(self.type_):
+                if is_none_type(type_) or type_ is Any or type_ is object:
+                    if self.required is Undefined:
+                        self.required = False
+                    self.allow_none = True
+                if is_none_type(type_):
+                    continue
+                types_.append(type_)
+
+            if len(types_) == 1:
+                # Optional[]
+                self.type_ = types_[0]
+                # this is the one case where the "outer type" isn't just the original type
+                self.outer_type_ = self.type_
+                # re-run to correctly interpret the new self.type_
+                self._type_analysis()
+            else:
+                self.sub_fields = [self._create_sub_type(t, f'{self.name}_{display_as_type(t)}') for t in types_]
+
+                if self.discriminator_key is not None:
+                    self.prepare_discriminated_union_sub_fields()
+            return
+        elif issubclass(origin, Tuple):  # type: ignore
+            # origin == Tuple without item type
+            args = get_args(self.type_)
+            if not args:  # plain tuple
+                self.type_ = Any
+                self.shape = SHAPE_TUPLE_ELLIPSIS
+            elif len(args) == 2 and args[1] is Ellipsis:  # e.g. Tuple[int, ...]
+                self.type_ = args[0]
+                self.shape = SHAPE_TUPLE_ELLIPSIS
+                self.sub_fields = [self._create_sub_type(args[0], f'{self.name}_0')]
+            elif args == ((),):  # Tuple[()] means empty tuple
+                self.shape = SHAPE_TUPLE
+                self.type_ = Any
+                self.sub_fields = []
+            else:
+                self.shape = SHAPE_TUPLE
+                self.sub_fields = [self._create_sub_type(t, f'{self.name}_{i}') for i, t in enumerate(args)]
+            return
+        elif issubclass(origin, List):
+            # Create self validators
+            get_validators = getattr(self.type_, '__get_validators__', None)
+            if get_validators:
+                self.class_validators.update(
+                    {f'list_{i}': Validator(validator, pre=True) for i, validator in enumerate(get_validators())}
+                )
+
+            self.type_ = get_args(self.type_)[0]
+            self.shape = SHAPE_LIST
+        elif issubclass(origin, Set):
+            # Create self validators
+            get_validators = getattr(self.type_, '__get_validators__', None)
+            if get_validators:
+                self.class_validators.update(
+                    {f'set_{i}': Validator(validator, pre=True) for i, validator in enumerate(get_validators())}
+                )
+
+            self.type_ = get_args(self.type_)[0]
+            self.shape = SHAPE_SET
+        elif issubclass(origin, FrozenSet):
+            # Create self validators
+            get_validators = getattr(self.type_, '__get_validators__', None)
+            if get_validators:
+                self.class_validators.update(
+                    {f'frozenset_{i}': Validator(validator, pre=True) for i, validator in enumerate(get_validators())}
+                )
+
+            self.type_ = get_args(self.type_)[0]
+            self.shape = SHAPE_FROZENSET
+        elif issubclass(origin, Deque):
+            self.type_ = get_args(self.type_)[0]
+            self.shape = SHAPE_DEQUE
+        elif issubclass(origin, Sequence):
+            self.type_ = get_args(self.type_)[0]
+            self.shape = SHAPE_SEQUENCE
+        # priority to most common mapping: dict
+        elif origin is dict or origin is Dict:
+            self.key_field = self._create_sub_type(get_args(self.type_)[0], 'key_' + self.name, for_keys=True)
+            self.type_ = get_args(self.type_)[1]
+            self.shape = SHAPE_DICT
+        elif issubclass(origin, DefaultDict):
+            self.key_field = self._create_sub_type(get_args(self.type_)[0], 'key_' + self.name, for_keys=True)
+            self.type_ = get_args(self.type_)[1]
+            self.shape = SHAPE_DEFAULTDICT
+        elif issubclass(origin, Counter):
+            self.key_field = self._create_sub_type(get_args(self.type_)[0], 'key_' + self.name, for_keys=True)
+            self.type_ = int
+            self.shape = SHAPE_COUNTER
+        elif issubclass(origin, Mapping):
+            self.key_field = self._create_sub_type(get_args(self.type_)[0], 'key_' + self.name, for_keys=True)
+            self.type_ = get_args(self.type_)[1]
+            self.shape = SHAPE_MAPPING
+        # Equality check as almost everything inherits form Iterable, including str
+        # check for Iterable and CollectionsIterable, as it could receive one even when declared with the other
+        elif origin in {Iterable, CollectionsIterable}:
+            self.type_ = get_args(self.type_)[0]
+            self.shape = SHAPE_ITERABLE
+            self.sub_fields = [self._create_sub_type(self.type_, f'{self.name}_type')]
+        elif issubclass(origin, Type):  # type: ignore
+            return
+        elif hasattr(origin, '__get_validators__') or self.model_config.arbitrary_types_allowed:
+            # Is a Pydantic-compatible generic that handles itself
+            # or we have arbitrary_types_allowed = True
+            self.shape = SHAPE_GENERIC
+            self.sub_fields = [self._create_sub_type(t, f'{self.name}_{i}') for i, t in enumerate(get_args(self.type_))]
+            self.type_ = origin
+            return
+        else:
+            raise TypeError(f'Fields of type "{origin}" are not supported.')
+
+        # type_ has been refined eg. as the type of a List and sub_fields needs to be populated
+        self.sub_fields = [self._create_sub_type(self.type_, '_' + self.name)]
+
+    def prepare_discriminated_union_sub_fields(self) -> None:
+        """
+        Prepare the mapping <discriminator key> -> <ModelField> and update `sub_fields`
+        Note that this process can be aborted if a `ForwardRef` is encountered
+        """
+        assert self.discriminator_key is not None
+
+        if self.type_.__class__ is DeferredType:
+            return
+
+        assert self.sub_fields is not None
+        sub_fields_mapping: Dict[str, 'ModelField'] = {}
+        all_aliases: Set[str] = set()
+
+        for sub_field in self.sub_fields:
+            t = sub_field.type_
+            if t.__class__ is ForwardRef:
+                # Stopping everything...will need to call `update_forward_refs`
+                return
+
+            alias, discriminator_values = get_discriminator_alias_and_values(t, self.discriminator_key)
+            all_aliases.add(alias)
+            for discriminator_value in discriminator_values:
+                sub_fields_mapping[discriminator_value] = sub_field
+
+        self.sub_fields_mapping = sub_fields_mapping
+        self.discriminator_alias = get_unique_discriminator_alias(all_aliases, self.discriminator_key)
+
+    def _create_sub_type(self, type_: Type[Any], name: str, *, for_keys: bool = False) -> 'ModelField':
+        if for_keys:
+            class_validators = None
+        else:
+            # validators for sub items should not have `each_item` as we want to check only the first sublevel
+            class_validators = {
+                k: Validator(
+                    func=v.func,
+                    pre=v.pre,
+                    each_item=False,
+                    always=v.always,
+                    check_fields=v.check_fields,
+                    skip_on_failure=v.skip_on_failure,
+                )
+                for k, v in self.class_validators.items()
+                if v.each_item
+            }
+
+        field_info, _ = self._get_field_info(name, type_, None, self.model_config)
+
+        return self.__class__(
+            type_=type_,
+            name=name,
+            class_validators=class_validators,
+            model_config=self.model_config,
+            field_info=field_info,
+        )
+
+    def populate_validators(self) -> None:
+        """
+        Prepare self.pre_validators, self.validators, and self.post_validators based on self.type_'s  __get_validators__
+        and class validators. This method should be idempotent, e.g. it should be safe to call multiple times
+        without mis-configuring the field.
+        """
+        self.validate_always = getattr(self.type_, 'validate_always', False) or any(
+            v.always for v in self.class_validators.values()
+        )
+
+        class_validators_ = self.class_validators.values()
+        if not self.sub_fields or self.shape == SHAPE_GENERIC:
+            get_validators = getattr(self.type_, '__get_validators__', None)
+            v_funcs = (
+                *[v.func for v in class_validators_ if v.each_item and v.pre],
+                *(get_validators() if get_validators else list(find_validators(self.type_, self.model_config))),
+                *[v.func for v in class_validators_ if v.each_item and not v.pre],
+            )
+            self.validators = prep_validators(v_funcs)
+
+        self.pre_validators = []
+        self.post_validators = []
+
+        if self.field_info and self.field_info.const:
+            self.post_validators.append(make_generic_validator(constant_validator))
+
+        if class_validators_:
+            self.pre_validators += prep_validators(v.func for v in class_validators_ if not v.each_item and v.pre)
+            self.post_validators += prep_validators(v.func for v in class_validators_ if not v.each_item and not v.pre)
+
+        if self.parse_json:
+            self.pre_validators.append(make_generic_validator(validate_json))
+
+        self.pre_validators = self.pre_validators or None
+        self.post_validators = self.post_validators or None
+
+    def validate(
+        self, v: Any, values: Dict[str, Any], *, loc: 'LocStr', cls: Optional['ModelOrDc'] = None
+    ) -> 'ValidateReturn':
+
+        assert self.type_.__class__ is not DeferredType
+
+        if self.type_.__class__ is ForwardRef:
+            assert cls is not None
+            raise ConfigError(
+                f'field "{self.name}" not yet prepared so type is still a ForwardRef, '
+                f'you might need to call {cls.__name__}.update_forward_refs().'
+            )
+
+        errors: Optional['ErrorList']
+        if self.pre_validators:
+            v, errors = self._apply_validators(v, values, loc, cls, self.pre_validators)
+            if errors:
+                return v, errors
+
+        if v is None:
+            if is_none_type(self.type_):
+                # keep validating
+                pass
+            elif self.allow_none:
+                if self.post_validators:
+                    return self._apply_validators(v, values, loc, cls, self.post_validators)
+                else:
+                    return None, None
+            else:
+                return v, ErrorWrapper(NoneIsNotAllowedError(), loc)
+
+        if self.shape == SHAPE_SINGLETON:
+            v, errors = self._validate_singleton(v, values, loc, cls)
+        elif self.shape in MAPPING_LIKE_SHAPES:
+            v, errors = self._validate_mapping_like(v, values, loc, cls)
+        elif self.shape == SHAPE_TUPLE:
+            v, errors = self._validate_tuple(v, values, loc, cls)
+        elif self.shape == SHAPE_ITERABLE:
+            v, errors = self._validate_iterable(v, values, loc, cls)
+        elif self.shape == SHAPE_GENERIC:
+            v, errors = self._apply_validators(v, values, loc, cls, self.validators)
+        else:
+            #  sequence, list, set, generator, tuple with ellipsis, frozen set
+            v, errors = self._validate_sequence_like(v, values, loc, cls)
+
+        if not errors and self.post_validators:
+            v, errors = self._apply_validators(v, values, loc, cls, self.post_validators)
+        return v, errors
+
+    def _validate_sequence_like(  # noqa: C901 (ignore complexity)
+        self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc']
+    ) -> 'ValidateReturn':
+        """
+        Validate sequence-like containers: lists, tuples, sets and generators
+        Note that large if-else blocks are necessary to enable Cython
+        optimization, which is why we disable the complexity check above.
+        """
+        if not sequence_like(v):
+            e: errors_.PydanticTypeError
+            if self.shape == SHAPE_LIST:
+                e = errors_.ListError()
+            elif self.shape in (SHAPE_TUPLE, SHAPE_TUPLE_ELLIPSIS):
+                e = errors_.TupleError()
+            elif self.shape == SHAPE_SET:
+                e = errors_.SetError()
+            elif self.shape == SHAPE_FROZENSET:
+                e = errors_.FrozenSetError()
+            else:
+                e = errors_.SequenceError()
+            return v, ErrorWrapper(e, loc)
+
+        loc = loc if isinstance(loc, tuple) else (loc,)
+        result = []
+        errors: List[ErrorList] = []
+        for i, v_ in enumerate(v):
+            v_loc = *loc, i
+            r, ee = self._validate_singleton(v_, values, v_loc, cls)
+            if ee:
+                errors.append(ee)
+            else:
+                result.append(r)
+
+        if errors:
+            return v, errors
+
+        converted: Union[List[Any], Set[Any], FrozenSet[Any], Tuple[Any, ...], Iterator[Any], Deque[Any]] = result
+
+        if self.shape == SHAPE_SET:
+            converted = set(result)
+        elif self.shape == SHAPE_FROZENSET:
+            converted = frozenset(result)
+        elif self.shape == SHAPE_TUPLE_ELLIPSIS:
+            converted = tuple(result)
+        elif self.shape == SHAPE_DEQUE:
+            converted = deque(result)
+        elif self.shape == SHAPE_SEQUENCE:
+            if isinstance(v, tuple):
+                converted = tuple(result)
+            elif isinstance(v, set):
+                converted = set(result)
+            elif isinstance(v, Generator):
+                converted = iter(result)
+            elif isinstance(v, deque):
+                converted = deque(result)
+        return converted, None
+
+    def _validate_iterable(
+        self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc']
+    ) -> 'ValidateReturn':
+        """
+        Validate Iterables.
+
+        This intentionally doesn't validate values to allow infinite generators.
+        """
+
+        try:
+            iterable = iter(v)
+        except TypeError:
+            return v, ErrorWrapper(errors_.IterableError(), loc)
+        return iterable, None
+
+    def _validate_tuple(
+        self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc']
+    ) -> 'ValidateReturn':
+        e: Optional[Exception] = None
+        if not sequence_like(v):
+            e = errors_.TupleError()
+        else:
+            actual_length, expected_length = len(v), len(self.sub_fields)  # type: ignore
+            if actual_length != expected_length:
+                e = errors_.TupleLengthError(actual_length=actual_length, expected_length=expected_length)
+
+        if e:
+            return v, ErrorWrapper(e, loc)
+
+        loc = loc if isinstance(loc, tuple) else (loc,)
+        result = []
+        errors: List[ErrorList] = []
+        for i, (v_, field) in enumerate(zip(v, self.sub_fields)):  # type: ignore
+            v_loc = *loc, i
+            r, ee = field.validate(v_, values, loc=v_loc, cls=cls)
+            if ee:
+                errors.append(ee)
+            else:
+                result.append(r)
+
+        if errors:
+            return v, errors
+        else:
+            return tuple(result), None
+
+    def _validate_mapping_like(
+        self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc']
+    ) -> 'ValidateReturn':
+        try:
+            v_iter = dict_validator(v)
+        except TypeError as exc:
+            return v, ErrorWrapper(exc, loc)
+
+        loc = loc if isinstance(loc, tuple) else (loc,)
+        result, errors = {}, []
+        for k, v_ in v_iter.items():
+            v_loc = *loc, '__key__'
+            key_result, key_errors = self.key_field.validate(k, values, loc=v_loc, cls=cls)  # type: ignore
+            if key_errors:
+                errors.append(key_errors)
+                continue
+
+            v_loc = *loc, k
+            value_result, value_errors = self._validate_singleton(v_, values, v_loc, cls)
+            if value_errors:
+                errors.append(value_errors)
+                continue
+
+            result[key_result] = value_result
+        if errors:
+            return v, errors
+        elif self.shape == SHAPE_DICT:
+            return result, None
+        elif self.shape == SHAPE_DEFAULTDICT:
+            return defaultdict(self.type_, result), None
+        elif self.shape == SHAPE_COUNTER:
+            return CollectionCounter(result), None
+        else:
+            return self._get_mapping_value(v, result), None
+
+    def _get_mapping_value(self, original: T, converted: Dict[Any, Any]) -> Union[T, Dict[Any, Any]]:
+        """
+        When type is `Mapping[KT, KV]` (or another unsupported mapping), we try to avoid
+        coercing to `dict` unwillingly.
+        """
+        original_cls = original.__class__
+
+        if original_cls == dict or original_cls == Dict:
+            return converted
+        elif original_cls in {defaultdict, DefaultDict}:
+            return defaultdict(self.type_, converted)
+        else:
+            try:
+                # Counter, OrderedDict, UserDict, ...
+                return original_cls(converted)  # type: ignore
+            except TypeError:
+                raise RuntimeError(f'Could not convert dictionary to {original_cls.__name__!r}') from None
+
+    def _validate_singleton(
+        self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc']
+    ) -> 'ValidateReturn':
+        if self.sub_fields:
+            if self.discriminator_key is not None:
+                return self._validate_discriminated_union(v, values, loc, cls)
+
+            errors = []
+
+            if self.model_config.smart_union and is_union(get_origin(self.type_)):
+                # 1st pass: check if the value is an exact instance of one of the Union types
+                # (e.g. to avoid coercing a bool into an int)
+                for field in self.sub_fields:
+                    if v.__class__ is field.outer_type_:
+                        return v, None
+
+                # 2nd pass: check if the value is an instance of any subclass of the Union types
+                for field in self.sub_fields:
+                    # This whole logic will be improved later on to support more complex `isinstance` checks
+                    # It will probably be done once a strict mode is added and be something like:
+                    # ```
+                    #     value, error = field.validate(v, values, strict=True)
+                    #     if error is None:
+                    #         return value, None
+                    # ```
+                    try:
+                        if isinstance(v, field.outer_type_):
+                            return v, None
+                    except TypeError:
+                        # compound type
+                        if lenient_isinstance(v, get_origin(field.outer_type_)):
+                            value, error = field.validate(v, values, loc=loc, cls=cls)
+                            if not error:
+                                return value, None
+
+            # 1st pass by default or 3rd pass with `smart_union` enabled:
+            # check if the value can be coerced into one of the Union types
+            for field in self.sub_fields:
+                value, error = field.validate(v, values, loc=loc, cls=cls)
+                if error:
+                    errors.append(error)
+                else:
+                    return value, None
+            return v, errors
+        else:
+            return self._apply_validators(v, values, loc, cls, self.validators)
+
+    def _validate_discriminated_union(
+        self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc']
+    ) -> 'ValidateReturn':
+        assert self.discriminator_key is not None
+        assert self.discriminator_alias is not None
+
+        try:
+            discriminator_value = v[self.discriminator_alias]
+        except KeyError:
+            return v, ErrorWrapper(MissingDiscriminator(discriminator_key=self.discriminator_key), loc)
+        except TypeError:
+            try:
+                # BaseModel or dataclass
+                discriminator_value = getattr(v, self.discriminator_key)
+            except (AttributeError, TypeError):
+                return v, ErrorWrapper(MissingDiscriminator(discriminator_key=self.discriminator_key), loc)
+
+        try:
+            sub_field = self.sub_fields_mapping[discriminator_value]  # type: ignore[index]
+        except TypeError:
+            assert cls is not None
+            raise ConfigError(
+                f'field "{self.name}" not yet prepared so type is still a ForwardRef, '
+                f'you might need to call {cls.__name__}.update_forward_refs().'
+            )
+        except KeyError:
+            assert self.sub_fields_mapping is not None
+            return v, ErrorWrapper(
+                InvalidDiscriminator(
+                    discriminator_key=self.discriminator_key,
+                    discriminator_value=discriminator_value,
+                    allowed_values=list(self.sub_fields_mapping),
+                ),
+                loc,
+            )
+        else:
+            if not isinstance(loc, tuple):
+                loc = (loc,)
+            return sub_field.validate(v, values, loc=(*loc, display_as_type(sub_field.type_)), cls=cls)
+
+    def _apply_validators(
+        self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc'], validators: 'ValidatorsList'
+    ) -> 'ValidateReturn':
+        for validator in validators:
+            try:
+                v = validator(cls, v, values, self, self.model_config)
+            except (ValueError, TypeError, AssertionError) as exc:
+                return v, ErrorWrapper(exc, loc)
+        return v, None
+
+    def is_complex(self) -> bool:
+        """
+        Whether the field is "complex" eg. env variables should be parsed as JSON.
+        """
+        from .main import BaseModel
+
+        return (
+            self.shape != SHAPE_SINGLETON
+            or hasattr(self.type_, '__pydantic_model__')
+            or lenient_issubclass(self.type_, (BaseModel, list, set, frozenset, dict))
+        )
+
+    def _type_display(self) -> PyObjectStr:
+        t = display_as_type(self.type_)
+
+        if self.shape in MAPPING_LIKE_SHAPES:
+            t = f'Mapping[{display_as_type(self.key_field.type_)}, {t}]'  # type: ignore
+        elif self.shape == SHAPE_TUPLE:
+            t = 'Tuple[{}]'.format(', '.join(display_as_type(f.type_) for f in self.sub_fields))  # type: ignore
+        elif self.shape == SHAPE_GENERIC:
+            assert self.sub_fields
+            t = '{}[{}]'.format(
+                display_as_type(self.type_), ', '.join(display_as_type(f.type_) for f in self.sub_fields)
+            )
+        elif self.shape != SHAPE_SINGLETON:
+            t = SHAPE_NAME_LOOKUP[self.shape].format(t)
+
+        if self.allow_none and (self.shape != SHAPE_SINGLETON or not self.sub_fields):
+            t = f'Optional[{t}]'
+        return PyObjectStr(t)
+
+    def __repr_args__(self) -> 'ReprArgs':
+        args = [('name', self.name), ('type', self._type_display()), ('required', self.required)]
+
+        if not self.required:
+            if self.default_factory is not None:
+                args.append(('default_factory', f'<function {self.default_factory.__name__}>'))
+            else:
+                args.append(('default', self.default))
+
+        if self.alt_alias:
+            args.append(('alias', self.alias))
+        return args
+
+
+class ModelPrivateAttr(Representation):
+    __slots__ = ('default', 'default_factory')
+
+    def __init__(self, default: Any = Undefined, *, default_factory: Optional[NoArgAnyCallable] = None) -> None:
+        self.default = default
+        self.default_factory = default_factory
+
+    def get_default(self) -> Any:
+        return smart_deepcopy(self.default) if self.default_factory is None else self.default_factory()
+
+    def __eq__(self, other: Any) -> bool:
+        return isinstance(other, self.__class__) and (self.default, self.default_factory) == (
+            other.default,
+            other.default_factory,
+        )
+
+
+def PrivateAttr(
+    default: Any = Undefined,
+    *,
+    default_factory: Optional[NoArgAnyCallable] = None,
+) -> Any:
+    """
+    Indicates that attribute is only used internally and never mixed with regular fields.
+
+    Types or values of private attrs are not checked by pydantic and it's up to you to keep them relevant.
+
+    Private attrs are stored in model __slots__.
+
+    :param default: the attribute’s default value
+    :param default_factory: callable that will be called when a default value is needed for this attribute
+      If both `default` and `default_factory` are set, an error is raised.
+    """
+    if default is not Undefined and default_factory is not None:
+        raise ValueError('cannot specify both default and default_factory')
+
+    return ModelPrivateAttr(
+        default,
+        default_factory=default_factory,
+    )
+
+
+class DeferredType:
+    """
+    Used to postpone field preparation, while creating recursive generic models.
+    """
+
+
+def is_finalvar_with_default_val(type_: Type[Any], val: Any) -> bool:
+    return is_finalvar(type_) and val is not Undefined and not isinstance(val, FieldInfo)
diff --git a/lib/pydantic/generics.py b/lib/pydantic/generics.py
new file mode 100644
index 00000000..a3f52bfe
--- /dev/null
+++ b/lib/pydantic/generics.py
@@ -0,0 +1,364 @@
+import sys
+import typing
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    ClassVar,
+    Dict,
+    Generic,
+    Iterator,
+    List,
+    Mapping,
+    Optional,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+    cast,
+)
+
+from typing_extensions import Annotated
+
+from .class_validators import gather_all_validators
+from .fields import DeferredType
+from .main import BaseModel, create_model
+from .types import JsonWrapper
+from .typing import display_as_type, get_all_type_hints, get_args, get_origin, typing_base
+from .utils import LimitedDict, all_identical, lenient_issubclass
+
+GenericModelT = TypeVar('GenericModelT', bound='GenericModel')
+TypeVarType = Any  # since mypy doesn't allow the use of TypeVar as a type
+
+Parametrization = Mapping[TypeVarType, Type[Any]]
+
+_generic_types_cache: LimitedDict[Tuple[Type[Any], Union[Any, Tuple[Any, ...]]], Type[BaseModel]] = LimitedDict()
+# _assigned_parameters is a Mapping from parametrized version of generic models to assigned types of parametrizations
+# as captured during construction of the class (not instances).
+# E.g., for generic model `Model[A, B]`, when parametrized model `Model[int, str]` is created,
+# `Model[int, str]`: {A: int, B: str}` will be stored in `_assigned_parameters`.
+# (This information is only otherwise available after creation from the class name string).
+_assigned_parameters: LimitedDict[Type[Any], Parametrization] = LimitedDict()
+
+
+class GenericModel(BaseModel):
+    __slots__ = ()
+    __concrete__: ClassVar[bool] = False
+
+    if TYPE_CHECKING:
+        # Putting this in a TYPE_CHECKING block allows us to replace `if Generic not in cls.__bases__` with
+        # `not hasattr(cls, "__parameters__")`. This means we don't need to force non-concrete subclasses of
+        # `GenericModel` to also inherit from `Generic`, which would require changes to the use of `create_model` below.
+        __parameters__: ClassVar[Tuple[TypeVarType, ...]]
+
+    # Setting the return type as Type[Any] instead of Type[BaseModel] prevents PyCharm warnings
+    def __class_getitem__(cls: Type[GenericModelT], params: Union[Type[Any], Tuple[Type[Any], ...]]) -> Type[Any]:
+        """Instantiates a new class from a generic class `cls` and type variables `params`.
+
+        :param params: Tuple of types the class . Given a generic class
+            `Model` with 2 type variables and a concrete model `Model[str, int]`,
+            the value `(str, int)` would be passed to `params`.
+        :return: New model class inheriting from `cls` with instantiated
+            types described by `params`. If no parameters are given, `cls` is
+            returned as is.
+
+        """
+
+        def _cache_key(_params: Any) -> Tuple[Type[GenericModelT], Any, Tuple[Any, ...]]:
+            return cls, _params, get_args(_params)
+
+        cached = _generic_types_cache.get(_cache_key(params))
+        if cached is not None:
+            return cached
+        if cls.__concrete__ and Generic not in cls.__bases__:
+            raise TypeError('Cannot parameterize a concrete instantiation of a generic model')
+        if not isinstance(params, tuple):
+            params = (params,)
+        if cls is GenericModel and any(isinstance(param, TypeVar) for param in params):
+            raise TypeError('Type parameters should be placed on typing.Generic, not GenericModel')
+        if not hasattr(cls, '__parameters__'):
+            raise TypeError(f'Type {cls.__name__} must inherit from typing.Generic before being parameterized')
+
+        check_parameters_count(cls, params)
+        # Build map from generic typevars to passed params
+        typevars_map: Dict[TypeVarType, Type[Any]] = dict(zip(cls.__parameters__, params))
+        if all_identical(typevars_map.keys(), typevars_map.values()) and typevars_map:
+            return cls  # if arguments are equal to parameters it's the same object
+
+        # Create new model with original model as parent inserting fields with DeferredType.
+        model_name = cls.__concrete_name__(params)
+        validators = gather_all_validators(cls)
+
+        type_hints = get_all_type_hints(cls).items()
+        instance_type_hints = {k: v for k, v in type_hints if get_origin(v) is not ClassVar}
+
+        fields = {k: (DeferredType(), cls.__fields__[k].field_info) for k in instance_type_hints if k in cls.__fields__}
+
+        model_module, called_globally = get_caller_frame_info()
+        created_model = cast(
+            Type[GenericModel],  # casting ensures mypy is aware of the __concrete__ and __parameters__ attributes
+            create_model(
+                model_name,
+                __module__=model_module or cls.__module__,
+                __base__=(cls,) + tuple(cls.__parameterized_bases__(typevars_map)),
+                __config__=None,
+                __validators__=validators,
+                __cls_kwargs__=None,
+                **fields,
+            ),
+        )
+
+        _assigned_parameters[created_model] = typevars_map
+
+        if called_globally:  # create global reference and therefore allow pickling
+            object_by_reference = None
+            reference_name = model_name
+            reference_module_globals = sys.modules[created_model.__module__].__dict__
+            while object_by_reference is not created_model:
+                object_by_reference = reference_module_globals.setdefault(reference_name, created_model)
+                reference_name += '_'
+
+        created_model.Config = cls.Config
+
+        # Find any typevars that are still present in the model.
+        # If none are left, the model is fully "concrete", otherwise the new
+        # class is a generic class as well taking the found typevars as
+        # parameters.
+        new_params = tuple(
+            {param: None for param in iter_contained_typevars(typevars_map.values())}
+        )  # use dict as ordered set
+        created_model.__concrete__ = not new_params
+        if new_params:
+            created_model.__parameters__ = new_params
+
+        # Save created model in cache so we don't end up creating duplicate
+        # models that should be identical.
+        _generic_types_cache[_cache_key(params)] = created_model
+        if len(params) == 1:
+            _generic_types_cache[_cache_key(params[0])] = created_model
+
+        # Recursively walk class type hints and replace generic typevars
+        # with concrete types that were passed.
+        _prepare_model_fields(created_model, fields, instance_type_hints, typevars_map)
+
+        return created_model
+
+    @classmethod
+    def __concrete_name__(cls: Type[Any], params: Tuple[Type[Any], ...]) -> str:
+        """Compute class name for child classes.
+
+        :param params: Tuple of types the class . Given a generic class
+            `Model` with 2 type variables and a concrete model `Model[str, int]`,
+            the value `(str, int)` would be passed to `params`.
+        :return: String representing a the new class where `params` are
+            passed to `cls` as type variables.
+
+        This method can be overridden to achieve a custom naming scheme for GenericModels.
+        """
+        param_names = [display_as_type(param) for param in params]
+        params_component = ', '.join(param_names)
+        return f'{cls.__name__}[{params_component}]'
+
+    @classmethod
+    def __parameterized_bases__(cls, typevars_map: Parametrization) -> Iterator[Type[Any]]:
+        """
+        Returns unbound bases of cls parameterised to given type variables
+
+        :param typevars_map: Dictionary of type applications for binding subclasses.
+            Given a generic class `Model` with 2 type variables [S, T]
+            and a concrete model `Model[str, int]`,
+            the value `{S: str, T: int}` would be passed to `typevars_map`.
+        :return: an iterator of generic sub classes, parameterised by `typevars_map`
+            and other assigned parameters of `cls`
+
+        e.g.:
+        ```
+        class A(GenericModel, Generic[T]):
+            ...
+
+        class B(A[V], Generic[V]):
+            ...
+
+        assert A[int] in B.__parameterized_bases__({V: int})
+        ```
+        """
+
+        def build_base_model(
+            base_model: Type[GenericModel], mapped_types: Parametrization
+        ) -> Iterator[Type[GenericModel]]:
+            base_parameters = tuple(mapped_types[param] for param in base_model.__parameters__)
+            parameterized_base = base_model.__class_getitem__(base_parameters)
+            if parameterized_base is base_model or parameterized_base is cls:
+                # Avoid duplication in MRO
+                return
+            yield parameterized_base
+
+        for base_model in cls.__bases__:
+            if not issubclass(base_model, GenericModel):
+                # not a class that can be meaningfully parameterized
+                continue
+            elif not getattr(base_model, '__parameters__', None):
+                # base_model is "GenericModel"  (and has no __parameters__)
+                # or
+                # base_model is already concrete, and will be included transitively via cls.
+                continue
+            elif cls in _assigned_parameters:
+                if base_model in _assigned_parameters:
+                    # cls is partially parameterised but not from base_model
+                    # e.g. cls = B[S], base_model = A[S]
+                    # B[S][int] should subclass A[int],  (and will be transitively via B[int])
+                    # but it's not viable to consistently subclass types with arbitrary construction
+                    # So don't attempt to include A[S][int]
+                    continue
+                else:  # base_model not in _assigned_parameters:
+                    # cls is partially parameterized, base_model is original generic
+                    # e.g.  cls = B[str, T], base_model = B[S, T]
+                    # Need to determine the mapping for the base_model parameters
+                    mapped_types: Parametrization = {
+                        key: typevars_map.get(value, value) for key, value in _assigned_parameters[cls].items()
+                    }
+                    yield from build_base_model(base_model, mapped_types)
+            else:
+                # cls is base generic, so base_class has a distinct base
+                # can construct the Parameterised base model using typevars_map directly
+                yield from build_base_model(base_model, typevars_map)
+
+
+def replace_types(type_: Any, type_map: Mapping[Any, Any]) -> Any:
+    """Return type with all occurrences of `type_map` keys recursively replaced with their values.
+
+    :param type_: Any type, class or generic alias
+    :param type_map: Mapping from `TypeVar` instance to concrete types.
+    :return: New type representing the basic structure of `type_` with all
+        `typevar_map` keys recursively replaced.
+
+    >>> replace_types(Tuple[str, Union[List[str], float]], {str: int})
+    Tuple[int, Union[List[int], float]]
+
+    """
+    if not type_map:
+        return type_
+
+    type_args = get_args(type_)
+    origin_type = get_origin(type_)
+
+    if origin_type is Annotated:
+        annotated_type, *annotations = type_args
+        return Annotated[replace_types(annotated_type, type_map), tuple(annotations)]
+
+    # Having type args is a good indicator that this is a typing module
+    # class instantiation or a generic alias of some sort.
+    if type_args:
+        resolved_type_args = tuple(replace_types(arg, type_map) for arg in type_args)
+        if all_identical(type_args, resolved_type_args):
+            # If all arguments are the same, there is no need to modify the
+            # type or create a new object at all
+            return type_
+        if (
+            origin_type is not None
+            and isinstance(type_, typing_base)
+            and not isinstance(origin_type, typing_base)
+            and getattr(type_, '_name', None) is not None
+        ):
+            # In python < 3.9 generic aliases don't exist so any of these like `list`,
+            # `type` or `collections.abc.Callable` need to be translated.
+            # See: https://www.python.org/dev/peps/pep-0585
+            origin_type = getattr(typing, type_._name)
+        assert origin_type is not None
+        return origin_type[resolved_type_args]
+
+    # We handle pydantic generic models separately as they don't have the same
+    # semantics as "typing" classes or generic aliases
+    if not origin_type and lenient_issubclass(type_, GenericModel) and not type_.__concrete__:
+        type_args = type_.__parameters__
+        resolved_type_args = tuple(replace_types(t, type_map) for t in type_args)
+        if all_identical(type_args, resolved_type_args):
+            return type_
+        return type_[resolved_type_args]
+
+    # Handle special case for typehints that can have lists as arguments.
+    # `typing.Callable[[int, str], int]` is an example for this.
+    if isinstance(type_, (List, list)):
+        resolved_list = list(replace_types(element, type_map) for element in type_)
+        if all_identical(type_, resolved_list):
+            return type_
+        return resolved_list
+
+    # For JsonWrapperValue, need to handle its inner type to allow correct parsing
+    # of generic Json arguments like Json[T]
+    if not origin_type and lenient_issubclass(type_, JsonWrapper):
+        type_.inner_type = replace_types(type_.inner_type, type_map)
+        return type_
+
+    # If all else fails, we try to resolve the type directly and otherwise just
+    # return the input with no modifications.
+    return type_map.get(type_, type_)
+
+
+def check_parameters_count(cls: Type[GenericModel], parameters: Tuple[Any, ...]) -> None:
+    actual = len(parameters)
+    expected = len(cls.__parameters__)
+    if actual != expected:
+        description = 'many' if actual > expected else 'few'
+        raise TypeError(f'Too {description} parameters for {cls.__name__}; actual {actual}, expected {expected}')
+
+
+DictValues: Type[Any] = {}.values().__class__
+
+
+def iter_contained_typevars(v: Any) -> Iterator[TypeVarType]:
+    """Recursively iterate through all subtypes and type args of `v` and yield any typevars that are found."""
+    if isinstance(v, TypeVar):
+        yield v
+    elif hasattr(v, '__parameters__') and not get_origin(v) and lenient_issubclass(v, GenericModel):
+        yield from v.__parameters__
+    elif isinstance(v, (DictValues, list)):
+        for var in v:
+            yield from iter_contained_typevars(var)
+    else:
+        args = get_args(v)
+        for arg in args:
+            yield from iter_contained_typevars(arg)
+
+
+def get_caller_frame_info() -> Tuple[Optional[str], bool]:
+    """
+    Used inside a function to check whether it was called globally
+
+    Will only work against non-compiled code, therefore used only in pydantic.generics
+
+    :returns Tuple[module_name, called_globally]
+    """
+    try:
+        previous_caller_frame = sys._getframe(2)
+    except ValueError as e:
+        raise RuntimeError('This function must be used inside another function') from e
+    except AttributeError:  # sys module does not have _getframe function, so there's nothing we can do about it
+        return None, False
+    frame_globals = previous_caller_frame.f_globals
+    return frame_globals.get('__name__'), previous_caller_frame.f_locals is frame_globals
+
+
+def _prepare_model_fields(
+    created_model: Type[GenericModel],
+    fields: Mapping[str, Any],
+    instance_type_hints: Mapping[str, type],
+    typevars_map: Mapping[Any, type],
+) -> None:
+    """
+    Replace DeferredType fields with concrete type hints and prepare them.
+    """
+
+    for key, field in created_model.__fields__.items():
+        if key not in fields:
+            assert field.type_.__class__ is not DeferredType
+            # https://github.com/nedbat/coveragepy/issues/198
+            continue  # pragma: no cover
+
+        assert field.type_.__class__ is DeferredType, field.type_.__class__
+
+        field_type_hint = instance_type_hints[key]
+        concrete_type = replace_types(field_type_hint, typevars_map)
+        field.type_ = concrete_type
+        field.outer_type_ = concrete_type
+        field.prepare()
+        created_model.__annotations__[key] = concrete_type
diff --git a/lib/pydantic/json.py b/lib/pydantic/json.py
new file mode 100644
index 00000000..b358b850
--- /dev/null
+++ b/lib/pydantic/json.py
@@ -0,0 +1,112 @@
+import datetime
+from collections import deque
+from decimal import Decimal
+from enum import Enum
+from ipaddress import IPv4Address, IPv4Interface, IPv4Network, IPv6Address, IPv6Interface, IPv6Network
+from pathlib import Path
+from re import Pattern
+from types import GeneratorType
+from typing import Any, Callable, Dict, Type, Union
+from uuid import UUID
+
+from .color import Color
+from .networks import NameEmail
+from .types import SecretBytes, SecretStr
+
+__all__ = 'pydantic_encoder', 'custom_pydantic_encoder', 'timedelta_isoformat'
+
+
+def isoformat(o: Union[datetime.date, datetime.time]) -> str:
+    return o.isoformat()
+
+
+def decimal_encoder(dec_value: Decimal) -> Union[int, float]:
+    """
+    Encodes a Decimal as int of there's no exponent, otherwise float
+
+    This is useful when we use ConstrainedDecimal to represent Numeric(x,0)
+    where a integer (but not int typed) is used. Encoding this as a float
+    results in failed round-tripping between encode and parse.
+    Our Id type is a prime example of this.
+
+    >>> decimal_encoder(Decimal("1.0"))
+    1.0
+
+    >>> decimal_encoder(Decimal("1"))
+    1
+    """
+    if dec_value.as_tuple().exponent >= 0:
+        return int(dec_value)
+    else:
+        return float(dec_value)
+
+
+ENCODERS_BY_TYPE: Dict[Type[Any], Callable[[Any], Any]] = {
+    bytes: lambda o: o.decode(),
+    Color: str,
+    datetime.date: isoformat,
+    datetime.datetime: isoformat,
+    datetime.time: isoformat,
+    datetime.timedelta: lambda td: td.total_seconds(),
+    Decimal: decimal_encoder,
+    Enum: lambda o: o.value,
+    frozenset: list,
+    deque: list,
+    GeneratorType: list,
+    IPv4Address: str,
+    IPv4Interface: str,
+    IPv4Network: str,
+    IPv6Address: str,
+    IPv6Interface: str,
+    IPv6Network: str,
+    NameEmail: str,
+    Path: str,
+    Pattern: lambda o: o.pattern,
+    SecretBytes: str,
+    SecretStr: str,
+    set: list,
+    UUID: str,
+}
+
+
+def pydantic_encoder(obj: Any) -> Any:
+    from dataclasses import asdict, is_dataclass
+
+    from .main import BaseModel
+
+    if isinstance(obj, BaseModel):
+        return obj.dict()
+    elif is_dataclass(obj):
+        return asdict(obj)
+
+    # Check the class type and its superclasses for a matching encoder
+    for base in obj.__class__.__mro__[:-1]:
+        try:
+            encoder = ENCODERS_BY_TYPE[base]
+        except KeyError:
+            continue
+        return encoder(obj)
+    else:  # We have exited the for loop without finding a suitable encoder
+        raise TypeError(f"Object of type '{obj.__class__.__name__}' is not JSON serializable")
+
+
+def custom_pydantic_encoder(type_encoders: Dict[Any, Callable[[Type[Any]], Any]], obj: Any) -> Any:
+    # Check the class type and its superclasses for a matching encoder
+    for base in obj.__class__.__mro__[:-1]:
+        try:
+            encoder = type_encoders[base]
+        except KeyError:
+            continue
+
+        return encoder(obj)
+    else:  # We have exited the for loop without finding a suitable encoder
+        return pydantic_encoder(obj)
+
+
+def timedelta_isoformat(td: datetime.timedelta) -> str:
+    """
+    ISO 8601 encoding for Python timedelta object.
+    """
+    minutes, seconds = divmod(td.seconds, 60)
+    hours, minutes = divmod(minutes, 60)
+    return f'{"-" if td.days < 0 else ""}P{abs(td.days)}DT{hours:d}H{minutes:d}M{seconds:d}.{td.microseconds:06d}S'
diff --git a/lib/pydantic/main.py b/lib/pydantic/main.py
new file mode 100644
index 00000000..69f3b751
--- /dev/null
+++ b/lib/pydantic/main.py
@@ -0,0 +1,1109 @@
+import warnings
+from abc import ABCMeta
+from copy import deepcopy
+from enum import Enum
+from functools import partial
+from pathlib import Path
+from types import FunctionType, prepare_class, resolve_bases
+from typing import (
+    TYPE_CHECKING,
+    AbstractSet,
+    Any,
+    Callable,
+    ClassVar,
+    Dict,
+    List,
+    Mapping,
+    Optional,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+    cast,
+    no_type_check,
+    overload,
+)
+
+from typing_extensions import dataclass_transform
+
+from .class_validators import ValidatorGroup, extract_root_validators, extract_validators, inherit_validators
+from .config import BaseConfig, Extra, inherit_config, prepare_config
+from .error_wrappers import ErrorWrapper, ValidationError
+from .errors import ConfigError, DictError, ExtraError, MissingError
+from .fields import (
+    MAPPING_LIKE_SHAPES,
+    Field,
+    FieldInfo,
+    ModelField,
+    ModelPrivateAttr,
+    PrivateAttr,
+    Undefined,
+    is_finalvar_with_default_val,
+)
+from .json import custom_pydantic_encoder, pydantic_encoder
+from .parse import Protocol, load_file, load_str_bytes
+from .schema import default_ref_template, model_schema
+from .types import PyObject, StrBytes
+from .typing import (
+    AnyCallable,
+    get_args,
+    get_origin,
+    is_classvar,
+    is_namedtuple,
+    is_union,
+    resolve_annotations,
+    update_model_forward_refs,
+)
+from .utils import (
+    DUNDER_ATTRIBUTES,
+    ROOT_KEY,
+    ClassAttribute,
+    GetterDict,
+    Representation,
+    ValueItems,
+    generate_model_signature,
+    is_valid_field,
+    is_valid_private_name,
+    lenient_issubclass,
+    sequence_like,
+    smart_deepcopy,
+    unique_list,
+    validate_field_name,
+)
+
+if TYPE_CHECKING:
+    from inspect import Signature
+
+    from .class_validators import ValidatorListDict
+    from .types import ModelOrDc
+    from .typing import (
+        AbstractSetIntStr,
+        AnyClassMethod,
+        CallableGenerator,
+        DictAny,
+        DictStrAny,
+        MappingIntStrAny,
+        ReprArgs,
+        SetStr,
+        TupleGenerator,
+    )
+
+    Model = TypeVar('Model', bound='BaseModel')
+
+__all__ = 'BaseModel', 'create_model', 'validate_model'
+
+_T = TypeVar('_T')
+
+
+def validate_custom_root_type(fields: Dict[str, ModelField]) -> None:
+    if len(fields) > 1:
+        raise ValueError(f'{ROOT_KEY} cannot be mixed with other fields')
+
+
+def generate_hash_function(frozen: bool) -> Optional[Callable[[Any], int]]:
+    def hash_function(self_: Any) -> int:
+        return hash(self_.__class__) + hash(tuple(self_.__dict__.values()))
+
+    return hash_function if frozen else None
+
+
+# If a field is of type `Callable`, its default value should be a function and cannot to ignored.
+ANNOTATED_FIELD_UNTOUCHED_TYPES: Tuple[Any, ...] = (property, type, classmethod, staticmethod)
+# When creating a `BaseModel` instance, we bypass all the methods, properties... added to the model
+UNTOUCHED_TYPES: Tuple[Any, ...] = (FunctionType,) + ANNOTATED_FIELD_UNTOUCHED_TYPES
+# Note `ModelMetaclass` refers to `BaseModel`, but is also used to *create* `BaseModel`, so we need to add this extra
+# (somewhat hacky) boolean to keep track of whether we've created the `BaseModel` class yet, and therefore whether it's
+# safe to refer to it. If it *hasn't* been created, we assume that the `__new__` call we're in the middle of is for
+# the `BaseModel` class, since that's defined immediately after the metaclass.
+_is_base_model_class_defined = False
+
+
+@dataclass_transform(kw_only_default=True, field_descriptors=(Field, FieldInfo))
+class ModelMetaclass(ABCMeta):
+    @no_type_check  # noqa C901
+    def __new__(mcs, name, bases, namespace, **kwargs):  # noqa C901
+        fields: Dict[str, ModelField] = {}
+        config = BaseConfig
+        validators: 'ValidatorListDict' = {}
+
+        pre_root_validators, post_root_validators = [], []
+        private_attributes: Dict[str, ModelPrivateAttr] = {}
+        base_private_attributes: Dict[str, ModelPrivateAttr] = {}
+        slots: SetStr = namespace.get('__slots__', ())
+        slots = {slots} if isinstance(slots, str) else set(slots)
+        class_vars: SetStr = set()
+        hash_func: Optional[Callable[[Any], int]] = None
+
+        for base in reversed(bases):
+            if _is_base_model_class_defined and issubclass(base, BaseModel) and base != BaseModel:
+                fields.update(smart_deepcopy(base.__fields__))
+                config = inherit_config(base.__config__, config)
+                validators = inherit_validators(base.__validators__, validators)
+                pre_root_validators += base.__pre_root_validators__
+                post_root_validators += base.__post_root_validators__
+                base_private_attributes.update(base.__private_attributes__)
+                class_vars.update(base.__class_vars__)
+                hash_func = base.__hash__
+
+        resolve_forward_refs = kwargs.pop('__resolve_forward_refs__', True)
+        allowed_config_kwargs: SetStr = {
+            key
+            for key in dir(config)
+            if not (key.startswith('__') and key.endswith('__'))  # skip dunder methods and attributes
+        }
+        config_kwargs = {key: kwargs.pop(key) for key in kwargs.keys() & allowed_config_kwargs}
+        config_from_namespace = namespace.get('Config')
+        if config_kwargs and config_from_namespace:
+            raise TypeError('Specifying config in two places is ambiguous, use either Config attribute or class kwargs')
+        config = inherit_config(config_from_namespace, config, **config_kwargs)
+
+        validators = inherit_validators(extract_validators(namespace), validators)
+        vg = ValidatorGroup(validators)
+
+        for f in fields.values():
+            f.set_config(config)
+            extra_validators = vg.get_validators(f.name)
+            if extra_validators:
+                f.class_validators.update(extra_validators)
+                # re-run prepare to add extra validators
+                f.populate_validators()
+
+        prepare_config(config, name)
+
+        untouched_types = ANNOTATED_FIELD_UNTOUCHED_TYPES
+
+        def is_untouched(v: Any) -> bool:
+            return isinstance(v, untouched_types) or v.__class__.__name__ == 'cython_function_or_method'
+
+        if (namespace.get('__module__'), namespace.get('__qualname__')) != ('pydantic.main', 'BaseModel'):
+            annotations = resolve_annotations(namespace.get('__annotations__', {}), namespace.get('__module__', None))
+            # annotation only fields need to come first in fields
+            for ann_name, ann_type in annotations.items():
+                if is_classvar(ann_type):
+                    class_vars.add(ann_name)
+                elif is_finalvar_with_default_val(ann_type, namespace.get(ann_name, Undefined)):
+                    class_vars.add(ann_name)
+                elif is_valid_field(ann_name):
+                    validate_field_name(bases, ann_name)
+                    value = namespace.get(ann_name, Undefined)
+                    allowed_types = get_args(ann_type) if is_union(get_origin(ann_type)) else (ann_type,)
+                    if (
+                        is_untouched(value)
+                        and ann_type != PyObject
+                        and not any(
+                            lenient_issubclass(get_origin(allowed_type), Type) for allowed_type in allowed_types
+                        )
+                    ):
+                        continue
+                    fields[ann_name] = ModelField.infer(
+                        name=ann_name,
+                        value=value,
+                        annotation=ann_type,
+                        class_validators=vg.get_validators(ann_name),
+                        config=config,
+                    )
+                elif ann_name not in namespace and config.underscore_attrs_are_private:
+                    private_attributes[ann_name] = PrivateAttr()
+
+            untouched_types = UNTOUCHED_TYPES + config.keep_untouched
+            for var_name, value in namespace.items():
+                can_be_changed = var_name not in class_vars and not is_untouched(value)
+                if isinstance(value, ModelPrivateAttr):
+                    if not is_valid_private_name(var_name):
+                        raise NameError(
+                            f'Private attributes "{var_name}" must not be a valid field name; '
+                            f'Use sunder or dunder names, e. g. "_{var_name}" or "__{var_name}__"'
+                        )
+                    private_attributes[var_name] = value
+                elif config.underscore_attrs_are_private and is_valid_private_name(var_name) and can_be_changed:
+                    private_attributes[var_name] = PrivateAttr(default=value)
+                elif is_valid_field(var_name) and var_name not in annotations and can_be_changed:
+                    validate_field_name(bases, var_name)
+                    inferred = ModelField.infer(
+                        name=var_name,
+                        value=value,
+                        annotation=annotations.get(var_name, Undefined),
+                        class_validators=vg.get_validators(var_name),
+                        config=config,
+                    )
+                    if var_name in fields:
+                        if lenient_issubclass(inferred.type_, fields[var_name].type_):
+                            inferred.type_ = fields[var_name].type_
+                        else:
+                            raise TypeError(
+                                f'The type of {name}.{var_name} differs from the new default value; '
+                                f'if you wish to change the type of this field, please use a type annotation'
+                            )
+                    fields[var_name] = inferred
+
+        _custom_root_type = ROOT_KEY in fields
+        if _custom_root_type:
+            validate_custom_root_type(fields)
+        vg.check_for_unused()
+        if config.json_encoders:
+            json_encoder = partial(custom_pydantic_encoder, config.json_encoders)
+        else:
+            json_encoder = pydantic_encoder
+        pre_rv_new, post_rv_new = extract_root_validators(namespace)
+
+        if hash_func is None:
+            hash_func = generate_hash_function(config.frozen)
+
+        exclude_from_namespace = fields | private_attributes.keys() | {'__slots__'}
+        new_namespace = {
+            '__config__': config,
+            '__fields__': fields,
+            '__exclude_fields__': {
+                name: field.field_info.exclude for name, field in fields.items() if field.field_info.exclude is not None
+            }
+            or None,
+            '__include_fields__': {
+                name: field.field_info.include for name, field in fields.items() if field.field_info.include is not None
+            }
+            or None,
+            '__validators__': vg.validators,
+            '__pre_root_validators__': unique_list(
+                pre_root_validators + pre_rv_new,
+                name_factory=lambda v: v.__name__,
+            ),
+            '__post_root_validators__': unique_list(
+                post_root_validators + post_rv_new,
+                name_factory=lambda skip_on_failure_and_v: skip_on_failure_and_v[1].__name__,
+            ),
+            '__schema_cache__': {},
+            '__json_encoder__': staticmethod(json_encoder),
+            '__custom_root_type__': _custom_root_type,
+            '__private_attributes__': {**base_private_attributes, **private_attributes},
+            '__slots__': slots | private_attributes.keys(),
+            '__hash__': hash_func,
+            '__class_vars__': class_vars,
+            **{n: v for n, v in namespace.items() if n not in exclude_from_namespace},
+        }
+
+        cls = super().__new__(mcs, name, bases, new_namespace, **kwargs)
+        # set __signature__ attr only for model class, but not for its instances
+        cls.__signature__ = ClassAttribute('__signature__', generate_model_signature(cls.__init__, fields, config))
+        if resolve_forward_refs:
+            cls.__try_update_forward_refs__()
+
+        # preserve `__set_name__` protocol defined in https://peps.python.org/pep-0487
+        # for attributes not in `new_namespace` (e.g. private attributes)
+        for name, obj in namespace.items():
+            if name not in new_namespace:
+                set_name = getattr(obj, '__set_name__', None)
+                if callable(set_name):
+                    set_name(cls, name)
+
+        return cls
+
+    def __instancecheck__(self, instance: Any) -> bool:
+        """
+        Avoid calling ABC _abc_subclasscheck unless we're pretty sure.
+
+        See #3829 and python/cpython#92810
+        """
+        return hasattr(instance, '__fields__') and super().__instancecheck__(instance)
+
+
+object_setattr = object.__setattr__
+
+
+class BaseModel(Representation, metaclass=ModelMetaclass):
+    if TYPE_CHECKING:
+        # populated by the metaclass, defined here to help IDEs only
+        __fields__: ClassVar[Dict[str, ModelField]] = {}
+        __include_fields__: ClassVar[Optional[Mapping[str, Any]]] = None
+        __exclude_fields__: ClassVar[Optional[Mapping[str, Any]]] = None
+        __validators__: ClassVar[Dict[str, AnyCallable]] = {}
+        __pre_root_validators__: ClassVar[List[AnyCallable]]
+        __post_root_validators__: ClassVar[List[Tuple[bool, AnyCallable]]]
+        __config__: ClassVar[Type[BaseConfig]] = BaseConfig
+        __json_encoder__: ClassVar[Callable[[Any], Any]] = lambda x: x
+        __schema_cache__: ClassVar['DictAny'] = {}
+        __custom_root_type__: ClassVar[bool] = False
+        __signature__: ClassVar['Signature']
+        __private_attributes__: ClassVar[Dict[str, ModelPrivateAttr]]
+        __class_vars__: ClassVar[SetStr]
+        __fields_set__: ClassVar[SetStr] = set()
+
+    Config = BaseConfig
+    __slots__ = ('__dict__', '__fields_set__')
+    __doc__ = ''  # Null out the Representation docstring
+
+    def __init__(__pydantic_self__, **data: Any) -> None:
+        """
+        Create a new model by parsing and validating input data from keyword arguments.
+
+        Raises ValidationError if the input data cannot be parsed to form a valid model.
+        """
+        # Uses something other than `self` the first arg to allow "self" as a settable attribute
+        values, fields_set, validation_error = validate_model(__pydantic_self__.__class__, data)
+        if validation_error:
+            raise validation_error
+        try:
+            object_setattr(__pydantic_self__, '__dict__', values)
+        except TypeError as e:
+            raise TypeError(
+                'Model values must be a dict; you may not have returned a dictionary from a root validator'
+            ) from e
+        object_setattr(__pydantic_self__, '__fields_set__', fields_set)
+        __pydantic_self__._init_private_attributes()
+
+    @no_type_check
+    def __setattr__(self, name, value):  # noqa: C901 (ignore complexity)
+        if name in self.__private_attributes__ or name in DUNDER_ATTRIBUTES:
+            return object_setattr(self, name, value)
+
+        if self.__config__.extra is not Extra.allow and name not in self.__fields__:
+            raise ValueError(f'"{self.__class__.__name__}" object has no field "{name}"')
+        elif not self.__config__.allow_mutation or self.__config__.frozen:
+            raise TypeError(f'"{self.__class__.__name__}" is immutable and does not support item assignment')
+        elif name in self.__fields__ and self.__fields__[name].final:
+            raise TypeError(
+                f'"{self.__class__.__name__}" object "{name}" field is final and does not support reassignment'
+            )
+        elif self.__config__.validate_assignment:
+            new_values = {**self.__dict__, name: value}
+
+            for validator in self.__pre_root_validators__:
+                try:
+                    new_values = validator(self.__class__, new_values)
+                except (ValueError, TypeError, AssertionError) as exc:
+                    raise ValidationError([ErrorWrapper(exc, loc=ROOT_KEY)], self.__class__)
+
+            known_field = self.__fields__.get(name, None)
+            if known_field:
+                # We want to
+                # - make sure validators are called without the current value for this field inside `values`
+                # - keep other values (e.g. submodels) untouched (using `BaseModel.dict()` will change them into dicts)
+                # - keep the order of the fields
+                if not known_field.field_info.allow_mutation:
+                    raise TypeError(f'"{known_field.name}" has allow_mutation set to False and cannot be assigned')
+                dict_without_original_value = {k: v for k, v in self.__dict__.items() if k != name}
+                value, error_ = known_field.validate(value, dict_without_original_value, loc=name, cls=self.__class__)
+                if error_:
+                    raise ValidationError([error_], self.__class__)
+                else:
+                    new_values[name] = value
+
+            errors = []
+            for skip_on_failure, validator in self.__post_root_validators__:
+                if skip_on_failure and errors:
+                    continue
+                try:
+                    new_values = validator(self.__class__, new_values)
+                except (ValueError, TypeError, AssertionError) as exc:
+                    errors.append(ErrorWrapper(exc, loc=ROOT_KEY))
+            if errors:
+                raise ValidationError(errors, self.__class__)
+
+            # update the whole __dict__ as other values than just `value`
+            # may be changed (e.g. with `root_validator`)
+            object_setattr(self, '__dict__', new_values)
+        else:
+            self.__dict__[name] = value
+
+        self.__fields_set__.add(name)
+
+    def __getstate__(self) -> 'DictAny':
+        private_attrs = ((k, getattr(self, k, Undefined)) for k in self.__private_attributes__)
+        return {
+            '__dict__': self.__dict__,
+            '__fields_set__': self.__fields_set__,
+            '__private_attribute_values__': {k: v for k, v in private_attrs if v is not Undefined},
+        }
+
+    def __setstate__(self, state: 'DictAny') -> None:
+        object_setattr(self, '__dict__', state['__dict__'])
+        object_setattr(self, '__fields_set__', state['__fields_set__'])
+        for name, value in state.get('__private_attribute_values__', {}).items():
+            object_setattr(self, name, value)
+
+    def _init_private_attributes(self) -> None:
+        for name, private_attr in self.__private_attributes__.items():
+            default = private_attr.get_default()
+            if default is not Undefined:
+                object_setattr(self, name, default)
+
+    def dict(
+        self,
+        *,
+        include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
+        exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
+        by_alias: bool = False,
+        skip_defaults: Optional[bool] = None,
+        exclude_unset: bool = False,
+        exclude_defaults: bool = False,
+        exclude_none: bool = False,
+    ) -> 'DictStrAny':
+        """
+        Generate a dictionary representation of the model, optionally specifying which fields to include or exclude.
+
+        """
+        if skip_defaults is not None:
+            warnings.warn(
+                f'{self.__class__.__name__}.dict(): "skip_defaults" is deprecated and replaced by "exclude_unset"',
+                DeprecationWarning,
+            )
+            exclude_unset = skip_defaults
+
+        return dict(
+            self._iter(
+                to_dict=True,
+                by_alias=by_alias,
+                include=include,
+                exclude=exclude,
+                exclude_unset=exclude_unset,
+                exclude_defaults=exclude_defaults,
+                exclude_none=exclude_none,
+            )
+        )
+
+    def json(
+        self,
+        *,
+        include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
+        exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
+        by_alias: bool = False,
+        skip_defaults: Optional[bool] = None,
+        exclude_unset: bool = False,
+        exclude_defaults: bool = False,
+        exclude_none: bool = False,
+        encoder: Optional[Callable[[Any], Any]] = None,
+        models_as_dict: bool = True,
+        **dumps_kwargs: Any,
+    ) -> str:
+        """
+        Generate a JSON representation of the model, `include` and `exclude` arguments as per `dict()`.
+
+        `encoder` is an optional function to supply as `default` to json.dumps(), other arguments as per `json.dumps()`.
+        """
+        if skip_defaults is not None:
+            warnings.warn(
+                f'{self.__class__.__name__}.json(): "skip_defaults" is deprecated and replaced by "exclude_unset"',
+                DeprecationWarning,
+            )
+            exclude_unset = skip_defaults
+        encoder = cast(Callable[[Any], Any], encoder or self.__json_encoder__)
+
+        # We don't directly call `self.dict()`, which does exactly this with `to_dict=True`
+        # because we want to be able to keep raw `BaseModel` instances and not as `dict`.
+        # This allows users to write custom JSON encoders for given `BaseModel` classes.
+        data = dict(
+            self._iter(
+                to_dict=models_as_dict,
+                by_alias=by_alias,
+                include=include,
+                exclude=exclude,
+                exclude_unset=exclude_unset,
+                exclude_defaults=exclude_defaults,
+                exclude_none=exclude_none,
+            )
+        )
+        if self.__custom_root_type__:
+            data = data[ROOT_KEY]
+        return self.__config__.json_dumps(data, default=encoder, **dumps_kwargs)
+
+    @classmethod
+    def _enforce_dict_if_root(cls, obj: Any) -> Any:
+        if cls.__custom_root_type__ and (
+            not (isinstance(obj, dict) and obj.keys() == {ROOT_KEY})
+            or cls.__fields__[ROOT_KEY].shape in MAPPING_LIKE_SHAPES
+        ):
+            return {ROOT_KEY: obj}
+        else:
+            return obj
+
+    @classmethod
+    def parse_obj(cls: Type['Model'], obj: Any) -> 'Model':
+        obj = cls._enforce_dict_if_root(obj)
+        if not isinstance(obj, dict):
+            try:
+                obj = dict(obj)
+            except (TypeError, ValueError) as e:
+                exc = TypeError(f'{cls.__name__} expected dict not {obj.__class__.__name__}')
+                raise ValidationError([ErrorWrapper(exc, loc=ROOT_KEY)], cls) from e
+        return cls(**obj)
+
+    @classmethod
+    def parse_raw(
+        cls: Type['Model'],
+        b: StrBytes,
+        *,
+        content_type: str = None,
+        encoding: str = 'utf8',
+        proto: Protocol = None,
+        allow_pickle: bool = False,
+    ) -> 'Model':
+        try:
+            obj = load_str_bytes(
+                b,
+                proto=proto,
+                content_type=content_type,
+                encoding=encoding,
+                allow_pickle=allow_pickle,
+                json_loads=cls.__config__.json_loads,
+            )
+        except (ValueError, TypeError, UnicodeDecodeError) as e:
+            raise ValidationError([ErrorWrapper(e, loc=ROOT_KEY)], cls)
+        return cls.parse_obj(obj)
+
+    @classmethod
+    def parse_file(
+        cls: Type['Model'],
+        path: Union[str, Path],
+        *,
+        content_type: str = None,
+        encoding: str = 'utf8',
+        proto: Protocol = None,
+        allow_pickle: bool = False,
+    ) -> 'Model':
+        obj = load_file(
+            path,
+            proto=proto,
+            content_type=content_type,
+            encoding=encoding,
+            allow_pickle=allow_pickle,
+            json_loads=cls.__config__.json_loads,
+        )
+        return cls.parse_obj(obj)
+
+    @classmethod
+    def from_orm(cls: Type['Model'], obj: Any) -> 'Model':
+        if not cls.__config__.orm_mode:
+            raise ConfigError('You must have the config attribute orm_mode=True to use from_orm')
+        obj = {ROOT_KEY: obj} if cls.__custom_root_type__ else cls._decompose_class(obj)
+        m = cls.__new__(cls)
+        values, fields_set, validation_error = validate_model(cls, obj)
+        if validation_error:
+            raise validation_error
+        object_setattr(m, '__dict__', values)
+        object_setattr(m, '__fields_set__', fields_set)
+        m._init_private_attributes()
+        return m
+
+    @classmethod
+    def construct(cls: Type['Model'], _fields_set: Optional['SetStr'] = None, **values: Any) -> 'Model':
+        """
+        Creates a new model setting __dict__ and __fields_set__ from trusted or pre-validated data.
+        Default values are respected, but no other validation is performed.
+        Behaves as if `Config.extra = 'allow'` was set since it adds all passed values
+        """
+        m = cls.__new__(cls)
+        fields_values: Dict[str, Any] = {}
+        for name, field in cls.__fields__.items():
+            if field.alt_alias and field.alias in values:
+                fields_values[name] = values[field.alias]
+            elif name in values:
+                fields_values[name] = values[name]
+            elif not field.required:
+                fields_values[name] = field.get_default()
+        fields_values.update(values)
+        object_setattr(m, '__dict__', fields_values)
+        if _fields_set is None:
+            _fields_set = set(values.keys())
+        object_setattr(m, '__fields_set__', _fields_set)
+        m._init_private_attributes()
+        return m
+
+    def _copy_and_set_values(self: 'Model', values: 'DictStrAny', fields_set: 'SetStr', *, deep: bool) -> 'Model':
+        if deep:
+            # chances of having empty dict here are quite low for using smart_deepcopy
+            values = deepcopy(values)
+
+        cls = self.__class__
+        m = cls.__new__(cls)
+        object_setattr(m, '__dict__', values)
+        object_setattr(m, '__fields_set__', fields_set)
+        for name in self.__private_attributes__:
+            value = getattr(self, name, Undefined)
+            if value is not Undefined:
+                if deep:
+                    value = deepcopy(value)
+                object_setattr(m, name, value)
+
+        return m
+
+    def copy(
+        self: 'Model',
+        *,
+        include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
+        exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
+        update: Optional['DictStrAny'] = None,
+        deep: bool = False,
+    ) -> 'Model':
+        """
+        Duplicate a model, optionally choose which fields to include, exclude and change.
+
+        :param include: fields to include in new model
+        :param exclude: fields to exclude from new model, as with values this takes precedence over include
+        :param update: values to change/add in the new model. Note: the data is not validated before creating
+            the new model: you should trust this data
+        :param deep: set to `True` to make a deep copy of the model
+        :return: new model instance
+        """
+
+        values = dict(
+            self._iter(to_dict=False, by_alias=False, include=include, exclude=exclude, exclude_unset=False),
+            **(update or {}),
+        )
+
+        # new `__fields_set__` can have unset optional fields with a set value in `update` kwarg
+        if update:
+            fields_set = self.__fields_set__ | update.keys()
+        else:
+            fields_set = set(self.__fields_set__)
+
+        return self._copy_and_set_values(values, fields_set, deep=deep)
+
+    @classmethod
+    def schema(cls, by_alias: bool = True, ref_template: str = default_ref_template) -> 'DictStrAny':
+        cached = cls.__schema_cache__.get((by_alias, ref_template))
+        if cached is not None:
+            return cached
+        s = model_schema(cls, by_alias=by_alias, ref_template=ref_template)
+        cls.__schema_cache__[(by_alias, ref_template)] = s
+        return s
+
+    @classmethod
+    def schema_json(
+        cls, *, by_alias: bool = True, ref_template: str = default_ref_template, **dumps_kwargs: Any
+    ) -> str:
+        from .json import pydantic_encoder
+
+        return cls.__config__.json_dumps(
+            cls.schema(by_alias=by_alias, ref_template=ref_template), default=pydantic_encoder, **dumps_kwargs
+        )
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield cls.validate
+
+    @classmethod
+    def validate(cls: Type['Model'], value: Any) -> 'Model':
+        if isinstance(value, cls):
+            copy_on_model_validation = cls.__config__.copy_on_model_validation
+            # whether to deep or shallow copy the model on validation, None means do not copy
+            deep_copy: Optional[bool] = None
+            if copy_on_model_validation not in {'deep', 'shallow', 'none'}:
+                # Warn about deprecated behavior
+                warnings.warn(
+                    "`copy_on_model_validation` should be a string: 'deep', 'shallow' or 'none'", DeprecationWarning
+                )
+                if copy_on_model_validation:
+                    deep_copy = False
+
+            if copy_on_model_validation == 'shallow':
+                # shallow copy
+                deep_copy = False
+            elif copy_on_model_validation == 'deep':
+                # deep copy
+                deep_copy = True
+
+            if deep_copy is None:
+                return value
+            else:
+                return value._copy_and_set_values(value.__dict__, value.__fields_set__, deep=deep_copy)
+
+        value = cls._enforce_dict_if_root(value)
+
+        if isinstance(value, dict):
+            return cls(**value)
+        elif cls.__config__.orm_mode:
+            return cls.from_orm(value)
+        else:
+            try:
+                value_as_dict = dict(value)
+            except (TypeError, ValueError) as e:
+                raise DictError() from e
+            return cls(**value_as_dict)
+
+    @classmethod
+    def _decompose_class(cls: Type['Model'], obj: Any) -> GetterDict:
+        if isinstance(obj, GetterDict):
+            return obj
+        return cls.__config__.getter_dict(obj)
+
+    @classmethod
+    @no_type_check
+    def _get_value(
+        cls,
+        v: Any,
+        to_dict: bool,
+        by_alias: bool,
+        include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']],
+        exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']],
+        exclude_unset: bool,
+        exclude_defaults: bool,
+        exclude_none: bool,
+    ) -> Any:
+
+        if isinstance(v, BaseModel):
+            if to_dict:
+                v_dict = v.dict(
+                    by_alias=by_alias,
+                    exclude_unset=exclude_unset,
+                    exclude_defaults=exclude_defaults,
+                    include=include,
+                    exclude=exclude,
+                    exclude_none=exclude_none,
+                )
+                if ROOT_KEY in v_dict:
+                    return v_dict[ROOT_KEY]
+                return v_dict
+            else:
+                return v.copy(include=include, exclude=exclude)
+
+        value_exclude = ValueItems(v, exclude) if exclude else None
+        value_include = ValueItems(v, include) if include else None
+
+        if isinstance(v, dict):
+            return {
+                k_: cls._get_value(
+                    v_,
+                    to_dict=to_dict,
+                    by_alias=by_alias,
+                    exclude_unset=exclude_unset,
+                    exclude_defaults=exclude_defaults,
+                    include=value_include and value_include.for_element(k_),
+                    exclude=value_exclude and value_exclude.for_element(k_),
+                    exclude_none=exclude_none,
+                )
+                for k_, v_ in v.items()
+                if (not value_exclude or not value_exclude.is_excluded(k_))
+                and (not value_include or value_include.is_included(k_))
+            }
+
+        elif sequence_like(v):
+            seq_args = (
+                cls._get_value(
+                    v_,
+                    to_dict=to_dict,
+                    by_alias=by_alias,
+                    exclude_unset=exclude_unset,
+                    exclude_defaults=exclude_defaults,
+                    include=value_include and value_include.for_element(i),
+                    exclude=value_exclude and value_exclude.for_element(i),
+                    exclude_none=exclude_none,
+                )
+                for i, v_ in enumerate(v)
+                if (not value_exclude or not value_exclude.is_excluded(i))
+                and (not value_include or value_include.is_included(i))
+            )
+
+            return v.__class__(*seq_args) if is_namedtuple(v.__class__) else v.__class__(seq_args)
+
+        elif isinstance(v, Enum) and getattr(cls.Config, 'use_enum_values', False):
+            return v.value
+
+        else:
+            return v
+
+    @classmethod
+    def __try_update_forward_refs__(cls, **localns: Any) -> None:
+        """
+        Same as update_forward_refs but will not raise exception
+        when forward references are not defined.
+        """
+        update_model_forward_refs(cls, cls.__fields__.values(), cls.__config__.json_encoders, localns, (NameError,))
+
+    @classmethod
+    def update_forward_refs(cls, **localns: Any) -> None:
+        """
+        Try to update ForwardRefs on fields based on this Model, globalns and localns.
+        """
+        update_model_forward_refs(cls, cls.__fields__.values(), cls.__config__.json_encoders, localns)
+
+    def __iter__(self) -> 'TupleGenerator':
+        """
+        so `dict(model)` works
+        """
+        yield from self.__dict__.items()
+
+    def _iter(
+        self,
+        to_dict: bool = False,
+        by_alias: bool = False,
+        include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
+        exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
+        exclude_unset: bool = False,
+        exclude_defaults: bool = False,
+        exclude_none: bool = False,
+    ) -> 'TupleGenerator':
+
+        # Merge field set excludes with explicit exclude parameter with explicit overriding field set options.
+        # The extra "is not None" guards are not logically necessary but optimizes performance for the simple case.
+        if exclude is not None or self.__exclude_fields__ is not None:
+            exclude = ValueItems.merge(self.__exclude_fields__, exclude)
+
+        if include is not None or self.__include_fields__ is not None:
+            include = ValueItems.merge(self.__include_fields__, include, intersect=True)
+
+        allowed_keys = self._calculate_keys(
+            include=include, exclude=exclude, exclude_unset=exclude_unset  # type: ignore
+        )
+        if allowed_keys is None and not (to_dict or by_alias or exclude_unset or exclude_defaults or exclude_none):
+            # huge boost for plain _iter()
+            yield from self.__dict__.items()
+            return
+
+        value_exclude = ValueItems(self, exclude) if exclude is not None else None
+        value_include = ValueItems(self, include) if include is not None else None
+
+        for field_key, v in self.__dict__.items():
+            if (allowed_keys is not None and field_key not in allowed_keys) or (exclude_none and v is None):
+                continue
+
+            if exclude_defaults:
+                model_field = self.__fields__.get(field_key)
+                if not getattr(model_field, 'required', True) and getattr(model_field, 'default', _missing) == v:
+                    continue
+
+            if by_alias and field_key in self.__fields__:
+                dict_key = self.__fields__[field_key].alias
+            else:
+                dict_key = field_key
+
+            if to_dict or value_include or value_exclude:
+                v = self._get_value(
+                    v,
+                    to_dict=to_dict,
+                    by_alias=by_alias,
+                    include=value_include and value_include.for_element(field_key),
+                    exclude=value_exclude and value_exclude.for_element(field_key),
+                    exclude_unset=exclude_unset,
+                    exclude_defaults=exclude_defaults,
+                    exclude_none=exclude_none,
+                )
+            yield dict_key, v
+
+    def _calculate_keys(
+        self,
+        include: Optional['MappingIntStrAny'],
+        exclude: Optional['MappingIntStrAny'],
+        exclude_unset: bool,
+        update: Optional['DictStrAny'] = None,
+    ) -> Optional[AbstractSet[str]]:
+        if include is None and exclude is None and exclude_unset is False:
+            return None
+
+        keys: AbstractSet[str]
+        if exclude_unset:
+            keys = self.__fields_set__.copy()
+        else:
+            keys = self.__dict__.keys()
+
+        if include is not None:
+            keys &= include.keys()
+
+        if update:
+            keys -= update.keys()
+
+        if exclude:
+            keys -= {k for k, v in exclude.items() if ValueItems.is_true(v)}
+
+        return keys
+
+    def __eq__(self, other: Any) -> bool:
+        if isinstance(other, BaseModel):
+            return self.dict() == other.dict()
+        else:
+            return self.dict() == other
+
+    def __repr_args__(self) -> 'ReprArgs':
+        return [
+            (k, v)
+            for k, v in self.__dict__.items()
+            if k not in DUNDER_ATTRIBUTES and (k not in self.__fields__ or self.__fields__[k].field_info.repr)
+        ]
+
+
+_is_base_model_class_defined = True
+
+
+@overload
+def create_model(
+    __model_name: str,
+    *,
+    __config__: Optional[Type[BaseConfig]] = None,
+    __base__: None = None,
+    __module__: str = __name__,
+    __validators__: Dict[str, 'AnyClassMethod'] = None,
+    __cls_kwargs__: Dict[str, Any] = None,
+    **field_definitions: Any,
+) -> Type['BaseModel']:
+    ...
+
+
+@overload
+def create_model(
+    __model_name: str,
+    *,
+    __config__: Optional[Type[BaseConfig]] = None,
+    __base__: Union[Type['Model'], Tuple[Type['Model'], ...]],
+    __module__: str = __name__,
+    __validators__: Dict[str, 'AnyClassMethod'] = None,
+    __cls_kwargs__: Dict[str, Any] = None,
+    **field_definitions: Any,
+) -> Type['Model']:
+    ...
+
+
+def create_model(
+    __model_name: str,
+    *,
+    __config__: Optional[Type[BaseConfig]] = None,
+    __base__: Union[None, Type['Model'], Tuple[Type['Model'], ...]] = None,
+    __module__: str = __name__,
+    __validators__: Dict[str, 'AnyClassMethod'] = None,
+    __cls_kwargs__: Dict[str, Any] = None,
+    __slots__: Optional[Tuple[str, ...]] = None,
+    **field_definitions: Any,
+) -> Type['Model']:
+    """
+    Dynamically create a model.
+    :param __model_name: name of the created model
+    :param __config__: config class to use for the new model
+    :param __base__: base class for the new model to inherit from
+    :param __module__: module of the created model
+    :param __validators__: a dict of method names and @validator class methods
+    :param __cls_kwargs__: a dict for class creation
+    :param __slots__: Deprecated, `__slots__` should not be passed to `create_model`
+    :param field_definitions: fields of the model (or extra fields if a base is supplied)
+        in the format `<name>=(<type>, <default default>)` or `<name>=<default value>, e.g.
+        `foobar=(str, ...)` or `foobar=123`, or, for complex use-cases, in the format
+        `<name>=<Field>` or `<name>=(<type>, <FieldInfo>)`, e.g.
+        `foo=Field(datetime, default_factory=datetime.utcnow, alias='bar')` or
+        `foo=(str, FieldInfo(title='Foo'))`
+    """
+    if __slots__ is not None:
+        # __slots__ will be ignored from here on
+        warnings.warn('__slots__ should not be passed to create_model', RuntimeWarning)
+
+    if __base__ is not None:
+        if __config__ is not None:
+            raise ConfigError('to avoid confusion __config__ and __base__ cannot be used together')
+        if not isinstance(__base__, tuple):
+            __base__ = (__base__,)
+    else:
+        __base__ = (cast(Type['Model'], BaseModel),)
+
+    __cls_kwargs__ = __cls_kwargs__ or {}
+
+    fields = {}
+    annotations = {}
+
+    for f_name, f_def in field_definitions.items():
+        if not is_valid_field(f_name):
+            warnings.warn(f'fields may not start with an underscore, ignoring "{f_name}"', RuntimeWarning)
+        if isinstance(f_def, tuple):
+            try:
+                f_annotation, f_value = f_def
+            except ValueError as e:
+                raise ConfigError(
+                    'field definitions should either be a tuple of (<type>, <default>) or just a '
+                    'default value, unfortunately this means tuples as '
+                    'default values are not allowed'
+                ) from e
+        else:
+            f_annotation, f_value = None, f_def
+
+        if f_annotation:
+            annotations[f_name] = f_annotation
+        fields[f_name] = f_value
+
+    namespace: 'DictStrAny' = {'__annotations__': annotations, '__module__': __module__}
+    if __validators__:
+        namespace.update(__validators__)
+    namespace.update(fields)
+    if __config__:
+        namespace['Config'] = inherit_config(__config__, BaseConfig)
+    resolved_bases = resolve_bases(__base__)
+    meta, ns, kwds = prepare_class(__model_name, resolved_bases, kwds=__cls_kwargs__)
+    if resolved_bases is not __base__:
+        ns['__orig_bases__'] = __base__
+    namespace.update(ns)
+    return meta(__model_name, resolved_bases, namespace, **kwds)
+
+
+_missing = object()
+
+
+def validate_model(  # noqa: C901 (ignore complexity)
+    model: Type[BaseModel], input_data: 'DictStrAny', cls: 'ModelOrDc' = None
+) -> Tuple['DictStrAny', 'SetStr', Optional[ValidationError]]:
+    """
+    validate data against a model.
+    """
+    values = {}
+    errors = []
+    # input_data names, possibly alias
+    names_used = set()
+    # field names, never aliases
+    fields_set = set()
+    config = model.__config__
+    check_extra = config.extra is not Extra.ignore
+    cls_ = cls or model
+
+    for validator in model.__pre_root_validators__:
+        try:
+            input_data = validator(cls_, input_data)
+        except (ValueError, TypeError, AssertionError) as exc:
+            return {}, set(), ValidationError([ErrorWrapper(exc, loc=ROOT_KEY)], cls_)
+
+    for name, field in model.__fields__.items():
+        value = input_data.get(field.alias, _missing)
+        using_name = False
+        if value is _missing and config.allow_population_by_field_name and field.alt_alias:
+            value = input_data.get(field.name, _missing)
+            using_name = True
+
+        if value is _missing:
+            if field.required:
+                errors.append(ErrorWrapper(MissingError(), loc=field.alias))
+                continue
+
+            value = field.get_default()
+
+            if not config.validate_all and not field.validate_always:
+                values[name] = value
+                continue
+        else:
+            fields_set.add(name)
+            if check_extra:
+                names_used.add(field.name if using_name else field.alias)
+
+        v_, errors_ = field.validate(value, values, loc=field.alias, cls=cls_)
+        if isinstance(errors_, ErrorWrapper):
+            errors.append(errors_)
+        elif isinstance(errors_, list):
+            errors.extend(errors_)
+        else:
+            values[name] = v_
+
+    if check_extra:
+        if isinstance(input_data, GetterDict):
+            extra = input_data.extra_keys() - names_used
+        else:
+            extra = input_data.keys() - names_used
+        if extra:
+            fields_set |= extra
+            if config.extra is Extra.allow:
+                for f in extra:
+                    values[f] = input_data[f]
+            else:
+                for f in sorted(extra):
+                    errors.append(ErrorWrapper(ExtraError(), loc=f))
+
+    for skip_on_failure, validator in model.__post_root_validators__:
+        if skip_on_failure and errors:
+            continue
+        try:
+            values = validator(cls_, values)
+        except (ValueError, TypeError, AssertionError) as exc:
+            errors.append(ErrorWrapper(exc, loc=ROOT_KEY))
+
+    if errors:
+        return values, fields_set, ValidationError(errors, cls_)
+    else:
+        return values, fields_set, None
diff --git a/lib/pydantic/mypy.py b/lib/pydantic/mypy.py
new file mode 100644
index 00000000..6bd9db18
--- /dev/null
+++ b/lib/pydantic/mypy.py
@@ -0,0 +1,850 @@
+import sys
+from configparser import ConfigParser
+from typing import Any, Callable, Dict, List, Optional, Set, Tuple, Type as TypingType, Union
+
+from mypy.errorcodes import ErrorCode
+from mypy.nodes import (
+    ARG_NAMED,
+    ARG_NAMED_OPT,
+    ARG_OPT,
+    ARG_POS,
+    ARG_STAR2,
+    MDEF,
+    Argument,
+    AssignmentStmt,
+    Block,
+    CallExpr,
+    ClassDef,
+    Context,
+    Decorator,
+    EllipsisExpr,
+    FuncBase,
+    FuncDef,
+    JsonDict,
+    MemberExpr,
+    NameExpr,
+    PassStmt,
+    PlaceholderNode,
+    RefExpr,
+    StrExpr,
+    SymbolNode,
+    SymbolTableNode,
+    TempNode,
+    TypeInfo,
+    TypeVarExpr,
+    Var,
+)
+from mypy.options import Options
+from mypy.plugin import (
+    CheckerPluginInterface,
+    ClassDefContext,
+    FunctionContext,
+    MethodContext,
+    Plugin,
+    SemanticAnalyzerPluginInterface,
+)
+from mypy.plugins import dataclasses
+from mypy.semanal import set_callable_name  # type: ignore
+from mypy.server.trigger import make_wildcard_trigger
+from mypy.types import (
+    AnyType,
+    CallableType,
+    Instance,
+    NoneType,
+    Overloaded,
+    Type,
+    TypeOfAny,
+    TypeType,
+    TypeVarType,
+    UnionType,
+    get_proper_type,
+)
+from mypy.typevars import fill_typevars
+from mypy.util import get_unique_redefinition_name
+from mypy.version import __version__ as mypy_version
+
+from pydantic.utils import is_valid_field
+
+try:
+    from mypy.types import TypeVarDef  # type: ignore[attr-defined]
+except ImportError:  # pragma: no cover
+    # Backward-compatible with TypeVarDef from Mypy 0.910.
+    from mypy.types import TypeVarType as TypeVarDef
+
+CONFIGFILE_KEY = 'pydantic-mypy'
+METADATA_KEY = 'pydantic-mypy-metadata'
+BASEMODEL_FULLNAME = 'pydantic.main.BaseModel'
+BASESETTINGS_FULLNAME = 'pydantic.env_settings.BaseSettings'
+FIELD_FULLNAME = 'pydantic.fields.Field'
+DATACLASS_FULLNAME = 'pydantic.dataclasses.dataclass'
+
+
+def parse_mypy_version(version: str) -> Tuple[int, ...]:
+    return tuple(int(part) for part in version.split('+', 1)[0].split('.'))
+
+
+MYPY_VERSION_TUPLE = parse_mypy_version(mypy_version)
+BUILTINS_NAME = 'builtins' if MYPY_VERSION_TUPLE >= (0, 930) else '__builtins__'
+
+
+def plugin(version: str) -> 'TypingType[Plugin]':
+    """
+    `version` is the mypy version string
+
+    We might want to use this to print a warning if the mypy version being used is
+    newer, or especially older, than we expect (or need).
+    """
+    return PydanticPlugin
+
+
+class PydanticPlugin(Plugin):
+    def __init__(self, options: Options) -> None:
+        self.plugin_config = PydanticPluginConfig(options)
+        super().__init__(options)
+
+    def get_base_class_hook(self, fullname: str) -> 'Optional[Callable[[ClassDefContext], None]]':
+        sym = self.lookup_fully_qualified(fullname)
+        if sym and isinstance(sym.node, TypeInfo):  # pragma: no branch
+            # No branching may occur if the mypy cache has not been cleared
+            if any(get_fullname(base) == BASEMODEL_FULLNAME for base in sym.node.mro):
+                return self._pydantic_model_class_maker_callback
+        return None
+
+    def get_function_hook(self, fullname: str) -> 'Optional[Callable[[FunctionContext], Type]]':
+        sym = self.lookup_fully_qualified(fullname)
+        if sym and sym.fullname == FIELD_FULLNAME:
+            return self._pydantic_field_callback
+        return None
+
+    def get_method_hook(self, fullname: str) -> Optional[Callable[[MethodContext], Type]]:
+        if fullname.endswith('.from_orm'):
+            return from_orm_callback
+        return None
+
+    def get_class_decorator_hook(self, fullname: str) -> Optional[Callable[[ClassDefContext], None]]:
+        if fullname == DATACLASS_FULLNAME:
+            return dataclasses.dataclass_class_maker_callback  # type: ignore[return-value]
+        return None
+
+    def _pydantic_model_class_maker_callback(self, ctx: ClassDefContext) -> None:
+        transformer = PydanticModelTransformer(ctx, self.plugin_config)
+        transformer.transform()
+
+    def _pydantic_field_callback(self, ctx: FunctionContext) -> 'Type':
+        """
+        Extract the type of the `default` argument from the Field function, and use it as the return type.
+
+        In particular:
+        * Check whether the default and default_factory argument is specified.
+        * Output an error if both are specified.
+        * Retrieve the type of the argument which is specified, and use it as return type for the function.
+        """
+        default_any_type = ctx.default_return_type
+
+        assert ctx.callee_arg_names[0] == 'default', '"default" is no longer first argument in Field()'
+        assert ctx.callee_arg_names[1] == 'default_factory', '"default_factory" is no longer second argument in Field()'
+        default_args = ctx.args[0]
+        default_factory_args = ctx.args[1]
+
+        if default_args and default_factory_args:
+            error_default_and_default_factory_specified(ctx.api, ctx.context)
+            return default_any_type
+
+        if default_args:
+            default_type = ctx.arg_types[0][0]
+            default_arg = default_args[0]
+
+            # Fallback to default Any type if the field is required
+            if not isinstance(default_arg, EllipsisExpr):
+                return default_type
+
+        elif default_factory_args:
+            default_factory_type = ctx.arg_types[1][0]
+
+            # Functions which use `ParamSpec` can be overloaded, exposing the callable's types as a parameter
+            # Pydantic calls the default factory without any argument, so we retrieve the first item
+            if isinstance(default_factory_type, Overloaded):
+                if MYPY_VERSION_TUPLE > (0, 910):
+                    default_factory_type = default_factory_type.items[0]
+                else:
+                    # Mypy0.910 exposes the items of overloaded types in a function
+                    default_factory_type = default_factory_type.items()[0]  # type: ignore[operator]
+
+            if isinstance(default_factory_type, CallableType):
+                ret_type = default_factory_type.ret_type
+                # mypy doesn't think `ret_type` has `args`, you'd think mypy should know,
+                # add this check in case it varies by version
+                args = getattr(ret_type, 'args', None)
+                if args:
+                    if all(isinstance(arg, TypeVarType) for arg in args):
+                        # Looks like the default factory is a type like `list` or `dict`, replace all args with `Any`
+                        ret_type.args = tuple(default_any_type for _ in args)  # type: ignore[attr-defined]
+                return ret_type
+
+        return default_any_type
+
+
+class PydanticPluginConfig:
+    __slots__ = ('init_forbid_extra', 'init_typed', 'warn_required_dynamic_aliases', 'warn_untyped_fields')
+    init_forbid_extra: bool
+    init_typed: bool
+    warn_required_dynamic_aliases: bool
+    warn_untyped_fields: bool
+
+    def __init__(self, options: Options) -> None:
+        if options.config_file is None:  # pragma: no cover
+            return
+
+        toml_config = parse_toml(options.config_file)
+        if toml_config is not None:
+            config = toml_config.get('tool', {}).get('pydantic-mypy', {})
+            for key in self.__slots__:
+                setting = config.get(key, False)
+                if not isinstance(setting, bool):
+                    raise ValueError(f'Configuration value must be a boolean for key: {key}')
+                setattr(self, key, setting)
+        else:
+            plugin_config = ConfigParser()
+            plugin_config.read(options.config_file)
+            for key in self.__slots__:
+                setting = plugin_config.getboolean(CONFIGFILE_KEY, key, fallback=False)
+                setattr(self, key, setting)
+
+
+def from_orm_callback(ctx: MethodContext) -> Type:
+    """
+    Raise an error if orm_mode is not enabled
+    """
+    model_type: Instance
+    if isinstance(ctx.type, CallableType) and isinstance(ctx.type.ret_type, Instance):
+        model_type = ctx.type.ret_type  # called on the class
+    elif isinstance(ctx.type, Instance):
+        model_type = ctx.type  # called on an instance (unusual, but still valid)
+    else:  # pragma: no cover
+        detail = f'ctx.type: {ctx.type} (of type {ctx.type.__class__.__name__})'
+        error_unexpected_behavior(detail, ctx.api, ctx.context)
+        return ctx.default_return_type
+    pydantic_metadata = model_type.type.metadata.get(METADATA_KEY)
+    if pydantic_metadata is None:
+        return ctx.default_return_type
+    orm_mode = pydantic_metadata.get('config', {}).get('orm_mode')
+    if orm_mode is not True:
+        error_from_orm(get_name(model_type.type), ctx.api, ctx.context)
+    return ctx.default_return_type
+
+
+class PydanticModelTransformer:
+    tracked_config_fields: Set[str] = {
+        'extra',
+        'allow_mutation',
+        'frozen',
+        'orm_mode',
+        'allow_population_by_field_name',
+        'alias_generator',
+    }
+
+    def __init__(self, ctx: ClassDefContext, plugin_config: PydanticPluginConfig) -> None:
+        self._ctx = ctx
+        self.plugin_config = plugin_config
+
+    def transform(self) -> None:
+        """
+        Configures the BaseModel subclass according to the plugin settings.
+
+        In particular:
+        * determines the model config and fields,
+        * adds a fields-aware signature for the initializer and construct methods
+        * freezes the class if allow_mutation = False or frozen = True
+        * stores the fields, config, and if the class is settings in the mypy metadata for access by subclasses
+        """
+        ctx = self._ctx
+        info = self._ctx.cls.info
+
+        self.adjust_validator_signatures()
+        config = self.collect_config()
+        fields = self.collect_fields(config)
+        for field in fields:
+            if info[field.name].type is None:
+                if not ctx.api.final_iteration:
+                    ctx.api.defer()
+        is_settings = any(get_fullname(base) == BASESETTINGS_FULLNAME for base in info.mro[:-1])
+        self.add_initializer(fields, config, is_settings)
+        self.add_construct_method(fields)
+        self.set_frozen(fields, frozen=config.allow_mutation is False or config.frozen is True)
+        info.metadata[METADATA_KEY] = {
+            'fields': {field.name: field.serialize() for field in fields},
+            'config': config.set_values_dict(),
+        }
+
+    def adjust_validator_signatures(self) -> None:
+        """When we decorate a function `f` with `pydantic.validator(...), mypy sees
+        `f` as a regular method taking a `self` instance, even though pydantic
+        internally wraps `f` with `classmethod` if necessary.
+
+        Teach mypy this by marking any function whose outermost decorator is a
+        `validator()` call as a classmethod.
+        """
+        for name, sym in self._ctx.cls.info.names.items():
+            if isinstance(sym.node, Decorator):
+                first_dec = sym.node.original_decorators[0]
+                if (
+                    isinstance(first_dec, CallExpr)
+                    and isinstance(first_dec.callee, NameExpr)
+                    and first_dec.callee.fullname == 'pydantic.class_validators.validator'
+                ):
+                    sym.node.func.is_class = True
+
+    def collect_config(self) -> 'ModelConfigData':
+        """
+        Collects the values of the config attributes that are used by the plugin, accounting for parent classes.
+        """
+        ctx = self._ctx
+        cls = ctx.cls
+        config = ModelConfigData()
+        for stmt in cls.defs.body:
+            if not isinstance(stmt, ClassDef):
+                continue
+            if stmt.name == 'Config':
+                for substmt in stmt.defs.body:
+                    if not isinstance(substmt, AssignmentStmt):
+                        continue
+                    config.update(self.get_config_update(substmt))
+                if (
+                    config.has_alias_generator
+                    and not config.allow_population_by_field_name
+                    and self.plugin_config.warn_required_dynamic_aliases
+                ):
+                    error_required_dynamic_aliases(ctx.api, stmt)
+        for info in cls.info.mro[1:]:  # 0 is the current class
+            if METADATA_KEY not in info.metadata:
+                continue
+
+            # Each class depends on the set of fields in its ancestors
+            ctx.api.add_plugin_dependency(make_wildcard_trigger(get_fullname(info)))
+            for name, value in info.metadata[METADATA_KEY]['config'].items():
+                config.setdefault(name, value)
+        return config
+
+    def collect_fields(self, model_config: 'ModelConfigData') -> List['PydanticModelField']:
+        """
+        Collects the fields for the model, accounting for parent classes
+        """
+        # First, collect fields belonging to the current class.
+        ctx = self._ctx
+        cls = self._ctx.cls
+        fields = []  # type: List[PydanticModelField]
+        known_fields = set()  # type: Set[str]
+        for stmt in cls.defs.body:
+            if not isinstance(stmt, AssignmentStmt):  # `and stmt.new_syntax` to require annotation
+                continue
+
+            lhs = stmt.lvalues[0]
+            if not isinstance(lhs, NameExpr) or not is_valid_field(lhs.name):
+                continue
+
+            if not stmt.new_syntax and self.plugin_config.warn_untyped_fields:
+                error_untyped_fields(ctx.api, stmt)
+
+            # if lhs.name == '__config__':  # BaseConfig not well handled; I'm not sure why yet
+            #     continue
+
+            sym = cls.info.names.get(lhs.name)
+            if sym is None:  # pragma: no cover
+                # This is likely due to a star import (see the dataclasses plugin for a more detailed explanation)
+                # This is the same logic used in the dataclasses plugin
+                continue
+
+            node = sym.node
+            if isinstance(node, PlaceholderNode):  # pragma: no cover
+                # See the PlaceholderNode docstring for more detail about how this can occur
+                # Basically, it is an edge case when dealing with complex import logic
+                # This is the same logic used in the dataclasses plugin
+                continue
+            if not isinstance(node, Var):  # pragma: no cover
+                # Don't know if this edge case still happens with the `is_valid_field` check above
+                # but better safe than sorry
+                continue
+
+            # x: ClassVar[int] is ignored by dataclasses.
+            if node.is_classvar:
+                continue
+
+            is_required = self.get_is_required(cls, stmt, lhs)
+            alias, has_dynamic_alias = self.get_alias_info(stmt)
+            if (
+                has_dynamic_alias
+                and not model_config.allow_population_by_field_name
+                and self.plugin_config.warn_required_dynamic_aliases
+            ):
+                error_required_dynamic_aliases(ctx.api, stmt)
+            fields.append(
+                PydanticModelField(
+                    name=lhs.name,
+                    is_required=is_required,
+                    alias=alias,
+                    has_dynamic_alias=has_dynamic_alias,
+                    line=stmt.line,
+                    column=stmt.column,
+                )
+            )
+            known_fields.add(lhs.name)
+        all_fields = fields.copy()
+        for info in cls.info.mro[1:]:  # 0 is the current class, -2 is BaseModel, -1 is object
+            if METADATA_KEY not in info.metadata:
+                continue
+
+            superclass_fields = []
+            # Each class depends on the set of fields in its ancestors
+            ctx.api.add_plugin_dependency(make_wildcard_trigger(get_fullname(info)))
+
+            for name, data in info.metadata[METADATA_KEY]['fields'].items():
+                if name not in known_fields:
+                    field = PydanticModelField.deserialize(info, data)
+                    known_fields.add(name)
+                    superclass_fields.append(field)
+                else:
+                    (field,) = (a for a in all_fields if a.name == name)
+                    all_fields.remove(field)
+                    superclass_fields.append(field)
+            all_fields = superclass_fields + all_fields
+        return all_fields
+
+    def add_initializer(self, fields: List['PydanticModelField'], config: 'ModelConfigData', is_settings: bool) -> None:
+        """
+        Adds a fields-aware `__init__` method to the class.
+
+        The added `__init__` will be annotated with types vs. all `Any` depending on the plugin settings.
+        """
+        ctx = self._ctx
+        typed = self.plugin_config.init_typed
+        use_alias = config.allow_population_by_field_name is not True
+        force_all_optional = is_settings or bool(
+            config.has_alias_generator and not config.allow_population_by_field_name
+        )
+        init_arguments = self.get_field_arguments(
+            fields, typed=typed, force_all_optional=force_all_optional, use_alias=use_alias
+        )
+        if not self.should_init_forbid_extra(fields, config):
+            var = Var('kwargs')
+            init_arguments.append(Argument(var, AnyType(TypeOfAny.explicit), None, ARG_STAR2))
+
+        if '__init__' not in ctx.cls.info.names:
+            add_method(ctx, '__init__', init_arguments, NoneType())
+
+    def add_construct_method(self, fields: List['PydanticModelField']) -> None:
+        """
+        Adds a fully typed `construct` classmethod to the class.
+
+        Similar to the fields-aware __init__ method, but always uses the field names (not aliases),
+        and does not treat settings fields as optional.
+        """
+        ctx = self._ctx
+        set_str = ctx.api.named_type(f'{BUILTINS_NAME}.set', [ctx.api.named_type(f'{BUILTINS_NAME}.str')])
+        optional_set_str = UnionType([set_str, NoneType()])
+        fields_set_argument = Argument(Var('_fields_set', optional_set_str), optional_set_str, None, ARG_OPT)
+        construct_arguments = self.get_field_arguments(fields, typed=True, force_all_optional=False, use_alias=False)
+        construct_arguments = [fields_set_argument] + construct_arguments
+
+        obj_type = ctx.api.named_type(f'{BUILTINS_NAME}.object')
+        self_tvar_name = '_PydanticBaseModel'  # Make sure it does not conflict with other names in the class
+        tvar_fullname = ctx.cls.fullname + '.' + self_tvar_name
+        tvd = TypeVarDef(self_tvar_name, tvar_fullname, -1, [], obj_type)
+        self_tvar_expr = TypeVarExpr(self_tvar_name, tvar_fullname, [], obj_type)
+        ctx.cls.info.names[self_tvar_name] = SymbolTableNode(MDEF, self_tvar_expr)
+
+        # Backward-compatible with TypeVarDef from Mypy 0.910.
+        if isinstance(tvd, TypeVarType):
+            self_type = tvd
+        else:
+            self_type = TypeVarType(tvd)  # type: ignore[call-arg]
+
+        add_method(
+            ctx,
+            'construct',
+            construct_arguments,
+            return_type=self_type,
+            self_type=self_type,
+            tvar_def=tvd,
+            is_classmethod=True,
+        )
+
+    def set_frozen(self, fields: List['PydanticModelField'], frozen: bool) -> None:
+        """
+        Marks all fields as properties so that attempts to set them trigger mypy errors.
+
+        This is the same approach used by the attrs and dataclasses plugins.
+        """
+        info = self._ctx.cls.info
+        for field in fields:
+            sym_node = info.names.get(field.name)
+            if sym_node is not None:
+                var = sym_node.node
+                assert isinstance(var, Var)
+                var.is_property = frozen
+            else:
+                var = field.to_var(info, use_alias=False)
+                var.info = info
+                var.is_property = frozen
+                var._fullname = get_fullname(info) + '.' + get_name(var)
+                info.names[get_name(var)] = SymbolTableNode(MDEF, var)
+
+    def get_config_update(self, substmt: AssignmentStmt) -> Optional['ModelConfigData']:
+        """
+        Determines the config update due to a single statement in the Config class definition.
+
+        Warns if a tracked config attribute is set to a value the plugin doesn't know how to interpret (e.g., an int)
+        """
+        lhs = substmt.lvalues[0]
+        if not (isinstance(lhs, NameExpr) and lhs.name in self.tracked_config_fields):
+            return None
+        if lhs.name == 'extra':
+            if isinstance(substmt.rvalue, StrExpr):
+                forbid_extra = substmt.rvalue.value == 'forbid'
+            elif isinstance(substmt.rvalue, MemberExpr):
+                forbid_extra = substmt.rvalue.name == 'forbid'
+            else:
+                error_invalid_config_value(lhs.name, self._ctx.api, substmt)
+                return None
+            return ModelConfigData(forbid_extra=forbid_extra)
+        if lhs.name == 'alias_generator':
+            has_alias_generator = True
+            if isinstance(substmt.rvalue, NameExpr) and substmt.rvalue.fullname == 'builtins.None':
+                has_alias_generator = False
+            return ModelConfigData(has_alias_generator=has_alias_generator)
+        if isinstance(substmt.rvalue, NameExpr) and substmt.rvalue.fullname in ('builtins.True', 'builtins.False'):
+            return ModelConfigData(**{lhs.name: substmt.rvalue.fullname == 'builtins.True'})
+        error_invalid_config_value(lhs.name, self._ctx.api, substmt)
+        return None
+
+    @staticmethod
+    def get_is_required(cls: ClassDef, stmt: AssignmentStmt, lhs: NameExpr) -> bool:
+        """
+        Returns a boolean indicating whether the field defined in `stmt` is a required field.
+        """
+        expr = stmt.rvalue
+        if isinstance(expr, TempNode):
+            # TempNode means annotation-only, so only non-required if Optional
+            value_type = get_proper_type(cls.info[lhs.name].type)
+            if isinstance(value_type, UnionType) and any(isinstance(item, NoneType) for item in value_type.items):
+                # Annotated as Optional, or otherwise having NoneType in the union
+                return False
+            return True
+        if isinstance(expr, CallExpr) and isinstance(expr.callee, RefExpr) and expr.callee.fullname == FIELD_FULLNAME:
+            # The "default value" is a call to `Field`; at this point, the field is
+            # only required if default is Ellipsis (i.e., `field_name: Annotation = Field(...)`) or if default_factory
+            # is specified.
+            for arg, name in zip(expr.args, expr.arg_names):
+                # If name is None, then this arg is the default because it is the only positonal argument.
+                if name is None or name == 'default':
+                    return arg.__class__ is EllipsisExpr
+                if name == 'default_factory':
+                    return False
+            return True
+        # Only required if the "default value" is Ellipsis (i.e., `field_name: Annotation = ...`)
+        return isinstance(expr, EllipsisExpr)
+
+    @staticmethod
+    def get_alias_info(stmt: AssignmentStmt) -> Tuple[Optional[str], bool]:
+        """
+        Returns a pair (alias, has_dynamic_alias), extracted from the declaration of the field defined in `stmt`.
+
+        `has_dynamic_alias` is True if and only if an alias is provided, but not as a string literal.
+        If `has_dynamic_alias` is True, `alias` will be None.
+        """
+        expr = stmt.rvalue
+        if isinstance(expr, TempNode):
+            # TempNode means annotation-only
+            return None, False
+
+        if not (
+            isinstance(expr, CallExpr) and isinstance(expr.callee, RefExpr) and expr.callee.fullname == FIELD_FULLNAME
+        ):
+            # Assigned value is not a call to pydantic.fields.Field
+            return None, False
+
+        for i, arg_name in enumerate(expr.arg_names):
+            if arg_name != 'alias':
+                continue
+            arg = expr.args[i]
+            if isinstance(arg, StrExpr):
+                return arg.value, False
+            else:
+                return None, True
+        return None, False
+
+    def get_field_arguments(
+        self, fields: List['PydanticModelField'], typed: bool, force_all_optional: bool, use_alias: bool
+    ) -> List[Argument]:
+        """
+        Helper function used during the construction of the `__init__` and `construct` method signatures.
+
+        Returns a list of mypy Argument instances for use in the generated signatures.
+        """
+        info = self._ctx.cls.info
+        arguments = [
+            field.to_argument(info, typed=typed, force_optional=force_all_optional, use_alias=use_alias)
+            for field in fields
+            if not (use_alias and field.has_dynamic_alias)
+        ]
+        return arguments
+
+    def should_init_forbid_extra(self, fields: List['PydanticModelField'], config: 'ModelConfigData') -> bool:
+        """
+        Indicates whether the generated `__init__` should get a `**kwargs` at the end of its signature
+
+        We disallow arbitrary kwargs if the extra config setting is "forbid", or if the plugin config says to,
+        *unless* a required dynamic alias is present (since then we can't determine a valid signature).
+        """
+        if not config.allow_population_by_field_name:
+            if self.is_dynamic_alias_present(fields, bool(config.has_alias_generator)):
+                return False
+        if config.forbid_extra:
+            return True
+        return self.plugin_config.init_forbid_extra
+
+    @staticmethod
+    def is_dynamic_alias_present(fields: List['PydanticModelField'], has_alias_generator: bool) -> bool:
+        """
+        Returns whether any fields on the model have a "dynamic alias", i.e., an alias that cannot be
+        determined during static analysis.
+        """
+        for field in fields:
+            if field.has_dynamic_alias:
+                return True
+        if has_alias_generator:
+            for field in fields:
+                if field.alias is None:
+                    return True
+        return False
+
+
+class PydanticModelField:
+    def __init__(
+        self, name: str, is_required: bool, alias: Optional[str], has_dynamic_alias: bool, line: int, column: int
+    ):
+        self.name = name
+        self.is_required = is_required
+        self.alias = alias
+        self.has_dynamic_alias = has_dynamic_alias
+        self.line = line
+        self.column = column
+
+    def to_var(self, info: TypeInfo, use_alias: bool) -> Var:
+        name = self.name
+        if use_alias and self.alias is not None:
+            name = self.alias
+        return Var(name, info[self.name].type)
+
+    def to_argument(self, info: TypeInfo, typed: bool, force_optional: bool, use_alias: bool) -> Argument:
+        if typed and info[self.name].type is not None:
+            type_annotation = info[self.name].type
+        else:
+            type_annotation = AnyType(TypeOfAny.explicit)
+        return Argument(
+            variable=self.to_var(info, use_alias),
+            type_annotation=type_annotation,
+            initializer=None,
+            kind=ARG_NAMED_OPT if force_optional or not self.is_required else ARG_NAMED,
+        )
+
+    def serialize(self) -> JsonDict:
+        return self.__dict__
+
+    @classmethod
+    def deserialize(cls, info: TypeInfo, data: JsonDict) -> 'PydanticModelField':
+        return cls(**data)
+
+
+class ModelConfigData:
+    def __init__(
+        self,
+        forbid_extra: Optional[bool] = None,
+        allow_mutation: Optional[bool] = None,
+        frozen: Optional[bool] = None,
+        orm_mode: Optional[bool] = None,
+        allow_population_by_field_name: Optional[bool] = None,
+        has_alias_generator: Optional[bool] = None,
+    ):
+        self.forbid_extra = forbid_extra
+        self.allow_mutation = allow_mutation
+        self.frozen = frozen
+        self.orm_mode = orm_mode
+        self.allow_population_by_field_name = allow_population_by_field_name
+        self.has_alias_generator = has_alias_generator
+
+    def set_values_dict(self) -> Dict[str, Any]:
+        return {k: v for k, v in self.__dict__.items() if v is not None}
+
+    def update(self, config: Optional['ModelConfigData']) -> None:
+        if config is None:
+            return
+        for k, v in config.set_values_dict().items():
+            setattr(self, k, v)
+
+    def setdefault(self, key: str, value: Any) -> None:
+        if getattr(self, key) is None:
+            setattr(self, key, value)
+
+
+ERROR_ORM = ErrorCode('pydantic-orm', 'Invalid from_orm call', 'Pydantic')
+ERROR_CONFIG = ErrorCode('pydantic-config', 'Invalid config value', 'Pydantic')
+ERROR_ALIAS = ErrorCode('pydantic-alias', 'Dynamic alias disallowed', 'Pydantic')
+ERROR_UNEXPECTED = ErrorCode('pydantic-unexpected', 'Unexpected behavior', 'Pydantic')
+ERROR_UNTYPED = ErrorCode('pydantic-field', 'Untyped field disallowed', 'Pydantic')
+ERROR_FIELD_DEFAULTS = ErrorCode('pydantic-field', 'Invalid Field defaults', 'Pydantic')
+
+
+def error_from_orm(model_name: str, api: CheckerPluginInterface, context: Context) -> None:
+    api.fail(f'"{model_name}" does not have orm_mode=True', context, code=ERROR_ORM)
+
+
+def error_invalid_config_value(name: str, api: SemanticAnalyzerPluginInterface, context: Context) -> None:
+    api.fail(f'Invalid value for "Config.{name}"', context, code=ERROR_CONFIG)
+
+
+def error_required_dynamic_aliases(api: SemanticAnalyzerPluginInterface, context: Context) -> None:
+    api.fail('Required dynamic aliases disallowed', context, code=ERROR_ALIAS)
+
+
+def error_unexpected_behavior(detail: str, api: CheckerPluginInterface, context: Context) -> None:  # pragma: no cover
+    # Can't think of a good way to test this, but I confirmed it renders as desired by adding to a non-error path
+    link = 'https://github.com/pydantic/pydantic/issues/new/choose'
+    full_message = f'The pydantic mypy plugin ran into unexpected behavior: {detail}\n'
+    full_message += f'Please consider reporting this bug at {link} so we can try to fix it!'
+    api.fail(full_message, context, code=ERROR_UNEXPECTED)
+
+
+def error_untyped_fields(api: SemanticAnalyzerPluginInterface, context: Context) -> None:
+    api.fail('Untyped fields disallowed', context, code=ERROR_UNTYPED)
+
+
+def error_default_and_default_factory_specified(api: CheckerPluginInterface, context: Context) -> None:
+    api.fail('Field default and default_factory cannot be specified together', context, code=ERROR_FIELD_DEFAULTS)
+
+
+def add_method(
+    ctx: ClassDefContext,
+    name: str,
+    args: List[Argument],
+    return_type: Type,
+    self_type: Optional[Type] = None,
+    tvar_def: Optional[TypeVarDef] = None,
+    is_classmethod: bool = False,
+    is_new: bool = False,
+    # is_staticmethod: bool = False,
+) -> None:
+    """
+    Adds a new method to a class.
+
+    This can be dropped if/when https://github.com/python/mypy/issues/7301 is merged
+    """
+    info = ctx.cls.info
+
+    # First remove any previously generated methods with the same name
+    # to avoid clashes and problems in the semantic analyzer.
+    if name in info.names:
+        sym = info.names[name]
+        if sym.plugin_generated and isinstance(sym.node, FuncDef):
+            ctx.cls.defs.body.remove(sym.node)  # pragma: no cover
+
+    self_type = self_type or fill_typevars(info)
+    if is_classmethod or is_new:
+        first = [Argument(Var('_cls'), TypeType.make_normalized(self_type), None, ARG_POS)]
+    # elif is_staticmethod:
+    #     first = []
+    else:
+        self_type = self_type or fill_typevars(info)
+        first = [Argument(Var('__pydantic_self__'), self_type, None, ARG_POS)]
+    args = first + args
+    arg_types, arg_names, arg_kinds = [], [], []
+    for arg in args:
+        assert arg.type_annotation, 'All arguments must be fully typed.'
+        arg_types.append(arg.type_annotation)
+        arg_names.append(get_name(arg.variable))
+        arg_kinds.append(arg.kind)
+
+    function_type = ctx.api.named_type(f'{BUILTINS_NAME}.function')
+    signature = CallableType(arg_types, arg_kinds, arg_names, return_type, function_type)
+    if tvar_def:
+        signature.variables = [tvar_def]
+
+    func = FuncDef(name, args, Block([PassStmt()]))
+    func.info = info
+    func.type = set_callable_name(signature, func)
+    func.is_class = is_classmethod
+    # func.is_static = is_staticmethod
+    func._fullname = get_fullname(info) + '.' + name
+    func.line = info.line
+
+    # NOTE: we would like the plugin generated node to dominate, but we still
+    # need to keep any existing definitions so they get semantically analyzed.
+    if name in info.names:
+        # Get a nice unique name instead.
+        r_name = get_unique_redefinition_name(name, info.names)
+        info.names[r_name] = info.names[name]
+
+    if is_classmethod:  # or is_staticmethod:
+        func.is_decorated = True
+        v = Var(name, func.type)
+        v.info = info
+        v._fullname = func._fullname
+        # if is_classmethod:
+        v.is_classmethod = True
+        dec = Decorator(func, [NameExpr('classmethod')], v)
+        # else:
+        #     v.is_staticmethod = True
+        #     dec = Decorator(func, [NameExpr('staticmethod')], v)
+
+        dec.line = info.line
+        sym = SymbolTableNode(MDEF, dec)
+    else:
+        sym = SymbolTableNode(MDEF, func)
+    sym.plugin_generated = True
+
+    info.names[name] = sym
+    info.defn.defs.body.append(func)
+
+
+def get_fullname(x: Union[FuncBase, SymbolNode]) -> str:
+    """
+    Used for compatibility with mypy 0.740; can be dropped once support for 0.740 is dropped.
+    """
+    fn = x.fullname
+    if callable(fn):  # pragma: no cover
+        return fn()
+    return fn
+
+
+def get_name(x: Union[FuncBase, SymbolNode]) -> str:
+    """
+    Used for compatibility with mypy 0.740; can be dropped once support for 0.740 is dropped.
+    """
+    fn = x.name
+    if callable(fn):  # pragma: no cover
+        return fn()
+    return fn
+
+
+def parse_toml(config_file: str) -> Optional[Dict[str, Any]]:
+    if not config_file.endswith('.toml'):
+        return None
+
+    read_mode = 'rb'
+    if sys.version_info >= (3, 11):
+        import tomllib as toml_
+    else:
+        try:
+            import tomli as toml_
+        except ImportError:
+            # older versions of mypy have toml as a dependency, not tomli
+            read_mode = 'r'
+            try:
+                import toml as toml_  # type: ignore[no-redef]
+            except ImportError:  # pragma: no cover
+                import warnings
+
+                warnings.warn('No TOML parser installed, cannot read configuration from `pyproject.toml`.')
+                return None
+
+    with open(config_file, read_mode) as rf:
+        return toml_.load(rf)  # type: ignore[arg-type]
diff --git a/lib/pydantic/networks.py b/lib/pydantic/networks.py
new file mode 100644
index 00000000..c7d97186
--- /dev/null
+++ b/lib/pydantic/networks.py
@@ -0,0 +1,736 @@
+import re
+from ipaddress import (
+    IPv4Address,
+    IPv4Interface,
+    IPv4Network,
+    IPv6Address,
+    IPv6Interface,
+    IPv6Network,
+    _BaseAddress,
+    _BaseNetwork,
+)
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Collection,
+    Dict,
+    Generator,
+    List,
+    Match,
+    Optional,
+    Pattern,
+    Set,
+    Tuple,
+    Type,
+    Union,
+    cast,
+    no_type_check,
+)
+
+from . import errors
+from .utils import Representation, update_not_none
+from .validators import constr_length_validator, str_validator
+
+if TYPE_CHECKING:
+    import email_validator
+    from typing_extensions import TypedDict
+
+    from .config import BaseConfig
+    from .fields import ModelField
+    from .typing import AnyCallable
+
+    CallableGenerator = Generator[AnyCallable, None, None]
+
+    class Parts(TypedDict, total=False):
+        scheme: str
+        user: Optional[str]
+        password: Optional[str]
+        ipv4: Optional[str]
+        ipv6: Optional[str]
+        domain: Optional[str]
+        port: Optional[str]
+        path: Optional[str]
+        query: Optional[str]
+        fragment: Optional[str]
+
+    class HostParts(TypedDict, total=False):
+        host: str
+        tld: Optional[str]
+        host_type: Optional[str]
+        port: Optional[str]
+        rebuild: bool
+
+else:
+    email_validator = None
+
+    class Parts(dict):
+        pass
+
+
+NetworkType = Union[str, bytes, int, Tuple[Union[str, bytes, int], Union[str, int]]]
+
+__all__ = [
+    'AnyUrl',
+    'AnyHttpUrl',
+    'FileUrl',
+    'HttpUrl',
+    'stricturl',
+    'EmailStr',
+    'NameEmail',
+    'IPvAnyAddress',
+    'IPvAnyInterface',
+    'IPvAnyNetwork',
+    'PostgresDsn',
+    'CockroachDsn',
+    'AmqpDsn',
+    'RedisDsn',
+    'MongoDsn',
+    'KafkaDsn',
+    'validate_email',
+]
+
+_url_regex_cache = None
+_multi_host_url_regex_cache = None
+_ascii_domain_regex_cache = None
+_int_domain_regex_cache = None
+_host_regex_cache = None
+
+_host_regex = (
+    r'(?:'
+    r'(?P<ipv4>(?:\d{1,3}\.){3}\d{1,3})(?=$|[/:#?])|'  # ipv4
+    r'(?P<ipv6>\[[A-F0-9]*:[A-F0-9:]+\])(?=$|[/:#?])|'  # ipv6
+    r'(?P<domain>[^\s/:?#]+)'  # domain, validation occurs later
+    r')?'
+    r'(?::(?P<port>\d+))?'  # port
+)
+_scheme_regex = r'(?:(?P<scheme>[a-z][a-z0-9+\-.]+)://)?'  # scheme https://tools.ietf.org/html/rfc3986#appendix-A
+_user_info_regex = r'(?:(?P<user>[^\s:/]*)(?::(?P<password>[^\s/]*))?@)?'
+_path_regex = r'(?P<path>/[^\s?#]*)?'
+_query_regex = r'(?:\?(?P<query>[^\s#]*))?'
+_fragment_regex = r'(?:#(?P<fragment>[^\s#]*))?'
+
+
+def url_regex() -> Pattern[str]:
+    global _url_regex_cache
+    if _url_regex_cache is None:
+        _url_regex_cache = re.compile(
+            rf'{_scheme_regex}{_user_info_regex}{_host_regex}{_path_regex}{_query_regex}{_fragment_regex}',
+            re.IGNORECASE,
+        )
+    return _url_regex_cache
+
+
+def multi_host_url_regex() -> Pattern[str]:
+    """
+    Compiled multi host url regex.
+
+    Additionally to `url_regex` it allows to match multiple hosts.
+    E.g. host1.db.net,host2.db.net
+    """
+    global _multi_host_url_regex_cache
+    if _multi_host_url_regex_cache is None:
+        _multi_host_url_regex_cache = re.compile(
+            rf'{_scheme_regex}{_user_info_regex}'
+            r'(?P<hosts>([^/]*))'  # validation occurs later
+            rf'{_path_regex}{_query_regex}{_fragment_regex}',
+            re.IGNORECASE,
+        )
+    return _multi_host_url_regex_cache
+
+
+def ascii_domain_regex() -> Pattern[str]:
+    global _ascii_domain_regex_cache
+    if _ascii_domain_regex_cache is None:
+        ascii_chunk = r'[_0-9a-z](?:[-_0-9a-z]{0,61}[_0-9a-z])?'
+        ascii_domain_ending = r'(?P<tld>\.[a-z]{2,63})?\.?'
+        _ascii_domain_regex_cache = re.compile(
+            fr'(?:{ascii_chunk}\.)*?{ascii_chunk}{ascii_domain_ending}', re.IGNORECASE
+        )
+    return _ascii_domain_regex_cache
+
+
+def int_domain_regex() -> Pattern[str]:
+    global _int_domain_regex_cache
+    if _int_domain_regex_cache is None:
+        int_chunk = r'[_0-9a-\U00040000](?:[-_0-9a-\U00040000]{0,61}[_0-9a-\U00040000])?'
+        int_domain_ending = r'(?P<tld>(\.[^\W\d_]{2,63})|(\.(?:xn--)[_0-9a-z-]{2,63}))?\.?'
+        _int_domain_regex_cache = re.compile(fr'(?:{int_chunk}\.)*?{int_chunk}{int_domain_ending}', re.IGNORECASE)
+    return _int_domain_regex_cache
+
+
+def host_regex() -> Pattern[str]:
+    global _host_regex_cache
+    if _host_regex_cache is None:
+        _host_regex_cache = re.compile(
+            _host_regex,
+            re.IGNORECASE,
+        )
+    return _host_regex_cache
+
+
+class AnyUrl(str):
+    strip_whitespace = True
+    min_length = 1
+    max_length = 2**16
+    allowed_schemes: Optional[Collection[str]] = None
+    tld_required: bool = False
+    user_required: bool = False
+    host_required: bool = True
+    hidden_parts: Set[str] = set()
+
+    __slots__ = ('scheme', 'user', 'password', 'host', 'tld', 'host_type', 'port', 'path', 'query', 'fragment')
+
+    @no_type_check
+    def __new__(cls, url: Optional[str], **kwargs) -> object:
+        return str.__new__(cls, cls.build(**kwargs) if url is None else url)
+
+    def __init__(
+        self,
+        url: str,
+        *,
+        scheme: str,
+        user: Optional[str] = None,
+        password: Optional[str] = None,
+        host: Optional[str] = None,
+        tld: Optional[str] = None,
+        host_type: str = 'domain',
+        port: Optional[str] = None,
+        path: Optional[str] = None,
+        query: Optional[str] = None,
+        fragment: Optional[str] = None,
+    ) -> None:
+        str.__init__(url)
+        self.scheme = scheme
+        self.user = user
+        self.password = password
+        self.host = host
+        self.tld = tld
+        self.host_type = host_type
+        self.port = port
+        self.path = path
+        self.query = query
+        self.fragment = fragment
+
+    @classmethod
+    def build(
+        cls,
+        *,
+        scheme: str,
+        user: Optional[str] = None,
+        password: Optional[str] = None,
+        host: str,
+        port: Optional[str] = None,
+        path: Optional[str] = None,
+        query: Optional[str] = None,
+        fragment: Optional[str] = None,
+        **_kwargs: str,
+    ) -> str:
+        parts = Parts(
+            scheme=scheme,
+            user=user,
+            password=password,
+            host=host,
+            port=port,
+            path=path,
+            query=query,
+            fragment=fragment,
+            **_kwargs,  # type: ignore[misc]
+        )
+
+        url = scheme + '://'
+        if user:
+            url += user
+        if password:
+            url += ':' + password
+        if user or password:
+            url += '@'
+        url += host
+        if port and ('port' not in cls.hidden_parts or cls.get_default_parts(parts).get('port') != port):
+            url += ':' + port
+        if path:
+            url += path
+        if query:
+            url += '?' + query
+        if fragment:
+            url += '#' + fragment
+        return url
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        update_not_none(field_schema, minLength=cls.min_length, maxLength=cls.max_length, format='uri')
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield cls.validate
+
+    @classmethod
+    def validate(cls, value: Any, field: 'ModelField', config: 'BaseConfig') -> 'AnyUrl':
+        if value.__class__ == cls:
+            return value
+        value = str_validator(value)
+        if cls.strip_whitespace:
+            value = value.strip()
+        url: str = cast(str, constr_length_validator(value, field, config))
+
+        m = cls._match_url(url)
+        # the regex should always match, if it doesn't please report with details of the URL tried
+        assert m, 'URL regex failed unexpectedly'
+
+        original_parts = cast('Parts', m.groupdict())
+        parts = cls.apply_default_parts(original_parts)
+        parts = cls.validate_parts(parts)
+
+        if m.end() != len(url):
+            raise errors.UrlExtraError(extra=url[m.end() :])
+
+        return cls._build_url(m, url, parts)
+
+    @classmethod
+    def _build_url(cls, m: Match[str], url: str, parts: 'Parts') -> 'AnyUrl':
+        """
+        Validate hosts and build the AnyUrl object. Split from `validate` so this method
+        can be altered in `MultiHostDsn`.
+        """
+        host, tld, host_type, rebuild = cls.validate_host(parts)
+
+        return cls(
+            None if rebuild else url,
+            scheme=parts['scheme'],
+            user=parts['user'],
+            password=parts['password'],
+            host=host,
+            tld=tld,
+            host_type=host_type,
+            port=parts['port'],
+            path=parts['path'],
+            query=parts['query'],
+            fragment=parts['fragment'],
+        )
+
+    @staticmethod
+    def _match_url(url: str) -> Optional[Match[str]]:
+        return url_regex().match(url)
+
+    @staticmethod
+    def _validate_port(port: Optional[str]) -> None:
+        if port is not None and int(port) > 65_535:
+            raise errors.UrlPortError()
+
+    @classmethod
+    def validate_parts(cls, parts: 'Parts', validate_port: bool = True) -> 'Parts':
+        """
+        A method used to validate parts of a URL.
+        Could be overridden to set default values for parts if missing
+        """
+        scheme = parts['scheme']
+        if scheme is None:
+            raise errors.UrlSchemeError()
+
+        if cls.allowed_schemes and scheme.lower() not in cls.allowed_schemes:
+            raise errors.UrlSchemePermittedError(set(cls.allowed_schemes))
+
+        if validate_port:
+            cls._validate_port(parts['port'])
+
+        user = parts['user']
+        if cls.user_required and user is None:
+            raise errors.UrlUserInfoError()
+
+        return parts
+
+    @classmethod
+    def validate_host(cls, parts: 'Parts') -> Tuple[str, Optional[str], str, bool]:
+        tld, host_type, rebuild = None, None, False
+        for f in ('domain', 'ipv4', 'ipv6'):
+            host = parts[f]  # type: ignore[literal-required]
+            if host:
+                host_type = f
+                break
+
+        if host is None:
+            if cls.host_required:
+                raise errors.UrlHostError()
+        elif host_type == 'domain':
+            is_international = False
+            d = ascii_domain_regex().fullmatch(host)
+            if d is None:
+                d = int_domain_regex().fullmatch(host)
+                if d is None:
+                    raise errors.UrlHostError()
+                is_international = True
+
+            tld = d.group('tld')
+            if tld is None and not is_international:
+                d = int_domain_regex().fullmatch(host)
+                assert d is not None
+                tld = d.group('tld')
+                is_international = True
+
+            if tld is not None:
+                tld = tld[1:]
+            elif cls.tld_required:
+                raise errors.UrlHostTldError()
+
+            if is_international:
+                host_type = 'int_domain'
+                rebuild = True
+                host = host.encode('idna').decode('ascii')
+                if tld is not None:
+                    tld = tld.encode('idna').decode('ascii')
+
+        return host, tld, host_type, rebuild  # type: ignore
+
+    @staticmethod
+    def get_default_parts(parts: 'Parts') -> 'Parts':
+        return {}
+
+    @classmethod
+    def apply_default_parts(cls, parts: 'Parts') -> 'Parts':
+        for key, value in cls.get_default_parts(parts).items():
+            if not parts[key]:  # type: ignore[literal-required]
+                parts[key] = value  # type: ignore[literal-required]
+        return parts
+
+    def __repr__(self) -> str:
+        extra = ', '.join(f'{n}={getattr(self, n)!r}' for n in self.__slots__ if getattr(self, n) is not None)
+        return f'{self.__class__.__name__}({super().__repr__()}, {extra})'
+
+
+class AnyHttpUrl(AnyUrl):
+    allowed_schemes = {'http', 'https'}
+
+    __slots__ = ()
+
+
+class HttpUrl(AnyHttpUrl):
+    tld_required = True
+    # https://stackoverflow.com/questions/417142/what-is-the-maximum-length-of-a-url-in-different-browsers
+    max_length = 2083
+    hidden_parts = {'port'}
+
+    @staticmethod
+    def get_default_parts(parts: 'Parts') -> 'Parts':
+        return {'port': '80' if parts['scheme'] == 'http' else '443'}
+
+
+class FileUrl(AnyUrl):
+    allowed_schemes = {'file'}
+    host_required = False
+
+    __slots__ = ()
+
+
+class MultiHostDsn(AnyUrl):
+    __slots__ = AnyUrl.__slots__ + ('hosts',)
+
+    def __init__(self, *args: Any, hosts: Optional[List['HostParts']] = None, **kwargs: Any):
+        super().__init__(*args, **kwargs)
+        self.hosts = hosts
+
+    @staticmethod
+    def _match_url(url: str) -> Optional[Match[str]]:
+        return multi_host_url_regex().match(url)
+
+    @classmethod
+    def validate_parts(cls, parts: 'Parts', validate_port: bool = True) -> 'Parts':
+        return super().validate_parts(parts, validate_port=False)
+
+    @classmethod
+    def _build_url(cls, m: Match[str], url: str, parts: 'Parts') -> 'MultiHostDsn':
+        hosts_parts: List['HostParts'] = []
+        host_re = host_regex()
+        for host in m.groupdict()['hosts'].split(','):
+            d: Parts = host_re.match(host).groupdict()  # type: ignore
+            host, tld, host_type, rebuild = cls.validate_host(d)
+            port = d.get('port')
+            cls._validate_port(port)
+            hosts_parts.append(
+                {
+                    'host': host,
+                    'host_type': host_type,
+                    'tld': tld,
+                    'rebuild': rebuild,
+                    'port': port,
+                }
+            )
+
+        if len(hosts_parts) > 1:
+            return cls(
+                None if any([hp['rebuild'] for hp in hosts_parts]) else url,
+                scheme=parts['scheme'],
+                user=parts['user'],
+                password=parts['password'],
+                path=parts['path'],
+                query=parts['query'],
+                fragment=parts['fragment'],
+                host_type=None,
+                hosts=hosts_parts,
+            )
+        else:
+            # backwards compatibility with single host
+            host_part = hosts_parts[0]
+            return cls(
+                None if host_part['rebuild'] else url,
+                scheme=parts['scheme'],
+                user=parts['user'],
+                password=parts['password'],
+                host=host_part['host'],
+                tld=host_part['tld'],
+                host_type=host_part['host_type'],
+                port=host_part.get('port'),
+                path=parts['path'],
+                query=parts['query'],
+                fragment=parts['fragment'],
+            )
+
+
+class PostgresDsn(MultiHostDsn):
+    allowed_schemes = {
+        'postgres',
+        'postgresql',
+        'postgresql+asyncpg',
+        'postgresql+pg8000',
+        'postgresql+psycopg2',
+        'postgresql+psycopg2cffi',
+        'postgresql+py-postgresql',
+        'postgresql+pygresql',
+    }
+    user_required = True
+
+    __slots__ = ()
+
+
+class CockroachDsn(AnyUrl):
+    allowed_schemes = {
+        'cockroachdb',
+        'cockroachdb+psycopg2',
+        'cockroachdb+asyncpg',
+    }
+    user_required = True
+
+
+class AmqpDsn(AnyUrl):
+    allowed_schemes = {'amqp', 'amqps'}
+    host_required = False
+
+
+class RedisDsn(AnyUrl):
+    __slots__ = ()
+    allowed_schemes = {'redis', 'rediss'}
+    host_required = False
+
+    @staticmethod
+    def get_default_parts(parts: 'Parts') -> 'Parts':
+        return {
+            'domain': 'localhost' if not (parts['ipv4'] or parts['ipv6']) else '',
+            'port': '6379',
+            'path': '/0',
+        }
+
+
+class MongoDsn(AnyUrl):
+    allowed_schemes = {'mongodb'}
+
+    # TODO: Needed to generic "Parts" for "Replica Set", "Sharded Cluster", and other mongodb deployment modes
+    @staticmethod
+    def get_default_parts(parts: 'Parts') -> 'Parts':
+        return {
+            'port': '27017',
+        }
+
+
+class KafkaDsn(AnyUrl):
+    allowed_schemes = {'kafka'}
+
+    @staticmethod
+    def get_default_parts(parts: 'Parts') -> 'Parts':
+        return {
+            'domain': 'localhost',
+            'port': '9092',
+        }
+
+
+def stricturl(
+    *,
+    strip_whitespace: bool = True,
+    min_length: int = 1,
+    max_length: int = 2**16,
+    tld_required: bool = True,
+    host_required: bool = True,
+    allowed_schemes: Optional[Collection[str]] = None,
+) -> Type[AnyUrl]:
+    # use kwargs then define conf in a dict to aid with IDE type hinting
+    namespace = dict(
+        strip_whitespace=strip_whitespace,
+        min_length=min_length,
+        max_length=max_length,
+        tld_required=tld_required,
+        host_required=host_required,
+        allowed_schemes=allowed_schemes,
+    )
+    return type('UrlValue', (AnyUrl,), namespace)
+
+
+def import_email_validator() -> None:
+    global email_validator
+    try:
+        import email_validator
+    except ImportError as e:
+        raise ImportError('email-validator is not installed, run `pip install pydantic[email]`') from e
+
+
+class EmailStr(str):
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        field_schema.update(type='string', format='email')
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        # included here and below so the error happens straight away
+        import_email_validator()
+
+        yield str_validator
+        yield cls.validate
+
+    @classmethod
+    def validate(cls, value: Union[str]) -> str:
+        return validate_email(value)[1]
+
+
+class NameEmail(Representation):
+    __slots__ = 'name', 'email'
+
+    def __init__(self, name: str, email: str):
+        self.name = name
+        self.email = email
+
+    def __eq__(self, other: Any) -> bool:
+        return isinstance(other, NameEmail) and (self.name, self.email) == (other.name, other.email)
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        field_schema.update(type='string', format='name-email')
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        import_email_validator()
+
+        yield cls.validate
+
+    @classmethod
+    def validate(cls, value: Any) -> 'NameEmail':
+        if value.__class__ == cls:
+            return value
+        value = str_validator(value)
+        return cls(*validate_email(value))
+
+    def __str__(self) -> str:
+        return f'{self.name} <{self.email}>'
+
+
+class IPvAnyAddress(_BaseAddress):
+    __slots__ = ()
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        field_schema.update(type='string', format='ipvanyaddress')
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield cls.validate
+
+    @classmethod
+    def validate(cls, value: Union[str, bytes, int]) -> Union[IPv4Address, IPv6Address]:
+        try:
+            return IPv4Address(value)
+        except ValueError:
+            pass
+
+        try:
+            return IPv6Address(value)
+        except ValueError:
+            raise errors.IPvAnyAddressError()
+
+
+class IPvAnyInterface(_BaseAddress):
+    __slots__ = ()
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        field_schema.update(type='string', format='ipvanyinterface')
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield cls.validate
+
+    @classmethod
+    def validate(cls, value: NetworkType) -> Union[IPv4Interface, IPv6Interface]:
+        try:
+            return IPv4Interface(value)
+        except ValueError:
+            pass
+
+        try:
+            return IPv6Interface(value)
+        except ValueError:
+            raise errors.IPvAnyInterfaceError()
+
+
+class IPvAnyNetwork(_BaseNetwork):  # type: ignore
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        field_schema.update(type='string', format='ipvanynetwork')
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield cls.validate
+
+    @classmethod
+    def validate(cls, value: NetworkType) -> Union[IPv4Network, IPv6Network]:
+        # Assume IP Network is defined with a default value for ``strict`` argument.
+        # Define your own class if you want to specify network address check strictness.
+        try:
+            return IPv4Network(value)
+        except ValueError:
+            pass
+
+        try:
+            return IPv6Network(value)
+        except ValueError:
+            raise errors.IPvAnyNetworkError()
+
+
+pretty_email_regex = re.compile(r'([\w ]*?) *<(.*)> *')
+
+
+def validate_email(value: Union[str]) -> Tuple[str, str]:
+    """
+    Brutally simple email address validation. Note unlike most email address validation
+    * raw ip address (literal) domain parts are not allowed.
+    * "John Doe <local_part@domain.com>" style "pretty" email addresses are processed
+    * the local part check is extremely basic. This raises the possibility of unicode spoofing, but no better
+        solution is really possible.
+    * spaces are striped from the beginning and end of addresses but no error is raised
+
+    See RFC 5322 but treat it with suspicion, there seems to exist no universally acknowledged test for a valid email!
+    """
+    if email_validator is None:
+        import_email_validator()
+
+    m = pretty_email_regex.fullmatch(value)
+    name: Optional[str] = None
+    if m:
+        name, value = m.groups()
+
+    email = value.strip()
+
+    try:
+        email_validator.validate_email(email, check_deliverability=False)
+    except email_validator.EmailNotValidError as e:
+        raise errors.EmailError() from e
+
+    at_index = email.index('@')
+    local_part = email[:at_index]  # RFC 5321, local part must be case-sensitive.
+    global_part = email[at_index:].lower()
+
+    return name or local_part, local_part + global_part
diff --git a/lib/pydantic/parse.py b/lib/pydantic/parse.py
new file mode 100644
index 00000000..7ac330ca
--- /dev/null
+++ b/lib/pydantic/parse.py
@@ -0,0 +1,66 @@
+import json
+import pickle
+from enum import Enum
+from pathlib import Path
+from typing import Any, Callable, Union
+
+from .types import StrBytes
+
+
+class Protocol(str, Enum):
+    json = 'json'
+    pickle = 'pickle'
+
+
+def load_str_bytes(
+    b: StrBytes,
+    *,
+    content_type: str = None,
+    encoding: str = 'utf8',
+    proto: Protocol = None,
+    allow_pickle: bool = False,
+    json_loads: Callable[[str], Any] = json.loads,
+) -> Any:
+    if proto is None and content_type:
+        if content_type.endswith(('json', 'javascript')):
+            pass
+        elif allow_pickle and content_type.endswith('pickle'):
+            proto = Protocol.pickle
+        else:
+            raise TypeError(f'Unknown content-type: {content_type}')
+
+    proto = proto or Protocol.json
+
+    if proto == Protocol.json:
+        if isinstance(b, bytes):
+            b = b.decode(encoding)
+        return json_loads(b)
+    elif proto == Protocol.pickle:
+        if not allow_pickle:
+            raise RuntimeError('Trying to decode with pickle with allow_pickle=False')
+        bb = b if isinstance(b, bytes) else b.encode()
+        return pickle.loads(bb)
+    else:
+        raise TypeError(f'Unknown protocol: {proto}')
+
+
+def load_file(
+    path: Union[str, Path],
+    *,
+    content_type: str = None,
+    encoding: str = 'utf8',
+    proto: Protocol = None,
+    allow_pickle: bool = False,
+    json_loads: Callable[[str], Any] = json.loads,
+) -> Any:
+    path = Path(path)
+    b = path.read_bytes()
+    if content_type is None:
+        if path.suffix in ('.js', '.json'):
+            proto = Protocol.json
+        elif path.suffix == '.pkl':
+            proto = Protocol.pickle
+
+    return load_str_bytes(
+        b, proto=proto, content_type=content_type, encoding=encoding, allow_pickle=allow_pickle, json_loads=json_loads
+    )
diff --git a/lib/pydantic/py.typed b/lib/pydantic/py.typed
new file mode 100644
index 00000000..e69de29b
diff --git a/lib/pydantic/schema.py b/lib/pydantic/schema.py
new file mode 100644
index 00000000..e7af56f1
--- /dev/null
+++ b/lib/pydantic/schema.py
@@ -0,0 +1,1153 @@
+import re
+import warnings
+from collections import defaultdict
+from datetime import date, datetime, time, timedelta
+from decimal import Decimal
+from enum import Enum
+from ipaddress import IPv4Address, IPv4Interface, IPv4Network, IPv6Address, IPv6Interface, IPv6Network
+from pathlib import Path
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    Dict,
+    ForwardRef,
+    FrozenSet,
+    Generic,
+    Iterable,
+    List,
+    Optional,
+    Pattern,
+    Sequence,
+    Set,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+    cast,
+)
+from uuid import UUID
+
+from typing_extensions import Annotated, Literal
+
+from .fields import (
+    MAPPING_LIKE_SHAPES,
+    SHAPE_DEQUE,
+    SHAPE_FROZENSET,
+    SHAPE_GENERIC,
+    SHAPE_ITERABLE,
+    SHAPE_LIST,
+    SHAPE_SEQUENCE,
+    SHAPE_SET,
+    SHAPE_SINGLETON,
+    SHAPE_TUPLE,
+    SHAPE_TUPLE_ELLIPSIS,
+    FieldInfo,
+    ModelField,
+)
+from .json import pydantic_encoder
+from .networks import AnyUrl, EmailStr
+from .types import (
+    ConstrainedDecimal,
+    ConstrainedFloat,
+    ConstrainedFrozenSet,
+    ConstrainedInt,
+    ConstrainedList,
+    ConstrainedSet,
+    SecretBytes,
+    SecretStr,
+    StrictBytes,
+    StrictStr,
+    conbytes,
+    condecimal,
+    confloat,
+    confrozenset,
+    conint,
+    conlist,
+    conset,
+    constr,
+)
+from .typing import (
+    all_literal_values,
+    get_args,
+    get_origin,
+    get_sub_types,
+    is_callable_type,
+    is_literal_type,
+    is_namedtuple,
+    is_none_type,
+    is_union,
+)
+from .utils import ROOT_KEY, get_model, lenient_issubclass
+
+if TYPE_CHECKING:
+    from .dataclasses import Dataclass
+    from .main import BaseModel
+
+default_prefix = '#/definitions/'
+default_ref_template = '#/definitions/{model}'
+
+TypeModelOrEnum = Union[Type['BaseModel'], Type[Enum]]
+TypeModelSet = Set[TypeModelOrEnum]
+
+
+def _apply_modify_schema(
+    modify_schema: Callable[..., None], field: Optional[ModelField], field_schema: Dict[str, Any]
+) -> None:
+    from inspect import signature
+
+    sig = signature(modify_schema)
+    args = set(sig.parameters.keys())
+    if 'field' in args or 'kwargs' in args:
+        modify_schema(field_schema, field=field)
+    else:
+        modify_schema(field_schema)
+
+
+def schema(
+    models: Sequence[Union[Type['BaseModel'], Type['Dataclass']]],
+    *,
+    by_alias: bool = True,
+    title: Optional[str] = None,
+    description: Optional[str] = None,
+    ref_prefix: Optional[str] = None,
+    ref_template: str = default_ref_template,
+) -> Dict[str, Any]:
+    """
+    Process a list of models and generate a single JSON Schema with all of them defined in the ``definitions``
+    top-level JSON key, including their sub-models.
+
+    :param models: a list of models to include in the generated JSON Schema
+    :param by_alias: generate the schemas using the aliases defined, if any
+    :param title: title for the generated schema that includes the definitions
+    :param description: description for the generated schema
+    :param ref_prefix: the JSON Pointer prefix for schema references with ``$ref``, if None, will be set to the
+      default of ``#/definitions/``. Update it if you want the schemas to reference the definitions somewhere
+      else, e.g. for OpenAPI use ``#/components/schemas/``. The resulting generated schemas will still be at the
+      top-level key ``definitions``, so you can extract them from there. But all the references will have the set
+      prefix.
+    :param ref_template: Use a ``string.format()`` template for ``$ref`` instead of a prefix. This can be useful
+      for references that cannot be represented by ``ref_prefix`` such as a definition stored in another file. For
+      a sibling json file in a ``/schemas`` directory use ``"/schemas/${model}.json#"``.
+    :return: dict with the JSON Schema with a ``definitions`` top-level key including the schema definitions for
+      the models and sub-models passed in ``models``.
+    """
+    clean_models = [get_model(model) for model in models]
+    flat_models = get_flat_models_from_models(clean_models)
+    model_name_map = get_model_name_map(flat_models)
+    definitions = {}
+    output_schema: Dict[str, Any] = {}
+    if title:
+        output_schema['title'] = title
+    if description:
+        output_schema['description'] = description
+    for model in clean_models:
+        m_schema, m_definitions, m_nested_models = model_process_schema(
+            model,
+            by_alias=by_alias,
+            model_name_map=model_name_map,
+            ref_prefix=ref_prefix,
+            ref_template=ref_template,
+        )
+        definitions.update(m_definitions)
+        model_name = model_name_map[model]
+        definitions[model_name] = m_schema
+    if definitions:
+        output_schema['definitions'] = definitions
+    return output_schema
+
+
+def model_schema(
+    model: Union[Type['BaseModel'], Type['Dataclass']],
+    by_alias: bool = True,
+    ref_prefix: Optional[str] = None,
+    ref_template: str = default_ref_template,
+) -> Dict[str, Any]:
+    """
+    Generate a JSON Schema for one model. With all the sub-models defined in the ``definitions`` top-level
+    JSON key.
+
+    :param model: a Pydantic model (a class that inherits from BaseModel)
+    :param by_alias: generate the schemas using the aliases defined, if any
+    :param ref_prefix: the JSON Pointer prefix for schema references with ``$ref``, if None, will be set to the
+      default of ``#/definitions/``. Update it if you want the schemas to reference the definitions somewhere
+      else, e.g. for OpenAPI use ``#/components/schemas/``. The resulting generated schemas will still be at the
+      top-level key ``definitions``, so you can extract them from there. But all the references will have the set
+      prefix.
+    :param ref_template: Use a ``string.format()`` template for ``$ref`` instead of a prefix. This can be useful for
+      references that cannot be represented by ``ref_prefix`` such as a definition stored in another file. For a
+      sibling json file in a ``/schemas`` directory use ``"/schemas/${model}.json#"``.
+    :return: dict with the JSON Schema for the passed ``model``
+    """
+    model = get_model(model)
+    flat_models = get_flat_models_from_model(model)
+    model_name_map = get_model_name_map(flat_models)
+    model_name = model_name_map[model]
+    m_schema, m_definitions, nested_models = model_process_schema(
+        model, by_alias=by_alias, model_name_map=model_name_map, ref_prefix=ref_prefix, ref_template=ref_template
+    )
+    if model_name in nested_models:
+        # model_name is in Nested models, it has circular references
+        m_definitions[model_name] = m_schema
+        m_schema = get_schema_ref(model_name, ref_prefix, ref_template, False)
+    if m_definitions:
+        m_schema.update({'definitions': m_definitions})
+    return m_schema
+
+
+def get_field_info_schema(field: ModelField, schema_overrides: bool = False) -> Tuple[Dict[str, Any], bool]:
+
+    # If no title is explicitly set, we don't set title in the schema for enums.
+    # The behaviour is the same as `BaseModel` reference, where the default title
+    # is in the definitions part of the schema.
+    schema_: Dict[str, Any] = {}
+    if field.field_info.title or not lenient_issubclass(field.type_, Enum):
+        schema_['title'] = field.field_info.title or field.alias.title().replace('_', ' ')
+
+    if field.field_info.title:
+        schema_overrides = True
+
+    if field.field_info.description:
+        schema_['description'] = field.field_info.description
+        schema_overrides = True
+
+    if not field.required and field.default is not None and not is_callable_type(field.outer_type_):
+        schema_['default'] = encode_default(field.default)
+        schema_overrides = True
+
+    return schema_, schema_overrides
+
+
+def field_schema(
+    field: ModelField,
+    *,
+    by_alias: bool = True,
+    model_name_map: Dict[TypeModelOrEnum, str],
+    ref_prefix: Optional[str] = None,
+    ref_template: str = default_ref_template,
+    known_models: TypeModelSet = None,
+) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]:
+    """
+    Process a Pydantic field and return a tuple with a JSON Schema for it as the first item.
+    Also return a dictionary of definitions with models as keys and their schemas as values. If the passed field
+    is a model and has sub-models, and those sub-models don't have overrides (as ``title``, ``default``, etc), they
+    will be included in the definitions and referenced in the schema instead of included recursively.
+
+    :param field: a Pydantic ``ModelField``
+    :param by_alias: use the defined alias (if any) in the returned schema
+    :param model_name_map: used to generate the JSON Schema references to other models included in the definitions
+    :param ref_prefix: the JSON Pointer prefix to use for references to other schemas, if None, the default of
+      #/definitions/ will be used
+    :param ref_template: Use a ``string.format()`` template for ``$ref`` instead of a prefix. This can be useful for
+      references that cannot be represented by ``ref_prefix`` such as a definition stored in another file. For a
+      sibling json file in a ``/schemas`` directory use ``"/schemas/${model}.json#"``.
+    :param known_models: used to solve circular references
+    :return: tuple of the schema for this field and additional definitions
+    """
+    s, schema_overrides = get_field_info_schema(field)
+
+    validation_schema = get_field_schema_validations(field)
+    if validation_schema:
+        s.update(validation_schema)
+        schema_overrides = True
+
+    f_schema, f_definitions, f_nested_models = field_type_schema(
+        field,
+        by_alias=by_alias,
+        model_name_map=model_name_map,
+        schema_overrides=schema_overrides,
+        ref_prefix=ref_prefix,
+        ref_template=ref_template,
+        known_models=known_models or set(),
+    )
+
+    # $ref will only be returned when there are no schema_overrides
+    if '$ref' in f_schema:
+        return f_schema, f_definitions, f_nested_models
+    else:
+        s.update(f_schema)
+        return s, f_definitions, f_nested_models
+
+
+numeric_types = (int, float, Decimal)
+_str_types_attrs: Tuple[Tuple[str, Union[type, Tuple[type, ...]], str], ...] = (
+    ('max_length', numeric_types, 'maxLength'),
+    ('min_length', numeric_types, 'minLength'),
+    ('regex', str, 'pattern'),
+)
+
+_numeric_types_attrs: Tuple[Tuple[str, Union[type, Tuple[type, ...]], str], ...] = (
+    ('gt', numeric_types, 'exclusiveMinimum'),
+    ('lt', numeric_types, 'exclusiveMaximum'),
+    ('ge', numeric_types, 'minimum'),
+    ('le', numeric_types, 'maximum'),
+    ('multiple_of', numeric_types, 'multipleOf'),
+)
+
+
+def get_field_schema_validations(field: ModelField) -> Dict[str, Any]:
+    """
+    Get the JSON Schema validation keywords for a ``field`` with an annotation of
+    a Pydantic ``FieldInfo`` with validation arguments.
+    """
+    f_schema: Dict[str, Any] = {}
+
+    if lenient_issubclass(field.type_, Enum):
+        # schema is already updated by `enum_process_schema`; just update with field extra
+        if field.field_info.extra:
+            f_schema.update(field.field_info.extra)
+        return f_schema
+
+    if lenient_issubclass(field.type_, (str, bytes)):
+        for attr_name, t, keyword in _str_types_attrs:
+            attr = getattr(field.field_info, attr_name, None)
+            if isinstance(attr, t):
+                f_schema[keyword] = attr
+    if lenient_issubclass(field.type_, numeric_types) and not issubclass(field.type_, bool):
+        for attr_name, t, keyword in _numeric_types_attrs:
+            attr = getattr(field.field_info, attr_name, None)
+            if isinstance(attr, t):
+                f_schema[keyword] = attr
+    if field.field_info is not None and field.field_info.const:
+        f_schema['const'] = field.default
+    if field.field_info.extra:
+        f_schema.update(field.field_info.extra)
+    modify_schema = getattr(field.outer_type_, '__modify_schema__', None)
+    if modify_schema:
+        _apply_modify_schema(modify_schema, field, f_schema)
+    return f_schema
+
+
+def get_model_name_map(unique_models: TypeModelSet) -> Dict[TypeModelOrEnum, str]:
+    """
+    Process a set of models and generate unique names for them to be used as keys in the JSON Schema
+    definitions. By default the names are the same as the class name. But if two models in different Python
+    modules have the same name (e.g. "users.Model" and "items.Model"), the generated names will be
+    based on the Python module path for those conflicting models to prevent name collisions.
+
+    :param unique_models: a Python set of models
+    :return: dict mapping models to names
+    """
+    name_model_map = {}
+    conflicting_names: Set[str] = set()
+    for model in unique_models:
+        model_name = normalize_name(model.__name__)
+        if model_name in conflicting_names:
+            model_name = get_long_model_name(model)
+            name_model_map[model_name] = model
+        elif model_name in name_model_map:
+            conflicting_names.add(model_name)
+            conflicting_model = name_model_map.pop(model_name)
+            name_model_map[get_long_model_name(conflicting_model)] = conflicting_model
+            name_model_map[get_long_model_name(model)] = model
+        else:
+            name_model_map[model_name] = model
+    return {v: k for k, v in name_model_map.items()}
+
+
+def get_flat_models_from_model(model: Type['BaseModel'], known_models: TypeModelSet = None) -> TypeModelSet:
+    """
+    Take a single ``model`` and generate a set with itself and all the sub-models in the tree. I.e. if you pass
+    model ``Foo`` (subclass of Pydantic ``BaseModel``) as ``model``, and it has a field of type ``Bar`` (also
+    subclass of ``BaseModel``) and that model ``Bar`` has a field of type ``Baz`` (also subclass of ``BaseModel``),
+    the return value will be ``set([Foo, Bar, Baz])``.
+
+    :param model: a Pydantic ``BaseModel`` subclass
+    :param known_models: used to solve circular references
+    :return: a set with the initial model and all its sub-models
+    """
+    known_models = known_models or set()
+    flat_models: TypeModelSet = set()
+    flat_models.add(model)
+    known_models |= flat_models
+    fields = cast(Sequence[ModelField], model.__fields__.values())
+    flat_models |= get_flat_models_from_fields(fields, known_models=known_models)
+    return flat_models
+
+
+def get_flat_models_from_field(field: ModelField, known_models: TypeModelSet) -> TypeModelSet:
+    """
+    Take a single Pydantic ``ModelField`` (from a model) that could have been declared as a sublcass of BaseModel
+    (so, it could be a submodel), and generate a set with its model and all the sub-models in the tree.
+    I.e. if you pass a field that was declared to be of type ``Foo`` (subclass of BaseModel) as ``field``, and that
+    model ``Foo`` has a field of type ``Bar`` (also subclass of ``BaseModel``) and that model ``Bar`` has a field of
+    type ``Baz`` (also subclass of ``BaseModel``), the return value will be ``set([Foo, Bar, Baz])``.
+
+    :param field: a Pydantic ``ModelField``
+    :param known_models: used to solve circular references
+    :return: a set with the model used in the declaration for this field, if any, and all its sub-models
+    """
+    from .main import BaseModel
+
+    flat_models: TypeModelSet = set()
+
+    field_type = field.type_
+    if lenient_issubclass(getattr(field_type, '__pydantic_model__', None), BaseModel):
+        field_type = field_type.__pydantic_model__
+
+    if field.sub_fields and not lenient_issubclass(field_type, BaseModel):
+        flat_models |= get_flat_models_from_fields(field.sub_fields, known_models=known_models)
+    elif lenient_issubclass(field_type, BaseModel) and field_type not in known_models:
+        flat_models |= get_flat_models_from_model(field_type, known_models=known_models)
+    elif lenient_issubclass(field_type, Enum):
+        flat_models.add(field_type)
+    return flat_models
+
+
+def get_flat_models_from_fields(fields: Sequence[ModelField], known_models: TypeModelSet) -> TypeModelSet:
+    """
+    Take a list of Pydantic  ``ModelField``s (from a model) that could have been declared as subclasses of ``BaseModel``
+    (so, any of them could be a submodel), and generate a set with their models and all the sub-models in the tree.
+    I.e. if you pass a the fields of a model ``Foo`` (subclass of ``BaseModel``) as ``fields``, and on of them has a
+    field of type ``Bar`` (also subclass of ``BaseModel``) and that model ``Bar`` has a field of type ``Baz`` (also
+    subclass of ``BaseModel``), the return value will be ``set([Foo, Bar, Baz])``.
+
+    :param fields: a list of Pydantic ``ModelField``s
+    :param known_models: used to solve circular references
+    :return: a set with any model declared in the fields, and all their sub-models
+    """
+    flat_models: TypeModelSet = set()
+    for field in fields:
+        flat_models |= get_flat_models_from_field(field, known_models=known_models)
+    return flat_models
+
+
+def get_flat_models_from_models(models: Sequence[Type['BaseModel']]) -> TypeModelSet:
+    """
+    Take a list of ``models`` and generate a set with them and all their sub-models in their trees. I.e. if you pass
+    a list of two models, ``Foo`` and ``Bar``, both subclasses of Pydantic ``BaseModel`` as models, and ``Bar`` has
+    a field of type ``Baz`` (also subclass of ``BaseModel``), the return value will be ``set([Foo, Bar, Baz])``.
+    """
+    flat_models: TypeModelSet = set()
+    for model in models:
+        flat_models |= get_flat_models_from_model(model)
+    return flat_models
+
+
+def get_long_model_name(model: TypeModelOrEnum) -> str:
+    return f'{model.__module__}__{model.__qualname__}'.replace('.', '__')
+
+
+def field_type_schema(
+    field: ModelField,
+    *,
+    by_alias: bool,
+    model_name_map: Dict[TypeModelOrEnum, str],
+    ref_template: str,
+    schema_overrides: bool = False,
+    ref_prefix: Optional[str] = None,
+    known_models: TypeModelSet,
+) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]:
+    """
+    Used by ``field_schema()``, you probably should be using that function.
+
+    Take a single ``field`` and generate the schema for its type only, not including additional
+    information as title, etc. Also return additional schema definitions, from sub-models.
+    """
+    from .main import BaseModel  # noqa: F811
+
+    definitions = {}
+    nested_models: Set[str] = set()
+    f_schema: Dict[str, Any]
+    if field.shape in {
+        SHAPE_LIST,
+        SHAPE_TUPLE_ELLIPSIS,
+        SHAPE_SEQUENCE,
+        SHAPE_SET,
+        SHAPE_FROZENSET,
+        SHAPE_ITERABLE,
+        SHAPE_DEQUE,
+    }:
+        items_schema, f_definitions, f_nested_models = field_singleton_schema(
+            field,
+            by_alias=by_alias,
+            model_name_map=model_name_map,
+            ref_prefix=ref_prefix,
+            ref_template=ref_template,
+            known_models=known_models,
+        )
+        definitions.update(f_definitions)
+        nested_models.update(f_nested_models)
+        f_schema = {'type': 'array', 'items': items_schema}
+        if field.shape in {SHAPE_SET, SHAPE_FROZENSET}:
+            f_schema['uniqueItems'] = True
+
+    elif field.shape in MAPPING_LIKE_SHAPES:
+        f_schema = {'type': 'object'}
+        key_field = cast(ModelField, field.key_field)
+        regex = getattr(key_field.type_, 'regex', None)
+        items_schema, f_definitions, f_nested_models = field_singleton_schema(
+            field,
+            by_alias=by_alias,
+            model_name_map=model_name_map,
+            ref_prefix=ref_prefix,
+            ref_template=ref_template,
+            known_models=known_models,
+        )
+        definitions.update(f_definitions)
+        nested_models.update(f_nested_models)
+        if regex:
+            # Dict keys have a regex pattern
+            # items_schema might be a schema or empty dict, add it either way
+            f_schema['patternProperties'] = {regex.pattern: items_schema}
+        elif items_schema:
+            # The dict values are not simply Any, so they need a schema
+            f_schema['additionalProperties'] = items_schema
+    elif field.shape == SHAPE_TUPLE or (field.shape == SHAPE_GENERIC and not issubclass(field.type_, BaseModel)):
+        sub_schema = []
+        sub_fields = cast(List[ModelField], field.sub_fields)
+        for sf in sub_fields:
+            sf_schema, sf_definitions, sf_nested_models = field_type_schema(
+                sf,
+                by_alias=by_alias,
+                model_name_map=model_name_map,
+                ref_prefix=ref_prefix,
+                ref_template=ref_template,
+                known_models=known_models,
+            )
+            definitions.update(sf_definitions)
+            nested_models.update(sf_nested_models)
+            sub_schema.append(sf_schema)
+
+        sub_fields_len = len(sub_fields)
+        if field.shape == SHAPE_GENERIC:
+            all_of_schemas = sub_schema[0] if sub_fields_len == 1 else {'type': 'array', 'items': sub_schema}
+            f_schema = {'allOf': [all_of_schemas]}
+        else:
+            f_schema = {
+                'type': 'array',
+                'minItems': sub_fields_len,
+                'maxItems': sub_fields_len,
+            }
+            if sub_fields_len >= 1:
+                f_schema['items'] = sub_schema
+    else:
+        assert field.shape in {SHAPE_SINGLETON, SHAPE_GENERIC}, field.shape
+        f_schema, f_definitions, f_nested_models = field_singleton_schema(
+            field,
+            by_alias=by_alias,
+            model_name_map=model_name_map,
+            schema_overrides=schema_overrides,
+            ref_prefix=ref_prefix,
+            ref_template=ref_template,
+            known_models=known_models,
+        )
+        definitions.update(f_definitions)
+        nested_models.update(f_nested_models)
+
+    # check field type to avoid repeated calls to the same __modify_schema__ method
+    if field.type_ != field.outer_type_:
+        if field.shape == SHAPE_GENERIC:
+            field_type = field.type_
+        else:
+            field_type = field.outer_type_
+        modify_schema = getattr(field_type, '__modify_schema__', None)
+        if modify_schema:
+            _apply_modify_schema(modify_schema, field, f_schema)
+    return f_schema, definitions, nested_models
+
+
+def model_process_schema(
+    model: TypeModelOrEnum,
+    *,
+    by_alias: bool = True,
+    model_name_map: Dict[TypeModelOrEnum, str],
+    ref_prefix: Optional[str] = None,
+    ref_template: str = default_ref_template,
+    known_models: TypeModelSet = None,
+    field: Optional[ModelField] = None,
+) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]:
+    """
+    Used by ``model_schema()``, you probably should be using that function.
+
+    Take a single ``model`` and generate its schema. Also return additional schema definitions, from sub-models. The
+    sub-models of the returned schema will be referenced, but their definitions will not be included in the schema. All
+    the definitions are returned as the second value.
+    """
+    from inspect import getdoc, signature
+
+    known_models = known_models or set()
+    if lenient_issubclass(model, Enum):
+        model = cast(Type[Enum], model)
+        s = enum_process_schema(model, field=field)
+        return s, {}, set()
+    model = cast(Type['BaseModel'], model)
+    s = {'title': model.__config__.title or model.__name__}
+    doc = getdoc(model)
+    if doc:
+        s['description'] = doc
+    known_models.add(model)
+    m_schema, m_definitions, nested_models = model_type_schema(
+        model,
+        by_alias=by_alias,
+        model_name_map=model_name_map,
+        ref_prefix=ref_prefix,
+        ref_template=ref_template,
+        known_models=known_models,
+    )
+    s.update(m_schema)
+    schema_extra = model.__config__.schema_extra
+    if callable(schema_extra):
+        if len(signature(schema_extra).parameters) == 1:
+            schema_extra(s)
+        else:
+            schema_extra(s, model)
+    else:
+        s.update(schema_extra)
+    return s, m_definitions, nested_models
+
+
+def model_type_schema(
+    model: Type['BaseModel'],
+    *,
+    by_alias: bool,
+    model_name_map: Dict[TypeModelOrEnum, str],
+    ref_template: str,
+    ref_prefix: Optional[str] = None,
+    known_models: TypeModelSet,
+) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]:
+    """
+    You probably should be using ``model_schema()``, this function is indirectly used by that function.
+
+    Take a single ``model`` and generate the schema for its type only, not including additional
+    information as title, etc. Also return additional schema definitions, from sub-models.
+    """
+    properties = {}
+    required = []
+    definitions: Dict[str, Any] = {}
+    nested_models: Set[str] = set()
+    for k, f in model.__fields__.items():
+        try:
+            f_schema, f_definitions, f_nested_models = field_schema(
+                f,
+                by_alias=by_alias,
+                model_name_map=model_name_map,
+                ref_prefix=ref_prefix,
+                ref_template=ref_template,
+                known_models=known_models,
+            )
+        except SkipField as skip:
+            warnings.warn(skip.message, UserWarning)
+            continue
+        definitions.update(f_definitions)
+        nested_models.update(f_nested_models)
+        if by_alias:
+            properties[f.alias] = f_schema
+            if f.required:
+                required.append(f.alias)
+        else:
+            properties[k] = f_schema
+            if f.required:
+                required.append(k)
+    if ROOT_KEY in properties:
+        out_schema = properties[ROOT_KEY]
+        out_schema['title'] = model.__config__.title or model.__name__
+    else:
+        out_schema = {'type': 'object', 'properties': properties}
+        if required:
+            out_schema['required'] = required
+    if model.__config__.extra == 'forbid':
+        out_schema['additionalProperties'] = False
+    return out_schema, definitions, nested_models
+
+
+def enum_process_schema(enum: Type[Enum], *, field: Optional[ModelField] = None) -> Dict[str, Any]:
+    """
+    Take a single `enum` and generate its schema.
+
+    This is similar to the `model_process_schema` function, but applies to ``Enum`` objects.
+    """
+    schema_: Dict[str, Any] = {
+        'title': enum.__name__,
+        # Python assigns all enums a default docstring value of 'An enumeration', so
+        # all enums will have a description field even if not explicitly provided.
+        'description': enum.__doc__ or 'An enumeration.',
+        # Add enum values and the enum field type to the schema.
+        'enum': [item.value for item in cast(Iterable[Enum], enum)],
+    }
+
+    add_field_type_to_schema(enum, schema_)
+
+    modify_schema = getattr(enum, '__modify_schema__', None)
+    if modify_schema:
+        _apply_modify_schema(modify_schema, field, schema_)
+
+    return schema_
+
+
+def field_singleton_sub_fields_schema(
+    field: ModelField,
+    *,
+    by_alias: bool,
+    model_name_map: Dict[TypeModelOrEnum, str],
+    ref_template: str,
+    schema_overrides: bool = False,
+    ref_prefix: Optional[str] = None,
+    known_models: TypeModelSet,
+) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]:
+    """
+    This function is indirectly used by ``field_schema()``, you probably should be using that function.
+
+    Take a list of Pydantic ``ModelField`` from the declaration of a type with parameters, and generate their
+    schema. I.e., fields used as "type parameters", like ``str`` and ``int`` in ``Tuple[str, int]``.
+    """
+    sub_fields = cast(List[ModelField], field.sub_fields)
+    definitions = {}
+    nested_models: Set[str] = set()
+    if len(sub_fields) == 1:
+        return field_type_schema(
+            sub_fields[0],
+            by_alias=by_alias,
+            model_name_map=model_name_map,
+            schema_overrides=schema_overrides,
+            ref_prefix=ref_prefix,
+            ref_template=ref_template,
+            known_models=known_models,
+        )
+    else:
+        s: Dict[str, Any] = {}
+        # https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#discriminator-object
+        field_has_discriminator: bool = field.discriminator_key is not None
+        if field_has_discriminator:
+            assert field.sub_fields_mapping is not None
+
+            discriminator_models_refs: Dict[str, Union[str, Dict[str, Any]]] = {}
+
+            for discriminator_value, sub_field in field.sub_fields_mapping.items():
+                # sub_field is either a `BaseModel` or directly an `Annotated` `Union` of many
+                if is_union(get_origin(sub_field.type_)):
+                    sub_models = get_sub_types(sub_field.type_)
+                    discriminator_models_refs[discriminator_value] = {
+                        model_name_map[sub_model]: get_schema_ref(
+                            model_name_map[sub_model], ref_prefix, ref_template, False
+                        )
+                        for sub_model in sub_models
+                    }
+                else:
+                    sub_field_type = sub_field.type_
+                    if hasattr(sub_field_type, '__pydantic_model__'):
+                        sub_field_type = sub_field_type.__pydantic_model__
+
+                    discriminator_model_name = model_name_map[sub_field_type]
+                    discriminator_model_ref = get_schema_ref(discriminator_model_name, ref_prefix, ref_template, False)
+                    discriminator_models_refs[discriminator_value] = discriminator_model_ref['$ref']
+
+            s['discriminator'] = {
+                'propertyName': field.discriminator_alias,
+                'mapping': discriminator_models_refs,
+            }
+
+        sub_field_schemas = []
+        for sf in sub_fields:
+            sub_schema, sub_definitions, sub_nested_models = field_type_schema(
+                sf,
+                by_alias=by_alias,
+                model_name_map=model_name_map,
+                schema_overrides=schema_overrides,
+                ref_prefix=ref_prefix,
+                ref_template=ref_template,
+                known_models=known_models,
+            )
+            definitions.update(sub_definitions)
+            if schema_overrides and 'allOf' in sub_schema:
+                # if the sub_field is a referenced schema we only need the referenced
+                # object. Otherwise we will end up with several allOf inside anyOf/oneOf.
+                # See https://github.com/pydantic/pydantic/issues/1209
+                sub_schema = sub_schema['allOf'][0]
+
+            if sub_schema.keys() == {'discriminator', 'oneOf'}:
+                # we don't want discriminator information inside oneOf choices, this is dealt with elsewhere
+                sub_schema.pop('discriminator')
+            sub_field_schemas.append(sub_schema)
+            nested_models.update(sub_nested_models)
+        s['oneOf' if field_has_discriminator else 'anyOf'] = sub_field_schemas
+        return s, definitions, nested_models
+
+
+# Order is important, e.g. subclasses of str must go before str
+# this is used only for standard library types, custom types should use __modify_schema__ instead
+field_class_to_schema: Tuple[Tuple[Any, Dict[str, Any]], ...] = (
+    (Path, {'type': 'string', 'format': 'path'}),
+    (datetime, {'type': 'string', 'format': 'date-time'}),
+    (date, {'type': 'string', 'format': 'date'}),
+    (time, {'type': 'string', 'format': 'time'}),
+    (timedelta, {'type': 'number', 'format': 'time-delta'}),
+    (IPv4Network, {'type': 'string', 'format': 'ipv4network'}),
+    (IPv6Network, {'type': 'string', 'format': 'ipv6network'}),
+    (IPv4Interface, {'type': 'string', 'format': 'ipv4interface'}),
+    (IPv6Interface, {'type': 'string', 'format': 'ipv6interface'}),
+    (IPv4Address, {'type': 'string', 'format': 'ipv4'}),
+    (IPv6Address, {'type': 'string', 'format': 'ipv6'}),
+    (Pattern, {'type': 'string', 'format': 'regex'}),
+    (str, {'type': 'string'}),
+    (bytes, {'type': 'string', 'format': 'binary'}),
+    (bool, {'type': 'boolean'}),
+    (int, {'type': 'integer'}),
+    (float, {'type': 'number'}),
+    (Decimal, {'type': 'number'}),
+    (UUID, {'type': 'string', 'format': 'uuid'}),
+    (dict, {'type': 'object'}),
+    (list, {'type': 'array', 'items': {}}),
+    (tuple, {'type': 'array', 'items': {}}),
+    (set, {'type': 'array', 'items': {}, 'uniqueItems': True}),
+    (frozenset, {'type': 'array', 'items': {}, 'uniqueItems': True}),
+)
+
+json_scheme = {'type': 'string', 'format': 'json-string'}
+
+
+def add_field_type_to_schema(field_type: Any, schema_: Dict[str, Any]) -> None:
+    """
+    Update the given `schema` with the type-specific metadata for the given `field_type`.
+
+    This function looks through `field_class_to_schema` for a class that matches the given `field_type`,
+    and then modifies the given `schema` with the information from that type.
+    """
+    for type_, t_schema in field_class_to_schema:
+        # Fallback for `typing.Pattern` and `re.Pattern` as they are not a valid class
+        if lenient_issubclass(field_type, type_) or field_type is type_ is Pattern:
+            schema_.update(t_schema)
+            break
+
+
+def get_schema_ref(name: str, ref_prefix: Optional[str], ref_template: str, schema_overrides: bool) -> Dict[str, Any]:
+    if ref_prefix:
+        schema_ref = {'$ref': ref_prefix + name}
+    else:
+        schema_ref = {'$ref': ref_template.format(model=name)}
+    return {'allOf': [schema_ref]} if schema_overrides else schema_ref
+
+
+def field_singleton_schema(  # noqa: C901 (ignore complexity)
+    field: ModelField,
+    *,
+    by_alias: bool,
+    model_name_map: Dict[TypeModelOrEnum, str],
+    ref_template: str,
+    schema_overrides: bool = False,
+    ref_prefix: Optional[str] = None,
+    known_models: TypeModelSet,
+) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]:
+    """
+    This function is indirectly used by ``field_schema()``, you should probably be using that function.
+
+    Take a single Pydantic ``ModelField``, and return its schema and any additional definitions from sub-models.
+    """
+    from .main import BaseModel
+
+    definitions: Dict[str, Any] = {}
+    nested_models: Set[str] = set()
+    field_type = field.type_
+
+    # Recurse into this field if it contains sub_fields and is NOT a
+    # BaseModel OR that BaseModel is a const
+    if field.sub_fields and (
+        (field.field_info and field.field_info.const) or not lenient_issubclass(field_type, BaseModel)
+    ):
+        return field_singleton_sub_fields_schema(
+            field,
+            by_alias=by_alias,
+            model_name_map=model_name_map,
+            schema_overrides=schema_overrides,
+            ref_prefix=ref_prefix,
+            ref_template=ref_template,
+            known_models=known_models,
+        )
+    if field_type is Any or field_type is object or field_type.__class__ == TypeVar or get_origin(field_type) is type:
+        return {}, definitions, nested_models  # no restrictions
+    if is_none_type(field_type):
+        return {'type': 'null'}, definitions, nested_models
+    if is_callable_type(field_type):
+        raise SkipField(f'Callable {field.name} was excluded from schema since JSON schema has no equivalent type.')
+    f_schema: Dict[str, Any] = {}
+    if field.field_info is not None and field.field_info.const:
+        f_schema['const'] = field.default
+
+    if is_literal_type(field_type):
+        values = all_literal_values(field_type)
+
+        if len({v.__class__ for v in values}) > 1:
+            return field_schema(
+                multitypes_literal_field_for_schema(values, field),
+                by_alias=by_alias,
+                model_name_map=model_name_map,
+                ref_prefix=ref_prefix,
+                ref_template=ref_template,
+                known_models=known_models,
+            )
+
+        # All values have the same type
+        field_type = values[0].__class__
+        f_schema['enum'] = list(values)
+        add_field_type_to_schema(field_type, f_schema)
+    elif lenient_issubclass(field_type, Enum):
+        enum_name = model_name_map[field_type]
+        f_schema, schema_overrides = get_field_info_schema(field, schema_overrides)
+        f_schema.update(get_schema_ref(enum_name, ref_prefix, ref_template, schema_overrides))
+        definitions[enum_name] = enum_process_schema(field_type, field=field)
+    elif is_namedtuple(field_type):
+        sub_schema, *_ = model_process_schema(
+            field_type.__pydantic_model__,
+            by_alias=by_alias,
+            model_name_map=model_name_map,
+            ref_prefix=ref_prefix,
+            ref_template=ref_template,
+            known_models=known_models,
+            field=field,
+        )
+        items_schemas = list(sub_schema['properties'].values())
+        f_schema.update(
+            {
+                'type': 'array',
+                'items': items_schemas,
+                'minItems': len(items_schemas),
+                'maxItems': len(items_schemas),
+            }
+        )
+    elif not hasattr(field_type, '__pydantic_model__'):
+        add_field_type_to_schema(field_type, f_schema)
+
+        modify_schema = getattr(field_type, '__modify_schema__', None)
+        if modify_schema:
+            _apply_modify_schema(modify_schema, field, f_schema)
+
+    if f_schema:
+        return f_schema, definitions, nested_models
+
+    # Handle dataclass-based models
+    if lenient_issubclass(getattr(field_type, '__pydantic_model__', None), BaseModel):
+        field_type = field_type.__pydantic_model__
+
+    if issubclass(field_type, BaseModel):
+        model_name = model_name_map[field_type]
+        if field_type not in known_models:
+            sub_schema, sub_definitions, sub_nested_models = model_process_schema(
+                field_type,
+                by_alias=by_alias,
+                model_name_map=model_name_map,
+                ref_prefix=ref_prefix,
+                ref_template=ref_template,
+                known_models=known_models,
+                field=field,
+            )
+            definitions.update(sub_definitions)
+            definitions[model_name] = sub_schema
+            nested_models.update(sub_nested_models)
+        else:
+            nested_models.add(model_name)
+        schema_ref = get_schema_ref(model_name, ref_prefix, ref_template, schema_overrides)
+        return schema_ref, definitions, nested_models
+
+    # For generics with no args
+    args = get_args(field_type)
+    if args is not None and not args and Generic in field_type.__bases__:
+        return f_schema, definitions, nested_models
+
+    raise ValueError(f'Value not declarable with JSON Schema, field: {field}')
+
+
+def multitypes_literal_field_for_schema(values: Tuple[Any, ...], field: ModelField) -> ModelField:
+    """
+    To support `Literal` with values of different types, we split it into multiple `Literal` with same type
+    e.g. `Literal['qwe', 'asd', 1, 2]` becomes `Union[Literal['qwe', 'asd'], Literal[1, 2]]`
+    """
+    literal_distinct_types = defaultdict(list)
+    for v in values:
+        literal_distinct_types[v.__class__].append(v)
+    distinct_literals = (Literal[tuple(same_type_values)] for same_type_values in literal_distinct_types.values())
+
+    return ModelField(
+        name=field.name,
+        type_=Union[tuple(distinct_literals)],  # type: ignore
+        class_validators=field.class_validators,
+        model_config=field.model_config,
+        default=field.default,
+        required=field.required,
+        alias=field.alias,
+        field_info=field.field_info,
+    )
+
+
+def encode_default(dft: Any) -> Any:
+    if isinstance(dft, Enum):
+        return dft.value
+    elif isinstance(dft, (int, float, str)):
+        return dft
+    elif isinstance(dft, (list, tuple)):
+        t = dft.__class__
+        seq_args = (encode_default(v) for v in dft)
+        return t(*seq_args) if is_namedtuple(t) else t(seq_args)
+    elif isinstance(dft, dict):
+        return {encode_default(k): encode_default(v) for k, v in dft.items()}
+    elif dft is None:
+        return None
+    else:
+        return pydantic_encoder(dft)
+
+
+_map_types_constraint: Dict[Any, Callable[..., type]] = {int: conint, float: confloat, Decimal: condecimal}
+
+
+def get_annotation_from_field_info(
+    annotation: Any, field_info: FieldInfo, field_name: str, validate_assignment: bool = False
+) -> Type[Any]:
+    """
+    Get an annotation with validation implemented for numbers and strings based on the field_info.
+    :param annotation: an annotation from a field specification, as ``str``, ``ConstrainedStr``
+    :param field_info: an instance of FieldInfo, possibly with declarations for validations and JSON Schema
+    :param field_name: name of the field for use in error messages
+    :param validate_assignment: default False, flag for BaseModel Config value of validate_assignment
+    :return: the same ``annotation`` if unmodified or a new annotation with validation in place
+    """
+    constraints = field_info.get_constraints()
+    used_constraints: Set[str] = set()
+    if constraints:
+        annotation, used_constraints = get_annotation_with_constraints(annotation, field_info)
+    if validate_assignment:
+        used_constraints.add('allow_mutation')
+
+    unused_constraints = constraints - used_constraints
+    if unused_constraints:
+        raise ValueError(
+            f'On field "{field_name}" the following field constraints are set but not enforced: '
+            f'{", ".join(unused_constraints)}. '
+            f'\nFor more details see https://pydantic-docs.helpmanual.io/usage/schema/#unenforced-field-constraints'
+        )
+
+    return annotation
+
+
+def get_annotation_with_constraints(annotation: Any, field_info: FieldInfo) -> Tuple[Type[Any], Set[str]]:  # noqa: C901
+    """
+    Get an annotation with used constraints implemented for numbers and strings based on the field_info.
+
+    :param annotation: an annotation from a field specification, as ``str``, ``ConstrainedStr``
+    :param field_info: an instance of FieldInfo, possibly with declarations for validations and JSON Schema
+    :return: the same ``annotation`` if unmodified or a new annotation along with the used constraints.
+    """
+    used_constraints: Set[str] = set()
+
+    def go(type_: Any) -> Type[Any]:
+        if (
+            is_literal_type(type_)
+            or isinstance(type_, ForwardRef)
+            or lenient_issubclass(type_, (ConstrainedList, ConstrainedSet, ConstrainedFrozenSet))
+        ):
+            return type_
+        origin = get_origin(type_)
+        if origin is not None:
+            args: Tuple[Any, ...] = get_args(type_)
+            if any(isinstance(a, ForwardRef) for a in args):
+                # forward refs cause infinite recursion below
+                return type_
+
+            if origin is Annotated:
+                return go(args[0])
+            if is_union(origin):
+                return Union[tuple(go(a) for a in args)]  # type: ignore
+
+            if issubclass(origin, List) and (
+                field_info.min_items is not None
+                or field_info.max_items is not None
+                or field_info.unique_items is not None
+            ):
+                used_constraints.update({'min_items', 'max_items', 'unique_items'})
+                return conlist(
+                    go(args[0]),
+                    min_items=field_info.min_items,
+                    max_items=field_info.max_items,
+                    unique_items=field_info.unique_items,
+                )
+
+            if issubclass(origin, Set) and (field_info.min_items is not None or field_info.max_items is not None):
+                used_constraints.update({'min_items', 'max_items'})
+                return conset(go(args[0]), min_items=field_info.min_items, max_items=field_info.max_items)
+
+            if issubclass(origin, FrozenSet) and (field_info.min_items is not None or field_info.max_items is not None):
+                used_constraints.update({'min_items', 'max_items'})
+                return confrozenset(go(args[0]), min_items=field_info.min_items, max_items=field_info.max_items)
+
+            for t in (Tuple, List, Set, FrozenSet, Sequence):
+                if issubclass(origin, t):  # type: ignore
+                    return t[tuple(go(a) for a in args)]  # type: ignore
+
+            if issubclass(origin, Dict):
+                return Dict[args[0], go(args[1])]  # type: ignore
+
+        attrs: Optional[Tuple[str, ...]] = None
+        constraint_func: Optional[Callable[..., type]] = None
+        if isinstance(type_, type):
+            if issubclass(type_, (SecretStr, SecretBytes)):
+                attrs = ('max_length', 'min_length')
+
+                def constraint_func(**kw: Any) -> Type[Any]:
+                    return type(type_.__name__, (type_,), kw)
+
+            elif issubclass(type_, str) and not issubclass(type_, (EmailStr, AnyUrl)):
+                attrs = ('max_length', 'min_length', 'regex')
+                if issubclass(type_, StrictStr):
+
+                    def constraint_func(**kw: Any) -> Type[Any]:
+                        return type(type_.__name__, (type_,), kw)
+
+                else:
+                    constraint_func = constr
+            elif issubclass(type_, bytes):
+                attrs = ('max_length', 'min_length', 'regex')
+                if issubclass(type_, StrictBytes):
+
+                    def constraint_func(**kw: Any) -> Type[Any]:
+                        return type(type_.__name__, (type_,), kw)
+
+                else:
+                    constraint_func = conbytes
+            elif issubclass(type_, numeric_types) and not issubclass(
+                type_,
+                (
+                    ConstrainedInt,
+                    ConstrainedFloat,
+                    ConstrainedDecimal,
+                    ConstrainedList,
+                    ConstrainedSet,
+                    ConstrainedFrozenSet,
+                    bool,
+                ),
+            ):
+                # Is numeric type
+                attrs = ('gt', 'lt', 'ge', 'le', 'multiple_of')
+                if issubclass(type_, float):
+                    attrs += ('allow_inf_nan',)
+                if issubclass(type_, Decimal):
+                    attrs += ('max_digits', 'decimal_places')
+                numeric_type = next(t for t in numeric_types if issubclass(type_, t))  # pragma: no branch
+                constraint_func = _map_types_constraint[numeric_type]
+
+        if attrs:
+            used_constraints.update(set(attrs))
+            kwargs = {
+                attr_name: attr
+                for attr_name, attr in ((attr_name, getattr(field_info, attr_name)) for attr_name in attrs)
+                if attr is not None
+            }
+            if kwargs:
+                constraint_func = cast(Callable[..., type], constraint_func)
+                return constraint_func(**kwargs)
+        return type_
+
+    return go(annotation), used_constraints
+
+
+def normalize_name(name: str) -> str:
+    """
+    Normalizes the given name. This can be applied to either a model *or* enum.
+    """
+    return re.sub(r'[^a-zA-Z0-9.\-_]', '_', name)
+
+
+class SkipField(Exception):
+    """
+    Utility exception used to exclude fields from schema.
+    """
+
+    def __init__(self, message: str) -> None:
+        self.message = message
diff --git a/lib/pydantic/tools.py b/lib/pydantic/tools.py
new file mode 100644
index 00000000..9cdb4538
--- /dev/null
+++ b/lib/pydantic/tools.py
@@ -0,0 +1,92 @@
+import json
+from functools import lru_cache
+from pathlib import Path
+from typing import TYPE_CHECKING, Any, Callable, Optional, Type, TypeVar, Union
+
+from .parse import Protocol, load_file, load_str_bytes
+from .types import StrBytes
+from .typing import display_as_type
+
+__all__ = ('parse_file_as', 'parse_obj_as', 'parse_raw_as', 'schema_of', 'schema_json_of')
+
+NameFactory = Union[str, Callable[[Type[Any]], str]]
+
+if TYPE_CHECKING:
+    from .typing import DictStrAny
+
+
+def _generate_parsing_type_name(type_: Any) -> str:
+    return f'ParsingModel[{display_as_type(type_)}]'
+
+
+@lru_cache(maxsize=2048)
+def _get_parsing_type(type_: Any, *, type_name: Optional[NameFactory] = None) -> Any:
+    from pydantic.main import create_model
+
+    if type_name is None:
+        type_name = _generate_parsing_type_name
+    if not isinstance(type_name, str):
+        type_name = type_name(type_)
+    return create_model(type_name, __root__=(type_, ...))
+
+
+T = TypeVar('T')
+
+
+def parse_obj_as(type_: Type[T], obj: Any, *, type_name: Optional[NameFactory] = None) -> T:
+    model_type = _get_parsing_type(type_, type_name=type_name)  # type: ignore[arg-type]
+    return model_type(__root__=obj).__root__
+
+
+def parse_file_as(
+    type_: Type[T],
+    path: Union[str, Path],
+    *,
+    content_type: str = None,
+    encoding: str = 'utf8',
+    proto: Protocol = None,
+    allow_pickle: bool = False,
+    json_loads: Callable[[str], Any] = json.loads,
+    type_name: Optional[NameFactory] = None,
+) -> T:
+    obj = load_file(
+        path,
+        proto=proto,
+        content_type=content_type,
+        encoding=encoding,
+        allow_pickle=allow_pickle,
+        json_loads=json_loads,
+    )
+    return parse_obj_as(type_, obj, type_name=type_name)
+
+
+def parse_raw_as(
+    type_: Type[T],
+    b: StrBytes,
+    *,
+    content_type: str = None,
+    encoding: str = 'utf8',
+    proto: Protocol = None,
+    allow_pickle: bool = False,
+    json_loads: Callable[[str], Any] = json.loads,
+    type_name: Optional[NameFactory] = None,
+) -> T:
+    obj = load_str_bytes(
+        b,
+        proto=proto,
+        content_type=content_type,
+        encoding=encoding,
+        allow_pickle=allow_pickle,
+        json_loads=json_loads,
+    )
+    return parse_obj_as(type_, obj, type_name=type_name)
+
+
+def schema_of(type_: Any, *, title: Optional[NameFactory] = None, **schema_kwargs: Any) -> 'DictStrAny':
+    """Generate a JSON schema (as dict) for the passed model or dynamically generated one"""
+    return _get_parsing_type(type_, type_name=title).schema(**schema_kwargs)
+
+
+def schema_json_of(type_: Any, *, title: Optional[NameFactory] = None, **schema_json_kwargs: Any) -> str:
+    """Generate a JSON schema (as JSON) for the passed model or dynamically generated one"""
+    return _get_parsing_type(type_, type_name=title).schema_json(**schema_json_kwargs)
diff --git a/lib/pydantic/types.py b/lib/pydantic/types.py
new file mode 100644
index 00000000..f98dba3d
--- /dev/null
+++ b/lib/pydantic/types.py
@@ -0,0 +1,1187 @@
+import abc
+import math
+import re
+import warnings
+from datetime import date
+from decimal import Decimal
+from enum import Enum
+from pathlib import Path
+from types import new_class
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    ClassVar,
+    Dict,
+    FrozenSet,
+    List,
+    Optional,
+    Pattern,
+    Set,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+    cast,
+    overload,
+)
+from uuid import UUID
+from weakref import WeakSet
+
+from . import errors
+from .datetime_parse import parse_date
+from .utils import import_string, update_not_none
+from .validators import (
+    bytes_validator,
+    constr_length_validator,
+    constr_lower,
+    constr_strip_whitespace,
+    constr_upper,
+    decimal_validator,
+    float_finite_validator,
+    float_validator,
+    frozenset_validator,
+    int_validator,
+    list_validator,
+    number_multiple_validator,
+    number_size_validator,
+    path_exists_validator,
+    path_validator,
+    set_validator,
+    str_validator,
+    strict_bytes_validator,
+    strict_float_validator,
+    strict_int_validator,
+    strict_str_validator,
+)
+
+__all__ = [
+    'NoneStr',
+    'NoneBytes',
+    'StrBytes',
+    'NoneStrBytes',
+    'StrictStr',
+    'ConstrainedBytes',
+    'conbytes',
+    'ConstrainedList',
+    'conlist',
+    'ConstrainedSet',
+    'conset',
+    'ConstrainedFrozenSet',
+    'confrozenset',
+    'ConstrainedStr',
+    'constr',
+    'PyObject',
+    'ConstrainedInt',
+    'conint',
+    'PositiveInt',
+    'NegativeInt',
+    'NonNegativeInt',
+    'NonPositiveInt',
+    'ConstrainedFloat',
+    'confloat',
+    'PositiveFloat',
+    'NegativeFloat',
+    'NonNegativeFloat',
+    'NonPositiveFloat',
+    'FiniteFloat',
+    'ConstrainedDecimal',
+    'condecimal',
+    'UUID1',
+    'UUID3',
+    'UUID4',
+    'UUID5',
+    'FilePath',
+    'DirectoryPath',
+    'Json',
+    'JsonWrapper',
+    'SecretField',
+    'SecretStr',
+    'SecretBytes',
+    'StrictBool',
+    'StrictBytes',
+    'StrictInt',
+    'StrictFloat',
+    'PaymentCardNumber',
+    'ByteSize',
+    'PastDate',
+    'FutureDate',
+    'ConstrainedDate',
+    'condate',
+]
+
+NoneStr = Optional[str]
+NoneBytes = Optional[bytes]
+StrBytes = Union[str, bytes]
+NoneStrBytes = Optional[StrBytes]
+OptionalInt = Optional[int]
+OptionalIntFloat = Union[OptionalInt, float]
+OptionalIntFloatDecimal = Union[OptionalIntFloat, Decimal]
+OptionalDate = Optional[date]
+StrIntFloat = Union[str, int, float]
+
+if TYPE_CHECKING:
+    from typing_extensions import Annotated
+
+    from .dataclasses import Dataclass
+    from .main import BaseModel
+    from .typing import CallableGenerator
+
+    ModelOrDc = Type[Union[BaseModel, Dataclass]]
+
+T = TypeVar('T')
+_DEFINED_TYPES: 'WeakSet[type]' = WeakSet()
+
+
+@overload
+def _registered(typ: Type[T]) -> Type[T]:
+    pass
+
+
+@overload
+def _registered(typ: 'ConstrainedNumberMeta') -> 'ConstrainedNumberMeta':
+    pass
+
+
+def _registered(typ: Union[Type[T], 'ConstrainedNumberMeta']) -> Union[Type[T], 'ConstrainedNumberMeta']:
+    # In order to generate valid examples of constrained types, Hypothesis needs
+    # to inspect the type object - so we keep a weakref to each contype object
+    # until it can be registered.  When (or if) our Hypothesis plugin is loaded,
+    # it monkeypatches this function.
+    # If Hypothesis is never used, the total effect is to keep a weak reference
+    # which has minimal memory usage and doesn't even affect garbage collection.
+    _DEFINED_TYPES.add(typ)
+    return typ
+
+
+class ConstrainedNumberMeta(type):
+    def __new__(cls, name: str, bases: Any, dct: Dict[str, Any]) -> 'ConstrainedInt':  # type: ignore
+        new_cls = cast('ConstrainedInt', type.__new__(cls, name, bases, dct))
+
+        if new_cls.gt is not None and new_cls.ge is not None:
+            raise errors.ConfigError('bounds gt and ge cannot be specified at the same time')
+        if new_cls.lt is not None and new_cls.le is not None:
+            raise errors.ConfigError('bounds lt and le cannot be specified at the same time')
+
+        return _registered(new_cls)  # type: ignore
+
+
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ BOOLEAN TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+if TYPE_CHECKING:
+    StrictBool = bool
+else:
+
+    class StrictBool(int):
+        """
+        StrictBool to allow for bools which are not type-coerced.
+        """
+
+        @classmethod
+        def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+            field_schema.update(type='boolean')
+
+        @classmethod
+        def __get_validators__(cls) -> 'CallableGenerator':
+            yield cls.validate
+
+        @classmethod
+        def validate(cls, value: Any) -> bool:
+            """
+            Ensure that we only allow bools.
+            """
+            if isinstance(value, bool):
+                return value
+
+            raise errors.StrictBoolError()
+
+
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ INTEGER TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+
+class ConstrainedInt(int, metaclass=ConstrainedNumberMeta):
+    strict: bool = False
+    gt: OptionalInt = None
+    ge: OptionalInt = None
+    lt: OptionalInt = None
+    le: OptionalInt = None
+    multiple_of: OptionalInt = None
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        update_not_none(
+            field_schema,
+            exclusiveMinimum=cls.gt,
+            exclusiveMaximum=cls.lt,
+            minimum=cls.ge,
+            maximum=cls.le,
+            multipleOf=cls.multiple_of,
+        )
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield strict_int_validator if cls.strict else int_validator
+        yield number_size_validator
+        yield number_multiple_validator
+
+
+def conint(
+    *, strict: bool = False, gt: int = None, ge: int = None, lt: int = None, le: int = None, multiple_of: int = None
+) -> Type[int]:
+    # use kwargs then define conf in a dict to aid with IDE type hinting
+    namespace = dict(strict=strict, gt=gt, ge=ge, lt=lt, le=le, multiple_of=multiple_of)
+    return type('ConstrainedIntValue', (ConstrainedInt,), namespace)
+
+
+if TYPE_CHECKING:
+    PositiveInt = int
+    NegativeInt = int
+    NonPositiveInt = int
+    NonNegativeInt = int
+    StrictInt = int
+else:
+
+    class PositiveInt(ConstrainedInt):
+        gt = 0
+
+    class NegativeInt(ConstrainedInt):
+        lt = 0
+
+    class NonPositiveInt(ConstrainedInt):
+        le = 0
+
+    class NonNegativeInt(ConstrainedInt):
+        ge = 0
+
+    class StrictInt(ConstrainedInt):
+        strict = True
+
+
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ FLOAT TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+
+class ConstrainedFloat(float, metaclass=ConstrainedNumberMeta):
+    strict: bool = False
+    gt: OptionalIntFloat = None
+    ge: OptionalIntFloat = None
+    lt: OptionalIntFloat = None
+    le: OptionalIntFloat = None
+    multiple_of: OptionalIntFloat = None
+    allow_inf_nan: Optional[bool] = None
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        update_not_none(
+            field_schema,
+            exclusiveMinimum=cls.gt,
+            exclusiveMaximum=cls.lt,
+            minimum=cls.ge,
+            maximum=cls.le,
+            multipleOf=cls.multiple_of,
+        )
+        # Modify constraints to account for differences between IEEE floats and JSON
+        if field_schema.get('exclusiveMinimum') == -math.inf:
+            del field_schema['exclusiveMinimum']
+        if field_schema.get('minimum') == -math.inf:
+            del field_schema['minimum']
+        if field_schema.get('exclusiveMaximum') == math.inf:
+            del field_schema['exclusiveMaximum']
+        if field_schema.get('maximum') == math.inf:
+            del field_schema['maximum']
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield strict_float_validator if cls.strict else float_validator
+        yield number_size_validator
+        yield number_multiple_validator
+        yield float_finite_validator
+
+
+def confloat(
+    *,
+    strict: bool = False,
+    gt: float = None,
+    ge: float = None,
+    lt: float = None,
+    le: float = None,
+    multiple_of: float = None,
+    allow_inf_nan: Optional[bool] = None,
+) -> Type[float]:
+    # use kwargs then define conf in a dict to aid with IDE type hinting
+    namespace = dict(strict=strict, gt=gt, ge=ge, lt=lt, le=le, multiple_of=multiple_of, allow_inf_nan=allow_inf_nan)
+    return type('ConstrainedFloatValue', (ConstrainedFloat,), namespace)
+
+
+if TYPE_CHECKING:
+    PositiveFloat = float
+    NegativeFloat = float
+    NonPositiveFloat = float
+    NonNegativeFloat = float
+    StrictFloat = float
+    FiniteFloat = float
+else:
+
+    class PositiveFloat(ConstrainedFloat):
+        gt = 0
+
+    class NegativeFloat(ConstrainedFloat):
+        lt = 0
+
+    class NonPositiveFloat(ConstrainedFloat):
+        le = 0
+
+    class NonNegativeFloat(ConstrainedFloat):
+        ge = 0
+
+    class StrictFloat(ConstrainedFloat):
+        strict = True
+
+    class FiniteFloat(ConstrainedFloat):
+        allow_inf_nan = False
+
+
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ BYTES TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+
+class ConstrainedBytes(bytes):
+    strip_whitespace = False
+    to_upper = False
+    to_lower = False
+    min_length: OptionalInt = None
+    max_length: OptionalInt = None
+    strict: bool = False
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        update_not_none(field_schema, minLength=cls.min_length, maxLength=cls.max_length)
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield strict_bytes_validator if cls.strict else bytes_validator
+        yield constr_strip_whitespace
+        yield constr_upper
+        yield constr_lower
+        yield constr_length_validator
+
+
+def conbytes(
+    *,
+    strip_whitespace: bool = False,
+    to_upper: bool = False,
+    to_lower: bool = False,
+    min_length: int = None,
+    max_length: int = None,
+    strict: bool = False,
+) -> Type[bytes]:
+    # use kwargs then define conf in a dict to aid with IDE type hinting
+    namespace = dict(
+        strip_whitespace=strip_whitespace,
+        to_upper=to_upper,
+        to_lower=to_lower,
+        min_length=min_length,
+        max_length=max_length,
+        strict=strict,
+    )
+    return _registered(type('ConstrainedBytesValue', (ConstrainedBytes,), namespace))
+
+
+if TYPE_CHECKING:
+    StrictBytes = bytes
+else:
+
+    class StrictBytes(ConstrainedBytes):
+        strict = True
+
+
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ STRING TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+
+class ConstrainedStr(str):
+    strip_whitespace = False
+    to_upper = False
+    to_lower = False
+    min_length: OptionalInt = None
+    max_length: OptionalInt = None
+    curtail_length: OptionalInt = None
+    regex: Optional[Pattern[str]] = None
+    strict = False
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        update_not_none(
+            field_schema,
+            minLength=cls.min_length,
+            maxLength=cls.max_length,
+            pattern=cls.regex and cls.regex.pattern,
+        )
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield strict_str_validator if cls.strict else str_validator
+        yield constr_strip_whitespace
+        yield constr_upper
+        yield constr_lower
+        yield constr_length_validator
+        yield cls.validate
+
+    @classmethod
+    def validate(cls, value: Union[str]) -> Union[str]:
+        if cls.curtail_length and len(value) > cls.curtail_length:
+            value = value[: cls.curtail_length]
+
+        if cls.regex:
+            if not cls.regex.match(value):
+                raise errors.StrRegexError(pattern=cls.regex.pattern)
+
+        return value
+
+
+def constr(
+    *,
+    strip_whitespace: bool = False,
+    to_upper: bool = False,
+    to_lower: bool = False,
+    strict: bool = False,
+    min_length: int = None,
+    max_length: int = None,
+    curtail_length: int = None,
+    regex: str = None,
+) -> Type[str]:
+    # use kwargs then define conf in a dict to aid with IDE type hinting
+    namespace = dict(
+        strip_whitespace=strip_whitespace,
+        to_upper=to_upper,
+        to_lower=to_lower,
+        strict=strict,
+        min_length=min_length,
+        max_length=max_length,
+        curtail_length=curtail_length,
+        regex=regex and re.compile(regex),
+    )
+    return _registered(type('ConstrainedStrValue', (ConstrainedStr,), namespace))
+
+
+if TYPE_CHECKING:
+    StrictStr = str
+else:
+
+    class StrictStr(ConstrainedStr):
+        strict = True
+
+
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ SET TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+# This types superclass should be Set[T], but cython chokes on that...
+class ConstrainedSet(set):  # type: ignore
+    # Needed for pydantic to detect that this is a set
+    __origin__ = set
+    __args__: Set[Type[T]]  # type: ignore
+
+    min_items: Optional[int] = None
+    max_items: Optional[int] = None
+    item_type: Type[T]  # type: ignore
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield cls.set_length_validator
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        update_not_none(field_schema, minItems=cls.min_items, maxItems=cls.max_items)
+
+    @classmethod
+    def set_length_validator(cls, v: 'Optional[Set[T]]') -> 'Optional[Set[T]]':
+        if v is None:
+            return None
+
+        v = set_validator(v)
+        v_len = len(v)
+
+        if cls.min_items is not None and v_len < cls.min_items:
+            raise errors.SetMinLengthError(limit_value=cls.min_items)
+
+        if cls.max_items is not None and v_len > cls.max_items:
+            raise errors.SetMaxLengthError(limit_value=cls.max_items)
+
+        return v
+
+
+def conset(item_type: Type[T], *, min_items: int = None, max_items: int = None) -> Type[Set[T]]:
+    # __args__ is needed to conform to typing generics api
+    namespace = {'min_items': min_items, 'max_items': max_items, 'item_type': item_type, '__args__': [item_type]}
+    # We use new_class to be able to deal with Generic types
+    return new_class('ConstrainedSetValue', (ConstrainedSet,), {}, lambda ns: ns.update(namespace))
+
+
+# This types superclass should be FrozenSet[T], but cython chokes on that...
+class ConstrainedFrozenSet(frozenset):  # type: ignore
+    # Needed for pydantic to detect that this is a set
+    __origin__ = frozenset
+    __args__: FrozenSet[Type[T]]  # type: ignore
+
+    min_items: Optional[int] = None
+    max_items: Optional[int] = None
+    item_type: Type[T]  # type: ignore
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield cls.frozenset_length_validator
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        update_not_none(field_schema, minItems=cls.min_items, maxItems=cls.max_items)
+
+    @classmethod
+    def frozenset_length_validator(cls, v: 'Optional[FrozenSet[T]]') -> 'Optional[FrozenSet[T]]':
+        if v is None:
+            return None
+
+        v = frozenset_validator(v)
+        v_len = len(v)
+
+        if cls.min_items is not None and v_len < cls.min_items:
+            raise errors.FrozenSetMinLengthError(limit_value=cls.min_items)
+
+        if cls.max_items is not None and v_len > cls.max_items:
+            raise errors.FrozenSetMaxLengthError(limit_value=cls.max_items)
+
+        return v
+
+
+def confrozenset(item_type: Type[T], *, min_items: int = None, max_items: int = None) -> Type[FrozenSet[T]]:
+    # __args__ is needed to conform to typing generics api
+    namespace = {'min_items': min_items, 'max_items': max_items, 'item_type': item_type, '__args__': [item_type]}
+    # We use new_class to be able to deal with Generic types
+    return new_class('ConstrainedFrozenSetValue', (ConstrainedFrozenSet,), {}, lambda ns: ns.update(namespace))
+
+
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ LIST TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+# This types superclass should be List[T], but cython chokes on that...
+class ConstrainedList(list):  # type: ignore
+    # Needed for pydantic to detect that this is a list
+    __origin__ = list
+    __args__: Tuple[Type[T], ...]  # type: ignore
+
+    min_items: Optional[int] = None
+    max_items: Optional[int] = None
+    unique_items: Optional[bool] = None
+    item_type: Type[T]  # type: ignore
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield cls.list_length_validator
+        if cls.unique_items:
+            yield cls.unique_items_validator
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        update_not_none(field_schema, minItems=cls.min_items, maxItems=cls.max_items, uniqueItems=cls.unique_items)
+
+    @classmethod
+    def list_length_validator(cls, v: 'Optional[List[T]]') -> 'Optional[List[T]]':
+        if v is None:
+            return None
+
+        v = list_validator(v)
+        v_len = len(v)
+
+        if cls.min_items is not None and v_len < cls.min_items:
+            raise errors.ListMinLengthError(limit_value=cls.min_items)
+
+        if cls.max_items is not None and v_len > cls.max_items:
+            raise errors.ListMaxLengthError(limit_value=cls.max_items)
+
+        return v
+
+    @classmethod
+    def unique_items_validator(cls, v: 'List[T]') -> 'List[T]':
+        for i, value in enumerate(v, start=1):
+            if value in v[i:]:
+                raise errors.ListUniqueItemsError()
+
+        return v
+
+
+def conlist(
+    item_type: Type[T], *, min_items: int = None, max_items: int = None, unique_items: bool = None
+) -> Type[List[T]]:
+    # __args__ is needed to conform to typing generics api
+    namespace = dict(
+        min_items=min_items, max_items=max_items, unique_items=unique_items, item_type=item_type, __args__=(item_type,)
+    )
+    # We use new_class to be able to deal with Generic types
+    return new_class('ConstrainedListValue', (ConstrainedList,), {}, lambda ns: ns.update(namespace))
+
+
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ PYOBJECT TYPE ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+
+if TYPE_CHECKING:
+    PyObject = Callable[..., Any]
+else:
+
+    class PyObject:
+        validate_always = True
+
+        @classmethod
+        def __get_validators__(cls) -> 'CallableGenerator':
+            yield cls.validate
+
+        @classmethod
+        def validate(cls, value: Any) -> Any:
+            if isinstance(value, Callable):
+                return value
+
+            try:
+                value = str_validator(value)
+            except errors.StrError:
+                raise errors.PyObjectError(error_message='value is neither a valid import path not a valid callable')
+
+            try:
+                return import_string(value)
+            except ImportError as e:
+                raise errors.PyObjectError(error_message=str(e))
+
+
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ DECIMAL TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+
+class ConstrainedDecimal(Decimal, metaclass=ConstrainedNumberMeta):
+    gt: OptionalIntFloatDecimal = None
+    ge: OptionalIntFloatDecimal = None
+    lt: OptionalIntFloatDecimal = None
+    le: OptionalIntFloatDecimal = None
+    max_digits: OptionalInt = None
+    decimal_places: OptionalInt = None
+    multiple_of: OptionalIntFloatDecimal = None
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        update_not_none(
+            field_schema,
+            exclusiveMinimum=cls.gt,
+            exclusiveMaximum=cls.lt,
+            minimum=cls.ge,
+            maximum=cls.le,
+            multipleOf=cls.multiple_of,
+        )
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield decimal_validator
+        yield number_size_validator
+        yield number_multiple_validator
+        yield cls.validate
+
+    @classmethod
+    def validate(cls, value: Decimal) -> Decimal:
+        digit_tuple, exponent = value.as_tuple()[1:]
+        if exponent in {'F', 'n', 'N'}:
+            raise errors.DecimalIsNotFiniteError()
+
+        if exponent >= 0:
+            # A positive exponent adds that many trailing zeros.
+            digits = len(digit_tuple) + exponent
+            decimals = 0
+        else:
+            # If the absolute value of the negative exponent is larger than the
+            # number of digits, then it's the same as the number of digits,
+            # because it'll consume all of the digits in digit_tuple and then
+            # add abs(exponent) - len(digit_tuple) leading zeros after the
+            # decimal point.
+            if abs(exponent) > len(digit_tuple):
+                digits = decimals = abs(exponent)
+            else:
+                digits = len(digit_tuple)
+                decimals = abs(exponent)
+        whole_digits = digits - decimals
+
+        if cls.max_digits is not None and digits > cls.max_digits:
+            raise errors.DecimalMaxDigitsError(max_digits=cls.max_digits)
+
+        if cls.decimal_places is not None and decimals > cls.decimal_places:
+            raise errors.DecimalMaxPlacesError(decimal_places=cls.decimal_places)
+
+        if cls.max_digits is not None and cls.decimal_places is not None:
+            expected = cls.max_digits - cls.decimal_places
+            if whole_digits > expected:
+                raise errors.DecimalWholeDigitsError(whole_digits=expected)
+
+        return value
+
+
+def condecimal(
+    *,
+    gt: Decimal = None,
+    ge: Decimal = None,
+    lt: Decimal = None,
+    le: Decimal = None,
+    max_digits: int = None,
+    decimal_places: int = None,
+    multiple_of: Decimal = None,
+) -> Type[Decimal]:
+    # use kwargs then define conf in a dict to aid with IDE type hinting
+    namespace = dict(
+        gt=gt, ge=ge, lt=lt, le=le, max_digits=max_digits, decimal_places=decimal_places, multiple_of=multiple_of
+    )
+    return type('ConstrainedDecimalValue', (ConstrainedDecimal,), namespace)
+
+
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ UUID TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+if TYPE_CHECKING:
+    UUID1 = UUID
+    UUID3 = UUID
+    UUID4 = UUID
+    UUID5 = UUID
+else:
+
+    class UUID1(UUID):
+        _required_version = 1
+
+        @classmethod
+        def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+            field_schema.update(type='string', format=f'uuid{cls._required_version}')
+
+    class UUID3(UUID1):
+        _required_version = 3
+
+    class UUID4(UUID1):
+        _required_version = 4
+
+    class UUID5(UUID1):
+        _required_version = 5
+
+
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ PATH TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+if TYPE_CHECKING:
+    FilePath = Path
+    DirectoryPath = Path
+else:
+
+    class FilePath(Path):
+        @classmethod
+        def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+            field_schema.update(format='file-path')
+
+        @classmethod
+        def __get_validators__(cls) -> 'CallableGenerator':
+            yield path_validator
+            yield path_exists_validator
+            yield cls.validate
+
+        @classmethod
+        def validate(cls, value: Path) -> Path:
+            if not value.is_file():
+                raise errors.PathNotAFileError(path=value)
+
+            return value
+
+    class DirectoryPath(Path):
+        @classmethod
+        def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+            field_schema.update(format='directory-path')
+
+        @classmethod
+        def __get_validators__(cls) -> 'CallableGenerator':
+            yield path_validator
+            yield path_exists_validator
+            yield cls.validate
+
+        @classmethod
+        def validate(cls, value: Path) -> Path:
+            if not value.is_dir():
+                raise errors.PathNotADirectoryError(path=value)
+
+            return value
+
+
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ JSON TYPE ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+
+class JsonWrapper:
+    pass
+
+
+class JsonMeta(type):
+    def __getitem__(self, t: Type[Any]) -> Type[JsonWrapper]:
+        if t is Any:
+            return Json  # allow Json[Any] to replecate plain Json
+        return _registered(type('JsonWrapperValue', (JsonWrapper,), {'inner_type': t}))
+
+
+if TYPE_CHECKING:
+    Json = Annotated[T, ...]  # Json[list[str]] will be recognized by type checkers as list[str]
+
+else:
+
+    class Json(metaclass=JsonMeta):
+        @classmethod
+        def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+            field_schema.update(type='string', format='json-string')
+
+
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ SECRET TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+
+class SecretField(abc.ABC):
+    """
+    Note: this should be implemented as a generic like `SecretField(ABC, Generic[T])`,
+          the `__init__()` should be part of the abstract class and the
+          `get_secret_value()` method should use the generic `T` type.
+
+          However Cython doesn't support very well generics at the moment and
+          the generated code fails to be imported (see
+          https://github.com/cython/cython/issues/2753).
+    """
+
+    def __eq__(self, other: Any) -> bool:
+        return isinstance(other, self.__class__) and self.get_secret_value() == other.get_secret_value()
+
+    def __str__(self) -> str:
+        return '**********' if self.get_secret_value() else ''
+
+    def __hash__(self) -> int:
+        return hash(self.get_secret_value())
+
+    @abc.abstractmethod
+    def get_secret_value(self) -> Any:  # pragma: no cover
+        ...
+
+
+class SecretStr(SecretField):
+    min_length: OptionalInt = None
+    max_length: OptionalInt = None
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        update_not_none(
+            field_schema,
+            type='string',
+            writeOnly=True,
+            format='password',
+            minLength=cls.min_length,
+            maxLength=cls.max_length,
+        )
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield cls.validate
+        yield constr_length_validator
+
+    @classmethod
+    def validate(cls, value: Any) -> 'SecretStr':
+        if isinstance(value, cls):
+            return value
+        value = str_validator(value)
+        return cls(value)
+
+    def __init__(self, value: str):
+        self._secret_value = value
+
+    def __repr__(self) -> str:
+        return f"SecretStr('{self}')"
+
+    def __len__(self) -> int:
+        return len(self._secret_value)
+
+    def display(self) -> str:
+        warnings.warn('`secret_str.display()` is deprecated, use `str(secret_str)` instead', DeprecationWarning)
+        return str(self)
+
+    def get_secret_value(self) -> str:
+        return self._secret_value
+
+
+class SecretBytes(SecretField):
+    min_length: OptionalInt = None
+    max_length: OptionalInt = None
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        update_not_none(
+            field_schema,
+            type='string',
+            writeOnly=True,
+            format='password',
+            minLength=cls.min_length,
+            maxLength=cls.max_length,
+        )
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield cls.validate
+        yield constr_length_validator
+
+    @classmethod
+    def validate(cls, value: Any) -> 'SecretBytes':
+        if isinstance(value, cls):
+            return value
+        value = bytes_validator(value)
+        return cls(value)
+
+    def __init__(self, value: bytes):
+        self._secret_value = value
+
+    def __repr__(self) -> str:
+        return f"SecretBytes(b'{self}')"
+
+    def __len__(self) -> int:
+        return len(self._secret_value)
+
+    def display(self) -> str:
+        warnings.warn('`secret_bytes.display()` is deprecated, use `str(secret_bytes)` instead', DeprecationWarning)
+        return str(self)
+
+    def get_secret_value(self) -> bytes:
+        return self._secret_value
+
+
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ PAYMENT CARD TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+
+class PaymentCardBrand(str, Enum):
+    # If you add another card type, please also add it to the
+    # Hypothesis strategy in `pydantic._hypothesis_plugin`.
+    amex = 'American Express'
+    mastercard = 'Mastercard'
+    visa = 'Visa'
+    other = 'other'
+
+    def __str__(self) -> str:
+        return self.value
+
+
+class PaymentCardNumber(str):
+    """
+    Based on: https://en.wikipedia.org/wiki/Payment_card_number
+    """
+
+    strip_whitespace: ClassVar[bool] = True
+    min_length: ClassVar[int] = 12
+    max_length: ClassVar[int] = 19
+    bin: str
+    last4: str
+    brand: PaymentCardBrand
+
+    def __init__(self, card_number: str):
+        self.bin = card_number[:6]
+        self.last4 = card_number[-4:]
+        self.brand = self._get_brand(card_number)
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield str_validator
+        yield constr_strip_whitespace
+        yield constr_length_validator
+        yield cls.validate_digits
+        yield cls.validate_luhn_check_digit
+        yield cls
+        yield cls.validate_length_for_brand
+
+    @property
+    def masked(self) -> str:
+        num_masked = len(self) - 10  # len(bin) + len(last4) == 10
+        return f'{self.bin}{"*" * num_masked}{self.last4}'
+
+    @classmethod
+    def validate_digits(cls, card_number: str) -> str:
+        if not card_number.isdigit():
+            raise errors.NotDigitError
+        return card_number
+
+    @classmethod
+    def validate_luhn_check_digit(cls, card_number: str) -> str:
+        """
+        Based on: https://en.wikipedia.org/wiki/Luhn_algorithm
+        """
+        sum_ = int(card_number[-1])
+        length = len(card_number)
+        parity = length % 2
+        for i in range(length - 1):
+            digit = int(card_number[i])
+            if i % 2 == parity:
+                digit *= 2
+            if digit > 9:
+                digit -= 9
+            sum_ += digit
+        valid = sum_ % 10 == 0
+        if not valid:
+            raise errors.LuhnValidationError
+        return card_number
+
+    @classmethod
+    def validate_length_for_brand(cls, card_number: 'PaymentCardNumber') -> 'PaymentCardNumber':
+        """
+        Validate length based on BIN for major brands:
+        https://en.wikipedia.org/wiki/Payment_card_number#Issuer_identification_number_(IIN)
+        """
+        required_length: Union[None, int, str] = None
+        if card_number.brand in PaymentCardBrand.mastercard:
+            required_length = 16
+            valid = len(card_number) == required_length
+        elif card_number.brand == PaymentCardBrand.visa:
+            required_length = '13, 16 or 19'
+            valid = len(card_number) in {13, 16, 19}
+        elif card_number.brand == PaymentCardBrand.amex:
+            required_length = 15
+            valid = len(card_number) == required_length
+        else:
+            valid = True
+        if not valid:
+            raise errors.InvalidLengthForBrand(brand=card_number.brand, required_length=required_length)
+        return card_number
+
+    @staticmethod
+    def _get_brand(card_number: str) -> PaymentCardBrand:
+        if card_number[0] == '4':
+            brand = PaymentCardBrand.visa
+        elif 51 <= int(card_number[:2]) <= 55:
+            brand = PaymentCardBrand.mastercard
+        elif card_number[:2] in {'34', '37'}:
+            brand = PaymentCardBrand.amex
+        else:
+            brand = PaymentCardBrand.other
+        return brand
+
+
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ BYTE SIZE TYPE ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+BYTE_SIZES = {
+    'b': 1,
+    'kb': 10**3,
+    'mb': 10**6,
+    'gb': 10**9,
+    'tb': 10**12,
+    'pb': 10**15,
+    'eb': 10**18,
+    'kib': 2**10,
+    'mib': 2**20,
+    'gib': 2**30,
+    'tib': 2**40,
+    'pib': 2**50,
+    'eib': 2**60,
+}
+BYTE_SIZES.update({k.lower()[0]: v for k, v in BYTE_SIZES.items() if 'i' not in k})
+byte_string_re = re.compile(r'^\s*(\d*\.?\d+)\s*(\w+)?', re.IGNORECASE)
+
+
+class ByteSize(int):
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield cls.validate
+
+    @classmethod
+    def validate(cls, v: StrIntFloat) -> 'ByteSize':
+
+        try:
+            return cls(int(v))
+        except ValueError:
+            pass
+
+        str_match = byte_string_re.match(str(v))
+        if str_match is None:
+            raise errors.InvalidByteSize()
+
+        scalar, unit = str_match.groups()
+        if unit is None:
+            unit = 'b'
+
+        try:
+            unit_mult = BYTE_SIZES[unit.lower()]
+        except KeyError:
+            raise errors.InvalidByteSizeUnit(unit=unit)
+
+        return cls(int(float(scalar) * unit_mult))
+
+    def human_readable(self, decimal: bool = False) -> str:
+
+        if decimal:
+            divisor = 1000
+            units = ['B', 'KB', 'MB', 'GB', 'TB', 'PB']
+            final_unit = 'EB'
+        else:
+            divisor = 1024
+            units = ['B', 'KiB', 'MiB', 'GiB', 'TiB', 'PiB']
+            final_unit = 'EiB'
+
+        num = float(self)
+        for unit in units:
+            if abs(num) < divisor:
+                return f'{num:0.1f}{unit}'
+            num /= divisor
+
+        return f'{num:0.1f}{final_unit}'
+
+    def to(self, unit: str) -> float:
+
+        try:
+            unit_div = BYTE_SIZES[unit.lower()]
+        except KeyError:
+            raise errors.InvalidByteSizeUnit(unit=unit)
+
+        return self / unit_div
+
+
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ DATE TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+if TYPE_CHECKING:
+    PastDate = date
+    FutureDate = date
+else:
+
+    class PastDate(date):
+        @classmethod
+        def __get_validators__(cls) -> 'CallableGenerator':
+            yield parse_date
+            yield cls.validate
+
+        @classmethod
+        def validate(cls, value: date) -> date:
+            if value >= date.today():
+                raise errors.DateNotInThePastError()
+
+            return value
+
+    class FutureDate(date):
+        @classmethod
+        def __get_validators__(cls) -> 'CallableGenerator':
+            yield parse_date
+            yield cls.validate
+
+        @classmethod
+        def validate(cls, value: date) -> date:
+            if value <= date.today():
+                raise errors.DateNotInTheFutureError()
+
+            return value
+
+
+class ConstrainedDate(date, metaclass=ConstrainedNumberMeta):
+    gt: OptionalDate = None
+    ge: OptionalDate = None
+    lt: OptionalDate = None
+    le: OptionalDate = None
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        update_not_none(field_schema, exclusiveMinimum=cls.gt, exclusiveMaximum=cls.lt, minimum=cls.ge, maximum=cls.le)
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield parse_date
+        yield number_size_validator
+
+
+def condate(
+    *,
+    gt: date = None,
+    ge: date = None,
+    lt: date = None,
+    le: date = None,
+) -> Type[date]:
+    # use kwargs then define conf in a dict to aid with IDE type hinting
+    namespace = dict(gt=gt, ge=ge, lt=lt, le=le)
+    return type('ConstrainedDateValue', (ConstrainedDate,), namespace)
diff --git a/lib/pydantic/typing.py b/lib/pydantic/typing.py
new file mode 100644
index 00000000..5ccf266c
--- /dev/null
+++ b/lib/pydantic/typing.py
@@ -0,0 +1,602 @@
+import sys
+from collections.abc import Callable
+from os import PathLike
+from typing import (  # type: ignore
+    TYPE_CHECKING,
+    AbstractSet,
+    Any,
+    Callable as TypingCallable,
+    ClassVar,
+    Dict,
+    ForwardRef,
+    Generator,
+    Iterable,
+    List,
+    Mapping,
+    NewType,
+    Optional,
+    Sequence,
+    Set,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+    _eval_type,
+    cast,
+    get_type_hints,
+)
+
+from typing_extensions import (
+    Annotated,
+    Final,
+    Literal,
+    NotRequired as TypedDictNotRequired,
+    Required as TypedDictRequired,
+)
+
+try:
+    from typing import _TypingBase as typing_base  # type: ignore
+except ImportError:
+    from typing import _Final as typing_base  # type: ignore
+
+try:
+    from typing import GenericAlias as TypingGenericAlias  # type: ignore
+except ImportError:
+    # python < 3.9 does not have GenericAlias (list[int], tuple[str, ...] and so on)
+    TypingGenericAlias = ()
+
+try:
+    from types import UnionType as TypesUnionType  # type: ignore
+except ImportError:
+    # python < 3.10 does not have UnionType (str | int, byte | bool and so on)
+    TypesUnionType = ()
+
+
+if sys.version_info < (3, 9):
+
+    def evaluate_forwardref(type_: ForwardRef, globalns: Any, localns: Any) -> Any:
+        return type_._evaluate(globalns, localns)
+
+else:
+
+    def evaluate_forwardref(type_: ForwardRef, globalns: Any, localns: Any) -> Any:
+        # Even though it is the right signature for python 3.9, mypy complains with
+        # `error: Too many arguments for "_evaluate" of "ForwardRef"` hence the cast...
+        return cast(Any, type_)._evaluate(globalns, localns, set())
+
+
+if sys.version_info < (3, 9):
+    # Ensure we always get all the whole `Annotated` hint, not just the annotated type.
+    # For 3.7 to 3.8, `get_type_hints` doesn't recognize `typing_extensions.Annotated`,
+    # so it already returns the full annotation
+    get_all_type_hints = get_type_hints
+
+else:
+
+    def get_all_type_hints(obj: Any, globalns: Any = None, localns: Any = None) -> Any:
+        return get_type_hints(obj, globalns, localns, include_extras=True)
+
+
+_T = TypeVar('_T')
+
+AnyCallable = TypingCallable[..., Any]
+NoArgAnyCallable = TypingCallable[[], Any]
+
+# workaround for https://github.com/python/mypy/issues/9496
+AnyArgTCallable = TypingCallable[..., _T]
+
+
+# Annotated[...] is implemented by returning an instance of one of these classes, depending on
+# python/typing_extensions version.
+AnnotatedTypeNames = {'AnnotatedMeta', '_AnnotatedAlias'}
+
+
+if sys.version_info < (3, 8):
+
+    def get_origin(t: Type[Any]) -> Optional[Type[Any]]:
+        if type(t).__name__ in AnnotatedTypeNames:
+            # weirdly this is a runtime requirement, as well as for mypy
+            return cast(Type[Any], Annotated)
+        return getattr(t, '__origin__', None)
+
+else:
+    from typing import get_origin as _typing_get_origin
+
+    def get_origin(tp: Type[Any]) -> Optional[Type[Any]]:
+        """
+        We can't directly use `typing.get_origin` since we need a fallback to support
+        custom generic classes like `ConstrainedList`
+        It should be useless once https://github.com/cython/cython/issues/3537 is
+        solved and https://github.com/pydantic/pydantic/pull/1753 is merged.
+        """
+        if type(tp).__name__ in AnnotatedTypeNames:
+            return cast(Type[Any], Annotated)  # mypy complains about _SpecialForm
+        return _typing_get_origin(tp) or getattr(tp, '__origin__', None)
+
+
+if sys.version_info < (3, 8):
+    from typing import _GenericAlias
+
+    def get_args(t: Type[Any]) -> Tuple[Any, ...]:
+        """Compatibility version of get_args for python 3.7.
+
+        Mostly compatible with the python 3.8 `typing` module version
+        and able to handle almost all use cases.
+        """
+        if type(t).__name__ in AnnotatedTypeNames:
+            return t.__args__ + t.__metadata__
+        if isinstance(t, _GenericAlias):
+            res = t.__args__
+            if t.__origin__ is Callable and res and res[0] is not Ellipsis:
+                res = (list(res[:-1]), res[-1])
+            return res
+        return getattr(t, '__args__', ())
+
+else:
+    from typing import get_args as _typing_get_args
+
+    def _generic_get_args(tp: Type[Any]) -> Tuple[Any, ...]:
+        """
+        In python 3.9, `typing.Dict`, `typing.List`, ...
+        do have an empty `__args__` by default (instead of the generic ~T for example).
+        In order to still support `Dict` for example and consider it as `Dict[Any, Any]`,
+        we retrieve the `_nparams` value that tells us how many parameters it needs.
+        """
+        if hasattr(tp, '_nparams'):
+            return (Any,) * tp._nparams
+        # Special case for `tuple[()]`, which used to return ((),) with `typing.Tuple`
+        # in python 3.10- but now returns () for `tuple` and `Tuple`.
+        # This will probably be clarified in pydantic v2
+        try:
+            if tp == Tuple[()] or sys.version_info >= (3, 9) and tp == tuple[()]:  # type: ignore[misc]
+                return ((),)
+        # there is a TypeError when compiled with cython
+        except TypeError:  # pragma: no cover
+            pass
+        return ()
+
+    def get_args(tp: Type[Any]) -> Tuple[Any, ...]:
+        """Get type arguments with all substitutions performed.
+
+        For unions, basic simplifications used by Union constructor are performed.
+        Examples::
+            get_args(Dict[str, int]) == (str, int)
+            get_args(int) == ()
+            get_args(Union[int, Union[T, int], str][int]) == (int, str)
+            get_args(Union[int, Tuple[T, int]][str]) == (int, Tuple[str, int])
+            get_args(Callable[[], T][int]) == ([], int)
+        """
+        if type(tp).__name__ in AnnotatedTypeNames:
+            return tp.__args__ + tp.__metadata__
+        # the fallback is needed for the same reasons as `get_origin` (see above)
+        return _typing_get_args(tp) or getattr(tp, '__args__', ()) or _generic_get_args(tp)
+
+
+if sys.version_info < (3, 9):
+
+    def convert_generics(tp: Type[Any]) -> Type[Any]:
+        """Python 3.9 and older only supports generics from `typing` module.
+        They convert strings to ForwardRef automatically.
+
+        Examples::
+            typing.List['Hero'] == typing.List[ForwardRef('Hero')]
+        """
+        return tp
+
+else:
+    from typing import _UnionGenericAlias  # type: ignore
+
+    from typing_extensions import _AnnotatedAlias
+
+    def convert_generics(tp: Type[Any]) -> Type[Any]:
+        """
+        Recursively searches for `str` type hints and replaces them with ForwardRef.
+
+        Examples::
+            convert_generics(list['Hero']) == list[ForwardRef('Hero')]
+            convert_generics(dict['Hero', 'Team']) == dict[ForwardRef('Hero'), ForwardRef('Team')]
+            convert_generics(typing.Dict['Hero', 'Team']) == typing.Dict[ForwardRef('Hero'), ForwardRef('Team')]
+            convert_generics(list[str | 'Hero'] | int) == list[str | ForwardRef('Hero')] | int
+        """
+        origin = get_origin(tp)
+        if not origin or not hasattr(tp, '__args__'):
+            return tp
+
+        args = get_args(tp)
+
+        # typing.Annotated needs special treatment
+        if origin is Annotated:
+            return _AnnotatedAlias(convert_generics(args[0]), args[1:])
+
+        # recursively replace `str` instances inside of `GenericAlias` with `ForwardRef(arg)`
+        converted = tuple(
+            ForwardRef(arg) if isinstance(arg, str) and isinstance(tp, TypingGenericAlias) else convert_generics(arg)
+            for arg in args
+        )
+
+        if converted == args:
+            return tp
+        elif isinstance(tp, TypingGenericAlias):
+            return TypingGenericAlias(origin, converted)
+        elif isinstance(tp, TypesUnionType):
+            # recreate types.UnionType (PEP604, Python >= 3.10)
+            return _UnionGenericAlias(origin, converted)
+        else:
+            try:
+                setattr(tp, '__args__', converted)
+            except AttributeError:
+                pass
+            return tp
+
+
+if sys.version_info < (3, 10):
+
+    def is_union(tp: Optional[Type[Any]]) -> bool:
+        return tp is Union
+
+    WithArgsTypes = (TypingGenericAlias,)
+
+else:
+    import types
+    import typing
+
+    def is_union(tp: Optional[Type[Any]]) -> bool:
+        return tp is Union or tp is types.UnionType  # noqa: E721
+
+    WithArgsTypes = (typing._GenericAlias, types.GenericAlias, types.UnionType)
+
+
+if sys.version_info < (3, 9):
+    StrPath = Union[str, PathLike]
+else:
+    StrPath = Union[str, PathLike]
+    # TODO: Once we switch to Cython 3 to handle generics properly
+    #  (https://github.com/cython/cython/issues/2753), use following lines instead
+    #  of the one above
+    # # os.PathLike only becomes subscriptable from Python 3.9 onwards
+    # StrPath = Union[str, PathLike[str]]
+
+
+if TYPE_CHECKING:
+    from .fields import ModelField
+
+    TupleGenerator = Generator[Tuple[str, Any], None, None]
+    DictStrAny = Dict[str, Any]
+    DictAny = Dict[Any, Any]
+    SetStr = Set[str]
+    ListStr = List[str]
+    IntStr = Union[int, str]
+    AbstractSetIntStr = AbstractSet[IntStr]
+    DictIntStrAny = Dict[IntStr, Any]
+    MappingIntStrAny = Mapping[IntStr, Any]
+    CallableGenerator = Generator[AnyCallable, None, None]
+    ReprArgs = Sequence[Tuple[Optional[str], Any]]
+    AnyClassMethod = classmethod[Any]
+
+__all__ = (
+    'AnyCallable',
+    'NoArgAnyCallable',
+    'NoneType',
+    'is_none_type',
+    'display_as_type',
+    'resolve_annotations',
+    'is_callable_type',
+    'is_literal_type',
+    'all_literal_values',
+    'is_namedtuple',
+    'is_typeddict',
+    'is_typeddict_special',
+    'is_new_type',
+    'new_type_supertype',
+    'is_classvar',
+    'is_finalvar',
+    'update_field_forward_refs',
+    'update_model_forward_refs',
+    'TupleGenerator',
+    'DictStrAny',
+    'DictAny',
+    'SetStr',
+    'ListStr',
+    'IntStr',
+    'AbstractSetIntStr',
+    'DictIntStrAny',
+    'CallableGenerator',
+    'ReprArgs',
+    'AnyClassMethod',
+    'CallableGenerator',
+    'WithArgsTypes',
+    'get_args',
+    'get_origin',
+    'get_sub_types',
+    'typing_base',
+    'get_all_type_hints',
+    'is_union',
+    'StrPath',
+    'MappingIntStrAny',
+)
+
+
+NoneType = None.__class__
+
+
+NONE_TYPES: Tuple[Any, Any, Any] = (None, NoneType, Literal[None])
+
+
+if sys.version_info < (3, 8):
+    # Even though this implementation is slower, we need it for python 3.7:
+    # In python 3.7 "Literal" is not a builtin type and uses a different
+    # mechanism.
+    # for this reason `Literal[None] is Literal[None]` evaluates to `False`,
+    # breaking the faster implementation used for the other python versions.
+
+    def is_none_type(type_: Any) -> bool:
+        return type_ in NONE_TYPES
+
+elif sys.version_info[:2] == (3, 8):
+
+    def is_none_type(type_: Any) -> bool:
+        for none_type in NONE_TYPES:
+            if type_ is none_type:
+                return True
+        # With python 3.8, specifically 3.8.10, Literal "is" check sare very flakey
+        # can change on very subtle changes like use of types in other modules,
+        # hopefully this check avoids that issue.
+        if is_literal_type(type_):  # pragma: no cover
+            return all_literal_values(type_) == (None,)
+        return False
+
+else:
+
+    def is_none_type(type_: Any) -> bool:
+        for none_type in NONE_TYPES:
+            if type_ is none_type:
+                return True
+        return False
+
+
+def display_as_type(v: Type[Any]) -> str:
+    if not isinstance(v, typing_base) and not isinstance(v, WithArgsTypes) and not isinstance(v, type):
+        v = v.__class__
+
+    if is_union(get_origin(v)):
+        return f'Union[{", ".join(map(display_as_type, get_args(v)))}]'
+
+    if isinstance(v, WithArgsTypes):
+        # Generic alias are constructs like `list[int]`
+        return str(v).replace('typing.', '')
+
+    try:
+        return v.__name__
+    except AttributeError:
+        # happens with typing objects
+        return str(v).replace('typing.', '')
+
+
+def resolve_annotations(raw_annotations: Dict[str, Type[Any]], module_name: Optional[str]) -> Dict[str, Type[Any]]:
+    """
+    Partially taken from typing.get_type_hints.
+
+    Resolve string or ForwardRef annotations into type objects if possible.
+    """
+    base_globals: Optional[Dict[str, Any]] = None
+    if module_name:
+        try:
+            module = sys.modules[module_name]
+        except KeyError:
+            # happens occasionally, see https://github.com/pydantic/pydantic/issues/2363
+            pass
+        else:
+            base_globals = module.__dict__
+
+    annotations = {}
+    for name, value in raw_annotations.items():
+        if isinstance(value, str):
+            if (3, 10) > sys.version_info >= (3, 9, 8) or sys.version_info >= (3, 10, 1):
+                value = ForwardRef(value, is_argument=False, is_class=True)
+            else:
+                value = ForwardRef(value, is_argument=False)
+        try:
+            value = _eval_type(value, base_globals, None)
+        except NameError:
+            # this is ok, it can be fixed with update_forward_refs
+            pass
+        annotations[name] = value
+    return annotations
+
+
+def is_callable_type(type_: Type[Any]) -> bool:
+    return type_ is Callable or get_origin(type_) is Callable
+
+
+def is_literal_type(type_: Type[Any]) -> bool:
+    return Literal is not None and get_origin(type_) is Literal
+
+
+def literal_values(type_: Type[Any]) -> Tuple[Any, ...]:
+    return get_args(type_)
+
+
+def all_literal_values(type_: Type[Any]) -> Tuple[Any, ...]:
+    """
+    This method is used to retrieve all Literal values as
+    Literal can be used recursively (see https://www.python.org/dev/peps/pep-0586)
+    e.g. `Literal[Literal[Literal[1, 2, 3], "foo"], 5, None]`
+    """
+    if not is_literal_type(type_):
+        return (type_,)
+
+    values = literal_values(type_)
+    return tuple(x for value in values for x in all_literal_values(value))
+
+
+def is_namedtuple(type_: Type[Any]) -> bool:
+    """
+    Check if a given class is a named tuple.
+    It can be either a `typing.NamedTuple` or `collections.namedtuple`
+    """
+    from .utils import lenient_issubclass
+
+    return lenient_issubclass(type_, tuple) and hasattr(type_, '_fields')
+
+
+def is_typeddict(type_: Type[Any]) -> bool:
+    """
+    Check if a given class is a typed dict (from `typing` or `typing_extensions`)
+    In 3.10, there will be a public method (https://docs.python.org/3.10/library/typing.html#typing.is_typeddict)
+    """
+    from .utils import lenient_issubclass
+
+    return lenient_issubclass(type_, dict) and hasattr(type_, '__total__')
+
+
+def _check_typeddict_special(type_: Any) -> bool:
+    return type_ is TypedDictRequired or type_ is TypedDictNotRequired
+
+
+def is_typeddict_special(type_: Any) -> bool:
+    """
+    Check if type is a TypedDict special form (Required or NotRequired).
+    """
+    return _check_typeddict_special(type_) or _check_typeddict_special(get_origin(type_))
+
+
+test_type = NewType('test_type', str)
+
+
+def is_new_type(type_: Type[Any]) -> bool:
+    """
+    Check whether type_ was created using typing.NewType
+    """
+    return isinstance(type_, test_type.__class__) and hasattr(type_, '__supertype__')  # type: ignore
+
+
+def new_type_supertype(type_: Type[Any]) -> Type[Any]:
+    while hasattr(type_, '__supertype__'):
+        type_ = type_.__supertype__
+    return type_
+
+
+def _check_classvar(v: Optional[Type[Any]]) -> bool:
+    if v is None:
+        return False
+
+    return v.__class__ == ClassVar.__class__ and getattr(v, '_name', None) == 'ClassVar'
+
+
+def _check_finalvar(v: Optional[Type[Any]]) -> bool:
+    """
+    Check if a given type is a `typing.Final` type.
+    """
+    if v is None:
+        return False
+
+    return v.__class__ == Final.__class__ and (sys.version_info < (3, 8) or getattr(v, '_name', None) == 'Final')
+
+
+def is_classvar(ann_type: Type[Any]) -> bool:
+    if _check_classvar(ann_type) or _check_classvar(get_origin(ann_type)):
+        return True
+
+    # this is an ugly workaround for class vars that contain forward references and are therefore themselves
+    # forward references, see #3679
+    if ann_type.__class__ == ForwardRef and ann_type.__forward_arg__.startswith('ClassVar['):
+        return True
+
+    return False
+
+
+def is_finalvar(ann_type: Type[Any]) -> bool:
+    return _check_finalvar(ann_type) or _check_finalvar(get_origin(ann_type))
+
+
+def update_field_forward_refs(field: 'ModelField', globalns: Any, localns: Any) -> None:
+    """
+    Try to update ForwardRefs on fields based on this ModelField, globalns and localns.
+    """
+    prepare = False
+    if field.type_.__class__ == ForwardRef:
+        prepare = True
+        field.type_ = evaluate_forwardref(field.type_, globalns, localns or None)
+    if field.outer_type_.__class__ == ForwardRef:
+        prepare = True
+        field.outer_type_ = evaluate_forwardref(field.outer_type_, globalns, localns or None)
+    if prepare:
+        field.prepare()
+
+    if field.sub_fields:
+        for sub_f in field.sub_fields:
+            update_field_forward_refs(sub_f, globalns=globalns, localns=localns)
+
+    if field.discriminator_key is not None:
+        field.prepare_discriminated_union_sub_fields()
+
+
+def update_model_forward_refs(
+    model: Type[Any],
+    fields: Iterable['ModelField'],
+    json_encoders: Dict[Union[Type[Any], str, ForwardRef], AnyCallable],
+    localns: 'DictStrAny',
+    exc_to_suppress: Tuple[Type[BaseException], ...] = (),
+) -> None:
+    """
+    Try to update model fields ForwardRefs based on model and localns.
+    """
+    if model.__module__ in sys.modules:
+        globalns = sys.modules[model.__module__].__dict__.copy()
+    else:
+        globalns = {}
+
+    globalns.setdefault(model.__name__, model)
+
+    for f in fields:
+        try:
+            update_field_forward_refs(f, globalns=globalns, localns=localns)
+        except exc_to_suppress:
+            pass
+
+    for key in set(json_encoders.keys()):
+        if isinstance(key, str):
+            fr: ForwardRef = ForwardRef(key)
+        elif isinstance(key, ForwardRef):
+            fr = key
+        else:
+            continue
+
+        try:
+            new_key = evaluate_forwardref(fr, globalns, localns or None)
+        except exc_to_suppress:  # pragma: no cover
+            continue
+
+        json_encoders[new_key] = json_encoders.pop(key)
+
+
+def get_class(type_: Type[Any]) -> Union[None, bool, Type[Any]]:
+    """
+    Tries to get the class of a Type[T] annotation. Returns True if Type is used
+    without brackets. Otherwise returns None.
+    """
+    if type_ is type:
+        return True
+
+    if get_origin(type_) is None:
+        return None
+
+    args = get_args(type_)
+    if not args or not isinstance(args[0], type):
+        return True
+    else:
+        return args[0]
+
+
+def get_sub_types(tp: Any) -> List[Any]:
+    """
+    Return all the types that are allowed by type `tp`
+    `tp` can be a `Union` of allowed types or an `Annotated` type
+    """
+    origin = get_origin(tp)
+    if origin is Annotated:
+        return get_sub_types(get_args(tp)[0])
+    elif is_union(origin):
+        return [x for t in get_args(tp) for x in get_sub_types(t)]
+    else:
+        return [tp]
diff --git a/lib/pydantic/utils.py b/lib/pydantic/utils.py
new file mode 100644
index 00000000..1d016c0e
--- /dev/null
+++ b/lib/pydantic/utils.py
@@ -0,0 +1,841 @@
+import keyword
+import warnings
+import weakref
+from collections import OrderedDict, defaultdict, deque
+from copy import deepcopy
+from itertools import islice, zip_longest
+from types import BuiltinFunctionType, CodeType, FunctionType, GeneratorType, LambdaType, ModuleType
+from typing import (
+    TYPE_CHECKING,
+    AbstractSet,
+    Any,
+    Callable,
+    Collection,
+    Dict,
+    Generator,
+    Iterable,
+    Iterator,
+    List,
+    Mapping,
+    MutableMapping,
+    NoReturn,
+    Optional,
+    Set,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+)
+
+from typing_extensions import Annotated
+
+from .errors import ConfigError
+from .typing import (
+    NoneType,
+    WithArgsTypes,
+    all_literal_values,
+    display_as_type,
+    get_args,
+    get_origin,
+    is_literal_type,
+    is_union,
+)
+from .version import version_info
+
+if TYPE_CHECKING:
+    from inspect import Signature
+    from pathlib import Path
+
+    from .config import BaseConfig
+    from .dataclasses import Dataclass
+    from .fields import ModelField
+    from .main import BaseModel
+    from .typing import AbstractSetIntStr, DictIntStrAny, IntStr, MappingIntStrAny, ReprArgs
+
+    RichReprResult = Iterable[Union[Any, Tuple[Any], Tuple[str, Any], Tuple[str, Any, Any]]]
+
+__all__ = (
+    'import_string',
+    'sequence_like',
+    'validate_field_name',
+    'lenient_isinstance',
+    'lenient_issubclass',
+    'in_ipython',
+    'is_valid_identifier',
+    'deep_update',
+    'update_not_none',
+    'almost_equal_floats',
+    'get_model',
+    'to_camel',
+    'is_valid_field',
+    'smart_deepcopy',
+    'PyObjectStr',
+    'Representation',
+    'GetterDict',
+    'ValueItems',
+    'version_info',  # required here to match behaviour in v1.3
+    'ClassAttribute',
+    'path_type',
+    'ROOT_KEY',
+    'get_unique_discriminator_alias',
+    'get_discriminator_alias_and_values',
+    'DUNDER_ATTRIBUTES',
+    'LimitedDict',
+)
+
+ROOT_KEY = '__root__'
+# these are types that are returned unchanged by deepcopy
+IMMUTABLE_NON_COLLECTIONS_TYPES: Set[Type[Any]] = {
+    int,
+    float,
+    complex,
+    str,
+    bool,
+    bytes,
+    type,
+    NoneType,
+    FunctionType,
+    BuiltinFunctionType,
+    LambdaType,
+    weakref.ref,
+    CodeType,
+    # note: including ModuleType will differ from behaviour of deepcopy by not producing error.
+    # It might be not a good idea in general, but considering that this function used only internally
+    # against default values of fields, this will allow to actually have a field with module as default value
+    ModuleType,
+    NotImplemented.__class__,
+    Ellipsis.__class__,
+}
+
+# these are types that if empty, might be copied with simple copy() instead of deepcopy()
+BUILTIN_COLLECTIONS: Set[Type[Any]] = {
+    list,
+    set,
+    tuple,
+    frozenset,
+    dict,
+    OrderedDict,
+    defaultdict,
+    deque,
+}
+
+
+def import_string(dotted_path: str) -> Any:
+    """
+    Stolen approximately from django. Import a dotted module path and return the attribute/class designated by the
+    last name in the path. Raise ImportError if the import fails.
+    """
+    from importlib import import_module
+
+    try:
+        module_path, class_name = dotted_path.strip(' ').rsplit('.', 1)
+    except ValueError as e:
+        raise ImportError(f'"{dotted_path}" doesn\'t look like a module path') from e
+
+    module = import_module(module_path)
+    try:
+        return getattr(module, class_name)
+    except AttributeError as e:
+        raise ImportError(f'Module "{module_path}" does not define a "{class_name}" attribute') from e
+
+
+def truncate(v: Union[str], *, max_len: int = 80) -> str:
+    """
+    Truncate a value and add a unicode ellipsis (three dots) to the end if it was too long
+    """
+    warnings.warn('`truncate` is no-longer used by pydantic and is deprecated', DeprecationWarning)
+    if isinstance(v, str) and len(v) > (max_len - 2):
+        # -3 so quote + string + … + quote has correct length
+        return (v[: (max_len - 3)] + '…').__repr__()
+    try:
+        v = v.__repr__()
+    except TypeError:
+        v = v.__class__.__repr__(v)  # in case v is a type
+    if len(v) > max_len:
+        v = v[: max_len - 1] + '…'
+    return v
+
+
+def sequence_like(v: Any) -> bool:
+    return isinstance(v, (list, tuple, set, frozenset, GeneratorType, deque))
+
+
+def validate_field_name(bases: List[Type['BaseModel']], field_name: str) -> None:
+    """
+    Ensure that the field's name does not shadow an existing attribute of the model.
+    """
+    for base in bases:
+        if getattr(base, field_name, None):
+            raise NameError(
+                f'Field name "{field_name}" shadows a BaseModel attribute; '
+                f'use a different field name with "alias=\'{field_name}\'".'
+            )
+
+
+def lenient_isinstance(o: Any, class_or_tuple: Union[Type[Any], Tuple[Type[Any], ...], None]) -> bool:
+    try:
+        return isinstance(o, class_or_tuple)  # type: ignore[arg-type]
+    except TypeError:
+        return False
+
+
+def lenient_issubclass(cls: Any, class_or_tuple: Union[Type[Any], Tuple[Type[Any], ...], None]) -> bool:
+    try:
+        return isinstance(cls, type) and issubclass(cls, class_or_tuple)  # type: ignore[arg-type]
+    except TypeError:
+        if isinstance(cls, WithArgsTypes):
+            return False
+        raise  # pragma: no cover
+
+
+def in_ipython() -> bool:
+    """
+    Check whether we're in an ipython environment, including jupyter notebooks.
+    """
+    try:
+        eval('__IPYTHON__')
+    except NameError:
+        return False
+    else:  # pragma: no cover
+        return True
+
+
+def is_valid_identifier(identifier: str) -> bool:
+    """
+    Checks that a string is a valid identifier and not a Python keyword.
+    :param identifier: The identifier to test.
+    :return: True if the identifier is valid.
+    """
+    return identifier.isidentifier() and not keyword.iskeyword(identifier)
+
+
+KeyType = TypeVar('KeyType')
+
+
+def deep_update(mapping: Dict[KeyType, Any], *updating_mappings: Dict[KeyType, Any]) -> Dict[KeyType, Any]:
+    updated_mapping = mapping.copy()
+    for updating_mapping in updating_mappings:
+        for k, v in updating_mapping.items():
+            if k in updated_mapping and isinstance(updated_mapping[k], dict) and isinstance(v, dict):
+                updated_mapping[k] = deep_update(updated_mapping[k], v)
+            else:
+                updated_mapping[k] = v
+    return updated_mapping
+
+
+def update_not_none(mapping: Dict[Any, Any], **update: Any) -> None:
+    mapping.update({k: v for k, v in update.items() if v is not None})
+
+
+def almost_equal_floats(value_1: float, value_2: float, *, delta: float = 1e-8) -> bool:
+    """
+    Return True if two floats are almost equal
+    """
+    return abs(value_1 - value_2) <= delta
+
+
+def generate_model_signature(
+    init: Callable[..., None], fields: Dict[str, 'ModelField'], config: Type['BaseConfig']
+) -> 'Signature':
+    """
+    Generate signature for model based on its fields
+    """
+    from inspect import Parameter, Signature, signature
+
+    from .config import Extra
+
+    present_params = signature(init).parameters.values()
+    merged_params: Dict[str, Parameter] = {}
+    var_kw = None
+    use_var_kw = False
+
+    for param in islice(present_params, 1, None):  # skip self arg
+        if param.kind is param.VAR_KEYWORD:
+            var_kw = param
+            continue
+        merged_params[param.name] = param
+
+    if var_kw:  # if custom init has no var_kw, fields which are not declared in it cannot be passed through
+        allow_names = config.allow_population_by_field_name
+        for field_name, field in fields.items():
+            param_name = field.alias
+            if field_name in merged_params or param_name in merged_params:
+                continue
+            elif not is_valid_identifier(param_name):
+                if allow_names and is_valid_identifier(field_name):
+                    param_name = field_name
+                else:
+                    use_var_kw = True
+                    continue
+
+            # TODO: replace annotation with actual expected types once #1055 solved
+            kwargs = {'default': field.default} if not field.required else {}
+            merged_params[param_name] = Parameter(
+                param_name, Parameter.KEYWORD_ONLY, annotation=field.annotation, **kwargs
+            )
+
+    if config.extra is Extra.allow:
+        use_var_kw = True
+
+    if var_kw and use_var_kw:
+        # Make sure the parameter for extra kwargs
+        # does not have the same name as a field
+        default_model_signature = [
+            ('__pydantic_self__', Parameter.POSITIONAL_OR_KEYWORD),
+            ('data', Parameter.VAR_KEYWORD),
+        ]
+        if [(p.name, p.kind) for p in present_params] == default_model_signature:
+            # if this is the standard model signature, use extra_data as the extra args name
+            var_kw_name = 'extra_data'
+        else:
+            # else start from var_kw
+            var_kw_name = var_kw.name
+
+        # generate a name that's definitely unique
+        while var_kw_name in fields:
+            var_kw_name += '_'
+        merged_params[var_kw_name] = var_kw.replace(name=var_kw_name)
+
+    return Signature(parameters=list(merged_params.values()), return_annotation=None)
+
+
+def get_model(obj: Union[Type['BaseModel'], Type['Dataclass']]) -> Type['BaseModel']:
+    from .main import BaseModel
+
+    try:
+        model_cls = obj.__pydantic_model__  # type: ignore
+    except AttributeError:
+        model_cls = obj
+
+    if not issubclass(model_cls, BaseModel):
+        raise TypeError('Unsupported type, must be either BaseModel or dataclass')
+    return model_cls
+
+
+def to_camel(string: str) -> str:
+    return ''.join(word.capitalize() for word in string.split('_'))
+
+
+def to_lower_camel(string: str) -> str:
+    if len(string) >= 1:
+        pascal_string = to_camel(string)
+        return pascal_string[0].lower() + pascal_string[1:]
+    return string.lower()
+
+
+T = TypeVar('T')
+
+
+def unique_list(
+    input_list: Union[List[T], Tuple[T, ...]],
+    *,
+    name_factory: Callable[[T], str] = str,
+) -> List[T]:
+    """
+    Make a list unique while maintaining order.
+    We update the list if another one with the same name is set
+    (e.g. root validator overridden in subclass)
+    """
+    result: List[T] = []
+    result_names: List[str] = []
+    for v in input_list:
+        v_name = name_factory(v)
+        if v_name not in result_names:
+            result_names.append(v_name)
+            result.append(v)
+        else:
+            result[result_names.index(v_name)] = v
+
+    return result
+
+
+class PyObjectStr(str):
+    """
+    String class where repr doesn't include quotes. Useful with Representation when you want to return a string
+    representation of something that valid (or pseudo-valid) python.
+    """
+
+    def __repr__(self) -> str:
+        return str(self)
+
+
+class Representation:
+    """
+    Mixin to provide __str__, __repr__, and __pretty__ methods. See #884 for more details.
+
+    __pretty__ is used by [devtools](https://python-devtools.helpmanual.io/) to provide human readable representations
+    of objects.
+    """
+
+    __slots__: Tuple[str, ...] = tuple()
+
+    def __repr_args__(self) -> 'ReprArgs':
+        """
+        Returns the attributes to show in __str__, __repr__, and __pretty__ this is generally overridden.
+
+        Can either return:
+        * name - value pairs, e.g.: `[('foo_name', 'foo'), ('bar_name', ['b', 'a', 'r'])]`
+        * or, just values, e.g.: `[(None, 'foo'), (None, ['b', 'a', 'r'])]`
+        """
+        attrs = ((s, getattr(self, s)) for s in self.__slots__)
+        return [(a, v) for a, v in attrs if v is not None]
+
+    def __repr_name__(self) -> str:
+        """
+        Name of the instance's class, used in __repr__.
+        """
+        return self.__class__.__name__
+
+    def __repr_str__(self, join_str: str) -> str:
+        return join_str.join(repr(v) if a is None else f'{a}={v!r}' for a, v in self.__repr_args__())
+
+    def __pretty__(self, fmt: Callable[[Any], Any], **kwargs: Any) -> Generator[Any, None, None]:
+        """
+        Used by devtools (https://python-devtools.helpmanual.io/) to provide a human readable representations of objects
+        """
+        yield self.__repr_name__() + '('
+        yield 1
+        for name, value in self.__repr_args__():
+            if name is not None:
+                yield name + '='
+            yield fmt(value)
+            yield ','
+            yield 0
+        yield -1
+        yield ')'
+
+    def __str__(self) -> str:
+        return self.__repr_str__(' ')
+
+    def __repr__(self) -> str:
+        return f'{self.__repr_name__()}({self.__repr_str__(", ")})'
+
+    def __rich_repr__(self) -> 'RichReprResult':
+        """Get fields for Rich library"""
+        for name, field_repr in self.__repr_args__():
+            if name is None:
+                yield field_repr
+            else:
+                yield name, field_repr
+
+
+class GetterDict(Representation):
+    """
+    Hack to make object's smell just enough like dicts for validate_model.
+
+    We can't inherit from Mapping[str, Any] because it upsets cython so we have to implement all methods ourselves.
+    """
+
+    __slots__ = ('_obj',)
+
+    def __init__(self, obj: Any):
+        self._obj = obj
+
+    def __getitem__(self, key: str) -> Any:
+        try:
+            return getattr(self._obj, key)
+        except AttributeError as e:
+            raise KeyError(key) from e
+
+    def get(self, key: Any, default: Any = None) -> Any:
+        return getattr(self._obj, key, default)
+
+    def extra_keys(self) -> Set[Any]:
+        """
+        We don't want to get any other attributes of obj if the model didn't explicitly ask for them
+        """
+        return set()
+
+    def keys(self) -> List[Any]:
+        """
+        Keys of the pseudo dictionary, uses a list not set so order information can be maintained like python
+        dictionaries.
+        """
+        return list(self)
+
+    def values(self) -> List[Any]:
+        return [self[k] for k in self]
+
+    def items(self) -> Iterator[Tuple[str, Any]]:
+        for k in self:
+            yield k, self.get(k)
+
+    def __iter__(self) -> Iterator[str]:
+        for name in dir(self._obj):
+            if not name.startswith('_'):
+                yield name
+
+    def __len__(self) -> int:
+        return sum(1 for _ in self)
+
+    def __contains__(self, item: Any) -> bool:
+        return item in self.keys()
+
+    def __eq__(self, other: Any) -> bool:
+        return dict(self) == dict(other.items())
+
+    def __repr_args__(self) -> 'ReprArgs':
+        return [(None, dict(self))]
+
+    def __repr_name__(self) -> str:
+        return f'GetterDict[{display_as_type(self._obj)}]'
+
+
+class ValueItems(Representation):
+    """
+    Class for more convenient calculation of excluded or included fields on values.
+    """
+
+    __slots__ = ('_items', '_type')
+
+    def __init__(self, value: Any, items: Union['AbstractSetIntStr', 'MappingIntStrAny']) -> None:
+        items = self._coerce_items(items)
+
+        if isinstance(value, (list, tuple)):
+            items = self._normalize_indexes(items, len(value))
+
+        self._items: 'MappingIntStrAny' = items
+
+    def is_excluded(self, item: Any) -> bool:
+        """
+        Check if item is fully excluded.
+
+        :param item: key or index of a value
+        """
+        return self.is_true(self._items.get(item))
+
+    def is_included(self, item: Any) -> bool:
+        """
+        Check if value is contained in self._items
+
+        :param item: key or index of value
+        """
+        return item in self._items
+
+    def for_element(self, e: 'IntStr') -> Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']]:
+        """
+        :param e: key or index of element on value
+        :return: raw values for element if self._items is dict and contain needed element
+        """
+
+        item = self._items.get(e)
+        return item if not self.is_true(item) else None
+
+    def _normalize_indexes(self, items: 'MappingIntStrAny', v_length: int) -> 'DictIntStrAny':
+        """
+        :param items: dict or set of indexes which will be normalized
+        :param v_length: length of sequence indexes of which will be
+
+        >>> self._normalize_indexes({0: True, -2: True, -1: True}, 4)
+        {0: True, 2: True, 3: True}
+        >>> self._normalize_indexes({'__all__': True}, 4)
+        {0: True, 1: True, 2: True, 3: True}
+        """
+
+        normalized_items: 'DictIntStrAny' = {}
+        all_items = None
+        for i, v in items.items():
+            if not (isinstance(v, Mapping) or isinstance(v, AbstractSet) or self.is_true(v)):
+                raise TypeError(f'Unexpected type of exclude value for index "{i}" {v.__class__}')
+            if i == '__all__':
+                all_items = self._coerce_value(v)
+                continue
+            if not isinstance(i, int):
+                raise TypeError(
+                    'Excluding fields from a sequence of sub-models or dicts must be performed index-wise: '
+                    'expected integer keys or keyword "__all__"'
+                )
+            normalized_i = v_length + i if i < 0 else i
+            normalized_items[normalized_i] = self.merge(v, normalized_items.get(normalized_i))
+
+        if not all_items:
+            return normalized_items
+        if self.is_true(all_items):
+            for i in range(v_length):
+                normalized_items.setdefault(i, ...)
+            return normalized_items
+        for i in range(v_length):
+            normalized_item = normalized_items.setdefault(i, {})
+            if not self.is_true(normalized_item):
+                normalized_items[i] = self.merge(all_items, normalized_item)
+        return normalized_items
+
+    @classmethod
+    def merge(cls, base: Any, override: Any, intersect: bool = False) -> Any:
+        """
+        Merge a ``base`` item with an ``override`` item.
+
+        Both ``base`` and ``override`` are converted to dictionaries if possible.
+        Sets are converted to dictionaries with the sets entries as keys and
+        Ellipsis as values.
+
+        Each key-value pair existing in ``base`` is merged with ``override``,
+        while the rest of the key-value pairs are updated recursively with this function.
+
+        Merging takes place based on the "union" of keys if ``intersect`` is
+        set to ``False`` (default) and on the intersection of keys if
+        ``intersect`` is set to ``True``.
+        """
+        override = cls._coerce_value(override)
+        base = cls._coerce_value(base)
+        if override is None:
+            return base
+        if cls.is_true(base) or base is None:
+            return override
+        if cls.is_true(override):
+            return base if intersect else override
+
+        # intersection or union of keys while preserving ordering:
+        if intersect:
+            merge_keys = [k for k in base if k in override] + [k for k in override if k in base]
+        else:
+            merge_keys = list(base) + [k for k in override if k not in base]
+
+        merged: 'DictIntStrAny' = {}
+        for k in merge_keys:
+            merged_item = cls.merge(base.get(k), override.get(k), intersect=intersect)
+            if merged_item is not None:
+                merged[k] = merged_item
+
+        return merged
+
+    @staticmethod
+    def _coerce_items(items: Union['AbstractSetIntStr', 'MappingIntStrAny']) -> 'MappingIntStrAny':
+        if isinstance(items, Mapping):
+            pass
+        elif isinstance(items, AbstractSet):
+            items = dict.fromkeys(items, ...)
+        else:
+            class_name = getattr(items, '__class__', '???')
+            assert_never(
+                items,
+                f'Unexpected type of exclude value {class_name}',
+            )
+        return items
+
+    @classmethod
+    def _coerce_value(cls, value: Any) -> Any:
+        if value is None or cls.is_true(value):
+            return value
+        return cls._coerce_items(value)
+
+    @staticmethod
+    def is_true(v: Any) -> bool:
+        return v is True or v is ...
+
+    def __repr_args__(self) -> 'ReprArgs':
+        return [(None, self._items)]
+
+
+class ClassAttribute:
+    """
+    Hide class attribute from its instances
+    """
+
+    __slots__ = (
+        'name',
+        'value',
+    )
+
+    def __init__(self, name: str, value: Any) -> None:
+        self.name = name
+        self.value = value
+
+    def __get__(self, instance: Any, owner: Type[Any]) -> None:
+        if instance is None:
+            return self.value
+        raise AttributeError(f'{self.name!r} attribute of {owner.__name__!r} is class-only')
+
+
+path_types = {
+    'is_dir': 'directory',
+    'is_file': 'file',
+    'is_mount': 'mount point',
+    'is_symlink': 'symlink',
+    'is_block_device': 'block device',
+    'is_char_device': 'char device',
+    'is_fifo': 'FIFO',
+    'is_socket': 'socket',
+}
+
+
+def path_type(p: 'Path') -> str:
+    """
+    Find out what sort of thing a path is.
+    """
+    assert p.exists(), 'path does not exist'
+    for method, name in path_types.items():
+        if getattr(p, method)():
+            return name
+
+    return 'unknown'
+
+
+Obj = TypeVar('Obj')
+
+
+def smart_deepcopy(obj: Obj) -> Obj:
+    """
+    Return type as is for immutable built-in types
+    Use obj.copy() for built-in empty collections
+    Use copy.deepcopy() for non-empty collections and unknown objects
+    """
+
+    obj_type = obj.__class__
+    if obj_type in IMMUTABLE_NON_COLLECTIONS_TYPES:
+        return obj  # fastest case: obj is immutable and not collection therefore will not be copied anyway
+    try:
+        if not obj and obj_type in BUILTIN_COLLECTIONS:
+            # faster way for empty collections, no need to copy its members
+            return obj if obj_type is tuple else obj.copy()  # type: ignore  # tuple doesn't have copy method
+    except (TypeError, ValueError, RuntimeError):
+        # do we really dare to catch ALL errors? Seems a bit risky
+        pass
+
+    return deepcopy(obj)  # slowest way when we actually might need a deepcopy
+
+
+def is_valid_field(name: str) -> bool:
+    if not name.startswith('_'):
+        return True
+    return ROOT_KEY == name
+
+
+DUNDER_ATTRIBUTES = {
+    '__annotations__',
+    '__classcell__',
+    '__doc__',
+    '__module__',
+    '__orig_bases__',
+    '__orig_class__',
+    '__qualname__',
+}
+
+
+def is_valid_private_name(name: str) -> bool:
+    return not is_valid_field(name) and name not in DUNDER_ATTRIBUTES
+
+
+_EMPTY = object()
+
+
+def all_identical(left: Iterable[Any], right: Iterable[Any]) -> bool:
+    """
+    Check that the items of `left` are the same objects as those in `right`.
+
+    >>> a, b = object(), object()
+    >>> all_identical([a, b, a], [a, b, a])
+    True
+    >>> all_identical([a, b, [a]], [a, b, [a]])  # new list object, while "equal" is not "identical"
+    False
+    """
+    for left_item, right_item in zip_longest(left, right, fillvalue=_EMPTY):
+        if left_item is not right_item:
+            return False
+    return True
+
+
+def assert_never(obj: NoReturn, msg: str) -> NoReturn:
+    """
+    Helper to make sure that we have covered all possible types.
+
+    This is mostly useful for ``mypy``, docs:
+    https://mypy.readthedocs.io/en/latest/literal_types.html#exhaustive-checks
+    """
+    raise TypeError(msg)
+
+
+def get_unique_discriminator_alias(all_aliases: Collection[str], discriminator_key: str) -> str:
+    """Validate that all aliases are the same and if that's the case return the alias"""
+    unique_aliases = set(all_aliases)
+    if len(unique_aliases) > 1:
+        raise ConfigError(
+            f'Aliases for discriminator {discriminator_key!r} must be the same (got {", ".join(sorted(all_aliases))})'
+        )
+    return unique_aliases.pop()
+
+
+def get_discriminator_alias_and_values(tp: Any, discriminator_key: str) -> Tuple[str, Tuple[str, ...]]:
+    """
+    Get alias and all valid values in the `Literal` type of the discriminator field
+    `tp` can be a `BaseModel` class or directly an `Annotated` `Union` of many.
+    """
+    is_root_model = getattr(tp, '__custom_root_type__', False)
+
+    if get_origin(tp) is Annotated:
+        tp = get_args(tp)[0]
+
+    if hasattr(tp, '__pydantic_model__'):
+        tp = tp.__pydantic_model__
+
+    if is_union(get_origin(tp)):
+        alias, all_values = _get_union_alias_and_all_values(tp, discriminator_key)
+        return alias, tuple(v for values in all_values for v in values)
+    elif is_root_model:
+        union_type = tp.__fields__[ROOT_KEY].type_
+        alias, all_values = _get_union_alias_and_all_values(union_type, discriminator_key)
+
+        if len(set(all_values)) > 1:
+            raise ConfigError(
+                f'Field {discriminator_key!r} is not the same for all submodels of {display_as_type(tp)!r}'
+            )
+
+        return alias, all_values[0]
+
+    else:
+        try:
+            t_discriminator_type = tp.__fields__[discriminator_key].type_
+        except AttributeError as e:
+            raise TypeError(f'Type {tp.__name__!r} is not a valid `BaseModel` or `dataclass`') from e
+        except KeyError as e:
+            raise ConfigError(f'Model {tp.__name__!r} needs a discriminator field for key {discriminator_key!r}') from e
+
+        if not is_literal_type(t_discriminator_type):
+            raise ConfigError(f'Field {discriminator_key!r} of model {tp.__name__!r} needs to be a `Literal`')
+
+        return tp.__fields__[discriminator_key].alias, all_literal_values(t_discriminator_type)
+
+
+def _get_union_alias_and_all_values(
+    union_type: Type[Any], discriminator_key: str
+) -> Tuple[str, Tuple[Tuple[str, ...], ...]]:
+    zipped_aliases_values = [get_discriminator_alias_and_values(t, discriminator_key) for t in get_args(union_type)]
+    # unzip: [('alias_a',('v1', 'v2)), ('alias_b', ('v3',))] => [('alias_a', 'alias_b'), (('v1', 'v2'), ('v3',))]
+    all_aliases, all_values = zip(*zipped_aliases_values)
+    return get_unique_discriminator_alias(all_aliases, discriminator_key), all_values
+
+
+KT = TypeVar('KT')
+VT = TypeVar('VT')
+if TYPE_CHECKING:
+    # Annoying inheriting from `MutableMapping` and `dict` breaks cython, hence this work around
+    class LimitedDict(dict, MutableMapping[KT, VT]):  # type: ignore[type-arg]
+        def __init__(self, size_limit: int = 1000):
+            ...
+
+else:
+
+    class LimitedDict(dict):
+        """
+        Limit the size/length of a dict used for caching to avoid unlimited increase in memory usage.
+
+        Since the dict is ordered, and we always remove elements from the beginning, this is effectively a FIFO cache.
+
+        Annoying inheriting from `MutableMapping` breaks cython.
+        """
+
+        def __init__(self, size_limit: int = 1000):
+            self.size_limit = size_limit
+            super().__init__()
+
+        def __setitem__(self, __key: Any, __value: Any) -> None:
+            super().__setitem__(__key, __value)
+            if len(self) > self.size_limit:
+                excess = len(self) - self.size_limit + self.size_limit // 10
+                to_remove = list(self.keys())[:excess]
+                for key in to_remove:
+                    del self[key]
+
+        def __class_getitem__(cls, *args: Any) -> Any:
+            # to avoid errors with 3.7
+            pass
diff --git a/lib/pydantic/validators.py b/lib/pydantic/validators.py
new file mode 100644
index 00000000..fb6d0418
--- /dev/null
+++ b/lib/pydantic/validators.py
@@ -0,0 +1,765 @@
+import math
+import re
+from collections import OrderedDict, deque
+from collections.abc import Hashable as CollectionsHashable
+from datetime import date, datetime, time, timedelta
+from decimal import Decimal, DecimalException
+from enum import Enum, IntEnum
+from ipaddress import IPv4Address, IPv4Interface, IPv4Network, IPv6Address, IPv6Interface, IPv6Network
+from pathlib import Path
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    Deque,
+    Dict,
+    ForwardRef,
+    FrozenSet,
+    Generator,
+    Hashable,
+    List,
+    NamedTuple,
+    Pattern,
+    Set,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+)
+from uuid import UUID
+
+from . import errors
+from .datetime_parse import parse_date, parse_datetime, parse_duration, parse_time
+from .typing import (
+    AnyCallable,
+    all_literal_values,
+    display_as_type,
+    get_class,
+    is_callable_type,
+    is_literal_type,
+    is_namedtuple,
+    is_none_type,
+    is_typeddict,
+)
+from .utils import almost_equal_floats, lenient_issubclass, sequence_like
+
+if TYPE_CHECKING:
+    from typing_extensions import Literal, TypedDict
+
+    from .config import BaseConfig
+    from .fields import ModelField
+    from .types import ConstrainedDecimal, ConstrainedFloat, ConstrainedInt
+
+    ConstrainedNumber = Union[ConstrainedDecimal, ConstrainedFloat, ConstrainedInt]
+    AnyOrderedDict = OrderedDict[Any, Any]
+    Number = Union[int, float, Decimal]
+    StrBytes = Union[str, bytes]
+
+
+def str_validator(v: Any) -> Union[str]:
+    if isinstance(v, str):
+        if isinstance(v, Enum):
+            return v.value
+        else:
+            return v
+    elif isinstance(v, (float, int, Decimal)):
+        # is there anything else we want to add here? If you think so, create an issue.
+        return str(v)
+    elif isinstance(v, (bytes, bytearray)):
+        return v.decode()
+    else:
+        raise errors.StrError()
+
+
+def strict_str_validator(v: Any) -> Union[str]:
+    if isinstance(v, str) and not isinstance(v, Enum):
+        return v
+    raise errors.StrError()
+
+
+def bytes_validator(v: Any) -> Union[bytes]:
+    if isinstance(v, bytes):
+        return v
+    elif isinstance(v, bytearray):
+        return bytes(v)
+    elif isinstance(v, str):
+        return v.encode()
+    elif isinstance(v, (float, int, Decimal)):
+        return str(v).encode()
+    else:
+        raise errors.BytesError()
+
+
+def strict_bytes_validator(v: Any) -> Union[bytes]:
+    if isinstance(v, bytes):
+        return v
+    elif isinstance(v, bytearray):
+        return bytes(v)
+    else:
+        raise errors.BytesError()
+
+
+BOOL_FALSE = {0, '0', 'off', 'f', 'false', 'n', 'no'}
+BOOL_TRUE = {1, '1', 'on', 't', 'true', 'y', 'yes'}
+
+
+def bool_validator(v: Any) -> bool:
+    if v is True or v is False:
+        return v
+    if isinstance(v, bytes):
+        v = v.decode()
+    if isinstance(v, str):
+        v = v.lower()
+    try:
+        if v in BOOL_TRUE:
+            return True
+        if v in BOOL_FALSE:
+            return False
+    except TypeError:
+        raise errors.BoolError()
+    raise errors.BoolError()
+
+
+# matches the default limit cpython, see https://github.com/python/cpython/pull/96500
+max_str_int = 4_300
+
+
+def int_validator(v: Any) -> int:
+    if isinstance(v, int) and not (v is True or v is False):
+        return v
+
+    # see https://github.com/pydantic/pydantic/issues/1477 and in turn, https://github.com/python/cpython/issues/95778
+    # this check should be unnecessary once patch releases are out for 3.7, 3.8, 3.9 and 3.10
+    # but better to check here until then.
+    # NOTICE: this does not fully protect user from the DOS risk since the standard library JSON implementation
+    # (and other std lib modules like xml) use `int()` and are likely called before this, the best workaround is to
+    # 1. update to the latest patch release of python once released, 2. use a different JSON library like ujson
+    if isinstance(v, (str, bytes, bytearray)) and len(v) > max_str_int:
+        raise errors.IntegerError()
+
+    try:
+        return int(v)
+    except (TypeError, ValueError, OverflowError):
+        raise errors.IntegerError()
+
+
+def strict_int_validator(v: Any) -> int:
+    if isinstance(v, int) and not (v is True or v is False):
+        return v
+    raise errors.IntegerError()
+
+
+def float_validator(v: Any) -> float:
+    if isinstance(v, float):
+        return v
+
+    try:
+        return float(v)
+    except (TypeError, ValueError):
+        raise errors.FloatError()
+
+
+def strict_float_validator(v: Any) -> float:
+    if isinstance(v, float):
+        return v
+    raise errors.FloatError()
+
+
+def float_finite_validator(v: 'Number', field: 'ModelField', config: 'BaseConfig') -> 'Number':
+    allow_inf_nan = getattr(field.type_, 'allow_inf_nan', None)
+    if allow_inf_nan is None:
+        allow_inf_nan = config.allow_inf_nan
+
+    if allow_inf_nan is False and (math.isnan(v) or math.isinf(v)):
+        raise errors.NumberNotFiniteError()
+    return v
+
+
+def number_multiple_validator(v: 'Number', field: 'ModelField') -> 'Number':
+    field_type: ConstrainedNumber = field.type_
+    if field_type.multiple_of is not None:
+        mod = float(v) / float(field_type.multiple_of) % 1
+        if not almost_equal_floats(mod, 0.0) and not almost_equal_floats(mod, 1.0):
+            raise errors.NumberNotMultipleError(multiple_of=field_type.multiple_of)
+    return v
+
+
+def number_size_validator(v: 'Number', field: 'ModelField') -> 'Number':
+    field_type: ConstrainedNumber = field.type_
+    if field_type.gt is not None and not v > field_type.gt:
+        raise errors.NumberNotGtError(limit_value=field_type.gt)
+    elif field_type.ge is not None and not v >= field_type.ge:
+        raise errors.NumberNotGeError(limit_value=field_type.ge)
+
+    if field_type.lt is not None and not v < field_type.lt:
+        raise errors.NumberNotLtError(limit_value=field_type.lt)
+    if field_type.le is not None and not v <= field_type.le:
+        raise errors.NumberNotLeError(limit_value=field_type.le)
+
+    return v
+
+
+def constant_validator(v: 'Any', field: 'ModelField') -> 'Any':
+    """Validate ``const`` fields.
+
+    The value provided for a ``const`` field must be equal to the default value
+    of the field. This is to support the keyword of the same name in JSON
+    Schema.
+    """
+    if v != field.default:
+        raise errors.WrongConstantError(given=v, permitted=[field.default])
+
+    return v
+
+
+def anystr_length_validator(v: 'StrBytes', config: 'BaseConfig') -> 'StrBytes':
+    v_len = len(v)
+
+    min_length = config.min_anystr_length
+    if v_len < min_length:
+        raise errors.AnyStrMinLengthError(limit_value=min_length)
+
+    max_length = config.max_anystr_length
+    if max_length is not None and v_len > max_length:
+        raise errors.AnyStrMaxLengthError(limit_value=max_length)
+
+    return v
+
+
+def anystr_strip_whitespace(v: 'StrBytes') -> 'StrBytes':
+    return v.strip()
+
+
+def anystr_upper(v: 'StrBytes') -> 'StrBytes':
+    return v.upper()
+
+
+def anystr_lower(v: 'StrBytes') -> 'StrBytes':
+    return v.lower()
+
+
+def ordered_dict_validator(v: Any) -> 'AnyOrderedDict':
+    if isinstance(v, OrderedDict):
+        return v
+
+    try:
+        return OrderedDict(v)
+    except (TypeError, ValueError):
+        raise errors.DictError()
+
+
+def dict_validator(v: Any) -> Dict[Any, Any]:
+    if isinstance(v, dict):
+        return v
+
+    try:
+        return dict(v)
+    except (TypeError, ValueError):
+        raise errors.DictError()
+
+
+def list_validator(v: Any) -> List[Any]:
+    if isinstance(v, list):
+        return v
+    elif sequence_like(v):
+        return list(v)
+    else:
+        raise errors.ListError()
+
+
+def tuple_validator(v: Any) -> Tuple[Any, ...]:
+    if isinstance(v, tuple):
+        return v
+    elif sequence_like(v):
+        return tuple(v)
+    else:
+        raise errors.TupleError()
+
+
+def set_validator(v: Any) -> Set[Any]:
+    if isinstance(v, set):
+        return v
+    elif sequence_like(v):
+        return set(v)
+    else:
+        raise errors.SetError()
+
+
+def frozenset_validator(v: Any) -> FrozenSet[Any]:
+    if isinstance(v, frozenset):
+        return v
+    elif sequence_like(v):
+        return frozenset(v)
+    else:
+        raise errors.FrozenSetError()
+
+
+def deque_validator(v: Any) -> Deque[Any]:
+    if isinstance(v, deque):
+        return v
+    elif sequence_like(v):
+        return deque(v)
+    else:
+        raise errors.DequeError()
+
+
+def enum_member_validator(v: Any, field: 'ModelField', config: 'BaseConfig') -> Enum:
+    try:
+        enum_v = field.type_(v)
+    except ValueError:
+        # field.type_ should be an enum, so will be iterable
+        raise errors.EnumMemberError(enum_values=list(field.type_))
+    return enum_v.value if config.use_enum_values else enum_v
+
+
+def uuid_validator(v: Any, field: 'ModelField') -> UUID:
+    try:
+        if isinstance(v, str):
+            v = UUID(v)
+        elif isinstance(v, (bytes, bytearray)):
+            try:
+                v = UUID(v.decode())
+            except ValueError:
+                # 16 bytes in big-endian order as the bytes argument fail
+                # the above check
+                v = UUID(bytes=v)
+    except ValueError:
+        raise errors.UUIDError()
+
+    if not isinstance(v, UUID):
+        raise errors.UUIDError()
+
+    required_version = getattr(field.type_, '_required_version', None)
+    if required_version and v.version != required_version:
+        raise errors.UUIDVersionError(required_version=required_version)
+
+    return v
+
+
+def decimal_validator(v: Any) -> Decimal:
+    if isinstance(v, Decimal):
+        return v
+    elif isinstance(v, (bytes, bytearray)):
+        v = v.decode()
+
+    v = str(v).strip()
+
+    try:
+        v = Decimal(v)
+    except DecimalException:
+        raise errors.DecimalError()
+
+    if not v.is_finite():
+        raise errors.DecimalIsNotFiniteError()
+
+    return v
+
+
+def hashable_validator(v: Any) -> Hashable:
+    if isinstance(v, Hashable):
+        return v
+
+    raise errors.HashableError()
+
+
+def ip_v4_address_validator(v: Any) -> IPv4Address:
+    if isinstance(v, IPv4Address):
+        return v
+
+    try:
+        return IPv4Address(v)
+    except ValueError:
+        raise errors.IPv4AddressError()
+
+
+def ip_v6_address_validator(v: Any) -> IPv6Address:
+    if isinstance(v, IPv6Address):
+        return v
+
+    try:
+        return IPv6Address(v)
+    except ValueError:
+        raise errors.IPv6AddressError()
+
+
+def ip_v4_network_validator(v: Any) -> IPv4Network:
+    """
+    Assume IPv4Network initialised with a default ``strict`` argument
+
+    See more:
+    https://docs.python.org/library/ipaddress.html#ipaddress.IPv4Network
+    """
+    if isinstance(v, IPv4Network):
+        return v
+
+    try:
+        return IPv4Network(v)
+    except ValueError:
+        raise errors.IPv4NetworkError()
+
+
+def ip_v6_network_validator(v: Any) -> IPv6Network:
+    """
+    Assume IPv6Network initialised with a default ``strict`` argument
+
+    See more:
+    https://docs.python.org/library/ipaddress.html#ipaddress.IPv6Network
+    """
+    if isinstance(v, IPv6Network):
+        return v
+
+    try:
+        return IPv6Network(v)
+    except ValueError:
+        raise errors.IPv6NetworkError()
+
+
+def ip_v4_interface_validator(v: Any) -> IPv4Interface:
+    if isinstance(v, IPv4Interface):
+        return v
+
+    try:
+        return IPv4Interface(v)
+    except ValueError:
+        raise errors.IPv4InterfaceError()
+
+
+def ip_v6_interface_validator(v: Any) -> IPv6Interface:
+    if isinstance(v, IPv6Interface):
+        return v
+
+    try:
+        return IPv6Interface(v)
+    except ValueError:
+        raise errors.IPv6InterfaceError()
+
+
+def path_validator(v: Any) -> Path:
+    if isinstance(v, Path):
+        return v
+
+    try:
+        return Path(v)
+    except TypeError:
+        raise errors.PathError()
+
+
+def path_exists_validator(v: Any) -> Path:
+    if not v.exists():
+        raise errors.PathNotExistsError(path=v)
+
+    return v
+
+
+def callable_validator(v: Any) -> AnyCallable:
+    """
+    Perform a simple check if the value is callable.
+
+    Note: complete matching of argument type hints and return types is not performed
+    """
+    if callable(v):
+        return v
+
+    raise errors.CallableError(value=v)
+
+
+def enum_validator(v: Any) -> Enum:
+    if isinstance(v, Enum):
+        return v
+
+    raise errors.EnumError(value=v)
+
+
+def int_enum_validator(v: Any) -> IntEnum:
+    if isinstance(v, IntEnum):
+        return v
+
+    raise errors.IntEnumError(value=v)
+
+
+def make_literal_validator(type_: Any) -> Callable[[Any], Any]:
+    permitted_choices = all_literal_values(type_)
+
+    # To have a O(1) complexity and still return one of the values set inside the `Literal`,
+    # we create a dict with the set values (a set causes some problems with the way intersection works).
+    # In some cases the set value and checked value can indeed be different (see `test_literal_validator_str_enum`)
+    allowed_choices = {v: v for v in permitted_choices}
+
+    def literal_validator(v: Any) -> Any:
+        try:
+            return allowed_choices[v]
+        except KeyError:
+            raise errors.WrongConstantError(given=v, permitted=permitted_choices)
+
+    return literal_validator
+
+
+def constr_length_validator(v: 'StrBytes', field: 'ModelField', config: 'BaseConfig') -> 'StrBytes':
+    v_len = len(v)
+
+    min_length = field.type_.min_length if field.type_.min_length is not None else config.min_anystr_length
+    if v_len < min_length:
+        raise errors.AnyStrMinLengthError(limit_value=min_length)
+
+    max_length = field.type_.max_length if field.type_.max_length is not None else config.max_anystr_length
+    if max_length is not None and v_len > max_length:
+        raise errors.AnyStrMaxLengthError(limit_value=max_length)
+
+    return v
+
+
+def constr_strip_whitespace(v: 'StrBytes', field: 'ModelField', config: 'BaseConfig') -> 'StrBytes':
+    strip_whitespace = field.type_.strip_whitespace or config.anystr_strip_whitespace
+    if strip_whitespace:
+        v = v.strip()
+
+    return v
+
+
+def constr_upper(v: 'StrBytes', field: 'ModelField', config: 'BaseConfig') -> 'StrBytes':
+    upper = field.type_.to_upper or config.anystr_upper
+    if upper:
+        v = v.upper()
+
+    return v
+
+
+def constr_lower(v: 'StrBytes', field: 'ModelField', config: 'BaseConfig') -> 'StrBytes':
+    lower = field.type_.to_lower or config.anystr_lower
+    if lower:
+        v = v.lower()
+    return v
+
+
+def validate_json(v: Any, config: 'BaseConfig') -> Any:
+    if v is None:
+        # pass None through to other validators
+        return v
+    try:
+        return config.json_loads(v)  # type: ignore
+    except ValueError:
+        raise errors.JsonError()
+    except TypeError:
+        raise errors.JsonTypeError()
+
+
+T = TypeVar('T')
+
+
+def make_arbitrary_type_validator(type_: Type[T]) -> Callable[[T], T]:
+    def arbitrary_type_validator(v: Any) -> T:
+        if isinstance(v, type_):
+            return v
+        raise errors.ArbitraryTypeError(expected_arbitrary_type=type_)
+
+    return arbitrary_type_validator
+
+
+def make_class_validator(type_: Type[T]) -> Callable[[Any], Type[T]]:
+    def class_validator(v: Any) -> Type[T]:
+        if lenient_issubclass(v, type_):
+            return v
+        raise errors.SubclassError(expected_class=type_)
+
+    return class_validator
+
+
+def any_class_validator(v: Any) -> Type[T]:
+    if isinstance(v, type):
+        return v
+    raise errors.ClassError()
+
+
+def none_validator(v: Any) -> 'Literal[None]':
+    if v is None:
+        return v
+    raise errors.NotNoneError()
+
+
+def pattern_validator(v: Any) -> Pattern[str]:
+    if isinstance(v, Pattern):
+        return v
+
+    str_value = str_validator(v)
+
+    try:
+        return re.compile(str_value)
+    except re.error:
+        raise errors.PatternError()
+
+
+NamedTupleT = TypeVar('NamedTupleT', bound=NamedTuple)
+
+
+def make_namedtuple_validator(
+    namedtuple_cls: Type[NamedTupleT], config: Type['BaseConfig']
+) -> Callable[[Tuple[Any, ...]], NamedTupleT]:
+    from .annotated_types import create_model_from_namedtuple
+
+    NamedTupleModel = create_model_from_namedtuple(
+        namedtuple_cls,
+        __config__=config,
+        __module__=namedtuple_cls.__module__,
+    )
+    namedtuple_cls.__pydantic_model__ = NamedTupleModel  # type: ignore[attr-defined]
+
+    def namedtuple_validator(values: Tuple[Any, ...]) -> NamedTupleT:
+        annotations = NamedTupleModel.__annotations__
+
+        if len(values) > len(annotations):
+            raise errors.ListMaxLengthError(limit_value=len(annotations))
+
+        dict_values: Dict[str, Any] = dict(zip(annotations, values))
+        validated_dict_values: Dict[str, Any] = dict(NamedTupleModel(**dict_values))
+        return namedtuple_cls(**validated_dict_values)
+
+    return namedtuple_validator
+
+
+def make_typeddict_validator(
+    typeddict_cls: Type['TypedDict'], config: Type['BaseConfig']  # type: ignore[valid-type]
+) -> Callable[[Any], Dict[str, Any]]:
+    from .annotated_types import create_model_from_typeddict
+
+    TypedDictModel = create_model_from_typeddict(
+        typeddict_cls,
+        __config__=config,
+        __module__=typeddict_cls.__module__,
+    )
+    typeddict_cls.__pydantic_model__ = TypedDictModel  # type: ignore[attr-defined]
+
+    def typeddict_validator(values: 'TypedDict') -> Dict[str, Any]:  # type: ignore[valid-type]
+        return TypedDictModel.parse_obj(values).dict(exclude_unset=True)
+
+    return typeddict_validator
+
+
+class IfConfig:
+    def __init__(self, validator: AnyCallable, *config_attr_names: str, ignored_value: Any = False) -> None:
+        self.validator = validator
+        self.config_attr_names = config_attr_names
+        self.ignored_value = ignored_value
+
+    def check(self, config: Type['BaseConfig']) -> bool:
+        return any(getattr(config, name) not in {None, self.ignored_value} for name in self.config_attr_names)
+
+
+# order is important here, for example: bool is a subclass of int so has to come first, datetime before date same,
+# IPv4Interface before IPv4Address, etc
+_VALIDATORS: List[Tuple[Type[Any], List[Any]]] = [
+    (IntEnum, [int_validator, enum_member_validator]),
+    (Enum, [enum_member_validator]),
+    (
+        str,
+        [
+            str_validator,
+            IfConfig(anystr_strip_whitespace, 'anystr_strip_whitespace'),
+            IfConfig(anystr_upper, 'anystr_upper'),
+            IfConfig(anystr_lower, 'anystr_lower'),
+            IfConfig(anystr_length_validator, 'min_anystr_length', 'max_anystr_length'),
+        ],
+    ),
+    (
+        bytes,
+        [
+            bytes_validator,
+            IfConfig(anystr_strip_whitespace, 'anystr_strip_whitespace'),
+            IfConfig(anystr_upper, 'anystr_upper'),
+            IfConfig(anystr_lower, 'anystr_lower'),
+            IfConfig(anystr_length_validator, 'min_anystr_length', 'max_anystr_length'),
+        ],
+    ),
+    (bool, [bool_validator]),
+    (int, [int_validator]),
+    (float, [float_validator, IfConfig(float_finite_validator, 'allow_inf_nan', ignored_value=True)]),
+    (Path, [path_validator]),
+    (datetime, [parse_datetime]),
+    (date, [parse_date]),
+    (time, [parse_time]),
+    (timedelta, [parse_duration]),
+    (OrderedDict, [ordered_dict_validator]),
+    (dict, [dict_validator]),
+    (list, [list_validator]),
+    (tuple, [tuple_validator]),
+    (set, [set_validator]),
+    (frozenset, [frozenset_validator]),
+    (deque, [deque_validator]),
+    (UUID, [uuid_validator]),
+    (Decimal, [decimal_validator]),
+    (IPv4Interface, [ip_v4_interface_validator]),
+    (IPv6Interface, [ip_v6_interface_validator]),
+    (IPv4Address, [ip_v4_address_validator]),
+    (IPv6Address, [ip_v6_address_validator]),
+    (IPv4Network, [ip_v4_network_validator]),
+    (IPv6Network, [ip_v6_network_validator]),
+]
+
+
+def find_validators(  # noqa: C901 (ignore complexity)
+    type_: Type[Any], config: Type['BaseConfig']
+) -> Generator[AnyCallable, None, None]:
+    from .dataclasses import is_builtin_dataclass, make_dataclass_validator
+
+    if type_ is Any or type_ is object:
+        return
+    type_type = type_.__class__
+    if type_type == ForwardRef or type_type == TypeVar:
+        return
+
+    if is_none_type(type_):
+        yield none_validator
+        return
+    if type_ is Pattern or type_ is re.Pattern:
+        yield pattern_validator
+        return
+    if type_ is Hashable or type_ is CollectionsHashable:
+        yield hashable_validator
+        return
+    if is_callable_type(type_):
+        yield callable_validator
+        return
+    if is_literal_type(type_):
+        yield make_literal_validator(type_)
+        return
+    if is_builtin_dataclass(type_):
+        yield from make_dataclass_validator(type_, config)
+        return
+    if type_ is Enum:
+        yield enum_validator
+        return
+    if type_ is IntEnum:
+        yield int_enum_validator
+        return
+    if is_namedtuple(type_):
+        yield tuple_validator
+        yield make_namedtuple_validator(type_, config)
+        return
+    if is_typeddict(type_):
+        yield make_typeddict_validator(type_, config)
+        return
+
+    class_ = get_class(type_)
+    if class_ is not None:
+        if class_ is not Any and isinstance(class_, type):
+            yield make_class_validator(class_)
+        else:
+            yield any_class_validator
+        return
+
+    for val_type, validators in _VALIDATORS:
+        try:
+            if issubclass(type_, val_type):
+                for v in validators:
+                    if isinstance(v, IfConfig):
+                        if v.check(config):
+                            yield v.validator
+                    else:
+                        yield v
+                return
+        except TypeError:
+            raise RuntimeError(f'error checking inheritance of {type_!r} (type: {display_as_type(type_)})')
+
+    if config.arbitrary_types_allowed:
+        yield make_arbitrary_type_validator(type_)
+    else:
+        raise RuntimeError(f'no validator found for {type_}, see `arbitrary_types_allowed` in Config')
diff --git a/lib/pydantic/version.py b/lib/pydantic/version.py
new file mode 100644
index 00000000..32c61633
--- /dev/null
+++ b/lib/pydantic/version.py
@@ -0,0 +1,38 @@
+__all__ = 'compiled', 'VERSION', 'version_info'
+
+VERSION = '1.10.2'
+
+try:
+    import cython  # type: ignore
+except ImportError:
+    compiled: bool = False
+else:  # pragma: no cover
+    try:
+        compiled = cython.compiled
+    except AttributeError:
+        compiled = False
+
+
+def version_info() -> str:
+    import platform
+    import sys
+    from importlib import import_module
+    from pathlib import Path
+
+    optional_deps = []
+    for p in ('devtools', 'dotenv', 'email-validator', 'typing-extensions'):
+        try:
+            import_module(p.replace('-', '_'))
+        except ImportError:
+            continue
+        optional_deps.append(p)
+
+    info = {
+        'pydantic version': VERSION,
+        'pydantic compiled': compiled,
+        'install path': Path(__file__).resolve().parent,
+        'python version': sys.version,
+        'platform': platform.platform(),
+        'optional deps. installed': optional_deps,
+    }
+    return '\n'.join('{:>30} {}'.format(k + ':', str(v).replace('\n', ' ')) for k, v in info.items())
diff --git a/lib/typing_extensions.py b/lib/typing_extensions.py
index 9f1c7aa3..ef42417c 100644
--- a/lib/typing_extensions.py
+++ b/lib/typing_extensions.py
@@ -1,52 +1,28 @@
 import abc
 import collections
 import collections.abc
+import functools
 import operator
 import sys
+import types as _types
 import typing
 
-# After PEP 560, internal typing API was substantially reworked.
-# This is especially important for Protocol class which uses internal APIs
-# quite extensively.
-PEP_560 = sys.version_info[:3] >= (3, 7, 0)
 
-if PEP_560:
-    GenericMeta = type
-else:
-    # 3.6
-    from typing import GenericMeta, _type_vars  # noqa
-
-# The two functions below are copies of typing internal helpers.
-# They are needed by _ProtocolMeta
-
-
-def _no_slots_copy(dct):
-    dict_copy = dict(dct)
-    if '__slots__' in dict_copy:
-        for slot in dict_copy['__slots__']:
-            dict_copy.pop(slot, None)
-    return dict_copy
-
-
-def _check_generic(cls, parameters):
-    if not cls.__parameters__:
-        raise TypeError(f"{cls} is not a generic class")
-    alen = len(parameters)
-    elen = len(cls.__parameters__)
-    if alen != elen:
-        raise TypeError(f"Too {'many' if alen > elen else 'few'} arguments for {cls};"
-                        f" actual {alen}, expected {elen}")
-
-
-# Please keep __all__ alphabetized within each category.
 __all__ = [
     # Super-special typing primitives.
+    'Any',
     'ClassVar',
     'Concatenate',
     'Final',
+    'LiteralString',
     'ParamSpec',
+    'ParamSpecArgs',
+    'ParamSpecKwargs',
     'Self',
     'Type',
+    'TypeVar',
+    'TypeVarTuple',
+    'Unpack',
 
     # ABCs (from collections.abc).
     'Awaitable',
@@ -62,6 +38,7 @@ __all__ = [
     'Counter',
     'Deque',
     'DefaultDict',
+    'NamedTuple',
     'OrderedDict',
     'TypedDict',
 
@@ -70,49 +47,101 @@ __all__ = [
 
     # One-off things.
     'Annotated',
+    'assert_never',
+    'assert_type',
+    'clear_overloads',
+    'dataclass_transform',
+    'get_overloads',
     'final',
+    'get_args',
+    'get_origin',
+    'get_type_hints',
     'IntVar',
+    'is_typeddict',
     'Literal',
     'NewType',
     'overload',
+    'override',
     'Protocol',
+    'reveal_type',
     'runtime',
     'runtime_checkable',
     'Text',
     'TypeAlias',
     'TypeGuard',
     'TYPE_CHECKING',
+    'Never',
+    'NoReturn',
+    'Required',
+    'NotRequired',
 ]
 
-if PEP_560:
-    __all__.extend(["get_args", "get_origin", "get_type_hints"])
+# for backward compatibility
+PEP_560 = True
+GenericMeta = type
 
-# 3.6.2+
-if hasattr(typing, 'NoReturn'):
-    NoReturn = typing.NoReturn
-# 3.6.0-3.6.1
+# The functions below are modified copies of typing internal helpers.
+# They are needed by _ProtocolMeta and they provide support for PEP 646.
+
+_marker = object()
+
+
+def _check_generic(cls, parameters, elen=_marker):
+    """Check correct count for parameters of a generic cls (internal helper).
+    This gives a nice error message in case of count mismatch.
+    """
+    if not elen:
+        raise TypeError(f"{cls} is not a generic class")
+    if elen is _marker:
+        if not hasattr(cls, "__parameters__") or not cls.__parameters__:
+            raise TypeError(f"{cls} is not a generic class")
+        elen = len(cls.__parameters__)
+    alen = len(parameters)
+    if alen != elen:
+        if hasattr(cls, "__parameters__"):
+            parameters = [p for p in cls.__parameters__ if not _is_unpack(p)]
+            num_tv_tuples = sum(isinstance(p, TypeVarTuple) for p in parameters)
+            if (num_tv_tuples > 0) and (alen >= elen - num_tv_tuples):
+                return
+        raise TypeError(f"Too {'many' if alen > elen else 'few'} parameters for {cls};"
+                        f" actual {alen}, expected {elen}")
+
+
+if sys.version_info >= (3, 10):
+    def _should_collect_from_parameters(t):
+        return isinstance(
+            t, (typing._GenericAlias, _types.GenericAlias, _types.UnionType)
+        )
+elif sys.version_info >= (3, 9):
+    def _should_collect_from_parameters(t):
+        return isinstance(t, (typing._GenericAlias, _types.GenericAlias))
 else:
-    class _NoReturn(typing._FinalTypingBase, _root=True):
-        """Special type indicating functions that never return.
-        Example::
+    def _should_collect_from_parameters(t):
+        return isinstance(t, typing._GenericAlias) and not t._special
 
-          from typing import NoReturn
 
-          def stop() -> NoReturn:
-              raise Exception('no way')
+def _collect_type_vars(types, typevar_types=None):
+    """Collect all type variable contained in types in order of
+    first appearance (lexicographic order). For example::
 
-        This type is invalid in other positions, e.g., ``List[NoReturn]``
-        will fail in static type checkers.
-        """
-        __slots__ = ()
+        _collect_type_vars((T, List[S, T])) == (T, S)
+    """
+    if typevar_types is None:
+        typevar_types = typing.TypeVar
+    tvars = []
+    for t in types:
+        if (
+            isinstance(t, typevar_types) and
+            t not in tvars and
+            not _is_unpack(t)
+        ):
+            tvars.append(t)
+        if _should_collect_from_parameters(t):
+            tvars.extend([t for t in t.__parameters__ if t not in tvars])
+    return tuple(tvars)
 
-        def __instancecheck__(self, obj):
-            raise TypeError("NoReturn cannot be used with isinstance().")
 
-        def __subclasscheck__(self, cls):
-            raise TypeError("NoReturn cannot be used with issubclass().")
-
-    NoReturn = _NoReturn(_root=True)
+NoReturn = typing.NoReturn
 
 # Some unconstrained type variables.  These are used by the container types.
 # (These are not for export.)
@@ -122,6 +151,37 @@ VT = typing.TypeVar('VT')  # Value type.
 T_co = typing.TypeVar('T_co', covariant=True)  # Any type covariant containers.
 T_contra = typing.TypeVar('T_contra', contravariant=True)  # Ditto contravariant.
 
+
+if sys.version_info >= (3, 11):
+    from typing import Any
+else:
+
+    class _AnyMeta(type):
+        def __instancecheck__(self, obj):
+            if self is Any:
+                raise TypeError("typing_extensions.Any cannot be used with isinstance()")
+            return super().__instancecheck__(obj)
+
+        def __repr__(self):
+            if self is Any:
+                return "typing_extensions.Any"
+            return super().__repr__()
+
+    class Any(metaclass=_AnyMeta):
+        """Special type indicating an unconstrained type.
+        - Any is compatible with every type.
+        - Any assumed to have all methods.
+        - All values assumed to be instances of Any.
+        Note that all the above statements are true from the point of view of
+        static type checkers. At runtime, Any should not be used with instance
+        checks.
+        """
+        def __new__(cls, *args, **kwargs):
+            if cls is Any:
+                raise TypeError("Any cannot be instantiated")
+            return super().__new__(cls, *args, **kwargs)
+
+
 ClassVar = typing.ClassVar
 
 # On older versions of typing there is an internal class named "Final".
@@ -129,7 +189,7 @@ ClassVar = typing.ClassVar
 if hasattr(typing, 'Final') and sys.version_info[:2] >= (3, 7):
     Final = typing.Final
 # 3.7
-elif sys.version_info[:2] >= (3, 7):
+else:
     class _FinalForm(typing._SpecialForm, _root=True):
 
         def __repr__(self):
@@ -137,7 +197,7 @@ elif sys.version_info[:2] >= (3, 7):
 
         def __getitem__(self, parameters):
             item = typing._type_check(parameters,
-                                      f'{self._name} accepts only single type')
+                                      f'{self._name} accepts only a single type.')
             return typing._GenericAlias(self, (item,))
 
     Final = _FinalForm('Final',
@@ -154,67 +214,13 @@ elif sys.version_info[:2] >= (3, 7):
                                TIMEOUT = 1  # Error reported by type checker
 
                        There is no runtime checking of these properties.""")
-# 3.6
-else:
-    class _Final(typing._FinalTypingBase, _root=True):
-        """A special typing construct to indicate that a name
-        cannot be re-assigned or overridden in a subclass.
-        For example:
 
-            MAX_SIZE: Final = 9000
-            MAX_SIZE += 1  # Error reported by type checker
-
-            class Connection:
-                TIMEOUT: Final[int] = 10
-            class FastConnector(Connection):
-                TIMEOUT = 1  # Error reported by type checker
-
-        There is no runtime checking of these properties.
-        """
-
-        __slots__ = ('__type__',)
-
-        def __init__(self, tp=None, **kwds):
-            self.__type__ = tp
-
-        def __getitem__(self, item):
-            cls = type(self)
-            if self.__type__ is None:
-                return cls(typing._type_check(item,
-                           f'{cls.__name__[1:]} accepts only single type.'),
-                           _root=True)
-            raise TypeError(f'{cls.__name__[1:]} cannot be further subscripted')
-
-        def _eval_type(self, globalns, localns):
-            new_tp = typing._eval_type(self.__type__, globalns, localns)
-            if new_tp == self.__type__:
-                return self
-            return type(self)(new_tp, _root=True)
-
-        def __repr__(self):
-            r = super().__repr__()
-            if self.__type__ is not None:
-                r += f'[{typing._type_repr(self.__type__)}]'
-            return r
-
-        def __hash__(self):
-            return hash((type(self).__name__, self.__type__))
-
-        def __eq__(self, other):
-            if not isinstance(other, _Final):
-                return NotImplemented
-            if self.__type__ is not None:
-                return self.__type__ == other.__type__
-            return self is other
-
-    Final = _Final(_root=True)
-
-
-# 3.8+
-if hasattr(typing, 'final'):
+if sys.version_info >= (3, 11):
     final = typing.final
-# 3.6-3.7
 else:
+    # @final exists in 3.8+, but we backport it for all versions
+    # before 3.11 to keep support for the __final__ attribute.
+    # See https://bugs.python.org/issue46342
     def final(f):
         """This decorator can be used to indicate to type checkers that
         the decorated method cannot be overridden, and decorated class
@@ -233,8 +239,17 @@ else:
             class Other(Leaf):  # Error reported by type checker
                 ...
 
-        There is no runtime checking of these properties.
+        There is no runtime checking of these properties. The decorator
+        sets the ``__final__`` attribute to ``True`` on the decorated object
+        to allow runtime introspection.
         """
+        try:
+            f.__final__ = True
+        except (AttributeError, TypeError):
+            # Skip the attribute silently if it is not writable.
+            # AttributeError happens if the object has __slots__ or a
+            # read-only property, TypeError if it's a builtin class.
+            pass
         return f
 
 
@@ -246,7 +261,7 @@ def IntVar(name):
 if hasattr(typing, 'Literal'):
     Literal = typing.Literal
 # 3.7:
-elif sys.version_info[:2] >= (3, 7):
+else:
     class _LiteralForm(typing._SpecialForm, _root=True):
 
         def __repr__(self):
@@ -268,59 +283,75 @@ elif sys.version_info[:2] >= (3, 7):
                            Literal[...] cannot be subclassed. There is no runtime
                            checking verifying that the parameter is actually a value
                            instead of a type.""")
-# 3.6:
-else:
-    class _Literal(typing._FinalTypingBase, _root=True):
-        """A type that can be used to indicate to type checkers that the
-        corresponding value has a value literally equivalent to the
-        provided parameter. For example:
-
-            var: Literal[4] = 4
-
-        The type checker understands that 'var' is literally equal to the
-        value 4 and no other value.
-
-        Literal[...] cannot be subclassed. There is no runtime checking
-        verifying that the parameter is actually a value instead of a type.
-        """
-
-        __slots__ = ('__values__',)
-
-        def __init__(self, values=None, **kwds):
-            self.__values__ = values
-
-        def __getitem__(self, values):
-            cls = type(self)
-            if self.__values__ is None:
-                if not isinstance(values, tuple):
-                    values = (values,)
-                return cls(values, _root=True)
-            raise TypeError(f'{cls.__name__[1:]} cannot be further subscripted')
-
-        def _eval_type(self, globalns, localns):
-            return self
-
-        def __repr__(self):
-            r = super().__repr__()
-            if self.__values__ is not None:
-                r += f'[{", ".join(map(typing._type_repr, self.__values__))}]'
-            return r
-
-        def __hash__(self):
-            return hash((type(self).__name__, self.__values__))
-
-        def __eq__(self, other):
-            if not isinstance(other, _Literal):
-                return NotImplemented
-            if self.__values__ is not None:
-                return self.__values__ == other.__values__
-            return self is other
-
-    Literal = _Literal(_root=True)
 
 
 _overload_dummy = typing._overload_dummy  # noqa
-overload = typing.overload
+
+
+if hasattr(typing, "get_overloads"):  # 3.11+
+    overload = typing.overload
+    get_overloads = typing.get_overloads
+    clear_overloads = typing.clear_overloads
+else:
+    # {module: {qualname: {firstlineno: func}}}
+    _overload_registry = collections.defaultdict(
+        functools.partial(collections.defaultdict, dict)
+    )
+
+    def overload(func):
+        """Decorator for overloaded functions/methods.
+
+        In a stub file, place two or more stub definitions for the same
+        function in a row, each decorated with @overload.  For example:
+
+        @overload
+        def utf8(value: None) -> None: ...
+        @overload
+        def utf8(value: bytes) -> bytes: ...
+        @overload
+        def utf8(value: str) -> bytes: ...
+
+        In a non-stub file (i.e. a regular .py file), do the same but
+        follow it with an implementation.  The implementation should *not*
+        be decorated with @overload.  For example:
+
+        @overload
+        def utf8(value: None) -> None: ...
+        @overload
+        def utf8(value: bytes) -> bytes: ...
+        @overload
+        def utf8(value: str) -> bytes: ...
+        def utf8(value):
+            # implementation goes here
+
+        The overloads for a function can be retrieved at runtime using the
+        get_overloads() function.
+        """
+        # classmethod and staticmethod
+        f = getattr(func, "__func__", func)
+        try:
+            _overload_registry[f.__module__][f.__qualname__][
+                f.__code__.co_firstlineno
+            ] = func
+        except AttributeError:
+            # Not a normal function; ignore.
+            pass
+        return _overload_dummy
+
+    def get_overloads(func):
+        """Return all defined overloads for *func* as a sequence."""
+        # classmethod and staticmethod
+        f = getattr(func, "__func__", func)
+        if f.__module__ not in _overload_registry:
+            return []
+        mod_dict = _overload_registry[f.__module__]
+        if f.__qualname__ not in mod_dict:
+            return []
+        return list(mod_dict[f.__qualname__].values())
+
+    def clear_overloads():
+        """Clear all overloads in the registry."""
+        _overload_registry.clear()
 
 
 # This is not a real generic class.  Don't use outside annotations.
@@ -330,154 +361,30 @@ Type = typing.Type
 # A few are simply re-exported for completeness.
 
 
-class _ExtensionsGenericMeta(GenericMeta):
-    def __subclasscheck__(self, subclass):
-        """This mimics a more modern GenericMeta.__subclasscheck__() logic
-        (that does not have problems with recursion) to work around interactions
-        between collections, typing, and typing_extensions on older
-        versions of Python, see https://github.com/python/typing/issues/501.
-        """
-        if self.__origin__ is not None:
-            if sys._getframe(1).f_globals['__name__'] not in ['abc', 'functools']:
-                raise TypeError("Parameterized generics cannot be used with class "
-                                "or instance checks")
-            return False
-        if not self.__extra__:
-            return super().__subclasscheck__(subclass)
-        res = self.__extra__.__subclasshook__(subclass)
-        if res is not NotImplemented:
-            return res
-        if self.__extra__ in subclass.__mro__:
-            return True
-        for scls in self.__extra__.__subclasses__():
-            if isinstance(scls, GenericMeta):
-                continue
-            if issubclass(subclass, scls):
-                return True
-        return False
-
-
 Awaitable = typing.Awaitable
 Coroutine = typing.Coroutine
 AsyncIterable = typing.AsyncIterable
 AsyncIterator = typing.AsyncIterator
-
-# 3.6.1+
-if hasattr(typing, 'Deque'):
-    Deque = typing.Deque
-# 3.6.0
-else:
-    class Deque(collections.deque, typing.MutableSequence[T],
-                metaclass=_ExtensionsGenericMeta,
-                extra=collections.deque):
-        __slots__ = ()
-
-        def __new__(cls, *args, **kwds):
-            if cls._gorg is Deque:
-                return collections.deque(*args, **kwds)
-            return typing._generic_new(collections.deque, cls, *args, **kwds)
-
+Deque = typing.Deque
 ContextManager = typing.ContextManager
-# 3.6.2+
-if hasattr(typing, 'AsyncContextManager'):
-    AsyncContextManager = typing.AsyncContextManager
-# 3.6.0-3.6.1
-else:
-    from _collections_abc import _check_methods as _check_methods_in_mro  # noqa
-
-    class AsyncContextManager(typing.Generic[T_co]):
-        __slots__ = ()
-
-        async def __aenter__(self):
-            return self
-
-        @abc.abstractmethod
-        async def __aexit__(self, exc_type, exc_value, traceback):
-            return None
-
-        @classmethod
-        def __subclasshook__(cls, C):
-            if cls is AsyncContextManager:
-                return _check_methods_in_mro(C, "__aenter__", "__aexit__")
-            return NotImplemented
-
+AsyncContextManager = typing.AsyncContextManager
 DefaultDict = typing.DefaultDict
 
 # 3.7.2+
 if hasattr(typing, 'OrderedDict'):
     OrderedDict = typing.OrderedDict
 # 3.7.0-3.7.2
-elif (3, 7, 0) <= sys.version_info[:3] < (3, 7, 2):
+else:
     OrderedDict = typing._alias(collections.OrderedDict, (KT, VT))
-# 3.6
-else:
-    class OrderedDict(collections.OrderedDict, typing.MutableMapping[KT, VT],
-                      metaclass=_ExtensionsGenericMeta,
-                      extra=collections.OrderedDict):
-
-        __slots__ = ()
-
-        def __new__(cls, *args, **kwds):
-            if cls._gorg is OrderedDict:
-                return collections.OrderedDict(*args, **kwds)
-            return typing._generic_new(collections.OrderedDict, cls, *args, **kwds)
-
-# 3.6.2+
-if hasattr(typing, 'Counter'):
-    Counter = typing.Counter
-# 3.6.0-3.6.1
-else:
-    class Counter(collections.Counter,
-                  typing.Dict[T, int],
-                  metaclass=_ExtensionsGenericMeta, extra=collections.Counter):
-
-        __slots__ = ()
-
-        def __new__(cls, *args, **kwds):
-            if cls._gorg is Counter:
-                return collections.Counter(*args, **kwds)
-            return typing._generic_new(collections.Counter, cls, *args, **kwds)
-
-# 3.6.1+
-if hasattr(typing, 'ChainMap'):
-    ChainMap = typing.ChainMap
-elif hasattr(collections, 'ChainMap'):
-    class ChainMap(collections.ChainMap, typing.MutableMapping[KT, VT],
-                   metaclass=_ExtensionsGenericMeta,
-                   extra=collections.ChainMap):
-
-        __slots__ = ()
-
-        def __new__(cls, *args, **kwds):
-            if cls._gorg is ChainMap:
-                return collections.ChainMap(*args, **kwds)
-            return typing._generic_new(collections.ChainMap, cls, *args, **kwds)
-
-# 3.6.1+
-if hasattr(typing, 'AsyncGenerator'):
-    AsyncGenerator = typing.AsyncGenerator
-# 3.6.0
-else:
-    class AsyncGenerator(AsyncIterator[T_co], typing.Generic[T_co, T_contra],
-                         metaclass=_ExtensionsGenericMeta,
-                         extra=collections.abc.AsyncGenerator):
-        __slots__ = ()
 
+Counter = typing.Counter
+ChainMap = typing.ChainMap
+AsyncGenerator = typing.AsyncGenerator
 NewType = typing.NewType
 Text = typing.Text
 TYPE_CHECKING = typing.TYPE_CHECKING
 
 
-def _gorg(cls):
-    """This function exists for compatibility with old typing versions."""
-    assert isinstance(cls, GenericMeta)
-    if hasattr(cls, '_gorg'):
-        return cls._gorg
-    while cls.__origin__ is not None:
-        cls = cls.__origin__
-    return cls
-
-
 _PROTO_WHITELIST = ['Callable', 'Awaitable',
                     'Iterable', 'Iterator', 'AsyncIterable', 'AsyncIterator',
                     'Hashable', 'Sized', 'Container', 'Collection', 'Reversible',
@@ -507,18 +414,57 @@ def _is_callable_members_only(cls):
     return all(callable(getattr(cls, attr, None)) for attr in _get_protocol_attrs(cls))
 
 
+def _maybe_adjust_parameters(cls):
+    """Helper function used in Protocol.__init_subclass__ and _TypedDictMeta.__new__.
+
+    The contents of this function are very similar
+    to logic found in typing.Generic.__init_subclass__
+    on the CPython main branch.
+    """
+    tvars = []
+    if '__orig_bases__' in cls.__dict__:
+        tvars = typing._collect_type_vars(cls.__orig_bases__)
+        # Look for Generic[T1, ..., Tn] or Protocol[T1, ..., Tn].
+        # If found, tvars must be a subset of it.
+        # If not found, tvars is it.
+        # Also check for and reject plain Generic,
+        # and reject multiple Generic[...] and/or Protocol[...].
+        gvars = None
+        for base in cls.__orig_bases__:
+            if (isinstance(base, typing._GenericAlias) and
+                    base.__origin__ in (typing.Generic, Protocol)):
+                # for error messages
+                the_base = base.__origin__.__name__
+                if gvars is not None:
+                    raise TypeError(
+                        "Cannot inherit from Generic[...]"
+                        " and/or Protocol[...] multiple types.")
+                gvars = base.__parameters__
+        if gvars is None:
+            gvars = tvars
+        else:
+            tvarset = set(tvars)
+            gvarset = set(gvars)
+            if not tvarset <= gvarset:
+                s_vars = ', '.join(str(t) for t in tvars if t not in gvarset)
+                s_args = ', '.join(str(g) for g in gvars)
+                raise TypeError(f"Some type variables ({s_vars}) are"
+                                f" not listed in {the_base}[{s_args}]")
+            tvars = gvars
+    cls.__parameters__ = tuple(tvars)
+
+
 # 3.8+
 if hasattr(typing, 'Protocol'):
     Protocol = typing.Protocol
 # 3.7
-elif PEP_560:
-    from typing import _collect_type_vars  # noqa
+else:
 
     def _no_init(self, *args, **kwargs):
         if type(self)._is_protocol:
             raise TypeError('Protocols cannot be instantiated')
 
-    class _ProtocolMeta(abc.ABCMeta):
+    class _ProtocolMeta(abc.ABCMeta):  # noqa: B024
         # This metaclass is a bit unfortunate and exists only because of the lack
         # of __instancehook__.
         def __instancecheck__(cls, instance):
@@ -600,47 +546,17 @@ elif PEP_560:
                         "Parameters to Protocol[...] must all be unique")
             else:
                 # Subscripting a regular Generic subclass.
-                _check_generic(cls, params)
+                _check_generic(cls, params, len(cls.__parameters__))
             return typing._GenericAlias(cls, params)
 
         def __init_subclass__(cls, *args, **kwargs):
-            tvars = []
             if '__orig_bases__' in cls.__dict__:
                 error = typing.Generic in cls.__orig_bases__
             else:
                 error = typing.Generic in cls.__bases__
             if error:
                 raise TypeError("Cannot inherit from plain Generic")
-            if '__orig_bases__' in cls.__dict__:
-                tvars = _collect_type_vars(cls.__orig_bases__)
-                # Look for Generic[T1, ..., Tn] or Protocol[T1, ..., Tn].
-                # If found, tvars must be a subset of it.
-                # If not found, tvars is it.
-                # Also check for and reject plain Generic,
-                # and reject multiple Generic[...] and/or Protocol[...].
-                gvars = None
-                for base in cls.__orig_bases__:
-                    if (isinstance(base, typing._GenericAlias) and
-                            base.__origin__ in (typing.Generic, Protocol)):
-                        # for error messages
-                        the_base = base.__origin__.__name__
-                        if gvars is not None:
-                            raise TypeError(
-                                "Cannot inherit from Generic[...]"
-                                " and/or Protocol[...] multiple types.")
-                        gvars = base.__parameters__
-                if gvars is None:
-                    gvars = tvars
-                else:
-                    tvarset = set(tvars)
-                    gvarset = set(gvars)
-                    if not tvarset <= gvarset:
-                        s_vars = ', '.join(str(t) for t in tvars if t not in gvarset)
-                        s_args = ', '.join(str(g) for g in gvars)
-                        raise TypeError(f"Some type variables ({s_vars}) are"
-                                        f" not listed in {the_base}[{s_args}]")
-                    tvars = gvars
-            cls.__parameters__ = tuple(tvars)
+            _maybe_adjust_parameters(cls)
 
             # Determine if this is a protocol or a concrete subclass.
             if not cls.__dict__.get('_is_protocol', None):
@@ -694,250 +610,12 @@ elif PEP_560:
                     raise TypeError('Protocols can only inherit from other'
                                     f' protocols, got {repr(base)}')
             cls.__init__ = _no_init
-# 3.6
-else:
-    from typing import _next_in_mro, _type_check  # noqa
-
-    def _no_init(self, *args, **kwargs):
-        if type(self)._is_protocol:
-            raise TypeError('Protocols cannot be instantiated')
-
-    class _ProtocolMeta(GenericMeta):
-        """Internal metaclass for Protocol.
-
-        This exists so Protocol classes can be generic without deriving
-        from Generic.
-        """
-        def __new__(cls, name, bases, namespace,
-                    tvars=None, args=None, origin=None, extra=None, orig_bases=None):
-            # This is just a version copied from GenericMeta.__new__ that
-            # includes "Protocol" special treatment. (Comments removed for brevity.)
-            assert extra is None  # Protocols should not have extra
-            if tvars is not None:
-                assert origin is not None
-                assert all(isinstance(t, typing.TypeVar) for t in tvars), tvars
-            else:
-                tvars = _type_vars(bases)
-                gvars = None
-                for base in bases:
-                    if base is typing.Generic:
-                        raise TypeError("Cannot inherit from plain Generic")
-                    if (isinstance(base, GenericMeta) and
-                            base.__origin__ in (typing.Generic, Protocol)):
-                        if gvars is not None:
-                            raise TypeError(
-                                "Cannot inherit from Generic[...] or"
-                                " Protocol[...] multiple times.")
-                        gvars = base.__parameters__
-                if gvars is None:
-                    gvars = tvars
-                else:
-                    tvarset = set(tvars)
-                    gvarset = set(gvars)
-                    if not tvarset <= gvarset:
-                        s_vars = ", ".join(str(t) for t in tvars if t not in gvarset)
-                        s_args = ", ".join(str(g) for g in gvars)
-                        cls_name = "Generic" if any(b.__origin__ is typing.Generic
-                                                    for b in bases) else "Protocol"
-                        raise TypeError(f"Some type variables ({s_vars}) are"
-                                        f" not listed in {cls_name}[{s_args}]")
-                    tvars = gvars
-
-            initial_bases = bases
-            if (extra is not None and type(extra) is abc.ABCMeta and
-                    extra not in bases):
-                bases = (extra,) + bases
-            bases = tuple(_gorg(b) if isinstance(b, GenericMeta) else b
-                          for b in bases)
-            if any(isinstance(b, GenericMeta) and b is not typing.Generic for b in bases):
-                bases = tuple(b for b in bases if b is not typing.Generic)
-            namespace.update({'__origin__': origin, '__extra__': extra})
-            self = super(GenericMeta, cls).__new__(cls, name, bases, namespace,
-                                                   _root=True)
-            super(GenericMeta, self).__setattr__('_gorg',
-                                                 self if not origin else
-                                                 _gorg(origin))
-            self.__parameters__ = tvars
-            self.__args__ = tuple(... if a is typing._TypingEllipsis else
-                                  () if a is typing._TypingEmpty else
-                                  a for a in args) if args else None
-            self.__next_in_mro__ = _next_in_mro(self)
-            if orig_bases is None:
-                self.__orig_bases__ = initial_bases
-            elif origin is not None:
-                self._abc_registry = origin._abc_registry
-                self._abc_cache = origin._abc_cache
-            if hasattr(self, '_subs_tree'):
-                self.__tree_hash__ = (hash(self._subs_tree()) if origin else
-                                      super(GenericMeta, self).__hash__())
-            return self
-
-        def __init__(cls, *args, **kwargs):
-            super().__init__(*args, **kwargs)
-            if not cls.__dict__.get('_is_protocol', None):
-                cls._is_protocol = any(b is Protocol or
-                                       isinstance(b, _ProtocolMeta) and
-                                       b.__origin__ is Protocol
-                                       for b in cls.__bases__)
-            if cls._is_protocol:
-                for base in cls.__mro__[1:]:
-                    if not (base in (object, typing.Generic) or
-                            base.__module__ == 'collections.abc' and
-                            base.__name__ in _PROTO_WHITELIST or
-                            isinstance(base, typing.TypingMeta) and base._is_protocol or
-                            isinstance(base, GenericMeta) and
-                            base.__origin__ is typing.Generic):
-                        raise TypeError(f'Protocols can only inherit from other'
-                                        f' protocols, got {repr(base)}')
-
-                cls.__init__ = _no_init
-
-            def _proto_hook(other):
-                if not cls.__dict__.get('_is_protocol', None):
-                    return NotImplemented
-                if not isinstance(other, type):
-                    # Same error as for issubclass(1, int)
-                    raise TypeError('issubclass() arg 1 must be a class')
-                for attr in _get_protocol_attrs(cls):
-                    for base in other.__mro__:
-                        if attr in base.__dict__:
-                            if base.__dict__[attr] is None:
-                                return NotImplemented
-                            break
-                        annotations = getattr(base, '__annotations__', {})
-                        if (isinstance(annotations, typing.Mapping) and
-                                attr in annotations and
-                                isinstance(other, _ProtocolMeta) and
-                                other._is_protocol):
-                            break
-                    else:
-                        return NotImplemented
-                return True
-            if '__subclasshook__' not in cls.__dict__:
-                cls.__subclasshook__ = _proto_hook
-
-        def __instancecheck__(self, instance):
-            # We need this method for situations where attributes are
-            # assigned in __init__.
-            if ((not getattr(self, '_is_protocol', False) or
-                    _is_callable_members_only(self)) and
-                    issubclass(instance.__class__, self)):
-                return True
-            if self._is_protocol:
-                if all(hasattr(instance, attr) and
-                        (not callable(getattr(self, attr, None)) or
-                         getattr(instance, attr) is not None)
-                        for attr in _get_protocol_attrs(self)):
-                    return True
-            return super(GenericMeta, self).__instancecheck__(instance)
-
-        def __subclasscheck__(self, cls):
-            if self.__origin__ is not None:
-                if sys._getframe(1).f_globals['__name__'] not in ['abc', 'functools']:
-                    raise TypeError("Parameterized generics cannot be used with class "
-                                    "or instance checks")
-                return False
-            if (self.__dict__.get('_is_protocol', None) and
-                    not self.__dict__.get('_is_runtime_protocol', None)):
-                if sys._getframe(1).f_globals['__name__'] in ['abc',
-                                                              'functools',
-                                                              'typing']:
-                    return False
-                raise TypeError("Instance and class checks can only be used with"
-                                " @runtime protocols")
-            if (self.__dict__.get('_is_runtime_protocol', None) and
-                    not _is_callable_members_only(self)):
-                if sys._getframe(1).f_globals['__name__'] in ['abc',
-                                                              'functools',
-                                                              'typing']:
-                    return super(GenericMeta, self).__subclasscheck__(cls)
-                raise TypeError("Protocols with non-method members"
-                                " don't support issubclass()")
-            return super(GenericMeta, self).__subclasscheck__(cls)
-
-        @typing._tp_cache
-        def __getitem__(self, params):
-            # We also need to copy this from GenericMeta.__getitem__ to get
-            # special treatment of "Protocol". (Comments removed for brevity.)
-            if not isinstance(params, tuple):
-                params = (params,)
-            if not params and _gorg(self) is not typing.Tuple:
-                raise TypeError(
-                    f"Parameter list to {self.__qualname__}[...] cannot be empty")
-            msg = "Parameters to generic types must be types."
-            params = tuple(_type_check(p, msg) for p in params)
-            if self in (typing.Generic, Protocol):
-                if not all(isinstance(p, typing.TypeVar) for p in params):
-                    raise TypeError(
-                        f"Parameters to {repr(self)}[...] must all be type variables")
-                if len(set(params)) != len(params):
-                    raise TypeError(
-                        f"Parameters to {repr(self)}[...] must all be unique")
-                tvars = params
-                args = params
-            elif self in (typing.Tuple, typing.Callable):
-                tvars = _type_vars(params)
-                args = params
-            elif self.__origin__ in (typing.Generic, Protocol):
-                raise TypeError(f"Cannot subscript already-subscripted {repr(self)}")
-            else:
-                _check_generic(self, params)
-                tvars = _type_vars(params)
-                args = params
-
-            prepend = (self,) if self.__origin__ is None else ()
-            return self.__class__(self.__name__,
-                                  prepend + self.__bases__,
-                                  _no_slots_copy(self.__dict__),
-                                  tvars=tvars,
-                                  args=args,
-                                  origin=self,
-                                  extra=self.__extra__,
-                                  orig_bases=self.__orig_bases__)
-
-    class Protocol(metaclass=_ProtocolMeta):
-        """Base class for protocol classes. Protocol classes are defined as::
-
-          class Proto(Protocol):
-              def meth(self) -> int:
-                  ...
-
-        Such classes are primarily used with static type checkers that recognize
-        structural subtyping (static duck-typing), for example::
-
-          class C:
-              def meth(self) -> int:
-                  return 0
-
-          def func(x: Proto) -> int:
-              return x.meth()
-
-          func(C())  # Passes static type check
-
-        See PEP 544 for details. Protocol classes decorated with
-        @typing_extensions.runtime act as simple-minded runtime protocol that checks
-        only the presence of given attributes, ignoring their type signatures.
-
-        Protocol classes can be generic, they are defined as::
-
-          class GenProto(Protocol[T]):
-              def meth(self) -> T:
-                  ...
-        """
-        __slots__ = ()
-        _is_protocol = True
-
-        def __new__(cls, *args, **kwds):
-            if _gorg(cls) is Protocol:
-                raise TypeError("Type Protocol cannot be instantiated; "
-                                "it can be used only as a base class")
-            return typing._generic_new(cls.__next_in_mro__, cls, *args, **kwds)
 
 
 # 3.8+
 if hasattr(typing, 'runtime_checkable'):
     runtime_checkable = typing.runtime_checkable
-# 3.6-3.7
+# 3.7
 else:
     def runtime_checkable(cls):
         """Mark a protocol class as a runtime protocol, so that it
@@ -961,7 +639,7 @@ runtime = runtime_checkable
 # 3.8+
 if hasattr(typing, 'SupportsIndex'):
     SupportsIndex = typing.SupportsIndex
-# 3.6-3.7
+# 3.7
 else:
     @runtime_checkable
     class SupportsIndex(Protocol):
@@ -972,12 +650,17 @@ else:
             pass
 
 
-if sys.version_info >= (3, 9, 2):
+if hasattr(typing, "Required"):
     # The standard library TypedDict in Python 3.8 does not store runtime information
     # about which (if any) keys are optional.  See https://bugs.python.org/issue38834
     # The standard library TypedDict in Python 3.9.0/1 does not honour the "total"
     # keyword with old-style TypedDict().  See https://bugs.python.org/issue42059
+    # The standard library TypedDict below Python 3.11 does not store runtime
+    # information about optional and required keys when using Required or NotRequired.
+    # Generic TypedDicts are also impossible using typing.TypedDict on Python <3.11.
     TypedDict = typing.TypedDict
+    _TypedDictMeta = typing._TypedDictMeta
+    is_typeddict = typing.is_typeddict
 else:
     def _check_fails(cls, other):
         try:
@@ -1057,11 +740,18 @@ else:
             # Subclasses and instances of TypedDict return actual dictionaries
             # via _dict_new.
             ns['__new__'] = _typeddict_new if name == 'TypedDict' else _dict_new
+            # Don't insert typing.Generic into __bases__ here,
+            # or Generic.__init_subclass__ will raise TypeError
+            # in the super().__new__() call.
+            # Instead, monkey-patch __bases__ onto the class after it's been created.
             tp_dict = super().__new__(cls, name, (dict,), ns)
 
+            if any(issubclass(base, typing.Generic) for base in bases):
+                tp_dict.__bases__ = (typing.Generic, dict)
+                _maybe_adjust_parameters(tp_dict)
+
             annotations = {}
             own_annotations = ns.get('__annotations__', {})
-            own_annotation_keys = set(own_annotations.keys())
             msg = "TypedDict('Name', {f0: t0, f1: t1, ...}); each t must be a type"
             own_annotations = {
                 n: typing._type_check(tp, msg) for n, tp in own_annotations.items()
@@ -1075,10 +765,22 @@ else:
                 optional_keys.update(base.__dict__.get('__optional_keys__', ()))
 
             annotations.update(own_annotations)
-            if total:
-                required_keys.update(own_annotation_keys)
-            else:
-                optional_keys.update(own_annotation_keys)
+            for annotation_key, annotation_type in own_annotations.items():
+                annotation_origin = get_origin(annotation_type)
+                if annotation_origin is Annotated:
+                    annotation_args = get_args(annotation_type)
+                    if annotation_args:
+                        annotation_type = annotation_args[0]
+                        annotation_origin = get_origin(annotation_type)
+
+                if annotation_origin is Required:
+                    required_keys.add(annotation_key)
+                elif annotation_origin is NotRequired:
+                    optional_keys.add(annotation_key)
+                elif total:
+                    required_keys.add(annotation_key)
+                else:
+                    optional_keys.add(annotation_key)
 
             tp_dict.__annotations__ = annotations
             tp_dict.__required_keys__ = frozenset(required_keys)
@@ -1121,16 +823,127 @@ else:
         syntax forms work for Python 2.7 and 3.2+
         """
 
+    if hasattr(typing, "_TypedDictMeta"):
+        _TYPEDDICT_TYPES = (typing._TypedDictMeta, _TypedDictMeta)
+    else:
+        _TYPEDDICT_TYPES = (_TypedDictMeta,)
 
-# Python 3.9+ has PEP 593 (Annotated and modified get_type_hints)
+    def is_typeddict(tp):
+        """Check if an annotation is a TypedDict class
+
+        For example::
+            class Film(TypedDict):
+                title: str
+                year: int
+
+            is_typeddict(Film)  # => True
+            is_typeddict(Union[list, str])  # => False
+        """
+        return isinstance(tp, tuple(_TYPEDDICT_TYPES))
+
+
+if hasattr(typing, "assert_type"):
+    assert_type = typing.assert_type
+
+else:
+    def assert_type(__val, __typ):
+        """Assert (to the type checker) that the value is of the given type.
+
+        When the type checker encounters a call to assert_type(), it
+        emits an error if the value is not of the specified type::
+
+            def greet(name: str) -> None:
+                assert_type(name, str)  # ok
+                assert_type(name, int)  # type checker error
+
+        At runtime this returns the first argument unchanged and otherwise
+        does nothing.
+        """
+        return __val
+
+
+if hasattr(typing, "Required"):
+    get_type_hints = typing.get_type_hints
+else:
+    import functools
+    import types
+
+    # replaces _strip_annotations()
+    def _strip_extras(t):
+        """Strips Annotated, Required and NotRequired from a given type."""
+        if isinstance(t, _AnnotatedAlias):
+            return _strip_extras(t.__origin__)
+        if hasattr(t, "__origin__") and t.__origin__ in (Required, NotRequired):
+            return _strip_extras(t.__args__[0])
+        if isinstance(t, typing._GenericAlias):
+            stripped_args = tuple(_strip_extras(a) for a in t.__args__)
+            if stripped_args == t.__args__:
+                return t
+            return t.copy_with(stripped_args)
+        if hasattr(types, "GenericAlias") and isinstance(t, types.GenericAlias):
+            stripped_args = tuple(_strip_extras(a) for a in t.__args__)
+            if stripped_args == t.__args__:
+                return t
+            return types.GenericAlias(t.__origin__, stripped_args)
+        if hasattr(types, "UnionType") and isinstance(t, types.UnionType):
+            stripped_args = tuple(_strip_extras(a) for a in t.__args__)
+            if stripped_args == t.__args__:
+                return t
+            return functools.reduce(operator.or_, stripped_args)
+
+        return t
+
+    def get_type_hints(obj, globalns=None, localns=None, include_extras=False):
+        """Return type hints for an object.
+
+        This is often the same as obj.__annotations__, but it handles
+        forward references encoded as string literals, adds Optional[t] if a
+        default value equal to None is set and recursively replaces all
+        'Annotated[T, ...]', 'Required[T]' or 'NotRequired[T]' with 'T'
+        (unless 'include_extras=True').
+
+        The argument may be a module, class, method, or function. The annotations
+        are returned as a dictionary. For classes, annotations include also
+        inherited members.
+
+        TypeError is raised if the argument is not of a type that can contain
+        annotations, and an empty dictionary is returned if no annotations are
+        present.
+
+        BEWARE -- the behavior of globalns and localns is counterintuitive
+        (unless you are familiar with how eval() and exec() work).  The
+        search order is locals first, then globals.
+
+        - If no dict arguments are passed, an attempt is made to use the
+          globals from obj (or the respective module's globals for classes),
+          and these are also used as the locals.  If the object does not appear
+          to have globals, an empty dictionary is used.
+
+        - If one dict argument is passed, it is used for both globals and
+          locals.
+
+        - If two dict arguments are passed, they specify globals and
+          locals, respectively.
+        """
+        if hasattr(typing, "Annotated"):
+            hint = typing.get_type_hints(
+                obj, globalns=globalns, localns=localns, include_extras=True
+            )
+        else:
+            hint = typing.get_type_hints(obj, globalns=globalns, localns=localns)
+        if include_extras:
+            return hint
+        return {k: _strip_extras(t) for k, t in hint.items()}
+
+
+# Python 3.9+ has PEP 593 (Annotated)
 if hasattr(typing, 'Annotated'):
     Annotated = typing.Annotated
-    get_type_hints = typing.get_type_hints
     # Not exported and not a public API, but needed for get_origin() and get_args()
     # to work.
     _AnnotatedAlias = typing._AnnotatedAlias
 # 3.7-3.8
-elif PEP_560:
+else:
     class _AnnotatedAlias(typing._GenericAlias, _root=True):
         """Runtime representation of an annotated type.
 
@@ -1214,8 +1027,12 @@ elif PEP_560:
                 raise TypeError("Annotated[...] should be used "
                                 "with at least two arguments (a type and an "
                                 "annotation).")
-            msg = "Annotated[t, ...]: t must be a type."
-            origin = typing._type_check(params[0], msg)
+            allowed_special_forms = (ClassVar, Final)
+            if get_origin(params[0]) in allowed_special_forms:
+                origin = params[0]
+            else:
+                msg = "Annotated[t, ...]: t must be a type."
+                origin = typing._type_check(params[0], msg)
             metadata = tuple(params[1:])
             return _AnnotatedAlias(origin, metadata)
 
@@ -1224,196 +1041,6 @@ elif PEP_560:
                 f"Cannot subclass {cls.__module__}.Annotated"
             )
 
-    def _strip_annotations(t):
-        """Strips the annotations from a given type.
-        """
-        if isinstance(t, _AnnotatedAlias):
-            return _strip_annotations(t.__origin__)
-        if isinstance(t, typing._GenericAlias):
-            stripped_args = tuple(_strip_annotations(a) for a in t.__args__)
-            if stripped_args == t.__args__:
-                return t
-            res = t.copy_with(stripped_args)
-            res._special = t._special
-            return res
-        return t
-
-    def get_type_hints(obj, globalns=None, localns=None, include_extras=False):
-        """Return type hints for an object.
-
-        This is often the same as obj.__annotations__, but it handles
-        forward references encoded as string literals, adds Optional[t] if a
-        default value equal to None is set and recursively replaces all
-        'Annotated[T, ...]' with 'T' (unless 'include_extras=True').
-
-        The argument may be a module, class, method, or function. The annotations
-        are returned as a dictionary. For classes, annotations include also
-        inherited members.
-
-        TypeError is raised if the argument is not of a type that can contain
-        annotations, and an empty dictionary is returned if no annotations are
-        present.
-
-        BEWARE -- the behavior of globalns and localns is counterintuitive
-        (unless you are familiar with how eval() and exec() work).  The
-        search order is locals first, then globals.
-
-        - If no dict arguments are passed, an attempt is made to use the
-          globals from obj (or the respective module's globals for classes),
-          and these are also used as the locals.  If the object does not appear
-          to have globals, an empty dictionary is used.
-
-        - If one dict argument is passed, it is used for both globals and
-          locals.
-
-        - If two dict arguments are passed, they specify globals and
-          locals, respectively.
-        """
-        hint = typing.get_type_hints(obj, globalns=globalns, localns=localns)
-        if include_extras:
-            return hint
-        return {k: _strip_annotations(t) for k, t in hint.items()}
-# 3.6
-else:
-
-    def _is_dunder(name):
-        """Returns True if name is a __dunder_variable_name__."""
-        return len(name) > 4 and name.startswith('__') and name.endswith('__')
-
-    # Prior to Python 3.7 types did not have `copy_with`. A lot of the equality
-    # checks, argument expansion etc. are done on the _subs_tre. As a result we
-    # can't provide a get_type_hints function that strips out annotations.
-
-    class AnnotatedMeta(typing.GenericMeta):
-        """Metaclass for Annotated"""
-
-        def __new__(cls, name, bases, namespace, **kwargs):
-            if any(b is not object for b in bases):
-                raise TypeError("Cannot subclass " + str(Annotated))
-            return super().__new__(cls, name, bases, namespace, **kwargs)
-
-        @property
-        def __metadata__(self):
-            return self._subs_tree()[2]
-
-        def _tree_repr(self, tree):
-            cls, origin, metadata = tree
-            if not isinstance(origin, tuple):
-                tp_repr = typing._type_repr(origin)
-            else:
-                tp_repr = origin[0]._tree_repr(origin)
-            metadata_reprs = ", ".join(repr(arg) for arg in metadata)
-            return f'{cls}[{tp_repr}, {metadata_reprs}]'
-
-        def _subs_tree(self, tvars=None, args=None):  # noqa
-            if self is Annotated:
-                return Annotated
-            res = super()._subs_tree(tvars=tvars, args=args)
-            # Flatten nested Annotated
-            if isinstance(res[1], tuple) and res[1][0] is Annotated:
-                sub_tp = res[1][1]
-                sub_annot = res[1][2]
-                return (Annotated, sub_tp, sub_annot + res[2])
-            return res
-
-        def _get_cons(self):
-            """Return the class used to create instance of this type."""
-            if self.__origin__ is None:
-                raise TypeError("Cannot get the underlying type of a "
-                                "non-specialized Annotated type.")
-            tree = self._subs_tree()
-            while isinstance(tree, tuple) and tree[0] is Annotated:
-                tree = tree[1]
-            if isinstance(tree, tuple):
-                return tree[0]
-            else:
-                return tree
-
-        @typing._tp_cache
-        def __getitem__(self, params):
-            if not isinstance(params, tuple):
-                params = (params,)
-            if self.__origin__ is not None:  # specializing an instantiated type
-                return super().__getitem__(params)
-            elif not isinstance(params, tuple) or len(params) < 2:
-                raise TypeError("Annotated[...] should be instantiated "
-                                "with at least two arguments (a type and an "
-                                "annotation).")
-            else:
-                msg = "Annotated[t, ...]: t must be a type."
-                tp = typing._type_check(params[0], msg)
-                metadata = tuple(params[1:])
-            return self.__class__(
-                self.__name__,
-                self.__bases__,
-                _no_slots_copy(self.__dict__),
-                tvars=_type_vars((tp,)),
-                # Metadata is a tuple so it won't be touched by _replace_args et al.
-                args=(tp, metadata),
-                origin=self,
-            )
-
-        def __call__(self, *args, **kwargs):
-            cons = self._get_cons()
-            result = cons(*args, **kwargs)
-            try:
-                result.__orig_class__ = self
-            except AttributeError:
-                pass
-            return result
-
-        def __getattr__(self, attr):
-            # For simplicity we just don't relay all dunder names
-            if self.__origin__ is not None and not _is_dunder(attr):
-                return getattr(self._get_cons(), attr)
-            raise AttributeError(attr)
-
-        def __setattr__(self, attr, value):
-            if _is_dunder(attr) or attr.startswith('_abc_'):
-                super().__setattr__(attr, value)
-            elif self.__origin__ is None:
-                raise AttributeError(attr)
-            else:
-                setattr(self._get_cons(), attr, value)
-
-        def __instancecheck__(self, obj):
-            raise TypeError("Annotated cannot be used with isinstance().")
-
-        def __subclasscheck__(self, cls):
-            raise TypeError("Annotated cannot be used with issubclass().")
-
-    class Annotated(metaclass=AnnotatedMeta):
-        """Add context specific metadata to a type.
-
-        Example: Annotated[int, runtime_check.Unsigned] indicates to the
-        hypothetical runtime_check module that this type is an unsigned int.
-        Every other consumer of this type can ignore this metadata and treat
-        this type as int.
-
-        The first argument to Annotated must be a valid type, the remaining
-        arguments are kept as a tuple in the __metadata__ field.
-
-        Details:
-
-        - It's an error to call `Annotated` with less than two arguments.
-        - Nested Annotated are flattened::
-
-            Annotated[Annotated[T, Ann1, Ann2], Ann3] == Annotated[T, Ann1, Ann2, Ann3]
-
-        - Instantiating an annotated type is equivalent to instantiating the
-        underlying type::
-
-            Annotated[C, Ann1](5) == C(5)
-
-        - Annotated can be used as a generic type alias::
-
-            Optimized = Annotated[T, runtime.Optimize()]
-            Optimized[int] == Annotated[int, runtime.Optimize()]
-
-            OptimizedList = Annotated[List[T], runtime.Optimize()]
-            OptimizedList[int] == Annotated[List[int], runtime.Optimize()]
-        """
-
 # Python 3.8 has get_origin() and get_args() but those implementations aren't
 # Annotated-aware, so we can't use those. Python 3.9's versions don't support
 # ParamSpecArgs and ParamSpecKwargs, so only Python 3.10's versions will do.
@@ -1421,7 +1048,7 @@ if sys.version_info[:2] >= (3, 10):
     get_origin = typing.get_origin
     get_args = typing.get_args
 # 3.7-3.9
-elif PEP_560:
+else:
     try:
         # 3.9+
         from typing import _BaseGenericAlias
@@ -1429,9 +1056,9 @@ elif PEP_560:
         _BaseGenericAlias = typing._GenericAlias
     try:
         # 3.9+
-        from typing import GenericAlias
+        from typing import GenericAlias as _typing_GenericAlias
     except ImportError:
-        GenericAlias = typing._GenericAlias
+        _typing_GenericAlias = typing._GenericAlias
 
     def get_origin(tp):
         """Get the unsubscripted version of a type.
@@ -1450,7 +1077,7 @@ elif PEP_560:
         """
         if isinstance(tp, _AnnotatedAlias):
             return Annotated
-        if isinstance(tp, (typing._GenericAlias, GenericAlias, _BaseGenericAlias,
+        if isinstance(tp, (typing._GenericAlias, _typing_GenericAlias, _BaseGenericAlias,
                            ParamSpecArgs, ParamSpecKwargs)):
             return tp.__origin__
         if tp is typing.Generic:
@@ -1470,7 +1097,7 @@ elif PEP_560:
         """
         if isinstance(tp, _AnnotatedAlias):
             return (tp.__origin__,) + tp.__metadata__
-        if isinstance(tp, (typing._GenericAlias, GenericAlias)):
+        if isinstance(tp, (typing._GenericAlias, _typing_GenericAlias)):
             if getattr(tp, "_special", False):
                 return ()
             res = tp.__args__
@@ -1503,7 +1130,7 @@ elif sys.version_info[:2] >= (3, 9):
         """
         raise TypeError(f"{self} is not subscriptable")
 # 3.7-3.8
-elif sys.version_info[:2] >= (3, 7):
+else:
     class _TypeAliasForm(typing._SpecialForm, _root=True):
         def __repr__(self):
             return 'typing_extensions.' + self._name
@@ -1519,44 +1146,51 @@ elif sys.version_info[:2] >= (3, 7):
 
                                It's invalid when used anywhere except as in the example
                                above.""")
-# 3.6
-else:
-    class _TypeAliasMeta(typing.TypingMeta):
-        """Metaclass for TypeAlias"""
 
-        def __repr__(self):
-            return 'typing_extensions.TypeAlias'
 
-    class _TypeAliasBase(typing._FinalTypingBase, metaclass=_TypeAliasMeta, _root=True):
-        """Special marker indicating that an assignment should
-        be recognized as a proper type alias definition by type
-        checkers.
+class _DefaultMixin:
+    """Mixin for TypeVarLike defaults."""
 
-        For example::
+    __slots__ = ()
 
-            Predicate: TypeAlias = Callable[..., bool]
+    def __init__(self, default):
+        if isinstance(default, (tuple, list)):
+            self.__default__ = tuple((typing._type_check(d, "Default must be a type")
+                                      for d in default))
+        elif default:
+            self.__default__ = typing._type_check(default, "Default must be a type")
+        else:
+            self.__default__ = None
 
-        It's invalid when used anywhere except as in the example above.
-        """
-        __slots__ = ()
 
-        def __instancecheck__(self, obj):
-            raise TypeError("TypeAlias cannot be used with isinstance().")
+# Add default and infer_variance parameters from PEP 696 and 695
+class TypeVar(typing.TypeVar, _DefaultMixin, _root=True):
+    """Type variable."""
 
-        def __subclasscheck__(self, cls):
-            raise TypeError("TypeAlias cannot be used with issubclass().")
+    __module__ = 'typing'
 
-        def __repr__(self):
-            return 'typing_extensions.TypeAlias'
+    def __init__(self, name, *constraints, bound=None,
+                 covariant=False, contravariant=False,
+                 default=None, infer_variance=False):
+        super().__init__(name, *constraints, bound=bound, covariant=covariant,
+                         contravariant=contravariant)
+        _DefaultMixin.__init__(self, default)
+        self.__infer_variance__ = infer_variance
 
-    TypeAlias = _TypeAliasBase(_root=True)
+        # for pickling:
+        try:
+            def_mod = sys._getframe(1).f_globals.get('__name__', '__main__')
+        except (AttributeError, ValueError):
+            def_mod = None
+        if def_mod != 'typing_extensions':
+            self.__module__ = def_mod
 
 
 # Python 3.10+ has PEP 612
 if hasattr(typing, 'ParamSpecArgs'):
     ParamSpecArgs = typing.ParamSpecArgs
     ParamSpecKwargs = typing.ParamSpecKwargs
-# 3.6-3.9
+# 3.7-3.9
 else:
     class _Immutable:
         """Mixin to indicate that object should not be copied."""
@@ -1586,6 +1220,11 @@ else:
         def __repr__(self):
             return f"{self.__origin__.__name__}.args"
 
+        def __eq__(self, other):
+            if not isinstance(other, ParamSpecArgs):
+                return NotImplemented
+            return self.__origin__ == other.__origin__
+
     class ParamSpecKwargs(_Immutable):
         """The kwargs for a ParamSpec object.
 
@@ -1604,14 +1243,39 @@ else:
         def __repr__(self):
             return f"{self.__origin__.__name__}.kwargs"
 
+        def __eq__(self, other):
+            if not isinstance(other, ParamSpecKwargs):
+                return NotImplemented
+            return self.__origin__ == other.__origin__
+
 # 3.10+
 if hasattr(typing, 'ParamSpec'):
-    ParamSpec = typing.ParamSpec
-# 3.6-3.9
+
+    # Add default Parameter - PEP 696
+    class ParamSpec(typing.ParamSpec, _DefaultMixin, _root=True):
+        """Parameter specification variable."""
+
+        __module__ = 'typing'
+
+        def __init__(self, name, *, bound=None, covariant=False, contravariant=False,
+                     default=None):
+            super().__init__(name, bound=bound, covariant=covariant,
+                             contravariant=contravariant)
+            _DefaultMixin.__init__(self, default)
+
+            # for pickling:
+            try:
+                def_mod = sys._getframe(1).f_globals.get('__name__', '__main__')
+            except (AttributeError, ValueError):
+                def_mod = None
+            if def_mod != 'typing_extensions':
+                self.__module__ = def_mod
+
+# 3.7-3.9
 else:
 
     # Inherits from list as a workaround for Callable checks in Python < 3.9.2.
-    class ParamSpec(list):
+    class ParamSpec(list, _DefaultMixin):
         """Parameter specification variable.
 
         Usage::
@@ -1669,7 +1333,8 @@ else:
         def kwargs(self):
             return ParamSpecKwargs(self)
 
-        def __init__(self, name, *, bound=None, covariant=False, contravariant=False):
+        def __init__(self, name, *, bound=None, covariant=False, contravariant=False,
+                     default=None):
             super().__init__([self])
             self.__name__ = name
             self.__covariant__ = bool(covariant)
@@ -1678,6 +1343,7 @@ else:
                 self.__bound__ = typing._type_check(bound, 'Bound must be a type.')
             else:
                 self.__bound__ = None
+            _DefaultMixin.__init__(self, default)
 
             # for pickling:
             try:
@@ -1709,28 +1375,17 @@ else:
         def __call__(self, *args, **kwargs):
             pass
 
-        if not PEP_560:
-            # Only needed in 3.6.
-            def _get_type_vars(self, tvars):
-                if self not in tvars:
-                    tvars.append(self)
 
-
-# 3.6-3.9
+# 3.7-3.9
 if not hasattr(typing, 'Concatenate'):
     # Inherits from list as a workaround for Callable checks in Python < 3.9.2.
     class _ConcatenateGenericAlias(list):
 
         # Trick Generic into looking into this for __parameters__.
-        if PEP_560:
-            __class__ = typing._GenericAlias
-        else:
-            __class__ = typing._TypingBase
+        __class__ = typing._GenericAlias
 
         # Flag in 3.8.
         _special = False
-        # Attribute in 3.6 and earlier.
-        _gorg = typing.Generic
 
         def __init__(self, origin, args):
             super().__init__(args)
@@ -1755,14 +1410,8 @@ if not hasattr(typing, 'Concatenate'):
                 tp for tp in self.__args__ if isinstance(tp, (typing.TypeVar, ParamSpec))
             )
 
-        if not PEP_560:
-            # Only required in 3.6.
-            def _get_type_vars(self, tvars):
-                if self.__origin__ and self.__parameters__:
-                    typing._get_type_vars(self.__parameters__, tvars)
 
-
-# 3.6-3.9
+# 3.7-3.9
 @typing._tp_cache
 def _concatenate_getitem(self, parameters):
     if parameters == ():
@@ -1797,7 +1446,7 @@ elif sys.version_info[:2] >= (3, 9):
         """
         return _concatenate_getitem(self, parameters)
 # 3.7-8
-elif sys.version_info[:2] >= (3, 7):
+else:
     class _ConcatenateForm(typing._SpecialForm, _root=True):
         def __repr__(self):
             return 'typing_extensions.' + self._name
@@ -1817,42 +1466,6 @@ elif sys.version_info[:2] >= (3, 7):
 
         See PEP 612 for detailed information.
         """)
-# 3.6
-else:
-    class _ConcatenateAliasMeta(typing.TypingMeta):
-        """Metaclass for Concatenate."""
-
-        def __repr__(self):
-            return 'typing_extensions.Concatenate'
-
-    class _ConcatenateAliasBase(typing._FinalTypingBase,
-                                metaclass=_ConcatenateAliasMeta,
-                                _root=True):
-        """Used in conjunction with ``ParamSpec`` and ``Callable`` to represent a
-        higher order function which adds, removes or transforms parameters of a
-        callable.
-
-        For example::
-
-           Callable[Concatenate[int, P], int]
-
-        See PEP 612 for detailed information.
-        """
-        __slots__ = ()
-
-        def __instancecheck__(self, obj):
-            raise TypeError("Concatenate cannot be used with isinstance().")
-
-        def __subclasscheck__(self, cls):
-            raise TypeError("Concatenate cannot be used with issubclass().")
-
-        def __repr__(self):
-            return 'typing_extensions.Concatenate'
-
-        def __getitem__(self, parameters):
-            return _concatenate_getitem(self, parameters)
-
-    Concatenate = _ConcatenateAliasBase(_root=True)
 
 # 3.10+
 if hasattr(typing, 'TypeGuard'):
@@ -1907,10 +1520,10 @@ elif sys.version_info[:2] >= (3, 9):
         ``TypeGuard`` also works with type variables.  For more information, see
         PEP 647 (User-Defined Type Guards).
         """
-        item = typing._type_check(parameters, f'{self} accepts only single type.')
+        item = typing._type_check(parameters, f'{self} accepts only a single type.')
         return typing._GenericAlias(self, (item,))
 # 3.7-3.8
-elif sys.version_info[:2] >= (3, 7):
+else:
     class _TypeGuardForm(typing._SpecialForm, _root=True):
 
         def __repr__(self):
@@ -1965,135 +1578,78 @@ elif sys.version_info[:2] >= (3, 7):
         ``TypeGuard`` also works with type variables.  For more information, see
         PEP 647 (User-Defined Type Guards).
         """)
-# 3.6
+
+
+# Vendored from cpython typing._SpecialFrom
+class _SpecialForm(typing._Final, _root=True):
+    __slots__ = ('_name', '__doc__', '_getitem')
+
+    def __init__(self, getitem):
+        self._getitem = getitem
+        self._name = getitem.__name__
+        self.__doc__ = getitem.__doc__
+
+    def __getattr__(self, item):
+        if item in {'__name__', '__qualname__'}:
+            return self._name
+
+        raise AttributeError(item)
+
+    def __mro_entries__(self, bases):
+        raise TypeError(f"Cannot subclass {self!r}")
+
+    def __repr__(self):
+        return f'typing_extensions.{self._name}'
+
+    def __reduce__(self):
+        return self._name
+
+    def __call__(self, *args, **kwds):
+        raise TypeError(f"Cannot instantiate {self!r}")
+
+    def __or__(self, other):
+        return typing.Union[self, other]
+
+    def __ror__(self, other):
+        return typing.Union[other, self]
+
+    def __instancecheck__(self, obj):
+        raise TypeError(f"{self} cannot be used with isinstance()")
+
+    def __subclasscheck__(self, cls):
+        raise TypeError(f"{self} cannot be used with issubclass()")
+
+    @typing._tp_cache
+    def __getitem__(self, parameters):
+        return self._getitem(self, parameters)
+
+
+if hasattr(typing, "LiteralString"):
+    LiteralString = typing.LiteralString
 else:
-    class _TypeGuard(typing._FinalTypingBase, _root=True):
-        """Special typing form used to annotate the return type of a user-defined
-        type guard function.  ``TypeGuard`` only accepts a single type argument.
-        At runtime, functions marked this way should return a boolean.
+    @_SpecialForm
+    def LiteralString(self, params):
+        """Represents an arbitrary literal string.
 
-        ``TypeGuard`` aims to benefit *type narrowing* -- a technique used by static
-        type checkers to determine a more precise type of an expression within a
-        program's code flow.  Usually type narrowing is done by analyzing
-        conditional code flow and applying the narrowing to a block of code.  The
-        conditional expression here is sometimes referred to as a "type guard".
+        Example::
 
-        Sometimes it would be convenient to use a user-defined boolean function
-        as a type guard.  Such a function should use ``TypeGuard[...]`` as its
-        return type to alert static type checkers to this intention.
+          from typing_extensions import LiteralString
 
-        Using  ``-> TypeGuard`` tells the static type checker that for a given
-        function:
+          def query(sql: LiteralString) -> ...:
+              ...
 
-        1. The return value is a boolean.
-        2. If the return value is ``True``, the type of its argument
-        is the type inside ``TypeGuard``.
+          query("SELECT * FROM table")  # ok
+          query(f"SELECT * FROM {input()}")  # not ok
 
-        For example::
+        See PEP 675 for details.
 
-            def is_str(val: Union[str, float]):
-                # "isinstance" type guard
-                if isinstance(val, str):
-                    # Type of ``val`` is narrowed to ``str``
-                    ...
-                else:
-                    # Else, type of ``val`` is narrowed to ``float``.
-                    ...
-
-        Strict type narrowing is not enforced -- ``TypeB`` need not be a narrower
-        form of ``TypeA`` (it can even be a wider form) and this may lead to
-        type-unsafe results.  The main reason is to allow for things like
-        narrowing ``List[object]`` to ``List[str]`` even though the latter is not
-        a subtype of the former, since ``List`` is invariant.  The responsibility of
-        writing type-safe type guards is left to the user.
-
-        ``TypeGuard`` also works with type variables.  For more information, see
-        PEP 647 (User-Defined Type Guards).
         """
+        raise TypeError(f"{self} is not subscriptable")
 
-        __slots__ = ('__type__',)
-
-        def __init__(self, tp=None, **kwds):
-            self.__type__ = tp
-
-        def __getitem__(self, item):
-            cls = type(self)
-            if self.__type__ is None:
-                return cls(typing._type_check(item,
-                           f'{cls.__name__[1:]} accepts only a single type.'),
-                           _root=True)
-            raise TypeError(f'{cls.__name__[1:]} cannot be further subscripted')
-
-        def _eval_type(self, globalns, localns):
-            new_tp = typing._eval_type(self.__type__, globalns, localns)
-            if new_tp == self.__type__:
-                return self
-            return type(self)(new_tp, _root=True)
-
-        def __repr__(self):
-            r = super().__repr__()
-            if self.__type__ is not None:
-                r += f'[{typing._type_repr(self.__type__)}]'
-            return r
-
-        def __hash__(self):
-            return hash((type(self).__name__, self.__type__))
-
-        def __eq__(self, other):
-            if not isinstance(other, _TypeGuard):
-                return NotImplemented
-            if self.__type__ is not None:
-                return self.__type__ == other.__type__
-            return self is other
-
-    TypeGuard = _TypeGuard(_root=True)
 
 if hasattr(typing, "Self"):
     Self = typing.Self
-elif sys.version_info[:2] >= (3, 7):
-    # Vendored from cpython typing._SpecialFrom
-    class _SpecialForm(typing._Final, _root=True):
-        __slots__ = ('_name', '__doc__', '_getitem')
-
-        def __init__(self, getitem):
-            self._getitem = getitem
-            self._name = getitem.__name__
-            self.__doc__ = getitem.__doc__
-
-        def __getattr__(self, item):
-            if item in {'__name__', '__qualname__'}:
-                return self._name
-
-            raise AttributeError(item)
-
-        def __mro_entries__(self, bases):
-            raise TypeError(f"Cannot subclass {self!r}")
-
-        def __repr__(self):
-            return f'typing_extensions.{self._name}'
-
-        def __reduce__(self):
-            return self._name
-
-        def __call__(self, *args, **kwds):
-            raise TypeError(f"Cannot instantiate {self!r}")
-
-        def __or__(self, other):
-            return typing.Union[self, other]
-
-        def __ror__(self, other):
-            return typing.Union[other, self]
-
-        def __instancecheck__(self, obj):
-            raise TypeError(f"{self} cannot be used with isinstance()")
-
-        def __subclasscheck__(self, cls):
-            raise TypeError(f"{self} cannot be used with issubclass()")
-
-        @typing._tp_cache
-        def __getitem__(self, parameters):
-            return self._getitem(self, parameters)
-
+else:
     @_SpecialForm
     def Self(self, params):
         """Used to spell the type of "self" in classes.
@@ -2110,30 +1666,36 @@ elif sys.version_info[:2] >= (3, 7):
         """
 
         raise TypeError(f"{self} is not subscriptable")
+
+
+if hasattr(typing, "Never"):
+    Never = typing.Never
 else:
-    class _Self(typing._FinalTypingBase, _root=True):
-        """Used to spell the type of "self" in classes.
+    @_SpecialForm
+    def Never(self, params):
+        """The bottom type, a type that has no members.
 
-        Example::
+        This can be used to define a function that should never be
+        called, or a function that never returns::
 
-          from typing import Self
+            from typing_extensions import Never
 
-          class ReturnsSelf:
-              def parse(self, data: bytes) -> Self:
-                  ...
-                  return self
+            def never_call_me(arg: Never) -> None:
+                pass
+
+            def int_or_str(arg: int | str) -> None:
+                never_call_me(arg)  # type checker error
+                match arg:
+                    case int():
+                        print("It's an int")
+                    case str():
+                        print("It's a str")
+                    case _:
+                        never_call_me(arg)  # ok, arg is of type Never
 
         """
 
-        __slots__ = ()
-
-        def __instancecheck__(self, obj):
-            raise TypeError(f"{self} cannot be used with isinstance().")
-
-        def __subclasscheck__(self, cls):
-            raise TypeError(f"{self} cannot be used with issubclass().")
-
-    Self = _Self(_root=True)
+        raise TypeError(f"{self} is not subscriptable")
 
 
 if hasattr(typing, 'Required'):
@@ -2161,7 +1723,7 @@ elif sys.version_info[:2] >= (3, 9):
         There is no runtime checking that a required key is actually provided
         when instantiating a related TypedDict.
         """
-        item = typing._type_check(parameters, f'{self._name} accepts only single type')
+        item = typing._type_check(parameters, f'{self._name} accepts only a single type.')
         return typing._GenericAlias(self, (item,))
 
     @_ExtensionsSpecialForm
@@ -2178,17 +1740,17 @@ elif sys.version_info[:2] >= (3, 9):
                 year=1999,
             )
         """
-        item = typing._type_check(parameters, f'{self._name} accepts only single type')
+        item = typing._type_check(parameters, f'{self._name} accepts only a single type.')
         return typing._GenericAlias(self, (item,))
 
-elif sys.version_info[:2] >= (3, 7):
+else:
     class _RequiredForm(typing._SpecialForm, _root=True):
         def __repr__(self):
             return 'typing_extensions.' + self._name
 
         def __getitem__(self, parameters):
             item = typing._type_check(parameters,
-                                      '{} accepts only single type'.format(self._name))
+                                      f'{self._name} accepts only a single type.')
             return typing._GenericAlias(self, (item,))
 
     Required = _RequiredForm(
@@ -2222,75 +1784,426 @@ elif sys.version_info[:2] >= (3, 7):
                 year=1999,
             )
         """)
+
+
+if hasattr(typing, "Unpack"):  # 3.11+
+    Unpack = typing.Unpack
+elif sys.version_info[:2] >= (3, 9):
+    class _UnpackSpecialForm(typing._SpecialForm, _root=True):
+        def __repr__(self):
+            return 'typing_extensions.' + self._name
+
+    class _UnpackAlias(typing._GenericAlias, _root=True):
+        __class__ = typing.TypeVar
+
+    @_UnpackSpecialForm
+    def Unpack(self, parameters):
+        """A special typing construct to unpack a variadic type. For example:
+
+            Shape = TypeVarTuple('Shape')
+            Batch = NewType('Batch', int)
+
+            def add_batch_axis(
+                x: Array[Unpack[Shape]]
+            ) -> Array[Batch, Unpack[Shape]]: ...
+
+        """
+        item = typing._type_check(parameters, f'{self._name} accepts only a single type.')
+        return _UnpackAlias(self, (item,))
+
+    def _is_unpack(obj):
+        return isinstance(obj, _UnpackAlias)
+
 else:
-    # NOTE: Modeled after _Final's implementation when _FinalTypingBase available
-    class _MaybeRequired(typing._FinalTypingBase, _root=True):
-        __slots__ = ('__type__',)
+    class _UnpackAlias(typing._GenericAlias, _root=True):
+        __class__ = typing.TypeVar
 
-        def __init__(self, tp=None, **kwds):
-            self.__type__ = tp
+    class _UnpackForm(typing._SpecialForm, _root=True):
+        def __repr__(self):
+            return 'typing_extensions.' + self._name
 
-        def __getitem__(self, item):
-            cls = type(self)
-            if self.__type__ is None:
-                return cls(typing._type_check(item,
-                           '{} accepts only single type.'.format(cls.__name__[1:])),
-                           _root=True)
-            raise TypeError('{} cannot be further subscripted'
-                            .format(cls.__name__[1:]))
+        def __getitem__(self, parameters):
+            item = typing._type_check(parameters,
+                                      f'{self._name} accepts only a single type.')
+            return _UnpackAlias(self, (item,))
 
-        def _eval_type(self, globalns, localns):
-            new_tp = typing._eval_type(self.__type__, globalns, localns)
-            if new_tp == self.__type__:
-                return self
-            return type(self)(new_tp, _root=True)
+    Unpack = _UnpackForm(
+        'Unpack',
+        doc="""A special typing construct to unpack a variadic type. For example:
+
+            Shape = TypeVarTuple('Shape')
+            Batch = NewType('Batch', int)
+
+            def add_batch_axis(
+                x: Array[Unpack[Shape]]
+            ) -> Array[Batch, Unpack[Shape]]: ...
+
+        """)
+
+    def _is_unpack(obj):
+        return isinstance(obj, _UnpackAlias)
+
+
+if hasattr(typing, "TypeVarTuple"):  # 3.11+
+
+    # Add default Parameter - PEP 696
+    class TypeVarTuple(typing.TypeVarTuple, _DefaultMixin, _root=True):
+        """Type variable tuple."""
+
+        def __init__(self, name, *, default=None):
+            super().__init__(name)
+            _DefaultMixin.__init__(self, default)
+
+            # for pickling:
+            try:
+                def_mod = sys._getframe(1).f_globals.get('__name__', '__main__')
+            except (AttributeError, ValueError):
+                def_mod = None
+            if def_mod != 'typing_extensions':
+                self.__module__ = def_mod
+
+else:
+    class TypeVarTuple(_DefaultMixin):
+        """Type variable tuple.
+
+        Usage::
+
+            Ts = TypeVarTuple('Ts')
+
+        In the same way that a normal type variable is a stand-in for a single
+        type such as ``int``, a type variable *tuple* is a stand-in for a *tuple*
+        type such as ``Tuple[int, str]``.
+
+        Type variable tuples can be used in ``Generic`` declarations.
+        Consider the following example::
+
+            class Array(Generic[*Ts]): ...
+
+        The ``Ts`` type variable tuple here behaves like ``tuple[T1, T2]``,
+        where ``T1`` and ``T2`` are type variables. To use these type variables
+        as type parameters of ``Array``, we must *unpack* the type variable tuple using
+        the star operator: ``*Ts``. The signature of ``Array`` then behaves
+        as if we had simply written ``class Array(Generic[T1, T2]): ...``.
+        In contrast to ``Generic[T1, T2]``, however, ``Generic[*Shape]`` allows
+        us to parameterise the class with an *arbitrary* number of type parameters.
+
+        Type variable tuples can be used anywhere a normal ``TypeVar`` can.
+        This includes class definitions, as shown above, as well as function
+        signatures and variable annotations::
+
+            class Array(Generic[*Ts]):
+
+                def __init__(self, shape: Tuple[*Ts]):
+                    self._shape: Tuple[*Ts] = shape
+
+                def get_shape(self) -> Tuple[*Ts]:
+                    return self._shape
+
+            shape = (Height(480), Width(640))
+            x: Array[Height, Width] = Array(shape)
+            y = abs(x)  # Inferred type is Array[Height, Width]
+            z = x + x   #        ...    is Array[Height, Width]
+            x.get_shape()  #     ...    is tuple[Height, Width]
+
+        """
+
+        # Trick Generic __parameters__.
+        __class__ = typing.TypeVar
+
+        def __iter__(self):
+            yield self.__unpacked__
+
+        def __init__(self, name, *, default=None):
+            self.__name__ = name
+            _DefaultMixin.__init__(self, default)
+
+            # for pickling:
+            try:
+                def_mod = sys._getframe(1).f_globals.get('__name__', '__main__')
+            except (AttributeError, ValueError):
+                def_mod = None
+            if def_mod != 'typing_extensions':
+                self.__module__ = def_mod
+
+            self.__unpacked__ = Unpack[self]
 
         def __repr__(self):
-            r = super().__repr__()
-            if self.__type__ is not None:
-                r += '[{}]'.format(typing._type_repr(self.__type__))
-            return r
+            return self.__name__
 
         def __hash__(self):
-            return hash((type(self).__name__, self.__type__))
+            return object.__hash__(self)
 
         def __eq__(self, other):
-            if not isinstance(other, type(self)):
-                return NotImplemented
-            if self.__type__ is not None:
-                return self.__type__ == other.__type__
             return self is other
 
-    class _Required(_MaybeRequired, _root=True):
-        """A special typing construct to mark a key of a total=False TypedDict
-        as required. For example:
+        def __reduce__(self):
+            return self.__name__
 
-            class Movie(TypedDict, total=False):
-                title: Required[str]
-                year: int
+        def __init_subclass__(self, *args, **kwds):
+            if '_root' not in kwds:
+                raise TypeError("Cannot subclass special typing classes")
 
-            m = Movie(
-                title='The Matrix',  # typechecker error if key is omitted
-                year=1999,
-            )
 
-        There is no runtime checking that a required key is actually provided
-        when instantiating a related TypedDict.
+if hasattr(typing, "reveal_type"):
+    reveal_type = typing.reveal_type
+else:
+    def reveal_type(__obj: T) -> T:
+        """Reveal the inferred type of a variable.
+
+        When a static type checker encounters a call to ``reveal_type()``,
+        it will emit the inferred type of the argument::
+
+            x: int = 1
+            reveal_type(x)
+
+        Running a static type checker (e.g., ``mypy``) on this example
+        will produce output similar to 'Revealed type is "builtins.int"'.
+
+        At runtime, the function prints the runtime type of the
+        argument and returns it unchanged.
+
         """
+        print(f"Runtime type is {type(__obj).__name__!r}", file=sys.stderr)
+        return __obj
 
-    class _NotRequired(_MaybeRequired, _root=True):
-        """A special typing construct to mark a key of a TypedDict as
-        potentially missing. For example:
 
-            class Movie(TypedDict):
-                title: str
-                year: NotRequired[int]
+if hasattr(typing, "assert_never"):
+    assert_never = typing.assert_never
+else:
+    def assert_never(__arg: Never) -> Never:
+        """Assert to the type checker that a line of code is unreachable.
+
+        Example::
+
+            def int_or_str(arg: int | str) -> None:
+                match arg:
+                    case int():
+                        print("It's an int")
+                    case str():
+                        print("It's a str")
+                    case _:
+                        assert_never(arg)
+
+        If a type checker finds that a call to assert_never() is
+        reachable, it will emit an error.
+
+        At runtime, this throws an exception when called.
 
-            m = Movie(
-                title='The Matrix',  # typechecker error if key is omitted
-                year=1999,
-            )
         """
+        raise AssertionError("Expected code to be unreachable")
 
-    Required = _Required(_root=True)
-    NotRequired = _NotRequired(_root=True)
+
+if hasattr(typing, 'dataclass_transform'):
+    dataclass_transform = typing.dataclass_transform
+else:
+    def dataclass_transform(
+        *,
+        eq_default: bool = True,
+        order_default: bool = False,
+        kw_only_default: bool = False,
+        field_specifiers: typing.Tuple[
+            typing.Union[typing.Type[typing.Any], typing.Callable[..., typing.Any]],
+            ...
+        ] = (),
+        **kwargs: typing.Any,
+    ) -> typing.Callable[[T], T]:
+        """Decorator that marks a function, class, or metaclass as providing
+        dataclass-like behavior.
+
+        Example:
+
+            from typing_extensions import dataclass_transform
+
+            _T = TypeVar("_T")
+
+            # Used on a decorator function
+            @dataclass_transform()
+            def create_model(cls: type[_T]) -> type[_T]:
+                ...
+                return cls
+
+            @create_model
+            class CustomerModel:
+                id: int
+                name: str
+
+            # Used on a base class
+            @dataclass_transform()
+            class ModelBase: ...
+
+            class CustomerModel(ModelBase):
+                id: int
+                name: str
+
+            # Used on a metaclass
+            @dataclass_transform()
+            class ModelMeta(type): ...
+
+            class ModelBase(metaclass=ModelMeta): ...
+
+            class CustomerModel(ModelBase):
+                id: int
+                name: str
+
+        Each of the ``CustomerModel`` classes defined in this example will now
+        behave similarly to a dataclass created with the ``@dataclasses.dataclass``
+        decorator. For example, the type checker will synthesize an ``__init__``
+        method.
+
+        The arguments to this decorator can be used to customize this behavior:
+        - ``eq_default`` indicates whether the ``eq`` parameter is assumed to be
+          True or False if it is omitted by the caller.
+        - ``order_default`` indicates whether the ``order`` parameter is
+          assumed to be True or False if it is omitted by the caller.
+        - ``kw_only_default`` indicates whether the ``kw_only`` parameter is
+          assumed to be True or False if it is omitted by the caller.
+        - ``field_specifiers`` specifies a static list of supported classes
+          or functions that describe fields, similar to ``dataclasses.field()``.
+
+        At runtime, this decorator records its arguments in the
+        ``__dataclass_transform__`` attribute on the decorated object.
+
+        See PEP 681 for details.
+
+        """
+        def decorator(cls_or_fn):
+            cls_or_fn.__dataclass_transform__ = {
+                "eq_default": eq_default,
+                "order_default": order_default,
+                "kw_only_default": kw_only_default,
+                "field_specifiers": field_specifiers,
+                "kwargs": kwargs,
+            }
+            return cls_or_fn
+        return decorator
+
+
+if hasattr(typing, "override"):
+    override = typing.override
+else:
+    _F = typing.TypeVar("_F", bound=typing.Callable[..., typing.Any])
+
+    def override(__arg: _F) -> _F:
+        """Indicate that a method is intended to override a method in a base class.
+
+        Usage:
+
+            class Base:
+                def method(self) -> None: ...
+                    pass
+
+            class Child(Base):
+                @override
+                def method(self) -> None:
+                    super().method()
+
+        When this decorator is applied to a method, the type checker will
+        validate that it overrides a method with the same name on a base class.
+        This helps prevent bugs that may occur when a base class is changed
+        without an equivalent change to a child class.
+
+        See PEP 698 for details.
+
+        """
+        return __arg
+
+
+# We have to do some monkey patching to deal with the dual nature of
+# Unpack/TypeVarTuple:
+# - We want Unpack to be a kind of TypeVar so it gets accepted in
+#   Generic[Unpack[Ts]]
+# - We want it to *not* be treated as a TypeVar for the purposes of
+#   counting generic parameters, so that when we subscript a generic,
+#   the runtime doesn't try to substitute the Unpack with the subscripted type.
+if not hasattr(typing, "TypeVarTuple"):
+    typing._collect_type_vars = _collect_type_vars
+    typing._check_generic = _check_generic
+
+
+# Backport typing.NamedTuple as it exists in Python 3.11.
+# In 3.11, the ability to define generic `NamedTuple`s was supported.
+# This was explicitly disallowed in 3.9-3.10, and only half-worked in <=3.8.
+if sys.version_info >= (3, 11):
+    NamedTuple = typing.NamedTuple
+else:
+    def _caller():
+        try:
+            return sys._getframe(2).f_globals.get('__name__', '__main__')
+        except (AttributeError, ValueError):  # For platforms without _getframe()
+            return None
+
+    def _make_nmtuple(name, types, module, defaults=()):
+        fields = [n for n, t in types]
+        annotations = {n: typing._type_check(t, f"field {n} annotation must be a type")
+                       for n, t in types}
+        nm_tpl = collections.namedtuple(name, fields,
+                                        defaults=defaults, module=module)
+        nm_tpl.__annotations__ = nm_tpl.__new__.__annotations__ = annotations
+        # The `_field_types` attribute was removed in 3.9;
+        # in earlier versions, it is the same as the `__annotations__` attribute
+        if sys.version_info < (3, 9):
+            nm_tpl._field_types = annotations
+        return nm_tpl
+
+    _prohibited_namedtuple_fields = typing._prohibited
+    _special_namedtuple_fields = frozenset({'__module__', '__name__', '__annotations__'})
+
+    class _NamedTupleMeta(type):
+        def __new__(cls, typename, bases, ns):
+            assert _NamedTuple in bases
+            for base in bases:
+                if base is not _NamedTuple and base is not typing.Generic:
+                    raise TypeError(
+                        'can only inherit from a NamedTuple type and Generic')
+            bases = tuple(tuple if base is _NamedTuple else base for base in bases)
+            types = ns.get('__annotations__', {})
+            default_names = []
+            for field_name in types:
+                if field_name in ns:
+                    default_names.append(field_name)
+                elif default_names:
+                    raise TypeError(f"Non-default namedtuple field {field_name} "
+                                    f"cannot follow default field"
+                                    f"{'s' if len(default_names) > 1 else ''} "
+                                    f"{', '.join(default_names)}")
+            nm_tpl = _make_nmtuple(
+                typename, types.items(),
+                defaults=[ns[n] for n in default_names],
+                module=ns['__module__']
+            )
+            nm_tpl.__bases__ = bases
+            if typing.Generic in bases:
+                class_getitem = typing.Generic.__class_getitem__.__func__
+                nm_tpl.__class_getitem__ = classmethod(class_getitem)
+            # update from user namespace without overriding special namedtuple attributes
+            for key in ns:
+                if key in _prohibited_namedtuple_fields:
+                    raise AttributeError("Cannot overwrite NamedTuple attribute " + key)
+                elif key not in _special_namedtuple_fields and key not in nm_tpl._fields:
+                    setattr(nm_tpl, key, ns[key])
+            if typing.Generic in bases:
+                nm_tpl.__init_subclass__()
+            return nm_tpl
+
+    def NamedTuple(__typename, __fields=None, **kwargs):
+        if __fields is None:
+            __fields = kwargs.items()
+        elif kwargs:
+            raise TypeError("Either list of fields or keywords"
+                            " can be provided to NamedTuple, not both")
+        return _make_nmtuple(__typename, __fields, module=_caller())
+
+    NamedTuple.__doc__ = typing.NamedTuple.__doc__
+    _NamedTuple = type.__new__(_NamedTupleMeta, 'NamedTuple', (), {})
+
+    # On 3.8+, alter the signature so that it matches typing.NamedTuple.
+    # The signature of typing.NamedTuple on >=3.8 is invalid syntax in Python 3.7,
+    # so just leave the signature as it is on 3.7.
+    if sys.version_info >= (3, 8):
+        NamedTuple.__text_signature__ = '(typename, fields=None, /, **kwargs)'
+
+    def _namedtuple_mro_entries(bases):
+        assert NamedTuple in bases
+        return (_NamedTuple,)
+
+    NamedTuple.__mro_entries__ = _namedtuple_mro_entries
diff --git a/requirements.txt b/requirements.txt
index a0dcd531..773e6f01 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -8,7 +8,7 @@ beautifulsoup4==4.11.1
 bleach==5.0.1
 certifi==2022.9.24
 cheroot==8.6.0
-cherrypy==18.6.1
+cherrypy==18.8.0
 cloudinary==1.29.0
 distro==1.7.0
 dnspython==2.2.1

From ed735e5fa34200c39b9c668b5b1e0df555d47866 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 12 Nov 2022 17:57:44 -0800
Subject: [PATCH 224/743] Shorten winget workflow name

---
 .github/workflows/submit-winget.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/submit-winget.yml b/.github/workflows/submit-winget.yml
index c295cd47..33b6d9da 100644
--- a/.github/workflows/submit-winget.yml
+++ b/.github/workflows/submit-winget.yml
@@ -1,4 +1,4 @@
-name: Submit Tautulli package to Windows Package Manager Community Repository
+name: Submit winget
 
 on:
   workflow_dispatch: ~

From 05739ea959e8dc48f77f769d7c908da427178fd4 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 13 Nov 2022 00:17:28 -0800
Subject: [PATCH 225/743] pyOpenSSL only required for generating self-signed
 certificates

---
 Tautulli.py       | 10 ----------
 plexpy/helpers.py |  2 +-
 2 files changed, 1 insertion(+), 11 deletions(-)

diff --git a/Tautulli.py b/Tautulli.py
index ead27c31..eebfa55a 100755
--- a/Tautulli.py
+++ b/Tautulli.py
@@ -253,16 +253,6 @@ def main():
     else:
         plexpy.HTTP_PORT = int(plexpy.CONFIG.HTTP_PORT)
 
-    # Check if pyOpenSSL is installed. It is required for certificate generation
-    # and for CherryPy.
-    if plexpy.CONFIG.ENABLE_HTTPS:
-        try:
-            import OpenSSL
-        except ImportError:
-            logger.warn("The pyOpenSSL module is missing. Install this "
-                        "module to enable HTTPS. HTTPS will be disabled.")
-            plexpy.CONFIG.ENABLE_HTTPS = False
-
     # Try to start the server. Will exit here is address is already in use.
     webstart.start()
 
diff --git a/plexpy/helpers.py b/plexpy/helpers.py
index da5a5df5..b0995849 100644
--- a/plexpy/helpers.py
+++ b/plexpy/helpers.py
@@ -486,7 +486,7 @@ def create_https_certificates(ssl_cert, ssl_key):
     try:
         from OpenSSL import crypto
     except ImportError:
-        logger.error("Unable to generate self-signed certificates: Missing OpenSSL module.")
+        logger.error("Unable to generate self-signed certificates: Missing pyOpenSSL module.")
         return False
     from certgen import createKeyPair, createSelfSignedCertificate, TYPE_RSA
 

From 977eec8a663bd9f62592c69d25a1e9ae6a1683af Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 13 Nov 2022 00:19:02 -0800
Subject: [PATCH 226/743] Disable TLS 1.0 and TLS 1.1 in webserver

Fixes #1870
---
 plexpy/webstart.py | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/plexpy/webstart.py b/plexpy/webstart.py
index 59ae8608..a2d84ec0 100644
--- a/plexpy/webstart.py
+++ b/plexpy/webstart.py
@@ -16,6 +16,7 @@
 #  along with Tautulli.  If not, see <http://www.gnu.org/licenses/>.
 
 import os
+import ssl
 import sys
 
 import cherrypy
@@ -101,6 +102,17 @@ def initialize(options):
         options_dict['engine.autoreload.on'] = True
 
     if enable_https:
+        context = ssl.create_default_context(
+            purpose=ssl.Purpose.CLIENT_AUTH,
+            cafile=https_cert_chain
+        )
+        # Context options:
+        # PROTOCOL_TLS_SERVER | OP_NO_SSLv2 | OP_NO_SSLv3 | OP_NO_TLSv1 | OP_NO_TLSv1_1
+        context.options |= ssl.OP_NO_TLSv1
+        context.options |= ssl.OP_NO_TLSv1_1
+        context.load_cert_chain(https_cert, https_key)
+
+        options_dict['server.ssl_context'] = context
         options_dict['server.ssl_certificate'] = https_cert
         options_dict['server.ssl_certificate_chain'] = https_cert_chain
         options_dict['server.ssl_private_key'] = https_key

From 1cdb55a6a9cc86d08df0df541cec5c76b9505aed Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 13 Nov 2022 01:03:07 -0800
Subject: [PATCH 227/743] Set SSLContext.minimum_version to TLSv1.2

`ssl.OP_NO_TLSv1` and `ssl.OP_NO_TLSv1_1` deprecated since Python 3.7 and OpenSSL 1.1.0.

Ref: #1870
---
 plexpy/webstart.py | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/plexpy/webstart.py b/plexpy/webstart.py
index a2d84ec0..3b8a1a90 100644
--- a/plexpy/webstart.py
+++ b/plexpy/webstart.py
@@ -106,10 +106,7 @@ def initialize(options):
             purpose=ssl.Purpose.CLIENT_AUTH,
             cafile=https_cert_chain
         )
-        # Context options:
-        # PROTOCOL_TLS_SERVER | OP_NO_SSLv2 | OP_NO_SSLv3 | OP_NO_TLSv1 | OP_NO_TLSv1_1
-        context.options |= ssl.OP_NO_TLSv1
-        context.options |= ssl.OP_NO_TLSv1_1
+        context.minimum_version = ssl.TLSVersion.TLSv1_2
         context.load_cert_chain(https_cert, https_key)
 
         options_dict['server.ssl_context'] = context

From 100fdd1df199611f725e41bf1f79b13c24b3fe45 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 13 Nov 2022 19:09:58 -0800
Subject: [PATCH 228/743] Change export m3u8 to m3u extension

* m3u files are still encoded using UTF-8
---
 data/interfaces/default/export_modal.html |  2 +-
 plexpy/exporter.py                        | 44 +++++++++++------------
 plexpy/webserve.py                        |  4 +--
 3 files changed, 25 insertions(+), 25 deletions(-)

diff --git a/data/interfaces/default/export_modal.html b/data/interfaces/default/export_modal.html
index bdda847a..b91d31f1 100644
--- a/data/interfaces/default/export_modal.html
+++ b/data/interfaces/default/export_modal.html
@@ -226,7 +226,7 @@ DOCUMENTATION :: END
     getExportFields();
 
     $('#export_file_format').on('change', function() {
-        if ($(this).val() === 'm3u8') {
+        if ($(this).val() === 'm3u') {
             $('#export_metadata_level').prop('disabled', true);
             $('#export_media_info_level').prop('disabled', true);
             $("#export_thumb_level").prop('disabled', true);
diff --git a/plexpy/exporter.py b/plexpy/exporter.py
index 09c0c6b0..f9e4e893 100644
--- a/plexpy/exporter.py
+++ b/plexpy/exporter.py
@@ -102,7 +102,7 @@ class Export(object):
     METADATA_LEVELS = (0, 1, 2, 3, 9)
     MEDIA_INFO_LEVELS = (0, 1, 2, 3, 9)
     IMAGE_LEVELS = (0, 1, 2, 9)
-    FILE_FORMATS = ('csv', 'json', 'xml', 'm3u8')
+    FILE_FORMATS = ('csv', 'json', 'xml', 'm3u')
     EXPORT_TYPES = ('all', 'collection', 'playlist')
 
     def __init__(self, section_id=None, user_id=None, rating_key=None, file_format='csv',
@@ -141,8 +141,8 @@ class Export(object):
         self.exported_items = 0
         self.success = False
 
-        # Reset export options for m3u8
-        if self.file_format == 'm3u8':
+        # Reset export options for m3u
+        if self.file_format == 'm3u':
             self.metadata_level = 1
             self.media_info_level = 1
             self.thumb_level = 0
@@ -1960,10 +1960,10 @@ class Export(object):
             with open(filepath, 'w', encoding='utf-8') as outfile:
                 outfile.write(xml_data)
 
-        elif self.file_format == 'm3u8':
-            m3u8_data = self.data_to_m3u8(result, obj)
+        elif self.file_format == 'm3u':
+            m3u_data = self.data_to_m3u(result, obj)
             with open(filepath, 'w', encoding='utf-8') as outfile:
-                outfile.write(m3u8_data)
+                outfile.write(m3u_data)
 
         self.file_size += os.path.getsize(filepath)
 
@@ -2119,36 +2119,36 @@ class Export(object):
 
         return helpers.dict_to_xml(xml_metadata, root_node='export', indent=4)
 
-    def data_to_m3u8(self, data, obj):
-        items = self._get_m3u8_items(data)
+    def data_to_m3u(self, data, obj):
+        items = self._get_m3u_items(data)
 
-        m3u8_metadata = {'title': obj.title, 'type': obj.media_type}
+        m3u_metadata = {'title': obj.title, 'type': obj.media_type}
         if obj.rating_key:
-            m3u8_metadata['ratingKey'] = obj.rating_key
+            m3u_metadata['ratingKey'] = obj.rating_key
         if obj.user_id:
-            m3u8_metadata['userID'] = obj.user_id
+            m3u_metadata['userID'] = obj.user_id
         if obj.section_id:
-            m3u8_metadata['sectionID'] = obj.section_id
+            m3u_metadata['sectionID'] = obj.section_id
 
-        m3u8 = '#EXTM3U\n'
-        m3u8 += '# Playlist: {title}\n# {metadata}\n\n'.format(title=obj.title, metadata=json.dumps(m3u8_metadata))
-        m3u8_item_template = '# {metadata}\n#EXTINF:{duration},{title}\n{location}\n'
-        m3u8_items = []
+        m3u = '#EXTM3U\n'
+        m3u += '# Playlist: {title}\n# {metadata}\n\n'.format(title=obj.title, metadata=json.dumps(m3u_metadata))
+        m3u_item_template = '# {metadata}\n#EXTINF:{duration},{title}\n{location}\n'
+        m3u_items = []
 
         for item in items:
-            m3u8_values = {
+            m3u_values = {
                 'duration': item.pop('duration'),
                 'title': item.pop('title'),
                 'location': item.pop('location'),
                 'metadata': json.dumps(item)
             }
-            m3u8_items.append(m3u8_item_template.format(**m3u8_values))
+            m3u_items.append(m3u_item_template.format(**m3u_values))
 
-        m3u8 = m3u8 + '\n'.join(m3u8_items)
+        m3u = m3u + '\n'.join(m3u_items)
 
-        return m3u8
+        return m3u
 
-    def _get_m3u8_items(self, data):
+    def _get_m3u_items(self, data):
         items = []
 
         for d in data:
@@ -2167,7 +2167,7 @@ class Export(object):
                 items.append(metadata)
 
             for child_media_type in self.CHILD_MEDIA_TYPES[d['type']]:
-                child_locations = self._get_m3u8_items(d[self.PLURAL_MEDIA_TYPES[child_media_type]])
+                child_locations = self._get_m3u_items(d[self.PLURAL_MEDIA_TYPES[child_media_type]])
                 items.extend(child_locations)
 
         return items
diff --git a/plexpy/webserve.py b/plexpy/webserve.py
index 040d61c7..76c44243 100644
--- a/plexpy/webserve.py
+++ b/plexpy/webserve.py
@@ -7003,7 +7003,7 @@ class WebInterface(object):
                 rating_key (int):          The rating key of the media item to export
 
             Optional parameters:
-                file_format (str):         csv (default), json, xml, or m3u8
+                file_format (str):         csv (default), json, xml, or m3u
                 metadata_level (int):      The level of metadata to export (default 1)
                 media_info_level (int):    The level of media info to export (default 1)
                 thumb_level (int):         The level of poster/cover images to export (default 0)
@@ -7084,7 +7084,7 @@ class WebInterface(object):
             elif result['file_format'] == 'xml':
                 return serve_file(filepath, name=result['filename'], content_type='application/xml;charset=UTF-8')
 
-            elif result['file_format'] == 'm3u8':
+            elif result['file_format'] == 'm3u':
                 return serve_file(filepath, name=result['filename'], content_type='text/plain;charset=UTF-8')
 
         else:

From 0f39171f93a0d90ee514f40415a0450bd4ae7fb4 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 14 Nov 2022 11:09:22 -0800
Subject: [PATCH 229/743] Make webserver TLS version advanced config

Ref: #1870
---
 plexpy/config.py   | 1 +
 plexpy/webstart.py | 7 ++++++-
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/plexpy/config.py b/plexpy/config.py
index 724e1a08..544cf79a 100644
--- a/plexpy/config.py
+++ b/plexpy/config.py
@@ -126,6 +126,7 @@ _CONFIG_DEFINITIONS = {
     'HTTPS_KEY': (str, 'General', ''),
     'HTTPS_DOMAIN': (str, 'General', 'localhost'),
     'HTTPS_IP': (str, 'General', '127.0.0.1'),
+    'HTTPS_MIN_TLS_VERSION': (str, 'Advanced', 'TLSv1.2'),
     'HTTP_BASIC_AUTH': (int, 'General', 0),
     'HTTP_ENVIRONMENT': (str, 'General', 'production'),
     'HTTP_HASH_PASSWORD': (int, 'General', 1),
diff --git a/plexpy/webstart.py b/plexpy/webstart.py
index 3b8a1a90..964a8b75 100644
--- a/plexpy/webstart.py
+++ b/plexpy/webstart.py
@@ -46,6 +46,7 @@ def start():
         'https_cert': plexpy.CONFIG.HTTPS_CERT,
         'https_cert_chain': plexpy.CONFIG.HTTPS_CERT_CHAIN,
         'https_key': plexpy.CONFIG.HTTPS_KEY,
+        'https_min_tls_version': plexpy.CONFIG.HTTPS_MIN_TLS_VERSION,
         'http_username': plexpy.CONFIG.HTTP_USERNAME,
         'http_password': plexpy.CONFIG.HTTP_PASSWORD,
         'http_basic_auth': plexpy.CONFIG.HTTP_BASIC_AUTH
@@ -106,7 +107,11 @@ def initialize(options):
             purpose=ssl.Purpose.CLIENT_AUTH,
             cafile=https_cert_chain
         )
-        context.minimum_version = ssl.TLSVersion.TLSv1_2
+
+        min_tls_version = options['https_min_tls_version'].replace('.', '_')
+        context.minimum_version = getattr(ssl.TLSVersion, min_tls_version, ssl.TLSVersion.TLSv1_2)
+        logger.debug("Tautulli WebStart :: Web server minimum TLS version set to %s.", context.minimum_version.name)
+
         context.load_cert_chain(https_cert, https_key)
 
         options_dict['server.ssl_context'] = context

From fb21815ca0914bf9a58478cbbbe1f2bccabf775a Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 14 Nov 2022 11:24:06 -0800
Subject: [PATCH 230/743] Bump apscheduler from 3.9.1 to 3.9.1.post1 (#1892)

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

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

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

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 package/requirements-package.txt | 2 +-
 requirements.txt                 | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index ce53967b..fb441b25 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -1,4 +1,4 @@
-apscheduler==3.9.1
+apscheduler==3.9.1.post1
 importlib-metadata==5.0.0
 importlib-resources==5.10.0
 pyinstaller==5.6.2
diff --git a/requirements.txt b/requirements.txt
index 773e6f01..17d503fd 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,5 +1,5 @@
 appdirs==1.4.4
-apscheduler==3.9.1
+apscheduler==3.9.1.post1
 arrow==1.2.3
 backports.csv==1.0.7
 backports.functools-lru-cache==1.6.4

From b3091d7366ee69e372c0b7b18a41bd37e8c092f3 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 14 Nov 2022 11:24:22 -0800
Subject: [PATCH 231/743] Bump pyobjc-framework-cocoa from 8.5 to 9.0 (#1891)

Bumps [pyobjc-framework-cocoa](https://github.com/ronaldoussoren/pyobjc) from 8.5 to 9.0.
- [Release notes](https://github.com/ronaldoussoren/pyobjc/releases)
- [Changelog](https://github.com/ronaldoussoren/pyobjc/blob/master/docs/changelog.rst)
- [Commits](https://github.com/ronaldoussoren/pyobjc/compare/v8.5...v9.0)

---
updated-dependencies:
- dependency-name: pyobjc-framework-cocoa
  dependency-type: direct:production
  update-type: version-update:semver-major
...

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

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 package/requirements-package.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index fb441b25..87fd6278 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -5,7 +5,7 @@ pyinstaller==5.6.2
 pyopenssl==22.0.0
 pycryptodomex==3.15.0
 
-pyobjc-framework-Cocoa==8.5; platform_system == "Darwin"
+pyobjc-framework-Cocoa==9.0; platform_system == "Darwin"
 pyobjc-core==9.0; platform_system == "Darwin"
 
 pywin32==304; platform_system == "Windows"

From 8d40224d61707aff61f649fcc3b69bdf719f56a2 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 14 Nov 2022 11:24:36 -0800
Subject: [PATCH 232/743] Bump pywin32 from 304 to 305 (#1894)

Bumps [pywin32](https://github.com/mhammond/pywin32) from 304 to 305.
- [Release notes](https://github.com/mhammond/pywin32/releases)
- [Changelog](https://github.com/mhammond/pywin32/blob/main/CHANGES.txt)
- [Commits](https://github.com/mhammond/pywin32/commits)

---
updated-dependencies:
- dependency-name: pywin32
  dependency-type: direct:production
  update-type: version-update:semver-major
...

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

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 package/requirements-package.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index 87fd6278..597af3b0 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -8,4 +8,4 @@ pycryptodomex==3.15.0
 pyobjc-framework-Cocoa==9.0; platform_system == "Darwin"
 pyobjc-core==9.0; platform_system == "Darwin"
 
-pywin32==304; platform_system == "Windows"
+pywin32==305; platform_system == "Windows"

From 6365327595b2f5b60a3152fb0aa7f61c278a6f70 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 14 Nov 2022 11:25:40 -0800
Subject: [PATCH 233/743] Bump pyopenssl from 22.0.0 to 22.1.0 (#1893)

Bumps [pyopenssl](https://github.com/pyca/pyopenssl) from 22.0.0 to 22.1.0.
- [Release notes](https://github.com/pyca/pyopenssl/releases)
- [Changelog](https://github.com/pyca/pyopenssl/blob/main/CHANGELOG.rst)
- [Commits](https://github.com/pyca/pyopenssl/compare/22.0.0...22.1.0)

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

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

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 package/requirements-package.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index 597af3b0..7dc0227b 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -2,7 +2,7 @@ apscheduler==3.9.1.post1
 importlib-metadata==5.0.0
 importlib-resources==5.10.0
 pyinstaller==5.6.2
-pyopenssl==22.0.0
+pyopenssl==22.1.0
 pycryptodomex==3.15.0
 
 pyobjc-framework-Cocoa==9.0; platform_system == "Darwin"

From 7f132439be54f065061fa54b203e914c03883c15 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 14 Nov 2022 11:26:09 -0800
Subject: [PATCH 234/743] Bump tokenize-rt from 4.2.1 to 5.0.0 (#1889)

* Bump tokenize-rt from 4.2.1 to 5.0.0

Bumps [tokenize-rt](https://github.com/asottile/tokenize-rt) from 4.2.1 to 5.0.0.
- [Release notes](https://github.com/asottile/tokenize-rt/releases)
- [Commits](https://github.com/asottile/tokenize-rt/compare/v4.2.1...v5.0.0)

---
updated-dependencies:
- dependency-name: tokenize-rt
  dependency-type: direct:production
  update-type: version-update:semver-major
...

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

* Update tokenize-rt==5.0.0

Signed-off-by: dependabot[bot] <support@github.com>
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/tokenize_rt.py | 62 +++++++++++++---------------------------------
 requirements.txt   |  2 +-
 2 files changed, 18 insertions(+), 46 deletions(-)

diff --git a/lib/tokenize_rt.py b/lib/tokenize_rt.py
index b225a9f0..f0922c16 100644
--- a/lib/tokenize_rt.py
+++ b/lib/tokenize_rt.py
@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import argparse
 import io
 import keyword
@@ -6,20 +8,17 @@ import sys
 import tokenize
 from typing import Generator
 from typing import Iterable
-from typing import List
 from typing import NamedTuple
-from typing import Optional
 from typing import Pattern
 from typing import Sequence
-from typing import Tuple
 
 # this is a performance hack.  see https://bugs.python.org/issue43014
-if (
+if (  # pragma: no branch
         sys.version_info < (3, 10) and
         callable(getattr(tokenize, '_compile', None))
-):  # pragma: no cover (<py310)
+):  # pragma: <3.10 cover
     from functools import lru_cache
-    tokenize._compile = lru_cache()(tokenize._compile)  # type: ignore
+    tokenize._compile = lru_cache()(tokenize._compile)
 
 ESCAPED_NL = 'ESCAPED_NL'
 UNIMPORTANT_WS = 'UNIMPORTANT_WS'
@@ -27,15 +26,15 @@ NON_CODING_TOKENS = frozenset(('COMMENT', ESCAPED_NL, 'NL', UNIMPORTANT_WS))
 
 
 class Offset(NamedTuple):
-    line: Optional[int] = None
-    utf8_byte_offset: Optional[int] = None
+    line: int | None = None
+    utf8_byte_offset: int | None = None
 
 
 class Token(NamedTuple):
     name: str
     src: str
-    line: Optional[int] = None
-    utf8_byte_offset: Optional[int] = None
+    line: int | None = None
+    utf8_byte_offset: int | None = None
 
     @property
     def offset(self) -> Offset:
@@ -43,11 +42,10 @@ class Token(NamedTuple):
 
 
 _string_re = re.compile('^([^\'"]*)(.*)$', re.DOTALL)
-_string_prefixes = frozenset('bfru')
 _escaped_nl_re = re.compile(r'\\(\n|\r\n|\r)')
 
 
-def _re_partition(regex: Pattern[str], s: str) -> Tuple[str, str, str]:
+def _re_partition(regex: Pattern[str], s: str) -> tuple[str, str, str]:
     match = regex.search(s)
     if match:
         return s[:match.start()], s[slice(*match.span())], s[match.end():]
@@ -55,7 +53,7 @@ def _re_partition(regex: Pattern[str], s: str) -> Tuple[str, str, str]:
         return (s, '', '')
 
 
-def src_to_tokens(src: str) -> List[Token]:
+def src_to_tokens(src: str) -> list[Token]:
     tokenize_target = io.StringIO(src)
     lines = ('',) + tuple(tokenize_target)
 
@@ -98,33 +96,7 @@ def src_to_tokens(src: str) -> List[Token]:
             end_offset += len(newtok.encode())
 
         tok_name = tokenize.tok_name[tok_type]
-        # when a string prefix is not recognized, the tokenizer produces a
-        # NAME token followed by a STRING token
-        if (
-                tok_name == 'STRING' and
-                tokens and
-                tokens[-1].name == 'NAME' and
-                frozenset(tokens[-1].src.lower()) <= _string_prefixes
-        ):
-            newsrc = tokens[-1].src + tok_text
-            tokens[-1] = tokens[-1]._replace(src=newsrc, name=tok_name)
-        # produce octal literals as a single token in python 3 as well
-        elif (
-                tok_name == 'NUMBER' and
-                tokens and
-                tokens[-1].name == 'NUMBER'
-        ):
-            tokens[-1] = tokens[-1]._replace(src=tokens[-1].src + tok_text)
-        # produce long literals as a single token in python 3 as well
-        elif (
-                tok_name == 'NAME' and
-                tok_text.lower() == 'l' and
-                tokens and
-                tokens[-1].name == 'NUMBER'
-        ):
-            tokens[-1] = tokens[-1]._replace(src=tokens[-1].src + tok_text)
-        else:
-            tokens.append(Token(tok_name, tok_text, sline, end_offset))
+        tokens.append(Token(tok_name, tok_text, sline, end_offset))
         last_line, last_col = eline, ecol
         if sline != eline:
             end_offset = len(lines[last_line][:last_col].encode())
@@ -140,19 +112,19 @@ def tokens_to_src(tokens: Iterable[Token]) -> str:
 
 def reversed_enumerate(
         tokens: Sequence[Token],
-) -> Generator[Tuple[int, Token], None, None]:
+) -> Generator[tuple[int, Token], None, None]:
     for i in reversed(range(len(tokens))):
         yield i, tokens[i]
 
 
-def parse_string_literal(src: str) -> Tuple[str, str]:
+def parse_string_literal(src: str) -> tuple[str, str]:
     """parse a string literal's source into (prefix, string)"""
     match = _string_re.match(src)
     assert match is not None
     return match.group(1), match.group(2)
 
 
-def rfind_string_parts(tokens: Sequence[Token], i: int) -> Tuple[int, ...]:
+def rfind_string_parts(tokens: Sequence[Token], i: int) -> tuple[int, ...]:
     """find the indicies of the string parts of a (joined) string literal
 
     - `i` should start at the end of the string literal
@@ -195,7 +167,7 @@ def rfind_string_parts(tokens: Sequence[Token], i: int) -> Tuple[int, ...]:
     return tuple(reversed(ret))
 
 
-def main(argv: Optional[Sequence[str]] = None) -> int:
+def main(argv: Sequence[str] | None = None) -> int:
     parser = argparse.ArgumentParser()
     parser.add_argument('filename')
     args = parser.parse_args(argv)
@@ -210,4 +182,4 @@ def main(argv: Optional[Sequence[str]] = None) -> int:
 
 
 if __name__ == '__main__':
-    exit(main())
+    raise SystemExit(main())
diff --git a/requirements.txt b/requirements.txt
index 17d503fd..cff0f4b1 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -42,7 +42,7 @@ simplejson==3.17.6
 six==1.16.0
 soupsieve==2.3.2.post1
 tempora==5.0.2
-tokenize-rt==4.2.1
+tokenize-rt==5.0.0
 tzdata==2022.6
 tzlocal==4.2
 urllib3==1.26.12

From 6b835226cd5878bc0b29a4766b725ce208eb70ea Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 14 Nov 2022 11:26:24 -0800
Subject: [PATCH 235/743] Bump cloudinary from 1.29.0 to 1.30.0 (#1890)

* Bump cloudinary from 1.29.0 to 1.30.0

Bumps [cloudinary](https://github.com/cloudinary/pycloudinary) from 1.29.0 to 1.30.0.
- [Release notes](https://github.com/cloudinary/pycloudinary/releases)
- [Changelog](https://github.com/cloudinary/pycloudinary/blob/master/CHANGELOG.md)
- [Commits](https://github.com/cloudinary/pycloudinary/compare/1.29.0...1.30.0)

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

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

* Update cloudinary==1.30.0

Signed-off-by: dependabot[bot] <support@github.com>
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/cloudinary/__init__.py                    | 22 ++++++++-------
 lib/cloudinary/api.py                         | 27 ++++++++++++++++++-
 lib/cloudinary/auth_token.py                  |  4 ++-
 lib/cloudinary/models.py                      |  2 +-
 lib/cloudinary/provisioning/account.py        |  2 +-
 .../html/cloudinary_cors.html                 |  0
 .../{ => cloudinary}/js/canvas-to-blob.min.js |  0
 .../{ => cloudinary}/js/jquery.cloudinary.js  |  9 ++++---
 .../js/jquery.fileupload-image.js             |  0
 .../js/jquery.fileupload-process.js           |  0
 .../js/jquery.fileupload-validate.js          |  0
 .../{ => cloudinary}/js/jquery.fileupload.js  |  0
 .../js/jquery.iframe-transport.js             |  0
 .../{ => cloudinary}/js/jquery.ui.widget.js   |  0
 .../{ => cloudinary}/js/load-image.all.min.js |  0
 .../templates/cloudinary_includes.html        | 18 ++++++-------
 lib/cloudinary/utils.py                       |  2 ++
 requirements.txt                              |  2 +-
 18 files changed, 61 insertions(+), 27 deletions(-)
 rename lib/cloudinary/static/{ => cloudinary}/html/cloudinary_cors.html (100%)
 rename lib/cloudinary/static/{ => cloudinary}/js/canvas-to-blob.min.js (100%)
 rename lib/cloudinary/static/{ => cloudinary}/js/jquery.cloudinary.js (99%)
 rename lib/cloudinary/static/{ => cloudinary}/js/jquery.fileupload-image.js (100%)
 rename lib/cloudinary/static/{ => cloudinary}/js/jquery.fileupload-process.js (100%)
 rename lib/cloudinary/static/{ => cloudinary}/js/jquery.fileupload-validate.js (100%)
 rename lib/cloudinary/static/{ => cloudinary}/js/jquery.fileupload.js (100%)
 rename lib/cloudinary/static/{ => cloudinary}/js/jquery.iframe-transport.js (100%)
 rename lib/cloudinary/static/{ => cloudinary}/js/jquery.ui.widget.js (100%)
 rename lib/cloudinary/static/{ => cloudinary}/js/load-image.all.min.js (100%)

diff --git a/lib/cloudinary/__init__.py b/lib/cloudinary/__init__.py
index 5e315049..da7ca9ae 100644
--- a/lib/cloudinary/__init__.py
+++ b/lib/cloudinary/__init__.py
@@ -1,14 +1,14 @@
 from __future__ import absolute_import
 
 import abc
-from copy import deepcopy
-import hashlib
-import os
-import re
 import logging
 import numbers
-import certifi
+import os
+import re
+from copy import deepcopy
 from math import ceil
+
+import certifi
 from six import python_2_unicode_compatible, add_metaclass
 
 logger = logging.getLogger("Cloudinary")
@@ -23,7 +23,7 @@ from cloudinary.cache import responsive_breakpoints_cache
 from cloudinary.http_client import HttpClient
 from cloudinary.compat import urlparse, parse_qs
 
-from platform import python_version
+from platform import python_version, platform
 
 CERT_KWARGS = {
     'cert_reqs': 'CERT_REQUIRED',
@@ -38,15 +38,17 @@ CL_BLANK = "data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAA
 URI_SCHEME = "cloudinary"
 API_VERSION = "v1_1"
 
-VERSION = "1.29.0"
+VERSION = "1.30.0"
 
-USER_AGENT = "CloudinaryPython/{} (Python {})".format(VERSION, python_version())
+_USER_PLATFORM_DETAILS = "; ".join((platform(), "Python {}".format(python_version())))
+
+USER_AGENT = "CloudinaryPython/{} ({})".format(VERSION, _USER_PLATFORM_DETAILS)
 """ :const: USER_AGENT """
 
 USER_PLATFORM = ""
 """
-Additional information to be passed with the USER_AGENT, e.g. "CloudinaryMagento/1.0.1".
-This value is set in platform-specific implementations that use cloudinary_php.
+Additional information to be passed with the USER_AGENT, e.g. "CloudinaryCLI/1.2.3".
+This value is set in platform-specific implementations that use pycloudinary.
 
 The format of the value should be <ProductName>/Version[ (comment)].
 @see http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.43
diff --git a/lib/cloudinary/api.py b/lib/cloudinary/api.py
index 58002254..73d18fa1 100644
--- a/lib/cloudinary/api.py
+++ b/lib/cloudinary/api.py
@@ -93,6 +93,23 @@ def resources_by_ids(public_ids, **options):
     return call_api("get", uri, params, **options)
 
 
+def resources_by_asset_folder(asset_folder, **options):
+    """
+    Returns the details of the resources (assets) under a specified asset_folder.
+
+    :param asset_folder:    The Asset Folder of the asset
+    :type asset_folder:     string
+    :param options:     Additional options
+    :type options:      dict, optional
+    :return:            Resources (assets) of a specific asset_folder
+    :rtype:             Response
+    """
+    uri = ["resources", "by_asset_folder"]
+    params = only(options, "max_results", "tags", "moderations", "context", "next_cursor")
+    params["asset_folder"] = asset_folder
+    return call_api("get", uri, params, **options)
+
+
 def resources_by_asset_ids(asset_ids, **options):
     """Retrieves the resources (assets) indicated in the asset IDs.
     This method does not return deleted assets even if they have been backed up.
@@ -131,7 +148,7 @@ def resources_by_context(key, value=None, **options):
     resource_type = options.pop("resource_type", "image")
     uri = ["resources", resource_type, "context"]
     params = only(options, "next_cursor", "max_results", "tags",
-                "context", "moderations", "direction", "metadata")
+                  "context", "moderations", "direction", "metadata")
     params["key"] = key
     if value is not None:
         params["value"] = value
@@ -194,10 +211,18 @@ def update(public_id, **options):
             options.get("custom_coordinates"))
     if "context" in options:
         params["context"] = utils.encode_context(options.get("context"))
+    if "metadata" in options:
+        params["metadata"] = utils.encode_context(options.get("metadata"))
     if "auto_tagging" in options:
         params["auto_tagging"] = str(options.get("auto_tagging"))
     if "access_control" in options:
         params["access_control"] = utils.json_encode(utils.build_list_of_dicts(options.get("access_control")))
+    if "asset_folder" in options:
+        params["asset_folder"] = options.get("asset_folder")
+    if "display_name" in options:
+        params["display_name"] = options.get("display_name")
+    if "unique_display_name" in options:
+        params["unique_display_name"] = options.get("unique_display_name")
 
     return call_api("post", uri, params, **options)
 
diff --git a/lib/cloudinary/auth_token.py b/lib/cloudinary/auth_token.py
index 3aaf3844..4f6c1fe1 100644
--- a/lib/cloudinary/auth_token.py
+++ b/lib/cloudinary/auth_token.py
@@ -30,7 +30,9 @@ def generate(url=None, acl=None, start_time=None, duration=None,
         token_parts.append("st=%d" % start_time)
     token_parts.append("exp=%d" % expiration)
     if acl is not None:
-        token_parts.append("acl=%s" % _escape_to_lower(acl))
+        acl_list = acl if type(acl) is list else [acl]
+        acl_list = [_escape_to_lower(a) for a in acl_list] 
+        token_parts.append("acl=%s" % "!".join(acl_list))
     to_sign = list(token_parts)
     if url is not None and acl is None:
         to_sign.append("url=%s" % _escape_to_lower(url))
diff --git a/lib/cloudinary/models.py b/lib/cloudinary/models.py
index 5ccb133d..1240150e 100644
--- a/lib/cloudinary/models.py
+++ b/lib/cloudinary/models.py
@@ -106,7 +106,7 @@ class CloudinaryField(models.Field):
         value = super(CloudinaryField, self).pre_save(model_instance, add)
         if isinstance(value, UploadedFile):
             options = {"type": self.type, "resource_type": self.resource_type}
-            options.update(self.options)
+            options.update({key: val(model_instance) if callable(val) else val for key, val in self.options.items()})
             if hasattr(value, 'seekable') and value.seekable():
                 value.seek(0)
             instance_value = uploader.upload_resource(value, **options)
diff --git a/lib/cloudinary/provisioning/account.py b/lib/cloudinary/provisioning/account.py
index 6607f101..414c2727 100644
--- a/lib/cloudinary/provisioning/account.py
+++ b/lib/cloudinary/provisioning/account.py
@@ -65,7 +65,7 @@ def create_sub_account(name, cloud_name=None, custom_attributes=None, enabled=No
               "cloud_name": cloud_name,
               "custom_attributes": custom_attributes,
               "enabled": enabled,
-              "base_account": base_account}
+              "base_sub_account_id": base_account}
     return _call_account_api("POST", uri, params=params, **options)
 
 
diff --git a/lib/cloudinary/static/html/cloudinary_cors.html b/lib/cloudinary/static/cloudinary/html/cloudinary_cors.html
similarity index 100%
rename from lib/cloudinary/static/html/cloudinary_cors.html
rename to lib/cloudinary/static/cloudinary/html/cloudinary_cors.html
diff --git a/lib/cloudinary/static/js/canvas-to-blob.min.js b/lib/cloudinary/static/cloudinary/js/canvas-to-blob.min.js
similarity index 100%
rename from lib/cloudinary/static/js/canvas-to-blob.min.js
rename to lib/cloudinary/static/cloudinary/js/canvas-to-blob.min.js
diff --git a/lib/cloudinary/static/js/jquery.cloudinary.js b/lib/cloudinary/static/cloudinary/js/jquery.cloudinary.js
similarity index 99%
rename from lib/cloudinary/static/js/jquery.cloudinary.js
rename to lib/cloudinary/static/cloudinary/js/jquery.cloudinary.js
index 998054b9..7b41a0f2 100644
--- a/lib/cloudinary/static/js/jquery.cloudinary.js
+++ b/lib/cloudinary/static/cloudinary/js/jquery.cloudinary.js
@@ -1093,11 +1093,11 @@ var slice = [].slice,
     *
     * If the parameter is an object,
     * @param {(string|Object)} param - the video codec as either a String or a Hash
-    * @return {string} the video codec string in the format codec:profile:level
+    * @return {string} the video codec string in the format codec:profile:level:b_frames
     * @example
-    * vc_[ :profile : [level]]
+    * vc_[ :profile : [level : [b_frames]]]
     * or
-      { codec: 'h264', profile: 'basic', level: '3.1' }
+      { codec: 'h264', profile: 'basic', level: '3.1', b_frames: false }
     * @ignore
      */
 
@@ -1112,6 +1112,9 @@ var slice = [].slice,
               video += ":" + param['profile'];
               if ('level' in param) {
                 video += ":" + param['level'];
+                if ('b_frames' in param && param['b_frames'] === false) {
+                  video += ":bframes_no";
+                }
               }
             }
           }
diff --git a/lib/cloudinary/static/js/jquery.fileupload-image.js b/lib/cloudinary/static/cloudinary/js/jquery.fileupload-image.js
similarity index 100%
rename from lib/cloudinary/static/js/jquery.fileupload-image.js
rename to lib/cloudinary/static/cloudinary/js/jquery.fileupload-image.js
diff --git a/lib/cloudinary/static/js/jquery.fileupload-process.js b/lib/cloudinary/static/cloudinary/js/jquery.fileupload-process.js
similarity index 100%
rename from lib/cloudinary/static/js/jquery.fileupload-process.js
rename to lib/cloudinary/static/cloudinary/js/jquery.fileupload-process.js
diff --git a/lib/cloudinary/static/js/jquery.fileupload-validate.js b/lib/cloudinary/static/cloudinary/js/jquery.fileupload-validate.js
similarity index 100%
rename from lib/cloudinary/static/js/jquery.fileupload-validate.js
rename to lib/cloudinary/static/cloudinary/js/jquery.fileupload-validate.js
diff --git a/lib/cloudinary/static/js/jquery.fileupload.js b/lib/cloudinary/static/cloudinary/js/jquery.fileupload.js
similarity index 100%
rename from lib/cloudinary/static/js/jquery.fileupload.js
rename to lib/cloudinary/static/cloudinary/js/jquery.fileupload.js
diff --git a/lib/cloudinary/static/js/jquery.iframe-transport.js b/lib/cloudinary/static/cloudinary/js/jquery.iframe-transport.js
similarity index 100%
rename from lib/cloudinary/static/js/jquery.iframe-transport.js
rename to lib/cloudinary/static/cloudinary/js/jquery.iframe-transport.js
diff --git a/lib/cloudinary/static/js/jquery.ui.widget.js b/lib/cloudinary/static/cloudinary/js/jquery.ui.widget.js
similarity index 100%
rename from lib/cloudinary/static/js/jquery.ui.widget.js
rename to lib/cloudinary/static/cloudinary/js/jquery.ui.widget.js
diff --git a/lib/cloudinary/static/js/load-image.all.min.js b/lib/cloudinary/static/cloudinary/js/load-image.all.min.js
similarity index 100%
rename from lib/cloudinary/static/js/load-image.all.min.js
rename to lib/cloudinary/static/cloudinary/js/load-image.all.min.js
diff --git a/lib/cloudinary/templates/cloudinary_includes.html b/lib/cloudinary/templates/cloudinary_includes.html
index 82361c33..908c41d2 100644
--- a/lib/cloudinary/templates/cloudinary_includes.html
+++ b/lib/cloudinary/templates/cloudinary_includes.html
@@ -1,14 +1,14 @@
 {% load static %}
 
-<script src="{% static "js/jquery.ui.widget.js" %}" type="text/javascript"></script>
-<script src="{% static "js/jquery.iframe-transport.js" %}" type="text/javascript"></script>
-<script src="{% static "js/jquery.fileupload.js" %}" type="text/javascript"></script>
-<script src="{% static "js/jquery.cloudinary.js" %}" type="text/javascript"></script>
+<script src="{% static "cloudinary/js/jquery.ui.widget.js" %}" type="text/javascript"></script>
+<script src="{% static "cloudinary/js/jquery.iframe-transport.js" %}" type="text/javascript"></script>
+<script src="{% static "cloudinary/js/jquery.fileupload.js" %}" type="text/javascript"></script>
+<script src="{% static "cloudinary/js/jquery.cloudinary.js" %}" type="text/javascript"></script>
 
 {% if processing %}
-<script src="{% static "js/load-image.all.min.js" %}" type="text/javascript"></script>
-<script src="{% static "js/canvas-to-blob.min.js" %}" type="text/javascript"></script>
-<script src="{% static "js/jquery.fileupload-process.js" %}" type="text/javascript"></script>
-<script src="{% static "js/jquery.fileupload-image.js" %}" type="text/javascript"></script>
-<script src="{% static "js/jquery.fileupload-validate.js" %}" type="text/javascript"></script>
+<script src="{% static "cloudinary/js/load-image.all.min.js" %}" type="text/javascript"></script>
+<script src="{% static "cloudinary/js/canvas-to-blob.min.js" %}" type="text/javascript"></script>
+<script src="{% static "cloudinary/js/jquery.fileupload-process.js" %}" type="text/javascript"></script>
+<script src="{% static "cloudinary/js/jquery.fileupload-image.js" %}" type="text/javascript"></script>
+<script src="{% static "cloudinary/js/jquery.fileupload-validate.js" %}" type="text/javascript"></script>
 {% endif %}
diff --git a/lib/cloudinary/utils.py b/lib/cloudinary/utils.py
index 1fade15b..f7f94512 100644
--- a/lib/cloudinary/utils.py
+++ b/lib/cloudinary/utils.py
@@ -94,6 +94,8 @@ __SIMPLE_UPLOAD_PARAMS = [
     "proxy",
     "folder",
     "asset_folder",
+    "use_asset_folder_as_public_id_prefix",
+    "unique_display_name",
     "overwrite",
     "moderation",
     "raw_convert",
diff --git a/requirements.txt b/requirements.txt
index cff0f4b1..406d8c3f 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -9,7 +9,7 @@ bleach==5.0.1
 certifi==2022.9.24
 cheroot==8.6.0
 cherrypy==18.8.0
-cloudinary==1.29.0
+cloudinary==1.30.0
 distro==1.7.0
 dnspython==2.2.1
 facebook-sdk==3.1.0

From b31d75aeee896bdf0482bd1da15b9d3ed98139a8 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 14 Nov 2022 11:27:01 -0800
Subject: [PATCH 236/743] Bump distro from 1.7.0 to 1.8.0 (#1895)

* Bump distro from 1.7.0 to 1.8.0

Bumps [distro](https://github.com/python-distro/distro) from 1.7.0 to 1.8.0.
- [Release notes](https://github.com/python-distro/distro/releases)
- [Changelog](https://github.com/python-distro/distro/blob/master/CHANGELOG.md)
- [Commits](https://github.com/python-distro/distro/compare/v1.7.0...v1.8.0)

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

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

* Update distro==1.8.0

Signed-off-by: dependabot[bot] <support@github.com>
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/distro/distro.py | 101 +++++++++++++++++++++++++++----------------
 requirements.txt     |   2 +-
 2 files changed, 64 insertions(+), 39 deletions(-)

diff --git a/lib/distro/distro.py b/lib/distro/distro.py
index 49066ae8..89e18680 100644
--- a/lib/distro/distro.py
+++ b/lib/distro/distro.py
@@ -55,7 +55,7 @@ except ImportError:
     # Python 3.7
     TypedDict = dict
 
-__version__ = "1.7.0"
+__version__ = "1.8.0"
 
 
 class VersionDict(TypedDict):
@@ -122,6 +122,26 @@ _DISTRO_RELEASE_CONTENT_REVERSED_PATTERN = re.compile(
 # Pattern for base file name of distro release file
 _DISTRO_RELEASE_BASENAME_PATTERN = re.compile(r"(\w+)[-_](release|version)$")
 
+# Base file names to be looked up for if _UNIXCONFDIR is not readable.
+_DISTRO_RELEASE_BASENAMES = [
+    "SuSE-release",
+    "arch-release",
+    "base-release",
+    "centos-release",
+    "fedora-release",
+    "gentoo-release",
+    "mageia-release",
+    "mandrake-release",
+    "mandriva-release",
+    "mandrivalinux-release",
+    "manjaro-release",
+    "oracle-release",
+    "redhat-release",
+    "rocky-release",
+    "sl-release",
+    "slackware-version",
+]
+
 # Base file names to be ignored when searching for distro release file
 _DISTRO_RELEASE_IGNORE_BASENAMES = (
     "debian_version",
@@ -200,6 +220,7 @@ def id() -> str:
     "opensuse"      openSUSE
     "amzn"          Amazon Linux
     "arch"          Arch Linux
+    "buildroot"     Buildroot
     "cloudlinux"    CloudLinux OS
     "exherbo"       Exherbo Linux
     "gentoo"        GenToo Linux
@@ -221,6 +242,7 @@ def id() -> str:
     "midnightbsd"   MidnightBSD
     "rocky"         Rocky Linux
     "aix"           AIX
+    "guix"          Guix System
     ==============  =========================================
 
     If you have a need to get distros for reliable IDs added into this set,
@@ -876,6 +898,9 @@ class LinuxDistribution:
         if self.uname_attr("id").startswith("aix"):
             # On AIX platforms, prefer oslevel command output.
             versions.insert(0, self.oslevel_info())
+        elif self.id() == "debian" or "debian" in self.like().split():
+            # On Debian-like, add debian_version file content to candidates list.
+            versions.append(self._debian_version)
         version = ""
         if best:
             # This algorithm uses the last version in priority order that has
@@ -1186,6 +1211,16 @@ class LinuxDistribution:
             return ""
         return self._to_str(stdout).strip()
 
+    @cached_property
+    def _debian_version(self) -> str:
+        try:
+            with open(
+                os.path.join(self.etc_dir, "debian_version"), encoding="ascii"
+            ) as fp:
+                return fp.readline().rstrip()
+        except FileNotFoundError:
+            return ""
+
     @staticmethod
     def _parse_uname_content(lines: Sequence[str]) -> Dict[str, str]:
         if not lines:
@@ -1228,14 +1263,14 @@ class LinuxDistribution:
             # file), because we want to use what was specified as best as
             # possible.
             match = _DISTRO_RELEASE_BASENAME_PATTERN.match(basename)
-            if "name" in distro_info and "cloudlinux" in distro_info["name"].lower():
-                distro_info["id"] = "cloudlinux"
-            elif match:
-                distro_info["id"] = match.group(1)
-            return distro_info
         else:
             try:
-                basenames = os.listdir(self.etc_dir)
+                basenames = [
+                    basename
+                    for basename in os.listdir(self.etc_dir)
+                    if basename not in _DISTRO_RELEASE_IGNORE_BASENAMES
+                    and os.path.isfile(os.path.join(self.etc_dir, basename))
+                ]
                 # We sort for repeatability in cases where there are multiple
                 # distro specific files; e.g. CentOS, Oracle, Enterprise all
                 # containing `redhat-release` on top of their own.
@@ -1245,39 +1280,29 @@ class LinuxDistribution:
                 # sure about the *-release files. Check common entries of
                 # /etc for information. If they turn out to not be there the
                 # error is handled in `_parse_distro_release_file()`.
-                basenames = [
-                    "SuSE-release",
-                    "arch-release",
-                    "base-release",
-                    "centos-release",
-                    "fedora-release",
-                    "gentoo-release",
-                    "mageia-release",
-                    "mandrake-release",
-                    "mandriva-release",
-                    "mandrivalinux-release",
-                    "manjaro-release",
-                    "oracle-release",
-                    "redhat-release",
-                    "rocky-release",
-                    "sl-release",
-                    "slackware-version",
-                ]
+                basenames = _DISTRO_RELEASE_BASENAMES
             for basename in basenames:
-                if basename in _DISTRO_RELEASE_IGNORE_BASENAMES:
-                    continue
                 match = _DISTRO_RELEASE_BASENAME_PATTERN.match(basename)
-                if match:
-                    filepath = os.path.join(self.etc_dir, basename)
-                    distro_info = self._parse_distro_release_file(filepath)
-                    if "name" in distro_info:
-                        # The name is always present if the pattern matches
-                        self.distro_release_file = filepath
-                        distro_info["id"] = match.group(1)
-                        if "cloudlinux" in distro_info["name"].lower():
-                            distro_info["id"] = "cloudlinux"
-                        return distro_info
-            return {}
+                if match is None:
+                    continue
+                filepath = os.path.join(self.etc_dir, basename)
+                distro_info = self._parse_distro_release_file(filepath)
+                # The name is always present if the pattern matches.
+                if "name" not in distro_info:
+                    continue
+                self.distro_release_file = filepath
+                break
+            else:  # the loop didn't "break": no candidate.
+                return {}
+
+        if match is not None:
+            distro_info["id"] = match.group(1)
+
+        # CloudLinux < 7: manually enrich info with proper id.
+        if "cloudlinux" in distro_info.get("name", "").lower():
+            distro_info["id"] = "cloudlinux"
+
+        return distro_info
 
     def _parse_distro_release_file(self, filepath: str) -> Dict[str, str]:
         """
diff --git a/requirements.txt b/requirements.txt
index 406d8c3f..7b597123 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -10,7 +10,7 @@ certifi==2022.9.24
 cheroot==8.6.0
 cherrypy==18.8.0
 cloudinary==1.30.0
-distro==1.7.0
+distro==1.8.0
 dnspython==2.2.1
 facebook-sdk==3.1.0
 future==0.18.2

From 79cf61c53eadee7ee8cbcdd714c21ec6caf110ab Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 14 Nov 2022 11:27:16 -0800
Subject: [PATCH 237/743] Bump rumps from 0.3.0 to 0.4.0 (#1896)

* Bump rumps from 0.3.0 to 0.4.0

Bumps [rumps](https://github.com/jaredks/rumps) from 0.3.0 to 0.4.0.
- [Release notes](https://github.com/jaredks/rumps/releases)
- [Changelog](https://github.com/jaredks/rumps/blob/master/CHANGES.rst)
- [Commits](https://github.com/jaredks/rumps/commits)

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

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

* Update rumps==0.4.0

Signed-off-by: dependabot[bot] <support@github.com>
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/rumps/__init__.py             |  14 +-
 lib/rumps/_internal.py            |  92 +++++++++
 lib/rumps/compat.py               |  16 ++
 lib/rumps/events.py               |  40 ++++
 lib/rumps/exceptions.py           |   9 +
 lib/rumps/notifications.py        | 276 +++++++++++++++++++++++++-
 lib/rumps/packages/ordereddict.py |   2 +-
 lib/rumps/rumps.py                | 316 +++++++++---------------------
 lib/rumps/text_field.py           |  32 +++
 lib/rumps/utils.py                |  17 +-
 requirements.txt                  |   2 +-
 11 files changed, 573 insertions(+), 243 deletions(-)
 create mode 100644 lib/rumps/_internal.py
 create mode 100644 lib/rumps/events.py
 create mode 100644 lib/rumps/exceptions.py
 create mode 100644 lib/rumps/text_field.py

diff --git a/lib/rumps/__init__.py b/lib/rumps/__init__.py
index 966fa2d1..5c232f5f 100644
--- a/lib/rumps/__init__.py
+++ b/lib/rumps/__init__.py
@@ -2,7 +2,7 @@
 # -*- coding: utf-8 -*-
 #
 # rumps: Ridiculously Uncomplicated macOS Python Statusbar apps.
-# Copyright: (c) 2017, Jared Suttles. All rights reserved.
+# Copyright: (c) 2020, Jared Suttles. All rights reserved.
 # License: BSD, see LICENSE for details.
 # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 
@@ -17,10 +17,14 @@ statusbar application.
 """
 
 __title__ = 'rumps'
-__version__ = '0.3.0'
+__version__ = '0.4.0'
 __author__ = 'Jared Suttles'
 __license__ = 'Modified BSD'
-__copyright__ = 'Copyright 2017 Jared Suttles'
+__copyright__ = 'Copyright 2020 Jared Suttles'
 
-from .rumps import (separator, debug_mode, alert, notification, application_support, timers, quit_application, timer,
-                    clicked, notifications, MenuItem, SliderMenuItem, Timer, Window, App, slider)
+from . import notifications as _notifications
+from .rumps import (separator, debug_mode, alert, application_support, timers, quit_application, timer,
+                    clicked, MenuItem, SliderMenuItem, Timer, Window, App, slider)
+
+notifications = _notifications.on_notification
+notification = _notifications.notify
diff --git a/lib/rumps/_internal.py b/lib/rumps/_internal.py
new file mode 100644
index 00000000..a4d5320f
--- /dev/null
+++ b/lib/rumps/_internal.py
@@ -0,0 +1,92 @@
+# -*- coding: utf-8 -*-
+
+from __future__ import print_function
+
+import inspect
+import traceback
+
+import Foundation
+
+from . import compat
+from . import exceptions
+
+
+def require_string(*objs):
+    for obj in objs:
+        if not isinstance(obj, compat.string_types):
+            raise TypeError(
+                'a string is required but given {0}, a {1}'.format(obj, type(obj).__name__)
+            )
+
+
+def require_string_or_none(*objs):
+    for obj in objs:
+        if not(obj is None or isinstance(obj, compat.string_types)):
+            raise TypeError(
+                'a string or None is required but given {0}, a {1}'.format(obj, type(obj).__name__)
+            )
+
+
+def call_as_function_or_method(func, *args, **kwargs):
+    # The idea here is that when using decorators in a class, the functions passed are not bound so we have to
+    # determine later if the functions we have (those saved as callbacks) for particular events need to be passed
+    # 'self'.
+    #
+    # This works for an App subclass method or a standalone decorated function. Will attempt to find function as
+    # a bound method of the App instance. If it is found, use it, otherwise simply call function.
+    from . import rumps
+    try:
+        app = getattr(rumps.App, '*app_instance')
+    except AttributeError:
+        pass
+    else:
+        for name, method in inspect.getmembers(app, predicate=inspect.ismethod):
+            if method.__func__ is func:
+                return method(*args, **kwargs)
+    return func(*args, **kwargs)
+
+
+def guard_unexpected_errors(func):
+    """Decorator to be used in PyObjC callbacks where an error bubbling up
+    would cause a crash. Instead of crashing, print the error to stderr and
+    prevent passing to PyObjC layer.
+
+    For Python 3, print the exception using chaining. Accomplished by setting
+    the cause of :exc:`rumps.exceptions.InternalRumpsError` to the exception.
+
+    For Python 2, emulate exception chaining by printing the original exception
+    followed by :exc:`rumps.exceptions.InternalRumpsError`.
+    """
+    def wrapper(*args, **kwargs):
+        try:
+            return func(*args, **kwargs)
+
+        except Exception as e:
+            internal_error = exceptions.InternalRumpsError(
+                'an unexpected error occurred within an internal callback'
+            )
+            if compat.PY2:
+                import sys
+                traceback.print_exc()
+                print('\nThe above exception was the direct cause of the following exception:\n', file=sys.stderr)
+                traceback.print_exception(exceptions.InternalRumpsError, internal_error, None)
+            else:
+                internal_error.__cause__ = e
+                traceback.print_exception(exceptions.InternalRumpsError, internal_error, None)
+
+    return wrapper
+
+
+def string_to_objc(x):
+    if isinstance(x, compat.binary_type):
+        return Foundation.NSData.alloc().initWithData_(x)
+    elif isinstance(x, compat.string_types):
+        return Foundation.NSString.alloc().initWithString_(x)
+    else:
+        raise TypeError(
+            "expected a string or a bytes-like object but provided %s, "
+            "having type '%s'" % (
+                x,
+                type(x).__name__
+            )
+        )
diff --git a/lib/rumps/compat.py b/lib/rumps/compat.py
index a0fb4156..e17d45a3 100644
--- a/lib/rumps/compat.py
+++ b/lib/rumps/compat.py
@@ -1,17 +1,33 @@
 # -*- coding: utf-8 -*-
 
+"""
+rumps.compat
+~~~~~~~~~~~~
+
+Compatibility for Python 2 and Python 3 major versions.
+
+:copyright: (c) 2020 by Jared Suttles
+:license: BSD-3-Clause, see LICENSE for details.
+"""
+
 import sys
 
 PY2 = sys.version_info[0] == 2
 
 if not PY2:
+    binary_type = bytes
     text_type = str
     string_types = (str,)
 
     iteritems = lambda d: iter(d.items())
 
+    import collections.abc as collections_abc
+
 else:
+    binary_type = ()
     text_type = unicode
     string_types = (str, unicode)
 
     iteritems = lambda d: d.iteritems()
+
+    import collections as collections_abc
diff --git a/lib/rumps/events.py b/lib/rumps/events.py
new file mode 100644
index 00000000..64f4439c
--- /dev/null
+++ b/lib/rumps/events.py
@@ -0,0 +1,40 @@
+# -*- coding: utf-8 -*-
+
+import traceback
+
+from . import _internal
+
+
+class EventEmitter(object):
+    def __init__(self, name):
+        self.name = name
+        self.callbacks = set()
+        self._executor = _internal.call_as_function_or_method
+
+    def register(self, func):
+        self.callbacks.add(func)
+        return func
+
+    def unregister(self, func):
+        try:
+            self.callbacks.remove(func)
+            return True
+        except KeyError:
+            return False
+
+    def emit(self, *args, **kwargs):
+        #print('EventEmitter("%s").emit called' % self.name)
+        for callback in self.callbacks:
+            try:
+                self._executor(callback, *args, **kwargs)
+            except Exception:
+                traceback.print_exc()
+
+    __call__ = register
+
+
+before_start = EventEmitter('before_start')
+on_notification = EventEmitter('on_notification')
+on_sleep = EventEmitter('on_sleep')
+on_wake = EventEmitter('on_wake')
+before_quit = EventEmitter('before_quit')
diff --git a/lib/rumps/exceptions.py b/lib/rumps/exceptions.py
new file mode 100644
index 00000000..05c6d46d
--- /dev/null
+++ b/lib/rumps/exceptions.py
@@ -0,0 +1,9 @@
+# -*- coding: utf-8 -*-
+
+
+class RumpsError(Exception):
+    """A generic rumps error occurred."""
+
+
+class InternalRumpsError(RumpsError):
+    """Internal mechanism powering functionality of rumps failed."""
diff --git a/lib/rumps/notifications.py b/lib/rumps/notifications.py
index 760e5f2a..b111e50e 100644
--- a/lib/rumps/notifications.py
+++ b/lib/rumps/notifications.py
@@ -1,10 +1,266 @@
-INFO_PLIST_TEMPLATE = '''\
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
-<plist version="1.0">
-<dict>
-	<key>CFBundleIdentifier</key>
-	<string>%(name)s</string>
-</dict>
-</plist>
-'''
+# -*- coding: utf-8 -*-
+
+_ENABLED = True
+try:
+    from Foundation import NSUserNotification, NSUserNotificationCenter
+except ImportError:
+    _ENABLED = False
+
+import datetime
+import os
+import sys
+import traceback
+
+import Foundation
+
+from . import _internal
+from . import compat
+from . import events
+
+
+def on_notification(f):
+    """Decorator for registering a function to serve as a "notification center"
+    for the application. This function will receive the data associated with an
+    incoming macOS notification sent using :func:`rumps.notification`. This
+    occurs whenever the user clicks on a notification for this application in
+    the macOS Notification Center.
+
+    .. code-block:: python
+
+        @rumps.notifications
+        def notification_center(info):
+            if 'unix' in info:
+                print 'i know this'
+
+    """
+    return events.on_notification.register(f)
+
+
+def _gather_info_issue_9():  # pragma: no cover
+    missing_plist = False
+    missing_bundle_ident = False
+    info_plist_path = os.path.join(os.path.dirname(sys.executable), 'Info.plist')
+    try:
+        with open(info_plist_path) as f:
+            import plistlib
+            try:
+                load_plist = plistlib.load
+            except AttributeError:
+                load_plist = plistlib.readPlist
+            try:
+                load_plist(f)['CFBundleIdentifier']
+            except Exception:
+                missing_bundle_ident = True
+
+    except IOError as e:
+        import errno
+        if e.errno == errno.ENOENT:  # No such file or directory
+            missing_plist = True
+
+    info = '\n\n'
+    if missing_plist:
+        info += 'In this case there is no file at "%(info_plist_path)s"'
+        info += '\n\n'
+        confidence = 'should'
+    elif missing_bundle_ident:
+        info += 'In this case the file at "%(info_plist_path)s" does not contain a value for "CFBundleIdentifier"'
+        info += '\n\n'
+        confidence = 'should'
+    else:
+        confidence = 'may'
+    info += 'Running the following command %(confidence)s fix the issue:\n'
+    info += '/usr/libexec/PlistBuddy -c \'Add :CFBundleIdentifier string "rumps"\' %(info_plist_path)s\n'
+    return info % {'info_plist_path': info_plist_path, 'confidence': confidence}
+
+
+def _default_user_notification_center():
+    notification_center = NSUserNotificationCenter.defaultUserNotificationCenter()
+    if notification_center is None:  # pragma: no cover
+        info = (
+            'Failed to setup the notification center. This issue occurs when the "Info.plist" file '
+            'cannot be found or is missing "CFBundleIdentifier".'
+        )
+        try:
+            info += _gather_info_issue_9()
+        except Exception:
+            pass
+        raise RuntimeError(info)
+    else:
+        return notification_center
+
+
+def _init_nsapp(nsapp):
+    if _ENABLED:
+        try:
+            notification_center = _default_user_notification_center()
+        except RuntimeError:
+            pass
+        else:
+            notification_center.setDelegate_(nsapp)
+
+
+@_internal.guard_unexpected_errors
+def _clicked(ns_user_notification_center, ns_user_notification):
+    from . import rumps
+
+    ns_user_notification_center.removeDeliveredNotification_(ns_user_notification)
+    ns_dict = ns_user_notification.userInfo()
+    if ns_dict is None:
+        data = None
+    else:
+        dumped = ns_dict['value']
+        app = getattr(rumps.App, '*app_instance', rumps.App)
+        try:
+            data = app.serializer.loads(dumped)
+        except Exception:
+            traceback.print_exc()
+            return
+
+    # notification center function not specified => no error but log warning
+    if not events.on_notification.callbacks:
+        rumps._log(
+            'WARNING: notification received but no function specified for '
+            'answering it; use @notifications decorator to register a function.'
+        )
+    else:
+        notification = Notification(ns_user_notification, data)
+        events.on_notification.emit(notification)
+
+
+def notify(title, subtitle, message, data=None, sound=True,
+           action_button=None, other_button=None, has_reply_button=False,
+           icon=None, ignoreDnD=False):
+    """Send a notification to Notification Center (OS X 10.8+). If running on a
+    version of macOS that does not support notifications, a ``RuntimeError``
+    will be raised. Apple says,
+
+        "The userInfo content must be of reasonable serialized size (less than
+        1k) or an exception will be thrown."
+
+    So don't do that!
+
+    :param title: text in a larger font.
+    :param subtitle: text in a smaller font below the `title`.
+    :param message: text representing the body of the notification below the
+                    `subtitle`.
+    :param data: will be passed to the application's "notification center" (see
+                 :func:`rumps.notifications`) when this notification is clicked.
+    :param sound: whether the notification should make a noise when it arrives.
+    :param action_button: title for the action button.
+    :param other_button: title for the other button.
+    :param has_reply_button: whether or not the notification has a reply button.
+    :param icon: the filename of an image for the notification's icon, will
+                 replace the default.
+    :param ignoreDnD: whether the notification should ignore do not disturb,
+                 e.g., appear also while screen sharing.
+    """
+    from . import rumps
+
+    if not _ENABLED:
+        raise RuntimeError('OS X 10.8+ is required to send notifications')
+
+    _internal.require_string_or_none(title, subtitle, message)
+
+    notification = NSUserNotification.alloc().init()
+
+    notification.setTitle_(title)
+    notification.setSubtitle_(subtitle)
+    notification.setInformativeText_(message)
+
+    if data is not None:
+        app = getattr(rumps.App, '*app_instance', rumps.App)
+        dumped = app.serializer.dumps(data)
+        objc_string = _internal.string_to_objc(dumped)
+        ns_dict = Foundation.NSMutableDictionary.alloc().init()
+        ns_dict.setDictionary_({'value': objc_string})
+        notification.setUserInfo_(ns_dict)
+
+    if icon is not None:
+        notification.set_identityImage_(rumps._nsimage_from_file(icon))
+    if sound:
+        notification.setSoundName_("NSUserNotificationDefaultSoundName")
+    if action_button:
+        notification.setActionButtonTitle_(action_button)
+        notification.set_showsButtons_(True)
+    if other_button:
+        notification.setOtherButtonTitle_(other_button)
+        notification.set_showsButtons_(True)
+    if has_reply_button:
+        notification.setHasReplyButton_(True)
+    if ignoreDnD:
+        notification.set_ignoresDoNotDisturb_(True)
+
+    notification.setDeliveryDate_(Foundation.NSDate.dateWithTimeInterval_sinceDate_(0, Foundation.NSDate.date()))
+    notification_center = _default_user_notification_center()
+    notification_center.scheduleNotification_(notification)
+
+
+class Notification(compat.collections_abc.Mapping):
+    def __init__(self, ns_user_notification, data):
+        self._ns = ns_user_notification
+        self._data = data
+
+    def __repr__(self):
+        return '<{0}: [data: {1}]>'.format(type(self).__name__, repr(self._data))
+
+    @property
+    def title(self):
+        return compat.text_type(self._ns.title())
+
+    @property
+    def subtitle(self):
+        return compat.text_type(self._ns.subtitle())
+
+    @property
+    def message(self):
+        return compat.text_type(self._ns.informativeText())
+
+    @property
+    def activation_type(self):
+        activation_type = self._ns.activationType()
+        if activation_type == 1:
+            return 'contents_clicked'
+        elif activation_type == 2:
+            return 'action_button_clicked'
+        elif activation_type == 3:
+            return 'replied'
+        elif activation_type == 4:
+            return 'additional_action_clicked'
+
+    @property
+    def delivered_at(self):
+        ns_date = self._ns.actualDeliveryDate()
+        seconds = ns_date.timeIntervalSince1970()
+        dt = datetime.datetime.fromtimestamp(seconds)
+        return dt
+
+    @property
+    def response(self):
+        ns_attributed_string = self._ns.response()
+        if ns_attributed_string is None:
+            return None
+        ns_string = ns_attributed_string.string()
+        return compat.text_type(ns_string)
+
+    @property
+    def data(self):
+        return self._data
+
+    def _check_if_mapping(self):
+        if not isinstance(self._data, compat.collections_abc.Mapping):
+            raise TypeError(
+                'notification cannot be used as a mapping when data is not a '
+                'mapping'
+            )
+
+    def __getitem__(self, key):
+        self._check_if_mapping()
+        return self._data[key]
+
+    def __iter__(self):
+        self._check_if_mapping()
+        return iter(self._data)
+
+    def __len__(self):
+        self._check_if_mapping()
+        return len(self._data)
diff --git a/lib/rumps/packages/ordereddict.py b/lib/rumps/packages/ordereddict.py
index 34ba259d..c416b5a1 100644
--- a/lib/rumps/packages/ordereddict.py
+++ b/lib/rumps/packages/ordereddict.py
@@ -82,7 +82,7 @@ class OrderedDict(dict):
     def clear(self):
         'od.clear() -> None.  Remove all items from od.'
         try:
-            for node in self.__map.itervalues():
+            for node in self.__map.values():
                 del node[:]
             root = self.__root
             root[:] = [root, root, None]
diff --git a/lib/rumps/rumps.py b/lib/rumps/rumps.py
index b3fa19f5..00148cb9 100644
--- a/lib/rumps/rumps.py
+++ b/lib/rumps/rumps.py
@@ -1,38 +1,32 @@
-#!/usr/bin/env python
 # -*- coding: utf-8 -*-
-#
-# rumps: Ridiculously Uncomplicated macOS Python Statusbar apps.
-# Copyright: (c) 2017, Jared Suttles. All rights reserved.
-# License: BSD, see LICENSE for details.
-# - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 
-_NOTIFICATIONS = True
+# rumps: Ridiculously Uncomplicated macOS Python Statusbar apps.
+# Copyright: (c) 2020, Jared Suttles. All rights reserved.
+# License: BSD, see LICENSE for details.
+
 
 # For compatibility with pyinstaller
 # See: http://stackoverflow.com/questions/21058889/pyinstaller-not-finding-pyobjc-library-macos-python
 import Foundation
 import AppKit
 
-try:
-    from Foundation import NSUserNotification, NSUserNotificationCenter
-except ImportError:
-    _NOTIFICATIONS = False
-
 from Foundation import (NSDate, NSTimer, NSRunLoop, NSDefaultRunLoopMode, NSSearchPathForDirectoriesInDomains,
-                        NSMakeRect, NSLog, NSObject, NSMutableDictionary, NSString)
-from AppKit import NSApplication, NSStatusBar, NSMenu, NSMenuItem, NSAlert, NSTextField, NSSecureTextField, NSImage, NSSlider, NSSize
+                        NSMakeRect, NSLog, NSObject, NSMutableDictionary, NSString, NSUserDefaults)
+from AppKit import NSApplication, NSStatusBar, NSMenu, NSMenuItem, NSAlert, NSTextField, NSSecureTextField, NSImage, NSSlider, NSSize, NSWorkspace, NSWorkspaceWillSleepNotification, NSWorkspaceDidWakeNotification
 from PyObjCTools import AppHelper
 
-import inspect
 import os
 import pickle
-import sys
 import traceback
 import weakref
 
-from collections import Mapping, Iterable
+from .compat import text_type, string_types, iteritems, collections_abc
+from .text_field import Editing, SecureEditing
 from .utils import ListDict
-from .compat import text_type, string_types, iteritems
+
+from . import _internal
+from . import events
+from . import notifications
 
 _TIMERS = weakref.WeakKeyDictionary()
 separator = object()
@@ -78,11 +72,13 @@ def alert(title=None, message='', ok=None, cancel=None, other=None, icon_path=No
     message = message.replace('%', '%%')
     if title is not None:
         title = text_type(title)
-    _require_string_or_none(ok)
+    _internal.require_string_or_none(ok)
     if not isinstance(cancel, string_types):
         cancel = 'Cancel' if cancel else None
     alert = NSAlert.alertWithMessageText_defaultButton_alternateButton_otherButton_informativeTextWithFormat_(
         title, ok, cancel, other, message)
+    if NSUserDefaults.standardUserDefaults().stringForKey_('AppleInterfaceStyle') == 'Dark':
+        alert.window().setAppearance_(AppKit.NSAppearance.appearanceNamed_('NSAppearanceNameVibrantDark'))
     alert.setAlertStyle_(0)  # informational style
     if icon_path is not None:
         icon = _nsimage_from_file(icon_path)
@@ -91,119 +87,6 @@ def alert(title=None, message='', ok=None, cancel=None, other=None, icon_path=No
     return alert.runModal()
 
 
-def _gather_info_issue_9():
-    missing_plist = False
-    missing_bundle_ident = False
-    info_plist_path = os.path.join(os.path.dirname(sys.executable), 'Info.plist')
-    try:
-        with open(info_plist_path) as f:
-            import plistlib
-            try:
-                load_plist = plistlib.load
-            except AttributeError:
-                load_plist = plistlib.readPlist
-            try:
-                load_plist(f)['CFBundleIdentifier']
-            except Exception:
-                missing_bundle_ident = True
-
-    except IOError as e:
-        import errno
-        if e.errno == errno.ENOENT:  # No such file or directory
-            missing_plist = True
-
-    info = '\n\n'
-    if missing_plist:
-        info += 'In this case there is no file at "%(info_plist_path)s"'
-        info += '\n\n'
-        confidence = 'should'
-    elif missing_bundle_ident:
-        info += 'In this case the file at "%(info_plist_path)s" does not contain a value for "CFBundleIdentifier"'
-        info += '\n\n'
-        confidence = 'should'
-    else:
-        confidence = 'may'
-    info += 'Running the following command %(confidence)s fix the issue:\n'
-    info += '/usr/libexec/PlistBuddy -c \'Add :CFBundleIdentifier string "rumps"\' %(info_plist_path)s\n'
-    return info % {'info_plist_path': info_plist_path, 'confidence': confidence}
-
-
-def _default_user_notification_center():
-    notification_center = NSUserNotificationCenter.defaultUserNotificationCenter()
-    if notification_center is None:
-        info = (
-            'Failed to setup the notification center. This issue occurs when the "Info.plist" file '
-            'cannot be found or is missing "CFBundleIdentifier".'
-        )
-        try:
-            info += _gather_info_issue_9()
-        except Exception:
-            pass
-        raise RuntimeError(info)
-    else:
-        return notification_center
-
-
-def notification(title, subtitle, message, data=None, sound=True, action_button=None, other_button=None,
-                 has_reply_button=False, icon=None):
-    """Send a notification to Notification Center (OS X 10.8+). If running on a version of macOS that does not
-    support notifications, a ``RuntimeError`` will be raised. Apple says,
-
-        "The userInfo content must be of reasonable serialized size (less than 1k) or an exception will be thrown."
-
-    So don't do that!
-
-    :param title: text in a larger font.
-    :param subtitle: text in a smaller font below the `title`.
-    :param message: text representing the body of the notification below the `subtitle`.
-    :param data: will be passed to the application's "notification center" (see :func:`rumps.notifications`) when this
-                 notification is clicked.
-    :param sound: whether the notification should make a noise when it arrives.
-    :param action_button: title for the action button.
-    :param other_button: title for the other button.
-    :param has_reply_button: whether or not the notification has a reply button.
-    :param icon: the filename of an image for the notification's icon, will replace the default.
-    """
-    if not _NOTIFICATIONS:
-        raise RuntimeError('OS X 10.8+ is required to send notifications')
-
-    if data is not None and not isinstance(data, Mapping):
-        raise TypeError('notification data must be a mapping')
-
-    _require_string_or_none(title, subtitle, message)
-
-    notification = NSUserNotification.alloc().init()
-
-    notification.setTitle_(title)
-    notification.setSubtitle_(subtitle)
-    notification.setInformativeText_(message)
-
-    if data is not None:
-        app = getattr(App, '*app_instance')
-        dumped = app.serializer.dumps(data)
-        ns_dict = NSMutableDictionary.alloc().init()
-        ns_string = NSString.alloc().initWithString_(dumped)
-        ns_dict.setDictionary_({'value': ns_string})
-        notification.setUserInfo_(ns_dict)
-
-    if icon is not None:
-        notification.set_identityImage_(_nsimage_from_file(icon))
-    if sound:
-        notification.setSoundName_("NSUserNotificationDefaultSoundName")
-    if action_button:
-        notification.setActionButtonTitle_(action_button)
-        notification.set_showsButtons_(True)
-    if other_button:
-        notification.setOtherButtonTitle_(other_button)
-        notification.set_showsButtons_(True)
-    if has_reply_button:
-        notification.setHasReplyButton_(True)
-
-    notification.setDeliveryDate_(NSDate.dateWithTimeInterval_sinceDate_(0, NSDate.date()))
-    notification_center = _default_user_notification_center()
-    notification_center.scheduleNotification_(notification)
-
-
 def application_support(name):
     """Return the application support folder path for the given `name`, creating it if it doesn't exist."""
     app_support_path = os.path.join(NSSearchPathForDirectoriesInDomains(14, 1, 1).objectAtIndex_(0), name)
@@ -248,18 +131,6 @@ def _nsimage_from_file(filename, dimensions=None, template=None):
     return image
 
 
-def _require_string(*objs):
-    for obj in objs:
-        if not isinstance(obj, string_types):
-            raise TypeError('a string is required but given {0}, a {1}'.format(obj, type(obj).__name__))
-
-
-def _require_string_or_none(*objs):
-    for obj in objs:
-        if not(obj is None or isinstance(obj, string_types)):
-            raise TypeError('a string or None is required but given {0}, a {1}'.format(obj, type(obj).__name__))
-
-
 # Decorators and helper function serving to register functions for dealing with interaction and events
 #- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 def timer(interval):
@@ -365,36 +236,6 @@ def slider(*args, **options):
         return f
     return decorator
 
-
-def notifications(f):
-    """Decorator for registering a function to serve as a "notification center" for the application. This function will
-    receive the data associated with an incoming macOS notification sent using :func:`rumps.notification`. This occurs
-    whenever the user clicks on a notification for this application in the macOS Notification Center.
-
-    .. code-block:: python
-
-        @rumps.notifications
-        def notification_center(info):
-            if 'unix' in info:
-                print 'i know this'
-
-    """
-    notifications.__dict__['*notification_center'] = f
-    return f
-
-
-def _call_as_function_or_method(func, event):
-    # The idea here is that when using decorators in a class, the functions passed are not bound so we have to
-    # determine later if the functions we have (those saved as callbacks) for particular events need to be passed
-    # 'self'.
-    #
-    # This works for an App subclass method or a standalone decorated function. Will attempt to find function as
-    # a bound method of the App instance. If it is found, use it, otherwise simply call function.
-    app = getattr(App, '*app_instance')
-    for name, method in inspect.getmembers(app, predicate=inspect.ismethod):
-        if method.__func__ is func:
-            return method(event)
-    return func(event)
 #- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 
 
@@ -468,14 +309,14 @@ class Menu(ListDict):
                 menu.add(iterable)
                 return
 
-            for n, ele in enumerate(iteritems(iterable) if isinstance(iterable, Mapping) else iterable):
+            for n, ele in enumerate(iteritems(iterable) if isinstance(iterable, collections_abc.Mapping) else iterable):
 
                 # for mappings we recurse but don't drop down a level in the menu
-                if not isinstance(ele, MenuItem) and isinstance(ele, Mapping):
+                if not isinstance(ele, MenuItem) and isinstance(ele, collections_abc.Mapping):
                     parse_menu(ele, menu, depth)
 
                 # any iterables other than strings and MenuItems
-                elif not isinstance(ele, (string_types, MenuItem)) and isinstance(ele, Iterable):
+                elif not isinstance(ele, (string_types, MenuItem)) and isinstance(ele, collections_abc.Iterable):
                     try:
                         menuitem, submenu = ele
                     except TypeError:
@@ -580,7 +421,7 @@ class MenuItem(Menu):
     # NOTE:
     # Because of the quirks of PyObjC, a class level dictionary **inside an NSObject subclass for 10.9.x** is required
     # in order to have callback_ be a @classmethod. And we need callback_ to be class level because we can't use
-    # instances in setTarget_ method of NSMenuItem. Otherwise this would be much more straightfoward like Timer class.
+    # instances in setTarget_ method of NSMenuItem. Otherwise this would be much more straightforward like Timer class.
     #
     # So the target is always the NSApp class and action is always the @classmethod callback_ -- for every function
     # decorated with @clicked(...). All we do is lookup the MenuItem instance and the user-provided callback function
@@ -690,6 +531,35 @@ class MenuItem(Menu):
     def state(self, new_state):
         self._menuitem.setState_(new_state)
 
+    @property
+    def hidden(self):
+        """Indicates whether the menu item is hidden.
+
+        .. versionadded:: 0.4.0
+
+        """
+        return self._menuitem.isHidden()
+
+    @hidden.setter
+    def hidden(self, value):
+        self._menuitem.setHidden_(value)
+
+    def hide(self):
+        """Hide the menu item.
+
+        .. versionadded:: 0.4.0
+
+        """
+        self.hidden = True
+
+    def show(self):
+        """Show the menu item.
+
+        .. versionadded:: 0.4.0
+
+        """
+        self.hidden = False
+
     def set_callback(self, callback, key=None):
         """Set the function serving as callback for when a click event occurs on this menu item. When `callback` is
         ``None``, it will disable the callback function and grey out the menu item. If `key` is a string, set as the
@@ -703,7 +573,7 @@ class MenuItem(Menu):
         :param callback: the function to be called when the user clicks on this menu item.
         :param key: the key shortcut to click this menu item.
         """
-        _require_string_or_none(key)
+        _internal.require_string_or_none(key)
         if key is not None:
             self._menuitem.setKeyEquivalent_(key)
         NSApp._ns_to_py_and_callback[self._menuitem] = self, callback
@@ -744,7 +614,7 @@ class SliderMenuItem(object):
         self._slider = NSSlider.alloc().init()
         self._slider.setMinValue_(min_value)
         self._slider.setMaxValue_(max_value)
-        self._slider.setValue_(value)
+        self._slider.setDoubleValue_(value)
         self._slider.setFrameSize_(NSSize(*dimensions))
         self._slider.setTarget_(NSApp)
         self._menuitem = NSMenuItem.alloc().init()
@@ -774,11 +644,11 @@ class SliderMenuItem(object):
     @property
     def value(self):
         """The current position of the slider."""
-        return self._slider.value()
+        return self._slider.doubleValue()
 
     @value.setter
     def value(self, new_value):
-        self._slider.setValue_(new_value)
+        self._slider.setDoubleValue_(new_value)
 
 
 class SeparatorMenuItem(object):
@@ -860,9 +730,9 @@ class Timer(object):
     def callback_(self, _):
         _log(self)
         try:
-            return _call_as_function_or_method(getattr(self, '*callback'), self)
+            return _internal.call_as_function_or_method(getattr(self, '*callback'), self)
         except Exception:
-            _log(traceback.format_exc())
+            traceback.print_exc()
 
 
 class Window(object):
@@ -899,7 +769,7 @@ class Window(object):
         self._cancel = bool(cancel)
         self._icon = None
 
-        _require_string_or_none(ok)
+        _internal.require_string_or_none(ok)
         if not isinstance(cancel, string_types):
             cancel = 'Cancel' if cancel else None
 
@@ -908,9 +778,9 @@ class Window(object):
         self._alert.setAlertStyle_(0)  # informational style
 
         if secure:
-            self._textfield = NSSecureTextField.alloc().initWithFrame_(NSMakeRect(0, 0, *dimensions))
+            self._textfield = SecureEditing.alloc().initWithFrame_(NSMakeRect(0, 0, *dimensions))
         else:
-            self._textfield = NSTextField.alloc().initWithFrame_(NSMakeRect(0, 0, *dimensions))
+            self._textfield = Editing.alloc().initWithFrame_(NSMakeRect(0, 0, *dimensions))
         self._textfield.setSelectable_(True)
         self._alert.setAccessoryView_(self._textfield)
 
@@ -982,7 +852,7 @@ class Window(object):
 
         :param name: the text for a new button. Must be a string.
         """
-        _require_string(name)
+        _internal.require_string(name)
         self._alert.addButtonWithTitle_(name)
 
     def add_buttons(self, iterable=None, *args):
@@ -1009,6 +879,8 @@ class Window(object):
         :return: a :class:`rumps.rumps.Response` object that contains the text and the button clicked as an integer.
         """
         _log(self)
+        if NSUserDefaults.standardUserDefaults().stringForKey_('AppleInterfaceStyle') == 'Dark':
+            self._alert.window().setAppearance_(AppKit.NSAppearance.appearanceNamed_('NSAppearanceNameVibrantDark'))
         clicked = self._alert.runModal() % 999
         if clicked > 2 and self._cancel:
             clicked -= 1
@@ -1062,27 +934,7 @@ class NSApp(NSObject):
     _ns_to_py_and_callback = {}
 
     def userNotificationCenter_didActivateNotification_(self, notification_center, notification):
-        notification_center.removeDeliveredNotification_(notification)
-        ns_dict = notification.userInfo()
-        if ns_dict is None:
-            data = None
-        else:
-            dumped = ns_dict['value']
-            app = getattr(App, '*app_instance')
-            data = app.serializer.loads(dumped)
-
-        try:
-            notification_function = getattr(notifications, '*notification_center')
-        except AttributeError:  # notification center function not specified -> no error but warning in log
-            _log('WARNING: notification received but no function specified for answering it; use @notifications '
-                 'decorator to register a function.')
-        else:
-            try:
-                data['activationType'] = notification.activationType()
-                data['actualDeliveryDate'] = notification.actualDeliveryDate()
-                _call_as_function_or_method(notification_function, data)
-            except Exception:
-                _log(traceback.format_exc())
+        notifications._clicked(notification_center, notification)
 
     def initializeStatusBar(self):
         self.nsstatusitem = NSStatusBar.systemStatusBar().statusItemWithLength_(-1)  # variable dimensions
@@ -1113,14 +965,42 @@ class NSApp(NSObject):
         if not (self.nsstatusitem.title() or self.nsstatusitem.image()):
             self.nsstatusitem.setTitle_(self._app['_name'])
 
+    def applicationDidFinishLaunching_(self, notification):
+        workspace          = NSWorkspace.sharedWorkspace()
+        notificationCenter = workspace.notificationCenter()
+        notificationCenter.addObserver_selector_name_object_(
+            self,
+            self.receiveSleepNotification_,
+            NSWorkspaceWillSleepNotification,
+            None
+        )
+        notificationCenter.addObserver_selector_name_object_(
+            self,
+            self.receiveWakeNotification_,
+            NSWorkspaceDidWakeNotification,
+            None
+        )
+
+    def receiveSleepNotification_(self, ns_notification):
+        _log('receiveSleepNotification')
+        events.on_sleep.emit()
+
+    def receiveWakeNotification_(self, ns_notification):
+        _log('receiveWakeNotification')
+        events.on_wake.emit()
+
+    def applicationWillTerminate_(self, ns_notification):
+        _log('applicationWillTerminate')
+        events.before_quit.emit()
+
     @classmethod
     def callback_(cls, nsmenuitem):
         self, callback = cls._ns_to_py_and_callback[nsmenuitem]
         _log(self)
         try:
-            return _call_as_function_or_method(callback, self)
+            return _internal.call_as_function_or_method(callback, self)
         except Exception:
-            _log(traceback.format_exc())
+            traceback.print_exc()
 
 
 class App(object):
@@ -1150,7 +1030,7 @@ class App(object):
     serializer = pickle
 
     def __init__(self, name, title=None, icon=None, template=None, menu=None, quit_button='Quit'):
-        _require_string(name)
+        _internal.require_string(name)
         self._name = name
         self._icon = self._icon_nsimage = self._title = None
         self._template = template
@@ -1186,7 +1066,7 @@ class App(object):
 
     @title.setter
     def title(self, title):
-        _require_string_or_none(title)
+        _internal.require_string_or_none(title)
         self._title = title
         try:
             self._nsapp.setStatusBarTitle()
@@ -1308,13 +1188,7 @@ class App(object):
         self._nsapp = NSApp.alloc().init()
         self._nsapp._app = self.__dict__  # allow for dynamic modification based on this App instance
         nsapplication.setDelegate_(self._nsapp)
-        if _NOTIFICATIONS:
-            try:
-                notification_center = _default_user_notification_center()
-            except RuntimeError:
-                pass
-            else:
-                notification_center.setDelegate_(self._nsapp)
+        notifications._init_nsapp(self._nsapp)
 
         setattr(App, '*app_instance', self)  # class level ref to running instance (for passing self to App subclasses)
         t = b = None
@@ -1326,4 +1200,6 @@ class App(object):
 
         self._nsapp.initializeStatusBar()
 
+        AppHelper.installMachInterrupt()
+        events.before_start.emit()
         AppHelper.runEventLoop()
diff --git a/lib/rumps/text_field.py b/lib/rumps/text_field.py
new file mode 100644
index 00000000..f33f0ff4
--- /dev/null
+++ b/lib/rumps/text_field.py
@@ -0,0 +1,32 @@
+from AppKit import NSApplication, NSTextField, NSSecureTextField, NSKeyDown, NSCommandKeyMask
+
+
+class Editing(NSTextField):
+    """NSTextField with cut, copy, paste, undo and selectAll"""
+    def performKeyEquivalent_(self, event):
+        return _perform_key_equivalent(self, event)
+
+
+class SecureEditing(NSSecureTextField):
+    """NSSecureTextField with cut, copy, paste, undo and selectAll"""
+    def performKeyEquivalent_(self, event):
+        return _perform_key_equivalent(self, event)
+
+
+def _perform_key_equivalent(self, event):
+    if event.type() == NSKeyDown and event.modifierFlags() & NSCommandKeyMask:
+        if event.charactersIgnoringModifiers() == "x":
+            NSApplication.sharedApplication().sendAction_to_from_("cut:", None, self)
+            return True
+        elif event.charactersIgnoringModifiers() == "c":
+            NSApplication.sharedApplication().sendAction_to_from_("copy:", None, self)
+            return True
+        elif event.charactersIgnoringModifiers() == "v":
+            NSApplication.sharedApplication().sendAction_to_from_("paste:", None, self)
+            return True
+        elif event.charactersIgnoringModifiers() == "z":
+            NSApplication.sharedApplication().sendAction_to_from_("undo:", None, self)
+            return True
+        elif event.charactersIgnoringModifiers() == "a":
+            NSApplication.sharedApplication().sendAction_to_from_("selectAll:", None, self)
+            return True
diff --git a/lib/rumps/utils.py b/lib/rumps/utils.py
index 7480a081..eb71b9b8 100644
--- a/lib/rumps/utils.py
+++ b/lib/rumps/utils.py
@@ -1,10 +1,15 @@
-#!/usr/bin/env python
 # -*- coding: utf-8 -*-
-#
-# rumps: Ridiculously Uncomplicated macOS Python Statusbar apps.
-# Copyright: (c) 2017, Jared Suttles. All rights reserved.
-# License: BSD, see LICENSE for details.
-# - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+
+"""
+rumps.utils
+~~~~~~~~~~~
+
+Generic container classes and utility functions.
+
+:copyright: (c) 2020 by Jared Suttles
+:license: BSD-3-Clause, see LICENSE for details.
+"""
+
 from .packages.ordereddict import OrderedDict as _OrderedDict
 
 
diff --git a/requirements.txt b/requirements.txt
index 7b597123..a0e0c1b9 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -37,7 +37,7 @@ python-twitter==3.5
 pytz==2022.6
 requests==2.28.1
 requests-oauthlib==1.3.1
-rumps==0.3.0; platform_system == "Darwin"
+rumps==0.4.0; platform_system == "Darwin"
 simplejson==3.17.6
 six==1.16.0
 soupsieve==2.3.2.post1

From 60da55933277c46574dfa25c12fe24969cfe63aa Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 14 Nov 2022 11:27:25 -0800
Subject: [PATCH 238/743] Bump pyjwt from 2.4.0 to 2.6.0 (#1897)

* Bump pyjwt from 2.4.0 to 2.6.0

Bumps [pyjwt](https://github.com/jpadilla/pyjwt) from 2.4.0 to 2.6.0.
- [Release notes](https://github.com/jpadilla/pyjwt/releases)
- [Changelog](https://github.com/jpadilla/pyjwt/blob/master/CHANGELOG.rst)
- [Commits](https://github.com/jpadilla/pyjwt/compare/2.4.0...2.6.0)

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

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

* Update pyjwt==2.6.0

Signed-off-by: dependabot[bot] <support@github.com>
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/jwt/__init__.py      |   4 +-
 lib/jwt/algorithms.py    |  37 ++++++++++-
 lib/jwt/api_jwk.py       |  34 ++++++++--
 lib/jwt/api_jws.py       | 134 ++++++++++++++++++++++++---------------
 lib/jwt/api_jwt.py       |  78 +++++++++++++++++++----
 lib/jwt/help.py          |  18 +++---
 lib/jwt/jwk_set_cache.py |  32 ++++++++++
 lib/jwt/jwks_client.py   |  82 +++++++++++++++++++-----
 lib/jwt/utils.py         |   6 +-
 lib/jwt/warnings.py      |   2 +
 requirements.txt         |   2 +-
 11 files changed, 326 insertions(+), 103 deletions(-)
 create mode 100644 lib/jwt/jwk_set_cache.py
 create mode 100644 lib/jwt/warnings.py

diff --git a/lib/jwt/__init__.py b/lib/jwt/__init__.py
index 6b3f8ab1..26c79b24 100644
--- a/lib/jwt/__init__.py
+++ b/lib/jwt/__init__.py
@@ -1,6 +1,7 @@
 from .api_jwk import PyJWK, PyJWKSet
 from .api_jws import (
     PyJWS,
+    get_algorithm_by_name,
     get_unverified_header,
     register_algorithm,
     unregister_algorithm,
@@ -25,7 +26,7 @@ from .exceptions import (
 )
 from .jwks_client import PyJWKClient
 
-__version__ = "2.4.0"
+__version__ = "2.6.0"
 
 __title__ = "PyJWT"
 __description__ = "JSON Web Token implementation in Python"
@@ -51,6 +52,7 @@ __all__ = [
     "get_unverified_header",
     "register_algorithm",
     "unregister_algorithm",
+    "get_algorithm_by_name",
     # Exceptions
     "DecodeError",
     "ExpiredSignatureError",
diff --git a/lib/jwt/algorithms.py b/lib/jwt/algorithms.py
index 46a1a532..93fadf4c 100644
--- a/lib/jwt/algorithms.py
+++ b/lib/jwt/algorithms.py
@@ -439,6 +439,41 @@ if has_crypto:
             except InvalidSignature:
                 return False
 
+        @staticmethod
+        def to_jwk(key_obj):
+
+            if isinstance(key_obj, EllipticCurvePrivateKey):
+                public_numbers = key_obj.public_key().public_numbers()
+            elif isinstance(key_obj, EllipticCurvePublicKey):
+                public_numbers = key_obj.public_numbers()
+            else:
+                raise InvalidKeyError("Not a public or private key")
+
+            if isinstance(key_obj.curve, ec.SECP256R1):
+                crv = "P-256"
+            elif isinstance(key_obj.curve, ec.SECP384R1):
+                crv = "P-384"
+            elif isinstance(key_obj.curve, ec.SECP521R1):
+                crv = "P-521"
+            elif isinstance(key_obj.curve, ec.SECP256K1):
+                crv = "secp256k1"
+            else:
+                raise InvalidKeyError(f"Invalid curve: {key_obj.curve}")
+
+            obj = {
+                "kty": "EC",
+                "crv": crv,
+                "x": to_base64url_uint(public_numbers.x).decode(),
+                "y": to_base64url_uint(public_numbers.y).decode(),
+            }
+
+            if isinstance(key_obj, EllipticCurvePrivateKey):
+                obj["d"] = to_base64url_uint(
+                    key_obj.private_numbers().private_value
+                ).decode()
+
+            return json.dumps(obj)
+
         @staticmethod
         def from_jwk(jwk):
             try:
@@ -574,7 +609,7 @@ if has_crypto:
             Sign a message ``msg`` using the EdDSA private key ``key``
             :param str|bytes msg: Message to sign
             :param Ed25519PrivateKey}Ed448PrivateKey key: A :class:`.Ed25519PrivateKey`
-                or :class:`.Ed448PrivateKey` iinstance
+                or :class:`.Ed448PrivateKey` isinstance
             :return bytes signature: The signature, as bytes
             """
             msg = bytes(msg, "utf-8") if type(msg) is not bytes else msg
diff --git a/lib/jwt/api_jwk.py b/lib/jwt/api_jwk.py
index 31250d57..aa3dd321 100644
--- a/lib/jwt/api_jwk.py
+++ b/lib/jwt/api_jwk.py
@@ -1,4 +1,7 @@
+from __future__ import annotations
+
 import json
+import time
 
 from .algorithms import get_default_algorithms
 from .exceptions import InvalidKeyError, PyJWKError, PyJWKSetError
@@ -74,17 +77,24 @@ class PyJWK:
 
 
 class PyJWKSet:
-    def __init__(self, keys):
+    def __init__(self, keys: list[dict]) -> None:
         self.keys = []
 
-        if not keys or not isinstance(keys, list):
-            raise PyJWKSetError("Invalid JWK Set value")
-
-        if len(keys) == 0:
+        if not keys:
             raise PyJWKSetError("The JWK Set did not contain any keys")
 
+        if not isinstance(keys, list):
+            raise PyJWKSetError("Invalid JWK Set value")
+
         for key in keys:
-            self.keys.append(PyJWK(key))
+            try:
+                self.keys.append(PyJWK(key))
+            except PyJWKError:
+                # skip unusable keys
+                continue
+
+        if len(self.keys) == 0:
+            raise PyJWKSetError("The JWK Set did not contain any usable keys")
 
     @staticmethod
     def from_dict(obj):
@@ -101,3 +111,15 @@ class PyJWKSet:
             if key.key_id == kid:
                 return key
         raise KeyError(f"keyset has no key for kid: {kid}")
+
+
+class PyJWTSetWithTimestamp:
+    def __init__(self, jwk_set: PyJWKSet):
+        self.jwk_set = jwk_set
+        self.timestamp = time.monotonic()
+
+    def get_jwk_set(self):
+        return self.jwk_set
+
+    def get_timestamp(self):
+        return self.timestamp
diff --git a/lib/jwt/api_jws.py b/lib/jwt/api_jws.py
index cbf4f6f5..ab8490f9 100644
--- a/lib/jwt/api_jws.py
+++ b/lib/jwt/api_jws.py
@@ -1,7 +1,9 @@
+from __future__ import annotations
+
 import binascii
 import json
-from collections.abc import Mapping
-from typing import Any, Dict, List, Optional, Type
+import warnings
+from typing import Any, Type
 
 from .algorithms import (
     Algorithm,
@@ -16,12 +18,13 @@ from .exceptions import (
     InvalidTokenError,
 )
 from .utils import base64url_decode, base64url_encode
+from .warnings import RemovedInPyjwt3Warning
 
 
 class PyJWS:
     header_typ = "JWT"
 
-    def __init__(self, algorithms=None, options=None):
+    def __init__(self, algorithms=None, options=None) -> None:
         self._algorithms = get_default_algorithms()
         self._valid_algs = (
             set(algorithms) if algorithms is not None else set(self._algorithms)
@@ -37,10 +40,10 @@ class PyJWS:
         self.options = {**self._get_default_options(), **options}
 
     @staticmethod
-    def _get_default_options():
+    def _get_default_options() -> dict[str, bool]:
         return {"verify_signature": True}
 
-    def register_algorithm(self, alg_id, alg_obj):
+    def register_algorithm(self, alg_id: str, alg_obj: Algorithm) -> None:
         """
         Registers a new Algorithm for use when creating and verifying tokens.
         """
@@ -53,7 +56,7 @@ class PyJWS:
         self._algorithms[alg_id] = alg_obj
         self._valid_algs.add(alg_id)
 
-    def unregister_algorithm(self, alg_id):
+    def unregister_algorithm(self, alg_id: str) -> None:
         """
         Unregisters an Algorithm for use when creating and verifying tokens
         Throws KeyError if algorithm is not registered.
@@ -67,38 +70,55 @@ class PyJWS:
         del self._algorithms[alg_id]
         self._valid_algs.remove(alg_id)
 
-    def get_algorithms(self):
+    def get_algorithms(self) -> list[str]:
         """
         Returns a list of supported values for the 'alg' parameter.
         """
         return list(self._valid_algs)
 
+    def get_algorithm_by_name(self, alg_name: str) -> Algorithm:
+        """
+        For a given string name, return the matching Algorithm object.
+
+        Example usage:
+
+        >>> jws_obj.get_algorithm_by_name("RS256")
+        """
+        try:
+            return self._algorithms[alg_name]
+        except KeyError as e:
+            if not has_crypto and alg_name in requires_cryptography:
+                raise NotImplementedError(
+                    f"Algorithm '{alg_name}' could not be found. Do you have cryptography installed?"
+                ) from e
+            raise NotImplementedError("Algorithm not supported") from e
+
     def encode(
         self,
         payload: bytes,
         key: str,
-        algorithm: Optional[str] = "HS256",
-        headers: Optional[Dict] = None,
-        json_encoder: Optional[Type[json.JSONEncoder]] = None,
+        algorithm: str | None = "HS256",
+        headers: dict[str, Any] | None = None,
+        json_encoder: Type[json.JSONEncoder] | None = None,
         is_payload_detached: bool = False,
     ) -> str:
         segments = []
 
-        if algorithm is None:
-            algorithm = "none"
+        # declare a new var to narrow the type for type checkers
+        algorithm_: str = algorithm if algorithm is not None else "none"
 
         # Prefer headers values if present to function parameters.
         if headers:
             headers_alg = headers.get("alg")
             if headers_alg:
-                algorithm = headers["alg"]
+                algorithm_ = headers["alg"]
 
             headers_b64 = headers.get("b64")
             if headers_b64 is False:
                 is_payload_detached = True
 
         # Header
-        header = {"typ": self.header_typ, "alg": algorithm}  # type: Dict[str, Any]
+        header: dict[str, Any] = {"typ": self.header_typ, "alg": algorithm_}
 
         if headers:
             self._validate_headers(headers)
@@ -113,8 +133,9 @@ class PyJWS:
             # True is the standard value for b64, so no need for it
             del header["b64"]
 
+        # Fix for headers misorder - issue #715
         json_header = json.dumps(
-            header, separators=(",", ":"), cls=json_encoder
+            header, separators=(",", ":"), cls=json_encoder, sort_keys=True
         ).encode()
 
         segments.append(base64url_encode(json_header))
@@ -128,17 +149,9 @@ class PyJWS:
         # Segments
         signing_input = b".".join(segments)
 
-        try:
-            alg_obj = self._algorithms[algorithm]
-            key = alg_obj.prepare_key(key)
-            signature = alg_obj.sign(signing_input, key)
-
-        except KeyError as e:
-            if not has_crypto and algorithm in requires_cryptography:
-                raise NotImplementedError(
-                    f"Algorithm '{algorithm}' could not be found. Do you have cryptography installed?"
-                ) from e
-            raise NotImplementedError("Algorithm not supported") from e
+        alg_obj = self.get_algorithm_by_name(algorithm_)
+        key = alg_obj.prepare_key(key)
+        signature = alg_obj.sign(signing_input, key)
 
         segments.append(base64url_encode(signature))
 
@@ -153,11 +166,18 @@ class PyJWS:
         self,
         jwt: str,
         key: str = "",
-        algorithms: Optional[List[str]] = None,
-        options: Optional[Dict] = None,
-        detached_payload: Optional[bytes] = None,
+        algorithms: list[str] | None = None,
+        options: dict[str, Any] | None = None,
+        detached_payload: bytes | None = None,
         **kwargs,
-    ) -> Dict[str, Any]:
+    ) -> dict[str, Any]:
+        if kwargs:
+            warnings.warn(
+                "passing additional kwargs to decode_complete() is deprecated "
+                "and will be removed in pyjwt version 3. "
+                f"Unsupported kwargs: {tuple(kwargs.keys())}",
+                RemovedInPyjwt3Warning,
+            )
         if options is None:
             options = {}
         merged_options = {**self.options, **options}
@@ -191,14 +211,24 @@ class PyJWS:
         self,
         jwt: str,
         key: str = "",
-        algorithms: Optional[List[str]] = None,
-        options: Optional[Dict] = None,
+        algorithms: list[str] | None = None,
+        options: dict[str, Any] | None = None,
+        detached_payload: bytes | None = None,
         **kwargs,
     ) -> str:
-        decoded = self.decode_complete(jwt, key, algorithms, options, **kwargs)
+        if kwargs:
+            warnings.warn(
+                "passing additional kwargs to decode() is deprecated "
+                "and will be removed in pyjwt version 3. "
+                f"Unsupported kwargs: {tuple(kwargs.keys())}",
+                RemovedInPyjwt3Warning,
+            )
+        decoded = self.decode_complete(
+            jwt, key, algorithms, options, detached_payload=detached_payload
+        )
         return decoded["payload"]
 
-    def get_unverified_header(self, jwt):
+    def get_unverified_header(self, jwt: str | bytes) -> dict:
         """Returns back the JWT header parameters as a dict()
 
         Note: The signature is not verified so the header parameters
@@ -209,7 +239,7 @@ class PyJWS:
 
         return headers
 
-    def _load(self, jwt):
+    def _load(self, jwt: str | bytes) -> tuple[bytes, bytes, dict, bytes]:
         if isinstance(jwt, str):
             jwt = jwt.encode("utf-8")
 
@@ -232,7 +262,7 @@ class PyJWS:
         except ValueError as e:
             raise DecodeError(f"Invalid header string: {e}") from e
 
-        if not isinstance(header, Mapping):
+        if not isinstance(header, dict):
             raise DecodeError("Invalid header string: must be a json object")
 
         try:
@@ -249,33 +279,32 @@ class PyJWS:
 
     def _verify_signature(
         self,
-        signing_input,
-        header,
-        signature,
-        key="",
-        algorithms=None,
-    ):
+        signing_input: bytes,
+        header: dict,
+        signature: bytes,
+        key: str = "",
+        algorithms: list[str] | None = None,
+    ) -> None:
 
         alg = header.get("alg")
 
-        if algorithms is not None and alg not in algorithms:
+        if not alg or (algorithms is not None and alg not in algorithms):
             raise InvalidAlgorithmError("The specified alg value is not allowed")
 
         try:
-            alg_obj = self._algorithms[alg]
-            key = alg_obj.prepare_key(key)
-
-            if not alg_obj.verify(signing_input, key, signature):
-                raise InvalidSignatureError("Signature verification failed")
-
-        except KeyError as e:
+            alg_obj = self.get_algorithm_by_name(alg)
+        except NotImplementedError as e:
             raise InvalidAlgorithmError("Algorithm not supported") from e
+        key = alg_obj.prepare_key(key)
 
-    def _validate_headers(self, headers):
+        if not alg_obj.verify(signing_input, key, signature):
+            raise InvalidSignatureError("Signature verification failed")
+
+    def _validate_headers(self, headers: dict[str, Any]) -> None:
         if "kid" in headers:
             self._validate_kid(headers["kid"])
 
-    def _validate_kid(self, kid):
+    def _validate_kid(self, kid: str) -> None:
         if not isinstance(kid, str):
             raise InvalidTokenError("Key ID header parameter must be a string")
 
@@ -286,4 +315,5 @@ decode_complete = _jws_global_obj.decode_complete
 decode = _jws_global_obj.decode
 register_algorithm = _jws_global_obj.register_algorithm
 unregister_algorithm = _jws_global_obj.unregister_algorithm
+get_algorithm_by_name = _jws_global_obj.get_algorithm_by_name
 get_unverified_header = _jws_global_obj.get_unverified_header
diff --git a/lib/jwt/api_jwt.py b/lib/jwt/api_jwt.py
index 7d2177bf..4bb1ee1f 100644
--- a/lib/jwt/api_jwt.py
+++ b/lib/jwt/api_jwt.py
@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import json
 import warnings
 from calendar import timegm
@@ -15,6 +17,7 @@ from .exceptions import (
     InvalidIssuerError,
     MissingRequiredClaimError,
 )
+from .warnings import RemovedInPyjwt3Warning
 
 
 class PyJWT:
@@ -40,7 +43,7 @@ class PyJWT:
         payload: Dict[str, Any],
         key: str,
         algorithm: Optional[str] = "HS256",
-        headers: Optional[Dict] = None,
+        headers: Optional[Dict[str, Any]] = None,
         json_encoder: Optional[Type[json.JSONEncoder]] = None,
     ) -> str:
         # Check that we get a mapping
@@ -68,16 +71,33 @@ class PyJWT:
         jwt: str,
         key: str = "",
         algorithms: Optional[List[str]] = None,
-        options: Optional[Dict] = None,
+        options: Optional[Dict[str, Any]] = None,
+        # deprecated arg, remove in pyjwt3
+        verify: Optional[bool] = None,
+        # could be used as passthrough to api_jws, consider removal in pyjwt3
+        detached_payload: Optional[bytes] = None,
+        # passthrough arguments to _validate_claims
+        # consider putting in options
+        audience: Optional[Union[str, Iterable[str]]] = None,
+        issuer: Optional[str] = None,
+        leeway: Union[int, float, timedelta] = 0,
+        # kwargs
         **kwargs,
     ) -> Dict[str, Any]:
+        if kwargs:
+            warnings.warn(
+                "passing additional kwargs to decode_complete() is deprecated "
+                "and will be removed in pyjwt version 3. "
+                f"Unsupported kwargs: {tuple(kwargs.keys())}",
+                RemovedInPyjwt3Warning,
+            )
         options = dict(options or {})  # shallow-copy or initialize an empty dict
         options.setdefault("verify_signature", True)
 
         # If the user has set the legacy `verify` argument, and it doesn't match
         # what the relevant `options` entry for the argument is, inform the user
         # that they're likely making a mistake.
-        if "verify" in kwargs and kwargs["verify"] != options["verify_signature"]:
+        if verify is not None and verify != options["verify_signature"]:
             warnings.warn(
                 "The `verify` argument to `decode` does nothing in PyJWT 2.0 and newer. "
                 "The equivalent is setting `verify_signature` to False in the `options` dictionary. "
@@ -102,7 +122,7 @@ class PyJWT:
             key=key,
             algorithms=algorithms,
             options=options,
-            **kwargs,
+            detached_payload=detached_payload,
         )
 
         try:
@@ -113,7 +133,9 @@ class PyJWT:
             raise DecodeError("Invalid payload string: must be a json object")
 
         merged_options = {**self.options, **options}
-        self._validate_claims(payload, merged_options, **kwargs)
+        self._validate_claims(
+            payload, merged_options, audience=audience, issuer=issuer, leeway=leeway
+        )
 
         decoded["payload"] = payload
         return decoded
@@ -123,20 +145,45 @@ class PyJWT:
         jwt: str,
         key: str = "",
         algorithms: Optional[List[str]] = None,
-        options: Optional[Dict] = None,
+        options: Optional[Dict[str, Any]] = None,
+        # deprecated arg, remove in pyjwt3
+        verify: Optional[bool] = None,
+        # could be used as passthrough to api_jws, consider removal in pyjwt3
+        detached_payload: Optional[bytes] = None,
+        # passthrough arguments to _validate_claims
+        # consider putting in options
+        audience: Optional[Union[str, Iterable[str]]] = None,
+        issuer: Optional[str] = None,
+        leeway: Union[int, float, timedelta] = 0,
+        # kwargs
         **kwargs,
     ) -> Dict[str, Any]:
-        decoded = self.decode_complete(jwt, key, algorithms, options, **kwargs)
+        if kwargs:
+            warnings.warn(
+                "passing additional kwargs to decode() is deprecated "
+                "and will be removed in pyjwt version 3. "
+                f"Unsupported kwargs: {tuple(kwargs.keys())}",
+                RemovedInPyjwt3Warning,
+            )
+        decoded = self.decode_complete(
+            jwt,
+            key,
+            algorithms,
+            options,
+            verify=verify,
+            detached_payload=detached_payload,
+            audience=audience,
+            issuer=issuer,
+            leeway=leeway,
+        )
         return decoded["payload"]
 
-    def _validate_claims(
-        self, payload, options, audience=None, issuer=None, leeway=0, **kwargs
-    ):
+    def _validate_claims(self, payload, options, audience=None, issuer=None, leeway=0):
         if isinstance(leeway, timedelta):
             leeway = leeway.total_seconds()
 
-        if not isinstance(audience, (bytes, str, type(None), Iterable)):
-            raise TypeError("audience must be a string, iterable, or None")
+        if audience is not None and not isinstance(audience, (str, Iterable)):
+            raise TypeError("audience must be a string, iterable or None")
 
         self._validate_required_claims(payload, options)
 
@@ -163,10 +210,13 @@ class PyJWT:
                 raise MissingRequiredClaimError(claim)
 
     def _validate_iat(self, payload, now, leeway):
+        iat = payload["iat"]
         try:
-            int(payload["iat"])
+            int(iat)
         except ValueError:
             raise InvalidIssuedAtError("Issued At claim (iat) must be an integer.")
+        if iat > (now + leeway):
+            raise ImmatureSignatureError("The token is not yet valid (iat)")
 
     def _validate_nbf(self, payload, now, leeway):
         try:
@@ -183,7 +233,7 @@ class PyJWT:
         except ValueError:
             raise DecodeError("Expiration Time claim (exp) must be an" " integer.")
 
-        if exp < (now - leeway):
+        if exp <= (now - leeway):
             raise ExpiredSignatureError("Signature has expired")
 
     def _validate_aud(self, payload, audience):
diff --git a/lib/jwt/help.py b/lib/jwt/help.py
index d5c3ebbf..0c02eb92 100644
--- a/lib/jwt/help.py
+++ b/lib/jwt/help.py
@@ -1,16 +1,17 @@
 import json
 import platform
 import sys
+from typing import Dict
 
 from . import __version__ as pyjwt_version
 
 try:
     import cryptography
 except ModuleNotFoundError:
-    cryptography = None  # type: ignore
+    cryptography = None
 
 
-def info():
+def info() -> Dict[str, Dict[str, str]]:
     """
     Generate information for a bug report.
     Based on the requests package help utility module.
@@ -28,14 +29,15 @@ def info():
     if implementation == "CPython":
         implementation_version = platform.python_version()
     elif implementation == "PyPy":
+        pypy_version_info = getattr(sys, "pypy_version_info")
         implementation_version = (
-            f"{sys.pypy_version_info.major}."
-            f"{sys.pypy_version_info.minor}."
-            f"{sys.pypy_version_info.micro}"
+            f"{pypy_version_info.major}."
+            f"{pypy_version_info.minor}."
+            f"{pypy_version_info.micro}"
         )
-        if sys.pypy_version_info.releaselevel != "final":
+        if pypy_version_info.releaselevel != "final":
             implementation_version = "".join(
-                [implementation_version, sys.pypy_version_info.releaselevel]
+                [implementation_version, pypy_version_info.releaselevel]
             )
     else:
         implementation_version = "Unknown"
@@ -51,7 +53,7 @@ def info():
     }
 
 
-def main():
+def main() -> None:
     """Pretty-print the bug information as JSON."""
     print(json.dumps(info(), sort_keys=True, indent=2))
 
diff --git a/lib/jwt/jwk_set_cache.py b/lib/jwt/jwk_set_cache.py
new file mode 100644
index 00000000..e8c2a7e0
--- /dev/null
+++ b/lib/jwt/jwk_set_cache.py
@@ -0,0 +1,32 @@
+import time
+from typing import Optional
+
+from .api_jwk import PyJWKSet, PyJWTSetWithTimestamp
+
+
+class JWKSetCache:
+    def __init__(self, lifespan: int):
+        self.jwk_set_with_timestamp: Optional[PyJWTSetWithTimestamp] = None
+        self.lifespan = lifespan
+
+    def put(self, jwk_set: PyJWKSet):
+        if jwk_set is not None:
+            self.jwk_set_with_timestamp = PyJWTSetWithTimestamp(jwk_set)
+        else:
+            # clear cache
+            self.jwk_set_with_timestamp = None
+
+    def get(self) -> Optional[PyJWKSet]:
+        if self.jwk_set_with_timestamp is None or self.is_expired():
+            return None
+
+        return self.jwk_set_with_timestamp.get_jwk_set()
+
+    def is_expired(self) -> bool:
+
+        return (
+            self.jwk_set_with_timestamp is not None
+            and self.lifespan > -1
+            and time.monotonic()
+            > self.jwk_set_with_timestamp.get_timestamp() + self.lifespan
+        )
diff --git a/lib/jwt/jwks_client.py b/lib/jwt/jwks_client.py
index 767b7179..b4e98007 100644
--- a/lib/jwt/jwks_client.py
+++ b/lib/jwt/jwks_client.py
@@ -1,31 +1,68 @@
 import json
 import urllib.request
 from functools import lru_cache
-from typing import Any, List
+from typing import Any, List, Optional
+from urllib.error import URLError
 
 from .api_jwk import PyJWK, PyJWKSet
 from .api_jwt import decode_complete as decode_token
 from .exceptions import PyJWKClientError
+from .jwk_set_cache import JWKSetCache
 
 
 class PyJWKClient:
-    def __init__(self, uri: str, cache_keys: bool = True, max_cached_keys: int = 16):
+    def __init__(
+        self,
+        uri: str,
+        cache_keys: bool = False,
+        max_cached_keys: int = 16,
+        cache_jwk_set: bool = True,
+        lifespan: int = 300,
+    ):
         self.uri = uri
+        self.jwk_set_cache: Optional[JWKSetCache] = None
+
+        if cache_jwk_set:
+            # Init jwt set cache with default or given lifespan.
+            # Default lifespan is 300 seconds (5 minutes).
+            if lifespan <= 0:
+                raise PyJWKClientError(
+                    f'Lifespan must be greater than 0, the input is "{lifespan}"'
+                )
+            self.jwk_set_cache = JWKSetCache(lifespan)
+        else:
+            self.jwk_set_cache = None
+
         if cache_keys:
             # Cache signing keys
             # Ignore mypy (https://github.com/python/mypy/issues/2427)
             self.get_signing_key = lru_cache(maxsize=max_cached_keys)(self.get_signing_key)  # type: ignore
 
     def fetch_data(self) -> Any:
-        with urllib.request.urlopen(self.uri) as response:
-            return json.load(response)
+        jwk_set: Any = None
+        try:
+            with urllib.request.urlopen(self.uri) as response:
+                jwk_set = json.load(response)
+        except URLError as e:
+            raise PyJWKClientError(f'Fail to fetch data from the url, err: "{e}"')
+        else:
+            return jwk_set
+        finally:
+            if self.jwk_set_cache is not None:
+                self.jwk_set_cache.put(jwk_set)
+
+    def get_jwk_set(self, refresh: bool = False) -> PyJWKSet:
+        data = None
+        if self.jwk_set_cache is not None and not refresh:
+            data = self.jwk_set_cache.get()
+
+        if data is None:
+            data = self.fetch_data()
 
-    def get_jwk_set(self) -> PyJWKSet:
-        data = self.fetch_data()
         return PyJWKSet.from_dict(data)
 
-    def get_signing_keys(self) -> List[PyJWK]:
-        jwk_set = self.get_jwk_set()
+    def get_signing_keys(self, refresh: bool = False) -> List[PyJWK]:
+        jwk_set = self.get_jwk_set(refresh)
         signing_keys = [
             jwk_set_key
             for jwk_set_key in jwk_set.keys
@@ -39,17 +76,17 @@ class PyJWKClient:
 
     def get_signing_key(self, kid: str) -> PyJWK:
         signing_keys = self.get_signing_keys()
-        signing_key = None
-
-        for key in signing_keys:
-            if key.key_id == kid:
-                signing_key = key
-                break
+        signing_key = self.match_kid(signing_keys, kid)
 
         if not signing_key:
-            raise PyJWKClientError(
-                f'Unable to find a signing key that matches: "{kid}"'
-            )
+            # If no matching signing key from the jwk set, refresh the jwk set and try again.
+            signing_keys = self.get_signing_keys(refresh=True)
+            signing_key = self.match_kid(signing_keys, kid)
+
+            if not signing_key:
+                raise PyJWKClientError(
+                    f'Unable to find a signing key that matches: "{kid}"'
+                )
 
         return signing_key
 
@@ -57,3 +94,14 @@ class PyJWKClient:
         unverified = decode_token(token, options={"verify_signature": False})
         header = unverified["header"]
         return self.get_signing_key(header.get("kid"))
+
+    @staticmethod
+    def match_kid(signing_keys: List[PyJWK], kid: str) -> Optional[PyJWK]:
+        signing_key = None
+
+        for key in signing_keys:
+            if key.key_id == kid:
+                signing_key = key
+                break
+
+        return signing_key
diff --git a/lib/jwt/utils.py b/lib/jwt/utils.py
index 8ab73b42..16cae066 100644
--- a/lib/jwt/utils.py
+++ b/lib/jwt/utils.py
@@ -1,7 +1,7 @@
 import base64
 import binascii
 import re
-from typing import Any, Union
+from typing import Union
 
 try:
     from cryptography.hazmat.primitives.asymmetric.ec import EllipticCurve
@@ -10,7 +10,7 @@ try:
         encode_dss_signature,
     )
 except ModuleNotFoundError:
-    EllipticCurve = Any  # type: ignore
+    EllipticCurve = None
 
 
 def force_bytes(value: Union[str, bytes]) -> bytes:
@@ -136,7 +136,7 @@ def is_pem_format(key: bytes) -> bool:
 
 # Based on https://github.com/pyca/cryptography/blob/bcb70852d577b3f490f015378c75cba74986297b/src/cryptography/hazmat/primitives/serialization/ssh.py#L40-L46
 _CERT_SUFFIX = b"-cert-v01@openssh.com"
-_SSH_PUBKEY_RC = re.compile(br"\A(\S+)[ \t]+(\S+)")
+_SSH_PUBKEY_RC = re.compile(rb"\A(\S+)[ \t]+(\S+)")
 _SSH_KEY_FORMATS = [
     b"ssh-ed25519",
     b"ssh-rsa",
diff --git a/lib/jwt/warnings.py b/lib/jwt/warnings.py
new file mode 100644
index 00000000..8762a8cb
--- /dev/null
+++ b/lib/jwt/warnings.py
@@ -0,0 +1,2 @@
+class RemovedInPyjwt3Warning(DeprecationWarning):
+    pass
diff --git a/requirements.txt b/requirements.txt
index a0e0c1b9..ac0b1975 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -30,7 +30,7 @@ paho-mqtt==1.6.1
 plexapi==4.13.1
 portend==3.1.0
 profilehooks==1.12.0
-PyJWT==2.4.0
+PyJWT==2.6.0
 pyparsing==3.0.9
 python-dateutil==2.8.2
 python-twitter==3.5

From 259a96995a3310e7a42e800e9f9d3a90718c73ca Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 15 Nov 2022 15:55:50 -0800
Subject: [PATCH 239/743] Bump simplejson from 3.17.6 to 3.18.0 (#1898)

* Bump simplejson from 3.17.6 to 3.18.0

Bumps [simplejson](https://github.com/simplejson/simplejson) from 3.17.6 to 3.18.0.
- [Release notes](https://github.com/simplejson/simplejson/releases)
- [Changelog](https://github.com/simplejson/simplejson/blob/master/CHANGES.txt)
- [Commits](https://github.com/simplejson/simplejson/compare/v3.17.6...v3.18.0)

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

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

* Update simplejson==3.18.0

Signed-off-by: dependabot[bot] <support@github.com>
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/simplejson/__init__.py              |  4 +--
 lib/simplejson/decoder.py               |  2 ++
 lib/simplejson/encoder.py               | 45 +++++++++++++++----------
 lib/simplejson/tests/test_namedtuple.py | 29 ++++++++++++++--
 lib/simplejson/tests/test_scanstring.py |  2 ++
 requirements.txt                        |  2 +-
 6 files changed, 61 insertions(+), 23 deletions(-)

diff --git a/lib/simplejson/__init__.py b/lib/simplejson/__init__.py
index 20327ead..c79ad1bc 100644
--- a/lib/simplejson/__init__.py
+++ b/lib/simplejson/__init__.py
@@ -118,7 +118,7 @@ Serializing multiple objects to JSON lines (newline-delimited JSON)::
 
 """
 from __future__ import absolute_import
-__version__ = '3.17.6'
+__version__ = '3.18.0'
 __all__ = [
     'dump', 'dumps', 'load', 'loads',
     'JSONDecoder', 'JSONDecodeError', 'JSONEncoder',
@@ -300,7 +300,7 @@ def dumps(obj, skipkeys=False, ensure_ascii=True, check_circular=True,
           iterable_as_array=False, **kw):
     """Serialize ``obj`` to a JSON formatted ``str``.
 
-    If ``skipkeys`` is false then ``dict`` keys that are not basic types
+    If ``skipkeys`` is true then ``dict`` keys that are not basic types
     (``str``, ``int``, ``long``, ``float``, ``bool``, ``None``)
     will be skipped instead of raising a ``TypeError``.
 
diff --git a/lib/simplejson/decoder.py b/lib/simplejson/decoder.py
index 7f0b0568..1a8f772f 100644
--- a/lib/simplejson/decoder.py
+++ b/lib/simplejson/decoder.py
@@ -109,6 +109,8 @@ def py_scanstring(s, end, encoding=None, strict=True,
                 uni = int(esc, 16)
             except ValueError:
                 raise JSONDecodeError(msg, s, end - 1)
+            if uni < 0 or uni > _maxunicode:
+                raise JSONDecodeError(msg, s, end - 1)
             end += 5
             # Check for surrogate pair on UCS-4 systems
             # Note that this will join high/low surrogate pairs
diff --git a/lib/simplejson/encoder.py b/lib/simplejson/encoder.py
index 2f81cabc..2bc8bbad 100644
--- a/lib/simplejson/encoder.py
+++ b/lib/simplejson/encoder.py
@@ -450,6 +450,15 @@ def _make_iterencode(markers, _default, _encoder, _indent, _floatstr,
          not isinstance(_int_as_string_bitcount, integer_types))):
         raise TypeError("int_as_string_bitcount must be a positive integer")
 
+    def call_method(obj, method_name):
+        method = getattr(obj, method_name, None)
+        if callable(method):
+            try:
+                return (method(),)
+            except TypeError:
+                pass
+        return None
+
     def _encode_int(value):
         skip_quoting = (
             _int_as_string_bitcount is None
@@ -512,15 +521,15 @@ def _make_iterencode(markers, _default, _encoder, _indent, _floatstr,
                 yield buf + str(value)
             else:
                 yield buf
-                for_json = _for_json and getattr(value, 'for_json', None)
-                if for_json and callable(for_json):
-                    chunks = _iterencode(for_json(), _current_indent_level)
+                for_json = _for_json and call_method(value, 'for_json')
+                if for_json:
+                    chunks = _iterencode(for_json[0], _current_indent_level)
                 elif isinstance(value, list):
                     chunks = _iterencode_list(value, _current_indent_level)
                 else:
-                    _asdict = _namedtuple_as_object and getattr(value, '_asdict', None)
-                    if _asdict and callable(_asdict):
-                        dct = _asdict()
+                    _asdict = _namedtuple_as_object and call_method(value, '_asdict')
+                    if _asdict:
+                        dct = _asdict[0]
                         if not isinstance(dct, dict):
                             raise TypeError("_asdict() must return a dict, not %s" % (type(dct).__name__,))
                         chunks = _iterencode_dict(dct,
@@ -636,15 +645,15 @@ def _make_iterencode(markers, _default, _encoder, _indent, _floatstr,
             elif _use_decimal and isinstance(value, Decimal):
                 yield str(value)
             else:
-                for_json = _for_json and getattr(value, 'for_json', None)
-                if for_json and callable(for_json):
-                    chunks = _iterencode(for_json(), _current_indent_level)
+                for_json = _for_json and call_method(value, 'for_json')
+                if for_json:
+                    chunks = _iterencode(for_json[0], _current_indent_level)
                 elif isinstance(value, list):
                     chunks = _iterencode_list(value, _current_indent_level)
                 else:
-                    _asdict = _namedtuple_as_object and getattr(value, '_asdict', None)
-                    if _asdict and callable(_asdict):
-                        dct = _asdict()
+                    _asdict = _namedtuple_as_object and call_method(value, '_asdict')
+                    if _asdict:
+                        dct = _asdict[0]
                         if not isinstance(dct, dict):
                             raise TypeError("_asdict() must return a dict, not %s" % (type(dct).__name__,))
                         chunks = _iterencode_dict(dct,
@@ -682,17 +691,17 @@ def _make_iterencode(markers, _default, _encoder, _indent, _floatstr,
         elif isinstance(o, float):
             yield _floatstr(o)
         else:
-            for_json = _for_json and getattr(o, 'for_json', None)
-            if for_json and callable(for_json):
-                for chunk in _iterencode(for_json(), _current_indent_level):
+            for_json = _for_json and call_method(o, 'for_json')
+            if for_json:
+                for chunk in _iterencode(for_json[0], _current_indent_level):
                     yield chunk
             elif isinstance(o, list):
                 for chunk in _iterencode_list(o, _current_indent_level):
                     yield chunk
             else:
-                _asdict = _namedtuple_as_object and getattr(o, '_asdict', None)
-                if _asdict and callable(_asdict):
-                    dct = _asdict()
+                _asdict = _namedtuple_as_object and call_method(o, '_asdict')
+                if _asdict:
+                    dct = _asdict[0]
                     if not isinstance(dct, dict):
                         raise TypeError("_asdict() must return a dict, not %s" % (type(dct).__name__,))
                     for chunk in _iterencode_dict(dct, _current_indent_level):
diff --git a/lib/simplejson/tests/test_namedtuple.py b/lib/simplejson/tests/test_namedtuple.py
index 8035a5f5..cc0f8aa1 100644
--- a/lib/simplejson/tests/test_namedtuple.py
+++ b/lib/simplejson/tests/test_namedtuple.py
@@ -110,22 +110,47 @@ class TestNamedTuple(unittest.TestCase):
 
     def test_asdict_not_callable_dump(self):
         for f in CONSTRUCTORS:
-            self.assertRaises(TypeError,
-                json.dump, f(DeadDuck()), StringIO(), namedtuple_as_object=True)
+            self.assertRaises(
+                TypeError,
+                json.dump,
+                f(DeadDuck()),
+                StringIO(),
+                namedtuple_as_object=True
+            )
             sio = StringIO()
             json.dump(f(DeadDict()), sio, namedtuple_as_object=True)
             self.assertEqual(
                 json.dumps(f({})),
                 sio.getvalue())
+            self.assertRaises(
+                TypeError,
+                json.dump,
+                f(Value),
+                StringIO(),
+                namedtuple_as_object=True
+            )
 
     def test_asdict_not_callable_dumps(self):
         for f in CONSTRUCTORS:
             self.assertRaises(TypeError,
                 json.dumps, f(DeadDuck()), namedtuple_as_object=True)
+            self.assertRaises(
+                TypeError,
+                json.dumps,
+                f(Value),
+                namedtuple_as_object=True
+            )
             self.assertEqual(
                 json.dumps(f({})),
                 json.dumps(f(DeadDict()), namedtuple_as_object=True))
 
+    def test_asdict_unbound_method_dumps(self):
+        for f in CONSTRUCTORS:
+            self.assertEqual(
+                json.dumps(f(Value), default=lambda v: v.__name__),
+                json.dumps(f(Value.__name__))
+            )
+
     def test_asdict_does_not_return_dict(self):
         if not mock:
             if hasattr(unittest, "SkipTest"):
diff --git a/lib/simplejson/tests/test_scanstring.py b/lib/simplejson/tests/test_scanstring.py
index d5de1801..c6c53b81 100644
--- a/lib/simplejson/tests/test_scanstring.py
+++ b/lib/simplejson/tests/test_scanstring.py
@@ -132,6 +132,8 @@ class TestScanString(TestCase):
             self.assertRaises(ValueError,
                               scanstring, '\\ud834\\x0123"', 0, None, True)
 
+        self.assertRaises(json.JSONDecodeError, scanstring, "\\u-123", 0, None, True)
+
     def test_issue3623(self):
         self.assertRaises(ValueError, json.decoder.scanstring, "xxx", 1,
                           "xxx")
diff --git a/requirements.txt b/requirements.txt
index ac0b1975..827ed814 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -38,7 +38,7 @@ pytz==2022.6
 requests==2.28.1
 requests-oauthlib==1.3.1
 rumps==0.4.0; platform_system == "Darwin"
-simplejson==3.17.6
+simplejson==3.18.0
 six==1.16.0
 soupsieve==2.3.2.post1
 tempora==5.0.2

From 192dd64dbe7b344d61e005d59d971dc0c8773541 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 15 Nov 2022 15:56:03 -0800
Subject: [PATCH 240/743] Bump mako from 1.2.3 to 1.2.4 (#1899)

* Bump mako from 1.2.3 to 1.2.4

Bumps [mako](https://github.com/sqlalchemy/mako) from 1.2.3 to 1.2.4.
- [Release notes](https://github.com/sqlalchemy/mako/releases)
- [Changelog](https://github.com/sqlalchemy/mako/blob/main/CHANGES)
- [Commits](https://github.com/sqlalchemy/mako/commits)

---
updated-dependencies:
- dependency-name: mako
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

* Update mako==1.2.4

Signed-off-by: dependabot[bot] <support@github.com>
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/mako/__init__.py | 2 +-
 lib/mako/codegen.py  | 9 +++++++--
 requirements.txt     | 2 +-
 3 files changed, 9 insertions(+), 4 deletions(-)

diff --git a/lib/mako/__init__.py b/lib/mako/__init__.py
index 3d7dcb6d..d7339219 100644
--- a/lib/mako/__init__.py
+++ b/lib/mako/__init__.py
@@ -5,4 +5,4 @@
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
 
 
-__version__ = "1.2.3"
+__version__ = "1.2.4"
diff --git a/lib/mako/codegen.py b/lib/mako/codegen.py
index a9dbcb67..d1d2c20a 100644
--- a/lib/mako/codegen.py
+++ b/lib/mako/codegen.py
@@ -1251,8 +1251,13 @@ class _Identifiers:
 
 
 _FOR_LOOP = re.compile(
-    r"^for\s+((?:\(?)\s*[A-Za-z_][A-Za-z_0-9]*"
-    r"(?:\s*,\s*(?:[A-Za-z_][A-Za-z0-9_]*),??)*\s*(?:\)?))\s+in\s+(.*):"
+    r"^for\s+((?:\(?)\s*"
+    r"(?:\(?)\s*[A-Za-z_][A-Za-z_0-9]*"
+    r"(?:\s*,\s*(?:[A-Za-z_][A-Za-z_0-9]*),??)*\s*(?:\)?)"
+    r"(?:\s*,\s*(?:"
+    r"(?:\(?)\s*[A-Za-z_][A-Za-z_0-9]*"
+    r"(?:\s*,\s*(?:[A-Za-z_][A-Za-z_0-9]*),??)*\s*(?:\)?)"
+    r"),??)*\s*(?:\)?))\s+in\s+(.*):"
 )
 
 
diff --git a/requirements.txt b/requirements.txt
index 827ed814..98316136 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -22,7 +22,7 @@ importlib-metadata==5.0.0
 importlib-resources==5.10.0
 git+https://github.com/Tautulli/ipwhois.git@master#egg=ipwhois
 IPy==1.01
-Mako==1.2.3
+Mako==1.2.4
 MarkupSafe==2.1.1
 musicbrainzngs==0.7.1
 packaging==21.3

From 5a8797a6dd97329b41812f487486cf11387bcf81 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 14 Nov 2022 11:11:53 -0800
Subject: [PATCH 241/743] Shorten TLS log message

---
 plexpy/webstart.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/plexpy/webstart.py b/plexpy/webstart.py
index 964a8b75..c8ed258f 100644
--- a/plexpy/webstart.py
+++ b/plexpy/webstart.py
@@ -110,7 +110,7 @@ def initialize(options):
 
         min_tls_version = options['https_min_tls_version'].replace('.', '_')
         context.minimum_version = getattr(ssl.TLSVersion, min_tls_version, ssl.TLSVersion.TLSv1_2)
-        logger.debug("Tautulli WebStart :: Web server minimum TLS version set to %s.", context.minimum_version.name)
+        logger.debug("Tautulli WebStart :: Minimum TLS version set to %s.", context.minimum_version.name)
 
         context.load_cert_chain(https_cert, https_key)
 

From 8c552d30866337dd3843ccca69440359b78f72c9 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 21 Nov 2022 20:48:47 -0800
Subject: [PATCH 242/743] Only validate condition operator if parameter is
 present

---
 plexpy/notifiers.py | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/plexpy/notifiers.py b/plexpy/notifiers.py
index ffe3d40a..59b7a41f 100644
--- a/plexpy/notifiers.py
+++ b/plexpy/notifiers.py
@@ -732,12 +732,12 @@ def validate_conditions(custom_conditions):
             validated_condition['parameter'] = parameter.lower()
             validated_condition['type'] = parameter_type
 
-        if operator:
-            if operator not in CUSTOM_CONDITION_TYPE_OPERATORS.get(parameter_type, []):
-                logger.error("Tautulli Notifiers :: Invalid operator '%s' for parameter '%s' in custom condition: %s" % (operator, parameter, condition))
-                return False
+            if operator:
+                if operator not in CUSTOM_CONDITION_TYPE_OPERATORS.get(parameter_type, []):
+                    logger.error("Tautulli Notifiers :: Invalid operator '%s' for parameter '%s' in custom condition: %s" % (operator, parameter, condition))
+                    return False
 
-            validated_condition['operator'] = operator
+                validated_condition['operator'] = operator
 
         if values:
             if not isinstance(values, list):

From 94eb5cdef38657c69c5b00ee4bf63dfcfb66f5f3 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 24 Nov 2022 09:15:07 -0800
Subject: [PATCH 243/743] Add movie editionTitle to exporter

---
 plexpy/exporter.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/plexpy/exporter.py b/plexpy/exporter.py
index f9e4e893..62f4b2ba 100644
--- a/plexpy/exporter.py
+++ b/plexpy/exporter.py
@@ -185,6 +185,7 @@ class Export(object):
                 },
                 'duration': None,
                 'durationHuman': lambda o: helpers.human_duration(getattr(o, 'duration', 0)),
+                'editionTitle': None,
                 'fields': {
                     'name': None,
                     'locked': None
@@ -1267,7 +1268,7 @@ class Export(object):
             _media_type = 'movie'
             _metadata_levels = {
                 1: [
-                    'ratingKey', 'title', 'titleSort', 'originalTitle', 'originallyAvailableAt', 'year', 'addedAt',
+                    'ratingKey', 'title', 'titleSort', 'originalTitle', 'editionTitle', 'originallyAvailableAt', 'year', 'addedAt',
                     'rating', 'ratingImage', 'audienceRating', 'audienceRatingImage', 'userRating', 'contentRating',
                     'studio', 'tagline', 'summary', 'guid', 'duration', 'durationHuman', 'type'
                 ],

From e2326cd06ac71dd9e21dd69c5d2a05624b059ca5 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 29 Nov 2022 14:04:24 -0800
Subject: [PATCH 244/743] Mask more user and metadata fields for guest access

Fixes #1913
---
 plexpy/session.py | 82 ++++++++++++++++++++++++++++++++---------------
 1 file changed, 56 insertions(+), 26 deletions(-)

diff --git a/plexpy/session.py b/plexpy/session.py
index 1a4b8d3b..21c14430 100644
--- a/plexpy/session.py
+++ b/plexpy/session.py
@@ -211,33 +211,63 @@ def mask_session_info(list_of_dicts, mask_metadata=True):
     session_library_ids = get_session_shared_libraries()
     session_library_filters = get_session_library_filters()
 
-    keys_to_mask = {'user_id': '',
-                    'user': 'Plex User',
-                    'username': 'Plex User',
-                    'friendly_name': 'Plex User',
-                    'user_thumb': common.DEFAULT_USER_THUMB,
-                    'ip_address': 'N/A',
-                    'machine_id': '',
-                    'player': 'Player'
-                    }
+    keys_to_mask = {
+        'user_id': '',
+        'user': 'Plex User',
+        'username': 'Plex User',
+        'email': '',
+        'friendly_name': 'Plex User',
+        'user_thumb': common.DEFAULT_USER_THUMB,
+        'ip_address': 'N/A',
+        'ip_address_public': 'N/A',
+        'machine_id': '',
+        'player': 'Player'
+    }
 
-    metadata_to_mask = {'media_index': '0',
-                        'parent_media_index': '0',
-                        'art': common.DEFAULT_ART,
-                        'parent_thumb': common.DEFAULT_POSTER_THUMB,
-                        'grandparent_thumb': common.DEFAULT_POSTER_THUMB,
-                        'thumb': common.DEFAULT_POSTER_THUMB,
-                        'bif_thumb': '',
-                        'title': 'Plex Media',
-                        'parent_title': 'Plex Media',
-                        'grandparent_title': 'Plex Media',
-                        'original_title': 'Plex Media',
-                        'rating_key': '',
-                        'parent_rating_key': '',
-                        'grandparent_rating_key': '',
-                        'year': '',
-                        'last_played': 'Plex Media'
-                        }
+    metadata_to_mask = {
+        'actors': [],
+        'art': common.DEFAULT_ART,
+        'bif_thumb': '',
+        'content_rating': '',
+        'directors': [],
+        'edition_title': '',
+        'file': '',
+        'full_title': 'Plex Media',
+        'genres': [],
+        'grandparent_guid': '',
+        'grandparent_guids': [],
+        'grandparent_rating_key': '',
+        'grandparent_thumb': common.DEFAULT_POSTER_THUMB,
+        'grandparent_title': 'Plex Media',
+        'grandparent_year': '',
+        'guid': '',
+        'guids': [],
+        'labels': [],
+        'library_name': '',
+        'media_index': '0',
+        'original_title': 'Plex Media',
+        'originally_available_at': '',
+        'parent_guid': '',
+        'parent_guids': [],
+        'parent_media_index': '0',
+        'parent_rating_key': '',
+        'parent_thumb': common.DEFAULT_POSTER_THUMB,
+        'parent_title': 'Plex Media',
+        'parent_year': '',
+        'rating_key': '',
+        'section_id': '',
+        'shared_libraries': [],
+        'sort_title': 'Plex Media',
+        'studio': '',
+        'summary': '',
+        'tagline': '',
+        'thumb': common.DEFAULT_POSTER_THUMB,
+        'title': 'Plex Media',
+        'writers': [],
+        'year': '',
+
+        'last_played': 'Plex Media',
+    }
 
     list_of_dicts = friendly_name_to_username(list_of_dicts)
 

From 6156edf5feed9f9e3d9b6ef9bbb924407d469ed2 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 29 Nov 2022 20:55:14 -0800
Subject: [PATCH 245/743] Pin diddlesnaps/snapcraft-multiarch-action@v1.5.0

---
 .github/workflows/publish-snap.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/publish-snap.yml b/.github/workflows/publish-snap.yml
index da1959ea..5cd43a1b 100644
--- a/.github/workflows/publish-snap.yml
+++ b/.github/workflows/publish-snap.yml
@@ -38,7 +38,7 @@ jobs:
         uses: docker/setup-qemu-action@v2
 
       - name: Build Snap Package
-        uses: diddlesnaps/snapcraft-multiarch-action@v1
+        uses: diddlesnaps/snapcraft-multiarch-action@v1.5.0
         id: build
         with:
           architecture: ${{ matrix.architecture }}

From 8cfe60b485ec0f885644e057051c5d41aba647e1 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Wed, 21 Dec 2022 14:55:33 -0800
Subject: [PATCH 246/743] Add started and stopped notification parameters

* Closes #1931
---
 plexpy/common.py               | 6 ++++++
 plexpy/notification_handler.py | 6 ++++++
 2 files changed, 12 insertions(+)

diff --git a/plexpy/common.py b/plexpy/common.py
index b6800d3c..33b4cc00 100644
--- a/plexpy/common.py
+++ b/plexpy/common.py
@@ -400,6 +400,12 @@ NOTIFICATION_PARAMETERS = [
              {'name': 'Player', 'type': 'str', 'value': 'player', 'description': 'The name of the player being used for playback.'},
              {'name': 'Initial Stream', 'type': 'int', 'value': 'initial_stream', 'description': 'If the stream is the initial stream of a continuous streaming session.', 'example': '0 or 1'},
              {'name': 'IP Address', 'type': 'str', 'value': 'ip_address', 'description': 'The IP address of the device being used for playback.'},
+             {'name': 'Started Datestamp', 'type': 'str', 'value': 'started_datestamp', 'description': 'The date (in date format) when the stream started.'},
+             {'name': 'Started Timestamp', 'type': 'str', 'value': 'started_timestamp', 'description': 'The time (in time format) when the stream started.'},
+             {'name': 'Started Unix Time', 'type': 'int', 'value': 'started_unixtime', 'description': 'The unix timestamp when the stream started.'},
+             {'name': 'Stopped Datestamp', 'type': 'str', 'value': 'stopped_datestamp', 'description': 'The date (in date format) when the stream stopped.'},
+             {'name': 'Stopped Timestamp', 'type': 'str', 'value': 'stopped_timestamp', 'description': 'The time (in time format) when the stream stopped.'},
+             {'name': 'Stopped Unix Time', 'type': 'int', 'value': 'stopped_unixtime', 'description': 'The unix timestamp when the stream stopped.'},
              {'name': 'Stream Duration', 'type': 'int', 'value': 'stream_duration', 'description': 'The duration (in minutes) for the stream.'},
              {'name': 'Stream Duration (sec)', 'type': 'int', 'value': 'stream_duration_sec', 'description': 'The duration (in seconds) for the stream.'},
              {'name': 'Stream Time', 'type': 'str', 'value': 'stream_time', 'description': 'The duration (in time format) of the stream.'},
diff --git a/plexpy/notification_handler.py b/plexpy/notification_handler.py
index 315bcb52..7c16de00 100644
--- a/plexpy/notification_handler.py
+++ b/plexpy/notification_handler.py
@@ -985,6 +985,12 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
         'product': notify_params['product'],
         'player': notify_params['player'],
         'ip_address': notify_params.get('ip_address', 'N/A'),
+        'started_datestamp': arrow.get(notify_params['started']).format(date_format),
+        'started_timestamp': arrow.get(notify_params['started']).format(time_format),
+        'started_unixtime': notify_params['started'],
+        'stopped_datestamp': arrow.get(notify_params['stopped']).format(date_format) if notify_params['stopped'] else '',
+        'stopped_timestamp': arrow.get(notify_params['stopped']).format(time_format) if notify_params['stopped'] else '',
+        'stopped_unixtime': notify_params['stopped'],
         'stream_duration': stream_duration,
         'stream_duration_sec': stream_duration_sec,
         'stream_time': arrow.get(stream_duration_sec).format(duration_format),

From 5f8fbe1230d1e35e013b29b0ee9d896d09572048 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Wed, 21 Dec 2022 15:13:14 -0800
Subject: [PATCH 247/743] Add meta color-scheme to newsletter template

* Allows CSS to support light and dark themes
---
 data/interfaces/newsletters/recently_added.html          | 1 +
 data/interfaces/newsletters/recently_added.internal.html | 1 +
 2 files changed, 2 insertions(+)

diff --git a/data/interfaces/newsletters/recently_added.html b/data/interfaces/newsletters/recently_added.html
index f4f6e8e8..e74d8463 100644
--- a/data/interfaces/newsletters/recently_added.html
+++ b/data/interfaces/newsletters/recently_added.html
@@ -24,6 +24,7 @@
 <html>
 <head>
     <meta name="viewport" content="width=device-width">
+    <meta name="color-scheme" content="light dark">
     <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
     <title>Tautulli Newsletter - ${subject}</title>
     <link rel="shortcut icon" href="${base_url_image + 'images/favicon/favicon.ico' if base_url_image else 'https://tautulli.com/images/favicon.ico'}">
diff --git a/data/interfaces/newsletters/recently_added.internal.html b/data/interfaces/newsletters/recently_added.internal.html
index 8253e281..edf7edc6 100644
--- a/data/interfaces/newsletters/recently_added.internal.html
+++ b/data/interfaces/newsletters/recently_added.internal.html
@@ -24,6 +24,7 @@
 <html>
 <head>
     <meta name="viewport" content="width=device-width"/>
+    <meta name="color-scheme" content="light dark">
     <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
     <title>Tautulli Newsletter - ${subject}</title>
     <link rel="shortcut icon" href="${base_url_image + 'images/favicon/favicon.ico' if base_url_image else 'https://tautulli.com/images/favicon.ico'}">

From 8a1cd2841b907a8bd15b31a4d6de4ddebf6ac39d Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 29 Nov 2022 20:55:14 -0800
Subject: [PATCH 248/743] Revert "Pin
 diddlesnaps/snapcraft-multiarch-action@v1.5.0"

This reverts commit 6156edf5feed9f9e3d9b6ef9bbb924407d469ed2.
---
 .github/workflows/publish-snap.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/publish-snap.yml b/.github/workflows/publish-snap.yml
index 5cd43a1b..da1959ea 100644
--- a/.github/workflows/publish-snap.yml
+++ b/.github/workflows/publish-snap.yml
@@ -38,7 +38,7 @@ jobs:
         uses: docker/setup-qemu-action@v2
 
       - name: Build Snap Package
-        uses: diddlesnaps/snapcraft-multiarch-action@v1.5.0
+        uses: diddlesnaps/snapcraft-multiarch-action@v1
         id: build
         with:
           architecture: ${{ matrix.architecture }}

From d7aa1ced53687bee7d3616cba925cd74deb39a7b Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 21 Dec 2022 15:41:04 -0800
Subject: [PATCH 249/743] Bump dessant/label-actions from 2 to 3 (#1916)

Bumps [dessant/label-actions](https://github.com/dessant/label-actions) from 2 to 3.
- [Release notes](https://github.com/dessant/label-actions/releases)
- [Changelog](https://github.com/dessant/label-actions/blob/master/CHANGELOG.md)
- [Commits](https://github.com/dessant/label-actions/compare/v2...v3)

---
updated-dependencies:
- dependency-name: dessant/label-actions
  dependency-type: direct:production
  update-type: version-update:semver-major
...

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

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 .github/workflows/issues.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/issues.yml b/.github/workflows/issues.yml
index 728cd8c9..34ceb357 100644
--- a/.github/workflows/issues.yml
+++ b/.github/workflows/issues.yml
@@ -10,6 +10,6 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Label Issues
-        uses: dessant/label-actions@v2
+        uses: dessant/label-actions@v3
         with:
           github-token: ${{ github.token }}

From ec08c887f44b745df0626b7207d630fdd3a34a81 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 21 Dec 2022 15:41:32 -0800
Subject: [PATCH 250/743] Bump actions/setup-python from 4.3.0 to 4.3.1 (#1921)

Bumps [actions/setup-python](https://github.com/actions/setup-python) from 4.3.0 to 4.3.1.
- [Release notes](https://github.com/actions/setup-python/releases)
- [Commits](https://github.com/actions/setup-python/compare/v4.3.0...v4.3.1)

---
updated-dependencies:
- dependency-name: actions/setup-python
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 .github/workflows/publish-installers.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/publish-installers.yml b/.github/workflows/publish-installers.yml
index 1c5f075b..a5190f79 100644
--- a/.github/workflows/publish-installers.yml
+++ b/.github/workflows/publish-installers.yml
@@ -52,7 +52,7 @@ jobs:
           echo $GITHUB_SHA > version.txt
 
       - name: Set Up Python
-        uses: actions/setup-python@v4.3.0
+        uses: actions/setup-python@v4.3.1
         with:
           python-version: '3.9'
           cache: pip

From d00916331da81fee7767abc528029c0fa4e804c3 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 21 Dec 2022 15:41:48 -0800
Subject: [PATCH 251/743] Bump actions/checkout from 3.1.0 to 3.2.0 (#1924)

Bumps [actions/checkout](https://github.com/actions/checkout) from 3.1.0 to 3.2.0.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v3.1.0...v3.2.0)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

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

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 .github/workflows/publish-docker.yml     | 2 +-
 .github/workflows/publish-installers.yml | 4 ++--
 .github/workflows/publish-snap.yml       | 2 +-
 .github/workflows/pull-requests.yml      | 2 +-
 4 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/publish-docker.yml b/.github/workflows/publish-docker.yml
index 3f6af320..aca4efed 100644
--- a/.github/workflows/publish-docker.yml
+++ b/.github/workflows/publish-docker.yml
@@ -13,7 +13,7 @@ jobs:
     if: ${{ !contains(github.event.head_commit.message, '[skip ci]') }}
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v3.1.0
+        uses: actions/checkout@v3.2.0
 
       - name: Prepare
         id: prepare
diff --git a/.github/workflows/publish-installers.yml b/.github/workflows/publish-installers.yml
index a5190f79..7002834b 100644
--- a/.github/workflows/publish-installers.yml
+++ b/.github/workflows/publish-installers.yml
@@ -24,7 +24,7 @@ jobs:
 
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v3.1.0
+        uses: actions/checkout@v3.2.0
 
       - name: Set Release Version
         id: get_version
@@ -103,7 +103,7 @@ jobs:
         uses: technote-space/workflow-conclusion-action@v3.0
 
       - name: Checkout Code
-        uses: actions/checkout@v3.1.0
+        uses: actions/checkout@v3.2.0
 
       - name: Set Release Version
         id: get_version
diff --git a/.github/workflows/publish-snap.yml b/.github/workflows/publish-snap.yml
index da1959ea..7ad8fe95 100644
--- a/.github/workflows/publish-snap.yml
+++ b/.github/workflows/publish-snap.yml
@@ -20,7 +20,7 @@ jobs:
           - armhf
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v3.1.0
+        uses: actions/checkout@v3.2.0
 
       - name: Prepare
         id: prepare
diff --git a/.github/workflows/pull-requests.yml b/.github/workflows/pull-requests.yml
index d15b9140..d7c8e45d 100644
--- a/.github/workflows/pull-requests.yml
+++ b/.github/workflows/pull-requests.yml
@@ -10,7 +10,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v3.1.0
+        uses: actions/checkout@v3.2.0
 
       - name: Comment on Pull Request
         uses: mshick/add-pr-comment@v2

From ff81b0849119f0f806fe86fbf026977d35478f21 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 21 Dec 2022 15:42:02 -0800
Subject: [PATCH 252/743] Bump actions/cache from 3.0.11 to 3.2.0 (#1936)

Bumps [actions/cache](https://github.com/actions/cache) from 3.0.11 to 3.2.0.
- [Release notes](https://github.com/actions/cache/releases)
- [Changelog](https://github.com/actions/cache/blob/main/RELEASES.md)
- [Commits](https://github.com/actions/cache/compare/v3.0.11...v3.2.0)

---
updated-dependencies:
- dependency-name: actions/cache
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

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

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 .github/workflows/publish-docker.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/publish-docker.yml b/.github/workflows/publish-docker.yml
index aca4efed..125cae51 100644
--- a/.github/workflows/publish-docker.yml
+++ b/.github/workflows/publish-docker.yml
@@ -47,7 +47,7 @@ jobs:
           version: latest
 
       - name: Cache Docker Layers
-        uses: actions/cache@v3.0.11
+        uses: actions/cache@v3.2.0
         with:
           path: /tmp/.buildx-cache
           key: ${{ runner.os }}-buildx-${{ github.sha }}

From d736fab432303ea48e58bf9fa2829f17604c6a31 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 21 Dec 2022 15:42:30 -0800
Subject: [PATCH 253/743] Bump actions/stale from 6 to 7 (#1937)

Bumps [actions/stale](https://github.com/actions/stale) from 6 to 7.
- [Release notes](https://github.com/actions/stale/releases)
- [Changelog](https://github.com/actions/stale/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/stale/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/stale
  dependency-type: direct:production
  update-type: version-update:semver-major
...

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

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 .github/workflows/issues-stale.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/issues-stale.yml b/.github/workflows/issues-stale.yml
index 75c1e08f..0643cb0a 100644
--- a/.github/workflows/issues-stale.yml
+++ b/.github/workflows/issues-stale.yml
@@ -10,7 +10,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Stale
-        uses: actions/stale@v6
+        uses: actions/stale@v7
         with:
           stale-issue-message: >
             This issue is stale because it has been open for 30 days with no activity.
@@ -30,7 +30,7 @@ jobs:
           days-before-close: 5
 
       - name: Invalid Template
-        uses: actions/stale@v6
+        uses: actions/stale@v7
         with:
           stale-issue-message: >
             Invalid issues template.

From 0a5edebea33855330ad98f14dd3a703daf940295 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 21 Dec 2022 15:58:39 -0800
Subject: [PATCH 254/743] Bump tempora from 5.0.2 to 5.1.0 (#1902)

* Bump tempora from 5.0.2 to 5.1.0

Bumps [tempora](https://github.com/jaraco/tempora) from 5.0.2 to 5.1.0.
- [Release notes](https://github.com/jaraco/tempora/releases)
- [Changelog](https://github.com/jaraco/tempora/blob/main/CHANGES.rst)
- [Commits](https://github.com/jaraco/tempora/compare/v5.0.2...v5.1.0)

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

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

* Update tempora==5.1.0

Signed-off-by: dependabot[bot] <support@github.com>
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/more_itertools/more.py |  0
 lib/tempora/__init__.py    | 38 +++++++++++++++++++++++++-------------
 lib/tempora/schedule.py    |  2 +-
 lib/tempora/timing.py      |  2 +-
 requirements.txt           |  2 +-
 5 files changed, 28 insertions(+), 16 deletions(-)
 mode change 100644 => 100755 lib/more_itertools/more.py

diff --git a/lib/more_itertools/more.py b/lib/more_itertools/more.py
old mode 100644
new mode 100755
diff --git a/lib/tempora/__init__.py b/lib/tempora/__init__.py
index 6652b5ae..cece8bb7 100644
--- a/lib/tempora/__init__.py
+++ b/lib/tempora/__init__.py
@@ -6,6 +6,10 @@ import re
 import numbers
 import functools
 import contextlib
+from numbers import Number
+from typing import Union, Tuple, Iterable
+from typing import cast
+
 
 from jaraco.functools import once
 
@@ -33,7 +37,7 @@ hours_per_month = hours_per_day * days_per_year / 12
 
 
 @once
-def _needs_year_help():
+def _needs_year_help() -> bool:
     """
     Some versions of Python render %Y with only three characters :(
     https://bugs.python.org/issue39103
@@ -41,14 +45,19 @@ def _needs_year_help():
     return len(datetime.date(900, 1, 1).strftime('%Y')) != 4
 
 
-def ensure_datetime(ob):
+AnyDatetime = Union[datetime.datetime, datetime.date, datetime.time]
+StructDatetime = Union[Tuple[int, ...], time.struct_time]
+
+
+def ensure_datetime(ob: AnyDatetime) -> datetime.datetime:
     """
     Given a datetime or date or time object from the ``datetime``
     module, always return a datetime using default values.
     """
     if isinstance(ob, datetime.datetime):
         return ob
-    date = time = ob
+    date = cast(datetime.date, ob)
+    time = cast(datetime.time, ob)
     if isinstance(ob, datetime.date):
         time = datetime.time()
     if isinstance(ob, datetime.time):
@@ -56,7 +65,13 @@ def ensure_datetime(ob):
     return datetime.datetime.combine(date, time)
 
 
-def strftime(fmt, t):
+def infer_datetime(ob: Union[AnyDatetime, StructDatetime]) -> datetime.datetime:
+    if isinstance(ob, (time.struct_time, tuple)):
+        ob = datetime.datetime(*ob[:6])  # type: ignore
+    return ensure_datetime(ob)
+
+
+def strftime(fmt: str, t: Union[AnyDatetime, tuple, time.struct_time]) -> str:
     """
     Portable strftime.
 
@@ -115,15 +130,11 @@ def strftime(fmt, t):
     >>> strftime('%Y', datetime.time())
     '1900'
     """
-    if isinstance(t, (time.struct_time, tuple)):
-        t = datetime.datetime(*t[:6])
-    t = ensure_datetime(t)
+    t = infer_datetime(t)
     subs = (
         ('%s', '%03d' % (t.microsecond // 1000)),
         ('%µ', '%03d' % (t.microsecond % 1000)),
-    )
-    if _needs_year_help():  # pragma: nocover
-        subs += (('%Y', '%04d' % t.year),)
+    ) + (('%Y', '%04d' % t.year),) * _needs_year_help()
 
     def doSub(s, sub):
         return s.replace(*sub)
@@ -324,10 +335,10 @@ def calculate_prorated_values():
     """
     rate = input("Enter the rate (3/hour, 50/month)> ")
     for period, value in _prorated_values(rate):
-        print("per {period}: {value}".format(**locals()))
+        print(f"per {period}: {value}")
 
 
-def _prorated_values(rate):
+def _prorated_values(rate: str) -> Iterable[Tuple[str, Number]]:
     """
     Given a rate (a string in units per unit time), and return that same
     rate for various time periods.
@@ -341,7 +352,8 @@ def _prorated_values(rate):
     year: 175316.333
 
     """
-    res = re.match(r'(?P<value>[\d.]+)/(?P<period>\w+)$', rate).groupdict()
+    match = re.match(r'(?P<value>[\d.]+)/(?P<period>\w+)$', rate)
+    res = cast(re.Match, match).groupdict()
     value = float(res['value'])
     value_per_second = value / get_period_seconds(res['period'])
     for period in ('minute', 'hour', 'day', 'month', 'year'):
diff --git a/lib/tempora/schedule.py b/lib/tempora/schedule.py
index a94c9819..b6ad8aac 100644
--- a/lib/tempora/schedule.py
+++ b/lib/tempora/schedule.py
@@ -130,7 +130,7 @@ class PeriodicCommand(DelayedCommand):
             raise ValueError(
                 "A PeriodicCommand must have a positive, " "non-zero delay."
             )
-        super(PeriodicCommand, self).__setattr__(key, value)
+        super().__setattr__(key, value)
 
 
 class PeriodicCommandFixedDelay(PeriodicCommand):
diff --git a/lib/tempora/timing.py b/lib/tempora/timing.py
index 6b3147a9..c43a3d94 100644
--- a/lib/tempora/timing.py
+++ b/lib/tempora/timing.py
@@ -115,7 +115,7 @@ class Timer(Stopwatch):
 
     def __init__(self, target=float('Inf')):
         self.target = self._accept(target)
-        super(Timer, self).__init__()
+        super().__init__()
 
     @staticmethod
     def _accept(target):
diff --git a/requirements.txt b/requirements.txt
index 98316136..2a5b1836 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -41,7 +41,7 @@ rumps==0.4.0; platform_system == "Darwin"
 simplejson==3.18.0
 six==1.16.0
 soupsieve==2.3.2.post1
-tempora==5.0.2
+tempora==5.1.0
 tokenize-rt==5.0.0
 tzdata==2022.6
 tzlocal==4.2

From 3d378eb583cac54ba09d0c770034aa9855b58ee1 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 21 Dec 2022 15:58:54 -0800
Subject: [PATCH 255/743] Bump cheroot from 8.6.0 to 9.0.0 (#1903)

* Bump cheroot from 8.6.0 to 9.0.0

Bumps [cheroot](https://github.com/cherrypy/cheroot) from 8.6.0 to 9.0.0.
- [Release notes](https://github.com/cherrypy/cheroot/releases)
- [Changelog](https://github.com/cherrypy/cheroot/blob/main/CHANGES.rst)
- [Commits](https://github.com/cherrypy/cheroot/compare/v8.6.0...v9.0.0)

---
updated-dependencies:
- dependency-name: cheroot
  dependency-type: direct:production
  update-type: version-update:semver-major
...

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

* Update cheroot==9.0.0

Signed-off-by: dependabot[bot] <support@github.com>
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/cheroot/__init__.py            |   9 +-
 lib/cheroot/_compat.py             |  93 +-----
 lib/cheroot/_compat.pyi            |  21 ++
 lib/cheroot/cli.py                 |  12 +-
 lib/cheroot/connections.py         |  17 +-
 lib/cheroot/errors.py              |   7 +-
 lib/cheroot/errors.pyi             |   4 +-
 lib/cheroot/makefile.py            | 439 +++--------------------------
 lib/cheroot/makefile.pyi           |  13 -
 lib/cheroot/server.py              |  52 +---
 lib/cheroot/ssl/__init__.py        |   8 +-
 lib/cheroot/ssl/builtin.py         |  13 +-
 lib/cheroot/ssl/builtin.pyi        |   3 +-
 lib/cheroot/ssl/pyopenssl.py       |   8 +-
 lib/cheroot/ssl/pyopenssl.pyi      |  11 +-
 lib/cheroot/test/_pytest_plugin.py |  18 +-
 lib/cheroot/test/conftest.py       |  18 +-
 lib/cheroot/test/helper.py         |  22 +-
 lib/cheroot/test/test__compat.py   |   9 +-
 lib/cheroot/test/test_cli.py       |   9 -
 lib/cheroot/test/test_conn.py      |  48 ++--
 lib/cheroot/test/test_core.py      |  25 +-
 lib/cheroot/test/test_dispatch.py  |   4 -
 lib/cheroot/test/test_makefile.py  |   3 -
 lib/cheroot/test/test_server.py    |  40 ++-
 lib/cheroot/test/test_ssl.py       | 101 ++-----
 lib/cheroot/test/test_wsgi.py      |   2 +
 lib/cheroot/test/webtest.py        |  52 +---
 lib/cheroot/testing.py             |  16 +-
 lib/cheroot/workers/threadpool.py  |  11 +-
 lib/cheroot/wsgi.py                |  41 +--
 lib/cheroot/wsgi.pyi               |   7 +
 requirements.txt                   |   2 +-
 33 files changed, 287 insertions(+), 851 deletions(-)
 create mode 100644 lib/cheroot/_compat.pyi

diff --git a/lib/cheroot/__init__.py b/lib/cheroot/__init__.py
index 30d38cab..aac9cd98 100644
--- a/lib/cheroot/__init__.py
+++ b/lib/cheroot/__init__.py
@@ -1,15 +1,12 @@
 """High-performance, pure-Python HTTP server used by CherryPy."""
 
-from __future__ import absolute_import, division, print_function
-__metaclass__ = type
-
 try:
-    import pkg_resources
+    from importlib import metadata
 except ImportError:
-    pass
+    import importlib_metadata as metadata  # noqa: WPS440
 
 
 try:
-    __version__ = pkg_resources.get_distribution('cheroot').version
+    __version__ = metadata.version('cheroot')
 except Exception:
     __version__ = 'unknown'
diff --git a/lib/cheroot/_compat.py b/lib/cheroot/_compat.py
index 10dcdefa..20c993de 100644
--- a/lib/cheroot/_compat.py
+++ b/lib/cheroot/_compat.py
@@ -1,19 +1,9 @@
 # pylint: disable=unused-import
 """Compatibility code for using Cheroot with various versions of Python."""
 
-from __future__ import absolute_import, division, print_function
-__metaclass__ = type
-
 import os
 import platform
-import re
 
-import six
-
-try:
-    import selectors  # lgtm [py/unused-import]
-except ImportError:
-    import selectors2 as selectors  # noqa: F401  # lgtm [py/unused-import]
 
 try:
     import ssl
@@ -22,20 +12,6 @@ try:
 except ImportError:
     IS_ABOVE_OPENSSL10 = None
 
-# contextlib.suppress was added in Python 3.4
-try:
-    from contextlib import suppress
-except ImportError:
-    from contextlib import contextmanager
-
-    @contextmanager
-    def suppress(*exceptions):
-        """Return a context manager that suppresses the `exceptions`."""
-        try:
-            yield
-        except exceptions:
-            pass
-
 
 IS_CI = bool(os.getenv('CI'))
 IS_GITHUB_ACTIONS_WORKFLOW = bool(os.getenv('GITHUB_WORKFLOW'))
@@ -53,53 +29,23 @@ PLATFORM_ARCH = platform.machine()
 IS_PPC = PLATFORM_ARCH.startswith('ppc')
 
 
-if not six.PY2:
-    def ntob(n, encoding='ISO-8859-1'):
-        """Return the native string as bytes in the given encoding."""
-        assert_native(n)
-        # In Python 3, the native string type is unicode
-        return n.encode(encoding)
+def ntob(n, encoding='ISO-8859-1'):
+    """Return the native string as bytes in the given encoding."""
+    assert_native(n)
+    # In Python 3, the native string type is unicode
+    return n.encode(encoding)
 
-    def ntou(n, encoding='ISO-8859-1'):
-        """Return the native string as Unicode with the given encoding."""
-        assert_native(n)
-        # In Python 3, the native string type is unicode
-        return n
 
-    def bton(b, encoding='ISO-8859-1'):
-        """Return the byte string as native string in the given encoding."""
-        return b.decode(encoding)
-else:
-    # Python 2
-    def ntob(n, encoding='ISO-8859-1'):
-        """Return the native string as bytes in the given encoding."""
-        assert_native(n)
-        # In Python 2, the native string type is bytes. Assume it's already
-        # in the given encoding, which for ISO-8859-1 is almost always what
-        # was intended.
-        return n
+def ntou(n, encoding='ISO-8859-1'):
+    """Return the native string as Unicode with the given encoding."""
+    assert_native(n)
+    # In Python 3, the native string type is unicode
+    return n
 
-    def ntou(n, encoding='ISO-8859-1'):
-        """Return the native string as Unicode with the given encoding."""
-        assert_native(n)
-        # In Python 2, the native string type is bytes.
-        # First, check for the special encoding 'escape'. The test suite uses
-        # this to signal that it wants to pass a string with embedded \uXXXX
-        # escapes, but without having to prefix it with u'' for Python 2,
-        # but no prefix for Python 3.
-        if encoding == 'escape':
-            return re.sub(
-                r'\\u([0-9a-zA-Z]{4})',
-                lambda m: six.unichr(int(m.group(1), 16)),
-                n.decode('ISO-8859-1'),
-            )
-        # Assume it's already in the given encoding, which for ISO-8859-1
-        # is almost always what was intended.
-        return n.decode(encoding)
 
-    def bton(b, encoding='ISO-8859-1'):
-        """Return the byte string as native string in the given encoding."""
-        return b
+def bton(b, encoding='ISO-8859-1'):
+    """Return the byte string as native string in the given encoding."""
+    return b.decode(encoding)
 
 
 def assert_native(n):
@@ -113,17 +59,6 @@ def assert_native(n):
         raise TypeError('n must be a native str (got %s)' % type(n).__name__)
 
 
-if not six.PY2:
-    """Python 3 has :py:class:`memoryview` builtin."""
-    # Python 2.7 has it backported, but socket.write() does
-    # str(memoryview(b'0' * 100)) -> <memory at 0x7fb6913a5588>
-    # instead of accessing it correctly.
-    memoryview = memoryview
-else:
-    """Link :py:class:`memoryview` to buffer under Python 2."""
-    memoryview = buffer  # noqa: F821
-
-
 def extract_bytes(mv):
     r"""Retrieve bytes out of the given input buffer.
 
@@ -138,7 +73,7 @@ def extract_bytes(mv):
                         or :py:class:`bytes`
     """
     if isinstance(mv, memoryview):
-        return bytes(mv) if six.PY2 else mv.tobytes()
+        return mv.tobytes()
 
     if isinstance(mv, bytes):
         return mv
diff --git a/lib/cheroot/_compat.pyi b/lib/cheroot/_compat.pyi
new file mode 100644
index 00000000..023bad8c
--- /dev/null
+++ b/lib/cheroot/_compat.pyi
@@ -0,0 +1,21 @@
+from typing import Any, ContextManager, Optional, Type, Union
+
+def suppress(*exceptions: Type[BaseException]) -> ContextManager[None]: ...
+
+IS_ABOVE_OPENSSL10: Optional[bool]
+IS_CI: bool
+IS_GITHUB_ACTIONS_WORKFLOW: bool
+IS_PYPY: bool
+SYS_PLATFORM: str
+IS_WINDOWS: bool
+IS_LINUX: bool
+IS_MACOS: bool
+PLATFORM_ARCH: str
+IS_PPC: bool
+
+def ntob(n: str, encoding: str = ...) -> bytes: ...
+def ntou(n: str, encoding: str = ...) -> str: ...
+def bton(b: bytes, encoding: str = ...) -> str: ...
+def assert_native(n: str) -> None: ...
+
+def extract_bytes(mv: Union[memoryview, bytes]) -> bytes: ...
diff --git a/lib/cheroot/cli.py b/lib/cheroot/cli.py
index 4607e226..cd168e91 100644
--- a/lib/cheroot/cli.py
+++ b/lib/cheroot/cli.py
@@ -28,18 +28,14 @@ Basic usage:
 """
 
 import argparse
-from importlib import import_module
 import os
 import sys
-
-import six
+import urllib.parse  # noqa: WPS301
+from importlib import import_module
+from contextlib import suppress
 
 from . import server
 from . import wsgi
-from ._compat import suppress
-
-
-__metaclass__ = type
 
 
 class BindLocation:
@@ -143,7 +139,7 @@ def parse_wsgi_bind_location(bind_addr_string):
         return AbstractSocket(bind_addr_string[1:])
 
     # try and match for an IP/hostname and port
-    match = six.moves.urllib.parse.urlparse(
+    match = urllib.parse.urlparse(
         '//{addr}'.format(addr=bind_addr_string),
     )
     try:
diff --git a/lib/cheroot/connections.py b/lib/cheroot/connections.py
index 181e3731..9b6366e5 100644
--- a/lib/cheroot/connections.py
+++ b/lib/cheroot/connections.py
@@ -1,22 +1,17 @@
 """Utilities to manage open connections."""
 
-from __future__ import absolute_import, division, print_function
-__metaclass__ = type
-
 import io
 import os
 import socket
 import threading
 import time
+import selectors
+from contextlib import suppress
 
 from . import errors
-from ._compat import selectors
-from ._compat import suppress
 from ._compat import IS_WINDOWS
 from .makefile import MakeFile
 
-import six
-
 try:
     import fcntl
 except ImportError:
@@ -310,8 +305,7 @@ class ConnectionManager:
                         msg,
                     ]
 
-                    sock_to_make = s if not six.PY2 else s._sock
-                    wfile = mf(sock_to_make, 'wb', io.DEFAULT_BUFFER_SIZE)
+                    wfile = mf(s, 'wb', io.DEFAULT_BUFFER_SIZE)
                     try:
                         wfile.write(''.join(buf).encode('ISO-8859-1'))
                     except socket.error as ex:
@@ -327,10 +321,7 @@ class ConnectionManager:
 
             conn = self.server.ConnectionClass(self.server, s, mf)
 
-            if not isinstance(
-                    self.server.bind_addr,
-                    (six.text_type, six.binary_type),
-            ):
+            if not isinstance(self.server.bind_addr, (str, bytes)):
                 # optional values
                 # Until we do DNS lookups, omit REMOTE_HOST
                 if addr is None:  # sometimes this can happen
diff --git a/lib/cheroot/errors.py b/lib/cheroot/errors.py
index e00629f8..046263ad 100644
--- a/lib/cheroot/errors.py
+++ b/lib/cheroot/errors.py
@@ -1,17 +1,14 @@
 # -*- coding: utf-8 -*-
 """Collection of exceptions raised and/or processed by Cheroot."""
 
-from __future__ import absolute_import, division, print_function
-__metaclass__ = type
-
 import errno
 import sys
 
 
 class MaxSizeExceeded(Exception):
-    """Exception raised when a client sends more data then acceptable within limit.
+    """Exception raised when a client sends more data then allowed under limit.
 
-    Depends on ``request.body.maxbytes`` config option if used within CherryPy
+    Depends on ``request.body.maxbytes`` config option if used within CherryPy.
     """
 
 
diff --git a/lib/cheroot/errors.pyi b/lib/cheroot/errors.pyi
index e78a7585..18669568 100644
--- a/lib/cheroot/errors.pyi
+++ b/lib/cheroot/errors.pyi
@@ -1,4 +1,4 @@
-from typing import Any, List, Set, Tuple
+from typing import List, Set, Tuple, Type
 
 class MaxSizeExceeded(Exception): ...
 class NoSSLError(Exception): ...
@@ -10,4 +10,4 @@ socket_error_eintr: List[int]
 socket_errors_to_ignore: List[int]
 socket_errors_nonblocking: List[int]
 acceptable_sock_shutdown_error_codes: Set[int]
-acceptable_sock_shutdown_exceptions: Tuple[Exception]
+acceptable_sock_shutdown_exceptions: Tuple[Type[Exception], ...]
diff --git a/lib/cheroot/makefile.py b/lib/cheroot/makefile.py
index 1383c658..77878c13 100644
--- a/lib/cheroot/makefile.py
+++ b/lib/cheroot/makefile.py
@@ -1,21 +1,9 @@
 """Socket file object."""
 
-from __future__ import absolute_import, division, print_function
-__metaclass__ = type
-
 import socket
 
-try:
-    # prefer slower Python-based io module
-    import _pyio as io
-except ImportError:
-    # Python 2.6
-    import io
-
-import six
-
-from . import errors
-from ._compat import extract_bytes, memoryview
+# prefer slower Python-based io module
+import _pyio as io
 
 
 # Write only 16K at a time to sockets
@@ -48,400 +36,41 @@ class BufferedWriter(io.BufferedWriter):
             del self._write_buf[:n]
 
 
-class MakeFile_PY2(getattr(socket, '_fileobject', object)):
-    """Faux file object attached to a socket object."""
+class StreamReader(io.BufferedReader):
+    """Socket stream reader."""
 
-    def __init__(self, *args, **kwargs):
-        """Initialize faux file object."""
+    def __init__(self, sock, mode='r', bufsize=io.DEFAULT_BUFFER_SIZE):
+        """Initialize socket stream reader."""
+        super().__init__(socket.SocketIO(sock, mode), bufsize)
         self.bytes_read = 0
+
+    def read(self, *args, **kwargs):
+        """Capture bytes read."""
+        val = super().read(*args, **kwargs)
+        self.bytes_read += len(val)
+        return val
+
+    def has_data(self):
+        """Return true if there is buffered data to read."""
+        return len(self._read_buf) > self._read_pos
+
+
+class StreamWriter(BufferedWriter):
+    """Socket stream writer."""
+
+    def __init__(self, sock, mode='w', bufsize=io.DEFAULT_BUFFER_SIZE):
+        """Initialize socket stream writer."""
+        super().__init__(socket.SocketIO(sock, mode), bufsize)
         self.bytes_written = 0
-        socket._fileobject.__init__(self, *args, **kwargs)
-        self._refcount = 0
 
-    def _reuse(self):
-        self._refcount += 1
-
-    def _drop(self):
-        if self._refcount < 0:
-            self.close()
-        else:
-            self._refcount -= 1
-
-    def write(self, data):
-        """Send entire data contents for non-blocking sockets."""
-        bytes_sent = 0
-        data_mv = memoryview(data)
-        payload_size = len(data_mv)
-        while bytes_sent < payload_size:
-            try:
-                bytes_sent += self.send(
-                    data_mv[bytes_sent:bytes_sent + SOCK_WRITE_BLOCKSIZE],
-                )
-            except socket.error as e:
-                if e.args[0] not in errors.socket_errors_nonblocking:
-                    raise
-
-    def send(self, data):
-        """Send some part of message to the socket."""
-        bytes_sent = self._sock.send(extract_bytes(data))
-        self.bytes_written += bytes_sent
-        return bytes_sent
-
-    def flush(self):
-        """Write all data from buffer to socket and reset write buffer."""
-        if self._wbuf:
-            buffer = ''.join(self._wbuf)
-            self._wbuf = []
-            self.write(buffer)
-
-    def recv(self, size):
-        """Receive message of a size from the socket."""
-        while True:
-            try:
-                data = self._sock.recv(size)
-                self.bytes_read += len(data)
-                return data
-            except socket.error as e:
-                what = (
-                    e.args[0] not in errors.socket_errors_nonblocking
-                    and e.args[0] not in errors.socket_error_eintr
-                )
-                if what:
-                    raise
-
-    class FauxSocket:
-        """Faux socket with the minimal interface required by pypy."""
-
-        def _reuse(self):
-            pass
-
-    _fileobject_uses_str_type = six.PY2 and isinstance(
-        socket._fileobject(FauxSocket())._rbuf, six.string_types,
-    )
-
-    # FauxSocket is no longer needed
-    del FauxSocket
-
-    if not _fileobject_uses_str_type:  # noqa: C901  # FIXME
-        def read(self, size=-1):
-            """Read data from the socket to buffer."""
-            # Use max, disallow tiny reads in a loop as they are very
-            # inefficient.
-            # We never leave read() with any leftover data from a new recv()
-            # call in our internal buffer.
-            rbufsize = max(self._rbufsize, self.default_bufsize)
-            # Our use of StringIO rather than lists of string objects returned
-            # by recv() minimizes memory usage and fragmentation that occurs
-            # when rbufsize is large compared to the typical return value of
-            # recv().
-            buf = self._rbuf
-            buf.seek(0, 2)  # seek end
-            if size < 0:
-                # Read until EOF
-                # reset _rbuf.  we consume it via buf.
-                self._rbuf = io.BytesIO()
-                while True:
-                    data = self.recv(rbufsize)
-                    if not data:
-                        break
-                    buf.write(data)
-                return buf.getvalue()
-            else:
-                # Read until size bytes or EOF seen, whichever comes first
-                buf_len = buf.tell()
-                if buf_len >= size:
-                    # Already have size bytes in our buffer?  Extract and
-                    # return.
-                    buf.seek(0)
-                    rv = buf.read(size)
-                    self._rbuf = io.BytesIO()
-                    self._rbuf.write(buf.read())
-                    return rv
-
-                # reset _rbuf.  we consume it via buf.
-                self._rbuf = io.BytesIO()
-                while True:
-                    left = size - buf_len
-                    # recv() will malloc the amount of memory given as its
-                    # parameter even though it often returns much less data
-                    # than that.  The returned data string is short lived
-                    # as we copy it into a StringIO and free it.  This avoids
-                    # fragmentation issues on many platforms.
-                    data = self.recv(left)
-                    if not data:
-                        break
-                    n = len(data)
-                    if n == size and not buf_len:
-                        # Shortcut.  Avoid buffer data copies when:
-                        # - We have no data in our buffer.
-                        # AND
-                        # - Our call to recv returned exactly the
-                        #   number of bytes we were asked to read.
-                        return data
-                    if n == left:
-                        buf.write(data)
-                        del data  # explicit free
-                        break
-                    assert n <= left, 'recv(%d) returned %d bytes' % (left, n)
-                    buf.write(data)
-                    buf_len += n
-                    del data  # explicit free
-                    # assert buf_len == buf.tell()
-                return buf.getvalue()
-
-        def readline(self, size=-1):
-            """Read line from the socket to buffer."""
-            buf = self._rbuf
-            buf.seek(0, 2)  # seek end
-            if buf.tell() > 0:
-                # check if we already have it in our buffer
-                buf.seek(0)
-                bline = buf.readline(size)
-                if bline.endswith('\n') or len(bline) == size:
-                    self._rbuf = io.BytesIO()
-                    self._rbuf.write(buf.read())
-                    return bline
-                del bline
-            if size < 0:
-                # Read until \n or EOF, whichever comes first
-                if self._rbufsize <= 1:
-                    # Speed up unbuffered case
-                    buf.seek(0)
-                    buffers = [buf.read()]
-                    # reset _rbuf.  we consume it via buf.
-                    self._rbuf = io.BytesIO()
-                    data = None
-                    recv = self.recv
-                    while data != '\n':
-                        data = recv(1)
-                        if not data:
-                            break
-                        buffers.append(data)
-                    return ''.join(buffers)
-
-                buf.seek(0, 2)  # seek end
-                # reset _rbuf.  we consume it via buf.
-                self._rbuf = io.BytesIO()
-                while True:
-                    data = self.recv(self._rbufsize)
-                    if not data:
-                        break
-                    nl = data.find('\n')
-                    if nl >= 0:
-                        nl += 1
-                        buf.write(data[:nl])
-                        self._rbuf.write(data[nl:])
-                        del data
-                        break
-                    buf.write(data)
-                return buf.getvalue()
-
-            else:
-                # Read until size bytes or \n or EOF seen, whichever comes
-                # first
-                buf.seek(0, 2)  # seek end
-                buf_len = buf.tell()
-                if buf_len >= size:
-                    buf.seek(0)
-                    rv = buf.read(size)
-                    self._rbuf = io.BytesIO()
-                    self._rbuf.write(buf.read())
-                    return rv
-                # reset _rbuf.  we consume it via buf.
-                self._rbuf = io.BytesIO()
-                while True:
-                    data = self.recv(self._rbufsize)
-                    if not data:
-                        break
-                    left = size - buf_len
-                    # did we just receive a newline?
-                    nl = data.find('\n', 0, left)
-                    if nl >= 0:
-                        nl += 1
-                        # save the excess data to _rbuf
-                        self._rbuf.write(data[nl:])
-                        if buf_len:
-                            buf.write(data[:nl])
-                            break
-                        else:
-                            # Shortcut.  Avoid data copy through buf when
-                            # returning a substring of our first recv().
-                            return data[:nl]
-                    n = len(data)
-                    if n == size and not buf_len:
-                        # Shortcut.  Avoid data copy through buf when
-                        # returning exactly all of our first recv().
-                        return data
-                    if n >= left:
-                        buf.write(data[:left])
-                        self._rbuf.write(data[left:])
-                        break
-                    buf.write(data)
-                    buf_len += n
-                    # assert buf_len == buf.tell()
-                return buf.getvalue()
-
-        def has_data(self):
-            """Return true if there is buffered data to read."""
-            return bool(self._rbuf.getvalue())
-
-    else:
-        def read(self, size=-1):
-            """Read data from the socket to buffer."""
-            if size < 0:
-                # Read until EOF
-                buffers = [self._rbuf]
-                self._rbuf = ''
-                if self._rbufsize <= 1:
-                    recv_size = self.default_bufsize
-                else:
-                    recv_size = self._rbufsize
-
-                while True:
-                    data = self.recv(recv_size)
-                    if not data:
-                        break
-                    buffers.append(data)
-                return ''.join(buffers)
-            else:
-                # Read until size bytes or EOF seen, whichever comes first
-                data = self._rbuf
-                buf_len = len(data)
-                if buf_len >= size:
-                    self._rbuf = data[size:]
-                    return data[:size]
-                buffers = []
-                if data:
-                    buffers.append(data)
-                self._rbuf = ''
-                while True:
-                    left = size - buf_len
-                    recv_size = max(self._rbufsize, left)
-                    data = self.recv(recv_size)
-                    if not data:
-                        break
-                    buffers.append(data)
-                    n = len(data)
-                    if n >= left:
-                        self._rbuf = data[left:]
-                        buffers[-1] = data[:left]
-                        break
-                    buf_len += n
-                return ''.join(buffers)
-
-        def readline(self, size=-1):
-            """Read line from the socket to buffer."""
-            data = self._rbuf
-            if size < 0:
-                # Read until \n or EOF, whichever comes first
-                if self._rbufsize <= 1:
-                    # Speed up unbuffered case
-                    assert data == ''
-                    buffers = []
-                    while data != '\n':
-                        data = self.recv(1)
-                        if not data:
-                            break
-                        buffers.append(data)
-                    return ''.join(buffers)
-                nl = data.find('\n')
-                if nl >= 0:
-                    nl += 1
-                    self._rbuf = data[nl:]
-                    return data[:nl]
-                buffers = []
-                if data:
-                    buffers.append(data)
-                self._rbuf = ''
-                while True:
-                    data = self.recv(self._rbufsize)
-                    if not data:
-                        break
-                    buffers.append(data)
-                    nl = data.find('\n')
-                    if nl >= 0:
-                        nl += 1
-                        self._rbuf = data[nl:]
-                        buffers[-1] = data[:nl]
-                        break
-                return ''.join(buffers)
-            else:
-                # Read until size bytes or \n or EOF seen, whichever comes
-                # first
-                nl = data.find('\n', 0, size)
-                if nl >= 0:
-                    nl += 1
-                    self._rbuf = data[nl:]
-                    return data[:nl]
-                buf_len = len(data)
-                if buf_len >= size:
-                    self._rbuf = data[size:]
-                    return data[:size]
-                buffers = []
-                if data:
-                    buffers.append(data)
-                self._rbuf = ''
-                while True:
-                    data = self.recv(self._rbufsize)
-                    if not data:
-                        break
-                    buffers.append(data)
-                    left = size - buf_len
-                    nl = data.find('\n', 0, left)
-                    if nl >= 0:
-                        nl += 1
-                        self._rbuf = data[nl:]
-                        buffers[-1] = data[:nl]
-                        break
-                    n = len(data)
-                    if n >= left:
-                        self._rbuf = data[left:]
-                        buffers[-1] = data[:left]
-                        break
-                    buf_len += n
-                return ''.join(buffers)
-
-        def has_data(self):
-            """Return true if there is buffered data to read."""
-            return bool(self._rbuf)
+    def write(self, val, *args, **kwargs):
+        """Capture bytes written."""
+        res = super().write(val, *args, **kwargs)
+        self.bytes_written += len(val)
+        return res
 
 
-if not six.PY2:
-    class StreamReader(io.BufferedReader):
-        """Socket stream reader."""
-
-        def __init__(self, sock, mode='r', bufsize=io.DEFAULT_BUFFER_SIZE):
-            """Initialize socket stream reader."""
-            super().__init__(socket.SocketIO(sock, mode), bufsize)
-            self.bytes_read = 0
-
-        def read(self, *args, **kwargs):
-            """Capture bytes read."""
-            val = super().read(*args, **kwargs)
-            self.bytes_read += len(val)
-            return val
-
-        def has_data(self):
-            """Return true if there is buffered data to read."""
-            return len(self._read_buf) > self._read_pos
-
-    class StreamWriter(BufferedWriter):
-        """Socket stream writer."""
-
-        def __init__(self, sock, mode='w', bufsize=io.DEFAULT_BUFFER_SIZE):
-            """Initialize socket stream writer."""
-            super().__init__(socket.SocketIO(sock, mode), bufsize)
-            self.bytes_written = 0
-
-        def write(self, val, *args, **kwargs):
-            """Capture bytes written."""
-            res = super().write(val, *args, **kwargs)
-            self.bytes_written += len(val)
-            return res
-
-    def MakeFile(sock, mode='r', bufsize=io.DEFAULT_BUFFER_SIZE):
-        """File object attached to a socket object."""
-        cls = StreamReader if 'r' in mode else StreamWriter
-        return cls(sock, mode, bufsize)
-else:
-    StreamReader = StreamWriter = MakeFile = MakeFile_PY2
+def MakeFile(sock, mode='r', bufsize=io.DEFAULT_BUFFER_SIZE):
+    """File object attached to a socket object."""
+    cls = StreamReader if 'r' in mode else StreamWriter
+    return cls(sock, mode, bufsize)
diff --git a/lib/cheroot/makefile.pyi b/lib/cheroot/makefile.pyi
index 11748505..3f5ea275 100644
--- a/lib/cheroot/makefile.pyi
+++ b/lib/cheroot/makefile.pyi
@@ -5,19 +5,6 @@ SOCK_WRITE_BLOCKSIZE: int
 class BufferedWriter(io.BufferedWriter):
     def write(self, b): ...
 
-class MakeFile_PY2:
-    bytes_read: int
-    bytes_written: int
-    def __init__(self, *args, **kwargs) -> None: ...
-    def write(self, data) -> None: ...
-    def send(self, data): ...
-    def flush(self) -> None: ...
-    def recv(self, size): ...
-    class FauxSocket: ...
-    def read(self, size: int = ...): ...
-    def readline(self, size: int = ...): ...
-    def has_data(self): ...
-
 class StreamReader(io.BufferedReader):
     bytes_read: int
     def __init__(self, sock, mode: str = ..., bufsize=...) -> None: ...
diff --git a/lib/cheroot/server.py b/lib/cheroot/server.py
index d92988ab..6b8e37a9 100644
--- a/lib/cheroot/server.py
+++ b/lib/cheroot/server.py
@@ -65,9 +65,6 @@ And now for a trivial doctest to exercise the test suite
 True
 """
 
-from __future__ import absolute_import, division, print_function
-__metaclass__ = type
-
 import os
 import io
 import re
@@ -78,20 +75,14 @@ import time
 import traceback as traceback_
 import logging
 import platform
+import queue
 import contextlib
 import threading
-
-try:
-    from functools import lru_cache
-except ImportError:
-    from backports.functools_lru_cache import lru_cache
-
-import six
-from six.moves import queue
-from six.moves import urllib
+import urllib.parse
+from functools import lru_cache
 
 from . import connections, errors, __version__
-from ._compat import bton, ntou
+from ._compat import bton
 from ._compat import IS_PPC
 from .workers import threadpool
 from .makefile import MakeFile, StreamWriter
@@ -606,8 +597,8 @@ class ChunkedRFile:
     def read_trailer_lines(self):
         """Read HTTP headers and yield them.
 
-        Returns:
-            Generator: yields CRLF separated lines.
+        :yields: CRLF separated lines
+        :ytype: bytes
 
         """
         if not self.closed:
@@ -817,10 +808,6 @@ class HTTPRequest:
             return False
 
         try:
-            if six.PY2:  # FIXME: Figure out better way to do this
-                # Ref: https://stackoverflow.com/a/196392/595220 (like this?)
-                """This is a dummy check for unicode in URI."""
-                ntou(bton(uri, 'ascii'), 'ascii')
             scheme, authority, path, qs, fragment = urllib.parse.urlsplit(uri)
         except UnicodeError:
             self.simple_response('400 Bad Request', 'Malformed Request-URI')
@@ -1120,7 +1107,7 @@ class HTTPRequest:
 
         buf.append(CRLF)
         if msg:
-            if isinstance(msg, six.text_type):
+            if isinstance(msg, str):
                 msg = msg.encode('ISO-8859-1')
             buf.append(msg)
 
@@ -1422,10 +1409,7 @@ class HTTPConnection:
             https://github.com/daveti/tcpSockHack
             msdn.microsoft.com/en-us/commandline/wsl/release_notes#build-15025
             """
-            six.raise_from(  # 3.6+: raise RuntimeError from socket_err
-                RuntimeError,
-                socket_err,
-            )
+            raise RuntimeError from socket_err
         else:
             pid, uid, gid = struct.unpack(PEERCRED_STRUCT_DEF, peer_creds)
             return pid, uid, gid
@@ -1589,7 +1573,7 @@ class HTTPServer:
     """
 
     keep_alive_conn_limit = 10
-    """The maximum number of waiting keep-alive connections that will be kept open.
+    """Maximum number of waiting keep-alive connections that will be kept open.
 
     Default is 10. Set to None to have unlimited connections."""
 
@@ -1762,13 +1746,13 @@ class HTTPServer:
         if os.getenv('LISTEN_PID', None):
             # systemd socket activation
             self.socket = socket.fromfd(3, socket.AF_INET, socket.SOCK_STREAM)
-        elif isinstance(self.bind_addr, (six.text_type, six.binary_type)):
+        elif isinstance(self.bind_addr, (str, bytes)):
             # AF_UNIX socket
             try:
                 self.bind_unix_socket(self.bind_addr)
             except socket.error as serr:
                 msg = '%s -- (%s: %s)' % (msg, self.bind_addr, serr)
-                six.raise_from(socket.error(msg), serr)
+                raise socket.error(msg) from serr
         else:
             # AF_INET or AF_INET6 socket
             # Get the correct address family for our host (allows IPv6
@@ -2007,10 +1991,7 @@ class HTTPServer:
             * https://gavv.github.io/blog/ephemeral-port-reuse/
             """
             sock.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
-        if nodelay and not isinstance(
-                bind_addr,
-                (six.text_type, six.binary_type),
-        ):
+        if nodelay and not isinstance(bind_addr, (str, bytes)):
             sock.setsockopt(socket.IPPROTO_TCP, socket.TCP_NODELAY, 1)
 
         if ssl_adapter is not None:
@@ -2059,7 +2040,7 @@ class HTTPServer:
             """
             return bind_addr[:2]
 
-        if isinstance(bind_addr, six.binary_type):
+        if isinstance(bind_addr, bytes):
             bind_addr = bton(bind_addr)
 
         return bind_addr
@@ -2109,10 +2090,7 @@ class HTTPServer:
 
         sock = getattr(self, 'socket', None)
         if sock:
-            if not isinstance(
-                    self.bind_addr,
-                    (six.text_type, six.binary_type),
-            ):
+            if not isinstance(self.bind_addr, (str, bytes)):
                 # Touch our own socket to make accept() return immediately.
                 try:
                     host, port = sock.getsockname()[:2]
@@ -2179,7 +2157,7 @@ ssl_adapters = {
 def get_ssl_adapter_class(name='builtin'):
     """Return an SSL adapter class for the given name."""
     adapter = ssl_adapters[name.lower()]
-    if isinstance(adapter, six.string_types):
+    if isinstance(adapter, str):
         last_dot = adapter.rfind('.')
         attr_name = adapter[last_dot + 1:]
         mod_path = adapter[:last_dot]
diff --git a/lib/cheroot/ssl/__init__.py b/lib/cheroot/ssl/__init__.py
index d45fd7f1..19b587d0 100644
--- a/lib/cheroot/ssl/__init__.py
+++ b/lib/cheroot/ssl/__init__.py
@@ -1,15 +1,9 @@
 """Implementation of the SSL adapter base interface."""
 
-from __future__ import absolute_import, division, print_function
-__metaclass__ = type
-
 from abc import ABCMeta, abstractmethod
 
-from six import add_metaclass
 
-
-@add_metaclass(ABCMeta)
-class Adapter:
+class Adapter(metaclass=ABCMeta):
     """Base class for SSL driver library adapters.
 
     Required methods:
diff --git a/lib/cheroot/ssl/builtin.py b/lib/cheroot/ssl/builtin.py
index ff987a71..b22d4ae6 100644
--- a/lib/cheroot/ssl/builtin.py
+++ b/lib/cheroot/ssl/builtin.py
@@ -7,12 +7,10 @@ To use this module, set ``HTTPServer.ssl_adapter`` to an instance of
 ``BuiltinSSLAdapter``.
 """
 
-from __future__ import absolute_import, division, print_function
-__metaclass__ = type
-
 import socket
 import sys
 import threading
+from contextlib import suppress
 
 try:
     import ssl
@@ -27,18 +25,13 @@ except ImportError:
     except ImportError:
         DEFAULT_BUFFER_SIZE = -1
 
-import six
-
 from . import Adapter
 from .. import errors
-from .._compat import IS_ABOVE_OPENSSL10, suppress
+from .._compat import IS_ABOVE_OPENSSL10
 from ..makefile import StreamReader, StreamWriter
 from ..server import HTTPServer
 
-if six.PY2:
-    generic_socket_error = socket.error
-else:
-    generic_socket_error = OSError
+generic_socket_error = OSError
 
 
 def _assert_ssl_exc_contains(exc, *msgs):
diff --git a/lib/cheroot/ssl/builtin.pyi b/lib/cheroot/ssl/builtin.pyi
index fdc656e0..72e45001 100644
--- a/lib/cheroot/ssl/builtin.pyi
+++ b/lib/cheroot/ssl/builtin.pyi
@@ -1,7 +1,6 @@
 from typing import Any
 from . import Adapter
 
-generic_socket_error: OSError
 DEFAULT_BUFFER_SIZE: int
 
 class BuiltinSSLAdapter(Adapter):
@@ -14,5 +13,5 @@ class BuiltinSSLAdapter(Adapter):
     def context(self, context) -> None: ...
     def bind(self, sock): ...
     def wrap(self, sock): ...
-    def get_environ(self): ...
+    def get_environ(self, sock): ...
     def makefile(self, sock, mode: str = ..., bufsize: int = ...): ...
diff --git a/lib/cheroot/ssl/pyopenssl.py b/lib/cheroot/ssl/pyopenssl.py
index adc9a1ba..548200f7 100644
--- a/lib/cheroot/ssl/pyopenssl.py
+++ b/lib/cheroot/ssl/pyopenssl.py
@@ -50,16 +50,11 @@ will be read, and the context will be automatically created from them.
    pyopenssl
 """
 
-from __future__ import absolute_import, division, print_function
-__metaclass__ = type
-
 import socket
 import sys
 import threading
 import time
 
-import six
-
 try:
     import OpenSSL.version
     from OpenSSL import SSL
@@ -229,8 +224,7 @@ class SSLConnectionProxyMeta:
         return type(name, bases, nmspc)
 
 
-@six.add_metaclass(SSLConnectionProxyMeta)
-class SSLConnection:
+class SSLConnection(metaclass=SSLConnectionProxyMeta):
     r"""A thread-safe wrapper for an ``SSL.Connection``.
 
     :param tuple args: the arguments to create the wrapped \
diff --git a/lib/cheroot/ssl/pyopenssl.pyi b/lib/cheroot/ssl/pyopenssl.pyi
index d5b93471..107675c9 100644
--- a/lib/cheroot/ssl/pyopenssl.pyi
+++ b/lib/cheroot/ssl/pyopenssl.pyi
@@ -1,9 +1,9 @@
 from . import Adapter
 from ..makefile import StreamReader, StreamWriter
 from OpenSSL import SSL
-from typing import Any
+from typing import Any, Type
 
-ssl_conn_type: SSL.Connection
+ssl_conn_type: Type[SSL.Connection]
 
 class SSLFileobjectMixin:
     ssl_timeout: int
@@ -13,13 +13,13 @@ class SSLFileobjectMixin:
     def sendall(self, *args, **kwargs): ...
     def send(self, *args, **kwargs): ...
 
-class SSLFileobjectStreamReader(SSLFileobjectMixin, StreamReader): ...  # type:ignore
-class SSLFileobjectStreamWriter(SSLFileobjectMixin, StreamWriter): ...  # type:ignore
+class SSLFileobjectStreamReader(SSLFileobjectMixin, StreamReader): ...  # type:ignore[misc]
+class SSLFileobjectStreamWriter(SSLFileobjectMixin, StreamWriter): ...  # type:ignore[misc]
 
 class SSLConnectionProxyMeta:
     def __new__(mcl, name, bases, nmspc): ...
 
-class SSLConnection():
+class SSLConnection:
     def __init__(self, *args) -> None: ...
 
 class pyOpenSSLAdapter(Adapter):
@@ -28,3 +28,4 @@ class pyOpenSSLAdapter(Adapter):
     def wrap(self, sock): ...
     def get_environ(self): ...
     def makefile(self, sock, mode: str = ..., bufsize: int = ...): ...
+    def get_context(self) -> SSL.Context: ...
diff --git a/lib/cheroot/test/_pytest_plugin.py b/lib/cheroot/test/_pytest_plugin.py
index 012211df..8ff3b02c 100644
--- a/lib/cheroot/test/_pytest_plugin.py
+++ b/lib/cheroot/test/_pytest_plugin.py
@@ -8,6 +8,7 @@ from __future__ import absolute_import, division, print_function
 __metaclass__ = type
 
 import pytest
+import six
 
 
 pytest_version = tuple(map(int, pytest.__version__.split('.')))
@@ -43,8 +44,17 @@ def pytest_load_initial_conftests(early_config, parser, args):
         '<socket.socket fd=-1, family=AF_INET6, '
         'type=SocketKind.SOCK_STREAM, proto=.:'
         'pytest.PytestUnraisableExceptionWarning:_pytest.unraisableexception',
-        'ignore:Exception ignored in. '
-        '<ssl.SSLSocket fd=-1, family=AddressFamily.AF_UNIX, '
-        'type=SocketKind.SOCK_STREAM, proto=.:'
-        'pytest.PytestUnraisableExceptionWarning:_pytest.unraisableexception',
+    ))
+
+    if six.PY2:
+        return
+
+    # NOTE: `ResourceWarning` does not exist under Python 2 and so using
+    # NOTE: it in warning filters results in an `_OptionError` exception
+    # NOTE: being raised.
+    early_config._inicache['filterwarnings'].extend((
+        # FIXME: Try to figure out what causes this and ensure that the socket
+        # FIXME: gets closed.
+        'ignore:unclosed <socket.socket fd=:ResourceWarning',
+        'ignore:unclosed <ssl.SSLSocket fd=:ResourceWarning',
     ))
diff --git a/lib/cheroot/test/conftest.py b/lib/cheroot/test/conftest.py
index e12f8a73..205753b1 100644
--- a/lib/cheroot/test/conftest.py
+++ b/lib/cheroot/test/conftest.py
@@ -4,14 +4,12 @@ Contains fixtures, which are tightly bound to the Cheroot framework
 itself, useless for end-users' app testing.
 """
 
-from __future__ import absolute_import, division, print_function
-__metaclass__ = type  # pylint: disable=invalid-name
-
 import threading
 import time
 
 import pytest
 
+from .._compat import IS_MACOS, IS_WINDOWS  # noqa: WPS436
 from ..server import Gateway, HTTPServer
 from ..testing import (  # noqa: F401  # pylint: disable=unused-import
     native_server, wsgi_server,
@@ -19,6 +17,20 @@ from ..testing import (  # noqa: F401  # pylint: disable=unused-import
 from ..testing import get_server_client
 
 
+@pytest.fixture
+def http_request_timeout():
+    """Return a common HTTP request timeout for tests with queries."""
+    computed_timeout = 0.1
+
+    if IS_MACOS:
+        computed_timeout *= 2
+
+    if IS_WINDOWS:
+        computed_timeout *= 10
+
+    return computed_timeout
+
+
 @pytest.fixture
 # pylint: disable=redefined-outer-name
 def wsgi_server_client(wsgi_server):  # noqa: F811
diff --git a/lib/cheroot/test/helper.py b/lib/cheroot/test/helper.py
index bdf29755..e5eed08a 100644
--- a/lib/cheroot/test/helper.py
+++ b/lib/cheroot/test/helper.py
@@ -1,8 +1,5 @@
 """A library of helper functions for the Cheroot test suite."""
 
-from __future__ import absolute_import, division, print_function
-__metaclass__ = type
-
 import datetime
 import logging
 import os
@@ -10,10 +7,7 @@ import sys
 import time
 import threading
 import types
-
-from six.moves import http_client
-
-import six
+import http.client
 
 import cheroot.server
 import cheroot.wsgi
@@ -60,14 +54,14 @@ class CherootWebCase(webtest.WebCase):
             cls.scheme = 'http'
         else:
             ssl = ' (ssl)'
-            cls.HTTP_CONN = http_client.HTTPSConnection
+            cls.HTTP_CONN = http.client.HTTPSConnection
             cls.scheme = 'https'
 
         v = sys.version.split()[0]
-        log.info('Python version used to run this test script: %s' % v)
-        log.info('Cheroot version: %s' % cheroot.__version__)
-        log.info('HTTP server version: %s%s' % (cls.httpserver.protocol, ssl))
-        log.info('PID: %s' % os.getpid())
+        log.info('Python version used to run this test script: %s', v)
+        log.info('Cheroot version: %s', cheroot.__version__)
+        log.info('HTTP server version: %s%s', cls.httpserver.protocol, ssl)
+        log.info('PID: %s', os.getpid())
 
         if hasattr(cls, 'setup_server'):
             # Clear the wsgi server so that
@@ -135,9 +129,9 @@ class Response:
         """Generate iterable response body object."""
         if self.body is None:
             return []
-        elif isinstance(self.body, six.text_type):
+        elif isinstance(self.body, str):
             return [self.body.encode('iso-8859-1')]
-        elif isinstance(self.body, six.binary_type):
+        elif isinstance(self.body, bytes):
             return [self.body]
         else:
             return [x.encode('iso-8859-1') for x in self.body]
diff --git a/lib/cheroot/test/test__compat.py b/lib/cheroot/test/test__compat.py
index 35c6280e..8a0f3304 100644
--- a/lib/cheroot/test/test__compat.py
+++ b/lib/cheroot/test/test__compat.py
@@ -1,13 +1,8 @@
-# -*- coding: utf-8 -*-
 """Test suite for cross-python compatibility helpers."""
 
-from __future__ import absolute_import, division, print_function
-__metaclass__ = type
-
 import pytest
-import six
 
-from cheroot._compat import extract_bytes, memoryview, ntob, ntou, bton
+from cheroot._compat import extract_bytes, ntob, ntou, bton
 
 
 @pytest.mark.parametrize(
@@ -32,7 +27,7 @@ def test_compat_functions_positive(func, inp, out):
 )
 def test_compat_functions_negative_nonnative(func):
     """Check that compatibility functions fail loudly for incorrect input."""
-    non_native_test_str = u'bar' if six.PY2 else b'bar'
+    non_native_test_str = b'bar'
     with pytest.raises(TypeError):
         func(non_native_test_str, encoding='utf-8')
 
diff --git a/lib/cheroot/test/test_cli.py b/lib/cheroot/test/test_cli.py
index 91edc023..a50ba98b 100644
--- a/lib/cheroot/test/test_cli.py
+++ b/lib/cheroot/test/test_cli.py
@@ -4,11 +4,8 @@
 
    cli
 """
-# -*- coding: utf-8 -*-
-# vim: set fileencoding=utf-8 :
 import sys
 
-import six
 import pytest
 
 from cheroot.cli import (
@@ -69,12 +66,6 @@ def wsgi_app(monkeypatch):
     app = WSGIAppMock()
     # patch sys.modules, to include the an instance of WSGIAppMock
     # under a specific namespace
-    if six.PY2:
-        # python2 requires the previous namespaces to be part of sys.modules
-        #   (e.g. for 'a.b.c' we need to insert 'a', 'a.b' and 'a.b.c')
-        # otherwise it fails, we're setting the same instance on each level,
-        # we don't really care about those, just the last one.
-        monkeypatch.setitem(sys.modules, 'mypkg', app)
     monkeypatch.setitem(sys.modules, 'mypkg.wsgi', app)
     return app
 
diff --git a/lib/cheroot/test/test_conn.py b/lib/cheroot/test/test_conn.py
index da7adcac..57c21ac7 100644
--- a/lib/cheroot/test/test_conn.py
+++ b/lib/cheroot/test/test_conn.py
@@ -1,18 +1,14 @@
 """Tests for TCP connection handling, including proper and timely close."""
 
-from __future__ import absolute_import, division, print_function
-__metaclass__ = type
-
 import errno
 import socket
 import time
 import logging
 import traceback as traceback_
 from collections import namedtuple
+import http.client
+import urllib.request
 
-from six.moves import range, http_client, urllib
-
-import six
 import pytest
 from jaraco.text import trim, unwrap
 
@@ -94,8 +90,6 @@ class Controller(helper.Controller):
         WSGI 1.0 is a mess around unicode. Create endpoints
         that match the PATH_INFO that it produces.
         """
-        if six.PY2:
-            return string
         return string.encode('utf-8').decode('latin-1')
 
     handlers = {
@@ -242,7 +236,7 @@ def test_HTTP11_persistent_connections(test_client):
     assert header_has_value('Connection', 'close', actual_headers)
 
     # Make another request on the same connection, which should error.
-    with pytest.raises(http_client.NotConnected):
+    with pytest.raises(http.client.NotConnected):
         test_client.get('/pov', http_conn=http_connection)
 
 
@@ -309,7 +303,7 @@ def test_streaming_11(test_client, set_cl):
 
             # Make another request on the same connection, which should
             # error.
-            with pytest.raises(http_client.NotConnected):
+            with pytest.raises(http.client.NotConnected):
                 test_client.get('/pov', http_conn=http_connection)
 
         # Try HEAD.
@@ -324,6 +318,9 @@ def test_streaming_11(test_client, set_cl):
         assert actual_resp_body == b''
         assert not header_exists('Transfer-Encoding', actual_headers)
 
+    # Prevent the resource warnings:
+    http_connection.close()
+
 
 @pytest.mark.parametrize(
     'set_cl',
@@ -389,7 +386,7 @@ def test_streaming_10(test_client, set_cl):
         assert not header_exists('Transfer-Encoding', actual_headers)
 
         # Make another request on the same connection, which should error.
-        with pytest.raises(http_client.NotConnected):
+        with pytest.raises(http.client.NotConnected):
             test_client.get(
                 '/pov', http_conn=http_connection,
                 protocol='HTTP/1.0',
@@ -397,6 +394,9 @@ def test_streaming_10(test_client, set_cl):
 
     test_client.server_instance.protocol = original_server_protocol
 
+    # Prevent the resource warnings:
+    http_connection.close()
+
 
 @pytest.mark.parametrize(
     'http_server_protocol',
@@ -466,6 +466,9 @@ def test_keepalive(test_client, http_server_protocol):
 
     test_client.server_instance.protocol = original_server_protocol
 
+    # Prevent the resource warnings:
+    http_connection.close()
+
 
 def test_keepalive_conn_management(test_client):
     """Test management of Keep-Alive connections."""
@@ -511,9 +514,9 @@ def test_keepalive_conn_management(test_client):
             )
 
     disconnect_errors = (
-        http_client.BadStatusLine,
-        http_client.CannotSendRequest,
-        http_client.NotConnected,
+        http.client.BadStatusLine,
+        http.client.CannotSendRequest,
+        http.client.NotConnected,
     )
 
     # Make a new connection.
@@ -565,6 +568,11 @@ def test_keepalive_conn_management(test_client):
     # Restore original timeout.
     test_client.server_instance.timeout = timeout
 
+    # Prevent the resource warnings:
+    c1.close()
+    c2.close()
+    c3.close()
+
 
 @pytest.mark.parametrize(
     ('simulated_exception', 'error_number', 'exception_leaks'),
@@ -597,7 +605,6 @@ def test_keepalive_conn_management(test_client):
         pytest.param(RuntimeError, 666, True, id='RuntimeError(666)'),
         pytest.param(socket.error, -1, True, id='socket.error(-1)'),
     ) + (
-        () if six.PY2 else (
             pytest.param(
                 ConnectionResetError, errno.ECONNRESET, False,
                 id='ConnectionResetError(ECONNRESET)',
@@ -610,7 +617,6 @@ def test_keepalive_conn_management(test_client):
                 BrokenPipeError, errno.ESHUTDOWN, False,
                 id='BrokenPipeError(ESHUTDOWN)',
             ),
-        )
     ),
 )
 def test_broken_connection_during_tcp_fin(
@@ -765,7 +771,7 @@ def test_HTTP11_Timeout_after_request(test_client):
     response = conn.response_class(conn.sock, method='GET')
     try:
         response.begin()
-    except (socket.error, http_client.BadStatusLine):
+    except (socket.error, http.client.BadStatusLine):
         pass
     except Exception as ex:
         pytest.fail(fail_msg % ex)
@@ -795,7 +801,7 @@ def test_HTTP11_Timeout_after_request(test_client):
     response = conn.response_class(conn.sock, method='GET')
     try:
         response.begin()
-    except (socket.error, http_client.BadStatusLine):
+    except (socket.error, http.client.BadStatusLine):
         pass
     except Exception as ex:
         pytest.fail(fail_msg % ex)
@@ -845,8 +851,7 @@ def test_HTTP11_pipelining(test_client):
         # ``conn.sock``. Until that bug get's fixed we will
         # monkey patch the ``response`` instance.
         # https://bugs.python.org/issue23377
-        if not six.PY2:
-            response.fp = conn.sock.makefile('rb', 0)
+        response.fp = conn.sock.makefile('rb', 0)
         response.begin()
         body = response.read(13)
         assert response.status == 200
@@ -1026,6 +1031,9 @@ def test_No_Message_Body(test_client):
     assert actual_resp_body == b''
     assert not header_exists('Connection', actual_headers)
 
+    # Prevent the resource warnings:
+    http_connection.close()
+
 
 @pytest.mark.xfail(
     reason=unwrap(
diff --git a/lib/cheroot/test/test_core.py b/lib/cheroot/test/test_core.py
index 685fe971..0203c2f7 100644
--- a/lib/cheroot/test/test_core.py
+++ b/lib/cheroot/test/test_core.py
@@ -1,16 +1,10 @@
 """Tests for managing HTTP issues (malformed requests, etc)."""
-# -*- coding: utf-8 -*-
-# vim: set fileencoding=utf-8 :
-
-from __future__ import absolute_import, division, print_function
-__metaclass__ = type
 
 import errno
 import socket
+import urllib.parse  # noqa: WPS301
 
 import pytest
-import six
-from six.moves import urllib
 
 from cheroot.test import helper
 
@@ -54,8 +48,6 @@ class HelloController(helper.Controller):
         WSGI 1.0 is a mess around unicode. Create endpoints
         that match the PATH_INFO that it produces.
         """
-        if six.PY2:
-            return string
         return string.encode('utf-8').decode('latin-1')
 
     handlers = {
@@ -63,7 +55,13 @@ class HelloController(helper.Controller):
         '/no_body': hello,
         '/body_required': body_required,
         '/query_string': query_string,
+        # FIXME: Unignore the pylint rules in pylint >= 2.15.4.
+        # Refs:
+        # * https://github.com/PyCQA/pylint/issues/6592
+        # * https://github.com/PyCQA/pylint/pull/7395
+        # pylint: disable-next=too-many-function-args
         _munge('/привіт'): hello,
+        # pylint: disable-next=too-many-function-args
         _munge('/Юххууу'): hello,
         '/\xa0Ðblah key 0 900 4 data': hello,
         '/*': asterisk,
@@ -151,7 +149,6 @@ def test_parse_acceptable_uri(test_client, uri):
     assert actual_status == HTTP_OK
 
 
-@pytest.mark.xfail(six.PY2, reason='Fails on Python 2')
 def test_parse_uri_unsafe_uri(test_client):
     """Test that malicious URI does not allow HTTP injection.
 
@@ -263,6 +260,8 @@ def test_no_content_length(test_client):
     assert actual_status == HTTP_OK
     assert actual_resp_body == b'Hello world!'
 
+    c.close()  # deal with the resource warning
+
 
 def test_content_length_required(test_client):
     """Test POST query with body failing because of missing Content-Length."""
@@ -278,6 +277,8 @@ def test_content_length_required(test_client):
     actual_status = response.status
     assert actual_status == HTTP_LENGTH_REQUIRED
 
+    c.close()  # deal with the resource warning
+
 
 @pytest.mark.xfail(
     reason='https://github.com/cherrypy/cheroot/issues/106',
@@ -350,6 +351,8 @@ def test_malformed_http_method(test_client):
     actual_resp_body = response.read(21)
     assert actual_resp_body == b'Malformed method name'
 
+    c.close()  # deal with the resource warning
+
 
 def test_malformed_header(test_client):
     """Check that broken HTTP header results in Bad Request."""
@@ -366,6 +369,8 @@ def test_malformed_header(test_client):
     actual_resp_body = response.read(20)
     assert actual_resp_body == b'Illegal header line.'
 
+    c.close()  # deal with the resource warning
+
 
 def test_request_line_split_issue_1220(test_client):
     """Check that HTTP request line of exactly 256 chars length is OK."""
diff --git a/lib/cheroot/test/test_dispatch.py b/lib/cheroot/test/test_dispatch.py
index 9974fdab..c42014fa 100644
--- a/lib/cheroot/test/test_dispatch.py
+++ b/lib/cheroot/test/test_dispatch.py
@@ -1,8 +1,4 @@
 """Tests for the HTTP server."""
-# -*- coding: utf-8 -*-
-# vim: set fileencoding=utf-8 :
-
-from __future__ import absolute_import, division, print_function
 
 from cheroot.wsgi import PathInfoDispatcher
 
diff --git a/lib/cheroot/test/test_makefile.py b/lib/cheroot/test/test_makefile.py
index cdded07e..57f6f57e 100644
--- a/lib/cheroot/test/test_makefile.py
+++ b/lib/cheroot/test/test_makefile.py
@@ -3,9 +3,6 @@
 from cheroot import makefile
 
 
-__metaclass__ = type
-
-
 class MockSocket:
     """A mock socket."""
 
diff --git a/lib/cheroot/test/test_server.py b/lib/cheroot/test/test_server.py
index 8305c78c..5e0a6832 100644
--- a/lib/cheroot/test/test_server.py
+++ b/lib/cheroot/test/test_server.py
@@ -1,23 +1,18 @@
 """Tests for the HTTP server."""
-# -*- coding: utf-8 -*-
-# vim: set fileencoding=utf-8 :
-
-from __future__ import absolute_import, division, print_function
-__metaclass__ = type
 
 import os
+import queue
 import socket
 import tempfile
 import threading
 import uuid
+import urllib.parse  # noqa: WPS301
 
 import pytest
 import requests
 import requests_unixsocket
-import six
 
 from pypytools.gc.custom import DefaultGc
-from six.moves import queue, urllib
 
 from .._compat import bton, ntob
 from .._compat import IS_LINUX, IS_MACOS, IS_WINDOWS, SYS_PLATFORM
@@ -259,12 +254,12 @@ def peercreds_enabled_server(http_server, unix_sock_file):
 
 @unix_only_sock_test
 @non_macos_sock_test
-def test_peercreds_unix_sock(peercreds_enabled_server):
+def test_peercreds_unix_sock(http_request_timeout, peercreds_enabled_server):
     """Check that ``PEERCRED`` lookup works when enabled."""
     httpserver = peercreds_enabled_server
     bind_addr = httpserver.bind_addr
 
-    if isinstance(bind_addr, six.binary_type):
+    if isinstance(bind_addr, bytes):
         bind_addr = bind_addr.decode()
 
     # pylint: disable=possibly-unused-variable
@@ -275,11 +270,17 @@ def test_peercreds_unix_sock(peercreds_enabled_server):
     expected_peercreds = '|'.join(map(str, expected_peercreds))
 
     with requests_unixsocket.monkeypatch():
-        peercreds_resp = requests.get(unix_base_uri + PEERCRED_IDS_URI)
+        peercreds_resp = requests.get(
+            unix_base_uri + PEERCRED_IDS_URI,
+            timeout=http_request_timeout,
+        )
         peercreds_resp.raise_for_status()
         assert peercreds_resp.text == expected_peercreds
 
-        peercreds_text_resp = requests.get(unix_base_uri + PEERCRED_TEXTS_URI)
+        peercreds_text_resp = requests.get(
+            unix_base_uri + PEERCRED_TEXTS_URI,
+            timeout=http_request_timeout,
+        )
         assert peercreds_text_resp.status_code == 500
 
 
@@ -290,14 +291,17 @@ def test_peercreds_unix_sock(peercreds_enabled_server):
 )
 @unix_only_sock_test
 @non_macos_sock_test
-def test_peercreds_unix_sock_with_lookup(peercreds_enabled_server):
+def test_peercreds_unix_sock_with_lookup(
+        http_request_timeout,
+        peercreds_enabled_server,
+):
     """Check that ``PEERCRED`` resolution works when enabled."""
     httpserver = peercreds_enabled_server
     httpserver.peercreds_resolve_enabled = True
 
     bind_addr = httpserver.bind_addr
 
-    if isinstance(bind_addr, six.binary_type):
+    if isinstance(bind_addr, bytes):
         bind_addr = bind_addr.decode()
 
     # pylint: disable=possibly-unused-variable
@@ -312,7 +316,10 @@ def test_peercreds_unix_sock_with_lookup(peercreds_enabled_server):
     )
     expected_textcreds = '!'.join(map(str, expected_textcreds))
     with requests_unixsocket.monkeypatch():
-        peercreds_text_resp = requests.get(unix_base_uri + PEERCRED_TEXTS_URI)
+        peercreds_text_resp = requests.get(
+            unix_base_uri + PEERCRED_TEXTS_URI,
+            timeout=http_request_timeout,
+        )
         peercreds_text_resp.raise_for_status()
         assert peercreds_text_resp.text == expected_textcreds
 
@@ -363,7 +370,10 @@ def test_high_number_of_file_descriptors(native_server_client, resource_limit):
     assert any(fn >= resource_limit for fn in native_process_conn.filenos)
 
 
-if not IS_WINDOWS:
+ISSUE511 = IS_MACOS
+
+
+if not IS_WINDOWS and not ISSUE511:
     test_high_number_of_file_descriptors = pytest.mark.forked(
         test_high_number_of_file_descriptors,
     )
diff --git a/lib/cheroot/test/test_ssl.py b/lib/cheroot/test/test_ssl.py
index 8da330df..c55e156f 100644
--- a/lib/cheroot/test/test_ssl.py
+++ b/lib/cheroot/test/test_ssl.py
@@ -1,9 +1,4 @@
 """Tests for TLS support."""
-# -*- coding: utf-8 -*-
-# vim: set fileencoding=utf-8 :
-
-from __future__ import absolute_import, division, print_function
-__metaclass__ = type
 
 import functools
 import json
@@ -14,11 +9,11 @@ import sys
 import threading
 import time
 import traceback
+import http.client
 
 import OpenSSL.SSL
 import pytest
 import requests
-import six
 import trustme
 
 from .._compat import bton, ntob, ntou
@@ -49,9 +44,6 @@ IS_PYOPENSSL_SSL_VERSION_1_0 = (
     OpenSSL.SSL.SSLeay_version(OpenSSL.SSL.SSLEAY_VERSION).
     startswith(b'OpenSSL 1.0.')
 )
-PY27 = sys.version_info[:2] == (2, 7)
-PY34 = sys.version_info[:2] == (3, 4)
-PY3 = not six.PY2
 PY310_PLUS = sys.version_info[:2] >= (3, 10)
 
 
@@ -64,13 +56,12 @@ _stdlib_to_openssl_verify = {
 
 
 fails_under_py3 = pytest.mark.xfail(
-    not six.PY2,
     reason='Fails under Python 3+',
 )
 
 
 fails_under_py3_in_pypy = pytest.mark.xfail(
-    not six.PY2 and IS_PYPY,
+    IS_PYPY,
     reason='Fails under PyPy3',
 )
 
@@ -213,6 +204,7 @@ def thread_exceptions():
     ),
 )
 def test_ssl_adapters(
+    http_request_timeout,
     tls_http_server, adapter_type,
     tls_certificate,
     tls_certificate_chain_pem_path,
@@ -241,6 +233,7 @@ def test_ssl_adapters(
 
     resp = requests.get(
         'https://{host!s}:{port!s}/'.format(host=interface, port=port),
+        timeout=http_request_timeout,
         verify=tls_ca_certificate_pem_path,
     )
 
@@ -276,8 +269,9 @@ def test_ssl_adapters(
     reason='Fails under PyPy in CI for unknown reason',
     strict=False,
 )
-def test_tls_client_auth(  # noqa: C901  # FIXME
+def test_tls_client_auth(  # noqa: C901, WPS213  # FIXME
     # FIXME: remove twisted logic, separate tests
+    http_request_timeout,
     mocker,
     tls_http_server, adapter_type,
     ca,
@@ -331,6 +325,9 @@ def test_tls_client_auth(  # noqa: C901  # FIXME
             requests.get,
             'https://{host!s}:{port!s}/'.format(host=interface, port=port),
 
+            # Don't wait for the first byte forever:
+            timeout=http_request_timeout,
+
             # Server TLS certificate verification:
             verify=tls_ca_certificate_pem_path,
 
@@ -348,12 +345,13 @@ def test_tls_client_auth(  # noqa: C901  # FIXME
                     and tls_verify_mode == ssl.CERT_REQUIRED
                     and tls_client_identity == 'localhost'
                     and is_trusted_cert
-            ) or PY34:
+            ):
                 pytest.xfail(
                     'OpenSSL 1.0 has problems with verifying client certs',
                 )
             assert is_req_successful
             assert resp.text == 'Hello world!'
+            resp.close()
             return
 
         # xfail some flaky tests
@@ -366,29 +364,16 @@ def test_tls_client_auth(  # noqa: C901  # FIXME
         if issue_237:
             pytest.xfail('Test sometimes fails')
 
-        expected_ssl_errors = (
-            requests.exceptions.SSLError,
-            OpenSSL.SSL.Error,
-        ) if PY34 else (
-            requests.exceptions.SSLError,
-        )
+        expected_ssl_errors = requests.exceptions.SSLError,
         if IS_WINDOWS or IS_GITHUB_ACTIONS_WORKFLOW:
             expected_ssl_errors += requests.exceptions.ConnectionError,
         with pytest.raises(expected_ssl_errors) as ssl_err:
-            make_https_request()
-
-        if PY34 and isinstance(ssl_err, OpenSSL.SSL.Error):
-            pytest.xfail(
-                'OpenSSL behaves wierdly under Python 3.4 '
-                'because of an outdated urllib3',
-            )
+            make_https_request().close()
 
         try:
             err_text = ssl_err.value.args[0].reason.args[0].args[0]
         except AttributeError:
-            if PY34:
-                pytest.xfail('OpenSSL behaves wierdly under Python 3.4')
-            elif IS_WINDOWS or IS_GITHUB_ACTIONS_WORKFLOW:
+            if IS_WINDOWS or IS_GITHUB_ACTIONS_WORKFLOW:
                 err_text = str(ssl_err.value)
             else:
                 raise
@@ -400,9 +385,8 @@ def test_tls_client_auth(  # noqa: C901  # FIXME
             'sslv3 alert bad certificate' if IS_LIBRESSL_BACKEND
             else 'tlsv1 alert unknown ca',
         )
-        if not six.PY2:
-            if IS_MACOS and IS_PYPY and adapter_type == 'pyopenssl':
-                expected_substrings = ('tlsv1 alert unknown ca',)
+        if IS_MACOS and IS_PYPY and adapter_type == 'pyopenssl':
+            expected_substrings = ('tlsv1 alert unknown ca',)
         if (
                 tls_verify_mode in (
                     ssl.CERT_REQUIRED,
@@ -469,9 +453,9 @@ def test_tls_client_auth(  # noqa: C901  # FIXME
         pytest.param(
             'builtin',
             marks=pytest.mark.xfail(
-                IS_GITHUB_ACTIONS_WORKFLOW and IS_MACOS and PY310_PLUS,
+                IS_MACOS and PY310_PLUS,
                 reason='Unclosed TLS resource warnings happen on macOS '
-                'under Python 3.10',
+                'under Python 3.10 (#508)',
                 strict=False,
             ),
         ),
@@ -492,6 +476,7 @@ def test_ssl_env(  # noqa: C901  # FIXME
         thread_exceptions,
         recwarn,
         mocker,
+        http_request_timeout,
         tls_http_server, adapter_type,
         ca, tls_verify_mode, tls_certificate,
         tls_certificate_chain_pem_path,
@@ -532,13 +517,10 @@ def test_ssl_env(  # noqa: C901  # FIXME
 
         resp = requests.get(
             'https://' + interface + ':' + str(port) + '/env',
+            timeout=http_request_timeout,
             verify=tls_ca_certificate_pem_path,
             cert=cl_pem if use_client_cert else None,
         )
-        if PY34 and resp.status_code != 200:
-            pytest.xfail(
-                'Python 3.4 has problems with verifying client certs',
-            )
 
         env = json.loads(resp.content.decode('utf-8'))
 
@@ -620,7 +602,7 @@ def test_https_over_http_error(http_server, ip_addr):
     httpserver = http_server.send((ip_addr, EPHEMERAL_PORT))
     interface, _host, port = _get_conn_data(httpserver.bind_addr)
     with pytest.raises(ssl.SSLError) as ssl_err:
-        six.moves.http_client.HTTPSConnection(
+        http.client.HTTPSConnection(
             '{interface}:{port}'.format(
                 interface=interface,
                 port=port,
@@ -633,20 +615,10 @@ def test_https_over_http_error(http_server, ip_addr):
     assert expected_substring in ssl_err.value.args[-1]
 
 
-http_over_https_error_builtin_marks = []
-if IS_WINDOWS and six.PY2:
-    http_over_https_error_builtin_marks.append(
-        pytest.mark.flaky(reruns=5, reruns_delay=2),
-    )
-
-
 @pytest.mark.parametrize(
     'adapter_type',
     (
-        pytest.param(
-            'builtin',
-            marks=http_over_https_error_builtin_marks,
-        ),
+        'builtin',
         'pyopenssl',
     ),
 )
@@ -657,7 +629,9 @@ if IS_WINDOWS and six.PY2:
         pytest.param(ANY_INTERFACE_IPV6, marks=missing_ipv6),
     ),
 )
+@pytest.mark.flaky(reruns=3, reruns_delay=2)
 def test_http_over_https_error(
+    http_request_timeout,
     tls_http_server, adapter_type,
     ca, ip_addr,
     tls_certificate,
@@ -697,36 +671,12 @@ def test_http_over_https_error(
     expect_fallback_response_over_plain_http = (
         (
             adapter_type == 'pyopenssl'
-            and (IS_ABOVE_OPENSSL10 or not six.PY2)
         )
-        or PY27
-    ) or (
-        IS_GITHUB_ACTIONS_WORKFLOW
-        and IS_WINDOWS
-        and six.PY2
-        and not IS_WIN2016
     )
-    if (
-            IS_GITHUB_ACTIONS_WORKFLOW
-            and IS_WINDOWS
-            and six.PY2
-            and IS_WIN2016
-            and adapter_type == 'builtin'
-            and ip_addr is ANY_INTERFACE_IPV6
-    ):
-        expect_fallback_response_over_plain_http = True
-    if (
-            IS_GITHUB_ACTIONS_WORKFLOW
-            and IS_WINDOWS
-            and six.PY2
-            and not IS_WIN2016
-            and adapter_type == 'builtin'
-            and ip_addr is not ANY_INTERFACE_IPV6
-    ):
-        expect_fallback_response_over_plain_http = False
     if expect_fallback_response_over_plain_http:
         resp = requests.get(
             'http://{host!s}:{port!s}/'.format(host=fqdn, port=port),
+            timeout=http_request_timeout,
         )
         assert resp.status_code == 400
         assert resp.text == (
@@ -738,6 +688,7 @@ def test_http_over_https_error(
     with pytest.raises(requests.exceptions.ConnectionError) as ssl_err:
         requests.get(  # FIXME: make stdlib ssl behave like PyOpenSSL
             'http://{host!s}:{port!s}/'.format(host=fqdn, port=port),
+            timeout=http_request_timeout,
         )
 
     if IS_LINUX:
diff --git a/lib/cheroot/test/test_wsgi.py b/lib/cheroot/test/test_wsgi.py
index 91dfb71e..14005a84 100644
--- a/lib/cheroot/test/test_wsgi.py
+++ b/lib/cheroot/test/test_wsgi.py
@@ -37,6 +37,7 @@ def simple_wsgi_server():
         yield locals()
 
 
+@pytest.mark.flaky(reruns=3, reruns_delay=2)
 def test_connection_keepalive(simple_wsgi_server):
     """Test the connection keepalive works (duh)."""
     session = Session(base_url=simple_wsgi_server['url'])
@@ -59,6 +60,7 @@ def test_connection_keepalive(simple_wsgi_server):
         ]
         failures = sum(task.result() for task in tasks)
 
+    session.close()
     assert not failures
 
 
diff --git a/lib/cheroot/test/webtest.py b/lib/cheroot/test/webtest.py
index 118014a6..1630c8ef 100644
--- a/lib/cheroot/test/webtest.py
+++ b/lib/cheroot/test/webtest.py
@@ -15,9 +15,6 @@ the traceback to stdout, and keep any assertions you have from running
 be of further significance to your tests).
 """
 
-from __future__ import absolute_import, division, print_function
-__metaclass__ = type
-
 import pprint
 import re
 import socket
@@ -29,9 +26,8 @@ import json
 import unittest  # pylint: disable=deprecated-module,preferred-module
 import warnings
 import functools
-
-from six.moves import http_client, map, urllib_parse
-import six
+import http.client
+import urllib.parse
 
 from more_itertools.more import always_iterable
 import jaraco.functools
@@ -105,7 +101,7 @@ class WebCase(unittest.TestCase):
 
     HOST = '127.0.0.1'
     PORT = 8000
-    HTTP_CONN = http_client.HTTPConnection
+    HTTP_CONN = http.client.HTTPConnection
     PROTOCOL = 'HTTP/1.1'
 
     scheme = 'http'
@@ -127,7 +123,7 @@ class WebCase(unittest.TestCase):
         * from :py:mod:`python:http.client`.
         """
         cls_name = '{scheme}Connection'.format(scheme=self.scheme.upper())
-        return getattr(http_client, cls_name)
+        return getattr(http.client, cls_name)
 
     def get_conn(self, auto_open=False):
         """Return a connection to our HTTP server."""
@@ -201,9 +197,9 @@ class WebCase(unittest.TestCase):
         """
         ServerError.on = False
 
-        if isinstance(url, six.text_type):
+        if isinstance(url, str):
             url = url.encode('utf-8')
-        if isinstance(body, six.text_type):
+        if isinstance(body, str):
             body = body.encode('utf-8')
 
         # for compatibility, support raise_subcls is None
@@ -386,7 +382,7 @@ class WebCase(unittest.TestCase):
 
     def assertBody(self, value, msg=None):
         """Fail if value != self.body."""
-        if isinstance(value, six.text_type):
+        if isinstance(value, str):
             value = value.encode(self.encoding)
         if value != self.body:
             if msg is None:
@@ -397,7 +393,7 @@ class WebCase(unittest.TestCase):
 
     def assertInBody(self, value, msg=None):
         """Fail if value not in self.body."""
-        if isinstance(value, six.text_type):
+        if isinstance(value, str):
             value = value.encode(self.encoding)
         if value not in self.body:
             if msg is None:
@@ -406,7 +402,7 @@ class WebCase(unittest.TestCase):
 
     def assertNotInBody(self, value, msg=None):
         """Fail if value in self.body."""
-        if isinstance(value, six.text_type):
+        if isinstance(value, str):
             value = value.encode(self.encoding)
         if value in self.body:
             if msg is None:
@@ -415,7 +411,7 @@ class WebCase(unittest.TestCase):
 
     def assertMatchesBody(self, pattern, msg=None, flags=0):
         """Fail if value (a regex pattern) is not in self.body."""
-        if isinstance(pattern, six.text_type):
+        if isinstance(pattern, str):
             pattern = pattern.encode(self.encoding)
         if re.search(pattern, self.body, flags) is None:
             if msg is None:
@@ -464,25 +460,7 @@ def shb(response):
     """Return status, headers, body the way we like from a response."""
     resp_status_line = '%s %s' % (response.status, response.reason)
 
-    if not six.PY2:
-        return resp_status_line, response.getheaders(), response.read()
-
-    h = []
-    key, value = None, None
-    for line in response.msg.headers:
-        if line:
-            if line[0] in ' \t':
-                value += line.strip()
-            else:
-                if key and value:
-                    h.append((key, value))
-                key, value = line.split(':', 1)
-                key = key.strip()
-                value = value.strip()
-    if key and value:
-        h.append((key, value))
-
-    return resp_status_line, h, response.read()
+    return resp_status_line, response.getheaders(), response.read()
 
 
 # def openURL(*args, raise_subcls=(), **kwargs):
@@ -514,7 +492,7 @@ def openURL(*args, **kwargs):
 
 def _open_url_once(
     url, headers=None, method='GET', body=None,
-    host='127.0.0.1', port=8000, http_conn=http_client.HTTPConnection,
+    host='127.0.0.1', port=8000, http_conn=http.client.HTTPConnection,
     protocol='HTTP/1.1', ssl_context=None,
 ):
     """Open the given HTTP resource and return status, headers, and body."""
@@ -530,7 +508,7 @@ def _open_url_once(
         conn = http_conn(interface(host), port, **kw)
     conn._http_vsn_str = protocol
     conn._http_vsn = int(''.join([x for x in protocol if x.isdigit()]))
-    if not six.PY2 and isinstance(url, bytes):
+    if isinstance(url, bytes):
         url = url.decode()
     conn.putrequest(
         method.upper(), url, skip_host=True,
@@ -572,10 +550,10 @@ def strip_netloc(url):
     >>> strip_netloc('/foo/bar?bing#baz')
     '/foo/bar?bing'
     """
-    parsed = urllib_parse.urlparse(url)
+    parsed = urllib.parse.urlparse(url)
     _scheme, _netloc, path, params, query, _fragment = parsed
     stripped = '', '', path, params, query, ''
-    return urllib_parse.urlunparse(stripped)
+    return urllib.parse.urlunparse(stripped)
 
 
 # Add any exceptions which your web framework handles
diff --git a/lib/cheroot/testing.py b/lib/cheroot/testing.py
index c9a6ac99..169142bf 100644
--- a/lib/cheroot/testing.py
+++ b/lib/cheroot/testing.py
@@ -1,16 +1,13 @@
 """Pytest fixtures and other helpers for doing testing by end-users."""
 
-from __future__ import absolute_import, division, print_function
-__metaclass__ = type
-
-from contextlib import closing
+from contextlib import closing, contextmanager
 import errno
 import socket
 import threading
 import time
+import http.client
 
 import pytest
-from six.moves import http_client
 
 import cheroot.server
 from cheroot.test import webtest
@@ -33,6 +30,7 @@ config = {
 }
 
 
+@contextmanager
 def cheroot_server(server_factory):
     """Set up and tear down a Cheroot server instance."""
     conf = config[server_factory].copy()
@@ -64,14 +62,14 @@ def cheroot_server(server_factory):
 @pytest.fixture
 def wsgi_server():
     """Set up and tear down a Cheroot WSGI server instance."""
-    for srv in cheroot_server(cheroot.wsgi.Server):
+    with cheroot_server(cheroot.wsgi.Server) as srv:
         yield srv
 
 
 @pytest.fixture
 def native_server():
     """Set up and tear down a Cheroot HTTP server instance."""
-    for srv in cheroot_server(cheroot.server.HTTPServer):
+    with cheroot_server(cheroot.server.HTTPServer) as srv:
         yield srv
 
 
@@ -89,9 +87,9 @@ class _TestClient:
             port=self._port,
         )
         conn_cls = (
-            http_client.HTTPConnection
+            http.client.HTTPConnection
             if self.server_instance.ssl_adapter is None else
-            http_client.HTTPSConnection
+            http.client.HTTPSConnection
         )
         return conn_cls(name)
 
diff --git a/lib/cheroot/workers/threadpool.py b/lib/cheroot/workers/threadpool.py
index 795ebc6d..2a9878dc 100644
--- a/lib/cheroot/workers/threadpool.py
+++ b/lib/cheroot/workers/threadpool.py
@@ -5,17 +5,12 @@
    joinable
 """
 
-from __future__ import absolute_import, division, print_function
-__metaclass__ = type
-
-
 import collections
 import threading
 import time
 import socket
 import warnings
-
-from six.moves import queue
+import queue
 
 from jaraco.functools import pass_none
 
@@ -178,7 +173,7 @@ class ThreadPool:
         for worker in self._threads:
             worker.name = (
                 'CP Server {worker_name!s}'.
-                format(worker_name=worker.name),
+                format(worker_name=worker.name)
             )
             worker.start()
         for worker in self._threads:
@@ -228,7 +223,7 @@ class ThreadPool:
         worker = WorkerThread(self.server)
         worker.name = (
             'CP Server {worker_name!s}'.
-            format(worker_name=worker.name),
+            format(worker_name=worker.name)
         )
         worker.start()
         return worker
diff --git a/lib/cheroot/wsgi.py b/lib/cheroot/wsgi.py
index 583d52a9..82faca3e 100644
--- a/lib/cheroot/wsgi.py
+++ b/lib/cheroot/wsgi.py
@@ -25,14 +25,8 @@ as you want in one instance by using a PathInfoDispatcher::
     server = wsgi.Server(addr, d)
 """
 
-from __future__ import absolute_import, division, print_function
-__metaclass__ = type
-
 import sys
 
-import six
-from six.moves import filter
-
 from . import server
 from .workers import threadpool
 from ._compat import ntob, bton
@@ -140,7 +134,7 @@ class Gateway(server.Gateway):
         response = self.req.server.wsgi_app(self.env, self.start_response)
         try:
             for chunk in filter(None, response):
-                if not isinstance(chunk, six.binary_type):
+                if not isinstance(chunk, bytes):
                     raise ValueError('WSGI Applications must yield bytes')
                 self.write(chunk)
         finally:
@@ -149,7 +143,7 @@ class Gateway(server.Gateway):
             if hasattr(response, 'close'):
                 response.close()
 
-    def start_response(self, status, headers, exc_info=None):
+    def start_response(self, status, headers, exc_info=None):  # noqa: WPS238
         """WSGI callable to begin the HTTP response."""
         # "The application may call start_response more than once,
         # if and only if the exc_info argument is provided."
@@ -164,10 +158,8 @@ class Gateway(server.Gateway):
         # sent, start_response must raise an error, and should raise the
         # exc_info tuple."
         if self.req.sent_headers:
-            try:
-                six.reraise(*exc_info)
-            finally:
-                exc_info = None
+            value = exc_info[1]
+            raise value
 
         self.req.status = self._encode_status(status)
 
@@ -196,8 +188,6 @@ class Gateway(server.Gateway):
         must be of type "str" but are restricted to code points in the
         "Latin-1" set.
         """
-        if six.PY2:
-            return status
         if not isinstance(status, str):
             raise TypeError('WSGI response status is not of type str.')
         return status.encode('ISO-8859-1')
@@ -273,7 +263,7 @@ class Gateway_10(Gateway):
             'wsgi.version': self.version,
         }
 
-        if isinstance(req.server.bind_addr, six.string_types):
+        if isinstance(req.server.bind_addr, str):
             # AF_UNIX. This isn't really allowed by WSGI, which doesn't
             # address unix domain sockets. But it's better than nothing.
             env['SERVER_PORT'] = ''
@@ -332,10 +322,10 @@ class Gateway_u0(Gateway_10):
         """Return a new environ dict targeting the given wsgi.version."""
         req = self.req
         env_10 = super(Gateway_u0, self).get_environ()
-        env = dict(map(self._decode_key, env_10.items()))
+        env = dict(env_10.items())
 
         # Request-URI
-        enc = env.setdefault(six.u('wsgi.url_encoding'), six.u('utf-8'))
+        enc = env.setdefault('wsgi.url_encoding', 'utf-8')
         try:
             env['PATH_INFO'] = req.path.decode(enc)
             env['QUERY_STRING'] = req.qs.decode(enc)
@@ -345,25 +335,10 @@ class Gateway_u0(Gateway_10):
             env['PATH_INFO'] = env_10['PATH_INFO']
             env['QUERY_STRING'] = env_10['QUERY_STRING']
 
-        env.update(map(self._decode_value, env.items()))
+        env.update(env.items())
 
         return env
 
-    @staticmethod
-    def _decode_key(item):
-        k, v = item
-        if six.PY2:
-            k = k.decode('ISO-8859-1')
-        return k, v
-
-    @staticmethod
-    def _decode_value(item):
-        k, v = item
-        skip_keys = 'REQUEST_URI', 'wsgi.input'
-        if not six.PY2 or not isinstance(v, bytes) or k in skip_keys:
-            return k, v
-        return k, v.decode('ISO-8859-1')
-
 
 wsgi_gateways = Gateway.gateway_map()
 
diff --git a/lib/cheroot/wsgi.pyi b/lib/cheroot/wsgi.pyi
index b4851a3d..96075633 100644
--- a/lib/cheroot/wsgi.pyi
+++ b/lib/cheroot/wsgi.pyi
@@ -40,3 +40,10 @@ class PathInfoDispatcher:
     apps: Any
     def __init__(self, apps): ...
     def __call__(self, environ, start_response): ...
+
+
+WSGIServer = Server
+WSGIGateway = Gateway
+WSGIGateway_u0 = Gateway_u0
+WSGIGateway_10 = Gateway_10
+WSGIPathInfoDispatcher = PathInfoDispatcher
diff --git a/requirements.txt b/requirements.txt
index 2a5b1836..dfafa748 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -7,7 +7,7 @@ backports.zoneinfo==0.2.1
 beautifulsoup4==4.11.1
 bleach==5.0.1
 certifi==2022.9.24
-cheroot==8.6.0
+cheroot==9.0.0
 cherrypy==18.8.0
 cloudinary==1.30.0
 distro==1.8.0

From d596b86c8dee9b45333d887af20e6812f963f99a Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 21 Dec 2022 15:59:10 -0800
Subject: [PATCH 256/743] Bump urllib3 from 1.26.12 to 1.26.13 (#1908)

* Bump urllib3 from 1.26.12 to 1.26.13

Bumps [urllib3](https://github.com/urllib3/urllib3) from 1.26.12 to 1.26.13.
- [Release notes](https://github.com/urllib3/urllib3/releases)
- [Changelog](https://github.com/urllib3/urllib3/blob/1.26.13/CHANGES.rst)
- [Commits](https://github.com/urllib3/urllib3/compare/1.26.12...1.26.13)

---
updated-dependencies:
- dependency-name: urllib3
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

* Update urllib3==1.26.13

Signed-off-by: dependabot[bot] <support@github.com>
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/urllib3/_version.py          |  2 +-
 lib/urllib3/connectionpool.py    |  2 +-
 lib/urllib3/contrib/pyopenssl.py |  7 +++----
 lib/urllib3/response.py          | 13 +++++++++++++
 lib/urllib3/util/retry.py        |  2 +-
 lib/urllib3/util/url.py          |  2 +-
 requirements.txt                 |  2 +-
 7 files changed, 21 insertions(+), 9 deletions(-)

diff --git a/lib/urllib3/_version.py b/lib/urllib3/_version.py
index 6fbc84b3..308d7f28 100644
--- a/lib/urllib3/_version.py
+++ b/lib/urllib3/_version.py
@@ -1,2 +1,2 @@
 # This file is protected via CODEOWNERS
-__version__ = "1.26.12"
+__version__ = "1.26.13"
diff --git a/lib/urllib3/connectionpool.py b/lib/urllib3/connectionpool.py
index 96339e90..70873927 100644
--- a/lib/urllib3/connectionpool.py
+++ b/lib/urllib3/connectionpool.py
@@ -862,7 +862,7 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
             )
 
         # Check if we should retry the HTTP response.
-        has_retry_after = bool(response.getheader("Retry-After"))
+        has_retry_after = bool(response.headers.get("Retry-After"))
         if retries.is_retry(method, response.status, has_retry_after):
             try:
                 retries = retries.increment(method, url, response=response, _pool=self)
diff --git a/lib/urllib3/contrib/pyopenssl.py b/lib/urllib3/contrib/pyopenssl.py
index 50a07d59..1ed214b1 100644
--- a/lib/urllib3/contrib/pyopenssl.py
+++ b/lib/urllib3/contrib/pyopenssl.py
@@ -47,10 +47,10 @@ compression in Python 2 (see `CRIME attack`_).
 """
 from __future__ import absolute_import
 
+import OpenSSL.crypto
 import OpenSSL.SSL
 from cryptography import x509
 from cryptography.hazmat.backends.openssl import backend as openssl_backend
-from cryptography.hazmat.backends.openssl.x509 import _Certificate
 
 try:
     from cryptography.x509 import UnsupportedExtension
@@ -228,9 +228,8 @@ def get_subj_alt_name(peer_cert):
     if hasattr(peer_cert, "to_cryptography"):
         cert = peer_cert.to_cryptography()
     else:
-        # This is technically using private APIs, but should work across all
-        # relevant versions before PyOpenSSL got a proper API for this.
-        cert = _Certificate(openssl_backend, peer_cert._x509)
+        der = OpenSSL.crypto.dump_certificate(OpenSSL.crypto.FILETYPE_ASN1, peer_cert)
+        cert = x509.load_der_x509_certificate(der, openssl_backend)
 
     # We want to find the SAN extension. Ask Cryptography to locate it (it's
     # faster than looping in Python)
diff --git a/lib/urllib3/response.py b/lib/urllib3/response.py
index 01f08eee..8f1b4fa8 100644
--- a/lib/urllib3/response.py
+++ b/lib/urllib3/response.py
@@ -3,6 +3,7 @@ from __future__ import absolute_import
 import io
 import logging
 import sys
+import warnings
 import zlib
 from contextlib import contextmanager
 from socket import error as SocketError
@@ -663,9 +664,21 @@ class HTTPResponse(io.IOBase):
 
     # Backwards-compatibility methods for http.client.HTTPResponse
     def getheaders(self):
+        warnings.warn(
+            "HTTPResponse.getheaders() is deprecated and will be removed "
+            "in urllib3 v2.1.0. Instead access HTTResponse.headers directly.",
+            category=DeprecationWarning,
+            stacklevel=2,
+        )
         return self.headers
 
     def getheader(self, name, default=None):
+        warnings.warn(
+            "HTTPResponse.getheader() is deprecated and will be removed "
+            "in urllib3 v2.1.0. Instead use HTTResponse.headers.get(name, default).",
+            category=DeprecationWarning,
+            stacklevel=2,
+        )
         return self.headers.get(name, default)
 
     # Backwards compatibility for http.cookiejar
diff --git a/lib/urllib3/util/retry.py b/lib/urllib3/util/retry.py
index 3398323f..2490d5e5 100644
--- a/lib/urllib3/util/retry.py
+++ b/lib/urllib3/util/retry.py
@@ -394,7 +394,7 @@ class Retry(object):
     def get_retry_after(self, response):
         """Get the value of Retry-After in seconds."""
 
-        retry_after = response.getheader("Retry-After")
+        retry_after = response.headers.get("Retry-After")
 
         if retry_after is None:
             return None
diff --git a/lib/urllib3/util/url.py b/lib/urllib3/util/url.py
index b667c160..94f1b8d4 100644
--- a/lib/urllib3/util/url.py
+++ b/lib/urllib3/util/url.py
@@ -63,7 +63,7 @@ IPV6_ADDRZ_RE = re.compile("^" + IPV6_ADDRZ_PAT + "$")
 BRACELESS_IPV6_ADDRZ_RE = re.compile("^" + IPV6_ADDRZ_PAT[2:-2] + "$")
 ZONE_ID_RE = re.compile("(" + ZONE_ID_PAT + r")\]$")
 
-_HOST_PORT_PAT = ("^(%s|%s|%s)(?::([0-9]{0,5}))?$") % (
+_HOST_PORT_PAT = ("^(%s|%s|%s)(?::0*([0-9]{0,5}))?$") % (
     REG_NAME_PAT,
     IPV4_PAT,
     IPV6_ADDRZ_PAT,
diff --git a/requirements.txt b/requirements.txt
index dfafa748..727bd6db 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -45,7 +45,7 @@ tempora==5.1.0
 tokenize-rt==5.0.0
 tzdata==2022.6
 tzlocal==4.2
-urllib3==1.26.12
+urllib3==1.26.13
 webencodings==0.5.1
 websocket-client==1.4.2
 xmltodict==0.13.0

From e646c0e6ebb5f2fb7a56e05b2dec16fbc6d6e6c1 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 21 Dec 2022 15:59:38 -0800
Subject: [PATCH 257/743] Bump zipp from 3.10.0 to 3.11.0 (#1912)

* Bump zipp from 3.10.0 to 3.11.0

Bumps [zipp](https://github.com/jaraco/zipp) from 3.10.0 to 3.11.0.
- [Release notes](https://github.com/jaraco/zipp/releases)
- [Changelog](https://github.com/jaraco/zipp/blob/main/CHANGES.rst)
- [Commits](https://github.com/jaraco/zipp/compare/v3.10.0...v3.11.0)

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

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

* Update zipp==3.11.0

Signed-off-by: dependabot[bot] <support@github.com>
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/zipp/__init__.py | 46 ++++++++++++++++++++++++++++++++++++++++++++
 requirements.txt     |  2 +-
 2 files changed, 47 insertions(+), 1 deletion(-)

diff --git a/lib/zipp/__init__.py b/lib/zipp/__init__.py
index c1f3632e..ad01e27e 100644
--- a/lib/zipp/__init__.py
+++ b/lib/zipp/__init__.py
@@ -4,6 +4,8 @@ import zipfile
 import itertools
 import contextlib
 import pathlib
+import re
+import fnmatch
 
 from .py310compat import text_encoding
 
@@ -243,6 +245,18 @@ class Path:
         self.root = FastLookup.make(root)
         self.at = at
 
+    def __eq__(self, other):
+        """
+        >>> Path(zipfile.ZipFile(io.BytesIO(), 'w')) == 'foo'
+        False
+        """
+        if self.__class__ is not other.__class__:
+            return NotImplemented
+        return (self.root, self.at) == (other.root, other.at)
+
+    def __hash__(self):
+        return hash((self.root, self.at))
+
     def open(self, mode='r', *args, pwd=None, **kwargs):
         """
         Open this entry as text or binary following the semantics
@@ -313,6 +327,38 @@ class Path:
         subs = map(self._next, self.root.namelist())
         return filter(self._is_child, subs)
 
+    def match(self, path_pattern):
+        return pathlib.Path(self.at).match(path_pattern)
+
+    def is_symlink(self):
+        """
+        Return whether this path is a symlink. Always false (python/cpython#82102).
+        """
+        return False
+
+    def _descendants(self):
+        for child in self.iterdir():
+            yield child
+            if child.is_dir():
+                yield from child._descendants()
+
+    def glob(self, pattern):
+        if not pattern:
+            raise ValueError("Unacceptable pattern: {!r}".format(pattern))
+
+        matches = re.compile(fnmatch.translate(pattern)).fullmatch
+        return (
+            child
+            for child in self._descendants()
+            if matches(str(child.relative_to(self)))
+        )
+
+    def rglob(self, pattern):
+        return self.glob(f'**/{pattern}')
+
+    def relative_to(self, other, *extra):
+        return posixpath.relpath(str(self), str(other.joinpath(*extra)))
+
     def __str__(self):
         return posixpath.join(self.root.filename, self.at)
 
diff --git a/requirements.txt b/requirements.txt
index 727bd6db..6de9a262 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -49,7 +49,7 @@ urllib3==1.26.13
 webencodings==0.5.1
 websocket-client==1.4.2
 xmltodict==0.13.0
-zipp==3.10.0
+zipp==3.11.0
 
 # configobj==5.1.0
 # sgmllib3k==1.0.0

From c61f85431822a26b4b8a4b17b153a612ee00202d Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 21 Dec 2022 15:59:53 -0800
Subject: [PATCH 258/743] Bump tzdata from 2022.6 to 2022.7 (#1915)

* Bump tzdata from 2022.6 to 2022.7

Bumps [tzdata](https://github.com/python/tzdata) from 2022.6 to 2022.7.
- [Release notes](https://github.com/python/tzdata/releases)
- [Changelog](https://github.com/python/tzdata/blob/master/NEWS.md)
- [Commits](https://github.com/python/tzdata/compare/2022.6...2022.7)

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

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

* Update tzdata==2022.7

Signed-off-by: dependabot[bot] <support@github.com>
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/tzdata/__init__.py                    |   4 +-
 lib/tzdata/zoneinfo/America/Bogota        | Bin 179 -> 179 bytes
 lib/tzdata/zoneinfo/America/Cambridge_Bay | Bin 768 -> 883 bytes
 lib/tzdata/zoneinfo/America/Ciudad_Juarez | Bin 0 -> 718 bytes
 lib/tzdata/zoneinfo/America/Godthab       | Bin 465 -> 931 bytes
 lib/tzdata/zoneinfo/America/Inuvik        | Bin 701 -> 817 bytes
 lib/tzdata/zoneinfo/America/Iqaluit       | Bin 740 -> 855 bytes
 lib/tzdata/zoneinfo/America/Nuuk          | Bin 465 -> 931 bytes
 lib/tzdata/zoneinfo/America/Ojinaga       | Bin 691 -> 709 bytes
 lib/tzdata/zoneinfo/America/Pangnirtung   | Bin 769 -> 855 bytes
 lib/tzdata/zoneinfo/America/Rankin_Inlet  | Bin 692 -> 807 bytes
 lib/tzdata/zoneinfo/America/Resolute      | Bin 692 -> 807 bytes
 lib/tzdata/zoneinfo/America/Whitehorse    | Bin 1029 -> 1029 bytes
 lib/tzdata/zoneinfo/America/Yellowknife   | Bin 729 -> 844 bytes
 lib/tzdata/zoneinfo/Asia/Kuala_Lumpur     | Bin 256 -> 256 bytes
 lib/tzdata/zoneinfo/Asia/Singapore        | Bin 256 -> 256 bytes
 lib/tzdata/zoneinfo/Canada/Yukon          | Bin 1029 -> 1029 bytes
 lib/tzdata/zoneinfo/Singapore             | Bin 256 -> 256 bytes
 lib/tzdata/zoneinfo/iso3166.tab           |   6 +--
 lib/tzdata/zoneinfo/tzdata.zi             |  47 +++++++++++++---------
 lib/tzdata/zoneinfo/zone.tab              |  26 ++++++------
 lib/tzdata/zoneinfo/zone1970.tab          |  26 ++++++------
 lib/tzdata/zones                          |   3 +-
 requirements.txt                          |   2 +-
 24 files changed, 63 insertions(+), 51 deletions(-)
 create mode 100644 lib/tzdata/zoneinfo/America/Ciudad_Juarez

diff --git a/lib/tzdata/__init__.py b/lib/tzdata/__init__.py
index c3851325..96456857 100644
--- a/lib/tzdata/__init__.py
+++ b/lib/tzdata/__init__.py
@@ -1,6 +1,6 @@
 # IANA versions like 2020a are not valid PEP 440 identifiers; the recommended
 # way to translate the version is to use YYYY.n where `n` is a 0-based index.
-__version__ = "2022.6"
+__version__ = "2022.7"
 
 # This exposes the original IANA version number.
-IANA_VERSION = "2022f"
+IANA_VERSION = "2022g"
diff --git a/lib/tzdata/zoneinfo/America/Bogota b/lib/tzdata/zoneinfo/America/Bogota
index 6cb53d4e6125c0541eb92871b4f03fda450a6d2e..85b903333eb6325aa8343f6e9aee38447495303f 100644
GIT binary patch
delta 12
TcmdnYxS4T64O2<y#5z*|9=-&)

delta 12
TcmdnYxS4T64b#5ZiFKv`AAkhb

diff --git a/lib/tzdata/zoneinfo/America/Cambridge_Bay b/lib/tzdata/zoneinfo/America/Cambridge_Bay
index 0a2225244a67b412ace9a98978a9a9f1f5535f1f..1092f4b61a1b203f7feabb586b51085bb72602dc 100644
GIT binary patch
delta 269
zcmZo*`^+{WjMImKfq?^v6(+_j)B|Y-mPE-3AeuGcPXmZ%bNCJBvm4w4^Enjmg87^R
z2f%zThW%hZ*M~)5KKFx#U_Q^y{XpFe47>-L!F;}*3&DK;l?wzw41t-=V7_2y6PPbl
znaaqpvHuvO8w)cTkd2j{4Mp4JUM4A()e9H}{{P>(fl=iD|J4f^BtUEi8C?Sd2H)@y
O2HyZ64xW6CNecj6RWauP

delta 153
zcmey&*1$F)jMI*Rfq@f<RVT(P2>b_v@A^>%Ao_<!>xYg1k1<-XG7|;a**Mry6i()5
xmeSw3fe~ox>IICV|NjHok{~vNEQrmZsB2)r;2R#o;2QwM!9eWdGTD<^3jm(^DUSdE

diff --git a/lib/tzdata/zoneinfo/America/Ciudad_Juarez b/lib/tzdata/zoneinfo/America/Ciudad_Juarez
new file mode 100644
index 0000000000000000000000000000000000000000..f636ee643fe49a583fb2db3ff8408c341a06e8d3
GIT binary patch
literal 718
zcmb8n%PYiD6bJD88zY(~CfSh`r8I^a#``_Pc>O$oromu5A}JJEky*%OWmwpFWI+}d
zCTWneV<{|zg%l!LphS6G_k8^Ua&G7MJ)hgTKc%s!%f$XHNo-J4DSto75o>{>!?~yx
z|NQ{v`b*yxrN7JWqTI5aAh)%tzxg%sME^H-4^uGHVDJECvduxkQfePyb6kmzoNBso
zQ>F#Q!|4%kM3#Q1g)=_R;mp@CFAZ7#V>sKVfpc~j;M}Q4IB#wY&hI~j3&!W%bWvF4
zgDst-ur+Z8F0!`5#i2v6Ew%u*y-(}JGghjOflJQ@;j)`RxO{#E`xU27SRV1fmHu3~
z%Gm=~&ql*F+2wHUunMk=On{a88(8@ah3)18*nX?mF;R}FYYOJr4}lxL_u<CnC%EZy
z6?TrFz|DJ;a7*VV+`8BcyW}G;4Q(Eeo3cG&1MX-^B(jc)XP2as0wk4MoB%QW>!>8o
z=k<(nzTjnQ&exV$FnuL0=Q}=0S0O7*u2Yyrv}_eAS|cvf1oU#U!DL9%%SNNYXh_oh
E0Js*Lo&W#<

literal 0
HcmV?d00001

diff --git a/lib/tzdata/zoneinfo/America/Godthab b/lib/tzdata/zoneinfo/America/Godthab
index 4ddc99d8b74c4b525263ca1337cb57d1a15692c0..79d7a45464b3f1dac470b9ea5f6a12b1344c8173 100644
GIT binary patch
literal 931
zcmcJ{-Ahwp9Ki9j=17JYr_7hy%xbM^&03q8+SF{hQEg^+s%5TaE-4sZNJJNgM$$!$
zIKc?QBBSUc%x*?qs6|9jWERAT-Y6Iqz0i$GQOM~$-~9nz^&Fn(!xzr)r?egEa!a!w
zgZ_uO;wZC^g!SKY^qZ&YXR!aU7?bity)D88o<FLv!1fIb^WS2T@oCnnyI7pLg$rK{
z;i3oU&@whIi+Stt2$o#DjEfU0miC^+CGj3y+TMxFf(qKaO}N}yg?6h0SL79=!{k%N
ze#dkrmVLBidAbl+KAelIQoqr8?F&{UU*qb5C%ES57`kFNac$(4EcUv4Qs}80#md(6
zxUS?9R=JO7o$14BOHvhc)$cm!n!m^B+HoJf;Z2zKUXNnkXf4*CZp4N`D{kzvVdFrJ
zEcR{kn`mFmLT|Qzrki{-wBPiY4%pt)fghi6i}8Ne$w#;~a}~FZ+`!<(Jyq-volVfq
z!&m6--Q9Fc;uO7O&lzluAHtpM<ER7!xT~lccRS0o{&Hcsz%Psa;g|F2z0+lM+wGt9
zzO<QcADV}e)OXz9H-*vUBp!&SvE#&7RqQ+1aEI=UOwh5?3$kI(fBB4>_N-r$G%fvH
d%F(pU2ScuSrQBdhkt$ps{kkQySAXl>=6^d<qv`+v

delta 110
zcmZ3?evz3qBq}q_c%q=#L<RPV3ak^=1sI_`HU=dI1_tJh(ISkK6`7SB{{KJUz`*eT
z|J4f&EdT#Me!$4#;~T=DYhVn-MhsjwK$e{`kTkN>@io>n)ico7HPZ1lG=MM-xd6lX
B9dZBw

diff --git a/lib/tzdata/zoneinfo/America/Inuvik b/lib/tzdata/zoneinfo/America/Inuvik
index af3107db51e3848767a443adf8b3c87c55579061..86639f6ecb4c424911e5bdbca81a9e39c86e850c 100644
GIT binary patch
delta 218
zcmdnXx{+-{SiJ`W0|P4%i~I+I2W)-~KsEzQqWS_5%^Jux0YtMoaxMVT>;`YZd=7=z
zU_Ph7IWV7#;VhWX^<e{;&;4LMn9p<btN>6O1Mh)}U_Rf@^<X~#%5@4Lae<ja6Tt$4
zofE(ULY1iu8|!y7@-Q+X;ABT8!^r_m9LgXq3=IGO&z-=?^8bH-0|N($&A{{j|LO&d
P0=fnU3;~m;F{uLpH1jk}

delta 99
zcmdnUwwHB6n5H!Y0|P4%i~a|K2W)-~Ao{z02AKY#F$E~az#!N;L1E+b-HekrGMT9{
pvw+1I{{LUSfRW|@|NaIB&j0`CPGH~#iwNo(7%&95Oy*)%2LM5XC~g1%

diff --git a/lib/tzdata/zoneinfo/America/Iqaluit b/lib/tzdata/zoneinfo/America/Iqaluit
index eb2c99cca53a5559c5b3ebe6e08032bb60ab4930..95e055cb55d19335fa96f1a8d81fb5620f790771 100644
GIT binary patch
delta 285
zcmaFDdYx@T7^fEl0|Pq{%S?=ys0Y#vED3)LKs0N>g9H%G=5Qa(XE!(m=5r_<1oJrs
zmVo(O42!{ht`BWsKKFxGFrVk<q6Z8>z<VGa%;($L0_O9tZ2kZe7nqp_<_mVFg84#~
z9*hq*w(nr9XJKSwCJ(Z*q3Q$K!@%(W|M3HiEdT%S+`zyAX7hkaf&c$kFJKS>i8D&*
T8W=FR281xU28T@E&7=tcn1eh_

delta 172
zcmcc4_Jnmp7^e*b0|N&TD^84;5cm%S-}UVRK=cod%nKX8?_jKFWn^MzVj&K)v7@R3
z8Vm&g{~tfV$nyXH&J7G4|NmdTz{mp@5d@Q>|NpOEz#s{dWt7!5Fko;E2w`vy24WW%
K5HZ=1Sq%X7!ZD2i

diff --git a/lib/tzdata/zoneinfo/America/Nuuk b/lib/tzdata/zoneinfo/America/Nuuk
index 4ddc99d8b74c4b525263ca1337cb57d1a15692c0..79d7a45464b3f1dac470b9ea5f6a12b1344c8173 100644
GIT binary patch
literal 931
zcmcJ{-Ahwp9Ki9j=17JYr_7hy%xbM^&03q8+SF{hQEg^+s%5TaE-4sZNJJNgM$$!$
zIKc?QBBSUc%x*?qs6|9jWERAT-Y6Iqz0i$GQOM~$-~9nz^&Fn(!xzr)r?egEa!a!w
zgZ_uO;wZC^g!SKY^qZ&YXR!aU7?bity)D88o<FLv!1fIb^WS2T@oCnnyI7pLg$rK{
z;i3oU&@whIi+Stt2$o#DjEfU0miC^+CGj3y+TMxFf(qKaO}N}yg?6h0SL79=!{k%N
ze#dkrmVLBidAbl+KAelIQoqr8?F&{UU*qb5C%ES57`kFNac$(4EcUv4Qs}80#md(6
zxUS?9R=JO7o$14BOHvhc)$cm!n!m^B+HoJf;Z2zKUXNnkXf4*CZp4N`D{kzvVdFrJ
zEcR{kn`mFmLT|Qzrki{-wBPiY4%pt)fghi6i}8Ne$w#;~a}~FZ+`!<(Jyq-volVfq
z!&m6--Q9Fc;uO7O&lzluAHtpM<ER7!xT~lccRS0o{&Hcsz%Psa;g|F2z0+lM+wGt9
zzO<QcADV}e)OXz9H-*vUBp!&SvE#&7RqQ+1aEI=UOwh5?3$kI(fBB4>_N-r$G%fvH
d%F(pU2ScuSrQBdhkt$ps{kkQySAXl>=6^d<qv`+v

delta 110
zcmZ3?evz3qBq}q_c%q=#L<RPV3ak^=1sI_`HU=dI1_tJh(ISkK6`7SB{{KJUz`*eT
z|J4f&EdT#Me!$4#;~T=DYhVn-MhsjwK$e{`kTkN>@io>n)ico7HPZ1lG=MM-xd6lX
B9dZBw

diff --git a/lib/tzdata/zoneinfo/America/Ojinaga b/lib/tzdata/zoneinfo/America/Ojinaga
index 560b8674f7e16a7e117f4e0c5f9a6a13adc1867a..2fc74e947389cf4371baece8ac66945df1b208fe 100644
GIT binary patch
delta 27
icmdnYdX#m;CMIELmk=FaV?851107#OLp?)111<n^?grri

delta 9
QcmX@gx|wyuCMHHM01|5g@&Et;

diff --git a/lib/tzdata/zoneinfo/America/Pangnirtung b/lib/tzdata/zoneinfo/America/Pangnirtung
index 5be6f9b0160d75c9c10822f22f7c9a7a0c14b21e..95e055cb55d19335fa96f1a8d81fb5620f790771 100644
GIT binary patch
literal 855
zcmbWwO-K}B7zgloZFSe#wbs&FKT6YTnROj!SJ#ie)OHuY5G6+<Pg9u7M$k|ocrn8-
zI*I5-1j$k{JowQ`0?~>Bk;*(-Qd5Txk+N7PC8y{8-#iKZhi9Jm_ssJ$N>il8#}15%
zHhA$U2VbeCH49a`L0P#o+QIwB>^~a1x~tPSW>)`dyvNq-D(`V+Utx><61HY8!SRkU
zSYS_KA=(4m^lsR`{zPY#gvBs?c)klh@~kt;=Z>KkIPuXf_-I=td@ND{CtY{L$yFkJ
zyu=Ql5N)tCOH>&p#kvWn#@OK0Z9(Jnv~Qbm`sy$E<kEZi)a*MrV{{hIY-PBA`r!ba
z)%YFGzCEoo${GJ__-u7Qd@gwccDe7vuDw?p-xGyKSo|^$yMGqJISak8XH8LQjpdF+
zVCi`woY!6h%L7i>8xBYLp6}icoL^A|7hK(d{jMCi(6;~=SrXvlv`;#t6#v-cjg{;!
zV}Ab4D*A=bBRZd7oZixSzx1L*=lycu2e@?jCR}!R4leI{pz`lm>IUIJ^9?wd*9wP%
z0XXz~GHN!(9QwZ}Hg5kt`XR+I-Y%NVhA}_GtT@~8b{NLgW0u6{CTFfJvrxUlLJd?w
es%r`h&^bV7frfq>dTR3}pCo%~y<W*H$-+NRytfhn

literal 769
zcmWHE%1kq2AP5+NDnJ+nLI`WI1uEkLV$J_Ru=r|F1BgD|@hAaAUsC>30Hzb(UI5YG
z^$i?A^bd{b13*0t!kLy2K(t7t%molF>M8vIM2lJc1M|f-{(|`uO40!!aY>H*V7?UN
zUoc<l<DUeOxb(yOV7|=7dtkoo!GmDF+{Oc7zWl<)V7@}>rw2gg42q4dV7^l56);~p
zYvBcuxQgjEFkjWH8O&D`odM>nYo&tu>i@PT0F^Ola=C-~n)jxI`C6|u!F=s~m0-Tk
zWw!v3I^B8EV7}gF4KQE7&KAr!m@EON4b#&<0F^Nq75xJ9jom%Le3PI%V7{rkHkfZ_
zv=7WTXXgd;Eu?QfU;qM(Xa7JHgXQm2U~#Ks7s0gk?RgJC;x_Bw6@X~l-3<>wv|axN
zFyDT55}5ChzX{BDY^hHG$vgQ^0rQ<x62W{I{W37$)x{aicm2HL12ZENGYc~-UdYA{
zg&dqP7K8@c0R;d5U%kM{0wy{B|37|!f#?7K#}60<z#^g`5k|@X|95U+kp2IE^#TS(
z5Svj|*T8_mF+7C9F#w2zf!M_bM1(N7f-q3P8H9msE+EGgD5&FWtY@TWpyO+3sAs5W
Gzy$!<q`lJs

diff --git a/lib/tzdata/zoneinfo/America/Rankin_Inlet b/lib/tzdata/zoneinfo/America/Rankin_Inlet
index 92e2ed2dbe0ff9481f27ff331263beb060f919a1..6d1d90dede9888571eb09299dbd0b3e7dcfb1cc9 100644
GIT binary patch
delta 289
zcmdnOx}0r7SiJ`W0|N^X3;YLy=RJ8qCQu-ey8%SA2D~c((QFQH8$dL>!38j%L*YD_
z&nd78%;#d*2<CHrm;&Z=KbQ>W^W5C<0jQ0E_dqF_&$n|Dn9sj*5=fXqV5U$BSU|9|
z1S}v_8TMgg`EJH~MkcZ#Gm0*-kqrO;@7%!1^8f$p1q>V@HUp2YfdPZFO9+E=a0r7d
Z5OV<;W<UWQUt>KZJp&zI!^!KI*Z}^|IW7PI

delta 149
zcmZ3^wuN;<n4%Q}0|P4%i~a|K=RJ80Ao{z$PXdVkp;7)|<MZ8&Da=enLKYNtKy!iM
t|Nr9$7+L=RU%h~V^Z);y8yI;(B!i%?fdPZFi%STDb1)FQOy*>k0|0BuDaQZ+

diff --git a/lib/tzdata/zoneinfo/America/Resolute b/lib/tzdata/zoneinfo/America/Resolute
index a84d1dfdb3a820a10f52a8fd4d9b4bf39d663132..97eb8a9c1fbbf56b8e32a1bea34f68e263e2a9d7 100644
GIT binary patch
delta 289
zcmdnOx}0r7SiJ`W0|N^X3;YLytG^o?fNTbqL~bz68t|?F#AkDO3+A&MTmbVq6wZVB
zoC2G`d@hEKU_RG}DPTVLgUMh%&&>@V7=VEHKq;8dw{sGh&%bgKNSHxjrceo3K(Mm}
zEFe@F_F-fBZpL~>CbA$ik}hUOu#pV^|L@$u$nyXH>IDoOAT|S!u7LrAvr7nrb8rZQ
aD-d%58D>BM9baQTBRvBhU&G1knAiaMIXWKz

delta 149
zcmZ3^wuN;<n4%Q}0|P4%i~a|KtG^o?K=gNgp9B#7L!<n`#^<{kQ<#~Ege*wvSeSw4
v0>S_P#}6>F{Qtjt0R!j%|2sD@@`6YPL0tm_24@$S5C-R9Aa<F|$t(u|;|eOd

diff --git a/lib/tzdata/zoneinfo/America/Whitehorse b/lib/tzdata/zoneinfo/America/Whitehorse
index 878b6a92f7406b2568b34de88e0c31cc4499d10e..40baa9aba2a879f7a38a5a0f67e16e7a2d677a5e 100644
GIT binary patch
delta 15
XcmZqWXyur&ndQgPmI)iT`!NFmHBbiZ

delta 15
WcmZqWXyur&ndP@^yuiloe#`(Zas{FQ

diff --git a/lib/tzdata/zoneinfo/America/Yellowknife b/lib/tzdata/zoneinfo/America/Yellowknife
index c779cef92c8a166f597be7ab3e1078b6699d84fb..ff3eb8781ee7283c74b186b7c897ce929619929d 100644
GIT binary patch
delta 285
zcmcb~dWLO67^gP_0|P4%i%g7Hs0Y#vEQyj6Ks0N>p9T=k=I|TLXE(S9=5r|A1@k!t
z4uJVw4Ew=+t`CdAeC`Je!F-;Z`+>R{7<dmfgZX?r7lQfxD;EfW7y>h!!F<8aCNN*9
zGL?~GWB)$JdKP9XK(N^i|NpOEz{mn7IsX5jJAr`*%ofl!FktWv4`J{P0ODXEb_rqN
N0y4~jjL9dN1OTZ3HEaL?

delta 172
zcmX@Zc9V5N7^f`*0|OfnOHPbe5cm%S-}R#kK=cod)(;#1?_;cIWhM&(%>;t~|5q<y
zWC4>L|NqaOz`*nW|IQ7JK%0Q#qPhkK48GwZ488$C91O%RE+8U=feXkp2QqYgjVIeP
G^8x?^5iT+S

diff --git a/lib/tzdata/zoneinfo/Asia/Kuala_Lumpur b/lib/tzdata/zoneinfo/Asia/Kuala_Lumpur
index 350d77e28ee770be54bff6aea7f03ebbb82effaa..dbbdea3c8149004cfd525a0fc26e5da72b20e8a1 100644
GIT binary patch
delta 12
TcmZo*YG9f$m+2kD#QBK;90LTi

delta 12
TcmZo*YG9f$m+33V#QBK;97Y7f

diff --git a/lib/tzdata/zoneinfo/Asia/Singapore b/lib/tzdata/zoneinfo/Asia/Singapore
index 350d77e28ee770be54bff6aea7f03ebbb82effaa..dbbdea3c8149004cfd525a0fc26e5da72b20e8a1 100644
GIT binary patch
delta 12
TcmZo*YG9f$m+2kD#QBK;90LTi

delta 12
TcmZo*YG9f$m+33V#QBK;97Y7f

diff --git a/lib/tzdata/zoneinfo/Canada/Yukon b/lib/tzdata/zoneinfo/Canada/Yukon
index 878b6a92f7406b2568b34de88e0c31cc4499d10e..40baa9aba2a879f7a38a5a0f67e16e7a2d677a5e 100644
GIT binary patch
delta 15
XcmZqWXyur&ndQgPmI)iT`!NFmHBbiZ

delta 15
WcmZqWXyur&ndP@^yuiloe#`(Zas{FQ

diff --git a/lib/tzdata/zoneinfo/Singapore b/lib/tzdata/zoneinfo/Singapore
index 350d77e28ee770be54bff6aea7f03ebbb82effaa..dbbdea3c8149004cfd525a0fc26e5da72b20e8a1 100644
GIT binary patch
delta 12
TcmZo*YG9f$m+2kD#QBK;90LTi

delta 12
TcmZo*YG9f$m+33V#QBK;97Y7f

diff --git a/lib/tzdata/zoneinfo/iso3166.tab b/lib/tzdata/zoneinfo/iso3166.tab
index a4ff61a4..911af5e8 100644
--- a/lib/tzdata/zoneinfo/iso3166.tab
+++ b/lib/tzdata/zoneinfo/iso3166.tab
@@ -3,13 +3,13 @@
 # This file is in the public domain, so clarified as of
 # 2009-05-17 by Arthur David Olson.
 #
-# From Paul Eggert (2015-05-02):
+# From Paul Eggert (2022-11-18):
 # This file contains a table of two-letter country codes.  Columns are
 # separated by a single tab.  Lines beginning with '#' are comments.
 # All text uses UTF-8 encoding.  The columns of the table are as follows:
 #
 # 1.  ISO 3166-1 alpha-2 country code, current as of
-#     ISO 3166-1 N976 (2018-11-06).  See: Updates on ISO 3166-1
+#     ISO 3166-1 N1087 (2022-09-02).  See: Updates on ISO 3166-1
 #     https://isotc.iso.org/livelink/livelink/Open/16944257
 # 2.  The usual English name for the coded region,
 #     chosen so that alphabetic sorting of subsets produces helpful lists.
@@ -238,7 +238,7 @@ SY	Syria
 SZ	Eswatini (Swaziland)
 TC	Turks & Caicos Is
 TD	Chad
-TF	French Southern & Antarctic Lands
+TF	French Southern Territories
 TG	Togo
 TH	Thailand
 TJ	Tajikistan
diff --git a/lib/tzdata/zoneinfo/tzdata.zi b/lib/tzdata/zoneinfo/tzdata.zi
index a36449f4..3db1460e 100644
--- a/lib/tzdata/zoneinfo/tzdata.zi
+++ b/lib/tzdata/zoneinfo/tzdata.zi
@@ -1,4 +1,4 @@
-# version 2022f
+# version 2022g
 # This zic input file is in the public domain.
 R d 1916 o - Jun 14 23s 1 S
 R d 1916 1919 - O Su>=1 23s 0 -
@@ -1040,7 +1040,7 @@ Z Asia/Singapore 6:55:25 - LMT 1901
 7:20 - +0720 1941 S
 7:30 - +0730 1942 F 16
 9 - +09 1945 S 12
-7:30 - +0730 1982
+7:30 - +0730 1981 D 31 16u
 8 - +08
 Z Asia/Colombo 5:19:24 - LMT 1880
 5:19:32 - MMT 1906
@@ -1754,7 +1754,8 @@ Z America/Scoresbysund -1:27:52 - LMT 1916 Jul 28
 -1 E -01/+00
 Z America/Nuuk -3:26:56 - LMT 1916 Jul 28
 -3 - -03 1980 Ap 6 2
--3 E -03/-02
+-3 E -03/-02 2023 Mar 25 22
+-2 - -02
 Z America/Thule -4:35:8 - LMT 1916 Jul 28
 -4 Th A%sT
 Z Europe/Tallinn 1:39 - LMT 1880
@@ -3044,16 +3045,11 @@ R Y 1919 o - N 1 0 0 S
 R Y 1942 o - F 9 2 1 W
 R Y 1945 o - Au 14 23u 1 P
 R Y 1945 o - S 30 2 0 S
-R Y 1965 o - Ap lastSu 0 2 DD
-R Y 1965 o - O lastSu 2 0 S
-R Y 1980 1986 - Ap lastSu 2 1 D
-R Y 1980 2006 - O lastSu 2 0 S
+R Y 1972 1986 - Ap lastSu 2 1 D
+R Y 1972 2006 - O lastSu 2 0 S
 R Y 1987 2006 - Ap Su>=1 2 1 D
-Z America/Pangnirtung 0 - -00 1921
--4 Y A%sT 1995 Ap Su>=1 2
--5 C E%sT 1999 O 31 2
--6 C C%sT 2000 O 29 2
--5 C E%sT
+R Yu 1965 o - Ap lastSu 0 2 DD
+R Yu 1965 o - O lastSu 2 0 S
 Z America/Iqaluit 0 - -00 1942 Au
 -5 Y E%sT 1999 O 31 2
 -6 C C%sT 2000 O 29 2
@@ -3082,13 +3078,15 @@ Z America/Inuvik 0 - -00 1953
 -7 Y M%sT 1980
 -7 C M%sT
 Z America/Whitehorse -9:0:12 - LMT 1900 Au 20
--9 Y Y%sT 1967 May 28
--8 Y P%sT 1980
+-9 Y Y%sT 1965
+-9 Yu Y%sT 1966 F 27
+-8 - PST 1980
 -8 C P%sT 2020 N
 -7 - MST
 Z America/Dawson -9:17:40 - LMT 1900 Au 20
--9 Y Y%sT 1973 O 28
--8 Y P%sT 1980
+-9 Y Y%sT 1965
+-9 Yu Y%sT 1973 O 28
+-8 - PST 1980
 -8 C P%sT 2020 N
 -7 - MST
 R m 1931 o - May 1 23 1 D
@@ -3132,6 +3130,17 @@ Z America/Mexico_City -6:36:36 - LMT 1922 Ja 1 7u
 -6 m C%sT 2001 S 30 2
 -6 - CST 2002 F 20
 -6 m C%sT
+Z America/Ciudad_Juarez -7:5:56 - LMT 1922 Ja 1 7u
+-7 - MST 1927 Jun 10 23
+-6 - CST 1930 N 15
+-7 m M%sT 1932 Ap
+-6 - CST 1996
+-6 m C%sT 1998
+-6 - CST 1998 Ap Su>=1 3
+-7 m M%sT 2010
+-7 u M%sT 2022 O 30 2
+-6 - CST 2022 N 30
+-7 u M%sT
 Z America/Ojinaga -6:57:40 - LMT 1922 Ja 1 7u
 -7 - MST 1927 Jun 10 23
 -6 - CST 1930 N 15
@@ -3141,7 +3150,8 @@ Z America/Ojinaga -6:57:40 - LMT 1922 Ja 1 7u
 -6 - CST 1998 Ap Su>=1 3
 -7 m M%sT 2010
 -7 u M%sT 2022 O 30 2
--6 - CST
+-6 - CST 2022 N 30
+-6 u C%sT
 Z America/Chihuahua -7:4:20 - LMT 1922 Ja 1 7u
 -7 - MST 1927 Jun 10 23
 -6 - CST 1930 N 15
@@ -3771,7 +3781,7 @@ Z Antarctica/Palmer 0 - -00 1965
 -4 x -04/-03 2016 D 4
 -3 - -03
 R CO 1992 o - May 3 0 1 -
-R CO 1993 o - Ap 4 0 0 -
+R CO 1993 o - F 6 24 0 -
 Z America/Bogota -4:56:16 - LMT 1884 Mar 13
 -4:56:16 - BMT 1914 N 23
 -5 CO -05/-04
@@ -4154,6 +4164,7 @@ L America/Tijuana America/Ensenada
 L America/Indiana/Indianapolis America/Fort_Wayne
 L America/Toronto America/Montreal
 L America/Toronto America/Nipigon
+L America/Iqaluit America/Pangnirtung
 L America/Rio_Branco America/Porto_Acre
 L America/Winnipeg America/Rainy_River
 L America/Argentina/Cordoba America/Rosario
diff --git a/lib/tzdata/zoneinfo/zone.tab b/lib/tzdata/zoneinfo/zone.tab
index 2636e21a..6e5adb9f 100644
--- a/lib/tzdata/zoneinfo/zone.tab
+++ b/lib/tzdata/zoneinfo/zone.tab
@@ -114,8 +114,7 @@ CA	+4606-06447	America/Moncton	Atlantic - New Brunswick
 CA	+5320-06025	America/Goose_Bay	Atlantic - Labrador (most areas)
 CA	+5125-05707	America/Blanc-Sablon	AST - QC (Lower North Shore)
 CA	+4339-07923	America/Toronto	Eastern - ON, QC (most areas)
-CA	+6344-06828	America/Iqaluit	Eastern - NU (most east areas)
-CA	+6608-06544	America/Pangnirtung	Eastern - NU (Pangnirtung)
+CA	+6344-06828	America/Iqaluit	Eastern - NU (most areas)
 CA	+484531-0913718	America/Atikokan	EST - ON (Atikokan); NU (Coral H)
 CA	+4953-09709	America/Winnipeg	Central - ON (west); Manitoba
 CA	+744144-0944945	America/Resolute	Central - NU (Resolute)
@@ -277,17 +276,18 @@ MT	+3554+01431	Europe/Malta
 MU	-2010+05730	Indian/Mauritius
 MV	+0410+07330	Indian/Maldives
 MW	-1547+03500	Africa/Blantyre
-MX	+1924-09909	America/Mexico_City	Central Time
-MX	+2105-08646	America/Cancun	Eastern Standard Time - Quintana Roo
-MX	+2058-08937	America/Merida	Central Time - Campeche, Yucatan
-MX	+2540-10019	America/Monterrey	Central Time - Durango; Coahuila, Nuevo Leon, Tamaulipas (most areas)
-MX	+2550-09730	America/Matamoros	Central Time US - Coahuila, Nuevo Leon, Tamaulipas (US border)
-MX	+2313-10625	America/Mazatlan	Mountain Time - Baja California Sur, Nayarit, Sinaloa
-MX	+2838-10605	America/Chihuahua	Mountain Time - Chihuahua (most areas)
-MX	+2934-10425	America/Ojinaga	Mountain Time US - Chihuahua (US border)
-MX	+2904-11058	America/Hermosillo	Mountain Standard Time - Sonora
-MX	+3232-11701	America/Tijuana	Pacific Time US - Baja California
-MX	+2048-10515	America/Bahia_Banderas	Central Time - Bahia de Banderas
+MX	+1924-09909	America/Mexico_City	Central Mexico
+MX	+2105-08646	America/Cancun	Quintana Roo
+MX	+2058-08937	America/Merida	Campeche, Yucatan
+MX	+2540-10019	America/Monterrey	Durango; Coahuila, Nuevo Leon, Tamaulipas (most areas)
+MX	+2550-09730	America/Matamoros	Coahuila, Nuevo Leon, Tamaulipas (US border)
+MX	+2838-10605	America/Chihuahua	Chihuahua (most areas)
+MX	+3144-10629	America/Ciudad_Juarez	Chihuahua (US border - west)
+MX	+2934-10425	America/Ojinaga	Chihuahua (US border - east)
+MX	+2313-10625	America/Mazatlan	Baja California Sur, Nayarit (most areas), Sinaloa
+MX	+2048-10515	America/Bahia_Banderas	Bahia de Banderas
+MX	+2904-11058	America/Hermosillo	Sonora
+MX	+3232-11701	America/Tijuana	Baja California
 MY	+0310+10142	Asia/Kuala_Lumpur	Malaysia (peninsula)
 MY	+0133+11020	Asia/Kuching	Sabah, Sarawak
 MZ	-2558+03235	Africa/Maputo
diff --git a/lib/tzdata/zoneinfo/zone1970.tab b/lib/tzdata/zoneinfo/zone1970.tab
index 75372e3f..a9b36d36 100644
--- a/lib/tzdata/zoneinfo/zone1970.tab
+++ b/lib/tzdata/zoneinfo/zone1970.tab
@@ -102,8 +102,7 @@ CA	+4612-05957	America/Glace_Bay	Atlantic - NS (Cape Breton)
 CA	+4606-06447	America/Moncton	Atlantic - New Brunswick
 CA	+5320-06025	America/Goose_Bay	Atlantic - Labrador (most areas)
 CA,BS	+4339-07923	America/Toronto	Eastern - ON, QC (most areas), Bahamas
-CA	+6344-06828	America/Iqaluit	Eastern - NU (most east areas)
-CA	+6608-06544	America/Pangnirtung	Eastern - NU (Pangnirtung)
+CA	+6344-06828	America/Iqaluit	Eastern - NU (most areas)
 CA	+4953-09709	America/Winnipeg	Central - ON (west); Manitoba
 CA	+744144-0944945	America/Resolute	Central - NU (Resolute)
 CA	+624900-0920459	America/Rankin_Inlet	Central - NU (central)
@@ -214,17 +213,18 @@ MQ	+1436-06105	America/Martinique
 MT	+3554+01431	Europe/Malta
 MU	-2010+05730	Indian/Mauritius
 MV,TF	+0410+07330	Indian/Maldives	Maldives, Kerguelen, St Paul I, Amsterdam I
-MX	+1924-09909	America/Mexico_City	Central Time
-MX	+2105-08646	America/Cancun	Eastern Standard Time - Quintana Roo
-MX	+2058-08937	America/Merida	Central Time - Campeche, Yucatán
-MX	+2540-10019	America/Monterrey	Central Time - Durango; Coahuila, Nuevo León, Tamaulipas (most areas)
-MX	+2550-09730	America/Matamoros	Central Time US - Coahuila, Nuevo León, Tamaulipas (US border)
-MX	+2313-10625	America/Mazatlan	Mountain Time - Baja California Sur, Nayarit, Sinaloa
-MX	+2838-10605	America/Chihuahua	Mountain Time - Chihuahua (most areas)
-MX	+2934-10425	America/Ojinaga	Mountain Time US - Chihuahua (US border)
-MX	+2904-11058	America/Hermosillo	Mountain Standard Time - Sonora
-MX	+3232-11701	America/Tijuana	Pacific Time US - Baja California
-MX	+2048-10515	America/Bahia_Banderas	Central Time - Bahía de Banderas
+MX	+1924-09909	America/Mexico_City	Central Mexico
+MX	+2105-08646	America/Cancun	Quintana Roo
+MX	+2058-08937	America/Merida	Campeche, Yucatán
+MX	+2540-10019	America/Monterrey	Durango; Coahuila, Nuevo León, Tamaulipas (most areas)
+MX	+2550-09730	America/Matamoros	Coahuila, Nuevo León, Tamaulipas (US border)
+MX	+2838-10605	America/Chihuahua	Chihuahua (most areas)
+MX	+3144-10629	America/Ciudad_Juarez	Chihuahua (US border - west)
+MX	+2934-10425	America/Ojinaga	Chihuahua (US border - east)
+MX	+2313-10625	America/Mazatlan	Baja California Sur, Nayarit (most areas), Sinaloa
+MX	+2048-10515	America/Bahia_Banderas	Bahía de Banderas
+MX	+2904-11058	America/Hermosillo	Sonora
+MX	+3232-11701	America/Tijuana	Baja California
 MY,BN	+0133+11020	Asia/Kuching	Sabah, Sarawak, Brunei
 MZ,BI,BW,CD,MW,RW,ZM,ZW	-2558+03235	Africa/Maputo	Central Africa Time
 NA	-2234+01706	Africa/Windhoek
diff --git a/lib/tzdata/zones b/lib/tzdata/zones
index d8ec444a..8d9892ed 100644
--- a/lib/tzdata/zones
+++ b/lib/tzdata/zones
@@ -239,7 +239,6 @@ America/Edmonton
 America/Vancouver
 America/Dawson_Creek
 America/Fort_Nelson
-America/Pangnirtung
 America/Iqaluit
 America/Resolute
 America/Rankin_Inlet
@@ -253,6 +252,7 @@ America/Merida
 America/Matamoros
 America/Monterrey
 America/Mexico_City
+America/Ciudad_Juarez
 America/Ojinaga
 America/Chihuahua
 America/Hermosillo
@@ -554,6 +554,7 @@ America/Ensenada
 America/Fort_Wayne
 America/Montreal
 America/Nipigon
+America/Pangnirtung
 America/Porto_Acre
 America/Rainy_River
 America/Rosario
diff --git a/requirements.txt b/requirements.txt
index 6de9a262..647d8dd7 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -43,7 +43,7 @@ six==1.16.0
 soupsieve==2.3.2.post1
 tempora==5.1.0
 tokenize-rt==5.0.0
-tzdata==2022.6
+tzdata==2022.7
 tzlocal==4.2
 urllib3==1.26.13
 webencodings==0.5.1

From 483245506b8ad8b9eb6d2a858172aa6cbabbc46e Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 21 Dec 2022 16:00:12 -0800
Subject: [PATCH 259/743] Bump importlib-resources from 5.10.0 to 5.10.1
 (#1918)

* Bump importlib-resources from 5.10.0 to 5.10.1

Bumps [importlib-resources](https://github.com/python/importlib_resources) from 5.10.0 to 5.10.1.
- [Release notes](https://github.com/python/importlib_resources/releases)
- [Changelog](https://github.com/python/importlib_resources/blob/main/CHANGES.rst)
- [Commits](https://github.com/python/importlib_resources/compare/v5.10.0...v5.10.1)

---
updated-dependencies:
- dependency-name: importlib-resources
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

* Update importlib-resources==5.10.1

Signed-off-by: dependabot[bot] <support@github.com>
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/importlib_resources/_common.py | 3 ++-
 package/requirements-package.txt   | 2 +-
 requirements.txt                   | 2 +-
 3 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/lib/importlib_resources/_common.py b/lib/importlib_resources/_common.py
index 9f19784d..6a338c61 100644
--- a/lib/importlib_resources/_common.py
+++ b/lib/importlib_resources/_common.py
@@ -203,5 +203,6 @@ def _write_contents(target, source):
         for item in source.iterdir():
             _write_contents(child, item)
     else:
-        child.open('wb').write(source.read_bytes())
+        with child.open('wb') as fp:
+            fp.write(source.read_bytes())
     return child
diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index 7dc0227b..6260d288 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -1,6 +1,6 @@
 apscheduler==3.9.1.post1
 importlib-metadata==5.0.0
-importlib-resources==5.10.0
+importlib-resources==5.10.1
 pyinstaller==5.6.2
 pyopenssl==22.1.0
 pycryptodomex==3.15.0
diff --git a/requirements.txt b/requirements.txt
index 647d8dd7..6e82f4e1 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -19,7 +19,7 @@ html5lib==1.1
 httpagentparser==1.9.5
 idna==3.4
 importlib-metadata==5.0.0
-importlib-resources==5.10.0
+importlib-resources==5.10.1
 git+https://github.com/Tautulli/ipwhois.git@master#egg=ipwhois
 IPy==1.01
 Mako==1.2.4

From dbe0018e2412e1623ba79c018e9842d19a5991a5 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 21 Dec 2022 16:00:56 -0800
Subject: [PATCH 260/743] Bump certifi from 2022.9.24 to 2022.12.7 (#1920)

* Bump certifi from 2022.9.24 to 2022.12.7

Bumps [certifi](https://github.com/certifi/python-certifi) from 2022.9.24 to 2022.12.7.
- [Release notes](https://github.com/certifi/python-certifi/releases)
- [Commits](https://github.com/certifi/python-certifi/compare/2022.09.24...2022.12.07)

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

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

* Update certifi==2022.12.7

Signed-off-by: dependabot[bot] <support@github.com>
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/certifi/__init__.py |   2 +-
 lib/certifi/cacert.pem  | 181 ----------------------------------------
 requirements.txt        |   2 +-
 3 files changed, 2 insertions(+), 183 deletions(-)

diff --git a/lib/certifi/__init__.py b/lib/certifi/__init__.py
index af4bcc15..a3546f12 100644
--- a/lib/certifi/__init__.py
+++ b/lib/certifi/__init__.py
@@ -1,4 +1,4 @@
 from .core import contents, where
 
 __all__ = ["contents", "where"]
-__version__ = "2022.09.24"
+__version__ = "2022.12.07"
diff --git a/lib/certifi/cacert.pem b/lib/certifi/cacert.pem
index 40051551..df9e4e3c 100644
--- a/lib/certifi/cacert.pem
+++ b/lib/certifi/cacert.pem
@@ -636,37 +636,6 @@ BA6+C4OmF4O5MBKgxTMVBbkN+8cFduPYSo38NBejxiEovjBFMR7HeL5YYTisO+IB
 ZQ==
 -----END CERTIFICATE-----
 
-# Issuer: CN=Network Solutions Certificate Authority O=Network Solutions L.L.C.
-# Subject: CN=Network Solutions Certificate Authority O=Network Solutions L.L.C.
-# Label: "Network Solutions Certificate Authority"
-# Serial: 116697915152937497490437556386812487904
-# MD5 Fingerprint: d3:f3:a6:16:c0:fa:6b:1d:59:b1:2d:96:4d:0e:11:2e
-# SHA1 Fingerprint: 74:f8:a3:c3:ef:e7:b3:90:06:4b:83:90:3c:21:64:60:20:e5:df:ce
-# SHA256 Fingerprint: 15:f0:ba:00:a3:ac:7a:f3:ac:88:4c:07:2b:10:11:a0:77:bd:77:c0:97:f4:01:64:b2:f8:59:8a:bd:83:86:0c
------BEGIN CERTIFICATE-----
-MIID5jCCAs6gAwIBAgIQV8szb8JcFuZHFhfjkDFo4DANBgkqhkiG9w0BAQUFADBi
-MQswCQYDVQQGEwJVUzEhMB8GA1UEChMYTmV0d29yayBTb2x1dGlvbnMgTC5MLkMu
-MTAwLgYDVQQDEydOZXR3b3JrIFNvbHV0aW9ucyBDZXJ0aWZpY2F0ZSBBdXRob3Jp
-dHkwHhcNMDYxMjAxMDAwMDAwWhcNMjkxMjMxMjM1OTU5WjBiMQswCQYDVQQGEwJV
-UzEhMB8GA1UEChMYTmV0d29yayBTb2x1dGlvbnMgTC5MLkMuMTAwLgYDVQQDEydO
-ZXR3b3JrIFNvbHV0aW9ucyBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkwggEiMA0GCSqG
-SIb3DQEBAQUAA4IBDwAwggEKAoIBAQDkvH6SMG3G2I4rC7xGzuAnlt7e+foS0zwz
-c7MEL7xxjOWftiJgPl9dzgn/ggwbmlFQGiaJ3dVhXRncEg8tCqJDXRfQNJIg6nPP
-OCwGJgl6cvf6UDL4wpPTaaIjzkGxzOTVHzbRijr4jGPiFFlp7Q3Tf2vouAPlT2rl
-mGNpSAW+Lv8ztumXWWn4Zxmuk2GWRBXTcrA/vGp97Eh/jcOrqnErU2lBUzS1sLnF
-BgrEsEX1QV1uiUV7PTsmjHTC5dLRfbIR1PtYMiKagMnc/Qzpf14Dl847ABSHJ3A4
-qY5usyd2mFHgBeMhqxrVhSI8KbWaFsWAqPS7azCPL0YCorEMIuDTAgMBAAGjgZcw
-gZQwHQYDVR0OBBYEFCEwyfsA106Y2oeqKtCnLrFAMadMMA4GA1UdDwEB/wQEAwIB
-BjAPBgNVHRMBAf8EBTADAQH/MFIGA1UdHwRLMEkwR6BFoEOGQWh0dHA6Ly9jcmwu
-bmV0c29sc3NsLmNvbS9OZXR3b3JrU29sdXRpb25zQ2VydGlmaWNhdGVBdXRob3Jp
-dHkuY3JsMA0GCSqGSIb3DQEBBQUAA4IBAQC7rkvnt1frf6ott3NHhWrB5KUd5Oc8
-6fRZZXe1eltajSU24HqXLjjAV2CDmAaDn7l2em5Q4LqILPxFzBiwmZVRDuwduIj/
-h1AcgsLj4DKAv6ALR8jDMe+ZZzKATxcheQxpXN5eNK4CtSbqUN9/GGUsyfJj4akH
-/nxxH2szJGoeBfcFaMBqEssuXmHLrijTfsK0ZpEmXzwuJF/LWA/rKOyvEZbz3Htv
-wKeI8lN3s2Berq4o2jUsbzRF0ybh3uxbTydrFny9RAQYgrOJeRcQcT16ohZO9QHN
-pGxlaKFJdlxDydi8NmdspZS11My5vWo1ViHe2MPr+8ukYEywVaCge1ey
------END CERTIFICATE-----
-
 # Issuer: CN=COMODO ECC Certification Authority O=COMODO CA Limited
 # Subject: CN=COMODO ECC Certification Authority O=COMODO CA Limited
 # Label: "COMODO ECC Certification Authority"
@@ -2204,46 +2173,6 @@ KoZIzj0EAwMDaAAwZQIxAOVpEslu28YxuglB4Zf4+/2a4n0Sye18ZNPLBSWLVtmg
 xwy8p2Fp8fc74SrL+SvzZpA3
 -----END CERTIFICATE-----
 
-# Issuer: CN=Staat der Nederlanden EV Root CA O=Staat der Nederlanden
-# Subject: CN=Staat der Nederlanden EV Root CA O=Staat der Nederlanden
-# Label: "Staat der Nederlanden EV Root CA"
-# Serial: 10000013
-# MD5 Fingerprint: fc:06:af:7b:e8:1a:f1:9a:b4:e8:d2:70:1f:c0:f5:ba
-# SHA1 Fingerprint: 76:e2:7e:c1:4f:db:82:c1:c0:a6:75:b5:05:be:3d:29:b4:ed:db:bb
-# SHA256 Fingerprint: 4d:24:91:41:4c:fe:95:67:46:ec:4c:ef:a6:cf:6f:72:e2:8a:13:29:43:2f:9d:8a:90:7a:c4:cb:5d:ad:c1:5a
------BEGIN CERTIFICATE-----
-MIIFcDCCA1igAwIBAgIEAJiWjTANBgkqhkiG9w0BAQsFADBYMQswCQYDVQQGEwJO
-TDEeMBwGA1UECgwVU3RhYXQgZGVyIE5lZGVybGFuZGVuMSkwJwYDVQQDDCBTdGFh
-dCBkZXIgTmVkZXJsYW5kZW4gRVYgUm9vdCBDQTAeFw0xMDEyMDgxMTE5MjlaFw0y
-MjEyMDgxMTEwMjhaMFgxCzAJBgNVBAYTAk5MMR4wHAYDVQQKDBVTdGFhdCBkZXIg
-TmVkZXJsYW5kZW4xKTAnBgNVBAMMIFN0YWF0IGRlciBOZWRlcmxhbmRlbiBFViBS
-b290IENBMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA48d+ifkkSzrS
-M4M1LGns3Amk41GoJSt5uAg94JG6hIXGhaTK5skuU6TJJB79VWZxXSzFYGgEt9nC
-UiY4iKTWO0Cmws0/zZiTs1QUWJZV1VD+hq2kY39ch/aO5ieSZxeSAgMs3NZmdO3d
-Z//BYY1jTw+bbRcwJu+r0h8QoPnFfxZpgQNH7R5ojXKhTbImxrpsX23Wr9GxE46p
-rfNeaXUmGD5BKyF/7otdBwadQ8QpCiv8Kj6GyzyDOvnJDdrFmeK8eEEzduG/L13l
-pJhQDBXd4Pqcfzho0LKmeqfRMb1+ilgnQ7O6M5HTp5gVXJrm0w912fxBmJc+qiXb
-j5IusHsMX/FjqTf5m3VpTCgmJdrV8hJwRVXj33NeN/UhbJCONVrJ0yPr08C+eKxC
-KFhmpUZtcALXEPlLVPxdhkqHz3/KRawRWrUgUY0viEeXOcDPusBCAUCZSCELa6fS
-/ZbV0b5GnUngC6agIk440ME8MLxwjyx1zNDFjFE7PZQIZCZhfbnDZY8UnCHQqv0X
-cgOPvZuM5l5Tnrmd74K74bzickFbIZTTRTeU0d8JOV3nI6qaHcptqAqGhYqCvkIH
-1vI4gnPah1vlPNOePqc7nvQDs/nxfRN0Av+7oeX6AHkcpmZBiFxgV6YuCcS6/ZrP
-px9Aw7vMWgpVSzs4dlG4Y4uElBbmVvMCAwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB
-/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYEFP6rAJCYniT8qcwaivsnuL8wbqg7
-MA0GCSqGSIb3DQEBCwUAA4ICAQDPdyxuVr5Os7aEAJSrR8kN0nbHhp8dB9O2tLsI
-eK9p0gtJ3jPFrK3CiAJ9Brc1AsFgyb/E6JTe1NOpEyVa/m6irn0F3H3zbPB+po3u
-2dfOWBfoqSmuc0iH55vKbimhZF8ZE/euBhD/UcabTVUlT5OZEAFTdfETzsemQUHS
-v4ilf0X8rLiltTMMgsT7B/Zq5SWEXwbKwYY5EdtYzXc7LMJMD16a4/CrPmEbUCTC
-wPTxGfARKbalGAKb12NMcIxHowNDXLldRqANb/9Zjr7dn3LDWyvfjFvO5QxGbJKy
-CqNMVEIYFRIYvdr8unRu/8G2oGTYqV9Vrp9canaW2HNnh/tNf1zuacpzEPuKqf2e
-vTY4SUmH9A4U8OmHuD+nT3pajnnUk+S7aFKErGzp85hwVXIy+TSrK0m1zSBi5Dp6
-Z2Orltxtrpfs/J92VoguZs9btsmksNcFuuEnL5O7Jiqik7Ab846+HUCjuTaPPoIa
-Gl6I6lD4WeKDRikL40Rc4ZW2aZCaFG+XroHPaO+Zmr615+F/+PoTRxZMzG0IQOeL
-eG9QgkRQP2YGiqtDhFZKDyAthg710tvSeopLzaXoTvFeJiUBWSOgftL2fiFX1ye8
-FVdMpEbB4IMeDExNH08GGeL5qPQ6gqGyeUN51q1veieQA6TqJIc/2b3Z6fJfUEkc
-7uzXLg==
------END CERTIFICATE-----
-
 # Issuer: CN=IdenTrust Commercial Root CA 1 O=IdenTrust
 # Subject: CN=IdenTrust Commercial Root CA 1 O=IdenTrust
 # Label: "IdenTrust Commercial Root CA 1"
@@ -2851,116 +2780,6 @@ T8p+ck0LcIymSLumoRT2+1hEmRSuqguTaaApJUqlyyvdimYHFngVV3Eb7PVHhPOe
 MTd61X8kreS8/f3MboPoDKi3QWwH3b08hpcv0g==
 -----END CERTIFICATE-----
 
-# Issuer: CN=TrustCor RootCert CA-1 O=TrustCor Systems S. de R.L. OU=TrustCor Certificate Authority
-# Subject: CN=TrustCor RootCert CA-1 O=TrustCor Systems S. de R.L. OU=TrustCor Certificate Authority
-# Label: "TrustCor RootCert CA-1"
-# Serial: 15752444095811006489
-# MD5 Fingerprint: 6e:85:f1:dc:1a:00:d3:22:d5:b2:b2:ac:6b:37:05:45
-# SHA1 Fingerprint: ff:bd:cd:e7:82:c8:43:5e:3c:6f:26:86:5c:ca:a8:3a:45:5b:c3:0a
-# SHA256 Fingerprint: d4:0e:9c:86:cd:8f:e4:68:c1:77:69:59:f4:9e:a7:74:fa:54:86:84:b6:c4:06:f3:90:92:61:f4:dc:e2:57:5c
------BEGIN CERTIFICATE-----
-MIIEMDCCAxigAwIBAgIJANqb7HHzA7AZMA0GCSqGSIb3DQEBCwUAMIGkMQswCQYD
-VQQGEwJQQTEPMA0GA1UECAwGUGFuYW1hMRQwEgYDVQQHDAtQYW5hbWEgQ2l0eTEk
-MCIGA1UECgwbVHJ1c3RDb3IgU3lzdGVtcyBTLiBkZSBSLkwuMScwJQYDVQQLDB5U
-cnVzdENvciBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkxHzAdBgNVBAMMFlRydXN0Q29y
-IFJvb3RDZXJ0IENBLTEwHhcNMTYwMjA0MTIzMjE2WhcNMjkxMjMxMTcyMzE2WjCB
-pDELMAkGA1UEBhMCUEExDzANBgNVBAgMBlBhbmFtYTEUMBIGA1UEBwwLUGFuYW1h
-IENpdHkxJDAiBgNVBAoMG1RydXN0Q29yIFN5c3RlbXMgUy4gZGUgUi5MLjEnMCUG
-A1UECwweVHJ1c3RDb3IgQ2VydGlmaWNhdGUgQXV0aG9yaXR5MR8wHQYDVQQDDBZU
-cnVzdENvciBSb290Q2VydCBDQS0xMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIB
-CgKCAQEAv463leLCJhJrMxnHQFgKq1mqjQCj/IDHUHuO1CAmujIS2CNUSSUQIpid
-RtLByZ5OGy4sDjjzGiVoHKZaBeYei0i/mJZ0PmnK6bV4pQa81QBeCQryJ3pS/C3V
-seq0iWEk8xoT26nPUu0MJLq5nux+AHT6k61sKZKuUbS701e/s/OojZz0JEsq1pme
-9J7+wH5COucLlVPat2gOkEz7cD+PSiyU8ybdY2mplNgQTsVHCJCZGxdNuWxu72CV
-EY4hgLW9oHPY0LJ3xEXqWib7ZnZ2+AYfYW0PVcWDtxBWcgYHpfOxGgMFZA6dWorW
-hnAbJN7+KIor0Gqw/Hqi3LJ5DotlDwIDAQABo2MwYTAdBgNVHQ4EFgQU7mtJPHo/
-DeOxCbeKyKsZn3MzUOcwHwYDVR0jBBgwFoAU7mtJPHo/DeOxCbeKyKsZn3MzUOcw
-DwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAYYwDQYJKoZIhvcNAQELBQAD
-ggEBACUY1JGPE+6PHh0RU9otRCkZoB5rMZ5NDp6tPVxBb5UrJKF5mDo4Nvu7Zp5I
-/5CQ7z3UuJu0h3U/IJvOcs+hVcFNZKIZBqEHMwwLKeXx6quj7LUKdJDHfXLy11yf
-ke+Ri7fc7Waiz45mO7yfOgLgJ90WmMCV1Aqk5IGadZQ1nJBfiDcGrVmVCrDRZ9MZ
-yonnMlo2HD6CqFqTvsbQZJG2z9m2GM/bftJlo6bEjhcxwft+dtvTheNYsnd6djts
-L1Ac59v2Z3kf9YKVmgenFK+P3CghZwnS1k1aHBkcjndcw5QkPTJrS37UeJSDvjdN
-zl/HHk484IkzlQsPpTLWPFp5LBk=
------END CERTIFICATE-----
-
-# Issuer: CN=TrustCor RootCert CA-2 O=TrustCor Systems S. de R.L. OU=TrustCor Certificate Authority
-# Subject: CN=TrustCor RootCert CA-2 O=TrustCor Systems S. de R.L. OU=TrustCor Certificate Authority
-# Label: "TrustCor RootCert CA-2"
-# Serial: 2711694510199101698
-# MD5 Fingerprint: a2:e1:f8:18:0b:ba:45:d5:c7:41:2a:bb:37:52:45:64
-# SHA1 Fingerprint: b8:be:6d:cb:56:f1:55:b9:63:d4:12:ca:4e:06:34:c7:94:b2:1c:c0
-# SHA256 Fingerprint: 07:53:e9:40:37:8c:1b:d5:e3:83:6e:39:5d:ae:a5:cb:83:9e:50:46:f1:bd:0e:ae:19:51:cf:10:fe:c7:c9:65
------BEGIN CERTIFICATE-----
-MIIGLzCCBBegAwIBAgIIJaHfyjPLWQIwDQYJKoZIhvcNAQELBQAwgaQxCzAJBgNV
-BAYTAlBBMQ8wDQYDVQQIDAZQYW5hbWExFDASBgNVBAcMC1BhbmFtYSBDaXR5MSQw
-IgYDVQQKDBtUcnVzdENvciBTeXN0ZW1zIFMuIGRlIFIuTC4xJzAlBgNVBAsMHlRy
-dXN0Q29yIENlcnRpZmljYXRlIEF1dGhvcml0eTEfMB0GA1UEAwwWVHJ1c3RDb3Ig
-Um9vdENlcnQgQ0EtMjAeFw0xNjAyMDQxMjMyMjNaFw0zNDEyMzExNzI2MzlaMIGk
-MQswCQYDVQQGEwJQQTEPMA0GA1UECAwGUGFuYW1hMRQwEgYDVQQHDAtQYW5hbWEg
-Q2l0eTEkMCIGA1UECgwbVHJ1c3RDb3IgU3lzdGVtcyBTLiBkZSBSLkwuMScwJQYD
-VQQLDB5UcnVzdENvciBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkxHzAdBgNVBAMMFlRy
-dXN0Q29yIFJvb3RDZXJ0IENBLTIwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIK
-AoICAQCnIG7CKqJiJJWQdsg4foDSq8GbZQWU9MEKENUCrO2fk8eHyLAnK0IMPQo+
-QVqedd2NyuCb7GgypGmSaIwLgQ5WoD4a3SwlFIIvl9NkRvRUqdw6VC0xK5mC8tkq
-1+9xALgxpL56JAfDQiDyitSSBBtlVkxs1Pu2YVpHI7TYabS3OtB0PAx1oYxOdqHp
-2yqlO/rOsP9+aij9JxzIsekp8VduZLTQwRVtDr4uDkbIXvRR/u8OYzo7cbrPb1nK
-DOObXUm4TOJXsZiKQlecdu/vvdFoqNL0Cbt3Nb4lggjEFixEIFapRBF37120Hape
-az6LMvYHL1cEksr1/p3C6eizjkxLAjHZ5DxIgif3GIJ2SDpxsROhOdUuxTTCHWKF
-3wP+TfSvPd9cW436cOGlfifHhi5qjxLGhF5DUVCcGZt45vz27Ud+ez1m7xMTiF88
-oWP7+ayHNZ/zgp6kPwqcMWmLmaSISo5uZk3vFsQPeSghYA2FFn3XVDjxklb9tTNM
-g9zXEJ9L/cb4Qr26fHMC4P99zVvh1Kxhe1fVSntb1IVYJ12/+CtgrKAmrhQhJ8Z3
-mjOAPF5GP/fDsaOGM8boXg25NSyqRsGFAnWAoOsk+xWq5Gd/bnc/9ASKL3x74xdh
-8N0JqSDIvgmk0H5Ew7IwSjiqqewYmgeCK9u4nBit2uBGF6zPXQIDAQABo2MwYTAd
-BgNVHQ4EFgQU2f4hQG6UnrybPZx9mCAZ5YwwYrIwHwYDVR0jBBgwFoAU2f4hQG6U
-nrybPZx9mCAZ5YwwYrIwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAYYw
-DQYJKoZIhvcNAQELBQADggIBAJ5Fngw7tu/hOsh80QA9z+LqBrWyOrsGS2h60COX
-dKcs8AjYeVrXWoSK2BKaG9l9XE1wxaX5q+WjiYndAfrs3fnpkpfbsEZC89NiqpX+
-MWcUaViQCqoL7jcjx1BRtPV+nuN79+TMQjItSQzL/0kMmx40/W5ulop5A7Zv2wnL
-/V9lFDfhOPXzYRZY5LVtDQsEGz9QLX+zx3oaFoBg+Iof6Rsqxvm6ARppv9JYx1RX
-CI/hOWB3S6xZhBqI8d3LT3jX5+EzLfzuQfogsL7L9ziUwOHQhQ+77Sxzq+3+knYa
-ZH9bDTMJBzN7Bj8RpFxwPIXAz+OQqIN3+tvmxYxoZxBnpVIt8MSZj3+/0WvitUfW
-2dCFmU2Umw9Lje4AWkcdEQOsQRivh7dvDDqPys/cA8GiCcjl/YBeyGBCARsaU1q7
-N6a3vLqE6R5sGtRk2tRD/pOLS/IseRYQ1JMLiI+h2IYURpFHmygk71dSTlxCnKr3
-Sewn6EAes6aJInKc9Q0ztFijMDvd1GpUk74aTfOTlPf8hAs/hCBcNANExdqtvArB
-As8e5ZTZ845b2EzwnexhF7sUMlQMAimTHpKG9n/v55IFDlndmQguLvqcAFLTxWYp
-5KeXRKQOKIETNcX2b2TmQcTVL8w0RSXPQQCWPUouwpaYT05KnJe32x+SMsj/D1Fu
-1uwJ
------END CERTIFICATE-----
-
-# Issuer: CN=TrustCor ECA-1 O=TrustCor Systems S. de R.L. OU=TrustCor Certificate Authority
-# Subject: CN=TrustCor ECA-1 O=TrustCor Systems S. de R.L. OU=TrustCor Certificate Authority
-# Label: "TrustCor ECA-1"
-# Serial: 9548242946988625984
-# MD5 Fingerprint: 27:92:23:1d:0a:f5:40:7c:e9:e6:6b:9d:d8:f5:e7:6c
-# SHA1 Fingerprint: 58:d1:df:95:95:67:6b:63:c0:f0:5b:1c:17:4d:8b:84:0b:c8:78:bd
-# SHA256 Fingerprint: 5a:88:5d:b1:9c:01:d9:12:c5:75:93:88:93:8c:af:bb:df:03:1a:b2:d4:8e:91:ee:15:58:9b:42:97:1d:03:9c
------BEGIN CERTIFICATE-----
-MIIEIDCCAwigAwIBAgIJAISCLF8cYtBAMA0GCSqGSIb3DQEBCwUAMIGcMQswCQYD
-VQQGEwJQQTEPMA0GA1UECAwGUGFuYW1hMRQwEgYDVQQHDAtQYW5hbWEgQ2l0eTEk
-MCIGA1UECgwbVHJ1c3RDb3IgU3lzdGVtcyBTLiBkZSBSLkwuMScwJQYDVQQLDB5U
-cnVzdENvciBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkxFzAVBgNVBAMMDlRydXN0Q29y
-IEVDQS0xMB4XDTE2MDIwNDEyMzIzM1oXDTI5MTIzMTE3MjgwN1owgZwxCzAJBgNV
-BAYTAlBBMQ8wDQYDVQQIDAZQYW5hbWExFDASBgNVBAcMC1BhbmFtYSBDaXR5MSQw
-IgYDVQQKDBtUcnVzdENvciBTeXN0ZW1zIFMuIGRlIFIuTC4xJzAlBgNVBAsMHlRy
-dXN0Q29yIENlcnRpZmljYXRlIEF1dGhvcml0eTEXMBUGA1UEAwwOVHJ1c3RDb3Ig
-RUNBLTEwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDPj+ARtZ+odnbb
-3w9U73NjKYKtR8aja+3+XzP4Q1HpGjORMRegdMTUpwHmspI+ap3tDvl0mEDTPwOA
-BoJA6LHip1GnHYMma6ve+heRK9jGrB6xnhkB1Zem6g23xFUfJ3zSCNV2HykVh0A5
-3ThFEXXQmqc04L/NyFIduUd+Dbi7xgz2c1cWWn5DkR9VOsZtRASqnKmcp0yJF4Ou
-owReUoCLHhIlERnXDH19MURB6tuvsBzvgdAsxZohmz3tQjtQJvLsznFhBmIhVE5/
-wZ0+fyCMgMsq2JdiyIMzkX2woloPV+g7zPIlstR8L+xNxqE6FXrntl019fZISjZF
-ZtS6mFjBAgMBAAGjYzBhMB0GA1UdDgQWBBREnkj1zG1I1KBLf/5ZJC+Dl5mahjAf
-BgNVHSMEGDAWgBREnkj1zG1I1KBLf/5ZJC+Dl5mahjAPBgNVHRMBAf8EBTADAQH/
-MA4GA1UdDwEB/wQEAwIBhjANBgkqhkiG9w0BAQsFAAOCAQEABT41XBVwm8nHc2Fv
-civUwo/yQ10CzsSUuZQRg2dd4mdsdXa/uwyqNsatR5Nj3B5+1t4u/ukZMjgDfxT2
-AHMsWbEhBuH7rBiVDKP/mZb3Kyeb1STMHd3BOuCYRLDE5D53sXOpZCz2HAF8P11F
-hcCF5yWPldwX8zyfGm6wyuMdKulMY/okYWLW2n62HGz1Ah3UKt1VkOsqEUc8Ll50
-soIipX1TH0XsJ5F95yIW6MBoNtjG8U+ARDL54dHRHareqKucBK+tIA5kmE2la8BI
-WJZpTdwHjFGTot+fDz2LYLSCjaoITmJF4PkL0uDgPFveXHEnJcLmA4GLEFPjx1Wi
-tJ/X5g==
------END CERTIFICATE-----
-
 # Issuer: CN=SSL.com Root Certification Authority RSA O=SSL Corporation
 # Subject: CN=SSL.com Root Certification Authority RSA O=SSL Corporation
 # Label: "SSL.com Root Certification Authority RSA"
diff --git a/requirements.txt b/requirements.txt
index 6e82f4e1..e31185a6 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -6,7 +6,7 @@ backports.functools-lru-cache==1.6.4
 backports.zoneinfo==0.2.1
 beautifulsoup4==4.11.1
 bleach==5.0.1
-certifi==2022.9.24
+certifi==2022.12.7
 cheroot==9.0.0
 cherrypy==18.8.0
 cloudinary==1.30.0

From 56780677fbe3e472400c39eb4b1535e5df7016c6 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 21 Dec 2022 16:01:24 -0800
Subject: [PATCH 261/743] Bump packaging from 21.3 to 22.0 (#1922)

* Bump packaging from 21.3 to 22.0

Bumps [packaging](https://github.com/pypa/packaging) from 21.3 to 22.0.
- [Release notes](https://github.com/pypa/packaging/releases)
- [Changelog](https://github.com/pypa/packaging/blob/main/CHANGELOG.rst)
- [Commits](https://github.com/pypa/packaging/compare/21.3...22.0)

---
updated-dependencies:
- dependency-name: packaging
  dependency-type: direct:production
  update-type: version-update:semver-major
...

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

* Update packaging==22.0

Signed-off-by: dependabot[bot] <support@github.com>
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/packaging/__about__.py    |   2 +-
 lib/packaging/_elffile.py     | 108 ++++
 lib/packaging/_manylinux.py   | 145 ++----
 lib/packaging/_musllinux.py   |  72 +--
 lib/packaging/_parser.py      | 333 ++++++++++++
 lib/packaging/_tokenizer.py   | 186 +++++++
 lib/packaging/markers.py      | 197 +++-----
 lib/packaging/requirements.py | 121 ++---
 lib/packaging/specifiers.py   | 918 ++++++++++++++++++++--------------
 lib/packaging/tags.py         |  26 +-
 lib/packaging/utils.py        |  11 +-
 lib/packaging/version.py      | 333 +++++++-----
 requirements.txt              |   2 +-
 13 files changed, 1562 insertions(+), 892 deletions(-)
 create mode 100644 lib/packaging/_elffile.py
 create mode 100644 lib/packaging/_parser.py
 create mode 100644 lib/packaging/_tokenizer.py

diff --git a/lib/packaging/__about__.py b/lib/packaging/__about__.py
index 3551bc2d..1391863f 100644
--- a/lib/packaging/__about__.py
+++ b/lib/packaging/__about__.py
@@ -17,7 +17,7 @@ __title__ = "packaging"
 __summary__ = "Core utilities for Python packages"
 __uri__ = "https://github.com/pypa/packaging"
 
-__version__ = "21.3"
+__version__ = "22.0"
 
 __author__ = "Donald Stufft and individual contributors"
 __email__ = "donald@stufft.io"
diff --git a/lib/packaging/_elffile.py b/lib/packaging/_elffile.py
new file mode 100644
index 00000000..9fb5984b
--- /dev/null
+++ b/lib/packaging/_elffile.py
@@ -0,0 +1,108 @@
+"""
+ELF file parser.
+
+This provides a class ``ELFFile`` that parses an ELF executable in a similar
+interface to ``ZipFile``. Only the read interface is implemented.
+
+Based on: https://gist.github.com/lyssdod/f51579ae8d93c8657a5564aefc2ffbca
+ELF header: https://refspecs.linuxfoundation.org/elf/gabi4+/ch4.eheader.html
+"""
+
+import enum
+import os
+import struct
+from typing import IO, Optional, Tuple
+
+
+class ELFInvalid(ValueError):
+    pass
+
+
+class EIClass(enum.IntEnum):
+    C32 = 1
+    C64 = 2
+
+
+class EIData(enum.IntEnum):
+    Lsb = 1
+    Msb = 2
+
+
+class EMachine(enum.IntEnum):
+    I386 = 3
+    S390 = 22
+    Arm = 40
+    X8664 = 62
+    AArc64 = 183
+
+
+class ELFFile:
+    """
+    Representation of an ELF executable.
+    """
+
+    def __init__(self, f: IO[bytes]) -> None:
+        self._f = f
+
+        try:
+            ident = self._read("16B")
+        except struct.error:
+            raise ELFInvalid("unable to parse identification")
+        magic = bytes(ident[:4])
+        if magic != b"\x7fELF":
+            raise ELFInvalid(f"invalid magic: {magic!r}")
+
+        self.capacity = ident[4]  # Format for program header (bitness).
+        self.encoding = ident[5]  # Data structure encoding (endianess).
+
+        try:
+            # e_fmt: Format for program header.
+            # p_fmt: Format for section header.
+            # p_idx: Indexes to find p_type, p_offset, and p_filesz.
+            e_fmt, self._p_fmt, self._p_idx = {
+                (1, 1): ("<HHIIIIIHHH", "<IIIIIIII", (0, 1, 4)),  # 32-bit LSB.
+                (1, 2): (">HHIIIIIHHH", ">IIIIIIII", (0, 1, 4)),  # 32-bit MSB.
+                (2, 1): ("<HHIQQQIHHH", "<IIQQQQQQ", (0, 2, 5)),  # 64-bit LSB.
+                (2, 2): (">HHIQQQIHHH", ">IIQQQQQQ", (0, 2, 5)),  # 64-bit MSB.
+            }[(self.capacity, self.encoding)]
+        except KeyError:
+            raise ELFInvalid(
+                f"unrecognized capacity ({self.capacity}) or "
+                f"encoding ({self.encoding})"
+            )
+
+        try:
+            (
+                _,
+                self.machine,  # Architecture type.
+                _,
+                _,
+                self._e_phoff,  # Offset of program header.
+                _,
+                self.flags,  # Processor-specific flags.
+                _,
+                self._e_phentsize,  # Size of section.
+                self._e_phnum,  # Number of sections.
+            ) = self._read(e_fmt)
+        except struct.error as e:
+            raise ELFInvalid("unable to parse machine and section information") from e
+
+    def _read(self, fmt: str) -> Tuple[int, ...]:
+        return struct.unpack(fmt, self._f.read(struct.calcsize(fmt)))
+
+    @property
+    def interpreter(self) -> Optional[str]:
+        """
+        The path recorded in the ``PT_INTERP`` section header.
+        """
+        for index in range(self._e_phnum):
+            self._f.seek(self._e_phoff + self._e_phentsize * index)
+            try:
+                data = self._read(self._p_fmt)
+            except struct.error:
+                continue
+            if data[self._p_idx[0]] != 3:  # Not PT_INTERP.
+                continue
+            self._f.seek(data[self._p_idx[1]])
+            return os.fsdecode(self._f.read(data[self._p_idx[2]])).strip("\0")
+        return None
diff --git a/lib/packaging/_manylinux.py b/lib/packaging/_manylinux.py
index 4c379aa6..2f0cc743 100644
--- a/lib/packaging/_manylinux.py
+++ b/lib/packaging/_manylinux.py
@@ -1,121 +1,58 @@
 import collections
+import contextlib
 import functools
 import os
 import re
-import struct
 import sys
 import warnings
-from typing import IO, Dict, Iterator, NamedTuple, Optional, Tuple
+from typing import Dict, Generator, Iterator, NamedTuple, Optional, Tuple
+
+from ._elffile import EIClass, EIData, ELFFile, EMachine
+
+EF_ARM_ABIMASK = 0xFF000000
+EF_ARM_ABI_VER5 = 0x05000000
+EF_ARM_ABI_FLOAT_HARD = 0x00000400
 
 
-# Python does not provide platform information at sufficient granularity to
-# identify the architecture of the running executable in some cases, so we
-# determine it dynamically by reading the information from the running
-# process. This only applies on Linux, which uses the ELF format.
-class _ELFFileHeader:
-    # https://en.wikipedia.org/wiki/Executable_and_Linkable_Format#File_header
-    class _InvalidELFFileHeader(ValueError):
-        """
-        An invalid ELF file header was found.
-        """
-
-    ELF_MAGIC_NUMBER = 0x7F454C46
-    ELFCLASS32 = 1
-    ELFCLASS64 = 2
-    ELFDATA2LSB = 1
-    ELFDATA2MSB = 2
-    EM_386 = 3
-    EM_S390 = 22
-    EM_ARM = 40
-    EM_X86_64 = 62
-    EF_ARM_ABIMASK = 0xFF000000
-    EF_ARM_ABI_VER5 = 0x05000000
-    EF_ARM_ABI_FLOAT_HARD = 0x00000400
-
-    def __init__(self, file: IO[bytes]) -> None:
-        def unpack(fmt: str) -> int:
-            try:
-                data = file.read(struct.calcsize(fmt))
-                result: Tuple[int, ...] = struct.unpack(fmt, data)
-            except struct.error:
-                raise _ELFFileHeader._InvalidELFFileHeader()
-            return result[0]
-
-        self.e_ident_magic = unpack(">I")
-        if self.e_ident_magic != self.ELF_MAGIC_NUMBER:
-            raise _ELFFileHeader._InvalidELFFileHeader()
-        self.e_ident_class = unpack("B")
-        if self.e_ident_class not in {self.ELFCLASS32, self.ELFCLASS64}:
-            raise _ELFFileHeader._InvalidELFFileHeader()
-        self.e_ident_data = unpack("B")
-        if self.e_ident_data not in {self.ELFDATA2LSB, self.ELFDATA2MSB}:
-            raise _ELFFileHeader._InvalidELFFileHeader()
-        self.e_ident_version = unpack("B")
-        self.e_ident_osabi = unpack("B")
-        self.e_ident_abiversion = unpack("B")
-        self.e_ident_pad = file.read(7)
-        format_h = "<H" if self.e_ident_data == self.ELFDATA2LSB else ">H"
-        format_i = "<I" if self.e_ident_data == self.ELFDATA2LSB else ">I"
-        format_q = "<Q" if self.e_ident_data == self.ELFDATA2LSB else ">Q"
-        format_p = format_i if self.e_ident_class == self.ELFCLASS32 else format_q
-        self.e_type = unpack(format_h)
-        self.e_machine = unpack(format_h)
-        self.e_version = unpack(format_i)
-        self.e_entry = unpack(format_p)
-        self.e_phoff = unpack(format_p)
-        self.e_shoff = unpack(format_p)
-        self.e_flags = unpack(format_i)
-        self.e_ehsize = unpack(format_h)
-        self.e_phentsize = unpack(format_h)
-        self.e_phnum = unpack(format_h)
-        self.e_shentsize = unpack(format_h)
-        self.e_shnum = unpack(format_h)
-        self.e_shstrndx = unpack(format_h)
-
-
-def _get_elf_header() -> Optional[_ELFFileHeader]:
+@contextlib.contextmanager
+def _parse_elf(path: str) -> Generator[Optional[ELFFile], None, None]:
     try:
-        with open(sys.executable, "rb") as f:
-            elf_header = _ELFFileHeader(f)
-    except (OSError, TypeError, _ELFFileHeader._InvalidELFFileHeader):
-        return None
-    return elf_header
+        with open(path, "rb") as f:
+            yield ELFFile(f)
+    except (OSError, TypeError, ValueError):
+        yield None
 
 
-def _is_linux_armhf() -> bool:
+def _is_linux_armhf(executable: str) -> bool:
     # hard-float ABI can be detected from the ELF header of the running
     # process
     # https://static.docs.arm.com/ihi0044/g/aaelf32.pdf
-    elf_header = _get_elf_header()
-    if elf_header is None:
-        return False
-    result = elf_header.e_ident_class == elf_header.ELFCLASS32
-    result &= elf_header.e_ident_data == elf_header.ELFDATA2LSB
-    result &= elf_header.e_machine == elf_header.EM_ARM
-    result &= (
-        elf_header.e_flags & elf_header.EF_ARM_ABIMASK
-    ) == elf_header.EF_ARM_ABI_VER5
-    result &= (
-        elf_header.e_flags & elf_header.EF_ARM_ABI_FLOAT_HARD
-    ) == elf_header.EF_ARM_ABI_FLOAT_HARD
-    return result
+    with _parse_elf(executable) as f:
+        return (
+            f is not None
+            and f.capacity == EIClass.C32
+            and f.encoding == EIData.Lsb
+            and f.machine == EMachine.Arm
+            and f.flags & EF_ARM_ABIMASK == EF_ARM_ABI_VER5
+            and f.flags & EF_ARM_ABI_FLOAT_HARD == EF_ARM_ABI_FLOAT_HARD
+        )
 
 
-def _is_linux_i686() -> bool:
-    elf_header = _get_elf_header()
-    if elf_header is None:
-        return False
-    result = elf_header.e_ident_class == elf_header.ELFCLASS32
-    result &= elf_header.e_ident_data == elf_header.ELFDATA2LSB
-    result &= elf_header.e_machine == elf_header.EM_386
-    return result
+def _is_linux_i686(executable: str) -> bool:
+    with _parse_elf(executable) as f:
+        return (
+            f is not None
+            and f.capacity == EIClass.C32
+            and f.encoding == EIData.Lsb
+            and f.machine == EMachine.I386
+        )
 
 
-def _have_compatible_abi(arch: str) -> bool:
+def _have_compatible_abi(executable: str, arch: str) -> bool:
     if arch == "armv7l":
-        return _is_linux_armhf()
+        return _is_linux_armhf(executable)
     if arch == "i686":
-        return _is_linux_i686()
+        return _is_linux_i686(executable)
     return arch in {"x86_64", "aarch64", "ppc64", "ppc64le", "s390x"}
 
 
@@ -141,10 +78,10 @@ def _glibc_version_string_confstr() -> Optional[str]:
     # platform module.
     # https://github.com/python/cpython/blob/fcf1d003bf4f0100c/Lib/platform.py#L175-L183
     try:
-        # os.confstr("CS_GNU_LIBC_VERSION") returns a string like "glibc 2.17".
-        version_string = os.confstr("CS_GNU_LIBC_VERSION")
+        # Should be a string like "glibc 2.17".
+        version_string: str = getattr(os, "confstr")("CS_GNU_LIBC_VERSION")
         assert version_string is not None
-        _, version = version_string.split()
+        _, version = version_string.rsplit()
     except (AssertionError, AttributeError, OSError, ValueError):
         # os.confstr() or CS_GNU_LIBC_VERSION not available (or a bad value)...
         return None
@@ -211,8 +148,8 @@ def _parse_glibc_version(version_str: str) -> Tuple[int, int]:
     m = re.match(r"(?P<major>[0-9]+)\.(?P<minor>[0-9]+)", version_str)
     if not m:
         warnings.warn(
-            "Expected glibc version with 2 components major.minor,"
-            " got: %s" % version_str,
+            f"Expected glibc version with 2 components major.minor,"
+            f" got: {version_str}",
             RuntimeWarning,
         )
         return -1, -1
@@ -265,7 +202,7 @@ _LEGACY_MANYLINUX_MAP = {
 
 
 def platform_tags(linux: str, arch: str) -> Iterator[str]:
-    if not _have_compatible_abi(arch):
+    if not _have_compatible_abi(sys.executable, arch):
         return
     # Oldest glibc to be supported regardless of architecture is (2, 17).
     too_old_glibc2 = _GLibCVersion(2, 16)
diff --git a/lib/packaging/_musllinux.py b/lib/packaging/_musllinux.py
index 8ac3059b..706ba600 100644
--- a/lib/packaging/_musllinux.py
+++ b/lib/packaging/_musllinux.py
@@ -4,68 +4,13 @@ This module implements logic to detect if the currently running Python is
 linked against musl, and what musl version is used.
 """
 
-import contextlib
 import functools
-import operator
-import os
 import re
-import struct
 import subprocess
 import sys
-from typing import IO, Iterator, NamedTuple, Optional, Tuple
+from typing import Iterator, NamedTuple, Optional
 
-
-def _read_unpacked(f: IO[bytes], fmt: str) -> Tuple[int, ...]:
-    return struct.unpack(fmt, f.read(struct.calcsize(fmt)))
-
-
-def _parse_ld_musl_from_elf(f: IO[bytes]) -> Optional[str]:
-    """Detect musl libc location by parsing the Python executable.
-
-    Based on: https://gist.github.com/lyssdod/f51579ae8d93c8657a5564aefc2ffbca
-    ELF header: https://refspecs.linuxfoundation.org/elf/gabi4+/ch4.eheader.html
-    """
-    f.seek(0)
-    try:
-        ident = _read_unpacked(f, "16B")
-    except struct.error:
-        return None
-    if ident[:4] != tuple(b"\x7fELF"):  # Invalid magic, not ELF.
-        return None
-    f.seek(struct.calcsize("HHI"), 1)  # Skip file type, machine, and version.
-
-    try:
-        # e_fmt: Format for program header.
-        # p_fmt: Format for section header.
-        # p_idx: Indexes to find p_type, p_offset, and p_filesz.
-        e_fmt, p_fmt, p_idx = {
-            1: ("IIIIHHH", "IIIIIIII", (0, 1, 4)),  # 32-bit.
-            2: ("QQQIHHH", "IIQQQQQQ", (0, 2, 5)),  # 64-bit.
-        }[ident[4]]
-    except KeyError:
-        return None
-    else:
-        p_get = operator.itemgetter(*p_idx)
-
-    # Find the interpreter section and return its content.
-    try:
-        _, e_phoff, _, _, _, e_phentsize, e_phnum = _read_unpacked(f, e_fmt)
-    except struct.error:
-        return None
-    for i in range(e_phnum + 1):
-        f.seek(e_phoff + e_phentsize * i)
-        try:
-            p_type, p_offset, p_filesz = p_get(_read_unpacked(f, p_fmt))
-        except struct.error:
-            return None
-        if p_type != 3:  # Not PT_INTERP.
-            continue
-        f.seek(p_offset)
-        interpreter = os.fsdecode(f.read(p_filesz)).strip("\0")
-        if "musl" not in interpreter:
-            return None
-        return interpreter
-    return None
+from ._elffile import ELFFile
 
 
 class _MuslVersion(NamedTuple):
@@ -95,13 +40,12 @@ def _get_musl_version(executable: str) -> Optional[_MuslVersion]:
         Version 1.2.2
         Dynamic Program Loader
     """
-    with contextlib.ExitStack() as stack:
-        try:
-            f = stack.enter_context(open(executable, "rb"))
-        except OSError:
-            return None
-        ld = _parse_ld_musl_from_elf(f)
-    if not ld:
+    try:
+        with open(executable, "rb") as f:
+            ld = ELFFile(f).interpreter
+    except (OSError, TypeError, ValueError):
+        return None
+    if ld is None or "musl" not in ld:
         return None
     proc = subprocess.run([ld], stderr=subprocess.PIPE, universal_newlines=True)
     return _parse_musl_version(proc.stderr)
diff --git a/lib/packaging/_parser.py b/lib/packaging/_parser.py
new file mode 100644
index 00000000..4dcf03d1
--- /dev/null
+++ b/lib/packaging/_parser.py
@@ -0,0 +1,333 @@
+"""Handwritten parser of dependency specifiers.
+
+The docstring for each __parse_* function contains ENBF-inspired grammar representing
+the implementation.
+"""
+
+import ast
+from typing import Any, List, NamedTuple, Optional, Tuple, Union
+
+from ._tokenizer import DEFAULT_RULES, Tokenizer
+
+
+class Node:
+    def __init__(self, value: str) -> None:
+        self.value = value
+
+    def __str__(self) -> str:
+        return self.value
+
+    def __repr__(self) -> str:
+        return f"<{self.__class__.__name__}('{self}')>"
+
+    def serialize(self) -> str:
+        raise NotImplementedError
+
+
+class Variable(Node):
+    def serialize(self) -> str:
+        return str(self)
+
+
+class Value(Node):
+    def serialize(self) -> str:
+        return f'"{self}"'
+
+
+class Op(Node):
+    def serialize(self) -> str:
+        return str(self)
+
+
+MarkerVar = Union[Variable, Value]
+MarkerItem = Tuple[MarkerVar, Op, MarkerVar]
+# MarkerAtom = Union[MarkerItem, List["MarkerAtom"]]
+# MarkerList = List[Union["MarkerList", MarkerAtom, str]]
+# mypy does not suport recursive type definition
+# https://github.com/python/mypy/issues/731
+MarkerAtom = Any
+MarkerList = List[Any]
+
+
+class ParsedRequirement(NamedTuple):
+    name: str
+    url: str
+    extras: List[str]
+    specifier: str
+    marker: Optional[MarkerList]
+
+
+# --------------------------------------------------------------------------------------
+# Recursive descent parser for dependency specifier
+# --------------------------------------------------------------------------------------
+def parse_requirement(source: str) -> ParsedRequirement:
+    return _parse_requirement(Tokenizer(source, rules=DEFAULT_RULES))
+
+
+def _parse_requirement(tokenizer: Tokenizer) -> ParsedRequirement:
+    """
+    requirement = WS? IDENTIFIER WS? extras WS? requirement_details
+    """
+    tokenizer.consume("WS")
+
+    name_token = tokenizer.expect(
+        "IDENTIFIER", expected="package name at the start of dependency specifier"
+    )
+    name = name_token.text
+    tokenizer.consume("WS")
+
+    extras = _parse_extras(tokenizer)
+    tokenizer.consume("WS")
+
+    url, specifier, marker = _parse_requirement_details(tokenizer)
+    tokenizer.expect("END", expected="end of dependency specifier")
+
+    return ParsedRequirement(name, url, extras, specifier, marker)
+
+
+def _parse_requirement_details(
+    tokenizer: Tokenizer,
+) -> Tuple[str, str, Optional[MarkerList]]:
+    """
+    requirement_details = AT URL (WS requirement_marker)?
+                        | specifier WS? (requirement_marker)?
+    """
+
+    specifier = ""
+    url = ""
+    marker = None
+
+    if tokenizer.check("AT"):
+        tokenizer.read()
+        tokenizer.consume("WS")
+
+        url_start = tokenizer.position
+        url = tokenizer.expect("URL", expected="URL after @").text
+        if tokenizer.check("END", peek=True):
+            return (url, specifier, marker)
+
+        tokenizer.expect("WS", expected="whitespace after URL")
+
+        marker = _parse_requirement_marker(
+            tokenizer, span_start=url_start, after="URL and whitespace"
+        )
+    else:
+        specifier_start = tokenizer.position
+        specifier = _parse_specifier(tokenizer)
+        tokenizer.consume("WS")
+
+        if tokenizer.check("END", peek=True):
+            return (url, specifier, marker)
+
+        marker = _parse_requirement_marker(
+            tokenizer,
+            span_start=specifier_start,
+            after=(
+                "version specifier"
+                if specifier
+                else "name and no valid version specifier"
+            ),
+        )
+
+    return (url, specifier, marker)
+
+
+def _parse_requirement_marker(
+    tokenizer: Tokenizer, *, span_start: int, after: str
+) -> MarkerList:
+    """
+    requirement_marker = SEMICOLON marker WS?
+    """
+
+    if not tokenizer.check("SEMICOLON"):
+        tokenizer.raise_syntax_error(
+            f"Expected end or semicolon (after {after})",
+            span_start=span_start,
+        )
+    else:
+        tokenizer.read()
+
+    marker = _parse_marker(tokenizer)
+    tokenizer.consume("WS")
+
+    return marker
+
+
+def _parse_extras(tokenizer: Tokenizer) -> List[str]:
+    """
+    extras = (LEFT_BRACKET wsp* extras_list? wsp* RIGHT_BRACKET)?
+    """
+    if not tokenizer.check("LEFT_BRACKET", peek=True):
+        return []
+
+    with tokenizer.enclosing_tokens("LEFT_BRACKET", "RIGHT_BRACKET"):
+        tokenizer.consume("WS")
+        extras = _parse_extras_list(tokenizer)
+        tokenizer.consume("WS")
+
+    return extras
+
+
+def _parse_extras_list(tokenizer: Tokenizer) -> List[str]:
+    """
+    extras_list = identifier (wsp* ',' wsp* identifier)*
+    """
+    extras: List[str] = []
+
+    if not tokenizer.check("IDENTIFIER"):
+        return extras
+
+    extras.append(tokenizer.read().text)
+
+    while True:
+        tokenizer.consume("WS")
+        if tokenizer.check("IDENTIFIER", peek=True):
+            tokenizer.raise_syntax_error("Expected comma between extra names")
+        elif not tokenizer.check("COMMA"):
+            break
+
+        tokenizer.read()
+        tokenizer.consume("WS")
+
+        extra_token = tokenizer.expect("IDENTIFIER", expected="extra name after comma")
+        extras.append(extra_token.text)
+
+    return extras
+
+
+def _parse_specifier(tokenizer: Tokenizer) -> str:
+    """
+    specifier = LEFT_PARENTHESIS WS? version_many WS? RIGHT_PARENTHESIS
+              | WS? version_many WS?
+    """
+    with tokenizer.enclosing_tokens("LEFT_PARENTHESIS", "RIGHT_PARENTHESIS"):
+        tokenizer.consume("WS")
+        parsed_specifiers = _parse_version_many(tokenizer)
+        tokenizer.consume("WS")
+
+    return parsed_specifiers
+
+
+def _parse_version_many(tokenizer: Tokenizer) -> str:
+    """
+    version_many = (OP VERSION (COMMA OP VERSION)*)?
+    """
+    parsed_specifiers = ""
+    while tokenizer.check("OP"):
+        parsed_specifiers += tokenizer.read().text
+
+        # We intentionally do not consume whitespace here, since the regular expression
+        # for `VERSION` uses a lookback for the operator, to determine what
+        # corresponding syntax is permitted.
+
+        version_token = tokenizer.expect("VERSION", expected="version after operator")
+        parsed_specifiers += version_token.text
+        tokenizer.consume("WS")
+
+        if not tokenizer.check("COMMA"):
+            break
+        parsed_specifiers += tokenizer.read().text
+        tokenizer.consume("WS")
+
+    return parsed_specifiers
+
+
+# --------------------------------------------------------------------------------------
+# Recursive descent parser for marker expression
+# --------------------------------------------------------------------------------------
+def parse_marker(source: str) -> MarkerList:
+    return _parse_marker(Tokenizer(source, rules=DEFAULT_RULES))
+
+
+def _parse_marker(tokenizer: Tokenizer) -> MarkerList:
+    """
+    marker = marker_atom (BOOLOP marker_atom)+
+    """
+    expression = [_parse_marker_atom(tokenizer)]
+    while tokenizer.check("BOOLOP"):
+        token = tokenizer.read()
+        expr_right = _parse_marker_atom(tokenizer)
+        expression.extend((token.text, expr_right))
+    return expression
+
+
+def _parse_marker_atom(tokenizer: Tokenizer) -> MarkerAtom:
+    """
+    marker_atom = WS? LEFT_PARENTHESIS WS? marker WS? RIGHT_PARENTHESIS WS?
+                | WS? marker_item WS?
+    """
+
+    tokenizer.consume("WS")
+    if tokenizer.check("LEFT_PARENTHESIS", peek=True):
+        with tokenizer.enclosing_tokens("LEFT_PARENTHESIS", "RIGHT_PARENTHESIS"):
+            tokenizer.consume("WS")
+            marker: MarkerAtom = _parse_marker(tokenizer)
+            tokenizer.consume("WS")
+    else:
+        marker = _parse_marker_item(tokenizer)
+    tokenizer.consume("WS")
+    return marker
+
+
+def _parse_marker_item(tokenizer: Tokenizer) -> MarkerItem:
+    """
+    marker_item = WS? marker_var WS? marker_op WS? marker_var WS?
+    """
+    tokenizer.consume("WS")
+    marker_var_left = _parse_marker_var(tokenizer)
+    tokenizer.consume("WS")
+    marker_op = _parse_marker_op(tokenizer)
+    tokenizer.consume("WS")
+    marker_var_right = _parse_marker_var(tokenizer)
+    tokenizer.consume("WS")
+    return (marker_var_left, marker_op, marker_var_right)
+
+
+def _parse_marker_var(tokenizer: Tokenizer) -> MarkerVar:
+    """
+    marker_var = VARIABLE | QUOTED_STRING
+    """
+    if tokenizer.check("VARIABLE"):
+        return process_env_var(tokenizer.read().text.replace(".", "_"))
+    elif tokenizer.check("QUOTED_STRING"):
+        return process_python_str(tokenizer.read().text)
+    else:
+        tokenizer.raise_syntax_error(
+            message="Expected a marker variable or quoted string"
+        )
+
+
+def process_env_var(env_var: str) -> Variable:
+    if (
+        env_var == "platform_python_implementation"
+        or env_var == "python_implementation"
+    ):
+        return Variable("platform_python_implementation")
+    else:
+        return Variable(env_var)
+
+
+def process_python_str(python_str: str) -> Value:
+    value = ast.literal_eval(python_str)
+    return Value(str(value))
+
+
+def _parse_marker_op(tokenizer: Tokenizer) -> Op:
+    """
+    marker_op = IN | NOT IN | OP
+    """
+    if tokenizer.check("IN"):
+        tokenizer.read()
+        return Op("in")
+    elif tokenizer.check("NOT"):
+        tokenizer.read()
+        tokenizer.expect("WS", expected="whitespace after 'not'")
+        tokenizer.expect("IN", expected="'in' after 'not'")
+        return Op("not in")
+    elif tokenizer.check("OP"):
+        return Op(tokenizer.read().text)
+    else:
+        return tokenizer.raise_syntax_error(
+            "Expected marker operator, one of "
+            "<=, <, !=, ==, >=, >, ~=, ===, in, not in"
+        )
diff --git a/lib/packaging/_tokenizer.py b/lib/packaging/_tokenizer.py
new file mode 100644
index 00000000..de389cb3
--- /dev/null
+++ b/lib/packaging/_tokenizer.py
@@ -0,0 +1,186 @@
+import contextlib
+import re
+from dataclasses import dataclass
+from typing import Dict, Iterator, NoReturn, Optional, Tuple, Union
+
+from .specifiers import Specifier
+
+
+@dataclass
+class Token:
+    name: str
+    text: str
+    position: int
+
+
+class ParserSyntaxError(Exception):
+    """The provided source text could not be parsed correctly."""
+
+    def __init__(
+        self,
+        message: str,
+        *,
+        source: str,
+        span: Tuple[int, int],
+    ) -> None:
+        self.span = span
+        self.message = message
+        self.source = source
+
+        super().__init__()
+
+    def __str__(self) -> str:
+        marker = " " * self.span[0] + "~" * (self.span[1] - self.span[0]) + "^"
+        return "\n    ".join([self.message, self.source, marker])
+
+
+DEFAULT_RULES: "Dict[str, Union[str, re.Pattern[str]]]" = {
+    "LPAREN": r"\s*\(",
+    "LEFT_PARENTHESIS": r"\(",
+    "RIGHT_PARENTHESIS": r"\)",
+    "LEFT_BRACKET": r"\[",
+    "RIGHT_BRACKET": r"\]",
+    "SEMICOLON": r";",
+    "COMMA": r",",
+    "QUOTED_STRING": re.compile(
+        r"""
+            (
+                ('[^']*')
+                |
+                ("[^"]*")
+            )
+        """,
+        re.VERBOSE,
+    ),
+    "OP": r"(===|==|~=|!=|<=|>=|<|>)",
+    "BOOLOP": r"\b(or|and)\b",
+    "IN": r"\bin\b",
+    "NOT": r"\bnot\b",
+    "VARIABLE": re.compile(
+        r"""
+            \b(
+                python_version
+                |python_full_version
+                |os[._]name
+                |sys[._]platform
+                |platform_(release|system)
+                |platform[._](version|machine|python_implementation)
+                |python_implementation
+                |implementation_(name|version)
+                |extra
+            )\b
+        """,
+        re.VERBOSE,
+    ),
+    "VERSION": re.compile(Specifier._version_regex_str, re.VERBOSE | re.IGNORECASE),
+    "AT": r"\@",
+    "URL": r"[^ \t]+",
+    "IDENTIFIER": r"\b[a-zA-Z0-9][a-zA-Z0-9._-]*\b",
+    "WS": r"[ \t]+",
+    "END": r"$",
+}
+
+
+class Tokenizer:
+    """Context-sensitive token parsing.
+
+    Provides methods to examine the input stream to check whether the next token
+    matches.
+    """
+
+    def __init__(
+        self,
+        source: str,
+        *,
+        rules: "Dict[str, Union[str, re.Pattern[str]]]",
+    ) -> None:
+        self.source = source
+        self.rules: Dict[str, re.Pattern[str]] = {
+            name: re.compile(pattern) for name, pattern in rules.items()
+        }
+        self.next_token: Optional[Token] = None
+        self.position = 0
+
+    def consume(self, name: str) -> None:
+        """Move beyond provided token name, if at current position."""
+        if self.check(name):
+            self.read()
+
+    def check(self, name: str, *, peek: bool = False) -> bool:
+        """Check whether the next token has the provided name.
+
+        By default, if the check succeeds, the token *must* be read before
+        another check. If `peek` is set to `True`, the token is not loaded and
+        would need to be checked again.
+        """
+        assert (
+            self.next_token is None
+        ), f"Cannot check for {name!r}, already have {self.next_token!r}"
+        assert name in self.rules, f"Unknown token name: {name!r}"
+
+        expression = self.rules[name]
+
+        match = expression.match(self.source, self.position)
+        if match is None:
+            return False
+        if not peek:
+            self.next_token = Token(name, match[0], self.position)
+        return True
+
+    def expect(self, name: str, *, expected: str) -> Token:
+        """Expect a certain token name next, failing with a syntax error otherwise.
+
+        The token is *not* read.
+        """
+        if not self.check(name):
+            raise self.raise_syntax_error(f"Expected {expected}")
+        return self.read()
+
+    def read(self) -> Token:
+        """Consume the next token and return it."""
+        token = self.next_token
+        assert token is not None
+
+        self.position += len(token.text)
+        self.next_token = None
+
+        return token
+
+    def raise_syntax_error(
+        self,
+        message: str,
+        *,
+        span_start: Optional[int] = None,
+        span_end: Optional[int] = None,
+    ) -> NoReturn:
+        """Raise ParserSyntaxError at the given position."""
+        span = (
+            self.position if span_start is None else span_start,
+            self.position if span_end is None else span_end,
+        )
+        raise ParserSyntaxError(
+            message,
+            source=self.source,
+            span=span,
+        )
+
+    @contextlib.contextmanager
+    def enclosing_tokens(self, open_token: str, close_token: str) -> Iterator[bool]:
+        if self.check(open_token):
+            open_position = self.position
+            self.read()
+        else:
+            open_position = None
+
+        yield open_position is not None
+
+        if open_position is None:
+            return
+
+        if not self.check(close_token):
+            self.raise_syntax_error(
+                f"Expected closing {close_token}",
+                span_start=open_position,
+            )
+
+        self.read()
diff --git a/lib/packaging/markers.py b/lib/packaging/markers.py
index cb640e8f..a5bf35c6 100644
--- a/lib/packaging/markers.py
+++ b/lib/packaging/markers.py
@@ -8,19 +8,10 @@ import platform
 import sys
 from typing import Any, Callable, Dict, List, Optional, Tuple, Union
 
-from pyparsing import (  # noqa: N817
-    Forward,
-    Group,
-    Literal as L,
-    ParseException,
-    ParseResults,
-    QuotedString,
-    ZeroOrMore,
-    stringEnd,
-    stringStart,
-)
-
+from ._parser import MarkerAtom, MarkerList, Op, Value, Variable, parse_marker
+from ._tokenizer import ParserSyntaxError
 from .specifiers import InvalidSpecifier, Specifier
+from .utils import canonicalize_name
 
 __all__ = [
     "InvalidMarker",
@@ -52,101 +43,24 @@ class UndefinedEnvironmentName(ValueError):
     """
 
 
-class Node:
-    def __init__(self, value: Any) -> None:
-        self.value = value
-
-    def __str__(self) -> str:
-        return str(self.value)
-
-    def __repr__(self) -> str:
-        return f"<{self.__class__.__name__}('{self}')>"
-
-    def serialize(self) -> str:
-        raise NotImplementedError
-
-
-class Variable(Node):
-    def serialize(self) -> str:
-        return str(self)
-
-
-class Value(Node):
-    def serialize(self) -> str:
-        return f'"{self}"'
-
-
-class Op(Node):
-    def serialize(self) -> str:
-        return str(self)
-
-
-VARIABLE = (
-    L("implementation_version")
-    | L("platform_python_implementation")
-    | L("implementation_name")
-    | L("python_full_version")
-    | L("platform_release")
-    | L("platform_version")
-    | L("platform_machine")
-    | L("platform_system")
-    | L("python_version")
-    | L("sys_platform")
-    | L("os_name")
-    | L("os.name")  # PEP-345
-    | L("sys.platform")  # PEP-345
-    | L("platform.version")  # PEP-345
-    | L("platform.machine")  # PEP-345
-    | L("platform.python_implementation")  # PEP-345
-    | L("python_implementation")  # undocumented setuptools legacy
-    | L("extra")  # PEP-508
-)
-ALIASES = {
-    "os.name": "os_name",
-    "sys.platform": "sys_platform",
-    "platform.version": "platform_version",
-    "platform.machine": "platform_machine",
-    "platform.python_implementation": "platform_python_implementation",
-    "python_implementation": "platform_python_implementation",
-}
-VARIABLE.setParseAction(lambda s, l, t: Variable(ALIASES.get(t[0], t[0])))
-
-VERSION_CMP = (
-    L("===") | L("==") | L(">=") | L("<=") | L("!=") | L("~=") | L(">") | L("<")
-)
-
-MARKER_OP = VERSION_CMP | L("not in") | L("in")
-MARKER_OP.setParseAction(lambda s, l, t: Op(t[0]))
-
-MARKER_VALUE = QuotedString("'") | QuotedString('"')
-MARKER_VALUE.setParseAction(lambda s, l, t: Value(t[0]))
-
-BOOLOP = L("and") | L("or")
-
-MARKER_VAR = VARIABLE | MARKER_VALUE
-
-MARKER_ITEM = Group(MARKER_VAR + MARKER_OP + MARKER_VAR)
-MARKER_ITEM.setParseAction(lambda s, l, t: tuple(t[0]))
-
-LPAREN = L("(").suppress()
-RPAREN = L(")").suppress()
-
-MARKER_EXPR = Forward()
-MARKER_ATOM = MARKER_ITEM | Group(LPAREN + MARKER_EXPR + RPAREN)
-MARKER_EXPR << MARKER_ATOM + ZeroOrMore(BOOLOP + MARKER_EXPR)
-
-MARKER = stringStart + MARKER_EXPR + stringEnd
-
-
-def _coerce_parse_result(results: Union[ParseResults, List[Any]]) -> List[Any]:
-    if isinstance(results, ParseResults):
-        return [_coerce_parse_result(i) for i in results]
-    else:
-        return results
+def _normalize_extra_values(results: Any) -> Any:
+    """
+    Normalize extra values.
+    """
+    if isinstance(results[0], tuple):
+        lhs, op, rhs = results[0]
+        if isinstance(lhs, Variable) and lhs.value == "extra":
+            normalized_extra = canonicalize_name(rhs.value)
+            rhs = Value(normalized_extra)
+        elif isinstance(rhs, Variable) and rhs.value == "extra":
+            normalized_extra = canonicalize_name(lhs.value)
+            lhs = Value(normalized_extra)
+        results[0] = lhs, op, rhs
+    return results
 
 
 def _format_marker(
-    marker: Union[List[str], Tuple[Node, ...], str], first: Optional[bool] = True
+    marker: Union[List[str], MarkerAtom, str], first: Optional[bool] = True
 ) -> str:
 
     assert isinstance(marker, (list, tuple, str))
@@ -192,7 +106,7 @@ def _eval_op(lhs: str, op: Op, rhs: str) -> bool:
     except InvalidSpecifier:
         pass
     else:
-        return spec.contains(lhs)
+        return spec.contains(lhs, prereleases=True)
 
     oper: Optional[Operator] = _operators.get(op.serialize())
     if oper is None:
@@ -201,25 +115,19 @@ def _eval_op(lhs: str, op: Op, rhs: str) -> bool:
     return oper(lhs, rhs)
 
 
-class Undefined:
-    pass
+def _normalize(*values: str, key: str) -> Tuple[str, ...]:
+    # PEP 685 – Comparison of extra names for optional distribution dependencies
+    # https://peps.python.org/pep-0685/
+    # > When comparing extra names, tools MUST normalize the names being
+    # > compared using the semantics outlined in PEP 503 for names
+    if key == "extra":
+        return tuple(canonicalize_name(v) for v in values)
+
+    # other environment markers don't have such standards
+    return values
 
 
-_undefined = Undefined()
-
-
-def _get_env(environment: Dict[str, str], name: str) -> str:
-    value: Union[str, Undefined] = environment.get(name, _undefined)
-
-    if isinstance(value, Undefined):
-        raise UndefinedEnvironmentName(
-            f"{name!r} does not exist in evaluation environment."
-        )
-
-    return value
-
-
-def _evaluate_markers(markers: List[Any], environment: Dict[str, str]) -> bool:
+def _evaluate_markers(markers: MarkerList, environment: Dict[str, str]) -> bool:
     groups: List[List[bool]] = [[]]
 
     for marker in markers:
@@ -231,12 +139,15 @@ def _evaluate_markers(markers: List[Any], environment: Dict[str, str]) -> bool:
             lhs, op, rhs = marker
 
             if isinstance(lhs, Variable):
-                lhs_value = _get_env(environment, lhs.value)
+                environment_key = lhs.value
+                lhs_value = environment[environment_key]
                 rhs_value = rhs.value
             else:
                 lhs_value = lhs.value
-                rhs_value = _get_env(environment, rhs.value)
+                environment_key = rhs.value
+                rhs_value = environment[environment_key]
 
+            lhs_value, rhs_value = _normalize(lhs_value, rhs_value, key=environment_key)
             groups[-1].append(_eval_op(lhs_value, op, rhs_value))
         else:
             assert marker in ["and", "or"]
@@ -274,13 +185,29 @@ def default_environment() -> Dict[str, str]:
 
 class Marker:
     def __init__(self, marker: str) -> None:
+        # Note: We create a Marker object without calling this constructor in
+        #       packaging.requirements.Requirement. If any additional logic is
+        #       added here, make sure to mirror/adapt Requirement.
         try:
-            self._markers = _coerce_parse_result(MARKER.parseString(marker))
-        except ParseException as e:
-            raise InvalidMarker(
-                f"Invalid marker: {marker!r}, parse error at "
-                f"{marker[e.loc : e.loc + 8]!r}"
-            )
+            self._markers = _normalize_extra_values(parse_marker(marker))
+            # The attribute `_markers` can be described in terms of a recursive type:
+            # MarkerList = List[Union[Tuple[Node, ...], str, MarkerList]]
+            #
+            # For example, the following expression:
+            # python_version > "3.6" or (python_version == "3.6" and os_name == "unix")
+            #
+            # is parsed into:
+            # [
+            #     (<Variable('python_version')>, <Op('>')>, <Value('3.6')>),
+            #     'and',
+            #     [
+            #         (<Variable('python_version')>, <Op('==')>, <Value('3.6')>),
+            #         'or',
+            #         (<Variable('os_name')>, <Op('==')>, <Value('unix')>)
+            #     ]
+            # ]
+        except ParserSyntaxError as e:
+            raise InvalidMarker(str(e)) from e
 
     def __str__(self) -> str:
         return _format_marker(self._markers)
@@ -288,6 +215,15 @@ class Marker:
     def __repr__(self) -> str:
         return f"<Marker('{self}')>"
 
+    def __hash__(self) -> int:
+        return hash((self.__class__.__name__, str(self)))
+
+    def __eq__(self, other: Any) -> bool:
+        if not isinstance(other, Marker):
+            return NotImplemented
+
+        return str(self) == str(other)
+
     def evaluate(self, environment: Optional[Dict[str, str]] = None) -> bool:
         """Evaluate a marker.
 
@@ -298,6 +234,7 @@ class Marker:
         The environment is determined from the current Python process.
         """
         current_environment = default_environment()
+        current_environment["extra"] = ""
         if environment is not None:
             current_environment.update(environment)
 
diff --git a/lib/packaging/requirements.py b/lib/packaging/requirements.py
index 53f9a3aa..a9f9b9c7 100644
--- a/lib/packaging/requirements.py
+++ b/lib/packaging/requirements.py
@@ -2,26 +2,13 @@
 # 2.0, and the BSD License. See the LICENSE file in the root of this repository
 # for complete details.
 
-import re
-import string
 import urllib.parse
-from typing import List, Optional as TOptional, Set
+from typing import Any, List, Optional, Set
 
-from pyparsing import (  # noqa
-    Combine,
-    Literal as L,
-    Optional,
-    ParseException,
-    Regex,
-    Word,
-    ZeroOrMore,
-    originalTextFor,
-    stringEnd,
-    stringStart,
-)
-
-from .markers import MARKER_EXPR, Marker
-from .specifiers import LegacySpecifier, Specifier, SpecifierSet
+from ._parser import parse_requirement
+from ._tokenizer import ParserSyntaxError
+from .markers import Marker, _normalize_extra_values
+from .specifiers import SpecifierSet
 
 
 class InvalidRequirement(ValueError):
@@ -30,60 +17,6 @@ class InvalidRequirement(ValueError):
     """
 
 
-ALPHANUM = Word(string.ascii_letters + string.digits)
-
-LBRACKET = L("[").suppress()
-RBRACKET = L("]").suppress()
-LPAREN = L("(").suppress()
-RPAREN = L(")").suppress()
-COMMA = L(",").suppress()
-SEMICOLON = L(";").suppress()
-AT = L("@").suppress()
-
-PUNCTUATION = Word("-_.")
-IDENTIFIER_END = ALPHANUM | (ZeroOrMore(PUNCTUATION) + ALPHANUM)
-IDENTIFIER = Combine(ALPHANUM + ZeroOrMore(IDENTIFIER_END))
-
-NAME = IDENTIFIER("name")
-EXTRA = IDENTIFIER
-
-URI = Regex(r"[^ ]+")("url")
-URL = AT + URI
-
-EXTRAS_LIST = EXTRA + ZeroOrMore(COMMA + EXTRA)
-EXTRAS = (LBRACKET + Optional(EXTRAS_LIST) + RBRACKET)("extras")
-
-VERSION_PEP440 = Regex(Specifier._regex_str, re.VERBOSE | re.IGNORECASE)
-VERSION_LEGACY = Regex(LegacySpecifier._regex_str, re.VERBOSE | re.IGNORECASE)
-
-VERSION_ONE = VERSION_PEP440 ^ VERSION_LEGACY
-VERSION_MANY = Combine(
-    VERSION_ONE + ZeroOrMore(COMMA + VERSION_ONE), joinString=",", adjacent=False
-)("_raw_spec")
-_VERSION_SPEC = Optional((LPAREN + VERSION_MANY + RPAREN) | VERSION_MANY)
-_VERSION_SPEC.setParseAction(lambda s, l, t: t._raw_spec or "")
-
-VERSION_SPEC = originalTextFor(_VERSION_SPEC)("specifier")
-VERSION_SPEC.setParseAction(lambda s, l, t: t[1])
-
-MARKER_EXPR = originalTextFor(MARKER_EXPR())("marker")
-MARKER_EXPR.setParseAction(
-    lambda s, l, t: Marker(s[t._original_start : t._original_end])
-)
-MARKER_SEPARATOR = SEMICOLON
-MARKER = MARKER_SEPARATOR + MARKER_EXPR
-
-VERSION_AND_MARKER = VERSION_SPEC + Optional(MARKER)
-URL_AND_MARKER = URL + Optional(MARKER)
-
-NAMED_REQUIREMENT = NAME + Optional(EXTRAS) + (URL_AND_MARKER | VERSION_AND_MARKER)
-
-REQUIREMENT = stringStart + NAMED_REQUIREMENT + stringEnd
-# pyparsing isn't thread safe during initialization, so we do it eagerly, see
-# issue #104
-REQUIREMENT.parseString("x[]")
-
-
 class Requirement:
     """Parse a requirement.
 
@@ -99,28 +32,29 @@ class Requirement:
 
     def __init__(self, requirement_string: str) -> None:
         try:
-            req = REQUIREMENT.parseString(requirement_string)
-        except ParseException as e:
-            raise InvalidRequirement(
-                f'Parse error at "{ requirement_string[e.loc : e.loc + 8]!r}": {e.msg}'
-            )
+            parsed = parse_requirement(requirement_string)
+        except ParserSyntaxError as e:
+            raise InvalidRequirement(str(e)) from e
 
-        self.name: str = req.name
-        if req.url:
-            parsed_url = urllib.parse.urlparse(req.url)
+        self.name: str = parsed.name
+        if parsed.url:
+            parsed_url = urllib.parse.urlparse(parsed.url)
             if parsed_url.scheme == "file":
-                if urllib.parse.urlunparse(parsed_url) != req.url:
+                if urllib.parse.urlunparse(parsed_url) != parsed.url:
                     raise InvalidRequirement("Invalid URL given")
             elif not (parsed_url.scheme and parsed_url.netloc) or (
                 not parsed_url.scheme and not parsed_url.netloc
             ):
-                raise InvalidRequirement(f"Invalid URL: {req.url}")
-            self.url: TOptional[str] = req.url
+                raise InvalidRequirement(f"Invalid URL: {parsed.url}")
+            self.url: Optional[str] = parsed.url
         else:
             self.url = None
-        self.extras: Set[str] = set(req.extras.asList() if req.extras else [])
-        self.specifier: SpecifierSet = SpecifierSet(req.specifier)
-        self.marker: TOptional[Marker] = req.marker if req.marker else None
+        self.extras: Set[str] = set(parsed.extras if parsed.extras else [])
+        self.specifier: SpecifierSet = SpecifierSet(parsed.specifier)
+        self.marker: Optional[Marker] = None
+        if parsed.marker is not None:
+            self.marker = Marker.__new__(Marker)
+            self.marker._markers = _normalize_extra_values(parsed.marker)
 
     def __str__(self) -> str:
         parts: List[str] = [self.name]
@@ -144,3 +78,18 @@ class Requirement:
 
     def __repr__(self) -> str:
         return f"<Requirement('{self}')>"
+
+    def __hash__(self) -> int:
+        return hash((self.__class__.__name__, str(self)))
+
+    def __eq__(self, other: Any) -> bool:
+        if not isinstance(other, Requirement):
+            return NotImplemented
+
+        return (
+            self.name == other.name
+            and self.extras == other.extras
+            and self.specifier == other.specifier
+            and self.url == other.url
+            and self.marker == other.marker
+        )
diff --git a/lib/packaging/specifiers.py b/lib/packaging/specifiers.py
index 0e218a6f..645214ae 100644
--- a/lib/packaging/specifiers.py
+++ b/lib/packaging/specifiers.py
@@ -1,38 +1,40 @@
 # This file is dual licensed under the terms of the Apache License, Version
 # 2.0, and the BSD License. See the LICENSE file in the root of this repository
 # for complete details.
+"""
+.. testsetup::
+
+    from packaging.specifiers import Specifier, SpecifierSet, InvalidSpecifier
+    from packaging.version import Version
+"""
 
 import abc
-import functools
 import itertools
 import re
-import warnings
-from typing import (
-    Callable,
-    Dict,
-    Iterable,
-    Iterator,
-    List,
-    Optional,
-    Pattern,
-    Set,
-    Tuple,
-    TypeVar,
-    Union,
-)
+from typing import Callable, Iterable, Iterator, List, Optional, Set, Tuple, Union
 
 from .utils import canonicalize_version
-from .version import LegacyVersion, Version, parse
+from .version import Version
 
-ParsedVersion = Union[Version, LegacyVersion]
-UnparsedVersion = Union[Version, LegacyVersion, str]
-VersionTypeVar = TypeVar("VersionTypeVar", bound=UnparsedVersion)
-CallableOperator = Callable[[ParsedVersion, str], bool]
+UnparsedVersion = Union[Version, str]
+CallableOperator = Callable[[Version, str], bool]
+
+
+def _coerce_version(version: UnparsedVersion) -> Version:
+    if not isinstance(version, Version):
+        version = Version(version)
+    return version
 
 
 class InvalidSpecifier(ValueError):
     """
-    An invalid specifier was found, users should refer to PEP 440.
+    Raised when attempting to create a :class:`Specifier` with a specifier
+    string that is invalid.
+
+    >>> Specifier("lolwat")
+    Traceback (most recent call last):
+        ...
+    packaging.specifiers.InvalidSpecifier: Invalid specifier: 'lolwat'
     """
 
 
@@ -40,35 +42,39 @@ class BaseSpecifier(metaclass=abc.ABCMeta):
     @abc.abstractmethod
     def __str__(self) -> str:
         """
-        Returns the str representation of this Specifier like object. This
+        Returns the str representation of this Specifier-like object. This
         should be representative of the Specifier itself.
         """
 
     @abc.abstractmethod
     def __hash__(self) -> int:
         """
-        Returns a hash value for this Specifier like object.
+        Returns a hash value for this Specifier-like object.
         """
 
     @abc.abstractmethod
     def __eq__(self, other: object) -> bool:
         """
-        Returns a boolean representing whether or not the two Specifier like
+        Returns a boolean representing whether or not the two Specifier-like
         objects are equal.
+
+        :param other: The other object to check against.
         """
 
-    @abc.abstractproperty
+    @property
+    @abc.abstractmethod
     def prereleases(self) -> Optional[bool]:
-        """
-        Returns whether or not pre-releases as a whole are allowed by this
-        specifier.
+        """Whether or not pre-releases as a whole are allowed.
+
+        This can be set to either ``True`` or ``False`` to explicitly enable or disable
+        prereleases or it can be set to ``None`` (the default) to use default semantics.
         """
 
     @prereleases.setter
     def prereleases(self, value: bool) -> None:
-        """
-        Sets whether or not pre-releases as a whole are allowed by this
-        specifier.
+        """Setter for :attr:`prereleases`.
+
+        :param value: The value to set.
         """
 
     @abc.abstractmethod
@@ -79,227 +85,28 @@ class BaseSpecifier(metaclass=abc.ABCMeta):
 
     @abc.abstractmethod
     def filter(
-        self, iterable: Iterable[VersionTypeVar], prereleases: Optional[bool] = None
-    ) -> Iterable[VersionTypeVar]:
+        self, iterable: Iterable[UnparsedVersion], prereleases: Optional[bool] = None
+    ) -> Iterator[UnparsedVersion]:
         """
         Takes an iterable of items and filters them so that only items which
         are contained within this specifier are allowed in it.
         """
 
 
-class _IndividualSpecifier(BaseSpecifier):
+class Specifier(BaseSpecifier):
+    """This class abstracts handling of version specifiers.
 
-    _operators: Dict[str, str] = {}
-    _regex: Pattern[str]
+    .. tip::
 
-    def __init__(self, spec: str = "", prereleases: Optional[bool] = None) -> None:
-        match = self._regex.search(spec)
-        if not match:
-            raise InvalidSpecifier(f"Invalid specifier: '{spec}'")
+        It is generally not required to instantiate this manually. You should instead
+        prefer to work with :class:`SpecifierSet` instead, which can parse
+        comma-separated version specifiers (which is what package metadata contains).
+    """
 
-        self._spec: Tuple[str, str] = (
-            match.group("operator").strip(),
-            match.group("version").strip(),
-        )
-
-        # Store whether or not this Specifier should accept prereleases
-        self._prereleases = prereleases
-
-    def __repr__(self) -> str:
-        pre = (
-            f", prereleases={self.prereleases!r}"
-            if self._prereleases is not None
-            else ""
-        )
-
-        return f"<{self.__class__.__name__}({str(self)!r}{pre})>"
-
-    def __str__(self) -> str:
-        return "{}{}".format(*self._spec)
-
-    @property
-    def _canonical_spec(self) -> Tuple[str, str]:
-        return self._spec[0], canonicalize_version(self._spec[1])
-
-    def __hash__(self) -> int:
-        return hash(self._canonical_spec)
-
-    def __eq__(self, other: object) -> bool:
-        if isinstance(other, str):
-            try:
-                other = self.__class__(str(other))
-            except InvalidSpecifier:
-                return NotImplemented
-        elif not isinstance(other, self.__class__):
-            return NotImplemented
-
-        return self._canonical_spec == other._canonical_spec
-
-    def _get_operator(self, op: str) -> CallableOperator:
-        operator_callable: CallableOperator = getattr(
-            self, f"_compare_{self._operators[op]}"
-        )
-        return operator_callable
-
-    def _coerce_version(self, version: UnparsedVersion) -> ParsedVersion:
-        if not isinstance(version, (LegacyVersion, Version)):
-            version = parse(version)
-        return version
-
-    @property
-    def operator(self) -> str:
-        return self._spec[0]
-
-    @property
-    def version(self) -> str:
-        return self._spec[1]
-
-    @property
-    def prereleases(self) -> Optional[bool]:
-        return self._prereleases
-
-    @prereleases.setter
-    def prereleases(self, value: bool) -> None:
-        self._prereleases = value
-
-    def __contains__(self, item: str) -> bool:
-        return self.contains(item)
-
-    def contains(
-        self, item: UnparsedVersion, prereleases: Optional[bool] = None
-    ) -> bool:
-
-        # Determine if prereleases are to be allowed or not.
-        if prereleases is None:
-            prereleases = self.prereleases
-
-        # Normalize item to a Version or LegacyVersion, this allows us to have
-        # a shortcut for ``"2.0" in Specifier(">=2")
-        normalized_item = self._coerce_version(item)
-
-        # Determine if we should be supporting prereleases in this specifier
-        # or not, if we do not support prereleases than we can short circuit
-        # logic if this version is a prereleases.
-        if normalized_item.is_prerelease and not prereleases:
-            return False
-
-        # Actually do the comparison to determine if this item is contained
-        # within this Specifier or not.
-        operator_callable: CallableOperator = self._get_operator(self.operator)
-        return operator_callable(normalized_item, self.version)
-
-    def filter(
-        self, iterable: Iterable[VersionTypeVar], prereleases: Optional[bool] = None
-    ) -> Iterable[VersionTypeVar]:
-
-        yielded = False
-        found_prereleases = []
-
-        kw = {"prereleases": prereleases if prereleases is not None else True}
-
-        # Attempt to iterate over all the values in the iterable and if any of
-        # them match, yield them.
-        for version in iterable:
-            parsed_version = self._coerce_version(version)
-
-            if self.contains(parsed_version, **kw):
-                # If our version is a prerelease, and we were not set to allow
-                # prereleases, then we'll store it for later in case nothing
-                # else matches this specifier.
-                if parsed_version.is_prerelease and not (
-                    prereleases or self.prereleases
-                ):
-                    found_prereleases.append(version)
-                # Either this is not a prerelease, or we should have been
-                # accepting prereleases from the beginning.
-                else:
-                    yielded = True
-                    yield version
-
-        # Now that we've iterated over everything, determine if we've yielded
-        # any values, and if we have not and we have any prereleases stored up
-        # then we will go ahead and yield the prereleases.
-        if not yielded and found_prereleases:
-            for version in found_prereleases:
-                yield version
-
-
-class LegacySpecifier(_IndividualSpecifier):
-
-    _regex_str = r"""
-        (?P<operator>(==|!=|<=|>=|<|>))
-        \s*
-        (?P<version>
-            [^,;\s)]* # Since this is a "legacy" specifier, and the version
-                      # string can be just about anything, we match everything
-                      # except for whitespace, a semi-colon for marker support,
-                      # a closing paren since versions can be enclosed in
-                      # them, and a comma since it's a version separator.
-        )
-        """
-
-    _regex = re.compile(r"^\s*" + _regex_str + r"\s*$", re.VERBOSE | re.IGNORECASE)
-
-    _operators = {
-        "==": "equal",
-        "!=": "not_equal",
-        "<=": "less_than_equal",
-        ">=": "greater_than_equal",
-        "<": "less_than",
-        ">": "greater_than",
-    }
-
-    def __init__(self, spec: str = "", prereleases: Optional[bool] = None) -> None:
-        super().__init__(spec, prereleases)
-
-        warnings.warn(
-            "Creating a LegacyVersion has been deprecated and will be "
-            "removed in the next major release",
-            DeprecationWarning,
-        )
-
-    def _coerce_version(self, version: UnparsedVersion) -> LegacyVersion:
-        if not isinstance(version, LegacyVersion):
-            version = LegacyVersion(str(version))
-        return version
-
-    def _compare_equal(self, prospective: LegacyVersion, spec: str) -> bool:
-        return prospective == self._coerce_version(spec)
-
-    def _compare_not_equal(self, prospective: LegacyVersion, spec: str) -> bool:
-        return prospective != self._coerce_version(spec)
-
-    def _compare_less_than_equal(self, prospective: LegacyVersion, spec: str) -> bool:
-        return prospective <= self._coerce_version(spec)
-
-    def _compare_greater_than_equal(
-        self, prospective: LegacyVersion, spec: str
-    ) -> bool:
-        return prospective >= self._coerce_version(spec)
-
-    def _compare_less_than(self, prospective: LegacyVersion, spec: str) -> bool:
-        return prospective < self._coerce_version(spec)
-
-    def _compare_greater_than(self, prospective: LegacyVersion, spec: str) -> bool:
-        return prospective > self._coerce_version(spec)
-
-
-def _require_version_compare(
-    fn: Callable[["Specifier", ParsedVersion, str], bool]
-) -> Callable[["Specifier", ParsedVersion, str], bool]:
-    @functools.wraps(fn)
-    def wrapped(self: "Specifier", prospective: ParsedVersion, spec: str) -> bool:
-        if not isinstance(prospective, Version):
-            return False
-        return fn(self, prospective, spec)
-
-    return wrapped
-
-
-class Specifier(_IndividualSpecifier):
-
-    _regex_str = r"""
+    _operator_regex_str = r"""
         (?P<operator>(~=|==|!=|<=|>=|<|>|===))
+        """
+    _version_regex_str = r"""
         (?P<version>
             (?:
                 # The identity operators allow for an escape hatch that will
@@ -309,8 +116,10 @@ class Specifier(_IndividualSpecifier):
                 # but included entirely as an escape hatch.
                 (?<====)  # Only match for the identity operator
                 \s*
-                [^\s]*    # We just match everything, except for whitespace
-                          # since we are only testing for strict identity.
+                [^\s;)]*  # The arbitrary version can be just about anything,
+                          # we match everything except for whitespace, a
+                          # semi-colon for marker support, and a closing paren
+                          # since versions can be enclosed in them.
             )
             |
             (?:
@@ -323,23 +132,23 @@ class Specifier(_IndividualSpecifier):
                 v?
                 (?:[0-9]+!)?          # epoch
                 [0-9]+(?:\.[0-9]+)*   # release
-                (?:                   # pre release
-                    [-_\.]?
-                    (a|b|c|rc|alpha|beta|pre|preview)
-                    [-_\.]?
-                    [0-9]*
-                )?
-                (?:                   # post release
-                    (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*)
-                )?
 
-                # You cannot use a wild card and a dev or local version
-                # together so group them with a | and make them optional.
+                # You cannot use a wild card and a pre-release, post-release, a dev or
+                # local version together so group them with a | and make them optional.
                 (?:
+                    \.\*  # Wild card syntax of .*
+                    |
+                    (?:                                  # pre release
+                        [-_\.]?
+                        (a|b|c|rc|alpha|beta|pre|preview)
+                        [-_\.]?
+                        [0-9]*
+                    )?
+                    (?:                                  # post release
+                        (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*)
+                    )?
                     (?:[-_\.]?dev[-_\.]?[0-9]*)?         # dev release
                     (?:\+[a-z0-9]+(?:[-_\.][a-z0-9]+)*)? # local
-                    |
-                    \.\*  # Wild card syntax of .*
                 )?
             )
             |
@@ -391,7 +200,10 @@ class Specifier(_IndividualSpecifier):
         )
         """
 
-    _regex = re.compile(r"^\s*" + _regex_str + r"\s*$", re.VERBOSE | re.IGNORECASE)
+    _regex = re.compile(
+        r"^\s*" + _operator_regex_str + _version_regex_str + r"\s*$",
+        re.VERBOSE | re.IGNORECASE,
+    )
 
     _operators = {
         "~=": "compatible",
@@ -404,8 +216,152 @@ class Specifier(_IndividualSpecifier):
         "===": "arbitrary",
     }
 
-    @_require_version_compare
-    def _compare_compatible(self, prospective: ParsedVersion, spec: str) -> bool:
+    def __init__(self, spec: str = "", prereleases: Optional[bool] = None) -> None:
+        """Initialize a Specifier instance.
+
+        :param spec:
+            The string representation of a specifier which will be parsed and
+            normalized before use.
+        :param prereleases:
+            This tells the specifier if it should accept prerelease versions if
+            applicable or not. The default of ``None`` will autodetect it from the
+            given specifiers.
+        :raises InvalidSpecifier:
+            If the given specifier is invalid (i.e. bad syntax).
+        """
+        match = self._regex.search(spec)
+        if not match:
+            raise InvalidSpecifier(f"Invalid specifier: '{spec}'")
+
+        self._spec: Tuple[str, str] = (
+            match.group("operator").strip(),
+            match.group("version").strip(),
+        )
+
+        # Store whether or not this Specifier should accept prereleases
+        self._prereleases = prereleases
+
+    @property
+    def prereleases(self) -> bool:
+        # If there is an explicit prereleases set for this, then we'll just
+        # blindly use that.
+        if self._prereleases is not None:
+            return self._prereleases
+
+        # Look at all of our specifiers and determine if they are inclusive
+        # operators, and if they are if they are including an explicit
+        # prerelease.
+        operator, version = self._spec
+        if operator in ["==", ">=", "<=", "~=", "==="]:
+            # The == specifier can include a trailing .*, if it does we
+            # want to remove before parsing.
+            if operator == "==" and version.endswith(".*"):
+                version = version[:-2]
+
+            # Parse the version, and if it is a pre-release than this
+            # specifier allows pre-releases.
+            if Version(version).is_prerelease:
+                return True
+
+        return False
+
+    @prereleases.setter
+    def prereleases(self, value: bool) -> None:
+        self._prereleases = value
+
+    @property
+    def operator(self) -> str:
+        """The operator of this specifier.
+
+        >>> Specifier("==1.2.3").operator
+        '=='
+        """
+        return self._spec[0]
+
+    @property
+    def version(self) -> str:
+        """The version of this specifier.
+
+        >>> Specifier("==1.2.3").version
+        '1.2.3'
+        """
+        return self._spec[1]
+
+    def __repr__(self) -> str:
+        """A representation of the Specifier that shows all internal state.
+
+        >>> Specifier('>=1.0.0')
+        <Specifier('>=1.0.0')>
+        >>> Specifier('>=1.0.0', prereleases=False)
+        <Specifier('>=1.0.0', prereleases=False)>
+        >>> Specifier('>=1.0.0', prereleases=True)
+        <Specifier('>=1.0.0', prereleases=True)>
+        """
+        pre = (
+            f", prereleases={self.prereleases!r}"
+            if self._prereleases is not None
+            else ""
+        )
+
+        return f"<{self.__class__.__name__}({str(self)!r}{pre})>"
+
+    def __str__(self) -> str:
+        """A string representation of the Specifier that can be round-tripped.
+
+        >>> str(Specifier('>=1.0.0'))
+        '>=1.0.0'
+        >>> str(Specifier('>=1.0.0', prereleases=False))
+        '>=1.0.0'
+        """
+        return "{}{}".format(*self._spec)
+
+    @property
+    def _canonical_spec(self) -> Tuple[str, str]:
+        canonical_version = canonicalize_version(
+            self._spec[1],
+            strip_trailing_zero=(self._spec[0] != "~="),
+        )
+        return self._spec[0], canonical_version
+
+    def __hash__(self) -> int:
+        return hash(self._canonical_spec)
+
+    def __eq__(self, other: object) -> bool:
+        """Whether or not the two Specifier-like objects are equal.
+
+        :param other: The other object to check against.
+
+        The value of :attr:`prereleases` is ignored.
+
+        >>> Specifier("==1.2.3") == Specifier("== 1.2.3.0")
+        True
+        >>> (Specifier("==1.2.3", prereleases=False) ==
+        ...  Specifier("==1.2.3", prereleases=True))
+        True
+        >>> Specifier("==1.2.3") == "==1.2.3"
+        True
+        >>> Specifier("==1.2.3") == Specifier("==1.2.4")
+        False
+        >>> Specifier("==1.2.3") == Specifier("~=1.2.3")
+        False
+        """
+        if isinstance(other, str):
+            try:
+                other = self.__class__(str(other))
+            except InvalidSpecifier:
+                return NotImplemented
+        elif not isinstance(other, self.__class__):
+            return NotImplemented
+
+        return self._canonical_spec == other._canonical_spec
+
+    def _get_operator(self, op: str) -> CallableOperator:
+        operator_callable: CallableOperator = getattr(
+            self, f"_compare_{self._operators[op]}"
+        )
+        return operator_callable
+
+    def _compare_compatible(self, prospective: Version, spec: str) -> bool:
 
         # Compatible releases have an equivalent combination of >= and ==. That
         # is that ~=2.2 is equivalent to >=2.2,==2.*. This allows us to
@@ -426,34 +382,33 @@ class Specifier(_IndividualSpecifier):
             prospective, prefix
         )
 
-    @_require_version_compare
-    def _compare_equal(self, prospective: ParsedVersion, spec: str) -> bool:
+    def _compare_equal(self, prospective: Version, spec: str) -> bool:
 
         # We need special logic to handle prefix matching
         if spec.endswith(".*"):
             # In the case of prefix matching we want to ignore local segment.
-            prospective = Version(prospective.public)
+            normalized_prospective = canonicalize_version(prospective.public)
+            # Get the normalized version string ignoring the trailing .*
+            normalized_spec = canonicalize_version(spec[:-2], strip_trailing_zero=False)
             # Split the spec out by dots, and pretend that there is an implicit
             # dot in between a release segment and a pre-release segment.
-            split_spec = _version_split(spec[:-2])  # Remove the trailing .*
+            split_spec = _version_split(normalized_spec)
 
             # Split the prospective version out by dots, and pretend that there
             # is an implicit dot in between a release segment and a pre-release
             # segment.
-            split_prospective = _version_split(str(prospective))
+            split_prospective = _version_split(normalized_prospective)
+
+            # 0-pad the prospective version before shortening it to get the correct
+            # shortened version.
+            padded_prospective, _ = _pad_version(split_prospective, split_spec)
 
             # Shorten the prospective version to be the same length as the spec
             # so that we can determine if the specifier is a prefix of the
             # prospective version or not.
-            shortened_prospective = split_prospective[: len(split_spec)]
+            shortened_prospective = padded_prospective[: len(split_spec)]
 
-            # Pad out our two sides with zeros so that they both equal the same
-            # length.
-            padded_spec, padded_prospective = _pad_version(
-                split_spec, shortened_prospective
-            )
-
-            return padded_prospective == padded_spec
+            return shortened_prospective == split_spec
         else:
             # Convert our spec string into a Version
             spec_version = Version(spec)
@@ -466,30 +421,24 @@ class Specifier(_IndividualSpecifier):
 
             return prospective == spec_version
 
-    @_require_version_compare
-    def _compare_not_equal(self, prospective: ParsedVersion, spec: str) -> bool:
+    def _compare_not_equal(self, prospective: Version, spec: str) -> bool:
         return not self._compare_equal(prospective, spec)
 
-    @_require_version_compare
-    def _compare_less_than_equal(self, prospective: ParsedVersion, spec: str) -> bool:
+    def _compare_less_than_equal(self, prospective: Version, spec: str) -> bool:
 
         # NB: Local version identifiers are NOT permitted in the version
         # specifier, so local version labels can be universally removed from
         # the prospective version.
         return Version(prospective.public) <= Version(spec)
 
-    @_require_version_compare
-    def _compare_greater_than_equal(
-        self, prospective: ParsedVersion, spec: str
-    ) -> bool:
+    def _compare_greater_than_equal(self, prospective: Version, spec: str) -> bool:
 
         # NB: Local version identifiers are NOT permitted in the version
         # specifier, so local version labels can be universally removed from
         # the prospective version.
         return Version(prospective.public) >= Version(spec)
 
-    @_require_version_compare
-    def _compare_less_than(self, prospective: ParsedVersion, spec_str: str) -> bool:
+    def _compare_less_than(self, prospective: Version, spec_str: str) -> bool:
 
         # Convert our spec to a Version instance, since we'll want to work with
         # it as a version.
@@ -514,8 +463,7 @@ class Specifier(_IndividualSpecifier):
         # version in the spec.
         return True
 
-    @_require_version_compare
-    def _compare_greater_than(self, prospective: ParsedVersion, spec_str: str) -> bool:
+    def _compare_greater_than(self, prospective: Version, spec_str: str) -> bool:
 
         # Convert our spec to a Version instance, since we'll want to work with
         # it as a version.
@@ -549,34 +497,133 @@ class Specifier(_IndividualSpecifier):
     def _compare_arbitrary(self, prospective: Version, spec: str) -> bool:
         return str(prospective).lower() == str(spec).lower()
 
-    @property
-    def prereleases(self) -> bool:
+    def __contains__(self, item: Union[str, Version]) -> bool:
+        """Return whether or not the item is contained in this specifier.
 
-        # If there is an explicit prereleases set for this, then we'll just
-        # blindly use that.
-        if self._prereleases is not None:
-            return self._prereleases
+        :param item: The item to check for.
 
-        # Look at all of our specifiers and determine if they are inclusive
-        # operators, and if they are if they are including an explicit
-        # prerelease.
-        operator, version = self._spec
-        if operator in ["==", ">=", "<=", "~=", "==="]:
-            # The == specifier can include a trailing .*, if it does we
-            # want to remove before parsing.
-            if operator == "==" and version.endswith(".*"):
-                version = version[:-2]
+        This is used for the ``in`` operator and behaves the same as
+        :meth:`contains` with no ``prereleases`` argument passed.
 
-            # Parse the version, and if it is a pre-release than this
-            # specifier allows pre-releases.
-            if parse(version).is_prerelease:
-                return True
+        >>> "1.2.3" in Specifier(">=1.2.3")
+        True
+        >>> Version("1.2.3") in Specifier(">=1.2.3")
+        True
+        >>> "1.0.0" in Specifier(">=1.2.3")
+        False
+        >>> "1.3.0a1" in Specifier(">=1.2.3")
+        False
+        >>> "1.3.0a1" in Specifier(">=1.2.3", prereleases=True)
+        True
+        """
+        return self.contains(item)
 
-        return False
+    def contains(
+        self, item: UnparsedVersion, prereleases: Optional[bool] = None
+    ) -> bool:
+        """Return whether or not the item is contained in this specifier.
 
-    @prereleases.setter
-    def prereleases(self, value: bool) -> None:
-        self._prereleases = value
+        :param item:
+            The item to check for, which can be a version string or a
+            :class:`Version` instance.
+        :param prereleases:
+            Whether or not to match prereleases with this Specifier. If set to
+            ``None`` (the default), it uses :attr:`prereleases` to determine
+            whether or not prereleases are allowed.
+
+        >>> Specifier(">=1.2.3").contains("1.2.3")
+        True
+        >>> Specifier(">=1.2.3").contains(Version("1.2.3"))
+        True
+        >>> Specifier(">=1.2.3").contains("1.0.0")
+        False
+        >>> Specifier(">=1.2.3").contains("1.3.0a1")
+        False
+        >>> Specifier(">=1.2.3", prereleases=True).contains("1.3.0a1")
+        True
+        >>> Specifier(">=1.2.3").contains("1.3.0a1", prereleases=True)
+        True
+        """
+
+        # Determine if prereleases are to be allowed or not.
+        if prereleases is None:
+            prereleases = self.prereleases
+
+        # Normalize item to a Version, this allows us to have a shortcut for
+        # "2.0" in Specifier(">=2")
+        normalized_item = _coerce_version(item)
+
+        # Determine if we should be supporting prereleases in this specifier
+        # or not, if we do not support prereleases than we can short circuit
+        # logic if this version is a prereleases.
+        if normalized_item.is_prerelease and not prereleases:
+            return False
+
+        # Actually do the comparison to determine if this item is contained
+        # within this Specifier or not.
+        operator_callable: CallableOperator = self._get_operator(self.operator)
+        return operator_callable(normalized_item, self.version)
+
+    def filter(
+        self, iterable: Iterable[UnparsedVersion], prereleases: Optional[bool] = None
+    ) -> Iterator[UnparsedVersion]:
+        """Filter items in the given iterable, that match the specifier.
+
+        :param iterable:
+            An iterable that can contain version strings and :class:`Version` instances.
+            The items in the iterable will be filtered according to the specifier.
+        :param prereleases:
+            Whether or not to allow prereleases in the returned iterator. If set to
+            ``None`` (the default), it will be intelligently decide whether to allow
+            prereleases or not (based on the :attr:`prereleases` attribute, and
+            whether the only versions matching are prereleases).
+
+        This method is smarter than just ``filter(Specifier().contains, [...])``
+        because it implements the rule from :pep:`440` that a prerelease item
+        SHOULD be accepted if no other versions match the given specifier.
+
+        >>> list(Specifier(">=1.2.3").filter(["1.2", "1.3", "1.5a1"]))
+        ['1.3']
+        >>> list(Specifier(">=1.2.3").filter(["1.2", "1.2.3", "1.3", Version("1.4")]))
+        ['1.2.3', '1.3', <Version('1.4')>]
+        >>> list(Specifier(">=1.2.3").filter(["1.2", "1.5a1"]))
+        ['1.5a1']
+        >>> list(Specifier(">=1.2.3").filter(["1.3", "1.5a1"], prereleases=True))
+        ['1.3', '1.5a1']
+        >>> list(Specifier(">=1.2.3", prereleases=True).filter(["1.3", "1.5a1"]))
+        ['1.3', '1.5a1']
+        """
+
+        yielded = False
+        found_prereleases = []
+
+        kw = {"prereleases": prereleases if prereleases is not None else True}
+
+        # Attempt to iterate over all the values in the iterable and if any of
+        # them match, yield them.
+        for version in iterable:
+            parsed_version = _coerce_version(version)
+
+            if self.contains(parsed_version, **kw):
+                # If our version is a prerelease, and we were not set to allow
+                # prereleases, then we'll store it for later incase nothing
+                # else matches this specifier.
+                if parsed_version.is_prerelease and not (
+                    prereleases or self.prereleases
+                ):
+                    found_prereleases.append(version)
+                # Either this is not a prerelease, or we should have been
+                # accepting prereleases from the beginning.
+                else:
+                    yielded = True
+                    yield version
+
+        # Now that we've iterated over everything, determine if we've yielded
+        # any values, and if we have not and we have any prereleases stored up
+        # then we will go ahead and yield the prereleases.
+        if not yielded and found_prereleases:
+            for version in found_prereleases:
+                yield version
 
 
 _prefix_regex = re.compile(r"^([0-9]+)((?:a|b|c|rc)[0-9]+)$")
@@ -618,22 +665,39 @@ def _pad_version(left: List[str], right: List[str]) -> Tuple[List[str], List[str
 
 
 class SpecifierSet(BaseSpecifier):
+    """This class abstracts handling of a set of version specifiers.
+
+    It can be passed a single specifier (``>=3.0``), a comma-separated list of
+    specifiers (``>=3.0,!=3.1``), or no specifier at all.
+    """
+
     def __init__(
         self, specifiers: str = "", prereleases: Optional[bool] = None
     ) -> None:
+        """Initialize a SpecifierSet instance.
 
-        # Split on , to break each individual specifier into it's own item, and
+        :param specifiers:
+            The string representation of a specifier or a comma-separated list of
+            specifiers which will be parsed and normalized before use.
+        :param prereleases:
+            This tells the SpecifierSet if it should accept prerelease versions if
+            applicable or not. The default of ``None`` will autodetect it from the
+            given specifiers.
+
+        :raises InvalidSpecifier:
+            If the given ``specifiers`` are not parseable than this exception will be
+            raised.
+        """
+
+        # Split on `,` to break each individual specifier into it's own item, and
         # strip each item to remove leading/trailing whitespace.
         split_specifiers = [s.strip() for s in specifiers.split(",") if s.strip()]
 
         # Parsed each individual specifier, attempting first to make it a
-        # Specifier and falling back to a LegacySpecifier.
-        parsed: Set[_IndividualSpecifier] = set()
+        # Specifier.
+        parsed: Set[Specifier] = set()
         for specifier in split_specifiers:
-            try:
-                parsed.add(Specifier(specifier))
-            except InvalidSpecifier:
-                parsed.add(LegacySpecifier(specifier))
+            parsed.add(Specifier(specifier))
 
         # Turn our parsed specifiers into a frozen set and save them for later.
         self._specs = frozenset(parsed)
@@ -642,7 +706,40 @@ class SpecifierSet(BaseSpecifier):
         # we accept prereleases or not.
         self._prereleases = prereleases
 
+    @property
+    def prereleases(self) -> Optional[bool]:
+        # If we have been given an explicit prerelease modifier, then we'll
+        # pass that through here.
+        if self._prereleases is not None:
+            return self._prereleases
+
+        # If we don't have any specifiers, and we don't have a forced value,
+        # then we'll just return None since we don't know if this should have
+        # pre-releases or not.
+        if not self._specs:
+            return None
+
+        # Otherwise we'll see if any of the given specifiers accept
+        # prereleases, if any of them do we'll return True, otherwise False.
+        return any(s.prereleases for s in self._specs)
+
+    @prereleases.setter
+    def prereleases(self, value: bool) -> None:
+        self._prereleases = value
+
     def __repr__(self) -> str:
+        """A representation of the specifier set that shows all internal state.
+
+        Note that the ordering of the individual specifiers within the set may not
+        match the input string.
+
+        >>> SpecifierSet('>=1.0.0,!=2.0.0')
+        <SpecifierSet('!=2.0.0,>=1.0.0')>
+        >>> SpecifierSet('>=1.0.0,!=2.0.0', prereleases=False)
+        <SpecifierSet('!=2.0.0,>=1.0.0', prereleases=False)>
+        >>> SpecifierSet('>=1.0.0,!=2.0.0', prereleases=True)
+        <SpecifierSet('!=2.0.0,>=1.0.0', prereleases=True)>
+        """
         pre = (
             f", prereleases={self.prereleases!r}"
             if self._prereleases is not None
@@ -652,12 +749,31 @@ class SpecifierSet(BaseSpecifier):
         return f"<SpecifierSet({str(self)!r}{pre})>"
 
     def __str__(self) -> str:
+        """A string representation of the specifier set that can be round-tripped.
+
+        Note that the ordering of the individual specifiers within the set may not
+        match the input string.
+
+        >>> str(SpecifierSet(">=1.0.0,!=1.0.1"))
+        '!=1.0.1,>=1.0.0'
+        >>> str(SpecifierSet(">=1.0.0,!=1.0.1", prereleases=False))
+        '!=1.0.1,>=1.0.0'
+        """
         return ",".join(sorted(str(s) for s in self._specs))
 
     def __hash__(self) -> int:
         return hash(self._specs)
 
     def __and__(self, other: Union["SpecifierSet", str]) -> "SpecifierSet":
+        """Return a SpecifierSet which is a combination of the two sets.
+
+        :param other: The other object to combine with.
+
+        >>> SpecifierSet(">=1.0.0,!=1.0.1") & '<=2.0.0,!=2.0.1'
+        <SpecifierSet('!=1.0.1,!=2.0.1,<=2.0.0,>=1.0.0')>
+        >>> SpecifierSet(">=1.0.0,!=1.0.1") & SpecifierSet('<=2.0.0,!=2.0.1')
+        <SpecifierSet('!=1.0.1,!=2.0.1,<=2.0.0,>=1.0.0')>
+        """
         if isinstance(other, str):
             other = SpecifierSet(other)
         elif not isinstance(other, SpecifierSet):
@@ -681,7 +797,25 @@ class SpecifierSet(BaseSpecifier):
         return specifier
 
     def __eq__(self, other: object) -> bool:
-        if isinstance(other, (str, _IndividualSpecifier)):
+        """Whether or not the two SpecifierSet-like objects are equal.
+
+        :param other: The other object to check against.
+
+        The value of :attr:`prereleases` is ignored.
+
+        >>> SpecifierSet(">=1.0.0,!=1.0.1") == SpecifierSet(">=1.0.0,!=1.0.1")
+        True
+        >>> (SpecifierSet(">=1.0.0,!=1.0.1", prereleases=False) ==
+        ...  SpecifierSet(">=1.0.0,!=1.0.1", prereleases=True))
+        True
+        >>> SpecifierSet(">=1.0.0,!=1.0.1") == ">=1.0.0,!=1.0.1"
+        True
+        >>> SpecifierSet(">=1.0.0,!=1.0.1") == SpecifierSet(">=1.0.0")
+        False
+        >>> SpecifierSet(">=1.0.0,!=1.0.1") == SpecifierSet(">=1.0.0,!=1.0.2")
+        False
+        """
+        if isinstance(other, (str, Specifier)):
             other = SpecifierSet(str(other))
         elif not isinstance(other, SpecifierSet):
             return NotImplemented
@@ -689,43 +823,72 @@ class SpecifierSet(BaseSpecifier):
         return self._specs == other._specs
 
     def __len__(self) -> int:
+        """Returns the number of specifiers in this specifier set."""
         return len(self._specs)
 
-    def __iter__(self) -> Iterator[_IndividualSpecifier]:
+    def __iter__(self) -> Iterator[Specifier]:
+        """
+        Returns an iterator over all the underlying :class:`Specifier` instances
+        in this specifier set.
+
+        >>> sorted(SpecifierSet(">=1.0.0,!=1.0.1"), key=str)
+        [<Specifier('!=1.0.1')>, <Specifier('>=1.0.0')>]
+        """
         return iter(self._specs)
 
-    @property
-    def prereleases(self) -> Optional[bool]:
-
-        # If we have been given an explicit prerelease modifier, then we'll
-        # pass that through here.
-        if self._prereleases is not None:
-            return self._prereleases
-
-        # If we don't have any specifiers, and we don't have a forced value,
-        # then we'll just return None since we don't know if this should have
-        # pre-releases or not.
-        if not self._specs:
-            return None
-
-        # Otherwise we'll see if any of the given specifiers accept
-        # prereleases, if any of them do we'll return True, otherwise False.
-        return any(s.prereleases for s in self._specs)
-
-    @prereleases.setter
-    def prereleases(self, value: bool) -> None:
-        self._prereleases = value
-
     def __contains__(self, item: UnparsedVersion) -> bool:
+        """Return whether or not the item is contained in this specifier.
+
+        :param item: The item to check for.
+
+        This is used for the ``in`` operator and behaves the same as
+        :meth:`contains` with no ``prereleases`` argument passed.
+
+        >>> "1.2.3" in SpecifierSet(">=1.0.0,!=1.0.1")
+        True
+        >>> Version("1.2.3") in SpecifierSet(">=1.0.0,!=1.0.1")
+        True
+        >>> "1.0.1" in SpecifierSet(">=1.0.0,!=1.0.1")
+        False
+        >>> "1.3.0a1" in SpecifierSet(">=1.0.0,!=1.0.1")
+        False
+        >>> "1.3.0a1" in SpecifierSet(">=1.0.0,!=1.0.1", prereleases=True)
+        True
+        """
         return self.contains(item)
 
     def contains(
-        self, item: UnparsedVersion, prereleases: Optional[bool] = None
+        self,
+        item: UnparsedVersion,
+        prereleases: Optional[bool] = None,
+        installed: Optional[bool] = None,
     ) -> bool:
+        """Return whether or not the item is contained in this SpecifierSet.
 
-        # Ensure that our item is a Version or LegacyVersion instance.
-        if not isinstance(item, (LegacyVersion, Version)):
-            item = parse(item)
+        :param item:
+            The item to check for, which can be a version string or a
+            :class:`Version` instance.
+        :param prereleases:
+            Whether or not to match prereleases with this SpecifierSet. If set to
+            ``None`` (the default), it uses :attr:`prereleases` to determine
+            whether or not prereleases are allowed.
+
+        >>> SpecifierSet(">=1.0.0,!=1.0.1").contains("1.2.3")
+        True
+        >>> SpecifierSet(">=1.0.0,!=1.0.1").contains(Version("1.2.3"))
+        True
+        >>> SpecifierSet(">=1.0.0,!=1.0.1").contains("1.0.1")
+        False
+        >>> SpecifierSet(">=1.0.0,!=1.0.1").contains("1.3.0a1")
+        False
+        >>> SpecifierSet(">=1.0.0,!=1.0.1", prereleases=True).contains("1.3.0a1")
+        True
+        >>> SpecifierSet(">=1.0.0,!=1.0.1").contains("1.3.0a1", prereleases=True)
+        True
+        """
+        # Ensure that our item is a Version instance.
+        if not isinstance(item, Version):
+            item = Version(item)
 
         # Determine if we're forcing a prerelease or not, if we're not forcing
         # one for this particular filter call, then we'll use whatever the
@@ -742,6 +905,9 @@ class SpecifierSet(BaseSpecifier):
         if not prereleases and item.is_prerelease:
             return False
 
+        if installed and item.is_prerelease:
+            item = Version(item.base_version)
+
         # We simply dispatch to the underlying specs here to make sure that the
         # given version is contained within all of them.
         # Note: This use of all() here means that an empty set of specifiers
@@ -749,9 +915,46 @@ class SpecifierSet(BaseSpecifier):
         return all(s.contains(item, prereleases=prereleases) for s in self._specs)
 
     def filter(
-        self, iterable: Iterable[VersionTypeVar], prereleases: Optional[bool] = None
-    ) -> Iterable[VersionTypeVar]:
+        self, iterable: Iterable[UnparsedVersion], prereleases: Optional[bool] = None
+    ) -> Iterator[UnparsedVersion]:
+        """Filter items in the given iterable, that match the specifiers in this set.
 
+        :param iterable:
+            An iterable that can contain version strings and :class:`Version` instances.
+            The items in the iterable will be filtered according to the specifier.
+        :param prereleases:
+            Whether or not to allow prereleases in the returned iterator. If set to
+            ``None`` (the default), it will be intelligently decide whether to allow
+            prereleases or not (based on the :attr:`prereleases` attribute, and
+            whether the only versions matching are prereleases).
+
+        This method is smarter than just ``filter(SpecifierSet(...).contains, [...])``
+        because it implements the rule from :pep:`440` that a prerelease item
+        SHOULD be accepted if no other versions match the given specifier.
+
+        >>> list(SpecifierSet(">=1.2.3").filter(["1.2", "1.3", "1.5a1"]))
+        ['1.3']
+        >>> list(SpecifierSet(">=1.2.3").filter(["1.2", "1.3", Version("1.4")]))
+        ['1.3', <Version('1.4')>]
+        >>> list(SpecifierSet(">=1.2.3").filter(["1.2", "1.5a1"]))
+        []
+        >>> list(SpecifierSet(">=1.2.3").filter(["1.3", "1.5a1"], prereleases=True))
+        ['1.3', '1.5a1']
+        >>> list(SpecifierSet(">=1.2.3", prereleases=True).filter(["1.3", "1.5a1"]))
+        ['1.3', '1.5a1']
+
+        An "empty" SpecifierSet will filter items based on the presence of prerelease
+        versions in the set.
+
+        >>> list(SpecifierSet("").filter(["1.3", "1.5a1"]))
+        ['1.3']
+        >>> list(SpecifierSet("").filter(["1.5a1"]))
+        ['1.5a1']
+        >>> list(SpecifierSet("", prereleases=True).filter(["1.3", "1.5a1"]))
+        ['1.3', '1.5a1']
+        >>> list(SpecifierSet("").filter(["1.3", "1.5a1"], prereleases=True))
+        ['1.3', '1.5a1']
+        """
         # Determine if we're forcing a prerelease or not, if we're not forcing
         # one for this particular filter call, then we'll use whatever the
         # SpecifierSet thinks for whether or not we should support prereleases.
@@ -764,27 +967,16 @@ class SpecifierSet(BaseSpecifier):
         if self._specs:
             for spec in self._specs:
                 iterable = spec.filter(iterable, prereleases=bool(prereleases))
-            return iterable
+            return iter(iterable)
         # If we do not have any specifiers, then we need to have a rough filter
         # which will filter out any pre-releases, unless there are no final
-        # releases, and which will filter out LegacyVersion in general.
+        # releases.
         else:
-            filtered: List[VersionTypeVar] = []
-            found_prereleases: List[VersionTypeVar] = []
-
-            item: UnparsedVersion
-            parsed_version: Union[Version, LegacyVersion]
+            filtered: List[UnparsedVersion] = []
+            found_prereleases: List[UnparsedVersion] = []
 
             for item in iterable:
-                # Ensure that we some kind of Version class for this item.
-                if not isinstance(item, (LegacyVersion, Version)):
-                    parsed_version = parse(item)
-                else:
-                    parsed_version = item
-
-                # Filter out any item which is parsed as a LegacyVersion
-                if isinstance(parsed_version, LegacyVersion):
-                    continue
+                parsed_version = _coerce_version(item)
 
                 # Store any item which is a pre-release for later unless we've
                 # already found a final version or we are accepting prereleases
@@ -797,6 +989,6 @@ class SpecifierSet(BaseSpecifier):
             # If we've found no items except for pre-releases, then we'll go
             # ahead and use the pre-releases
             if not filtered and found_prereleases and prereleases is None:
-                return found_prereleases
+                return iter(found_prereleases)
 
-            return filtered
+            return iter(filtered)
diff --git a/lib/packaging/tags.py b/lib/packaging/tags.py
index 9a3d25a7..a0e1ea23 100644
--- a/lib/packaging/tags.py
+++ b/lib/packaging/tags.py
@@ -4,6 +4,7 @@
 
 import logging
 import platform
+import subprocess
 import sys
 import sysconfig
 from importlib.machinery import EXTENSION_SUFFIXES
@@ -36,7 +37,7 @@ INTERPRETER_SHORT_NAMES: Dict[str, str] = {
 }
 
 
-_32_BIT_INTERPRETER = sys.maxsize <= 2 ** 32
+_32_BIT_INTERPRETER = sys.maxsize <= 2**32
 
 
 class Tag:
@@ -356,6 +357,22 @@ def mac_platforms(
     version_str, _, cpu_arch = platform.mac_ver()
     if version is None:
         version = cast("MacVersion", tuple(map(int, version_str.split(".")[:2])))
+        if version == (10, 16):
+            # When built against an older macOS SDK, Python will report macOS 10.16
+            # instead of the real version.
+            version_str = subprocess.run(
+                [
+                    sys.executable,
+                    "-sS",
+                    "-c",
+                    "import platform; print(platform.mac_ver()[0])",
+                ],
+                check=True,
+                env={"SYSTEM_VERSION_COMPAT": "0"},
+                stdout=subprocess.PIPE,
+                universal_newlines=True,
+            ).stdout
+            version = cast("MacVersion", tuple(map(int, version_str.split(".")[:2])))
     else:
         version = version
     if arch is None:
@@ -482,6 +499,9 @@ def sys_tags(*, warn: bool = False) -> Iterator[Tag]:
         yield from generic_tags()
 
     if interp_name == "pp":
-        yield from compatible_tags(interpreter="pp3")
+        interp = "pp3"
+    elif interp_name == "cp":
+        interp = "cp" + interpreter_version(warn=warn)
     else:
-        yield from compatible_tags()
+        interp = None
+    yield from compatible_tags(interpreter=interp)
diff --git a/lib/packaging/utils.py b/lib/packaging/utils.py
index bab11b80..33c613b7 100644
--- a/lib/packaging/utils.py
+++ b/lib/packaging/utils.py
@@ -35,7 +35,9 @@ def canonicalize_name(name: str) -> NormalizedName:
     return cast(NormalizedName, value)
 
 
-def canonicalize_version(version: Union[Version, str]) -> str:
+def canonicalize_version(
+    version: Union[Version, str], *, strip_trailing_zero: bool = True
+) -> str:
     """
     This is very similar to Version.__str__, but has one subtle difference
     with the way it handles the release segment.
@@ -56,8 +58,11 @@ def canonicalize_version(version: Union[Version, str]) -> str:
         parts.append(f"{parsed.epoch}!")
 
     # Release segment
-    # NB: This strips trailing '.0's to normalize
-    parts.append(re.sub(r"(\.0)+$", "", ".".join(str(x) for x in parsed.release)))
+    release_segment = ".".join(str(x) for x in parsed.release)
+    if strip_trailing_zero:
+        # NB: This strips trailing '.0's to normalize
+        release_segment = re.sub(r"(\.0)+$", "", release_segment)
+    parts.append(release_segment)
 
     # Pre-release
     if parsed.pre is not None:
diff --git a/lib/packaging/version.py b/lib/packaging/version.py
index de9a09a4..e5c738cf 100644
--- a/lib/packaging/version.py
+++ b/lib/packaging/version.py
@@ -1,16 +1,20 @@
 # This file is dual licensed under the terms of the Apache License, Version
 # 2.0, and the BSD License. See the LICENSE file in the root of this repository
 # for complete details.
+"""
+.. testsetup::
+
+    from packaging.version import parse, Version
+"""
 
 import collections
 import itertools
 import re
-import warnings
-from typing import Callable, Iterator, List, Optional, SupportsInt, Tuple, Union
+from typing import Callable, Optional, SupportsInt, Tuple, Union
 
 from ._structures import Infinity, InfinityType, NegativeInfinity, NegativeInfinityType
 
-__all__ = ["parse", "Version", "LegacyVersion", "InvalidVersion", "VERSION_PATTERN"]
+__all__ = ["VERSION_PATTERN", "parse", "Version", "InvalidVersion"]
 
 InfiniteTypes = Union[InfinityType, NegativeInfinityType]
 PrePostDevType = Union[InfiniteTypes, Tuple[str, int]]
@@ -29,36 +33,37 @@ LocalType = Union[
 CmpKey = Tuple[
     int, Tuple[int, ...], PrePostDevType, PrePostDevType, PrePostDevType, LocalType
 ]
-LegacyCmpKey = Tuple[int, Tuple[str, ...]]
-VersionComparisonMethod = Callable[
-    [Union[CmpKey, LegacyCmpKey], Union[CmpKey, LegacyCmpKey]], bool
-]
+VersionComparisonMethod = Callable[[CmpKey, CmpKey], bool]
 
 _Version = collections.namedtuple(
     "_Version", ["epoch", "release", "dev", "pre", "post", "local"]
 )
 
 
-def parse(version: str) -> Union["LegacyVersion", "Version"]:
+def parse(version: str) -> "Version":
+    """Parse the given version string.
+
+    >>> parse('1.0.dev1')
+    <Version('1.0.dev1')>
+
+    :param version: The version string to parse.
+    :raises InvalidVersion: When the version string is not a valid version.
     """
-    Parse the given version string and return either a :class:`Version` object
-    or a :class:`LegacyVersion` object depending on if the given version is
-    a valid PEP 440 version or a legacy version.
-    """
-    try:
-        return Version(version)
-    except InvalidVersion:
-        return LegacyVersion(version)
+    return Version(version)
 
 
 class InvalidVersion(ValueError):
-    """
-    An invalid version was found, users should refer to PEP 440.
+    """Raised when a version string is not a valid version.
+
+    >>> Version("invalid")
+    Traceback (most recent call last):
+        ...
+    packaging.version.InvalidVersion: Invalid version: 'invalid'
     """
 
 
 class _BaseVersion:
-    _key: Union[CmpKey, LegacyCmpKey]
+    _key: CmpKey
 
     def __hash__(self) -> int:
         return hash(self._key)
@@ -103,126 +108,9 @@ class _BaseVersion:
         return self._key != other._key
 
 
-class LegacyVersion(_BaseVersion):
-    def __init__(self, version: str) -> None:
-        self._version = str(version)
-        self._key = _legacy_cmpkey(self._version)
-
-        warnings.warn(
-            "Creating a LegacyVersion has been deprecated and will be "
-            "removed in the next major release",
-            DeprecationWarning,
-        )
-
-    def __str__(self) -> str:
-        return self._version
-
-    def __repr__(self) -> str:
-        return f"<LegacyVersion('{self}')>"
-
-    @property
-    def public(self) -> str:
-        return self._version
-
-    @property
-    def base_version(self) -> str:
-        return self._version
-
-    @property
-    def epoch(self) -> int:
-        return -1
-
-    @property
-    def release(self) -> None:
-        return None
-
-    @property
-    def pre(self) -> None:
-        return None
-
-    @property
-    def post(self) -> None:
-        return None
-
-    @property
-    def dev(self) -> None:
-        return None
-
-    @property
-    def local(self) -> None:
-        return None
-
-    @property
-    def is_prerelease(self) -> bool:
-        return False
-
-    @property
-    def is_postrelease(self) -> bool:
-        return False
-
-    @property
-    def is_devrelease(self) -> bool:
-        return False
-
-
-_legacy_version_component_re = re.compile(r"(\d+ | [a-z]+ | \.| -)", re.VERBOSE)
-
-_legacy_version_replacement_map = {
-    "pre": "c",
-    "preview": "c",
-    "-": "final-",
-    "rc": "c",
-    "dev": "@",
-}
-
-
-def _parse_version_parts(s: str) -> Iterator[str]:
-    for part in _legacy_version_component_re.split(s):
-        part = _legacy_version_replacement_map.get(part, part)
-
-        if not part or part == ".":
-            continue
-
-        if part[:1] in "0123456789":
-            # pad for numeric comparison
-            yield part.zfill(8)
-        else:
-            yield "*" + part
-
-    # ensure that alpha/beta/candidate are before final
-    yield "*final"
-
-
-def _legacy_cmpkey(version: str) -> LegacyCmpKey:
-
-    # We hardcode an epoch of -1 here. A PEP 440 version can only have a epoch
-    # greater than or equal to 0. This will effectively put the LegacyVersion,
-    # which uses the defacto standard originally implemented by setuptools,
-    # as before all PEP 440 versions.
-    epoch = -1
-
-    # This scheme is taken from pkg_resources.parse_version setuptools prior to
-    # it's adoption of the packaging library.
-    parts: List[str] = []
-    for part in _parse_version_parts(version.lower()):
-        if part.startswith("*"):
-            # remove "-" before a prerelease tag
-            if part < "*final":
-                while parts and parts[-1] == "*final-":
-                    parts.pop()
-
-            # remove trailing zeros from each series of numeric parts
-            while parts and parts[-1] == "00000000":
-                parts.pop()
-
-        parts.append(part)
-
-    return epoch, tuple(parts)
-
-
 # Deliberately not anchored to the start and end of the string, to make it
 # easier for 3rd party code to reuse
-VERSION_PATTERN = r"""
+_VERSION_PATTERN = r"""
     v?
     (?:
         (?:(?P<epoch>[0-9]+)!)?                           # epoch
@@ -253,12 +141,55 @@ VERSION_PATTERN = r"""
     (?:\+(?P<local>[a-z0-9]+(?:[-_\.][a-z0-9]+)*))?       # local version
 """
 
+VERSION_PATTERN = _VERSION_PATTERN
+"""
+A string containing the regular expression used to match a valid version.
+
+The pattern is not anchored at either end, and is intended for embedding in larger
+expressions (for example, matching a version number as part of a file name). The
+regular expression should be compiled with the ``re.VERBOSE`` and ``re.IGNORECASE``
+flags set.
+
+:meta hide-value:
+"""
+
 
 class Version(_BaseVersion):
+    """This class abstracts handling of a project's versions.
+
+    A :class:`Version` instance is comparison aware and can be compared and
+    sorted using the standard Python interfaces.
+
+    >>> v1 = Version("1.0a5")
+    >>> v2 = Version("1.0")
+    >>> v1
+    <Version('1.0a5')>
+    >>> v2
+    <Version('1.0')>
+    >>> v1 < v2
+    True
+    >>> v1 == v2
+    False
+    >>> v1 > v2
+    False
+    >>> v1 >= v2
+    False
+    >>> v1 <= v2
+    True
+    """
 
     _regex = re.compile(r"^\s*" + VERSION_PATTERN + r"\s*$", re.VERBOSE | re.IGNORECASE)
 
     def __init__(self, version: str) -> None:
+        """Initialize a Version object.
+
+        :param version:
+            The string representation of a version which will be parsed and normalized
+            before use.
+        :raises InvalidVersion:
+            If the ``version`` does not conform to PEP 440 in any way then this
+            exception will be raised.
+        """
 
         # Validate the version and parse it into pieces
         match = self._regex.search(version)
@@ -288,9 +219,19 @@ class Version(_BaseVersion):
         )
 
     def __repr__(self) -> str:
+        """A representation of the Version that shows all internal state.
+
+        >>> Version('1.0.0')
+        <Version('1.0.0')>
+        """
         return f"<Version('{self}')>"
 
     def __str__(self) -> str:
+        """A string representation of the version that can be rounded-tripped.
+
+        >>> str(Version("1.0a5"))
+        '1.0a5'
+        """
         parts = []
 
         # Epoch
@@ -320,29 +261,80 @@ class Version(_BaseVersion):
 
     @property
     def epoch(self) -> int:
+        """The epoch of the version.
+
+        >>> Version("2.0.0").epoch
+        0
+        >>> Version("1!2.0.0").epoch
+        1
+        """
         _epoch: int = self._version.epoch
         return _epoch
 
     @property
     def release(self) -> Tuple[int, ...]:
+        """The components of the "release" segment of the version.
+
+        >>> Version("1.2.3").release
+        (1, 2, 3)
+        >>> Version("2.0.0").release
+        (2, 0, 0)
+        >>> Version("1!2.0.0.post0").release
+        (2, 0, 0)
+
+        Includes trailing zeroes but not the epoch or any pre-release / development /
+        post-release suffixes.
+        """
         _release: Tuple[int, ...] = self._version.release
         return _release
 
     @property
     def pre(self) -> Optional[Tuple[str, int]]:
+        """The pre-release segment of the version.
+
+        >>> print(Version("1.2.3").pre)
+        None
+        >>> Version("1.2.3a1").pre
+        ('a', 1)
+        >>> Version("1.2.3b1").pre
+        ('b', 1)
+        >>> Version("1.2.3rc1").pre
+        ('rc', 1)
+        """
         _pre: Optional[Tuple[str, int]] = self._version.pre
         return _pre
 
     @property
     def post(self) -> Optional[int]:
+        """The post-release number of the version.
+
+        >>> print(Version("1.2.3").post)
+        None
+        >>> Version("1.2.3.post1").post
+        1
+        """
         return self._version.post[1] if self._version.post else None
 
     @property
     def dev(self) -> Optional[int]:
+        """The development number of the version.
+
+        >>> print(Version("1.2.3").dev)
+        None
+        >>> Version("1.2.3.dev1").dev
+        1
+        """
         return self._version.dev[1] if self._version.dev else None
 
     @property
     def local(self) -> Optional[str]:
+        """The local version segment of the version.
+
+        >>> print(Version("1.2.3").local)
+        None
+        >>> Version("1.2.3+abc").local
+        'abc'
+        """
         if self._version.local:
             return ".".join(str(x) for x in self._version.local)
         else:
@@ -350,10 +342,31 @@ class Version(_BaseVersion):
 
     @property
     def public(self) -> str:
+        """The public portion of the version.
+
+        >>> Version("1.2.3").public
+        '1.2.3'
+        >>> Version("1.2.3+abc").public
+        '1.2.3'
+        >>> Version("1.2.3+abc.dev1").public
+        '1.2.3'
+        """
         return str(self).split("+", 1)[0]
 
     @property
     def base_version(self) -> str:
+        """The "base version" of the version.
+
+        >>> Version("1.2.3").base_version
+        '1.2.3'
+        >>> Version("1.2.3+abc").base_version
+        '1.2.3'
+        >>> Version("1!1.2.3+abc.dev1").base_version
+        '1!1.2.3'
+
+        The "base version" is the public version of the project without any pre or post
+        release markers.
+        """
         parts = []
 
         # Epoch
@@ -367,26 +380,72 @@ class Version(_BaseVersion):
 
     @property
     def is_prerelease(self) -> bool:
+        """Whether this version is a pre-release.
+
+        >>> Version("1.2.3").is_prerelease
+        False
+        >>> Version("1.2.3a1").is_prerelease
+        True
+        >>> Version("1.2.3b1").is_prerelease
+        True
+        >>> Version("1.2.3rc1").is_prerelease
+        True
+        >>> Version("1.2.3dev1").is_prerelease
+        True
+        """
         return self.dev is not None or self.pre is not None
 
     @property
     def is_postrelease(self) -> bool:
+        """Whether this version is a post-release.
+
+        >>> Version("1.2.3").is_postrelease
+        False
+        >>> Version("1.2.3.post1").is_postrelease
+        True
+        """
         return self.post is not None
 
     @property
     def is_devrelease(self) -> bool:
+        """Whether this version is a development release.
+
+        >>> Version("1.2.3").is_devrelease
+        False
+        >>> Version("1.2.3.dev1").is_devrelease
+        True
+        """
         return self.dev is not None
 
     @property
     def major(self) -> int:
+        """The first item of :attr:`release` or ``0`` if unavailable.
+
+        >>> Version("1.2.3").major
+        1
+        """
         return self.release[0] if len(self.release) >= 1 else 0
 
     @property
     def minor(self) -> int:
+        """The second item of :attr:`release` or ``0`` if unavailable.
+
+        >>> Version("1.2.3").minor
+        2
+        >>> Version("1").minor
+        0
+        """
         return self.release[1] if len(self.release) >= 2 else 0
 
     @property
     def micro(self) -> int:
+        """The third item of :attr:`release` or ``0`` if unavailable.
+
+        >>> Version("1.2.3").micro
+        3
+        >>> Version("1").micro
+        0
+        """
         return self.release[2] if len(self.release) >= 3 else 0
 
 
diff --git a/requirements.txt b/requirements.txt
index e31185a6..cffb49c5 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -25,7 +25,7 @@ IPy==1.01
 Mako==1.2.4
 MarkupSafe==2.1.1
 musicbrainzngs==0.7.1
-packaging==21.3
+packaging==22.0
 paho-mqtt==1.6.1
 plexapi==4.13.1
 portend==3.1.0

From 8159bf456c3ea05a666beb345bc85ba7984c3e81 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 21 Dec 2022 16:02:25 -0800
Subject: [PATCH 262/743] Bump importlib-metadata from 5.0.0 to 5.2.0 (#1932)

* Bump importlib-metadata from 5.0.0 to 5.2.0

Bumps [importlib-metadata](https://github.com/python/importlib_metadata) from 5.0.0 to 5.2.0.
- [Release notes](https://github.com/python/importlib_metadata/releases)
- [Changelog](https://github.com/python/importlib_metadata/blob/main/CHANGES.rst)
- [Commits](https://github.com/python/importlib_metadata/compare/v5.0.0...v5.2.0)

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

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

* Update importlib-metadata==5.2.0

Signed-off-by: dependabot[bot] <support@github.com>
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/importlib_metadata/__init__.py    |  4 ++--
 lib/importlib_metadata/_adapters.py   | 22 ++++++++++++++++++++++
 lib/importlib_metadata/_meta.py       |  9 +++++----
 lib/importlib_metadata/_py39compat.py | 21 ++++-----------------
 package/requirements-package.txt      |  2 +-
 requirements.txt                      |  2 +-
 6 files changed, 35 insertions(+), 25 deletions(-)

diff --git a/lib/importlib_metadata/__init__.py b/lib/importlib_metadata/__init__.py
index 304b6d48..26a1388c 100644
--- a/lib/importlib_metadata/__init__.py
+++ b/lib/importlib_metadata/__init__.py
@@ -139,6 +139,7 @@ class DeprecatedTuple:
     1
     """
 
+    # Do not remove prior to 2023-05-01 or Python 3.13
     _warn = functools.partial(
         warnings.warn,
         "EntryPoint tuple interface is deprecated. Access members by name.",
@@ -293,8 +294,7 @@ class EntryPoints(tuple):
         Select entry points from self that match the
         given parameters (typically group and/or name).
         """
-        candidates = (_py39compat.ep_matches(ep, **params) for ep in self)
-        return EntryPoints(ep for ep, predicate in candidates if predicate)
+        return EntryPoints(ep for ep in self if _py39compat.ep_matches(ep, **params))
 
     @property
     def names(self):
diff --git a/lib/importlib_metadata/_adapters.py b/lib/importlib_metadata/_adapters.py
index aa460d3e..e33cba5e 100644
--- a/lib/importlib_metadata/_adapters.py
+++ b/lib/importlib_metadata/_adapters.py
@@ -1,8 +1,20 @@
+import functools
+import warnings
 import re
 import textwrap
 import email.message
 
 from ._text import FoldedCase
+from ._compat import pypy_partial
+
+
+# Do not remove prior to 2024-01-01 or Python 3.14
+_warn = functools.partial(
+    warnings.warn,
+    "Implicit None on return values is deprecated and will raise KeyErrors.",
+    DeprecationWarning,
+    stacklevel=pypy_partial(2),
+)
 
 
 class Message(email.message.Message):
@@ -39,6 +51,16 @@ class Message(email.message.Message):
     def __iter__(self):
         return super().__iter__()
 
+    def __getitem__(self, item):
+        """
+        Warn users that a ``KeyError`` can be expected when a
+        mising key is supplied. Ref python/importlib_metadata#371.
+        """
+        res = super().__getitem__(item)
+        if res is None:
+            _warn()
+        return res
+
     def _repair_headers(self):
         def redent(value):
             "Correct for RFC822 indentation"
diff --git a/lib/importlib_metadata/_meta.py b/lib/importlib_metadata/_meta.py
index 37ee43e6..259b15ba 100644
--- a/lib/importlib_metadata/_meta.py
+++ b/lib/importlib_metadata/_meta.py
@@ -30,18 +30,19 @@ class PackageMetadata(Protocol):
         """
 
 
-class SimplePath(Protocol):
+class SimplePath(Protocol[_T]):
     """
     A minimal subset of pathlib.Path required by PathDistribution.
     """
 
-    def joinpath(self) -> 'SimplePath':
+    def joinpath(self) -> _T:
         ...  # pragma: no cover
 
-    def __truediv__(self) -> 'SimplePath':
+    def __truediv__(self, other: Union[str, _T]) -> _T:
         ...  # pragma: no cover
 
-    def parent(self) -> 'SimplePath':
+    @property
+    def parent(self) -> _T:
         ...  # pragma: no cover
 
     def read_text(self) -> str:
diff --git a/lib/importlib_metadata/_py39compat.py b/lib/importlib_metadata/_py39compat.py
index cf9cc124..cde4558f 100644
--- a/lib/importlib_metadata/_py39compat.py
+++ b/lib/importlib_metadata/_py39compat.py
@@ -1,7 +1,7 @@
 """
 Compatibility layer with Python 3.8/3.9
 """
-from typing import TYPE_CHECKING, Any, Optional, Tuple
+from typing import TYPE_CHECKING, Any, Optional
 
 if TYPE_CHECKING:  # pragma: no cover
     # Prevent circular imports on runtime.
@@ -22,27 +22,14 @@ def normalized_name(dist: Distribution) -> Optional[str]:
         return Prepared.normalize(getattr(dist, "name", None) or dist.metadata['Name'])
 
 
-def ep_matches(ep: EntryPoint, **params) -> Tuple[EntryPoint, bool]:
+def ep_matches(ep: EntryPoint, **params) -> bool:
     """
     Workaround for ``EntryPoint`` objects without the ``matches`` method.
-    For the sake of convenience, a tuple is returned containing not only the
-    boolean value corresponding to the predicate evalutation, but also a compatible
-    ``EntryPoint`` object that can be safely used at a later stage.
-
-    For example, the following sequences of expressions should be compatible:
-
-        # Sequence 1: using the compatibility layer
-        candidates = (_py39compat.ep_matches(ep, **params) for ep in entry_points)
-        [ep for ep, predicate in candidates if predicate]
-
-        # Sequence 2: using Python 3.9+
-        [ep for ep in entry_points if ep.matches(**params)]
     """
     try:
-        return ep, ep.matches(**params)
+        return ep.matches(**params)
     except AttributeError:
         from . import EntryPoint  # -> delay to prevent circular imports.
 
         # Reconstruct the EntryPoint object to make sure it is compatible.
-        _ep = EntryPoint(ep.name, ep.value, ep.group)
-        return _ep, _ep.matches(**params)
+        return EntryPoint(ep.name, ep.value, ep.group).matches(**params)
diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index 6260d288..82782772 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -1,5 +1,5 @@
 apscheduler==3.9.1.post1
-importlib-metadata==5.0.0
+importlib-metadata==5.2.0
 importlib-resources==5.10.1
 pyinstaller==5.6.2
 pyopenssl==22.1.0
diff --git a/requirements.txt b/requirements.txt
index cffb49c5..4fc06668 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -18,7 +18,7 @@ gntp==1.0.3
 html5lib==1.1
 httpagentparser==1.9.5
 idna==3.4
-importlib-metadata==5.0.0
+importlib-metadata==5.2.0
 importlib-resources==5.10.1
 git+https://github.com/Tautulli/ipwhois.git@master#egg=ipwhois
 IPy==1.01

From 4398ece2daafe28db966509d510186788e5acb88 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 21 Dec 2022 16:02:40 -0800
Subject: [PATCH 263/743] Bump pytz from 2022.6 to 2022.7 (#1934)

* Bump pytz from 2022.6 to 2022.7

Bumps [pytz](https://github.com/stub42/pytz) from 2022.6 to 2022.7.
- [Release notes](https://github.com/stub42/pytz/releases)
- [Commits](https://github.com/stub42/pytz/compare/release_2022.6...release_2022.7)

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

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

* Update pytz==2022.7

Signed-off-by: dependabot[bot] <support@github.com>
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/pytz/__init__.py                    |  15 ++++----
 lib/pytz/zoneinfo/America/Bogota        | Bin 232 -> 232 bytes
 lib/pytz/zoneinfo/America/Cambridge_Bay | Bin 2084 -> 2254 bytes
 lib/pytz/zoneinfo/America/Ciudad_Juarez | Bin 0 -> 1538 bytes
 lib/pytz/zoneinfo/America/Godthab       | Bin 1864 -> 1448 bytes
 lib/pytz/zoneinfo/America/Inuvik        | Bin 1894 -> 2074 bytes
 lib/pytz/zoneinfo/America/Iqaluit       | Bin 2032 -> 2202 bytes
 lib/pytz/zoneinfo/America/Nuuk          | Bin 1864 -> 1448 bytes
 lib/pytz/zoneinfo/America/Ojinaga       | Bin 1102 -> 1524 bytes
 lib/pytz/zoneinfo/America/Pangnirtung   | Bin 2094 -> 2202 bytes
 lib/pytz/zoneinfo/America/Rankin_Inlet  | Bin 1892 -> 2066 bytes
 lib/pytz/zoneinfo/America/Resolute      | Bin 1892 -> 2066 bytes
 lib/pytz/zoneinfo/America/Whitehorse    | Bin 1614 -> 1614 bytes
 lib/pytz/zoneinfo/America/Yellowknife   | Bin 1966 -> 2136 bytes
 lib/pytz/zoneinfo/Asia/Kuala_Lumpur     | Bin 369 -> 401 bytes
 lib/pytz/zoneinfo/Asia/Singapore        | Bin 369 -> 401 bytes
 lib/pytz/zoneinfo/Canada/Yukon          | Bin 1614 -> 1614 bytes
 lib/pytz/zoneinfo/Singapore             | Bin 369 -> 401 bytes
 lib/pytz/zoneinfo/iso3166.tab           |   6 ++--
 lib/pytz/zoneinfo/tzdata.zi             |  45 +++++++++++++++---------
 lib/pytz/zoneinfo/zone.tab              |  26 +++++++-------
 lib/pytz/zoneinfo/zone1970.tab          |  26 +++++++-------
 requirements.txt                        |   2 +-
 23 files changed, 67 insertions(+), 53 deletions(-)
 create mode 100644 lib/pytz/zoneinfo/America/Ciudad_Juarez

diff --git a/lib/pytz/__init__.py b/lib/pytz/__init__.py
index 2e4dc394..4fdc9a7e 100644
--- a/lib/pytz/__init__.py
+++ b/lib/pytz/__init__.py
@@ -22,8 +22,8 @@ from pytz.tzfile import build_tzinfo
 
 
 # The IANA (nee Olson) database is updated several times a year.
-OLSON_VERSION = '2022f'
-VERSION = '2022.6'  # pip compatible version number.
+OLSON_VERSION = '2022g'
+VERSION = '2022.7'  # pip compatible version number.
 __version__ = VERSION
 
 OLSEN_VERSION = OLSON_VERSION  # Old releases had this misspelling
@@ -202,7 +202,9 @@ def _case_insensitive_zone_lookup(zone):
     """case-insensitively matching timezone, else return zone unchanged"""
     global _all_timezones_lower_to_standard
     if _all_timezones_lower_to_standard is None:
-        _all_timezones_lower_to_standard = dict((tz.lower(), tz) for tz in all_timezones)  # noqa
+        global _all_timezones_unchecked
+        _all_timezones_lower_to_standard = dict((tz.lower(), tz) for tz in _all_timezones_unchecked)  # noqa
+        del _all_timezones_unchecked
     return _all_timezones_lower_to_standard.get(zone.lower()) or zone  # noqa
 
 
@@ -514,7 +516,7 @@ def _test():
 
 if __name__ == '__main__':
     _test()
-all_timezones = \
+_all_timezones_unchecked = \
 ['Africa/Abidjan',
  'Africa/Accra',
  'Africa/Addis_Ababa',
@@ -610,6 +612,7 @@ all_timezones = \
  'America/Cayman',
  'America/Chicago',
  'America/Chihuahua',
+ 'America/Ciudad_Juarez',
  'America/Coral_Harbour',
  'America/Cordoba',
  'America/Costa_Rica',
@@ -1111,7 +1114,7 @@ all_timezones = \
  'WET',
  'Zulu']
 all_timezones = LazyList(
-        tz for tz in all_timezones if resource_exists(tz))
+        tz for tz in _all_timezones_unchecked if resource_exists(tz))
         
 all_timezones_set = LazySet(all_timezones)
 common_timezones = \
@@ -1204,6 +1207,7 @@ common_timezones = \
  'America/Cayman',
  'America/Chicago',
  'America/Chihuahua',
+ 'America/Ciudad_Juarez',
  'America/Costa_Rica',
  'America/Creston',
  'America/Cuiaba',
@@ -1275,7 +1279,6 @@ common_timezones = \
  'America/Nuuk',
  'America/Ojinaga',
  'America/Panama',
- 'America/Pangnirtung',
  'America/Paramaribo',
  'America/Phoenix',
  'America/Port-au-Prince',
diff --git a/lib/pytz/zoneinfo/America/Bogota b/lib/pytz/zoneinfo/America/Bogota
index c274baee5f2212756cb10a477d90b1aedda1468b..331a1b7c4c3af257841900fe076e5393e15db100 100644
GIT binary patch
delta 21
ZcmaFC_=0hQB~wY~MC&pzsXOrj2LN3p2u=V1

delta 21
ZcmaFC_=0hQCDXpxiPmLcQg`A54gg>f2#Npz

diff --git a/lib/pytz/zoneinfo/America/Cambridge_Bay b/lib/pytz/zoneinfo/America/Cambridge_Bay
index f8db4b6ebf5b66d3d566fc3975d6151783f6e645..7e58a203c6bdc9045092f879f8f58aa960084cad 100644
GIT binary patch
delta 662
zcmdVWze~eF7{>AUn&wAiwQsdGsTK^n*v(aNa8Yq{brA|W2oA1JIqZ~04sLQwii;GA
z;?$|xMTKq-ihqEEh?_#p<J_s6Z#cd$AxGeI#gA3xg)R}{V50nB50cLZc^{S4Xyxm4
z)b^>^ZYXo_M_QZT%3gbwPVk~ioJyC5%KhldskcOxpNBM^cGS!up~`j4eA%IDbk4J9
zM>KbQ$hG|)s_$;|{CbPL)++nUTe4BQJxE1ZG$wc~)3zqKHs)7&r7!HoW-k_;WrG`0
z%d%cfK6Ywi7p$KOzJ4z(I091nD6c-&PHz}Nh!22<0uBWp3P2QyC?HW_{xt_hfr<ha
e16&lq7$Bp7#sC}5!3Eu&7=7bk!3v>GXXzK7^>jc0

delta 503
zcmX>nxI|!rxGpyX0|N+yKs6A9*s2RZoozVX$ur@S@|S{3i4qLo^`i=YXtaLVSaXZ9
zo|Ty>$j-*WPLx8Ti~~83f#LuE)eDRmSwIvc$N&FxCou5*|G#qsqX1Y$6wH<cu^D7R
zYz9S$_+)-&2}YO66FB6!7#JZYF)&OJ7scxL$)(H+K=c0p2YDJqgFL=jlw}?BkoGw<
L(C3rabI1b#@*Zmj

diff --git a/lib/pytz/zoneinfo/America/Ciudad_Juarez b/lib/pytz/zoneinfo/America/Ciudad_Juarez
new file mode 100644
index 0000000000000000000000000000000000000000..eb1e53961c1ebe1e147dd42248753ad30817a349
GIT binary patch
literal 1538
zcmdUuOGs2v0EW-#h$5z!C<v4Y3WV^{jQPwg(=yY^(#a+@o$|$G>69{9`8bd$tvrQD
z;DdssMT8<^Mqn%373Lx=$b#%a6lf3$rqlUuxC#Q7{f9H(<-%n)-{&mx)Y!#e3)XMA
ztW;l~Hw}${_6~oqe>YxJ?0%Rv<DLjha!;&uF4$^)!rmC-O~`SH-GyJgiP49RB>QWb
z9K6#=iTo*2K7|>n%dbS*kBw^2_zRIf5~}t-9uOJbU)8?8cCo+VxytP5lLrb$R9021
z%#OdQ4rW)#LlI3XXGf;YS-N55TDQyG*+%2Ye2~oRA5!@*%cP^FOC250kOgHPb*y)r
zJf5DX3Vi{xC@NMtPs~f_uLxC~_*52uh%sDS-wW4NxN&NAN|fAPFiPj{iL#Cv<MiZp
zQC>A>R1DS$w_{qJ>FSbaV@FkGdAz9XTy$4$=uy=<d9wPOPt``p%Gzfx<q3|Eo(E~_
z+{Z;(*L%`9KOHVE_)?Af;RVr99BFvFXT-(C72{IFm}uPm)@Ul|6-}$l%9k=KeRFSA
z^OhdjJo!XjUh>H+gLl-`S(j{SyQW$v(qvnCwQ9c=B`pEgKx;sdK7smSU579Kb^QMR
z7$N-r0VS+{|NYw{gkMY8+M7os7UR#Ge1}swiku=#Uq`m4zQTeNYjCbZAHN<7K{SG>
z1knkilu4}>|AJZ!y&#G)G=r!H(G8*;L_3pOJ&1k`1tA(TRD|frP!gggLrsXD5Je%H
zLR5w53Q-oKtx2seL|>CyVTi^Ml_5Gql!j;xQ5&K+L~)4b5Y-{No7Bofv^S~Mhv;uo
zCjiNSkpd(KMiP)L7->NAU?c*`1d<9Q7n3>}NH&mkOzM0f37OOxK~gfQbAluV$qJGd
zBQHo|jLaaZF>-?>$H)$no=Ke_BterpLr97yb&ilEAz4DwgyacH6p|_Yk5UcQB`52O
UV;l)__PAX!4x25`7Pl+(H}^J_J^%m!

literal 0
HcmV?d00001

diff --git a/lib/pytz/zoneinfo/America/Godthab b/lib/pytz/zoneinfo/America/Godthab
index 0d2149cc0033785b517624400583fb9edf2ff2ec..883dfa055532c8319a833d80c82707b3ca5d4d5a 100644
GIT binary patch
delta 232
zcmX@Xw}M+EBq}q_hyeqz0YyL<1R{W#ZKFmC<0Pi=RM!9h&o?kI{QrOT0s{+-eEfis
v<Ntpc$-v>`8^WM#U<||{qZt{21ehe&vdtHnjxYgjbEU{OE*qfzc1BzPtvo$f

delta 614
zcmbWzJxBs!9LMqJF$FP@ry-hp86AAN^KetQAfg*WX{g3JHG9)iw6|-Druf4R;Sen$
zPEtfuTSz#SOG85twKPRrG{p7%&YD`H=Xjp)!@<G*KaJkDKaifz85;YwJn{`TR!MHp
zSzwNv^NA)I-V4eM5@lWvDf?NZT)RpO4{6FbW@z!cAeQzMv|LY#mFzIB?!`o5GA@e7
zfLK$9#QNxmDD^Q>j`UOc?MYPp?^NluMD_KaHcsne^X8JaYFD(~JffZI37H2baks1I
z`>|?#+&bnXv$lP^%b0E7b(s6-e17C!+r~Mer&&nR<c`We=e&FTb<p!MSIcF}Zy2UU
zF)@m%oyy5kOpihUg#ro*6dEW*P^h4gL7{^}2!#?VrSi@NTzCO86l_i<9ST0Dk`M(W
w3Q825C`eJTqM${)ycY2kRHy!<>WfS1q$ba3GN^0eSXhaKqCs6%x>wcr1*mzd#Q*>R

diff --git a/lib/pytz/zoneinfo/America/Inuvik b/lib/pytz/zoneinfo/America/Inuvik
index 87bb355295a3efcacd4baecb5a8bfa3fb9ce9c54..04c2df456ff0f879a419331dc3e9f4d4f68f0ecd 100644
GIT binary patch
delta 362
zcmbV{u@1pd6ozkGZK>jFJV28UCP`zKhzB4%g2CbqOe_YI+jOc#auW-YsK#XT0xTw*
z$->|buKRajcWzF;o0FWJ?|&2*lzHtbAw-v5xf`8HreEcH&tgU^$4&pmvhI`T=!IG2
z%&qsH<?k`KZ)aLK1-y8SX=$@_X%x`%jJeKeK$6B)u@&|A!o(Pcu4;Sof-E7HOvwl_
zpO7s6#1>-96<YIs(hb*Yef-rCvY>=DXn{}zp$9?{geC}85V|R)G6-!D>LBz%L;w*3
Wq>&S(1LVN~nGTw^(*6(CG^-!$_hNYf

delta 173
zcmbOw@QiPQvSbAV0|P4%i#}lUYxu68(eOiK3WH$h1ci+Sml-D~vgc1OU}u|rft^EU
z^#Vqg|Nr|N7&!m`pF4qp_y2#Oh@h^40YiYx<QGgvnsB530|Cf55DhXCM1zb40g%y~
OS2HhWCf@AN?CJn&;zZ8?

diff --git a/lib/pytz/zoneinfo/America/Iqaluit b/lib/pytz/zoneinfo/America/Iqaluit
index c8138bdbb3cf141ad42ace037e144bee98d81481..0b47b9032f11d4ea7dd6ac51aa329f7a98253638 100644
GIT binary patch
delta 761
zcmeysKTB|ecp@hQ0|N+yKsykF*fM8w7B*Z`{!(x$;r9cUguex>0S^+`9PSse8yrgD
zP&in?DX=7gi(zpA*N3(Q?gy;}JU16T;60FDz_+vI0sqS84+1mO9td`(eh{kkc(Bpo
z0%JW3BNH=ukd=)*eJHweV3vb?$-wac|M3HiEdT%S+`zyAX7hkaf&c$kFJKS>i8D&T
z#6fCw4Gb7u140;FgMruuh{Hn|oPlg-Ae(^^VkUwyLA)Mop#BE}P{4v{P~d`TU;u;k
zg8~^ug8~{vg8~~wg902xg905yg908zg90B+10w)LgCYS$gCc@~L63m}6dND`P>g_R
jP^^GxP|Sd6Q0#zcPz-JMV_v{K&{331mnfQikzF1DmO`b0

delta 520
zcmbOw_<?_dxF#0^0|N+yKqU}^*otRz7B*Z`{!(x$;rD~@`gQ?7G%_!2thm5f&&tTe
z%)~+*WMd~z9Z{-4&SPM3{r~^?0Y;Yp|95U+;Q0Ul>IFs~u!ta-6#f5y^#TS-kSwDt
zOdO<A*T8_mH6Vn+H5iCpTqg4~%P=!AGECNCmJ`M5|H<*p5(58$0OWZP4GMtG-<cOM
L53>-c=8y*fz@l$0

diff --git a/lib/pytz/zoneinfo/America/Nuuk b/lib/pytz/zoneinfo/America/Nuuk
index 0d2149cc0033785b517624400583fb9edf2ff2ec..883dfa055532c8319a833d80c82707b3ca5d4d5a 100644
GIT binary patch
delta 232
zcmX@Xw}M+EBq}q_hyeqz0YyL<1R{W#ZKFmC<0Pi=RM!9h&o?kI{QrOT0s{+-eEfis
v<Ntpc$-v>`8^WM#U<||{qZt{21ehe&vdtHnjxYgjbEU{OE*qfzc1BzPtvo$f

delta 614
zcmbWzJxBs!9LMqJF$FP@ry-hp86AAN^KetQAfg*WX{g3JHG9)iw6|-Druf4R;Sen$
zPEtfuTSz#SOG85twKPRrG{p7%&YD`H=Xjp)!@<G*KaJkDKaifz85;YwJn{`TR!MHp
zSzwNv^NA)I-V4eM5@lWvDf?NZT)RpO4{6FbW@z!cAeQzMv|LY#mFzIB?!`o5GA@e7
zfLK$9#QNxmDD^Q>j`UOc?MYPp?^NluMD_KaHcsne^X8JaYFD(~JffZI37H2baks1I
z`>|?#+&bnXv$lP^%b0E7b(s6-e17C!+r~Mer&&nR<c`We=e&FTb<p!MSIcF}Zy2UU
zF)@m%oyy5kOpihUg#ro*6dEW*P^h4gL7{^}2!#?VrSi@NTzCO86l_i<9ST0Dk`M(W
w3Q825C`eJTqM${)ycY2kRHy!<>WfS1q$ba3GN^0eSXhaKqCs6%x>wcr1*mzd#Q*>R

diff --git a/lib/pytz/zoneinfo/America/Ojinaga b/lib/pytz/zoneinfo/America/Ojinaga
index f81827e840b0156317cd9a6e85d49160aa5127bd..f97946d1e269bf9c83fd4a02591b7ef04e8eb6a8 100644
GIT binary patch
delta 558
zcma)&JxIeq7>4iK)JUa*gXm%f9sCQSQ7SG@6~sbuuvl<#vb6QDpS6bi*W6S`m4G-o
z=_n#DPA<+`1P3QU6t`lA4o>R5=i(sZ8;%EZ%RSF+W4&pwtwm>y;b1fJ==;5OXD(C`
z>G4rY*Rmqh(@B||xX9_8a;Juve|@Hfg9)}+{q&aX0k(Yh<mIPBjCQZRmFOEQ<WIcS
z);m_5-0_MZHDQk&ll@o~rS=MyuFl2!dzLniT(S8Or>*ju*uFHVJev~EVKZ@`=GS}y
zx0^>h0=_>!H^uwhE-l=^)x&@DxVYyp+`%<$Ko}`XD-dRi(hh{7qO=5I3c?nHF$il6
z<{<1b6aY~HlO-JW1354xQIuIgq*0W4KqOL>nLwlhkqbmJ5ZOSa1CbB>kx<6-%a(3G
gH~&{M{9Q5_n@SGH#*#*2$Q(2yM#8d8%ZvoS009$;R{#J2

delta 106
zcmeyueU4*-xF81u0|N+yfDI6HOw{-?*^Jd@@&r~5CPtpgTUeDi7#P9Q4A_)!PGWk(
Qh^B!Lrh&^jIK+$#0G?YAkpKVy

diff --git a/lib/pytz/zoneinfo/America/Pangnirtung b/lib/pytz/zoneinfo/America/Pangnirtung
index 3e4e0db6ae0a5a704f8cdd549071cc5b7124e2fd..0b47b9032f11d4ea7dd6ac51aa329f7a98253638 100644
GIT binary patch
literal 2202
zcmd_qe@xVM9LMo5hKL6wloTnELB$T?I4~5A3Ij%`osb@;Wct>?+X=-dwHuV7EsW_u
zuGz3wW0}^h*2v73Yhz;0TB}T1tzW}WZShBo_A&aS#k%YB{Iu2|^-uoW_x8QVXW!l3
zU-x=OT4S3ly?<OY?GtXUetUDy|ETleuJc8|sPi(VQ{{Ixy;)0I?FBU>cuLaeji{N~
zhsEa|Qa<yfWa!;0^UD`?*2$>4{6wFg^~w__``OJpXHUDiqUTP1WvtQ6UR$DbLw<AB
z;!J(DKf~k|`sJGR2{UI}hRpfdr{;b;A^GQiRM(E2m4c(6sOt_Mm3eW`T>tofDQx-9
z6m1#OH&mTAH!gch-<12ZDK6QjixclDzpq96$6it;KP=Mohx=9OXhg~eV=8cLp_KP7
zSHb;xQW1@s%B{c2g2s@!dF3}!RXpD;tQ?j_GqOze+^=-?c*0ve^`TjE=A60Z>p@*J
z^pm>v-Cg>&eV?k^pWCEsyWUhw`*zA5O;4-3wvAF>9#;+Zb<!|-#59&|(2b*eO(<)r
z4jt<>%O;BS^5^%cyFRa#@Qx0(;_X6dS{GK$1F3R%O}Se6@VKnX&ry+<4<s@*sa99L
zDyzSrW!4m&(Q8g$G;0$_bnD?!bMM$*y{_-Lxo@~ruWvhGHVm%N5`If<?C+3GWdrK|
zXjs~^x>b8)xwKETs%UYJL_e-kv9w8vy<VWUjDIE_14~Tj*^Bytc)odXXjFH#B#hd3
zTt8H$&DO31dRy)(v%RTDZ%<rM@#+DIkBzAAyl&|pKBRhnZIwp`cdJLgsF5ALQT5n6
z1=71dq;@{zNovZp%P#FTJ?+xI_pjgL|LS?k<ohR6Qj^IOZ+PkMoax@PlgZa!@MiNo
zCGW52e5NcI^ctEYUc)MT*W3G^h*xLNb@uF~{P~-IA0q!@GD&+e8)Q08J0E_N2_Z8=
zri9E1nG`ZBWLi!;FJxlK%#f)eb3-PF%nq3zGCyR3$PAGwB6CD0iOdq2CNfW_ohUL>
zWU9zqk;x*nMW&0)7nv|JV`R$6oRLW*vv%5PBlC9Ji6b*drjE=VnLILkWctYbkpv(a
zKvIC@07(Lp1tbkf9-KB2Tx0@C1(FLS8AvvebRhXa5`ts|NePk@Bq>N%oHi{;UYs^D
zNM@WiHArrd<RIBW(u3p&Nf44DBt=M$kR%~la@sT@d2-rBA(?X8R3W)Sl7(aoNf(kY
zBw<L#kdz@gLz0GM4M`i4H>XV;k~ybM9g;hzO&*dxBz;K!kOU$bL{f<45J@7EMI?<#
z9-TIkNG6>&l}Ij~Hkn8^k#r*YL=uW*6iF%m&vNRs)vdDCEe$USR0e{j;fjhtMIh+=
E0}Ll$F#rGn

literal 2094
zcmeIyaZFWJ0LStBf|Qu7oKYx92^pa9-UEAuh6Mq=J?+U2AEsb>H0TYXIGHjqLt8q_
zfBd5cZZ(#}Kb);u8LrmGpfzi?)>WdlYH+H>A8oWlwB<72?R-zQ+S=OM`m_6X?&t3Q
z^R~D5`zD&(AFgozb}cY(I9&V8;kjgJqVeE|&wMQ|7XBzNiW%>xP`LV1am(nU_SNe8
zEqPvcELYu7neuKdzM^spa^1xlQ))@zio0a?7m@qbl$&>9QY;-CbMs#t6*rw2a&O-I
zgIe~~VYi^^6IHnDgm+8ioLau_Y46tT<Em&yn^%+?7A2WcuVivStoW|PTRGAzO2_YY
z%LZFS@NBUg>RT(q&*g~nWKvh`{#mSw#`JBCUy4Z4N_~69h`3{ZmafeGTvbk|oYj{<
z&}+_L(06_@sH)C<FW0_(P~CORlXt(cQ&o4pE^7`Q5cf1ZFKb(Oh`La>tgovT^>e3m
zv~0VIjvv*rtQr+N+o{*h6sq+vJ}dA0v|7aXcgPLr3Pi)!xODr|#r;(w*|>LFY|L9I
z6HV`n#N|1;DRNqD`u1AAIsd%c{O+vYk~*cDPmb%B$)jrPp<(^tNT=G?I-s`?Zcrlr
zhTL(aL+mW;mk%Z5qBW~WwnamtZKhc!ix!IHM^&<Y-kfNEC138Eo)8`VYjo$wv+9xV
zJpJgIan;q7((>4_dMu*!?ydp#c=kJbPeZTTlbVv<mHnc7a!mH*^oX93A=!JWS?n7;
zET8zSO6>1T$|v8<7k%4e^1yLNqy?@@OHaG{A3yWv|NhCi=8vcUK>luy<NFg{Al=?G
zeE+>sXMyj3qXO62H`%-iEcX4kUUioG{>v{p%Xkhf|Lgm*aM-DNAmP-w=4>>lu8v#6
zspps%wH)*8I05^Wzuo?PPW+2m_~v37$UKmVSj|k3sUUOVyO<0z8)Q1je2@ttGeV|>
z%*kpdh0F?>7BVknV#v&psUdSiCWp)pnI1AfWP->Ht!9eI9Ia-O$Sjd*BJ)Hhip&(5
zDl%7OvdC<a=_2z*CXCD&nKCkGtC=(xvqq+k%o~|FGIM0=$lQ_1BeO@QkIWxQ0FnW#
zNdb}rt4RWq1*=H|k_RLaNG6a}Ah|%2fn)<o2a*pYAxK87CM8HttR^W)R;(s1NM4Y{
zAeli@gX9KD4w4-tJxG3#1R)thQiSBlYLbLx$!gMs<jHChg=7jz6_P6?SxB~!bRqdd
z5{6_9Ng0wet4SJ?HLFP*k~gbK9FjRCbx7`z<RRHZ(ue=&k6*#bG>wdyR+h$B1uKH#
N(s+4!usj&f{1s}GV)+07

diff --git a/lib/pytz/zoneinfo/America/Rankin_Inlet b/lib/pytz/zoneinfo/America/Rankin_Inlet
index 3a70587472c633aaa178c7f979b8b3884d604372..e2714921a8f3c05189d20a9151931fb6eadf493b 100644
GIT binary patch
delta 596
zcmaFDH%VZEvTrK`0|P4%3q0@1V_-?-ZeR^~SHR}*wt?N?LIH=u`36pbO$A&G8ymPj
zOex@gFu8%}=7tZv2TB|Gc24@hzj6|Tz|4{lf}JG{LX}}3Hd<U}tY>5*3o?_X3)3z`
zpb*eMK=A+n&JBz#|NpOEz`y}wGw?vzx&{Ue&MqMg&cPuJu0T9NxgH)0|A7D$5+DEy
z4G;|q5fBXu6%Y*y84wK$9S{u)ArK7;B`^&PDG&_`Ef5U~F%S(3H4qI7IS>sBJrEF>
fDO3U$00komfP!-KAEw33109yyB!uN;H+DGyf68g~

delta 443
zcmbOv@Pu!IvS>L20|Ofni$3qkWB9J`lkh{M{K3Y8%Z&BROhiH!BGnOL9?&5`@c;ku
z1B@Ch|NpOEz`*(c|IQ7JydaW65F(;$V8Gz);u6B(91O%RlixCFD#E?-9|%BR0ns4u
xfM}4HHZNyh%skM3awFDHAq=iSzi|OQXy)t^qT_3<XQXGK<7;TBXQ*eu1pt3=R0041

diff --git a/lib/pytz/zoneinfo/America/Resolute b/lib/pytz/zoneinfo/America/Resolute
index 0a73b753ba597f89cd57cc3875e7869dc133778c..19668900dea9249c1714b8838e44ac2070069138 100644
GIT binary patch
delta 596
zcmaFDH%VZEvTrK`0|P4%3tau(*uav=-M|{~u7J(qZ3DZ(g#r$R^9`H=n+muXHa2j5
zm{P#~U~&V`%?%%T50p0W?VR+1f8`_wfte*A1UpL@get>6Y_zz{SkK5r7Gy@!h0G?^
zG((^Upnrhi|NosE7+L=RU%h~V1H@+Ffv|NA3>chULKvKbLl|6vc!F|0JQV%|0VpIu
z`az)qqCp`7qCueoqCp`8qCuepqCp`9qCueqrhy>^qCuerqCp`BqCuesqCp`CqCuet
i0s=FIO27i3U<3hBP;UOiw3vCI!%~}su$=71E(ZX_5o^}~

delta 443
zcmbOv@Pu!IvS>L20|Ofni(dWR*zjH7C*g-i`GbuGml^AsnTUieNa~Q;#Og;<2XqJ!
z{QrOa0HX%W|NpBOFmV3=zjFg4FNkCigox-G7%(`yxP&k`2LrLo<hM+kig0iI2Lg~+
zKs3lZAR6SQ&C8h=GY_<%+=%s42!kuoZ(KkRnmN0K==d7z8R;45_!=7O8R{8u0RZ8k
BRptNy

diff --git a/lib/pytz/zoneinfo/America/Whitehorse b/lib/pytz/zoneinfo/America/Whitehorse
index 9ee229c0eb82c6aea7359e0b38677264f3cad8ab..318c4a8e4003bcff00f9a21e294e7815f170235b 100644
GIT binary patch
delta 25
ecmX@dbB<?12+NP7EfY3IOkx5vHos#^U<Lr4+6(3Y

delta 25
dcmX@dbB<?12+METc!7-(lbFDa&F`2Jm;rzA2~q$6

diff --git a/lib/pytz/zoneinfo/America/Yellowknife b/lib/pytz/zoneinfo/America/Yellowknife
index e6afa390e879f97cef351e382ae62daf183e8d77..efc9ab037fea7aa699c70b59d011150043c51cd9 100644
GIT binary patch
delta 692
zcmd7Pze@sf7{~GFyfgE%d`iocmarv5kMAWIH8u2uh65oXS^}Ylw$>)U<dQ@1g{C%b
z2qFlgDTs7$bE=`}PiSZ>sORGzjrBR6d*A%JtK=h_Og&0OIP6Fc-|72Vj~<!{)0=+Z
z@6|kVYFQJleCmOv4--=_dT{F5#JQ_o>KOO!Ob@-bP2#CT!`+4%xouPOqQ!jLpwZ?b
zj~(n%YHx?rTWd7FzRD8|dCKHx*vqZxZ2Wrr&Z;~1pFR=WIXR9@<}O<n7nP!Lvr1t_
zZbNRlDj=2|UO#z#$zX=U4TW95;)lTyg(C_}6rLzdQMjV8?N@wJ7!#F=0F40~1vmzD
n6z~}EQT%|Ll6`Lf6X(U>on4`y7y3e2^5=Y22!p^6eC2)v8|HHT

delta 490
zcmca1u#SI%xGoz50|N+yKot;!*pmCSBp6P2@=Um-{H5Shq6EWt{iuQ;8m%8T)?8z(
zXJw{81i6lZ;s5{D3mENKz!b;-|8plW@cjS3a|5FQSVUCUz<|LwJcPkF0EmNu*u@1z
wgaCCig7t&Q3F4wyy*$~5SpjIy|NkJrf@qL`H{W4i#yrp-wxPtslkGU906$1mvH$=8

diff --git a/lib/pytz/zoneinfo/Asia/Kuala_Lumpur b/lib/pytz/zoneinfo/Asia/Kuala_Lumpur
index adb41cf4caca6096052d7a82cf6adb568f3cee3a..3d9f191e3acad56fb4f73ab44a74c50cdf91c12e 100644
GIT binary patch
delta 83
zcmey!G?96NI4cJO0|UoI89k<V43h;IBLsk45MYE*42*Ck2mGK)Bw<o8n#)Gpz`{<~
Gf(rl>R0{<F

delta 50
rcmbQp{E=ybI4c7POq9`M`pPj`fiVIua={NO!pUW$ZD3)iYrzEoBm4^w

diff --git a/lib/pytz/zoneinfo/Asia/Singapore b/lib/pytz/zoneinfo/Asia/Singapore
index adb41cf4caca6096052d7a82cf6adb568f3cee3a..3d9f191e3acad56fb4f73ab44a74c50cdf91c12e 100644
GIT binary patch
delta 83
zcmey!G?96NI4cJO0|UoI89k<V43h;IBLsk45MYE*42*Ck2mGK)Bw<o8n#)Gpz`{<~
Gf(rl>R0{<F

delta 50
rcmbQp{E=ybI4c7POq9`M`pPj`fiVIua={NO!pUW$ZD3)iYrzEoBm4^w

diff --git a/lib/pytz/zoneinfo/Canada/Yukon b/lib/pytz/zoneinfo/Canada/Yukon
index 9ee229c0eb82c6aea7359e0b38677264f3cad8ab..318c4a8e4003bcff00f9a21e294e7815f170235b 100644
GIT binary patch
delta 25
ecmX@dbB<?12+NP7EfY3IOkx5vHos#^U<Lr4+6(3Y

delta 25
dcmX@dbB<?12+METc!7-(lbFDa&F`2Jm;rzA2~q$6

diff --git a/lib/pytz/zoneinfo/Singapore b/lib/pytz/zoneinfo/Singapore
index adb41cf4caca6096052d7a82cf6adb568f3cee3a..3d9f191e3acad56fb4f73ab44a74c50cdf91c12e 100644
GIT binary patch
delta 83
zcmey!G?96NI4cJO0|UoI89k<V43h;IBLsk45MYE*42*Ck2mGK)Bw<o8n#)Gpz`{<~
Gf(rl>R0{<F

delta 50
rcmbQp{E=ybI4c7POq9`M`pPj`fiVIua={NO!pUW$ZD3)iYrzEoBm4^w

diff --git a/lib/pytz/zoneinfo/iso3166.tab b/lib/pytz/zoneinfo/iso3166.tab
index a4ff61a4..911af5e8 100644
--- a/lib/pytz/zoneinfo/iso3166.tab
+++ b/lib/pytz/zoneinfo/iso3166.tab
@@ -3,13 +3,13 @@
 # This file is in the public domain, so clarified as of
 # 2009-05-17 by Arthur David Olson.
 #
-# From Paul Eggert (2015-05-02):
+# From Paul Eggert (2022-11-18):
 # This file contains a table of two-letter country codes.  Columns are
 # separated by a single tab.  Lines beginning with '#' are comments.
 # All text uses UTF-8 encoding.  The columns of the table are as follows:
 #
 # 1.  ISO 3166-1 alpha-2 country code, current as of
-#     ISO 3166-1 N976 (2018-11-06).  See: Updates on ISO 3166-1
+#     ISO 3166-1 N1087 (2022-09-02).  See: Updates on ISO 3166-1
 #     https://isotc.iso.org/livelink/livelink/Open/16944257
 # 2.  The usual English name for the coded region,
 #     chosen so that alphabetic sorting of subsets produces helpful lists.
@@ -238,7 +238,7 @@ SY	Syria
 SZ	Eswatini (Swaziland)
 TC	Turks & Caicos Is
 TD	Chad
-TF	French Southern & Antarctic Lands
+TF	French Southern Territories
 TG	Togo
 TH	Thailand
 TJ	Tajikistan
diff --git a/lib/pytz/zoneinfo/tzdata.zi b/lib/pytz/zoneinfo/tzdata.zi
index d8c78d47..7c88530c 100644
--- a/lib/pytz/zoneinfo/tzdata.zi
+++ b/lib/pytz/zoneinfo/tzdata.zi
@@ -1040,7 +1040,7 @@ Z Asia/Singapore 6:55:25 - LMT 1901
 7:20 - +0720 1941 S
 7:30 - +0730 1942 F 16
 9 - +09 1945 S 12
-7:30 - +0730 1982
+7:30 - +0730 1981 D 31 16u
 8 - +08
 Z Asia/Colombo 5:19:24 - LMT 1880
 5:19:32 - MMT 1906
@@ -1754,7 +1754,8 @@ Z America/Scoresbysund -1:27:52 - LMT 1916 Jul 28
 -1 E -01/+00
 Z America/Nuuk -3:26:56 - LMT 1916 Jul 28
 -3 - -03 1980 Ap 6 2
--3 E -03/-02
+-3 E -03/-02 2023 Mar 25 22
+-2 - -02
 Z America/Thule -4:35:8 - LMT 1916 Jul 28
 -4 Th A%sT
 Z Europe/Tallinn 1:39 - LMT 1880
@@ -3044,16 +3045,11 @@ R Y 1919 o - N 1 0 0 S
 R Y 1942 o - F 9 2 1 W
 R Y 1945 o - Au 14 23u 1 P
 R Y 1945 o - S 30 2 0 S
-R Y 1965 o - Ap lastSu 0 2 DD
-R Y 1965 o - O lastSu 2 0 S
-R Y 1980 1986 - Ap lastSu 2 1 D
-R Y 1980 2006 - O lastSu 2 0 S
+R Y 1972 1986 - Ap lastSu 2 1 D
+R Y 1972 2006 - O lastSu 2 0 S
 R Y 1987 2006 - Ap Su>=1 2 1 D
-Z America/Pangnirtung 0 - -00 1921
--4 Y A%sT 1995 Ap Su>=1 2
--5 C E%sT 1999 O 31 2
--6 C C%sT 2000 O 29 2
--5 C E%sT
+R Yu 1965 o - Ap lastSu 0 2 DD
+R Yu 1965 o - O lastSu 2 0 S
 Z America/Iqaluit 0 - -00 1942 Au
 -5 Y E%sT 1999 O 31 2
 -6 C C%sT 2000 O 29 2
@@ -3082,13 +3078,15 @@ Z America/Inuvik 0 - -00 1953
 -7 Y M%sT 1980
 -7 C M%sT
 Z America/Whitehorse -9:0:12 - LMT 1900 Au 20
--9 Y Y%sT 1967 May 28
--8 Y P%sT 1980
+-9 Y Y%sT 1965
+-9 Yu Y%sT 1966 F 27
+-8 - PST 1980
 -8 C P%sT 2020 N
 -7 - MST
 Z America/Dawson -9:17:40 - LMT 1900 Au 20
--9 Y Y%sT 1973 O 28
--8 Y P%sT 1980
+-9 Y Y%sT 1965
+-9 Yu Y%sT 1973 O 28
+-8 - PST 1980
 -8 C P%sT 2020 N
 -7 - MST
 R m 1931 o - May 1 23 1 D
@@ -3132,6 +3130,17 @@ Z America/Mexico_City -6:36:36 - LMT 1922 Ja 1 7u
 -6 m C%sT 2001 S 30 2
 -6 - CST 2002 F 20
 -6 m C%sT
+Z America/Ciudad_Juarez -7:5:56 - LMT 1922 Ja 1 7u
+-7 - MST 1927 Jun 10 23
+-6 - CST 1930 N 15
+-7 m M%sT 1932 Ap
+-6 - CST 1996
+-6 m C%sT 1998
+-6 - CST 1998 Ap Su>=1 3
+-7 m M%sT 2010
+-7 u M%sT 2022 O 30 2
+-6 - CST 2022 N 30
+-7 u M%sT
 Z America/Ojinaga -6:57:40 - LMT 1922 Ja 1 7u
 -7 - MST 1927 Jun 10 23
 -6 - CST 1930 N 15
@@ -3141,7 +3150,8 @@ Z America/Ojinaga -6:57:40 - LMT 1922 Ja 1 7u
 -6 - CST 1998 Ap Su>=1 3
 -7 m M%sT 2010
 -7 u M%sT 2022 O 30 2
--6 - CST
+-6 - CST 2022 N 30
+-6 u C%sT
 Z America/Chihuahua -7:4:20 - LMT 1922 Ja 1 7u
 -7 - MST 1927 Jun 10 23
 -6 - CST 1930 N 15
@@ -3771,7 +3781,7 @@ Z Antarctica/Palmer 0 - -00 1965
 -4 x -04/-03 2016 D 4
 -3 - -03
 R CO 1992 o - May 3 0 1 -
-R CO 1993 o - Ap 4 0 0 -
+R CO 1993 o - F 6 24 0 -
 Z America/Bogota -4:56:16 - LMT 1884 Mar 13
 -4:56:16 - BMT 1914 N 23
 -5 CO -05/-04
@@ -4154,6 +4164,7 @@ L America/Tijuana America/Ensenada
 L America/Indiana/Indianapolis America/Fort_Wayne
 L America/Toronto America/Montreal
 L America/Toronto America/Nipigon
+L America/Iqaluit America/Pangnirtung
 L America/Rio_Branco America/Porto_Acre
 L America/Winnipeg America/Rainy_River
 L America/Argentina/Cordoba America/Rosario
diff --git a/lib/pytz/zoneinfo/zone.tab b/lib/pytz/zoneinfo/zone.tab
index 2636e21a..6e5adb9f 100644
--- a/lib/pytz/zoneinfo/zone.tab
+++ b/lib/pytz/zoneinfo/zone.tab
@@ -114,8 +114,7 @@ CA	+4606-06447	America/Moncton	Atlantic - New Brunswick
 CA	+5320-06025	America/Goose_Bay	Atlantic - Labrador (most areas)
 CA	+5125-05707	America/Blanc-Sablon	AST - QC (Lower North Shore)
 CA	+4339-07923	America/Toronto	Eastern - ON, QC (most areas)
-CA	+6344-06828	America/Iqaluit	Eastern - NU (most east areas)
-CA	+6608-06544	America/Pangnirtung	Eastern - NU (Pangnirtung)
+CA	+6344-06828	America/Iqaluit	Eastern - NU (most areas)
 CA	+484531-0913718	America/Atikokan	EST - ON (Atikokan); NU (Coral H)
 CA	+4953-09709	America/Winnipeg	Central - ON (west); Manitoba
 CA	+744144-0944945	America/Resolute	Central - NU (Resolute)
@@ -277,17 +276,18 @@ MT	+3554+01431	Europe/Malta
 MU	-2010+05730	Indian/Mauritius
 MV	+0410+07330	Indian/Maldives
 MW	-1547+03500	Africa/Blantyre
-MX	+1924-09909	America/Mexico_City	Central Time
-MX	+2105-08646	America/Cancun	Eastern Standard Time - Quintana Roo
-MX	+2058-08937	America/Merida	Central Time - Campeche, Yucatan
-MX	+2540-10019	America/Monterrey	Central Time - Durango; Coahuila, Nuevo Leon, Tamaulipas (most areas)
-MX	+2550-09730	America/Matamoros	Central Time US - Coahuila, Nuevo Leon, Tamaulipas (US border)
-MX	+2313-10625	America/Mazatlan	Mountain Time - Baja California Sur, Nayarit, Sinaloa
-MX	+2838-10605	America/Chihuahua	Mountain Time - Chihuahua (most areas)
-MX	+2934-10425	America/Ojinaga	Mountain Time US - Chihuahua (US border)
-MX	+2904-11058	America/Hermosillo	Mountain Standard Time - Sonora
-MX	+3232-11701	America/Tijuana	Pacific Time US - Baja California
-MX	+2048-10515	America/Bahia_Banderas	Central Time - Bahia de Banderas
+MX	+1924-09909	America/Mexico_City	Central Mexico
+MX	+2105-08646	America/Cancun	Quintana Roo
+MX	+2058-08937	America/Merida	Campeche, Yucatan
+MX	+2540-10019	America/Monterrey	Durango; Coahuila, Nuevo Leon, Tamaulipas (most areas)
+MX	+2550-09730	America/Matamoros	Coahuila, Nuevo Leon, Tamaulipas (US border)
+MX	+2838-10605	America/Chihuahua	Chihuahua (most areas)
+MX	+3144-10629	America/Ciudad_Juarez	Chihuahua (US border - west)
+MX	+2934-10425	America/Ojinaga	Chihuahua (US border - east)
+MX	+2313-10625	America/Mazatlan	Baja California Sur, Nayarit (most areas), Sinaloa
+MX	+2048-10515	America/Bahia_Banderas	Bahia de Banderas
+MX	+2904-11058	America/Hermosillo	Sonora
+MX	+3232-11701	America/Tijuana	Baja California
 MY	+0310+10142	Asia/Kuala_Lumpur	Malaysia (peninsula)
 MY	+0133+11020	Asia/Kuching	Sabah, Sarawak
 MZ	-2558+03235	Africa/Maputo
diff --git a/lib/pytz/zoneinfo/zone1970.tab b/lib/pytz/zoneinfo/zone1970.tab
index 75372e3f..a9b36d36 100644
--- a/lib/pytz/zoneinfo/zone1970.tab
+++ b/lib/pytz/zoneinfo/zone1970.tab
@@ -102,8 +102,7 @@ CA	+4612-05957	America/Glace_Bay	Atlantic - NS (Cape Breton)
 CA	+4606-06447	America/Moncton	Atlantic - New Brunswick
 CA	+5320-06025	America/Goose_Bay	Atlantic - Labrador (most areas)
 CA,BS	+4339-07923	America/Toronto	Eastern - ON, QC (most areas), Bahamas
-CA	+6344-06828	America/Iqaluit	Eastern - NU (most east areas)
-CA	+6608-06544	America/Pangnirtung	Eastern - NU (Pangnirtung)
+CA	+6344-06828	America/Iqaluit	Eastern - NU (most areas)
 CA	+4953-09709	America/Winnipeg	Central - ON (west); Manitoba
 CA	+744144-0944945	America/Resolute	Central - NU (Resolute)
 CA	+624900-0920459	America/Rankin_Inlet	Central - NU (central)
@@ -214,17 +213,18 @@ MQ	+1436-06105	America/Martinique
 MT	+3554+01431	Europe/Malta
 MU	-2010+05730	Indian/Mauritius
 MV,TF	+0410+07330	Indian/Maldives	Maldives, Kerguelen, St Paul I, Amsterdam I
-MX	+1924-09909	America/Mexico_City	Central Time
-MX	+2105-08646	America/Cancun	Eastern Standard Time - Quintana Roo
-MX	+2058-08937	America/Merida	Central Time - Campeche, Yucatán
-MX	+2540-10019	America/Monterrey	Central Time - Durango; Coahuila, Nuevo León, Tamaulipas (most areas)
-MX	+2550-09730	America/Matamoros	Central Time US - Coahuila, Nuevo León, Tamaulipas (US border)
-MX	+2313-10625	America/Mazatlan	Mountain Time - Baja California Sur, Nayarit, Sinaloa
-MX	+2838-10605	America/Chihuahua	Mountain Time - Chihuahua (most areas)
-MX	+2934-10425	America/Ojinaga	Mountain Time US - Chihuahua (US border)
-MX	+2904-11058	America/Hermosillo	Mountain Standard Time - Sonora
-MX	+3232-11701	America/Tijuana	Pacific Time US - Baja California
-MX	+2048-10515	America/Bahia_Banderas	Central Time - Bahía de Banderas
+MX	+1924-09909	America/Mexico_City	Central Mexico
+MX	+2105-08646	America/Cancun	Quintana Roo
+MX	+2058-08937	America/Merida	Campeche, Yucatán
+MX	+2540-10019	America/Monterrey	Durango; Coahuila, Nuevo León, Tamaulipas (most areas)
+MX	+2550-09730	America/Matamoros	Coahuila, Nuevo León, Tamaulipas (US border)
+MX	+2838-10605	America/Chihuahua	Chihuahua (most areas)
+MX	+3144-10629	America/Ciudad_Juarez	Chihuahua (US border - west)
+MX	+2934-10425	America/Ojinaga	Chihuahua (US border - east)
+MX	+2313-10625	America/Mazatlan	Baja California Sur, Nayarit (most areas), Sinaloa
+MX	+2048-10515	America/Bahia_Banderas	Bahía de Banderas
+MX	+2904-11058	America/Hermosillo	Sonora
+MX	+3232-11701	America/Tijuana	Baja California
 MY,BN	+0133+11020	Asia/Kuching	Sabah, Sarawak, Brunei
 MZ,BI,BW,CD,MW,RW,ZM,ZW	-2558+03235	Africa/Maputo	Central Africa Time
 NA	-2234+01706	Africa/Windhoek
diff --git a/requirements.txt b/requirements.txt
index 4fc06668..0003108a 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -34,7 +34,7 @@ PyJWT==2.6.0
 pyparsing==3.0.9
 python-dateutil==2.8.2
 python-twitter==3.5
-pytz==2022.6
+pytz==2022.7
 requests==2.28.1
 requests-oauthlib==1.3.1
 rumps==0.4.0; platform_system == "Darwin"

From d8150813f163edc4a5e1df6cebaca10cedc0fddf Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 21 Dec 2022 16:03:24 -0800
Subject: [PATCH 264/743] Bump pycryptodomex from 3.15.0 to 3.16.0 (#1911)

Bumps [pycryptodomex](https://github.com/Legrandin/pycryptodome) from 3.15.0 to 3.16.0.
- [Release notes](https://github.com/Legrandin/pycryptodome/releases)
- [Changelog](https://github.com/Legrandin/pycryptodome/blob/master/Changelog.rst)
- [Commits](https://github.com/Legrandin/pycryptodome/compare/v3.15.0...v3.16.0)

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

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

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 package/requirements-package.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index 82782772..a9200d3e 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -3,7 +3,7 @@ importlib-metadata==5.2.0
 importlib-resources==5.10.1
 pyinstaller==5.6.2
 pyopenssl==22.1.0
-pycryptodomex==3.15.0
+pycryptodomex==3.16.0
 
 pyobjc-framework-Cocoa==9.0; platform_system == "Darwin"
 pyobjc-core==9.0; platform_system == "Darwin"

From 18a59620261a42b9acf9a01c7be25fc1ffc5817e Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 21 Dec 2022 16:03:50 -0800
Subject: [PATCH 265/743] Bump pyobjc-framework-cocoa from 9.0 to 9.0.1 (#1933)

Bumps [pyobjc-framework-cocoa](https://github.com/ronaldoussoren/pyobjc) from 9.0 to 9.0.1.
- [Release notes](https://github.com/ronaldoussoren/pyobjc/releases)
- [Changelog](https://github.com/ronaldoussoren/pyobjc/blob/master/docs/changelog.rst)
- [Commits](https://github.com/ronaldoussoren/pyobjc/commits)

---
updated-dependencies:
- dependency-name: pyobjc-framework-cocoa
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 package/requirements-package.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index a9200d3e..ca1d690e 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -5,7 +5,7 @@ pyinstaller==5.6.2
 pyopenssl==22.1.0
 pycryptodomex==3.16.0
 
-pyobjc-framework-Cocoa==9.0; platform_system == "Darwin"
+pyobjc-framework-Cocoa==9.0.1; platform_system == "Darwin"
 pyobjc-core==9.0; platform_system == "Darwin"
 
 pywin32==305; platform_system == "Windows"

From 497ceb8cbb6413d4fcd2c9bd756090188bd6dfe9 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 21 Dec 2022 16:05:11 -0800
Subject: [PATCH 266/743] Bump pyobjc-core from 9.0 to 9.0.1 (#1935)

Bumps [pyobjc-core](https://github.com/ronaldoussoren/pyobjc) from 9.0 to 9.0.1.
- [Release notes](https://github.com/ronaldoussoren/pyobjc/releases)
- [Changelog](https://github.com/ronaldoussoren/pyobjc/blob/master/docs/changelog.rst)
- [Commits](https://github.com/ronaldoussoren/pyobjc/commits)

---
updated-dependencies:
- dependency-name: pyobjc-core
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

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

[skip ci]
---
 package/requirements-package.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index ca1d690e..b793d1c5 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -5,7 +5,7 @@ pyinstaller==5.6.2
 pyopenssl==22.1.0
 pycryptodomex==3.16.0
 
+pyobjc-core==9.0.1; platform_system == "Darwin"
 pyobjc-framework-Cocoa==9.0.1; platform_system == "Darwin"
-pyobjc-core==9.0; platform_system == "Darwin"
 
 pywin32==305; platform_system == "Windows"

From 8cf12a2ab5cfd679d5072c8528b06678802c5c7d Mon Sep 17 00:00:00 2001
From: Eric Nemchik <eric@nemchik.com>
Date: Wed, 21 Dec 2022 18:05:55 -0600
Subject: [PATCH 267/743] backports.zoneinfo environment marker (#1926)

https://github.com/pganssle/zoneinfo#installation-and-depending-on-this-library notes:
> Support for `backports.zoneinfo` in Python 3.9+ is currently minimal, since it is expected that you would use the standard library `zoneinfo` module instead.
---
 requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements.txt b/requirements.txt
index 0003108a..70ca360f 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -3,7 +3,7 @@ apscheduler==3.9.1.post1
 arrow==1.2.3
 backports.csv==1.0.7
 backports.functools-lru-cache==1.6.4
-backports.zoneinfo==0.2.1
+backports.zoneinfo==0.2.1;python_version<"3.9"
 beautifulsoup4==4.11.1
 bleach==5.0.1
 certifi==2022.12.7

From cbe33e93c9d6d778e1795ab6e67f0f92305ac48a Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 21 Dec 2022 16:06:32 -0800
Subject: [PATCH 268/743] Bump pyinstaller from 5.6.2 to 5.7.0 (#1917)

Bumps [pyinstaller](https://github.com/pyinstaller/pyinstaller) from 5.6.2 to 5.7.0.
- [Release notes](https://github.com/pyinstaller/pyinstaller/releases)
- [Changelog](https://github.com/pyinstaller/pyinstaller/blob/develop/doc/CHANGES.rst)
- [Commits](https://github.com/pyinstaller/pyinstaller/compare/v5.6.2...v5.7.0)

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

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

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 package/requirements-package.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index b793d1c5..93054bda 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -1,7 +1,7 @@
 apscheduler==3.9.1.post1
 importlib-metadata==5.2.0
 importlib-resources==5.10.1
-pyinstaller==5.6.2
+pyinstaller==5.7.0
 pyopenssl==22.1.0
 pycryptodomex==3.16.0
 

From 74d8bc15ca5f409cf9eb990738af288baf65e7c8 Mon Sep 17 00:00:00 2001
From: Jagandeep Brar <me@jagandeepbrar.io>
Date: Wed, 21 Dec 2022 18:08:14 -0600
Subject: [PATCH 269/743] Add session_key to LunaSea notifier payload (#1929)

---
 plexpy/notifiers.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/plexpy/notifiers.py b/plexpy/notifiers.py
index 59b7a41f..fbd48c4b 100644
--- a/plexpy/notifiers.py
+++ b/plexpy/notifiers.py
@@ -2175,6 +2175,7 @@ class LUNASEA(Notifier):
                 'player': pretty_metadata.parameters.get('player'),
                 'title': pretty_metadata.get_title(),
                 'poster_url': pretty_metadata.get_poster_url(),
+                'session_key': pretty_metadata.parameters.get('session_key'),
                 'session_id': pretty_metadata.parameters.get('session_id'),
                 'user_streams': pretty_metadata.parameters.get('user_streams'),
                 'remote_access_reason': pretty_metadata.parameters.get('remote_access_reason'),

From 8664b95ca12ad249e0219e6ec9a5a39a795a61ce Mon Sep 17 00:00:00 2001
From: FSCorrupt <45659314+fscorrupt@users.noreply.github.com>
Date: Thu, 22 Dec 2022 01:26:32 +0100
Subject: [PATCH 270/743] Adding stream audio/sub language to activity card.
 (#1900)

* Update current_activity_instance.html

* Update index.html

* Make sure language is capitalized on activity card

Co-authored-by: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
---
 .../default/current_activity_instance.html       | 16 ++++++++--------
 data/interfaces/default/index.html               | 16 ++++++++--------
 2 files changed, 16 insertions(+), 16 deletions(-)

diff --git a/data/interfaces/default/current_activity_instance.html b/data/interfaces/default/current_activity_instance.html
index 2c24c233..83660745 100644
--- a/data/interfaces/default/current_activity_instance.html
+++ b/data/interfaces/default/current_activity_instance.html
@@ -266,11 +266,11 @@ DOCUMENTATION :: END
                                 <div class="sub-value" id="audio_decision-${sk}">
                                     % if data['stream_audio_decision']:
                                         % if data['stream_audio_decision'] == 'transcode':
-                                        Transcode (${AUDIO_CODEC_OVERRIDES.get(data['audio_codec'], data['audio_codec'].upper())} ${data['audio_channel_layout'].split('(')[0].capitalize()} <i class="fa fa-long-arrow-right"></i> ${AUDIO_CODEC_OVERRIDES.get(data['stream_audio_codec'], data['stream_audio_codec'].upper())} ${data['stream_audio_channel_layout'].split('(')[0].capitalize()})
+                                        Transcode (${data['stream_audio_language'].capitalize()} - ${AUDIO_CODEC_OVERRIDES.get(data['audio_codec'], data['audio_codec'].upper())} ${data['audio_channel_layout'].split('(')[0].capitalize()} <i class="fa fa-long-arrow-right"></i> ${AUDIO_CODEC_OVERRIDES.get(data['stream_audio_codec'], data['stream_audio_codec'].upper())} ${data['stream_audio_channel_layout'].split('(')[0].capitalize()})
                                         % elif data['stream_audio_decision'] == 'copy':
-                                        Direct Stream (${AUDIO_CODEC_OVERRIDES.get(data['stream_audio_codec'], data['stream_audio_codec'].upper())} ${data['stream_audio_channel_layout'].split('(')[0].capitalize()})
+                                        Direct Stream (${data['stream_audio_language'].capitalize()} - ${AUDIO_CODEC_OVERRIDES.get(data['stream_audio_codec'], data['stream_audio_codec'].upper())} ${data['stream_audio_channel_layout'].split('(')[0].capitalize()})
                                         % else:
-                                        Direct Play (${AUDIO_CODEC_OVERRIDES.get(data['stream_audio_codec'], data['stream_audio_codec'].upper())} ${data['stream_audio_channel_layout'].split('(')[0].capitalize()})
+                                        Direct Play (${data['stream_audio_language'].capitalize()} - ${AUDIO_CODEC_OVERRIDES.get(data['stream_audio_codec'], data['stream_audio_codec'].upper())} ${data['stream_audio_channel_layout'].split('(')[0].capitalize()})
                                         % endif
                                     % endif
                                 </div>
@@ -285,13 +285,13 @@ DOCUMENTATION :: END
                                             subtitle_codec = 'None' if data['stream_subtitle_codec'] and data['stream_subtitle_transient'] else data['subtitle_codec'].upper()
                                         %>
                                         % if data['stream_subtitle_decision'] == 'transcode':
-                                        Transcode (${subtitle_codec} <i class="fa fa-long-arrow-right"></i> ${data['stream_subtitle_codec'].upper()})
+                                        Transcode (${data['stream_subtitle_language'].capitalize()} - ${subtitle_codec} <i class="fa fa-long-arrow-right"></i> ${data['stream_subtitle_codec'].upper()})
                                         % elif data['stream_subtitle_decision'] == 'copy':
-                                        Direct Stream (${subtitle_codec})
+                                        Direct Stream (${data['stream_subtitle_language'].capitalize()} - ${subtitle_codec})
                                         % elif data['stream_subtitle_decision'] == 'burn':
-                                        Burn (${subtitle_codec})
+                                        Burn (${data['stream_subtitle_language'].capitalize()} - ${subtitle_codec})
                                         % else:
-                                        Direct Play (${subtitle_codec if data['synced_version'] else data['stream_subtitle_codec'].upper()})
+                                        Direct Play (${data['stream_subtitle_language'].capitalize()} - ${subtitle_codec if data['synced_version'] else data['stream_subtitle_codec'].upper()})
                                         % endif
                                     % else:
                                     None
@@ -537,4 +537,4 @@ DOCUMENTATION :: END
         </div>
     </div>
 </div>
-% endif
\ No newline at end of file
+% endif
diff --git a/data/interfaces/default/index.html b/data/interfaces/default/index.html
index b96e67cf..adcefce6 100644
--- a/data/interfaces/default/index.html
+++ b/data/interfaces/default/index.html
@@ -526,11 +526,11 @@
                             var a_codec = (s.audio_codec === 'truehd') ? 'TrueHD' : s.audio_codec.toUpperCase();
                             var sa_codec = (s.stream_audio_codec === 'truehd') ? 'TrueHD' : s.stream_audio_codec.toUpperCase();
                             if (s.stream_audio_decision === 'transcode') {
-                                audio_decision = 'Transcode (' + a_codec + ' ' + capitalizeFirstLetter(s.audio_channel_layout.split('(')[0]) + ' <i class="fa fa-long-arrow-right"></i> ' + sa_codec + ' ' + capitalizeFirstLetter(s.stream_audio_channel_layout.split('(')[0]) + ')';
+                                audio_decision = 'Transcode ('+ capitalizeFirstLetter(s.stream_audio_language)+ ' - ' + a_codec + ' ' + capitalizeFirstLetter(s.audio_channel_layout.split('(')[0]) + ' <i class="fa fa-long-arrow-right"></i> ' + sa_codec + ' ' + capitalizeFirstLetter(s.stream_audio_channel_layout.split('(')[0]) + ')';
                             } else if (s.stream_audio_decision === 'copy') {
-                                audio_decision = 'Direct Stream (' + sa_codec + ' ' + capitalizeFirstLetter(s.stream_audio_channel_layout.split('(')[0]) + ')';
+                                audio_decision = 'Direct Stream ('+ capitalizeFirstLetter(s.stream_audio_language)+ ' - ' + sa_codec + ' ' + capitalizeFirstLetter(s.stream_audio_channel_layout.split('(')[0]) + ')';
                             } else {
-                                audio_decision = 'Direct Play (' + sa_codec + ' ' + capitalizeFirstLetter(s.stream_audio_channel_layout.split('(')[0]) + ')';
+                                audio_decision = 'Direct Play ('+ capitalizeFirstLetter(s.stream_audio_language)+ ' - ' + sa_codec + ' ' + capitalizeFirstLetter(s.stream_audio_channel_layout.split('(')[0]) + ')';
                             }
                         }
                         $('#audio_decision-' + key).html(audio_decision);
@@ -539,13 +539,13 @@
                         if (['movie', 'episode', 'clip'].indexOf(s.media_type) > -1 && s.subtitles === 1) {
                             var subtitle_codec = (s.stream_subtitle_codec && s.stream_subtitle_transient) ? 'None' : s.subtitle_codec.toUpperCase();
                             if (s.stream_subtitle_decision === 'transcode') {
-                                subtitle_decision = 'Transcode (' + subtitle_codec + ' <i class="fa fa-long-arrow-right"></i> ' + s.stream_subtitle_codec.toUpperCase() + ')';
+                                subtitle_decision = 'Transcode ('+ capitalizeFirstLetter(s.stream_subtitle_language)+ ' - ' + subtitle_codec + ' <i class="fa fa-long-arrow-right"></i> ' + s.stream_subtitle_codec.toUpperCase() + ')';
                             } else if (s.stream_subtitle_decision === 'copy') {
-                                subtitle_decision = 'Direct Stream (' + subtitle_codec + ')';
+                                subtitle_decision = 'Direct Stream ('+ capitalizeFirstLetter(s.stream_subtitle_language)+ ' - ' + subtitle_codec + ')';
                             } else if (s.stream_subtitle_decision === 'burn') {
-                                subtitle_decision = 'Burn (' + subtitle_codec + ')';
+                                subtitle_decision = 'Burn ('+ capitalizeFirstLetter(s.stream_subtitle_language)+ ' - ' + subtitle_codec + ')';
                             } else {
-                                subtitle_decision = 'Direct Play (' + ((s.synced_version === '1') ? subtitle_codec : s.stream_subtitle_codec.toUpperCase()) + ')';
+                                subtitle_decision = 'Direct Play ('+ capitalizeFirstLetter(s.stream_subtitle_language)+ ' - ' + ((s.synced_version === '1') ? subtitle_codec : s.stream_subtitle_codec.toUpperCase()) + ')';
                             }
                         }
                         $('#subtitle_decision-' + key).html(subtitle_decision);
@@ -1076,4 +1076,4 @@
     }
 </script>
 % endif
-</%def>
\ No newline at end of file
+</%def>

From 7c030ef362e102fc9d13f8a1e32c2cdb637c7207 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Wed, 21 Dec 2022 15:33:34 -0800
Subject: [PATCH 271/743] Link watch statistics to info page using history
 metadata

* Closes #1882
---
 data/interfaces/default/home_stats.html | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/data/interfaces/default/home_stats.html b/data/interfaces/default/home_stats.html
index 9a0c49f4..df2b7b69 100644
--- a/data/interfaces/default/home_stats.html
+++ b/data/interfaces/default/home_stats.html
@@ -102,7 +102,7 @@ DOCUMENTATION :: END
                         if row0['live']:
                             href = page('info', row0['rating_key'], row0['guid'], history=True, live=row0['live'])
                         else:
-                            href = page('info', row0['rating_key'])
+                            href = page('info', row0['rating_key'], history=True)
                 %>
                 <a id="stats-thumb-url-${stat_id}" href="${href}" title="${row0['title']}">
                     <div id="stats-thumb-${stat_id}" class="dashboard-stats-${fallback.split('-')[0]}" style="background-image: url(${page('pms_image_proxy', row0['thumb'], row0['grandparent_rating_key'] or row0['rating_key'], 300, height, fallback=fallback)});"></div>
@@ -157,7 +157,7 @@ DOCUMENTATION :: END
                                             if row['live']:
                                                 href = page('info', row['rating_key'], row['guid'], history=True, live=row['live'])
                                             else:
-                                                href = page('info', row['rating_key'])
+                                                href = page('info', row['rating_key'], history=True)
                                     %>
                                     <a href="${href}" title="${row['title']}">
                                         ${row['title']}

From 023fde7a848eb381163b2de50c57ff28ec1acb2b Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Wed, 21 Dec 2022 16:34:07 -0800
Subject: [PATCH 272/743] Add subtitle_language to database

---
 plexpy/__init__.py | 34 ++++++++++++++++++++++++++++++----
 1 file changed, 30 insertions(+), 4 deletions(-)

diff --git a/plexpy/__init__.py b/plexpy/__init__.py
index e4f64b45..c2e9b4ae 100644
--- a/plexpy/__init__.py
+++ b/plexpy/__init__.py
@@ -638,14 +638,14 @@ def dbcheck():
         'video_framerate TEXT, video_scan_type TEXT, video_full_resolution TEXT, '
         'video_dynamic_range TEXT, aspect_ratio TEXT, '
         'audio_codec TEXT, audio_bitrate INTEGER, audio_channels INTEGER, audio_language TEXT, audio_language_code TEXT, '
-        'subtitle_codec TEXT, stream_bitrate INTEGER, stream_video_resolution TEXT, quality_profile TEXT, '
+        'subtitle_codec TEXT, subtitle_language TEXT, stream_bitrate INTEGER, stream_video_resolution TEXT, quality_profile TEXT, '
         'stream_container_decision TEXT, stream_container TEXT, '
         'stream_video_decision TEXT, stream_video_codec TEXT, stream_video_bitrate INTEGER, stream_video_width INTEGER, '
         'stream_video_height INTEGER, stream_video_framerate TEXT, stream_video_scan_type TEXT, stream_video_full_resolution TEXT, '
         'stream_video_dynamic_range TEXT, '
         'stream_audio_decision TEXT, stream_audio_codec TEXT, stream_audio_bitrate INTEGER, stream_audio_channels INTEGER, '
         'stream_audio_language TEXT, stream_audio_language_code TEXT, '
-        'subtitles INTEGER, stream_subtitle_decision TEXT, stream_subtitle_codec TEXT, '
+        'subtitles INTEGER, stream_subtitle_decision TEXT, stream_subtitle_codec TEXT, stream_subtitle_language TEXT, '
         'transcode_protocol TEXT, transcode_container TEXT, '
         'transcode_video_codec TEXT, transcode_audio_codec TEXT, transcode_audio_channels INTEGER,'
         'transcode_width INTEGER, transcode_height INTEGER, '
@@ -684,6 +684,7 @@ def dbcheck():
         'video_codec TEXT, video_codec_level TEXT, video_width INTEGER, video_height INTEGER, video_resolution TEXT, '
         'video_framerate TEXT, video_scan_type TEXT, video_full_resolution TEXT, video_dynamic_range TEXT, aspect_ratio TEXT, '
         'audio_bitrate INTEGER, audio_codec TEXT, audio_channels INTEGER, audio_language TEXT, audio_language_code TEXT, '
+        'subtitles INTEGER, subtitle_codec TEXT, subtitle_language TEXT,'
         'transcode_protocol TEXT, transcode_container TEXT, transcode_video_codec TEXT, transcode_audio_codec TEXT, '
         'transcode_audio_channels INTEGER, transcode_width INTEGER, transcode_height INTEGER, '
         'transcode_hw_requested INTEGER, transcode_hw_full_pipeline INTEGER, '
@@ -695,8 +696,9 @@ def dbcheck():
         'stream_video_framerate TEXT, stream_video_scan_type TEXT, stream_video_full_resolution TEXT, stream_video_dynamic_range TEXT, '
         'stream_audio_decision TEXT, stream_audio_codec TEXT, stream_audio_bitrate INTEGER, stream_audio_channels INTEGER, '
         'stream_audio_language TEXT, stream_audio_language_code TEXT, '
-        'stream_subtitle_decision TEXT, stream_subtitle_codec TEXT, stream_subtitle_container TEXT, stream_subtitle_forced INTEGER, '
-        'subtitles INTEGER, subtitle_codec TEXT, synced_version INTEGER, synced_version_profile TEXT, '
+        'stream_subtitle_decision TEXT, stream_subtitle_codec TEXT, '
+        'stream_subtitle_container TEXT, stream_subtitle_forced INTEGER, stream_subtitle_language TEXT, '
+        'synced_version INTEGER, synced_version_profile TEXT, '
         'optimized_version INTEGER, optimized_version_profile TEXT, optimized_version_title TEXT)'
     )
 
@@ -1373,6 +1375,18 @@ def dbcheck():
             'ALTER TABLE sessions ADD COLUMN stream_audio_language_code TEXT'
         )
 
+    # Upgrade sessions table from earlier versions
+    try:
+        c_db.execute('SELECT subtitle_language FROM sessions')
+    except sqlite3.OperationalError:
+        logger.debug(u"Altering database. Updating database table sessions.")
+        c_db.execute(
+            'ALTER TABLE sessions ADD COLUMN subtitle_language TEXT'
+        )
+        c_db.execute(
+            'ALTER TABLE sessions ADD COLUMN stream_subtitle_language TEXT'
+        )
+
     # Upgrade session_history table from earlier versions
     try:
         c_db.execute('SELECT reference_id FROM session_history')
@@ -1770,6 +1784,18 @@ def dbcheck():
             'ALTER TABLE session_history_media_info ADD COLUMN stream_audio_language_code TEXT'
         ) 
     
+    # Upgrade session_history_media_info table from earlier versions
+    try:
+        c_db.execute('SELECT subtitle_language FROM session_history_media_info')
+    except sqlite3.OperationalError:
+        logger.debug("Altering database. Updating database table session_history_media_info.")
+        c_db.execute(
+            'ALTER TABLE session_history_media_info ADD COLUMN subtitle_language TEXT'
+        )
+        c_db.execute(
+            'ALTER TABLE session_history_media_info ADD COLUMN stream_subtitle_language TEXT'
+        )
+
     # Upgrade session_history table from earlier versions
     try:
         c_db.execute('SELECT section_id FROM session_history')

From c00dfca2f082e3c99f46525a3d9fe815c702ebf8 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Wed, 21 Dec 2022 16:34:24 -0800
Subject: [PATCH 273/743] Log subtitle language

---
 plexpy/activity_processor.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/plexpy/activity_processor.py b/plexpy/activity_processor.py
index f4e58329..8f0cb977 100644
--- a/plexpy/activity_processor.py
+++ b/plexpy/activity_processor.py
@@ -102,6 +102,7 @@ class ActivityProcessor(object):
                       'audio_language': session.get('audio_language', ''),
                       'audio_language_code': session.get('audio_language_code', ''),
                       'subtitle_codec': session.get('subtitle_codec', ''),
+                      'subtitle_language': session.get('subtitle_language', ''),
                       'transcode_protocol': session.get('transcode_protocol', ''),
                       'transcode_container': session.get('transcode_container', ''),
                       'transcode_video_codec': session.get('transcode_video_codec', ''),
@@ -138,6 +139,7 @@ class ActivityProcessor(object):
                       'stream_audio_language_code': session.get('stream_audio_language_code', ''),
                       'stream_subtitle_decision': session.get('stream_subtitle_decision', ''),
                       'stream_subtitle_codec': session.get('stream_subtitle_codec', ''),
+                      'stream_subitile_language': session.get('stream_subtitle_language', ''),
                       'subtitles': session.get('subtitles', 0),
                       'live': session.get('live', 0),
                       'live_uuid': session.get('live_uuid', ''),
@@ -424,6 +426,7 @@ class ActivityProcessor(object):
                           'audio_language': session['audio_language'],
                           'audio_language_code': session['audio_language_code'],
                           'subtitle_codec': session['subtitle_codec'],
+                          'subtitle_language': session['subtitle_language'],
                           'transcode_protocol': session['transcode_protocol'],
                           'transcode_container': session['transcode_container'],
                           'transcode_video_codec': session['transcode_video_codec'],
@@ -464,6 +467,7 @@ class ActivityProcessor(object):
                           'stream_subtitle_codec': session['stream_subtitle_codec'],
                           'stream_subtitle_container': session['stream_subtitle_container'],
                           'stream_subtitle_forced': session['stream_subtitle_forced'],
+                          'stream_subtitle_language': session['stream_subtitle_language'],
                           'subtitles': session['subtitles'],
                           'synced_version': session['synced_version'],
                           'synced_version_profile': session['synced_version_profile'],

From 44419fb0bfb9a5b5e178dd9b2cf0ba6928e064d8 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Wed, 21 Dec 2022 16:34:52 -0800
Subject: [PATCH 274/743] Display subtitle language in stream data modal

---
 data/interfaces/default/stream_data.html | 11 +++++++++--
 plexpy/datafactory.py                    |  5 +++--
 2 files changed, 12 insertions(+), 4 deletions(-)

diff --git a/data/interfaces/default/stream_data.html b/data/interfaces/default/stream_data.html
index bd2ffb2a..d4c81741 100644
--- a/data/interfaces/default/stream_data.html
+++ b/data/interfaces/default/stream_data.html
@@ -218,10 +218,10 @@ DOCUMENTATION :: END
                         <td>${data['stream_audio_channels']}</td>
                         <td>${data['audio_channels']}</td>
                     </tr>
-                    % if data['stream_audio_language'] != '':
+                    % if data['audio_language'] != '':
                     <tr>
                         <td>Language</td>
-                        <td>${data['stream_audio_language']}</td>
+                        <td>-</td>
                         <td>${data['audio_language']}</td>
                     </tr>
                     % endif
@@ -245,6 +245,13 @@ DOCUMENTATION :: END
                         <td>${data['stream_subtitle_codec'].upper() or '-'}</td>
                         <td>${data['subtitle_codec'].upper()}</td>
                     </tr>
+                    % if data['subtitle_language'] != '':
+                    <tr>
+                        <td>Language</td>
+                        <td>-</td>
+                        <td>${data['subtitle_language']}</td>
+                    </tr>
+                    % endif
                 </tbody>
             </table>
             % endif
diff --git a/plexpy/datafactory.py b/plexpy/datafactory.py
index 8a15ef7d..5a77ba38 100644
--- a/plexpy/datafactory.py
+++ b/plexpy/datafactory.py
@@ -1286,13 +1286,14 @@ class DataFactory(object):
                     'synced_version, synced_version_profile, ' \
                     'container, video_codec, video_bitrate, video_width, video_height, video_framerate, ' \
                     'video_dynamic_range, aspect_ratio, ' \
-                    'audio_codec, audio_bitrate, audio_channels, audio_language, audio_language_code, subtitle_codec, ' \
+                    'audio_codec, audio_bitrate, audio_channels, audio_language, audio_language_code, ' \
+                    'subtitle_codec, subtitle_language, ' \
                     'stream_bitrate, stream_video_full_resolution, quality_profile, stream_container_decision, stream_container, ' \
                     'stream_video_decision, stream_video_codec, stream_video_bitrate, stream_video_width, stream_video_height, ' \
                     'stream_video_framerate, stream_video_dynamic_range, ' \
                     'stream_audio_decision, stream_audio_codec, stream_audio_bitrate, stream_audio_channels, ' \
                     'stream_audio_language, stream_audio_language_code, ' \
-                    'subtitles, stream_subtitle_decision, stream_subtitle_codec, ' \
+                    'subtitles, stream_subtitle_decision, stream_subtitle_codec, stream_subtitle_language, ' \
                     'transcode_hw_decoding, transcode_hw_encoding, ' \
                     'video_decision, audio_decision, transcode_decision, width, height, container, ' \
                     'transcode_container, transcode_video_codec, transcode_audio_codec, transcode_audio_channels, ' \

From 185a5cb0eafe3c080cde550ec85427646fdd6ab3 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Wed, 21 Dec 2022 17:01:24 -0800
Subject: [PATCH 275/743] Add subtitle_forced to database

---
 plexpy/__init__.py | 29 ++++++++++++++++++++++++++---
 1 file changed, 26 insertions(+), 3 deletions(-)

diff --git a/plexpy/__init__.py b/plexpy/__init__.py
index c2e9b4ae..d27cd396 100644
--- a/plexpy/__init__.py
+++ b/plexpy/__init__.py
@@ -638,14 +638,16 @@ def dbcheck():
         'video_framerate TEXT, video_scan_type TEXT, video_full_resolution TEXT, '
         'video_dynamic_range TEXT, aspect_ratio TEXT, '
         'audio_codec TEXT, audio_bitrate INTEGER, audio_channels INTEGER, audio_language TEXT, audio_language_code TEXT, '
-        'subtitle_codec TEXT, subtitle_language TEXT, stream_bitrate INTEGER, stream_video_resolution TEXT, quality_profile TEXT, '
+        'subtitle_codec TEXT, subtitle_forced INTEGER, subtitle_language TEXT, '
+        'stream_bitrate INTEGER, stream_video_resolution TEXT, quality_profile TEXT, '
         'stream_container_decision TEXT, stream_container TEXT, '
         'stream_video_decision TEXT, stream_video_codec TEXT, stream_video_bitrate INTEGER, stream_video_width INTEGER, '
         'stream_video_height INTEGER, stream_video_framerate TEXT, stream_video_scan_type TEXT, stream_video_full_resolution TEXT, '
         'stream_video_dynamic_range TEXT, '
         'stream_audio_decision TEXT, stream_audio_codec TEXT, stream_audio_bitrate INTEGER, stream_audio_channels INTEGER, '
         'stream_audio_language TEXT, stream_audio_language_code TEXT, '
-        'subtitles INTEGER, stream_subtitle_decision TEXT, stream_subtitle_codec TEXT, stream_subtitle_language TEXT, '
+        'subtitles INTEGER, stream_subtitle_decision TEXT, stream_subtitle_codec TEXT, '
+        'stream_subtitle_forced INTEGER, stream_subtitle_language TEXT, '
         'transcode_protocol TEXT, transcode_container TEXT, '
         'transcode_video_codec TEXT, transcode_audio_codec TEXT, transcode_audio_channels INTEGER,'
         'transcode_width INTEGER, transcode_height INTEGER, '
@@ -684,7 +686,7 @@ def dbcheck():
         'video_codec TEXT, video_codec_level TEXT, video_width INTEGER, video_height INTEGER, video_resolution TEXT, '
         'video_framerate TEXT, video_scan_type TEXT, video_full_resolution TEXT, video_dynamic_range TEXT, aspect_ratio TEXT, '
         'audio_bitrate INTEGER, audio_codec TEXT, audio_channels INTEGER, audio_language TEXT, audio_language_code TEXT, '
-        'subtitles INTEGER, subtitle_codec TEXT, subtitle_language TEXT,'
+        'subtitles INTEGER, subtitle_codec TEXT, subtitle_forced, subtitle_language TEXT,'
         'transcode_protocol TEXT, transcode_container TEXT, transcode_video_codec TEXT, transcode_audio_codec TEXT, '
         'transcode_audio_channels INTEGER, transcode_width INTEGER, transcode_height INTEGER, '
         'transcode_hw_requested INTEGER, transcode_hw_full_pipeline INTEGER, '
@@ -1387,6 +1389,18 @@ def dbcheck():
             'ALTER TABLE sessions ADD COLUMN stream_subtitle_language TEXT'
         )
 
+    # Upgrade sessions table from earlier versions
+    try:
+        c_db.execute('SELECT subtitle_forced FROM sessions')
+    except sqlite3.OperationalError:
+        logger.debug(u"Altering database. Updating database table sessions.")
+        c_db.execute(
+            'ALTER TABLE sessions ADD COLUMN subtitle_forced INTEGER'
+        )
+        c_db.execute(
+            'ALTER TABLE sessions ADD COLUMN stream_subtitle_forced INTEGER'
+        )
+
     # Upgrade session_history table from earlier versions
     try:
         c_db.execute('SELECT reference_id FROM session_history')
@@ -1796,6 +1810,15 @@ def dbcheck():
             'ALTER TABLE session_history_media_info ADD COLUMN stream_subtitle_language TEXT'
         )
 
+    # Upgrade session_history_media_info table from earlier versions
+    try:
+        c_db.execute('SELECT subtitle_forced FROM session_history_media_info')
+    except sqlite3.OperationalError:
+        logger.debug("Altering database. Updating database table session_history_media_info.")
+        c_db.execute(
+            'ALTER TABLE session_history_media_info ADD COLUMN subtitle_forced INTEGER'
+        )
+
     # Upgrade session_history table from earlier versions
     try:
         c_db.execute('SELECT section_id FROM session_history')

From 5a9ace0b1924d841fcfd1b8e49579c5054c6b4ab Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Wed, 21 Dec 2022 17:01:50 -0800
Subject: [PATCH 276/743] Log subtitle forced

---
 plexpy/activity_processor.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/plexpy/activity_processor.py b/plexpy/activity_processor.py
index 8f0cb977..4608e4c8 100644
--- a/plexpy/activity_processor.py
+++ b/plexpy/activity_processor.py
@@ -102,6 +102,7 @@ class ActivityProcessor(object):
                       'audio_language': session.get('audio_language', ''),
                       'audio_language_code': session.get('audio_language_code', ''),
                       'subtitle_codec': session.get('subtitle_codec', ''),
+                      'subtitle_forced': session.get('subtitle_forced', ''),
                       'subtitle_language': session.get('subtitle_language', ''),
                       'transcode_protocol': session.get('transcode_protocol', ''),
                       'transcode_container': session.get('transcode_container', ''),
@@ -139,7 +140,8 @@ class ActivityProcessor(object):
                       'stream_audio_language_code': session.get('stream_audio_language_code', ''),
                       'stream_subtitle_decision': session.get('stream_subtitle_decision', ''),
                       'stream_subtitle_codec': session.get('stream_subtitle_codec', ''),
-                      'stream_subitile_language': session.get('stream_subtitle_language', ''),
+                      'stream_subtitle_forced': session.get('stream_subtitle_forced', ''),
+                      'stream_subtitle_language': session.get('stream_subtitle_language', ''),
                       'subtitles': session.get('subtitles', 0),
                       'live': session.get('live', 0),
                       'live_uuid': session.get('live_uuid', ''),
@@ -426,6 +428,7 @@ class ActivityProcessor(object):
                           'audio_language': session['audio_language'],
                           'audio_language_code': session['audio_language_code'],
                           'subtitle_codec': session['subtitle_codec'],
+                          'subtitle_forced': session['subtitle_forced'],
                           'subtitle_language': session['subtitle_language'],
                           'transcode_protocol': session['transcode_protocol'],
                           'transcode_container': session['transcode_container'],

From bcb9a9d6c60cee4b033919d7b1b776735277c5c5 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Wed, 21 Dec 2022 17:02:10 -0800
Subject: [PATCH 277/743] Display subtitle forced in stream data modal

---
 data/interfaces/default/stream_data.html |  7 +++++++
 plexpy/datafactory.py                    | 13 +++++++++----
 2 files changed, 16 insertions(+), 4 deletions(-)

diff --git a/data/interfaces/default/stream_data.html b/data/interfaces/default/stream_data.html
index d4c81741..9ccdc061 100644
--- a/data/interfaces/default/stream_data.html
+++ b/data/interfaces/default/stream_data.html
@@ -245,6 +245,13 @@ DOCUMENTATION :: END
                         <td>${data['stream_subtitle_codec'].upper() or '-'}</td>
                         <td>${data['subtitle_codec'].upper()}</td>
                     </tr>
+                    % if data['subtitle_forced']:
+                    <tr>
+                        <td>Forced</td>
+                        <td>-</td>
+                        <td>${bool(data['subtitle_forced'])}</td>
+                    </tr>
+                    % endif
                     % if data['subtitle_language'] != '':
                     <tr>
                         <td>Language</td>
diff --git a/plexpy/datafactory.py b/plexpy/datafactory.py
index 5a77ba38..700c14c6 100644
--- a/plexpy/datafactory.py
+++ b/plexpy/datafactory.py
@@ -1287,13 +1287,13 @@ class DataFactory(object):
                     'container, video_codec, video_bitrate, video_width, video_height, video_framerate, ' \
                     'video_dynamic_range, aspect_ratio, ' \
                     'audio_codec, audio_bitrate, audio_channels, audio_language, audio_language_code, ' \
-                    'subtitle_codec, subtitle_language, ' \
+                    'subtitle_codec, subtitle_forced, subtitle_language, ' \
                     'stream_bitrate, stream_video_full_resolution, quality_profile, stream_container_decision, stream_container, ' \
                     'stream_video_decision, stream_video_codec, stream_video_bitrate, stream_video_width, stream_video_height, ' \
                     'stream_video_framerate, stream_video_dynamic_range, ' \
                     'stream_audio_decision, stream_audio_codec, stream_audio_bitrate, stream_audio_channels, ' \
                     'stream_audio_language, stream_audio_language_code, ' \
-                    'subtitles, stream_subtitle_decision, stream_subtitle_codec, stream_subtitle_language, ' \
+                    'subtitles, stream_subtitle_decision, stream_subtitle_codec, stream_subtitle_forced, stream_subtitle_language, ' \
                     'transcode_hw_decoding, transcode_hw_encoding, ' \
                     'video_decision, audio_decision, transcode_decision, width, height, container, ' \
                     'transcode_container, transcode_video_codec, transcode_audio_codec, transcode_audio_channels, ' \
@@ -1310,13 +1310,14 @@ class DataFactory(object):
                     'synced_version, synced_version_profile, ' \
                     'container, video_codec, video_bitrate, video_width, video_height, video_framerate, ' \
                     'video_dynamic_range, aspect_ratio, ' \
-                    'audio_codec, audio_bitrate, audio_channels, audio_language, audio_language_code, subtitle_codec, ' \
+                    'audio_codec, audio_bitrate, audio_channels, audio_language, audio_language_code, ' \
+                    'subtitle_codec, subtitle_forced, subtitle_language, ' \
                     'stream_bitrate, stream_video_full_resolution, quality_profile, stream_container_decision, stream_container, ' \
                     'stream_video_decision, stream_video_codec, stream_video_bitrate, stream_video_width, stream_video_height, ' \
                     'stream_video_framerate, stream_video_dynamic_range, ' \
                     'stream_audio_decision, stream_audio_codec, stream_audio_bitrate, stream_audio_channels, ' \
                     'stream_audio_language, stream_audio_language_code, ' \
-                    'subtitles, stream_subtitle_decision, stream_subtitle_codec, ' \
+                    'subtitles, stream_subtitle_decision, stream_subtitle_codec, stream_subtitle_forced, stream_subtitle_language, ' \
                     'transcode_hw_decoding, transcode_hw_encoding, ' \
                     'video_decision, audio_decision, transcode_decision, width, height, container, ' \
                     'transcode_container, transcode_video_codec, transcode_audio_codec, transcode_audio_channels, ' \
@@ -1369,6 +1370,8 @@ class DataFactory(object):
                              'audio_language': item['audio_language'],
                              'audio_language_code': item['audio_language_code'],
                              'subtitle_codec': item['subtitle_codec'],
+                             'subtitle_forced': item['subtitle_forced'],
+                             'subtitle_language': item['subtitle_language'],
                              'stream_bitrate': item['stream_bitrate'],
                              'stream_video_full_resolution': item['stream_video_full_resolution'],
                              'quality_profile': item['quality_profile'],
@@ -1390,6 +1393,8 @@ class DataFactory(object):
                              'subtitles': item['subtitles'],
                              'stream_subtitle_decision': item['stream_subtitle_decision'],
                              'stream_subtitle_codec': item['stream_subtitle_codec'],
+                             'stream_subtitle_forced': item['stream_subtitle_forced'],
+                             'stream_subtitle_language': item['stream_subtitle_language'],
                              'transcode_hw_decoding': item['transcode_hw_decoding'],
                              'transcode_hw_encoding': item['transcode_hw_encoding'],
                              'video_decision': item['video_decision'],

From fe1d850e1c1feff12620c95841bdf1d3aa1c961e Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Wed, 21 Dec 2022 17:24:14 -0800
Subject: [PATCH 278/743] Display "Unknown" language in stream data modal

---
 data/interfaces/default/stream_data.html | 17 +++++++----------
 1 file changed, 7 insertions(+), 10 deletions(-)

diff --git a/data/interfaces/default/stream_data.html b/data/interfaces/default/stream_data.html
index 9ccdc061..7731e3f7 100644
--- a/data/interfaces/default/stream_data.html
+++ b/data/interfaces/default/stream_data.html
@@ -218,13 +218,12 @@ DOCUMENTATION :: END
                         <td>${data['stream_audio_channels']}</td>
                         <td>${data['audio_channels']}</td>
                     </tr>
-                    % if data['audio_language'] != '':
                     <tr>
                         <td>Language</td>
                         <td>-</td>
-                        <td>${data['audio_language']}</td>
+                        <td>${data['audio_language'] or 'Unknown'}</td>
                     </tr>
-                    % endif
+
                 </tbody>
             </table>
             % if data['subtitles'] == 1:
@@ -245,6 +244,11 @@ DOCUMENTATION :: END
                         <td>${data['stream_subtitle_codec'].upper() or '-'}</td>
                         <td>${data['subtitle_codec'].upper()}</td>
                     </tr>
+                    <tr>
+                        <td>Language</td>
+                        <td>-</td>
+                        <td>${data['subtitle_language'] or 'Unknown'}</td>
+                    </tr>
                     % if data['subtitle_forced']:
                     <tr>
                         <td>Forced</td>
@@ -252,13 +256,6 @@ DOCUMENTATION :: END
                         <td>${bool(data['subtitle_forced'])}</td>
                     </tr>
                     % endif
-                    % if data['subtitle_language'] != '':
-                    <tr>
-                        <td>Language</td>
-                        <td>-</td>
-                        <td>${data['subtitle_language']}</td>
-                    </tr>
-                    % endif
                 </tbody>
             </table>
             % endif

From 8eed162367e7e42b6b1b47820e3a8698a4a262d9 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Wed, 21 Dec 2022 17:24:41 -0800
Subject: [PATCH 279/743] Override direct play subtitle decision in stream data
 modal

---
 data/interfaces/default/stream_data.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/data/interfaces/default/stream_data.html b/data/interfaces/default/stream_data.html
index 7731e3f7..9e42189b 100644
--- a/data/interfaces/default/stream_data.html
+++ b/data/interfaces/default/stream_data.html
@@ -234,7 +234,7 @@ DOCUMENTATION :: END
                             Subtitles
                         </th>
                         <th>
-                            ${data['stream_subtitle_decision']}
+                            ${'direct play' if data['stream_subtitle_decision'] not in ('transcode', 'copy', 'burn') else data['stream_subtitle_decision']}
                         </th>
                     </tr>
                 </thead>

From d426c3e12ec59845e120447fbb6d9d657c6f0eab Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Wed, 21 Dec 2022 17:25:18 -0800
Subject: [PATCH 280/743] Don't capitalize language and display "Unknown" on
 activity cards

---
 .../default/current_activity_instance.html         | 14 +++++++-------
 data/interfaces/default/index.html                 | 14 +++++++-------
 2 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/data/interfaces/default/current_activity_instance.html b/data/interfaces/default/current_activity_instance.html
index 83660745..d0e95ac8 100644
--- a/data/interfaces/default/current_activity_instance.html
+++ b/data/interfaces/default/current_activity_instance.html
@@ -266,11 +266,11 @@ DOCUMENTATION :: END
                                 <div class="sub-value" id="audio_decision-${sk}">
                                     % if data['stream_audio_decision']:
                                         % if data['stream_audio_decision'] == 'transcode':
-                                        Transcode (${data['stream_audio_language'].capitalize()} - ${AUDIO_CODEC_OVERRIDES.get(data['audio_codec'], data['audio_codec'].upper())} ${data['audio_channel_layout'].split('(')[0].capitalize()} <i class="fa fa-long-arrow-right"></i> ${AUDIO_CODEC_OVERRIDES.get(data['stream_audio_codec'], data['stream_audio_codec'].upper())} ${data['stream_audio_channel_layout'].split('(')[0].capitalize()})
+                                        Transcode (${data['stream_audio_language'] or 'Unknown'} - ${AUDIO_CODEC_OVERRIDES.get(data['audio_codec'], data['audio_codec'].upper())} ${data['audio_channel_layout'].split('(')[0].capitalize()} <i class="fa fa-long-arrow-right"></i> ${AUDIO_CODEC_OVERRIDES.get(data['stream_audio_codec'], data['stream_audio_codec'].upper())} ${data['stream_audio_channel_layout'].split('(')[0].capitalize()})
                                         % elif data['stream_audio_decision'] == 'copy':
-                                        Direct Stream (${data['stream_audio_language'].capitalize()} - ${AUDIO_CODEC_OVERRIDES.get(data['stream_audio_codec'], data['stream_audio_codec'].upper())} ${data['stream_audio_channel_layout'].split('(')[0].capitalize()})
+                                        Direct Stream (${data['stream_audio_language'] or 'Unknown'} - ${AUDIO_CODEC_OVERRIDES.get(data['stream_audio_codec'], data['stream_audio_codec'].upper())} ${data['stream_audio_channel_layout'].split('(')[0].capitalize()})
                                         % else:
-                                        Direct Play (${data['stream_audio_language'].capitalize()} - ${AUDIO_CODEC_OVERRIDES.get(data['stream_audio_codec'], data['stream_audio_codec'].upper())} ${data['stream_audio_channel_layout'].split('(')[0].capitalize()})
+                                        Direct Play (${data['stream_audio_language'] or 'Unknown'} - ${AUDIO_CODEC_OVERRIDES.get(data['stream_audio_codec'], data['stream_audio_codec'].upper())} ${data['stream_audio_channel_layout'].split('(')[0].capitalize()})
                                         % endif
                                     % endif
                                 </div>
@@ -285,13 +285,13 @@ DOCUMENTATION :: END
                                             subtitle_codec = 'None' if data['stream_subtitle_codec'] and data['stream_subtitle_transient'] else data['subtitle_codec'].upper()
                                         %>
                                         % if data['stream_subtitle_decision'] == 'transcode':
-                                        Transcode (${data['stream_subtitle_language'].capitalize()} - ${subtitle_codec} <i class="fa fa-long-arrow-right"></i> ${data['stream_subtitle_codec'].upper()})
+                                        Transcode (${data['stream_subtitle_language'] or 'Unknown'} - ${subtitle_codec} <i class="fa fa-long-arrow-right"></i> ${data['stream_subtitle_codec'].upper()})
                                         % elif data['stream_subtitle_decision'] == 'copy':
-                                        Direct Stream (${data['stream_subtitle_language'].capitalize()} - ${subtitle_codec})
+                                        Direct Stream (${data['stream_subtitle_language'] or 'Unknown'} - ${subtitle_codec})
                                         % elif data['stream_subtitle_decision'] == 'burn':
-                                        Burn (${data['stream_subtitle_language'].capitalize()} - ${subtitle_codec})
+                                        Burn (${data['stream_subtitle_language'] or 'Unknown'} - ${subtitle_codec})
                                         % else:
-                                        Direct Play (${data['stream_subtitle_language'].capitalize()} - ${subtitle_codec if data['synced_version'] else data['stream_subtitle_codec'].upper()})
+                                        Direct Play (${data['stream_subtitle_language'] or 'Unknown'} - ${subtitle_codec if data['synced_version'] else data['stream_subtitle_codec'].upper()})
                                         % endif
                                     % else:
                                     None
diff --git a/data/interfaces/default/index.html b/data/interfaces/default/index.html
index adcefce6..e4cc7d51 100644
--- a/data/interfaces/default/index.html
+++ b/data/interfaces/default/index.html
@@ -526,11 +526,11 @@
                             var a_codec = (s.audio_codec === 'truehd') ? 'TrueHD' : s.audio_codec.toUpperCase();
                             var sa_codec = (s.stream_audio_codec === 'truehd') ? 'TrueHD' : s.stream_audio_codec.toUpperCase();
                             if (s.stream_audio_decision === 'transcode') {
-                                audio_decision = 'Transcode ('+ capitalizeFirstLetter(s.stream_audio_language)+ ' - ' + a_codec + ' ' + capitalizeFirstLetter(s.audio_channel_layout.split('(')[0]) + ' <i class="fa fa-long-arrow-right"></i> ' + sa_codec + ' ' + capitalizeFirstLetter(s.stream_audio_channel_layout.split('(')[0]) + ')';
+                                audio_decision = 'Transcode ('+ (s.stream_audio_language || 'Unknown')+ ' - ' + a_codec + ' ' + capitalizeFirstLetter(s.audio_channel_layout.split('(')[0]) + ' <i class="fa fa-long-arrow-right"></i> ' + sa_codec + ' ' + capitalizeFirstLetter(s.stream_audio_channel_layout.split('(')[0]) + ')';
                             } else if (s.stream_audio_decision === 'copy') {
-                                audio_decision = 'Direct Stream ('+ capitalizeFirstLetter(s.stream_audio_language)+ ' - ' + sa_codec + ' ' + capitalizeFirstLetter(s.stream_audio_channel_layout.split('(')[0]) + ')';
+                                audio_decision = 'Direct Stream ('+ (s.stream_audio_language || 'Unknown')+ ' - ' + sa_codec + ' ' + capitalizeFirstLetter(s.stream_audio_channel_layout.split('(')[0]) + ')';
                             } else {
-                                audio_decision = 'Direct Play ('+ capitalizeFirstLetter(s.stream_audio_language)+ ' - ' + sa_codec + ' ' + capitalizeFirstLetter(s.stream_audio_channel_layout.split('(')[0]) + ')';
+                                audio_decision = 'Direct Play ('+ (s.stream_audio_language || 'Unknown')+ ' - ' + sa_codec + ' ' + capitalizeFirstLetter(s.stream_audio_channel_layout.split('(')[0]) + ')';
                             }
                         }
                         $('#audio_decision-' + key).html(audio_decision);
@@ -539,13 +539,13 @@
                         if (['movie', 'episode', 'clip'].indexOf(s.media_type) > -1 && s.subtitles === 1) {
                             var subtitle_codec = (s.stream_subtitle_codec && s.stream_subtitle_transient) ? 'None' : s.subtitle_codec.toUpperCase();
                             if (s.stream_subtitle_decision === 'transcode') {
-                                subtitle_decision = 'Transcode ('+ capitalizeFirstLetter(s.stream_subtitle_language)+ ' - ' + subtitle_codec + ' <i class="fa fa-long-arrow-right"></i> ' + s.stream_subtitle_codec.toUpperCase() + ')';
+                                subtitle_decision = 'Transcode ('+ (s.stream_subtitle_language || 'Unknown')+ ' - ' + subtitle_codec + ' <i class="fa fa-long-arrow-right"></i> ' + s.stream_subtitle_codec.toUpperCase() + ')';
                             } else if (s.stream_subtitle_decision === 'copy') {
-                                subtitle_decision = 'Direct Stream ('+ capitalizeFirstLetter(s.stream_subtitle_language)+ ' - ' + subtitle_codec + ')';
+                                subtitle_decision = 'Direct Stream ('+ (s.stream_subtitle_language || 'Unknown')+ ' - ' + subtitle_codec + ')';
                             } else if (s.stream_subtitle_decision === 'burn') {
-                                subtitle_decision = 'Burn ('+ capitalizeFirstLetter(s.stream_subtitle_language)+ ' - ' + subtitle_codec + ')';
+                                subtitle_decision = 'Burn ('+ (s.stream_subtitle_language || 'Unknown')+ ' - ' + subtitle_codec + ')';
                             } else {
-                                subtitle_decision = 'Direct Play ('+ capitalizeFirstLetter(s.stream_subtitle_language)+ ' - ' + ((s.synced_version === '1') ? subtitle_codec : s.stream_subtitle_codec.toUpperCase()) + ')';
+                                subtitle_decision = 'Direct Play ('+ (s.stream_subtitle_language || 'Unknown')+ ' - ' + ((s.synced_version === '1') ? subtitle_codec : s.stream_subtitle_codec.toUpperCase()) + ')';
                             }
                         }
                         $('#subtitle_decision-' + key).html(subtitle_decision);

From 8cd5b0b77510d857a1d3c6aa74ce8d3df2fcaa1b Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Wed, 21 Dec 2022 17:25:40 -0800
Subject: [PATCH 281/743] Use system language for requests

---
 plexpy/http_handler.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/plexpy/http_handler.py b/plexpy/http_handler.py
index 974b9ce4..87c4cff5 100644
--- a/plexpy/http_handler.py
+++ b/plexpy/http_handler.py
@@ -61,7 +61,8 @@ class HTTPHandler(object):
                 'X-Plex-Device': '{} {}'.format(plexpy.common.PLATFORM,
                                                 plexpy.common.PLATFORM_RELEASE),
                 'X-Plex-Device-Name': '{} ({})'.format(plexpy.common.PLATFORM_DEVICE_NAME,
-                                                       plexpy.common.PRODUCT)
+                                                       plexpy.common.PRODUCT),
+                'Accept-Language': plexpy.SYS_LANGUAGE
             }
 
         self.token = token

From 31f6b02149786acd370e3e43322c98c02e738cce Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 22 Dec 2022 10:44:51 -0800
Subject: [PATCH 282/743] Bump plexapi from 4.13.1 to 4.13.2 (#1939)

* Bump plexapi from 4.13.1 to 4.13.2

Bumps [plexapi](https://github.com/pkkid/python-plexapi) from 4.13.1 to 4.13.2.
- [Release notes](https://github.com/pkkid/python-plexapi/releases)
- [Commits](https://github.com/pkkid/python-plexapi/compare/4.13.1...4.13.2)

---
updated-dependencies:
- dependency-name: plexapi
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

* Update plexapi==4.13.2

Signed-off-by: dependabot[bot] <support@github.com>
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/plexapi/base.py       | 23 ++++++----
 lib/plexapi/collection.py |  5 --
 lib/plexapi/const.py      |  2 +-
 lib/plexapi/library.py    | 19 ++++----
 lib/plexapi/media.py      | 63 ++++++++++++++++++++-----
 lib/plexapi/mixins.py     | 26 ++++++-----
 lib/plexapi/myplex.py     | 37 ++++++++++-----
 lib/plexapi/playlist.py   | 36 +++++++++++----
 lib/plexapi/playqueue.py  | 19 ++++----
 lib/plexapi/server.py     | 96 +++++++++++++++++++++++++++++----------
 lib/plexapi/settings.py   |  9 +++-
 lib/plexapi/utils.py      | 12 +++++
 lib/plexapi/video.py      |  8 ++++
 requirements.txt          |  2 +-
 14 files changed, 250 insertions(+), 107 deletions(-)

diff --git a/lib/plexapi/base.py b/lib/plexapi/base.py
index 2cb78c53..fe6f0be0 100644
--- a/lib/plexapi/base.py
+++ b/lib/plexapi/base.py
@@ -6,6 +6,7 @@ from xml.etree import ElementTree
 
 from plexapi import log, utils
 from plexapi.exceptions import BadRequest, NotFound, UnknownType, Unsupported
+from plexapi.utils import cached_property
 
 USER_DONT_RELOAD_FOR_KEYS = set()
 _DONT_RELOAD_FOR_KEYS = {'key'}
@@ -666,6 +667,13 @@ class PlexPartialObject(PlexObject):
         """
         return self._getWebURL(base=base)
 
+    def playQueue(self, *args, **kwargs):
+        """ Returns a new :class:`~plexapi.playqueue.PlayQueue` from this media item.
+            See :func:`~plexapi.playqueue.PlayQueue.create` for available parameters.
+        """
+        from plexapi.playqueue import PlayQueue
+        return PlayQueue.create(self._server, self, *args, **kwargs)
+
 
 class Playable:
     """ This is a general place to store functions specific to media that is Playable.
@@ -841,7 +849,6 @@ class PlexSession(object):
         user = data.find('User')
         self._username = user.attrib.get('title')
         self._userId = utils.cast(int, user.attrib.get('id'))
-        self._user = None  # Cache for user object
 
         # For backwards compatibility
         self.players = [self.player] if self.player else []
@@ -849,18 +856,16 @@ class PlexSession(object):
         self.transcodeSessions = [self.transcodeSession] if self.transcodeSession else []
         self.usernames = [self._username] if self._username else []
 
-    @property
+    @cached_property
     def user(self):
         """ Returns the :class:`~plexapi.myplex.MyPlexAccount` object (for admin)
             or :class:`~plexapi.myplex.MyPlexUser` object (for users) for this session.
         """
-        if self._user is None:
-            myPlexAccount = self._server.myPlexAccount()
-            if self._userId == 1:
-                self._user = myPlexAccount
-            else:
-                self._user = myPlexAccount.user(self._username)
-        return self._user
+        myPlexAccount = self._server.myPlexAccount()
+        if self._userId == 1:
+            return myPlexAccount
+
+        return myPlexAccount.user(self._username)
 
     def reload(self):
         """ Reload the data for the session.
diff --git a/lib/plexapi/collection.py b/lib/plexapi/collection.py
index ff26cf32..4561c158 100644
--- a/lib/plexapi/collection.py
+++ b/lib/plexapi/collection.py
@@ -11,7 +11,6 @@ from plexapi.mixins import (
     ContentRatingMixin, SortTitleMixin, SummaryMixin, TitleMixin,
     LabelMixin
 )
-from plexapi.playqueue import PlayQueue
 from plexapi.utils import deprecated
 
 
@@ -427,10 +426,6 @@ class Collection(
         """ Delete the collection. """
         super(Collection, self).delete()
 
-    def playQueue(self, *args, **kwargs):
-        """ Returns a new :class:`~plexapi.playqueue.PlayQueue` from the collection. """
-        return PlayQueue.create(self._server, self.items(), *args, **kwargs)
-
     @classmethod
     def _create(cls, server, title, section, items):
         """ Create a regular collection. """
diff --git a/lib/plexapi/const.py b/lib/plexapi/const.py
index 8ac71b57..605ed78c 100644
--- a/lib/plexapi/const.py
+++ b/lib/plexapi/const.py
@@ -4,6 +4,6 @@
 # Library version
 MAJOR_VERSION = 4
 MINOR_VERSION = 13
-PATCH_VERSION = 1
+PATCH_VERSION = 2
 __short_version__ = f"{MAJOR_VERSION}.{MINOR_VERSION}"
 __version__ = f"{__short_version__}.{PATCH_VERSION}"
diff --git a/lib/plexapi/library.py b/lib/plexapi/library.py
index 647a89f0..ce2df733 100644
--- a/lib/plexapi/library.py
+++ b/lib/plexapi/library.py
@@ -7,7 +7,7 @@ from plexapi import X_PLEX_CONTAINER_SIZE, log, media, utils
 from plexapi.base import OPERATORS, PlexObject
 from plexapi.exceptions import BadRequest, NotFound
 from plexapi.settings import Setting
-from plexapi.utils import deprecated
+from plexapi.utils import cached_property, deprecated
 
 
 class Library(PlexObject):
@@ -418,7 +418,6 @@ class LibrarySection(PlexObject):
         self._filterTypes = None
         self._fieldTypes = None
         self._totalViewSize = None
-        self._totalSize = None
         self._totalDuration = None
         self._totalStorage = None
 
@@ -456,12 +455,10 @@ class LibrarySection(PlexObject):
                 item.librarySectionID = librarySectionID
         return items
 
-    @property
+    @cached_property
     def totalSize(self):
         """ Returns the total number of items in the library for the default library type. """
-        if self._totalSize is None:
-            self._totalSize = self.totalViewSize(includeCollections=False)
-        return self._totalSize
+        return self.totalViewSize(includeCollections=False)
 
     @property
     def totalDuration(self):
@@ -644,12 +641,12 @@ class LibrarySection(PlexObject):
                     guidLookup = {}
                     for item in library.all():
                         guidLookup[item.guid] = item
-                        guidLookup.update({guid.id for guid in item.guids}}
+                        guidLookup.update({guid.id: item for guid in item.guids}}
 
                     result1 = guidLookup['plex://show/5d9c086c46115600200aa2fe']
                     result2 = guidLookup['imdb://tt0944947']
-                    result4 = guidLookup['tmdb://1399']
-                    result5 = guidLookup['tvdb://121361']
+                    result3 = guidLookup['tmdb://1399']
+                    result4 = guidLookup['tvdb://121361']
 
         """
 
@@ -1671,13 +1668,13 @@ class LibrarySection(PlexObject):
         return self.search(libtype='collection', **kwargs)
 
     def createPlaylist(self, title, items=None, smart=False, limit=None,
-                       sort=None, filters=None, **kwargs):
+                       sort=None, filters=None, m3ufilepath=None, **kwargs):
         """ Alias for :func:`~plexapi.server.PlexServer.createPlaylist` using this
             :class:`~plexapi.library.LibrarySection`.
         """
         return self._server.createPlaylist(
             title, section=self, items=items, smart=smart, limit=limit,
-            sort=sort, filters=filters, **kwargs)
+            sort=sort, filters=filters, m3ufilepath=m3ufilepath, **kwargs)
 
     def playlist(self, title):
         """ Returns the playlist with the specified title.
diff --git a/lib/plexapi/media.py b/lib/plexapi/media.py
index ccdf9fab..c8ea8c4e 100644
--- a/lib/plexapi/media.py
+++ b/lib/plexapi/media.py
@@ -672,6 +672,7 @@ class MediaTag(PlexObject):
             role (str): The name of the character role for :class:`~plexapi.media.Role` only.
             tag (str): Name of the tag. This will be Animation, SciFi etc for Genres. The name of
                 person for Directors and Roles (ex: Animation, Stephen Graham, etc).
+            tagKey (str): Plex GUID for the actor/actress for :class:`~plexapi.media.Role` only.
             thumb (str): URL to thumbnail image for :class:`~plexapi.media.Role` only.
     """
 
@@ -687,6 +688,7 @@ class MediaTag(PlexObject):
         self.key = data.attrib.get('key')
         self.role = data.attrib.get('role')
         self.tag = data.attrib.get('tag')
+        self.tagKey = data.attrib.get('tagKey')
         self.thumb = data.attrib.get('thumb')
 
         parent = self._parent()
@@ -879,12 +881,15 @@ class Writer(MediaTag):
     FILTER = 'writer'
 
 
-class GuidTag(PlexObject):
-    """ Base class for guid tags used only for Guids, as they contain only a string identifier
+@utils.registerPlexObject
+class Guid(PlexObject):
+    """ Represents a single Guid media tag.
 
         Attributes:
+            TAG (str): 'Guid'
             id (id): The guid for external metadata sources (e.g. IMDB, TMDB, TVDB, MBID).
     """
+    TAG = 'Guid'
 
     def _loadData(self, data):
         """ Load attribute values from Plex XML response. """
@@ -893,13 +898,25 @@ class GuidTag(PlexObject):
 
 
 @utils.registerPlexObject
-class Guid(GuidTag):
-    """ Represents a single Guid media tag.
+class Rating(PlexObject):
+    """ Represents a single Rating media tag.
 
         Attributes:
-            TAG (str): 'Guid'
+            TAG (str): 'Rating'
+            image (str): The uri for the rating image
+                (e.g. ``imdb://image.rating``, ``rottentomatoes://image.rating.ripe``,
+                ``rottentomatoes://image.rating.upright``, ``themoviedb://image.rating``).
+            type (str): The type of rating (e.g. audience or critic).
+            value (float): The rating value.
     """
-    TAG = 'Guid'
+    TAG = 'Rating'
+
+    def _loadData(self, data):
+        """ Load attribute values from Plex XML response. """
+        self._data = data
+        self.image = data.attrib.get('image')
+        self.type = data.attrib.get('type')
+        self.value = utils.cast(float, data.attrib.get('value'))
 
 
 @utils.registerPlexObject
@@ -908,7 +925,7 @@ class Review(PlexObject):
 
         Attributes:
             TAG (str): 'Review'
-            filter (str): filter for reviews?
+            filter (str): The library filter for the review.
             id (int): The ID of the review.
             image (str): The image uri for the review.
             link (str): The url to the online review.
@@ -983,18 +1000,34 @@ class Chapter(PlexObject):
 
         Attributes:
             TAG (str): 'Chapter'
+            end (int): The end time of the chapter in milliseconds.
+            filter (str): The library filter for the chapter.
+            id (int): The ID of the chapter.
+            index (int): The index of the chapter.
+            tag (str): The name of the chapter.
+            title (str): The title of the chapter.
+            thumb (str): The URL to retrieve the chapter thumbnail.
+            start (int): The start time of the chapter in milliseconds.
     """
     TAG = 'Chapter'
 
+    def __repr__(self):
+        name = self._clean(self.firstAttr('tag'))
+        start = utils.millisecondToHumanstr(self._clean(self.firstAttr('start')))
+        end = utils.millisecondToHumanstr(self._clean(self.firstAttr('end')))
+        offsets = f'{start}-{end}'
+        return f"<{':'.join([self.__class__.__name__, name, offsets])}>"
+
     def _loadData(self, data):
         self._data = data
+        self.end = utils.cast(int, data.attrib.get('endTimeOffset'))
+        self.filter = data.attrib.get('filter')
         self.id = utils.cast(int, data.attrib.get('id', 0))
-        self.filter = data.attrib.get('filter')  # I couldn't filter on it anyways
+        self.index = utils.cast(int, data.attrib.get('index'))
         self.tag = data.attrib.get('tag')
         self.title = self.tag
-        self.index = utils.cast(int, data.attrib.get('index'))
+        self.thumb = data.attrib.get('thumb')
         self.start = utils.cast(int, data.attrib.get('startTimeOffset'))
-        self.end = utils.cast(int, data.attrib.get('endTimeOffset'))
 
 
 @utils.registerPlexObject
@@ -1003,6 +1036,10 @@ class Marker(PlexObject):
 
         Attributes:
             TAG (str): 'Marker'
+            end (int): The end time of the marker in milliseconds.
+            id (int): The ID of the marker.
+            type (str): The type of marker.
+            start (int): The start time of the marker in milliseconds.
     """
     TAG = 'Marker'
 
@@ -1015,10 +1052,10 @@ class Marker(PlexObject):
 
     def _loadData(self, data):
         self._data = data
+        self.end = utils.cast(int, data.attrib.get('endTimeOffset'))
         self.id = utils.cast(int, data.attrib.get('id'))
         self.type = data.attrib.get('type')
         self.start = utils.cast(int, data.attrib.get('startTimeOffset'))
-        self.end = utils.cast(int, data.attrib.get('endTimeOffset'))
 
 
 @utils.registerPlexObject
@@ -1027,13 +1064,15 @@ class Field(PlexObject):
 
         Attributes:
             TAG (str): 'Field'
+            locked (bool): True if the field is locked.
+            name (str): The name of the field.
     """
     TAG = 'Field'
 
     def _loadData(self, data):
         self._data = data
-        self.name = data.attrib.get('name')
         self.locked = utils.cast(bool, data.attrib.get('locked'))
+        self.name = data.attrib.get('name')
 
 
 @utils.registerPlexObject
diff --git a/lib/plexapi/mixins.py b/lib/plexapi/mixins.py
index 16414cf5..91c9caaa 100644
--- a/lib/plexapi/mixins.py
+++ b/lib/plexapi/mixins.py
@@ -5,7 +5,7 @@ from urllib.parse import parse_qsl, quote_plus, unquote, urlencode, urlsplit
 
 from plexapi import media, settings, utils
 from plexapi.exceptions import BadRequest, NotFound
-from plexapi.utils import deprecated
+from plexapi.utils import deprecated, openOrRead
 
 
 class AdvancedSettingsMixin:
@@ -341,14 +341,14 @@ class ArtMixin(ArtUrlMixin):
         
             Parameters:
                 url (str): The full URL to the image to upload.
-                filepath (str): The full file path the the image to upload.
+                filepath (str): The full file path the the image to upload or file-like object.
         """
         if url:
             key = f'/library/metadata/{self.ratingKey}/arts?url={quote_plus(url)}'
             self._server.query(key, method=self._server._session.post)
         elif filepath:
             key = f'/library/metadata/{self.ratingKey}/arts'
-            data = open(filepath, 'rb').read()
+            data = openOrRead(filepath)
             self._server.query(key, method=self._server._session.post, data=data)
         return self
 
@@ -392,14 +392,14 @@ class BannerMixin(BannerUrlMixin):
         
             Parameters:
                 url (str): The full URL to the image to upload.
-                filepath (str): The full file path the the image to upload.
+                filepath (str): The full file path the the image to upload or file-like object.
         """
         if url:
             key = f'/library/metadata/{self.ratingKey}/banners?url={quote_plus(url)}'
             self._server.query(key, method=self._server._session.post)
         elif filepath:
             key = f'/library/metadata/{self.ratingKey}/banners'
-            data = open(filepath, 'rb').read()
+            data = openOrRead(filepath)
             self._server.query(key, method=self._server._session.post, data=data)
         return self
 
@@ -448,14 +448,14 @@ class PosterMixin(PosterUrlMixin):
 
             Parameters:
                 url (str): The full URL to the image to upload.
-                filepath (str): The full file path the the image to upload.
+                filepath (str): The full file path the the image to upload or file-like object.
         """
         if url:
             key = f'/library/metadata/{self.ratingKey}/posters?url={quote_plus(url)}'
             self._server.query(key, method=self._server._session.post)
         elif filepath:
             key = f'/library/metadata/{self.ratingKey}/posters'
-            data = open(filepath, 'rb').read()
+            data = openOrRead(filepath)
             self._server.query(key, method=self._server._session.post, data=data)
         return self
 
@@ -494,22 +494,24 @@ class ThemeMixin(ThemeUrlMixin):
         """ Returns list of available :class:`~plexapi.media.Theme` objects. """
         return self.fetchItems(f'/library/metadata/{self.ratingKey}/themes', cls=media.Theme)
 
-    def uploadTheme(self, url=None, filepath=None):
+    def uploadTheme(self, url=None, filepath=None, timeout=None):
         """ Upload a theme from url or filepath.
 
             Warning: Themes cannot be deleted using PlexAPI!
 
             Parameters:
                 url (str): The full URL to the theme to upload.
-                filepath (str): The full file path to the theme to upload.
+                filepath (str): The full file path to the theme to upload or file-like object.
+                timeout (int, optional): Timeout, in seconds, to use when uploading themes to the server.
+                    (default config.TIMEOUT).
         """
         if url:
             key = f'/library/metadata/{self.ratingKey}/themes?url={quote_plus(url)}'
-            self._server.query(key, method=self._server._session.post)
+            self._server.query(key, method=self._server._session.post, timeout=timeout)
         elif filepath:
             key = f'/library/metadata/{self.ratingKey}/themes'
-            data = open(filepath, 'rb').read()
-            self._server.query(key, method=self._server._session.post, data=data)
+            data = openOrRead(filepath)
+            self._server.query(key, method=self._server._session.post, data=data, timeout=timeout)
         return self
 
     def setTheme(self, theme):
diff --git a/lib/plexapi/myplex.py b/lib/plexapi/myplex.py
index 7bfbe7ab..ca3f026a 100644
--- a/lib/plexapi/myplex.py
+++ b/lib/plexapi/myplex.py
@@ -32,6 +32,7 @@ class MyPlexAccount(PlexObject):
             session (requests.Session, optional): Use your own session object if you want to
                 cache the http responses from PMS
             timeout (int): timeout in seconds on initial connect to myplex (default config.TIMEOUT).
+            code (str): Two-factor authentication code to use when logging in.
 
         Attributes:
             SIGNIN (str): 'https://plex.tv/users/sign_in.xml'
@@ -88,19 +89,21 @@ class MyPlexAccount(PlexObject):
     # https://plex.tv/api/v2/user?X-Plex-Token={token}&X-Plex-Client-Identifier={clientId}
     key = 'https://plex.tv/users/account'
 
-    def __init__(self, username=None, password=None, token=None, session=None, timeout=None):
+    def __init__(self, username=None, password=None, token=None, session=None, timeout=None, code=None):
         self._token = token or CONFIG.get('auth.server_token')
         self._session = session or requests.Session()
         self._sonos_cache = []
         self._sonos_cache_timestamp = 0
-        data, initpath = self._signin(username, password, timeout)
+        data, initpath = self._signin(username, password, code, timeout)
         super(MyPlexAccount, self).__init__(self, data, initpath)
 
-    def _signin(self, username, password, timeout):
+    def _signin(self, username, password, code, timeout):
         if self._token:
             return self.query(self.key), self.key
         username = username or CONFIG.get('auth.myplex_username')
         password = password or CONFIG.get('auth.myplex_password')
+        if code:
+            password += code
         data = self.query(self.SIGNIN, method=self._session.post, auth=(username, password), timeout=timeout)
         return data, self.SIGNIN
 
@@ -390,12 +393,13 @@ class MyPlexAccount(PlexObject):
         url = self.HOMEUSER.format(userId=user.id)
         return self.query(url, self._session.delete)
 
-    def switchHomeUser(self, user):
+    def switchHomeUser(self, user, pin=None):
         """ Returns a new :class:`~plexapi.myplex.MyPlexAccount` object switched to the given home user.
 
             Parameters:
                 user (:class:`~plexapi.myplex.MyPlexUser` or str): :class:`~plexapi.myplex.MyPlexUser`,
                     username, or email of the home user to switch to.
+                pin (str): PIN for the home user (required if the home user has a PIN set).
 
             Example:
 
@@ -410,9 +414,12 @@ class MyPlexAccount(PlexObject):
         """
         user = user if isinstance(user, MyPlexUser) else self.user(user)
         url = f'{self.HOMEUSERS}/{user.id}/switch'
-        data = self.query(url, self._session.post)
+        params = {}
+        if pin:
+            params['pin'] = pin
+        data = self.query(url, self._session.post, params=params)
         userToken = data.attrib.get('authenticationToken')
-        return MyPlexAccount(token=userToken)
+        return MyPlexAccount(token=userToken, session=self._session)
 
     def setPin(self, newPin, currentPin=None):
         """ Set a new Plex Home PIN for the account.
@@ -861,7 +868,12 @@ class MyPlexAccount(PlexObject):
             results += subresults[:maxresults - len(results)]
             params['X-Plex-Container-Start'] += params['X-Plex-Container-Size']
 
-        return self._toOnlineMetadata(results)
+            # totalSize is available in first response, update maxresults from it
+            totalSize = utils.cast(int, data.attrib.get('totalSize'))
+            if maxresults > totalSize:
+                maxresults = totalSize
+
+        return self._toOnlineMetadata(results, **kwargs)
 
     def onWatchlist(self, item):
         """ Returns True if the item is on the user's watchlist.
@@ -941,7 +953,7 @@ class MyPlexAccount(PlexObject):
         }
         params = {
             'query': query,
-            'limit ': limit,
+            'limit': limit,
             'searchTypes': libtype,
             'includeMetadata': 1
         }
@@ -1005,21 +1017,24 @@ class MyPlexAccount(PlexObject):
         data = {'code': pin}
         self.query(self.LINK, self._session.put, headers=headers, data=data)
 
-    def _toOnlineMetadata(self, objs):
+    def _toOnlineMetadata(self, objs, **kwargs):
         """ Convert a list of media objects to online metadata objects. """
         # TODO: Add proper support for metadata.provider.plex.tv
         # Temporary workaround to allow reloading and browsing of online media objects
-        server = PlexServer(self.METADATA, self._token)
+        server = PlexServer(self.METADATA, self._token, session=self._session)
+
+        includeUserState = int(bool(kwargs.pop('includeUserState', True)))
 
         if not isinstance(objs, list):
             objs = [objs]
+
         for obj in objs:
             obj._server = server
 
             # Parse details key to modify query string
             url = urlsplit(obj._details_key)
             query = dict(parse_qsl(url.query))
-            query['includeUserState'] = 1
+            query['includeUserState'] = includeUserState
             query.pop('includeFields', None)
             obj._details_key = urlunsplit((url.scheme, url.netloc, url.path, urlencode(query), url.fragment))
 
diff --git a/lib/plexapi/playlist.py b/lib/plexapi/playlist.py
index b4174c84..f5ece634 100644
--- a/lib/plexapi/playlist.py
+++ b/lib/plexapi/playlist.py
@@ -5,9 +5,8 @@ from urllib.parse import quote_plus, unquote
 from plexapi import media, utils
 from plexapi.base import Playable, PlexPartialObject
 from plexapi.exceptions import BadRequest, NotFound, Unsupported
-from plexapi.library import LibrarySection
+from plexapi.library import LibrarySection, MusicSection
 from plexapi.mixins import SmartFilterMixin, ArtMixin, PosterMixin
-from plexapi.playqueue import PlayQueue
 from plexapi.utils import deprecated
 
 
@@ -330,10 +329,6 @@ class Playlist(
         """ Delete the playlist. """
         self._server.query(self.key, method=self._server._session.delete)
 
-    def playQueue(self, *args, **kwargs):
-        """ Returns a new :class:`~plexapi.playqueue.PlayQueue` from the playlist. """
-        return PlayQueue.create(self._server, self, *args, **kwargs)
-
     @classmethod
     def _create(cls, server, title, items):
         """ Create a regular playlist. """
@@ -375,15 +370,32 @@ class Playlist(
         data = server.query(key, method=server._session.post)[0]
         return cls(server, data, initpath=key)
 
+    @classmethod
+    def _createFromM3U(cls, server, title, section, m3ufilepath):
+        """ Create a playlist from uploading an m3u file. """
+        if not isinstance(section, LibrarySection):
+            section = server.library.section(section)
+
+        if not isinstance(section, MusicSection):
+            raise BadRequest('Can only create playlists from m3u files in a music library.')
+
+        args = {'sectionID': section.key, 'path': m3ufilepath}
+        key = f"/playlists/upload{utils.joinArgs(args)}"
+        server.query(key, method=server._session.post)
+        try:
+            return server.playlists(sectionId=section.key, guid__endswith=m3ufilepath)[0].edit(title=title).reload()
+        except IndexError:
+            raise BadRequest('Failed to create playlist from m3u file.') from None
+
     @classmethod
     def create(cls, server, title, section=None, items=None, smart=False, limit=None,
-               libtype=None, sort=None, filters=None, **kwargs):
+               libtype=None, sort=None, filters=None, m3ufilepath=None, **kwargs):
         """ Create a playlist.
 
             Parameters:
                 server (:class:`~plexapi.server.PlexServer`): Server to create the playlist on.
                 title (str): Title of the playlist.
-                section (:class:`~plexapi.library.LibrarySection`, str): Smart playlists only,
+                section (:class:`~plexapi.library.LibrarySection`, str): Smart playlists and m3u import only,
                     the library section to create the playlist in.
                 items (List): Regular playlists only, list of :class:`~plexapi.audio.Audio`,
                     :class:`~plexapi.video.Video`, or :class:`~plexapi.photo.Photo` objects to be added to the playlist.
@@ -396,17 +408,23 @@ class Playlist(
                     See :func:`~plexapi.library.LibrarySection.search` for more info.
                 filters (dict): Smart playlists only, a dictionary of advanced filters.
                     See :func:`~plexapi.library.LibrarySection.search` for more info.
+                m3ufilepath (str): Music playlists only, the full file path to an m3u file to import.
+                    Note: This will overwrite any playlist previously created from the same m3u file.
                 **kwargs (dict): Smart playlists only, additional custom filters to apply to the
                     search results. See :func:`~plexapi.library.LibrarySection.search` for more info.
 
             Raises:
                 :class:`plexapi.exceptions.BadRequest`: When no items are included to create the playlist.
                 :class:`plexapi.exceptions.BadRequest`: When mixing media types in the playlist.
+                :class:`plexapi.exceptions.BadRequest`: When attempting to import m3u file into non-music library.
+                :class:`plexapi.exceptions.BadRequest`: When failed to import m3u file.
 
             Returns:
                 :class:`~plexapi.playlist.Playlist`: A new instance of the created Playlist.
         """
-        if smart:
+        if m3ufilepath:
+            return cls._createFromM3U(server, title, section, m3ufilepath)
+        elif smart:
             return cls._createSmart(server, title, section, limit, libtype, sort, filters, **kwargs)
         else:
             return cls._create(server, title, items)
diff --git a/lib/plexapi/playqueue.py b/lib/plexapi/playqueue.py
index 6f4646dc..4c49f8d2 100644
--- a/lib/plexapi/playqueue.py
+++ b/lib/plexapi/playqueue.py
@@ -150,8 +150,8 @@ class PlayQueue(PlexObject):
 
         Parameters:
             server (:class:`~plexapi.server.PlexServer`): Server you are connected to.
-            items (:class:`~plexapi.base.Playable` or :class:`~plexapi.playlist.Playlist`):
-                A media item, list of media items, or Playlist.
+            items (:class:`~plexapi.base.PlexPartialObject`):
+                A media item or a list of media items.
             startItem (:class:`~plexapi.base.Playable`, optional):
                 Media item in the PlayQueue where playback should begin.
             shuffle (int, optional): Start the playqueue shuffled.
@@ -174,16 +174,13 @@ class PlayQueue(PlexObject):
             uri_args = quote_plus(f"/library/metadata/{item_keys}")
             args["uri"] = f"library:///directory/{uri_args}"
             args["type"] = items[0].listType
-        elif items.type == "playlist":
-            args["type"] = items.playlistType
-            if items.radio:
-                args["uri"] = f"server://{server.machineIdentifier}/{server.library.identifier}{items.key}"
-            else:
-                args["playlistID"] = items.ratingKey
         else:
-            uuid = items.section().uuid
-            args["type"] = items.listType
-            args["uri"] = f"library://{uuid}/item/{items.key}"
+            if items.type == "playlist":
+                args["type"] = items.playlistType
+                args["playlistID"] = items.ratingKey
+            else:
+                args["type"] = items.listType
+            args["uri"] = f"server://{server.machineIdentifier}/{server.library.identifier}{items.key}"
 
         if startItem:
             args["key"] = startItem.key
diff --git a/lib/plexapi/server.py b/lib/plexapi/server.py
index 168efd40..bec9fc08 100644
--- a/lib/plexapi/server.py
+++ b/lib/plexapi/server.py
@@ -17,7 +17,7 @@ from plexapi.media import Conversion, Optimized
 from plexapi.playlist import Playlist
 from plexapi.playqueue import PlayQueue
 from plexapi.settings import Settings
-from plexapi.utils import deprecated
+from plexapi.utils import cached_property, deprecated
 from requests.status_codes import _codes as codes
 
 # Need these imports to populate utils.PLEXOBJECTS
@@ -109,8 +109,6 @@ class PlexServer(PlexObject):
         self._showSecrets = CONFIG.get('log.show_secrets', '').lower() == 'true'
         self._session = session or requests.Session()
         self._timeout = timeout
-        self._library = None   # cached library
-        self._settings = None   # cached settings
         self._myPlexAccount = None   # cached myPlexAccount
         self._systemAccounts = None   # cached list of SystemAccount
         self._systemDevices = None   # cached list of SystemDevice
@@ -173,27 +171,22 @@ class PlexServer(PlexObject):
     def _uriRoot(self):
         return f'server://{self.machineIdentifier}/com.plexapp.plugins.library'
 
-    @property
+    @cached_property
     def library(self):
         """ Library to browse or search your media. """
-        if not self._library:
-            try:
-                data = self.query(Library.key)
-                self._library = Library(self, data)
-            except BadRequest:
-                data = self.query('/library/sections/')
-                # Only the owner has access to /library
-                # so just return the library without the data.
-                return Library(self, data)
-        return self._library
+        try:
+            data = self.query(Library.key)
+        except BadRequest:
+            # Only the owner has access to /library
+            # so just return the library without the data.
+            data = self.query('/library/sections/')
+        return Library(self, data)
 
-    @property
+    @cached_property
     def settings(self):
         """ Returns a list of all server settings. """
-        if not self._settings:
-            data = self.query(Settings.key)
-            self._settings = Settings(self, data)
-        return self._settings
+        data = self.query(Settings.key)
+        return Settings(self, data)
 
     def account(self):
         """ Returns the :class:`~plexapi.server.Account` object this server belongs to. """
@@ -318,7 +311,7 @@ class PlexServer(PlexObject):
         """
         if self._myPlexAccount is None:
             from plexapi.myplex import MyPlexAccount
-            self._myPlexAccount = MyPlexAccount(token=self._token)
+            self._myPlexAccount = MyPlexAccount(token=self._token, session=self._session)
         return self._myPlexAccount
 
     def _myPlexClientPorts(self):
@@ -454,19 +447,42 @@ class PlexServer(PlexObject):
 
             Returns:
                 :class:`~plexapi.collection.Collection`: A new instance of the created Collection.
+
+            Example:
+
+                .. code-block:: python
+
+                    # Create a regular collection
+                    movies = plex.library.section("Movies")
+                    movie1 = movies.get("Big Buck Bunny")
+                    movie2 = movies.get("Sita Sings the Blues")
+                    collection = plex.createCollection(
+                        title="Favorite Movies",
+                        section=movies,
+                        items=[movie1, movie2]
+                    )
+
+                    # Create a smart collection
+                    collection = plex.createCollection(
+                        title="Recently Aired Comedy TV Shows",
+                        section="TV Shows",
+                        smart=True,
+                        sort="episode.originallyAvailableAt:desc",
+                        filters={"episode.originallyAvailableAt>>": "4w", "genre": "comedy"}
+                    )
         """
         return Collection.create(
             self, title, section, items=items, smart=smart, limit=limit,
             libtype=libtype, sort=sort, filters=filters, **kwargs)
 
     def createPlaylist(self, title, section=None, items=None, smart=False, limit=None,
-                       libtype=None, sort=None, filters=None, **kwargs):
+                       libtype=None, sort=None, filters=None, m3ufilepath=None, **kwargs):
         """ Creates and returns a new :class:`~plexapi.playlist.Playlist`.
 
             Parameters:
                 title (str): Title of the playlist.
-                section (:class:`~plexapi.library.LibrarySection`, str): Smart playlists only,
-                    library section to create the playlist in.
+                section (:class:`~plexapi.library.LibrarySection`, str): Smart playlists and m3u import only,
+                    the library section to create the playlist in.
                 items (List): Regular playlists only, list of :class:`~plexapi.audio.Audio`,
                     :class:`~plexapi.video.Video`, or :class:`~plexapi.photo.Photo` objects to be added to the playlist.
                 smart (bool): True to create a smart playlist. Default False.
@@ -478,19 +494,51 @@ class PlexServer(PlexObject):
                     See :func:`~plexapi.library.LibrarySection.search` for more info.
                 filters (dict): Smart playlists only, a dictionary of advanced filters.
                     See :func:`~plexapi.library.LibrarySection.search` for more info.
+                m3ufilepath (str): Music playlists only, the full file path to an m3u file to import.
+                    Note: This will overwrite any playlist previously created from the same m3u file.
                 **kwargs (dict): Smart playlists only, additional custom filters to apply to the
                     search results. See :func:`~plexapi.library.LibrarySection.search` for more info.
 
             Raises:
                 :class:`plexapi.exceptions.BadRequest`: When no items are included to create the playlist.
                 :class:`plexapi.exceptions.BadRequest`: When mixing media types in the playlist.
+                :class:`plexapi.exceptions.BadRequest`: When attempting to import m3u file into non-music library.
+                :class:`plexapi.exceptions.BadRequest`: When failed to import m3u file.
 
             Returns:
                 :class:`~plexapi.playlist.Playlist`: A new instance of the created Playlist.
+
+            Example:
+
+                .. code-block:: python
+
+                    # Create a regular playlist
+                    episodes = plex.library.section("TV Shows").get("Game of Thrones").episodes()
+                    playlist = plex.createPlaylist(
+                        title="GoT Episodes",
+                        items=episodes
+                    )
+
+                    # Create a smart playlist
+                    playlist = plex.createPlaylist(
+                        title="Top 10 Unwatched Movies",
+                        section="Movies",
+                        smart=True,
+                        limit=10,
+                        sort="audienceRating:desc",
+                        filters={"audienceRating>>": 8.0, "unwatched": True}
+                    )
+
+                    # Create a music playlist from an m3u file
+                    playlist = plex.createPlaylist(
+                        title="Favorite Tracks",
+                        section="Music",
+                        m3ufilepath="/path/to/playlist.m3u"
+                    )
         """
         return Playlist.create(
             self, title, section=section, items=items, smart=smart, limit=limit,
-            libtype=libtype, sort=sort, filters=filters, **kwargs)
+            libtype=libtype, sort=sort, filters=filters, m3ufilepath=m3ufilepath, **kwargs)
 
     def createPlayQueue(self, item, **kwargs):
         """ Creates and returns a new :class:`~plexapi.playqueue.PlayQueue`.
diff --git a/lib/plexapi/settings.py b/lib/plexapi/settings.py
index b6b4d2e6..ef91391b 100644
--- a/lib/plexapi/settings.py
+++ b/lib/plexapi/settings.py
@@ -139,7 +139,14 @@ class Setting(PlexObject):
         if not enumstr:
             return None
         if ':' in enumstr:
-            return {self._cast(k): v for k, v in [kv.split(':') for kv in enumstr.split('|')]}
+            d = {}
+            for kv in enumstr.split('|'):
+                try:
+                    k, v = kv.split(':')
+                    d[self._cast(k)] = v
+                except ValueError:
+                    d[self._cast(kv)] = kv
+            return d
         return enumstr.split('|')
 
     def set(self, value):
diff --git a/lib/plexapi/utils.py b/lib/plexapi/utils.py
index 36827311..f429147e 100644
--- a/lib/plexapi/utils.py
+++ b/lib/plexapi/utils.py
@@ -24,6 +24,11 @@ try:
 except ImportError:
     tqdm = None
 
+try:
+    from functools import cached_property
+except ImportError:
+    from backports.cached_property import cached_property  # noqa: F401
+
 log = logging.getLogger('plexapi')
 
 # Search Types - Plex uses these to filter specific media types when searching.
@@ -618,3 +623,10 @@ def toJson(obj, **kwargs):
             return obj.isoformat()
         return {k: v for k, v in obj.__dict__.items() if not k.startswith('_')}
     return json.dumps(obj, default=serialize, **kwargs)
+
+
+def openOrRead(file):
+    if hasattr(file, 'read'):
+        return file.read()
+    with open(file, 'rb') as f:
+        return f.read()
diff --git a/lib/plexapi/video.py b/lib/plexapi/video.py
index 0d664c14..fe12ce67 100644
--- a/lib/plexapi/video.py
+++ b/lib/plexapi/video.py
@@ -323,6 +323,7 @@ class Movie(
             producers (List<:class:`~plexapi.media.Producer`>): List of producers objects.
             rating (float): Movie critic rating (7.9; 9.8; 8.1).
             ratingImage (str): Key to critic rating image (rottentomatoes://image.rating.rotten).
+            ratings (List<:class:`~plexapi.media.Rating`>): List of rating objects.
             roles (List<:class:`~plexapi.media.Role`>): List of role objects.
             similar (List<:class:`~plexapi.media.Similar`>): List of Similar objects.
             studio (str): Studio that created movie (Di Bonaventura Pictures; 21 Laps Entertainment).
@@ -363,6 +364,7 @@ class Movie(
         self.producers = self.findItems(data, media.Producer)
         self.rating = utils.cast(float, data.attrib.get('rating'))
         self.ratingImage = data.attrib.get('ratingImage')
+        self.ratings = self.findItems(data, media.Rating)
         self.roles = self.findItems(data, media.Role)
         self.similar = self.findItems(data, media.Similar)
         self.studio = data.attrib.get('studio')
@@ -459,6 +461,7 @@ class Show(
             originallyAvailableAt (datetime): Datetime the show was released.
             originalTitle (str): The original title of the show.
             rating (float): Show rating (7.9; 9.8; 8.1).
+            ratings (List<:class:`~plexapi.media.Rating`>): List of rating objects.
             roles (List<:class:`~plexapi.media.Role`>): List of role objects.
             showOrdering (str): Setting that indicates the episode ordering for the show
                 (None = Library default).
@@ -503,6 +506,7 @@ class Show(
         self.originallyAvailableAt = utils.toDatetime(data.attrib.get('originallyAvailableAt'), '%Y-%m-%d')
         self.originalTitle = data.attrib.get('originalTitle')
         self.rating = utils.cast(float, data.attrib.get('rating'))
+        self.ratings = self.findItems(data, media.Rating)
         self.roles = self.findItems(data, media.Role)
         self.showOrdering = data.attrib.get('showOrdering')
         self.similar = self.findItems(data, media.Similar)
@@ -639,6 +643,7 @@ class Season(
             parentTheme (str): URL to show theme resource (/library/metadata/<parentRatingkey>/theme/<themeid>).
             parentThumb (str): URL to show thumbnail image (/library/metadata/<parentRatingKey>/thumb/<thumbid>).
             parentTitle (str): Name of the show for the season.
+            ratings (List<:class:`~plexapi.media.Rating`>): List of rating objects.
             viewedLeafCount (int): Number of items marked as played in the season view.
             year (int): Year the season was released.
     """
@@ -663,6 +668,7 @@ class Season(
         self.parentTheme = data.attrib.get('parentTheme')
         self.parentThumb = data.attrib.get('parentThumb')
         self.parentTitle = data.attrib.get('parentTitle')
+        self.ratings = self.findItems(data, media.Rating)
         self.viewedLeafCount = utils.cast(int, data.attrib.get('viewedLeafCount'))
         self.year = utils.cast(int, data.attrib.get('year'))
 
@@ -800,6 +806,7 @@ class Episode(
             parentYear (int): Year the season was released.
             producers (List<:class:`~plexapi.media.Producer`>): List of producers objects.
             rating (float): Episode rating (7.9; 9.8; 8.1).
+            ratings (List<:class:`~plexapi.media.Rating`>): List of rating objects.
             roles (List<:class:`~plexapi.media.Role`>): List of role objects.
             skipParent (bool): True if the show's seasons are set to hidden.
             viewOffset (int): View offset in milliseconds.
@@ -845,6 +852,7 @@ class Episode(
         self.parentYear = utils.cast(int, data.attrib.get('parentYear'))
         self.producers = self.findItems(data, media.Producer)
         self.rating = utils.cast(float, data.attrib.get('rating'))
+        self.ratings = self.findItems(data, media.Rating)
         self.roles = self.findItems(data, media.Role)
         self.skipParent = utils.cast(bool, data.attrib.get('skipParent', '0'))
         self.viewOffset = utils.cast(int, data.attrib.get('viewOffset', 0))
diff --git a/requirements.txt b/requirements.txt
index 70ca360f..b69f5fc2 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -27,7 +27,7 @@ MarkupSafe==2.1.1
 musicbrainzngs==0.7.1
 packaging==22.0
 paho-mqtt==1.6.1
-plexapi==4.13.1
+plexapi==4.13.2
 portend==3.1.0
 profilehooks==1.12.0
 PyJWT==2.6.0

From 4064ac083e0f8c61cbddba883feb3d688b158232 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 22 Dec 2022 10:45:05 -0800
Subject: [PATCH 283/743] Bump actions/setup-python from 4.3.1 to 4.4.0 (#1938)

Bumps [actions/setup-python](https://github.com/actions/setup-python) from 4.3.1 to 4.4.0.
- [Release notes](https://github.com/actions/setup-python/releases)
- [Commits](https://github.com/actions/setup-python/compare/v4.3.1...v4.4.0)

---
updated-dependencies:
- dependency-name: actions/setup-python
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

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

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 .github/workflows/publish-installers.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/publish-installers.yml b/.github/workflows/publish-installers.yml
index 7002834b..77530960 100644
--- a/.github/workflows/publish-installers.yml
+++ b/.github/workflows/publish-installers.yml
@@ -52,7 +52,7 @@ jobs:
           echo $GITHUB_SHA > version.txt
 
       - name: Set Up Python
-        uses: actions/setup-python@v4.3.1
+        uses: actions/setup-python@v4.4.0
         with:
           python-version: '3.9'
           cache: pip

From f6dd38ad126917193d5ac3bf014815623e349dc9 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 22 Dec 2022 11:15:59 -0800
Subject: [PATCH 284/743] v2.11.0

---
 CHANGELOG.md      | 24 ++++++++++++++++++++++++
 plexpy/version.py |  2 +-
 2 files changed, 25 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 44da2582..89f15eb6 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,29 @@
 # Changelog
 
+## v2.11.0 (2022-12-22)
+
+* Activity:
+  * New: Added audio and subtitle language to activity cards. (#1831, #1900) (Thanks @fscorrupt)
+* History:
+  * New: Log subtitle language and subtitle forced to database. (#1826)
+* Notifications:
+  * Fix: Validating condition operators would fail with a blank parameter.
+  * New: Added start time and stop time notification parameters. (#1931)
+  * New: Added session_key to LunaSea notification payload. (#1929) (Thanks @JagandeepBrar)
+* Newsletters:
+  * Fix: Allow CSS to support light and dark themes.
+* Exporter:
+  * New: Added editionTitle to movie exporter fields.
+  * Change: m3u8 export changed to .m3u file extension. File is still encoded using UTF-8.
+* UI:
+  * Fix: Link watch statistics to media page using metadata from history. (#1882)
+  * New: Show subtitle language and subtitle forced flag in stream data modal.
+* Other:
+  * Fix: Mask more user and metadata fields for guest access. (#1913)
+  * Change: Disable TLS 1.0 and 1.1 for the webserver. Minimum TLS version is 1.2. (#1870)
+  * Change: Use system language for requests to Plex Media Server.
+
+
 ## v2.10.5 (2022-11-07)
 
 * Notifications:
diff --git a/plexpy/version.py b/plexpy/version.py
index 6c3d1104..57d3f6ae 100644
--- a/plexpy/version.py
+++ b/plexpy/version.py
@@ -18,4 +18,4 @@
 from __future__ import unicode_literals
 
 PLEXPY_BRANCH = "master"
-PLEXPY_RELEASE_VERSION = "v2.10.5"
+PLEXPY_RELEASE_VERSION = "v2.11.0"
\ No newline at end of file

From 808ca348e86f4541100b0fc6c2e9c39c31df3466 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 22 Dec 2022 11:24:41 -0800
Subject: [PATCH 285/743] Use source language instead of stream language on
 activity cards

---
 .../default/current_activity_instance.html         | 14 +++++++-------
 data/interfaces/default/index.html                 | 14 +++++++-------
 2 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/data/interfaces/default/current_activity_instance.html b/data/interfaces/default/current_activity_instance.html
index d0e95ac8..b48a70f3 100644
--- a/data/interfaces/default/current_activity_instance.html
+++ b/data/interfaces/default/current_activity_instance.html
@@ -266,11 +266,11 @@ DOCUMENTATION :: END
                                 <div class="sub-value" id="audio_decision-${sk}">
                                     % if data['stream_audio_decision']:
                                         % if data['stream_audio_decision'] == 'transcode':
-                                        Transcode (${data['stream_audio_language'] or 'Unknown'} - ${AUDIO_CODEC_OVERRIDES.get(data['audio_codec'], data['audio_codec'].upper())} ${data['audio_channel_layout'].split('(')[0].capitalize()} <i class="fa fa-long-arrow-right"></i> ${AUDIO_CODEC_OVERRIDES.get(data['stream_audio_codec'], data['stream_audio_codec'].upper())} ${data['stream_audio_channel_layout'].split('(')[0].capitalize()})
+                                        Transcode (${data['audio_language'] or 'Unknown'} - ${AUDIO_CODEC_OVERRIDES.get(data['audio_codec'], data['audio_codec'].upper())} ${data['audio_channel_layout'].split('(')[0].capitalize()} <i class="fa fa-long-arrow-right"></i> ${AUDIO_CODEC_OVERRIDES.get(data['stream_audio_codec'], data['stream_audio_codec'].upper())} ${data['stream_audio_channel_layout'].split('(')[0].capitalize()})
                                         % elif data['stream_audio_decision'] == 'copy':
-                                        Direct Stream (${data['stream_audio_language'] or 'Unknown'} - ${AUDIO_CODEC_OVERRIDES.get(data['stream_audio_codec'], data['stream_audio_codec'].upper())} ${data['stream_audio_channel_layout'].split('(')[0].capitalize()})
+                                        Direct Stream (${data['audio_language'] or 'Unknown'} - ${AUDIO_CODEC_OVERRIDES.get(data['stream_audio_codec'], data['stream_audio_codec'].upper())} ${data['stream_audio_channel_layout'].split('(')[0].capitalize()})
                                         % else:
-                                        Direct Play (${data['stream_audio_language'] or 'Unknown'} - ${AUDIO_CODEC_OVERRIDES.get(data['stream_audio_codec'], data['stream_audio_codec'].upper())} ${data['stream_audio_channel_layout'].split('(')[0].capitalize()})
+                                        Direct Play (${data['audio_language'] or 'Unknown'} - ${AUDIO_CODEC_OVERRIDES.get(data['stream_audio_codec'], data['stream_audio_codec'].upper())} ${data['stream_audio_channel_layout'].split('(')[0].capitalize()})
                                         % endif
                                     % endif
                                 </div>
@@ -285,13 +285,13 @@ DOCUMENTATION :: END
                                             subtitle_codec = 'None' if data['stream_subtitle_codec'] and data['stream_subtitle_transient'] else data['subtitle_codec'].upper()
                                         %>
                                         % if data['stream_subtitle_decision'] == 'transcode':
-                                        Transcode (${data['stream_subtitle_language'] or 'Unknown'} - ${subtitle_codec} <i class="fa fa-long-arrow-right"></i> ${data['stream_subtitle_codec'].upper()})
+                                        Transcode (${data['subtitle_language'] or 'Unknown'} - ${subtitle_codec} <i class="fa fa-long-arrow-right"></i> ${data['stream_subtitle_codec'].upper()})
                                         % elif data['stream_subtitle_decision'] == 'copy':
-                                        Direct Stream (${data['stream_subtitle_language'] or 'Unknown'} - ${subtitle_codec})
+                                        Direct Stream (${data['subtitle_language'] or 'Unknown'} - ${subtitle_codec})
                                         % elif data['stream_subtitle_decision'] == 'burn':
-                                        Burn (${data['stream_subtitle_language'] or 'Unknown'} - ${subtitle_codec})
+                                        Burn (${data['subtitle_language'] or 'Unknown'} - ${subtitle_codec})
                                         % else:
-                                        Direct Play (${data['stream_subtitle_language'] or 'Unknown'} - ${subtitle_codec if data['synced_version'] else data['stream_subtitle_codec'].upper()})
+                                        Direct Play (${data['subtitle_language'] or 'Unknown'} - ${subtitle_codec if data['synced_version'] else data['stream_subtitle_codec'].upper()})
                                         % endif
                                     % else:
                                     None
diff --git a/data/interfaces/default/index.html b/data/interfaces/default/index.html
index e4cc7d51..e094d0e4 100644
--- a/data/interfaces/default/index.html
+++ b/data/interfaces/default/index.html
@@ -526,11 +526,11 @@
                             var a_codec = (s.audio_codec === 'truehd') ? 'TrueHD' : s.audio_codec.toUpperCase();
                             var sa_codec = (s.stream_audio_codec === 'truehd') ? 'TrueHD' : s.stream_audio_codec.toUpperCase();
                             if (s.stream_audio_decision === 'transcode') {
-                                audio_decision = 'Transcode ('+ (s.stream_audio_language || 'Unknown')+ ' - ' + a_codec + ' ' + capitalizeFirstLetter(s.audio_channel_layout.split('(')[0]) + ' <i class="fa fa-long-arrow-right"></i> ' + sa_codec + ' ' + capitalizeFirstLetter(s.stream_audio_channel_layout.split('(')[0]) + ')';
+                                audio_decision = 'Transcode ('+ (s.audio_language || 'Unknown')+ ' - ' + a_codec + ' ' + capitalizeFirstLetter(s.audio_channel_layout.split('(')[0]) + ' <i class="fa fa-long-arrow-right"></i> ' + sa_codec + ' ' + capitalizeFirstLetter(s.stream_audio_channel_layout.split('(')[0]) + ')';
                             } else if (s.stream_audio_decision === 'copy') {
-                                audio_decision = 'Direct Stream ('+ (s.stream_audio_language || 'Unknown')+ ' - ' + sa_codec + ' ' + capitalizeFirstLetter(s.stream_audio_channel_layout.split('(')[0]) + ')';
+                                audio_decision = 'Direct Stream ('+ (s.audio_language || 'Unknown')+ ' - ' + sa_codec + ' ' + capitalizeFirstLetter(s.stream_audio_channel_layout.split('(')[0]) + ')';
                             } else {
-                                audio_decision = 'Direct Play ('+ (s.stream_audio_language || 'Unknown')+ ' - ' + sa_codec + ' ' + capitalizeFirstLetter(s.stream_audio_channel_layout.split('(')[0]) + ')';
+                                audio_decision = 'Direct Play ('+ (s.audio_language || 'Unknown')+ ' - ' + sa_codec + ' ' + capitalizeFirstLetter(s.stream_audio_channel_layout.split('(')[0]) + ')';
                             }
                         }
                         $('#audio_decision-' + key).html(audio_decision);
@@ -539,13 +539,13 @@
                         if (['movie', 'episode', 'clip'].indexOf(s.media_type) > -1 && s.subtitles === 1) {
                             var subtitle_codec = (s.stream_subtitle_codec && s.stream_subtitle_transient) ? 'None' : s.subtitle_codec.toUpperCase();
                             if (s.stream_subtitle_decision === 'transcode') {
-                                subtitle_decision = 'Transcode ('+ (s.stream_subtitle_language || 'Unknown')+ ' - ' + subtitle_codec + ' <i class="fa fa-long-arrow-right"></i> ' + s.stream_subtitle_codec.toUpperCase() + ')';
+                                subtitle_decision = 'Transcode ('+ (s.subtitle_language || 'Unknown')+ ' - ' + subtitle_codec + ' <i class="fa fa-long-arrow-right"></i> ' + s.stream_subtitle_codec.toUpperCase() + ')';
                             } else if (s.stream_subtitle_decision === 'copy') {
-                                subtitle_decision = 'Direct Stream ('+ (s.stream_subtitle_language || 'Unknown')+ ' - ' + subtitle_codec + ')';
+                                subtitle_decision = 'Direct Stream ('+ (s.subtitle_language || 'Unknown')+ ' - ' + subtitle_codec + ')';
                             } else if (s.stream_subtitle_decision === 'burn') {
-                                subtitle_decision = 'Burn ('+ (s.stream_subtitle_language || 'Unknown')+ ' - ' + subtitle_codec + ')';
+                                subtitle_decision = 'Burn ('+ (s.subtitle_language || 'Unknown')+ ' - ' + subtitle_codec + ')';
                             } else {
-                                subtitle_decision = 'Direct Play ('+ (s.stream_subtitle_language || 'Unknown')+ ' - ' + ((s.synced_version === '1') ? subtitle_codec : s.stream_subtitle_codec.toUpperCase()) + ')';
+                                subtitle_decision = 'Direct Play ('+ (s.subtitle_language || 'Unknown')+ ' - ' + ((s.synced_version === '1') ? subtitle_codec : s.stream_subtitle_codec.toUpperCase()) + ')';
                             }
                         }
                         $('#subtitle_decision-' + key).html(subtitle_decision);

From e8af221e99a4a37038affe4459603bcdf8879931 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 22 Dec 2022 11:44:30 -0800
Subject: [PATCH 286/743] Rename submit winget job name

---
 .github/workflows/submit-winget.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/submit-winget.yml b/.github/workflows/submit-winget.yml
index 33b6d9da..43c1ce24 100644
--- a/.github/workflows/submit-winget.yml
+++ b/.github/workflows/submit-winget.yml
@@ -7,7 +7,7 @@ on:
 
 jobs:
   winget:
-    name: Publish Winget Package
+    name: Submit Winget Package
     runs-on: windows-latest
     steps:
       - name: Submit package to Windows Package Manager Community Repository

From 680c8f1ee3e31019065fd407bee0c2ed10f3e320 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 22 Dec 2022 11:44:48 -0800
Subject: [PATCH 287/743] Update publish installer workflow token

---
 .github/workflows/publish-installers.yml | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/publish-installers.yml b/.github/workflows/publish-installers.yml
index 77530960..3b0911ee 100644
--- a/.github/workflows/publish-installers.yml
+++ b/.github/workflows/publish-installers.yml
@@ -125,7 +125,7 @@ jobs:
         uses: actions/create-release@v1
         id: create_release
         env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GITHUB_TOKEN: ${{ secrets.GHACTIONS_TOKEN }}
         with:
           tag_name: ${{ steps.get_version.outputs.RELEASE_VERSION }}
           release_name: Tautulli ${{ steps.get_version.outputs.RELEASE_VERSION }}
@@ -140,7 +140,7 @@ jobs:
         uses: actions/upload-release-asset@v1
         if: env.WORKFLOW_CONCLUSION == 'success'
         env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GITHUB_TOKEN: ${{ secrets.GHACTIONS_TOKEN }}
         with:
           upload_url: ${{ steps.create_release.outputs.upload_url }}
           asset_path: Tautulli-windows-installer/Tautulli-windows-${{ steps.get_version.outputs.RELEASE_VERSION }}-x64.exe
@@ -151,7 +151,7 @@ jobs:
         uses: actions/upload-release-asset@v1
         if: env.WORKFLOW_CONCLUSION == 'success'
         env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GITHUB_TOKEN: ${{ secrets.GHACTIONS_TOKEN }}
         with:
           upload_url: ${{ steps.create_release.outputs.upload_url }}
           asset_path: Tautulli-macos-installer/Tautulli-macos-${{ steps.get_version.outputs.RELEASE_VERSION }}-x64.pkg

From 6181aa178ddf144cbbd4159626933106b70a74be Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 22 Dec 2022 12:01:52 -0800
Subject: [PATCH 288/743] Fix publish installer changelog sed command

---
 .github/workflows/publish-installers.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/publish-installers.yml b/.github/workflows/publish-installers.yml
index 3b0911ee..3b271a1b 100644
--- a/.github/workflows/publish-installers.yml
+++ b/.github/workflows/publish-installers.yml
@@ -118,7 +118,7 @@ jobs:
         id: get_changelog
         run: |
           CHANGELOG="$( sed -n '/^## /{p; :loop n; p; /^## /q; b loop}' CHANGELOG.md \
-            | sed '$d' | sed '$d' | sed '$d' | sed ':a;N;$!ba;s/\n/%0A/g' )"
+            | sed '$d' | sed '$d' | sed '$d' )"
           echo "CHANGELOG=${CHANGELOG}" >> $GITHUB_OUTPUT
 
       - name: Create Release

From b0ba73cf46d1ec80d5dd707b6265e0bb19680176 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 22 Dec 2022 13:52:11 -0800
Subject: [PATCH 289/743] Fix no started parameter for recently added
 notifications

* Fixes #1940
---
 plexpy/notification_handler.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/plexpy/notification_handler.py b/plexpy/notification_handler.py
index 7c16de00..57f5ff83 100644
--- a/plexpy/notification_handler.py
+++ b/plexpy/notification_handler.py
@@ -985,8 +985,8 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
         'product': notify_params['product'],
         'player': notify_params['player'],
         'ip_address': notify_params.get('ip_address', 'N/A'),
-        'started_datestamp': arrow.get(notify_params['started']).format(date_format),
-        'started_timestamp': arrow.get(notify_params['started']).format(time_format),
+        'started_datestamp': arrow.get(notify_params['started']).format(date_format) if notify_params['started'] else '',
+        'started_timestamp': arrow.get(notify_params['started']).format(time_format) if notify_params['started'] else '',
         'started_unixtime': notify_params['started'],
         'stopped_datestamp': arrow.get(notify_params['stopped']).format(date_format) if notify_params['stopped'] else '',
         'stopped_timestamp': arrow.get(notify_params['stopped']).format(time_format) if notify_params['stopped'] else '',

From 1e58847bcd945a49fe01e9ebc95e57ea6a4642bb Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 22 Dec 2022 16:24:51 -0800
Subject: [PATCH 290/743] Update snap to core22

* Fixes #1941
---
 snap/snapcraft.yaml | 22 ++++++++++++++--------
 1 file changed, 14 insertions(+), 8 deletions(-)

diff --git a/snap/snapcraft.yaml b/snap/snapcraft.yaml
index 82171392..184f09d5 100644
--- a/snap/snapcraft.yaml
+++ b/snap/snapcraft.yaml
@@ -7,7 +7,7 @@ description: >
   The only thing missing is "why they watched it", but who am I to question your 42 plays of Frozen. 
   All statistics are presented in a nice and clean interface with many tables and graphs, which makes it easy to brag about your server to everyone else.
 
-base: core18
+base: core22
 confinement: strict
 
 architectures:
@@ -20,12 +20,18 @@ parts:
     plugin: dump
     source: .
     stage-packages:
-      - python3.8
+      - python3
       - python3-openssl
       - python3-pycryptodome
       - python3-setuptools
+      - python3-pkg-resources
     build-packages:
       - git
+      - python3
+      - python3-openssl
+      - python3-pycryptodome
+      - python3-setuptools
+      - python3-pkg-resources
     override-pull: |
       snapcraftctl pull
       git config --global --add safe.directory /data/parts/tautulli/src
@@ -52,15 +58,14 @@ parts:
       echo $COMMIT > version.txt
       snapcraftctl set-version "$VERSION"
       snapcraftctl set-grade "$GRADE"
+    override-prime: |
+      snapcraftctl prime
+      mkdir -p usr/bin
+      ln -s /usr/bin/python3 usr/bin/python3
 
 apps:
   tautulli:
-    command: >
-      usr/bin/python3 $SNAP/Tautulli.py
-        --datadir $SNAP_USER_COMMON/Tautulli
-        --config $SNAP_USER_COMMON/Tautulli/config.ini
-        --quiet
-        --nolaunch
+    command: usr/bin/python3 $SNAP/Tautulli.py --datadir $SNAP_USER_COMMON/Tautulli --config $SNAP_USER_COMMON/Tautulli/config.ini --quiet --nolaunch
     daemon: simple
     restart-condition: on-abnormal
     restart-delay: 5s
@@ -70,4 +75,5 @@ apps:
       - network-bind
       - removable-media
     environment:
+      PYTHONPATH: $SNAP/usr/lib/python3/dist-packages:$PYTHONPATH
       TAUTULLI_SNAP: "True"

From 2a0e07aca518dcb97cbcbb5ee96076befeadf923 Mon Sep 17 00:00:00 2001
From: James Tufarelli <james.tufarelli@gmail.com>
Date: Thu, 22 Dec 2022 17:28:09 -0800
Subject: [PATCH 291/743] Fix update check failing when `git` is not found
 (#1943)

* Update versioncheck to cast commit_hash to string

After the most recent v2.11.0 update, Tautulli would not start until I made this change to the codebase.

* Update plexpy/versioncheck.py

Co-authored-by: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>

Co-authored-by: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
---
 plexpy/versioncheck.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/plexpy/versioncheck.py b/plexpy/versioncheck.py
index 33f2b917..2f07d7ae 100644
--- a/plexpy/versioncheck.py
+++ b/plexpy/versioncheck.py
@@ -101,9 +101,9 @@ def get_version():
         else:
             cur_commit_hash = str(output)
 
-        if not re.match('^[a-z0-9]+$', cur_commit_hash):
-            logger.error('Output does not look like a hash, not using it.')
-            cur_commit_hash = None
+            if not re.match('^[a-z0-9]+$', cur_commit_hash):
+                logger.error('Output does not look like a hash, not using it.')
+                cur_commit_hash = None
 
         if plexpy.CONFIG.DO_NOT_OVERRIDE_GIT_BRANCH and plexpy.CONFIG.GIT_BRANCH:
             remote_name = None

From 7386ca1c429cd4444587a9f7d5fc6e4f1c0a4f2d Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 22 Dec 2022 17:05:23 -0800
Subject: [PATCH 292/743] Add backports.cached-property==1.0.2

---
 lib/backports/cached_property/__init__.py  | 94 ++++++++++++++++++++++
 lib/backports/cached_property/__init__.pyi | 24 ++++++
 lib/backports/cached_property/_version.py  |  5 ++
 lib/backports/cached_property/py.typed     |  1 +
 4 files changed, 124 insertions(+)
 create mode 100644 lib/backports/cached_property/__init__.py
 create mode 100644 lib/backports/cached_property/__init__.pyi
 create mode 100644 lib/backports/cached_property/_version.py
 create mode 100644 lib/backports/cached_property/py.typed

diff --git a/lib/backports/cached_property/__init__.py b/lib/backports/cached_property/__init__.py
new file mode 100644
index 00000000..80f1f0b7
--- /dev/null
+++ b/lib/backports/cached_property/__init__.py
@@ -0,0 +1,94 @@
+"""Backport of python 3.8 functools.cached_property.
+
+cached_property() - computed once per instance, cached as attribute
+"""
+
+__all__ = ("cached_property",)
+
+# Standard Library
+from sys import version_info
+try:
+    # Local Implementation
+    from ._version import version as __version__
+except ImportError:
+    pass
+
+if version_info >= (3, 8):
+    # Standard Library
+    from functools import cached_property  # pylint: disable=no-name-in-module
+else:
+    # Standard Library
+    from threading import RLock
+    from typing import Any
+    from typing import Callable
+    from typing import Optional
+    from typing import Type
+    from typing import TypeVar
+
+    _NOT_FOUND = object()
+    _T = TypeVar("_T")
+    _S = TypeVar("_S")
+
+    # noinspection PyPep8Naming
+    class cached_property:  # NOSONAR  # pylint: disable=invalid-name  # noqa: N801
+        """Cached property implementation.
+
+        Transform a method of a class into a property whose value is computed once
+        and then cached as a normal attribute for the life of the instance.
+        Similar to property(), with the addition of caching.
+        Useful for expensive computed properties of instances
+        that are otherwise effectively immutable.
+        """
+
+        def __init__(self, func: Callable[[Any], _T]) -> None:
+            """Cached property implementation."""
+            self.func = func
+            self.attrname: Optional[str] = None
+            self.__doc__ = func.__doc__
+            self.lock = RLock()
+
+        def __set_name__(self, owner: Type[Any], name: str) -> None:
+            """Assign attribute name and owner."""
+            if self.attrname is None:
+                self.attrname = name
+            elif name != self.attrname:
+                raise TypeError(
+                    "Cannot assign the same cached_property to two different names "
+                    f"({self.attrname!r} and {name!r})."
+                )
+
+        def __get__(self, instance: Optional[_S], owner: Optional[Type[Any]] = None) -> Any:
+            """Property-like getter implementation.
+
+            :return: property instance if requested on class or value/cached value if requested on instance.
+            :rtype: Union[cached_property[_T], _T]
+            :raises TypeError: call without calling __set_name__ or no '__dict__' attribute
+            """
+            if instance is None:
+                return self
+            if self.attrname is None:
+                raise TypeError("Cannot use cached_property instance without calling __set_name__ on it.")
+            try:
+                cache = instance.__dict__
+            except AttributeError:  # not all objects have __dict__ (e.g. class defines slots)
+                msg = (
+                    f"No '__dict__' attribute on {type(instance).__name__!r} "
+                    f"instance to cache {self.attrname!r} property."
+                )
+                raise TypeError(msg) from None
+            val = cache.get(self.attrname, _NOT_FOUND)
+            if val is _NOT_FOUND:
+                with self.lock:
+                    # check if another thread filled cache while we awaited lock
+                    val = cache.get(self.attrname, _NOT_FOUND)
+                    if val is _NOT_FOUND:
+                        val = self.func(instance)
+                        try:
+                            cache[self.attrname] = val
+                        except TypeError:
+                            msg = (
+                                f"The '__dict__' attribute on {type(instance).__name__!r} instance "
+                                f"does not support item assignment for caching {self.attrname!r} property."
+                            )
+                            raise TypeError(msg) from None
+            return val
diff --git a/lib/backports/cached_property/__init__.pyi b/lib/backports/cached_property/__init__.pyi
new file mode 100644
index 00000000..13e619ba
--- /dev/null
+++ b/lib/backports/cached_property/__init__.pyi
@@ -0,0 +1,24 @@
+# Standard Library
+from threading import RLock
+from typing import Any
+from typing import Callable
+from typing import Generic
+from typing import Optional
+from typing import Type
+from typing import TypeVar
+from typing import overload
+
+_T = TypeVar("_T")
+_S = TypeVar("_S")
+
+# noinspection PyPep8Naming
+class cached_property(Generic[_T]):
+    func: Callable[[Any], _T]
+    attrname: Optional[str]
+    lock: RLock
+    def __init__(self, func: Callable[[Any], _T]) -> None: ...
+    @overload
+    def __get__(self, instance: None, owner: Optional[Type[Any]] = ...) -> cached_property[_T]: ...
+    @overload
+    def __get__(self, instance: _S, owner: Optional[Type[Any]] = ...) -> _T: ...
+    def __set_name__(self, owner: Type[Any], name: str) -> None: ...
diff --git a/lib/backports/cached_property/_version.py b/lib/backports/cached_property/_version.py
new file mode 100644
index 00000000..87c708f5
--- /dev/null
+++ b/lib/backports/cached_property/_version.py
@@ -0,0 +1,5 @@
+# coding: utf-8
+# file generated by setuptools_scm
+# don't change, don't track in version control
+version = '1.0.2'
+version_tuple = (1, 0, 2)
diff --git a/lib/backports/cached_property/py.typed b/lib/backports/cached_property/py.typed
new file mode 100644
index 00000000..8b137891
--- /dev/null
+++ b/lib/backports/cached_property/py.typed
@@ -0,0 +1 @@
+

From d9343730da97192e1099d5443440eb2125fb81b0 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 22 Dec 2022 17:50:24 -0800
Subject: [PATCH 293/743] Downgrade snap to core20

---
 snap/snapcraft.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/snap/snapcraft.yaml b/snap/snapcraft.yaml
index 184f09d5..1220971e 100644
--- a/snap/snapcraft.yaml
+++ b/snap/snapcraft.yaml
@@ -7,7 +7,7 @@ description: >
   The only thing missing is "why they watched it", but who am I to question your 42 plays of Frozen. 
   All statistics are presented in a nice and clean interface with many tables and graphs, which makes it easy to brag about your server to everyone else.
 
-base: core22
+base: core20
 confinement: strict
 
 architectures:

From 3c996f01a9fe15466978781022fdbb00d1e189a9 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 22 Dec 2022 17:58:38 -0800
Subject: [PATCH 294/743] v2.11.1

---
 CHANGELOG.md      | 12 ++++++++++++
 plexpy/version.py |  2 +-
 2 files changed, 13 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 89f15eb6..79b3546a 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,17 @@
 # Changelog
 
+## v2.11.1 (2022-12-22)
+
+* Activity:
+  * Fix: Use source language instead of stream language on activity cards.
+* Notifications:
+  * Fix: Blank start time notification parameters causing recently added notifications to fail. (#1940)
+* Other:
+  * Fix: Tautulli failing to start when using python 3.7.
+  * Fix: Snap install failing to start. (#1941)
+  * Fix: Update check crashing when git is missing. (#1943) (Thanks @Minituff)
+
+
 ## v2.11.0 (2022-12-22)
 
 * Activity:
diff --git a/plexpy/version.py b/plexpy/version.py
index 57d3f6ae..ec5d5f61 100644
--- a/plexpy/version.py
+++ b/plexpy/version.py
@@ -18,4 +18,4 @@
 from __future__ import unicode_literals
 
 PLEXPY_BRANCH = "master"
-PLEXPY_RELEASE_VERSION = "v2.11.0"
\ No newline at end of file
+PLEXPY_RELEASE_VERSION = "v2.11.1"
\ No newline at end of file

From 2f6869ed2ad55f50b364e2fb9d63ca5b791ed6cd Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 23 Dec 2022 11:10:39 -0800
Subject: [PATCH 295/743] Update CI badges in README

* Ref: badges/shields#8671

[skip ci]
---
 README.md | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/README.md b/README.md
index fa35aab8..d38f69e1 100644
--- a/README.md
+++ b/README.md
@@ -57,24 +57,24 @@ Read the [Installation Guides][Installation] for instructions on how to install
 [badge-release-nightly-last-commit]: https://img.shields.io/github/last-commit/Tautulli/Tautulli/nightly?style=flat-square&color=blue
 [badge-release-nightly-commits]: https://img.shields.io/github/commits-since/Tautulli/Tautulli/latest/nightly?style=flat-square&color=blue
 [badge-docker-master]: https://img.shields.io/badge/docker-latest-blue?style=flat-square
-[badge-docker-master-ci]: https://img.shields.io/github/workflow/status/Tautulli/Tautulli/Publish%20Docker/master?style=flat-square
+[badge-docker-master-ci]: https://img.shields.io/github/actions/workflow/status/Tautulli/Tautulli/.github/workflows/publish-docker.yml?style=flat-square&branch=master
 [badge-docker-beta]: https://img.shields.io/badge/docker-beta-blue?style=flat-square
-[badge-docker-beta-ci]: https://img.shields.io/github/workflow/status/Tautulli/Tautulli/Publish%20Docker/beta?style=flat-square
+[badge-docker-beta-ci]: https://img.shields.io/github/actions/workflow/status/Tautulli/Tautulli/.github/workflows/publish-docker.yml?style=flat-square&branch=beta
 [badge-docker-nightly]: https://img.shields.io/badge/docker-nightly-blue?style=flat-square
-[badge-docker-nightly-ci]: https://img.shields.io/github/workflow/status/Tautulli/Tautulli/Publish%20Docker/nightly?style=flat-square
+[badge-docker-nightly-ci]: https://img.shields.io/github/actions/workflow/status/Tautulli/Tautulli/.github/workflows/publish-docker.yml?style=flat-square&branch=nightly
 [badge-snap-master]: https://img.shields.io/badge/snap-stable-blue?style=flat-square
-[badge-snap-master-ci]: https://img.shields.io/github/workflow/status/Tautulli/Tautulli/Publish%20Snap/master?style=flat-square
+[badge-snap-master-ci]: https://img.shields.io/github/actions/workflow/status/Tautulli/Tautulli/.github/workflows/publish-snap.yml?style=flat-square&branch=master
 [badge-snap-beta]: https://img.shields.io/badge/snap-beta-blue?style=flat-square
-[badge-snap-beta-ci]: https://img.shields.io/github/workflow/status/Tautulli/Tautulli/Publish%20Snap/beta?style=flat-square
+[badge-snap-beta-ci]: https://img.shields.io/github/actions/workflow/status/Tautulli/Tautulli/.github/workflows/publish-snap.yml?style=flat-square&branch=beta
 [badge-snap-nightly]: https://img.shields.io/badge/snap-edge-blue?style=flat-square
-[badge-snap-nightly-ci]: https://img.shields.io/github/workflow/status/Tautulli/Tautulli/Publish%20Snap/nightly?style=flat-square
+[badge-snap-nightly-ci]: https://img.shields.io/github/actions/workflow/status/Tautulli/Tautulli/.github/workflows/publish-snap.yml?style=flat-square&branch=nightly
 [badge-installer-master-win]: https://img.shields.io/github/v/release/Tautulli/Tautulli?label=windows&style=flat-square
 [badge-installer-master-macos]: https://img.shields.io/github/v/release/Tautulli/Tautulli?label=macos&style=flat-square
-[badge-installer-master-ci]: https://img.shields.io/github/workflow/status/Tautulli/Tautulli/Publish%20Installers/master?style=flat-square
+[badge-installer-master-ci]: https://img.shields.io/github/actions/workflow/status/Tautulli/Tautulli/.github/workflows/publish-installers.yml?style=flat-square&branch=master
 [badge-installer-beta-win]: https://img.shields.io/github/v/release/Tautulli/Tautulli?label=windows&include_prereleases&style=flat-square
 [badge-installer-beta-macos]: https://img.shields.io/github/v/release/Tautulli/Tautulli?label=macos&include_prereleases&style=flat-square
-[badge-installer-beta-ci]: https://img.shields.io/github/workflow/status/Tautulli/Tautulli/Publish%20Installers/beta?style=flat-square
-[badge-installer-nightly-ci]: https://img.shields.io/github/workflow/status/Tautulli/Tautulli/Publish%20Installers/nightly?style=flat-square
+[badge-installer-beta-ci]: https://img.shields.io/github/actions/workflow/status/Tautulli/Tautulli/.github/workflows/publish-installers.yml?style=flat-square&branch=beta
+[badge-installer-nightly-ci]: https://img.shields.io/github/actions/workflow/status/Tautulli/Tautulli/.github/workflows/publish-installers.yml?style=flat-square&branch=nightly
 
 ## Support
 

From 460a463be11386e2777f488f60e6d437672f283c Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 19 Jan 2023 13:54:55 -0800
Subject: [PATCH 296/743] Update notification parameter description for Plex
 API image paths

---
 plexpy/common.py | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/plexpy/common.py b/plexpy/common.py
index 33b4cc00..3e56a4c9 100644
--- a/plexpy/common.py
+++ b/plexpy/common.py
@@ -600,11 +600,11 @@ NOTIFICATION_PARAMETERS = [
              {'name': 'Rating Key', 'type': 'int', 'value': 'rating_key', 'description': 'The unique identifier for the movie, episode, or track.'},
              {'name': 'Parent Rating Key', 'type': 'int', 'value': 'parent_rating_key', 'description': 'The unique identifier for the season or album.'},
              {'name': 'Grandparent Rating Key', 'type': 'int', 'value': 'grandparent_rating_key', 'description': 'The unique identifier for the TV show or artist.'},
-             {'name': 'Art', 'type': 'str', 'value': 'art', 'description': 'The Plex background art for the media.'},
-             {'name': 'Thumb', 'type': 'str', 'value': 'thumb', 'description': 'The Plex thumbnail for the movie or episode.'},
-             {'name': 'Parent Thumb', 'type': 'str', 'value': 'parent_thumb', 'description': 'The Plex thumbnail for the season or album.'},
-             {'name': 'Grandparent Thumb', 'type': 'str', 'value': 'grandparent_thumb', 'description': 'The Plex thumbnail for the TV show or artist.'},
-             {'name': 'Poster Thumb', 'type': 'str', 'value': 'poster_thumb', 'description': 'The Plex thumbnail for the poster image.'},
+             {'name': 'Art', 'type': 'str', 'value': 'art', 'description': 'The Plex API path to the background art for the media.'},
+             {'name': 'Thumb', 'type': 'str', 'value': 'thumb', 'description': 'The Plex API path to the thumbnail for the movie or episode.'},
+             {'name': 'Parent Thumb', 'type': 'str', 'value': 'parent_thumb', 'description': 'The Plex API path to the thumbnail for the season or album.'},
+             {'name': 'Grandparent Thumb', 'type': 'str', 'value': 'grandparent_thumb', 'description': 'The Plex API path to the thumbnail for the TV show or artist.'},
+             {'name': 'Poster Thumb', 'type': 'str', 'value': 'poster_thumb', 'description': 'The Plex API path to the thumbnail for the poster image.'},
              {'name': 'Poster Title', 'type': 'str', 'value': 'poster_title', 'description': 'The title for the poster image.'},
              {'name': 'Indexes', 'type': 'int', 'value': 'indexes', 'description': 'If the media has video preview thumbnails.', 'example': '0 or 1'},
          ]

From 548264d51a905bd80d418e0bdb34266b6da32a8c Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 20 Jan 2023 17:05:30 -0800
Subject: [PATCH 297/743] Add prvenance: false to docker/build-push-action

Ref: docker/buildx#1533
---
 .github/workflows/publish-docker.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.github/workflows/publish-docker.yml b/.github/workflows/publish-docker.yml
index 125cae51..37885c2f 100644
--- a/.github/workflows/publish-docker.yml
+++ b/.github/workflows/publish-docker.yml
@@ -87,6 +87,7 @@ jobs:
             ghcr.io/${{ steps.prepare.outputs.docker_image }}:${{ steps.prepare.outputs.tag }}
           cache-from: type=local,src=/tmp/.buildx-cache
           cache-to: type=local,dest=/tmp/.buildx-cache
+          provenance: false
 
   discord:
     name: Discord Notification

From 1e02c26a9ad1fa3c36040e9a6c3cd58179739d0c Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 20 Jan 2023 17:09:03 -0800
Subject: [PATCH 298/743] Relax workflow action versions

---
 .github/workflows/publish-docker.yml     | 4 ++--
 .github/workflows/publish-installers.yml | 4 ++--
 .github/workflows/publish-snap.yml       | 2 +-
 .github/workflows/pull-requests.yml      | 2 +-
 4 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/.github/workflows/publish-docker.yml b/.github/workflows/publish-docker.yml
index 37885c2f..85ce6266 100644
--- a/.github/workflows/publish-docker.yml
+++ b/.github/workflows/publish-docker.yml
@@ -13,7 +13,7 @@ jobs:
     if: ${{ !contains(github.event.head_commit.message, '[skip ci]') }}
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v3.2.0
+        uses: actions/checkout@v3
 
       - name: Prepare
         id: prepare
@@ -47,7 +47,7 @@ jobs:
           version: latest
 
       - name: Cache Docker Layers
-        uses: actions/cache@v3.2.0
+        uses: actions/cache@v3
         with:
           path: /tmp/.buildx-cache
           key: ${{ runner.os }}-buildx-${{ github.sha }}
diff --git a/.github/workflows/publish-installers.yml b/.github/workflows/publish-installers.yml
index 3b271a1b..31ad0f81 100644
--- a/.github/workflows/publish-installers.yml
+++ b/.github/workflows/publish-installers.yml
@@ -24,7 +24,7 @@ jobs:
 
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v3.2.0
+        uses: actions/checkout@v3
 
       - name: Set Release Version
         id: get_version
@@ -52,7 +52,7 @@ jobs:
           echo $GITHUB_SHA > version.txt
 
       - name: Set Up Python
-        uses: actions/setup-python@v4.4.0
+        uses: actions/setup-python@v4
         with:
           python-version: '3.9'
           cache: pip
diff --git a/.github/workflows/publish-snap.yml b/.github/workflows/publish-snap.yml
index 7ad8fe95..9df4d2fd 100644
--- a/.github/workflows/publish-snap.yml
+++ b/.github/workflows/publish-snap.yml
@@ -20,7 +20,7 @@ jobs:
           - armhf
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v3.2.0
+        uses: actions/checkout@v3
 
       - name: Prepare
         id: prepare
diff --git a/.github/workflows/pull-requests.yml b/.github/workflows/pull-requests.yml
index d7c8e45d..58cb4ee4 100644
--- a/.github/workflows/pull-requests.yml
+++ b/.github/workflows/pull-requests.yml
@@ -10,7 +10,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v3.2.0
+        uses: actions/checkout@v3
 
       - name: Comment on Pull Request
         uses: mshick/add-pr-comment@v2

From 0959f28e957ef119e5abbd083796c650862501c4 Mon Sep 17 00:00:00 2001
From: herby2212 <12448284+herby2212@users.noreply.github.com>
Date: Sat, 28 Jan 2023 23:09:11 +0100
Subject: [PATCH 299/743] Add edition detail field for movie info (#1957)

* edition addition for movie info

* swap position to match plex order
---
 data/interfaces/default/info.html | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/data/interfaces/default/info.html b/data/interfaces/default/info.html
index 6d8b3aaf..a7acb11b 100644
--- a/data/interfaces/default/info.html
+++ b/data/interfaces/default/info.html
@@ -14,6 +14,7 @@ rating_key              Returns the unique identifier for the media item.
 media_type              Returns the type of media. Either 'movie', 'show', 'season', 'episode', 'artist', 'album', or 'track'.
 art                     Returns the location of the item's artwork
 title                   Returns the name of the movie, show, episode, artist, album, or track.
+edition_title            Returns the edition title of a movie.
 duration                Returns the standard runtime of the media.
 content_rating          Returns the age rating for the media.
 summary                 Returns a brief description of the media plot.
@@ -390,6 +391,11 @@ DOCUMENTATION :: END
                                 Runtime <strong> <span id="runtime">${data['duration']}</span></strong>
                                 % endif
                             </div>
+                            % if data['edition_title']:
+                            <div class="summary-content-details-tag">
+                                Edition <strong> ${data['edition_title']} </strong>
+                            </div>
+                            % endif
                             <div class="summary-content-details-tag">
                                 % if data['content_rating']:
                                 Rated <strong> ${data['content_rating']} </strong>

From c51ee673e83e4ed2fe143f3ef8466575070e31ff Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 28 Jan 2023 13:29:12 -0800
Subject: [PATCH 300/743] Add support for Telegram group topics

* Closes #1980
---
 plexpy/notifiers.py | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/plexpy/notifiers.py b/plexpy/notifiers.py
index fbd48c4b..75f810d8 100644
--- a/plexpy/notifiers.py
+++ b/plexpy/notifiers.py
@@ -3962,7 +3962,10 @@ class TELEGRAM(Notifier):
                        }
 
     def agent_notify(self, subject='', body='', action='', **kwargs):
-        data = {'chat_id': self.config['chat_id']}
+        chat_id, *message_thread_id = self.config['chat_id'].split('/')
+        data = {'chat_id': chat_id}
+        if message_thread_id:
+            data['message_thread_id'] = message_thread_id[0]
 
         if self.config['incl_subject']:
             text = subject + '\r\n' + body
@@ -4032,7 +4035,8 @@ class TELEGRAM(Notifier):
                           'description': 'Your Telegram Chat ID, Group ID, Channel ID or @channelusername. '
                                          'Contact <a href="' + helpers.anon_url('https://telegram.me/myidbot') +
                                          '" target="_blank">@myidbot</a>'
-                                         ' on Telegram to get an ID.',
+                                         ' on Telegram to get an ID. '
+                                         'For a group topic, append <span class="inline-pre">/topicID</span> to the group ID.',
                           'input_type': 'text'
                           },
                          {'label': 'Include Subject Line',

From b0a55df8620e37795e6a5e202fdd8b10e4d5338a Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 28 Jan 2023 13:43:42 -0800
Subject: [PATCH 301/743] Add anidb_id and anidb_url notification parameters

* Closes #1973
---
 plexpy/common.py               | 2 ++
 plexpy/notification_handler.py | 6 ++++++
 2 files changed, 8 insertions(+)

diff --git a/plexpy/common.py b/plexpy/common.py
index 3e56a4c9..ad91ee87 100644
--- a/plexpy/common.py
+++ b/plexpy/common.py
@@ -553,6 +553,8 @@ NOTIFICATION_PARAMETERS = [
              {'name': 'TVmaze URL', 'type': 'str', 'value': 'tvmaze_url', 'description': 'The TVmaze URL for the TV show.'},
              {'name': 'MusicBrainz ID', 'type': 'str', 'value': 'musicbrainz_id', 'description': 'The MusicBrainz ID for the artist, album, or track.', 'example': 'e.g. b670dfcf-9824-4309-a57e-03595aaba286'},
              {'name': 'MusicBrainz URL', 'type': 'str', 'value': 'musicbrainz_url', 'description': 'The MusicBrainz URL for the artist, album, or track.'},
+             {'name': 'AniDB ID', 'type': 'str', 'value': 'anidb_id', 'description': 'The AniDB ID for the Anime', 'example': 'e.g. 69', 'help_text': 'TV show library agent must be HAMA'},
+             {'name': 'AniDB URL', 'type': 'str', 'value': 'anidb_url', 'description': 'The AniDB URL for the Anime', 'help_text': 'TV show library agent must be HAMA'},
              {'name': 'Last.fm URL', 'type': 'str', 'value': 'lastfm_url', 'description': 'The Last.fm URL for the album.', 'help_text': 'Music library agent must be Last.fm'},
              {'name': 'Trakt.tv URL', 'type': 'str', 'value': 'trakt_url', 'description': 'The trakt.tv URL for the movie or TV show.'},
              {'name': 'Container', 'type': 'str', 'value': 'container', 'description': 'The media container of the original media.'},
diff --git a/plexpy/notification_handler.py b/plexpy/notification_handler.py
index 57f5ff83..6b55c5b7 100644
--- a/plexpy/notification_handler.py
+++ b/plexpy/notification_handler.py
@@ -715,6 +715,10 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
         else:
             notify_params['musicbrainz_url'] = 'https://musicbrainz.org/track/' + notify_params['musicbrainz_id']
 
+    if 'hama://' in notify_params['guid']:
+        notify_params['anidb_id'] = notify_params['guid'].split('hama://')[1].split('/')[0].split('?')[0].split('-')[1]
+        notify_params['anidb_url'] = 'https://anidb.net/anime/' + notify_params['anidb_id']
+
     # Get TheMovieDB info (for movies and tv only)
     if plexpy.CONFIG.THEMOVIEDB_LOOKUP and notify_params['media_type'] in ('movie', 'show', 'season', 'episode'):
         if notify_params.get('themoviedb_id'):
@@ -1142,6 +1146,8 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
         'tvmaze_url': notify_params['tvmaze_url'],
         'musicbrainz_id': notify_params['musicbrainz_id'],
         'musicbrainz_url': notify_params['musicbrainz_url'],
+        'anidb_id': notify_params['anidb_id'],
+        'anidb_url': notify_params['anidb_url'],
         'lastfm_url': notify_params['lastfm_url'],
         'trakt_url': notify_params['trakt_url'],
         'container': notify_params['container'],

From b6ff45138f29763b92fa59646c7499cfd3d28c41 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 28 Jan 2023 14:04:45 -0800
Subject: [PATCH 302/743] Add section_id and user_id parameters to
 get_home_stats API command

* Closes #1944
---
 plexpy/datafactory.py | 49 ++++++++++++++++++++++++-------------------
 plexpy/webserve.py    |  9 ++++++--
 2 files changed, 35 insertions(+), 23 deletions(-)

diff --git a/plexpy/datafactory.py b/plexpy/datafactory.py
index 700c14c6..cf55a2c0 100644
--- a/plexpy/datafactory.py
+++ b/plexpy/datafactory.py
@@ -349,7 +349,8 @@ class DataFactory(object):
         return dict
 
     def get_home_stats(self, grouping=None, time_range=30, stats_type='plays',
-                       stats_start=0, stats_count=10, stat_id='', stats_cards=None):
+                       stats_start=0, stats_count=10, stat_id='', stats_cards=None,
+                       section_id=None, user_id=None):
         monitor_db = database.MonitorDatabase()
 
         time_range = helpers.cast_to_int(time_range)
@@ -364,6 +365,12 @@ class DataFactory(object):
         if stats_cards is None:
             stats_cards = plexpy.CONFIG.HOME_STATS_CARDS
 
+        where_id = ''
+        if section_id:
+            where_id += 'AND session_history.section_id = %s ' % section_id
+        if user_id:
+            where_id += 'AND session_history.user_id = %s ' % user_id
+
         movie_watched_percent = plexpy.CONFIG.MOVIE_WATCHED_PERCENT
         tv_watched_percent = plexpy.CONFIG.TV_WATCHED_PERCENT
         music_watched_percent = plexpy.CONFIG.MUSIC_WATCHED_PERCENT
@@ -385,12 +392,12 @@ class DataFactory(object):
                             '       AS d ' \
                             '   FROM session_history ' \
                             '   WHERE session_history.stopped >= %s ' \
-                            '       AND session_history.media_type = "movie" ' \
+                            '       AND session_history.media_type = "movie" %s ' \
                             '   GROUP BY %s) AS sh ' \
                             'JOIN session_history_metadata AS shm ON shm.id = sh.id ' \
                             'GROUP BY shm.full_title, shm.year ' \
                             'ORDER BY %s DESC, sh.started DESC ' \
-                            'LIMIT %s OFFSET %s ' % (timestamp, group_by, sort_type, stats_count, stats_start)
+                            'LIMIT %s OFFSET %s ' % (timestamp, where_id, group_by, sort_type, stats_count, stats_start)
                     result = monitor_db.select(query)
                 except Exception as e:
                     logger.warn("Tautulli DataFactory :: Unable to execute database query for get_home_stats: top_movies: %s." % e)
@@ -438,12 +445,12 @@ class DataFactory(object):
                             '       AS d ' \
                             '   FROM session_history ' \
                             '   WHERE session_history.stopped >= %s ' \
-                            '       AND session_history.media_type = "movie" ' \
+                            '       AND session_history.media_type = "movie" %s ' \
                             '   GROUP BY %s) AS sh ' \
                             'JOIN session_history_metadata AS shm ON shm.id = sh.id ' \
                             'GROUP BY shm.full_title, shm.year ' \
                             'ORDER BY users_watched DESC, %s DESC, sh.started DESC ' \
-                            'LIMIT %s OFFSET %s ' % (timestamp, group_by, sort_type, stats_count, stats_start)
+                            'LIMIT %s OFFSET %s ' % (timestamp, where_id, group_by, sort_type, stats_count, stats_start)
                     result = monitor_db.select(query)
                 except Exception as e:
                     logger.warn("Tautulli DataFactory :: Unable to execute database query for get_home_stats: popular_movies: %s." % e)
@@ -490,12 +497,12 @@ class DataFactory(object):
                             '       AS d ' \
                             '   FROM session_history ' \
                             '   WHERE session_history.stopped >= %s ' \
-                            '       AND session_history.media_type = "episode" ' \
+                            '       AND session_history.media_type = "episode" %s ' \
                             '   GROUP BY %s) AS sh ' \
                             'JOIN session_history_metadata AS shm ON shm.id = sh.id ' \
                             'GROUP BY shm.grandparent_title ' \
                             'ORDER BY %s DESC, sh.started DESC ' \
-                            'LIMIT %s OFFSET %s ' % (timestamp, group_by, sort_type, stats_count, stats_start)
+                            'LIMIT %s OFFSET %s ' % (timestamp, where_id, group_by, sort_type, stats_count, stats_start)
                     result = monitor_db.select(query)
                 except Exception as e:
                     logger.warn("Tautulli DataFactory :: Unable to execute database query for get_home_stats: top_tv: %s." % e)
@@ -545,12 +552,12 @@ class DataFactory(object):
                             '       AS d ' \
                             '   FROM session_history ' \
                             '   WHERE session_history.stopped >= %s ' \
-                            '       AND session_history.media_type = "episode" ' \
+                            '       AND session_history.media_type = "episode" %s ' \
                             '   GROUP BY %s) AS sh ' \
                             'JOIN session_history_metadata AS shm ON shm.id = sh.id ' \
                             'GROUP BY shm.grandparent_title ' \
                             'ORDER BY users_watched DESC, %s DESC, sh.started DESC ' \
-                            'LIMIT %s OFFSET %s ' % (timestamp, group_by, sort_type, stats_count, stats_start)
+                            'LIMIT %s OFFSET %s ' % (timestamp, where_id, group_by, sort_type, stats_count, stats_start)
                     result = monitor_db.select(query)
                 except Exception as e:
                     logger.warn("Tautulli DataFactory :: Unable to execute database query for get_home_stats: popular_tv: %s." % e)
@@ -596,12 +603,12 @@ class DataFactory(object):
                             '       AS d ' \
                             '   FROM session_history ' \
                             '   WHERE session_history.stopped >= %s ' \
-                            '       AND session_history.media_type = "track" ' \
+                            '       AND session_history.media_type = "track" %s ' \
                             '   GROUP BY %s) AS sh ' \
                             'JOIN session_history_metadata AS shm ON shm.id = sh.id ' \
                             'GROUP BY shm.original_title, shm.grandparent_title ' \
                             'ORDER BY %s DESC, sh.started DESC ' \
-                            'LIMIT %s OFFSET %s ' % (timestamp, group_by, sort_type, stats_count, stats_start)
+                            'LIMIT %s OFFSET %s ' % (timestamp, where_id, group_by, sort_type, stats_count, stats_start)
                     result = monitor_db.select(query)
                 except Exception as e:
                     logger.warn("Tautulli DataFactory :: Unable to execute database query for get_home_stats: top_music: %s." % e)
@@ -650,12 +657,12 @@ class DataFactory(object):
                             '       AS d ' \
                             '   FROM session_history ' \
                             '   WHERE session_history.stopped >= %s ' \
-                            '       AND session_history.media_type = "track" ' \
+                            '       AND session_history.media_type = "track" %s ' \
                             '   GROUP BY %s) AS sh ' \
                             'JOIN session_history_metadata AS shm ON shm.id = sh.id ' \
                             'GROUP BY shm.original_title, shm.grandparent_title ' \
                             'ORDER BY users_watched DESC, %s DESC, sh.started DESC ' \
-                            'LIMIT %s OFFSET %s ' % (timestamp, group_by, sort_type, stats_count, stats_start)
+                            'LIMIT %s OFFSET %s ' % (timestamp, where_id, group_by, sort_type, stats_count, stats_start)
                     result = monitor_db.select(query)
                 except Exception as e:
                     logger.warn("Tautulli DataFactory :: Unable to execute database query for get_home_stats: popular_music: %s." % e)
@@ -706,14 +713,14 @@ class DataFactory(object):
                             '       (CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) ELSE 0 END) ' \
                             '       AS d ' \
                             '   FROM session_history ' \
-                            '   WHERE session_history.stopped >= %s ' \
+                            '   WHERE session_history.stopped >= %s %s ' \
                             '   GROUP BY %s) AS sh ' \
                             'JOIN session_history_metadata AS shm ON shm.id = sh.id ' \
                             'LEFT OUTER JOIN (SELECT * FROM library_sections WHERE deleted_section = 0) ' \
                             '   AS ls ON sh.section_id = ls.section_id ' \
                             'GROUP BY sh.section_id ' \
                             'ORDER BY %s DESC, sh.started DESC ' \
-                            'LIMIT %s OFFSET %s ' % (timestamp, group_by, sort_type, stats_count, stats_start)
+                            'LIMIT %s OFFSET %s ' % (timestamp, where_id, group_by, sort_type, stats_count, stats_start)
                     result = monitor_db.select(query)
                 except Exception as e:
                     logger.warn("Tautulli DataFactory :: Unable to execute database query for get_home_stats: top_libraries: %s." % e)
@@ -793,13 +800,13 @@ class DataFactory(object):
                             '       (CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) ELSE 0 END) ' \
                             '       AS d ' \
                             '   FROM session_history ' \
-                            '   WHERE session_history.stopped >= %s ' \
+                            '   WHERE session_history.stopped >= %s %s ' \
                             '   GROUP BY %s) AS sh ' \
                             'JOIN session_history_metadata AS shm ON shm.id = sh.id ' \
                             'LEFT OUTER JOIN users AS u ON sh.user_id = u.user_id ' \
                             'GROUP BY sh.user_id ' \
                             'ORDER BY %s DESC, sh.started DESC ' \
-                            'LIMIT %s OFFSET %s ' % (timestamp, group_by, sort_type, stats_count, stats_start)
+                            'LIMIT %s OFFSET %s ' % (timestamp, where_id, group_by, sort_type, stats_count, stats_start)
                     result = monitor_db.select(query)
                 except Exception as e:
                     logger.warn("Tautulli DataFactory :: Unable to execute database query for get_home_stats: top_users: %s." % e)
@@ -862,11 +869,11 @@ class DataFactory(object):
                             '       (CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) ELSE 0 END) ' \
                             '       AS d ' \
                             '   FROM session_history ' \
-                            '   WHERE session_history.stopped >= %s ' \
+                            '   WHERE session_history.stopped >= %s %s ' \
                             '   GROUP BY %s) AS sh ' \
                             'GROUP BY sh.platform ' \
                             'ORDER BY %s DESC, sh.started DESC ' \
-                            'LIMIT %s OFFSET %s ' % (timestamp, group_by, sort_type, stats_count, stats_start)
+                            'LIMIT %s OFFSET %s ' % (timestamp, where_id, group_by, sort_type, stats_count, stats_start)
                     result = monitor_db.select(query)
                 except Exception as e:
                     logger.warn("Tautulli DataFactory :: Unable to execute database query for get_home_stats: top_platforms: %s." % e)
@@ -918,7 +925,7 @@ class DataFactory(object):
                             'FROM (SELECT *, MAX(id) FROM session_history ' \
                             '   WHERE session_history.stopped >= %s ' \
                             '       AND (session_history.media_type = "movie" ' \
-                            '           OR session_history.media_type = "episode") ' \
+                            '           OR session_history.media_type = "episode") %s ' \
                             '   GROUP BY %s) AS sh ' \
                             'JOIN session_history_metadata AS shm ON shm.id = sh.id ' \
                             'LEFT OUTER JOIN users AS u ON sh.user_id = u.user_id ' \
@@ -926,7 +933,7 @@ class DataFactory(object):
                             '   OR sh.media_type == "episode" AND percent_complete >= %s ' \
                             'GROUP BY sh.id ' \
                             'ORDER BY last_watch DESC ' \
-                            'LIMIT %s OFFSET %s' % (timestamp, group_by, movie_watched_percent, tv_watched_percent,
+                            'LIMIT %s OFFSET %s' % (timestamp, where_id, group_by, movie_watched_percent, tv_watched_percent,
                                                     stats_count, stats_start)
                     result = monitor_db.select(query)
                 except Exception as e:
diff --git a/plexpy/webserve.py b/plexpy/webserve.py
index 76c44243..8ad3e664 100644
--- a/plexpy/webserve.py
+++ b/plexpy/webserve.py
@@ -6185,7 +6185,8 @@ class WebInterface(object):
     @requireAuth(member_of("admin"))
     @addtoapi()
     def get_home_stats(self, grouping=None, time_range=30, stats_type='plays',
-                       stats_start=0, stats_count=10, stat_id='', **kwargs):
+                       stats_start=0, stats_count=10, stat_id='',
+                       section_id=None, user_id=None, **kwargs):
         """ Get the homepage watch statistics.
 
             ```
@@ -6201,6 +6202,8 @@ class WebInterface(object):
                 stat_id (str):          A single stat to return, 'top_movies', 'popular_movies',
                                         'top_tv', 'popular_tv', 'top_music', 'popular_music', 'top_libraries',
                                         'top_users', 'top_platforms', 'last_watched', 'most_concurrent'
+                section_id (int):       The id of the Plex library section
+                user_id (int):          The id of the Plex user
 
             Returns:
                 json:
@@ -6282,7 +6285,9 @@ class WebInterface(object):
                                              stats_type=stats_type,
                                              stats_start=stats_start,
                                              stats_count=stats_count,
-                                             stat_id=stat_id)
+                                             stat_id=stat_id,
+                                             section_id=section_id,
+                                             user_id=user_id)
 
         if result:
             return result

From 5ab9315f1601850c04bff5858429799da0148ee8 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 14 Feb 2023 18:19:35 -0800
Subject: [PATCH 303/743] Upload notification images directly to Discord

---
 plexpy/notifiers.py | 31 +++++++++++++++++++++++--------
 1 file changed, 23 insertions(+), 8 deletions(-)

diff --git a/plexpy/notifiers.py b/plexpy/notifiers.py
index 75f810d8..3e721515 100644
--- a/plexpy/notifiers.py
+++ b/plexpy/notifiers.py
@@ -892,6 +892,15 @@ class PrettyMetadata(object):
         parameters[''] = ''
         return parameters
 
+    def get_image(self):
+        result = pmsconnect.PmsConnect().get_image(img=self.parameters.get('poster_thumb', ''))
+        if result and result[0]:
+            poster_content = result[0]
+            poster_filename = 'poster_{}.png'.format(self.parameters['rating_key'])
+            return (poster_filename, poster_content, 'image/png')
+        
+        logger.error("Tautulli Notifiers :: Unable to retrieve image for notification.")
+
 
 class Notifier(object):
     NAME = ''
@@ -1117,10 +1126,16 @@ class DISCORD(Notifier):
         if self.config['tts']:
             data['tts'] = True
 
+        files = {}
+
         if self.config['incl_card'] and kwargs.get('parameters', {}).get('media_type'):
             # Grab formatted metadata
             pretty_metadata = PrettyMetadata(kwargs['parameters'])
 
+            image = pretty_metadata.get_image()
+            if image:
+                files = {'files[0]': image}
+
             if pretty_metadata.media_type == 'movie':
                 provider = self.config['movie_provider']
             elif pretty_metadata.media_type in ('show', 'season', 'episode'):
@@ -1150,9 +1165,9 @@ class DISCORD(Notifier):
                     attachment['color'] = helpers.hex_to_int(hex)
 
             if self.config['incl_thumbnail']:
-                attachment['thumbnail'] = {'url': poster_url}
+                attachment['thumbnail'] = {'url': 'attachment://{}'.format(image[0]) if image else poster_url}
             else:
-                attachment['image'] = {'url': poster_url}
+                attachment['image'] = {'url': 'attachment://{}'.format(image[0]) if image else poster_url}
 
             if self.config['incl_description']:
                 attachment['description'] = description[:2045] + (description[2045:] and '...')
@@ -1172,10 +1187,13 @@ class DISCORD(Notifier):
 
             data['embeds'] = [attachment]
 
-        headers = {'Content-type': 'application/json'}
         params = {'wait': True}
 
-        return self.make_request(self.config['hook'], params=params, headers=headers, json=data)
+        if files:
+            files['payload_json'] = (None, json.dumps(data), 'application/json')
+            return self.make_request(self.config['hook'], params=params, files=files)
+        else:
+            return self.make_request(self.config['hook'], params=params, json=data)
 
     def _return_config_options(self):
         config_option = [{'label': 'Discord Webhook URL',
@@ -1217,10 +1235,7 @@ class DISCORD(Notifier):
                          {'label': 'Include Rich Metadata Info',
                           'value': self.config['incl_card'],
                           'name': 'discord_incl_card',
-                          'description': 'Include an info card with a poster and metadata with the notifications.<br>'
-                                         'Note: <a data-tab-destination="3rd_party_apis" data-dismiss="modal" '
-                                         'data-target="notify_upload_posters">Image Hosting</a> '
-                                         'must be enabled under the 3rd Party APIs settings tab.',
+                          'description': 'Include an info card with a poster and metadata with the notifications.',
                           'input_type': 'checkbox'
                           },
                          {'label': 'Include Summary',

From e263f0b8a3a40f92820a6a230f5a377eef817a5c Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 14 Feb 2023 18:21:11 -0800
Subject: [PATCH 304/743] Refactor notification image upload code

---
 plexpy/notifiers.py | 57 +++++++++++----------------------------------
 1 file changed, 13 insertions(+), 44 deletions(-)

diff --git a/plexpy/notifiers.py b/plexpy/notifiers.py
index 3e721515..e3ef6862 100644
--- a/plexpy/notifiers.py
+++ b/plexpy/notifiers.py
@@ -1807,19 +1807,12 @@ class GROUPME(Notifier):
         if self.config['incl_poster'] and kwargs.get('parameters'):
             pretty_metadata = PrettyMetadata(kwargs.get('parameters'))
 
-            # Retrieve the poster from Plex
-            result = pmsconnect.PmsConnect().get_image(img=pretty_metadata.parameters.get('poster_thumb',''))
-            if result and result[0]:
-                poster_content = result[0]
-            else:
-                poster_content = ''
-                logger.error("Tautulli Notifiers :: Unable to retrieve image for {name}.".format(name=self.NAME))
-
-            if poster_content:
+            image = pretty_metadata.get_image()
+            if image:
                 headers = {'X-Access-Token': self.config['access_token'],
                            'Content-Type': 'image/png'}
 
-                r = requests.post('https://image.groupme.com/pictures', headers=headers, data=poster_content)
+                r = requests.post('https://image.groupme.com/pictures', headers=headers, data=image[1])
 
                 if r.status_code == 200:
                     logger.info("Tautulli Notifiers :: {name} poster sent.".format(name=self.NAME))
@@ -3042,18 +3035,10 @@ class PUSHBULLET(Notifier):
             # Grab formatted metadata
             pretty_metadata = PrettyMetadata(kwargs['parameters'])
 
-            # Retrieve the poster from Plex
-            result = pmsconnect.PmsConnect().get_image(img=pretty_metadata.parameters.get('poster_thumb', ''))
-            if result and result[0]:
-                poster_content = result[0]
-            else:
-                poster_content = ''
-                logger.error("Tautulli Notifiers :: Unable to retrieve image for {name}.".format(name=self.NAME))
-
-            if poster_content:
-                poster_filename = 'poster_{}.png'.format(pretty_metadata.parameters['rating_key'])
-                file_json = {'file_name': poster_filename, 'file_type': 'image/png'}
-                files = {'file': (poster_filename, poster_content, 'image/png')}
+            image = pretty_metadata.get_image()
+            if image:
+                file_json = {'file_name': image[0], 'file_type': image[2]}
+                files = {'file': image}
 
                 r = requests.post('https://api.pushbullet.com/v2/upload-request', headers=headers, json=file_json)
 
@@ -3199,17 +3184,9 @@ class PUSHOVER(Notifier):
             # Grab formatted metadata
             pretty_metadata = PrettyMetadata(kwargs['parameters'])
 
-            # Retrieve the poster from Plex
-            result = pmsconnect.PmsConnect().get_image(img=pretty_metadata.parameters.get('poster_thumb', ''))
-            if result and result[0]:
-                poster_content = result[0]
-            else:
-                poster_content = ''
-                logger.error("Tautulli Notifiers :: Unable to retrieve image for {name}.".format(name=self.NAME))
-
-            if poster_content:
-                poster_filename = 'poster_{}.png'.format(pretty_metadata.parameters['rating_key'])
-                files = {'attachment': (poster_filename, poster_content, 'image/png')}
+            image = pretty_metadata.get_image()
+            if image:
+                files = {'attachment': image}
                 headers = {}
 
         return self.make_request('https://api.pushover.net/1/messages.json', headers=headers, data=data, files=files)
@@ -3994,17 +3971,9 @@ class TELEGRAM(Notifier):
             # Grab formatted metadata
             pretty_metadata = PrettyMetadata(kwargs['parameters'])
 
-            # Retrieve the poster from Plex
-            result = pmsconnect.PmsConnect().get_image(img=pretty_metadata.parameters.get('poster_thumb', ''))
-            if result and result[0]:
-                poster_content = result[0]
-            else:
-                poster_content = ''
-                logger.error("Tautulli Notifiers :: Unable to retrieve image for {name}.".format(name=self.NAME))
-
-            if poster_content:
-                poster_filename = 'poster_{}.png'.format(pretty_metadata.parameters['rating_key'])
-                files = {'photo': (poster_filename, poster_content, 'image/png')}
+            image = pretty_metadata.get_image()
+            if image:
+                files = {'photo': image}
 
                 if len(text) > 1024:
                     data['disable_notification'] = True

From 0db9548995303d5669e06d5111ed074a486583dd Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 20 Jan 2023 17:05:30 -0800
Subject: [PATCH 305/743] Revert "Add prvenance: false to
 docker/build-push-action"

This reverts commit 548264d51a905bd80d418e0bdb34266b6da32a8c.
---
 .github/workflows/publish-docker.yml | 1 -
 1 file changed, 1 deletion(-)

diff --git a/.github/workflows/publish-docker.yml b/.github/workflows/publish-docker.yml
index 85ce6266..8cb8267f 100644
--- a/.github/workflows/publish-docker.yml
+++ b/.github/workflows/publish-docker.yml
@@ -87,7 +87,6 @@ jobs:
             ghcr.io/${{ steps.prepare.outputs.docker_image }}:${{ steps.prepare.outputs.tag }}
           cache-from: type=local,src=/tmp/.buildx-cache
           cache-to: type=local,dest=/tmp/.buildx-cache
-          provenance: false
 
   discord:
     name: Discord Notification

From a8539b29272995e0cf6ade177923c26119838dc3 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 16 Feb 2023 11:29:18 -0800
Subject: [PATCH 306/743] Retrieve intro/credits markers for metadata details

---
 plexpy/pmsconnect.py | 24 +++++++++++++++++++++++-
 1 file changed, 23 insertions(+), 1 deletion(-)

diff --git a/plexpy/pmsconnect.py b/plexpy/pmsconnect.py
index 11142873..3a7a2450 100644
--- a/plexpy/pmsconnect.py
+++ b/plexpy/pmsconnect.py
@@ -140,7 +140,7 @@ class PmsConnect(object):
 
         Output: array
         """
-        uri = '/library/metadata/' + rating_key
+        uri = '/library/metadata/' + rating_key + '?includeMarkers=1'
         request = self.request_handler.make_request(uri=uri,
                                                     request_type='GET',
                                                     output_format=output_format)
@@ -745,6 +745,7 @@ class PmsConnect(object):
         labels = []
         collections = []
         guids = []
+        markers = []
 
         if metadata_main.getElementsByTagName('Director'):
             for director in metadata_main.getElementsByTagName('Director'):
@@ -774,6 +775,16 @@ class PmsConnect(object):
             for guid in metadata_main.getElementsByTagName('Guid'):
                 guids.append(helpers.get_xml_attr(guid, 'id'))
 
+        if metadata_main.getElementsByTagName('Marker'):
+            for marker in metadata_main.getElementsByTagName('Marker'):
+                markers.append({
+                    'id': helpers.get_xml_attr(marker, 'id'),
+                    'type': helpers.get_xml_attr(marker, 'type'),
+                    'start_time_offset': helpers.cast_to_int(helpers.get_xml_attr(marker, 'startTimeOffset')),
+                    'end_time_offset': helpers.cast_to_int(helpers.get_xml_attr(marker, 'endTimeOffset')),
+                    'final': helpers.bool_true(helpers.get_xml_attr(marker, 'final'))
+                })
+
         if metadata_type == 'movie':
             metadata = {'media_type': metadata_type,
                         'section_id': section_id,
@@ -821,6 +832,7 @@ class PmsConnect(object):
                         'labels': labels,
                         'collections': collections,
                         'guids': guids,
+                        'markers': markers,
                         'parent_guids': [],
                         'grandparent_guids': [],
                         'full_title': helpers.get_xml_attr(metadata_main, 'title'),
@@ -880,6 +892,7 @@ class PmsConnect(object):
                         'labels': labels,
                         'collections': collections,
                         'guids': guids,
+                        'markers': markers,
                         'parent_guids': [],
                         'grandparent_guids': [],
                         'full_title': helpers.get_xml_attr(metadata_main, 'title'),
@@ -942,6 +955,7 @@ class PmsConnect(object):
                         'labels': show_details.get('labels', []),
                         'collections': show_details.get('collections', []),
                         'guids': guids,
+                        'markers': markers,
                         'parent_guids': show_details.get('guids', []),
                         'grandparent_guids': [],
                         'full_title': '{} - {}'.format(helpers.get_xml_attr(metadata_main, 'parentTitle'),
@@ -1021,6 +1035,7 @@ class PmsConnect(object):
                         'labels': show_details.get('labels', []),
                         'collections': show_details.get('collections', []),
                         'guids': guids,
+                        'markers': markers,
                         'parent_guids': season_details.get('guids', []),
                         'grandparent_guids': show_details.get('guids', []),
                         'full_title': '{} - {}'.format(helpers.get_xml_attr(metadata_main, 'grandparentTitle'),
@@ -1076,6 +1091,7 @@ class PmsConnect(object):
                         'labels': labels,
                         'collections': collections,
                         'guids': guids,
+                        'markers': markers,
                         'parent_guids': [],
                         'grandparent_guids': [],
                         'full_title': helpers.get_xml_attr(metadata_main, 'title'),
@@ -1132,6 +1148,7 @@ class PmsConnect(object):
                         'labels': labels,
                         'collections': collections,
                         'guids': guids,
+                        'markers': markers,
                         'parent_guids': artist_details.get('guids', []),
                         'grandparent_guids': [],
                         'full_title': '{} - {}'.format(helpers.get_xml_attr(metadata_main, 'parentTitle'),
@@ -1191,6 +1208,7 @@ class PmsConnect(object):
                         'labels': album_details.get('labels', []),
                         'collections': album_details.get('collections', []),
                         'guids': guids,
+                        'markers': markers,
                         'parent_guids': album_details.get('guids', []),
                         'grandparent_guids': album_details.get('parent_guids', []),
                         'full_title': '{} - {}'.format(helpers.get_xml_attr(metadata_main, 'title'),
@@ -1246,6 +1264,7 @@ class PmsConnect(object):
                         'labels': labels,
                         'collections': collections,
                         'guids': guids,
+                        'markers': markers,
                         'parent_guids': [],
                         'grandparent_guids': [],
                         'full_title': helpers.get_xml_attr(metadata_main, 'title'),
@@ -1302,6 +1321,7 @@ class PmsConnect(object):
                         'labels': photo_album_details.get('labels', []),
                         'collections': photo_album_details.get('collections', []),
                         'guids': [],
+                        'markers': markers,
                         'parent_guids': photo_album_details.get('guids', []),
                         'grandparent_guids': [],
                         'full_title': '{} - {}'.format(helpers.get_xml_attr(metadata_main, 'parentTitle') or library_name,
@@ -1361,6 +1381,7 @@ class PmsConnect(object):
                         'labels': labels,
                         'collections': collections,
                         'guids': guids,
+                        'markers': markers,
                         'parent_guids': [],
                         'grandparent_guids': [],
                         'full_title': helpers.get_xml_attr(metadata_main, 'title'),
@@ -1435,6 +1456,7 @@ class PmsConnect(object):
                         'labels': labels,
                         'collections': collections,
                         'guids': guids,
+                        'markers': markers,
                         'parent_guids': [],
                         'grandparent_guids': [],
                         'full_title': helpers.get_xml_attr(metadata_main, 'title'),

From 9a152932ee8c81341123749d61de8b1987390a0d Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 16 Feb 2023 11:29:47 -0800
Subject: [PATCH 307/743] Monitor stream intro/credits marker activity

---
 plexpy/__init__.py           |  15 +-
 plexpy/activity_handler.py   | 380 ++++++++++++++++++-----------------
 plexpy/activity_processor.py |  12 +-
 3 files changed, 226 insertions(+), 181 deletions(-)

diff --git a/plexpy/__init__.py b/plexpy/__init__.py
index d27cd396..003259bc 100644
--- a/plexpy/__init__.py
+++ b/plexpy/__init__.py
@@ -656,7 +656,8 @@ def dbcheck():
         'synced_version INTEGER, synced_version_profile TEXT, '
         'live INTEGER, live_uuid TEXT, channel_call_sign TEXT, channel_identifier TEXT, channel_thumb TEXT, '
         'secure INTEGER, relayed INTEGER, '
-        'buffer_count INTEGER DEFAULT 0, buffer_last_triggered INTEGER, last_paused INTEGER, watched INTEGER DEFAULT 0, '
+        'buffer_count INTEGER DEFAULT 0, buffer_last_triggered INTEGER, last_paused INTEGER, '
+        'watched INTEGER DEFAULT 0, intro INTEGER DEFAULT 0, credits INTEGER DEFAULT 0, '
         'initial_stream INTEGER DEFAULT 1, write_attempts INTEGER DEFAULT 0, raw_stream_info TEXT, '
         'rating_key_websocket TEXT)'
     )
@@ -1401,6 +1402,18 @@ def dbcheck():
             'ALTER TABLE sessions ADD COLUMN stream_subtitle_forced INTEGER'
         )
 
+    # Upgrade sessions table from earlier versions
+    try:
+        c_db.execute('SELECT intro FROM sessions')
+    except sqlite3.OperationalError:
+        logger.debug(u"Altering database. Updating database table sessions.")
+        c_db.execute(
+            'ALTER TABLE sessions ADD COLUMN intro INTEGER DEFAULT 0'
+        )
+        c_db.execute(
+            'ALTER TABLE sessions ADD COLUMN credits INTEGER DEFAULT 0'
+        )
+
     # Upgrade session_history table from earlier versions
     try:
         c_db.execute('SELECT reference_id FROM session_history')
diff --git a/plexpy/activity_handler.py b/plexpy/activity_handler.py
index 07d0f8e3..a89ccb98 100644
--- a/plexpy/activity_handler.py
+++ b/plexpy/activity_handler.py
@@ -51,7 +51,11 @@ RECENTLY_ADDED_QUEUE = {}
 class ActivityHandler(object):
 
     def __init__(self, timeline):
+        self.ap = activity_processor.ActivityProcessor()
         self.timeline = timeline
+        self.db_session = None
+        self.session = None
+        self.metadata = None
 
     def is_valid_session(self):
         if 'sessionKey' in self.timeline:
@@ -72,15 +76,18 @@ class ActivityHandler(object):
 
         return None
 
+    def get_db_session(self):
+        # Retrieve the session data from our temp table
+        self.db_session = self.ap.get_session_by_key(session_key=self.get_session_key())
+
     def get_metadata(self, skip_cache=False):
-        cache_key = None if skip_cache else self.get_session_key()
-        pms_connect = pmsconnect.PmsConnect()
-        metadata = pms_connect.get_metadata_details(rating_key=self.get_rating_key(), cache_key=cache_key)
+        if self.metadata is None:
+            cache_key = None if skip_cache else self.get_session_key()
+            pms_connect = pmsconnect.PmsConnect()
+            metadata = pms_connect.get_metadata_details(rating_key=self.get_rating_key(), cache_key=cache_key)
 
-        if metadata:
-            return metadata
-
-        return None
+            if metadata:
+                self.metadata = metadata
 
     def get_live_session(self, skip_cache=False):
         pms_connect = pmsconnect.PmsConnect()
@@ -94,196 +101,179 @@ class ActivityHandler(object):
                     if not session['rating_key']:
                         session['rating_key'] = self.get_rating_key()
                     session['rating_key_websocket'] = self.get_rating_key()
+                    self.session = session
                     return session
 
-        return None
+    def update_db_session(self, notify=False):
+        if self.session is None:
+            self.get_live_session()
 
-    def update_db_session(self, session=None, notify=False):
-        if session is None:
-            session = self.get_live_session()
-
-        if session:
+        if self.session:
             # Update our session temp table values
-            ap = activity_processor.ActivityProcessor()
-            ap.write_session(session=session, notify=notify)
+            self.ap.write_session(session=self.session, notify=notify)
 
         self.set_session_state()
+        self.get_db_session()
 
     def set_session_state(self):
-        ap = activity_processor.ActivityProcessor()
-        ap.set_session_state(session_key=self.get_session_key(),
+        self.ap.set_session_state(session_key=self.get_session_key(),
                              state=self.timeline['state'],
                              view_offset=self.timeline['viewOffset'],
                              stopped=helpers.timestamp())
+        
+    def put_notification(self, notify_action, **kwargs):
+        notification = {'stream_data': self.db_session.copy(), 'notify_action': notify_action}
+        notification.update(kwargs)
+        plexpy.NOTIFY_QUEUE.put(notification)
 
     def on_start(self):
-        if self.is_valid_session():
-            session = self.get_live_session(skip_cache=True)
+        self.get_live_session(skip_cache=True)
 
-            if not session:
+        if not self.session:
+            return
+
+        # Some DLNA clients create a new session temporarily when browsing the library
+        # Wait and get session again to make sure it is an actual session
+        if self.session['platform'] == 'DLNA':
+            time.sleep(1)
+            self.get_live_session()
+            if not self.session:
                 return
 
-            # Some DLNA clients create a new session temporarily when browsing the library
-            # Wait and get session again to make sure it is an actual session
-            if session['platform'] == 'DLNA':
-                time.sleep(1)
-                session = self.get_live_session()
-                if not session:
-                    return
+        logger.debug("Tautulli ActivityHandler :: Session %s started by user %s (%s) with ratingKey %s (%s)%s."
+                        % (str(self.session['session_key']), str(self.session['user_id']), self.session['username'],
+                        str(self.session['rating_key']), self.session['full_title'], '[Live TV]' if self.session['live'] else ''))
 
-            logger.debug("Tautulli ActivityHandler :: Session %s started by user %s (%s) with ratingKey %s (%s)%s."
-                         % (str(session['session_key']), str(session['user_id']), session['username'],
-                            str(session['rating_key']), session['full_title'], '[Live TV]' if session['live'] else ''))
+        # Write the new session to our temp session table
+        self.update_db_session(notify=True)
 
-            # Send notification after updating db
-            #plexpy.NOTIFY_QUEUE.put({'stream_data': session.copy(), 'notify_action': 'on_play'})
-
-            # Write the new session to our temp session table
-            self.update_db_session(session=session, notify=True)
-
-            # Schedule a callback to force stop a stale stream 5 minutes later
-            schedule_callback('session_key-{}'.format(self.get_session_key()),
-                              func=force_stop_stream,
-                              args=[self.get_session_key(), session['full_title'], session['username']],
-                              minutes=5)
+        # Schedule a callback to force stop a stale stream 5 minutes later
+        schedule_callback('session_key-{}'.format(self.get_session_key()),
+                            func=force_stop_stream,
+                            args=[self.get_session_key(), self.session['full_title'], self.session['username']],
+                            minutes=5)
+        
+        self.check_markers()
 
     def on_stop(self, force_stop=False):
-        if self.is_valid_session():
-            logger.debug("Tautulli ActivityHandler :: Session %s %sstopped."
-                         % (str(self.get_session_key()), 'force ' if force_stop else ''))
+        logger.debug("Tautulli ActivityHandler :: Session %s %sstopped."
+                        % (str(self.get_session_key()), 'force ' if force_stop else ''))
 
-            # Set the session last_paused timestamp
-            ap = activity_processor.ActivityProcessor()
-            ap.set_session_last_paused(session_key=self.get_session_key(), timestamp=None)
+        # Set the session last_paused timestamp
+        self.ap.set_session_last_paused(session_key=self.get_session_key(), timestamp=None)
 
-            # Update the session state and viewOffset
-            # Set force_stop to true to disable the state set
-            if not force_stop:
-                self.set_session_state()
+        # Update the session state and viewOffset
+        # Set force_stop to true to disable the state set
+        if not force_stop:
+            self.set_session_state()
 
-            # Retrieve the session data from our temp table
-            db_session = ap.get_session_by_key(session_key=self.get_session_key())
+        # Write it to the history table
+        row_id = self.ap.write_session_history(session=self.db_session)
 
-            # Write it to the history table
-            monitor_proc = activity_processor.ActivityProcessor()
-            row_id = monitor_proc.write_session_history(session=db_session)
+        if row_id:
+            self.put_notification('on_stop')
 
-            if row_id:
-                plexpy.NOTIFY_QUEUE.put({'stream_data': db_session.copy(), 'notify_action': 'on_stop'})
+            schedule_callback('session_key-{}'.format(self.get_session_key()), remove_job=True)
 
-                schedule_callback('session_key-{}'.format(self.get_session_key()), remove_job=True)
-
-                # Remove the session from our temp session table
-                logger.debug("Tautulli ActivityHandler :: Removing sessionKey %s ratingKey %s from session queue"
-                             % (str(self.get_session_key()), str(self.get_rating_key())))
-                ap.delete_session(row_id=row_id)
-                delete_metadata_cache(self.get_session_key())
-            else:
-                schedule_callback('session_key-{}'.format(self.get_session_key()),
-                                  func=force_stop_stream,
-                                  args=[self.get_session_key(), db_session['full_title'], db_session['user']],
-                                  seconds=30)
+            # Remove the session from our temp session table
+            logger.debug("Tautulli ActivityHandler :: Removing sessionKey %s ratingKey %s from session queue"
+                            % (str(self.get_session_key()), str(self.get_rating_key())))
+            self.ap.delete_session(row_id=row_id)
+            delete_metadata_cache(self.get_session_key())
+        else:
+            schedule_callback('session_key-{}'.format(self.get_session_key()),
+                                func=force_stop_stream,
+                                args=[self.get_session_key(), self.db_session['full_title'], self.db_session['user']],
+                                seconds=30)
 
     def on_pause(self, still_paused=False):
-        if self.is_valid_session():
-            if not still_paused:
-                logger.debug("Tautulli ActivityHandler :: Session %s paused." % str(self.get_session_key()))
+        if not still_paused:
+            logger.debug("Tautulli ActivityHandler :: Session %s paused." % str(self.get_session_key()))
 
-            # Set the session last_paused timestamp
-            ap = activity_processor.ActivityProcessor()
-            ap.set_session_last_paused(session_key=self.get_session_key(), timestamp=helpers.timestamp())
+        # Set the session last_paused timestamp
+        self.ap.set_session_last_paused(session_key=self.get_session_key(), timestamp=helpers.timestamp())
 
-            # Update the session state and viewOffset
-            self.update_db_session()
+        self.update_db_session()
 
-            # Retrieve the session data from our temp table
-            db_session = ap.get_session_by_key(session_key=self.get_session_key())
-
-            if not still_paused:
-                plexpy.NOTIFY_QUEUE.put({'stream_data': db_session.copy(), 'notify_action': 'on_pause'})
+        if not still_paused:
+            self.put_notification('on_pause')
 
     def on_resume(self):
-        if self.is_valid_session():
-            logger.debug("Tautulli ActivityHandler :: Session %s resumed." % str(self.get_session_key()))
+        logger.debug("Tautulli ActivityHandler :: Session %s resumed." % str(self.get_session_key()))
 
-            # Set the session last_paused timestamp
-            ap = activity_processor.ActivityProcessor()
-            ap.set_session_last_paused(session_key=self.get_session_key(), timestamp=None)
+        # Set the session last_paused timestamp
+        self.ap.set_session_last_paused(session_key=self.get_session_key(), timestamp=None)
 
-            # Update the session state and viewOffset
-            self.update_db_session()
+        self.update_db_session()
 
-            # Retrieve the session data from our temp table
-            db_session = ap.get_session_by_key(session_key=self.get_session_key())
-
-            plexpy.NOTIFY_QUEUE.put({'stream_data': db_session.copy(), 'notify_action': 'on_resume'})
-
-    def on_change(self):
-        if self.is_valid_session():
-            logger.debug("Tautulli ActivityHandler :: Session %s has changed transcode decision." % str(self.get_session_key()))
-
-            # Update the session state and viewOffset
-            self.update_db_session()
-
-            # Retrieve the session data from our temp table
-            ap = activity_processor.ActivityProcessor()
-            db_session = ap.get_session_by_key(session_key=self.get_session_key())
-
-            plexpy.NOTIFY_QUEUE.put({'stream_data': db_session.copy(), 'notify_action': 'on_change'})
+        self.put_notification('on_resume')
 
     def on_buffer(self):
-        if self.is_valid_session():
-            logger.debug("Tautulli ActivityHandler :: Session %s is buffering." % self.get_session_key())
-            ap = activity_processor.ActivityProcessor()
-            db_stream = ap.get_session_by_key(session_key=self.get_session_key())
+        logger.debug("Tautulli ActivityHandler :: Session %s is buffering." % self.get_session_key())
 
-            # Increment our buffer count
-            ap.increment_session_buffer_count(session_key=self.get_session_key())
+        # Increment our buffer count
+        self.ap.increment_session_buffer_count(session_key=self.get_session_key())
 
-            # Get our current buffer count
-            current_buffer_count = ap.get_session_buffer_count(self.get_session_key())
-            logger.debug("Tautulli ActivityHandler :: Session %s buffer count is %s." %
-                         (self.get_session_key(), current_buffer_count))
+        # Get our current buffer count
+        current_buffer_count = self.ap.get_session_buffer_count(self.get_session_key())
+        logger.debug("Tautulli ActivityHandler :: Session %s buffer count is %s." %
+                        (self.get_session_key(), current_buffer_count))
 
-            # Get our last triggered time
-            buffer_last_triggered = ap.get_session_buffer_trigger_time(self.get_session_key())
+        # Get our last triggered time
+        buffer_last_triggered = self.ap.get_session_buffer_trigger_time(self.get_session_key())
 
-            # Update the session state and viewOffset
-            self.update_db_session()
+        self.update_db_session()
 
-            time_since_last_trigger = 0
-            if buffer_last_triggered:
-                logger.debug("Tautulli ActivityHandler :: Session %s buffer last triggered at %s." %
-                             (self.get_session_key(), buffer_last_triggered))
-                time_since_last_trigger = helpers.timestamp() - int(buffer_last_triggered)
+        time_since_last_trigger = 0
+        if buffer_last_triggered:
+            logger.debug("Tautulli ActivityHandler :: Session %s buffer last triggered at %s." %
+                            (self.get_session_key(), buffer_last_triggered))
+            time_since_last_trigger = helpers.timestamp() - int(buffer_last_triggered)
 
-            if current_buffer_count >= plexpy.CONFIG.BUFFER_THRESHOLD and time_since_last_trigger == 0 or \
-                    time_since_last_trigger >= plexpy.CONFIG.BUFFER_WAIT:
-                ap.set_session_buffer_trigger_time(session_key=self.get_session_key())
+        if current_buffer_count >= plexpy.CONFIG.BUFFER_THRESHOLD and time_since_last_trigger == 0 or \
+                time_since_last_trigger >= plexpy.CONFIG.BUFFER_WAIT:
+            self.ap.set_session_buffer_trigger_time(session_key=self.get_session_key())
 
-                # Retrieve the session data from our temp table
-                db_session = ap.get_session_by_key(session_key=self.get_session_key())
-
-                plexpy.NOTIFY_QUEUE.put({'stream_data': db_session.copy(), 'notify_action': 'on_buffer'})
+            self.put_notification('on_buffer')
 
     def on_error(self):
-        if self.is_valid_session():
-            logger.debug("Tautulli ActivityHandler :: Session %s encountered an error." % str(self.get_session_key()))
+        logger.debug("Tautulli ActivityHandler :: Session %s encountered an error." % str(self.get_session_key()))
 
-            # Update the session state and viewOffset
-            self.update_db_session()
+        self.update_db_session()
 
-            # Retrieve the session data from our temp table
-            ap = activity_processor.ActivityProcessor()
-            db_session = ap.get_session_by_key(session_key=self.get_session_key())
+        self.put_notification('on_error')
 
-            plexpy.NOTIFY_QUEUE.put({'stream_data': db_session.copy(), 'notify_action': 'on_error'})
+    def on_change(self):
+        logger.debug("Tautulli ActivityHandler :: Session %s has changed transcode decision." % str(self.get_session_key()))
+
+        self.update_db_session()
+
+        self.put_notification('on_change')
+
+    def on_intro(self):
+        if self.get_live_session():
+            logger.debug("Tautulli ActivityHandler :: Session %s intro marker reached." % str(self.get_session_key()))
+
+            self.put_notification('on_intro')
+
+    def on_credits(self):
+        if self.get_live_session():
+            logger.debug("Tautulli ActivityHandler :: Session %s credits marker reached." % str(self.get_session_key()))
+            self.put_notification('on_credits')
+
+    def on_watched(self):
+        logger.debug("Tautulli ActivityHandler :: Session %s watched." % str(self.get_session_key()))
+
+        watched_notifiers = notification_handler.get_notify_state_enabled(
+            session=self.db_session, notify_action='on_watched', notified=False)
+
+        for d in watched_notifiers:
+            self.put_notification('on_watched', notifier_id=d['notifier_id'])
 
     # This function receives events from our websocket connection
     def process(self):
         if self.is_valid_session():
-            ap = activity_processor.ActivityProcessor()
-            db_session = ap.get_session_by_key(session_key=self.get_session_key())
+            self.get_db_session()
 
             this_state = self.timeline['state']
             this_rating_key = str(self.timeline['ratingKey'])
@@ -294,27 +284,27 @@ class ActivityHandler(object):
             this_live_uuid = this_key.split('/')[-1] if this_key.startswith('/livetv/sessions') else None
 
             # If we already have this session in the temp table, check for state changes
-            if db_session:
+            if self.db_session:
                 # Re-schedule the callback to reset the 5 minutes timer
                 schedule_callback('session_key-{}'.format(self.get_session_key()),
                                   func=force_stop_stream,
-                                  args=[self.get_session_key(), db_session['full_title'], db_session['user']],
+                                  args=[self.get_session_key(), self.db_session['full_title'], self.db_session['user']],
                                   minutes=5)
 
-                last_state = db_session['state']
-                last_rating_key = str(db_session['rating_key'])
-                last_live_uuid = db_session['live_uuid']
-                last_transcode_key = db_session['transcode_key'].split('/')[-1]
-                last_paused = db_session['last_paused']
-                last_rating_key_websocket = db_session['rating_key_websocket']
-                last_guid = db_session['guid']
+                last_state = self.db_session['state']
+                last_rating_key = str(self.db_session['rating_key'])
+                last_live_uuid = self.db_session['live_uuid']
+                last_transcode_key = self.db_session['transcode_key'].split('/')[-1]
+                last_paused = self.db_session['last_paused']
+                last_rating_key_websocket = self.db_session['rating_key_websocket']
+                last_guid = self.db_session['guid']
 
                 this_guid = last_guid
                 # Check guid for live TV metadata every 60 seconds
-                if db_session['live'] and helpers.timestamp() - db_session['stopped'] > 60:
-                    metadata = self.get_metadata(skip_cache=True)
-                    if metadata:
-                        this_guid = metadata['guid']
+                if self.db_session['live'] and helpers.timestamp() - self.db_session['stopped'] > 60:
+                    self.get_metadata(skip_cache=True)
+                    if self.metadata:
+                        this_guid = self.metadata['guid']
 
                 # Make sure the same item is being played
                 if (this_rating_key == last_rating_key
@@ -325,7 +315,7 @@ class ActivityHandler(object):
                     if this_state == 'playing':
                         # Update the session in our temp session table
                         # if the last set temporary stopped time exceeds 60 seconds
-                        if helpers.timestamp() - db_session['stopped'] > 60:
+                        if helpers.timestamp() - self.db_session['stopped'] > 60:
                             self.update_db_session()
 
                     # Start our state checks
@@ -356,33 +346,65 @@ class ActivityHandler(object):
                     self.on_stop(force_stop=True)
                     self.on_start()
 
-                # Monitor if the stream has reached the watch percentage for notifications
-                # The only purpose of this is for notifications
-                if not db_session['watched'] and this_state != 'buffering':
-                    progress_percent = helpers.get_percent(self.timeline['viewOffset'], db_session['duration'])
-                    watched_percent = {'movie': plexpy.CONFIG.MOVIE_WATCHED_PERCENT,
-                                       'episode': plexpy.CONFIG.TV_WATCHED_PERCENT,
-                                       'track': plexpy.CONFIG.MUSIC_WATCHED_PERCENT,
-                                       'clip': plexpy.CONFIG.TV_WATCHED_PERCENT
-                                       }
-
-                    if progress_percent >= watched_percent.get(db_session['media_type'], 101):
-                        logger.debug("Tautulli ActivityHandler :: Session %s watched."
-                                     % str(self.get_session_key()))
-                        ap.set_watched(session_key=self.get_session_key())
-
-                        watched_notifiers = notification_handler.get_notify_state_enabled(
-                            session=db_session, notify_action='on_watched', notified=False)
-
-                        for d in watched_notifiers:
-                            plexpy.NOTIFY_QUEUE.put({'stream_data': db_session.copy(),
-                                                     'notifier_id': d['notifier_id'],
-                                                     'notify_action': 'on_watched'})
+                # Check for stream offset notifications
+                self.check_markers()
+                self.check_watched()
 
             else:
                 # We don't have this session in our table yet, start a new one.
                 if this_state != 'buffering':
                     self.on_start()
+    
+    def check_markers(self):
+        # Monitor if the stream has reached the intro or credit marker offsets
+        self.get_metadata()
+
+        intro_markers, credits_markers = [], []
+        for marker in self.metadata['markers']:
+            if marker['type'] == 'intro':
+                intro_markers.append(marker)
+            elif marker['type'] == 'credits':
+                credits_markers.append(marker)
+
+        self._check_marker('intro', intro_markers)
+        self._check_marker('credits', credits_markers)
+
+    def _check_marker(self, marker_type, markers):
+        if self.db_session[marker_type] < len(markers):
+            marker = markers[self.db_session[marker_type]]
+
+            # Websocket events only fire every 10 seconds
+            # Check if the marker is within 10 seconds of the current viewOffset
+            if marker['start_time_offset'] - 10000 <= self.timeline['viewOffset'] <= marker['end_time_offset']:
+                set_func = getattr(self.ap, 'set_{}'.format(marker_type))
+                callback_func = getattr(self, 'on_{}'.format(marker_type))
+
+                set_func(session_key=self.get_session_key())
+
+                if self.timeline['viewOffset'] < marker['start_time_offset']:
+                    # Schedule a callback for the exact offset of the marker
+                    schedule_callback(
+                        'session_key-{}-{}-{}'.format(self.get_session_key(), marker_type, self.db_session[marker_type]),
+                        func=callback_func,
+                        milliseconds=marker['start_time_offset'] - self.timeline['viewOffset']
+                    )
+                else:
+                    callback_func()
+
+    def check_watched(self):
+        # Monitor if the stream has reached the watch percentage for notifications
+        if not self.db_session['watched'] and self.timeline['state'] != 'buffering':
+            progress_percent = helpers.get_percent(self.timeline['viewOffset'], self.db_session['duration'])
+            watched_percent = {
+                'movie': plexpy.CONFIG.MOVIE_WATCHED_PERCENT,
+                'episode': plexpy.CONFIG.TV_WATCHED_PERCENT,
+                'track': plexpy.CONFIG.MUSIC_WATCHED_PERCENT,
+                'clip': plexpy.CONFIG.TV_WATCHED_PERCENT
+            }
+
+            if progress_percent >= watched_percent.get(self.db_session['media_type'], 101):
+                self.ap.set_watched(session_key=self.get_session_key())
+                self.on_watched()
 
 
 class TimelineHandler(object):
diff --git a/plexpy/activity_processor.py b/plexpy/activity_processor.py
index 4608e4c8..e110ea64 100644
--- a/plexpy/activity_processor.py
+++ b/plexpy/activity_processor.py
@@ -660,8 +660,18 @@ class ActivityProcessor(object):
             self.db.action('UPDATE sessions SET write_attempts = ? WHERE session_key = ?',
                            [session['write_attempts'] + 1, session_key])
 
+    def set_intro(self, session_key=None):
+        self.db.action('UPDATE sessions SET intro = intro + 1 '
+                       'WHERE session_key = ?',
+                       [session_key])
+
+    def set_credits(self, session_key=None):
+        self.db.action('UPDATE sessions SET credits = credits + 1 '
+                       'WHERE session_key = ?',
+                       [session_key])
+
     def set_watched(self, session_key=None):
-        self.db.action('UPDATE sessions SET watched = ?'
+        self.db.action('UPDATE sessions SET watched = ? '
                        'WHERE session_key = ?',
                        [1, session_key])
 

From 71bc0631559e6630610afd570afc2ec7551c12bc Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 16 Feb 2023 11:31:35 -0800
Subject: [PATCH 308/743] Add notification triggers for intro/credit markers

---
 plexpy/__init__.py             | 29 ++++++++++++++++++++++++++++-
 plexpy/common.py               |  8 ++++++++
 plexpy/notification_handler.py | 24 ++++++++++++++++++++++++
 plexpy/notifiers.py            | 16 ++++++++++++++++
 4 files changed, 76 insertions(+), 1 deletion(-)

diff --git a/plexpy/__init__.py b/plexpy/__init__.py
index 003259bc..873b46f0 100644
--- a/plexpy/__init__.py
+++ b/plexpy/__init__.py
@@ -754,19 +754,22 @@ def dbcheck():
         'agent_id INTEGER, agent_name TEXT, agent_label TEXT, friendly_name TEXT, notifier_config TEXT, '
         'on_play INTEGER DEFAULT 0, on_stop INTEGER DEFAULT 0, on_pause INTEGER DEFAULT 0, '
         'on_resume INTEGER DEFAULT 0, on_change INTEGER DEFAULT 0, on_buffer INTEGER DEFAULT 0, '
-        'on_error INTEGER DEFAULT 0, on_watched INTEGER DEFAULT 0, on_created INTEGER DEFAULT 0, '
+        'on_error INTEGER DEFAULT 0, on_intro INTEGER DEFAULT 0, on_credits INTEGER DEFAULT 0, '
+        'on_watched INTEGER DEFAULT 0, on_created INTEGER DEFAULT 0, '
         'on_extdown INTEGER DEFAULT 0, on_intdown INTEGER DEFAULT 0, '
         'on_extup INTEGER DEFAULT 0, on_intup INTEGER DEFAULT 0, on_pmsupdate INTEGER DEFAULT 0, '
         'on_concurrent INTEGER DEFAULT 0, on_newdevice INTEGER DEFAULT 0, on_plexpyupdate INTEGER DEFAULT 0, '
         'on_plexpydbcorrupt INTEGER DEFAULT 0, '
         'on_play_subject TEXT, on_stop_subject TEXT, on_pause_subject TEXT, '
         'on_resume_subject TEXT, on_change_subject TEXT, on_buffer_subject TEXT, on_error_subject TEXT, '
+        'on_intro_subject TEXT, on_credits_subject TEXT, '
         'on_watched_subject TEXT, on_created_subject TEXT, on_extdown_subject TEXT, on_intdown_subject TEXT, '
         'on_extup_subject TEXT, on_intup_subject TEXT, on_pmsupdate_subject TEXT, '
         'on_concurrent_subject TEXT, on_newdevice_subject TEXT, on_plexpyupdate_subject TEXT, '
         'on_plexpydbcorrupt_subject TEXT, '
         'on_play_body TEXT, on_stop_body TEXT, on_pause_body TEXT, '
         'on_resume_body TEXT, on_change_body TEXT, on_buffer_body TEXT, on_error_body TEXT, '
+        'on_intro_body TEXT, on_credits_body TEXT, '
         'on_watched_body TEXT, on_created_body TEXT, on_extdown_body TEXT, on_intdown_body TEXT, '
         'on_extup_body TEXT, on_intup_body TEXT, on_pmsupdate_body TEXT, '
         'on_concurrent_body TEXT, on_newdevice_body TEXT, on_plexpyupdate_body TEXT, '
@@ -2384,6 +2387,30 @@ def dbcheck():
             'ALTER TABLE notifiers ADD COLUMN on_error_body TEXT'
         )
 
+    # Upgrade notifiers table from earlier versions
+    try:
+        c_db.execute('SELECT on_intro FROM notifiers')
+    except sqlite3.OperationalError:
+        logger.debug("Altering database. Updating database table notifiers.")
+        c_db.execute(
+            'ALTER TABLE notifiers ADD COLUMN on_intro INTEGER DEFAULT 0'
+        )
+        c_db.execute(
+            'ALTER TABLE notifiers ADD COLUMN on_intro_subject TEXT'
+        )
+        c_db.execute(
+            'ALTER TABLE notifiers ADD COLUMN on_intro_body TEXT'
+        )
+        c_db.execute(
+            'ALTER TABLE notifiers ADD COLUMN on_credits INTEGER DEFAULT 0'
+        )
+        c_db.execute(
+            'ALTER TABLE notifiers ADD COLUMN on_credits_subject TEXT'
+        )
+        c_db.execute(
+            'ALTER TABLE notifiers ADD COLUMN on_credits_body TEXT'
+        )
+
     # Upgrade tvmaze_lookup table from earlier versions
     try:
         c_db.execute('SELECT rating_key FROM tvmaze_lookup')
diff --git a/plexpy/common.py b/plexpy/common.py
index ad91ee87..65de4810 100644
--- a/plexpy/common.py
+++ b/plexpy/common.py
@@ -416,6 +416,7 @@ NOTIFICATION_PARAMETERS = [
              {'name': 'Progress Duration (sec)', 'type': 'int', 'value': 'progress_duration_sec', 'description': 'The last reported offset (in seconds) of the stream.'},
              {'name': 'Progress Time', 'type': 'str', 'value': 'progress_time', 'description': 'The last reported offset (in time format) of the stream.'},
              {'name': 'Progress Percent', 'type': 'int', 'value': 'progress_percent', 'description': 'The last reported progress percent of the stream.'},
+             {'name': 'View Offset (ms)', 'type': 'int', 'value': 'view_offset', 'description': 'The current view offset (in milliseconds) for the stream.'},
              {'name': 'Transcode Decision', 'type': 'str', 'value': 'transcode_decision', 'description': 'The transcode decision of the stream.'},
              {'name': 'Container Decision', 'type': 'str', 'value': 'container_decision', 'description': 'The container transcode decision of the stream.'},
              {'name': 'Video Decision', 'type': 'str', 'value': 'video_decision', 'description': 'The video transcode decision of the stream.'},
@@ -426,6 +427,12 @@ NOTIFICATION_PARAMETERS = [
              {'name': 'Optimized Version Profile', 'type': 'str', 'value': 'optimized_version_profile', 'description': 'The optimized version profile of the stream.'},
              {'name': 'Synced Version', 'type': 'int', 'value': 'synced_version', 'description': 'If the stream is an synced version.', 'example': '0 or 1'},
              {'name': 'Live', 'type': 'int', 'value': 'live', 'description': 'If the stream is live TV.', 'example': '0 or 1'},
+             {'name': 'Intro Marker Start Time', 'type': 'int', 'value': 'intro_marker_start', 'description': 'The intro marker start time offset in milliseconds.'},
+             {'name': 'Intro Marker End Time', 'type': 'int', 'value': 'intro_marker_end', 'description': 'The intro marker end time offset in milliseconds.'},
+             {'name': 'Credits Marker First', 'type': 'int', 'value': 'credits_marker_first', 'description': 'If the credits marker is the first marker.', 'example': '0 or 1'},
+             {'name': 'Credits Marker Final', 'type': 'int', 'value': 'credits_marker_final', 'description': 'If the credits marker is the final marker.', 'example': '0 or 1'},
+             {'name': 'Credits Marker Start Time', 'type': 'int', 'value': 'credits_marker_start', 'description': 'The credits marker start time offset in milliseconds.'},
+             {'name': 'Credits Marker End Time', 'type': 'int', 'value': 'credits_marker_end', 'description': 'The credits marker end time offset in milliseconds.'},
              {'name': 'Channel Call Sign', 'type': 'str', 'value': 'channel_call_sign', 'description': 'The Live TV channel call sign.'},
              {'name': 'Channel Identifier', 'type': 'str', 'value': 'channel_identifier', 'description': 'The Live TV channel number.'},
              {'name': 'Channel Thumb', 'type': 'str', 'value': 'channel_thumb', 'description': 'The URL for the Live TV channel logo.'},
@@ -540,6 +547,7 @@ NOTIFICATION_PARAMETERS = [
              {'name': 'User Rating', 'type': 'float', 'value': 'user_rating', 'description': 'The user (star) rating (out of 10) for the item.'},
              {'name': 'Duration', 'type': 'int', 'value': 'duration', 'description': 'The duration (in minutes) for the item.'},
              {'name': 'Duration (sec)', 'type': 'int', 'value': 'duration_sec', 'description': 'The duration (in seconds) for the item.'},
+             {'name': 'Duration (ms)', 'type': 'int', 'value': 'duration_ms', 'description': 'The duration (in milliseconds) for the item.'},
              {'name': 'Poster URL', 'type': 'str', 'value': 'poster_url', 'description': 'A URL for the movie, TV show, or album poster.'},
              {'name': 'Plex ID', 'type': 'str', 'value': 'plex_id', 'description': 'The Plex ID for the item.', 'example': 'e.g. 5d7769a9594b2b001e6a6b7e'},
              {'name': 'Plex URL', 'type': 'str', 'value': 'plex_url', 'description': 'The Plex URL to your server for the item.'},
diff --git a/plexpy/notification_handler.py b/plexpy/notification_handler.py
index 6b55c5b7..b9940b70 100644
--- a/plexpy/notification_handler.py
+++ b/plexpy/notification_handler.py
@@ -583,6 +583,8 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
     notify_params.update(media_info)
     notify_params.update(media_part_info)
 
+    metadata = pmsconnect.PmsConnect().get_metadata_details(rating_key=rating_key)
+
     child_metadata = grandchild_metadata = []
     for key in kwargs.pop('child_keys', []):
         child = pmsconnect.PmsConnect().get_metadata_details(rating_key=key)
@@ -938,6 +940,20 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
             and audience_rating:
         audience_rating = helpers.get_percent(notify_params['audience_rating'], 10)
 
+    intro_markers, credits_markers = [], []
+    for marker in metadata['markers']:
+        if marker['type'] == 'intro':
+            intro_markers.append(marker)
+        elif marker['type'] == 'credits':
+            credits_markers.append(marker)
+
+    intro_marker = defaultdict(int)
+    credits_marker = defaultdict(int)
+    if notify_action == 'on_intro' and intro_markers and notify_params['intro'] < len(intro_markers):
+        intro_marker = intro_markers[notify_params['intro']]
+    if notify_action == 'on_credits' and credits_markers and notify_params['credits'] < len(credits_markers):
+        credits_marker = credits_markers[notify_params['credits']]
+
     now = arrow.now()
     now_iso = now.isocalendar()
 
@@ -1005,6 +1021,7 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
         'progress_duration_sec': view_offset_sec,
         'progress_time': arrow.get(view_offset_sec).format(duration_format),
         'progress_percent': helpers.get_percent(view_offset_sec, duration_sec),
+        'view_offset': session.get('view_offset', 0),
         'initial_stream': notify_params['initial_stream'],
         'transcode_decision': transcode_decision,
         'container_decision': notify_params['container_decision'],
@@ -1016,6 +1033,12 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
         'optimized_version_profile': notify_params['optimized_version_profile'],
         'synced_version': notify_params['synced_version'],
         'live': notify_params['live'],
+        'intro_marker_start': intro_marker['start_time_offset'],
+        'intro_marker_end': intro_marker['end_time_offset'],
+        'credits_marker_first': int(bool(credits_marker and notify_params['credits'] == 0)),
+        'credits_marker_final': int(credits_marker['final']),
+        'credits_marker_start': credits_marker['start_time_offset'],
+        'credits_marker_end': credits_marker['end_time_offset'],
         'channel_call_sign': notify_params['channel_call_sign'],
         'channel_identifier': notify_params['channel_identifier'],
         'channel_thumb': notify_params['channel_thumb'],
@@ -1132,6 +1155,7 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
         'user_rating': notify_params['user_rating'],
         'duration': duration,
         'duration_sec': duration_sec,
+        'duration_ms': notify_params['duration'],
         'poster_title': notify_params['poster_title'],
         'poster_url': notify_params['poster_url'],
         'plex_id': notify_params['plex_id'],
diff --git a/plexpy/notifiers.py b/plexpy/notifiers.py
index e3ef6862..383f4908 100644
--- a/plexpy/notifiers.py
+++ b/plexpy/notifiers.py
@@ -340,6 +340,22 @@ def available_notification_actions(agent_id=None):
                 'icon': 'fa-exchange-alt',
                 'media_types': ('movie', 'episode', 'track')
                 },
+               {'label': 'Intro Marker',
+                'name': 'on_intro',
+                'description': 'Trigger a notification when a video stream reaches any intro marker.',
+                'subject': 'Tautulli ({server_name})',
+                'body': '{user} ({player}) has reached an intro marker for {title}.',
+                'icon': 'fa-bookmark',
+                'media_types': ('episode',)
+                },
+               {'label': 'Credits Marker',
+                'name': 'on_credits',
+                'description': 'Trigger a notification when a video stream reaches any credits marker.',
+                'subject': 'Tautulli ({server_name})',
+                'body': '{user} ({player}) has reached a credits marker for {title}.',
+                'icon': 'fa-bookmark',
+                'media_types': ('movie', 'episode')
+                },
                {'label': 'Watched',
                 'name': 'on_watched',
                 'description': 'Trigger a notification when a video stream reaches the specified watch percentage.',

From 97af214ac1bcff2de971a3c2bdeb9ff1b4a4edb1 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 16 Feb 2023 16:19:29 -0800
Subject: [PATCH 309/743] Handle seeking through intro/credits markers

---
 plexpy/__init__.py           | 11 +++++++-
 plexpy/activity_handler.py   | 54 +++++++++++++++++-------------------
 plexpy/activity_processor.py | 17 ++++++------
 3 files changed, 44 insertions(+), 38 deletions(-)

diff --git a/plexpy/__init__.py b/plexpy/__init__.py
index 873b46f0..09c16586 100644
--- a/plexpy/__init__.py
+++ b/plexpy/__init__.py
@@ -657,7 +657,7 @@ def dbcheck():
         'live INTEGER, live_uuid TEXT, channel_call_sign TEXT, channel_identifier TEXT, channel_thumb TEXT, '
         'secure INTEGER, relayed INTEGER, '
         'buffer_count INTEGER DEFAULT 0, buffer_last_triggered INTEGER, last_paused INTEGER, '
-        'watched INTEGER DEFAULT 0, intro INTEGER DEFAULT 0, credits INTEGER DEFAULT 0, '
+        'watched INTEGER DEFAULT 0, intro INTEGER DEFAULT 0, credits INTEGER DEFAULT 0, marker INTEGER DEFAULT 0, '
         'initial_stream INTEGER DEFAULT 1, write_attempts INTEGER DEFAULT 0, raw_stream_info TEXT, '
         'rating_key_websocket TEXT)'
     )
@@ -1417,6 +1417,15 @@ def dbcheck():
             'ALTER TABLE sessions ADD COLUMN credits INTEGER DEFAULT 0'
         )
 
+    # Upgrade sessions table from earlier versions
+    try:
+        c_db.execute('SELECT marker FROM sessions')
+    except sqlite3.OperationalError:
+        logger.debug(u"Altering database. Updating database table sessions.")
+        c_db.execute(
+            'ALTER TABLE sessions ADD COLUMN marker INTEGER DEFAULT 0'
+        )
+
     # Upgrade session_history table from earlier versions
     try:
         c_db.execute('SELECT reference_id FROM session_history')
diff --git a/plexpy/activity_handler.py b/plexpy/activity_handler.py
index a89ccb98..3b5a283f 100644
--- a/plexpy/activity_handler.py
+++ b/plexpy/activity_handler.py
@@ -250,16 +250,16 @@ class ActivityHandler(object):
 
         self.put_notification('on_change')
 
-    def on_intro(self):
+    def on_intro(self, marker):
         if self.get_live_session():
             logger.debug("Tautulli ActivityHandler :: Session %s intro marker reached." % str(self.get_session_key()))
 
-            self.put_notification('on_intro')
+            self.put_notification('on_intro', marker=marker)
 
-    def on_credits(self):
+    def on_credits(self, marker):
         if self.get_live_session():
             logger.debug("Tautulli ActivityHandler :: Session %s credits marker reached." % str(self.get_session_key()))
-            self.put_notification('on_credits')
+            self.put_notification('on_credits', marker=marker)
 
     def on_watched(self):
         logger.debug("Tautulli ActivityHandler :: Session %s watched." % str(self.get_session_key()))
@@ -359,37 +359,33 @@ class ActivityHandler(object):
         # Monitor if the stream has reached the intro or credit marker offsets
         self.get_metadata()
 
-        intro_markers, credits_markers = [], []
-        for marker in self.metadata['markers']:
-            if marker['type'] == 'intro':
-                intro_markers.append(marker)
-            elif marker['type'] == 'credits':
-                credits_markers.append(marker)
-
-        self._check_marker('intro', intro_markers)
-        self._check_marker('credits', credits_markers)
-
-    def _check_marker(self, marker_type, markers):
-        if self.db_session[marker_type] < len(markers):
-            marker = markers[self.db_session[marker_type]]
+        marker_flag = False
 
+        for marker_idx, marker in enumerate(self.metadata['markers'], start=1):
             # Websocket events only fire every 10 seconds
             # Check if the marker is within 10 seconds of the current viewOffset
             if marker['start_time_offset'] - 10000 <= self.timeline['viewOffset'] <= marker['end_time_offset']:
-                set_func = getattr(self.ap, 'set_{}'.format(marker_type))
-                callback_func = getattr(self, 'on_{}'.format(marker_type))
+                marker_flag = True
 
-                set_func(session_key=self.get_session_key())
+                if self.db_session['marker'] != marker_idx:
+                    self.ap.set_marker(session_key=self.get_session_key(), marker_idx=marker_idx, marker_type=marker['type'])
+                    callback_func = getattr(self, 'on_{}'.format(marker['type']))
 
-                if self.timeline['viewOffset'] < marker['start_time_offset']:
-                    # Schedule a callback for the exact offset of the marker
-                    schedule_callback(
-                        'session_key-{}-{}-{}'.format(self.get_session_key(), marker_type, self.db_session[marker_type]),
-                        func=callback_func,
-                        milliseconds=marker['start_time_offset'] - self.timeline['viewOffset']
-                    )
-                else:
-                    callback_func()
+                    if self.timeline['viewOffset'] < marker['start_time_offset']:
+                        # Schedule a callback for the exact offset of the marker
+                        schedule_callback(
+                            'session_key-{}-marker-{}'.format(self.get_session_key(), marker_idx),
+                            func=callback_func,
+                            args=[marker],
+                            milliseconds=marker['start_time_offset'] - self.timeline['viewOffset']
+                        )
+                    else:
+                        callback_func(marker)
+
+                break
+
+        if not marker_flag:
+            self.ap.set_marker(session_key=self.get_session_key(), marker_idx=0)
 
     def check_watched(self):
         # Monitor if the stream has reached the watch percentage for notifications
diff --git a/plexpy/activity_processor.py b/plexpy/activity_processor.py
index e110ea64..c821d23d 100644
--- a/plexpy/activity_processor.py
+++ b/plexpy/activity_processor.py
@@ -660,15 +660,16 @@ class ActivityProcessor(object):
             self.db.action('UPDATE sessions SET write_attempts = ? WHERE session_key = ?',
                            [session['write_attempts'] + 1, session_key])
 
-    def set_intro(self, session_key=None):
-        self.db.action('UPDATE sessions SET intro = intro + 1 '
+    def set_marker(self, session_key=None, marker_idx=None, marker_type=None):
+        if marker_type == 'intro':
+            args = [1, 0]
+        elif marker_type == 'credits':
+            args = [0, 1]
+        else:
+            args = [0, 0]
+        self.db.action('UPDATE sessions SET intro = ?, credits = ?, marker = ? '
                        'WHERE session_key = ?',
-                       [session_key])
-
-    def set_credits(self, session_key=None):
-        self.db.action('UPDATE sessions SET credits = credits + 1 '
-                       'WHERE session_key = ?',
-                       [session_key])
+                       args + [marker_idx, session_key])
 
     def set_watched(self, session_key=None):
         self.db.action('UPDATE sessions SET watched = ? '

From 9be3bbbf0f85eb33a7b6d09d17af52355cbcdadb Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 16 Feb 2023 16:20:25 -0800
Subject: [PATCH 310/743] Update marker notification parameters

---
 plexpy/common.py               | 10 ++++------
 plexpy/notification_handler.py | 24 +++++-------------------
 plexpy/pmsconnect.py           | 10 +++++++++-
 3 files changed, 18 insertions(+), 26 deletions(-)

diff --git a/plexpy/common.py b/plexpy/common.py
index 65de4810..cf1180dc 100644
--- a/plexpy/common.py
+++ b/plexpy/common.py
@@ -427,12 +427,10 @@ NOTIFICATION_PARAMETERS = [
              {'name': 'Optimized Version Profile', 'type': 'str', 'value': 'optimized_version_profile', 'description': 'The optimized version profile of the stream.'},
              {'name': 'Synced Version', 'type': 'int', 'value': 'synced_version', 'description': 'If the stream is an synced version.', 'example': '0 or 1'},
              {'name': 'Live', 'type': 'int', 'value': 'live', 'description': 'If the stream is live TV.', 'example': '0 or 1'},
-             {'name': 'Intro Marker Start Time', 'type': 'int', 'value': 'intro_marker_start', 'description': 'The intro marker start time offset in milliseconds.'},
-             {'name': 'Intro Marker End Time', 'type': 'int', 'value': 'intro_marker_end', 'description': 'The intro marker end time offset in milliseconds.'},
-             {'name': 'Credits Marker First', 'type': 'int', 'value': 'credits_marker_first', 'description': 'If the credits marker is the first marker.', 'example': '0 or 1'},
-             {'name': 'Credits Marker Final', 'type': 'int', 'value': 'credits_marker_final', 'description': 'If the credits marker is the final marker.', 'example': '0 or 1'},
-             {'name': 'Credits Marker Start Time', 'type': 'int', 'value': 'credits_marker_start', 'description': 'The credits marker start time offset in milliseconds.'},
-             {'name': 'Credits Marker End Time', 'type': 'int', 'value': 'credits_marker_end', 'description': 'The credits marker end time offset in milliseconds.'},
+             {'name': 'Marker Start Time', 'type': 'int', 'value': 'marker_start', 'description': 'The intro or credits marker start time offset in milliseconds.'},
+             {'name': 'Marker End Time', 'type': 'int', 'value': 'marker_end', 'description': 'The intro or credits marker end time offset in milliseconds.'},
+             {'name': 'Credits Marker First', 'type': 'int', 'value': 'credits_marker_first', 'description': 'If the marker is the first credits marker.', 'example': '0 or 1'},
+             {'name': 'Credits Marker Final', 'type': 'int', 'value': 'credits_marker_final', 'description': 'If the marker is the final credits marker.', 'example': '0 or 1'},
              {'name': 'Channel Call Sign', 'type': 'str', 'value': 'channel_call_sign', 'description': 'The Live TV channel call sign.'},
              {'name': 'Channel Identifier', 'type': 'str', 'value': 'channel_identifier', 'description': 'The Live TV channel number.'},
              {'name': 'Channel Thumb', 'type': 'str', 'value': 'channel_thumb', 'description': 'The URL for the Live TV channel logo.'},
diff --git a/plexpy/notification_handler.py b/plexpy/notification_handler.py
index b9940b70..c92415e5 100644
--- a/plexpy/notification_handler.py
+++ b/plexpy/notification_handler.py
@@ -940,19 +940,7 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
             and audience_rating:
         audience_rating = helpers.get_percent(notify_params['audience_rating'], 10)
 
-    intro_markers, credits_markers = [], []
-    for marker in metadata['markers']:
-        if marker['type'] == 'intro':
-            intro_markers.append(marker)
-        elif marker['type'] == 'credits':
-            credits_markers.append(marker)
-
-    intro_marker = defaultdict(int)
-    credits_marker = defaultdict(int)
-    if notify_action == 'on_intro' and intro_markers and notify_params['intro'] < len(intro_markers):
-        intro_marker = intro_markers[notify_params['intro']]
-    if notify_action == 'on_credits' and credits_markers and notify_params['credits'] < len(credits_markers):
-        credits_marker = credits_markers[notify_params['credits']]
+    marker = kwargs.pop('marker', defaultdict(int))
 
     now = arrow.now()
     now_iso = now.isocalendar()
@@ -1033,12 +1021,10 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
         'optimized_version_profile': notify_params['optimized_version_profile'],
         'synced_version': notify_params['synced_version'],
         'live': notify_params['live'],
-        'intro_marker_start': intro_marker['start_time_offset'],
-        'intro_marker_end': intro_marker['end_time_offset'],
-        'credits_marker_first': int(bool(credits_marker and notify_params['credits'] == 0)),
-        'credits_marker_final': int(credits_marker['final']),
-        'credits_marker_start': credits_marker['start_time_offset'],
-        'credits_marker_end': credits_marker['end_time_offset'],
+        'marker_start': marker['start_time_offset'],
+        'marker_end': marker['end_time_offset'],
+        'credits_marker_first': int(marker['first']),
+        'credits_marker_final': int(marker['final']),
         'channel_call_sign': notify_params['channel_call_sign'],
         'channel_identifier': notify_params['channel_identifier'],
         'channel_thumb': notify_params['channel_thumb'],
diff --git a/plexpy/pmsconnect.py b/plexpy/pmsconnect.py
index 3a7a2450..cc433027 100644
--- a/plexpy/pmsconnect.py
+++ b/plexpy/pmsconnect.py
@@ -776,12 +776,20 @@ class PmsConnect(object):
                 guids.append(helpers.get_xml_attr(guid, 'id'))
 
         if metadata_main.getElementsByTagName('Marker'):
+            first = None
             for marker in metadata_main.getElementsByTagName('Marker'):
+                marker_type = helpers.get_xml_attr(marker, 'type')
+                if marker_type == 'credits':
+                    if first is None:
+                        first = True
+                    elif first is True:
+                        first = False
                 markers.append({
-                    'id': helpers.get_xml_attr(marker, 'id'),
+                    'id': helpers.cast_to_int(helpers.get_xml_attr(marker, 'id')),
                     'type': helpers.get_xml_attr(marker, 'type'),
                     'start_time_offset': helpers.cast_to_int(helpers.get_xml_attr(marker, 'startTimeOffset')),
                     'end_time_offset': helpers.cast_to_int(helpers.get_xml_attr(marker, 'endTimeOffset')),
+                    'first': first if marker_type == 'credits' else False,
                     'final': helpers.bool_true(helpers.get_xml_attr(marker, 'final'))
                 })
 

From 599c54c9e10ce7293319f172fab4def78702a86b Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 16 Feb 2023 17:02:30 -0800
Subject: [PATCH 311/743] Refactor activity handler

---
 plexpy/activity_handler.py | 482 ++++++++++++++++++-------------------
 1 file changed, 229 insertions(+), 253 deletions(-)

diff --git a/plexpy/activity_handler.py b/plexpy/activity_handler.py
index 3b5a283f..5ed69e10 100644
--- a/plexpy/activity_handler.py
+++ b/plexpy/activity_handler.py
@@ -53,38 +53,33 @@ class ActivityHandler(object):
     def __init__(self, timeline):
         self.ap = activity_processor.ActivityProcessor()
         self.timeline = timeline
+
+        self.session_key = None
+        self.rating_key = None
+
+        self.is_valid_session = ('sessionKey' in self.timeline and str(self.timeline['sessionKey']).isdigit())
+        if self.is_valid_session:
+            self.session_key = int(self.timeline['sessionKey'])
+            self.rating_key = str(self.timeline['ratingKey'])
+
+        self.key = self.timeline.get('key')
+        self.state = self.timeline.get('state')
+        self.view_offset = self.timeline.get('viewOffset')
+        self.transcode_key = self.timeline.get('transcodeSession', '')
+
         self.db_session = None
         self.session = None
         self.metadata = None
 
-    def is_valid_session(self):
-        if 'sessionKey' in self.timeline:
-            if str(self.timeline['sessionKey']).isdigit():
-                return True
-
-        return False
-
-    def get_session_key(self):
-        if self.is_valid_session():
-            return int(self.timeline['sessionKey'])
-
-        return None
-
-    def get_rating_key(self):
-        if self.is_valid_session():
-            return self.timeline['ratingKey']
-
-        return None
-
     def get_db_session(self):
         # Retrieve the session data from our temp table
-        self.db_session = self.ap.get_session_by_key(session_key=self.get_session_key())
+        self.db_session = self.ap.get_session_by_key(session_key=self.session_key)
 
     def get_metadata(self, skip_cache=False):
         if self.metadata is None:
-            cache_key = None if skip_cache else self.get_session_key()
+            cache_key = None if skip_cache else self.session_key
             pms_connect = pmsconnect.PmsConnect()
-            metadata = pms_connect.get_metadata_details(rating_key=self.get_rating_key(), cache_key=cache_key)
+            metadata = pms_connect.get_metadata_details(rating_key=self.rating_key, cache_key=cache_key)
 
             if metadata:
                 self.metadata = metadata
@@ -95,12 +90,12 @@ class ActivityHandler(object):
 
         if session_list:
             for session in session_list['sessions']:
-                if int(session['session_key']) == self.get_session_key():
+                if int(session['session_key']) == self.session_key:
                     # Live sessions don't have rating keys in sessions
                     # Get it from the websocket data
                     if not session['rating_key']:
-                        session['rating_key'] = self.get_rating_key()
-                    session['rating_key_websocket'] = self.get_rating_key()
+                        session['rating_key'] = self.rating_key
+                    session['rating_key_websocket'] = self.rating_key
                     self.session = session
                     return session
 
@@ -116,9 +111,9 @@ class ActivityHandler(object):
         self.get_db_session()
 
     def set_session_state(self):
-        self.ap.set_session_state(session_key=self.get_session_key(),
-                             state=self.timeline['state'],
-                             view_offset=self.timeline['viewOffset'],
+        self.ap.set_session_state(session_key=self.session_key,
+                             state=self.state,
+                             view_offset=self.view_offset,
                              stopped=helpers.timestamp())
         
     def put_notification(self, notify_action, **kwargs):
@@ -148,19 +143,19 @@ class ActivityHandler(object):
         self.update_db_session(notify=True)
 
         # Schedule a callback to force stop a stale stream 5 minutes later
-        schedule_callback('session_key-{}'.format(self.get_session_key()),
+        schedule_callback('session_key-{}'.format(self.session_key),
                             func=force_stop_stream,
-                            args=[self.get_session_key(), self.session['full_title'], self.session['username']],
+                            args=[self.session_key, self.session['full_title'], self.session['username']],
                             minutes=5)
         
         self.check_markers()
 
     def on_stop(self, force_stop=False):
         logger.debug("Tautulli ActivityHandler :: Session %s %sstopped."
-                        % (str(self.get_session_key()), 'force ' if force_stop else ''))
+                        % (str(self.session_key), 'force ' if force_stop else ''))
 
         # Set the session last_paused timestamp
-        self.ap.set_session_last_paused(session_key=self.get_session_key(), timestamp=None)
+        self.ap.set_session_last_paused(session_key=self.session_key, timestamp=None)
 
         # Update the session state and viewOffset
         # Set force_stop to true to disable the state set
@@ -173,25 +168,25 @@ class ActivityHandler(object):
         if row_id:
             self.put_notification('on_stop')
 
-            schedule_callback('session_key-{}'.format(self.get_session_key()), remove_job=True)
+            schedule_callback('session_key-{}'.format(self.session_key), remove_job=True)
 
             # Remove the session from our temp session table
             logger.debug("Tautulli ActivityHandler :: Removing sessionKey %s ratingKey %s from session queue"
-                            % (str(self.get_session_key()), str(self.get_rating_key())))
+                            % (str(self.session_key), str(self.rating_key)))
             self.ap.delete_session(row_id=row_id)
-            delete_metadata_cache(self.get_session_key())
+            delete_metadata_cache(self.session_key)
         else:
-            schedule_callback('session_key-{}'.format(self.get_session_key()),
+            schedule_callback('session_key-{}'.format(self.session_key),
                                 func=force_stop_stream,
-                                args=[self.get_session_key(), self.db_session['full_title'], self.db_session['user']],
+                                args=[self.session_key, self.db_session['full_title'], self.db_session['user']],
                                 seconds=30)
 
     def on_pause(self, still_paused=False):
         if not still_paused:
-            logger.debug("Tautulli ActivityHandler :: Session %s paused." % str(self.get_session_key()))
+            logger.debug("Tautulli ActivityHandler :: Session %s paused." % str(self.session_key))
 
         # Set the session last_paused timestamp
-        self.ap.set_session_last_paused(session_key=self.get_session_key(), timestamp=helpers.timestamp())
+        self.ap.set_session_last_paused(session_key=self.session_key, timestamp=helpers.timestamp())
 
         self.update_db_session()
 
@@ -199,52 +194,52 @@ class ActivityHandler(object):
             self.put_notification('on_pause')
 
     def on_resume(self):
-        logger.debug("Tautulli ActivityHandler :: Session %s resumed." % str(self.get_session_key()))
+        logger.debug("Tautulli ActivityHandler :: Session %s resumed." % str(self.session_key))
 
         # Set the session last_paused timestamp
-        self.ap.set_session_last_paused(session_key=self.get_session_key(), timestamp=None)
+        self.ap.set_session_last_paused(session_key=self.session_key, timestamp=None)
 
         self.update_db_session()
 
         self.put_notification('on_resume')
 
     def on_buffer(self):
-        logger.debug("Tautulli ActivityHandler :: Session %s is buffering." % self.get_session_key())
+        logger.debug("Tautulli ActivityHandler :: Session %s is buffering." % self.session_key)
 
         # Increment our buffer count
-        self.ap.increment_session_buffer_count(session_key=self.get_session_key())
+        self.ap.increment_session_buffer_count(session_key=self.session_key)
 
         # Get our current buffer count
-        current_buffer_count = self.ap.get_session_buffer_count(self.get_session_key())
+        current_buffer_count = self.ap.get_session_buffer_count(self.session_key)
         logger.debug("Tautulli ActivityHandler :: Session %s buffer count is %s." %
-                        (self.get_session_key(), current_buffer_count))
+                        (self.session_key, current_buffer_count))
 
         # Get our last triggered time
-        buffer_last_triggered = self.ap.get_session_buffer_trigger_time(self.get_session_key())
+        buffer_last_triggered = self.ap.get_session_buffer_trigger_time(self.session_key)
 
         self.update_db_session()
 
         time_since_last_trigger = 0
         if buffer_last_triggered:
             logger.debug("Tautulli ActivityHandler :: Session %s buffer last triggered at %s." %
-                            (self.get_session_key(), buffer_last_triggered))
+                            (self.session_key, buffer_last_triggered))
             time_since_last_trigger = helpers.timestamp() - int(buffer_last_triggered)
 
         if current_buffer_count >= plexpy.CONFIG.BUFFER_THRESHOLD and time_since_last_trigger == 0 or \
                 time_since_last_trigger >= plexpy.CONFIG.BUFFER_WAIT:
-            self.ap.set_session_buffer_trigger_time(session_key=self.get_session_key())
+            self.ap.set_session_buffer_trigger_time(session_key=self.session_key)
 
             self.put_notification('on_buffer')
 
     def on_error(self):
-        logger.debug("Tautulli ActivityHandler :: Session %s encountered an error." % str(self.get_session_key()))
+        logger.debug("Tautulli ActivityHandler :: Session %s encountered an error." % str(self.session_key))
 
         self.update_db_session()
 
         self.put_notification('on_error')
 
     def on_change(self):
-        logger.debug("Tautulli ActivityHandler :: Session %s has changed transcode decision." % str(self.get_session_key()))
+        logger.debug("Tautulli ActivityHandler :: Session %s has changed transcode decision." % str(self.session_key))
 
         self.update_db_session()
 
@@ -252,17 +247,17 @@ class ActivityHandler(object):
 
     def on_intro(self, marker):
         if self.get_live_session():
-            logger.debug("Tautulli ActivityHandler :: Session %s intro marker reached." % str(self.get_session_key()))
+            logger.debug("Tautulli ActivityHandler :: Session %s intro marker reached." % str(self.session_key))
 
             self.put_notification('on_intro', marker=marker)
 
     def on_credits(self, marker):
         if self.get_live_session():
-            logger.debug("Tautulli ActivityHandler :: Session %s credits marker reached." % str(self.get_session_key()))
+            logger.debug("Tautulli ActivityHandler :: Session %s credits marker reached." % str(self.session_key))
             self.put_notification('on_credits', marker=marker)
 
     def on_watched(self):
-        logger.debug("Tautulli ActivityHandler :: Session %s watched." % str(self.get_session_key()))
+        logger.debug("Tautulli ActivityHandler :: Session %s watched." % str(self.session_key))
 
         watched_notifiers = notification_handler.get_notify_state_enabled(
             session=self.db_session, notify_action='on_watched', notified=False)
@@ -272,88 +267,85 @@ class ActivityHandler(object):
 
     # This function receives events from our websocket connection
     def process(self):
-        if self.is_valid_session():
-            self.get_db_session()
+        if not self.is_valid_session:
+            return
+        
+        self.get_db_session()
 
-            this_state = self.timeline['state']
-            this_rating_key = str(self.timeline['ratingKey'])
-            this_key = self.timeline['key']
-            this_transcode_key = self.timeline.get('transcodeSession', '')
+        if not self.db_session:
+            # We don't have this session in our table yet, start a new one.
+            if self.state != 'buffering':
+                self.on_start()
+            return
 
-            # Get the live tv session uuid
-            this_live_uuid = this_key.split('/')[-1] if this_key.startswith('/livetv/sessions') else None
+        # If we already have this session in the temp table, check for state changes
+        # Re-schedule the callback to reset the 5 minutes timer
+        schedule_callback('session_key-{}'.format(self.session_key),
+                            func=force_stop_stream,
+                            args=[self.session_key, self.db_session['full_title'], self.db_session['user']],
+                            minutes=5)
 
-            # If we already have this session in the temp table, check for state changes
-            if self.db_session:
-                # Re-schedule the callback to reset the 5 minutes timer
-                schedule_callback('session_key-{}'.format(self.get_session_key()),
-                                  func=force_stop_stream,
-                                  args=[self.get_session_key(), self.db_session['full_title'], self.db_session['user']],
-                                  minutes=5)
+        last_state = self.db_session['state']
+        last_rating_key = str(self.db_session['rating_key'])
+        last_live_uuid = self.db_session['live_uuid']
+        last_transcode_key = self.db_session['transcode_key'].split('/')[-1]
+        last_paused = self.db_session['last_paused']
+        last_rating_key_websocket = self.db_session['rating_key_websocket']
+        last_guid = self.db_session['guid']
 
-                last_state = self.db_session['state']
-                last_rating_key = str(self.db_session['rating_key'])
-                last_live_uuid = self.db_session['live_uuid']
-                last_transcode_key = self.db_session['transcode_key'].split('/')[-1]
-                last_paused = self.db_session['last_paused']
-                last_rating_key_websocket = self.db_session['rating_key_websocket']
-                last_guid = self.db_session['guid']
+        # Get the live tv session uuid
+        this_live_uuid = self.key.split('/')[-1] if self.key.startswith('/livetv/sessions') else None
 
-                this_guid = last_guid
-                # Check guid for live TV metadata every 60 seconds
-                if self.db_session['live'] and helpers.timestamp() - self.db_session['stopped'] > 60:
-                    self.get_metadata(skip_cache=True)
-                    if self.metadata:
-                        this_guid = self.metadata['guid']
+        this_guid = last_guid
+        # Check guid for live TV metadata every 60 seconds
+        if self.db_session['live'] and helpers.timestamp() - self.db_session['stopped'] > 60:
+            self.get_metadata(skip_cache=True)
+            if self.metadata:
+                this_guid = self.metadata['guid']
 
-                # Make sure the same item is being played
-                if (this_rating_key == last_rating_key
-                        or this_rating_key == last_rating_key_websocket
-                        or this_live_uuid == last_live_uuid) \
-                        and this_guid == last_guid:
-                    # Update the session state and viewOffset
-                    if this_state == 'playing':
-                        # Update the session in our temp session table
-                        # if the last set temporary stopped time exceeds 60 seconds
-                        if helpers.timestamp() - self.db_session['stopped'] > 60:
-                            self.update_db_session()
+        # Make sure the same item is being played
+        if (self.rating_key == last_rating_key
+                or self.rating_key == last_rating_key_websocket
+                or this_live_uuid == last_live_uuid) \
+                and this_guid == last_guid:
+            # Update the session state and viewOffset
+            if self.state == 'playing':
+                # Update the session in our temp session table
+                # if the last set temporary stopped time exceeds 60 seconds
+                if helpers.timestamp() - self.db_session['stopped'] > 60:
+                    self.update_db_session()
 
-                    # Start our state checks
-                    if this_state != last_state:
-                        if this_state == 'paused':
-                            self.on_pause()
-                        elif last_paused and this_state == 'playing':
-                            self.on_resume()
-                        elif this_state == 'stopped':
-                            self.on_stop()
-                        elif this_state == 'error':
-                            self.on_error()
+            # Start our state checks
+            if self.state != last_state:
+                if self.state == 'paused':
+                    self.on_pause()
+                elif last_paused and self.state == 'playing':
+                    self.on_resume()
+                elif self.state == 'stopped':
+                    self.on_stop()
+                elif self.state == 'error':
+                    self.on_error()
 
-                    elif this_state == 'paused':
-                        # Update the session last_paused timestamp
-                        self.on_pause(still_paused=True)
+            elif self.state == 'paused':
+                # Update the session last_paused timestamp
+                self.on_pause(still_paused=True)
 
-                    if this_state == 'buffering':
-                        self.on_buffer()
+            if self.state == 'buffering':
+                self.on_buffer()
 
-                    if this_transcode_key != last_transcode_key and this_state != 'stopped':
-                        self.on_change()
+            if self.transcode_key != last_transcode_key and self.state != 'stopped':
+                self.on_change()
 
-                # If a client doesn't register stop events (I'm looking at you PHT!) check if the ratingKey has changed
-                else:
-                    # Manually stop and start
-                    # Set force_stop so that we don't overwrite our last viewOffset
-                    self.on_stop(force_stop=True)
-                    self.on_start()
+        # If a client doesn't register stop events (I'm looking at you PHT!) check if the ratingKey has changed
+        else:
+            # Manually stop and start
+            # Set force_stop so that we don't overwrite our last viewOffset
+            self.on_stop(force_stop=True)
+            self.on_start()
 
-                # Check for stream offset notifications
-                self.check_markers()
-                self.check_watched()
-
-            else:
-                # We don't have this session in our table yet, start a new one.
-                if this_state != 'buffering':
-                    self.on_start()
+        # Check for stream offset notifications
+        self.check_markers()
+        self.check_watched()
     
     def check_markers(self):
         # Monitor if the stream has reached the intro or credit marker offsets
@@ -364,20 +356,20 @@ class ActivityHandler(object):
         for marker_idx, marker in enumerate(self.metadata['markers'], start=1):
             # Websocket events only fire every 10 seconds
             # Check if the marker is within 10 seconds of the current viewOffset
-            if marker['start_time_offset'] - 10000 <= self.timeline['viewOffset'] <= marker['end_time_offset']:
+            if marker['start_time_offset'] - 10000 <= self.view_offset <= marker['end_time_offset']:
                 marker_flag = True
 
                 if self.db_session['marker'] != marker_idx:
-                    self.ap.set_marker(session_key=self.get_session_key(), marker_idx=marker_idx, marker_type=marker['type'])
+                    self.ap.set_marker(session_key=self.session_key, marker_idx=marker_idx, marker_type=marker['type'])
                     callback_func = getattr(self, 'on_{}'.format(marker['type']))
 
-                    if self.timeline['viewOffset'] < marker['start_time_offset']:
+                    if self.view_offset < marker['start_time_offset']:
                         # Schedule a callback for the exact offset of the marker
                         schedule_callback(
-                            'session_key-{}-marker-{}'.format(self.get_session_key(), marker_idx),
+                            'session_key-{}-marker-{}'.format(self.session_key, marker_idx),
                             func=callback_func,
                             args=[marker],
-                            milliseconds=marker['start_time_offset'] - self.timeline['viewOffset']
+                            milliseconds=marker['start_time_offset'] - self.view_offset
                         )
                     else:
                         callback_func(marker)
@@ -385,7 +377,7 @@ class ActivityHandler(object):
                 break
 
         if not marker_flag:
-            self.ap.set_marker(session_key=self.get_session_key(), marker_idx=0)
+            self.ap.set_marker(session_key=self.session_key, marker_idx=0)
 
     def check_watched(self):
         # Monitor if the stream has reached the watch percentage for notifications
@@ -399,7 +391,7 @@ class ActivityHandler(object):
             }
 
             if progress_percent >= watched_percent.get(self.db_session['media_type'], 101):
-                self.ap.set_watched(session_key=self.get_session_key())
+                self.ap.set_watched(session_key=self.session_key)
                 self.on_watched()
 
 
@@ -408,121 +400,106 @@ class TimelineHandler(object):
     def __init__(self, timeline):
         self.timeline = timeline
 
-    def is_item(self):
-        if 'itemID' in self.timeline:
-            return True
+        self.rating_key = None
 
-        return False
+        self.is_item = ('itemID' in self.timeline)
+        if self.is_item:
+            self.rating_key = int(self.timeline['itemID'])
 
-    def get_rating_key(self):
-        if self.is_item():
-            return int(self.timeline['itemID'])
-
-        return None
-
-    def get_metadata(self):
-        pms_connect = pmsconnect.PmsConnect()
-        metadata = pms_connect.get_metadata_details(self.get_rating_key())
-
-        if metadata:
-            return metadata
-
-        return None
+        self.parent_rating_key = helpers.cast_to_int(self.timeline.get('parentItemID')) or None
+        self.grandparent_rating_key = helpers.cast_to_int(self.timeline.get('rootItemID')) or None
+        self.identifier = self.timeline.get('identifier')
+        self.state_type = self.timeline.get('state')
+        self.media_type = common.MEDIA_TYPE_VALUES.get(self.timeline.get('type'))
+        self.section_id = helpers.cast_to_int(self.timeline.get('sectionID', 0))
+        self.title = self.timeline.get('title', 'Unknown')
+        self.metadata_state = self.timeline.get('metadataState')
+        self.media_state = self.timeline.get('mediaState')
+        self.queue_size = self.timeline.get('queueSize')
 
     # This function receives events from our websocket connection
     def process(self):
-        if self.is_item():
-            global RECENTLY_ADDED_QUEUE
+        if not self.is_item:
+            return
+        
+        # Return if it is not a library event (i.e. DVR EPG event)
+        if self.identifier != 'com.plexapp.plugins.library':
+            return
 
-            rating_key = self.get_rating_key()
-            parent_rating_key = helpers.cast_to_int(self.timeline.get('parentItemID')) or None
-            grandparent_rating_key = helpers.cast_to_int(self.timeline.get('rootItemID')) or None
+        global RECENTLY_ADDED_QUEUE
 
-            identifier = self.timeline.get('identifier')
-            state_type = self.timeline.get('state')
-            media_type = common.MEDIA_TYPE_VALUES.get(self.timeline.get('type'))
-            section_id = helpers.cast_to_int(self.timeline.get('sectionID', 0))
-            title = self.timeline.get('title', 'Unknown')
-            metadata_state = self.timeline.get('metadataState')
-            media_state = self.timeline.get('mediaState')
-            queue_size = self.timeline.get('queueSize')
+        # Add a new media item to the recently added queue
+        if self.media_type and self.section_id > 0 and self.state_type == 0 and self.metadata_state == 'created':
 
-            # Return if it is not a library event (i.e. DVR EPG event)
-            if identifier != 'com.plexapp.plugins.library':
-                return
+            if self.media_type in ('episode', 'track'):
+                grandparent_set = RECENTLY_ADDED_QUEUE.get(self.grandparent_rating_key, set())
+                grandparent_set.add(self.parent_rating_key)
+                RECENTLY_ADDED_QUEUE[self.grandparent_rating_key] = grandparent_set
 
-            # Add a new media item to the recently added queue
-            if media_type and section_id > 0 and state_type == 0 and metadata_state == 'created':
+                parent_set = RECENTLY_ADDED_QUEUE.get(self.parent_rating_key, set())
+                parent_set.add(self.rating_key)
+                RECENTLY_ADDED_QUEUE[self.parent_rating_key] = parent_set
 
-                if media_type in ('episode', 'track'):
-                    grandparent_set = RECENTLY_ADDED_QUEUE.get(grandparent_rating_key, set())
-                    grandparent_set.add(parent_rating_key)
-                    RECENTLY_ADDED_QUEUE[grandparent_rating_key] = grandparent_set
+                RECENTLY_ADDED_QUEUE[self.rating_key] = {self.grandparent_rating_key}
 
-                    parent_set = RECENTLY_ADDED_QUEUE.get(parent_rating_key, set())
-                    parent_set.add(rating_key)
-                    RECENTLY_ADDED_QUEUE[parent_rating_key] = parent_set
+                logger.debug("Tautulli TimelineHandler :: Library item '%s' (%s, grandparent %s) "
+                                "added to recently added queue."
+                                % (self.title, str(self.rating_key), str(self.grandparent_rating_key)))
 
-                    RECENTLY_ADDED_QUEUE[rating_key] = {grandparent_rating_key}
+                # Schedule a callback to clear the recently added queue
+                schedule_callback('rating_key-{}'.format(self.grandparent_rating_key),
+                                    func=clear_recently_added_queue,
+                                    args=[self.grandparent_rating_key, self.title],
+                                    seconds=plexpy.CONFIG.NOTIFY_RECENTLY_ADDED_DELAY)
 
-                    logger.debug("Tautulli TimelineHandler :: Library item '%s' (%s, grandparent %s) "
-                                 "added to recently added queue."
-                                 % (title, str(rating_key), str(grandparent_rating_key)))
+            elif self.media_type in ('season', 'album'):
+                parent_set = RECENTLY_ADDED_QUEUE.get(self.parent_rating_key, set())
+                parent_set.add(self.rating_key)
+                RECENTLY_ADDED_QUEUE[self.parent_rating_key] = parent_set
 
-                    # Schedule a callback to clear the recently added queue
-                    schedule_callback('rating_key-{}'.format(grandparent_rating_key),
-                                      func=clear_recently_added_queue,
-                                      args=[grandparent_rating_key, title],
-                                      seconds=plexpy.CONFIG.NOTIFY_RECENTLY_ADDED_DELAY)
+                logger.debug("Tautulli TimelineHandler :: Library item '%s' (%s , parent %s) "
+                                "added to recently added queue."
+                                % (self.title, str(self.rating_key), str(self.parent_rating_key)))
 
-                elif media_type in ('season', 'album'):
-                    parent_set = RECENTLY_ADDED_QUEUE.get(parent_rating_key, set())
-                    parent_set.add(rating_key)
-                    RECENTLY_ADDED_QUEUE[parent_rating_key] = parent_set
+                # Schedule a callback to clear the recently added queue
+                schedule_callback('rating_key-{}'.format(self.parent_rating_key),
+                                    func=clear_recently_added_queue,
+                                    args=[self.parent_rating_key, self.title],
+                                    seconds=plexpy.CONFIG.NOTIFY_RECENTLY_ADDED_DELAY)
 
-                    logger.debug("Tautulli TimelineHandler :: Library item '%s' (%s , parent %s) "
-                                 "added to recently added queue."
-                                 % (title, str(rating_key), str(parent_rating_key)))
-
-                    # Schedule a callback to clear the recently added queue
-                    schedule_callback('rating_key-{}'.format(parent_rating_key),
-                                      func=clear_recently_added_queue,
-                                      args=[parent_rating_key, title],
-                                      seconds=plexpy.CONFIG.NOTIFY_RECENTLY_ADDED_DELAY)
-
-                elif media_type in ('movie', 'show', 'artist'):
-                    queue_set = RECENTLY_ADDED_QUEUE.get(rating_key, set())
-                    RECENTLY_ADDED_QUEUE[rating_key] = queue_set
-
-                    logger.debug("Tautulli TimelineHandler :: Library item '%s' (%s) "
-                                 "added to recently added queue."
-                                 % (title, str(rating_key)))
-
-                    # Schedule a callback to clear the recently added queue
-                    schedule_callback('rating_key-{}'.format(rating_key),
-                                      func=clear_recently_added_queue,
-                                      args=[rating_key, title],
-                                      seconds=plexpy.CONFIG.NOTIFY_RECENTLY_ADDED_DELAY)
-
-            # A movie, show, or artist is done processing
-            elif media_type in ('movie', 'show', 'artist') and section_id > 0 and \
-                    state_type == 5 and metadata_state is None and queue_size is None and \
-                    rating_key in RECENTLY_ADDED_QUEUE:
+            elif self.media_type in ('movie', 'show', 'artist'):
+                queue_set = RECENTLY_ADDED_QUEUE.get(self.rating_key, set())
+                RECENTLY_ADDED_QUEUE[self.rating_key] = queue_set
 
                 logger.debug("Tautulli TimelineHandler :: Library item '%s' (%s) "
-                             "done processing metadata."
-                             % (title, str(rating_key)))
+                                "added to recently added queue."
+                                % (self.title, str(self.rating_key)))
 
-            # An item was deleted, make sure it is removed from the queue
-            elif state_type == 9 and metadata_state == 'deleted':
-                if rating_key in RECENTLY_ADDED_QUEUE and not RECENTLY_ADDED_QUEUE[rating_key]:
-                    logger.debug("Tautulli TimelineHandler :: Library item %s "
-                                 "removed from recently added queue."
-                                 % str(rating_key))
-                    del_keys(rating_key)
+                # Schedule a callback to clear the recently added queue
+                schedule_callback('rating_key-{}'.format(self.rating_key),
+                                    func=clear_recently_added_queue,
+                                    args=[self.rating_key, self.title],
+                                    seconds=plexpy.CONFIG.NOTIFY_RECENTLY_ADDED_DELAY)
 
-                    # Remove the callback if the item is removed
-                    schedule_callback('rating_key-{}'.format(rating_key), remove_job=True)
+        # A movie, show, or artist is done processing
+        elif self.media_type in ('movie', 'show', 'artist') and self.section_id > 0 and \
+                self.state_type == 5 and self.metadata_state is None and self.queue_size is None and \
+                self.rating_key in RECENTLY_ADDED_QUEUE:
+
+            logger.debug("Tautulli TimelineHandler :: Library item '%s' (%s) "
+                            "done processing metadata."
+                            % (self.title, str(self.rating_key)))
+
+        # An item was deleted, make sure it is removed from the queue
+        elif self.state_type == 9 and self.metadata_state == 'deleted':
+            if self.rating_key in RECENTLY_ADDED_QUEUE and not RECENTLY_ADDED_QUEUE[self.rating_key]:
+                logger.debug("Tautulli TimelineHandler :: Library item %s "
+                                "removed from recently added queue."
+                                % str(self.rating_key))
+                del_keys(self.rating_key)
+
+                # Remove the callback if the item is removed
+                schedule_callback('rating_key-{}'.format(self.rating_key), remove_job=True)
 
 
 class ReachabilityHandler(object):
@@ -530,10 +507,7 @@ class ReachabilityHandler(object):
     def __init__(self, data):
         self.data = data
 
-    def is_reachable(self):
-        if 'reachability' in self.data:
-            return self.data['reachability']
-        return False
+        self.is_reachable = self.data.get('reachable', False)
 
     def remote_access_enabled(self):
         pms_connect = pmsconnect.PmsConnect()
@@ -552,42 +526,44 @@ class ReachabilityHandler(object):
             return
 
         # Do nothing if remote access is still up and hasn't changed
-        if self.is_reachable() and plexpy.PLEX_REMOTE_ACCESS_UP:
+        if self.is_reachable and plexpy.PLEX_REMOTE_ACCESS_UP:
             return
 
         pms_connect = pmsconnect.PmsConnect()
         server_response = pms_connect.get_server_response()
 
-        if server_response:
-            # Waiting for port mapping
-            if server_response['mapping_state'] == 'waiting':
-                logger.warn("Tautulli ReachabilityHandler :: Remote access waiting for port mapping.")
+        if not server_response:
+            return
 
-            elif plexpy.PLEX_REMOTE_ACCESS_UP is not False and server_response['reason']:
-                logger.warn("Tautulli ReachabilityHandler :: Remote access failed: %s" % server_response['reason'])
-                logger.info("Tautulli ReachabilityHandler :: Plex remote access is down.")
+        # Waiting for port mapping
+        if server_response['mapping_state'] == 'waiting':
+            logger.warn("Tautulli ReachabilityHandler :: Remote access waiting for port mapping.")
 
-                plexpy.PLEX_REMOTE_ACCESS_UP = False
+        elif plexpy.PLEX_REMOTE_ACCESS_UP is not False and server_response['reason']:
+            logger.warn("Tautulli ReachabilityHandler :: Remote access failed: %s" % server_response['reason'])
+            logger.info("Tautulli ReachabilityHandler :: Plex remote access is down.")
 
-                if not ACTIVITY_SCHED.get_job('on_extdown'):
-                    logger.debug("Tautulli ReachabilityHandler :: Scheduling remote access down callback in %d seconds.",
-                                 plexpy.CONFIG.NOTIFY_REMOTE_ACCESS_THRESHOLD)
-                    schedule_callback('on_extdown', func=self.on_extdown, args=[server_response],
-                                      seconds=plexpy.CONFIG.NOTIFY_REMOTE_ACCESS_THRESHOLD)
+            plexpy.PLEX_REMOTE_ACCESS_UP = False
 
-            elif plexpy.PLEX_REMOTE_ACCESS_UP is False and not server_response['reason']:
-                logger.info("Tautulli ReachabilityHandler :: Plex remote access is back up.")
+            if not ACTIVITY_SCHED.get_job('on_extdown'):
+                logger.debug("Tautulli ReachabilityHandler :: Scheduling remote access down callback in %d seconds.",
+                                plexpy.CONFIG.NOTIFY_REMOTE_ACCESS_THRESHOLD)
+                schedule_callback('on_extdown', func=self.on_extdown, args=[server_response],
+                                    seconds=plexpy.CONFIG.NOTIFY_REMOTE_ACCESS_THRESHOLD)
 
-                plexpy.PLEX_REMOTE_ACCESS_UP = True
+        elif plexpy.PLEX_REMOTE_ACCESS_UP is False and not server_response['reason']:
+            logger.info("Tautulli ReachabilityHandler :: Plex remote access is back up.")
 
-                if ACTIVITY_SCHED.get_job('on_extdown'):
-                    logger.debug("Tautulli ReachabilityHandler :: Cancelling scheduled remote access down callback.")
-                    schedule_callback('on_extdown', remove_job=True)
-                else:
-                    self.on_extup(server_response)
+            plexpy.PLEX_REMOTE_ACCESS_UP = True
 
-            elif plexpy.PLEX_REMOTE_ACCESS_UP is None:
-                plexpy.PLEX_REMOTE_ACCESS_UP = self.is_reachable()
+            if ACTIVITY_SCHED.get_job('on_extdown'):
+                logger.debug("Tautulli ReachabilityHandler :: Cancelling scheduled remote access down callback.")
+                schedule_callback('on_extdown', remove_job=True)
+            else:
+                self.on_extup(server_response)
+
+        elif plexpy.PLEX_REMOTE_ACCESS_UP is None:
+            plexpy.PLEX_REMOTE_ACCESS_UP = self.is_reachable
 
 
 def del_keys(key):

From 7cc78d448d6d3f907d203203be0d20d2a359f275 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 16 Feb 2023 17:06:46 -0800
Subject: [PATCH 312/743] Simplify set marker in database

---
 plexpy/activity_processor.py | 9 ++-------
 1 file changed, 2 insertions(+), 7 deletions(-)

diff --git a/plexpy/activity_processor.py b/plexpy/activity_processor.py
index c821d23d..dcd1f138 100644
--- a/plexpy/activity_processor.py
+++ b/plexpy/activity_processor.py
@@ -661,15 +661,10 @@ class ActivityProcessor(object):
                            [session['write_attempts'] + 1, session_key])
 
     def set_marker(self, session_key=None, marker_idx=None, marker_type=None):
-        if marker_type == 'intro':
-            args = [1, 0]
-        elif marker_type == 'credits':
-            args = [0, 1]
-        else:
-            args = [0, 0]
+        marker_args = [int(marker_type == 'intro'), int(marker_type == 'credits')]
         self.db.action('UPDATE sessions SET intro = ?, credits = ?, marker = ? '
                        'WHERE session_key = ?',
-                       args + [marker_idx, session_key])
+                       marker_args + [marker_idx, session_key])
 
     def set_watched(self, session_key=None):
         self.db.action('UPDATE sessions SET watched = ? '

From 9c6b8f1af5bd4f1e0c32a85d178253ae14014fd9 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 17 Feb 2023 09:28:44 -0800
Subject: [PATCH 313/743] Simplify metadata credits marker first flag

---
 plexpy/pmsconnect.py | 12 +++++-------
 1 file changed, 5 insertions(+), 7 deletions(-)

diff --git a/plexpy/pmsconnect.py b/plexpy/pmsconnect.py
index cc433027..347de513 100644
--- a/plexpy/pmsconnect.py
+++ b/plexpy/pmsconnect.py
@@ -780,17 +780,15 @@ class PmsConnect(object):
             for marker in metadata_main.getElementsByTagName('Marker'):
                 marker_type = helpers.get_xml_attr(marker, 'type')
                 if marker_type == 'credits':
-                    if first is None:
-                        first = True
-                    elif first is True:
-                        first = False
+                    first = bool(first is None)
+                final = helpers.bool_true(helpers.get_xml_attr(marker, 'final'))
                 markers.append({
                     'id': helpers.cast_to_int(helpers.get_xml_attr(marker, 'id')),
-                    'type': helpers.get_xml_attr(marker, 'type'),
+                    'type': marker_type,
                     'start_time_offset': helpers.cast_to_int(helpers.get_xml_attr(marker, 'startTimeOffset')),
                     'end_time_offset': helpers.cast_to_int(helpers.get_xml_attr(marker, 'endTimeOffset')),
-                    'first': first if marker_type == 'credits' else False,
-                    'final': helpers.bool_true(helpers.get_xml_attr(marker, 'final'))
+                    'first': first if marker_type == 'credits' else None,
+                    'final': final if marker_type == 'credits' else None
                 })
 
         if metadata_type == 'movie':

From 32bb98e8c1a0d3b790e269e28c15d259628e00d1 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 17 Feb 2023 09:29:08 -0800
Subject: [PATCH 314/743] Update get_metadata_details docs

---
 plexpy/webserve.py | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/plexpy/webserve.py b/plexpy/webserve.py
index 8ad3e664..963f2ce1 100644
--- a/plexpy/webserve.py
+++ b/plexpy/webserve.py
@@ -5339,6 +5339,24 @@ class WebInterface(object):
                      "last_viewed_at": "1462165717",
                      "library_name": "TV Shows",
                      "live": 0,
+                     "markers": [
+                        {
+                             "id": 908,
+                             "type": "credits",
+                             "start_time_offset": 2923863,
+                             "end_time_offset": 2998197,
+                             "first": true,
+                             "final": true
+                        },
+                        {
+                             "id": 908,
+                             "type": "intro",
+                             "start_time_offset": 1622,
+                             "end_time_offset": 109135,
+                             "first": null,
+                             "final": null
+                        }
+                     ],
                      "media_index": "1",
                      "media_info": [
                          {

From 6b0b3a476fbfde4cdf3dbfa617ff8080cdf28234 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 17 Feb 2023 10:01:57 -0800
Subject: [PATCH 315/743] Add support for commercial marker triggers

---
 plexpy/__init__.py             | 13 +++++++++++--
 plexpy/activity_handler.py     | 11 +++++++++--
 plexpy/activity_processor.py   |  8 ++++++--
 plexpy/notification_handler.py |  4 ++--
 plexpy/notifiers.py            |  8 ++++++++
 5 files changed, 36 insertions(+), 8 deletions(-)

diff --git a/plexpy/__init__.py b/plexpy/__init__.py
index 09c16586..d3de0815 100644
--- a/plexpy/__init__.py
+++ b/plexpy/__init__.py
@@ -656,8 +656,8 @@ def dbcheck():
         'synced_version INTEGER, synced_version_profile TEXT, '
         'live INTEGER, live_uuid TEXT, channel_call_sign TEXT, channel_identifier TEXT, channel_thumb TEXT, '
         'secure INTEGER, relayed INTEGER, '
-        'buffer_count INTEGER DEFAULT 0, buffer_last_triggered INTEGER, last_paused INTEGER, '
-        'watched INTEGER DEFAULT 0, intro INTEGER DEFAULT 0, credits INTEGER DEFAULT 0, marker INTEGER DEFAULT 0, '
+        'buffer_count INTEGER DEFAULT 0, buffer_last_triggered INTEGER, last_paused INTEGER, watched INTEGER DEFAULT 0, '
+        'intro INTEGER DEFAULT 0, credits INTEGER DEFAULT 0, commercial INTEGER DEFAULT 0, marker INTEGER DEFAULT 0, '
         'initial_stream INTEGER DEFAULT 1, write_attempts INTEGER DEFAULT 0, raw_stream_info TEXT, '
         'rating_key_websocket TEXT)'
     )
@@ -1417,6 +1417,15 @@ def dbcheck():
             'ALTER TABLE sessions ADD COLUMN credits INTEGER DEFAULT 0'
         )
 
+    # Upgrade sessions table from earlier versions
+    try:
+        c_db.execute('SELECT commercial FROM sessions')
+    except sqlite3.OperationalError:
+        logger.debug(u"Altering database. Updating database table sessions.")
+        c_db.execute(
+            'ALTER TABLE sessions ADD COLUMN commercial INTEGER DEFAULT 0'
+        )
+
     # Upgrade sessions table from earlier versions
     try:
         c_db.execute('SELECT marker FROM sessions')
diff --git a/plexpy/activity_handler.py b/plexpy/activity_handler.py
index 5ed69e10..8933c1ac 100644
--- a/plexpy/activity_handler.py
+++ b/plexpy/activity_handler.py
@@ -247,13 +247,20 @@ class ActivityHandler(object):
 
     def on_intro(self, marker):
         if self.get_live_session():
-            logger.debug("Tautulli ActivityHandler :: Session %s intro marker reached." % str(self.session_key))
+            logger.debug("Tautulli ActivityHandler :: Session %s reached intro marker." % str(self.session_key))
 
             self.put_notification('on_intro', marker=marker)
 
+    def on_commercial(self, marker):
+        if self.get_live_session():
+            logger.debug("Tautulli ActivityHandler :: Session %s reached commercial marker." % str(self.session_key))
+
+            self.put_notification('on_commercial', marker=marker)
+
     def on_credits(self, marker):
         if self.get_live_session():
-            logger.debug("Tautulli ActivityHandler :: Session %s credits marker reached." % str(self.session_key))
+            logger.debug("Tautulli ActivityHandler :: Session %s reached credits marker." % str(self.session_key))
+
             self.put_notification('on_credits', marker=marker)
 
     def on_watched(self):
diff --git a/plexpy/activity_processor.py b/plexpy/activity_processor.py
index dcd1f138..a8d8cdd4 100644
--- a/plexpy/activity_processor.py
+++ b/plexpy/activity_processor.py
@@ -661,8 +661,12 @@ class ActivityProcessor(object):
                            [session['write_attempts'] + 1, session_key])
 
     def set_marker(self, session_key=None, marker_idx=None, marker_type=None):
-        marker_args = [int(marker_type == 'intro'), int(marker_type == 'credits')]
-        self.db.action('UPDATE sessions SET intro = ?, credits = ?, marker = ? '
+        marker_args = [
+            int(marker_type == 'intro'),
+            int(marker_type == 'commercial'),
+            int(marker_type == 'credits')
+        ]
+        self.db.action('UPDATE sessions SET intro = ?, commercial = ?, credits = ?, marker = ? '
                        'WHERE session_key = ?',
                        marker_args + [marker_idx, session_key])
 
diff --git a/plexpy/notification_handler.py b/plexpy/notification_handler.py
index c92415e5..4b727c5d 100644
--- a/plexpy/notification_handler.py
+++ b/plexpy/notification_handler.py
@@ -1023,8 +1023,8 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
         'live': notify_params['live'],
         'marker_start': marker['start_time_offset'],
         'marker_end': marker['end_time_offset'],
-        'credits_marker_first': int(marker['first']),
-        'credits_marker_final': int(marker['final']),
+        'credits_marker_first': helpers.cast_to_int(marker['first']),
+        'credits_marker_final': helpers.cast_to_int(marker['final']),
         'channel_call_sign': notify_params['channel_call_sign'],
         'channel_identifier': notify_params['channel_identifier'],
         'channel_thumb': notify_params['channel_thumb'],
diff --git a/plexpy/notifiers.py b/plexpy/notifiers.py
index 383f4908..d717c8f6 100644
--- a/plexpy/notifiers.py
+++ b/plexpy/notifiers.py
@@ -348,6 +348,14 @@ def available_notification_actions(agent_id=None):
                 'icon': 'fa-bookmark',
                 'media_types': ('episode',)
                 },
+               {'label': 'Commercial Marker',
+                'name': 'on_credits',
+                'description': 'Trigger a notification when a video stream reaches any commercial marker.',
+                'subject': 'Tautulli ({server_name})',
+                'body': '{user} ({player}) has reached a commercial marker for {title}.',
+                'icon': 'fa-bookmark',
+                'media_types': ('movie', 'episode')
+                },
                {'label': 'Credits Marker',
                 'name': 'on_credits',
                 'description': 'Trigger a notification when a video stream reaches any credits marker.',

From 87d3c0ae8172ca65f3168d999bdbdb920265be14 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 17 Feb 2023 18:54:52 -0800
Subject: [PATCH 316/743] Fix missing on_commercial columns in database

---
 plexpy/__init__.py  | 22 +++++++++++++++++++---
 plexpy/notifiers.py |  2 +-
 2 files changed, 20 insertions(+), 4 deletions(-)

diff --git a/plexpy/__init__.py b/plexpy/__init__.py
index d3de0815..2827c5fa 100644
--- a/plexpy/__init__.py
+++ b/plexpy/__init__.py
@@ -754,7 +754,8 @@ def dbcheck():
         'agent_id INTEGER, agent_name TEXT, agent_label TEXT, friendly_name TEXT, notifier_config TEXT, '
         'on_play INTEGER DEFAULT 0, on_stop INTEGER DEFAULT 0, on_pause INTEGER DEFAULT 0, '
         'on_resume INTEGER DEFAULT 0, on_change INTEGER DEFAULT 0, on_buffer INTEGER DEFAULT 0, '
-        'on_error INTEGER DEFAULT 0, on_intro INTEGER DEFAULT 0, on_credits INTEGER DEFAULT 0, '
+        'on_error INTEGER DEFAULT 0, '
+        'on_intro INTEGER DEFAULT 0, on_credits INTEGER DEFAULT 0, on_commercial INTEGER DEFAULT 0, '
         'on_watched INTEGER DEFAULT 0, on_created INTEGER DEFAULT 0, '
         'on_extdown INTEGER DEFAULT 0, on_intdown INTEGER DEFAULT 0, '
         'on_extup INTEGER DEFAULT 0, on_intup INTEGER DEFAULT 0, on_pmsupdate INTEGER DEFAULT 0, '
@@ -762,14 +763,14 @@ def dbcheck():
         'on_plexpydbcorrupt INTEGER DEFAULT 0, '
         'on_play_subject TEXT, on_stop_subject TEXT, on_pause_subject TEXT, '
         'on_resume_subject TEXT, on_change_subject TEXT, on_buffer_subject TEXT, on_error_subject TEXT, '
-        'on_intro_subject TEXT, on_credits_subject TEXT, '
+        'on_intro_subject TEXT, on_credits_subject TEXT, on_commercial_subject TEXT,'
         'on_watched_subject TEXT, on_created_subject TEXT, on_extdown_subject TEXT, on_intdown_subject TEXT, '
         'on_extup_subject TEXT, on_intup_subject TEXT, on_pmsupdate_subject TEXT, '
         'on_concurrent_subject TEXT, on_newdevice_subject TEXT, on_plexpyupdate_subject TEXT, '
         'on_plexpydbcorrupt_subject TEXT, '
         'on_play_body TEXT, on_stop_body TEXT, on_pause_body TEXT, '
         'on_resume_body TEXT, on_change_body TEXT, on_buffer_body TEXT, on_error_body TEXT, '
-        'on_intro_body TEXT, on_credits_body TEXT, '
+        'on_intro_body TEXT, on_credits_body TEXT, on_commercial_body TEXT, '
         'on_watched_body TEXT, on_created_body TEXT, on_extdown_body TEXT, on_intdown_body TEXT, '
         'on_extup_body TEXT, on_intup_body TEXT, on_pmsupdate_body TEXT, '
         'on_concurrent_body TEXT, on_newdevice_body TEXT, on_plexpyupdate_body TEXT, '
@@ -2429,6 +2430,21 @@ def dbcheck():
             'ALTER TABLE notifiers ADD COLUMN on_credits_body TEXT'
         )
 
+    # Upgrade notifiers table from earlier versions
+    try:
+        c_db.execute('SELECT on_commercial FROM notifiers')
+    except sqlite3.OperationalError:
+        logger.debug("Altering database. Updating database table notifiers.")
+        c_db.execute(
+            'ALTER TABLE notifiers ADD COLUMN on_commercial INTEGER DEFAULT 0'
+        )
+        c_db.execute(
+            'ALTER TABLE notifiers ADD COLUMN on_commercial_subject TEXT'
+        )
+        c_db.execute(
+            'ALTER TABLE notifiers ADD COLUMN on_commercial_body TEXT'
+        )
+
     # Upgrade tvmaze_lookup table from earlier versions
     try:
         c_db.execute('SELECT rating_key FROM tvmaze_lookup')
diff --git a/plexpy/notifiers.py b/plexpy/notifiers.py
index d717c8f6..f0f02bf0 100644
--- a/plexpy/notifiers.py
+++ b/plexpy/notifiers.py
@@ -349,7 +349,7 @@ def available_notification_actions(agent_id=None):
                 'media_types': ('episode',)
                 },
                {'label': 'Commercial Marker',
-                'name': 'on_credits',
+                'name': 'on_commercial',
                 'description': 'Trigger a notification when a video stream reaches any commercial marker.',
                 'subject': 'Tautulli ({server_name})',
                 'body': '{user} ({player}) has reached a commercial marker for {title}.',

From 6807cebe51311f599a32f5df421c2dccc6e0c498 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 17 Feb 2023 18:55:28 -0800
Subject: [PATCH 317/743] Strip whitespace from condition values

---
 plexpy/notification_handler.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/plexpy/notification_handler.py b/plexpy/notification_handler.py
index 4b727c5d..197314fc 100644
--- a/plexpy/notification_handler.py
+++ b/plexpy/notification_handler.py
@@ -294,7 +294,7 @@ def notify_custom_conditions(notifier_id=None, parameters=None):
             # Cast the condition values to the correct type
             try:
                 if parameter_type == 'str':
-                    values = ['' if v == '~' else str(v).lower() for v in values]
+                    values = ['' if v == '~' else str(v).strip().lower() for v in values]
 
                 elif parameter_type == 'int':
                     values = [helpers.cast_to_int(v) for v in values]
@@ -313,7 +313,7 @@ def notify_custom_conditions(notifier_id=None, parameters=None):
             # Cast the parameter value to the correct type
             try:
                 if parameter_type == 'str':
-                    parameter_value = str(parameter_value).lower()
+                    parameter_value = str(parameter_value).strip().lower()
 
                 elif parameter_type == 'int':
                     parameter_value = helpers.cast_to_int(parameter_value)

From c2abfce8e1bcc3a1f57a76a98e642eaa263edf6f Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 19 Feb 2023 17:41:48 -0800
Subject: [PATCH 318/743] Save credits markers offsets to session history

---
 plexpy/__init__.py           | 15 ++++++++++++++-
 plexpy/activity_processor.py | 12 +++++++++++-
 2 files changed, 25 insertions(+), 2 deletions(-)

diff --git a/plexpy/__init__.py b/plexpy/__init__.py
index 2827c5fa..d0aed7cf 100644
--- a/plexpy/__init__.py
+++ b/plexpy/__init__.py
@@ -715,7 +715,8 @@ def dbcheck():
         'art TEXT, media_type TEXT, year INTEGER, originally_available_at TEXT, added_at INTEGER, updated_at INTEGER, '
         'last_viewed_at INTEGER, content_rating TEXT, summary TEXT, tagline TEXT, rating TEXT, '
         'duration INTEGER DEFAULT 0, guid TEXT, directors TEXT, writers TEXT, actors TEXT, genres TEXT, studio TEXT, '
-        'labels TEXT, live INTEGER DEFAULT 0, channel_call_sign TEXT, channel_identifier TEXT, channel_thumb TEXT)'
+        'labels TEXT, live INTEGER DEFAULT 0, channel_call_sign TEXT, channel_identifier TEXT, channel_thumb TEXT, '
+        'marker_credits_first INTEGER DEFAULT NULL, marker_credits_final INTEGER DEFAULT NULL)'
     )
 
     # users table :: This table keeps record of the friends list
@@ -1564,6 +1565,18 @@ def dbcheck():
             'ALTER TABLE session_history_metadata ADD COLUMN channel_thumb TEXT'
         )
 
+    # Upgrade session_history_metadata table from earlier versions
+    try:
+        c_db.execute('SELECT marker_credits_first FROM session_history_metadata')
+    except sqlite3.OperationalError:
+        logger.debug("Altering database. Updating database table session_history_metadata.")
+        c_db.execute(
+            'ALTER TABLE session_history_metadata ADD COLUMN marker_credits_first INTEGER DEFAULT NULL'
+        )
+        c_db.execute(
+            'ALTER TABLE session_history_metadata ADD COLUMN marker_credits_final INTEGER DEFAULT NULL'
+        )
+
     # Upgrade session_history_media_info table from earlier versions
     try:
         c_db.execute('SELECT transcode_decision FROM session_history_media_info')
diff --git a/plexpy/activity_processor.py b/plexpy/activity_processor.py
index a8d8cdd4..d55c6738 100644
--- a/plexpy/activity_processor.py
+++ b/plexpy/activity_processor.py
@@ -490,6 +490,14 @@ class ActivityProcessor(object):
                 genres = ";".join(metadata['genres'])
                 labels = ";".join(metadata['labels'])
 
+                marker_credits_first = None
+                marker_credits_final = None
+                for marker in metadata['markers']:
+                    if marker['first']:
+                        marker_credits_first = marker['start_time_offset']
+                    if marker['final']:
+                        marker_credits_final = marker['start_time_offset']
+
                 # logger.debug("Tautulli ActivityProcessor :: Attempting to write to sessionKey %s session_history_metadata table..."
                 #              % session['session_key'])
                 keys = {'id': last_id}
@@ -528,7 +536,9 @@ class ActivityProcessor(object):
                           'live': session['live'],
                           'channel_call_sign': media_info.get('channel_call_sign', ''),
                           'channel_identifier': media_info.get('channel_identifier', ''),
-                          'channel_thumb': media_info.get('channel_thumb', '')
+                          'channel_thumb': media_info.get('channel_thumb', ''),
+                          'marker_credits_first': marker_credits_first,
+                          'marker_credits_final': marker_credits_final
                           }
 
                 # logger.debug("Tautulli ActivityProcessor :: Writing sessionKey %s session_history_metadata transaction..."

From b1dd28e39b648482cb55a0c6b8a827760b4aea90 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 20 Feb 2023 16:33:19 -0800
Subject: [PATCH 319/743] Add setting to change video watched completion
 behaviour

---
 data/interfaces/default/settings.html | 14 ++++++++++++++
 plexpy/config.py                      |  4 +++-
 2 files changed, 17 insertions(+), 1 deletion(-)

diff --git a/data/interfaces/default/settings.html b/data/interfaces/default/settings.html
index f7c24211..fd234da2 100644
--- a/data/interfaces/default/settings.html
+++ b/data/interfaces/default/settings.html
@@ -213,6 +213,20 @@
                             </div>
                             <p class="help-block">Set the percentage for a music track to be considered as listened. Minimum 50, Maximum 95.</p>
                         </div>
+                        <div class="form-group">
+                            <label for="music_watched_percent">Video Watched Completion Behaviour</label>
+                            <div class="row">
+                                <div class="col-md-7">
+                                    <select class="form-control" id="watched_marker" name="watched_marker">
+                                        <option value="0" ${'selected' if config['watched_marker'] == 0 else ''}>At selected threshold percentage</option>
+                                        <option value="1" ${'selected' if config['watched_marker'] == 1 else ''}>At final credits marker position</option>
+                                        <option value="2" ${'selected' if config['watched_marker'] == 2 else ''}>At first credits marker position</option>
+                                        <option value="3" ${'selected' if config['watched_marker'] == 3 else ''}>Earliest between threshold percent and first credits marker</option>
+                                    </select>
+                                </div>
+                            </div>
+                            <p class="help-block">Decide whether to use end credits markers to determine the 'watched' state of video items. When markers are not available the selected threshold percentage will be used.</p>
+                        </div>
                         <div class="form-group advanced-setting">
                             <label>Flush Temporary Sessions</label>
                             <p class="help-block">
diff --git a/plexpy/config.py b/plexpy/config.py
index 544cf79a..f094e88e 100644
--- a/plexpy/config.py
+++ b/plexpy/config.py
@@ -199,6 +199,7 @@ _CONFIG_DEFINITIONS = {
     'UPGRADE_FLAG': (int, 'Advanced', 0),
     'VERBOSE_LOGS': (int, 'Advanced', 1),
     'VERIFY_SSL_CERT': (bool_int, 'Advanced', 1),
+    'WATCHED_MARKER': (int, 'Monitoring', 3),
     'WEBSOCKET_MONITOR_PING_PONG': (int, 'Advanced', 0),
     'WEBSOCKET_CONNECTION_ATTEMPTS': (int, 'Advanced', 5),
     'WEBSOCKET_CONNECTION_TIMEOUT': (int, 'Advanced', 5),
@@ -298,7 +299,8 @@ SETTINGS = [
     'REFRESH_USERS_INTERVAL',
     'SHOW_ADVANCED_SETTINGS',
     'TIME_FORMAT',
-    'TV_WATCHED_PERCENT'
+    'TV_WATCHED_PERCENT',
+    'WATCHED_MARKER'
 ]
 
 CHECKED_SETTINGS = [

From b2b12044e3342ccc77dbbaa9c90771e8e13a38dd Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 20 Feb 2023 17:14:35 -0800
Subject: [PATCH 320/743] Trigger on_watched based on credits markers

---
 plexpy/activity_handler.py | 92 +++++++++++++++++++++++++-------------
 plexpy/helpers.py          | 40 +++++++++++++++++
 2 files changed, 101 insertions(+), 31 deletions(-)

diff --git a/plexpy/activity_handler.py b/plexpy/activity_handler.py
index 8933c1ac..851372d5 100644
--- a/plexpy/activity_handler.py
+++ b/plexpy/activity_handler.py
@@ -110,11 +110,13 @@ class ActivityHandler(object):
         self.set_session_state()
         self.get_db_session()
 
-    def set_session_state(self):
-        self.ap.set_session_state(session_key=self.session_key,
-                             state=self.state,
-                             view_offset=self.view_offset,
-                             stopped=helpers.timestamp())
+    def set_session_state(self, view_offset=None):
+        self.ap.set_session_state(
+            session_key=self.session_key,
+            state=self.state,
+            view_offset=view_offset or self.view_offset,
+            stopped=helpers.timestamp()
+        )
         
     def put_notification(self, notify_action, **kwargs):
         notification = {'stream_data': self.db_session.copy(), 'notify_action': notify_action}
@@ -246,26 +248,34 @@ class ActivityHandler(object):
         self.put_notification('on_change')
 
     def on_intro(self, marker):
-        if self.get_live_session():
-            logger.debug("Tautulli ActivityHandler :: Session %s reached intro marker." % str(self.session_key))
+        logger.debug("Tautulli ActivityHandler :: Session %s reached intro marker." % str(self.session_key))
 
-            self.put_notification('on_intro', marker=marker)
+        self.set_session_state(view_offset=marker['start_time_offset'])
+
+        self.put_notification('on_intro', marker=marker)
 
     def on_commercial(self, marker):
-        if self.get_live_session():
-            logger.debug("Tautulli ActivityHandler :: Session %s reached commercial marker." % str(self.session_key))
+        logger.debug("Tautulli ActivityHandler :: Session %s reached commercial marker." % str(self.session_key))
 
-            self.put_notification('on_commercial', marker=marker)
+        self.set_session_state(view_offset=marker['start_time_offset'])
+
+        self.put_notification('on_commercial', marker=marker)
 
     def on_credits(self, marker):
-        if self.get_live_session():
-            logger.debug("Tautulli ActivityHandler :: Session %s reached credits marker." % str(self.session_key))
+        logger.debug("Tautulli ActivityHandler :: Session %s reached credits marker." % str(self.session_key))
 
-            self.put_notification('on_credits', marker=marker)
+        self.set_session_state(view_offset=marker['start_time_offset'])
 
-    def on_watched(self):
+        self.put_notification('on_credits', marker=marker)
+
+    def on_watched(self, marker=None):
         logger.debug("Tautulli ActivityHandler :: Session %s watched." % str(self.session_key))
 
+        if marker:
+            self.set_session_state(view_offset=marker['start_time_offset'])
+        else:
+            self.update_db_session()
+
         watched_notifiers = notification_handler.get_notify_state_enabled(
             session=self.db_session, notify_action='on_watched', notified=False)
 
@@ -368,38 +378,58 @@ class ActivityHandler(object):
 
                 if self.db_session['marker'] != marker_idx:
                     self.ap.set_marker(session_key=self.session_key, marker_idx=marker_idx, marker_type=marker['type'])
-                    callback_func = getattr(self, 'on_{}'.format(marker['type']))
 
                     if self.view_offset < marker['start_time_offset']:
                         # Schedule a callback for the exact offset of the marker
                         schedule_callback(
                             'session_key-{}-marker-{}'.format(self.session_key, marker_idx),
-                            func=callback_func,
+                            func=self._marker_callback,
                             args=[marker],
                             milliseconds=marker['start_time_offset'] - self.view_offset
                         )
                     else:
-                        callback_func(marker)
+                        self._marker_callback(marker)
 
                 break
 
         if not marker_flag:
             self.ap.set_marker(session_key=self.session_key, marker_idx=0)
 
-    def check_watched(self):
-        # Monitor if the stream has reached the watch percentage for notifications
-        if not self.db_session['watched'] and self.timeline['state'] != 'buffering':
-            progress_percent = helpers.get_percent(self.timeline['viewOffset'], self.db_session['duration'])
-            watched_percent = {
-                'movie': plexpy.CONFIG.MOVIE_WATCHED_PERCENT,
-                'episode': plexpy.CONFIG.TV_WATCHED_PERCENT,
-                'track': plexpy.CONFIG.MUSIC_WATCHED_PERCENT,
-                'clip': plexpy.CONFIG.TV_WATCHED_PERCENT
-            }
+    def _marker_callback(self, marker):
+        if self.get_live_session():
+            # Reset ActivityProcessor object for new database thread
+            self.ap = activity_processor.ActivityProcessor()
 
-            if progress_percent >= watched_percent.get(self.db_session['media_type'], 101):
-                self.ap.set_watched(session_key=self.session_key)
-                self.on_watched()
+            if marker['type'] == 'intro':
+                self.on_intro(marker)
+            elif marker['type'] == 'commercial':
+                self.on_commercial(marker)
+            elif marker['type'] == 'credits':
+                self.on_credits(marker)
+
+                if not self.db_session['watched']:
+                    if marker['final'] and plexpy.CONFIG.WATCHED_MARKER == 1:
+                        self._marker_watched(marker)
+                    elif marker['first'] and (plexpy.CONFIG.WATCHED_MARKER in (2, 3)):
+                        self._marker_watched(marker)
+
+    def _marker_watched(self, marker):
+        if not self.db_session['watched']:
+            self._watched_callback(marker)
+
+    def check_watched(self):
+        if plexpy.CONFIG.WATCHED_MARKER == 1 or plexpy.CONFIG.WATCHED_MARKER == 2:
+            return
+
+        # Monitor if the stream has reached the watch percentage for notifications
+        if not self.db_session['watched'] and self.state != 'buffering' and helpers.check_watched(
+            self.db_session['media_type'], self.view_offset, self.db_session['duration']
+        ):
+            self._watched_callback()
+
+    def _watched_callback(self, marker=None):
+        self.ap.set_watched(session_key=self.session_key)
+        self.on_watched(marker)
 
 
 class TimelineHandler(object):
diff --git a/plexpy/helpers.py b/plexpy/helpers.py
index b0995849..89b047fd 100644
--- a/plexpy/helpers.py
+++ b/plexpy/helpers.py
@@ -1733,3 +1733,43 @@ def short_season(title):
     if title.startswith('Season ') and title[7:].isdigit():
         return 'S%s' % title[7:]
     return title
+
+
+def get_first_final_marker(markers):
+    first = None
+    final = None
+    for marker in markers:
+        if marker['first']:
+            first = marker
+        if marker['final']:
+            final = marker
+    return first, final
+
+
+def check_watched(media_type, view_offset, duration, marker_credits_first=None, marker_credits_final=None):
+    if isinstance(marker_credits_first, dict):
+        marker_credits_first = marker_credits_first['start_time_offset']
+    if isinstance(marker_credits_final, dict):
+        marker_credits_final = marker_credits_final['start_time_offset']
+
+    view_offset = cast_to_int(view_offset)
+    duration = cast_to_int(duration)
+
+    watched_percent = {
+        'movie': plexpy.CONFIG.MOVIE_WATCHED_PERCENT,
+        'episode': plexpy.CONFIG.TV_WATCHED_PERCENT,
+        'track': plexpy.CONFIG.MUSIC_WATCHED_PERCENT,
+        'clip': plexpy.CONFIG.TV_WATCHED_PERCENT
+    }
+    threshold = watched_percent.get(media_type, 0) / 100 * duration
+    if not threshold:
+        return False
+
+    if plexpy.CONFIG.WATCHED_MARKER == 1 and marker_credits_final:
+        return view_offset >= marker_credits_final
+    elif plexpy.CONFIG.WATCHED_MARKER == 2 and marker_credits_first:
+        return view_offset >= marker_credits_first
+    elif plexpy.CONFIG.WATCHED_MARKER == 3 and marker_credits_first:
+        return view_offset >= min(threshold, marker_credits_first)
+    else:
+        return view_offset >= threshold

From c5005c1ea9ec1575abd36fa51dfc9cb1d4dd8159 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 20 Feb 2023 16:36:31 -0800
Subject: [PATCH 321/743] Group watched history sessions based on credits
 markers

---
 plexpy/activity_processor.py | 16 +++++++---------
 1 file changed, 7 insertions(+), 9 deletions(-)

diff --git a/plexpy/activity_processor.py b/plexpy/activity_processor.py
index d55c6738..71b6e3e0 100644
--- a/plexpy/activity_processor.py
+++ b/plexpy/activity_processor.py
@@ -327,7 +327,7 @@ class ActivityProcessor(object):
                 # Get the last insert row id
                 last_id = self.db.last_insert_id()
                 new_session = prev_session = None
-                prev_progress_percent = media_watched_percent = 0
+                watched = False
 
                 if session['live']:
                     # Check if we should group the session, select the last guid from the user
@@ -369,12 +369,11 @@ class ActivityProcessor(object):
                                         'view_offset': result[1]['view_offset'],
                                         'reference_id': result[1]['reference_id']}
 
-                        watched_percent = {'movie': plexpy.CONFIG.MOVIE_WATCHED_PERCENT,
-                                           'episode': plexpy.CONFIG.TV_WATCHED_PERCENT,
-                                           'track': plexpy.CONFIG.MUSIC_WATCHED_PERCENT
-                                           }
-                        prev_progress_percent = helpers.get_percent(prev_session['view_offset'], session['duration'])
-                        media_watched_percent = watched_percent.get(session['media_type'], 0)
+                        marker_first, marker_final = helpers.get_first_final_marker(metadata['markers'])
+                        watched = helpers.check_watched(
+                            session['media_type'], session['view_offset'], session['duration'],
+                            marker_first, marker_final
+                        )
 
                 query = 'UPDATE session_history SET reference_id = ? WHERE id = ? '
 
@@ -384,8 +383,7 @@ class ActivityProcessor(object):
                 # else set the reference_id to the new id
                 if prev_session is None and new_session is None:
                     args = [last_id, last_id]
-                elif prev_progress_percent < media_watched_percent and \
-                        prev_session['view_offset'] <= new_session['view_offset'] or \
+                elif watched and prev_session['view_offset'] <= new_session['view_offset'] or \
                         session['live'] and prev_session['guid'] == new_session['guid']:
                     args = [prev_session['reference_id'], new_session['id']]
                 else:

From 928e1d4b5edb2adec3049e38cccf3717463f65c2 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 20 Feb 2023 16:37:37 -0800
Subject: [PATCH 322/743] History table watched status based on credits markers

---
 plexpy/datafactory.py | 21 ++++++++++++++++-----
 1 file changed, 16 insertions(+), 5 deletions(-)

diff --git a/plexpy/datafactory.py b/plexpy/datafactory.py
index cf55a2c0..e0e9fdee 100644
--- a/plexpy/datafactory.py
+++ b/plexpy/datafactory.py
@@ -99,8 +99,9 @@ class DataFactory(object):
             'MIN(started) AS started',
             'MAX(stopped) AS stopped',
             'SUM(CASE WHEN stopped > 0 THEN (stopped - started) ELSE 0 END) - \
-             SUM(CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) AS duration',
+             SUM(CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) AS play_duration',
             'SUM(CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) AS paused_counter',
+            'session_history.view_offset',
             'session_history.user_id',
             'session_history.user',
             '(CASE WHEN users.friendly_name IS NULL OR TRIM(users.friendly_name) = "" \
@@ -139,6 +140,9 @@ class DataFactory(object):
             'MAX((CASE WHEN (view_offset IS NULL OR view_offset = "") THEN 0.1 ELSE view_offset * 1.0 END) / \
              (CASE WHEN (session_history_metadata.duration IS NULL OR session_history_metadata.duration = "") \
              THEN 1.0 ELSE session_history_metadata.duration * 1.0 END) * 100) AS percent_complete',
+            'session_history_metadata.duration',
+            'session_history_metadata.marker_credits_first',
+            'session_history_metadata.marker_credits_final',
             'session_history_media_info.transcode_decision',
             'COUNT(*) AS group_count',
             'GROUP_CONCAT(session_history.id) AS group_ids',
@@ -159,8 +163,9 @@ class DataFactory(object):
                 'started',
                 'stopped',
                 'SUM(CASE WHEN stopped > 0 THEN (stopped - started) ELSE (strftime("%s", "now") - started) END) - \
-                 SUM(CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) AS duration',
+                 SUM(CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) AS play_duration',
                 'SUM(CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) AS paused_counter',
+                'view_offset',
                 'user_id',
                 'user',
                 '(CASE WHEN friendly_name IS NULL OR TRIM(friendly_name) = "" \
@@ -198,6 +203,9 @@ class DataFactory(object):
                 'MAX((CASE WHEN (view_offset IS NULL OR view_offset = "") THEN 0.1 ELSE view_offset * 1.0 END) / \
                  (CASE WHEN (duration IS NULL OR duration = "") \
                  THEN 1.0 ELSE duration * 1.0 END) * 100) AS percent_complete',
+                'duration',
+                'NULL AS marker_credits_first',
+                'NULL AS marker_credits_final',
                 'transcode_decision',
                 'NULL AS group_count',
                 'NULL AS group_ids',
@@ -262,7 +270,7 @@ class DataFactory(object):
 
                 item['user_thumb'] = users_lookup.get(item['user_id'])
 
-            filter_duration += int(item['duration'])
+            filter_duration += int(item['play_duration'])
 
             if item['media_type'] == 'episode' and item['parent_thumb']:
                 thumb = item['parent_thumb']
@@ -274,7 +282,10 @@ class DataFactory(object):
             if item['live']:
                 item['percent_complete'] = 100
 
-            if item['percent_complete'] >= watched_percent[item['media_type']]:
+            if helpers.check_watched(
+                item['media_type'], item['view_offset'], item['duration'],
+                item['marker_credits_first'], item['marker_credits_final']
+            ):
                 watched_status = 1
             elif item['percent_complete'] >= watched_percent[item['media_type']] / 2.0:
                 watched_status = 0.5
@@ -297,7 +308,7 @@ class DataFactory(object):
                    'date': item['date'],
                    'started': item['started'],
                    'stopped': item['stopped'],
-                   'duration': item['duration'],
+                   'duration': item['play_duration'],
                    'paused_counter': item['paused_counter'],
                    'user_id': item['user_id'],
                    'user': item['user'],

From 2a1bf7847b32f01059d990f564ce89777ed7751e Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 20 Feb 2023 18:35:55 -0800
Subject: [PATCH 323/743] Last watched statistics card based on credits markers

---
 plexpy/datafactory.py | 60 ++++++++++++++++++++++++++++++++++---------
 1 file changed, 48 insertions(+), 12 deletions(-)

diff --git a/plexpy/datafactory.py b/plexpy/datafactory.py
index e0e9fdee..e51b8a46 100644
--- a/plexpy/datafactory.py
+++ b/plexpy/datafactory.py
@@ -382,10 +382,6 @@ class DataFactory(object):
         if user_id:
             where_id += 'AND session_history.user_id = %s ' % user_id
 
-        movie_watched_percent = plexpy.CONFIG.MOVIE_WATCHED_PERCENT
-        tv_watched_percent = plexpy.CONFIG.TV_WATCHED_PERCENT
-        music_watched_percent = plexpy.CONFIG.MUSIC_WATCHED_PERCENT
-
         group_by = 'session_history.reference_id' if grouping else 'session_history.id'
         sort_type = 'total_duration' if stats_type == 'duration' else 'total_plays'
 
@@ -919,6 +915,43 @@ class DataFactory(object):
                                    'rows': session.mask_session_info(top_platform, mask_metadata=False)})
 
             elif stat == 'last_watched':
+
+                movie_watched_percent = plexpy.CONFIG.MOVIE_WATCHED_PERCENT
+                tv_watched_percent = plexpy.CONFIG.TV_WATCHED_PERCENT
+
+                if plexpy.CONFIG.WATCHED_MARKER == 1:
+                    watched_threshold = (
+                        '(CASE WHEN shm.marker_credits_final IS NULL '
+                        'THEN sh._duration * (CASE WHEN sh.media_type = "movie" THEN %d ELSE %d END) / 100.0 '
+                        'ELSE shm.marker_credits_final END) '
+                        'AS watched_threshold'
+                    ) % (movie_watched_percent, tv_watched_percent)
+                    watched_where = '_view_offset >= watched_threshold'
+                elif plexpy.CONFIG.WATCHED_MARKER == 2:
+                    watched_threshold = (
+                        '(CASE WHEN shm.marker_credits_first IS NULL '
+                        'THEN sh._duration * (CASE WHEN sh.media_type = "movie" THEN %d ELSE %d END) / 100.0 '
+                        'ELSE shm.marker_credits_first END) '
+                        'AS watched_threshold'
+                    ) % (movie_watched_percent, tv_watched_percent)
+                    watched_where = '_view_offset >= watched_threshold'
+                elif plexpy.CONFIG.WATCHED_MARKER == 3:
+                    watched_threshold = (
+                        'MIN('
+                        '(CASE WHEN shm.marker_credits_first IS NULL '
+                        'THEN sh._duration * (CASE WHEN sh.media_type = "movie" THEN %d ELSE %d END) / 100.0 '
+                        'ELSE shm.marker_credits_first END), '
+                        'sh._duration * (CASE WHEN sh.media_type = "movie" THEN %d ELSE %d END) / 100.0) '
+                        'AS watched_threshold'
+                    ) % (movie_watched_percent, tv_watched_percent, movie_watched_percent, tv_watched_percent)
+                    watched_where = '_view_offset >= watched_threshold'
+                else:
+                    watched_threshold = 'NULL AS watched_threshold'
+                    watched_where = (
+                        'sh.media_type == "movie" AND percent_complete >= %d '
+                        'OR sh.media_type == "episode" AND percent_complete >= %d'
+                    ) % (movie_watched_percent, tv_watched_percent)
+
                 last_watched = []
                 try:
                     query = 'SELECT sh.id, shm.title, shm.grandparent_title, shm.full_title, shm.year, ' \
@@ -929,22 +962,25 @@ class DataFactory(object):
                             '(CASE WHEN u.friendly_name IS NULL OR TRIM(u.friendly_name) = ""' \
                             '   THEN u.username ELSE u.friendly_name END) ' \
                             '   AS friendly_name, ' \
-                            'MAX(sh.started) AS last_watch, ' \
-                            '((CASE WHEN sh.view_offset IS NULL THEN 0.1 ELSE sh.view_offset * 1.0 END) / ' \
-                            '   (CASE WHEN shm.duration IS NULL THEN 1.0 ELSE shm.duration * 1.0 END) * 100) ' \
-                            '   AS percent_complete ' \
-                            'FROM (SELECT *, MAX(id) FROM session_history ' \
+                            'MAX(sh.started) AS last_watch, sh._view_offset, sh._duration, ' \
+                            '(sh._view_offset / sh._duration * 100) AS percent_complete, ' \
+                            '%s ' \
+                            'FROM (SELECT *, MAX(session_history.id), ' \
+                            '   (CASE WHEN view_offset IS NULL THEN 0.1 ELSE view_offset * 1.0 END) AS _view_offset, ' \
+                            '   (CASE WHEN duration IS NULL THEN 1.0 ELSE duration * 1.0 END) AS _duration ' \
+                            '   FROM session_history ' \
+                            '   JOIN session_history_metadata ON session_history_metadata.id = session_history.id ' \
                             '   WHERE session_history.stopped >= %s ' \
                             '       AND (session_history.media_type = "movie" ' \
                             '           OR session_history.media_type = "episode") %s ' \
                             '   GROUP BY %s) AS sh ' \
                             'JOIN session_history_metadata AS shm ON shm.id = sh.id ' \
                             'LEFT OUTER JOIN users AS u ON sh.user_id = u.user_id ' \
-                            'WHERE sh.media_type == "movie" AND percent_complete >= %s ' \
-                            '   OR sh.media_type == "episode" AND percent_complete >= %s ' \
+                            'WHERE %s ' \
                             'GROUP BY sh.id ' \
                             'ORDER BY last_watch DESC ' \
-                            'LIMIT %s OFFSET %s' % (timestamp, where_id, group_by, movie_watched_percent, tv_watched_percent,
+                            'LIMIT %s OFFSET %s' % (watched_threshold,
+                                                    timestamp, where_id, group_by, watched_where,
                                                     stats_count, stats_start)
                     result = monitor_db.select(query)
                 except Exception as e:

From ebe570d42f9a2e70a7bdbb7db2cdcf8577fc70f5 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 21 Feb 2023 11:12:56 -0800
Subject: [PATCH 324/743] Allow setting a custom Pushover sound

* Closes #2005
---
 data/interfaces/default/css/tautulli.css      |  2 -
 .../interfaces/default/newsletter_config.html |  4 ++
 data/interfaces/default/notifier_config.html  | 10 +++
 plexpy/newsletters.py                         |  3 +-
 plexpy/notifiers.py                           | 69 ++++++++++---------
 5 files changed, 54 insertions(+), 34 deletions(-)

diff --git a/data/interfaces/default/css/tautulli.css b/data/interfaces/default/css/tautulli.css
index ac99ae76..5f1d90a0 100644
--- a/data/interfaces/default/css/tautulli.css
+++ b/data/interfaces/default/css/tautulli.css
@@ -79,7 +79,6 @@ select.form-control {
     color: #eee !important;
     border: 0px solid #444 !important;
     background: #555 !important;
-    padding: 1px 2px;
     transition: background-color .3s;
 }
 .selectize-control.form-control .selectize-input {
@@ -87,7 +86,6 @@ select.form-control {
     align-items: center;
     flex-wrap: wrap;
     margin-bottom: 4px;
-    padding-left: 5px;
 }
 .selectize-control.form-control.selectize-pms-ip .selectize-input {
     padding-left: 12px !important;
diff --git a/data/interfaces/default/newsletter_config.html b/data/interfaces/default/newsletter_config.html
index dc6de294..10583707 100644
--- a/data/interfaces/default/newsletter_config.html
+++ b/data/interfaces/default/newsletter_config.html
@@ -142,8 +142,10 @@
                                         <div class="row">
                                             <div class="col-md-12">
                                                 <select class="form-control" id="${item['name']}" name="${item['name']}">
+                                                    % if item['select_all']:
                                                     <option value="select-all">Select All</option>
                                                     <option value="remove-all">Remove All</option>
+                                                    % endif
                                                     % if isinstance(item['select_options'], dict):
                                                     % for section, options in item['select_options'].items():
                                                     <optgroup label="${section}">
@@ -153,7 +155,9 @@
                                                     </optgroup>
                                                     % endfor
                                                     % else:
+                                                    % if item['select_all']:
                                                     <option value="border-all"></option>
+                                                    % endif
                                                     % for option in sorted(item['select_options'], key=lambda x: x['text'].lower()):
                                                         <option value="${option['value']}">${option['text']}</option>
                                                     % endfor
diff --git a/data/interfaces/default/notifier_config.html b/data/interfaces/default/notifier_config.html
index 3aa68bb5..f023491f 100644
--- a/data/interfaces/default/notifier_config.html
+++ b/data/interfaces/default/notifier_config.html
@@ -134,8 +134,10 @@
                                         <div class="row">
                                             <div class="col-md-12">
                                                 <select class="form-control" id="${item['name']}" name="${item['name']}">
+                                                    % if item['select_all']:
                                                     <option value="select-all">Select All</option>
                                                     <option value="remove-all">Remove All</option>
+                                                    % endif
                                                     % if isinstance(item['select_options'], dict):
                                                     % for section, options in item['select_options'].items():
                                                     <optgroup label="${section}">
@@ -145,7 +147,9 @@
                                                     </optgroup>
                                                     % endfor
                                                     % else:
+                                                    % if item['select_all']:
                                                     <option value="border-all"></option>
+                                                    % endif
                                                     % for option in sorted(item['select_options'], key=lambda x: x['text'].lower()):
                                                         <option value="${option['value']}">${option['text']}</option>
                                                     % endfor
@@ -718,6 +722,12 @@
     $('#pushover_priority').change( function () {
         pushoverPriority();
     });
+    
+    var $pushover_sound = $('#pushover_sound').selectize({
+        create: true
+    });
+    var pushover_sound = $pushover_sound[0].selectize;
+    pushover_sound.setValue(${json.dumps(next((c['value'] for c in notifier['config_options'] if c['name'] == 'pushover_sound'), [])) | n});
 
     % elif notifier['agent_name'] == 'plexmobileapp':
     var $plexmobileapp_user_ids = $('#plexmobileapp_user_ids').selectize({
diff --git a/plexpy/newsletters.py b/plexpy/newsletters.py
index 902eb69b..fdc1c5a8 100644
--- a/plexpy/newsletters.py
+++ b/plexpy/newsletters.py
@@ -971,7 +971,8 @@ class RecentlyAdded(Newsletter):
              'description': 'Select the libraries to include in the newsletter.',
              'name': 'newsletter_config_incl_libraries',
              'input_type': 'selectize',
-             'select_options': self._get_sections_options()
+             'select_options': self._get_sections_options(),
+             'select_all': True
              }
         ]
 
diff --git a/plexpy/notifiers.py b/plexpy/notifiers.py
index f0f02bf0..1a747be9 100644
--- a/plexpy/notifiers.py
+++ b/plexpy/notifiers.py
@@ -1435,21 +1435,24 @@ class EMAIL(Notifier):
                           'name': 'email_to',
                           'description': 'The email address(es) of the recipients.',
                           'input_type': 'selectize',
-                          'select_options': user_emails_to
+                          'select_options': user_emails_to,
+                          'select_all': True
                           },
                          {'label': 'CC',
                           'value': self.config['cc'],
                           'name': 'email_cc',
                           'description': 'The email address(es) to CC.',
                           'input_type': 'selectize',
-                          'select_options': user_emails_cc
+                          'select_options': user_emails_cc,
+                          'select_all': True
                           },
                          {'label': 'BCC',
                           'value': self.config['bcc'],
                           'name': 'email_bcc',
                           'description': 'The email address(es) to BCC.',
                           'input_type': 'selectize',
-                          'select_options': user_emails_bcc
+                          'select_options': user_emails_bcc,
+                          'select_all': True
                           },
                          {'label': 'SMTP Server',
                           'value': self.config['smtp_server'],
@@ -3216,31 +3219,34 @@ class PUSHOVER(Notifier):
         return self.make_request('https://api.pushover.net/1/messages.json', headers=headers, data=data, files=files)
 
     def get_sounds(self):
-        sounds = {
-            '': '',
-            'alien': 'Alien Alarm (long)',
-            'bike': 'Bike',
-            'bugle': 'Bugle',
-            'cashregister': 'Cash Register',
-            'classical': 'Classical',
-            'climb': 'Climb (long)',
-            'cosmic': 'Cosmic',
-            'echo': 'Pushover Echo (long)',
-            'falling': 'Falling',
-            'gamelan': 'Gamelan',
-            'incoming': 'Incoming',
-            'intermission': 'Intermission',
-            'magic': 'Magic',
-            'mechanical': 'Mechanical',
-            'none': 'None (silent)',
-            'persistent': 'Persistent (long)',
-            'pianobar': 'Piano Bar',
-            'pushover': 'Pushover (default)',
-            'siren': 'Siren',
-            'spacealarm': 'Space Alarm',
-            'tugboat': 'Tug Boat',
-            'updown': 'Up Down (long)'
-        }
+        sounds = [
+            {'value': '', 'text': ''},
+            {'value': 'alien', 'text': 'Alien Alarm (long)'},
+            {'value': 'bike', 'text': 'Bike'},
+            {'value': 'bugle', 'text': 'Bugle'},
+            {'value': 'cashregister', 'text': 'Cash Register'},
+            {'value': 'classical', 'text': 'Classical'},
+            {'value': 'climb', 'text': 'Climb (long)'},
+            {'value': 'cosmic', 'text': 'Cosmic'},
+            {'value': 'echo', 'text': 'Pushover Echo (long)'},
+            {'value': 'falling', 'text': 'Falling'},
+            {'value': 'gamelan', 'text': 'Gamelan'},
+            {'value': 'incoming', 'text': 'Incoming'},
+            {'value': 'intermission', 'text': 'Intermission'},
+            {'value': 'magic', 'text': 'Magic'},
+            {'value': 'mechanical', 'text': 'Mechanical'},
+            {'value': 'none', 'text': 'None (silent)'},
+            {'value': 'persistent', 'text': 'Persistent (long)'},
+            {'value': 'pianobar', 'text': 'Piano Bar'},
+            {'value': 'pushover', 'text': 'Pushover (default)'},
+            {'value': 'siren', 'text': 'Siren'},
+            {'value': 'spacealarm', 'text': 'Space Alarm'},
+            {'value': 'tugboat', 'text': 'Tug Boat'},
+            {'value': 'updown', 'text': 'Up Down (long)'},
+            {'value': 'vibrate', 'text': 'Vibrate Only'},
+        ]
+        if self.config['sound'] not in [s['value'] for s in sounds]:
+            sounds.append({'value': self.config['sound'], 'text': self.config['sound']})
 
         return sounds
 
@@ -3281,9 +3287,10 @@ class PUSHOVER(Notifier):
                          {'label': 'Sound',
                           'value': self.config['sound'],
                           'name': 'pushover_sound',
-                          'description': 'Set the notification sound. Leave blank for the default sound.',
-                          'input_type': 'select',
-                          'select_options': self.get_sounds()
+                          'description': 'Select a notification sound or enter a custom sound name. Leave blank for the default sound.',
+                          'input_type': 'selectize',
+                          'select_options': self.get_sounds(),
+                          'select_all': False
                           },
                          {'label': 'Priority',
                           'value': self.config['priority'],

From e6d1712afdec09630c1a141afc47a826175d51b9 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 25 Feb 2023 16:35:48 -0800
Subject: [PATCH 325/743] Fix styling on collection info pages

---
 data/interfaces/default/info.html             | 12 ++---
 .../default/info_children_list.html           | 48 ++++++++++++++++++-
 .../default/js/tables/collections_table.js    |  7 ++-
 plexpy/pmsconnect.py                          |  2 +-
 4 files changed, 60 insertions(+), 9 deletions(-)

diff --git a/data/interfaces/default/info.html b/data/interfaces/default/info.html
index a7acb11b..05bccf52 100644
--- a/data/interfaces/default/info.html
+++ b/data/interfaces/default/info.html
@@ -213,7 +213,7 @@ DOCUMENTATION :: END
                             % if _session['user_group'] == 'admin':
                             <span class="overlay-refresh-image" title="Refresh image"><i class="fa fa-refresh refresh_pms_image"></i></span>
                             % endif
-                            % elif data['media_type'] in ('artist', 'album', 'track', 'playlist', 'photo_album', 'photo', 'clip'):
+                            % elif data['media_type'] in ('artist', 'album', 'track', 'playlist', 'photo_album', 'photo', 'clip') or data['sub_media_type'] in ('artist', 'album', 'track'):
                             <div class="summary-poster-face-track" style="background-image: url(${page('pms_image_proxy', data['thumb'], data['rating_key'], 300, 300, fallback='cover')});">
                                 <div class="summary-poster-face-overlay">
                                     <span></span>
@@ -283,14 +283,14 @@ DOCUMENTATION :: END
                         padding_height = ''
                         if data['media_type'] == 'movie' or data['live']:
                             padding_height = 'height: 305px;'
-                        elif data['media_type'] in ('show', 'season', 'collection'):
-                            padding_height = 'height: 270px;'
-                        elif data['media_type'] == 'episode':
-                            padding_height = 'height: 70px;'
-                        elif data['media_type'] in ('artist', 'album', 'playlist', 'photo_album', 'photo'):
+                        elif data['media_type'] in ('artist', 'album', 'playlist', 'photo_album', 'photo') or data['sub_media_type'] in ('artist', 'album', 'track'):
                             padding_height = 'height: 150px;'
                         elif data['media_type'] in ('track', 'clip'):
                             padding_height = 'height: 180px;'
+                        elif data['media_type'] == 'episode':
+                            padding_height = 'height: 70px;'
+                        elif data['media_type'] in ('show', 'season', 'collection'):
+                            padding_height = 'height: 270px;'
                     %>
                     <div class="summary-content-padding hidden-xs hidden-sm" style="${padding_height}">
                         % if data['media_type'] in ('movie', 'episode', 'track', 'clip'):
diff --git a/data/interfaces/default/info_children_list.html b/data/interfaces/default/info_children_list.html
index 14f85275..d7998071 100644
--- a/data/interfaces/default/info_children_list.html
+++ b/data/interfaces/default/info_children_list.html
@@ -160,6 +160,16 @@ DOCUMENTATION :: END
                     % endif
                 </div>
             </a>
+            <div class="item-children-instance-text-wrapper poster-item">
+                <h3>
+                     <a href="${page('info', child['rating_key'])}" title="${child['title']}">${child['title']}</a>
+                </h3>
+                % if media_type == 'collection':
+                <h3 class="text-muted">
+                    <a class="text-muted" href="${page('info', child['parent_rating_key'])}" title="${child['parent_title']}">${child['parent_title']}</a>
+                </h3>
+                % endif
+            </div>
             % elif child['media_type'] == 'episode':
             <a href="${page('info', child['rating_key'])}" title="Episode ${child['media_index']}">
                 <div class="item-children-poster">
@@ -179,6 +189,29 @@ DOCUMENTATION :: END
                 <h3>
                      <a href="${page('info', child['rating_key'])}" title="${child['title']}">${child['title']}</a>
                 </h3>
+                % if media_type == 'collection':
+                <h3 class="text-muted">
+                    <a href="${page('info', child['grandparent_rating_key'])}" title="${child['grandparent_title']}">${child['grandparent_title']}</a>
+                </h3>
+                <h3 class="text-muted">
+                    <a href="${page('info', child['parent_rating_key'])}" title="${child['parent_title']}">${short_season(child['parent_title'])}</a>
+                        &middot; <a href="${page('info', child['rating_key'])}" title="Episode ${child['media_index']}">E${child['media_index']}</a>
+                </h3>
+                % endif
+            </div>
+            % elif child['media_type'] == 'artist':
+            <a href="${page('info', child['rating_key'])}" title="${child['title']}">
+                <div class="item-children-poster">
+                    <div class="item-children-poster-face cover-item" style="background-image: url(${page('pms_image_proxy', child['thumb'], child['rating_key'], 300, 300, fallback='cover')});"></div>
+                    % if _session['user_group'] == 'admin':
+                    <span class="overlay-refresh-image" title="Refresh image"><i class="fa fa-refresh refresh_pms_image"></i></span>
+                    % endif
+                </div>
+            </a>
+            <div class="item-children-instance-text-wrapper cover-item">
+                <h3>
+                    <a href="${page('info', child['rating_key'])}" title="${child['title']}">${child['title']}</a>
+                </h3>
             </div>
             % elif child['media_type'] == 'album':
             <a href="${page('info', child['rating_key'])}" title="${child['title']}">
@@ -193,6 +226,11 @@ DOCUMENTATION :: END
                 <h3>
                     <a href="${page('info', child['rating_key'])}" title="${child['title']}">${child['title']}</a>
                 </h3>
+                % if media_type == 'collection':
+                <h3 class="text-muted">
+                    <a class="text-muted" href="${page('info', child['parent_rating_key'])}" title="${child['parent_title']}">${child['parent_title']}</a>
+                </h3>
+                % endif
             </div>
             % elif child['media_type'] == 'track':
                 <% e = 'even' if loop.index % 2 == 0 else 'odd' %>
@@ -205,7 +243,15 @@ DOCUMENTATION :: END
                                 ${child['title']}
                             </span>
                         </a>
-                        % if child['original_title']:
+                        % if media_type == 'collection':
+                        -
+                        <a href="${page('info', child['grandparent_rating_key'])}" title="${child['grandparent_title']}">
+                            <span class="thumb-tooltip" data-toggle="popover" data-img="${page('pms_image_proxy', child['grandparent_thumb'], child['grandparent_rating_key'], 300, 300, fallback='cover')}" data-height="80" data-width="80">
+                                ${child['grandparent_title']}
+                            </span>
+                        </a>
+                        <span class="text-muted"> (<a class="no-highlight" href="${page('info', child['parent_rating_key'])}" title="${child['parent_title']}">${child['parent_title']}</a>)</span>
+                        % elif child['original_title']:
                         <span class="text-muted"> - ${child['original_title']}</span>
                         % endif
                     </span>
diff --git a/data/interfaces/default/js/tables/collections_table.js b/data/interfaces/default/js/tables/collections_table.js
index b768c2d3..91eb68ab 100644
--- a/data/interfaces/default/js/tables/collections_table.js
+++ b/data/interfaces/default/js/tables/collections_table.js
@@ -32,7 +32,12 @@ collections_table_options = {
                     if (rowData['smart']) {
                         smart = '<span class="media-type-tooltip" data-toggle="tooltip" title="Smart Collection"><i class="fa fa-cog fa-fw"></i></span>&nbsp;'
                     }
-                    var thumb_popover = '<span class="thumb-tooltip" data-toggle="popover" data-img="' + page('pms_image_proxy', rowData['thumb'], rowData['ratingKey'], 300, 450, null, null, null, 'poster') + '" data-height="120" data-width="80">' + rowData['title'] + '</span>';
+                    console.log(rowData['subtype'])
+                    if (rowData['subtype'] === 'artist' || rowData['subtype'] === 'album' || rowData['subtype'] === 'track') {
+                        var thumb_popover = '<span class="thumb-tooltip" data-toggle="popover" data-img="' + page('pms_image_proxy', rowData['thumb'], rowData['ratingKey'], 300, 300, null, null, null, 'cover') + '" data-height="80" data-width="80">' + rowData['title'] + '</span>';
+                    } else {
+                        var thumb_popover = '<span class="thumb-tooltip" data-toggle="popover" data-img="' + page('pms_image_proxy', rowData['thumb'], rowData['ratingKey'], 300, 450, null, null, null, 'poster') + '" data-height="120" data-width="80">' + rowData['title'] + '</span>';
+                    }
                     $(td).html(smart + '<a href="' + page('info', rowData['ratingKey']) + '">' + thumb_popover + '</a>');
                 }
             },
diff --git a/plexpy/pmsconnect.py b/plexpy/pmsconnect.py
index 347de513..1d161a04 100644
--- a/plexpy/pmsconnect.py
+++ b/plexpy/pmsconnect.py
@@ -2545,7 +2545,7 @@ class PmsConnect(object):
                     children_list.append(children_output)
 
         output = {'children_count': helpers.cast_to_int(helpers.get_xml_attr(xml_head[0], 'size')),
-                  'children_type': helpers.get_xml_attr(xml_head[0], 'viewGroup'),
+                  'children_type': helpers.get_xml_attr(xml_head[0], 'viewGroup') or (children_list[0]['media_type'] if children_list else ''),
                   'title': helpers.get_xml_attr(xml_head[0], 'title2'),
                   'children_list': children_list
                   }

From ecb6d8b74329ea07ca651a4b83efc9a024c3cd0a Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 25 Feb 2023 16:43:14 -0800
Subject: [PATCH 326/743] Move track artist to details tag on info page

---
 data/interfaces/default/info.html | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/data/interfaces/default/info.html b/data/interfaces/default/info.html
index 05bccf52..dbce734b 100644
--- a/data/interfaces/default/info.html
+++ b/data/interfaces/default/info.html
@@ -267,7 +267,7 @@ DOCUMENTATION :: END
                         <h1><a href="${page('info', data['parent_rating_key'])}">${data['parent_title']}</a></h1>
                         <h2>${data['title']}</h2>
                         % elif data['media_type'] == 'track':
-                        <h1><a href="${page('info', data['grandparent_rating_key'])}">${data['original_title'] or data['grandparent_title']}</a></h1>
+                        <h1><a href="${page('info', data['grandparent_rating_key'])}">${data['grandparent_title']}</a></h1>
                         <h2><a href="${page('info', data['parent_rating_key'])}">${data['parent_title']}</a> - ${data['title']}</h2>
                         <h3 class="hidden-xs">T${data['media_index']}</h3>
                         % elif data['media_type'] in ('photo', 'clip'):
@@ -369,6 +369,11 @@ DOCUMENTATION :: END
                                 Studio <strong> ${data['studio']}</strong>
                                 % endif
                             </div>
+                            <div class="summary-content-details-tag">
+                                % if data['media_type'] == 'track' and data['original_title']:
+                                Track Artists <strong> ${data['original_title']}</strong>
+                                % endif
+                            </div>
                             <div class="summary-content-details-tag">
                                 % if data['media_type'] == 'movie':
                                 Year <strong> ${data['year']}</strong>
@@ -812,7 +817,7 @@ DOCUMENTATION :: END
                         % elif data['media_type'] == 'album':
                         ${data['parent_title']}<br />${data['title']}
                         % elif data['media_type'] == 'track':
-                        ${data['original_title'] or data['grandparent_title']}<br />${data['title']}<br />${data['parent_title']}
+                        ${data['grandparent_title']}<br />${data['title']}<br />${data['parent_title']}
                         % endif
                     </strong>
                 </p>

From 42eeb90532289f30a19ee4bdb1c79ffc0e4b2cf4 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 26 Feb 2023 15:09:12 -0800
Subject: [PATCH 327/743] Add ga4mp library

* Remove UniversalAnalytics
---
 lib/UniversalAnalytics/HTTPLog.py  | 121 --------
 lib/UniversalAnalytics/Tracker.py  | 424 -----------------------------
 lib/UniversalAnalytics/__init__.py |   1 -
 lib/ga4mp/__init__.py              |   3 +
 lib/ga4mp/event.py                 |  44 +++
 lib/ga4mp/ga4mp.py                 | 416 ++++++++++++++++++++++++++++
 lib/ga4mp/item.py                  |  11 +
 lib/ga4mp/store.py                 | 116 ++++++++
 lib/ga4mp/utils.py                 | 392 ++++++++++++++++++++++++++
 requirements.txt                   |   1 +
 10 files changed, 983 insertions(+), 546 deletions(-)
 delete mode 100644 lib/UniversalAnalytics/HTTPLog.py
 delete mode 100644 lib/UniversalAnalytics/Tracker.py
 delete mode 100644 lib/UniversalAnalytics/__init__.py
 create mode 100644 lib/ga4mp/__init__.py
 create mode 100644 lib/ga4mp/event.py
 create mode 100644 lib/ga4mp/ga4mp.py
 create mode 100644 lib/ga4mp/item.py
 create mode 100644 lib/ga4mp/store.py
 create mode 100644 lib/ga4mp/utils.py

diff --git a/lib/UniversalAnalytics/HTTPLog.py b/lib/UniversalAnalytics/HTTPLog.py
deleted file mode 100644
index a8fc906d..00000000
--- a/lib/UniversalAnalytics/HTTPLog.py
+++ /dev/null
@@ -1,121 +0,0 @@
-#!/usr/bin/python
-###############################################################################
-# Formatting filter for urllib2's HTTPHandler(debuglevel=1) output
-# Copyright (c) 2013, Analytics Pros
-# 
-# This project is free software, distributed under the BSD license. 
-# Analytics Pros offers consulting and integration services if your firm needs 
-# assistance in strategy, implementation, or auditing existing work.
-###############################################################################
-
-
-import sys, re, os
-from io import StringIO
-
-
-
-class BufferTranslator(object):
-    """ Provides a buffer-compatible interface for filtering buffer content.
-    """
-    parsers = []
-
-    def __init__(self, output):
-        self.output = output
-        self.encoding = getattr(output, 'encoding', None)
-
-    def write(self, content):
-        content = self.translate(content)
-        self.output.write(content)
-
-
-    @staticmethod
-    def stripslashes(content):
-        return content.decode('string_escape')
-
-    @staticmethod
-    def addslashes(content):
-        return content.encode('string_escape')
-
-    def translate(self, line):
-        for pattern, method in self.parsers:
-            match = pattern.match(line)
-            if match:
-                return method(match)
-            
-        return line
-            
-
-
-class LineBufferTranslator(BufferTranslator):
-    """ Line buffer implementation supports translation of line-format input
-        even when input is not already line-buffered. Caches input until newlines 
-        occur, and then dispatches translated input to output buffer.
-    """
-    def __init__(self, *a, **kw):
-        self._linepending = []
-        super(LineBufferTranslator, self).__init__(*a, **kw)
-    
-    def write(self, _input):
-        lines = _input.splitlines(True)
-        for i in range(0, len(lines)):
-            last = i
-            if lines[i].endswith('\n'):
-                prefix = len(self._linepending) and ''.join(self._linepending) or ''
-                self.output.write(self.translate(prefix + lines[i]))
-                del self._linepending[0:]
-                last = -1
-                
-        if last >= 0:
-            self._linepending.append(lines[ last ])
-
-
-    def __del__(self):
-        if len(self._linepending):
-            self.output.write(self.translate(''.join(self._linepending)))
-
-
-class HTTPTranslator(LineBufferTranslator):
-    """ Translates output from |urllib2| HTTPHandler(debuglevel = 1) into
-        HTTP-compatible, readible text structures for human analysis.
-    """
-
-    RE_LINE_PARSER = re.compile(r'^(?:([a-z]+):)\s*(\'?)([^\r\n]*)\2(?:[\r\n]*)$')
-    RE_LINE_BREAK = re.compile(r'(\r?\n|(?:\\r)?\\n)')
-    RE_HTTP_METHOD = re.compile(r'^(POST|GET|HEAD|DELETE|PUT|TRACE|OPTIONS)')
-    RE_PARAMETER_SPACER = re.compile(r'&([a-z0-9]+)=')
-
-    @classmethod
-    def spacer(cls, line):
-        return cls.RE_PARAMETER_SPACER.sub(r' &\1= ', line)
-
-    def translate(self, line):
-
-        parsed = self.RE_LINE_PARSER.match(line)
-
-        if parsed:
-            value = parsed.group(3)
-            stage = parsed.group(1)
-
-            if stage == 'send': # query string is rendered here
-                return '\n# HTTP Request:\n' + self.stripslashes(value)
-            elif stage == 'reply':
-                return '\n\n# HTTP Response:\n' + self.stripslashes(value)
-            elif stage == 'header':
-                return value + '\n'
-            else:
-                return value
-
-
-        return line
-
-
-def consume(outbuffer = None): # Capture standard output
-    sys.stdout = HTTPTranslator(outbuffer or sys.stdout)
-    return sys.stdout
-
-
-if __name__ == '__main__':
-    consume(sys.stdout).write(sys.stdin.read())
-    print('\n')
-
-# vim: set nowrap tabstop=4 shiftwidth=4 softtabstop=0 expandtab textwidth=0 filetype=python foldmethod=indent foldcolumn=4
diff --git a/lib/UniversalAnalytics/Tracker.py b/lib/UniversalAnalytics/Tracker.py
deleted file mode 100644
index b7d9476e..00000000
--- a/lib/UniversalAnalytics/Tracker.py
+++ /dev/null
@@ -1,424 +0,0 @@
-from future.moves.urllib.request import urlopen, build_opener, install_opener
-from future.moves.urllib.request import Request, HTTPSHandler
-from future.moves.urllib.error import URLError, HTTPError
-from future.moves.urllib.parse import urlencode
-
-import random
-import datetime
-import time
-import uuid
-import hashlib
-import socket
-
-
-def generate_uuid(basedata=None):
-    """ Provides a _random_ UUID with no input, or a UUID4-format MD5 checksum of any input data provided """
-    if basedata is None:
-        return str(uuid.uuid4())
-    elif isinstance(basedata, str):
-        checksum = hashlib.md5(str(basedata).encode('utf-8')).hexdigest()
-        return '%8s-%4s-%4s-%4s-%12s' % (
-        checksum[0:8], checksum[8:12], checksum[12:16], checksum[16:20], checksum[20:32])
-
-
-class Time(datetime.datetime):
-    """ Wrappers and convenience methods for processing various time representations """
-
-    @classmethod
-    def from_unix(cls, seconds, milliseconds=0):
-        """ Produce a full |datetime.datetime| object from a Unix timestamp """
-        base = list(time.gmtime(seconds))[0:6]
-        base.append(milliseconds * 1000)  # microseconds
-        return cls(*base)
-
-    @classmethod
-    def to_unix(cls, timestamp):
-        """ Wrapper over time module to produce Unix epoch time as a float """
-        if not isinstance(timestamp, datetime.datetime):
-            raise TypeError('Time.milliseconds expects a datetime object')
-        base = time.mktime(timestamp.timetuple())
-        return base
-
-    @classmethod
-    def milliseconds_offset(cls, timestamp, now=None):
-        """ Offset time (in milliseconds) from a |datetime.datetime| object to now """
-        if isinstance(timestamp, (int, float)):
-            base = timestamp
-        else:
-            base = cls.to_unix(timestamp)
-            base = base + (timestamp.microsecond / 1000000)
-        if now is None:
-            now = time.time()
-        return (now - base) * 1000
-
-
-class HTTPRequest(object):
-    """ URL Construction and request handling abstraction.
-        This is not intended to be used outside this module.
-
-        Automates mapping of persistent state (i.e. query parameters)
-        onto transcient datasets for each query.
-    """
-
-    endpoint = 'https://www.google-analytics.com/collect'
-
-    @staticmethod
-    def debug():
-        """ Activate debugging on urllib2 """
-        handler = HTTPSHandler(debuglevel=1)
-        opener = build_opener(handler)
-        install_opener(opener)
-
-    # Store properties for all requests
-    def __init__(self, user_agent=None, *args, **opts):
-        self.user_agent = user_agent or 'Analytics Pros - Universal Analytics (Python)'
-
-    @classmethod
-    def fixUTF8(cls, data):  # Ensure proper encoding for UA's servers...
-        """ Convert all strings to UTF-8 """
-        for key in data:
-            if isinstance(data[key], str):
-                data[key] = data[key].encode('utf-8')
-        return data
-
-    # Apply stored properties to the given dataset & POST to the configured endpoint
-    def send(self, data):
-        request = Request(
-            self.endpoint + '?' + urlencode(self.fixUTF8(data)).encode('utf-8'),
-            headers={
-                'User-Agent': self.user_agent
-            }
-        )
-        self.open(request)
-
-    def open(self, request):
-        try:
-            return urlopen(request)
-        except HTTPError as e:
-            return False
-        except URLError as e:
-            self.cache_request(request)
-            return False
-
-    def cache_request(self, request):
-        # TODO: implement a proper caching mechanism here for re-transmitting hits
-        # record = (Time.now(), request.get_full_url(), request.get_data(), request.headers)
-        pass
-
-
-class HTTPPost(HTTPRequest):
-
-    # Apply stored properties to the given dataset & POST to the configured endpoint 
-    def send(self, data):
-        request = Request(
-            self.endpoint,
-            data=urlencode(self.fixUTF8(data)).encode('utf-8'),
-            headers={
-                'User-Agent': self.user_agent
-            }
-        )
-        self.open(request)
-
-
-class Tracker(object):
-    """ Primary tracking interface for Universal Analytics """
-    params = None
-    parameter_alias = {}
-    valid_hittypes = ('pageview', 'event', 'social', 'screenview', 'transaction', 'item', 'exception', 'timing')
-
-    @classmethod
-    def alias(cls, typemap, base, *names):
-        """ Declare an alternate (humane) name for a measurement protocol parameter """
-        cls.parameter_alias[base] = (typemap, base)
-        for i in names:
-            cls.parameter_alias[i] = (typemap, base)
-
-    @classmethod
-    def coerceParameter(cls, name, value=None):
-        if isinstance(name, str) and name[0] == '&':
-            return name[1:], str(value)
-        elif name in cls.parameter_alias:
-            typecast, param_name = cls.parameter_alias.get(name)
-            return param_name, typecast(value)
-        else:
-            raise KeyError('Parameter "{0}" is not recognized'.format(name))
-
-    def payload(self, data):
-        for key, value in data.items():
-            try:
-                yield self.coerceParameter(key, value)
-            except KeyError:
-                continue
-
-    option_sequence = {
-        'pageview': [(str, 'dp')],
-        'event': [(str, 'ec'), (str, 'ea'), (str, 'el'), (int, 'ev')],
-        'social': [(str, 'sn'), (str, 'sa'), (str, 'st')],
-        'timing': [(str, 'utc'), (str, 'utv'), (str, 'utt'), (str, 'utl')]
-    }
-
-    @classmethod
-    def consume_options(cls, data, hittype, args):
-        """ Interpret sequential arguments related to known hittypes based on declared structures """
-        opt_position = 0
-        data['t'] = hittype  # integrate hit type parameter
-        if hittype in cls.option_sequence:
-            for expected_type, optname in cls.option_sequence[hittype]:
-                if opt_position < len(args) and isinstance(args[opt_position], expected_type):
-                    data[optname] = args[opt_position]
-                opt_position += 1
-
-    @classmethod
-    def hittime(cls, timestamp=None, age=None, milliseconds=None):
-        """ Returns an integer represeting the milliseconds offset for a given hit (relative to now) """
-        if isinstance(timestamp, (int, float)):
-            return int(Time.milliseconds_offset(Time.from_unix(timestamp, milliseconds=milliseconds)))
-        if isinstance(timestamp, datetime.datetime):
-            return int(Time.milliseconds_offset(timestamp))
-        if isinstance(age, (int, float)):
-            return int(age * 1000) + (milliseconds or 0)
-
-    @property
-    def account(self):
-        return self.params.get('tid', None)
-
-    def __init__(self, account, name=None, client_id=None, hash_client_id=False, user_id=None, user_agent=None,
-                 use_post=True):
-
-        if use_post is False:
-            self.http = HTTPRequest(user_agent=user_agent)
-        else:
-            self.http = HTTPPost(user_agent=user_agent)
-
-        self.params = {'v': 1, 'tid': account}
-
-        if client_id is None:
-            client_id = generate_uuid()
-
-        self.params['cid'] = client_id
-
-        self.hash_client_id = hash_client_id
-
-        if user_id is not None:
-            self.params['uid'] = user_id
-
-    def set_timestamp(self, data):
-        """ Interpret time-related options, apply queue-time parameter as needed """
-        if 'hittime' in data:  # an absolute timestamp
-            data['qt'] = self.hittime(timestamp=data.pop('hittime', None))
-        if 'hitage' in data:  # a relative age (in seconds)
-            data['qt'] = self.hittime(age=data.pop('hitage', None))
-
-    def send(self, hittype, *args, **data):
-        """ Transmit HTTP requests to Google Analytics using the measurement protocol """
-
-        if hittype not in self.valid_hittypes:
-            raise KeyError('Unsupported Universal Analytics Hit Type: {0}'.format(repr(hittype)))
-
-        self.set_timestamp(data)
-        self.consume_options(data, hittype, args)
-
-        for item in args:  # process dictionary-object arguments of transcient data
-            if isinstance(item, dict):
-                for key, val in self.payload(item):
-                    data[key] = val
-
-        for k, v in self.params.items():  # update only absent parameters
-            if k not in data:
-                data[k] = v
-
-        data = dict(self.payload(data))
-
-        if self.hash_client_id:
-            data['cid'] = generate_uuid(data['cid'])
-
-        # Transmit the hit to Google...
-        self.http.send(data)
-
-    # Setting persistent attibutes of the session/hit/etc (inc. custom dimensions/metrics)
-    def set(self, name, value=None):
-        if isinstance(name, dict):
-            for key, value in name.items():
-                try:
-                    param, value = self.coerceParameter(key, value)
-                    self.params[param] = value
-                except KeyError:
-                    pass
-        elif isinstance(name, str):
-            try:
-                param, value = self.coerceParameter(name, value)
-                self.params[param] = value
-            except KeyError:
-                pass
-
-    def __getitem__(self, name):
-        param, value = self.coerceParameter(name, None)
-        return self.params.get(param, None)
-
-    def __setitem__(self, name, value):
-        param, value = self.coerceParameter(name, value)
-        self.params[param] = value
-
-    def __delitem__(self, name):
-        param, value = self.coerceParameter(name, None)
-        if param in self.params:
-            del self.params[param]
-
-
-def safe_unicode(obj):
-    """ Safe convertion to the Unicode string version of the object """
-    try:
-        return str(obj)
-    except UnicodeDecodeError:
-        return obj.decode('utf-8')
-
-
-# Declaring name mappings for Measurement Protocol parameters
-MAX_CUSTOM_DEFINITIONS = 200
-MAX_EC_LISTS = 11  # 1-based index
-MAX_EC_PRODUCTS = 11  # 1-based index
-MAX_EC_PROMOTIONS = 11  # 1-based index
-
-Tracker.alias(int, 'v', 'protocol-version')
-Tracker.alias(safe_unicode, 'cid', 'client-id', 'clientId', 'clientid')
-Tracker.alias(safe_unicode, 'tid', 'trackingId', 'account')
-Tracker.alias(safe_unicode, 'uid', 'user-id', 'userId', 'userid')
-Tracker.alias(safe_unicode, 'uip', 'user-ip', 'userIp', 'ipaddr')
-Tracker.alias(safe_unicode, 'ua', 'userAgent', 'userAgentOverride', 'user-agent')
-Tracker.alias(safe_unicode, 'dp', 'page', 'path')
-Tracker.alias(safe_unicode, 'dt', 'title', 'pagetitle', 'pageTitle' 'page-title')
-Tracker.alias(safe_unicode, 'dl', 'location')
-Tracker.alias(safe_unicode, 'dh', 'hostname')
-Tracker.alias(safe_unicode, 'sc', 'sessioncontrol', 'session-control', 'sessionControl')
-Tracker.alias(safe_unicode, 'dr', 'referrer', 'referer')
-Tracker.alias(int, 'qt', 'queueTime', 'queue-time')
-Tracker.alias(safe_unicode, 't', 'hitType', 'hittype')
-Tracker.alias(int, 'aip', 'anonymizeIp', 'anonIp', 'anonymize-ip')
-Tracker.alias(safe_unicode, 'ds', 'dataSource', 'data-source')
-
-# Campaign attribution
-Tracker.alias(safe_unicode, 'cn', 'campaign', 'campaignName', 'campaign-name')
-Tracker.alias(safe_unicode, 'cs', 'source', 'campaignSource', 'campaign-source')
-Tracker.alias(safe_unicode, 'cm', 'medium', 'campaignMedium', 'campaign-medium')
-Tracker.alias(safe_unicode, 'ck', 'keyword', 'campaignKeyword', 'campaign-keyword')
-Tracker.alias(safe_unicode, 'cc', 'content', 'campaignContent', 'campaign-content')
-Tracker.alias(safe_unicode, 'ci', 'campaignId', 'campaignID', 'campaign-id')
-
-# Technical specs
-Tracker.alias(safe_unicode, 'sr', 'screenResolution', 'screen-resolution', 'resolution')
-Tracker.alias(safe_unicode, 'vp', 'viewport', 'viewportSize', 'viewport-size')
-Tracker.alias(safe_unicode, 'de', 'encoding', 'documentEncoding', 'document-encoding')
-Tracker.alias(int, 'sd', 'colors', 'screenColors', 'screen-colors')
-Tracker.alias(safe_unicode, 'ul', 'language', 'user-language', 'userLanguage')
-
-# Mobile app
-Tracker.alias(safe_unicode, 'an', 'appName', 'app-name', 'app')
-Tracker.alias(safe_unicode, 'cd', 'contentDescription', 'screenName', 'screen-name', 'content-description')
-Tracker.alias(safe_unicode, 'av', 'appVersion', 'app-version', 'version')
-Tracker.alias(safe_unicode, 'aid', 'appID', 'appId', 'application-id', 'app-id', 'applicationId')
-Tracker.alias(safe_unicode, 'aiid', 'appInstallerId', 'app-installer-id')
-
-# Ecommerce
-Tracker.alias(safe_unicode, 'ta', 'affiliation', 'transactionAffiliation', 'transaction-affiliation')
-Tracker.alias(safe_unicode, 'ti', 'transaction', 'transactionId', 'transaction-id')
-Tracker.alias(float, 'tr', 'revenue', 'transactionRevenue', 'transaction-revenue')
-Tracker.alias(float, 'ts', 'shipping', 'transactionShipping', 'transaction-shipping')
-Tracker.alias(float, 'tt', 'tax', 'transactionTax', 'transaction-tax')
-Tracker.alias(safe_unicode, 'cu', 'currency', 'transactionCurrency',
-              'transaction-currency')  # Currency code, e.g. USD, EUR
-Tracker.alias(safe_unicode, 'in', 'item-name', 'itemName')
-Tracker.alias(float, 'ip', 'item-price', 'itemPrice')
-Tracker.alias(float, 'iq', 'item-quantity', 'itemQuantity')
-Tracker.alias(safe_unicode, 'ic', 'item-code', 'sku', 'itemCode')
-Tracker.alias(safe_unicode, 'iv', 'item-variation', 'item-category', 'itemCategory', 'itemVariation')
-
-# Events
-Tracker.alias(safe_unicode, 'ec', 'event-category', 'eventCategory', 'category')
-Tracker.alias(safe_unicode, 'ea', 'event-action', 'eventAction', 'action')
-Tracker.alias(safe_unicode, 'el', 'event-label', 'eventLabel', 'label')
-Tracker.alias(int, 'ev', 'event-value', 'eventValue', 'value')
-Tracker.alias(int, 'ni', 'noninteractive', 'nonInteractive', 'noninteraction', 'nonInteraction')
-
-# Social
-Tracker.alias(safe_unicode, 'sa', 'social-action', 'socialAction')
-Tracker.alias(safe_unicode, 'sn', 'social-network', 'socialNetwork')
-Tracker.alias(safe_unicode, 'st', 'social-target', 'socialTarget')
-
-# Exceptions
-Tracker.alias(safe_unicode, 'exd', 'exception-description', 'exceptionDescription', 'exDescription')
-Tracker.alias(int, 'exf', 'exception-fatal', 'exceptionFatal', 'exFatal')
-
-# User Timing
-Tracker.alias(safe_unicode, 'utc', 'timingCategory', 'timing-category')
-Tracker.alias(safe_unicode, 'utv', 'timingVariable', 'timing-variable')
-Tracker.alias(float, 'utt', 'time', 'timingTime', 'timing-time')
-Tracker.alias(safe_unicode, 'utl', 'timingLabel', 'timing-label')
-Tracker.alias(float, 'dns', 'timingDNS', 'timing-dns')
-Tracker.alias(float, 'pdt', 'timingPageLoad', 'timing-page-load')
-Tracker.alias(float, 'rrt', 'timingRedirect', 'timing-redirect')
-Tracker.alias(safe_unicode, 'tcp', 'timingTCPConnect', 'timing-tcp-connect')
-Tracker.alias(safe_unicode, 'srt', 'timingServerResponse', 'timing-server-response')
-
-# Custom dimensions and metrics
-for i in range(0, 200):
-    Tracker.alias(safe_unicode, 'cd{0}'.format(i), 'dimension{0}'.format(i))
-    Tracker.alias(int, 'cm{0}'.format(i), 'metric{0}'.format(i))
-
-# Content groups
-for i in range(0, 5):
-    Tracker.alias(safe_unicode, 'cg{0}'.format(i), 'contentGroup{0}'.format(i))
-
-# Enhanced Ecommerce
-Tracker.alias(str, 'pa')  # Product action
-Tracker.alias(str, 'tcc')  # Coupon code
-Tracker.alias(str, 'pal')  # Product action list
-Tracker.alias(int, 'cos')  # Checkout step
-Tracker.alias(str, 'col')  # Checkout step option
-
-Tracker.alias(str, 'promoa')  # Promotion action
-
-for product_index in range(1, MAX_EC_PRODUCTS):
-    Tracker.alias(str, 'pr{0}id'.format(product_index))  # Product SKU
-    Tracker.alias(str, 'pr{0}nm'.format(product_index))  # Product name
-    Tracker.alias(str, 'pr{0}br'.format(product_index))  # Product brand
-    Tracker.alias(str, 'pr{0}ca'.format(product_index))  # Product category
-    Tracker.alias(str, 'pr{0}va'.format(product_index))  # Product variant
-    Tracker.alias(str, 'pr{0}pr'.format(product_index))  # Product price
-    Tracker.alias(int, 'pr{0}qt'.format(product_index))  # Product quantity
-    Tracker.alias(str, 'pr{0}cc'.format(product_index))  # Product coupon code
-    Tracker.alias(int, 'pr{0}ps'.format(product_index))  # Product position
-
-    for custom_index in range(MAX_CUSTOM_DEFINITIONS):
-        Tracker.alias(str, 'pr{0}cd{1}'.format(product_index, custom_index))  # Product custom dimension
-        Tracker.alias(int, 'pr{0}cm{1}'.format(product_index, custom_index))  # Product custom metric
-
-    for list_index in range(1, MAX_EC_LISTS):
-        Tracker.alias(str, 'il{0}pi{1}id'.format(list_index, product_index))  # Product impression SKU
-        Tracker.alias(str, 'il{0}pi{1}nm'.format(list_index, product_index))  # Product impression name
-        Tracker.alias(str, 'il{0}pi{1}br'.format(list_index, product_index))  # Product impression brand
-        Tracker.alias(str, 'il{0}pi{1}ca'.format(list_index, product_index))  # Product impression category
-        Tracker.alias(str, 'il{0}pi{1}va'.format(list_index, product_index))  # Product impression variant
-        Tracker.alias(int, 'il{0}pi{1}ps'.format(list_index, product_index))  # Product impression position
-        Tracker.alias(int, 'il{0}pi{1}pr'.format(list_index, product_index))  # Product impression price
-
-        for custom_index in range(MAX_CUSTOM_DEFINITIONS):
-            Tracker.alias(str, 'il{0}pi{1}cd{2}'.format(list_index, product_index,
-                                                        custom_index))  # Product impression custom dimension
-            Tracker.alias(int, 'il{0}pi{1}cm{2}'.format(list_index, product_index,
-                                                        custom_index))  # Product impression custom metric
-
-for list_index in range(1, MAX_EC_LISTS):
-    Tracker.alias(str, 'il{0}nm'.format(list_index))  # Product impression list name
-
-for promotion_index in range(1, MAX_EC_PROMOTIONS):
-    Tracker.alias(str, 'promo{0}id'.format(promotion_index))  # Promotion ID
-    Tracker.alias(str, 'promo{0}nm'.format(promotion_index))  # Promotion name
-    Tracker.alias(str, 'promo{0}cr'.format(promotion_index))  # Promotion creative
-    Tracker.alias(str, 'promo{0}ps'.format(promotion_index))  # Promotion position
-
-
-# Shortcut for creating trackers
-def create(account, *args, **kwargs):
-    return Tracker(account, *args, **kwargs)
-
-# vim: set nowrap tabstop=4 shiftwidth=4 softtabstop=0 expandtab textwidth=0 filetype=python foldmethod=indent foldcolumn=4
diff --git a/lib/UniversalAnalytics/__init__.py b/lib/UniversalAnalytics/__init__.py
deleted file mode 100644
index 0d8817d6..00000000
--- a/lib/UniversalAnalytics/__init__.py
+++ /dev/null
@@ -1 +0,0 @@
-from . import Tracker
\ No newline at end of file
diff --git a/lib/ga4mp/__init__.py b/lib/ga4mp/__init__.py
new file mode 100644
index 00000000..9a817b94
--- /dev/null
+++ b/lib/ga4mp/__init__.py
@@ -0,0 +1,3 @@
+from ga4mp.ga4mp import GtagMP, FirebaseMP
+
+__all__ = ['GtagMP','FirebaseMP']
\ No newline at end of file
diff --git a/lib/ga4mp/event.py b/lib/ga4mp/event.py
new file mode 100644
index 00000000..12f65a10
--- /dev/null
+++ b/lib/ga4mp/event.py
@@ -0,0 +1,44 @@
+from ga4mp.item import Item
+
+class Event(dict):
+    def __init__(self, name):
+        self.set_event_name(name)
+
+    def set_event_name(self, name):
+        if len(name) > 40:
+            raise ValueError("Event name cannot exceed 40 characters.")
+        self["name"] = name
+
+    def get_event_name(self):
+        return self.get("name")
+
+    def set_event_param(self, name, value):
+        # Series of checks to comply with GA4 event collection limits: https://support.google.com/analytics/answer/9267744
+        if len(name) > 40:
+            raise ValueError("Event parameter name cannot exceed 40 characters.")
+        if name in ["page_location", "page_referrer", "page_title"] and len(str(value)) > 300:
+            raise ValueError("Event parameter value for page info cannot exceed 300 characters.")
+        if name not in ["page_location", "page_referrer", "page_title"] and len(str(value)) > 100:
+            raise ValueError("Event parameter value cannot exceed 100 characters.")
+        if "params" not in self.keys():
+            self["params"] = {}
+        if len(self["params"]) >= 100:
+            raise RuntimeError("Event cannot contain more than 100 parameters.")
+        self["params"][name] = value
+
+    def get_event_params(self):
+        return self.get("params")
+
+    def delete_event_param(self, name):
+        # Since only 25 event parameters are allowed, this will allow the user to delete a parameter if necessary.
+        self["params"].pop(name, None)
+
+    def create_new_item(self, item_id=None, item_name=None):
+        return Item(item_id=item_id, item_name=item_name)
+
+    def add_item_to_event(self, item):
+        if not isinstance(item, dict):
+            raise ValueError("'item' must be an instance of a dictionary.")
+        if "items" not in self["params"].keys():
+            self.set_event_param("items", [])
+        self["params"]["items"].append(item)
\ No newline at end of file
diff --git a/lib/ga4mp/ga4mp.py b/lib/ga4mp/ga4mp.py
new file mode 100644
index 00000000..45fdc842
--- /dev/null
+++ b/lib/ga4mp/ga4mp.py
@@ -0,0 +1,416 @@
+###############################################################################
+# Google Analytics 4 Measurement Protocol for Python
+# Copyright (c) 2022, Adswerve
+#
+# This project is free software, distributed under the BSD license.
+# Adswerve offers consulting and integration services if your firm needs
+# assistance in strategy, implementation, or auditing existing work.
+###############################################################################
+
+import json
+import logging
+import urllib.request
+import time
+import datetime
+import random
+from ga4mp.utils import params_dict
+from ga4mp.event import Event
+from ga4mp.store import BaseStore, DictStore
+
+import os, sys
+sys.path.append(
+    os.path.normpath(os.path.join(os.path.dirname(__file__), ".."))
+)
+
+logger = logging.getLogger(__name__)
+logger.setLevel(logging.INFO)
+
+class BaseGa4mp(object):
+    """
+    Parent class that provides an interface for sending data to Google Analytics, supporting the GA4 Measurement Protocol.
+
+    Parameters
+    ----------
+    api_secret : string
+        Generated through the Google Analytics UI. To create a new secret, navigate in the Google Analytics UI to: Admin > Data Streams >
+        [choose your stream] > Measurement Protocol API Secrets > Create
+
+    See Also
+    --------
+
+    * Measurement Protocol (Google Analytics 4): https://developers.google.com/analytics/devguides/collection/protocol/ga4
+
+    Examples
+    --------
+    # Initialize tracking object for gtag usage
+    >>> ga = gtagMP(api_secret = "API_SECRET", measurement_id = "MEASUREMENT_ID", client_id="CLIENT_ID")
+
+    # Initialize tracking object for Firebase usage
+    >>> ga = firebaseMP(api_secret = "API_SECRET", firebase_app_id = "FIREBASE_APP_ID", app_instance_id="APP_INSTANCE_ID")
+
+    # Build an event
+    >>> event_type = 'new_custom_event'
+    >>> event_parameters = {'parameter_key_1': 'parameter_1', 'parameter_key_2': 'parameter_2'}
+    >>> event = {'name': event_type, 'params': event_parameters }
+    >>> events = [event]
+
+    # Send a custom event to GA4 immediately
+    >>> ga.send(events)
+
+    # Postponed send of a custom event to GA4
+    >>> ga.send(events, postpone=True)
+    >>> ga.postponed_send()
+    """
+
+    def __init__(self, api_secret, store: BaseStore = None):
+        self._initialization_time = time.time() # used for both session_id and calculating engagement time
+        self.api_secret = api_secret
+        self._event_list = []
+        assert store is None or isinstance(store, BaseStore), "if supplied, store must be an instance of BaseStore"
+        self.store = store or DictStore()
+        self._check_store_requirements()
+        self._base_domain = "https://www.google-analytics.com/mp/collect"
+        self._validation_domain = "https://www.google-analytics.com/debug/mp/collect"
+
+    def _check_store_requirements(self):
+        # Store must contain "session_id" and "last_interaction_time_msec" in order for tracking to work properly.
+        if self.store.get_session_parameter("session_id") is None:
+            self.store.set_session_parameter(name="session_id", value=int(self._initialization_time))
+        # Note: "last_interaction_time_msec" factors into the required "engagement_time_msec" event parameter.
+        self.store.set_session_parameter(name="last_interaction_time_msec", value=int(self._initialization_time * 1000))
+
+    def create_new_event(self, name):
+        return Event(name=name)
+
+    def send(self, events, validation_hit=False, postpone=False, date=None):
+        """
+        Method to send an http post request to google analytics with the specified events.
+
+        Parameters
+        ----------
+        events : List[Dict]
+            A list of dictionaries of the events to be sent to Google Analytics. The list of dictionaries should adhere
+            to the following format:
+
+            [{'name': 'level_end',
+            'params' : {'level_name': 'First',
+                        'success': 'True'}
+            },
+            {'name': 'level_up',
+            'params': {'character': 'John Madden',
+                        'level': 'First'}
+            }]
+
+        validation_hit : bool, optional
+            Boolean to depict if events should be tested against the Measurement Protocol Validation Server, by default False
+        postpone : bool, optional
+            Boolean to depict if provided event list should be postponed, by default False
+        date : datetime
+            Python datetime object for sending a historical event at the given date. Date cannot be in the future.
+        """
+
+        # check for any missing or invalid parameters among automatically collected and recommended event types
+        self._check_params(events)
+        self._check_date_not_in_future(date)
+        self._add_session_id_and_engagement_time(events)
+
+        if postpone is True:
+            # build event list to send later
+            for event in events:
+                event["_timestamp_micros"] = self._get_timestamp(time.time())
+                self._event_list.append(event)
+        else:
+            # batch events into sets of 25 events, the maximum allowed.
+            batched_event_list = [
+                events[event : event + 25] for event in range(0, len(events), 25)
+            ]
+            # send http post request
+            self._http_post(
+                batched_event_list, validation_hit=validation_hit, date=date
+            )
+
+    def postponed_send(self):
+        """
+        Method to send the events provided to Ga4mp.send(events,postpone=True)
+        """
+
+        for event in self._event_list:
+            self._http_post([event], postpone=True)
+
+        # clear event_list for future use
+        self._event_list = []
+
+    def append_event_to_params_dict(self, new_name_and_parameters):
+
+        """
+        Method to append event name and parameters key-value pairing(s) to parameters dictionary.
+
+        Parameters
+        ----------
+        new_name_and_parameters : Dict
+            A dictionary with one key-value pair representing a new type of event to be sent to Google Analytics.
+            The dictionary should adhere to the following format:
+
+            {'new_name': ['new_param_1', 'new_param_2', 'new_param_3']}
+        """
+
+        params_dict.update(new_name_and_parameters)
+
+    def _http_post(self, batched_event_list, validation_hit=False, postpone=False, date=None):
+        """
+        Method to send http POST request to google-analytics.
+
+        Parameters
+        ----------
+        batched_event_list : List[List[Dict]]
+            List of List of events. Places initial event payload into a list to send http POST in batches.
+        validation_hit : bool, optional
+            Boolean to depict if events should be tested against the Measurement Protocol Validation Server, by default False
+        postpone : bool, optional
+            Boolean to depict if provided event list should be postponed, by default False
+        date : datetime
+            Python datetime object for sending a historical event at the given date. Date cannot be in the future.
+            Timestamp micros supports up to 48 hours of backdating.
+            If date is specified, postpone must be False or an assertion will be thrown.
+        """
+        self._check_date_not_in_future(date)
+        status_code = None  # Default set to know if batch loop does not work and to bound status_code
+
+        # set domain
+        domain = self._base_domain
+        if validation_hit is True:
+            domain = self._validation_domain
+        logger.info(f"Sending POST to: {domain}")
+
+        # loop through events in batches of 25
+        batch_number = 1
+        for batch in batched_event_list:
+            # url and request slightly differ by subclass
+            url = self._build_url(domain=domain)
+            request = self._build_request(batch=batch)
+            self._add_user_props_to_hit(request)
+
+            # make adjustments for postponed hit
+            request["events"] = (
+                {"name": batch["name"], "params": batch["params"]}
+                if (postpone)
+                else batch
+            )
+
+            if date is not None:
+                logger.info(f"Setting event timestamp to: {date}")
+                assert (
+                    postpone is False
+                ), "Cannot send postponed historical hit, ensure postpone=False"
+
+                ts = self._datetime_to_timestamp(date)
+                ts_micro = self._get_timestamp(ts)
+                request["timestamp_micros"] = int(ts_micro)
+                logger.info(f"Timestamp of request is: {request['timestamp_micros']}")
+
+            if postpone:
+                # add timestamp to hit
+                request["timestamp_micros"] = batch["_timestamp_micros"]
+
+            req = urllib.request.Request(url)
+            req.add_header("Content-Type", "application/json; charset=utf-8")
+            jsondata = json.dumps(request)
+            json_data_as_bytes = jsondata.encode("utf-8")  # needs to be bytes
+            req.add_header("Content-Length", len(json_data_as_bytes))
+            result = urllib.request.urlopen(req, json_data_as_bytes)
+
+            status_code = result.status
+            logger.info(f"Batch Number: {batch_number}")
+            logger.info(f"Status code: {status_code}")
+            batch_number += 1
+
+        return status_code
+
+    def _check_params(self, events):
+
+        """
+        Method to check whether the provided event payload parameters align with supported parameters.
+
+        Parameters
+        ----------
+        events : List[Dict]
+            A list of dictionaries of the events to be sent to Google Analytics. The list of dictionaries should adhere
+            to the following format:
+
+            [{'name': 'level_end',
+            'params' : {'level_name': 'First',
+                        'success': 'True'}
+            },
+            {'name': 'level_up',
+            'params': {'character': 'John Madden',
+                        'level': 'First'}
+            }]
+        """
+
+        # check to make sure it's a list of dictionaries with the right keys
+
+        assert type(events) == list, "events should be a list"
+
+        for event in events:
+
+            assert isinstance(event, dict), "each event should be an instance of a dictionary"
+
+            assert "name" in event, 'each event should have a "name" key'
+
+            assert "params" in event, 'each event should have a "params" key'
+
+        # check for any missing or invalid parameters
+
+        for e in events:
+            event_name = e["name"]
+            event_params = e["params"]
+            if event_name in params_dict.keys():
+                for parameter in params_dict[event_name]:
+                    if parameter not in event_params.keys():
+                        logger.warning(
+                            f"WARNING: Event parameters do not match event type.\nFor {event_name} event type, the correct parameter(s) are {params_dict[event_name]}.\nThe parameter '{parameter}' triggered this warning.\nFor a breakdown of currently supported event types and their parameters go here: https://support.google.com/analytics/answer/9267735\n"
+                        )
+
+    def _add_session_id_and_engagement_time(self, events):
+        """
+        Method to add the session_id and engagement_time_msec parameter to all events.
+        """
+        for event in events:
+            current_time_in_milliseconds = int(time.time() * 1000)
+
+            event_params = event["params"]
+            if "session_id" not in event_params.keys():
+                event_params["session_id"] = self.store.get_session_parameter("session_id")
+            if "engagement_time_msec" not in event_params.keys():
+                last_interaction_time = self.store.get_session_parameter("last_interaction_time_msec")
+                event_params["engagement_time_msec"] = current_time_in_milliseconds - last_interaction_time if current_time_in_milliseconds > last_interaction_time else 0
+                self.store.set_session_parameter(name="last_interaction_time_msec", value=current_time_in_milliseconds)
+
+    def _add_user_props_to_hit(self, hit):
+
+        """
+        Method is a helper function to add user properties to outgoing hits.
+
+        Parameters
+        ----------
+        hit : dict
+        """
+
+        for key in self.store.get_all_user_properties():
+            try:
+                if key in ["user_id", "non_personalized_ads"]:
+                    hit.update({key: self.store.get_user_property(key)})
+                else:
+                    if "user_properties" not in hit.keys():
+                        hit.update({"user_properties": {}})
+                    hit["user_properties"].update(
+                        {key: {"value": self.store.get_user_property(key)}}
+                    )
+            except:
+                logger.info(f"Failed to add user property to outgoing hit: {key}")
+
+    def _get_timestamp(self, timestamp):
+        """
+        Method returns UNIX timestamp in microseconds for postponed hits.
+
+        Parameters
+        ----------
+        None
+        """
+        return int(timestamp * 1e6)
+
+    def _datetime_to_timestamp(self, dt):
+        """
+        Private method to convert a datetime object into a timestamp
+
+        Parameters
+        ----------
+        dt : datetime
+            A datetime object in any format
+
+        Returns
+        -------
+        timestamp
+            A UNIX timestamp in milliseconds
+        """
+        return time.mktime(dt.timetuple())
+
+    def _check_date_not_in_future(self, date):
+        """
+        Method to check that provided date is not in the future.
+
+        Parameters
+        ----------
+        date : datetime
+            Python datetime object
+        """
+        if date is None:
+            pass
+        else:
+            assert (
+                date <= datetime.datetime.now()
+            ), "Provided date cannot be in the future"
+
+    def _build_url(self, domain):
+        raise NotImplementedError("Subclass should be using this function, but it was called through the base class instead.")
+
+    def _build_request(self, batch):
+        raise NotImplementedError("Subclass should be using this function, but it was called through the base class instead.")
+
+class GtagMP(BaseGa4mp):
+    """
+    Subclass for users of gtag. See `Ga4mp` parent class for examples.
+
+    Parameters
+    ----------
+    measurement_id : string
+        The identifier for a Data Stream. Found in the Google Analytics UI under: Admin > Data Streams > [choose your stream] > Measurement ID (top-right)
+    client_id : string
+        A unique identifier for a client, representing a specific browser/device.
+    """
+
+    def __init__(self, api_secret, measurement_id, client_id,):
+        super().__init__(api_secret)
+        self.measurement_id = measurement_id
+        self.client_id = client_id
+
+    def _build_url(self, domain):
+        return f"{domain}?measurement_id={self.measurement_id}&api_secret={self.api_secret}"
+
+    def _build_request(self, batch):
+        return {"client_id": self.client_id, "events": batch}
+
+    def random_client_id(self):
+        """
+        Utility function for generating a new client ID matching the typical format of 10 random digits and the UNIX timestamp in seconds, joined by a period.
+        """
+        return "%0.10d" % random.randint(0,9999999999) + "." + str(int(time.time()))
+
+class FirebaseMP(BaseGa4mp):
+    """
+    Subclass for users of Firebase. See `Ga4mp` parent class for examples.
+
+    Parameters
+    ----------
+    firebase_app_id : string
+        The identifier for a Firebase app. Found in the Firebase console under: Project Settings > General > Your Apps > App ID.
+    app_instance_id : string
+        A unique identifier for a Firebase app instance.
+            * Android - getAppInstanceId() - https://firebase.google.com/docs/reference/android/com/google/firebase/analytics/FirebaseAnalytics#public-taskstring-getappinstanceid
+            * Kotlin - getAppInstanceId() - https://firebase.google.com/docs/reference/kotlin/com/google/firebase/analytics/FirebaseAnalytics#getappinstanceid
+            * Swift - appInstanceID() - https://firebase.google.com/docs/reference/swift/firebaseanalytics/api/reference/Classes/Analytics#appinstanceid
+            * Objective-C - appInstanceID - https://firebase.google.com/docs/reference/ios/firebaseanalytics/api/reference/Classes/FIRAnalytics#+appinstanceid
+            * C++ - GetAnalyticsInstanceId() - https://firebase.google.com/docs/reference/cpp/namespace/firebase/analytics#getanalyticsinstanceid
+            * Unity - GetAnalyticsInstanceIdAsync() - https://firebase.google.com/docs/reference/unity/class/firebase/analytics/firebase-analytics#getanalyticsinstanceidasync
+    """
+
+    def __init__(self, api_secret, firebase_app_id, app_instance_id):
+        super().__init__(api_secret)
+        self.firebase_app_id = firebase_app_id
+        self.app_instance_id = app_instance_id
+
+    def _build_url(self, domain):
+        return f"{domain}?firebase_app_id={self.firebase_app_id}&api_secret={self.api_secret}"
+
+    def _build_request(self, batch):
+        return {"app_instance_id": self.app_instance_id, "events": batch}
\ No newline at end of file
diff --git a/lib/ga4mp/item.py b/lib/ga4mp/item.py
new file mode 100644
index 00000000..9c5ee9cd
--- /dev/null
+++ b/lib/ga4mp/item.py
@@ -0,0 +1,11 @@
+class Item(dict):
+    def __init__(self, item_id=None, item_name=None):
+        if item_id is None and item_name is None:
+            raise ValueError("At least one of 'item_id' and 'item_name' is required.")
+        if item_id is not None:
+            self.set_parameter("item_id", str(item_id))
+        if item_name is not None:
+            self.set_parameter("item_name", item_name)
+
+    def set_parameter(self, name, value):
+        self[name] = value
\ No newline at end of file
diff --git a/lib/ga4mp/store.py b/lib/ga4mp/store.py
new file mode 100644
index 00000000..d85bc0c2
--- /dev/null
+++ b/lib/ga4mp/store.py
@@ -0,0 +1,116 @@
+import json
+import logging
+from pathlib import Path
+
+logger = logging.getLogger(__name__)
+logger.setLevel(logging.INFO)
+
+class BaseStore(dict):
+    def __init__(self):
+        self.update([("user_properties", {}),("session_parameters", {})])
+
+    def save(self):
+        raise NotImplementedError("Subclass should be using this function, but it was called through the base class instead.")
+
+    def _check_exists(self, key):
+        # Helper function to make sure a key exists before trying to work with values within it.
+        if key not in self.keys():
+            self[key] = {}
+
+    def _set(self, param_type, name, value):
+        # Helper function to set a single parameter (user or session or other).
+        self._check_exists(key=param_type)
+        self[param_type][name] = value
+
+    def _get_one(self, param_type, name):
+        # Helper function to get a single parameter value (user or session).
+        self._check_exists(key=param_type)
+        return self[param_type].get(name, None)
+
+    def _get_all(self, param_type=None):
+        # Helper function to get all user or session parameters - or the entire dictionary if not specified.
+        if param_type is not None:
+            return self[param_type]
+        else:
+            return self
+
+    # While redundant, the following make sure the distinction between session and user items is easier for the end user.
+    def set_user_property(self, name, value):
+        self._set(param_type="user_properties", name=name, value=value)
+
+    def get_user_property(self, name):
+        return self._get_one(param_type="user_properties", name=name)
+
+    def get_all_user_properties(self):
+        return self._get_all(param_type="user_properties")
+
+    def clear_user_properties(self):
+        self["user_properties"] = {}
+
+    def set_session_parameter(self, name, value):
+        self._set(param_type="session_parameters", name=name, value=value)
+
+    def get_session_parameter(self, name):
+        return self._get_one(param_type="session_parameters", name=name)
+
+    def get_all_session_parameters(self):
+        return self._get_all(param_type="session_parameters")
+
+    def clear_session_parameters(self):
+        self["session_parameters"] = {}
+
+    # Similar functions for other items the user wants to store that don't fit the other two categories.
+    def set_other_parameter(self, name, value):
+        self._set(param_type="other", name=name, value=value)
+
+    def get_other_parameter(self, name):
+        return self._get_one(param_type="other", name=name)
+
+    def get_all_other_parameters(self):
+        return self._get_all(param_type="other")
+
+    def clear_other_parameters(self):
+        self["other"] = {}
+
+class DictStore(BaseStore):
+    # Class for working with dictionaries that persist for the life of the class.
+    def __init__(self, data: dict = None):
+        super().__init__()
+        if data:
+            self.update(data)
+
+    def save(self):
+        # Give the user back what's in the dictionary so they can decide how to save it.
+        self._get_all()
+
+class FileStore(BaseStore):
+    # Class for working with dictionaries that get saved to a JSON file.
+    def __init__(self, data_location: str = None):
+        super().__init__()
+        self.data_location = data_location
+        try:
+            self._load_file(data_location)
+        except:
+            logger.info(f"Failed to find file at location: {data_location}")
+
+    def _load_file(self):
+        # Function to get data from the object's initialized location.
+        # If the provided or stored data_location exists, read the file and overwrite the object's contents.
+        if Path(self.data_location).exists():
+            with open(self.data_location, "r") as json_file:
+                self = json.load(json_file)
+        # If the data_location doesn't exist, try to create a new starter JSON file at the location given.
+        else:
+            starter_dict = '{"user_properties":{}, "session_parameters":{}}'
+            starter_json = json.loads(starter_dict)
+            Path(self.data_location).touch()
+            with open(self.data_location, "w") as json_file:
+                json.dumps(starter_json, json_file)
+
+    def save(self):
+        # Function to save the current dictionary to a JSON file at the object's initialized location.
+        try:
+            with open(self.data_location, "w") as outfile:
+                json.dump(self, outfile)
+        except:
+            logger.info(f"Failed to save file at location: {self.data_location}")
\ No newline at end of file
diff --git a/lib/ga4mp/utils.py b/lib/ga4mp/utils.py
new file mode 100644
index 00000000..27fbca86
--- /dev/null
+++ b/lib/ga4mp/utils.py
@@ -0,0 +1,392 @@
+# all automatically collected and recommended event types
+params_dict = {
+    "ad_click": [
+        "ad_event_id"
+    ],
+    "ad_exposure": [
+        "firebase_screen",
+        "firebase_screen_id",
+        "firebase_screen_class",
+        "exposure_time",
+    ],
+    "ad_impression": [
+        "ad_event_id"
+    ],
+    "ad_query": [
+        "ad_event_id"
+    ],
+    "ad_reward": [
+        "ad_unit_id",
+        "reward_type",
+        "reward_value"
+    ],
+    "add_payment_info": [
+        "coupon",
+        "currency",
+        "items",
+        "payment_type",
+        "value"
+    ],
+    "add_shipping_info": [
+        "coupon",
+        "currency",
+        "items",
+        "shipping_tier",
+        "value"
+    ],
+    "add_to_cart": [
+        "currency",
+        "items",
+        "value"
+    ],
+    "add_to_wishlist": [
+        "currency",
+        "items",
+        "value"
+    ],
+    "adunit_exposure": [
+        "firebase_screen",
+        "firebase_screen_id",
+        "firebase_screen_class",
+        "exposure_time",
+    ],
+    "app_clear_data": [],
+    "app_exception": [
+        "fatal",
+        "timestamp",
+        "engagement_time_msec"
+    ],
+    "app_remove": [],
+    "app_store_refund": [
+        "product_id",
+        "value",
+        "currency",
+        "quantity"
+    ],
+    "app_store_subscription_cancel": [
+        "product_id",
+        "price",
+        "value",
+        "currency",
+        "cancellation_reason",
+    ],
+    "app_store_subscription_convert": [
+        "product_id",
+        "price",
+        "value",
+        "currency",
+        "quantity",
+    ],
+    "app_store_subscription_renew": [
+        "product_id",
+        "price",
+        "value",
+        "currency",
+        "quantity",
+        "renewal_count",
+    ],
+    "app_update": [
+        "previous_app_version"
+    ],
+    "begin_checkout": [
+        "coupon",
+        "currency",
+        "items",
+        "value"
+    ],
+    "click": [],
+    "dynamic_link_app_open": [
+        "source",
+        "medium",
+        "campaign",
+        "link_id",
+        "accept_time"
+    ],
+    "dynamic_link_app_update": [
+        "source",
+        "medium",
+        "campaign",
+        "link_id",
+        "accept_time",
+    ],
+    "dynamic_link_first_open": [
+        "source",
+        "medium",
+        "campaign",
+        "link_id",
+        "accept_time",
+    ],
+    "earn_virtual_currency": [
+        "virtual_currency_name",
+        "value"
+    ],
+    "error": [
+        "firebase_error",
+        "firebase_error_value"
+    ],
+    "file_download": [
+        "file_extension",
+        "file_name",
+        "link_classes",
+        "link_domain",
+        "link_id",
+        "link_text",
+        "link_url",
+    ],
+    "firebase_campaign": [
+        "source",
+        "medium",
+        "campaign",
+        "term",
+        "content",
+        "gclid",
+        "aclid",
+        "cp1",
+        "anid",
+        "click_timestamp",
+        "campaign_info_source",
+    ],
+    "firebase_in_app_message_action": [
+        "message_name",
+        "message_device_time",
+        "message_id",
+    ],
+    "firebase_in_app_message_dismiss": [
+        "message_name",
+        "message_device_time",
+        "message_id",
+    ],
+    "firebase_in_app_message_impression": [
+        "message_name",
+        "message_device_time",
+        "message_id",
+    ],
+    "first_open": [
+        "previous_gmp_app_id",
+        "updated_with_analytics",
+        "previous_first_open_count",
+        "system_app",
+        "system_app_update",
+        "deferred_analytics_collection",
+        "reset_analytics_cause",
+        "engagement_time_msec",
+    ],
+    "first_visit": [],
+    "generate_lead": [
+        "value",
+        "currency"
+    ],
+    "in_app_purchase": [
+        "product_id",
+        "price",
+        "value",
+        "currency",
+        "quantity",
+        "subscription",
+        "free_trial",
+        "introductory_price",
+    ],
+    "join_group": [
+        "group_id"
+    ],
+    "level_end": [
+        "level_name",
+        "success"
+    ],
+    "level_start": [
+        "level_name"
+    ],
+    "level_up": [
+        "character",
+        "level"
+    ],
+    "login": [
+        "method"
+    ],
+    "notification_dismiss": [
+        "message_name",
+        "message_time",
+        "message_device_time",
+        "message_id",
+        "topic",
+        "label",
+        "message_channel",
+    ],
+    "notification_foreground": [
+        "message_name",
+        "message_time",
+        "message_device_time",
+        "message_id",
+        "topic",
+        "label",
+        "message_channel",
+        "message_type",
+    ],
+    "notification_open": [
+        "message_name",
+        "message_time",
+        "message_device_time",
+        "message_id",
+        "topic",
+        "label",
+        "message_channel",
+    ],
+    "notification_receive": [
+        "message_name",
+        "message_time",
+        "message_device_time",
+        "message_id",
+        "topic",
+        "label",
+        "message_channel",
+        "message_type",
+    ],
+    "notification_send": [
+        "message_name",
+        "message_time",
+        "message_device_time",
+        "message_id",
+        "topic",
+        "label",
+        "message_channel",
+    ],
+    "os_update": [
+        "previous_os_version"
+    ],
+    "page_view": [
+        "page_location",
+        "page_referrer"
+    ],
+    "post_score": [
+        "level",
+        "character",
+        "score"
+    ],
+    "purchase": [
+        "affiliation",
+        "coupon",
+        "currency",
+        "items",
+        "transaction_id",
+        "shipping",
+        "tax",
+        "value",
+    ],
+    "refund": [
+        "transaction_id",
+        "value",
+        "currency",
+        "tax",
+        "shipping",
+        "items"
+    ],
+    "remove_from_cart": [
+        "currency",
+        "items",
+        "value"
+    ],
+    "screen_view": [
+        "firebase_screen",
+        "firebase_screen_class",
+        "firebase_screen_id",
+        "firebase_previous_screen",
+        "firebase_previous_class",
+        "firebase_previous_id",
+        "engagement_time_msec",
+    ],
+    "scroll": [],
+    "search": [
+        "search_term"
+    ],
+    "select_content": [
+        "content_type",
+        "item_id"
+    ],
+    "select_item": [
+        "items",
+        "item_list_name",
+        "item_list_id"
+    ],
+    "select_promotion": [
+        "items",
+        "promotion_id",
+        "promotion_name",
+        "creative_name",
+        "creative_slot",
+        "location_id",
+    ],
+    "session_start": [],
+    "share": [
+        "content_type",
+        "item_id"
+    ],
+    "sign_up": [
+        "method"
+    ],
+    "view_search_results": [
+        "search_term"
+    ],
+    "spend_virtual_currency": [
+        "item_name",
+        "virtual_currency_name",
+        "value"
+    ],
+    "tutorial_begin": [],
+    "tutorial_complete": [],
+    "unlock_achievement": [
+        "achievement_id"
+    ],
+    "user_engagement": [
+        "engagement_time_msec"
+    ],
+    "video_start": [
+        "video_current_time",
+        "video_duration",
+        "video_percent",
+        "video_provider",
+        "video_title",
+        "video_url",
+        "visible",
+    ],
+    "video_progress": [
+        "video_current_time",
+        "video_duration",
+        "video_percent",
+        "video_provider",
+        "video_title",
+        "video_url",
+        "visible",
+    ],
+    "video_complete": [
+        "video_current_time",
+        "video_duration",
+        "video_percent",
+        "video_provider",
+        "video_title",
+        "video_url",
+        "visible",
+    ],
+    "view_cart": [
+        "currency",
+        "items",
+        "value"
+    ],
+    "view_item": [
+        "currency",
+        "items",
+        "value"
+    ],
+    "view_item_list": [
+        "items",
+        "item_list_name",
+        "item_list_id"
+    ],
+    "view_promotion": [
+        "items",
+        "promotion_id",
+        "promotion_name",
+        "creative_name",
+        "creative_slot",
+        "location_id",
+    ],
+}
\ No newline at end of file
diff --git a/requirements.txt b/requirements.txt
index b69f5fc2..6d3fa686 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -14,6 +14,7 @@ distro==1.8.0
 dnspython==2.2.1
 facebook-sdk==3.1.0
 future==0.18.2
+ga4mp==2.0.4
 gntp==1.0.3
 html5lib==1.1
 httpagentparser==1.9.5

From af3e5574f5442fb45a722462ba62965fe2dce247 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 26 Feb 2023 15:09:51 -0800
Subject: [PATCH 328/743] Migrate to Google Analytics 4

---
 plexpy/__init__.py | 66 ++++++++++++++++++++++++----------------------
 plexpy/plextv.py   |  8 ++++++
 2 files changed, 42 insertions(+), 32 deletions(-)

diff --git a/plexpy/__init__.py b/plexpy/__init__.py
index d0aed7cf..31e3d51c 100644
--- a/plexpy/__init__.py
+++ b/plexpy/__init__.py
@@ -36,7 +36,7 @@ except ImportError:
 
 from apscheduler.schedulers.background import BackgroundScheduler
 from apscheduler.triggers.interval import IntervalTrigger
-from UniversalAnalytics import Tracker
+from ga4mp import GtagMP
 import pytz
 
 PYTHON2 = sys.version_info[0] == 2
@@ -578,12 +578,12 @@ def start():
 
             # Send system analytics events
             if not CONFIG.FIRST_RUN_COMPLETE:
-                analytics_event(category='system', action='install')
+                analytics_event(name='install')
 
             elif _UPDATE:
-                analytics_event(category='system', action='update')
+                analytics_event(name='update')
 
-            analytics_event(category='system', action='start')
+            analytics_event(name='start')
 
         _STARTED = True
 
@@ -2843,44 +2843,46 @@ def generate_uuid():
 
 
 def initialize_tracker():
-    data = {
-        'dataSource': 'server',
-        'appName': common.PRODUCT,
-        'appVersion': common.RELEASE,
-        'appId': INSTALL_TYPE,
-        'appInstallerId': CONFIG.GIT_BRANCH,
-        'dimension1': '{} {}'.format(common.PLATFORM, common.PLATFORM_RELEASE),  # App Platform
-        'dimension2': common.PLATFORM_LINUX_DISTRO,  # Linux Distro
-        'dimension3': common.PYTHON_VERSION,
-        'userLanguage': SYS_LANGUAGE,
-        'documentEncoding': SYS_ENCODING,
-        'noninteractive': True
-        }
-
-    tracker = Tracker.create('UA-111522699-2', client_id=CONFIG.PMS_UUID, hash_client_id=True,
-                             user_agent=common.USER_AGENT)
-    tracker.set(data)
-
+    tracker = GtagMP(
+        api_secret='Cl_LjAKUT26AS22YZwqaPw',
+        measurement_id='G-NH1M4BYM2P',
+        client_id=CONFIG.PMS_UUID
+    )
     return tracker
 
 
-def analytics_event(category, action, label=None, value=None, **kwargs):
-    data = {'category': category, 'action': action}
+def analytics_event(name, **kwargs):
+    event = TRACKER.create_new_event(name=name)
+    event.set_event_param('name', common.PRODUCT)
+    event.set_event_param('version', common.RELEASE)
+    event.set_event_param('install', INSTALL_TYPE)
+    event.set_event_param('branch', CONFIG.GIT_BRANCH)
+    event.set_event_param('platform', common.PLATFORM)
+    event.set_event_param('platformRelease', common.PLATFORM_RELEASE)
+    event.set_event_param('platformVersion', common.PLATFORM_VERSION)
+    event.set_event_param('linuxDistro', common.PLATFORM_LINUX_DISTRO)
+    event.set_event_param('pythonVersion', common.PYTHON_VERSION)
+    event.set_event_param('language', SYS_LANGUAGE)
+    event.set_event_param('encoding', SYS_ENCODING)
+    event.set_event_param('timezone', str(SYS_TIMEZONE))
+    event.set_event_param('timezoneUTCOffset', f'UTC{SYS_UTC_OFFSET}')
 
-    if label is not None:
-        data['label'] = label
+    for key, value in kwargs.items():
+        event.set_event_param(key, value)
 
-    if value is not None:
-        data['value'] = value
+    plex_tv = plextv.PlexTV()
+    ip_address = plex_tv.get_public_ip(output_format='text')
+    geolocation = plex_tv.get_geoip_lookup(ip_address) or {}
 
-    if kwargs:
-        data.update(kwargs)
+    event.set_event_param('country', geolocation.get('country', 'Unknown'))
+    event.set_event_param('countryCode', geolocation.get('code', 'Unknown'))
 
     if TRACKER:
         try:
-            TRACKER.send('event', data)
+            TRACKER.send(events=[event])
+            pass
         except Exception as e:
-            logger.warn("Failed to send analytics event for category '%s', action '%s': %s" % (category, action, e))
+            logger.warn("Failed to send analytics event for name '%s': %s" % (name, e))
 
 
 def check_folder_writable(folder, fallback, name):
diff --git a/plexpy/plextv.py b/plexpy/plextv.py
index 1b596fc7..e7815756 100644
--- a/plexpy/plextv.py
+++ b/plexpy/plextv.py
@@ -331,6 +331,14 @@ class PlexTV(object):
 
         return request
 
+    def get_public_ip(self, output_format=''):
+        uri = '/:/ip'
+        request = self.request_handler.make_request(uri=uri,
+                                                    request_type='GET',
+                                                    output_format=output_format)
+
+        return request
+
     def get_plextv_geoip(self, ip_address='', output_format=''):
         uri = '/api/v2/geoip?ip_address=%s' % ip_address
         request = self.request_handler.make_request(uri=uri,

From 731d5c9bafab5ad505d8f30afd8a5e3e1128803b Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 26 Feb 2023 15:17:04 -0800
Subject: [PATCH 329/743] Add multiprocessing semaphore prefix

* Fixes #2007
---
 Tautulli.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/Tautulli.py b/Tautulli.py
index eebfa55a..2c03eb3b 100755
--- a/Tautulli.py
+++ b/Tautulli.py
@@ -29,6 +29,7 @@ import appdirs
 import argparse
 import datetime
 import locale
+import multiprocessing
 import pytz
 import signal
 import shutil
@@ -47,6 +48,8 @@ elif common.PLATFORM == 'Darwin':
 signal.signal(signal.SIGINT, plexpy.sig_handler)
 signal.signal(signal.SIGTERM, plexpy.sig_handler)
 
+multiprocessing.current_process()._config['semprefix'] = '/tautulli.tautulli.mp'
+
 
 def main():
     """

From cd3ff6eed76f0fb33a2e7b9a1ac754548d48e0b9 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 26 Feb 2023 16:06:44 -0800
Subject: [PATCH 330/743] Remove extra pass

---
 plexpy/__init__.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/plexpy/__init__.py b/plexpy/__init__.py
index 31e3d51c..993436b8 100644
--- a/plexpy/__init__.py
+++ b/plexpy/__init__.py
@@ -2880,7 +2880,6 @@ def analytics_event(name, **kwargs):
     if TRACKER:
         try:
             TRACKER.send(events=[event])
-            pass
         except Exception as e:
             logger.warn("Failed to send analytics event for name '%s': %s" % (name, e))
 

From ce45321e3fd3d188ad29bebd277d9beff3a04278 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 26 Feb 2023 15:17:04 -0800
Subject: [PATCH 331/743] Revert "Add multiprocessing semaphore prefix"

This reverts commit 731d5c9bafab5ad505d8f30afd8a5e3e1128803b.
---
 Tautulli.py | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/Tautulli.py b/Tautulli.py
index 2c03eb3b..eebfa55a 100755
--- a/Tautulli.py
+++ b/Tautulli.py
@@ -29,7 +29,6 @@ import appdirs
 import argparse
 import datetime
 import locale
-import multiprocessing
 import pytz
 import signal
 import shutil
@@ -48,8 +47,6 @@ elif common.PLATFORM == 'Darwin':
 signal.signal(signal.SIGINT, plexpy.sig_handler)
 signal.signal(signal.SIGTERM, plexpy.sig_handler)
 
-multiprocessing.current_process()._config['semprefix'] = '/tautulli.tautulli.mp'
-
 
 def main():
     """

From 993909fa089dcbb21b7d80c46d9f784ad6aeefe9 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 26 Feb 2023 16:17:58 -0800
Subject: [PATCH 332/743] Use private shared-memory for Snap

---
 snap/snapcraft.yaml | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/snap/snapcraft.yaml b/snap/snapcraft.yaml
index 1220971e..030e72a9 100644
--- a/snap/snapcraft.yaml
+++ b/snap/snapcraft.yaml
@@ -15,6 +15,10 @@ architectures:
   - build-on: arm64
   - build-on: armhf
 
+plugs:
+  shared-memory:
+    private: true
+
 parts:
   tautulli:
     plugin: dump

From ae3d75bbe309b835f819d61fadfa46deb7c813e1 Mon Sep 17 00:00:00 2001
From: herby2212 <12448284+herby2212@users.noreply.github.com>
Date: Mon, 27 Feb 2023 02:32:50 +0100
Subject: [PATCH 333/743] watch time & user stats for collections (#1982)

* user_stats for collection

* watch_time_stats for collection

* check for media_type to be compatible with API

* update API and datafactory optimizations

* beautify webserve class

* fix sql query build

* filter on suitable collections

* stats for collections of sub media type

* optimize array creation
---
 data/interfaces/default/info.html | 15 ++++++--
 plexpy/datafactory.py             | 61 ++++++++++++++++++++++---------
 plexpy/webserve.py                | 22 +++++++----
 3 files changed, 69 insertions(+), 29 deletions(-)

diff --git a/data/interfaces/default/info.html b/data/interfaces/default/info.html
index dbce734b..471c8e7e 100644
--- a/data/interfaces/default/info.html
+++ b/data/interfaces/default/info.html
@@ -12,6 +12,7 @@ data :: Usable parameters (if not applicable for media type, blank value will be
 == Global keys ==
 rating_key              Returns the unique identifier for the media item.
 media_type              Returns the type of media. Either 'movie', 'show', 'season', 'episode', 'artist', 'album', or 'track'.
+sub_media_type          Returns the subtype of media. Either 'movie', 'show', 'season', 'episode', 'artist', 'album', or 'track'.
 art                     Returns the location of the item's artwork
 title                   Returns the name of the movie, show, episode, artist, album, or track.
 edition_title            Returns the edition title of a movie.
@@ -553,7 +554,7 @@ DOCUMENTATION :: END
                     </div>
                 </div>
                 % endif
-                % if data['media_type'] in ('movie', 'show', 'season', 'episode', 'artist', 'album', 'track'):
+                % if data['media_type'] in ('movie', 'show', 'season', 'episode', 'artist', 'album', 'track', 'collection'):
                 <div class="col-md-12">
                     <div class="table-card-header">
                         <div class="header-bar">
@@ -936,13 +937,16 @@ DOCUMENTATION :: END
     });
 </script>
 % endif
-% if data['media_type'] in ('movie', 'show', 'season', 'episode', 'artist', 'album', 'track'):
+% if data['media_type'] in ('movie', 'show', 'season', 'episode', 'artist', 'album', 'track', 'collection'):
 <script>
     // Populate watch time stats
     $.ajax({
         url: 'item_watch_time_stats',
         async: true,
-        data: { rating_key: "${data['rating_key']}" },
+        data: { 
+            rating_key: "${data['rating_key']}",
+            media_type: "${data['media_type']}"    
+        },
         complete: function(xhr, status) {
             $("#watch-time-stats").html(xhr.responseText);
         }
@@ -951,7 +955,10 @@ DOCUMENTATION :: END
     $.ajax({
         url: 'item_user_stats',
         async: true,
-        data: { rating_key: "${data['rating_key']}" },
+        data: { 
+            rating_key: "${data['rating_key']}",
+            media_type: "${data['media_type']}"    
+        },
         complete: function(xhr, status) {
             $("#user-stats").html(xhr.responseText);
         }
diff --git a/plexpy/datafactory.py b/plexpy/datafactory.py
index e51b8a46..06f58c36 100644
--- a/plexpy/datafactory.py
+++ b/plexpy/datafactory.py
@@ -1,4 +1,4 @@
-# -*- coding: utf-8 -*-
+# -*- coding: utf-8 -*-
 
 # This file is part of Tautulli.
 #
@@ -1188,7 +1188,7 @@ class DataFactory(object):
 
         return library_stats
 
-    def get_watch_time_stats(self, rating_key=None, grouping=None, query_days=None):
+    def get_watch_time_stats(self, rating_key=None, media_type=None, grouping=None, query_days=None):
         if rating_key is None:
             return []
 
@@ -1210,6 +1210,15 @@ class DataFactory(object):
 
         group_by = 'session_history.reference_id' if grouping else 'session_history.id'
 
+        if media_type == 'collection':
+            pms_connect = pmsconnect.PmsConnect()
+            result = pms_connect.get_item_children(rating_key=rating_key, media_type=media_type)
+            rating_keys = [child['rating_key'] for child in result['children_list']]
+        else:
+            rating_keys = [rating_key]
+
+        rating_keys_arg = ','.join(['?'] * len(rating_keys))
+
         for days in query_days:
             timestamp_query = timestamp - days * 24 * 60 * 60
 
@@ -1221,11 +1230,14 @@ class DataFactory(object):
                                 'COUNT(DISTINCT %s) AS total_plays, section_id ' \
                                 'FROM session_history ' \
                                 'JOIN session_history_metadata ON session_history_metadata.id = session_history.id ' \
-                                'WHERE stopped >= %s ' \
-                                'AND (session_history.grandparent_rating_key = ? ' \
-                                'OR session_history.parent_rating_key = ? ' \
-                                'OR session_history.rating_key = ?)' % (group_by, timestamp_query)
-                        result = monitor_db.select(query, args=[rating_key, rating_key, rating_key])
+                                'WHERE stopped >= ? ' \
+                                'AND (session_history.grandparent_rating_key IN (%s) ' \
+                                'OR session_history.parent_rating_key IN (%s) ' \
+                                'OR session_history.rating_key IN (%s))' % (
+                                    group_by, rating_keys_arg, rating_keys_arg, rating_keys_arg
+                                )
+                        
+                        result = monitor_db.select(query, args=[timestamp_query] + rating_keys * 3)
                     else:
                         result = []
                 else:
@@ -1235,10 +1247,13 @@ class DataFactory(object):
                                 'COUNT(DISTINCT %s) AS total_plays, section_id ' \
                                 'FROM session_history ' \
                                 'JOIN session_history_metadata ON session_history_metadata.id = session_history.id ' \
-                                'WHERE (session_history.grandparent_rating_key = ? ' \
-                                'OR session_history.parent_rating_key = ? ' \
-                                'OR session_history.rating_key = ?)' % group_by
-                        result = monitor_db.select(query, args=[rating_key, rating_key, rating_key])
+                                'WHERE (session_history.grandparent_rating_key IN (%s) ' \
+                                'OR session_history.parent_rating_key IN (%s) ' \
+                                'OR session_history.rating_key IN (%s))' % (
+                                    group_by, rating_keys_arg, rating_keys_arg, rating_keys_arg
+                                )
+                        
+                        result = monitor_db.select(query, args=rating_keys * 3)
                     else:
                         result = []
             except Exception as e:
@@ -1267,7 +1282,7 @@ class DataFactory(object):
 
         return item_watch_time_stats
 
-    def get_user_stats(self, rating_key=None, grouping=None):
+    def get_user_stats(self, rating_key=None, media_type=None, grouping=None):
         if grouping is None:
             grouping = plexpy.CONFIG.GROUP_HISTORY_TABLES
 
@@ -1279,6 +1294,15 @@ class DataFactory(object):
         
         group_by = 'session_history.reference_id' if grouping else 'session_history.id'
 
+        if media_type == 'collection':
+            pms_connect = pmsconnect.PmsConnect()
+            result = pms_connect.get_item_children(rating_key=rating_key, media_type=media_type)
+            rating_keys = [child['rating_key'] for child in result['children_list']]
+        else:
+            rating_keys = [rating_key]
+
+        rating_keys_arg = ','.join(['?'] * len(rating_keys))
+
         try:
             if str(rating_key).isdigit():
                 query = 'SELECT (CASE WHEN users.friendly_name IS NULL OR TRIM(users.friendly_name) = "" ' \
@@ -1290,12 +1314,15 @@ class DataFactory(object):
                         'FROM session_history ' \
                         'JOIN session_history_metadata ON session_history_metadata.id = session_history.id ' \
                         'JOIN users ON users.user_id = session_history.user_id ' \
-                        'WHERE (session_history.grandparent_rating_key = ? ' \
-                        'OR session_history.parent_rating_key = ? ' \
-                        'OR session_history.rating_key = ?) ' \
+                        'WHERE (session_history.grandparent_rating_key IN (%s) ' \
+                        'OR session_history.parent_rating_key IN (%s) ' \
+                        'OR session_history.rating_key IN (%s)) ' \
                         'GROUP BY users.user_id ' \
-                        'ORDER BY total_plays DESC, total_time DESC' % group_by
-                result = monitor_db.select(query, args=[rating_key, rating_key, rating_key])
+                        'ORDER BY total_plays DESC, total_time DESC' % (
+                            group_by, rating_keys_arg, rating_keys_arg, rating_keys_arg
+                        )
+
+                result = monitor_db.select(query, args=rating_keys * 3)
             else:
                 result = []
         except Exception as e:
diff --git a/plexpy/webserve.py b/plexpy/webserve.py
index 963f2ce1..3c960706 100644
--- a/plexpy/webserve.py
+++ b/plexpy/webserve.py
@@ -4431,10 +4431,10 @@ class WebInterface(object):
 
     @cherrypy.expose
     @requireAuth()
-    def item_watch_time_stats(self, rating_key=None, **kwargs):
+    def item_watch_time_stats(self, rating_key=None, media_type=None, **kwargs):
         if rating_key:
             item_data = datafactory.DataFactory()
-            result = item_data.get_watch_time_stats(rating_key=rating_key)
+            result = item_data.get_watch_time_stats(rating_key=rating_key, media_type=media_type)
         else:
             result = None
 
@@ -4446,10 +4446,10 @@ class WebInterface(object):
 
     @cherrypy.expose
     @requireAuth()
-    def item_user_stats(self, rating_key=None, **kwargs):
+    def item_user_stats(self, rating_key=None, media_type=None, **kwargs):
         if rating_key:
             item_data = datafactory.DataFactory()
-            result = item_data.get_user_stats(rating_key=rating_key)
+            result = item_data.get_user_stats(rating_key=rating_key, media_type=media_type)
         else:
             result = None
 
@@ -4463,7 +4463,7 @@ class WebInterface(object):
     @cherrypy.tools.json_out()
     @requireAuth(member_of("admin"))
     @addtoapi()
-    def get_item_watch_time_stats(self, rating_key=None, grouping=None, query_days=None, **kwargs):
+    def get_item_watch_time_stats(self, rating_key=None, media_type=None, grouping=None, query_days=None, **kwargs):
         """  Get the watch time stats for the media item.
 
             ```
@@ -4471,6 +4471,7 @@ class WebInterface(object):
                 rating_key (str):       Rating key of the item
 
             Optional parameters:
+                media_type (str):        Media type of the item (only required for a collection)
                 grouping (int):         0 or 1
                 query_days (str):       Comma separated days, e.g. "1,7,30,0"
 
@@ -4504,7 +4505,9 @@ class WebInterface(object):
 
         if rating_key:
             item_data = datafactory.DataFactory()
-            result = item_data.get_watch_time_stats(rating_key=rating_key, grouping=grouping,
+            result = item_data.get_watch_time_stats(rating_key=rating_key,
+                                                    media_type=media_type,
+                                                    grouping=grouping,
                                                     query_days=query_days)
             if result:
                 return result
@@ -4518,7 +4521,7 @@ class WebInterface(object):
     @cherrypy.tools.json_out()
     @requireAuth(member_of("admin"))
     @addtoapi()
-    def get_item_user_stats(self, rating_key=None, grouping=None, **kwargs):
+    def get_item_user_stats(self, rating_key=None, media_type=None, grouping=None, **kwargs):
         """  Get the user stats for the media item.
 
             ```
@@ -4526,6 +4529,7 @@ class WebInterface(object):
                 rating_key (str):       Rating key of the item
 
             Optional parameters:
+                media_type (str):        Media type of the item (only required for a collection)
                 grouping (int):         0 or 1
 
             Returns:
@@ -4554,7 +4558,9 @@ class WebInterface(object):
 
         if rating_key:
             item_data = datafactory.DataFactory()
-            result = item_data.get_user_stats(rating_key=rating_key, grouping=grouping)
+            result = item_data.get_user_stats(rating_key=rating_key,
+                                              media_type=media_type,
+                                              grouping=grouping)
             if result:
                 return result
             else:

From 0522253194a24d5f12b3d45345f850bf51fba1ce Mon Sep 17 00:00:00 2001
From: herby2212 <12448284+herby2212@users.noreply.github.com>
Date: Wed, 1 Mar 2023 02:33:13 +0100
Subject: [PATCH 334/743] Add watch time & user stats for playlists (#2012)

---
 data/interfaces/default/info.html | 4 ++--
 plexpy/datafactory.py             | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/data/interfaces/default/info.html b/data/interfaces/default/info.html
index 471c8e7e..31c83c05 100644
--- a/data/interfaces/default/info.html
+++ b/data/interfaces/default/info.html
@@ -554,7 +554,7 @@ DOCUMENTATION :: END
                     </div>
                 </div>
                 % endif
-                % if data['media_type'] in ('movie', 'show', 'season', 'episode', 'artist', 'album', 'track', 'collection'):
+                % if data['media_type'] in ('movie', 'show', 'season', 'episode', 'artist', 'album', 'track', 'collection', 'playlist'):
                 <div class="col-md-12">
                     <div class="table-card-header">
                         <div class="header-bar">
@@ -937,7 +937,7 @@ DOCUMENTATION :: END
     });
 </script>
 % endif
-% if data['media_type'] in ('movie', 'show', 'season', 'episode', 'artist', 'album', 'track', 'collection'):
+% if data['media_type'] in ('movie', 'show', 'season', 'episode', 'artist', 'album', 'track', 'collection', 'playlist'):
 <script>
     // Populate watch time stats
     $.ajax({
diff --git a/plexpy/datafactory.py b/plexpy/datafactory.py
index 06f58c36..8eb1d39c 100644
--- a/plexpy/datafactory.py
+++ b/plexpy/datafactory.py
@@ -1210,7 +1210,7 @@ class DataFactory(object):
 
         group_by = 'session_history.reference_id' if grouping else 'session_history.id'
 
-        if media_type == 'collection':
+        if media_type in ('collection', 'playlist'):
             pms_connect = pmsconnect.PmsConnect()
             result = pms_connect.get_item_children(rating_key=rating_key, media_type=media_type)
             rating_keys = [child['rating_key'] for child in result['children_list']]
@@ -1294,7 +1294,7 @@ class DataFactory(object):
         
         group_by = 'session_history.reference_id' if grouping else 'session_history.id'
 
-        if media_type == 'collection':
+        if media_type in ('collection', 'playlist'):
             pms_connect = pmsconnect.PmsConnect()
             result = pms_connect.get_item_children(rating_key=rating_key, media_type=media_type)
             rating_keys = [child['rating_key'] for child in result['children_list']]

From 5c43daf067cfd1f19994abab572906b6ccfb6a03 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 2 Mar 2023 20:01:45 -0800
Subject: [PATCH 335/743] Bump docker/build-push-action from 3 to 4 (#1985)

Bumps [docker/build-push-action](https://github.com/docker/build-push-action) from 3 to 4.
- [Release notes](https://github.com/docker/build-push-action/releases)
- [Commits](https://github.com/docker/build-push-action/compare/v3...v4)

---
updated-dependencies:
- dependency-name: docker/build-push-action
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 .github/workflows/publish-docker.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/publish-docker.yml b/.github/workflows/publish-docker.yml
index 8cb8267f..6480575f 100644
--- a/.github/workflows/publish-docker.yml
+++ b/.github/workflows/publish-docker.yml
@@ -70,7 +70,7 @@ jobs:
           password: ${{ secrets.GHCR_TOKEN }}
 
       - name: Docker Build and Push
-        uses: docker/build-push-action@v3
+        uses: docker/build-push-action@v4
         if: success()
         with:
           context: .

From eaa294b2a203fe6cee946ae502c5a846c0ef91e2 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 2 Mar 2023 20:49:14 -0800
Subject: [PATCH 336/743] Bump importlib-metadata from 5.2.0 to 6.0.0 (#1954)

* Bump importlib-metadata from 5.2.0 to 6.0.0

Bumps [importlib-metadata](https://github.com/python/importlib_metadata) from 5.2.0 to 6.0.0.
- [Release notes](https://github.com/python/importlib_metadata/releases)
- [Changelog](https://github.com/python/importlib_metadata/blob/main/CHANGES.rst)
- [Commits](https://github.com/python/importlib_metadata/compare/v5.2.0...v6.0.0)

---
updated-dependencies:
- dependency-name: importlib-metadata
  dependency-type: direct:production
  update-type: version-update:semver-major
...

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

* Update importlib-metadata==6.0.0

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/importlib_metadata/__init__.py | 2 +-
 package/requirements-package.txt   | 2 +-
 requirements.txt                   | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/lib/importlib_metadata/__init__.py b/lib/importlib_metadata/__init__.py
index 26a1388c..9a36a8e6 100644
--- a/lib/importlib_metadata/__init__.py
+++ b/lib/importlib_metadata/__init__.py
@@ -346,7 +346,7 @@ class FileHash:
         return f'<FileHash mode: {self.mode} value: {self.value}>'
 
 
-class Distribution:
+class Distribution(metaclass=abc.ABCMeta):
     """A Python distribution package."""
 
     @abc.abstractmethod
diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index 93054bda..69f54514 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -1,5 +1,5 @@
 apscheduler==3.9.1.post1
-importlib-metadata==5.2.0
+importlib-metadata==6.0.0
 importlib-resources==5.10.1
 pyinstaller==5.7.0
 pyopenssl==22.1.0
diff --git a/requirements.txt b/requirements.txt
index 6d3fa686..4498847a 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -19,7 +19,7 @@ gntp==1.0.3
 html5lib==1.1
 httpagentparser==1.9.5
 idna==3.4
-importlib-metadata==5.2.0
+importlib-metadata==6.0.0
 importlib-resources==5.10.1
 git+https://github.com/Tautulli/ipwhois.git@master#egg=ipwhois
 IPy==1.01

From c8f43825f9f7ff482c517c41b1f69fef10ef576d Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 2 Mar 2023 20:50:15 -0800
Subject: [PATCH 337/743] Bump importlib-resources from 5.10.1 to 5.12.0
 (#2004)

* Bump importlib-resources from 5.10.1 to 5.12.0

Bumps [importlib-resources](https://github.com/python/importlib_resources) from 5.10.1 to 5.12.0.
- [Release notes](https://github.com/python/importlib_resources/releases)
- [Changelog](https://github.com/python/importlib_resources/blob/main/CHANGES.rst)
- [Commits](https://github.com/python/importlib_resources/compare/v5.10.1...v5.12.0)

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

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

* Update importlib-resources==5.12.0

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/importlib_resources/_adapters.py          |   4 +-
 lib/importlib_resources/_common.py            |   3 +-
 lib/importlib_resources/_compat.py            |   9 +-
 lib/importlib_resources/_itertools.py         |  69 ++++++------
 lib/importlib_resources/readers.py            |  34 +++++-
 lib/importlib_resources/tests/_path.py        |  18 ++--
 .../subdirectory/subsubdir/resource.txt       |   1 +
 .../tests/test_compatibilty_files.py          |   6 +-
 lib/importlib_resources/tests/test_custom.py  |  45 ++++++++
 lib/importlib_resources/tests/test_files.py   |   4 +-
 lib/importlib_resources/tests/test_open.py    |  14 ++-
 lib/importlib_resources/tests/test_path.py    |  15 ++-
 lib/importlib_resources/tests/test_read.py    |  12 ++-
 lib/importlib_resources/tests/test_reader.py  |  11 ++
 .../tests/test_resource.py                    | 100 ++++++++----------
 lib/importlib_resources/tests/util.py         |  28 +++--
 package/requirements-package.txt              |   2 +-
 requirements.txt                              |   2 +-
 18 files changed, 243 insertions(+), 134 deletions(-)
 create mode 100644 lib/importlib_resources/tests/data02/subdirectory/subsubdir/resource.txt
 create mode 100644 lib/importlib_resources/tests/test_custom.py

diff --git a/lib/importlib_resources/_adapters.py b/lib/importlib_resources/_adapters.py
index ea363d86..50688fbb 100644
--- a/lib/importlib_resources/_adapters.py
+++ b/lib/importlib_resources/_adapters.py
@@ -34,9 +34,7 @@ def _io_wrapper(file, mode='r', *args, **kwargs):
         return TextIOWrapper(file, *args, **kwargs)
     elif mode == 'rb':
         return file
-    raise ValueError(
-        "Invalid mode value '{}', only 'r' and 'rb' are supported".format(mode)
-    )
+    raise ValueError(f"Invalid mode value '{mode}', only 'r' and 'rb' are supported")
 
 
 class CompatibilityFiles:
diff --git a/lib/importlib_resources/_common.py b/lib/importlib_resources/_common.py
index 6a338c61..3c6de1cf 100644
--- a/lib/importlib_resources/_common.py
+++ b/lib/importlib_resources/_common.py
@@ -203,6 +203,5 @@ def _write_contents(target, source):
         for item in source.iterdir():
             _write_contents(child, item)
     else:
-        with child.open('wb') as fp:
-            fp.write(source.read_bytes())
+        child.write_bytes(source.read_bytes())
     return child
diff --git a/lib/importlib_resources/_compat.py b/lib/importlib_resources/_compat.py
index 8d7ade08..a93a8826 100644
--- a/lib/importlib_resources/_compat.py
+++ b/lib/importlib_resources/_compat.py
@@ -72,9 +72,6 @@ class TraversableResourcesLoader:
                 return readers.FileReader(self)
 
         return (
-            # native reader if it supplies 'files'
-            _native_reader(self.spec)
-            or
             # local ZipReader if a zip module
             _zip_reader(self.spec)
             or
@@ -83,8 +80,12 @@ class TraversableResourcesLoader:
             or
             # local FileReader
             _file_reader(self.spec)
+            or
+            # native reader if it supplies 'files'
+            _native_reader(self.spec)
+            or
             # fallback - adapt the spec ResourceReader to TraversableReader
-            or _adapters.CompatibilityFiles(self.spec)
+            _adapters.CompatibilityFiles(self.spec)
         )
 
 
diff --git a/lib/importlib_resources/_itertools.py b/lib/importlib_resources/_itertools.py
index cce05582..7b775ef5 100644
--- a/lib/importlib_resources/_itertools.py
+++ b/lib/importlib_resources/_itertools.py
@@ -1,35 +1,38 @@
-from itertools import filterfalse
+# from more_itertools 9.0
+def only(iterable, default=None, too_long=None):
+    """If *iterable* has only one item, return it.
+    If it has zero items, return *default*.
+    If it has more than one item, raise the exception given by *too_long*,
+    which is ``ValueError`` by default.
+    >>> only([], default='missing')
+    'missing'
+    >>> only([1])
+    1
+    >>> only([1, 2])  # doctest: +IGNORE_EXCEPTION_DETAIL
+    Traceback (most recent call last):
+    ...
+    ValueError: Expected exactly one item in iterable, but got 1, 2,
+     and perhaps more.'
+    >>> only([1, 2], too_long=TypeError)  # doctest: +IGNORE_EXCEPTION_DETAIL
+    Traceback (most recent call last):
+    ...
+    TypeError
+    Note that :func:`only` attempts to advance *iterable* twice to ensure there
+    is only one item.  See :func:`spy` or :func:`peekable` to check
+    iterable contents less destructively.
+    """
+    it = iter(iterable)
+    first_value = next(it, default)
 
-from typing import (
-    Callable,
-    Iterable,
-    Iterator,
-    Optional,
-    Set,
-    TypeVar,
-    Union,
-)
-
-# Type and type variable definitions
-_T = TypeVar('_T')
-_U = TypeVar('_U')
-
-
-def unique_everseen(
-    iterable: Iterable[_T], key: Optional[Callable[[_T], _U]] = None
-) -> Iterator[_T]:
-    "List unique elements, preserving order. Remember all elements ever seen."
-    # unique_everseen('AAAABBBCCDAABBB') --> A B C D
-    # unique_everseen('ABBCcAD', str.lower) --> A B C D
-    seen: Set[Union[_T, _U]] = set()
-    seen_add = seen.add
-    if key is None:
-        for element in filterfalse(seen.__contains__, iterable):
-            seen_add(element)
-            yield element
+    try:
+        second_value = next(it)
+    except StopIteration:
+        pass
     else:
-        for element in iterable:
-            k = key(element)
-            if k not in seen:
-                seen_add(k)
-                yield element
+        msg = (
+            'Expected exactly one item in iterable, but got {!r}, {!r}, '
+            'and perhaps more.'.format(first_value, second_value)
+        )
+        raise too_long or ValueError(msg)
+
+    return first_value
diff --git a/lib/importlib_resources/readers.py b/lib/importlib_resources/readers.py
index ab34db74..51d030a6 100644
--- a/lib/importlib_resources/readers.py
+++ b/lib/importlib_resources/readers.py
@@ -1,10 +1,11 @@
 import collections
+import itertools
 import pathlib
 import operator
 
 from . import abc
 
-from ._itertools import unique_everseen
+from ._itertools import only
 from ._compat import ZipPath
 
 
@@ -41,8 +42,10 @@ class ZipReader(abc.TraversableResources):
             raise FileNotFoundError(exc.args[0])
 
     def is_resource(self, path):
-        # workaround for `zipfile.Path.is_file` returning true
-        # for non-existent paths.
+        """
+        Workaround for `zipfile.Path.is_file` returning true
+        for non-existent paths.
+        """
         target = self.files().joinpath(path)
         return target.is_file() and target.exists()
 
@@ -67,8 +70,10 @@ class MultiplexedPath(abc.Traversable):
             raise NotADirectoryError('MultiplexedPath only supports directories')
 
     def iterdir(self):
-        files = (file for path in self._paths for file in path.iterdir())
-        return unique_everseen(files, key=operator.attrgetter('name'))
+        children = (child for path in self._paths for child in path.iterdir())
+        by_name = operator.attrgetter('name')
+        groups = itertools.groupby(sorted(children, key=by_name), key=by_name)
+        return map(self._follow, (locs for name, locs in groups))
 
     def read_bytes(self):
         raise FileNotFoundError(f'{self} is not a file')
@@ -90,6 +95,25 @@ class MultiplexedPath(abc.Traversable):
             # Just return something that will not exist.
             return self._paths[0].joinpath(*descendants)
 
+    @classmethod
+    def _follow(cls, children):
+        """
+        Construct a MultiplexedPath if needed.
+
+        If children contains a sole element, return it.
+        Otherwise, return a MultiplexedPath of the items.
+        Unless one of the items is not a Directory, then return the first.
+        """
+        subdirs, one_dir, one_file = itertools.tee(children, 3)
+
+        try:
+            return only(one_dir)
+        except ValueError:
+            try:
+                return cls(*subdirs)
+            except NotADirectoryError:
+                return next(one_file)
+
     def open(self, *args, **kwargs):
         raise FileNotFoundError(f'{self} is not a file')
 
diff --git a/lib/importlib_resources/tests/_path.py b/lib/importlib_resources/tests/_path.py
index c630e4d3..1f97c961 100644
--- a/lib/importlib_resources/tests/_path.py
+++ b/lib/importlib_resources/tests/_path.py
@@ -1,12 +1,16 @@
 import pathlib
 import functools
 
+from typing import Dict, Union
+
 
 ####
-# from jaraco.path 3.4
+# from jaraco.path 3.4.1
+
+FilesSpec = Dict[str, Union[str, bytes, 'FilesSpec']]  # type: ignore
 
 
-def build(spec, prefix=pathlib.Path()):
+def build(spec: FilesSpec, prefix=pathlib.Path()):
     """
     Build a set of files/directories, as described by the spec.
 
@@ -23,15 +27,17 @@ def build(spec, prefix=pathlib.Path()):
     ...         "baz.py": "# Some code",
     ...     }
     ... }
-    >>> tmpdir = getfixture('tmpdir')
-    >>> build(spec, tmpdir)
+    >>> target = getfixture('tmp_path')
+    >>> build(spec, target)
+    >>> target.joinpath('foo/baz.py').read_text(encoding='utf-8')
+    '# Some code'
     """
     for name, contents in spec.items():
         create(contents, pathlib.Path(prefix) / name)
 
 
 @functools.singledispatch
-def create(content, path):
+def create(content: Union[str, bytes, FilesSpec], path):
     path.mkdir(exist_ok=True)
     build(content, prefix=path)  # type: ignore
 
@@ -43,7 +49,7 @@ def _(content: bytes, path):
 
 @create.register
 def _(content: str, path):
-    path.write_text(content)
+    path.write_text(content, encoding='utf-8')
 
 
 # end from jaraco.path
diff --git a/lib/importlib_resources/tests/data02/subdirectory/subsubdir/resource.txt b/lib/importlib_resources/tests/data02/subdirectory/subsubdir/resource.txt
new file mode 100644
index 00000000..48f587a2
--- /dev/null
+++ b/lib/importlib_resources/tests/data02/subdirectory/subsubdir/resource.txt
@@ -0,0 +1 @@
+a resource
\ No newline at end of file
diff --git a/lib/importlib_resources/tests/test_compatibilty_files.py b/lib/importlib_resources/tests/test_compatibilty_files.py
index d92c7c56..13ad0dfb 100644
--- a/lib/importlib_resources/tests/test_compatibilty_files.py
+++ b/lib/importlib_resources/tests/test_compatibilty_files.py
@@ -64,11 +64,13 @@ class CompatibilityFilesTests(unittest.TestCase):
 
     def test_spec_path_open(self):
         self.assertEqual(self.files.read_bytes(), b'Hello, world!')
-        self.assertEqual(self.files.read_text(), 'Hello, world!')
+        self.assertEqual(self.files.read_text(encoding='utf-8'), 'Hello, world!')
 
     def test_child_path_open(self):
         self.assertEqual((self.files / 'a').read_bytes(), b'Hello, world!')
-        self.assertEqual((self.files / 'a').read_text(), 'Hello, world!')
+        self.assertEqual(
+            (self.files / 'a').read_text(encoding='utf-8'), 'Hello, world!'
+        )
 
     def test_orphan_path_open(self):
         with self.assertRaises(FileNotFoundError):
diff --git a/lib/importlib_resources/tests/test_custom.py b/lib/importlib_resources/tests/test_custom.py
new file mode 100644
index 00000000..e85ddd65
--- /dev/null
+++ b/lib/importlib_resources/tests/test_custom.py
@@ -0,0 +1,45 @@
+import unittest
+import contextlib
+import pathlib
+
+import importlib_resources as resources
+from ..abc import TraversableResources, ResourceReader
+from . import util
+from ._compat import os_helper
+
+
+class SimpleLoader:
+    """
+    A simple loader that only implements a resource reader.
+    """
+
+    def __init__(self, reader: ResourceReader):
+        self.reader = reader
+
+    def get_resource_reader(self, package):
+        return self.reader
+
+
+class MagicResources(TraversableResources):
+    """
+    Magically returns the resources at path.
+    """
+
+    def __init__(self, path: pathlib.Path):
+        self.path = path
+
+    def files(self):
+        return self.path
+
+
+class CustomTraversableResourcesTests(unittest.TestCase):
+    def setUp(self):
+        self.fixtures = contextlib.ExitStack()
+        self.addCleanup(self.fixtures.close)
+
+    def test_custom_loader(self):
+        temp_dir = self.fixtures.enter_context(os_helper.temp_dir())
+        loader = SimpleLoader(MagicResources(temp_dir))
+        pkg = util.create_package_from_loader(loader)
+        files = resources.files(pkg)
+        assert files is temp_dir
diff --git a/lib/importlib_resources/tests/test_files.py b/lib/importlib_resources/tests/test_files.py
index d258fb5f..197a063b 100644
--- a/lib/importlib_resources/tests/test_files.py
+++ b/lib/importlib_resources/tests/test_files.py
@@ -84,7 +84,7 @@ class ModulesFilesTests(SiteDir, unittest.TestCase):
         _path.build(spec, self.site_dir)
         import mod
 
-        actual = resources.files(mod).joinpath('res.txt').read_text()
+        actual = resources.files(mod).joinpath('res.txt').read_text(encoding='utf-8')
         assert actual == spec['res.txt']
 
 
@@ -98,7 +98,7 @@ class ImplicitContextFilesTests(SiteDir, unittest.TestCase):
                 '__init__.py': textwrap.dedent(
                     """
                     import importlib_resources as res
-                    val = res.files().joinpath('res.txt').read_text()
+                    val = res.files().joinpath('res.txt').read_text(encoding='utf-8')
                     """
                 ),
                 'res.txt': 'resources are the best',
diff --git a/lib/importlib_resources/tests/test_open.py b/lib/importlib_resources/tests/test_open.py
index 87b42c3d..83b737dc 100644
--- a/lib/importlib_resources/tests/test_open.py
+++ b/lib/importlib_resources/tests/test_open.py
@@ -15,7 +15,7 @@ class CommonBinaryTests(util.CommonTests, unittest.TestCase):
 class CommonTextTests(util.CommonTests, unittest.TestCase):
     def execute(self, package, path):
         target = resources.files(package).joinpath(path)
-        with target.open():
+        with target.open(encoding='utf-8'):
             pass
 
 
@@ -28,7 +28,7 @@ class OpenTests:
 
     def test_open_text_default_encoding(self):
         target = resources.files(self.data) / 'utf-8.file'
-        with target.open() as fp:
+        with target.open(encoding='utf-8') as fp:
             result = fp.read()
             self.assertEqual(result, 'Hello, UTF-8 world!\n')
 
@@ -39,7 +39,9 @@ class OpenTests:
         self.assertEqual(result, 'Hello, UTF-16 world!\n')
 
     def test_open_text_with_errors(self):
-        # Raises UnicodeError without the 'errors' argument.
+        """
+        Raises UnicodeError without the 'errors' argument.
+        """
         target = resources.files(self.data) / 'utf-16.file'
         with target.open(encoding='utf-8', errors='strict') as fp:
             self.assertRaises(UnicodeError, fp.read)
@@ -54,11 +56,13 @@ class OpenTests:
 
     def test_open_binary_FileNotFoundError(self):
         target = resources.files(self.data) / 'does-not-exist'
-        self.assertRaises(FileNotFoundError, target.open, 'rb')
+        with self.assertRaises(FileNotFoundError):
+            target.open('rb')
 
     def test_open_text_FileNotFoundError(self):
         target = resources.files(self.data) / 'does-not-exist'
-        self.assertRaises(FileNotFoundError, target.open)
+        with self.assertRaises(FileNotFoundError):
+            target.open(encoding='utf-8')
 
 
 class OpenDiskTests(OpenTests, unittest.TestCase):
diff --git a/lib/importlib_resources/tests/test_path.py b/lib/importlib_resources/tests/test_path.py
index 4f4d3943..7cb20003 100644
--- a/lib/importlib_resources/tests/test_path.py
+++ b/lib/importlib_resources/tests/test_path.py
@@ -14,9 +14,12 @@ class CommonTests(util.CommonTests, unittest.TestCase):
 
 class PathTests:
     def test_reading(self):
-        # Path should be readable.
-        # Test also implicitly verifies the returned object is a pathlib.Path
-        # instance.
+        """
+        Path should be readable.
+
+        Test also implicitly verifies the returned object is a pathlib.Path
+        instance.
+        """
         target = resources.files(self.data) / 'utf-8.file'
         with resources.as_file(target) as path:
             self.assertTrue(path.name.endswith("utf-8.file"), repr(path))
@@ -53,8 +56,10 @@ class PathMemoryTests(PathTests, unittest.TestCase):
 
 class PathZipTests(PathTests, util.ZipSetup, unittest.TestCase):
     def test_remove_in_context_manager(self):
-        # It is not an error if the file that was temporarily stashed on the
-        # file system is removed inside the `with` stanza.
+        """
+        It is not an error if the file that was temporarily stashed on the
+        file system is removed inside the `with` stanza.
+        """
         target = resources.files(self.data) / 'utf-8.file'
         with resources.as_file(target) as path:
             path.unlink()
diff --git a/lib/importlib_resources/tests/test_read.py b/lib/importlib_resources/tests/test_read.py
index 41dd6db5..b5aaec45 100644
--- a/lib/importlib_resources/tests/test_read.py
+++ b/lib/importlib_resources/tests/test_read.py
@@ -13,7 +13,7 @@ class CommonBinaryTests(util.CommonTests, unittest.TestCase):
 
 class CommonTextTests(util.CommonTests, unittest.TestCase):
     def execute(self, package, path):
-        resources.files(package).joinpath(path).read_text()
+        resources.files(package).joinpath(path).read_text(encoding='utf-8')
 
 
 class ReadTests:
@@ -22,7 +22,11 @@ class ReadTests:
         self.assertEqual(result, b'\0\1\2\3')
 
     def test_read_text_default_encoding(self):
-        result = resources.files(self.data).joinpath('utf-8.file').read_text()
+        result = (
+            resources.files(self.data)
+            .joinpath('utf-8.file')
+            .read_text(encoding='utf-8')
+        )
         self.assertEqual(result, 'Hello, UTF-8 world!\n')
 
     def test_read_text_given_encoding(self):
@@ -34,7 +38,9 @@ class ReadTests:
         self.assertEqual(result, 'Hello, UTF-16 world!\n')
 
     def test_read_text_with_errors(self):
-        # Raises UnicodeError without the 'errors' argument.
+        """
+        Raises UnicodeError without the 'errors' argument.
+        """
         target = resources.files(self.data) / 'utf-16.file'
         self.assertRaises(UnicodeError, target.read_text, encoding='utf-8')
         result = target.read_text(encoding='utf-8', errors='ignore')
diff --git a/lib/importlib_resources/tests/test_reader.py b/lib/importlib_resources/tests/test_reader.py
index 1c8ebeeb..e2bdf19c 100644
--- a/lib/importlib_resources/tests/test_reader.py
+++ b/lib/importlib_resources/tests/test_reader.py
@@ -81,6 +81,17 @@ class MultiplexedPathTest(unittest.TestCase):
         path = MultiplexedPath(self.folder)
         assert not path.joinpath('imaginary/foo.py').exists()
 
+    def test_join_path_common_subdir(self):
+        prefix = os.path.abspath(os.path.join(__file__, '..'))
+        data01 = os.path.join(prefix, 'data01')
+        data02 = os.path.join(prefix, 'data02')
+        path = MultiplexedPath(data01, data02)
+        self.assertIsInstance(path.joinpath('subdirectory'), MultiplexedPath)
+        self.assertEqual(
+            str(path.joinpath('subdirectory', 'subsubdir'))[len(prefix) + 1 :],
+            os.path.join('data02', 'subdirectory', 'subsubdir'),
+        )
+
     def test_repr(self):
         self.assertEqual(
             repr(MultiplexedPath(self.folder)),
diff --git a/lib/importlib_resources/tests/test_resource.py b/lib/importlib_resources/tests/test_resource.py
index 82390271..677110cd 100644
--- a/lib/importlib_resources/tests/test_resource.py
+++ b/lib/importlib_resources/tests/test_resource.py
@@ -1,3 +1,4 @@
+import contextlib
 import sys
 import unittest
 import importlib_resources as resources
@@ -8,7 +9,7 @@ from . import data01
 from . import zipdata01, zipdata02
 from . import util
 from importlib import import_module
-from ._compat import import_helper, unlink
+from ._compat import import_helper, os_helper, unlink
 
 
 class ResourceTests:
@@ -69,10 +70,12 @@ class ResourceLoaderTests(unittest.TestCase):
 
 class ResourceCornerCaseTests(unittest.TestCase):
     def test_package_has_no_reader_fallback(self):
-        # Test odd ball packages which:
+        """
+        Test odd ball packages which:
         # 1. Do not have a ResourceReader as a loader
         # 2. Are not on the file system
         # 3. Are not in a zip file
+        """
         module = util.create_package(
             file=data01, path=data01.__file__, contents=['A', 'B', 'C']
         )
@@ -138,82 +141,71 @@ class ResourceFromZipsTest02(util.ZipSetupBase, unittest.TestCase):
         )
 
 
+@contextlib.contextmanager
+def zip_on_path(dir):
+    data_path = pathlib.Path(zipdata01.__file__)
+    source_zip_path = data_path.parent.joinpath('ziptestdata.zip')
+    zip_path = pathlib.Path(dir) / f'{uuid.uuid4()}.zip'
+    zip_path.write_bytes(source_zip_path.read_bytes())
+    sys.path.append(str(zip_path))
+    import_module('ziptestdata')
+
+    try:
+        yield
+    finally:
+        with contextlib.suppress(ValueError):
+            sys.path.remove(str(zip_path))
+
+        with contextlib.suppress(KeyError):
+            del sys.path_importer_cache[str(zip_path)]
+            del sys.modules['ziptestdata']
+
+        with contextlib.suppress(OSError):
+            unlink(zip_path)
+
+
 class DeletingZipsTest(unittest.TestCase):
     """Having accessed resources in a zip file should not keep an open
     reference to the zip.
     """
 
-    ZIP_MODULE = zipdata01
-
     def setUp(self):
+        self.fixtures = contextlib.ExitStack()
+        self.addCleanup(self.fixtures.close)
+
         modules = import_helper.modules_setup()
         self.addCleanup(import_helper.modules_cleanup, *modules)
 
-        data_path = pathlib.Path(self.ZIP_MODULE.__file__)
-        data_dir = data_path.parent
-        self.source_zip_path = data_dir / 'ziptestdata.zip'
-        self.zip_path = pathlib.Path(f'{uuid.uuid4()}.zip').absolute()
-        self.zip_path.write_bytes(self.source_zip_path.read_bytes())
-        sys.path.append(str(self.zip_path))
-        self.data = import_module('ziptestdata')
-
-    def tearDown(self):
-        try:
-            sys.path.remove(str(self.zip_path))
-        except ValueError:
-            pass
-
-        try:
-            del sys.path_importer_cache[str(self.zip_path)]
-            del sys.modules[self.data.__name__]
-        except KeyError:
-            pass
-
-        try:
-            unlink(self.zip_path)
-        except OSError:
-            # If the test fails, this will probably fail too
-            pass
+        temp_dir = self.fixtures.enter_context(os_helper.temp_dir())
+        self.fixtures.enter_context(zip_on_path(temp_dir))
 
     def test_iterdir_does_not_keep_open(self):
-        c = [item.name for item in resources.files('ziptestdata').iterdir()]
-        self.zip_path.unlink()
-        del c
+        [item.name for item in resources.files('ziptestdata').iterdir()]
 
     def test_is_file_does_not_keep_open(self):
-        c = resources.files('ziptestdata').joinpath('binary.file').is_file()
-        self.zip_path.unlink()
-        del c
+        resources.files('ziptestdata').joinpath('binary.file').is_file()
 
     def test_is_file_failure_does_not_keep_open(self):
-        c = resources.files('ziptestdata').joinpath('not-present').is_file()
-        self.zip_path.unlink()
-        del c
+        resources.files('ziptestdata').joinpath('not-present').is_file()
 
     @unittest.skip("Desired but not supported.")
     def test_as_file_does_not_keep_open(self):  # pragma: no cover
-        c = resources.as_file(resources.files('ziptestdata') / 'binary.file')
-        self.zip_path.unlink()
-        del c
+        resources.as_file(resources.files('ziptestdata') / 'binary.file')
 
     def test_entered_path_does_not_keep_open(self):
-        # This is what certifi does on import to make its bundle
-        # available for the process duration.
-        c = resources.as_file(
-            resources.files('ziptestdata') / 'binary.file'
-        ).__enter__()
-        self.zip_path.unlink()
-        del c
+        """
+        Mimic what certifi does on import to make its bundle
+        available for the process duration.
+        """
+        resources.as_file(resources.files('ziptestdata') / 'binary.file').__enter__()
 
     def test_read_binary_does_not_keep_open(self):
-        c = resources.files('ziptestdata').joinpath('binary.file').read_bytes()
-        self.zip_path.unlink()
-        del c
+        resources.files('ziptestdata').joinpath('binary.file').read_bytes()
 
     def test_read_text_does_not_keep_open(self):
-        c = resources.files('ziptestdata').joinpath('utf-8.file').read_text()
-        self.zip_path.unlink()
-        del c
+        resources.files('ziptestdata').joinpath('utf-8.file').read_text(
+            encoding='utf-8'
+        )
 
 
 class ResourceFromNamespaceTest01(unittest.TestCase):
diff --git a/lib/importlib_resources/tests/util.py b/lib/importlib_resources/tests/util.py
index b596c0ce..ce0e6fad 100644
--- a/lib/importlib_resources/tests/util.py
+++ b/lib/importlib_resources/tests/util.py
@@ -80,32 +80,44 @@ class CommonTests(metaclass=abc.ABCMeta):
         """
 
     def test_package_name(self):
-        # Passing in the package name should succeed.
+        """
+        Passing in the package name should succeed.
+        """
         self.execute(data01.__name__, 'utf-8.file')
 
     def test_package_object(self):
-        # Passing in the package itself should succeed.
+        """
+        Passing in the package itself should succeed.
+        """
         self.execute(data01, 'utf-8.file')
 
     def test_string_path(self):
-        # Passing in a string for the path should succeed.
+        """
+        Passing in a string for the path should succeed.
+        """
         path = 'utf-8.file'
         self.execute(data01, path)
 
     def test_pathlib_path(self):
-        # Passing in a pathlib.PurePath object for the path should succeed.
+        """
+        Passing in a pathlib.PurePath object for the path should succeed.
+        """
         path = pathlib.PurePath('utf-8.file')
         self.execute(data01, path)
 
     def test_importing_module_as_side_effect(self):
-        # The anchor package can already be imported.
+        """
+        The anchor package can already be imported.
+        """
         del sys.modules[data01.__name__]
         self.execute(data01.__name__, 'utf-8.file')
 
     def test_missing_path(self):
-        # Attempting to open or read or request the path for a
-        # non-existent path should succeed if open_resource
-        # can return a viable data stream.
+        """
+        Attempting to open or read or request the path for a
+        non-existent path should succeed if open_resource
+        can return a viable data stream.
+        """
         bytes_data = io.BytesIO(b'Hello, world!')
         package = create_package(file=bytes_data, path=FileNotFoundError())
         self.execute(package, 'utf-8.file')
diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index 69f54514..bbd322c3 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -1,6 +1,6 @@
 apscheduler==3.9.1.post1
 importlib-metadata==6.0.0
-importlib-resources==5.10.1
+importlib-resources==5.12.0
 pyinstaller==5.7.0
 pyopenssl==22.1.0
 pycryptodomex==3.16.0
diff --git a/requirements.txt b/requirements.txt
index 4498847a..7b65b814 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -20,7 +20,7 @@ html5lib==1.1
 httpagentparser==1.9.5
 idna==3.4
 importlib-metadata==6.0.0
-importlib-resources==5.10.1
+importlib-resources==5.12.0
 git+https://github.com/Tautulli/ipwhois.git@master#egg=ipwhois
 IPy==1.01
 Mako==1.2.4

From 1f59171dcb361382eea8fe69f1516946b0674293 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 2 Mar 2023 20:50:33 -0800
Subject: [PATCH 338/743] Bump zipp from 3.11.0 to 3.15.0 (#2011)

* Bump zipp from 3.11.0 to 3.15.0

Bumps [zipp](https://github.com/jaraco/zipp) from 3.11.0 to 3.15.0.
- [Release notes](https://github.com/jaraco/zipp/releases)
- [Changelog](https://github.com/jaraco/zipp/blob/main/CHANGES.rst)
- [Commits](https://github.com/jaraco/zipp/compare/v3.11.0...v3.15.0)

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

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

* Update zipp==3.15.0

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/zipp/__init__.py | 41 +++++++++++++++++++++++++++++++----------
 requirements.txt     |  2 +-
 2 files changed, 32 insertions(+), 11 deletions(-)

diff --git a/lib/zipp/__init__.py b/lib/zipp/__init__.py
index ad01e27e..ddfa0a64 100644
--- a/lib/zipp/__init__.py
+++ b/lib/zipp/__init__.py
@@ -88,6 +88,11 @@ class CompleteDirs(InitializedState, zipfile.ZipFile):
     """
     A ZipFile subclass that ensures that implied directories
     are always included in the namelist.
+
+    >>> list(CompleteDirs._implied_dirs(['foo/bar.txt', 'foo/bar/baz.txt']))
+    ['foo/', 'foo/bar/']
+    >>> list(CompleteDirs._implied_dirs(['foo/bar.txt', 'foo/bar/baz.txt', 'foo/bar/']))
+    ['foo/']
     """
 
     @staticmethod
@@ -97,7 +102,7 @@ class CompleteDirs(InitializedState, zipfile.ZipFile):
         return _dedupe(_difference(as_dirs, names))
 
     def namelist(self):
-        names = super(CompleteDirs, self).namelist()
+        names = super().namelist()
         return names + list(self._implied_dirs(names))
 
     def _name_set(self):
@@ -113,6 +118,17 @@ class CompleteDirs(InitializedState, zipfile.ZipFile):
         dir_match = name not in names and dirname in names
         return dirname if dir_match else name
 
+    def getinfo(self, name):
+        """
+        Supplement getinfo for implied dirs.
+        """
+        try:
+            return super().getinfo(name)
+        except KeyError:
+            if not name.endswith('/') or name not in self._name_set():
+                raise
+            return zipfile.ZipInfo(filename=name)
+
     @classmethod
     def make(cls, source):
         """
@@ -142,16 +158,21 @@ class FastLookup(CompleteDirs):
     def namelist(self):
         with contextlib.suppress(AttributeError):
             return self.__names
-        self.__names = super(FastLookup, self).namelist()
+        self.__names = super().namelist()
         return self.__names
 
     def _name_set(self):
         with contextlib.suppress(AttributeError):
             return self.__lookup
-        self.__lookup = super(FastLookup, self)._name_set()
+        self.__lookup = super()._name_set()
         return self.__lookup
 
 
+def _extract_text_encoding(encoding=None, *args, **kwargs):
+    # stacklevel=3 so that the caller of the caller see any warning.
+    return text_encoding(encoding, 3), args, kwargs
+
+
 class Path:
     """
     A pathlib-compatible interface for zip files.
@@ -201,7 +222,7 @@ class Path:
 
     Read text:
 
-    >>> c.read_text()
+    >>> c.read_text(encoding='utf-8')
     'content of c'
 
     existence:
@@ -273,9 +294,9 @@ class Path:
             if args or kwargs:
                 raise ValueError("encoding args invalid for binary operation")
             return stream
-        else:
-            kwargs["encoding"] = text_encoding(kwargs.get("encoding"))
-        return io.TextIOWrapper(stream, *args, **kwargs)
+        # Text mode:
+        encoding, args, kwargs = _extract_text_encoding(*args, **kwargs)
+        return io.TextIOWrapper(stream, encoding, *args, **kwargs)
 
     @property
     def name(self):
@@ -298,8 +319,8 @@ class Path:
         return pathlib.Path(self.root.filename).joinpath(self.at)
 
     def read_text(self, *args, **kwargs):
-        kwargs["encoding"] = text_encoding(kwargs.get("encoding"))
-        with self.open('r', *args, **kwargs) as strm:
+        encoding, args, kwargs = _extract_text_encoding(*args, **kwargs)
+        with self.open('r', encoding, *args, **kwargs) as strm:
             return strm.read()
 
     def read_bytes(self):
@@ -344,7 +365,7 @@ class Path:
 
     def glob(self, pattern):
         if not pattern:
-            raise ValueError("Unacceptable pattern: {!r}".format(pattern))
+            raise ValueError(f"Unacceptable pattern: {pattern!r}")
 
         matches = re.compile(fnmatch.translate(pattern)).fullmatch
         return (
diff --git a/requirements.txt b/requirements.txt
index 7b65b814..00beccf9 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -50,7 +50,7 @@ urllib3==1.26.13
 webencodings==0.5.1
 websocket-client==1.4.2
 xmltodict==0.13.0
-zipp==3.11.0
+zipp==3.15.0
 
 # configobj==5.1.0
 # sgmllib3k==1.0.0

From 70e09582da01ceffa1c25f82d22399edbbbad3eb Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 2 Mar 2023 20:53:00 -0800
Subject: [PATCH 339/743] Bump packaging from 22.0 to 23.0 (#1964)

* Bump packaging from 22.0 to 23.0

Bumps [packaging](https://github.com/pypa/packaging) from 22.0 to 23.0.
- [Release notes](https://github.com/pypa/packaging/releases)
- [Changelog](https://github.com/pypa/packaging/blob/main/CHANGELOG.rst)
- [Commits](https://github.com/pypa/packaging/compare/22.0...23.0)

---
updated-dependencies:
- dependency-name: packaging
  dependency-type: direct:production
  update-type: version-update:semver-major
...

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

* Update packaging==23.0

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/packaging/__about__.py  | 26 --------------------
 lib/packaging/__init__.py   | 30 ++++++++---------------
 lib/packaging/_elffile.py   |  2 +-
 lib/packaging/_parser.py    | 23 +++++++----------
 lib/packaging/_tokenizer.py |  6 +++--
 lib/packaging/markers.py    |  4 +++
 lib/packaging/specifiers.py | 37 ++++++++++++++++++----------
 lib/packaging/tags.py       | 49 +++++++++++++++++++++++++++++++++----
 requirements.txt            |  2 +-
 9 files changed, 97 insertions(+), 82 deletions(-)
 delete mode 100644 lib/packaging/__about__.py

diff --git a/lib/packaging/__about__.py b/lib/packaging/__about__.py
deleted file mode 100644
index 1391863f..00000000
--- a/lib/packaging/__about__.py
+++ /dev/null
@@ -1,26 +0,0 @@
-# This file is dual licensed under the terms of the Apache License, Version
-# 2.0, and the BSD License. See the LICENSE file in the root of this repository
-# for complete details.
-
-__all__ = [
-    "__title__",
-    "__summary__",
-    "__uri__",
-    "__version__",
-    "__author__",
-    "__email__",
-    "__license__",
-    "__copyright__",
-]
-
-__title__ = "packaging"
-__summary__ = "Core utilities for Python packages"
-__uri__ = "https://github.com/pypa/packaging"
-
-__version__ = "22.0"
-
-__author__ = "Donald Stufft and individual contributors"
-__email__ = "donald@stufft.io"
-
-__license__ = "BSD-2-Clause or Apache-2.0"
-__copyright__ = "2014-2019 %s" % __author__
diff --git a/lib/packaging/__init__.py b/lib/packaging/__init__.py
index 3c50c5dc..4112fec0 100644
--- a/lib/packaging/__init__.py
+++ b/lib/packaging/__init__.py
@@ -2,24 +2,14 @@
 # 2.0, and the BSD License. See the LICENSE file in the root of this repository
 # for complete details.
 
-from .__about__ import (
-    __author__,
-    __copyright__,
-    __email__,
-    __license__,
-    __summary__,
-    __title__,
-    __uri__,
-    __version__,
-)
+__title__ = "packaging"
+__summary__ = "Core utilities for Python packages"
+__uri__ = "https://github.com/pypa/packaging"
 
-__all__ = [
-    "__title__",
-    "__summary__",
-    "__uri__",
-    "__version__",
-    "__author__",
-    "__email__",
-    "__license__",
-    "__copyright__",
-]
+__version__ = "23.0"
+
+__author__ = "Donald Stufft and individual contributors"
+__email__ = "donald@stufft.io"
+
+__license__ = "BSD-2-Clause or Apache-2.0"
+__copyright__ = "2014-2019 %s" % __author__
diff --git a/lib/packaging/_elffile.py b/lib/packaging/_elffile.py
index 9fb5984b..6fb19b30 100644
--- a/lib/packaging/_elffile.py
+++ b/lib/packaging/_elffile.py
@@ -53,7 +53,7 @@ class ELFFile:
             raise ELFInvalid(f"invalid magic: {magic!r}")
 
         self.capacity = ident[4]  # Format for program header (bitness).
-        self.encoding = ident[5]  # Data structure encoding (endianess).
+        self.encoding = ident[5]  # Data structure encoding (endianness).
 
         try:
             # e_fmt: Format for program header.
diff --git a/lib/packaging/_parser.py b/lib/packaging/_parser.py
index 4dcf03d1..2bc6a8f9 100644
--- a/lib/packaging/_parser.py
+++ b/lib/packaging/_parser.py
@@ -43,7 +43,7 @@ MarkerVar = Union[Variable, Value]
 MarkerItem = Tuple[MarkerVar, Op, MarkerVar]
 # MarkerAtom = Union[MarkerItem, List["MarkerAtom"]]
 # MarkerList = List[Union["MarkerList", MarkerAtom, str]]
-# mypy does not suport recursive type definition
+# mypy does not support recursive type definition
 # https://github.com/python/mypy/issues/731
 MarkerAtom = Any
 MarkerList = List[Any]
@@ -89,7 +89,7 @@ def _parse_requirement_details(
     tokenizer: Tokenizer,
 ) -> Tuple[str, str, Optional[MarkerList]]:
     """
-    requirement_details = AT URL (WS requirement_marker)?
+    requirement_details = AT URL (WS requirement_marker?)?
                         | specifier WS? (requirement_marker)?
     """
 
@@ -108,6 +108,10 @@ def _parse_requirement_details(
 
         tokenizer.expect("WS", expected="whitespace after URL")
 
+        # The input might end after whitespace.
+        if tokenizer.check("END", peek=True):
+            return (url, specifier, marker)
+
         marker = _parse_requirement_marker(
             tokenizer, span_start=url_start, after="URL and whitespace"
         )
@@ -144,8 +148,7 @@ def _parse_requirement_marker(
             f"Expected end or semicolon (after {after})",
             span_start=span_start,
         )
-    else:
-        tokenizer.read()
+    tokenizer.read()
 
     marker = _parse_marker(tokenizer)
     tokenizer.consume("WS")
@@ -210,20 +213,12 @@ def _parse_specifier(tokenizer: Tokenizer) -> str:
 
 def _parse_version_many(tokenizer: Tokenizer) -> str:
     """
-    version_many = (OP VERSION (COMMA OP VERSION)*)?
+    version_many = (SPECIFIER (WS? COMMA WS? SPECIFIER)*)?
     """
     parsed_specifiers = ""
-    while tokenizer.check("OP"):
+    while tokenizer.check("SPECIFIER"):
         parsed_specifiers += tokenizer.read().text
-
-        # We intentionally do not consume whitespace here, since the regular expression
-        # for `VERSION` uses a lookback for the operator, to determine what
-        # corresponding syntax is permitted.
-
-        version_token = tokenizer.expect("VERSION", expected="version after operator")
-        parsed_specifiers += version_token.text
         tokenizer.consume("WS")
-
         if not tokenizer.check("COMMA"):
             break
         parsed_specifiers += tokenizer.read().text
diff --git a/lib/packaging/_tokenizer.py b/lib/packaging/_tokenizer.py
index de389cb3..b1fb207c 100644
--- a/lib/packaging/_tokenizer.py
+++ b/lib/packaging/_tokenizer.py
@@ -35,7 +35,6 @@ class ParserSyntaxError(Exception):
 
 
 DEFAULT_RULES: "Dict[str, Union[str, re.Pattern[str]]]" = {
-    "LPAREN": r"\s*\(",
     "LEFT_PARENTHESIS": r"\(",
     "RIGHT_PARENTHESIS": r"\)",
     "LEFT_BRACKET": r"\[",
@@ -72,7 +71,10 @@ DEFAULT_RULES: "Dict[str, Union[str, re.Pattern[str]]]" = {
         """,
         re.VERBOSE,
     ),
-    "VERSION": re.compile(Specifier._version_regex_str, re.VERBOSE | re.IGNORECASE),
+    "SPECIFIER": re.compile(
+        Specifier._operator_regex_str + Specifier._version_regex_str,
+        re.VERBOSE | re.IGNORECASE,
+    ),
     "AT": r"\@",
     "URL": r"[^ \t]+",
     "IDENTIFIER": r"\b[a-zA-Z0-9][a-zA-Z0-9._-]*\b",
diff --git a/lib/packaging/markers.py b/lib/packaging/markers.py
index a5bf35c6..68369c98 100644
--- a/lib/packaging/markers.py
+++ b/lib/packaging/markers.py
@@ -237,5 +237,9 @@ class Marker:
         current_environment["extra"] = ""
         if environment is not None:
             current_environment.update(environment)
+            # The API used to allow setting extra to None. We need to handle this
+            # case for backwards compatibility.
+            if current_environment["extra"] is None:
+                current_environment["extra"] = ""
 
         return _evaluate_markers(self._markers, current_environment)
diff --git a/lib/packaging/specifiers.py b/lib/packaging/specifiers.py
index 645214ae..e715ecc8 100644
--- a/lib/packaging/specifiers.py
+++ b/lib/packaging/specifiers.py
@@ -11,12 +11,23 @@
 import abc
 import itertools
 import re
-from typing import Callable, Iterable, Iterator, List, Optional, Set, Tuple, Union
+from typing import (
+    Callable,
+    Iterable,
+    Iterator,
+    List,
+    Optional,
+    Set,
+    Tuple,
+    TypeVar,
+    Union,
+)
 
 from .utils import canonicalize_version
 from .version import Version
 
 UnparsedVersion = Union[Version, str]
+UnparsedVersionVar = TypeVar("UnparsedVersionVar", bound=UnparsedVersion)
 CallableOperator = Callable[[Version, str], bool]
 
 
@@ -85,8 +96,8 @@ class BaseSpecifier(metaclass=abc.ABCMeta):
 
     @abc.abstractmethod
     def filter(
-        self, iterable: Iterable[UnparsedVersion], prereleases: Optional[bool] = None
-    ) -> Iterator[UnparsedVersion]:
+        self, iterable: Iterable[UnparsedVersionVar], prereleases: Optional[bool] = None
+    ) -> Iterator[UnparsedVersionVar]:
         """
         Takes an iterable of items and filters them so that only items which
         are contained within this specifier are allowed in it.
@@ -140,7 +151,7 @@ class Specifier(BaseSpecifier):
                     |
                     (?:                                  # pre release
                         [-_\.]?
-                        (a|b|c|rc|alpha|beta|pre|preview)
+                        (alpha|beta|preview|pre|a|b|c|rc)
                         [-_\.]?
                         [0-9]*
                     )?
@@ -163,7 +174,7 @@ class Specifier(BaseSpecifier):
                 [0-9]+(?:\.[0-9]+)+   # release  (We have a + instead of a *)
                 (?:                   # pre release
                     [-_\.]?
-                    (a|b|c|rc|alpha|beta|pre|preview)
+                    (alpha|beta|preview|pre|a|b|c|rc)
                     [-_\.]?
                     [0-9]*
                 )?
@@ -188,7 +199,7 @@ class Specifier(BaseSpecifier):
                 [0-9]+(?:\.[0-9]+)*   # release
                 (?:                   # pre release
                     [-_\.]?
-                    (a|b|c|rc|alpha|beta|pre|preview)
+                    (alpha|beta|preview|pre|a|b|c|rc)
                     [-_\.]?
                     [0-9]*
                 )?
@@ -565,8 +576,8 @@ class Specifier(BaseSpecifier):
         return operator_callable(normalized_item, self.version)
 
     def filter(
-        self, iterable: Iterable[UnparsedVersion], prereleases: Optional[bool] = None
-    ) -> Iterator[UnparsedVersion]:
+        self, iterable: Iterable[UnparsedVersionVar], prereleases: Optional[bool] = None
+    ) -> Iterator[UnparsedVersionVar]:
         """Filter items in the given iterable, that match the specifier.
 
         :param iterable:
@@ -606,7 +617,7 @@ class Specifier(BaseSpecifier):
 
             if self.contains(parsed_version, **kw):
                 # If our version is a prerelease, and we were not set to allow
-                # prereleases, then we'll store it for later incase nothing
+                # prereleases, then we'll store it for later in case nothing
                 # else matches this specifier.
                 if parsed_version.is_prerelease and not (
                     prereleases or self.prereleases
@@ -915,8 +926,8 @@ class SpecifierSet(BaseSpecifier):
         return all(s.contains(item, prereleases=prereleases) for s in self._specs)
 
     def filter(
-        self, iterable: Iterable[UnparsedVersion], prereleases: Optional[bool] = None
-    ) -> Iterator[UnparsedVersion]:
+        self, iterable: Iterable[UnparsedVersionVar], prereleases: Optional[bool] = None
+    ) -> Iterator[UnparsedVersionVar]:
         """Filter items in the given iterable, that match the specifiers in this set.
 
         :param iterable:
@@ -972,8 +983,8 @@ class SpecifierSet(BaseSpecifier):
         # which will filter out any pre-releases, unless there are no final
         # releases.
         else:
-            filtered: List[UnparsedVersion] = []
-            found_prereleases: List[UnparsedVersion] = []
+            filtered: List[UnparsedVersionVar] = []
+            found_prereleases: List[UnparsedVersionVar] = []
 
             for item in iterable:
                 parsed_version = _coerce_version(item)
diff --git a/lib/packaging/tags.py b/lib/packaging/tags.py
index a0e1ea23..19ccbde3 100644
--- a/lib/packaging/tags.py
+++ b/lib/packaging/tags.py
@@ -225,10 +225,45 @@ def cpython_tags(
                 yield Tag(interpreter, "abi3", platform_)
 
 
-def _generic_abi() -> Iterator[str]:
-    abi = sysconfig.get_config_var("SOABI")
-    if abi:
-        yield _normalize_string(abi)
+def _generic_abi() -> List[str]:
+    """
+    Return the ABI tag based on EXT_SUFFIX.
+    """
+    # The following are examples of `EXT_SUFFIX`.
+    # We want to keep the parts which are related to the ABI and remove the
+    # parts which are related to the platform:
+    # - linux:   '.cpython-310-x86_64-linux-gnu.so' => cp310
+    # - mac:     '.cpython-310-darwin.so'           => cp310
+    # - win:     '.cp310-win_amd64.pyd'             => cp310
+    # - win:     '.pyd'                             => cp37 (uses _cpython_abis())
+    # - pypy:    '.pypy38-pp73-x86_64-linux-gnu.so' => pypy38_pp73
+    # - graalpy: '.graalpy-38-native-x86_64-darwin.dylib'
+    #                                               => graalpy_38_native
+
+    ext_suffix = _get_config_var("EXT_SUFFIX", warn=True)
+    if not isinstance(ext_suffix, str) or ext_suffix[0] != ".":
+        raise SystemError("invalid sysconfig.get_config_var('EXT_SUFFIX')")
+    parts = ext_suffix.split(".")
+    if len(parts) < 3:
+        # CPython3.7 and earlier uses ".pyd" on Windows.
+        return _cpython_abis(sys.version_info[:2])
+    soabi = parts[1]
+    if soabi.startswith("cpython"):
+        # non-windows
+        abi = "cp" + soabi.split("-")[1]
+    elif soabi.startswith("cp"):
+        # windows
+        abi = soabi.split("-")[0]
+    elif soabi.startswith("pypy"):
+        abi = "-".join(soabi.split("-")[:2])
+    elif soabi.startswith("graalpy"):
+        abi = "-".join(soabi.split("-")[:3])
+    elif soabi:
+        # pyston, ironpython, others?
+        abi = soabi
+    else:
+        return []
+    return [_normalize_string(abi)]
 
 
 def generic_tags(
@@ -252,8 +287,9 @@ def generic_tags(
         interpreter = "".join([interp_name, interp_version])
     if abis is None:
         abis = _generic_abi()
+    else:
+        abis = list(abis)
     platforms = list(platforms or platform_tags())
-    abis = list(abis)
     if "none" not in abis:
         abis.append("none")
     for abi in abis:
@@ -463,6 +499,9 @@ def platform_tags() -> Iterator[str]:
 def interpreter_name() -> str:
     """
     Returns the name of the running interpreter.
+
+    Some implementations have a reserved, two-letter abbreviation which will
+    be returned when appropriate.
     """
     name = sys.implementation.name
     return INTERPRETER_SHORT_NAMES.get(name) or name
diff --git a/requirements.txt b/requirements.txt
index 00beccf9..80de6d04 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -26,7 +26,7 @@ IPy==1.01
 Mako==1.2.4
 MarkupSafe==2.1.1
 musicbrainzngs==0.7.1
-packaging==22.0
+packaging==23.0
 paho-mqtt==1.6.1
 plexapi==4.13.2
 portend==3.1.0

From cc78f17be560c6cf41ecdd3fa14354a13b8cb6e4 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 2 Mar 2023 20:53:15 -0800
Subject: [PATCH 340/743] Bump requests from 2.28.1 to 2.28.2 (#1968)

* Bump requests from 2.28.1 to 2.28.2

Bumps [requests](https://github.com/psf/requests) from 2.28.1 to 2.28.2.
- [Release notes](https://github.com/psf/requests/releases)
- [Changelog](https://github.com/psf/requests/blob/main/HISTORY.md)
- [Commits](https://github.com/psf/requests/compare/v2.28.1...v2.28.2)

---
updated-dependencies:
- dependency-name: requests
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

* Update requests==2.28.2

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/charset_normalizer/__init__.py        |  15 +-
 lib/charset_normalizer/api.py             |  79 ++--
 lib/charset_normalizer/assets/__init__.py | 446 ++++++++++++++++++----
 lib/charset_normalizer/cd.py              |  74 +++-
 lib/charset_normalizer/cli/normalizer.py  |  23 +-
 lib/charset_normalizer/constant.py        |   4 +-
 lib/charset_normalizer/legacy.py          |  54 +--
 lib/charset_normalizer/md.py              |  24 +-
 lib/charset_normalizer/models.py          |  70 +---
 lib/charset_normalizer/utils.py           |  10 +-
 lib/charset_normalizer/version.py         |   2 +-
 lib/requests/__init__.py                  |   4 +-
 lib/requests/__version__.py               |   6 +-
 lib/requests/models.py                    |   2 +-
 lib/urllib3/_version.py                   |   2 +-
 lib/urllib3/contrib/appengine.py          |   2 +-
 lib/urllib3/contrib/ntlmpool.py           |   4 +-
 lib/urllib3/response.py                   |   4 +-
 lib/urllib3/util/url.py                   |   2 +-
 requirements.txt                          |   2 +-
 20 files changed, 527 insertions(+), 302 deletions(-)

diff --git a/lib/charset_normalizer/__init__.py b/lib/charset_normalizer/__init__.py
index 2dcaf56f..ebb5da89 100644
--- a/lib/charset_normalizer/__init__.py
+++ b/lib/charset_normalizer/__init__.py
@@ -21,14 +21,8 @@ at <https://github.com/Ousret/charset_normalizer>.
 """
 import logging
 
-from .api import from_bytes, from_fp, from_path, normalize
-from .legacy import (
-    CharsetDetector,
-    CharsetDoctor,
-    CharsetNormalizerMatch,
-    CharsetNormalizerMatches,
-    detect,
-)
+from .api import from_bytes, from_fp, from_path
+from .legacy import detect
 from .models import CharsetMatch, CharsetMatches
 from .utils import set_logging_handler
 from .version import VERSION, __version__
@@ -37,14 +31,9 @@ __all__ = (
     "from_fp",
     "from_path",
     "from_bytes",
-    "normalize",
     "detect",
     "CharsetMatch",
     "CharsetMatches",
-    "CharsetNormalizerMatch",
-    "CharsetNormalizerMatches",
-    "CharsetDetector",
-    "CharsetDoctor",
     "__version__",
     "VERSION",
     "set_logging_handler",
diff --git a/lib/charset_normalizer/api.py b/lib/charset_normalizer/api.py
index 72907f94..6c7e8983 100644
--- a/lib/charset_normalizer/api.py
+++ b/lib/charset_normalizer/api.py
@@ -1,7 +1,5 @@
 import logging
-import warnings
 from os import PathLike
-from os.path import basename, splitext
 from typing import Any, BinaryIO, List, Optional, Set
 
 from .cd import (
@@ -41,11 +39,12 @@ def from_bytes(
     cp_exclusion: Optional[List[str]] = None,
     preemptive_behaviour: bool = True,
     explain: bool = False,
+    language_threshold: float = 0.1,
 ) -> CharsetMatches:
     """
     Given a raw bytes sequence, return the best possibles charset usable to render str objects.
     If there is no results, it is a strong indicator that the source is binary/not text.
-    By default, the process will extract 5 blocs of 512o each to assess the mess and coherence of a given sequence.
+    By default, the process will extract 5 blocks of 512o each to assess the mess and coherence of a given sequence.
     And will give up a particular code page after 20% of measured mess. Those criteria are customizable at will.
 
     The preemptive behavior DOES NOT replace the traditional detection workflow, it prioritize a particular code page
@@ -197,7 +196,14 @@ def from_bytes(
         if encoding_iana in {"utf_16", "utf_32"} and not bom_or_sig_available:
             logger.log(
                 TRACE,
-                "Encoding %s wont be tested as-is because it require a BOM. Will try some sub-encoder LE/BE.",
+                "Encoding %s won't be tested as-is because it require a BOM. Will try some sub-encoder LE/BE.",
+                encoding_iana,
+            )
+            continue
+        if encoding_iana in {"utf_7"} and not bom_or_sig_available:
+            logger.log(
+                TRACE,
+                "Encoding %s won't be tested as-is because detection is unreliable without BOM/SIG.",
                 encoding_iana,
             )
             continue
@@ -297,7 +303,13 @@ def from_bytes(
             ):
                 md_chunks.append(chunk)
 
-                md_ratios.append(mess_ratio(chunk, threshold))
+                md_ratios.append(
+                    mess_ratio(
+                        chunk,
+                        threshold,
+                        explain is True and 1 <= len(cp_isolation) <= 2,
+                    )
+                )
 
                 if md_ratios[-1] >= threshold:
                     early_stop_count += 1
@@ -389,7 +401,9 @@ def from_bytes(
         if encoding_iana != "ascii":
             for chunk in md_chunks:
                 chunk_languages = coherence_ratio(
-                    chunk, 0.1, ",".join(target_languages) if target_languages else None
+                    chunk,
+                    language_threshold,
+                    ",".join(target_languages) if target_languages else None,
                 )
 
                 cd_ratios.append(chunk_languages)
@@ -491,6 +505,7 @@ def from_fp(
     cp_exclusion: Optional[List[str]] = None,
     preemptive_behaviour: bool = True,
     explain: bool = False,
+    language_threshold: float = 0.1,
 ) -> CharsetMatches:
     """
     Same thing than the function from_bytes but using a file pointer that is already ready.
@@ -505,6 +520,7 @@ def from_fp(
         cp_exclusion,
         preemptive_behaviour,
         explain,
+        language_threshold,
     )
 
 
@@ -517,6 +533,7 @@ def from_path(
     cp_exclusion: Optional[List[str]] = None,
     preemptive_behaviour: bool = True,
     explain: bool = False,
+    language_threshold: float = 0.1,
 ) -> CharsetMatches:
     """
     Same thing than the function from_bytes but with one extra step. Opening and reading given file path in binary mode.
@@ -532,53 +549,5 @@ def from_path(
             cp_exclusion,
             preemptive_behaviour,
             explain,
+            language_threshold,
         )
-
-
-def normalize(
-    path: "PathLike[Any]",
-    steps: int = 5,
-    chunk_size: int = 512,
-    threshold: float = 0.20,
-    cp_isolation: Optional[List[str]] = None,
-    cp_exclusion: Optional[List[str]] = None,
-    preemptive_behaviour: bool = True,
-) -> CharsetMatch:
-    """
-    Take a (text-based) file path and try to create another file next to it, this time using UTF-8.
-    """
-    warnings.warn(
-        "normalize is deprecated and will be removed in 3.0",
-        DeprecationWarning,
-    )
-
-    results = from_path(
-        path,
-        steps,
-        chunk_size,
-        threshold,
-        cp_isolation,
-        cp_exclusion,
-        preemptive_behaviour,
-    )
-
-    filename = basename(path)
-    target_extensions = list(splitext(filename))
-
-    if len(results) == 0:
-        raise IOError(
-            'Unable to normalize "{}", no encoding charset seems to fit.'.format(
-                filename
-            )
-        )
-
-    result = results.best()
-
-    target_extensions[0] += "-" + result.encoding  # type: ignore
-
-    with open(
-        "{}".format(str(path).replace(filename, "".join(target_extensions))), "wb"
-    ) as fp:
-        fp.write(result.output())  # type: ignore
-
-    return result  # type: ignore
diff --git a/lib/charset_normalizer/assets/__init__.py b/lib/charset_normalizer/assets/__init__.py
index 3c33ba30..9075930d 100644
--- a/lib/charset_normalizer/assets/__init__.py
+++ b/lib/charset_normalizer/assets/__init__.py
@@ -1,6 +1,8 @@
 # -*- coding: utf-8 -*-
 from typing import Dict, List
 
+# Language label that contain the em dash "—"
+# character are to be considered alternative seq to origin
 FREQUENCIES: Dict[str, List[str]] = {
     "English": [
         "e",
@@ -30,6 +32,34 @@ FREQUENCIES: Dict[str, List[str]] = {
         "z",
         "q",
     ],
+    "English—": [
+        "e",
+        "a",
+        "t",
+        "i",
+        "o",
+        "n",
+        "s",
+        "r",
+        "h",
+        "l",
+        "d",
+        "c",
+        "m",
+        "u",
+        "f",
+        "p",
+        "g",
+        "w",
+        "b",
+        "y",
+        "v",
+        "k",
+        "j",
+        "x",
+        "z",
+        "q",
+    ],
     "German": [
         "e",
         "n",
@@ -226,33 +256,303 @@ FREQUENCIES: Dict[str, List[str]] = {
         "ж",
         "ц",
     ],
+    # Jap-Kanji
     "Japanese": [
+        "人",
+        "一",
+        "大",
+        "亅",
+        "丁",
+        "丨",
+        "竹",
+        "笑",
+        "口",
+        "日",
+        "今",
+        "二",
+        "彳",
+        "行",
+        "十",
+        "土",
+        "丶",
+        "寸",
+        "寺",
+        "時",
+        "乙",
+        "丿",
+        "乂",
+        "气",
+        "気",
+        "冂",
+        "巾",
+        "亠",
+        "市",
+        "目",
+        "儿",
+        "見",
+        "八",
+        "小",
+        "凵",
+        "県",
+        "月",
+        "彐",
+        "門",
+        "間",
+        "木",
+        "東",
+        "山",
+        "出",
+        "本",
+        "中",
+        "刀",
+        "分",
+        "耳",
+        "又",
+        "取",
+        "最",
+        "言",
+        "田",
+        "心",
+        "思",
+        "刂",
+        "前",
+        "京",
+        "尹",
+        "事",
+        "生",
+        "厶",
+        "云",
+        "会",
+        "未",
+        "来",
+        "白",
+        "冫",
+        "楽",
+        "灬",
+        "馬",
+        "尸",
+        "尺",
+        "駅",
+        "明",
+        "耂",
+        "者",
+        "了",
+        "阝",
+        "都",
+        "高",
+        "卜",
+        "占",
+        "厂",
+        "广",
+        "店",
+        "子",
+        "申",
+        "奄",
+        "亻",
+        "俺",
+        "上",
+        "方",
+        "冖",
+        "学",
+        "衣",
+        "艮",
+        "食",
+        "自",
+    ],
+    # Jap-Katakana
+    "Japanese—": [
+        "ー",
+        "ン",
+        "ス",
+        "・",
+        "ル",
+        "ト",
+        "リ",
+        "イ",
+        "ア",
+        "ラ",
+        "ッ",
+        "ク",
+        "ド",
+        "シ",
+        "レ",
+        "ジ",
+        "タ",
+        "フ",
+        "ロ",
+        "カ",
+        "テ",
+        "マ",
+        "ィ",
+        "グ",
+        "バ",
+        "ム",
+        "プ",
+        "オ",
+        "コ",
+        "デ",
+        "ニ",
+        "ウ",
+        "メ",
+        "サ",
+        "ビ",
+        "ナ",
+        "ブ",
+        "ャ",
+        "エ",
+        "ュ",
+        "チ",
+        "キ",
+        "ズ",
+        "ダ",
+        "パ",
+        "ミ",
+        "ェ",
+        "ョ",
+        "ハ",
+        "セ",
+        "ベ",
+        "ガ",
+        "モ",
+        "ツ",
+        "ネ",
+        "ボ",
+        "ソ",
+        "ノ",
+        "ァ",
+        "ヴ",
+        "ワ",
+        "ポ",
+        "ペ",
+        "ピ",
+        "ケ",
+        "ゴ",
+        "ギ",
+        "ザ",
+        "ホ",
+        "ゲ",
+        "ォ",
+        "ヤ",
+        "ヒ",
+        "ユ",
+        "ヨ",
+        "ヘ",
+        "ゼ",
+        "ヌ",
+        "ゥ",
+        "ゾ",
+        "ヶ",
+        "ヂ",
+        "ヲ",
+        "ヅ",
+        "ヵ",
+        "ヱ",
+        "ヰ",
+        "ヮ",
+        "ヽ",
+        "゠",
+        "ヾ",
+        "ヷ",
+        "ヿ",
+        "ヸ",
+        "ヹ",
+        "ヺ",
+    ],
+    # Jap-Hiragana
+    "Japanese——": [
         "の",
         "に",
         "る",
         "た",
-        "は",
-        "ー",
         "と",
+        "は",
         "し",
+        "い",
         "を",
         "で",
         "て",
         "が",
-        "い",
-        "ン",
-        "れ",
         "な",
-        "年",
-        "ス",
-        "っ",
-        "ル",
+        "れ",
         "か",
         "ら",
-        "あ",
         "さ",
-        "も",
+        "っ",
         "り",
+        "す",
+        "あ",
+        "も",
+        "こ",
+        "ま",
+        "う",
+        "く",
+        "よ",
+        "き",
+        "ん",
+        "め",
+        "お",
+        "け",
+        "そ",
+        "つ",
+        "だ",
+        "や",
+        "え",
+        "ど",
+        "わ",
+        "ち",
+        "み",
+        "せ",
+        "じ",
+        "ば",
+        "へ",
+        "び",
+        "ず",
+        "ろ",
+        "ほ",
+        "げ",
+        "む",
+        "べ",
+        "ひ",
+        "ょ",
+        "ゆ",
+        "ぶ",
+        "ご",
+        "ゃ",
+        "ね",
+        "ふ",
+        "ぐ",
+        "ぎ",
+        "ぼ",
+        "ゅ",
+        "づ",
+        "ざ",
+        "ぞ",
+        "ぬ",
+        "ぜ",
+        "ぱ",
+        "ぽ",
+        "ぷ",
+        "ぴ",
+        "ぃ",
+        "ぁ",
+        "ぇ",
+        "ぺ",
+        "ゞ",
+        "ぢ",
+        "ぉ",
+        "ぅ",
+        "ゐ",
+        "ゝ",
+        "ゑ",
+        "゛",
+        "゜",
+        "ゎ",
+        "ゔ",
+        "゚",
+        "ゟ",
+        "゙",
+        "ゕ",
+        "ゖ",
     ],
     "Portuguese": [
         "a",
@@ -340,6 +640,77 @@ FREQUENCIES: Dict[str, List[str]] = {
         "就",
         "出",
         "会",
+        "可",
+        "也",
+        "你",
+        "对",
+        "生",
+        "能",
+        "而",
+        "子",
+        "那",
+        "得",
+        "于",
+        "着",
+        "下",
+        "自",
+        "之",
+        "年",
+        "过",
+        "发",
+        "后",
+        "作",
+        "里",
+        "用",
+        "道",
+        "行",
+        "所",
+        "然",
+        "家",
+        "种",
+        "事",
+        "成",
+        "方",
+        "多",
+        "经",
+        "么",
+        "去",
+        "法",
+        "学",
+        "如",
+        "都",
+        "同",
+        "现",
+        "当",
+        "没",
+        "动",
+        "面",
+        "起",
+        "看",
+        "定",
+        "天",
+        "分",
+        "还",
+        "进",
+        "好",
+        "小",
+        "部",
+        "其",
+        "些",
+        "主",
+        "样",
+        "理",
+        "心",
+        "她",
+        "本",
+        "前",
+        "开",
+        "但",
+        "因",
+        "只",
+        "从",
+        "想",
+        "实",
     ],
     "Ukrainian": [
         "о",
@@ -956,34 +1327,6 @@ FREQUENCIES: Dict[str, List[str]] = {
         "ö",
         "y",
     ],
-    "Simple English": [
-        "e",
-        "a",
-        "t",
-        "i",
-        "o",
-        "n",
-        "s",
-        "r",
-        "h",
-        "l",
-        "d",
-        "c",
-        "m",
-        "u",
-        "f",
-        "p",
-        "g",
-        "w",
-        "b",
-        "y",
-        "v",
-        "k",
-        "j",
-        "x",
-        "z",
-        "q",
-    ],
     "Thai": [
         "า",
         "น",
@@ -1066,31 +1409,6 @@ FREQUENCIES: Dict[str, List[str]] = {
         "ஒ",
         "ஸ",
     ],
-    "Classical Chinese": [
-        "之",
-        "年",
-        "為",
-        "也",
-        "以",
-        "一",
-        "人",
-        "其",
-        "者",
-        "國",
-        "有",
-        "二",
-        "十",
-        "於",
-        "曰",
-        "三",
-        "不",
-        "大",
-        "而",
-        "子",
-        "中",
-        "五",
-        "四",
-    ],
     "Kazakh": [
         "а",
         "ы",
diff --git a/lib/charset_normalizer/cd.py b/lib/charset_normalizer/cd.py
index ee4b7424..ae2813fb 100644
--- a/lib/charset_normalizer/cd.py
+++ b/lib/charset_normalizer/cd.py
@@ -105,7 +105,7 @@ def mb_encoding_languages(iana_name: str) -> List[str]:
     ):
         return ["Japanese"]
     if iana_name.startswith("gb") or iana_name in ZH_NAMES:
-        return ["Chinese", "Classical Chinese"]
+        return ["Chinese"]
     if iana_name.startswith("iso2022_kr") or iana_name in KO_NAMES:
         return ["Korean"]
 
@@ -179,22 +179,45 @@ def characters_popularity_compare(
     character_approved_count: int = 0
     FREQUENCIES_language_set = set(FREQUENCIES[language])
 
-    for character in ordered_characters:
+    ordered_characters_count: int = len(ordered_characters)
+    target_language_characters_count: int = len(FREQUENCIES[language])
+
+    large_alphabet: bool = target_language_characters_count > 26
+
+    for character, character_rank in zip(
+        ordered_characters, range(0, ordered_characters_count)
+    ):
         if character not in FREQUENCIES_language_set:
             continue
 
+        character_rank_in_language: int = FREQUENCIES[language].index(character)
+        expected_projection_ratio: float = (
+            target_language_characters_count / ordered_characters_count
+        )
+        character_rank_projection: int = int(character_rank * expected_projection_ratio)
+
+        if (
+            large_alphabet is False
+            and abs(character_rank_projection - character_rank_in_language) > 4
+        ):
+            continue
+
+        if (
+            large_alphabet is True
+            and abs(character_rank_projection - character_rank_in_language)
+            < target_language_characters_count / 3
+        ):
+            character_approved_count += 1
+            continue
+
         characters_before_source: List[str] = FREQUENCIES[language][
-            0 : FREQUENCIES[language].index(character)
+            0:character_rank_in_language
         ]
         characters_after_source: List[str] = FREQUENCIES[language][
-            FREQUENCIES[language].index(character) :
-        ]
-        characters_before: List[str] = ordered_characters[
-            0 : ordered_characters.index(character)
-        ]
-        characters_after: List[str] = ordered_characters[
-            ordered_characters.index(character) :
+            character_rank_in_language:
         ]
+        characters_before: List[str] = ordered_characters[0:character_rank]
+        characters_after: List[str] = ordered_characters[character_rank:]
 
         before_match_count: int = len(
             set(characters_before) & set(characters_before_source)
@@ -289,6 +312,33 @@ def merge_coherence_ratios(results: List[CoherenceMatches]) -> CoherenceMatches:
     return sorted(merge, key=lambda x: x[1], reverse=True)
 
 
+def filter_alt_coherence_matches(results: CoherenceMatches) -> CoherenceMatches:
+    """
+    We shall NOT return "English—" in CoherenceMatches because it is an alternative
+    of "English". This function only keeps the best match and remove the em-dash in it.
+    """
+    index_results: Dict[str, List[float]] = dict()
+
+    for result in results:
+        language, ratio = result
+        no_em_name: str = language.replace("—", "")
+
+        if no_em_name not in index_results:
+            index_results[no_em_name] = []
+
+        index_results[no_em_name].append(ratio)
+
+    if any(len(index_results[e]) > 1 for e in index_results):
+        filtered_results: CoherenceMatches = []
+
+        for language in index_results:
+            filtered_results.append((language, max(index_results[language])))
+
+        return filtered_results
+
+    return results
+
+
 @lru_cache(maxsize=2048)
 def coherence_ratio(
     decoded_sequence: str, threshold: float = 0.1, lg_inclusion: Optional[str] = None
@@ -336,4 +386,6 @@ def coherence_ratio(
             if sufficient_match_count >= 3:
                 break
 
-    return sorted(results, key=lambda x: x[1], reverse=True)
+    return sorted(
+        filter_alt_coherence_matches(results), key=lambda x: x[1], reverse=True
+    )
diff --git a/lib/charset_normalizer/cli/normalizer.py b/lib/charset_normalizer/cli/normalizer.py
index b8b652a5..ad26b4d0 100644
--- a/lib/charset_normalizer/cli/normalizer.py
+++ b/lib/charset_normalizer/cli/normalizer.py
@@ -1,15 +1,12 @@
 import argparse
 import sys
 from json import dumps
-from os.path import abspath
+from os.path import abspath, basename, dirname, join, realpath
 from platform import python_version
 from typing import List, Optional
+from unicodedata import unidata_version
 
-try:
-    from unicodedata2 import unidata_version
-except ImportError:
-    from unicodedata import unidata_version
-
+import charset_normalizer.md as md_module
 from charset_normalizer import from_fp
 from charset_normalizer.models import CliDetectionResult
 from charset_normalizer.version import __version__
@@ -124,8 +121,11 @@ def cli_detect(argv: Optional[List[str]] = None) -> int:
     parser.add_argument(
         "--version",
         action="version",
-        version="Charset-Normalizer {} - Python {} - Unicode {}".format(
-            __version__, python_version(), unidata_version
+        version="Charset-Normalizer {} - Python {} - Unicode {} - SpeedUp {}".format(
+            __version__,
+            python_version(),
+            unidata_version,
+            "OFF" if md_module.__file__.lower().endswith(".py") else "ON",
         ),
         help="Show version information and exit.",
     )
@@ -234,7 +234,10 @@ def cli_detect(argv: Optional[List[str]] = None) -> int:
                         my_file.close()
                     continue
 
-                o_: List[str] = my_file.name.split(".")
+                dir_path = dirname(realpath(my_file.name))
+                file_name = basename(realpath(my_file.name))
+
+                o_: List[str] = file_name.split(".")
 
                 if args.replace is False:
                     o_.insert(-1, best_guess.encoding)
@@ -255,7 +258,7 @@ def cli_detect(argv: Optional[List[str]] = None) -> int:
                     continue
 
                 try:
-                    x_[0].unicode_path = abspath("./{}".format(".".join(o_)))
+                    x_[0].unicode_path = join(dir_path, ".".join(o_))
 
                     with open(x_[0].unicode_path, "w", encoding="utf-8") as fp:
                         fp.write(str(best_guess))
diff --git a/lib/charset_normalizer/constant.py b/lib/charset_normalizer/constant.py
index ac840c46..3188108d 100644
--- a/lib/charset_normalizer/constant.py
+++ b/lib/charset_normalizer/constant.py
@@ -489,9 +489,7 @@ COMMON_SAFE_ASCII_CHARACTERS: Set[str] = {
 KO_NAMES: Set[str] = {"johab", "cp949", "euc_kr"}
 ZH_NAMES: Set[str] = {"big5", "cp950", "big5hkscs", "hz"}
 
-NOT_PRINTABLE_PATTERN = re_compile(r"[0-9\W\n\r\t]+")
-
 LANGUAGE_SUPPORTED_COUNT: int = len(FREQUENCIES)
 
-# Logging LEVEL bellow DEBUG
+# Logging LEVEL below DEBUG
 TRACE: int = 5
diff --git a/lib/charset_normalizer/legacy.py b/lib/charset_normalizer/legacy.py
index cdebe2b8..b266d176 100644
--- a/lib/charset_normalizer/legacy.py
+++ b/lib/charset_normalizer/legacy.py
@@ -1,9 +1,7 @@
-import warnings
 from typing import Dict, Optional, Union
 
-from .api import from_bytes, from_fp, from_path, normalize
+from .api import from_bytes
 from .constant import CHARDET_CORRESPONDENCE
-from .models import CharsetMatch, CharsetMatches
 
 
 def detect(byte_str: bytes) -> Dict[str, Optional[Union[str, float]]]:
@@ -43,53 +41,3 @@ def detect(byte_str: bytes) -> Dict[str, Optional[Union[str, float]]]:
         "language": language,
         "confidence": confidence,
     }
-
-
-class CharsetNormalizerMatch(CharsetMatch):
-    pass
-
-
-class CharsetNormalizerMatches(CharsetMatches):
-    @staticmethod
-    def from_fp(*args, **kwargs):  # type: ignore
-        warnings.warn(  # pragma: nocover
-            "staticmethod from_fp, from_bytes, from_path and normalize are deprecated "
-            "and scheduled to be removed in 3.0",
-            DeprecationWarning,
-        )
-        return from_fp(*args, **kwargs)  # pragma: nocover
-
-    @staticmethod
-    def from_bytes(*args, **kwargs):  # type: ignore
-        warnings.warn(  # pragma: nocover
-            "staticmethod from_fp, from_bytes, from_path and normalize are deprecated "
-            "and scheduled to be removed in 3.0",
-            DeprecationWarning,
-        )
-        return from_bytes(*args, **kwargs)  # pragma: nocover
-
-    @staticmethod
-    def from_path(*args, **kwargs):  # type: ignore
-        warnings.warn(  # pragma: nocover
-            "staticmethod from_fp, from_bytes, from_path and normalize are deprecated "
-            "and scheduled to be removed in 3.0",
-            DeprecationWarning,
-        )
-        return from_path(*args, **kwargs)  # pragma: nocover
-
-    @staticmethod
-    def normalize(*args, **kwargs):  # type: ignore
-        warnings.warn(  # pragma: nocover
-            "staticmethod from_fp, from_bytes, from_path and normalize are deprecated "
-            "and scheduled to be removed in 3.0",
-            DeprecationWarning,
-        )
-        return normalize(*args, **kwargs)  # pragma: nocover
-
-
-class CharsetDetector(CharsetNormalizerMatches):
-    pass
-
-
-class CharsetDoctor(CharsetNormalizerMatches):
-    pass
diff --git a/lib/charset_normalizer/md.py b/lib/charset_normalizer/md.py
index 31808af8..56e9321a 100644
--- a/lib/charset_normalizer/md.py
+++ b/lib/charset_normalizer/md.py
@@ -1,7 +1,12 @@
 from functools import lru_cache
+from logging import getLogger
 from typing import List, Optional
 
-from .constant import COMMON_SAFE_ASCII_CHARACTERS, UNICODE_SECONDARY_RANGE_KEYWORD
+from .constant import (
+    COMMON_SAFE_ASCII_CHARACTERS,
+    TRACE,
+    UNICODE_SECONDARY_RANGE_KEYWORD,
+)
 from .utils import (
     is_accentuated,
     is_ascii,
@@ -123,7 +128,7 @@ class TooManyAccentuatedPlugin(MessDetectorPlugin):
 
     @property
     def ratio(self) -> float:
-        if self._character_count == 0:
+        if self._character_count == 0 or self._character_count < 8:
             return 0.0
         ratio_of_accentuation: float = self._accentuated_count / self._character_count
         return ratio_of_accentuation if ratio_of_accentuation >= 0.35 else 0.0
@@ -547,7 +552,20 @@ def mess_ratio(
                 break
 
     if debug:
+        logger = getLogger("charset_normalizer")
+
+        logger.log(
+            TRACE,
+            "Mess-detector extended-analysis start. "
+            f"intermediary_mean_mess_ratio_calc={intermediary_mean_mess_ratio_calc} mean_mess_ratio={mean_mess_ratio} "
+            f"maximum_threshold={maximum_threshold}",
+        )
+
+        if len(decoded_sequence) > 16:
+            logger.log(TRACE, f"Starting with: {decoded_sequence[:16]}")
+            logger.log(TRACE, f"Ending with: {decoded_sequence[-16::]}")
+
         for dt in detectors:  # pragma: nocover
-            print(dt.__class__, dt.ratio)
+            logger.log(TRACE, f"{dt.__class__}: {dt.ratio}")
 
     return round(mean_mess_ratio, 3)
diff --git a/lib/charset_normalizer/models.py b/lib/charset_normalizer/models.py
index ccb0d475..7f8ca389 100644
--- a/lib/charset_normalizer/models.py
+++ b/lib/charset_normalizer/models.py
@@ -1,22 +1,9 @@
-import warnings
-from collections import Counter
 from encodings.aliases import aliases
 from hashlib import sha256
 from json import dumps
-from re import sub
-from typing import (
-    Any,
-    Counter as TypeCounter,
-    Dict,
-    Iterator,
-    List,
-    Optional,
-    Tuple,
-    Union,
-)
+from typing import Any, Dict, Iterator, List, Optional, Tuple, Union
 
-from .constant import NOT_PRINTABLE_PATTERN, TOO_BIG_SEQUENCE
-from .md import mess_ratio
+from .constant import TOO_BIG_SEQUENCE
 from .utils import iana_name, is_multi_byte_encoding, unicode_range
 
 
@@ -65,7 +52,7 @@ class CharsetMatch:
         chaos_difference: float = abs(self.chaos - other.chaos)
         coherence_difference: float = abs(self.coherence - other.coherence)
 
-        # Bellow 1% difference --> Use Coherence
+        # Below 1% difference --> Use Coherence
         if chaos_difference < 0.01 and coherence_difference > 0.02:
             # When having a tough decision, use the result that decoded as many multi-byte as possible.
             if chaos_difference == 0.0 and self.coherence == other.coherence:
@@ -78,45 +65,6 @@ class CharsetMatch:
     def multi_byte_usage(self) -> float:
         return 1.0 - len(str(self)) / len(self.raw)
 
-    @property
-    def chaos_secondary_pass(self) -> float:
-        """
-        Check once again chaos in decoded text, except this time, with full content.
-        Use with caution, this can be very slow.
-        Notice: Will be removed in 3.0
-        """
-        warnings.warn(
-            "chaos_secondary_pass is deprecated and will be removed in 3.0",
-            DeprecationWarning,
-        )
-        return mess_ratio(str(self), 1.0)
-
-    @property
-    def coherence_non_latin(self) -> float:
-        """
-        Coherence ratio on the first non-latin language detected if ANY.
-        Notice: Will be removed in 3.0
-        """
-        warnings.warn(
-            "coherence_non_latin is deprecated and will be removed in 3.0",
-            DeprecationWarning,
-        )
-        return 0.0
-
-    @property
-    def w_counter(self) -> TypeCounter[str]:
-        """
-        Word counter instance on decoded text.
-        Notice: Will be removed in 3.0
-        """
-        warnings.warn(
-            "w_counter is deprecated and will be removed in 3.0", DeprecationWarning
-        )
-
-        string_printable_only = sub(NOT_PRINTABLE_PATTERN, " ", str(self).lower())
-
-        return Counter(string_printable_only.split())
-
     def __str__(self) -> str:
         # Lazy Str Loading
         if self._string is None:
@@ -252,18 +200,6 @@ class CharsetMatch:
         """
         return [self._encoding] + [m.encoding for m in self._leaves]
 
-    def first(self) -> "CharsetMatch":
-        """
-        Kept for BC reasons. Will be removed in 3.0.
-        """
-        return self
-
-    def best(self) -> "CharsetMatch":
-        """
-        Kept for BC reasons. Will be removed in 3.0.
-        """
-        return self
-
     def output(self, encoding: str = "utf_8") -> bytes:
         """
         Method to get re-encoded bytes payload using given target encoding. Default to UTF-8.
diff --git a/lib/charset_normalizer/utils.py b/lib/charset_normalizer/utils.py
index 859f212b..e3536267 100644
--- a/lib/charset_normalizer/utils.py
+++ b/lib/charset_normalizer/utils.py
@@ -1,12 +1,6 @@
-try:
-    # WARNING: unicodedata2 support is going to be removed in 3.0
-    # Python is quickly catching up.
-    import unicodedata2 as unicodedata
-except ImportError:
-    import unicodedata  # type: ignore[no-redef]
-
 import importlib
 import logging
+import unicodedata
 from codecs import IncrementalDecoder
 from encodings.aliases import aliases
 from functools import lru_cache
@@ -402,7 +396,7 @@ def cut_sequence_chunks(
 
             # multi-byte bad cutting detector and adjustment
             # not the cleanest way to perform that fix but clever enough for now.
-            if is_multi_byte_decoder and i > 0 and sequences[i] >= 0x80:
+            if is_multi_byte_decoder and i > 0:
 
                 chunk_partial_size_chk: int = min(chunk_size, 16)
 
diff --git a/lib/charset_normalizer/version.py b/lib/charset_normalizer/version.py
index 64c0dbde..cb503673 100644
--- a/lib/charset_normalizer/version.py
+++ b/lib/charset_normalizer/version.py
@@ -2,5 +2,5 @@
 Expose version
 """
 
-__version__ = "2.1.1"
+__version__ = "3.0.1"
 VERSION = __version__.split(".")
diff --git a/lib/requests/__init__.py b/lib/requests/__init__.py
index 7ac8e297..22db3c1d 100644
--- a/lib/requests/__init__.py
+++ b/lib/requests/__init__.py
@@ -80,8 +80,8 @@ def check_compatibility(urllib3_version, chardet_version, charset_normalizer_ver
     elif charset_normalizer_version:
         major, minor, patch = charset_normalizer_version.split(".")[:3]
         major, minor, patch = int(major), int(minor), int(patch)
-        # charset_normalizer >= 2.0.0 < 3.0.0
-        assert (2, 0, 0) <= (major, minor, patch) < (3, 0, 0)
+        # charset_normalizer >= 2.0.0 < 4.0.0
+        assert (2, 0, 0) <= (major, minor, patch) < (4, 0, 0)
     else:
         raise Exception("You need either charset_normalizer or chardet installed")
 
diff --git a/lib/requests/__version__.py b/lib/requests/__version__.py
index e725ada6..69be3dec 100644
--- a/lib/requests/__version__.py
+++ b/lib/requests/__version__.py
@@ -5,10 +5,10 @@
 __title__ = "requests"
 __description__ = "Python HTTP for Humans."
 __url__ = "https://requests.readthedocs.io"
-__version__ = "2.28.1"
-__build__ = 0x022801
+__version__ = "2.28.2"
+__build__ = 0x022802
 __author__ = "Kenneth Reitz"
 __author_email__ = "me@kennethreitz.org"
 __license__ = "Apache 2.0"
-__copyright__ = "Copyright 2022 Kenneth Reitz"
+__copyright__ = "Copyright Kenneth Reitz"
 __cake__ = "\u2728 \U0001f370 \u2728"
diff --git a/lib/requests/models.py b/lib/requests/models.py
index 3cd49f5b..617a4134 100644
--- a/lib/requests/models.py
+++ b/lib/requests/models.py
@@ -438,7 +438,7 @@ class PreparedRequest(RequestEncodingMixin, RequestHooksMixin):
         if not scheme:
             raise MissingSchema(
                 f"Invalid URL {url!r}: No scheme supplied. "
-                f"Perhaps you meant http://{url}?"
+                f"Perhaps you meant https://{url}?"
             )
 
         if not host:
diff --git a/lib/urllib3/_version.py b/lib/urllib3/_version.py
index 308d7f28..7c031661 100644
--- a/lib/urllib3/_version.py
+++ b/lib/urllib3/_version.py
@@ -1,2 +1,2 @@
 # This file is protected via CODEOWNERS
-__version__ = "1.26.13"
+__version__ = "1.26.14"
diff --git a/lib/urllib3/contrib/appengine.py b/lib/urllib3/contrib/appengine.py
index f91bdd6e..a5a6d910 100644
--- a/lib/urllib3/contrib/appengine.py
+++ b/lib/urllib3/contrib/appengine.py
@@ -224,7 +224,7 @@ class AppEngineManager(RequestMethods):
                 )
 
         # Check if we should retry the HTTP response.
-        has_retry_after = bool(http_response.getheader("Retry-After"))
+        has_retry_after = bool(http_response.headers.get("Retry-After"))
         if retries.is_retry(method, http_response.status, has_retry_after):
             retries = retries.increment(method, url, response=http_response, _pool=self)
             log.debug("Retry: %s", url)
diff --git a/lib/urllib3/contrib/ntlmpool.py b/lib/urllib3/contrib/ntlmpool.py
index 41a8fd17..47166575 100644
--- a/lib/urllib3/contrib/ntlmpool.py
+++ b/lib/urllib3/contrib/ntlmpool.py
@@ -69,7 +69,7 @@ class NTLMConnectionPool(HTTPSConnectionPool):
         log.debug("Request headers: %s", headers)
         conn.request("GET", self.authurl, None, headers)
         res = conn.getresponse()
-        reshdr = dict(res.getheaders())
+        reshdr = dict(res.headers)
         log.debug("Response status: %s %s", res.status, res.reason)
         log.debug("Response headers: %s", reshdr)
         log.debug("Response data: %s [...]", res.read(100))
@@ -101,7 +101,7 @@ class NTLMConnectionPool(HTTPSConnectionPool):
         conn.request("GET", self.authurl, None, headers)
         res = conn.getresponse()
         log.debug("Response status: %s %s", res.status, res.reason)
-        log.debug("Response headers: %s", dict(res.getheaders()))
+        log.debug("Response headers: %s", dict(res.headers))
         log.debug("Response data: %s [...]", res.read()[:100])
         if res.status != 200:
             if res.status == 401:
diff --git a/lib/urllib3/response.py b/lib/urllib3/response.py
index 8f1b4fa8..0bd13d40 100644
--- a/lib/urllib3/response.py
+++ b/lib/urllib3/response.py
@@ -666,7 +666,7 @@ class HTTPResponse(io.IOBase):
     def getheaders(self):
         warnings.warn(
             "HTTPResponse.getheaders() is deprecated and will be removed "
-            "in urllib3 v2.1.0. Instead access HTTResponse.headers directly.",
+            "in urllib3 v2.1.0. Instead access HTTPResponse.headers directly.",
             category=DeprecationWarning,
             stacklevel=2,
         )
@@ -675,7 +675,7 @@ class HTTPResponse(io.IOBase):
     def getheader(self, name, default=None):
         warnings.warn(
             "HTTPResponse.getheader() is deprecated and will be removed "
-            "in urllib3 v2.1.0. Instead use HTTResponse.headers.get(name, default).",
+            "in urllib3 v2.1.0. Instead use HTTPResponse.headers.get(name, default).",
             category=DeprecationWarning,
             stacklevel=2,
         )
diff --git a/lib/urllib3/util/url.py b/lib/urllib3/util/url.py
index 94f1b8d4..3a169a43 100644
--- a/lib/urllib3/util/url.py
+++ b/lib/urllib3/util/url.py
@@ -63,7 +63,7 @@ IPV6_ADDRZ_RE = re.compile("^" + IPV6_ADDRZ_PAT + "$")
 BRACELESS_IPV6_ADDRZ_RE = re.compile("^" + IPV6_ADDRZ_PAT[2:-2] + "$")
 ZONE_ID_RE = re.compile("(" + ZONE_ID_PAT + r")\]$")
 
-_HOST_PORT_PAT = ("^(%s|%s|%s)(?::0*([0-9]{0,5}))?$") % (
+_HOST_PORT_PAT = ("^(%s|%s|%s)(?::0*?(|0|[1-9][0-9]{0,4}))?$") % (
     REG_NAME_PAT,
     IPV4_PAT,
     IPV6_ADDRZ_PAT,
diff --git a/requirements.txt b/requirements.txt
index 80de6d04..63e238ff 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -36,7 +36,7 @@ pyparsing==3.0.9
 python-dateutil==2.8.2
 python-twitter==3.5
 pytz==2022.7
-requests==2.28.1
+requests==2.28.2
 requests-oauthlib==1.3.1
 rumps==0.4.0; platform_system == "Darwin"
 simplejson==3.18.0

From 9f727d0086a86177085b7d8734884eb01a47c5bd Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 2 Mar 2023 20:53:26 -0800
Subject: [PATCH 341/743] Bump future from 0.18.2 to 0.18.3 (#1970)

* Bump future from 0.18.2 to 0.18.3

Bumps [future](https://github.com/PythonCharmers/python-future) from 0.18.2 to 0.18.3.
- [Release notes](https://github.com/PythonCharmers/python-future/releases)
- [Changelog](https://github.com/PythonCharmers/python-future/blob/master/docs/changelog.rst)
- [Commits](https://github.com/PythonCharmers/python-future/compare/v0.18.2...v0.18.3)

---
updated-dependencies:
- dependency-name: future
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

* Update future==0.18.3

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/future/__init__.py                     |  2 +-
 lib/future/backports/email/base64mime.py   |  1 +
 lib/future/backports/http/cookiejar.py     | 18 ++++--
 lib/future/backports/misc.py               | 14 +++++
 lib/future/builtins/newround.py            | 25 ++++----
 lib/future/builtins/newsuper.py            | 71 +++++++++++----------
 lib/future/moves/tkinter/filedialog.py     |  6 ++
 lib/future/types/newdict.py                | 61 ++++--------------
 lib/future/types/newint.py                 |  3 +
 lib/future/types/newrange.py               |  2 +-
 lib/future/utils/__init__.py               |  7 ++-
 lib/libfuturize/fixes/fix_division_safe.py |  7 ++-
 lib/libfuturize/fixes/fix_print.py         | 10 +++
 lib/libfuturize/fixes/fix_raise.py         |  2 +-
 lib/past/builtins/misc.py                  | 73 +++++++++++++++++++++-
 lib/past/types/basestring.py               |  5 +-
 lib/past/types/oldstr.py                   |  2 +-
 requirements.txt                           |  2 +-
 18 files changed, 196 insertions(+), 115 deletions(-)

diff --git a/lib/future/__init__.py b/lib/future/__init__.py
index ad419d67..b609299a 100644
--- a/lib/future/__init__.py
+++ b/lib/future/__init__.py
@@ -87,7 +87,7 @@ __license__ = 'MIT'
 __copyright__ = 'Copyright 2013-2019 Python Charmers Pty Ltd'
 __ver_major__ = 0
 __ver_minor__ = 18
-__ver_patch__ = 2
+__ver_patch__ = 3
 __ver_sub__ = ''
 __version__ = "%d.%d.%d%s" % (__ver_major__, __ver_minor__,
                               __ver_patch__, __ver_sub__)
diff --git a/lib/future/backports/email/base64mime.py b/lib/future/backports/email/base64mime.py
index 416d612e..296392a6 100644
--- a/lib/future/backports/email/base64mime.py
+++ b/lib/future/backports/email/base64mime.py
@@ -28,6 +28,7 @@ from __future__ import division
 from __future__ import absolute_import
 from future.builtins import range
 from future.builtins import bytes
+from future.builtins import str
 
 __all__ = [
     'body_decode',
diff --git a/lib/future/backports/http/cookiejar.py b/lib/future/backports/http/cookiejar.py
index af3ef415..0ad80a02 100644
--- a/lib/future/backports/http/cookiejar.py
+++ b/lib/future/backports/http/cookiejar.py
@@ -225,10 +225,14 @@ LOOSE_HTTP_DATE_RE = re.compile(
        (?::(\d\d))?    # optional seconds
     )?                 # optional clock
        \s*
-    ([-+]?\d{2,4}|(?![APap][Mm]\b)[A-Za-z]+)? # timezone
+    (?:
+       ([-+]?\d{2,4}|(?![APap][Mm]\b)[A-Za-z]+) # timezone
        \s*
-    (?:\(\w+\))?       # ASCII representation of timezone in parens.
-       \s*$""", re.X | re.ASCII)
+    )?
+    (?:
+       \(\w+\)         # ASCII representation of timezone in parens.
+       \s*
+    )?$""", re.X | re.ASCII)
 def http2time(text):
     """Returns time in seconds since epoch of time represented by a string.
 
@@ -298,9 +302,11 @@ ISO_DATE_RE = re.compile(
       (?::?(\d\d(?:\.\d*)?))?  # optional seconds (and fractional)
    )?                    # optional clock
       \s*
-   ([-+]?\d\d?:?(:?\d\d)?
-    |Z|z)?               # timezone  (Z is "zero meridian", i.e. GMT)
-      \s*$""", re.X | re. ASCII)
+   (?:
+      ([-+]?\d\d?:?(:?\d\d)?
+       |Z|z)             # timezone  (Z is "zero meridian", i.e. GMT)
+      \s*
+   )?$""", re.X | re. ASCII)
 def iso2time(text):
     """
     As for http2time, but parses the ISO 8601 formats:
diff --git a/lib/future/backports/misc.py b/lib/future/backports/misc.py
index 098a0667..992b978f 100644
--- a/lib/future/backports/misc.py
+++ b/lib/future/backports/misc.py
@@ -46,6 +46,16 @@ def ceil(x):
 
 from itertools import islice
 
+if PY26:
+    # itertools.count in Py 2.6 doesn't accept a step parameter
+    def count(start=0, step=1):
+        while True:
+            yield start
+            start += step
+else:
+    from itertools import count
+
+
 if PY3:
     try:
         from _thread import get_ident
@@ -85,6 +95,10 @@ def recursive_repr(fillvalue='...'):
     return decorating_function
 
 
+# OrderedDict Shim from  Raymond Hettinger, python core dev
+# http://code.activestate.com/recipes/576693-ordered-dictionary-for-py24/
+# here to support version 2.6.
+
 ################################################################################
 ### OrderedDict
 ################################################################################
diff --git a/lib/future/builtins/newround.py b/lib/future/builtins/newround.py
index 394a2c63..b06c1169 100644
--- a/lib/future/builtins/newround.py
+++ b/lib/future/builtins/newround.py
@@ -2,6 +2,7 @@
 ``python-future``: pure Python implementation of Python 3 round().
 """
 
+from __future__ import division
 from future.utils import PYPY, PY26, bind_method
 
 # Use the decimal module for simplicity of implementation (and
@@ -29,28 +30,30 @@ def newround(number, ndigits=None):
     if hasattr(number, '__round__'):
         return number.__round__(ndigits)
 
-    if ndigits < 0:
-        raise NotImplementedError('negative ndigits not supported yet')
     exponent = Decimal('10') ** (-ndigits)
 
-    if PYPY:
-        # Work around issue #24: round() breaks on PyPy with NumPy's types
-        if 'numpy' in repr(type(number)):
-            number = float(number)
+    # Work around issue #24: round() breaks on PyPy with NumPy's types
+    # Also breaks on CPython with NumPy's specialized int types like uint64
+    if 'numpy' in repr(type(number)):
+        number = float(number)
 
     if isinstance(number, Decimal):
         d = number
     else:
         if not PY26:
-            d = Decimal.from_float(number).quantize(exponent,
-                                                rounding=ROUND_HALF_EVEN)
+            d = Decimal.from_float(number)
         else:
-            d = from_float_26(number).quantize(exponent, rounding=ROUND_HALF_EVEN)
+            d = from_float_26(number)
+
+    if ndigits < 0:
+        result = newround(d / exponent) * exponent
+    else:
+        result = d.quantize(exponent, rounding=ROUND_HALF_EVEN)
 
     if return_int:
-        return int(d)
+        return int(result)
     else:
-        return float(d)
+        return float(result)
 
 
 ### From Python 2.7's decimal.py. Only needed to support Py2.6:
diff --git a/lib/future/builtins/newsuper.py b/lib/future/builtins/newsuper.py
index 5d3402bd..3e8cc80f 100644
--- a/lib/future/builtins/newsuper.py
+++ b/lib/future/builtins/newsuper.py
@@ -60,44 +60,15 @@ def newsuper(typ=_SENTINEL, type_or_obj=_SENTINEL, framedepth=1):
             raise RuntimeError('super() used in a function with no args')
 
         try:
-            # Get the MRO so we can crawl it.
-            mro = type_or_obj.__mro__
-        except (AttributeError, RuntimeError):  # see issue #160
+            typ = find_owner(type_or_obj, f.f_code)
+        except (AttributeError, RuntimeError, TypeError):
+            # see issues #160, #267
             try:
-                mro = type_or_obj.__class__.__mro__
+                typ = find_owner(type_or_obj.__class__, f.f_code)
             except AttributeError:
-                raise RuntimeError('super() used with a non-newstyle class')
-
-        #   A ``for...else`` block?  Yes!  It's odd, but useful.
-        #   If unfamiliar with for...else, see:
-        #
-        #       http://psung.blogspot.com/2007/12/for-else-in-python.html
-        for typ in mro:
-            #  Find the class that owns the currently-executing method.
-            for meth in typ.__dict__.values():
-                # Drill down through any wrappers to the underlying func.
-                # This handles e.g. classmethod() and staticmethod().
-                try:
-                    while not isinstance(meth,FunctionType):
-                        if isinstance(meth, property):
-                            # Calling __get__ on the property will invoke
-                            # user code which might throw exceptions or have
-                            # side effects
-                            meth = meth.fget
-                        else:
-                            try:
-                                meth = meth.__func__
-                            except AttributeError:
-                                meth = meth.__get__(type_or_obj, typ)
-                except (AttributeError, TypeError):
-                    continue
-                if meth.func_code is f.f_code:
-                    break   # Aha!  Found you.
-            else:
-                continue    #  Not found! Move onto the next class in MRO.
-            break    #  Found! Break out of the search loop.
-        else:
-            raise RuntimeError('super() called outside a method')
+                raise RuntimeError('super() used with an old-style class')
+            except TypeError:
+                raise RuntimeError('super() called outside a method')
 
     #  Dispatch to builtin super().
     if type_or_obj is not _SENTINEL:
@@ -105,6 +76,34 @@ def newsuper(typ=_SENTINEL, type_or_obj=_SENTINEL, framedepth=1):
     return _builtin_super(typ)
 
 
+def find_owner(cls, code):
+    '''Find the class that owns the currently-executing method.
+    '''
+    for typ in cls.__mro__:
+        for meth in typ.__dict__.values():
+            # Drill down through any wrappers to the underlying func.
+            # This handles e.g. classmethod() and staticmethod().
+            try:
+                while not isinstance(meth,FunctionType):
+                    if isinstance(meth, property):
+                        # Calling __get__ on the property will invoke
+                        # user code which might throw exceptions or have
+                        # side effects
+                        meth = meth.fget
+                    else:
+                        try:
+                            meth = meth.__func__
+                        except AttributeError:
+                            meth = meth.__get__(cls, typ)
+            except (AttributeError, TypeError):
+                continue
+            if meth.func_code is code:
+                return typ   # Aha!  Found you.
+        #  Not found! Move onto the next class in MRO.
+
+    raise TypeError
+
+
 def superm(*args, **kwds):
     f = sys._getframe(1)
     nm = f.f_code.co_name
diff --git a/lib/future/moves/tkinter/filedialog.py b/lib/future/moves/tkinter/filedialog.py
index 973923e2..6a6f03ca 100644
--- a/lib/future/moves/tkinter/filedialog.py
+++ b/lib/future/moves/tkinter/filedialog.py
@@ -10,3 +10,9 @@ else:
     except ImportError:
         raise ImportError('The FileDialog module is missing. Does your Py2 '
                           'installation include tkinter?')
+    
+    try:
+        from tkFileDialog import *
+    except ImportError:
+        raise ImportError('The tkFileDialog module is missing. Does your Py2 '
+                          'installation include tkinter?')
diff --git a/lib/future/types/newdict.py b/lib/future/types/newdict.py
index 3f3a559d..d90316cb 100644
--- a/lib/future/types/newdict.py
+++ b/lib/future/types/newdict.py
@@ -23,7 +23,7 @@ from future.types.newobject import newobject
 
 
 _builtin_dict = dict
-ver = sys.version_info[:2]
+ver = sys.version_info
 
 
 class BaseNewDict(type):
@@ -38,47 +38,18 @@ class newdict(with_metaclass(BaseNewDict, _builtin_dict)):
     """
     A backport of the Python 3 dict object to Py2
     """
-    def items(self):
-        """
-        On Python 2.7+:
-            D.items() -> a set-like object providing a view on D's items
-        On Python 2.6:
-            D.items() -> an iterator over D's items
-        """
-        if ver == (2, 7):
-            return self.viewitems()
-        elif ver == (2, 6):
-            return self.iteritems()
-        elif ver >= (3, 0):
-            return self.items()
 
-    def keys(self):
-        """
-        On Python 2.7+:
-            D.keys() -> a set-like object providing a view on D's keys
-        On Python 2.6:
-            D.keys() -> an iterator over D's keys
-        """
-        if ver == (2, 7):
-            return self.viewkeys()
-        elif ver == (2, 6):
-            return self.iterkeys()
-        elif ver >= (3, 0):
-            return self.keys()
-
-    def values(self):
-        """
-        On Python 2.7+:
-            D.values() -> a set-like object providing a view on D's values
-        On Python 2.6:
-            D.values() -> an iterator over D's values
-        """
-        if ver == (2, 7):
-            return self.viewvalues()
-        elif ver == (2, 6):
-            return self.itervalues()
-        elif ver >= (3, 0):
-            return self.values()
+    if ver >= (3,):
+        # Inherit items, keys and values from `dict` in 3.x
+        pass
+    elif ver >= (2, 7):
+        items = dict.viewitems
+        keys = dict.viewkeys
+        values = dict.viewvalues
+    else:
+        items = dict.iteritems
+        keys = dict.iterkeys
+        values = dict.itervalues
 
     def __new__(cls, *args, **kwargs):
         """
@@ -93,13 +64,7 @@ class newdict(with_metaclass(BaseNewDict, _builtin_dict)):
             in the keyword argument list.  For example:  dict(one=1, two=2)
         """
 
-        if len(args) == 0:
-            return super(newdict, cls).__new__(cls)
-        elif type(args[0]) == newdict:
-            value = args[0]
-        else:
-            value = args[0]
-        return super(newdict, cls).__new__(cls, value)
+        return super(newdict, cls).__new__(cls, *args)
 
     def __native__(self):
         """
diff --git a/lib/future/types/newint.py b/lib/future/types/newint.py
index 748dba9d..04a411e9 100644
--- a/lib/future/types/newint.py
+++ b/lib/future/types/newint.py
@@ -284,6 +284,9 @@ class newint(with_metaclass(BaseNewInt, long)):
         """
         So subclasses can override this, Py3-style
         """
+        if PY3:
+            return super(newint, self).__bool__()
+
         return super(newint, self).__nonzero__()
 
     def __native__(self):
diff --git a/lib/future/types/newrange.py b/lib/future/types/newrange.py
index eda01a5a..6d4ebe2f 100644
--- a/lib/future/types/newrange.py
+++ b/lib/future/types/newrange.py
@@ -87,7 +87,7 @@ class newrange(Sequence):
         return (isinstance(other, newrange) and
                 (self._len == 0 == other._len or
                  (self._start, self._step, self._len) ==
-                 (other._start, other._step, self._len)))
+                 (other._start, other._step, other._len)))
 
     def __len__(self):
         return self._len
diff --git a/lib/future/utils/__init__.py b/lib/future/utils/__init__.py
index 46bd96de..ec1b1027 100644
--- a/lib/future/utils/__init__.py
+++ b/lib/future/utils/__init__.py
@@ -61,6 +61,9 @@ PY3 = sys.version_info[0] >= 3
 PY34_PLUS = sys.version_info[0:2] >= (3, 4)
 PY35_PLUS = sys.version_info[0:2] >= (3, 5)
 PY36_PLUS = sys.version_info[0:2] >= (3, 6)
+PY37_PLUS = sys.version_info[0:2] >= (3, 7)
+PY38_PLUS = sys.version_info[0:2] >= (3, 8)
+PY39_PLUS = sys.version_info[0:2] >= (3, 9)
 PY2 = sys.version_info[0] == 2
 PY26 = sys.version_info[0:2] == (2, 6)
 PY27 = sys.version_info[0:2] == (2, 7)
@@ -527,9 +530,9 @@ def implements_iterator(cls):
         return cls
 
 if PY3:
-    get_next = lambda x: x.next
-else:
     get_next = lambda x: x.__next__
+else:
+    get_next = lambda x: x.next
 
 
 def encode_filename(filename):
diff --git a/lib/libfuturize/fixes/fix_division_safe.py b/lib/libfuturize/fixes/fix_division_safe.py
index 3d5909cc..65c8c1da 100644
--- a/lib/libfuturize/fixes/fix_division_safe.py
+++ b/lib/libfuturize/fixes/fix_division_safe.py
@@ -92,7 +92,12 @@ class FixDivisionSafe(fixer_base.BaseFix):
                 else:
                     children.append(child.clone())
             if matched:
-                return Node(node.type, children, fixers_applied=node.fixers_applied)
+                # In Python 2.6, `Node` does not have the fixers_applied attribute
+                # https://github.com/python/cpython/blob/8493c0cd66cfc181ac1517268a74f077e9998701/Lib/lib2to3/pytree.py#L235
+                if hasattr(Node, "fixers_applied"):
+                    return Node(node.type, children, fixers_applied=node.fixers_applied)
+                else:
+                    return Node(node.type, children)
 
         return False
 
diff --git a/lib/libfuturize/fixes/fix_print.py b/lib/libfuturize/fixes/fix_print.py
index 247b91b8..2554717c 100644
--- a/lib/libfuturize/fixes/fix_print.py
+++ b/lib/libfuturize/fixes/fix_print.py
@@ -57,6 +57,16 @@ class FixPrint(fixer_base.BaseFix):
         if args and args[-1] == Comma():
             args = args[:-1]
             end = " "
+
+            # try to determine if the string ends in a non-space whitespace character, in which
+            # case there should be no space at the end of the conversion
+            string_leaves = [leaf for leaf in args[-1].leaves() if leaf.type == token.STRING]
+            if (
+                string_leaves
+                and string_leaves[-1].value[0] != "r"  # "raw" string
+                and string_leaves[-1].value[-3:-1] in (r"\t", r"\n", r"\r")
+            ):
+                end = ""
         if args and args[0] == pytree.Leaf(token.RIGHTSHIFT, u">>"):
             assert len(args) >= 2
             file = args[1].clone()
diff --git a/lib/libfuturize/fixes/fix_raise.py b/lib/libfuturize/fixes/fix_raise.py
index f7518416..d113401c 100644
--- a/lib/libfuturize/fixes/fix_raise.py
+++ b/lib/libfuturize/fixes/fix_raise.py
@@ -94,7 +94,7 @@ class FixRaise(fixer_base.BaseFix):
                 args = [exc, Comma(), val]
                 if tb is not None:
                     args += [Comma(), tb]
-                return Call(Name(u"raise_"), args)
+                return Call(Name(u"raise_"), args, prefix=node.prefix)
 
         if tb is not None:
             tb.prefix = ""
diff --git a/lib/past/builtins/misc.py b/lib/past/builtins/misc.py
index ba50aa9e..3600695c 100644
--- a/lib/past/builtins/misc.py
+++ b/lib/past/builtins/misc.py
@@ -1,6 +1,8 @@
 from __future__ import unicode_literals
 
 import inspect
+import math
+import numbers
 
 from future.utils import PY2, PY3, exec_
 
@@ -29,8 +31,67 @@ if PY3:
         cmp(x, y) -> integer
 
         Return negative if x<y, zero if x==y, positive if x>y.
+        Python2 had looser comparison allowing cmp None and non Numerical types and collections.
+        Try to match the old behavior
         """
-        return (x > y) - (x < y)
+        if isinstance(x, set) and isinstance(y, set):
+            raise TypeError('cannot compare sets using cmp()',)
+        try:
+            if isinstance(x, numbers.Number) and math.isnan(x):
+                if not isinstance(y, numbers.Number):
+                    raise TypeError('cannot compare float("nan"), {type_y} with cmp'.format(type_y=type(y)))
+                if isinstance(y, int):
+                    return 1
+                else:
+                    return -1
+            if isinstance(y, numbers.Number) and math.isnan(y):
+                if not isinstance(x, numbers.Number):
+                    raise TypeError('cannot compare {type_x}, float("nan") with cmp'.format(type_x=type(x)))
+                if isinstance(x, int):
+                    return -1
+                else:
+                    return 1
+            return (x > y) - (x < y)
+        except TypeError:
+            if x == y:
+                return 0
+            type_order = [
+                type(None),
+                numbers.Number,
+                dict, list,
+                set,
+                (str, bytes),
+            ]
+            x_type_index = y_type_index = None
+            for i, type_match in enumerate(type_order):
+                if isinstance(x, type_match):
+                    x_type_index = i
+                if isinstance(y, type_match):
+                    y_type_index = i
+            if cmp(x_type_index, y_type_index) == 0:
+                if isinstance(x, bytes) and isinstance(y, str):
+                    return cmp(x.decode('ascii'), y)
+                if isinstance(y, bytes) and isinstance(x, str):
+                    return cmp(x, y.decode('ascii'))
+                elif isinstance(x, list):
+                    # if both arguments are lists take the comparison of the first non equal value
+                    for x_elem, y_elem in zip(x, y):
+                        elem_cmp_val = cmp(x_elem, y_elem)
+                        if elem_cmp_val != 0:
+                            return elem_cmp_val
+                    # if all elements are equal, return equal/0
+                    return 0
+                elif isinstance(x, dict):
+                    if len(x) != len(y):
+                        return cmp(len(x), len(y))
+                    else:
+                        x_key = min(a for a in x if a not in y or x[a] != y[a])
+                        y_key = min(b for b in y if b not in x or x[b] != y[b])
+                        if x_key != y_key:
+                            return cmp(x_key, y_key)
+                        else:
+                            return cmp(x[x_key], y[y_key])
+            return cmp(x_type_index, y_type_index)
 
     from sys import intern
 
@@ -42,7 +103,13 @@ if PY3:
         return '0' + builtins.oct(number)[2:]
 
     raw_input = input
-    from imp import reload
+
+    try:
+        from importlib import reload
+    except ImportError:
+        # for python2, python3 <= 3.4
+        from imp import reload
+
     unicode = str
     unichr = chr
     xrange = range
@@ -82,7 +149,7 @@ if PY3:
         if not isinstance(mylocals, Mapping):
             raise TypeError('locals must be a mapping')
         with open(filename, "rb") as fin:
-             source = fin.read()
+            source = fin.read()
         code = compile(source, filename, "exec")
         exec_(code, myglobals, mylocals)
 
diff --git a/lib/past/types/basestring.py b/lib/past/types/basestring.py
index 1cab22f6..9c21715a 100644
--- a/lib/past/types/basestring.py
+++ b/lib/past/types/basestring.py
@@ -25,9 +25,8 @@ class BaseBaseString(type):
     def __instancecheck__(cls, instance):
         return isinstance(instance, (bytes, str))
 
-    def __subclasshook__(cls, thing):
-        # TODO: What should go here?
-        raise NotImplemented
+    def __subclasscheck__(cls, subclass):
+        return super(BaseBaseString, cls).__subclasscheck__(subclass) or issubclass(subclass, (bytes, str))
 
 
 class basestring(with_metaclass(BaseBaseString)):
diff --git a/lib/past/types/oldstr.py b/lib/past/types/oldstr.py
index a477d884..5a0e3789 100644
--- a/lib/past/types/oldstr.py
+++ b/lib/past/types/oldstr.py
@@ -20,7 +20,7 @@ class BaseOldStr(type):
 
 
 def unescape(s):
-    """
+    r"""
     Interprets strings with escape sequences
 
     Example:
diff --git a/requirements.txt b/requirements.txt
index 63e238ff..9aacb2e9 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -13,7 +13,7 @@ cloudinary==1.30.0
 distro==1.8.0
 dnspython==2.2.1
 facebook-sdk==3.1.0
-future==0.18.2
+future==0.18.3
 ga4mp==2.0.4
 gntp==1.0.3
 html5lib==1.1

From 6910079330ec8110f4789fe90301bf889558e691 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 2 Mar 2023 20:54:08 -0800
Subject: [PATCH 342/743] Bump pytz from 2022.7 to 2022.7.1 (#1974)

* Bump pytz from 2022.7 to 2022.7.1

Bumps [pytz](https://github.com/stub42/pytz) from 2022.7 to 2022.7.1.
- [Release notes](https://github.com/stub42/pytz/releases)
- [Commits](https://github.com/stub42/pytz/compare/release_2022.7...release_2022.7.1)

---
updated-dependencies:
- dependency-name: pytz
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

* Update pytz==2022.7.1

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/pytz/__init__.py | 4 +---
 requirements.txt     | 2 +-
 2 files changed, 2 insertions(+), 4 deletions(-)

diff --git a/lib/pytz/__init__.py b/lib/pytz/__init__.py
index 4fdc9a7e..11d2e2ca 100644
--- a/lib/pytz/__init__.py
+++ b/lib/pytz/__init__.py
@@ -23,7 +23,7 @@ from pytz.tzfile import build_tzinfo
 
 # The IANA (nee Olson) database is updated several times a year.
 OLSON_VERSION = '2022g'
-VERSION = '2022.7'  # pip compatible version number.
+VERSION = '2022.7.1'  # pip compatible version number.
 __version__ = VERSION
 
 OLSEN_VERSION = OLSON_VERSION  # Old releases had this misspelling
@@ -202,9 +202,7 @@ def _case_insensitive_zone_lookup(zone):
     """case-insensitively matching timezone, else return zone unchanged"""
     global _all_timezones_lower_to_standard
     if _all_timezones_lower_to_standard is None:
-        global _all_timezones_unchecked
         _all_timezones_lower_to_standard = dict((tz.lower(), tz) for tz in _all_timezones_unchecked)  # noqa
-        del _all_timezones_unchecked
     return _all_timezones_lower_to_standard.get(zone.lower()) or zone  # noqa
 
 
diff --git a/requirements.txt b/requirements.txt
index 9aacb2e9..017ae555 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -35,7 +35,7 @@ PyJWT==2.6.0
 pyparsing==3.0.9
 python-dateutil==2.8.2
 python-twitter==3.5
-pytz==2022.7
+pytz==2022.7.1
 requests==2.28.2
 requests-oauthlib==1.3.1
 rumps==0.4.0; platform_system == "Darwin"

From 32c06a8b7286af196bdd4a7e38a521cf436da236 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 2 Mar 2023 20:54:32 -0800
Subject: [PATCH 343/743] Bump dnspython from 2.2.1 to 2.3.0 (#1975)

* Bump dnspython from 2.2.1 to 2.3.0

Bumps [dnspython](https://github.com/rthalley/dnspython) from 2.2.1 to 2.3.0.
- [Release notes](https://github.com/rthalley/dnspython/releases)
- [Changelog](https://github.com/rthalley/dnspython/blob/master/doc/whatsnew.rst)
- [Commits](https://github.com/rthalley/dnspython/compare/v2.2.1...v2.3.0)

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

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

* Update dnspython==2.3.0

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/dns/__init__.py               |  89 +--
 lib/dns/_asyncbackend.py          |  26 +-
 lib/dns/_asyncio_backend.py       |  92 ++-
 lib/dns/_curio_backend.py         |  44 +-
 lib/dns/_immutable_attr.py        |  84 ---
 lib/dns/_immutable_ctx.py         |   8 +-
 lib/dns/_trio_backend.py          |  39 +-
 lib/dns/asyncbackend.py           |  51 +-
 lib/dns/asyncbackend.pyi          |  13 -
 lib/dns/asyncquery.py             | 558 ++++++++++++-----
 lib/dns/asyncquery.pyi            |  43 --
 lib/dns/asyncresolver.py          | 148 +++--
 lib/dns/asyncresolver.pyi         |  26 -
 lib/dns/dnssec.py                 | 999 +++++++++++++++++++++++++-----
 lib/dns/dnssec.pyi                |  21 -
 lib/dns/dnssectypes.py            |  71 +++
 lib/dns/e164.py                   |  30 +-
 lib/dns/e164.pyi                  |  10 -
 lib/dns/edns.py                   | 152 ++---
 lib/dns/entropy.py                |  47 +-
 lib/dns/entropy.pyi               |  10 -
 lib/dns/enum.py                   |  26 +-
 lib/dns/exception.py              |  35 +-
 lib/dns/exception.pyi             |  12 -
 lib/dns/flags.py                  |  19 +-
 lib/dns/grange.py                 |  19 +-
 lib/dns/immutable.py              |  29 +-
 lib/dns/inet.py                   |  23 +-
 lib/dns/inet.pyi                  |   4 -
 lib/dns/ipv4.py                   |  23 +-
 lib/dns/ipv6.py                   |  98 +--
 lib/dns/message.py                | 815 +++++++++++++++---------
 lib/dns/message.pyi               |  47 --
 lib/dns/name.py                   | 401 +++++++-----
 lib/dns/name.pyi                  |  40 --
 lib/dns/namedict.py               |   5 +-
 lib/dns/node.py                   | 126 ++--
 lib/dns/node.pyi                  |  17 -
 lib/dns/opcode.py                 |  14 +-
 lib/dns/query.py                  | 703 +++++++++++++++------
 lib/dns/query.pyi                 |  64 --
 lib/dns/quic/__init__.py          |  74 +++
 lib/dns/quic/_asyncio.py          | 206 ++++++
 lib/dns/quic/_common.py           | 180 ++++++
 lib/dns/quic/_sync.py             | 214 +++++++
 lib/dns/quic/_trio.py             | 170 +++++
 lib/dns/rcode.py                  |  32 +-
 lib/dns/rdata.py                  | 372 +++++++----
 lib/dns/rdata.pyi                 |  19 -
 lib/dns/rdataclass.py             |  13 +-
 lib/dns/rdataset.py               | 227 ++++---
 lib/dns/rdataset.pyi              |  58 --
 lib/dns/rdatatype.py              |  71 ++-
 lib/dns/rdtypes/ANY/AMTRELAY.py   |  48 +-
 lib/dns/rdtypes/ANY/CAA.py        |  19 +-
 lib/dns/rdtypes/ANY/CDNSKEY.py    |  10 +-
 lib/dns/rdtypes/ANY/CERT.py       |  76 +--
 lib/dns/rdtypes/ANY/CSYNC.py      |  13 +-
 lib/dns/rdtypes/ANY/DNSKEY.py     |  10 +-
 lib/dns/rdtypes/ANY/GPOS.py       |  42 +-
 lib/dns/rdtypes/ANY/HINFO.py      |  16 +-
 lib/dns/rdtypes/ANY/HIP.py        |  17 +-
 lib/dns/rdtypes/ANY/ISDN.py       |  20 +-
 lib/dns/rdtypes/ANY/L32.py        |  12 +-
 lib/dns/rdtypes/ANY/L64.py        |  20 +-
 lib/dns/rdtypes/ANY/LOC.py        | 174 +++---
 lib/dns/rdtypes/ANY/LP.py         |  12 +-
 lib/dns/rdtypes/ANY/NID.py        |  19 +-
 lib/dns/rdtypes/ANY/NSEC.py       |  11 +-
 lib/dns/rdtypes/ANY/NSEC3.py      |  61 +-
 lib/dns/rdtypes/ANY/NSEC3PARAM.py |  23 +-
 lib/dns/rdtypes/ANY/OPENPGPKEY.py |   6 +-
 lib/dns/rdtypes/ANY/OPT.py        |  11 +-
 lib/dns/rdtypes/ANY/RP.py         |   7 +-
 lib/dns/rdtypes/ANY/RRSIG.py      |  83 ++-
 lib/dns/rdtypes/ANY/SOA.py        |  37 +-
 lib/dns/rdtypes/ANY/SSHFP.py      |  22 +-
 lib/dns/rdtypes/ANY/TKEY.py       |  59 +-
 lib/dns/rdtypes/ANY/TSIG.py       |  89 ++-
 lib/dns/rdtypes/ANY/URI.py        |  14 +-
 lib/dns/rdtypes/ANY/X25.py        |   9 +-
 lib/dns/rdtypes/ANY/ZONEMD.py     |  36 +-
 lib/dns/rdtypes/ANY/__init__.py   |  94 +--
 lib/dns/rdtypes/CH/A.py           |  10 +-
 lib/dns/rdtypes/CH/__init__.py    |   2 +-
 lib/dns/rdtypes/IN/A.py           |   7 +-
 lib/dns/rdtypes/IN/AAAA.py        |   7 +-
 lib/dns/rdtypes/IN/APL.py         |  32 +-
 lib/dns/rdtypes/IN/DHCID.py       |   8 +-
 lib/dns/rdtypes/IN/HTTPS.py       |   1 +
 lib/dns/rdtypes/IN/IPSECKEY.py    |  53 +-
 lib/dns/rdtypes/IN/NAPTR.py       |  48 +-
 lib/dns/rdtypes/IN/NSAP.py        |  15 +-
 lib/dns/rdtypes/IN/PX.py          |   9 +-
 lib/dns/rdtypes/IN/SRV.py         |  12 +-
 lib/dns/rdtypes/IN/SVCB.py        |   1 +
 lib/dns/rdtypes/IN/WKS.py         |  18 +-
 lib/dns/rdtypes/IN/__init__.py    |  28 +-
 lib/dns/rdtypes/__init__.py       |  24 +-
 lib/dns/rdtypes/dnskeybase.py     |  28 +-
 lib/dns/rdtypes/dnskeybase.pyi    |  38 --
 lib/dns/rdtypes/dsbase.py         |  40 +-
 lib/dns/rdtypes/euibase.py        |  26 +-
 lib/dns/rdtypes/mxbase.py         |   9 +-
 lib/dns/rdtypes/nsbase.py         |   7 +-
 lib/dns/rdtypes/svcbbase.py       | 131 ++--
 lib/dns/rdtypes/tlsabase.py       |  24 +-
 lib/dns/rdtypes/txtbase.py        |  47 +-
 lib/dns/rdtypes/txtbase.pyi       |  12 -
 lib/dns/rdtypes/util.py           |  34 +-
 lib/dns/renderer.py               | 131 +++-
 lib/dns/resolver.py               | 810 +++++++++++++++---------
 lib/dns/resolver.pyi              |  66 --
 lib/dns/reversename.py            |  33 +-
 lib/dns/reversename.pyi           |   6 -
 lib/dns/rrset.py                  | 131 ++--
 lib/dns/rrset.pyi                 |  10 -
 lib/dns/serial.py                 |  31 +-
 lib/dns/set.py                    | 104 ++--
 lib/dns/tokenizer.py              | 225 ++++---
 lib/dns/transaction.py            | 175 +++---
 lib/dns/tsig.py                   |  75 ++-
 lib/dns/tsigkeyring.py            |  20 +-
 lib/dns/tsigkeyring.pyi           |   7 -
 lib/dns/ttl.py                    |  18 +-
 lib/dns/update.py                 | 194 ++++--
 lib/dns/update.pyi                |  21 -
 lib/dns/version.py                |  46 +-
 lib/dns/versioned.py              | 134 ++--
 lib/dns/win32util.py              | 100 +--
 lib/dns/wire.py                   |  45 +-
 lib/dns/xfr.py                    | 124 ++--
 lib/dns/zone.py                   | 583 ++++++++++-------
 lib/dns/zone.pyi                  |  55 --
 lib/dns/zonefile.py               | 335 ++++++----
 lib/dns/zonetypes.py              |  37 ++
 requirements.txt                  |   2 +-
 137 files changed, 7699 insertions(+), 4277 deletions(-)
 delete mode 100644 lib/dns/_immutable_attr.py
 delete mode 100644 lib/dns/asyncbackend.pyi
 delete mode 100644 lib/dns/asyncquery.pyi
 delete mode 100644 lib/dns/asyncresolver.pyi
 delete mode 100644 lib/dns/dnssec.pyi
 create mode 100644 lib/dns/dnssectypes.py
 delete mode 100644 lib/dns/e164.pyi
 delete mode 100644 lib/dns/entropy.pyi
 delete mode 100644 lib/dns/exception.pyi
 delete mode 100644 lib/dns/inet.pyi
 delete mode 100644 lib/dns/message.pyi
 delete mode 100644 lib/dns/name.pyi
 delete mode 100644 lib/dns/node.pyi
 delete mode 100644 lib/dns/query.pyi
 create mode 100644 lib/dns/quic/__init__.py
 create mode 100644 lib/dns/quic/_asyncio.py
 create mode 100644 lib/dns/quic/_common.py
 create mode 100644 lib/dns/quic/_sync.py
 create mode 100644 lib/dns/quic/_trio.py
 delete mode 100644 lib/dns/rdata.pyi
 delete mode 100644 lib/dns/rdataset.pyi
 delete mode 100644 lib/dns/rdtypes/dnskeybase.pyi
 delete mode 100644 lib/dns/rdtypes/txtbase.pyi
 delete mode 100644 lib/dns/resolver.pyi
 delete mode 100644 lib/dns/reversename.pyi
 delete mode 100644 lib/dns/rrset.pyi
 delete mode 100644 lib/dns/tsigkeyring.pyi
 delete mode 100644 lib/dns/update.pyi
 delete mode 100644 lib/dns/zone.pyi
 create mode 100644 lib/dns/zonetypes.py

diff --git a/lib/dns/__init__.py b/lib/dns/__init__.py
index 0473ca17..9abdf018 100644
--- a/lib/dns/__init__.py
+++ b/lib/dns/__init__.py
@@ -18,49 +18,52 @@
 """dnspython DNS toolkit"""
 
 __all__ = [
-    'asyncbackend',
-    'asyncquery',
-    'asyncresolver',
-    'dnssec',
-    'e164',
-    'edns',
-    'entropy',
-    'exception',
-    'flags',
-    'immutable',
-    'inet',
-    'ipv4',
-    'ipv6',
-    'message',
-    'name',
-    'namedict',
-    'node',
-    'opcode',
-    'query',
-    'rcode',
-    'rdata',
-    'rdataclass',
-    'rdataset',
-    'rdatatype',
-    'renderer',
-    'resolver',
-    'reversename',
-    'rrset',
-    'serial',
-    'set',
-    'tokenizer',
-    'transaction',
-    'tsig',
-    'tsigkeyring',
-    'ttl',
-    'rdtypes',
-    'update',
-    'version',
-    'versioned',
-    'wire',
-    'xfr',
-    'zone',
-    'zonefile',
+    "asyncbackend",
+    "asyncquery",
+    "asyncresolver",
+    "dnssec",
+    "dnssectypes",
+    "e164",
+    "edns",
+    "entropy",
+    "exception",
+    "flags",
+    "immutable",
+    "inet",
+    "ipv4",
+    "ipv6",
+    "message",
+    "name",
+    "namedict",
+    "node",
+    "opcode",
+    "query",
+    "quic",
+    "rcode",
+    "rdata",
+    "rdataclass",
+    "rdataset",
+    "rdatatype",
+    "renderer",
+    "resolver",
+    "reversename",
+    "rrset",
+    "serial",
+    "set",
+    "tokenizer",
+    "transaction",
+    "tsig",
+    "tsigkeyring",
+    "ttl",
+    "rdtypes",
+    "update",
+    "version",
+    "versioned",
+    "wire",
+    "xfr",
+    "zone",
+    "zonetypes",
+    "zonefile",
 ]
 
 from dns.version import version as __version__  # noqa
diff --git a/lib/dns/_asyncbackend.py b/lib/dns/_asyncbackend.py
index 1f3a8287..ff24604f 100644
--- a/lib/dns/_asyncbackend.py
+++ b/lib/dns/_asyncbackend.py
@@ -3,6 +3,7 @@
 # This is a nullcontext for both sync and async.  3.7 has a nullcontext,
 # but it is only for sync use.
 
+
 class NullContext:
     def __init__(self, enter_result=None):
         self.enter_result = enter_result
@@ -23,6 +24,7 @@ class NullContext:
 # These are declared here so backends can import them without creating
 # circular dependencies with dns.asyncbackend.
 
+
 class Socket:  # pragma: no cover
     async def close(self):
         pass
@@ -41,6 +43,9 @@ class Socket:  # pragma: no cover
 
 
 class DatagramSocket(Socket):  # pragma: no cover
+    def __init__(self, family: int):
+        self.family = family
+
     async def sendto(self, what, destination, timeout):
         raise NotImplementedError
 
@@ -56,14 +61,25 @@ class StreamSocket(Socket):  # pragma: no cover
         raise NotImplementedError
 
 
-class Backend:    # pragma: no cover
+class Backend:  # pragma: no cover
     def name(self):
-        return 'unknown'
+        return "unknown"
 
-    async def make_socket(self, af, socktype, proto=0,
-                          source=None, destination=None, timeout=None,
-                          ssl_context=None, server_hostname=None):
+    async def make_socket(
+        self,
+        af,
+        socktype,
+        proto=0,
+        source=None,
+        destination=None,
+        timeout=None,
+        ssl_context=None,
+        server_hostname=None,
+    ):
         raise NotImplementedError
 
     def datagram_connection_required(self):
         return False
+
+    async def sleep(self, interval):
+        raise NotImplementedError
diff --git a/lib/dns/_asyncio_backend.py b/lib/dns/_asyncio_backend.py
index d737d13c..82a06249 100644
--- a/lib/dns/_asyncio_backend.py
+++ b/lib/dns/_asyncio_backend.py
@@ -10,7 +10,8 @@ import dns._asyncbackend
 import dns.exception
 
 
-_is_win32 = sys.platform == 'win32'
+_is_win32 = sys.platform == "win32"
+
 
 def _get_running_loop():
     try:
@@ -30,7 +31,6 @@ class _DatagramProtocol:
     def datagram_received(self, data, addr):
         if self.recvfrom and not self.recvfrom.done():
             self.recvfrom.set_result((data, addr))
-            self.recvfrom = None
 
     def error_received(self, exc):  # pragma: no cover
         if self.recvfrom and not self.recvfrom.done():
@@ -56,30 +56,34 @@ async def _maybe_wait_for(awaitable, timeout):
 
 class DatagramSocket(dns._asyncbackend.DatagramSocket):
     def __init__(self, family, transport, protocol):
-        self.family = family
+        super().__init__(family)
         self.transport = transport
         self.protocol = protocol
 
     async def sendto(self, what, destination, timeout):  # pragma: no cover
         # no timeout for asyncio sendto
         self.transport.sendto(what, destination)
+        return len(what)
 
     async def recvfrom(self, size, timeout):
         # ignore size as there's no way I know to tell protocol about it
         done = _get_running_loop().create_future()
-        assert self.protocol.recvfrom is None
-        self.protocol.recvfrom = done
-        await _maybe_wait_for(done, timeout)
-        return done.result()
+        try:
+            assert self.protocol.recvfrom is None
+            self.protocol.recvfrom = done
+            await _maybe_wait_for(done, timeout)
+            return done.result()
+        finally:
+            self.protocol.recvfrom = None
 
     async def close(self):
         self.protocol.close()
 
     async def getpeername(self):
-        return self.transport.get_extra_info('peername')
+        return self.transport.get_extra_info("peername")
 
     async def getsockname(self):
-        return self.transport.get_extra_info('sockname')
+        return self.transport.get_extra_info("sockname")
 
 
 class StreamSocket(dns._asyncbackend.StreamSocket):
@@ -93,8 +97,7 @@ class StreamSocket(dns._asyncbackend.StreamSocket):
         return await _maybe_wait_for(self.writer.drain(), timeout)
 
     async def recv(self, size, timeout):
-        return await _maybe_wait_for(self.reader.read(size),
-                                     timeout)
+        return await _maybe_wait_for(self.reader.read(size), timeout)
 
     async def close(self):
         self.writer.close()
@@ -104,43 +107,64 @@ class StreamSocket(dns._asyncbackend.StreamSocket):
             pass
 
     async def getpeername(self):
-        return self.writer.get_extra_info('peername')
+        return self.writer.get_extra_info("peername")
 
     async def getsockname(self):
-        return self.writer.get_extra_info('sockname')
+        return self.writer.get_extra_info("sockname")
 
 
 class Backend(dns._asyncbackend.Backend):
     def name(self):
-        return 'asyncio'
+        return "asyncio"
 
-    async def make_socket(self, af, socktype, proto=0,
-                          source=None, destination=None, timeout=None,
-                          ssl_context=None, server_hostname=None):
-        if destination is None and socktype == socket.SOCK_DGRAM and \
-           _is_win32:
-            raise NotImplementedError('destinationless datagram sockets '
-                                      'are not supported by asyncio '
-                                      'on Windows')
+    async def make_socket(
+        self,
+        af,
+        socktype,
+        proto=0,
+        source=None,
+        destination=None,
+        timeout=None,
+        ssl_context=None,
+        server_hostname=None,
+    ):
+        if destination is None and socktype == socket.SOCK_DGRAM and _is_win32:
+            raise NotImplementedError(
+                "destinationless datagram sockets "
+                "are not supported by asyncio "
+                "on Windows"
+            )
         loop = _get_running_loop()
         if socktype == socket.SOCK_DGRAM:
             transport, protocol = await loop.create_datagram_endpoint(
-                _DatagramProtocol, source, family=af,
-                proto=proto, remote_addr=destination)
+                _DatagramProtocol,
+                source,
+                family=af,
+                proto=proto,
+                remote_addr=destination,
+            )
             return DatagramSocket(af, transport, protocol)
         elif socktype == socket.SOCK_STREAM:
+            if destination is None:
+                # This shouldn't happen, but we check to make code analysis software
+                # happier.
+                raise ValueError("destination required for stream sockets")
             (r, w) = await _maybe_wait_for(
-                asyncio.open_connection(destination[0],
-                                        destination[1],
-                                        ssl=ssl_context,
-                                        family=af,
-                                        proto=proto,
-                                        local_addr=source,
-                                        server_hostname=server_hostname),
-                timeout)
+                asyncio.open_connection(
+                    destination[0],
+                    destination[1],
+                    ssl=ssl_context,
+                    family=af,
+                    proto=proto,
+                    local_addr=source,
+                    server_hostname=server_hostname,
+                ),
+                timeout,
+            )
             return StreamSocket(af, r, w)
-        raise NotImplementedError('unsupported socket ' +
-                                  f'type {socktype}')  # pragma: no cover
+        raise NotImplementedError(
+            "unsupported socket " + f"type {socktype}"
+        )  # pragma: no cover
 
     async def sleep(self, interval):
         await asyncio.sleep(interval)
diff --git a/lib/dns/_curio_backend.py b/lib/dns/_curio_backend.py
index 6fa7b3a1..765d6471 100644
--- a/lib/dns/_curio_backend.py
+++ b/lib/dns/_curio_backend.py
@@ -26,18 +26,20 @@ _lltuple = dns.inet.low_level_address_tuple
 
 class DatagramSocket(dns._asyncbackend.DatagramSocket):
     def __init__(self, socket):
+        super().__init__(socket.family)
         self.socket = socket
-        self.family = socket.family
 
     async def sendto(self, what, destination, timeout):
         async with _maybe_timeout(timeout):
             return await self.socket.sendto(what, destination)
-        raise dns.exception.Timeout(timeout=timeout)  # pragma: no cover
+        raise dns.exception.Timeout(
+            timeout=timeout
+        )  # pragma: no cover  lgtm[py/unreachable-statement]
 
     async def recvfrom(self, size, timeout):
         async with _maybe_timeout(timeout):
             return await self.socket.recvfrom(size)
-        raise dns.exception.Timeout(timeout=timeout)
+        raise dns.exception.Timeout(timeout=timeout)  # lgtm[py/unreachable-statement]
 
     async def close(self):
         await self.socket.close()
@@ -57,12 +59,12 @@ class StreamSocket(dns._asyncbackend.StreamSocket):
     async def sendall(self, what, timeout):
         async with _maybe_timeout(timeout):
             return await self.socket.sendall(what)
-        raise dns.exception.Timeout(timeout=timeout)
+        raise dns.exception.Timeout(timeout=timeout)  # lgtm[py/unreachable-statement]
 
     async def recv(self, size, timeout):
         async with _maybe_timeout(timeout):
             return await self.socket.recv(size)
-        raise dns.exception.Timeout(timeout=timeout)
+        raise dns.exception.Timeout(timeout=timeout)  # lgtm[py/unreachable-statement]
 
     async def close(self):
         await self.socket.close()
@@ -76,11 +78,19 @@ class StreamSocket(dns._asyncbackend.StreamSocket):
 
 class Backend(dns._asyncbackend.Backend):
     def name(self):
-        return 'curio'
+        return "curio"
 
-    async def make_socket(self, af, socktype, proto=0,
-                          source=None, destination=None, timeout=None,
-                          ssl_context=None, server_hostname=None):
+    async def make_socket(
+        self,
+        af,
+        socktype,
+        proto=0,
+        source=None,
+        destination=None,
+        timeout=None,
+        ssl_context=None,
+        server_hostname=None,
+    ):
         if socktype == socket.SOCK_DGRAM:
             s = curio.socket.socket(af, socktype, proto)
             try:
@@ -96,13 +106,17 @@ class Backend(dns._asyncbackend.Backend):
             else:
                 source_addr = None
             async with _maybe_timeout(timeout):
-                s = await curio.open_connection(destination[0], destination[1],
-                                                ssl=ssl_context,
-                                                source_addr=source_addr,
-                                                server_hostname=server_hostname)
+                s = await curio.open_connection(
+                    destination[0],
+                    destination[1],
+                    ssl=ssl_context,
+                    source_addr=source_addr,
+                    server_hostname=server_hostname,
+                )
             return StreamSocket(s)
-        raise NotImplementedError('unsupported socket ' +
-                                  f'type {socktype}')  # pragma: no cover
+        raise NotImplementedError(
+            "unsupported socket " + f"type {socktype}"
+        )  # pragma: no cover
 
     async def sleep(self, interval):
         await curio.sleep(interval)
diff --git a/lib/dns/_immutable_attr.py b/lib/dns/_immutable_attr.py
deleted file mode 100644
index 4d89be90..00000000
--- a/lib/dns/_immutable_attr.py
+++ /dev/null
@@ -1,84 +0,0 @@
-# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license
-
-# This implementation of the immutable decorator is for python 3.6,
-# which doesn't have Context Variables.  This implementation is somewhat
-# costly for classes with slots, as it adds a __dict__ to them.
-
-
-import inspect
-
-
-class _Immutable:
-    """Immutable mixin class"""
-
-    # Note we MUST NOT have __slots__ as that causes
-    #
-    #    TypeError: multiple bases have instance lay-out conflict
-    #
-    # when we get mixed in with another class with slots.  When we
-    # get mixed into something with slots, it effectively adds __dict__ to
-    # the slots of the other class, which allows attribute setting to work,
-    # albeit at the cost of the dictionary.
-
-    def __setattr__(self, name, value):
-        if not hasattr(self, '_immutable_init') or \
-           self._immutable_init is not self:
-            raise TypeError("object doesn't support attribute assignment")
-        else:
-            super().__setattr__(name, value)
-
-    def __delattr__(self, name):
-        if not hasattr(self, '_immutable_init') or \
-           self._immutable_init is not self:
-            raise TypeError("object doesn't support attribute assignment")
-        else:
-            super().__delattr__(name)
-
-
-def _immutable_init(f):
-    def nf(*args, **kwargs):
-        try:
-            # Are we already initializing an immutable class?
-            previous = args[0]._immutable_init
-        except AttributeError:
-            # We are the first!
-            previous = None
-            object.__setattr__(args[0], '_immutable_init', args[0])
-        try:
-            # call the actual __init__
-            f(*args, **kwargs)
-        finally:
-            if not previous:
-                # If we started the initialization, establish immutability
-                # by removing the attribute that allows mutation
-                object.__delattr__(args[0], '_immutable_init')
-    nf.__signature__ = inspect.signature(f)
-    return nf
-
-
-def immutable(cls):
-    if _Immutable in cls.__mro__:
-        # Some ancestor already has the mixin, so just make sure we keep
-        # following the __init__ protocol.
-        cls.__init__ = _immutable_init(cls.__init__)
-        if hasattr(cls, '__setstate__'):
-            cls.__setstate__ = _immutable_init(cls.__setstate__)
-        ncls = cls
-    else:
-        # Mixin the Immutable class and follow the __init__ protocol.
-        class ncls(_Immutable, cls):
-
-            @_immutable_init
-            def __init__(self, *args, **kwargs):
-                super().__init__(*args, **kwargs)
-
-            if hasattr(cls, '__setstate__'):
-                @_immutable_init
-                def __setstate__(self, *args, **kwargs):
-                    super().__setstate__(*args, **kwargs)
-
-        # make ncls have the same name and module as cls
-        ncls.__name__ = cls.__name__
-        ncls.__qualname__ = cls.__qualname__
-        ncls.__module__ = cls.__module__
-    return ncls
diff --git a/lib/dns/_immutable_ctx.py b/lib/dns/_immutable_ctx.py
index ececdbeb..63c0a2d3 100644
--- a/lib/dns/_immutable_ctx.py
+++ b/lib/dns/_immutable_ctx.py
@@ -8,7 +8,7 @@ import contextvars
 import inspect
 
 
-_in__init__ = contextvars.ContextVar('_immutable_in__init__', default=False)
+_in__init__ = contextvars.ContextVar("_immutable_in__init__", default=False)
 
 
 class _Immutable:
@@ -41,6 +41,7 @@ def _immutable_init(f):
             f(*args, **kwargs)
         finally:
             _in__init__.reset(previous)
+
     nf.__signature__ = inspect.signature(f)
     return nf
 
@@ -50,7 +51,7 @@ def immutable(cls):
         # Some ancestor already has the mixin, so just make sure we keep
         # following the __init__ protocol.
         cls.__init__ = _immutable_init(cls.__init__)
-        if hasattr(cls, '__setstate__'):
+        if hasattr(cls, "__setstate__"):
             cls.__setstate__ = _immutable_init(cls.__setstate__)
         ncls = cls
     else:
@@ -63,7 +64,8 @@ def immutable(cls):
             def __init__(self, *args, **kwargs):
                 super().__init__(*args, **kwargs)
 
-            if hasattr(cls, '__setstate__'):
+            if hasattr(cls, "__setstate__"):
+
                 @_immutable_init
                 def __setstate__(self, *args, **kwargs):
                     super().__setstate__(*args, **kwargs)
diff --git a/lib/dns/_trio_backend.py b/lib/dns/_trio_backend.py
index a00d4a4e..b0c02103 100644
--- a/lib/dns/_trio_backend.py
+++ b/lib/dns/_trio_backend.py
@@ -26,18 +26,20 @@ _lltuple = dns.inet.low_level_address_tuple
 
 class DatagramSocket(dns._asyncbackend.DatagramSocket):
     def __init__(self, socket):
+        super().__init__(socket.family)
         self.socket = socket
-        self.family = socket.family
 
     async def sendto(self, what, destination, timeout):
         with _maybe_timeout(timeout):
             return await self.socket.sendto(what, destination)
-        raise dns.exception.Timeout(timeout=timeout)  # pragma: no cover
+        raise dns.exception.Timeout(
+            timeout=timeout
+        )  # pragma: no cover  lgtm[py/unreachable-statement]
 
     async def recvfrom(self, size, timeout):
         with _maybe_timeout(timeout):
             return await self.socket.recvfrom(size)
-        raise dns.exception.Timeout(timeout=timeout)
+        raise dns.exception.Timeout(timeout=timeout)  # lgtm[py/unreachable-statement]
 
     async def close(self):
         self.socket.close()
@@ -58,12 +60,12 @@ class StreamSocket(dns._asyncbackend.StreamSocket):
     async def sendall(self, what, timeout):
         with _maybe_timeout(timeout):
             return await self.stream.send_all(what)
-        raise dns.exception.Timeout(timeout=timeout)
+        raise dns.exception.Timeout(timeout=timeout)  # lgtm[py/unreachable-statement]
 
     async def recv(self, size, timeout):
         with _maybe_timeout(timeout):
             return await self.stream.receive_some(size)
-        raise dns.exception.Timeout(timeout=timeout)
+        raise dns.exception.Timeout(timeout=timeout)  # lgtm[py/unreachable-statement]
 
     async def close(self):
         await self.stream.aclose()
@@ -83,11 +85,19 @@ class StreamSocket(dns._asyncbackend.StreamSocket):
 
 class Backend(dns._asyncbackend.Backend):
     def name(self):
-        return 'trio'
+        return "trio"
 
-    async def make_socket(self, af, socktype, proto=0, source=None,
-                          destination=None, timeout=None,
-                          ssl_context=None, server_hostname=None):
+    async def make_socket(
+        self,
+        af,
+        socktype,
+        proto=0,
+        source=None,
+        destination=None,
+        timeout=None,
+        ssl_context=None,
+        server_hostname=None,
+    ):
         s = trio.socket.socket(af, socktype, proto)
         stream = None
         try:
@@ -103,19 +113,20 @@ class Backend(dns._asyncbackend.Backend):
             return DatagramSocket(s)
         elif socktype == socket.SOCK_STREAM:
             stream = trio.SocketStream(s)
-            s = None
             tls = False
             if ssl_context:
                 tls = True
                 try:
-                    stream = trio.SSLStream(stream, ssl_context,
-                                            server_hostname=server_hostname)
+                    stream = trio.SSLStream(
+                        stream, ssl_context, server_hostname=server_hostname
+                    )
                 except Exception:  # pragma: no cover
                     await stream.aclose()
                     raise
             return StreamSocket(af, stream, tls)
-        raise NotImplementedError('unsupported socket ' +
-                                  f'type {socktype}')    # pragma: no cover
+        raise NotImplementedError(
+            "unsupported socket " + f"type {socktype}"
+        )  # pragma: no cover
 
     async def sleep(self, interval):
         await trio.sleep(interval)
diff --git a/lib/dns/asyncbackend.py b/lib/dns/asyncbackend.py
index 089d3d35..c7565a99 100644
--- a/lib/dns/asyncbackend.py
+++ b/lib/dns/asyncbackend.py
@@ -1,26 +1,33 @@
 # Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license
 
+from typing import Dict
+
 import dns.exception
 
 # pylint: disable=unused-import
 
-from dns._asyncbackend import Socket, DatagramSocket, \
-    StreamSocket, Backend  # noqa:
+from dns._asyncbackend import (
+    Socket,
+    DatagramSocket,
+    StreamSocket,
+    Backend,
+)  # noqa: F401  lgtm[py/unused-import]
 
 # pylint: enable=unused-import
 
 _default_backend = None
 
-_backends = {}
+_backends: Dict[str, Backend] = {}
 
 # Allow sniffio import to be disabled for testing purposes
 _no_sniffio = False
 
+
 class AsyncLibraryNotFoundError(dns.exception.DNSException):
     pass
 
 
-def get_backend(name):
+def get_backend(name: str) -> Backend:
     """Get the specified asynchronous backend.
 
     *name*, a ``str``, the name of the backend.  Currently the "trio",
@@ -32,22 +39,25 @@ def get_backend(name):
     backend = _backends.get(name)
     if backend:
         return backend
-    if name == 'trio':
+    if name == "trio":
         import dns._trio_backend
+
         backend = dns._trio_backend.Backend()
-    elif name == 'curio':
+    elif name == "curio":
         import dns._curio_backend
+
         backend = dns._curio_backend.Backend()
-    elif name == 'asyncio':
+    elif name == "asyncio":
         import dns._asyncio_backend
+
         backend = dns._asyncio_backend.Backend()
     else:
-        raise NotImplementedError(f'unimplemented async backend {name}')
+        raise NotImplementedError(f"unimplemented async backend {name}")
     _backends[name] = backend
     return backend
 
 
-def sniff():
+def sniff() -> str:
     """Attempt to determine the in-use asynchronous I/O library by using
     the ``sniffio`` module if it is available.
 
@@ -59,35 +69,32 @@ def sniff():
         if _no_sniffio:
             raise ImportError
         import sniffio
+
         try:
             return sniffio.current_async_library()
         except sniffio.AsyncLibraryNotFoundError:
-            raise AsyncLibraryNotFoundError('sniffio cannot determine ' +
-                                            'async library')
+            raise AsyncLibraryNotFoundError(
+                "sniffio cannot determine " + "async library"
+            )
     except ImportError:
         import asyncio
+
         try:
             asyncio.get_running_loop()
-            return 'asyncio'
+            return "asyncio"
         except RuntimeError:
-            raise AsyncLibraryNotFoundError('no async library detected')
-        except AttributeError:  # pragma: no cover
-            # we have to check current_task on 3.6
-            if not asyncio.Task.current_task():
-                raise AsyncLibraryNotFoundError('no async library detected')
-            return 'asyncio'
+            raise AsyncLibraryNotFoundError("no async library detected")
 
 
-def get_default_backend():
-    """Get the default backend, initializing it if necessary.
-    """
+def get_default_backend() -> Backend:
+    """Get the default backend, initializing it if necessary."""
     if _default_backend:
         return _default_backend
 
     return set_default_backend(sniff())
 
 
-def set_default_backend(name):
+def set_default_backend(name: str) -> Backend:
     """Set the default backend.
 
     It's not normally necessary to call this method, as
diff --git a/lib/dns/asyncbackend.pyi b/lib/dns/asyncbackend.pyi
deleted file mode 100644
index 1ec9d32b..00000000
--- a/lib/dns/asyncbackend.pyi
+++ /dev/null
@@ -1,13 +0,0 @@
-# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license
-
-class Backend:
-    ...
-
-def get_backend(name: str) -> Backend:
-    ...
-def sniff() -> str:
-    ...
-def get_default_backend() -> Backend:
-    ...
-def set_default_backend(name: str) -> Backend:
-    ...
diff --git a/lib/dns/asyncquery.py b/lib/dns/asyncquery.py
index 4ec97fb7..459c611d 100644
--- a/lib/dns/asyncquery.py
+++ b/lib/dns/asyncquery.py
@@ -17,7 +17,10 @@
 
 """Talk to a DNS server."""
 
+from typing import Any, Dict, Optional, Tuple, Union
+
 import base64
+import contextlib
 import socket
 import struct
 import time
@@ -27,12 +30,24 @@ import dns.exception
 import dns.inet
 import dns.name
 import dns.message
+import dns.quic
 import dns.rcode
 import dns.rdataclass
 import dns.rdatatype
+import dns.transaction
 
-from dns.query import _compute_times, _matches_destination, BadResponse, ssl, \
-    UDPMode, _have_httpx, _have_http2, NoDOH
+from dns._asyncbackend import NullContext
+from dns.query import (
+    _compute_times,
+    _matches_destination,
+    BadResponse,
+    ssl,
+    UDPMode,
+    _have_httpx,
+    _have_http2,
+    NoDOH,
+    NoDOQ,
+)
 
 if _have_httpx:
     import httpx
@@ -47,11 +62,11 @@ def _source_tuple(af, address, port):
     if address or port:
         if address is None:
             if af == socket.AF_INET:
-                address = '0.0.0.0'
+                address = "0.0.0.0"
             elif af == socket.AF_INET6:
-                address = '::'
+                address = "::"
             else:
-                raise NotImplementedError(f'unknown address family {af}')
+                raise NotImplementedError(f"unknown address family {af}")
         return (address, port)
     else:
         return None
@@ -66,7 +81,12 @@ def _timeout(expiration, now=None):
         return None
 
 
-async def send_udp(sock, what, destination, expiration=None):
+async def send_udp(
+    sock: dns.asyncbackend.DatagramSocket,
+    what: Union[dns.message.Message, bytes],
+    destination: Any,
+    expiration: Optional[float] = None,
+) -> Tuple[int, float]:
     """Send a DNS message to the specified UDP socket.
 
     *sock*, a ``dns.asyncbackend.DatagramSocket``.
@@ -78,7 +98,8 @@ async def send_udp(sock, what, destination, expiration=None):
 
     *expiration*, a ``float`` or ``None``, the absolute time at which
     a timeout exception should be raised.  If ``None``, no timeout will
-    occur.
+    occur.  The expiration value is meaningless for the asyncio backend, as
+    asyncio's transport sendto() never blocks.
 
     Returns an ``(int, float)`` tuple of bytes sent and the sent time.
     """
@@ -90,35 +111,61 @@ async def send_udp(sock, what, destination, expiration=None):
     return (n, sent_time)
 
 
-async def receive_udp(sock, destination=None, expiration=None,
-                      ignore_unexpected=False, one_rr_per_rrset=False,
-                      keyring=None, request_mac=b'', ignore_trailing=False,
-                      raise_on_truncation=False):
+async def receive_udp(
+    sock: dns.asyncbackend.DatagramSocket,
+    destination: Optional[Any] = None,
+    expiration: Optional[float] = None,
+    ignore_unexpected: bool = False,
+    one_rr_per_rrset: bool = False,
+    keyring: Optional[Dict[dns.name.Name, dns.tsig.Key]] = None,
+    request_mac: Optional[bytes] = b"",
+    ignore_trailing: bool = False,
+    raise_on_truncation: bool = False,
+) -> Any:
     """Read a DNS message from a UDP socket.
 
     *sock*, a ``dns.asyncbackend.DatagramSocket``.
 
     See :py:func:`dns.query.receive_udp()` for the documentation of the other
-    parameters, exceptions, and return type of this method.
+    parameters, and exceptions.
+
+    Returns a ``(dns.message.Message, float, tuple)`` tuple of the received message, the
+    received time, and the address where the message arrived from.
     """
 
-    wire = b''
+    wire = b""
     while 1:
         (wire, from_address) = await sock.recvfrom(65535, _timeout(expiration))
-        if _matches_destination(sock.family, from_address, destination,
-                                ignore_unexpected):
+        if _matches_destination(
+            sock.family, from_address, destination, ignore_unexpected
+        ):
             break
     received_time = time.time()
-    r = dns.message.from_wire(wire, keyring=keyring, request_mac=request_mac,
-                              one_rr_per_rrset=one_rr_per_rrset,
-                              ignore_trailing=ignore_trailing,
-                              raise_on_truncation=raise_on_truncation)
+    r = dns.message.from_wire(
+        wire,
+        keyring=keyring,
+        request_mac=request_mac,
+        one_rr_per_rrset=one_rr_per_rrset,
+        ignore_trailing=ignore_trailing,
+        raise_on_truncation=raise_on_truncation,
+    )
     return (r, received_time, from_address)
 
-async def udp(q, where, timeout=None, port=53, source=None, source_port=0,
-              ignore_unexpected=False, one_rr_per_rrset=False,
-              ignore_trailing=False, raise_on_truncation=False, sock=None,
-              backend=None):
+
+async def udp(
+    q: dns.message.Message,
+    where: str,
+    timeout: Optional[float] = None,
+    port: int = 53,
+    source: Optional[str] = None,
+    source_port: int = 0,
+    ignore_unexpected: bool = False,
+    one_rr_per_rrset: bool = False,
+    ignore_trailing: bool = False,
+    raise_on_truncation: bool = False,
+    sock: Optional[dns.asyncbackend.DatagramSocket] = None,
+    backend: Optional[dns.asyncbackend.Backend] = None,
+) -> dns.message.Message:
     """Return the response obtained after sending a query via UDP.
 
     *sock*, a ``dns.asyncbackend.DatagramSocket``, or ``None``,
@@ -134,42 +181,52 @@ async def udp(q, where, timeout=None, port=53, source=None, source_port=0,
     """
     wire = q.to_wire()
     (begin_time, expiration) = _compute_times(timeout)
-    s = None
-    # After 3.6 is no longer supported, this can use an AsyncExitStack.
-    try:
-        af = dns.inet.af_for_address(where)
-        destination = _lltuple((where, port), af)
-        if sock:
-            s = sock
+    af = dns.inet.af_for_address(where)
+    destination = _lltuple((where, port), af)
+    if sock:
+        cm: contextlib.AbstractAsyncContextManager = NullContext(sock)
+    else:
+        if not backend:
+            backend = dns.asyncbackend.get_default_backend()
+        stuple = _source_tuple(af, source, source_port)
+        if backend.datagram_connection_required():
+            dtuple = (where, port)
         else:
-            if not backend:
-                backend = dns.asyncbackend.get_default_backend()
-            stuple = _source_tuple(af, source, source_port)
-            if backend.datagram_connection_required():
-                dtuple = (where, port)
-            else:
-                dtuple = None
-            s = await backend.make_socket(af, socket.SOCK_DGRAM, 0, stuple,
-                                          dtuple)
+            dtuple = None
+        cm = await backend.make_socket(af, socket.SOCK_DGRAM, 0, stuple, dtuple)
+    async with cm as s:
         await send_udp(s, wire, destination, expiration)
-        (r, received_time, _) = await receive_udp(s, destination, expiration,
-                                                  ignore_unexpected,
-                                                  one_rr_per_rrset,
-                                                  q.keyring, q.mac,
-                                                  ignore_trailing,
-                                                  raise_on_truncation)
+        (r, received_time, _) = await receive_udp(
+            s,
+            destination,
+            expiration,
+            ignore_unexpected,
+            one_rr_per_rrset,
+            q.keyring,
+            q.mac,
+            ignore_trailing,
+            raise_on_truncation,
+        )
         r.time = received_time - begin_time
         if not q.is_response(r):
             raise BadResponse
         return r
-    finally:
-        if not sock and s:
-            await s.close()
 
-async def udp_with_fallback(q, where, timeout=None, port=53, source=None,
-                            source_port=0, ignore_unexpected=False,
-                            one_rr_per_rrset=False, ignore_trailing=False,
-                            udp_sock=None, tcp_sock=None, backend=None):
+
+async def udp_with_fallback(
+    q: dns.message.Message,
+    where: str,
+    timeout: Optional[float] = None,
+    port: int = 53,
+    source: Optional[str] = None,
+    source_port: int = 0,
+    ignore_unexpected: bool = False,
+    one_rr_per_rrset: bool = False,
+    ignore_trailing: bool = False,
+    udp_sock: Optional[dns.asyncbackend.DatagramSocket] = None,
+    tcp_sock: Optional[dns.asyncbackend.StreamSocket] = None,
+    backend: Optional[dns.asyncbackend.Backend] = None,
+) -> Tuple[dns.message.Message, bool]:
     """Return the response to the query, trying UDP first and falling back
     to TCP if UDP results in a truncated response.
 
@@ -191,18 +248,42 @@ async def udp_with_fallback(q, where, timeout=None, port=53, source=None,
     method.
     """
     try:
-        response = await udp(q, where, timeout, port, source, source_port,
-                             ignore_unexpected, one_rr_per_rrset,
-                             ignore_trailing, True, udp_sock, backend)
+        response = await udp(
+            q,
+            where,
+            timeout,
+            port,
+            source,
+            source_port,
+            ignore_unexpected,
+            one_rr_per_rrset,
+            ignore_trailing,
+            True,
+            udp_sock,
+            backend,
+        )
         return (response, False)
     except dns.message.Truncated:
-        response = await tcp(q, where, timeout, port, source, source_port,
-                             one_rr_per_rrset, ignore_trailing, tcp_sock,
-                             backend)
+        response = await tcp(
+            q,
+            where,
+            timeout,
+            port,
+            source,
+            source_port,
+            one_rr_per_rrset,
+            ignore_trailing,
+            tcp_sock,
+            backend,
+        )
         return (response, True)
 
 
-async def send_tcp(sock, what, expiration=None):
+async def send_tcp(
+    sock: dns.asyncbackend.StreamSocket,
+    what: Union[dns.message.Message, bytes],
+    expiration: Optional[float] = None,
+) -> Tuple[int, float]:
     """Send a DNS message to the specified TCP socket.
 
     *sock*, a ``dns.asyncbackend.StreamSocket``.
@@ -212,12 +293,14 @@ async def send_tcp(sock, what, expiration=None):
     """
 
     if isinstance(what, dns.message.Message):
-        what = what.to_wire()
-    l = len(what)
+        wire = what.to_wire()
+    else:
+        wire = what
+    l = len(wire)
     # copying the wire into tcpmsg is inefficient, but lets us
     # avoid writev() or doing a short write that would get pushed
     # onto the net
-    tcpmsg = struct.pack("!H", l) + what
+    tcpmsg = struct.pack("!H", l) + wire
     sent_time = time.time()
     await sock.sendall(tcpmsg, _timeout(expiration, sent_time))
     return (len(tcpmsg), sent_time)
@@ -227,18 +310,24 @@ async def _read_exactly(sock, count, expiration):
     """Read the specified number of bytes from stream.  Keep trying until we
     either get the desired amount, or we hit EOF.
     """
-    s = b''
+    s = b""
     while count > 0:
         n = await sock.recv(count, _timeout(expiration))
-        if n == b'':
+        if n == b"":
             raise EOFError
         count = count - len(n)
         s = s + n
     return s
 
 
-async def receive_tcp(sock, expiration=None, one_rr_per_rrset=False,
-                      keyring=None, request_mac=b'', ignore_trailing=False):
+async def receive_tcp(
+    sock: dns.asyncbackend.StreamSocket,
+    expiration: Optional[float] = None,
+    one_rr_per_rrset: bool = False,
+    keyring: Optional[Dict[dns.name.Name, dns.tsig.Key]] = None,
+    request_mac: Optional[bytes] = b"",
+    ignore_trailing: bool = False,
+) -> Tuple[dns.message.Message, float]:
     """Read a DNS message from a TCP socket.
 
     *sock*, a ``dns.asyncbackend.StreamSocket``.
@@ -251,15 +340,28 @@ async def receive_tcp(sock, expiration=None, one_rr_per_rrset=False,
     (l,) = struct.unpack("!H", ldata)
     wire = await _read_exactly(sock, l, expiration)
     received_time = time.time()
-    r = dns.message.from_wire(wire, keyring=keyring, request_mac=request_mac,
-                              one_rr_per_rrset=one_rr_per_rrset,
-                              ignore_trailing=ignore_trailing)
+    r = dns.message.from_wire(
+        wire,
+        keyring=keyring,
+        request_mac=request_mac,
+        one_rr_per_rrset=one_rr_per_rrset,
+        ignore_trailing=ignore_trailing,
+    )
     return (r, received_time)
 
 
-async def tcp(q, where, timeout=None, port=53, source=None, source_port=0,
-              one_rr_per_rrset=False, ignore_trailing=False, sock=None,
-              backend=None):
+async def tcp(
+    q: dns.message.Message,
+    where: str,
+    timeout: Optional[float] = None,
+    port: int = 53,
+    source: Optional[str] = None,
+    source_port: int = 0,
+    one_rr_per_rrset: bool = False,
+    ignore_trailing: bool = False,
+    sock: Optional[dns.asyncbackend.StreamSocket] = None,
+    backend: Optional[dns.asyncbackend.Backend] = None,
+) -> dns.message.Message:
     """Return the response obtained after sending a query via TCP.
 
     *sock*, a ``dns.asyncbacket.StreamSocket``, or ``None``, the
@@ -276,41 +378,48 @@ async def tcp(q, where, timeout=None, port=53, source=None, source_port=0,
 
     wire = q.to_wire()
     (begin_time, expiration) = _compute_times(timeout)
-    s = None
-    # After 3.6 is no longer supported, this can use an AsyncExitStack.
-    try:
-        if sock:
-            # Verify that the socket is connected, as if it's not connected,
-            # it's not writable, and the polling in send_tcp() will time out or
-            # hang forever.
-            await sock.getpeername()
-            s = sock
-        else:
-            # These are simple (address, port) pairs, not
-            # family-dependent tuples you pass to lowlevel socket
-            # code.
-            af = dns.inet.af_for_address(where)
-            stuple = _source_tuple(af, source, source_port)
-            dtuple = (where, port)
-            if not backend:
-                backend = dns.asyncbackend.get_default_backend()
-            s = await backend.make_socket(af, socket.SOCK_STREAM, 0, stuple,
-                                          dtuple, timeout)
+    if sock:
+        # Verify that the socket is connected, as if it's not connected,
+        # it's not writable, and the polling in send_tcp() will time out or
+        # hang forever.
+        await sock.getpeername()
+        cm: contextlib.AbstractAsyncContextManager = NullContext(sock)
+    else:
+        # These are simple (address, port) pairs, not family-dependent tuples
+        # you pass to low-level socket code.
+        af = dns.inet.af_for_address(where)
+        stuple = _source_tuple(af, source, source_port)
+        dtuple = (where, port)
+        if not backend:
+            backend = dns.asyncbackend.get_default_backend()
+        cm = await backend.make_socket(
+            af, socket.SOCK_STREAM, 0, stuple, dtuple, timeout
+        )
+    async with cm as s:
         await send_tcp(s, wire, expiration)
-        (r, received_time) = await receive_tcp(s, expiration, one_rr_per_rrset,
-                                               q.keyring, q.mac,
-                                               ignore_trailing)
+        (r, received_time) = await receive_tcp(
+            s, expiration, one_rr_per_rrset, q.keyring, q.mac, ignore_trailing
+        )
         r.time = received_time - begin_time
         if not q.is_response(r):
             raise BadResponse
         return r
-    finally:
-        if not sock and s:
-            await s.close()
 
-async def tls(q, where, timeout=None, port=853, source=None, source_port=0,
-              one_rr_per_rrset=False, ignore_trailing=False, sock=None,
-              backend=None, ssl_context=None, server_hostname=None):
+
+async def tls(
+    q: dns.message.Message,
+    where: str,
+    timeout: Optional[float] = None,
+    port: int = 853,
+    source: Optional[str] = None,
+    source_port: int = 0,
+    one_rr_per_rrset: bool = False,
+    ignore_trailing: bool = False,
+    sock: Optional[dns.asyncbackend.StreamSocket] = None,
+    backend: Optional[dns.asyncbackend.Backend] = None,
+    ssl_context: Optional[ssl.SSLContext] = None,
+    server_hostname: Optional[str] = None,
+) -> dns.message.Message:
     """Return the response obtained after sending a query via TLS.
 
     *sock*, an ``asyncbackend.StreamSocket``, or ``None``, the socket
@@ -326,11 +435,14 @@ async def tls(q, where, timeout=None, port=853, source=None, source_port=0,
     See :py:func:`dns.query.tls()` for the documentation of the other
     parameters, exceptions, and return type of this method.
     """
-    # After 3.6 is no longer supported, this can use an AsyncExitStack.
     (begin_time, expiration) = _compute_times(timeout)
-    if not sock:
+    if sock:
+        cm: contextlib.AbstractAsyncContextManager = NullContext(sock)
+    else:
         if ssl_context is None:
-            ssl_context = ssl.create_default_context()
+            # See the comment about ssl.create_default_context() in query.py
+            ssl_context = ssl.create_default_context()  # lgtm[py/insecure-protocol]
+            ssl_context.minimum_version = ssl.TLSVersion.TLSv1_2
             if server_hostname is None:
                 ssl_context.check_hostname = False
         else:
@@ -341,25 +453,49 @@ async def tls(q, where, timeout=None, port=853, source=None, source_port=0,
         dtuple = (where, port)
         if not backend:
             backend = dns.asyncbackend.get_default_backend()
-        s = await backend.make_socket(af, socket.SOCK_STREAM, 0, stuple,
-                                      dtuple, timeout, ssl_context,
-                                      server_hostname)
-    else:
-        s = sock
-    try:
+        cm = await backend.make_socket(
+            af,
+            socket.SOCK_STREAM,
+            0,
+            stuple,
+            dtuple,
+            timeout,
+            ssl_context,
+            server_hostname,
+        )
+    async with cm as s:
         timeout = _timeout(expiration)
-        response = await tcp(q, where, timeout, port, source, source_port,
-                             one_rr_per_rrset, ignore_trailing, s, backend)
+        response = await tcp(
+            q,
+            where,
+            timeout,
+            port,
+            source,
+            source_port,
+            one_rr_per_rrset,
+            ignore_trailing,
+            s,
+            backend,
+        )
         end_time = time.time()
         response.time = end_time - begin_time
         return response
-    finally:
-        if not sock and s:
-            await s.close()
 
-async def https(q, where, timeout=None, port=443, source=None, source_port=0,
-                one_rr_per_rrset=False, ignore_trailing=False, client=None,
-                path='/dns-query', post=True, verify=True):
+
+async def https(
+    q: dns.message.Message,
+    where: str,
+    timeout: Optional[float] = None,
+    port: int = 443,
+    source: Optional[str] = None,
+    source_port: int = 0,  # pylint: disable=W0613
+    one_rr_per_rrset: bool = False,
+    ignore_trailing: bool = False,
+    client: Optional["httpx.AsyncClient"] = None,
+    path: str = "/dns-query",
+    post: bool = True,
+    verify: Union[bool, str] = True,
+) -> dns.message.Message:
     """Return the response obtained after sending a query via DNS-over-HTTPS.
 
     *client*, a ``httpx.AsyncClient``.  If provided, the client to use for
@@ -373,7 +509,7 @@ async def https(q, where, timeout=None, port=443, source=None, source_port=0,
     """
 
     if not _have_httpx:
-        raise NoDOH('httpx is not available.')  # pragma: no cover
+        raise NoDOH("httpx is not available.")  # pragma: no cover
 
     wire = q.to_wire()
     try:
@@ -381,65 +517,78 @@ async def https(q, where, timeout=None, port=443, source=None, source_port=0,
     except ValueError:
         af = None
     transport = None
-    headers = {
-        "accept": "application/dns-message"
-    }
+    headers = {"accept": "application/dns-message"}
     if af is not None:
         if af == socket.AF_INET:
-            url = 'https://{}:{}{}'.format(where, port, path)
+            url = "https://{}:{}{}".format(where, port, path)
         elif af == socket.AF_INET6:
-            url = 'https://[{}]:{}{}'.format(where, port, path)
+            url = "https://[{}]:{}{}".format(where, port, path)
     else:
         url = where
     if source is not None:
         transport = httpx.AsyncHTTPTransport(local_address=source[0])
 
-    # After 3.6 is no longer supported, this can use an AsyncExitStack
-    client_to_close = None
-    try:
-        if not client:
-            client = httpx.AsyncClient(http1=True, http2=_have_http2,
-                                       verify=verify, transport=transport)
-            client_to_close = client
+    if client:
+        cm: contextlib.AbstractAsyncContextManager = NullContext(client)
+    else:
+        cm = httpx.AsyncClient(
+            http1=True, http2=_have_http2, verify=verify, transport=transport
+        )
 
+    async with cm as the_client:
         # see https://tools.ietf.org/html/rfc8484#section-4.1.1 for DoH
         # GET and POST examples
         if post:
-            headers.update({
-                "content-type": "application/dns-message",
-                "content-length": str(len(wire))
-            })
-            response = await client.post(url, headers=headers, content=wire,
-                                         timeout=timeout)
+            headers.update(
+                {
+                    "content-type": "application/dns-message",
+                    "content-length": str(len(wire)),
+                }
+            )
+            response = await the_client.post(
+                url, headers=headers, content=wire, timeout=timeout
+            )
         else:
             wire = base64.urlsafe_b64encode(wire).rstrip(b"=")
-            wire = wire.decode()  # httpx does a repr() if we give it bytes
-            response = await client.get(url, headers=headers, timeout=timeout,
-                                        params={"dns": wire})
-    finally:
-        if client_to_close:
-            await client.aclose()
+            twire = wire.decode()  # httpx does a repr() if we give it bytes
+            response = await the_client.get(
+                url, headers=headers, timeout=timeout, params={"dns": twire}
+            )
 
     # see https://tools.ietf.org/html/rfc8484#section-4.2.1 for info about DoH
     # status codes
     if response.status_code < 200 or response.status_code > 299:
-        raise ValueError('{} responded with status code {}'
-                         '\nResponse body: {}'.format(where,
-                                                      response.status_code,
-                                                      response.content))
-    r = dns.message.from_wire(response.content,
-                              keyring=q.keyring,
-                              request_mac=q.request_mac,
-                              one_rr_per_rrset=one_rr_per_rrset,
-                              ignore_trailing=ignore_trailing)
-    r.time = response.elapsed
+        raise ValueError(
+            "{} responded with status code {}"
+            "\nResponse body: {!r}".format(
+                where, response.status_code, response.content
+            )
+        )
+    r = dns.message.from_wire(
+        response.content,
+        keyring=q.keyring,
+        request_mac=q.request_mac,
+        one_rr_per_rrset=one_rr_per_rrset,
+        ignore_trailing=ignore_trailing,
+    )
+    r.time = response.elapsed.total_seconds()
     if not q.is_response(r):
         raise BadResponse
     return r
 
-async def inbound_xfr(where, txn_manager, query=None,
-                      port=53, timeout=None, lifetime=None, source=None,
-                      source_port=0, udp_mode=UDPMode.NEVER, backend=None):
+
+async def inbound_xfr(
+    where: str,
+    txn_manager: dns.transaction.TransactionManager,
+    query: Optional[dns.message.Message] = None,
+    port: int = 53,
+    timeout: Optional[float] = None,
+    lifetime: Optional[float] = None,
+    source: Optional[str] = None,
+    source_port: int = 0,
+    udp_mode: UDPMode = UDPMode.NEVER,
+    backend: Optional[dns.asyncbackend.Backend] = None,
+) -> None:
     """Conduct an inbound transfer and apply it via a transaction from the
     txn_manager.
 
@@ -472,42 +621,48 @@ async def inbound_xfr(where, txn_manager, query=None,
             is_udp = False
         if not backend:
             backend = dns.asyncbackend.get_default_backend()
-        s = await backend.make_socket(af, sock_type, 0, stuple, dtuple,
-                                      _timeout(expiration))
+        s = await backend.make_socket(
+            af, sock_type, 0, stuple, dtuple, _timeout(expiration)
+        )
         async with s:
             if is_udp:
                 await s.sendto(wire, dtuple, _timeout(expiration))
             else:
                 tcpmsg = struct.pack("!H", len(wire)) + wire
                 await s.sendall(tcpmsg, expiration)
-            with dns.xfr.Inbound(txn_manager, rdtype, serial,
-                                 is_udp) as inbound:
+            with dns.xfr.Inbound(txn_manager, rdtype, serial, is_udp) as inbound:
                 done = False
                 tsig_ctx = None
                 while not done:
                     (_, mexpiration) = _compute_times(timeout)
-                    if mexpiration is None or \
-                       (expiration is not None and mexpiration > expiration):
+                    if mexpiration is None or (
+                        expiration is not None and mexpiration > expiration
+                    ):
                         mexpiration = expiration
                     if is_udp:
                         destination = _lltuple((where, port), af)
                         while True:
                             timeout = _timeout(mexpiration)
-                            (rwire, from_address) = await s.recvfrom(65535,
-                                                                     timeout)
-                            if _matches_destination(af, from_address,
-                                                    destination, True):
+                            (rwire, from_address) = await s.recvfrom(65535, timeout)
+                            if _matches_destination(
+                                af, from_address, destination, True
+                            ):
                                 break
                     else:
                         ldata = await _read_exactly(s, 2, mexpiration)
                         (l,) = struct.unpack("!H", ldata)
                         rwire = await _read_exactly(s, l, mexpiration)
-                    is_ixfr = (rdtype == dns.rdatatype.IXFR)
-                    r = dns.message.from_wire(rwire, keyring=query.keyring,
-                                              request_mac=query.mac, xfr=True,
-                                              origin=origin, tsig_ctx=tsig_ctx,
-                                              multi=(not is_udp),
-                                              one_rr_per_rrset=is_ixfr)
+                    is_ixfr = rdtype == dns.rdatatype.IXFR
+                    r = dns.message.from_wire(
+                        rwire,
+                        keyring=query.keyring,
+                        request_mac=query.mac,
+                        xfr=True,
+                        origin=origin,
+                        tsig_ctx=tsig_ctx,
+                        multi=(not is_udp),
+                        one_rr_per_rrset=is_ixfr,
+                    )
                     try:
                         done = inbound.process_message(r)
                     except dns.xfr.UseTCP:
@@ -521,3 +676,62 @@ async def inbound_xfr(where, txn_manager, query=None,
                     tsig_ctx = r.tsig_ctx
                 if not retry and query.keyring and not r.had_tsig:
                     raise dns.exception.FormError("missing TSIG")
+
+
+async def quic(
+    q: dns.message.Message,
+    where: str,
+    timeout: Optional[float] = None,
+    port: int = 853,
+    source: Optional[str] = None,
+    source_port: int = 0,
+    one_rr_per_rrset: bool = False,
+    ignore_trailing: bool = False,
+    connection: Optional[dns.quic.AsyncQuicConnection] = None,
+    verify: Union[bool, str] = True,
+    backend: Optional[dns.asyncbackend.Backend] = None,
+) -> dns.message.Message:
+    """Return the response obtained after sending an asynchronous query via
+    DNS-over-QUIC.
+
+    *backend*, a ``dns.asyncbackend.Backend``, or ``None``.  If ``None``,
+    the default, then dnspython will use the default backend.
+
+    See :py:func:`dns.query.quic()` for the documentation of the other
+    parameters, exceptions, and return type of this method.
+    """
+
+    if not dns.quic.have_quic:
+        raise NoDOQ("DNS-over-QUIC is not available.")  # pragma: no cover
+
+    q.id = 0
+    wire = q.to_wire()
+    the_connection: dns.quic.AsyncQuicConnection
+    if connection:
+        cfactory = dns.quic.null_factory
+        mfactory = dns.quic.null_factory
+        the_connection = connection
+    else:
+        (cfactory, mfactory) = dns.quic.factories_for_backend(backend)
+
+    async with cfactory() as context:
+        async with mfactory(context, verify_mode=verify) as the_manager:
+            if not connection:
+                the_connection = the_manager.connect(where, port, source, source_port)
+            start = time.time()
+            stream = await the_connection.make_stream()
+            async with stream:
+                await stream.send(wire, True)
+                wire = await stream.receive(timeout)
+            finish = time.time()
+        r = dns.message.from_wire(
+            wire,
+            keyring=q.keyring,
+            request_mac=q.request_mac,
+            one_rr_per_rrset=one_rr_per_rrset,
+            ignore_trailing=ignore_trailing,
+        )
+    r.time = max(finish - start, 0.0)
+    if not q.is_response(r):
+        raise BadResponse
+    return r
diff --git a/lib/dns/asyncquery.pyi b/lib/dns/asyncquery.pyi
deleted file mode 100644
index a03434c2..00000000
--- a/lib/dns/asyncquery.pyi
+++ /dev/null
@@ -1,43 +0,0 @@
-from typing import Optional, Union, Dict, Generator, Any
-from . import tsig, rdatatype, rdataclass, name, message, asyncbackend
-
-# If the ssl import works, then
-#
-#    error: Name 'ssl' already defined (by an import)
-#
-# is expected and can be ignored.
-try:
-    import ssl
-except ImportError:
-    class ssl:    # type: ignore
-        SSLContext : Dict = {}
-
-async def udp(q : message.Message, where : str,
-              timeout : Optional[float] = None, port=53,
-              source : Optional[str] = None, source_port : Optional[int] = 0,
-              ignore_unexpected : Optional[bool] = False,
-              one_rr_per_rrset : Optional[bool] = False,
-              ignore_trailing : Optional[bool] = False,
-              sock : Optional[asyncbackend.DatagramSocket] = None,
-              backend : Optional[asyncbackend.Backend] = None) -> message.Message:
-    pass
-
-async def tcp(q : message.Message, where : str, timeout : float = None, port=53,
-        af : Optional[int] = None, source : Optional[str] = None,
-        source_port : Optional[int] = 0,
-        one_rr_per_rrset : Optional[bool] = False,
-        ignore_trailing : Optional[bool] = False,
-        sock : Optional[asyncbackend.StreamSocket] = None,
-        backend : Optional[asyncbackend.Backend] = None) -> message.Message:
-    pass
-
-async def tls(q : message.Message, where : str,
-              timeout : Optional[float] = None, port=53,
-              source : Optional[str] = None, source_port : Optional[int] = 0,
-              one_rr_per_rrset : Optional[bool] = False,
-              ignore_trailing : Optional[bool] = False,
-              sock : Optional[asyncbackend.StreamSocket] = None,
-              backend : Optional[asyncbackend.Backend] = None,
-              ssl_context: Optional[ssl.SSLContext] = None,
-              server_hostname: Optional[str] = None) -> message.Message:
-    pass
diff --git a/lib/dns/asyncresolver.py b/lib/dns/asyncresolver.py
index ed29deed..506530e2 100644
--- a/lib/dns/asyncresolver.py
+++ b/lib/dns/asyncresolver.py
@@ -17,13 +17,18 @@
 
 """Asynchronous DNS stub resolver."""
 
+from typing import Any, Dict, Optional, Union
+
 import time
 
 import dns.asyncbackend
 import dns.asyncquery
 import dns.exception
+import dns.name
 import dns.query
-import dns.resolver
+import dns.rdataclass
+import dns.rdatatype
+import dns.resolver  # lgtm[py/import-and-import-from]
 
 # import some resolver symbols for brevity
 from dns.resolver import NXDOMAIN, NoAnswer, NotAbsolute, NoRootSOA
@@ -37,11 +42,19 @@ _tcp = dns.asyncquery.tcp
 class Resolver(dns.resolver.BaseResolver):
     """Asynchronous DNS stub resolver."""
 
-    async def resolve(self, qname, rdtype=dns.rdatatype.A,
-                      rdclass=dns.rdataclass.IN,
-                      tcp=False, source=None, raise_on_no_answer=True,
-                      source_port=0, lifetime=None, search=None,
-                      backend=None):
+    async def resolve(
+        self,
+        qname: Union[dns.name.Name, str],
+        rdtype: Union[dns.rdatatype.RdataType, str] = dns.rdatatype.A,
+        rdclass: Union[dns.rdataclass.RdataClass, str] = dns.rdataclass.IN,
+        tcp: bool = False,
+        source: Optional[str] = None,
+        raise_on_no_answer: bool = True,
+        source_port: int = 0,
+        lifetime: Optional[float] = None,
+        search: Optional[bool] = None,
+        backend: Optional[dns.asyncbackend.Backend] = None,
+    ) -> dns.resolver.Answer:
         """Query nameservers asynchronously to find the answer to the question.
 
         *backend*, a ``dns.asyncbackend.Backend``, or ``None``.  If ``None``,
@@ -52,8 +65,9 @@ class Resolver(dns.resolver.BaseResolver):
         type of this method.
         """
 
-        resolution = dns.resolver._Resolution(self, qname, rdtype, rdclass, tcp,
-                                              raise_on_no_answer, search)
+        resolution = dns.resolver._Resolution(
+            self, qname, rdtype, rdclass, tcp, raise_on_no_answer, search
+        )
         if not backend:
             backend = dns.asyncbackend.get_default_backend()
         start = time.time()
@@ -66,30 +80,40 @@ class Resolver(dns.resolver.BaseResolver):
             if answer is not None:
                 # cache hit!
                 return answer
+            assert request is not None  # needed for type checking
             done = False
             while not done:
                 (nameserver, port, tcp, backoff) = resolution.next_nameserver()
                 if backoff:
                     await backend.sleep(backoff)
-                timeout = self._compute_timeout(start, lifetime,
-                                                resolution.errors)
+                timeout = self._compute_timeout(start, lifetime, resolution.errors)
                 try:
                     if dns.inet.is_address(nameserver):
                         if tcp:
-                            response = await _tcp(request, nameserver,
-                                                  timeout, port,
-                                                  source, source_port,
-                                                  backend=backend)
+                            response = await _tcp(
+                                request,
+                                nameserver,
+                                timeout,
+                                port,
+                                source,
+                                source_port,
+                                backend=backend,
+                            )
                         else:
-                            response = await _udp(request, nameserver,
-                                                  timeout, port,
-                                                  source, source_port,
-                                                  raise_on_truncation=True,
-                                                  backend=backend)
+                            response = await _udp(
+                                request,
+                                nameserver,
+                                timeout,
+                                port,
+                                source,
+                                source_port,
+                                raise_on_truncation=True,
+                                backend=backend,
+                            )
                     else:
-                        response = await dns.asyncquery.https(request,
-                                                              nameserver,
-                                                              timeout=timeout)
+                        response = await dns.asyncquery.https(
+                            request, nameserver, timeout=timeout
+                        )
                 except Exception as ex:
                     (_, done) = resolution.query_result(None, ex)
                     continue
@@ -101,7 +125,9 @@ class Resolver(dns.resolver.BaseResolver):
                 if answer is not None:
                     return answer
 
-    async def resolve_address(self, ipaddr, *args, **kwargs):
+    async def resolve_address(
+        self, ipaddr: str, *args: Any, **kwargs: Any
+    ) -> dns.resolver.Answer:
         """Use an asynchronous resolver to run a reverse query for PTR
         records.
 
@@ -116,15 +142,20 @@ class Resolver(dns.resolver.BaseResolver):
         function.
 
         """
-
-        return await self.resolve(dns.reversename.from_address(ipaddr),
-                                  rdtype=dns.rdatatype.PTR,
-                                  rdclass=dns.rdataclass.IN,
-                                  *args, **kwargs)
+        # We make a modified kwargs for type checking happiness, as otherwise
+        # we get a legit warning about possibly having rdtype and rdclass
+        # in the kwargs more than once.
+        modified_kwargs: Dict[str, Any] = {}
+        modified_kwargs.update(kwargs)
+        modified_kwargs["rdtype"] = dns.rdatatype.PTR
+        modified_kwargs["rdclass"] = dns.rdataclass.IN
+        return await self.resolve(
+            dns.reversename.from_address(ipaddr), *args, **modified_kwargs
+        )
 
     # pylint: disable=redefined-outer-name
 
-    async def canonical_name(self, name):
+    async def canonical_name(self, name: Union[dns.name.Name, str]) -> dns.name.Name:
         """Determine the canonical name of *name*.
 
         The canonical name is the name the resolver uses for queries
@@ -149,14 +180,15 @@ class Resolver(dns.resolver.BaseResolver):
 default_resolver = None
 
 
-def get_default_resolver():
+def get_default_resolver() -> Resolver:
     """Get the default asynchronous resolver, initializing it if necessary."""
     if default_resolver is None:
         reset_default_resolver()
+    assert default_resolver is not None
     return default_resolver
 
 
-def reset_default_resolver():
+def reset_default_resolver() -> None:
     """Re-initialize default asynchronous resolver.
 
     Note that the resolver configuration (i.e. /etc/resolv.conf on UNIX
@@ -167,9 +199,18 @@ def reset_default_resolver():
     default_resolver = Resolver()
 
 
-async def resolve(qname, rdtype=dns.rdatatype.A, rdclass=dns.rdataclass.IN,
-                  tcp=False, source=None, raise_on_no_answer=True,
-                  source_port=0, lifetime=None, search=None, backend=None):
+async def resolve(
+    qname: Union[dns.name.Name, str],
+    rdtype: Union[dns.rdatatype.RdataType, str] = dns.rdatatype.A,
+    rdclass: Union[dns.rdataclass.RdataClass, str] = dns.rdataclass.IN,
+    tcp: bool = False,
+    source: Optional[str] = None,
+    raise_on_no_answer: bool = True,
+    source_port: int = 0,
+    lifetime: Optional[float] = None,
+    search: Optional[bool] = None,
+    backend: Optional[dns.asyncbackend.Backend] = None,
+) -> dns.resolver.Answer:
     """Query nameservers asynchronously to find the answer to the question.
 
     This is a convenience function that uses the default resolver
@@ -179,13 +220,23 @@ async def resolve(qname, rdtype=dns.rdatatype.A, rdclass=dns.rdataclass.IN,
     information on the parameters.
     """
 
-    return await get_default_resolver().resolve(qname, rdtype, rdclass, tcp,
-                                                source, raise_on_no_answer,
-                                                source_port, lifetime, search,
-                                                backend)
+    return await get_default_resolver().resolve(
+        qname,
+        rdtype,
+        rdclass,
+        tcp,
+        source,
+        raise_on_no_answer,
+        source_port,
+        lifetime,
+        search,
+        backend,
+    )
 
 
-async def resolve_address(ipaddr, *args, **kwargs):
+async def resolve_address(
+    ipaddr: str, *args: Any, **kwargs: Any
+) -> dns.resolver.Answer:
     """Use a resolver to run a reverse query for PTR records.
 
     See :py:func:`dns.asyncresolver.Resolver.resolve_address` for more
@@ -194,7 +245,8 @@ async def resolve_address(ipaddr, *args, **kwargs):
 
     return await get_default_resolver().resolve_address(ipaddr, *args, **kwargs)
 
-async def canonical_name(name):
+
+async def canonical_name(name: Union[dns.name.Name, str]) -> dns.name.Name:
     """Determine the canonical name of *name*.
 
     See :py:func:`dns.resolver.Resolver.canonical_name` for more
@@ -203,8 +255,14 @@ async def canonical_name(name):
 
     return await get_default_resolver().canonical_name(name)
 
-async def zone_for_name(name, rdclass=dns.rdataclass.IN, tcp=False,
-                        resolver=None, backend=None):
+
+async def zone_for_name(
+    name: Union[dns.name.Name, str],
+    rdclass: dns.rdataclass.RdataClass = dns.rdataclass.IN,
+    tcp: bool = False,
+    resolver: Optional[Resolver] = None,
+    backend: Optional[dns.asyncbackend.Backend] = None,
+) -> dns.name.Name:
     """Find the name of the zone which contains the specified name.
 
     See :py:func:`dns.resolver.Resolver.zone_for_name` for more
@@ -219,8 +277,10 @@ async def zone_for_name(name, rdclass=dns.rdataclass.IN, tcp=False,
         raise NotAbsolute(name)
     while True:
         try:
-            answer = await resolver.resolve(name, dns.rdatatype.SOA, rdclass,
-                                            tcp, backend=backend)
+            answer = await resolver.resolve(
+                name, dns.rdatatype.SOA, rdclass, tcp, backend=backend
+            )
+            assert answer.rrset is not None
             if answer.rrset.name == name:
                 return name
             # otherwise we were CNAMEd or DNAMEd and need to look higher
diff --git a/lib/dns/asyncresolver.pyi b/lib/dns/asyncresolver.pyi
deleted file mode 100644
index 92759d29..00000000
--- a/lib/dns/asyncresolver.pyi
+++ /dev/null
@@ -1,26 +0,0 @@
-from typing import Union, Optional, List, Any, Dict
-from . import exception, rdataclass, name, rdatatype, asyncbackend
-
-async def resolve(qname : str, rdtype : Union[int,str] = 0,
-                  rdclass : Union[int,str] = 0,
-                  tcp=False, source=None, raise_on_no_answer=True,
-                  source_port=0, lifetime : Optional[float]=None,
-                  search : Optional[bool]=None,
-                  backend : Optional[asyncbackend.Backend]=None):
-    ...
-async def resolve_address(self, ipaddr: str,
-                          *args: Any, **kwargs: Optional[Dict]):
-    ...
-
-class Resolver:
-    def __init__(self, filename : Optional[str] = '/etc/resolv.conf',
-                 configure : Optional[bool] = True):
-        self.nameservers : List[str]
-    async def resolve(self, qname : str, rdtype : Union[int,str] = rdatatype.A,
-                      rdclass : Union[int,str] = rdataclass.IN,
-                      tcp : bool = False, source : Optional[str] = None,
-                      raise_on_no_answer=True, source_port : int = 0,
-                      lifetime : Optional[float]=None,
-                      search : Optional[bool]=None,
-                      backend : Optional[asyncbackend.Backend]=None):
-        ...
diff --git a/lib/dns/dnssec.py b/lib/dns/dnssec.py
index dee4e618..5dc26223 100644
--- a/lib/dns/dnssec.py
+++ b/lib/dns/dnssec.py
@@ -17,12 +17,17 @@
 
 """Common DNSSEC-related functions and constants."""
 
+from typing import Any, cast, Dict, List, Optional, Set, Tuple, Union
+
 import hashlib
+import math
 import struct
 import time
 import base64
+from datetime import datetime
+
+from dns.dnssectypes import Algorithm, DSDigest, NSEC3Hash
 
-import dns.enum
 import dns.exception
 import dns.name
 import dns.node
@@ -30,41 +35,47 @@ import dns.rdataset
 import dns.rdata
 import dns.rdatatype
 import dns.rdataclass
+import dns.rrset
+from dns.rdtypes.ANY.CDNSKEY import CDNSKEY
+from dns.rdtypes.ANY.CDS import CDS
+from dns.rdtypes.ANY.DNSKEY import DNSKEY
+from dns.rdtypes.ANY.DS import DS
+from dns.rdtypes.ANY.RRSIG import RRSIG, sigtime_to_posixtime
+from dns.rdtypes.dnskeybase import Flag
 
 
 class UnsupportedAlgorithm(dns.exception.DNSException):
     """The DNSSEC algorithm is not supported."""
 
 
+class AlgorithmKeyMismatch(UnsupportedAlgorithm):
+    """The DNSSEC algorithm is not supported for the given key type."""
+
+
 class ValidationFailure(dns.exception.DNSException):
     """The DNSSEC signature is invalid."""
 
 
-class Algorithm(dns.enum.IntEnum):
-    RSAMD5 = 1
-    DH = 2
-    DSA = 3
-    ECC = 4
-    RSASHA1 = 5
-    DSANSEC3SHA1 = 6
-    RSASHA1NSEC3SHA1 = 7
-    RSASHA256 = 8
-    RSASHA512 = 10
-    ECCGOST = 12
-    ECDSAP256SHA256 = 13
-    ECDSAP384SHA384 = 14
-    ED25519 = 15
-    ED448 = 16
-    INDIRECT = 252
-    PRIVATEDNS = 253
-    PRIVATEOID = 254
-
-    @classmethod
-    def _maximum(cls):
-        return 255
+class DeniedByPolicy(dns.exception.DNSException):
+    """Denied by DNSSEC policy."""
 
 
-def algorithm_from_text(text):
+PublicKey = Union[
+    "rsa.RSAPublicKey",
+    "ec.EllipticCurvePublicKey",
+    "ed25519.Ed25519PublicKey",
+    "ed448.Ed448PublicKey",
+]
+
+PrivateKey = Union[
+    "rsa.RSAPrivateKey",
+    "ec.EllipticCurvePrivateKey",
+    "ed25519.Ed25519PrivateKey",
+    "ed448.Ed448PrivateKey",
+]
+
+
+def algorithm_from_text(text: str) -> Algorithm:
     """Convert text into a DNSSEC algorithm value.
 
     *text*, a ``str``, the text to convert to into an algorithm value.
@@ -75,10 +86,10 @@ def algorithm_from_text(text):
     return Algorithm.from_text(text)
 
 
-def algorithm_to_text(value):
+def algorithm_to_text(value: Union[Algorithm, int]) -> str:
     """Convert a DNSSEC algorithm value to text
 
-    *value*, an ``int`` a DNSSEC algorithm.
+    *value*, a ``dns.dnssec.Algorithm``.
 
     Returns a ``str``, the name of a DNSSEC algorithm.
     """
@@ -86,7 +97,21 @@ def algorithm_to_text(value):
     return Algorithm.to_text(value)
 
 
-def key_id(key):
+def to_timestamp(value: Union[datetime, str, float, int]) -> int:
+    """Convert various format to a timestamp"""
+    if isinstance(value, datetime):
+        return int(value.timestamp())
+    elif isinstance(value, str):
+        return sigtime_to_posixtime(value)
+    elif isinstance(value, float):
+        return int(value)
+    elif isinstance(value, int):
+        return value
+    else:
+        raise TypeError("Unsupported timestamp type")
+
+
+def key_id(key: Union[DNSKEY, CDNSKEY]) -> int:
     """Return the key id (a 16-bit number) for the specified key.
 
     *key*, a ``dns.rdtypes.ANY.DNSKEY.DNSKEY``
@@ -100,50 +125,116 @@ def key_id(key):
     else:
         total = 0
         for i in range(len(rdata) // 2):
-            total += (rdata[2 * i] << 8) + \
-                rdata[2 * i + 1]
+            total += (rdata[2 * i] << 8) + rdata[2 * i + 1]
         if len(rdata) % 2 != 0:
             total += rdata[len(rdata) - 1] << 8
-        total += ((total >> 16) & 0xffff)
-        return total & 0xffff
-
-class DSDigest(dns.enum.IntEnum):
-    """DNSSEC Delegation Signer Digest Algorithm"""
-
-    SHA1 = 1
-    SHA256 = 2
-    SHA384 = 4
-
-    @classmethod
-    def _maximum(cls):
-        return 255
+        total += (total >> 16) & 0xFFFF
+        return total & 0xFFFF
 
 
-def make_ds(name, key, algorithm, origin=None):
+class Policy:
+    def __init__(self):
+        pass
+
+    def ok_to_sign(self, _: DNSKEY) -> bool:  # pragma: no cover
+        return False
+
+    def ok_to_validate(self, _: DNSKEY) -> bool:  # pragma: no cover
+        return False
+
+    def ok_to_create_ds(self, _: DSDigest) -> bool:  # pragma: no cover
+        return False
+
+    def ok_to_validate_ds(self, _: DSDigest) -> bool:  # pragma: no cover
+        return False
+
+
+class SimpleDeny(Policy):
+    def __init__(self, deny_sign, deny_validate, deny_create_ds, deny_validate_ds):
+        super().__init__()
+        self._deny_sign = deny_sign
+        self._deny_validate = deny_validate
+        self._deny_create_ds = deny_create_ds
+        self._deny_validate_ds = deny_validate_ds
+
+    def ok_to_sign(self, key: DNSKEY) -> bool:
+        return key.algorithm not in self._deny_sign
+
+    def ok_to_validate(self, key: DNSKEY) -> bool:
+        return key.algorithm not in self._deny_validate
+
+    def ok_to_create_ds(self, algorithm: DSDigest) -> bool:
+        return algorithm not in self._deny_create_ds
+
+    def ok_to_validate_ds(self, algorithm: DSDigest) -> bool:
+        return algorithm not in self._deny_validate_ds
+
+
+rfc_8624_policy = SimpleDeny(
+    {Algorithm.RSAMD5, Algorithm.DSA, Algorithm.DSANSEC3SHA1, Algorithm.ECCGOST},
+    {Algorithm.RSAMD5, Algorithm.DSA, Algorithm.DSANSEC3SHA1},
+    {DSDigest.NULL, DSDigest.SHA1, DSDigest.GOST},
+    {DSDigest.NULL},
+)
+
+allow_all_policy = SimpleDeny(set(), set(), set(), set())
+
+
+default_policy = rfc_8624_policy
+
+
+def make_ds(
+    name: Union[dns.name.Name, str],
+    key: dns.rdata.Rdata,
+    algorithm: Union[DSDigest, str],
+    origin: Optional[dns.name.Name] = None,
+    policy: Optional[Policy] = None,
+    validating: bool = False,
+) -> DS:
     """Create a DS record for a DNSSEC key.
 
     *name*, a ``dns.name.Name`` or ``str``, the owner name of the DS record.
 
-    *key*, a ``dns.rdtypes.ANY.DNSKEY.DNSKEY``, the key the DS is about.
+    *key*, a ``dns.rdtypes.ANY.DNSKEY.DNSKEY`` or ``dns.rdtypes.ANY.DNSKEY.CDNSKEY``,
+    the key the DS is about.
 
     *algorithm*, a ``str`` or ``int`` specifying the hash algorithm.
     The currently supported hashes are "SHA1", "SHA256", and "SHA384". Case
     does not matter for these strings.
 
-    *origin*, a ``dns.name.Name`` or ``None``.  If `key` is a relative name,
+    *origin*, a ``dns.name.Name`` or ``None``.  If *key* is a relative name,
     then it will be made absolute using the specified origin.
 
+    *policy*, a ``dns.dnssec.Policy`` or ``None``.  If ``None``, the default policy,
+    ``dns.dnssec.default_policy`` is used; this policy defaults to that of RFC 8624.
+
+    *validating*, a ``bool``.  If ``True``, then policy is checked in
+    validating mode, i.e. "Is it ok to validate using this digest algorithm?".
+    Otherwise the policy is checked in creating mode, i.e. "Is it ok to create a DS with
+    this digest algorithm?".
+
     Raises ``UnsupportedAlgorithm`` if the algorithm is unknown.
 
+    Raises ``DeniedByPolicy`` if the algorithm is denied by policy.
+
     Returns a ``dns.rdtypes.ANY.DS.DS``
     """
 
+    if policy is None:
+        policy = default_policy
     try:
         if isinstance(algorithm, str):
             algorithm = DSDigest[algorithm.upper()]
     except Exception:
         raise UnsupportedAlgorithm('unsupported algorithm "%s"' % algorithm)
-
+    if validating:
+        check = policy.ok_to_validate_ds
+    else:
+        check = policy.ok_to_create_ds
+    if not check(algorithm):
+        raise DeniedByPolicy
+    if not isinstance(key, (DNSKEY, CDNSKEY)):
+        raise ValueError("key is not a DNSKEY/CDNSKEY")
     if algorithm == DSDigest.SHA1:
         dshash = hashlib.sha1()
     elif algorithm == DSDigest.SHA256:
@@ -155,17 +246,58 @@ def make_ds(name, key, algorithm, origin=None):
 
     if isinstance(name, str):
         name = dns.name.from_text(name, origin)
-    dshash.update(name.canonicalize().to_wire())
+    wire = name.canonicalize().to_wire()
+    assert wire is not None
+    dshash.update(wire)
     dshash.update(key.to_wire(origin=origin))
     digest = dshash.digest()
 
-    dsrdata = struct.pack("!HBB", key_id(key), key.algorithm, algorithm) + \
-        digest
-    return dns.rdata.from_wire(dns.rdataclass.IN, dns.rdatatype.DS, dsrdata, 0,
-                               len(dsrdata))
+    dsrdata = struct.pack("!HBB", key_id(key), key.algorithm, algorithm) + digest
+    ds = dns.rdata.from_wire(
+        dns.rdataclass.IN, dns.rdatatype.DS, dsrdata, 0, len(dsrdata)
+    )
+    return cast(DS, ds)
 
 
-def _find_candidate_keys(keys, rrsig):
+def make_cds(
+    name: Union[dns.name.Name, str],
+    key: dns.rdata.Rdata,
+    algorithm: Union[DSDigest, str],
+    origin: Optional[dns.name.Name] = None,
+) -> CDS:
+    """Create a CDS record for a DNSSEC key.
+
+    *name*, a ``dns.name.Name`` or ``str``, the owner name of the DS record.
+
+    *key*, a ``dns.rdtypes.ANY.DNSKEY.DNSKEY`` or ``dns.rdtypes.ANY.DNSKEY.CDNSKEY``,
+    the key the DS is about.
+
+    *algorithm*, a ``str`` or ``int`` specifying the hash algorithm.
+    The currently supported hashes are "SHA1", "SHA256", and "SHA384". Case
+    does not matter for these strings.
+
+    *origin*, a ``dns.name.Name`` or ``None``.  If *key* is a relative name,
+    then it will be made absolute using the specified origin.
+
+    Raises ``UnsupportedAlgorithm`` if the algorithm is unknown.
+
+    Returns a ``dns.rdtypes.ANY.DS.CDS``
+    """
+
+    ds = make_ds(name, key, algorithm, origin)
+    return CDS(
+        rdclass=ds.rdclass,
+        rdtype=dns.rdatatype.CDS,
+        key_tag=ds.key_tag,
+        algorithm=ds.algorithm,
+        digest_type=ds.digest_type,
+        digest=ds.digest,
+    )
+
+
+def _find_candidate_keys(
+    keys: Dict[dns.name.Name, Union[dns.rdataset.Rdataset, dns.node.Node]], rrsig: RRSIG
+) -> Optional[List[DNSKEY]]:
     value = keys.get(rrsig.signer)
     if isinstance(value, dns.node.Node):
         rdataset = value.get_rdataset(dns.rdataclass.IN, dns.rdatatype.DNSKEY)
@@ -173,54 +305,94 @@ def _find_candidate_keys(keys, rrsig):
         rdataset = value
     if rdataset is None:
         return None
-    return [rd for rd in rdataset if
-            rd.algorithm == rrsig.algorithm and key_id(rd) == rrsig.key_tag]
+    return [
+        cast(DNSKEY, rd)
+        for rd in rdataset
+        if rd.algorithm == rrsig.algorithm and key_id(rd) == rrsig.key_tag
+    ]
 
 
-def _is_rsa(algorithm):
-    return algorithm in (Algorithm.RSAMD5, Algorithm.RSASHA1,
-                         Algorithm.RSASHA1NSEC3SHA1, Algorithm.RSASHA256,
-                         Algorithm.RSASHA512)
+def _is_rsa(algorithm: int) -> bool:
+    return algorithm in (
+        Algorithm.RSAMD5,
+        Algorithm.RSASHA1,
+        Algorithm.RSASHA1NSEC3SHA1,
+        Algorithm.RSASHA256,
+        Algorithm.RSASHA512,
+    )
 
 
-def _is_dsa(algorithm):
+def _is_dsa(algorithm: int) -> bool:
     return algorithm in (Algorithm.DSA, Algorithm.DSANSEC3SHA1)
 
 
-def _is_ecdsa(algorithm):
+def _is_ecdsa(algorithm: int) -> bool:
     return algorithm in (Algorithm.ECDSAP256SHA256, Algorithm.ECDSAP384SHA384)
 
 
-def _is_eddsa(algorithm):
+def _is_eddsa(algorithm: int) -> bool:
     return algorithm in (Algorithm.ED25519, Algorithm.ED448)
 
 
-def _is_gost(algorithm):
+def _is_gost(algorithm: int) -> bool:
     return algorithm == Algorithm.ECCGOST
 
 
-def _is_md5(algorithm):
+def _is_md5(algorithm: int) -> bool:
     return algorithm == Algorithm.RSAMD5
 
 
-def _is_sha1(algorithm):
-    return algorithm in (Algorithm.DSA, Algorithm.RSASHA1,
-                         Algorithm.DSANSEC3SHA1, Algorithm.RSASHA1NSEC3SHA1)
+def _is_sha1(algorithm: int) -> bool:
+    return algorithm in (
+        Algorithm.DSA,
+        Algorithm.RSASHA1,
+        Algorithm.DSANSEC3SHA1,
+        Algorithm.RSASHA1NSEC3SHA1,
+    )
 
 
-def _is_sha256(algorithm):
+def _is_sha256(algorithm: int) -> bool:
     return algorithm in (Algorithm.RSASHA256, Algorithm.ECDSAP256SHA256)
 
 
-def _is_sha384(algorithm):
+def _is_sha384(algorithm: int) -> bool:
     return algorithm == Algorithm.ECDSAP384SHA384
 
 
-def _is_sha512(algorithm):
+def _is_sha512(algorithm: int) -> bool:
     return algorithm == Algorithm.RSASHA512
 
 
-def _make_hash(algorithm):
+def _ensure_algorithm_key_combination(algorithm: int, key: PublicKey) -> None:
+    """Ensure algorithm is valid for key type, throwing an exception on
+    mismatch."""
+    if isinstance(key, rsa.RSAPublicKey):
+        if _is_rsa(algorithm):
+            return
+        raise AlgorithmKeyMismatch('algorithm "%s" not valid for RSA key' % algorithm)
+    if isinstance(key, dsa.DSAPublicKey):
+        if _is_dsa(algorithm):
+            return
+        raise AlgorithmKeyMismatch('algorithm "%s" not valid for DSA key' % algorithm)
+    if isinstance(key, ec.EllipticCurvePublicKey):
+        if _is_ecdsa(algorithm):
+            return
+        raise AlgorithmKeyMismatch('algorithm "%s" not valid for ECDSA key' % algorithm)
+    if isinstance(key, ed25519.Ed25519PublicKey):
+        if algorithm == Algorithm.ED25519:
+            return
+        raise AlgorithmKeyMismatch(
+            'algorithm "%s" not valid for ED25519 key' % algorithm
+        )
+    if isinstance(key, ed448.Ed448PublicKey):
+        if algorithm == Algorithm.ED448:
+            return
+        raise AlgorithmKeyMismatch('algorithm "%s" not valid for ED448 key' % algorithm)
+
+    raise TypeError("unsupported key type")
+
+
+def _make_hash(algorithm: int) -> Any:
     if _is_md5(algorithm):
         return hashes.MD5()
     if _is_sha1(algorithm):
@@ -236,33 +408,45 @@ def _make_hash(algorithm):
     if algorithm == Algorithm.ED448:
         return hashes.SHAKE256(114)
 
-    raise ValidationFailure('unknown hash for algorithm %u' % algorithm)
+    raise ValidationFailure("unknown hash for algorithm %u" % algorithm)
 
 
-def _bytes_to_long(b):
-    return int.from_bytes(b, 'big')
+def _bytes_to_long(b: bytes) -> int:
+    return int.from_bytes(b, "big")
 
 
-def _validate_signature(sig, data, key, chosen_hash):
+def _get_rrname_rdataset(
+    rrset: Union[dns.rrset.RRset, Tuple[dns.name.Name, dns.rdataset.Rdataset]],
+) -> Tuple[dns.name.Name, dns.rdataset.Rdataset]:
+    if isinstance(rrset, tuple):
+        return rrset[0], rrset[1]
+    else:
+        return rrset.name, rrset
+
+
+def _validate_signature(sig: bytes, data: bytes, key: DNSKEY, chosen_hash: Any) -> None:
+    keyptr: bytes
     if _is_rsa(key.algorithm):
+        # we ignore because mypy is confused and thinks key.key is a str for unknown
+        # reasons.
         keyptr = key.key
-        (bytes_,) = struct.unpack('!B', keyptr[0:1])
+        (bytes_,) = struct.unpack("!B", keyptr[0:1])
         keyptr = keyptr[1:]
         if bytes_ == 0:
-            (bytes_,) = struct.unpack('!H', keyptr[0:2])
+            (bytes_,) = struct.unpack("!H", keyptr[0:2])
             keyptr = keyptr[2:]
         rsa_e = keyptr[0:bytes_]
         rsa_n = keyptr[bytes_:]
         try:
-            public_key = rsa.RSAPublicNumbers(
-                _bytes_to_long(rsa_e),
-                _bytes_to_long(rsa_n)).public_key(default_backend())
+            rsa_public_key = rsa.RSAPublicNumbers(
+                _bytes_to_long(rsa_e), _bytes_to_long(rsa_n)
+            ).public_key(default_backend())
         except ValueError:
-            raise ValidationFailure('invalid public key')
-        public_key.verify(sig, data, padding.PKCS1v15(), chosen_hash)
+            raise ValidationFailure("invalid public key")
+        rsa_public_key.verify(sig, data, padding.PKCS1v15(), chosen_hash)
     elif _is_dsa(key.algorithm):
         keyptr = key.key
-        (t,) = struct.unpack('!B', keyptr[0:1])
+        (t,) = struct.unpack("!B", keyptr[0:1])
         keyptr = keyptr[1:]
         octets = 64 + t * 8
         dsa_q = keyptr[0:20]
@@ -273,17 +457,18 @@ def _validate_signature(sig, data, key, chosen_hash):
         keyptr = keyptr[octets:]
         dsa_y = keyptr[0:octets]
         try:
-            public_key = dsa.DSAPublicNumbers(
+            dsa_public_key = dsa.DSAPublicNumbers(  # type: ignore
                 _bytes_to_long(dsa_y),
                 dsa.DSAParameterNumbers(
-                    _bytes_to_long(dsa_p),
-                    _bytes_to_long(dsa_q),
-                    _bytes_to_long(dsa_g))).public_key(default_backend())
+                    _bytes_to_long(dsa_p), _bytes_to_long(dsa_q), _bytes_to_long(dsa_g)
+                ),
+            ).public_key(default_backend())
         except ValueError:
-            raise ValidationFailure('invalid public key')
-        public_key.verify(sig, data, chosen_hash)
+            raise ValidationFailure("invalid public key")
+        dsa_public_key.verify(sig, data, chosen_hash)
     elif _is_ecdsa(key.algorithm):
         keyptr = key.key
+        curve: Any
         if key.algorithm == Algorithm.ECDSAP256SHA256:
             curve = ec.SECP256R1()
             octets = 32
@@ -291,35 +476,43 @@ def _validate_signature(sig, data, key, chosen_hash):
             curve = ec.SECP384R1()
             octets = 48
         ecdsa_x = keyptr[0:octets]
-        ecdsa_y = keyptr[octets:octets * 2]
+        ecdsa_y = keyptr[octets : octets * 2]
         try:
-            public_key = ec.EllipticCurvePublicNumbers(
-                curve=curve,
-                x=_bytes_to_long(ecdsa_x),
-                y=_bytes_to_long(ecdsa_y)).public_key(default_backend())
+            ecdsa_public_key = ec.EllipticCurvePublicNumbers(
+                curve=curve, x=_bytes_to_long(ecdsa_x), y=_bytes_to_long(ecdsa_y)
+            ).public_key(default_backend())
         except ValueError:
-            raise ValidationFailure('invalid public key')
-        public_key.verify(sig, data, ec.ECDSA(chosen_hash))
+            raise ValidationFailure("invalid public key")
+        ecdsa_public_key.verify(sig, data, ec.ECDSA(chosen_hash))
     elif _is_eddsa(key.algorithm):
         keyptr = key.key
+        loader: Any
         if key.algorithm == Algorithm.ED25519:
             loader = ed25519.Ed25519PublicKey
         else:
             loader = ed448.Ed448PublicKey
         try:
-            public_key = loader.from_public_bytes(keyptr)
+            eddsa_public_key = loader.from_public_bytes(keyptr)
         except ValueError:
-            raise ValidationFailure('invalid public key')
-        public_key.verify(sig, data)
+            raise ValidationFailure("invalid public key")
+        eddsa_public_key.verify(sig, data)
     elif _is_gost(key.algorithm):
         raise UnsupportedAlgorithm(
-            'algorithm "%s" not supported by dnspython' %
-            algorithm_to_text(key.algorithm))
+            'algorithm "%s" not supported by dnspython'
+            % algorithm_to_text(key.algorithm)
+        )
     else:
-        raise ValidationFailure('unknown algorithm %u' % key.algorithm)
+        raise ValidationFailure("unknown algorithm %u" % key.algorithm)
 
 
-def _validate_rrsig(rrset, rrsig, keys, origin=None, now=None):
+def _validate_rrsig(
+    rrset: Union[dns.rrset.RRset, Tuple[dns.name.Name, dns.rdataset.Rdataset]],
+    rrsig: RRSIG,
+    keys: Dict[dns.name.Name, Union[dns.node.Node, dns.rdataset.Rdataset]],
+    origin: Optional[dns.name.Name] = None,
+    now: Optional[float] = None,
+    policy: Optional[Policy] = None,
+) -> None:
     """Validate an RRset against a single signature rdata, throwing an
     exception if validation is not successful.
 
@@ -337,10 +530,13 @@ def _validate_rrsig(rrset, rrsig, keys, origin=None, now=None):
     *origin*, a ``dns.name.Name`` or ``None``, the origin to use for relative
     names.
 
-    *now*, an ``int`` or ``None``, the time, in seconds since the epoch, to
+    *now*, a ``float`` or ``None``, the time, in seconds since the epoch, to
     use as the current time when validating.  If ``None``, the actual current
     time is used.
 
+    *policy*, a ``dns.dnssec.Policy`` or ``None``.  If ``None``, the default policy,
+    ``dns.dnssec.default_policy`` is used; this policy defaults to that of RFC 8624.
+
     Raises ``ValidationFailure`` if the signature is expired, not yet valid,
     the public key is invalid, the algorithm is unknown, the verification
     fails, etc.
@@ -349,34 +545,24 @@ def _validate_rrsig(rrset, rrsig, keys, origin=None, now=None):
     dnspython but not implemented.
     """
 
-    if isinstance(origin, str):
-        origin = dns.name.from_text(origin, dns.name.root)
+    if policy is None:
+        policy = default_policy
 
     candidate_keys = _find_candidate_keys(keys, rrsig)
     if candidate_keys is None:
-        raise ValidationFailure('unknown key')
-
-    # For convenience, allow the rrset to be specified as a (name,
-    # rdataset) tuple as well as a proper rrset
-    if isinstance(rrset, tuple):
-        rrname = rrset[0]
-        rdataset = rrset[1]
-    else:
-        rrname = rrset.name
-        rdataset = rrset
+        raise ValidationFailure("unknown key")
 
     if now is None:
         now = time.time()
     if rrsig.expiration < now:
-        raise ValidationFailure('expired')
+        raise ValidationFailure("expired")
     if rrsig.inception > now:
-        raise ValidationFailure('not yet valid')
+        raise ValidationFailure("not yet valid")
 
     if _is_dsa(rrsig.algorithm):
         sig_r = rrsig.signature[1:21]
         sig_s = rrsig.signature[21:]
-        sig = utils.encode_dss_signature(_bytes_to_long(sig_r),
-                                         _bytes_to_long(sig_s))
+        sig = utils.encode_dss_signature(_bytes_to_long(sig_r), _bytes_to_long(sig_s))
     elif _is_ecdsa(rrsig.algorithm):
         if rrsig.algorithm == Algorithm.ECDSAP256SHA256:
             octets = 32
@@ -384,37 +570,16 @@ def _validate_rrsig(rrset, rrsig, keys, origin=None, now=None):
             octets = 48
         sig_r = rrsig.signature[0:octets]
         sig_s = rrsig.signature[octets:]
-        sig = utils.encode_dss_signature(_bytes_to_long(sig_r),
-                                         _bytes_to_long(sig_s))
+        sig = utils.encode_dss_signature(_bytes_to_long(sig_r), _bytes_to_long(sig_s))
     else:
         sig = rrsig.signature
 
-    data = b''
-    data += rrsig.to_wire(origin=origin)[:18]
-    data += rrsig.signer.to_digestable(origin)
-
-    # Derelativize the name before considering labels.
-    rrname = rrname.derelativize(origin)
-
-    if len(rrname) - 1 < rrsig.labels:
-        raise ValidationFailure('owner name longer than RRSIG labels')
-    elif rrsig.labels < len(rrname) - 1:
-        suffix = rrname.split(rrsig.labels + 1)[1]
-        rrname = dns.name.from_text('*', suffix)
-    rrnamebuf = rrname.to_digestable()
-    rrfixed = struct.pack('!HHI', rdataset.rdtype, rdataset.rdclass,
-                          rrsig.original_ttl)
-    rdatas = [rdata.to_digestable(origin) for rdata in rdataset]
-    for rdata in sorted(rdatas):
-        data += rrnamebuf
-        data += rrfixed
-        rrlen = struct.pack('!H', len(rdata))
-        data += rrlen
-        data += rdata
-
+    data = _make_rrsig_signature_data(rrset, rrsig, origin)
     chosen_hash = _make_hash(rrsig.algorithm)
 
     for candidate_key in candidate_keys:
+        if not policy.ok_to_validate(candidate_key):
+            continue
         try:
             _validate_signature(sig, data, candidate_key, chosen_hash)
             return
@@ -422,10 +587,17 @@ def _validate_rrsig(rrset, rrsig, keys, origin=None, now=None):
             # this happens on an individual validation failure
             continue
     # nothing verified -- raise failure:
-    raise ValidationFailure('verify failure')
+    raise ValidationFailure("verify failure")
 
 
-def _validate(rrset, rrsigset, keys, origin=None, now=None):
+def _validate(
+    rrset: Union[dns.rrset.RRset, Tuple[dns.name.Name, dns.rdataset.Rdataset]],
+    rrsigset: Union[dns.rrset.RRset, Tuple[dns.name.Name, dns.rdataset.Rdataset]],
+    keys: Dict[dns.name.Name, Union[dns.node.Node, dns.rdataset.Rdataset]],
+    origin: Optional[dns.name.Name] = None,
+    now: Optional[float] = None,
+    policy: Optional[Policy] = None,
+) -> None:
     """Validate an RRset against a signature RRset, throwing an exception
     if none of the signatures validate.
 
@@ -449,11 +621,17 @@ def _validate(rrset, rrsigset, keys, origin=None, now=None):
     use as the current time when validating.  If ``None``, the actual current
     time is used.
 
+    *policy*, a ``dns.dnssec.Policy`` or ``None``.  If ``None``, the default policy,
+    ``dns.dnssec.default_policy`` is used; this policy defaults to that of RFC 8624.
+
     Raises ``ValidationFailure`` if the signature is expired, not yet valid,
     the public key is invalid, the algorithm is unknown, the verification
     fails, etc.
     """
 
+    if policy is None:
+        policy = default_policy
+
     if isinstance(origin, str):
         origin = dns.name.from_text(origin, dns.name.root)
 
@@ -475,24 +653,367 @@ def _validate(rrset, rrsigset, keys, origin=None, now=None):
         raise ValidationFailure("owner names do not match")
 
     for rrsig in rrsigrdataset:
+        if not isinstance(rrsig, RRSIG):
+            raise ValidationFailure("expected an RRSIG")
         try:
-            _validate_rrsig(rrset, rrsig, keys, origin, now)
+            _validate_rrsig(rrset, rrsig, keys, origin, now, policy)
             return
         except (ValidationFailure, UnsupportedAlgorithm):
             pass
     raise ValidationFailure("no RRSIGs validated")
 
 
-class NSEC3Hash(dns.enum.IntEnum):
-    """NSEC3 hash algorithm"""
+def _sign(
+    rrset: Union[dns.rrset.RRset, Tuple[dns.name.Name, dns.rdataset.Rdataset]],
+    private_key: PrivateKey,
+    signer: dns.name.Name,
+    dnskey: DNSKEY,
+    inception: Optional[Union[datetime, str, int, float]] = None,
+    expiration: Optional[Union[datetime, str, int, float]] = None,
+    lifetime: Optional[int] = None,
+    verify: bool = False,
+    policy: Optional[Policy] = None,
+) -> RRSIG:
+    """Sign RRset using private key.
 
-    SHA1 = 1
+    *rrset*, the RRset to validate.  This can be a
+    ``dns.rrset.RRset`` or a (``dns.name.Name``, ``dns.rdataset.Rdataset``)
+    tuple.
 
-    @classmethod
-    def _maximum(cls):
-        return 255
+    *private_key*, the private key to use for signing, a
+    ``cryptography.hazmat.primitives.asymmetric`` private key class applicable
+    for DNSSEC.
 
-def nsec3_hash(domain, salt, iterations, algorithm):
+    *signer*, a ``dns.name.Name``, the Signer's name.
+
+    *dnskey*, a ``DNSKEY`` matching ``private_key``.
+
+    *inception*, a ``datetime``, ``str``, ``int``, ``float`` or ``None``, the
+    signature inception time.  If ``None``, the current time is used.  If a ``str``, the
+    format is "YYYYMMDDHHMMSS" or alternatively the number of seconds since the UNIX
+    epoch in text form; this is the same the RRSIG rdata's text form.
+    Values of type `int` or `float` are interpreted as seconds since the UNIX epoch.
+
+    *expiration*, a ``datetime``, ``str``, ``int``, ``float`` or ``None``, the signature
+    expiration time.  If ``None``, the expiration time will be the inception time plus
+    the value of the *lifetime* parameter.  See the description of *inception* above
+    for how the various parameter types are interpreted.
+
+    *lifetime*, an ``int`` or ``None``, the signature lifetime in seconds.  This
+    parameter is only meaningful if *expiration* is ``None``.
+
+    *verify*, a ``bool``.  If set to ``True``, the signer will verify signatures
+    after they are created; the default is ``False``.
+
+    *policy*, a ``dns.dnssec.Policy`` or ``None``.  If ``None``, the default policy,
+    ``dns.dnssec.default_policy`` is used; this policy defaults to that of RFC 8624.
+
+    Raises ``DeniedByPolicy`` if the signature is denied by policy.
+    """
+
+    if policy is None:
+        policy = default_policy
+    if not policy.ok_to_sign(dnskey):
+        raise DeniedByPolicy
+
+    if isinstance(rrset, tuple):
+        rdclass = rrset[1].rdclass
+        rdtype = rrset[1].rdtype
+        rrname = rrset[0]
+        original_ttl = rrset[1].ttl
+    else:
+        rdclass = rrset.rdclass
+        rdtype = rrset.rdtype
+        rrname = rrset.name
+        original_ttl = rrset.ttl
+
+    if inception is not None:
+        rrsig_inception = to_timestamp(inception)
+    else:
+        rrsig_inception = int(time.time())
+
+    if expiration is not None:
+        rrsig_expiration = to_timestamp(expiration)
+    elif lifetime is not None:
+        rrsig_expiration = int(time.time()) + lifetime
+    else:
+        raise ValueError("expiration or lifetime must be specified")
+
+    rrsig_template = RRSIG(
+        rdclass=rdclass,
+        rdtype=dns.rdatatype.RRSIG,
+        type_covered=rdtype,
+        algorithm=dnskey.algorithm,
+        labels=len(rrname) - 1,
+        original_ttl=original_ttl,
+        expiration=rrsig_expiration,
+        inception=rrsig_inception,
+        key_tag=key_id(dnskey),
+        signer=signer,
+        signature=b"",
+    )
+
+    data = dns.dnssec._make_rrsig_signature_data(rrset, rrsig_template)
+    chosen_hash = _make_hash(rrsig_template.algorithm)
+    signature = None
+
+    if isinstance(private_key, rsa.RSAPrivateKey):
+        if not _is_rsa(dnskey.algorithm):
+            raise ValueError("Invalid DNSKEY algorithm for RSA key")
+        signature = private_key.sign(data, padding.PKCS1v15(), chosen_hash)
+        if verify:
+            private_key.public_key().verify(
+                signature, data, padding.PKCS1v15(), chosen_hash
+            )
+    elif isinstance(private_key, dsa.DSAPrivateKey):
+        if not _is_dsa(dnskey.algorithm):
+            raise ValueError("Invalid DNSKEY algorithm for DSA key")
+        public_dsa_key = private_key.public_key()
+        if public_dsa_key.key_size > 1024:
+            raise ValueError("DSA key size overflow")
+        der_signature = private_key.sign(data, chosen_hash)
+        if verify:
+            public_dsa_key.verify(der_signature, data, chosen_hash)
+        dsa_r, dsa_s = utils.decode_dss_signature(der_signature)
+        dsa_t = (public_dsa_key.key_size // 8 - 64) // 8
+        octets = 20
+        signature = (
+            struct.pack("!B", dsa_t)
+            + int.to_bytes(dsa_r, length=octets, byteorder="big")
+            + int.to_bytes(dsa_s, length=octets, byteorder="big")
+        )
+    elif isinstance(private_key, ec.EllipticCurvePrivateKey):
+        if not _is_ecdsa(dnskey.algorithm):
+            raise ValueError("Invalid DNSKEY algorithm for EC key")
+        der_signature = private_key.sign(data, ec.ECDSA(chosen_hash))
+        if verify:
+            private_key.public_key().verify(der_signature, data, ec.ECDSA(chosen_hash))
+        if dnskey.algorithm == Algorithm.ECDSAP256SHA256:
+            octets = 32
+        else:
+            octets = 48
+        dsa_r, dsa_s = utils.decode_dss_signature(der_signature)
+        signature = int.to_bytes(dsa_r, length=octets, byteorder="big") + int.to_bytes(
+            dsa_s, length=octets, byteorder="big"
+        )
+    elif isinstance(private_key, ed25519.Ed25519PrivateKey):
+        if dnskey.algorithm != Algorithm.ED25519:
+            raise ValueError("Invalid DNSKEY algorithm for ED25519 key")
+        signature = private_key.sign(data)
+        if verify:
+            private_key.public_key().verify(signature, data)
+    elif isinstance(private_key, ed448.Ed448PrivateKey):
+        if dnskey.algorithm != Algorithm.ED448:
+            raise ValueError("Invalid DNSKEY algorithm for ED448 key")
+        signature = private_key.sign(data)
+        if verify:
+            private_key.public_key().verify(signature, data)
+    else:
+        raise TypeError("Unsupported key algorithm")
+
+    return cast(RRSIG, rrsig_template.replace(signature=signature))
+
+
+def _make_rrsig_signature_data(
+    rrset: Union[dns.rrset.RRset, Tuple[dns.name.Name, dns.rdataset.Rdataset]],
+    rrsig: RRSIG,
+    origin: Optional[dns.name.Name] = None,
+) -> bytes:
+    """Create signature rdata.
+
+    *rrset*, the RRset to sign/validate.  This can be a
+    ``dns.rrset.RRset`` or a (``dns.name.Name``, ``dns.rdataset.Rdataset``)
+    tuple.
+
+    *rrsig*, a ``dns.rdata.Rdata``, the signature to validate, or the
+    signature template used when signing.
+
+    *origin*, a ``dns.name.Name`` or ``None``, the origin to use for relative
+    names.
+
+    Raises ``UnsupportedAlgorithm`` if the algorithm is recognized by
+    dnspython but not implemented.
+    """
+
+    if isinstance(origin, str):
+        origin = dns.name.from_text(origin, dns.name.root)
+
+    signer = rrsig.signer
+    if not signer.is_absolute():
+        if origin is None:
+            raise ValidationFailure("relative RR name without an origin specified")
+        signer = signer.derelativize(origin)
+
+    # For convenience, allow the rrset to be specified as a (name,
+    # rdataset) tuple as well as a proper rrset
+    rrname, rdataset = _get_rrname_rdataset(rrset)
+
+    data = b""
+    data += rrsig.to_wire(origin=signer)[:18]
+    data += rrsig.signer.to_digestable(signer)
+
+    # Derelativize the name before considering labels.
+    if not rrname.is_absolute():
+        if origin is None:
+            raise ValidationFailure("relative RR name without an origin specified")
+        rrname = rrname.derelativize(origin)
+
+    if len(rrname) - 1 < rrsig.labels:
+        raise ValidationFailure("owner name longer than RRSIG labels")
+    elif rrsig.labels < len(rrname) - 1:
+        suffix = rrname.split(rrsig.labels + 1)[1]
+        rrname = dns.name.from_text("*", suffix)
+    rrnamebuf = rrname.to_digestable()
+    rrfixed = struct.pack("!HHI", rdataset.rdtype, rdataset.rdclass, rrsig.original_ttl)
+    rdatas = [rdata.to_digestable(origin) for rdata in rdataset]
+    for rdata in sorted(rdatas):
+        data += rrnamebuf
+        data += rrfixed
+        rrlen = struct.pack("!H", len(rdata))
+        data += rrlen
+        data += rdata
+
+    return data
+
+
+def _make_dnskey(
+    public_key: PublicKey,
+    algorithm: Union[int, str],
+    flags: int = Flag.ZONE,
+    protocol: int = 3,
+) -> DNSKEY:
+    """Convert a public key to DNSKEY Rdata
+
+    *public_key*, the public key to convert, a
+    ``cryptography.hazmat.primitives.asymmetric`` public key class applicable
+    for DNSSEC.
+
+    *algorithm*, a ``str`` or ``int`` specifying the DNSKEY algorithm.
+
+    *flags*: DNSKEY flags field as an integer.
+
+    *protocol*: DNSKEY protocol field as an integer.
+
+    Raises ``ValueError`` if the specified key algorithm parameters are not
+    unsupported, ``TypeError`` if the key type is unsupported,
+    `UnsupportedAlgorithm` if the algorithm is unknown and
+    `AlgorithmKeyMismatch` if the algorithm does not match the key type.
+
+    Return DNSKEY ``Rdata``.
+    """
+
+    def encode_rsa_public_key(public_key: "rsa.RSAPublicKey") -> bytes:
+        """Encode a public key per RFC 3110, section 2."""
+        pn = public_key.public_numbers()
+        _exp_len = math.ceil(int.bit_length(pn.e) / 8)
+        exp = int.to_bytes(pn.e, length=_exp_len, byteorder="big")
+        if _exp_len > 255:
+            exp_header = b"\0" + struct.pack("!H", _exp_len)
+        else:
+            exp_header = struct.pack("!B", _exp_len)
+        if pn.n.bit_length() < 512 or pn.n.bit_length() > 4096:
+            raise ValueError("unsupported RSA key length")
+        return exp_header + exp + pn.n.to_bytes((pn.n.bit_length() + 7) // 8, "big")
+
+    def encode_dsa_public_key(public_key: "dsa.DSAPublicKey") -> bytes:
+        """Encode a public key per RFC 2536, section 2."""
+        pn = public_key.public_numbers()
+        dsa_t = (public_key.key_size // 8 - 64) // 8
+        if dsa_t > 8:
+            raise ValueError("unsupported DSA key size")
+        octets = 64 + dsa_t * 8
+        res = struct.pack("!B", dsa_t)
+        res += pn.parameter_numbers.q.to_bytes(20, "big")
+        res += pn.parameter_numbers.p.to_bytes(octets, "big")
+        res += pn.parameter_numbers.g.to_bytes(octets, "big")
+        res += pn.y.to_bytes(octets, "big")
+        return res
+
+    def encode_ecdsa_public_key(public_key: "ec.EllipticCurvePublicKey") -> bytes:
+        """Encode a public key per RFC 6605, section 4."""
+        pn = public_key.public_numbers()
+        if isinstance(public_key.curve, ec.SECP256R1):
+            return pn.x.to_bytes(32, "big") + pn.y.to_bytes(32, "big")
+        elif isinstance(public_key.curve, ec.SECP384R1):
+            return pn.x.to_bytes(48, "big") + pn.y.to_bytes(48, "big")
+        else:
+            raise ValueError("unsupported ECDSA curve")
+
+    the_algorithm = Algorithm.make(algorithm)
+
+    _ensure_algorithm_key_combination(the_algorithm, public_key)
+
+    if isinstance(public_key, rsa.RSAPublicKey):
+        key_bytes = encode_rsa_public_key(public_key)
+    elif isinstance(public_key, dsa.DSAPublicKey):
+        key_bytes = encode_dsa_public_key(public_key)
+    elif isinstance(public_key, ec.EllipticCurvePublicKey):
+        key_bytes = encode_ecdsa_public_key(public_key)
+    elif isinstance(public_key, ed25519.Ed25519PublicKey):
+        key_bytes = public_key.public_bytes(
+            encoding=serialization.Encoding.Raw, format=serialization.PublicFormat.Raw
+        )
+    elif isinstance(public_key, ed448.Ed448PublicKey):
+        key_bytes = public_key.public_bytes(
+            encoding=serialization.Encoding.Raw, format=serialization.PublicFormat.Raw
+        )
+    else:
+        raise TypeError("unsupported key algorithm")
+
+    return DNSKEY(
+        rdclass=dns.rdataclass.IN,
+        rdtype=dns.rdatatype.DNSKEY,
+        flags=flags,
+        protocol=protocol,
+        algorithm=the_algorithm,
+        key=key_bytes,
+    )
+
+
+def _make_cdnskey(
+    public_key: PublicKey,
+    algorithm: Union[int, str],
+    flags: int = Flag.ZONE,
+    protocol: int = 3,
+) -> CDNSKEY:
+    """Convert a public key to CDNSKEY Rdata
+
+    *public_key*, the public key to convert, a
+    ``cryptography.hazmat.primitives.asymmetric`` public key class applicable
+    for DNSSEC.
+
+    *algorithm*, a ``str`` or ``int`` specifying the DNSKEY algorithm.
+
+    *flags*: DNSKEY flags field as an integer.
+
+    *protocol*: DNSKEY protocol field as an integer.
+
+    Raises ``ValueError`` if the specified key algorithm parameters are not
+    unsupported, ``TypeError`` if the key type is unsupported,
+    `UnsupportedAlgorithm` if the algorithm is unknown and
+    `AlgorithmKeyMismatch` if the algorithm does not match the key type.
+
+    Return CDNSKEY ``Rdata``.
+    """
+
+    dnskey = _make_dnskey(public_key, algorithm, flags, protocol)
+
+    return CDNSKEY(
+        rdclass=dnskey.rdclass,
+        rdtype=dns.rdatatype.CDNSKEY,
+        flags=dnskey.flags,
+        protocol=dnskey.protocol,
+        algorithm=dnskey.algorithm,
+        key=dnskey.key,
+    )
+
+
+def nsec3_hash(
+    domain: Union[dns.name.Name, str],
+    salt: Optional[Union[str, bytes]],
+    iterations: int,
+    algorithm: Union[int, str],
+) -> str:
     """
     Calculate the NSEC3 hash, according to
     https://tools.ietf.org/html/rfc5155#section-5
@@ -523,18 +1044,20 @@ def nsec3_hash(domain, salt, iterations, algorithm):
     if algorithm != NSEC3Hash.SHA1:
         raise ValueError("Wrong hash algorithm (only SHA1 is supported)")
 
-    salt_encoded = salt
     if salt is None:
-        salt_encoded = b''
+        salt_encoded = b""
     elif isinstance(salt, str):
         if len(salt) % 2 == 0:
             salt_encoded = bytes.fromhex(salt)
         else:
             raise ValueError("Invalid salt length")
+    else:
+        salt_encoded = salt
 
     if not isinstance(domain, dns.name.Name):
         domain = dns.name.from_text(domain)
     domain_encoded = domain.canonicalize().to_wire()
+    assert domain_encoded is not None
 
     digest = hashlib.sha1(domain_encoded + salt_encoded).digest()
     for _ in range(iterations):
@@ -546,15 +1069,163 @@ def nsec3_hash(domain, salt, iterations, algorithm):
     return output
 
 
+def make_ds_rdataset(
+    rrset: Union[dns.rrset.RRset, Tuple[dns.name.Name, dns.rdataset.Rdataset]],
+    algorithms: Set[Union[DSDigest, str]],
+    origin: Optional[dns.name.Name] = None,
+) -> dns.rdataset.Rdataset:
+    """Create a DS record from DNSKEY/CDNSKEY/CDS.
+
+    *rrset*, the RRset to create DS Rdataset for.  This can be a
+    ``dns.rrset.RRset`` or a (``dns.name.Name``, ``dns.rdataset.Rdataset``)
+    tuple.
+
+    *algorithms*, a set of ``str`` or ``int`` specifying the hash algorithms.
+    The currently supported hashes are "SHA1", "SHA256", and "SHA384". Case
+    does not matter for these strings. If the RRset is a CDS, only digest
+    algorithms matching algorithms are accepted.
+
+    *origin*, a ``dns.name.Name`` or ``None``.  If `key` is a relative name,
+    then it will be made absolute using the specified origin.
+
+    Raises ``UnsupportedAlgorithm`` if any of the algorithms are unknown and
+    ``ValueError`` if the given RRset is not usable.
+
+    Returns a ``dns.rdataset.Rdataset``
+    """
+
+    rrname, rdataset = _get_rrname_rdataset(rrset)
+
+    if rdataset.rdtype not in (
+        dns.rdatatype.DNSKEY,
+        dns.rdatatype.CDNSKEY,
+        dns.rdatatype.CDS,
+    ):
+        raise ValueError("rrset not a DNSKEY/CDNSKEY/CDS")
+
+    _algorithms = set()
+    for algorithm in algorithms:
+        try:
+            if isinstance(algorithm, str):
+                algorithm = DSDigest[algorithm.upper()]
+        except Exception:
+            raise UnsupportedAlgorithm('unsupported algorithm "%s"' % algorithm)
+        _algorithms.add(algorithm)
+
+    if rdataset.rdtype == dns.rdatatype.CDS:
+        res = []
+        for rdata in cds_rdataset_to_ds_rdataset(rdataset):
+            if rdata.digest_type in _algorithms:
+                res.append(rdata)
+        if len(res) == 0:
+            raise ValueError("no acceptable CDS rdata found")
+        return dns.rdataset.from_rdata_list(rdataset.ttl, res)
+
+    res = []
+    for algorithm in _algorithms:
+        res.extend(dnskey_rdataset_to_cds_rdataset(rrname, rdataset, algorithm, origin))
+    return dns.rdataset.from_rdata_list(rdataset.ttl, res)
+
+
+def cds_rdataset_to_ds_rdataset(
+    rdataset: dns.rdataset.Rdataset,
+) -> dns.rdataset.Rdataset:
+    """Create a CDS record from DS.
+
+    *rdataset*, a ``dns.rdataset.Rdataset``, to create DS Rdataset for.
+
+    Raises ``ValueError`` if the rdataset is not CDS.
+
+    Returns a ``dns.rdataset.Rdataset``
+    """
+
+    if rdataset.rdtype != dns.rdatatype.CDS:
+        raise ValueError("rdataset not a CDS")
+    res = []
+    for rdata in rdataset:
+        res.append(
+            CDS(
+                rdclass=rdata.rdclass,
+                rdtype=dns.rdatatype.DS,
+                key_tag=rdata.key_tag,
+                algorithm=rdata.algorithm,
+                digest_type=rdata.digest_type,
+                digest=rdata.digest,
+            )
+        )
+    return dns.rdataset.from_rdata_list(rdataset.ttl, res)
+
+
+def dnskey_rdataset_to_cds_rdataset(
+    name: Union[dns.name.Name, str],
+    rdataset: dns.rdataset.Rdataset,
+    algorithm: Union[DSDigest, str],
+    origin: Optional[dns.name.Name] = None,
+) -> dns.rdataset.Rdataset:
+    """Create a CDS record from DNSKEY/CDNSKEY.
+
+    *name*, a ``dns.name.Name`` or ``str``, the owner name of the CDS record.
+
+    *rdataset*, a ``dns.rdataset.Rdataset``, to create DS Rdataset for.
+
+    *algorithm*, a ``str`` or ``int`` specifying the hash algorithm.
+    The currently supported hashes are "SHA1", "SHA256", and "SHA384". Case
+    does not matter for these strings.
+
+    *origin*, a ``dns.name.Name`` or ``None``.  If `key` is a relative name,
+    then it will be made absolute using the specified origin.
+
+    Raises ``UnsupportedAlgorithm`` if the algorithm is unknown or
+    ``ValueError`` if the rdataset is not DNSKEY/CDNSKEY.
+
+    Returns a ``dns.rdataset.Rdataset``
+    """
+
+    if rdataset.rdtype not in (dns.rdatatype.DNSKEY, dns.rdatatype.CDNSKEY):
+        raise ValueError("rdataset not a DNSKEY/CDNSKEY")
+    res = []
+    for rdata in rdataset:
+        res.append(make_cds(name, rdata, algorithm, origin))
+    return dns.rdataset.from_rdata_list(rdataset.ttl, res)
+
+
+def dnskey_rdataset_to_cdnskey_rdataset(
+    rdataset: dns.rdataset.Rdataset,
+) -> dns.rdataset.Rdataset:
+    """Create a CDNSKEY record from DNSKEY.
+
+    *rdataset*, a ``dns.rdataset.Rdataset``, to create CDNSKEY Rdataset for.
+
+    Returns a ``dns.rdataset.Rdataset``
+    """
+
+    if rdataset.rdtype != dns.rdatatype.DNSKEY:
+        raise ValueError("rdataset not a DNSKEY")
+    res = []
+    for rdata in rdataset:
+        res.append(
+            CDNSKEY(
+                rdclass=rdataset.rdclass,
+                rdtype=rdataset.rdtype,
+                flags=rdata.flags,
+                protocol=rdata.protocol,
+                algorithm=rdata.algorithm,
+                key=rdata.key,
+            )
+        )
+    return dns.rdataset.from_rdata_list(rdataset.ttl, res)
+
+
 def _need_pyca(*args, **kwargs):
-    raise ImportError("DNSSEC validation requires " +
-                      "python cryptography")  # pragma: no cover
+    raise ImportError(
+        "DNSSEC validation requires " + "python cryptography"
+    )  # pragma: no cover
 
 
 try:
     from cryptography.exceptions import InvalidSignature
     from cryptography.hazmat.backends import default_backend
-    from cryptography.hazmat.primitives import hashes
+    from cryptography.hazmat.primitives import hashes, serialization
     from cryptography.hazmat.primitives.asymmetric import padding
     from cryptography.hazmat.primitives.asymmetric import utils
     from cryptography.hazmat.primitives.asymmetric import dsa
@@ -565,10 +1236,16 @@ try:
 except ImportError:  # pragma: no cover
     validate = _need_pyca
     validate_rrsig = _need_pyca
+    sign = _need_pyca
+    make_dnskey = _need_pyca
+    make_cdnskey = _need_pyca
     _have_pyca = False
 else:
-    validate = _validate                # type: ignore
-    validate_rrsig = _validate_rrsig    # type: ignore
+    validate = _validate  # type: ignore
+    validate_rrsig = _validate_rrsig  # type: ignore
+    sign = _sign
+    make_dnskey = _make_dnskey
+    make_cdnskey = _make_cdnskey
     _have_pyca = True
 
 ### BEGIN generated Algorithm constants
diff --git a/lib/dns/dnssec.pyi b/lib/dns/dnssec.pyi
deleted file mode 100644
index e126f9b8..00000000
--- a/lib/dns/dnssec.pyi
+++ /dev/null
@@ -1,21 +0,0 @@
-from typing import Union, Dict, Tuple, Optional
-from . import rdataset, rrset, exception, name, rdtypes, rdata, node
-import dns.rdtypes.ANY.DS as DS
-import dns.rdtypes.ANY.DNSKEY as DNSKEY
-
-_have_pyca : bool
-
-def validate_rrsig(rrset : Union[Tuple[name.Name, rdataset.Rdataset], rrset.RRset], rrsig : rdata.Rdata, keys : Dict[name.Name, Union[node.Node, rdataset.Rdataset]], origin : Optional[name.Name] = None, now : Optional[int] = None) -> None:
-    ...
-
-def validate(rrset: Union[Tuple[name.Name, rdataset.Rdataset], rrset.RRset], rrsigset : Union[Tuple[name.Name, rdataset.Rdataset], rrset.RRset], keys : Dict[name.Name, Union[node.Node, rdataset.Rdataset]], origin=None, now=None) -> None:
-    ...
-
-class ValidationFailure(exception.DNSException):
-    ...
-
-def make_ds(name : name.Name, key : DNSKEY.DNSKEY, algorithm : str, origin : Optional[name.Name] = None) -> DS.DS:
-    ...
-
-def nsec3_hash(domain: str, salt: Optional[Union[str, bytes]], iterations: int, algo: int) -> str:
-    ...
diff --git a/lib/dns/dnssectypes.py b/lib/dns/dnssectypes.py
new file mode 100644
index 00000000..02131e0a
--- /dev/null
+++ b/lib/dns/dnssectypes.py
@@ -0,0 +1,71 @@
+# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license
+
+# Copyright (C) 2003-2017 Nominum, Inc.
+#
+# Permission to use, copy, modify, and distribute this software and its
+# documentation for any purpose with or without fee is hereby granted,
+# provided that the above copyright notice and this permission notice
+# appear in all copies.
+#
+# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES
+# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR
+# ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+# WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+# ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
+# OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+"""Common DNSSEC-related types."""
+
+# This is a separate file to avoid import circularity between dns.dnssec and
+# the implementations of the DS and DNSKEY types.
+
+import dns.enum
+
+
+class Algorithm(dns.enum.IntEnum):
+    RSAMD5 = 1
+    DH = 2
+    DSA = 3
+    ECC = 4
+    RSASHA1 = 5
+    DSANSEC3SHA1 = 6
+    RSASHA1NSEC3SHA1 = 7
+    RSASHA256 = 8
+    RSASHA512 = 10
+    ECCGOST = 12
+    ECDSAP256SHA256 = 13
+    ECDSAP384SHA384 = 14
+    ED25519 = 15
+    ED448 = 16
+    INDIRECT = 252
+    PRIVATEDNS = 253
+    PRIVATEOID = 254
+
+    @classmethod
+    def _maximum(cls):
+        return 255
+
+
+class DSDigest(dns.enum.IntEnum):
+    """DNSSEC Delegation Signer Digest Algorithm"""
+
+    NULL = 0
+    SHA1 = 1
+    SHA256 = 2
+    GOST = 3
+    SHA384 = 4
+
+    @classmethod
+    def _maximum(cls):
+        return 255
+
+
+class NSEC3Hash(dns.enum.IntEnum):
+    """NSEC3 hash algorithm"""
+
+    SHA1 = 1
+
+    @classmethod
+    def _maximum(cls):
+        return 255
diff --git a/lib/dns/e164.py b/lib/dns/e164.py
index 83731b2c..453736d4 100644
--- a/lib/dns/e164.py
+++ b/lib/dns/e164.py
@@ -17,15 +17,19 @@
 
 """DNS E.164 helpers."""
 
+from typing import Iterable, Optional, Union
+
 import dns.exception
 import dns.name
 import dns.resolver
 
 #: The public E.164 domain.
-public_enum_domain = dns.name.from_text('e164.arpa.')
+public_enum_domain = dns.name.from_text("e164.arpa.")
 
 
-def from_e164(text, origin=public_enum_domain):
+def from_e164(
+    text: str, origin: Optional[dns.name.Name] = public_enum_domain
+) -> dns.name.Name:
     """Convert an E.164 number in textual form into a Name object whose
     value is the ENUM domain name for that number.
 
@@ -42,10 +46,14 @@ def from_e164(text, origin=public_enum_domain):
 
     parts = [d for d in text if d.isdigit()]
     parts.reverse()
-    return dns.name.from_text('.'.join(parts), origin=origin)
+    return dns.name.from_text(".".join(parts), origin=origin)
 
 
-def to_e164(name, origin=public_enum_domain, want_plus_prefix=True):
+def to_e164(
+    name: dns.name.Name,
+    origin: Optional[dns.name.Name] = public_enum_domain,
+    want_plus_prefix: bool = True,
+) -> str:
     """Convert an ENUM domain name into an E.164 number.
 
     Note that dnspython does not have any information about preferred
@@ -69,15 +77,19 @@ def to_e164(name, origin=public_enum_domain, want_plus_prefix=True):
         name = name.relativize(origin)
     dlabels = [d for d in name.labels if d.isdigit() and len(d) == 1]
     if len(dlabels) != len(name.labels):
-        raise dns.exception.SyntaxError('non-digit labels in ENUM domain name')
+        raise dns.exception.SyntaxError("non-digit labels in ENUM domain name")
     dlabels.reverse()
-    text = b''.join(dlabels)
+    text = b"".join(dlabels)
     if want_plus_prefix:
-        text = b'+' + text
+        text = b"+" + text
     return text.decode()
 
 
-def query(number, domains, resolver=None):
+def query(
+    number: str,
+    domains: Iterable[Union[dns.name.Name, str]],
+    resolver: Optional[dns.resolver.Resolver] = None,
+) -> dns.resolver.Answer:
     """Look for NAPTR RRs for the specified number in the specified domains.
 
     e.g. lookup('16505551212', ['e164.dnspython.org.', 'e164.arpa.'])
@@ -98,7 +110,7 @@ def query(number, domains, resolver=None):
             domain = dns.name.from_text(domain)
         qname = dns.e164.from_e164(number, domain)
         try:
-            return resolver.resolve(qname, 'NAPTR')
+            return resolver.resolve(qname, "NAPTR")
         except dns.resolver.NXDOMAIN as e:
             e_nx += e
     raise e_nx
diff --git a/lib/dns/e164.pyi b/lib/dns/e164.pyi
deleted file mode 100644
index 37a99fed..00000000
--- a/lib/dns/e164.pyi
+++ /dev/null
@@ -1,10 +0,0 @@
-from typing import Optional, Iterable
-from . import name, resolver
-def from_e164(text : str, origin=name.Name(".")) -> name.Name:
-    ...
-
-def to_e164(name : name.Name, origin : Optional[name.Name] = None, want_plus_prefix=True) -> str:
-    ...
-
-def query(number : str, domains : Iterable[str], resolver : Optional[resolver.Resolver] = None) -> resolver.Answer:
-    ...
diff --git a/lib/dns/edns.py b/lib/dns/edns.py
index 9d7e909d..64436cde 100644
--- a/lib/dns/edns.py
+++ b/lib/dns/edns.py
@@ -17,6 +17,8 @@
 
 """EDNS Options"""
 
+from typing import Any, Dict, Optional, Union
+
 import math
 import socket
 import struct
@@ -24,6 +26,7 @@ import struct
 import dns.enum
 import dns.inet
 import dns.rdata
+import dns.wire
 
 
 class OptionType(dns.enum.IntEnum):
@@ -59,14 +62,14 @@ class Option:
 
     """Base class for all EDNS option types."""
 
-    def __init__(self, otype):
+    def __init__(self, otype: Union[OptionType, str]):
         """Initialize an option.
 
-        *otype*, an ``int``, is the option type.
+        *otype*, a ``dns.edns.OptionType``, is the option type.
         """
         self.otype = OptionType.make(otype)
 
-    def to_wire(self, file=None):
+    def to_wire(self, file: Optional[Any] = None) -> Optional[bytes]:
         """Convert an option to wire format.
 
         Returns a ``bytes`` or ``None``.
@@ -75,10 +78,10 @@ class Option:
         raise NotImplementedError  # pragma: no cover
 
     @classmethod
-    def from_wire_parser(cls, otype, parser):
+    def from_wire_parser(cls, otype: OptionType, parser: "dns.wire.Parser") -> "Option":
         """Build an EDNS option object from wire format.
 
-        *otype*, an ``int``, is the option type.
+        *otype*, a ``dns.edns.OptionType``, is the option type.
 
         *parser*, a ``dns.wire.Parser``, the parser, which should be
         restructed to the option length.
@@ -115,26 +118,22 @@ class Option:
         return self._cmp(other) != 0
 
     def __lt__(self, other):
-        if not isinstance(other, Option) or \
-                self.otype != other.otype:
+        if not isinstance(other, Option) or self.otype != other.otype:
             return NotImplemented
         return self._cmp(other) < 0
 
     def __le__(self, other):
-        if not isinstance(other, Option) or \
-                self.otype != other.otype:
+        if not isinstance(other, Option) or self.otype != other.otype:
             return NotImplemented
         return self._cmp(other) <= 0
 
     def __ge__(self, other):
-        if not isinstance(other, Option) or \
-                self.otype != other.otype:
+        if not isinstance(other, Option) or self.otype != other.otype:
             return NotImplemented
         return self._cmp(other) >= 0
 
     def __gt__(self, other):
-        if not isinstance(other, Option) or \
-                self.otype != other.otype:
+        if not isinstance(other, Option) or self.otype != other.otype:
             return NotImplemented
         return self._cmp(other) > 0
 
@@ -142,7 +141,7 @@ class Option:
         return self.to_text()
 
 
-class GenericOption(Option):
+class GenericOption(Option):  # lgtm[py/missing-equals]
 
     """Generic Option Class
 
@@ -150,28 +149,31 @@ class GenericOption(Option):
     implementation.
     """
 
-    def __init__(self, otype, data):
+    def __init__(self, otype: Union[OptionType, str], data: Union[bytes, str]):
         super().__init__(otype)
         self.data = dns.rdata.Rdata._as_bytes(data, True)
 
-    def to_wire(self, file=None):
+    def to_wire(self, file: Optional[Any] = None) -> Optional[bytes]:
         if file:
             file.write(self.data)
+            return None
         else:
             return self.data
 
-    def to_text(self):
+    def to_text(self) -> str:
         return "Generic %d" % self.otype
 
     @classmethod
-    def from_wire_parser(cls, otype, parser):
+    def from_wire_parser(
+        cls, otype: Union[OptionType, str], parser: "dns.wire.Parser"
+    ) -> Option:
         return cls(otype, parser.get_remaining())
 
 
-class ECSOption(Option):
+class ECSOption(Option):  # lgtm[py/missing-equals]
     """EDNS Client Subnet (ECS, RFC7871)"""
 
-    def __init__(self, address, srclen=None, scopelen=0):
+    def __init__(self, address: str, srclen: Optional[int] = None, scopelen: int = 0):
         """*address*, a ``str``, is the client address information.
 
         *srclen*, an ``int``, the source prefix length, which is the
@@ -200,8 +202,9 @@ class ECSOption(Option):
             srclen = dns.rdata.Rdata._as_int(srclen, 0, 32)
             scopelen = dns.rdata.Rdata._as_int(scopelen, 0, 32)
         else:  # pragma: no cover   (this will never happen)
-            raise ValueError('Bad address family')
+            raise ValueError("Bad address family")
 
+        assert srclen is not None
         self.address = address
         self.srclen = srclen
         self.scopelen = scopelen
@@ -214,16 +217,14 @@ class ECSOption(Option):
         self.addrdata = addrdata[:nbytes]
         nbits = srclen % 8
         if nbits != 0:
-            last = struct.pack('B',
-                               ord(self.addrdata[-1:]) & (0xff << (8 - nbits)))
+            last = struct.pack("B", ord(self.addrdata[-1:]) & (0xFF << (8 - nbits)))
             self.addrdata = self.addrdata[:-1] + last
 
-    def to_text(self):
-        return "ECS {}/{} scope/{}".format(self.address, self.srclen,
-                                           self.scopelen)
+    def to_text(self) -> str:
+        return "ECS {}/{} scope/{}".format(self.address, self.srclen, self.scopelen)
 
     @staticmethod
-    def from_text(text):
+    def from_text(text: str) -> Option:
         """Convert a string into a `dns.edns.ECSOption`
 
         *text*, a `str`, the text form of the option.
@@ -246,7 +247,7 @@ class ECSOption(Option):
         >>> # it understands results from `dns.edns.ECSOption.to_text()`
         >>> dns.edns.ECSOption.from_text('ECS 1.2.3.4/24/32')
         """
-        optional_prefix = 'ECS'
+        optional_prefix = "ECS"
         tokens = text.split()
         ecs_text = None
         if len(tokens) == 1:
@@ -257,47 +258,53 @@ class ECSOption(Option):
             ecs_text = tokens[1]
         else:
             raise ValueError('could not parse ECS from "{}"'.format(text))
-        n_slashes = ecs_text.count('/')
+        n_slashes = ecs_text.count("/")
         if n_slashes == 1:
-            address, srclen = ecs_text.split('/')
-            scope = 0
+            address, tsrclen = ecs_text.split("/")
+            tscope = "0"
         elif n_slashes == 2:
-            address, srclen, scope = ecs_text.split('/')
+            address, tsrclen, tscope = ecs_text.split("/")
         else:
             raise ValueError('could not parse ECS from "{}"'.format(text))
         try:
-            scope = int(scope)
+            scope = int(tscope)
         except ValueError:
-            raise ValueError('invalid scope ' +
-                             '"{}": scope must be an integer'.format(scope))
+            raise ValueError(
+                "invalid scope " + '"{}": scope must be an integer'.format(tscope)
+            )
         try:
-            srclen = int(srclen)
+            srclen = int(tsrclen)
         except ValueError:
-            raise ValueError('invalid srclen ' +
-                             '"{}": srclen must be an integer'.format(srclen))
+            raise ValueError(
+                "invalid srclen " + '"{}": srclen must be an integer'.format(tsrclen)
+            )
         return ECSOption(address, srclen, scope)
 
-    def to_wire(self, file=None):
-        value = (struct.pack('!HBB', self.family, self.srclen, self.scopelen) +
-                 self.addrdata)
+    def to_wire(self, file: Optional[Any] = None) -> Optional[bytes]:
+        value = (
+            struct.pack("!HBB", self.family, self.srclen, self.scopelen) + self.addrdata
+        )
         if file:
             file.write(value)
+            return None
         else:
             return value
 
     @classmethod
-    def from_wire_parser(cls, otype, parser):
-        family, src, scope = parser.get_struct('!HBB')
+    def from_wire_parser(
+        cls, otype: Union[OptionType, str], parser: "dns.wire.Parser"
+    ) -> Option:
+        family, src, scope = parser.get_struct("!HBB")
         addrlen = int(math.ceil(src / 8.0))
         prefix = parser.get_bytes(addrlen)
         if family == 1:
             pad = 4 - addrlen
-            addr = dns.ipv4.inet_ntoa(prefix + b'\x00' * pad)
+            addr = dns.ipv4.inet_ntoa(prefix + b"\x00" * pad)
         elif family == 2:
             pad = 16 - addrlen
-            addr = dns.ipv6.inet_ntoa(prefix + b'\x00' * pad)
+            addr = dns.ipv6.inet_ntoa(prefix + b"\x00" * pad)
         else:
-            raise ValueError('unsupported family')
+            raise ValueError("unsupported family")
 
         return cls(addr, src, scope)
 
@@ -334,10 +341,10 @@ class EDECode(dns.enum.IntEnum):
         return 65535
 
 
-class EDEOption(Option):
+class EDEOption(Option):  # lgtm[py/missing-equals]
     """Extended DNS Error (EDE, RFC8914)"""
 
-    def __init__(self, code, text=None):
+    def __init__(self, code: Union[EDECode, str], text: Optional[str] = None):
         """*code*, a ``dns.edns.EDECode`` or ``str``, the info code of the
         extended error.
 
@@ -349,49 +356,50 @@ class EDEOption(Option):
 
         self.code = EDECode.make(code)
         if text is not None and not isinstance(text, str):
-            raise ValueError('text must be string or None')
-
-        self.code = code
+            raise ValueError("text must be string or None")
         self.text = text
 
-    def to_text(self):
-        output = f'EDE {self.code}'
+    def to_text(self) -> str:
+        output = f"EDE {self.code}"
         if self.text is not None:
-            output += f': {self.text}'
+            output += f": {self.text}"
         return output
 
-    def to_wire(self, file=None):
-        value = struct.pack('!H', self.code)
+    def to_wire(self, file: Optional[Any] = None) -> Optional[bytes]:
+        value = struct.pack("!H", self.code)
         if self.text is not None:
-            value += self.text.encode('utf8')
+            value += self.text.encode("utf8")
 
         if file:
             file.write(value)
+            return None
         else:
             return value
 
     @classmethod
-    def from_wire_parser(cls, otype, parser):
-        code = parser.get_uint16()
+    def from_wire_parser(
+        cls, otype: Union[OptionType, str], parser: "dns.wire.Parser"
+    ) -> Option:
+        the_code = EDECode.make(parser.get_uint16())
         text = parser.get_remaining()
 
         if text:
             if text[-1] == 0:  # text MAY be null-terminated
                 text = text[:-1]
-            text = text.decode('utf8')
+            btext = text.decode("utf8")
         else:
-            text = None
+            btext = None
 
-        return cls(code, text)
+        return cls(the_code, btext)
 
 
-_type_to_class = {
+_type_to_class: Dict[OptionType, Any] = {
     OptionType.ECS: ECSOption,
     OptionType.EDE: EDEOption,
 }
 
 
-def get_option_class(otype):
+def get_option_class(otype: OptionType) -> Any:
     """Return the class for the specified option type.
 
     The GenericOption class is used if a more specific class is not
@@ -404,7 +412,9 @@ def get_option_class(otype):
     return cls
 
 
-def option_from_wire_parser(otype, parser):
+def option_from_wire_parser(
+    otype: Union[OptionType, str], parser: "dns.wire.Parser"
+) -> Option:
     """Build an EDNS option object from wire format.
 
     *otype*, an ``int``, is the option type.
@@ -414,12 +424,14 @@ def option_from_wire_parser(otype, parser):
 
     Returns an instance of a subclass of ``dns.edns.Option``.
     """
-    cls = get_option_class(otype)
-    otype = OptionType.make(otype)
+    the_otype = OptionType.make(otype)
+    cls = get_option_class(the_otype)
     return cls.from_wire_parser(otype, parser)
 
 
-def option_from_wire(otype, wire, current, olen):
+def option_from_wire(
+    otype: Union[OptionType, str], wire: bytes, current: int, olen: int
+) -> Option:
     """Build an EDNS option object from wire format.
 
     *otype*, an ``int``, is the option type.
@@ -437,7 +449,8 @@ def option_from_wire(otype, wire, current, olen):
     with parser.restrict_to(olen):
         return option_from_wire_parser(otype, parser)
 
-def register_type(implementation, otype):
+
+def register_type(implementation: Any, otype: OptionType) -> None:
     """Register the implementation of an option type.
 
     *implementation*, a ``class``, is a subclass of ``dns.edns.Option``.
@@ -447,6 +460,7 @@ def register_type(implementation, otype):
 
     _type_to_class[otype] = implementation
 
+
 ### BEGIN generated OptionType constants
 
 NSID = OptionType.NSID
diff --git a/lib/dns/entropy.py b/lib/dns/entropy.py
index 086bba78..5e1f5e23 100644
--- a/lib/dns/entropy.py
+++ b/lib/dns/entropy.py
@@ -15,14 +15,13 @@
 # ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
 # OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 
+from typing import Any, Optional
+
 import os
 import hashlib
 import random
+import threading
 import time
-try:
-    import threading as _threading
-except ImportError:  # pragma: no cover
-    import dummy_threading as _threading    # type: ignore
 
 
 class EntropyPool:
@@ -32,51 +31,51 @@ class EntropyPool:
     # leaving this code doesn't hurt anything as the library code
     # is used if present.
 
-    def __init__(self, seed=None):
+    def __init__(self, seed: Optional[bytes] = None):
         self.pool_index = 0
-        self.digest = None
+        self.digest: Optional[bytearray] = None
         self.next_byte = 0
-        self.lock = _threading.Lock()
+        self.lock = threading.Lock()
         self.hash = hashlib.sha1()
         self.hash_len = 20
-        self.pool = bytearray(b'\0' * self.hash_len)
+        self.pool = bytearray(b"\0" * self.hash_len)
         if seed is not None:
-            self._stir(bytearray(seed))
+            self._stir(seed)
             self.seeded = True
             self.seed_pid = os.getpid()
         else:
             self.seeded = False
             self.seed_pid = 0
 
-    def _stir(self, entropy):
+    def _stir(self, entropy: bytes) -> None:
         for c in entropy:
             if self.pool_index == self.hash_len:
                 self.pool_index = 0
-            b = c & 0xff
+            b = c & 0xFF
             self.pool[self.pool_index] ^= b
             self.pool_index += 1
 
-    def stir(self, entropy):
+    def stir(self, entropy: bytes) -> None:
         with self.lock:
             self._stir(entropy)
 
-    def _maybe_seed(self):
+    def _maybe_seed(self) -> None:
         if not self.seeded or self.seed_pid != os.getpid():
             try:
                 seed = os.urandom(16)
             except Exception:  # pragma: no cover
                 try:
-                    with open('/dev/urandom', 'rb', 0) as r:
+                    with open("/dev/urandom", "rb", 0) as r:
                         seed = r.read(16)
                 except Exception:
-                    seed = str(time.time())
+                    seed = str(time.time()).encode()
             self.seeded = True
             self.seed_pid = os.getpid()
             self.digest = None
             seed = bytearray(seed)
             self._stir(seed)
 
-    def random_8(self):
+    def random_8(self) -> int:
         with self.lock:
             self._maybe_seed()
             if self.digest is None or self.next_byte == self.hash_len:
@@ -88,16 +87,16 @@ class EntropyPool:
             self.next_byte += 1
         return value
 
-    def random_16(self):
+    def random_16(self) -> int:
         return self.random_8() * 256 + self.random_8()
 
-    def random_32(self):
+    def random_32(self) -> int:
         return self.random_16() * 65536 + self.random_16()
 
-    def random_between(self, first, last):
+    def random_between(self, first: int, last: int) -> int:
         size = last - first + 1
         if size > 4294967296:
-            raise ValueError('too big')
+            raise ValueError("too big")
         if size > 65536:
             rand = self.random_32
             max = 4294967295
@@ -109,20 +108,24 @@ class EntropyPool:
             max = 255
         return first + size * rand() // (max + 1)
 
+
 pool = EntropyPool()
 
+system_random: Optional[Any]
 try:
     system_random = random.SystemRandom()
 except Exception:  # pragma: no cover
     system_random = None
 
-def random_16():
+
+def random_16() -> int:
     if system_random is not None:
         return system_random.randrange(0, 65536)
     else:
         return pool.random_16()
 
-def between(first, last):
+
+def between(first: int, last: int) -> int:
     if system_random is not None:
         return system_random.randrange(first, last + 1)
     else:
diff --git a/lib/dns/entropy.pyi b/lib/dns/entropy.pyi
deleted file mode 100644
index 818f805a..00000000
--- a/lib/dns/entropy.pyi
+++ /dev/null
@@ -1,10 +0,0 @@
-from typing import Optional
-from random import SystemRandom
-
-system_random : Optional[SystemRandom]
-
-def random_16() -> int:
-   pass
-
-def between(first: int, last: int) -> int:
-    pass
diff --git a/lib/dns/enum.py b/lib/dns/enum.py
index b822dd51..b5a4aed8 100644
--- a/lib/dns/enum.py
+++ b/lib/dns/enum.py
@@ -17,6 +17,7 @@
 
 import enum
 
+
 class IntEnum(enum.IntEnum):
     @classmethod
     def _check_value(cls, value):
@@ -32,9 +33,12 @@ class IntEnum(enum.IntEnum):
             return cls[text]
         except KeyError:
             pass
+        value = cls._extra_from_text(text)
+        if value:
+            return value
         prefix = cls._prefix()
-        if text.startswith(prefix) and text[len(prefix):].isdigit():
-            value = int(text[len(prefix):])
+        if text.startswith(prefix) and text[len(prefix) :].isdigit():
+            value = int(text[len(prefix) :])
             cls._check_value(value)
             try:
                 return cls(value)
@@ -46,9 +50,13 @@ class IntEnum(enum.IntEnum):
     def to_text(cls, value):
         cls._check_value(value)
         try:
-            return cls(value).name
+            text = cls(value).name
         except ValueError:
-            return f"{cls._prefix()}{value}"
+            text = None
+        text = cls._extra_to_text(value, text)
+        if text is None:
+            text = f"{cls._prefix()}{value}"
+        return text
 
     @classmethod
     def make(cls, value):
@@ -83,7 +91,15 @@ class IntEnum(enum.IntEnum):
 
     @classmethod
     def _prefix(cls):
-        return ''
+        return ""
+
+    @classmethod
+    def _extra_from_text(cls, text):  # pylint: disable=W0613
+        return None
+
+    @classmethod
+    def _extra_to_text(cls, value, current_text):  # pylint: disable=W0613
+        return current_text
 
     @classmethod
     def _unknown_exception_class(cls):
diff --git a/lib/dns/exception.py b/lib/dns/exception.py
index 08393821..4b1481d1 100644
--- a/lib/dns/exception.py
+++ b/lib/dns/exception.py
@@ -21,6 +21,10 @@ Dnspython modules may also define their own exceptions, which will
 always be subclasses of ``DNSException``.
 """
 
+
+from typing import Optional, Set
+
+
 class DNSException(Exception):
     """Abstract base class shared by all dnspython exceptions.
 
@@ -44,14 +48,15 @@ class DNSException(Exception):
     and ``fmt`` class variables to get nice parametrized messages.
     """
 
-    msg = None  # non-parametrized message
-    supp_kwargs = set()  # accepted parameters for _fmt_kwargs (sanity check)
-    fmt = None  # message parametrized with results from _fmt_kwargs
+    msg: Optional[str] = None  # non-parametrized message
+    supp_kwargs: Set[str] = set()  # accepted parameters for _fmt_kwargs (sanity check)
+    fmt: Optional[str] = None  # message parametrized with results from _fmt_kwargs
 
     def __init__(self, *args, **kwargs):
         self._check_params(*args, **kwargs)
         if kwargs:
-            self.kwargs = self._check_kwargs(**kwargs)
+            # This call to a virtual method from __init__ is ok in our usage
+            self.kwargs = self._check_kwargs(**kwargs)  # lgtm[py/init-calls-subclass]
             self.msg = str(self)
         else:
             self.kwargs = dict()  # defined but empty for old mode exceptions
@@ -68,14 +73,15 @@ class DNSException(Exception):
 
         For sanity we do not allow to mix old and new behavior."""
         if args or kwargs:
-            assert bool(args) != bool(kwargs), \
-                'keyword arguments are mutually exclusive with positional args'
+            assert bool(args) != bool(
+                kwargs
+            ), "keyword arguments are mutually exclusive with positional args"
 
     def _check_kwargs(self, **kwargs):
         if kwargs:
-            assert set(kwargs.keys()) == self.supp_kwargs, \
-                'following set of keyword args is required: %s' % (
-                    self.supp_kwargs)
+            assert (
+                set(kwargs.keys()) == self.supp_kwargs
+            ), "following set of keyword args is required: %s" % (self.supp_kwargs)
         return kwargs
 
     def _fmt_kwargs(self, **kwargs):
@@ -124,9 +130,15 @@ class TooBig(DNSException):
 
 class Timeout(DNSException):
     """The DNS operation timed out."""
-    supp_kwargs = {'timeout'}
+
+    supp_kwargs = {"timeout"}
     fmt = "The DNS operation timed out after {timeout:.3f} seconds"
 
+    # We do this as otherwise mypy complains about unexpected keyword argument
+    # idna_exception
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+
 
 class ExceptionWrapper:
     def __init__(self, exception_class):
@@ -136,7 +148,6 @@ class ExceptionWrapper:
         return self
 
     def __exit__(self, exc_type, exc_val, exc_tb):
-        if exc_type is not None and not isinstance(exc_val,
-                                                   self.exception_class):
+        if exc_type is not None and not isinstance(exc_val, self.exception_class):
             raise self.exception_class(str(exc_val)) from exc_val
         return False
diff --git a/lib/dns/exception.pyi b/lib/dns/exception.pyi
deleted file mode 100644
index dc571264..00000000
--- a/lib/dns/exception.pyi
+++ /dev/null
@@ -1,12 +0,0 @@
-from typing import Set, Optional, Dict
-
-class DNSException(Exception):
-    supp_kwargs : Set[str]
-    kwargs : Optional[Dict]
-    fmt : Optional[str]
-
-class SyntaxError(DNSException): ...
-class FormError(DNSException): ...
-class Timeout(DNSException): ...
-class TooBig(DNSException): ...
-class UnexpectedEnd(SyntaxError): ...
diff --git a/lib/dns/flags.py b/lib/dns/flags.py
index 96522879..b21b8e3b 100644
--- a/lib/dns/flags.py
+++ b/lib/dns/flags.py
@@ -17,10 +17,13 @@
 
 """DNS Message Flags."""
 
+from typing import Any
+
 import enum
 
 # Standard DNS flags
 
+
 class Flag(enum.IntFlag):
     #: Query Response
     QR = 0x8000
@@ -40,12 +43,13 @@ class Flag(enum.IntFlag):
 
 # EDNS flags
 
+
 class EDNSFlag(enum.IntFlag):
     #: DNSSEC answer OK
     DO = 0x8000
 
 
-def _from_text(text, enum_class):
+def _from_text(text: str, enum_class: Any) -> int:
     flags = 0
     tokens = text.split()
     for t in tokens:
@@ -53,15 +57,15 @@ def _from_text(text, enum_class):
     return flags
 
 
-def _to_text(flags, enum_class):
+def _to_text(flags: int, enum_class: Any) -> str:
     text_flags = []
     for k, v in enum_class.__members__.items():
         if flags & v != 0:
             text_flags.append(k)
-    return ' '.join(text_flags)
+    return " ".join(text_flags)
 
 
-def from_text(text):
+def from_text(text: str) -> int:
     """Convert a space-separated list of flag text values into a flags
     value.
 
@@ -71,7 +75,7 @@ def from_text(text):
     return _from_text(text, Flag)
 
 
-def to_text(flags):
+def to_text(flags: int) -> str:
     """Convert a flags value into a space-separated list of flag text
     values.
 
@@ -81,7 +85,7 @@ def to_text(flags):
     return _to_text(flags, Flag)
 
 
-def edns_from_text(text):
+def edns_from_text(text: str) -> int:
     """Convert a space-separated list of EDNS flag text values into a EDNS
     flags value.
 
@@ -91,7 +95,7 @@ def edns_from_text(text):
     return _from_text(text, EDNSFlag)
 
 
-def edns_to_text(flags):
+def edns_to_text(flags: int) -> str:
     """Convert an EDNS flags value into a space-separated list of EDNS flag
     text values.
 
@@ -100,6 +104,7 @@ def edns_to_text(flags):
 
     return _to_text(flags, EDNSFlag)
 
+
 ### BEGIN generated Flag constants
 
 QR = Flag.QR
diff --git a/lib/dns/grange.py b/lib/dns/grange.py
index 112ede47..3a52278f 100644
--- a/lib/dns/grange.py
+++ b/lib/dns/grange.py
@@ -17,9 +17,12 @@
 
 """DNS GENERATE range conversion."""
 
+from typing import Tuple
+
 import dns
 
-def from_text(text):
+
+def from_text(text: str) -> Tuple[int, int, int]:
     """Convert the text form of a range in a ``$GENERATE`` statement to an
     integer.
 
@@ -31,22 +34,22 @@ def from_text(text):
     start = -1
     stop = -1
     step = 1
-    cur = ''
+    cur = ""
     state = 0
     # state   0   1   2
     #         x - y / z
 
-    if text and text[0] == '-':
+    if text and text[0] == "-":
         raise dns.exception.SyntaxError("Start cannot be a negative number")
 
     for c in text:
-        if c == '-' and state == 0:
+        if c == "-" and state == 0:
             start = int(cur)
-            cur = ''
+            cur = ""
             state = 1
-        elif c == '/':
+        elif c == "/":
             stop = int(cur)
-            cur = ''
+            cur = ""
             state = 2
         elif c.isdigit():
             cur += c
@@ -64,6 +67,6 @@ def from_text(text):
     assert step >= 1
     assert start >= 0
     if start > stop:
-        raise dns.exception.SyntaxError('start must be <= stop')
+        raise dns.exception.SyntaxError("start must be <= stop")
 
     return (start, stop, step)
diff --git a/lib/dns/immutable.py b/lib/dns/immutable.py
index db7abbcc..38fbe597 100644
--- a/lib/dns/immutable.py
+++ b/lib/dns/immutable.py
@@ -1,32 +1,25 @@
 # Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license
 
-import collections.abc
-import sys
+from typing import Any
 
-# pylint: disable=unused-import
-if sys.version_info >= (3, 7):
-    odict = dict
-    from dns._immutable_ctx import immutable
-else:
-    # pragma: no cover
-    from collections import OrderedDict as odict
-    from dns._immutable_attr import immutable  # noqa
-# pylint: enable=unused-import
+import collections.abc
+
+from dns._immutable_ctx import immutable
 
 
 @immutable
-class Dict(collections.abc.Mapping):
-    def __init__(self, dictionary, no_copy=False):
+class Dict(collections.abc.Mapping):  # lgtm[py/missing-equals]
+    def __init__(self, dictionary: Any, no_copy: bool = False):
         """Make an immutable dictionary from the specified dictionary.
 
         If *no_copy* is `True`, then *dictionary* will be wrapped instead
         of copied.  Only set this if you are sure there will be no external
         references to the dictionary.
         """
-        if no_copy and isinstance(dictionary, odict):
+        if no_copy and isinstance(dictionary, dict):
             self._odict = dictionary
         else:
-            self._odict = odict(dictionary)
+            self._odict = dict(dictionary)
         self._hash = None
 
     def __getitem__(self, key):
@@ -37,7 +30,7 @@ class Dict(collections.abc.Mapping):
             h = 0
             for key in sorted(self._odict.keys()):
                 h ^= hash(key)
-            object.__setattr__(self, '_hash', h)
+            object.__setattr__(self, "_hash", h)
         # this does return an int, but pylint doesn't figure that out
         return self._hash
 
@@ -48,7 +41,7 @@ class Dict(collections.abc.Mapping):
         return iter(self._odict)
 
 
-def constify(o):
+def constify(o: Any) -> Any:
     """
     Convert mutable types to immutable types.
     """
@@ -63,7 +56,7 @@ def constify(o):
     if isinstance(o, list):
         return tuple(constify(elt) for elt in o)
     if isinstance(o, dict):
-        cdict = odict()
+        cdict = dict()
         for k, v in o.items():
             cdict[k] = constify(v)
         return Dict(cdict, True)
diff --git a/lib/dns/inet.py b/lib/dns/inet.py
index d3bdc64c..11180c96 100644
--- a/lib/dns/inet.py
+++ b/lib/dns/inet.py
@@ -17,6 +17,8 @@
 
 """Generic Internet address helper functions."""
 
+from typing import Any, Optional, Tuple
+
 import socket
 
 import dns.ipv4
@@ -30,7 +32,7 @@ AF_INET = socket.AF_INET
 AF_INET6 = socket.AF_INET6
 
 
-def inet_pton(family, text):
+def inet_pton(family: int, text: str) -> bytes:
     """Convert the textual form of a network address into its binary form.
 
     *family* is an ``int``, the address family.
@@ -51,7 +53,7 @@ def inet_pton(family, text):
         raise NotImplementedError
 
 
-def inet_ntop(family, address):
+def inet_ntop(family: int, address: bytes) -> str:
     """Convert the binary form of a network address into its textual form.
 
     *family* is an ``int``, the address family.
@@ -72,7 +74,7 @@ def inet_ntop(family, address):
         raise NotImplementedError
 
 
-def af_for_address(text):
+def af_for_address(text: str) -> int:
     """Determine the address family of a textual-form network address.
 
     *text*, a ``str``, the textual address.
@@ -94,7 +96,7 @@ def af_for_address(text):
             raise ValueError
 
 
-def is_multicast(text):
+def is_multicast(text: str) -> bool:
     """Is the textual-form network address a multicast address?
 
     *text*, a ``str``, the textual address.
@@ -116,7 +118,7 @@ def is_multicast(text):
             raise ValueError
 
 
-def is_address(text):
+def is_address(text: str) -> bool:
     """Is the specified string an IPv4 or IPv6 address?
 
     *text*, a ``str``, the textual address.
@@ -135,7 +137,9 @@ def is_address(text):
             return False
 
 
-def low_level_address_tuple(high_tuple, af=None):
+def low_level_address_tuple(
+    high_tuple: Tuple[str, int], af: Optional[int] = None
+) -> Any:
     """Given a "high-level" address tuple, i.e.
     an (address, port) return the appropriate "low-level" address tuple
     suitable for use in socket calls.
@@ -143,7 +147,6 @@ def low_level_address_tuple(high_tuple, af=None):
     If an *af* other than ``None`` is provided, it is assumed the
     address in the high-level tuple is valid and has that af.  If af
     is ``None``, then af_for_address will be called.
-
     """
     address, port = high_tuple
     if af is None:
@@ -151,13 +154,13 @@ def low_level_address_tuple(high_tuple, af=None):
     if af == AF_INET:
         return (address, port)
     elif af == AF_INET6:
-        i = address.find('%')
+        i = address.find("%")
         if i < 0:
             # no scope, shortcut!
             return (address, port, 0, 0)
         # try to avoid getaddrinfo()
         addrpart = address[:i]
-        scope = address[i + 1:]
+        scope = address[i + 1 :]
         if scope.isdigit():
             return (addrpart, port, 0, int(scope))
         try:
@@ -167,4 +170,4 @@ def low_level_address_tuple(high_tuple, af=None):
             ((*_, tup), *_) = socket.getaddrinfo(address, port, flags=ai_flags)
             return tup
     else:
-        raise NotImplementedError(f'unknown address family {af}')
+        raise NotImplementedError(f"unknown address family {af}")
diff --git a/lib/dns/inet.pyi b/lib/dns/inet.pyi
deleted file mode 100644
index 6d9dcc70..00000000
--- a/lib/dns/inet.pyi
+++ /dev/null
@@ -1,4 +0,0 @@
-from typing import Union
-from socket import AddressFamily
-
-AF_INET6 : Union[int, AddressFamily]
diff --git a/lib/dns/ipv4.py b/lib/dns/ipv4.py
index e1f38d3d..b8e148f3 100644
--- a/lib/dns/ipv4.py
+++ b/lib/dns/ipv4.py
@@ -17,11 +17,14 @@
 
 """IPv4 helper functions."""
 
+from typing import Union
+
 import struct
 
 import dns.exception
 
-def inet_ntoa(address):
+
+def inet_ntoa(address: bytes) -> str:
     """Convert an IPv4 address in binary form to text form.
 
     *address*, a ``bytes``, the IPv4 address in binary form.
@@ -31,30 +34,32 @@ def inet_ntoa(address):
 
     if len(address) != 4:
         raise dns.exception.SyntaxError
-    return ('%u.%u.%u.%u' % (address[0], address[1],
-                             address[2], address[3]))
+    return "%u.%u.%u.%u" % (address[0], address[1], address[2], address[3])
 
-def inet_aton(text):
+
+def inet_aton(text: Union[str, bytes]) -> bytes:
     """Convert an IPv4 address in text form to binary form.
 
-    *text*, a ``str``, the IPv4 address in textual form.
+    *text*, a ``str`` or ``bytes``, the IPv4 address in textual form.
 
     Returns a ``bytes``.
     """
 
     if not isinstance(text, bytes):
-        text = text.encode()
-    parts = text.split(b'.')
+        btext = text.encode()
+    else:
+        btext = text
+    parts = btext.split(b".")
     if len(parts) != 4:
         raise dns.exception.SyntaxError
     for part in parts:
         if not part.isdigit():
             raise dns.exception.SyntaxError
-        if len(part) > 1 and part[0] == ord('0'):
+        if len(part) > 1 and part[0] == ord("0"):
             # No leading zeros
             raise dns.exception.SyntaxError
     try:
         b = [int(part) for part in parts]
-        return struct.pack('BBBB', *b)
+        return struct.pack("BBBB", *b)
     except Exception:
         raise dns.exception.SyntaxError
diff --git a/lib/dns/ipv6.py b/lib/dns/ipv6.py
index 0db6fcfa..fbd49623 100644
--- a/lib/dns/ipv6.py
+++ b/lib/dns/ipv6.py
@@ -17,15 +17,18 @@
 
 """IPv6 helper functions."""
 
+from typing import List, Union
+
 import re
 import binascii
 
 import dns.exception
 import dns.ipv4
 
-_leading_zero = re.compile(r'0+([0-9a-f]+)')
+_leading_zero = re.compile(r"0+([0-9a-f]+)")
 
-def inet_ntoa(address):
+
+def inet_ntoa(address: bytes) -> str:
     """Convert an IPv6 address in binary form to text form.
 
     *address*, a ``bytes``, the IPv6 address in binary form.
@@ -41,7 +44,7 @@ def inet_ntoa(address):
     i = 0
     l = len(hex)
     while i < l:
-        chunk = hex[i:i + 4].decode()
+        chunk = hex[i : i + 4].decode()
         # strip leading zeros.  we do this with an re instead of
         # with lstrip() because lstrip() didn't support chars until
         # python 2.2.2
@@ -58,7 +61,7 @@ def inet_ntoa(address):
     start = -1
     last_was_zero = False
     for i in range(8):
-        if chunks[i] != '0':
+        if chunks[i] != "0":
             if last_was_zero:
                 end = i
                 current_len = end - start
@@ -76,27 +79,30 @@ def inet_ntoa(address):
             best_start = start
             best_len = current_len
     if best_len > 1:
-        if best_start == 0 and \
-           (best_len == 6 or
-            best_len == 5 and chunks[5] == 'ffff'):
+        if best_start == 0 and (best_len == 6 or best_len == 5 and chunks[5] == "ffff"):
             # We have an embedded IPv4 address
             if best_len == 6:
-                prefix = '::'
+                prefix = "::"
             else:
-                prefix = '::ffff:'
-            hex = prefix + dns.ipv4.inet_ntoa(address[12:])
+                prefix = "::ffff:"
+            thex = prefix + dns.ipv4.inet_ntoa(address[12:])
         else:
-            hex = ':'.join(chunks[:best_start]) + '::' + \
-                  ':'.join(chunks[best_start + best_len:])
+            thex = (
+                ":".join(chunks[:best_start])
+                + "::"
+                + ":".join(chunks[best_start + best_len :])
+            )
     else:
-        hex = ':'.join(chunks)
-    return hex
+        thex = ":".join(chunks)
+    return thex
 
-_v4_ending = re.compile(br'(.*):(\d+\.\d+\.\d+\.\d+)$')
-_colon_colon_start = re.compile(br'::.*')
-_colon_colon_end = re.compile(br'.*::$')
 
-def inet_aton(text, ignore_scope=False):
+_v4_ending = re.compile(rb"(.*):(\d+\.\d+\.\d+\.\d+)$")
+_colon_colon_start = re.compile(rb"::.*")
+_colon_colon_end = re.compile(rb".*::$")
+
+
+def inet_aton(text: Union[str, bytes], ignore_scope: bool = False) -> bytes:
     """Convert an IPv6 address in text form to binary form.
 
     *text*, a ``str``, the IPv6 address in textual form.
@@ -111,82 +117,88 @@ def inet_aton(text, ignore_scope=False):
     # Our aim here is not something fast; we just want something that works.
     #
     if not isinstance(text, bytes):
-        text = text.encode()
+        btext = text.encode()
+    else:
+        btext = text
 
     if ignore_scope:
-        parts = text.split(b'%')
+        parts = btext.split(b"%")
         l = len(parts)
         if l == 2:
-            text = parts[0]
+            btext = parts[0]
         elif l > 2:
             raise dns.exception.SyntaxError
 
-    if text == b'':
+    if btext == b"":
         raise dns.exception.SyntaxError
-    elif text.endswith(b':') and not text.endswith(b'::'):
+    elif btext.endswith(b":") and not btext.endswith(b"::"):
         raise dns.exception.SyntaxError
-    elif text.startswith(b':') and not text.startswith(b'::'):
+    elif btext.startswith(b":") and not btext.startswith(b"::"):
         raise dns.exception.SyntaxError
-    elif text == b'::':
-        text = b'0::'
+    elif btext == b"::":
+        btext = b"0::"
     #
     # Get rid of the icky dot-quad syntax if we have it.
     #
-    m = _v4_ending.match(text)
+    m = _v4_ending.match(btext)
     if m is not None:
         b = dns.ipv4.inet_aton(m.group(2))
-        text = ("{}:{:02x}{:02x}:{:02x}{:02x}".format(m.group(1).decode(),
-                                                      b[0], b[1], b[2],
-                                                      b[3])).encode()
+        btext = (
+            "{}:{:02x}{:02x}:{:02x}{:02x}".format(
+                m.group(1).decode(), b[0], b[1], b[2], b[3]
+            )
+        ).encode()
     #
     # Try to turn '::<whatever>' into ':<whatever>'; if no match try to
     # turn '<whatever>::' into '<whatever>:'
     #
-    m = _colon_colon_start.match(text)
+    m = _colon_colon_start.match(btext)
     if m is not None:
-        text = text[1:]
+        btext = btext[1:]
     else:
-        m = _colon_colon_end.match(text)
+        m = _colon_colon_end.match(btext)
         if m is not None:
-            text = text[:-1]
+            btext = btext[:-1]
     #
     # Now canonicalize into 8 chunks of 4 hex digits each
     #
-    chunks = text.split(b':')
+    chunks = btext.split(b":")
     l = len(chunks)
     if l > 8:
         raise dns.exception.SyntaxError
     seen_empty = False
-    canonical = []
+    canonical: List[bytes] = []
     for c in chunks:
-        if c == b'':
+        if c == b"":
             if seen_empty:
                 raise dns.exception.SyntaxError
             seen_empty = True
             for _ in range(0, 8 - l + 1):
-                canonical.append(b'0000')
+                canonical.append(b"0000")
         else:
             lc = len(c)
             if lc > 4:
                 raise dns.exception.SyntaxError
             if lc != 4:
-                c = (b'0' * (4 - lc)) + c
+                c = (b"0" * (4 - lc)) + c
             canonical.append(c)
     if l < 8 and not seen_empty:
         raise dns.exception.SyntaxError
-    text = b''.join(canonical)
+    btext = b"".join(canonical)
 
     #
     # Finally we can go to binary.
     #
     try:
-        return binascii.unhexlify(text)
+        return binascii.unhexlify(btext)
     except (binascii.Error, TypeError):
         raise dns.exception.SyntaxError
 
-_mapped_prefix = b'\x00' * 10 + b'\xff\xff'
 
-def is_mapped(address):
+_mapped_prefix = b"\x00" * 10 + b"\xff\xff"
+
+
+def is_mapped(address: bytes) -> bool:
     """Is the specified address a mapped IPv4 address?
 
     *address*, a ``bytes`` is an IPv6 address in binary form.
diff --git a/lib/dns/message.py b/lib/dns/message.py
index c2751a90..8250db3b 100644
--- a/lib/dns/message.py
+++ b/lib/dns/message.py
@@ -17,6 +17,8 @@
 
 """DNS Messages"""
 
+from typing import Any, Dict, List, Optional, Tuple, Union
+
 import contextlib
 import io
 import time
@@ -71,14 +73,19 @@ class UnknownTSIGKey(dns.exception.DNSException):
 class Truncated(dns.exception.DNSException):
     """The truncated flag is set."""
 
-    supp_kwargs = {'message'}
+    supp_kwargs = {"message"}
+
+    # We do this as otherwise mypy complains about unexpected keyword argument
+    # idna_exception
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
 
     def message(self):
         """As much of the message as could be processed.
 
         Returns a ``dns.message.Message``.
         """
-        return self.kwargs['message']
+        return self.kwargs["message"]
 
 
 class NotQueryResponse(dns.exception.DNSException):
@@ -92,12 +99,14 @@ class ChainTooLong(dns.exception.DNSException):
 class AnswerForNXDOMAIN(dns.exception.DNSException):
     """The rcode is NXDOMAIN but an answer was found."""
 
+
 class NoPreviousName(dns.exception.SyntaxError):
     """No previous name was known."""
 
 
 class MessageSection(dns.enum.IntEnum):
     """Message sections"""
+
     QUESTION = 0
     ANSWER = 1
     AUTHORITY = 2
@@ -109,7 +118,7 @@ class MessageSection(dns.enum.IntEnum):
 
 
 class MessageError:
-    def __init__(self, exception, offset):
+    def __init__(self, exception: Exception, offset: int):
         self.exception = exception
         self.offset = offset
 
@@ -117,32 +126,46 @@ class MessageError:
 DEFAULT_EDNS_PAYLOAD = 1232
 MAX_CHAIN = 16
 
+IndexKeyType = Tuple[
+    int,
+    dns.name.Name,
+    dns.rdataclass.RdataClass,
+    dns.rdatatype.RdataType,
+    Optional[dns.rdatatype.RdataType],
+    Optional[dns.rdataclass.RdataClass],
+]
+IndexType = Dict[IndexKeyType, dns.rrset.RRset]
+SectionType = Union[int, List[dns.rrset.RRset]]
+
+
 class Message:
     """A DNS message."""
 
     _section_enum = MessageSection
 
-    def __init__(self, id=None):
+    def __init__(self, id: Optional[int] = None):
         if id is None:
             self.id = dns.entropy.random_16()
         else:
             self.id = id
         self.flags = 0
-        self.sections = [[], [], [], []]
-        self.opt = None
+        self.sections: List[List[dns.rrset.RRset]] = [[], [], [], []]
+        self.opt: Optional[dns.rrset.RRset] = None
         self.request_payload = 0
-        self.keyring = None
-        self.tsig = None
-        self.request_mac = b''
+        self.pad = 0
+        self.keyring: Any = None
+        self.tsig: Optional[dns.rrset.RRset] = None
+        self.request_mac = b""
         self.xfr = False
-        self.origin = None
-        self.tsig_ctx = None
-        self.index = {}
-        self.errors = []
+        self.origin: Optional[dns.name.Name] = None
+        self.tsig_ctx: Optional[Any] = None
+        self.index: IndexType = {}
+        self.errors: List[MessageError] = []
+        self.time = 0.0
 
     @property
-    def question(self):
-        """ The question section."""
+    def question(self) -> List[dns.rrset.RRset]:
+        """The question section."""
         return self.sections[0]
 
     @question.setter
@@ -150,8 +173,8 @@ class Message:
         self.sections[0] = v
 
     @property
-    def answer(self):
-        """ The answer section."""
+    def answer(self) -> List[dns.rrset.RRset]:
+        """The answer section."""
         return self.sections[1]
 
     @answer.setter
@@ -159,8 +182,8 @@ class Message:
         self.sections[1] = v
 
     @property
-    def authority(self):
-        """ The authority section."""
+    def authority(self) -> List[dns.rrset.RRset]:
+        """The authority section."""
         return self.sections[2]
 
     @authority.setter
@@ -168,8 +191,8 @@ class Message:
         self.sections[2] = v
 
     @property
-    def additional(self):
-        """ The additional data section."""
+    def additional(self) -> List[dns.rrset.RRset]:
+        """The additional data section."""
         return self.sections[3]
 
     @additional.setter
@@ -177,12 +200,17 @@ class Message:
         self.sections[3] = v
 
     def __repr__(self):
-        return '<DNS message, ID ' + repr(self.id) + '>'
+        return "<DNS message, ID " + repr(self.id) + ">"
 
     def __str__(self):
         return self.to_text()
 
-    def to_text(self, origin=None, relativize=True, **kw):
+    def to_text(
+        self,
+        origin: Optional[dns.name.Name] = None,
+        relativize: bool = True,
+        **kw: Dict[str, Any],
+    ) -> str:
         """Convert the message to text.
 
         The *origin*, *relativize*, and any other keyword
@@ -192,23 +220,22 @@ class Message:
         """
 
         s = io.StringIO()
-        s.write('id %d\n' % self.id)
-        s.write('opcode %s\n' % dns.opcode.to_text(self.opcode()))
-        s.write('rcode %s\n' % dns.rcode.to_text(self.rcode()))
-        s.write('flags %s\n' % dns.flags.to_text(self.flags))
+        s.write("id %d\n" % self.id)
+        s.write("opcode %s\n" % dns.opcode.to_text(self.opcode()))
+        s.write("rcode %s\n" % dns.rcode.to_text(self.rcode()))
+        s.write("flags %s\n" % dns.flags.to_text(self.flags))
         if self.edns >= 0:
-            s.write('edns %s\n' % self.edns)
+            s.write("edns %s\n" % self.edns)
             if self.ednsflags != 0:
-                s.write('eflags %s\n' %
-                        dns.flags.edns_to_text(self.ednsflags))
-            s.write('payload %d\n' % self.payload)
+                s.write("eflags %s\n" % dns.flags.edns_to_text(self.ednsflags))
+            s.write("payload %d\n" % self.payload)
         for opt in self.options:
-            s.write('option %s\n' % opt.to_text())
+            s.write("option %s\n" % opt.to_text())
         for (name, which) in self._section_enum.__members__.items():
-            s.write(f';{name}\n')
+            s.write(f";{name}\n")
             for rrset in self.section_from_number(which):
                 s.write(rrset.to_text(origin, relativize, **kw))
-                s.write('\n')
+                s.write("\n")
         #
         # We strip off the final \n so the caller can print the result without
         # doing weird things to get around eccentricities in Python print
@@ -242,20 +269,25 @@ class Message:
     def __ne__(self, other):
         return not self.__eq__(other)
 
-    def is_response(self, other):
+    def is_response(self, other: "Message") -> bool:
         """Is *other*, also a ``dns.message.Message``, a response to this
         message?
 
         Returns a ``bool``.
         """
 
-        if other.flags & dns.flags.QR == 0 or \
-           self.id != other.id or \
-           dns.opcode.from_flags(self.flags) != \
-           dns.opcode.from_flags(other.flags):
+        if (
+            other.flags & dns.flags.QR == 0
+            or self.id != other.id
+            or dns.opcode.from_flags(self.flags) != dns.opcode.from_flags(other.flags)
+        ):
             return False
-        if other.rcode() in {dns.rcode.FORMERR, dns.rcode.SERVFAIL,
-                             dns.rcode.NOTIMP, dns.rcode.REFUSED}:
+        if other.rcode() in {
+            dns.rcode.FORMERR,
+            dns.rcode.SERVFAIL,
+            dns.rcode.NOTIMP,
+            dns.rcode.REFUSED,
+        }:
             # We don't check the question section in these cases if
             # the other question section is empty, even though they
             # still really ought to have a question section.
@@ -275,7 +307,7 @@ class Message:
                 return False
         return True
 
-    def section_number(self, section):
+    def section_number(self, section: List[dns.rrset.RRset]) -> int:
         """Return the "section number" of the specified section for use
         in indexing.
 
@@ -289,9 +321,9 @@ class Message:
         for i, our_section in enumerate(self.sections):
             if section is our_section:
                 return self._section_enum(i)
-        raise ValueError('unknown section')
+        raise ValueError("unknown section")
 
-    def section_from_number(self, number):
+    def section_from_number(self, number: int) -> List[dns.rrset.RRset]:
         """Return the section list associated with the specified section
         number.
 
@@ -306,9 +338,17 @@ class Message:
         section = self._section_enum.make(number)
         return self.sections[section]
 
-    def find_rrset(self, section, name, rdclass, rdtype,
-                   covers=dns.rdatatype.NONE, deleting=None, create=False,
-                   force_unique=False):
+    def find_rrset(
+        self,
+        section: SectionType,
+        name: dns.name.Name,
+        rdclass: dns.rdataclass.RdataClass,
+        rdtype: dns.rdatatype.RdataType,
+        covers: dns.rdatatype.RdataType = dns.rdatatype.NONE,
+        deleting: Optional[dns.rdataclass.RdataClass] = None,
+        create: bool = False,
+        force_unique: bool = False,
+    ) -> dns.rrset.RRset:
         """Find the RRset with the given attributes in the specified section.
 
         *section*, an ``int`` section number, or one of the section
@@ -346,9 +386,10 @@ class Message:
 
         if isinstance(section, int):
             section_number = section
-            section = self.section_from_number(section_number)
+            the_section = self.section_from_number(section_number)
         else:
             section_number = self.section_number(section)
+            the_section = section
         key = (section_number, name, rdclass, rdtype, covers, deleting)
         if not force_unique:
             if self.index is not None:
@@ -356,21 +397,28 @@ class Message:
                 if rrset is not None:
                     return rrset
             else:
-                for rrset in section:
-                    if rrset.full_match(name, rdclass, rdtype, covers,
-                                        deleting):
+                for rrset in the_section:
+                    if rrset.full_match(name, rdclass, rdtype, covers, deleting):
                         return rrset
         if not create:
             raise KeyError
         rrset = dns.rrset.RRset(name, rdclass, rdtype, covers, deleting)
-        section.append(rrset)
+        the_section.append(rrset)
         if self.index is not None:
             self.index[key] = rrset
         return rrset
 
-    def get_rrset(self, section, name, rdclass, rdtype,
-                  covers=dns.rdatatype.NONE, deleting=None, create=False,
-                  force_unique=False):
+    def get_rrset(
+        self,
+        section: SectionType,
+        name: dns.name.Name,
+        rdclass: dns.rdataclass.RdataClass,
+        rdtype: dns.rdatatype.RdataType,
+        covers: dns.rdatatype.RdataType = dns.rdatatype.NONE,
+        deleting: Optional[dns.rdataclass.RdataClass] = None,
+        create: bool = False,
+        force_unique: bool = False,
+    ) -> Optional[dns.rrset.RRset]:
         """Get the RRset with the given attributes in the specified section.
 
         If the RRset is not found, None is returned.
@@ -406,14 +454,53 @@ class Message:
         """
 
         try:
-            rrset = self.find_rrset(section, name, rdclass, rdtype, covers,
-                                    deleting, create, force_unique)
+            rrset = self.find_rrset(
+                section, name, rdclass, rdtype, covers, deleting, create, force_unique
+            )
         except KeyError:
             rrset = None
         return rrset
 
-    def to_wire(self, origin=None, max_size=0, multi=False, tsig_ctx=None,
-                **kw):
+    def _compute_opt_reserve(self) -> int:
+        """Compute the size required for the OPT RR, padding excluded"""
+        if not self.opt:
+            return 0
+        # 1 byte for the root name, 10 for the standard RR fields
+        size = 11
+        # This would be more efficient if options had a size() method, but we won't
+        # worry about that for now.  We also don't worry if there is an existing padding
+        # option, as it is unlikely and probably harmless, as the worst case is that we
+        # may add another, and this seems to be legal.
+        for option in self.opt[0].options:
+            wire = option.to_wire()
+            # We add 4 here to account for the option type and length
+            size += len(wire) + 4
+        if self.pad:
+            # Padding will be added, so again add the option type and length.
+            size += 4
+        return size
+
+    def _compute_tsig_reserve(self) -> int:
+        """Compute the size required for the TSIG RR"""
+        # This would be more efficient if TSIGs had a size method, but we won't
+        # worry about for now.  Also, we can't really cope with the potential
+        # compressibility of the TSIG owner name, so we estimate with the uncompressed
+        # size.  We will disable compression when TSIG and padding are both is active
+        # so that the padding comes out right.
+        if not self.tsig:
+            return 0
+        f = io.BytesIO()
+        self.tsig.to_wire(f)
+        return len(f.getvalue())
+
+    def to_wire(
+        self,
+        origin: Optional[dns.name.Name] = None,
+        max_size: int = 0,
+        multi: bool = False,
+        tsig_ctx: Optional[Any] = None,
+        **kw: Dict[str, Any],
+    ) -> bytes:
         """Return a string containing the message in DNS compressed wire
         format.
 
@@ -451,25 +538,32 @@ class Message:
         elif max_size > 65535:
             max_size = 65535
         r = dns.renderer.Renderer(self.id, self.flags, max_size, origin)
+        opt_reserve = self._compute_opt_reserve()
+        r.reserve(opt_reserve)
+        tsig_reserve = self._compute_tsig_reserve()
+        r.reserve(tsig_reserve)
         for rrset in self.question:
             r.add_question(rrset.name, rrset.rdtype, rrset.rdclass)
         for rrset in self.answer:
             r.add_rrset(dns.renderer.ANSWER, rrset, **kw)
         for rrset in self.authority:
             r.add_rrset(dns.renderer.AUTHORITY, rrset, **kw)
-        if self.opt is not None:
-            r.add_rrset(dns.renderer.ADDITIONAL, self.opt)
         for rrset in self.additional:
             r.add_rrset(dns.renderer.ADDITIONAL, rrset, **kw)
+        r.release_reserved()
+        if self.opt is not None:
+            r.add_opt(self.opt, self.pad, opt_reserve, tsig_reserve)
         r.write_header()
         if self.tsig is not None:
-            (new_tsig, ctx) = dns.tsig.sign(r.get_wire(),
-                                            self.keyring,
-                                            self.tsig[0],
-                                            int(time.time()),
-                                            self.request_mac,
-                                            tsig_ctx,
-                                            multi)
+            (new_tsig, ctx) = dns.tsig.sign(
+                r.get_wire(),
+                self.keyring,
+                self.tsig[0],
+                int(time.time()),
+                self.request_mac,
+                tsig_ctx,
+                multi,
+            )
             self.tsig.clear()
             self.tsig.add(new_tsig)
             r.add_rrset(dns.renderer.ADDITIONAL, self.tsig)
@@ -479,16 +573,32 @@ class Message:
         return r.get_wire()
 
     @staticmethod
-    def _make_tsig(keyname, algorithm, time_signed, fudge, mac, original_id,
-                   error, other):
-        tsig = dns.rdtypes.ANY.TSIG.TSIG(dns.rdataclass.ANY, dns.rdatatype.TSIG,
-                                         algorithm, time_signed, fudge, mac,
-                                         original_id, error, other)
+    def _make_tsig(
+        keyname, algorithm, time_signed, fudge, mac, original_id, error, other
+    ):
+        tsig = dns.rdtypes.ANY.TSIG.TSIG(
+            dns.rdataclass.ANY,
+            dns.rdatatype.TSIG,
+            algorithm,
+            time_signed,
+            fudge,
+            mac,
+            original_id,
+            error,
+            other,
+        )
         return dns.rrset.from_rdata(keyname, 0, tsig)
 
-    def use_tsig(self, keyring, keyname=None, fudge=300,
-                 original_id=None, tsig_error=0, other_data=b'',
-                 algorithm=dns.tsig.default_algorithm):
+    def use_tsig(
+        self,
+        keyring: Any,
+        keyname: Optional[Union[dns.name.Name, str]] = None,
+        fudge: int = 300,
+        original_id: Optional[int] = None,
+        tsig_error: int = 0,
+        other_data: bytes = b"",
+        algorithm: Union[dns.name.Name, str] = dns.tsig.default_algorithm,
+    ) -> None:
         """When sending, a TSIG signature using the specified key
         should be added.
 
@@ -522,7 +632,7 @@ class Message:
 
         *other_data*, a ``bytes``, the TSIG other data.
 
-        *algorithm*, a ``dns.name.Name``, the TSIG algorithm to use.  This is
+        *algorithm*, a ``dns.name.Name`` or ``str``, the TSIG algorithm to use.  This is
         only used if *keyring* is a ``dict``, and the key entry is a ``bytes``.
         """
 
@@ -542,68 +652,84 @@ class Message:
         self.keyring = key
         if original_id is None:
             original_id = self.id
-        self.tsig = self._make_tsig(keyname, self.keyring.algorithm, 0, fudge,
-                                    b'', original_id, tsig_error, other_data)
+        self.tsig = self._make_tsig(
+            keyname,
+            self.keyring.algorithm,
+            0,
+            fudge,
+            b"\x00" * dns.tsig.mac_sizes[self.keyring.algorithm],
+            original_id,
+            tsig_error,
+            other_data,
+        )
 
     @property
-    def keyname(self):
+    def keyname(self) -> Optional[dns.name.Name]:
         if self.tsig:
             return self.tsig.name
         else:
             return None
 
     @property
-    def keyalgorithm(self):
+    def keyalgorithm(self) -> Optional[dns.name.Name]:
         if self.tsig:
             return self.tsig[0].algorithm
         else:
             return None
 
     @property
-    def mac(self):
+    def mac(self) -> Optional[bytes]:
         if self.tsig:
             return self.tsig[0].mac
         else:
             return None
 
     @property
-    def tsig_error(self):
+    def tsig_error(self) -> Optional[int]:
         if self.tsig:
             return self.tsig[0].error
         else:
             return None
 
     @property
-    def had_tsig(self):
+    def had_tsig(self) -> bool:
         return bool(self.tsig)
 
     @staticmethod
     def _make_opt(flags=0, payload=DEFAULT_EDNS_PAYLOAD, options=None):
-        opt = dns.rdtypes.ANY.OPT.OPT(payload, dns.rdatatype.OPT,
-                                      options or ())
+        opt = dns.rdtypes.ANY.OPT.OPT(payload, dns.rdatatype.OPT, options or ())
         return dns.rrset.from_rdata(dns.name.root, int(flags), opt)
 
-    def use_edns(self, edns=0, ednsflags=0, payload=DEFAULT_EDNS_PAYLOAD,
-                 request_payload=None, options=None):
+    def use_edns(
+        self,
+        edns: Optional[Union[int, bool]] = 0,
+        ednsflags: int = 0,
+        payload: int = DEFAULT_EDNS_PAYLOAD,
+        request_payload: Optional[int] = None,
+        options: Optional[List[dns.edns.Option]] = None,
+        pad: int = 0,
+    ) -> None:
         """Configure EDNS behavior.
 
-        *edns*, an ``int``, is the EDNS level to use.  Specifying
-        ``None``, ``False``, or ``-1`` means "do not use EDNS", and in this case
-        the other parameters are ignored.  Specifying ``True`` is
-        equivalent to specifying 0, i.e. "use EDNS0".
+        *edns*, an ``int``, is the EDNS level to use.  Specifying ``None``, ``False``,
+        or ``-1`` means "do not use EDNS", and in this case the other parameters are
+        ignored.  Specifying ``True`` is equivalent to specifying 0, i.e. "use EDNS0".
 
         *ednsflags*, an ``int``, the EDNS flag values.
 
-        *payload*, an ``int``, is the EDNS sender's payload field, which is the
-        maximum size of UDP datagram the sender can handle.  I.e. how big
-        a response to this message can be.
+        *payload*, an ``int``, is the EDNS sender's payload field, which is the maximum
+        size of UDP datagram the sender can handle.  I.e. how big a response to this
+        message can be.
 
-        *request_payload*, an ``int``, is the EDNS payload size to use when
-        sending this message.  If not specified, defaults to the value of
-        *payload*.
+        *request_payload*, an ``int``, is the EDNS payload size to use when sending this
+        message.  If not specified, defaults to the value of *payload*.
 
-        *options*, a list of ``dns.edns.Option`` objects or ``None``, the EDNS
-        options.
+        *options*, a list of ``dns.edns.Option`` objects or ``None``, the EDNS options.
+
+        *pad*, a non-negative ``int``.  If 0, the default, do not pad; otherwise add
+        padding bytes to make the message size a multiple of *pad*.  Note that if
+        padding is non-zero, an EDNS PADDING option will always be added to the
+        message.
         """
 
         if edns is None or edns is False:
@@ -616,23 +742,24 @@ class Message:
         else:
             # make sure the EDNS version in ednsflags agrees with edns
             ednsflags &= 0xFF00FFFF
-            ednsflags |= (edns << 16)
+            ednsflags |= edns << 16
             if options is None:
                 options = []
             self.opt = self._make_opt(ednsflags, payload, options)
             if request_payload is None:
                 request_payload = payload
             self.request_payload = request_payload
+            self.pad = pad
 
     @property
-    def edns(self):
+    def edns(self) -> int:
         if self.opt:
-            return (self.ednsflags & 0xff0000) >> 16
+            return (self.ednsflags & 0xFF0000) >> 16
         else:
             return -1
 
     @property
-    def ednsflags(self):
+    def ednsflags(self) -> int:
         if self.opt:
             return self.opt.ttl
         else:
@@ -646,20 +773,20 @@ class Message:
             self.opt = self._make_opt(v)
 
     @property
-    def payload(self):
+    def payload(self) -> int:
         if self.opt:
             return self.opt[0].payload
         else:
             return 0
 
     @property
-    def options(self):
+    def options(self) -> Tuple:
         if self.opt:
             return self.opt[0].options
         else:
             return ()
 
-    def want_dnssec(self, wanted=True):
+    def want_dnssec(self, wanted: bool = True) -> None:
         """Enable or disable 'DNSSEC desired' flag in requests.
 
         *wanted*, a ``bool``.  If ``True``, then DNSSEC data is
@@ -673,17 +800,17 @@ class Message:
         elif self.opt:
             self.ednsflags &= ~dns.flags.DO
 
-    def rcode(self):
+    def rcode(self) -> dns.rcode.Rcode:
         """Return the rcode.
 
-        Returns an ``int``.
+        Returns a ``dns.rcode.Rcode``.
         """
         return dns.rcode.from_flags(int(self.flags), int(self.ednsflags))
 
-    def set_rcode(self, rcode):
+    def set_rcode(self, rcode: dns.rcode.Rcode) -> None:
         """Set the rcode.
 
-        *rcode*, an ``int``, is the rcode to set.
+        *rcode*, a ``dns.rcode.Rcode``, is the rcode to set.
         """
         (value, evalue) = dns.rcode.to_flags(rcode)
         self.flags &= 0xFFF0
@@ -691,17 +818,17 @@ class Message:
         self.ednsflags &= 0x00FFFFFF
         self.ednsflags |= evalue
 
-    def opcode(self):
+    def opcode(self) -> dns.opcode.Opcode:
         """Return the opcode.
 
-        Returns an ``int``.
+        Returns a ``dns.opcode.Opcode``.
         """
         return dns.opcode.from_flags(int(self.flags))
 
-    def set_opcode(self, opcode):
+    def set_opcode(self, opcode: dns.opcode.Opcode) -> None:
         """Set the opcode.
 
-        *opcode*, an ``int``, is the opcode to set.
+        *opcode*, a ``dns.opcode.Opcode``, is the opcode to set.
         """
         self.flags &= 0x87FF
         self.flags |= dns.opcode.to_flags(opcode)
@@ -717,16 +844,20 @@ class Message:
 
     # pylint: enable=unused-argument
 
-    def _parse_special_rr_header(self, section, count, position,
-                                 name, rdclass, rdtype):
+    def _parse_special_rr_header(self, section, count, position, name, rdclass, rdtype):
         if rdtype == dns.rdatatype.OPT:
-            if section != MessageSection.ADDITIONAL or self.opt or \
-               name != dns.name.root:
+            if (
+                section != MessageSection.ADDITIONAL
+                or self.opt
+                or name != dns.name.root
+            ):
                 raise BadEDNS
         elif rdtype == dns.rdatatype.TSIG:
-            if section != MessageSection.ADDITIONAL or \
-               rdclass != dns.rdatatype.ANY or \
-               position != count - 1:
+            if (
+                section != MessageSection.ADDITIONAL
+                or rdclass != dns.rdatatype.ANY
+                or position != count - 1
+            ):
                 raise BadTSIG
         return (rdclass, rdtype, None, False)
 
@@ -738,7 +869,7 @@ class ChainingResult:
     exist.
 
     The ``canonical_name`` attribute is the canonical name after all
-    chaining has been applied (this is the name as ``rrset.name`` in cases
+    chaining has been applied (this is the same name as ``rrset.name`` in cases
     where rrset is not ``None``).
 
     The ``minimum_ttl`` attribute is the minimum TTL, i.e. the TTL to
@@ -749,7 +880,14 @@ class ChainingResult:
     The ``cnames`` attribute is a list of all the CNAME RRSets followed to
     get to the canonical name.
     """
-    def __init__(self, canonical_name, answer, minimum_ttl, cnames):
+
+    def __init__(
+        self,
+        canonical_name: dns.name.Name,
+        answer: Optional[dns.rrset.RRset],
+        minimum_ttl: int,
+        cnames: List[dns.rrset.RRset],
+    ):
         self.canonical_name = canonical_name
         self.answer = answer
         self.minimum_ttl = minimum_ttl
@@ -757,7 +895,7 @@ class ChainingResult:
 
 
 class QueryMessage(Message):
-    def resolve_chaining(self):
+    def resolve_chaining(self) -> ChainingResult:
         """Follow the CNAME chain in the response to determine the answer
         RRset.
 
@@ -785,16 +923,17 @@ class QueryMessage(Message):
         cnames = []
         while count < MAX_CHAIN:
             try:
-                answer = self.find_rrset(self.answer, qname, question.rdclass,
-                                         question.rdtype)
+                answer = self.find_rrset(
+                    self.answer, qname, question.rdclass, question.rdtype
+                )
                 min_ttl = min(min_ttl, answer.ttl)
                 break
             except KeyError:
                 if question.rdtype != dns.rdatatype.CNAME:
                     try:
-                        crrset = self.find_rrset(self.answer, qname,
-                                                 question.rdclass,
-                                                 dns.rdatatype.CNAME)
+                        crrset = self.find_rrset(
+                            self.answer, qname, question.rdclass, dns.rdatatype.CNAME
+                        )
                         cnames.append(crrset)
                         min_ttl = min(min_ttl, crrset.ttl)
                         for rd in crrset:
@@ -819,9 +958,9 @@ class QueryMessage(Message):
                 # Look for an SOA RR whose owner name is a superdomain
                 # of qname.
                 try:
-                    srrset = self.find_rrset(self.authority, auname,
-                                             question.rdclass,
-                                             dns.rdatatype.SOA)
+                    srrset = self.find_rrset(
+                        self.authority, auname, question.rdclass, dns.rdatatype.SOA
+                    )
                     min_ttl = min(min_ttl, srrset.ttl, srrset[0].minimum)
                     break
                 except KeyError:
@@ -831,7 +970,7 @@ class QueryMessage(Message):
                         break
         return ChainingResult(qname, answer, min_ttl, cnames)
 
-    def canonical_name(self):
+    def canonical_name(self) -> dns.name.Name:
         """Return the canonical name of the first name in the question
         section.
 
@@ -885,9 +1024,17 @@ class _WireReader:
     raising them.
     """
 
-    def __init__(self, wire, initialize_message, question_only=False,
-                 one_rr_per_rrset=False, ignore_trailing=False,
-                 keyring=None, multi=False, continue_on_error=False):
+    def __init__(
+        self,
+        wire,
+        initialize_message,
+        question_only=False,
+        one_rr_per_rrset=False,
+        ignore_trailing=False,
+        keyring=None,
+        multi=False,
+        continue_on_error=False,
+    ):
         self.parser = dns.wire.Parser(wire)
         self.message = None
         self.initialize_message = initialize_message
@@ -903,16 +1050,17 @@ class _WireReader:
         """Read the next *qcount* records from the wire data and add them to
         the question section.
         """
-
+        assert self.message is not None
         section = self.message.sections[section_number]
         for _ in range(qcount):
             qname = self.parser.get_name(self.message.origin)
-            (rdtype, rdclass) = self.parser.get_struct('!HH')
-            (rdclass, rdtype, _, _) = \
-                self.message._parse_rr_header(section_number, qname, rdclass,
-                                              rdtype)
-            self.message.find_rrset(section, qname, rdclass, rdtype,
-                                    create=True, force_unique=True)
+            (rdtype, rdclass) = self.parser.get_struct("!HH")
+            (rdclass, rdtype, _, _) = self.message._parse_rr_header(
+                section_number, qname, rdclass, rdtype
+            )
+            self.message.find_rrset(
+                section, qname, rdclass, rdtype, create=True, force_unique=True
+            )
 
     def _add_error(self, e):
         self.errors.append(MessageError(e, self.parser.current))
@@ -924,7 +1072,7 @@ class _WireReader:
         section_number: the section of the message to which to add records
         count: the number of records to read
         """
-
+        assert self.message is not None
         section = self.message.sections[section_number]
         force_unique = self.one_rr_per_rrset
         for i in range(count):
@@ -934,18 +1082,22 @@ class _WireReader:
                 name = absolute_name.relativize(self.message.origin)
             else:
                 name = absolute_name
-            (rdtype, rdclass, ttl, rdlen) = self.parser.get_struct('!HHIH')
+            (rdtype, rdclass, ttl, rdlen) = self.parser.get_struct("!HHIH")
             if rdtype in (dns.rdatatype.OPT, dns.rdatatype.TSIG):
-                (rdclass, rdtype, deleting, empty) = \
-                    self.message._parse_special_rr_header(section_number,
-                                                          count, i, name,
-                                                          rdclass, rdtype)
+                (
+                    rdclass,
+                    rdtype,
+                    deleting,
+                    empty,
+                ) = self.message._parse_special_rr_header(
+                    section_number, count, i, name, rdclass, rdtype
+                )
             else:
-                (rdclass, rdtype, deleting, empty) = \
-                    self.message._parse_rr_header(section_number,
-                                                  name, rdclass, rdtype)
+                (rdclass, rdtype, deleting, empty) = self.message._parse_rr_header(
+                    section_number, name, rdclass, rdtype
+                )
+            rdata_start = self.parser.current
             try:
-                rdata_start = self.parser.current
                 if empty:
                     if rdlen > 0:
                         raise dns.exception.FormError
@@ -953,9 +1105,9 @@ class _WireReader:
                     covers = dns.rdatatype.NONE
                 else:
                     with self.parser.restrict_to(rdlen):
-                        rd = dns.rdata.from_wire_parser(rdclass, rdtype,
-                                                        self.parser,
-                                                        self.message.origin)
+                        rd = dns.rdata.from_wire_parser(
+                            rdclass, rdtype, self.parser, self.message.origin
+                        )
                     covers = rd.covers()
                 if self.message.xfr and rdtype == dns.rdatatype.SOA:
                     force_unique = True
@@ -963,8 +1115,7 @@ class _WireReader:
                     self.message.opt = dns.rrset.from_rdata(name, ttl, rd)
                 elif rdtype == dns.rdatatype.TSIG:
                     if self.keyring is None:
-                        raise UnknownTSIGKey('got signed message without '
-                                             'keyring')
+                        raise UnknownTSIGKey("got signed message without keyring")
                     if isinstance(self.keyring, dict):
                         key = self.keyring.get(absolute_name)
                         if isinstance(key, bytes):
@@ -976,25 +1127,31 @@ class _WireReader:
                     if key is None:
                         raise UnknownTSIGKey("key '%s' unknown" % name)
                     self.message.keyring = key
-                    self.message.tsig_ctx = \
-                        dns.tsig.validate(self.parser.wire,
-                                        key,
-                                        absolute_name,
-                                        rd,
-                                        int(time.time()),
-                                        self.message.request_mac,
-                                        rr_start,
-                                        self.message.tsig_ctx,
-                                        self.multi)
-                    self.message.tsig = dns.rrset.from_rdata(absolute_name, 0,
-                                                             rd)
+                    self.message.tsig_ctx = dns.tsig.validate(
+                        self.parser.wire,
+                        key,
+                        absolute_name,
+                        rd,
+                        int(time.time()),
+                        self.message.request_mac,
+                        rr_start,
+                        self.message.tsig_ctx,
+                        self.multi,
+                    )
+                    self.message.tsig = dns.rrset.from_rdata(absolute_name, 0, rd)
                 else:
-                    rrset = self.message.find_rrset(section, name,
-                                                    rdclass, rdtype, covers,
-                                                    deleting, True,
-                                                    force_unique)
+                    rrset = self.message.find_rrset(
+                        section,
+                        name,
+                        rdclass,
+                        rdtype,
+                        covers,
+                        deleting,
+                        True,
+                        force_unique,
+                    )
                     if rd is not None:
-                        if ttl > 0x7fffffff:
+                        if ttl > 0x7FFFFFFF:
                             ttl = 0
                         rrset.add(rd, ttl)
             except Exception as e:
@@ -1010,14 +1167,16 @@ class _WireReader:
 
         if self.parser.remaining() < 12:
             raise ShortHeader
-        (id, flags, qcount, ancount, aucount, adcount) = \
-            self.parser.get_struct('!HHHHHH')
+        (id, flags, qcount, ancount, aucount, adcount) = self.parser.get_struct(
+            "!HHHHHH"
+        )
         factory = _message_factory_from_opcode(dns.opcode.from_flags(flags))
         self.message = factory(id=id)
         self.message.flags = dns.flags.Flag(flags)
         self.initialize_message(self.message)
-        self.one_rr_per_rrset = \
-            self.message._get_one_rr_per_rrset(self.one_rr_per_rrset)
+        self.one_rr_per_rrset = self.message._get_one_rr_per_rrset(
+            self.one_rr_per_rrset
+        )
         try:
             self._get_question(MessageSection.QUESTION, qcount)
             if self.question_only:
@@ -1027,8 +1186,7 @@ class _WireReader:
             self._get_section(MessageSection.ADDITIONAL, adcount)
             if not self.ignore_trailing and self.parser.remaining() != 0:
                 raise TrailingJunk
-            if self.multi and self.message.tsig_ctx and \
-                not self.message.had_tsig:
+            if self.multi and self.message.tsig_ctx and not self.message.had_tsig:
                 self.message.tsig_ctx.update(self.parser.wire)
         except Exception as e:
             if self.continue_on_error:
@@ -1038,83 +1196,103 @@ class _WireReader:
         return self.message
 
 
-def from_wire(wire, keyring=None, request_mac=b'', xfr=False, origin=None,
-              tsig_ctx=None, multi=False,
-              question_only=False, one_rr_per_rrset=False,
-              ignore_trailing=False, raise_on_truncation=False,
-              continue_on_error=False):
+def from_wire(
+    wire: bytes,
+    keyring: Optional[Any] = None,
+    request_mac: Optional[bytes] = b"",
+    xfr: bool = False,
+    origin: Optional[dns.name.Name] = None,
+    tsig_ctx: Optional[Union[dns.tsig.HMACTSig, dns.tsig.GSSTSig]] = None,
+    multi: bool = False,
+    question_only: bool = False,
+    one_rr_per_rrset: bool = False,
+    ignore_trailing: bool = False,
+    raise_on_truncation: bool = False,
+    continue_on_error: bool = False,
+) -> Message:
     """Convert a DNS wire format message into a message object.
 
-    *keyring*, a ``dns.tsig.Key`` or ``dict``, the key or keyring to use if the
-    message is signed.
+    *keyring*, a ``dns.tsig.Key`` or ``dict``, the key or keyring to use if the message
+    is signed.
 
-    *request_mac*, a ``bytes``.  If the message is a response to a TSIG-signed
-    request, *request_mac* should be set to the MAC of that request.
+    *request_mac*, a ``bytes`` or ``None``.  If the message is a response to a
+    TSIG-signed request, *request_mac* should be set to the MAC of that request.
 
-    *xfr*, a ``bool``, should be set to ``True`` if this message is part of a
-    zone transfer.
+    *xfr*, a ``bool``, should be set to ``True`` if this message is part of a zone
+    transfer.
 
     *origin*, a ``dns.name.Name`` or ``None``.  If the message is part of a zone
-    transfer, *origin* should be the origin name of the zone.  If not ``None``,
-    names will be relativized to the origin.
+    transfer, *origin* should be the origin name of the zone.  If not ``None``, names
+    will be relativized to the origin.
 
-    *tsig_ctx*, a ``dns.tsig.HMACTSig`` or ``dns.tsig.GSSTSig`` object, the
-    ongoing TSIG context, used when validating zone transfers.
+    *tsig_ctx*, a ``dns.tsig.HMACTSig`` or ``dns.tsig.GSSTSig`` object, the ongoing TSIG
+    context, used when validating zone transfers.
 
-    *multi*, a ``bool``, should be set to ``True`` if this message is part of a
-    multiple message sequence.
+    *multi*, a ``bool``, should be set to ``True`` if this message is part of a multiple
+    message sequence.
 
-    *question_only*, a ``bool``.  If ``True``, read only up to the end of the
-    question section.
+    *question_only*, a ``bool``.  If ``True``, read only up to the end of the question
+    section.
 
-    *one_rr_per_rrset*, a ``bool``.  If ``True``, put each RR into its own
-    RRset.
+    *one_rr_per_rrset*, a ``bool``.  If ``True``, put each RR into its own RRset.
 
-    *ignore_trailing*, a ``bool``.  If ``True``, ignore trailing junk at end of
-    the message.
+    *ignore_trailing*, a ``bool``.  If ``True``, ignore trailing junk at end of the
+    message.
 
-    *raise_on_truncation*, a ``bool``.  If ``True``, raise an exception if the
-    TC bit is set.
+    *raise_on_truncation*, a ``bool``.  If ``True``, raise an exception if the TC bit is
+    set.
 
-    *continue_on_error*, a ``bool``.  If ``True``, try to continue parsing even
-    if errors occur.  Erroneous rdata will be ignored.  Errors will be
-    accumulated as a list of MessageError objects in the message's ``errors``
-    attribute.  This option is recommended only for DNS analysis tools, or for
-    use in a server as part of an error handling path.  The default is
-    ``False``.
+    *continue_on_error*, a ``bool``.  If ``True``, try to continue parsing even if
+    errors occur.  Erroneous rdata will be ignored.  Errors will be accumulated as a
+    list of MessageError objects in the message's ``errors`` attribute.  This option is
+    recommended only for DNS analysis tools, or for use in a server as part of an error
+    handling path.  The default is ``False``.
 
-    Raises ``dns.message.ShortHeader`` if the message is less than 12 octets
-    long.
+    Raises ``dns.message.ShortHeader`` if the message is less than 12 octets long.
 
-    Raises ``dns.message.TrailingJunk`` if there were octets in the message past
-    the end of the proper DNS message, and *ignore_trailing* is ``False``.
+    Raises ``dns.message.TrailingJunk`` if there were octets in the message past the end
+    of the proper DNS message, and *ignore_trailing* is ``False``.
 
     Raises ``dns.message.BadEDNS`` if an OPT record was in the wrong section, or
     occurred more than once.
 
-    Raises ``dns.message.BadTSIG`` if a TSIG record was not the last record of
-    the additional data section.
+    Raises ``dns.message.BadTSIG`` if a TSIG record was not the last record of the
+    additional data section.
 
-    Raises ``dns.message.Truncated`` if the TC flag is set and
-    *raise_on_truncation* is ``True``.
+    Raises ``dns.message.Truncated`` if the TC flag is set and *raise_on_truncation* is
+    ``True``.
 
     Returns a ``dns.message.Message``.
     """
 
+    # We permit None for request_mac solely for backwards compatibility
+    if request_mac is None:
+        request_mac = b""
+
     def initialize_message(message):
         message.request_mac = request_mac
         message.xfr = xfr
         message.origin = origin
         message.tsig_ctx = tsig_ctx
 
-    reader = _WireReader(wire, initialize_message, question_only,
-                         one_rr_per_rrset, ignore_trailing, keyring, multi,
-                         continue_on_error)
+    reader = _WireReader(
+        wire,
+        initialize_message,
+        question_only,
+        one_rr_per_rrset,
+        ignore_trailing,
+        keyring,
+        multi,
+        continue_on_error,
+    )
     try:
         m = reader.read()
     except dns.exception.FormError:
-        if reader.message and (reader.message.flags & dns.flags.TC) and \
-           raise_on_truncation:
+        if (
+            reader.message
+            and (reader.message.flags & dns.flags.TC)
+            and raise_on_truncation
+        ):
             raise Truncated(message=reader.message)
         else:
             raise
@@ -1142,8 +1320,15 @@ class _TextReader:
     relativize_to: the origin to relativize to.
     """
 
-    def __init__(self, text, idna_codec, one_rr_per_rrset=False,
-                 origin=None, relativize=True, relativize_to=None):
+    def __init__(
+        self,
+        text,
+        idna_codec,
+        one_rr_per_rrset=False,
+        origin=None,
+        relativize=True,
+        relativize_to=None,
+    ):
         self.message = None
         self.tok = dns.tokenizer.Tokenizer(text, idna_codec=idna_codec)
         self.last_name = None
@@ -1164,19 +1349,19 @@ class _TextReader:
 
         token = self.tok.get()
         what = token.value
-        if what == 'id':
+        if what == "id":
             self.id = self.tok.get_int()
-        elif what == 'flags':
+        elif what == "flags":
             while True:
                 token = self.tok.get()
                 if not token.is_identifier():
                     self.tok.unget(token)
                     break
                 self.flags = self.flags | dns.flags.from_text(token.value)
-        elif what == 'edns':
+        elif what == "edns":
             self.edns = self.tok.get_int()
             self.ednsflags = self.ednsflags | (self.edns << 16)
-        elif what == 'eflags':
+        elif what == "eflags":
             if self.edns < 0:
                 self.edns = 0
             while True:
@@ -1184,17 +1369,16 @@ class _TextReader:
                 if not token.is_identifier():
                     self.tok.unget(token)
                     break
-                self.ednsflags = self.ednsflags | \
-                    dns.flags.edns_from_text(token.value)
-        elif what == 'payload':
+                self.ednsflags = self.ednsflags | dns.flags.edns_from_text(token.value)
+        elif what == "payload":
             self.payload = self.tok.get_int()
             if self.edns < 0:
                 self.edns = 0
-        elif what == 'opcode':
+        elif what == "opcode":
             text = self.tok.get_string()
             self.opcode = dns.opcode.from_text(text)
             self.flags = self.flags | dns.opcode.to_flags(self.opcode)
-        elif what == 'rcode':
+        elif what == "rcode":
             text = self.tok.get_string()
             self.rcode = dns.rcode.from_text(text)
         else:
@@ -1207,9 +1391,9 @@ class _TextReader:
         section = self.message.sections[section_number]
         token = self.tok.get(want_leading=True)
         if not token.is_whitespace():
-            self.last_name = self.tok.as_name(token, self.message.origin,
-                                              self.relativize,
-                                              self.relativize_to)
+            self.last_name = self.tok.as_name(
+                token, self.message.origin, self.relativize, self.relativize_to
+            )
         name = self.last_name
         if name is None:
             raise NoPreviousName
@@ -1228,10 +1412,12 @@ class _TextReader:
             rdclass = dns.rdataclass.IN
         # Type
         rdtype = dns.rdatatype.from_text(token.value)
-        (rdclass, rdtype, _, _) = \
-            self.message._parse_rr_header(section_number, name, rdclass, rdtype)
-        self.message.find_rrset(section, name, rdclass, rdtype, create=True,
-                                force_unique=True)
+        (rdclass, rdtype, _, _) = self.message._parse_rr_header(
+            section_number, name, rdclass, rdtype
+        )
+        self.message.find_rrset(
+            section, name, rdclass, rdtype, create=True, force_unique=True
+        )
         self.tok.get_eol()
 
     def _rr_line(self, section_number):
@@ -1243,9 +1429,9 @@ class _TextReader:
         # Name
         token = self.tok.get(want_leading=True)
         if not token.is_whitespace():
-            self.last_name = self.tok.as_name(token, self.message.origin,
-                                              self.relativize,
-                                              self.relativize_to)
+            self.last_name = self.tok.as_name(
+                token, self.message.origin, self.relativize, self.relativize_to
+            )
         name = self.last_name
         if name is None:
             raise NoPreviousName
@@ -1274,8 +1460,9 @@ class _TextReader:
             rdclass = dns.rdataclass.IN
         # Type
         rdtype = dns.rdatatype.from_text(token.value)
-        (rdclass, rdtype, deleting, empty) = \
-            self.message._parse_rr_header(section_number, name, rdclass, rdtype)
+        (rdclass, rdtype, deleting, empty) = self.message._parse_rr_header(
+            section_number, name, rdclass, rdtype
+        )
         token = self.tok.get()
         if empty and not token.is_eol_or_eof():
             raise dns.exception.SyntaxError
@@ -1283,16 +1470,28 @@ class _TextReader:
             raise dns.exception.UnexpectedEnd
         if not token.is_eol_or_eof():
             self.tok.unget(token)
-            rd = dns.rdata.from_text(rdclass, rdtype, self.tok,
-                                     self.message.origin, self.relativize,
-                                     self.relativize_to)
+            rd = dns.rdata.from_text(
+                rdclass,
+                rdtype,
+                self.tok,
+                self.message.origin,
+                self.relativize,
+                self.relativize_to,
+            )
             covers = rd.covers()
         else:
             rd = None
             covers = dns.rdatatype.NONE
-        rrset = self.message.find_rrset(section, name,
-                                        rdclass, rdtype, covers,
-                                        deleting, True, self.one_rr_per_rrset)
+        rrset = self.message.find_rrset(
+            section,
+            name,
+            rdclass,
+            rdtype,
+            covers,
+            deleting,
+            True,
+            self.one_rr_per_rrset,
+        )
         if rd is not None:
             rrset.add(rd, ttl)
 
@@ -1320,7 +1519,7 @@ class _TextReader:
                 break
             if token.is_comment():
                 u = token.value.upper()
-                if u == 'HEADER':
+                if u == "HEADER":
                     line_method = self._header_line
 
                 if self.message:
@@ -1335,8 +1534,9 @@ class _TextReader:
                     # use the one we just created.
                     if not self.message:
                         self.message = message
-                        self.one_rr_per_rrset = \
-                            message._get_one_rr_per_rrset(self.one_rr_per_rrset)
+                        self.one_rr_per_rrset = message._get_one_rr_per_rrset(
+                            self.one_rr_per_rrset
+                        )
                     if section_number == MessageSection.QUESTION:
                         line_method = self._question_line
                     else:
@@ -1353,8 +1553,14 @@ class _TextReader:
         return self.message
 
 
-def from_text(text, idna_codec=None, one_rr_per_rrset=False,
-              origin=None, relativize=True, relativize_to=None):
+def from_text(
+    text: str,
+    idna_codec: Optional[dns.name.IDNACodec] = None,
+    one_rr_per_rrset: bool = False,
+    origin: Optional[dns.name.Name] = None,
+    relativize: bool = True,
+    relativize_to: Optional[dns.name.Name] = None,
+) -> Message:
     """Convert the text format message into a message object.
 
     The reader stops after reading the first blank line in the input to
@@ -1389,12 +1595,17 @@ def from_text(text, idna_codec=None, one_rr_per_rrset=False,
     # since it's an implementation detail.  The official file
     # interface is from_file().
 
-    reader = _TextReader(text, idna_codec, one_rr_per_rrset, origin,
-                         relativize, relativize_to)
+    reader = _TextReader(
+        text, idna_codec, one_rr_per_rrset, origin, relativize, relativize_to
+    )
     return reader.read()
 
 
-def from_file(f, idna_codec=None, one_rr_per_rrset=False):
+def from_file(
+    f: Any,
+    idna_codec: Optional[dns.name.IDNACodec] = None,
+    one_rr_per_rrset: bool = False,
+) -> Message:
     """Read the next text format message from the specified file.
 
     Message blocks are separated by a single blank line.
@@ -1416,16 +1627,30 @@ def from_file(f, idna_codec=None, one_rr_per_rrset=False):
     Returns a ``dns.message.Message object``
     """
 
-    with contextlib.ExitStack() as stack:
-        if isinstance(f, str):
-            f = stack.enter_context(open(f))
+    if isinstance(f, str):
+        cm: contextlib.AbstractContextManager = open(f)
+    else:
+        cm = contextlib.nullcontext(f)
+    with cm as f:
         return from_text(f, idna_codec, one_rr_per_rrset)
+    assert False  # for mypy  lgtm[py/unreachable-statement]
 
 
-def make_query(qname, rdtype, rdclass=dns.rdataclass.IN, use_edns=None,
-               want_dnssec=False, ednsflags=None, payload=None,
-               request_payload=None, options=None, idna_codec=None,
-               id=None, flags=dns.flags.RD):
+def make_query(
+    qname: Union[dns.name.Name, str],
+    rdtype: Union[dns.rdatatype.RdataType, str],
+    rdclass: Union[dns.rdataclass.RdataClass, str] = dns.rdataclass.IN,
+    use_edns: Optional[Union[int, bool]] = None,
+    want_dnssec: bool = False,
+    ednsflags: Optional[int] = None,
+    payload: Optional[int] = None,
+    request_payload: Optional[int] = None,
+    options: Optional[List[dns.edns.Option]] = None,
+    idna_codec: Optional[dns.name.IDNACodec] = None,
+    id: Optional[int] = None,
+    flags: int = dns.flags.RD,
+    pad: int = 0,
+) -> QueryMessage:
     """Make a query message.
 
     The query name, type, and class may all be specified either
@@ -1473,39 +1698,51 @@ def make_query(qname, rdtype, rdclass=dns.rdataclass.IN, use_edns=None,
     *flags*, an ``int``, the desired query flags.  The default is
     ``dns.flags.RD``.
 
+    *pad*, a non-negative ``int``.  If 0, the default, do not pad; otherwise add
+    padding bytes to make the message size a multiple of *pad*.  Note that if
+    padding is non-zero, an EDNS PADDING option will always be added to the
+    message.
+
     Returns a ``dns.message.QueryMessage``
     """
 
     if isinstance(qname, str):
         qname = dns.name.from_text(qname, idna_codec=idna_codec)
-    rdtype = dns.rdatatype.RdataType.make(rdtype)
-    rdclass = dns.rdataclass.RdataClass.make(rdclass)
+    the_rdtype = dns.rdatatype.RdataType.make(rdtype)
+    the_rdclass = dns.rdataclass.RdataClass.make(rdclass)
     m = QueryMessage(id=id)
     m.flags = dns.flags.Flag(flags)
-    m.find_rrset(m.question, qname, rdclass, rdtype, create=True,
-                 force_unique=True)
+    m.find_rrset(
+        m.question, qname, the_rdclass, the_rdtype, create=True, force_unique=True
+    )
     # only pass keywords on to use_edns if they have been set to a
     # non-None value.  Setting a field will turn EDNS on if it hasn't
     # been configured.
-    kwargs = {}
+    kwargs: Dict[str, Any] = {}
     if ednsflags is not None:
-        kwargs['ednsflags'] = ednsflags
+        kwargs["ednsflags"] = ednsflags
     if payload is not None:
-        kwargs['payload'] = payload
+        kwargs["payload"] = payload
     if request_payload is not None:
-        kwargs['request_payload'] = request_payload
+        kwargs["request_payload"] = request_payload
     if options is not None:
-        kwargs['options'] = options
+        kwargs["options"] = options
     if kwargs and use_edns is None:
         use_edns = 0
-    kwargs['edns'] = use_edns
+    kwargs["edns"] = use_edns
+    kwargs["pad"] = pad
     m.use_edns(**kwargs)
     m.want_dnssec(want_dnssec)
     return m
 
 
-def make_response(query, recursion_available=False, our_payload=8192,
-                  fudge=300, tsig_error=0):
+def make_response(
+    query: Message,
+    recursion_available: bool = False,
+    our_payload: int = 8192,
+    fudge: int = 300,
+    tsig_error: int = 0,
+) -> Message:
     """Make a message which is a response for the specified query.
     The message returned is really a response skeleton; it has all
     of the infrastructure required of a response, but none of the
@@ -1532,7 +1769,7 @@ def make_response(query, recursion_available=False, our_payload=8192,
     """
 
     if query.flags & dns.flags.QR:
-        raise dns.exception.FormError('specified query message is not a query')
+        raise dns.exception.FormError("specified query message is not a query")
     factory = _message_factory_from_opcode(query.opcode())
     response = factory(id=query.id)
     response.flags = dns.flags.QR | (query.flags & dns.flags.RD)
@@ -1543,11 +1780,19 @@ def make_response(query, recursion_available=False, our_payload=8192,
     if query.edns >= 0:
         response.use_edns(0, 0, our_payload, query.payload)
     if query.had_tsig:
-        response.use_tsig(query.keyring, query.keyname, fudge, None,
-                          tsig_error, b'', query.keyalgorithm)
+        response.use_tsig(
+            query.keyring,
+            query.keyname,
+            fudge,
+            None,
+            tsig_error,
+            b"",
+            query.keyalgorithm,
+        )
         response.request_mac = query.mac
     return response
 
+
 ### BEGIN generated MessageSection constants
 
 QUESTION = MessageSection.QUESTION
diff --git a/lib/dns/message.pyi b/lib/dns/message.pyi
deleted file mode 100644
index 252a4118..00000000
--- a/lib/dns/message.pyi
+++ /dev/null
@@ -1,47 +0,0 @@
-from typing import Optional, Dict, List, Tuple, Union
-from . import name, rrset, tsig, rdatatype, entropy, edns, rdataclass, rcode
-import hmac
-
-class Message:
-    def to_wire(self, origin : Optional[name.Name]=None, max_size=0, **kw) -> bytes:
-        ...
-    def find_rrset(self, section : List[rrset.RRset], name : name.Name, rdclass : int, rdtype : int,
-                   covers=rdatatype.NONE, deleting : Optional[int]=None, create=False,
-                   force_unique=False) -> rrset.RRset:
-        ...
-    def __init__(self, id : Optional[int] =None) -> None:
-        self.id : int
-        self.flags = 0
-        self.sections : List[List[rrset.RRset]] = [[], [], [], []]
-        self.opt : rrset.RRset = None
-        self.request_payload = 0
-        self.keyring = None
-        self.tsig : rrset.RRset = None
-        self.request_mac = b''
-        self.xfr = False
-        self.origin = None
-        self.tsig_ctx = None
-        self.index : Dict[Tuple[rrset.RRset, name.Name, int, int, Union[int,str], int], rrset.RRset] = {}
-
-    def is_response(self, other : Message) -> bool:
-        ...
-
-    def set_rcode(self, rcode : rcode.Rcode):
-        ...
-
-def from_text(a : str, idna_codec : Optional[name.IDNACodec] = None) -> Message:
-    ...
-
-def from_wire(wire, keyring : Optional[Dict[name.Name,bytes]] = None, request_mac = b'', xfr=False, origin=None,
-              tsig_ctx : Optional[Union[dns.tsig.HMACTSig, dns.tsig.GSSTSig]] = None, multi=False,
-              question_only=False, one_rr_per_rrset=False,
-              ignore_trailing=False) -> Message:
-    ...
-def make_response(query : Message, recursion_available=False, our_payload=8192,
-                  fudge=300) -> Message:
-    ...
-
-def make_query(qname : Union[name.Name,str], rdtype : Union[str,int], rdclass : Union[int,str] =rdataclass.IN, use_edns : Optional[bool] = None,
-               want_dnssec=False, ednsflags : Optional[int] = None, payload : Optional[int] = None,
-               request_payload : Optional[int] = None, options : Optional[List[edns.Option]] = None) -> Message:
-    ...
diff --git a/lib/dns/name.py b/lib/dns/name.py
index 8905d70f..612af021 100644
--- a/lib/dns/name.py
+++ b/lib/dns/name.py
@@ -18,32 +18,61 @@
 """DNS Names.
 """
 
+from typing import Any, Dict, Iterable, Optional, Tuple, Union
+
 import copy
 import struct
 
-import encodings.idna    # type: ignore
+import encodings.idna  # type: ignore
+
 try:
-    import idna          # type: ignore
+    import idna  # type: ignore
+
     have_idna_2008 = True
 except ImportError:  # pragma: no cover
     have_idna_2008 = False
 
+import dns.enum
 import dns.wire
 import dns.exception
 import dns.immutable
 
-# fullcompare() result values
 
-#: The compared names have no relationship to each other.
-NAMERELN_NONE = 0
-#: the first name is a superdomain of the second.
-NAMERELN_SUPERDOMAIN = 1
-#: The first name is a subdomain of the second.
-NAMERELN_SUBDOMAIN = 2
-#: The compared names are equal.
-NAMERELN_EQUAL = 3
-#: The compared names have a common ancestor.
-NAMERELN_COMMONANCESTOR = 4
+CompressType = Dict["Name", int]
+
+
+class NameRelation(dns.enum.IntEnum):
+    """Name relation result from fullcompare()."""
+
+    # This is an IntEnum for backwards compatibility in case anyone
+    # has hardwired the constants.
+
+    #: The compared names have no relationship to each other.
+    NONE = 0
+    #: the first name is a superdomain of the second.
+    SUPERDOMAIN = 1
+    #: The first name is a subdomain of the second.
+    SUBDOMAIN = 2
+    #: The compared names are equal.
+    EQUAL = 3
+    #: The compared names have a common ancestor.
+    COMMONANCESTOR = 4
+
+    @classmethod
+    def _maximum(cls):
+        return cls.COMMONANCESTOR
+
+    @classmethod
+    def _short_name(cls):
+        return cls.__name__
+
+
+# Backwards compatibility
+NAMERELN_NONE = NameRelation.NONE
+NAMERELN_SUPERDOMAIN = NameRelation.SUPERDOMAIN
+NAMERELN_SUBDOMAIN = NameRelation.SUBDOMAIN
+NAMERELN_EQUAL = NameRelation.EQUAL
+NAMERELN_COMMONANCESTOR = NameRelation.COMMONANCESTOR
 
 
 class EmptyLabel(dns.exception.SyntaxError):
@@ -84,6 +113,7 @@ class NoParent(dns.exception.DNSException):
     """An attempt was made to get the parent of the root name
     or the empty name."""
 
+
 class NoIDNA2008(dns.exception.DNSException):
     """IDNA 2008 processing was requested but the idna module is not
     available."""
@@ -92,9 +122,47 @@ class NoIDNA2008(dns.exception.DNSException):
 class IDNAException(dns.exception.DNSException):
     """IDNA processing raised an exception."""
 
-    supp_kwargs = {'idna_exception'}
+    supp_kwargs = {"idna_exception"}
     fmt = "IDNA processing exception: {idna_exception}"
 
+    # We do this as otherwise mypy complains about unexpected keyword argument
+    # idna_exception
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+
+
+_escaped = b'"().;\\@$'
+_escaped_text = '"().;\\@$'
+
+
+def _escapify(label: Union[bytes, str]) -> str:
+    """Escape the characters in label which need it.
+    @returns: the escaped string
+    @rtype: string"""
+    if isinstance(label, bytes):
+        # Ordinary DNS label mode.  Escape special characters and values
+        # < 0x20 or > 0x7f.
+        text = ""
+        for c in label:
+            if c in _escaped:
+                text += "\\" + chr(c)
+            elif c > 0x20 and c < 0x7F:
+                text += chr(c)
+            else:
+                text += "\\%03d" % c
+        return text
+
+    # Unicode label mode.  Escape only special characters and values < 0x20
+    text = ""
+    for uc in label:
+        if uc in _escaped_text:
+            text += "\\" + uc
+        elif uc <= "\x20":
+            text += "\\%03d" % ord(uc)
+        else:
+            text += uc
+    return text
+
 
 class IDNACodec:
     """Abstract base class for IDNA encoder/decoders."""
@@ -102,26 +170,28 @@ class IDNACodec:
     def __init__(self):
         pass
 
-    def is_idna(self, label):
-        return label.lower().startswith(b'xn--')
+    def is_idna(self, label: bytes) -> bool:
+        return label.lower().startswith(b"xn--")
 
-    def encode(self, label):
+    def encode(self, label: str) -> bytes:
         raise NotImplementedError  # pragma: no cover
 
-    def decode(self, label):
+    def decode(self, label: bytes) -> str:
         # We do not apply any IDNA policy on decode.
         if self.is_idna(label):
             try:
-                label = label[4:].decode('punycode')
+                slabel = label[4:].decode("punycode")
+                return _escapify(slabel)
             except Exception as e:
                 raise IDNAException(idna_exception=e)
-        return _escapify(label)
+        else:
+            return _escapify(label)
 
 
 class IDNA2003Codec(IDNACodec):
     """IDNA 2003 encoder/decoder."""
 
-    def __init__(self, strict_decode=False):
+    def __init__(self, strict_decode: bool = False):
         """Initialize the IDNA 2003 encoder/decoder.
 
         *strict_decode* is a ``bool``. If `True`, then IDNA2003 checking
@@ -132,22 +202,22 @@ class IDNA2003Codec(IDNACodec):
         super().__init__()
         self.strict_decode = strict_decode
 
-    def encode(self, label):
+    def encode(self, label: str) -> bytes:
         """Encode *label*."""
 
-        if label == '':
-            return b''
+        if label == "":
+            return b""
         try:
             return encodings.idna.ToASCII(label)
         except UnicodeError:
             raise LabelTooLong
 
-    def decode(self, label):
+    def decode(self, label: bytes) -> str:
         """Decode *label*."""
         if not self.strict_decode:
             return super().decode(label)
-        if label == b'':
-            return ''
+        if label == b"":
+            return ""
         try:
             return _escapify(encodings.idna.ToUnicode(label))
         except Exception as e:
@@ -155,16 +225,20 @@ class IDNA2003Codec(IDNACodec):
 
 
 class IDNA2008Codec(IDNACodec):
-    """IDNA 2008 encoder/decoder.
-    """
+    """IDNA 2008 encoder/decoder."""
 
-    def __init__(self, uts_46=False, transitional=False,
-                 allow_pure_ascii=False, strict_decode=False):
+    def __init__(
+        self,
+        uts_46: bool = False,
+        transitional: bool = False,
+        allow_pure_ascii: bool = False,
+        strict_decode: bool = False,
+    ):
         """Initialize the IDNA 2008 encoder/decoder.
 
         *uts_46* is a ``bool``.  If True, apply Unicode IDNA
         compatibility processing as described in Unicode Technical
-        Standard #46 (http://unicode.org/reports/tr46/).
+        Standard #46 (https://unicode.org/reports/tr46/).
         If False, do not apply the mapping.  The default is False.
 
         *transitional* is a ``bool``: If True, use the
@@ -188,11 +262,11 @@ class IDNA2008Codec(IDNACodec):
         self.allow_pure_ascii = allow_pure_ascii
         self.strict_decode = strict_decode
 
-    def encode(self, label):
-        if label == '':
-            return b''
+    def encode(self, label: str) -> bytes:
+        if label == "":
+            return b""
         if self.allow_pure_ascii and is_all_ascii(label):
-            encoded = label.encode('ascii')
+            encoded = label.encode("ascii")
             if len(encoded) > 63:
                 raise LabelTooLong
             return encoded
@@ -203,16 +277,16 @@ class IDNA2008Codec(IDNACodec):
                 label = idna.uts46_remap(label, False, self.transitional)
             return idna.alabel(label)
         except idna.IDNAError as e:
-            if e.args[0] == 'Label too long':
+            if e.args[0] == "Label too long":
                 raise LabelTooLong
             else:
                 raise IDNAException(idna_exception=e)
 
-    def decode(self, label):
+    def decode(self, label: bytes) -> str:
         if not self.strict_decode:
             return super().decode(label)
-        if label == b'':
-            return ''
+        if label == b"":
+            return ""
         if not have_idna_2008:
             raise NoIDNA2008
         try:
@@ -223,8 +297,6 @@ class IDNA2008Codec(IDNACodec):
         except (idna.IDNAError, UnicodeError) as e:
             raise IDNAException(idna_exception=e)
 
-_escaped = b'"().;\\@$'
-_escaped_text = '"().;\\@$'
 
 IDNA_2003_Practical = IDNA2003Codec(False)
 IDNA_2003_Strict = IDNA2003Codec(True)
@@ -235,35 +307,8 @@ IDNA_2008_Strict = IDNA2008Codec(False, False, False, True)
 IDNA_2008_Transitional = IDNA2008Codec(True, True, False, False)
 IDNA_2008 = IDNA_2008_Practical
 
-def _escapify(label):
-    """Escape the characters in label which need it.
-    @returns: the escaped string
-    @rtype: string"""
-    if isinstance(label, bytes):
-        # Ordinary DNS label mode.  Escape special characters and values
-        # < 0x20 or > 0x7f.
-        text = ''
-        for c in label:
-            if c in _escaped:
-                text += '\\' + chr(c)
-            elif c > 0x20 and c < 0x7F:
-                text += chr(c)
-            else:
-                text += '\\%03d' % c
-        return text
 
-    # Unicode label mode.  Escape only special characters and values < 0x20
-    text = ''
-    for c in label:
-        if c in _escaped_text:
-            text += '\\' + c
-        elif c <= '\x20':
-            text += '\\%03d' % ord(c)
-        else:
-            text += c
-    return text
-
-def _validate_labels(labels):
+def _validate_labels(labels: Tuple[bytes, ...]) -> None:
     """Check for empty labels in the middle of a label sequence,
     labels that are too long, and for too many labels.
 
@@ -284,7 +329,7 @@ def _validate_labels(labels):
         total += ll + 1
         if ll > 63:
             raise LabelTooLong
-        if i < 0 and label == b'':
+        if i < 0 and label == b"":
             i = j
         j += 1
     if total > 255:
@@ -293,7 +338,7 @@ def _validate_labels(labels):
         raise EmptyLabel
 
 
-def _maybe_convert_to_binary(label):
+def _maybe_convert_to_binary(label: Union[bytes, str]) -> bytes:
     """If label is ``str``, convert it to ``bytes``.  If it is already
     ``bytes`` just return it.
 
@@ -316,14 +361,13 @@ class Name:
     of the class are immutable.
     """
 
-    __slots__ = ['labels']
+    __slots__ = ["labels"]
 
-    def __init__(self, labels):
-        """*labels* is any iterable whose values are ``str`` or ``bytes``.
-        """
+    def __init__(self, labels: Iterable[Union[bytes, str]]):
+        """*labels* is any iterable whose values are ``str`` or ``bytes``."""
 
-        labels = [_maybe_convert_to_binary(x) for x in labels]
-        self.labels = tuple(labels)
+        blabels = [_maybe_convert_to_binary(x) for x in labels]
+        self.labels = tuple(blabels)
         _validate_labels(self.labels)
 
     def __copy__(self):
@@ -334,29 +378,29 @@ class Name:
 
     def __getstate__(self):
         # Names can be pickled
-        return {'labels': self.labels}
+        return {"labels": self.labels}
 
     def __setstate__(self, state):
-        super().__setattr__('labels', state['labels'])
+        super().__setattr__("labels", state["labels"])
         _validate_labels(self.labels)
 
-    def is_absolute(self):
+    def is_absolute(self) -> bool:
         """Is the most significant label of this name the root label?
 
         Returns a ``bool``.
         """
 
-        return len(self.labels) > 0 and self.labels[-1] == b''
+        return len(self.labels) > 0 and self.labels[-1] == b""
 
-    def is_wild(self):
+    def is_wild(self) -> bool:
         """Is this name wild?  (I.e. Is the least significant label '*'?)
 
         Returns a ``bool``.
         """
 
-        return len(self.labels) > 0 and self.labels[0] == b'*'
+        return len(self.labels) > 0 and self.labels[0] == b"*"
 
-    def __hash__(self):
+    def __hash__(self) -> int:
         """Return a case-insensitive hash of the name.
 
         Returns an ``int``.
@@ -368,14 +412,14 @@ class Name:
                 h += (h << 3) + c
         return h
 
-    def fullcompare(self, other):
+    def fullcompare(self, other: "Name") -> Tuple[NameRelation, int, int]:
         """Compare two names, returning a 3-tuple
         ``(relation, order, nlabels)``.
 
         *relation* describes the relation ship between the names,
-        and is one of: ``dns.name.NAMERELN_NONE``,
-        ``dns.name.NAMERELN_SUPERDOMAIN``, ``dns.name.NAMERELN_SUBDOMAIN``,
-        ``dns.name.NAMERELN_EQUAL``, or ``dns.name.NAMERELN_COMMONANCESTOR``.
+        and is one of: ``dns.name.NameRelation.NONE``,
+        ``dns.name.NameRelation.SUPERDOMAIN``, ``dns.name.NameRelation.SUBDOMAIN``,
+        ``dns.name.NameRelation.EQUAL``, or ``dns.name.NameRelation.COMMONANCESTOR``.
 
         *order* is < 0 if *self* < *other*, > 0 if *self* > *other*, and ==
         0 if *self* == *other*.  A relative name is always less than an
@@ -404,9 +448,9 @@ class Name:
         oabs = other.is_absolute()
         if sabs != oabs:
             if sabs:
-                return (NAMERELN_NONE, 1, 0)
+                return (NameRelation.NONE, 1, 0)
             else:
-                return (NAMERELN_NONE, -1, 0)
+                return (NameRelation.NONE, -1, 0)
         l1 = len(self.labels)
         l2 = len(other.labels)
         ldiff = l1 - l2
@@ -417,7 +461,7 @@ class Name:
 
         order = 0
         nlabels = 0
-        namereln = NAMERELN_NONE
+        namereln = NameRelation.NONE
         while l > 0:
             l -= 1
             l1 -= 1
@@ -427,52 +471,52 @@ class Name:
             if label1 < label2:
                 order = -1
                 if nlabels > 0:
-                    namereln = NAMERELN_COMMONANCESTOR
+                    namereln = NameRelation.COMMONANCESTOR
                 return (namereln, order, nlabels)
             elif label1 > label2:
                 order = 1
                 if nlabels > 0:
-                    namereln = NAMERELN_COMMONANCESTOR
+                    namereln = NameRelation.COMMONANCESTOR
                 return (namereln, order, nlabels)
             nlabels += 1
         order = ldiff
         if ldiff < 0:
-            namereln = NAMERELN_SUPERDOMAIN
+            namereln = NameRelation.SUPERDOMAIN
         elif ldiff > 0:
-            namereln = NAMERELN_SUBDOMAIN
+            namereln = NameRelation.SUBDOMAIN
         else:
-            namereln = NAMERELN_EQUAL
+            namereln = NameRelation.EQUAL
         return (namereln, order, nlabels)
 
-    def is_subdomain(self, other):
+    def is_subdomain(self, other: "Name") -> bool:
         """Is self a subdomain of other?
 
         Note that the notion of subdomain includes equality, e.g.
-        "dnpython.org" is a subdomain of itself.
+        "dnspython.org" is a subdomain of itself.
 
         Returns a ``bool``.
         """
 
         (nr, _, _) = self.fullcompare(other)
-        if nr == NAMERELN_SUBDOMAIN or nr == NAMERELN_EQUAL:
+        if nr == NameRelation.SUBDOMAIN or nr == NameRelation.EQUAL:
             return True
         return False
 
-    def is_superdomain(self, other):
+    def is_superdomain(self, other: "Name") -> bool:
         """Is self a superdomain of other?
 
         Note that the notion of superdomain includes equality, e.g.
-        "dnpython.org" is a superdomain of itself.
+        "dnspython.org" is a superdomain of itself.
 
         Returns a ``bool``.
         """
 
         (nr, _, _) = self.fullcompare(other)
-        if nr == NAMERELN_SUPERDOMAIN or nr == NAMERELN_EQUAL:
+        if nr == NameRelation.SUPERDOMAIN or nr == NameRelation.EQUAL:
             return True
         return False
 
-    def canonicalize(self):
+    def canonicalize(self) -> "Name":
         """Return a name which is equal to the current name, but is in
         DNSSEC canonical form.
         """
@@ -516,12 +560,12 @@ class Name:
             return NotImplemented
 
     def __repr__(self):
-        return '<DNS name ' + self.__str__() + '>'
+        return "<DNS name " + self.__str__() + ">"
 
     def __str__(self):
         return self.to_text(False)
 
-    def to_text(self, omit_final_dot=False):
+    def to_text(self, omit_final_dot: bool = False) -> str:
         """Convert name to DNS text format.
 
         *omit_final_dot* is a ``bool``.  If True, don't emit the final
@@ -532,17 +576,19 @@ class Name:
         """
 
         if len(self.labels) == 0:
-            return '@'
-        if len(self.labels) == 1 and self.labels[0] == b'':
-            return '.'
+            return "@"
+        if len(self.labels) == 1 and self.labels[0] == b"":
+            return "."
         if omit_final_dot and self.is_absolute():
             l = self.labels[:-1]
         else:
             l = self.labels
-        s = '.'.join(map(_escapify, l))
+        s = ".".join(map(_escapify, l))
         return s
 
-    def to_unicode(self, omit_final_dot=False, idna_codec=None):
+    def to_unicode(
+        self, omit_final_dot: bool = False, idna_codec: Optional[IDNACodec] = None
+    ) -> str:
         """Convert name to Unicode text format.
 
         IDN ACE labels are converted to Unicode.
@@ -561,18 +607,18 @@ class Name:
         """
 
         if len(self.labels) == 0:
-            return '@'
-        if len(self.labels) == 1 and self.labels[0] == b'':
-            return '.'
+            return "@"
+        if len(self.labels) == 1 and self.labels[0] == b"":
+            return "."
         if omit_final_dot and self.is_absolute():
             l = self.labels[:-1]
         else:
             l = self.labels
         if idna_codec is None:
             idna_codec = IDNA_2003_Practical
-        return '.'.join([idna_codec.decode(x) for x in l])
+        return ".".join([idna_codec.decode(x) for x in l])
 
-    def to_digestable(self, origin=None):
+    def to_digestable(self, origin: Optional["Name"] = None) -> bytes:
         """Convert name to a format suitable for digesting in hashes.
 
         The name is canonicalized and converted to uncompressed wire
@@ -589,10 +635,17 @@ class Name:
         Returns a ``bytes``.
         """
 
-        return self.to_wire(origin=origin, canonicalize=True)
+        digest = self.to_wire(origin=origin, canonicalize=True)
+        assert digest is not None
+        return digest
 
-    def to_wire(self, file=None, compress=None, origin=None,
-                canonicalize=False):
+    def to_wire(
+        self,
+        file: Optional[Any] = None,
+        compress: Optional[CompressType] = None,
+        origin: Optional["Name"] = None,
+        canonicalize: bool = False,
+    ) -> Optional[bytes]:
         """Convert name to wire format, possibly compressing it.
 
         *file* is the file where the name is emitted (typically an
@@ -638,6 +691,7 @@ class Name:
                         out += label
             return bytes(out)
 
+        labels: Iterable[bytes]
         if not self.is_absolute():
             if origin is None or not origin.is_absolute():
                 raise NeedAbsoluteNameOrOrigin
@@ -654,24 +708,25 @@ class Name:
             else:
                 pos = None
             if pos is not None:
-                value = 0xc000 + pos
-                s = struct.pack('!H', value)
+                value = 0xC000 + pos
+                s = struct.pack("!H", value)
                 file.write(s)
                 break
             else:
                 if compress is not None and len(n) > 1:
                     pos = file.tell()
-                    if pos <= 0x3fff:
+                    if pos <= 0x3FFF:
                         compress[n] = pos
                 l = len(label)
-                file.write(struct.pack('!B', l))
+                file.write(struct.pack("!B", l))
                 if l > 0:
                     if canonicalize:
                         file.write(label.lower())
                     else:
                         file.write(label)
+        return None
 
-    def __len__(self):
+    def __len__(self) -> int:
         """The length of the name (in labels).
 
         Returns an ``int``.
@@ -688,7 +743,7 @@ class Name:
     def __sub__(self, other):
         return self.relativize(other)
 
-    def split(self, depth):
+    def split(self, depth: int) -> Tuple["Name", "Name"]:
         """Split a name into a prefix and suffix names at the specified depth.
 
         *depth* is an ``int`` specifying the number of labels in the suffix
@@ -705,11 +760,10 @@ class Name:
         elif depth == l:
             return (dns.name.empty, self)
         elif depth < 0 or depth > l:
-            raise ValueError(
-                'depth must be >= 0 and <= the length of the name')
-        return (Name(self[: -depth]), Name(self[-depth:]))
+            raise ValueError("depth must be >= 0 and <= the length of the name")
+        return (Name(self[:-depth]), Name(self[-depth:]))
 
-    def concatenate(self, other):
+    def concatenate(self, other: "Name") -> "Name":
         """Return a new name which is the concatenation of self and other.
 
         Raises ``dns.name.AbsoluteConcatenation`` if the name is
@@ -724,7 +778,7 @@ class Name:
         labels.extend(list(other.labels))
         return Name(labels)
 
-    def relativize(self, origin):
+    def relativize(self, origin: "Name") -> "Name":
         """If the name is a subdomain of *origin*, return a new name which is
         the name relative to origin.  Otherwise return the name.
 
@@ -740,7 +794,7 @@ class Name:
         else:
             return self
 
-    def derelativize(self, origin):
+    def derelativize(self, origin: "Name") -> "Name":
         """If the name is a relative name, return a new name which is the
         concatenation of the name and origin.  Otherwise return the name.
 
@@ -756,7 +810,9 @@ class Name:
         else:
             return self
 
-    def choose_relativity(self, origin=None, relativize=True):
+    def choose_relativity(
+        self, origin: Optional["Name"] = None, relativize: bool = True
+    ) -> "Name":
         """Return a name with the relativity desired by the caller.
 
         If *origin* is ``None``, then the name is returned.
@@ -775,7 +831,7 @@ class Name:
         else:
             return self
 
-    def parent(self):
+    def parent(self) -> "Name":
         """Return the parent of the name.
 
         For example, the parent of ``www.dnspython.org.`` is ``dnspython.org``.
@@ -790,13 +846,17 @@ class Name:
             raise NoParent
         return Name(self.labels[1:])
 
+
 #: The root name, '.'
-root = Name([b''])
+root = Name([b""])
 
 #: The empty name.
 empty = Name([])
 
-def from_unicode(text, origin=root, idna_codec=None):
+
+def from_unicode(
+    text: str, origin: Optional[Name] = root, idna_codec: Optional[IDNACodec] = None
+) -> Name:
     """Convert unicode text into a Name object.
 
     Labels are encoded in IDN ACE form according to rules specified by
@@ -819,17 +879,17 @@ def from_unicode(text, origin=root, idna_codec=None):
     if not (origin is None or isinstance(origin, Name)):
         raise ValueError("origin must be a Name or None")
     labels = []
-    label = ''
+    label = ""
     escaping = False
     edigits = 0
     total = 0
     if idna_codec is None:
         idna_codec = IDNA_2003
-    if text == '@':
-        text = ''
+    if text == "@":
+        text = ""
     if text:
-        if text in ['.', '\u3002', '\uff0e', '\uff61']:
-            return Name([b''])        # no Unicode "u" on this constant!
+        if text in [".", "\u3002", "\uff0e", "\uff61"]:
+            return Name([b""])  # no Unicode "u" on this constant!
         for c in text:
             if escaping:
                 if edigits == 0:
@@ -848,12 +908,12 @@ def from_unicode(text, origin=root, idna_codec=None):
                     if edigits == 3:
                         escaping = False
                         label += chr(total)
-            elif c in ['.', '\u3002', '\uff0e', '\uff61']:
+            elif c in [".", "\u3002", "\uff0e", "\uff61"]:
                 if len(label) == 0:
                     raise EmptyLabel
                 labels.append(idna_codec.encode(label))
-                label = ''
-            elif c == '\\':
+                label = ""
+            elif c == "\\":
                 escaping = True
                 edigits = 0
                 total = 0
@@ -864,22 +924,28 @@ def from_unicode(text, origin=root, idna_codec=None):
         if len(label) > 0:
             labels.append(idna_codec.encode(label))
         else:
-            labels.append(b'')
+            labels.append(b"")
 
-    if (len(labels) == 0 or labels[-1] != b'') and origin is not None:
+    if (len(labels) == 0 or labels[-1] != b"") and origin is not None:
         labels.extend(list(origin.labels))
     return Name(labels)
 
-def is_all_ascii(text):
+
+def is_all_ascii(text: str) -> bool:
     for c in text:
-        if ord(c) > 0x7f:
+        if ord(c) > 0x7F:
             return False
     return True
 
-def from_text(text, origin=root, idna_codec=None):
+
+def from_text(
+    text: Union[bytes, str],
+    origin: Optional[Name] = root,
+    idna_codec: Optional[IDNACodec] = None,
+) -> Name:
     """Convert text into a Name object.
 
-    *text*, a ``str``, is the text to convert into a name.
+    *text*, a ``bytes`` or ``str``, is the text to convert into a name.
 
     *origin*, a ``dns.name.Name``, specifies the origin to
     append to non-absolute names.  The default is the root name.
@@ -903,23 +969,23 @@ def from_text(text, origin=root, idna_codec=None):
         #
         # then it's still "all ASCII" even though the domain name has
         # codepoints > 127.
-        text = text.encode('ascii')
+        text = text.encode("ascii")
     if not isinstance(text, bytes):
         raise ValueError("input to from_text() must be a string")
     if not (origin is None or isinstance(origin, Name)):
         raise ValueError("origin must be a Name or None")
     labels = []
-    label = b''
+    label = b""
     escaping = False
     edigits = 0
     total = 0
-    if text == b'@':
-        text = b''
+    if text == b"@":
+        text = b""
     if text:
-        if text == b'.':
-            return Name([b''])
+        if text == b".":
+            return Name([b""])
         for c in text:
-            byte_ = struct.pack('!B', c)
+            byte_ = struct.pack("!B", c)
             if escaping:
                 if edigits == 0:
                     if byte_.isdigit():
@@ -936,13 +1002,13 @@ def from_text(text, origin=root, idna_codec=None):
                     edigits += 1
                     if edigits == 3:
                         escaping = False
-                        label += struct.pack('!B', total)
-            elif byte_ == b'.':
+                        label += struct.pack("!B", total)
+            elif byte_ == b".":
                 if len(label) == 0:
                     raise EmptyLabel
                 labels.append(label)
-                label = b''
-            elif byte_ == b'\\':
+                label = b""
+            elif byte_ == b"\\":
                 escaping = True
                 edigits = 0
                 total = 0
@@ -953,13 +1019,16 @@ def from_text(text, origin=root, idna_codec=None):
         if len(label) > 0:
             labels.append(label)
         else:
-            labels.append(b'')
-    if (len(labels) == 0 or labels[-1] != b'') and origin is not None:
+            labels.append(b"")
+    if (len(labels) == 0 or labels[-1] != b"") and origin is not None:
         labels.extend(list(origin.labels))
     return Name(labels)
 
 
-def from_wire_parser(parser):
+# we need 'dns.wire.Parser' quoted as dns.name and dns.wire depend on each other.
+
+
+def from_wire_parser(parser: "dns.wire.Parser") -> Name:
     """Convert possibly compressed wire format into a Name.
 
     *parser* is a dns.wire.Parser.
@@ -980,7 +1049,7 @@ def from_wire_parser(parser):
             if count < 64:
                 labels.append(parser.get_bytes(count))
             elif count >= 192:
-                current = (count & 0x3f) * 256 + parser.get_uint8()
+                current = (count & 0x3F) * 256 + parser.get_uint8()
                 if current >= biggest_pointer:
                     raise BadPointer
                 biggest_pointer = current
@@ -988,11 +1057,11 @@ def from_wire_parser(parser):
             else:
                 raise BadLabelType
             count = parser.get_uint8()
-        labels.append(b'')
+        labels.append(b"")
     return Name(labels)
 
 
-def from_wire(message, current):
+def from_wire(message: bytes, current: int) -> Tuple[Name, int]:
     """Convert possibly compressed wire format into a Name.
 
     *message* is a ``bytes`` containing an entire DNS message in DNS
diff --git a/lib/dns/name.pyi b/lib/dns/name.pyi
deleted file mode 100644
index c48d4bd1..00000000
--- a/lib/dns/name.pyi
+++ /dev/null
@@ -1,40 +0,0 @@
-from typing import Optional, Union, Tuple, Iterable, List
-
-have_idna_2008: bool
-
-class Name:
-    def is_subdomain(self, o : Name) -> bool: ...
-    def is_superdomain(self, o : Name) -> bool: ...
-    def __init__(self, labels : Iterable[Union[bytes,str]]) -> None:
-        self.labels : List[bytes]
-    def is_absolute(self) -> bool: ...
-    def is_wild(self) -> bool: ...
-    def fullcompare(self, other) -> Tuple[int,int,int]: ...
-    def canonicalize(self) -> Name: ...
-    def __eq__(self, other) -> bool: ...
-    def __ne__(self, other) -> bool: ...
-    def __lt__(self, other : Name) -> bool: ...
-    def __le__(self, other : Name) -> bool: ...
-    def __ge__(self, other : Name) -> bool: ...
-    def __gt__(self, other : Name) -> bool: ...
-    def to_text(self, omit_final_dot=False) -> str: ...
-    def to_unicode(self, omit_final_dot=False, idna_codec=None) -> str: ...
-    def to_digestable(self, origin=None) -> bytes: ...
-    def to_wire(self, file=None, compress=None, origin=None,
-                canonicalize=False) -> Optional[bytes]: ...
-    def __add__(self, other : Name) -> Name: ...
-    def __sub__(self, other : Name) -> Name: ...
-    def split(self, depth) -> List[Tuple[str,str]]: ...
-    def concatenate(self, other : Name) -> Name: ...
-    def relativize(self, origin) -> Name: ...
-    def derelativize(self, origin) -> Name: ...
-    def choose_relativity(self, origin : Optional[Name] = None, relativize=True) -> Name: ...
-    def parent(self) -> Name: ...
-
-class IDNACodec:
-    pass
-
-def from_text(text, origin : Optional[Name] = Name('.'), idna_codec : Optional[IDNACodec] = None) -> Name:
-    ...
-
-empty : Name
diff --git a/lib/dns/namedict.py b/lib/dns/namedict.py
index ec0750ce..ca8b1978 100644
--- a/lib/dns/namedict.py
+++ b/lib/dns/namedict.py
@@ -27,7 +27,8 @@
 
 """DNS name dictionary"""
 
-from collections.abc import MutableMapping
+# pylint seems to be confused about this one!
+from collections.abc import MutableMapping  # pylint: disable=no-name-in-module
 
 import dns.name
 
@@ -62,7 +63,7 @@ class NameDict(MutableMapping):
 
     def __setitem__(self, key, value):
         if not isinstance(key, dns.name.Name):
-            raise ValueError('NameDict key must be a name')
+            raise ValueError("NameDict key must be a name")
         self.__store[key] = value
         self.__update_max_depth(key)
 
diff --git a/lib/dns/node.py b/lib/dns/node.py
index 63ce008b..22bbe7cb 100644
--- a/lib/dns/node.py
+++ b/lib/dns/node.py
@@ -17,12 +17,17 @@
 
 """DNS nodes.  A node is a set of rdatasets."""
 
+from typing import Any, Dict, Optional
+
 import enum
 import io
 
 import dns.immutable
+import dns.name
+import dns.rdataclass
 import dns.rdataset
 import dns.rdatatype
+import dns.rrset
 import dns.renderer
 
 
@@ -32,26 +37,28 @@ _cname_types = {
 
 # "neutral" types can coexist with a CNAME and thus are not "other data"
 _neutral_types = {
-    dns.rdatatype.NSEC,   # RFC 4035 section 2.5
+    dns.rdatatype.NSEC,  # RFC 4035 section 2.5
     dns.rdatatype.NSEC3,  # This is not likely to happen, but not impossible!
-    dns.rdatatype.KEY,    # RFC 4035 section 2.5, RFC 3007
+    dns.rdatatype.KEY,  # RFC 4035 section 2.5, RFC 3007
 }
 
+
 def _matches_type_or_its_signature(rdtypes, rdtype, covers):
-    return rdtype in rdtypes or \
-           (rdtype == dns.rdatatype.RRSIG and covers in rdtypes)
+    return rdtype in rdtypes or (rdtype == dns.rdatatype.RRSIG and covers in rdtypes)
 
 
 @enum.unique
 class NodeKind(enum.Enum):
-    """Rdatasets in nodes
-    """
-    REGULAR = 0      # a.k.a "other data"
+    """Rdatasets in nodes"""
+
+    REGULAR = 0  # a.k.a "other data"
     NEUTRAL = 1
     CNAME = 2
 
     @classmethod
-    def classify(cls, rdtype, covers):
+    def classify(
+        cls, rdtype: dns.rdatatype.RdataType, covers: dns.rdatatype.RdataType
+    ) -> "NodeKind":
         if _matches_type_or_its_signature(_cname_types, rdtype, covers):
             return NodeKind.CNAME
         elif _matches_type_or_its_signature(_neutral_types, rdtype, covers):
@@ -60,7 +67,7 @@ class NodeKind(enum.Enum):
             return NodeKind.REGULAR
 
     @classmethod
-    def classify_rdataset(cls, rdataset):
+    def classify_rdataset(cls, rdataset: dns.rdataset.Rdataset) -> "NodeKind":
         return cls.classify(rdataset.rdtype, rdataset.covers)
 
 
@@ -81,19 +88,19 @@ class Node:
     deleted.
     """
 
-    __slots__ = ['rdatasets']
+    __slots__ = ["rdatasets"]
 
     def __init__(self):
         # the set of rdatasets, represented as a list.
         self.rdatasets = []
 
-    def to_text(self, name, **kw):
+    def to_text(self, name: dns.name.Name, **kw: Dict[str, Any]) -> str:
         """Convert a node to text format.
 
         Each rdataset at the node is printed.  Any keyword arguments
         to this method are passed on to the rdataset's to_text() method.
 
-        *name*, a ``dns.name.Name`` or ``str``, the owner name of the
+        *name*, a ``dns.name.Name``, the owner name of the
         rdatasets.
 
         Returns a ``str``.
@@ -103,12 +110,12 @@ class Node:
         s = io.StringIO()
         for rds in self.rdatasets:
             if len(rds) > 0:
-                s.write(rds.to_text(name, **kw))
-                s.write('\n')
+                s.write(rds.to_text(name, **kw))  # type: ignore[arg-type]
+                s.write("\n")
         return s.getvalue()[:-1]
 
     def __repr__(self):
-        return '<DNS node ' + str(id(self)) + '>'
+        return "<DNS node " + str(id(self)) + ">"
 
     def __eq__(self, other):
         #
@@ -144,27 +151,36 @@ class Node:
         if len(self.rdatasets) > 0:
             kind = NodeKind.classify_rdataset(rdataset)
             if kind == NodeKind.CNAME:
-                self.rdatasets = [rds for rds in self.rdatasets if
-                                  NodeKind.classify_rdataset(rds) !=
-                                  NodeKind.REGULAR]
+                self.rdatasets = [
+                    rds
+                    for rds in self.rdatasets
+                    if NodeKind.classify_rdataset(rds) != NodeKind.REGULAR
+                ]
             elif kind == NodeKind.REGULAR:
-                self.rdatasets = [rds for rds in self.rdatasets if
-                                  NodeKind.classify_rdataset(rds) !=
-                                  NodeKind.CNAME]
+                self.rdatasets = [
+                    rds
+                    for rds in self.rdatasets
+                    if NodeKind.classify_rdataset(rds) != NodeKind.CNAME
+                ]
             # Otherwise the rdataset is NodeKind.NEUTRAL and we do not need to
             # edit self.rdatasets.
         self.rdatasets.append(rdataset)
 
-    def find_rdataset(self, rdclass, rdtype, covers=dns.rdatatype.NONE,
-                      create=False):
+    def find_rdataset(
+        self,
+        rdclass: dns.rdataclass.RdataClass,
+        rdtype: dns.rdatatype.RdataType,
+        covers: dns.rdatatype.RdataType = dns.rdatatype.NONE,
+        create: bool = False,
+    ) -> dns.rdataset.Rdataset:
         """Find an rdataset matching the specified properties in the
         current node.
 
-        *rdclass*, an ``int``, the class of the rdataset.
+        *rdclass*, a ``dns.rdataclass.RdataClass``, the class of the rdataset.
 
-        *rdtype*, an ``int``, the type of the rdataset.
+        *rdtype*, a ``dns.rdatatype.RdataType``, the type of the rdataset.
 
-        *covers*, an ``int`` or ``None``, the covered type.
+        *covers*, a ``dns.rdatatype.RdataType``, the covered type.
         Usually this value is ``dns.rdatatype.NONE``, but if the
         rdtype is ``dns.rdatatype.SIG`` or ``dns.rdatatype.RRSIG``,
         then the covers value will be the rdata type the SIG/RRSIG
@@ -191,8 +207,13 @@ class Node:
         self._append_rdataset(rds)
         return rds
 
-    def get_rdataset(self, rdclass, rdtype, covers=dns.rdatatype.NONE,
-                     create=False):
+    def get_rdataset(
+        self,
+        rdclass: dns.rdataclass.RdataClass,
+        rdtype: dns.rdatatype.RdataType,
+        covers: dns.rdatatype.RdataType = dns.rdatatype.NONE,
+        create: bool = False,
+    ) -> Optional[dns.rdataset.Rdataset]:
         """Get an rdataset matching the specified properties in the
         current node.
 
@@ -223,7 +244,12 @@ class Node:
             rds = None
         return rds
 
-    def delete_rdataset(self, rdclass, rdtype, covers=dns.rdatatype.NONE):
+    def delete_rdataset(
+        self,
+        rdclass: dns.rdataclass.RdataClass,
+        rdtype: dns.rdatatype.RdataType,
+        covers: dns.rdatatype.RdataType = dns.rdatatype.NONE,
+    ) -> None:
         """Delete the rdataset matching the specified properties in the
         current node.
 
@@ -240,7 +266,7 @@ class Node:
         if rds is not None:
             self.rdatasets.remove(rds)
 
-    def replace_rdataset(self, replacement):
+    def replace_rdataset(self, replacement: dns.rdataset.Rdataset) -> None:
         """Replace an rdataset.
 
         It is not an error if there is no rdataset matching *replacement*.
@@ -256,16 +282,17 @@ class Node:
         """
 
         if not isinstance(replacement, dns.rdataset.Rdataset):
-            raise ValueError('replacement is not an rdataset')
+            raise ValueError("replacement is not an rdataset")
         if isinstance(replacement, dns.rrset.RRset):
             # RRsets are not good replacements as the match() method
             # is not compatible.
             replacement = replacement.to_rdataset()
-        self.delete_rdataset(replacement.rdclass, replacement.rdtype,
-                             replacement.covers)
+        self.delete_rdataset(
+            replacement.rdclass, replacement.rdtype, replacement.covers
+        )
         self._append_rdataset(replacement)
 
-    def classify(self):
+    def classify(self) -> NodeKind:
         """Classify a node.
 
         A node which contains a CNAME or RRSIG(CNAME) is a
@@ -286,7 +313,7 @@ class Node:
                 return kind
         return NodeKind.NEUTRAL
 
-    def is_immutable(self):
+    def is_immutable(self) -> bool:
         return False
 
 
@@ -298,23 +325,38 @@ class ImmutableNode(Node):
             [dns.rdataset.ImmutableRdataset(rds) for rds in node.rdatasets]
         )
 
-    def find_rdataset(self, rdclass, rdtype, covers=dns.rdatatype.NONE,
-                      create=False):
+    def find_rdataset(
+        self,
+        rdclass: dns.rdataclass.RdataClass,
+        rdtype: dns.rdatatype.RdataType,
+        covers: dns.rdatatype.RdataType = dns.rdatatype.NONE,
+        create: bool = False,
+    ) -> dns.rdataset.Rdataset:
         if create:
             raise TypeError("immutable")
         return super().find_rdataset(rdclass, rdtype, covers, False)
 
-    def get_rdataset(self, rdclass, rdtype, covers=dns.rdatatype.NONE,
-                     create=False):
+    def get_rdataset(
+        self,
+        rdclass: dns.rdataclass.RdataClass,
+        rdtype: dns.rdatatype.RdataType,
+        covers: dns.rdatatype.RdataType = dns.rdatatype.NONE,
+        create: bool = False,
+    ) -> Optional[dns.rdataset.Rdataset]:
         if create:
             raise TypeError("immutable")
         return super().get_rdataset(rdclass, rdtype, covers, False)
 
-    def delete_rdataset(self, rdclass, rdtype, covers=dns.rdatatype.NONE):
+    def delete_rdataset(
+        self,
+        rdclass: dns.rdataclass.RdataClass,
+        rdtype: dns.rdatatype.RdataType,
+        covers: dns.rdatatype.RdataType = dns.rdatatype.NONE,
+    ) -> None:
         raise TypeError("immutable")
 
-    def replace_rdataset(self, replacement):
+    def replace_rdataset(self, replacement: dns.rdataset.Rdataset) -> None:
         raise TypeError("immutable")
 
-    def is_immutable(self):
+    def is_immutable(self) -> bool:
         return True
diff --git a/lib/dns/node.pyi b/lib/dns/node.pyi
deleted file mode 100644
index 0997edf9..00000000
--- a/lib/dns/node.pyi
+++ /dev/null
@@ -1,17 +0,0 @@
-from typing import List, Optional, Union
-from . import rdataset, rdatatype, name
-class Node:
-    def __init__(self):
-        self.rdatasets : List[rdataset.Rdataset]
-    def to_text(self, name : Union[str,name.Name], **kw) -> str:
-        ...
-    def find_rdataset(self, rdclass : int, rdtype : int, covers=rdatatype.NONE,
-                      create=False) -> rdataset.Rdataset:
-        ...
-    def get_rdataset(self, rdclass : int, rdtype : int, covers=rdatatype.NONE,
-                     create=False) -> Optional[rdataset.Rdataset]:
-        ...
-    def delete_rdataset(self, rdclass : int, rdtype : int, covers=rdatatype.NONE):
-        ...
-    def replace_rdataset(self, replacement : rdataset.Rdataset) -> None:
-        ...
diff --git a/lib/dns/opcode.py b/lib/dns/opcode.py
index 5cf6143c..78b43d2c 100644
--- a/lib/dns/opcode.py
+++ b/lib/dns/opcode.py
@@ -20,6 +20,7 @@
 import dns.enum
 import dns.exception
 
+
 class Opcode(dns.enum.IntEnum):
     #: Query
     QUERY = 0
@@ -45,7 +46,7 @@ class UnknownOpcode(dns.exception.DNSException):
     """An DNS opcode is unknown."""
 
 
-def from_text(text):
+def from_text(text: str) -> Opcode:
     """Convert text into an opcode.
 
     *text*, a ``str``, the textual opcode
@@ -58,7 +59,7 @@ def from_text(text):
     return Opcode.from_text(text)
 
 
-def from_flags(flags):
+def from_flags(flags: int) -> Opcode:
     """Extract an opcode from DNS message flags.
 
     *flags*, an ``int``, the DNS flags.
@@ -66,10 +67,10 @@ def from_flags(flags):
     Returns an ``int``.
     """
 
-    return (flags & 0x7800) >> 11
+    return Opcode((flags & 0x7800) >> 11)
 
 
-def to_flags(value):
+def to_flags(value: Opcode) -> int:
     """Convert an opcode to a value suitable for ORing into DNS message
     flags.
 
@@ -81,7 +82,7 @@ def to_flags(value):
     return (value << 11) & 0x7800
 
 
-def to_text(value):
+def to_text(value: Opcode) -> str:
     """Convert an opcode to text.
 
     *value*, an ``int`` the opcode value,
@@ -94,7 +95,7 @@ def to_text(value):
     return Opcode.to_text(value)
 
 
-def is_update(flags):
+def is_update(flags: int) -> bool:
     """Is the opcode in flags UPDATE?
 
     *flags*, an ``int``, the DNS message flags.
@@ -104,6 +105,7 @@ def is_update(flags):
 
     return from_flags(flags) == Opcode.UPDATE
 
+
 ### BEGIN generated Opcode constants
 
 QUERY = Opcode.QUERY
diff --git a/lib/dns/query.py b/lib/dns/query.py
index 6d924b5f..b4cd69f7 100644
--- a/lib/dns/query.py
+++ b/lib/dns/query.py
@@ -17,6 +17,9 @@
 
 """Talk to a DNS server."""
 
+from typing import Any, Dict, Optional, Tuple, Union
+
+import base64
 import contextlib
 import enum
 import errno
@@ -25,23 +28,26 @@ import selectors
 import socket
 import struct
 import time
-import base64
 import urllib.parse
 
 import dns.exception
 import dns.inet
 import dns.name
 import dns.message
+import dns.quic
 import dns.rcode
 import dns.rdataclass
 import dns.rdatatype
 import dns.serial
+import dns.transaction
+import dns.tsig
 import dns.xfr
 
 try:
     import requests
     from requests_toolbelt.adapters.source import SourceAddressAdapter
     from requests_toolbelt.adapters.host_header_ssl import HostHeaderSSLAdapter
+
     _have_requests = True
 except ImportError:  # pragma: no cover
     _have_requests = False
@@ -50,6 +56,7 @@ _have_httpx = False
 _have_http2 = False
 try:
     import httpx
+
     _have_httpx = True
     try:
         # See if http2 support is available.
@@ -65,24 +72,30 @@ have_doh = _have_requests or _have_httpx
 try:
     import ssl
 except ImportError:  # pragma: no cover
-    class ssl:    # type: ignore
 
+    class ssl:  # type: ignore
         class WantReadException(Exception):
             pass
 
         class WantWriteException(Exception):
             pass
 
+        class SSLContext:
+            pass
+
         class SSLSocket:
             pass
 
-        def create_default_context(self, *args, **kwargs):
-            raise Exception('no ssl support')
+        @classmethod
+        def create_default_context(cls, *args, **kwargs):
+            raise Exception("no ssl support")
+
 
 # Function used to create a socket.  Can be overridden if needed in special
 # situations.
 socket_factory = socket.socket
 
+
 class UnexpectedSource(dns.exception.DNSException):
     """A DNS query response came from an unexpected address or port."""
 
@@ -96,6 +109,11 @@ class NoDOH(dns.exception.DNSException):
     available."""
 
 
+class NoDOQ(dns.exception.DNSException):
+    """DNS over QUIC (DOQ) was requested but the aioquic module is not
+    available."""
+
+
 # for backwards compatibility
 TransferError = dns.xfr.TransferError
 
@@ -143,13 +161,17 @@ def _set_selector_class(selector_class):
 
     _selector_class = selector_class
 
-if hasattr(selectors, 'PollSelector'):
+
+if hasattr(selectors, "PollSelector"):
     # Prefer poll() on platforms that support it because it has no
     # limits on the maximum value of a file descriptor (plus it will
     # be more efficient for high values).
-    _selector_class = selectors.PollSelector
+    #
+    # We ignore typing here as we can't say _selector_class is Any
+    # on python < 3.8 due to a bug.
+    _selector_class = selectors.PollSelector  # type: ignore
 else:
-    _selector_class = selectors.SelectSelector  # pragma: no cover
+    _selector_class = selectors.SelectSelector  # type: ignore
 
 
 def _wait_for_readable(s, expiration):
@@ -177,18 +199,20 @@ def _matches_destination(af, from_address, destination, ignore_unexpected):
     # sent to destination.
     if not destination:
         return True
-    if _addresses_equal(af, from_address, destination) or \
-       (dns.inet.is_multicast(destination[0]) and
-        from_address[1:] == destination[1:]):
+    if _addresses_equal(af, from_address, destination) or (
+        dns.inet.is_multicast(destination[0]) and from_address[1:] == destination[1:]
+    ):
         return True
     elif ignore_unexpected:
         return False
-    raise UnexpectedSource(f'got a response from {from_address} instead of '
-                           f'{destination}')
+    raise UnexpectedSource(
+        f"got a response from {from_address} instead of " f"{destination}"
+    )
 
 
-def _destination_and_source(where, port, source, source_port,
-                            where_must_be_address=True):
+def _destination_and_source(
+    where, port, source, source_port, where_must_be_address=True
+):
     # Apply defaults and compute destination and source tuples
     # suitable for use in connect(), sendto(), or bind().
     af = None
@@ -205,8 +229,9 @@ def _destination_and_source(where, port, source, source_port,
         if af:
             # We know the destination af, so source had better agree!
             if saf != af:
-                raise ValueError('different address families for source ' +
-                                 'and destination')
+                raise ValueError(
+                    "different address families for source " + "and destination"
+                )
         else:
             # We didn't know the destination af, but we know the source,
             # so that's our af.
@@ -216,12 +241,11 @@ def _destination_and_source(where, port, source, source_port,
         # need to return a source, and we need to use the appropriate
         # wildcard address as the address.
         if af == socket.AF_INET:
-            source = '0.0.0.0'
+            source = "0.0.0.0"
         elif af == socket.AF_INET6:
-            source = '::'
+            source = "::"
         else:
-            raise ValueError('source_port specified but address family is '
-                             'unknown')
+            raise ValueError("source_port specified but address family is unknown")
     # Convert high-level (address, port) tuples into low-level address
     # tuples.
     if destination:
@@ -230,6 +254,7 @@ def _destination_and_source(where, port, source, source_port,
         source = dns.inet.low_level_address_tuple((source, source_port), af)
     return (af, destination, source)
 
+
 def _make_socket(af, type, source, ssl_context=None, server_hostname=None):
     s = socket_factory(af, type)
     try:
@@ -237,81 +262,98 @@ def _make_socket(af, type, source, ssl_context=None, server_hostname=None):
         if source is not None:
             s.bind(source)
         if ssl_context:
-            return ssl_context.wrap_socket(s, do_handshake_on_connect=False,
-                                           server_hostname=server_hostname)
+            # LGTM gets a false positive here, as our default context is OK
+            return ssl_context.wrap_socket(
+                s,
+                do_handshake_on_connect=False,  # lgtm[py/insecure-protocol]
+                server_hostname=server_hostname,
+            )
         else:
             return s
     except Exception:
         s.close()
         raise
 
-def https(q, where, timeout=None, port=443, source=None, source_port=0,
-          one_rr_per_rrset=False, ignore_trailing=False,
-          session=None, path='/dns-query', post=True,
-          bootstrap_address=None, verify=True):
+
+def https(
+    q: dns.message.Message,
+    where: str,
+    timeout: Optional[float] = None,
+    port: int = 443,
+    source: Optional[str] = None,
+    source_port: int = 0,
+    one_rr_per_rrset: bool = False,
+    ignore_trailing: bool = False,
+    session: Optional[Any] = None,
+    path: str = "/dns-query",
+    post: bool = True,
+    bootstrap_address: Optional[str] = None,
+    verify: Union[bool, str] = True,
+) -> dns.message.Message:
     """Return the response obtained after sending a query via DNS-over-HTTPS.
 
     *q*, a ``dns.message.Message``, the query to send.
 
-    *where*, a ``str``, the nameserver IP address or the full URL. If an IP
-    address is given, the URL will be constructed using the following schema:
+    *where*, a ``str``, the nameserver IP address or the full URL. If an IP address is
+    given, the URL will be constructed using the following schema:
     https://<IP-address>:<port>/<path>.
 
-    *timeout*, a ``float`` or ``None``, the number of seconds to
-    wait before the query times out. If ``None``, the default, wait forever.
+    *timeout*, a ``float`` or ``None``, the number of seconds to wait before the query
+    times out. If ``None``, the default, wait forever.
 
     *port*, a ``int``, the port to send the query to. The default is 443.
 
-    *source*, a ``str`` containing an IPv4 or IPv6 address, specifying
-    the source address.  The default is the wildcard address.
+    *source*, a ``str`` containing an IPv4 or IPv6 address, specifying the source
+    address.  The default is the wildcard address.
 
-    *source_port*, an ``int``, the port from which to send the message.
-    The default is 0.
+    *source_port*, an ``int``, the port from which to send the message. The default is
+    0.
 
-    *one_rr_per_rrset*, a ``bool``. If ``True``, put each RR into its own
-    RRset.
+    *one_rr_per_rrset*, a ``bool``. If ``True``, put each RR into its own RRset.
 
-    *ignore_trailing*, a ``bool``. If ``True``, ignore trailing
-    junk at end of the received message.
+    *ignore_trailing*, a ``bool``. If ``True``, ignore trailing junk at end of the
+    received message.
 
-    *session*, an ``httpx.Client`` or ``requests.session.Session``.  If
-    provided, the client/session to use to send the queries.
+    *session*, an ``httpx.Client`` or ``requests.session.Session``.  If provided, the
+    client/session to use to send the queries.
 
     *path*, a ``str``. If *where* is an IP address, then *path* will be used to
     construct the URL to send the DNS query to.
 
     *post*, a ``bool``. If ``True``, the default, POST method will be used.
 
-    *bootstrap_address*, a ``str``, the IP address to use to bypass the
-    system's DNS resolver.
+    *bootstrap_address*, a ``str``, the IP address to use to bypass the system's DNS
+    resolver.
 
-    *verify*, a ``str``, containing a path to a certificate file or directory.
+    *verify*, a ``bool`` or ``str``.  If a ``True``, then TLS certificate verification
+    of the server is done using the default CA bundle; if ``False``, then no
+    verification is done; if a `str` then it specifies the path to a certificate file or
+    directory which will be used for verification.
 
     Returns a ``dns.message.Message``.
     """
 
     if not have_doh:
-        raise NoDOH('Neither httpx nor requests is available.')  # pragma: no cover
+        raise NoDOH("Neither httpx nor requests is available.")  # pragma: no cover
 
     _httpx_ok = _have_httpx
 
     wire = q.to_wire()
-    (af, _, source) = _destination_and_source(where, port, source, source_port,
-                                              False)
+    (af, _, source) = _destination_and_source(where, port, source, source_port, False)
     transport_adapter = None
     transport = None
-    headers = {
-        "accept": "application/dns-message"
-    }
+    headers = {"accept": "application/dns-message"}
     if af is not None:
         if af == socket.AF_INET:
-            url = 'https://{}:{}{}'.format(where, port, path)
+            url = "https://{}:{}{}".format(where, port, path)
         elif af == socket.AF_INET6:
-            url = 'https://[{}]:{}{}'.format(where, port, path)
+            url = "https://[{}]:{}{}".format(where, port, path)
     elif bootstrap_address is not None:
         _httpx_ok = False
         split_url = urllib.parse.urlsplit(where)
-        headers['Host'] = split_url.hostname
+        if split_url.hostname is None:
+            raise ValueError("DoH URL has no hostname")
+        headers["Host"] = split_url.hostname
         url = where.replace(split_url.hostname, bootstrap_address)
         if _have_requests:
             transport_adapter = HostHeaderSSLAdapter()
@@ -321,7 +363,7 @@ def https(q, where, timeout=None, port=443, source=None, source_port=0,
         # set source port and source address
         if _have_httpx:
             if source_port == 0:
-                transport = httpx.HTTPTransport(local_address=source[0])
+                transport = httpx.HTTPTransport(local_address=source[0], verify=verify)
             else:
                 _httpx_ok = False
         if _have_requests:
@@ -333,70 +375,83 @@ def https(q, where, timeout=None, port=443, source=None, source_port=0,
         else:
             _is_httpx = False
         if _is_httpx and not _httpx_ok:
-            raise NoDOH('Session is httpx, but httpx cannot be used for '
-                        'the requested operation.')
+            raise NoDOH(
+                "Session is httpx, but httpx cannot be used for "
+                "the requested operation."
+            )
     else:
         _is_httpx = _httpx_ok
 
     if not _httpx_ok and not _have_requests:
-        raise NoDOH('Cannot use httpx for this operation, and '
-                    'requests is not available.')
+        raise NoDOH(
+            "Cannot use httpx for this operation, and requests is not available."
+        )
 
-    with contextlib.ExitStack() as stack:
-        if not session:
-            if _is_httpx:
-                session = stack.enter_context(httpx.Client(http1=True,
-                                                           http2=_have_http2,
-                                                           verify=verify,
-                                                           transport=transport))
-            else:
-                session = stack.enter_context(requests.sessions.Session())
-
-        if transport_adapter:
+    if session:
+        cm: contextlib.AbstractContextManager = contextlib.nullcontext(session)
+    elif _is_httpx:
+        cm = httpx.Client(
+            http1=True, http2=_have_http2, verify=verify, transport=transport
+        )
+    else:
+        cm = requests.sessions.Session()
+    with cm as session:
+        if transport_adapter and not _is_httpx:
             session.mount(url, transport_adapter)
 
         # see https://tools.ietf.org/html/rfc8484#section-4.1.1 for DoH
         # GET and POST examples
         if post:
-            headers.update({
-                "content-type": "application/dns-message",
-                "content-length": str(len(wire))
-            })
+            headers.update(
+                {
+                    "content-type": "application/dns-message",
+                    "content-length": str(len(wire)),
+                }
+            )
             if _is_httpx:
-                response = session.post(url, headers=headers, content=wire,
-                                        timeout=timeout)
+                response = session.post(
+                    url, headers=headers, content=wire, timeout=timeout
+                )
             else:
-                response = session.post(url, headers=headers, data=wire,
-                                        timeout=timeout, verify=verify)
+                response = session.post(
+                    url, headers=headers, data=wire, timeout=timeout, verify=verify
+                )
         else:
             wire = base64.urlsafe_b64encode(wire).rstrip(b"=")
             if _is_httpx:
-                wire = wire.decode()  # httpx does a repr() if we give it bytes
-                response = session.get(url, headers=headers,
-                                       timeout=timeout,
-                                       params={"dns": wire})
+                twire = wire.decode()  # httpx does a repr() if we give it bytes
+                response = session.get(
+                    url, headers=headers, timeout=timeout, params={"dns": twire}
+                )
             else:
-                response = session.get(url, headers=headers,
-                                       timeout=timeout, verify=verify,
-                                       params={"dns": wire})
+                response = session.get(
+                    url,
+                    headers=headers,
+                    timeout=timeout,
+                    verify=verify,
+                    params={"dns": wire},
+                )
 
     # see https://tools.ietf.org/html/rfc8484#section-4.2.1 for info about DoH
     # status codes
     if response.status_code < 200 or response.status_code > 299:
-        raise ValueError('{} responded with status code {}'
-                         '\nResponse body: {}'.format(where,
-                                                      response.status_code,
-                                                      response.content))
-    r = dns.message.from_wire(response.content,
-                              keyring=q.keyring,
-                              request_mac=q.request_mac,
-                              one_rr_per_rrset=one_rr_per_rrset,
-                              ignore_trailing=ignore_trailing)
-    r.time = response.elapsed
+        raise ValueError(
+            "{} responded with status code {}"
+            "\nResponse body: {}".format(where, response.status_code, response.content)
+        )
+    r = dns.message.from_wire(
+        response.content,
+        keyring=q.keyring,
+        request_mac=q.request_mac,
+        one_rr_per_rrset=one_rr_per_rrset,
+        ignore_trailing=ignore_trailing,
+    )
+    r.time = response.elapsed.total_seconds()
     if not q.is_response(r):
         raise BadResponse
     return r
 
+
 def _udp_recv(sock, max_size, expiration):
     """Reads a datagram from the socket.
     A Timeout exception will be raised if the operation is not completed
@@ -424,7 +479,12 @@ def _udp_send(sock, data, destination, expiration):
             _wait_for_writable(sock, expiration)
 
 
-def send_udp(sock, what, destination, expiration=None):
+def send_udp(
+    sock: Any,
+    what: Union[dns.message.Message, bytes],
+    destination: Any,
+    expiration: Optional[float] = None,
+) -> Tuple[int, float]:
     """Send a DNS message to the specified UDP socket.
 
     *sock*, a ``socket``.
@@ -448,10 +508,17 @@ def send_udp(sock, what, destination, expiration=None):
     return (n, sent_time)
 
 
-def receive_udp(sock, destination=None, expiration=None,
-                ignore_unexpected=False, one_rr_per_rrset=False,
-                keyring=None, request_mac=b'', ignore_trailing=False,
-                raise_on_truncation=False):
+def receive_udp(
+    sock: Any,
+    destination: Optional[Any] = None,
+    expiration: Optional[float] = None,
+    ignore_unexpected: bool = False,
+    one_rr_per_rrset: bool = False,
+    keyring: Optional[Dict[dns.name.Name, dns.tsig.Key]] = None,
+    request_mac: Optional[bytes] = b"",
+    ignore_trailing: bool = False,
+    raise_on_truncation: bool = False,
+) -> Any:
     """Read a DNS message from a UDP socket.
 
     *sock*, a ``socket``.
@@ -473,7 +540,7 @@ def receive_udp(sock, destination=None, expiration=None,
 
     *keyring*, a ``dict``, the keyring to use for TSIG.
 
-    *request_mac*, a ``bytes``, the MAC of the request (for TSIG).
+    *request_mac*, a ``bytes`` or ``None``, the MAC of the request (for TSIG).
 
     *ignore_trailing*, a ``bool``.  If ``True``, ignore trailing
     junk at end of the received message.
@@ -493,25 +560,41 @@ def receive_udp(sock, destination=None, expiration=None,
     the message arrived from.
     """
 
-    wire = b''
+    wire = b""
     while True:
         (wire, from_address) = _udp_recv(sock, 65535, expiration)
-        if _matches_destination(sock.family, from_address, destination,
-                                ignore_unexpected):
+        if _matches_destination(
+            sock.family, from_address, destination, ignore_unexpected
+        ):
             break
     received_time = time.time()
-    r = dns.message.from_wire(wire, keyring=keyring, request_mac=request_mac,
-                              one_rr_per_rrset=one_rr_per_rrset,
-                              ignore_trailing=ignore_trailing,
-                              raise_on_truncation=raise_on_truncation)
+    r = dns.message.from_wire(
+        wire,
+        keyring=keyring,
+        request_mac=request_mac,
+        one_rr_per_rrset=one_rr_per_rrset,
+        ignore_trailing=ignore_trailing,
+        raise_on_truncation=raise_on_truncation,
+    )
     if destination:
         return (r, received_time)
     else:
         return (r, received_time, from_address)
 
-def udp(q, where, timeout=None, port=53, source=None, source_port=0,
-        ignore_unexpected=False, one_rr_per_rrset=False, ignore_trailing=False,
-        raise_on_truncation=False, sock=None):
+
+def udp(
+    q: dns.message.Message,
+    where: str,
+    timeout: Optional[float] = None,
+    port: int = 53,
+    source: Optional[str] = None,
+    source_port: int = 0,
+    ignore_unexpected: bool = False,
+    one_rr_per_rrset: bool = False,
+    ignore_trailing: bool = False,
+    raise_on_truncation: bool = False,
+    sock: Optional[Any] = None,
+) -> dns.message.Message:
     """Return the response obtained after sending a query via UDP.
 
     *q*, a ``dns.message.Message``, the query to send
@@ -551,28 +634,49 @@ def udp(q, where, timeout=None, port=53, source=None, source_port=0,
     """
 
     wire = q.to_wire()
-    (af, destination, source) = _destination_and_source(where, port,
-                                                        source, source_port)
+    (af, destination, source) = _destination_and_source(
+        where, port, source, source_port
+    )
     (begin_time, expiration) = _compute_times(timeout)
-    with contextlib.ExitStack() as stack:
-        if sock:
-            s = sock
-        else:
-            s = stack.enter_context(_make_socket(af, socket.SOCK_DGRAM, source))
+    if sock:
+        cm: contextlib.AbstractContextManager = contextlib.nullcontext(sock)
+    else:
+        cm = _make_socket(af, socket.SOCK_DGRAM, source)
+    with cm as s:
         send_udp(s, wire, destination, expiration)
-        (r, received_time) = receive_udp(s, destination, expiration,
-                                         ignore_unexpected, one_rr_per_rrset,
-                                         q.keyring, q.mac, ignore_trailing,
-                                         raise_on_truncation)
+        (r, received_time) = receive_udp(
+            s,
+            destination,
+            expiration,
+            ignore_unexpected,
+            one_rr_per_rrset,
+            q.keyring,
+            q.mac,
+            ignore_trailing,
+            raise_on_truncation,
+        )
         r.time = received_time - begin_time
         if not q.is_response(r):
             raise BadResponse
         return r
+    assert (
+        False  # help mypy figure out we can't get here  lgtm[py/unreachable-statement]
+    )
 
-def udp_with_fallback(q, where, timeout=None, port=53, source=None,
-                      source_port=0, ignore_unexpected=False,
-                      one_rr_per_rrset=False, ignore_trailing=False,
-                      udp_sock=None, tcp_sock=None):
+
+def udp_with_fallback(
+    q: dns.message.Message,
+    where: str,
+    timeout: Optional[float] = None,
+    port: int = 53,
+    source: Optional[str] = None,
+    source_port: int = 0,
+    ignore_unexpected: bool = False,
+    one_rr_per_rrset: bool = False,
+    ignore_trailing: bool = False,
+    udp_sock: Optional[Any] = None,
+    tcp_sock: Optional[Any] = None,
+) -> Tuple[dns.message.Message, bool]:
     """Return the response to the query, trying UDP first and falling back
     to TCP if UDP results in a truncated response.
 
@@ -616,26 +720,46 @@ def udp_with_fallback(q, where, timeout=None, port=53, source=None,
     if and only if TCP was used.
     """
     try:
-        response = udp(q, where, timeout, port, source, source_port,
-                       ignore_unexpected, one_rr_per_rrset,
-                       ignore_trailing, True, udp_sock)
+        response = udp(
+            q,
+            where,
+            timeout,
+            port,
+            source,
+            source_port,
+            ignore_unexpected,
+            one_rr_per_rrset,
+            ignore_trailing,
+            True,
+            udp_sock,
+        )
         return (response, False)
     except dns.message.Truncated:
-        response = tcp(q, where, timeout, port, source, source_port,
-                       one_rr_per_rrset, ignore_trailing, tcp_sock)
+        response = tcp(
+            q,
+            where,
+            timeout,
+            port,
+            source,
+            source_port,
+            one_rr_per_rrset,
+            ignore_trailing,
+            tcp_sock,
+        )
         return (response, True)
 
+
 def _net_read(sock, count, expiration):
     """Read the specified number of bytes from sock.  Keep trying until we
     either get the desired amount, or we hit EOF.
     A Timeout exception will be raised if the operation is not completed
     by the expiration time.
     """
-    s = b''
+    s = b""
     while count > 0:
         try:
             n = sock.recv(count)
-            if n == b'':
+            if n == b"":
                 raise EOFError
             count -= len(n)
             s += n
@@ -662,7 +786,11 @@ def _net_write(sock, data, expiration):
             _wait_for_readable(sock, expiration)
 
 
-def send_tcp(sock, what, expiration=None):
+def send_tcp(
+    sock: Any,
+    what: Union[dns.message.Message, bytes],
+    expiration: Optional[float] = None,
+) -> Tuple[int, float]:
     """Send a DNS message to the specified TCP socket.
 
     *sock*, a ``socket``.
@@ -677,18 +805,27 @@ def send_tcp(sock, what, expiration=None):
     """
 
     if isinstance(what, dns.message.Message):
-        what = what.to_wire()
-    l = len(what)
+        wire = what.to_wire()
+    else:
+        wire = what
+    l = len(wire)
     # copying the wire into tcpmsg is inefficient, but lets us
     # avoid writev() or doing a short write that would get pushed
     # onto the net
-    tcpmsg = struct.pack("!H", l) + what
+    tcpmsg = struct.pack("!H", l) + wire
     sent_time = time.time()
     _net_write(sock, tcpmsg, expiration)
     return (len(tcpmsg), sent_time)
 
-def receive_tcp(sock, expiration=None, one_rr_per_rrset=False,
-                keyring=None, request_mac=b'', ignore_trailing=False):
+
+def receive_tcp(
+    sock: Any,
+    expiration: Optional[float] = None,
+    one_rr_per_rrset: bool = False,
+    keyring: Optional[Dict[dns.name.Name, dns.tsig.Key]] = None,
+    request_mac: Optional[bytes] = b"",
+    ignore_trailing: bool = False,
+) -> Tuple[dns.message.Message, float]:
     """Read a DNS message from a TCP socket.
 
     *sock*, a ``socket``.
@@ -702,7 +839,7 @@ def receive_tcp(sock, expiration=None, one_rr_per_rrset=False,
 
     *keyring*, a ``dict``, the keyring to use for TSIG.
 
-    *request_mac*, a ``bytes``, the MAC of the request (for TSIG).
+    *request_mac*, a ``bytes`` or ``None``, the MAC of the request (for TSIG).
 
     *ignore_trailing*, a ``bool``.  If ``True``, ignore trailing
     junk at end of the received message.
@@ -718,11 +855,16 @@ def receive_tcp(sock, expiration=None, one_rr_per_rrset=False,
     (l,) = struct.unpack("!H", ldata)
     wire = _net_read(sock, l, expiration)
     received_time = time.time()
-    r = dns.message.from_wire(wire, keyring=keyring, request_mac=request_mac,
-                              one_rr_per_rrset=one_rr_per_rrset,
-                              ignore_trailing=ignore_trailing)
+    r = dns.message.from_wire(
+        wire,
+        keyring=keyring,
+        request_mac=request_mac,
+        one_rr_per_rrset=one_rr_per_rrset,
+        ignore_trailing=ignore_trailing,
+    )
     return (r, received_time)
 
+
 def _connect(s, address, expiration):
     err = s.connect_ex(address)
     if err == 0:
@@ -734,8 +876,17 @@ def _connect(s, address, expiration):
         raise OSError(err, os.strerror(err))
 
 
-def tcp(q, where, timeout=None, port=53, source=None, source_port=0,
-        one_rr_per_rrset=False, ignore_trailing=False, sock=None):
+def tcp(
+    q: dns.message.Message,
+    where: str,
+    timeout: Optional[float] = None,
+    port: int = 53,
+    source: Optional[str] = None,
+    source_port: int = 0,
+    one_rr_per_rrset: bool = False,
+    ignore_trailing: bool = False,
+    sock: Optional[Any] = None,
+) -> dns.message.Message:
     """Return the response obtained after sending a query via TCP.
 
     *q*, a ``dns.message.Message``, the query to send
@@ -770,23 +921,27 @@ def tcp(q, where, timeout=None, port=53, source=None, source_port=0,
 
     wire = q.to_wire()
     (begin_time, expiration) = _compute_times(timeout)
-    with contextlib.ExitStack() as stack:
-        if sock:
-            s = sock
-        else:
-            (af, destination, source) = _destination_and_source(where, port,
-                                                                source,
-                                                                source_port)
-            s = stack.enter_context(_make_socket(af, socket.SOCK_STREAM,
-                                                 source))
+    if sock:
+        cm: contextlib.AbstractContextManager = contextlib.nullcontext(sock)
+    else:
+        (af, destination, source) = _destination_and_source(
+            where, port, source, source_port
+        )
+        cm = _make_socket(af, socket.SOCK_STREAM, source)
+    with cm as s:
+        if not sock:
             _connect(s, destination, expiration)
         send_tcp(s, wire, expiration)
-        (r, received_time) = receive_tcp(s, expiration, one_rr_per_rrset,
-                                         q.keyring, q.mac, ignore_trailing)
+        (r, received_time) = receive_tcp(
+            s, expiration, one_rr_per_rrset, q.keyring, q.mac, ignore_trailing
+        )
         r.time = received_time - begin_time
         if not q.is_response(r):
             raise BadResponse
         return r
+    assert (
+        False  # help mypy figure out we can't get here  lgtm[py/unreachable-statement]
+    )
 
 
 def _tls_handshake(s, expiration):
@@ -800,9 +955,19 @@ def _tls_handshake(s, expiration):
             _wait_for_writable(s, expiration)
 
 
-def tls(q, where, timeout=None, port=853, source=None, source_port=0,
-        one_rr_per_rrset=False, ignore_trailing=False, sock=None,
-        ssl_context=None, server_hostname=None):
+def tls(
+    q: dns.message.Message,
+    where: str,
+    timeout: Optional[float] = None,
+    port: int = 853,
+    source: Optional[str] = None,
+    source_port: int = 0,
+    one_rr_per_rrset: bool = False,
+    ignore_trailing: bool = False,
+    sock: Optional[ssl.SSLSocket] = None,
+    ssl_context: Optional[ssl.SSLContext] = None,
+    server_hostname: Optional[str] = None,
+) -> dns.message.Message:
     """Return the response obtained after sending a query via TLS.
 
     *q*, a ``dns.message.Message``, the query to send
@@ -849,35 +1014,148 @@ def tls(q, where, timeout=None, port=853, source=None, source_port=0,
         #
         # If a socket was provided, there's no special TLS handling needed.
         #
-        return tcp(q, where, timeout, port, source, source_port,
-                   one_rr_per_rrset, ignore_trailing, sock)
+        return tcp(
+            q,
+            where,
+            timeout,
+            port,
+            source,
+            source_port,
+            one_rr_per_rrset,
+            ignore_trailing,
+            sock,
+        )
 
     wire = q.to_wire()
     (begin_time, expiration) = _compute_times(timeout)
-    (af, destination, source) = _destination_and_source(where, port,
-                                                        source, source_port)
+    (af, destination, source) = _destination_and_source(
+        where, port, source, source_port
+    )
     if ssl_context is None and not sock:
         ssl_context = ssl.create_default_context()
+        ssl_context.minimum_version = ssl.TLSVersion.TLSv1_2
         if server_hostname is None:
             ssl_context.check_hostname = False
 
-    with _make_socket(af, socket.SOCK_STREAM, source, ssl_context=ssl_context,
-                      server_hostname=server_hostname) as s:
+    with _make_socket(
+        af,
+        socket.SOCK_STREAM,
+        source,
+        ssl_context=ssl_context,
+        server_hostname=server_hostname,
+    ) as s:
         _connect(s, destination, expiration)
         _tls_handshake(s, expiration)
         send_tcp(s, wire, expiration)
-        (r, received_time) = receive_tcp(s, expiration, one_rr_per_rrset,
-                                         q.keyring, q.mac, ignore_trailing)
+        (r, received_time) = receive_tcp(
+            s, expiration, one_rr_per_rrset, q.keyring, q.mac, ignore_trailing
+        )
         r.time = received_time - begin_time
         if not q.is_response(r):
             raise BadResponse
         return r
+    assert (
+        False  # help mypy figure out we can't get here  lgtm[py/unreachable-statement]
+    )
 
 
-def xfr(where, zone, rdtype=dns.rdatatype.AXFR, rdclass=dns.rdataclass.IN,
-        timeout=None, port=53, keyring=None, keyname=None, relativize=True,
-        lifetime=None, source=None, source_port=0, serial=0,
-        use_udp=False, keyalgorithm=dns.tsig.default_algorithm):
+def quic(
+    q: dns.message.Message,
+    where: str,
+    timeout: Optional[float] = None,
+    port: int = 853,
+    source: Optional[str] = None,
+    source_port: int = 0,
+    one_rr_per_rrset: bool = False,
+    ignore_trailing: bool = False,
+    connection: Optional[dns.quic.SyncQuicConnection] = None,
+    verify: Union[bool, str] = True,
+) -> dns.message.Message:
+    """Return the response obtained after sending a query via DNS-over-QUIC.
+
+    *q*, a ``dns.message.Message``, the query to send.
+
+    *where*, a ``str``, the nameserver IP address.
+
+    *timeout*, a ``float`` or ``None``, the number of seconds to wait before the query
+    times out. If ``None``, the default, wait forever.
+
+    *port*, a ``int``, the port to send the query to. The default is 853.
+
+    *source*, a ``str`` containing an IPv4 or IPv6 address, specifying the source
+    address.  The default is the wildcard address.
+
+    *source_port*, an ``int``, the port from which to send the message. The default is
+    0.
+
+    *one_rr_per_rrset*, a ``bool``. If ``True``, put each RR into its own RRset.
+
+    *ignore_trailing*, a ``bool``. If ``True``, ignore trailing junk at end of the
+    received message.
+
+    *connection*, a ``dns.quic.SyncQuicConnection``.  If provided, the
+    connection to use to send the query.
+
+    *verify*, a ``bool`` or ``str``.  If a ``True``, then TLS certificate verification
+    of the server is done using the default CA bundle; if ``False``, then no
+    verification is done; if a `str` then it specifies the path to a certificate file or
+    directory which will be used for verification.
+
+    Returns a ``dns.message.Message``.
+    """
+
+    if not dns.quic.have_quic:
+        raise NoDOQ("DNS-over-QUIC is not available.")  # pragma: no cover
+
+    q.id = 0
+    wire = q.to_wire()
+    the_connection: dns.quic.SyncQuicConnection
+    the_manager: dns.quic.SyncQuicManager
+    if connection:
+        manager: contextlib.AbstractContextManager = contextlib.nullcontext(None)
+        the_connection = connection
+    else:
+        manager = dns.quic.SyncQuicManager(verify_mode=verify)
+        the_manager = manager  # for type checking happiness
+
+    with manager:
+        if not connection:
+            the_connection = the_manager.connect(where, port, source, source_port)
+        start = time.time()
+        with the_connection.make_stream() as stream:
+            stream.send(wire, True)
+            wire = stream.receive(timeout)
+        finish = time.time()
+    r = dns.message.from_wire(
+        wire,
+        keyring=q.keyring,
+        request_mac=q.request_mac,
+        one_rr_per_rrset=one_rr_per_rrset,
+        ignore_trailing=ignore_trailing,
+    )
+    r.time = max(finish - start, 0.0)
+    if not q.is_response(r):
+        raise BadResponse
+    return r
+
+
+def xfr(
+    where: str,
+    zone: Union[dns.name.Name, str],
+    rdtype: Union[dns.rdatatype.RdataType, str] = dns.rdatatype.AXFR,
+    rdclass: Union[dns.rdataclass.RdataClass, str] = dns.rdataclass.IN,
+    timeout: Optional[float] = None,
+    port: int = 53,
+    keyring: Optional[Dict[dns.name.Name, dns.tsig.Key]] = None,
+    keyname: Optional[Union[dns.name.Name, str]] = None,
+    relativize: bool = True,
+    lifetime: Optional[float] = None,
+    source: Optional[str] = None,
+    source_port: int = 0,
+    serial: int = 0,
+    use_udp: bool = False,
+    keyalgorithm: Union[dns.name.Name, str] = dns.tsig.default_algorithm,
+) -> Any:
     """Return a generator for the responses to a zone transfer.
 
     *where*, a ``str`` containing an IPv4 or IPv6 address,  where
@@ -935,16 +1213,16 @@ def xfr(where, zone, rdtype=dns.rdatatype.AXFR, rdclass=dns.rdataclass.IN,
     rdtype = dns.rdatatype.RdataType.make(rdtype)
     q = dns.message.make_query(zone, rdtype, rdclass)
     if rdtype == dns.rdatatype.IXFR:
-        rrset = dns.rrset.from_text(zone, 0, 'IN', 'SOA',
-                                    '. . %u 0 0 0 0' % serial)
+        rrset = dns.rrset.from_text(zone, 0, "IN", "SOA", ". . %u 0 0 0 0" % serial)
         q.authority.append(rrset)
     if keyring is not None:
         q.use_tsig(keyring, keyname, algorithm=keyalgorithm)
     wire = q.to_wire()
-    (af, destination, source) = _destination_and_source(where, port,
-                                                        source, source_port)
+    (af, destination, source) = _destination_and_source(
+        where, port, source, source_port
+    )
     if use_udp and rdtype != dns.rdatatype.IXFR:
-        raise ValueError('cannot do a UDP AXFR')
+        raise ValueError("cannot do a UDP AXFR")
     sock_type = socket.SOCK_DGRAM if use_udp else socket.SOCK_STREAM
     with _make_socket(af, sock_type, source) as s:
         (_, expiration) = _compute_times(lifetime)
@@ -968,8 +1246,9 @@ def xfr(where, zone, rdtype=dns.rdatatype.AXFR, rdclass=dns.rdataclass.IN,
         tsig_ctx = None
         while not done:
             (_, mexpiration) = _compute_times(timeout)
-            if mexpiration is None or \
-               (expiration is not None and mexpiration > expiration):
+            if mexpiration is None or (
+                expiration is not None and mexpiration > expiration
+            ):
                 mexpiration = expiration
             if use_udp:
                 (wire, _) = _udp_recv(s, 65535, mexpiration)
@@ -977,11 +1256,17 @@ def xfr(where, zone, rdtype=dns.rdatatype.AXFR, rdclass=dns.rdataclass.IN,
                 ldata = _net_read(s, 2, mexpiration)
                 (l,) = struct.unpack("!H", ldata)
                 wire = _net_read(s, l, mexpiration)
-            is_ixfr = (rdtype == dns.rdatatype.IXFR)
-            r = dns.message.from_wire(wire, keyring=q.keyring,
-                                      request_mac=q.mac, xfr=True,
-                                      origin=origin, tsig_ctx=tsig_ctx,
-                                      multi=True, one_rr_per_rrset=is_ixfr)
+            is_ixfr = rdtype == dns.rdatatype.IXFR
+            r = dns.message.from_wire(
+                wire,
+                keyring=q.keyring,
+                request_mac=q.mac,
+                xfr=True,
+                origin=origin,
+                tsig_ctx=tsig_ctx,
+                multi=True,
+                one_rr_per_rrset=is_ixfr,
+            )
             rcode = r.rcode()
             if rcode != dns.rcode.NOERROR:
                 raise TransferError(rcode)
@@ -989,8 +1274,7 @@ def xfr(where, zone, rdtype=dns.rdatatype.AXFR, rdclass=dns.rdataclass.IN,
             answer_index = 0
             if soa_rrset is None:
                 if not r.answer or r.answer[0].name != oname:
-                    raise dns.exception.FormError(
-                        "No answer or RRset not for qname")
+                    raise dns.exception.FormError("No answer or RRset not for qname")
                 rrset = r.answer[0]
                 if rrset.rdtype != dns.rdatatype.SOA:
                     raise dns.exception.FormError("first RRset is not an SOA")
@@ -1014,8 +1298,7 @@ def xfr(where, zone, rdtype=dns.rdatatype.AXFR, rdclass=dns.rdataclass.IN,
                 if rrset.rdtype == dns.rdatatype.SOA and rrset.name == oname:
                     if expecting_SOA:
                         if rrset[0].serial != serial:
-                            raise dns.exception.FormError(
-                                "IXFR base serial mismatch")
+                            raise dns.exception.FormError("IXFR base serial mismatch")
                         expecting_SOA = False
                     elif rdtype == dns.rdatatype.IXFR:
                         delete_mode = not delete_mode
@@ -1024,9 +1307,10 @@ def xfr(where, zone, rdtype=dns.rdatatype.AXFR, rdclass=dns.rdataclass.IN,
                     # finished. If this is an IXFR we also check that we're
                     # seeing the record in the expected part of the response.
                     #
-                    if rrset == soa_rrset and \
-                            (rdtype == dns.rdatatype.AXFR or
-                             (rdtype == dns.rdatatype.IXFR and delete_mode)):
+                    if rrset == soa_rrset and (
+                        rdtype == dns.rdatatype.AXFR
+                        or (rdtype == dns.rdatatype.IXFR and delete_mode)
+                    ):
                         done = True
                 elif expecting_SOA:
                     #
@@ -1048,14 +1332,23 @@ class UDPMode(enum.IntEnum):
     TRY_FIRST means "try to use UDP but fall back to TCP if needed"
     ONLY means "raise ``dns.xfr.UseTCP`` if trying UDP does not succeed"
     """
+
     NEVER = 0
     TRY_FIRST = 1
     ONLY = 2
 
 
-def inbound_xfr(where, txn_manager, query=None,
-                port=53, timeout=None, lifetime=None, source=None,
-                source_port=0, udp_mode=UDPMode.NEVER):
+def inbound_xfr(
+    where: str,
+    txn_manager: dns.transaction.TransactionManager,
+    query: Optional[dns.message.Message] = None,
+    port: int = 53,
+    timeout: Optional[float] = None,
+    lifetime: Optional[float] = None,
+    source: Optional[str] = None,
+    source_port: int = 0,
+    udp_mode: UDPMode = UDPMode.NEVER,
+) -> None:
     """Conduct an inbound transfer and apply it via a transaction from the
     txn_manager.
 
@@ -1100,8 +1393,9 @@ def inbound_xfr(where, txn_manager, query=None,
     is_ixfr = rdtype == dns.rdatatype.IXFR
     origin = txn_manager.from_wire_origin()
     wire = query.to_wire()
-    (af, destination, source) = _destination_and_source(where, port,
-                                                        source, source_port)
+    (af, destination, source) = _destination_and_source(
+        where, port, source, source_port
+    )
     (_, expiration) = _compute_times(lifetime)
     retry = True
     while retry:
@@ -1119,14 +1413,14 @@ def inbound_xfr(where, txn_manager, query=None,
             else:
                 tcpmsg = struct.pack("!H", len(wire)) + wire
                 _net_write(s, tcpmsg, expiration)
-            with dns.xfr.Inbound(txn_manager, rdtype, serial,
-                                 is_udp) as inbound:
+            with dns.xfr.Inbound(txn_manager, rdtype, serial, is_udp) as inbound:
                 done = False
                 tsig_ctx = None
                 while not done:
                     (_, mexpiration) = _compute_times(timeout)
-                    if mexpiration is None or \
-                       (expiration is not None and mexpiration > expiration):
+                    if mexpiration is None or (
+                        expiration is not None and mexpiration > expiration
+                    ):
                         mexpiration = expiration
                     if is_udp:
                         (rwire, _) = _udp_recv(s, 65535, mexpiration)
@@ -1134,11 +1428,16 @@ def inbound_xfr(where, txn_manager, query=None,
                         ldata = _net_read(s, 2, mexpiration)
                         (l,) = struct.unpack("!H", ldata)
                         rwire = _net_read(s, l, mexpiration)
-                    r = dns.message.from_wire(rwire, keyring=query.keyring,
-                                              request_mac=query.mac, xfr=True,
-                                              origin=origin, tsig_ctx=tsig_ctx,
-                                              multi=(not is_udp),
-                                              one_rr_per_rrset=is_ixfr)
+                    r = dns.message.from_wire(
+                        rwire,
+                        keyring=query.keyring,
+                        request_mac=query.mac,
+                        xfr=True,
+                        origin=origin,
+                        tsig_ctx=tsig_ctx,
+                        multi=(not is_udp),
+                        one_rr_per_rrset=is_ixfr,
+                    )
                     try:
                         done = inbound.process_message(r)
                     except dns.xfr.UseTCP:
diff --git a/lib/dns/query.pyi b/lib/dns/query.pyi
deleted file mode 100644
index a22e229f..00000000
--- a/lib/dns/query.pyi
+++ /dev/null
@@ -1,64 +0,0 @@
-from typing import Optional, Union, Dict, Generator, Any
-from . import tsig, rdatatype, rdataclass, name, message
-from requests.sessions import Session
-
-import socket
-
-# If the ssl import works, then
-#
-#    error: Name 'ssl' already defined (by an import)
-#
-# is expected and can be ignored.
-try:
-    import ssl
-except ImportError:
-    class ssl:    # type: ignore
-        SSLContext : Dict = {}
-
-have_doh: bool
-
-def https(q : message.Message, where: str, timeout : Optional[float] = None,
-          port : Optional[int] = 443, source : Optional[str] = None,
-          source_port : Optional[int] = 0,
-          session: Optional[Session] = None,
-          path : Optional[str] = '/dns-query', post : Optional[bool] = True,
-          bootstrap_address : Optional[str] = None,
-          verify : Optional[bool] = True) -> message.Message:
-    pass
-
-def tcp(q : message.Message, where : str, timeout : float = None, port=53,
-        af : Optional[int] = None, source : Optional[str] = None,
-        source_port : Optional[int] = 0,
-        one_rr_per_rrset : Optional[bool] = False,
-        ignore_trailing : Optional[bool] = False,
-        sock : Optional[socket.socket] = None) -> message.Message:
-    pass
-
-def xfr(where : None, zone : Union[name.Name,str], rdtype=rdatatype.AXFR,
-        rdclass=rdataclass.IN,
-        timeout : Optional[float] = None, port=53,
-        keyring : Optional[Dict[name.Name, bytes]] = None,
-        keyname : Union[str,name.Name]= None, relativize=True,
-        lifetime : Optional[float] = None,
-        source : Optional[str] = None, source_port=0, serial=0,
-        use_udp : Optional[bool] = False,
-        keyalgorithm=tsig.default_algorithm) \
-        -> Generator[Any,Any,message.Message]:
-    pass
-
-def udp(q : message.Message, where : str, timeout : Optional[float] = None,
-        port=53, source : Optional[str] = None, source_port : Optional[int] = 0,
-        ignore_unexpected : Optional[bool] = False,
-        one_rr_per_rrset : Optional[bool] = False,
-        ignore_trailing : Optional[bool] = False,
-        sock : Optional[socket.socket] = None) -> message.Message:
-    pass
-
-def tls(q : message.Message, where : str, timeout : Optional[float] = None,
-        port=53, source : Optional[str] = None, source_port : Optional[int] = 0,
-        one_rr_per_rrset : Optional[bool] = False,
-        ignore_trailing : Optional[bool] = False,
-        sock : Optional[socket.socket] = None,
-        ssl_context: Optional[ssl.SSLContext] = None,
-        server_hostname: Optional[str] = None) -> message.Message:
-    pass
diff --git a/lib/dns/quic/__init__.py b/lib/dns/quic/__init__.py
new file mode 100644
index 00000000..f48ecf57
--- /dev/null
+++ b/lib/dns/quic/__init__.py
@@ -0,0 +1,74 @@
+# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license
+
+try:
+    import aioquic.quic.configuration  # type: ignore
+
+    import dns.asyncbackend
+    from dns._asyncbackend import NullContext
+    from dns.quic._sync import SyncQuicManager, SyncQuicConnection, SyncQuicStream
+    from dns.quic._asyncio import (
+        AsyncioQuicManager,
+        AsyncioQuicConnection,
+        AsyncioQuicStream,
+    )
+    from dns.quic._common import AsyncQuicConnection, AsyncQuicManager
+
+    have_quic = True
+
+    def null_factory(
+        *args,  # pylint: disable=unused-argument
+        **kwargs  # pylint: disable=unused-argument
+    ):
+        return NullContext(None)
+
+    def _asyncio_manager_factory(
+        context, *args, **kwargs  # pylint: disable=unused-argument
+    ):
+        return AsyncioQuicManager(*args, **kwargs)
+
+    # We have a context factory and a manager factory as for trio we need to have
+    # a nursery.
+
+    _async_factories = {"asyncio": (null_factory, _asyncio_manager_factory)}
+
+    try:
+        import trio
+        from dns.quic._trio import (  # pylint: disable=ungrouped-imports
+            TrioQuicManager,
+            TrioQuicConnection,
+            TrioQuicStream,
+        )
+
+        def _trio_context_factory():
+            return trio.open_nursery()
+
+        def _trio_manager_factory(context, *args, **kwargs):
+            return TrioQuicManager(context, *args, **kwargs)
+
+        _async_factories["trio"] = (_trio_context_factory, _trio_manager_factory)
+    except ImportError:
+        pass
+
+    def factories_for_backend(backend=None):
+        if backend is None:
+            backend = dns.asyncbackend.get_default_backend()
+        return _async_factories[backend.name()]
+
+except ImportError:
+    have_quic = False
+
+    from typing import Any
+
+    class AsyncQuicStream:  # type: ignore
+        pass
+
+    class AsyncQuicConnection:  # type: ignore
+        async def make_stream(self) -> Any:
+            raise NotImplementedError
+
+    class SyncQuicStream:  # type: ignore
+        pass
+
+    class SyncQuicConnection:  # type: ignore
+        def make_stream(self) -> Any:
+            raise NotImplementedError
diff --git a/lib/dns/quic/_asyncio.py b/lib/dns/quic/_asyncio.py
new file mode 100644
index 00000000..0a2e220d
--- /dev/null
+++ b/lib/dns/quic/_asyncio.py
@@ -0,0 +1,206 @@
+# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license
+
+import asyncio
+import socket
+import ssl
+import struct
+import time
+
+import aioquic.quic.configuration  # type: ignore
+import aioquic.quic.connection  # type: ignore
+import aioquic.quic.events  # type: ignore
+import dns.inet
+import dns.asyncbackend
+
+from dns.quic._common import (
+    BaseQuicStream,
+    AsyncQuicConnection,
+    AsyncQuicManager,
+    QUIC_MAX_DATAGRAM,
+)
+
+
+class AsyncioQuicStream(BaseQuicStream):
+    def __init__(self, connection, stream_id):
+        super().__init__(connection, stream_id)
+        self._wake_up = asyncio.Condition()
+
+    async def _wait_for_wake_up(self):
+        async with self._wake_up:
+            await self._wake_up.wait()
+
+    async def wait_for(self, amount, expiration):
+        timeout = self._timeout_from_expiration(expiration)
+        while True:
+            if self._buffer.have(amount):
+                return
+            self._expecting = amount
+            try:
+                await asyncio.wait_for(self._wait_for_wake_up(), timeout)
+            except Exception:
+                pass
+            self._expecting = 0
+
+    async def receive(self, timeout=None):
+        expiration = self._expiration_from_timeout(timeout)
+        await self.wait_for(2, expiration)
+        (size,) = struct.unpack("!H", self._buffer.get(2))
+        await self.wait_for(size, expiration)
+        return self._buffer.get(size)
+
+    async def send(self, datagram, is_end=False):
+        data = self._encapsulate(datagram)
+        await self._connection.write(self._stream_id, data, is_end)
+
+    async def _add_input(self, data, is_end):
+        if self._common_add_input(data, is_end):
+            async with self._wake_up:
+                self._wake_up.notify()
+
+    async def close(self):
+        self._close()
+
+    # Streams are async context managers
+
+    async def __aenter__(self):
+        return self
+
+    async def __aexit__(self, exc_type, exc_val, exc_tb):
+        await self.close()
+        async with self._wake_up:
+            self._wake_up.notify()
+        return False
+
+
+class AsyncioQuicConnection(AsyncQuicConnection):
+    def __init__(self, connection, address, port, source, source_port, manager=None):
+        super().__init__(connection, address, port, source, source_port, manager)
+        self._socket = None
+        self._handshake_complete = asyncio.Event()
+        self._socket_created = asyncio.Event()
+        self._wake_timer = asyncio.Condition()
+        self._receiver_task = None
+        self._sender_task = None
+
+    async def _receiver(self):
+        try:
+            af = dns.inet.af_for_address(self._address)
+            backend = dns.asyncbackend.get_backend("asyncio")
+            self._socket = await backend.make_socket(
+                af, socket.SOCK_DGRAM, 0, self._source, self._peer
+            )
+            self._socket_created.set()
+            async with self._socket:
+                while not self._done:
+                    (datagram, address) = await self._socket.recvfrom(
+                        QUIC_MAX_DATAGRAM, None
+                    )
+                    if address[0] != self._peer[0] or address[1] != self._peer[1]:
+                        continue
+                    self._connection.receive_datagram(
+                        datagram, self._peer[0], time.time()
+                    )
+                    # Wake up the timer in case the sender is sleeping, as there may be
+                    # stuff to send now.
+                    async with self._wake_timer:
+                        self._wake_timer.notify_all()
+        except Exception:
+            pass
+
+    async def _wait_for_wake_timer(self):
+        async with self._wake_timer:
+            await self._wake_timer.wait()
+
+    async def _sender(self):
+        await self._socket_created.wait()
+        while not self._done:
+            datagrams = self._connection.datagrams_to_send(time.time())
+            for (datagram, address) in datagrams:
+                assert address == self._peer[0]
+                await self._socket.sendto(datagram, self._peer, None)
+            (expiration, interval) = self._get_timer_values()
+            try:
+                await asyncio.wait_for(self._wait_for_wake_timer(), interval)
+            except Exception:
+                pass
+            self._handle_timer(expiration)
+            await self._handle_events()
+
+    async def _handle_events(self):
+        count = 0
+        while True:
+            event = self._connection.next_event()
+            if event is None:
+                return
+            if isinstance(event, aioquic.quic.events.StreamDataReceived):
+                stream = self._streams.get(event.stream_id)
+                if stream:
+                    await stream._add_input(event.data, event.end_stream)
+            elif isinstance(event, aioquic.quic.events.HandshakeCompleted):
+                self._handshake_complete.set()
+            elif isinstance(
+                event, aioquic.quic.events.ConnectionTerminated
+            ) or isinstance(event, aioquic.quic.events.StreamReset):
+                self._done = True
+                self._receiver_task.cancel()
+            count += 1
+            if count > 10:
+                # yield
+                count = 0
+                await asyncio.sleep(0)
+
+    async def write(self, stream, data, is_end=False):
+        self._connection.send_stream_data(stream, data, is_end)
+        async with self._wake_timer:
+            self._wake_timer.notify_all()
+
+    def run(self):
+        if self._closed:
+            return
+        self._receiver_task = asyncio.Task(self._receiver())
+        self._sender_task = asyncio.Task(self._sender())
+
+    async def make_stream(self):
+        await self._handshake_complete.wait()
+        stream_id = self._connection.get_next_available_stream_id(False)
+        stream = AsyncioQuicStream(self, stream_id)
+        self._streams[stream_id] = stream
+        return stream
+
+    async def close(self):
+        if not self._closed:
+            self._manager.closed(self._peer[0], self._peer[1])
+            self._closed = True
+            self._connection.close()
+            async with self._wake_timer:
+                self._wake_timer.notify_all()
+            try:
+                await self._receiver_task
+            except asyncio.CancelledError:
+                pass
+            try:
+                await self._sender_task
+            except asyncio.CancelledError:
+                pass
+
+
+class AsyncioQuicManager(AsyncQuicManager):
+    def __init__(self, conf=None, verify_mode=ssl.CERT_REQUIRED):
+        super().__init__(conf, verify_mode, AsyncioQuicConnection)
+
+    def connect(self, address, port=853, source=None, source_port=0):
+        (connection, start) = self._connect(address, port, source, source_port)
+        if start:
+            connection.run()
+        return connection
+
+    async def __aenter__(self):
+        return self
+
+    async def __aexit__(self, exc_type, exc_val, exc_tb):
+        # Copy the itertor into a list as exiting things will mutate the connections
+        # table.
+        connections = list(self._connections.values())
+        for connection in connections:
+            await connection.close()
+        return False
diff --git a/lib/dns/quic/_common.py b/lib/dns/quic/_common.py
new file mode 100644
index 00000000..d8f6f7fd
--- /dev/null
+++ b/lib/dns/quic/_common.py
@@ -0,0 +1,180 @@
+# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license
+
+import socket
+import struct
+import time
+
+from typing import Any
+
+import aioquic.quic.configuration  # type: ignore
+import aioquic.quic.connection  # type: ignore
+import dns.inet
+
+
+QUIC_MAX_DATAGRAM = 2048
+
+
+class UnexpectedEOF(Exception):
+    pass
+
+
+class Buffer:
+    def __init__(self):
+        self._buffer = b""
+        self._seen_end = False
+
+    def put(self, data, is_end):
+        if self._seen_end:
+            return
+        self._buffer += data
+        if is_end:
+            self._seen_end = True
+
+    def have(self, amount):
+        if len(self._buffer) >= amount:
+            return True
+        if self._seen_end:
+            raise UnexpectedEOF
+        return False
+
+    def seen_end(self):
+        return self._seen_end
+
+    def get(self, amount):
+        assert self.have(amount)
+        data = self._buffer[:amount]
+        self._buffer = self._buffer[amount:]
+        return data
+
+
+class BaseQuicStream:
+    def __init__(self, connection, stream_id):
+        self._connection = connection
+        self._stream_id = stream_id
+        self._buffer = Buffer()
+        self._expecting = 0
+
+    def id(self):
+        return self._stream_id
+
+    def _expiration_from_timeout(self, timeout):
+        if timeout is not None:
+            expiration = time.time() + timeout
+        else:
+            expiration = None
+        return expiration
+
+    def _timeout_from_expiration(self, expiration):
+        if expiration is not None:
+            timeout = max(expiration - time.time(), 0.0)
+        else:
+            timeout = None
+        return timeout
+
+    # Subclass must implement receive() as sync / async and which returns a message
+    # or raises UnexpectedEOF.
+
+    def _encapsulate(self, datagram):
+        l = len(datagram)
+        return struct.pack("!H", l) + datagram
+
+    def _common_add_input(self, data, is_end):
+        self._buffer.put(data, is_end)
+        return self._expecting > 0 and self._buffer.have(self._expecting)
+
+    def _close(self):
+        self._connection.close_stream(self._stream_id)
+        self._buffer.put(b"", True)  # send EOF in case we haven't seen it.
+
+
+class BaseQuicConnection:
+    def __init__(
+        self, connection, address, port, source=None, source_port=0, manager=None
+    ):
+        self._done = False
+        self._connection = connection
+        self._address = address
+        self._port = port
+        self._closed = False
+        self._manager = manager
+        self._streams = {}
+        self._af = dns.inet.af_for_address(address)
+        self._peer = dns.inet.low_level_address_tuple((address, port))
+        if source is None and source_port != 0:
+            if self._af == socket.AF_INET:
+                source = "0.0.0.0"
+            elif self._af == socket.AF_INET6:
+                source = "::"
+            else:
+                raise NotImplementedError
+        if source:
+            self._source = (source, source_port)
+        else:
+            self._source = None
+
+    def close_stream(self, stream_id):
+        del self._streams[stream_id]
+
+    def _get_timer_values(self, closed_is_special=True):
+        now = time.time()
+        expiration = self._connection.get_timer()
+        if expiration is None:
+            expiration = now + 3600  # arbitrary "big" value
+        interval = max(expiration - now, 0)
+        if self._closed and closed_is_special:
+            # lower sleep interval to avoid a race in the closing process
+            # which can lead to higher latency closing due to sleeping when
+            # we have events.
+            interval = min(interval, 0.05)
+        return (expiration, interval)
+
+    def _handle_timer(self, expiration):
+        now = time.time()
+        if expiration <= now:
+            self._connection.handle_timer(now)
+
+
+class AsyncQuicConnection(BaseQuicConnection):
+    async def make_stream(self) -> Any:
+        pass
+
+
+class BaseQuicManager:
+    def __init__(self, conf, verify_mode, connection_factory):
+        self._connections = {}
+        self._connection_factory = connection_factory
+        if conf is None:
+            verify_path = None
+            if isinstance(verify_mode, str):
+                verify_path = verify_mode
+                verify_mode = True
+            conf = aioquic.quic.configuration.QuicConfiguration(
+                alpn_protocols=["doq", "doq-i03"],
+                verify_mode=verify_mode,
+            )
+            if verify_path is not None:
+                conf.load_verify_locations(verify_path)
+        self._conf = conf
+
+    def _connect(self, address, port=853, source=None, source_port=0):
+        connection = self._connections.get((address, port))
+        if connection is not None:
+            return (connection, False)
+        qconn = aioquic.quic.connection.QuicConnection(configuration=self._conf)
+        qconn.connect(address, time.time())
+        connection = self._connection_factory(
+            qconn, address, port, source, source_port, self
+        )
+        self._connections[(address, port)] = connection
+        return (connection, True)
+
+    def closed(self, address, port):
+        try:
+            del self._connections[(address, port)]
+        except KeyError:
+            pass
+
+
+class AsyncQuicManager(BaseQuicManager):
+    def connect(self, address, port=853, source=None, source_port=0):
+        raise NotImplementedError
diff --git a/lib/dns/quic/_sync.py b/lib/dns/quic/_sync.py
new file mode 100644
index 00000000..be005ba9
--- /dev/null
+++ b/lib/dns/quic/_sync.py
@@ -0,0 +1,214 @@
+# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license
+
+import socket
+import ssl
+import selectors
+import struct
+import threading
+import time
+
+import aioquic.quic.configuration  # type: ignore
+import aioquic.quic.connection  # type: ignore
+import aioquic.quic.events  # type: ignore
+import dns.inet
+
+from dns.quic._common import (
+    BaseQuicStream,
+    BaseQuicConnection,
+    BaseQuicManager,
+    QUIC_MAX_DATAGRAM,
+)
+
+# Avoid circularity with dns.query
+if hasattr(selectors, "PollSelector"):
+    _selector_class = selectors.PollSelector  # type: ignore
+else:
+    _selector_class = selectors.SelectSelector  # type: ignore
+
+
+class SyncQuicStream(BaseQuicStream):
+    def __init__(self, connection, stream_id):
+        super().__init__(connection, stream_id)
+        self._wake_up = threading.Condition()
+        self._lock = threading.Lock()
+
+    def wait_for(self, amount, expiration):
+        timeout = self._timeout_from_expiration(expiration)
+        while True:
+            with self._lock:
+                if self._buffer.have(amount):
+                    return
+                self._expecting = amount
+            with self._wake_up:
+                self._wake_up.wait(timeout)
+            self._expecting = 0
+
+    def receive(self, timeout=None):
+        expiration = self._expiration_from_timeout(timeout)
+        self.wait_for(2, expiration)
+        with self._lock:
+            (size,) = struct.unpack("!H", self._buffer.get(2))
+        self.wait_for(size, expiration)
+        with self._lock:
+            return self._buffer.get(size)
+
+    def send(self, datagram, is_end=False):
+        data = self._encapsulate(datagram)
+        self._connection.write(self._stream_id, data, is_end)
+
+    def _add_input(self, data, is_end):
+        if self._common_add_input(data, is_end):
+            with self._wake_up:
+                self._wake_up.notify()
+
+    def close(self):
+        with self._lock:
+            self._close()
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        self.close()
+        with self._wake_up:
+            self._wake_up.notify()
+        return False
+
+
+class SyncQuicConnection(BaseQuicConnection):
+    def __init__(self, connection, address, port, source, source_port, manager):
+        super().__init__(connection, address, port, source, source_port, manager)
+        self._socket = socket.socket(self._af, socket.SOCK_DGRAM, 0)
+        self._socket.connect(self._peer)
+        (self._send_wakeup, self._receive_wakeup) = socket.socketpair()
+        self._receive_wakeup.setblocking(False)
+        self._socket.setblocking(False)
+        if self._source is not None:
+            try:
+                self._socket.bind(
+                    dns.inet.low_level_address_tuple(self._source, self._af)
+                )
+            except Exception:
+                self._socket.close()
+                raise
+        self._handshake_complete = threading.Event()
+        self._worker_thread = None
+        self._lock = threading.Lock()
+
+    def _read(self):
+        count = 0
+        while count < 10:
+            count += 1
+            try:
+                datagram = self._socket.recv(QUIC_MAX_DATAGRAM)
+            except BlockingIOError:
+                return
+            with self._lock:
+                self._connection.receive_datagram(datagram, self._peer[0], time.time())
+
+    def _drain_wakeup(self):
+        while True:
+            try:
+                self._receive_wakeup.recv(32)
+            except BlockingIOError:
+                return
+
+    def _worker(self):
+        sel = _selector_class()
+        sel.register(self._socket, selectors.EVENT_READ, self._read)
+        sel.register(self._receive_wakeup, selectors.EVENT_READ, self._drain_wakeup)
+        while not self._done:
+            (expiration, interval) = self._get_timer_values(False)
+            items = sel.select(interval)
+            for (key, _) in items:
+                key.data()
+            with self._lock:
+                self._handle_timer(expiration)
+                datagrams = self._connection.datagrams_to_send(time.time())
+            for (datagram, _) in datagrams:
+                try:
+                    self._socket.send(datagram)
+                except BlockingIOError:
+                    # we let QUIC handle any lossage
+                    pass
+            self._handle_events()
+
+    def _handle_events(self):
+        while True:
+            with self._lock:
+                event = self._connection.next_event()
+            if event is None:
+                return
+            if isinstance(event, aioquic.quic.events.StreamDataReceived):
+                with self._lock:
+                    stream = self._streams.get(event.stream_id)
+                if stream:
+                    stream._add_input(event.data, event.end_stream)
+            elif isinstance(event, aioquic.quic.events.HandshakeCompleted):
+                self._handshake_complete.set()
+            elif isinstance(
+                event, aioquic.quic.events.ConnectionTerminated
+            ) or isinstance(event, aioquic.quic.events.StreamReset):
+                with self._lock:
+                    self._done = True
+
+    def write(self, stream, data, is_end=False):
+        with self._lock:
+            self._connection.send_stream_data(stream, data, is_end)
+        self._send_wakeup.send(b"\x01")
+
+    def run(self):
+        if self._closed:
+            return
+        self._worker_thread = threading.Thread(target=self._worker)
+        self._worker_thread.start()
+
+    def make_stream(self):
+        self._handshake_complete.wait()
+        with self._lock:
+            stream_id = self._connection.get_next_available_stream_id(False)
+            stream = SyncQuicStream(self, stream_id)
+            self._streams[stream_id] = stream
+        return stream
+
+    def close_stream(self, stream_id):
+        with self._lock:
+            super().close_stream(stream_id)
+
+    def close(self):
+        with self._lock:
+            if self._closed:
+                return
+            self._manager.closed(self._peer[0], self._peer[1])
+            self._closed = True
+            self._connection.close()
+            self._send_wakeup.send(b"\x01")
+        self._worker_thread.join()
+
+
+class SyncQuicManager(BaseQuicManager):
+    def __init__(self, conf=None, verify_mode=ssl.CERT_REQUIRED):
+        super().__init__(conf, verify_mode, SyncQuicConnection)
+        self._lock = threading.Lock()
+
+    def connect(self, address, port=853, source=None, source_port=0):
+        with self._lock:
+            (connection, start) = self._connect(address, port, source, source_port)
+            if start:
+                connection.run()
+            return connection
+
+    def closed(self, address, port):
+        with self._lock:
+            super().closed(address, port)
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        # Copy the itertor into a list as exiting things will mutate the connections
+        # table.
+        connections = list(self._connections.values())
+        for connection in connections:
+            connection.close()
+        return False
diff --git a/lib/dns/quic/_trio.py b/lib/dns/quic/_trio.py
new file mode 100644
index 00000000..1e47a5a6
--- /dev/null
+++ b/lib/dns/quic/_trio.py
@@ -0,0 +1,170 @@
+# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license
+
+import socket
+import ssl
+import struct
+import time
+
+import aioquic.quic.configuration  # type: ignore
+import aioquic.quic.connection  # type: ignore
+import aioquic.quic.events  # type: ignore
+import trio
+
+import dns.inet
+from dns._asyncbackend import NullContext
+from dns.quic._common import (
+    BaseQuicStream,
+    AsyncQuicConnection,
+    AsyncQuicManager,
+    QUIC_MAX_DATAGRAM,
+)
+
+
+class TrioQuicStream(BaseQuicStream):
+    def __init__(self, connection, stream_id):
+        super().__init__(connection, stream_id)
+        self._wake_up = trio.Condition()
+
+    async def wait_for(self, amount):
+        while True:
+            if self._buffer.have(amount):
+                return
+            self._expecting = amount
+            async with self._wake_up:
+                await self._wake_up.wait()
+            self._expecting = 0
+
+    async def receive(self, timeout=None):
+        if timeout is None:
+            context = NullContext(None)
+        else:
+            context = trio.move_on_after(timeout)
+        with context:
+            await self.wait_for(2)
+            (size,) = struct.unpack("!H", self._buffer.get(2))
+            await self.wait_for(size)
+            return self._buffer.get(size)
+
+    async def send(self, datagram, is_end=False):
+        data = self._encapsulate(datagram)
+        await self._connection.write(self._stream_id, data, is_end)
+
+    async def _add_input(self, data, is_end):
+        if self._common_add_input(data, is_end):
+            async with self._wake_up:
+                self._wake_up.notify()
+
+    async def close(self):
+        self._close()
+
+    # Streams are async context managers
+
+    async def __aenter__(self):
+        return self
+
+    async def __aexit__(self, exc_type, exc_val, exc_tb):
+        await self.close()
+        async with self._wake_up:
+            self._wake_up.notify()
+        return False
+
+
+class TrioQuicConnection(AsyncQuicConnection):
+    def __init__(self, connection, address, port, source, source_port, manager=None):
+        super().__init__(connection, address, port, source, source_port, manager)
+        self._socket = trio.socket.socket(self._af, socket.SOCK_DGRAM, 0)
+        if self._source:
+            trio.socket.bind(dns.inet.low_level_address_tuple(self._source, self._af))
+        self._handshake_complete = trio.Event()
+        self._run_done = trio.Event()
+        self._worker_scope = None
+
+    async def _worker(self):
+        await self._socket.connect(self._peer)
+        while not self._done:
+            (expiration, interval) = self._get_timer_values(False)
+            with trio.CancelScope(
+                deadline=trio.current_time() + interval
+            ) as self._worker_scope:
+                datagram = await self._socket.recv(QUIC_MAX_DATAGRAM)
+                self._connection.receive_datagram(datagram, self._peer[0], time.time())
+            self._worker_scope = None
+            self._handle_timer(expiration)
+            datagrams = self._connection.datagrams_to_send(time.time())
+            for (datagram, _) in datagrams:
+                await self._socket.send(datagram)
+            await self._handle_events()
+
+    async def _handle_events(self):
+        count = 0
+        while True:
+            event = self._connection.next_event()
+            if event is None:
+                return
+            if isinstance(event, aioquic.quic.events.StreamDataReceived):
+                stream = self._streams.get(event.stream_id)
+                if stream:
+                    await stream._add_input(event.data, event.end_stream)
+            elif isinstance(event, aioquic.quic.events.HandshakeCompleted):
+                self._handshake_complete.set()
+            elif isinstance(
+                event, aioquic.quic.events.ConnectionTerminated
+            ) or isinstance(event, aioquic.quic.events.StreamReset):
+                self._done = True
+                self._socket.close()
+            count += 1
+            if count > 10:
+                # yield
+                count = 0
+                await trio.sleep(0)
+
+    async def write(self, stream, data, is_end=False):
+        self._connection.send_stream_data(stream, data, is_end)
+        if self._worker_scope is not None:
+            self._worker_scope.cancel()
+
+    async def run(self):
+        if self._closed:
+            return
+        async with trio.open_nursery() as nursery:
+            nursery.start_soon(self._worker)
+        self._run_done.set()
+
+    async def make_stream(self):
+        await self._handshake_complete.wait()
+        stream_id = self._connection.get_next_available_stream_id(False)
+        stream = TrioQuicStream(self, stream_id)
+        self._streams[stream_id] = stream
+        return stream
+
+    async def close(self):
+        if not self._closed:
+            self._manager.closed(self._peer[0], self._peer[1])
+            self._closed = True
+            self._connection.close()
+            if self._worker_scope is not None:
+                self._worker_scope.cancel()
+            await self._run_done.wait()
+
+
+class TrioQuicManager(AsyncQuicManager):
+    def __init__(self, nursery, conf=None, verify_mode=ssl.CERT_REQUIRED):
+        super().__init__(conf, verify_mode, TrioQuicConnection)
+        self._nursery = nursery
+
+    def connect(self, address, port=853, source=None, source_port=0):
+        (connection, start) = self._connect(address, port, source, source_port)
+        if start:
+            self._nursery.start_soon(connection.run)
+        return connection
+
+    async def __aenter__(self):
+        return self
+
+    async def __aexit__(self, exc_type, exc_val, exc_tb):
+        # Copy the itertor into a list as exiting things will mutate the connections
+        # table.
+        connections = list(self._connections.values())
+        for connection in connections:
+            await connection.close()
+        return False
diff --git a/lib/dns/rcode.py b/lib/dns/rcode.py
index 49fee695..8e6386f8 100644
--- a/lib/dns/rcode.py
+++ b/lib/dns/rcode.py
@@ -17,9 +17,12 @@
 
 """DNS Result Codes."""
 
+from typing import Tuple
+
 import dns.enum
 import dns.exception
 
+
 class Rcode(dns.enum.IntEnum):
     #: No error
     NOERROR = 0
@@ -77,20 +80,20 @@ class UnknownRcode(dns.exception.DNSException):
     """A DNS rcode is unknown."""
 
 
-def from_text(text):
+def from_text(text: str) -> Rcode:
     """Convert text into an rcode.
 
     *text*, a ``str``, the textual rcode or an integer in textual form.
 
     Raises ``dns.rcode.UnknownRcode`` if the rcode mnemonic is unknown.
 
-    Returns an ``int``.
+    Returns a ``dns.rcode.Rcode``.
     """
 
     return Rcode.from_text(text)
 
 
-def from_flags(flags, ednsflags):
+def from_flags(flags: int, ednsflags: int) -> Rcode:
     """Return the rcode value encoded by flags and ednsflags.
 
     *flags*, an ``int``, the DNS flags field.
@@ -99,17 +102,17 @@ def from_flags(flags, ednsflags):
 
     Raises ``ValueError`` if rcode is < 0 or > 4095
 
-    Returns an ``int``.
+    Returns a ``dns.rcode.Rcode``.
     """
 
-    value = (flags & 0x000f) | ((ednsflags >> 20) & 0xff0)
-    return value
+    value = (flags & 0x000F) | ((ednsflags >> 20) & 0xFF0)
+    return Rcode.make(value)
 
 
-def to_flags(value):
+def to_flags(value: Rcode) -> Tuple[int, int]:
     """Return a (flags, ednsflags) tuple which encodes the rcode.
 
-    *value*, an ``int``, the rcode.
+    *value*, a ``dns.rcode.Rcode``, the rcode.
 
     Raises ``ValueError`` if rcode is < 0 or > 4095.
 
@@ -117,16 +120,16 @@ def to_flags(value):
     """
 
     if value < 0 or value > 4095:
-        raise ValueError('rcode must be >= 0 and <= 4095')
-    v = value & 0xf
-    ev = (value & 0xff0) << 20
+        raise ValueError("rcode must be >= 0 and <= 4095")
+    v = value & 0xF
+    ev = (value & 0xFF0) << 20
     return (v, ev)
 
 
-def to_text(value, tsig=False):
+def to_text(value: Rcode, tsig: bool = False) -> str:
     """Convert rcode into text.
 
-    *value*, an ``int``, the rcode.
+    *value*, a ``dns.rcode.Rcode``, the rcode.
 
     Raises ``ValueError`` if rcode is < 0 or > 4095.
 
@@ -134,9 +137,10 @@ def to_text(value, tsig=False):
     """
 
     if tsig and value == Rcode.BADVERS:
-        return 'BADSIG'
+        return "BADSIG"
     return Rcode.to_text(value)
 
+
 ### BEGIN generated Rcode constants
 
 NOERROR = Rcode.NOERROR
diff --git a/lib/dns/rdata.py b/lib/dns/rdata.py
index 6b5b5c5a..1dd6ed90 100644
--- a/lib/dns/rdata.py
+++ b/lib/dns/rdata.py
@@ -17,6 +17,8 @@
 
 """DNS rdata."""
 
+from typing import Any, Dict, Optional, Tuple, Union
+
 from importlib import import_module
 import base64
 import binascii
@@ -55,21 +57,22 @@ class NoRelativeRdataOrdering(dns.exception.DNSException):
     """
 
 
-def _wordbreak(data, chunksize=_chunksize, separator=b' '):
+def _wordbreak(data, chunksize=_chunksize, separator=b" "):
     """Break a binary string into chunks of chunksize characters separated by
     a space.
     """
 
     if not chunksize:
         return data.decode()
-    return separator.join([data[i:i + chunksize]
-                           for i
-                           in range(0, len(data), chunksize)]).decode()
+    return separator.join(
+        [data[i : i + chunksize] for i in range(0, len(data), chunksize)]
+    ).decode()
 
 
 # pylint: disable=unused-argument
 
-def _hexify(data, chunksize=_chunksize, separator=b' ', **kw):
+
+def _hexify(data, chunksize=_chunksize, separator=b" ", **kw):
     """Convert a binary string into its hex encoding, broken up into chunks
     of chunksize characters separated by a separator.
     """
@@ -77,17 +80,19 @@ def _hexify(data, chunksize=_chunksize, separator=b' ', **kw):
     return _wordbreak(binascii.hexlify(data), chunksize, separator)
 
 
-def _base64ify(data, chunksize=_chunksize, separator=b' ', **kw):
+def _base64ify(data, chunksize=_chunksize, separator=b" ", **kw):
     """Convert a binary string into its base64 encoding, broken up into chunks
     of chunksize characters separated by a separator.
     """
 
     return _wordbreak(base64.b64encode(data), chunksize, separator)
 
+
 # pylint: enable=unused-argument
 
 __escaped = b'"\\'
 
+
 def _escapify(qstring):
     """Escape the characters in a quoted string which need it."""
 
@@ -96,14 +101,14 @@ def _escapify(qstring):
     if not isinstance(qstring, bytearray):
         qstring = bytearray(qstring)
 
-    text = ''
+    text = ""
     for c in qstring:
         if c in __escaped:
-            text += '\\' + chr(c)
+            text += "\\" + chr(c)
         elif c >= 0x20 and c < 0x7F:
             text += chr(c)
         else:
-            text += '\\%03d' % c
+            text += "\\%03d" % c
     return text
 
 
@@ -114,9 +119,10 @@ def _truncate_bitmap(what):
 
     for i in range(len(what) - 1, -1, -1):
         if what[i] != 0:
-            return what[0: i + 1]
+            return what[0 : i + 1]
     return what[0:1]
 
+
 # So we don't have to edit all the rdata classes...
 _constify = dns.immutable.constify
 
@@ -125,7 +131,7 @@ _constify = dns.immutable.constify
 class Rdata:
     """Base class for all DNS rdata types."""
 
-    __slots__ = ['rdclass', 'rdtype', 'rdcomment']
+    __slots__ = ["rdclass", "rdtype", "rdcomment"]
 
     def __init__(self, rdclass, rdtype):
         """Initialize an rdata.
@@ -140,8 +146,9 @@ class Rdata:
         self.rdcomment = None
 
     def _get_all_slots(self):
-        return itertools.chain.from_iterable(getattr(cls, '__slots__', [])
-                                             for cls in self.__class__.__mro__)
+        return itertools.chain.from_iterable(
+            getattr(cls, "__slots__", []) for cls in self.__class__.__mro__
+        )
 
     def __getstate__(self):
         # We used to try to do a tuple of all slots here, but it
@@ -160,12 +167,12 @@ class Rdata:
     def __setstate__(self, state):
         for slot, val in state.items():
             object.__setattr__(self, slot, val)
-        if not hasattr(self, 'rdcomment'):
+        if not hasattr(self, "rdcomment"):
             # Pickled rdata from 2.0.x might not have a rdcomment, so add
             # it if needed.
-            object.__setattr__(self, 'rdcomment', None)
+            object.__setattr__(self, "rdcomment", None)
 
-    def covers(self):
+    def covers(self) -> dns.rdatatype.RdataType:
         """Return the type a Rdata covers.
 
         DNS SIG/RRSIG rdatas apply to a specific type; this type is
@@ -174,12 +181,12 @@ class Rdata:
         creating rdatasets, allowing the rdataset to contain only RRSIGs
         of a particular type, e.g. RRSIG(NS).
 
-        Returns an ``int``.
+        Returns a ``dns.rdatatype.RdataType``.
         """
 
         return dns.rdatatype.NONE
 
-    def extended_rdatatype(self):
+    def extended_rdatatype(self) -> int:
         """Return a 32-bit type value, the least significant 16 bits of
         which are the ordinary DNS type, and the upper 16 bits of which are
         the "covered" type, if any.
@@ -189,7 +196,12 @@ class Rdata:
 
         return self.covers() << 16 | self.rdtype
 
-    def to_text(self, origin=None, relativize=True, **kw):
+    def to_text(
+        self,
+        origin: Optional[dns.name.Name] = None,
+        relativize: bool = True,
+        **kw: Dict[str, Any]
+    ) -> str:
         """Convert an rdata to text format.
 
         Returns a ``str``.
@@ -197,11 +209,22 @@ class Rdata:
 
         raise NotImplementedError  # pragma: no cover
 
-    def _to_wire(self, file, compress=None, origin=None, canonicalize=False):
+    def _to_wire(
+        self,
+        file: Optional[Any],
+        compress: Optional[dns.name.CompressType] = None,
+        origin: Optional[dns.name.Name] = None,
+        canonicalize: bool = False,
+    ) -> bytes:
         raise NotImplementedError  # pragma: no cover
 
-    def to_wire(self, file=None, compress=None, origin=None,
-                canonicalize=False):
+    def to_wire(
+        self,
+        file: Optional[Any] = None,
+        compress: Optional[dns.name.CompressType] = None,
+        origin: Optional[dns.name.Name] = None,
+        canonicalize: bool = False,
+    ) -> bytes:
         """Convert an rdata to wire format.
 
         Returns a ``bytes`` or ``None``.
@@ -214,15 +237,18 @@ class Rdata:
             self._to_wire(f, compress, origin, canonicalize)
             return f.getvalue()
 
-    def to_generic(self, origin=None):
+    def to_generic(
+        self, origin: Optional[dns.name.Name] = None
+    ) -> "dns.rdata.GenericRdata":
         """Creates a dns.rdata.GenericRdata equivalent of this rdata.
 
         Returns a ``dns.rdata.GenericRdata``.
         """
-        return dns.rdata.GenericRdata(self.rdclass, self.rdtype,
-                                      self.to_wire(origin=origin))
+        return dns.rdata.GenericRdata(
+            self.rdclass, self.rdtype, self.to_wire(origin=origin)
+        )
 
-    def to_digestable(self, origin=None):
+    def to_digestable(self, origin: Optional[dns.name.Name] = None) -> bytes:
         """Convert rdata to a format suitable for digesting in hashes.  This
         is also the DNSSEC canonical form.
 
@@ -234,12 +260,19 @@ class Rdata:
     def __repr__(self):
         covers = self.covers()
         if covers == dns.rdatatype.NONE:
-            ctext = ''
+            ctext = ""
         else:
-            ctext = '(' + dns.rdatatype.to_text(covers) + ')'
-        return '<DNS ' + dns.rdataclass.to_text(self.rdclass) + ' ' + \
-               dns.rdatatype.to_text(self.rdtype) + ctext + ' rdata: ' + \
-               str(self) + '>'
+            ctext = "(" + dns.rdatatype.to_text(covers) + ")"
+        return (
+            "<DNS "
+            + dns.rdataclass.to_text(self.rdclass)
+            + " "
+            + dns.rdatatype.to_text(self.rdtype)
+            + ctext
+            + " rdata: "
+            + str(self)
+            + ">"
+        )
 
     def __str__(self):
         return self.to_text()
@@ -320,27 +353,39 @@ class Rdata:
         return not self.__eq__(other)
 
     def __lt__(self, other):
-        if not isinstance(other, Rdata) or \
-                self.rdclass != other.rdclass or self.rdtype != other.rdtype:
+        if (
+            not isinstance(other, Rdata)
+            or self.rdclass != other.rdclass
+            or self.rdtype != other.rdtype
+        ):
 
             return NotImplemented
         return self._cmp(other) < 0
 
     def __le__(self, other):
-        if not isinstance(other, Rdata) or \
-                self.rdclass != other.rdclass or self.rdtype != other.rdtype:
+        if (
+            not isinstance(other, Rdata)
+            or self.rdclass != other.rdclass
+            or self.rdtype != other.rdtype
+        ):
             return NotImplemented
         return self._cmp(other) <= 0
 
     def __ge__(self, other):
-        if not isinstance(other, Rdata) or \
-                self.rdclass != other.rdclass or self.rdtype != other.rdtype:
+        if (
+            not isinstance(other, Rdata)
+            or self.rdclass != other.rdclass
+            or self.rdtype != other.rdtype
+        ):
             return NotImplemented
         return self._cmp(other) >= 0
 
     def __gt__(self, other):
-        if not isinstance(other, Rdata) or \
-                self.rdclass != other.rdclass or self.rdtype != other.rdtype:
+        if (
+            not isinstance(other, Rdata)
+            or self.rdclass != other.rdclass
+            or self.rdtype != other.rdtype
+        ):
             return NotImplemented
         return self._cmp(other) > 0
 
@@ -348,15 +393,28 @@ class Rdata:
         return hash(self.to_digestable(dns.name.root))
 
     @classmethod
-    def from_text(cls, rdclass, rdtype, tok, origin=None, relativize=True,
-                  relativize_to=None):
+    def from_text(
+        cls,
+        rdclass: dns.rdataclass.RdataClass,
+        rdtype: dns.rdatatype.RdataType,
+        tok: dns.tokenizer.Tokenizer,
+        origin: Optional[dns.name.Name] = None,
+        relativize: bool = True,
+        relativize_to: Optional[dns.name.Name] = None,
+    ) -> "Rdata":
         raise NotImplementedError  # pragma: no cover
 
     @classmethod
-    def from_wire_parser(cls, rdclass, rdtype, parser, origin=None):
+    def from_wire_parser(
+        cls,
+        rdclass: dns.rdataclass.RdataClass,
+        rdtype: dns.rdatatype.RdataType,
+        parser: dns.wire.Parser,
+        origin: Optional[dns.name.Name] = None,
+    ) -> "Rdata":
         raise NotImplementedError  # pragma: no cover
 
-    def replace(self, **kwargs):
+    def replace(self, **kwargs: Any) -> "Rdata":
         """
         Create a new Rdata instance based on the instance replace was
         invoked on. It is possible to pass different parameters to
@@ -369,19 +427,25 @@ class Rdata:
         """
 
         # Get the constructor parameters.
-        parameters = inspect.signature(self.__init__).parameters
+        parameters = inspect.signature(self.__init__).parameters  # type: ignore
 
         # Ensure that all of the arguments correspond to valid fields.
         # Don't allow rdclass or rdtype to be changed, though.
         for key in kwargs:
-            if key == 'rdcomment':
+            if key == "rdcomment":
                 continue
             if key not in parameters:
-                raise AttributeError("'{}' object has no attribute '{}'"
-                                     .format(self.__class__.__name__, key))
-            if key in ('rdclass', 'rdtype'):
-                raise AttributeError("Cannot overwrite '{}' attribute '{}'"
-                                     .format(self.__class__.__name__, key))
+                raise AttributeError(
+                    "'{}' object has no attribute '{}'".format(
+                        self.__class__.__name__, key
+                    )
+                )
+            if key in ("rdclass", "rdtype"):
+                raise AttributeError(
+                    "Cannot overwrite '{}' attribute '{}'".format(
+                        self.__class__.__name__, key
+                    )
+                )
 
         # Construct the parameter list.  For each field, use the value in
         # kwargs if present, and the current value otherwise.
@@ -391,9 +455,9 @@ class Rdata:
         rd = self.__class__(*args)
         # The comment is not set in the constructor, so give it special
         # handling.
-        rdcomment = kwargs.get('rdcomment', self.rdcomment)
+        rdcomment = kwargs.get("rdcomment", self.rdcomment)
         if rdcomment is not None:
-            object.__setattr__(rd, 'rdcomment', rdcomment)
+            object.__setattr__(rd, "rdcomment", rdcomment)
         return rd
 
     # Type checking and conversion helpers.  These are class methods as
@@ -408,18 +472,26 @@ class Rdata:
         return dns.rdatatype.RdataType.make(value)
 
     @classmethod
-    def _as_bytes(cls, value, encode=False, max_length=None, empty_ok=True):
+    def _as_bytes(
+        cls,
+        value: Any,
+        encode: bool = False,
+        max_length: Optional[int] = None,
+        empty_ok: bool = True,
+    ) -> bytes:
         if encode and isinstance(value, str):
-            value = value.encode()
+            bvalue = value.encode()
         elif isinstance(value, bytearray):
-            value = bytes(value)
-        elif not isinstance(value, bytes):
-            raise ValueError('not bytes')
-        if max_length is not None and len(value) > max_length:
-            raise ValueError('too long')
-        if not empty_ok and len(value) == 0:
-            raise ValueError('empty bytes not allowed')
-        return value
+            bvalue = bytes(value)
+        elif isinstance(value, bytes):
+            bvalue = value
+        else:
+            raise ValueError("not bytes")
+        if max_length is not None and len(bvalue) > max_length:
+            raise ValueError("too long")
+        if not empty_ok and len(bvalue) == 0:
+            raise ValueError("empty bytes not allowed")
+        return bvalue
 
     @classmethod
     def _as_name(cls, value):
@@ -429,49 +501,49 @@ class Rdata:
         if isinstance(value, str):
             return dns.name.from_text(value)
         elif not isinstance(value, dns.name.Name):
-            raise ValueError('not a name')
+            raise ValueError("not a name")
         return value
 
     @classmethod
     def _as_uint8(cls, value):
         if not isinstance(value, int):
-            raise ValueError('not an integer')
+            raise ValueError("not an integer")
         if value < 0 or value > 255:
-            raise ValueError('not a uint8')
+            raise ValueError("not a uint8")
         return value
 
     @classmethod
     def _as_uint16(cls, value):
         if not isinstance(value, int):
-            raise ValueError('not an integer')
+            raise ValueError("not an integer")
         if value < 0 or value > 65535:
-            raise ValueError('not a uint16')
+            raise ValueError("not a uint16")
         return value
 
     @classmethod
     def _as_uint32(cls, value):
         if not isinstance(value, int):
-            raise ValueError('not an integer')
+            raise ValueError("not an integer")
         if value < 0 or value > 4294967295:
-            raise ValueError('not a uint32')
+            raise ValueError("not a uint32")
         return value
 
     @classmethod
     def _as_uint48(cls, value):
         if not isinstance(value, int):
-            raise ValueError('not an integer')
+            raise ValueError("not an integer")
         if value < 0 or value > 281474976710655:
-            raise ValueError('not a uint48')
+            raise ValueError("not a uint48")
         return value
 
     @classmethod
     def _as_int(cls, value, low=None, high=None):
         if not isinstance(value, int):
-            raise ValueError('not an integer')
+            raise ValueError("not an integer")
         if low is not None and value < low:
-            raise ValueError('value too small')
+            raise ValueError("value too small")
         if high is not None and value > high:
-            raise ValueError('value too large')
+            raise ValueError("value too large")
         return value
 
     @classmethod
@@ -483,7 +555,7 @@ class Rdata:
         elif isinstance(value, bytes):
             return dns.ipv4.inet_ntoa(value)
         else:
-            raise ValueError('not an IPv4 address')
+            raise ValueError("not an IPv4 address")
 
     @classmethod
     def _as_ipv6_address(cls, value):
@@ -494,14 +566,14 @@ class Rdata:
         elif isinstance(value, bytes):
             return dns.ipv6.inet_ntoa(value)
         else:
-            raise ValueError('not an IPv6 address')
+            raise ValueError("not an IPv6 address")
 
     @classmethod
     def _as_bool(cls, value):
         if isinstance(value, bool):
             return value
         else:
-            raise ValueError('not a boolean')
+            raise ValueError("not a boolean")
 
     @classmethod
     def _as_ttl(cls, value):
@@ -510,7 +582,7 @@ class Rdata:
         elif isinstance(value, str):
             return dns.ttl.from_text(value)
         else:
-            raise ValueError('not a TTL')
+            raise ValueError("not a TTL")
 
     @classmethod
     def _as_tuple(cls, value, as_value):
@@ -532,6 +604,7 @@ class Rdata:
         return items
 
 
+@dns.immutable.immutable
 class GenericRdata(Rdata):
 
     """Generic Rdata Class
@@ -540,28 +613,32 @@ class GenericRdata(Rdata):
     implementation.  It implements the DNS "unknown RRs" scheme.
     """
 
-    __slots__ = ['data']
+    __slots__ = ["data"]
 
     def __init__(self, rdclass, rdtype, data):
         super().__init__(rdclass, rdtype)
-        object.__setattr__(self, 'data', data)
+        self.data = data
 
-    def to_text(self, origin=None, relativize=True, **kw):
-        return r'\# %d ' % len(self.data) + _hexify(self.data, **kw)
+    def to_text(
+        self,
+        origin: Optional[dns.name.Name] = None,
+        relativize: bool = True,
+        **kw: Dict[str, Any]
+    ) -> str:
+        return r"\# %d " % len(self.data) + _hexify(self.data, **kw)
 
     @classmethod
-    def from_text(cls, rdclass, rdtype, tok, origin=None, relativize=True,
-                  relativize_to=None):
+    def from_text(
+        cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None
+    ):
         token = tok.get()
-        if not token.is_identifier() or token.value != r'\#':
-            raise dns.exception.SyntaxError(
-                r'generic rdata does not start with \#')
+        if not token.is_identifier() or token.value != r"\#":
+            raise dns.exception.SyntaxError(r"generic rdata does not start with \#")
         length = tok.get_int()
         hex = tok.concatenate_remaining_identifiers(True).encode()
         data = binascii.unhexlify(hex)
         if len(data) != length:
-            raise dns.exception.SyntaxError(
-                'generic rdata hex data has wrong length')
+            raise dns.exception.SyntaxError("generic rdata hex data has wrong length")
         return cls(rdclass, rdtype, data)
 
     def _to_wire(self, file, compress=None, origin=None, canonicalize=False):
@@ -571,8 +648,12 @@ class GenericRdata(Rdata):
     def from_wire_parser(cls, rdclass, rdtype, parser, origin=None):
         return cls(rdclass, rdtype, parser.get_remaining())
 
-_rdata_classes = {}
-_module_prefix = 'dns.rdtypes'
+
+_rdata_classes: Dict[
+    Tuple[dns.rdataclass.RdataClass, dns.rdatatype.RdataType], Any
+] = {}
+_module_prefix = "dns.rdtypes"
+
 
 def get_rdata_class(rdclass, rdtype):
     cls = _rdata_classes.get((rdclass, rdtype))
@@ -581,16 +662,16 @@ def get_rdata_class(rdclass, rdtype):
         if not cls:
             rdclass_text = dns.rdataclass.to_text(rdclass)
             rdtype_text = dns.rdatatype.to_text(rdtype)
-            rdtype_text = rdtype_text.replace('-', '_')
+            rdtype_text = rdtype_text.replace("-", "_")
             try:
-                mod = import_module('.'.join([_module_prefix,
-                                              rdclass_text, rdtype_text]))
+                mod = import_module(
+                    ".".join([_module_prefix, rdclass_text, rdtype_text])
+                )
                 cls = getattr(mod, rdtype_text)
                 _rdata_classes[(rdclass, rdtype)] = cls
             except ImportError:
                 try:
-                    mod = import_module('.'.join([_module_prefix,
-                                                  'ANY', rdtype_text]))
+                    mod = import_module(".".join([_module_prefix, "ANY", rdtype_text]))
                     cls = getattr(mod, rdtype_text)
                     _rdata_classes[(dns.rdataclass.ANY, rdtype)] = cls
                     _rdata_classes[(rdclass, rdtype)] = cls
@@ -602,8 +683,15 @@ def get_rdata_class(rdclass, rdtype):
     return cls
 
 
-def from_text(rdclass, rdtype, tok, origin=None, relativize=True,
-              relativize_to=None, idna_codec=None):
+def from_text(
+    rdclass: Union[dns.rdataclass.RdataClass, str],
+    rdtype: Union[dns.rdatatype.RdataType, str],
+    tok: Union[dns.tokenizer.Tokenizer, str],
+    origin: Optional[dns.name.Name] = None,
+    relativize: bool = True,
+    relativize_to: Optional[dns.name.Name] = None,
+    idna_codec: Optional[dns.name.IDNACodec] = None,
+) -> Rdata:
     """Build an rdata object from text format.
 
     This function attempts to dynamically load a class which
@@ -617,9 +705,9 @@ def from_text(rdclass, rdtype, tok, origin=None, relativize=True,
     If *tok* is a ``str``, then a tokenizer is created and the string
     is used as its input.
 
-    *rdclass*, an ``int``, the rdataclass.
+    *rdclass*, a ``dns.rdataclass.RdataClass`` or ``str``, the rdataclass.
 
-    *rdtype*, an ``int``, the rdatatype.
+    *rdtype*, a ``dns.rdatatype.RdataType`` or ``str``, the rdatatype.
 
     *tok*, a ``dns.tokenizer.Tokenizer`` or a ``str``.
 
@@ -651,17 +739,18 @@ def from_text(rdclass, rdtype, tok, origin=None, relativize=True,
             # peek at first token
             token = tok.get()
             tok.unget(token)
-            if token.is_identifier() and \
-               token.value == r'\#':
+            if token.is_identifier() and token.value == r"\#":
                 #
                 # Known type using the generic syntax.  Extract the
                 # wire form from the generic syntax, and then run
                 # from_wire on it.
                 #
-                grdata = GenericRdata.from_text(rdclass, rdtype, tok, origin,
-                                                relativize, relativize_to)
-                rdata = from_wire(rdclass, rdtype, grdata.data, 0,
-                                  len(grdata.data), origin)
+                grdata = GenericRdata.from_text(
+                    rdclass, rdtype, tok, origin, relativize, relativize_to
+                )
+                rdata = from_wire(
+                    rdclass, rdtype, grdata.data, 0, len(grdata.data), origin
+                )
                 #
                 # If this comparison isn't equal, then there must have been
                 # compressed names in the wire format, which is an error,
@@ -669,19 +758,27 @@ def from_text(rdclass, rdtype, tok, origin=None, relativize=True,
                 #
                 rwire = rdata.to_wire()
                 if rwire != grdata.data:
-                    raise dns.exception.SyntaxError('compressed data in '
-                                                    'generic syntax form '
-                                                    'of known rdatatype')
+                    raise dns.exception.SyntaxError(
+                        "compressed data in "
+                        "generic syntax form "
+                        "of known rdatatype"
+                    )
         if rdata is None:
-            rdata = cls.from_text(rdclass, rdtype, tok, origin, relativize,
-                                  relativize_to)
+            rdata = cls.from_text(
+                rdclass, rdtype, tok, origin, relativize, relativize_to
+            )
         token = tok.get_eol_as_token()
         if token.comment is not None:
-            object.__setattr__(rdata, 'rdcomment', token.comment)
+            object.__setattr__(rdata, "rdcomment", token.comment)
         return rdata
 
 
-def from_wire_parser(rdclass, rdtype, parser, origin=None):
+def from_wire_parser(
+    rdclass: Union[dns.rdataclass.RdataClass, str],
+    rdtype: Union[dns.rdatatype.RdataType, str],
+    parser: dns.wire.Parser,
+    origin: Optional[dns.name.Name] = None,
+) -> Rdata:
     """Build an rdata object from wire format
 
     This function attempts to dynamically load a class which
@@ -692,9 +789,9 @@ def from_wire_parser(rdclass, rdtype, parser, origin=None):
     Once a class is chosen, its from_wire() class method is called
     with the parameters to this function.
 
-    *rdclass*, an ``int``, the rdataclass.
+    *rdclass*, a ``dns.rdataclass.RdataClass`` or ``str``, the rdataclass.
 
-    *rdtype*, an ``int``, the rdatatype.
+    *rdtype*, a ``dns.rdatatype.RdataType`` or ``str``, the rdatatype.
 
     *parser*, a ``dns.wire.Parser``, the parser, which should be
     restricted to the rdata length.
@@ -712,7 +809,14 @@ def from_wire_parser(rdclass, rdtype, parser, origin=None):
         return cls.from_wire_parser(rdclass, rdtype, parser, origin)
 
 
-def from_wire(rdclass, rdtype, wire, current, rdlen, origin=None):
+def from_wire(
+    rdclass: Union[dns.rdataclass.RdataClass, str],
+    rdtype: Union[dns.rdatatype.RdataType, str],
+    wire: bytes,
+    current: int,
+    rdlen: int,
+    origin: Optional[dns.name.Name] = None,
+) -> Rdata:
     """Build an rdata object from wire format
 
     This function attempts to dynamically load a class which
@@ -746,13 +850,21 @@ def from_wire(rdclass, rdtype, wire, current, rdlen, origin=None):
 
 class RdatatypeExists(dns.exception.DNSException):
     """DNS rdatatype already exists."""
-    supp_kwargs = {'rdclass', 'rdtype'}
-    fmt = "The rdata type with class {rdclass:d} and rdtype {rdtype:d} " + \
-        "already exists."
+
+    supp_kwargs = {"rdclass", "rdtype"}
+    fmt = (
+        "The rdata type with class {rdclass:d} and rdtype {rdtype:d} "
+        + "already exists."
+    )
 
 
-def register_type(implementation, rdtype, rdtype_text, is_singleton=False,
-                  rdclass=dns.rdataclass.IN):
+def register_type(
+    implementation: Any,
+    rdtype: int,
+    rdtype_text: str,
+    is_singleton: bool = False,
+    rdclass: dns.rdataclass.RdataClass = dns.rdataclass.IN,
+) -> None:
     """Dynamically register a module to handle an rdatatype.
 
     *implementation*, a module implementing the type in the usual dnspython
@@ -769,14 +881,16 @@ def register_type(implementation, rdtype, rdtype_text, is_singleton=False,
     it applies to all classes.
     """
 
-    existing_cls = get_rdata_class(rdclass, rdtype)
-    if existing_cls != GenericRdata or dns.rdatatype.is_metatype(rdtype):
-        raise RdatatypeExists(rdclass=rdclass, rdtype=rdtype)
+    the_rdtype = dns.rdatatype.RdataType.make(rdtype)
+    existing_cls = get_rdata_class(rdclass, the_rdtype)
+    if existing_cls != GenericRdata or dns.rdatatype.is_metatype(the_rdtype):
+        raise RdatatypeExists(rdclass=rdclass, rdtype=the_rdtype)
     try:
-        if dns.rdatatype.RdataType(rdtype).name != rdtype_text:
-            raise RdatatypeExists(rdclass=rdclass, rdtype=rdtype)
+        if dns.rdatatype.RdataType(the_rdtype).name != rdtype_text:
+            raise RdatatypeExists(rdclass=rdclass, rdtype=the_rdtype)
     except ValueError:
         pass
-    _rdata_classes[(rdclass, rdtype)] = getattr(implementation,
-                                                rdtype_text.replace('-', '_'))
-    dns.rdatatype.register_type(rdtype, rdtype_text, is_singleton)
+    _rdata_classes[(rdclass, the_rdtype)] = getattr(
+        implementation, rdtype_text.replace("-", "_")
+    )
+    dns.rdatatype.register_type(the_rdtype, rdtype_text, is_singleton)
diff --git a/lib/dns/rdata.pyi b/lib/dns/rdata.pyi
deleted file mode 100644
index f394791f..00000000
--- a/lib/dns/rdata.pyi
+++ /dev/null
@@ -1,19 +0,0 @@
-from typing import Dict, Tuple, Any, Optional, BinaryIO
-from .name import Name, IDNACodec
-class Rdata:
-    def __init__(self):
-        self.address : str
-    def to_wire(self, file : Optional[BinaryIO], compress : Optional[Dict[Name,int]], origin : Optional[Name], canonicalize : Optional[bool]) -> Optional[bytes]:
-        ...
-    @classmethod
-    def from_text(cls, rdclass : int, rdtype : int, tok, origin=None, relativize=True):
-        ...
-_rdata_modules : Dict[Tuple[Any,Rdata],Any]
-
-def from_text(rdclass : int, rdtype : int, tok : Optional[str], origin : Optional[Name] = None,
-              relativize : bool = True, relativize_to : Optional[Name] = None,
-              idna_codec : Optional[IDNACodec] = None):
-    ...
-
-def from_wire(rdclass : int, rdtype : int, wire : bytes, current : int, rdlen : int, origin : Optional[Name] = None):
-    ...
diff --git a/lib/dns/rdataclass.py b/lib/dns/rdataclass.py
index 41bba693..89b85a79 100644
--- a/lib/dns/rdataclass.py
+++ b/lib/dns/rdataclass.py
@@ -20,8 +20,10 @@
 import dns.enum
 import dns.exception
 
+
 class RdataClass(dns.enum.IntEnum):
     """DNS Rdata Class"""
+
     RESERVED0 = 0
     IN = 1
     INTERNET = IN
@@ -56,7 +58,7 @@ class UnknownRdataclass(dns.exception.DNSException):
     """A DNS class is unknown."""
 
 
-def from_text(text):
+def from_text(text: str) -> RdataClass:
     """Convert text into a DNS rdata class value.
 
     The input text can be a defined DNS RR class mnemonic or
@@ -68,13 +70,13 @@ def from_text(text):
 
     Raises ``ValueError`` if the rdata class value is not >= 0 and <= 65535.
 
-    Returns an ``int``.
+    Returns a ``dns.rdataclass.RdataClass``.
     """
 
     return RdataClass.from_text(text)
 
 
-def to_text(value):
+def to_text(value: RdataClass) -> str:
     """Convert a DNS rdata class value to text.
 
     If the value has a known mnemonic, it will be used, otherwise the
@@ -88,18 +90,19 @@ def to_text(value):
     return RdataClass.to_text(value)
 
 
-def is_metaclass(rdclass):
+def is_metaclass(rdclass: RdataClass) -> bool:
     """True if the specified class is a metaclass.
 
     The currently defined metaclasses are ANY and NONE.
 
-    *rdclass* is an ``int``.
+    *rdclass* is a ``dns.rdataclass.RdataClass``.
     """
 
     if rdclass in _metaclasses:
         return True
     return False
 
+
 ### BEGIN generated RdataClass constants
 
 RESERVED0 = RdataClass.RESERVED0
diff --git a/lib/dns/rdataset.py b/lib/dns/rdataset.py
index 579bc964..c0ede425 100644
--- a/lib/dns/rdataset.py
+++ b/lib/dns/rdataset.py
@@ -17,16 +17,20 @@
 
 """DNS rdatasets (an rdataset is a set of rdatas of a given type and class)"""
 
+from typing import Any, cast, Collection, Dict, List, Optional, Union
+
 import io
 import random
 import struct
 
 import dns.exception
 import dns.immutable
+import dns.name
 import dns.rdatatype
 import dns.rdataclass
 import dns.rdata
 import dns.set
+import dns.ttl
 
 # define SimpleSet here for backwards compatibility
 SimpleSet = dns.set.Set
@@ -45,24 +49,30 @@ class Rdataset(dns.set.Set):
 
     """A DNS rdataset."""
 
-    __slots__ = ['rdclass', 'rdtype', 'covers', 'ttl']
+    __slots__ = ["rdclass", "rdtype", "covers", "ttl"]
 
-    def __init__(self, rdclass, rdtype, covers=dns.rdatatype.NONE, ttl=0):
+    def __init__(
+        self,
+        rdclass: dns.rdataclass.RdataClass,
+        rdtype: dns.rdatatype.RdataType,
+        covers: dns.rdatatype.RdataType = dns.rdatatype.NONE,
+        ttl: int = 0,
+    ):
         """Create a new rdataset of the specified class and type.
 
-        *rdclass*, an ``int``, the rdataclass.
+        *rdclass*, a ``dns.rdataclass.RdataClass``, the rdataclass.
 
-        *rdtype*, an ``int``, the rdatatype.
+        *rdtype*, an ``dns.rdatatype.RdataType``, the rdatatype.
 
-        *covers*, an ``int``, the covered rdatatype.
+        *covers*, an ``dns.rdatatype.RdataType``, the covered rdatatype.
 
         *ttl*, an ``int``, the TTL.
         """
 
         super().__init__()
         self.rdclass = rdclass
-        self.rdtype = rdtype
-        self.covers = covers
+        self.rdtype: dns.rdatatype.RdataType = rdtype
+        self.covers: dns.rdatatype.RdataType = covers
         self.ttl = ttl
 
     def _clone(self):
@@ -73,7 +83,7 @@ class Rdataset(dns.set.Set):
         obj.ttl = self.ttl
         return obj
 
-    def update_ttl(self, ttl):
+    def update_ttl(self, ttl: int) -> None:
         """Perform TTL minimization.
 
         Set the TTL of the rdataset to be the lesser of the set's current
@@ -88,7 +98,9 @@ class Rdataset(dns.set.Set):
         elif ttl < self.ttl:
             self.ttl = ttl
 
-    def add(self, rd, ttl=None):  # pylint: disable=arguments-differ
+    def add(  # pylint: disable=arguments-differ,arguments-renamed
+        self, rd: dns.rdata.Rdata, ttl: Optional[int] = None
+    ) -> None:
         """Add the specified rdata to the rdataset.
 
         If the optional *ttl* parameter is supplied, then
@@ -115,8 +127,7 @@ class Rdataset(dns.set.Set):
             raise IncompatibleTypes
         if ttl is not None:
             self.update_ttl(ttl)
-        if self.rdtype == dns.rdatatype.RRSIG or \
-           self.rdtype == dns.rdatatype.SIG:
+        if self.rdtype == dns.rdatatype.RRSIG or self.rdtype == dns.rdatatype.SIG:
             covers = rd.covers()
             if len(self) == 0 and self.covers == dns.rdatatype.NONE:
                 self.covers = covers
@@ -147,19 +158,26 @@ class Rdataset(dns.set.Set):
     def _rdata_repr(self):
         def maybe_truncate(s):
             if len(s) > 100:
-                return s[:100] + '...'
+                return s[:100] + "..."
             return s
-        return '[%s]' % ', '.join('<%s>' % maybe_truncate(str(rr))
-                                  for rr in self)
+
+        return "[%s]" % ", ".join("<%s>" % maybe_truncate(str(rr)) for rr in self)
 
     def __repr__(self):
         if self.covers == 0:
-            ctext = ''
+            ctext = ""
         else:
-            ctext = '(' + dns.rdatatype.to_text(self.covers) + ')'
-        return '<DNS ' + dns.rdataclass.to_text(self.rdclass) + ' ' + \
-               dns.rdatatype.to_text(self.rdtype) + ctext + \
-               ' rdataset: ' + self._rdata_repr() + '>'
+            ctext = "(" + dns.rdatatype.to_text(self.covers) + ")"
+        return (
+            "<DNS "
+            + dns.rdataclass.to_text(self.rdclass)
+            + " "
+            + dns.rdatatype.to_text(self.rdtype)
+            + ctext
+            + " rdataset: "
+            + self._rdata_repr()
+            + ">"
+        )
 
     def __str__(self):
         return self.to_text()
@@ -167,17 +185,26 @@ class Rdataset(dns.set.Set):
     def __eq__(self, other):
         if not isinstance(other, Rdataset):
             return False
-        if self.rdclass != other.rdclass or \
-           self.rdtype != other.rdtype or \
-           self.covers != other.covers:
+        if (
+            self.rdclass != other.rdclass
+            or self.rdtype != other.rdtype
+            or self.covers != other.covers
+        ):
             return False
         return super().__eq__(other)
 
     def __ne__(self, other):
         return not self.__eq__(other)
 
-    def to_text(self, name=None, origin=None, relativize=True,
-                override_rdclass=None, want_comments=False, **kw):
+    def to_text(
+        self,
+        name: Optional[dns.name.Name] = None,
+        origin: Optional[dns.name.Name] = None,
+        relativize: bool = True,
+        override_rdclass: Optional[dns.rdataclass.RdataClass] = None,
+        want_comments: bool = False,
+        **kw: Dict[str, Any],
+    ) -> str:
         """Convert the rdataset into DNS zone file format.
 
         See ``dns.name.Name.choose_relativity`` for more information
@@ -206,10 +233,10 @@ class Rdataset(dns.set.Set):
         if name is not None:
             name = name.choose_relativity(origin, relativize)
             ntext = str(name)
-            pad = ' '
+            pad = " "
         else:
-            ntext = ''
-            pad = ''
+            ntext = ""
+            pad = ""
         s = io.StringIO()
         if override_rdclass is not None:
             rdclass = override_rdclass
@@ -221,28 +248,46 @@ class Rdataset(dns.set.Set):
             # some dynamic updates, so we don't need to print out the TTL
             # (which is meaningless anyway).
             #
-            s.write('{}{}{} {}\n'.format(ntext, pad,
-                                         dns.rdataclass.to_text(rdclass),
-                                         dns.rdatatype.to_text(self.rdtype)))
+            s.write(
+                "{}{}{} {}\n".format(
+                    ntext,
+                    pad,
+                    dns.rdataclass.to_text(rdclass),
+                    dns.rdatatype.to_text(self.rdtype),
+                )
+            )
         else:
             for rd in self:
-                extra = ''
+                extra = ""
                 if want_comments:
                     if rd.rdcomment:
-                        extra = f' ;{rd.rdcomment}'
-                s.write('%s%s%d %s %s %s%s\n' %
-                        (ntext, pad, self.ttl, dns.rdataclass.to_text(rdclass),
-                         dns.rdatatype.to_text(self.rdtype),
-                         rd.to_text(origin=origin, relativize=relativize,
-                                    **kw),
-                         extra))
+                        extra = f" ;{rd.rdcomment}"
+                s.write(
+                    "%s%s%d %s %s %s%s\n"
+                    % (
+                        ntext,
+                        pad,
+                        self.ttl,
+                        dns.rdataclass.to_text(rdclass),
+                        dns.rdatatype.to_text(self.rdtype),
+                        rd.to_text(origin=origin, relativize=relativize, **kw),
+                        extra,
+                    )
+                )
         #
         # We strip off the final \n for the caller's convenience in printing
         #
         return s.getvalue()[:-1]
 
-    def to_wire(self, name, file, compress=None, origin=None,
-                override_rdclass=None, want_shuffle=True):
+    def to_wire(
+        self,
+        name: dns.name.Name,
+        file: Any,
+        compress: Optional[dns.name.CompressType] = None,
+        origin: Optional[dns.name.Name] = None,
+        override_rdclass: Optional[dns.rdataclass.RdataClass] = None,
+        want_shuffle: bool = True,
+    ) -> int:
         """Convert the rdataset to wire format.
 
         *name*, a ``dns.name.Name`` is the owner name to use.
@@ -279,6 +324,7 @@ class Rdataset(dns.set.Set):
             file.write(stuff)
             return 1
         else:
+            l: Union[Rdataset, List[dns.rdata.Rdata]]
             if want_shuffle:
                 l = list(self)
                 random.shuffle(l)
@@ -286,8 +332,7 @@ class Rdataset(dns.set.Set):
                 l = self
             for rd in l:
                 name.to_wire(file, compress, origin)
-                stuff = struct.pack("!HHIH", self.rdtype, rdclass,
-                                    self.ttl, 0)
+                stuff = struct.pack("!HHIH", self.rdtype, rdclass, self.ttl, 0)
                 file.write(stuff)
                 start = file.tell()
                 rd.to_wire(file, compress, origin)
@@ -299,17 +344,20 @@ class Rdataset(dns.set.Set):
                 file.seek(0, io.SEEK_END)
             return len(self)
 
-    def match(self, rdclass, rdtype, covers):
+    def match(
+        self,
+        rdclass: dns.rdataclass.RdataClass,
+        rdtype: dns.rdatatype.RdataType,
+        covers: dns.rdatatype.RdataType,
+    ) -> bool:
         """Returns ``True`` if this rdataset matches the specified class,
         type, and covers.
         """
-        if self.rdclass == rdclass and \
-           self.rdtype == rdtype and \
-           self.covers == covers:
+        if self.rdclass == rdclass and self.rdtype == rdtype and self.covers == covers:
             return True
         return False
 
-    def processing_order(self):
+    def processing_order(self) -> List[dns.rdata.Rdata]:
         """Return rdatas in a valid processing order according to the type's
         specification.  For example, MX records are in preference order from
         lowest to highest preferences, with items of the same preference
@@ -325,51 +373,56 @@ class Rdataset(dns.set.Set):
 
 
 @dns.immutable.immutable
-class ImmutableRdataset(Rdataset):
+class ImmutableRdataset(Rdataset):  # lgtm[py/missing-equals]
 
     """An immutable DNS rdataset."""
 
     _clone_class = Rdataset
 
-    def __init__(self, rdataset):
+    def __init__(self, rdataset: Rdataset):
         """Create an immutable rdataset from the specified rdataset."""
 
-        super().__init__(rdataset.rdclass, rdataset.rdtype, rdataset.covers,
-                         rdataset.ttl)
+        super().__init__(
+            rdataset.rdclass, rdataset.rdtype, rdataset.covers, rdataset.ttl
+        )
         self.items = dns.immutable.Dict(rdataset.items)
 
     def update_ttl(self, ttl):
-        raise TypeError('immutable')
+        raise TypeError("immutable")
 
     def add(self, rd, ttl=None):
-        raise TypeError('immutable')
+        raise TypeError("immutable")
 
     def union_update(self, other):
-        raise TypeError('immutable')
+        raise TypeError("immutable")
 
     def intersection_update(self, other):
-        raise TypeError('immutable')
+        raise TypeError("immutable")
 
     def update(self, other):
-        raise TypeError('immutable')
+        raise TypeError("immutable")
 
     def __delitem__(self, i):
-        raise TypeError('immutable')
+        raise TypeError("immutable")
 
-    def __ior__(self, other):
-        raise TypeError('immutable')
+    # lgtm complains about these not raising ArithmeticError, but there is
+    # precedent for overrides of these methods in other classes to raise
+    # TypeError, and it seems like the better exception.
 
-    def __iand__(self, other):
-        raise TypeError('immutable')
+    def __ior__(self, other):  # lgtm[py/unexpected-raise-in-special-method]
+        raise TypeError("immutable")
 
-    def __iadd__(self, other):
-        raise TypeError('immutable')
+    def __iand__(self, other):  # lgtm[py/unexpected-raise-in-special-method]
+        raise TypeError("immutable")
 
-    def __isub__(self, other):
-        raise TypeError('immutable')
+    def __iadd__(self, other):  # lgtm[py/unexpected-raise-in-special-method]
+        raise TypeError("immutable")
+
+    def __isub__(self, other):  # lgtm[py/unexpected-raise-in-special-method]
+        raise TypeError("immutable")
 
     def clear(self):
-        raise TypeError('immutable')
+        raise TypeError("immutable")
 
     def __copy__(self):
         return ImmutableRdataset(super().copy())
@@ -386,9 +439,20 @@ class ImmutableRdataset(Rdataset):
     def difference(self, other):
         return ImmutableRdataset(super().difference(other))
 
+    def symmetric_difference(self, other):
+        return ImmutableRdataset(super().symmetric_difference(other))
 
-def from_text_list(rdclass, rdtype, ttl, text_rdatas, idna_codec=None,
-                   origin=None, relativize=True, relativize_to=None):
+
+def from_text_list(
+    rdclass: Union[dns.rdataclass.RdataClass, str],
+    rdtype: Union[dns.rdatatype.RdataType, str],
+    ttl: int,
+    text_rdatas: Collection[str],
+    idna_codec: Optional[dns.name.IDNACodec] = None,
+    origin: Optional[dns.name.Name] = None,
+    relativize: bool = True,
+    relativize_to: Optional[dns.name.Name] = None,
+) -> Rdataset:
     """Create an rdataset with the specified class, type, and TTL, and with
     the specified list of rdatas in text format.
 
@@ -407,28 +471,34 @@ def from_text_list(rdclass, rdtype, ttl, text_rdatas, idna_codec=None,
     Returns a ``dns.rdataset.Rdataset`` object.
     """
 
-    rdclass = dns.rdataclass.RdataClass.make(rdclass)
-    rdtype = dns.rdatatype.RdataType.make(rdtype)
-    r = Rdataset(rdclass, rdtype)
+    the_rdclass = dns.rdataclass.RdataClass.make(rdclass)
+    the_rdtype = dns.rdatatype.RdataType.make(rdtype)
+    r = Rdataset(the_rdclass, the_rdtype)
     r.update_ttl(ttl)
     for t in text_rdatas:
-        rd = dns.rdata.from_text(r.rdclass, r.rdtype, t, origin, relativize,
-                                 relativize_to, idna_codec)
+        rd = dns.rdata.from_text(
+            r.rdclass, r.rdtype, t, origin, relativize, relativize_to, idna_codec
+        )
         r.add(rd)
     return r
 
 
-def from_text(rdclass, rdtype, ttl, *text_rdatas):
+def from_text(
+    rdclass: Union[dns.rdataclass.RdataClass, str],
+    rdtype: Union[dns.rdatatype.RdataType, str],
+    ttl: int,
+    *text_rdatas: Any,
+) -> Rdataset:
     """Create an rdataset with the specified class, type, and TTL, and with
     the specified rdatas in text format.
 
     Returns a ``dns.rdataset.Rdataset`` object.
     """
 
-    return from_text_list(rdclass, rdtype, ttl, text_rdatas)
+    return from_text_list(rdclass, rdtype, ttl, cast(Collection[str], text_rdatas))
 
 
-def from_rdata_list(ttl, rdatas):
+def from_rdata_list(ttl: int, rdatas: Collection[dns.rdata.Rdata]) -> Rdataset:
     """Create an rdataset with the specified TTL, and with
     the specified list of rdata objects.
 
@@ -443,14 +513,15 @@ def from_rdata_list(ttl, rdatas):
             r = Rdataset(rd.rdclass, rd.rdtype)
             r.update_ttl(ttl)
         r.add(rd)
+    assert r is not None
     return r
 
 
-def from_rdata(ttl, *rdatas):
+def from_rdata(ttl: int, *rdatas: Any) -> Rdataset:
     """Create an rdataset with the specified TTL, and with
     the specified rdata objects.
 
     Returns a ``dns.rdataset.Rdataset`` object.
     """
 
-    return from_rdata_list(ttl, rdatas)
+    return from_rdata_list(ttl, cast(Collection[dns.rdata.Rdata], rdatas))
diff --git a/lib/dns/rdataset.pyi b/lib/dns/rdataset.pyi
deleted file mode 100644
index a7bbf2d4..00000000
--- a/lib/dns/rdataset.pyi
+++ /dev/null
@@ -1,58 +0,0 @@
-from typing import Optional, Dict, List, Union
-from io import BytesIO
-from . import exception, name, set, rdatatype, rdata, rdataset
-
-class DifferingCovers(exception.DNSException):
-    """An attempt was made to add a DNS SIG/RRSIG whose covered type
-    is not the same as that of the other rdatas in the rdataset."""
-
-
-class IncompatibleTypes(exception.DNSException):
-    """An attempt was made to add DNS RR data of an incompatible type."""
-
-
-class Rdataset(set.Set):
-    def __init__(self, rdclass, rdtype, covers=rdatatype.NONE, ttl=0):
-        self.rdclass : int = rdclass
-        self.rdtype : int = rdtype
-        self.covers : int = covers
-        self.ttl : int = ttl
-
-    def update_ttl(self, ttl : int) -> None:
-        ...
-
-    def add(self, rd : rdata.Rdata, ttl : Optional[int] =None):
-        ...
-
-    def union_update(self, other : Rdataset):
-        ...
-
-    def intersection_update(self, other : Rdataset):
-        ...
-
-    def update(self, other : Rdataset):
-        ...
-
-    def to_text(self, name : Optional[name.Name] =None, origin : Optional[name.Name] =None, relativize=True,
-                override_rdclass : Optional[int] =None, **kw) -> bytes:
-        ...
-
-    def to_wire(self, name : Optional[name.Name], file : BytesIO, compress : Optional[Dict[name.Name, int]] = None, origin : Optional[name.Name] = None,
-                override_rdclass : Optional[int] = None, want_shuffle=True) -> int:
-        ...
-
-    def match(self, rdclass : int, rdtype : int, covers : int) -> bool:
-        ...
-
-
-def from_text_list(rdclass : Union[int,str], rdtype : Union[int,str], ttl : int, text_rdatas : str, idna_codec : Optional[name.IDNACodec] = None) -> rdataset.Rdataset:
-    ...
-
-def from_text(rdclass : Union[int,str], rdtype : Union[int,str], ttl : int, *text_rdatas : str) -> rdataset.Rdataset:
-    ...
-
-def from_rdata_list(ttl : int, rdatas : List[rdata.Rdata]) -> rdataset.Rdataset:
-    ...
-
-def from_rdata(ttl : int, *rdatas : List[rdata.Rdata]) -> rdataset.Rdataset:
-    ...
diff --git a/lib/dns/rdatatype.py b/lib/dns/rdatatype.py
index 9499c7b9..e6c58186 100644
--- a/lib/dns/rdatatype.py
+++ b/lib/dns/rdatatype.py
@@ -17,11 +17,15 @@
 
 """DNS Rdata Types."""
 
+from typing import Dict
+
 import dns.enum
 import dns.exception
 
+
 class RdataType(dns.enum.IntEnum):
     """DNS Rdata Type"""
+
     TYPE0 = 0
     NONE = 0
     A = 1
@@ -116,24 +120,47 @@ class RdataType(dns.enum.IntEnum):
     def _prefix(cls):
         return "TYPE"
 
+    @classmethod
+    def _extra_from_text(cls, text):
+        if text.find("-") >= 0:
+            try:
+                return cls[text.replace("-", "_")]
+            except KeyError:
+                pass
+        return _registered_by_text.get(text)
+
+    @classmethod
+    def _extra_to_text(cls, value, current_text):
+        if current_text is None:
+            return _registered_by_value.get(value)
+        if current_text.find("_") >= 0:
+            return current_text.replace("_", "-")
+        return current_text
+
     @classmethod
     def _unknown_exception_class(cls):
         return UnknownRdatatype
 
-_registered_by_text = {}
-_registered_by_value = {}
+
+_registered_by_text: Dict[str, RdataType] = {}
+_registered_by_value: Dict[RdataType, str] = {}
 
 _metatypes = {RdataType.OPT}
 
-_singletons = {RdataType.SOA, RdataType.NXT, RdataType.DNAME,
-               RdataType.NSEC, RdataType.CNAME}
+_singletons = {
+    RdataType.SOA,
+    RdataType.NXT,
+    RdataType.DNAME,
+    RdataType.NSEC,
+    RdataType.CNAME,
+}
 
 
 class UnknownRdatatype(dns.exception.DNSException):
     """DNS resource record type is unknown."""
 
 
-def from_text(text):
+def from_text(text: str) -> RdataType:
     """Convert text into a DNS rdata type value.
 
     The input text can be a defined DNS RR type mnemonic or
@@ -145,20 +172,13 @@ def from_text(text):
 
     Raises ``ValueError`` if the rdata type value is not >= 0 and <= 65535.
 
-    Returns an ``int``.
+    Returns a ``dns.rdatatype.RdataType``.
     """
 
-    text = text.upper().replace('-', '_')
-    try:
-        return RdataType.from_text(text)
-    except UnknownRdatatype:
-        registered_type = _registered_by_text.get(text)
-        if registered_type:
-            return registered_type
-        raise
+    return RdataType.from_text(text)
 
 
-def to_text(value):
+def to_text(value: RdataType) -> str:
     """Convert a DNS rdata type value to text.
 
     If the value has a known mnemonic, it will be used, otherwise the
@@ -169,18 +189,13 @@ def to_text(value):
     Returns a ``str``.
     """
 
-    text = RdataType.to_text(value)
-    if text.startswith("TYPE"):
-        registered_text = _registered_by_value.get(value)
-        if registered_text:
-            text = registered_text
-    return text.replace('_', '-')
+    return RdataType.to_text(value)
 
 
-def is_metatype(rdtype):
+def is_metatype(rdtype: RdataType) -> bool:
     """True if the specified type is a metatype.
 
-    *rdtype* is an ``int``.
+    *rdtype* is a ``dns.rdatatype.RdataType``.
 
     The currently defined metatypes are TKEY, TSIG, IXFR, AXFR, MAILA,
     MAILB, ANY, and OPT.
@@ -191,7 +206,7 @@ def is_metatype(rdtype):
     return (256 > rdtype >= 128) or rdtype in _metatypes
 
 
-def is_singleton(rdtype):
+def is_singleton(rdtype: RdataType) -> bool:
     """Is the specified type a singleton type?
 
     Singleton types can only have a single rdata in an rdataset, or a single
@@ -209,11 +224,14 @@ def is_singleton(rdtype):
         return True
     return False
 
+
 # pylint: disable=redefined-outer-name
-def register_type(rdtype, rdtype_text, is_singleton=False):
+def register_type(
+    rdtype: RdataType, rdtype_text: str, is_singleton: bool = False
+) -> None:
     """Dynamically register an rdatatype.
 
-    *rdtype*, an ``int``, the rdatatype to register.
+    *rdtype*, a ``dns.rdatatype.RdataType``, the rdatatype to register.
 
     *rdtype_text*, a ``str``, the textual form of the rdatatype.
 
@@ -226,6 +244,7 @@ def register_type(rdtype, rdtype_text, is_singleton=False):
     if is_singleton:
         _singletons.add(rdtype)
 
+
 ### BEGIN generated RdataType constants
 
 TYPE0 = RdataType.TYPE0
diff --git a/lib/dns/rdtypes/ANY/AMTRELAY.py b/lib/dns/rdtypes/ANY/AMTRELAY.py
index 9f093dee..dfe7abc3 100644
--- a/lib/dns/rdtypes/ANY/AMTRELAY.py
+++ b/lib/dns/rdtypes/ANY/AMTRELAY.py
@@ -23,7 +23,7 @@ import dns.rdtypes.util
 
 
 class Relay(dns.rdtypes.util.Gateway):
-    name = 'AMTRELAY relay'
+    name = "AMTRELAY relay"
 
     @property
     def relay(self):
@@ -37,10 +37,11 @@ class AMTRELAY(dns.rdata.Rdata):
 
     # see: RFC 8777
 
-    __slots__ = ['precedence', 'discovery_optional', 'relay_type', 'relay']
+    __slots__ = ["precedence", "discovery_optional", "relay_type", "relay"]
 
-    def __init__(self, rdclass, rdtype, precedence, discovery_optional,
-                 relay_type, relay):
+    def __init__(
+        self, rdclass, rdtype, precedence, discovery_optional, relay_type, relay
+    ):
         super().__init__(rdclass, rdtype)
         relay = Relay(relay_type, relay)
         self.precedence = self._as_uint8(precedence)
@@ -50,37 +51,42 @@ class AMTRELAY(dns.rdata.Rdata):
 
     def to_text(self, origin=None, relativize=True, **kw):
         relay = Relay(self.relay_type, self.relay).to_text(origin, relativize)
-        return '%d %d %d %s' % (self.precedence, self.discovery_optional,
-                                self.relay_type, relay)
+        return "%d %d %d %s" % (
+            self.precedence,
+            self.discovery_optional,
+            self.relay_type,
+            relay,
+        )
 
     @classmethod
-    def from_text(cls, rdclass, rdtype, tok, origin=None, relativize=True,
-                  relativize_to=None):
+    def from_text(
+        cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None
+    ):
         precedence = tok.get_uint8()
         discovery_optional = tok.get_uint8()
         if discovery_optional > 1:
-            raise dns.exception.SyntaxError('expecting 0 or 1')
+            raise dns.exception.SyntaxError("expecting 0 or 1")
         discovery_optional = bool(discovery_optional)
         relay_type = tok.get_uint8()
-        if relay_type > 0x7f:
-            raise dns.exception.SyntaxError('expecting an integer <= 127')
-        relay = Relay.from_text(relay_type, tok, origin, relativize,
-                                relativize_to)
-        return cls(rdclass, rdtype, precedence, discovery_optional, relay_type,
-                   relay.relay)
+        if relay_type > 0x7F:
+            raise dns.exception.SyntaxError("expecting an integer <= 127")
+        relay = Relay.from_text(relay_type, tok, origin, relativize, relativize_to)
+        return cls(
+            rdclass, rdtype, precedence, discovery_optional, relay_type, relay.relay
+        )
 
     def _to_wire(self, file, compress=None, origin=None, canonicalize=False):
         relay_type = self.relay_type | (self.discovery_optional << 7)
         header = struct.pack("!BB", self.precedence, relay_type)
         file.write(header)
-        Relay(self.relay_type, self.relay).to_wire(file, compress, origin,
-                                                   canonicalize)
+        Relay(self.relay_type, self.relay).to_wire(file, compress, origin, canonicalize)
 
     @classmethod
     def from_wire_parser(cls, rdclass, rdtype, parser, origin=None):
-        (precedence, relay_type) = parser.get_struct('!BB')
+        (precedence, relay_type) = parser.get_struct("!BB")
         discovery_optional = bool(relay_type >> 7)
-        relay_type &= 0x7f
+        relay_type &= 0x7F
         relay = Relay.from_wire_parser(relay_type, parser, origin)
-        return cls(rdclass, rdtype, precedence, discovery_optional, relay_type,
-                   relay.relay)
+        return cls(
+            rdclass, rdtype, precedence, discovery_optional, relay_type, relay.relay
+        )
diff --git a/lib/dns/rdtypes/ANY/CAA.py b/lib/dns/rdtypes/ANY/CAA.py
index c86b45ea..8afb538c 100644
--- a/lib/dns/rdtypes/ANY/CAA.py
+++ b/lib/dns/rdtypes/ANY/CAA.py
@@ -30,7 +30,7 @@ class CAA(dns.rdata.Rdata):
 
     # see: RFC 6844
 
-    __slots__ = ['flags', 'tag', 'value']
+    __slots__ = ["flags", "tag", "value"]
 
     def __init__(self, rdclass, rdtype, flags, tag, value):
         super().__init__(rdclass, rdtype)
@@ -41,23 +41,26 @@ class CAA(dns.rdata.Rdata):
         self.value = self._as_bytes(value)
 
     def to_text(self, origin=None, relativize=True, **kw):
-        return '%u %s "%s"' % (self.flags,
-                               dns.rdata._escapify(self.tag),
-                               dns.rdata._escapify(self.value))
+        return '%u %s "%s"' % (
+            self.flags,
+            dns.rdata._escapify(self.tag),
+            dns.rdata._escapify(self.value),
+        )
 
     @classmethod
-    def from_text(cls, rdclass, rdtype, tok, origin=None, relativize=True,
-                  relativize_to=None):
+    def from_text(
+        cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None
+    ):
         flags = tok.get_uint8()
         tag = tok.get_string().encode()
         value = tok.get_string().encode()
         return cls(rdclass, rdtype, flags, tag, value)
 
     def _to_wire(self, file, compress=None, origin=None, canonicalize=False):
-        file.write(struct.pack('!B', self.flags))
+        file.write(struct.pack("!B", self.flags))
         l = len(self.tag)
         assert l < 256
-        file.write(struct.pack('!B', l))
+        file.write(struct.pack("!B", l))
         file.write(self.tag)
         file.write(self.value)
 
diff --git a/lib/dns/rdtypes/ANY/CDNSKEY.py b/lib/dns/rdtypes/ANY/CDNSKEY.py
index 14b19417..869523fb 100644
--- a/lib/dns/rdtypes/ANY/CDNSKEY.py
+++ b/lib/dns/rdtypes/ANY/CDNSKEY.py
@@ -15,13 +15,19 @@
 # ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
 # OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 
-import dns.rdtypes.dnskeybase
+import dns.rdtypes.dnskeybase  # lgtm[py/import-and-import-from]
 import dns.immutable
 
 # pylint: disable=unused-import
-from dns.rdtypes.dnskeybase import SEP, REVOKE, ZONE  # noqa: F401
+from dns.rdtypes.dnskeybase import (
+    SEP,
+    REVOKE,
+    ZONE,
+)  # noqa: F401  lgtm[py/unused-import]
+
 # pylint: enable=unused-import
 
+
 @dns.immutable.immutable
 class CDNSKEY(dns.rdtypes.dnskeybase.DNSKEYBase):
 
diff --git a/lib/dns/rdtypes/ANY/CERT.py b/lib/dns/rdtypes/ANY/CERT.py
index f35ce3ad..1b0cbeca 100644
--- a/lib/dns/rdtypes/ANY/CERT.py
+++ b/lib/dns/rdtypes/ANY/CERT.py
@@ -20,34 +20,34 @@ import base64
 
 import dns.exception
 import dns.immutable
-import dns.dnssec
+import dns.dnssectypes
 import dns.rdata
 import dns.tokenizer
 
 _ctype_by_value = {
-    1: 'PKIX',
-    2: 'SPKI',
-    3: 'PGP',
-    4: 'IPKIX',
-    5: 'ISPKI',
-    6: 'IPGP',
-    7: 'ACPKIX',
-    8: 'IACPKIX',
-    253: 'URI',
-    254: 'OID',
+    1: "PKIX",
+    2: "SPKI",
+    3: "PGP",
+    4: "IPKIX",
+    5: "ISPKI",
+    6: "IPGP",
+    7: "ACPKIX",
+    8: "IACPKIX",
+    253: "URI",
+    254: "OID",
 }
 
 _ctype_by_name = {
-    'PKIX': 1,
-    'SPKI': 2,
-    'PGP': 3,
-    'IPKIX': 4,
-    'ISPKI': 5,
-    'IPGP': 6,
-    'ACPKIX': 7,
-    'IACPKIX': 8,
-    'URI': 253,
-    'OID': 254,
+    "PKIX": 1,
+    "SPKI": 2,
+    "PGP": 3,
+    "IPKIX": 4,
+    "ISPKI": 5,
+    "IPGP": 6,
+    "ACPKIX": 7,
+    "IACPKIX": 8,
+    "URI": 253,
+    "OID": 254,
 }
 
 
@@ -72,10 +72,11 @@ class CERT(dns.rdata.Rdata):
 
     # see RFC 4398
 
-    __slots__ = ['certificate_type', 'key_tag', 'algorithm', 'certificate']
+    __slots__ = ["certificate_type", "key_tag", "algorithm", "certificate"]
 
-    def __init__(self, rdclass, rdtype, certificate_type, key_tag, algorithm,
-                 certificate):
+    def __init__(
+        self, rdclass, rdtype, certificate_type, key_tag, algorithm, certificate
+    ):
         super().__init__(rdclass, rdtype)
         self.certificate_type = self._as_uint16(certificate_type)
         self.key_tag = self._as_uint16(key_tag)
@@ -84,24 +85,28 @@ class CERT(dns.rdata.Rdata):
 
     def to_text(self, origin=None, relativize=True, **kw):
         certificate_type = _ctype_to_text(self.certificate_type)
-        return "%s %d %s %s" % (certificate_type, self.key_tag,
-                                dns.dnssec.algorithm_to_text(self.algorithm),
-                                dns.rdata._base64ify(self.certificate, **kw))
+        return "%s %d %s %s" % (
+            certificate_type,
+            self.key_tag,
+            dns.dnssectypes.Algorithm.to_text(self.algorithm),
+            dns.rdata._base64ify(self.certificate, **kw),
+        )
 
     @classmethod
-    def from_text(cls, rdclass, rdtype, tok, origin=None, relativize=True,
-                  relativize_to=None):
+    def from_text(
+        cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None
+    ):
         certificate_type = _ctype_from_text(tok.get_string())
         key_tag = tok.get_uint16()
-        algorithm = dns.dnssec.algorithm_from_text(tok.get_string())
+        algorithm = dns.dnssectypes.Algorithm.from_text(tok.get_string())
         b64 = tok.concatenate_remaining_identifiers().encode()
         certificate = base64.b64decode(b64)
-        return cls(rdclass, rdtype, certificate_type, key_tag,
-                   algorithm, certificate)
+        return cls(rdclass, rdtype, certificate_type, key_tag, algorithm, certificate)
 
     def _to_wire(self, file, compress=None, origin=None, canonicalize=False):
-        prefix = struct.pack("!HHB", self.certificate_type, self.key_tag,
-                             self.algorithm)
+        prefix = struct.pack(
+            "!HHB", self.certificate_type, self.key_tag, self.algorithm
+        )
         file.write(prefix)
         file.write(self.certificate)
 
@@ -109,5 +114,4 @@ class CERT(dns.rdata.Rdata):
     def from_wire_parser(cls, rdclass, rdtype, parser, origin=None):
         (certificate_type, key_tag, algorithm) = parser.get_struct("!HHB")
         certificate = parser.get_remaining()
-        return cls(rdclass, rdtype, certificate_type, key_tag, algorithm,
-                   certificate)
+        return cls(rdclass, rdtype, certificate_type, key_tag, algorithm, certificate)
diff --git a/lib/dns/rdtypes/ANY/CSYNC.py b/lib/dns/rdtypes/ANY/CSYNC.py
index 979028ae..f819c08c 100644
--- a/lib/dns/rdtypes/ANY/CSYNC.py
+++ b/lib/dns/rdtypes/ANY/CSYNC.py
@@ -27,7 +27,7 @@ import dns.rdtypes.util
 
 @dns.immutable.immutable
 class Bitmap(dns.rdtypes.util.Bitmap):
-    type_name = 'CSYNC'
+    type_name = "CSYNC"
 
 
 @dns.immutable.immutable
@@ -35,7 +35,7 @@ class CSYNC(dns.rdata.Rdata):
 
     """CSYNC record"""
 
-    __slots__ = ['serial', 'flags', 'windows']
+    __slots__ = ["serial", "flags", "windows"]
 
     def __init__(self, rdclass, rdtype, serial, flags, windows):
         super().__init__(rdclass, rdtype)
@@ -47,18 +47,19 @@ class CSYNC(dns.rdata.Rdata):
 
     def to_text(self, origin=None, relativize=True, **kw):
         text = Bitmap(self.windows).to_text()
-        return '%d %d%s' % (self.serial, self.flags, text)
+        return "%d %d%s" % (self.serial, self.flags, text)
 
     @classmethod
-    def from_text(cls, rdclass, rdtype, tok, origin=None, relativize=True,
-                  relativize_to=None):
+    def from_text(
+        cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None
+    ):
         serial = tok.get_uint32()
         flags = tok.get_uint16()
         bitmap = Bitmap.from_text(tok)
         return cls(rdclass, rdtype, serial, flags, bitmap)
 
     def _to_wire(self, file, compress=None, origin=None, canonicalize=False):
-        file.write(struct.pack('!IH', self.serial, self.flags))
+        file.write(struct.pack("!IH", self.serial, self.flags))
         Bitmap(self.windows).to_wire(file)
 
     @classmethod
diff --git a/lib/dns/rdtypes/ANY/DNSKEY.py b/lib/dns/rdtypes/ANY/DNSKEY.py
index e69a7c19..50fa05b7 100644
--- a/lib/dns/rdtypes/ANY/DNSKEY.py
+++ b/lib/dns/rdtypes/ANY/DNSKEY.py
@@ -15,13 +15,19 @@
 # ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
 # OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 
-import dns.rdtypes.dnskeybase
+import dns.rdtypes.dnskeybase  # lgtm[py/import-and-import-from]
 import dns.immutable
 
 # pylint: disable=unused-import
-from dns.rdtypes.dnskeybase import SEP, REVOKE, ZONE  # noqa: F401
+from dns.rdtypes.dnskeybase import (
+    SEP,
+    REVOKE,
+    ZONE,
+)  # noqa: F401  lgtm[py/unused-import]
+
 # pylint: enable=unused-import
 
+
 @dns.immutable.immutable
 class DNSKEY(dns.rdtypes.dnskeybase.DNSKEYBase):
 
diff --git a/lib/dns/rdtypes/ANY/GPOS.py b/lib/dns/rdtypes/ANY/GPOS.py
index 29fa8f8b..30aab321 100644
--- a/lib/dns/rdtypes/ANY/GPOS.py
+++ b/lib/dns/rdtypes/ANY/GPOS.py
@@ -26,19 +26,19 @@ import dns.tokenizer
 def _validate_float_string(what):
     if len(what) == 0:
         raise dns.exception.FormError
-    if what[0] == b'-'[0] or what[0] == b'+'[0]:
+    if what[0] == b"-"[0] or what[0] == b"+"[0]:
         what = what[1:]
     if what.isdigit():
         return
     try:
-        (left, right) = what.split(b'.')
+        (left, right) = what.split(b".")
     except ValueError:
         raise dns.exception.FormError
-    if left == b'' and right == b'':
+    if left == b"" and right == b"":
         raise dns.exception.FormError
-    if not left == b'' and not left.decode().isdigit():
+    if not left == b"" and not left.decode().isdigit():
         raise dns.exception.FormError
-    if not right == b'' and not right.decode().isdigit():
+    if not right == b"" and not right.decode().isdigit():
         raise dns.exception.FormError
 
 
@@ -49,18 +49,15 @@ class GPOS(dns.rdata.Rdata):
 
     # see: RFC 1712
 
-    __slots__ = ['latitude', 'longitude', 'altitude']
+    __slots__ = ["latitude", "longitude", "altitude"]
 
     def __init__(self, rdclass, rdtype, latitude, longitude, altitude):
         super().__init__(rdclass, rdtype)
-        if isinstance(latitude, float) or \
-           isinstance(latitude, int):
+        if isinstance(latitude, float) or isinstance(latitude, int):
             latitude = str(latitude)
-        if isinstance(longitude, float) or \
-           isinstance(longitude, int):
+        if isinstance(longitude, float) or isinstance(longitude, int):
             longitude = str(longitude)
-        if isinstance(altitude, float) or \
-           isinstance(altitude, int):
+        if isinstance(altitude, float) or isinstance(altitude, int):
             altitude = str(altitude)
         latitude = self._as_bytes(latitude, True, 255)
         longitude = self._as_bytes(longitude, True, 255)
@@ -73,19 +70,20 @@ class GPOS(dns.rdata.Rdata):
         self.altitude = altitude
         flat = self.float_latitude
         if flat < -90.0 or flat > 90.0:
-            raise dns.exception.FormError('bad latitude')
+            raise dns.exception.FormError("bad latitude")
         flong = self.float_longitude
         if flong < -180.0 or flong > 180.0:
-            raise dns.exception.FormError('bad longitude')
+            raise dns.exception.FormError("bad longitude")
 
     def to_text(self, origin=None, relativize=True, **kw):
-        return '{} {} {}'.format(self.latitude.decode(),
-                                 self.longitude.decode(),
-                                 self.altitude.decode())
+        return "{} {} {}".format(
+            self.latitude.decode(), self.longitude.decode(), self.altitude.decode()
+        )
 
     @classmethod
-    def from_text(cls, rdclass, rdtype, tok, origin=None, relativize=True,
-                  relativize_to=None):
+    def from_text(
+        cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None
+    ):
         latitude = tok.get_string()
         longitude = tok.get_string()
         altitude = tok.get_string()
@@ -94,15 +92,15 @@ class GPOS(dns.rdata.Rdata):
     def _to_wire(self, file, compress=None, origin=None, canonicalize=False):
         l = len(self.latitude)
         assert l < 256
-        file.write(struct.pack('!B', l))
+        file.write(struct.pack("!B", l))
         file.write(self.latitude)
         l = len(self.longitude)
         assert l < 256
-        file.write(struct.pack('!B', l))
+        file.write(struct.pack("!B", l))
         file.write(self.longitude)
         l = len(self.altitude)
         assert l < 256
-        file.write(struct.pack('!B', l))
+        file.write(struct.pack("!B", l))
         file.write(self.altitude)
 
     @classmethod
diff --git a/lib/dns/rdtypes/ANY/HINFO.py b/lib/dns/rdtypes/ANY/HINFO.py
index cd049693..513c155a 100644
--- a/lib/dns/rdtypes/ANY/HINFO.py
+++ b/lib/dns/rdtypes/ANY/HINFO.py
@@ -30,7 +30,7 @@ class HINFO(dns.rdata.Rdata):
 
     # see: RFC 1035
 
-    __slots__ = ['cpu', 'os']
+    __slots__ = ["cpu", "os"]
 
     def __init__(self, rdclass, rdtype, cpu, os):
         super().__init__(rdclass, rdtype)
@@ -38,12 +38,14 @@ class HINFO(dns.rdata.Rdata):
         self.os = self._as_bytes(os, True, 255)
 
     def to_text(self, origin=None, relativize=True, **kw):
-        return '"{}" "{}"'.format(dns.rdata._escapify(self.cpu),
-                                  dns.rdata._escapify(self.os))
+        return '"{}" "{}"'.format(
+            dns.rdata._escapify(self.cpu), dns.rdata._escapify(self.os)
+        )
 
     @classmethod
-    def from_text(cls, rdclass, rdtype, tok, origin=None, relativize=True,
-                  relativize_to=None):
+    def from_text(
+        cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None
+    ):
         cpu = tok.get_string(max_length=255)
         os = tok.get_string(max_length=255)
         return cls(rdclass, rdtype, cpu, os)
@@ -51,11 +53,11 @@ class HINFO(dns.rdata.Rdata):
     def _to_wire(self, file, compress=None, origin=None, canonicalize=False):
         l = len(self.cpu)
         assert l < 256
-        file.write(struct.pack('!B', l))
+        file.write(struct.pack("!B", l))
         file.write(self.cpu)
         l = len(self.os)
         assert l < 256
-        file.write(struct.pack('!B', l))
+        file.write(struct.pack("!B", l))
         file.write(self.os)
 
     @classmethod
diff --git a/lib/dns/rdtypes/ANY/HIP.py b/lib/dns/rdtypes/ANY/HIP.py
index e887359b..01fec822 100644
--- a/lib/dns/rdtypes/ANY/HIP.py
+++ b/lib/dns/rdtypes/ANY/HIP.py
@@ -32,7 +32,7 @@ class HIP(dns.rdata.Rdata):
 
     # see: RFC 5205
 
-    __slots__ = ['hit', 'algorithm', 'key', 'servers']
+    __slots__ = ["hit", "algorithm", "key", "servers"]
 
     def __init__(self, rdclass, rdtype, hit, algorithm, key, servers):
         super().__init__(rdclass, rdtype)
@@ -43,18 +43,19 @@ class HIP(dns.rdata.Rdata):
 
     def to_text(self, origin=None, relativize=True, **kw):
         hit = binascii.hexlify(self.hit).decode()
-        key = base64.b64encode(self.key).replace(b'\n', b'').decode()
-        text = ''
+        key = base64.b64encode(self.key).replace(b"\n", b"").decode()
+        text = ""
         servers = []
         for server in self.servers:
             servers.append(server.choose_relativity(origin, relativize))
         if len(servers) > 0:
-            text += (' ' + ' '.join((x.to_unicode() for x in servers)))
-        return '%u %s %s%s' % (self.algorithm, hit, key, text)
+            text += " " + " ".join((x.to_unicode() for x in servers))
+        return "%u %s %s%s" % (self.algorithm, hit, key, text)
 
     @classmethod
-    def from_text(cls, rdclass, rdtype, tok, origin=None, relativize=True,
-                  relativize_to=None):
+    def from_text(
+        cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None
+    ):
         algorithm = tok.get_uint8()
         hit = binascii.unhexlify(tok.get_string().encode())
         key = base64.b64decode(tok.get_string().encode())
@@ -75,7 +76,7 @@ class HIP(dns.rdata.Rdata):
 
     @classmethod
     def from_wire_parser(cls, rdclass, rdtype, parser, origin=None):
-        (lh, algorithm, lk) = parser.get_struct('!BBH')
+        (lh, algorithm, lk) = parser.get_struct("!BBH")
         hit = parser.get_bytes(lh)
         key = parser.get_bytes(lk)
         servers = []
diff --git a/lib/dns/rdtypes/ANY/ISDN.py b/lib/dns/rdtypes/ANY/ISDN.py
index b9a49adb..536a35d6 100644
--- a/lib/dns/rdtypes/ANY/ISDN.py
+++ b/lib/dns/rdtypes/ANY/ISDN.py
@@ -30,7 +30,7 @@ class ISDN(dns.rdata.Rdata):
 
     # see: RFC 1183
 
-    __slots__ = ['address', 'subaddress']
+    __slots__ = ["address", "subaddress"]
 
     def __init__(self, rdclass, rdtype, address, subaddress):
         super().__init__(rdclass, rdtype)
@@ -39,31 +39,33 @@ class ISDN(dns.rdata.Rdata):
 
     def to_text(self, origin=None, relativize=True, **kw):
         if self.subaddress:
-            return '"{}" "{}"'.format(dns.rdata._escapify(self.address),
-                                      dns.rdata._escapify(self.subaddress))
+            return '"{}" "{}"'.format(
+                dns.rdata._escapify(self.address), dns.rdata._escapify(self.subaddress)
+            )
         else:
             return '"%s"' % dns.rdata._escapify(self.address)
 
     @classmethod
-    def from_text(cls, rdclass, rdtype, tok, origin=None, relativize=True,
-                  relativize_to=None):
+    def from_text(
+        cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None
+    ):
         address = tok.get_string()
         tokens = tok.get_remaining(max_tokens=1)
         if len(tokens) >= 1:
             subaddress = tokens[0].unescape().value
         else:
-            subaddress = ''
+            subaddress = ""
         return cls(rdclass, rdtype, address, subaddress)
 
     def _to_wire(self, file, compress=None, origin=None, canonicalize=False):
         l = len(self.address)
         assert l < 256
-        file.write(struct.pack('!B', l))
+        file.write(struct.pack("!B", l))
         file.write(self.address)
         l = len(self.subaddress)
         if l > 0:
             assert l < 256
-            file.write(struct.pack('!B', l))
+            file.write(struct.pack("!B", l))
             file.write(self.subaddress)
 
     @classmethod
@@ -72,5 +74,5 @@ class ISDN(dns.rdata.Rdata):
         if parser.remaining() > 0:
             subaddress = parser.get_counted_bytes()
         else:
-            subaddress = b''
+            subaddress = b""
         return cls(rdclass, rdtype, address, subaddress)
diff --git a/lib/dns/rdtypes/ANY/L32.py b/lib/dns/rdtypes/ANY/L32.py
index 47eff958..14be01f9 100644
--- a/lib/dns/rdtypes/ANY/L32.py
+++ b/lib/dns/rdtypes/ANY/L32.py
@@ -3,6 +3,7 @@
 import struct
 
 import dns.immutable
+import dns.rdata
 
 
 @dns.immutable.immutable
@@ -12,7 +13,7 @@ class L32(dns.rdata.Rdata):
 
     # see: rfc6742.txt
 
-    __slots__ = ['preference', 'locator32']
+    __slots__ = ["preference", "locator32"]
 
     def __init__(self, rdclass, rdtype, preference, locator32):
         super().__init__(rdclass, rdtype)
@@ -20,17 +21,18 @@ class L32(dns.rdata.Rdata):
         self.locator32 = self._as_ipv4_address(locator32)
 
     def to_text(self, origin=None, relativize=True, **kw):
-        return f'{self.preference} {self.locator32}'
+        return f"{self.preference} {self.locator32}"
 
     @classmethod
-    def from_text(cls, rdclass, rdtype, tok, origin=None, relativize=True,
-                  relativize_to=None):
+    def from_text(
+        cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None
+    ):
         preference = tok.get_uint16()
         nodeid = tok.get_identifier()
         return cls(rdclass, rdtype, preference, nodeid)
 
     def _to_wire(self, file, compress=None, origin=None, canonicalize=False):
-        file.write(struct.pack('!H', self.preference))
+        file.write(struct.pack("!H", self.preference))
         file.write(dns.ipv4.inet_aton(self.locator32))
 
     @classmethod
diff --git a/lib/dns/rdtypes/ANY/L64.py b/lib/dns/rdtypes/ANY/L64.py
index aab36a82..d083d403 100644
--- a/lib/dns/rdtypes/ANY/L64.py
+++ b/lib/dns/rdtypes/ANY/L64.py
@@ -13,33 +13,33 @@ class L64(dns.rdata.Rdata):
 
     # see: rfc6742.txt
 
-    __slots__ = ['preference', 'locator64']
+    __slots__ = ["preference", "locator64"]
 
     def __init__(self, rdclass, rdtype, preference, locator64):
         super().__init__(rdclass, rdtype)
         self.preference = self._as_uint16(preference)
         if isinstance(locator64, bytes):
             if len(locator64) != 8:
-                raise ValueError('invalid locator64')
-            self.locator64 = dns.rdata._hexify(locator64, 4, b':')
+                raise ValueError("invalid locator64")
+            self.locator64 = dns.rdata._hexify(locator64, 4, b":")
         else:
-            dns.rdtypes.util.parse_formatted_hex(locator64, 4, 4, ':')
+            dns.rdtypes.util.parse_formatted_hex(locator64, 4, 4, ":")
             self.locator64 = locator64
 
     def to_text(self, origin=None, relativize=True, **kw):
-        return f'{self.preference} {self.locator64}'
+        return f"{self.preference} {self.locator64}"
 
     @classmethod
-    def from_text(cls, rdclass, rdtype, tok, origin=None, relativize=True,
-                  relativize_to=None):
+    def from_text(
+        cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None
+    ):
         preference = tok.get_uint16()
         locator64 = tok.get_identifier()
         return cls(rdclass, rdtype, preference, locator64)
 
     def _to_wire(self, file, compress=None, origin=None, canonicalize=False):
-        file.write(struct.pack('!H', self.preference))
-        file.write(dns.rdtypes.util.parse_formatted_hex(self.locator64,
-                                                        4, 4, ':'))
+        file.write(struct.pack("!H", self.preference))
+        file.write(dns.rdtypes.util.parse_formatted_hex(self.locator64, 4, 4, ":"))
 
     @classmethod
     def from_wire_parser(cls, rdclass, rdtype, parser, origin=None):
diff --git a/lib/dns/rdtypes/ANY/LOC.py b/lib/dns/rdtypes/ANY/LOC.py
index c9398994..52c97532 100644
--- a/lib/dns/rdtypes/ANY/LOC.py
+++ b/lib/dns/rdtypes/ANY/LOC.py
@@ -93,15 +93,15 @@ def _decode_size(what, desc):
 
 def _check_coordinate_list(value, low, high):
     if value[0] < low or value[0] > high:
-        raise ValueError(f'not in range [{low}, {high}]')
+        raise ValueError(f"not in range [{low}, {high}]")
     if value[1] < 0 or value[1] > 59:
-        raise ValueError('bad minutes value')
+        raise ValueError("bad minutes value")
     if value[2] < 0 or value[2] > 59:
-        raise ValueError('bad seconds value')
+        raise ValueError("bad seconds value")
     if value[3] < 0 or value[3] > 999:
-        raise ValueError('bad milliseconds value')
+        raise ValueError("bad milliseconds value")
     if value[4] != 1 and value[4] != -1:
-        raise ValueError('bad hemisphere value')
+        raise ValueError("bad hemisphere value")
 
 
 @dns.immutable.immutable
@@ -111,12 +111,26 @@ class LOC(dns.rdata.Rdata):
 
     # see: RFC 1876
 
-    __slots__ = ['latitude', 'longitude', 'altitude', 'size',
-                 'horizontal_precision', 'vertical_precision']
+    __slots__ = [
+        "latitude",
+        "longitude",
+        "altitude",
+        "size",
+        "horizontal_precision",
+        "vertical_precision",
+    ]
 
-    def __init__(self, rdclass, rdtype, latitude, longitude, altitude,
-                 size=_default_size, hprec=_default_hprec,
-                 vprec=_default_vprec):
+    def __init__(
+        self,
+        rdclass,
+        rdtype,
+        latitude,
+        longitude,
+        altitude,
+        size=_default_size,
+        hprec=_default_hprec,
+        vprec=_default_vprec,
+    ):
         """Initialize a LOC record instance.
 
         The parameters I{latitude} and I{longitude} may be either a 4-tuple
@@ -145,34 +159,44 @@ class LOC(dns.rdata.Rdata):
 
     def to_text(self, origin=None, relativize=True, **kw):
         if self.latitude[4] > 0:
-            lat_hemisphere = 'N'
+            lat_hemisphere = "N"
         else:
-            lat_hemisphere = 'S'
+            lat_hemisphere = "S"
         if self.longitude[4] > 0:
-            long_hemisphere = 'E'
+            long_hemisphere = "E"
         else:
-            long_hemisphere = 'W'
+            long_hemisphere = "W"
         text = "%d %d %d.%03d %s %d %d %d.%03d %s %0.2fm" % (
-            self.latitude[0], self.latitude[1],
-            self.latitude[2], self.latitude[3], lat_hemisphere,
-            self.longitude[0], self.longitude[1], self.longitude[2],
-            self.longitude[3], long_hemisphere,
-            self.altitude / 100.0
+            self.latitude[0],
+            self.latitude[1],
+            self.latitude[2],
+            self.latitude[3],
+            lat_hemisphere,
+            self.longitude[0],
+            self.longitude[1],
+            self.longitude[2],
+            self.longitude[3],
+            long_hemisphere,
+            self.altitude / 100.0,
         )
 
         # do not print default values
-        if self.size != _default_size or \
-            self.horizontal_precision != _default_hprec or \
-                self.vertical_precision != _default_vprec:
+        if (
+            self.size != _default_size
+            or self.horizontal_precision != _default_hprec
+            or self.vertical_precision != _default_vprec
+        ):
             text += " {:0.2f}m {:0.2f}m {:0.2f}m".format(
-                self.size / 100.0, self.horizontal_precision / 100.0,
-                self.vertical_precision / 100.0
+                self.size / 100.0,
+                self.horizontal_precision / 100.0,
+                self.vertical_precision / 100.0,
             )
         return text
 
     @classmethod
-    def from_text(cls, rdclass, rdtype, tok, origin=None, relativize=True,
-                  relativize_to=None):
+    def from_text(
+        cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None
+    ):
         latitude = [0, 0, 0, 0, 1]
         longitude = [0, 0, 0, 0, 1]
         size = _default_size
@@ -184,16 +208,14 @@ class LOC(dns.rdata.Rdata):
         if t.isdigit():
             latitude[1] = int(t)
             t = tok.get_string()
-            if '.' in t:
-                (seconds, milliseconds) = t.split('.')
+            if "." in t:
+                (seconds, milliseconds) = t.split(".")
                 if not seconds.isdigit():
-                    raise dns.exception.SyntaxError(
-                        'bad latitude seconds value')
+                    raise dns.exception.SyntaxError("bad latitude seconds value")
                 latitude[2] = int(seconds)
                 l = len(milliseconds)
                 if l == 0 or l > 3 or not milliseconds.isdigit():
-                    raise dns.exception.SyntaxError(
-                        'bad latitude milliseconds value')
+                    raise dns.exception.SyntaxError("bad latitude milliseconds value")
                 if l == 1:
                     m = 100
                 elif l == 2:
@@ -205,26 +227,24 @@ class LOC(dns.rdata.Rdata):
             elif t.isdigit():
                 latitude[2] = int(t)
                 t = tok.get_string()
-        if t == 'S':
+        if t == "S":
             latitude[4] = -1
-        elif t != 'N':
-            raise dns.exception.SyntaxError('bad latitude hemisphere value')
+        elif t != "N":
+            raise dns.exception.SyntaxError("bad latitude hemisphere value")
 
         longitude[0] = tok.get_int()
         t = tok.get_string()
         if t.isdigit():
             longitude[1] = int(t)
             t = tok.get_string()
-            if '.' in t:
-                (seconds, milliseconds) = t.split('.')
+            if "." in t:
+                (seconds, milliseconds) = t.split(".")
                 if not seconds.isdigit():
-                    raise dns.exception.SyntaxError(
-                        'bad longitude seconds value')
+                    raise dns.exception.SyntaxError("bad longitude seconds value")
                 longitude[2] = int(seconds)
                 l = len(milliseconds)
                 if l == 0 or l > 3 or not milliseconds.isdigit():
-                    raise dns.exception.SyntaxError(
-                        'bad longitude milliseconds value')
+                    raise dns.exception.SyntaxError("bad longitude milliseconds value")
                 if l == 1:
                     m = 100
                 elif l == 2:
@@ -236,64 +256,75 @@ class LOC(dns.rdata.Rdata):
             elif t.isdigit():
                 longitude[2] = int(t)
                 t = tok.get_string()
-        if t == 'W':
+        if t == "W":
             longitude[4] = -1
-        elif t != 'E':
-            raise dns.exception.SyntaxError('bad longitude hemisphere value')
+        elif t != "E":
+            raise dns.exception.SyntaxError("bad longitude hemisphere value")
 
         t = tok.get_string()
-        if t[-1] == 'm':
-            t = t[0: -1]
-        altitude = float(t) * 100.0        # m -> cm
+        if t[-1] == "m":
+            t = t[0:-1]
+        altitude = float(t) * 100.0  # m -> cm
 
         tokens = tok.get_remaining(max_tokens=3)
         if len(tokens) >= 1:
             value = tokens[0].unescape().value
-            if value[-1] == 'm':
-                value = value[0: -1]
-            size = float(value) * 100.0        # m -> cm
+            if value[-1] == "m":
+                value = value[0:-1]
+            size = float(value) * 100.0  # m -> cm
             if len(tokens) >= 2:
                 value = tokens[1].unescape().value
-                if value[-1] == 'm':
-                    value = value[0: -1]
-                hprec = float(value) * 100.0        # m -> cm
+                if value[-1] == "m":
+                    value = value[0:-1]
+                hprec = float(value) * 100.0  # m -> cm
                 if len(tokens) >= 3:
                     value = tokens[2].unescape().value
-                    if value[-1] == 'm':
-                        value = value[0: -1]
-                    vprec = float(value) * 100.0        # m -> cm
+                    if value[-1] == "m":
+                        value = value[0:-1]
+                    vprec = float(value) * 100.0  # m -> cm
 
         # Try encoding these now so we raise if they are bad
         _encode_size(size, "size")
         _encode_size(hprec, "horizontal precision")
         _encode_size(vprec, "vertical precision")
 
-        return cls(rdclass, rdtype, latitude, longitude, altitude,
-                   size, hprec, vprec)
+        return cls(rdclass, rdtype, latitude, longitude, altitude, size, hprec, vprec)
 
     def _to_wire(self, file, compress=None, origin=None, canonicalize=False):
-        milliseconds = (self.latitude[0] * 3600000 +
-                        self.latitude[1] * 60000 +
-                        self.latitude[2] * 1000 +
-                        self.latitude[3]) * self.latitude[4]
+        milliseconds = (
+            self.latitude[0] * 3600000
+            + self.latitude[1] * 60000
+            + self.latitude[2] * 1000
+            + self.latitude[3]
+        ) * self.latitude[4]
         latitude = 0x80000000 + milliseconds
-        milliseconds = (self.longitude[0] * 3600000 +
-                        self.longitude[1] * 60000 +
-                        self.longitude[2] * 1000 +
-                        self.longitude[3]) * self.longitude[4]
+        milliseconds = (
+            self.longitude[0] * 3600000
+            + self.longitude[1] * 60000
+            + self.longitude[2] * 1000
+            + self.longitude[3]
+        ) * self.longitude[4]
         longitude = 0x80000000 + milliseconds
         altitude = int(self.altitude) + 10000000
         size = _encode_size(self.size, "size")
         hprec = _encode_size(self.horizontal_precision, "horizontal precision")
         vprec = _encode_size(self.vertical_precision, "vertical precision")
-        wire = struct.pack("!BBBBIII", 0, size, hprec, vprec, latitude,
-                           longitude, altitude)
+        wire = struct.pack(
+            "!BBBBIII", 0, size, hprec, vprec, latitude, longitude, altitude
+        )
         file.write(wire)
 
     @classmethod
     def from_wire_parser(cls, rdclass, rdtype, parser, origin=None):
-        (version, size, hprec, vprec, latitude, longitude, altitude) = \
-            parser.get_struct("!BBBBIII")
+        (
+            version,
+            size,
+            hprec,
+            vprec,
+            latitude,
+            longitude,
+            altitude,
+        ) = parser.get_struct("!BBBBIII")
         if version != 0:
             raise dns.exception.FormError("LOC version not zero")
         if latitude < _MIN_LATITUDE or latitude > _MAX_LATITUDE:
@@ -312,8 +343,7 @@ class LOC(dns.rdata.Rdata):
         size = _decode_size(size, "size")
         hprec = _decode_size(hprec, "horizontal precision")
         vprec = _decode_size(vprec, "vertical precision")
-        return cls(rdclass, rdtype, latitude, longitude, altitude,
-                   size, hprec, vprec)
+        return cls(rdclass, rdtype, latitude, longitude, altitude, size, hprec, vprec)
 
     @property
     def float_latitude(self):
diff --git a/lib/dns/rdtypes/ANY/LP.py b/lib/dns/rdtypes/ANY/LP.py
index b6a2e36c..8a7c5125 100644
--- a/lib/dns/rdtypes/ANY/LP.py
+++ b/lib/dns/rdtypes/ANY/LP.py
@@ -3,6 +3,7 @@
 import struct
 
 import dns.immutable
+import dns.rdata
 
 
 @dns.immutable.immutable
@@ -12,7 +13,7 @@ class LP(dns.rdata.Rdata):
 
     # see: rfc6742.txt
 
-    __slots__ = ['preference', 'fqdn']
+    __slots__ = ["preference", "fqdn"]
 
     def __init__(self, rdclass, rdtype, preference, fqdn):
         super().__init__(rdclass, rdtype)
@@ -21,17 +22,18 @@ class LP(dns.rdata.Rdata):
 
     def to_text(self, origin=None, relativize=True, **kw):
         fqdn = self.fqdn.choose_relativity(origin, relativize)
-        return '%d %s' % (self.preference, fqdn)
+        return "%d %s" % (self.preference, fqdn)
 
     @classmethod
-    def from_text(cls, rdclass, rdtype, tok, origin=None, relativize=True,
-                  relativize_to=None):
+    def from_text(
+        cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None
+    ):
         preference = tok.get_uint16()
         fqdn = tok.get_name(origin, relativize, relativize_to)
         return cls(rdclass, rdtype, preference, fqdn)
 
     def _to_wire(self, file, compress=None, origin=None, canonicalize=False):
-        file.write(struct.pack('!H', self.preference))
+        file.write(struct.pack("!H", self.preference))
         self.fqdn.to_wire(file, compress, origin, canonicalize)
 
     @classmethod
diff --git a/lib/dns/rdtypes/ANY/NID.py b/lib/dns/rdtypes/ANY/NID.py
index 74951bbf..ad54aca3 100644
--- a/lib/dns/rdtypes/ANY/NID.py
+++ b/lib/dns/rdtypes/ANY/NID.py
@@ -13,32 +13,33 @@ class NID(dns.rdata.Rdata):
 
     # see: rfc6742.txt
 
-    __slots__ = ['preference', 'nodeid']
+    __slots__ = ["preference", "nodeid"]
 
     def __init__(self, rdclass, rdtype, preference, nodeid):
         super().__init__(rdclass, rdtype)
         self.preference = self._as_uint16(preference)
         if isinstance(nodeid, bytes):
             if len(nodeid) != 8:
-                raise ValueError('invalid nodeid')
-            self.nodeid = dns.rdata._hexify(nodeid, 4, b':')
+                raise ValueError("invalid nodeid")
+            self.nodeid = dns.rdata._hexify(nodeid, 4, b":")
         else:
-            dns.rdtypes.util.parse_formatted_hex(nodeid, 4, 4, ':')
+            dns.rdtypes.util.parse_formatted_hex(nodeid, 4, 4, ":")
             self.nodeid = nodeid
 
     def to_text(self, origin=None, relativize=True, **kw):
-        return f'{self.preference} {self.nodeid}'
+        return f"{self.preference} {self.nodeid}"
 
     @classmethod
-    def from_text(cls, rdclass, rdtype, tok, origin=None, relativize=True,
-                  relativize_to=None):
+    def from_text(
+        cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None
+    ):
         preference = tok.get_uint16()
         nodeid = tok.get_identifier()
         return cls(rdclass, rdtype, preference, nodeid)
 
     def _to_wire(self, file, compress=None, origin=None, canonicalize=False):
-        file.write(struct.pack('!H', self.preference))
-        file.write(dns.rdtypes.util.parse_formatted_hex(self.nodeid, 4, 4, ':'))
+        file.write(struct.pack("!H", self.preference))
+        file.write(dns.rdtypes.util.parse_formatted_hex(self.nodeid, 4, 4, ":"))
 
     @classmethod
     def from_wire_parser(cls, rdclass, rdtype, parser, origin=None):
diff --git a/lib/dns/rdtypes/ANY/NSEC.py b/lib/dns/rdtypes/ANY/NSEC.py
index dc31f4c4..7af7b77f 100644
--- a/lib/dns/rdtypes/ANY/NSEC.py
+++ b/lib/dns/rdtypes/ANY/NSEC.py
@@ -25,7 +25,7 @@ import dns.rdtypes.util
 
 @dns.immutable.immutable
 class Bitmap(dns.rdtypes.util.Bitmap):
-    type_name = 'NSEC'
+    type_name = "NSEC"
 
 
 @dns.immutable.immutable
@@ -33,7 +33,7 @@ class NSEC(dns.rdata.Rdata):
 
     """NSEC record"""
 
-    __slots__ = ['next', 'windows']
+    __slots__ = ["next", "windows"]
 
     def __init__(self, rdclass, rdtype, next, windows):
         super().__init__(rdclass, rdtype)
@@ -45,11 +45,12 @@ class NSEC(dns.rdata.Rdata):
     def to_text(self, origin=None, relativize=True, **kw):
         next = self.next.choose_relativity(origin, relativize)
         text = Bitmap(self.windows).to_text()
-        return '{}{}'.format(next, text)
+        return "{}{}".format(next, text)
 
     @classmethod
-    def from_text(cls, rdclass, rdtype, tok, origin=None, relativize=True,
-                  relativize_to=None):
+    def from_text(
+        cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None
+    ):
         next = tok.get_name(origin, relativize, relativize_to)
         windows = Bitmap.from_text(tok)
         return cls(rdclass, rdtype, next, windows)
diff --git a/lib/dns/rdtypes/ANY/NSEC3.py b/lib/dns/rdtypes/ANY/NSEC3.py
index 14242bda..6eae16e0 100644
--- a/lib/dns/rdtypes/ANY/NSEC3.py
+++ b/lib/dns/rdtypes/ANY/NSEC3.py
@@ -26,10 +26,12 @@ import dns.rdatatype
 import dns.rdtypes.util
 
 
-b32_hex_to_normal = bytes.maketrans(b'0123456789ABCDEFGHIJKLMNOPQRSTUV',
-                                    b'ABCDEFGHIJKLMNOPQRSTUVWXYZ234567')
-b32_normal_to_hex = bytes.maketrans(b'ABCDEFGHIJKLMNOPQRSTUVWXYZ234567',
-                                    b'0123456789ABCDEFGHIJKLMNOPQRSTUV')
+b32_hex_to_normal = bytes.maketrans(
+    b"0123456789ABCDEFGHIJKLMNOPQRSTUV", b"ABCDEFGHIJKLMNOPQRSTUVWXYZ234567"
+)
+b32_normal_to_hex = bytes.maketrans(
+    b"ABCDEFGHIJKLMNOPQRSTUVWXYZ234567", b"0123456789ABCDEFGHIJKLMNOPQRSTUV"
+)
 
 # hash algorithm constants
 SHA1 = 1
@@ -40,7 +42,7 @@ OPTOUT = 1
 
 @dns.immutable.immutable
 class Bitmap(dns.rdtypes.util.Bitmap):
-    type_name = 'NSEC3'
+    type_name = "NSEC3"
 
 
 @dns.immutable.immutable
@@ -48,10 +50,11 @@ class NSEC3(dns.rdata.Rdata):
 
     """NSEC3 record"""
 
-    __slots__ = ['algorithm', 'flags', 'iterations', 'salt', 'next', 'windows']
+    __slots__ = ["algorithm", "flags", "iterations", "salt", "next", "windows"]
 
-    def __init__(self, rdclass, rdtype, algorithm, flags, iterations, salt,
-                 next, windows):
+    def __init__(
+        self, rdclass, rdtype, algorithm, flags, iterations, salt, next, windows
+    ):
         super().__init__(rdclass, rdtype)
         self.algorithm = self._as_uint8(algorithm)
         self.flags = self._as_uint8(flags)
@@ -63,38 +66,41 @@ class NSEC3(dns.rdata.Rdata):
         self.windows = tuple(windows.windows)
 
     def to_text(self, origin=None, relativize=True, **kw):
-        next = base64.b32encode(self.next).translate(
-            b32_normal_to_hex).lower().decode()
-        if self.salt == b'':
-            salt = '-'
+        next = base64.b32encode(self.next).translate(b32_normal_to_hex).lower().decode()
+        if self.salt == b"":
+            salt = "-"
         else:
             salt = binascii.hexlify(self.salt).decode()
         text = Bitmap(self.windows).to_text()
-        return '%u %u %u %s %s%s' % (self.algorithm, self.flags,
-                                     self.iterations, salt, next, text)
+        return "%u %u %u %s %s%s" % (
+            self.algorithm,
+            self.flags,
+            self.iterations,
+            salt,
+            next,
+            text,
+        )
 
     @classmethod
-    def from_text(cls, rdclass, rdtype, tok, origin=None, relativize=True,
-                  relativize_to=None):
+    def from_text(
+        cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None
+    ):
         algorithm = tok.get_uint8()
         flags = tok.get_uint8()
         iterations = tok.get_uint16()
         salt = tok.get_string()
-        if salt == '-':
-            salt = b''
+        if salt == "-":
+            salt = b""
         else:
-            salt = binascii.unhexlify(salt.encode('ascii'))
-        next = tok.get_string().encode(
-            'ascii').upper().translate(b32_hex_to_normal)
+            salt = binascii.unhexlify(salt.encode("ascii"))
+        next = tok.get_string().encode("ascii").upper().translate(b32_hex_to_normal)
         next = base64.b32decode(next)
         bitmap = Bitmap.from_text(tok)
-        return cls(rdclass, rdtype, algorithm, flags, iterations, salt, next,
-                   bitmap)
+        return cls(rdclass, rdtype, algorithm, flags, iterations, salt, next, bitmap)
 
     def _to_wire(self, file, compress=None, origin=None, canonicalize=False):
         l = len(self.salt)
-        file.write(struct.pack("!BBHB", self.algorithm, self.flags,
-                               self.iterations, l))
+        file.write(struct.pack("!BBHB", self.algorithm, self.flags, self.iterations, l))
         file.write(self.salt)
         l = len(self.next)
         file.write(struct.pack("!B", l))
@@ -103,9 +109,8 @@ class NSEC3(dns.rdata.Rdata):
 
     @classmethod
     def from_wire_parser(cls, rdclass, rdtype, parser, origin=None):
-        (algorithm, flags, iterations) = parser.get_struct('!BBH')
+        (algorithm, flags, iterations) = parser.get_struct("!BBH")
         salt = parser.get_counted_bytes()
         next = parser.get_counted_bytes()
         bitmap = Bitmap.from_wire_parser(parser)
-        return cls(rdclass, rdtype, algorithm, flags, iterations, salt, next,
-                   bitmap)
+        return cls(rdclass, rdtype, algorithm, flags, iterations, salt, next, bitmap)
diff --git a/lib/dns/rdtypes/ANY/NSEC3PARAM.py b/lib/dns/rdtypes/ANY/NSEC3PARAM.py
index 299bf6ed..1b7269a0 100644
--- a/lib/dns/rdtypes/ANY/NSEC3PARAM.py
+++ b/lib/dns/rdtypes/ANY/NSEC3PARAM.py
@@ -28,7 +28,7 @@ class NSEC3PARAM(dns.rdata.Rdata):
 
     """NSEC3PARAM record"""
 
-    __slots__ = ['algorithm', 'flags', 'iterations', 'salt']
+    __slots__ = ["algorithm", "flags", "iterations", "salt"]
 
     def __init__(self, rdclass, rdtype, algorithm, flags, iterations, salt):
         super().__init__(rdclass, rdtype)
@@ -38,34 +38,33 @@ class NSEC3PARAM(dns.rdata.Rdata):
         self.salt = self._as_bytes(salt, True, 255)
 
     def to_text(self, origin=None, relativize=True, **kw):
-        if self.salt == b'':
-            salt = '-'
+        if self.salt == b"":
+            salt = "-"
         else:
             salt = binascii.hexlify(self.salt).decode()
-        return '%u %u %u %s' % (self.algorithm, self.flags, self.iterations,
-                                salt)
+        return "%u %u %u %s" % (self.algorithm, self.flags, self.iterations, salt)
 
     @classmethod
-    def from_text(cls, rdclass, rdtype, tok, origin=None, relativize=True,
-                  relativize_to=None):
+    def from_text(
+        cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None
+    ):
         algorithm = tok.get_uint8()
         flags = tok.get_uint8()
         iterations = tok.get_uint16()
         salt = tok.get_string()
-        if salt == '-':
-            salt = ''
+        if salt == "-":
+            salt = ""
         else:
             salt = binascii.unhexlify(salt.encode())
         return cls(rdclass, rdtype, algorithm, flags, iterations, salt)
 
     def _to_wire(self, file, compress=None, origin=None, canonicalize=False):
         l = len(self.salt)
-        file.write(struct.pack("!BBHB", self.algorithm, self.flags,
-                               self.iterations, l))
+        file.write(struct.pack("!BBHB", self.algorithm, self.flags, self.iterations, l))
         file.write(self.salt)
 
     @classmethod
     def from_wire_parser(cls, rdclass, rdtype, parser, origin=None):
-        (algorithm, flags, iterations) = parser.get_struct('!BBH')
+        (algorithm, flags, iterations) = parser.get_struct("!BBH")
         salt = parser.get_counted_bytes()
         return cls(rdclass, rdtype, algorithm, flags, iterations, salt)
diff --git a/lib/dns/rdtypes/ANY/OPENPGPKEY.py b/lib/dns/rdtypes/ANY/OPENPGPKEY.py
index dcfa028d..e5e25727 100644
--- a/lib/dns/rdtypes/ANY/OPENPGPKEY.py
+++ b/lib/dns/rdtypes/ANY/OPENPGPKEY.py
@@ -22,6 +22,7 @@ import dns.immutable
 import dns.rdata
 import dns.tokenizer
 
+
 @dns.immutable.immutable
 class OPENPGPKEY(dns.rdata.Rdata):
 
@@ -37,8 +38,9 @@ class OPENPGPKEY(dns.rdata.Rdata):
         return dns.rdata._base64ify(self.key, chunksize=None, **kw)
 
     @classmethod
-    def from_text(cls, rdclass, rdtype, tok, origin=None, relativize=True,
-                  relativize_to=None):
+    def from_text(
+        cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None
+    ):
         b64 = tok.concatenate_remaining_identifiers().encode()
         key = base64.b64decode(b64)
         return cls(rdclass, rdtype, key)
diff --git a/lib/dns/rdtypes/ANY/OPT.py b/lib/dns/rdtypes/ANY/OPT.py
index 69b8fe75..36d4c7c6 100644
--- a/lib/dns/rdtypes/ANY/OPT.py
+++ b/lib/dns/rdtypes/ANY/OPT.py
@@ -26,12 +26,13 @@ import dns.rdata
 # We don't implement from_text, and that's ok.
 # pylint: disable=abstract-method
 
+
 @dns.immutable.immutable
 class OPT(dns.rdata.Rdata):
 
     """OPT record"""
 
-    __slots__ = ['options']
+    __slots__ = ["options"]
 
     def __init__(self, rdclass, rdtype, options):
         """Initialize an OPT rdata.
@@ -45,10 +46,12 @@ class OPT(dns.rdata.Rdata):
         """
 
         super().__init__(rdclass, rdtype)
+
         def as_option(option):
             if not isinstance(option, dns.edns.Option):
-                raise ValueError('option is not a dns.edns.option')
+                raise ValueError("option is not a dns.edns.option")
             return option
+
         self.options = self._as_tuple(options, as_option)
 
     def _to_wire(self, file, compress=None, origin=None, canonicalize=False):
@@ -58,13 +61,13 @@ class OPT(dns.rdata.Rdata):
             file.write(owire)
 
     def to_text(self, origin=None, relativize=True, **kw):
-        return ' '.join(opt.to_text() for opt in self.options)
+        return " ".join(opt.to_text() for opt in self.options)
 
     @classmethod
     def from_wire_parser(cls, rdclass, rdtype, parser, origin=None):
         options = []
         while parser.remaining() > 0:
-            (otype, olen) = parser.get_struct('!HH')
+            (otype, olen) = parser.get_struct("!HH")
             with parser.restrict_to(olen):
                 opt = dns.edns.option_from_wire_parser(otype, parser)
             options.append(opt)
diff --git a/lib/dns/rdtypes/ANY/RP.py b/lib/dns/rdtypes/ANY/RP.py
index a4e2297d..c0c316b5 100644
--- a/lib/dns/rdtypes/ANY/RP.py
+++ b/lib/dns/rdtypes/ANY/RP.py
@@ -28,7 +28,7 @@ class RP(dns.rdata.Rdata):
 
     # see: RFC 1183
 
-    __slots__ = ['mbox', 'txt']
+    __slots__ = ["mbox", "txt"]
 
     def __init__(self, rdclass, rdtype, mbox, txt):
         super().__init__(rdclass, rdtype)
@@ -41,8 +41,9 @@ class RP(dns.rdata.Rdata):
         return "{} {}".format(str(mbox), str(txt))
 
     @classmethod
-    def from_text(cls, rdclass, rdtype, tok, origin=None, relativize=True,
-                  relativize_to=None):
+    def from_text(
+        cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None
+    ):
         mbox = tok.get_name(origin, relativize, relativize_to)
         txt = tok.get_name(origin, relativize, relativize_to)
         return cls(rdclass, rdtype, mbox, txt)
diff --git a/lib/dns/rdtypes/ANY/RRSIG.py b/lib/dns/rdtypes/ANY/RRSIG.py
index d050ccc6..3d5ad0f3 100644
--- a/lib/dns/rdtypes/ANY/RRSIG.py
+++ b/lib/dns/rdtypes/ANY/RRSIG.py
@@ -20,7 +20,7 @@ import calendar
 import struct
 import time
 
-import dns.dnssec
+import dns.dnssectypes
 import dns.immutable
 import dns.exception
 import dns.rdata
@@ -43,12 +43,11 @@ def sigtime_to_posixtime(what):
     hour = int(what[8:10])
     minute = int(what[10:12])
     second = int(what[12:14])
-    return calendar.timegm((year, month, day, hour, minute, second,
-                            0, 0, 0))
+    return calendar.timegm((year, month, day, hour, minute, second, 0, 0, 0))
 
 
 def posixtime_to_sigtime(what):
-    return time.strftime('%Y%m%d%H%M%S', time.gmtime(what))
+    return time.strftime("%Y%m%d%H%M%S", time.gmtime(what))
 
 
 @dns.immutable.immutable
@@ -56,16 +55,35 @@ class RRSIG(dns.rdata.Rdata):
 
     """RRSIG record"""
 
-    __slots__ = ['type_covered', 'algorithm', 'labels', 'original_ttl',
-                 'expiration', 'inception', 'key_tag', 'signer',
-                 'signature']
+    __slots__ = [
+        "type_covered",
+        "algorithm",
+        "labels",
+        "original_ttl",
+        "expiration",
+        "inception",
+        "key_tag",
+        "signer",
+        "signature",
+    ]
 
-    def __init__(self, rdclass, rdtype, type_covered, algorithm, labels,
-                 original_ttl, expiration, inception, key_tag, signer,
-                 signature):
+    def __init__(
+        self,
+        rdclass,
+        rdtype,
+        type_covered,
+        algorithm,
+        labels,
+        original_ttl,
+        expiration,
+        inception,
+        key_tag,
+        signer,
+        signature,
+    ):
         super().__init__(rdclass, rdtype)
         self.type_covered = self._as_rdatatype(type_covered)
-        self.algorithm = dns.dnssec.Algorithm.make(algorithm)
+        self.algorithm = dns.dnssectypes.Algorithm.make(algorithm)
         self.labels = self._as_uint8(labels)
         self.original_ttl = self._as_ttl(original_ttl)
         self.expiration = self._as_uint32(expiration)
@@ -78,7 +96,7 @@ class RRSIG(dns.rdata.Rdata):
         return self.type_covered
 
     def to_text(self, origin=None, relativize=True, **kw):
-        return '%s %d %d %d %s %s %d %s %s' % (
+        return "%s %d %d %d %s %s %d %s %s" % (
             dns.rdatatype.to_text(self.type_covered),
             self.algorithm,
             self.labels,
@@ -87,14 +105,15 @@ class RRSIG(dns.rdata.Rdata):
             posixtime_to_sigtime(self.inception),
             self.key_tag,
             self.signer.choose_relativity(origin, relativize),
-            dns.rdata._base64ify(self.signature, **kw)
+            dns.rdata._base64ify(self.signature, **kw),
         )
 
     @classmethod
-    def from_text(cls, rdclass, rdtype, tok, origin=None, relativize=True,
-                  relativize_to=None):
+    def from_text(
+        cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None
+    ):
         type_covered = dns.rdatatype.from_text(tok.get_string())
-        algorithm = dns.dnssec.algorithm_from_text(tok.get_string())
+        algorithm = dns.dnssectypes.Algorithm.from_text(tok.get_string())
         labels = tok.get_int()
         original_ttl = tok.get_ttl()
         expiration = sigtime_to_posixtime(tok.get_string())
@@ -103,22 +122,38 @@ class RRSIG(dns.rdata.Rdata):
         signer = tok.get_name(origin, relativize, relativize_to)
         b64 = tok.concatenate_remaining_identifiers().encode()
         signature = base64.b64decode(b64)
-        return cls(rdclass, rdtype, type_covered, algorithm, labels,
-                   original_ttl, expiration, inception, key_tag, signer,
-                   signature)
+        return cls(
+            rdclass,
+            rdtype,
+            type_covered,
+            algorithm,
+            labels,
+            original_ttl,
+            expiration,
+            inception,
+            key_tag,
+            signer,
+            signature,
+        )
 
     def _to_wire(self, file, compress=None, origin=None, canonicalize=False):
-        header = struct.pack('!HBBIIIH', self.type_covered,
-                             self.algorithm, self.labels,
-                             self.original_ttl, self.expiration,
-                             self.inception, self.key_tag)
+        header = struct.pack(
+            "!HBBIIIH",
+            self.type_covered,
+            self.algorithm,
+            self.labels,
+            self.original_ttl,
+            self.expiration,
+            self.inception,
+            self.key_tag,
+        )
         file.write(header)
         self.signer.to_wire(file, None, origin, canonicalize)
         file.write(self.signature)
 
     @classmethod
     def from_wire_parser(cls, rdclass, rdtype, parser, origin=None):
-        header = parser.get_struct('!HBBIIIH')
+        header = parser.get_struct("!HBBIIIH")
         signer = parser.get_name(origin)
         signature = parser.get_remaining()
         return cls(rdclass, rdtype, *header, signer, signature)
diff --git a/lib/dns/rdtypes/ANY/SOA.py b/lib/dns/rdtypes/ANY/SOA.py
index 7ce88652..6f6fe58b 100644
--- a/lib/dns/rdtypes/ANY/SOA.py
+++ b/lib/dns/rdtypes/ANY/SOA.py
@@ -30,11 +30,11 @@ class SOA(dns.rdata.Rdata):
 
     # see: RFC 1035
 
-    __slots__ = ['mname', 'rname', 'serial', 'refresh', 'retry', 'expire',
-                 'minimum']
+    __slots__ = ["mname", "rname", "serial", "refresh", "retry", "expire", "minimum"]
 
-    def __init__(self, rdclass, rdtype, mname, rname, serial, refresh, retry,
-                 expire, minimum):
+    def __init__(
+        self, rdclass, rdtype, mname, rname, serial, refresh, retry, expire, minimum
+    ):
         super().__init__(rdclass, rdtype)
         self.mname = self._as_name(mname)
         self.rname = self._as_name(rname)
@@ -47,13 +47,20 @@ class SOA(dns.rdata.Rdata):
     def to_text(self, origin=None, relativize=True, **kw):
         mname = self.mname.choose_relativity(origin, relativize)
         rname = self.rname.choose_relativity(origin, relativize)
-        return '%s %s %d %d %d %d %d' % (
-            mname, rname, self.serial, self.refresh, self.retry,
-            self.expire, self.minimum)
+        return "%s %s %d %d %d %d %d" % (
+            mname,
+            rname,
+            self.serial,
+            self.refresh,
+            self.retry,
+            self.expire,
+            self.minimum,
+        )
 
     @classmethod
-    def from_text(cls, rdclass, rdtype, tok, origin=None, relativize=True,
-                  relativize_to=None):
+    def from_text(
+        cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None
+    ):
         mname = tok.get_name(origin, relativize, relativize_to)
         rname = tok.get_name(origin, relativize, relativize_to)
         serial = tok.get_uint32()
@@ -61,18 +68,20 @@ class SOA(dns.rdata.Rdata):
         retry = tok.get_ttl()
         expire = tok.get_ttl()
         minimum = tok.get_ttl()
-        return cls(rdclass, rdtype, mname, rname, serial, refresh, retry,
-                   expire, minimum)
+        return cls(
+            rdclass, rdtype, mname, rname, serial, refresh, retry, expire, minimum
+        )
 
     def _to_wire(self, file, compress=None, origin=None, canonicalize=False):
         self.mname.to_wire(file, compress, origin, canonicalize)
         self.rname.to_wire(file, compress, origin, canonicalize)
-        five_ints = struct.pack('!IIIII', self.serial, self.refresh,
-                                self.retry, self.expire, self.minimum)
+        five_ints = struct.pack(
+            "!IIIII", self.serial, self.refresh, self.retry, self.expire, self.minimum
+        )
         file.write(five_ints)
 
     @classmethod
     def from_wire_parser(cls, rdclass, rdtype, parser, origin=None):
         mname = parser.get_name(origin)
         rname = parser.get_name(origin)
-        return cls(rdclass, rdtype, mname, rname, *parser.get_struct('!IIIII'))
+        return cls(rdclass, rdtype, mname, rname, *parser.get_struct("!IIIII"))
diff --git a/lib/dns/rdtypes/ANY/SSHFP.py b/lib/dns/rdtypes/ANY/SSHFP.py
index cc035195..58ffcbbc 100644
--- a/lib/dns/rdtypes/ANY/SSHFP.py
+++ b/lib/dns/rdtypes/ANY/SSHFP.py
@@ -30,10 +30,9 @@ class SSHFP(dns.rdata.Rdata):
 
     # See RFC 4255
 
-    __slots__ = ['algorithm', 'fp_type', 'fingerprint']
+    __slots__ = ["algorithm", "fp_type", "fingerprint"]
 
-    def __init__(self, rdclass, rdtype, algorithm, fp_type,
-                 fingerprint):
+    def __init__(self, rdclass, rdtype, algorithm, fp_type, fingerprint):
         super().__init__(rdclass, rdtype)
         self.algorithm = self._as_uint8(algorithm)
         self.fp_type = self._as_uint8(fp_type)
@@ -41,16 +40,17 @@ class SSHFP(dns.rdata.Rdata):
 
     def to_text(self, origin=None, relativize=True, **kw):
         kw = kw.copy()
-        chunksize = kw.pop('chunksize', 128)
-        return '%d %d %s' % (self.algorithm,
-                             self.fp_type,
-                             dns.rdata._hexify(self.fingerprint,
-                                               chunksize=chunksize,
-                                               **kw))
+        chunksize = kw.pop("chunksize", 128)
+        return "%d %d %s" % (
+            self.algorithm,
+            self.fp_type,
+            dns.rdata._hexify(self.fingerprint, chunksize=chunksize, **kw),
+        )
 
     @classmethod
-    def from_text(cls, rdclass, rdtype, tok, origin=None, relativize=True,
-                  relativize_to=None):
+    def from_text(
+        cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None
+    ):
         algorithm = tok.get_uint8()
         fp_type = tok.get_uint8()
         fingerprint = tok.concatenate_remaining_identifiers().encode()
diff --git a/lib/dns/rdtypes/ANY/TKEY.py b/lib/dns/rdtypes/ANY/TKEY.py
index 861fc4e3..070f03af 100644
--- a/lib/dns/rdtypes/ANY/TKEY.py
+++ b/lib/dns/rdtypes/ANY/TKEY.py
@@ -18,7 +18,6 @@
 import base64
 import struct
 
-import dns.dnssec
 import dns.immutable
 import dns.exception
 import dns.rdata
@@ -29,11 +28,28 @@ class TKEY(dns.rdata.Rdata):
 
     """TKEY Record"""
 
-    __slots__ = ['algorithm', 'inception', 'expiration', 'mode', 'error',
-                 'key', 'other']
+    __slots__ = [
+        "algorithm",
+        "inception",
+        "expiration",
+        "mode",
+        "error",
+        "key",
+        "other",
+    ]
 
-    def __init__(self, rdclass, rdtype, algorithm, inception, expiration,
-                 mode, error, key, other=b''):
+    def __init__(
+        self,
+        rdclass,
+        rdtype,
+        algorithm,
+        inception,
+        expiration,
+        mode,
+        error,
+        key,
+        other=b"",
+    ):
         super().__init__(rdclass, rdtype)
         self.algorithm = self._as_name(algorithm)
         self.inception = self._as_uint32(inception)
@@ -45,17 +61,23 @@ class TKEY(dns.rdata.Rdata):
 
     def to_text(self, origin=None, relativize=True, **kw):
         _algorithm = self.algorithm.choose_relativity(origin, relativize)
-        text = '%s %u %u %u %u %s' % (str(_algorithm), self.inception,
-                                      self.expiration, self.mode, self.error,
-                                      dns.rdata._base64ify(self.key, 0))
+        text = "%s %u %u %u %u %s" % (
+            str(_algorithm),
+            self.inception,
+            self.expiration,
+            self.mode,
+            self.error,
+            dns.rdata._base64ify(self.key, 0),
+        )
         if len(self.other) > 0:
-            text += ' %s' % (dns.rdata._base64ify(self.other, 0))
+            text += " %s" % (dns.rdata._base64ify(self.other, 0))
 
         return text
 
     @classmethod
-    def from_text(cls, rdclass, rdtype, tok, origin=None, relativize=True,
-                  relativize_to=None):
+    def from_text(
+        cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None
+    ):
         algorithm = tok.get_name(relativize=False)
         inception = tok.get_uint32()
         expiration = tok.get_uint32()
@@ -66,13 +88,15 @@ class TKEY(dns.rdata.Rdata):
         other_b64 = tok.concatenate_remaining_identifiers(True).encode()
         other = base64.b64decode(other_b64)
 
-        return cls(rdclass, rdtype, algorithm, inception, expiration, mode,
-                   error, key, other)
+        return cls(
+            rdclass, rdtype, algorithm, inception, expiration, mode, error, key, other
+        )
 
     def _to_wire(self, file, compress=None, origin=None, canonicalize=False):
         self.algorithm.to_wire(file, compress, origin)
-        file.write(struct.pack("!IIHH", self.inception, self.expiration,
-                               self.mode, self.error))
+        file.write(
+            struct.pack("!IIHH", self.inception, self.expiration, self.mode, self.error)
+        )
         file.write(struct.pack("!H", len(self.key)))
         file.write(self.key)
         file.write(struct.pack("!H", len(self.other)))
@@ -86,8 +110,9 @@ class TKEY(dns.rdata.Rdata):
         key = parser.get_counted_bytes(2)
         other = parser.get_counted_bytes(2)
 
-        return cls(rdclass, rdtype, algorithm, inception, expiration, mode,
-                   error, key, other)
+        return cls(
+            rdclass, rdtype, algorithm, inception, expiration, mode, error, key, other
+        )
 
     # Constants for the mode field - from RFC 2930:
     # 2.5 The Mode Field
diff --git a/lib/dns/rdtypes/ANY/TSIG.py b/lib/dns/rdtypes/ANY/TSIG.py
index b43a78f1..1ae87ebe 100644
--- a/lib/dns/rdtypes/ANY/TSIG.py
+++ b/lib/dns/rdtypes/ANY/TSIG.py
@@ -29,11 +29,28 @@ class TSIG(dns.rdata.Rdata):
 
     """TSIG record"""
 
-    __slots__ = ['algorithm', 'time_signed', 'fudge', 'mac',
-                 'original_id', 'error', 'other']
+    __slots__ = [
+        "algorithm",
+        "time_signed",
+        "fudge",
+        "mac",
+        "original_id",
+        "error",
+        "other",
+    ]
 
-    def __init__(self, rdclass, rdtype, algorithm, time_signed, fudge, mac,
-                 original_id, error, other):
+    def __init__(
+        self,
+        rdclass,
+        rdtype,
+        algorithm,
+        time_signed,
+        fudge,
+        mac,
+        original_id,
+        error,
+        other,
+    ):
         """Initialize a TSIG rdata.
 
         *rdclass*, an ``int`` is the rdataclass of the Rdata.
@@ -67,45 +84,60 @@ class TSIG(dns.rdata.Rdata):
     def to_text(self, origin=None, relativize=True, **kw):
         algorithm = self.algorithm.choose_relativity(origin, relativize)
         error = dns.rcode.to_text(self.error, True)
-        text = f"{algorithm} {self.time_signed} {self.fudge} " + \
-               f"{len(self.mac)} {dns.rdata._base64ify(self.mac, 0)} " + \
-               f"{self.original_id} {error} {len(self.other)}"
+        text = (
+            f"{algorithm} {self.time_signed} {self.fudge} "
+            + f"{len(self.mac)} {dns.rdata._base64ify(self.mac, 0)} "
+            + f"{self.original_id} {error} {len(self.other)}"
+        )
         if self.other:
             text += f" {dns.rdata._base64ify(self.other, 0)}"
         return text
 
     @classmethod
-    def from_text(cls, rdclass, rdtype, tok, origin=None, relativize=True,
-                  relativize_to=None):
+    def from_text(
+        cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None
+    ):
         algorithm = tok.get_name(relativize=False)
         time_signed = tok.get_uint48()
         fudge = tok.get_uint16()
         mac_len = tok.get_uint16()
         mac = base64.b64decode(tok.get_string())
         if len(mac) != mac_len:
-            raise SyntaxError('invalid MAC')
+            raise SyntaxError("invalid MAC")
         original_id = tok.get_uint16()
         error = dns.rcode.from_text(tok.get_string())
         other_len = tok.get_uint16()
         if other_len > 0:
             other = base64.b64decode(tok.get_string())
             if len(other) != other_len:
-                raise SyntaxError('invalid other data')
+                raise SyntaxError("invalid other data")
         else:
-            other = b''
-        return cls(rdclass, rdtype, algorithm, time_signed, fudge, mac,
-                   original_id, error, other)
+            other = b""
+        return cls(
+            rdclass,
+            rdtype,
+            algorithm,
+            time_signed,
+            fudge,
+            mac,
+            original_id,
+            error,
+            other,
+        )
 
     def _to_wire(self, file, compress=None, origin=None, canonicalize=False):
         self.algorithm.to_wire(file, None, origin, False)
-        file.write(struct.pack('!HIHH',
-                               (self.time_signed >> 32) & 0xffff,
-                               self.time_signed & 0xffffffff,
-                               self.fudge,
-                               len(self.mac)))
+        file.write(
+            struct.pack(
+                "!HIHH",
+                (self.time_signed >> 32) & 0xFFFF,
+                self.time_signed & 0xFFFFFFFF,
+                self.fudge,
+                len(self.mac),
+            )
+        )
         file.write(self.mac)
-        file.write(struct.pack('!HHH', self.original_id, self.error,
-                               len(self.other)))
+        file.write(struct.pack("!HHH", self.original_id, self.error, len(self.other)))
         file.write(self.other)
 
     @classmethod
@@ -114,7 +146,16 @@ class TSIG(dns.rdata.Rdata):
         time_signed = parser.get_uint48()
         fudge = parser.get_uint16()
         mac = parser.get_counted_bytes(2)
-        (original_id, error) = parser.get_struct('!HH')
+        (original_id, error) = parser.get_struct("!HH")
         other = parser.get_counted_bytes(2)
-        return cls(rdclass, rdtype, algorithm, time_signed, fudge, mac,
-                   original_id, error, other)
+        return cls(
+            rdclass,
+            rdtype,
+            algorithm,
+            time_signed,
+            fudge,
+            mac,
+            original_id,
+            error,
+            other,
+        )
diff --git a/lib/dns/rdtypes/ANY/URI.py b/lib/dns/rdtypes/ANY/URI.py
index 524fa1ba..b4c95a3b 100644
--- a/lib/dns/rdtypes/ANY/URI.py
+++ b/lib/dns/rdtypes/ANY/URI.py
@@ -32,7 +32,7 @@ class URI(dns.rdata.Rdata):
 
     # see RFC 7553
 
-    __slots__ = ['priority', 'weight', 'target']
+    __slots__ = ["priority", "weight", "target"]
 
     def __init__(self, rdclass, rdtype, priority, weight, target):
         super().__init__(rdclass, rdtype)
@@ -43,12 +43,12 @@ class URI(dns.rdata.Rdata):
             raise dns.exception.SyntaxError("URI target cannot be empty")
 
     def to_text(self, origin=None, relativize=True, **kw):
-        return '%d %d "%s"' % (self.priority, self.weight,
-                               self.target.decode())
+        return '%d %d "%s"' % (self.priority, self.weight, self.target.decode())
 
     @classmethod
-    def from_text(cls, rdclass, rdtype, tok, origin=None, relativize=True,
-                  relativize_to=None):
+    def from_text(
+        cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None
+    ):
         priority = tok.get_uint16()
         weight = tok.get_uint16()
         target = tok.get().unescape()
@@ -63,10 +63,10 @@ class URI(dns.rdata.Rdata):
 
     @classmethod
     def from_wire_parser(cls, rdclass, rdtype, parser, origin=None):
-        (priority, weight) = parser.get_struct('!HH')
+        (priority, weight) = parser.get_struct("!HH")
         target = parser.get_remaining()
         if len(target) == 0:
-            raise dns.exception.FormError('URI target may not be empty')
+            raise dns.exception.FormError("URI target may not be empty")
         return cls(rdclass, rdtype, priority, weight, target)
 
     def _processing_priority(self):
diff --git a/lib/dns/rdtypes/ANY/X25.py b/lib/dns/rdtypes/ANY/X25.py
index 4f7230c0..06c14534 100644
--- a/lib/dns/rdtypes/ANY/X25.py
+++ b/lib/dns/rdtypes/ANY/X25.py
@@ -30,7 +30,7 @@ class X25(dns.rdata.Rdata):
 
     # see RFC 1183
 
-    __slots__ = ['address']
+    __slots__ = ["address"]
 
     def __init__(self, rdclass, rdtype, address):
         super().__init__(rdclass, rdtype)
@@ -40,15 +40,16 @@ class X25(dns.rdata.Rdata):
         return '"%s"' % dns.rdata._escapify(self.address)
 
     @classmethod
-    def from_text(cls, rdclass, rdtype, tok, origin=None, relativize=True,
-                  relativize_to=None):
+    def from_text(
+        cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None
+    ):
         address = tok.get_string()
         return cls(rdclass, rdtype, address)
 
     def _to_wire(self, file, compress=None, origin=None, canonicalize=False):
         l = len(self.address)
         assert l < 256
-        file.write(struct.pack('!B', l))
+        file.write(struct.pack("!B", l))
         file.write(self.address)
 
     @classmethod
diff --git a/lib/dns/rdtypes/ANY/ZONEMD.py b/lib/dns/rdtypes/ANY/ZONEMD.py
index 035f7b32..1f86ba49 100644
--- a/lib/dns/rdtypes/ANY/ZONEMD.py
+++ b/lib/dns/rdtypes/ANY/ZONEMD.py
@@ -6,7 +6,7 @@ import binascii
 import dns.immutable
 import dns.rdata
 import dns.rdatatype
-import dns.zone
+import dns.zonetypes
 
 
 @dns.immutable.immutable
@@ -16,35 +16,38 @@ class ZONEMD(dns.rdata.Rdata):
 
     # See RFC 8976
 
-    __slots__ = ['serial', 'scheme', 'hash_algorithm', 'digest']
+    __slots__ = ["serial", "scheme", "hash_algorithm", "digest"]
 
     def __init__(self, rdclass, rdtype, serial, scheme, hash_algorithm, digest):
         super().__init__(rdclass, rdtype)
         self.serial = self._as_uint32(serial)
-        self.scheme = dns.zone.DigestScheme.make(scheme)
-        self.hash_algorithm = dns.zone.DigestHashAlgorithm.make(hash_algorithm)
+        self.scheme = dns.zonetypes.DigestScheme.make(scheme)
+        self.hash_algorithm = dns.zonetypes.DigestHashAlgorithm.make(hash_algorithm)
         self.digest = self._as_bytes(digest)
 
         if self.scheme == 0:  # reserved, RFC 8976 Sec. 5.2
-            raise ValueError('scheme 0 is reserved')
+            raise ValueError("scheme 0 is reserved")
         if self.hash_algorithm == 0:  # reserved, RFC 8976 Sec. 5.3
-            raise ValueError('hash_algorithm 0 is reserved')
+            raise ValueError("hash_algorithm 0 is reserved")
 
-        hasher = dns.zone._digest_hashers.get(self.hash_algorithm)
+        hasher = dns.zonetypes._digest_hashers.get(self.hash_algorithm)
         if hasher and hasher().digest_size != len(self.digest):
-            raise ValueError('digest length inconsistent with hash algorithm')
+            raise ValueError("digest length inconsistent with hash algorithm")
 
     def to_text(self, origin=None, relativize=True, **kw):
         kw = kw.copy()
-        chunksize = kw.pop('chunksize', 128)
-        return '%d %d %d %s' % (self.serial, self.scheme, self.hash_algorithm,
-                                dns.rdata._hexify(self.digest,
-                                                  chunksize=chunksize,
-                                                  **kw))
+        chunksize = kw.pop("chunksize", 128)
+        return "%d %d %d %s" % (
+            self.serial,
+            self.scheme,
+            self.hash_algorithm,
+            dns.rdata._hexify(self.digest, chunksize=chunksize, **kw),
+        )
 
     @classmethod
-    def from_text(cls, rdclass, rdtype, tok, origin=None, relativize=True,
-                  relativize_to=None):
+    def from_text(
+        cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None
+    ):
         serial = tok.get_uint32()
         scheme = tok.get_uint8()
         hash_algorithm = tok.get_uint8()
@@ -53,8 +56,7 @@ class ZONEMD(dns.rdata.Rdata):
         return cls(rdclass, rdtype, serial, scheme, hash_algorithm, digest)
 
     def _to_wire(self, file, compress=None, origin=None, canonicalize=False):
-        header = struct.pack("!IBB", self.serial, self.scheme,
-                             self.hash_algorithm)
+        header = struct.pack("!IBB", self.serial, self.scheme, self.hash_algorithm)
         file.write(header)
         file.write(self.digest)
 
diff --git a/lib/dns/rdtypes/ANY/__init__.py b/lib/dns/rdtypes/ANY/__init__.py
index 2cadcde3..3824a0a0 100644
--- a/lib/dns/rdtypes/ANY/__init__.py
+++ b/lib/dns/rdtypes/ANY/__init__.py
@@ -18,51 +18,51 @@
 """Class ANY (generic) rdata type classes."""
 
 __all__ = [
-    'AFSDB',
-    'AMTRELAY',
-    'AVC',
-    'CAA',
-    'CDNSKEY',
-    'CDS',
-    'CERT',
-    'CNAME',
-    'CSYNC',
-    'DLV',
-    'DNAME',
-    'DNSKEY',
-    'DS',
-    'EUI48',
-    'EUI64',
-    'GPOS',
-    'HINFO',
-    'HIP',
-    'ISDN',
-    'L32',
-    'L64',
-    'LOC',
-    'LP',
-    'MX',
-    'NID',
-    'NINFO',
-    'NS',
-    'NSEC',
-    'NSEC3',
-    'NSEC3PARAM',
-    'OPENPGPKEY',
-    'OPT',
-    'PTR',
-    'RP',
-    'RRSIG',
-    'RT',
-    'SMIMEA',
-    'SOA',
-    'SPF',
-    'SSHFP',
-    'TKEY',
-    'TLSA',
-    'TSIG',
-    'TXT',
-    'URI',
-    'X25',
-    'ZONEMD',
+    "AFSDB",
+    "AMTRELAY",
+    "AVC",
+    "CAA",
+    "CDNSKEY",
+    "CDS",
+    "CERT",
+    "CNAME",
+    "CSYNC",
+    "DLV",
+    "DNAME",
+    "DNSKEY",
+    "DS",
+    "EUI48",
+    "EUI64",
+    "GPOS",
+    "HINFO",
+    "HIP",
+    "ISDN",
+    "L32",
+    "L64",
+    "LOC",
+    "LP",
+    "MX",
+    "NID",
+    "NINFO",
+    "NS",
+    "NSEC",
+    "NSEC3",
+    "NSEC3PARAM",
+    "OPENPGPKEY",
+    "OPT",
+    "PTR",
+    "RP",
+    "RRSIG",
+    "RT",
+    "SMIMEA",
+    "SOA",
+    "SPF",
+    "SSHFP",
+    "TKEY",
+    "TLSA",
+    "TSIG",
+    "TXT",
+    "URI",
+    "X25",
+    "ZONEMD",
 ]
diff --git a/lib/dns/rdtypes/CH/A.py b/lib/dns/rdtypes/CH/A.py
index 828701b4..9905c7c9 100644
--- a/lib/dns/rdtypes/CH/A.py
+++ b/lib/dns/rdtypes/CH/A.py
@@ -20,6 +20,7 @@ import struct
 import dns.rdtypes.mxbase
 import dns.immutable
 
+
 @dns.immutable.immutable
 class A(dns.rdata.Rdata):
 
@@ -28,7 +29,7 @@ class A(dns.rdata.Rdata):
     # domain: the domain of the address
     # address: the 16-bit address
 
-    __slots__ = ['domain', 'address']
+    __slots__ = ["domain", "address"]
 
     def __init__(self, rdclass, rdtype, domain, address):
         super().__init__(rdclass, rdtype)
@@ -37,11 +38,12 @@ class A(dns.rdata.Rdata):
 
     def to_text(self, origin=None, relativize=True, **kw):
         domain = self.domain.choose_relativity(origin, relativize)
-        return '%s %o' % (domain, self.address)
+        return "%s %o" % (domain, self.address)
 
     @classmethod
-    def from_text(cls, rdclass, rdtype, tok, origin=None, relativize=True,
-                  relativize_to=None):
+    def from_text(
+        cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None
+    ):
         domain = tok.get_name(origin, relativize, relativize_to)
         address = tok.get_uint16(base=8)
         return cls(rdclass, rdtype, domain, address)
diff --git a/lib/dns/rdtypes/CH/__init__.py b/lib/dns/rdtypes/CH/__init__.py
index 7184a733..0760c26c 100644
--- a/lib/dns/rdtypes/CH/__init__.py
+++ b/lib/dns/rdtypes/CH/__init__.py
@@ -18,5 +18,5 @@
 """Class CH rdata type classes."""
 
 __all__ = [
-    'A',
+    "A",
 ]
diff --git a/lib/dns/rdtypes/IN/A.py b/lib/dns/rdtypes/IN/A.py
index 74b591ef..713d5eea 100644
--- a/lib/dns/rdtypes/IN/A.py
+++ b/lib/dns/rdtypes/IN/A.py
@@ -27,7 +27,7 @@ class A(dns.rdata.Rdata):
 
     """A record."""
 
-    __slots__ = ['address']
+    __slots__ = ["address"]
 
     def __init__(self, rdclass, rdtype, address):
         super().__init__(rdclass, rdtype)
@@ -37,8 +37,9 @@ class A(dns.rdata.Rdata):
         return self.address
 
     @classmethod
-    def from_text(cls, rdclass, rdtype, tok, origin=None, relativize=True,
-                  relativize_to=None):
+    def from_text(
+        cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None
+    ):
         address = tok.get_identifier()
         return cls(rdclass, rdtype, address)
 
diff --git a/lib/dns/rdtypes/IN/AAAA.py b/lib/dns/rdtypes/IN/AAAA.py
index 2d3ec902..f8237b44 100644
--- a/lib/dns/rdtypes/IN/AAAA.py
+++ b/lib/dns/rdtypes/IN/AAAA.py
@@ -27,7 +27,7 @@ class AAAA(dns.rdata.Rdata):
 
     """AAAA record."""
 
-    __slots__ = ['address']
+    __slots__ = ["address"]
 
     def __init__(self, rdclass, rdtype, address):
         super().__init__(rdclass, rdtype)
@@ -37,8 +37,9 @@ class AAAA(dns.rdata.Rdata):
         return self.address
 
     @classmethod
-    def from_text(cls, rdclass, rdtype, tok, origin=None, relativize=True,
-                  relativize_to=None):
+    def from_text(
+        cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None
+    ):
         address = tok.get_identifier()
         return cls(rdclass, rdtype, address)
 
diff --git a/lib/dns/rdtypes/IN/APL.py b/lib/dns/rdtypes/IN/APL.py
index ae94fb24..05e1689f 100644
--- a/lib/dns/rdtypes/IN/APL.py
+++ b/lib/dns/rdtypes/IN/APL.py
@@ -26,12 +26,13 @@ import dns.ipv6
 import dns.rdata
 import dns.tokenizer
 
+
 @dns.immutable.immutable
 class APLItem:
 
     """An APL list item."""
 
-    __slots__ = ['family', 'negation', 'address', 'prefix']
+    __slots__ = ["family", "negation", "address", "prefix"]
 
     def __init__(self, family, negation, address, prefix):
         self.family = dns.rdata.Rdata._as_uint16(family)
@@ -67,12 +68,12 @@ class APLItem:
             if address[i] != 0:
                 last = i + 1
                 break
-        address = address[0: last]
+        address = address[0:last]
         l = len(address)
         assert l < 128
         if self.negation:
             l |= 0x80
-        header = struct.pack('!HBB', self.family, self.prefix, l)
+        header = struct.pack("!HBB", self.family, self.prefix, l)
         file.write(header)
         file.write(address)
 
@@ -84,32 +85,33 @@ class APL(dns.rdata.Rdata):
 
     # see: RFC 3123
 
-    __slots__ = ['items']
+    __slots__ = ["items"]
 
     def __init__(self, rdclass, rdtype, items):
         super().__init__(rdclass, rdtype)
         for item in items:
             if not isinstance(item, APLItem):
-                raise ValueError('item not an APLItem')
+                raise ValueError("item not an APLItem")
         self.items = tuple(items)
 
     def to_text(self, origin=None, relativize=True, **kw):
-        return ' '.join(map(str, self.items))
+        return " ".join(map(str, self.items))
 
     @classmethod
-    def from_text(cls, rdclass, rdtype, tok, origin=None, relativize=True,
-                  relativize_to=None):
+    def from_text(
+        cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None
+    ):
         items = []
         for token in tok.get_remaining():
             item = token.unescape().value
-            if item[0] == '!':
+            if item[0] == "!":
                 negation = True
                 item = item[1:]
             else:
                 negation = False
-            (family, rest) = item.split(':', 1)
+            (family, rest) = item.split(":", 1)
             family = int(family)
-            (address, prefix) = rest.split('/', 1)
+            (address, prefix) = rest.split("/", 1)
             prefix = int(prefix)
             item = APLItem(family, negation, address, prefix)
             items.append(item)
@@ -125,7 +127,7 @@ class APL(dns.rdata.Rdata):
 
         items = []
         while parser.remaining() > 0:
-            header = parser.get_struct('!HBB')
+            header = parser.get_struct("!HBB")
             afdlen = header[2]
             if afdlen > 127:
                 negation = True
@@ -136,16 +138,16 @@ class APL(dns.rdata.Rdata):
             l = len(address)
             if header[0] == 1:
                 if l < 4:
-                    address += b'\x00' * (4 - l)
+                    address += b"\x00" * (4 - l)
             elif header[0] == 2:
                 if l < 16:
-                    address += b'\x00' * (16 - l)
+                    address += b"\x00" * (16 - l)
             else:
                 #
                 # This isn't really right according to the RFC, but it
                 # seems better than throwing an exception
                 #
-                address = codecs.encode(address, 'hex_codec')
+                address = codecs.encode(address, "hex_codec")
             item = APLItem(header[0], negation, address, header[1])
             items.append(item)
         return cls(rdclass, rdtype, items)
diff --git a/lib/dns/rdtypes/IN/DHCID.py b/lib/dns/rdtypes/IN/DHCID.py
index a9185989..65f85897 100644
--- a/lib/dns/rdtypes/IN/DHCID.py
+++ b/lib/dns/rdtypes/IN/DHCID.py
@@ -19,6 +19,7 @@ import base64
 
 import dns.exception
 import dns.immutable
+import dns.rdata
 
 
 @dns.immutable.immutable
@@ -28,7 +29,7 @@ class DHCID(dns.rdata.Rdata):
 
     # see: RFC 4701
 
-    __slots__ = ['data']
+    __slots__ = ["data"]
 
     def __init__(self, rdclass, rdtype, data):
         super().__init__(rdclass, rdtype)
@@ -38,8 +39,9 @@ class DHCID(dns.rdata.Rdata):
         return dns.rdata._base64ify(self.data, **kw)
 
     @classmethod
-    def from_text(cls, rdclass, rdtype, tok, origin=None, relativize=True,
-                  relativize_to=None):
+    def from_text(
+        cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None
+    ):
         b64 = tok.concatenate_remaining_identifiers().encode()
         data = base64.b64decode(b64)
         return cls(rdclass, rdtype, data)
diff --git a/lib/dns/rdtypes/IN/HTTPS.py b/lib/dns/rdtypes/IN/HTTPS.py
index 6a67e8ed..7797fbaf 100644
--- a/lib/dns/rdtypes/IN/HTTPS.py
+++ b/lib/dns/rdtypes/IN/HTTPS.py
@@ -3,6 +3,7 @@
 import dns.rdtypes.svcbbase
 import dns.immutable
 
+
 @dns.immutable.immutable
 class HTTPS(dns.rdtypes.svcbbase.SVCBBase):
     """HTTPS record"""
diff --git a/lib/dns/rdtypes/IN/IPSECKEY.py b/lib/dns/rdtypes/IN/IPSECKEY.py
index d1d39438..1255739f 100644
--- a/lib/dns/rdtypes/IN/IPSECKEY.py
+++ b/lib/dns/rdtypes/IN/IPSECKEY.py
@@ -24,7 +24,8 @@ import dns.rdtypes.util
 
 
 class Gateway(dns.rdtypes.util.Gateway):
-    name = 'IPSECKEY gateway'
+    name = "IPSECKEY gateway"
+
 
 @dns.immutable.immutable
 class IPSECKEY(dns.rdata.Rdata):
@@ -33,10 +34,11 @@ class IPSECKEY(dns.rdata.Rdata):
 
     # see: RFC 4025
 
-    __slots__ = ['precedence', 'gateway_type', 'algorithm', 'gateway', 'key']
+    __slots__ = ["precedence", "gateway_type", "algorithm", "gateway", "key"]
 
-    def __init__(self, rdclass, rdtype, precedence, gateway_type, algorithm,
-                 gateway, key):
+    def __init__(
+        self, rdclass, rdtype, precedence, gateway_type, algorithm, gateway, key
+    ):
         super().__init__(rdclass, rdtype)
         gateway = Gateway(gateway_type, gateway)
         self.precedence = self._as_uint8(precedence)
@@ -46,38 +48,45 @@ class IPSECKEY(dns.rdata.Rdata):
         self.key = self._as_bytes(key)
 
     def to_text(self, origin=None, relativize=True, **kw):
-        gateway = Gateway(self.gateway_type, self.gateway).to_text(origin,
-                                                                   relativize)
-        return '%d %d %d %s %s' % (self.precedence, self.gateway_type,
-                                   self.algorithm, gateway,
-                                   dns.rdata._base64ify(self.key, **kw))
+        gateway = Gateway(self.gateway_type, self.gateway).to_text(origin, relativize)
+        return "%d %d %d %s %s" % (
+            self.precedence,
+            self.gateway_type,
+            self.algorithm,
+            gateway,
+            dns.rdata._base64ify(self.key, **kw),
+        )
 
     @classmethod
-    def from_text(cls, rdclass, rdtype, tok, origin=None, relativize=True,
-                  relativize_to=None):
+    def from_text(
+        cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None
+    ):
         precedence = tok.get_uint8()
         gateway_type = tok.get_uint8()
         algorithm = tok.get_uint8()
-        gateway = Gateway.from_text(gateway_type, tok, origin, relativize,
-                                    relativize_to)
+        gateway = Gateway.from_text(
+            gateway_type, tok, origin, relativize, relativize_to
+        )
         b64 = tok.concatenate_remaining_identifiers().encode()
         key = base64.b64decode(b64)
-        return cls(rdclass, rdtype, precedence, gateway_type, algorithm,
-                   gateway.gateway, key)
+        return cls(
+            rdclass, rdtype, precedence, gateway_type, algorithm, gateway.gateway, key
+        )
 
     def _to_wire(self, file, compress=None, origin=None, canonicalize=False):
-        header = struct.pack("!BBB", self.precedence, self.gateway_type,
-                             self.algorithm)
+        header = struct.pack("!BBB", self.precedence, self.gateway_type, self.algorithm)
         file.write(header)
-        Gateway(self.gateway_type, self.gateway).to_wire(file, compress,
-                                                         origin, canonicalize)
+        Gateway(self.gateway_type, self.gateway).to_wire(
+            file, compress, origin, canonicalize
+        )
         file.write(self.key)
 
     @classmethod
     def from_wire_parser(cls, rdclass, rdtype, parser, origin=None):
-        header = parser.get_struct('!BBB')
+        header = parser.get_struct("!BBB")
         gateway_type = header[1]
         gateway = Gateway.from_wire_parser(gateway_type, parser, origin)
         key = parser.get_remaining()
-        return cls(rdclass, rdtype, header[0], gateway_type, header[2],
-                   gateway.gateway, key)
+        return cls(
+            rdclass, rdtype, header[0], gateway_type, header[2], gateway.gateway, key
+        )
diff --git a/lib/dns/rdtypes/IN/NAPTR.py b/lib/dns/rdtypes/IN/NAPTR.py
index b107974d..1f1f5a12 100644
--- a/lib/dns/rdtypes/IN/NAPTR.py
+++ b/lib/dns/rdtypes/IN/NAPTR.py
@@ -27,7 +27,7 @@ import dns.rdtypes.util
 def _write_string(file, s):
     l = len(s)
     assert l < 256
-    file.write(struct.pack('!B', l))
+    file.write(struct.pack("!B", l))
     file.write(s)
 
 
@@ -38,11 +38,11 @@ class NAPTR(dns.rdata.Rdata):
 
     # see: RFC 3403
 
-    __slots__ = ['order', 'preference', 'flags', 'service', 'regexp',
-                 'replacement']
+    __slots__ = ["order", "preference", "flags", "service", "regexp", "replacement"]
 
-    def __init__(self, rdclass, rdtype, order, preference, flags, service,
-                 regexp, replacement):
+    def __init__(
+        self, rdclass, rdtype, order, preference, flags, service, regexp, replacement
+    ):
         super().__init__(rdclass, rdtype)
         self.flags = self._as_bytes(flags, True, 255)
         self.service = self._as_bytes(service, True, 255)
@@ -53,24 +53,28 @@ class NAPTR(dns.rdata.Rdata):
 
     def to_text(self, origin=None, relativize=True, **kw):
         replacement = self.replacement.choose_relativity(origin, relativize)
-        return '%d %d "%s" "%s" "%s" %s' % \
-               (self.order, self.preference,
-                dns.rdata._escapify(self.flags),
-                dns.rdata._escapify(self.service),
-                dns.rdata._escapify(self.regexp),
-                replacement)
+        return '%d %d "%s" "%s" "%s" %s' % (
+            self.order,
+            self.preference,
+            dns.rdata._escapify(self.flags),
+            dns.rdata._escapify(self.service),
+            dns.rdata._escapify(self.regexp),
+            replacement,
+        )
 
     @classmethod
-    def from_text(cls, rdclass, rdtype, tok, origin=None, relativize=True,
-                  relativize_to=None):
+    def from_text(
+        cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None
+    ):
         order = tok.get_uint16()
         preference = tok.get_uint16()
         flags = tok.get_string()
         service = tok.get_string()
         regexp = tok.get_string()
         replacement = tok.get_name(origin, relativize, relativize_to)
-        return cls(rdclass, rdtype, order, preference, flags, service,
-                   regexp, replacement)
+        return cls(
+            rdclass, rdtype, order, preference, flags, service, regexp, replacement
+        )
 
     def _to_wire(self, file, compress=None, origin=None, canonicalize=False):
         two_ints = struct.pack("!HH", self.order, self.preference)
@@ -82,14 +86,22 @@ class NAPTR(dns.rdata.Rdata):
 
     @classmethod
     def from_wire_parser(cls, rdclass, rdtype, parser, origin=None):
-        (order, preference) = parser.get_struct('!HH')
+        (order, preference) = parser.get_struct("!HH")
         strings = []
         for _ in range(3):
             s = parser.get_counted_bytes()
             strings.append(s)
         replacement = parser.get_name(origin)
-        return cls(rdclass, rdtype, order, preference, strings[0], strings[1],
-                   strings[2], replacement)
+        return cls(
+            rdclass,
+            rdtype,
+            order,
+            preference,
+            strings[0],
+            strings[1],
+            strings[2],
+            replacement,
+        )
 
     def _processing_priority(self):
         return (self.order, self.preference)
diff --git a/lib/dns/rdtypes/IN/NSAP.py b/lib/dns/rdtypes/IN/NSAP.py
index 23ae9b1a..be8581e6 100644
--- a/lib/dns/rdtypes/IN/NSAP.py
+++ b/lib/dns/rdtypes/IN/NSAP.py
@@ -30,7 +30,7 @@ class NSAP(dns.rdata.Rdata):
 
     # see: RFC 1706
 
-    __slots__ = ['address']
+    __slots__ = ["address"]
 
     def __init__(self, rdclass, rdtype, address):
         super().__init__(rdclass, rdtype)
@@ -40,14 +40,15 @@ class NSAP(dns.rdata.Rdata):
         return "0x%s" % binascii.hexlify(self.address).decode()
 
     @classmethod
-    def from_text(cls, rdclass, rdtype, tok, origin=None, relativize=True,
-                  relativize_to=None):
+    def from_text(
+        cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None
+    ):
         address = tok.get_string()
-        if address[0:2] != '0x':
-            raise dns.exception.SyntaxError('string does not start with 0x')
-        address = address[2:].replace('.', '')
+        if address[0:2] != "0x":
+            raise dns.exception.SyntaxError("string does not start with 0x")
+        address = address[2:].replace(".", "")
         if len(address) % 2 != 0:
-            raise dns.exception.SyntaxError('hexstring has odd length')
+            raise dns.exception.SyntaxError("hexstring has odd length")
         address = binascii.unhexlify(address.encode())
         return cls(rdclass, rdtype, address)
 
diff --git a/lib/dns/rdtypes/IN/PX.py b/lib/dns/rdtypes/IN/PX.py
index 113d409c..b2216d6b 100644
--- a/lib/dns/rdtypes/IN/PX.py
+++ b/lib/dns/rdtypes/IN/PX.py
@@ -31,7 +31,7 @@ class PX(dns.rdata.Rdata):
 
     # see: RFC 2163
 
-    __slots__ = ['preference', 'map822', 'mapx400']
+    __slots__ = ["preference", "map822", "mapx400"]
 
     def __init__(self, rdclass, rdtype, preference, map822, mapx400):
         super().__init__(rdclass, rdtype)
@@ -42,11 +42,12 @@ class PX(dns.rdata.Rdata):
     def to_text(self, origin=None, relativize=True, **kw):
         map822 = self.map822.choose_relativity(origin, relativize)
         mapx400 = self.mapx400.choose_relativity(origin, relativize)
-        return '%d %s %s' % (self.preference, map822, mapx400)
+        return "%d %s %s" % (self.preference, map822, mapx400)
 
     @classmethod
-    def from_text(cls, rdclass, rdtype, tok, origin=None, relativize=True,
-                  relativize_to=None):
+    def from_text(
+        cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None
+    ):
         preference = tok.get_uint16()
         map822 = tok.get_name(origin, relativize, relativize_to)
         mapx400 = tok.get_name(origin, relativize, relativize_to)
diff --git a/lib/dns/rdtypes/IN/SRV.py b/lib/dns/rdtypes/IN/SRV.py
index 5b5ff422..8b0b6bf7 100644
--- a/lib/dns/rdtypes/IN/SRV.py
+++ b/lib/dns/rdtypes/IN/SRV.py
@@ -31,7 +31,7 @@ class SRV(dns.rdata.Rdata):
 
     # see: RFC 2782
 
-    __slots__ = ['priority', 'weight', 'port', 'target']
+    __slots__ = ["priority", "weight", "port", "target"]
 
     def __init__(self, rdclass, rdtype, priority, weight, port, target):
         super().__init__(rdclass, rdtype)
@@ -42,12 +42,12 @@ class SRV(dns.rdata.Rdata):
 
     def to_text(self, origin=None, relativize=True, **kw):
         target = self.target.choose_relativity(origin, relativize)
-        return '%d %d %d %s' % (self.priority, self.weight, self.port,
-                                target)
+        return "%d %d %d %s" % (self.priority, self.weight, self.port, target)
 
     @classmethod
-    def from_text(cls, rdclass, rdtype, tok, origin=None, relativize=True,
-                  relativize_to=None):
+    def from_text(
+        cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None
+    ):
         priority = tok.get_uint16()
         weight = tok.get_uint16()
         port = tok.get_uint16()
@@ -61,7 +61,7 @@ class SRV(dns.rdata.Rdata):
 
     @classmethod
     def from_wire_parser(cls, rdclass, rdtype, parser, origin=None):
-        (priority, weight, port) = parser.get_struct('!HHH')
+        (priority, weight, port) = parser.get_struct("!HHH")
         target = parser.get_name(origin)
         return cls(rdclass, rdtype, priority, weight, port, target)
 
diff --git a/lib/dns/rdtypes/IN/SVCB.py b/lib/dns/rdtypes/IN/SVCB.py
index 14838e16..9a1ad101 100644
--- a/lib/dns/rdtypes/IN/SVCB.py
+++ b/lib/dns/rdtypes/IN/SVCB.py
@@ -3,6 +3,7 @@
 import dns.rdtypes.svcbbase
 import dns.immutable
 
+
 @dns.immutable.immutable
 class SVCB(dns.rdtypes.svcbbase.SVCBBase):
     """SVCB record"""
diff --git a/lib/dns/rdtypes/IN/WKS.py b/lib/dns/rdtypes/IN/WKS.py
index 264e45d3..a671e203 100644
--- a/lib/dns/rdtypes/IN/WKS.py
+++ b/lib/dns/rdtypes/IN/WKS.py
@@ -23,13 +23,14 @@ import dns.immutable
 import dns.rdata
 
 try:
-    _proto_tcp = socket.getprotobyname('tcp')
-    _proto_udp = socket.getprotobyname('udp')
+    _proto_tcp = socket.getprotobyname("tcp")
+    _proto_udp = socket.getprotobyname("udp")
 except OSError:
     # Fall back to defaults in case /etc/protocols is unavailable.
     _proto_tcp = 6
     _proto_udp = 17
 
+
 @dns.immutable.immutable
 class WKS(dns.rdata.Rdata):
 
@@ -37,7 +38,7 @@ class WKS(dns.rdata.Rdata):
 
     # see: RFC 1035
 
-    __slots__ = ['address', 'protocol', 'bitmap']
+    __slots__ = ["address", "protocol", "bitmap"]
 
     def __init__(self, rdclass, rdtype, address, protocol, bitmap):
         super().__init__(rdclass, rdtype)
@@ -51,12 +52,13 @@ class WKS(dns.rdata.Rdata):
             for j in range(0, 8):
                 if byte & (0x80 >> j):
                     bits.append(str(i * 8 + j))
-        text = ' '.join(bits)
-        return '%s %d %s' % (self.address, self.protocol, text)
+        text = " ".join(bits)
+        return "%s %d %s" % (self.address, self.protocol, text)
 
     @classmethod
-    def from_text(cls, rdclass, rdtype, tok, origin=None, relativize=True,
-                  relativize_to=None):
+    def from_text(
+        cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None
+    ):
         address = tok.get_string()
         protocol = tok.get_string()
         if protocol.isdigit():
@@ -87,7 +89,7 @@ class WKS(dns.rdata.Rdata):
 
     def _to_wire(self, file, compress=None, origin=None, canonicalize=False):
         file.write(dns.ipv4.inet_aton(self.address))
-        protocol = struct.pack('!B', self.protocol)
+        protocol = struct.pack("!B", self.protocol)
         file.write(protocol)
         file.write(self.bitmap)
 
diff --git a/lib/dns/rdtypes/IN/__init__.py b/lib/dns/rdtypes/IN/__init__.py
index d51b99e7..dcec4dd2 100644
--- a/lib/dns/rdtypes/IN/__init__.py
+++ b/lib/dns/rdtypes/IN/__init__.py
@@ -18,18 +18,18 @@
 """Class IN rdata type classes."""
 
 __all__ = [
-    'A',
-    'AAAA',
-    'APL',
-    'DHCID',
-    'HTTPS',
-    'IPSECKEY',
-    'KX',
-    'NAPTR',
-    'NSAP',
-    'NSAP_PTR',
-    'PX',
-    'SRV',
-    'SVCB',
-    'WKS',
+    "A",
+    "AAAA",
+    "APL",
+    "DHCID",
+    "HTTPS",
+    "IPSECKEY",
+    "KX",
+    "NAPTR",
+    "NSAP",
+    "NSAP_PTR",
+    "PX",
+    "SRV",
+    "SVCB",
+    "WKS",
 ]
diff --git a/lib/dns/rdtypes/__init__.py b/lib/dns/rdtypes/__init__.py
index c3af264e..3997f84c 100644
--- a/lib/dns/rdtypes/__init__.py
+++ b/lib/dns/rdtypes/__init__.py
@@ -18,16 +18,16 @@
 """DNS rdata type classes"""
 
 __all__ = [
-    'ANY',
-    'IN',
-    'CH',
-    'dnskeybase',
-    'dsbase',
-    'euibase',
-    'mxbase',
-    'nsbase',
-    'svcbbase',
-    'tlsabase',
-    'txtbase',
-    'util'
+    "ANY",
+    "IN",
+    "CH",
+    "dnskeybase",
+    "dsbase",
+    "euibase",
+    "mxbase",
+    "nsbase",
+    "svcbbase",
+    "tlsabase",
+    "txtbase",
+    "util",
 ]
diff --git a/lib/dns/rdtypes/dnskeybase.py b/lib/dns/rdtypes/dnskeybase.py
index 788bb2bf..1d17f70f 100644
--- a/lib/dns/rdtypes/dnskeybase.py
+++ b/lib/dns/rdtypes/dnskeybase.py
@@ -21,11 +21,12 @@ import struct
 
 import dns.exception
 import dns.immutable
-import dns.dnssec
+import dns.dnssectypes
 import dns.rdata
 
 # wildcard import
-__all__ = ["SEP", "REVOKE", "ZONE"]   # noqa: F822
+__all__ = ["SEP", "REVOKE", "ZONE"]  # noqa: F822
+
 
 class Flag(enum.IntFlag):
     SEP = 0x0001
@@ -38,22 +39,27 @@ class DNSKEYBase(dns.rdata.Rdata):
 
     """Base class for rdata that is like a DNSKEY record"""
 
-    __slots__ = ['flags', 'protocol', 'algorithm', 'key']
+    __slots__ = ["flags", "protocol", "algorithm", "key"]
 
     def __init__(self, rdclass, rdtype, flags, protocol, algorithm, key):
         super().__init__(rdclass, rdtype)
         self.flags = self._as_uint16(flags)
         self.protocol = self._as_uint8(protocol)
-        self.algorithm = dns.dnssec.Algorithm.make(algorithm)
+        self.algorithm = dns.dnssectypes.Algorithm.make(algorithm)
         self.key = self._as_bytes(key)
 
     def to_text(self, origin=None, relativize=True, **kw):
-        return '%d %d %d %s' % (self.flags, self.protocol, self.algorithm,
-                                dns.rdata._base64ify(self.key, **kw))
+        return "%d %d %d %s" % (
+            self.flags,
+            self.protocol,
+            self.algorithm,
+            dns.rdata._base64ify(self.key, **kw),
+        )
 
     @classmethod
-    def from_text(cls, rdclass, rdtype, tok, origin=None, relativize=True,
-                  relativize_to=None):
+    def from_text(
+        cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None
+    ):
         flags = tok.get_uint16()
         protocol = tok.get_uint8()
         algorithm = tok.get_string()
@@ -68,10 +74,10 @@ class DNSKEYBase(dns.rdata.Rdata):
 
     @classmethod
     def from_wire_parser(cls, rdclass, rdtype, parser, origin=None):
-        header = parser.get_struct('!HBB')
+        header = parser.get_struct("!HBB")
         key = parser.get_remaining()
-        return cls(rdclass, rdtype, header[0], header[1], header[2],
-                   key)
+        return cls(rdclass, rdtype, header[0], header[1], header[2], key)
+
 
 ### BEGIN generated Flag constants
 
diff --git a/lib/dns/rdtypes/dnskeybase.pyi b/lib/dns/rdtypes/dnskeybase.pyi
deleted file mode 100644
index 1b999cfd..00000000
--- a/lib/dns/rdtypes/dnskeybase.pyi
+++ /dev/null
@@ -1,38 +0,0 @@
-from typing import Set, Any
-
-SEP : int
-REVOKE : int
-ZONE : int
-
-def flags_to_text_set(flags : int) -> Set[str]:
-    ...
-
-def flags_from_text_set(texts_set) -> int:
-    ...
-
-from .. import rdata
-
-class DNSKEYBase(rdata.Rdata):
-    def __init__(self, rdclass, rdtype, flags, protocol, algorithm, key):
-        self.flags : int
-        self.protocol : int
-        self.key : str
-        self.algorithm : int
-
-    def to_text(self, origin : Any = None, relativize=True, **kw : Any):
-        ...
-
-    @classmethod
-    def from_text(cls, rdclass, rdtype, tok, origin=None, relativize=True,
-                  relativize_to=None):
-        ...
-
-    def _to_wire(self, file, compress=None, origin=None, canonicalize=False):
-        ...
-
-    @classmethod
-    def from_parser(cls, rdclass, rdtype, parser, origin=None):
-        ...
-
-    def flags_to_text_set(self) -> Set[str]:
-        ...
diff --git a/lib/dns/rdtypes/dsbase.py b/lib/dns/rdtypes/dsbase.py
index 0c2e7471..b6032b0f 100644
--- a/lib/dns/rdtypes/dsbase.py
+++ b/lib/dns/rdtypes/dsbase.py
@@ -18,7 +18,7 @@
 import struct
 import binascii
 
-import dns.dnssec
+import dns.dnssectypes
 import dns.immutable
 import dns.rdata
 import dns.rdatatype
@@ -29,9 +29,10 @@ class DSBase(dns.rdata.Rdata):
 
     """Base class for rdata that is like a DS record"""
 
-    __slots__ = ['key_tag', 'algorithm', 'digest_type', 'digest']
+    __slots__ = ["key_tag", "algorithm", "digest_type", "digest"]
 
-    # Digest types registry: https://www.iana.org/assignments/ds-rr-types/ds-rr-types.xhtml
+    # Digest types registry:
+    # https://www.iana.org/assignments/ds-rr-types/ds-rr-types.xhtml
     _digest_length_by_type = {
         1: 20,  # SHA-1, RFC 3658 Sec. 2.4
         2: 32,  # SHA-256, RFC 4509 Sec. 2.2
@@ -39,43 +40,42 @@ class DSBase(dns.rdata.Rdata):
         4: 48,  # SHA-384, RFC 6605 Sec. 2
     }
 
-    def __init__(self, rdclass, rdtype, key_tag, algorithm, digest_type,
-                 digest):
+    def __init__(self, rdclass, rdtype, key_tag, algorithm, digest_type, digest):
         super().__init__(rdclass, rdtype)
         self.key_tag = self._as_uint16(key_tag)
-        self.algorithm = dns.dnssec.Algorithm.make(algorithm)
+        self.algorithm = dns.dnssectypes.Algorithm.make(algorithm)
         self.digest_type = self._as_uint8(digest_type)
         self.digest = self._as_bytes(digest)
         try:
             if len(self.digest) != self._digest_length_by_type[self.digest_type]:
-                raise ValueError('digest length inconsistent with digest type')
+                raise ValueError("digest length inconsistent with digest type")
         except KeyError:
             if self.digest_type == 0:  # reserved, RFC 3658 Sec. 2.4
-                raise ValueError('digest type 0 is reserved')
+                raise ValueError("digest type 0 is reserved")
 
     def to_text(self, origin=None, relativize=True, **kw):
         kw = kw.copy()
-        chunksize = kw.pop('chunksize', 128)
-        return '%d %d %d %s' % (self.key_tag, self.algorithm,
-                                self.digest_type,
-                                dns.rdata._hexify(self.digest,
-                                                  chunksize=chunksize,
-                                                  **kw))
+        chunksize = kw.pop("chunksize", 128)
+        return "%d %d %d %s" % (
+            self.key_tag,
+            self.algorithm,
+            self.digest_type,
+            dns.rdata._hexify(self.digest, chunksize=chunksize, **kw),
+        )
 
     @classmethod
-    def from_text(cls, rdclass, rdtype, tok, origin=None, relativize=True,
-                  relativize_to=None):
+    def from_text(
+        cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None
+    ):
         key_tag = tok.get_uint16()
         algorithm = tok.get_string()
         digest_type = tok.get_uint8()
         digest = tok.concatenate_remaining_identifiers().encode()
         digest = binascii.unhexlify(digest)
-        return cls(rdclass, rdtype, key_tag, algorithm, digest_type,
-                   digest)
+        return cls(rdclass, rdtype, key_tag, algorithm, digest_type, digest)
 
     def _to_wire(self, file, compress=None, origin=None, canonicalize=False):
-        header = struct.pack("!HBB", self.key_tag, self.algorithm,
-                             self.digest_type)
+        header = struct.pack("!HBB", self.key_tag, self.algorithm, self.digest_type)
         file.write(header)
         file.write(self.digest)
 
diff --git a/lib/dns/rdtypes/euibase.py b/lib/dns/rdtypes/euibase.py
index 48b69bd3..e524aea9 100644
--- a/lib/dns/rdtypes/euibase.py
+++ b/lib/dns/rdtypes/euibase.py
@@ -27,7 +27,7 @@ class EUIBase(dns.rdata.Rdata):
 
     # see: rfc7043.txt
 
-    __slots__ = ['eui']
+    __slots__ = ["eui"]
     # define these in subclasses
     # byte_len = 6  # 0123456789ab (in hex)
     # text_len = byte_len * 3 - 1  # 01-23-45-67-89-ab
@@ -36,28 +36,30 @@ class EUIBase(dns.rdata.Rdata):
         super().__init__(rdclass, rdtype)
         self.eui = self._as_bytes(eui)
         if len(self.eui) != self.byte_len:
-            raise dns.exception.FormError('EUI%s rdata has to have %s bytes'
-                                          % (self.byte_len * 8, self.byte_len))
+            raise dns.exception.FormError(
+                "EUI%s rdata has to have %s bytes" % (self.byte_len * 8, self.byte_len)
+            )
 
     def to_text(self, origin=None, relativize=True, **kw):
-        return dns.rdata._hexify(self.eui, chunksize=2, separator=b'-', **kw)
+        return dns.rdata._hexify(self.eui, chunksize=2, separator=b"-", **kw)
 
     @classmethod
-    def from_text(cls, rdclass, rdtype, tok, origin=None, relativize=True,
-                  relativize_to=None):
+    def from_text(
+        cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None
+    ):
         text = tok.get_string()
         if len(text) != cls.text_len:
             raise dns.exception.SyntaxError(
-                'Input text must have %s characters' % cls.text_len)
+                "Input text must have %s characters" % cls.text_len
+            )
         for i in range(2, cls.byte_len * 3 - 1, 3):
-            if text[i] != '-':
-                raise dns.exception.SyntaxError('Dash expected at position %s'
-                                                % i)
-        text = text.replace('-', '')
+            if text[i] != "-":
+                raise dns.exception.SyntaxError("Dash expected at position %s" % i)
+        text = text.replace("-", "")
         try:
             data = binascii.unhexlify(text.encode())
         except (ValueError, TypeError) as ex:
-            raise dns.exception.SyntaxError('Hex decoding error: %s' % str(ex))
+            raise dns.exception.SyntaxError("Hex decoding error: %s" % str(ex))
         return cls(rdclass, rdtype, data)
 
     def _to_wire(self, file, compress=None, origin=None, canonicalize=False):
diff --git a/lib/dns/rdtypes/mxbase.py b/lib/dns/rdtypes/mxbase.py
index 56418234..b4b9b088 100644
--- a/lib/dns/rdtypes/mxbase.py
+++ b/lib/dns/rdtypes/mxbase.py
@@ -31,7 +31,7 @@ class MXBase(dns.rdata.Rdata):
 
     """Base class for rdata that is like an MX record."""
 
-    __slots__ = ['preference', 'exchange']
+    __slots__ = ["preference", "exchange"]
 
     def __init__(self, rdclass, rdtype, preference, exchange):
         super().__init__(rdclass, rdtype)
@@ -40,11 +40,12 @@ class MXBase(dns.rdata.Rdata):
 
     def to_text(self, origin=None, relativize=True, **kw):
         exchange = self.exchange.choose_relativity(origin, relativize)
-        return '%d %s' % (self.preference, exchange)
+        return "%d %s" % (self.preference, exchange)
 
     @classmethod
-    def from_text(cls, rdclass, rdtype, tok, origin=None, relativize=True,
-                  relativize_to=None):
+    def from_text(
+        cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None
+    ):
         preference = tok.get_uint16()
         exchange = tok.get_name(origin, relativize, relativize_to)
         return cls(rdclass, rdtype, preference, exchange)
diff --git a/lib/dns/rdtypes/nsbase.py b/lib/dns/rdtypes/nsbase.py
index b3e25506..ba7a2ab7 100644
--- a/lib/dns/rdtypes/nsbase.py
+++ b/lib/dns/rdtypes/nsbase.py
@@ -28,7 +28,7 @@ class NSBase(dns.rdata.Rdata):
 
     """Base class for rdata that is like an NS record."""
 
-    __slots__ = ['target']
+    __slots__ = ["target"]
 
     def __init__(self, rdclass, rdtype, target):
         super().__init__(rdclass, rdtype)
@@ -39,8 +39,9 @@ class NSBase(dns.rdata.Rdata):
         return str(target)
 
     @classmethod
-    def from_text(cls, rdclass, rdtype, tok, origin=None, relativize=True,
-                  relativize_to=None):
+    def from_text(
+        cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None
+    ):
         target = tok.get_name(origin, relativize, relativize_to)
         return cls(rdclass, rdtype, target)
 
diff --git a/lib/dns/rdtypes/svcbbase.py b/lib/dns/rdtypes/svcbbase.py
index 3362571c..8d6fb1c6 100644
--- a/lib/dns/rdtypes/svcbbase.py
+++ b/lib/dns/rdtypes/svcbbase.py
@@ -63,44 +63,48 @@ def _validate_key(key):
     if isinstance(key, bytes):
         # We decode to latin-1 so we get 0-255 as valid and do NOT interpret
         # UTF-8 sequences
-        key = key.decode('latin-1')
+        key = key.decode("latin-1")
     if isinstance(key, str):
-        if key.lower().startswith('key'):
+        if key.lower().startswith("key"):
             force_generic = True
-            if key[3:].startswith('0') and len(key) != 4:
+            if key[3:].startswith("0") and len(key) != 4:
                 # key has leading zeros
-                raise ValueError('leading zeros in key')
-        key = key.replace('-', '_')
+                raise ValueError("leading zeros in key")
+        key = key.replace("-", "_")
     return (ParamKey.make(key), force_generic)
 
+
 def key_to_text(key):
-    return ParamKey.to_text(key).replace('_', '-').lower()
+    return ParamKey.to_text(key).replace("_", "-").lower()
+
 
 # Like rdata escapify, but escapes ',' too.
 
 _escaped = b'",\\'
 
+
 def _escapify(qstring):
-    text = ''
+    text = ""
     for c in qstring:
         if c in _escaped:
-            text += '\\' + chr(c)
+            text += "\\" + chr(c)
         elif c >= 0x20 and c < 0x7F:
             text += chr(c)
         else:
-            text += '\\%03d' % c
+            text += "\\%03d" % c
     return text
 
+
 def _unescape(value):
-    if value == '':
+    if value == "":
         return value
-    unescaped = b''
+    unescaped = b""
     l = len(value)
     i = 0
     while i < l:
         c = value[i]
         i += 1
-        if c == '\\':
+        if c == "\\":
             if i >= l:  # pragma: no cover   (can't happen via tokenizer get())
                 raise dns.exception.UnexpectedEnd
             c = value[i]
@@ -119,7 +123,7 @@ def _unescape(value):
                 codepoint = int(c) * 100 + int(c2) * 10 + int(c3)
                 if codepoint > 255:
                     raise dns.exception.SyntaxError
-                unescaped += b'%c' % (codepoint)
+                unescaped += b"%c" % (codepoint)
                 continue
         unescaped += c.encode()
     return unescaped
@@ -129,21 +133,21 @@ def _split(value):
     l = len(value)
     i = 0
     items = []
-    unescaped = b''
+    unescaped = b""
     while i < l:
         c = value[i]
         i += 1
-        if c == ord('\\'):
+        if c == ord("\\"):
             if i >= l:  # pragma: no cover   (can't happen via tokenizer get())
                 raise dns.exception.UnexpectedEnd
             c = value[i]
             i += 1
-            unescaped += b'%c' % (c)
-        elif c == ord(','):
+            unescaped += b"%c" % (c)
+        elif c == ord(","):
             items.append(unescaped)
-            unescaped = b''
+            unescaped = b""
         else:
-            unescaped += b'%c' % (c)
+            unescaped += b"%c" % (c)
     items.append(unescaped)
     return items
 
@@ -159,8 +163,8 @@ class Param:
 
 @dns.immutable.immutable
 class GenericParam(Param):
-    """Generic SVCB parameter
-    """
+    """Generic SVCB parameter"""
+
     def __init__(self, value):
         self.value = dns.rdata.Rdata._as_bytes(value, True)
 
@@ -198,19 +202,19 @@ class MandatoryParam(Param):
         prior_k = None
         for k in keys:
             if k == prior_k:
-                raise ValueError(f'duplicate key {k:d}')
+                raise ValueError(f"duplicate key {k:d}")
             prior_k = k
             if k == ParamKey.MANDATORY:
-                raise ValueError('listed the mandatory key as mandatory')
+                raise ValueError("listed the mandatory key as mandatory")
         self.keys = tuple(keys)
 
     @classmethod
     def from_value(cls, value):
-        keys = [k.encode() for k in value.split(',')]
+        keys = [k.encode() for k in value.split(",")]
         return cls(keys)
 
     def to_text(self):
-        return '"' + ','.join([key_to_text(key) for key in self.keys]) + '"'
+        return '"' + ",".join([key_to_text(key) for key in self.keys]) + '"'
 
     @classmethod
     def from_wire_parser(cls, parser, origin=None):  # pylint: disable=W0613
@@ -219,28 +223,29 @@ class MandatoryParam(Param):
         while parser.remaining() > 0:
             key = parser.get_uint16()
             if key < last_key:
-                raise dns.exception.FormError('manadatory keys not ascending')
+                raise dns.exception.FormError("manadatory keys not ascending")
             last_key = key
             keys.append(key)
         return cls(keys)
 
     def to_wire(self, file, origin=None):  # pylint: disable=W0613
         for key in self.keys:
-            file.write(struct.pack('!H', key))
+            file.write(struct.pack("!H", key))
 
 
 @dns.immutable.immutable
 class ALPNParam(Param):
     def __init__(self, ids):
         self.ids = dns.rdata.Rdata._as_tuple(
-            ids, lambda x: dns.rdata.Rdata._as_bytes(x, True, 255, False))
+            ids, lambda x: dns.rdata.Rdata._as_bytes(x, True, 255, False)
+        )
 
     @classmethod
     def from_value(cls, value):
         return cls(_split(_unescape(value)))
 
     def to_text(self):
-        value = ','.join([_escapify(id) for id in self.ids])
+        value = ",".join([_escapify(id) for id in self.ids])
         return '"' + dns.rdata._escapify(value.encode()) + '"'
 
     @classmethod
@@ -253,7 +258,7 @@ class ALPNParam(Param):
 
     def to_wire(self, file, origin=None):  # pylint: disable=W0613
         for id in self.ids:
-            file.write(struct.pack('!B', len(id)))
+            file.write(struct.pack("!B", len(id)))
             file.write(id)
 
 
@@ -269,10 +274,10 @@ class NoDefaultALPNParam(Param):
 
     @classmethod
     def from_value(cls, value):
-        if value is None or value == '':
+        if value is None or value == "":
             return None
         else:
-            raise ValueError('no-default-alpn with non-empty value')
+            raise ValueError("no-default-alpn with non-empty value")
 
     def to_text(self):
         raise NotImplementedError  # pragma: no cover
@@ -306,22 +311,23 @@ class PortParam(Param):
         return cls(port)
 
     def to_wire(self, file, origin=None):  # pylint: disable=W0613
-        file.write(struct.pack('!H', self.port))
+        file.write(struct.pack("!H", self.port))
 
 
 @dns.immutable.immutable
 class IPv4HintParam(Param):
     def __init__(self, addresses):
         self.addresses = dns.rdata.Rdata._as_tuple(
-            addresses, dns.rdata.Rdata._as_ipv4_address)
+            addresses, dns.rdata.Rdata._as_ipv4_address
+        )
 
     @classmethod
     def from_value(cls, value):
-        addresses = value.split(',')
+        addresses = value.split(",")
         return cls(addresses)
 
     def to_text(self):
-        return '"' + ','.join(self.addresses) + '"'
+        return '"' + ",".join(self.addresses) + '"'
 
     @classmethod
     def from_wire_parser(cls, parser, origin=None):  # pylint: disable=W0613
@@ -340,15 +346,16 @@ class IPv4HintParam(Param):
 class IPv6HintParam(Param):
     def __init__(self, addresses):
         self.addresses = dns.rdata.Rdata._as_tuple(
-            addresses, dns.rdata.Rdata._as_ipv6_address)
+            addresses, dns.rdata.Rdata._as_ipv6_address
+        )
 
     @classmethod
     def from_value(cls, value):
-        addresses = value.split(',')
+        addresses = value.split(",")
         return cls(addresses)
 
     def to_text(self):
-        return '"' + ','.join(self.addresses) + '"'
+        return '"' + ",".join(self.addresses) + '"'
 
     @classmethod
     def from_wire_parser(cls, parser, origin=None):  # pylint: disable=W0613
@@ -370,13 +377,13 @@ class ECHParam(Param):
 
     @classmethod
     def from_value(cls, value):
-        if '\\' in value:
-            raise ValueError('escape in ECH value')
+        if "\\" in value:
+            raise ValueError("escape in ECH value")
         value = base64.b64decode(value.encode())
         return cls(value)
 
     def to_text(self):
-        b64 = base64.b64encode(self.ech).decode('ascii')
+        b64 = base64.b64encode(self.ech).decode("ascii")
         return f'"{b64}"'
 
     @classmethod
@@ -407,7 +414,7 @@ def _validate_and_define(params, key, value):
     emptiness = cls.emptiness()
     if value is None:
         if emptiness == Emptiness.NEVER:
-            raise SyntaxError('value cannot be empty')
+            raise SyntaxError("value cannot be empty")
         value = cls.from_value(value)
     else:
         if force_generic:
@@ -422,9 +429,9 @@ class SVCBBase(dns.rdata.Rdata):
 
     """Base class for SVCB-like records"""
 
-    # see: draft-ietf-dnsop-svcb-https-01
+    # see: draft-ietf-dnsop-svcb-https-11
 
-    __slots__ = ['priority', 'target', 'params']
+    __slots__ = ["priority", "target", "params"]
 
     def __init__(self, rdclass, rdtype, priority, target, params):
         super().__init__(rdclass, rdtype)
@@ -433,7 +440,7 @@ class SVCBBase(dns.rdata.Rdata):
         for k, v in params.items():
             k = ParamKey.make(k)
             if not isinstance(v, Param) and v is not None:
-                raise ValueError("not a Param")
+                raise ValueError(f"{k:d} not a Param")
         self.params = dns.immutable.Dict(params)
         # Make sure any parameter listed as mandatory is present in the
         # record.
@@ -443,12 +450,11 @@ class SVCBBase(dns.rdata.Rdata):
                 # Note we have to say "not in" as we have None as a value
                 # so a get() and a not None test would be wrong.
                 if key not in params:
-                    raise ValueError(f'key {key:d} declared mandatory but not '
-                                     'present')
+                    raise ValueError(f"key {key:d} declared mandatory but not present")
         # The no-default-alpn parameter requires the alpn parameter.
         if ParamKey.NO_DEFAULT_ALPN in params:
             if ParamKey.ALPN not in params:
-                raise ValueError('no-default-alpn present, but alpn missing')
+                raise ValueError("no-default-alpn present, but alpn missing")
 
     def to_text(self, origin=None, relativize=True, **kw):
         target = self.target.choose_relativity(origin, relativize)
@@ -458,23 +464,24 @@ class SVCBBase(dns.rdata.Rdata):
             if value is None:
                 params.append(key_to_text(key))
             else:
-                kv = key_to_text(key) + '=' + value.to_text()
+                kv = key_to_text(key) + "=" + value.to_text()
                 params.append(kv)
         if len(params) > 0:
-            space = ' '
+            space = " "
         else:
-            space = ''
-        return '%d %s%s%s' % (self.priority, target, space, ' '.join(params))
+            space = ""
+        return "%d %s%s%s" % (self.priority, target, space, " ".join(params))
 
     @classmethod
-    def from_text(cls, rdclass, rdtype, tok, origin=None, relativize=True,
-                  relativize_to=None):
+    def from_text(
+        cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None
+    ):
         priority = tok.get_uint16()
         target = tok.get_name(origin, relativize, relativize_to)
         if priority == 0:
             token = tok.get()
             if not token.is_eol_or_eof():
-                raise SyntaxError('parameters in AliasMode')
+                raise SyntaxError("parameters in AliasMode")
             tok.unget(token)
         params = {}
         while True:
@@ -483,20 +490,20 @@ class SVCBBase(dns.rdata.Rdata):
                 tok.unget(token)
                 break
             if token.ttype != dns.tokenizer.IDENTIFIER:
-                raise SyntaxError('parameter is not an identifier')
-            equals = token.value.find('=')
+                raise SyntaxError("parameter is not an identifier")
+            equals = token.value.find("=")
             if equals == len(token.value) - 1:
                 # 'key=', so next token should be a quoted string without
                 # any intervening whitespace.
                 key = token.value[:-1]
                 token = tok.get(want_leading=True)
                 if token.ttype != dns.tokenizer.QUOTED_STRING:
-                    raise SyntaxError('whitespace after =')
+                    raise SyntaxError("whitespace after =")
                 value = token.value
             elif equals > 0:
                 # key=value
                 key = token.value[:equals]
-                value = token.value[equals + 1:]
+                value = token.value[equals + 1 :]
             elif equals == 0:
                 # =key
                 raise SyntaxError('parameter cannot start with "="')
@@ -532,13 +539,13 @@ class SVCBBase(dns.rdata.Rdata):
         priority = parser.get_uint16()
         target = parser.get_name(origin)
         if priority == 0 and parser.remaining() != 0:
-            raise dns.exception.FormError('parameters in AliasMode')
+            raise dns.exception.FormError("parameters in AliasMode")
         params = {}
         prior_key = -1
         while parser.remaining() > 0:
             key = parser.get_uint16()
             if key < prior_key:
-                raise dns.exception.FormError('keys not in order')
+                raise dns.exception.FormError("keys not in order")
             prior_key = key
             vlen = parser.get_uint16()
             pcls = _class_for_key.get(key, GenericParam)
diff --git a/lib/dns/rdtypes/tlsabase.py b/lib/dns/rdtypes/tlsabase.py
index 786fca55..a3fdc354 100644
--- a/lib/dns/rdtypes/tlsabase.py
+++ b/lib/dns/rdtypes/tlsabase.py
@@ -30,10 +30,9 @@ class TLSABase(dns.rdata.Rdata):
 
     # see: RFC 6698
 
-    __slots__ = ['usage', 'selector', 'mtype', 'cert']
+    __slots__ = ["usage", "selector", "mtype", "cert"]
 
-    def __init__(self, rdclass, rdtype, usage, selector,
-                 mtype, cert):
+    def __init__(self, rdclass, rdtype, usage, selector, mtype, cert):
         super().__init__(rdclass, rdtype)
         self.usage = self._as_uint8(usage)
         self.selector = self._as_uint8(selector)
@@ -42,17 +41,18 @@ class TLSABase(dns.rdata.Rdata):
 
     def to_text(self, origin=None, relativize=True, **kw):
         kw = kw.copy()
-        chunksize = kw.pop('chunksize', 128)
-        return '%d %d %d %s' % (self.usage,
-                                self.selector,
-                                self.mtype,
-                                dns.rdata._hexify(self.cert,
-                                                  chunksize=chunksize,
-                                                  **kw))
+        chunksize = kw.pop("chunksize", 128)
+        return "%d %d %d %s" % (
+            self.usage,
+            self.selector,
+            self.mtype,
+            dns.rdata._hexify(self.cert, chunksize=chunksize, **kw),
+        )
 
     @classmethod
-    def from_text(cls, rdclass, rdtype, tok, origin=None, relativize=True,
-                  relativize_to=None):
+    def from_text(
+        cls, rdclass, rdtype, tok, origin=None, relativize=True, relativize_to=None
+    ):
         usage = tok.get_uint8()
         selector = tok.get_uint8()
         mtype = tok.get_uint8()
diff --git a/lib/dns/rdtypes/txtbase.py b/lib/dns/rdtypes/txtbase.py
index 68071ee0..d4cb9bb2 100644
--- a/lib/dns/rdtypes/txtbase.py
+++ b/lib/dns/rdtypes/txtbase.py
@@ -17,6 +17,8 @@
 
 """TXT-like base class."""
 
+from typing import Any, Dict, Iterable, Optional, Tuple, Union
+
 import struct
 
 import dns.exception
@@ -30,9 +32,14 @@ class TXTBase(dns.rdata.Rdata):
 
     """Base class for rdata that is like a TXT record (see RFC 1035)."""
 
-    __slots__ = ['strings']
+    __slots__ = ["strings"]
 
-    def __init__(self, rdclass, rdtype, strings):
+    def __init__(
+        self,
+        rdclass: dns.rdataclass.RdataClass,
+        rdtype: dns.rdatatype.RdataType,
+        strings: Iterable[Union[bytes, str]],
+    ):
         """Initialize a TXT-like rdata.
 
         *rdclass*, an ``int`` is the rdataclass of the Rdata.
@@ -42,27 +49,41 @@ class TXTBase(dns.rdata.Rdata):
         *strings*, a tuple of ``bytes``
         """
         super().__init__(rdclass, rdtype)
-        self.strings = self._as_tuple(strings,
-                                      lambda x: self._as_bytes(x, True, 255))
+        self.strings: Tuple[bytes] = self._as_tuple(
+            strings, lambda x: self._as_bytes(x, True, 255)
+        )
 
-    def to_text(self, origin=None, relativize=True, **kw):
-        txt = ''
-        prefix = ''
+    def to_text(
+        self,
+        origin: Optional[dns.name.Name] = None,
+        relativize: bool = True,
+        **kw: Dict[str, Any]
+    ) -> str:
+        txt = ""
+        prefix = ""
         for s in self.strings:
             txt += '{}"{}"'.format(prefix, dns.rdata._escapify(s))
-            prefix = ' '
+            prefix = " "
         return txt
 
     @classmethod
-    def from_text(cls, rdclass, rdtype, tok, origin=None, relativize=True,
-                  relativize_to=None):
+    def from_text(
+        cls,
+        rdclass: dns.rdataclass.RdataClass,
+        rdtype: dns.rdatatype.RdataType,
+        tok: dns.tokenizer.Tokenizer,
+        origin: Optional[dns.name.Name] = None,
+        relativize: bool = True,
+        relativize_to: Optional[dns.name.Name] = None,
+    ) -> dns.rdata.Rdata:
         strings = []
         for token in tok.get_remaining():
             token = token.unescape_to_bytes()
             # The 'if' below is always true in the current code, but we
             # are leaving this check in in case things change some day.
-            if not (token.is_quoted_string() or
-                    token.is_identifier()):  # pragma: no cover
+            if not (
+                token.is_quoted_string() or token.is_identifier()
+            ):  # pragma: no cover
                 raise dns.exception.SyntaxError("expected a string")
             if len(token.value) > 255:
                 raise dns.exception.SyntaxError("string too long")
@@ -75,7 +96,7 @@ class TXTBase(dns.rdata.Rdata):
         for s in self.strings:
             l = len(s)
             assert l < 256
-            file.write(struct.pack('!B', l))
+            file.write(struct.pack("!B", l))
             file.write(s)
 
     @classmethod
diff --git a/lib/dns/rdtypes/txtbase.pyi b/lib/dns/rdtypes/txtbase.pyi
deleted file mode 100644
index f8d5df98..00000000
--- a/lib/dns/rdtypes/txtbase.pyi
+++ /dev/null
@@ -1,12 +0,0 @@
-import typing
-from .. import rdata
-
-class TXTBase(rdata.Rdata):
-    strings: typing.Tuple[bytes, ...]
-
-    def __init__(self, rdclass: int, rdtype: int, strings: typing.Iterable[bytes]) -> None:
-        ...
-    def to_text(self, origin: typing.Any, relativize: bool, **kw: typing.Any) -> str:
-        ...
-class TXT(TXTBase):
-    ...
diff --git a/lib/dns/rdtypes/util.py b/lib/dns/rdtypes/util.py
index 9bf8f7e9..74596f05 100644
--- a/lib/dns/rdtypes/util.py
+++ b/lib/dns/rdtypes/util.py
@@ -28,6 +28,7 @@ import dns.rdata
 
 class Gateway:
     """A helper class for the IPSECKEY gateway and AMTRELAY relay fields"""
+
     name = ""
 
     def __init__(self, type, gateway=None):
@@ -67,15 +68,17 @@ class Gateway:
             raise ValueError(self._invalid_type(self.type))  # pragma: no cover
 
     @classmethod
-    def from_text(cls, gateway_type, tok, origin=None, relativize=True,
-                  relativize_to=None):
+    def from_text(
+        cls, gateway_type, tok, origin=None, relativize=True, relativize_to=None
+    ):
         if gateway_type in (0, 1, 2):
             gateway = tok.get_string()
         elif gateway_type == 3:
             gateway = tok.get_name(origin, relativize, relativize_to)
         else:
             raise dns.exception.SyntaxError(
-                cls._invalid_type(gateway_type))  # pragma: no cover
+                cls._invalid_type(gateway_type)
+            )  # pragma: no cover
         return cls(gateway_type, gateway)
 
     # pylint: disable=unused-argument
@@ -90,6 +93,7 @@ class Gateway:
             self.gateway.to_wire(file, None, origin, False)
         else:
             raise ValueError(self._invalid_type(self.type))  # pragma: no cover
+
     # pylint: enable=unused-argument
 
     @classmethod
@@ -109,6 +113,7 @@ class Gateway:
 
 class Bitmap:
     """A helper class for the NSEC/NSEC3/CSYNC type bitmaps"""
+
     type_name = ""
 
     def __init__(self, windows=None):
@@ -136,7 +141,7 @@ class Bitmap:
                     if byte & (0x80 >> j):
                         rdtype = window * 256 + i * 8 + j
                         bits.append(dns.rdatatype.to_text(rdtype))
-            text += (' ' + ' '.join(bits))
+            text += " " + " ".join(bits)
         return text
 
     @classmethod
@@ -151,7 +156,7 @@ class Bitmap:
         window = 0
         octets = 0
         prior_rdtype = 0
-        bitmap = bytearray(b'\0' * 32)
+        bitmap = bytearray(b"\0" * 32)
         windows = []
         for rdtype in rdtypes:
             if rdtype == prior_rdtype:
@@ -161,7 +166,7 @@ class Bitmap:
             if new_window != window:
                 if octets != 0:
                     windows.append((window, bytes(bitmap[0:octets])))
-                bitmap = bytearray(b'\0' * 32)
+                bitmap = bytearray(b"\0" * 32)
                 window = new_window
             offset = rdtype % 256
             byte = offset // 8
@@ -174,7 +179,7 @@ class Bitmap:
 
     def to_wire(self, file):
         for (window, bitmap) in self.windows:
-            file.write(struct.pack('!BB', window, len(bitmap)))
+            file.write(struct.pack("!BB", window, len(bitmap)))
             file.write(bitmap)
 
     @classmethod
@@ -193,6 +198,7 @@ def _priority_table(items):
         by_priority[rdata._processing_priority()].append(rdata)
     return by_priority
 
+
 def priority_processing_order(iterable):
     items = list(iterable)
     if len(items) == 1:
@@ -205,8 +211,10 @@ def priority_processing_order(iterable):
         ordered.extend(rdatas)
     return ordered
 
+
 _no_weight = 0.1
 
+
 def weighted_processing_order(iterable):
     items = list(iterable)
     if len(items) == 1:
@@ -215,8 +223,7 @@ def weighted_processing_order(iterable):
     ordered = []
     for k in sorted(by_priority.keys()):
         rdatas = by_priority[k]
-        total = sum(rdata._processing_weight() or _no_weight
-                    for rdata in rdatas)
+        total = sum(rdata._processing_weight() or _no_weight for rdata in rdatas)
         while len(rdatas) > 1:
             r = random.uniform(0, total)
             for (n, rdata) in enumerate(rdatas):
@@ -230,15 +237,16 @@ def weighted_processing_order(iterable):
         ordered.append(rdatas[0])
     return ordered
 
+
 def parse_formatted_hex(formatted, num_chunks, chunk_size, separator):
     if len(formatted) != num_chunks * (chunk_size + 1) - 1:
-        raise ValueError('invalid formatted hex string')
-    value = b''
+        raise ValueError("invalid formatted hex string")
+    value = b""
     for _ in range(num_chunks):
         chunk = formatted[0:chunk_size]
-        value += int(chunk, 16).to_bytes(chunk_size // 2, 'big')
+        value += int(chunk, 16).to_bytes(chunk_size // 2, "big")
         formatted = formatted[chunk_size:]
         if len(formatted) > 0 and formatted[0] != separator:
-            raise ValueError('invalid formatted hex string')
+            raise ValueError("invalid formatted hex string")
         formatted = formatted[1:]
     return value
diff --git a/lib/dns/renderer.py b/lib/dns/renderer.py
index 4e4391cd..3c495f61 100644
--- a/lib/dns/renderer.py
+++ b/lib/dns/renderer.py
@@ -48,13 +48,17 @@ class Renderer:
         r.add_rrset(dns.renderer.ANSWER, rrset_1)
         r.add_rrset(dns.renderer.ANSWER, rrset_2)
         r.add_rrset(dns.renderer.AUTHORITY, ns_rrset)
-        r.add_edns(0, 0, 4096)
         r.add_rrset(dns.renderer.ADDITIONAL, ad_rrset_1)
         r.add_rrset(dns.renderer.ADDITIONAL, ad_rrset_2)
+        r.add_edns(0, 0, 4096)
         r.write_header()
         r.add_tsig(keyname, secret, 300, 1, 0, '', request_mac)
         wire = r.get_wire()
 
+    If padding is going to be used, then the OPT record MUST be
+    written after everything else in the additional section except for
+    the TSIG (if any).
+
     output, an io.BytesIO, where rendering is written
 
     id: the message id
@@ -88,8 +92,10 @@ class Renderer:
         self.compress = {}
         self.section = QUESTION
         self.counts = [0, 0, 0, 0]
-        self.output.write(b'\x00' * 12)
-        self.mac = ''
+        self.output.write(b"\x00" * 12)
+        self.mac = ""
+        self.reserved = 0
+        self.was_padded = False
 
     def _rollback(self, where):
         """Truncate the output buffer at offset *where*, and remove any
@@ -160,21 +166,52 @@ class Renderer:
 
         self._set_section(section)
         with self._track_size():
-            n = rdataset.to_wire(name, self.output, self.compress, self.origin,
-                                 **kw)
+            n = rdataset.to_wire(name, self.output, self.compress, self.origin, **kw)
         self.counts[section] += n
 
+    def add_opt(self, opt, pad=0, opt_size=0, tsig_size=0):
+        """Add *opt* to the additional section, applying padding if desired.  The
+        padding will take the specified precomputed OPT size and TSIG size into
+        account.
+
+        Note that we don't have reliable way of knowing how big a GSS-TSIG digest
+        might be, so we we might not get an even multiple of the pad in that case."""
+        if pad:
+            ttl = opt.ttl
+            assert opt_size >= 11
+            opt_rdata = opt[0]
+            size_without_padding = self.output.tell() + opt_size + tsig_size
+            remainder = size_without_padding % pad
+            if remainder:
+                pad = b"\x00" * (pad - remainder)
+            else:
+                pad = b""
+            options = list(opt_rdata.options)
+            options.append(dns.edns.GenericOption(dns.edns.OptionType.PADDING, pad))
+            opt = dns.message.Message._make_opt(ttl, opt_rdata.rdclass, options)
+            self.was_padded = True
+        self.add_rrset(ADDITIONAL, opt)
+
     def add_edns(self, edns, ednsflags, payload, options=None):
         """Add an EDNS OPT record to the message."""
 
         # make sure the EDNS version in ednsflags agrees with edns
         ednsflags &= 0xFF00FFFF
-        ednsflags |= (edns << 16)
+        ednsflags |= edns << 16
         opt = dns.message.Message._make_opt(ednsflags, payload, options)
-        self.add_rrset(ADDITIONAL, opt)
+        self.add_opt(opt)
 
-    def add_tsig(self, keyname, secret, fudge, id, tsig_error, other_data,
-                 request_mac, algorithm=dns.tsig.default_algorithm):
+    def add_tsig(
+        self,
+        keyname,
+        secret,
+        fudge,
+        id,
+        tsig_error,
+        other_data,
+        request_mac,
+        algorithm=dns.tsig.default_algorithm,
+    ):
         """Add a TSIG signature to the message."""
 
         s = self.output.getvalue()
@@ -183,15 +220,24 @@ class Renderer:
             key = secret
         else:
             key = dns.tsig.Key(keyname, secret, algorithm)
-        tsig = dns.message.Message._make_tsig(keyname, algorithm, 0, fudge,
-                                              b'', id, tsig_error, other_data)
-        (tsig, _) = dns.tsig.sign(s, key, tsig[0], int(time.time()),
-                                  request_mac)
+        tsig = dns.message.Message._make_tsig(
+            keyname, algorithm, 0, fudge, b"", id, tsig_error, other_data
+        )
+        (tsig, _) = dns.tsig.sign(s, key, tsig[0], int(time.time()), request_mac)
         self._write_tsig(tsig, keyname)
 
-    def add_multi_tsig(self, ctx, keyname, secret, fudge, id, tsig_error,
-                       other_data, request_mac,
-                       algorithm=dns.tsig.default_algorithm):
+    def add_multi_tsig(
+        self,
+        ctx,
+        keyname,
+        secret,
+        fudge,
+        id,
+        tsig_error,
+        other_data,
+        request_mac,
+        algorithm=dns.tsig.default_algorithm,
+    ):
         """Add a TSIG signature to the message. Unlike add_tsig(), this can be
         used for a series of consecutive DNS envelopes, e.g. for a zone
         transfer over TCP [RFC2845, 4.4].
@@ -206,28 +252,35 @@ class Renderer:
             key = secret
         else:
             key = dns.tsig.Key(keyname, secret, algorithm)
-        tsig = dns.message.Message._make_tsig(keyname, algorithm, 0, fudge,
-                                              b'', id, tsig_error, other_data)
-        (tsig, ctx) = dns.tsig.sign(s, key, tsig[0], int(time.time()),
-                                    request_mac, ctx, True)
+        tsig = dns.message.Message._make_tsig(
+            keyname, algorithm, 0, fudge, b"", id, tsig_error, other_data
+        )
+        (tsig, ctx) = dns.tsig.sign(
+            s, key, tsig[0], int(time.time()), request_mac, ctx, True
+        )
         self._write_tsig(tsig, keyname)
         return ctx
 
     def _write_tsig(self, tsig, keyname):
+        if self.was_padded:
+            compress = None
+        else:
+            compress = self.compress
         self._set_section(ADDITIONAL)
         with self._track_size():
-            keyname.to_wire(self.output, self.compress, self.origin)
-            self.output.write(struct.pack('!HHIH', dns.rdatatype.TSIG,
-                                          dns.rdataclass.ANY, 0, 0))
+            keyname.to_wire(self.output, compress, self.origin)
+            self.output.write(
+                struct.pack("!HHIH", dns.rdatatype.TSIG, dns.rdataclass.ANY, 0, 0)
+            )
             rdata_start = self.output.tell()
             tsig.to_wire(self.output)
 
         after = self.output.tell()
         self.output.seek(rdata_start - 2)
-        self.output.write(struct.pack('!H', after - rdata_start))
+        self.output.write(struct.pack("!H", after - rdata_start))
         self.counts[ADDITIONAL] += 1
         self.output.seek(10)
-        self.output.write(struct.pack('!H', self.counts[ADDITIONAL]))
+        self.output.write(struct.pack("!H", self.counts[ADDITIONAL]))
         self.output.seek(0, io.SEEK_END)
 
     def write_header(self):
@@ -239,12 +292,34 @@ class Renderer:
         """
 
         self.output.seek(0)
-        self.output.write(struct.pack('!HHHHHH', self.id, self.flags,
-                                      self.counts[0], self.counts[1],
-                                      self.counts[2], self.counts[3]))
+        self.output.write(
+            struct.pack(
+                "!HHHHHH",
+                self.id,
+                self.flags,
+                self.counts[0],
+                self.counts[1],
+                self.counts[2],
+                self.counts[3],
+            )
+        )
         self.output.seek(0, io.SEEK_END)
 
     def get_wire(self):
         """Return the wire format message."""
 
         return self.output.getvalue()
+
+    def reserve(self, size: int) -> None:
+        """Reserve *size* bytes."""
+        if size < 0:
+            raise ValueError("reserved amount must be non-negative")
+        if size > self.max_size:
+            raise ValueError("cannot reserve more than the maximum size")
+        self.reserved += size
+        self.max_size -= size
+
+    def release_reserved(self) -> None:
+        """Release the reserved bytes."""
+        self.max_size += self.reserved
+        self.reserved = 0
diff --git a/lib/dns/resolver.py b/lib/dns/resolver.py
index 7da7a613..a5b66c1d 100644
--- a/lib/dns/resolver.py
+++ b/lib/dns/resolver.py
@@ -16,19 +16,20 @@
 # OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 
 """DNS stub resolver."""
+
+from typing import Any, Dict, List, Optional, Tuple, Union
+
 from urllib.parse import urlparse
 import contextlib
 import socket
 import sys
+import threading
 import time
 import random
 import warnings
-try:
-    import threading as _threading
-except ImportError:  # pragma: no cover
-    import dummy_threading as _threading    # type: ignore
 
 import dns.exception
+import dns.edns
 import dns.flags
 import dns.inet
 import dns.ipv4
@@ -42,18 +43,24 @@ import dns.rdatatype
 import dns.reversename
 import dns.tsig
 
-if sys.platform == 'win32':
+if sys.platform == "win32":
     import dns.win32util
 
+
 class NXDOMAIN(dns.exception.DNSException):
     """The DNS query name does not exist."""
-    supp_kwargs = {'qnames', 'responses'}
+
+    supp_kwargs = {"qnames", "responses"}
     fmt = None  # we have our own __str__ implementation
 
     # pylint: disable=arguments-differ
 
-    def _check_kwargs(self, qnames,
-                      responses=None):
+    # We do this as otherwise mypy complains about unexpected keyword argument
+    # idna_exception
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+
+    def _check_kwargs(self, qnames, responses=None):
         if not isinstance(qnames, (list, tuple, set)):
             raise AttributeError("qnames must be a list, tuple or set")
         if len(qnames) == 0:
@@ -66,23 +73,23 @@ class NXDOMAIN(dns.exception.DNSException):
         return kwargs
 
     def __str__(self):
-        if 'qnames' not in self.kwargs:
+        if "qnames" not in self.kwargs:
             return super().__str__()
-        qnames = self.kwargs['qnames']
+        qnames = self.kwargs["qnames"]
         if len(qnames) > 1:
-            msg = 'None of DNS query names exist'
+            msg = "None of DNS query names exist"
         else:
-            msg = 'The DNS query name does not exist'
-        qnames = ', '.join(map(str, qnames))
+            msg = "The DNS query name does not exist"
+        qnames = ", ".join(map(str, qnames))
         return "{}: {}".format(msg, qnames)
 
     @property
     def canonical_name(self):
         """Return the unresolved canonical name."""
-        if 'qnames' not in self.kwargs:
+        if "qnames" not in self.kwargs:
             raise TypeError("parametrized exception required")
-        for qname in self.kwargs['qnames']:
-            response = self.kwargs['responses'][qname]
+        for qname in self.kwargs["qnames"]:
+            response = self.kwargs["responses"][qname]
             try:
                 cname = response.canonical_name()
                 if cname != qname:
@@ -91,14 +98,14 @@ class NXDOMAIN(dns.exception.DNSException):
                 # We can just eat this exception as it means there was
                 # something wrong with the response.
                 pass
-        return self.kwargs['qnames'][0]
+        return self.kwargs["qnames"][0]
 
     def __add__(self, e_nx):
         """Augment by results from another NXDOMAIN exception."""
-        qnames0 = list(self.kwargs.get('qnames', []))
-        responses0 = dict(self.kwargs.get('responses', {}))
-        responses1 = e_nx.kwargs.get('responses', {})
-        for qname1 in e_nx.kwargs.get('qnames', []):
+        qnames0 = list(self.kwargs.get("qnames", []))
+        responses0 = dict(self.kwargs.get("responses", {}))
+        responses1 = e_nx.kwargs.get("responses", {})
+        for qname1 in e_nx.kwargs.get("qnames", []):
             if qname1 not in qnames0:
                 qnames0.append(qname1)
             if qname1 in responses1:
@@ -110,7 +117,7 @@ class NXDOMAIN(dns.exception.DNSException):
 
         Returns a list of ``dns.name.Name``.
         """
-        return self.kwargs['qnames']
+        return self.kwargs["qnames"]
 
     def responses(self):
         """A map from queried names to their NXDOMAIN responses.
@@ -118,26 +125,34 @@ class NXDOMAIN(dns.exception.DNSException):
         Returns a dict mapping a ``dns.name.Name`` to a
         ``dns.message.Message``.
         """
-        return self.kwargs['responses']
+        return self.kwargs["responses"]
 
     def response(self, qname):
         """The response for query *qname*.
 
         Returns a ``dns.message.Message``.
         """
-        return self.kwargs['responses'][qname]
+        return self.kwargs["responses"][qname]
 
 
 class YXDOMAIN(dns.exception.DNSException):
     """The DNS query name is too long after DNAME substitution."""
 
 
-def _errors_to_text(errors):
+ErrorTuple = Tuple[
+    Optional[str], bool, int, Union[Exception, str], Optional[dns.message.Message]
+]
+
+
+def _errors_to_text(errors: List[ErrorTuple]) -> List[str]:
     """Turn a resolution errors trace into a list of text."""
     texts = []
     for err in errors:
-        texts.append('Server {} {} port {} answered {}'.format(err[0],
-                     'TCP' if err[1] else 'UDP', err[2], err[3]))
+        texts.append(
+            "Server {} {} port {} answered {}".format(
+                err[0], "TCP" if err[1] else "UDP", err[2], err[3]
+            )
+        )
     return texts
 
 
@@ -146,12 +161,18 @@ class LifetimeTimeout(dns.exception.Timeout):
 
     msg = "The resolution lifetime expired."
     fmt = "%s after {timeout:.3f} seconds: {errors}" % msg[:-1]
-    supp_kwargs = {'timeout', 'errors'}
+    supp_kwargs = {"timeout", "errors"}
+
+    # We do this as otherwise mypy complains about unexpected keyword argument
+    # idna_exception
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
 
     def _fmt_kwargs(self, **kwargs):
-        srv_msgs = _errors_to_text(kwargs['errors'])
-        return super()._fmt_kwargs(timeout=kwargs['timeout'],
-                                   errors='; '.join(srv_msgs))
+        srv_msgs = _errors_to_text(kwargs["errors"])
+        return super()._fmt_kwargs(
+            timeout=kwargs["timeout"], errors="; ".join(srv_msgs)
+        )
 
 
 # We added more detail to resolution timeouts, but they are still
@@ -162,15 +183,20 @@ Timeout = LifetimeTimeout
 
 class NoAnswer(dns.exception.DNSException):
     """The DNS response does not contain an answer to the question."""
-    fmt = 'The DNS response does not contain an answer ' + \
-          'to the question: {query}'
-    supp_kwargs = {'response'}
+
+    fmt = "The DNS response does not contain an answer " + "to the question: {query}"
+    supp_kwargs = {"response"}
+
+    # We do this as otherwise mypy complains about unexpected keyword argument
+    # idna_exception
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
 
     def _fmt_kwargs(self, **kwargs):
-        return super()._fmt_kwargs(query=kwargs['response'].question)
+        return super()._fmt_kwargs(query=kwargs["response"].question)
 
     def response(self):
-        return self.kwargs['response']
+        return self.kwargs["response"]
 
 
 class NoNameservers(dns.exception.DNSException):
@@ -184,12 +210,18 @@ class NoNameservers(dns.exception.DNSException):
 
     msg = "All nameservers failed to answer the query."
     fmt = "%s {query}: {errors}" % msg[:-1]
-    supp_kwargs = {'request', 'errors'}
+    supp_kwargs = {"request", "errors"}
+
+    # We do this as otherwise mypy complains about unexpected keyword argument
+    # idna_exception
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
 
     def _fmt_kwargs(self, **kwargs):
-        srv_msgs = _errors_to_text(kwargs['errors'])
-        return super()._fmt_kwargs(query=kwargs['request'].question,
-                                   errors='; '.join(srv_msgs))
+        srv_msgs = _errors_to_text(kwargs["errors"])
+        return super()._fmt_kwargs(
+            query=kwargs["request"].question, errors="; ".join(srv_msgs)
+        )
 
 
 class NotAbsolute(dns.exception.DNSException):
@@ -203,9 +235,11 @@ class NoRootSOA(dns.exception.DNSException):
 class NoMetaqueries(dns.exception.DNSException):
     """DNS metaqueries are not allowed."""
 
+
 class NoResolverConfiguration(dns.exception.DNSException):
     """Resolver configuration could not be read or specified no nameservers."""
 
+
 class Answer:
     """DNS stub resolver answer.
 
@@ -222,8 +256,15 @@ class Answer:
     RRset's name might not be the query name.
     """
 
-    def __init__(self, qname, rdtype, rdclass, response, nameserver=None,
-                 port=None):
+    def __init__(
+        self,
+        qname: dns.name.Name,
+        rdtype: dns.rdatatype.RdataType,
+        rdclass: dns.rdataclass.RdataClass,
+        response: dns.message.QueryMessage,
+        nameserver: Optional[str] = None,
+        port: Optional[int] = None,
+    ):
         self.qname = qname
         self.rdtype = rdtype
         self.rdclass = rdclass
@@ -238,15 +279,15 @@ class Answer:
         self.expiration = time.time() + self.chaining_result.minimum_ttl
 
     def __getattr__(self, attr):  # pragma: no cover
-        if attr == 'name':
+        if attr == "name":
             return self.rrset.name
-        elif attr == 'ttl':
+        elif attr == "ttl":
             return self.rrset.ttl
-        elif attr == 'covers':
+        elif attr == "covers":
             return self.rrset.covers
-        elif attr == 'rdclass':
+        elif attr == "rdclass":
             return self.rrset.rdclass
-        elif attr == 'rdtype':
+        elif attr == "rdtype":
             return self.rrset.rdtype
         else:
             raise AttributeError(attr)
@@ -269,8 +310,7 @@ class Answer:
 
 
 class CacheStatistics:
-    """Cache Statistics
-    """
+    """Cache Statistics"""
 
     def __init__(self, hits=0, misses=0):
         self.hits = hits
@@ -280,31 +320,31 @@ class CacheStatistics:
         self.hits = 0
         self.misses = 0
 
-    def clone(self):
+    def clone(self) -> "CacheStatistics":
         return CacheStatistics(self.hits, self.misses)
 
 
 class CacheBase:
     def __init__(self):
-        self.lock = _threading.Lock()
+        self.lock = threading.Lock()
         self.statistics = CacheStatistics()
 
-    def reset_statistics(self):
+    def reset_statistics(self) -> None:
         """Reset all statistics to zero."""
         with self.lock:
             self.statistics.reset()
 
-    def hits(self):
+    def hits(self) -> int:
         """How many hits has the cache had?"""
         with self.lock:
             return self.statistics.hits
 
-    def misses(self):
+    def misses(self) -> int:
         """How many misses has the cache had?"""
         with self.lock:
             return self.statistics.misses
 
-    def get_statistics_snapshot(self):
+    def get_statistics_snapshot(self) -> CacheStatistics:
         """Return a consistent snapshot of all the statistics.
 
         If running with multiple threads, it's better to take a
@@ -315,20 +355,23 @@ class CacheBase:
             return self.statistics.clone()
 
 
+CacheKey = Tuple[dns.name.Name, dns.rdatatype.RdataType, dns.rdataclass.RdataClass]
+
+
 class Cache(CacheBase):
     """Simple thread-safe DNS answer cache."""
 
-    def __init__(self, cleaning_interval=300.0):
+    def __init__(self, cleaning_interval: float = 300.0):
         """*cleaning_interval*, a ``float`` is the number of seconds between
         periodic cleanings.
         """
 
         super().__init__()
-        self.data = {}
+        self.data: Dict[CacheKey, Answer] = {}
         self.cleaning_interval = cleaning_interval
-        self.next_cleaning = time.time() + self.cleaning_interval
+        self.next_cleaning: float = time.time() + self.cleaning_interval
 
-    def _maybe_clean(self):
+    def _maybe_clean(self) -> None:
         """Clean the cache if it's time to do so."""
 
         now = time.time()
@@ -342,13 +385,13 @@ class Cache(CacheBase):
             now = time.time()
             self.next_cleaning = now + self.cleaning_interval
 
-    def get(self, key):
+    def get(self, key: CacheKey) -> Optional[Answer]:
         """Get the answer associated with *key*.
 
         Returns None if no answer is cached for the key.
 
-        *key*, a ``(dns.name.Name, int, int)`` tuple whose values are the
-        query name, rdtype, and rdclass respectively.
+        *key*, a ``(dns.name.Name, dns.rdatatype.RdataType, dns.rdataclass.RdataClass)``
+        tuple whose values are the query name, rdtype, and rdclass respectively.
 
         Returns a ``dns.resolver.Answer`` or ``None``.
         """
@@ -362,11 +405,11 @@ class Cache(CacheBase):
             self.statistics.hits += 1
             return v
 
-    def put(self, key, value):
+    def put(self, key: CacheKey, value: Answer) -> None:
         """Associate key and value in the cache.
 
-        *key*, a ``(dns.name.Name, int, int)`` tuple whose values are the
-        query name, rdtype, and rdclass respectively.
+        *key*, a ``(dns.name.Name, dns.rdatatype.RdataType, dns.rdataclass.RdataClass)``
+        tuple whose values are the query name, rdtype, and rdclass respectively.
 
         *value*, a ``dns.resolver.Answer``, the answer.
         """
@@ -375,14 +418,14 @@ class Cache(CacheBase):
             self._maybe_clean()
             self.data[key] = value
 
-    def flush(self, key=None):
+    def flush(self, key: Optional[CacheKey] = None) -> None:
         """Flush the cache.
 
-        If *key* is not ``None``, only that item is flushed.  Otherwise
-        the entire cache is flushed.
+        If *key* is not ``None``, only that item is flushed.  Otherwise the entire cache
+        is flushed.
 
-        *key*, a ``(dns.name.Name, int, int)`` tuple whose values are the
-        query name, rdtype, and rdclass respectively.
+        *key*, a ``(dns.name.Name, dns.rdatatype.RdataType, dns.rdataclass.RdataClass)``
+        tuple whose values are the query name, rdtype, and rdclass respectively.
         """
 
         with self.lock:
@@ -425,30 +468,30 @@ class LRUCache(CacheBase):
     for a new one.
     """
 
-    def __init__(self, max_size=100000):
+    def __init__(self, max_size: int = 100000):
         """*max_size*, an ``int``, is the maximum number of nodes to cache;
         it must be greater than 0.
         """
 
         super().__init__()
-        self.data = {}
+        self.data: Dict[CacheKey, LRUCacheNode] = {}
         self.set_max_size(max_size)
-        self.sentinel = LRUCacheNode(None, None)
+        self.sentinel: LRUCacheNode = LRUCacheNode(None, None)
         self.sentinel.prev = self.sentinel
         self.sentinel.next = self.sentinel
 
-    def set_max_size(self, max_size):
+    def set_max_size(self, max_size: int) -> None:
         if max_size < 1:
             max_size = 1
         self.max_size = max_size
 
-    def get(self, key):
+    def get(self, key: CacheKey) -> Optional[Answer]:
         """Get the answer associated with *key*.
 
         Returns None if no answer is cached for the key.
 
-        *key*, a ``(dns.name.Name, int, int)`` tuple whose values are the
-        query name, rdtype, and rdclass respectively.
+        *key*, a ``(dns.name.Name, dns.rdatatype.RdataType, dns.rdataclass.RdataClass)``
+        tuple whose values are the query name, rdtype, and rdclass respectively.
 
         Returns a ``dns.resolver.Answer`` or ``None``.
         """
@@ -470,7 +513,7 @@ class LRUCache(CacheBase):
             node.hits += 1
             return node.value
 
-    def get_hits_for_key(self, key):
+    def get_hits_for_key(self, key: CacheKey) -> int:
         """Return the number of cache hits associated with the specified key."""
         with self.lock:
             node = self.data.get(key)
@@ -479,11 +522,11 @@ class LRUCache(CacheBase):
             else:
                 return node.hits
 
-    def put(self, key, value):
+    def put(self, key: CacheKey, value: Answer) -> None:
         """Associate key and value in the cache.
 
-        *key*, a ``(dns.name.Name, int, int)`` tuple whose values are the
-        query name, rdtype, and rdclass respectively.
+        *key*, a ``(dns.name.Name, dns.rdatatype.RdataType, dns.rdataclass.RdataClass)``
+        tuple whose values are the query name, rdtype, and rdclass respectively.
 
         *value*, a ``dns.resolver.Answer``, the answer.
         """
@@ -494,21 +537,21 @@ class LRUCache(CacheBase):
                 node.unlink()
                 del self.data[node.key]
             while len(self.data) >= self.max_size:
-                node = self.sentinel.prev
-                node.unlink()
-                del self.data[node.key]
+                gnode = self.sentinel.prev
+                gnode.unlink()
+                del self.data[gnode.key]
             node = LRUCacheNode(key, value)
             node.link_after(self.sentinel)
             self.data[key] = node
 
-    def flush(self, key=None):
+    def flush(self, key: Optional[CacheKey] = None) -> None:
         """Flush the cache.
 
-        If *key* is not ``None``, only that item is flushed.  Otherwise
-        the entire cache is flushed.
+        If *key* is not ``None``, only that item is flushed.  Otherwise the entire cache
+        is flushed.
 
-        *key*, a ``(dns.name.Name, int, int)`` tuple whose values are the
-        query name, rdtype, and rdclass respectively.
+        *key*, a ``(dns.name.Name, dns.rdatatype.RdataType, dns.rdataclass.RdataClass)``
+        tuple whose values are the query name, rdtype, and rdclass respectively.
         """
 
         with self.lock:
@@ -518,13 +561,14 @@ class LRUCache(CacheBase):
                     node.unlink()
                     del self.data[node.key]
             else:
-                node = self.sentinel.next
-                while node != self.sentinel:
-                    next = node.next
-                    node.unlink()
-                    node = next
+                gnode = self.sentinel.next
+                while gnode != self.sentinel:
+                    next = gnode.next
+                    gnode.unlink()
+                    gnode = next
                 self.data = {}
 
+
 class _Resolution:
     """Helper class for dns.resolver.Resolver.resolve().
 
@@ -537,38 +581,47 @@ class _Resolution:
     resolver data structures directly.
     """
 
-    def __init__(self, resolver, qname, rdtype, rdclass, tcp,
-                 raise_on_no_answer, search):
+    def __init__(
+        self,
+        resolver: "BaseResolver",
+        qname: Union[dns.name.Name, str],
+        rdtype: Union[dns.rdatatype.RdataType, str],
+        rdclass: Union[dns.rdataclass.RdataClass, str],
+        tcp: bool,
+        raise_on_no_answer: bool,
+        search: Optional[bool],
+    ):
         if isinstance(qname, str):
             qname = dns.name.from_text(qname, None)
-        rdtype = dns.rdatatype.RdataType.make(rdtype)
-        if dns.rdatatype.is_metatype(rdtype):
+        the_rdtype = dns.rdatatype.RdataType.make(rdtype)
+        if dns.rdatatype.is_metatype(the_rdtype):
             raise NoMetaqueries
-        rdclass = dns.rdataclass.RdataClass.make(rdclass)
-        if dns.rdataclass.is_metaclass(rdclass):
+        the_rdclass = dns.rdataclass.RdataClass.make(rdclass)
+        if dns.rdataclass.is_metaclass(the_rdclass):
             raise NoMetaqueries
         self.resolver = resolver
         self.qnames_to_try = resolver._get_qnames_to_try(qname, search)
         self.qnames = self.qnames_to_try[:]
-        self.rdtype = rdtype
-        self.rdclass = rdclass
+        self.rdtype = the_rdtype
+        self.rdclass = the_rdclass
         self.tcp = tcp
         self.raise_on_no_answer = raise_on_no_answer
-        self.nxdomain_responses = {}
-        #
+        self.nxdomain_responses: Dict[dns.name.Name, dns.message.QueryMessage] = {}
         # Initialize other things to help analysis tools
         self.qname = dns.name.empty
-        self.nameservers = []
-        self.current_nameservers = []
-        self.errors = []
-        self.nameserver = None
+        self.nameservers: List[str] = []
+        self.current_nameservers: List[str] = []
+        self.errors: List[ErrorTuple] = []
+        self.nameserver: Optional[str] = None
         self.port = 0
         self.tcp_attempt = False
         self.retry_with_tcp = False
-        self.request = None
-        self.backoff = 0
+        self.request: Optional[dns.message.QueryMessage] = None
+        self.backoff = 0.0
 
-    def next_request(self):
+    def next_request(
+        self,
+    ) -> Tuple[Optional[dns.message.QueryMessage], Optional[Answer]]:
         """Get the next request to send, and check the cache.
 
         Returns a (request, answer) tuple.  At most one of request or
@@ -583,31 +636,37 @@ class _Resolution:
 
             # Do we know the answer?
             if self.resolver.cache:
-                answer = self.resolver.cache.get((self.qname, self.rdtype,
-                                                  self.rdclass))
+                answer = self.resolver.cache.get(
+                    (self.qname, self.rdtype, self.rdclass)
+                )
                 if answer is not None:
                     if answer.rrset is None and self.raise_on_no_answer:
                         raise NoAnswer(response=answer.response)
                     else:
                         return (None, answer)
-                answer = self.resolver.cache.get((self.qname,
-                                                  dns.rdatatype.ANY,
-                                                  self.rdclass))
-                if answer is not None and \
-                   answer.response.rcode() == dns.rcode.NXDOMAIN:
+                answer = self.resolver.cache.get(
+                    (self.qname, dns.rdatatype.ANY, self.rdclass)
+                )
+                if answer is not None and answer.response.rcode() == dns.rcode.NXDOMAIN:
                     # cached NXDOMAIN; record it and continue to next
                     # name.
                     self.nxdomain_responses[self.qname] = answer.response
                     continue
 
             # Build the request
-            request = dns.message.make_query(self.qname, self.rdtype,
-                                             self.rdclass)
+            request = dns.message.make_query(self.qname, self.rdtype, self.rdclass)
             if self.resolver.keyname is not None:
-                request.use_tsig(self.resolver.keyring, self.resolver.keyname,
-                                 algorithm=self.resolver.keyalgorithm)
-            request.use_edns(self.resolver.edns, self.resolver.ednsflags,
-                             self.resolver.payload)
+                request.use_tsig(
+                    self.resolver.keyring,
+                    self.resolver.keyname,
+                    algorithm=self.resolver.keyalgorithm,
+                )
+            request.use_edns(
+                self.resolver.edns,
+                self.resolver.ednsflags,
+                self.resolver.payload,
+                options=self.resolver.ednsoptions,
+            )
             if self.resolver.flags is not None:
                 request.flags = self.resolver.flags
 
@@ -629,17 +688,16 @@ class _Resolution:
         # it's only NXDOMAINs as anything else would have returned
         # before now.)
         #
-        raise NXDOMAIN(qnames=self.qnames_to_try,
-                       responses=self.nxdomain_responses)
+        raise NXDOMAIN(qnames=self.qnames_to_try, responses=self.nxdomain_responses)
 
-    def next_nameserver(self):
+    def next_nameserver(self) -> Tuple[str, int, bool, float]:
         if self.retry_with_tcp:
             assert self.nameserver is not None
             self.tcp_attempt = True
             self.retry_with_tcp = False
             return (self.nameserver, self.port, True, 0)
 
-        backoff = 0
+        backoff = 0.0
         if not self.current_nameservers:
             if len(self.nameservers) == 0:
                 # Out of things to try!
@@ -649,24 +707,31 @@ class _Resolution:
             self.backoff = min(self.backoff * 2, 2)
 
         self.nameserver = self.current_nameservers.pop(0)
-        self.port = self.resolver.nameserver_ports.get(self.nameserver,
-                                                       self.resolver.port)
+        self.port = self.resolver.nameserver_ports.get(
+            self.nameserver, self.resolver.port
+        )
         self.tcp_attempt = self.tcp
         return (self.nameserver, self.port, self.tcp_attempt, backoff)
 
-    def query_result(self, response, ex):
+    def query_result(
+        self, response: Optional[dns.message.Message], ex: Optional[Exception]
+    ) -> Tuple[Optional[Answer], bool]:
         #
         # returns an (answer: Answer, end_loop: bool) tuple.
         #
+        assert self.nameserver is not None
         if ex:
             # Exception during I/O or from_wire()
             assert response is None
-            self.errors.append((self.nameserver, self.tcp_attempt, self.port,
-                                ex, response))
-            if isinstance(ex, dns.exception.FormError) or \
-               isinstance(ex, EOFError) or \
-               isinstance(ex, OSError) or \
-               isinstance(ex, NotImplementedError):
+            self.errors.append(
+                (self.nameserver, self.tcp_attempt, self.port, ex, response)
+            )
+            if (
+                isinstance(ex, dns.exception.FormError)
+                or isinstance(ex, EOFError)
+                or isinstance(ex, OSError)
+                or isinstance(ex, NotImplementedError)
+            ):
                 # This nameserver is no good, take it out of the mix.
                 self.nameservers.remove(self.nameserver)
             elif isinstance(ex, dns.message.Truncated):
@@ -678,20 +743,27 @@ class _Resolution:
             return (None, False)
         # We got an answer!
         assert response is not None
+        assert isinstance(response, dns.message.QueryMessage)
         rcode = response.rcode()
         if rcode == dns.rcode.NOERROR:
             try:
-                answer = Answer(self.qname, self.rdtype, self.rdclass, response,
-                                self.nameserver, self.port)
+                answer = Answer(
+                    self.qname,
+                    self.rdtype,
+                    self.rdclass,
+                    response,
+                    self.nameserver,
+                    self.port,
+                )
             except Exception as e:
-                self.errors.append((self.nameserver, self.tcp_attempt,
-                                   self.port, e, response))
+                self.errors.append(
+                    (self.nameserver, self.tcp_attempt, self.port, e, response)
+                )
                 # The nameserver is no good, take it out of the mix.
                 self.nameservers.remove(self.nameserver)
                 return (None, False)
             if self.resolver.cache:
-                self.resolver.cache.put((self.qname, self.rdtype,
-                                         self.rdclass), answer)
+                self.resolver.cache.put((self.qname, self.rdtype, self.rdclass), answer)
             if answer.rrset is None and self.raise_on_no_answer:
                 raise NoAnswer(response=answer.response)
             return (answer, True)
@@ -699,26 +771,29 @@ class _Resolution:
             # Further validate the response by making an Answer, even
             # if we aren't going to cache it.
             try:
-                answer = Answer(self.qname, dns.rdatatype.ANY,
-                                dns.rdataclass.IN, response)
+                answer = Answer(
+                    self.qname, dns.rdatatype.ANY, dns.rdataclass.IN, response
+                )
             except Exception as e:
-                self.errors.append((self.nameserver, self.tcp_attempt,
-                                   self.port, e, response))
+                self.errors.append(
+                    (self.nameserver, self.tcp_attempt, self.port, e, response)
+                )
                 # The nameserver is no good, take it out of the mix.
                 self.nameservers.remove(self.nameserver)
                 return (None, False)
             self.nxdomain_responses[self.qname] = response
             if self.resolver.cache:
-                self.resolver.cache.put((self.qname,
-                                         dns.rdatatype.ANY,
-                                         self.rdclass), answer)
+                self.resolver.cache.put(
+                    (self.qname, dns.rdatatype.ANY, self.rdclass), answer
+                )
             # Make next_nameserver() return None, so caller breaks its
             # inner loop and calls next_request().
             return (None, True)
         elif rcode == dns.rcode.YXDOMAIN:
             yex = YXDOMAIN()
-            self.errors.append((self.nameserver, self.tcp_attempt,
-                                self.port, yex, response))
+            self.errors.append(
+                (self.nameserver, self.tcp_attempt, self.port, yex, response)
+            )
             raise yex
         else:
             #
@@ -727,10 +802,18 @@ class _Resolution:
             #
             if rcode != dns.rcode.SERVFAIL or not self.resolver.retry_servfail:
                 self.nameservers.remove(self.nameserver)
-            self.errors.append((self.nameserver, self.tcp_attempt, self.port,
-                                dns.rcode.to_text(rcode), response))
+            self.errors.append(
+                (
+                    self.nameserver,
+                    self.tcp_attempt,
+                    self.port,
+                    dns.rcode.to_text(rcode),
+                    response,
+                )
+            )
             return (None, False)
 
+
 class BaseResolver:
     """DNS stub resolver."""
 
@@ -738,7 +821,27 @@ class BaseResolver:
     #
     # pylint: disable=attribute-defined-outside-init
 
-    def __init__(self, filename='/etc/resolv.conf', configure=True):
+    domain: dns.name.Name
+    nameserver_ports: Dict[str, int]
+    port: int
+    search: List[dns.name.Name]
+    use_search_by_default: bool
+    timeout: float
+    lifetime: float
+    keyring: Optional[Any]
+    keyname: Optional[Union[dns.name.Name, str]]
+    keyalgorithm: Union[dns.name.Name, str]
+    edns: int
+    ednsflags: int
+    ednsoptions: Optional[List[dns.edns.Option]]
+    payload: int
+    cache: Any
+    flags: Optional[int]
+    retry_servfail: bool
+    rotate: bool
+    ndots: Optional[int]
+
+    def __init__(self, filename: str = "/etc/resolv.conf", configure: bool = True):
         """*filename*, a ``str`` or file object, specifying a file
         in standard /etc/resolv.conf format.  This parameter is meaningful
         only when *configure* is true and the platform is POSIX.
@@ -752,7 +855,7 @@ class BaseResolver:
 
         self.reset()
         if configure:
-            if sys.platform == 'win32':
+            if sys.platform == "win32":
                 self.read_registry()
             elif filename:
                 self.read_resolv_conf(filename)
@@ -760,8 +863,7 @@ class BaseResolver:
     def reset(self):
         """Reset all resolver configuration to the defaults."""
 
-        self.domain = \
-            dns.name.Name(dns.name.from_text(socket.gethostname())[1:])
+        self.domain = dns.name.Name(dns.name.from_text(socket.gethostname())[1:])
         if len(self.domain) == 0:
             self.domain = dns.name.root
         self.nameservers = []
@@ -776,6 +878,7 @@ class BaseResolver:
         self.keyalgorithm = dns.tsig.default_algorithm
         self.edns = -1
         self.ednsflags = 0
+        self.ednsoptions = None
         self.payload = 0
         self.cache = None
         self.flags = None
@@ -783,7 +886,7 @@ class BaseResolver:
         self.rotate = False
         self.ndots = None
 
-    def read_resolv_conf(self, f):
+    def read_resolv_conf(self, f: Any) -> None:
         """Process *f* as a file in the /etc/resolv.conf format.  If f is
         a ``str``, it is used as the name of the file to open; otherwise it
         is treated as the file itself.
@@ -800,16 +903,17 @@ class BaseResolver:
 
         """
 
-        with contextlib.ExitStack() as stack:
-            if isinstance(f, str):
-                try:
-                    f = stack.enter_context(open(f))
-                except OSError:
-                    # /etc/resolv.conf doesn't exist, can't be read, etc.
-                    raise NoResolverConfiguration(f'cannot open {f}')
-
+        if isinstance(f, str):
+            try:
+                cm: contextlib.AbstractContextManager = open(f)
+            except OSError:
+                # /etc/resolv.conf doesn't exist, can't be read, etc.
+                raise NoResolverConfiguration(f"cannot open {f}")
+        else:
+            cm = contextlib.nullcontext(f)
+        with cm as f:
             for l in f:
-                if len(l) == 0 or l[0] == '#' or l[0] == ';':
+                if len(l) == 0 or l[0] == "#" or l[0] == ";":
                     continue
                 tokens = l.split()
 
@@ -817,42 +921,42 @@ class BaseResolver:
                 if len(tokens) < 2:
                     continue
 
-                if tokens[0] == 'nameserver':
+                if tokens[0] == "nameserver":
                     self.nameservers.append(tokens[1])
-                elif tokens[0] == 'domain':
+                elif tokens[0] == "domain":
                     self.domain = dns.name.from_text(tokens[1])
                     # domain and search are exclusive
                     self.search = []
-                elif tokens[0] == 'search':
+                elif tokens[0] == "search":
                     # the last search wins
                     self.search = []
                     for suffix in tokens[1:]:
                         self.search.append(dns.name.from_text(suffix))
                     # We don't set domain as it is not used if
                     # len(self.search) > 0
-                elif tokens[0] == 'options':
+                elif tokens[0] == "options":
                     for opt in tokens[1:]:
-                        if opt == 'rotate':
+                        if opt == "rotate":
                             self.rotate = True
-                        elif opt == 'edns0':
+                        elif opt == "edns0":
                             self.use_edns()
-                        elif 'timeout' in opt:
+                        elif "timeout" in opt:
                             try:
-                                self.timeout = int(opt.split(':')[1])
+                                self.timeout = int(opt.split(":")[1])
                             except (ValueError, IndexError):
                                 pass
-                        elif 'ndots' in opt:
+                        elif "ndots" in opt:
                             try:
-                                self.ndots = int(opt.split(':')[1])
+                                self.ndots = int(opt.split(":")[1])
                             except (ValueError, IndexError):
                                 pass
         if len(self.nameservers) == 0:
-            raise NoResolverConfiguration('no nameservers')
+            raise NoResolverConfiguration("no nameservers")
 
-    def read_registry(self):
+    def read_registry(self) -> None:
         """Extract resolver configuration from the Windows registry."""
         try:
-            info = dns.win32util.get_dns_info()
+            info = dns.win32util.get_dns_info()  # type: ignore
             if info.domain is not None:
                 self.domain = info.domain
             self.nameservers = info.nameservers
@@ -860,7 +964,12 @@ class BaseResolver:
         except AttributeError:
             raise NotImplementedError
 
-    def _compute_timeout(self, start, lifetime=None, errors=None):
+    def _compute_timeout(
+        self,
+        start: float,
+        lifetime: Optional[float] = None,
+        errors: Optional[List[ErrorTuple]] = None,
+    ) -> float:
         lifetime = self.lifetime if lifetime is None else lifetime
         now = time.time()
         duration = now - start
@@ -874,12 +983,14 @@ class BaseResolver:
                 # Time went backwards, but only a little.  This can
                 # happen, e.g. under vmware with older linux kernels.
                 # Pretend it didn't happen.
-                now = start
+                duration = 0
         if duration >= lifetime:
             raise LifetimeTimeout(timeout=duration, errors=errors)
         return min(lifetime - duration, self.timeout)
 
-    def _get_qnames_to_try(self, qname, search):
+    def _get_qnames_to_try(
+        self, qname: dns.name.Name, search: Optional[bool]
+    ) -> List[dns.name.Name]:
         # This is a separate method so we can unit test the search
         # rules without requiring the Internet.
         if search is None:
@@ -918,8 +1029,12 @@ class BaseResolver:
                 qnames_to_try.append(abs_qname)
         return qnames_to_try
 
-    def use_tsig(self, keyring, keyname=None,
-                 algorithm=dns.tsig.default_algorithm):
+    def use_tsig(
+        self,
+        keyring: Any,
+        keyname: Optional[Union[dns.name.Name, str]] = None,
+        algorithm: Union[dns.name.Name, str] = dns.tsig.default_algorithm,
+    ) -> None:
         """Add a TSIG signature to each query.
 
         The parameters are passed to ``dns.message.Message.use_tsig()``;
@@ -930,8 +1045,13 @@ class BaseResolver:
         self.keyname = keyname
         self.keyalgorithm = algorithm
 
-    def use_edns(self, edns=0, ednsflags=0,
-                 payload=dns.message.DEFAULT_EDNS_PAYLOAD):
+    def use_edns(
+        self,
+        edns: Optional[Union[int, bool]] = 0,
+        ednsflags: int = 0,
+        payload: int = dns.message.DEFAULT_EDNS_PAYLOAD,
+        options: Optional[List[dns.edns.Option]] = None,
+    ) -> None:
         """Configure EDNS behavior.
 
         *edns*, an ``int``, is the EDNS level to use.  Specifying
@@ -944,6 +1064,9 @@ class BaseResolver:
         *payload*, an ``int``, is the EDNS sender's payload field, which is the
         maximum size of UDP datagram the sender can handle.  I.e. how big
         a response to this message can be.
+
+        *options*, a list of ``dns.edns.Option`` objects or ``None``, the EDNS
+        options.
         """
 
         if edns is None or edns is False:
@@ -953,8 +1076,9 @@ class BaseResolver:
         self.edns = edns
         self.ednsflags = ednsflags
         self.payload = payload
+        self.ednsoptions = options
 
-    def set_flags(self, flags):
+    def set_flags(self, flags: int) -> None:
         """Overrides the default flags with your own.
 
         *flags*, an ``int``, the message flags to use.
@@ -963,11 +1087,11 @@ class BaseResolver:
         self.flags = flags
 
     @property
-    def nameservers(self):
+    def nameservers(self) -> List[str]:
         return self._nameservers
 
     @nameservers.setter
-    def nameservers(self, nameservers):
+    def nameservers(self, nameservers: List[str]) -> None:
         """
         *nameservers*, a ``list`` of nameservers.
 
@@ -978,23 +1102,35 @@ class BaseResolver:
             for nameserver in nameservers:
                 if not dns.inet.is_address(nameserver):
                     try:
-                        if urlparse(nameserver).scheme != 'https':
+                        if urlparse(nameserver).scheme != "https":
                             raise NotImplementedError
                     except Exception:
-                        raise ValueError(f'nameserver {nameserver} is not an '
-                                         'IP address or valid https URL')
+                        raise ValueError(
+                            f"nameserver {nameserver} is not an "
+                            "IP address or valid https URL"
+                        )
             self._nameservers = nameservers
         else:
-            raise ValueError('nameservers must be a list'
-                             ' (not a {})'.format(type(nameservers)))
+            raise ValueError(
+                "nameservers must be a list (not a {})".format(type(nameservers))
+            )
 
 
 class Resolver(BaseResolver):
     """DNS stub resolver."""
 
-    def resolve(self, qname, rdtype=dns.rdatatype.A, rdclass=dns.rdataclass.IN,
-                tcp=False, source=None, raise_on_no_answer=True, source_port=0,
-                lifetime=None, search=None):  # pylint: disable=arguments-differ
+    def resolve(
+        self,
+        qname: Union[dns.name.Name, str],
+        rdtype: Union[dns.rdatatype.RdataType, str] = dns.rdatatype.A,
+        rdclass: Union[dns.rdataclass.RdataClass, str] = dns.rdataclass.IN,
+        tcp: bool = False,
+        source: Optional[str] = None,
+        raise_on_no_answer: bool = True,
+        source_port: int = 0,
+        lifetime: Optional[float] = None,
+        search: Optional[bool] = None,
+    ) -> Answer:  # pylint: disable=arguments-differ
         """Query nameservers to find the answer to the question.
 
         The *qname*, *rdtype*, and *rdclass* parameters may be objects
@@ -1046,8 +1182,9 @@ class Resolver(BaseResolver):
 
         """
 
-        resolution = _Resolution(self, qname, rdtype, rdclass, tcp,
-                                 raise_on_no_answer, search)
+        resolution = _Resolution(
+            self, qname, rdtype, rdclass, tcp, raise_on_no_answer, search
+        )
         start = time.time()
         while True:
             (request, answer) = resolution.next_request()
@@ -1058,32 +1195,36 @@ class Resolver(BaseResolver):
             if answer is not None:
                 # cache hit!
                 return answer
+            assert request is not None  # needed for type checking
             done = False
             while not done:
                 (nameserver, port, tcp, backoff) = resolution.next_nameserver()
                 if backoff:
                     time.sleep(backoff)
-                timeout = self._compute_timeout(start, lifetime,
-                                                resolution.errors)
+                timeout = self._compute_timeout(start, lifetime, resolution.errors)
                 try:
                     if dns.inet.is_address(nameserver):
                         if tcp:
-                            response = dns.query.tcp(request, nameserver,
-                                                     timeout=timeout,
-                                                     port=port,
-                                                     source=source,
-                                                     source_port=source_port)
+                            response = dns.query.tcp(
+                                request,
+                                nameserver,
+                                timeout=timeout,
+                                port=port,
+                                source=source,
+                                source_port=source_port,
+                            )
                         else:
-                            response = dns.query.udp(request,
-                                                     nameserver,
-                                                     timeout=timeout,
-                                                     port=port,
-                                                     source=source,
-                                                     source_port=source_port,
-                                                     raise_on_truncation=True)
+                            response = dns.query.udp(
+                                request,
+                                nameserver,
+                                timeout=timeout,
+                                port=port,
+                                source=source,
+                                source_port=source_port,
+                                raise_on_truncation=True,
+                            )
                     else:
-                        response = dns.query.https(request, nameserver,
-                                                   timeout=timeout)
+                        response = dns.query.https(request, nameserver, timeout=timeout)
                 except Exception as ex:
                     (_, done) = resolution.query_result(None, ex)
                     continue
@@ -1095,9 +1236,17 @@ class Resolver(BaseResolver):
                 if answer is not None:
                     return answer
 
-    def query(self, qname, rdtype=dns.rdatatype.A, rdclass=dns.rdataclass.IN,
-              tcp=False, source=None, raise_on_no_answer=True, source_port=0,
-              lifetime=None):  # pragma: no cover
+    def query(
+        self,
+        qname: Union[dns.name.Name, str],
+        rdtype: Union[dns.rdatatype.RdataType, str] = dns.rdatatype.A,
+        rdclass: Union[dns.rdataclass.RdataClass, str] = dns.rdataclass.IN,
+        tcp: bool = False,
+        source: Optional[str] = None,
+        raise_on_no_answer: bool = True,
+        source_port: int = 0,
+        lifetime: Optional[float] = None,
+    ) -> Answer:  # pragma: no cover
         """Query nameservers to find the answer to the question.
 
         This method calls resolve() with ``search=True``, and is
@@ -1105,13 +1254,24 @@ class Resolver(BaseResolver):
         dnspython.  See the documentation for the resolve() method for
         further details.
         """
-        warnings.warn('please use dns.resolver.Resolver.resolve() instead',
-                      DeprecationWarning, stacklevel=2)
-        return self.resolve(qname, rdtype, rdclass, tcp, source,
-                            raise_on_no_answer, source_port, lifetime,
-                            True)
+        warnings.warn(
+            "please use dns.resolver.Resolver.resolve() instead",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        return self.resolve(
+            qname,
+            rdtype,
+            rdclass,
+            tcp,
+            source,
+            raise_on_no_answer,
+            source_port,
+            lifetime,
+            True,
+        )
 
-    def resolve_address(self, ipaddr, *args, **kwargs):
+    def resolve_address(self, ipaddr: str, *args: Any, **kwargs: Any) -> Answer:
         """Use a resolver to run a reverse query for PTR records.
 
         This utilizes the resolve() method to perform a PTR lookup on the
@@ -1124,15 +1284,20 @@ class Resolver(BaseResolver):
         except for rdtype and rdclass are also supported by this
         function.
         """
-
-        return self.resolve(dns.reversename.from_address(ipaddr),
-                            rdtype=dns.rdatatype.PTR,
-                            rdclass=dns.rdataclass.IN,
-                            *args, **kwargs)
+        # We make a modified kwargs for type checking happiness, as otherwise
+        # we get a legit warning about possibly having rdtype and rdclass
+        # in the kwargs more than once.
+        modified_kwargs: Dict[str, Any] = {}
+        modified_kwargs.update(kwargs)
+        modified_kwargs["rdtype"] = dns.rdatatype.PTR
+        modified_kwargs["rdclass"] = dns.rdataclass.IN
+        return self.resolve(
+            dns.reversename.from_address(ipaddr), *args, **modified_kwargs
+        )  # type: ignore[arg-type]
 
     # pylint: disable=redefined-outer-name
 
-    def canonical_name(self, name):
+    def canonical_name(self, name: Union[dns.name.Name, str]) -> dns.name.Name:
         """Determine the canonical name of *name*.
 
         The canonical name is the name the resolver uses for queries
@@ -1157,13 +1322,14 @@ class Resolver(BaseResolver):
 
 
 #: The default resolver.
-default_resolver = None
+default_resolver: Optional[Resolver] = None
 
 
-def get_default_resolver():
+def get_default_resolver() -> Resolver:
     """Get the default resolver, initializing it if necessary."""
     if default_resolver is None:
         reset_default_resolver()
+    assert default_resolver is not None
     return default_resolver
 
 
@@ -1178,9 +1344,18 @@ def reset_default_resolver():
     default_resolver = Resolver()
 
 
-def resolve(qname, rdtype=dns.rdatatype.A, rdclass=dns.rdataclass.IN,
-            tcp=False, source=None, raise_on_no_answer=True,
-            source_port=0, lifetime=None, search=None):
+def resolve(
+    qname: Union[dns.name.Name, str],
+    rdtype: Union[dns.rdatatype.RdataType, str] = dns.rdatatype.A,
+    rdclass: Union[dns.rdataclass.RdataClass, str] = dns.rdataclass.IN,
+    tcp: bool = False,
+    source: Optional[str] = None,
+    raise_on_no_answer: bool = True,
+    source_port: int = 0,
+    lifetime: Optional[float] = None,
+    search: Optional[bool] = None,
+) -> Answer:  # pragma: no cover
+
     """Query nameservers to find the answer to the question.
 
     This is a convenience function that uses the default resolver
@@ -1190,13 +1365,29 @@ def resolve(qname, rdtype=dns.rdatatype.A, rdclass=dns.rdataclass.IN,
     parameters.
     """
 
-    return get_default_resolver().resolve(qname, rdtype, rdclass, tcp, source,
-                                          raise_on_no_answer, source_port,
-                                          lifetime, search)
+    return get_default_resolver().resolve(
+        qname,
+        rdtype,
+        rdclass,
+        tcp,
+        source,
+        raise_on_no_answer,
+        source_port,
+        lifetime,
+        search,
+    )
 
-def query(qname, rdtype=dns.rdatatype.A, rdclass=dns.rdataclass.IN,
-          tcp=False, source=None, raise_on_no_answer=True,
-          source_port=0, lifetime=None):  # pragma: no cover
+
+def query(
+    qname: Union[dns.name.Name, str],
+    rdtype: Union[dns.rdatatype.RdataType, str] = dns.rdatatype.A,
+    rdclass: Union[dns.rdataclass.RdataClass, str] = dns.rdataclass.IN,
+    tcp: bool = False,
+    source: Optional[str] = None,
+    raise_on_no_answer: bool = True,
+    source_port: int = 0,
+    lifetime: Optional[float] = None,
+) -> Answer:  # pragma: no cover
     """Query nameservers to find the answer to the question.
 
     This method calls resolve() with ``search=True``, and is
@@ -1204,14 +1395,23 @@ def query(qname, rdtype=dns.rdatatype.A, rdclass=dns.rdataclass.IN,
     dnspython.  See the documentation for the resolve() method for
     further details.
     """
-    warnings.warn('please use dns.resolver.resolve() instead',
-                  DeprecationWarning, stacklevel=2)
-    return resolve(qname, rdtype, rdclass, tcp, source,
-                   raise_on_no_answer, source_port, lifetime,
-                   True)
+    warnings.warn(
+        "please use dns.resolver.resolve() instead", DeprecationWarning, stacklevel=2
+    )
+    return resolve(
+        qname,
+        rdtype,
+        rdclass,
+        tcp,
+        source,
+        raise_on_no_answer,
+        source_port,
+        lifetime,
+        True,
+    )
 
 
-def resolve_address(ipaddr, *args, **kwargs):
+def resolve_address(ipaddr: str, *args: Any, **kwargs: Any) -> Answer:
     """Use a resolver to run a reverse query for PTR records.
 
     See ``dns.resolver.Resolver.resolve_address`` for more information on the
@@ -1221,7 +1421,7 @@ def resolve_address(ipaddr, *args, **kwargs):
     return get_default_resolver().resolve_address(ipaddr, *args, **kwargs)
 
 
-def canonical_name(name):
+def canonical_name(name: Union[dns.name.Name, str]) -> dns.name.Name:
     """Determine the canonical name of *name*.
 
     See ``dns.resolver.Resolver.canonical_name`` for more information on the
@@ -1231,8 +1431,13 @@ def canonical_name(name):
     return get_default_resolver().canonical_name(name)
 
 
-def zone_for_name(name, rdclass=dns.rdataclass.IN, tcp=False, resolver=None,
-                  lifetime=None):
+def zone_for_name(
+    name: Union[dns.name.Name, str],
+    rdclass: dns.rdataclass.RdataClass = dns.rdataclass.IN,
+    tcp: bool = False,
+    resolver: Optional[Resolver] = None,
+    lifetime: Optional[float] = None,
+) -> dns.name.Name:
     """Find the name of the zone which contains the specified name.
 
     *name*, an absolute ``dns.name.Name`` or ``str``, the query name.
@@ -1265,20 +1470,24 @@ def zone_for_name(name, rdclass=dns.rdataclass.IN, tcp=False, resolver=None,
     if not name.is_absolute():
         raise NotAbsolute(name)
     start = time.time()
+    expiration: Optional[float]
     if lifetime is not None:
         expiration = start + lifetime
     else:
         expiration = None
     while 1:
         try:
+            rlifetime: Optional[float]
             if expiration:
                 rlifetime = expiration - time.time()
                 if rlifetime <= 0:
                     rlifetime = 0
             else:
                 rlifetime = None
-            answer = resolver.resolve(name, dns.rdatatype.SOA, rdclass, tcp,
-                                      lifetime=rlifetime)
+            answer = resolver.resolve(
+                name, dns.rdatatype.SOA, rdclass, tcp, lifetime=rlifetime
+            )
+            assert answer.rrset is not None
             if answer.rrset.name == name:
                 return name
             # otherwise we were CNAMEd or DNAMEd and need to look higher
@@ -1289,8 +1498,7 @@ def zone_for_name(name, rdclass=dns.rdataclass.IN, tcp=False, resolver=None,
                 response = e.response()  # pylint: disable=no-value-for-parameter
             if response:
                 for rrs in response.authority:
-                    if rrs.rdtype == dns.rdatatype.SOA and \
-                        rrs.rdclass == rdclass:
+                    if rrs.rdtype == dns.rdatatype.SOA and rrs.rdclass == rdclass:
                         (nr, _, _) = rrs.name.fullcompare(name)
                         if nr == dns.name.NAMERELN_SUPERDOMAIN:
                             # We're doing a proper superdomain check as
@@ -1307,6 +1515,7 @@ def zone_for_name(name, rdclass=dns.rdataclass.IN, tcp=False, resolver=None,
         except dns.name.NoParent:
             raise NoRootSOA
 
+
 #
 # Support for overriding the system resolver for all python code in the
 # running process.
@@ -1326,16 +1535,16 @@ _original_gethostbyname_ex = socket.gethostbyname_ex
 _original_gethostbyaddr = socket.gethostbyaddr
 
 
-def _getaddrinfo(host=None, service=None, family=socket.AF_UNSPEC, socktype=0,
-                 proto=0, flags=0):
+def _getaddrinfo(
+    host=None, service=None, family=socket.AF_UNSPEC, socktype=0, proto=0, flags=0
+):
     if flags & socket.AI_NUMERICHOST != 0:
         # Short circuit directly into the system's getaddrinfo().  We're
         # not adding any value in this case, and this avoids infinite loops
         # because dns.query.* needs to call getaddrinfo() for IPv6 scoping
         # reasons.  We will also do this short circuit below if we
         # discover that the host is an address literal.
-        return _original_getaddrinfo(host, service, family, socktype, proto,
-                                     flags)
+        return _original_getaddrinfo(host, service, family, socktype, proto, flags)
     if flags & (socket.AI_ADDRCONFIG | socket.AI_V4MAPPED) != 0:
         # Not implemented.  We raise a gaierror as opposed to a
         # NotImplementedError as it helps callers handle errors more
@@ -1345,55 +1554,53 @@ def _getaddrinfo(host=None, service=None, family=socket.AF_UNSPEC, socktype=0,
         # no EAI_SYSTEM on Windows [Issue #416].  We didn't go for
         # EAI_BADFLAGS as the flags aren't bad, we just don't
         # implement them.
-        raise socket.gaierror(socket.EAI_FAIL,
-                              'Non-recoverable failure in name resolution')
+        raise socket.gaierror(
+            socket.EAI_FAIL, "Non-recoverable failure in name resolution"
+        )
     if host is None and service is None:
-        raise socket.gaierror(socket.EAI_NONAME, 'Name or service not known')
+        raise socket.gaierror(socket.EAI_NONAME, "Name or service not known")
     v6addrs = []
     v4addrs = []
     canonical_name = None  # pylint: disable=redefined-outer-name
     # Is host None or an address literal?  If so, use the system's
     # getaddrinfo().
     if host is None:
-        return _original_getaddrinfo(host, service, family, socktype,
-                                     proto, flags)
+        return _original_getaddrinfo(host, service, family, socktype, proto, flags)
     try:
         # We don't care about the result of af_for_address(), we're just
         # calling it so it raises an exception if host is not an IPv4 or
         # IPv6 address.
         dns.inet.af_for_address(host)
-        return _original_getaddrinfo(host, service, family, socktype,
-                                     proto, flags)
+        return _original_getaddrinfo(host, service, family, socktype, proto, flags)
     except Exception:
         pass
     # Something needs resolution!
     try:
         if family == socket.AF_INET6 or family == socket.AF_UNSPEC:
-            v6 = _resolver.resolve(host, dns.rdatatype.AAAA,
-                                   raise_on_no_answer=False)
+            v6 = _resolver.resolve(host, dns.rdatatype.AAAA, raise_on_no_answer=False)
             # Note that setting host ensures we query the same name
-            # for A as we did for AAAA.
+            # for A as we did for AAAA.  (This is just in case search lists
+            # are active by default in the resolver configuration and
+            # we might be talking to a server that says NXDOMAIN when it
+            # wants to say NOERROR no data.
             host = v6.qname
             canonical_name = v6.canonical_name.to_text(True)
             if v6.rrset is not None:
                 for rdata in v6.rrset:
                     v6addrs.append(rdata.address)
         if family == socket.AF_INET or family == socket.AF_UNSPEC:
-            v4 = _resolver.resolve(host, dns.rdatatype.A,
-                                   raise_on_no_answer=False)
-            host = v4.qname
+            v4 = _resolver.resolve(host, dns.rdatatype.A, raise_on_no_answer=False)
             canonical_name = v4.canonical_name.to_text(True)
             if v4.rrset is not None:
                 for rdata in v4.rrset:
                     v4addrs.append(rdata.address)
     except dns.resolver.NXDOMAIN:
-        raise socket.gaierror(socket.EAI_NONAME, 'Name or service not known')
+        raise socket.gaierror(socket.EAI_NONAME, "Name or service not known")
     except Exception:
         # We raise EAI_AGAIN here as the failure may be temporary
         # (e.g. a timeout) and EAI_SYSTEM isn't defined on Windows.
         # [Issue #416]
-        raise socket.gaierror(socket.EAI_AGAIN,
-                              'Temporary failure in name resolution')
+        raise socket.gaierror(socket.EAI_AGAIN, "Temporary failure in name resolution")
     port = None
     try:
         # Is it a port literal?
@@ -1408,7 +1615,7 @@ def _getaddrinfo(host=None, service=None, family=socket.AF_UNSPEC, socktype=0,
             except Exception:
                 pass
     if port is None:
-        raise socket.gaierror(socket.EAI_NONAME, 'Name or service not known')
+        raise socket.gaierror(socket.EAI_NONAME, "Name or service not known")
     tuples = []
     if socktype == 0:
         socktypes = [socket.SOCK_DGRAM, socket.SOCK_STREAM]
@@ -1417,21 +1624,23 @@ def _getaddrinfo(host=None, service=None, family=socket.AF_UNSPEC, socktype=0,
     if flags & socket.AI_CANONNAME != 0:
         cname = canonical_name
     else:
-        cname = ''
+        cname = ""
     if family == socket.AF_INET6 or family == socket.AF_UNSPEC:
         for addr in v6addrs:
             for socktype in socktypes:
                 for proto in _protocols_for_socktype[socktype]:
-                    tuples.append((socket.AF_INET6, socktype, proto,
-                                   cname, (addr, port, 0, 0)))
+                    tuples.append(
+                        (socket.AF_INET6, socktype, proto, cname, (addr, port, 0, 0))
+                    )
     if family == socket.AF_INET or family == socket.AF_UNSPEC:
         for addr in v4addrs:
             for socktype in socktypes:
                 for proto in _protocols_for_socktype[socktype]:
-                    tuples.append((socket.AF_INET, socktype, proto,
-                                   cname, (addr, port)))
+                    tuples.append(
+                        (socket.AF_INET, socktype, proto, cname, (addr, port))
+                    )
     if len(tuples) == 0:
-        raise socket.gaierror(socket.EAI_NONAME, 'Name or service not known')
+        raise socket.gaierror(socket.EAI_NONAME, "Name or service not known")
     return tuples
 
 
@@ -1444,31 +1653,29 @@ def _getnameinfo(sockaddr, flags=0):
     else:
         scope = None
         family = socket.AF_INET
-    tuples = _getaddrinfo(host, port, family, socket.SOCK_STREAM,
-                          socket.SOL_TCP, 0)
+    tuples = _getaddrinfo(host, port, family, socket.SOCK_STREAM, socket.SOL_TCP, 0)
     if len(tuples) > 1:
-        raise socket.error('sockaddr resolved to multiple addresses')
+        raise socket.error("sockaddr resolved to multiple addresses")
     addr = tuples[0][4][0]
     if flags & socket.NI_DGRAM:
-        pname = 'udp'
+        pname = "udp"
     else:
-        pname = 'tcp'
+        pname = "tcp"
     qname = dns.reversename.from_address(addr)
     if flags & socket.NI_NUMERICHOST == 0:
         try:
-            answer = _resolver.resolve(qname, 'PTR')
+            answer = _resolver.resolve(qname, "PTR")
             hostname = answer.rrset[0].target.to_text(True)
         except (dns.resolver.NXDOMAIN, dns.resolver.NoAnswer):
             if flags & socket.NI_NAMEREQD:
-                raise socket.gaierror(socket.EAI_NONAME,
-                                      'Name or service not known')
+                raise socket.gaierror(socket.EAI_NONAME, "Name or service not known")
             hostname = addr
             if scope is not None:
-                hostname += '%' + str(scope)
+                hostname += "%" + str(scope)
     else:
         hostname = addr
         if scope is not None:
-            hostname += '%' + str(scope)
+            hostname += "%" + str(scope)
     if flags & socket.NI_NUMERICSERV:
         service = str(port)
     else:
@@ -1495,8 +1702,9 @@ def _gethostbyname(name):
 def _gethostbyname_ex(name):
     aliases = []
     addresses = []
-    tuples = _getaddrinfo(name, 0, socket.AF_INET, socket.SOCK_STREAM,
-                          socket.SOL_TCP, socket.AI_CANONNAME)
+    tuples = _getaddrinfo(
+        name, 0, socket.AF_INET, socket.SOCK_STREAM, socket.SOL_TCP, socket.AI_CANONNAME
+    )
     canonical = tuples[0][3]
     for item in tuples:
         addresses.append(item[4][0])
@@ -1513,15 +1721,15 @@ def _gethostbyaddr(ip):
         try:
             dns.ipv4.inet_aton(ip)
         except Exception:
-            raise socket.gaierror(socket.EAI_NONAME,
-                                  'Name or service not known')
+            raise socket.gaierror(socket.EAI_NONAME, "Name or service not known")
         sockaddr = (ip, 80)
         family = socket.AF_INET
     (name, _) = _getnameinfo(sockaddr, socket.NI_NAMEREQD)
     aliases = []
     addresses = []
-    tuples = _getaddrinfo(name, 0, family, socket.SOCK_STREAM, socket.SOL_TCP,
-                          socket.AI_CANONNAME)
+    tuples = _getaddrinfo(
+        name, 0, family, socket.SOCK_STREAM, socket.SOL_TCP, socket.AI_CANONNAME
+    )
     canonical = tuples[0][3]
     # We only want to include an address from the tuples if it's the
     # same as the one we asked about.  We do this comparison in binary
@@ -1536,7 +1744,7 @@ def _gethostbyaddr(ip):
     return (canonical, aliases, addresses)
 
 
-def override_system_resolver(resolver=None):
+def override_system_resolver(resolver: Optional[Resolver] = None) -> None:
     """Override the system resolver routines in the socket module with
     versions which use dnspython's resolver.
 
@@ -1562,7 +1770,7 @@ def override_system_resolver(resolver=None):
     socket.gethostbyaddr = _gethostbyaddr
 
 
-def restore_system_resolver():
+def restore_system_resolver() -> None:
     """Undo the effects of prior override_system_resolver()."""
 
     global _resolver
diff --git a/lib/dns/resolver.pyi b/lib/dns/resolver.pyi
deleted file mode 100644
index 348df4da..00000000
--- a/lib/dns/resolver.pyi
+++ /dev/null
@@ -1,66 +0,0 @@
-from typing import Union, Optional, List, Any, Dict
-from . import exception, rdataclass, name, rdatatype
-
-import socket
-_gethostbyname = socket.gethostbyname
-
-class NXDOMAIN(exception.DNSException): ...
-class YXDOMAIN(exception.DNSException): ...
-class NoAnswer(exception.DNSException): ...
-class NoNameservers(exception.DNSException): ...
-class NotAbsolute(exception.DNSException): ...
-class NoRootSOA(exception.DNSException): ...
-class NoMetaqueries(exception.DNSException): ...
-class NoResolverConfiguration(exception.DNSException): ...
-Timeout = exception.Timeout
-
-def resolve(qname : str, rdtype : Union[int,str] = 0,
-            rdclass : Union[int,str] = 0,
-            tcp=False, source=None, raise_on_no_answer=True,
-            source_port=0, lifetime : Optional[float]=None,
-            search : Optional[bool]=None):
-    ...
-def query(qname : str, rdtype : Union[int,str] = 0,
-          rdclass : Union[int,str] = 0,
-          tcp=False, source=None, raise_on_no_answer=True,
-          source_port=0, lifetime : Optional[float]=None):
-    ...
-def resolve_address(ipaddr: str, *args: Any, **kwargs: Optional[Dict]):
-    ...
-class LRUCache:
-    def __init__(self, max_size=1000):
-        ...
-    def get(self, key):
-        ...
-    def put(self, key, val):
-        ...
-class Answer:
-    def __init__(self, qname, rdtype, rdclass, response,
-                 raise_on_no_answer=True):
-        ...
-def zone_for_name(name, rdclass : int = rdataclass.IN, tcp=False,
-                  resolver : Optional[Resolver] = None):
-    ...
-
-class Resolver:
-    def __init__(self, filename : Optional[str] = '/etc/resolv.conf',
-                 configure : Optional[bool] = True):
-        self.nameservers : List[str]
-    def resolve(self, qname : str, rdtype : Union[int,str] = rdatatype.A,
-                rdclass : Union[int,str] = rdataclass.IN,
-                tcp : bool = False, source : Optional[str] = None,
-                raise_on_no_answer=True, source_port : int = 0,
-                lifetime : Optional[float]=None,
-                search : Optional[bool]=None):
-        ...
-    def query(self, qname : str, rdtype : Union[int,str] = rdatatype.A,
-              rdclass : Union[int,str] = rdataclass.IN,
-              tcp : bool = False, source : Optional[str] = None,
-              raise_on_no_answer=True, source_port : int = 0,
-              lifetime : Optional[float]=None):
-        ...
-default_resolver: typing.Optional[Resolver]
-def reset_default_resolver() -> None:
-    ...
-def get_default_resolver() -> Resolver:
-    ...
diff --git a/lib/dns/reversename.py b/lib/dns/reversename.py
index e0beb03d..eb6a3b6b 100644
--- a/lib/dns/reversename.py
+++ b/lib/dns/reversename.py
@@ -23,12 +23,15 @@ import dns.name
 import dns.ipv6
 import dns.ipv4
 
-ipv4_reverse_domain = dns.name.from_text('in-addr.arpa.')
-ipv6_reverse_domain = dns.name.from_text('ip6.arpa.')
+ipv4_reverse_domain = dns.name.from_text("in-addr.arpa.")
+ipv6_reverse_domain = dns.name.from_text("ip6.arpa.")
 
 
-def from_address(text, v4_origin=ipv4_reverse_domain,
-                 v6_origin=ipv6_reverse_domain):
+def from_address(
+    text: str,
+    v4_origin: dns.name.Name = ipv4_reverse_domain,
+    v6_origin: dns.name.Name = ipv6_reverse_domain,
+) -> dns.name.Name:
     """Convert an IPv4 or IPv6 address in textual form into a Name object whose
     value is the reverse-map domain name of the address.
 
@@ -51,20 +54,22 @@ def from_address(text, v4_origin=ipv4_reverse_domain,
     try:
         v6 = dns.ipv6.inet_aton(text)
         if dns.ipv6.is_mapped(v6):
-            parts = ['%d' % byte for byte in v6[12:]]
+            parts = ["%d" % byte for byte in v6[12:]]
             origin = v4_origin
         else:
             parts = [x for x in str(binascii.hexlify(v6).decode())]
             origin = v6_origin
     except Exception:
-        parts = ['%d' %
-                 byte for byte in dns.ipv4.inet_aton(text)]
+        parts = ["%d" % byte for byte in dns.ipv4.inet_aton(text)]
         origin = v4_origin
-    return dns.name.from_text('.'.join(reversed(parts)), origin=origin)
+    return dns.name.from_text(".".join(reversed(parts)), origin=origin)
 
 
-def to_address(name, v4_origin=ipv4_reverse_domain,
-               v6_origin=ipv6_reverse_domain):
+def to_address(
+    name: dns.name.Name,
+    v4_origin: dns.name.Name = ipv4_reverse_domain,
+    v6_origin: dns.name.Name = ipv6_reverse_domain,
+) -> str:
     """Convert a reverse map domain name into textual address form.
 
     *name*, a ``dns.name.Name``, an IPv4 or IPv6 address in reverse-map name
@@ -84,7 +89,7 @@ def to_address(name, v4_origin=ipv4_reverse_domain,
 
     if name.is_subdomain(v4_origin):
         name = name.relativize(v4_origin)
-        text = b'.'.join(reversed(name.labels))
+        text = b".".join(reversed(name.labels))
         # run through inet_ntoa() to check syntax and make pretty.
         return dns.ipv4.inet_ntoa(dns.ipv4.inet_aton(text))
     elif name.is_subdomain(v6_origin):
@@ -92,9 +97,9 @@ def to_address(name, v4_origin=ipv4_reverse_domain,
         labels = list(reversed(name.labels))
         parts = []
         for i in range(0, len(labels), 4):
-            parts.append(b''.join(labels[i:i + 4]))
-        text = b':'.join(parts)
+            parts.append(b"".join(labels[i : i + 4]))
+        text = b":".join(parts)
         # run through inet_ntoa() to check syntax and make pretty.
         return dns.ipv6.inet_ntoa(dns.ipv6.inet_aton(text))
     else:
-        raise dns.exception.SyntaxError('unknown reverse-map address family')
+        raise dns.exception.SyntaxError("unknown reverse-map address family")
diff --git a/lib/dns/reversename.pyi b/lib/dns/reversename.pyi
deleted file mode 100644
index 97f072ea..00000000
--- a/lib/dns/reversename.pyi
+++ /dev/null
@@ -1,6 +0,0 @@
-from . import name
-def from_address(text : str) -> name.Name:
-    ...
-
-def to_address(name : name.Name) -> str:
-    ...
diff --git a/lib/dns/rrset.py b/lib/dns/rrset.py
index a71d4573..3f22a90c 100644
--- a/lib/dns/rrset.py
+++ b/lib/dns/rrset.py
@@ -17,6 +17,7 @@
 
 """DNS RRsets (an RRset is a named rdataset)"""
 
+from typing import Any, cast, Collection, Dict, Optional, Union
 
 import dns.name
 import dns.rdataset
@@ -35,10 +36,16 @@ class RRset(dns.rdataset.Rdataset):
     name.
     """
 
-    __slots__ = ['name', 'deleting']
+    __slots__ = ["name", "deleting"]
 
-    def __init__(self, name, rdclass, rdtype, covers=dns.rdatatype.NONE,
-                 deleting=None):
+    def __init__(
+        self,
+        name: dns.name.Name,
+        rdclass: dns.rdataclass.RdataClass,
+        rdtype: dns.rdatatype.RdataType,
+        covers: dns.rdatatype.RdataType = dns.rdatatype.NONE,
+        deleting: Optional[dns.rdataclass.RdataClass] = None,
+    ):
         """Create a new RRset."""
 
         super().__init__(rdclass, rdtype, covers)
@@ -53,17 +60,26 @@ class RRset(dns.rdataset.Rdataset):
 
     def __repr__(self):
         if self.covers == 0:
-            ctext = ''
+            ctext = ""
         else:
-            ctext = '(' + dns.rdatatype.to_text(self.covers) + ')'
+            ctext = "(" + dns.rdatatype.to_text(self.covers) + ")"
         if self.deleting is not None:
-            dtext = ' delete=' + dns.rdataclass.to_text(self.deleting)
+            dtext = " delete=" + dns.rdataclass.to_text(self.deleting)
         else:
-            dtext = ''
-        return '<DNS ' + str(self.name) + ' ' + \
-               dns.rdataclass.to_text(self.rdclass) + ' ' + \
-               dns.rdatatype.to_text(self.rdtype) + ctext + dtext + \
-               ' RRset: ' + self._rdata_repr() + '>'
+            dtext = ""
+        return (
+            "<DNS "
+            + str(self.name)
+            + " "
+            + dns.rdataclass.to_text(self.rdclass)
+            + " "
+            + dns.rdatatype.to_text(self.rdtype)
+            + ctext
+            + dtext
+            + " RRset: "
+            + self._rdata_repr()
+            + ">"
+        )
 
     def __str__(self):
         return self.to_text()
@@ -76,7 +92,7 @@ class RRset(dns.rdataset.Rdataset):
             return False
         return super().__eq__(other)
 
-    def match(self, *args, **kwargs):
+    def match(self, *args: Any, **kwargs: Any) -> bool:  # type: ignore[override]
         """Does this rrset match the specified attributes?
 
         Behaves as :py:func:`full_match()` if the first argument is a
@@ -89,12 +105,18 @@ class RRset(dns.rdataset.Rdataset):
         compatibility.)
         """
         if isinstance(args[0], dns.name.Name):
-            return self.full_match(*args, **kwargs)
+            return self.full_match(*args, **kwargs)  # type: ignore[arg-type]
         else:
-            return super().match(*args, **kwargs)
+            return super().match(*args, **kwargs)  # type: ignore[arg-type]
 
-    def full_match(self, name, rdclass, rdtype, covers,
-                    deleting=None):
+    def full_match(
+        self,
+        name: dns.name.Name,
+        rdclass: dns.rdataclass.RdataClass,
+        rdtype: dns.rdatatype.RdataType,
+        covers: dns.rdatatype.RdataType,
+        deleting: Optional[dns.rdataclass.RdataClass] = None,
+    ) -> bool:
         """Returns ``True`` if this rrset matches the specified name, class,
         type, covers, and deletion state.
         """
@@ -106,7 +128,12 @@ class RRset(dns.rdataset.Rdataset):
 
     # pylint: disable=arguments-differ
 
-    def to_text(self, origin=None, relativize=True, **kw):
+    def to_text(  # type: ignore[override]
+        self,
+        origin: Optional[dns.name.Name] = None,
+        relativize: bool = True,
+        **kw: Dict[str, Any]
+    ) -> str:
         """Convert the RRset into DNS zone file format.
 
         See ``dns.name.Name.choose_relativity`` for more information
@@ -123,11 +150,17 @@ class RRset(dns.rdataset.Rdataset):
         to *origin*.
         """
 
-        return super().to_text(self.name, origin, relativize,
-                               self.deleting, **kw)
+        return super().to_text(
+            self.name, origin, relativize, self.deleting, **kw  # type: ignore
+        )
 
-    def to_wire(self, file, compress=None, origin=None,
-                **kw):
+    def to_wire(  # type: ignore[override]
+        self,
+        file: Any,
+        compress: Optional[dns.name.CompressType] = None,  # type: ignore
+        origin: Optional[dns.name.Name] = None,
+        **kw: Dict[str, Any]
+    ) -> int:
         """Convert the RRset to wire format.
 
         All keyword arguments are passed to ``dns.rdataset.to_wire()``; see
@@ -136,12 +169,13 @@ class RRset(dns.rdataset.Rdataset):
         Returns an ``int``, the number of records emitted.
         """
 
-        return super().to_wire(self.name, file, compress, origin,
-                               self.deleting, **kw)
+        return super().to_wire(
+            self.name, file, compress, origin, self.deleting, **kw  # type:ignore
+        )
 
     # pylint: enable=arguments-differ
 
-    def to_rdataset(self):
+    def to_rdataset(self) -> dns.rdataset.Rdataset:
         """Convert an RRset into an Rdataset.
 
         Returns a ``dns.rdataset.Rdataset``.
@@ -149,9 +183,17 @@ class RRset(dns.rdataset.Rdataset):
         return dns.rdataset.from_rdata_list(self.ttl, list(self))
 
 
-def from_text_list(name, ttl, rdclass, rdtype, text_rdatas,
-                   idna_codec=None, origin=None, relativize=True,
-                   relativize_to=None):
+def from_text_list(
+    name: Union[dns.name.Name, str],
+    ttl: int,
+    rdclass: Union[dns.rdataclass.RdataClass, str],
+    rdtype: Union[dns.rdatatype.RdataType, str],
+    text_rdatas: Collection[str],
+    idna_codec: Optional[dns.name.IDNACodec] = None,
+    origin: Optional[dns.name.Name] = None,
+    relativize: bool = True,
+    relativize_to: Optional[dns.name.Name] = None,
+) -> RRset:
     """Create an RRset with the specified name, TTL, class, and type, and with
     the specified list of rdatas in text format.
 
@@ -172,28 +214,42 @@ def from_text_list(name, ttl, rdclass, rdtype, text_rdatas,
 
     if isinstance(name, str):
         name = dns.name.from_text(name, None, idna_codec=idna_codec)
-    rdclass = dns.rdataclass.RdataClass.make(rdclass)
-    rdtype = dns.rdatatype.RdataType.make(rdtype)
-    r = RRset(name, rdclass, rdtype)
+    the_rdclass = dns.rdataclass.RdataClass.make(rdclass)
+    the_rdtype = dns.rdatatype.RdataType.make(rdtype)
+    r = RRset(name, the_rdclass, the_rdtype)
     r.update_ttl(ttl)
     for t in text_rdatas:
-        rd = dns.rdata.from_text(r.rdclass, r.rdtype, t, origin, relativize,
-                                 relativize_to, idna_codec)
+        rd = dns.rdata.from_text(
+            r.rdclass, r.rdtype, t, origin, relativize, relativize_to, idna_codec
+        )
         r.add(rd)
     return r
 
 
-def from_text(name, ttl, rdclass, rdtype, *text_rdatas):
+def from_text(
+    name: Union[dns.name.Name, str],
+    ttl: int,
+    rdclass: Union[dns.rdataclass.RdataClass, str],
+    rdtype: Union[dns.rdatatype.RdataType, str],
+    *text_rdatas: Any
+) -> RRset:
     """Create an RRset with the specified name, TTL, class, and type and with
     the specified rdatas in text format.
 
     Returns a ``dns.rrset.RRset`` object.
     """
 
-    return from_text_list(name, ttl, rdclass, rdtype, text_rdatas)
+    return from_text_list(
+        name, ttl, rdclass, rdtype, cast(Collection[str], text_rdatas)
+    )
 
 
-def from_rdata_list(name, ttl, rdatas, idna_codec=None):
+def from_rdata_list(
+    name: Union[dns.name.Name, str],
+    ttl: int,
+    rdatas: Collection[dns.rdata.Rdata],
+    idna_codec: Optional[dns.name.IDNACodec] = None,
+) -> RRset:
     """Create an RRset with the specified name and TTL, and with
     the specified list of rdata objects.
 
@@ -216,14 +272,15 @@ def from_rdata_list(name, ttl, rdatas, idna_codec=None):
             r = RRset(name, rd.rdclass, rd.rdtype)
             r.update_ttl(ttl)
         r.add(rd)
+    assert r is not None
     return r
 
 
-def from_rdata(name, ttl, *rdatas):
+def from_rdata(name: Union[dns.name.Name, str], ttl: int, *rdatas: Any) -> RRset:
     """Create an RRset with the specified name and TTL, and with
     the specified rdata objects.
 
     Returns a ``dns.rrset.RRset`` object.
     """
 
-    return from_rdata_list(name, ttl, rdatas)
+    return from_rdata_list(name, ttl, cast(Collection[dns.rdata.Rdata], rdatas))
diff --git a/lib/dns/rrset.pyi b/lib/dns/rrset.pyi
deleted file mode 100644
index 0a81a2a0..00000000
--- a/lib/dns/rrset.pyi
+++ /dev/null
@@ -1,10 +0,0 @@
-from typing import List, Optional
-from . import rdataset, rdatatype
-
-class RRset(rdataset.Rdataset):
-    def __init__(self, name, rdclass : int , rdtype : int, covers=rdatatype.NONE,
-                 deleting : Optional[int] =None) -> None:
-        self.name = name
-        self.deleting = deleting
-def from_text(name : str, ttl : int, rdclass : str, rdtype : str, *text_rdatas : str):
-    ...
diff --git a/lib/dns/serial.py b/lib/dns/serial.py
index b0474151..3417299b 100644
--- a/lib/dns/serial.py
+++ b/lib/dns/serial.py
@@ -2,13 +2,14 @@
 
 """Serial Number Arthimetic from RFC 1982"""
 
+
 class Serial:
-    def __init__(self, value, bits=32):
-        self.value = value % 2 ** bits
+    def __init__(self, value: int, bits: int = 32):
+        self.value = value % 2**bits
         self.bits = bits
 
     def __repr__(self):
-        return f'dns.serial.Serial({self.value}, {self.bits})'
+        return f"dns.serial.Serial({self.value}, {self.bits})"
 
     def __eq__(self, other):
         if isinstance(other, int):
@@ -29,11 +30,11 @@ class Serial:
             other = Serial(other, self.bits)
         elif not isinstance(other, Serial) or other.bits != self.bits:
             return NotImplemented
-        if self.value < other.value and \
-           other.value - self.value < 2 ** (self.bits - 1):
+        if self.value < other.value and other.value - self.value < 2 ** (self.bits - 1):
             return True
-        elif self.value > other.value and \
-             self.value - other.value > 2 ** (self.bits - 1):
+        elif self.value > other.value and self.value - other.value > 2 ** (
+            self.bits - 1
+        ):
             return True
         else:
             return False
@@ -46,11 +47,11 @@ class Serial:
             other = Serial(other, self.bits)
         elif not isinstance(other, Serial) or other.bits != self.bits:
             return NotImplemented
-        if self.value < other.value and \
-           other.value - self.value > 2 ** (self.bits - 1):
+        if self.value < other.value and other.value - self.value > 2 ** (self.bits - 1):
             return True
-        elif self.value > other.value and \
-             self.value - other.value < 2 ** (self.bits - 1):
+        elif self.value > other.value and self.value - other.value < 2 ** (
+            self.bits - 1
+        ):
             return True
         else:
             return False
@@ -69,7 +70,7 @@ class Serial:
         if abs(delta) > (2 ** (self.bits - 1) - 1):
             raise ValueError
         v += delta
-        v = v % 2 ** self.bits
+        v = v % 2**self.bits
         return Serial(v, self.bits)
 
     def __iadd__(self, other):
@@ -83,7 +84,7 @@ class Serial:
         if abs(delta) > (2 ** (self.bits - 1) - 1):
             raise ValueError
         v += delta
-        v = v % 2 ** self.bits
+        v = v % 2**self.bits
         self.value = v
         return self
 
@@ -98,7 +99,7 @@ class Serial:
         if abs(delta) > (2 ** (self.bits - 1) - 1):
             raise ValueError
         v -= delta
-        v = v % 2 ** self.bits
+        v = v % 2**self.bits
         return Serial(v, self.bits)
 
     def __isub__(self, other):
@@ -112,6 +113,6 @@ class Serial:
         if abs(delta) > (2 ** (self.bits - 1) - 1):
             raise ValueError
         v -= delta
-        v = v % 2 ** self.bits
+        v = v % 2**self.bits
         self.value = v
         return self
diff --git a/lib/dns/set.py b/lib/dns/set.py
index 1fd4d0ae..fa50ed97 100644
--- a/lib/dns/set.py
+++ b/lib/dns/set.py
@@ -16,12 +16,7 @@
 # OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 
 import itertools
-import sys
 
-if sys.version_info >= (3, 7):
-    odict = dict
-else:
-    from collections import OrderedDict as odict  # pragma: no cover
 
 class Set:
 
@@ -33,7 +28,7 @@ class Set:
     ability is widely used in dnspython applications.
     """
 
-    __slots__ = ['items']
+    __slots__ = ["items"]
 
     def __init__(self, items=None):
         """Initialize the set.
@@ -41,24 +36,24 @@ class Set:
         *items*, an iterable or ``None``, the initial set of items.
         """
 
-        self.items = odict()
+        self.items = dict()
         if items is not None:
             for item in items:
-                self.add(item)
+                # This is safe for how we use set, but if other code
+                # subclasses it could be a legitimate issue.
+                self.add(item)  # lgtm[py/init-calls-subclass]
 
     def __repr__(self):
         return "dns.set.Set(%s)" % repr(list(self.items.keys()))
 
     def add(self, item):
-        """Add an item to the set.
-        """
+        """Add an item to the set."""
 
         if item not in self.items:
             self.items[item] = None
 
     def remove(self, item):
-        """Remove an item from the set.
-        """
+        """Remove an item from the set."""
 
         try:
             del self.items[item]
@@ -66,12 +61,16 @@ class Set:
             raise ValueError
 
     def discard(self, item):
-        """Remove an item from the set if present.
-        """
+        """Remove an item from the set if present."""
 
         self.items.pop(item, None)
 
-    def _clone(self):
+    def pop(self):
+        """Remove an arbitrary item from the set."""
+        (k, _) = self.items.popitem()
+        return k
+
+    def _clone(self) -> "Set":
         """Make a (shallow) copy of the set.
 
         There is a 'clone protocol' that subclasses of this class
@@ -84,24 +83,22 @@ class Set:
         subclasses.
         """
 
-        if hasattr(self, '_clone_class'):
-            cls = self._clone_class
+        if hasattr(self, "_clone_class"):
+            cls = self._clone_class  # type: ignore
         else:
             cls = self.__class__
         obj = cls.__new__(cls)
-        obj.items = odict()
+        obj.items = dict()
         obj.items.update(self.items)
         return obj
 
     def __copy__(self):
-        """Make a (shallow) copy of the set.
-        """
+        """Make a (shallow) copy of the set."""
 
         return self._clone()
 
     def copy(self):
-        """Make a (shallow) copy of the set.
-        """
+        """Make a (shallow) copy of the set."""
 
         return self._clone()
 
@@ -111,8 +108,8 @@ class Set:
         """
 
         if not isinstance(other, Set):
-            raise ValueError('other must be a Set instance')
-        if self is other:
+            raise ValueError("other must be a Set instance")
+        if self is other:  # lgtm[py/comparison-using-is]
             return
         for item in other.items:
             self.add(item)
@@ -123,8 +120,8 @@ class Set:
         """
 
         if not isinstance(other, Set):
-            raise ValueError('other must be a Set instance')
-        if self is other:
+            raise ValueError("other must be a Set instance")
+        if self is other:  # lgtm[py/comparison-using-is]
             return
         # we make a copy of the list so that we can remove items from
         # the list without breaking the iterator.
@@ -138,13 +135,25 @@ class Set:
         """
 
         if not isinstance(other, Set):
-            raise ValueError('other must be a Set instance')
-        if self is other:
+            raise ValueError("other must be a Set instance")
+        if self is other:  # lgtm[py/comparison-using-is]
             self.items.clear()
         else:
             for item in other.items:
                 self.discard(item)
 
+    def symmetric_difference_update(self, other):
+        """Update the set, retaining only elements unique to both sets."""
+
+        if not isinstance(other, Set):
+            raise ValueError("other must be a Set instance")
+        if self is other:  # lgtm[py/comparison-using-is]
+            self.items.clear()
+        else:
+            overlap = self.intersection(other)
+            self.union_update(other)
+            self.difference_update(overlap)
+
     def union(self, other):
         """Return a new set which is the union of ``self`` and ``other``.
 
@@ -177,6 +186,18 @@ class Set:
         obj.difference_update(other)
         return obj
 
+    def symmetric_difference(self, other):
+        """Return a new set which (``self`` - ``other``) | (``other``
+        - ``self), ie: the items in either ``self`` or ``other`` which
+        are not contained in their intersection.
+
+        Returns the same Set type as this set.
+        """
+
+        obj = self._clone()
+        obj.symmetric_difference_update(other)
+        return obj
+
     def __or__(self, other):
         return self.union(other)
 
@@ -189,6 +210,9 @@ class Set:
     def __sub__(self, other):
         return self.difference(other)
 
+    def __xor__(self, other):
+        return self.symmetric_difference(other)
+
     def __ior__(self, other):
         self.union_update(other)
         return self
@@ -205,6 +229,10 @@ class Set:
         self.difference_update(other)
         return self
 
+    def __ixor__(self, other):
+        self.symmetric_difference_update(other)
+        return self
+
     def update(self, other):
         """Update the set, adding any elements from other which are not
         already in the set.
@@ -221,13 +249,7 @@ class Set:
         self.items.clear()
 
     def __eq__(self, other):
-        if odict == dict:
-            return self.items == other.items
-        else:
-            # We don't want an ordered comparison.
-            if len(self.items) != len(other.items):
-                return False
-            return all(elt in other.items for elt in self.items)
+        return self.items == other.items
 
     def __ne__(self, other):
         return not self.__eq__(other)
@@ -258,7 +280,7 @@ class Set:
         """
 
         if not isinstance(other, Set):
-            raise ValueError('other must be a Set instance')
+            raise ValueError("other must be a Set instance")
         for item in self.items:
             if item not in other.items:
                 return False
@@ -271,8 +293,16 @@ class Set:
         """
 
         if not isinstance(other, Set):
-            raise ValueError('other must be a Set instance')
+            raise ValueError("other must be a Set instance")
         for item in other.items:
             if item not in self.items:
                 return False
         return True
+
+    def isdisjoint(self, other):
+        if not isinstance(other, Set):
+            raise ValueError("other must be a Set instance")
+        for item in other.items:
+            if item in self.items:
+                return False
+        return True
diff --git a/lib/dns/tokenizer.py b/lib/dns/tokenizer.py
index cb6a6302..0551578a 100644
--- a/lib/dns/tokenizer.py
+++ b/lib/dns/tokenizer.py
@@ -17,6 +17,8 @@
 
 """Tokenize DNS zone file format"""
 
+from typing import Any, Optional, List, Tuple
+
 import io
 import sys
 
@@ -24,7 +26,7 @@ import dns.exception
 import dns.name
 import dns.ttl
 
-_DELIMITERS = {' ', '\t', '\n', ';', '(', ')', '"'}
+_DELIMITERS = {" ", "\t", "\n", ";", "(", ")", '"'}
 _QUOTING_DELIMITERS = {'"'}
 
 EOF = 0
@@ -48,7 +50,13 @@ class Token:
     has_escape: Does the token value contain escapes?
     """
 
-    def __init__(self, ttype, value='', has_escape=False, comment=None):
+    def __init__(
+        self,
+        ttype: int,
+        value: Any = "",
+        has_escape: bool = False,
+        comment: Optional[str] = None,
+    ):
         """Initialize a token instance."""
 
         self.ttype = ttype
@@ -56,55 +64,53 @@ class Token:
         self.has_escape = has_escape
         self.comment = comment
 
-    def is_eof(self):
+    def is_eof(self) -> bool:
         return self.ttype == EOF
 
-    def is_eol(self):
+    def is_eol(self) -> bool:
         return self.ttype == EOL
 
-    def is_whitespace(self):
+    def is_whitespace(self) -> bool:
         return self.ttype == WHITESPACE
 
-    def is_identifier(self):
+    def is_identifier(self) -> bool:
         return self.ttype == IDENTIFIER
 
-    def is_quoted_string(self):
+    def is_quoted_string(self) -> bool:
         return self.ttype == QUOTED_STRING
 
-    def is_comment(self):
+    def is_comment(self) -> bool:
         return self.ttype == COMMENT
 
-    def is_delimiter(self):  # pragma: no cover (we don't return delimiters yet)
+    def is_delimiter(self) -> bool:  # pragma: no cover (we don't return delimiters yet)
         return self.ttype == DELIMITER
 
-    def is_eol_or_eof(self):
+    def is_eol_or_eof(self) -> bool:
         return self.ttype == EOL or self.ttype == EOF
 
     def __eq__(self, other):
         if not isinstance(other, Token):
             return False
-        return (self.ttype == other.ttype and
-                self.value == other.value)
+        return self.ttype == other.ttype and self.value == other.value
 
     def __ne__(self, other):
         if not isinstance(other, Token):
             return True
-        return (self.ttype != other.ttype or
-                self.value != other.value)
+        return self.ttype != other.ttype or self.value != other.value
 
     def __str__(self):
         return '%d "%s"' % (self.ttype, self.value)
 
-    def unescape(self):
+    def unescape(self) -> "Token":
         if not self.has_escape:
             return self
-        unescaped = ''
+        unescaped = ""
         l = len(self.value)
         i = 0
         while i < l:
             c = self.value[i]
             i += 1
-            if c == '\\':
+            if c == "\\":
                 if i >= l:  # pragma: no cover   (can't happen via get())
                     raise dns.exception.UnexpectedEnd
                 c = self.value[i]
@@ -127,7 +133,7 @@ class Token:
             unescaped += c
         return Token(self.ttype, unescaped)
 
-    def unescape_to_bytes(self):
+    def unescape_to_bytes(self) -> "Token":
         # We used to use unescape() for TXT-like records, but this
         # caused problems as we'd process DNS escapes into Unicode code
         # points instead of byte values, and then a to_text() of the
@@ -152,13 +158,13 @@ class Token:
         #
         #     foo\226\128\139bar
         #
-        unescaped = b''
+        unescaped = b""
         l = len(self.value)
         i = 0
         while i < l:
             c = self.value[i]
             i += 1
-            if c == '\\':
+            if c == "\\":
                 if i >= l:  # pragma: no cover   (can't happen via get())
                     raise dns.exception.UnexpectedEnd
                 c = self.value[i]
@@ -177,7 +183,7 @@ class Token:
                     codepoint = int(c) * 100 + int(c2) * 10 + int(c3)
                     if codepoint > 255:
                         raise dns.exception.SyntaxError
-                    unescaped += b'%c' % (codepoint)
+                    unescaped += b"%c" % (codepoint)
                 else:
                     # Note that as mentioned above, if c is a Unicode
                     # code point outside of the ASCII range, then this
@@ -223,7 +229,12 @@ class Tokenizer:
     encoder/decoder is used.
     """
 
-    def __init__(self, f=sys.stdin, filename=None, idna_codec=None):
+    def __init__(
+        self,
+        f: Any = sys.stdin,
+        filename: Optional[str] = None,
+        idna_codec: Optional[dns.name.IDNACodec] = None,
+    ):
         """Initialize a tokenizer instance.
 
         f: The file to tokenize.  The default is sys.stdin.
@@ -241,49 +252,50 @@ class Tokenizer:
         if isinstance(f, str):
             f = io.StringIO(f)
             if filename is None:
-                filename = '<string>'
+                filename = "<string>"
         elif isinstance(f, bytes):
             f = io.StringIO(f.decode())
             if filename is None:
-                filename = '<string>'
+                filename = "<string>"
         else:
             if filename is None:
                 if f is sys.stdin:
-                    filename = '<stdin>'
+                    filename = "<stdin>"
                 else:
-                    filename = '<file>'
+                    filename = "<file>"
         self.file = f
-        self.ungotten_char = None
-        self.ungotten_token = None
+        self.ungotten_char: Optional[str] = None
+        self.ungotten_token: Optional[Token] = None
         self.multiline = 0
         self.quoting = False
         self.eof = False
         self.delimiters = _DELIMITERS
         self.line_number = 1
+        assert filename is not None
         self.filename = filename
         if idna_codec is None:
-            idna_codec = dns.name.IDNA_2003
-        self.idna_codec = idna_codec
+            self.idna_codec: dns.name.IDNACodec = dns.name.IDNA_2003
+        else:
+            self.idna_codec = idna_codec
 
-    def _get_char(self):
-        """Read a character from input.
-        """
+    def _get_char(self) -> str:
+        """Read a character from input."""
 
         if self.ungotten_char is None:
             if self.eof:
-                c = ''
+                c = ""
             else:
                 c = self.file.read(1)
-                if c == '':
+                if c == "":
                     self.eof = True
-                elif c == '\n':
+                elif c == "\n":
                     self.line_number += 1
         else:
             c = self.ungotten_char
             self.ungotten_char = None
         return c
 
-    def where(self):
+    def where(self) -> Tuple[str, int]:
         """Return the current location in the input.
 
         Returns a (string, int) tuple.  The first item is the filename of
@@ -292,7 +304,7 @@ class Tokenizer:
 
         return (self.filename, self.line_number)
 
-    def _unget_char(self, c):
+    def _unget_char(self, c: str) -> None:
         """Unget a character.
 
         The unget buffer for characters is only one character large; it is
@@ -308,7 +320,7 @@ class Tokenizer:
             raise UngetBufferFull  # pragma: no cover
         self.ungotten_char = c
 
-    def skip_whitespace(self):
+    def skip_whitespace(self) -> int:
         """Consume input until a non-whitespace character is encountered.
 
         The non-whitespace character is then ungotten, and the number of
@@ -322,13 +334,13 @@ class Tokenizer:
         skipped = 0
         while True:
             c = self._get_char()
-            if c != ' ' and c != '\t':
-                if (c != '\n') or not self.multiline:
+            if c != " " and c != "\t":
+                if (c != "\n") or not self.multiline:
                     self._unget_char(c)
                     return skipped
             skipped += 1
 
-    def get(self, want_leading=False, want_comment=False):
+    def get(self, want_leading: bool = False, want_comment: bool = False) -> Token:
         """Get the next token.
 
         want_leading: If True, return a WHITESPACE token if the
@@ -345,33 +357,33 @@ class Tokenizer:
         """
 
         if self.ungotten_token is not None:
-            token = self.ungotten_token
+            utoken = self.ungotten_token
             self.ungotten_token = None
-            if token.is_whitespace():
+            if utoken.is_whitespace():
                 if want_leading:
-                    return token
-            elif token.is_comment():
+                    return utoken
+            elif utoken.is_comment():
                 if want_comment:
-                    return token
+                    return utoken
             else:
-                return token
+                return utoken
         skipped = self.skip_whitespace()
         if want_leading and skipped > 0:
-            return Token(WHITESPACE, ' ')
-        token = ''
+            return Token(WHITESPACE, " ")
+        token = ""
         ttype = IDENTIFIER
         has_escape = False
         while True:
             c = self._get_char()
-            if c == '' or c in self.delimiters:
-                if c == '' and self.quoting:
+            if c == "" or c in self.delimiters:
+                if c == "" and self.quoting:
                     raise dns.exception.UnexpectedEnd
-                if token == '' and ttype != QUOTED_STRING:
-                    if c == '(':
+                if token == "" and ttype != QUOTED_STRING:
+                    if c == "(":
                         self.multiline += 1
                         self.skip_whitespace()
                         continue
-                    elif c == ')':
+                    elif c == ")":
                         if self.multiline <= 0:
                             raise dns.exception.SyntaxError
                         self.multiline -= 1
@@ -388,28 +400,29 @@ class Tokenizer:
                             self.delimiters = _DELIMITERS
                             self.skip_whitespace()
                             continue
-                    elif c == '\n':
-                        return Token(EOL, '\n')
-                    elif c == ';':
+                    elif c == "\n":
+                        return Token(EOL, "\n")
+                    elif c == ";":
                         while 1:
                             c = self._get_char()
-                            if c == '\n' or c == '':
+                            if c == "\n" or c == "":
                                 break
                             token += c
                         if want_comment:
                             self._unget_char(c)
                             return Token(COMMENT, token)
-                        elif c == '':
+                        elif c == "":
                             if self.multiline:
                                 raise dns.exception.SyntaxError(
-                                    'unbalanced parentheses')
+                                    "unbalanced parentheses"
+                                )
                             return Token(EOF, comment=token)
                         elif self.multiline:
                             self.skip_whitespace()
-                            token = ''
+                            token = ""
                             continue
                         else:
-                            return Token(EOL, '\n', comment=token)
+                            return Token(EOL, "\n", comment=token)
                     else:
                         # This code exists in case we ever want a
                         # delimiter to be returned.  It never produces
@@ -419,9 +432,9 @@ class Tokenizer:
                 else:
                     self._unget_char(c)
                 break
-            elif self.quoting and c == '\n':
-                raise dns.exception.SyntaxError('newline in quoted string')
-            elif c == '\\':
+            elif self.quoting and c == "\n":
+                raise dns.exception.SyntaxError("newline in quoted string")
+            elif c == "\\":
                 #
                 # It's an escape.  Put it and the next character into
                 # the token; it will be checked later for goodness.
@@ -429,16 +442,16 @@ class Tokenizer:
                 token += c
                 has_escape = True
                 c = self._get_char()
-                if c == '' or (c == '\n' and not self.quoting):
+                if c == "" or (c == "\n" and not self.quoting):
                     raise dns.exception.UnexpectedEnd
             token += c
-        if token == '' and ttype != QUOTED_STRING:
+        if token == "" and ttype != QUOTED_STRING:
             if self.multiline:
-                raise dns.exception.SyntaxError('unbalanced parentheses')
+                raise dns.exception.SyntaxError("unbalanced parentheses")
             ttype = EOF
         return Token(ttype, token, has_escape)
 
-    def unget(self, token):
+    def unget(self, token: Token) -> None:
         """Unget a token.
 
         The unget buffer for tokens is only one token large; it is
@@ -472,7 +485,7 @@ class Tokenizer:
 
     # Helpers
 
-    def get_int(self, base=10):
+    def get_int(self, base: int = 10) -> int:
         """Read the next token and interpret it as an unsigned integer.
 
         Raises dns.exception.SyntaxError if not an unsigned integer.
@@ -482,12 +495,12 @@ class Tokenizer:
 
         token = self.get().unescape()
         if not token.is_identifier():
-            raise dns.exception.SyntaxError('expecting an identifier')
+            raise dns.exception.SyntaxError("expecting an identifier")
         if not token.value.isdigit():
-            raise dns.exception.SyntaxError('expecting an integer')
+            raise dns.exception.SyntaxError("expecting an integer")
         return int(token.value, base)
 
-    def get_uint8(self):
+    def get_uint8(self) -> int:
         """Read the next token and interpret it as an 8-bit unsigned
         integer.
 
@@ -499,10 +512,11 @@ class Tokenizer:
         value = self.get_int()
         if value < 0 or value > 255:
             raise dns.exception.SyntaxError(
-                '%d is not an unsigned 8-bit integer' % value)
+                "%d is not an unsigned 8-bit integer" % value
+            )
         return value
 
-    def get_uint16(self, base=10):
+    def get_uint16(self, base: int = 10) -> int:
         """Read the next token and interpret it as a 16-bit unsigned
         integer.
 
@@ -515,13 +529,15 @@ class Tokenizer:
         if value < 0 or value > 65535:
             if base == 8:
                 raise dns.exception.SyntaxError(
-                    '%o is not an octal unsigned 16-bit integer' % value)
+                    "%o is not an octal unsigned 16-bit integer" % value
+                )
             else:
                 raise dns.exception.SyntaxError(
-                    '%d is not an unsigned 16-bit integer' % value)
+                    "%d is not an unsigned 16-bit integer" % value
+                )
         return value
 
-    def get_uint32(self, base=10):
+    def get_uint32(self, base: int = 10) -> int:
         """Read the next token and interpret it as a 32-bit unsigned
         integer.
 
@@ -533,10 +549,11 @@ class Tokenizer:
         value = self.get_int(base=base)
         if value < 0 or value > 4294967295:
             raise dns.exception.SyntaxError(
-                '%d is not an unsigned 32-bit integer' % value)
+                "%d is not an unsigned 32-bit integer" % value
+            )
         return value
 
-    def get_uint48(self, base=10):
+    def get_uint48(self, base: int = 10) -> int:
         """Read the next token and interpret it as a 48-bit unsigned
         integer.
 
@@ -548,10 +565,11 @@ class Tokenizer:
         value = self.get_int(base=base)
         if value < 0 or value > 281474976710655:
             raise dns.exception.SyntaxError(
-                '%d is not an unsigned 48-bit integer' % value)
+                "%d is not an unsigned 48-bit integer" % value
+            )
         return value
 
-    def get_string(self, max_length=None):
+    def get_string(self, max_length: Optional[int] = None) -> str:
         """Read the next token and interpret it as a string.
 
         Raises dns.exception.SyntaxError if not a string.
@@ -563,12 +581,12 @@ class Tokenizer:
 
         token = self.get().unescape()
         if not (token.is_identifier() or token.is_quoted_string()):
-            raise dns.exception.SyntaxError('expecting a string')
+            raise dns.exception.SyntaxError("expecting a string")
         if max_length and len(token.value) > max_length:
             raise dns.exception.SyntaxError("string too long")
         return token.value
 
-    def get_identifier(self):
+    def get_identifier(self) -> str:
         """Read the next token, which should be an identifier.
 
         Raises dns.exception.SyntaxError if not an identifier.
@@ -578,10 +596,10 @@ class Tokenizer:
 
         token = self.get().unescape()
         if not token.is_identifier():
-            raise dns.exception.SyntaxError('expecting an identifier')
+            raise dns.exception.SyntaxError("expecting an identifier")
         return token.value
 
-    def get_remaining(self, max_tokens=None):
+    def get_remaining(self, max_tokens: Optional[int] = None) -> List[Token]:
         """Return the remaining tokens on the line, until an EOL or EOF is seen.
 
         max_tokens: If not None, stop after this number of tokens.
@@ -600,7 +618,7 @@ class Tokenizer:
                 break
         return tokens
 
-    def concatenate_remaining_identifiers(self, allow_empty=False):
+    def concatenate_remaining_identifiers(self, allow_empty: bool = False) -> str:
         """Read the remaining tokens on the line, which should be identifiers.
 
         Raises dns.exception.SyntaxError if there are no remaining tokens,
@@ -622,10 +640,16 @@ class Tokenizer:
                 raise dns.exception.SyntaxError
             s += token.value
         if not (allow_empty or s):
-            raise dns.exception.SyntaxError('expecting another identifier')
+            raise dns.exception.SyntaxError("expecting another identifier")
         return s
 
-    def as_name(self, token, origin=None, relativize=False, relativize_to=None):
+    def as_name(
+        self,
+        token: Token,
+        origin: Optional[dns.name.Name] = None,
+        relativize: bool = False,
+        relativize_to: Optional[dns.name.Name] = None,
+    ) -> dns.name.Name:
         """Try to interpret the token as a DNS name.
 
         Raises dns.exception.SyntaxError if not a name.
@@ -633,11 +657,16 @@ class Tokenizer:
         Returns a dns.name.Name.
         """
         if not token.is_identifier():
-            raise dns.exception.SyntaxError('expecting an identifier')
+            raise dns.exception.SyntaxError("expecting an identifier")
         name = dns.name.from_text(token.value, origin, self.idna_codec)
         return name.choose_relativity(relativize_to or origin, relativize)
 
-    def get_name(self, origin=None, relativize=False, relativize_to=None):
+    def get_name(
+        self,
+        origin: Optional[dns.name.Name] = None,
+        relativize: bool = False,
+        relativize_to: Optional[dns.name.Name] = None,
+    ) -> dns.name.Name:
         """Read the next token and interpret it as a DNS name.
 
         Raises dns.exception.SyntaxError if not a name.
@@ -648,7 +677,7 @@ class Tokenizer:
         token = self.get()
         return self.as_name(token, origin, relativize, relativize_to)
 
-    def get_eol_as_token(self):
+    def get_eol_as_token(self) -> Token:
         """Read the next token and raise an exception if it isn't EOL or
         EOF.
 
@@ -658,14 +687,14 @@ class Tokenizer:
         token = self.get()
         if not token.is_eol_or_eof():
             raise dns.exception.SyntaxError(
-                'expected EOL or EOF, got %d "%s"' % (token.ttype,
-                                                      token.value))
+                'expected EOL or EOF, got %d "%s"' % (token.ttype, token.value)
+            )
         return token
 
-    def get_eol(self):
+    def get_eol(self) -> str:
         return self.get_eol_as_token().value
 
-    def get_ttl(self):
+    def get_ttl(self) -> int:
         """Read the next token and interpret it as a DNS TTL.
 
         Raises dns.exception.SyntaxError or dns.ttl.BadTTL if not an
@@ -676,5 +705,5 @@ class Tokenizer:
 
         token = self.get().unescape()
         if not token.is_identifier():
-            raise dns.exception.SyntaxError('expecting an identifier')
+            raise dns.exception.SyntaxError("expecting an identifier")
         return dns.ttl.from_text(token.value)
diff --git a/lib/dns/transaction.py b/lib/dns/transaction.py
index d7254924..c4a9e1f6 100644
--- a/lib/dns/transaction.py
+++ b/lib/dns/transaction.py
@@ -1,9 +1,12 @@
 # Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license
 
+from typing import Any, Callable, List, Optional, Tuple, Union
+
 import collections
 
 import dns.exception
 import dns.name
+import dns.node
 import dns.rdataclass
 import dns.rdataset
 import dns.rdatatype
@@ -13,11 +16,11 @@ import dns.ttl
 
 
 class TransactionManager:
-    def reader(self):
+    def reader(self) -> "Transaction":
         """Begin a read-only transaction."""
         raise NotImplementedError  # pragma: no cover
 
-    def writer(self, replacement=False):
+    def writer(self, replacement: bool = False) -> "Transaction":
         """Begin a writable transaction.
 
         *replacement*, a ``bool``.  If `True`, the content of the
@@ -27,7 +30,9 @@ class TransactionManager:
         """
         raise NotImplementedError  # pragma: no cover
 
-    def origin_information(self):
+    def origin_information(
+        self,
+    ) -> Tuple[Optional[dns.name.Name], bool, Optional[dns.name.Name]]:
         """Returns a tuple
 
             (absolute_origin, relativize, effective_origin)
@@ -52,14 +57,12 @@ class TransactionManager:
         """
         raise NotImplementedError  # pragma: no cover
 
-    def get_class(self):
-        """The class of the transaction manager.
-        """
+    def get_class(self) -> dns.rdataclass.RdataClass:
+        """The class of the transaction manager."""
         raise NotImplementedError  # pragma: no cover
 
-    def from_wire_origin(self):
-        """Origin to use in from_wire() calls.
-        """
+    def from_wire_origin(self) -> Optional[dns.name.Name]:
+        """Origin to use in from_wire() calls."""
         (absolute_origin, relativize, _) = self.origin_information()
         if relativize:
             return absolute_origin
@@ -84,28 +87,51 @@ def _ensure_immutable_rdataset(rdataset):
         return rdataset
     return dns.rdataset.ImmutableRdataset(rdataset)
 
+
 def _ensure_immutable_node(node):
     if node is None or node.is_immutable():
         return node
     return dns.node.ImmutableNode(node)
 
 
-class Transaction:
+CheckPutRdatasetType = Callable[
+    ["Transaction", dns.name.Name, dns.rdataset.Rdataset], None
+]
+CheckDeleteRdatasetType = Callable[
+    ["Transaction", dns.name.Name, dns.rdatatype.RdataType, dns.rdatatype.RdataType],
+    None,
+]
+CheckDeleteNameType = Callable[["Transaction", dns.name.Name], None]
 
-    def __init__(self, manager, replacement=False, read_only=False):
+
+class Transaction:
+    def __init__(
+        self,
+        manager: TransactionManager,
+        replacement: bool = False,
+        read_only: bool = False,
+    ):
         self.manager = manager
         self.replacement = replacement
         self.read_only = read_only
         self._ended = False
-        self._check_put_rdataset = []
-        self._check_delete_rdataset = []
-        self._check_delete_name = []
+        self._check_put_rdataset: List[CheckPutRdatasetType] = []
+        self._check_delete_rdataset: List[CheckDeleteRdatasetType] = []
+        self._check_delete_name: List[CheckDeleteNameType] = []
 
     #
     # This is the high level API
     #
+    # Note that we currently use non-immutable types in the return type signature to
+    # avoid covariance problems, e.g. if the caller has a List[Rdataset], mypy will be
+    # unhappy if we return an ImmutableRdataset.
 
-    def get(self, name, rdtype, covers=dns.rdatatype.NONE):
+    def get(
+        self,
+        name: Optional[Union[dns.name.Name, str]],
+        rdtype: Union[dns.rdatatype.RdataType, str],
+        covers: Union[dns.rdatatype.RdataType, str] = dns.rdatatype.NONE,
+    ) -> dns.rdataset.Rdataset:
         """Return the rdataset associated with *name*, *rdtype*, and *covers*,
         or `None` if not found.
 
@@ -115,21 +141,22 @@ class Transaction:
         if isinstance(name, str):
             name = dns.name.from_text(name, None)
         rdtype = dns.rdatatype.RdataType.make(rdtype)
+        covers = dns.rdatatype.RdataType.make(covers)
         rdataset = self._get_rdataset(name, rdtype, covers)
         return _ensure_immutable_rdataset(rdataset)
 
-    def get_node(self, name):
+    def get_node(self, name: dns.name.Name) -> Optional[dns.node.Node]:
         """Return the node at *name*, if any.
 
         Returns an immutable node or ``None``.
         """
         return _ensure_immutable_node(self._get_node(name))
 
-    def _check_read_only(self):
+    def _check_read_only(self) -> None:
         if self.read_only:
             raise ReadOnly
 
-    def add(self, *args):
+    def add(self, *args: Any) -> None:
         """Add records.
 
         The arguments may be:
@@ -142,9 +169,9 @@ class Transaction:
         """
         self._check_ended()
         self._check_read_only()
-        return self._add(False, args)
+        self._add(False, args)
 
-    def replace(self, *args):
+    def replace(self, *args: Any) -> None:
         """Replace the existing rdataset at the name with the specified
         rdataset, or add the specified rdataset if there was no existing
         rdataset.
@@ -163,9 +190,9 @@ class Transaction:
         """
         self._check_ended()
         self._check_read_only()
-        return self._add(True, args)
+        self._add(True, args)
 
-    def delete(self, *args):
+    def delete(self, *args: Any) -> None:
         """Delete records.
 
         It is not an error if some of the records are not in the existing
@@ -185,9 +212,9 @@ class Transaction:
         """
         self._check_ended()
         self._check_read_only()
-        return self._delete(False, args)
+        self._delete(False, args)
 
-    def delete_exact(self, *args):
+    def delete_exact(self, *args: Any) -> None:
         """Delete records.
 
         The arguments may be:
@@ -208,16 +235,21 @@ class Transaction:
         """
         self._check_ended()
         self._check_read_only()
-        return self._delete(True, args)
+        self._delete(True, args)
 
-    def name_exists(self, name):
+    def name_exists(self, name: Union[dns.name.Name, str]) -> bool:
         """Does the specified name exist?"""
         self._check_ended()
         if isinstance(name, str):
             name = dns.name.from_text(name, None)
         return self._name_exists(name)
 
-    def update_serial(self, value=1, relative=True, name=dns.name.empty):
+    def update_serial(
+        self,
+        value: int = 1,
+        relative: bool = True,
+        name: dns.name.Name = dns.name.empty,
+    ) -> None:
         """Update the serial number.
 
         *value*, an `int`, is an increment if *relative* is `True`, or the
@@ -231,11 +263,10 @@ class Transaction:
         """
         self._check_ended()
         if value < 0:
-            raise ValueError('negative update_serial() value')
+            raise ValueError("negative update_serial() value")
         if isinstance(name, str):
             name = dns.name.from_text(name, None)
-        rdataset = self._get_rdataset(name, dns.rdatatype.SOA,
-                                      dns.rdatatype.NONE)
+        rdataset = self._get_rdataset(name, dns.rdatatype.SOA, dns.rdatatype.NONE)
         if rdataset is None or len(rdataset) == 0:
             raise KeyError
         if relative:
@@ -253,7 +284,7 @@ class Transaction:
         self._check_ended()
         return self._iterate_rdatasets()
 
-    def changed(self):
+    def changed(self) -> bool:
         """Has this transaction changed anything?
 
         For read-only transactions, the result is always `False`.
@@ -264,7 +295,7 @@ class Transaction:
         self._check_ended()
         return self._changed()
 
-    def commit(self):
+    def commit(self) -> None:
         """Commit the transaction.
 
         Normally transactions are used as context managers and commit
@@ -277,7 +308,7 @@ class Transaction:
         """
         self._end(True)
 
-    def rollback(self):
+    def rollback(self) -> None:
         """Rollback the transaction.
 
         Normally transactions are used as context managers and commit
@@ -289,7 +320,7 @@ class Transaction:
         """
         self._end(False)
 
-    def check_put_rdataset(self, check):
+    def check_put_rdataset(self, check: CheckPutRdatasetType) -> None:
         """Call *check* before putting (storing) an rdataset.
 
         The function is called with the transaction, the name, and the rdataset.
@@ -301,7 +332,7 @@ class Transaction:
         """
         self._check_put_rdataset.append(check)
 
-    def check_delete_rdataset(self, check):
+    def check_delete_rdataset(self, check: CheckDeleteRdatasetType) -> None:
         """Call *check* before deleting an rdataset.
 
         The function is called with the transaction, the name, the rdatatype,
@@ -314,7 +345,7 @@ class Transaction:
         """
         self._check_delete_rdataset.append(check)
 
-    def check_delete_name(self, check):
+    def check_delete_name(self, check: CheckDeleteNameType) -> None:
         """Call *check* before putting (storing) an rdataset.
 
         The function is called with the transaction and the name.
@@ -332,7 +363,7 @@ class Transaction:
 
     def _raise_if_not_empty(self, method, args):
         if len(args) != 0:
-            raise TypeError(f'extra parameters to {method}')
+            raise TypeError(f"extra parameters to {method}")
 
     def _rdataset_from_args(self, method, deleting, args):
         try:
@@ -348,29 +379,29 @@ class Transaction:
                     if isinstance(arg, int):
                         ttl = arg
                         if ttl > dns.ttl.MAX_TTL:
-                            raise ValueError(f'{method}: TTL value too big')
+                            raise ValueError(f"{method}: TTL value too big")
                     else:
-                        raise TypeError(f'{method}: expected a TTL')
+                        raise TypeError(f"{method}: expected a TTL")
                     arg = args.popleft()
                 if isinstance(arg, dns.rdata.Rdata):
                     rdataset = dns.rdataset.from_rdata(ttl, arg)
                 else:
-                    raise TypeError(f'{method}: expected an Rdata')
+                    raise TypeError(f"{method}: expected an Rdata")
             return rdataset
         except IndexError:
             if deleting:
                 return None
             else:
                 # reraise
-                raise TypeError(f'{method}: expected more arguments')
+                raise TypeError(f"{method}: expected more arguments")
 
     def _add(self, replace, args):
         try:
             args = collections.deque(args)
             if replace:
-                method = 'replace()'
+                method = "replace()"
             else:
-                method = 'add()'
+                method = "add()"
             arg = args.popleft()
             if isinstance(arg, str):
                 arg = dns.name.from_text(arg, None)
@@ -384,44 +415,45 @@ class Transaction:
                 # same and can't be stored in nodes, so convert.
                 rdataset = rrset.to_rdataset()
             else:
-                raise TypeError(f'{method} requires a name or RRset ' +
-                                'as the first argument')
+                raise TypeError(
+                    f"{method} requires a name or RRset " + "as the first argument"
+                )
             if rdataset.rdclass != self.manager.get_class():
-                raise ValueError(f'{method} has objects of wrong RdataClass')
+                raise ValueError(f"{method} has objects of wrong RdataClass")
             if rdataset.rdtype == dns.rdatatype.SOA:
                 (_, _, origin) = self._origin_information()
                 if name != origin:
-                    raise ValueError(f'{method} has non-origin SOA')
+                    raise ValueError(f"{method} has non-origin SOA")
             self._raise_if_not_empty(method, args)
             if not replace:
-                existing = self._get_rdataset(name, rdataset.rdtype,
-                                              rdataset.covers)
+                existing = self._get_rdataset(name, rdataset.rdtype, rdataset.covers)
                 if existing is not None:
                     if isinstance(existing, dns.rdataset.ImmutableRdataset):
-                        trds = dns.rdataset.Rdataset(existing.rdclass,
-                                                     existing.rdtype,
-                                                     existing.covers)
+                        trds = dns.rdataset.Rdataset(
+                            existing.rdclass, existing.rdtype, existing.covers
+                        )
                         trds.update(existing)
                         existing = trds
                     rdataset = existing.union(rdataset)
             self._checked_put_rdataset(name, rdataset)
         except IndexError:
-            raise TypeError(f'not enough parameters to {method}')
+            raise TypeError(f"not enough parameters to {method}")
 
     def _delete(self, exact, args):
         try:
             args = collections.deque(args)
             if exact:
-                method = 'delete_exact()'
+                method = "delete_exact()"
             else:
-                method = 'delete()'
+                method = "delete()"
             arg = args.popleft()
             if isinstance(arg, str):
                 arg = dns.name.from_text(arg, None)
             if isinstance(arg, dns.name.Name):
                 name = arg
-                if len(args) > 0 and (isinstance(args[0], int) or
-                                      isinstance(args[0], str)):
+                if len(args) > 0 and (
+                    isinstance(args[0], int) or isinstance(args[0], str)
+                ):
                     # deleting by type and (optionally) covers
                     rdtype = dns.rdatatype.RdataType.make(args.popleft())
                     if len(args) > 0:
@@ -432,7 +464,7 @@ class Transaction:
                     existing = self._get_rdataset(name, rdtype, covers)
                     if existing is None:
                         if exact:
-                            raise DeleteNotExact(f'{method}: missing rdataset')
+                            raise DeleteNotExact(f"{method}: missing rdataset")
                     else:
                         self._delete_rdataset(name, rdtype, covers)
                     return
@@ -442,34 +474,34 @@ class Transaction:
                 rdataset = arg  # rrsets are also rdatasets
                 name = rdataset.name
             else:
-                raise TypeError(f'{method} requires a name or RRset ' +
-                                'as the first argument')
+                raise TypeError(
+                    f"{method} requires a name or RRset " + "as the first argument"
+                )
             self._raise_if_not_empty(method, args)
             if rdataset:
                 if rdataset.rdclass != self.manager.get_class():
-                    raise ValueError(f'{method} has objects of wrong '
-                                     'RdataClass')
-                existing = self._get_rdataset(name, rdataset.rdtype,
-                                              rdataset.covers)
+                    raise ValueError(f"{method} has objects of wrong RdataClass")
+                existing = self._get_rdataset(name, rdataset.rdtype, rdataset.covers)
                 if existing is not None:
                     if exact:
                         intersection = existing.intersection(rdataset)
                         if intersection != rdataset:
-                            raise DeleteNotExact(f'{method}: missing rdatas')
+                            raise DeleteNotExact(f"{method}: missing rdatas")
                     rdataset = existing.difference(rdataset)
                     if len(rdataset) == 0:
-                        self._checked_delete_rdataset(name, rdataset.rdtype,
-                                                      rdataset.covers)
+                        self._checked_delete_rdataset(
+                            name, rdataset.rdtype, rdataset.covers
+                        )
                     else:
                         self._checked_put_rdataset(name, rdataset)
                 elif exact:
-                    raise DeleteNotExact(f'{method}: missing rdataset')
+                    raise DeleteNotExact(f"{method}: missing rdataset")
             else:
                 if exact and not self._name_exists(name):
-                    raise DeleteNotExact(f'{method}: name not known')
+                    raise DeleteNotExact(f"{method}: name not known")
                 self._checked_delete_name(name)
         except IndexError:
-            raise TypeError(f'not enough parameters to {method}')
+            raise TypeError(f"not enough parameters to {method}")
 
     def _check_ended(self):
         if self._ended:
@@ -575,8 +607,7 @@ class Transaction:
         raise NotImplementedError  # pragma: no cover
 
     def _iterate_rdatasets(self):
-        """Return an iterator that yields (name, rdataset) tuples.
-        """
+        """Return an iterator that yields (name, rdataset) tuples."""
         raise NotImplementedError  # pragma: no cover
 
     def _get_node(self, name):
diff --git a/lib/dns/tsig.py b/lib/dns/tsig.py
index 50b2d47e..2476fdfb 100644
--- a/lib/dns/tsig.py
+++ b/lib/dns/tsig.py
@@ -27,6 +27,7 @@ import dns.rdataclass
 import dns.name
 import dns.rcode
 
+
 class BadTime(dns.exception.DNSException):
 
     """The current time is not within the TSIG's validity time."""
@@ -87,6 +88,19 @@ GSS_TSIG = dns.name.from_text("gss-tsig")
 
 default_algorithm = HMAC_SHA256
 
+mac_sizes = {
+    HMAC_SHA1: 20,
+    HMAC_SHA224: 28,
+    HMAC_SHA256: 32,
+    HMAC_SHA256_128: 16,
+    HMAC_SHA384: 48,
+    HMAC_SHA384_192: 24,
+    HMAC_SHA512: 64,
+    HMAC_SHA512_256: 32,
+    HMAC_MD5: 16,
+    GSS_TSIG: 128,  # This is what we assume to be the worst case!
+}
+
 
 class GSSTSig:
     """
@@ -97,10 +111,11 @@ class GSSTSig:
     In order to avoid a direct GSSAPI dependency, the keyring holds a ref
     to the GSSAPI object required, rather than the key itself.
     """
+
     def __init__(self, gssapi_context):
         self.gssapi_context = gssapi_context
-        self.data = b''
-        self.name = 'gss-tsig'
+        self.data = b""
+        self.name = "gss-tsig"
 
     def update(self, data):
         self.data += data
@@ -139,9 +154,9 @@ class GSSTSigAdapter:
         # client to complete the GSSAPI negotiation before attempting
         # to verify the signed response to a TKEY message exchange
         try:
-            rrset = message.find_rrset(message.answer, keyname,
-                                       dns.rdataclass.ANY,
-                                       dns.rdatatype.TKEY)
+            rrset = message.find_rrset(
+                message.answer, keyname, dns.rdataclass.ANY, dns.rdatatype.TKEY
+            )
             if rrset:
                 token = rrset[0].key
                 gssapi_context = key.secret
@@ -172,8 +187,9 @@ class HMACTSig:
         try:
             hashinfo = self._hashes[algorithm]
         except KeyError:
-            raise NotImplementedError(f"TSIG algorithm {algorithm} " +
-                                      "is not supported")
+            raise NotImplementedError(
+                f"TSIG algorithm {algorithm} " + "is not supported"
+            )
 
         # create the HMAC context
         if isinstance(hashinfo, tuple):
@@ -184,7 +200,7 @@ class HMACTSig:
             self.size = None
         self.name = self.hmac_context.name
         if self.size:
-            self.name += f'-{self.size}'
+            self.name += f"-{self.size}"
 
     def update(self, data):
         return self.hmac_context.update(data)
@@ -203,8 +219,7 @@ class HMACTSig:
             raise BadSignature
 
 
-def _digest(wire, key, rdata, time=None, request_mac=None, ctx=None,
-            multi=None):
+def _digest(wire, key, rdata, time=None, request_mac=None, ctx=None, multi=None):
     """Return a context containing the TSIG rdata for the input parameters
     @rtype: dns.tsig.HMACTSig or dns.tsig.GSSTSig object
     @raises ValueError: I{other_data} is too long
@@ -215,25 +230,25 @@ def _digest(wire, key, rdata, time=None, request_mac=None, ctx=None,
     if first:
         ctx = get_context(key)
         if request_mac:
-            ctx.update(struct.pack('!H', len(request_mac)))
+            ctx.update(struct.pack("!H", len(request_mac)))
             ctx.update(request_mac)
-    ctx.update(struct.pack('!H', rdata.original_id))
+    ctx.update(struct.pack("!H", rdata.original_id))
     ctx.update(wire[2:])
     if first:
         ctx.update(key.name.to_digestable())
-        ctx.update(struct.pack('!H', dns.rdataclass.ANY))
-        ctx.update(struct.pack('!I', 0))
+        ctx.update(struct.pack("!H", dns.rdataclass.ANY))
+        ctx.update(struct.pack("!I", 0))
     if time is None:
         time = rdata.time_signed
-    upper_time = (time >> 32) & 0xffff
-    lower_time = time & 0xffffffff
-    time_encoded = struct.pack('!HIH', upper_time, lower_time, rdata.fudge)
+    upper_time = (time >> 32) & 0xFFFF
+    lower_time = time & 0xFFFFFFFF
+    time_encoded = struct.pack("!HIH", upper_time, lower_time, rdata.fudge)
     other_len = len(rdata.other)
     if other_len > 65535:
-        raise ValueError('TSIG Other Data is > 65535 bytes')
+        raise ValueError("TSIG Other Data is > 65535 bytes")
     if first:
         ctx.update(key.algorithm.to_digestable() + time_encoded)
-        ctx.update(struct.pack('!HH', rdata.error, other_len) + rdata.other)
+        ctx.update(struct.pack("!HH", rdata.error, other_len) + rdata.other)
     else:
         ctx.update(time_encoded)
     return ctx
@@ -246,7 +261,7 @@ def _maybe_start_digest(key, mac, multi):
     """
     if multi:
         ctx = get_context(key)
-        ctx.update(struct.pack('!H', len(mac)))
+        ctx.update(struct.pack("!H", len(mac)))
         ctx.update(mac)
         return ctx
     else:
@@ -269,8 +284,9 @@ def sign(wire, key, rdata, time=None, request_mac=None, ctx=None, multi=False):
     return (tsig, _maybe_start_digest(key, mac, multi))
 
 
-def validate(wire, key, owner, rdata, now, request_mac, tsig_start, ctx=None,
-             multi=False):
+def validate(
+    wire, key, owner, rdata, now, request_mac, tsig_start, ctx=None, multi=False
+):
     """Validate the specified TSIG rdata against the other input parameters.
 
     @raises FormError: The TSIG is badly formed.
@@ -294,7 +310,7 @@ def validate(wire, key, owner, rdata, now, request_mac, tsig_start, ctx=None,
         elif rdata.error == dns.rcode.BADTRUNC:
             raise PeerBadTruncation
         else:
-            raise PeerError('unknown TSIG error code %d' % rdata.error)
+            raise PeerError("unknown TSIG error code %d" % rdata.error)
     if abs(rdata.time_signed - now) > rdata.fudge:
         raise BadTime
     if key.name != owner:
@@ -332,14 +348,15 @@ class Key:
         self.algorithm = algorithm
 
     def __eq__(self, other):
-        return (isinstance(other, Key) and
-                self.name == other.name and
-                self.secret == other.secret and
-                self.algorithm == other.algorithm)
+        return (
+            isinstance(other, Key)
+            and self.name == other.name
+            and self.secret == other.secret
+            and self.algorithm == other.algorithm
+        )
 
     def __repr__(self):
-        r = f"<DNS key name='{self.name}', " + \
-            f"algorithm='{self.algorithm}'"
+        r = f"<DNS key name='{self.name}', " + f"algorithm='{self.algorithm}'"
         if self.algorithm != GSS_TSIG:
             r += f", secret='{base64.b64encode(self.secret).decode()}'"
         r += ">"
diff --git a/lib/dns/tsigkeyring.py b/lib/dns/tsigkeyring.py
index 788581c9..6adba284 100644
--- a/lib/dns/tsigkeyring.py
+++ b/lib/dns/tsigkeyring.py
@@ -17,13 +17,15 @@
 
 """A place to store TSIG keys."""
 
+from typing import Any, Dict
+
 import base64
 
 import dns.name
 import dns.tsig
 
 
-def from_text(textring):
+def from_text(textring: Dict[str, Any]) -> Dict[dns.name.Name, dns.tsig.Key]:
     """Convert a dictionary containing (textual DNS name, base64 secret)
     pairs into a binary keyring which has (dns.name.Name, bytes) pairs, or
     a dictionary containing (textual DNS name, (algorithm, base64 secret))
@@ -32,16 +34,16 @@ def from_text(textring):
 
     keyring = {}
     for (name, value) in textring.items():
-        name = dns.name.from_text(name)
+        kname = dns.name.from_text(name)
         if isinstance(value, str):
-            keyring[name] = dns.tsig.Key(name, value).secret
+            keyring[kname] = dns.tsig.Key(kname, value).secret
         else:
             (algorithm, secret) = value
-            keyring[name] = dns.tsig.Key(name, secret, algorithm)
+            keyring[kname] = dns.tsig.Key(kname, secret, algorithm)
     return keyring
 
 
-def to_text(keyring):
+def to_text(keyring: Dict[dns.name.Name, Any]) -> Dict[str, Any]:
     """Convert a dictionary containing (dns.name.Name, dns.tsig.Key) pairs
     into a text keyring which has (textual DNS name, (textual algorithm,
     base64 secret)) pairs, or a dictionary containing (dns.name.Name, bytes)
@@ -49,17 +51,19 @@ def to_text(keyring):
     @rtype: dict"""
 
     textring = {}
+
     def b64encode(secret):
         return base64.encodebytes(secret).decode().rstrip()
+
     for (name, key) in keyring.items():
-        name = name.to_text()
+        tname = name.to_text()
         if isinstance(key, bytes):
-            textring[name] = b64encode(key)
+            textring[tname] = b64encode(key)
         else:
             if isinstance(key.secret, bytes):
                 text_secret = b64encode(key.secret)
             else:
                 text_secret = str(key.secret)
 
-            textring[name] = (key.algorithm.to_text(), text_secret)
+            textring[tname] = (key.algorithm.to_text(), text_secret)
     return textring
diff --git a/lib/dns/tsigkeyring.pyi b/lib/dns/tsigkeyring.pyi
deleted file mode 100644
index b5d51e15..00000000
--- a/lib/dns/tsigkeyring.pyi
+++ /dev/null
@@ -1,7 +0,0 @@
-from typing import Dict
-from . import name
-
-def from_text(textring : Dict[str,str]) -> Dict[name.Name,bytes]:
-    ...
-def to_text(keyring : Dict[name.Name,bytes]) -> Dict[str, str]:
-    ...
diff --git a/lib/dns/ttl.py b/lib/dns/ttl.py
index df92b2b6..264b0338 100644
--- a/lib/dns/ttl.py
+++ b/lib/dns/ttl.py
@@ -17,6 +17,8 @@
 
 """DNS TTL conversion."""
 
+from typing import Union
+
 import dns.exception
 
 # Technically TTLs are supposed to be between 0 and 2**31 - 1, with values
@@ -31,7 +33,7 @@ class BadTTL(dns.exception.SyntaxError):
     """DNS TTL value is not well-formed."""
 
 
-def from_text(text):
+def from_text(text: str) -> int:
     """Convert the text form of a TTL to an integer.
 
     The BIND 8 units syntax for TTLs (e.g. '1w6d4h3m10s') is supported.
@@ -60,15 +62,15 @@ def from_text(text):
                 if need_digit:
                     raise BadTTL
                 c = c.lower()
-                if c == 'w':
+                if c == "w":
                     total += current * 604800
-                elif c == 'd':
+                elif c == "d":
                     total += current * 86400
-                elif c == 'h':
+                elif c == "h":
                     total += current * 3600
-                elif c == 'm':
+                elif c == "m":
                     total += current * 60
-                elif c == 's':
+                elif c == "s":
                     total += current
                 else:
                     raise BadTTL("unknown unit '%s'" % c)
@@ -81,10 +83,10 @@ def from_text(text):
     return total
 
 
-def make(value):
+def make(value: Union[int, str]) -> int:
     if isinstance(value, int):
         return value
     elif isinstance(value, str):
         return dns.ttl.from_text(value)
     else:
-        raise ValueError('cannot convert value to TTL')
+        raise ValueError("cannot convert value to TTL")
diff --git a/lib/dns/update.py b/lib/dns/update.py
index a541af22..647e5b19 100644
--- a/lib/dns/update.py
+++ b/lib/dns/update.py
@@ -17,18 +17,21 @@
 
 """DNS Dynamic Update Support"""
 
+from typing import Any, List, Optional, Union
 
 import dns.message
 import dns.name
 import dns.opcode
 import dns.rdata
 import dns.rdataclass
+import dns.rdatatype
 import dns.rdataset
 import dns.tsig
 
 
 class UpdateSection(dns.enum.IntEnum):
     """Update sections"""
+
     ZONE = 0
     PREREQ = 1
     UPDATE = 2
@@ -39,13 +42,20 @@ class UpdateSection(dns.enum.IntEnum):
         return 3
 
 
-class UpdateMessage(dns.message.Message):
+class UpdateMessage(dns.message.Message):  # lgtm[py/missing-equals]
 
-    _section_enum = UpdateSection
+    # ignore the mypy error here as we mean to use a different enum
+    _section_enum = UpdateSection  # type: ignore
 
-    def __init__(self, zone=None, rdclass=dns.rdataclass.IN, keyring=None,
-                 keyname=None, keyalgorithm=dns.tsig.default_algorithm,
-                 id=None):
+    def __init__(
+        self,
+        zone: Optional[Union[dns.name.Name, str]] = None,
+        rdclass: dns.rdataclass.RdataClass = dns.rdataclass.IN,
+        keyring: Optional[Any] = None,
+        keyname: Optional[dns.name.Name] = None,
+        keyalgorithm: Union[dns.name.Name, str] = dns.tsig.default_algorithm,
+        id: Optional[int] = None,
+    ):
         """Initialize a new DNS Update object.
 
         See the documentation of the Message class for a complete
@@ -69,13 +79,19 @@ class UpdateMessage(dns.message.Message):
         rdclass = dns.rdataclass.RdataClass.make(rdclass)
         self.zone_rdclass = rdclass
         if self.origin:
-            self.find_rrset(self.zone, self.origin, rdclass, dns.rdatatype.SOA,
-                            create=True, force_unique=True)
+            self.find_rrset(
+                self.zone,
+                self.origin,
+                rdclass,
+                dns.rdatatype.SOA,
+                create=True,
+                force_unique=True,
+            )
         if keyring is not None:
             self.use_tsig(keyring, keyname, algorithm=keyalgorithm)
 
     @property
-    def zone(self):
+    def zone(self) -> List[dns.rrset.RRset]:
         """The zone section."""
         return self.sections[0]
 
@@ -84,7 +100,7 @@ class UpdateMessage(dns.message.Message):
         self.sections[0] = v
 
     @property
-    def prerequisite(self):
+    def prerequisite(self) -> List[dns.rrset.RRset]:
         """The prerequisite section."""
         return self.sections[1]
 
@@ -93,7 +109,7 @@ class UpdateMessage(dns.message.Message):
         self.sections[1] = v
 
     @property
-    def update(self):
+    def update(self) -> List[dns.rrset.RRset]:
         """The update section."""
         return self.sections[2]
 
@@ -107,8 +123,9 @@ class UpdateMessage(dns.message.Message):
         if section is None:
             section = self.update
         covers = rd.covers()
-        rrset = self.find_rrset(section, name, self.zone_rdclass, rd.rdtype,
-                                covers, deleting, True, True)
+        rrset = self.find_rrset(
+            section, name, self.zone_rdclass, rd.rdtype, covers, deleting, True, True
+        )
         rrset.add(rd, ttl)
 
     def _add(self, replace, section, name, *args):
@@ -148,11 +165,10 @@ class UpdateMessage(dns.message.Message):
                 if replace:
                     self.delete(name, rdtype)
                 for s in args:
-                    rd = dns.rdata.from_text(self.zone_rdclass, rdtype, s,
-                                             self.origin)
+                    rd = dns.rdata.from_text(self.zone_rdclass, rdtype, s, self.origin)
                     self._add_rr(name, ttl, rd, section=section)
 
-    def add(self, name, *args):
+    def add(self, name: Union[dns.name.Name, str], *args: Any) -> None:
         """Add records.
 
         The first argument is always a name.  The other
@@ -167,7 +183,7 @@ class UpdateMessage(dns.message.Message):
 
         self._add(False, self.update, name, *args)
 
-    def delete(self, name, *args):
+    def delete(self, name: Union[dns.name.Name, str], *args: Any) -> None:
         """Delete records.
 
         The first argument is always a name.  The other
@@ -185,33 +201,49 @@ class UpdateMessage(dns.message.Message):
         if isinstance(name, str):
             name = dns.name.from_text(name, None)
         if len(args) == 0:
-            self.find_rrset(self.update, name, dns.rdataclass.ANY,
-                            dns.rdatatype.ANY, dns.rdatatype.NONE,
-                            dns.rdatatype.ANY, True, True)
+            self.find_rrset(
+                self.update,
+                name,
+                dns.rdataclass.ANY,
+                dns.rdatatype.ANY,
+                dns.rdatatype.NONE,
+                dns.rdataclass.ANY,
+                True,
+                True,
+            )
         elif isinstance(args[0], dns.rdataset.Rdataset):
             for rds in args:
                 for rd in rds:
                     self._add_rr(name, 0, rd, dns.rdataclass.NONE)
         else:
-            args = list(args)
-            if isinstance(args[0], dns.rdata.Rdata):
-                for rd in args:
+            largs = list(args)
+            if isinstance(largs[0], dns.rdata.Rdata):
+                for rd in largs:
                     self._add_rr(name, 0, rd, dns.rdataclass.NONE)
             else:
-                rdtype = dns.rdatatype.RdataType.make(args.pop(0))
-                if len(args) == 0:
-                    self.find_rrset(self.update, name,
-                                    self.zone_rdclass, rdtype,
-                                    dns.rdatatype.NONE,
-                                    dns.rdataclass.ANY,
-                                    True, True)
+                rdtype = dns.rdatatype.RdataType.make(largs.pop(0))
+                if len(largs) == 0:
+                    self.find_rrset(
+                        self.update,
+                        name,
+                        self.zone_rdclass,
+                        rdtype,
+                        dns.rdatatype.NONE,
+                        dns.rdataclass.ANY,
+                        True,
+                        True,
+                    )
                 else:
-                    for s in args:
-                        rd = dns.rdata.from_text(self.zone_rdclass, rdtype, s,
-                                                 self.origin)
+                    for s in largs:
+                        rd = dns.rdata.from_text(
+                            self.zone_rdclass,
+                            rdtype,
+                            s,  # type: ignore[arg-type]
+                            self.origin,
+                        )
                         self._add_rr(name, 0, rd, dns.rdataclass.NONE)
 
-    def replace(self, name, *args):
+    def replace(self, name: Union[dns.name.Name, str], *args: Any) -> None:
         """Replace records.
 
         The first argument is always a name.  The other
@@ -229,7 +261,7 @@ class UpdateMessage(dns.message.Message):
 
         self._add(True, self.update, name, *args)
 
-    def present(self, name, *args):
+    def present(self, name: Union[dns.name.Name, str], *args: Any) -> None:
         """Require that an owner name (and optionally an rdata type,
         or specific rdataset) exists as a prerequisite to the
         execution of the update.
@@ -247,42 +279,74 @@ class UpdateMessage(dns.message.Message):
         if isinstance(name, str):
             name = dns.name.from_text(name, None)
         if len(args) == 0:
-            self.find_rrset(self.prerequisite, name,
-                            dns.rdataclass.ANY, dns.rdatatype.ANY,
-                            dns.rdatatype.NONE, None,
-                            True, True)
-        elif isinstance(args[0], dns.rdataset.Rdataset) or \
-            isinstance(args[0], dns.rdata.Rdata) or \
-                len(args) > 1:
+            self.find_rrset(
+                self.prerequisite,
+                name,
+                dns.rdataclass.ANY,
+                dns.rdatatype.ANY,
+                dns.rdatatype.NONE,
+                None,
+                True,
+                True,
+            )
+        elif (
+            isinstance(args[0], dns.rdataset.Rdataset)
+            or isinstance(args[0], dns.rdata.Rdata)
+            or len(args) > 1
+        ):
             if not isinstance(args[0], dns.rdataset.Rdataset):
                 # Add a 0 TTL
-                args = list(args)
-                args.insert(0, 0)
-            self._add(False, self.prerequisite, name, *args)
+                largs = list(args)
+                largs.insert(0, 0)  # type: ignore[arg-type]
+                self._add(False, self.prerequisite, name, *largs)
+            else:
+                self._add(False, self.prerequisite, name, *args)
         else:
             rdtype = dns.rdatatype.RdataType.make(args[0])
-            self.find_rrset(self.prerequisite, name,
-                            dns.rdataclass.ANY, rdtype,
-                            dns.rdatatype.NONE, None,
-                            True, True)
+            self.find_rrset(
+                self.prerequisite,
+                name,
+                dns.rdataclass.ANY,
+                rdtype,
+                dns.rdatatype.NONE,
+                None,
+                True,
+                True,
+            )
 
-    def absent(self, name, rdtype=None):
+    def absent(
+        self,
+        name: Union[dns.name.Name, str],
+        rdtype: Optional[Union[dns.rdatatype.RdataType, str]] = None,
+    ) -> None:
         """Require that an owner name (and optionally an rdata type) does
         not exist as a prerequisite to the execution of the update."""
 
         if isinstance(name, str):
             name = dns.name.from_text(name, None)
         if rdtype is None:
-            self.find_rrset(self.prerequisite, name,
-                            dns.rdataclass.NONE, dns.rdatatype.ANY,
-                            dns.rdatatype.NONE, None,
-                            True, True)
+            self.find_rrset(
+                self.prerequisite,
+                name,
+                dns.rdataclass.NONE,
+                dns.rdatatype.ANY,
+                dns.rdatatype.NONE,
+                None,
+                True,
+                True,
+            )
         else:
-            rdtype = dns.rdatatype.RdataType.make(rdtype)
-            self.find_rrset(self.prerequisite, name,
-                            dns.rdataclass.NONE, rdtype,
-                            dns.rdatatype.NONE, None,
-                            True, True)
+            the_rdtype = dns.rdatatype.RdataType.make(rdtype)
+            self.find_rrset(
+                self.prerequisite,
+                name,
+                dns.rdataclass.NONE,
+                the_rdtype,
+                dns.rdatatype.NONE,
+                None,
+                True,
+                True,
+            )
 
     def _get_one_rr_per_rrset(self, value):
         # Updates are always one_rr_per_rrset
@@ -292,9 +356,11 @@ class UpdateMessage(dns.message.Message):
         deleting = None
         empty = False
         if section == UpdateSection.ZONE:
-            if dns.rdataclass.is_metaclass(rdclass) or \
-               rdtype != dns.rdatatype.SOA or \
-               self.zone:
+            if (
+                dns.rdataclass.is_metaclass(rdclass)
+                or rdtype != dns.rdatatype.SOA
+                or self.zone
+            ):
                 raise dns.exception.FormError
         else:
             if not self.zone:
@@ -302,10 +368,12 @@ class UpdateMessage(dns.message.Message):
             if rdclass in (dns.rdataclass.ANY, dns.rdataclass.NONE):
                 deleting = rdclass
                 rdclass = self.zone[0].rdclass
-                empty = (deleting == dns.rdataclass.ANY or
-                         section == UpdateSection.PREREQ)
+                empty = (
+                    deleting == dns.rdataclass.ANY or section == UpdateSection.PREREQ
+                )
         return (rdclass, rdtype, deleting, empty)
 
+
 # backwards compatibility
 Update = UpdateMessage
 
diff --git a/lib/dns/update.pyi b/lib/dns/update.pyi
deleted file mode 100644
index eeac0591..00000000
--- a/lib/dns/update.pyi
+++ /dev/null
@@ -1,21 +0,0 @@
-from typing import Optional,Dict,Union,Any
-
-from . import message, tsig, rdataclass, name
-
-class Update(message.Message):
-    def __init__(self, zone : Union[name.Name, str], rdclass : Union[int,str] = rdataclass.IN, keyring : Optional[Dict[name.Name,bytes]] = None,
-                 keyname : Optional[name.Name] = None, keyalgorithm : Optional[name.Name] = tsig.default_algorithm) -> None:
-        self.id : int
-    def add(self, name : Union[str,name.Name], *args : Any):
-        ...
-    def delete(self, name, *args : Any):
-        ...
-    def replace(self, name : Union[str,name.Name], *args : Any):
-        ...
-    def present(self, name : Union[str,name.Name], *args : Any):
-        ...
-    def absent(self, name : Union[str,name.Name], rdtype=None):
-        """Require that an owner name (and optionally an rdata type) does
-        not exist as a prerequisite to the execution of the update."""
-    def to_wire(self, origin : Optional[name.Name] = None, max_size=65535, **kw) -> bytes:
-        ...
diff --git a/lib/dns/version.py b/lib/dns/version.py
index 65017872..89d4cf1a 100644
--- a/lib/dns/version.py
+++ b/lib/dns/version.py
@@ -20,27 +20,39 @@
 #: MAJOR
 MAJOR = 2
 #: MINOR
-MINOR = 2
+MINOR = 3
 #: MICRO
-MICRO = 1
+MICRO = 0
 #: RELEASELEVEL
-RELEASELEVEL = 0x0f
+RELEASELEVEL = 0x0F
 #: SERIAL
-SERIAL = 0
+SERIAL = 1
 
-if RELEASELEVEL == 0x0f:  # pragma: no cover
+if RELEASELEVEL == 0x0F:  # pragma: no cover  lgtm[py/unreachable-statement]
     #: version
-    version = '%d.%d.%d' % (MAJOR, MINOR, MICRO)
-elif RELEASELEVEL == 0x00:  # pragma: no cover
-    version = '%d.%d.%ddev%d' % \
-              (MAJOR, MINOR, MICRO, SERIAL)
-elif RELEASELEVEL == 0x0c:  # pragma: no cover
-    version = '%d.%d.%drc%d' % \
-              (MAJOR, MINOR, MICRO, SERIAL)
-else:  # pragma: no cover
-    version = '%d.%d.%d%x%d' % \
-              (MAJOR, MINOR, MICRO, RELEASELEVEL, SERIAL)
+    version = "%d.%d.%d" % (MAJOR, MINOR, MICRO)  # lgtm[py/unreachable-statement]
+elif RELEASELEVEL == 0x00:  # pragma: no cover  lgtm[py/unreachable-statement]
+    version = "%d.%d.%ddev%d" % (
+        MAJOR,
+        MINOR,
+        MICRO,
+        SERIAL,
+    )  # lgtm[py/unreachable-statement]
+elif RELEASELEVEL == 0x0C:  # pragma: no cover  lgtm[py/unreachable-statement]
+    version = "%d.%d.%drc%d" % (
+        MAJOR,
+        MINOR,
+        MICRO,
+        SERIAL,
+    )  # lgtm[py/unreachable-statement]
+else:  # pragma: no cover  lgtm[py/unreachable-statement]
+    version = "%d.%d.%d%x%d" % (
+        MAJOR,
+        MINOR,
+        MICRO,
+        RELEASELEVEL,
+        SERIAL,
+    )  # lgtm[py/unreachable-statement]
 
 #: hexversion
-hexversion = MAJOR << 24 | MINOR << 16 | MICRO << 8 | RELEASELEVEL << 4 | \
-    SERIAL
+hexversion = MAJOR << 24 | MINOR << 16 | MICRO << 8 | RELEASELEVEL << 4 | SERIAL
diff --git a/lib/dns/versioned.py b/lib/dns/versioned.py
index 8b6c275f..02e24122 100644
--- a/lib/dns/versioned.py
+++ b/lib/dns/versioned.py
@@ -2,16 +2,17 @@
 
 """DNS Versioned Zones."""
 
+from typing import Callable, Deque, Optional, Set, Union
+
 import collections
-try:
-    import threading as _threading
-except ImportError:  # pragma: no cover
-    import dummy_threading as _threading    # type: ignore
+import threading
 
 import dns.exception
 import dns.immutable
 import dns.name
+import dns.node
 import dns.rdataclass
+import dns.rdataset
 import dns.rdatatype
 import dns.rdtypes.ANY.SOA
 import dns.zone
@@ -30,16 +31,27 @@ ImmutableVersion = dns.zone.ImmutableVersion
 Transaction = dns.zone.Transaction
 
 
-class Zone(dns.zone.Zone):
+class Zone(dns.zone.Zone):  # lgtm[py/missing-equals]
 
-    __slots__ = ['_versions', '_versions_lock', '_write_txn',
-                 '_write_waiters', '_write_event', '_pruning_policy',
-                 '_readers']
+    __slots__ = [
+        "_versions",
+        "_versions_lock",
+        "_write_txn",
+        "_write_waiters",
+        "_write_event",
+        "_pruning_policy",
+        "_readers",
+    ]
 
     node_factory = Node
 
-    def __init__(self, origin, rdclass=dns.rdataclass.IN, relativize=True,
-                 pruning_policy=None):
+    def __init__(
+        self,
+        origin: Optional[Union[dns.name.Name, str]],
+        rdclass: dns.rdataclass.RdataClass = dns.rdataclass.IN,
+        relativize: bool = True,
+        pruning_policy: Optional[Callable[["Zone", Version], Optional[bool]]] = None,
+    ):
         """Initialize a versioned zone object.
 
         *origin* is the origin of the zone.  It may be a ``dns.name.Name``,
@@ -51,28 +63,30 @@ class Zone(dns.zone.Zone):
         *relativize*, a ``bool``, determine's whether domain names are
         relativized to the zone's origin.  The default is ``True``.
 
-        *pruning policy*, a function taking a `Version` and returning
-        a `bool`, or `None`.  Should the version be pruned?  If `None`,
+        *pruning policy*, a function taking a ``Zone`` and a ``Version`` and returning
+        a ``bool``, or ``None``.  Should the version be pruned?  If ``None``,
         the default policy, which retains one version is used.
         """
         super().__init__(origin, rdclass, relativize)
-        self._versions = collections.deque()
-        self._version_lock = _threading.Lock()
+        self._versions: Deque[Version] = collections.deque()
+        self._version_lock = threading.Lock()
         if pruning_policy is None:
             self._pruning_policy = self._default_pruning_policy
         else:
             self._pruning_policy = pruning_policy
-        self._write_txn = None
-        self._write_event = None
-        self._write_waiters = collections.deque()
-        self._readers = set()
-        self._commit_version_unlocked(None,
-                                      WritableVersion(self, replacement=True),
-                                      origin)
+        self._write_txn: Optional[Transaction] = None
+        self._write_event: Optional[threading.Event] = None
+        self._write_waiters: Deque[threading.Event] = collections.deque()
+        self._readers: Set[Transaction] = set()
+        self._commit_version_unlocked(
+            None, WritableVersion(self, replacement=True), origin
+        )
 
-    def reader(self, id=None, serial=None):  # pylint: disable=arguments-differ
+    def reader(
+        self, id: Optional[int] = None, serial: Optional[int] = None
+    ) -> Transaction:  # pylint: disable=arguments-differ
         if id is not None and serial is not None:
-            raise ValueError('cannot specify both id and serial')
+            raise ValueError("cannot specify both id and serial")
         with self._version_lock:
             if id is not None:
                 version = None
@@ -81,11 +95,12 @@ class Zone(dns.zone.Zone):
                         version = v
                         break
                 if version is None:
-                    raise KeyError('version not found')
+                    raise KeyError("version not found")
             elif serial is not None:
                 if self.relativize:
                     oname = dns.name.empty
                 else:
+                    assert self.origin is not None
                     oname = self.origin
                 version = None
                 for v in reversed(self._versions):
@@ -96,14 +111,14 @@ class Zone(dns.zone.Zone):
                             version = v
                             break
                 if version is None:
-                    raise KeyError('serial not found')
+                    raise KeyError("serial not found")
             else:
                 version = self._versions[-1]
             txn = Transaction(self, False, version)
             self._readers.add(txn)
             return txn
 
-    def writer(self, replacement=False):
+    def writer(self, replacement: bool = False) -> Transaction:
         event = None
         while True:
             with self._version_lock:
@@ -117,15 +132,16 @@ class Zone(dns.zone.Zone):
                     # give up the lock, so that we hold the lock as
                     # short a time as possible.  This is why we call
                     # _setup_version() below.
-                    self._write_txn = Transaction(self, replacement,
-                                                  make_immutable=True)
+                    self._write_txn = Transaction(
+                        self, replacement, make_immutable=True
+                    )
                     # give up our exclusive right to make a Transaction
                     self._write_event = None
                     break
                 # Someone else is writing already, so we will have to
                 # wait, but we want to do the actual wait outside the
                 # lock.
-                event = _threading.Event()
+                event = threading.Event()
                 self._write_waiters.append(event)
             # wait (note we gave up the lock!)
             #
@@ -159,6 +175,7 @@ class Zone(dns.zone.Zone):
     # pylint: disable=unused-argument
     def _default_pruning_policy(self, zone, version):
         return True
+
     # pylint: enable=unused-argument
 
     def _prune_versions_unlocked(self):
@@ -174,25 +191,32 @@ class Zone(dns.zone.Zone):
             least_kept = min(txn.version.id for txn in self._readers)
         else:
             least_kept = self._versions[-1].id
-        while self._versions[0].id < least_kept and \
-              self._pruning_policy(self, self._versions[0]):
+        while self._versions[0].id < least_kept and self._pruning_policy(
+            self, self._versions[0]
+        ):
             self._versions.popleft()
 
-    def set_max_versions(self, max_versions):
+    def set_max_versions(self, max_versions: Optional[int]) -> None:
         """Set a pruning policy that retains up to the specified number
         of versions
         """
         if max_versions is not None and max_versions < 1:
-            raise ValueError('max versions must be at least 1')
+            raise ValueError("max versions must be at least 1")
         if max_versions is None:
-            def policy(*_):
+
+            def policy(zone, _):  # pylint: disable=unused-argument
                 return False
+
         else:
+
             def policy(zone, _):
                 return len(zone._versions) > max_versions
+
         self.set_pruning_policy(policy)
 
-    def set_pruning_policy(self, policy):
+    def set_pruning_policy(
+        self, policy: Optional[Callable[["Zone", Version], Optional[bool]]]
+    ) -> None:
         """Set the pruning policy for the zone.
 
         The *policy* function takes a `Version` and returns `True` if
@@ -245,30 +269,52 @@ class Zone(dns.zone.Zone):
             id = 1
         return id
 
-    def find_node(self, name, create=False):
+    def find_node(
+        self, name: Union[dns.name.Name, str], create: bool = False
+    ) -> dns.node.Node:
         if create:
             raise UseTransaction
         return super().find_node(name)
 
-    def delete_node(self, name):
+    def delete_node(self, name: Union[dns.name.Name, str]) -> None:
         raise UseTransaction
 
-    def find_rdataset(self, name, rdtype, covers=dns.rdatatype.NONE,
-                      create=False):
+    def find_rdataset(
+        self,
+        name: Union[dns.name.Name, str],
+        rdtype: Union[dns.rdatatype.RdataType, str],
+        covers: Union[dns.rdatatype.RdataType, str] = dns.rdatatype.NONE,
+        create: bool = False,
+    ) -> dns.rdataset.Rdataset:
         if create:
             raise UseTransaction
         rdataset = super().find_rdataset(name, rdtype, covers)
         return dns.rdataset.ImmutableRdataset(rdataset)
 
-    def get_rdataset(self, name, rdtype, covers=dns.rdatatype.NONE,
-                     create=False):
+    def get_rdataset(
+        self,
+        name: Union[dns.name.Name, str],
+        rdtype: Union[dns.rdatatype.RdataType, str],
+        covers: Union[dns.rdatatype.RdataType, str] = dns.rdatatype.NONE,
+        create: bool = False,
+    ) -> Optional[dns.rdataset.Rdataset]:
         if create:
             raise UseTransaction
         rdataset = super().get_rdataset(name, rdtype, covers)
-        return dns.rdataset.ImmutableRdataset(rdataset)
+        if rdataset is not None:
+            return dns.rdataset.ImmutableRdataset(rdataset)
+        else:
+            return None
 
-    def delete_rdataset(self, name, rdtype, covers=dns.rdatatype.NONE):
+    def delete_rdataset(
+        self,
+        name: Union[dns.name.Name, str],
+        rdtype: Union[dns.rdatatype.RdataType, str],
+        covers: Union[dns.rdatatype.RdataType, str] = dns.rdatatype.NONE,
+    ) -> None:
         raise UseTransaction
 
-    def replace_rdataset(self, name, replacement):
+    def replace_rdataset(
+        self, name: Union[dns.name.Name, str], replacement: dns.rdataset.Rdataset
+    ) -> None:
         raise UseTransaction
diff --git a/lib/dns/win32util.py b/lib/dns/win32util.py
index 745317a3..ac314750 100644
--- a/lib/dns/win32util.py
+++ b/lib/dns/win32util.py
@@ -1,20 +1,26 @@
 import sys
 
-if sys.platform == 'win32':
+if sys.platform == "win32":
+
+    from typing import Any
 
     import dns.name
 
     _prefer_wmi = True
 
-    import winreg
+    import winreg  # pylint: disable=import-error
+
+    # Keep pylint quiet on non-windows.
+    try:
+        WindowsError is None  # pylint: disable=used-before-assignment
+    except KeyError:
+        WindowsError = Exception
 
     try:
-        try:
-            import threading as _threading
-        except ImportError:  # pragma: no cover
-            import dummy_threading as _threading    # type: ignore
-        import pythoncom
-        import wmi
+        import threading
+        import pythoncom  # pylint: disable=import-error
+        import wmi  # pylint: disable=import-error
+
         _have_wmi = True
     except Exception:
         _have_wmi = False
@@ -23,7 +29,7 @@ if sys.platform == 'win32':
         # Sometimes DHCP servers add a '.' prefix to the default domain, and
         # Windows just stores such values in the registry (see #687).
         # Check for this and fix it.
-        if domain.startswith('.'):
+        if domain.startswith("."):
             domain = domain[1:]
         return dns.name.from_text(domain)
 
@@ -34,7 +40,8 @@ if sys.platform == 'win32':
             self.search = []
 
     if _have_wmi:
-        class _WMIGetter(_threading.Thread):
+
+        class _WMIGetter(threading.Thread):
             def __init__(self):
                 super().__init__()
                 self.info = DnsInfo()
@@ -44,11 +51,14 @@ if sys.platform == 'win32':
                 try:
                     system = wmi.WMI()
                     for interface in system.Win32_NetworkAdapterConfiguration():
-                        if interface.IPEnabled:
+                        if interface.IPEnabled and interface.DNSDomain:
                             self.info.domain = _config_domain(interface.DNSDomain)
                             self.info.nameservers = list(interface.DNSServerSearchOrder)
-                            self.info.search = [dns.name.from_text(x) for x in
-                                                interface.DNSDomainSuffixSearchOrder]
+                            if interface.DNSDomainSuffixSearchOrder:
+                                self.info.search = [
+                                    _config_domain(x)
+                                    for x in interface.DNSDomainSuffixSearchOrder
+                                ]
                             break
                 finally:
                     pythoncom.CoUninitialize()
@@ -59,10 +69,11 @@ if sys.platform == 'win32':
                 self.start()
                 self.join()
                 return self.info
-    else:
-        class _WMIGetter:
-            pass
 
+    else:
+
+        class _WMIGetter:  # type: ignore
+            pass
 
     class _RegistryGetter:
         def __init__(self):
@@ -74,13 +85,13 @@ if sys.platform == 'win32':
             # delimiter in between ' ' and ',' (and vice-versa) in various
             # versions of windows.
             #
-            if entry.find(' ') >= 0:
-                split_char = ' '
-            elif entry.find(',') >= 0:
-                split_char = ','
+            if entry.find(" ") >= 0:
+                split_char = " "
+            elif entry.find(",") >= 0:
+                split_char = ","
             else:
                 # probably a singleton; treat as a space-separated list.
-                split_char = ' '
+                split_char = " "
             return split_char
 
         def _config_nameservers(self, nameservers):
@@ -94,44 +105,44 @@ if sys.platform == 'win32':
             split_char = self._determine_split_char(search)
             search_list = search.split(split_char)
             for s in search_list:
-                s = dns.name.from_text(s)
+                s = _config_domain(s)
                 if s not in self.info.search:
                     self.info.search.append(s)
 
         def _config_fromkey(self, key, always_try_domain):
             try:
-                servers, _ = winreg.QueryValueEx(key, 'NameServer')
+                servers, _ = winreg.QueryValueEx(key, "NameServer")
             except WindowsError:
                 servers = None
             if servers:
                 self._config_nameservers(servers)
             if servers or always_try_domain:
                 try:
-                    dom, _ = winreg.QueryValueEx(key, 'Domain')
+                    dom, _ = winreg.QueryValueEx(key, "Domain")
                     if dom:
                         self.info.domain = _config_domain(dom)
                 except WindowsError:
                     pass
             else:
                 try:
-                    servers, _ = winreg.QueryValueEx(key, 'DhcpNameServer')
+                    servers, _ = winreg.QueryValueEx(key, "DhcpNameServer")
                 except WindowsError:
                     servers = None
                 if servers:
                     self._config_nameservers(servers)
                     try:
-                        dom, _ = winreg.QueryValueEx(key, 'DhcpDomain')
+                        dom, _ = winreg.QueryValueEx(key, "DhcpDomain")
                         if dom:
                             self.info.domain = _config_domain(dom)
                     except WindowsError:
                         pass
             try:
-                search, _ = winreg.QueryValueEx(key, 'SearchList')
+                search, _ = winreg.QueryValueEx(key, "SearchList")
             except WindowsError:
                 search = None
             if search is None:
                 try:
-                    search, _ = winreg.QueryValueEx(key, 'DhcpSearchList')
+                    search, _ = winreg.QueryValueEx(key, "DhcpSearchList")
                 except WindowsError:
                     search = None
             if search:
@@ -148,25 +159,27 @@ if sys.platform == 'win32':
                 # from Windows 2000 through Vista.
                 connection_key = winreg.OpenKey(
                     lm,
-                    r'SYSTEM\CurrentControlSet\Control\Network'
-                    r'\{4D36E972-E325-11CE-BFC1-08002BE10318}'
-                    r'\%s\Connection' % guid)
+                    r"SYSTEM\CurrentControlSet\Control\Network"
+                    r"\{4D36E972-E325-11CE-BFC1-08002BE10318}"
+                    r"\%s\Connection" % guid,
+                )
 
                 try:
                     # The PnpInstanceID points to a key inside Enum
                     (pnp_id, ttype) = winreg.QueryValueEx(
-                        connection_key, 'PnpInstanceID')
+                        connection_key, "PnpInstanceID"
+                    )
 
                     if ttype != winreg.REG_SZ:
                         raise ValueError  # pragma: no cover
 
                     device_key = winreg.OpenKey(
-                        lm, r'SYSTEM\CurrentControlSet\Enum\%s' % pnp_id)
+                        lm, r"SYSTEM\CurrentControlSet\Enum\%s" % pnp_id
+                    )
 
                     try:
                         # Get ConfigFlags for this device
-                        (flags, ttype) = winreg.QueryValueEx(
-                            device_key, 'ConfigFlags')
+                        (flags, ttype) = winreg.QueryValueEx(device_key, "ConfigFlags")
 
                         if ttype != winreg.REG_DWORD:
                             raise ValueError  # pragma: no cover
@@ -192,17 +205,19 @@ if sys.platform == 'win32':
 
             lm = winreg.ConnectRegistry(None, winreg.HKEY_LOCAL_MACHINE)
             try:
-                tcp_params = winreg.OpenKey(lm,
-                                            r'SYSTEM\CurrentControlSet'
-                                            r'\Services\Tcpip\Parameters')
+                tcp_params = winreg.OpenKey(
+                    lm, r"SYSTEM\CurrentControlSet" r"\Services\Tcpip\Parameters"
+                )
                 try:
                     self._config_fromkey(tcp_params, True)
                 finally:
                     tcp_params.Close()
-                interfaces = winreg.OpenKey(lm,
-                                            r'SYSTEM\CurrentControlSet'
-                                            r'\Services\Tcpip\Parameters'
-                                            r'\Interfaces')
+                interfaces = winreg.OpenKey(
+                    lm,
+                    r"SYSTEM\CurrentControlSet"
+                    r"\Services\Tcpip\Parameters"
+                    r"\Interfaces",
+                )
                 try:
                     i = 0
                     while True:
@@ -224,6 +239,7 @@ if sys.platform == 'win32':
                 lm.Close()
             return self.info
 
+    _getter_class: Any
     if _have_wmi and _prefer_wmi:
         _getter_class = _WMIGetter
     else:
diff --git a/lib/dns/wire.py b/lib/dns/wire.py
index 572e27e7..cadf1686 100644
--- a/lib/dns/wire.py
+++ b/lib/dns/wire.py
@@ -1,13 +1,16 @@
 # Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license
 
+from typing import Iterator, Optional, Tuple
+
 import contextlib
 import struct
 
 import dns.exception
 import dns.name
 
+
 class Parser:
-    def __init__(self, wire, current=0):
+    def __init__(self, wire: bytes, current: int = 0):
         self.wire = wire
         self.current = 0
         self.end = len(self.wire)
@@ -15,46 +18,47 @@ class Parser:
             self.seek(current)
         self.furthest = current
 
-    def remaining(self):
+    def remaining(self) -> int:
         return self.end - self.current
 
-    def get_bytes(self, size):
+    def get_bytes(self, size: int) -> bytes:
+        assert size >= 0
         if size > self.remaining():
             raise dns.exception.FormError
-        output = self.wire[self.current:self.current + size]
+        output = self.wire[self.current : self.current + size]
         self.current += size
         self.furthest = max(self.furthest, self.current)
         return output
 
-    def get_counted_bytes(self, length_size=1):
-        length = int.from_bytes(self.get_bytes(length_size), 'big')
+    def get_counted_bytes(self, length_size: int = 1) -> bytes:
+        length = int.from_bytes(self.get_bytes(length_size), "big")
         return self.get_bytes(length)
 
-    def get_remaining(self):
+    def get_remaining(self) -> bytes:
         return self.get_bytes(self.remaining())
 
-    def get_uint8(self):
-        return struct.unpack('!B', self.get_bytes(1))[0]
+    def get_uint8(self) -> int:
+        return struct.unpack("!B", self.get_bytes(1))[0]
 
-    def get_uint16(self):
-        return struct.unpack('!H', self.get_bytes(2))[0]
+    def get_uint16(self) -> int:
+        return struct.unpack("!H", self.get_bytes(2))[0]
 
-    def get_uint32(self):
-        return struct.unpack('!I', self.get_bytes(4))[0]
+    def get_uint32(self) -> int:
+        return struct.unpack("!I", self.get_bytes(4))[0]
 
-    def get_uint48(self):
-        return int.from_bytes(self.get_bytes(6), 'big')
+    def get_uint48(self) -> int:
+        return int.from_bytes(self.get_bytes(6), "big")
 
-    def get_struct(self, format):
+    def get_struct(self, format: str) -> Tuple:
         return struct.unpack(format, self.get_bytes(struct.calcsize(format)))
 
-    def get_name(self, origin=None):
+    def get_name(self, origin: Optional["dns.name.Name"] = None) -> "dns.name.Name":
         name = dns.name.from_wire_parser(self)
         if origin:
             name = name.relativize(origin)
         return name
 
-    def seek(self, where):
+    def seek(self, where: int) -> None:
         # Note that seeking to the end is OK!  (If you try to read
         # after such a seek, you'll get an exception as expected.)
         if where < 0 or where > self.end:
@@ -62,7 +66,8 @@ class Parser:
         self.current = where
 
     @contextlib.contextmanager
-    def restrict_to(self, size):
+    def restrict_to(self, size: int) -> Iterator:
+        assert size >= 0
         if size > self.remaining():
             raise dns.exception.FormError
         saved_end = self.end
@@ -78,7 +83,7 @@ class Parser:
             self.end = saved_end
 
     @contextlib.contextmanager
-    def restore_furthest(self):
+    def restore_furthest(self) -> Iterator:
         try:
             yield None
         finally:
diff --git a/lib/dns/xfr.py b/lib/dns/xfr.py
index cf9a163e..bb165888 100644
--- a/lib/dns/xfr.py
+++ b/lib/dns/xfr.py
@@ -15,12 +15,17 @@
 # ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
 # OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 
+from typing import Any, List, Optional, Tuple, Union
+
 import dns.exception
 import dns.message
 import dns.name
 import dns.rcode
 import dns.serial
+import dns.rdataset
 import dns.rdatatype
+import dns.transaction
+import dns.tsig
 import dns.zone
 
 
@@ -28,7 +33,7 @@ class TransferError(dns.exception.DNSException):
     """A zone transfer response got a non-zero rcode."""
 
     def __init__(self, rcode):
-        message = 'Zone transfer error: %s' % dns.rcode.to_text(rcode)
+        message = "Zone transfer error: %s" % dns.rcode.to_text(rcode)
         super().__init__(message)
         self.rcode = rcode
 
@@ -46,8 +51,13 @@ class Inbound:
     State machine for zone transfers.
     """
 
-    def __init__(self, txn_manager, rdtype=dns.rdatatype.AXFR,
-                 serial=None, is_udp=False):
+    def __init__(
+        self,
+        txn_manager: dns.transaction.TransactionManager,
+        rdtype: dns.rdatatype.RdataType = dns.rdatatype.AXFR,
+        serial: Optional[int] = None,
+        is_udp: bool = False,
+    ):
         """Initialize an inbound zone transfer.
 
         *txn_manager* is a :py:class:`dns.transaction.TransactionManager`.
@@ -61,22 +71,22 @@ class Inbound:
         XFR.
         """
         self.txn_manager = txn_manager
-        self.txn = None
+        self.txn: Optional[dns.transaction.Transaction] = None
         self.rdtype = rdtype
         if rdtype == dns.rdatatype.IXFR:
             if serial is None:
-                raise ValueError('a starting serial must be supplied for IXFRs')
+                raise ValueError("a starting serial must be supplied for IXFRs")
         elif is_udp:
-            raise ValueError('is_udp specified for AXFR')
+            raise ValueError("is_udp specified for AXFR")
         self.serial = serial
         self.is_udp = is_udp
         (_, _, self.origin) = txn_manager.origin_information()
-        self.soa_rdataset = None
+        self.soa_rdataset: Optional[dns.rdataset.Rdataset] = None
         self.done = False
         self.expecting_SOA = False
         self.delete_mode = False
 
-    def process_message(self, message):
+    def process_message(self, message: dns.message.Message) -> bool:
         """Process one message in the transfer.
 
         The message should have the same relativization as was specified when
@@ -107,10 +117,8 @@ class Inbound:
             # the origin.
             #
             if not message.answer or message.answer[0].name != self.origin:
-                raise dns.exception.FormError("No answer or RRset not "
-                                              "for zone origin")
+                raise dns.exception.FormError("No answer or RRset not for zone origin")
             rrset = message.answer[0]
-            name = rrset.name
             rdataset = rrset
             if rdataset.rdtype != dns.rdatatype.SOA:
                 raise dns.exception.FormError("first RRset is not an SOA")
@@ -122,8 +130,7 @@ class Inbound:
                     # We're already up-to-date.
                     #
                     self.done = True
-                elif dns.serial.Serial(self.soa_rdataset[0].serial) < \
-                     self.serial:
+                elif dns.serial.Serial(self.soa_rdataset[0].serial) < self.serial:
                     # It went backwards!
                     raise SerialWentBackwards
                 else:
@@ -147,8 +154,8 @@ class Inbound:
             rdataset = rrset
             if self.done:
                 raise dns.exception.FormError("answers after final SOA")
-            if rdataset.rdtype == dns.rdatatype.SOA and \
-               name == self.origin:
+            assert self.txn is not None  # for mypy
+            if rdataset.rdtype == dns.rdatatype.SOA and name == self.origin:
                 #
                 # Every time we see an origin SOA delete_mode inverts
                 #
@@ -160,20 +167,21 @@ class Inbound:
                 # check that we're seeing the record in the expected
                 # part of the response.
                 #
-                if rdataset == self.soa_rdataset and \
-                        (self.rdtype == dns.rdatatype.AXFR or
-                         (self.rdtype == dns.rdatatype.IXFR and
-                          self.delete_mode)):
+                if rdataset == self.soa_rdataset and (
+                    self.rdtype == dns.rdatatype.AXFR
+                    or (self.rdtype == dns.rdatatype.IXFR and self.delete_mode)
+                ):
                     #
                     # This is the final SOA
                     #
                     if self.expecting_SOA:
                         # We got an empty IXFR sequence!
-                        raise dns.exception.FormError('empty IXFR sequence')
-                    if self.rdtype == dns.rdatatype.IXFR \
-                       and self.serial != rdataset[0].serial:
-                        raise dns.exception.FormError('unexpected end of IXFR '
-                                                      'sequence')
+                        raise dns.exception.FormError("empty IXFR sequence")
+                    if (
+                        self.rdtype == dns.rdatatype.IXFR
+                        and self.serial != rdataset[0].serial
+                    ):
+                        raise dns.exception.FormError("unexpected end of IXFR sequence")
                     self.txn.replace(name, rdataset)
                     self.txn.commit()
                     self.txn = None
@@ -188,15 +196,15 @@ class Inbound:
                             # This is the start of an IXFR deletion set
                             if rdataset[0].serial != self.serial:
                                 raise dns.exception.FormError(
-                                    "IXFR base serial mismatch")
+                                    "IXFR base serial mismatch"
+                                )
                         else:
                             # This is the start of an IXFR addition set
                             self.serial = rdataset[0].serial
                             self.txn.replace(name, rdataset)
                     else:
                         # We saw a non-final SOA for the origin in an AXFR.
-                        raise dns.exception.FormError('unexpected origin SOA '
-                                                      'in AXFR')
+                        raise dns.exception.FormError("unexpected origin SOA in AXFR")
                 continue
             if self.expecting_SOA:
                 #
@@ -223,7 +231,7 @@ class Inbound:
             # This is a UDP IXFR and we didn't get to done, and we didn't
             # get the proper "truncated" response
             #
-            raise dns.exception.FormError('unexpected end of UDP IXFR')
+            raise dns.exception.FormError("unexpected end of UDP IXFR")
         return self.done
 
     #
@@ -239,11 +247,18 @@ class Inbound:
         return False
 
 
-def make_query(txn_manager, serial=0,
-               use_edns=None, ednsflags=None, payload=None,
-               request_payload=None, options=None,
-               keyring=None, keyname=None,
-               keyalgorithm=dns.tsig.default_algorithm):
+def make_query(
+    txn_manager: dns.transaction.TransactionManager,
+    serial: Optional[int] = 0,
+    use_edns: Optional[Union[int, bool]] = None,
+    ednsflags: Optional[int] = None,
+    payload: Optional[int] = None,
+    request_payload: Optional[int] = None,
+    options: Optional[List[dns.edns.Option]] = None,
+    keyring: Any = None,
+    keyname: Optional[dns.name.Name] = None,
+    keyalgorithm: Union[dns.name.Name, str] = dns.tsig.default_algorithm,
+) -> Tuple[dns.message.QueryMessage, Optional[int]]:
     """Make an AXFR or IXFR query.
 
     *txn_manager* is a ``dns.transaction.TransactionManager``, typically a
@@ -264,13 +279,15 @@ def make_query(txn_manager, serial=0,
     Returns a `(query, serial)` tuple.
     """
     (zone_origin, _, origin) = txn_manager.origin_information()
+    if zone_origin is None:
+        raise ValueError("no zone origin")
     if serial is None:
         rdtype = dns.rdatatype.AXFR
     elif not isinstance(serial, int):
-        raise ValueError('serial is not an integer')
+        raise ValueError("serial is not an integer")
     elif serial == 0:
         with txn_manager.reader() as txn:
-            rdataset = txn.get(origin, 'SOA')
+            rdataset = txn.get(origin, "SOA")
             if rdataset:
                 serial = rdataset[0].serial
                 rdtype = dns.rdatatype.IXFR
@@ -280,34 +297,47 @@ def make_query(txn_manager, serial=0,
     elif serial > 0 and serial < 4294967296:
         rdtype = dns.rdatatype.IXFR
     else:
-        raise ValueError('serial out-of-range')
+        raise ValueError("serial out-of-range")
     rdclass = txn_manager.get_class()
-    q = dns.message.make_query(zone_origin, rdtype, rdclass,
-                               use_edns, False, ednsflags, payload,
-                               request_payload, options)
+    q = dns.message.make_query(
+        zone_origin,
+        rdtype,
+        rdclass,
+        use_edns,
+        False,
+        ednsflags,
+        payload,
+        request_payload,
+        options,
+    )
     if serial is not None:
-        rdata = dns.rdata.from_text(rdclass, 'SOA', f'. . {serial} 0 0 0 0')
-        rrset = q.find_rrset(q.authority, zone_origin, rdclass,
-                             dns.rdatatype.SOA, create=True)
+        rdata = dns.rdata.from_text(rdclass, "SOA", f". . {serial} 0 0 0 0")
+        rrset = q.find_rrset(
+            q.authority, zone_origin, rdclass, dns.rdatatype.SOA, create=True
+        )
         rrset.add(rdata, 0)
     if keyring is not None:
         q.use_tsig(keyring, keyname, algorithm=keyalgorithm)
     return (q, serial)
 
-def extract_serial_from_query(query):
+
+def extract_serial_from_query(query: dns.message.Message) -> Optional[int]:
     """Extract the SOA serial number from query if it is an IXFR and return
     it, otherwise return None.
 
     *query* is a dns.message.QueryMessage that is an IXFR or AXFR request.
 
     Raises if the query is not an IXFR or AXFR, or if an IXFR doesn't have
-    an appropriate SOA RRset in the authority section."""
-
+    an appropriate SOA RRset in the authority section.
+    """
+    if not isinstance(query, dns.message.QueryMessage):
+        raise ValueError("query not a QueryMessage")
     question = query.question[0]
     if question.rdtype == dns.rdatatype.AXFR:
         return None
     elif question.rdtype != dns.rdatatype.IXFR:
         raise ValueError("query is not an AXFR or IXFR")
-    soa = query.find_rrset(query.authority, question.name, question.rdclass,
-                           dns.rdatatype.SOA)
+    soa = query.find_rrset(
+        query.authority, question.name, question.rdclass, dns.rdatatype.SOA
+    )
     return soa[0].serial
diff --git a/lib/dns/zone.py b/lib/dns/zone.py
index 5a649404..cc8268da 100644
--- a/lib/dns/zone.py
+++ b/lib/dns/zone.py
@@ -17,8 +17,9 @@
 
 """DNS Zones."""
 
+from typing import Any, Dict, Iterator, Iterable, List, Optional, Set, Tuple, Union
+
 import contextlib
-import hashlib
 import io
 import os
 import struct
@@ -30,6 +31,7 @@ import dns.node
 import dns.rdataclass
 import dns.rdatatype
 import dns.rdata
+import dns.rdataset
 import dns.rdtypes.ANY.SOA
 import dns.rdtypes.ANY.ZONEMD
 import dns.rrset
@@ -38,6 +40,7 @@ import dns.transaction
 import dns.ttl
 import dns.grange
 import dns.zonefile
+from dns.zonetypes import DigestScheme, DigestHashAlgorithm, _digest_hashers
 
 
 class BadZone(dns.exception.DNSException):
@@ -80,33 +83,6 @@ class DigestVerificationFailure(dns.exception.DNSException):
     """The ZONEMD digest failed to verify."""
 
 
-class DigestScheme(dns.enum.IntEnum):
-    """ZONEMD Scheme"""
-
-    SIMPLE = 1
-
-    @classmethod
-    def _maximum(cls):
-        return 255
-
-
-class DigestHashAlgorithm(dns.enum.IntEnum):
-    """ZONEMD Hash Algorithm"""
-
-    SHA384 = 1
-    SHA512 = 2
-
-    @classmethod
-    def _maximum(cls):
-        return 255
-
-
-_digest_hashers = {
-    DigestHashAlgorithm.SHA384: hashlib.sha384,
-    DigestHashAlgorithm.SHA512: hashlib.sha512,
-}
-
-
 class Zone(dns.transaction.TransactionManager):
 
     """A DNS zone.
@@ -121,9 +97,14 @@ class Zone(dns.transaction.TransactionManager):
 
     node_factory = dns.node.Node
 
-    __slots__ = ['rdclass', 'origin', 'nodes', 'relativize']
+    __slots__ = ["rdclass", "origin", "nodes", "relativize"]
 
-    def __init__(self, origin, rdclass=dns.rdataclass.IN, relativize=True):
+    def __init__(
+        self,
+        origin: Optional[Union[dns.name.Name, str]],
+        rdclass: dns.rdataclass.RdataClass = dns.rdataclass.IN,
+        relativize: bool = True,
+    ):
         """Initialize a zone object.
 
         *origin* is the origin of the zone.  It may be a ``dns.name.Name``,
@@ -140,13 +121,12 @@ class Zone(dns.transaction.TransactionManager):
             if isinstance(origin, str):
                 origin = dns.name.from_text(origin)
             elif not isinstance(origin, dns.name.Name):
-                raise ValueError("origin parameter must be convertible to a "
-                                 "DNS name")
+                raise ValueError("origin parameter must be convertible to a DNS name")
             if not origin.is_absolute():
                 raise ValueError("origin parameter must be an absolute name")
         self.origin = origin
         self.rdclass = rdclass
-        self.nodes = {}
+        self.nodes: Dict[dns.name.Name, dns.node.Node] = {}
         self.relativize = relativize
 
     def __eq__(self, other):
@@ -158,9 +138,11 @@ class Zone(dns.transaction.TransactionManager):
 
         if not isinstance(other, Zone):
             return False
-        if self.rdclass != other.rdclass or \
-           self.origin != other.origin or \
-           self.nodes != other.nodes:
+        if (
+            self.rdclass != other.rdclass
+            or self.origin != other.origin
+            or self.nodes != other.nodes
+        ):
             return False
         return True
 
@@ -172,21 +154,25 @@ class Zone(dns.transaction.TransactionManager):
 
         return not self.__eq__(other)
 
-    def _validate_name(self, name):
+    def _validate_name(self, name: Union[dns.name.Name, str]) -> dns.name.Name:
         if isinstance(name, str):
             name = dns.name.from_text(name, None)
         elif not isinstance(name, dns.name.Name):
             raise KeyError("name parameter must be convertible to a DNS name")
         if name.is_absolute():
+            if self.origin is None:
+                # This should probably never happen as other code (e.g.
+                # _rr_line) will notice the lack of an origin before us, but
+                # we check just in case!
+                raise KeyError("no zone origin is defined")
             if not name.is_subdomain(self.origin):
-                raise KeyError(
-                    "name parameter must be a subdomain of the zone origin")
+                raise KeyError("name parameter must be a subdomain of the zone origin")
             if self.relativize:
                 name = name.relativize(self.origin)
         elif not self.relativize:
             # We have a relative name in a non-relative zone, so derelativize.
             if self.origin is None:
-                raise KeyError('no zone origin is defined')
+                raise KeyError("no zone origin is defined")
             name = name.derelativize(self.origin)
         return name
 
@@ -222,7 +208,9 @@ class Zone(dns.transaction.TransactionManager):
         key = self._validate_name(key)
         return key in self.nodes
 
-    def find_node(self, name, create=False):
+    def find_node(
+        self, name: Union[dns.name.Name, str], create: bool = False
+    ) -> dns.node.Node:
         """Find a node in the zone, possibly creating it.
 
         *name*: the name of the node to find.
@@ -248,7 +236,9 @@ class Zone(dns.transaction.TransactionManager):
             self.nodes[name] = node
         return node
 
-    def get_node(self, name, create=False):
+    def get_node(
+        self, name: Union[dns.name.Name, str], create: bool = False
+    ) -> Optional[dns.node.Node]:
         """Get a node in the zone, possibly creating it.
 
         This method is like ``find_node()``, except it returns None instead
@@ -275,7 +265,7 @@ class Zone(dns.transaction.TransactionManager):
             node = None
         return node
 
-    def delete_node(self, name):
+    def delete_node(self, name: Union[dns.name.Name, str]) -> None:
         """Delete the specified node if it exists.
 
         *name*: the name of the node to find.
@@ -290,8 +280,13 @@ class Zone(dns.transaction.TransactionManager):
         if name in self.nodes:
             del self.nodes[name]
 
-    def find_rdataset(self, name, rdtype, covers=dns.rdatatype.NONE,
-                      create=False):
+    def find_rdataset(
+        self,
+        name: Union[dns.name.Name, str],
+        rdtype: Union[dns.rdatatype.RdataType, str],
+        covers: Union[dns.rdatatype.RdataType, str] = dns.rdatatype.NONE,
+        create: bool = False,
+    ) -> dns.rdataset.Rdataset:
         """Look for an rdataset with the specified name and type in the zone,
         and return an rdataset encapsulating it.
 
@@ -305,9 +300,9 @@ class Zone(dns.transaction.TransactionManager):
         name must be a subdomain of the zone's origin.  If ``zone.relativize``
         is ``True``, then the name will be relativized.
 
-        *rdtype*, an ``int`` or ``str``, the rdata type desired.
+        *rdtype*, a ``dns.rdatatype.RdataType`` or ``str``, the rdata type desired.
 
-        *covers*, an ``int`` or ``str`` or ``None``, the covered type.
+        *covers*, a ``dns.rdatatype.RdataType`` or ``str`` the covered type.
         Usually this value is ``dns.rdatatype.NONE``, but if the
         rdtype is ``dns.rdatatype.SIG`` or ``dns.rdatatype.RRSIG``,
         then the covers value will be the rdata type the SIG/RRSIG
@@ -326,15 +321,19 @@ class Zone(dns.transaction.TransactionManager):
         Returns a ``dns.rdataset.Rdataset``.
         """
 
-        name = self._validate_name(name)
-        rdtype = dns.rdatatype.RdataType.make(rdtype)
-        if covers is not None:
-            covers = dns.rdatatype.RdataType.make(covers)
-        node = self.find_node(name, create)
-        return node.find_rdataset(self.rdclass, rdtype, covers, create)
+        the_name = self._validate_name(name)
+        the_rdtype = dns.rdatatype.RdataType.make(rdtype)
+        the_covers = dns.rdatatype.RdataType.make(covers)
+        node = self.find_node(the_name, create)
+        return node.find_rdataset(self.rdclass, the_rdtype, the_covers, create)
 
-    def get_rdataset(self, name, rdtype, covers=dns.rdatatype.NONE,
-                     create=False):
+    def get_rdataset(
+        self,
+        name: Union[dns.name.Name, str],
+        rdtype: Union[dns.rdatatype.RdataType, str],
+        covers: Union[dns.rdatatype.RdataType, str] = dns.rdatatype.NONE,
+        create: bool = False,
+    ) -> Optional[dns.rdataset.Rdataset]:
         """Look for an rdataset with the specified name and type in the zone.
 
         This method is like ``find_rdataset()``, except it returns None instead
@@ -349,9 +348,9 @@ class Zone(dns.transaction.TransactionManager):
         name must be a subdomain of the zone's origin.  If ``zone.relativize``
         is ``True``, then the name will be relativized.
 
-        *rdtype*, an ``int`` or ``str``, the rdata type desired.
+        *rdtype*, a ``dns.rdatatype.RdataType`` or ``str``, the rdata type desired.
 
-        *covers*, an ``int`` or ``str`` or ``None``, the covered type.
+        *covers*, a ``dns.rdatatype.RdataType`` or ``str``, the covered type.
         Usually this value is ``dns.rdatatype.NONE``, but if the
         rdtype is ``dns.rdatatype.SIG`` or ``dns.rdatatype.RRSIG``,
         then the covers value will be the rdata type the SIG/RRSIG
@@ -376,45 +375,47 @@ class Zone(dns.transaction.TransactionManager):
             rdataset = None
         return rdataset
 
-    def delete_rdataset(self, name, rdtype, covers=dns.rdatatype.NONE):
+    def delete_rdataset(
+        self,
+        name: Union[dns.name.Name, str],
+        rdtype: Union[dns.rdatatype.RdataType, str],
+        covers: Union[dns.rdatatype.RdataType, str] = dns.rdatatype.NONE,
+    ) -> None:
         """Delete the rdataset matching *rdtype* and *covers*, if it
         exists at the node specified by *name*.
 
-        It is not an error if the node does not exist, or if there is no
-        matching rdataset at the node.
+        It is not an error if the node does not exist, or if there is no matching
+        rdataset at the node.
 
-        If the node has no rdatasets after the deletion, it will itself
-        be deleted.
+        If the node has no rdatasets after the deletion, it will itself be deleted.
 
-        *name*: the name of the node to find.
-        The value may be a ``dns.name.Name`` or a ``str``.  If absolute, the
-        name must be a subdomain of the zone's origin.  If ``zone.relativize``
-        is ``True``, then the name will be relativized.
+        *name*: the name of the node to find. The value may be a ``dns.name.Name`` or a
+        ``str``.  If absolute, the name must be a subdomain of the zone's origin.  If
+        ``zone.relativize`` is ``True``, then the name will be relativized.
 
-        *rdtype*, an ``int`` or ``str``, the rdata type desired.
+        *rdtype*, a ``dns.rdatatype.RdataType`` or ``str``, the rdata type desired.
 
-        *covers*, an ``int`` or ``str`` or ``None``, the covered type.
-        Usually this value is ``dns.rdatatype.NONE``, but if the
-        rdtype is ``dns.rdatatype.SIG`` or ``dns.rdatatype.RRSIG``,
-        then the covers value will be the rdata type the SIG/RRSIG
-        covers.  The library treats the SIG and RRSIG types as if they
-        were a family of types, e.g. RRSIG(A), RRSIG(NS), RRSIG(SOA).
-        This makes RRSIGs much easier to work with than if RRSIGs
-        covering different rdata types were aggregated into a single
-        RRSIG rdataset.
+        *covers*, a ``dns.rdatatype.RdataType`` or ``str`` or ``None``, the covered
+        type. Usually this value is ``dns.rdatatype.NONE``, but if the rdtype is
+        ``dns.rdatatype.SIG`` or ``dns.rdatatype.RRSIG``, then the covers value will be
+        the rdata type the SIG/RRSIG covers.  The library treats the SIG and RRSIG types
+        as if they were a family of types, e.g. RRSIG(A), RRSIG(NS), RRSIG(SOA). This
+        makes RRSIGs much easier to work with than if RRSIGs covering different rdata
+        types were aggregated into a single RRSIG rdataset.
         """
 
-        name = self._validate_name(name)
-        rdtype = dns.rdatatype.RdataType.make(rdtype)
-        if covers is not None:
-            covers = dns.rdatatype.RdataType.make(covers)
-        node = self.get_node(name)
+        the_name = self._validate_name(name)
+        the_rdtype = dns.rdatatype.RdataType.make(rdtype)
+        the_covers = dns.rdatatype.RdataType.make(covers)
+        node = self.get_node(the_name)
         if node is not None:
-            node.delete_rdataset(self.rdclass, rdtype, covers)
+            node.delete_rdataset(self.rdclass, the_rdtype, the_covers)
             if len(node) == 0:
-                self.delete_node(name)
+                self.delete_node(the_name)
 
-    def replace_rdataset(self, name, replacement):
+    def replace_rdataset(
+        self, name: Union[dns.name.Name, str], replacement: dns.rdataset.Rdataset
+    ) -> None:
         """Replace an rdataset at name.
 
         It is not an error if there is no rdataset matching I{replacement}.
@@ -434,11 +435,16 @@ class Zone(dns.transaction.TransactionManager):
         """
 
         if replacement.rdclass != self.rdclass:
-            raise ValueError('replacement.rdclass != zone.rdclass')
+            raise ValueError("replacement.rdclass != zone.rdclass")
         node = self.find_node(name, True)
         node.replace_rdataset(replacement)
 
-    def find_rrset(self, name, rdtype, covers=dns.rdatatype.NONE):
+    def find_rrset(
+        self,
+        name: Union[dns.name.Name, str],
+        rdtype: Union[dns.rdatatype.RdataType, str],
+        covers: Union[dns.rdatatype.RdataType, str] = dns.rdatatype.NONE,
+    ) -> dns.rrset.RRset:
         """Look for an rdataset with the specified name and type in the zone,
         and return an RRset encapsulating it.
 
@@ -456,9 +462,9 @@ class Zone(dns.transaction.TransactionManager):
         name must be a subdomain of the zone's origin.  If ``zone.relativize``
         is ``True``, then the name will be relativized.
 
-        *rdtype*, an ``int`` or ``str``, the rdata type desired.
+        *rdtype*, a ``dns.rdatatype.RdataType`` or ``str``, the rdata type desired.
 
-        *covers*, an ``int`` or ``str`` or ``None``, the covered type.
+        *covers*, a ``dns.rdatatype.RdataType`` or ``str``, the covered type.
         Usually this value is ``dns.rdatatype.NONE``, but if the
         rdtype is ``dns.rdatatype.SIG`` or ``dns.rdatatype.RRSIG``,
         then the covers value will be the rdata type the SIG/RRSIG
@@ -477,16 +483,20 @@ class Zone(dns.transaction.TransactionManager):
         Returns a ``dns.rrset.RRset`` or ``None``.
         """
 
-        name = self._validate_name(name)
-        rdtype = dns.rdatatype.RdataType.make(rdtype)
-        if covers is not None:
-            covers = dns.rdatatype.RdataType.make(covers)
-        rdataset = self.nodes[name].find_rdataset(self.rdclass, rdtype, covers)
-        rrset = dns.rrset.RRset(name, self.rdclass, rdtype, covers)
+        vname = self._validate_name(name)
+        the_rdtype = dns.rdatatype.RdataType.make(rdtype)
+        the_covers = dns.rdatatype.RdataType.make(covers)
+        rdataset = self.nodes[vname].find_rdataset(self.rdclass, the_rdtype, the_covers)
+        rrset = dns.rrset.RRset(vname, self.rdclass, the_rdtype, the_covers)
         rrset.update(rdataset)
         return rrset
 
-    def get_rrset(self, name, rdtype, covers=dns.rdatatype.NONE):
+    def get_rrset(
+        self,
+        name: Union[dns.name.Name, str],
+        rdtype: Union[dns.rdatatype.RdataType, str],
+        covers: Union[dns.rdatatype.RdataType, str] = dns.rdatatype.NONE,
+    ) -> Optional[dns.rrset.RRset]:
         """Look for an rdataset with the specified name and type in the zone,
         and return an RRset encapsulating it.
 
@@ -503,9 +513,9 @@ class Zone(dns.transaction.TransactionManager):
         name must be a subdomain of the zone's origin.  If ``zone.relativize``
         is ``True``, then the name will be relativized.
 
-        *rdtype*, an ``int`` or ``str``, the rdata type desired.
+        *rdtype*, a ``dns.rdataset.Rdataset`` or ``str``, the rdata type desired.
 
-        *covers*, an ``int`` or ``str`` or ``None``, the covered type.
+        *covers*, a ``dns.rdataset.Rdataset`` or ``str``, the covered type.
         Usually this value is ``dns.rdatatype.NONE``, but if the
         rdtype is ``dns.rdatatype.SIG`` or ``dns.rdatatype.RRSIG``,
         then the covers value will be the rdata type the SIG/RRSIG
@@ -530,16 +540,19 @@ class Zone(dns.transaction.TransactionManager):
             rrset = None
         return rrset
 
-    def iterate_rdatasets(self, rdtype=dns.rdatatype.ANY,
-                          covers=dns.rdatatype.NONE):
+    def iterate_rdatasets(
+        self,
+        rdtype: Union[dns.rdatatype.RdataType, str] = dns.rdatatype.ANY,
+        covers: Union[dns.rdatatype.RdataType, str] = dns.rdatatype.NONE,
+    ) -> Iterator[Tuple[dns.name.Name, dns.rdataset.Rdataset]]:
         """Return a generator which yields (name, rdataset) tuples for
         all rdatasets in the zone which have the specified *rdtype*
         and *covers*.  If *rdtype* is ``dns.rdatatype.ANY``, the default,
         then all rdatasets will be matched.
 
-        *rdtype*, an ``int`` or ``str``, the rdata type desired.
+        *rdtype*, a ``dns.rdataset.Rdataset`` or ``str``, the rdata type desired.
 
-        *covers*, an ``int`` or ``str`` or ``None``, the covered type.
+        *covers*, a ``dns.rdataset.Rdataset`` or ``str``, the covered type.
         Usually this value is ``dns.rdatatype.NONE``, but if the
         rdtype is ``dns.rdatatype.SIG`` or ``dns.rdatatype.RRSIG``,
         then the covers value will be the rdata type the SIG/RRSIG
@@ -551,24 +564,27 @@ class Zone(dns.transaction.TransactionManager):
         """
 
         rdtype = dns.rdatatype.RdataType.make(rdtype)
-        if covers is not None:
-            covers = dns.rdatatype.RdataType.make(covers)
+        covers = dns.rdatatype.RdataType.make(covers)
         for (name, node) in self.items():
             for rds in node:
-                if rdtype == dns.rdatatype.ANY or \
-                   (rds.rdtype == rdtype and rds.covers == covers):
+                if rdtype == dns.rdatatype.ANY or (
+                    rds.rdtype == rdtype and rds.covers == covers
+                ):
                     yield (name, rds)
 
-    def iterate_rdatas(self, rdtype=dns.rdatatype.ANY,
-                       covers=dns.rdatatype.NONE):
+    def iterate_rdatas(
+        self,
+        rdtype: Union[dns.rdatatype.RdataType, str] = dns.rdatatype.ANY,
+        covers: Union[dns.rdatatype.RdataType, str] = dns.rdatatype.NONE,
+    ) -> Iterator[Tuple[dns.name.Name, int, dns.rdata.Rdata]]:
         """Return a generator which yields (name, ttl, rdata) tuples for
         all rdatas in the zone which have the specified *rdtype*
         and *covers*.  If *rdtype* is ``dns.rdatatype.ANY``, the default,
         then all rdatas will be matched.
 
-        *rdtype*, an ``int`` or ``str``, the rdata type desired.
+        *rdtype*, a ``dns.rdataset.Rdataset`` or ``str``, the rdata type desired.
 
-        *covers*, an ``int`` or ``str`` or ``None``, the covered type.
+        *covers*, a ``dns.rdataset.Rdataset`` or ``str``, the covered type.
         Usually this value is ``dns.rdatatype.NONE``, but if the
         rdtype is ``dns.rdatatype.SIG`` or ``dns.rdatatype.RRSIG``,
         then the covers value will be the rdata type the SIG/RRSIG
@@ -580,17 +596,24 @@ class Zone(dns.transaction.TransactionManager):
         """
 
         rdtype = dns.rdatatype.RdataType.make(rdtype)
-        if covers is not None:
-            covers = dns.rdatatype.RdataType.make(covers)
+        covers = dns.rdatatype.RdataType.make(covers)
         for (name, node) in self.items():
             for rds in node:
-                if rdtype == dns.rdatatype.ANY or \
-                   (rds.rdtype == rdtype and rds.covers == covers):
+                if rdtype == dns.rdatatype.ANY or (
+                    rds.rdtype == rdtype and rds.covers == covers
+                ):
                     for rdata in rds:
                         yield (name, rds.ttl, rdata)
 
-    def to_file(self, f, sorted=True, relativize=True, nl=None,
-                want_comments=False, want_origin=False):
+    def to_file(
+        self,
+        f: Any,
+        sorted: bool = True,
+        relativize: bool = True,
+        nl: Optional[str] = None,
+        want_comments: bool = False,
+        want_origin: bool = False,
+    ) -> None:
         """Write a zone to a file.
 
         *f*, a file or `str`.  If *f* is a string, it is treated
@@ -618,20 +641,21 @@ class Zone(dns.transaction.TransactionManager):
         one.
         """
 
-        with contextlib.ExitStack() as stack:
-            if isinstance(f, str):
-                f = stack.enter_context(open(f, 'wb'))
-
+        if isinstance(f, str):
+            cm: contextlib.AbstractContextManager = open(f, "wb")
+        else:
+            cm = contextlib.nullcontext(f)
+        with cm as f:
             # must be in this way, f.encoding may contain None, or even
             # attribute may not be there
-            file_enc = getattr(f, 'encoding', None)
+            file_enc = getattr(f, "encoding", None)
             if file_enc is None:
-                file_enc = 'utf-8'
+                file_enc = "utf-8"
 
             if nl is None:
                 # binary mode, '\n' is not enough
                 nl_b = os.linesep.encode(file_enc)
-                nl = '\n'
+                nl = "\n"
             elif isinstance(nl, str):
                 nl_b = nl.encode(file_enc)
             else:
@@ -639,7 +663,8 @@ class Zone(dns.transaction.TransactionManager):
                 nl = nl.decode()
 
             if want_origin:
-                l = '$ORIGIN ' + self.origin.to_text()
+                assert self.origin is not None
+                l = "$ORIGIN " + self.origin.to_text()
                 l_b = l.encode(file_enc)
                 try:
                     f.write(l_b)
@@ -654,9 +679,12 @@ class Zone(dns.transaction.TransactionManager):
             else:
                 names = self.keys()
             for n in names:
-                l = self[n].to_text(n, origin=self.origin,
-                                    relativize=relativize,
-                                    want_comments=want_comments)
+                l = self[n].to_text(
+                    n,
+                    origin=self.origin,
+                    relativize=relativize,
+                    want_comments=want_comments,
+                )
                 l_b = l.encode(file_enc)
 
                 try:
@@ -666,8 +694,14 @@ class Zone(dns.transaction.TransactionManager):
                     f.write(l)
                     f.write(nl)
 
-    def to_text(self, sorted=True, relativize=True, nl=None,
-                want_comments=False, want_origin=False):
+    def to_text(
+        self,
+        sorted: bool = True,
+        relativize: bool = True,
+        nl: Optional[str] = None,
+        want_comments: bool = False,
+        want_origin: bool = False,
+    ) -> str:
         """Return a zone's text as though it were written to a file.
 
         *sorted*, a ``bool``.  If True, the default, then the file
@@ -694,13 +728,12 @@ class Zone(dns.transaction.TransactionManager):
         Returns a ``str``.
         """
         temp_buffer = io.StringIO()
-        self.to_file(temp_buffer, sorted, relativize, nl, want_comments,
-                     want_origin)
+        self.to_file(temp_buffer, sorted, relativize, nl, want_comments, want_origin)
         return_value = temp_buffer.getvalue()
         temp_buffer.close()
         return return_value
 
-    def check_origin(self):
+    def check_origin(self) -> None:
         """Do some simple checking of the zone's origin.
 
         Raises ``dns.zone.NoSOA`` if there is no SOA RRset.
@@ -712,13 +745,44 @@ class Zone(dns.transaction.TransactionManager):
         if self.relativize:
             name = dns.name.empty
         else:
+            assert self.origin is not None
             name = self.origin
         if self.get_rdataset(name, dns.rdatatype.SOA) is None:
             raise NoSOA
         if self.get_rdataset(name, dns.rdatatype.NS) is None:
             raise NoNS
 
-    def _compute_digest(self, hash_algorithm, scheme=DigestScheme.SIMPLE):
+    def get_soa(
+        self, txn: Optional[dns.transaction.Transaction] = None
+    ) -> dns.rdtypes.ANY.SOA.SOA:
+        """Get the zone SOA rdata.
+
+        Raises ``dns.zone.NoSOA`` if there is no SOA RRset.
+
+        Returns a ``dns.rdtypes.ANY.SOA.SOA`` Rdata.
+        """
+        if self.relativize:
+            origin_name = dns.name.empty
+        else:
+            if self.origin is None:
+                # get_soa() has been called very early, and there must not be
+                # an SOA if there is no origin.
+                raise NoSOA
+            origin_name = self.origin
+        soa: Optional[dns.rdataset.Rdataset]
+        if txn:
+            soa = txn.get(origin_name, dns.rdatatype.SOA)
+        else:
+            soa = self.get_rdataset(origin_name, dns.rdatatype.SOA)
+        if soa is None:
+            raise NoSOA
+        return soa[0]
+
+    def _compute_digest(
+        self,
+        hash_algorithm: DigestHashAlgorithm,
+        scheme: DigestScheme = DigestScheme.SIMPLE,
+    ) -> bytes:
         hashinfo = _digest_hashers.get(hash_algorithm)
         if not hashinfo:
             raise UnsupportedDigestHashAlgorithm
@@ -728,47 +792,52 @@ class Zone(dns.transaction.TransactionManager):
         if self.relativize:
             origin_name = dns.name.empty
         else:
+            assert self.origin is not None
             origin_name = self.origin
         hasher = hashinfo()
         for (name, node) in sorted(self.items()):
             rrnamebuf = name.to_digestable(self.origin)
-            for rdataset in sorted(node,
-                                   key=lambda rds: (rds.rdtype, rds.covers)):
-                if name == origin_name and \
-                   dns.rdatatype.ZONEMD in (rdataset.rdtype, rdataset.covers):
+            for rdataset in sorted(node, key=lambda rds: (rds.rdtype, rds.covers)):
+                if name == origin_name and dns.rdatatype.ZONEMD in (
+                    rdataset.rdtype,
+                    rdataset.covers,
+                ):
                     continue
-                rrfixed = struct.pack('!HHI', rdataset.rdtype,
-                                      rdataset.rdclass, rdataset.ttl)
-                rdatas = [rdata.to_digestable(self.origin)
-                          for rdata in rdataset]
+                rrfixed = struct.pack(
+                    "!HHI", rdataset.rdtype, rdataset.rdclass, rdataset.ttl
+                )
+                rdatas = [rdata.to_digestable(self.origin) for rdata in rdataset]
                 for rdata in sorted(rdatas):
-                    rrlen = struct.pack('!H', len(rdata))
+                    rrlen = struct.pack("!H", len(rdata))
                     hasher.update(rrnamebuf + rrfixed + rrlen + rdata)
         return hasher.digest()
 
-    def compute_digest(self, hash_algorithm, scheme=DigestScheme.SIMPLE):
-        if self.relativize:
-            origin_name = dns.name.empty
-        else:
-            origin_name = self.origin
-        serial = self.get_rdataset(origin_name, dns.rdatatype.SOA)[0].serial
+    def compute_digest(
+        self,
+        hash_algorithm: DigestHashAlgorithm,
+        scheme: DigestScheme = DigestScheme.SIMPLE,
+    ) -> dns.rdtypes.ANY.ZONEMD.ZONEMD:
+        serial = self.get_soa().serial
         digest = self._compute_digest(hash_algorithm, scheme)
-        return dns.rdtypes.ANY.ZONEMD.ZONEMD(self.rdclass,
-                                             dns.rdatatype.ZONEMD,
-                                             serial, scheme, hash_algorithm,
-                                             digest)
+        return dns.rdtypes.ANY.ZONEMD.ZONEMD(
+            self.rdclass, dns.rdatatype.ZONEMD, serial, scheme, hash_algorithm, digest
+        )
 
-    def verify_digest(self, zonemd=None):
+    def verify_digest(
+        self, zonemd: Optional[dns.rdtypes.ANY.ZONEMD.ZONEMD] = None
+    ) -> None:
+        digests: Union[dns.rdataset.Rdataset, List[dns.rdtypes.ANY.ZONEMD.ZONEMD]]
         if zonemd:
             digests = [zonemd]
         else:
-            digests = self.get_rdataset(self.origin, dns.rdatatype.ZONEMD)
-            if digests is None:
+            assert self.origin is not None
+            rds = self.get_rdataset(self.origin, dns.rdatatype.ZONEMD)
+            if rds is None:
                 raise NoDigest
+            digests = rds
         for digest in digests:
             try:
-                computed = self._compute_digest(digest.hash_algorithm,
-                                                digest.scheme)
+                computed = self._compute_digest(digest.hash_algorithm, digest.scheme)
                 if computed == digest.digest:
                     return
             except Exception:
@@ -777,16 +846,18 @@ class Zone(dns.transaction.TransactionManager):
 
     # TransactionManager methods
 
-    def reader(self):
-        return Transaction(self, False,
-                           Version(self, 1, self.nodes, self.origin))
+    def reader(self) -> "Transaction":
+        return Transaction(self, False, Version(self, 1, self.nodes, self.origin))
 
-    def writer(self, replacement=False):
+    def writer(self, replacement: bool = False) -> "Transaction":
         txn = Transaction(self, replacement)
         txn._setup_version()
         return txn
 
-    def origin_information(self):
+    def origin_information(
+        self,
+    ) -> Tuple[Optional[dns.name.Name], bool, Optional[dns.name.Name]]:
+        effective: Optional[dns.name.Name]
         if self.relativize:
             effective = dns.name.empty
         else:
@@ -821,8 +892,9 @@ class Zone(dns.transaction.TransactionManager):
 
 # A node with a version id.
 
-class VersionedNode(dns.node.Node):
-    __slots__ = ['id']
+
+class VersionedNode(dns.node.Node):  # lgtm[py/missing-equals]
+    __slots__ = ["id"]
 
     def __init__(self):
         super().__init__()
@@ -832,8 +904,6 @@ class VersionedNode(dns.node.Node):
 
 @dns.immutable.immutable
 class ImmutableVersionedNode(VersionedNode):
-    __slots__ = ['id']
-
     def __init__(self, node):
         super().__init__()
         self.id = node.id
@@ -841,30 +911,51 @@ class ImmutableVersionedNode(VersionedNode):
             [dns.rdataset.ImmutableRdataset(rds) for rds in node.rdatasets]
         )
 
-    def find_rdataset(self, rdclass, rdtype, covers=dns.rdatatype.NONE,
-                      create=False):
+    def find_rdataset(
+        self,
+        rdclass: dns.rdataclass.RdataClass,
+        rdtype: dns.rdatatype.RdataType,
+        covers: dns.rdatatype.RdataType = dns.rdatatype.NONE,
+        create: bool = False,
+    ) -> dns.rdataset.Rdataset:
         if create:
             raise TypeError("immutable")
         return super().find_rdataset(rdclass, rdtype, covers, False)
 
-    def get_rdataset(self, rdclass, rdtype, covers=dns.rdatatype.NONE,
-                     create=False):
+    def get_rdataset(
+        self,
+        rdclass: dns.rdataclass.RdataClass,
+        rdtype: dns.rdatatype.RdataType,
+        covers: dns.rdatatype.RdataType = dns.rdatatype.NONE,
+        create: bool = False,
+    ) -> Optional[dns.rdataset.Rdataset]:
         if create:
             raise TypeError("immutable")
         return super().get_rdataset(rdclass, rdtype, covers, False)
 
-    def delete_rdataset(self, rdclass, rdtype, covers=dns.rdatatype.NONE):
+    def delete_rdataset(
+        self,
+        rdclass: dns.rdataclass.RdataClass,
+        rdtype: dns.rdatatype.RdataType,
+        covers: dns.rdatatype.RdataType = dns.rdatatype.NONE,
+    ) -> None:
         raise TypeError("immutable")
 
-    def replace_rdataset(self, replacement):
+    def replace_rdataset(self, replacement: dns.rdataset.Rdataset) -> None:
         raise TypeError("immutable")
 
-    def is_immutable(self):
+    def is_immutable(self) -> bool:
         return True
 
 
 class Version:
-    def __init__(self, zone, id, nodes=None, origin=None):
+    def __init__(
+        self,
+        zone: Zone,
+        id: int,
+        nodes: Optional[Dict[dns.name.Name, dns.node.Node]] = None,
+        origin: Optional[dns.name.Name] = None,
+    ):
         self.zone = zone
         self.id = id
         if nodes is not None:
@@ -873,13 +964,13 @@ class Version:
             self.nodes = {}
         self.origin = origin
 
-    def _validate_name(self, name):
+    def _validate_name(self, name: dns.name.Name) -> dns.name.Name:
         if name.is_absolute():
             if self.origin is None:
                 # This should probably never happen as other code (e.g.
                 # _rr_line) will notice the lack of an origin before us, but
                 # we check just in case!
-                raise KeyError('no zone origin is defined')
+                raise KeyError("no zone origin is defined")
             if not name.is_subdomain(self.origin):
                 raise KeyError("name is not a subdomain of the zone origin")
             if self.zone.relativize:
@@ -887,15 +978,20 @@ class Version:
         elif not self.zone.relativize:
             # We have a relative name in a non-relative zone, so derelativize.
             if self.origin is None:
-                raise KeyError('no zone origin is defined')
+                raise KeyError("no zone origin is defined")
             name = name.derelativize(self.origin)
         return name
 
-    def get_node(self, name):
+    def get_node(self, name: dns.name.Name) -> Optional[dns.node.Node]:
         name = self._validate_name(name)
         return self.nodes.get(name)
 
-    def get_rdataset(self, name, rdtype, covers):
+    def get_rdataset(
+        self,
+        name: dns.name.Name,
+        rdtype: dns.rdatatype.RdataType,
+        covers: dns.rdatatype.RdataType,
+    ) -> Optional[dns.rdataset.Rdataset]:
         node = self.get_node(name)
         if node is None:
             return None
@@ -906,7 +1002,7 @@ class Version:
 
 
 class WritableVersion(Version):
-    def __init__(self, zone, replacement=False):
+    def __init__(self, zone: Zone, replacement: bool = False):
         # The zone._versions_lock must be held by our caller in a versioned
         # zone.
         id = zone._get_next_version_id()
@@ -920,19 +1016,21 @@ class WritableVersion(Version):
         # We have to copy the zone origin as it may be None in the first
         # version, and we don't want to mutate the zone until we commit.
         self.origin = zone.origin
-        self.changed = set()
+        self.changed: Set[dns.name.Name] = set()
 
-    def _maybe_cow(self, name):
+    def _maybe_cow(self, name: dns.name.Name) -> dns.node.Node:
         name = self._validate_name(name)
         node = self.nodes.get(name)
         if node is None or name not in self.changed:
             new_node = self.zone.node_factory()
-            if hasattr(new_node, 'id'):
+            if hasattr(new_node, "id"):
                 # We keep doing this for backwards compatibility, as earlier
                 # code used new_node.id != self.id for the "do we need to CoW?"
                 # test.  Now we use the changed set as this works with both
                 # regular zones and versioned zones.
-                new_node.id = self.id
+                #
+                # We ignore the mypy error as this is safe but it doesn't see it.
+                new_node.id = self.id  # type: ignore
             if node is not None:
                 # moo!  copy on write!
                 new_node.rdatasets.extend(node.rdatasets)
@@ -942,17 +1040,24 @@ class WritableVersion(Version):
         else:
             return node
 
-    def delete_node(self, name):
+    def delete_node(self, name: dns.name.Name) -> None:
         name = self._validate_name(name)
         if name in self.nodes:
             del self.nodes[name]
             self.changed.add(name)
 
-    def put_rdataset(self, name, rdataset):
+    def put_rdataset(
+        self, name: dns.name.Name, rdataset: dns.rdataset.Rdataset
+    ) -> None:
         node = self._maybe_cow(name)
         node.replace_rdataset(rdataset)
 
-    def delete_rdataset(self, name, rdtype, covers):
+    def delete_rdataset(
+        self,
+        name: dns.name.Name,
+        rdtype: dns.rdatatype.RdataType,
+        covers: dns.rdatatype.RdataType,
+    ) -> None:
         node = self._maybe_cow(name)
         node.delete_rdataset(self.zone.rdclass, rdtype, covers)
         if len(node) == 0:
@@ -961,7 +1066,7 @@ class WritableVersion(Version):
 
 @dns.immutable.immutable
 class ImmutableVersion(Version):
-    def __init__(self, version):
+    def __init__(self, version: WritableVersion):
         # We tell super() that it's a replacement as we don't want it
         # to copy the nodes, as we're about to do that with an
         # immutable Dict.
@@ -976,11 +1081,12 @@ class ImmutableVersion(Version):
             # it might not exist if we deleted it in the version
             if node:
                 version.nodes[name] = ImmutableVersionedNode(node)
-        self.nodes = dns.immutable.Dict(version.nodes, True)
+        # We're changing the type of the nodes dictionary here on purpose, so
+        # we ignore the mypy error.
+        self.nodes = dns.immutable.Dict(version.nodes, True)  # type: ignore
 
 
 class Transaction(dns.transaction.Transaction):
-
     def __init__(self, zone, replacement, version=None, make_immutable=False):
         read_only = version is not None
         super().__init__(zone, replacement, read_only)
@@ -1057,9 +1163,18 @@ class Transaction(dns.transaction.Transaction):
         return (absolute, relativize, effective)
 
 
-def from_text(text, origin=None, rdclass=dns.rdataclass.IN,
-              relativize=True, zone_factory=Zone, filename=None,
-              allow_include=False, check_origin=True, idna_codec=None):
+def from_text(
+    text: str,
+    origin: Optional[Union[dns.name.Name, str]] = None,
+    rdclass: dns.rdataclass.RdataClass = dns.rdataclass.IN,
+    relativize: bool = True,
+    zone_factory: Any = Zone,
+    filename: Optional[str] = None,
+    allow_include: bool = False,
+    check_origin: bool = True,
+    idna_codec: Optional[dns.name.IDNACodec] = None,
+    allow_directives: Union[bool, Iterable[str]] = True,
+) -> Zone:
     """Build a zone object from a zone file format string.
 
     *text*, a ``str``, the zone file format input.
@@ -1068,7 +1183,8 @@ def from_text(text, origin=None, rdclass=dns.rdataclass.IN,
     of the zone; if not specified, the first ``$ORIGIN`` statement in the
     zone file will determine the origin of the zone.
 
-    *rdclass*, an ``int``, the zone's rdata class; the default is class IN.
+    *rdclass*, a ``dns.rdataclass.RdataClass``, the zone's rdata class; the default is
+    class IN.
 
     *relativize*, a ``bool``, determine's whether domain names are
     relativized to the zone's origin.  The default is ``True``.
@@ -1092,6 +1208,13 @@ def from_text(text, origin=None, rdclass=dns.rdataclass.IN,
     encoder/decoder.  If ``None``, the default IDNA 2003 encoder/decoder
     is used.
 
+    *allow_directives*, a ``bool`` or an iterable of `str`.  If ``True``, the default,
+    then directives are permitted, and the *allow_include* parameter controls whether
+    ``$INCLUDE`` is permitted.  If ``False`` or an empty iterable, then no directive
+    processing is done and any directive-like text will be treated as a regular owner
+    name.  If a non-empty iterable, then only the listed directives (including the
+    ``$``) are allowed.
+
     Raises ``dns.zone.NoSOA`` if there is no SOA RRset.
 
     Raises ``dns.zone.NoNS`` if there is no NS RRset.
@@ -1106,12 +1229,17 @@ def from_text(text, origin=None, rdclass=dns.rdataclass.IN,
     # interface is from_file().
 
     if filename is None:
-        filename = '<string>'
+        filename = "<string>"
     zone = zone_factory(origin, rdclass, relativize=relativize)
     with zone.writer(True) as txn:
         tok = dns.tokenizer.Tokenizer(text, filename, idna_codec=idna_codec)
-        reader = dns.zonefile.Reader(tok, rdclass, txn,
-                                     allow_include=allow_include)
+        reader = dns.zonefile.Reader(
+            tok,
+            rdclass,
+            txn,
+            allow_include=allow_include,
+            allow_directives=allow_directives,
+        )
         try:
             reader.read()
         except dns.zonefile.UnknownOrigin:
@@ -1123,9 +1251,18 @@ def from_text(text, origin=None, rdclass=dns.rdataclass.IN,
     return zone
 
 
-def from_file(f, origin=None, rdclass=dns.rdataclass.IN,
-              relativize=True, zone_factory=Zone, filename=None,
-              allow_include=True, check_origin=True):
+def from_file(
+    f: Any,
+    origin: Optional[Union[dns.name.Name, str]] = None,
+    rdclass: dns.rdataclass.RdataClass = dns.rdataclass.IN,
+    relativize: bool = True,
+    zone_factory: Any = Zone,
+    filename: Optional[str] = None,
+    allow_include: bool = True,
+    check_origin: bool = True,
+    idna_codec: Optional[dns.name.IDNACodec] = None,
+    allow_directives: Union[bool, Iterable[str]] = True,
+) -> Zone:
     """Read a zone file and build a zone object.
 
     *f*, a file or ``str``.  If *f* is a string, it is treated
@@ -1159,6 +1296,13 @@ def from_file(f, origin=None, rdclass=dns.rdataclass.IN,
     encoder/decoder.  If ``None``, the default IDNA 2003 encoder/decoder
     is used.
 
+    *allow_directives*, a ``bool`` or an iterable of `str`.  If ``True``, the default,
+    then directives are permitted, and the *allow_include* parameter controls whether
+    ``$INCLUDE`` is permitted.  If ``False`` or an empty iterable, then no directive
+    processing is done and any directive-like text will be treated as a regular owner
+    name.  If a non-empty iterable, then only the listed directives (including the
+    ``$``) are allowed.
+
     Raises ``dns.zone.NoSOA`` if there is no SOA RRset.
 
     Raises ``dns.zone.NoNS`` if there is no NS RRset.
@@ -1168,16 +1312,34 @@ def from_file(f, origin=None, rdclass=dns.rdataclass.IN,
     Returns a subclass of ``dns.zone.Zone``.
     """
 
-    with contextlib.ExitStack() as stack:
-        if isinstance(f, str):
-            if filename is None:
-                filename = f
-            f = stack.enter_context(open(f))
-        return from_text(f, origin, rdclass, relativize, zone_factory,
-                         filename, allow_include, check_origin)
+    if isinstance(f, str):
+        if filename is None:
+            filename = f
+        cm: contextlib.AbstractContextManager = open(f)
+    else:
+        cm = contextlib.nullcontext(f)
+    with cm as f:
+        return from_text(
+            f,
+            origin,
+            rdclass,
+            relativize,
+            zone_factory,
+            filename,
+            allow_include,
+            check_origin,
+            idna_codec,
+            allow_directives,
+        )
+    assert False  # make mypy happy  lgtm[py/unreachable-statement]
 
 
-def from_xfr(xfr, zone_factory=Zone, relativize=True, check_origin=True):
+def from_xfr(
+    xfr: Any,
+    zone_factory: Any = Zone,
+    relativize: bool = True,
+    check_origin: bool = True,
+) -> Zone:
     """Convert the output of a zone transfer generator into a zone object.
 
     *xfr*, a generator of ``dns.message.Message`` objects, typically
@@ -1198,6 +1360,8 @@ def from_xfr(xfr, zone_factory=Zone, relativize=True, check_origin=True):
 
     Raises ``KeyError`` if there is no origin node.
 
+    Raises ``ValueError`` if no messages are yielded by the generator.
+
     Returns a subclass of ``dns.zone.Zone``.
     """
 
@@ -1215,11 +1379,12 @@ def from_xfr(xfr, zone_factory=Zone, relativize=True, check_origin=True):
             if not znode:
                 znode = z.node_factory()
                 z.nodes[rrset.name] = znode
-            zrds = znode.find_rdataset(rrset.rdclass, rrset.rdtype,
-                                       rrset.covers, True)
+            zrds = znode.find_rdataset(rrset.rdclass, rrset.rdtype, rrset.covers, True)
             zrds.update_ttl(rrset.ttl)
             for rd in rrset:
                 zrds.add(rd)
+    if z is None:
+        raise ValueError("empty transfer")
     if check_origin:
         z.check_origin()
     return z
diff --git a/lib/dns/zone.pyi b/lib/dns/zone.pyi
deleted file mode 100644
index 272814fe..00000000
--- a/lib/dns/zone.pyi
+++ /dev/null
@@ -1,55 +0,0 @@
-from typing import Generator, Optional, Union, Tuple, Iterable, Callable, Any, Iterator, TextIO, BinaryIO, Dict
-from . import rdata, zone, rdataclass, name, rdataclass, message, rdatatype, exception, node, rdataset, rrset, rdatatype
-
-class BadZone(exception.DNSException): ...
-class NoSOA(BadZone): ...
-class NoNS(BadZone): ...
-class UnknownOrigin(BadZone): ...
-
-class Zone:
-    def __getitem__(self, key : str) -> node.Node:
-        ...
-    def __init__(self, origin : Union[str,name.Name], rdclass : int = rdataclass.IN, relativize : bool = True) -> None:
-        self.nodes : Dict[str,node.Node]
-        self.origin = origin
-    def values(self):
-        return self.nodes.values()
-    def iterate_rdatas(self, rdtype : Union[int,str] = rdatatype.ANY, covers : Union[int,str] = None) -> Iterable[Tuple[name.Name, int, rdata.Rdata]]:
-        ...
-    def __iter__(self) -> Iterator[str]:
-        ...
-    def get_node(self, name : Union[name.Name,str], create=False) -> Optional[node.Node]:
-        ...
-    def find_rrset(self, name : Union[str,name.Name], rdtype : Union[int,str], covers=rdatatype.NONE) -> rrset.RRset:
-        ...
-    def find_rdataset(self, name : Union[str,name.Name], rdtype : Union[str,int], covers=rdatatype.NONE,
-                      create=False) -> rdataset.Rdataset:
-        ...
-    def get_rdataset(self, name : Union[str,name.Name], rdtype : Union[str,int], covers=rdatatype.NONE, create=False) -> Optional[rdataset.Rdataset]:
-        ...
-    def get_rrset(self, name : Union[str,name.Name], rdtype : Union[str,int], covers=rdatatype.NONE) -> Optional[rrset.RRset]:
-        ...
-    def replace_rdataset(self, name : Union[str,name.Name], replacement : rdataset.Rdataset) -> None:
-        ...
-    def delete_rdataset(self, name : Union[str,name.Name], rdtype : Union[str,int], covers=rdatatype.NONE) -> None:
-        ...
-    def iterate_rdatasets(self, rdtype : Union[str,int] =rdatatype.ANY,
-                          covers : Union[str,int] =rdatatype.NONE):
-        ...
-    def to_file(self, f : Union[TextIO, BinaryIO, str], sorted=True, relativize=True, nl : Optional[bytes] = None):
-        ...
-    def to_text(self, sorted=True, relativize=True, nl : Optional[str] = None) -> str:
-        ...
-
-def from_xfr(xfr : Generator[Any,Any,message.Message], zone_factory : Callable[..., zone.Zone] = zone.Zone, relativize=True, check_origin=True):
-    ...
-
-def from_text(text : str, origin : Optional[Union[str,name.Name]] = None, rdclass : int = rdataclass.IN,
-              relativize=True, zone_factory : Callable[...,zone.Zone] = zone.Zone, filename : Optional[str] = None,
-              allow_include=False, check_origin=True) -> zone.Zone:
-    ...
-
-def from_file(f, origin : Optional[Union[str,name.Name]] = None, rdclass=rdataclass.IN,
-              relativize=True, zone_factory : Callable[..., zone.Zone] = Zone, filename : Optional[str] = None,
-              allow_include=True, check_origin=True) -> zone.Zone:
-    ...
diff --git a/lib/dns/zonefile.py b/lib/dns/zonefile.py
index 53b40880..1a53f5bc 100644
--- a/lib/dns/zonefile.py
+++ b/lib/dns/zonefile.py
@@ -17,6 +17,8 @@
 
 """DNS Zones."""
 
+from typing import Any, Iterable, List, Optional, Set, Tuple, Union
+
 import re
 import sys
 
@@ -49,29 +51,60 @@ def _check_cname_and_other_data(txn, name, rdataset):
         # empty nodes are neutral.
         return
     node_kind = node.classify()
-    if node_kind == dns.node.NodeKind.CNAME and \
-       rdataset_kind == dns.node.NodeKind.REGULAR:
-        raise CNAMEAndOtherData('rdataset type is not compatible with a '
-                                'CNAME node')
-    elif node_kind == dns.node.NodeKind.REGULAR and \
-       rdataset_kind == dns.node.NodeKind.CNAME:
-        raise CNAMEAndOtherData('CNAME rdataset is not compatible with a '
-                                'regular data node')
+    if (
+        node_kind == dns.node.NodeKind.CNAME
+        and rdataset_kind == dns.node.NodeKind.REGULAR
+    ):
+        raise CNAMEAndOtherData("rdataset type is not compatible with a CNAME node")
+    elif (
+        node_kind == dns.node.NodeKind.REGULAR
+        and rdataset_kind == dns.node.NodeKind.CNAME
+    ):
+        raise CNAMEAndOtherData(
+            "CNAME rdataset is not compatible with a regular data node"
+        )
     # Otherwise at least one of the node and the rdataset is neutral, so
     # adding the rdataset is ok
 
 
+SavedStateType = Tuple[
+    dns.tokenizer.Tokenizer,
+    Optional[dns.name.Name],  # current_origin
+    Optional[dns.name.Name],  # last_name
+    Optional[Any],  # current_file
+    int,  # last_ttl
+    bool,  # last_ttl_known
+    int,  # default_ttl
+    bool,
+]  # default_ttl_known
+
+
+def _upper_dollarize(s):
+    s = s.upper()
+    if not s.startswith("$"):
+        s = "$" + s
+    return s
+
+
 class Reader:
 
     """Read a DNS zone file into a transaction."""
 
-    def __init__(self, tok, rdclass, txn, allow_include=False,
-                 allow_directives=True, force_name=None,
-                 force_ttl=None, force_rdclass=None, force_rdtype=None,
-                 default_ttl=None):
+    def __init__(
+        self,
+        tok: dns.tokenizer.Tokenizer,
+        rdclass: dns.rdataclass.RdataClass,
+        txn: dns.transaction.Transaction,
+        allow_include: bool = False,
+        allow_directives: Union[bool, Iterable[str]] = True,
+        force_name: Optional[dns.name.Name] = None,
+        force_ttl: Optional[int] = None,
+        force_rdclass: Optional[dns.rdataclass.RdataClass] = None,
+        force_rdtype: Optional[dns.rdatatype.RdataType] = None,
+        default_ttl: Optional[int] = None,
+    ):
         self.tok = tok
-        (self.zone_origin, self.relativize, _) = \
-            txn.manager.origin_information()
+        (self.zone_origin, self.relativize, _) = txn.manager.origin_information()
         self.current_origin = self.zone_origin
         self.last_ttl = 0
         self.last_ttl_known = False
@@ -86,10 +119,21 @@ class Reader:
         self.last_name = self.current_origin
         self.zone_rdclass = rdclass
         self.txn = txn
-        self.saved_state = []
-        self.current_file = None
-        self.allow_include = allow_include
-        self.allow_directives = allow_directives
+        self.saved_state: List[SavedStateType] = []
+        self.current_file: Optional[Any] = None
+        self.allowed_directives: Set[str]
+        if allow_directives is True:
+            self.allowed_directives = {"$GENERATE", "$ORIGIN", "$TTL"}
+            if allow_include:
+                self.allowed_directives.add("$INCLUDE")
+        elif allow_directives is False:
+            # allow_include was ignored in earlier releases if allow_directives was
+            # False, so we continue that.
+            self.allowed_directives = set()
+        else:
+            # Note that if directives are explicitly specified, then allow_include
+            # is ignored.
+            self.allowed_directives = set(_upper_dollarize(d) for d in allow_directives)
         self.force_name = force_name
         self.force_ttl = force_ttl
         self.force_rdclass = force_rdclass
@@ -176,13 +220,17 @@ class Reader:
             try:
                 rdtype = dns.rdatatype.from_text(token.value)
             except Exception:
-                raise dns.exception.SyntaxError(
-                    "unknown rdatatype '%s'" % token.value)
+                raise dns.exception.SyntaxError("unknown rdatatype '%s'" % token.value)
 
         try:
-            rd = dns.rdata.from_text(rdclass, rdtype, self.tok,
-                                     self.current_origin, self.relativize,
-                                     self.zone_origin)
+            rd = dns.rdata.from_text(
+                rdclass,
+                rdtype,
+                self.tok,
+                self.current_origin,
+                self.relativize,
+                self.zone_origin,
+            )
         except dns.exception.SyntaxError:
             # Catch and reraise.
             raise
@@ -194,7 +242,8 @@ class Reader:
             # helpful filename:line info.
             (ty, va) = sys.exc_info()[:2]
             raise dns.exception.SyntaxError(
-                "caught exception {}: {}".format(str(ty), str(va)))
+                "caught exception {}: {}".format(str(ty), str(va))
+            )
 
         if not self.default_ttl_known and rdtype == dns.rdatatype.SOA:
             # The pre-RFC2308 and pre-BIND9 behavior inherits the zone default
@@ -213,7 +262,7 @@ class Reader:
 
         self.txn.add(name, ttl, rd)
 
-    def _parse_modify(self, side):
+    def _parse_modify(self, side: str) -> Tuple[str, str, int, int, str]:
         # Here we catch everything in '{' '}' in a group so we can replace it
         # with ''.
         is_generate1 = re.compile(r"^.*\$({(\+|-?)(\d+),(\d+),(.)}).*$")
@@ -225,31 +274,36 @@ class Reader:
         g1 = is_generate1.match(side)
         if g1:
             mod, sign, offset, width, base = g1.groups()
-            if sign == '':
-                sign = '+'
+            if sign == "":
+                sign = "+"
         g2 = is_generate2.match(side)
         if g2:
             mod, sign, offset = g2.groups()
-            if sign == '':
-                sign = '+'
+            if sign == "":
+                sign = "+"
             width = 0
-            base = 'd'
+            base = "d"
         g3 = is_generate3.match(side)
         if g3:
             mod, sign, offset, width = g3.groups()
-            if sign == '':
-                sign = '+'
-            base = 'd'
+            if sign == "":
+                sign = "+"
+            base = "d"
 
         if not (g1 or g2 or g3):
-            mod = ''
-            sign = '+'
+            mod = ""
+            sign = "+"
             offset = 0
             width = 0
-            base = 'd'
+            base = "d"
 
-        if base != 'd':
-            raise NotImplementedError()
+        offset = int(offset)
+        width = int(width)
+
+        if sign not in ["+", "-"]:
+            raise dns.exception.SyntaxError("invalid offset sign %s" % sign)
+        if base not in ["d", "o", "x", "X", "n", "N"]:
+            raise dns.exception.SyntaxError("invalid type %s" % base)
 
         return mod, sign, offset, width, base
 
@@ -313,37 +367,47 @@ class Reader:
             if not token.is_identifier():
                 raise dns.exception.SyntaxError
         except Exception:
-            raise dns.exception.SyntaxError("unknown rdatatype '%s'" %
-                                            token.value)
+            raise dns.exception.SyntaxError("unknown rdatatype '%s'" % token.value)
 
         # rhs (required)
         rhs = token.value
 
-        # The code currently only supports base 'd', so the last value
-        # in the tuple _parse_modify returns is ignored
-        lmod, lsign, loffset, lwidth, _ = self._parse_modify(lhs)
-        rmod, rsign, roffset, rwidth, _ = self._parse_modify(rhs)
+        def _calculate_index(counter: int, offset_sign: str, offset: int) -> int:
+            """Calculate the index from the counter and offset."""
+            if offset_sign == "-":
+                offset *= -1
+            return counter + offset
+
+        def _format_index(index: int, base: str, width: int) -> str:
+            """Format the index with the given base, and zero-fill it
+            to the given width."""
+            if base in ["d", "o", "x", "X"]:
+                return format(index, base).zfill(width)
+
+            # base can only be n or N here
+            hexa = _format_index(index, "x", width)
+            nibbles = ".".join(hexa[::-1])[:width]
+            if base == "N":
+                nibbles = nibbles.upper()
+            return nibbles
+
+        lmod, lsign, loffset, lwidth, lbase = self._parse_modify(lhs)
+        rmod, rsign, roffset, rwidth, rbase = self._parse_modify(rhs)
         for i in range(start, stop + 1, step):
             # +1 because bind is inclusive and python is exclusive
 
-            if lsign == '+':
-                lindex = i + int(loffset)
-            elif lsign == '-':
-                lindex = i - int(loffset)
+            lindex = _calculate_index(i, lsign, loffset)
+            rindex = _calculate_index(i, rsign, roffset)
 
-            if rsign == '-':
-                rindex = i - int(roffset)
-            elif rsign == '+':
-                rindex = i + int(roffset)
+            lzfindex = _format_index(lindex, lbase, lwidth)
+            rzfindex = _format_index(rindex, rbase, rwidth)
 
-            lzfindex = str(lindex).zfill(int(lwidth))
-            rzfindex = str(rindex).zfill(int(rwidth))
+            name = lhs.replace("$%s" % (lmod), lzfindex)
+            rdata = rhs.replace("$%s" % (rmod), rzfindex)
 
-            name = lhs.replace('$%s' % (lmod), lzfindex)
-            rdata = rhs.replace('$%s' % (rmod), rzfindex)
-
-            self.last_name = dns.name.from_text(name, self.current_origin,
-                                                self.tok.idna_codec)
+            self.last_name = dns.name.from_text(
+                name, self.current_origin, self.tok.idna_codec
+            )
             name = self.last_name
             if not name.is_subdomain(self.zone_origin):
                 self._eat_line()
@@ -352,9 +416,14 @@ class Reader:
                 name = name.relativize(self.zone_origin)
 
             try:
-                rd = dns.rdata.from_text(rdclass, rdtype, rdata,
-                                         self.current_origin, self.relativize,
-                                         self.zone_origin)
+                rd = dns.rdata.from_text(
+                    rdclass,
+                    rdtype,
+                    rdata,
+                    self.current_origin,
+                    self.relativize,
+                    self.zone_origin,
+                )
             except dns.exception.SyntaxError:
                 # Catch and reraise.
                 raise
@@ -365,12 +434,13 @@ class Reader:
                 # We convert them to syntax errors so that we can emit
                 # helpful filename:line info.
                 (ty, va) = sys.exc_info()[:2]
-                raise dns.exception.SyntaxError("caught exception %s: %s" %
-                                                (str(ty), str(va)))
+                raise dns.exception.SyntaxError(
+                    "caught exception %s: %s" % (str(ty), str(va))
+                )
 
             self.txn.add(name, ttl, rd)
 
-    def read(self):
+    def read(self) -> None:
         """Read a DNS zone file and build a zone object.
 
         @raises dns.zone.NoSOA: No SOA RR was found at the zone origin
@@ -384,14 +454,16 @@ class Reader:
                     if self.current_file is not None:
                         self.current_file.close()
                     if len(self.saved_state) > 0:
-                        (self.tok,
-                         self.current_origin,
-                         self.last_name,
-                         self.current_file,
-                         self.last_ttl,
-                         self.last_ttl_known,
-                         self.default_ttl,
-                         self.default_ttl_known) = self.saved_state.pop(-1)
+                        (
+                            self.tok,
+                            self.current_origin,
+                            self.last_name,
+                            self.current_file,
+                            self.last_ttl,
+                            self.last_ttl_known,
+                            self.default_ttl,
+                            self.default_ttl_known,
+                        ) = self.saved_state.pop(-1)
                         continue
                     break
                 elif token.is_eol():
@@ -399,53 +471,62 @@ class Reader:
                 elif token.is_comment():
                     self.tok.get_eol()
                     continue
-                elif token.value[0] == '$' and self.allow_directives:
+                elif token.value[0] == "$" and len(self.allowed_directives) > 0:
+                    # Note that we only run directive processing code if at least
+                    # one directive is allowed in order to be backwards compatible
                     c = token.value.upper()
-                    if c == '$TTL':
+                    if c not in self.allowed_directives:
+                        raise dns.exception.SyntaxError(
+                            f"zone file directive '{c}' is not allowed"
+                        )
+                    if c == "$TTL":
                         token = self.tok.get()
                         if not token.is_identifier():
                             raise dns.exception.SyntaxError("bad $TTL")
                         self.default_ttl = dns.ttl.from_text(token.value)
                         self.default_ttl_known = True
                         self.tok.get_eol()
-                    elif c == '$ORIGIN':
+                    elif c == "$ORIGIN":
                         self.current_origin = self.tok.get_name()
                         self.tok.get_eol()
                         if self.zone_origin is None:
                             self.zone_origin = self.current_origin
                         self.txn._set_origin(self.current_origin)
-                    elif c == '$INCLUDE' and self.allow_include:
+                    elif c == "$INCLUDE":
                         token = self.tok.get()
                         filename = token.value
                         token = self.tok.get()
+                        new_origin: Optional[dns.name.Name]
                         if token.is_identifier():
-                            new_origin =\
-                                dns.name.from_text(token.value,
-                                                   self.current_origin,
-                                                   self.tok.idna_codec)
+                            new_origin = dns.name.from_text(
+                                token.value, self.current_origin, self.tok.idna_codec
+                            )
                             self.tok.get_eol()
                         elif not token.is_eol_or_eof():
-                            raise dns.exception.SyntaxError(
-                                "bad origin in $INCLUDE")
+                            raise dns.exception.SyntaxError("bad origin in $INCLUDE")
                         else:
                             new_origin = self.current_origin
-                        self.saved_state.append((self.tok,
-                                                 self.current_origin,
-                                                 self.last_name,
-                                                 self.current_file,
-                                                 self.last_ttl,
-                                                 self.last_ttl_known,
-                                                 self.default_ttl,
-                                                 self.default_ttl_known))
-                        self.current_file = open(filename, 'r')
-                        self.tok = dns.tokenizer.Tokenizer(self.current_file,
-                                                           filename)
+                        self.saved_state.append(
+                            (
+                                self.tok,
+                                self.current_origin,
+                                self.last_name,
+                                self.current_file,
+                                self.last_ttl,
+                                self.last_ttl_known,
+                                self.default_ttl,
+                                self.default_ttl_known,
+                            )
+                        )
+                        self.current_file = open(filename, "r")
+                        self.tok = dns.tokenizer.Tokenizer(self.current_file, filename)
                         self.current_origin = new_origin
-                    elif c == '$GENERATE':
+                    elif c == "$GENERATE":
                         self._generate_line()
                     else:
                         raise dns.exception.SyntaxError(
-                            "Unknown zone file directive '" + c + "'")
+                            f"Unknown zone file directive '{c}'"
+                        )
                     continue
                 self.tok.unget(token)
                 self._rr_line()
@@ -454,13 +535,13 @@ class Reader:
             if detail is None:
                 detail = "syntax error"
             ex = dns.exception.SyntaxError(
-                "%s:%d: %s" % (filename, line_number, detail))
+                "%s:%d: %s" % (filename, line_number, detail)
+            )
             tb = sys.exc_info()[2]
             raise ex.with_traceback(tb) from None
 
 
 class RRsetsReaderTransaction(dns.transaction.Transaction):
-
     def __init__(self, manager, replacement, read_only):
         assert not read_only
         super().__init__(manager, replacement, read_only)
@@ -512,8 +593,9 @@ class RRsetsReaderTransaction(dns.transaction.Transaction):
         if commit and self._changed():
             rrsets = []
             for (name, _, _), rdataset in self.rdatasets.items():
-                rrset = dns.rrset.RRset(name, rdataset.rdclass, rdataset.rdtype,
-                                        rdataset.covers)
+                rrset = dns.rrset.RRset(
+                    name, rdataset.rdclass, rdataset.rdtype, rdataset.covers
+                )
                 rrset.update(rdataset)
                 rrsets.append(rrset)
             self.manager.set_rrsets(rrsets)
@@ -521,15 +603,22 @@ class RRsetsReaderTransaction(dns.transaction.Transaction):
     def _set_origin(self, origin):
         pass
 
+    def _iterate_rdatasets(self):
+        raise NotImplementedError  # pragma: no cover
+
 
 class RRSetsReaderManager(dns.transaction.TransactionManager):
-    def __init__(self, origin=dns.name.root, relativize=False,
-                 rdclass=dns.rdataclass.IN):
+    def __init__(
+        self, origin=dns.name.root, relativize=False, rdclass=dns.rdataclass.IN
+    ):
         self.origin = origin
         self.relativize = relativize
         self.rdclass = rdclass
         self.rrsets = []
 
+    def reader(self):  # pragma: no cover
+        raise NotImplementedError
+
     def writer(self, replacement=False):
         assert replacement is True
         return RRsetsReaderTransaction(self, True, False)
@@ -548,10 +637,18 @@ class RRSetsReaderManager(dns.transaction.TransactionManager):
         self.rrsets = rrsets
 
 
-def read_rrsets(text, name=None, ttl=None, rdclass=dns.rdataclass.IN,
-                default_rdclass=dns.rdataclass.IN,
-                rdtype=None, default_ttl=None, idna_codec=None,
-                origin=dns.name.root, relativize=False):
+def read_rrsets(
+    text: Any,
+    name: Optional[Union[dns.name.Name, str]] = None,
+    ttl: Optional[int] = None,
+    rdclass: Optional[Union[dns.rdataclass.RdataClass, str]] = dns.rdataclass.IN,
+    default_rdclass: Union[dns.rdataclass.RdataClass, str] = dns.rdataclass.IN,
+    rdtype: Optional[Union[dns.rdatatype.RdataType, str]] = None,
+    default_ttl: Optional[Union[int, str]] = None,
+    idna_codec: Optional[dns.name.IDNACodec] = None,
+    origin: Optional[Union[dns.name.Name, str]] = dns.name.root,
+    relativize: bool = False,
+) -> List[dns.rrset.RRset]:
     """Read one or more rrsets from the specified text, possibly subject
     to restrictions.
 
@@ -610,15 +707,27 @@ def read_rrsets(text, name=None, ttl=None, rdclass=dns.rdataclass.IN,
     if isinstance(default_ttl, str):
         default_ttl = dns.ttl.from_text(default_ttl)
     if rdclass is not None:
-        rdclass = dns.rdataclass.RdataClass.make(rdclass)
-    default_rdclass = dns.rdataclass.RdataClass.make(default_rdclass)
+        the_rdclass = dns.rdataclass.RdataClass.make(rdclass)
+    else:
+        the_rdclass = None
+    the_default_rdclass = dns.rdataclass.RdataClass.make(default_rdclass)
     if rdtype is not None:
-        rdtype = dns.rdatatype.RdataType.make(rdtype)
+        the_rdtype = dns.rdatatype.RdataType.make(rdtype)
+    else:
+        the_rdtype = None
     manager = RRSetsReaderManager(origin, relativize, default_rdclass)
     with manager.writer(True) as txn:
-        tok = dns.tokenizer.Tokenizer(text, '<input>', idna_codec=idna_codec)
-        reader = Reader(tok, default_rdclass, txn, allow_directives=False,
-                        force_name=name, force_ttl=ttl, force_rdclass=rdclass,
-                        force_rdtype=rdtype, default_ttl=default_ttl)
+        tok = dns.tokenizer.Tokenizer(text, "<input>", idna_codec=idna_codec)
+        reader = Reader(
+            tok,
+            the_default_rdclass,
+            txn,
+            allow_directives=False,
+            force_name=name,
+            force_ttl=ttl,
+            force_rdclass=the_rdclass,
+            force_rdtype=the_rdtype,
+            default_ttl=default_ttl,
+        )
         reader.read()
     return manager.rrsets
diff --git a/lib/dns/zonetypes.py b/lib/dns/zonetypes.py
new file mode 100644
index 00000000..195ee2ec
--- /dev/null
+++ b/lib/dns/zonetypes.py
@@ -0,0 +1,37 @@
+# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license
+
+"""Common zone-related types."""
+
+# This is a separate file to avoid import circularity between dns.zone and
+# the implementation of the ZONEMD type.
+
+import hashlib
+
+import dns.enum
+
+
+class DigestScheme(dns.enum.IntEnum):
+    """ZONEMD Scheme"""
+
+    SIMPLE = 1
+
+    @classmethod
+    def _maximum(cls):
+        return 255
+
+
+class DigestHashAlgorithm(dns.enum.IntEnum):
+    """ZONEMD Hash Algorithm"""
+
+    SHA384 = 1
+    SHA512 = 2
+
+    @classmethod
+    def _maximum(cls):
+        return 255
+
+
+_digest_hashers = {
+    DigestHashAlgorithm.SHA384: hashlib.sha384,
+    DigestHashAlgorithm.SHA512: hashlib.sha512,
+}
diff --git a/requirements.txt b/requirements.txt
index 017ae555..69e57f37 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -11,7 +11,7 @@ cheroot==9.0.0
 cherrypy==18.8.0
 cloudinary==1.30.0
 distro==1.8.0
-dnspython==2.2.1
+dnspython==2.3.0
 facebook-sdk==3.1.0
 future==0.18.3
 ga4mp==2.0.4

From 2fda9163310919153cd7441456ddae1f38a47665 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 2 Mar 2023 20:54:41 -0800
Subject: [PATCH 344/743] Bump markupsafe from 2.1.1 to 2.1.2 (#1976)

* Bump markupsafe from 2.1.1 to 2.1.2

Bumps [markupsafe](https://github.com/pallets/markupsafe) from 2.1.1 to 2.1.2.
- [Release notes](https://github.com/pallets/markupsafe/releases)
- [Changelog](https://github.com/pallets/markupsafe/blob/main/CHANGES.rst)
- [Commits](https://github.com/pallets/markupsafe/compare/2.1.1...2.1.2)

---
updated-dependencies:
- dependency-name: markupsafe
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

* Update markupsafe==2.1.2

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/markupsafe/__init__.py | 6 +++---
 requirements.txt           | 2 +-
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/lib/markupsafe/__init__.py b/lib/markupsafe/__init__.py
index 0f1c4f46..7166b192 100644
--- a/lib/markupsafe/__init__.py
+++ b/lib/markupsafe/__init__.py
@@ -11,10 +11,10 @@ if t.TYPE_CHECKING:
             pass
 
 
-__version__ = "2.1.1"
+__version__ = "2.1.2"
 
-_strip_comments_re = re.compile(r"<!--.*?-->")
-_strip_tags_re = re.compile(r"<.*?>")
+_strip_comments_re = re.compile(r"<!--.*?-->", re.DOTALL)
+_strip_tags_re = re.compile(r"<.*?>", re.DOTALL)
 
 
 def _simple_escaping_wrapper(name: str) -> t.Callable[..., "Markup"]:
diff --git a/requirements.txt b/requirements.txt
index 69e57f37..b88c9efe 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -24,7 +24,7 @@ importlib-resources==5.12.0
 git+https://github.com/Tautulli/ipwhois.git@master#egg=ipwhois
 IPy==1.01
 Mako==1.2.4
-MarkupSafe==2.1.1
+MarkupSafe==2.1.2
 musicbrainzngs==0.7.1
 packaging==23.0
 paho-mqtt==1.6.1

From 6b1b6d0f32135a800b9c8e795d3acf366eb53ae2 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 2 Mar 2023 20:54:54 -0800
Subject: [PATCH 345/743] Bump tempora from 5.1.0 to 5.2.1 (#1977)

* Bump tempora from 5.1.0 to 5.2.1

Bumps [tempora](https://github.com/jaraco/tempora) from 5.1.0 to 5.2.1.
- [Release notes](https://github.com/jaraco/tempora/releases)
- [Changelog](https://github.com/jaraco/tempora/blob/main/CHANGES.rst)
- [Commits](https://github.com/jaraco/tempora/compare/v5.1.0...v5.2.1)

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

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

* Update tempora==5.2.1

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/jaraco/functools.py            |  37 +++-
 lib/more_itertools/__init__.py     |   2 +-
 lib/more_itertools/more.py         |  53 +++++-
 lib/more_itertools/more.pyi        | 286 ++++++++++++++---------------
 lib/more_itertools/recipes.py      |  99 +++++++++-
 lib/more_itertools/recipes.pyi     |  87 +++++----
 lib/tempora/__init__.py            |   5 +-
 lib/tempora/tests/test_schedule.py | 149 ---------------
 lib/tempora/tests/test_timing.py   |  50 -----
 requirements.txt                   |   2 +-
 10 files changed, 367 insertions(+), 403 deletions(-)
 delete mode 100644 lib/tempora/tests/test_schedule.py
 delete mode 100644 lib/tempora/tests/test_timing.py

diff --git a/lib/jaraco/functools.py b/lib/jaraco/functools.py
index fcdbb4f9..6ae9e31d 100644
--- a/lib/jaraco/functools.py
+++ b/lib/jaraco/functools.py
@@ -4,6 +4,7 @@ import inspect
 import collections
 import types
 import itertools
+import warnings
 
 import more_itertools
 
@@ -266,11 +267,33 @@ def result_invoke(action):
     return wrap
 
 
-def call_aside(f, *args, **kwargs):
+def invoke(f, *args, **kwargs):
     """
     Call a function for its side effect after initialization.
 
-    >>> @call_aside
+    The benefit of using the decorator instead of simply invoking a function
+    after defining it is that it makes explicit the author's intent for the
+    function to be called immediately. Whereas if one simply calls the
+    function immediately, it's less obvious if that was intentional or
+    incidental. It also avoids repeating the name - the two actions, defining
+    the function and calling it immediately are modeled separately, but linked
+    by the decorator construct.
+
+    The benefit of having a function construct (opposed to just invoking some
+    behavior inline) is to serve as a scope in which the behavior occurs. It
+    avoids polluting the global namespace with local variables, provides an
+    anchor on which to attach documentation (docstring), keeps the behavior
+    logically separated (instead of conceptually separated or not separated at
+    all), and provides potential to re-use the behavior for testing or other
+    purposes.
+
+    This function is named as a pithy way to communicate, "call this function
+    primarily for its side effect", or "while defining this function, also
+    take it aside and call it". It exists because there's no Python construct
+    for "define and call" (nor should there be, as decorators serve this need
+    just fine). The behavior happens immediately and synchronously.
+
+    >>> @invoke
     ... def func(): print("called")
     called
     >>> func()
@@ -278,7 +301,7 @@ def call_aside(f, *args, **kwargs):
 
     Use functools.partial to pass parameters to the initial call
 
-    >>> @functools.partial(call_aside, name='bingo')
+    >>> @functools.partial(invoke, name='bingo')
     ... def func(name): print("called with", name)
     called with bingo
     """
@@ -286,6 +309,14 @@ def call_aside(f, *args, **kwargs):
     return f
 
 
+def call_aside(*args, **kwargs):
+    """
+    Deprecated name for invoke.
+    """
+    warnings.warn("call_aside is deprecated, use invoke", DeprecationWarning)
+    return invoke(*args, **kwargs)
+
+
 class Throttler:
     """
     Rate-limit a function (or other callable)
diff --git a/lib/more_itertools/__init__.py b/lib/more_itertools/__init__.py
index 557bfc20..66443971 100644
--- a/lib/more_itertools/__init__.py
+++ b/lib/more_itertools/__init__.py
@@ -3,4 +3,4 @@
 from .more import *  # noqa
 from .recipes import *  # noqa
 
-__version__ = '9.0.0'
+__version__ = '9.1.0'
diff --git a/lib/more_itertools/more.py b/lib/more_itertools/more.py
index 7f73d6ed..cc8b8b48 100755
--- a/lib/more_itertools/more.py
+++ b/lib/more_itertools/more.py
@@ -68,6 +68,7 @@ __all__ = [
     'exactly_n',
     'filter_except',
     'first',
+    'gray_product',
     'groupby_transform',
     'ichunked',
     'iequals',
@@ -658,6 +659,7 @@ def distinct_permutations(iterable, r=None):
         [(0, 1), (0, 2), (1, 0), (1, 2), (2, 0), (2, 1)]
 
     """
+
     # Algorithm: https://w.wiki/Qai
     def _full(A):
         while True:
@@ -1301,7 +1303,7 @@ def split_at(iterable, pred, maxsplit=-1, keep_separator=False):
         [[0], [2], [4, 5, 6, 7, 8, 9]]
 
     By default, the delimiting items are not included in the output.
-    The include them, set *keep_separator* to ``True``.
+    To include them, set *keep_separator* to ``True``.
 
         >>> list(split_at('abcdcba', lambda x: x == 'b', keep_separator=True))
         [['a'], ['b'], ['c', 'd', 'c'], ['b'], ['a']]
@@ -1391,7 +1393,9 @@ def split_after(iterable, pred, maxsplit=-1):
         if pred(item) and buf:
             yield buf
             if maxsplit == 1:
-                yield list(it)
+                buf = list(it)
+                if buf:
+                    yield buf
                 return
             buf = []
             maxsplit -= 1
@@ -2914,6 +2918,7 @@ def make_decorator(wrapping_func, result_index=0):
         '7'
 
     """
+
     # See https://sites.google.com/site/bbayles/index/decorator_factory for
     # notes on how this works.
     def decorator(*wrapping_args, **wrapping_kwargs):
@@ -3464,7 +3469,6 @@ def _sample_unweighted(iterable, k):
     next_index = k + floor(log(random()) / log(1 - W))
 
     for index, element in enumerate(iterable, k):
-
         if index == next_index:
             reservoir[randrange(k)] = element
             # The new W is the largest in a sample of k U(0, `old_W`) numbers
@@ -4284,7 +4288,6 @@ def minmax(iterable_or_value, *others, key=None, default=_marker):
         lo_key = hi_key = key(lo)
 
         for x, y in zip_longest(it, it, fillvalue=lo):
-
             x_key, y_key = key(x), key(y)
 
             if y_key < x_key:
@@ -4345,3 +4348,45 @@ def constrained_batches(
 
     if batch:
         yield tuple(batch)
+
+
+def gray_product(*iterables):
+    """Like :func:`itertools.product`, but return tuples in an order such
+    that only one element in the generated tuple changes from one iteration
+    to the next.
+
+        >>> list(gray_product('AB','CD'))
+        [('A', 'C'), ('B', 'C'), ('B', 'D'), ('A', 'D')]
+
+    This function consumes all of the input iterables before producing output.
+    If any of the input iterables have fewer than two items, ``ValueError``
+    is raised.
+
+    For information on the algorithm, see
+    `this section <https://www-cs-faculty.stanford.edu/~knuth/fasc2a.ps.gz>`__
+    of Donald Knuth's *The Art of Computer Programming*.
+    """
+    all_iterables = tuple(tuple(x) for x in iterables)
+    iterable_count = len(all_iterables)
+    for iterable in all_iterables:
+        if len(iterable) < 2:
+            raise ValueError("each iterable must have two or more items")
+
+    # This is based on "Algorithm H" from section 7.2.1.1, page 20.
+    # a holds the indexes of the source iterables for the n-tuple to be yielded
+    # f is the array of "focus pointers"
+    # o is the array of "directions"
+    a = [0] * iterable_count
+    f = list(range(iterable_count + 1))
+    o = [1] * iterable_count
+    while True:
+        yield tuple(all_iterables[i][a[i]] for i in range(iterable_count))
+        j = f[0]
+        f[0] = 0
+        if j == iterable_count:
+            break
+        a[j] = a[j] + o[j]
+        if a[j] == 0 or a[j] == len(all_iterables[j]) - 1:
+            o[j] = -o[j]
+            f[j] = f[j + 1]
+            f[j + 1] = j + 1
diff --git a/lib/more_itertools/more.pyi b/lib/more_itertools/more.pyi
index 1413fae7..75c5232c 100644
--- a/lib/more_itertools/more.pyi
+++ b/lib/more_itertools/more.pyi
@@ -1,26 +1,25 @@
 """Stubs for more_itertools.more"""
+from __future__ import annotations
 
+from types import TracebackType
 from typing import (
     Any,
     Callable,
     Container,
-    Dict,
+    ContextManager,
     Generic,
     Hashable,
     Iterable,
     Iterator,
-    List,
-    Optional,
+    overload,
     Reversible,
     Sequence,
     Sized,
-    Tuple,
-    Union,
+    Type,
     TypeVar,
     type_check_only,
 )
-from types import TracebackType
-from typing_extensions import ContextManager, Protocol, Type, overload
+from typing_extensions import Protocol
 
 # Type and type variable definitions
 _T = TypeVar('_T')
@@ -31,7 +30,7 @@ _V = TypeVar('_V')
 _W = TypeVar('_W')
 _T_co = TypeVar('_T_co', covariant=True)
 _GenFn = TypeVar('_GenFn', bound=Callable[..., Iterator[object]])
-_Raisable = Union[BaseException, 'Type[BaseException]']
+_Raisable = BaseException | Type[BaseException]
 
 @type_check_only
 class _SizedIterable(Protocol[_T_co], Sized, Iterable[_T_co]): ...
@@ -39,23 +38,25 @@ class _SizedIterable(Protocol[_T_co], Sized, Iterable[_T_co]): ...
 @type_check_only
 class _SizedReversible(Protocol[_T_co], Sized, Reversible[_T_co]): ...
 
+@type_check_only
+class _SupportsSlicing(Protocol[_T_co]):
+    def __getitem__(self, __k: slice) -> _T_co: ...
+
 def chunked(
-    iterable: Iterable[_T], n: Optional[int], strict: bool = ...
-) -> Iterator[List[_T]]: ...
+    iterable: Iterable[_T], n: int | None, strict: bool = ...
+) -> Iterator[list[_T]]: ...
 @overload
 def first(iterable: Iterable[_T]) -> _T: ...
 @overload
-def first(iterable: Iterable[_T], default: _U) -> Union[_T, _U]: ...
+def first(iterable: Iterable[_T], default: _U) -> _T | _U: ...
 @overload
 def last(iterable: Iterable[_T]) -> _T: ...
 @overload
-def last(iterable: Iterable[_T], default: _U) -> Union[_T, _U]: ...
+def last(iterable: Iterable[_T], default: _U) -> _T | _U: ...
 @overload
 def nth_or_last(iterable: Iterable[_T], n: int) -> _T: ...
 @overload
-def nth_or_last(
-    iterable: Iterable[_T], n: int, default: _U
-) -> Union[_T, _U]: ...
+def nth_or_last(iterable: Iterable[_T], n: int, default: _U) -> _T | _U: ...
 
 class peekable(Generic[_T], Iterator[_T]):
     def __init__(self, iterable: Iterable[_T]) -> None: ...
@@ -64,13 +65,13 @@ class peekable(Generic[_T], Iterator[_T]):
     @overload
     def peek(self) -> _T: ...
     @overload
-    def peek(self, default: _U) -> Union[_T, _U]: ...
+    def peek(self, default: _U) -> _T | _U: ...
     def prepend(self, *items: _T) -> None: ...
     def __next__(self) -> _T: ...
     @overload
     def __getitem__(self, index: int) -> _T: ...
     @overload
-    def __getitem__(self, index: slice) -> List[_T]: ...
+    def __getitem__(self, index: slice) -> list[_T]: ...
 
 def consumer(func: _GenFn) -> _GenFn: ...
 def ilen(iterable: Iterable[object]) -> int: ...
@@ -80,42 +81,42 @@ def with_iter(
 ) -> Iterator[_T]: ...
 def one(
     iterable: Iterable[_T],
-    too_short: Optional[_Raisable] = ...,
-    too_long: Optional[_Raisable] = ...,
+    too_short: _Raisable | None = ...,
+    too_long: _Raisable | None = ...,
 ) -> _T: ...
 def raise_(exception: _Raisable, *args: Any) -> None: ...
 def strictly_n(
     iterable: Iterable[_T],
     n: int,
-    too_short: Optional[_GenFn] = ...,
-    too_long: Optional[_GenFn] = ...,
-) -> List[_T]: ...
+    too_short: _GenFn | None = ...,
+    too_long: _GenFn | None = ...,
+) -> list[_T]: ...
 def distinct_permutations(
-    iterable: Iterable[_T], r: Optional[int] = ...
-) -> Iterator[Tuple[_T, ...]]: ...
+    iterable: Iterable[_T], r: int | None = ...
+) -> Iterator[tuple[_T, ...]]: ...
 def intersperse(
     e: _U, iterable: Iterable[_T], n: int = ...
-) -> Iterator[Union[_T, _U]]: ...
-def unique_to_each(*iterables: Iterable[_T]) -> List[List[_T]]: ...
+) -> Iterator[_T | _U]: ...
+def unique_to_each(*iterables: Iterable[_T]) -> list[list[_T]]: ...
 @overload
 def windowed(
     seq: Iterable[_T], n: int, *, step: int = ...
-) -> Iterator[Tuple[Optional[_T], ...]]: ...
+) -> Iterator[tuple[_T | None, ...]]: ...
 @overload
 def windowed(
     seq: Iterable[_T], n: int, fillvalue: _U, step: int = ...
-) -> Iterator[Tuple[Union[_T, _U], ...]]: ...
-def substrings(iterable: Iterable[_T]) -> Iterator[Tuple[_T, ...]]: ...
+) -> Iterator[tuple[_T | _U, ...]]: ...
+def substrings(iterable: Iterable[_T]) -> Iterator[tuple[_T, ...]]: ...
 def substrings_indexes(
     seq: Sequence[_T], reverse: bool = ...
-) -> Iterator[Tuple[Sequence[_T], int, int]]: ...
+) -> Iterator[tuple[Sequence[_T], int, int]]: ...
 
 class bucket(Generic[_T, _U], Container[_U]):
     def __init__(
         self,
         iterable: Iterable[_T],
         key: Callable[[_T], _U],
-        validator: Optional[Callable[[object], object]] = ...,
+        validator: Callable[[object], object] | None = ...,
     ) -> None: ...
     def __contains__(self, value: object) -> bool: ...
     def __iter__(self) -> Iterator[_U]: ...
@@ -123,109 +124,105 @@ class bucket(Generic[_T, _U], Container[_U]):
 
 def spy(
     iterable: Iterable[_T], n: int = ...
-) -> Tuple[List[_T], Iterator[_T]]: ...
+) -> tuple[list[_T], Iterator[_T]]: ...
 def interleave(*iterables: Iterable[_T]) -> Iterator[_T]: ...
 def interleave_longest(*iterables: Iterable[_T]) -> Iterator[_T]: ...
 def interleave_evenly(
-    iterables: List[Iterable[_T]], lengths: Optional[List[int]] = ...
+    iterables: list[Iterable[_T]], lengths: list[int] | None = ...
 ) -> Iterator[_T]: ...
 def collapse(
     iterable: Iterable[Any],
-    base_type: Optional[type] = ...,
-    levels: Optional[int] = ...,
+    base_type: type | None = ...,
+    levels: int | None = ...,
 ) -> Iterator[Any]: ...
 @overload
 def side_effect(
     func: Callable[[_T], object],
     iterable: Iterable[_T],
     chunk_size: None = ...,
-    before: Optional[Callable[[], object]] = ...,
-    after: Optional[Callable[[], object]] = ...,
+    before: Callable[[], object] | None = ...,
+    after: Callable[[], object] | None = ...,
 ) -> Iterator[_T]: ...
 @overload
 def side_effect(
-    func: Callable[[List[_T]], object],
+    func: Callable[[list[_T]], object],
     iterable: Iterable[_T],
     chunk_size: int,
-    before: Optional[Callable[[], object]] = ...,
-    after: Optional[Callable[[], object]] = ...,
+    before: Callable[[], object] | None = ...,
+    after: Callable[[], object] | None = ...,
 ) -> Iterator[_T]: ...
 def sliced(
-    seq: Sequence[_T], n: int, strict: bool = ...
-) -> Iterator[Sequence[_T]]: ...
+    seq: _SupportsSlicing[_T], n: int, strict: bool = ...
+) -> Iterator[_T]: ...
 def split_at(
     iterable: Iterable[_T],
     pred: Callable[[_T], object],
     maxsplit: int = ...,
     keep_separator: bool = ...,
-) -> Iterator[List[_T]]: ...
+) -> Iterator[list[_T]]: ...
 def split_before(
     iterable: Iterable[_T], pred: Callable[[_T], object], maxsplit: int = ...
-) -> Iterator[List[_T]]: ...
+) -> Iterator[list[_T]]: ...
 def split_after(
     iterable: Iterable[_T], pred: Callable[[_T], object], maxsplit: int = ...
-) -> Iterator[List[_T]]: ...
+) -> Iterator[list[_T]]: ...
 def split_when(
     iterable: Iterable[_T],
     pred: Callable[[_T, _T], object],
     maxsplit: int = ...,
-) -> Iterator[List[_T]]: ...
+) -> Iterator[list[_T]]: ...
 def split_into(
-    iterable: Iterable[_T], sizes: Iterable[Optional[int]]
-) -> Iterator[List[_T]]: ...
+    iterable: Iterable[_T], sizes: Iterable[int | None]
+) -> Iterator[list[_T]]: ...
 @overload
 def padded(
     iterable: Iterable[_T],
     *,
-    n: Optional[int] = ...,
+    n: int | None = ...,
     next_multiple: bool = ...,
-) -> Iterator[Optional[_T]]: ...
+) -> Iterator[_T | None]: ...
 @overload
 def padded(
     iterable: Iterable[_T],
     fillvalue: _U,
-    n: Optional[int] = ...,
+    n: int | None = ...,
     next_multiple: bool = ...,
-) -> Iterator[Union[_T, _U]]: ...
+) -> Iterator[_T | _U]: ...
 @overload
 def repeat_last(iterable: Iterable[_T]) -> Iterator[_T]: ...
 @overload
-def repeat_last(
-    iterable: Iterable[_T], default: _U
-) -> Iterator[Union[_T, _U]]: ...
-def distribute(n: int, iterable: Iterable[_T]) -> List[Iterator[_T]]: ...
+def repeat_last(iterable: Iterable[_T], default: _U) -> Iterator[_T | _U]: ...
+def distribute(n: int, iterable: Iterable[_T]) -> list[Iterator[_T]]: ...
 @overload
 def stagger(
     iterable: Iterable[_T],
     offsets: _SizedIterable[int] = ...,
     longest: bool = ...,
-) -> Iterator[Tuple[Optional[_T], ...]]: ...
+) -> Iterator[tuple[_T | None, ...]]: ...
 @overload
 def stagger(
     iterable: Iterable[_T],
     offsets: _SizedIterable[int] = ...,
     longest: bool = ...,
     fillvalue: _U = ...,
-) -> Iterator[Tuple[Union[_T, _U], ...]]: ...
+) -> Iterator[tuple[_T | _U, ...]]: ...
 
 class UnequalIterablesError(ValueError):
-    def __init__(
-        self, details: Optional[Tuple[int, int, int]] = ...
-    ) -> None: ...
+    def __init__(self, details: tuple[int, int, int] | None = ...) -> None: ...
 
 @overload
-def zip_equal(__iter1: Iterable[_T1]) -> Iterator[Tuple[_T1]]: ...
+def zip_equal(__iter1: Iterable[_T1]) -> Iterator[tuple[_T1]]: ...
 @overload
 def zip_equal(
     __iter1: Iterable[_T1], __iter2: Iterable[_T2]
-) -> Iterator[Tuple[_T1, _T2]]: ...
+) -> Iterator[tuple[_T1, _T2]]: ...
 @overload
 def zip_equal(
     __iter1: Iterable[_T],
     __iter2: Iterable[_T],
     __iter3: Iterable[_T],
     *iterables: Iterable[_T],
-) -> Iterator[Tuple[_T, ...]]: ...
+) -> Iterator[tuple[_T, ...]]: ...
 @overload
 def zip_offset(
     __iter1: Iterable[_T1],
@@ -233,7 +230,7 @@ def zip_offset(
     offsets: _SizedIterable[int],
     longest: bool = ...,
     fillvalue: None = None,
-) -> Iterator[Tuple[Optional[_T1]]]: ...
+) -> Iterator[tuple[_T1 | None]]: ...
 @overload
 def zip_offset(
     __iter1: Iterable[_T1],
@@ -242,7 +239,7 @@ def zip_offset(
     offsets: _SizedIterable[int],
     longest: bool = ...,
     fillvalue: None = None,
-) -> Iterator[Tuple[Optional[_T1], Optional[_T2]]]: ...
+) -> Iterator[tuple[_T1 | None, _T2 | None]]: ...
 @overload
 def zip_offset(
     __iter1: Iterable[_T],
@@ -252,7 +249,7 @@ def zip_offset(
     offsets: _SizedIterable[int],
     longest: bool = ...,
     fillvalue: None = None,
-) -> Iterator[Tuple[Optional[_T], ...]]: ...
+) -> Iterator[tuple[_T | None, ...]]: ...
 @overload
 def zip_offset(
     __iter1: Iterable[_T1],
@@ -260,7 +257,7 @@ def zip_offset(
     offsets: _SizedIterable[int],
     longest: bool = ...,
     fillvalue: _U,
-) -> Iterator[Tuple[Union[_T1, _U]]]: ...
+) -> Iterator[tuple[_T1 | _U]]: ...
 @overload
 def zip_offset(
     __iter1: Iterable[_T1],
@@ -269,7 +266,7 @@ def zip_offset(
     offsets: _SizedIterable[int],
     longest: bool = ...,
     fillvalue: _U,
-) -> Iterator[Tuple[Union[_T1, _U], Union[_T2, _U]]]: ...
+) -> Iterator[tuple[_T1 | _U, _T2 | _U]]: ...
 @overload
 def zip_offset(
     __iter1: Iterable[_T],
@@ -279,82 +276,80 @@ def zip_offset(
     offsets: _SizedIterable[int],
     longest: bool = ...,
     fillvalue: _U,
-) -> Iterator[Tuple[Union[_T, _U], ...]]: ...
+) -> Iterator[tuple[_T | _U, ...]]: ...
 def sort_together(
     iterables: Iterable[Iterable[_T]],
     key_list: Iterable[int] = ...,
-    key: Optional[Callable[..., Any]] = ...,
+    key: Callable[..., Any] | None = ...,
     reverse: bool = ...,
-) -> List[Tuple[_T, ...]]: ...
-def unzip(iterable: Iterable[Sequence[_T]]) -> Tuple[Iterator[_T], ...]: ...
-def divide(n: int, iterable: Iterable[_T]) -> List[Iterator[_T]]: ...
+) -> list[tuple[_T, ...]]: ...
+def unzip(iterable: Iterable[Sequence[_T]]) -> tuple[Iterator[_T], ...]: ...
+def divide(n: int, iterable: Iterable[_T]) -> list[Iterator[_T]]: ...
 def always_iterable(
     obj: object,
-    base_type: Union[
-        type, Tuple[Union[type, Tuple[Any, ...]], ...], None
-    ] = ...,
+    base_type: type | tuple[type | tuple[Any, ...], ...] | None = ...,
 ) -> Iterator[Any]: ...
 def adjacent(
     predicate: Callable[[_T], bool],
     iterable: Iterable[_T],
     distance: int = ...,
-) -> Iterator[Tuple[bool, _T]]: ...
+) -> Iterator[tuple[bool, _T]]: ...
 @overload
 def groupby_transform(
     iterable: Iterable[_T],
     keyfunc: None = None,
     valuefunc: None = None,
     reducefunc: None = None,
-) -> Iterator[Tuple[_T, Iterator[_T]]]: ...
+) -> Iterator[tuple[_T, Iterator[_T]]]: ...
 @overload
 def groupby_transform(
     iterable: Iterable[_T],
     keyfunc: Callable[[_T], _U],
     valuefunc: None,
     reducefunc: None,
-) -> Iterator[Tuple[_U, Iterator[_T]]]: ...
+) -> Iterator[tuple[_U, Iterator[_T]]]: ...
 @overload
 def groupby_transform(
     iterable: Iterable[_T],
     keyfunc: None,
     valuefunc: Callable[[_T], _V],
     reducefunc: None,
-) -> Iterable[Tuple[_T, Iterable[_V]]]: ...
+) -> Iterable[tuple[_T, Iterable[_V]]]: ...
 @overload
 def groupby_transform(
     iterable: Iterable[_T],
     keyfunc: Callable[[_T], _U],
     valuefunc: Callable[[_T], _V],
     reducefunc: None,
-) -> Iterable[Tuple[_U, Iterator[_V]]]: ...
+) -> Iterable[tuple[_U, Iterator[_V]]]: ...
 @overload
 def groupby_transform(
     iterable: Iterable[_T],
     keyfunc: None,
     valuefunc: None,
     reducefunc: Callable[[Iterator[_T]], _W],
-) -> Iterable[Tuple[_T, _W]]: ...
+) -> Iterable[tuple[_T, _W]]: ...
 @overload
 def groupby_transform(
     iterable: Iterable[_T],
     keyfunc: Callable[[_T], _U],
     valuefunc: None,
     reducefunc: Callable[[Iterator[_T]], _W],
-) -> Iterable[Tuple[_U, _W]]: ...
+) -> Iterable[tuple[_U, _W]]: ...
 @overload
 def groupby_transform(
     iterable: Iterable[_T],
     keyfunc: None,
     valuefunc: Callable[[_T], _V],
     reducefunc: Callable[[Iterable[_V]], _W],
-) -> Iterable[Tuple[_T, _W]]: ...
+) -> Iterable[tuple[_T, _W]]: ...
 @overload
 def groupby_transform(
     iterable: Iterable[_T],
     keyfunc: Callable[[_T], _U],
     valuefunc: Callable[[_T], _V],
     reducefunc: Callable[[Iterable[_V]], _W],
-) -> Iterable[Tuple[_U, _W]]: ...
+) -> Iterable[tuple[_U, _W]]: ...
 
 class numeric_range(Generic[_T, _U], Sequence[_T], Hashable, Reversible[_T]):
     @overload
@@ -375,22 +370,22 @@ class numeric_range(Generic[_T, _U], Sequence[_T], Hashable, Reversible[_T]):
     def __len__(self) -> int: ...
     def __reduce__(
         self,
-    ) -> Tuple[Type[numeric_range[_T, _U]], Tuple[_T, _T, _U]]: ...
+    ) -> tuple[Type[numeric_range[_T, _U]], tuple[_T, _T, _U]]: ...
     def __repr__(self) -> str: ...
     def __reversed__(self) -> Iterator[_T]: ...
     def count(self, value: _T) -> int: ...
     def index(self, value: _T) -> int: ...  # type: ignore
 
 def count_cycle(
-    iterable: Iterable[_T], n: Optional[int] = ...
-) -> Iterable[Tuple[int, _T]]: ...
+    iterable: Iterable[_T], n: int | None = ...
+) -> Iterable[tuple[int, _T]]: ...
 def mark_ends(
     iterable: Iterable[_T],
-) -> Iterable[Tuple[bool, bool, _T]]: ...
+) -> Iterable[tuple[bool, bool, _T]]: ...
 def locate(
     iterable: Iterable[object],
     pred: Callable[..., Any] = ...,
-    window_size: Optional[int] = ...,
+    window_size: int | None = ...,
 ) -> Iterator[int]: ...
 def lstrip(
     iterable: Iterable[_T], pred: Callable[[_T], object]
@@ -403,9 +398,7 @@ def strip(
 ) -> Iterator[_T]: ...
 
 class islice_extended(Generic[_T], Iterator[_T]):
-    def __init__(
-        self, iterable: Iterable[_T], *args: Optional[int]
-    ) -> None: ...
+    def __init__(self, iterable: Iterable[_T], *args: int | None) -> None: ...
     def __iter__(self) -> islice_extended[_T]: ...
     def __next__(self) -> _T: ...
     def __getitem__(self, index: slice) -> islice_extended[_T]: ...
@@ -420,7 +413,7 @@ def difference(
     func: Callable[[_T, _T], _U] = ...,
     *,
     initial: None = ...,
-) -> Iterator[Union[_T, _U]]: ...
+) -> Iterator[_T | _U]: ...
 @overload
 def difference(
     iterable: Iterable[_T], func: Callable[[_T, _T], _U] = ..., *, initial: _U
@@ -436,7 +429,7 @@ class SequenceView(Generic[_T], Sequence[_T]):
 
 class seekable(Generic[_T], Iterator[_T]):
     def __init__(
-        self, iterable: Iterable[_T], maxlen: Optional[int] = ...
+        self, iterable: Iterable[_T], maxlen: int | None = ...
     ) -> None: ...
     def __iter__(self) -> seekable[_T]: ...
     def __next__(self) -> _T: ...
@@ -444,20 +437,20 @@ class seekable(Generic[_T], Iterator[_T]):
     @overload
     def peek(self) -> _T: ...
     @overload
-    def peek(self, default: _U) -> Union[_T, _U]: ...
+    def peek(self, default: _U) -> _T | _U: ...
     def elements(self) -> SequenceView[_T]: ...
     def seek(self, index: int) -> None: ...
 
 class run_length:
     @staticmethod
-    def encode(iterable: Iterable[_T]) -> Iterator[Tuple[_T, int]]: ...
+    def encode(iterable: Iterable[_T]) -> Iterator[tuple[_T, int]]: ...
     @staticmethod
-    def decode(iterable: Iterable[Tuple[_T, int]]) -> Iterator[_T]: ...
+    def decode(iterable: Iterable[tuple[_T, int]]) -> Iterator[_T]: ...
 
 def exactly_n(
     iterable: Iterable[_T], n: int, predicate: Callable[[_T], object] = ...
 ) -> bool: ...
-def circular_shifts(iterable: Iterable[_T]) -> List[Tuple[_T, ...]]: ...
+def circular_shifts(iterable: Iterable[_T]) -> list[tuple[_T, ...]]: ...
 def make_decorator(
     wrapping_func: Callable[..., _U], result_index: int = ...
 ) -> Callable[..., Callable[[Callable[..., Any]], Callable[..., _U]]]: ...
@@ -467,44 +460,44 @@ def map_reduce(
     keyfunc: Callable[[_T], _U],
     valuefunc: None = ...,
     reducefunc: None = ...,
-) -> Dict[_U, List[_T]]: ...
+) -> dict[_U, list[_T]]: ...
 @overload
 def map_reduce(
     iterable: Iterable[_T],
     keyfunc: Callable[[_T], _U],
     valuefunc: Callable[[_T], _V],
     reducefunc: None = ...,
-) -> Dict[_U, List[_V]]: ...
+) -> dict[_U, list[_V]]: ...
 @overload
 def map_reduce(
     iterable: Iterable[_T],
     keyfunc: Callable[[_T], _U],
     valuefunc: None = ...,
-    reducefunc: Callable[[List[_T]], _W] = ...,
-) -> Dict[_U, _W]: ...
+    reducefunc: Callable[[list[_T]], _W] = ...,
+) -> dict[_U, _W]: ...
 @overload
 def map_reduce(
     iterable: Iterable[_T],
     keyfunc: Callable[[_T], _U],
     valuefunc: Callable[[_T], _V],
-    reducefunc: Callable[[List[_V]], _W],
-) -> Dict[_U, _W]: ...
+    reducefunc: Callable[[list[_V]], _W],
+) -> dict[_U, _W]: ...
 def rlocate(
     iterable: Iterable[_T],
     pred: Callable[..., object] = ...,
-    window_size: Optional[int] = ...,
+    window_size: int | None = ...,
 ) -> Iterator[int]: ...
 def replace(
     iterable: Iterable[_T],
     pred: Callable[..., object],
     substitutes: Iterable[_U],
-    count: Optional[int] = ...,
+    count: int | None = ...,
     window_size: int = ...,
-) -> Iterator[Union[_T, _U]]: ...
-def partitions(iterable: Iterable[_T]) -> Iterator[List[List[_T]]]: ...
+) -> Iterator[_T | _U]: ...
+def partitions(iterable: Iterable[_T]) -> Iterator[list[list[_T]]]: ...
 def set_partitions(
-    iterable: Iterable[_T], k: Optional[int] = ...
-) -> Iterator[List[List[_T]]]: ...
+    iterable: Iterable[_T], k: int | None = ...
+) -> Iterator[list[list[_T]]]: ...
 
 class time_limited(Generic[_T], Iterator[_T]):
     def __init__(
@@ -515,16 +508,16 @@ class time_limited(Generic[_T], Iterator[_T]):
 
 @overload
 def only(
-    iterable: Iterable[_T], *, too_long: Optional[_Raisable] = ...
-) -> Optional[_T]: ...
+    iterable: Iterable[_T], *, too_long: _Raisable | None = ...
+) -> _T | None: ...
 @overload
 def only(
-    iterable: Iterable[_T], default: _U, too_long: Optional[_Raisable] = ...
-) -> Union[_T, _U]: ...
+    iterable: Iterable[_T], default: _U, too_long: _Raisable | None = ...
+) -> _T | _U: ...
 def ichunked(iterable: Iterable[_T], n: int) -> Iterator[Iterator[_T]]: ...
 def distinct_combinations(
     iterable: Iterable[_T], r: int
-) -> Iterator[Tuple[_T, ...]]: ...
+) -> Iterator[tuple[_T, ...]]: ...
 def filter_except(
     validator: Callable[[Any], object],
     iterable: Iterable[_T],
@@ -539,16 +532,16 @@ def map_if(
     iterable: Iterable[Any],
     pred: Callable[[Any], bool],
     func: Callable[[Any], Any],
-    func_else: Optional[Callable[[Any], Any]] = ...,
+    func_else: Callable[[Any], Any] | None = ...,
 ) -> Iterator[Any]: ...
 def sample(
     iterable: Iterable[_T],
     k: int,
-    weights: Optional[Iterable[float]] = ...,
-) -> List[_T]: ...
+    weights: Iterable[float] | None = ...,
+) -> list[_T]: ...
 def is_sorted(
     iterable: Iterable[_T],
-    key: Optional[Callable[[_T], _U]] = ...,
+    key: Callable[[_T], _U] | None = ...,
     reverse: bool = False,
     strict: bool = False,
 ) -> bool: ...
@@ -566,10 +559,10 @@ class callback_iter(Generic[_T], Iterator[_T]):
     def __enter__(self) -> callback_iter[_T]: ...
     def __exit__(
         self,
-        exc_type: Optional[Type[BaseException]],
-        exc_value: Optional[BaseException],
-        traceback: Optional[TracebackType],
-    ) -> Optional[bool]: ...
+        exc_type: Type[BaseException] | None,
+        exc_value: BaseException | None,
+        traceback: TracebackType | None,
+    ) -> bool | None: ...
     def __iter__(self) -> callback_iter[_T]: ...
     def __next__(self) -> _T: ...
     def _reader(self) -> Iterator[_T]: ...
@@ -580,15 +573,15 @@ class callback_iter(Generic[_T], Iterator[_T]):
 
 def windowed_complete(
     iterable: Iterable[_T], n: int
-) -> Iterator[Tuple[_T, ...]]: ...
+) -> Iterator[tuple[_T, ...]]: ...
 def all_unique(
-    iterable: Iterable[_T], key: Optional[Callable[[_T], _U]] = ...
+    iterable: Iterable[_T], key: Callable[[_T], _U] | None = ...
 ) -> bool: ...
-def nth_product(index: int, *args: Iterable[_T]) -> Tuple[_T, ...]: ...
+def nth_product(index: int, *args: Iterable[_T]) -> tuple[_T, ...]: ...
 def nth_permutation(
     iterable: Iterable[_T], r: int, index: int
-) -> Tuple[_T, ...]: ...
-def value_chain(*args: Union[_T, Iterable[_T]]) -> Iterable[_T]: ...
+) -> tuple[_T, ...]: ...
+def value_chain(*args: _T | Iterable[_T]) -> Iterable[_T]: ...
 def product_index(element: Iterable[_T], *args: Iterable[_T]) -> int: ...
 def combination_index(
     element: Iterable[_T], iterable: Iterable[_T]
@@ -603,22 +596,20 @@ class countable(Generic[_T], Iterator[_T]):
     def __iter__(self) -> countable[_T]: ...
     def __next__(self) -> _T: ...
 
-def chunked_even(iterable: Iterable[_T], n: int) -> Iterator[List[_T]]: ...
+def chunked_even(iterable: Iterable[_T], n: int) -> Iterator[list[_T]]: ...
 def zip_broadcast(
-    *objects: Union[_T, Iterable[_T]],
-    scalar_types: Union[
-        type, Tuple[Union[type, Tuple[Any, ...]], ...], None
-    ] = ...,
+    *objects: _T | Iterable[_T],
+    scalar_types: type | tuple[type | tuple[Any, ...], ...] | None = ...,
     strict: bool = ...,
-) -> Iterable[Tuple[_T, ...]]: ...
+) -> Iterable[tuple[_T, ...]]: ...
 def unique_in_window(
-    iterable: Iterable[_T], n: int, key: Optional[Callable[[_T], _U]] = ...
+    iterable: Iterable[_T], n: int, key: Callable[[_T], _U] | None = ...
 ) -> Iterator[_T]: ...
 def duplicates_everseen(
-    iterable: Iterable[_T], key: Optional[Callable[[_T], _U]] = ...
+    iterable: Iterable[_T], key: Callable[[_T], _U] | None = ...
 ) -> Iterator[_T]: ...
 def duplicates_justseen(
-    iterable: Iterable[_T], key: Optional[Callable[[_T], _U]] = ...
+    iterable: Iterable[_T], key: Callable[[_T], _U] | None = ...
 ) -> Iterator[_T]: ...
 
 class _SupportsLessThan(Protocol):
@@ -629,38 +620,38 @@ _SupportsLessThanT = TypeVar("_SupportsLessThanT", bound=_SupportsLessThan)
 @overload
 def minmax(
     iterable_or_value: Iterable[_SupportsLessThanT], *, key: None = None
-) -> Tuple[_SupportsLessThanT, _SupportsLessThanT]: ...
+) -> tuple[_SupportsLessThanT, _SupportsLessThanT]: ...
 @overload
 def minmax(
     iterable_or_value: Iterable[_T], *, key: Callable[[_T], _SupportsLessThan]
-) -> Tuple[_T, _T]: ...
+) -> tuple[_T, _T]: ...
 @overload
 def minmax(
     iterable_or_value: Iterable[_SupportsLessThanT],
     *,
     key: None = None,
     default: _U,
-) -> Union[_U, Tuple[_SupportsLessThanT, _SupportsLessThanT]]: ...
+) -> _U | tuple[_SupportsLessThanT, _SupportsLessThanT]: ...
 @overload
 def minmax(
     iterable_or_value: Iterable[_T],
     *,
     key: Callable[[_T], _SupportsLessThan],
     default: _U,
-) -> Union[_U, Tuple[_T, _T]]: ...
+) -> _U | tuple[_T, _T]: ...
 @overload
 def minmax(
     iterable_or_value: _SupportsLessThanT,
     __other: _SupportsLessThanT,
     *others: _SupportsLessThanT,
-) -> Tuple[_SupportsLessThanT, _SupportsLessThanT]: ...
+) -> tuple[_SupportsLessThanT, _SupportsLessThanT]: ...
 @overload
 def minmax(
     iterable_or_value: _T,
     __other: _T,
     *others: _T,
     key: Callable[[_T], _SupportsLessThan],
-) -> Tuple[_T, _T]: ...
+) -> tuple[_T, _T]: ...
 def longest_common_prefix(
     iterables: Iterable[Iterable[_T]],
 ) -> Iterator[_T]: ...
@@ -668,7 +659,8 @@ def iequals(*iterables: Iterable[object]) -> bool: ...
 def constrained_batches(
     iterable: Iterable[object],
     max_size: int,
-    max_count: Optional[int] = ...,
+    max_count: int | None = ...,
     get_len: Callable[[_T], object] = ...,
     strict: bool = ...,
-) -> Iterator[Tuple[_T]]: ...
+) -> Iterator[tuple[_T]]: ...
+def gray_product(*iterables: Iterable[_T]) -> Iterator[tuple[_T, ...]]: ...
diff --git a/lib/more_itertools/recipes.py b/lib/more_itertools/recipes.py
index 85796207..3facc2e3 100644
--- a/lib/more_itertools/recipes.py
+++ b/lib/more_itertools/recipes.py
@@ -9,6 +9,7 @@ Some backward-compatible usability improvements have been made.
 """
 import math
 import operator
+import warnings
 
 from collections import deque
 from collections.abc import Sized
@@ -21,12 +22,14 @@ from itertools import (
     cycle,
     groupby,
     islice,
+    product,
     repeat,
     starmap,
     tee,
     zip_longest,
 )
 from random import randrange, sample, choice
+from sys import hexversion
 
 __all__ = [
     'all_equal',
@@ -36,9 +39,12 @@ __all__ = [
     'convolve',
     'dotproduct',
     'first_true',
+    'factor',
     'flatten',
     'grouper',
     'iter_except',
+    'iter_index',
+    'matmul',
     'ncycles',
     'nth',
     'nth_combination',
@@ -62,6 +68,7 @@ __all__ = [
     'tabulate',
     'tail',
     'take',
+    'transpose',
     'triplewise',
     'unique_everseen',
     'unique_justseen',
@@ -808,6 +815,35 @@ def polynomial_from_roots(roots):
     ]
 
 
+def iter_index(iterable, value, start=0):
+    """Yield the index of each place in *iterable* that *value* occurs,
+    beginning with index *start*.
+
+    See :func:`locate` for a more general means of finding the indexes
+    associated with particular values.
+
+    >>> list(iter_index('AABCADEAF', 'A'))
+    [0, 1, 4, 7]
+    """
+    try:
+        seq_index = iterable.index
+    except AttributeError:
+        # Slow path for general iterables
+        it = islice(iterable, start, None)
+        for i, element in enumerate(it, start):
+            if element is value or element == value:
+                yield i
+    else:
+        # Fast path for sequences
+        i = start - 1
+        try:
+            while True:
+                i = seq_index(value, i + 1)
+                yield i
+        except ValueError:
+            pass
+
+
 def sieve(n):
     """Yield the primes less than n.
 
@@ -815,13 +851,13 @@ def sieve(n):
     [2, 3, 5, 7, 11, 13, 17, 19, 23, 29]
     """
     isqrt = getattr(math, 'isqrt', lambda x: int(math.sqrt(x)))
+    data = bytearray((0, 1)) * (n // 2)
+    data[:3] = 0, 0, 0
     limit = isqrt(n) + 1
-    data = bytearray([1]) * n
-    data[:2] = 0, 0
     for p in compress(range(limit), data):
-        data[p + p : n : p] = bytearray(len(range(p + p, n, p)))
-
-    return compress(count(), data)
+        data[p * p : n : p + p] = bytes(len(range(p * p, n, p + p)))
+    data[2] = 1
+    return iter_index(data, 1) if n > 2 else iter([])
 
 
 def batched(iterable, n):
@@ -833,9 +869,62 @@ def batched(iterable, n):
     This recipe is from the ``itertools`` docs. This library also provides
     :func:`chunked`, which has a different implementation.
     """
+    if hexversion >= 0x30C00A0:  # Python 3.12.0a0
+        warnings.warn(
+            (
+                'batched will be removed in a future version of '
+                'more-itertools. Use the standard library '
+                'itertools.batched function instead'
+            ),
+            DeprecationWarning,
+        )
+
     it = iter(iterable)
     while True:
         batch = list(islice(it, n))
         if not batch:
             break
         yield batch
+
+
+def transpose(it):
+    """Swap the rows and columns of the input.
+
+    >>> list(transpose([(1, 2, 3), (11, 22, 33)]))
+    [(1, 11), (2, 22), (3, 33)]
+
+    The caller should ensure that the dimensions of the input are compatible.
+    """
+    # TODO: when 3.9 goes end-of-life, add stric=True to this.
+    return zip(*it)
+
+
+def matmul(m1, m2):
+    """Multiply two matrices.
+    >>> list(matmul([(7, 5), (3, 5)], [(2, 5), (7, 9)]))
+    [[49, 80], [41, 60]]
+
+    The caller should ensure that the dimensions of the input matrices are
+    compatible with each other.
+    """
+    n = len(m2[0])
+    return batched(starmap(dotproduct, product(m1, transpose(m2))), n)
+
+
+def factor(n):
+    """Yield the prime factors of n.
+    >>> list(factor(360))
+    [2, 2, 2, 3, 3, 5]
+    """
+    isqrt = getattr(math, 'isqrt', lambda x: int(math.sqrt(x)))
+    for prime in sieve(isqrt(n) + 1):
+        while True:
+            quotient, remainder = divmod(n, prime)
+            if remainder:
+                break
+            yield prime
+            n = quotient
+            if n == 1:
+                return
+    if n >= 2:
+        yield n
diff --git a/lib/more_itertools/recipes.pyi b/lib/more_itertools/recipes.pyi
index 29415c5a..0267ed56 100644
--- a/lib/more_itertools/recipes.pyi
+++ b/lib/more_itertools/recipes.pyi
@@ -1,110 +1,119 @@
 """Stubs for more_itertools.recipes"""
+from __future__ import annotations
+
 from typing import (
     Any,
     Callable,
     Iterable,
     Iterator,
-    List,
-    Optional,
+    overload,
     Sequence,
-    Tuple,
+    Type,
     TypeVar,
-    Union,
 )
-from typing_extensions import overload, Type
 
 # Type and type variable definitions
 _T = TypeVar('_T')
 _U = TypeVar('_U')
 
-def take(n: int, iterable: Iterable[_T]) -> List[_T]: ...
+def take(n: int, iterable: Iterable[_T]) -> list[_T]: ...
 def tabulate(
     function: Callable[[int], _T], start: int = ...
 ) -> Iterator[_T]: ...
 def tail(n: int, iterable: Iterable[_T]) -> Iterator[_T]: ...
-def consume(iterator: Iterable[object], n: Optional[int] = ...) -> None: ...
+def consume(iterator: Iterable[object], n: int | None = ...) -> None: ...
 @overload
-def nth(iterable: Iterable[_T], n: int) -> Optional[_T]: ...
+def nth(iterable: Iterable[_T], n: int) -> _T | None: ...
 @overload
-def nth(iterable: Iterable[_T], n: int, default: _U) -> Union[_T, _U]: ...
+def nth(iterable: Iterable[_T], n: int, default: _U) -> _T | _U: ...
 def all_equal(iterable: Iterable[object]) -> bool: ...
 def quantify(
     iterable: Iterable[_T], pred: Callable[[_T], bool] = ...
 ) -> int: ...
-def pad_none(iterable: Iterable[_T]) -> Iterator[Optional[_T]]: ...
-def padnone(iterable: Iterable[_T]) -> Iterator[Optional[_T]]: ...
+def pad_none(iterable: Iterable[_T]) -> Iterator[_T | None]: ...
+def padnone(iterable: Iterable[_T]) -> Iterator[_T | None]: ...
 def ncycles(iterable: Iterable[_T], n: int) -> Iterator[_T]: ...
 def dotproduct(vec1: Iterable[object], vec2: Iterable[object]) -> object: ...
 def flatten(listOfLists: Iterable[Iterable[_T]]) -> Iterator[_T]: ...
 def repeatfunc(
-    func: Callable[..., _U], times: Optional[int] = ..., *args: Any
+    func: Callable[..., _U], times: int | None = ..., *args: Any
 ) -> Iterator[_U]: ...
-def pairwise(iterable: Iterable[_T]) -> Iterator[Tuple[_T, _T]]: ...
+def pairwise(iterable: Iterable[_T]) -> Iterator[tuple[_T, _T]]: ...
 def grouper(
     iterable: Iterable[_T],
     n: int,
     incomplete: str = ...,
     fillvalue: _U = ...,
-) -> Iterator[Tuple[Union[_T, _U], ...]]: ...
+) -> Iterator[tuple[_T | _U, ...]]: ...
 def roundrobin(*iterables: Iterable[_T]) -> Iterator[_T]: ...
 def partition(
-    pred: Optional[Callable[[_T], object]], iterable: Iterable[_T]
-) -> Tuple[Iterator[_T], Iterator[_T]]: ...
-def powerset(iterable: Iterable[_T]) -> Iterator[Tuple[_T, ...]]: ...
+    pred: Callable[[_T], object] | None, iterable: Iterable[_T]
+) -> tuple[Iterator[_T], Iterator[_T]]: ...
+def powerset(iterable: Iterable[_T]) -> Iterator[tuple[_T, ...]]: ...
 def unique_everseen(
-    iterable: Iterable[_T], key: Optional[Callable[[_T], _U]] = ...
+    iterable: Iterable[_T], key: Callable[[_T], _U] | None = ...
 ) -> Iterator[_T]: ...
 def unique_justseen(
-    iterable: Iterable[_T], key: Optional[Callable[[_T], object]] = ...
+    iterable: Iterable[_T], key: Callable[[_T], object] | None = ...
 ) -> Iterator[_T]: ...
 @overload
 def iter_except(
     func: Callable[[], _T],
-    exception: Union[Type[BaseException], Tuple[Type[BaseException], ...]],
+    exception: Type[BaseException] | tuple[Type[BaseException], ...],
     first: None = ...,
 ) -> Iterator[_T]: ...
 @overload
 def iter_except(
     func: Callable[[], _T],
-    exception: Union[Type[BaseException], Tuple[Type[BaseException], ...]],
+    exception: Type[BaseException] | tuple[Type[BaseException], ...],
     first: Callable[[], _U],
-) -> Iterator[Union[_T, _U]]: ...
+) -> Iterator[_T | _U]: ...
 @overload
 def first_true(
-    iterable: Iterable[_T], *, pred: Optional[Callable[[_T], object]] = ...
-) -> Optional[_T]: ...
+    iterable: Iterable[_T], *, pred: Callable[[_T], object] | None = ...
+) -> _T | None: ...
 @overload
 def first_true(
     iterable: Iterable[_T],
     default: _U,
-    pred: Optional[Callable[[_T], object]] = ...,
-) -> Union[_T, _U]: ...
+    pred: Callable[[_T], object] | None = ...,
+) -> _T | _U: ...
 def random_product(
     *args: Iterable[_T], repeat: int = ...
-) -> Tuple[_T, ...]: ...
+) -> tuple[_T, ...]: ...
 def random_permutation(
-    iterable: Iterable[_T], r: Optional[int] = ...
-) -> Tuple[_T, ...]: ...
-def random_combination(iterable: Iterable[_T], r: int) -> Tuple[_T, ...]: ...
+    iterable: Iterable[_T], r: int | None = ...
+) -> tuple[_T, ...]: ...
+def random_combination(iterable: Iterable[_T], r: int) -> tuple[_T, ...]: ...
 def random_combination_with_replacement(
     iterable: Iterable[_T], r: int
-) -> Tuple[_T, ...]: ...
+) -> tuple[_T, ...]: ...
 def nth_combination(
     iterable: Iterable[_T], r: int, index: int
-) -> Tuple[_T, ...]: ...
-def prepend(value: _T, iterator: Iterable[_U]) -> Iterator[Union[_T, _U]]: ...
+) -> tuple[_T, ...]: ...
+def prepend(value: _T, iterator: Iterable[_U]) -> Iterator[_T | _U]: ...
 def convolve(signal: Iterable[_T], kernel: Iterable[_T]) -> Iterator[_T]: ...
 def before_and_after(
     predicate: Callable[[_T], bool], it: Iterable[_T]
-) -> Tuple[Iterator[_T], Iterator[_T]]: ...
-def triplewise(iterable: Iterable[_T]) -> Iterator[Tuple[_T, _T, _T]]: ...
+) -> tuple[Iterator[_T], Iterator[_T]]: ...
+def triplewise(iterable: Iterable[_T]) -> Iterator[tuple[_T, _T, _T]]: ...
 def sliding_window(
     iterable: Iterable[_T], n: int
-) -> Iterator[Tuple[_T, ...]]: ...
-def subslices(iterable: Iterable[_T]) -> Iterator[List[_T]]: ...
-def polynomial_from_roots(roots: Sequence[int]) -> List[int]: ...
+) -> Iterator[tuple[_T, ...]]: ...
+def subslices(iterable: Iterable[_T]) -> Iterator[list[_T]]: ...
+def polynomial_from_roots(roots: Sequence[int]) -> list[int]: ...
+def iter_index(
+    iterable: Iterable[object],
+    value: Any,
+    start: int | None = ...,
+) -> Iterator[int]: ...
 def sieve(n: int) -> Iterator[int]: ...
 def batched(
     iterable: Iterable[_T],
     n: int,
-) -> Iterator[List[_T]]: ...
+) -> Iterator[list[_T]]: ...
+def transpose(
+    it: Iterable[Iterable[_T]],
+) -> tuple[Iterator[_T], ...]: ...
+def matmul(m1: Sequence[_T], m2: Sequence[_T]) -> Iterator[list[_T]]: ...
+def factor(n: int) -> Iterator[int]: ...
diff --git a/lib/tempora/__init__.py b/lib/tempora/__init__.py
index cece8bb7..27d5e828 100644
--- a/lib/tempora/__init__.py
+++ b/lib/tempora/__init__.py
@@ -11,9 +11,6 @@ from typing import Union, Tuple, Iterable
 from typing import cast
 
 
-from jaraco.functools import once
-
-
 # some useful constants
 osc_per_year = 290_091_329_207_984_000
 """
@@ -36,7 +33,7 @@ seconds_per_month = seconds_per_year / 12
 hours_per_month = hours_per_day * days_per_year / 12
 
 
-@once
+@functools.lru_cache()
 def _needs_year_help() -> bool:
     """
     Some versions of Python render %Y with only three characters :(
diff --git a/lib/tempora/tests/test_schedule.py b/lib/tempora/tests/test_schedule.py
deleted file mode 100644
index 0ce35435..00000000
--- a/lib/tempora/tests/test_schedule.py
+++ /dev/null
@@ -1,149 +0,0 @@
-import time
-import random
-import datetime
-from unittest import mock
-
-import pytest
-import pytz
-import freezegun
-
-from tempora import schedule
-
-
-do_nothing = type(None)
-
-
-def test_delayed_command_order():
-    """
-    delayed commands should be sorted by delay time
-    """
-    delays = [random.randint(0, 99) for x in range(5)]
-    cmds = sorted(
-        [schedule.DelayedCommand.after(delay, do_nothing) for delay in delays]
-    )
-    assert [c.delay.seconds for c in cmds] == sorted(delays)
-
-
-def test_periodic_command_delay():
-    "A PeriodicCommand must have a positive, non-zero delay."
-    with pytest.raises(ValueError) as exc_info:
-        schedule.PeriodicCommand.after(0, None)
-    assert str(exc_info.value) == test_periodic_command_delay.__doc__
-
-
-def test_periodic_command_fixed_delay():
-    """
-    Test that we can construct a periodic command with a fixed initial
-    delay.
-    """
-    fd = schedule.PeriodicCommandFixedDelay.at_time(
-        at=schedule.now(), delay=datetime.timedelta(seconds=2), target=lambda: None
-    )
-    assert fd.due() is True
-    assert fd.next().due() is False
-
-
-class TestCommands:
-    def test_delayed_command_from_timestamp(self):
-        """
-        Ensure a delayed command can be constructed from a timestamp.
-        """
-        t = time.time()
-        schedule.DelayedCommand.at_time(t, do_nothing)
-
-    def test_command_at_noon(self):
-        """
-        Create a periodic command that's run at noon every day.
-        """
-        when = datetime.time(12, 0, tzinfo=pytz.utc)
-        cmd = schedule.PeriodicCommandFixedDelay.daily_at(when, target=None)
-        assert cmd.due() is False
-        next_cmd = cmd.next()
-        daily = datetime.timedelta(days=1)
-        day_from_now = schedule.now() + daily
-        two_days_from_now = day_from_now + daily
-        assert day_from_now < next_cmd < two_days_from_now
-
-    @pytest.mark.parametrize("hour", range(10, 14))
-    @pytest.mark.parametrize("tz_offset", (14, -14))
-    def test_command_at_noon_distant_local(self, hour, tz_offset):
-        """
-        Run test_command_at_noon, but with the local timezone
-        more than 12 hours away from UTC.
-        """
-        with freezegun.freeze_time(f"2020-01-10 {hour:02}:01", tz_offset=tz_offset):
-            self.test_command_at_noon()
-
-
-class TestTimezones:
-    def test_alternate_timezone_west(self):
-        target_tz = pytz.timezone('US/Pacific')
-        target = schedule.now().astimezone(target_tz)
-        cmd = schedule.DelayedCommand.at_time(target, target=None)
-        assert cmd.due()
-
-    def test_alternate_timezone_east(self):
-        target_tz = pytz.timezone('Europe/Amsterdam')
-        target = schedule.now().astimezone(target_tz)
-        cmd = schedule.DelayedCommand.at_time(target, target=None)
-        assert cmd.due()
-
-    def test_daylight_savings(self):
-        """
-        A command at 9am should always be 9am regardless of
-        a DST boundary.
-        """
-        with freezegun.freeze_time('2018-03-10 08:00:00'):
-            target_tz = pytz.timezone('US/Eastern')
-            target_time = datetime.time(9, tzinfo=target_tz)
-            cmd = schedule.PeriodicCommandFixedDelay.daily_at(
-                target_time, target=lambda: None
-            )
-
-        def naive(dt):
-            return dt.replace(tzinfo=None)
-
-        assert naive(cmd) == datetime.datetime(2018, 3, 10, 9, 0, 0)
-        next_ = cmd.next()
-        assert naive(next_) == datetime.datetime(2018, 3, 11, 9, 0, 0)
-        assert next_ - cmd == datetime.timedelta(hours=23)
-
-
-class TestScheduler:
-    def test_invoke_scheduler(self):
-        sched = schedule.InvokeScheduler()
-        target = mock.MagicMock()
-        cmd = schedule.DelayedCommand.after(0, target)
-        sched.add(cmd)
-        sched.run_pending()
-        target.assert_called_once()
-        assert not sched.queue
-
-    def test_callback_scheduler(self):
-        callback = mock.MagicMock()
-        sched = schedule.CallbackScheduler(callback)
-        target = mock.MagicMock()
-        cmd = schedule.DelayedCommand.after(0, target)
-        sched.add(cmd)
-        sched.run_pending()
-        callback.assert_called_once_with(target)
-
-    def test_periodic_command(self):
-        sched = schedule.InvokeScheduler()
-        target = mock.MagicMock()
-
-        before = datetime.datetime.utcnow()
-
-        cmd = schedule.PeriodicCommand.after(10, target)
-        sched.add(cmd)
-        sched.run_pending()
-        target.assert_not_called()
-
-        with freezegun.freeze_time(before + datetime.timedelta(seconds=15)):
-            sched.run_pending()
-        assert sched.queue
-        target.assert_called_once()
-
-        with freezegun.freeze_time(before + datetime.timedelta(seconds=25)):
-            sched.run_pending()
-        assert target.call_count == 2
diff --git a/lib/tempora/tests/test_timing.py b/lib/tempora/tests/test_timing.py
deleted file mode 100644
index 43bf7efc..00000000
--- a/lib/tempora/tests/test_timing.py
+++ /dev/null
@@ -1,50 +0,0 @@
-import datetime
-import time
-import contextlib
-import os
-from unittest import mock
-
-import pytest
-from tempora import timing
-
-
-def test_IntervalGovernor():
-    """
-    IntervalGovernor should prevent a function from being called more than
-    once per interval.
-    """
-    func_under_test = mock.MagicMock()
-    # to look like a function, it needs a __name__ attribute
-    func_under_test.__name__ = 'func_under_test'
-    interval = datetime.timedelta(seconds=1)
-    governed = timing.IntervalGovernor(interval)(func_under_test)
-    governed('a')
-    governed('b')
-    governed(3, 'sir')
-    func_under_test.assert_called_once_with('a')
-
-
-@pytest.fixture
-def alt_tz(monkeypatch):
-    hasattr(time, 'tzset') or pytest.skip("tzset not available")
-
-    @contextlib.contextmanager
-    def change():
-        val = 'AEST-10AEDT-11,M10.5.0,M3.5.0'
-        with monkeypatch.context() as ctx:
-            ctx.setitem(os.environ, 'TZ', val)
-            time.tzset()
-            yield
-        time.tzset()
-
-    return change()
-
-
-def test_Stopwatch_timezone_change(alt_tz):
-    """
-    The stopwatch should provide a consistent duration even
-    if the timezone changes.
-    """
-    watch = timing.Stopwatch()
-    with alt_tz:
-        assert abs(watch.split().total_seconds()) < 0.1
diff --git a/requirements.txt b/requirements.txt
index b88c9efe..73c9308b 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -42,7 +42,7 @@ rumps==0.4.0; platform_system == "Darwin"
 simplejson==3.18.0
 six==1.16.0
 soupsieve==2.3.2.post1
-tempora==5.1.0
+tempora==5.2.1
 tokenize-rt==5.0.0
 tzdata==2022.7
 tzlocal==4.2

From 1466a391d1b4428ae244689933edfcbdb24dadd5 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 2 Mar 2023 20:55:01 -0800
Subject: [PATCH 346/743] Bump bleach from 5.0.1 to 6.0.0 (#1979)

* Bump bleach from 5.0.1 to 6.0.0

Bumps [bleach](https://github.com/mozilla/bleach) from 5.0.1 to 6.0.0.
- [Release notes](https://github.com/mozilla/bleach/releases)
- [Changelog](https://github.com/mozilla/bleach/blob/main/CHANGES)
- [Commits](https://github.com/mozilla/bleach/compare/v5.0.1...v6.0.0)

---
updated-dependencies:
- dependency-name: bleach
  dependency-type: direct:production
  update-type: version-update:semver-major
...

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

* Update bleach==6.0.0

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/bleach/__init__.py      |   6 +-
 lib/bleach/html5lib_shim.py | 245 ++++++++++++++++++------------------
 lib/bleach/linkifier.py     |  82 ++++++++++--
 lib/bleach/sanitizer.py     | 154 +++++++++++++----------
 requirements.txt            |   2 +-
 5 files changed, 291 insertions(+), 198 deletions(-)

diff --git a/lib/bleach/__init__.py b/lib/bleach/__init__.py
index bbcc2e03..4e87eb80 100644
--- a/lib/bleach/__init__.py
+++ b/lib/bleach/__init__.py
@@ -11,9 +11,9 @@ from bleach.sanitizer import (
 
 
 # yyyymmdd
-__releasedate__ = "20220627"
+__releasedate__ = "20230123"
 # x.y.z or x.y.z.dev0 -- semver
-__version__ = "5.0.1"
+__version__ = "6.0.0"
 
 
 __all__ = ["clean", "linkify"]
@@ -52,7 +52,7 @@ def clean(
 
     :arg str text: the text to clean
 
-    :arg list tags: allowed list of tags; defaults to
+    :arg set tags: set of allowed tags; defaults to
         ``bleach.sanitizer.ALLOWED_TAGS``
 
     :arg dict attributes: allowed attributes; can be a callable, list or dict;
diff --git a/lib/bleach/html5lib_shim.py b/lib/bleach/html5lib_shim.py
index d121953b..aa5189b1 100644
--- a/lib/bleach/html5lib_shim.py
+++ b/lib/bleach/html5lib_shim.py
@@ -38,6 +38,9 @@ from bleach._vendor.html5lib.filters.sanitizer import (
     allowed_protocols,
     allowed_css_properties,
     allowed_svg_properties,
+    attr_val_is_uri,
+    svg_attr_val_allows_ref,
+    svg_allow_local_href,
 )  # noqa: E402 module level import not at top of file
 from bleach._vendor.html5lib.filters.sanitizer import (
     Filter as SanitizerFilter,
@@ -78,127 +81,129 @@ TAG_TOKEN_TYPE_PARSEERROR = constants.tokenTypes["ParseError"]
 
 #: List of valid HTML tags, from WHATWG HTML Living Standard as of 2018-10-17
 #: https://html.spec.whatwg.org/multipage/indices.html#elements-3
-HTML_TAGS = [
-    "a",
-    "abbr",
-    "address",
-    "area",
-    "article",
-    "aside",
-    "audio",
-    "b",
-    "base",
-    "bdi",
-    "bdo",
-    "blockquote",
-    "body",
-    "br",
-    "button",
-    "canvas",
-    "caption",
-    "cite",
-    "code",
-    "col",
-    "colgroup",
-    "data",
-    "datalist",
-    "dd",
-    "del",
-    "details",
-    "dfn",
-    "dialog",
-    "div",
-    "dl",
-    "dt",
-    "em",
-    "embed",
-    "fieldset",
-    "figcaption",
-    "figure",
-    "footer",
-    "form",
-    "h1",
-    "h2",
-    "h3",
-    "h4",
-    "h5",
-    "h6",
-    "head",
-    "header",
-    "hgroup",
-    "hr",
-    "html",
-    "i",
-    "iframe",
-    "img",
-    "input",
-    "ins",
-    "kbd",
-    "keygen",
-    "label",
-    "legend",
-    "li",
-    "link",
-    "map",
-    "mark",
-    "menu",
-    "meta",
-    "meter",
-    "nav",
-    "noscript",
-    "object",
-    "ol",
-    "optgroup",
-    "option",
-    "output",
-    "p",
-    "param",
-    "picture",
-    "pre",
-    "progress",
-    "q",
-    "rp",
-    "rt",
-    "ruby",
-    "s",
-    "samp",
-    "script",
-    "section",
-    "select",
-    "slot",
-    "small",
-    "source",
-    "span",
-    "strong",
-    "style",
-    "sub",
-    "summary",
-    "sup",
-    "table",
-    "tbody",
-    "td",
-    "template",
-    "textarea",
-    "tfoot",
-    "th",
-    "thead",
-    "time",
-    "title",
-    "tr",
-    "track",
-    "u",
-    "ul",
-    "var",
-    "video",
-    "wbr",
-]
+HTML_TAGS = frozenset(
+    (
+        "a",
+        "abbr",
+        "address",
+        "area",
+        "article",
+        "aside",
+        "audio",
+        "b",
+        "base",
+        "bdi",
+        "bdo",
+        "blockquote",
+        "body",
+        "br",
+        "button",
+        "canvas",
+        "caption",
+        "cite",
+        "code",
+        "col",
+        "colgroup",
+        "data",
+        "datalist",
+        "dd",
+        "del",
+        "details",
+        "dfn",
+        "dialog",
+        "div",
+        "dl",
+        "dt",
+        "em",
+        "embed",
+        "fieldset",
+        "figcaption",
+        "figure",
+        "footer",
+        "form",
+        "h1",
+        "h2",
+        "h3",
+        "h4",
+        "h5",
+        "h6",
+        "head",
+        "header",
+        "hgroup",
+        "hr",
+        "html",
+        "i",
+        "iframe",
+        "img",
+        "input",
+        "ins",
+        "kbd",
+        "keygen",
+        "label",
+        "legend",
+        "li",
+        "link",
+        "map",
+        "mark",
+        "menu",
+        "meta",
+        "meter",
+        "nav",
+        "noscript",
+        "object",
+        "ol",
+        "optgroup",
+        "option",
+        "output",
+        "p",
+        "param",
+        "picture",
+        "pre",
+        "progress",
+        "q",
+        "rp",
+        "rt",
+        "ruby",
+        "s",
+        "samp",
+        "script",
+        "section",
+        "select",
+        "slot",
+        "small",
+        "source",
+        "span",
+        "strong",
+        "style",
+        "sub",
+        "summary",
+        "sup",
+        "table",
+        "tbody",
+        "td",
+        "template",
+        "textarea",
+        "tfoot",
+        "th",
+        "thead",
+        "time",
+        "title",
+        "tr",
+        "track",
+        "u",
+        "ul",
+        "var",
+        "video",
+        "wbr",
+    )
+)
 
 
 #: List of block level HTML tags, as per https://github.com/mozilla/bleach/issues/369
 #: from mozilla on 2019.07.11
 #: https://developer.mozilla.org/en-US/docs/Web/HTML/Block-level_elements#Elements
 HTML_TAGS_BLOCK_LEVEL = frozenset(
-    [
+    (
         "address",
         "article",
         "aside",
@@ -232,7 +237,7 @@ HTML_TAGS_BLOCK_LEVEL = frozenset(
         "section",
         "table",
         "ul",
-    ]
+    )
 )
 
 
@@ -473,7 +478,7 @@ class BleachHTMLParser(HTMLParser):
 
     def __init__(self, tags, strip, consume_entities, **kwargs):
         """
-        :arg tags: list of allowed tags--everything else is either stripped or
+        :arg tags: set of allowed tags--everything else is either stripped or
             escaped; if None, then this doesn't look at tags at all
         :arg strip: whether to strip disallowed tags (True) or escape them (False);
             if tags=None, then this doesn't have any effect
@@ -481,7 +486,9 @@ class BleachHTMLParser(HTMLParser):
             leave them as is when tokenizing (BleachHTMLTokenizer-added behavior)
 
         """
-        self.tags = [tag.lower() for tag in tags] if tags is not None else None
+        self.tags = (
+            frozenset((tag.lower() for tag in tags)) if tags is not None else None
+        )
         self.strip = strip
         self.consume_entities = consume_entities
         super().__init__(**kwargs)
@@ -691,7 +698,7 @@ class BleachHTMLSerializer(HTMLSerializer):
                 # Only leave entities in that are not ambiguous. If they're
                 # ambiguous, then we escape the ampersand.
                 if entity is not None and convert_entity(entity) is not None:
-                    yield "&" + entity + ";"
+                    yield f"&{entity};"
 
                     # Length of the entity plus 2--one for & at the beginning
                     # and one for ; at the end
diff --git a/lib/bleach/linkifier.py b/lib/bleach/linkifier.py
index b3b83e62..679d7ead 100644
--- a/lib/bleach/linkifier.py
+++ b/lib/bleach/linkifier.py
@@ -120,9 +120,10 @@ class Linker:
         :arg list callbacks: list of callbacks to run when adjusting tag attributes;
             defaults to ``bleach.linkifier.DEFAULT_CALLBACKS``
 
-        :arg list skip_tags: list of tags that you don't want to linkify the
-            contents of; for example, you could set this to ``['pre']`` to skip
-            linkifying contents of ``pre`` tags
+        :arg set skip_tags: set of tags that you don't want to linkify the
+            contents of; for example, you could set this to ``{'pre'}`` to skip
+            linkifying contents of ``pre`` tags; ``None`` means you don't
+            want linkify to skip any tags
 
         :arg bool parse_email: whether or not to linkify email addresses
 
@@ -130,7 +131,7 @@ class Linker:
 
         :arg email_re: email matching regex
 
-        :arg list recognized_tags: the list of tags that linkify knows about;
+        :arg set recognized_tags: the set of tags that linkify knows about;
             everything else gets escaped
 
         :returns: linkified text as unicode
@@ -145,15 +146,18 @@ class Linker:
         # Create a parser/tokenizer that allows all HTML tags and escapes
         # anything not in that list.
         self.parser = html5lib_shim.BleachHTMLParser(
-            tags=recognized_tags,
+            tags=frozenset(recognized_tags),
             strip=False,
-            consume_entities=True,
+            consume_entities=False,
             namespaceHTMLElements=False,
         )
         self.walker = html5lib_shim.getTreeWalker("etree")
         self.serializer = html5lib_shim.BleachHTMLSerializer(
             quote_attr_values="always",
             omit_optional_tags=False,
+            # We want to leave entities as they are without escaping or
+            # resolving or expanding
+            resolve_entities=False,
             # linkify does not sanitize
             sanitize=False,
             # linkify preserves attr order
@@ -218,8 +222,8 @@ class LinkifyFilter(html5lib_shim.Filter):
         :arg list callbacks: list of callbacks to run when adjusting tag attributes;
             defaults to ``bleach.linkifier.DEFAULT_CALLBACKS``
 
-        :arg list skip_tags: list of tags that you don't want to linkify the
-            contents of; for example, you could set this to ``['pre']`` to skip
+        :arg set skip_tags: set of tags that you don't want to linkify the
+            contents of; for example, you could set this to ``{'pre'}`` to skip
             linkifying contents of ``pre`` tags
 
         :arg bool parse_email: whether or not to linkify email addresses
@@ -232,7 +236,7 @@ class LinkifyFilter(html5lib_shim.Filter):
         super().__init__(source)
 
         self.callbacks = callbacks or []
-        self.skip_tags = skip_tags or []
+        self.skip_tags = skip_tags or {}
         self.parse_email = parse_email
 
         self.url_re = url_re
@@ -510,6 +514,62 @@ class LinkifyFilter(html5lib_shim.Filter):
                 yield {"type": "Characters", "data": str(new_text)}
                 yield token_buffer[-1]
 
+    def extract_entities(self, token):
+        """Handles Characters tokens with entities
+
+        Our overridden tokenizer doesn't do anything with entities. However,
+        that means that the serializer will convert all ``&`` in Characters
+        tokens to ``&amp;``.
+
+        Since we don't want that, we extract entities here and convert them to
+        Entity tokens so the serializer will let them be.
+
+        :arg token: the Characters token to work on
+
+        :returns: generator of tokens
+
+        """
+        data = token.get("data", "")
+
+        # If there isn't a & in the data, we can return now
+        if "&" not in data:
+            yield token
+            return
+
+        new_tokens = []
+
+        # For each possible entity that starts with a "&", we try to extract an
+        # actual entity and re-tokenize accordingly
+        for part in html5lib_shim.next_possible_entity(data):
+            if not part:
+                continue
+
+            if part.startswith("&"):
+                entity = html5lib_shim.match_entity(part)
+                if entity is not None:
+                    if entity == "amp":
+                        # LinkifyFilter can't match urls across token boundaries
+                        # which is problematic with &amp; since that shows up in
+                        # querystrings all the time. This special-cases &amp;
+                        # and converts it to a & and sticks it in as a
+                        # Characters token. It'll get merged with surrounding
+                        # tokens in the BleachSanitizerfilter.__iter__ and
+                        # escaped in the serializer.
+                        new_tokens.append({"type": "Characters", "data": "&"})
+                    else:
+                        new_tokens.append({"type": "Entity", "name": entity})
+
+                    # Length of the entity plus 2--one for & at the beginning
+                    # and one for ; at the end
+                    remainder = part[len(entity) + 2 :]
+                    if remainder:
+                        new_tokens.append({"type": "Characters", "data": remainder})
+                    continue
+
+            new_tokens.append({"type": "Characters", "data": part})
+
+        yield from new_tokens
+
     def __iter__(self):
         in_a = False
         in_skip_tag = None
@@ -564,8 +624,8 @@ class LinkifyFilter(html5lib_shim.Filter):
 
                 new_stream = self.handle_links(new_stream)
 
-                for token in new_stream:
-                    yield token
+                for new_token in new_stream:
+                    yield from self.extract_entities(new_token)
 
                 # We've already yielded this token, so continue
                 continue
diff --git a/lib/bleach/sanitizer.py b/lib/bleach/sanitizer.py
index 6527ac03..8662a879 100644
--- a/lib/bleach/sanitizer.py
+++ b/lib/bleach/sanitizer.py
@@ -8,21 +8,23 @@ from bleach import html5lib_shim
 from bleach import parse_shim
 
 
-#: List of allowed tags
-ALLOWED_TAGS = [
-    "a",
-    "abbr",
-    "acronym",
-    "b",
-    "blockquote",
-    "code",
-    "em",
-    "i",
-    "li",
-    "ol",
-    "strong",
-    "ul",
-]
+#: Set of allowed tags
+ALLOWED_TAGS = frozenset(
+    (
+        "a",
+        "abbr",
+        "acronym",
+        "b",
+        "blockquote",
+        "code",
+        "em",
+        "i",
+        "li",
+        "ol",
+        "strong",
+        "ul",
+    )
+)
 
 
 #: Map of allowed attributes by tag
@@ -33,7 +35,7 @@ ALLOWED_ATTRIBUTES = {
 }
 
 #: List of allowed protocols
-ALLOWED_PROTOCOLS = ["http", "https", "mailto"]
+ALLOWED_PROTOCOLS = frozenset(("http", "https", "mailto"))
 
 #: Invisible characters--0 to and including 31 except 9 (tab), 10 (lf), and 13 (cr)
 INVISIBLE_CHARACTERS = "".join(
@@ -48,6 +50,10 @@ INVISIBLE_CHARACTERS_RE = re.compile("[" + INVISIBLE_CHARACTERS + "]", re.UNICOD
 INVISIBLE_REPLACEMENT_CHAR = "?"
 
 
+class NoCssSanitizerWarning(UserWarning):
+    pass
+
+
 class Cleaner:
     """Cleaner for cleaning HTML fragments of malicious content
 
@@ -89,7 +95,7 @@ class Cleaner:
     ):
         """Initializes a Cleaner
 
-        :arg list tags: allowed list of tags; defaults to
+        :arg set tags: set of allowed tags; defaults to
             ``bleach.sanitizer.ALLOWED_TAGS``
 
         :arg dict attributes: allowed attributes; can be a callable, list or dict;
@@ -143,6 +149,25 @@ class Cleaner:
             alphabetical_attributes=False,
         )
 
+        if css_sanitizer is None:
+            # FIXME(willkg): this doesn't handle when attributes or an
+            # attributes value is a callable
+            attributes_values = []
+            if isinstance(attributes, list):
+                attributes_values = attributes
+
+            elif isinstance(attributes, dict):
+                attributes_values = []
+                for values in attributes.values():
+                    if isinstance(values, (list, tuple)):
+                        attributes_values.extend(values)
+
+            if "style" in attributes_values:
+                warnings.warn(
+                    "'style' attribute specified, but css_sanitizer not set.",
+                    category=NoCssSanitizerWarning,
+                )
+
     def clean(self, text):
         """Cleans text and returns sanitized result as unicode
 
@@ -155,9 +180,8 @@ class Cleaner:
         """
         if not isinstance(text, str):
             message = (
-                "argument cannot be of '{name}' type, must be of text type".format(
-                    name=text.__class__.__name__
-                )
+                f"argument cannot be of {text.__class__.__name__!r} type, "
+                + "must be of text type"
             )
             raise TypeError(message)
 
@@ -167,13 +191,11 @@ class Cleaner:
         dom = self.parser.parseFragment(text)
         filtered = BleachSanitizerFilter(
             source=self.walker(dom),
-            # Bleach-sanitizer-specific things
+            allowed_tags=self.tags,
             attributes=self.attributes,
-            strip_disallowed_elements=self.strip,
+            strip_disallowed_tags=self.strip,
             strip_html_comments=self.strip_comments,
             css_sanitizer=self.css_sanitizer,
-            # html5lib-sanitizer things
-            allowed_elements=self.tags,
             allowed_protocols=self.protocols,
         )
 
@@ -237,19 +259,21 @@ class BleachSanitizerFilter(html5lib_shim.SanitizerFilter):
     def __init__(
         self,
         source,
-        allowed_elements=ALLOWED_TAGS,
+        allowed_tags=ALLOWED_TAGS,
         attributes=ALLOWED_ATTRIBUTES,
         allowed_protocols=ALLOWED_PROTOCOLS,
-        strip_disallowed_elements=False,
+        attr_val_is_uri=html5lib_shim.attr_val_is_uri,
+        svg_attr_val_allows_ref=html5lib_shim.svg_attr_val_allows_ref,
+        svg_allow_local_href=html5lib_shim.svg_allow_local_href,
+        strip_disallowed_tags=False,
         strip_html_comments=True,
         css_sanitizer=None,
-        **kwargs,
     ):
         """Creates a BleachSanitizerFilter instance
 
         :arg source: html5lib TreeWalker stream as an html5lib TreeWalker
 
-        :arg list allowed_elements: allowed list of tags; defaults to
+        :arg set allowed_tags: set of allowed tags; defaults to
             ``bleach.sanitizer.ALLOWED_TAGS``
 
         :arg dict attributes: allowed attributes; can be a callable, list or dict;
@@ -258,8 +282,16 @@ class BleachSanitizerFilter(html5lib_shim.SanitizerFilter):
         :arg list allowed_protocols: allowed list of protocols for links; defaults
             to ``bleach.sanitizer.ALLOWED_PROTOCOLS``
 
-        :arg bool strip_disallowed_elements: whether or not to strip disallowed
-            elements
+        :arg attr_val_is_uri: set of attributes that have URI values
+
+        :arg svg_attr_val_allows_ref: set of SVG attributes that can have
+            references
+
+        :arg svg_allow_local_href: set of SVG elements that can have local
+            hrefs
+
+        :arg bool strip_disallowed_tags: whether or not to strip disallowed
+            tags
 
         :arg bool strip_html_comments: whether or not to strip HTML comments
 
@@ -267,24 +299,24 @@ class BleachSanitizerFilter(html5lib_shim.SanitizerFilter):
             sanitizing style attribute values and style text; defaults to None
 
         """
-        self.attr_filter = attribute_filter_factory(attributes)
-        self.strip_disallowed_elements = strip_disallowed_elements
-        self.strip_html_comments = strip_html_comments
-        self.css_sanitizer = css_sanitizer
+        # NOTE(willkg): This is the superclass of
+        # html5lib.filters.sanitizer.Filter. We call this directly skipping the
+        # __init__ for html5lib.filters.sanitizer.Filter because that does
+        # things we don't need to do and kicks up the deprecation warning for
+        # using Sanitizer.
+        html5lib_shim.Filter.__init__(self, source)
 
-        # filter out html5lib deprecation warnings to use bleach from BleachSanitizerFilter init
-        warnings.filterwarnings(
-            "ignore",
-            message="html5lib's sanitizer is deprecated",
-            category=DeprecationWarning,
-            module="bleach._vendor.html5lib",
-        )
-        return super().__init__(
-            source,
-            allowed_elements=allowed_elements,
-            allowed_protocols=allowed_protocols,
-            **kwargs,
-        )
+        self.allowed_tags = frozenset(allowed_tags)
+        self.allowed_protocols = frozenset(allowed_protocols)
+
+        self.attr_filter = attribute_filter_factory(attributes)
+        self.strip_disallowed_tags = strip_disallowed_tags
+        self.strip_html_comments = strip_html_comments
+
+        self.attr_val_is_uri = attr_val_is_uri
+        self.svg_attr_val_allows_ref = svg_attr_val_allows_ref
+        self.css_sanitizer = css_sanitizer
+        self.svg_allow_local_href = svg_allow_local_href
 
     def sanitize_stream(self, token_iterator):
         for token in token_iterator:
@@ -354,10 +386,10 @@ class BleachSanitizerFilter(html5lib_shim.SanitizerFilter):
         """
         token_type = token["type"]
         if token_type in ["StartTag", "EndTag", "EmptyTag"]:
-            if token["name"] in self.allowed_elements:
+            if token["name"] in self.allowed_tags:
                 return self.allow_token(token)
 
-            elif self.strip_disallowed_elements:
+            elif self.strip_disallowed_tags:
                 return None
 
             else:
@@ -570,7 +602,7 @@ class BleachSanitizerFilter(html5lib_shim.SanitizerFilter):
     def disallowed_token(self, token):
         token_type = token["type"]
         if token_type == "EndTag":
-            token["data"] = "</%s>" % token["name"]
+            token["data"] = f"</{token['name']}>"
 
         elif token["data"]:
             assert token_type in ("StartTag", "EmptyTag")
@@ -586,25 +618,19 @@ class BleachSanitizerFilter(html5lib_shim.SanitizerFilter):
                 if ns is None or ns not in html5lib_shim.prefixes:
                     namespaced_name = name
                 else:
-                    namespaced_name = "{}:{}".format(html5lib_shim.prefixes[ns], name)
+                    namespaced_name = f"{html5lib_shim.prefixes[ns]}:{name}"
 
-                attrs.append(
-                    ' %s="%s"'
-                    % (
-                        namespaced_name,
-                        # NOTE(willkg): HTMLSerializer escapes attribute values
-                        # already, so if we do it here (like HTMLSerializer does),
-                        # then we end up double-escaping.
-                        v,
-                    )
-                )
-            token["data"] = "<{}{}>".format(token["name"], "".join(attrs))
+                # NOTE(willkg): HTMLSerializer escapes attribute values
+                # already, so if we do it here (like HTMLSerializer does),
+                # then we end up double-escaping.
+                attrs.append(f' {namespaced_name}="{v}"')
+            token["data"] = f"<{token['name']}{''.join(attrs)}>"
 
         else:
-            token["data"] = "<%s>" % token["name"]
+            token["data"] = f"<{token['name']}>"
 
         if token.get("selfClosing"):
-            token["data"] = token["data"][:-1] + "/>"
+            token["data"] = f"{token['data'][:-1]}/>"
 
         token["type"] = "Characters"
 
diff --git a/requirements.txt b/requirements.txt
index 73c9308b..799b09b2 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -5,7 +5,7 @@ backports.csv==1.0.7
 backports.functools-lru-cache==1.6.4
 backports.zoneinfo==0.2.1;python_version<"3.9"
 beautifulsoup4==4.11.1
-bleach==5.0.1
+bleach==6.0.0
 certifi==2022.12.7
 cheroot==9.0.0
 cherrypy==18.8.0

From ded93ef2f559e48df59f841851dc2da30e2438b3 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 2 Mar 2023 20:55:46 -0800
Subject: [PATCH 347/743] Bump apscheduler from 3.9.1.post1 to 3.10.0 (#1986)

* Bump apscheduler from 3.9.1.post1 to 3.10.0

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

---
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.10.0

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/apscheduler/executors/asyncio.py    | 13 ++---
 lib/apscheduler/jobstores/sqlalchemy.py | 65 ++++++++++++++-----------
 lib/apscheduler/schedulers/asyncio.py   | 10 +---
 lib/apscheduler/util.py                 | 10 +---
 package/requirements-package.txt        |  2 +-
 requirements.txt                        |  2 +-
 6 files changed, 43 insertions(+), 59 deletions(-)

diff --git a/lib/apscheduler/executors/asyncio.py b/lib/apscheduler/executors/asyncio.py
index 06fc7f96..7d45d6c1 100644
--- a/lib/apscheduler/executors/asyncio.py
+++ b/lib/apscheduler/executors/asyncio.py
@@ -3,13 +3,9 @@ from __future__ import absolute_import
 import sys
 
 from apscheduler.executors.base import BaseExecutor, run_job
+from apscheduler.executors.base_py3 import run_coroutine_job
 from apscheduler.util import iscoroutinefunction_partial
 
-try:
-    from apscheduler.executors.base_py3 import run_coroutine_job
-except ImportError:
-    run_coroutine_job = None
-
 
 class AsyncIOExecutor(BaseExecutor):
     """
@@ -46,11 +42,8 @@ class AsyncIOExecutor(BaseExecutor):
                 self._run_job_success(job.id, events)
 
         if iscoroutinefunction_partial(job.func):
-            if run_coroutine_job is not None:
-                coro = run_coroutine_job(job, job._jobstore_alias, run_times, self._logger.name)
-                f = self._eventloop.create_task(coro)
-            else:
-                raise Exception('Executing coroutine based jobs is not supported with Trollius')
+            coro = run_coroutine_job(job, job._jobstore_alias, run_times, self._logger.name)
+            f = self._eventloop.create_task(coro)
         else:
             f = self._eventloop.run_in_executor(None, run_job, job, job._jobstore_alias, run_times,
                                                 self._logger.name)
diff --git a/lib/apscheduler/jobstores/sqlalchemy.py b/lib/apscheduler/jobstores/sqlalchemy.py
index dcfd3e56..716549bc 100644
--- a/lib/apscheduler/jobstores/sqlalchemy.py
+++ b/lib/apscheduler/jobstores/sqlalchemy.py
@@ -57,7 +57,7 @@ class SQLAlchemyJobStore(BaseJobStore):
         # 25 = precision that translates to an 8-byte float
         self.jobs_t = Table(
             tablename, metadata,
-            Column('id', Unicode(191, _warn_on_bytestring=False), primary_key=True),
+            Column('id', Unicode(191), primary_key=True),
             Column('next_run_time', Float(25), index=True),
             Column('job_state', LargeBinary, nullable=False),
             schema=tableschema
@@ -68,20 +68,22 @@ class SQLAlchemyJobStore(BaseJobStore):
         self.jobs_t.create(self.engine, True)
 
     def lookup_job(self, job_id):
-        selectable = select([self.jobs_t.c.job_state]).where(self.jobs_t.c.id == job_id)
-        job_state = self.engine.execute(selectable).scalar()
-        return self._reconstitute_job(job_state) if job_state else None
+        selectable = select(self.jobs_t.c.job_state).where(self.jobs_t.c.id == job_id)
+        with self.engine.begin() as connection:
+            job_state = connection.execute(selectable).scalar()
+            return self._reconstitute_job(job_state) if job_state else None
 
     def get_due_jobs(self, now):
         timestamp = datetime_to_utc_timestamp(now)
         return self._get_jobs(self.jobs_t.c.next_run_time <= timestamp)
 
     def get_next_run_time(self):
-        selectable = select([self.jobs_t.c.next_run_time]).\
+        selectable = select(self.jobs_t.c.next_run_time).\
             where(self.jobs_t.c.next_run_time != null()).\
             order_by(self.jobs_t.c.next_run_time).limit(1)
-        next_run_time = self.engine.execute(selectable).scalar()
-        return utc_timestamp_to_datetime(next_run_time)
+        with self.engine.begin() as connection:
+            next_run_time = connection.execute(selectable).scalar()
+            return utc_timestamp_to_datetime(next_run_time)
 
     def get_all_jobs(self):
         jobs = self._get_jobs()
@@ -94,29 +96,33 @@ class SQLAlchemyJobStore(BaseJobStore):
             'next_run_time': datetime_to_utc_timestamp(job.next_run_time),
             'job_state': pickle.dumps(job.__getstate__(), self.pickle_protocol)
         })
-        try:
-            self.engine.execute(insert)
-        except IntegrityError:
-            raise ConflictingIdError(job.id)
+        with self.engine.begin() as connection:
+            try:
+                connection.execute(insert)
+            except IntegrityError:
+                raise ConflictingIdError(job.id)
 
     def update_job(self, job):
         update = self.jobs_t.update().values(**{
             'next_run_time': datetime_to_utc_timestamp(job.next_run_time),
             'job_state': pickle.dumps(job.__getstate__(), self.pickle_protocol)
         }).where(self.jobs_t.c.id == job.id)
-        result = self.engine.execute(update)
-        if result.rowcount == 0:
-            raise JobLookupError(job.id)
+        with self.engine.begin() as connection:
+            result = connection.execute(update)
+            if result.rowcount == 0:
+                raise JobLookupError(job.id)
 
     def remove_job(self, job_id):
         delete = self.jobs_t.delete().where(self.jobs_t.c.id == job_id)
-        result = self.engine.execute(delete)
-        if result.rowcount == 0:
-            raise JobLookupError(job_id)
+        with self.engine.begin() as connection:
+            result = connection.execute(delete)
+            if result.rowcount == 0:
+                raise JobLookupError(job_id)
 
     def remove_all_jobs(self):
         delete = self.jobs_t.delete()
-        self.engine.execute(delete)
+        with self.engine.begin() as connection:
+            connection.execute(delete)
 
     def shutdown(self):
         self.engine.dispose()
@@ -132,21 +138,22 @@ class SQLAlchemyJobStore(BaseJobStore):
 
     def _get_jobs(self, *conditions):
         jobs = []
-        selectable = select([self.jobs_t.c.id, self.jobs_t.c.job_state]).\
+        selectable = select(self.jobs_t.c.id, self.jobs_t.c.job_state).\
             order_by(self.jobs_t.c.next_run_time)
         selectable = selectable.where(and_(*conditions)) if conditions else selectable
         failed_job_ids = set()
-        for row in self.engine.execute(selectable):
-            try:
-                jobs.append(self._reconstitute_job(row.job_state))
-            except BaseException:
-                self._logger.exception('Unable to restore job "%s" -- removing it', row.id)
-                failed_job_ids.add(row.id)
+        with self.engine.begin() as connection:
+            for row in connection.execute(selectable):
+                try:
+                    jobs.append(self._reconstitute_job(row.job_state))
+                except BaseException:
+                    self._logger.exception('Unable to restore job "%s" -- removing it', row.id)
+                    failed_job_ids.add(row.id)
 
-        # Remove all the jobs we failed to restore
-        if failed_job_ids:
-            delete = self.jobs_t.delete().where(self.jobs_t.c.id.in_(failed_job_ids))
-            self.engine.execute(delete)
+            # Remove all the jobs we failed to restore
+            if failed_job_ids:
+                delete = self.jobs_t.delete().where(self.jobs_t.c.id.in_(failed_job_ids))
+                connection.execute(delete)
 
         return jobs
 
diff --git a/lib/apscheduler/schedulers/asyncio.py b/lib/apscheduler/schedulers/asyncio.py
index 70ebedeb..8bcdfdaf 100644
--- a/lib/apscheduler/schedulers/asyncio.py
+++ b/lib/apscheduler/schedulers/asyncio.py
@@ -1,18 +1,10 @@
 from __future__ import absolute_import
+import asyncio
 from functools import wraps, partial
 
 from apscheduler.schedulers.base import BaseScheduler
 from apscheduler.util import maybe_ref
 
-try:
-    import asyncio
-except ImportError:  # pragma: nocover
-    try:
-        import trollius as asyncio
-    except ImportError:
-        raise ImportError(
-            'AsyncIOScheduler requires either Python 3.4 or the asyncio package installed')
-
 
 def run_in_event_loop(func):
     @wraps(func)
diff --git a/lib/apscheduler/util.py b/lib/apscheduler/util.py
index d929a482..64b27d7b 100644
--- a/lib/apscheduler/util.py
+++ b/lib/apscheduler/util.py
@@ -2,6 +2,7 @@
 
 from __future__ import division
 
+from asyncio import iscoroutinefunction
 from datetime import date, datetime, time, timedelta, tzinfo
 from calendar import timegm
 from functools import partial
@@ -22,15 +23,6 @@ try:
 except ImportError:
     TIMEOUT_MAX = 4294967  # Maximum value accepted by Event.wait() on Windows
 
-try:
-    from asyncio import iscoroutinefunction
-except ImportError:
-    try:
-        from trollius import iscoroutinefunction
-    except ImportError:
-        def iscoroutinefunction(func):
-            return False
-
 __all__ = ('asint', 'asbool', 'astimezone', 'convert_to_datetime', 'datetime_to_utc_timestamp',
            'utc_timestamp_to_datetime', 'timedelta_seconds', 'datetime_ceil', 'get_callable_name',
            'obj_to_ref', 'ref_to_obj', 'maybe_ref', 'repr_escape', 'check_callable_args',
diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index bbd322c3..27f69c35 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -1,4 +1,4 @@
-apscheduler==3.9.1.post1
+apscheduler==3.10.0
 importlib-metadata==6.0.0
 importlib-resources==5.12.0
 pyinstaller==5.7.0
diff --git a/requirements.txt b/requirements.txt
index 799b09b2..050b9add 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,5 +1,5 @@
 appdirs==1.4.4
-apscheduler==3.9.1.post1
+apscheduler==3.10.0
 arrow==1.2.3
 backports.csv==1.0.7
 backports.functools-lru-cache==1.6.4

From 8e42757b2da0e8659d725f9299ffec7c671b46a7 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 2 Mar 2023 20:56:24 -0800
Subject: [PATCH 348/743] Bump beautifulsoup4 from 4.11.1 to 4.11.2 (#1987)

* Bump beautifulsoup4 from 4.11.1 to 4.11.2

Bumps [beautifulsoup4](https://www.crummy.com/software/BeautifulSoup/bs4/) from 4.11.1 to 4.11.2.

---
updated-dependencies:
- dependency-name: beautifulsoup4
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

* Update beautifulsoup4==4.11.2

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/bs4/__init__.py                    |  15 +-
 lib/bs4/builder/__init__.py            |   2 +-
 lib/bs4/builder/_html5lib.py           |  14 +-
 lib/bs4/builder/_htmlparser.py         | 149 +------------------
 lib/bs4/element.py                     |  63 +++++---
 lib/bs4/formatter.py                   |   4 +-
 lib/bs4/tests/__init__.py              |  56 ++++---
 lib/bs4/tests/test_builder_registry.py |  19 +--
 lib/bs4/tests/test_dammit.py           |  65 ++++----
 lib/bs4/tests/test_html5lib.py         |  21 +--
 lib/bs4/tests/test_htmlparser.py       |  12 --
 lib/bs4/tests/test_lxml.py             |  34 +++--
 lib/bs4/tests/test_pageelement.py      |  11 +-
 lib/bs4/tests/test_soup.py             |  80 +++++-----
 lib/bs4/tests/test_tree.py             |  32 ++--
 lib/soupsieve/__init__.py              |  45 +++---
 lib/soupsieve/__meta__.py              |   5 +-
 lib/soupsieve/css_match.py             | 196 +++++++++++++------------
 lib/soupsieve/css_parser.py            |  82 +++++------
 lib/soupsieve/css_types.py             |  71 ++++-----
 lib/soupsieve/pretty.py                |   1 +
 lib/soupsieve/util.py                  |   7 +-
 requirements.txt                       |   2 +-
 23 files changed, 449 insertions(+), 537 deletions(-)

diff --git a/lib/bs4/__init__.py b/lib/bs4/__init__.py
index b3c9feb8..db71cc7c 100644
--- a/lib/bs4/__init__.py
+++ b/lib/bs4/__init__.py
@@ -7,7 +7,7 @@ Beautiful Soup uses a pluggable XML or HTML parser to parse a
 provides methods and Pythonic idioms that make it easy to navigate,
 search, and modify the parse tree.
 
-Beautiful Soup works with Python 3.5 and up. It works better if lxml
+Beautiful Soup works with Python 3.6 and up. It works better if lxml
 and/or html5lib is installed.
 
 For more than you ever wanted to know about Beautiful Soup, see the
@@ -15,8 +15,8 @@ documentation: http://www.crummy.com/software/BeautifulSoup/bs4/doc/
 """
 
 __author__ = "Leonard Richardson (leonardr@segfault.org)"
-__version__ = "4.11.1"
-__copyright__ = "Copyright (c) 2004-2022 Leonard Richardson"
+__version__ = "4.11.2"
+__copyright__ = "Copyright (c) 2004-2023 Leonard Richardson"
 # Use of this source code is governed by the MIT license.
 __license__ = "MIT"
 
@@ -211,7 +211,7 @@ class BeautifulSoup(Tag):
                 warnings.warn(
                     'The "%s" argument to the BeautifulSoup constructor '
                     'has been renamed to "%s."' % (old_name, new_name),
-                    DeprecationWarning
+                    DeprecationWarning, stacklevel=3
                 )
                 return kwargs.pop(old_name)
             return None
@@ -405,7 +405,8 @@ class BeautifulSoup(Tag):
                     'The input looks more like a URL than markup. You may want to use'
                     ' an HTTP client like requests to get the document behind'
                     ' the URL, and feed that document to Beautiful Soup.',
-                    MarkupResemblesLocatorWarning
+                    MarkupResemblesLocatorWarning,
+                    stacklevel=3
                 )
                 return True
         return False
@@ -436,7 +437,7 @@ class BeautifulSoup(Tag):
                 'The input looks more like a filename than markup. You may'
                 ' want to open this file and pass the filehandle into'
                 ' Beautiful Soup.',
-                MarkupResemblesLocatorWarning
+                MarkupResemblesLocatorWarning, stacklevel=3
             )
             return True
         return False
@@ -789,7 +790,7 @@ class BeautifulStoneSoup(BeautifulSoup):
         warnings.warn(
             'The BeautifulStoneSoup class is deprecated. Instead of using '
             'it, pass features="xml" into the BeautifulSoup constructor.',
-            DeprecationWarning
+            DeprecationWarning, stacklevel=2
         )
         super(BeautifulStoneSoup, self).__init__(*args, **kwargs)
 
diff --git a/lib/bs4/builder/__init__.py b/lib/bs4/builder/__init__.py
index 9f789f3e..2e397458 100644
--- a/lib/bs4/builder/__init__.py
+++ b/lib/bs4/builder/__init__.py
@@ -122,7 +122,7 @@ class TreeBuilder(object):
     
     # A value for these tag/attribute combinations is a space- or
     # comma-separated list of CDATA, rather than a single CDATA.
-    DEFAULT_CDATA_LIST_ATTRIBUTES = {}
+    DEFAULT_CDATA_LIST_ATTRIBUTES = defaultdict(list)
 
     # Whitespace should be preserved inside these tags.
     DEFAULT_PRESERVE_WHITESPACE_TAGS = set()
diff --git a/lib/bs4/builder/_html5lib.py b/lib/bs4/builder/_html5lib.py
index 58bc176e..dac21732 100644
--- a/lib/bs4/builder/_html5lib.py
+++ b/lib/bs4/builder/_html5lib.py
@@ -70,7 +70,10 @@ class HTML5TreeBuilder(HTMLTreeBuilder):
         # ATM because the html5lib TreeBuilder doesn't use
         # UnicodeDammit.
         if exclude_encodings:
-            warnings.warn("You provided a value for exclude_encoding, but the html5lib tree builder doesn't support exclude_encoding.")
+            warnings.warn(
+                "You provided a value for exclude_encoding, but the html5lib tree builder doesn't support exclude_encoding.",
+                stacklevel=3
+            )
 
         # html5lib only parses HTML, so if it's given XML that's worth
         # noting.
@@ -81,7 +84,10 @@ class HTML5TreeBuilder(HTMLTreeBuilder):
     # These methods are defined by Beautiful Soup.
     def feed(self, markup):
         if self.soup.parse_only is not None:
-            warnings.warn("You provided a value for parse_only, but the html5lib tree builder doesn't support parse_only. The entire document will be parsed.")
+            warnings.warn(
+                "You provided a value for parse_only, but the html5lib tree builder doesn't support parse_only. The entire document will be parsed.",
+                stacklevel=4
+            )
         parser = html5lib.HTMLParser(tree=self.create_treebuilder)
         self.underlying_builder.parser = parser
         extra_kwargs = dict()
@@ -249,9 +255,9 @@ class AttrList(object):
         # If this attribute is a multi-valued attribute for this element,
         # turn its value into a list.
         list_attr = self.element.cdata_list_attributes or {}
-        if (name in list_attr.get('*')
+        if (name in list_attr.get('*', [])
             or (self.element.name in list_attr
-                and name in list_attr[self.element.name])):
+                and name in list_attr.get(self.element.name, []))):
             # A node that is being cloned may have already undergone
             # this procedure.
             if not isinstance(value, list):
diff --git a/lib/bs4/builder/_htmlparser.py b/lib/bs4/builder/_htmlparser.py
index fae4d0f2..e48b6a0e 100644
--- a/lib/bs4/builder/_htmlparser.py
+++ b/lib/bs4/builder/_htmlparser.py
@@ -10,30 +10,9 @@ __all__ = [
 
 from html.parser import HTMLParser
 
-try:
-    from html.parser import HTMLParseError
-except ImportError as e:
-    # HTMLParseError is removed in Python 3.5. Since it can never be
-    # thrown in 3.5, we can just define our own class as a placeholder.
-    class HTMLParseError(Exception):
-        pass
-
 import sys
 import warnings
 
-# Starting in Python 3.2, the HTMLParser constructor takes a 'strict'
-# argument, which we'd like to set to False. Unfortunately,
-# http://bugs.python.org/issue13273 makes strict=True a better bet
-# before Python 3.2.3.
-#
-# At the end of this file, we monkeypatch HTMLParser so that
-# strict=True works well on Python 3.2.2.
-major, minor, release = sys.version_info[:3]
-CONSTRUCTOR_TAKES_STRICT = major == 3 and minor == 2 and release >= 3
-CONSTRUCTOR_STRICT_IS_DEPRECATED = major == 3 and minor == 3
-CONSTRUCTOR_TAKES_CONVERT_CHARREFS = major == 3 and minor >= 4
-
-
 from bs4.element import (
     CData,
     Comment,
@@ -90,20 +69,7 @@ class BeautifulSoupHTMLParser(HTMLParser, DetectsXMLParsedAsHTML):
         self.already_closed_empty_element = []
 
         self._initialize_xml_detector()
-        
-    def error(self, msg):
-        """In Python 3, HTMLParser subclasses must implement error(), although
-        this requirement doesn't appear to be documented.
 
-        In Python 2, HTMLParser implements error() by raising an exception,
-        which we don't want to do.
-
-        In any event, this method is called only on very strange
-        markup and our best strategy is to pretend it didn't happen
-        and keep going.
-        """
-        warnings.warn(msg)
-        
     def handle_startendtag(self, name, attrs):
         """Handle an incoming empty-element tag.
 
@@ -203,9 +169,10 @@ class BeautifulSoupHTMLParser(HTMLParser, DetectsXMLParsedAsHTML):
 
         :param name: Character number, possibly in hexadecimal.
         """
-        # XXX workaround for a bug in HTMLParser. Remove this once
-        # it's fixed in all supported versions.
-        # http://bugs.python.org/issue13633
+        # TODO: This was originally a workaround for a bug in
+        # HTMLParser. (http://bugs.python.org/issue13633) The bug has
+        # been fixed, but removing this code still makes some
+        # Beautiful Soup tests fail. This needs investigation.
         if name.startswith('x'):
             real_name = int(name.lstrip('x'), 16)
         elif name.startswith('X'):
@@ -333,10 +300,7 @@ class HTMLParserTreeBuilder(HTMLTreeBuilder):
         parser_args = parser_args or []
         parser_kwargs = parser_kwargs or {}
         parser_kwargs.update(extra_parser_kwargs)
-        if CONSTRUCTOR_TAKES_STRICT and not CONSTRUCTOR_STRICT_IS_DEPRECATED:
-            parser_kwargs['strict'] = False
-        if CONSTRUCTOR_TAKES_CONVERT_CHARREFS:
-            parser_kwargs['convert_charrefs'] = False
+        parser_kwargs['convert_charrefs'] = False
         self.parser_args = (parser_args, parser_kwargs)
         
     def prepare_markup(self, markup, user_specified_encoding=None,
@@ -395,105 +359,6 @@ class HTMLParserTreeBuilder(HTMLTreeBuilder):
         args, kwargs = self.parser_args
         parser = BeautifulSoupHTMLParser(*args, **kwargs)
         parser.soup = self.soup
-        try:
-            parser.feed(markup)
-            parser.close()
-        except HTMLParseError as e:
-            warnings.warn(RuntimeWarning(
-                "Python's built-in HTMLParser cannot parse the given document. This is not a bug in Beautiful Soup. The best solution is to install an external parser (lxml or html5lib), and use Beautiful Soup with that parser. See http://www.crummy.com/software/BeautifulSoup/bs4/doc/#installing-a-parser for help."))
-            raise e
+        parser.feed(markup)
+        parser.close()
         parser.already_closed_empty_element = []
-
-# Patch 3.2 versions of HTMLParser earlier than 3.2.3 to use some
-# 3.2.3 code. This ensures they don't treat markup like <p></p> as a
-# string.
-#
-# XXX This code can be removed once most Python 3 users are on 3.2.3.
-if major == 3 and minor == 2 and not CONSTRUCTOR_TAKES_STRICT:
-    import re
-    attrfind_tolerant = re.compile(
-        r'\s*((?<=[\'"\s])[^\s/>][^\s/=>]*)(\s*=+\s*'
-        r'(\'[^\']*\'|"[^"]*"|(?![\'"])[^>\s]*))?')
-    HTMLParserTreeBuilder.attrfind_tolerant = attrfind_tolerant
-
-    locatestarttagend = re.compile(r"""
-  <[a-zA-Z][-.a-zA-Z0-9:_]*          # tag name
-  (?:\s+                             # whitespace before attribute name
-    (?:[a-zA-Z_][-.:a-zA-Z0-9_]*     # attribute name
-      (?:\s*=\s*                     # value indicator
-        (?:'[^']*'                   # LITA-enclosed value
-          |\"[^\"]*\"                # LIT-enclosed value
-          |[^'\">\s]+                # bare value
-         )
-       )?
-     )
-   )*
-  \s*                                # trailing whitespace
-""", re.VERBOSE)
-    BeautifulSoupHTMLParser.locatestarttagend = locatestarttagend
-
-    from html.parser import tagfind, attrfind
-
-    def parse_starttag(self, i):
-        self.__starttag_text = None
-        endpos = self.check_for_whole_start_tag(i)
-        if endpos < 0:
-            return endpos
-        rawdata = self.rawdata
-        self.__starttag_text = rawdata[i:endpos]
-
-        # Now parse the data between i+1 and j into a tag and attrs
-        attrs = []
-        match = tagfind.match(rawdata, i+1)
-        assert match, 'unexpected call to parse_starttag()'
-        k = match.end()
-        self.lasttag = tag = rawdata[i+1:k].lower()
-        while k < endpos:
-            if self.strict:
-                m = attrfind.match(rawdata, k)
-            else:
-                m = attrfind_tolerant.match(rawdata, k)
-            if not m:
-                break
-            attrname, rest, attrvalue = m.group(1, 2, 3)
-            if not rest:
-                attrvalue = None
-            elif attrvalue[:1] == '\'' == attrvalue[-1:] or \
-                 attrvalue[:1] == '"' == attrvalue[-1:]:
-                attrvalue = attrvalue[1:-1]
-            if attrvalue:
-                attrvalue = self.unescape(attrvalue)
-            attrs.append((attrname.lower(), attrvalue))
-            k = m.end()
-
-        end = rawdata[k:endpos].strip()
-        if end not in (">", "/>"):
-            lineno, offset = self.getpos()
-            if "\n" in self.__starttag_text:
-                lineno = lineno + self.__starttag_text.count("\n")
-                offset = len(self.__starttag_text) \
-                         - self.__starttag_text.rfind("\n")
-            else:
-                offset = offset + len(self.__starttag_text)
-            if self.strict:
-                self.error("junk characters in start tag: %r"
-                           % (rawdata[k:endpos][:20],))
-            self.handle_data(rawdata[i:endpos])
-            return endpos
-        if end.endswith('/>'):
-            # XHTML-style empty tag: <span attr="value" />
-            self.handle_startendtag(tag, attrs)
-        else:
-            self.handle_starttag(tag, attrs)
-            if tag in self.CDATA_CONTENT_ELEMENTS:
-                self.set_cdata_mode(tag)
-        return endpos
-
-    def set_cdata_mode(self, elem):
-        self.cdata_elem = elem.lower()
-        self.interesting = re.compile(r'</\s*%s\s*>' % self.cdata_elem, re.I)
-
-    BeautifulSoupHTMLParser.parse_starttag = parse_starttag
-    BeautifulSoupHTMLParser.set_cdata_mode = set_cdata_mode
-
-    CONSTRUCTOR_TAKES_STRICT = True
diff --git a/lib/bs4/element.py b/lib/bs4/element.py
index 74b1dc0f..583d0e8a 100644
--- a/lib/bs4/element.py
+++ b/lib/bs4/element.py
@@ -496,13 +496,16 @@ class PageElement(object):
     def extend(self, tags):
         """Appends the given PageElements to this one's contents.
 
-        :param tags: A list of PageElements.
+        :param tags: A list of PageElements. If a single Tag is
+            provided instead, this PageElement's contents will be extended
+            with that Tag's contents.
         """
         if isinstance(tags, Tag):
-            # Calling self.append() on another tag's contents will change
-            # the list we're iterating over. Make a list that won't
-            # change.
-            tags = list(tags.contents)
+            tags = tags.contents
+        if isinstance(tags, list):
+            # Moving items around the tree may change their position in
+            # the original list. Make a list that won't change.
+            tags = list(tags)
         for tag in tags:
             self.append(tag)
 
@@ -586,8 +589,9 @@ class PageElement(object):
         :kwargs: A dictionary of filters on attribute values.
         :return: A ResultSet containing PageElements.
         """
+        _stacklevel = kwargs.pop('_stacklevel', 2)
         return self._find_all(name, attrs, string, limit, self.next_elements,
-                             **kwargs)
+                              _stacklevel=_stacklevel+1, **kwargs)
     findAllNext = find_all_next  # BS3
 
     def find_next_sibling(self, name=None, attrs={}, string=None, **kwargs):
@@ -624,8 +628,11 @@ class PageElement(object):
         :return: A ResultSet of PageElements.
         :rtype: bs4.element.ResultSet
         """
-        return self._find_all(name, attrs, string, limit,
-                              self.next_siblings, **kwargs)
+        _stacklevel = kwargs.pop('_stacklevel', 2)
+        return self._find_all(
+            name, attrs, string, limit,
+            self.next_siblings, _stacklevel=_stacklevel+1, **kwargs
+        )
     findNextSiblings = find_next_siblings   # BS3
     fetchNextSiblings = find_next_siblings  # BS2
 
@@ -663,8 +670,11 @@ class PageElement(object):
         :return: A ResultSet of PageElements.
         :rtype: bs4.element.ResultSet
         """
-        return self._find_all(name, attrs, string, limit, self.previous_elements,
-                           **kwargs)
+        _stacklevel = kwargs.pop('_stacklevel', 2)
+        return self._find_all(
+            name, attrs, string, limit, self.previous_elements,
+            _stacklevel=_stacklevel+1, **kwargs
+        )
     findAllPrevious = find_all_previous  # BS3
     fetchPrevious = find_all_previous    # BS2
 
@@ -702,8 +712,11 @@ class PageElement(object):
         :return: A ResultSet of PageElements.
         :rtype: bs4.element.ResultSet
         """
-        return self._find_all(name, attrs, string, limit,
-                              self.previous_siblings, **kwargs)
+        _stacklevel = kwargs.pop('_stacklevel', 2)
+        return self._find_all(
+            name, attrs, string, limit,
+            self.previous_siblings, _stacklevel=_stacklevel+1, **kwargs
+        )
     findPreviousSiblings = find_previous_siblings   # BS3
     fetchPreviousSiblings = find_previous_siblings  # BS2
 
@@ -724,7 +737,7 @@ class PageElement(object):
         # NOTE: We can't use _find_one because findParents takes a different
         # set of arguments.
         r = None
-        l = self.find_parents(name, attrs, 1, **kwargs)
+        l = self.find_parents(name, attrs, 1, _stacklevel=3, **kwargs)
         if l:
             r = l[0]
         return r
@@ -744,8 +757,9 @@ class PageElement(object):
         :return: A PageElement.
         :rtype: bs4.element.Tag | bs4.element.NavigableString
         """
+        _stacklevel = kwargs.pop('_stacklevel', 2)
         return self._find_all(name, attrs, None, limit, self.parents,
-                             **kwargs)
+                              _stacklevel=_stacklevel+1, **kwargs)
     findParents = find_parents   # BS3
     fetchParents = find_parents  # BS2
 
@@ -771,19 +785,20 @@ class PageElement(object):
 
     def _find_one(self, method, name, attrs, string, **kwargs):
         r = None
-        l = method(name, attrs, string, 1, **kwargs)
+        l = method(name, attrs, string, 1, _stacklevel=4, **kwargs)
         if l:
             r = l[0]
         return r
 
     def _find_all(self, name, attrs, string, limit, generator, **kwargs):
         "Iterates over a generator looking for things that match."
+        _stacklevel = kwargs.pop('_stacklevel', 3)
 
         if string is None and 'text' in kwargs:
             string = kwargs.pop('text')
             warnings.warn(
                 "The 'text' argument to find()-type methods is deprecated. Use 'string' instead.",
-                DeprecationWarning
+                DeprecationWarning, stacklevel=_stacklevel
             )
 
         if isinstance(name, SoupStrainer):
@@ -1306,7 +1321,8 @@ class Tag(PageElement):
             sourceline=self.sourceline, sourcepos=self.sourcepos,
             can_be_empty_element=self.can_be_empty_element,
             cdata_list_attributes=self.cdata_list_attributes,
-            preserve_whitespace_tags=self.preserve_whitespace_tags
+            preserve_whitespace_tags=self.preserve_whitespace_tags,
+            interesting_string_types=self.interesting_string_types
         )
         for attr in ('can_be_empty_element', 'hidden'):
             setattr(clone, attr, getattr(self, attr))
@@ -1558,7 +1574,7 @@ class Tag(PageElement):
                 '.%(name)sTag is deprecated, use .find("%(name)s") instead. If you really were looking for a tag called %(name)sTag, use .find("%(name)sTag")' % dict(
                     name=tag_name
                 ),
-                DeprecationWarning
+                DeprecationWarning, stacklevel=2
             )
             return self.find(tag_name)
         # We special case contents to avoid recursion.
@@ -1862,7 +1878,8 @@ class Tag(PageElement):
         :rtype: bs4.element.Tag | bs4.element.NavigableString
         """
         r = None
-        l = self.find_all(name, attrs, recursive, string, 1, **kwargs)
+        l = self.find_all(name, attrs, recursive, string, 1, _stacklevel=3,
+                          **kwargs)
         if l:
             r = l[0]
         return r
@@ -1889,7 +1906,9 @@ class Tag(PageElement):
         generator = self.descendants
         if not recursive:
             generator = self.children
-        return self._find_all(name, attrs, string, limit, generator, **kwargs)
+        _stacklevel = kwargs.pop('_stacklevel', 2)
+        return self._find_all(name, attrs, string, limit, generator,
+                              _stacklevel=_stacklevel+1, **kwargs)
     findAll = find_all       # BS3
     findChildren = find_all  # BS2
 
@@ -1993,7 +2012,7 @@ class Tag(PageElement):
         """
         warnings.warn(
             'has_key is deprecated. Use has_attr(key) instead.',
-            DeprecationWarning
+            DeprecationWarning, stacklevel=2
         )
         return self.has_attr(key)
 
@@ -2024,7 +2043,7 @@ class SoupStrainer(object):
             string = kwargs.pop('text')
             warnings.warn(
                 "The 'text' argument to the SoupStrainer constructor is deprecated. Use 'string' instead.",
-                DeprecationWarning
+                DeprecationWarning, stacklevel=2
             )
 
         self.name = self._normalize_search_value(name)
diff --git a/lib/bs4/formatter.py b/lib/bs4/formatter.py
index 65e57b57..83cc1c5c 100644
--- a/lib/bs4/formatter.py
+++ b/lib/bs4/formatter.py
@@ -149,14 +149,14 @@ class HTMLFormatter(Formatter):
     """A generic Formatter for HTML."""
     REGISTRY = {}
     def __init__(self, *args, **kwargs):
-        return super(HTMLFormatter, self).__init__(self.HTML, *args, **kwargs)
+        super(HTMLFormatter, self).__init__(self.HTML, *args, **kwargs)
 
     
 class XMLFormatter(Formatter):
     """A generic Formatter for XML."""
     REGISTRY = {}
     def __init__(self, *args, **kwargs):
-        return super(XMLFormatter, self).__init__(self.XML, *args, **kwargs)
+        super(XMLFormatter, self).__init__(self.XML, *args, **kwargs)
 
 
 # Set up aliases for the default formatters.
diff --git a/lib/bs4/tests/__init__.py b/lib/bs4/tests/__init__.py
index 4af4b0ce..f4d62db9 100644
--- a/lib/bs4/tests/__init__.py
+++ b/lib/bs4/tests/__init__.py
@@ -29,6 +29,29 @@ from bs4.builder import (
 )
 default_builder = HTMLParserTreeBuilder
 
+# Some tests depend on specific third-party libraries. We use
+# @pytest.mark.skipIf on the following conditionals to skip them
+# if the libraries are not installed.
+try:
+    from soupsieve import SelectorSyntaxError
+    SOUP_SIEVE_PRESENT = True
+except ImportError:
+    SOUP_SIEVE_PRESENT = False
+
+try:
+    import html5lib
+    HTML5LIB_PRESENT = True
+except ImportError:
+    HTML5LIB_PRESENT = False
+
+try:
+    import lxml.etree
+    LXML_PRESENT = True
+    LXML_VERSION = lxml.etree.LXML_VERSION
+except ImportError:
+    LXML_PRESENT = False
+    LXML_VERSION = (0,)
+
 BAD_DOCUMENT = """A bare string
 <!DOCTYPE xsl:stylesheet SYSTEM "htmlent.dtd">
 <!DOCTYPE xsl:stylesheet PUBLIC "htmlent.dtd">
@@ -258,10 +281,10 @@ class TreeBuilderSmokeTest(object):
 
     @pytest.mark.parametrize(
         "multi_valued_attributes",
-        [None, dict(b=['class']), {'*': ['notclass']}]
+        [None, {}, dict(b=['class']), {'*': ['notclass']}]
     )
     def test_attribute_not_multi_valued(self, multi_valued_attributes):
-        markup = '<a class="a b c">'
+        markup = '<html xmlns="http://www.w3.org/1999/xhtml"><a class="a b c"></html>'
         soup = self.soup(markup, multi_valued_attributes=multi_valued_attributes)
         assert soup.a['class'] == 'a b c'
 
@@ -820,26 +843,27 @@ Hello, world!
         soup = self.soup(text)
         assert soup.p.encode("utf-8") == expected
 
-    def test_real_iso_latin_document(self):
+    def test_real_iso_8859_document(self):
         # Smoke test of interrelated functionality, using an
         # easy-to-understand document.
 
-        # Here it is in Unicode. Note that it claims to be in ISO-Latin-1.
-        unicode_html = '<html><head><meta content="text/html; charset=ISO-Latin-1" http-equiv="Content-type"/></head><body><p>Sacr\N{LATIN SMALL LETTER E WITH ACUTE} bleu!</p></body></html>'
+        # Here it is in Unicode. Note that it claims to be in ISO-8859-1.
+        unicode_html = '<html><head><meta content="text/html; charset=ISO-8859-1" http-equiv="Content-type"/></head><body><p>Sacr\N{LATIN SMALL LETTER E WITH ACUTE} bleu!</p></body></html>'
 
-        # That's because we're going to encode it into ISO-Latin-1, and use
-        # that to test.
+        # That's because we're going to encode it into ISO-8859-1,
+        # and use that to test.
         iso_latin_html = unicode_html.encode("iso-8859-1")
 
-        # Parse the ISO-Latin-1 HTML.
+        # Parse the ISO-8859-1 HTML.
         soup = self.soup(iso_latin_html)
+
         # Encode it to UTF-8.
         result = soup.encode("utf-8")
 
         # What do we expect the result to look like? Well, it would
         # look like unicode_html, except that the META tag would say
-        # UTF-8 instead of ISO-Latin-1.
-        expected = unicode_html.replace("ISO-Latin-1", "utf-8")
+        # UTF-8 instead of ISO-8859-1.
+        expected = unicode_html.replace("ISO-8859-1", "utf-8")
 
         # And, of course, it would be in UTF-8, not Unicode.
         expected = expected.encode("utf-8")
@@ -1177,15 +1201,3 @@ class HTML5TreeBuilderSmokeTest(HTMLTreeBuilderSmokeTest):
         assert isinstance(soup.contents[0], Comment)
         assert soup.contents[0] == '?xml version="1.0" encoding="utf-8"?'
         assert "html" == soup.contents[0].next_element.name
-
-def skipIf(condition, reason):
-   def nothing(test, *args, **kwargs):
-       return None
-
-   def decorator(test_item):
-       if condition:
-           return nothing
-       else:
-           return test_item
-
-   return decorator
diff --git a/lib/bs4/tests/test_builder_registry.py b/lib/bs4/tests/test_builder_registry.py
index 5fa874c8..9327174f 100644
--- a/lib/bs4/tests/test_builder_registry.py
+++ b/lib/bs4/tests/test_builder_registry.py
@@ -10,22 +10,23 @@ from bs4.builder import (
     TreeBuilderRegistry,
 )
 
-try:
-    from bs4.builder import HTML5TreeBuilder
-    HTML5LIB_PRESENT = True
-except ImportError:
-    HTML5LIB_PRESENT = False
+from . import (
+    HTML5LIB_PRESENT,
+    LXML_PRESENT,
+)
 
-try:
+if HTML5LIB_PRESENT:
+    from bs4.builder import HTML5TreeBuilder
+
+if LXML_PRESENT:
     from bs4.builder import (
         LXMLTreeBuilderForXML,
         LXMLTreeBuilder,
         )
-    LXML_PRESENT = True
-except ImportError:
-    LXML_PRESENT = False
 
 
+# TODO: Split out the lxml and html5lib tests into their own classes
+# and gate with pytest.mark.skipIf.
 class TestBuiltInRegistry(object):
     """Test the built-in registry with the default builders registered."""
 
diff --git a/lib/bs4/tests/test_dammit.py b/lib/bs4/tests/test_dammit.py
index 9971234e..9aad0ac6 100644
--- a/lib/bs4/tests/test_dammit.py
+++ b/lib/bs4/tests/test_dammit.py
@@ -17,26 +17,24 @@ class TestUnicodeDammit(object):
         dammit = UnicodeDammit(markup)
         assert dammit.unicode_markup == markup
 
-    def test_smart_quotes_to_unicode(self):
+    @pytest.mark.parametrize(
+        "smart_quotes_to,expect_converted",
+        [(None, "\u2018\u2019\u201c\u201d"),
+         ("xml", "&#x2018;&#x2019;&#x201C;&#x201D;"),
+         ("html", "&lsquo;&rsquo;&ldquo;&rdquo;"),
+         ("ascii", "''" + '""'),
+        ]
+    )
+    def test_smart_quotes_to(self, smart_quotes_to, expect_converted):
+        """Verify the functionality of the smart_quotes_to argument
+        to the UnicodeDammit constructor."""
         markup = b"<foo>\x91\x92\x93\x94</foo>"
-        dammit = UnicodeDammit(markup)
-        assert dammit.unicode_markup == "<foo>\u2018\u2019\u201c\u201d</foo>"
-
-    def test_smart_quotes_to_xml_entities(self):
-        markup = b"<foo>\x91\x92\x93\x94</foo>"
-        dammit = UnicodeDammit(markup, smart_quotes_to="xml")
-        assert dammit.unicode_markup == "<foo>&#x2018;&#x2019;&#x201C;&#x201D;</foo>"
-
-    def test_smart_quotes_to_html_entities(self):
-        markup = b"<foo>\x91\x92\x93\x94</foo>"
-        dammit = UnicodeDammit(markup, smart_quotes_to="html")
-        assert dammit.unicode_markup == "<foo>&lsquo;&rsquo;&ldquo;&rdquo;</foo>"
-
-    def test_smart_quotes_to_ascii(self):
-        markup = b"<foo>\x91\x92\x93\x94</foo>"
-        dammit = UnicodeDammit(markup, smart_quotes_to="ascii")
-        assert dammit.unicode_markup == """<foo>''""</foo>"""
-
+        converted = UnicodeDammit(
+            markup, known_definite_encodings=["windows-1252"],
+            smart_quotes_to=smart_quotes_to
+        ).unicode_markup
+        assert converted == "<foo>{}</foo>".format(expect_converted)
+        
     def test_detect_utf8(self):
         utf8 = b"Sacr\xc3\xa9 bleu! \xe2\x98\x83"
         dammit = UnicodeDammit(utf8)
@@ -275,23 +273,24 @@ class TestEntitySubstitution(object):
     def setup_method(self):
         self.sub = EntitySubstitution
 
-    def test_simple_html_substitution(self):
-        # Unicode characters corresponding to named HTML entites
-        # are substituted, and no others.
-        s = "foo\u2200\N{SNOWMAN}\u00f5bar"
-        assert self.sub.substitute_html(s) == "foo&forall;\N{SNOWMAN}&otilde;bar"
 
-    def test_smart_quote_substitution(self):
-        # MS smart quotes are a common source of frustration, so we
-        # give them a special test.
-        quotes = b"\x91\x92foo\x93\x94"
-        dammit = UnicodeDammit(quotes)
-        assert self.sub.substitute_html(dammit.markup) == "&lsquo;&rsquo;foo&ldquo;&rdquo;"
+    @pytest.mark.parametrize(
+        "original,substituted",
+        [
+            # Basic case. Unicode characters corresponding to named
+            # HTML entites are substituted; others are not.
+            ("foo\u2200\N{SNOWMAN}\u00f5bar",
+             "foo&forall;\N{SNOWMAN}&otilde;bar"),
 
+            # MS smart quotes are a common source of frustration, so we
+            # give them a special test.
+            ('‘’foo“”', "&lsquo;&rsquo;foo&ldquo;&rdquo;"),           
+        ]
+    )
+    def test_substitute_html(self, original, substituted):
+        assert self.sub.substitute_html(original) == substituted
+        
     def test_html5_entity(self):
-        # Some HTML5 entities correspond to single- or multi-character
-        # Unicode sequences.
-
         for entity, u in (
             # A few spot checks of our ability to recognize
             # special character sequences and convert them
diff --git a/lib/bs4/tests/test_html5lib.py b/lib/bs4/tests/test_html5lib.py
index b32ab304..4197720f 100644
--- a/lib/bs4/tests/test_html5lib.py
+++ b/lib/bs4/tests/test_html5lib.py
@@ -1,27 +1,26 @@
 """Tests to ensure that the html5lib tree builder generates good trees."""
 
+import pytest
 import warnings
 
-try:
-    from bs4.builder import HTML5TreeBuilder
-    HTML5LIB_PRESENT = True
-except ImportError as e:
-    HTML5LIB_PRESENT = False
+from bs4 import BeautifulSoup
 from bs4.element import SoupStrainer
 from . import (
+    HTML5LIB_PRESENT,
     HTML5TreeBuilderSmokeTest,
     SoupTest,
-    skipIf,
 )
 
-@skipIf(
+@pytest.mark.skipif(
     not HTML5LIB_PRESENT,
-    "html5lib seems not to be present, not testing its tree builder.")
+    reason="html5lib seems not to be present, not testing its tree builder."
+)
 class TestHTML5LibBuilder(SoupTest, HTML5TreeBuilderSmokeTest):
     """See ``HTML5TreeBuilderSmokeTest``."""
 
     @property
     def default_builder(self):
+        from bs4.builder import HTML5TreeBuilder
         return HTML5TreeBuilder
 
     def test_soupstrainer(self):
@@ -29,10 +28,12 @@ class TestHTML5LibBuilder(SoupTest, HTML5TreeBuilderSmokeTest):
         strainer = SoupStrainer("b")
         markup = "<p>A <b>bold</b> statement.</p>"
         with warnings.catch_warnings(record=True) as w:
-            soup = self.soup(markup, parse_only=strainer)
+            soup = BeautifulSoup(markup, "html5lib", parse_only=strainer)
         assert soup.decode() == self.document_for(markup)
 
-        assert "the html5lib tree builder doesn't support parse_only" in str(w[0].message)
+        [warning] = w
+        assert warning.filename == __file__
+        assert "the html5lib tree builder doesn't support parse_only" in str(warning.message)
 
     def test_correctly_nested_tables(self):
         """html5lib inserts <tbody> tags where other parsers don't."""
diff --git a/lib/bs4/tests/test_htmlparser.py b/lib/bs4/tests/test_htmlparser.py
index bfcfa1f3..470d3936 100644
--- a/lib/bs4/tests/test_htmlparser.py
+++ b/lib/bs4/tests/test_htmlparser.py
@@ -122,15 +122,3 @@ class TestHTMLParserTreeBuilder(SoupTest, HTMLTreeBuilderSmokeTest):
             with_element = div.encode(formatter="html")
             expect = b"<div>%s</div>" % output_element
             assert with_element == expect
-
-class TestHTMLParserSubclass(SoupTest):
-    def test_error(self):
-        """Verify that our HTMLParser subclass implements error() in a way
-        that doesn't cause a crash.
-        """
-        parser = BeautifulSoupHTMLParser()
-        with warnings.catch_warnings(record=True) as warns:
-            parser.error("don't crash")
-        [warning] = warns
-        assert "don't crash" == str(warning.message)
-
diff --git a/lib/bs4/tests/test_lxml.py b/lib/bs4/tests/test_lxml.py
index 396ca0ef..c7bf45d3 100644
--- a/lib/bs4/tests/test_lxml.py
+++ b/lib/bs4/tests/test_lxml.py
@@ -1,16 +1,10 @@
 """Tests to ensure that the lxml tree builder generates good trees."""
 
 import pickle
+import pytest
 import re
 import warnings
-
-try:
-    import lxml.etree
-    LXML_PRESENT = True
-    LXML_VERSION = lxml.etree.LXML_VERSION
-except ImportError as e:
-    LXML_PRESENT = False
-    LXML_VERSION = (0,)
+from . import LXML_PRESENT, LXML_VERSION
 
 if LXML_PRESENT:
     from bs4.builder import LXMLTreeBuilder, LXMLTreeBuilderForXML
@@ -23,13 +17,14 @@ from bs4.element import Comment, Doctype, SoupStrainer
 from . import (
     HTMLTreeBuilderSmokeTest,
     XMLTreeBuilderSmokeTest,
+    SOUP_SIEVE_PRESENT,
     SoupTest,
-    skipIf,
 )
 
-@skipIf(
+@pytest.mark.skipif(
     not LXML_PRESENT,
-    "lxml seems not to be present, not testing its tree builder.")
+    reason="lxml seems not to be present, not testing its tree builder."
+)
 class TestLXMLTreeBuilder(SoupTest, HTMLTreeBuilderSmokeTest):
     """See ``HTMLTreeBuilderSmokeTest``."""
 
@@ -54,9 +49,10 @@ class TestLXMLTreeBuilder(SoupTest, HTMLTreeBuilderSmokeTest):
     # In lxml < 2.3.5, an empty doctype causes a segfault. Skip this
     # test if an old version of lxml is installed.
 
-    @skipIf(
+    @pytest.mark.skipif(
         not LXML_PRESENT or LXML_VERSION < (2,3,5,0),
-        "Skipping doctype test for old version of lxml to avoid segfault.")
+        reason="Skipping doctype test for old version of lxml to avoid segfault."
+    )
     def test_empty_doctype(self):
         soup = self.soup("<!DOCTYPE>")
         doctype = soup.contents[0]
@@ -68,7 +64,9 @@ class TestLXMLTreeBuilder(SoupTest, HTMLTreeBuilderSmokeTest):
         with warnings.catch_warnings(record=True) as w:
             soup = BeautifulStoneSoup("<b />")
         assert "<b/>" == str(soup.b)
-        assert "BeautifulStoneSoup class is deprecated" in str(w[0].message)
+        [warning] = w
+        assert warning.filename == __file__
+        assert "BeautifulStoneSoup class is deprecated" in str(warning.message)
 
     def test_tracking_line_numbers(self):
         # The lxml TreeBuilder cannot keep track of line numbers from
@@ -85,9 +83,10 @@ class TestLXMLTreeBuilder(SoupTest, HTMLTreeBuilderSmokeTest):
         assert "sourceline" == soup.p.sourceline.name
         assert "sourcepos" == soup.p.sourcepos.name
         
-@skipIf(
+@pytest.mark.skipif(
     not LXML_PRESENT,
-    "lxml seems not to be present, not testing its XML tree builder.")
+    reason="lxml seems not to be present, not testing its XML tree builder."
+)
 class TestLXMLXMLTreeBuilder(SoupTest, XMLTreeBuilderSmokeTest):
     """See ``HTMLTreeBuilderSmokeTest``."""
 
@@ -148,6 +147,9 @@ class TestLXMLXMLTreeBuilder(SoupTest, XMLTreeBuilderSmokeTest):
         }
 
 
+    @pytest.mark.skipif(
+        not SOUP_SIEVE_PRESENT, reason="Soup Sieve not installed"
+    )
     def test_namespace_interaction_with_select_and_find(self):
         # Demonstrate how namespaces interact with select* and
         # find* methods.
diff --git a/lib/bs4/tests/test_pageelement.py b/lib/bs4/tests/test_pageelement.py
index 26783f2c..6674dadf 100644
--- a/lib/bs4/tests/test_pageelement.py
+++ b/lib/bs4/tests/test_pageelement.py
@@ -3,15 +3,18 @@ import copy
 import pickle
 import pytest
 
-from soupsieve import SelectorSyntaxError
-
 from bs4 import BeautifulSoup
 from bs4.element import (
     Comment,
     SoupStrainer,
 )
-from . import SoupTest
+from . import (
+    SoupTest,
+    SOUP_SIEVE_PRESENT,
+)
 
+if SOUP_SIEVE_PRESENT:
+    from soupsieve import SelectorSyntaxError
 
 class TestEncoding(SoupTest):
     """Test the ability to encode objects into strings."""
@@ -213,6 +216,7 @@ class TestFormatters(SoupTest):
         assert soup.contents[0].name == 'pre'
 
 
+@pytest.mark.skipif(not SOUP_SIEVE_PRESENT, reason="Soup Sieve not installed")
 class TestCSSSelectors(SoupTest):
     """Test basic CSS selector functionality.
 
@@ -694,6 +698,7 @@ class TestPersistence(SoupTest):
         assert tag.can_be_empty_element == copied.can_be_empty_element
         assert tag.cdata_list_attributes == copied.cdata_list_attributes
         assert tag.preserve_whitespace_tags == copied.preserve_whitespace_tags
+        assert tag.interesting_string_types == copied.interesting_string_types
         
     def test_unicode_pickle(self):
         # A tree containing Unicode characters can be pickled.
diff --git a/lib/bs4/tests/test_soup.py b/lib/bs4/tests/test_soup.py
index 445f74da..64b8cf12 100644
--- a/lib/bs4/tests/test_soup.py
+++ b/lib/bs4/tests/test_soup.py
@@ -30,19 +30,11 @@ from bs4.element import (
 
 from . import (
     default_builder,
+    LXML_PRESENT,
     SoupTest,
-    skipIf,
 )
 import warnings
-
-try:
-    from bs4.builder import LXMLTreeBuilder, LXMLTreeBuilderForXML
-    LXML_PRESENT = True
-except ImportError as e:
-    LXML_PRESENT = False
     
-PYTHON_3_PRE_3_2 = (sys.version_info[0] == 3 and sys.version_info < (3,2))
-
 class TestConstructor(SoupTest):
 
     def test_short_unicode_input(self):
@@ -139,7 +131,7 @@ class TestConstructor(SoupTest):
         assert " an id " == a['id']
         assert ["a", "class"] == a['class']
 
-        # TreeBuilder takes an argument called 'mutli_valued_attributes'  which lets
+        # TreeBuilder takes an argument called 'multi_valued_attributes'  which lets
         # you customize or disable this. As always, you can customize the TreeBuilder
         # by passing in a keyword argument to the BeautifulSoup constructor.
         soup = self.soup(markup, builder=default_builder, multi_valued_attributes=None)
@@ -219,10 +211,17 @@ class TestConstructor(SoupTest):
 
 
 class TestWarnings(SoupTest):
+    # Note that some of the tests in this class create BeautifulSoup
+    # objects directly rather than using self.soup(). That's
+    # because SoupTest.soup is defined in a different file,
+    # which will throw off the assertion in _assert_warning
+    # that the code that triggered the warning is in the same
+    # file as the test.
 
     def _assert_warning(self, warnings, cls):
         for w in warnings:
             if isinstance(w.message, cls):
+                assert w.filename == __file__
                 return w
         raise Exception("%s warning not found in %r" % (cls, warnings))
     
@@ -243,13 +242,17 @@ class TestWarnings(SoupTest):
 
     def test_no_warning_if_explicit_parser_specified(self):
         with warnings.catch_warnings(record=True) as w:
-            soup = BeautifulSoup("<a><b></b></a>", "html.parser")
+            soup = self.soup("<a><b></b></a>")
         assert [] == w
 
     def test_parseOnlyThese_renamed_to_parse_only(self):
         with warnings.catch_warnings(record=True) as w:
-            soup = self.soup("<a><b></b></a>", parseOnlyThese=SoupStrainer("b"))
-        msg = str(w[0].message)
+            soup = BeautifulSoup(
+                "<a><b></b></a>", "html.parser",
+                parseOnlyThese=SoupStrainer("b"),
+            )
+        warning = self._assert_warning(w, DeprecationWarning)
+        msg = str(warning.message)
         assert "parseOnlyThese" in msg
         assert "parse_only" in msg
         assert b"<b></b>" == soup.encode()
@@ -257,8 +260,11 @@ class TestWarnings(SoupTest):
     def test_fromEncoding_renamed_to_from_encoding(self):
         with warnings.catch_warnings(record=True) as w:
             utf8 = b"\xc3\xa9"
-            soup = self.soup(utf8, fromEncoding="utf8")
-        msg = str(w[0].message)
+            soup = BeautifulSoup(
+                utf8, "html.parser", fromEncoding="utf8"
+            )
+        warning = self._assert_warning(w, DeprecationWarning)
+        msg = str(warning.message)
         assert "fromEncoding" in msg
         assert "from_encoding" in msg
         assert "utf8" == soup.original_encoding
@@ -276,7 +282,7 @@ class TestWarnings(SoupTest):
         # A warning is issued if the "markup" looks like the name of
         # an HTML or text file, or a full path to a file on disk.
         with warnings.catch_warnings(record=True) as w:
-            soup = self.soup("markup" + extension)
+            soup = BeautifulSoup("markup" + extension, "html.parser")
             warning = self._assert_warning(w, MarkupResemblesLocatorWarning)
             assert "looks more like a filename" in str(warning.message)
 
@@ -291,11 +297,11 @@ class TestWarnings(SoupTest):
         with warnings.catch_warnings(record=True) as w:
             soup = self.soup("markup" + extension)
         assert [] == w
-        
+
     def test_url_warning_with_bytes_url(self):
         url = b"http://www.crummybytes.com/"
         with warnings.catch_warnings(record=True) as warning_list:
-            soup = self.soup(url)
+            soup = BeautifulSoup(url, "html.parser")
         warning = self._assert_warning(
             warning_list, MarkupResemblesLocatorWarning
         )
@@ -307,7 +313,7 @@ class TestWarnings(SoupTest):
         with warnings.catch_warnings(record=True) as warning_list:
             # note - this url must differ from the bytes one otherwise
             # python's warnings system swallows the second warning
-            soup = self.soup(url)
+            soup = BeautifulSoup(url, "html.parser")
         warning = self._assert_warning(
             warning_list, MarkupResemblesLocatorWarning
         )
@@ -347,18 +353,22 @@ class TestNewTag(SoupTest):
         assert "foo" == new_tag.name
         assert dict(bar="baz", name="a name") == new_tag.attrs
         assert None == new_tag.parent
-        
+
+    @pytest.mark.skipif(
+        not LXML_PRESENT,
+        reason="lxml not installed, cannot parse XML document"
+    )
+    def test_xml_tag_inherits_self_closing_rules_from_builder(self):
+        xml_soup = BeautifulSoup("", "xml")
+        xml_br = xml_soup.new_tag("br")
+        xml_p = xml_soup.new_tag("p")
+
+        # Both the <br> and <p> tag are empty-element, just because
+        # they have no contents.
+        assert b"<br/>" == xml_br.encode()
+        assert b"<p/>" == xml_p.encode()
+
     def test_tag_inherits_self_closing_rules_from_builder(self):
-        if LXML_PRESENT:
-            xml_soup = BeautifulSoup("", "lxml-xml")
-            xml_br = xml_soup.new_tag("br")
-            xml_p = xml_soup.new_tag("p")
-
-            # Both the <br> and <p> tag are empty-element, just because
-            # they have no contents.
-            assert b"<br/>" == xml_br.encode()
-            assert b"<p/>" == xml_p.encode()
-
         html_soup = BeautifulSoup("", "html.parser")
         html_br = html_soup.new_tag("br")
         html_p = html_soup.new_tag("p")
@@ -450,13 +460,3 @@ class TestEncodingConversion(SoupTest):
         # The internal data structures can be encoded as UTF-8.
         soup_from_unicode = self.soup(self.unicode_data)
         assert soup_from_unicode.encode('utf-8') == self.utf8_data
-
-    @skipIf(
-        PYTHON_3_PRE_3_2,
-        "Bad HTMLParser detected; skipping test of non-ASCII characters in attribute name.")
-    def test_attribute_name_containing_unicode_characters(self):
-        markup = '<div><a \N{SNOWMAN}="snowman"></a></div>'
-        assert self.soup(markup).div.encode("utf8") == markup.encode("utf8")
-
-
-
diff --git a/lib/bs4/tests/test_tree.py b/lib/bs4/tests/test_tree.py
index bfd6826e..26995f95 100644
--- a/lib/bs4/tests/test_tree.py
+++ b/lib/bs4/tests/test_tree.py
@@ -33,7 +33,6 @@ from bs4.element import (
 )
 from . import (
     SoupTest,
-    skipIf,
 )
 
 class TestFind(SoupTest):
@@ -910,12 +909,16 @@ class TestTreeModification(SoupTest):
         soup.a.extend(l)
         assert "<a><g></g><f></f><e></e><d></d><c></c><b></b></a>" == soup.decode()
 
-    def test_extend_with_another_tags_contents(self):
+    @pytest.mark.parametrize(
+        "get_tags", [lambda tag: tag, lambda tag: tag.contents]
+    )
+    def test_extend_with_another_tags_contents(self, get_tags):
         data = '<body><div id="d1"><a>1</a><a>2</a><a>3</a><a>4</a></div><div id="d2"></div></body>'
         soup = self.soup(data)
         d1 = soup.find('div', id='d1')
         d2 = soup.find('div', id='d2')
-        d2.extend(d1)
+        tags = get_tags(d1)
+        d2.extend(tags)
         assert '<div id="d1"></div>' == d1.decode()
         assert '<div id="d2"><a>1</a><a>2</a><a>3</a><a>4</a></div>' == d2.decode()
         
@@ -1272,19 +1275,30 @@ class TestTreeModification(SoupTest):
 
 class TestDeprecatedArguments(SoupTest):
 
-    def test_find_type_method_string(self):
+    @pytest.mark.parametrize(
+        "method_name", [
+            "find", "find_all", "find_parent", "find_parents",
+            "find_next", "find_all_next", "find_previous",
+            "find_all_previous", "find_next_sibling", "find_next_siblings",
+            "find_previous_sibling", "find_previous_siblings",
+        ]
+    )
+    def test_find_type_method_string(self, method_name):
         soup = self.soup("<a>some</a><b>markup</b>")
+        method = getattr(soup.b, method_name)
         with warnings.catch_warnings(record=True) as w:
-            [result] = soup.find_all(text='markup')
-            assert result == 'markup'
-            assert result.parent.name == 'b'
-            msg = str(w[0].message)
+            method(text='markup')
+            [warning] = w
+            assert warning.filename == __file__
+            msg = str(warning.message)
             assert msg == "The 'text' argument to find()-type methods is deprecated. Use 'string' instead."
 
     def test_soupstrainer_constructor_string(self):
         with warnings.catch_warnings(record=True) as w:
             strainer = SoupStrainer(text="text")
             assert strainer.text == 'text'
-            msg = str(w[0].message)
+            [warning] = w
+            msg = str(warning.message)
+            assert warning.filename == __file__
             assert msg == "The 'text' argument to the SoupStrainer constructor is deprecated. Use 'string' instead."
 
diff --git a/lib/soupsieve/__init__.py b/lib/soupsieve/__init__.py
index c89b7002..591a4f4f 100644
--- a/lib/soupsieve/__init__.py
+++ b/lib/soupsieve/__init__.py
@@ -25,13 +25,14 @@ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 """
+from __future__ import annotations
 from .__meta__ import __version__, __version_info__  # noqa: F401
 from . import css_parser as cp
 from . import css_match as cm
 from . import css_types as ct
 from .util import DEBUG, SelectorSyntaxError  # noqa: F401
 import bs4  # type: ignore[import]
-from typing import Dict, Optional, Any, List, Iterator, Iterable
+from typing import Optional, Any, Iterator, Iterable
 
 __all__ = (
     'DEBUG', 'SelectorSyntaxError', 'SoupSieve',
@@ -44,17 +45,14 @@ SoupSieve = cm.SoupSieve
 
 def compile(  # noqa: A001
     pattern: str,
-    namespaces: Optional[Dict[str, str]] = None,
+    namespaces: Optional[dict[str, str]] = None,
     flags: int = 0,
     *,
-    custom: Optional[Dict[str, str]] = None,
+    custom: Optional[dict[str, str]] = None,
     **kwargs: Any
 ) -> cm.SoupSieve:
     """Compile CSS pattern."""
 
-    ns = ct.Namespaces(namespaces) if namespaces is not None else namespaces  # type: Optional[ct.Namespaces]
-    cs = ct.CustomSelectors(custom) if custom is not None else custom  # type: Optional[ct.CustomSelectors]
-
     if isinstance(pattern, SoupSieve):
         if flags:
             raise ValueError("Cannot process 'flags' argument on a compiled selector list")
@@ -64,7 +62,12 @@ def compile(  # noqa: A001
             raise ValueError("Cannot process 'custom' argument on a compiled selector list")
         return pattern
 
-    return cp._cached_css_compile(pattern, ns, cs, flags)
+    return cp._cached_css_compile(
+        pattern,
+        ct.Namespaces(namespaces) if namespaces is not None else namespaces,
+        ct.CustomSelectors(custom) if custom is not None else custom,
+        flags
+    )
 
 
 def purge() -> None:
@@ -76,10 +79,10 @@ def purge() -> None:
 def closest(
     select: str,
     tag: 'bs4.Tag',
-    namespaces: Optional[Dict[str, str]] = None,
+    namespaces: Optional[dict[str, str]] = None,
     flags: int = 0,
     *,
-    custom: Optional[Dict[str, str]] = None,
+    custom: Optional[dict[str, str]] = None,
     **kwargs: Any
 ) -> 'bs4.Tag':
     """Match closest ancestor."""
@@ -90,10 +93,10 @@ def closest(
 def match(
     select: str,
     tag: 'bs4.Tag',
-    namespaces: Optional[Dict[str, str]] = None,
+    namespaces: Optional[dict[str, str]] = None,
     flags: int = 0,
     *,
-    custom: Optional[Dict[str, str]] = None,
+    custom: Optional[dict[str, str]] = None,
     **kwargs: Any
 ) -> bool:
     """Match node."""
@@ -104,12 +107,12 @@ def match(
 def filter(  # noqa: A001
     select: str,
     iterable: Iterable['bs4.Tag'],
-    namespaces: Optional[Dict[str, str]] = None,
+    namespaces: Optional[dict[str, str]] = None,
     flags: int = 0,
     *,
-    custom: Optional[Dict[str, str]] = None,
+    custom: Optional[dict[str, str]] = None,
     **kwargs: Any
-) -> List['bs4.Tag']:
+) -> list['bs4.Tag']:
     """Filter list of nodes."""
 
     return compile(select, namespaces, flags, **kwargs).filter(iterable)
@@ -118,10 +121,10 @@ def filter(  # noqa: A001
 def select_one(
     select: str,
     tag: 'bs4.Tag',
-    namespaces: Optional[Dict[str, str]] = None,
+    namespaces: Optional[dict[str, str]] = None,
     flags: int = 0,
     *,
-    custom: Optional[Dict[str, str]] = None,
+    custom: Optional[dict[str, str]] = None,
     **kwargs: Any
 ) -> 'bs4.Tag':
     """Select a single tag."""
@@ -132,13 +135,13 @@ def select_one(
 def select(
     select: str,
     tag: 'bs4.Tag',
-    namespaces: Optional[Dict[str, str]] = None,
+    namespaces: Optional[dict[str, str]] = None,
     limit: int = 0,
     flags: int = 0,
     *,
-    custom: Optional[Dict[str, str]] = None,
+    custom: Optional[dict[str, str]] = None,
     **kwargs: Any
-) -> List['bs4.Tag']:
+) -> list['bs4.Tag']:
     """Select the specified tags."""
 
     return compile(select, namespaces, flags, **kwargs).select(tag, limit)
@@ -147,11 +150,11 @@ def select(
 def iselect(
     select: str,
     tag: 'bs4.Tag',
-    namespaces: Optional[Dict[str, str]] = None,
+    namespaces: Optional[dict[str, str]] = None,
     limit: int = 0,
     flags: int = 0,
     *,
-    custom: Optional[Dict[str, str]] = None,
+    custom: Optional[dict[str, str]] = None,
     **kwargs: Any
 ) -> Iterator['bs4.Tag']:
     """Iterate the specified tags."""
diff --git a/lib/soupsieve/__meta__.py b/lib/soupsieve/__meta__.py
index 3bd6607f..5369314e 100644
--- a/lib/soupsieve/__meta__.py
+++ b/lib/soupsieve/__meta__.py
@@ -1,4 +1,5 @@
 """Meta related things."""
+from __future__ import annotations
 from collections import namedtuple
 import re
 
@@ -83,7 +84,7 @@ class Version(namedtuple("Version", ["major", "minor", "micro", "release", "pre"
         cls,
         major: int, minor: int, micro: int, release: str = "final",
         pre: int = 0, post: int = 0, dev: int = 0
-    ) -> "Version":
+    ) -> Version:
         """Validate version info."""
 
         # Ensure all parts are positive integers.
@@ -192,5 +193,5 @@ def parse_version(ver: str) -> Version:
     return Version(major, minor, micro, release, pre, post, dev)
 
 
-__version_info__ = Version(2, 3, 2, "final", post=1)
+__version_info__ = Version(2, 4, 0, "final")
 __version__ = __version_info__._get_canonical()
diff --git a/lib/soupsieve/css_match.py b/lib/soupsieve/css_match.py
index 49e5f070..65752829 100644
--- a/lib/soupsieve/css_match.py
+++ b/lib/soupsieve/css_match.py
@@ -1,11 +1,12 @@
 """CSS matcher."""
+from __future__ import annotations
 from datetime import datetime
 from . import util
 import re
 from . import css_types as ct
 import unicodedata
 import bs4  # type: ignore[import]
-from typing import Iterator, Iterable, List, Any, Optional, Tuple, Union, Dict, Callable, Sequence, cast
+from typing import Iterator, Iterable, Any, Optional, Callable, Sequence, cast  # noqa: F401
 
 # Empty tag pattern (whitespace okay)
 RE_NOT_EMPTY = re.compile('[^ \t\r\n\f]')
@@ -64,12 +65,12 @@ class _FakeParent:
     fake parent so we can traverse the root element as a child.
     """
 
-    def __init__(self, element: 'bs4.Tag') -> None:
+    def __init__(self, element: bs4.Tag) -> None:
         """Initialize."""
 
         self.contents = [element]
 
-    def __len__(self) -> 'bs4.PageElement':
+    def __len__(self) -> bs4.PageElement:
         """Length."""
 
         return len(self.contents)
@@ -87,59 +88,59 @@ class _DocumentNav:
             raise TypeError("Expected a BeautifulSoup 'Tag', but instead received type {}".format(type(tag)))
 
     @staticmethod
-    def is_doc(obj: 'bs4.Tag') -> bool:
+    def is_doc(obj: bs4.Tag) -> bool:
         """Is `BeautifulSoup` object."""
         return isinstance(obj, bs4.BeautifulSoup)
 
     @staticmethod
-    def is_tag(obj: 'bs4.PageElement') -> bool:
+    def is_tag(obj: bs4.PageElement) -> bool:
         """Is tag."""
         return isinstance(obj, bs4.Tag)
 
     @staticmethod
-    def is_declaration(obj: 'bs4.PageElement') -> bool:  # pragma: no cover
+    def is_declaration(obj: bs4.PageElement) -> bool:  # pragma: no cover
         """Is declaration."""
         return isinstance(obj, bs4.Declaration)
 
     @staticmethod
-    def is_cdata(obj: 'bs4.PageElement') -> bool:
+    def is_cdata(obj: bs4.PageElement) -> bool:
         """Is CDATA."""
         return isinstance(obj, bs4.CData)
 
     @staticmethod
-    def is_processing_instruction(obj: 'bs4.PageElement') -> bool:  # pragma: no cover
+    def is_processing_instruction(obj: bs4.PageElement) -> bool:  # pragma: no cover
         """Is processing instruction."""
         return isinstance(obj, bs4.ProcessingInstruction)
 
     @staticmethod
-    def is_navigable_string(obj: 'bs4.PageElement') -> bool:
+    def is_navigable_string(obj: bs4.PageElement) -> bool:
         """Is navigable string."""
         return isinstance(obj, bs4.NavigableString)
 
     @staticmethod
-    def is_special_string(obj: 'bs4.PageElement') -> bool:
+    def is_special_string(obj: bs4.PageElement) -> bool:
         """Is special string."""
         return isinstance(obj, (bs4.Comment, bs4.Declaration, bs4.CData, bs4.ProcessingInstruction, bs4.Doctype))
 
     @classmethod
-    def is_content_string(cls, obj: 'bs4.PageElement') -> bool:
+    def is_content_string(cls, obj: bs4.PageElement) -> bool:
         """Check if node is content string."""
 
         return cls.is_navigable_string(obj) and not cls.is_special_string(obj)
 
     @staticmethod
-    def create_fake_parent(el: 'bs4.Tag') -> _FakeParent:
+    def create_fake_parent(el: bs4.Tag) -> _FakeParent:
         """Create fake parent for a given element."""
 
         return _FakeParent(el)
 
     @staticmethod
-    def is_xml_tree(el: 'bs4.Tag') -> bool:
+    def is_xml_tree(el: bs4.Tag) -> bool:
         """Check if element (or document) is from a XML tree."""
 
         return bool(el._is_xml)
 
-    def is_iframe(self, el: 'bs4.Tag') -> bool:
+    def is_iframe(self, el: bs4.Tag) -> bool:
         """Check if element is an `iframe`."""
 
         return bool(
@@ -147,7 +148,7 @@ class _DocumentNav:
             self.is_html_tag(el)  # type: ignore[attr-defined]
         )
 
-    def is_root(self, el: 'bs4.Tag') -> bool:
+    def is_root(self, el: bs4.Tag) -> bool:
         """
         Return whether element is a root element.
 
@@ -161,7 +162,7 @@ class _DocumentNav:
             root = parent is not None and self.is_html and self.is_iframe(parent)  # type: ignore[attr-defined]
         return root
 
-    def get_contents(self, el: 'bs4.Tag', no_iframe: bool = False) -> Iterator['bs4.PageElement']:
+    def get_contents(self, el: bs4.Tag, no_iframe: bool = False) -> Iterator[bs4.PageElement]:
         """Get contents or contents in reverse."""
         if not no_iframe or not self.is_iframe(el):
             for content in el.contents:
@@ -169,12 +170,12 @@ class _DocumentNav:
 
     def get_children(
         self,
-        el: 'bs4.Tag',
+        el: bs4.Tag,
         start: Optional[int] = None,
         reverse: bool = False,
         tags: bool = True,
         no_iframe: bool = False
-    ) -> Iterator['bs4.PageElement']:
+    ) -> Iterator[bs4.PageElement]:
         """Get children."""
 
         if not no_iframe or not self.is_iframe(el):
@@ -195,10 +196,10 @@ class _DocumentNav:
 
     def get_descendants(
         self,
-        el: 'bs4.Tag',
+        el: bs4.Tag,
         tags: bool = True,
         no_iframe: bool = False
-    ) -> Iterator['bs4.PageElement']:
+    ) -> Iterator[bs4.PageElement]:
         """Get descendants."""
 
         if not no_iframe or not self.is_iframe(el):
@@ -229,7 +230,7 @@ class _DocumentNav:
                 if not tags or is_tag:
                     yield child
 
-    def get_parent(self, el: 'bs4.Tag', no_iframe: bool = False) -> 'bs4.Tag':
+    def get_parent(self, el: bs4.Tag, no_iframe: bool = False) -> bs4.Tag:
         """Get parent."""
 
         parent = el.parent
@@ -238,25 +239,25 @@ class _DocumentNav:
         return parent
 
     @staticmethod
-    def get_tag_name(el: 'bs4.Tag') -> Optional[str]:
+    def get_tag_name(el: bs4.Tag) -> Optional[str]:
         """Get tag."""
 
         return cast(Optional[str], el.name)
 
     @staticmethod
-    def get_prefix_name(el: 'bs4.Tag') -> Optional[str]:
+    def get_prefix_name(el: bs4.Tag) -> Optional[str]:
         """Get prefix."""
 
         return cast(Optional[str], el.prefix)
 
     @staticmethod
-    def get_uri(el: 'bs4.Tag') -> Optional[str]:
+    def get_uri(el: bs4.Tag) -> Optional[str]:
         """Get namespace `URI`."""
 
         return cast(Optional[str], el.namespace)
 
     @classmethod
-    def get_next(cls, el: 'bs4.Tag', tags: bool = True) -> 'bs4.PageElement':
+    def get_next(cls, el: bs4.Tag, tags: bool = True) -> bs4.PageElement:
         """Get next sibling tag."""
 
         sibling = el.next_sibling
@@ -265,7 +266,7 @@ class _DocumentNav:
         return sibling
 
     @classmethod
-    def get_previous(cls, el: 'bs4.Tag', tags: bool = True) -> 'bs4.PageElement':
+    def get_previous(cls, el: bs4.Tag, tags: bool = True) -> bs4.PageElement:
         """Get previous sibling tag."""
 
         sibling = el.previous_sibling
@@ -274,7 +275,7 @@ class _DocumentNav:
         return sibling
 
     @staticmethod
-    def has_html_ns(el: 'bs4.Tag') -> bool:
+    def has_html_ns(el: bs4.Tag) -> bool:
         """
         Check if element has an HTML namespace.
 
@@ -286,13 +287,13 @@ class _DocumentNav:
         return bool(ns and ns == NS_XHTML)
 
     @staticmethod
-    def split_namespace(el: 'bs4.Tag', attr_name: str) -> Tuple[Optional[str], Optional[str]]:
+    def split_namespace(el: bs4.Tag, attr_name: str) -> tuple[Optional[str], Optional[str]]:
         """Return namespace and attribute name without the prefix."""
 
         return getattr(attr_name, 'namespace', None), getattr(attr_name, 'name', None)
 
     @classmethod
-    def normalize_value(cls, value: Any) -> Union[str, Sequence[str]]:
+    def normalize_value(cls, value: Any) -> str | Sequence[str]:
         """Normalize the value to be a string or list of strings."""
 
         # Treat `None` as empty string.
@@ -327,10 +328,10 @@ class _DocumentNav:
     @classmethod
     def get_attribute_by_name(
         cls,
-        el: 'bs4.Tag',
+        el: bs4.Tag,
         name: str,
-        default: Optional[Union[str, Sequence[str]]] = None
-    ) -> Optional[Union[str, Sequence[str]]]:
+        default: Optional[str | Sequence[str]] = None
+    ) -> Optional[str | Sequence[str]]:
         """Get attribute by name."""
 
         value = default
@@ -347,14 +348,14 @@ class _DocumentNav:
         return value
 
     @classmethod
-    def iter_attributes(cls, el: 'bs4.Tag') -> Iterator[Tuple[str, Optional[Union[str, Sequence[str]]]]]:
+    def iter_attributes(cls, el: bs4.Tag) -> Iterator[tuple[str, Optional[str | Sequence[str]]]]:
         """Iterate attributes."""
 
         for k, v in el.attrs.items():
             yield k, cls.normalize_value(v)
 
     @classmethod
-    def get_classes(cls, el: 'bs4.Tag') -> Sequence[str]:
+    def get_classes(cls, el: bs4.Tag) -> Sequence[str]:
         """Get classes."""
 
         classes = cls.get_attribute_by_name(el, 'class', [])
@@ -362,14 +363,14 @@ class _DocumentNav:
             classes = RE_NOT_WS.findall(classes)
         return cast(Sequence[str], classes)
 
-    def get_text(self, el: 'bs4.Tag', no_iframe: bool = False) -> str:
+    def get_text(self, el: bs4.Tag, no_iframe: bool = False) -> str:
         """Get text."""
 
         return ''.join(
             [node for node in self.get_descendants(el, tags=False, no_iframe=no_iframe) if self.is_content_string(node)]
         )
 
-    def get_own_text(self, el: 'bs4.Tag', no_iframe: bool = False) -> List[str]:
+    def get_own_text(self, el: bs4.Tag, no_iframe: bool = False) -> list[str]:
         """Get Own Text."""
 
         return [node for node in self.get_contents(el, no_iframe=no_iframe) if self.is_content_string(node)]
@@ -423,10 +424,10 @@ class Inputs:
         return 0 <= minutes <= 59
 
     @classmethod
-    def parse_value(cls, itype: str, value: Optional[str]) -> Optional[Tuple[float, ...]]:
+    def parse_value(cls, itype: str, value: Optional[str]) -> Optional[tuple[float, ...]]:
         """Parse the input value."""
 
-        parsed = None  # type: Optional[Tuple[float, ...]]
+        parsed = None  # type: Optional[tuple[float, ...]]
         if value is None:
             return value
         if itype == "date":
@@ -484,7 +485,7 @@ class CSSMatch(_DocumentNav):
     def __init__(
         self,
         selectors: ct.SelectorList,
-        scope: 'bs4.Tag',
+        scope: bs4.Tag,
         namespaces: Optional[ct.Namespaces],
         flags: int
     ) -> None:
@@ -492,11 +493,11 @@ class CSSMatch(_DocumentNav):
 
         self.assert_valid_input(scope)
         self.tag = scope
-        self.cached_meta_lang = []  # type: List[Tuple[str, str]]
-        self.cached_default_forms = []  # type: List[Tuple['bs4.Tag', 'bs4.Tag']]
-        self.cached_indeterminate_forms = []  # type: List[Tuple['bs4.Tag', str, bool]]
+        self.cached_meta_lang = []  # type: list[tuple[str, str]]
+        self.cached_default_forms = []  # type: list[tuple[bs4.Tag, bs4.Tag]]
+        self.cached_indeterminate_forms = []  # type: list[tuple[bs4.Tag, str, bool]]
         self.selectors = selectors
-        self.namespaces = {} if namespaces is None else namespaces  # type: Union[ct.Namespaces, Dict[str, str]]
+        self.namespaces = {} if namespaces is None else namespaces  # type: ct.Namespaces | dict[str, str]
         self.flags = flags
         self.iframe_restrict = False
 
@@ -527,7 +528,7 @@ class CSSMatch(_DocumentNav):
 
         return self.is_xml or self.has_html_namespace
 
-    def get_tag_ns(self, el: 'bs4.Tag') -> str:
+    def get_tag_ns(self, el: bs4.Tag) -> str:
         """Get tag namespace."""
 
         if self.supports_namespaces():
@@ -539,24 +540,24 @@ class CSSMatch(_DocumentNav):
             namespace = NS_XHTML
         return namespace
 
-    def is_html_tag(self, el: 'bs4.Tag') -> bool:
+    def is_html_tag(self, el: bs4.Tag) -> bool:
         """Check if tag is in HTML namespace."""
 
         return self.get_tag_ns(el) == NS_XHTML
 
-    def get_tag(self, el: 'bs4.Tag') -> Optional[str]:
+    def get_tag(self, el: bs4.Tag) -> Optional[str]:
         """Get tag."""
 
         name = self.get_tag_name(el)
         return util.lower(name) if name is not None and not self.is_xml else name
 
-    def get_prefix(self, el: 'bs4.Tag') -> Optional[str]:
+    def get_prefix(self, el: bs4.Tag) -> Optional[str]:
         """Get prefix."""
 
         prefix = self.get_prefix_name(el)
         return util.lower(prefix) if prefix is not None and not self.is_xml else prefix
 
-    def find_bidi(self, el: 'bs4.Tag') -> Optional[int]:
+    def find_bidi(self, el: bs4.Tag) -> Optional[int]:
         """Get directionality from element text."""
 
         for node in self.get_children(el, tags=False):
@@ -600,13 +601,18 @@ class CSSMatch(_DocumentNav):
         ranges = lang_range.split('-')
         subtags = lang_tag.lower().split('-')
         length = len(ranges)
+        slength = len(subtags)
         rindex = 0
         sindex = 0
         r = ranges[rindex]
         s = subtags[sindex]
 
+        # Empty specified language should match unspecified language attributes
+        if length == 1 and slength == 1 and not r and r == s:
+            return True
+
         # Primary tag needs to match
-        if r != '*' and r != s:
+        if (r != '*' and r != s) or (r == '*' and slength == 1 and not s):
             match = False
 
         rindex += 1
@@ -645,10 +651,10 @@ class CSSMatch(_DocumentNav):
 
     def match_attribute_name(
         self,
-        el: 'bs4.Tag',
+        el: bs4.Tag,
         attr: str,
         prefix: Optional[str]
-    ) -> Optional[Union[str, Sequence[str]]]:
+    ) -> Optional[str | Sequence[str]]:
         """Match attribute name and return value if it exists."""
 
         value = None
@@ -696,7 +702,7 @@ class CSSMatch(_DocumentNav):
                 break
         return value
 
-    def match_namespace(self, el: 'bs4.Tag', tag: ct.SelectorTag) -> bool:
+    def match_namespace(self, el: bs4.Tag, tag: ct.SelectorTag) -> bool:
         """Match the namespace of the element."""
 
         match = True
@@ -717,7 +723,7 @@ class CSSMatch(_DocumentNav):
             match = False
         return match
 
-    def match_attributes(self, el: 'bs4.Tag', attributes: Tuple[ct.SelectorAttribute, ...]) -> bool:
+    def match_attributes(self, el: bs4.Tag, attributes: tuple[ct.SelectorAttribute, ...]) -> bool:
         """Match attributes."""
 
         match = True
@@ -736,7 +742,7 @@ class CSSMatch(_DocumentNav):
                     break
         return match
 
-    def match_tagname(self, el: 'bs4.Tag', tag: ct.SelectorTag) -> bool:
+    def match_tagname(self, el: bs4.Tag, tag: ct.SelectorTag) -> bool:
         """Match tag name."""
 
         name = (util.lower(tag.name) if not self.is_xml and tag.name is not None else tag.name)
@@ -745,7 +751,7 @@ class CSSMatch(_DocumentNav):
             name not in (self.get_tag(el), '*')
         )
 
-    def match_tag(self, el: 'bs4.Tag', tag: Optional[ct.SelectorTag]) -> bool:
+    def match_tag(self, el: bs4.Tag, tag: Optional[ct.SelectorTag]) -> bool:
         """Match the tag."""
 
         match = True
@@ -757,7 +763,7 @@ class CSSMatch(_DocumentNav):
                 match = False
         return match
 
-    def match_past_relations(self, el: 'bs4.Tag', relation: ct.SelectorList) -> bool:
+    def match_past_relations(self, el: bs4.Tag, relation: ct.SelectorList) -> bool:
         """Match past relationship."""
 
         found = False
@@ -785,12 +791,12 @@ class CSSMatch(_DocumentNav):
                 found = self.match_selectors(sibling, relation)
         return found
 
-    def match_future_child(self, parent: 'bs4.Tag', relation: ct.SelectorList, recursive: bool = False) -> bool:
+    def match_future_child(self, parent: bs4.Tag, relation: ct.SelectorList, recursive: bool = False) -> bool:
         """Match future child."""
 
         match = False
         if recursive:
-            children = self.get_descendants  # type: Callable[..., Iterator['bs4.Tag']]
+            children = self.get_descendants  # type: Callable[..., Iterator[bs4.Tag]]
         else:
             children = self.get_children
         for child in children(parent, no_iframe=self.iframe_restrict):
@@ -799,7 +805,7 @@ class CSSMatch(_DocumentNav):
                 break
         return match
 
-    def match_future_relations(self, el: 'bs4.Tag', relation: ct.SelectorList) -> bool:
+    def match_future_relations(self, el: bs4.Tag, relation: ct.SelectorList) -> bool:
         """Match future relationship."""
 
         found = False
@@ -822,7 +828,7 @@ class CSSMatch(_DocumentNav):
                 found = self.match_selectors(sibling, relation)
         return found
 
-    def match_relations(self, el: 'bs4.Tag', relation: ct.SelectorList) -> bool:
+    def match_relations(self, el: bs4.Tag, relation: ct.SelectorList) -> bool:
         """Match relationship to other elements."""
 
         found = False
@@ -837,7 +843,7 @@ class CSSMatch(_DocumentNav):
 
         return found
 
-    def match_id(self, el: 'bs4.Tag', ids: Tuple[str, ...]) -> bool:
+    def match_id(self, el: bs4.Tag, ids: tuple[str, ...]) -> bool:
         """Match element's ID."""
 
         found = True
@@ -847,7 +853,7 @@ class CSSMatch(_DocumentNav):
                 break
         return found
 
-    def match_classes(self, el: 'bs4.Tag', classes: Tuple[str, ...]) -> bool:
+    def match_classes(self, el: bs4.Tag, classes: tuple[str, ...]) -> bool:
         """Match element's classes."""
 
         current_classes = self.get_classes(el)
@@ -858,7 +864,7 @@ class CSSMatch(_DocumentNav):
                 break
         return found
 
-    def match_root(self, el: 'bs4.Tag') -> bool:
+    def match_root(self, el: bs4.Tag) -> bool:
         """Match element as root."""
 
         is_root = self.is_root(el)
@@ -884,20 +890,20 @@ class CSSMatch(_DocumentNav):
                     sibling = self.get_next(sibling, tags=False)
         return is_root
 
-    def match_scope(self, el: 'bs4.Tag') -> bool:
+    def match_scope(self, el: bs4.Tag) -> bool:
         """Match element as scope."""
 
         return self.scope is el
 
-    def match_nth_tag_type(self, el: 'bs4.Tag', child: 'bs4.Tag') -> bool:
+    def match_nth_tag_type(self, el: bs4.Tag, child: bs4.Tag) -> bool:
         """Match tag type for `nth` matches."""
 
-        return(
+        return (
             (self.get_tag(child) == self.get_tag(el)) and
             (self.get_tag_ns(child) == self.get_tag_ns(el))
         )
 
-    def match_nth(self, el: 'bs4.Tag', nth: 'bs4.Tag') -> bool:
+    def match_nth(self, el: bs4.Tag, nth: bs4.Tag) -> bool:
         """Match `nth` elements."""
 
         matched = True
@@ -998,7 +1004,7 @@ class CSSMatch(_DocumentNav):
                 break
         return matched
 
-    def match_empty(self, el: 'bs4.Tag') -> bool:
+    def match_empty(self, el: bs4.Tag) -> bool:
         """Check if element is empty (if requested)."""
 
         is_empty = True
@@ -1011,7 +1017,7 @@ class CSSMatch(_DocumentNav):
                 break
         return is_empty
 
-    def match_subselectors(self, el: 'bs4.Tag', selectors: Tuple[ct.SelectorList, ...]) -> bool:
+    def match_subselectors(self, el: bs4.Tag, selectors: tuple[ct.SelectorList, ...]) -> bool:
         """Match selectors."""
 
         match = True
@@ -1020,11 +1026,11 @@ class CSSMatch(_DocumentNav):
                 match = False
         return match
 
-    def match_contains(self, el: 'bs4.Tag', contains: Tuple[ct.SelectorContains, ...]) -> bool:
+    def match_contains(self, el: bs4.Tag, contains: tuple[ct.SelectorContains, ...]) -> bool:
         """Match element if it contains text."""
 
         match = True
-        content = None  # type: Optional[Union[str, Sequence[str]]]
+        content = None  # type: Optional[str | Sequence[str]]
         for contain_list in contains:
             if content is None:
                 if contain_list.own:
@@ -1048,7 +1054,7 @@ class CSSMatch(_DocumentNav):
                 match = False
         return match
 
-    def match_default(self, el: 'bs4.Tag') -> bool:
+    def match_default(self, el: bs4.Tag) -> bool:
         """Match default."""
 
         match = False
@@ -1087,13 +1093,13 @@ class CSSMatch(_DocumentNav):
                         break
         return match
 
-    def match_indeterminate(self, el: 'bs4.Tag') -> bool:
+    def match_indeterminate(self, el: bs4.Tag) -> bool:
         """Match default."""
 
         match = False
         name = cast(str, self.get_attribute_by_name(el, 'name'))
 
-        def get_parent_form(el: 'bs4.Tag') -> Optional['bs4.Tag']:
+        def get_parent_form(el: bs4.Tag) -> Optional[bs4.Tag]:
             """Find this input's form."""
             form = None
             parent = self.get_parent(el, no_iframe=True)
@@ -1148,7 +1154,7 @@ class CSSMatch(_DocumentNav):
 
         return match
 
-    def match_lang(self, el: 'bs4.Tag', langs: Tuple[ct.SelectorLang, ...]) -> bool:
+    def match_lang(self, el: bs4.Tag, langs: tuple[ct.SelectorLang, ...]) -> bool:
         """Match languages."""
 
         match = False
@@ -1183,7 +1189,7 @@ class CSSMatch(_DocumentNav):
                 break
 
         # Use cached meta language.
-        if not found_lang and self.cached_meta_lang:
+        if found_lang is None and self.cached_meta_lang:
             for cache in self.cached_meta_lang:
                 if root is cache[0]:
                     found_lang = cache[1]
@@ -1217,13 +1223,13 @@ class CSSMatch(_DocumentNav):
                                 found_lang = content
                                 self.cached_meta_lang.append((cast(str, root), cast(str, found_lang)))
                                 break
-                    if found_lang:
+                    if found_lang is not None:
                         break
-                if not found_lang:
+                if found_lang is None:
                     self.cached_meta_lang.append((cast(str, root), ''))
 
         # If we determined a language, compare.
-        if found_lang:
+        if found_lang is not None:
             for patterns in langs:
                 match = False
                 for pattern in patterns:
@@ -1234,7 +1240,7 @@ class CSSMatch(_DocumentNav):
 
         return match
 
-    def match_dir(self, el: 'bs4.Tag', directionality: int) -> bool:
+    def match_dir(self, el: bs4.Tag, directionality: int) -> bool:
         """Check directionality."""
 
         # If we have to match both left and right, we can't match either.
@@ -1297,7 +1303,7 @@ class CSSMatch(_DocumentNav):
         # Match parents direction
         return self.match_dir(self.get_parent(el, no_iframe=True), directionality)
 
-    def match_range(self, el: 'bs4.Tag', condition: int) -> bool:
+    def match_range(self, el: bs4.Tag, condition: int) -> bool:
         """
         Match range.
 
@@ -1337,7 +1343,7 @@ class CSSMatch(_DocumentNav):
 
         return not out_of_range if condition & ct.SEL_IN_RANGE else out_of_range
 
-    def match_defined(self, el: 'bs4.Tag') -> bool:
+    def match_defined(self, el: bs4.Tag) -> bool:
         """
         Match defined.
 
@@ -1360,7 +1366,7 @@ class CSSMatch(_DocumentNav):
             )
         )
 
-    def match_placeholder_shown(self, el: 'bs4.Tag') -> bool:
+    def match_placeholder_shown(self, el: bs4.Tag) -> bool:
         """
         Match placeholder shown according to HTML spec.
 
@@ -1375,7 +1381,7 @@ class CSSMatch(_DocumentNav):
 
         return match
 
-    def match_selectors(self, el: 'bs4.Tag', selectors: ct.SelectorList) -> bool:
+    def match_selectors(self, el: bs4.Tag, selectors: ct.SelectorList) -> bool:
         """Check if element matches one of the selectors."""
 
         match = False
@@ -1459,7 +1465,7 @@ class CSSMatch(_DocumentNav):
 
         return match
 
-    def select(self, limit: int = 0) -> Iterator['bs4.Tag']:
+    def select(self, limit: int = 0) -> Iterator[bs4.Tag]:
         """Match all tags under the targeted tag."""
 
         lim = None if limit < 1 else limit
@@ -1472,7 +1478,7 @@ class CSSMatch(_DocumentNav):
                     if lim < 1:
                         break
 
-    def closest(self) -> Optional['bs4.Tag']:
+    def closest(self) -> Optional[bs4.Tag]:
         """Match closest ancestor."""
 
         current = self.tag
@@ -1484,12 +1490,12 @@ class CSSMatch(_DocumentNav):
                 current = self.get_parent(current)
         return closest
 
-    def filter(self) -> List['bs4.Tag']:  # noqa A001
+    def filter(self) -> list[bs4.Tag]:  # noqa A001
         """Filter tag's children."""
 
         return [tag for tag in self.get_contents(self.tag) if not self.is_navigable_string(tag) and self.match(tag)]
 
-    def match(self, el: 'bs4.Tag') -> bool:
+    def match(self, el: bs4.Tag) -> bool:
         """Match."""
 
         return not self.is_doc(el) and self.is_tag(el) and self.match_selectors(el, self.selectors)
@@ -1501,7 +1507,7 @@ class SoupSieve(ct.Immutable):
     pattern: str
     selectors: ct.SelectorList
     namespaces: Optional[ct.Namespaces]
-    custom: Dict[str, str]
+    custom: dict[str, str]
     flags: int
 
     __slots__ = ("pattern", "selectors", "namespaces", "custom", "flags", "_hash")
@@ -1524,17 +1530,17 @@ class SoupSieve(ct.Immutable):
             flags=flags
         )
 
-    def match(self, tag: 'bs4.Tag') -> bool:
+    def match(self, tag: bs4.Tag) -> bool:
         """Match."""
 
         return CSSMatch(self.selectors, tag, self.namespaces, self.flags).match(tag)
 
-    def closest(self, tag: 'bs4.Tag') -> 'bs4.Tag':
+    def closest(self, tag: bs4.Tag) -> bs4.Tag:
         """Match closest ancestor."""
 
         return CSSMatch(self.selectors, tag, self.namespaces, self.flags).closest()
 
-    def filter(self, iterable: Iterable['bs4.Tag']) -> List['bs4.Tag']:  # noqa A001
+    def filter(self, iterable: Iterable[bs4.Tag]) -> list[bs4.Tag]:  # noqa A001
         """
         Filter.
 
@@ -1551,18 +1557,18 @@ class SoupSieve(ct.Immutable):
         else:
             return [node for node in iterable if not CSSMatch.is_navigable_string(node) and self.match(node)]
 
-    def select_one(self, tag: 'bs4.Tag') -> 'bs4.Tag':
+    def select_one(self, tag: bs4.Tag) -> bs4.Tag:
         """Select a single tag."""
 
         tags = self.select(tag, limit=1)
         return tags[0] if tags else None
 
-    def select(self, tag: 'bs4.Tag', limit: int = 0) -> List['bs4.Tag']:
+    def select(self, tag: bs4.Tag, limit: int = 0) -> list[bs4.Tag]:
         """Select the specified tags."""
 
         return list(self.iselect(tag, limit))
 
-    def iselect(self, tag: 'bs4.Tag', limit: int = 0) -> Iterator['bs4.Tag']:
+    def iselect(self, tag: bs4.Tag, limit: int = 0) -> Iterator[bs4.Tag]:
         """Iterate the specified tags."""
 
         for el in CSSMatch(self.selectors, tag, self.namespaces, self.flags).select(limit):
diff --git a/lib/soupsieve/css_parser.py b/lib/soupsieve/css_parser.py
index d77084d4..4b8db186 100644
--- a/lib/soupsieve/css_parser.py
+++ b/lib/soupsieve/css_parser.py
@@ -1,4 +1,5 @@
 """CSS selector parser."""
+from __future__ import annotations
 import re
 from functools import lru_cache
 from . import util
@@ -6,7 +7,7 @@ from . import css_match as cm
 from . import css_types as ct
 from .util import SelectorSyntaxError
 import warnings
-from typing import Optional, Dict, Match, Tuple, Type, Any, List, Union, Iterator, cast
+from typing import Optional, Match, Any, Iterator, cast
 
 UNICODE_REPLACEMENT_CHAR = 0xFFFD
 
@@ -232,7 +233,7 @@ def _purge_cache() -> None:
     _cached_css_compile.cache_clear()
 
 
-def process_custom(custom: Optional[ct.CustomSelectors]) -> Dict[str, Union[str, ct.SelectorList]]:
+def process_custom(custom: Optional[ct.CustomSelectors]) -> dict[str, str | ct.SelectorList]:
     """Process custom."""
 
     custom_selectors = {}
@@ -325,7 +326,7 @@ class SelectorPattern:
 class SpecialPseudoPattern(SelectorPattern):
     """Selector pattern."""
 
-    def __init__(self, patterns: Tuple[Tuple[str, Tuple[str, ...], str, Type[SelectorPattern]], ...]) -> None:
+    def __init__(self, patterns: tuple[tuple[str, tuple[str, ...], str, type[SelectorPattern]], ...]) -> None:
         """Initialize."""
 
         self.patterns = {}
@@ -372,19 +373,19 @@ class _Selector:
         """Initialize."""
 
         self.tag = kwargs.get('tag', None)  # type: Optional[ct.SelectorTag]
-        self.ids = kwargs.get('ids', [])  # type: List[str]
-        self.classes = kwargs.get('classes', [])  # type: List[str]
-        self.attributes = kwargs.get('attributes', [])  # type: List[ct.SelectorAttribute]
-        self.nth = kwargs.get('nth', [])  # type: List[ct.SelectorNth]
-        self.selectors = kwargs.get('selectors', [])  # type: List[ct.SelectorList]
-        self.relations = kwargs.get('relations', [])  # type: List[_Selector]
+        self.ids = kwargs.get('ids', [])  # type: list[str]
+        self.classes = kwargs.get('classes', [])  # type: list[str]
+        self.attributes = kwargs.get('attributes', [])  # type: list[ct.SelectorAttribute]
+        self.nth = kwargs.get('nth', [])  # type: list[ct.SelectorNth]
+        self.selectors = kwargs.get('selectors', [])  # type: list[ct.SelectorList]
+        self.relations = kwargs.get('relations', [])  # type: list[_Selector]
         self.rel_type = kwargs.get('rel_type', None)  # type: Optional[str]
-        self.contains = kwargs.get('contains', [])  # type: List[ct.SelectorContains]
-        self.lang = kwargs.get('lang', [])  # type: List[ct.SelectorLang]
+        self.contains = kwargs.get('contains', [])  # type: list[ct.SelectorContains]
+        self.lang = kwargs.get('lang', [])  # type: list[ct.SelectorLang]
         self.flags = kwargs.get('flags', 0)  # type: int
         self.no_match = kwargs.get('no_match', False)  # type: bool
 
-    def _freeze_relations(self, relations: List['_Selector']) -> ct.SelectorList:
+    def _freeze_relations(self, relations: list[_Selector]) -> ct.SelectorList:
         """Freeze relation."""
 
         if relations:
@@ -394,7 +395,7 @@ class _Selector:
         else:
             return ct.SelectorList()
 
-    def freeze(self) -> Union[ct.Selector, ct.SelectorNull]:
+    def freeze(self) -> ct.Selector | ct.SelectorNull:
         """Freeze self."""
 
         if self.no_match:
@@ -461,7 +462,7 @@ class CSSParser:
     def __init__(
         self,
         selector: str,
-        custom: Optional[Dict[str, Union[str, ct.SelectorList]]] = None,
+        custom: Optional[dict[str, str | ct.SelectorList]] = None,
         flags: int = 0
     ) -> None:
         """Initialize."""
@@ -583,9 +584,9 @@ class CSSParser:
         sel: _Selector,
         m: Match[str],
         has_selector: bool,
-        iselector: Iterator[Tuple[str, Match[str]]],
+        iselector: Iterator[tuple[str, Match[str]]],
         is_html: bool
-    ) -> Tuple[bool, bool]:
+    ) -> tuple[bool, bool]:
         """Parse pseudo class."""
 
         complex_pseudo = False
@@ -678,7 +679,7 @@ class CSSParser:
         sel: _Selector,
         m: Match[str],
         has_selector: bool,
-        iselector: Iterator[Tuple[str, Match[str]]]
+        iselector: Iterator[tuple[str, Match[str]]]
     ) -> bool:
         """Parse `nth` pseudo."""
 
@@ -743,7 +744,7 @@ class CSSParser:
         sel: _Selector,
         name: str,
         has_selector: bool,
-        iselector: Iterator[Tuple[str, Match[str]]],
+        iselector: Iterator[tuple[str, Match[str]]],
         index: int
     ) -> bool:
         """Parse pseudo with opening bracket."""
@@ -752,7 +753,7 @@ class CSSParser:
         if name == ':not':
             flags |= FLG_NOT
         elif name == ':has':
-            flags |= FLG_RELATIVE | FLG_FORGIVE
+            flags |= FLG_RELATIVE
         elif name in (':where', ':is'):
             flags |= FLG_FORGIVE
 
@@ -766,21 +767,16 @@ class CSSParser:
         sel: _Selector,
         m: Match[str],
         has_selector: bool,
-        selectors: List[_Selector],
+        selectors: list[_Selector],
         rel_type: str,
         index: int
-    ) -> Tuple[bool, _Selector, str]:
+    ) -> tuple[bool, _Selector, str]:
         """Parse combinator tokens."""
 
         combinator = m.group('relation').strip()
         if not combinator:
             combinator = WS_COMBINATOR
         if combinator == COMMA_COMBINATOR:
-            if not has_selector:
-                # If we've not captured any selector parts, the comma is either at the beginning of the pattern
-                # or following another comma, both of which are unexpected. But shouldn't fail the pseudo-class.
-                sel.no_match = True
-
             sel.rel_type = rel_type
             selectors[-1].relations.append(sel)
             rel_type = ":" + WS_COMBINATOR
@@ -814,12 +810,12 @@ class CSSParser:
         sel: _Selector,
         m: Match[str],
         has_selector: bool,
-        selectors: List[_Selector],
-        relations: List[_Selector],
+        selectors: list[_Selector],
+        relations: list[_Selector],
         is_pseudo: bool,
         is_forgive: bool,
         index: int
-    ) -> Tuple[bool, _Selector]:
+    ) -> tuple[bool, _Selector]:
         """Parse combinator tokens."""
 
         combinator = m.group('relation').strip()
@@ -924,7 +920,7 @@ class CSSParser:
 
     def parse_selectors(
         self,
-        iselector: Iterator[Tuple[str, Match[str]]],
+        iselector: Iterator[tuple[str, Match[str]]],
         index: int = 0,
         flags: int = 0
     ) -> ct.SelectorList:
@@ -935,7 +931,7 @@ class CSSParser:
         selectors = []
         has_selector = False
         closed = False
-        relations = []  # type: List[_Selector]
+        relations = []  # type: list[_Selector]
         rel_type = ":" + WS_COMBINATOR
 
         # Setup various flags
@@ -1069,22 +1065,12 @@ class CSSParser:
                 selectors.append(sel)
 
         # Forgive empty slots in pseudo-classes that have lists (and are forgiving)
-        elif is_forgive:
-            if is_relative:
-                # Handle relative selectors pseudo-classes with empty slots like `:has()`
-                if selectors and selectors[-1].rel_type is None and rel_type == ': ':
-                    sel.rel_type = rel_type
-                    sel.no_match = True
-                    selectors[-1].relations.append(sel)
-                    has_selector = True
-            else:
-                # Handle normal pseudo-classes with empty slots
-                if not selectors or not relations:
-                    # Others like `:is()` etc.
-                    sel.no_match = True
-                    del relations[:]
-                    selectors.append(sel)
-                    has_selector = True
+        elif is_forgive and (not selectors or not relations):
+            # Handle normal pseudo-classes with empty slots like `:is()` etc.
+            sel.no_match = True
+            del relations[:]
+            selectors.append(sel)
+            has_selector = True
 
         if not has_selector:
             # We will always need to finish a selector when `:has()` is used as it leads with combining.
@@ -1112,7 +1098,7 @@ class CSSParser:
         # Return selector list
         return ct.SelectorList([s.freeze() for s in selectors], is_not, is_html)
 
-    def selector_iter(self, pattern: str) -> Iterator[Tuple[str, Match[str]]]:
+    def selector_iter(self, pattern: str) -> Iterator[tuple[str, Match[str]]]:
         """Iterate selector tokens."""
 
         # Ignore whitespace and comments at start and end of pattern
diff --git a/lib/soupsieve/css_types.py b/lib/soupsieve/css_types.py
index e5a6e49c..a97d5f4b 100644
--- a/lib/soupsieve/css_types.py
+++ b/lib/soupsieve/css_types.py
@@ -1,7 +1,8 @@
 """CSS selector structure items."""
+from __future__ import annotations
 import copyreg
 from .pretty import pretty
-from typing import Any, Type, Tuple, Union, Dict, Iterator, Hashable, Optional, Pattern, Iterable, Mapping
+from typing import Any, Iterator, Hashable, Optional, Pattern, Iterable, Mapping
 
 __all__ = (
     'Selector',
@@ -33,7 +34,7 @@ SEL_PLACEHOLDER_SHOWN = 0x400
 class Immutable:
     """Immutable."""
 
-    __slots__: Tuple[str, ...] = ('_hash',)
+    __slots__: tuple[str, ...] = ('_hash',)
 
     _hash: int
 
@@ -48,7 +49,7 @@ class Immutable:
         super(Immutable, self).__setattr__('_hash', hash(tuple(temp)))
 
     @classmethod
-    def __base__(cls) -> "Type[Immutable]":
+    def __base__(cls) -> "type[Immutable]":
         """Get base class."""
 
         return cls
@@ -99,7 +100,7 @@ class ImmutableDict(Mapping[Any, Any]):
 
     def __init__(
         self,
-        arg: Union[Dict[Any, Any], Iterable[Tuple[Any, Any]]]
+        arg: dict[Any, Any] | Iterable[tuple[Any, Any]]
     ) -> None:
         """Initialize."""
 
@@ -107,7 +108,7 @@ class ImmutableDict(Mapping[Any, Any]):
         self._d = dict(arg)
         self._hash = hash(tuple([(type(x), x, type(y), y) for x, y in sorted(self._d.items())]))
 
-    def _validate(self, arg: Union[Dict[Any, Any], Iterable[Tuple[Any, Any]]]) -> None:
+    def _validate(self, arg: dict[Any, Any] | Iterable[tuple[Any, Any]]) -> None:
         """Validate arguments."""
 
         if isinstance(arg, dict):
@@ -147,12 +148,12 @@ class ImmutableDict(Mapping[Any, Any]):
 class Namespaces(ImmutableDict):
     """Namespaces."""
 
-    def __init__(self, arg: Union[Dict[str, str], Iterable[Tuple[str, str]]]) -> None:
+    def __init__(self, arg: dict[str, str] | Iterable[tuple[str, str]]) -> None:
         """Initialize."""
 
         super().__init__(arg)
 
-    def _validate(self, arg: Union[Dict[str, str], Iterable[Tuple[str, str]]]) -> None:
+    def _validate(self, arg: dict[str, str] | Iterable[tuple[str, str]]) -> None:
         """Validate arguments."""
 
         if isinstance(arg, dict):
@@ -165,12 +166,12 @@ class Namespaces(ImmutableDict):
 class CustomSelectors(ImmutableDict):
     """Custom selectors."""
 
-    def __init__(self, arg: Union[Dict[str, str], Iterable[Tuple[str, str]]]) -> None:
+    def __init__(self, arg: dict[str, str] | Iterable[tuple[str, str]]) -> None:
         """Initialize."""
 
         super().__init__(arg)
 
-    def _validate(self, arg: Union[Dict[str, str], Iterable[Tuple[str, str]]]) -> None:
+    def _validate(self, arg: dict[str, str] | Iterable[tuple[str, str]]) -> None:
         """Validate arguments."""
 
         if isinstance(arg, dict):
@@ -188,30 +189,30 @@ class Selector(Immutable):
         'relation', 'rel_type', 'contains', 'lang', 'flags', '_hash'
     )
 
-    tag: Optional['SelectorTag']
-    ids: Tuple[str, ...]
-    classes: Tuple[str, ...]
-    attributes: Tuple['SelectorAttribute', ...]
-    nth: Tuple['SelectorNth', ...]
-    selectors: Tuple['SelectorList', ...]
-    relation: 'SelectorList'
+    tag: Optional[SelectorTag]
+    ids: tuple[str, ...]
+    classes: tuple[str, ...]
+    attributes: tuple[SelectorAttribute, ...]
+    nth: tuple[SelectorNth, ...]
+    selectors: tuple[SelectorList, ...]
+    relation: SelectorList
     rel_type: Optional[str]
-    contains: Tuple['SelectorContains', ...]
-    lang: Tuple['SelectorLang', ...]
+    contains: tuple[SelectorContains, ...]
+    lang: tuple[SelectorLang, ...]
     flags: int
 
     def __init__(
         self,
-        tag: Optional['SelectorTag'],
-        ids: Tuple[str, ...],
-        classes: Tuple[str, ...],
-        attributes: Tuple['SelectorAttribute', ...],
-        nth: Tuple['SelectorNth', ...],
-        selectors: Tuple['SelectorList', ...],
-        relation: 'SelectorList',
+        tag: Optional[SelectorTag],
+        ids: tuple[str, ...],
+        classes: tuple[str, ...],
+        attributes: tuple[SelectorAttribute, ...],
+        nth: tuple[SelectorNth, ...],
+        selectors: tuple[SelectorList, ...],
+        relation: SelectorList,
         rel_type: Optional[str],
-        contains: Tuple['SelectorContains', ...],
-        lang: Tuple['SelectorLang', ...],
+        contains: tuple[SelectorContains, ...],
+        lang: tuple[SelectorLang, ...],
         flags: int
     ):
         """Initialize."""
@@ -286,7 +287,7 @@ class SelectorContains(Immutable):
 
     __slots__ = ("text", "own", "_hash")
 
-    text: Tuple[str, ...]
+    text: tuple[str, ...]
     own: bool
 
     def __init__(self, text: Iterable[str], own: bool) -> None:
@@ -305,9 +306,9 @@ class SelectorNth(Immutable):
     b: int
     of_type: bool
     last: bool
-    selectors: 'SelectorList'
+    selectors: SelectorList
 
-    def __init__(self, a: int, n: bool, b: int, of_type: bool, last: bool, selectors: 'SelectorList') -> None:
+    def __init__(self, a: int, n: bool, b: int, of_type: bool, last: bool, selectors: SelectorList) -> None:
         """Initialize."""
 
         super().__init__(
@@ -325,7 +326,7 @@ class SelectorLang(Immutable):
 
     __slots__ = ("languages", "_hash",)
 
-    languages: Tuple[str, ...]
+    languages: tuple[str, ...]
 
     def __init__(self, languages: Iterable[str]):
         """Initialize."""
@@ -353,13 +354,13 @@ class SelectorList(Immutable):
 
     __slots__ = ("selectors", "is_not", "is_html", "_hash")
 
-    selectors: Tuple[Union['Selector', 'SelectorNull'], ...]
+    selectors: tuple[Selector | SelectorNull, ...]
     is_not: bool
     is_html: bool
 
     def __init__(
         self,
-        selectors: Optional[Iterable[Union['Selector', 'SelectorNull']]] = None,
+        selectors: Optional[Iterable[Selector | SelectorNull]] = None,
         is_not: bool = False,
         is_html: bool = False
     ) -> None:
@@ -371,7 +372,7 @@ class SelectorList(Immutable):
             is_html=is_html
         )
 
-    def __iter__(self) -> Iterator[Union['Selector', 'SelectorNull']]:
+    def __iter__(self) -> Iterator[Selector | SelectorNull]:
         """Iterator."""
 
         return iter(self.selectors)
@@ -381,7 +382,7 @@ class SelectorList(Immutable):
 
         return len(self.selectors)
 
-    def __getitem__(self, index: int) -> Union['Selector', 'SelectorNull']:
+    def __getitem__(self, index: int) -> Selector | SelectorNull:
         """Get item."""
 
         return self.selectors[index]
diff --git a/lib/soupsieve/pretty.py b/lib/soupsieve/pretty.py
index 57d16c97..f848d5e2 100644
--- a/lib/soupsieve/pretty.py
+++ b/lib/soupsieve/pretty.py
@@ -65,6 +65,7 @@ SelectorList(
     is_html=False)
 ```
 """
+from __future__ import annotations
 import re
 from typing import Any
 
diff --git a/lib/soupsieve/util.py b/lib/soupsieve/util.py
index 2b1ed24b..cf4dc5cc 100644
--- a/lib/soupsieve/util.py
+++ b/lib/soupsieve/util.py
@@ -1,8 +1,9 @@
 """Utility."""
+from __future__ import annotations
 from functools import wraps, lru_cache
 import warnings
 import re
-from typing import Callable, Any, Optional, Tuple, List
+from typing import Callable, Any, Optional
 
 DEBUG = 0x00001
 
@@ -75,13 +76,13 @@ def warn_deprecated(message: str, stacklevel: int = 2) -> None:  # pragma: no co
     )
 
 
-def get_pattern_context(pattern: str, index: int) -> Tuple[str, int, int]:
+def get_pattern_context(pattern: str, index: int) -> tuple[str, int, int]:
     """Get the pattern context."""
 
     last = 0
     current_line = 1
     col = 1
-    text = []  # type: List[str]
+    text = []  # type: list[str]
     line = 1
     offset = None  # type: Optional[int]
 
diff --git a/requirements.txt b/requirements.txt
index 050b9add..b5e6dd57 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -4,7 +4,7 @@ arrow==1.2.3
 backports.csv==1.0.7
 backports.functools-lru-cache==1.6.4
 backports.zoneinfo==0.2.1;python_version<"3.9"
-beautifulsoup4==4.11.1
+beautifulsoup4==4.11.2
 bleach==6.0.0
 certifi==2022.12.7
 cheroot==9.0.0

From d0f3f96709d546ef947a5256efdfdb51c7441131 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 2 Mar 2023 20:56:39 -0800
Subject: [PATCH 349/743] Bump simplejson from 3.18.0 to 3.18.3 (#1992)

* Bump simplejson from 3.18.0 to 3.18.3

Bumps [simplejson](https://github.com/simplejson/simplejson) from 3.18.0 to 3.18.3.
- [Release notes](https://github.com/simplejson/simplejson/releases)
- [Changelog](https://github.com/simplejson/simplejson/blob/master/CHANGES.txt)
- [Commits](https://github.com/simplejson/simplejson/compare/v3.18.0...v3.18.3)

---
updated-dependencies:
- dependency-name: simplejson
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

* Update simplejson==3.18.3

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/simplejson/__init__.py | 2 +-
 lib/simplejson/encoder.py  | 1 +
 requirements.txt           | 2 +-
 3 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/lib/simplejson/__init__.py b/lib/simplejson/__init__.py
index c79ad1bc..993d64d3 100644
--- a/lib/simplejson/__init__.py
+++ b/lib/simplejson/__init__.py
@@ -118,7 +118,7 @@ Serializing multiple objects to JSON lines (newline-delimited JSON)::
 
 """
 from __future__ import absolute_import
-__version__ = '3.18.0'
+__version__ = '3.18.3'
 __all__ = [
     'dump', 'dumps', 'load', 'loads',
     'JSONDecoder', 'JSONDecodeError', 'JSONEncoder',
diff --git a/lib/simplejson/encoder.py b/lib/simplejson/encoder.py
index 2bc8bbad..e93fe43f 100644
--- a/lib/simplejson/encoder.py
+++ b/lib/simplejson/encoder.py
@@ -32,6 +32,7 @@ ESCAPE_DCT = {
 for i in range(0x20):
     #ESCAPE_DCT.setdefault(chr(i), '\\u{0:04x}'.format(i))
     ESCAPE_DCT.setdefault(chr(i), '\\u%04x' % (i,))
+del i
 
 FLOAT_REPR = repr
 
diff --git a/requirements.txt b/requirements.txt
index b5e6dd57..754a9e9c 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -39,7 +39,7 @@ pytz==2022.7.1
 requests==2.28.2
 requests-oauthlib==1.3.1
 rumps==0.4.0; platform_system == "Darwin"
-simplejson==3.18.0
+simplejson==3.18.3
 six==1.16.0
 soupsieve==2.3.2.post1
 tempora==5.2.1

From 66fa93cfaf43a2f0be62fe7a67f74e04004b0a65 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 2 Mar 2023 20:56:49 -0800
Subject: [PATCH 350/743] Bump websocket-client from 1.4.2 to 1.5.1 (#1993)

* Bump websocket-client from 1.4.2 to 1.5.1

Bumps [websocket-client](https://github.com/websocket-client/websocket-client) from 1.4.2 to 1.5.1.
- [Release notes](https://github.com/websocket-client/websocket-client/releases)
- [Changelog](https://github.com/websocket-client/websocket-client/blob/master/ChangeLog)
- [Commits](https://github.com/websocket-client/websocket-client/compare/v1.4.2...v1.5.1)

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

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

* Update websocket-client==1.5.1

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/websocket/__init__.py       |   2 +-
 lib/websocket/_app.py           | 110 +++++++++++++++++++++-----------
 lib/websocket/_socket.py        |   2 +-
 lib/websocket/tests/test_app.py |  99 ++++++++++++++++++++++++++--
 requirements.txt                |   2 +-
 5 files changed, 167 insertions(+), 48 deletions(-)

diff --git a/lib/websocket/__init__.py b/lib/websocket/__init__.py
index 588a8f21..a579342d 100644
--- a/lib/websocket/__init__.py
+++ b/lib/websocket/__init__.py
@@ -23,4 +23,4 @@ from ._exceptions import *
 from ._logging import *
 from ._socket import *
 
-__version__ = "1.4.2"
+__version__ = "1.5.1"
diff --git a/lib/websocket/_app.py b/lib/websocket/_app.py
index e0a88e2f..0a16ddb6 100644
--- a/lib/websocket/_app.py
+++ b/lib/websocket/_app.py
@@ -4,11 +4,12 @@ import sys
 import threading
 import time
 import traceback
+
+from . import _logging
 from ._abnf import ABNF
 from ._url import parse_url
 from ._core import WebSocket, getdefaulttimeout
 from ._exceptions import *
-from . import _logging
 
 """
 _app.py
@@ -53,10 +54,9 @@ class DispatcherBase:
 
     def reconnect(self, seconds, reconnector):
         try:
-            while True:
-                _logging.info("reconnect() - retrying in %s seconds [%s frames in stack]" % (seconds, len(inspect.stack())))
-                time.sleep(seconds)
-                reconnector(reconnecting=True)
+            _logging.info("reconnect() - retrying in %s seconds [%s frames in stack]" % (seconds, len(inspect.stack())))
+            time.sleep(seconds)
+            reconnector(reconnecting=True)
         except KeyboardInterrupt as e:
             _logging.info("User exited %s" % (e,))
 
@@ -214,6 +214,11 @@ class WebSocketApp:
         self.sock = None
         self.last_ping_tm = 0
         self.last_pong_tm = 0
+        self.ping_thread = None
+        self.stop_ping = None
+        self.ping_interval = 0
+        self.ping_timeout = None
+        self.ping_payload = ""
         self.subprotocols = subprotocols
         self.prepared_socket = socket
         self.has_errored = False
@@ -244,15 +249,31 @@ class WebSocketApp:
             self.sock.close(**kwargs)
             self.sock = None
 
-    def _send_ping(self, interval, event, payload):
-        while not event.wait(interval):
-            self.last_ping_tm = time.time()
+    def _start_ping_thread(self):
+        self.last_ping_tm = self.last_pong_tm = 0
+        self.stop_ping = threading.Event()
+        self.ping_thread = threading.Thread(target=self._send_ping)
+        self.ping_thread.daemon = True
+        self.ping_thread.start()
+
+    def _stop_ping_thread(self):
+        if self.stop_ping:
+            self.stop_ping.set()
+        if self.ping_thread and self.ping_thread.is_alive():
+            self.ping_thread.join(3)
+        self.last_ping_tm = self.last_pong_tm = 0
+
+    def _send_ping(self):
+        if self.stop_ping.wait(self.ping_interval):
+            return
+        while not self.stop_ping.wait(self.ping_interval):
             if self.sock:
+                self.last_ping_tm = time.time()
                 try:
-                    self.sock.ping(payload)
+                    _logging.debug("Sending ping")
+                    self.sock.ping(self.ping_payload)
                 except Exception as ex:
-                    _logging.warning("send_ping routine terminated: {}".format(ex))
-                    break
+                    _logging.debug("Failed to send ping: %s", ex)
 
     def run_forever(self, sockopt=None, sslopt=None,
                     ping_interval=0, ping_timeout=None,
@@ -331,10 +352,11 @@ class WebSocketApp:
             sslopt = {}
         if self.sock:
             raise WebSocketException("socket is already opened")
-        thread = None
+
+        self.ping_interval = ping_interval
+        self.ping_timeout = ping_timeout
+        self.ping_payload = ping_payload
         self.keep_running = True
-        self.last_ping_tm = 0
-        self.last_pong_tm = 0
 
         def teardown(close_frame=None):
             """
@@ -347,9 +369,7 @@ class WebSocketApp:
                 with the statusCode and reason from the provided frame.
             """
 
-            if thread and thread.is_alive():
-                event.set()
-                thread.join()
+            self._stop_ping_thread()
             self.keep_running = False
             if self.sock:
                 self.sock.close()
@@ -361,11 +381,15 @@ class WebSocketApp:
             self._callback(self.on_close, close_status_code, close_reason)
 
         def setSock(reconnecting=False):
+            if reconnecting and self.sock:
+                self.sock.shutdown()
+
             self.sock = WebSocket(
                 self.get_mask_key, sockopt=sockopt, sslopt=sslopt,
                 fire_cont_frame=self.on_cont_message is not None,
                 skip_utf8_validation=skip_utf8_validation,
                 enable_multithread=True)
+
             self.sock.settimeout(getdefaulttimeout())
             try:
                 self.sock.connect(
@@ -377,13 +401,16 @@ class WebSocketApp:
                     host=host, origin=origin, suppress_origin=suppress_origin,
                     proxy_type=proxy_type, socket=self.prepared_socket)
 
+                _logging.info("Websocket connected")
+
+                if self.ping_interval:
+                    self._start_ping_thread()
+
                 self._callback(self.on_open)
 
-                _logging.warning("websocket connected")
                 dispatcher.read(self.sock.sock, read, check)
             except (WebSocketConnectionClosedException, ConnectionRefusedError, KeyboardInterrupt, SystemExit, Exception) as e:
-                _logging.error("%s - %s" % (e, reconnect and "reconnecting" or "goodbye"))
-                reconnecting or handleDisconnect(e)
+                handleDisconnect(e, reconnecting)
 
         def read():
             if not self.keep_running:
@@ -396,6 +423,7 @@ class WebSocketApp:
                     return handleDisconnect(e)
                 else:
                     raise e
+
             if op_code == ABNF.OPCODE_CLOSE:
                 return teardown(frame)
             elif op_code == ABNF.OPCODE_PING:
@@ -410,7 +438,7 @@ class WebSocketApp:
                                frame.data, frame.fin)
             else:
                 data = frame.data
-                if op_code == ABNF.OPCODE_TEXT:
+                if op_code == ABNF.OPCODE_TEXT and not skip_utf8_validation:
                     data = data.decode("utf-8")
                 self._callback(self.on_data, data, frame.opcode, True)
                 self._callback(self.on_message, data)
@@ -418,10 +446,10 @@ class WebSocketApp:
             return True
 
         def check():
-            if (ping_timeout):
-                has_timeout_expired = time.time() - self.last_ping_tm > ping_timeout
+            if (self.ping_timeout):
+                has_timeout_expired = time.time() - self.last_ping_tm > self.ping_timeout
                 has_pong_not_arrived_after_last_ping = self.last_pong_tm - self.last_ping_tm < 0
-                has_pong_arrived_too_late = self.last_pong_tm - self.last_ping_tm > ping_timeout
+                has_pong_arrived_too_late = self.last_pong_tm - self.last_ping_tm > self.ping_timeout
 
                 if (self.last_ping_tm and
                         has_timeout_expired and
@@ -429,29 +457,35 @@ class WebSocketApp:
                     raise WebSocketTimeoutException("ping/pong timed out")
             return True
 
-        def handleDisconnect(e):
+        def handleDisconnect(e, reconnecting=False):
             self.has_errored = True
-            self._callback(self.on_error, e)
-            if isinstance(e, SystemExit):
-                # propagate SystemExit further
+            self._stop_ping_thread()
+            if not reconnecting:
+                self._callback(self.on_error, e)
+
+            if isinstance(e, (KeyboardInterrupt, SystemExit)):
+                teardown()
+                # Propagate further
                 raise
-            if reconnect and not isinstance(e, KeyboardInterrupt):
-                _logging.info("websocket disconnected (retrying in %s seconds) [%s frames in stack]" % (reconnect, len(inspect.stack())))
-                dispatcher.reconnect(reconnect, setSock)
+
+            if reconnect:
+                _logging.info("%s - reconnect" % e)
+                if custom_dispatcher:
+                    _logging.debug("Calling custom dispatcher reconnect [%s frames in stack]" % len(inspect.stack()))
+                    dispatcher.reconnect(reconnect, setSock)
             else:
+                _logging.error("%s - goodbye" % e)
                 teardown()
 
         custom_dispatcher = bool(dispatcher)
         dispatcher = self.create_dispatcher(ping_timeout, dispatcher, parse_url(self.url)[3])
 
-        if ping_interval:
-            event = threading.Event()
-            thread = threading.Thread(
-                target=self._send_ping, args=(ping_interval, event, ping_payload))
-            thread.daemon = True
-            thread.start()
-
         setSock()
+        if not custom_dispatcher and reconnect:
+            while self.keep_running:
+                _logging.debug("Calling dispatcher reconnect [%s frames in stack]" % len(inspect.stack()))
+                dispatcher.reconnect(reconnect, setSock)
+
         return self.has_errored
 
     def create_dispatcher(self, ping_timeout, dispatcher=None, is_ssl=False):
diff --git a/lib/websocket/_socket.py b/lib/websocket/_socket.py
index 54e63997..7cc02164 100644
--- a/lib/websocket/_socket.py
+++ b/lib/websocket/_socket.py
@@ -151,7 +151,7 @@ def send(sock, data):
             error_code = extract_error_code(exc)
             if error_code is None:
                 raise
-            if error_code != errno.EAGAIN or error_code != errno.EWOULDBLOCK:
+            if error_code != errno.EAGAIN and error_code != errno.EWOULDBLOCK:
                 raise
 
         sel = selectors.DefaultSelector()
diff --git a/lib/websocket/tests/test_app.py b/lib/websocket/tests/test_app.py
index 5526d3ec..ac563c6e 100644
--- a/lib/websocket/tests/test_app.py
+++ b/lib/websocket/tests/test_app.py
@@ -186,13 +186,13 @@ class WebSocketAppTest(unittest.TestCase):
         app = ws.WebSocketApp('wss://tsock.us1.twilio.com/v3/wsconnect')
         app.run_forever(ping_interval=2, ping_timeout=1, ping_payload="Ping payload")
 
-    @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled")
-    def testOpcodeBinary(self):
-        """ Test WebSocketApp binary opcode
-        """
-        # The lack of wss:// in the URL below is on purpose
-        app = ws.WebSocketApp('wss://streaming.vn.teslamotors.com/streaming/')
-        app.run_forever(ping_interval=2, ping_timeout=1, ping_payload="Ping payload")
+    # This is commented out because the URL no longer responds in the expected way
+    # @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled")
+    # def testOpcodeBinary(self):
+    #     """ Test WebSocketApp binary opcode
+    #     """
+    #     app = ws.WebSocketApp('wss://streaming.vn.teslamotors.com/streaming/')
+    #     app.run_forever(ping_interval=2, ping_timeout=1, ping_payload="Ping payload")
 
     @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled")
     def testBadPingInterval(self):
@@ -228,6 +228,91 @@ class WebSocketAppTest(unittest.TestCase):
 
         self.assertRaises(ws.WebSocketConnectionClosedException, app.send, data="test if connection is closed")
 
+    @unittest.skipUnless(TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled")
+    def testCallbackFunctionException(self):
+        """ Test callback function exception handling """
+
+        exc = None
+        passed_app = None
+
+        def on_open(app):
+            raise RuntimeError("Callback failed")
+
+        def on_error(app, err):
+            nonlocal passed_app
+            passed_app = app
+            nonlocal exc
+            exc = err
+
+        def on_pong(app, msg):
+            app.close()
+
+        app = ws.WebSocketApp('ws://127.0.0.1:' + LOCAL_WS_SERVER_PORT, on_open=on_open, on_error=on_error, on_pong=on_pong)
+        app.run_forever(ping_interval=2, ping_timeout=1)
+
+        self.assertEqual(passed_app, app)
+        self.assertIsInstance(exc, RuntimeError)
+        self.assertEqual(str(exc), "Callback failed")
+
+    @unittest.skipUnless(TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled")
+    def testCallbackMethodException(self):
+        """ Test callback method exception handling """
+
+        class Callbacks:
+            def __init__(self):
+                self.exc = None
+                self.passed_app = None
+                self.app = ws.WebSocketApp(
+                    'ws://127.0.0.1:' + LOCAL_WS_SERVER_PORT,
+                    on_open=self.on_open,
+                    on_error=self.on_error,
+                    on_pong=self.on_pong
+                )
+                self.app.run_forever(ping_interval=2, ping_timeout=1)
+
+            def on_open(self, app):
+                raise RuntimeError("Callback failed")
+
+            def on_error(self, app, err):
+                self.passed_app = app
+                self.exc = err
+
+            def on_pong(self, app, msg):
+                app.close()
+
+        callbacks = Callbacks()
+
+        self.assertEqual(callbacks.passed_app, callbacks.app)
+        self.assertIsInstance(callbacks.exc, RuntimeError)
+        self.assertEqual(str(callbacks.exc), "Callback failed")
+
+    @unittest.skipUnless(TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled")
+    def testReconnect(self):
+        """ Test reconnect """
+        pong_count = 0
+        exc = None
+
+        def on_error(app, err):
+            nonlocal exc
+            exc = err
+
+        def on_pong(app, msg):
+            nonlocal pong_count
+            pong_count += 1
+            if pong_count == 1:
+                # First pong, shutdown socket, enforce read error
+                app.sock.shutdown()
+            if pong_count >= 2:
+                # Got second pong after reconnect
+                app.close()
+
+        app = ws.WebSocketApp('ws://127.0.0.1:' + LOCAL_WS_SERVER_PORT, on_pong=on_pong, on_error=on_error)
+        app.run_forever(ping_interval=2, ping_timeout=1, reconnect=3)
+
+        self.assertEqual(pong_count, 2)
+        self.assertIsInstance(exc, ValueError)
+        self.assertEqual(str(exc), "Invalid file object: None")
+
 
 if __name__ == "__main__":
     unittest.main()
diff --git a/requirements.txt b/requirements.txt
index 754a9e9c..2e253ab7 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -48,7 +48,7 @@ tzdata==2022.7
 tzlocal==4.2
 urllib3==1.26.13
 webencodings==0.5.1
-websocket-client==1.4.2
+websocket-client==1.5.1
 xmltodict==0.13.0
 zipp==3.15.0
 

From 133c8a33633cc5ddef0041bd9e9f3972cccbdbb7 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 2 Mar 2023 20:57:02 -0800
Subject: [PATCH 351/743] Bump cloudinary from 1.30.0 to 1.32.0 (#1996)

* Bump cloudinary from 1.30.0 to 1.32.0

Bumps [cloudinary](https://github.com/cloudinary/pycloudinary) from 1.30.0 to 1.32.0.
- [Release notes](https://github.com/cloudinary/pycloudinary/releases)
- [Changelog](https://github.com/cloudinary/pycloudinary/blob/master/CHANGELOG.md)
- [Commits](https://github.com/cloudinary/pycloudinary/compare/1.30.0...1.32.0)

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

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

* Update cloudinary==1.32.0

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/cloudinary/__init__.py                   |  3 +-
 lib/cloudinary/api.py                        | 50 +++++++++++++++++++-
 lib/cloudinary/api_client/execute_request.py |  4 +-
 lib/cloudinary/search.py                     | 12 ++++-
 lib/cloudinary/search_folders.py             | 10 ++++
 lib/cloudinary/uploader.py                   |  3 +-
 lib/cloudinary/utils.py                      | 20 +++++++-
 requirements.txt                             |  2 +-
 8 files changed, 94 insertions(+), 10 deletions(-)
 create mode 100644 lib/cloudinary/search_folders.py

diff --git a/lib/cloudinary/__init__.py b/lib/cloudinary/__init__.py
index da7ca9ae..7746e365 100644
--- a/lib/cloudinary/__init__.py
+++ b/lib/cloudinary/__init__.py
@@ -38,7 +38,7 @@ CL_BLANK = "data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAA
 URI_SCHEME = "cloudinary"
 API_VERSION = "v1_1"
 
-VERSION = "1.30.0"
+VERSION = "1.32.0"
 
 _USER_PLATFORM_DETAILS = "; ".join((platform(), "Python {}".format(python_version())))
 
@@ -234,6 +234,7 @@ _http_client = HttpClient()
 
 # FIXME: circular import issue
 from cloudinary.search import Search
+from cloudinary.search_folders import SearchFolders
 
 
 @python_2_unicode_compatible
diff --git a/lib/cloudinary/api.py b/lib/cloudinary/api.py
index 73d18fa1..dd34686e 100644
--- a/lib/cloudinary/api.py
+++ b/lib/cloudinary/api.py
@@ -188,9 +188,9 @@ def _prepare_asset_details_params(**options):
 
     :internal
     """
-    return only(options, "exif", "faces", "colors", "image_metadata", "cinemagraph_analysis",
+    return only(options, "exif", "faces", "colors", "image_metadata", "media_metadata", "cinemagraph_analysis",
                 "pages", "phash", "coordinates", "max_results", "quality_analysis", "derived_next_cursor",
-                "accessibility_analysis", "versions")
+                "accessibility_analysis", "versions", "related", "related_next_cursor")
 
 
 def update(public_id, **options):
@@ -223,6 +223,8 @@ def update(public_id, **options):
         params["display_name"] = options.get("display_name")
     if "unique_display_name" in options:
         params["unique_display_name"] = options.get("unique_display_name")
+    if "clear_invalid" in options:
+        params["clear_invalid"] = options.get("clear_invalid")
 
     return call_api("post", uri, params, **options)
 
@@ -293,6 +295,50 @@ def delete_derived_by_transformation(public_ids, transformations,
     return call_api("delete", uri, params, **options)
 
 
+def add_related_assets(public_id, assets_to_relate, resource_type="image", type="upload", **options):
+    """
+    Relates an asset to other assets by public IDs.
+
+    :param public_id: The public ID of the asset to update.
+    :type public_id: str
+    :param assets_to_relate: The array of up to 10 fully_qualified_public_ids given as resource_type/type/public_id.
+    :type assets_to_relate: list[str]
+    :param type: The upload type. Defaults to "upload".
+    :type type: str
+    :param resource_type: The type of the resource. Defaults to "image".
+    :type resource_type: str
+    :param options: Additional options.
+    :type options: dict, optional
+    :return: The result of the command.
+    :rtype: dict
+    """
+    uri = ["resources", "related_assets", resource_type, type, public_id]
+    params = {"assets_to_relate": utils.build_array(assets_to_relate)}
+    return call_json_api("post", uri, params, **options)
+
+
+def delete_related_assets(public_id, assets_to_unrelate, resource_type="image", type="upload", **options):
+    """
+    Unrelates an asset from other assets by public IDs.
+
+    :param public_id: The public ID of the asset to update.
+    :type public_id: str
+    :param assets_to_unrelate: The array of up to 10 fully_qualified_public_ids given as resource_type/type/public_id.
+    :type assets_to_unrelate: list[str]
+    :param type: The upload type.
+    :type type: str
+    :param resource_type: The type of the resource: defaults to "image".
+    :type resource_type: str
+    :param options: Additional options.
+    :type options: dict, optional
+    :return: The result of the command.
+    :rtype: dict
+    """
+    uri = ["resources", "related_assets", resource_type, type, public_id]
+    params = {"assets_to_unrelate": utils.build_array(assets_to_unrelate)}
+    return call_json_api("delete", uri, params, **options)
+
+
 def tags(**options):
     resource_type = options.pop("resource_type", "image")
     uri = ["tags", resource_type]
diff --git a/lib/cloudinary/api_client/execute_request.py b/lib/cloudinary/api_client/execute_request.py
index 4d6b8651..1bd52a25 100644
--- a/lib/cloudinary/api_client/execute_request.py
+++ b/lib/cloudinary/api_client/execute_request.py
@@ -68,9 +68,9 @@ def execute_request(http_connector, method, params, headers, auth, api_url, **op
         response = http_connector.request(method.upper(), api_url, processed_params, req_headers, **kw)
         body = response.data
     except HTTPError as e:
-        raise GeneralError("Unexpected error {0}", e.message)
+        raise GeneralError("Unexpected error %s" % str(e))
     except socket.error as e:
-        raise GeneralError("Socket Error: %s" % (str(e)))
+        raise GeneralError("Socket Error: %s" % str(e))
 
     try:
         result = json.loads(body.decode('utf-8'))
diff --git a/lib/cloudinary/search.py b/lib/cloudinary/search.py
index 0d97e098..0e4b0ee0 100644
--- a/lib/cloudinary/search.py
+++ b/lib/cloudinary/search.py
@@ -4,7 +4,11 @@ from cloudinary.api_client.call_api import call_json_api
 from cloudinary.utils import unique
 
 
-class Search:
+class Search(object):
+    ASSETS = 'resources'
+
+    _endpoint = ASSETS
+
     _KEYS_WITH_UNIQUE_VALUES = {
         'sort_by': lambda x: next(iter(x)),
         'aggregate': None,
@@ -53,7 +57,7 @@ class Search:
     def execute(self, **options):
         """Execute the search and return results."""
         options["content_type"] = 'application/json'
-        uri = ['resources', 'search']
+        uri = [self._endpoint, 'search']
         return call_json_api('post', uri, self.as_dict(), **options)
 
     def _add(self, name, value):
@@ -72,3 +76,7 @@ class Search:
             to_return[key] = value
 
         return to_return
+
+    def endpoint(self, endpoint):
+        self._endpoint = endpoint
+        return self
diff --git a/lib/cloudinary/search_folders.py b/lib/cloudinary/search_folders.py
new file mode 100644
index 00000000..87e2601d
--- /dev/null
+++ b/lib/cloudinary/search_folders.py
@@ -0,0 +1,10 @@
+from cloudinary import Search
+
+
+class SearchFolders(Search):
+    FOLDERS = 'folders'
+
+    def __init__(self):
+        super(SearchFolders, self).__init__()
+
+        self.endpoint(self.FOLDERS)
diff --git a/lib/cloudinary/uploader.py b/lib/cloudinary/uploader.py
index 3b118142..188c06e0 100644
--- a/lib/cloudinary/uploader.py
+++ b/lib/cloudinary/uploader.py
@@ -168,7 +168,8 @@ def update_metadata(metadata, public_ids, **options):
         "timestamp": utils.now(),
         "metadata": utils.encode_context(metadata),
         "public_ids": utils.build_array(public_ids),
-        "type": options.get("type")
+        "type": options.get("type"),
+        "clear_invalid": options.get("clear_invalid")
     }
 
     return call_api("metadata", params, **options)
diff --git a/lib/cloudinary/utils.py b/lib/cloudinary/utils.py
index f7f94512..7aac086b 100644
--- a/lib/cloudinary/utils.py
+++ b/lib/cloudinary/utils.py
@@ -78,6 +78,7 @@ __SIMPLE_UPLOAD_PARAMS = [
     "backup",
     "faces",
     "image_metadata",
+    "media_metadata",
     "exif",
     "colors",
     "use_filename",
@@ -1052,7 +1053,8 @@ def build_custom_headers(headers):
 
 
 def build_upload_params(**options):
-    params = {param_name: options.get(param_name) for param_name in __SIMPLE_UPLOAD_PARAMS}
+    params = {param_name: options.get(param_name) for param_name in __SIMPLE_UPLOAD_PARAMS if param_name in options}
+    params["upload_preset"] = params.pop("upload_preset", cloudinary.config().upload_preset)
 
     serialized_params = {
         "timestamp": now(),
@@ -1577,3 +1579,19 @@ def unique(collection, key=None):
         to_return[key(element)] = element
 
     return list(to_return.values())
+
+
+def fq_public_id(public_id, resource_type="image", type="upload"):
+    """
+    Returns the fully qualified public id of form resource_type/type/public_id.
+
+    :param public_id: The public ID of the asset.
+    :type public_id: str
+    :param resource_type: The type of the asset. Defaults to "image".
+    :type resource_type: str
+    :param type: The upload type. Defaults to "upload".
+    :type type: str
+
+    :return:
+    """
+    return "{resource_type}/{type}/{public_id}".format(resource_type=resource_type, type=type, public_id=public_id)
diff --git a/requirements.txt b/requirements.txt
index 2e253ab7..42b7808a 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -9,7 +9,7 @@ bleach==6.0.0
 certifi==2022.12.7
 cheroot==9.0.0
 cherrypy==18.8.0
-cloudinary==1.30.0
+cloudinary==1.32.0
 distro==1.8.0
 dnspython==2.3.0
 facebook-sdk==3.1.0

From eb9c9ffd4ebbd076e33889676d8e91976b945789 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 2 Mar 2023 20:57:58 -0800
Subject: [PATCH 352/743] Bump pyopenssl from 22.1.0 to 23.0.0 (#1955)

Bumps [pyopenssl](https://github.com/pyca/pyopenssl) from 22.1.0 to 23.0.0.
- [Release notes](https://github.com/pyca/pyopenssl/releases)
- [Changelog](https://github.com/pyca/pyopenssl/blob/main/CHANGELOG.rst)
- [Commits](https://github.com/pyca/pyopenssl/compare/22.1.0...23.0.0)

---
updated-dependencies:
- dependency-name: pyopenssl
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 package/requirements-package.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index 27f69c35..90bd7378 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -2,7 +2,7 @@ apscheduler==3.10.0
 importlib-metadata==6.0.0
 importlib-resources==5.12.0
 pyinstaller==5.7.0
-pyopenssl==22.1.0
+pyopenssl==23.0.0
 pycryptodomex==3.16.0
 
 pyobjc-core==9.0.1; platform_system == "Darwin"

From 33f9c70181e8b2e090f79f63f33e206dc3124fc4 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 2 Mar 2023 20:58:20 -0800
Subject: [PATCH 353/743] Bump urllib3 from 1.26.13 to 1.26.14 (#1965)

* Bump urllib3 from 1.26.13 to 1.26.14

Bumps [urllib3](https://github.com/urllib3/urllib3) from 1.26.13 to 1.26.14.
- [Release notes](https://github.com/urllib3/urllib3/releases)
- [Changelog](https://github.com/urllib3/urllib3/blob/1.26.14/CHANGES.rst)
- [Commits](https://github.com/urllib3/urllib3/compare/1.26.13...1.26.14)

---
updated-dependencies:
- dependency-name: urllib3
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

* Update urllib3==1.26.14

---------

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

[skip ci]
---
 requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements.txt b/requirements.txt
index 42b7808a..6dff712b 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -46,7 +46,7 @@ tempora==5.2.1
 tokenize-rt==5.0.0
 tzdata==2022.7
 tzlocal==4.2
-urllib3==1.26.13
+urllib3==1.26.14
 webencodings==0.5.1
 websocket-client==1.5.1
 xmltodict==0.13.0

From 3ba3ea9b7e05199ae7e7c14dc20d25fb2add6002 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 2 Mar 2023 21:04:49 -0800
Subject: [PATCH 354/743] Bump pycryptodomex from 3.16.0 to 3.17 (#1983)

Bumps [pycryptodomex](https://github.com/Legrandin/pycryptodome) from 3.16.0 to 3.17.
- [Release notes](https://github.com/Legrandin/pycryptodome/releases)
- [Changelog](https://github.com/Legrandin/pycryptodome/blob/master/Changelog.rst)
- [Commits](https://github.com/Legrandin/pycryptodome/compare/v3.16.0...v3.17.0)

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

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 package/requirements-package.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index 90bd7378..813119d5 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -3,7 +3,7 @@ importlib-metadata==6.0.0
 importlib-resources==5.12.0
 pyinstaller==5.7.0
 pyopenssl==23.0.0
-pycryptodomex==3.16.0
+pycryptodomex==3.17
 
 pyobjc-core==9.0.1; platform_system == "Darwin"
 pyobjc-framework-Cocoa==9.0.1; platform_system == "Darwin"

From a241de6dc27c3756f4f5d2c76135c220b8873c4f Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 2 Mar 2023 21:10:48 -0800
Subject: [PATCH 355/743] Bump pyinstaller from 5.7.0 to 5.8.0 (#1998)

Bumps [pyinstaller](https://github.com/pyinstaller/pyinstaller) from 5.7.0 to 5.8.0.
- [Release notes](https://github.com/pyinstaller/pyinstaller/releases)
- [Changelog](https://github.com/pyinstaller/pyinstaller/blob/develop/doc/CHANGES.rst)
- [Commits](https://github.com/pyinstaller/pyinstaller/compare/v5.7.0...v5.8.0)

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

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 package/requirements-package.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index 813119d5..db4c50b9 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -1,7 +1,7 @@
 apscheduler==3.10.0
 importlib-metadata==6.0.0
 importlib-resources==5.12.0
-pyinstaller==5.7.0
+pyinstaller==5.8.0
 pyopenssl==23.0.0
 pycryptodomex==3.17
 

From dffa3539668a0f9ee5cd88f538b0221fedd168ba Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 2 Mar 2023 22:59:58 -0800
Subject: [PATCH 356/743] Don't submit to winget for pre-release (beta)

[skip ci]
---
 .github/workflows/submit-winget.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.github/workflows/submit-winget.yml b/.github/workflows/submit-winget.yml
index 43c1ce24..9472b7fb 100644
--- a/.github/workflows/submit-winget.yml
+++ b/.github/workflows/submit-winget.yml
@@ -9,6 +9,7 @@ jobs:
   winget:
     name: Submit Winget Package
     runs-on: windows-latest
+    if: !github.event.release.prerelease
     steps:
       - name: Submit package to Windows Package Manager Community Repository
         run: |

From 69e1b43aa155c83ed683bf8e89e9ea65a613af5f Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Fri, 3 Mar 2023 10:21:35 -0800
Subject: [PATCH 357/743] Bump soupsieve from 2.3.2.post1 to 2.4 (#2014)

Bumps [soupsieve](https://github.com/facelessuser/soupsieve) from 2.3.2.post1 to 2.4.
- [Release notes](https://github.com/facelessuser/soupsieve/releases)
- [Commits](https://github.com/facelessuser/soupsieve/compare/2.3.2.post1...2.4)

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

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements.txt b/requirements.txt
index 6dff712b..6e7f207f 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -41,7 +41,7 @@ requests-oauthlib==1.3.1
 rumps==0.4.0; platform_system == "Darwin"
 simplejson==3.18.3
 six==1.16.0
-soupsieve==2.3.2.post1
+soupsieve==2.4
 tempora==5.2.1
 tokenize-rt==5.0.0
 tzdata==2022.7

From ec323abb922e2c5a6e30d97fa80b029118052f85 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Fri, 3 Mar 2023 10:21:48 -0800
Subject: [PATCH 358/743] Bump apscheduler from 3.10.0 to 3.10.1 (#2013)

* Bump apscheduler from 3.10.0 to 3.10.1

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

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

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

* Update apscheduler==3.10.1

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/apscheduler/schedulers/qt.py | 2 +-
 package/requirements-package.txt | 2 +-
 requirements.txt                 | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/lib/apscheduler/schedulers/qt.py b/lib/apscheduler/schedulers/qt.py
index 600f6e67..890a44a8 100644
--- a/lib/apscheduler/schedulers/qt.py
+++ b/lib/apscheduler/schedulers/qt.py
@@ -33,7 +33,7 @@ class QtScheduler(BaseScheduler):
     def _start_timer(self, wait_seconds):
         self._stop_timer()
         if wait_seconds is not None:
-            wait_time = min(wait_seconds * 1000, 2147483647)
+            wait_time = min(int(wait_seconds * 1000), 2147483647)
             self._timer = QTimer.singleShot(wait_time, self._process_jobs)
 
     def _stop_timer(self):
diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index db4c50b9..e8ccd0b8 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -1,4 +1,4 @@
-apscheduler==3.10.0
+apscheduler==3.10.1
 importlib-metadata==6.0.0
 importlib-resources==5.12.0
 pyinstaller==5.8.0
diff --git a/requirements.txt b/requirements.txt
index 6e7f207f..cb019452 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,5 +1,5 @@
 appdirs==1.4.4
-apscheduler==3.10.0
+apscheduler==3.10.1
 arrow==1.2.3
 backports.csv==1.0.7
 backports.functools-lru-cache==1.6.4

From 78a3d1503962ae5787896de178e6611dd6606717 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 3 Mar 2023 10:18:18 -0800
Subject: [PATCH 359/743] Add history table to collection and playlist info
 pages

---
 data/interfaces/default/info.html |  9 +++++---
 plexpy/webserve.py                | 36 +++++++++++++++++++------------
 2 files changed, 28 insertions(+), 17 deletions(-)

diff --git a/data/interfaces/default/info.html b/data/interfaces/default/info.html
index 31c83c05..43e57694 100644
--- a/data/interfaces/default/info.html
+++ b/data/interfaces/default/info.html
@@ -583,7 +583,7 @@ DOCUMENTATION :: END
                 </div>
                 % endif
                 <%
-                    history_type = data['media_type'] in ('movie', 'show', 'season', 'episode', 'artist', 'album', 'track')
+                    history_type = data['media_type'] in ('movie', 'show', 'season', 'episode', 'artist', 'album', 'track', 'collection', 'playlist')
                     history_active = 'active' if history_type else ''
                     export_active = 'active' if not history_type else ''
                 %>
@@ -646,7 +646,7 @@ DOCUMENTATION :: END
                                 <div class="col-md-12">
                                     <div class="table-card-header">
                                         <div class="header-bar">
-                                            % if data['media_type'] in ('artist', 'album', 'track'):
+                                            % if data['media_type'] in ('artist', 'album', 'track', 'playlist'):
                                             <span>Play History for <strong>${data['title']}</strong></span>
                                             % else:
                                             <span>Watch History for <strong>${data['title']}</strong></span>
@@ -865,7 +865,7 @@ DOCUMENTATION :: END
 %>
 <script src="${http_root}js/tables/history_table.js${cache_param}"></script>
 <script src="${http_root}js/tables/export_table.js${cache_param}"></script>
-% if data['media_type'] in ('movie', 'show', 'season', 'episode', 'artist', 'album', 'track'):
+% if data['media_type'] in ('movie', 'show', 'season', 'episode', 'artist', 'album', 'track', 'collection', 'playlist'):
 <script>
     function loadHistoryTable(transcode_decision) {
         // Build watch history table
@@ -885,6 +885,9 @@ DOCUMENTATION :: END
                     parent_rating_key: "${data['rating_key']}"
                     % elif data['media_type'] in ('movie', 'episode', 'track'):
                     rating_key: "${data['rating_key']}"
+                    % elif data['media_type'] in ('collection', 'playlist'):
+                    media_type: "${data['media_type']}",
+                    rating_key: "${data['rating_key']}"
                     % endif
                 };
             }
diff --git a/plexpy/webserve.py b/plexpy/webserve.py
index 3c960706..29e2d02a 100644
--- a/plexpy/webserve.py
+++ b/plexpy/webserve.py
@@ -1897,7 +1897,7 @@ class WebInterface(object):
                 before (str):                   History before and including the date, "YYYY-MM-DD"
                 after (str):                    History after and including the date, "YYYY-MM-DD"
                 section_id (int):               2
-                media_type (str):               "movie", "episode", "track", "live"
+                media_type (str):               "movie", "episode", "track", "live", "collection", "playlist"
                 transcode_decision (str):       "direct play", "copy", "transcode",
                 guid (str):                     Plex guid for an item, e.g. "com.plexapp.agents.thetvdb://121361/6/1"
                 order_column (str):             "date", "friendly_name", "ip_address", "platform", "player",
@@ -1994,47 +1994,55 @@ class WebInterface(object):
             if user:
                 custom_where.append(['session_history.user', user])
         if 'rating_key' in kwargs:
-            rating_key = helpers.split_strip(kwargs.get('rating_key', ''))
-            if rating_key:
-                custom_where.append(['session_history.rating_key', rating_key])
+            if kwargs.get('media_type') in ('collection', 'playlist') and kwargs.get('rating_key'):
+                pms_connect = pmsconnect.PmsConnect()
+                result = pms_connect.get_item_children(rating_key=kwargs.pop('rating_key'), media_type=kwargs.pop('media_type'))
+                rating_keys = [child['rating_key'] for child in result['children_list']]
+                custom_where.append(['session_history_metadata.rating_key OR', rating_keys])
+                custom_where.append(['session_history_metadata.parent_rating_key OR', rating_keys])
+                custom_where.append(['session_history_metadata.grandparent_rating_key OR', rating_keys])
+            else:
+                rating_key = helpers.split_strip(kwargs.pop('rating_key', ''))
+                if rating_key:
+                    custom_where.append(['session_history.rating_key', rating_key])
         if 'parent_rating_key' in kwargs:
-            rating_key = helpers.split_strip(kwargs.get('parent_rating_key', ''))
+            rating_key = helpers.split_strip(kwargs.pop('parent_rating_key', ''))
             if rating_key:
                 custom_where.append(['session_history.parent_rating_key', rating_key])
         if 'grandparent_rating_key' in kwargs:
-            rating_key = helpers.split_strip(kwargs.get('grandparent_rating_key', ''))
+            rating_key = helpers.split_strip(kwargs.pop('grandparent_rating_key', ''))
             if rating_key:
                 custom_where.append(['session_history.grandparent_rating_key', rating_key])
         if 'start_date' in kwargs:
-            start_date = helpers.split_strip(kwargs.get('start_date', ''))
+            start_date = helpers.split_strip(kwargs.pop('start_date', ''))
             if start_date:
                 custom_where.append(['strftime("%Y-%m-%d", datetime(started, "unixepoch", "localtime"))', start_date])
         if 'before' in kwargs:
-            before = helpers.split_strip(kwargs.get('before', ''))
+            before = helpers.split_strip(kwargs.pop('before', ''))
             if before:
                 custom_where.append(['strftime("%Y-%m-%d", datetime(started, "unixepoch", "localtime")) <', before])
         if 'after' in kwargs:
-            after = helpers.split_strip(kwargs.get('after', ''))
+            after = helpers.split_strip(kwargs.pop('after', ''))
             if after:
                 custom_where.append(['strftime("%Y-%m-%d", datetime(started, "unixepoch", "localtime")) >', after])
         if 'reference_id' in kwargs:
-            reference_id = helpers.split_strip(kwargs.get('reference_id', ''))
+            reference_id = helpers.split_strip(kwargs.pop('reference_id', ''))
             if reference_id:
                 custom_where.append(['session_history.reference_id', reference_id])
         if 'section_id' in kwargs:
-            section_id = helpers.split_strip(kwargs.get('section_id', ''))
+            section_id = helpers.split_strip(kwargs.pop('section_id', ''))
             if section_id:
                 custom_where.append(['session_history.section_id', section_id])
         if 'media_type' in kwargs:
-            media_type = helpers.split_strip(kwargs.get('media_type', ''))
+            media_type = helpers.split_strip(kwargs.pop('media_type', ''))
             if media_type and 'all' not in media_type:
                 custom_where.append(['media_type_live', media_type])
         if 'transcode_decision' in kwargs:
-            transcode_decision = helpers.split_strip(kwargs.get('transcode_decision', ''))
+            transcode_decision = helpers.split_strip(kwargs.pop('transcode_decision', ''))
             if transcode_decision and 'all' not in transcode_decision:
                 custom_where.append(['session_history_media_info.transcode_decision', transcode_decision])
         if 'guid' in kwargs:
-            guid = helpers.split_strip(kwargs.get('guid', '').split('?')[0])
+            guid = helpers.split_strip(kwargs.pop('guid', '').split('?')[0])
             if guid:
                 custom_where.append(['session_history_metadata.guid', ['LIKE ' + g + '%' for g in guid]])
 

From aa7606d5769b8ea1409d7af64f42aec57f388bb6 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 3 Mar 2023 10:26:31 -0800
Subject: [PATCH 360/743] v2.12.0-beta

---
 CHANGELOG.md      | 29 +++++++++++++++++++++++++++++
 plexpy/version.py |  4 ++--
 2 files changed, 31 insertions(+), 2 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 79b3546a..d99eb976 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,34 @@
 # Changelog
 
+## v2.12.0-beta (2023-03-03)
+
+* Notifications:
+  * New: Added support for Telegram group topics. (#1980)
+  * New: Added anidb_id and anidb_url notification parameters. (#1973)
+  * New: Added notification triggers for Intro Marker, Commercial Marker, and Credits Marker.
+  * New: Added various intro, commercial, and credits marker notification parameters.
+  * New: Allow setting a custom Pushover notification sound. (#2005)
+  * Change: Notification images are now uploaded directly to Discord without the need for a 3rd party image hosting service.
+  * Change: Automatically strip whitespace from notification condition values.
+  * Change: Trigger watched notifications based on the video watched completion behaviour setting.
+* Exporter:
+  * Fix: Unable to run exporter when using the Snap package. (#2007)
+* UI:
+  * New: Added edition details field on movie media info pages. (#1957) (Thanks @herby2212)
+  * New: Added setting to change the video watched completion behaviour.
+  * New: Added watch time and user statistics to collection and playlist media info pages. (#1982, #2012) (Thanks @herby2212)
+  * New: Added history table to collection and playlist media info pages.
+  * New: Dynamically change watched status in the UI based on video watched completion behaviour setting.
+  * Fix: Incorrect styling and missing content for collection media info pages.
+  * Change: Move track artist to a details field instead of in the title on track media info pages.
+* API:
+  * New: Added section_id and user_id parameters to get_home_stats API command. (#1944)
+  * New: Added marker info to get_metadata API command results.
+  * New: Added media_type parameter to get_item_watch_time_stats and get_item_user_stats API commands. (#1982) (Thanks @herby2212)
+* Other:
+  * Change: Migrate analytics to Google Analytics 4.
+
+
 ## v2.11.1 (2022-12-22)
 
 * Activity:
diff --git a/plexpy/version.py b/plexpy/version.py
index ec5d5f61..c11f3506 100644
--- a/plexpy/version.py
+++ b/plexpy/version.py
@@ -17,5 +17,5 @@
 
 from __future__ import unicode_literals
 
-PLEXPY_BRANCH = "master"
-PLEXPY_RELEASE_VERSION = "v2.11.1"
\ No newline at end of file
+PLEXPY_BRANCH = "beta"
+PLEXPY_RELEASE_VERSION = "v2.12.0-beta"
\ No newline at end of file

From 8f06b39a072c08d528d01e557d5f5c3d171e8dd2 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 3 Mar 2023 10:43:33 -0800
Subject: [PATCH 361/743] Fix submit winget workflow

[skip ci]
---
 .github/workflows/submit-winget.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/submit-winget.yml b/.github/workflows/submit-winget.yml
index 9472b7fb..aa1c4dec 100644
--- a/.github/workflows/submit-winget.yml
+++ b/.github/workflows/submit-winget.yml
@@ -9,7 +9,7 @@ jobs:
   winget:
     name: Submit Winget Package
     runs-on: windows-latest
-    if: !github.event.release.prerelease
+    if: ${{ !github.event.release.prerelease }}
     steps:
       - name: Submit package to Windows Package Manager Community Repository
         run: |

From d240984c278f525eefbcbe5042af1a2bc675a5a6 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 3 Mar 2023 10:58:16 -0800
Subject: [PATCH 362/743] Fix multiline changelog in publish installer workflow

* Ref: https://docs.github.com/en/actions/using-workflows/workflow-commands-for-github-actions#multiline-strings

[skip ci]
---
 .github/workflows/publish-installers.yml | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/publish-installers.yml b/.github/workflows/publish-installers.yml
index 31ad0f81..49d53233 100644
--- a/.github/workflows/publish-installers.yml
+++ b/.github/workflows/publish-installers.yml
@@ -119,7 +119,10 @@ jobs:
         run: |
           CHANGELOG="$( sed -n '/^## /{p; :loop n; p; /^## /q; b loop}' CHANGELOG.md \
             | sed '$d' | sed '$d' | sed '$d' )"
-          echo "CHANGELOG=${CHANGELOG}" >> $GITHUB_OUTPUT
+          EOF=$(dd if=/dev/urandom bs=15 count=1 status=none | base64)
+          echo "CHANGELOG<<$EOF" >> $GITHUB_OUTPUT
+          echo "$CHANGELOG" >> $GITHUB_OUTPUT
+          echo "$EOF" >> $GITHUB_OUTPUT
 
       - name: Create Release
         uses: actions/create-release@v1

From 0925234f06d014138efd83a3b9e62a8f2a5b49d6 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 3 Mar 2023 11:07:45 -0800
Subject: [PATCH 363/743] Create .github/workflows/codeql.yml

---
 .github/workflows/codeql.yml | 37 ++++++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)
 create mode 100644 .github/workflows/codeql.yml

diff --git a/.github/workflows/codeql.yml b/.github/workflows/codeql.yml
new file mode 100644
index 00000000..4fb6f9cc
--- /dev/null
+++ b/.github/workflows/codeql.yml
@@ -0,0 +1,37 @@
+name: CodeQL
+
+on:
+  push:
+    branches: [master, beta, nightly]
+  pull_request:
+    branches: [nightly]
+  schedule:
+    - cron: '05 10 * * 1'
+
+jobs:
+  codeql-analysis:
+    name: CodeQL Analysis
+    runs-on: ubuntu-latest
+    permissions:
+      actions: read
+      contents: read
+      security-events: write
+
+    strategy:
+      fail-fast: false
+      matrix:
+        language: ['javascript', 'python']
+
+    steps:
+    - name: Checkout Code
+      uses: actions/checkout@v3
+
+    - name: Initialize CodeQL
+      uses: github/codeql-action/init@v2
+      with:
+        languages: ${{ matrix.language }}
+
+    - name: Perform CodeQL Analysis
+      uses: github/codeql-action/analyze@v2
+      with:
+        category: "/language:${{matrix.language}}"

From 39047ea7c326640e2c4b63c4284fb656e4a0c3ac Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 3 Mar 2023 11:17:59 -0800
Subject: [PATCH 364/743] Add codeql config file

[skip ci]
---
 .github/codeql-config.yml    | 4 ++++
 .github/workflows/codeql.yml | 1 +
 2 files changed, 5 insertions(+)
 create mode 100644 .github/codeql-config.yml

diff --git a/.github/codeql-config.yml b/.github/codeql-config.yml
new file mode 100644
index 00000000..574f9b33
--- /dev/null
+++ b/.github/codeql-config.yml
@@ -0,0 +1,4 @@
+name: CodeQL Config
+
+paths-ignore:
+  - lib
diff --git a/.github/workflows/codeql.yml b/.github/workflows/codeql.yml
index 4fb6f9cc..a8570f78 100644
--- a/.github/workflows/codeql.yml
+++ b/.github/workflows/codeql.yml
@@ -29,6 +29,7 @@ jobs:
     - name: Initialize CodeQL
       uses: github/codeql-action/init@v2
       with:
+        config-file: ./.github/codeql-config.yml
         languages: ${{ matrix.language }}
 
     - name: Perform CodeQL Analysis

From 22c5e59ee96764145218ccab9630965a6a6b1f47 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 3 Mar 2023 11:20:29 -0800
Subject: [PATCH 365/743] Only run CodeQL on nightly branch

---
 .github/workflows/codeql.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/codeql.yml b/.github/workflows/codeql.yml
index a8570f78..e914485d 100644
--- a/.github/workflows/codeql.yml
+++ b/.github/workflows/codeql.yml
@@ -2,7 +2,7 @@ name: CodeQL
 
 on:
   push:
-    branches: [master, beta, nightly]
+    branches: [nightly]
   pull_request:
     branches: [nightly]
   schedule:

From 4274a29bd6aacf4259399f8ec6f09de07b301123 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 3 Mar 2023 22:22:21 -0800
Subject: [PATCH 366/743] Use `.text()` instead of `.html()` to set graph range
 values

---
 data/interfaces/default/graphs.html | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/data/interfaces/default/graphs.html b/data/interfaces/default/graphs.html
index 2e71bd76..3f189112 100644
--- a/data/interfaces/default/graphs.html
+++ b/data/interfaces/default/graphs.html
@@ -364,8 +364,8 @@
         //$(current_tab).addClass('active');
 
 
-        $('.days').html(current_day_range);
-        $('.months').html(current_month_range);
+        $('.days').text(current_day_range);
+        $('.months').text(current_month_range);
         
         // Load user ids and names (for the selector)
         $.ajax({
@@ -639,7 +639,7 @@
             setLocalStorage('graph_days', current_day_range);
             if (current_tab === '#tabs-plays') { loadGraphsTab1(current_day_range, yaxis); }
             if (current_tab === '#tabs-stream') { loadGraphsTab2(current_day_range, yaxis); }
-            $('.days').html(current_day_range);
+            $('.days').text(current_day_range);
         });
         
         // Month range changed
@@ -649,7 +649,7 @@
             current_month_range = $(this).val();
             setLocalStorage('graph_months', current_month_range);
             if (current_tab === '#tabs-total') { loadGraphsTab3(current_month_range, yaxis); }
-            $('.months').html(current_month_range);
+            $('.months').text(current_month_range);
         });
 
         // User changed

From 3d2959ee51ab8a48a4bc021bb70e5ccdcdded871 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 3 Mar 2023 22:25:01 -0800
Subject: [PATCH 367/743] Use `.setAttribute()` for QR code address parser

---
 data/interfaces/default/mobile_devices_table.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/data/interfaces/default/mobile_devices_table.html b/data/interfaces/default/mobile_devices_table.html
index 328e40e4..e5363885 100644
--- a/data/interfaces/default/mobile_devices_table.html
+++ b/data/interfaces/default/mobile_devices_table.html
@@ -70,7 +70,7 @@ DOCUMENTATION :: END
 
     function checkQRAddress(url) {
         var parser = document.createElement('a');
-        parser.href = url;
+        parser.setAttribute('href', url);
         var hostname = parser.hostname;
         var protocol = parser.protocol;
 

From c90469b0b75102188325f3a1de0fc18161c1b5a4 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 3 Mar 2023 22:37:57 -0800
Subject: [PATCH 368/743] URI encode download logfile parameter

---
 data/interfaces/default/logs.html | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/data/interfaces/default/logs.html b/data/interfaces/default/logs.html
index 56e6a4dc..f8262fb6 100644
--- a/data/interfaces/default/logs.html
+++ b/data/interfaces/default/logs.html
@@ -453,12 +453,12 @@
 
         $("#download-tautullilog").click(function () {
             var logfile = $(".tab-pane.active").data('logfile');
-            window.location.href = "download_log?logfile=" + logfile;
+            window.location.href = "download_log?logfile=" + window.encodeURIComponent(logfile);
         });
 
         $("#download-plexserverlog").click(function () {
             var logfile = $("option:selected", "#plex-log-files").val();
-            window.location.href = "download_plex_log?logfile=" + logfile;
+            window.location.href = "download_plex_log?logfile=" + window.encodeURIComponent(logfile);
         });
 
         $("#clear-notify-logs").click(function () {

From 000656be00291d350d4ffcfab3b3d6676870d578 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 7 Mar 2023 20:16:08 -0800
Subject: [PATCH 369/743] Add last_refreshed time to get_library_media_info
 response

---
 plexpy/libraries.py | 42 +++++++++++++++++++++++++++++-------------
 1 file changed, 29 insertions(+), 13 deletions(-)

diff --git a/plexpy/libraries.py b/plexpy/libraries.py
index 8a51eec1..8042378c 100644
--- a/plexpy/libraries.py
+++ b/plexpy/libraries.py
@@ -458,7 +458,8 @@ class Libraries(object):
                           'draw': 0,
                           'data': [],
                           'filtered_file_size': 0,
-                          'total_file_size': 0}
+                          'total_file_size': 0,
+                          'last_refreshed': None}
 
         if not session.allow_session_library(section_id):
             return default_return
@@ -513,13 +514,19 @@ class Libraries(object):
             watched_list[str(item[group_by])] = {'last_played': item['last_played'],
                                                  'play_count': item['play_count']}
 
+        cache_time = None
         rows = []
         # Import media info cache from json file
         if rating_key:
             try:
                 inFilePath = os.path.join(plexpy.CONFIG.CACHE_DIR,'media_info_%s-%s.json' % (section_id, rating_key))
                 with open(inFilePath, 'r') as inFile:
-                    rows = json.load(inFile)
+                    data = json.load(inFile)
+                    if isinstance(data, dict):
+                        cache_time = data['last_refreshed']
+                        rows = data['rows']
+                    else:
+                        rows = data
                     library_count = len(rows)
             except IOError as e:
                 #logger.debug("Tautulli Libraries :: No JSON file for rating_key %s." % rating_key)
@@ -529,7 +536,12 @@ class Libraries(object):
             try:
                 inFilePath = os.path.join(plexpy.CONFIG.CACHE_DIR,'media_info_%s.json' % section_id)
                 with open(inFilePath, 'r') as inFile:
-                    rows = json.load(inFile)
+                    data = json.load(inFile)
+                    if isinstance(data, dict):
+                        cache_time = data['last_refreshed']
+                        rows = data['rows']
+                    else:
+                        rows = data
                     library_count = len(rows)
             except IOError as e:
                 #logger.debug("Tautulli Libraries :: No JSON file for library section_id %s." % section_id)
@@ -594,18 +606,20 @@ class Libraries(object):
                 return default_return
 
             # Cache the media info to a json file
+            cache_time = helpers.timestamp()
+            
             if rating_key:
                 try:
                     outFilePath = os.path.join(plexpy.CONFIG.CACHE_DIR,'media_info_%s-%s.json' % (section_id, rating_key))
                     with open(outFilePath, 'w') as outFile:
-                        json.dump(rows, outFile)
+                        json.dump({'last_refreshed': cache_time, 'rows': rows}, outFile)
                 except IOError as e:
                     logger.debug("Tautulli Libraries :: Unable to create cache file for rating_key %s." % rating_key)
             elif section_id:
                 try:
                     outFilePath = os.path.join(plexpy.CONFIG.CACHE_DIR,'media_info_%s.json' % section_id)
                     with open(outFilePath, 'w') as outFile:
-                        json.dump(rows, outFile)
+                        json.dump({'last_refreshed': cache_time, 'rows': rows}, outFile)
                 except IOError as e:
                     logger.debug("Tautulli Libraries :: Unable to create cache file for section_id %s." % section_id)
 
@@ -662,15 +676,17 @@ class Libraries(object):
 
         filtered_file_size = sum([helpers.cast_to_int(d['file_size']) for d in results])
 
-        dict = {'recordsFiltered': filtered_count,
-                'recordsTotal': library_count,
-                'data': results,
-                'draw': int(json_data['draw']),
-                'filtered_file_size': filtered_file_size,
-                'total_file_size': total_file_size
-                }
+        output = {
+            'recordsFiltered': filtered_count,
+            'recordsTotal': int(library_count),
+            'data': results,
+            'draw': int(json_data['draw']),
+            'filtered_file_size': filtered_file_size,
+            'total_file_size': total_file_size,
+            'last_refreshed': cache_time
+        }
 
-        return dict
+        return output
 
     def get_media_info_file_sizes(self, section_id=None, rating_key=None):
         if not session.allow_session_library(section_id):

From b7da2dedf3710df708d77884a6ca7fdd563bb201 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 7 Mar 2023 20:25:49 -0800
Subject: [PATCH 370/743] Add hidden setting to override server name

---
 plexpy/config.py               | 1 +
 plexpy/helpers.py              | 4 ++++
 plexpy/newsletters.py          | 2 +-
 plexpy/notification_handler.py | 4 ++--
 plexpy/notifiers.py            | 2 +-
 plexpy/plextv.py               | 2 +-
 plexpy/webserve.py             | 6 +++---
 7 files changed, 13 insertions(+), 8 deletions(-)

diff --git a/plexpy/config.py b/plexpy/config.py
index f094e88e..7b583d8d 100644
--- a/plexpy/config.py
+++ b/plexpy/config.py
@@ -58,6 +58,7 @@ _CONFIG_DEFINITIONS = {
     'PMS_LOGS_FOLDER': (str, 'PMS', ''),
     'PMS_LOGS_LINE_CAP': (int, 'PMS', 1000),
     'PMS_NAME': (str, 'PMS', ''),
+    'PMS_NAME_OVERRIDE': (str, 'PMS', ''),
     'PMS_PORT': (int, 'PMS', 32400),
     'PMS_TOKEN': (str, 'PMS', ''),
     'PMS_SSL': (int, 'PMS', 0),
diff --git a/plexpy/helpers.py b/plexpy/helpers.py
index 89b047fd..9cfb9c45 100644
--- a/plexpy/helpers.py
+++ b/plexpy/helpers.py
@@ -1773,3 +1773,7 @@ def check_watched(media_type, view_offset, duration, marker_credits_first=None,
         return view_offset >= min(threshold, marker_credits_first)
     else:
         return view_offset >= threshold
+
+
+def pms_name():
+    return plexpy.CONFIG.PMS_NAME_OVERRIDE or plexpy.CONFIG.PMS_NAME
diff --git a/plexpy/newsletters.py b/plexpy/newsletters.py
index fdc1c5a8..59663fe2 100644
--- a/plexpy/newsletters.py
+++ b/plexpy/newsletters.py
@@ -599,7 +599,7 @@ class Newsletter(object):
             base_url = helpers.get_plexpy_url() + '/newsletter/'
 
         parameters = {
-            'server_name': plexpy.CONFIG.PMS_NAME,
+            'server_name': helpers.pms_name(),
             'start_date': self.start_date.format(date_format),
             'end_date': self.end_date.format(date_format),
             'current_year': self.start_date.year,
diff --git a/plexpy/notification_handler.py b/plexpy/notification_handler.py
index 197314fc..86baac4d 100644
--- a/plexpy/notification_handler.py
+++ b/plexpy/notification_handler.py
@@ -951,7 +951,7 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
         'tautulli_remote': plexpy.CONFIG.GIT_REMOTE,
         'tautulli_branch': plexpy.CONFIG.GIT_BRANCH,
         'tautulli_commit': plexpy.CURRENT_VERSION,
-        'server_name': plexpy.CONFIG.PMS_NAME,
+        'server_name': helpers.pms_name(),
         'server_ip': plexpy.CONFIG.PMS_IP,
         'server_port': plexpy.CONFIG.PMS_PORT,
         'server_url': plexpy.CONFIG.PMS_URL,
@@ -1246,7 +1246,7 @@ def build_server_notify_params(notify_action=None, **kwargs):
         'tautulli_remote': plexpy.CONFIG.GIT_REMOTE,
         'tautulli_branch': plexpy.CONFIG.GIT_BRANCH,
         'tautulli_commit': plexpy.CURRENT_VERSION,
-        'server_name': plexpy.CONFIG.PMS_NAME,
+        'server_name': helpers.pms_name(),
         'server_ip': plexpy.CONFIG.PMS_IP,
         'server_port': plexpy.CONFIG.PMS_PORT,
         'server_url': plexpy.CONFIG.PMS_URL,
diff --git a/plexpy/notifiers.py b/plexpy/notifiers.py
index 1a747be9..ecd33a60 100644
--- a/plexpy/notifiers.py
+++ b/plexpy/notifiers.py
@@ -2850,7 +2850,7 @@ class PLEXMOBILEAPP(Notifier):
             'data': {
                 'provider': {
                     'identifier': plexpy.CONFIG.PMS_IDENTIFIER,
-                    'title': plexpy.CONFIG.PMS_NAME
+                    'title': helpers.pms_name()
                 }
             }
         }
diff --git a/plexpy/plextv.py b/plexpy/plextv.py
index e7815756..8bab1d51 100644
--- a/plexpy/plextv.py
+++ b/plexpy/plextv.py
@@ -48,7 +48,7 @@ def get_server_resources(return_presence=False, return_server=False, return_info
     if not return_presence and not return_info:
         logger.info("Tautulli PlexTV :: Requesting resources for server...")
 
-    server = {'pms_name': plexpy.CONFIG.PMS_NAME,
+    server = {'pms_name': helpers.pms_name(),
               'pms_version': plexpy.CONFIG.PMS_VERSION,
               'pms_platform': plexpy.CONFIG.PMS_PLATFORM,
               'pms_ip': plexpy.CONFIG.PMS_IP,
diff --git a/plexpy/webserve.py b/plexpy/webserve.py
index 29e2d02a..dd0d4528 100644
--- a/plexpy/webserve.py
+++ b/plexpy/webserve.py
@@ -127,7 +127,7 @@ def serve_template(templatename, **kwargs):
                                error_handler=mako_error_handler)
 
     http_root = plexpy.HTTP_ROOT
-    server_name = plexpy.CONFIG.PMS_NAME
+    server_name = helpers.pms_name()
     cache_param = '?' + (plexpy.CURRENT_VERSION or common.RELEASE)
 
     _session = get_session_info()
@@ -213,7 +213,7 @@ class WebInterface(object):
             "pms_is_remote": plexpy.CONFIG.PMS_IS_REMOTE,
             "pms_ssl": plexpy.CONFIG.PMS_SSL,
             "pms_is_cloud": plexpy.CONFIG.PMS_IS_CLOUD,
-            "pms_name": plexpy.CONFIG.PMS_NAME,
+            "pms_name": helpers.pms_name(),
             "logging_ignore_interval": plexpy.CONFIG.LOGGING_IGNORE_INTERVAL
         }
 
@@ -282,7 +282,7 @@ class WebInterface(object):
         config = {
             "home_sections": plexpy.CONFIG.HOME_SECTIONS,
             "home_refresh_interval": plexpy.CONFIG.HOME_REFRESH_INTERVAL,
-            "pms_name": plexpy.CONFIG.PMS_NAME,
+            "pms_name": helpers.pms_name(),
             "pms_is_cloud": plexpy.CONFIG.PMS_IS_CLOUD,
             "update_show_changelog": plexpy.CONFIG.UPDATE_SHOW_CHANGELOG,
             "first_run_complete": plexpy.CONFIG.FIRST_RUN_COMPLETE

From eb7495e930396e0dc94c3ba6d06ee174492031cd Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 10 Mar 2023 11:06:27 -0800
Subject: [PATCH 371/743] Update plexapi==4.13.4

---
 lib/charset_normalizer/api.py            |  5 +-
 lib/charset_normalizer/cd.py             |  1 -
 lib/charset_normalizer/cli/normalizer.py |  2 -
 lib/charset_normalizer/legacy.py         | 21 ++++++--
 lib/charset_normalizer/utils.py          |  4 --
 lib/charset_normalizer/version.py        |  2 +-
 lib/plexapi/__init__.py                  |  2 +-
 lib/plexapi/audio.py                     |  4 +-
 lib/plexapi/base.py                      | 39 +++++++++------
 lib/plexapi/collection.py                |  4 +-
 lib/plexapi/const.py                     |  2 +-
 lib/plexapi/media.py                     | 25 +++++++++
 lib/plexapi/mixins.py                    | 26 ++++++++--
 lib/plexapi/photo.py                     |  6 +--
 lib/plexapi/server.py                    |  5 +-
 lib/plexapi/utils.py                     | 48 ++++++++++--------
 lib/plexapi/video.py                     | 64 +++++++++++++++++++++---
 requirements.txt                         |  2 +-
 18 files changed, 187 insertions(+), 75 deletions(-)

diff --git a/lib/charset_normalizer/api.py b/lib/charset_normalizer/api.py
index 6c7e8983..9dbf4201 100644
--- a/lib/charset_normalizer/api.py
+++ b/lib/charset_normalizer/api.py
@@ -175,7 +175,6 @@ def from_bytes(
         prioritized_encodings.append("utf_8")
 
     for encoding_iana in prioritized_encodings + IANA_SUPPORTED:
-
         if cp_isolation and encoding_iana not in cp_isolation:
             continue
 
@@ -318,7 +317,9 @@ def from_bytes(
                     bom_or_sig_available and strip_sig_or_bom is False
                 ):
                     break
-        except UnicodeDecodeError as e:  # Lazy str loading may have missed something there
+        except (
+            UnicodeDecodeError
+        ) as e:  # Lazy str loading may have missed something there
             logger.log(
                 TRACE,
                 "LazyStr Loading: After MD chunk decode, code page %s does not fit given bytes sequence at ALL. %s",
diff --git a/lib/charset_normalizer/cd.py b/lib/charset_normalizer/cd.py
index ae2813fb..6e56fe84 100644
--- a/lib/charset_normalizer/cd.py
+++ b/lib/charset_normalizer/cd.py
@@ -140,7 +140,6 @@ def alphabet_languages(
     source_have_accents = any(is_accentuated(character) for character in characters)
 
     for language, language_characters in FREQUENCIES.items():
-
         target_have_accents, target_pure_latin = get_target_features(language)
 
         if ignore_non_latin and target_pure_latin is False:
diff --git a/lib/charset_normalizer/cli/normalizer.py b/lib/charset_normalizer/cli/normalizer.py
index ad26b4d0..f4bcbaac 100644
--- a/lib/charset_normalizer/cli/normalizer.py
+++ b/lib/charset_normalizer/cli/normalizer.py
@@ -147,7 +147,6 @@ def cli_detect(argv: Optional[List[str]] = None) -> int:
     x_ = []
 
     for my_file in args.files:
-
         matches = from_fp(my_file, threshold=args.threshold, explain=args.verbose)
 
         best_guess = matches.best()
@@ -222,7 +221,6 @@ def cli_detect(argv: Optional[List[str]] = None) -> int:
                         )
 
             if args.normalize is True:
-
                 if best_guess.encoding.startswith("utf") is True:
                     print(
                         '"{}" file does not need to be normalized, as it already came from unicode.'.format(
diff --git a/lib/charset_normalizer/legacy.py b/lib/charset_normalizer/legacy.py
index b266d176..43aad21a 100644
--- a/lib/charset_normalizer/legacy.py
+++ b/lib/charset_normalizer/legacy.py
@@ -1,10 +1,13 @@
-from typing import Dict, Optional, Union
+from typing import Any, Dict, Optional, Union
+from warnings import warn
 
 from .api import from_bytes
 from .constant import CHARDET_CORRESPONDENCE
 
 
-def detect(byte_str: bytes) -> Dict[str, Optional[Union[str, float]]]:
+def detect(
+    byte_str: bytes, should_rename_legacy: bool = False, **kwargs: Any
+) -> Dict[str, Optional[Union[str, float]]]:
     """
     chardet legacy method
     Detect the encoding of the given byte string. It should be mostly backward-compatible.
@@ -13,7 +16,14 @@ def detect(byte_str: bytes) -> Dict[str, Optional[Union[str, float]]]:
     further information. Not planned for removal.
 
     :param byte_str:     The byte sequence to examine.
+    :param should_rename_legacy:  Should we rename legacy encodings
+                                  to their more modern equivalents?
     """
+    if len(kwargs):
+        warn(
+            f"charset-normalizer disregard arguments '{','.join(list(kwargs.keys()))}' in legacy function detect()"
+        )
+
     if not isinstance(byte_str, (bytearray, bytes)):
         raise TypeError(  # pragma: nocover
             "Expected object of type bytes or bytearray, got: "
@@ -34,10 +44,11 @@ def detect(byte_str: bytes) -> Dict[str, Optional[Union[str, float]]]:
     if r is not None and encoding == "utf_8" and r.bom:
         encoding += "_sig"
 
+    if should_rename_legacy is False and encoding in CHARDET_CORRESPONDENCE:
+        encoding = CHARDET_CORRESPONDENCE[encoding]
+
     return {
-        "encoding": encoding
-        if encoding not in CHARDET_CORRESPONDENCE
-        else CHARDET_CORRESPONDENCE[encoding],
+        "encoding": encoding,
         "language": language,
         "confidence": confidence,
     }
diff --git a/lib/charset_normalizer/utils.py b/lib/charset_normalizer/utils.py
index e3536267..76eafc64 100644
--- a/lib/charset_normalizer/utils.py
+++ b/lib/charset_normalizer/utils.py
@@ -311,7 +311,6 @@ def range_scan(decoded_sequence: str) -> List[str]:
 
 
 def cp_similarity(iana_name_a: str, iana_name_b: str) -> float:
-
     if is_multi_byte_encoding(iana_name_a) or is_multi_byte_encoding(iana_name_b):
         return 0.0
 
@@ -351,7 +350,6 @@ def set_logging_handler(
     level: int = logging.INFO,
     format_string: str = "%(asctime)s | %(levelname)s | %(message)s",
 ) -> None:
-
     logger = logging.getLogger(name)
     logger.setLevel(level)
 
@@ -371,7 +369,6 @@ def cut_sequence_chunks(
     is_multi_byte_decoder: bool,
     decoded_payload: Optional[str] = None,
 ) -> Generator[str, None, None]:
-
     if decoded_payload and is_multi_byte_decoder is False:
         for i in offsets:
             chunk = decoded_payload[i : i + chunk_size]
@@ -397,7 +394,6 @@ def cut_sequence_chunks(
             # multi-byte bad cutting detector and adjustment
             # not the cleanest way to perform that fix but clever enough for now.
             if is_multi_byte_decoder and i > 0:
-
                 chunk_partial_size_chk: int = min(chunk_size, 16)
 
                 if (
diff --git a/lib/charset_normalizer/version.py b/lib/charset_normalizer/version.py
index cb503673..b74c2643 100644
--- a/lib/charset_normalizer/version.py
+++ b/lib/charset_normalizer/version.py
@@ -2,5 +2,5 @@
 Expose version
 """
 
-__version__ = "3.0.1"
+__version__ = "3.1.0"
 VERSION = __version__.split(".")
diff --git a/lib/plexapi/__init__.py b/lib/plexapi/__init__.py
index 2a7d39ef..eefc181d 100644
--- a/lib/plexapi/__init__.py
+++ b/lib/plexapi/__init__.py
@@ -23,7 +23,7 @@ X_PLEX_ENABLE_FAST_CONNECT = CONFIG.get('plexapi.enable_fast_connect', False, bo
 
 # Plex Header Configuration
 X_PLEX_PROVIDES = CONFIG.get('header.provides', 'controller')
-X_PLEX_PLATFORM = CONFIG.get('header.platform', CONFIG.get('header.platform', uname()[0]))
+X_PLEX_PLATFORM = CONFIG.get('header.platform', uname()[0])
 X_PLEX_PLATFORM_VERSION = CONFIG.get('header.platform_version', uname()[2])
 X_PLEX_PRODUCT = CONFIG.get('header.product', PROJECT)
 X_PLEX_VERSION = CONFIG.get('header.version', VERSION)
diff --git a/lib/plexapi/audio.py b/lib/plexapi/audio.py
index ff9e1e1a..e5455fc8 100644
--- a/lib/plexapi/audio.py
+++ b/lib/plexapi/audio.py
@@ -8,14 +8,14 @@ from plexapi.exceptions import BadRequest, NotFound
 from plexapi.mixins import (
     AdvancedSettingsMixin, SplitMergeMixin, UnmatchMatchMixin, ExtrasMixin, HubsMixin, PlayedUnplayedMixin, RatingMixin,
     ArtUrlMixin, ArtMixin, PosterUrlMixin, PosterMixin, ThemeMixin, ThemeUrlMixin,
-    OriginallyAvailableMixin, SortTitleMixin, StudioMixin, SummaryMixin, TitleMixin,
+    AddedAtMixin, OriginallyAvailableMixin, SortTitleMixin, StudioMixin, SummaryMixin, TitleMixin,
     TrackArtistMixin, TrackDiscNumberMixin, TrackNumberMixin,
     CollectionMixin, CountryMixin, GenreMixin, LabelMixin, MoodMixin, SimilarArtistMixin, StyleMixin
 )
 from plexapi.playlist import Playlist
 
 
-class Audio(PlexPartialObject, PlayedUnplayedMixin):
+class Audio(PlexPartialObject, PlayedUnplayedMixin, AddedAtMixin):
     """ Base class for all audio objects including :class:`~plexapi.audio.Artist`,
         :class:`~plexapi.audio.Album`, and :class:`~plexapi.audio.Track`.
 
diff --git a/lib/plexapi/base.py b/lib/plexapi/base.py
index fe6f0be0..9f888eed 100644
--- a/lib/plexapi/base.py
+++ b/lib/plexapi/base.py
@@ -695,38 +695,45 @@ class Playable:
         self.playlistItemID = utils.cast(int, data.attrib.get('playlistItemID'))    # playlist
         self.playQueueItemID = utils.cast(int, data.attrib.get('playQueueItemID'))  # playqueue
 
-    def getStreamURL(self, **params):
+    def getStreamURL(self, **kwargs):
         """ Returns a stream url that may be used by external applications such as VLC.
 
             Parameters:
-                **params (dict): optional parameters to manipulate the playback when accessing
+                **kwargs (dict): optional parameters to manipulate the playback when accessing
                     the stream. A few known parameters include: maxVideoBitrate, videoResolution
-                    offset, copyts, protocol, mediaIndex, platform.
+                    offset, copyts, protocol, mediaIndex, partIndex, platform.
 
             Raises:
                 :exc:`~plexapi.exceptions.Unsupported`: When the item doesn't support fetching a stream URL.
         """
         if self.TYPE not in ('movie', 'episode', 'track', 'clip'):
             raise Unsupported(f'Fetching stream URL for {self.TYPE} is unsupported.')
-        mvb = params.get('maxVideoBitrate')
-        vr = params.get('videoResolution', '')
+
+        mvb = kwargs.pop('maxVideoBitrate', None)
+        vr = kwargs.pop('videoResolution', '')
+        protocol = kwargs.pop('protocol', None)
+
         params = {
             'path': self.key,
-            'offset': params.get('offset', 0),
-            'copyts': params.get('copyts', 1),
-            'protocol': params.get('protocol'),
-            'mediaIndex': params.get('mediaIndex', 0),
-            'X-Plex-Platform': params.get('platform', 'Chrome'),
+            'mediaIndex': kwargs.pop('mediaIndex', 0),
+            'partIndex': kwargs.pop('mediaIndex', 0),
+            'protocol': protocol,
+            'fastSeek': kwargs.pop('fastSeek', 1),
+            'copyts': kwargs.pop('copyts', 1),
+            'offset': kwargs.pop('offset', 0),
             'maxVideoBitrate': max(mvb, 64) if mvb else None,
-            'videoResolution': vr if re.match(r'^\d+x\d+$', vr) else None
+            'videoResolution': vr if re.match(r'^\d+x\d+$', vr) else None,
+            'X-Plex-Platform': kwargs.pop('platform', 'Chrome')
         }
+        params.update(kwargs)
+
         # remove None values
         params = {k: v for k, v in params.items() if v is not None}
         streamtype = 'audio' if self.TYPE in ('track', 'album') else 'video'
-        # sort the keys since the randomness fucks with my tests..
-        sorted_params = sorted(params.items(), key=lambda val: val[0])
+        ext = 'mpd' if protocol == 'dash' else 'm3u8'
+
         return self._server.url(
-            f'/{streamtype}/:/transcode/universal/start.m3u8?{urlencode(sorted_params)}',
+            f'/{streamtype}/:/transcode/universal/start.{ext}?{urlencode(params)}',
             includeToken=True
         )
 
@@ -795,8 +802,8 @@ class Playable:
         """ Set the watched progress for this video.
 
             Note that setting the time to 0 will not work.
-            Use :func:`~plexapi.mixins.PlayedMixin.markPlayed` or
-            :func:`~plexapi.mixins.PlayedMixin.markUnplayed` to achieve
+            Use :func:`~plexapi.mixins.PlayedUnplayedMixin.markPlayed` or
+            :func:`~plexapi.mixins.PlayedUnplayedMixin.markUnplayed` to achieve
             that goal.
 
             Parameters:
diff --git a/lib/plexapi/collection.py b/lib/plexapi/collection.py
index 4561c158..9d754b1b 100644
--- a/lib/plexapi/collection.py
+++ b/lib/plexapi/collection.py
@@ -8,7 +8,7 @@ from plexapi.library import LibrarySection, ManagedHub
 from plexapi.mixins import (
     AdvancedSettingsMixin, SmartFilterMixin, HubsMixin, RatingMixin,
     ArtMixin, PosterMixin, ThemeMixin,
-    ContentRatingMixin, SortTitleMixin, SummaryMixin, TitleMixin,
+    AddedAtMixin, ContentRatingMixin, SortTitleMixin, SummaryMixin, TitleMixin,
     LabelMixin
 )
 from plexapi.utils import deprecated
@@ -19,7 +19,7 @@ class Collection(
     PlexPartialObject,
     AdvancedSettingsMixin, SmartFilterMixin, HubsMixin, RatingMixin,
     ArtMixin, PosterMixin, ThemeMixin,
-    ContentRatingMixin, SortTitleMixin, SummaryMixin, TitleMixin,
+    AddedAtMixin, ContentRatingMixin, SortTitleMixin, SummaryMixin, TitleMixin,
     LabelMixin
 ):
     """ Represents a single Collection.
diff --git a/lib/plexapi/const.py b/lib/plexapi/const.py
index 605ed78c..86659c57 100644
--- a/lib/plexapi/const.py
+++ b/lib/plexapi/const.py
@@ -4,6 +4,6 @@
 # Library version
 MAJOR_VERSION = 4
 MINOR_VERSION = 13
-PATCH_VERSION = 2
+PATCH_VERSION = 4
 __short_version__ = f"{MAJOR_VERSION}.{MINOR_VERSION}"
 __version__ = f"{__short_version__}.{PATCH_VERSION}"
diff --git a/lib/plexapi/media.py b/lib/plexapi/media.py
index c8ea8c4e..bf401ee0 100644
--- a/lib/plexapi/media.py
+++ b/lib/plexapi/media.py
@@ -399,6 +399,10 @@ class AudioStream(MediaPartStream):
             self.peak = utils.cast(float, data.attrib.get('peak'))
             self.startRamp = data.attrib.get('startRamp')
 
+    def setDefault(self):
+        """ Sets this audio stream as the default audio stream. """
+        return self._parent().setDefaultAudioStream(self)
+
 
 @utils.registerPlexObject
 class SubtitleStream(MediaPartStream):
@@ -425,6 +429,10 @@ class SubtitleStream(MediaPartStream):
         self.headerCompression = data.attrib.get('headerCompression')
         self.transient = data.attrib.get('transient')
 
+    def setDefault(self):
+        """ Sets this subtitle stream as the default subtitle stream. """
+        return self._parent().setDefaultSubtitleStream(self)
+
 
 class LyricStream(MediaPartStream):
     """ Represents a lyric stream within a :class:`~plexapi.media.MediaPart`.
@@ -1037,9 +1045,11 @@ class Marker(PlexObject):
         Attributes:
             TAG (str): 'Marker'
             end (int): The end time of the marker in milliseconds.
+            final (bool): True if the marker is the final credits marker.
             id (int): The ID of the marker.
             type (str): The type of marker.
             start (int): The start time of the marker in milliseconds.
+            version (int): The Plex marker version.
     """
     TAG = 'Marker'
 
@@ -1053,10 +1063,25 @@ class Marker(PlexObject):
     def _loadData(self, data):
         self._data = data
         self.end = utils.cast(int, data.attrib.get('endTimeOffset'))
+        self.final = utils.cast(bool, data.attrib.get('final'))
         self.id = utils.cast(int, data.attrib.get('id'))
         self.type = data.attrib.get('type')
         self.start = utils.cast(int, data.attrib.get('startTimeOffset'))
 
+        attributes = data.find('Attributes')
+        self.version = attributes.attrib.get('version')
+
+    @property
+    def first(self):
+        """ Returns True if the marker in the first credits marker. """
+        if self.type != 'credits':
+            return None
+        first = min(
+            (marker for marker in self._parent().markers if marker.type == 'credits'),
+            key=lambda m: m.start
+        )
+        return first == self
+
 
 @utils.registerPlexObject
 class Field(PlexObject):
diff --git a/lib/plexapi/mixins.py b/lib/plexapi/mixins.py
index 91c9caaa..b004ad74 100644
--- a/lib/plexapi/mixins.py
+++ b/lib/plexapi/mixins.py
@@ -1,7 +1,7 @@
 # -*- coding: utf-8 -*-
 from datetime import datetime
 
-from urllib.parse import parse_qsl, quote_plus, unquote, urlencode, urlsplit
+from urllib.parse import parse_qsl, quote, quote_plus, unquote, urlencode, urlsplit
 
 from plexapi import media, settings, utils
 from plexapi.exceptions import BadRequest, NotFound
@@ -557,6 +557,24 @@ class EditFieldMixin:
         return self._edit(**edits)
 
 
+class AddedAtMixin(EditFieldMixin):
+    """ Mixin for Plex objects that can have an added at date. """
+
+    def editAddedAt(self, addedAt, locked=True):
+        """ Edit the added at date.
+
+            Parameters:
+                addedAt (int or str or datetime): The new value as a unix timestamp (int),
+                    "YYYY-MM-DD" (str), or datetime object.
+                locked (bool): True (default) to lock the field, False to unlock the field.
+        """
+        if isinstance(addedAt, str):
+            addedAt = int(round(datetime.strptime(addedAt, '%Y-%m-%d').timestamp()))
+        elif isinstance(addedAt, datetime):
+            addedAt = int(round(addedAt.timestamp()))
+        return self.editField('addedAt', addedAt, locked=locked)
+
+
 class ContentRatingMixin(EditFieldMixin):
     """ Mixin for Plex objects that can have a content rating. """
 
@@ -590,7 +608,7 @@ class OriginallyAvailableMixin(EditFieldMixin):
         """ Edit the originally available date.
 
             Parameters:
-                originallyAvailable (str or datetime): The new value (YYYY-MM-DD) or datetime object.
+                originallyAvailable (str or datetime): The new value "YYYY-MM-DD (str) or datetime object.
                 locked (bool): True (default) to lock the field, False to unlock the field.
         """
         if isinstance(originallyAvailable, datetime):
@@ -726,7 +744,7 @@ class PhotoCapturedTimeMixin(EditFieldMixin):
         """ Edit the photo captured time.
 
             Parameters:
-                capturedTime (str or datetime): The new value (YYYY-MM-DD hh:mm:ss) or datetime object.
+                capturedTime (str or datetime): The new value "YYYY-MM-DD hh:mm:ss" (str) or datetime object.
                 locked (bool): True (default) to lock the field, False to unlock the field.
         """
         if isinstance(capturedTime, datetime):
@@ -804,7 +822,7 @@ class EditTagsMixin:
 
         if remove:
             tagname = f'{tag}[].tag.tag-'
-            data[tagname] = ','.join([str(t) for t in items])
+            data[tagname] = ','.join([quote(str(t)) for t in items])
         else:
             for i, item in enumerate(items):
                 tagname = f'{str(tag)}[{i}].tag.tag'
diff --git a/lib/plexapi/photo.py b/lib/plexapi/photo.py
index 28556650..4c3d89b5 100644
--- a/lib/plexapi/photo.py
+++ b/lib/plexapi/photo.py
@@ -8,7 +8,7 @@ from plexapi.exceptions import BadRequest
 from plexapi.mixins import (
     RatingMixin,
     ArtUrlMixin, ArtMixin, PosterUrlMixin, PosterMixin,
-    SortTitleMixin, SummaryMixin, TitleMixin, PhotoCapturedTimeMixin,
+    AddedAtMixin, SortTitleMixin, SummaryMixin, TitleMixin, PhotoCapturedTimeMixin,
     TagMixin
 )
 
@@ -18,7 +18,7 @@ class Photoalbum(
     PlexPartialObject,
     RatingMixin,
     ArtMixin, PosterMixin,
-    SortTitleMixin, SummaryMixin, TitleMixin
+    AddedAtMixin, SortTitleMixin, SummaryMixin, TitleMixin
 ):
     """ Represents a single Photoalbum (collection of photos).
 
@@ -146,7 +146,7 @@ class Photo(
     PlexPartialObject, Playable,
     RatingMixin,
     ArtUrlMixin, PosterUrlMixin,
-    PhotoCapturedTimeMixin, SortTitleMixin, SummaryMixin, TitleMixin,
+    AddedAtMixin, PhotoCapturedTimeMixin, SortTitleMixin, SummaryMixin, TitleMixin,
     TagMixin
 ):
     """ Represents a single Photo.
diff --git a/lib/plexapi/server.py b/lib/plexapi/server.py
index bec9fc08..4a1a51ce 100644
--- a/lib/plexapi/server.py
+++ b/lib/plexapi/server.py
@@ -827,7 +827,7 @@ class PlexServer(PlexObject):
         return notifier
 
     def transcodeImage(self, imageUrl, height, width,
-                       opacity=None, saturation=None, blur=None, background=None,
+                       opacity=None, saturation=None, blur=None, background=None, blendColor=None,
                        minSize=True, upscale=True, imageFormat=None):
         """ Returns the URL for a transcoded image.
 
@@ -842,6 +842,7 @@ class PlexServer(PlexObject):
                 saturation (int, optional): Change the saturation of the image (0 to 100).
                 blur (int, optional): The blur to apply to the image in pixels (e.g. 3).
                 background (str, optional): The background hex colour to apply behind the opacity (e.g. '000000').
+                blendColor (str, optional): The hex colour to blend the image with (e.g. '000000').
                 minSize (bool, optional): Maintain smallest dimension. Default True.
                 upscale (bool, optional): Upscale the image if required. Default True.
                 imageFormat (str, optional): 'jpeg' (default) or 'png'.
@@ -861,6 +862,8 @@ class PlexServer(PlexObject):
             params['blur'] = blur
         if background is not None:
             params['background'] = str(background).strip('#')
+        if blendColor is not None:
+            params['blendColor'] = str(blendColor).strip('#')
         if imageFormat is not None:
             params['format'] = imageFormat.lower()
 
diff --git a/lib/plexapi/utils.py b/lib/plexapi/utils.py
index f429147e..d7d5afd1 100644
--- a/lib/plexapi/utils.py
+++ b/lib/plexapi/utils.py
@@ -53,6 +53,8 @@ SEARCHTYPES = {
     'optimizedVersion': 42,
     'userPlaylistItem': 1001,
 }
+REVERSESEARCHTYPES = {v: k for k, v in SEARCHTYPES.items()}
+
 # Tag Types - Plex uses these to filter specific tags when searching.
 TAGTYPES = {
     'tag': 0,
@@ -91,6 +93,8 @@ TAGTYPES = {
     'network': 319,
     'place': 400,
 }
+REVERSETAGTYPES = {v: k for k, v in TAGTYPES.items()}
+
 # Plex Objects - Populated at runtime
 PLEXOBJECTS = {}
 
@@ -219,11 +223,12 @@ def searchType(libtype):
             :exc:`~plexapi.exceptions.NotFound`: Unknown libtype
     """
     libtype = str(libtype)
-    if libtype in [str(v) for v in SEARCHTYPES.values()]:
-        return libtype
-    if SEARCHTYPES.get(libtype) is not None:
+    try:
         return SEARCHTYPES[libtype]
-    raise NotFound(f'Unknown libtype: {libtype}')
+    except KeyError:
+        if libtype in [str(k) for k in REVERSESEARCHTYPES]:
+            return libtype
+        raise NotFound(f'Unknown libtype: {libtype}') from None
 
 
 def reverseSearchType(libtype):
@@ -235,13 +240,12 @@ def reverseSearchType(libtype):
         Raises:
             :exc:`~plexapi.exceptions.NotFound`: Unknown libtype
     """
-    if libtype in SEARCHTYPES:
-        return libtype
-    libtype = int(libtype)
-    for k, v in SEARCHTYPES.items():
-        if libtype == v:
-            return k
-    raise NotFound(f'Unknown libtype: {libtype}')
+    try:
+        return REVERSESEARCHTYPES[int(libtype)]
+    except (KeyError, ValueError):
+        if libtype in SEARCHTYPES:
+            return libtype
+        raise NotFound(f'Unknown libtype: {libtype}') from None
 
 
 def tagType(tag):
@@ -254,11 +258,12 @@ def tagType(tag):
             :exc:`~plexapi.exceptions.NotFound`: Unknown tag
     """
     tag = str(tag)
-    if tag in [str(v) for v in TAGTYPES.values()]:
-        return tag
-    if TAGTYPES.get(tag) is not None:
+    try:
         return TAGTYPES[tag]
-    raise NotFound(f'Unknown tag: {tag}')
+    except KeyError:
+        if tag in [str(k) for k in REVERSETAGTYPES]:
+            return tag
+        raise NotFound(f'Unknown tag: {tag}') from None
 
 
 def reverseTagType(tag):
@@ -270,13 +275,12 @@ def reverseTagType(tag):
         Raises:
             :exc:`~plexapi.exceptions.NotFound`: Unknown tag
     """
-    if tag in TAGTYPES:
-        return tag
-    tag = int(tag)
-    for k, v in TAGTYPES.items():
-        if tag == v:
-            return k
-    raise NotFound(f'Unknown tag: {tag}')
+    try:
+        return REVERSETAGTYPES[int(tag)]
+    except (KeyError, ValueError):
+        if tag in TAGTYPES:
+            return tag
+        raise NotFound(f'Unknown tag: {tag}') from None
 
 
 def threaded(callback, listargs):
diff --git a/lib/plexapi/video.py b/lib/plexapi/video.py
index fe12ce67..d7f4d665 100644
--- a/lib/plexapi/video.py
+++ b/lib/plexapi/video.py
@@ -8,14 +8,14 @@ from plexapi.exceptions import BadRequest
 from plexapi.mixins import (
     AdvancedSettingsMixin, SplitMergeMixin, UnmatchMatchMixin, ExtrasMixin, HubsMixin, PlayedUnplayedMixin, RatingMixin,
     ArtUrlMixin, ArtMixin, BannerMixin, PosterUrlMixin, PosterMixin, ThemeUrlMixin, ThemeMixin,
-    ContentRatingMixin, EditionTitleMixin, OriginallyAvailableMixin, OriginalTitleMixin, SortTitleMixin, StudioMixin,
-    SummaryMixin, TaglineMixin, TitleMixin,
+    AddedAtMixin, ContentRatingMixin, EditionTitleMixin, OriginallyAvailableMixin, OriginalTitleMixin, SortTitleMixin,
+    StudioMixin, SummaryMixin, TaglineMixin, TitleMixin,
     CollectionMixin, CountryMixin, DirectorMixin, GenreMixin, LabelMixin, ProducerMixin, WriterMixin,
     WatchlistMixin
 )
 
 
-class Video(PlexPartialObject, PlayedUnplayedMixin):
+class Video(PlexPartialObject, PlayedUnplayedMixin, AddedAtMixin):
     """ Base class for all video objects including :class:`~plexapi.video.Movie`,
         :class:`~plexapi.video.Show`, :class:`~plexapi.video.Season`,
         :class:`~plexapi.video.Episode`, and :class:`~plexapi.video.Clip`.
@@ -97,10 +97,25 @@ class Video(PlexPartialObject, PlayedUnplayedMixin):
         """ Returns str, default title for a new syncItem. """
         return self.title
 
+    def videoStreams(self):
+        """ Returns a list of :class:`~plexapi.media.videoStream` objects for all MediaParts. """
+        streams = []
+
+        if self.isPartialObject():
+            self.reload()
+
+        parts = self.iterParts()
+        for part in parts:
+            streams += part.videoStreams()
+        return streams
+
     def audioStreams(self):
         """ Returns a list of :class:`~plexapi.media.AudioStream` objects for all MediaParts. """
         streams = []
 
+        if self.isPartialObject():
+            self.reload()
+
         parts = self.iterParts()
         for part in parts:
             streams += part.audioStreams()
@@ -110,6 +125,9 @@ class Video(PlexPartialObject, PlayedUnplayedMixin):
         """ Returns a list of :class:`~plexapi.media.SubtitleStream` objects for all MediaParts. """
         streams = []
 
+        if self.isPartialObject():
+            self.reload()
+
         parts = self.iterParts()
         for part in parts:
             streams += part.subtitleStreams()
@@ -311,11 +329,13 @@ class Movie(
             directors (List<:class:`~plexapi.media.Director`>): List of director objects.
             duration (int): Duration of the movie in milliseconds.
             editionTitle (str): The edition title of the movie (e.g. Director's Cut, Extended Edition, etc.).
+            enableCreditsMarkerGeneration (int): Setting that indicates if credits markers detection is enabled.
             genres (List<:class:`~plexapi.media.Genre`>): List of genre objects.
             guids (List<:class:`~plexapi.media.Guid`>): List of guid objects.
             labels (List<:class:`~plexapi.media.Label`>): List of label objects.
             languageOverride (str): Setting that indicates if a language is used to override metadata
                 (eg. en-CA, None = Library default).
+            markers (List<:class:`~plexapi.media.Marker`>): List of marker objects.
             media (List<:class:`~plexapi.media.Media`>): List of media objects.
             originallyAvailableAt (datetime): Datetime the movie was released.
             originalTitle (str): Original title, often the foreign title (転々; 엽기적인 그녀).
@@ -353,10 +373,12 @@ class Movie(
         self.directors = self.findItems(data, media.Director)
         self.duration = utils.cast(int, data.attrib.get('duration'))
         self.editionTitle = data.attrib.get('editionTitle')
+        self.enableCreditsMarkerGeneration = utils.cast(int, data.attrib.get('enableCreditsMarkerGeneration', '-1'))
         self.genres = self.findItems(data, media.Genre)
         self.guids = self.findItems(data, media.Guid)
         self.labels = self.findItems(data, media.Label)
         self.languageOverride = data.attrib.get('languageOverride')
+        self.markers = self.findItems(data, media.Marker)
         self.media = self.findItems(data, media.Media)
         self.originallyAvailableAt = utils.toDatetime(data.attrib.get('originallyAvailableAt'), '%Y-%m-%d')
         self.originalTitle = data.attrib.get('originalTitle')
@@ -390,6 +412,11 @@ class Movie(
         """
         return [part.file for part in self.iterParts() if part]
 
+    @property
+    def hasCreditsMarker(self):
+        """ Returns True if the movie has a credits marker. """
+        return any(marker.type == 'credits' for marker in self.markers)
+
     @property
     def hasPreviewThumbnails(self):
         """ Returns True if any of the media parts has generated preview (BIF) thumbnails. """
@@ -432,6 +459,7 @@ class Show(
             TYPE (str): 'show'
             audienceRating (float): Audience rating (TMDB or TVDB).
             audienceRatingImage (str): Key to audience rating image (tmdb://image.rating).
+            audioLanguage (str): Setting that indicates the preferred audio language.
             autoDeletionItemPolicyUnwatchedLibrary (int): Setting that indicates the number of unplayed
                 episodes to keep for the show (0 = All episodes, 5 = 5 latest episodes, 3 = 3 latest episodes,
                 1 = 1 latest episode, -3 = Episodes added in the past 3 days, -7 = Episodes added in the
@@ -440,10 +468,11 @@ class Show(
                 after being watched for the show (0 = Never, 1 = After a day, 7 = After a week,
                 100 = On next refresh).
             banner (str): Key to banner artwork (/library/metadata/<ratingkey>/banner/<bannerid>).
-            childCount (int): Number of seasons in the show.
+            childCount (int): Number of seasons (including Specials) in the show.
             collections (List<:class:`~plexapi.media.Collection`>): List of collection objects.
             contentRating (str) Content rating (PG-13; NR; TV-G).
             duration (int): Typical duration of the show episodes in milliseconds.
+            enableCreditsMarkerGeneration (int): Setting that indicates if credits markers detection is enabled.
             episodeSort (int): Setting that indicates how episodes are sorted for the show
                 (-1 = Library default, 0 = Oldest first, 1 = Newest first).
             flattenSeasons (int): Setting that indicates if seasons are set to hidden for the show
@@ -463,10 +492,14 @@ class Show(
             rating (float): Show rating (7.9; 9.8; 8.1).
             ratings (List<:class:`~plexapi.media.Rating`>): List of rating objects.
             roles (List<:class:`~plexapi.media.Role`>): List of role objects.
+            seasonCount (int): Number of seasons (excluding Specials) in the show.
             showOrdering (str): Setting that indicates the episode ordering for the show
                 (None = Library default).
             similar (List<:class:`~plexapi.media.Similar`>): List of Similar objects.
             studio (str): Studio that created show (Di Bonaventura Pictures; 21 Laps Entertainment).
+            subtitleLanguage (str): Setting that indicates the preferred subtitle language.
+            subtitleMode (int): Setting that indicates the auto-select subtitle mode.
+                (-1 = Account default, 0 = Manually selected, 1 = Shown with foreign audio, 2 = Always enabled).
             tagline (str): Show tag line.
             theme (str): URL to theme resource (/library/metadata/<ratingkey>/theme/<themeid>).
             useOriginalTitle (int): Setting that indicates if the original title is used for the show
@@ -483,6 +516,7 @@ class Show(
         Video._loadData(self, data)
         self.audienceRating = utils.cast(float, data.attrib.get('audienceRating'))
         self.audienceRatingImage = data.attrib.get('audienceRatingImage')
+        self.audioLanguage = data.attrib.get('audioLanguage', '')
         self.autoDeletionItemPolicyUnwatchedLibrary = utils.cast(
             int, data.attrib.get('autoDeletionItemPolicyUnwatchedLibrary', '0'))
         self.autoDeletionItemPolicyWatchedLibrary = utils.cast(
@@ -492,6 +526,7 @@ class Show(
         self.collections = self.findItems(data, media.Collection)
         self.contentRating = data.attrib.get('contentRating')
         self.duration = utils.cast(int, data.attrib.get('duration'))
+        self.enableCreditsMarkerGeneration = utils.cast(int, data.attrib.get('enableCreditsMarkerGeneration', '-1'))
         self.episodeSort = utils.cast(int, data.attrib.get('episodeSort', '-1'))
         self.flattenSeasons = utils.cast(int, data.attrib.get('flattenSeasons', '-1'))
         self.genres = self.findItems(data, media.Genre)
@@ -508,9 +543,12 @@ class Show(
         self.rating = utils.cast(float, data.attrib.get('rating'))
         self.ratings = self.findItems(data, media.Rating)
         self.roles = self.findItems(data, media.Role)
+        self.seasonCount = utils.cast(int, data.attrib.get('seasonCount', self.childCount))
         self.showOrdering = data.attrib.get('showOrdering')
         self.similar = self.findItems(data, media.Similar)
         self.studio = data.attrib.get('studio')
+        self.subtitleLanguage = data.attrib.get('audioLanguage', '')
+        self.subtitleMode = utils.cast(int, data.attrib.get('subtitleMode', '-1'))
         self.tagline = data.attrib.get('tagline')
         self.theme = data.attrib.get('theme')
         self.useOriginalTitle = utils.cast(int, data.attrib.get('useOriginalTitle', '-1'))
@@ -619,7 +657,7 @@ class Show(
 @utils.registerPlexObject
 class Season(
     Video,
-    ExtrasMixin, RatingMixin,
+    AdvancedSettingsMixin, ExtrasMixin, RatingMixin,
     ArtMixin, PosterMixin, ThemeUrlMixin,
     SummaryMixin, TitleMixin,
     CollectionMixin, LabelMixin
@@ -629,6 +667,7 @@ class Season(
         Attributes:
             TAG (str): 'Directory'
             TYPE (str): 'season'
+            audioLanguage (str): Setting that indicates the preferred audio language.
             collections (List<:class:`~plexapi.media.Collection`>): List of collection objects.
             guids (List<:class:`~plexapi.media.Guid`>): List of guid objects.
             index (int): Season number.
@@ -644,6 +683,9 @@ class Season(
             parentThumb (str): URL to show thumbnail image (/library/metadata/<parentRatingKey>/thumb/<thumbid>).
             parentTitle (str): Name of the show for the season.
             ratings (List<:class:`~plexapi.media.Rating`>): List of rating objects.
+            subtitleLanguage (str): Setting that indicates the preferred subtitle language.
+            subtitleMode (int): Setting that indicates the auto-select subtitle mode.
+                (-1 = Series default, 0 = Manually selected, 1 = Shown with foreign audio, 2 = Always enabled).
             viewedLeafCount (int): Number of items marked as played in the season view.
             year (int): Year the season was released.
     """
@@ -654,6 +696,7 @@ class Season(
     def _loadData(self, data):
         """ Load attribute values from Plex XML response. """
         Video._loadData(self, data)
+        self.audioLanguage = data.attrib.get('audioLanguage', '')
         self.collections = self.findItems(data, media.Collection)
         self.guids = self.findItems(data, media.Guid)
         self.index = utils.cast(int, data.attrib.get('index'))
@@ -669,6 +712,8 @@ class Season(
         self.parentThumb = data.attrib.get('parentThumb')
         self.parentTitle = data.attrib.get('parentTitle')
         self.ratings = self.findItems(data, media.Rating)
+        self.subtitleLanguage = data.attrib.get('audioLanguage', '')
+        self.subtitleMode = utils.cast(int, data.attrib.get('subtitleMode', '-1'))
         self.viewedLeafCount = utils.cast(int, data.attrib.get('viewedLeafCount'))
         self.year = utils.cast(int, data.attrib.get('year'))
 
@@ -918,14 +963,19 @@ class Episode(
 
     @property
     def hasCommercialMarker(self):
-        """ Returns True if the episode has a commercial marker in the xml. """
+        """ Returns True if the episode has a commercial marker. """
         return any(marker.type == 'commercial' for marker in self.markers)
 
     @property
     def hasIntroMarker(self):
-        """ Returns True if the episode has an intro marker in the xml. """
+        """ Returns True if the episode has an intro marker. """
         return any(marker.type == 'intro' for marker in self.markers)
 
+    @property
+    def hasCreditsMarker(self):
+        """ Returns True if the episode has a credits marker. """
+        return any(marker.type == 'credits' for marker in self.markers)
+
     @property
     def hasPreviewThumbnails(self):
         """ Returns True if any of the media parts has generated preview (BIF) thumbnails. """
diff --git a/requirements.txt b/requirements.txt
index cb019452..df45bd68 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -28,7 +28,7 @@ MarkupSafe==2.1.2
 musicbrainzngs==0.7.1
 packaging==23.0
 paho-mqtt==1.6.1
-plexapi==4.13.2
+plexapi==4.13.4
 portend==3.1.0
 profilehooks==1.12.0
 PyJWT==2.6.0

From 93d1f10ad3459756420d9541ac1917493fc82891 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 9 Mar 2023 18:15:36 -0800
Subject: [PATCH 372/743] Add credits markers and audio/subtitle settings to
 exporter fields

---
 plexpy/exporter.py | 34 +++++++++++++++++++++++++++++-----
 1 file changed, 29 insertions(+), 5 deletions(-)

diff --git a/plexpy/exporter.py b/plexpy/exporter.py
index 62f4b2ba..9bcb5d06 100644
--- a/plexpy/exporter.py
+++ b/plexpy/exporter.py
@@ -186,6 +186,7 @@ class Export(object):
                 'duration': None,
                 'durationHuman': lambda o: helpers.human_duration(getattr(o, 'duration', 0)),
                 'editionTitle': None,
+                'enableCreditsMarkerGeneration': None,
                 'fields': {
                     'name': None,
                     'locked': None
@@ -198,6 +199,7 @@ class Export(object):
                 'guids': {
                     'id': None
                 },
+                'hasCreditsMarker': None,
                 'hasPreviewThumbnails': None,
                 'key': None,
                 'labels': {
@@ -211,6 +213,14 @@ class Export(object):
                 'librarySectionKey': None,
                 'librarySectionTitle': None,
                 'locations': None,
+                'markers': {
+                    'end': None,
+                    'final': None,
+                    'first': None,
+                    'id': None,
+                    'start': None,
+                    'type': None
+                },
                 'media': {
                     'aspectRatio': None,
                     'audioChannels': None,
@@ -403,6 +413,7 @@ class Export(object):
                 'artFile': lambda o: self.get_image(o, 'art'),
                 'audienceRating': None,
                 'audienceRatingImage': None,
+                'audioLanguage': None,
                 'autoDeletionItemPolicyUnwatchedLibrary': None,
                 'autoDeletionItemPolicyWatchedLibrary': None,
                 'banner': None,
@@ -415,6 +426,7 @@ class Export(object):
                 'contentRating': None,
                 'duration': None,
                 'durationHuman': lambda o: helpers.human_duration(getattr(o, 'duration', 0)),
+                'enableCreditsMarkerGeneration': None,
                 'episodeSort': None,
                 'fields': {
                     'name': None,
@@ -454,8 +466,11 @@ class Export(object):
                     'role': None,
                     'thumb': None
                 },
+                'seasonCount': None,
                 'showOrdering': None,
                 'studio': None,
+                'subtitleLanguage': None,
+                'subtitleMode': None,
                 'summary': None,
                 'tagline': None,
                 'theme': None,
@@ -481,6 +496,7 @@ class Export(object):
                 'art': None,
                 'artBlurHash': None,
                 'artFile': lambda o: self.get_image(o, 'art'),
+                'audioLanguage': None,
                 'collections': {
                     'id': None,
                     'tag': None
@@ -515,6 +531,8 @@ class Export(object):
                 'parentTitle': None,
                 'ratingKey': None,
                 'seasonNumber': None,
+                'subtitleLanguage': None,
+                'subtitleMode': None,
                 'summary': None,
                 'thumb': None,
                 'thumbBlurHash': None,
@@ -576,6 +594,7 @@ class Export(object):
                     'id': None
                 },
                 'hasCommercialMarker': None,
+                'hasCreditsMarker': None,
                 'hasIntroMarker': None,
                 'hasPreviewThumbnails': None,
                 'index': None,
@@ -592,6 +611,9 @@ class Export(object):
                 'locations': None,
                 'markers': {
                     'end': None,
+                    'final': None,
+                    'first': None,
+                    'id': None,
                     'start': None,
                     'type': None
                 },
@@ -1270,12 +1292,14 @@ class Export(object):
                 1: [
                     'ratingKey', 'title', 'titleSort', 'originalTitle', 'editionTitle', 'originallyAvailableAt', 'year', 'addedAt',
                     'rating', 'ratingImage', 'audienceRating', 'audienceRatingImage', 'userRating', 'contentRating',
-                    'studio', 'tagline', 'summary', 'guid', 'duration', 'durationHuman', 'type'
+                    'studio', 'tagline', 'summary', 'guid', 'duration', 'durationHuman', 'type',
+                    'hasCreditsMarker'
                 ],
                 2: [
                     'directors.tag', 'writers.tag', 'producers.tag', 'roles.tag', 'roles.role',
                     'countries.tag', 'genres.tag', 'collections.tag', 'labels.tag',
-                    'fields.name', 'fields.locked', 'guids.id'
+                    'fields.name', 'fields.locked', 'guids.id',
+                    'markers.type', 'markers.start', 'markers.end', 'markers.first', 'markers.final'
                 ],
                 3: [
                     'art', 'thumb', 'key', 'chapterSource',
@@ -1333,7 +1357,7 @@ class Export(object):
                 1: [
                     'ratingKey', 'title', 'titleSort', 'originallyAvailableAt', 'originalTitle', 'year', 'addedAt',
                     'rating', 'audienceRating', 'audienceRatingImage', 'userRating', 'contentRating', 'network',
-                    'studio', 'tagline', 'summary', 'guid', 'duration', 'durationHuman', 'type', 'childCount',
+                    'studio', 'tagline', 'summary', 'guid', 'duration', 'durationHuman', 'type', 'childCount', 'seasonCount',
                     'seasons'
                 ],
                 2: [
@@ -1383,12 +1407,12 @@ class Export(object):
                     'summary', 'guid', 'duration', 'durationHuman', 'type', 'episodeNumber', 'seasonEpisode',
                     'parentTitle', 'parentRatingKey', 'parentGuid', 'parentYear', 'seasonNumber',
                     'grandparentTitle', 'grandparentRatingKey', 'grandparentGuid',
-                    'hasCommercialMarker', 'hasIntroMarker'
+                    'hasCommercialMarker', 'hasCreditsMarker', 'hasIntroMarker'
                 ],
                 2: [
                     'collections.tag', 'directors.tag', 'writers.tag', 'producers.tag', 'roles.tag', 'roles.role',
                     'fields.name', 'fields.locked', 'guids.id',
-                    'markers.type', 'markers.start', 'markers.end'
+                    'markers.type', 'markers.start', 'markers.end', 'markers.first', 'markers.final'
                 ],
                 3: [
                     'art', 'thumb', 'key', 'chapterSource',

From 705fd2d3e8b499b4a7240debe2b4915760d94fa0 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 13 Mar 2023 11:53:56 -0700
Subject: [PATCH 373/743] Bump urllib3 from 1.26.14 to 1.26.15 (#2017)

* Bump urllib3 from 1.26.14 to 1.26.15

Bumps [urllib3](https://github.com/urllib3/urllib3) from 1.26.14 to 1.26.15.
- [Release notes](https://github.com/urllib3/urllib3/releases)
- [Changelog](https://github.com/urllib3/urllib3/blob/main/CHANGES.rst)
- [Commits](https://github.com/urllib3/urllib3/compare/1.26.14...1.26.15)

---
updated-dependencies:
- dependency-name: urllib3
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

* Update urllib3==1.26.15

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/urllib3/_version.py       | 2 +-
 lib/urllib3/connection.py     | 5 +++++
 lib/urllib3/connectionpool.py | 2 +-
 lib/urllib3/util/timeout.py   | 9 ++++++---
 lib/urllib3/util/url.py       | 4 ++--
 requirements.txt              | 2 +-
 6 files changed, 16 insertions(+), 8 deletions(-)

diff --git a/lib/urllib3/_version.py b/lib/urllib3/_version.py
index 7c031661..e12dd0e7 100644
--- a/lib/urllib3/_version.py
+++ b/lib/urllib3/_version.py
@@ -1,2 +1,2 @@
 # This file is protected via CODEOWNERS
-__version__ = "1.26.14"
+__version__ = "1.26.15"
diff --git a/lib/urllib3/connection.py b/lib/urllib3/connection.py
index 10fb36c4..54b96b19 100644
--- a/lib/urllib3/connection.py
+++ b/lib/urllib3/connection.py
@@ -229,6 +229,11 @@ class HTTPConnection(_HTTPConnection, object):
             )
 
     def request(self, method, url, body=None, headers=None):
+        # Update the inner socket's timeout value to send the request.
+        # This only triggers if the connection is re-used.
+        if getattr(self, "sock", None) is not None:
+            self.sock.settimeout(self.timeout)
+
         if headers is None:
             headers = {}
         else:
diff --git a/lib/urllib3/connectionpool.py b/lib/urllib3/connectionpool.py
index 70873927..c23d736b 100644
--- a/lib/urllib3/connectionpool.py
+++ b/lib/urllib3/connectionpool.py
@@ -379,7 +379,7 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
 
         timeout_obj = self._get_timeout(timeout)
         timeout_obj.start_connect()
-        conn.timeout = timeout_obj.connect_timeout
+        conn.timeout = Timeout.resolve_default_timeout(timeout_obj.connect_timeout)
 
         # Trigger any extra validation we need to do.
         try:
diff --git a/lib/urllib3/util/timeout.py b/lib/urllib3/util/timeout.py
index ff69593b..78e18a62 100644
--- a/lib/urllib3/util/timeout.py
+++ b/lib/urllib3/util/timeout.py
@@ -2,9 +2,8 @@ from __future__ import absolute_import
 
 import time
 
-# The default socket timeout, used by httplib to indicate that no timeout was
-# specified by the user
-from socket import _GLOBAL_DEFAULT_TIMEOUT
+# The default socket timeout, used by httplib to indicate that no timeout was; specified by the user
+from socket import _GLOBAL_DEFAULT_TIMEOUT, getdefaulttimeout
 
 from ..exceptions import TimeoutStateError
 
@@ -116,6 +115,10 @@ class Timeout(object):
     # __str__ provided for backwards compatibility
     __str__ = __repr__
 
+    @classmethod
+    def resolve_default_timeout(cls, timeout):
+        return getdefaulttimeout() if timeout is cls.DEFAULT_TIMEOUT else timeout
+
     @classmethod
     def _validate_timeout(cls, value, name):
         """Check that a timeout attribute is valid.
diff --git a/lib/urllib3/util/url.py b/lib/urllib3/util/url.py
index 3a169a43..e5682d3b 100644
--- a/lib/urllib3/util/url.py
+++ b/lib/urllib3/util/url.py
@@ -50,7 +50,7 @@ _variations = [
     "(?:(?:%(hex)s:){0,6}%(hex)s)?::",
 ]
 
-UNRESERVED_PAT = r"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789._!\-~"
+UNRESERVED_PAT = r"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789._\-~"
 IPV6_PAT = "(?:" + "|".join([x % _subs for x in _variations]) + ")"
 ZONE_ID_PAT = "(?:%25|%)(?:[" + UNRESERVED_PAT + "]|%[a-fA-F0-9]{2})+"
 IPV6_ADDRZ_PAT = r"\[" + IPV6_PAT + r"(?:" + ZONE_ID_PAT + r")?\]"
@@ -303,7 +303,7 @@ def _normalize_host(host, scheme):
 
 
 def _idna_encode(name):
-    if name and any([ord(x) > 128 for x in name]):
+    if name and any(ord(x) >= 128 for x in name):
         try:
             import idna
         except ImportError:
diff --git a/requirements.txt b/requirements.txt
index df45bd68..49c32ff6 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -46,7 +46,7 @@ tempora==5.2.1
 tokenize-rt==5.0.0
 tzdata==2022.7
 tzlocal==4.2
-urllib3==1.26.14
+urllib3==1.26.15
 webencodings==0.5.1
 websocket-client==1.5.1
 xmltodict==0.13.0

From 2dd9272f569db25a462d9e7c2391d0aa4f175af9 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 13 Mar 2023 12:04:47 -0700
Subject: [PATCH 374/743] Remove extra space in doc strings

---
 plexpy/webserve.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/plexpy/webserve.py b/plexpy/webserve.py
index dd0d4528..0fa2dcfd 100644
--- a/plexpy/webserve.py
+++ b/plexpy/webserve.py
@@ -4479,7 +4479,7 @@ class WebInterface(object):
                 rating_key (str):       Rating key of the item
 
             Optional parameters:
-                media_type (str):        Media type of the item (only required for a collection)
+                media_type (str):       Media type of the item (only required for a collection)
                 grouping (int):         0 or 1
                 query_days (str):       Comma separated days, e.g. "1,7,30,0"
 
@@ -4537,7 +4537,7 @@ class WebInterface(object):
                 rating_key (str):       Rating key of the item
 
             Optional parameters:
-                media_type (str):        Media type of the item (only required for a collection)
+                media_type (str):       Media type of the item (only required for a collection)
                 grouping (int):         0 or 1
 
             Returns:

From ea5b43419d8376545c907d5c30671b59a4ca9c4f Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 13 Mar 2023 12:11:50 -0700
Subject: [PATCH 375/743] Add last_refreshed to get_library_media_info doc
 string

---
 plexpy/webserve.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/plexpy/webserve.py b/plexpy/webserve.py
index 0fa2dcfd..c71addb1 100644
--- a/plexpy/webserve.py
+++ b/plexpy/webserve.py
@@ -775,6 +775,7 @@ class WebInterface(object):
             Returns:
                 json:
                     {"draw": 1,
+                     "last_refreshed": 1678734670,
                      "recordsTotal": 82,
                      "recordsFiltered": 82,
                      "filtered_file_size": 2616760056742,

From 41f935e1ed8e3557ffb1956833523ee06f530ea6 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 13 Mar 2023 12:00:30 -0700
Subject: [PATCH 376/743] v2.12.0

---
 CHANGELOG.md      | 7 +++++--
 plexpy/version.py | 4 ++--
 2 files changed, 7 insertions(+), 4 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index d99eb976..02531e2a 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,6 +1,6 @@
 # Changelog
 
-## v2.12.0-beta (2023-03-03)
+## v2.12.0 (2023-03-13)
 
 * Notifications:
   * New: Added support for Telegram group topics. (#1980)
@@ -13,18 +13,21 @@
   * Change: Trigger watched notifications based on the video watched completion behaviour setting.
 * Exporter:
   * Fix: Unable to run exporter when using the Snap package. (#2007)
+  * New: Added credits marker, and audio/subtitle settings to export fields.
 * UI:
+  * Fix: Incorrect styling and missing content for collection media info pages.
   * New: Added edition details field on movie media info pages. (#1957) (Thanks @herby2212)
   * New: Added setting to change the video watched completion behaviour.
   * New: Added watch time and user statistics to collection and playlist media info pages. (#1982, #2012) (Thanks @herby2212)
   * New: Added history table to collection and playlist media info pages.
   * New: Dynamically change watched status in the UI based on video watched completion behaviour setting.
-  * Fix: Incorrect styling and missing content for collection media info pages.
+  * New: Added hidden setting to override server name.
   * Change: Move track artist to a details field instead of in the title on track media info pages.
 * API:
   * New: Added section_id and user_id parameters to get_home_stats API command. (#1944)
   * New: Added marker info to get_metadata API command results.
   * New: Added media_type parameter to get_item_watch_time_stats and get_item_user_stats API commands. (#1982) (Thanks @herby2212)
+  * New: Added last_refreshed timestamp to get_library_media_info API command response.
 * Other:
   * Change: Migrate analytics to Google Analytics 4.
 
diff --git a/plexpy/version.py b/plexpy/version.py
index c11f3506..f56b0784 100644
--- a/plexpy/version.py
+++ b/plexpy/version.py
@@ -17,5 +17,5 @@
 
 from __future__ import unicode_literals
 
-PLEXPY_BRANCH = "beta"
-PLEXPY_RELEASE_VERSION = "v2.12.0-beta"
\ No newline at end of file
+PLEXPY_BRANCH = "master"
+PLEXPY_RELEASE_VERSION = "v2.12.0"
\ No newline at end of file

From e5f55d7fe7421568ad9faa78a0c0f7ae6b6badde Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 14 Mar 2023 11:19:50 -0700
Subject: [PATCH 377/743] Remove checking for synced items for sessions

---
 plexpy/pmsconnect.py | 84 ++++++++------------------------------------
 1 file changed, 14 insertions(+), 70 deletions(-)

diff --git a/plexpy/pmsconnect.py b/plexpy/pmsconnect.py
index 1d161a04..ea41e838 100644
--- a/plexpy/pmsconnect.py
+++ b/plexpy/pmsconnect.py
@@ -1908,40 +1908,7 @@ class PmsConnect(object):
         transcode_details['transcode_hw_decoding'] = int(transcode_details['transcode_hw_decode'].lower() in common.HW_DECODERS)
         transcode_details['transcode_hw_encoding'] = int(transcode_details['transcode_hw_encode'].lower() in common.HW_ENCODERS)
 
-        # Determine if a synced version is being played
-        sync_id = synced_session_data = synced_item_details = None
-        if media_type not in ('photo', 'clip') \
-                and not session.getElementsByTagName('Session') \
-                and not session.getElementsByTagName('TranscodeSession') \
-                and helpers.get_xml_attr(session, 'ratingKey').isdigit() \
-                and plexpy.CONFIG.PMS_PLEXPASS:
-            plex_tv = plextv.PlexTV()
-            parent_rating_key = helpers.get_xml_attr(session, 'parentRatingKey')
-            grandparent_rating_key = helpers.get_xml_attr(session, 'grandparentRatingKey')
-
-            synced_items = plex_tv.get_synced_items(client_id_filter=player_details['machine_id'],
-                                                    rating_key_filter=[rating_key, parent_rating_key, grandparent_rating_key])
-            if synced_items:
-                synced_item_details = synced_items[0]
-                sync_id = synced_item_details['sync_id']
-                synced_xml = self.get_sync_item(sync_id=sync_id, output_format='xml')
-                synced_xml_head = synced_xml.getElementsByTagName('MediaContainer')
-
-                synced_xml_items = []
-                if synced_xml_head[0].getElementsByTagName('Track'):
-                    synced_xml_items = synced_xml_head[0].getElementsByTagName('Track')
-                elif synced_xml_head[0].getElementsByTagName('Video'):
-                    synced_xml_items = synced_xml_head[0].getElementsByTagName('Video')
-
-                for synced_session_data in synced_xml_items:
-                    if helpers.get_xml_attr(synced_session_data, 'ratingKey') == rating_key:
-                        break
-
-        # Figure out which version is being played
-        if sync_id and synced_session_data:
-            media_info_all = synced_session_data.getElementsByTagName('Media')
-        else:
-            media_info_all = session.getElementsByTagName('Media')
+        media_info_all = session.getElementsByTagName('Media')
         stream_media_info = next((m for m in media_info_all if helpers.get_xml_attr(m, 'selected') == '1'), media_info_all[0])
         part_info_all = stream_media_info.getElementsByTagName('Part')
         stream_media_parts_info = next((p for p in part_info_all if helpers.get_xml_attr(p, 'selected') == '1'), part_info_all[0])
@@ -2077,10 +2044,10 @@ class PmsConnect(object):
                           'stream_video_framerate': helpers.get_xml_attr(stream_media_info, 'videoFrameRate'),
                           'stream_video_resolution': stream_video_resolution,
                           'stream_duration': helpers.get_xml_attr(stream_media_info, 'duration') or helpers.get_xml_attr(session, 'duration'),
-                          'stream_container_decision': 'direct play' if sync_id else helpers.get_xml_attr(stream_media_parts_info, 'decision').replace('directplay', 'direct play'),
+                          'stream_container_decision': helpers.get_xml_attr(stream_media_parts_info, 'decision').replace('directplay', 'direct play'),
                           'optimized_version': int(helpers.get_xml_attr(stream_media_info, 'proxyType') == '42'),
                           'optimized_version_title': helpers.get_xml_attr(stream_media_info, 'title'),
-                          'synced_version': 1 if sync_id else 0,
+                          'synced_version': 0,
                           'live': int(helpers.get_xml_attr(session, 'live') == '1'),
                           'live_uuid': helpers.get_xml_attr(stream_media_info, 'uuid'),
                           'indexes': int(indexes == 'sd'),
@@ -2162,12 +2129,8 @@ class PmsConnect(object):
             media_id = helpers.get_xml_attr(stream_media_info, 'id')
             part_id = helpers.get_xml_attr(stream_media_parts_info, 'id')
 
-            if sync_id:
-                metadata_details = self.get_metadata_details(rating_key=rating_key, sync_id=sync_id,
-                                                             skip_cache=skip_cache, cache_key=session_key)
-            else:
-                metadata_details = self.get_metadata_details(rating_key=rating_key,
-                                                             skip_cache=skip_cache, cache_key=session_key)
+            metadata_details = self.get_metadata_details(rating_key=rating_key,
+                                                         skip_cache=skip_cache, cache_key=session_key)
 
             # Get the media info, fallback to first item if match id is not found
             source_medias = metadata_details.pop('media_info', [])
@@ -2278,16 +2241,7 @@ class PmsConnect(object):
 
         # Get the quality profile
         if media_type in ('movie', 'episode', 'clip') and 'stream_bitrate' in stream_details:
-            if sync_id:
-                quality_profile = 'Original'
-
-                synced_item_bitrate = helpers.cast_to_int(synced_item_details['video_bitrate'])
-                try:
-                    synced_bitrate = max(b for b in common.VIDEO_QUALITY_PROFILES if b <= synced_item_bitrate)
-                    synced_version_profile = common.VIDEO_QUALITY_PROFILES[synced_bitrate]
-                except ValueError:
-                    synced_version_profile = 'Original'
-            elif video_details['stream_video_decision'] == 'transcode':
+            if video_details['stream_video_decision'] == 'transcode':
                 synced_version_profile = ''
 
                 stream_bitrate = helpers.cast_to_int(stream_details['stream_bitrate'])
@@ -2310,26 +2264,16 @@ class PmsConnect(object):
                 optimized_version_profile = ''
 
         elif media_type == 'track' and 'stream_bitrate' in stream_details:
-            if sync_id:
+            synced_version_profile = ''
+
+            stream_bitrate = helpers.cast_to_int(stream_details['stream_bitrate'])
+            source_bitrate = helpers.cast_to_int(source_media_details.get('bitrate'))
+            try:
+                quailtiy_bitrate = min(b for b in common.AUDIO_QUALITY_PROFILES if stream_bitrate <= b <= source_bitrate)
+                quality_profile = common.AUDIO_QUALITY_PROFILES[quailtiy_bitrate]
+            except ValueError:
                 quality_profile = 'Original'
 
-                synced_item_bitrate = helpers.cast_to_int(synced_item_details['audio_bitrate'])
-                try:
-                    synced_bitrate = max(b for b in common.AUDIO_QUALITY_PROFILES if b <= synced_item_bitrate)
-                    synced_version_profile = common.AUDIO_QUALITY_PROFILES[synced_bitrate]
-                except ValueError:
-                    synced_version_profile = 'Original'
-            else:
-                synced_version_profile = ''
-
-                stream_bitrate = helpers.cast_to_int(stream_details['stream_bitrate'])
-                source_bitrate = helpers.cast_to_int(source_media_details.get('bitrate'))
-                try:
-                    quailtiy_bitrate = min(b for b in common.AUDIO_QUALITY_PROFILES if stream_bitrate <= b <= source_bitrate)
-                    quality_profile = common.AUDIO_QUALITY_PROFILES[quailtiy_bitrate]
-                except ValueError:
-                    quality_profile = 'Original'
-
             optimized_version_profile = ''
 
         elif media_type == 'photo':

From 8664570a78301d9d7be5bf5d11aa3c9459674150 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 14 Mar 2023 12:21:45 -0700
Subject: [PATCH 378/743] Don't show audio language for music on activity card

---
 data/interfaces/default/current_activity_instance.html | 9 ++++++---
 data/interfaces/default/index.html                     | 7 ++++---
 2 files changed, 10 insertions(+), 6 deletions(-)

diff --git a/data/interfaces/default/current_activity_instance.html b/data/interfaces/default/current_activity_instance.html
index b48a70f3..64b498e0 100644
--- a/data/interfaces/default/current_activity_instance.html
+++ b/data/interfaces/default/current_activity_instance.html
@@ -265,12 +265,15 @@ DOCUMENTATION :: END
                                 <div class="sub-heading">Audio</div>
                                 <div class="sub-value" id="audio_decision-${sk}">
                                     % if data['stream_audio_decision']:
+                                        <%
+                                            audio_language = (data['audio_language'] or 'Unknown') +  ' - ' if data['media_type'] != 'track' else ''
+                                        %>
                                         % if data['stream_audio_decision'] == 'transcode':
-                                        Transcode (${data['audio_language'] or 'Unknown'} - ${AUDIO_CODEC_OVERRIDES.get(data['audio_codec'], data['audio_codec'].upper())} ${data['audio_channel_layout'].split('(')[0].capitalize()} <i class="fa fa-long-arrow-right"></i> ${AUDIO_CODEC_OVERRIDES.get(data['stream_audio_codec'], data['stream_audio_codec'].upper())} ${data['stream_audio_channel_layout'].split('(')[0].capitalize()})
+                                        Transcode (${audio_language}${AUDIO_CODEC_OVERRIDES.get(data['audio_codec'], data['audio_codec'].upper())} ${data['audio_channel_layout'].split('(')[0].capitalize()} <i class="fa fa-long-arrow-right"></i> ${AUDIO_CODEC_OVERRIDES.get(data['stream_audio_codec'], data['stream_audio_codec'].upper())} ${data['stream_audio_channel_layout'].split('(')[0].capitalize()})
                                         % elif data['stream_audio_decision'] == 'copy':
-                                        Direct Stream (${data['audio_language'] or 'Unknown'} - ${AUDIO_CODEC_OVERRIDES.get(data['stream_audio_codec'], data['stream_audio_codec'].upper())} ${data['stream_audio_channel_layout'].split('(')[0].capitalize()})
+                                        Direct Stream (${audio_language}${AUDIO_CODEC_OVERRIDES.get(data['stream_audio_codec'], data['stream_audio_codec'].upper())} ${data['stream_audio_channel_layout'].split('(')[0].capitalize()})
                                         % else:
-                                        Direct Play (${data['audio_language'] or 'Unknown'} - ${AUDIO_CODEC_OVERRIDES.get(data['stream_audio_codec'], data['stream_audio_codec'].upper())} ${data['stream_audio_channel_layout'].split('(')[0].capitalize()})
+                                        Direct Play (${audio_language}${AUDIO_CODEC_OVERRIDES.get(data['stream_audio_codec'], data['stream_audio_codec'].upper())} ${data['stream_audio_channel_layout'].split('(')[0].capitalize()})
                                         % endif
                                     % endif
                                 </div>
diff --git a/data/interfaces/default/index.html b/data/interfaces/default/index.html
index e094d0e4..88d973da 100644
--- a/data/interfaces/default/index.html
+++ b/data/interfaces/default/index.html
@@ -523,14 +523,15 @@
 
                         var audio_decision = '';
                         if (['movie', 'episode', 'clip', 'track'].indexOf(s.media_type) > -1 && s.stream_audio_decision) {
+                            var audio_language = (s.media_type !== 'track') ? (s.audio_language || 'Unknown') + ' - ' : '';
                             var a_codec = (s.audio_codec === 'truehd') ? 'TrueHD' : s.audio_codec.toUpperCase();
                             var sa_codec = (s.stream_audio_codec === 'truehd') ? 'TrueHD' : s.stream_audio_codec.toUpperCase();
                             if (s.stream_audio_decision === 'transcode') {
-                                audio_decision = 'Transcode ('+ (s.audio_language || 'Unknown')+ ' - ' + a_codec + ' ' + capitalizeFirstLetter(s.audio_channel_layout.split('(')[0]) + ' <i class="fa fa-long-arrow-right"></i> ' + sa_codec + ' ' + capitalizeFirstLetter(s.stream_audio_channel_layout.split('(')[0]) + ')';
+                                audio_decision = 'Transcode (' + audio_language + a_codec + ' ' + capitalizeFirstLetter(s.audio_channel_layout.split('(')[0]) + ' <i class="fa fa-long-arrow-right"></i> ' + sa_codec + ' ' + capitalizeFirstLetter(s.stream_audio_channel_layout.split('(')[0]) + ')';
                             } else if (s.stream_audio_decision === 'copy') {
-                                audio_decision = 'Direct Stream ('+ (s.audio_language || 'Unknown')+ ' - ' + sa_codec + ' ' + capitalizeFirstLetter(s.stream_audio_channel_layout.split('(')[0]) + ')';
+                                audio_decision = 'Direct Stream (' + audio_language + sa_codec + ' ' + capitalizeFirstLetter(s.stream_audio_channel_layout.split('(')[0]) + ')';
                             } else {
-                                audio_decision = 'Direct Play ('+ (s.audio_language || 'Unknown')+ ' - ' + sa_codec + ' ' + capitalizeFirstLetter(s.stream_audio_channel_layout.split('(')[0]) + ')';
+                                audio_decision = 'Direct Play (' + audio_language + sa_codec + ' ' + capitalizeFirstLetter(s.stream_audio_channel_layout.split('(')[0]) + ')';
                             }
                         }
                         $('#audio_decision-' + key).html(audio_decision);

From 93081e3f6d2d272e7c0099302341c3e5600e203e Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 14 Mar 2023 13:02:49 -0700
Subject: [PATCH 379/743] Trim analytic event platform version for macOS

---
 plexpy/__init__.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/plexpy/__init__.py b/plexpy/__init__.py
index 993436b8..781dbed7 100644
--- a/plexpy/__init__.py
+++ b/plexpy/__init__.py
@@ -2859,7 +2859,7 @@ def analytics_event(name, **kwargs):
     event.set_event_param('branch', CONFIG.GIT_BRANCH)
     event.set_event_param('platform', common.PLATFORM)
     event.set_event_param('platformRelease', common.PLATFORM_RELEASE)
-    event.set_event_param('platformVersion', common.PLATFORM_VERSION)
+    event.set_event_param('platformVersion', common.PLATFORM_VERSION.split(';', 1)[0] if common.PLATFORM == 'Darwin' else common.PLATFORM_VERSION)
     event.set_event_param('linuxDistro', common.PLATFORM_LINUX_DISTRO)
     event.set_event_param('pythonVersion', common.PYTHON_VERSION)
     event.set_event_param('language', SYS_LANGUAGE)

From 710dd7955f572a78213a131d4494629baf10aa13 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 14 Mar 2023 13:05:49 -0700
Subject: [PATCH 380/743] v2.12.1

---
 CHANGELOG.md      | 9 +++++++++
 plexpy/version.py | 2 +-
 2 files changed, 10 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 02531e2a..79850531 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,14 @@
 # Changelog
 
+## v2.12.1 (2023-03-14)
+
+* Activity:
+  * Fix: Stop checking for deprecated sync items sessions.
+  * Change: Do not show audio language on activity cards for music.
+* Other:
+  * Fix: Tautulli not starting on macOS.
+
+
 ## v2.12.0 (2023-03-13)
 
 * Notifications:
diff --git a/plexpy/version.py b/plexpy/version.py
index f56b0784..6dd3c46a 100644
--- a/plexpy/version.py
+++ b/plexpy/version.py
@@ -18,4 +18,4 @@
 from __future__ import unicode_literals
 
 PLEXPY_BRANCH = "master"
-PLEXPY_RELEASE_VERSION = "v2.12.0"
\ No newline at end of file
+PLEXPY_RELEASE_VERSION = "v2.12.1"
\ No newline at end of file

From ab7e559f3991e5912dcb3785e7f282ad75e2d278 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Wed, 15 Mar 2023 17:14:53 -0700
Subject: [PATCH 381/743] Limit platform version to 100 characters

---
 plexpy/__init__.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/plexpy/__init__.py b/plexpy/__init__.py
index 781dbed7..2a769374 100644
--- a/plexpy/__init__.py
+++ b/plexpy/__init__.py
@@ -2859,7 +2859,7 @@ def analytics_event(name, **kwargs):
     event.set_event_param('branch', CONFIG.GIT_BRANCH)
     event.set_event_param('platform', common.PLATFORM)
     event.set_event_param('platformRelease', common.PLATFORM_RELEASE)
-    event.set_event_param('platformVersion', common.PLATFORM_VERSION.split(';', 1)[0] if common.PLATFORM == 'Darwin' else common.PLATFORM_VERSION)
+    event.set_event_param('platformVersion', common.PLATFORM_VERSION[:100])
     event.set_event_param('linuxDistro', common.PLATFORM_LINUX_DISTRO)
     event.set_event_param('pythonVersion', common.PYTHON_VERSION)
     event.set_event_param('language', SYS_LANGUAGE)

From 7836dc84033130367be7b28673417abb514e7ffe Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 16 Mar 2023 18:29:42 -0700
Subject: [PATCH 382/743] v2.12.2

---
 CHANGELOG.md      | 6 ++++++
 plexpy/version.py | 2 +-
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 79850531..c8463420 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,11 @@
 # Changelog
 
+## v2.12.2 (2023-03-16)
+
+* Other:
+  * Fix: Tautulli not starting on FreeBSD jails.
+
+
 ## v2.12.1 (2023-03-14)
 
 * Activity:
diff --git a/plexpy/version.py b/plexpy/version.py
index 6dd3c46a..7180028b 100644
--- a/plexpy/version.py
+++ b/plexpy/version.py
@@ -18,4 +18,4 @@
 from __future__ import unicode_literals
 
 PLEXPY_BRANCH = "master"
-PLEXPY_RELEASE_VERSION = "v2.12.1"
\ No newline at end of file
+PLEXPY_RELEASE_VERSION = "v2.12.2"
\ No newline at end of file

From 18110206d68b943f4c0709ebc25abe67b7a00a0b Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 16 Mar 2023 22:02:44 -0700
Subject: [PATCH 383/743] Fallback subtitle decision if transcoding subtitles

---
 plexpy/pmsconnect.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/plexpy/pmsconnect.py b/plexpy/pmsconnect.py
index ea41e838..7f81ed99 100644
--- a/plexpy/pmsconnect.py
+++ b/plexpy/pmsconnect.py
@@ -2008,7 +2008,7 @@ class PmsConnect(object):
                                 'stream_subtitle_location': helpers.get_xml_attr(subtitle_stream_info, 'location'),
                                 'stream_subtitle_language': helpers.get_xml_attr(subtitle_stream_info, 'language'),
                                 'stream_subtitle_language_code': helpers.get_xml_attr(subtitle_stream_info, 'languageCode'),
-                                'stream_subtitle_decision': helpers.get_xml_attr(subtitle_stream_info, 'decision'),
+                                'stream_subtitle_decision': helpers.get_xml_attr(subtitle_stream_info, 'decision') or transcode_details['subtitle_decision'],
                                 'stream_subtitle_transient': int(helpers.get_xml_attr(subtitle_stream_info, 'transient') == '1')
                                 }
         else:

From eb7a4fb4bf012d9b5c77d5721be040550619e6ac Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Wed, 22 Mar 2023 16:48:42 -0700
Subject: [PATCH 384/743] Fix calculating media info file sizes

---
 plexpy/libraries.py  | 162 ++++++++++++++++++++-----------------------
 plexpy/pmsconnect.py |  22 ++++--
 plexpy/webserve.py   |   3 +
 3 files changed, 94 insertions(+), 93 deletions(-)

diff --git a/plexpy/libraries.py b/plexpy/libraries.py
index 8042378c..ba30efa9 100644
--- a/plexpy/libraries.py
+++ b/plexpy/libraries.py
@@ -514,39 +514,8 @@ class Libraries(object):
             watched_list[str(item[group_by])] = {'last_played': item['last_played'],
                                                  'play_count': item['play_count']}
 
-        cache_time = None
-        rows = []
         # Import media info cache from json file
-        if rating_key:
-            try:
-                inFilePath = os.path.join(plexpy.CONFIG.CACHE_DIR,'media_info_%s-%s.json' % (section_id, rating_key))
-                with open(inFilePath, 'r') as inFile:
-                    data = json.load(inFile)
-                    if isinstance(data, dict):
-                        cache_time = data['last_refreshed']
-                        rows = data['rows']
-                    else:
-                        rows = data
-                    library_count = len(rows)
-            except IOError as e:
-                #logger.debug("Tautulli Libraries :: No JSON file for rating_key %s." % rating_key)
-                #logger.debug("Tautulli Libraries :: Refreshing data and creating new JSON file for rating_key %s." % rating_key)
-                pass
-        elif section_id:
-            try:
-                inFilePath = os.path.join(plexpy.CONFIG.CACHE_DIR,'media_info_%s.json' % section_id)
-                with open(inFilePath, 'r') as inFile:
-                    data = json.load(inFile)
-                    if isinstance(data, dict):
-                        cache_time = data['last_refreshed']
-                        rows = data['rows']
-                    else:
-                        rows = data
-                    library_count = len(rows)
-            except IOError as e:
-                #logger.debug("Tautulli Libraries :: No JSON file for library section_id %s." % section_id)
-                #logger.debug("Tautulli Libraries :: Refreshing data and creating new JSON file for section_id %s." % section_id)
-                pass
+        cache_time, rows, library_count = self._load_media_info_cache(section_id=section_id, rating_key=rating_key)
 
         # If no cache was imported, get all library children items
         cached_items = {d['rating_key']: d['file_size'] for d in rows} if not refresh else {}
@@ -606,22 +575,7 @@ class Libraries(object):
                 return default_return
 
             # Cache the media info to a json file
-            cache_time = helpers.timestamp()
-            
-            if rating_key:
-                try:
-                    outFilePath = os.path.join(plexpy.CONFIG.CACHE_DIR,'media_info_%s-%s.json' % (section_id, rating_key))
-                    with open(outFilePath, 'w') as outFile:
-                        json.dump({'last_refreshed': cache_time, 'rows': rows}, outFile)
-                except IOError as e:
-                    logger.debug("Tautulli Libraries :: Unable to create cache file for rating_key %s." % rating_key)
-            elif section_id:
-                try:
-                    outFilePath = os.path.join(plexpy.CONFIG.CACHE_DIR,'media_info_%s.json' % section_id)
-                    with open(outFilePath, 'w') as outFile:
-                        json.dump({'last_refreshed': cache_time, 'rows': rows}, outFile)
-                except IOError as e:
-                    logger.debug("Tautulli Libraries :: Unable to create cache file for section_id %s." % section_id)
+            self._save_media_info_cache(section_id=section_id, rating_key=rating_key, rows=rows)
 
         # Update the last_played and play_count
         for item in rows:
@@ -707,30 +661,15 @@ class Libraries(object):
         if library_details['section_type'] == 'photo':
             return False
 
-        rows = []
         # Import media info cache from json file
-        if rating_key:
-            #logger.debug("Tautulli Libraries :: Getting file sizes for rating_key %s." % rating_key)
-            try:
-                inFilePath = os.path.join(plexpy.CONFIG.CACHE_DIR,'media_info_%s-%s.json' % (section_id, rating_key))
-                with open(inFilePath, 'r') as inFile:
-                    rows = json.load(inFile)
-            except IOError as e:
-                #logger.debug("Tautulli Libraries :: No JSON file for rating_key %s." % rating_key)
-                #logger.debug("Tautulli Libraries :: Refreshing data and creating new JSON file for rating_key %s." % rating_key)
-                pass
-        elif section_id:
-            logger.debug("Tautulli Libraries :: Getting file sizes for section_id %s." % section_id)
-            try:
-                inFilePath = os.path.join(plexpy.CONFIG.CACHE_DIR,'media_info_%s.json' % section_id)
-                with open(inFilePath, 'r') as inFile:
-                    rows = json.load(inFile)
-            except IOError as e:
-                #logger.debug("Tautulli Libraries :: No JSON file for library section_id %s." % section_id)
-                #logger.debug("Tautulli Libraries :: Refreshing data and creating new JSON file for section_id %s." % section_id)
-                pass
+        _, rows, _ = self._load_media_info_cache(section_id=section_id, rating_key=rating_key)
 
         # Get the total file size for each item
+        if rating_key:
+            logger.debug("Tautulli Libraries :: Getting file sizes for rating_key %s." % rating_key)
+        elif section_id:
+            logger.debug("Tautulli Libraries :: Fetting file sizes for section_id %s." % section_id)
+
         pms_connect = pmsconnect.PmsConnect()
 
         for item in rows:
@@ -738,7 +677,9 @@ class Libraries(object):
                 file_size = 0
 
                 metadata = pms_connect.get_metadata_children_details(rating_key=item['rating_key'],
-                                                                     get_children=True)
+                                                                     get_children=True,
+                                                                     media_type=item['media_type'],
+                                                                     section_id=section_id)
 
                 for child_metadata in metadata:
                     ## TODO: Check list of media info items, currently only grabs first item
@@ -754,28 +695,77 @@ class Libraries(object):
                 item['file_size'] = file_size
 
         # Cache the media info to a json file
-        if rating_key:
-            try:
-                outFilePath = os.path.join(plexpy.CONFIG.CACHE_DIR,'media_info_%s-%s.json' % (section_id, rating_key))
-                with open(outFilePath, 'w') as outFile:
-                    json.dump(rows, outFile)
-            except IOError as e:
-                logger.debug("Tautulli Libraries :: Unable to create cache file with file sizes for rating_key %s." % rating_key)
-        elif section_id:
-            try:
-                outFilePath = os.path.join(plexpy.CONFIG.CACHE_DIR,'media_info_%s.json' % section_id)
-                with open(outFilePath, 'w') as outFile:
-                    json.dump(rows, outFile)
-            except IOError as e:
-                logger.debug("Tautulli Libraries :: Unable to create cache file with file sizes for section_id %s." % section_id)
+        self._save_media_info_cache(section_id=section_id, rating_key=rating_key, rows=rows)
 
         if rating_key:
-            #logger.debug("Tautulli Libraries :: File sizes updated for rating_key %s." % rating_key)
-            pass
+            logger.debug("Tautulli Libraries :: File sizes updated for rating_key %s." % rating_key)
         elif section_id:
             logger.debug("Tautulli Libraries :: File sizes updated for section_id %s." % section_id)
 
         return True
+    
+    def _load_media_info_cache(self, section_id=None, rating_key=None):
+        cache_time = None
+        rows = []
+        library_count = 0
+
+        # Import media info cache from json file
+        if rating_key:
+            try:
+                inFilePath = os.path.join(plexpy.CONFIG.CACHE_DIR,'media_info_%s-%s.json' % (section_id, rating_key))
+                with open(inFilePath, 'r') as inFile:
+                    data = json.load(inFile)
+                    if isinstance(data, dict):
+                        cache_time = data['last_refreshed']
+                        rows = data['rows']
+                    else:
+                        rows = data
+                    library_count = len(rows)
+                logger.debug("Tautulli Libraries :: Loaded media info from cache for rating_key %s (%s items)." % (rating_key, library_count))
+            except IOError as e:
+                logger.debug("Tautulli Libraries :: No media info cache for rating_key %s." % rating_key)
+
+        elif section_id:
+            try:
+                inFilePath = os.path.join(plexpy.CONFIG.CACHE_DIR,'media_info_%s.json' % section_id)
+                with open(inFilePath, 'r') as inFile:
+                    data = json.load(inFile)
+                    if isinstance(data, dict):
+                        cache_time = data['last_refreshed']
+                        rows = data['rows']
+                    else:
+                        rows = data
+                    library_count = len(rows)
+                logger.debug("Tautulli Libraries :: Loaded media info from cache for section_id %s (%s items)." % (section_id, library_count))
+            except IOError as e:
+                logger.debug("Tautulli Libraries :: No media info cache for section_id %s." % section_id)
+
+        return cache_time, rows, library_count
+    
+    def _save_media_info_cache(self, section_id=None, rating_key=None, rows=None):
+        cache_time = helpers.timestamp()
+
+        if rows is None:
+            rows = []
+        
+        if rating_key:
+            try:
+                outFilePath = os.path.join(plexpy.CONFIG.CACHE_DIR,'media_info_%s-%s.json' % (section_id, rating_key))
+                with open(outFilePath, 'w') as outFile:
+                    json.dump({'last_refreshed': cache_time, 'rows': rows}, outFile)
+                logger.debug("Tautulli Libraries :: Saved media info cache for rating_key %s." % rating_key)
+            except IOError as e:
+                logger.debug("Tautulli Libraries :: Unable to create cache file for rating_key %s." % rating_key)
+
+        elif section_id:
+            try:
+                outFilePath = os.path.join(plexpy.CONFIG.CACHE_DIR,'media_info_%s.json' % section_id)
+                with open(outFilePath, 'w') as outFile:
+                    json.dump({'last_refreshed': cache_time, 'rows': rows}, outFile)
+                logger.debug("Tautulli Libraries :: Saved media info cache for section_id %s." % section_id)
+            except IOError as e:
+                logger.debug("Tautulli Libraries :: Unable to create cache file for section_id %s." % section_id)
+
     def set_config(self, section_id=None, custom_thumb='', custom_art='',
                    do_notify=1, keep_history=1, do_notify_created=1):
         if section_id:
diff --git a/plexpy/pmsconnect.py b/plexpy/pmsconnect.py
index 7f81ed99..cf662be4 100644
--- a/plexpy/pmsconnect.py
+++ b/plexpy/pmsconnect.py
@@ -1617,7 +1617,7 @@ class PmsConnect(object):
         else:
             return metadata
 
-    def get_metadata_children_details(self, rating_key='', get_children=False):
+    def get_metadata_children_details(self, rating_key='', get_children=False, media_type=None, section_id=None):
         """
         Return processed and validated metadata list for all children of requested item.
 
@@ -1625,13 +1625,21 @@ class PmsConnect(object):
 
         Output: array
         """
-        metadata = self.get_metadata_children(str(rating_key), output_format='xml')
+        if media_type == 'artist':
+            sort_type = '&artist.id={}&type=9'.format(rating_key)
+            xml_head = self.fetch_library_list(
+                section_id=str(section_id),
+                sort_type=sort_type,
+                output_format='xml'
+            )
+        else:
+            metadata = self.get_metadata_children(str(rating_key), output_format='xml')
 
-        try:
-            xml_head = metadata.getElementsByTagName('MediaContainer')
-        except Exception as e:
-            logger.warn("Tautulli Pmsconnect :: Unable to parse XML for get_metadata_children: %s." % e)
-            return []
+            try:
+                xml_head = metadata.getElementsByTagName('MediaContainer')
+            except Exception as e:
+                logger.warn("Tautulli Pmsconnect :: Unable to parse XML for get_metadata_children: %s." % e)
+                return []
 
         metadata_list = []
 
diff --git a/plexpy/webserve.py b/plexpy/webserve.py
index c71addb1..7234d9d9 100644
--- a/plexpy/webserve.py
+++ b/plexpy/webserve.py
@@ -931,6 +931,9 @@ class WebInterface(object):
         section_ids = set(get_file_sizes_hold['section_ids'])
         rating_keys = set(get_file_sizes_hold['rating_keys'])
 
+        section_id = helpers.cast_to_int(section_id)
+        rating_key = helpers.cast_to_int(rating_key)
+
         if (section_id and section_id not in section_ids) or (rating_key and rating_key not in rating_keys):
             if section_id:
                 section_ids.add(section_id)

From fa8b51bfd9af683c87f61710c6bf420c8ff5a6fe Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 13 Apr 2023 14:46:30 -0700
Subject: [PATCH 385/743] Add .vscode to .gitignore

---
 .gitignore | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/.gitignore b/.gitignore
index 68d5abaf..1e54132b 100644
--- a/.gitignore
+++ b/.gitignore
@@ -53,6 +53,9 @@ Thumbs.db
 #Ignore files generated by PyCharm
 *.idea/*
 
+#Ignore files generated by VSCode
+*.vscode/*
+
 #Ignore files generated by vi
 *.swp
 

From 2921c1fc305483cf0d016112d7f88fd39e3f141b Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 13 Apr 2023 14:48:19 -0700
Subject: [PATCH 386/743] Fix live tv thumb and art for top libraries
 statistics card

---
 data/interfaces/default/home_stats.html | 5 +++--
 data/interfaces/default/index.html      | 2 +-
 plexpy/datafactory.py                   | 2 ++
 3 files changed, 6 insertions(+), 3 deletions(-)

diff --git a/data/interfaces/default/home_stats.html b/data/interfaces/default/home_stats.html
index df2b7b69..08f08b5a 100644
--- a/data/interfaces/default/home_stats.html
+++ b/data/interfaces/default/home_stats.html
@@ -77,7 +77,8 @@ DOCUMENTATION :: END
         <% fallback = 'art-live' if row0['live'] else 'art' %>
         <div id="stats-background-${stat_id}" class="dashboard-stats-background" style="background-image: url(${page('pms_image_proxy', row0['art'], row0['rating_key'], 500, 280, 40, '282828', 3, fallback=fallback)});">
         % elif stat_id == 'top_libraries':
-        <div id="stats-background-${stat_id}" class="dashboard-stats-background" style="background-image: url(${page('pms_image_proxy', row0['art'] or row0['library_art'], None, 500, 280, 40, '282828', 3, fallback=row0['library_art'])});" data-library_art="${row0['library_art']}">
+        <% fallback = 'art-live' if row0['live'] else row0['library_art'] %>
+        <div id="stats-background-${stat_id}" class="dashboard-stats-background" style="background-image: url(${page('pms_image_proxy', row0['art'] or row0['library_art'], None, 500, 280, 40, '282828', 3, fallback=fallback)});" data-library_art="${row0['library_art']}">
         % elif stat_id == 'top_users':
         <div id="stats-background-${stat_id}" class="dashboard-stats-background" data-blurhash="${page('pms_image_proxy', row0['user_thumb'] or 'interfaces/default/images/gravatar-default.png', None, 100, 100, 40, '282828', 0, fallback='user')}">
         % elif stat_id == 'top_platforms':
@@ -110,7 +111,7 @@ DOCUMENTATION :: END
             </div>
             % elif stat_id == 'top_libraries':
                 % if row0['thumb'].startswith('http'):
-                <div id="stats-thumb-${stat_id}" class="dashboard-stats-flat hidden-xs" style="background-image: url(${page('pms_image_proxy', row0['thumb'], None, 80, 80)});"></div>
+                <div id="stats-thumb-${stat_id}" class="dashboard-stats-flat hidden-xs" style="background-image: url(${page('pms_image_proxy', row0['library_thumb'], None, 80, 80)});"></div>
                 % else:
                 <div id="stats-thumb-${stat_id}" class="dashboard-stats-flat svg-icon library-${row0['section_type']} hidden-xs"></div>
                 % endif
diff --git a/data/interfaces/default/index.html b/data/interfaces/default/index.html
index 88d973da..7ad9da3b 100644
--- a/data/interfaces/default/index.html
+++ b/data/interfaces/default/index.html
@@ -809,7 +809,7 @@
             if (stat_id === 'most_concurrent') {
                 return
             } else if (stat_id === 'top_libraries') {
-                $('#stats-background-' + stat_id).css('background-image', 'url(' + page('pms_image_proxy', art || library_art, null, 500, 280, 40, '282828', 3, library_art || fallback_art) + ')');
+                $('#stats-background-' + stat_id).css('background-image', 'url(' + page('pms_image_proxy', art || library_art, null, 500, 280, 40, '282828', 3, fallback_art) + ')');
                 $('#stats-thumb-' + stat_id).removeClass(function (index, className) {
                     return (className.match (/(^|\s)svg-icon library-\S+/g) || []).join(' ')});
                 if (thumb.startsWith('http')) {
diff --git a/plexpy/datafactory.py b/plexpy/datafactory.py
index 8eb1d39c..62a4d9de 100644
--- a/plexpy/datafactory.py
+++ b/plexpy/datafactory.py
@@ -743,6 +743,8 @@ class DataFactory(object):
 
                     if item['custom_art'] and item['custom_art'] != item['library_art']:
                         library_art = item['custom_art']
+                    elif item['library_art'] == common.DEFAULT_LIVE_TV_ART_FULL:
+                        library_art = common.DEFAULT_LIVE_TV_ART
                     else:
                         library_art = item['library_art']
 

From b0921b5f4a7faf61882586f557ee51185fda6af5 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 13 Apr 2023 15:17:22 -0700
Subject: [PATCH 387/743] Fix history table sorting by play duration

---
 data/interfaces/default/history.html               | 2 +-
 data/interfaces/default/history_table_modal.html   | 2 +-
 data/interfaces/default/info.html                  | 2 +-
 data/interfaces/default/js/tables/history_table.js | 4 ++--
 data/interfaces/default/library.html               | 2 +-
 data/interfaces/default/user.html                  | 2 +-
 plexpy/datafactory.py                              | 3 ++-
 7 files changed, 9 insertions(+), 8 deletions(-)

diff --git a/data/interfaces/default/history.html b/data/interfaces/default/history.html
index cf15c87f..327b99b7 100644
--- a/data/interfaces/default/history.html
+++ b/data/interfaces/default/history.html
@@ -84,7 +84,7 @@
                 <th align="left" id="started">Started</th>
                 <th align="left" id="paused_counter">Paused</th>
                 <th align="left" id="stopped">Stopped</th>
-                <th align="left" id="duration">Duration</th>
+                <th align="left" id="play_duration">Duration</th>
                 <th align="left" id="percent_complete"></th>
             </tr>
             </thead>
diff --git a/data/interfaces/default/history_table_modal.html b/data/interfaces/default/history_table_modal.html
index 8ed42bf5..b4066627 100644
--- a/data/interfaces/default/history_table_modal.html
+++ b/data/interfaces/default/history_table_modal.html
@@ -32,7 +32,7 @@
                     <th align="left" id="started">Started</th>
                     <th align="left" id="paused_counter">Paused</th>
                     <th align="left" id="stopped">Stopped</th>
-                    <th align="left" id="duration">Duration</th>
+                    <th align="left" id="play_duration">Duration</th>
                     <th align="left" id="percent_complete"></th>
                 </tr>
                 </thead>
diff --git a/data/interfaces/default/info.html b/data/interfaces/default/info.html
index 43e57694..87c8f9d8 100644
--- a/data/interfaces/default/info.html
+++ b/data/interfaces/default/info.html
@@ -692,7 +692,7 @@ DOCUMENTATION :: END
                                                     <th align="left" id="started">Started</th>
                                                     <th align="left" id="paused_counter">Paused</th>
                                                     <th align="left" id="stopped">Stopped</th>
-                                                    <th align="left" id="duration">Duration</th>
+                                                    <th align="left" id="play_duration">Duration</th>
                                                     <th align="left" id="percent_complete"></th>
                                                 </tr>
                                             </thead>
diff --git a/data/interfaces/default/js/tables/history_table.js b/data/interfaces/default/js/tables/history_table.js
index deefa067..d209f90e 100644
--- a/data/interfaces/default/js/tables/history_table.js
+++ b/data/interfaces/default/js/tables/history_table.js
@@ -247,7 +247,7 @@ history_table_options = {
         },
         {
             "targets": [11],
-            "data": "duration",
+            "data": "play_duration",
             "render": function (data, type, full) {
                 if (data !== null) {
                     return Math.round(moment.duration(data, 'seconds').as('minutes')) + ' mins';
@@ -529,7 +529,7 @@ function childTableFormat(rowData) {
                 '<th align="left" id="started">Started</th>' +
                 '<th align="left" id="paused_counter">Paused</th>' +
                 '<th align="left" id="stopped">Stopped</th>' +
-                '<th align="left" id="duration">Duration</th>' +
+                '<th align="left" id="play_duration">Duration</th>' +
                 '<th align="left" id="percent_complete"></th>' +
             '</tr>' +
             '</thead>' +
diff --git a/data/interfaces/default/library.html b/data/interfaces/default/library.html
index 59de6497..b1fe8b6f 100644
--- a/data/interfaces/default/library.html
+++ b/data/interfaces/default/library.html
@@ -248,7 +248,7 @@ DOCUMENTATION :: END
                                                     <th align="left" id="started">Started</th>
                                                     <th align="left" id="paused_counter">Paused</th>
                                                     <th align="left" id="stopped">Stopped</th>
-                                                    <th align="left" id="duration">Duration</th>
+                                                    <th align="left" id="play_duration">Duration</th>
                                                     <th align="left" id="percent_complete"></th>
                                                 </tr>
                                             </thead>
diff --git a/data/interfaces/default/user.html b/data/interfaces/default/user.html
index 501c68ca..61dfdcb5 100644
--- a/data/interfaces/default/user.html
+++ b/data/interfaces/default/user.html
@@ -212,7 +212,7 @@ DOCUMENTATION :: END
                                                     <th align="left" id="started">Started</th>
                                                     <th align="left" id="paused_counter">Paused</th>
                                                     <th align="left" id="stopped">Stopped</th>
-                                                    <th align="left" id="duration">Duration</th>
+                                                    <th align="left" id="play_duration">Duration</th>
                                                     <th align="left" id="percent_complete"></th>
                                                 </tr>
                                             </thead>
diff --git a/plexpy/datafactory.py b/plexpy/datafactory.py
index 62a4d9de..e2ee0c2b 100644
--- a/plexpy/datafactory.py
+++ b/plexpy/datafactory.py
@@ -308,7 +308,8 @@ class DataFactory(object):
                    'date': item['date'],
                    'started': item['started'],
                    'stopped': item['stopped'],
-                   'duration': item['play_duration'],
+                   'duration': item['play_duration'],  # Keep for backwards compatibility
+                   'play_duration': item['play_duration'],
                    'paused_counter': item['paused_counter'],
                    'user_id': item['user_id'],
                    'user': item['user'],

From 07715c6a493d983852cf4aab27dd6391005ac816 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 13 Apr 2023 15:17:41 -0700
Subject: [PATCH 388/743] Rename API get_history response duration to
 play_duration

---
 plexpy/webserve.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/plexpy/webserve.py b/plexpy/webserve.py
index 7234d9d9..57921b61 100644
--- a/plexpy/webserve.py
+++ b/plexpy/webserve.py
@@ -1920,7 +1920,6 @@ class WebInterface(object):
                      "filter_duration": "10 hrs 12 mins",
                      "data":
                         [{"date": 1462687607,
-                          "duration": 263,
                           "friendly_name": "Mother of Dragons",
                           "full_title": "Game of Thrones - The Red Woman",
                           "grandparent_rating_key": 351,
@@ -1942,6 +1941,7 @@ class WebInterface(object):
                           "paused_counter": 0,
                           "percent_complete": 84,
                           "platform": "Windows",
+                          "play_duration": 263,
                           "product": "Plex for Windows",
                           "player": "Castle-PC",
                           "rating_key": 4348,

From 14648a46045688f27d165529158539d1ea1431a5 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 13 Apr 2023 21:48:31 -0700
Subject: [PATCH 389/743] Fix live tv thumb hover on top libraries statistics
 card

---
 data/interfaces/default/home_stats.html | 7 ++++---
 data/interfaces/default/index.html      | 5 +++--
 2 files changed, 7 insertions(+), 5 deletions(-)

diff --git a/data/interfaces/default/home_stats.html b/data/interfaces/default/home_stats.html
index 08f08b5a..d66dd1d4 100644
--- a/data/interfaces/default/home_stats.html
+++ b/data/interfaces/default/home_stats.html
@@ -110,8 +110,8 @@ DOCUMENTATION :: END
                 </a>
             </div>
             % elif stat_id == 'top_libraries':
-                % if row0['thumb'].startswith('http'):
-                <div id="stats-thumb-${stat_id}" class="dashboard-stats-flat hidden-xs" style="background-image: url(${page('pms_image_proxy', row0['library_thumb'], None, 80, 80)});"></div>
+                % if row0['library_thumb'].startswith('http'):
+                <div id="stats-thumb-${stat_id}" class="dashboard-stats-flat hidden-xs" style="background-image: url(${page('pms_image_proxy', row0['library_thumb'], None, 100, 100, fallback='cover')});"></div>
                 % else:
                 <div id="stats-thumb-${stat_id}" class="dashboard-stats-flat svg-icon library-${row0['section_type']} hidden-xs"></div>
                 % endif
@@ -148,7 +148,8 @@ DOCUMENTATION :: END
                                 data-rating_key="${row.get('rating_key')}" data-grandparent_rating_key="${row.get('grandparent_rating_key')}" data-guid="${row.get('guid')}" data-title="${row.get('title')}"
                                 data-art="${row.get('art')}" data-thumb="${row.get('thumb')}" data-platform="${row.get('platform_name')}" data-library-type="${row.get('section_type')}"
                                 data-user_id="${row.get('user_id')}" data-user="${row.get('user')}" data-friendly_name="${row.get('friendly_name')}" data-user_thumb="${row.get('user_thumb')}"
-                                data-last_watch="${row.get('last_watch')}" data-started="${row.get('started')}" data-live="${row.get('live')}" data-library_art="${row.get('library_art', '')}">
+                                data-last_watch="${row.get('last_watch')}" data-started="${row.get('started')}" data-live="${row.get('live')}"
+                                data-library_art="${row.get('library_art', '')}" data-library_thumb="${row.get('library_thumb', '')}">
                                 <div class="sub-list">${loop.index + 1}</div>
                                 <div class="sub-value">
                                     % if stat_id in ('top_movies', 'popular_movies', 'top_tv', 'popular_tv', 'top_music', 'popular_music', 'last_watched'):
diff --git a/data/interfaces/default/index.html b/data/interfaces/default/index.html
index 7ad9da3b..57236e69 100644
--- a/data/interfaces/default/index.html
+++ b/data/interfaces/default/index.html
@@ -798,6 +798,7 @@
             var guid = $(elem).data('guid');
             var live = $(elem).data('live');
             var library_art = $(elem).data('library_art');
+            var library_thumb = $(elem).data('library_thumb');
             var [height, fallback_poster, fallback_art] = [450, 'poster', 'art'];
             if ($.inArray(stat_id, ['top_music', 'popular_music']) > -1) {
                 [height, fallback_poster, fallback_art] = [300, 'cover', 'art'];
@@ -812,8 +813,8 @@
                 $('#stats-background-' + stat_id).css('background-image', 'url(' + page('pms_image_proxy', art || library_art, null, 500, 280, 40, '282828', 3, fallback_art) + ')');
                 $('#stats-thumb-' + stat_id).removeClass(function (index, className) {
                     return (className.match (/(^|\s)svg-icon library-\S+/g) || []).join(' ')});
-                if (thumb.startsWith('http')) {
-                    $('#stats-thumb-' + stat_id).css('background-image', 'url(' + page('pms_image_proxy', thumb, null, 300, 300, null, null, null, 'cover') + ')');
+                if (library_thumb.startsWith('http')) {
+                    $('#stats-thumb-' + stat_id).css('background-image', 'url(' + page('pms_image_proxy', library_thumb, null, 100, 100, null, null, null, 'cover') + ')');
                 } else {
                     $('#stats-thumb-' + stat_id).css('background-image', '')
                         .addClass('svg-icon library-' + library_type);

From 99afb7392b833d754c5efaa1188552d51b2cc391 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 14 Apr 2023 11:29:53 -0700
Subject: [PATCH 390/743] Use separate log file for script PlexAPI

---
 plexpy/notifiers.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/plexpy/notifiers.py b/plexpy/notifiers.py
index ecd33a60..c7580603 100644
--- a/plexpy/notifiers.py
+++ b/plexpy/notifiers.py
@@ -3431,7 +3431,8 @@ class SCRIPTS(Notifier):
             'TAUTULLI_PUBLIC_URL': plexpy.CONFIG.HTTP_BASE_URL + plexpy.HTTP_ROOT,
             'TAUTULLI_APIKEY': plexpy.CONFIG.API_KEY,
             'TAUTULLI_ENCODING': plexpy.SYS_ENCODING,
-            'TAUTULLI_PYTHON_VERSION': common.PYTHON_VERSION
+            'TAUTULLI_PYTHON_VERSION': common.PYTHON_VERSION,
+            'PLEXAPI_LOG_PATH': os.path.join(plexpy.CONFIG.LOG_DIR, 'plexapi_script.log')
             }
 
         if user_id:

From e9b1db139e96f0d82ff7d047f3a91d5b45a69f45 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 14 Apr 2023 11:50:55 -0700
Subject: [PATCH 391/743] v2.12.3

---
 CHANGELOG.md      | 15 +++++++++++++++
 plexpy/version.py |  2 +-
 2 files changed, 16 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index c8463420..b3c6c4a1 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,20 @@
 # Changelog
 
+## v2.12.3 (2023-04-14)
+
+* Activity:
+  * Fix: Incorrect subtitle decision shown when subtitles are transcoded.
+* History:
+  * Fix: Incorrect order when sorting by the duration column in the history tables.
+* Notifications:
+  * Fix: Logging error when running scripts that use PlexAPI.
+* UI:
+  * Fix: Calculate file sizes setting causing the media info table to fail to load.
+  * Fix: Incorrect artwork and thumbnail shown for Live TV on the Most Active Libraries statistics card.
+* API:
+  * Change: Renamed duration to play_duration in the get_history API response. (Note: duration kept for backwards compatibility.)
+
+
 ## v2.12.2 (2023-03-16)
 
 * Other:
diff --git a/plexpy/version.py b/plexpy/version.py
index 7180028b..47ba56cb 100644
--- a/plexpy/version.py
+++ b/plexpy/version.py
@@ -18,4 +18,4 @@
 from __future__ import unicode_literals
 
 PLEXPY_BRANCH = "master"
-PLEXPY_RELEASE_VERSION = "v2.12.2"
\ No newline at end of file
+PLEXPY_RELEASE_VERSION = "v2.12.3"
\ No newline at end of file

From 3b3c59c4bb8e58d76df01348151d869ee7ca1105 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 17 Apr 2023 12:50:52 -0700
Subject: [PATCH 392/743] Set view offset equal to duration if stopped within
 the last 10 sec

* Plex reports the view offset every 10 seconds, so the view offset at the end of stream can be short by up to 10 seconds.
---
 plexpy/activity_handler.py     |  9 +++++++--
 plexpy/notification_handler.py | 24 +++++++++++++++---------
 2 files changed, 22 insertions(+), 11 deletions(-)

diff --git a/plexpy/activity_handler.py b/plexpy/activity_handler.py
index 851372d5..7bfbe8fb 100644
--- a/plexpy/activity_handler.py
+++ b/plexpy/activity_handler.py
@@ -108,7 +108,6 @@ class ActivityHandler(object):
             self.ap.write_session(session=self.session, notify=notify)
 
         self.set_session_state()
-        self.get_db_session()
 
     def set_session_state(self, view_offset=None):
         self.ap.set_session_state(
@@ -117,6 +116,7 @@ class ActivityHandler(object):
             view_offset=view_offset or self.view_offset,
             stopped=helpers.timestamp()
         )
+        self.get_db_session()
         
     def put_notification(self, notify_action, **kwargs):
         notification = {'stream_data': self.db_session.copy(), 'notify_action': notify_action}
@@ -162,7 +162,12 @@ class ActivityHandler(object):
         # Update the session state and viewOffset
         # Set force_stop to true to disable the state set
         if not force_stop:
-            self.set_session_state()
+            # Set the view offset equal to the duration if it is within the last 10 seconds
+            if self.db_session['duration'] - self.view_offset <= 10000:
+                view_offset = self.db_session['duration']
+            else:
+                view_offset = self.view_offset
+            self.set_session_state(view_offset=view_offset)
 
         # Write it to the history table
         row_id = self.ap.write_session_history(session=self.db_session)
diff --git a/plexpy/notification_handler.py b/plexpy/notification_handler.py
index 86baac4d..bc8d39c5 100644
--- a/plexpy/notification_handler.py
+++ b/plexpy/notification_handler.py
@@ -550,7 +550,13 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
     if session:
         # Reload json from raw stream info
         if session.get('raw_stream_info'):
-            session.update(json.loads(session['raw_stream_info']))
+            raw_stream_info = json.loads(session['raw_stream_info'])
+            # Don't overwrite id, session_key, stopped, view_offset
+            raw_stream_info.pop('id', None)
+            raw_stream_info.pop('session_key', None)
+            raw_stream_info.pop('stopped', None)
+            raw_stream_info.pop('view_offset', None)
+            session.update(raw_stream_info)
         notify_params.update(session)
 
     if timeline:
@@ -638,13 +644,13 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
         stream_duration_sec = 0
         stream_duration = 0
 
-    view_offset_sec = helpers.convert_milliseconds_to_seconds(session.get('view_offset', 0))
+    progress_duration_sec = helpers.convert_milliseconds_to_seconds(session.get('view_offset', 0))
     duration_sec = helpers.convert_milliseconds_to_seconds(notify_params['duration'])
-    remaining_duration_sec = duration_sec - view_offset_sec
+    remaining_duration_sec = duration_sec - progress_duration_sec
 
-    view_offset = helpers.seconds_to_minutes(view_offset_sec)
+    progress_duration = helpers.seconds_to_minutes(progress_duration_sec)
     duration = helpers.seconds_to_minutes(duration_sec)
-    remaining_duration = duration - view_offset
+    remaining_duration = duration - progress_duration
 
     # Build Plex URL
     if notify_params['media_type'] == 'track':
@@ -1005,10 +1011,10 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
         'remaining_duration': remaining_duration,
         'remaining_duration_sec': remaining_duration_sec,
         'remaining_time': arrow.get(remaining_duration_sec).format(duration_format),
-        'progress_duration': view_offset,
-        'progress_duration_sec': view_offset_sec,
-        'progress_time': arrow.get(view_offset_sec).format(duration_format),
-        'progress_percent': helpers.get_percent(view_offset_sec, duration_sec),
+        'progress_duration': progress_duration,
+        'progress_duration_sec': progress_duration_sec,
+        'progress_time': arrow.get(progress_duration_sec).format(duration_format),
+        'progress_percent': helpers.get_percent(progress_duration_sec, duration_sec),
         'view_offset': session.get('view_offset', 0),
         'initial_stream': notify_params['initial_stream'],
         'transcode_decision': transcode_decision,

From fe4fba353e600d45ec30d381f60b68afdc67f8b5 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 20 Apr 2023 08:50:41 -0700
Subject: [PATCH 393/743] Catch KeyError on import db version

---
 plexpy/database.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/plexpy/database.py b/plexpy/database.py
index 3b56f33b..72ce7782 100644
--- a/plexpy/database.py
+++ b/plexpy/database.py
@@ -98,7 +98,7 @@ def import_tautulli_db(database=None, method=None, backup=False):
     try:
         version_info = db.select_single('SELECT * FROM import_db.version_info WHERE key = "version"')
         import_db_version = version_info['value']
-    except sqlite3.OperationalError:
+    except (sqlite3.OperationalError, KeyError):
         import_db_version = 'v2.6.10'
 
     logger.info("Tautulli Database :: Import Tautulli database version: %s", import_db_version)

From 3a1d6322aebfe63bb0160b4c85b3ecc785ce2cba Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 5 May 2023 15:56:32 -0700
Subject: [PATCH 394/743] Add return ID for async API calls

* export_id, notification_id, and newsletter_notification_d
---
 plexpy/api2.py                 | 18 ++++++++++--------
 plexpy/exporter.py             |  2 +-
 plexpy/notification_handler.py |  2 +-
 plexpy/webserve.py             |  8 +++-----
 4 files changed, 15 insertions(+), 15 deletions(-)

diff --git a/plexpy/api2.py b/plexpy/api2.py
index 4d9efbdc..eefaa9fd 100644
--- a/plexpy/api2.py
+++ b/plexpy/api2.py
@@ -505,7 +505,8 @@ class API2(object):
                 script_args (str):      The arguments for script notifications
 
             Returns:
-                None
+                json:
+                    {"notification_id": 1}
             ```
         """
         if not notifier_id:
@@ -527,14 +528,14 @@ class API2(object):
                                               body=body,
                                               **kwargs)
 
-        if success:
+        if isinstance(success, int):
             self._api_msg = 'Notification sent.'
             self._api_result_type = 'success'
+            return {'notification_id': success}
         else:
             self._api_msg = 'Notification failed.'
             self._api_result_type = 'error'
-
-        return
+            return
 
     def notify_newsletter(self, newsletter_id='', subject='', body='', message='', **kwargs):
         """ Send a newsletter using Tautulli.
@@ -549,7 +550,8 @@ class API2(object):
                 message (str):          The message of the newsletter
 
             Returns:
-                None
+                json:
+                    {"newsletter_notification_id": 1}
             ```
         """
         if not newsletter_id:
@@ -572,14 +574,14 @@ class API2(object):
                                             message=message,
                                             **kwargs)
 
-        if success:
+        if isinstance(success, int):
             self._api_msg = 'Newsletter sent.'
             self._api_result_type = 'success'
+            return {'newsletter_notification_id': success}
         else:
             self._api_msg = 'Newsletter failed.'
             self._api_result_type = 'error'
-
-        return
+            return
 
     def _api_make_md(self):
         """ Tries to make a API.md to simplify the api docs. """
diff --git a/plexpy/exporter.py b/plexpy/exporter.py
index 9bcb5d06..908aced7 100644
--- a/plexpy/exporter.py
+++ b/plexpy/exporter.py
@@ -1837,7 +1837,7 @@ class Export(object):
 
         threading.Thread(target=self._real_export).start()
 
-        return True
+        return self.export_id
 
     def add_export(self):
         keys = {
diff --git a/plexpy/notification_handler.py b/plexpy/notification_handler.py
index bc8d39c5..2171d2bd 100644
--- a/plexpy/notification_handler.py
+++ b/plexpy/notification_handler.py
@@ -438,7 +438,7 @@ def notify(notifier_id=None, notify_action=None, stream_data=None, timeline_data
 
     if success:
         set_notify_success(notification_id)
-        return True
+        return notification_id
 
 
 def get_notify_state(session):
diff --git a/plexpy/webserve.py b/plexpy/webserve.py
index 57921b61..88b65174 100644
--- a/plexpy/webserve.py
+++ b/plexpy/webserve.py
@@ -7057,9 +7057,7 @@ class WebInterface(object):
 
             Returns:
                 json:
-                    {"result": "success",
-                     "message": "Metadata export has started."
-                     }
+                    {"export_id": 1}
             ```
         """
         individual_files = helpers.bool_true(individual_files)
@@ -7075,8 +7073,8 @@ class WebInterface(object):
                                  export_type=export_type,
                                  individual_files=individual_files).export()
 
-        if result is True:
-            return {'result': 'success', 'message': 'Metadata export has started.'}
+        if isinstance(result, int):
+            return {'result': 'success', 'message': 'Metadata export has started.', 'export_id': result}
         else:
             return {'result': 'error', 'message': result}
 

From f39b9f908701feed62a22c30fdd558f5b3b3c979 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 15 May 2023 11:03:26 -0700
Subject: [PATCH 395/743] Fix SQLite Double-Quoted Strings (#2057)

* Fix __init__.py

* Fix activity_pinger.py

* Fix activity_processor.py

* Fix database.py

* Fix datafactory.py

* Fix exporter.py

* Fix graphs.py

* Fix libraries.py

* Fix mobile_app.py

* Fix newsletter_handler.py

* Fix newsletters.py

* Fix notification_handler.py

* Fix notifiers.py

* Fix plexivity_import.py

* Fix plexwatch_import.py

* Fix users.py

* Fix webauth.py
---
 plexpy/__init__.py             | 1519 ++++++++++++++++----------------
 plexpy/activity_pinger.py      |   30 +-
 plexpy/activity_processor.py   |   78 +-
 plexpy/database.py             |   74 +-
 plexpy/datafactory.py          | 1104 +++++++++++------------
 plexpy/exporter.py             |   52 +-
 plexpy/graphs.py               |  810 ++++++++---------
 plexpy/libraries.py            |  218 ++---
 plexpy/mobile_app.py           |   24 +-
 plexpy/newsletter_handler.py   |   18 +-
 plexpy/newsletters.py          |   18 +-
 plexpy/notification_handler.py |   54 +-
 plexpy/notifiers.py            |   14 +-
 plexpy/plexivity_import.py     |   48 +-
 plexpy/plexwatch_import.py     |   52 +-
 plexpy/users.py                |  310 +++----
 plexpy/webauth.py              |   14 +-
 17 files changed, 2220 insertions(+), 2217 deletions(-)

diff --git a/plexpy/__init__.py b/plexpy/__init__.py
index 2a769374..eb1f73c2 100644
--- a/plexpy/__init__.py
+++ b/plexpy/__init__.py
@@ -242,6 +242,9 @@ def initialize(config_file):
         logger.info("Python {}".format(
             sys.version.replace('\n', '')
         ))
+        logger.info("SQLite {}".format(
+            sqlite3.sqlite_version
+        ))
 
         logger.info("Program Dir: {}".format(
             PROG_DIR
@@ -618,1646 +621,1646 @@ def dbcheck():
 
     # schema table :: This is a table which keeps track of the database version
     c_db.execute(
-        'CREATE TABLE IF NOT EXISTS version_info (key TEXT UNIQUE, value TEXT)'
+        "CREATE TABLE IF NOT EXISTS version_info (key TEXT UNIQUE, value TEXT)"
     )
 
     # sessions table :: This is a temp table that logs currently active sessions
     c_db.execute(
-        'CREATE TABLE IF NOT EXISTS sessions (id INTEGER PRIMARY KEY AUTOINCREMENT, session_key INTEGER, session_id TEXT, '
-        'transcode_key TEXT, rating_key INTEGER, section_id INTEGER, media_type TEXT, started INTEGER, stopped INTEGER, '
-        'paused_counter INTEGER DEFAULT 0, state TEXT, user_id INTEGER, user TEXT, friendly_name TEXT, '
-        'ip_address TEXT, machine_id TEXT, bandwidth INTEGER, location TEXT, player TEXT, product TEXT, platform TEXT, '
-        'title TEXT, parent_title TEXT, grandparent_title TEXT, original_title TEXT, full_title TEXT, '
-        'media_index INTEGER, parent_media_index INTEGER, '
-        'thumb TEXT, parent_thumb TEXT, grandparent_thumb TEXT, year INTEGER, '
-        'parent_rating_key INTEGER, grandparent_rating_key INTEGER, '
-        'originally_available_at TEXT, added_at INTEGER, guid TEXT, '
-        'view_offset INTEGER DEFAULT 0, duration INTEGER, video_decision TEXT, audio_decision TEXT, '
-        'transcode_decision TEXT, container TEXT, bitrate INTEGER, width INTEGER, height INTEGER, '
-        'video_codec TEXT, video_bitrate INTEGER, video_resolution TEXT, video_width INTEGER, video_height INTEGER, '
-        'video_framerate TEXT, video_scan_type TEXT, video_full_resolution TEXT, '
-        'video_dynamic_range TEXT, aspect_ratio TEXT, '
-        'audio_codec TEXT, audio_bitrate INTEGER, audio_channels INTEGER, audio_language TEXT, audio_language_code TEXT, '
-        'subtitle_codec TEXT, subtitle_forced INTEGER, subtitle_language TEXT, '
-        'stream_bitrate INTEGER, stream_video_resolution TEXT, quality_profile TEXT, '
-        'stream_container_decision TEXT, stream_container TEXT, '
-        'stream_video_decision TEXT, stream_video_codec TEXT, stream_video_bitrate INTEGER, stream_video_width INTEGER, '
-        'stream_video_height INTEGER, stream_video_framerate TEXT, stream_video_scan_type TEXT, stream_video_full_resolution TEXT, '
-        'stream_video_dynamic_range TEXT, '
-        'stream_audio_decision TEXT, stream_audio_codec TEXT, stream_audio_bitrate INTEGER, stream_audio_channels INTEGER, '
-        'stream_audio_language TEXT, stream_audio_language_code TEXT, '
-        'subtitles INTEGER, stream_subtitle_decision TEXT, stream_subtitle_codec TEXT, '
-        'stream_subtitle_forced INTEGER, stream_subtitle_language TEXT, '
-        'transcode_protocol TEXT, transcode_container TEXT, '
-        'transcode_video_codec TEXT, transcode_audio_codec TEXT, transcode_audio_channels INTEGER,'
-        'transcode_width INTEGER, transcode_height INTEGER, '
-        'transcode_hw_decoding INTEGER, transcode_hw_encoding INTEGER, '
-        'optimized_version INTEGER, optimized_version_profile TEXT, optimized_version_title TEXT, '
-        'synced_version INTEGER, synced_version_profile TEXT, '
-        'live INTEGER, live_uuid TEXT, channel_call_sign TEXT, channel_identifier TEXT, channel_thumb TEXT, '
-        'secure INTEGER, relayed INTEGER, '
-        'buffer_count INTEGER DEFAULT 0, buffer_last_triggered INTEGER, last_paused INTEGER, watched INTEGER DEFAULT 0, '
-        'intro INTEGER DEFAULT 0, credits INTEGER DEFAULT 0, commercial INTEGER DEFAULT 0, marker INTEGER DEFAULT 0, '
-        'initial_stream INTEGER DEFAULT 1, write_attempts INTEGER DEFAULT 0, raw_stream_info TEXT, '
-        'rating_key_websocket TEXT)'
+        "CREATE TABLE IF NOT EXISTS sessions (id INTEGER PRIMARY KEY AUTOINCREMENT, session_key INTEGER, session_id TEXT, "
+        "transcode_key TEXT, rating_key INTEGER, section_id INTEGER, media_type TEXT, started INTEGER, stopped INTEGER, "
+        "paused_counter INTEGER DEFAULT 0, state TEXT, user_id INTEGER, user TEXT, friendly_name TEXT, "
+        "ip_address TEXT, machine_id TEXT, bandwidth INTEGER, location TEXT, player TEXT, product TEXT, platform TEXT, "
+        "title TEXT, parent_title TEXT, grandparent_title TEXT, original_title TEXT, full_title TEXT, "
+        "media_index INTEGER, parent_media_index INTEGER, "
+        "thumb TEXT, parent_thumb TEXT, grandparent_thumb TEXT, year INTEGER, "
+        "parent_rating_key INTEGER, grandparent_rating_key INTEGER, "
+        "originally_available_at TEXT, added_at INTEGER, guid TEXT, "
+        "view_offset INTEGER DEFAULT 0, duration INTEGER, video_decision TEXT, audio_decision TEXT, "
+        "transcode_decision TEXT, container TEXT, bitrate INTEGER, width INTEGER, height INTEGER, "
+        "video_codec TEXT, video_bitrate INTEGER, video_resolution TEXT, video_width INTEGER, video_height INTEGER, "
+        "video_framerate TEXT, video_scan_type TEXT, video_full_resolution TEXT, "
+        "video_dynamic_range TEXT, aspect_ratio TEXT, "
+        "audio_codec TEXT, audio_bitrate INTEGER, audio_channels INTEGER, audio_language TEXT, audio_language_code TEXT, "
+        "subtitle_codec TEXT, subtitle_forced INTEGER, subtitle_language TEXT, "
+        "stream_bitrate INTEGER, stream_video_resolution TEXT, quality_profile TEXT, "
+        "stream_container_decision TEXT, stream_container TEXT, "
+        "stream_video_decision TEXT, stream_video_codec TEXT, stream_video_bitrate INTEGER, stream_video_width INTEGER, "
+        "stream_video_height INTEGER, stream_video_framerate TEXT, stream_video_scan_type TEXT, stream_video_full_resolution TEXT, "
+        "stream_video_dynamic_range TEXT, "
+        "stream_audio_decision TEXT, stream_audio_codec TEXT, stream_audio_bitrate INTEGER, stream_audio_channels INTEGER, "
+        "stream_audio_language TEXT, stream_audio_language_code TEXT, "
+        "subtitles INTEGER, stream_subtitle_decision TEXT, stream_subtitle_codec TEXT, "
+        "stream_subtitle_forced INTEGER, stream_subtitle_language TEXT, "
+        "transcode_protocol TEXT, transcode_container TEXT, "
+        "transcode_video_codec TEXT, transcode_audio_codec TEXT, transcode_audio_channels INTEGER,"
+        "transcode_width INTEGER, transcode_height INTEGER, "
+        "transcode_hw_decoding INTEGER, transcode_hw_encoding INTEGER, "
+        "optimized_version INTEGER, optimized_version_profile TEXT, optimized_version_title TEXT, "
+        "synced_version INTEGER, synced_version_profile TEXT, "
+        "live INTEGER, live_uuid TEXT, channel_call_sign TEXT, channel_identifier TEXT, channel_thumb TEXT, "
+        "secure INTEGER, relayed INTEGER, "
+        "buffer_count INTEGER DEFAULT 0, buffer_last_triggered INTEGER, last_paused INTEGER, watched INTEGER DEFAULT 0, "
+        "intro INTEGER DEFAULT 0, credits INTEGER DEFAULT 0, commercial INTEGER DEFAULT 0, marker INTEGER DEFAULT 0, "
+        "initial_stream INTEGER DEFAULT 1, write_attempts INTEGER DEFAULT 0, raw_stream_info TEXT, "
+        "rating_key_websocket TEXT)"
     )
 
     # sessions_continued table :: This is a temp table that keeps track of continued streaming sessions
     c_db.execute(
-        'CREATE TABLE IF NOT EXISTS sessions_continued (id INTEGER PRIMARY KEY AUTOINCREMENT, '
-        'user_id INTEGER, machine_id TEXT, media_type TEXT, stopped INTEGER)'
+        "CREATE TABLE IF NOT EXISTS sessions_continued (id INTEGER PRIMARY KEY AUTOINCREMENT, "
+        "user_id INTEGER, machine_id TEXT, media_type TEXT, stopped INTEGER)"
     )
 
     # session_history table :: This is a history table which logs essential stream details
     c_db.execute(
-        'CREATE TABLE IF NOT EXISTS session_history (id INTEGER PRIMARY KEY AUTOINCREMENT, reference_id INTEGER, '
-        'started INTEGER, stopped INTEGER, rating_key INTEGER, user_id INTEGER, user TEXT, '
-        'ip_address TEXT, paused_counter INTEGER DEFAULT 0, player TEXT, product TEXT, product_version TEXT, '
-        'platform TEXT, platform_version TEXT, profile TEXT, machine_id TEXT, '
-        'bandwidth INTEGER, location TEXT, quality_profile TEXT, secure INTEGER, relayed INTEGER, '
-        'parent_rating_key INTEGER, grandparent_rating_key INTEGER, media_type TEXT, section_id INTEGER, '
-        'view_offset INTEGER DEFAULT 0)'
+        "CREATE TABLE IF NOT EXISTS session_history (id INTEGER PRIMARY KEY AUTOINCREMENT, reference_id INTEGER, "
+        "started INTEGER, stopped INTEGER, rating_key INTEGER, user_id INTEGER, user TEXT, "
+        "ip_address TEXT, paused_counter INTEGER DEFAULT 0, player TEXT, product TEXT, product_version TEXT, "
+        "platform TEXT, platform_version TEXT, profile TEXT, machine_id TEXT, "
+        "bandwidth INTEGER, location TEXT, quality_profile TEXT, secure INTEGER, relayed INTEGER, "
+        "parent_rating_key INTEGER, grandparent_rating_key INTEGER, media_type TEXT, section_id INTEGER, "
+        "view_offset INTEGER DEFAULT 0)"
     )
 
-    # session_history_media_info table :: This is a table which logs each session's media info
+    # session_history_media_info table :: This is a table which logs each session"s media info
     c_db.execute(
-        'CREATE TABLE IF NOT EXISTS session_history_media_info (id INTEGER PRIMARY KEY, rating_key INTEGER, '
-        'video_decision TEXT, audio_decision TEXT, transcode_decision TEXT, duration INTEGER DEFAULT 0, '
-        'container TEXT, bitrate INTEGER, width INTEGER, height INTEGER, video_bitrate INTEGER, video_bit_depth INTEGER, '
-        'video_codec TEXT, video_codec_level TEXT, video_width INTEGER, video_height INTEGER, video_resolution TEXT, '
-        'video_framerate TEXT, video_scan_type TEXT, video_full_resolution TEXT, video_dynamic_range TEXT, aspect_ratio TEXT, '
-        'audio_bitrate INTEGER, audio_codec TEXT, audio_channels INTEGER, audio_language TEXT, audio_language_code TEXT, '
-        'subtitles INTEGER, subtitle_codec TEXT, subtitle_forced, subtitle_language TEXT,'
-        'transcode_protocol TEXT, transcode_container TEXT, transcode_video_codec TEXT, transcode_audio_codec TEXT, '
-        'transcode_audio_channels INTEGER, transcode_width INTEGER, transcode_height INTEGER, '
-        'transcode_hw_requested INTEGER, transcode_hw_full_pipeline INTEGER, '
-        'transcode_hw_decode TEXT, transcode_hw_decode_title TEXT, transcode_hw_decoding INTEGER, '
-        'transcode_hw_encode TEXT, transcode_hw_encode_title TEXT, transcode_hw_encoding INTEGER, '
-        'stream_container TEXT, stream_container_decision TEXT, stream_bitrate INTEGER, '
-        'stream_video_decision TEXT, stream_video_bitrate INTEGER, stream_video_codec TEXT, stream_video_codec_level TEXT, '
-        'stream_video_bit_depth INTEGER, stream_video_height INTEGER, stream_video_width INTEGER, stream_video_resolution TEXT, '
-        'stream_video_framerate TEXT, stream_video_scan_type TEXT, stream_video_full_resolution TEXT, stream_video_dynamic_range TEXT, '
-        'stream_audio_decision TEXT, stream_audio_codec TEXT, stream_audio_bitrate INTEGER, stream_audio_channels INTEGER, '
-        'stream_audio_language TEXT, stream_audio_language_code TEXT, '
-        'stream_subtitle_decision TEXT, stream_subtitle_codec TEXT, '
-        'stream_subtitle_container TEXT, stream_subtitle_forced INTEGER, stream_subtitle_language TEXT, '
-        'synced_version INTEGER, synced_version_profile TEXT, '
-        'optimized_version INTEGER, optimized_version_profile TEXT, optimized_version_title TEXT)'
+        "CREATE TABLE IF NOT EXISTS session_history_media_info (id INTEGER PRIMARY KEY, rating_key INTEGER, "
+        "video_decision TEXT, audio_decision TEXT, transcode_decision TEXT, duration INTEGER DEFAULT 0, "
+        "container TEXT, bitrate INTEGER, width INTEGER, height INTEGER, video_bitrate INTEGER, video_bit_depth INTEGER, "
+        "video_codec TEXT, video_codec_level TEXT, video_width INTEGER, video_height INTEGER, video_resolution TEXT, "
+        "video_framerate TEXT, video_scan_type TEXT, video_full_resolution TEXT, video_dynamic_range TEXT, aspect_ratio TEXT, "
+        "audio_bitrate INTEGER, audio_codec TEXT, audio_channels INTEGER, audio_language TEXT, audio_language_code TEXT, "
+        "subtitles INTEGER, subtitle_codec TEXT, subtitle_forced, subtitle_language TEXT,"
+        "transcode_protocol TEXT, transcode_container TEXT, transcode_video_codec TEXT, transcode_audio_codec TEXT, "
+        "transcode_audio_channels INTEGER, transcode_width INTEGER, transcode_height INTEGER, "
+        "transcode_hw_requested INTEGER, transcode_hw_full_pipeline INTEGER, "
+        "transcode_hw_decode TEXT, transcode_hw_decode_title TEXT, transcode_hw_decoding INTEGER, "
+        "transcode_hw_encode TEXT, transcode_hw_encode_title TEXT, transcode_hw_encoding INTEGER, "
+        "stream_container TEXT, stream_container_decision TEXT, stream_bitrate INTEGER, "
+        "stream_video_decision TEXT, stream_video_bitrate INTEGER, stream_video_codec TEXT, stream_video_codec_level TEXT, "
+        "stream_video_bit_depth INTEGER, stream_video_height INTEGER, stream_video_width INTEGER, stream_video_resolution TEXT, "
+        "stream_video_framerate TEXT, stream_video_scan_type TEXT, stream_video_full_resolution TEXT, stream_video_dynamic_range TEXT, "
+        "stream_audio_decision TEXT, stream_audio_codec TEXT, stream_audio_bitrate INTEGER, stream_audio_channels INTEGER, "
+        "stream_audio_language TEXT, stream_audio_language_code TEXT, "
+        "stream_subtitle_decision TEXT, stream_subtitle_codec TEXT, "
+        "stream_subtitle_container TEXT, stream_subtitle_forced INTEGER, stream_subtitle_language TEXT, "
+        "synced_version INTEGER, synced_version_profile TEXT, "
+        "optimized_version INTEGER, optimized_version_profile TEXT, optimized_version_title TEXT)"
     )
 
-    # session_history_metadata table :: This is a table which logs each session's media metadata
+    # session_history_metadata table :: This is a table which logs each session"s media metadata
     c_db.execute(
-        'CREATE TABLE IF NOT EXISTS session_history_metadata (id INTEGER PRIMARY KEY, '
-        'rating_key INTEGER, parent_rating_key INTEGER, grandparent_rating_key INTEGER, '
-        'title TEXT, parent_title TEXT, grandparent_title TEXT, original_title TEXT, full_title TEXT, '
-        'media_index INTEGER, parent_media_index INTEGER, '
-        'thumb TEXT, parent_thumb TEXT, grandparent_thumb TEXT, '
-        'art TEXT, media_type TEXT, year INTEGER, originally_available_at TEXT, added_at INTEGER, updated_at INTEGER, '
-        'last_viewed_at INTEGER, content_rating TEXT, summary TEXT, tagline TEXT, rating TEXT, '
-        'duration INTEGER DEFAULT 0, guid TEXT, directors TEXT, writers TEXT, actors TEXT, genres TEXT, studio TEXT, '
-        'labels TEXT, live INTEGER DEFAULT 0, channel_call_sign TEXT, channel_identifier TEXT, channel_thumb TEXT, '
-        'marker_credits_first INTEGER DEFAULT NULL, marker_credits_final INTEGER DEFAULT NULL)'
+        "CREATE TABLE IF NOT EXISTS session_history_metadata (id INTEGER PRIMARY KEY, "
+        "rating_key INTEGER, parent_rating_key INTEGER, grandparent_rating_key INTEGER, "
+        "title TEXT, parent_title TEXT, grandparent_title TEXT, original_title TEXT, full_title TEXT, "
+        "media_index INTEGER, parent_media_index INTEGER, "
+        "thumb TEXT, parent_thumb TEXT, grandparent_thumb TEXT, "
+        "art TEXT, media_type TEXT, year INTEGER, originally_available_at TEXT, added_at INTEGER, updated_at INTEGER, "
+        "last_viewed_at INTEGER, content_rating TEXT, summary TEXT, tagline TEXT, rating TEXT, "
+        "duration INTEGER DEFAULT 0, guid TEXT, directors TEXT, writers TEXT, actors TEXT, genres TEXT, studio TEXT, "
+        "labels TEXT, live INTEGER DEFAULT 0, channel_call_sign TEXT, channel_identifier TEXT, channel_thumb TEXT, "
+        "marker_credits_first INTEGER DEFAULT NULL, marker_credits_final INTEGER DEFAULT NULL)"
     )
 
     # users table :: This table keeps record of the friends list
     c_db.execute(
-        'CREATE TABLE IF NOT EXISTS users (id INTEGER PRIMARY KEY AUTOINCREMENT, '
-        'user_id INTEGER DEFAULT NULL UNIQUE, username TEXT NOT NULL, friendly_name TEXT, '
-        'thumb TEXT, custom_avatar_url TEXT, title TEXT, email TEXT, '
-        'is_active INTEGER DEFAULT 1, is_admin INTEGER DEFAULT 0, is_home_user INTEGER DEFAULT NULL, '
-        'is_allow_sync INTEGER DEFAULT NULL, is_restricted INTEGER DEFAULT NULL, '
-        'do_notify INTEGER DEFAULT 1, keep_history INTEGER DEFAULT 1, deleted_user INTEGER DEFAULT 0, '
-        'allow_guest INTEGER DEFAULT 0, user_token TEXT, server_token TEXT, shared_libraries TEXT, '
-        'filter_all TEXT, filter_movies TEXT, filter_tv TEXT, filter_music TEXT, filter_photos TEXT)'
+        "CREATE TABLE IF NOT EXISTS users (id INTEGER PRIMARY KEY AUTOINCREMENT, "
+        "user_id INTEGER DEFAULT NULL UNIQUE, username TEXT NOT NULL, friendly_name TEXT, "
+        "thumb TEXT, custom_avatar_url TEXT, title TEXT, email TEXT, "
+        "is_active INTEGER DEFAULT 1, is_admin INTEGER DEFAULT 0, is_home_user INTEGER DEFAULT NULL, "
+        "is_allow_sync INTEGER DEFAULT NULL, is_restricted INTEGER DEFAULT NULL, "
+        "do_notify INTEGER DEFAULT 1, keep_history INTEGER DEFAULT 1, deleted_user INTEGER DEFAULT 0, "
+        "allow_guest INTEGER DEFAULT 0, user_token TEXT, server_token TEXT, shared_libraries TEXT, "
+        "filter_all TEXT, filter_movies TEXT, filter_tv TEXT, filter_music TEXT, filter_photos TEXT)"
     )
 
     # library_sections table :: This table keeps record of the servers library sections
     c_db.execute(
-        'CREATE TABLE IF NOT EXISTS library_sections (id INTEGER PRIMARY KEY AUTOINCREMENT, '
-        'server_id TEXT, section_id INTEGER, section_name TEXT, section_type TEXT, agent TEXT, '
-        'thumb TEXT, custom_thumb_url TEXT, art TEXT, custom_art_url TEXT, '
-        'count INTEGER, parent_count INTEGER, child_count INTEGER, is_active INTEGER DEFAULT 1, '
-        'do_notify INTEGER DEFAULT 1, do_notify_created INTEGER DEFAULT 1, keep_history INTEGER DEFAULT 1, '
-        'deleted_section INTEGER DEFAULT 0, UNIQUE(server_id, section_id))'
+        "CREATE TABLE IF NOT EXISTS library_sections (id INTEGER PRIMARY KEY AUTOINCREMENT, "
+        "server_id TEXT, section_id INTEGER, section_name TEXT, section_type TEXT, agent TEXT, "
+        "thumb TEXT, custom_thumb_url TEXT, art TEXT, custom_art_url TEXT, "
+        "count INTEGER, parent_count INTEGER, child_count INTEGER, is_active INTEGER DEFAULT 1, "
+        "do_notify INTEGER DEFAULT 1, do_notify_created INTEGER DEFAULT 1, keep_history INTEGER DEFAULT 1, "
+        "deleted_section INTEGER DEFAULT 0, UNIQUE(server_id, section_id))"
     )
 
     # user_login table :: This table keeps record of the Tautulli guest logins
     c_db.execute(
-        'CREATE TABLE IF NOT EXISTS user_login (id INTEGER PRIMARY KEY AUTOINCREMENT, '
-        'timestamp INTEGER, user_id INTEGER, user TEXT, user_group TEXT, '
-        'ip_address TEXT, host TEXT, user_agent TEXT, success INTEGER DEFAULT 1,'
-        'expiry TEXT, jwt_token TEXT)'
+        "CREATE TABLE IF NOT EXISTS user_login (id INTEGER PRIMARY KEY AUTOINCREMENT, "
+        "timestamp INTEGER, user_id INTEGER, user TEXT, user_group TEXT, "
+        "ip_address TEXT, host TEXT, user_agent TEXT, success INTEGER DEFAULT 1,"
+        "expiry TEXT, jwt_token TEXT)"
     )
 
     # notifiers table :: This table keeps record of the notification agent settings
     c_db.execute(
-        'CREATE TABLE IF NOT EXISTS notifiers (id INTEGER PRIMARY KEY AUTOINCREMENT, '
-        'agent_id INTEGER, agent_name TEXT, agent_label TEXT, friendly_name TEXT, notifier_config TEXT, '
-        'on_play INTEGER DEFAULT 0, on_stop INTEGER DEFAULT 0, on_pause INTEGER DEFAULT 0, '
-        'on_resume INTEGER DEFAULT 0, on_change INTEGER DEFAULT 0, on_buffer INTEGER DEFAULT 0, '
-        'on_error INTEGER DEFAULT 0, '
-        'on_intro INTEGER DEFAULT 0, on_credits INTEGER DEFAULT 0, on_commercial INTEGER DEFAULT 0, '
-        'on_watched INTEGER DEFAULT 0, on_created INTEGER DEFAULT 0, '
-        'on_extdown INTEGER DEFAULT 0, on_intdown INTEGER DEFAULT 0, '
-        'on_extup INTEGER DEFAULT 0, on_intup INTEGER DEFAULT 0, on_pmsupdate INTEGER DEFAULT 0, '
-        'on_concurrent INTEGER DEFAULT 0, on_newdevice INTEGER DEFAULT 0, on_plexpyupdate INTEGER DEFAULT 0, '
-        'on_plexpydbcorrupt INTEGER DEFAULT 0, '
-        'on_play_subject TEXT, on_stop_subject TEXT, on_pause_subject TEXT, '
-        'on_resume_subject TEXT, on_change_subject TEXT, on_buffer_subject TEXT, on_error_subject TEXT, '
-        'on_intro_subject TEXT, on_credits_subject TEXT, on_commercial_subject TEXT,'
-        'on_watched_subject TEXT, on_created_subject TEXT, on_extdown_subject TEXT, on_intdown_subject TEXT, '
-        'on_extup_subject TEXT, on_intup_subject TEXT, on_pmsupdate_subject TEXT, '
-        'on_concurrent_subject TEXT, on_newdevice_subject TEXT, on_plexpyupdate_subject TEXT, '
-        'on_plexpydbcorrupt_subject TEXT, '
-        'on_play_body TEXT, on_stop_body TEXT, on_pause_body TEXT, '
-        'on_resume_body TEXT, on_change_body TEXT, on_buffer_body TEXT, on_error_body TEXT, '
-        'on_intro_body TEXT, on_credits_body TEXT, on_commercial_body TEXT, '
-        'on_watched_body TEXT, on_created_body TEXT, on_extdown_body TEXT, on_intdown_body TEXT, '
-        'on_extup_body TEXT, on_intup_body TEXT, on_pmsupdate_body TEXT, '
-        'on_concurrent_body TEXT, on_newdevice_body TEXT, on_plexpyupdate_body TEXT, '
-        'on_plexpydbcorrupt_body TEXT, '
-        'custom_conditions TEXT, custom_conditions_logic TEXT)'
+        "CREATE TABLE IF NOT EXISTS notifiers (id INTEGER PRIMARY KEY AUTOINCREMENT, "
+        "agent_id INTEGER, agent_name TEXT, agent_label TEXT, friendly_name TEXT, notifier_config TEXT, "
+        "on_play INTEGER DEFAULT 0, on_stop INTEGER DEFAULT 0, on_pause INTEGER DEFAULT 0, "
+        "on_resume INTEGER DEFAULT 0, on_change INTEGER DEFAULT 0, on_buffer INTEGER DEFAULT 0, "
+        "on_error INTEGER DEFAULT 0, "
+        "on_intro INTEGER DEFAULT 0, on_credits INTEGER DEFAULT 0, on_commercial INTEGER DEFAULT 0, "
+        "on_watched INTEGER DEFAULT 0, on_created INTEGER DEFAULT 0, "
+        "on_extdown INTEGER DEFAULT 0, on_intdown INTEGER DEFAULT 0, "
+        "on_extup INTEGER DEFAULT 0, on_intup INTEGER DEFAULT 0, on_pmsupdate INTEGER DEFAULT 0, "
+        "on_concurrent INTEGER DEFAULT 0, on_newdevice INTEGER DEFAULT 0, on_plexpyupdate INTEGER DEFAULT 0, "
+        "on_plexpydbcorrupt INTEGER DEFAULT 0, "
+        "on_play_subject TEXT, on_stop_subject TEXT, on_pause_subject TEXT, "
+        "on_resume_subject TEXT, on_change_subject TEXT, on_buffer_subject TEXT, on_error_subject TEXT, "
+        "on_intro_subject TEXT, on_credits_subject TEXT, on_commercial_subject TEXT,"
+        "on_watched_subject TEXT, on_created_subject TEXT, on_extdown_subject TEXT, on_intdown_subject TEXT, "
+        "on_extup_subject TEXT, on_intup_subject TEXT, on_pmsupdate_subject TEXT, "
+        "on_concurrent_subject TEXT, on_newdevice_subject TEXT, on_plexpyupdate_subject TEXT, "
+        "on_plexpydbcorrupt_subject TEXT, "
+        "on_play_body TEXT, on_stop_body TEXT, on_pause_body TEXT, "
+        "on_resume_body TEXT, on_change_body TEXT, on_buffer_body TEXT, on_error_body TEXT, "
+        "on_intro_body TEXT, on_credits_body TEXT, on_commercial_body TEXT, "
+        "on_watched_body TEXT, on_created_body TEXT, on_extdown_body TEXT, on_intdown_body TEXT, "
+        "on_extup_body TEXT, on_intup_body TEXT, on_pmsupdate_body TEXT, "
+        "on_concurrent_body TEXT, on_newdevice_body TEXT, on_plexpyupdate_body TEXT, "
+        "on_plexpydbcorrupt_body TEXT, "
+        "custom_conditions TEXT, custom_conditions_logic TEXT)"
     )
 
     # notify_log table :: This is a table which logs notifications sent
     c_db.execute(
-        'CREATE TABLE IF NOT EXISTS notify_log (id INTEGER PRIMARY KEY AUTOINCREMENT, timestamp INTEGER, '
-        'session_key INTEGER, rating_key INTEGER, parent_rating_key INTEGER, grandparent_rating_key INTEGER, '
-        'user_id INTEGER, user TEXT, notifier_id INTEGER, agent_id INTEGER, agent_name TEXT, notify_action TEXT, '
-        'subject_text TEXT, body_text TEXT, script_args TEXT, success INTEGER DEFAULT 0, tag TEXT)'
+        "CREATE TABLE IF NOT EXISTS notify_log (id INTEGER PRIMARY KEY AUTOINCREMENT, timestamp INTEGER, "
+        "session_key INTEGER, rating_key INTEGER, parent_rating_key INTEGER, grandparent_rating_key INTEGER, "
+        "user_id INTEGER, user TEXT, notifier_id INTEGER, agent_id INTEGER, agent_name TEXT, notify_action TEXT, "
+        "subject_text TEXT, body_text TEXT, script_args TEXT, success INTEGER DEFAULT 0, tag TEXT)"
     )
 
     # newsletters table :: This table keeps record of the newsletter settings
     c_db.execute(
-        'CREATE TABLE IF NOT EXISTS newsletters (id INTEGER PRIMARY KEY AUTOINCREMENT, '
-        'agent_id INTEGER, agent_name TEXT, agent_label TEXT, id_name TEXT NOT NULL, '
-        'friendly_name TEXT, newsletter_config TEXT, email_config TEXT, '
-        'subject TEXT, body TEXT, message TEXT, '
-        'cron TEXT NOT NULL DEFAULT \'0 0 * * 0\', active INTEGER DEFAULT 0)'
+        "CREATE TABLE IF NOT EXISTS newsletters (id INTEGER PRIMARY KEY AUTOINCREMENT, "
+        "agent_id INTEGER, agent_name TEXT, agent_label TEXT, id_name TEXT NOT NULL, "
+        "friendly_name TEXT, newsletter_config TEXT, email_config TEXT, "
+        "subject TEXT, body TEXT, message TEXT, "
+        "cron TEXT NOT NULL DEFAULT '0 0 * * 0', active INTEGER DEFAULT 0)"
     )
 
     # newsletter_log table :: This is a table which logs newsletters sent
     c_db.execute(
-        'CREATE TABLE IF NOT EXISTS newsletter_log (id INTEGER PRIMARY KEY AUTOINCREMENT, timestamp INTEGER, '
-        'newsletter_id INTEGER, agent_id INTEGER, agent_name TEXT, notify_action TEXT, '
-        'subject_text TEXT, body_text TEXT, message_text TEXT, start_date TEXT, end_date TEXT, '
-        'start_time INTEGER, end_time INTEGER, uuid TEXT UNIQUE, filename TEXT, email_msg_id TEXT, '
-        'success INTEGER DEFAULT 0)'
+        "CREATE TABLE IF NOT EXISTS newsletter_log (id INTEGER PRIMARY KEY AUTOINCREMENT, timestamp INTEGER, "
+        "newsletter_id INTEGER, agent_id INTEGER, agent_name TEXT, notify_action TEXT, "
+        "subject_text TEXT, body_text TEXT, message_text TEXT, start_date TEXT, end_date TEXT, "
+        "start_time INTEGER, end_time INTEGER, uuid TEXT UNIQUE, filename TEXT, email_msg_id TEXT, "
+        "success INTEGER DEFAULT 0)"
     )
 
     # recently_added table :: This table keeps record of recently added items
     c_db.execute(
-        'CREATE TABLE IF NOT EXISTS recently_added (id INTEGER PRIMARY KEY AUTOINCREMENT, '
-        'added_at INTEGER, pms_identifier TEXT, section_id INTEGER, '
-        'rating_key INTEGER, parent_rating_key INTEGER, grandparent_rating_key INTEGER, media_type TEXT, '
-        'media_info TEXT)'
+        "CREATE TABLE IF NOT EXISTS recently_added (id INTEGER PRIMARY KEY AUTOINCREMENT, "
+        "added_at INTEGER, pms_identifier TEXT, section_id INTEGER, "
+        "rating_key INTEGER, parent_rating_key INTEGER, grandparent_rating_key INTEGER, media_type TEXT, "
+        "media_info TEXT)"
     )
 
     # mobile_devices table :: This table keeps record of devices linked with the mobile app
     c_db.execute(
-        'CREATE TABLE IF NOT EXISTS mobile_devices (id INTEGER PRIMARY KEY AUTOINCREMENT, '
-        'device_id TEXT NOT NULL UNIQUE, device_token TEXT, device_name TEXT, '
-        'platform TEXT, version TEXT, friendly_name TEXT, '
-        'onesignal_id TEXT, last_seen INTEGER, official INTEGER DEFAULT 0)'
+        "CREATE TABLE IF NOT EXISTS mobile_devices (id INTEGER PRIMARY KEY AUTOINCREMENT, "
+        "device_id TEXT NOT NULL UNIQUE, device_token TEXT, device_name TEXT, "
+        "platform TEXT, version TEXT, friendly_name TEXT, "
+        "onesignal_id TEXT, last_seen INTEGER, official INTEGER DEFAULT 0)"
     )
 
     # tvmaze_lookup table :: This table keeps record of the TVmaze lookups
     c_db.execute(
-        'CREATE TABLE IF NOT EXISTS tvmaze_lookup (id INTEGER PRIMARY KEY AUTOINCREMENT, '
-        'rating_key INTEGER, thetvdb_id INTEGER, imdb_id TEXT, '
-        'tvmaze_id INTEGER, tvmaze_url TEXT, tvmaze_json TEXT)'
+        "CREATE TABLE IF NOT EXISTS tvmaze_lookup (id INTEGER PRIMARY KEY AUTOINCREMENT, "
+        "rating_key INTEGER, thetvdb_id INTEGER, imdb_id TEXT, "
+        "tvmaze_id INTEGER, tvmaze_url TEXT, tvmaze_json TEXT)"
     )
 
     # themoviedb_lookup table :: This table keeps record of the TheMovieDB lookups
     c_db.execute(
-        'CREATE TABLE IF NOT EXISTS themoviedb_lookup (id INTEGER PRIMARY KEY AUTOINCREMENT, '
-        'rating_key INTEGER, thetvdb_id INTEGER, imdb_id TEXT, '
-        'themoviedb_id INTEGER, themoviedb_url TEXT, themoviedb_json TEXT)'
+        "CREATE TABLE IF NOT EXISTS themoviedb_lookup (id INTEGER PRIMARY KEY AUTOINCREMENT, "
+        "rating_key INTEGER, thetvdb_id INTEGER, imdb_id TEXT, "
+        "themoviedb_id INTEGER, themoviedb_url TEXT, themoviedb_json TEXT)"
     )
 
     # musicbrainz_lookup table :: This table keeps record of the MusicBrainz lookups
     c_db.execute(
-        'CREATE TABLE IF NOT EXISTS musicbrainz_lookup (id INTEGER PRIMARY KEY AUTOINCREMENT, '
-        'rating_key INTEGER, musicbrainz_id INTEGER, musicbrainz_url TEXT, musicbrainz_type TEXT, '
-        'musicbrainz_json TEXT)'
+        "CREATE TABLE IF NOT EXISTS musicbrainz_lookup (id INTEGER PRIMARY KEY AUTOINCREMENT, "
+        "rating_key INTEGER, musicbrainz_id INTEGER, musicbrainz_url TEXT, musicbrainz_type TEXT, "
+        "musicbrainz_json TEXT)"
     )
 
     # image_hash_lookup table :: This table keeps record of the image hash lookups
     c_db.execute(
-        'CREATE TABLE IF NOT EXISTS image_hash_lookup (id INTEGER PRIMARY KEY AUTOINCREMENT, '
-        'img_hash TEXT UNIQUE, img TEXT, rating_key INTEGER, width INTEGER, height INTEGER, '
-        'opacity INTEGER, background TEXT, blur INTEGER, fallback TEXT)'
+        "CREATE TABLE IF NOT EXISTS image_hash_lookup (id INTEGER PRIMARY KEY AUTOINCREMENT, "
+        "img_hash TEXT UNIQUE, img TEXT, rating_key INTEGER, width INTEGER, height INTEGER, "
+        "opacity INTEGER, background TEXT, blur INTEGER, fallback TEXT)"
     )
 
     # imgur_lookup table :: This table keeps record of the Imgur uploads
     c_db.execute(
-        'CREATE TABLE IF NOT EXISTS imgur_lookup (id INTEGER PRIMARY KEY AUTOINCREMENT, '
-        'img_hash TEXT, imgur_title TEXT, imgur_url TEXT, delete_hash TEXT)'
+        "CREATE TABLE IF NOT EXISTS imgur_lookup (id INTEGER PRIMARY KEY AUTOINCREMENT, "
+        "img_hash TEXT, imgur_title TEXT, imgur_url TEXT, delete_hash TEXT)"
     )
 
     # cloudinary_lookup table :: This table keeps record of the Cloudinary uploads
     c_db.execute(
-        'CREATE TABLE IF NOT EXISTS cloudinary_lookup (id INTEGER PRIMARY KEY AUTOINCREMENT, '
-        'img_hash TEXT, cloudinary_title TEXT, cloudinary_url TEXT)'
+        "CREATE TABLE IF NOT EXISTS cloudinary_lookup (id INTEGER PRIMARY KEY AUTOINCREMENT, "
+        "img_hash TEXT, cloudinary_title TEXT, cloudinary_url TEXT)"
     )
 
     # exports table :: This table keeps record of the exported files
     c_db.execute(
-        'CREATE TABLE IF NOT EXISTS exports (id INTEGER PRIMARY KEY AUTOINCREMENT, '
-        'timestamp INTEGER, section_id INTEGER, user_id INTEGER, rating_key INTEGER, media_type TEXT, '
-        'title TEXT, file_format TEXT, '
-        'metadata_level INTEGER, media_info_level INTEGER, '
-        'thumb_level INTEGER DEFAULT 0, art_level INTEGER DEFAULT 0, '
-        'custom_fields TEXT, individual_files INTEGER DEFAULT 0, '
-        'file_size INTEGER DEFAULT 0, complete INTEGER DEFAULT 0, '
-        'exported_items INTEGER DEFAULT 0, total_items INTEGER DEFAULT 0)'
+        "CREATE TABLE IF NOT EXISTS exports (id INTEGER PRIMARY KEY AUTOINCREMENT, "
+        "timestamp INTEGER, section_id INTEGER, user_id INTEGER, rating_key INTEGER, media_type TEXT, "
+        "title TEXT, file_format TEXT, "
+        "metadata_level INTEGER, media_info_level INTEGER, "
+        "thumb_level INTEGER DEFAULT 0, art_level INTEGER DEFAULT 0, "
+        "custom_fields TEXT, individual_files INTEGER DEFAULT 0, "
+        "file_size INTEGER DEFAULT 0, complete INTEGER DEFAULT 0, "
+        "exported_items INTEGER DEFAULT 0, total_items INTEGER DEFAULT 0)"
     )
 
     # Upgrade sessions table from earlier versions
     try:
-        c_db.execute('SELECT started FROM sessions')
+        c_db.execute("SELECT started FROM sessions")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table sessions.")
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN started INTEGER'
+            "ALTER TABLE sessions ADD COLUMN started INTEGER"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN paused_counter INTEGER DEFAULT 0'
+            "ALTER TABLE sessions ADD COLUMN paused_counter INTEGER DEFAULT 0"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN state TEXT'
+            "ALTER TABLE sessions ADD COLUMN state TEXT"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN user TEXT'
+            "ALTER TABLE sessions ADD COLUMN user TEXT"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN machine_id TEXT'
+            "ALTER TABLE sessions ADD COLUMN machine_id TEXT"
         )
 
     # Upgrade sessions table from earlier versions
     try:
-        c_db.execute('SELECT title FROM sessions')
+        c_db.execute("SELECT title FROM sessions")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table sessions.")
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN title TEXT'
+            "ALTER TABLE sessions ADD COLUMN title TEXT"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN parent_title TEXT'
+            "ALTER TABLE sessions ADD COLUMN parent_title TEXT"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN grandparent_title TEXT'
+            "ALTER TABLE sessions ADD COLUMN grandparent_title TEXT"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN friendly_name TEXT'
+            "ALTER TABLE sessions ADD COLUMN friendly_name TEXT"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN player TEXT'
+            "ALTER TABLE sessions ADD COLUMN player TEXT"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN user_id INTEGER'
+            "ALTER TABLE sessions ADD COLUMN user_id INTEGER"
         )
 
     # Upgrade sessions table from earlier versions
     try:
-        c_db.execute('SELECT ip_address FROM sessions')
+        c_db.execute("SELECT ip_address FROM sessions")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table sessions.")
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN ip_address TEXT'
+            "ALTER TABLE sessions ADD COLUMN ip_address TEXT"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN platform TEXT'
+            "ALTER TABLE sessions ADD COLUMN platform TEXT"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN parent_rating_key INTEGER'
+            "ALTER TABLE sessions ADD COLUMN parent_rating_key INTEGER"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN grandparent_rating_key INTEGER'
+            "ALTER TABLE sessions ADD COLUMN grandparent_rating_key INTEGER"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN view_offset INTEGER DEFAULT 0'
+            "ALTER TABLE sessions ADD COLUMN view_offset INTEGER DEFAULT 0"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN duration INTEGER'
+            "ALTER TABLE sessions ADD COLUMN duration INTEGER"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN video_decision TEXT'
+            "ALTER TABLE sessions ADD COLUMN video_decision TEXT"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN audio_decision TEXT'
+            "ALTER TABLE sessions ADD COLUMN audio_decision TEXT"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN width INTEGER'
+            "ALTER TABLE sessions ADD COLUMN width INTEGER"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN height INTEGER'
+            "ALTER TABLE sessions ADD COLUMN height INTEGER"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN container TEXT'
+            "ALTER TABLE sessions ADD COLUMN container TEXT"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN video_codec TEXT'
+            "ALTER TABLE sessions ADD COLUMN video_codec TEXT"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN audio_codec TEXT'
+            "ALTER TABLE sessions ADD COLUMN audio_codec TEXT"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN bitrate INTEGER'
+            "ALTER TABLE sessions ADD COLUMN bitrate INTEGER"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN video_resolution TEXT'
+            "ALTER TABLE sessions ADD COLUMN video_resolution TEXT"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN video_framerate TEXT'
+            "ALTER TABLE sessions ADD COLUMN video_framerate TEXT"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN aspect_ratio TEXT'
+            "ALTER TABLE sessions ADD COLUMN aspect_ratio TEXT"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN audio_channels INTEGER'
+            "ALTER TABLE sessions ADD COLUMN audio_channels INTEGER"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN transcode_protocol TEXT'
+            "ALTER TABLE sessions ADD COLUMN transcode_protocol TEXT"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN transcode_container TEXT'
+            "ALTER TABLE sessions ADD COLUMN transcode_container TEXT"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN transcode_video_codec TEXT'
+            "ALTER TABLE sessions ADD COLUMN transcode_video_codec TEXT"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN transcode_audio_codec TEXT'
+            "ALTER TABLE sessions ADD COLUMN transcode_audio_codec TEXT"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN transcode_audio_channels INTEGER'
+            "ALTER TABLE sessions ADD COLUMN transcode_audio_channels INTEGER"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN transcode_width INTEGER'
+            "ALTER TABLE sessions ADD COLUMN transcode_width INTEGER"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN transcode_height INTEGER'
+            "ALTER TABLE sessions ADD COLUMN transcode_height INTEGER"
         )
 
     # Upgrade sessions table from earlier versions
     try:
-        c_db.execute('SELECT buffer_count FROM sessions')
+        c_db.execute("SELECT buffer_count FROM sessions")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table sessions.")
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN buffer_count INTEGER DEFAULT 0'
+            "ALTER TABLE sessions ADD COLUMN buffer_count INTEGER DEFAULT 0"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN buffer_last_triggered INTEGER'
+            "ALTER TABLE sessions ADD COLUMN buffer_last_triggered INTEGER"
         )
 
     # Upgrade sessions table from earlier versions
     try:
-        c_db.execute('SELECT last_paused FROM sessions')
+        c_db.execute("SELECT last_paused FROM sessions")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table sessions.")
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN last_paused INTEGER'
+            "ALTER TABLE sessions ADD COLUMN last_paused INTEGER"
         )
 
     # Upgrade sessions table from earlier versions
     try:
-        c_db.execute('SELECT section_id FROM sessions')
+        c_db.execute("SELECT section_id FROM sessions")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table sessions.")
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN section_id INTEGER'
+            "ALTER TABLE sessions ADD COLUMN section_id INTEGER"
         )
 
     # Upgrade sessions table from earlier versions
     try:
-        c_db.execute('SELECT stopped FROM sessions')
+        c_db.execute("SELECT stopped FROM sessions")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table sessions.")
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN stopped INTEGER'
+            "ALTER TABLE sessions ADD COLUMN stopped INTEGER"
         )
 
     # Upgrade sessions table from earlier versions
     try:
-        c_db.execute('SELECT transcode_key FROM sessions')
+        c_db.execute("SELECT transcode_key FROM sessions")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table sessions.")
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN transcode_key TEXT'
+            "ALTER TABLE sessions ADD COLUMN transcode_key TEXT"
         )
 
     # Upgrade sessions table from earlier versions
     try:
-        c_db.execute('SELECT write_attempts FROM sessions')
+        c_db.execute("SELECT write_attempts FROM sessions")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table sessions.")
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN write_attempts INTEGER DEFAULT 0'
+            "ALTER TABLE sessions ADD COLUMN write_attempts INTEGER DEFAULT 0"
         )
 
     # Upgrade sessions table from earlier versions
     try:
-        c_db.execute('SELECT transcode_decision FROM sessions')
+        c_db.execute("SELECT transcode_decision FROM sessions")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table sessions.")
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN transcode_decision TEXT'
+            "ALTER TABLE sessions ADD COLUMN transcode_decision TEXT"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN full_title TEXT'
+            "ALTER TABLE sessions ADD COLUMN full_title TEXT"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN media_index INTEGER'
+            "ALTER TABLE sessions ADD COLUMN media_index INTEGER"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN parent_media_index INTEGER'
+            "ALTER TABLE sessions ADD COLUMN parent_media_index INTEGER"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN thumb TEXT'
+            "ALTER TABLE sessions ADD COLUMN thumb TEXT"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN parent_thumb TEXT'
+            "ALTER TABLE sessions ADD COLUMN parent_thumb TEXT"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN grandparent_thumb TEXT'
+            "ALTER TABLE sessions ADD COLUMN grandparent_thumb TEXT"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN year INTEGER'
+            "ALTER TABLE sessions ADD COLUMN year INTEGER"
         )
 
     # Upgrade sessions table from earlier versions
     try:
-        c_db.execute('SELECT raw_stream_info FROM sessions')
+        c_db.execute("SELECT raw_stream_info FROM sessions")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table sessions.")
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN product TEXT'
+            "ALTER TABLE sessions ADD COLUMN product TEXT"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN optimized_version INTEGER'
+            "ALTER TABLE sessions ADD COLUMN optimized_version INTEGER"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN optimized_version_profile TEXT'
+            "ALTER TABLE sessions ADD COLUMN optimized_version_profile TEXT"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN synced_version INTEGER'
+            "ALTER TABLE sessions ADD COLUMN synced_version INTEGER"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN video_bitrate INTEGER'
+            "ALTER TABLE sessions ADD COLUMN video_bitrate INTEGER"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN video_width INTEGER'
+            "ALTER TABLE sessions ADD COLUMN video_width INTEGER"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN video_height INTEGER'
+            "ALTER TABLE sessions ADD COLUMN video_height INTEGER"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN audio_bitrate INTEGER'
+            "ALTER TABLE sessions ADD COLUMN audio_bitrate INTEGER"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN subtitle_codec TEXT'
+            "ALTER TABLE sessions ADD COLUMN subtitle_codec TEXT"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN stream_bitrate INTEGER'
+            "ALTER TABLE sessions ADD COLUMN stream_bitrate INTEGER"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN stream_video_resolution TEXT'
+            "ALTER TABLE sessions ADD COLUMN stream_video_resolution TEXT"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN quality_profile TEXT'
+            "ALTER TABLE sessions ADD COLUMN quality_profile TEXT"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN stream_container_decision TEXT'
+            "ALTER TABLE sessions ADD COLUMN stream_container_decision TEXT"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN stream_container TEXT'
+            "ALTER TABLE sessions ADD COLUMN stream_container TEXT"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN stream_video_decision TEXT'
+            "ALTER TABLE sessions ADD COLUMN stream_video_decision TEXT"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN stream_video_codec TEXT'
+            "ALTER TABLE sessions ADD COLUMN stream_video_codec TEXT"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN stream_video_bitrate INTEGER'
+            "ALTER TABLE sessions ADD COLUMN stream_video_bitrate INTEGER"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN stream_video_width INTEGER'
+            "ALTER TABLE sessions ADD COLUMN stream_video_width INTEGER"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN stream_video_height INTEGER'
+            "ALTER TABLE sessions ADD COLUMN stream_video_height INTEGER"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN stream_video_framerate TEXT'
+            "ALTER TABLE sessions ADD COLUMN stream_video_framerate TEXT"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN stream_audio_decision TEXT'
+            "ALTER TABLE sessions ADD COLUMN stream_audio_decision TEXT"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN stream_audio_codec TEXT'
+            "ALTER TABLE sessions ADD COLUMN stream_audio_codec TEXT"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN stream_audio_bitrate INTEGER'
+            "ALTER TABLE sessions ADD COLUMN stream_audio_bitrate INTEGER"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN stream_audio_channels INTEGER'
+            "ALTER TABLE sessions ADD COLUMN stream_audio_channels INTEGER"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN subtitles INTEGER'
+            "ALTER TABLE sessions ADD COLUMN subtitles INTEGER"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN stream_subtitle_decision TEXT'
+            "ALTER TABLE sessions ADD COLUMN stream_subtitle_decision TEXT"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN stream_subtitle_codec TEXT'
+            "ALTER TABLE sessions ADD COLUMN stream_subtitle_codec TEXT"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN raw_stream_info TEXT'
+            "ALTER TABLE sessions ADD COLUMN raw_stream_info TEXT"
         )
 
     # Upgrade sessions table from earlier versions
     try:
-        c_db.execute('SELECT video_height FROM sessions')
+        c_db.execute("SELECT video_height FROM sessions")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table sessions.")
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN video_height INTEGER'
+            "ALTER TABLE sessions ADD COLUMN video_height INTEGER"
         )
 
     # Upgrade sessions table from earlier versions
     try:
-        c_db.execute('SELECT subtitles FROM sessions')
+        c_db.execute("SELECT subtitles FROM sessions")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table sessions.")
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN subtitles INTEGER'
+            "ALTER TABLE sessions ADD COLUMN subtitles INTEGER"
         )
 
     # Upgrade sessions table from earlier versions
     try:
-        c_db.execute('SELECT synced_version_profile FROM sessions')
+        c_db.execute("SELECT synced_version_profile FROM sessions")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table sessions.")
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN synced_version_profile TEXT'
+            "ALTER TABLE sessions ADD COLUMN synced_version_profile TEXT"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN optimized_version_title TEXT'
+            "ALTER TABLE sessions ADD COLUMN optimized_version_title TEXT"
         )
 
     # Upgrade sessions table from earlier versions
     try:
-        c_db.execute('SELECT transcode_hw_decoding FROM sessions')
+        c_db.execute("SELECT transcode_hw_decoding FROM sessions")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table sessions.")
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN transcode_hw_decoding INTEGER'
+            "ALTER TABLE sessions ADD COLUMN transcode_hw_decoding INTEGER"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN transcode_hw_encoding INTEGER'
+            "ALTER TABLE sessions ADD COLUMN transcode_hw_encoding INTEGER"
         )
 
     # Upgrade sessions table from earlier versions
     try:
-        c_db.execute('SELECT watched FROM sessions')
+        c_db.execute("SELECT watched FROM sessions")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table sessions.")
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN watched INTEGER DEFAULT 0'
+            "ALTER TABLE sessions ADD COLUMN watched INTEGER DEFAULT 0"
         )
 
     # Upgrade sessions table from earlier versions
     try:
-        c_db.execute('SELECT live FROM sessions')
+        c_db.execute("SELECT live FROM sessions")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table sessions.")
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN live INTEGER'
+            "ALTER TABLE sessions ADD COLUMN live INTEGER"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN live_uuid TEXT'
+            "ALTER TABLE sessions ADD COLUMN live_uuid TEXT"
         )
 
     # Upgrade sessions table from earlier versions
     try:
-        c_db.execute('SELECT session_id FROM sessions')
+        c_db.execute("SELECT session_id FROM sessions")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table sessions.")
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN session_id TEXT'
+            "ALTER TABLE sessions ADD COLUMN session_id TEXT"
         )
 
     # Upgrade sessions table from earlier versions
     try:
-        c_db.execute('SELECT original_title FROM sessions')
+        c_db.execute("SELECT original_title FROM sessions")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table sessions.")
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN original_title TEXT'
+            "ALTER TABLE sessions ADD COLUMN original_title TEXT"
         )
 
     # Upgrade sessions table from earlier versions
     try:
-        c_db.execute('SELECT secure FROM sessions')
+        c_db.execute("SELECT secure FROM sessions")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table sessions.")
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN secure INTEGER'
+            "ALTER TABLE sessions ADD COLUMN secure INTEGER"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN relayed INTEGER'
+            "ALTER TABLE sessions ADD COLUMN relayed INTEGER"
         )
 
     # Upgrade sessions table from earlier versions
     try:
-        c_db.execute('SELECT rating_key_websocket FROM sessions')
+        c_db.execute("SELECT rating_key_websocket FROM sessions")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table sessions.")
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN rating_key_websocket TEXT'
+            "ALTER TABLE sessions ADD COLUMN rating_key_websocket TEXT"
         )
 
     # Upgrade sessions table from earlier versions
     try:
-        c_db.execute('SELECT video_scan_type FROM sessions')
+        c_db.execute("SELECT video_scan_type FROM sessions")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table sessions.")
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN video_scan_type TEXT'
+            "ALTER TABLE sessions ADD COLUMN video_scan_type TEXT"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN video_full_resolution TEXT'
+            "ALTER TABLE sessions ADD COLUMN video_full_resolution TEXT"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN stream_video_scan_type TEXT'
+            "ALTER TABLE sessions ADD COLUMN stream_video_scan_type TEXT"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN stream_video_full_resolution TEXT'
+            "ALTER TABLE sessions ADD COLUMN stream_video_full_resolution TEXT"
         )
 
     # Upgrade sessions table from earlier versions
     try:
-        c_db.execute('SELECT video_dynamic_range FROM sessions')
+        c_db.execute("SELECT video_dynamic_range FROM sessions")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table sessions.")
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN video_dynamic_range TEXT'
+            "ALTER TABLE sessions ADD COLUMN video_dynamic_range TEXT"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN stream_video_dynamic_range TEXT'
+            "ALTER TABLE sessions ADD COLUMN stream_video_dynamic_range TEXT"
         )
 
     # Upgrade sessions table from earlier versions
     try:
-        c_db.execute('SELECT channel_identifier FROM sessions')
+        c_db.execute("SELECT channel_identifier FROM sessions")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table sessions.")
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN channel_call_sign TEXT'
+            "ALTER TABLE sessions ADD COLUMN channel_call_sign TEXT"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN channel_identifier TEXT'
+            "ALTER TABLE sessions ADD COLUMN channel_identifier TEXT"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN channel_thumb TEXT'
+            "ALTER TABLE sessions ADD COLUMN channel_thumb TEXT"
         )
 
     # Upgrade sessions table from earlier versions
     try:
-        c_db.execute('SELECT originally_available_at FROM sessions')
+        c_db.execute("SELECT originally_available_at FROM sessions")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table sessions.")
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN originally_available_at TEXT'
+            "ALTER TABLE sessions ADD COLUMN originally_available_at TEXT"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN added_at INTEGER'
+            "ALTER TABLE sessions ADD COLUMN added_at INTEGER"
         )
 
     # Upgrade sessions table from earlier versions
     try:
-        c_db.execute('SELECT guid FROM sessions')
+        c_db.execute("SELECT guid FROM sessions")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table sessions.")
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN guid TEXT'
+            "ALTER TABLE sessions ADD COLUMN guid TEXT"
         )
 
     # Upgrade sessions table from earlier versions
     try:
-        c_db.execute('SELECT bandwidth FROM sessions')
+        c_db.execute("SELECT bandwidth FROM sessions")
     except sqlite3.OperationalError:
         logger.debug(u"Altering database. Updating database table sessions.")
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN bandwidth INTEGER'
+            "ALTER TABLE sessions ADD COLUMN bandwidth INTEGER"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN location TEXT'
+            "ALTER TABLE sessions ADD COLUMN location TEXT"
         )
 
     # Upgrade sessions table from earlier versions
     try:
-        c_db.execute('SELECT initial_stream FROM sessions')
+        c_db.execute("SELECT initial_stream FROM sessions")
     except sqlite3.OperationalError:
         logger.debug(u"Altering database. Updating database table sessions.")
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN initial_stream INTEGER DEFAULT 1'
+            "ALTER TABLE sessions ADD COLUMN initial_stream INTEGER DEFAULT 1"
         )
 
     # Upgrade sessions table from earlier versions
     try:
-        c_db.execute('SELECT audio_language FROM sessions')
+        c_db.execute("SELECT audio_language FROM sessions")
     except sqlite3.OperationalError:
         logger.debug(u"Altering database. Updating database table sessions.")
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN audio_language TEXT'
+            "ALTER TABLE sessions ADD COLUMN audio_language TEXT"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN audio_language_code TEXT'
+            "ALTER TABLE sessions ADD COLUMN audio_language_code TEXT"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN stream_audio_language TEXT'
+            "ALTER TABLE sessions ADD COLUMN stream_audio_language TEXT"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN stream_audio_language_code TEXT'
+            "ALTER TABLE sessions ADD COLUMN stream_audio_language_code TEXT"
         )
 
     # Upgrade sessions table from earlier versions
     try:
-        c_db.execute('SELECT subtitle_language FROM sessions')
+        c_db.execute("SELECT subtitle_language FROM sessions")
     except sqlite3.OperationalError:
         logger.debug(u"Altering database. Updating database table sessions.")
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN subtitle_language TEXT'
+            "ALTER TABLE sessions ADD COLUMN subtitle_language TEXT"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN stream_subtitle_language TEXT'
+            "ALTER TABLE sessions ADD COLUMN stream_subtitle_language TEXT"
         )
 
     # Upgrade sessions table from earlier versions
     try:
-        c_db.execute('SELECT subtitle_forced FROM sessions')
+        c_db.execute("SELECT subtitle_forced FROM sessions")
     except sqlite3.OperationalError:
         logger.debug(u"Altering database. Updating database table sessions.")
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN subtitle_forced INTEGER'
+            "ALTER TABLE sessions ADD COLUMN subtitle_forced INTEGER"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN stream_subtitle_forced INTEGER'
+            "ALTER TABLE sessions ADD COLUMN stream_subtitle_forced INTEGER"
         )
 
     # Upgrade sessions table from earlier versions
     try:
-        c_db.execute('SELECT intro FROM sessions')
+        c_db.execute("SELECT intro FROM sessions")
     except sqlite3.OperationalError:
         logger.debug(u"Altering database. Updating database table sessions.")
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN intro INTEGER DEFAULT 0'
+            "ALTER TABLE sessions ADD COLUMN intro INTEGER DEFAULT 0"
         )
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN credits INTEGER DEFAULT 0'
+            "ALTER TABLE sessions ADD COLUMN credits INTEGER DEFAULT 0"
         )
 
     # Upgrade sessions table from earlier versions
     try:
-        c_db.execute('SELECT commercial FROM sessions')
+        c_db.execute("SELECT commercial FROM sessions")
     except sqlite3.OperationalError:
         logger.debug(u"Altering database. Updating database table sessions.")
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN commercial INTEGER DEFAULT 0'
+            "ALTER TABLE sessions ADD COLUMN commercial INTEGER DEFAULT 0"
         )
 
     # Upgrade sessions table from earlier versions
     try:
-        c_db.execute('SELECT marker FROM sessions')
+        c_db.execute("SELECT marker FROM sessions")
     except sqlite3.OperationalError:
         logger.debug(u"Altering database. Updating database table sessions.")
         c_db.execute(
-            'ALTER TABLE sessions ADD COLUMN marker INTEGER DEFAULT 0'
+            "ALTER TABLE sessions ADD COLUMN marker INTEGER DEFAULT 0"
         )
 
     # Upgrade session_history table from earlier versions
     try:
-        c_db.execute('SELECT reference_id FROM session_history')
+        c_db.execute("SELECT reference_id FROM session_history")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table session_history.")
         c_db.execute(
-            'ALTER TABLE session_history ADD COLUMN reference_id INTEGER DEFAULT 0'
+            "ALTER TABLE session_history ADD COLUMN reference_id INTEGER DEFAULT 0"
         )
         # Set reference_id to the first row where (user_id = previous row, rating_key != previous row) and user_id = user_id
         c_db.execute(
-            'UPDATE session_history ' \
-            'SET reference_id = (SELECT (CASE \
+            "UPDATE session_history " \
+            "SET reference_id = (SELECT (CASE \
              WHEN (SELECT MIN(id) FROM session_history WHERE id > ( \
                  SELECT MAX(id) FROM session_history \
                  WHERE (user_id = t1.user_id AND rating_key <> t1.rating_key AND id < t1.id)) AND user_id = t1.user_id) IS NULL \
              THEN (SELECT MIN(id) FROM session_history WHERE (user_id = t1.user_id)) \
              ELSE (SELECT MIN(id) FROM session_history WHERE id > ( \
                  SELECT MAX(id) FROM session_history \
-                 WHERE (user_id = t1.user_id AND rating_key <> t1.rating_key AND id < t1.id)) AND user_id = t1.user_id) END) ' \
-            'FROM session_history AS t1 ' \
-            'WHERE t1.id = session_history.id) '
+                 WHERE (user_id = t1.user_id AND rating_key <> t1.rating_key AND id < t1.id)) AND user_id = t1.user_id) END) " \
+            "FROM session_history AS t1 " \
+            "WHERE t1.id = session_history.id) "
         )
 
     # Upgrade session_history table from earlier versions
     try:
-        c_db.execute('SELECT bandwidth FROM session_history')
+        c_db.execute("SELECT bandwidth FROM session_history")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table session_history.")
         c_db.execute(
-            'ALTER TABLE session_history ADD COLUMN platform_version TEXT'
+            "ALTER TABLE session_history ADD COLUMN platform_version TEXT"
         )
         c_db.execute(
-            'ALTER TABLE session_history ADD COLUMN product TEXT'
+            "ALTER TABLE session_history ADD COLUMN product TEXT"
         )
         c_db.execute(
-            'ALTER TABLE session_history ADD COLUMN product_version TEXT'
+            "ALTER TABLE session_history ADD COLUMN product_version TEXT"
         )
         c_db.execute(
-            'ALTER TABLE session_history ADD COLUMN profile TEXT'
+            "ALTER TABLE session_history ADD COLUMN profile TEXT"
         )
         c_db.execute(
-            'ALTER TABLE session_history ADD COLUMN bandwidth INTEGER'
+            "ALTER TABLE session_history ADD COLUMN bandwidth INTEGER"
         )
         c_db.execute(
-            'ALTER TABLE session_history ADD COLUMN location TEXT'
+            "ALTER TABLE session_history ADD COLUMN location TEXT"
         )
         c_db.execute(
-            'ALTER TABLE session_history ADD COLUMN quality_profile TEXT'
+            "ALTER TABLE session_history ADD COLUMN quality_profile TEXT"
         )
 
     # Upgrade session_history table from earlier versions
     try:
-        c_db.execute('SELECT secure FROM session_history')
+        c_db.execute("SELECT secure FROM session_history")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table session_history.")
         c_db.execute(
-            'ALTER TABLE session_history ADD COLUMN secure INTEGER'
+            "ALTER TABLE session_history ADD COLUMN secure INTEGER"
         )
         c_db.execute(
-            'ALTER TABLE session_history ADD COLUMN relayed INTEGER'
+            "ALTER TABLE session_history ADD COLUMN relayed INTEGER"
         )
 
     # Upgrade session_history table from earlier versions
     try:
-        result = c_db.execute('SELECT platform FROM session_history '
-                              'WHERE platform = "windows"').fetchall()
+        result = c_db.execute("SELECT platform FROM session_history "
+                              "WHERE platform = 'windows'").fetchall()
         if len(result) > 0:
             logger.debug("Altering database. Capitalizing Windows platform values in session_history table.")
             c_db.execute(
-                'UPDATE session_history SET platform = "Windows" WHERE platform = "windows" '
+                "UPDATE session_history SET platform = 'Windows' WHERE platform = 'windows' "
             )
     except sqlite3.OperationalError:
         logger.warn("Unable to capitalize Windows platform values in session_history table.")
 
     # Upgrade session_history_metadata table from earlier versions
     try:
-        c_db.execute('SELECT full_title FROM session_history_metadata')
+        c_db.execute("SELECT full_title FROM session_history_metadata")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table session_history_metadata.")
         c_db.execute(
-            'ALTER TABLE session_history_metadata ADD COLUMN full_title TEXT'
+            "ALTER TABLE session_history_metadata ADD COLUMN full_title TEXT"
         )
 
     # Upgrade session_history_metadata table from earlier versions
     try:
-        c_db.execute('SELECT tagline FROM session_history_metadata')
+        c_db.execute("SELECT tagline FROM session_history_metadata")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table session_history_metadata.")
         c_db.execute(
-            'ALTER TABLE session_history_metadata ADD COLUMN tagline TEXT'
+            "ALTER TABLE session_history_metadata ADD COLUMN tagline TEXT"
         )
 
     # Upgrade session_history_metadata table from earlier versions
     try:
-        c_db.execute('SELECT labels FROM session_history_metadata')
+        c_db.execute("SELECT labels FROM session_history_metadata")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table session_history_metadata.")
         c_db.execute(
-            'ALTER TABLE session_history_metadata ADD COLUMN labels TEXT'
+            "ALTER TABLE session_history_metadata ADD COLUMN labels TEXT"
         )
 
     # Upgrade session_history_metadata table from earlier versions
     try:
-        c_db.execute('SELECT original_title FROM session_history_metadata')
+        c_db.execute("SELECT original_title FROM session_history_metadata")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table session_history_metadata.")
         c_db.execute(
-            'ALTER TABLE session_history_metadata ADD COLUMN original_title TEXT'
+            "ALTER TABLE session_history_metadata ADD COLUMN original_title TEXT"
         )
 
     # Upgrade session_history_metadata table from earlier versions
     try:
-        c_db.execute('SELECT live FROM session_history_metadata')
+        c_db.execute("SELECT live FROM session_history_metadata")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table session_history_metadata.")
         c_db.execute(
-            'ALTER TABLE session_history_metadata ADD COLUMN live INTEGER DEFAULT 0'
+            "ALTER TABLE session_history_metadata ADD COLUMN live INTEGER DEFAULT 0"
         )
         c_db.execute(
-            'ALTER TABLE session_history_metadata ADD COLUMN channel_call_sign TEXT'
+            "ALTER TABLE session_history_metadata ADD COLUMN channel_call_sign TEXT"
         )
         c_db.execute(
-            'ALTER TABLE session_history_metadata ADD COLUMN channel_identifier TEXT'
+            "ALTER TABLE session_history_metadata ADD COLUMN channel_identifier TEXT"
         )
         c_db.execute(
-            'ALTER TABLE session_history_metadata ADD COLUMN channel_thumb TEXT'
+            "ALTER TABLE session_history_metadata ADD COLUMN channel_thumb TEXT"
         )
 
     # Upgrade session_history_metadata table from earlier versions
     try:
-        c_db.execute('SELECT marker_credits_first FROM session_history_metadata')
+        c_db.execute("SELECT marker_credits_first FROM session_history_metadata")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table session_history_metadata.")
         c_db.execute(
-            'ALTER TABLE session_history_metadata ADD COLUMN marker_credits_first INTEGER DEFAULT NULL'
+            "ALTER TABLE session_history_metadata ADD COLUMN marker_credits_first INTEGER DEFAULT NULL"
         )
         c_db.execute(
-            'ALTER TABLE session_history_metadata ADD COLUMN marker_credits_final INTEGER DEFAULT NULL'
+            "ALTER TABLE session_history_metadata ADD COLUMN marker_credits_final INTEGER DEFAULT NULL"
         )
 
     # Upgrade session_history_media_info table from earlier versions
     try:
-        c_db.execute('SELECT transcode_decision FROM session_history_media_info')
+        c_db.execute("SELECT transcode_decision FROM session_history_media_info")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table session_history_media_info.")
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN transcode_decision TEXT'
+            "ALTER TABLE session_history_media_info ADD COLUMN transcode_decision TEXT"
         )
         c_db.execute(
-            'UPDATE session_history_media_info SET transcode_decision = (CASE '
-            'WHEN video_decision = "transcode" OR audio_decision = "transcode" THEN "transcode" '
-            'WHEN video_decision = "copy" OR audio_decision = "copy" THEN "copy" '
-            'WHEN video_decision = "direct play" OR audio_decision = "direct play" THEN "direct play" END)'
+            "UPDATE session_history_media_info SET transcode_decision = (CASE "
+            "WHEN video_decision = 'transcode' OR audio_decision = 'transcode' THEN 'transcode' "
+            "WHEN video_decision = 'copy' OR audio_decision = 'copy' THEN 'copy' "
+            "WHEN video_decision = 'direct play' OR audio_decision = 'direct play' THEN 'direct play' END)"
         )
 
     # Upgrade session_history_media_info table from earlier versions
     try:
-        c_db.execute('SELECT subtitles FROM session_history_media_info')
+        c_db.execute("SELECT subtitles FROM session_history_media_info")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table session_history_media_info.")
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN video_bit_depth INTEGER'
+            "ALTER TABLE session_history_media_info ADD COLUMN video_bit_depth INTEGER"
         )
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN video_bitrate INTEGER'
+            "ALTER TABLE session_history_media_info ADD COLUMN video_bitrate INTEGER"
         )
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN video_codec_level TEXT'
+            "ALTER TABLE session_history_media_info ADD COLUMN video_codec_level TEXT"
         )
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN video_width INTEGER'
+            "ALTER TABLE session_history_media_info ADD COLUMN video_width INTEGER"
         )
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN video_height INTEGER'
+            "ALTER TABLE session_history_media_info ADD COLUMN video_height INTEGER"
         )
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN audio_bitrate INTEGER'
+            "ALTER TABLE session_history_media_info ADD COLUMN audio_bitrate INTEGER"
         )
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN transcode_hw_requested INTEGER'
+            "ALTER TABLE session_history_media_info ADD COLUMN transcode_hw_requested INTEGER"
         )
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN transcode_hw_full_pipeline INTEGER'
+            "ALTER TABLE session_history_media_info ADD COLUMN transcode_hw_full_pipeline INTEGER"
         )
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN transcode_hw_decode TEXT'
+            "ALTER TABLE session_history_media_info ADD COLUMN transcode_hw_decode TEXT"
         )
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN transcode_hw_encode TEXT'
+            "ALTER TABLE session_history_media_info ADD COLUMN transcode_hw_encode TEXT"
         )
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN transcode_hw_decode_title TEXT'
+            "ALTER TABLE session_history_media_info ADD COLUMN transcode_hw_decode_title TEXT"
         )
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN transcode_hw_encode_title TEXT'
+            "ALTER TABLE session_history_media_info ADD COLUMN transcode_hw_encode_title TEXT"
         )
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN stream_container TEXT'
+            "ALTER TABLE session_history_media_info ADD COLUMN stream_container TEXT"
         )
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN stream_container_decision TEXT'
+            "ALTER TABLE session_history_media_info ADD COLUMN stream_container_decision TEXT"
         )
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN stream_bitrate INTEGER'
+            "ALTER TABLE session_history_media_info ADD COLUMN stream_bitrate INTEGER"
         )
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN stream_video_decision TEXT'
+            "ALTER TABLE session_history_media_info ADD COLUMN stream_video_decision TEXT"
         )
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN stream_video_bitrate INTEGER'
+            "ALTER TABLE session_history_media_info ADD COLUMN stream_video_bitrate INTEGER"
         )
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN stream_video_codec TEXT'
+            "ALTER TABLE session_history_media_info ADD COLUMN stream_video_codec TEXT"
         )
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN stream_video_codec_level TEXT'
+            "ALTER TABLE session_history_media_info ADD COLUMN stream_video_codec_level TEXT"
         )
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN stream_video_bit_depth INTEGER'
+            "ALTER TABLE session_history_media_info ADD COLUMN stream_video_bit_depth INTEGER"
         )
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN stream_video_height INTEGER'
+            "ALTER TABLE session_history_media_info ADD COLUMN stream_video_height INTEGER"
         )
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN stream_video_width INTEGER'
+            "ALTER TABLE session_history_media_info ADD COLUMN stream_video_width INTEGER"
         )
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN stream_video_resolution TEXT'
+            "ALTER TABLE session_history_media_info ADD COLUMN stream_video_resolution TEXT"
         )
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN stream_video_framerate TEXT'
+            "ALTER TABLE session_history_media_info ADD COLUMN stream_video_framerate TEXT"
         )
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN stream_audio_decision TEXT'
+            "ALTER TABLE session_history_media_info ADD COLUMN stream_audio_decision TEXT"
         )
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN stream_audio_codec TEXT'
+            "ALTER TABLE session_history_media_info ADD COLUMN stream_audio_codec TEXT"
         )
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN stream_audio_bitrate INTEGER'
+            "ALTER TABLE session_history_media_info ADD COLUMN stream_audio_bitrate INTEGER"
         )
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN stream_audio_channels INTEGER'
+            "ALTER TABLE session_history_media_info ADD COLUMN stream_audio_channels INTEGER"
         )
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN stream_subtitle_decision TEXT'
+            "ALTER TABLE session_history_media_info ADD COLUMN stream_subtitle_decision TEXT"
         )
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN stream_subtitle_codec TEXT'
+            "ALTER TABLE session_history_media_info ADD COLUMN stream_subtitle_codec TEXT"
         )
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN stream_subtitle_container TEXT'
+            "ALTER TABLE session_history_media_info ADD COLUMN stream_subtitle_container TEXT"
         )
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN stream_subtitle_forced INTEGER'
+            "ALTER TABLE session_history_media_info ADD COLUMN stream_subtitle_forced INTEGER"
         )
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN subtitles INTEGER'
+            "ALTER TABLE session_history_media_info ADD COLUMN subtitles INTEGER"
         )
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN synced_version INTEGER'
+            "ALTER TABLE session_history_media_info ADD COLUMN synced_version INTEGER"
         )
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN optimized_version INTEGER'
+            "ALTER TABLE session_history_media_info ADD COLUMN optimized_version INTEGER"
         )
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN optimized_version_profile TEXT'
+            "ALTER TABLE session_history_media_info ADD COLUMN optimized_version_profile TEXT"
         )
         c_db.execute(
-            'UPDATE session_history_media_info SET video_resolution=REPLACE(video_resolution, "p", "")'
+            "UPDATE session_history_media_info SET video_resolution=REPLACE(video_resolution, 'p', '')"
         )
         c_db.execute(
-            'UPDATE session_history_media_info SET video_resolution=REPLACE(video_resolution, "SD", "sd")'
+            "UPDATE session_history_media_info SET video_resolution=REPLACE(video_resolution, 'SD', 'sd')"
         )
 
     # Upgrade session_history_media_info table from earlier versions
     try:
-        c_db.execute('SELECT subtitle_codec FROM session_history_media_info')
+        c_db.execute("SELECT subtitle_codec FROM session_history_media_info")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table session_history_media_info.")
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN subtitle_codec TEXT'
+            "ALTER TABLE session_history_media_info ADD COLUMN subtitle_codec TEXT"
         )
 
     # Upgrade session_history_media_info table from earlier versions
     try:
-        c_db.execute('SELECT synced_version_profile FROM session_history_media_info')
+        c_db.execute("SELECT synced_version_profile FROM session_history_media_info")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table session_history_media_info.")
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN synced_version_profile TEXT'
+            "ALTER TABLE session_history_media_info ADD COLUMN synced_version_profile TEXT"
         )
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN optimized_version_title TEXT'
+            "ALTER TABLE session_history_media_info ADD COLUMN optimized_version_title TEXT"
         )
 
     # Upgrade session_history_media_info table from earlier versions
     try:
-        c_db.execute('SELECT transcode_hw_decoding FROM session_history_media_info')
+        c_db.execute("SELECT transcode_hw_decoding FROM session_history_media_info")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table session_history_media_info.")
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN transcode_hw_decoding INTEGER'
+            "ALTER TABLE session_history_media_info ADD COLUMN transcode_hw_decoding INTEGER"
         )
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN transcode_hw_encoding INTEGER'
+            "ALTER TABLE session_history_media_info ADD COLUMN transcode_hw_encoding INTEGER"
         )
         c_db.execute(
-            'UPDATE session_history_media_info SET subtitle_codec = "" WHERE subtitle_codec IS NULL'
+            "UPDATE session_history_media_info SET subtitle_codec = '' WHERE subtitle_codec IS NULL"
         )
 
     # Upgrade session_history_media_info table from earlier versions
     try:
-        result = c_db.execute('SELECT stream_container FROM session_history_media_info '
-                              'WHERE stream_container IS NULL').fetchall()
+        result = c_db.execute("SELECT stream_container FROM session_history_media_info "
+                              "WHERE stream_container IS NULL").fetchall()
         if len(result) > 0:
             logger.debug("Altering database. Removing NULL values from session_history_media_info table.")
             c_db.execute(
-                'UPDATE session_history_media_info SET stream_container = "" WHERE stream_container IS NULL'
+                "UPDATE session_history_media_info SET stream_container = '' WHERE stream_container IS NULL"
             )
             c_db.execute(
-                'UPDATE session_history_media_info SET stream_video_codec = "" WHERE stream_video_codec IS NULL'
+                "UPDATE session_history_media_info SET stream_video_codec = '' WHERE stream_video_codec IS NULL"
             )
             c_db.execute(
-                'UPDATE session_history_media_info SET stream_audio_codec = "" WHERE stream_audio_codec IS NULL'
+                "UPDATE session_history_media_info SET stream_audio_codec = '' WHERE stream_audio_codec IS NULL"
             )
             c_db.execute(
-                'UPDATE session_history_media_info SET stream_subtitle_codec = "" WHERE stream_subtitle_codec IS NULL'
+                "UPDATE session_history_media_info SET stream_subtitle_codec = '' WHERE stream_subtitle_codec IS NULL"
             )
     except sqlite3.OperationalError:
         logger.warn("Unable to remove NULL values from session_history_media_info table.")
 
     # Upgrade session_history_media_info table from earlier versions
     try:
-        c_db.execute('SELECT video_scan_type FROM session_history_media_info')
+        c_db.execute("SELECT video_scan_type FROM session_history_media_info")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table session_history_media_info.")
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN video_scan_type TEXT'
+            "ALTER TABLE session_history_media_info ADD COLUMN video_scan_type TEXT"
         )
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN video_full_resolution TEXT'
+            "ALTER TABLE session_history_media_info ADD COLUMN video_full_resolution TEXT"
         )
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN stream_video_scan_type TEXT'
+            "ALTER TABLE session_history_media_info ADD COLUMN stream_video_scan_type TEXT"
         )
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN stream_video_full_resolution TEXT'
+            "ALTER TABLE session_history_media_info ADD COLUMN stream_video_full_resolution TEXT"
         )
         c_db.execute(
-            'UPDATE session_history_media_info SET video_scan_type = "progressive" '
-            'WHERE video_resolution != ""'
+            "UPDATE session_history_media_info SET video_scan_type = 'progressive' "
+            "WHERE video_resolution != ''"
         )
         c_db.execute(
-            'UPDATE session_history_media_info SET stream_video_scan_type = "progressive" '
-            'WHERE stream_video_resolution != "" AND stream_video_resolution IS NOT NULL'
+            "UPDATE session_history_media_info SET stream_video_scan_type = 'progressive' "
+            "WHERE stream_video_resolution != '' AND stream_video_resolution IS NOT NULL"
         )
         c_db.execute(
-            'UPDATE session_history_media_info SET video_full_resolution = (CASE '
-            'WHEN video_resolution = "" OR video_resolution = "SD" OR video_resolution = "4k" THEN video_resolution '
-            'WHEN video_resolution = "sd" THEN "SD" '
-            'ELSE video_resolution || "p" END)'
+            "UPDATE session_history_media_info SET video_full_resolution = (CASE "
+            "WHEN video_resolution = '' OR video_resolution = 'SD' OR video_resolution = '4k' THEN video_resolution "
+            "WHEN video_resolution = 'sd' THEN 'SD' "
+            "ELSE video_resolution || 'p' END)"
         )
         c_db.execute(
-            'UPDATE session_history_media_info SET stream_video_full_resolution = ( '
-            'CASE WHEN stream_video_resolution = "" OR stream_video_resolution = "SD" OR stream_video_resolution = "4k" '
-            'THEN stream_video_resolution '
-            'WHEN stream_video_resolution = "sd" THEN "SD" '
-            'ELSE stream_video_resolution || "p" END)'
+            "UPDATE session_history_media_info SET stream_video_full_resolution = ( "
+            "CASE WHEN stream_video_resolution = '' OR stream_video_resolution = 'SD' OR stream_video_resolution = '4k' "
+            "THEN stream_video_resolution "
+            "WHEN stream_video_resolution = 'sd' THEN 'SD' "
+            "ELSE stream_video_resolution || 'p' END)"
         )
 
     # Upgrade session_history_media_info table from earlier versions
     try:
-        c_db.execute('SELECT video_dynamic_range FROM session_history_media_info')
+        c_db.execute("SELECT video_dynamic_range FROM session_history_media_info")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table session_history_media_info.")
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN video_dynamic_range TEXT'
+            "ALTER TABLE session_history_media_info ADD COLUMN video_dynamic_range TEXT"
         )
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN stream_video_dynamic_range TEXT'
+            "ALTER TABLE session_history_media_info ADD COLUMN stream_video_dynamic_range TEXT"
         )
 
-    result = c_db.execute('SELECT * FROM session_history_media_info '
-                          'WHERE video_dynamic_range = "SDR" AND stream_video_dynamic_range = "HDR"').fetchone()
+    result = c_db.execute("SELECT * FROM session_history_media_info "
+                          "WHERE video_dynamic_range = 'SDR' AND stream_video_dynamic_range = 'HDR'").fetchone()
     if result:
         c_db.execute(
-            'UPDATE session_history_media_info SET stream_video_dynamic_range = "SDR" '
-            'WHERE video_dynamic_range = "SDR" AND stream_video_dynamic_range = "HDR"'
+            "UPDATE session_history_media_info SET stream_video_dynamic_range = 'SDR' "
+            "WHERE video_dynamic_range = 'SDR' AND stream_video_dynamic_range = 'HDR'"
         )
     
     # Upgrade session_history_media_info table from earlier versions
     try:
-        c_db.execute('SELECT audio_language FROM session_history_media_info')
+        c_db.execute("SELECT audio_language FROM session_history_media_info")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table session_history_media_info.")
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN audio_language TEXT'
+            "ALTER TABLE session_history_media_info ADD COLUMN audio_language TEXT"
         )
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN audio_language_code TEXT'
+            "ALTER TABLE session_history_media_info ADD COLUMN audio_language_code TEXT"
         )
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN stream_audio_language TEXT'
+            "ALTER TABLE session_history_media_info ADD COLUMN stream_audio_language TEXT"
         )
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN stream_audio_language_code TEXT'
+            "ALTER TABLE session_history_media_info ADD COLUMN stream_audio_language_code TEXT"
         ) 
     
     # Upgrade session_history_media_info table from earlier versions
     try:
-        c_db.execute('SELECT subtitle_language FROM session_history_media_info')
+        c_db.execute("SELECT subtitle_language FROM session_history_media_info")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table session_history_media_info.")
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN subtitle_language TEXT'
+            "ALTER TABLE session_history_media_info ADD COLUMN subtitle_language TEXT"
         )
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN stream_subtitle_language TEXT'
+            "ALTER TABLE session_history_media_info ADD COLUMN stream_subtitle_language TEXT"
         )
 
     # Upgrade session_history_media_info table from earlier versions
     try:
-        c_db.execute('SELECT subtitle_forced FROM session_history_media_info')
+        c_db.execute("SELECT subtitle_forced FROM session_history_media_info")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table session_history_media_info.")
         c_db.execute(
-            'ALTER TABLE session_history_media_info ADD COLUMN subtitle_forced INTEGER'
+            "ALTER TABLE session_history_media_info ADD COLUMN subtitle_forced INTEGER"
         )
 
     # Upgrade session_history table from earlier versions
     try:
-        c_db.execute('SELECT section_id FROM session_history')
+        c_db.execute("SELECT section_id FROM session_history")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table session_history.")
         c_db.execute(
-            'ALTER TABLE session_history ADD COLUMN section_id INTEGER'
+            "ALTER TABLE session_history ADD COLUMN section_id INTEGER"
         )
         c_db.execute(
-            'UPDATE session_history SET section_id = ('
-            'SELECT section_id FROM session_history_metadata '
-            'WHERE session_history_metadata.id = session_history.id)'
+            "UPDATE session_history SET section_id = ("
+            "SELECT section_id FROM session_history_metadata "
+            "WHERE session_history_metadata.id = session_history.id)"
         )
         c_db.execute(
-            'CREATE TABLE IF NOT EXISTS session_history_metadata_temp (id INTEGER PRIMARY KEY, '
-            'rating_key INTEGER, parent_rating_key INTEGER, grandparent_rating_key INTEGER, '
-            'title TEXT, parent_title TEXT, grandparent_title TEXT, original_title TEXT, full_title TEXT, '
-            'media_index INTEGER, parent_media_index INTEGER, '
-            'thumb TEXT, parent_thumb TEXT, grandparent_thumb TEXT, '
-            'art TEXT, media_type TEXT, year INTEGER, originally_available_at TEXT, added_at INTEGER, updated_at INTEGER, '
-            'last_viewed_at INTEGER, content_rating TEXT, summary TEXT, tagline TEXT, rating TEXT, '
-            'duration INTEGER DEFAULT 0, guid TEXT, directors TEXT, writers TEXT, actors TEXT, genres TEXT, studio TEXT, '
-            'labels TEXT, live INTEGER DEFAULT 0, channel_call_sign TEXT, channel_identifier TEXT, channel_thumb TEXT)'
+            "CREATE TABLE IF NOT EXISTS session_history_metadata_temp (id INTEGER PRIMARY KEY, "
+            "rating_key INTEGER, parent_rating_key INTEGER, grandparent_rating_key INTEGER, "
+            "title TEXT, parent_title TEXT, grandparent_title TEXT, original_title TEXT, full_title TEXT, "
+            "media_index INTEGER, parent_media_index INTEGER, "
+            "thumb TEXT, parent_thumb TEXT, grandparent_thumb TEXT, "
+            "art TEXT, media_type TEXT, year INTEGER, originally_available_at TEXT, added_at INTEGER, updated_at INTEGER, "
+            "last_viewed_at INTEGER, content_rating TEXT, summary TEXT, tagline TEXT, rating TEXT, "
+            "duration INTEGER DEFAULT 0, guid TEXT, directors TEXT, writers TEXT, actors TEXT, genres TEXT, studio TEXT, "
+            "labels TEXT, live INTEGER DEFAULT 0, channel_call_sign TEXT, channel_identifier TEXT, channel_thumb TEXT)"
         )
         c_db.execute(
-            'INSERT INTO session_history_metadata_temp (id, rating_key, parent_rating_key, grandparent_rating_key, '
-            'title, parent_title, grandparent_title, original_title, full_title, '
-            'media_index, parent_media_index, '
-            'thumb, parent_thumb, grandparent_thumb, '
-            'art, media_type, year, originally_available_at, added_at, updated_at, '
-            'last_viewed_at, content_rating, summary, tagline, rating, '
-            'duration, guid, directors, writers, actors, genres, studio, '
-            'labels, live, channel_call_sign, channel_identifier, channel_thumb) '
-            'SELECT id, rating_key, parent_rating_key, grandparent_rating_key, '
-            'title, parent_title, grandparent_title, original_title, full_title, '
-            'media_index, parent_media_index, '
-            'thumb, parent_thumb, grandparent_thumb, '
-            'art, media_type, year, originally_available_at, added_at, updated_at, '
-            'last_viewed_at, content_rating, summary, tagline, rating, '
-            'duration, guid, directors, writers, actors, genres, studio, '
-            'labels, live, channel_call_sign, channel_identifier, channel_thumb '
-            'FROM session_history_metadata'
+            "INSERT INTO session_history_metadata_temp (id, rating_key, parent_rating_key, grandparent_rating_key, "
+            "title, parent_title, grandparent_title, original_title, full_title, "
+            "media_index, parent_media_index, "
+            "thumb, parent_thumb, grandparent_thumb, "
+            "art, media_type, year, originally_available_at, added_at, updated_at, "
+            "last_viewed_at, content_rating, summary, tagline, rating, "
+            "duration, guid, directors, writers, actors, genres, studio, "
+            "labels, live, channel_call_sign, channel_identifier, channel_thumb) "
+            "SELECT id, rating_key, parent_rating_key, grandparent_rating_key, "
+            "title, parent_title, grandparent_title, original_title, full_title, "
+            "media_index, parent_media_index, "
+            "thumb, parent_thumb, grandparent_thumb, "
+            "art, media_type, year, originally_available_at, added_at, updated_at, "
+            "last_viewed_at, content_rating, summary, tagline, rating, "
+            "duration, guid, directors, writers, actors, genres, studio, "
+            "labels, live, channel_call_sign, channel_identifier, channel_thumb "
+            "FROM session_history_metadata"
         )
         c_db.execute(
-            'DROP TABLE session_history_metadata'
+            "DROP TABLE session_history_metadata"
         )
         c_db.execute(
-            'ALTER TABLE session_history_metadata_temp RENAME TO session_history_metadata'
+            "ALTER TABLE session_history_metadata_temp RENAME TO session_history_metadata"
         )
 
     # Upgrade users table from earlier versions
     try:
-        c_db.execute('SELECT do_notify FROM users')
+        c_db.execute("SELECT do_notify FROM users")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table users.")
         c_db.execute(
-            'ALTER TABLE users ADD COLUMN do_notify INTEGER DEFAULT 1'
+            "ALTER TABLE users ADD COLUMN do_notify INTEGER DEFAULT 1"
         )
 
     # Upgrade users table from earlier versions
     try:
-        c_db.execute('SELECT keep_history FROM users')
+        c_db.execute("SELECT keep_history FROM users")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table users.")
         c_db.execute(
-            'ALTER TABLE users ADD COLUMN keep_history INTEGER DEFAULT 1'
+            "ALTER TABLE users ADD COLUMN keep_history INTEGER DEFAULT 1"
         )
 
     # Upgrade users table from earlier versions
     try:
-        c_db.execute('SELECT custom_avatar_url FROM users')
+        c_db.execute("SELECT custom_avatar_url FROM users")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table users.")
         c_db.execute(
-            'ALTER TABLE users ADD COLUMN custom_avatar_url TEXT'
+            "ALTER TABLE users ADD COLUMN custom_avatar_url TEXT"
         )
 
     # Upgrade users table from earlier versions
     try:
-        c_db.execute('SELECT deleted_user FROM users')
+        c_db.execute("SELECT deleted_user FROM users")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table users.")
         c_db.execute(
-            'ALTER TABLE users ADD COLUMN deleted_user INTEGER DEFAULT 0'
+            "ALTER TABLE users ADD COLUMN deleted_user INTEGER DEFAULT 0"
         )
 
     # Upgrade users table from earlier versions
     try:
-        c_db.execute('SELECT allow_guest FROM users')
+        c_db.execute("SELECT allow_guest FROM users")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table users.")
         c_db.execute(
-            'ALTER TABLE users ADD COLUMN allow_guest INTEGER DEFAULT 0'
+            "ALTER TABLE users ADD COLUMN allow_guest INTEGER DEFAULT 0"
         )
         c_db.execute(
-            'ALTER TABLE users ADD COLUMN user_token TEXT'
+            "ALTER TABLE users ADD COLUMN user_token TEXT"
         )
         c_db.execute(
-            'ALTER TABLE users ADD COLUMN server_token TEXT'
+            "ALTER TABLE users ADD COLUMN server_token TEXT"
         )
 
     # Upgrade users table from earlier versions
     try:
-        c_db.execute('SELECT shared_libraries FROM users')
+        c_db.execute("SELECT shared_libraries FROM users")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table users.")
         c_db.execute(
-            'ALTER TABLE users ADD COLUMN shared_libraries TEXT'
+            "ALTER TABLE users ADD COLUMN shared_libraries TEXT"
         )
         c_db.execute(
-            'ALTER TABLE users ADD COLUMN filter_all TEXT'
+            "ALTER TABLE users ADD COLUMN filter_all TEXT"
         )
         c_db.execute(
-            'ALTER TABLE users ADD COLUMN filter_movies TEXT'
+            "ALTER TABLE users ADD COLUMN filter_movies TEXT"
         )
         c_db.execute(
-            'ALTER TABLE users ADD COLUMN filter_tv TEXT'
+            "ALTER TABLE users ADD COLUMN filter_tv TEXT"
         )
         c_db.execute(
-            'ALTER TABLE users ADD COLUMN filter_music TEXT'
+            "ALTER TABLE users ADD COLUMN filter_music TEXT"
         )
         c_db.execute(
-            'ALTER TABLE users ADD COLUMN filter_photos TEXT'
+            "ALTER TABLE users ADD COLUMN filter_photos TEXT"
         )
 
     # Upgrade users table from earlier versions
     try:
-        c_db.execute('SELECT is_admin FROM users')
+        c_db.execute("SELECT is_admin FROM users")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table users.")
         c_db.execute(
-            'ALTER TABLE users ADD COLUMN is_admin INTEGER DEFAULT 0'
+            "ALTER TABLE users ADD COLUMN is_admin INTEGER DEFAULT 0"
         )
 
     # Upgrade users table from earlier versions
     try:
-        c_db.execute('SELECT is_active FROM users')
+        c_db.execute("SELECT is_active FROM users")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table users.")
         c_db.execute(
-            'ALTER TABLE users ADD COLUMN is_active INTEGER DEFAULT 1'
+            "ALTER TABLE users ADD COLUMN is_active INTEGER DEFAULT 1"
         )
 
     # Upgrade users table from earlier versions
     try:
-        c_db.execute('SELECT title FROM users')
+        c_db.execute("SELECT title FROM users")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table users.")
         c_db.execute(
-            'ALTER TABLE users ADD COLUMN title TEXT'
+            "ALTER TABLE users ADD COLUMN title TEXT"
         )
 
     try:
-        result = c_db.execute('SELECT * FROM users WHERE friendly_name = username').fetchall()
+        result = c_db.execute("SELECT * FROM users WHERE friendly_name = username").fetchall()
         if result:
             logger.debug("Altering database. Resetting user friendly names equal to username.")
-            c_db.execute('UPDATE users SET friendly_name = NULL WHERE friendly_name = username')
+            c_db.execute("UPDATE users SET friendly_name = NULL WHERE friendly_name = username")
     except sqlite3.OperationalError:
        pass
 
     # Upgrade notify_log table from earlier versions
     try:
-        c_db.execute('SELECT poster_url FROM notify_log')
+        c_db.execute("SELECT poster_url FROM notify_log")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table notify_log.")
         c_db.execute(
-            'ALTER TABLE notify_log ADD COLUMN poster_url TEXT'
+            "ALTER TABLE notify_log ADD COLUMN poster_url TEXT"
         )
 
     # Upgrade notify_log table from earlier versions (populate table with data from notify_log)
     try:
-        c_db.execute('SELECT timestamp FROM notify_log')
+        c_db.execute("SELECT timestamp FROM notify_log")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table notify_log.")
         c_db.execute(
-            'CREATE TABLE IF NOT EXISTS notify_log_temp (id INTEGER PRIMARY KEY AUTOINCREMENT, timestamp INTEGER, '
-            'session_key INTEGER, rating_key INTEGER, parent_rating_key INTEGER, grandparent_rating_key INTEGER, '
-            'user_id INTEGER, user TEXT, agent_id INTEGER, agent_name TEXT, notify_action TEXT, '
-            'subject_text TEXT, body_text TEXT, script_args TEXT, poster_url TEXT)'
+            "CREATE TABLE IF NOT EXISTS notify_log_temp (id INTEGER PRIMARY KEY AUTOINCREMENT, timestamp INTEGER, "
+            "session_key INTEGER, rating_key INTEGER, parent_rating_key INTEGER, grandparent_rating_key INTEGER, "
+            "user_id INTEGER, user TEXT, agent_id INTEGER, agent_name TEXT, notify_action TEXT, "
+            "subject_text TEXT, body_text TEXT, script_args TEXT, poster_url TEXT)"
         )
         c_db.execute(
-            'INSERT INTO notify_log_temp (session_key, rating_key, user_id, user, agent_id, agent_name, '
-            'poster_url, timestamp, notify_action) '
-            'SELECT session_key, rating_key, user_id, user, agent_id, agent_name, poster_url, timestamp, '
-            'notify_action FROM notify_log_temp '
-            'UNION ALL SELECT session_key, rating_key, user_id, user, agent_id, agent_name, poster_url, '
-            'on_play, "play" FROM notify_log WHERE on_play '
-            'UNION ALL SELECT session_key, rating_key, user_id, user, agent_id, agent_name, poster_url, '
-            'on_stop, "stop" FROM notify_log WHERE on_stop '
-            'UNION ALL SELECT session_key, rating_key, user_id, user, agent_id, agent_name, poster_url, '
-            'on_watched, "watched" FROM notify_log WHERE on_watched '
-            'UNION ALL SELECT session_key, rating_key, user_id, user, agent_id, agent_name, poster_url, '
-            'on_pause, "pause" FROM notify_log WHERE on_pause '
-            'UNION ALL SELECT session_key, rating_key, user_id, user, agent_id, agent_name, poster_url, '
-            'on_resume, "resume" FROM notify_log WHERE on_resume '
-            'UNION ALL SELECT session_key, rating_key, user_id, user, agent_id, agent_name, poster_url, '
-            'on_buffer, "buffer" FROM notify_log WHERE on_buffer '
-            'UNION ALL SELECT session_key, rating_key, user_id, user, agent_id, agent_name, poster_url, '
-            'on_created, "created" FROM notify_log WHERE on_created '
-            'ORDER BY timestamp ')
+            "INSERT INTO notify_log_temp (session_key, rating_key, user_id, user, agent_id, agent_name, "
+            "poster_url, timestamp, notify_action) "
+            "SELECT session_key, rating_key, user_id, user, agent_id, agent_name, poster_url, timestamp, "
+            "notify_action FROM notify_log_temp "
+            "UNION ALL SELECT session_key, rating_key, user_id, user, agent_id, agent_name, poster_url, "
+            "on_play, 'play' FROM notify_log WHERE on_play "
+            "UNION ALL SELECT session_key, rating_key, user_id, user, agent_id, agent_name, poster_url, "
+            "on_stop, 'stop' FROM notify_log WHERE on_stop "
+            "UNION ALL SELECT session_key, rating_key, user_id, user, agent_id, agent_name, poster_url, "
+            "on_watched, 'watched' FROM notify_log WHERE on_watched "
+            "UNION ALL SELECT session_key, rating_key, user_id, user, agent_id, agent_name, poster_url, "
+            "on_pause, 'pause' FROM notify_log WHERE on_pause "
+            "UNION ALL SELECT session_key, rating_key, user_id, user, agent_id, agent_name, poster_url, "
+            "on_resume, 'resume' FROM notify_log WHERE on_resume "
+            "UNION ALL SELECT session_key, rating_key, user_id, user, agent_id, agent_name, poster_url, "
+            "on_buffer, 'buffer' FROM notify_log WHERE on_buffer "
+            "UNION ALL SELECT session_key, rating_key, user_id, user, agent_id, agent_name, poster_url, "
+            "on_created, 'created' FROM notify_log WHERE on_created "
+            "ORDER BY timestamp ")
         c_db.execute(
-            'DROP TABLE notify_log'
+            "DROP TABLE notify_log"
         )
         c_db.execute(
-            'ALTER TABLE notify_log_temp RENAME TO notify_log'
+            "ALTER TABLE notify_log_temp RENAME TO notify_log"
         )
 
     # Upgrade notify_log table from earlier versions
     try:
-        c_db.execute('SELECT notifier_id FROM notify_log')
+        c_db.execute("SELECT notifier_id FROM notify_log")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table notify_log.")
         c_db.execute(
-            'ALTER TABLE notify_log ADD COLUMN notifier_id INTEGER'
+            "ALTER TABLE notify_log ADD COLUMN notifier_id INTEGER"
         )
 
     # Upgrade notify_log table from earlier versions
     try:
-        c_db.execute('SELECT success FROM notify_log')
+        c_db.execute("SELECT success FROM notify_log")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table notify_log.")
         c_db.execute(
-            'ALTER TABLE notify_log ADD COLUMN success INTEGER DEFAULT 0'
+            "ALTER TABLE notify_log ADD COLUMN success INTEGER DEFAULT 0"
         )
         c_db.execute(
-            'UPDATE notify_log SET success = 1'
+            "UPDATE notify_log SET success = 1"
         )
 
     # Upgrade notify_log table from earlier versions
     try:
-        c_db.execute('SELECT tag FROM notify_log')
+        c_db.execute("SELECT tag FROM notify_log")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table notify_log.")
         c_db.execute(
-            'ALTER TABLE notify_log ADD COLUMN tag TEXT'
+            "ALTER TABLE notify_log ADD COLUMN tag TEXT"
         )
 
     # Upgrade newsletter_log table from earlier versions
     try:
-        c_db.execute('SELECT start_time FROM newsletter_log')
+        c_db.execute("SELECT start_time FROM newsletter_log")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table newsletter_log.")
         c_db.execute(
-            'ALTER TABLE newsletter_log ADD COLUMN start_time INTEGER'
+            "ALTER TABLE newsletter_log ADD COLUMN start_time INTEGER"
         )
         c_db.execute(
-            'ALTER TABLE newsletter_log ADD COLUMN end_time INTEGER'
+            "ALTER TABLE newsletter_log ADD COLUMN end_time INTEGER"
         )
 
     # Upgrade newsletter_log table from earlier versions
     try:
-        c_db.execute('SELECT filename FROM newsletter_log')
+        c_db.execute("SELECT filename FROM newsletter_log")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table newsletter_log.")
         c_db.execute(
-            'ALTER TABLE newsletter_log ADD COLUMN filename TEXT'
+            "ALTER TABLE newsletter_log ADD COLUMN filename TEXT"
         )
 
     # Upgrade newsletter_log table from earlier versions
     try:
-        c_db.execute('SELECT email_msg_id FROM newsletter_log')
+        c_db.execute("SELECT email_msg_id FROM newsletter_log")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table newsletter_log.")
         c_db.execute(
-            'ALTER TABLE newsletter_log ADD COLUMN email_msg_id TEXT'
+            "ALTER TABLE newsletter_log ADD COLUMN email_msg_id TEXT"
         )
 
     # Upgrade newsletters table from earlier versions
     try:
-        c_db.execute('SELECT id_name FROM newsletters')
+        c_db.execute("SELECT id_name FROM newsletters")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table newsletters.")
         c_db.execute(
-            'ALTER TABLE newsletters ADD COLUMN id_name TEXT NOT NULL'
+            "ALTER TABLE newsletters ADD COLUMN id_name TEXT NOT NULL"
         )
 
     # Upgrade newsletters table from earlier versions
     try:
-        result = c_db.execute('SELECT SQL FROM sqlite_master WHERE type="table" AND name="newsletters"').fetchone()
-        if 'TEXT NOT NULL DEFAULT "0 0 * * 0"' in result[0]:
+        result = c_db.execute("SELECT SQL FROM sqlite_master WHERE type='table' AND name='newsletters'").fetchone()
+        if "TEXT NOT NULL DEFAULT \"0 0 * * 0\"" in result[0]:
             logger.debug("Altering database. Updating default cron value in newsletters table.")
             c_db.execute(
-                'CREATE TABLE newsletters_temp (id INTEGER PRIMARY KEY AUTOINCREMENT, '
-                'agent_id INTEGER, agent_name TEXT, agent_label TEXT, id_name TEXT NOT NULL, '
-                'friendly_name TEXT, newsletter_config TEXT, email_config TEXT, '
-                'subject TEXT, body TEXT, message TEXT, '
-                'cron TEXT NOT NULL DEFAULT \'0 0 * * 0\', active INTEGER DEFAULT 0)'
+                "CREATE TABLE newsletters_temp (id INTEGER PRIMARY KEY AUTOINCREMENT, "
+                "agent_id INTEGER, agent_name TEXT, agent_label TEXT, id_name TEXT NOT NULL, "
+                "friendly_name TEXT, newsletter_config TEXT, email_config TEXT, "
+                "subject TEXT, body TEXT, message TEXT, "
+                "cron TEXT NOT NULL DEFAULT '0 0 * * 0', active INTEGER DEFAULT 0)"
             )
             c_db.execute(
-                'INSERT INTO newsletters_temp (id, agent_id, agent_name, agent_label, id_name, '
-                'friendly_name, newsletter_config, email_config, subject, body, message, cron, active) '
-                'SELECT id, agent_id, agent_name, agent_label, id_name, '
-                'friendly_name, newsletter_config, email_config, subject, body, message, cron, active '
-                'FROM newsletters'
+                "INSERT INTO newsletters_temp (id, agent_id, agent_name, agent_label, id_name, "
+                "friendly_name, newsletter_config, email_config, subject, body, message, cron, active) "
+                "SELECT id, agent_id, agent_name, agent_label, id_name, "
+                "friendly_name, newsletter_config, email_config, subject, body, message, cron, active "
+                "FROM newsletters"
             )
             c_db.execute(
-                'DROP TABLE newsletters'
+                "DROP TABLE newsletters"
             )
             c_db.execute(
-                'ALTER TABLE newsletters_temp RENAME TO newsletters'
+                "ALTER TABLE newsletters_temp RENAME TO newsletters"
             )
     except sqlite3.OperationalError:
         logger.warn("Unable to update default cron value in newsletters table.")
         try:
             c_db.execute(
-                'DROP TABLE newsletters_temp'
+                "DROP TABLE newsletters_temp"
             )
         except:
             pass
 
     # Upgrade library_sections table from earlier versions (remove UNIQUE constraint on section_id)
     try:
-        result = c_db.execute('SELECT SQL FROM sqlite_master WHERE type="table" AND name="library_sections"').fetchone()
-        if 'section_id INTEGER UNIQUE' in result[0]:
+        result = c_db.execute("SELECT SQL FROM sqlite_master WHERE type='table' AND name='library_sections'").fetchone()
+        if "section_id INTEGER UNIQUE" in result[0]:
             logger.debug("Altering database. Removing unique constraint on section_id from library_sections table.")
             c_db.execute(
-                'CREATE TABLE library_sections_temp (id INTEGER PRIMARY KEY AUTOINCREMENT, '
-                'server_id TEXT, section_id INTEGER, section_name TEXT, section_type TEXT, '
-                'thumb TEXT, custom_thumb_url TEXT, art TEXT, count INTEGER, parent_count INTEGER, child_count INTEGER, '
-                'do_notify INTEGER DEFAULT 1, do_notify_created INTEGER DEFAULT 1, keep_history INTEGER DEFAULT 1, '
-                'deleted_section INTEGER DEFAULT 0, UNIQUE(server_id, section_id))'
+                "CREATE TABLE library_sections_temp (id INTEGER PRIMARY KEY AUTOINCREMENT, "
+                "server_id TEXT, section_id INTEGER, section_name TEXT, section_type TEXT, "
+                "thumb TEXT, custom_thumb_url TEXT, art TEXT, count INTEGER, parent_count INTEGER, child_count INTEGER, "
+                "do_notify INTEGER DEFAULT 1, do_notify_created INTEGER DEFAULT 1, keep_history INTEGER DEFAULT 1, "
+                "deleted_section INTEGER DEFAULT 0, UNIQUE(server_id, section_id))"
             )
             c_db.execute(
-                'INSERT INTO library_sections_temp (id, server_id, section_id, section_name, section_type, '
-                'thumb, custom_thumb_url, art, count, parent_count, child_count, do_notify, do_notify_created, '
-                'keep_history, deleted_section) '
-                'SELECT id, server_id, section_id, section_name, section_type, '
-                'thumb, custom_thumb_url, art, count, parent_count, child_count, do_notify, do_notify_created, '
-                'keep_history, deleted_section '
-                'FROM library_sections'
+                "INSERT INTO library_sections_temp (id, server_id, section_id, section_name, section_type, "
+                "thumb, custom_thumb_url, art, count, parent_count, child_count, do_notify, do_notify_created, "
+                "keep_history, deleted_section) "
+                "SELECT id, server_id, section_id, section_name, section_type, "
+                "thumb, custom_thumb_url, art, count, parent_count, child_count, do_notify, do_notify_created, "
+                "keep_history, deleted_section "
+                "FROM library_sections"
             )
             c_db.execute(
-                'DROP TABLE library_sections'
+                "DROP TABLE library_sections"
             )
             c_db.execute(
-                'ALTER TABLE library_sections_temp RENAME TO library_sections'
+                "ALTER TABLE library_sections_temp RENAME TO library_sections"
             )
     except sqlite3.OperationalError:
         logger.warn("Unable to remove section_id unique constraint from library_sections.")
         try:
             c_db.execute(
-                'DROP TABLE library_sections_temp'
+                "DROP TABLE library_sections_temp"
             )
         except:
             pass
 
     # Upgrade library_sections table from earlier versions (remove duplicated libraries)
     try:
-        result = c_db.execute('SELECT * FROM library_sections WHERE server_id = ""').fetchall()
+        result = c_db.execute("SELECT * FROM library_sections WHERE server_id = ''").fetchall()
         if len(result) > 0:
             logger.debug("Altering database. Removing duplicate libraries from library_sections table.")
             c_db.execute(
-                'DELETE FROM library_sections WHERE server_id = ""'
+                "DELETE FROM library_sections WHERE server_id = ''"
             )
     except sqlite3.OperationalError:
         logger.warn("Unable to remove duplicate libraries from library_sections table.")
 
     # Upgrade library_sections table from earlier versions
     try:
-        c_db.execute('SELECT agent FROM library_sections')
+        c_db.execute("SELECT agent FROM library_sections")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table library_sections.")
         c_db.execute(
-            'ALTER TABLE library_sections ADD COLUMN agent TEXT'
+            "ALTER TABLE library_sections ADD COLUMN agent TEXT"
         )
 
     # Upgrade library_sections table from earlier versions
     try:
-        c_db.execute('SELECT custom_art_url FROM library_sections')
+        c_db.execute("SELECT custom_art_url FROM library_sections")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table library_sections.")
         c_db.execute(
-            'ALTER TABLE library_sections ADD COLUMN custom_art_url TEXT'
+            "ALTER TABLE library_sections ADD COLUMN custom_art_url TEXT"
         )
 
     # Upgrade library_sections table from earlier versions
     try:
-        c_db.execute('SELECT is_active FROM library_sections')
+        c_db.execute("SELECT is_active FROM library_sections")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table library_sections.")
         c_db.execute(
-            'ALTER TABLE library_sections ADD COLUMN is_active INTEGER DEFAULT 1'
+            "ALTER TABLE library_sections ADD COLUMN is_active INTEGER DEFAULT 1"
         )
 
     # Upgrade library_sections table from earlier versions
     try:
-        result = c_db.execute('SELECT thumb, art FROM library_sections WHERE section_id = ?',
+        result = c_db.execute("SELECT thumb, art FROM library_sections WHERE section_id = ?",
                               [common.LIVE_TV_SECTION_ID]).fetchone()
         if result and (not result[0] or not result[1]):
             logger.debug("Altering database. Updating database table library_sections.")
-            c_db.execute('UPDATE library_sections SET thumb = ?, art =? WHERE section_id = ?',
+            c_db.execute("UPDATE library_sections SET thumb = ?, art =? WHERE section_id = ?",
                          [common.DEFAULT_LIVE_TV_THUMB,
                           common.DEFAULT_LIVE_TV_ART_FULL,
                           common.LIVE_TV_SECTION_ID])
@@ -2266,49 +2269,49 @@ def dbcheck():
 
     # Upgrade users table from earlier versions (remove UNIQUE constraint on username)
     try:
-        result = c_db.execute('SELECT SQL FROM sqlite_master WHERE type="table" AND name="users"').fetchone()
-        if 'username TEXT NOT NULL UNIQUE' in result[0]:
+        result = c_db.execute("SELECT SQL FROM sqlite_master WHERE type='table' AND name='users'").fetchone()
+        if "username TEXT NOT NULL UNIQUE" in result[0]:
             logger.debug("Altering database. Removing unique constraint on username from users table.")
             c_db.execute(
-                'CREATE TABLE users_temp (id INTEGER PRIMARY KEY AUTOINCREMENT, '
-                'user_id INTEGER DEFAULT NULL UNIQUE, username TEXT NOT NULL, friendly_name TEXT, '
-                'thumb TEXT, custom_avatar_url TEXT, email TEXT, is_home_user INTEGER DEFAULT NULL, '
-                'is_allow_sync INTEGER DEFAULT NULL, is_restricted INTEGER DEFAULT NULL, do_notify INTEGER DEFAULT 1, '
-                'keep_history INTEGER DEFAULT 1, deleted_user INTEGER DEFAULT 0)'
+                "CREATE TABLE users_temp (id INTEGER PRIMARY KEY AUTOINCREMENT, "
+                "user_id INTEGER DEFAULT NULL UNIQUE, username TEXT NOT NULL, friendly_name TEXT, "
+                "thumb TEXT, custom_avatar_url TEXT, email TEXT, is_home_user INTEGER DEFAULT NULL, "
+                "is_allow_sync INTEGER DEFAULT NULL, is_restricted INTEGER DEFAULT NULL, do_notify INTEGER DEFAULT 1, "
+                "keep_history INTEGER DEFAULT 1, deleted_user INTEGER DEFAULT 0)"
             )
             c_db.execute(
-                'INSERT INTO users_temp (id, user_id, username, friendly_name, thumb, custom_avatar_url, '
-                'email, is_home_user, is_allow_sync, is_restricted, do_notify, keep_history, deleted_user) '
-                'SELECT id, user_id, username, friendly_name, thumb, custom_avatar_url, '
-                'email, is_home_user, is_allow_sync, is_restricted, do_notify, keep_history, deleted_user '
-                'FROM users'
+                "INSERT INTO users_temp (id, user_id, username, friendly_name, thumb, custom_avatar_url, "
+                "email, is_home_user, is_allow_sync, is_restricted, do_notify, keep_history, deleted_user) "
+                "SELECT id, user_id, username, friendly_name, thumb, custom_avatar_url, "
+                "email, is_home_user, is_allow_sync, is_restricted, do_notify, keep_history, deleted_user "
+                "FROM users"
             )
             c_db.execute(
-                'DROP TABLE users'
+                "DROP TABLE users"
             )
             c_db.execute(
-                'ALTER TABLE users_temp RENAME TO users'
+                "ALTER TABLE users_temp RENAME TO users"
             )
     except sqlite3.OperationalError:
         logger.warn("Unable to remove username unique constraint from users.")
         try:
             c_db.execute(
-                'DROP TABLE users_temp'
+                "DROP TABLE users_temp"
             )
         except:
             pass
 
     # Upgrade mobile_devices table from earlier versions
     try:
-        result = c_db.execute('SELECT SQL FROM sqlite_master WHERE type="table" AND name="mobile_devices"').fetchone()
-        if 'device_token TEXT NOT NULL UNIQUE' in result[0]:
+        result = c_db.execute("SELECT SQL FROM sqlite_master WHERE type='table' AND name='mobile_devices'").fetchone()
+        if "device_token TEXT NOT NULL UNIQUE" in result[0]:
             logger.debug("Altering database. Dropping and recreating mobile_devices table.")
             c_db.execute(
-                'DROP TABLE mobile_devices'
+                "DROP TABLE mobile_devices"
             )
             c_db.execute(
-                'CREATE TABLE IF NOT EXISTS mobile_devices (id INTEGER PRIMARY KEY AUTOINCREMENT, '
-                'device_id TEXT NOT NULL UNIQUE, device_token TEXT, device_name TEXT, friendly_name TEXT)'
+                "CREATE TABLE IF NOT EXISTS mobile_devices (id INTEGER PRIMARY KEY AUTOINCREMENT, "
+                "device_id TEXT NOT NULL UNIQUE, device_token TEXT, device_name TEXT, friendly_name TEXT)"
             )
     except sqlite3.OperationalError:
         logger.warn("Failed to recreate mobile_devices table.")
@@ -2316,408 +2319,408 @@ def dbcheck():
 
     # Upgrade mobile_devices table from earlier versions
     try:
-        c_db.execute('SELECT last_seen FROM mobile_devices')
+        c_db.execute("SELECT last_seen FROM mobile_devices")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table mobile_devices.")
         c_db.execute(
-            'ALTER TABLE mobile_devices ADD COLUMN last_seen INTEGER'
+            "ALTER TABLE mobile_devices ADD COLUMN last_seen INTEGER"
         )
 
     # Upgrade mobile_devices table from earlier versions
     try:
-        c_db.execute('SELECT official FROM mobile_devices')
+        c_db.execute("SELECT official FROM mobile_devices")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table mobile_devices.")
         c_db.execute(
-            'ALTER TABLE mobile_devices ADD COLUMN official INTEGER DEFAULT 0'
+            "ALTER TABLE mobile_devices ADD COLUMN official INTEGER DEFAULT 0"
         )
         # Update official mobile device flag
-        for device_id, in c_db.execute('SELECT device_id FROM mobile_devices').fetchall():
-            c_db.execute('UPDATE mobile_devices SET official = ? WHERE device_id = ?',
+        for device_id, in c_db.execute("SELECT device_id FROM mobile_devices").fetchall():
+            c_db.execute("UPDATE mobile_devices SET official = ? WHERE device_id = ?",
                          [mobile_app.validate_onesignal_id(device_id), device_id])
 
     # Upgrade mobile_devices table from earlier versions
     try:
-        c_db.execute('SELECT onesignal_id FROM mobile_devices')
+        c_db.execute("SELECT onesignal_id FROM mobile_devices")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table mobile_devices.")
         c_db.execute(
-            'ALTER TABLE mobile_devices ADD COLUMN onesignal_id TEXT'
+            "ALTER TABLE mobile_devices ADD COLUMN onesignal_id TEXT"
         )
 
     # Upgrade mobile_devices table from earlier versions
     try:
-        c_db.execute('SELECT platform FROM mobile_devices')
+        c_db.execute("SELECT platform FROM mobile_devices")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table mobile_devices.")
         c_db.execute(
-            'ALTER TABLE mobile_devices ADD COLUMN platform TEXT'
+            "ALTER TABLE mobile_devices ADD COLUMN platform TEXT"
         )
         c_db.execute(
-            'ALTER TABLE mobile_devices ADD COLUMN version TEXT'
+            "ALTER TABLE mobile_devices ADD COLUMN version TEXT"
         )
         # Update mobile device platforms
         for device_id, in c_db.execute(
-                'SELECT device_id FROM mobile_devices WHERE official > 0').fetchall():
-            c_db.execute('UPDATE mobile_devices SET platform = ? WHERE device_id = ?',
-                         ['android', device_id])
+                "SELECT device_id FROM mobile_devices WHERE official > 0").fetchall():
+            c_db.execute("UPDATE mobile_devices SET platform = ? WHERE device_id = ?",
+                         ["android", device_id])
 
     # Upgrade notifiers table from earlier versions
     try:
-        c_db.execute('SELECT custom_conditions FROM notifiers')
+        c_db.execute("SELECT custom_conditions FROM notifiers")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table notifiers.")
         c_db.execute(
-            'ALTER TABLE notifiers ADD COLUMN custom_conditions TEXT'
+            "ALTER TABLE notifiers ADD COLUMN custom_conditions TEXT"
         )
         c_db.execute(
-            'ALTER TABLE notifiers ADD COLUMN custom_conditions_logic TEXT'
+            "ALTER TABLE notifiers ADD COLUMN custom_conditions_logic TEXT"
         )
 
     # Upgrade notifiers table from earlier versions
     try:
-        c_db.execute('SELECT on_change FROM notifiers')
+        c_db.execute("SELECT on_change FROM notifiers")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table notifiers.")
         c_db.execute(
-            'ALTER TABLE notifiers ADD COLUMN on_change INTEGER DEFAULT 0'
+            "ALTER TABLE notifiers ADD COLUMN on_change INTEGER DEFAULT 0"
         )
         c_db.execute(
-            'ALTER TABLE notifiers ADD COLUMN on_change_subject TEXT'
+            "ALTER TABLE notifiers ADD COLUMN on_change_subject TEXT"
         )
         c_db.execute(
-            'ALTER TABLE notifiers ADD COLUMN on_change_body TEXT'
+            "ALTER TABLE notifiers ADD COLUMN on_change_body TEXT"
         )
 
     # Upgrade notifiers table from earlier versions
     try:
-        c_db.execute('SELECT on_plexpydbcorrupt FROM notifiers')
+        c_db.execute("SELECT on_plexpydbcorrupt FROM notifiers")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table notifiers.")
         c_db.execute(
-            'ALTER TABLE notifiers ADD COLUMN on_plexpydbcorrupt INTEGER DEFAULT 0'
+            "ALTER TABLE notifiers ADD COLUMN on_plexpydbcorrupt INTEGER DEFAULT 0"
         )
         c_db.execute(
-            'ALTER TABLE notifiers ADD COLUMN on_plexpydbcorrupt_subject TEXT'
+            "ALTER TABLE notifiers ADD COLUMN on_plexpydbcorrupt_subject TEXT"
         )
         c_db.execute(
-            'ALTER TABLE notifiers ADD COLUMN on_plexpydbcorrupt_body TEXT'
+            "ALTER TABLE notifiers ADD COLUMN on_plexpydbcorrupt_body TEXT"
         )
 
     # Upgrade notifiers table from earlier versions
     try:
-        c_db.execute('SELECT on_error FROM notifiers')
+        c_db.execute("SELECT on_error FROM notifiers")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table notifiers.")
         c_db.execute(
-            'ALTER TABLE notifiers ADD COLUMN on_error INTEGER DEFAULT 0'
+            "ALTER TABLE notifiers ADD COLUMN on_error INTEGER DEFAULT 0"
         )
         c_db.execute(
-            'ALTER TABLE notifiers ADD COLUMN on_error_subject TEXT'
+            "ALTER TABLE notifiers ADD COLUMN on_error_subject TEXT"
         )
         c_db.execute(
-            'ALTER TABLE notifiers ADD COLUMN on_error_body TEXT'
+            "ALTER TABLE notifiers ADD COLUMN on_error_body TEXT"
         )
 
     # Upgrade notifiers table from earlier versions
     try:
-        c_db.execute('SELECT on_intro FROM notifiers')
+        c_db.execute("SELECT on_intro FROM notifiers")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table notifiers.")
         c_db.execute(
-            'ALTER TABLE notifiers ADD COLUMN on_intro INTEGER DEFAULT 0'
+            "ALTER TABLE notifiers ADD COLUMN on_intro INTEGER DEFAULT 0"
         )
         c_db.execute(
-            'ALTER TABLE notifiers ADD COLUMN on_intro_subject TEXT'
+            "ALTER TABLE notifiers ADD COLUMN on_intro_subject TEXT"
         )
         c_db.execute(
-            'ALTER TABLE notifiers ADD COLUMN on_intro_body TEXT'
+            "ALTER TABLE notifiers ADD COLUMN on_intro_body TEXT"
         )
         c_db.execute(
-            'ALTER TABLE notifiers ADD COLUMN on_credits INTEGER DEFAULT 0'
+            "ALTER TABLE notifiers ADD COLUMN on_credits INTEGER DEFAULT 0"
         )
         c_db.execute(
-            'ALTER TABLE notifiers ADD COLUMN on_credits_subject TEXT'
+            "ALTER TABLE notifiers ADD COLUMN on_credits_subject TEXT"
         )
         c_db.execute(
-            'ALTER TABLE notifiers ADD COLUMN on_credits_body TEXT'
+            "ALTER TABLE notifiers ADD COLUMN on_credits_body TEXT"
         )
 
     # Upgrade notifiers table from earlier versions
     try:
-        c_db.execute('SELECT on_commercial FROM notifiers')
+        c_db.execute("SELECT on_commercial FROM notifiers")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table notifiers.")
         c_db.execute(
-            'ALTER TABLE notifiers ADD COLUMN on_commercial INTEGER DEFAULT 0'
+            "ALTER TABLE notifiers ADD COLUMN on_commercial INTEGER DEFAULT 0"
         )
         c_db.execute(
-            'ALTER TABLE notifiers ADD COLUMN on_commercial_subject TEXT'
+            "ALTER TABLE notifiers ADD COLUMN on_commercial_subject TEXT"
         )
         c_db.execute(
-            'ALTER TABLE notifiers ADD COLUMN on_commercial_body TEXT'
+            "ALTER TABLE notifiers ADD COLUMN on_commercial_body TEXT"
         )
 
     # Upgrade tvmaze_lookup table from earlier versions
     try:
-        c_db.execute('SELECT rating_key FROM tvmaze_lookup')
+        c_db.execute("SELECT rating_key FROM tvmaze_lookup")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table tvmaze_lookup.")
         c_db.execute(
-            'ALTER TABLE tvmaze_lookup ADD COLUMN rating_key INTEGER'
+            "ALTER TABLE tvmaze_lookup ADD COLUMN rating_key INTEGER"
         )
         c_db.execute(
-            'DROP INDEX IF EXISTS idx_tvmaze_lookup_thetvdb_id'
+            "DROP INDEX IF EXISTS idx_tvmaze_lookup_thetvdb_id"
         )
         c_db.execute(
-            'DROP INDEX IF EXISTS idx_tvmaze_lookup_imdb_id'
+            "DROP INDEX IF EXISTS idx_tvmaze_lookup_imdb_id"
         )
 
     # Upgrade themoviedb_lookup table from earlier versions
     try:
-        c_db.execute('SELECT rating_key FROM themoviedb_lookup')
+        c_db.execute("SELECT rating_key FROM themoviedb_lookup")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table themoviedb_lookup.")
         c_db.execute(
-            'ALTER TABLE themoviedb_lookup ADD COLUMN rating_key INTEGER'
+            "ALTER TABLE themoviedb_lookup ADD COLUMN rating_key INTEGER"
         )
         c_db.execute(
-            'DROP INDEX IF EXISTS idx_themoviedb_lookup_thetvdb_id'
+            "DROP INDEX IF EXISTS idx_themoviedb_lookup_thetvdb_id"
         )
         c_db.execute(
-            'DROP INDEX IF EXISTS idx_themoviedb_lookup_imdb_id'
+            "DROP INDEX IF EXISTS idx_themoviedb_lookup_imdb_id"
         )
 
     # Upgrade user_login table from earlier versions
     try:
-        c_db.execute('SELECT success FROM user_login')
+        c_db.execute("SELECT success FROM user_login")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table user_login.")
         c_db.execute(
-            'ALTER TABLE user_login ADD COLUMN success INTEGER DEFAULT 1'
+            "ALTER TABLE user_login ADD COLUMN success INTEGER DEFAULT 1"
         )
 
     # Upgrade user_login table from earlier versions
     try:
-        c_db.execute('SELECT expiry FROM user_login')
+        c_db.execute("SELECT expiry FROM user_login")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table user_login.")
         c_db.execute(
-            'ALTER TABLE user_login ADD COLUMN expiry TEXT'
+            "ALTER TABLE user_login ADD COLUMN expiry TEXT"
         )
         c_db.execute(
-            'ALTER TABLE user_login ADD COLUMN jwt_token TEXT'
+            "ALTER TABLE user_login ADD COLUMN jwt_token TEXT"
         )
 
     # Rename notifiers in the database
-    result = c_db.execute('SELECT agent_label FROM notifiers '
-                          'WHERE agent_label = "XBMC" '
-                          'OR agent_label = "OSX Notify" '
-                          'OR agent_name = "androidapp"').fetchone()
+    result = c_db.execute("SELECT agent_label FROM notifiers "
+                          "WHERE agent_label = 'XBMC' "
+                          "OR agent_label = 'OSX Notify' "
+                          "OR agent_name = 'androidapp'").fetchone()
     if result:
         logger.debug("Altering database. Renaming notifiers.")
         c_db.execute(
-            'UPDATE notifiers SET agent_label = "Kodi" WHERE agent_label = "XBMC"'
+            "UPDATE notifiers SET agent_label = 'Kodi' WHERE agent_label = 'XBMC'"
         )
         c_db.execute(
-            'UPDATE notifiers SET agent_label = "macOS Notification Center" WHERE agent_label = "OSX Notify"'
+            "UPDATE notifiers SET agent_label = 'macOS Notification Center' WHERE agent_label = 'OSX Notify'"
         )
         c_db.execute(
-            'UPDATE notifiers SET agent_name = "remoteapp", agent_label = "Tautulli Remote App" '
-            'WHERE agent_name = "androidapp"'
+            "UPDATE notifiers SET agent_name = 'remoteapp', agent_label = 'Tautulli Remote App' "
+            "WHERE agent_name = 'androidapp'"
         )
 
     # Upgrade exports table from earlier versions
     try:
-        c_db.execute('SELECT thumb_level FROM exports')
+        c_db.execute("SELECT thumb_level FROM exports")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table exports.")
         c_db.execute(
-            'ALTER TABLE exports ADD COLUMN thumb_level INTEGER DEFAULT 0'
+            "ALTER TABLE exports ADD COLUMN thumb_level INTEGER DEFAULT 0"
         )
         c_db.execute(
-            'UPDATE exports SET thumb_level = 9 WHERE include_thumb = 1'
+            "UPDATE exports SET thumb_level = 9 WHERE include_thumb = 1"
         )
         c_db.execute(
-            'ALTER TABLE exports ADD COLUMN art_level INTEGER DEFAULT 0'
+            "ALTER TABLE exports ADD COLUMN art_level INTEGER DEFAULT 0"
         )
         c_db.execute(
-            'UPDATE exports SET art_level = 9 WHERE include_art = 1'
+            "UPDATE exports SET art_level = 9 WHERE include_art = 1"
         )
 
     # Upgrade exports table from earlier versions
     try:
-        c_db.execute('SELECT title FROM exports')
+        c_db.execute("SELECT title FROM exports")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table exports.")
         c_db.execute(
-            'ALTER TABLE exports ADD COLUMN title TEXT'
+            "ALTER TABLE exports ADD COLUMN title TEXT"
         )
         c_db.execute(
-            'ALTER TABLE exports ADD COLUMN individual_files INTEGER DEFAULT 0'
+            "ALTER TABLE exports ADD COLUMN individual_files INTEGER DEFAULT 0"
         )
 
     # Upgrade exports table from earlier versions
     try:
-        c_db.execute('SELECT total_items FROM exports')
+        c_db.execute("SELECT total_items FROM exports")
     except sqlite3.OperationalError:
         logger.debug("Altering database. Updating database table exports.")
         c_db.execute(
-            'ALTER TABLE exports ADD COLUMN exported_items INTEGER DEFAULT 0'
+            "ALTER TABLE exports ADD COLUMN exported_items INTEGER DEFAULT 0"
         )
         c_db.execute(
-            'ALTER TABLE exports ADD COLUMN total_items INTEGER DEFAULT 0'
+            "ALTER TABLE exports ADD COLUMN total_items INTEGER DEFAULT 0"
         )
 
     # Fix unique constraints
     try:
-        c_db.execute('DELETE FROM tvmaze_lookup '
-                     'WHERE id NOT IN (SELECT MIN(id) FROM tvmaze_lookup GROUP BY rating_key)')
+        c_db.execute("DELETE FROM tvmaze_lookup "
+                     "WHERE id NOT IN (SELECT MIN(id) FROM tvmaze_lookup GROUP BY rating_key)")
     except sqlite3.OperationalError:
         pass
 
     try:
-        c_db.execute('DELETE FROM themoviedb_lookup '
-                     'WHERE id NOT IN (SELECT MIN(id) FROM themoviedb_lookup GROUP BY rating_key)')
+        c_db.execute("DELETE FROM themoviedb_lookup "
+                     "WHERE id NOT IN (SELECT MIN(id) FROM themoviedb_lookup GROUP BY rating_key)")
     except sqlite3.OperationalError:
         pass
 
     try:
-        c_db.execute('DELETE FROM musicbrainz_lookup '
-                     'WHERE id NOT IN (SELECT MIN(id) FROM musicbrainz_lookup GROUP BY rating_key)')
+        c_db.execute("DELETE FROM musicbrainz_lookup "
+                     "WHERE id NOT IN (SELECT MIN(id) FROM musicbrainz_lookup GROUP BY rating_key)")
     except sqlite3.OperationalError:
         pass
 
     try:
-        c_db.execute('DELETE FROM image_hash_lookup '
-                     'WHERE id NOT IN (SELECT MIN(id) FROM image_hash_lookup GROUP BY img_hash)')
+        c_db.execute("DELETE FROM image_hash_lookup "
+                     "WHERE id NOT IN (SELECT MIN(id) FROM image_hash_lookup GROUP BY img_hash)")
     except sqlite3.OperationalError:
         pass
 
     try:
-        c_db.execute('DELETE FROM cloudinary_lookup '
-                     'WHERE id NOT IN (SELECT MIN(id) FROM cloudinary_lookup GROUP BY img_hash)')
+        c_db.execute("DELETE FROM cloudinary_lookup "
+                     "WHERE id NOT IN (SELECT MIN(id) FROM cloudinary_lookup GROUP BY img_hash)")
     except sqlite3.OperationalError:
         pass
 
     try:
-        c_db.execute('DELETE FROM imgur_lookup '
-                     'WHERE id NOT IN (SELECT MIN(id) FROM imgur_lookup GROUP BY img_hash)')
+        c_db.execute("DELETE FROM imgur_lookup "
+                     "WHERE id NOT IN (SELECT MIN(id) FROM imgur_lookup GROUP BY img_hash)")
     except sqlite3.OperationalError:
         pass
 
     # Add "Local" user to database as default unauthenticated user.
-    result = c_db.execute('SELECT id FROM users WHERE username = "Local"')
+    result = c_db.execute("SELECT id FROM users WHERE username = 'Local'")
     if not result.fetchone():
         logger.debug("User 'Local' does not exist. Adding user.")
-        c_db.execute('INSERT INTO users (user_id, username) VALUES (0, "Local")')
+        c_db.execute("INSERT INTO users (user_id, username) VALUES (0, 'Local')")
 
     # Create session_history table indices
     c_db.execute(
-        'CREATE INDEX IF NOT EXISTS "idx_session_history_media_type" '
-        'ON "session_history" ("media_type")'
+        "CREATE INDEX IF NOT EXISTS idx_session_history_media_type "
+        "ON session_history (media_type)"
     )
     c_db.execute(
-        'CREATE INDEX IF NOT EXISTS "idx_session_history_media_type_stopped" '
-        'ON "session_history" ("media_type", "stopped" ASC)'
+        "CREATE INDEX IF NOT EXISTS idx_session_history_media_type_stopped "
+        "ON session_history (media_type, stopped ASC)"
     )
     c_db.execute(
-        'CREATE INDEX IF NOT EXISTS "idx_session_history_rating_key" '
-        'ON "session_history" ("rating_key")'
+        "CREATE INDEX IF NOT EXISTS idx_session_history_rating_key "
+        "ON session_history (rating_key)"
     )
     c_db.execute(
-        'CREATE INDEX IF NOT EXISTS "idx_session_history_parent_rating_key" '
-        'ON "session_history" ("parent_rating_key")'
+        "CREATE INDEX IF NOT EXISTS idx_session_history_parent_rating_key "
+        "ON session_history (parent_rating_key)"
     )
     c_db.execute(
-        'CREATE INDEX IF NOT EXISTS "idx_session_history_grandparent_rating_key" '
-        'ON "session_history" ("grandparent_rating_key")'
+        "CREATE INDEX IF NOT EXISTS idx_session_history_grandparent_rating_key "
+        "ON session_history (grandparent_rating_key)"
     )
     c_db.execute(
-        'CREATE INDEX IF NOT EXISTS "idx_session_history_user" '
-        'ON "session_history" ("user")'
+        "CREATE INDEX IF NOT EXISTS idx_session_history_user "
+        "ON session_history (user)"
     )
     c_db.execute(
-        'CREATE INDEX IF NOT EXISTS "idx_session_history_user_id" '
-        'ON "session_history" ("user_id")'
+        "CREATE INDEX IF NOT EXISTS idx_session_history_user_id "
+        "ON session_history (user_id)"
     )
     c_db.execute(
-        'CREATE INDEX IF NOT EXISTS "idx_session_history_user_id_stopped" '
-        'ON "session_history" ("user_id", "stopped" ASC)'
+        "CREATE INDEX IF NOT EXISTS idx_session_history_user_id_stopped "
+        "ON session_history (user_id, stopped ASC)"
     )
     c_db.execute(
-        'CREATE INDEX IF NOT EXISTS "idx_session_history_section_id" '
-        'ON "session_history" ("section_id")'
+        "CREATE INDEX IF NOT EXISTS idx_session_history_section_id "
+        "ON session_history (section_id)"
     )
     c_db.execute(
-        'CREATE INDEX IF NOT EXISTS "idx_session_history_section_id_stopped" '
-        'ON "session_history" ("section_id", "stopped" ASC)'
+        "CREATE INDEX IF NOT EXISTS idx_session_history_section_id_stopped "
+        "ON session_history (section_id, stopped ASC)"
     )
     c_db.execute(
-        'CREATE INDEX IF NOT EXISTS "idx_session_history_reference_id" '
-        'ON "session_history" ("reference_id" ASC)'
+        "CREATE INDEX IF NOT EXISTS idx_session_history_reference_id "
+        "ON session_history (reference_id ASC)"
     )
 
     # Create session_history_metadata table indices
     c_db.execute(
-        'CREATE INDEX IF NOT EXISTS "idx_session_history_metadata_rating_key" '
-        'ON "session_history_metadata" ("rating_key")'
+        "CREATE INDEX IF NOT EXISTS idx_session_history_metadata_rating_key "
+        "ON session_history_metadata (rating_key)"
     )
     c_db.execute(
-        'CREATE INDEX IF NOT EXISTS "idx_session_history_metadata_guid" '
-        'ON "session_history_metadata" ("guid")'
+        "CREATE INDEX IF NOT EXISTS idx_session_history_metadata_guid "
+        "ON session_history_metadata (guid)"
     )
     c_db.execute(
-        'CREATE INDEX IF NOT EXISTS "idx_session_history_metadata_live" '
-        'ON "session_history_metadata" ("live")'
+        "CREATE INDEX IF NOT EXISTS idx_session_history_metadata_live "
+        "ON session_history_metadata (live)"
     )
 
     # Create session_history_media_info table indices
     c_db.execute(
-        'CREATE INDEX IF NOT EXISTS "idx_session_history_media_info_transcode_decision" '
-        'ON "session_history_media_info" ("transcode_decision")'
+        "CREATE INDEX IF NOT EXISTS idx_session_history_media_info_transcode_decision "
+        "ON session_history_media_info (transcode_decision)"
     )
 
     # Create lookup table indices
     c_db.execute(
-        'CREATE UNIQUE INDEX IF NOT EXISTS "idx_tvmaze_lookup" '
-        'ON "tvmaze_lookup" ("rating_key")'
+        "CREATE UNIQUE INDEX IF NOT EXISTS idx_tvmaze_lookup "
+        "ON tvmaze_lookup (rating_key)"
     )
     c_db.execute(
-        'CREATE UNIQUE INDEX IF NOT EXISTS "idx_themoviedb_lookup" '
-        'ON "themoviedb_lookup" ("rating_key")'
+        "CREATE UNIQUE INDEX IF NOT EXISTS idx_themoviedb_lookup "
+        "ON themoviedb_lookup (rating_key)"
     )
     c_db.execute(
-        'CREATE UNIQUE INDEX IF NOT EXISTS "idx_musicbrainz_lookup" '
-        'ON "musicbrainz_lookup" ("rating_key")'
+        "CREATE UNIQUE INDEX IF NOT EXISTS idx_musicbrainz_lookup "
+        "ON musicbrainz_lookup (rating_key)"
     )
     c_db.execute(
-        'CREATE UNIQUE INDEX IF NOT EXISTS "idx_image_hash_lookup" '
-        'ON "image_hash_lookup" ("img_hash")'
+        "CREATE UNIQUE INDEX IF NOT EXISTS idx_image_hash_lookup "
+        "ON image_hash_lookup (img_hash)"
     )
     c_db.execute(
-        'CREATE UNIQUE INDEX IF NOT EXISTS "idx_cloudinary_lookup" '
-        'ON "cloudinary_lookup" ("img_hash")'
+        "CREATE UNIQUE INDEX IF NOT EXISTS idx_cloudinary_lookup "
+        "ON cloudinary_lookup (img_hash)"
     )
     c_db.execute(
-        'CREATE UNIQUE INDEX IF NOT EXISTS "idx_imgur_lookup" '
-        'ON "imgur_lookup" ("img_hash")'
+        "CREATE UNIQUE INDEX IF NOT EXISTS idx_imgur_lookup "
+        "ON imgur_lookup (img_hash)"
     )
     c_db.execute(
-        'CREATE UNIQUE INDEX IF NOT EXISTS "idx_sessions_continued" '
-        'ON "sessions_continued" ("user_id", "machine_id", "media_type")'
+        "CREATE UNIQUE INDEX IF NOT EXISTS idx_sessions_continued "
+        "ON sessions_continued (user_id, machine_id, media_type)"
     )
 
     # Set database version
-    result = c_db.execute('SELECT value FROM version_info WHERE key = "version"').fetchone()
+    result = c_db.execute("SELECT value FROM version_info WHERE key = 'version'").fetchone()
     if not result:
         c_db.execute(
-            'INSERT OR REPLACE INTO version_info (key, value) VALUES ("version", ?)',
+            "INSERT OR REPLACE INTO version_info (key, value) VALUES ('version', ?)",
             [common.RELEASE]
         )
     elif helpers.version_to_tuple(result[0]) < helpers.version_to_tuple(common.RELEASE):
         c_db.execute(
-            'UPDATE version_info SET value = ? WHERE key = "version"',
+            "UPDATE version_info SET value = ? WHERE key = 'version'",
             [common.RELEASE]
         )
 
@@ -2727,9 +2730,9 @@ def dbcheck():
     # Migrate poster_urls to imgur_lookup table
     try:
         db = database.MonitorDatabase()
-        result = db.select('SELECT SQL FROM sqlite_master WHERE type="table" AND name="poster_urls"')
+        result = db.select("SELECT SQL FROM sqlite_master WHERE type='table' AND name='poster_urls'")
         if result:
-            result = db.select('SELECT * FROM poster_urls')
+            result = db.select("SELECT * FROM poster_urls")
             logger.debug("Altering database. Updating database table imgur_lookup.")
 
             data_factory = datafactory.DataFactory()
diff --git a/plexpy/activity_pinger.py b/plexpy/activity_pinger.py
index f1aac594..f349268c 100644
--- a/plexpy/activity_pinger.py
+++ b/plexpy/activity_pinger.py
@@ -99,22 +99,22 @@ def check_active_sessions(ws_request=False):
                                 # Using the set config parameter as the interval, probably not the most accurate but
                                 # it will have to do for now. If it's a websocket request don't use this method.
                                 paused_counter = int(stream['paused_counter']) + plexpy.CONFIG.MONITORING_INTERVAL
-                                monitor_db.action('UPDATE sessions SET paused_counter = ? '
-                                                  'WHERE session_key = ? AND rating_key = ?',
+                                monitor_db.action("UPDATE sessions SET paused_counter = ? "
+                                                  "WHERE session_key = ? AND rating_key = ?",
                                                   [paused_counter, stream['session_key'], stream['rating_key']])
 
                             if session['state'] == 'buffering' and plexpy.CONFIG.BUFFER_THRESHOLD > 0:
                                 # The stream is buffering so we need to increment the buffer_count
                                 # We're going just increment on every monitor ping,
                                 # would be difficult to keep track otherwise
-                                monitor_db.action('UPDATE sessions SET buffer_count = buffer_count + 1 '
-                                                  'WHERE session_key = ? AND rating_key = ?',
+                                monitor_db.action("UPDATE sessions SET buffer_count = buffer_count + 1 "
+                                                  "WHERE session_key = ? AND rating_key = ?",
                                                   [stream['session_key'], stream['rating_key']])
 
                                 # Check the current buffer count and last buffer to determine if we should notify
-                                buffer_values = monitor_db.select('SELECT buffer_count, buffer_last_triggered '
-                                                                  'FROM sessions '
-                                                                  'WHERE session_key = ? AND rating_key = ?',
+                                buffer_values = monitor_db.select("SELECT buffer_count, buffer_last_triggered "
+                                                                  "FROM sessions "
+                                                                  "WHERE session_key = ? AND rating_key = ?",
                                                                   [stream['session_key'], stream['rating_key']])
 
                                 if buffer_values[0]['buffer_count'] >= plexpy.CONFIG.BUFFER_THRESHOLD:
@@ -125,9 +125,9 @@ def check_active_sessions(ws_request=False):
                                         logger.info("Tautulli Monitor :: User '%s' has triggered a buffer warning."
                                                     % stream['user'])
                                         # Set the buffer trigger time
-                                        monitor_db.action('UPDATE sessions '
-                                                          'SET buffer_last_triggered = strftime("%s","now") '
-                                                          'WHERE session_key = ? AND rating_key = ?',
+                                        monitor_db.action("UPDATE sessions "
+                                                          "SET buffer_last_triggered = strftime('%s', 'now') "
+                                                          "WHERE session_key = ? AND rating_key = ?",
                                                           [stream['session_key'], stream['rating_key']])
 
                                         plexpy.NOTIFY_QUEUE.put({'stream_data': stream.copy(), 'notify_action': 'on_buffer'})
@@ -139,9 +139,9 @@ def check_active_sessions(ws_request=False):
                                             logger.info("Tautulli Monitor :: User '%s' has triggered multiple buffer warnings."
                                                     % stream['user'])
                                             # Set the buffer trigger time
-                                            monitor_db.action('UPDATE sessions '
-                                                              'SET buffer_last_triggered = strftime("%s","now") '
-                                                              'WHERE session_key = ? AND rating_key = ?',
+                                            monitor_db.action("UPDATE sessions "
+                                                              "SET buffer_last_triggered = strftime('%s', 'now') "
+                                                              "WHERE session_key = ? AND rating_key = ?",
                                                               [stream['session_key'], stream['rating_key']])
 
                                             plexpy.NOTIFY_QUEUE.put({'stream_data': stream.copy(), 'notify_action': 'on_buffer'})
@@ -171,8 +171,8 @@ def check_active_sessions(ws_request=False):
                         if not stream['stopped']:
                             # Set the stream stop time
                             stream['stopped'] = helpers.timestamp()
-                            monitor_db.action('UPDATE sessions SET stopped = ?, state = ? '
-                                              'WHERE session_key = ? AND rating_key = ?',
+                            monitor_db.action("UPDATE sessions SET stopped = ?, state = ? "
+                                              "WHERE session_key = ? AND rating_key = ?",
                                               [stream['stopped'], 'stopped', stream['session_key'], stream['rating_key']])
 
                         progress_percent = helpers.get_percent(stream['view_offset'], stream['duration'])
diff --git a/plexpy/activity_processor.py b/plexpy/activity_processor.py
index 71b6e3e0..588e91ce 100644
--- a/plexpy/activity_processor.py
+++ b/plexpy/activity_processor.py
@@ -331,10 +331,10 @@ class ActivityProcessor(object):
 
                 if session['live']:
                     # Check if we should group the session, select the last guid from the user
-                    query = 'SELECT session_history.id, session_history_metadata.guid, session_history.reference_id ' \
-                            'FROM session_history ' \
-                            'JOIN session_history_metadata ON session_history.id == session_history_metadata.id ' \
-                            'WHERE session_history.user_id = ? ORDER BY session_history.id DESC LIMIT 1 '
+                    query = "SELECT session_history.id, session_history_metadata.guid, session_history.reference_id " \
+                            "FROM session_history " \
+                            "JOIN session_history_metadata ON session_history.id == session_history_metadata.id " \
+                            "WHERE session_history.user_id = ? ORDER BY session_history.id DESC LIMIT 1 "
 
                     args = [session['user_id']]
 
@@ -351,8 +351,8 @@ class ActivityProcessor(object):
 
                 else:
                     # Check if we should group the session, select the last two rows from the user
-                    query = 'SELECT id, rating_key, view_offset, reference_id FROM session_history ' \
-                            'WHERE user_id = ? AND rating_key = ? ORDER BY id DESC LIMIT 2 '
+                    query = "SELECT id, rating_key, view_offset, reference_id FROM session_history " \
+                            "WHERE user_id = ? AND rating_key = ? ORDER BY id DESC LIMIT 2 "
 
                     args = [session['user_id'], session['rating_key']]
 
@@ -375,7 +375,7 @@ class ActivityProcessor(object):
                             marker_first, marker_final
                         )
 
-                query = 'UPDATE session_history SET reference_id = ? WHERE id = ? '
+                query = "UPDATE session_history SET reference_id = ? WHERE id = ? "
 
                 # If previous session view offset less than watched percent,
                 # and new session view offset is greater,
@@ -547,12 +547,12 @@ class ActivityProcessor(object):
             return session['id']
 
     def get_sessions(self, user_id=None, ip_address=None):
-        query = 'SELECT * FROM sessions'
+        query = "SELECT * FROM sessions"
         args = []
 
         if str(user_id).isdigit():
-            ip = ' GROUP BY ip_address' if ip_address else ''
-            query += ' WHERE user_id = ?' + ip
+            ip = " GROUP BY ip_address" if ip_address else ""
+            query += " WHERE user_id = ?" + ip
             args.append(user_id)
 
         sessions = self.db.select(query, args)
@@ -560,8 +560,8 @@ class ActivityProcessor(object):
 
     def get_session_by_key(self, session_key=None):
         if str(session_key).isdigit():
-            session = self.db.select_single('SELECT * FROM sessions '
-                                            'WHERE session_key = ? ',
+            session = self.db.select_single("SELECT * FROM sessions "
+                                            "WHERE session_key = ? ",
                                             args=[session_key])
             if session:
                 return session
@@ -570,8 +570,8 @@ class ActivityProcessor(object):
 
     def get_session_by_id(self, session_id=None):
         if session_id:
-            session = self.db.select_single('SELECT * FROM sessions '
-                                            'WHERE session_id = ? ',
+            session = self.db.select_single("SELECT * FROM sessions "
+                                            "WHERE session_id = ? ",
                                             args=[session_id])
             if session:
                 return session
@@ -597,15 +597,15 @@ class ActivityProcessor(object):
 
     def delete_session(self, session_key=None, row_id=None):
         if str(session_key).isdigit():
-            self.db.action('DELETE FROM sessions WHERE session_key = ?', [session_key])
+            self.db.action("DELETE FROM sessions WHERE session_key = ?", [session_key])
         elif str(row_id).isdigit():
-            self.db.action('DELETE FROM sessions WHERE id = ?', [row_id])
+            self.db.action("DELETE FROM sessions WHERE id = ?", [row_id])
 
     def set_session_last_paused(self, session_key=None, timestamp=None):
         if str(session_key).isdigit():
-            result = self.db.select('SELECT last_paused, paused_counter '
-                                    'FROM sessions '
-                                    'WHERE session_key = ?', args=[session_key])
+            result = self.db.select("SELECT last_paused, paused_counter "
+                                    "FROM sessions "
+                                    "WHERE session_key = ?", args=[session_key])
 
             paused_counter = None
             for session in result:
@@ -626,15 +626,15 @@ class ActivityProcessor(object):
 
     def increment_session_buffer_count(self, session_key=None):
         if str(session_key).isdigit():
-            self.db.action('UPDATE sessions SET buffer_count = buffer_count + 1 '
-                           'WHERE session_key = ?',
+            self.db.action("UPDATE sessions SET buffer_count = buffer_count + 1 "
+                           "WHERE session_key = ?",
                            [session_key])
 
     def get_session_buffer_count(self, session_key=None):
         if str(session_key).isdigit():
-            buffer_count = self.db.select_single('SELECT buffer_count '
-                                                 'FROM sessions '
-                                                 'WHERE session_key = ?',
+            buffer_count = self.db.select_single("SELECT buffer_count "
+                                                 "FROM sessions "
+                                                 "WHERE session_key = ?",
                                                  [session_key])
             if buffer_count:
                 return buffer_count['buffer_count']
@@ -643,15 +643,15 @@ class ActivityProcessor(object):
 
     def set_session_buffer_trigger_time(self, session_key=None):
         if str(session_key).isdigit():
-            self.db.action('UPDATE sessions SET buffer_last_triggered = strftime("%s","now") '
-                           'WHERE session_key = ?',
+            self.db.action("UPDATE sessions SET buffer_last_triggered = strftime('%s', 'now') "
+                           "WHERE session_key = ?",
                            [session_key])
 
     def get_session_buffer_trigger_time(self, session_key=None):
         if str(session_key).isdigit():
-            last_time = self.db.select_single('SELECT buffer_last_triggered '
-                                              'FROM sessions '
-                                              'WHERE session_key = ?',
+            last_time = self.db.select_single("SELECT buffer_last_triggered "
+                                              "FROM sessions "
+                                              "WHERE session_key = ?",
                                               [session_key])
             if last_time:
                 return last_time['buffer_last_triggered']
@@ -660,12 +660,12 @@ class ActivityProcessor(object):
 
     def set_temp_stopped(self):
         stopped_time = helpers.timestamp()
-        self.db.action('UPDATE sessions SET stopped = ?', [stopped_time])
+        self.db.action("UPDATE sessions SET stopped = ?", [stopped_time])
 
     def increment_write_attempts(self, session_key=None):
         if str(session_key).isdigit():
             session = self.get_session_by_key(session_key=session_key)
-            self.db.action('UPDATE sessions SET write_attempts = ? WHERE session_key = ?',
+            self.db.action("UPDATE sessions SET write_attempts = ? WHERE session_key = ?",
                            [session['write_attempts'] + 1, session_key])
 
     def set_marker(self, session_key=None, marker_idx=None, marker_type=None):
@@ -674,13 +674,13 @@ class ActivityProcessor(object):
             int(marker_type == 'commercial'),
             int(marker_type == 'credits')
         ]
-        self.db.action('UPDATE sessions SET intro = ?, commercial = ?, credits = ?, marker = ? '
-                       'WHERE session_key = ?',
+        self.db.action("UPDATE sessions SET intro = ?, commercial = ?, credits = ?, marker = ? "
+                       "WHERE session_key = ?",
                        marker_args + [marker_idx, session_key])
 
     def set_watched(self, session_key=None):
-        self.db.action('UPDATE sessions SET watched = ? '
-                       'WHERE session_key = ?',
+        self.db.action("UPDATE sessions SET watched = ? "
+                       "WHERE session_key = ?",
                        [1, session_key])
 
     def write_continued_session(self, user_id=None, machine_id=None, media_type=None, stopped=None):
@@ -689,9 +689,9 @@ class ActivityProcessor(object):
         self.db.upsert(table_name='sessions_continued', key_dict=keys, value_dict=values)
 
     def is_initial_stream(self, user_id=None, machine_id=None, media_type=None, started=None):
-        last_session = self.db.select_single('SELECT stopped '
-                                             'FROM sessions_continued '
-                                             'WHERE user_id = ? AND machine_id = ? AND media_type = ? '
-                                             'ORDER BY stopped DESC',
+        last_session = self.db.select_single("SELECT stopped "
+                                             "FROM sessions_continued "
+                                             "WHERE user_id = ? AND machine_id = ? AND media_type = ? "
+                                             "ORDER BY stopped DESC",
                                              [user_id, machine_id, media_type])
         return int(started - last_session.get('stopped', 0) >= plexpy.CONFIG.NOTIFY_CONTINUED_SESSION_THRESHOLD)
diff --git a/plexpy/database.py b/plexpy/database.py
index 72ce7782..859d9274 100644
--- a/plexpy/database.py
+++ b/plexpy/database.py
@@ -54,7 +54,7 @@ def validate_database(database=None):
         return 'Uncaught exception'
 
     try:
-        connection.execute('SELECT started from session_history')
+        connection.execute("SELECT started from session_history")
         connection.close()
     except (sqlite3.OperationalError, sqlite3.DatabaseError, ValueError) as e:
         logger.error("Tautulli Database :: Invalid database specified: %s", e)
@@ -92,11 +92,11 @@ def import_tautulli_db(database=None, method=None, backup=False):
     set_is_importing(True)
 
     db = MonitorDatabase()
-    db.connection.execute('BEGIN IMMEDIATE')
-    db.connection.execute('ATTACH ? AS import_db', [database])
+    db.connection.execute("BEGIN IMMEDIATE")
+    db.connection.execute("ATTACH ? AS import_db", [database])
 
     try:
-        version_info = db.select_single('SELECT * FROM import_db.version_info WHERE key = "version"')
+        version_info = db.select_single("SELECT * FROM import_db.version_info WHERE key = 'version'")
         import_db_version = version_info['value']
     except (sqlite3.OperationalError, KeyError):
         import_db_version = 'v2.6.10'
@@ -105,7 +105,7 @@ def import_tautulli_db(database=None, method=None, backup=False):
     import_db_version = helpers.version_to_tuple(import_db_version)
 
     # Get the current number of used ids in the session_history table
-    session_history_seq = db.select_single('SELECT seq FROM sqlite_sequence WHERE name = "session_history"')
+    session_history_seq = db.select_single("SELECT seq FROM sqlite_sequence WHERE name = 'session_history'")
     session_history_rows = session_history_seq.get('seq', 0)
 
     session_history_tables = ('session_history', 'session_history_metadata', 'session_history_media_info')
@@ -113,11 +113,11 @@ def import_tautulli_db(database=None, method=None, backup=False):
     if method == 'merge':
         logger.info("Tautulli Database :: Creating temporary database tables to re-index grouped session history.")
         for table_name in session_history_tables:
-            db.action('CREATE TABLE {table}_copy AS SELECT * FROM import_db.{table}'.format(table=table_name))
-            db.action('UPDATE {table}_copy SET id = id + ?'.format(table=table_name),
+            db.action("CREATE TABLE {table}_copy AS SELECT * FROM import_db.{table}".format(table=table_name))
+            db.action("UPDATE {table}_copy SET id = id + ?".format(table=table_name),
                       [session_history_rows])
             if table_name == 'session_history':
-                db.action('UPDATE {table}_copy SET reference_id = reference_id + ?'.format(table=table_name),
+                db.action("UPDATE {table}_copy SET reference_id = reference_id + ?".format(table=table_name),
                           [session_history_rows])
 
     # Migrate section_id from session_history_metadata to session_history
@@ -128,28 +128,28 @@ def import_tautulli_db(database=None, method=None, backup=False):
         else:
             from_db_name = 'import_db'
             copy = ''
-        db.action('ALTER TABLE {from_db}.session_history{copy} '
-                  'ADD COLUMN section_id INTEGER'.format(from_db=from_db_name,
+        db.action("ALTER TABLE {from_db}.session_history{copy} "
+                  "ADD COLUMN section_id INTEGER".format(from_db=from_db_name,
                                                          copy=copy))
-        db.action('UPDATE {from_db}.session_history{copy} SET section_id = ('
-                  'SELECT section_id FROM {from_db}.session_history_metadata{copy} '
-                  'WHERE {from_db}.session_history_metadata{copy}.id = '
-                  '{from_db}.session_history{copy}.id)'.format(from_db=from_db_name,
+        db.action("UPDATE {from_db}.session_history{copy} SET section_id = ("
+                  "SELECT section_id FROM {from_db}.session_history_metadata{copy} "
+                  "WHERE {from_db}.session_history_metadata{copy}.id = "
+                  "{from_db}.session_history{copy}.id)".format(from_db=from_db_name,
                                                                copy=copy))
 
     # Keep track of all table columns so that duplicates can be removed after importing
     table_columns = {}
 
-    tables = db.select('SELECT name FROM import_db.sqlite_master '
-                       'WHERE type = "table" AND name NOT LIKE "sqlite_%"'
-                       'ORDER BY name')
+    tables = db.select("SELECT name FROM import_db.sqlite_master "
+                       "WHERE type = 'table' AND name NOT LIKE 'sqlite_%'"
+                       "ORDER BY name")
     for table in tables:
         table_name = table['name']
         if table_name == 'sessions' or table_name == 'version_info':
             # Skip temporary sessions table
             continue
 
-        current_table = db.select('PRAGMA main.table_info({table})'.format(table=table_name))
+        current_table = db.select("PRAGMA main.table_info({table})".format(table=table_name))
         if not current_table:
             # Skip table does not exits
             continue
@@ -158,8 +158,8 @@ def import_tautulli_db(database=None, method=None, backup=False):
 
         if method == 'overwrite':
             # Clear the table and reset the autoincrement ids
-            db.action('DELETE FROM {table}'.format(table=table_name))
-            db.action('DELETE FROM sqlite_sequence WHERE name = ?', [table_name])
+            db.action("DELETE FROM {table}".format(table=table_name))
+            db.action("DELETE FROM sqlite_sequence WHERE name = ?", [table_name])
 
         if method == 'merge' and table_name in session_history_tables:
             from_db_name = 'main'
@@ -170,7 +170,7 @@ def import_tautulli_db(database=None, method=None, backup=False):
 
         # Get the list of columns to import
         current_columns = [c['name'] for c in current_table]
-        import_table = db.select('PRAGMA {from_db}.table_info({from_table})'.format(from_db=from_db_name,
+        import_table = db.select("PRAGMA {from_db}.table_info({from_table})".format(from_db=from_db_name,
                                                                                     from_table=from_table_name))
 
         if method == 'merge' and table_name not in session_history_tables:
@@ -182,29 +182,29 @@ def import_tautulli_db(database=None, method=None, backup=False):
         insert_columns = ', '.join(import_columns)
 
         # Insert the data with ignore instead of replace to be safe
-        db.action('INSERT OR IGNORE INTO {table} ({columns}) '
-                  'SELECT {columns} FROM {from_db}.{from_table}'.format(table=table_name,
+        db.action("INSERT OR IGNORE INTO {table} ({columns}) "
+                  "SELECT {columns} FROM {from_db}.{from_table}".format(table=table_name,
                                                                         columns=insert_columns,
                                                                         from_db=from_db_name,
                                                                         from_table=from_table_name))
 
-    db.connection.execute('DETACH import_db')
+    db.connection.execute("DETACH import_db")
 
     if method == 'merge':
         for table_name, columns in sorted(table_columns.items()):
             duplicate_columns = ', '.join([c for c in columns if c not in ('id', 'reference_id')])
             logger.info("Tautulli Database :: Removing duplicate rows from database table '%s'.", table_name)
             if table_name in session_history_tables[1:]:
-                db.action('DELETE FROM {table} WHERE id NOT IN '
-                          '(SELECT id FROM session_history)'.format(table=table_name))
+                db.action("DELETE FROM {table} WHERE id NOT IN "
+                          "(SELECT id FROM session_history)".format(table=table_name))
             else:
-                db.action('DELETE FROM {table} WHERE id NOT IN '
-                          '(SELECT MIN(id) FROM {table} GROUP BY {columns})'.format(table=table_name,
+                db.action("DELETE FROM {table} WHERE id NOT IN "
+                          "(SELECT MIN(id) FROM {table} GROUP BY {columns})".format(table=table_name,
                                                                                     columns=duplicate_columns))
 
         logger.info("Tautulli Database :: Deleting temporary database tables.")
         for table_name in session_history_tables:
-            db.action('DROP TABLE {table}_copy'.format(table=table_name))
+            db.action("DROP TABLE {table}_copy".format(table=table_name))
 
     vacuum()
 
@@ -217,7 +217,7 @@ def import_tautulli_db(database=None, method=None, backup=False):
 
 def integrity_check():
     monitor_db = MonitorDatabase()
-    result = monitor_db.select_single('PRAGMA integrity_check')
+    result = monitor_db.select_single("PRAGMA integrity_check")
     return result
 
 
@@ -227,7 +227,7 @@ def clear_table(table=None):
 
         logger.debug("Tautulli Database :: Clearing database table '%s'." % table)
         try:
-            monitor_db.action('DELETE FROM %s' % table)
+            monitor_db.action("DELETE FROM %s" % table)
             vacuum()
             return True
         except Exception as e:
@@ -286,7 +286,7 @@ def delete_user_history(user_id=None):
         monitor_db = MonitorDatabase()
 
         # Get all history associated with the user_id
-        result = monitor_db.select('SELECT id FROM session_history WHERE user_id = ?',
+        result = monitor_db.select("SELECT id FROM session_history WHERE user_id = ?",
                                    [user_id])
         row_ids = [row['id'] for row in result]
 
@@ -299,7 +299,7 @@ def delete_library_history(section_id=None):
         monitor_db = MonitorDatabase()
 
         # Get all history associated with the section_id
-        result = monitor_db.select('SELECT id FROM session_history WHERE section_id = ?',
+        result = monitor_db.select("SELECT id FROM session_history WHERE section_id = ?",
                                    [section_id])
         row_ids = [row['id'] for row in result]
 
@@ -312,7 +312,7 @@ def vacuum():
 
     logger.info("Tautulli Database :: Vacuuming database.")
     try:
-        monitor_db.action('VACUUM')
+        monitor_db.action("VACUUM")
     except Exception as e:
         logger.error("Tautulli Database :: Failed to vacuum database: %s" % e)
 
@@ -322,7 +322,7 @@ def optimize():
 
     logger.info("Tautulli Database :: Optimizing database.")
     try:
-        monitor_db.action('PRAGMA optimize')
+        monitor_db.action("PRAGMA optimize")
     except Exception as e:
         logger.error("Tautulli Database :: Failed to optimize database: %s" % e)
 
@@ -362,7 +362,7 @@ def make_backup(cleanup=False, scheduler=False):
         os.makedirs(backup_folder)
 
     db = MonitorDatabase()
-    db.connection.execute('BEGIN IMMEDIATE')
+    db.connection.execute("BEGIN IMMEDIATE")
     shutil.copyfile(db_filename(), backup_file_fp)
     db.connection.rollback()
 
@@ -496,6 +496,6 @@ class MonitorDatabase(object):
 
     def last_insert_id(self):
         # Get the last insert row id
-        result = self.select_single(query='SELECT last_insert_rowid() AS last_id')
+        result = self.select_single(query="SELECT last_insert_rowid() AS last_id")
         if result:
             return result.get('last_id', None)
\ No newline at end of file
diff --git a/plexpy/datafactory.py b/plexpy/datafactory.py
index e2ee0c2b..3db32a51 100644
--- a/plexpy/datafactory.py
+++ b/plexpy/datafactory.py
@@ -93,61 +93,61 @@ class DataFactory(object):
         group_by = ['session_history.reference_id'] if grouping else ['session_history.id']
 
         columns = [
-            'session_history.reference_id',
-            'session_history.id AS row_id',
-            'MAX(started) AS date',
-            'MIN(started) AS started',
-            'MAX(stopped) AS stopped',
-            'SUM(CASE WHEN stopped > 0 THEN (stopped - started) ELSE 0 END) - \
-             SUM(CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) AS play_duration',
-            'SUM(CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) AS paused_counter',
-            'session_history.view_offset',
-            'session_history.user_id',
-            'session_history.user',
-            '(CASE WHEN users.friendly_name IS NULL OR TRIM(users.friendly_name) = "" \
-             THEN users.username ELSE users.friendly_name END) AS friendly_name',
-            'users.thumb AS user_thumb',
-            'users.custom_avatar_url AS custom_thumb',
-            'platform',
-            'product',
-            'player',
-            'ip_address',
-            'machine_id',
-            'location',
-            'secure',
-            'relayed',
-            'session_history.media_type',
-            '(CASE WHEN session_history_metadata.live = 1 THEN \'live\' ELSE session_history.media_type END) \
-             AS media_type_live',
-            'session_history_metadata.rating_key',
-            'session_history_metadata.parent_rating_key',
-            'session_history_metadata.grandparent_rating_key',
-            'session_history_metadata.full_title',
-            'session_history_metadata.title',
-            'session_history_metadata.parent_title',
-            'session_history_metadata.grandparent_title',
-            'session_history_metadata.original_title',
-            'session_history_metadata.year',
-            'session_history_metadata.media_index',
-            'session_history_metadata.parent_media_index',
-            'session_history_metadata.thumb',
-            'session_history_metadata.parent_thumb',
-            'session_history_metadata.grandparent_thumb',
-            'session_history_metadata.live',
-            'session_history_metadata.added_at',
-            'session_history_metadata.originally_available_at',
-            'session_history_metadata.guid',
-            'MAX((CASE WHEN (view_offset IS NULL OR view_offset = "") THEN 0.1 ELSE view_offset * 1.0 END) / \
-             (CASE WHEN (session_history_metadata.duration IS NULL OR session_history_metadata.duration = "") \
-             THEN 1.0 ELSE session_history_metadata.duration * 1.0 END) * 100) AS percent_complete',
-            'session_history_metadata.duration',
-            'session_history_metadata.marker_credits_first',
-            'session_history_metadata.marker_credits_final',
-            'session_history_media_info.transcode_decision',
-            'COUNT(*) AS group_count',
-            'GROUP_CONCAT(session_history.id) AS group_ids',
-            'NULL AS state',
-            'NULL AS session_key'
+            "session_history.reference_id",
+            "session_history.id AS row_id",
+            "MAX(started) AS date",
+            "MIN(started) AS started",
+            "MAX(stopped) AS stopped",
+            "SUM(CASE WHEN stopped > 0 THEN (stopped - started) ELSE 0 END) - \
+             SUM(CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) AS play_duration",
+            "SUM(CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) AS paused_counter",
+            "session_history.view_offset",
+            "session_history.user_id",
+            "session_history.user",
+            "(CASE WHEN users.friendly_name IS NULL OR TRIM(users.friendly_name) = '' \
+             THEN users.username ELSE users.friendly_name END) AS friendly_name",
+            "users.thumb AS user_thumb",
+            "users.custom_avatar_url AS custom_thumb",
+            "platform",
+            "product",
+            "player",
+            "ip_address",
+            "machine_id",
+            "location",
+            "secure",
+            "relayed",
+            "session_history.media_type",
+            "(CASE WHEN session_history_metadata.live = 1 THEN 'live' ELSE session_history.media_type END) \
+             AS media_type_live",
+            "session_history_metadata.rating_key",
+            "session_history_metadata.parent_rating_key",
+            "session_history_metadata.grandparent_rating_key",
+            "session_history_metadata.full_title",
+            "session_history_metadata.title",
+            "session_history_metadata.parent_title",
+            "session_history_metadata.grandparent_title",
+            "session_history_metadata.original_title",
+            "session_history_metadata.year",
+            "session_history_metadata.media_index",
+            "session_history_metadata.parent_media_index",
+            "session_history_metadata.thumb",
+            "session_history_metadata.parent_thumb",
+            "session_history_metadata.grandparent_thumb",
+            "session_history_metadata.live",
+            "session_history_metadata.added_at",
+            "session_history_metadata.originally_available_at",
+            "session_history_metadata.guid",
+            "MAX((CASE WHEN (view_offset IS NULL OR view_offset = '') THEN 0.1 ELSE view_offset * 1.0 END) / \
+             (CASE WHEN (session_history_metadata.duration IS NULL OR session_history_metadata.duration = '') \
+             THEN 1.0 ELSE session_history_metadata.duration * 1.0 END) * 100) AS percent_complete",
+            "session_history_metadata.duration",
+            "session_history_metadata.marker_credits_first",
+            "session_history_metadata.marker_credits_final",
+            "session_history_media_info.transcode_decision",
+            "COUNT(*) AS group_count",
+            "GROUP_CONCAT(session_history.id) AS group_ids",
+            "NULL AS state",
+            "NULL AS session_key"
             ]
 
         if include_activity:
@@ -157,60 +157,60 @@ class DataFactory(object):
             group_by_union = ['session_key']
 
             columns_union = [
-                'NULL AS reference_id',
-                'NULL AS row_id',
-                'started AS date',
-                'started',
-                'stopped',
-                'SUM(CASE WHEN stopped > 0 THEN (stopped - started) ELSE (strftime("%s", "now") - started) END) - \
-                 SUM(CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) AS play_duration',
-                'SUM(CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) AS paused_counter',
-                'view_offset',
-                'user_id',
-                'user',
-                '(CASE WHEN friendly_name IS NULL OR TRIM(friendly_name) = "" \
-                 THEN user ELSE friendly_name END) AS friendly_name',
-                'NULL AS user_thumb',
-                'NULL AS custom_thumb',
-                'platform',
-                'product',
-                'player',
-                'ip_address',
-                'machine_id',
-                'location',
-                'secure',
-                'relayed',
-                'media_type',
-                '(CASE WHEN live = 1 THEN \'live\' ELSE media_type END) AS media_type_live',
-                'rating_key',
-                'parent_rating_key',
-                'grandparent_rating_key',
-                'full_title',
-                'title',
-                'parent_title',
-                'grandparent_title',
-                'original_title',
-                'year',
-                'media_index',
-                'parent_media_index',
-                'thumb',
-                'parent_thumb',
-                'grandparent_thumb',
-                'live',
-                'added_at',
-                'originally_available_at',
-                'guid',
-                'MAX((CASE WHEN (view_offset IS NULL OR view_offset = "") THEN 0.1 ELSE view_offset * 1.0 END) / \
-                 (CASE WHEN (duration IS NULL OR duration = "") \
-                 THEN 1.0 ELSE duration * 1.0 END) * 100) AS percent_complete',
-                'duration',
-                'NULL AS marker_credits_first',
-                'NULL AS marker_credits_final',
-                'transcode_decision',
-                'NULL AS group_count',
-                'NULL AS group_ids',
-                'state',
-                'session_key'
+                "NULL AS reference_id",
+                "NULL AS row_id",
+                "started AS date",
+                "started",
+                "stopped",
+                "SUM(CASE WHEN stopped > 0 THEN (stopped - started) ELSE (strftime('%s', 'now') - started) END) - \
+                 SUM(CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) AS play_duration",
+                "SUM(CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) AS paused_counter",
+                "view_offset",
+                "user_id",
+                "user",
+                "(CASE WHEN friendly_name IS NULL OR TRIM(friendly_name) = '' \
+                 THEN user ELSE friendly_name END) AS friendly_name",
+                "NULL AS user_thumb",
+                "NULL AS custom_thumb",
+                "platform",
+                "product",
+                "player",
+                "ip_address",
+                "machine_id",
+                "location",
+                "secure",
+                "relayed",
+                "media_type",
+                "(CASE WHEN live = 1 THEN 'live' ELSE media_type END) AS media_type_live",
+                "rating_key",
+                "parent_rating_key",
+                "grandparent_rating_key",
+                "full_title",
+                "title",
+                "parent_title",
+                "grandparent_title",
+                "original_title",
+                "year",
+                "media_index",
+                "parent_media_index",
+                "thumb",
+                "parent_thumb",
+                "grandparent_thumb",
+                "live",
+                "added_at",
+                "originally_available_at",
+                "guid",
+                "MAX((CASE WHEN (view_offset IS NULL OR view_offset = '') THEN 0.1 ELSE view_offset * 1.0 END) / \
+                 (CASE WHEN (duration IS NULL OR duration = '') \
+                 THEN 1.0 ELSE duration * 1.0 END) * 100) AS percent_complete",
+                "duration",
+                "NULL AS marker_credits_first",
+                "NULL AS marker_credits_final",
+                "transcode_decision",
+                "NULL AS group_count",
+                "NULL AS group_ids",
+                "state",
+                "session_key"
                 ]
 
         else:
@@ -392,20 +392,20 @@ class DataFactory(object):
             if stat == 'top_movies':
                 top_movies = []
                 try:
-                    query = 'SELECT sh.id, shm.full_title, shm.year, sh.rating_key, shm.thumb, sh.section_id, ' \
-                            'shm.art, sh.media_type, shm.content_rating, shm.labels, sh.started, shm.live, shm.guid, ' \
-                            'MAX(sh.started) AS last_watch, COUNT(sh.id) AS total_plays, SUM(sh.d) AS total_duration ' \
-                            'FROM (SELECT *, SUM(CASE WHEN stopped > 0 THEN (stopped - started) - ' \
-                            '       (CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) ELSE 0 END) ' \
-                            '       AS d ' \
-                            '   FROM session_history ' \
-                            '   WHERE session_history.stopped >= %s ' \
-                            '       AND session_history.media_type = "movie" %s ' \
-                            '   GROUP BY %s) AS sh ' \
-                            'JOIN session_history_metadata AS shm ON shm.id = sh.id ' \
-                            'GROUP BY shm.full_title, shm.year ' \
-                            'ORDER BY %s DESC, sh.started DESC ' \
-                            'LIMIT %s OFFSET %s ' % (timestamp, where_id, group_by, sort_type, stats_count, stats_start)
+                    query = "SELECT sh.id, shm.full_title, shm.year, sh.rating_key, shm.thumb, sh.section_id, " \
+                            "shm.art, sh.media_type, shm.content_rating, shm.labels, sh.started, shm.live, shm.guid, " \
+                            "MAX(sh.started) AS last_watch, COUNT(sh.id) AS total_plays, SUM(sh.d) AS total_duration " \
+                            "FROM (SELECT *, SUM(CASE WHEN stopped > 0 THEN (stopped - started) - " \
+                            "       (CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) ELSE 0 END) " \
+                            "       AS d " \
+                            "   FROM session_history " \
+                            "   WHERE session_history.stopped >= %s " \
+                            "       AND session_history.media_type = 'movie' %s " \
+                            "   GROUP BY %s) AS sh " \
+                            "JOIN session_history_metadata AS shm ON shm.id = sh.id " \
+                            "GROUP BY shm.full_title, shm.year " \
+                            "ORDER BY %s DESC, sh.started DESC " \
+                            "LIMIT %s OFFSET %s " % (timestamp, where_id, group_by, sort_type, stats_count, stats_start)
                     result = monitor_db.select(query)
                 except Exception as e:
                     logger.warn("Tautulli DataFactory :: Unable to execute database query for get_home_stats: top_movies: %s." % e)
@@ -444,21 +444,21 @@ class DataFactory(object):
             elif stat == 'popular_movies':
                 popular_movies = []
                 try:
-                    query = 'SELECT sh.id, shm.full_title, shm.year, sh.rating_key, shm.thumb, sh.section_id, ' \
-                            'shm.art, sh.media_type, shm.content_rating, shm.labels, sh.started, shm.live, shm.guid, ' \
-                            'COUNT(DISTINCT sh.user_id) AS users_watched, ' \
-                            'MAX(sh.started) AS last_watch, COUNT(sh.id) as total_plays, SUM(sh.d) AS total_duration ' \
-                            'FROM (SELECT *, SUM(CASE WHEN stopped > 0 THEN (stopped - started) - ' \
-                            '       (CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) ELSE 0 END) ' \
-                            '       AS d ' \
-                            '   FROM session_history ' \
-                            '   WHERE session_history.stopped >= %s ' \
-                            '       AND session_history.media_type = "movie" %s ' \
-                            '   GROUP BY %s) AS sh ' \
-                            'JOIN session_history_metadata AS shm ON shm.id = sh.id ' \
-                            'GROUP BY shm.full_title, shm.year ' \
-                            'ORDER BY users_watched DESC, %s DESC, sh.started DESC ' \
-                            'LIMIT %s OFFSET %s ' % (timestamp, where_id, group_by, sort_type, stats_count, stats_start)
+                    query = "SELECT sh.id, shm.full_title, shm.year, sh.rating_key, shm.thumb, sh.section_id, " \
+                            "shm.art, sh.media_type, shm.content_rating, shm.labels, sh.started, shm.live, shm.guid, " \
+                            "COUNT(DISTINCT sh.user_id) AS users_watched, " \
+                            "MAX(sh.started) AS last_watch, COUNT(sh.id) as total_plays, SUM(sh.d) AS total_duration " \
+                            "FROM (SELECT *, SUM(CASE WHEN stopped > 0 THEN (stopped - started) - " \
+                            "       (CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) ELSE 0 END) " \
+                            "       AS d " \
+                            "   FROM session_history " \
+                            "   WHERE session_history.stopped >= %s " \
+                            "       AND session_history.media_type = 'movie' %s " \
+                            "   GROUP BY %s) AS sh " \
+                            "JOIN session_history_metadata AS shm ON shm.id = sh.id " \
+                            "GROUP BY shm.full_title, shm.year " \
+                            "ORDER BY users_watched DESC, %s DESC, sh.started DESC " \
+                            "LIMIT %s OFFSET %s " % (timestamp, where_id, group_by, sort_type, stats_count, stats_start)
                     result = monitor_db.select(query)
                 except Exception as e:
                     logger.warn("Tautulli DataFactory :: Unable to execute database query for get_home_stats: popular_movies: %s." % e)
@@ -495,22 +495,22 @@ class DataFactory(object):
             elif stat == 'top_tv':
                 top_tv = []
                 try:
-                    query = 'SELECT sh.id, shm.grandparent_title, sh.grandparent_rating_key, ' \
-                            'shm.grandparent_thumb, sh.section_id, ' \
-                            'shm.year, sh.rating_key, shm.art, sh.media_type, ' \
-                            'shm.content_rating, shm.labels, sh.started, shm.live, shm.guid, ' \
-                            'MAX(sh.started) AS last_watch, COUNT(sh.id) AS total_plays, SUM(sh.d) AS total_duration ' \
-                            'FROM (SELECT *, SUM(CASE WHEN stopped > 0 THEN (stopped - started) - ' \
-                            '       (CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) ELSE 0 END) ' \
-                            '       AS d ' \
-                            '   FROM session_history ' \
-                            '   WHERE session_history.stopped >= %s ' \
-                            '       AND session_history.media_type = "episode" %s ' \
-                            '   GROUP BY %s) AS sh ' \
-                            'JOIN session_history_metadata AS shm ON shm.id = sh.id ' \
-                            'GROUP BY shm.grandparent_title ' \
-                            'ORDER BY %s DESC, sh.started DESC ' \
-                            'LIMIT %s OFFSET %s ' % (timestamp, where_id, group_by, sort_type, stats_count, stats_start)
+                    query = "SELECT sh.id, shm.grandparent_title, sh.grandparent_rating_key, " \
+                            "shm.grandparent_thumb, sh.section_id, " \
+                            "shm.year, sh.rating_key, shm.art, sh.media_type, " \
+                            "shm.content_rating, shm.labels, sh.started, shm.live, shm.guid, " \
+                            "MAX(sh.started) AS last_watch, COUNT(sh.id) AS total_plays, SUM(sh.d) AS total_duration " \
+                            "FROM (SELECT *, SUM(CASE WHEN stopped > 0 THEN (stopped - started) - " \
+                            "       (CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) ELSE 0 END) " \
+                            "       AS d " \
+                            "   FROM session_history " \
+                            "   WHERE session_history.stopped >= %s " \
+                            "       AND session_history.media_type = 'episode' %s " \
+                            "   GROUP BY %s) AS sh " \
+                            "JOIN session_history_metadata AS shm ON shm.id = sh.id " \
+                            "GROUP BY shm.grandparent_title " \
+                            "ORDER BY %s DESC, sh.started DESC " \
+                            "LIMIT %s OFFSET %s " % (timestamp, where_id, group_by, sort_type, stats_count, stats_start)
                     result = monitor_db.select(query)
                 except Exception as e:
                     logger.warn("Tautulli DataFactory :: Unable to execute database query for get_home_stats: top_tv: %s." % e)
@@ -549,23 +549,23 @@ class DataFactory(object):
             elif stat == 'popular_tv':
                 popular_tv = []
                 try:
-                    query = 'SELECT sh.id, shm.grandparent_title, sh.grandparent_rating_key, ' \
-                            'shm.grandparent_thumb, sh.section_id, ' \
-                            'shm.year, sh.rating_key, shm.art, sh.media_type, ' \
-                            'shm.content_rating, shm.labels, sh.started, shm.live, shm.guid, ' \
-                            'COUNT(DISTINCT sh.user_id) AS users_watched, ' \
-                            'MAX(sh.started) AS last_watch, COUNT(sh.id) as total_plays, SUM(sh.d) AS total_duration ' \
-                            'FROM (SELECT *, SUM(CASE WHEN stopped > 0 THEN (stopped - started) - ' \
-                            '       (CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) ELSE 0 END) ' \
-                            '       AS d ' \
-                            '   FROM session_history ' \
-                            '   WHERE session_history.stopped >= %s ' \
-                            '       AND session_history.media_type = "episode" %s ' \
-                            '   GROUP BY %s) AS sh ' \
-                            'JOIN session_history_metadata AS shm ON shm.id = sh.id ' \
-                            'GROUP BY shm.grandparent_title ' \
-                            'ORDER BY users_watched DESC, %s DESC, sh.started DESC ' \
-                            'LIMIT %s OFFSET %s ' % (timestamp, where_id, group_by, sort_type, stats_count, stats_start)
+                    query = "SELECT sh.id, shm.grandparent_title, sh.grandparent_rating_key, " \
+                            "shm.grandparent_thumb, sh.section_id, " \
+                            "shm.year, sh.rating_key, shm.art, sh.media_type, " \
+                            "shm.content_rating, shm.labels, sh.started, shm.live, shm.guid, " \
+                            "COUNT(DISTINCT sh.user_id) AS users_watched, " \
+                            "MAX(sh.started) AS last_watch, COUNT(sh.id) as total_plays, SUM(sh.d) AS total_duration " \
+                            "FROM (SELECT *, SUM(CASE WHEN stopped > 0 THEN (stopped - started) - " \
+                            "       (CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) ELSE 0 END) " \
+                            "       AS d " \
+                            "   FROM session_history " \
+                            "   WHERE session_history.stopped >= %s " \
+                            "       AND session_history.media_type = 'episode' %s " \
+                            "   GROUP BY %s) AS sh " \
+                            "JOIN session_history_metadata AS shm ON shm.id = sh.id " \
+                            "GROUP BY shm.grandparent_title " \
+                            "ORDER BY users_watched DESC, %s DESC, sh.started DESC " \
+                            "LIMIT %s OFFSET %s " % (timestamp, where_id, group_by, sort_type, stats_count, stats_start)
                     result = monitor_db.select(query)
                 except Exception as e:
                     logger.warn("Tautulli DataFactory :: Unable to execute database query for get_home_stats: popular_tv: %s." % e)
@@ -602,21 +602,21 @@ class DataFactory(object):
             elif stat == 'top_music':
                 top_music = []
                 try:
-                    query = 'SELECT sh.id, shm.grandparent_title, shm.original_title, shm.year, ' \
-                            'sh.grandparent_rating_key, shm.grandparent_thumb, sh.section_id, ' \
-                            'shm.art, sh.media_type, shm.content_rating, shm.labels, sh.started, shm.live, shm.guid, ' \
-                            'MAX(sh.started) AS last_watch, COUNT(sh.id) AS total_plays, SUM(sh.d) AS total_duration ' \
-                            'FROM (SELECT *, SUM(CASE WHEN stopped > 0 THEN (stopped - started) - ' \
-                            '       (CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) ELSE 0 END) ' \
-                            '       AS d ' \
-                            '   FROM session_history ' \
-                            '   WHERE session_history.stopped >= %s ' \
-                            '       AND session_history.media_type = "track" %s ' \
-                            '   GROUP BY %s) AS sh ' \
-                            'JOIN session_history_metadata AS shm ON shm.id = sh.id ' \
-                            'GROUP BY shm.original_title, shm.grandparent_title ' \
-                            'ORDER BY %s DESC, sh.started DESC ' \
-                            'LIMIT %s OFFSET %s ' % (timestamp, where_id, group_by, sort_type, stats_count, stats_start)
+                    query = "SELECT sh.id, shm.grandparent_title, shm.original_title, shm.year, " \
+                            "sh.grandparent_rating_key, shm.grandparent_thumb, sh.section_id, " \
+                            "shm.art, sh.media_type, shm.content_rating, shm.labels, sh.started, shm.live, shm.guid, " \
+                            "MAX(sh.started) AS last_watch, COUNT(sh.id) AS total_plays, SUM(sh.d) AS total_duration " \
+                            "FROM (SELECT *, SUM(CASE WHEN stopped > 0 THEN (stopped - started) - " \
+                            "       (CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) ELSE 0 END) " \
+                            "       AS d " \
+                            "   FROM session_history " \
+                            "   WHERE session_history.stopped >= %s " \
+                            "       AND session_history.media_type = 'track' %s " \
+                            "   GROUP BY %s) AS sh " \
+                            "JOIN session_history_metadata AS shm ON shm.id = sh.id " \
+                            "GROUP BY shm.original_title, shm.grandparent_title " \
+                            "ORDER BY %s DESC, sh.started DESC " \
+                            "LIMIT %s OFFSET %s " % (timestamp, where_id, group_by, sort_type, stats_count, stats_start)
                     result = monitor_db.select(query)
                 except Exception as e:
                     logger.warn("Tautulli DataFactory :: Unable to execute database query for get_home_stats: top_music: %s." % e)
@@ -655,22 +655,22 @@ class DataFactory(object):
             elif stat == 'popular_music':
                 popular_music = []
                 try:
-                    query = 'SELECT sh.id, shm.grandparent_title, shm.original_title, shm.year, ' \
-                            'sh.grandparent_rating_key, shm.grandparent_thumb, sh.section_id, ' \
-                            'shm.art, sh.media_type, shm.content_rating, shm.labels, sh.started, shm.live, shm.guid, ' \
-                            'COUNT(DISTINCT sh.user_id) AS users_watched, ' \
-                            'MAX(sh.started) AS last_watch, COUNT(sh.id) as total_plays, SUM(sh.d) AS total_duration ' \
-                            'FROM (SELECT *, SUM(CASE WHEN stopped > 0 THEN (stopped - started) - ' \
-                            '       (CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) ELSE 0 END) ' \
-                            '       AS d ' \
-                            '   FROM session_history ' \
-                            '   WHERE session_history.stopped >= %s ' \
-                            '       AND session_history.media_type = "track" %s ' \
-                            '   GROUP BY %s) AS sh ' \
-                            'JOIN session_history_metadata AS shm ON shm.id = sh.id ' \
-                            'GROUP BY shm.original_title, shm.grandparent_title ' \
-                            'ORDER BY users_watched DESC, %s DESC, sh.started DESC ' \
-                            'LIMIT %s OFFSET %s ' % (timestamp, where_id, group_by, sort_type, stats_count, stats_start)
+                    query = "SELECT sh.id, shm.grandparent_title, shm.original_title, shm.year, " \
+                            "sh.grandparent_rating_key, shm.grandparent_thumb, sh.section_id, " \
+                            "shm.art, sh.media_type, shm.content_rating, shm.labels, sh.started, shm.live, shm.guid, " \
+                            "COUNT(DISTINCT sh.user_id) AS users_watched, " \
+                            "MAX(sh.started) AS last_watch, COUNT(sh.id) as total_plays, SUM(sh.d) AS total_duration " \
+                            "FROM (SELECT *, SUM(CASE WHEN stopped > 0 THEN (stopped - started) - " \
+                            "       (CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) ELSE 0 END) " \
+                            "       AS d " \
+                            "   FROM session_history " \
+                            "   WHERE session_history.stopped >= %s " \
+                            "       AND session_history.media_type = 'track' %s " \
+                            "   GROUP BY %s) AS sh " \
+                            "JOIN session_history_metadata AS shm ON shm.id = sh.id " \
+                            "GROUP BY shm.original_title, shm.grandparent_title " \
+                            "ORDER BY users_watched DESC, %s DESC, sh.started DESC " \
+                            "LIMIT %s OFFSET %s " % (timestamp, where_id, group_by, sort_type, stats_count, stats_start)
                     result = monitor_db.select(query)
                 except Exception as e:
                     logger.warn("Tautulli DataFactory :: Unable to execute database query for get_home_stats: popular_music: %s." % e)
@@ -707,28 +707,28 @@ class DataFactory(object):
             elif stat == 'top_libraries':
                 top_libraries = []
                 try:
-                    query = 'SELECT sh.id, shm.title, shm.grandparent_title, shm.full_title, shm.year, ' \
-                            'shm.media_index, shm.parent_media_index, ' \
-                            'sh.rating_key, shm.grandparent_rating_key, shm.thumb, shm.grandparent_thumb, ' \
-                            'sh.user, sh.user_id, sh.player, sh.section_id, ' \
-                            'shm.art, sh.media_type, shm.content_rating, shm.labels, shm.live, shm.guid, ' \
-                            'ls.section_name, ls.section_type, ' \
-                            'ls.thumb AS library_thumb, ls.custom_thumb_url AS custom_thumb, ' \
-                            'ls.art AS library_art, ls.custom_art_url AS custom_art, ' \
-                            'sh.started, ' \
-                            'MAX(sh.started) AS last_watch, COUNT(sh.id) AS total_plays, SUM(sh.d) AS total_duration ' \
-                            'FROM (SELECT *, SUM(CASE WHEN stopped > 0 THEN (stopped - started) - ' \
-                            '       (CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) ELSE 0 END) ' \
-                            '       AS d ' \
-                            '   FROM session_history ' \
-                            '   WHERE session_history.stopped >= %s %s ' \
-                            '   GROUP BY %s) AS sh ' \
-                            'JOIN session_history_metadata AS shm ON shm.id = sh.id ' \
-                            'LEFT OUTER JOIN (SELECT * FROM library_sections WHERE deleted_section = 0) ' \
-                            '   AS ls ON sh.section_id = ls.section_id ' \
-                            'GROUP BY sh.section_id ' \
-                            'ORDER BY %s DESC, sh.started DESC ' \
-                            'LIMIT %s OFFSET %s ' % (timestamp, where_id, group_by, sort_type, stats_count, stats_start)
+                    query = "SELECT sh.id, shm.title, shm.grandparent_title, shm.full_title, shm.year, " \
+                            "shm.media_index, shm.parent_media_index, " \
+                            "sh.rating_key, shm.grandparent_rating_key, shm.thumb, shm.grandparent_thumb, " \
+                            "sh.user, sh.user_id, sh.player, sh.section_id, " \
+                            "shm.art, sh.media_type, shm.content_rating, shm.labels, shm.live, shm.guid, " \
+                            "ls.section_name, ls.section_type, " \
+                            "ls.thumb AS library_thumb, ls.custom_thumb_url AS custom_thumb, " \
+                            "ls.art AS library_art, ls.custom_art_url AS custom_art, " \
+                            "sh.started, " \
+                            "MAX(sh.started) AS last_watch, COUNT(sh.id) AS total_plays, SUM(sh.d) AS total_duration " \
+                            "FROM (SELECT *, SUM(CASE WHEN stopped > 0 THEN (stopped - started) - " \
+                            "       (CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) ELSE 0 END) " \
+                            "       AS d " \
+                            "   FROM session_history " \
+                            "   WHERE session_history.stopped >= %s %s " \
+                            "   GROUP BY %s) AS sh " \
+                            "JOIN session_history_metadata AS shm ON shm.id = sh.id " \
+                            "LEFT OUTER JOIN (SELECT * FROM library_sections WHERE deleted_section = 0) " \
+                            "   AS ls ON sh.section_id = ls.section_id " \
+                            "GROUP BY sh.section_id " \
+                            "ORDER BY %s DESC, sh.started DESC " \
+                            "LIMIT %s OFFSET %s " % (timestamp, where_id, group_by, sort_type, stats_count, stats_start)
                     result = monitor_db.select(query)
                 except Exception as e:
                     logger.warn("Tautulli DataFactory :: Unable to execute database query for get_home_stats: top_libraries: %s." % e)
@@ -795,28 +795,28 @@ class DataFactory(object):
             elif stat == 'top_users':
                 top_users = []
                 try:
-                    query = 'SELECT sh.id, shm.title, shm.grandparent_title, shm.full_title, shm.year, ' \
-                            'shm.media_index, shm.parent_media_index, ' \
-                            'sh.rating_key, shm.grandparent_rating_key, shm.thumb, shm.grandparent_thumb, ' \
-                            'sh.user, sh.user_id, sh.player, sh.section_id, ' \
-                            'shm.art, sh.media_type, shm.content_rating, shm.labels, shm.live, shm.guid, ' \
-                            'u.thumb AS user_thumb, u.custom_avatar_url AS custom_thumb, ' \
-                            'sh.started, ' \
-                            '(CASE WHEN u.friendly_name IS NULL OR TRIM(u.friendly_name) = ""' \
-                            '   THEN u.username ELSE u.friendly_name END) ' \
-                            '   AS friendly_name, ' \
-                            'MAX(sh.started) AS last_watch, COUNT(sh.id) AS total_plays, SUM(sh.d) AS total_duration ' \
-                            'FROM (SELECT *, SUM(CASE WHEN stopped > 0 THEN (stopped - started) - ' \
-                            '       (CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) ELSE 0 END) ' \
-                            '       AS d ' \
-                            '   FROM session_history ' \
-                            '   WHERE session_history.stopped >= %s %s ' \
-                            '   GROUP BY %s) AS sh ' \
-                            'JOIN session_history_metadata AS shm ON shm.id = sh.id ' \
-                            'LEFT OUTER JOIN users AS u ON sh.user_id = u.user_id ' \
-                            'GROUP BY sh.user_id ' \
-                            'ORDER BY %s DESC, sh.started DESC ' \
-                            'LIMIT %s OFFSET %s ' % (timestamp, where_id, group_by, sort_type, stats_count, stats_start)
+                    query = "SELECT sh.id, shm.title, shm.grandparent_title, shm.full_title, shm.year, " \
+                            "shm.media_index, shm.parent_media_index, " \
+                            "sh.rating_key, shm.grandparent_rating_key, shm.thumb, shm.grandparent_thumb, " \
+                            "sh.user, sh.user_id, sh.player, sh.section_id, " \
+                            "shm.art, sh.media_type, shm.content_rating, shm.labels, shm.live, shm.guid, " \
+                            "u.thumb AS user_thumb, u.custom_avatar_url AS custom_thumb, " \
+                            "sh.started, " \
+                            "(CASE WHEN u.friendly_name IS NULL OR TRIM(u.friendly_name) = ''" \
+                            "   THEN u.username ELSE u.friendly_name END) " \
+                            "   AS friendly_name, " \
+                            "MAX(sh.started) AS last_watch, COUNT(sh.id) AS total_plays, SUM(sh.d) AS total_duration " \
+                            "FROM (SELECT *, SUM(CASE WHEN stopped > 0 THEN (stopped - started) - " \
+                            "       (CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) ELSE 0 END) " \
+                            "       AS d " \
+                            "   FROM session_history " \
+                            "   WHERE session_history.stopped >= %s %s " \
+                            "   GROUP BY %s) AS sh " \
+                            "JOIN session_history_metadata AS shm ON shm.id = sh.id " \
+                            "LEFT OUTER JOIN users AS u ON sh.user_id = u.user_id " \
+                            "GROUP BY sh.user_id " \
+                            "ORDER BY %s DESC, sh.started DESC " \
+                            "LIMIT %s OFFSET %s " % (timestamp, where_id, group_by, sort_type, stats_count, stats_start)
                     result = monitor_db.select(query)
                 except Exception as e:
                     logger.warn("Tautulli DataFactory :: Unable to execute database query for get_home_stats: top_users: %s." % e)
@@ -873,17 +873,17 @@ class DataFactory(object):
                 top_platform = []
 
                 try:
-                    query = 'SELECT sh.platform, sh.started, ' \
-                            'MAX(sh.started) AS last_watch, COUNT(sh.id) AS total_plays, SUM(sh.d) AS total_duration ' \
-                            'FROM (SELECT *, SUM(CASE WHEN stopped > 0 THEN (stopped - started) - ' \
-                            '       (CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) ELSE 0 END) ' \
-                            '       AS d ' \
-                            '   FROM session_history ' \
-                            '   WHERE session_history.stopped >= %s %s ' \
-                            '   GROUP BY %s) AS sh ' \
-                            'GROUP BY sh.platform ' \
-                            'ORDER BY %s DESC, sh.started DESC ' \
-                            'LIMIT %s OFFSET %s ' % (timestamp, where_id, group_by, sort_type, stats_count, stats_start)
+                    query = "SELECT sh.platform, sh.started, " \
+                            "MAX(sh.started) AS last_watch, COUNT(sh.id) AS total_plays, SUM(sh.d) AS total_duration " \
+                            "FROM (SELECT *, SUM(CASE WHEN stopped > 0 THEN (stopped - started) - " \
+                            "       (CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) ELSE 0 END) " \
+                            "       AS d " \
+                            "   FROM session_history " \
+                            "   WHERE session_history.stopped >= %s %s " \
+                            "   GROUP BY %s) AS sh " \
+                            "GROUP BY sh.platform " \
+                            "ORDER BY %s DESC, sh.started DESC " \
+                            "LIMIT %s OFFSET %s " % (timestamp, where_id, group_by, sort_type, stats_count, stats_start)
                     result = monitor_db.select(query)
                 except Exception as e:
                     logger.warn("Tautulli DataFactory :: Unable to execute database query for get_home_stats: top_platforms: %s." % e)
@@ -924,65 +924,65 @@ class DataFactory(object):
 
                 if plexpy.CONFIG.WATCHED_MARKER == 1:
                     watched_threshold = (
-                        '(CASE WHEN shm.marker_credits_final IS NULL '
-                        'THEN sh._duration * (CASE WHEN sh.media_type = "movie" THEN %d ELSE %d END) / 100.0 '
-                        'ELSE shm.marker_credits_final END) '
-                        'AS watched_threshold'
+                        "(CASE WHEN shm.marker_credits_final IS NULL "
+                        "THEN sh._duration * (CASE WHEN sh.media_type = 'movie' THEN %d ELSE %d END) / 100.0 "
+                        "ELSE shm.marker_credits_final END) "
+                        "AS watched_threshold"
                     ) % (movie_watched_percent, tv_watched_percent)
-                    watched_where = '_view_offset >= watched_threshold'
+                    watched_where = "_view_offset >= watched_threshold"
                 elif plexpy.CONFIG.WATCHED_MARKER == 2:
                     watched_threshold = (
-                        '(CASE WHEN shm.marker_credits_first IS NULL '
-                        'THEN sh._duration * (CASE WHEN sh.media_type = "movie" THEN %d ELSE %d END) / 100.0 '
-                        'ELSE shm.marker_credits_first END) '
-                        'AS watched_threshold'
+                        "(CASE WHEN shm.marker_credits_first IS NULL "
+                        "THEN sh._duration * (CASE WHEN sh.media_type = 'movie' THEN %d ELSE %d END) / 100.0 "
+                        "ELSE shm.marker_credits_first END) "
+                        "AS watched_threshold"
                     ) % (movie_watched_percent, tv_watched_percent)
-                    watched_where = '_view_offset >= watched_threshold'
+                    watched_where = "_view_offset >= watched_threshold"
                 elif plexpy.CONFIG.WATCHED_MARKER == 3:
                     watched_threshold = (
-                        'MIN('
-                        '(CASE WHEN shm.marker_credits_first IS NULL '
-                        'THEN sh._duration * (CASE WHEN sh.media_type = "movie" THEN %d ELSE %d END) / 100.0 '
-                        'ELSE shm.marker_credits_first END), '
-                        'sh._duration * (CASE WHEN sh.media_type = "movie" THEN %d ELSE %d END) / 100.0) '
-                        'AS watched_threshold'
+                        "MIN("
+                        "(CASE WHEN shm.marker_credits_first IS NULL "
+                        "THEN sh._duration * (CASE WHEN sh.media_type = 'movie' THEN %d ELSE %d END) / 100.0 "
+                        "ELSE shm.marker_credits_first END), "
+                        "sh._duration * (CASE WHEN sh.media_type = 'movie' THEN %d ELSE %d END) / 100.0) "
+                        "AS watched_threshold"
                     ) % (movie_watched_percent, tv_watched_percent, movie_watched_percent, tv_watched_percent)
-                    watched_where = '_view_offset >= watched_threshold'
+                    watched_where = "_view_offset >= watched_threshold"
                 else:
-                    watched_threshold = 'NULL AS watched_threshold'
+                    watched_threshold = "NULL AS watched_threshold"
                     watched_where = (
-                        'sh.media_type == "movie" AND percent_complete >= %d '
-                        'OR sh.media_type == "episode" AND percent_complete >= %d'
+                        "sh.media_type == 'movie' AND percent_complete >= %d "
+                        "OR sh.media_type == 'episode' AND percent_complete >= %d"
                     ) % (movie_watched_percent, tv_watched_percent)
 
                 last_watched = []
                 try:
-                    query = 'SELECT sh.id, shm.title, shm.grandparent_title, shm.full_title, shm.year, ' \
-                            'shm.media_index, shm.parent_media_index, ' \
-                            'sh.rating_key, shm.grandparent_rating_key, shm.thumb, shm.grandparent_thumb, ' \
-                            'sh.user, sh.user_id, u.custom_avatar_url as user_thumb, sh.player, sh.section_id, ' \
-                            'shm.art, sh.media_type, shm.content_rating, shm.labels, shm.live, shm.guid, ' \
-                            '(CASE WHEN u.friendly_name IS NULL OR TRIM(u.friendly_name) = ""' \
-                            '   THEN u.username ELSE u.friendly_name END) ' \
-                            '   AS friendly_name, ' \
-                            'MAX(sh.started) AS last_watch, sh._view_offset, sh._duration, ' \
-                            '(sh._view_offset / sh._duration * 100) AS percent_complete, ' \
-                            '%s ' \
-                            'FROM (SELECT *, MAX(session_history.id), ' \
-                            '   (CASE WHEN view_offset IS NULL THEN 0.1 ELSE view_offset * 1.0 END) AS _view_offset, ' \
-                            '   (CASE WHEN duration IS NULL THEN 1.0 ELSE duration * 1.0 END) AS _duration ' \
-                            '   FROM session_history ' \
-                            '   JOIN session_history_metadata ON session_history_metadata.id = session_history.id ' \
-                            '   WHERE session_history.stopped >= %s ' \
-                            '       AND (session_history.media_type = "movie" ' \
-                            '           OR session_history.media_type = "episode") %s ' \
-                            '   GROUP BY %s) AS sh ' \
-                            'JOIN session_history_metadata AS shm ON shm.id = sh.id ' \
-                            'LEFT OUTER JOIN users AS u ON sh.user_id = u.user_id ' \
-                            'WHERE %s ' \
-                            'GROUP BY sh.id ' \
-                            'ORDER BY last_watch DESC ' \
-                            'LIMIT %s OFFSET %s' % (watched_threshold,
+                    query = "SELECT sh.id, shm.title, shm.grandparent_title, shm.full_title, shm.year, " \
+                            "shm.media_index, shm.parent_media_index, " \
+                            "sh.rating_key, shm.grandparent_rating_key, shm.thumb, shm.grandparent_thumb, " \
+                            "sh.user, sh.user_id, u.custom_avatar_url as user_thumb, sh.player, sh.section_id, " \
+                            "shm.art, sh.media_type, shm.content_rating, shm.labels, shm.live, shm.guid, " \
+                            "(CASE WHEN u.friendly_name IS NULL OR TRIM(u.friendly_name) = ''" \
+                            "   THEN u.username ELSE u.friendly_name END) " \
+                            "   AS friendly_name, " \
+                            "MAX(sh.started) AS last_watch, sh._view_offset, sh._duration, " \
+                            "(sh._view_offset / sh._duration * 100) AS percent_complete, " \
+                            "%s " \
+                            "FROM (SELECT *, MAX(session_history.id), " \
+                            "   (CASE WHEN view_offset IS NULL THEN 0.1 ELSE view_offset * 1.0 END) AS _view_offset, " \
+                            "   (CASE WHEN duration IS NULL THEN 1.0 ELSE duration * 1.0 END) AS _duration " \
+                            "   FROM session_history " \
+                            "   JOIN session_history_metadata ON session_history_metadata.id = session_history.id " \
+                            "   WHERE session_history.stopped >= %s " \
+                            "       AND (session_history.media_type = 'movie' " \
+                            "           OR session_history.media_type = 'episode') %s " \
+                            "   GROUP BY %s) AS sh " \
+                            "JOIN session_history_metadata AS shm ON shm.id = sh.id " \
+                            "LEFT OUTER JOIN users AS u ON sh.user_id = u.user_id " \
+                            "WHERE %s " \
+                            "GROUP BY sh.id " \
+                            "ORDER BY last_watch DESC " \
+                            "LIMIT %s OFFSET %s" % (watched_threshold,
                                                     timestamp, where_id, group_by, watched_where,
                                                     stats_count, stats_start)
                     result = monitor_db.select(query)
@@ -1068,10 +1068,10 @@ class DataFactory(object):
                 most_concurrent = []
 
                 try:
-                    base_query = 'SELECT sh.started, sh.stopped ' \
-                                 'FROM session_history AS sh ' \
-                                 'JOIN session_history_media_info AS shmi ON sh.id = shmi.id ' \
-                                 'WHERE sh.stopped >= %s ' % timestamp
+                    base_query = "SELECT sh.started, sh.stopped " \
+                                 "FROM session_history AS sh " \
+                                 "JOIN session_history_media_info AS shmi ON sh.id = shmi.id " \
+                                 "WHERE sh.stopped >= %s " % timestamp
 
                     title = 'Concurrent Streams'
                     query = base_query
@@ -1081,21 +1081,21 @@ class DataFactory(object):
 
                     title = 'Concurrent Transcodes'
                     query = base_query \
-                          + 'AND shmi.transcode_decision = "transcode" '
+                          + "AND shmi.transcode_decision = 'transcode' "
                     result = monitor_db.select(query)
                     if result:
                         most_concurrent.append(calc_most_concurrent(title, result))
 
                     title = 'Concurrent Direct Streams'
                     query = base_query \
-                          + 'AND shmi.transcode_decision = "copy" '
+                          + "AND shmi.transcode_decision = 'copy' "
                     result = monitor_db.select(query)
                     if result:
                         most_concurrent.append(calc_most_concurrent(title, result))
 
                     title = 'Concurrent Direct Plays'
                     query = base_query \
-                          + 'AND shmi.transcode_decision = "direct play" '
+                          + "AND shmi.transcode_decision = 'direct play' "
                     result = monitor_db.select(query)
                     if result:
                         most_concurrent.append(calc_most_concurrent(title, result))
@@ -1120,21 +1120,21 @@ class DataFactory(object):
         library_stats = []
 
         try:
-            query = 'SELECT ls.id, ls.section_id, ls.section_name, ls.section_type, ls.thumb AS library_thumb, ' \
-                    'ls.custom_thumb_url AS custom_thumb, ls.art AS library_art, ls.custom_art_url AS custom_art, ' \
-                    'ls.count, ls.parent_count, ls.child_count, ' \
-                    'sh.id, shm.title, shm.grandparent_title, shm.full_title, shm.year, ' \
-                    'shm.media_index, shm.parent_media_index, ' \
-                    'sh.rating_key, shm.grandparent_rating_key, shm.thumb, shm.grandparent_thumb, ' \
-                    'sh.user, sh.user_id, sh.player, ' \
-                    'shm.art, sh.media_type, shm.content_rating, shm.labels, shm.live, shm.guid, ' \
-                    'MAX(sh.started) AS last_watch ' \
-                    'FROM library_sections AS ls ' \
-                    'LEFT OUTER JOIN session_history AS sh ON ls.section_id = sh.section_id ' \
-                    'LEFT OUTER JOIN session_history_metadata AS shm ON sh.id = shm.id ' \
-                    'WHERE ls.section_id IN (%s) AND ls.deleted_section = 0 ' \
-                    'GROUP BY ls.id ' \
-                    'ORDER BY ls.section_type, ls.count DESC, ls.parent_count DESC, ls.child_count DESC ' % ','.join(library_cards)
+            query = "SELECT ls.id, ls.section_id, ls.section_name, ls.section_type, ls.thumb AS library_thumb, " \
+                    "ls.custom_thumb_url AS custom_thumb, ls.art AS library_art, ls.custom_art_url AS custom_art, " \
+                    "ls.count, ls.parent_count, ls.child_count, " \
+                    "sh.id, shm.title, shm.grandparent_title, shm.full_title, shm.year, " \
+                    "shm.media_index, shm.parent_media_index, " \
+                    "sh.rating_key, shm.grandparent_rating_key, shm.thumb, shm.grandparent_thumb, " \
+                    "sh.user, sh.user_id, sh.player, " \
+                    "shm.art, sh.media_type, shm.content_rating, shm.labels, shm.live, shm.guid, " \
+                    "MAX(sh.started) AS last_watch " \
+                    "FROM library_sections AS ls " \
+                    "LEFT OUTER JOIN session_history AS sh ON ls.section_id = sh.section_id " \
+                    "LEFT OUTER JOIN session_history_metadata AS shm ON sh.id = shm.id " \
+                    "WHERE ls.section_id IN (%s) AND ls.deleted_section = 0 " \
+                    "GROUP BY ls.id " \
+                    "ORDER BY ls.section_type, ls.count DESC, ls.parent_count DESC, ls.child_count DESC " % ",".join(library_cards)
             result = monitor_db.select(query)
         except Exception as e:
             logger.warn("Tautulli DataFactory :: Unable to execute database query for get_library_stats: %s." % e)
@@ -1228,15 +1228,15 @@ class DataFactory(object):
             try:
                 if days > 0:
                     if str(rating_key).isdigit():
-                        query = 'SELECT (SUM(stopped - started) - ' \
-                                'SUM(CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END)) AS total_time, ' \
-                                'COUNT(DISTINCT %s) AS total_plays, section_id ' \
-                                'FROM session_history ' \
-                                'JOIN session_history_metadata ON session_history_metadata.id = session_history.id ' \
-                                'WHERE stopped >= ? ' \
-                                'AND (session_history.grandparent_rating_key IN (%s) ' \
-                                'OR session_history.parent_rating_key IN (%s) ' \
-                                'OR session_history.rating_key IN (%s))' % (
+                        query = "SELECT (SUM(stopped - started) - " \
+                                "SUM(CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END)) AS total_time, " \
+                                "COUNT(DISTINCT %s) AS total_plays, section_id " \
+                                "FROM session_history " \
+                                "JOIN session_history_metadata ON session_history_metadata.id = session_history.id " \
+                                "WHERE stopped >= ? " \
+                                "AND (session_history.grandparent_rating_key IN (%s) " \
+                                "OR session_history.parent_rating_key IN (%s) " \
+                                "OR session_history.rating_key IN (%s))" % (
                                     group_by, rating_keys_arg, rating_keys_arg, rating_keys_arg
                                 )
                         
@@ -1245,14 +1245,14 @@ class DataFactory(object):
                         result = []
                 else:
                     if str(rating_key).isdigit():
-                        query = 'SELECT (SUM(stopped - started) - ' \
-                                'SUM(CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END)) AS total_time, ' \
-                                'COUNT(DISTINCT %s) AS total_plays, section_id ' \
-                                'FROM session_history ' \
-                                'JOIN session_history_metadata ON session_history_metadata.id = session_history.id ' \
-                                'WHERE (session_history.grandparent_rating_key IN (%s) ' \
-                                'OR session_history.parent_rating_key IN (%s) ' \
-                                'OR session_history.rating_key IN (%s))' % (
+                        query = "SELECT (SUM(stopped - started) - " \
+                                "SUM(CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END)) AS total_time, " \
+                                "COUNT(DISTINCT %s) AS total_plays, section_id " \
+                                "FROM session_history " \
+                                "JOIN session_history_metadata ON session_history_metadata.id = session_history.id " \
+                                "WHERE (session_history.grandparent_rating_key IN (%s) " \
+                                "OR session_history.parent_rating_key IN (%s) " \
+                                "OR session_history.rating_key IN (%s))" % (
                                     group_by, rating_keys_arg, rating_keys_arg, rating_keys_arg
                                 )
                         
@@ -1308,20 +1308,20 @@ class DataFactory(object):
 
         try:
             if str(rating_key).isdigit():
-                query = 'SELECT (CASE WHEN users.friendly_name IS NULL OR TRIM(users.friendly_name) = "" ' \
-                        'THEN users.username ELSE users.friendly_name END) AS friendly_name, ' \
-                        'users.user_id, users.username, users.thumb, users.custom_avatar_url AS custom_thumb, ' \
-                        'COUNT(DISTINCT %s) AS total_plays, (SUM(stopped - started) - ' \
-                        'SUM(CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END)) AS total_time, ' \
-                        'section_id ' \
-                        'FROM session_history ' \
-                        'JOIN session_history_metadata ON session_history_metadata.id = session_history.id ' \
-                        'JOIN users ON users.user_id = session_history.user_id ' \
-                        'WHERE (session_history.grandparent_rating_key IN (%s) ' \
-                        'OR session_history.parent_rating_key IN (%s) ' \
-                        'OR session_history.rating_key IN (%s)) ' \
-                        'GROUP BY users.user_id ' \
-                        'ORDER BY total_plays DESC, total_time DESC' % (
+                query = "SELECT (CASE WHEN users.friendly_name IS NULL OR TRIM(users.friendly_name) = '' " \
+                        "THEN users.username ELSE users.friendly_name END) AS friendly_name, " \
+                        "users.user_id, users.username, users.thumb, users.custom_avatar_url AS custom_thumb, " \
+                        "COUNT(DISTINCT %s) AS total_plays, (SUM(stopped - started) - " \
+                        "SUM(CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END)) AS total_time, " \
+                        "section_id " \
+                        "FROM session_history " \
+                        "JOIN session_history_metadata ON session_history_metadata.id = session_history.id " \
+                        "JOIN users ON users.user_id = session_history.user_id " \
+                        "WHERE (session_history.grandparent_rating_key IN (%s) " \
+                        "OR session_history.parent_rating_key IN (%s) " \
+                        "OR session_history.rating_key IN (%s)) " \
+                        "GROUP BY users.user_id " \
+                        "ORDER BY total_plays DESC, total_time DESC" % (
                             group_by, rating_keys_arg, rating_keys_arg, rating_keys_arg
                         )
 
@@ -1362,53 +1362,53 @@ class DataFactory(object):
         user_cond = ''
         table = 'session_history' if row_id else 'sessions'
         if session.get_session_user_id():
-            user_cond = 'AND %s.user_id = %s ' % (table, session.get_session_user_id())
+            user_cond = "AND %s.user_id = %s " % (table, session.get_session_user_id())
 
         if row_id:
-            query = 'SELECT bitrate, video_full_resolution, ' \
-                    'optimized_version, optimized_version_profile, optimized_version_title, ' \
-                    'synced_version, synced_version_profile, ' \
-                    'container, video_codec, video_bitrate, video_width, video_height, video_framerate, ' \
-                    'video_dynamic_range, aspect_ratio, ' \
-                    'audio_codec, audio_bitrate, audio_channels, audio_language, audio_language_code, ' \
-                    'subtitle_codec, subtitle_forced, subtitle_language, ' \
-                    'stream_bitrate, stream_video_full_resolution, quality_profile, stream_container_decision, stream_container, ' \
-                    'stream_video_decision, stream_video_codec, stream_video_bitrate, stream_video_width, stream_video_height, ' \
-                    'stream_video_framerate, stream_video_dynamic_range, ' \
-                    'stream_audio_decision, stream_audio_codec, stream_audio_bitrate, stream_audio_channels, ' \
-                    'stream_audio_language, stream_audio_language_code, ' \
-                    'subtitles, stream_subtitle_decision, stream_subtitle_codec, stream_subtitle_forced, stream_subtitle_language, ' \
-                    'transcode_hw_decoding, transcode_hw_encoding, ' \
-                    'video_decision, audio_decision, transcode_decision, width, height, container, ' \
-                    'transcode_container, transcode_video_codec, transcode_audio_codec, transcode_audio_channels, ' \
-                    'transcode_width, transcode_height, ' \
-                    'session_history_metadata.media_type, title, grandparent_title, original_title ' \
-                    'FROM session_history_media_info ' \
-                    'JOIN session_history ON session_history_media_info.id = session_history.id ' \
-                    'JOIN session_history_metadata ON session_history_media_info.id = session_history_metadata.id ' \
-                    'WHERE session_history_media_info.id = ? %s' % user_cond
+            query = "SELECT bitrate, video_full_resolution, " \
+                    "optimized_version, optimized_version_profile, optimized_version_title, " \
+                    "synced_version, synced_version_profile, " \
+                    "container, video_codec, video_bitrate, video_width, video_height, video_framerate, " \
+                    "video_dynamic_range, aspect_ratio, " \
+                    "audio_codec, audio_bitrate, audio_channels, audio_language, audio_language_code, " \
+                    "subtitle_codec, subtitle_forced, subtitle_language, " \
+                    "stream_bitrate, stream_video_full_resolution, quality_profile, stream_container_decision, stream_container, " \
+                    "stream_video_decision, stream_video_codec, stream_video_bitrate, stream_video_width, stream_video_height, " \
+                    "stream_video_framerate, stream_video_dynamic_range, " \
+                    "stream_audio_decision, stream_audio_codec, stream_audio_bitrate, stream_audio_channels, " \
+                    "stream_audio_language, stream_audio_language_code, " \
+                    "subtitles, stream_subtitle_decision, stream_subtitle_codec, stream_subtitle_forced, stream_subtitle_language, " \
+                    "transcode_hw_decoding, transcode_hw_encoding, " \
+                    "video_decision, audio_decision, transcode_decision, width, height, container, " \
+                    "transcode_container, transcode_video_codec, transcode_audio_codec, transcode_audio_channels, " \
+                    "transcode_width, transcode_height, " \
+                    "session_history_metadata.media_type, title, grandparent_title, original_title " \
+                    "FROM session_history_media_info " \
+                    "JOIN session_history ON session_history_media_info.id = session_history.id " \
+                    "JOIN session_history_metadata ON session_history_media_info.id = session_history_metadata.id " \
+                    "WHERE session_history_media_info.id = ? %s" % user_cond
             result = monitor_db.select(query, args=[row_id])
         elif session_key:
-            query = 'SELECT bitrate, video_full_resolution, ' \
-                    'optimized_version, optimized_version_profile, optimized_version_title, ' \
-                    'synced_version, synced_version_profile, ' \
-                    'container, video_codec, video_bitrate, video_width, video_height, video_framerate, ' \
-                    'video_dynamic_range, aspect_ratio, ' \
-                    'audio_codec, audio_bitrate, audio_channels, audio_language, audio_language_code, ' \
-                    'subtitle_codec, subtitle_forced, subtitle_language, ' \
-                    'stream_bitrate, stream_video_full_resolution, quality_profile, stream_container_decision, stream_container, ' \
-                    'stream_video_decision, stream_video_codec, stream_video_bitrate, stream_video_width, stream_video_height, ' \
-                    'stream_video_framerate, stream_video_dynamic_range, ' \
-                    'stream_audio_decision, stream_audio_codec, stream_audio_bitrate, stream_audio_channels, ' \
-                    'stream_audio_language, stream_audio_language_code, ' \
-                    'subtitles, stream_subtitle_decision, stream_subtitle_codec, stream_subtitle_forced, stream_subtitle_language, ' \
-                    'transcode_hw_decoding, transcode_hw_encoding, ' \
-                    'video_decision, audio_decision, transcode_decision, width, height, container, ' \
-                    'transcode_container, transcode_video_codec, transcode_audio_codec, transcode_audio_channels, ' \
-                    'transcode_width, transcode_height, ' \
-                    'media_type, title, grandparent_title, original_title ' \
-                    'FROM sessions ' \
-                    'WHERE session_key = ? %s' % user_cond
+            query = "SELECT bitrate, video_full_resolution, " \
+                    "optimized_version, optimized_version_profile, optimized_version_title, " \
+                    "synced_version, synced_version_profile, " \
+                    "container, video_codec, video_bitrate, video_width, video_height, video_framerate, " \
+                    "video_dynamic_range, aspect_ratio, " \
+                    "audio_codec, audio_bitrate, audio_channels, audio_language, audio_language_code, " \
+                    "subtitle_codec, subtitle_forced, subtitle_language, " \
+                    "stream_bitrate, stream_video_full_resolution, quality_profile, stream_container_decision, stream_container, " \
+                    "stream_video_decision, stream_video_codec, stream_video_bitrate, stream_video_width, stream_video_height, " \
+                    "stream_video_framerate, stream_video_dynamic_range, " \
+                    "stream_audio_decision, stream_audio_codec, stream_audio_bitrate, stream_audio_channels, " \
+                    "stream_audio_language, stream_audio_language_code, " \
+                    "subtitles, stream_subtitle_decision, stream_subtitle_codec, stream_subtitle_forced, stream_subtitle_language, " \
+                    "transcode_hw_decoding, transcode_hw_encoding, " \
+                    "video_decision, audio_decision, transcode_decision, width, height, container, " \
+                    "transcode_container, transcode_video_codec, transcode_audio_codec, transcode_audio_channels, " \
+                    "transcode_width, transcode_height, " \
+                    "media_type, title, grandparent_title, original_title " \
+                    "FROM sessions " \
+                    "WHERE session_key = ? %s" % user_cond
             result = monitor_db.select(query, args=[session_key])
         else:
             return None
@@ -1499,43 +1499,43 @@ class DataFactory(object):
 
         if rating_key or guid:
             if guid:
-                where = 'session_history_metadata.guid LIKE ?'
+                where = "session_history_metadata.guid LIKE ?"
                 args = [guid.split('?')[0] + '%']  # SQLite LIKE wildcard
             else:
-                where = 'session_history_metadata.rating_key = ?'
+                where = "session_history_metadata.rating_key = ?"
                 args = [rating_key]
 
-            query = 'SELECT session_history.section_id, session_history_metadata.id, ' \
-                    'session_history_metadata.rating_key, session_history_metadata.parent_rating_key, ' \
-                    'session_history_metadata.grandparent_rating_key, session_history_metadata.title, ' \
-                    'session_history_metadata.parent_title, session_history_metadata.grandparent_title, ' \
-                    'session_history_metadata.original_title, session_history_metadata.full_title, ' \
-                    'library_sections.section_name, ' \
-                    'session_history_metadata.media_index, session_history_metadata.parent_media_index, ' \
-                    'session_history_metadata.thumb, ' \
-                    'session_history_metadata.parent_thumb, session_history_metadata.grandparent_thumb, ' \
-                    'session_history_metadata.art, session_history_metadata.media_type, session_history_metadata.year, ' \
-                    'session_history_metadata.originally_available_at, session_history_metadata.added_at, ' \
-                    'session_history_metadata.updated_at, session_history_metadata.last_viewed_at, ' \
-                    'session_history_metadata.content_rating, session_history_metadata.summary, ' \
-                    'session_history_metadata.tagline, session_history_metadata.rating, session_history_metadata.duration, ' \
-                    'session_history_metadata.guid, session_history_metadata.directors, session_history_metadata.writers, ' \
-                    'session_history_metadata.actors, session_history_metadata.genres, session_history_metadata.studio, ' \
-                    'session_history_metadata.labels, ' \
-                    'session_history_media_info.container, session_history_media_info.bitrate, ' \
-                    'session_history_media_info.video_codec, session_history_media_info.video_resolution, ' \
-                    'session_history_media_info.video_full_resolution, ' \
-                    'session_history_media_info.video_framerate, session_history_media_info.audio_codec, ' \
-                    'session_history_media_info.audio_channels, session_history_metadata.live, ' \
-                    'session_history_metadata.channel_call_sign, session_history_metadata.channel_identifier, ' \
-                    'session_history_metadata.channel_thumb ' \
-                    'FROM session_history_metadata ' \
-                    'JOIN library_sections ON session_history.section_id = library_sections.section_id ' \
-                    'JOIN session_history ON session_history_metadata.id = session_history.id ' \
-                    'JOIN session_history_media_info ON session_history_metadata.id = session_history_media_info.id ' \
-                    'WHERE %s ' \
-                    'ORDER BY session_history_metadata.id DESC ' \
-                    'LIMIT 1' % where
+            query = "SELECT session_history.section_id, session_history_metadata.id, " \
+                    "session_history_metadata.rating_key, session_history_metadata.parent_rating_key, " \
+                    "session_history_metadata.grandparent_rating_key, session_history_metadata.title, " \
+                    "session_history_metadata.parent_title, session_history_metadata.grandparent_title, " \
+                    "session_history_metadata.original_title, session_history_metadata.full_title, " \
+                    "library_sections.section_name, " \
+                    "session_history_metadata.media_index, session_history_metadata.parent_media_index, " \
+                    "session_history_metadata.thumb, " \
+                    "session_history_metadata.parent_thumb, session_history_metadata.grandparent_thumb, " \
+                    "session_history_metadata.art, session_history_metadata.media_type, session_history_metadata.year, " \
+                    "session_history_metadata.originally_available_at, session_history_metadata.added_at, " \
+                    "session_history_metadata.updated_at, session_history_metadata.last_viewed_at, " \
+                    "session_history_metadata.content_rating, session_history_metadata.summary, " \
+                    "session_history_metadata.tagline, session_history_metadata.rating, session_history_metadata.duration, " \
+                    "session_history_metadata.guid, session_history_metadata.directors, session_history_metadata.writers, " \
+                    "session_history_metadata.actors, session_history_metadata.genres, session_history_metadata.studio, " \
+                    "session_history_metadata.labels, " \
+                    "session_history_media_info.container, session_history_media_info.bitrate, " \
+                    "session_history_media_info.video_codec, session_history_media_info.video_resolution, " \
+                    "session_history_media_info.video_full_resolution, " \
+                    "session_history_media_info.video_framerate, session_history_media_info.audio_codec, " \
+                    "session_history_media_info.audio_channels, session_history_metadata.live, " \
+                    "session_history_metadata.channel_call_sign, session_history_metadata.channel_identifier, " \
+                    "session_history_metadata.channel_thumb " \
+                    "FROM session_history_metadata " \
+                    "JOIN library_sections ON session_history.section_id = library_sections.section_id " \
+                    "JOIN session_history ON session_history_metadata.id = session_history.id " \
+                    "JOIN session_history_media_info ON session_history_metadata.id = session_history_media_info.id " \
+                    "WHERE %s " \
+                    "ORDER BY session_history_metadata.id DESC " \
+                    "LIMIT 1" % where
             result = monitor_db.select(query=query, args=args)
         else:
             result = []
@@ -1614,14 +1614,14 @@ class DataFactory(object):
         where, args = datatables.build_custom_where(custom_where=custom_where)
 
         try:
-            query = 'SELECT SUM(CASE WHEN stopped > 0 THEN (stopped - started) ELSE 0 END) - ' \
-                    'SUM(CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) AS total_duration, ' \
-                    '(CASE WHEN session_history_metadata.live = 1 THEN "live" ELSE session_history.media_type END) ' \
-                    'AS media_type_live ' \
-                    'FROM session_history ' \
-                    'JOIN session_history_metadata ON session_history_metadata.id = session_history.id ' \
-                    'JOIN session_history_media_info ON session_history_media_info.id = session_history.id ' \
-                    '%s ' % where
+            query = "SELECT SUM(CASE WHEN stopped > 0 THEN (stopped - started) ELSE 0 END) - " \
+                    "SUM(CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) AS total_duration, " \
+                    "(CASE WHEN session_history_metadata.live = 1 THEN 'live' ELSE session_history.media_type END) " \
+                    "AS media_type_live " \
+                    "FROM session_history " \
+                    "JOIN session_history_metadata ON session_history_metadata.id = session_history.id " \
+                    "JOIN session_history_media_info ON session_history_media_info.id = session_history.id " \
+                    "%s " % where
             result = monitor_db.select(query, args=args)
         except Exception as e:
             logger.warn("Tautulli DataFactory :: Unable to execute database query for get_total_duration: %s." % e)
@@ -1644,7 +1644,7 @@ class DataFactory(object):
 
         if session_key:
             try:
-                query = 'SELECT ip_address FROM sessions WHERE session_key = %d %s' % (int(session_key), user_cond)
+                query = "SELECT ip_address FROM sessions WHERE session_key = %d %s" % (int(session_key), user_cond)
                 result = monitor_db.select(query)
             except Exception as e:
                 logger.warn("Tautulli DataFactory :: Unable to execute database query for get_session_ip: %s." % e)
@@ -1694,19 +1694,19 @@ class DataFactory(object):
 
         where = ''
         if where_params:
-            where = 'WHERE ' + ' AND '.join([w + ' = ?' for w in where_params])
+            where = "WHERE " + " AND ".join([w + " = ?" for w in where_params])
 
         if order_by:
-            order_by = 'ORDER BY ' + order_by + ' DESC'
+            order_by = "ORDER BY " + order_by + " DESC"
 
         if service == 'imgur':
-            query = 'SELECT imgur_title AS img_title, imgur_url AS img_url FROM imgur_lookup ' \
-                    'JOIN image_hash_lookup ON imgur_lookup.img_hash = image_hash_lookup.img_hash ' \
-                    '%s %s' % (where, order_by)
+            query = "SELECT imgur_title AS img_title, imgur_url AS img_url FROM imgur_lookup " \
+                    "JOIN image_hash_lookup ON imgur_lookup.img_hash = image_hash_lookup.img_hash " \
+                    "%s %s" % (where, order_by)
         elif service == 'cloudinary':
-            query = 'SELECT cloudinary_title AS img_title, cloudinary_url AS img_url FROM cloudinary_lookup ' \
-                    'JOIN image_hash_lookup ON cloudinary_lookup.img_hash = image_hash_lookup.img_hash ' \
-                    '%s %s' % (where, order_by)
+            query = "SELECT cloudinary_title AS img_title, cloudinary_url AS img_url FROM cloudinary_lookup " \
+                    "JOIN image_hash_lookup ON cloudinary_lookup.img_hash = image_hash_lookup.img_hash " \
+                    "%s %s" % (where, order_by)
         else:
             logger.warn("Tautulli DataFactory :: Unable to execute database query for get_img_info: "
                         "service not provided.")
@@ -1754,14 +1754,14 @@ class DataFactory(object):
         args = []
         log_msg = ''
         if rating_key:
-            where = 'WHERE rating_key = ?'
+            where = "WHERE rating_key = ?"
             args = [rating_key]
             log_msg = ' for rating_key %s' % rating_key
 
         if service.lower() == 'imgur':
             # Delete from Imgur
-            query = 'SELECT imgur_title, delete_hash, fallback FROM imgur_lookup ' \
-                    'JOIN image_hash_lookup ON imgur_lookup.img_hash = image_hash_lookup.img_hash %s' % where
+            query = "SELECT imgur_title, delete_hash, fallback FROM imgur_lookup " \
+                    "JOIN image_hash_lookup ON imgur_lookup.img_hash = image_hash_lookup.img_hash %s" % where
             results = monitor_db.select(query, args=args)
 
             for imgur_info in results:
@@ -1772,15 +1772,15 @@ class DataFactory(object):
 
             logger.info("Tautulli DataFactory :: Deleting Imgur info%s from the database."
                         % log_msg)
-            result = monitor_db.action('DELETE FROM imgur_lookup WHERE img_hash '
-                                       'IN (SELECT img_hash FROM image_hash_lookup %s)' % where,
+            result = monitor_db.action("DELETE FROM imgur_lookup WHERE img_hash "
+                                       "IN (SELECT img_hash FROM image_hash_lookup %s)" % where,
                                        args)
 
         elif service.lower() == 'cloudinary':
             # Delete from Cloudinary
-            query = 'SELECT cloudinary_title, rating_key, fallback FROM cloudinary_lookup ' \
-                    'JOIN image_hash_lookup ON cloudinary_lookup.img_hash = image_hash_lookup.img_hash %s ' \
-                    'GROUP BY rating_key' % where
+            query = "SELECT cloudinary_title, rating_key, fallback FROM cloudinary_lookup " \
+                    "JOIN image_hash_lookup ON cloudinary_lookup.img_hash = image_hash_lookup.img_hash %s " \
+                    "GROUP BY rating_key" % where
             results = monitor_db.select(query, args=args)
 
             if delete_all:
@@ -1791,8 +1791,8 @@ class DataFactory(object):
 
             logger.info("Tautulli DataFactory :: Deleting Cloudinary info%s from the database."
                         % log_msg)
-            result = monitor_db.action('DELETE FROM cloudinary_lookup WHERE img_hash '
-                                       'IN (SELECT img_hash FROM image_hash_lookup %s)' % where,
+            result = monitor_db.action("DELETE FROM cloudinary_lookup WHERE img_hash "
+                                       "IN (SELECT img_hash FROM image_hash_lookup %s)" % where,
                                        args)
 
         else:
@@ -1883,15 +1883,15 @@ class DataFactory(object):
         if rating_key:
             logger.info("Tautulli DataFactory :: Deleting lookup info for rating_key %s from the database."
                         % rating_key)
-            result_themoviedb = monitor_db.action('DELETE FROM themoviedb_lookup WHERE rating_key = ?', [rating_key])
-            result_tvmaze = monitor_db.action('DELETE FROM tvmaze_lookup WHERE rating_key = ?', [rating_key])
-            result_musicbrainz = monitor_db.action('DELETE FROM musicbrainz_lookup WHERE rating_key = ?', [rating_key])
+            result_themoviedb = monitor_db.action("DELETE FROM themoviedb_lookup WHERE rating_key = ?", [rating_key])
+            result_tvmaze = monitor_db.action("DELETE FROM tvmaze_lookup WHERE rating_key = ?", [rating_key])
+            result_musicbrainz = monitor_db.action("DELETE FROM musicbrainz_lookup WHERE rating_key = ?", [rating_key])
             return bool(result_themoviedb or result_tvmaze or result_musicbrainz)
         elif service and delete_all:
             if service.lower() in ('themoviedb', 'tvmaze', 'musicbrainz'):
                 logger.info("Tautulli DataFactory :: Deleting all lookup info for '%s' from the database."
                             % service)
-                result = monitor_db.action('DELETE FROM %s_lookup' % service.lower())
+                result = monitor_db.action("DELETE FROM %s_lookup" % service.lower())
                 return bool(result)
             else:
                 logger.error("Tautulli DataFactory :: Unable to delete lookup info: invalid service '%s' provided."
@@ -1901,13 +1901,13 @@ class DataFactory(object):
         monitor_db = database.MonitorDatabase()
 
         if rating_key:
-            query = 'SELECT rating_key, parent_rating_key, grandparent_rating_key, title, parent_title, grandparent_title, ' \
-                    'media_index, parent_media_index, year, media_type ' \
-                    'FROM session_history_metadata ' \
-                    'WHERE rating_key = ? ' \
-                    'OR parent_rating_key = ? ' \
-                    'OR grandparent_rating_key = ? ' \
-                    'LIMIT 1'
+            query = "SELECT rating_key, parent_rating_key, grandparent_rating_key, title, parent_title, grandparent_title, " \
+                    "media_index, parent_media_index, year, media_type " \
+                    "FROM session_history_metadata " \
+                    "WHERE rating_key = ? " \
+                    "OR parent_rating_key = ? " \
+                    "OR grandparent_rating_key = ? " \
+                    "LIMIT 1"
             result = monitor_db.select(query=query, args=[rating_key, rating_key, rating_key])
         else:
             result = []
@@ -1974,12 +1974,12 @@ class DataFactory(object):
 
         # Get the grandparent rating key
         try:
-            query = 'SELECT rating_key, parent_rating_key, grandparent_rating_key ' \
-                    'FROM session_history_metadata ' \
-                    'WHERE rating_key = ? ' \
-                    'OR parent_rating_key = ? ' \
-                    'OR grandparent_rating_key = ? ' \
-                    'LIMIT 1'
+            query = "SELECT rating_key, parent_rating_key, grandparent_rating_key " \
+                    "FROM session_history_metadata " \
+                    "WHERE rating_key = ? " \
+                    "OR parent_rating_key = ? " \
+                    "OR grandparent_rating_key = ? " \
+                    "LIMIT 1"
             result = monitor_db.select(query=query, args=[rating_key, rating_key, rating_key])
 
             grandparent_rating_key = result[0]['grandparent_rating_key']
@@ -1988,12 +1988,12 @@ class DataFactory(object):
             logger.warn("Tautulli DataFactory :: Unable to execute database query for get_rating_keys_list: %s." % e)
             return {}
 
-        query = 'SELECT rating_key, parent_rating_key, grandparent_rating_key, title, parent_title, grandparent_title, ' \
-                'media_index, parent_media_index ' \
-                'FROM session_history_metadata ' \
-                'WHERE {0} = ? ' \
-                'GROUP BY {1} ' \
-                'ORDER BY {1} DESC '
+        query = "SELECT rating_key, parent_rating_key, grandparent_rating_key, title, parent_title, grandparent_title, " \
+                "media_index, parent_media_index " \
+                "FROM session_history_metadata " \
+                "WHERE {0} = ? " \
+                "GROUP BY {1} " \
+                "ORDER BY {1} DESC "
 
         # get grandparent_rating_keys
         grandparents = {}
@@ -2070,13 +2070,13 @@ class DataFactory(object):
                     if metadata['media_type'] == 'show' or metadata['media_type'] == 'artist':
                         # check grandparent_rating_key (2 tables)
                         query = (
-                            'SELECT id FROM session_history '
-                            'WHERE grandparent_rating_key = ? '
+                            "SELECT id FROM session_history "
+                            "WHERE grandparent_rating_key = ? "
                         )
                         args = [old_key]
 
                         if _UPDATE_METADATA_IDS['grandparent_rating_key_ids']:
-                            query += 'AND id NOT IN (%s)' % ','.join(_UPDATE_METADATA_IDS['grandparent_rating_key_ids'])
+                            query += "AND id NOT IN (%s)" % ",".join(_UPDATE_METADATA_IDS['grandparent_rating_key_ids'])
 
                         ids = [str(row['id']) for row in monitor_db.select(query, args)]
                         if ids:
@@ -2085,26 +2085,26 @@ class DataFactory(object):
                             continue
 
                         monitor_db.action(
-                            'UPDATE session_history SET grandparent_rating_key = ? '
-                            'WHERE id IN (%s)' % ','.join(ids),
+                            "UPDATE session_history SET grandparent_rating_key = ? "
+                            "WHERE id IN (%s)" % ",".join(ids),
                             [new_key]
                         )
                         monitor_db.action(
-                            'UPDATE session_history_metadata SET grandparent_rating_key = ? '
-                            'WHERE id IN (%s)' % ','.join(ids),
+                            "UPDATE session_history_metadata SET grandparent_rating_key = ? "
+                            "WHERE id IN (%s)" % ",".join(ids),
                             [new_key]
                         )
 
                     elif metadata['media_type'] == 'season' or metadata['media_type'] == 'album':
                         # check parent_rating_key (2 tables)
                         query = (
-                            'SELECT id FROM session_history '
-                            'WHERE parent_rating_key = ? '
+                            "SELECT id FROM session_history "
+                            "WHERE parent_rating_key = ? "
                         )
                         args = [old_key]
 
                         if _UPDATE_METADATA_IDS['parent_rating_key_ids']:
-                            query += 'AND id NOT IN (%s)' % ','.join(_UPDATE_METADATA_IDS['parent_rating_key_ids'])
+                            query += "AND id NOT IN (%s)" % ",".join(_UPDATE_METADATA_IDS['parent_rating_key_ids'])
 
                         ids = [str(row['id']) for row in monitor_db.select(query, args)]
                         if ids:
@@ -2113,26 +2113,26 @@ class DataFactory(object):
                             continue
 
                         monitor_db.action(
-                            'UPDATE session_history SET parent_rating_key = ? '
-                            'WHERE id IN (%s)' % ','.join(ids),
+                            "UPDATE session_history SET parent_rating_key = ? "
+                            "WHERE id IN (%s)" % ",".join(ids),
                             [new_key]
                         )
                         monitor_db.action(
-                            'UPDATE session_history_metadata SET parent_rating_key = ? '
-                            'WHERE id IN (%s)' % ','.join(ids),
+                            "UPDATE session_history_metadata SET parent_rating_key = ? "
+                            "WHERE id IN (%s)" % ",".join(ids),
                             [new_key]
                         )
 
                     else:
                         # check rating_key (2 tables)
                         query = (
-                            'SELECT id FROM session_history '
-                            'WHERE rating_key = ? '
+                            "SELECT id FROM session_history "
+                            "WHERE rating_key = ? "
                         )
                         args = [old_key]
 
                         if _UPDATE_METADATA_IDS['rating_key_ids']:
-                            query += 'AND id NOT IN (%s)' % ','.join(_UPDATE_METADATA_IDS['rating_key_ids'])
+                            query += "AND id NOT IN (%s)" % ",".join(_UPDATE_METADATA_IDS['rating_key_ids'])
 
                         ids = [str(row['id']) for row in monitor_db.select(query, args)]
                         if ids:
@@ -2141,13 +2141,13 @@ class DataFactory(object):
                             continue
 
                         monitor_db.action(
-                            'UPDATE session_history SET rating_key = ? '
-                            'WHERE id IN (%s)' % ','.join(ids),
+                            "UPDATE session_history SET rating_key = ? "
+                            "WHERE id IN (%s)" % ",".join(ids),
                             [new_key]
                         )
                         monitor_db.action(
-                            'UPDATE session_history_media_info SET rating_key = ? '
-                            'WHERE id IN (%s)' % ','.join(ids),
+                            "UPDATE session_history_media_info SET rating_key = ? "
+                            "WHERE id IN (%s)" % ",".join(ids),
                             [new_key]
                         )
 
@@ -2181,21 +2181,21 @@ class DataFactory(object):
 
             monitor_db = database.MonitorDatabase()
 
-            query = 'UPDATE session_history SET section_id = ? ' \
-                    'WHERE id IN (%s)' % ','.join(ids)
+            query = "UPDATE session_history SET section_id = ? " \
+                    "WHERE id IN (%s)" % ",".join(ids)
             args = [metadata['section_id']]
             monitor_db.action(query=query, args=args)
 
             # Update the session_history_metadata table
-            query = 'UPDATE session_history_metadata SET rating_key = ?, parent_rating_key = ?, ' \
-                    'grandparent_rating_key = ?, title = ?, parent_title = ?, grandparent_title = ?, ' \
-                    'original_title = ?, full_title = ?, ' \
-                    'media_index = ?, parent_media_index = ?, thumb = ?, parent_thumb = ?, ' \
-                    'grandparent_thumb = ?, art = ?, media_type = ?, year = ?, originally_available_at = ?, ' \
-                    'added_at = ?, updated_at = ?, last_viewed_at = ?, content_rating = ?, summary = ?, ' \
-                    'tagline = ?, rating = ?, duration = ?, guid = ?, directors = ?, writers = ?, actors = ?, ' \
-                    'genres = ?, studio = ?, labels = ? ' \
-                    'WHERE id IN (%s)' % ','.join(ids)
+            query = "UPDATE session_history_metadata SET rating_key = ?, parent_rating_key = ?, " \
+                    "grandparent_rating_key = ?, title = ?, parent_title = ?, grandparent_title = ?, " \
+                    "original_title = ?, full_title = ?, " \
+                    "media_index = ?, parent_media_index = ?, thumb = ?, parent_thumb = ?, " \
+                    "grandparent_thumb = ?, art = ?, media_type = ?, year = ?, originally_available_at = ?, " \
+                    "added_at = ?, updated_at = ?, last_viewed_at = ?, content_rating = ?, summary = ?, " \
+                    "tagline = ?, rating = ?, duration = ?, guid = ?, directors = ?, writers = ?, actors = ?, " \
+                    "genres = ?, studio = ?, labels = ? " \
+                    "WHERE id IN (%s)" % ",".join(ids)
 
             args = [metadata['rating_key'], metadata['parent_rating_key'], metadata['grandparent_rating_key'],
                     metadata['title'], metadata['parent_title'], metadata['grandparent_title'],
@@ -2212,19 +2212,19 @@ class DataFactory(object):
     def get_notification_log(self, kwargs=None):
         data_tables = datatables.DataTables()
 
-        columns = ['notify_log.id',
-                   'notify_log.timestamp',
-                   'notify_log.session_key',
-                   'notify_log.rating_key',
-                   'notify_log.user_id',
-                   'notify_log.user',
-                   'notify_log.notifier_id',
-                   'notify_log.agent_id',
-                   'notify_log.agent_name',
-                   'notify_log.notify_action',
-                   'notify_log.subject_text',
-                   'notify_log.body_text',
-                   'notify_log.success'
+        columns = ["notify_log.id",
+                   "notify_log.timestamp",
+                   "notify_log.session_key",
+                   "notify_log.rating_key",
+                   "notify_log.user_id",
+                   "notify_log.user",
+                   "notify_log.notifier_id",
+                   "notify_log.agent_id",
+                   "notify_log.agent_name",
+                   "notify_log.notify_action",
+                   "notify_log.subject_text",
+                   "notify_log.body_text",
+                   "notify_log.success"
                    ]
         try:
             query = data_tables.ssp_query(table_name='notify_log',
@@ -2281,8 +2281,8 @@ class DataFactory(object):
 
         try:
             logger.info("Tautulli DataFactory :: Clearing notification logs from database.")
-            monitor_db.action('DELETE FROM notify_log')
-            monitor_db.action('VACUUM')
+            monitor_db.action("DELETE FROM notify_log")
+            monitor_db.action("VACUUM")
             return True
         except Exception as e:
             logger.warn("Tautulli DataFactory :: Unable to execute database query for delete_notification_log: %s." % e)
@@ -2291,18 +2291,18 @@ class DataFactory(object):
     def get_newsletter_log(self, kwargs=None):
         data_tables = datatables.DataTables()
 
-        columns = ['newsletter_log.id',
-                   'newsletter_log.timestamp',
-                   'newsletter_log.newsletter_id',
-                   'newsletter_log.agent_id',
-                   'newsletter_log.agent_name',
-                   'newsletter_log.notify_action',
-                   'newsletter_log.subject_text',
-                   'newsletter_log.body_text',
-                   'newsletter_log.start_date',
-                   'newsletter_log.end_date',
-                   'newsletter_log.uuid',
-                   'newsletter_log.success'
+        columns = ["newsletter_log.id",
+                   "newsletter_log.timestamp",
+                   "newsletter_log.newsletter_id",
+                   "newsletter_log.agent_id",
+                   "newsletter_log.agent_name",
+                   "newsletter_log.notify_action",
+                   "newsletter_log.subject_text",
+                   "newsletter_log.body_text",
+                   "newsletter_log.start_date",
+                   "newsletter_log.end_date",
+                   "newsletter_log.uuid",
+                   "newsletter_log.success"
                    ]
         try:
             query = data_tables.ssp_query(table_name='newsletter_log',
@@ -2353,8 +2353,8 @@ class DataFactory(object):
 
         try:
             logger.info("Tautulli DataFactory :: Clearing newsletter logs from database.")
-            monitor_db.action('DELETE FROM newsletter_log')
-            monitor_db.action('VACUUM')
+            monitor_db.action("DELETE FROM newsletter_log")
+            monitor_db.action("VACUUM")
             return True
         except Exception as e:
             logger.warn("Tautulli DataFactory :: Unable to execute database query for delete_newsletter_log: %s." % e)
@@ -2365,15 +2365,15 @@ class DataFactory(object):
 
         if user_id:
             if history_only:
-                query = 'SELECT machine_id FROM session_history ' \
-                        'WHERE user_id = ? ' \
-                        'GROUP BY machine_id'
+                query = "SELECT machine_id FROM session_history " \
+                        "WHERE user_id = ? " \
+                        "GROUP BY machine_id"
             else:
-                query = 'SELECT * FROM (' \
-                        'SELECT user_id, machine_id FROM session_history ' \
-                        'UNION SELECT user_id, machine_id from sessions_continued) ' \
-                        'WHERE user_id = ? ' \
-                        'GROUP BY machine_id'
+                query = "SELECT * FROM (" \
+                        "SELECT user_id, machine_id FROM session_history " \
+                        "UNION SELECT user_id, machine_id from sessions_continued) " \
+                        "WHERE user_id = ? " \
+                        "GROUP BY machine_id"
 
             try:
                 result = monitor_db.select(query=query, args=[user_id])
@@ -2390,7 +2390,7 @@ class DataFactory(object):
 
         if rating_key:
             try:
-                query = 'SELECT * FROM recently_added WHERE rating_key = ?'
+                query = "SELECT * FROM recently_added WHERE rating_key = ?"
                 result = monitor_db.select(query=query, args=[rating_key])
             except Exception as e:
                 logger.warn("Tautulli DataFactory :: Unable to execute database query for get_recently_added_item: %s." % e)
diff --git a/plexpy/exporter.py b/plexpy/exporter.py
index 908aced7..3a48c6d7 100644
--- a/plexpy/exporter.py
+++ b/plexpy/exporter.py
@@ -2291,9 +2291,9 @@ class ExportObject(Export):
 
 def get_export(export_id):
     db = database.MonitorDatabase()
-    result = db.select_single('SELECT timestamp, title, file_format, thumb_level, art_level, '
-                              'individual_files, complete '
-                              'FROM exports WHERE id = ?',
+    result = db.select_single("SELECT timestamp, title, file_format, thumb_level, art_level, "
+                              "individual_files, complete "
+                              "FROM exports WHERE id = ?",
                               [export_id])
 
     if result:
@@ -2324,7 +2324,7 @@ def delete_export(export_id):
         if deleted:
             logger.info("Tautulli Exporter :: Deleting export_id %s from the database.", export_id)
             db = database.MonitorDatabase()
-            result = db.action('DELETE FROM exports WHERE id = ?', args=[export_id])
+            result = db.action("DELETE FROM exports WHERE id = ?", args=[export_id])
 
         return deleted
     else:
@@ -2349,7 +2349,7 @@ def delete_all_exports():
 
 def cancel_exports():
     db = database.MonitorDatabase()
-    db.action('UPDATE exports SET complete = -1 WHERE complete = 0')
+    db.action("UPDATE exports SET complete = -1 WHERE complete = 0")
 
 
 def get_export_datatable(section_id=None, user_id=None, rating_key=None, kwargs=None):
@@ -2368,27 +2368,27 @@ def get_export_datatable(section_id=None, user_id=None, rating_key=None, kwargs=
     if rating_key:
         custom_where.append(['exports.rating_key', rating_key])
 
-    columns = ['exports.id AS export_id',
-               'exports.timestamp',
-               'exports.section_id',
-               'exports.user_id',
-               'exports.rating_key',
-               'exports.media_type',
-               'CASE WHEN exports.media_type = "photoalbum" THEN "Photo Album" ELSE '
-               'UPPER(SUBSTR(exports.media_type, 1, 1)) || SUBSTR(exports.media_type, 2) END '
-               'AS media_type_title',
-               'exports.title',
-               'exports.file_format',
-               'exports.metadata_level',
-               'exports.media_info_level',
-               'exports.thumb_level',
-               'exports.art_level',
-               'exports.custom_fields',
-               'exports.individual_files',
-               'exports.file_size',
-               'exports.complete',
-               'exports.total_items',
-               'exports.exported_items'
+    columns = ["exports.id AS export_id",
+               "exports.timestamp",
+               "exports.section_id",
+               "exports.user_id",
+               "exports.rating_key",
+               "exports.media_type",
+               "CASE WHEN exports.media_type = 'photoalbum' THEN 'Photo Album' ELSE "
+               "UPPER(SUBSTR(exports.media_type, 1, 1)) || SUBSTR(exports.media_type, 2) END "
+               "AS media_type_title",
+               "exports.title",
+               "exports.file_format",
+               "exports.metadata_level",
+               "exports.media_info_level",
+               "exports.thumb_level",
+               "exports.art_level",
+               "exports.custom_fields",
+               "exports.individual_files",
+               "exports.file_size",
+               "exports.complete",
+               "exports.total_items",
+               "exports.exported_items"
                ]
     try:
         query = data_tables.ssp_query(table_name='exports',
diff --git a/plexpy/graphs.py b/plexpy/graphs.py
index e9afa704..49dfee57 100644
--- a/plexpy/graphs.py
+++ b/plexpy/graphs.py
@@ -64,42 +64,42 @@ class Graphs(object):
 
         try:
             if y_axis == 'plays':
-                query = 'SELECT sh.date_played, ' \
-                        'SUM(CASE WHEN sh.media_type = "episode" AND shm.live = 0 THEN 1 ELSE 0 END) AS tv_count, ' \
-                        'SUM(CASE WHEN sh.media_type = "movie" AND shm.live = 0 THEN 1 ELSE 0 END) AS movie_count, ' \
-                        'SUM(CASE WHEN sh.media_type = "track" AND shm.live = 0 THEN 1 ELSE 0 END) AS music_count, ' \
-                        'SUM(shm.live) AS live_count ' \
-                        'FROM (SELECT *,' \
-                        '      date(started, "unixepoch", "localtime") AS date_played ' \
-                        '    FROM session_history ' \
-                        '    WHERE session_history.stopped >= %s %s ' \
-                        '    GROUP BY date_played, %s) AS sh ' \
-                        'JOIN session_history_metadata AS shm ON shm.id = sh.id ' \
-                        'GROUP BY sh.date_played ' \
-                        'ORDER BY sh.started' % (timestamp, user_cond, group_by)
+                query = "SELECT sh.date_played, " \
+                        "SUM(CASE WHEN sh.media_type = 'episode' AND shm.live = 0 THEN 1 ELSE 0 END) AS tv_count, " \
+                        "SUM(CASE WHEN sh.media_type = 'movie' AND shm.live = 0 THEN 1 ELSE 0 END) AS movie_count, " \
+                        "SUM(CASE WHEN sh.media_type = 'track' AND shm.live = 0 THEN 1 ELSE 0 END) AS music_count, " \
+                        "SUM(shm.live) AS live_count " \
+                        "FROM (SELECT *," \
+                        "      date(started, 'unixepoch', 'localtime') AS date_played " \
+                        "    FROM session_history " \
+                        "    WHERE session_history.stopped >= %s %s " \
+                        "    GROUP BY date_played, %s) AS sh " \
+                        "JOIN session_history_metadata AS shm ON shm.id = sh.id " \
+                        "GROUP BY sh.date_played " \
+                        "ORDER BY sh.started" % (timestamp, user_cond, group_by)
 
                 result = monitor_db.select(query)
             else:
-                query = 'SELECT sh.date_played, ' \
-                        'SUM(CASE WHEN sh.media_type = "episode" AND shm.live = 0 ' \
-                        '  THEN sh.d ELSE 0 END) AS tv_count, ' \
-                        'SUM(CASE WHEN sh.media_type = "movie" AND shm.live = 0 ' \
-                        '  THEN sh.d ELSE 0 END) AS movie_count, ' \
-                        'SUM(CASE WHEN sh.media_type = "track" AND shm.live = 0 ' \
-                        '  THEN sh.d ELSE 0 END) AS music_count, ' \
-                        'SUM(CASE WHEN shm.live = 1 ' \
-                        '  THEN sh.d ELSE 0 END) AS live_count ' \
-                        'FROM (SELECT *,' \
-                        '      date(started, "unixepoch", "localtime") AS date_played,' \
-                        '      SUM(CASE WHEN stopped > 0 THEN (stopped - started) - ' \
-                        '        (CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) ELSE 0 END) ' \
-                        '        AS d ' \
-                        '    FROM session_history ' \
-                        '    WHERE session_history.stopped >= %s %s' \
-                        '    GROUP BY date_played, %s) AS sh ' \
-                        'JOIN session_history_metadata AS shm ON shm.id = sh.id ' \
-                        'GROUP BY sh.date_played ' \
-                        'ORDER BY sh.started' % (timestamp, user_cond, group_by)
+                query = "SELECT sh.date_played, " \
+                        "SUM(CASE WHEN sh.media_type = 'episode' AND shm.live = 0 " \
+                        "  THEN sh.d ELSE 0 END) AS tv_count, " \
+                        "SUM(CASE WHEN sh.media_type = 'movie' AND shm.live = 0 " \
+                        "  THEN sh.d ELSE 0 END) AS movie_count, " \
+                        "SUM(CASE WHEN sh.media_type = 'track' AND shm.live = 0 " \
+                        "  THEN sh.d ELSE 0 END) AS music_count, " \
+                        "SUM(CASE WHEN shm.live = 1 " \
+                        "  THEN sh.d ELSE 0 END) AS live_count " \
+                        "FROM (SELECT *," \
+                        "      date(started, 'unixepoch', 'localtime') AS date_played," \
+                        "      SUM(CASE WHEN stopped > 0 THEN (stopped - started) - " \
+                        "        (CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) ELSE 0 END) " \
+                        "        AS d " \
+                        "    FROM session_history " \
+                        "    WHERE session_history.stopped >= %s %s" \
+                        "    GROUP BY date_played, %s) AS sh " \
+                        "JOIN session_history_metadata AS shm ON shm.id = sh.id " \
+                        "GROUP BY sh.date_played " \
+                        "ORDER BY sh.started" % (timestamp, user_cond, group_by)
 
                 result = monitor_db.select(query)
         except Exception as e:
@@ -173,9 +173,9 @@ class Graphs(object):
 
         user_cond = ''
         if session.get_session_user_id() and user_id and user_id != str(session.get_session_user_id()):
-            user_cond = 'AND session_history.user_id = %s ' % session.get_session_user_id()
+            user_cond = "AND session_history.user_id = %s " % session.get_session_user_id()
         elif user_id and user_id.isdigit():
-            user_cond = 'AND session_history.user_id = %s ' % user_id
+            user_cond = "AND session_history.user_id = %s " % user_id
 
         if grouping is None:
             grouping = plexpy.CONFIG.GROUP_HISTORY_TABLES
@@ -184,58 +184,58 @@ class Graphs(object):
 
         try:
             if y_axis == 'plays':
-                query = 'SELECT sh.daynumber, ' \
-                        '(CASE sh.daynumber ' \
-                        '  WHEN 0 THEN "Sunday" ' \
-                        '  WHEN 1 THEN "Monday" ' \
-                        '  WHEN 2 THEN "Tuesday" ' \
-                        '  WHEN 3 THEN "Wednesday" ' \
-                        '  WHEN 4 THEN "Thursday" ' \
-                        '  WHEN 5 THEN "Friday" ' \
-                        '  ELSE "Saturday" END) AS dayofweek, ' \
-                        'SUM(CASE WHEN sh.media_type = "episode" AND shm.live = 0 THEN 1 ELSE 0 END) AS tv_count, ' \
-                        'SUM(CASE WHEN sh.media_type = "movie" AND shm.live = 0 THEN 1 ELSE 0 END) AS movie_count, ' \
-                        'SUM(CASE WHEN sh.media_type = "track" AND shm.live = 0 THEN 1 ELSE 0 END) AS music_count, ' \
-                        'SUM(shm.live) AS live_count ' \
-                        'FROM (SELECT *, ' \
-                        '      CAST(strftime("%%w", date(started, "unixepoch", "localtime")) AS INTEGER) AS daynumber' \
-                        '    FROM session_history ' \
-                        '    WHERE session_history.stopped >= %s %s ' \
-                        '    GROUP BY daynumber, %s) AS sh ' \
-                        'JOIN session_history_metadata AS shm ON shm.id = sh.id ' \
-                        'GROUP BY dayofweek ' \
-                        'ORDER BY sh.daynumber' % (timestamp, user_cond, group_by)
+                query = "SELECT sh.daynumber, " \
+                        "(CASE sh.daynumber " \
+                        "  WHEN 0 THEN 'Sunday' " \
+                        "  WHEN 1 THEN 'Monday' " \
+                        "  WHEN 2 THEN 'Tuesday' " \
+                        "  WHEN 3 THEN 'Wednesday' " \
+                        "  WHEN 4 THEN 'Thursday' " \
+                        "  WHEN 5 THEN 'Friday' " \
+                        "  ELSE 'Saturday' END) AS dayofweek, " \
+                        "SUM(CASE WHEN sh.media_type = 'episode' AND shm.live = 0 THEN 1 ELSE 0 END) AS tv_count, " \
+                        "SUM(CASE WHEN sh.media_type = 'movie' AND shm.live = 0 THEN 1 ELSE 0 END) AS movie_count, " \
+                        "SUM(CASE WHEN sh.media_type = 'track' AND shm.live = 0 THEN 1 ELSE 0 END) AS music_count, " \
+                        "SUM(shm.live) AS live_count " \
+                        "FROM (SELECT *, " \
+                        "      CAST(strftime('%%w', date(started, 'unixepoch', 'localtime')) AS INTEGER) AS daynumber" \
+                        "    FROM session_history " \
+                        "    WHERE session_history.stopped >= %s %s " \
+                        "    GROUP BY daynumber, %s) AS sh " \
+                        "JOIN session_history_metadata AS shm ON shm.id = sh.id " \
+                        "GROUP BY dayofweek " \
+                        "ORDER BY sh.daynumber" % (timestamp, user_cond, group_by)
 
                 result = monitor_db.select(query)
             else:
-                query = 'SELECT sh.daynumber, ' \
-                        '(CASE sh.daynumber ' \
-                        '  WHEN 0 THEN "Sunday" ' \
-                        '  WHEN 1 THEN "Monday" ' \
-                        '  WHEN 2 THEN "Tuesday" ' \
-                        '  WHEN 3 THEN "Wednesday" ' \
-                        '  WHEN 4 THEN "Thursday" ' \
-                        '  WHEN 5 THEN "Friday" ' \
-                        '  ELSE "Saturday" END) AS dayofweek, ' \
-                        'SUM(CASE WHEN sh.media_type = "episode" AND shm.live = 0 ' \
-                        '  THEN sh.d ELSE 0 END) AS tv_count, ' \
-                        'SUM(CASE WHEN sh.media_type = "movie" AND shm.live = 0 ' \
-                        '  THEN sh.d ELSE 0 END) AS movie_count, ' \
-                        'SUM(CASE WHEN sh.media_type = "track" AND shm.live = 0 ' \
-                        '  THEN sh.d ELSE 0 END) AS music_count, ' \
-                        'SUM(CASE WHEN shm.live = 1 ' \
-                        '  THEN sh.d ELSE 0 END) AS live_count ' \
-                        'FROM (SELECT *, ' \
-                        '      CAST(strftime("%%w", date(started, "unixepoch", "localtime")) AS INTEGER) AS daynumber, ' \
-                        '      SUM(CASE WHEN stopped > 0 THEN (stopped - started) - ' \
-                        '        (CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) ELSE 0 END) ' \
-                        '        AS d ' \
-                        '    FROM session_history ' \
-                        '    WHERE session_history.stopped >= %s %s' \
-                        '    GROUP BY daynumber, %s) AS sh ' \
-                        'JOIN session_history_metadata AS shm ON shm.id = sh.id ' \
-                        'GROUP BY dayofweek ' \
-                        'ORDER BY sh.daynumber' % (timestamp, user_cond, group_by)
+                query = "SELECT sh.daynumber, " \
+                        "(CASE sh.daynumber " \
+                        "  WHEN 0 THEN 'Sunday' " \
+                        "  WHEN 1 THEN 'Monday' " \
+                        "  WHEN 2 THEN 'Tuesday' " \
+                        "  WHEN 3 THEN 'Wednesday' " \
+                        "  WHEN 4 THEN 'Thursday' " \
+                        "  WHEN 5 THEN 'Friday' " \
+                        "  ELSE 'Saturday' END) AS dayofweek, " \
+                        "SUM(CASE WHEN sh.media_type = 'episode' AND shm.live = 0 " \
+                        "  THEN sh.d ELSE 0 END) AS tv_count, " \
+                        "SUM(CASE WHEN sh.media_type = 'movie' AND shm.live = 0 " \
+                        "  THEN sh.d ELSE 0 END) AS movie_count, " \
+                        "SUM(CASE WHEN sh.media_type = 'track' AND shm.live = 0 " \
+                        "  THEN sh.d ELSE 0 END) AS music_count, " \
+                        "SUM(CASE WHEN shm.live = 1 " \
+                        "  THEN sh.d ELSE 0 END) AS live_count " \
+                        "FROM (SELECT *, " \
+                        "      CAST(strftime('%%w', date(started, 'unixepoch', 'localtime')) AS INTEGER) AS daynumber, " \
+                        "      SUM(CASE WHEN stopped > 0 THEN (stopped - started) - " \
+                        "        (CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) ELSE 0 END) " \
+                        "        AS d " \
+                        "    FROM session_history " \
+                        "    WHERE session_history.stopped >= %s %s" \
+                        "    GROUP BY daynumber, %s) AS sh " \
+                        "JOIN session_history_metadata AS shm ON shm.id = sh.id " \
+                        "GROUP BY dayofweek " \
+                        "ORDER BY sh.daynumber" % (timestamp, user_cond, group_by)
 
                 result = monitor_db.select(query)
         except Exception as e:
@@ -321,42 +321,42 @@ class Graphs(object):
 
         try:
             if y_axis == 'plays':
-                query = 'SELECT sh.hourofday, ' \
-                        'SUM(CASE WHEN sh.media_type = "episode" AND shm.live = 0 THEN 1 ELSE 0 END) AS tv_count, ' \
-                        'SUM(CASE WHEN sh.media_type = "movie" AND shm.live = 0 THEN 1 ELSE 0 END) AS movie_count, ' \
-                        'SUM(CASE WHEN sh.media_type = "track" AND shm.live = 0 THEN 1 ELSE 0 END) AS music_count, ' \
-                        'SUM(shm.live) AS live_count ' \
-                        'FROM (SELECT *, ' \
-                        '      strftime("%%H", datetime(started, "unixepoch", "localtime")) AS hourofday' \
-                        '    FROM session_history ' \
-                        '    WHERE session_history.stopped >= %s %s ' \
-                        '    GROUP BY hourofday, %s) AS sh ' \
-                        'JOIN session_history_metadata AS shm ON shm.id = sh.id ' \
-                        'GROUP BY sh.hourofday ' \
-                        'ORDER BY sh.hourofday' % (timestamp, user_cond, group_by)
+                query = "SELECT sh.hourofday, " \
+                        "SUM(CASE WHEN sh.media_type = 'episode' AND shm.live = 0 THEN 1 ELSE 0 END) AS tv_count, " \
+                        "SUM(CASE WHEN sh.media_type = 'movie' AND shm.live = 0 THEN 1 ELSE 0 END) AS movie_count, " \
+                        "SUM(CASE WHEN sh.media_type = 'track' AND shm.live = 0 THEN 1 ELSE 0 END) AS music_count, " \
+                        "SUM(shm.live) AS live_count " \
+                        "FROM (SELECT *, " \
+                        "      strftime('%%H', datetime(started, 'unixepoch', 'localtime')) AS hourofday" \
+                        "    FROM session_history " \
+                        "    WHERE session_history.stopped >= %s %s " \
+                        "    GROUP BY hourofday, %s) AS sh " \
+                        "JOIN session_history_metadata AS shm ON shm.id = sh.id " \
+                        "GROUP BY sh.hourofday " \
+                        "ORDER BY sh.hourofday" % (timestamp, user_cond, group_by)
 
                 result = monitor_db.select(query)
             else:
-                query = 'SELECT sh.hourofday, ' \
-                        'SUM(CASE WHEN sh.media_type = "episode" AND shm.live = 0 ' \
-                        '  THEN sh.d ELSE 0 END) AS tv_count, ' \
-                        'SUM(CASE WHEN sh.media_type = "movie" AND shm.live = 0 ' \
-                        '  THEN sh.d ELSE 0 END) AS movie_count, ' \
-                        'SUM(CASE WHEN sh.media_type = "track" AND shm.live = 0 ' \
-                        '  THEN sh.d ELSE 0 END) AS music_count, ' \
-                        'SUM(CASE WHEN shm.live = 1 ' \
-                        '  THEN sh.d ELSE 0 END) AS live_count ' \
-                        'FROM (SELECT *, ' \
-                        '      strftime("%%H", datetime(started, "unixepoch", "localtime")) AS hourofday, ' \
-                        '      SUM(CASE WHEN stopped > 0 THEN (stopped - started) - ' \
-                        '        (CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) ELSE 0 END) ' \
-                        '        AS d ' \
-                        '    FROM session_history ' \
-                        '    WHERE session_history.stopped >= %s %s' \
-                        '    GROUP BY hourofday, %s) AS sh ' \
-                        'JOIN session_history_metadata AS shm ON shm.id = sh.id ' \
-                        'GROUP BY sh.hourofday ' \
-                        'ORDER BY sh.hourofday' % (timestamp, user_cond, group_by)
+                query = "SELECT sh.hourofday, " \
+                        "SUM(CASE WHEN sh.media_type = 'episode' AND shm.live = 0 " \
+                        "  THEN sh.d ELSE 0 END) AS tv_count, " \
+                        "SUM(CASE WHEN sh.media_type = 'movie' AND shm.live = 0 " \
+                        "  THEN sh.d ELSE 0 END) AS movie_count, " \
+                        "SUM(CASE WHEN sh.media_type = 'track' AND shm.live = 0 " \
+                        "  THEN sh.d ELSE 0 END) AS music_count, " \
+                        "SUM(CASE WHEN shm.live = 1 " \
+                        "  THEN sh.d ELSE 0 END) AS live_count " \
+                        "FROM (SELECT *, " \
+                        "      strftime('%%H', datetime(started, 'unixepoch', 'localtime')) AS hourofday, " \
+                        "      SUM(CASE WHEN stopped > 0 THEN (stopped - started) - " \
+                        "        (CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) ELSE 0 END) " \
+                        "        AS d " \
+                        "    FROM session_history " \
+                        "    WHERE session_history.stopped >= %s %s" \
+                        "    GROUP BY hourofday, %s) AS sh " \
+                        "JOIN session_history_metadata AS shm ON shm.id = sh.id " \
+                        "GROUP BY sh.hourofday " \
+                        "ORDER BY sh.hourofday" % (timestamp, user_cond, group_by)
 
                 result = monitor_db.select(query)
         except Exception as e:
@@ -440,42 +440,42 @@ class Graphs(object):
 
         try:
             if y_axis == 'plays':
-                query = 'SELECT sh.datestring, ' \
-                        'SUM(CASE WHEN sh.media_type = "episode" AND shm.live = 0 THEN 1 ELSE 0 END) AS tv_count, ' \
-                        'SUM(CASE WHEN sh.media_type = "movie" AND shm.live = 0 THEN 1 ELSE 0 END) AS movie_count, ' \
-                        'SUM(CASE WHEN sh.media_type = "track" AND shm.live = 0 THEN 1 ELSE 0 END) AS music_count, ' \
-                        'SUM(shm.live) AS live_count ' \
-                        'FROM (SELECT *, ' \
-                        '      strftime("%%Y-%%m", datetime(started, "unixepoch", "localtime")) AS datestring' \
-                        '    FROM session_history ' \
-                        '    WHERE session_history.stopped >= %s %s ' \
-                        '    GROUP BY datestring, %s) AS sh ' \
-                        'JOIN session_history_metadata AS shm ON shm.id = sh.id ' \
-                        'GROUP BY sh.datestring ' \
-                        'ORDER BY sh.datestring' % (timestamp, user_cond, group_by)
+                query = "SELECT sh.datestring, " \
+                        "SUM(CASE WHEN sh.media_type = 'episode' AND shm.live = 0 THEN 1 ELSE 0 END) AS tv_count, " \
+                        "SUM(CASE WHEN sh.media_type = 'movie' AND shm.live = 0 THEN 1 ELSE 0 END) AS movie_count, " \
+                        "SUM(CASE WHEN sh.media_type = 'track' AND shm.live = 0 THEN 1 ELSE 0 END) AS music_count, " \
+                        "SUM(shm.live) AS live_count " \
+                        "FROM (SELECT *, " \
+                        "      strftime('%%Y-%%m', datetime(started, 'unixepoch', 'localtime')) AS datestring" \
+                        "    FROM session_history " \
+                        "    WHERE session_history.stopped >= %s %s " \
+                        "    GROUP BY datestring, %s) AS sh " \
+                        "JOIN session_history_metadata AS shm ON shm.id = sh.id " \
+                        "GROUP BY sh.datestring " \
+                        "ORDER BY sh.datestring" % (timestamp, user_cond, group_by)
 
                 result = monitor_db.select(query)
             else:
-                query = 'SELECT sh.datestring, ' \
-                        'SUM(CASE WHEN sh.media_type = "episode" AND shm.live = 0 ' \
-                        '  THEN sh.d ELSE 0 END) AS tv_count, ' \
-                        'SUM(CASE WHEN sh.media_type = "movie" AND shm.live = 0 ' \
-                        '  THEN sh.d ELSE 0 END) AS movie_count, ' \
-                        'SUM(CASE WHEN sh.media_type = "track" AND shm.live = 0 ' \
-                        '  THEN sh.d ELSE 0 END) AS music_count, ' \
-                        'SUM(CASE WHEN shm.live = 1 ' \
-                        '  THEN sh.d ELSE 0 END) AS live_count ' \
-                        'FROM (SELECT *, ' \
-                        '      strftime("%%Y-%%m", datetime(started, "unixepoch", "localtime")) AS datestring, ' \
-                        '      SUM(CASE WHEN stopped > 0 THEN (stopped - started) - ' \
-                        '        (CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) ELSE 0 END) ' \
-                        '        AS d ' \
-                        '    FROM session_history ' \
-                        '    WHERE session_history.stopped >= %s %s' \
-                        '    GROUP BY datestring, %s) AS sh ' \
-                        'JOIN session_history_metadata AS shm ON shm.id = sh.id ' \
-                        'GROUP BY sh.datestring ' \
-                        'ORDER BY sh.datestring' % (timestamp, user_cond, group_by)
+                query = "SELECT sh.datestring, " \
+                        "SUM(CASE WHEN sh.media_type = 'episode' AND shm.live = 0 " \
+                        "  THEN sh.d ELSE 0 END) AS tv_count, " \
+                        "SUM(CASE WHEN sh.media_type = 'movie' AND shm.live = 0 " \
+                        "  THEN sh.d ELSE 0 END) AS movie_count, " \
+                        "SUM(CASE WHEN sh.media_type = 'track' AND shm.live = 0 " \
+                        "  THEN sh.d ELSE 0 END) AS music_count, " \
+                        "SUM(CASE WHEN shm.live = 1 " \
+                        "  THEN sh.d ELSE 0 END) AS live_count " \
+                        "FROM (SELECT *, " \
+                        "      strftime('%%Y-%%m', datetime(started, 'unixepoch', 'localtime')) AS datestring, " \
+                        "      SUM(CASE WHEN stopped > 0 THEN (stopped - started) - " \
+                        "        (CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) ELSE 0 END) " \
+                        "        AS d " \
+                        "    FROM session_history " \
+                        "    WHERE session_history.stopped >= %s %s" \
+                        "    GROUP BY datestring, %s) AS sh " \
+                        "JOIN session_history_metadata AS shm ON shm.id = sh.id " \
+                        "GROUP BY sh.datestring " \
+                        "ORDER BY sh.datestring" % (timestamp, user_cond, group_by)
 
                 result = monitor_db.select(query)
         except Exception as e:
@@ -567,44 +567,44 @@ class Graphs(object):
 
         try:
             if y_axis == 'plays':
-                query = 'SELECT sh.platform, ' \
-                        'SUM(CASE WHEN sh.media_type = "episode" AND shm.live = 0 THEN 1 ELSE 0 END) AS tv_count, ' \
-                        'SUM(CASE WHEN sh.media_type = "movie" AND shm.live = 0 THEN 1 ELSE 0 END) AS movie_count, ' \
-                        'SUM(CASE WHEN sh.media_type = "track" AND shm.live = 0 THEN 1 ELSE 0 END) AS music_count, ' \
-                        'SUM(shm.live) AS live_count, ' \
-                        'COUNT(sh.id) AS total_count ' \
-                        'FROM (SELECT * ' \
-                        '    FROM session_history ' \
-                        '    WHERE session_history.stopped >= %s %s ' \
-                        '    GROUP BY %s) AS sh ' \
-                        'JOIN session_history_metadata AS shm ON shm.id = sh.id ' \
-                        'GROUP BY sh.platform ' \
-                        'ORDER BY total_count DESC, sh.platform ASC ' \
-                        'LIMIT 10' % (timestamp, user_cond, group_by)
+                query = "SELECT sh.platform, " \
+                        "SUM(CASE WHEN sh.media_type = 'episode' AND shm.live = 0 THEN 1 ELSE 0 END) AS tv_count, " \
+                        "SUM(CASE WHEN sh.media_type = 'movie' AND shm.live = 0 THEN 1 ELSE 0 END) AS movie_count, " \
+                        "SUM(CASE WHEN sh.media_type = 'track' AND shm.live = 0 THEN 1 ELSE 0 END) AS music_count, " \
+                        "SUM(shm.live) AS live_count, " \
+                        "COUNT(sh.id) AS total_count " \
+                        "FROM (SELECT * " \
+                        "    FROM session_history " \
+                        "    WHERE session_history.stopped >= %s %s " \
+                        "    GROUP BY %s) AS sh " \
+                        "JOIN session_history_metadata AS shm ON shm.id = sh.id " \
+                        "GROUP BY sh.platform " \
+                        "ORDER BY total_count DESC, sh.platform ASC " \
+                        "LIMIT 10" % (timestamp, user_cond, group_by)
 
                 result = monitor_db.select(query)
             else:
-                query = 'SELECT sh.platform, ' \
-                        'SUM(CASE WHEN sh.media_type = "episode" AND shm.live = 0 ' \
-                        '  THEN sh.d ELSE 0 END) AS tv_count, ' \
-                        'SUM(CASE WHEN sh.media_type = "movie" AND shm.live = 0 ' \
-                        '  THEN sh.d ELSE 0 END) AS movie_count, ' \
-                        'SUM(CASE WHEN sh.media_type = "track" AND shm.live = 0 ' \
-                        '  THEN sh.d ELSE 0 END) AS music_count, ' \
-                        'SUM(CASE WHEN shm.live = 1 ' \
-                        '  THEN sh.d ELSE 0 END) AS live_count, ' \
-                        'SUM(sh.d) AS total_duration ' \
-                        'FROM (SELECT *, ' \
-                        '      SUM(CASE WHEN stopped > 0 THEN (stopped - started) - ' \
-                        '        (CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) ELSE 0 END) ' \
-                        '        AS d ' \
-                        '    FROM session_history ' \
-                        '    WHERE session_history.stopped >= %s %s' \
-                        '    GROUP BY %s) AS sh ' \
-                        'JOIN session_history_metadata AS shm ON shm.id = sh.id ' \
-                        'GROUP BY sh.platform ' \
-                        'ORDER BY total_duration DESC ' \
-                        'LIMIT 10' % (timestamp, user_cond, group_by)
+                query = "SELECT sh.platform, " \
+                        "SUM(CASE WHEN sh.media_type = 'episode' AND shm.live = 0 " \
+                        "  THEN sh.d ELSE 0 END) AS tv_count, " \
+                        "SUM(CASE WHEN sh.media_type = 'movie' AND shm.live = 0 " \
+                        "  THEN sh.d ELSE 0 END) AS movie_count, " \
+                        "SUM(CASE WHEN sh.media_type = 'track' AND shm.live = 0 " \
+                        "  THEN sh.d ELSE 0 END) AS music_count, " \
+                        "SUM(CASE WHEN shm.live = 1 " \
+                        "  THEN sh.d ELSE 0 END) AS live_count, " \
+                        "SUM(sh.d) AS total_duration " \
+                        "FROM (SELECT *, " \
+                        "      SUM(CASE WHEN stopped > 0 THEN (stopped - started) - " \
+                        "        (CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) ELSE 0 END) " \
+                        "        AS d " \
+                        "    FROM session_history " \
+                        "    WHERE session_history.stopped >= %s %s" \
+                        "    GROUP BY %s) AS sh " \
+                        "JOIN session_history_metadata AS shm ON shm.id = sh.id " \
+                        "GROUP BY sh.platform " \
+                        "ORDER BY total_duration DESC " \
+                        "LIMIT 10" % (timestamp, user_cond, group_by)
 
                 result = monitor_db.select(query)
         except Exception as e:
@@ -666,50 +666,50 @@ class Graphs(object):
 
         try:
             if y_axis == 'plays':
-                query = 'SELECT u.user_id, u.username, ' \
-                        '(CASE WHEN u.friendly_name IS NULL OR TRIM(u.friendly_name) = "" ' \
-                        '  THEN u.username ELSE u.friendly_name END) AS friendly_name,' \
-                        'SUM(CASE WHEN sh.media_type = "episode" AND shm.live = 0 THEN 1 ELSE 0 END) AS tv_count, ' \
-                        'SUM(CASE WHEN sh.media_type = "movie" AND shm.live = 0 THEN 1 ELSE 0 END) AS movie_count, ' \
-                        'SUM(CASE WHEN sh.media_type = "track" AND shm.live = 0 THEN 1 ELSE 0 END) AS music_count, ' \
-                        'SUM(shm.live) AS live_count, ' \
-                        'COUNT(sh.id) AS total_count ' \
-                        'FROM (SELECT * ' \
-                        '    FROM session_history ' \
-                        '    WHERE session_history.stopped >= %s %s ' \
-                        '    GROUP BY %s) AS sh ' \
-                        'JOIN session_history_metadata AS shm ON shm.id = sh.id ' \
-                        'JOIN users AS u ON u.user_id = sh.user_id ' \
-                        'GROUP BY sh.user_id ' \
-                        'ORDER BY total_count DESC ' \
-                        'LIMIT 10' % (timestamp, user_cond, group_by)
+                query = "SELECT u.user_id, u.username, " \
+                        "(CASE WHEN u.friendly_name IS NULL OR TRIM(u.friendly_name) = '' " \
+                        "  THEN u.username ELSE u.friendly_name END) AS friendly_name," \
+                        "SUM(CASE WHEN sh.media_type = 'episode' AND shm.live = 0 THEN 1 ELSE 0 END) AS tv_count, " \
+                        "SUM(CASE WHEN sh.media_type = 'movie' AND shm.live = 0 THEN 1 ELSE 0 END) AS movie_count, " \
+                        "SUM(CASE WHEN sh.media_type = 'track' AND shm.live = 0 THEN 1 ELSE 0 END) AS music_count, " \
+                        "SUM(shm.live) AS live_count, " \
+                        "COUNT(sh.id) AS total_count " \
+                        "FROM (SELECT * " \
+                        "    FROM session_history " \
+                        "    WHERE session_history.stopped >= %s %s " \
+                        "    GROUP BY %s) AS sh " \
+                        "JOIN session_history_metadata AS shm ON shm.id = sh.id " \
+                        "JOIN users AS u ON u.user_id = sh.user_id " \
+                        "GROUP BY sh.user_id " \
+                        "ORDER BY total_count DESC " \
+                        "LIMIT 10" % (timestamp, user_cond, group_by)
 
                 result = monitor_db.select(query)
             else:
-                query = 'SELECT u.user_id, u.username, ' \
-                        '(CASE WHEN u.friendly_name IS NULL OR TRIM(u.friendly_name) = "" ' \
-                        ' THEN u.username ELSE u.friendly_name END) AS friendly_name,' \
-                        'SUM(CASE WHEN sh.media_type = "episode" AND shm.live = 0 ' \
-                        '  THEN sh.d ELSE 0 END) AS tv_count, ' \
-                        'SUM(CASE WHEN sh.media_type = "movie" AND shm.live = 0 ' \
-                        '  THEN sh.d ELSE 0 END) AS movie_count, ' \
-                        'SUM(CASE WHEN sh.media_type = "track" AND shm.live = 0 ' \
-                        '  THEN sh.d ELSE 0 END) AS music_count, ' \
-                        'SUM(CASE WHEN shm.live = 1 ' \
-                        '  THEN sh.d ELSE 0 END) AS live_count, ' \
-                        'SUM(sh.d) AS total_duration ' \
-                        'FROM (SELECT *, ' \
-                        '      SUM(CASE WHEN stopped > 0 THEN (stopped - started) - ' \
-                        '         (CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) ELSE 0 END) ' \
-                        '         AS d ' \
-                        '    FROM session_history ' \
-                        '    WHERE session_history.stopped >= %s %s' \
-                        '    GROUP BY %s) AS sh ' \
-                        'JOIN session_history_metadata AS shm ON shm.id = sh.id ' \
-                        'JOIN users AS u ON u.user_id = sh.user_id ' \
-                        'GROUP BY sh.user_id ' \
-                        'ORDER BY total_duration DESC ' \
-                        'LIMIT 10' % (timestamp, user_cond, group_by)
+                query = "SELECT u.user_id, u.username, " \
+                        "(CASE WHEN u.friendly_name IS NULL OR TRIM(u.friendly_name) = '' " \
+                        " THEN u.username ELSE u.friendly_name END) AS friendly_name," \
+                        "SUM(CASE WHEN sh.media_type = 'episode' AND shm.live = 0 " \
+                        "  THEN sh.d ELSE 0 END) AS tv_count, " \
+                        "SUM(CASE WHEN sh.media_type = 'movie' AND shm.live = 0 " \
+                        "  THEN sh.d ELSE 0 END) AS movie_count, " \
+                        "SUM(CASE WHEN sh.media_type = 'track' AND shm.live = 0 " \
+                        "  THEN sh.d ELSE 0 END) AS music_count, " \
+                        "SUM(CASE WHEN shm.live = 1 " \
+                        "  THEN sh.d ELSE 0 END) AS live_count, " \
+                        "SUM(sh.d) AS total_duration " \
+                        "FROM (SELECT *, " \
+                        "      SUM(CASE WHEN stopped > 0 THEN (stopped - started) - " \
+                        "         (CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) ELSE 0 END) " \
+                        "         AS d " \
+                        "    FROM session_history " \
+                        "    WHERE session_history.stopped >= %s %s" \
+                        "    GROUP BY %s) AS sh " \
+                        "JOIN session_history_metadata AS shm ON shm.id = sh.id " \
+                        "JOIN users AS u ON u.user_id = sh.user_id " \
+                        "GROUP BY sh.user_id " \
+                        "ORDER BY total_duration DESC " \
+                        "LIMIT 10" % (timestamp, user_cond, group_by)
 
                 result = monitor_db.select(query)
         except Exception as e:
@@ -776,36 +776,36 @@ class Graphs(object):
 
         try:
             if y_axis == 'plays':
-                query = 'SELECT sh.date_played, ' \
-                        'SUM(CASE WHEN shmi.transcode_decision = "direct play" THEN 1 ELSE 0 END) AS dp_count, ' \
-                        'SUM(CASE WHEN shmi.transcode_decision = "copy" THEN 1 ELSE 0 END) AS ds_count, ' \
-                        'SUM(CASE WHEN shmi.transcode_decision = "transcode" THEN 1 ELSE 0 END) AS tc_count ' \
-                        'FROM (SELECT *, ' \
-                        '      date(started, "unixepoch", "localtime") AS date_played ' \
-                        '    FROM session_history ' \
-                        '    WHERE session_history.stopped >= %s %s ' \
-                        '    GROUP BY date_played, %s) AS sh ' \
-                        'JOIN session_history_media_info AS shmi ON shmi.id = sh.id ' \
-                        'GROUP BY sh.date_played ' \
-                        'ORDER BY sh.started' % (timestamp, user_cond, group_by)
+                query = "SELECT sh.date_played, " \
+                        "SUM(CASE WHEN shmi.transcode_decision = 'direct play' THEN 1 ELSE 0 END) AS dp_count, " \
+                        "SUM(CASE WHEN shmi.transcode_decision = 'copy' THEN 1 ELSE 0 END) AS ds_count, " \
+                        "SUM(CASE WHEN shmi.transcode_decision = 'transcode' THEN 1 ELSE 0 END) AS tc_count " \
+                        "FROM (SELECT *, " \
+                        "      date(started, 'unixepoch', 'localtime') AS date_played " \
+                        "    FROM session_history " \
+                        "    WHERE session_history.stopped >= %s %s " \
+                        "    GROUP BY date_played, %s) AS sh " \
+                        "JOIN session_history_media_info AS shmi ON shmi.id = sh.id " \
+                        "GROUP BY sh.date_played " \
+                        "ORDER BY sh.started" % (timestamp, user_cond, group_by)
 
                 result = monitor_db.select(query)
             else:
-                query = 'SELECT sh.date_played, ' \
-                        'SUM(CASE WHEN shmi.transcode_decision = "direct play" THEN sh.d ELSE 0 END) AS dp_count, ' \
-                        'SUM(CASE WHEN shmi.transcode_decision = "copy" THEN sh.d ELSE 0 END) AS ds_count, ' \
-                        'SUM(CASE WHEN shmi.transcode_decision = "transcode" THEN sh.d ELSE 0 END) AS tc_count ' \
-                        'FROM (SELECT *, ' \
-                        '      date(started, "unixepoch", "localtime") AS date_played,' \
-                        '      SUM(CASE WHEN stopped > 0 THEN (stopped - started) - ' \
-                        '        (CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) ELSE 0 END) ' \
-                        '        AS d ' \
-                        '    FROM session_history ' \
-                        '    WHERE session_history.stopped >= %s %s' \
-                        '    GROUP BY date_played, %s) AS sh ' \
-                        'JOIN session_history_media_info AS shmi ON shmi.id = sh.id ' \
-                        'GROUP BY sh.date_played ' \
-                        'ORDER BY sh.started' % (timestamp, user_cond, group_by)
+                query = "SELECT sh.date_played, " \
+                        "SUM(CASE WHEN shmi.transcode_decision = 'direct play' THEN sh.d ELSE 0 END) AS dp_count, " \
+                        "SUM(CASE WHEN shmi.transcode_decision = 'copy' THEN sh.d ELSE 0 END) AS ds_count, " \
+                        "SUM(CASE WHEN shmi.transcode_decision = 'transcode' THEN sh.d ELSE 0 END) AS tc_count " \
+                        "FROM (SELECT *, " \
+                        "      date(started, 'unixepoch', 'localtime') AS date_played," \
+                        "      SUM(CASE WHEN stopped > 0 THEN (stopped - started) - " \
+                        "        (CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) ELSE 0 END) " \
+                        "        AS d " \
+                        "    FROM session_history " \
+                        "    WHERE session_history.stopped >= %s %s" \
+                        "    GROUP BY date_played, %s) AS sh " \
+                        "JOIN session_history_media_info AS shmi ON shmi.id = sh.id " \
+                        "GROUP BY sh.date_played " \
+                        "ORDER BY sh.started" % (timestamp, user_cond, group_by)
 
                 result = monitor_db.select(query)
         except Exception as e:
@@ -873,40 +873,40 @@ class Graphs(object):
 
         try:
             if y_axis == 'plays':
-                query = 'SELECT shmi.video_full_resolution AS resolution, ' \
-                        'SUM(CASE WHEN shmi.transcode_decision = "direct play" THEN 1 ELSE 0 END) AS dp_count, ' \
-                        'SUM(CASE WHEN shmi.transcode_decision = "copy" THEN 1 ELSE 0 END) AS ds_count, ' \
-                        'SUM(CASE WHEN shmi.transcode_decision = "transcode" THEN 1 ELSE 0 END) AS tc_count, ' \
-                        'COUNT(sh.id) AS total_count ' \
-                        'FROM (SELECT * ' \
-                        '    FROM session_history ' \
-                        '    WHERE session_history.stopped >= %s ' \
-                        '    AND session_history.media_type IN ("movie", "episode") %s ' \
-                        '    GROUP BY %s) AS sh ' \
-                        'JOIN session_history_media_info AS shmi ON shmi.id = sh.id ' \
-                        'GROUP BY resolution ' \
-                        'ORDER BY total_count DESC ' \
-                        'LIMIT 10' % (timestamp, user_cond, group_by)
+                query = "SELECT shmi.video_full_resolution AS resolution, " \
+                        "SUM(CASE WHEN shmi.transcode_decision = 'direct play' THEN 1 ELSE 0 END) AS dp_count, " \
+                        "SUM(CASE WHEN shmi.transcode_decision = 'copy' THEN 1 ELSE 0 END) AS ds_count, " \
+                        "SUM(CASE WHEN shmi.transcode_decision = 'transcode' THEN 1 ELSE 0 END) AS tc_count, " \
+                        "COUNT(sh.id) AS total_count " \
+                        "FROM (SELECT * " \
+                        "    FROM session_history " \
+                        "    WHERE session_history.stopped >= %s " \
+                        "    AND session_history.media_type IN ('movie', 'episode') %s " \
+                        "    GROUP BY %s) AS sh " \
+                        "JOIN session_history_media_info AS shmi ON shmi.id = sh.id " \
+                        "GROUP BY resolution " \
+                        "ORDER BY total_count DESC " \
+                        "LIMIT 10" % (timestamp, user_cond, group_by)
 
                 result = monitor_db.select(query)
             else:
-                query = 'SELECT shmi.video_full_resolution AS resolution,' \
-                        'SUM(CASE WHEN shmi.transcode_decision = "direct play" THEN sh.d ELSE 0 END) AS dp_count, ' \
-                        'SUM(CASE WHEN shmi.transcode_decision = "copy" THEN sh.d ELSE 0 END) AS ds_count, ' \
-                        'SUM(CASE WHEN shmi.transcode_decision = "transcode" THEN sh.d ELSE 0 END) AS tc_count, ' \
-                        'SUM(sh.d) AS total_duration ' \
-                        'FROM (SELECT *, ' \
-                        '      SUM(CASE WHEN stopped > 0 THEN (stopped - started) - ' \
-                        '        (CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) ELSE 0 END) ' \
-                        '        AS d ' \
-                        '    FROM session_history ' \
-                        '    WHERE session_history.stopped >= %s ' \
-                        '    AND session_history.media_type IN ("movie", "episode") %s ' \
-                        '    GROUP BY %s) AS sh ' \
-                        'JOIN session_history_media_info AS shmi ON shmi.id = sh.id ' \
-                        'GROUP BY resolution ' \
-                        'ORDER BY total_duration DESC ' \
-                        'LIMIT 10' % (timestamp, user_cond, group_by)
+                query = "SELECT shmi.video_full_resolution AS resolution," \
+                        "SUM(CASE WHEN shmi.transcode_decision = 'direct play' THEN sh.d ELSE 0 END) AS dp_count, " \
+                        "SUM(CASE WHEN shmi.transcode_decision = 'copy' THEN sh.d ELSE 0 END) AS ds_count, " \
+                        "SUM(CASE WHEN shmi.transcode_decision = 'transcode' THEN sh.d ELSE 0 END) AS tc_count, " \
+                        "SUM(sh.d) AS total_duration " \
+                        "FROM (SELECT *, " \
+                        "      SUM(CASE WHEN stopped > 0 THEN (stopped - started) - " \
+                        "        (CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) ELSE 0 END) " \
+                        "        AS d " \
+                        "    FROM session_history " \
+                        "    WHERE session_history.stopped >= %s " \
+                        "    AND session_history.media_type IN ('movie', 'episode') %s " \
+                        "    GROUP BY %s) AS sh " \
+                        "JOIN session_history_media_info AS shmi ON shmi.id = sh.id " \
+                        "GROUP BY resolution " \
+                        "ORDER BY total_duration DESC " \
+                        "LIMIT 10" % (timestamp, user_cond, group_by)
 
                 result = monitor_db.select(query)
         except Exception as e:
@@ -954,66 +954,66 @@ class Graphs(object):
 
         try:
             if y_axis == 'plays':
-                query = 'SELECT ' \
-                        '(CASE WHEN shmi.stream_video_full_resolution IS NULL THEN ' \
-                        '  (CASE WHEN shmi.video_decision = "transcode" THEN ' \
-                        '    (CASE ' \
-                        '      WHEN shmi.transcode_height <= 360 THEN "SD" ' \
-                        '      WHEN shmi.transcode_height <= 480 THEN "480" ' \
-                        '      WHEN shmi.transcode_height <= 576 THEN "576" ' \
-                        '      WHEN shmi.transcode_height <= 720 THEN "720" ' \
-                        '      WHEN shmi.transcode_height <= 1080 THEN "1080" ' \
-                        '      WHEN shmi.transcode_height <= 1440 THEN "QHD" ' \
-                        '      WHEN shmi.transcode_height <= 2160 THEN "4k" ' \
-                        '      ELSE "unknown" END)' \
-                        '    ELSE shmi.video_full_resolution END) ' \
-                        '  ELSE shmi.stream_video_full_resolution END) AS resolution, ' \
-                        'SUM(CASE WHEN shmi.transcode_decision = "direct play" THEN 1 ELSE 0 END) AS dp_count, ' \
-                        'SUM(CASE WHEN shmi.transcode_decision = "copy" THEN 1 ELSE 0 END) AS ds_count, ' \
-                        'SUM(CASE WHEN shmi.transcode_decision = "transcode" THEN 1 ELSE 0 END) AS tc_count, ' \
-                        'COUNT(sh.id) AS total_count ' \
-                        'FROM (SELECT * ' \
-                        '    FROM session_history ' \
-                        '    WHERE session_history.stopped >= %s ' \
-                        '    AND session_history.media_type IN ("movie", "episode") %s ' \
-                        '    GROUP BY %s) AS sh ' \
-                        'JOIN session_history_media_info AS shmi ON shmi.id = sh.id ' \
-                        'GROUP BY resolution ' \
-                        'ORDER BY total_count DESC ' \
-                        'LIMIT 10' % (timestamp, user_cond, group_by)
+                query = "SELECT " \
+                        "(CASE WHEN shmi.stream_video_full_resolution IS NULL THEN " \
+                        "  (CASE WHEN shmi.video_decision = 'transcode' THEN " \
+                        "    (CASE " \
+                        "      WHEN shmi.transcode_height <= 360 THEN 'SD' " \
+                        "      WHEN shmi.transcode_height <= 480 THEN '480' " \
+                        "      WHEN shmi.transcode_height <= 576 THEN '576' " \
+                        "      WHEN shmi.transcode_height <= 720 THEN '720' " \
+                        "      WHEN shmi.transcode_height <= 1080 THEN '1080' " \
+                        "      WHEN shmi.transcode_height <= 1440 THEN 'QHD' " \
+                        "      WHEN shmi.transcode_height <= 2160 THEN '4k' " \
+                        "      ELSE 'unknown' END)" \
+                        "    ELSE shmi.video_full_resolution END) " \
+                        "  ELSE shmi.stream_video_full_resolution END) AS resolution, " \
+                        "SUM(CASE WHEN shmi.transcode_decision = 'direct play' THEN 1 ELSE 0 END) AS dp_count, " \
+                        "SUM(CASE WHEN shmi.transcode_decision = 'copy' THEN 1 ELSE 0 END) AS ds_count, " \
+                        "SUM(CASE WHEN shmi.transcode_decision = 'transcode' THEN 1 ELSE 0 END) AS tc_count, " \
+                        "COUNT(sh.id) AS total_count " \
+                        "FROM (SELECT * " \
+                        "    FROM session_history " \
+                        "    WHERE session_history.stopped >= %s " \
+                        "    AND session_history.media_type IN ('movie', 'episode') %s " \
+                        "    GROUP BY %s) AS sh " \
+                        "JOIN session_history_media_info AS shmi ON shmi.id = sh.id " \
+                        "GROUP BY resolution " \
+                        "ORDER BY total_count DESC " \
+                        "LIMIT 10" % (timestamp, user_cond, group_by)
 
                 result = monitor_db.select(query)
             else:
-                query = 'SELECT ' \
-                        '(CASE WHEN shmi.stream_video_full_resolution IS NULL THEN ' \
-                        '  (CASE WHEN shmi.video_decision = "transcode" THEN ' \
-                        '    (CASE ' \
-                        '      WHEN shmi.transcode_height <= 360 THEN "SD" ' \
-                        '      WHEN shmi.transcode_height <= 480 THEN "480" ' \
-                        '      WHEN shmi.transcode_height <= 576 THEN "576" ' \
-                        '      WHEN shmi.transcode_height <= 720 THEN "720" ' \
-                        '      WHEN shmi.transcode_height <= 1080 THEN "1080" ' \
-                        '      WHEN shmi.transcode_height <= 1440 THEN "QHD" ' \
-                        '      WHEN shmi.transcode_height <= 2160 THEN "4k" ' \
-                        '      ELSE "unknown" END)' \
-                        '    ELSE shmi.video_full_resolution END) ' \
-                        '  ELSE shmi.stream_video_full_resolution END) AS resolution, ' \
-                        'SUM(CASE WHEN shmi.transcode_decision = "direct play" THEN sh.d ELSE 0 END) AS dp_count, ' \
-                        'SUM(CASE WHEN shmi.transcode_decision = "copy" THEN sh.d ELSE 0 END) AS ds_count, ' \
-                        'SUM(CASE WHEN shmi.transcode_decision = "transcode" THEN sh.d ELSE 0 END) AS tc_count, ' \
-                        'SUM(sh.d) AS total_duration ' \
-                        'FROM (SELECT *, ' \
-                        '      SUM(CASE WHEN stopped > 0 THEN (stopped - started) - ' \
-                        '        (CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) ELSE 0 END) ' \
-                        '        AS d ' \
-                        '    FROM session_history ' \
-                        '    WHERE session_history.stopped >= %s ' \
-                        '    AND session_history.media_type IN ("movie", "episode") %s ' \
-                        '    GROUP BY %s) AS sh ' \
-                        'JOIN session_history_media_info AS shmi ON shmi.id = sh.id ' \
-                        'GROUP BY resolution ' \
-                        'ORDER BY total_duration DESC ' \
-                        'LIMIT 10' % (timestamp, user_cond, group_by)
+                query = "SELECT " \
+                        "(CASE WHEN shmi.stream_video_full_resolution IS NULL THEN " \
+                        "  (CASE WHEN shmi.video_decision = 'transcode' THEN " \
+                        "    (CASE " \
+                        "      WHEN shmi.transcode_height <= 360 THEN 'SD' " \
+                        "      WHEN shmi.transcode_height <= 480 THEN '480' " \
+                        "      WHEN shmi.transcode_height <= 576 THEN '576' " \
+                        "      WHEN shmi.transcode_height <= 720 THEN '720' " \
+                        "      WHEN shmi.transcode_height <= 1080 THEN '1080' " \
+                        "      WHEN shmi.transcode_height <= 1440 THEN 'QHD' " \
+                        "      WHEN shmi.transcode_height <= 2160 THEN '4k' " \
+                        "      ELSE 'unknown' END)" \
+                        "    ELSE shmi.video_full_resolution END) " \
+                        "  ELSE shmi.stream_video_full_resolution END) AS resolution, " \
+                        "SUM(CASE WHEN shmi.transcode_decision = 'direct play' THEN sh.d ELSE 0 END) AS dp_count, " \
+                        "SUM(CASE WHEN shmi.transcode_decision = 'copy' THEN sh.d ELSE 0 END) AS ds_count, " \
+                        "SUM(CASE WHEN shmi.transcode_decision = 'transcode' THEN sh.d ELSE 0 END) AS tc_count, " \
+                        "SUM(sh.d) AS total_duration " \
+                        "FROM (SELECT *, " \
+                        "      SUM(CASE WHEN stopped > 0 THEN (stopped - started) - " \
+                        "        (CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) ELSE 0 END) " \
+                        "        AS d " \
+                        "    FROM session_history " \
+                        "    WHERE session_history.stopped >= %s " \
+                        "    AND session_history.media_type IN ('movie', 'episode') %s " \
+                        "    GROUP BY %s) AS sh " \
+                        "JOIN session_history_media_info AS shmi ON shmi.id = sh.id " \
+                        "GROUP BY resolution " \
+                        "ORDER BY total_duration DESC " \
+                        "LIMIT 10" % (timestamp, user_cond, group_by)
 
                 result = monitor_db.select(query)
         except Exception as e:
@@ -1061,38 +1061,38 @@ class Graphs(object):
 
         try:
             if y_axis == 'plays':
-                query = 'SELECT sh.platform, ' \
-                        'SUM(CASE WHEN shmi.transcode_decision = "direct play" THEN 1 ELSE 0 END) AS dp_count, ' \
-                        'SUM(CASE WHEN shmi.transcode_decision = "copy" THEN 1 ELSE 0 END) AS ds_count, ' \
-                        'SUM(CASE WHEN shmi.transcode_decision = "transcode" THEN 1 ELSE 0 END) AS tc_count, ' \
-                        'COUNT(sh.id) AS total_count ' \
-                        'FROM (SELECT * ' \
-                        '    FROM session_history ' \
-                        '    WHERE session_history.stopped >= %s %s ' \
-                        '    GROUP BY %s) AS sh ' \
-                        'JOIN session_history_media_info AS shmi ON shmi.id = sh.id ' \
-                        'GROUP BY sh.platform ' \
-                        'ORDER BY total_count DESC ' \
-                        'LIMIT 10' % (timestamp, user_cond, group_by)
+                query = "SELECT sh.platform, " \
+                        "SUM(CASE WHEN shmi.transcode_decision = 'direct play' THEN 1 ELSE 0 END) AS dp_count, " \
+                        "SUM(CASE WHEN shmi.transcode_decision = 'copy' THEN 1 ELSE 0 END) AS ds_count, " \
+                        "SUM(CASE WHEN shmi.transcode_decision = 'transcode' THEN 1 ELSE 0 END) AS tc_count, " \
+                        "COUNT(sh.id) AS total_count " \
+                        "FROM (SELECT * " \
+                        "    FROM session_history " \
+                        "    WHERE session_history.stopped >= %s %s " \
+                        "    GROUP BY %s) AS sh " \
+                        "JOIN session_history_media_info AS shmi ON shmi.id = sh.id " \
+                        "GROUP BY sh.platform " \
+                        "ORDER BY total_count DESC " \
+                        "LIMIT 10" % (timestamp, user_cond, group_by)
 
                 result = monitor_db.select(query)
             else:
-                query = 'SELECT sh.platform, ' \
-                        'SUM(CASE WHEN shmi.transcode_decision = "direct play" THEN sh.d ELSE 0 END) AS dp_count, ' \
-                        'SUM(CASE WHEN shmi.transcode_decision = "copy" THEN sh.d ELSE 0 END) AS ds_count, ' \
-                        'SUM(CASE WHEN shmi.transcode_decision = "transcode" THEN sh.d ELSE 0 END) AS tc_count, ' \
-                        'SUM(sh.d) AS total_duration ' \
-                        'FROM (SELECT *, ' \
-                        '      SUM(CASE WHEN stopped > 0 THEN (stopped - started) - ' \
-                        '        (CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) ELSE 0 END) ' \
-                        '        AS d ' \
-                        '    FROM session_history ' \
-                        '    WHERE session_history.stopped >= %s %s ' \
-                        '    GROUP BY %s) AS sh ' \
-                        'JOIN session_history_media_info AS shmi ON shmi.id = sh.id ' \
-                        'GROUP BY sh.platform ' \
-                        'ORDER BY total_duration DESC ' \
-                        'LIMIT 10' % (timestamp, user_cond, group_by)
+                query = "SELECT sh.platform, " \
+                        "SUM(CASE WHEN shmi.transcode_decision = 'direct play' THEN sh.d ELSE 0 END) AS dp_count, " \
+                        "SUM(CASE WHEN shmi.transcode_decision = 'copy' THEN sh.d ELSE 0 END) AS ds_count, " \
+                        "SUM(CASE WHEN shmi.transcode_decision = 'transcode' THEN sh.d ELSE 0 END) AS tc_count, " \
+                        "SUM(sh.d) AS total_duration " \
+                        "FROM (SELECT *, " \
+                        "      SUM(CASE WHEN stopped > 0 THEN (stopped - started) - " \
+                        "        (CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) ELSE 0 END) " \
+                        "        AS d " \
+                        "    FROM session_history " \
+                        "    WHERE session_history.stopped >= %s %s " \
+                        "    GROUP BY %s) AS sh " \
+                        "JOIN session_history_media_info AS shmi ON shmi.id = sh.id " \
+                        "GROUP BY sh.platform " \
+                        "ORDER BY total_duration DESC " \
+                        "LIMIT 10" % (timestamp, user_cond, group_by)
 
                 result = monitor_db.select(query)
         except Exception as e:
@@ -1141,44 +1141,44 @@ class Graphs(object):
 
         try:
             if y_axis == 'plays':
-                query = 'SELECT u.user_id, u.username, ' \
-                        '(CASE WHEN u.friendly_name IS NULL OR TRIM(u.friendly_name) = "" ' \
-                        '  THEN u.username ELSE u.friendly_name END) AS friendly_name,' \
-                        'SUM(CASE WHEN shmi.transcode_decision = "direct play" THEN 1 ELSE 0 END) AS dp_count, ' \
-                        'SUM(CASE WHEN shmi.transcode_decision = "copy" THEN 1 ELSE 0 END) AS ds_count, ' \
-                        'SUM(CASE WHEN shmi.transcode_decision = "transcode" THEN 1 ELSE 0 END) AS tc_count, ' \
-                        'COUNT(sh.id) AS total_count ' \
-                        'FROM (SELECT * ' \
-                        '    FROM session_history ' \
-                        '    WHERE session_history.stopped >= %s %s ' \
-                        '    GROUP BY %s) AS sh ' \
-                        'JOIN session_history_media_info AS shmi ON shmi.id = sh.id ' \
-                        'JOIN users AS u ON u.user_id = sh.user_id ' \
-                        'GROUP BY u.user_id ' \
-                        'ORDER BY total_count DESC ' \
-                        'LIMIT 10' % (timestamp, user_cond, group_by)
+                query = "SELECT u.user_id, u.username, " \
+                        "(CASE WHEN u.friendly_name IS NULL OR TRIM(u.friendly_name) = '' " \
+                        "  THEN u.username ELSE u.friendly_name END) AS friendly_name," \
+                        "SUM(CASE WHEN shmi.transcode_decision = 'direct play' THEN 1 ELSE 0 END) AS dp_count, " \
+                        "SUM(CASE WHEN shmi.transcode_decision = 'copy' THEN 1 ELSE 0 END) AS ds_count, " \
+                        "SUM(CASE WHEN shmi.transcode_decision = 'transcode' THEN 1 ELSE 0 END) AS tc_count, " \
+                        "COUNT(sh.id) AS total_count " \
+                        "FROM (SELECT * " \
+                        "    FROM session_history " \
+                        "    WHERE session_history.stopped >= %s %s " \
+                        "    GROUP BY %s) AS sh " \
+                        "JOIN session_history_media_info AS shmi ON shmi.id = sh.id " \
+                        "JOIN users AS u ON u.user_id = sh.user_id " \
+                        "GROUP BY u.user_id " \
+                        "ORDER BY total_count DESC " \
+                        "LIMIT 10" % (timestamp, user_cond, group_by)
 
                 result = monitor_db.select(query)
             else:
-                query = 'SELECT u.user_id, u.username, ' \
-                        '(CASE WHEN u.friendly_name IS NULL OR TRIM(u.friendly_name) = "" ' \
-                        '  THEN u.username ELSE u.friendly_name END) AS friendly_name,' \
-                        'SUM(CASE WHEN shmi.transcode_decision = "direct play" THEN sh.d ELSE 0 END) AS dp_count, ' \
-                        'SUM(CASE WHEN shmi.transcode_decision = "copy" THEN sh.d ELSE 0 END) AS ds_count, ' \
-                        'SUM(CASE WHEN shmi.transcode_decision = "transcode" THEN sh.d ELSE 0 END) AS tc_count, ' \
-                        'SUM(sh.d) AS total_duration ' \
-                        'FROM (SELECT *, ' \
-                        '      SUM(CASE WHEN stopped > 0 THEN (stopped - started) - ' \
-                        '        (CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) ELSE 0 END) ' \
-                        '        AS d ' \
-                        '    FROM session_history ' \
-                        '    WHERE session_history.stopped >= %s %s ' \
-                        '    GROUP BY %s) AS sh ' \
-                        'JOIN session_history_media_info AS shmi ON shmi.id = sh.id ' \
-                        'JOIN users AS u ON u.user_id = sh.user_id ' \
-                        'GROUP BY u.user_id ' \
-                        'ORDER BY total_duration DESC ' \
-                        'LIMIT 10' % (timestamp, user_cond, group_by)
+                query = "SELECT u.user_id, u.username, " \
+                        "(CASE WHEN u.friendly_name IS NULL OR TRIM(u.friendly_name) = '' " \
+                        "  THEN u.username ELSE u.friendly_name END) AS friendly_name," \
+                        "SUM(CASE WHEN shmi.transcode_decision = 'direct play' THEN sh.d ELSE 0 END) AS dp_count, " \
+                        "SUM(CASE WHEN shmi.transcode_decision = 'copy' THEN sh.d ELSE 0 END) AS ds_count, " \
+                        "SUM(CASE WHEN shmi.transcode_decision = 'transcode' THEN sh.d ELSE 0 END) AS tc_count, " \
+                        "SUM(sh.d) AS total_duration " \
+                        "FROM (SELECT *, " \
+                        "      SUM(CASE WHEN stopped > 0 THEN (stopped - started) - " \
+                        "        (CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) ELSE 0 END) " \
+                        "        AS d " \
+                        "    FROM session_history " \
+                        "    WHERE session_history.stopped >= %s %s " \
+                        "    GROUP BY %s) AS sh " \
+                        "JOIN session_history_media_info AS shmi ON shmi.id = sh.id " \
+                        "JOIN users AS u ON u.user_id = sh.user_id " \
+                        "GROUP BY u.user_id " \
+                        "ORDER BY total_duration DESC " \
+                        "LIMIT 10" % (timestamp, user_cond, group_by)
 
                 result = monitor_db.select(query)
         except Exception as e:
diff --git a/plexpy/libraries.py b/plexpy/libraries.py
index ba30efa9..33832aba 100644
--- a/plexpy/libraries.py
+++ b/plexpy/libraries.py
@@ -95,8 +95,8 @@ def refresh_libraries():
 
         add_live_tv_library(refresh=True)
 
-        query = 'UPDATE library_sections SET is_active = 0 WHERE server_id != ? OR ' \
-                'section_id NOT IN ({})'.format(', '.join(['?'] * len(section_ids)))
+        query = "UPDATE library_sections SET is_active = 0 WHERE server_id != ? OR " \
+                "section_id NOT IN ({})".format(", ".join(["?"] * len(section_ids)))
         monitor_db.action(query=query, args=[plexpy.CONFIG.PMS_IDENTIFIER] + section_ids)
 
         new_keys = plexpy.CONFIG.HOME_LIBRARY_CARDS + new_keys
@@ -112,8 +112,8 @@ def refresh_libraries():
 
 def add_live_tv_library(refresh=False):
     monitor_db = database.MonitorDatabase()
-    result = monitor_db.select_single('SELECT * FROM library_sections '
-                                      'WHERE section_id = ? and server_id = ?',
+    result = monitor_db.select_single("SELECT * FROM library_sections "
+                                      "WHERE section_id = ? and server_id = ?",
                                       [common.LIVE_TV_SECTION_ID, plexpy.CONFIG.PMS_IDENTIFIER])
 
     if result and not refresh or not result and refresh:
@@ -138,7 +138,7 @@ def add_live_tv_library(refresh=False):
 
 def has_library_type(section_type):
     monitor_db = database.MonitorDatabase()
-    query = 'SELECT * FROM library_sections WHERE section_type = ? AND deleted_section = 0'
+    query = "SELECT * FROM library_sections WHERE section_type = ? AND deleted_section = 0"
     args = [section_type]
     result = monitor_db.select_single(query=query, args=args)
     return bool(result)
@@ -328,44 +328,44 @@ class Libraries(object):
 
         group_by = 'session_history.reference_id' if grouping else 'session_history.id'
 
-        columns = ['library_sections.id AS row_id',
-                   'library_sections.server_id',
-                   'library_sections.section_id',
-                   'library_sections.section_name',
-                   'library_sections.section_type',
-                   'library_sections.count',
-                   'library_sections.parent_count',
-                   'library_sections.child_count',
-                   'library_sections.thumb AS library_thumb',
-                   'library_sections.custom_thumb_url AS custom_thumb',
-                   'library_sections.art AS library_art',
-                   'library_sections.custom_art_url AS custom_art',
-                   'COUNT(DISTINCT %s) AS plays' % group_by,
-                   'SUM(CASE WHEN session_history.stopped > 0 THEN (session_history.stopped - session_history.started) \
+        columns = ["library_sections.id AS row_id",
+                   "library_sections.server_id",
+                   "library_sections.section_id",
+                   "library_sections.section_name",
+                   "library_sections.section_type",
+                   "library_sections.count",
+                   "library_sections.parent_count",
+                   "library_sections.child_count",
+                   "library_sections.thumb AS library_thumb",
+                   "library_sections.custom_thumb_url AS custom_thumb",
+                   "library_sections.art AS library_art",
+                   "library_sections.custom_art_url AS custom_art",
+                   "COUNT(DISTINCT %s) AS plays" % group_by,
+                   "SUM(CASE WHEN session_history.stopped > 0 THEN (session_history.stopped - session_history.started) \
                     ELSE 0 END) - SUM(CASE WHEN session_history.paused_counter IS NULL THEN 0 ELSE \
-                    session_history.paused_counter END) AS duration',
-                   'MAX(session_history.started) AS last_accessed',
-                   'MAX(session_history.id) AS history_row_id',
-                   'session_history_metadata.full_title AS last_played',
-                   'session_history.rating_key',
-                   'session_history_metadata.media_type',
-                   'session_history_metadata.thumb',
-                   'session_history_metadata.parent_thumb',
-                   'session_history_metadata.grandparent_thumb',
-                   'session_history_metadata.parent_title',
-                   'session_history_metadata.year',
-                   'session_history_metadata.media_index',
-                   'session_history_metadata.parent_media_index',
-                   'session_history_metadata.content_rating',
-                   'session_history_metadata.labels',
-                   'session_history_metadata.live',
-                   'session_history_metadata.added_at',
-                   'session_history_metadata.originally_available_at',
-                   'session_history_metadata.guid',
-                   'library_sections.do_notify',
-                   'library_sections.do_notify_created',
-                   'library_sections.keep_history',
-                   'library_sections.is_active'
+                    session_history.paused_counter END) AS duration",
+                   "MAX(session_history.started) AS last_accessed",
+                   "MAX(session_history.id) AS history_row_id",
+                   "session_history_metadata.full_title AS last_played",
+                   "session_history.rating_key",
+                   "session_history_metadata.media_type",
+                   "session_history_metadata.thumb",
+                   "session_history_metadata.parent_thumb",
+                   "session_history_metadata.grandparent_thumb",
+                   "session_history_metadata.parent_title",
+                   "session_history_metadata.year",
+                   "session_history_metadata.media_index",
+                   "session_history_metadata.parent_media_index",
+                   "session_history_metadata.content_rating",
+                   "session_history_metadata.labels",
+                   "session_history_metadata.live",
+                   "session_history_metadata.added_at",
+                   "session_history_metadata.originally_available_at",
+                   "session_history_metadata.guid",
+                   "library_sections.do_notify",
+                   "library_sections.do_notify_created",
+                   "library_sections.keep_history",
+                   "library_sections.is_active"
                    ]
         try:
             query = data_tables.ssp_query(table_name='library_sections',
@@ -499,11 +499,11 @@ class Libraries(object):
             group_by = 'rating_key'
 
         try:
-            query = 'SELECT MAX(started) AS last_played, COUNT(DISTINCT %s) AS play_count, ' \
-                    'rating_key, parent_rating_key, grandparent_rating_key ' \
-                    'FROM session_history ' \
-                    'WHERE section_id = ? ' \
-                    'GROUP BY %s ' % (count_by, group_by)
+            query = "SELECT MAX(started) AS last_played, COUNT(DISTINCT %s) AS play_count, " \
+                    "rating_key, parent_rating_key, grandparent_rating_key " \
+                    "FROM session_history " \
+                    "WHERE section_id = ? " \
+                    "GROUP BY %s " % (count_by, group_by)
             result = monitor_db.select(query, args=[section_id])
         except Exception as e:
             logger.warn("Tautulli Libraries :: Unable to execute database query for get_datatables_media_info2: %s." % e)
@@ -838,27 +838,27 @@ class Libraries(object):
         last_accessed = 'NULL'
         join = ''
         if include_last_accessed:
-            last_accessed = 'MAX(session_history.started)'
-            join = 'LEFT OUTER JOIN session_history ON library_sections.section_id = session_history.section_id ' \
+            last_accessed = "MAX(session_history.started)"
+            join = "LEFT OUTER JOIN session_history ON library_sections.section_id = session_history.section_id " \
 
         monitor_db = database.MonitorDatabase()
 
         try:
             if str(section_id).isdigit():
-                where = 'library_sections.section_id = ?'
+                where = "library_sections.section_id = ?"
                 args = [section_id]
             else:
                 raise Exception('Missing section_id')
 
-            query = 'SELECT library_sections.id AS row_id, server_id, library_sections.section_id, ' \
-                    'section_name, section_type, ' \
-                    'count, parent_count, child_count, ' \
-                    'library_sections.thumb AS library_thumb, custom_thumb_url AS custom_thumb, ' \
-                    'library_sections.art AS library_art, ' \
-                    'custom_art_url AS custom_art, is_active, ' \
-                    'do_notify, do_notify_created, keep_history, deleted_section, %s AS last_accessed ' \
-                    'FROM library_sections %s ' \
-                    'WHERE %s AND server_id = ? ' % (last_accessed, join, where)
+            query = "SELECT library_sections.id AS row_id, server_id, library_sections.section_id, " \
+                    "section_name, section_type, " \
+                    "count, parent_count, child_count, " \
+                    "library_sections.thumb AS library_thumb, custom_thumb_url AS custom_thumb, " \
+                    "library_sections.art AS library_art, " \
+                    "custom_art_url AS custom_art, is_active, " \
+                    "do_notify, do_notify_created, keep_history, deleted_section, %s AS last_accessed " \
+                    "FROM library_sections %s " \
+                    "WHERE %s AND server_id = ? " % (last_accessed, join, where)
             result = monitor_db.select(query, args=args + [server_id])
         except Exception as e:
             logger.warn("Tautulli Libraries :: Unable to execute database query for get_library_details: %s." % e)
@@ -924,24 +924,24 @@ class Libraries(object):
             try:
                 if days > 0:
                     if str(section_id).isdigit():
-                        query = 'SELECT (SUM(stopped - started) - ' \
-                                'SUM(CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END)) AS total_time, ' \
-                                'COUNT(DISTINCT %s) AS total_plays ' \
-                                'FROM session_history ' \
-                                'JOIN session_history_metadata ON session_history_metadata.id = session_history.id ' \
-                                'WHERE stopped >= %s ' \
-                                'AND section_id = ?' % (group_by, timestamp_query)
+                        query = "SELECT (SUM(stopped - started) - " \
+                                "SUM(CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END)) AS total_time, " \
+                                "COUNT(DISTINCT %s) AS total_plays " \
+                                "FROM session_history " \
+                                "JOIN session_history_metadata ON session_history_metadata.id = session_history.id " \
+                                "WHERE stopped >= %s " \
+                                "AND section_id = ?" % (group_by, timestamp_query)
                         result = monitor_db.select(query, args=[section_id])
                     else:
                         result = []
                 else:
                     if str(section_id).isdigit():
-                        query = 'SELECT (SUM(stopped - started) - ' \
-                                'SUM(CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END)) AS total_time, ' \
-                                'COUNT(DISTINCT %s) AS total_plays ' \
-                                'FROM session_history ' \
-                                'JOIN session_history_metadata ON session_history_metadata.id = session_history.id ' \
-                                'WHERE section_id = ?' % group_by
+                        query = "SELECT (SUM(stopped - started) - " \
+                                "SUM(CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END)) AS total_time, " \
+                                "COUNT(DISTINCT %s) AS total_plays " \
+                                "FROM session_history " \
+                                "JOIN session_history_metadata ON session_history_metadata.id = session_history.id " \
+                                "WHERE section_id = ?" % group_by
                         result = monitor_db.select(query, args=[section_id])
                     else:
                         result = []
@@ -981,17 +981,17 @@ class Libraries(object):
 
         try:
             if str(section_id).isdigit():
-                query = 'SELECT (CASE WHEN users.friendly_name IS NULL OR TRIM(users.friendly_name) = "" ' \
-                        'THEN users.username ELSE users.friendly_name END) AS friendly_name, ' \
-                        'users.user_id, users.username, users.thumb, users.custom_avatar_url AS custom_thumb, ' \
-                        'COUNT(DISTINCT %s) AS total_plays, (SUM(stopped - started) - ' \
-                        'SUM(CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END)) AS total_time ' \
-                        'FROM session_history ' \
-                        'JOIN session_history_metadata ON session_history_metadata.id = session_history.id ' \
-                        'JOIN users ON users.user_id = session_history.user_id ' \
-                        'WHERE section_id = ? ' \
-                        'GROUP BY users.user_id ' \
-                        'ORDER BY total_plays DESC, total_time DESC' % group_by
+                query = "SELECT (CASE WHEN users.friendly_name IS NULL OR TRIM(users.friendly_name) = '' " \
+                        "THEN users.username ELSE users.friendly_name END) AS friendly_name, " \
+                        "users.user_id, users.username, users.thumb, users.custom_avatar_url AS custom_thumb, " \
+                        "COUNT(DISTINCT %s) AS total_plays, (SUM(stopped - started) - " \
+                        "SUM(CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END)) AS total_time " \
+                        "FROM session_history " \
+                        "JOIN session_history_metadata ON session_history_metadata.id = session_history.id " \
+                        "JOIN users ON users.user_id = session_history.user_id " \
+                        "WHERE section_id = ? " \
+                        "GROUP BY users.user_id " \
+                        "ORDER BY total_plays DESC, total_time DESC" % group_by
                 result = monitor_db.select(query, args=[section_id])
             else:
                 result = []
@@ -1030,16 +1030,16 @@ class Libraries(object):
 
         try:
             if str(section_id).isdigit():
-                query = 'SELECT session_history.id, session_history.media_type, guid, ' \
-                        'session_history.rating_key, session_history.parent_rating_key, session_history.grandparent_rating_key, ' \
-                        'title, parent_title, grandparent_title, original_title, ' \
-                        'thumb, parent_thumb, grandparent_thumb, media_index, parent_media_index, ' \
-                        'year, originally_available_at, added_at, live, started, user, content_rating, labels, section_id ' \
-                        'FROM session_history_metadata ' \
-                        'JOIN session_history ON session_history_metadata.id = session_history.id ' \
-                        'WHERE section_id = ? ' \
-                        'GROUP BY session_history.rating_key ' \
-                        'ORDER BY MAX(started) DESC LIMIT ?'
+                query = "SELECT session_history.id, session_history.media_type, guid, " \
+                        "session_history.rating_key, session_history.parent_rating_key, session_history.grandparent_rating_key, " \
+                        "title, parent_title, grandparent_title, original_title, " \
+                        "thumb, parent_thumb, grandparent_thumb, media_index, parent_media_index, " \
+                        "year, originally_available_at, added_at, live, started, user, content_rating, labels, section_id " \
+                        "FROM session_history_metadata " \
+                        "JOIN session_history ON session_history_metadata.id = session_history.id " \
+                        "WHERE section_id = ? " \
+                        "GROUP BY session_history.rating_key " \
+                        "ORDER BY MAX(started) DESC LIMIT ?"
                 result = monitor_db.select(query, args=[section_id, limit])
             else:
                 result = []
@@ -1085,8 +1085,8 @@ class Libraries(object):
         monitor_db = database.MonitorDatabase()
 
         try:
-            query = 'SELECT section_id, section_name, section_type, agent ' \
-                    'FROM library_sections WHERE deleted_section = 0'
+            query = "SELECT section_id, section_name, section_type, agent " \
+                    "FROM library_sections WHERE deleted_section = 0"
             result = monitor_db.select(query=query)
         except Exception as e:
             logger.warn("Tautulli Libraries :: Unable to execute database query for get_sections: %s." % e)
@@ -1110,8 +1110,8 @@ class Libraries(object):
             row_ids = list(map(helpers.cast_to_int, row_ids.split(',')))
 
             # Get the section_ids corresponding to the row_ids
-            result = monitor_db.select('SELECT server_id, section_id FROM library_sections '
-                                       'WHERE id IN ({})'.format(','.join(['?'] * len(row_ids))), row_ids)
+            result = monitor_db.select("SELECT server_id, section_id FROM library_sections "
+                                       "WHERE id IN ({})".format(",".join(["?"] * len(row_ids))), row_ids)
 
             success = []
             for library in result:
@@ -1135,9 +1135,9 @@ class Libraries(object):
                 logger.info("Tautulli Libraries :: Deleting library with server_id %s and section_id %s from database."
                             % (server_id, section_id))
                 try:
-                    monitor_db.action('UPDATE library_sections '
-                                      'SET deleted_section = 1, keep_history = 0, do_notify = 0, do_notify_created = 0 '
-                                      'WHERE server_id = ? AND section_id = ?', [server_id, section_id])
+                    monitor_db.action("UPDATE library_sections "
+                                      "SET deleted_section = 1, keep_history = 0, do_notify = 0, do_notify_created = 0 "
+                                      "WHERE server_id = ? AND section_id = ?", [server_id, section_id])
                     return delete_success
                 except Exception as e:
                     logger.warn("Tautulli Libraries :: Unable to execute database query for delete: %s." % e)
@@ -1150,26 +1150,26 @@ class Libraries(object):
 
         try:
             if section_id and section_id.isdigit():
-                query = 'SELECT * FROM library_sections WHERE section_id = ?'
+                query = "SELECT * FROM library_sections WHERE section_id = ?"
                 result = monitor_db.select(query=query, args=[section_id])
                 if result:
                     logger.info("Tautulli Libraries :: Re-adding library with id %s to database." % section_id)
-                    monitor_db.action('UPDATE library_sections '
-                                      'SET deleted_section = 0, keep_history = 1, do_notify = 1, do_notify_created = 1 '
-                                      'WHERE section_id = ?',
+                    monitor_db.action("UPDATE library_sections "
+                                      "SET deleted_section = 0, keep_history = 1, do_notify = 1, do_notify_created = 1 "
+                                      "WHERE section_id = ?",
                                       [section_id])
                     return True
                 else:
                     return False
 
             elif section_name:
-                query = 'SELECT * FROM library_sections WHERE section_name = ?'
+                query = "SELECT * FROM library_sections WHERE section_name = ?"
                 result = monitor_db.select(query=query, args=[section_name])
                 if result:
                     logger.info("Tautulli Libraries :: Re-adding library with name %s to database." % section_name)
-                    monitor_db.action('UPDATE library_sections '
-                                      'SET deleted_section = 0, keep_history = 1, do_notify = 1, do_notify_created = 1 '
-                                      'WHERE section_name = ?',
+                    monitor_db.action("UPDATE library_sections "
+                                      "SET deleted_section = 0, keep_history = 1, do_notify = 1, do_notify_created = 1 "
+                                      "WHERE section_name = ?",
                                       [section_name])
                     return True
                 else:
@@ -1203,7 +1203,7 @@ class Libraries(object):
 
         try:
             logger.debug("Tautulli Libraries :: Deleting libraries where server_id does not match %s." % server_id)
-            monitor_db.action('DELETE FROM library_sections WHERE server_id != ?', [server_id])
+            monitor_db.action("DELETE FROM library_sections WHERE server_id != ?", [server_id])
 
             return 'Deleted duplicate libraries from the database.'
         except Exception as e:
diff --git a/plexpy/mobile_app.py b/plexpy/mobile_app.py
index 458f84a0..57734975 100644
--- a/plexpy/mobile_app.py
+++ b/plexpy/mobile_app.py
@@ -67,17 +67,17 @@ def get_mobile_devices(device_id=None, device_token=None):
     args = []
 
     if device_id or device_token:
-        where = 'WHERE '
+        where = "WHERE "
         if device_id:
-            where_id += 'device_id = ?'
+            where_id += "device_id = ?"
             args.append(device_id)
         if device_token:
-            where_token = 'device_token = ?'
+            where_token = "device_token = ?"
             args.append(device_token)
-        where += ' AND '.join([w for w in [where_id, where_token] if w])
+        where += " AND ".join([w for w in [where_id, where_token] if w])
 
     db = database.MonitorDatabase()
-    result = db.select('SELECT * FROM mobile_devices %s' % where, args=args)
+    result = db.select("SELECT * FROM mobile_devices %s" % where, args=args)
 
     return result
 
@@ -128,7 +128,7 @@ def get_mobile_device_config(mobile_device_id=None):
         return None
 
     db = database.MonitorDatabase()
-    result = db.select_single('SELECT * FROM mobile_devices WHERE id = ?',
+    result = db.select_single("SELECT * FROM mobile_devices WHERE id = ?",
                               args=[mobile_device_id])
 
     if result['onesignal_id'] == _ONESIGNAL_DISABLED:
@@ -163,11 +163,11 @@ def delete_mobile_device(mobile_device_id=None, device_id=None):
 
     if mobile_device_id:
         logger.debug("Tautulli MobileApp :: Deleting mobile_device_id %s from the database." % mobile_device_id)
-        result = db.action('DELETE FROM mobile_devices WHERE id = ?', args=[mobile_device_id])
+        result = db.action("DELETE FROM mobile_devices WHERE id = ?", args=[mobile_device_id])
         return True
     elif device_id:
         logger.debug("Tautulli MobileApp :: Deleting device_id %s from the database." % device_id)
-        result = db.action('DELETE FROM mobile_devices WHERE device_id = ?', args=[device_id])
+        result = db.action("DELETE FROM mobile_devices WHERE device_id = ?", args=[device_id])
         return True
     else:
         return False
@@ -179,9 +179,9 @@ def set_official(device_id, onesignal_id):
     platform = 'android' if official > 0 else None
 
     try:
-        result = db.action('UPDATE mobile_devices '
-                           'SET official = ?, platform = coalesce(platform, ?) '
-                           'WHERE device_id = ?',
+        result = db.action("UPDATE mobile_devices "
+                           "SET official = ?, platform = coalesce(platform, ?) "
+                           "WHERE device_id = ?",
                            args=[official, platform, device_id])
     except Exception as e:
         logger.warn("Tautulli MobileApp :: Failed to set official flag for device: %s." % e)
@@ -193,7 +193,7 @@ def set_last_seen(device_token=None):
     last_seen = helpers.timestamp()
 
     try:
-        result = db.action('UPDATE mobile_devices SET last_seen = ? WHERE device_token = ?',
+        result = db.action("UPDATE mobile_devices SET last_seen = ? WHERE device_token = ?",
                            args=[last_seen, device_token])
     except Exception as e:
         logger.warn("Tautulli MobileApp :: Failed to set last_seen time for device: %s." % e)
diff --git a/plexpy/newsletter_handler.py b/plexpy/newsletter_handler.py
index 8458e144..471a5984 100644
--- a/plexpy/newsletter_handler.py
+++ b/plexpy/newsletter_handler.py
@@ -181,9 +181,9 @@ def set_notify_success(newsletter_log_id):
 def get_last_newsletter_email_msg_id(newsletter_id, notify_action):
     db = database.MonitorDatabase()
 
-    result = db.select_single('SELECT email_msg_id FROM newsletter_log '
-                              'WHERE newsletter_id = ? AND notify_action = ? AND success = 1 '
-                              'ORDER BY timestamp DESC LIMIT 1', [newsletter_id, notify_action])
+    result = db.select_single("SELECT email_msg_id FROM newsletter_log "
+                              "WHERE newsletter_id = ? AND notify_action = ? AND success = 1 "
+                              "ORDER BY timestamp DESC LIMIT 1", [newsletter_id, notify_action])
 
     if result:
         return result['email_msg_id']
@@ -193,13 +193,13 @@ def get_newsletter(newsletter_uuid=None, newsletter_id_name=None):
     db = database.MonitorDatabase()
 
     if newsletter_uuid:
-        result = db.select_single('SELECT start_date, end_date, uuid, filename FROM newsletter_log '
-                                  'WHERE uuid = ?', [newsletter_uuid])
+        result = db.select_single("SELECT start_date, end_date, uuid, filename FROM newsletter_log "
+                                  "WHERE uuid = ?", [newsletter_uuid])
     elif newsletter_id_name:
-        result = db.select_single('SELECT start_date, end_date, uuid, filename FROM newsletter_log '
-                                  'JOIN newsletters ON newsletters.id = newsletter_log.newsletter_id '
-                                  'WHERE id_name = ? AND notify_action != "test" '
-                                  'ORDER BY timestamp DESC LIMIT 1', [newsletter_id_name])
+        result = db.select_single("SELECT start_date, end_date, uuid, filename FROM newsletter_log "
+                                  "JOIN newsletters ON newsletters.id = newsletter_log.newsletter_id "
+                                  "WHERE id_name = ? AND notify_action != 'test' "
+                                  "ORDER BY timestamp DESC LIMIT 1", [newsletter_id_name])
     else:
         result = None
 
diff --git a/plexpy/newsletters.py b/plexpy/newsletters.py
index 59663fe2..94f73c8f 100644
--- a/plexpy/newsletters.py
+++ b/plexpy/newsletters.py
@@ -117,15 +117,15 @@ def get_newsletters(newsletter_id=None):
     args = []
 
     if newsletter_id:
-        where = 'WHERE '
+        where = "WHERE "
         if newsletter_id:
-            where_id += 'id = ?'
+            where_id += "id = ?"
             args.append(newsletter_id)
-        where += ' AND '.join([w for w in [where_id] if w])
+        where += " AND ".join([w for w in [where_id] if w])
 
     db = database.MonitorDatabase()
-    result = db.select('SELECT id, agent_id, agent_name, agent_label, '
-                       'friendly_name, cron, active FROM newsletters %s' % where, args=args)
+    result = db.select("SELECT id, agent_id, agent_name, agent_label, "
+                       "friendly_name, cron, active FROM newsletters %s" % where, args=args)
 
     return result
 
@@ -136,7 +136,7 @@ def delete_newsletter(newsletter_id=None):
     if str(newsletter_id).isdigit():
         logger.debug("Tautulli Newsletters :: Deleting newsletter_id %s from the database."
                      % newsletter_id)
-        result = db.action('DELETE FROM newsletters WHERE id = ?', args=[newsletter_id])
+        result = db.action("DELETE FROM newsletters WHERE id = ?", args=[newsletter_id])
         return True
     else:
         return False
@@ -151,7 +151,7 @@ def get_newsletter_config(newsletter_id=None, mask_passwords=False):
         return None
 
     db = database.MonitorDatabase()
-    result = db.select_single('SELECT * FROM newsletters WHERE id = ?', args=[newsletter_id])
+    result = db.select_single("SELECT * FROM newsletters WHERE id = ?", args=[newsletter_id])
 
     if not result:
         return None
@@ -309,7 +309,7 @@ def send_newsletter(newsletter_id=None, subject=None, body=None, message=None, n
 
 def blacklist_logger():
     db = database.MonitorDatabase()
-    notifiers = db.select('SELECT newsletter_config, email_config FROM newsletters')
+    notifiers = db.select("SELECT newsletter_config, email_config FROM newsletters")
 
     for n in notifiers:
         config = json.loads(n['newsletter_config'] or '{}')
@@ -346,7 +346,7 @@ def generate_newsletter_uuid():
     while not uuid or uuid_exists:
         uuid = plexpy.generate_uuid()[:8]
         result = db.select_single(
-            'SELECT EXISTS(SELECT uuid FROM newsletter_log WHERE uuid = ?) as uuid_exists', [uuid])
+            "SELECT EXISTS(SELECT uuid FROM newsletter_log WHERE uuid = ?) as uuid_exists", [uuid])
         uuid_exists = result['uuid_exists']
 
     return uuid
diff --git a/plexpy/notification_handler.py b/plexpy/notification_handler.py
index 2171d2bd..7dd81627 100644
--- a/plexpy/notification_handler.py
+++ b/plexpy/notification_handler.py
@@ -443,12 +443,12 @@ def notify(notifier_id=None, notify_action=None, stream_data=None, timeline_data
 
 def get_notify_state(session):
     monitor_db = database.MonitorDatabase()
-    result = monitor_db.select('SELECT timestamp, notify_action, notifier_id '
-                               'FROM notify_log '
-                               'WHERE session_key = ? '
-                               'AND rating_key = ? '
-                               'AND user_id = ? '
-                               'ORDER BY id DESC',
+    result = monitor_db.select("SELECT timestamp, notify_action, notifier_id "
+                               "FROM notify_log "
+                               "WHERE session_key = ? "
+                               "AND rating_key = ? "
+                               "AND user_id = ? "
+                               "ORDER BY id DESC",
                                args=[session['session_key'], session['rating_key'], session['user_id']])
     notify_states = []
     for item in result:
@@ -467,16 +467,16 @@ def get_notify_state_enabled(session, notify_action, notified=True):
         timestamp_where = 'AND timestamp IS NULL'
 
     monitor_db = database.MonitorDatabase()
-    result = monitor_db.select('SELECT id AS notifier_id, timestamp '
-                               'FROM notifiers '
-                               'LEFT OUTER JOIN ('
-                               'SELECT timestamp, notifier_id '
-                               'FROM notify_log '
-                               'WHERE session_key = ? '
-                               'AND rating_key = ? '
-                               'AND user_id = ? '
-                               'AND notify_action = ?) AS t ON notifiers.id = t.notifier_id '
-                               'WHERE %s = 1 %s' % (notify_action, timestamp_where),
+    result = monitor_db.select("SELECT id AS notifier_id, timestamp "
+                               "FROM notifiers "
+                               "LEFT OUTER JOIN ("
+                               "SELECT timestamp, notifier_id "
+                               "FROM notify_log "
+                               "WHERE session_key = ? "
+                               "AND rating_key = ? "
+                               "AND user_id = ? "
+                               "AND notify_action = ?) AS t ON notifiers.id = t.notifier_id "
+                               "WHERE %s = 1 %s" % (notify_action, timestamp_where),
                                args=[session['session_key'], session['rating_key'], session['user_id'], notify_action])
 
     return result
@@ -528,8 +528,8 @@ def set_notify_success(notification_id):
 
 def check_nofity_tag(notify_action, tag):
     monitor_db = database.MonitorDatabase()
-    result = monitor_db.select_single('SELECT * FROM notify_log '
-                                      'WHERE notify_action = ? AND tag = ?',
+    result = monitor_db.select_single("SELECT * FROM notify_log "
+                                      "WHERE notify_action = ? AND tag = ?",
                                       [notify_action, tag])
     return bool(result)
 
@@ -1631,7 +1631,7 @@ def set_hash_image_info(img=None, rating_key=None, width=750, height=1000,
 
 def get_hash_image_info(img_hash=None):
     db = database.MonitorDatabase()
-    query = 'SELECT * FROM image_hash_lookup WHERE img_hash = ?'
+    query = "SELECT * FROM image_hash_lookup WHERE img_hash = ?"
     result = db.select_single(query, args=[img_hash])
     return result
 
@@ -1640,8 +1640,8 @@ def lookup_tvmaze_by_id(rating_key=None, thetvdb_id=None, imdb_id=None, title=No
     db = database.MonitorDatabase()
 
     try:
-        query = 'SELECT imdb_id, tvmaze_id, tvmaze_url FROM tvmaze_lookup ' \
-                'WHERE rating_key = ?'
+        query = "SELECT imdb_id, tvmaze_id, tvmaze_url FROM tvmaze_lookup " \
+                "WHERE rating_key = ?"
         tvmaze_info = db.select_single(query, args=[rating_key])
     except Exception as e:
         logger.warn("Tautulli NotificationHandler :: Unable to execute database query for lookup_tvmaze_by_tvdb_id: %s." % e)
@@ -1700,8 +1700,8 @@ def lookup_themoviedb_by_id(rating_key=None, thetvdb_id=None, imdb_id=None, titl
     db = database.MonitorDatabase()
 
     try:
-        query = 'SELECT thetvdb_id, imdb_id, themoviedb_id, themoviedb_url FROM themoviedb_lookup ' \
-                'WHERE rating_key = ?'
+        query = "SELECT thetvdb_id, imdb_id, themoviedb_id, themoviedb_url FROM themoviedb_lookup " \
+                "WHERE rating_key = ?"
         themoviedb_info = db.select_single(query, args=[rating_key])
     except Exception as e:
         logger.warn("Tautulli NotificationHandler :: Unable to execute database query for lookup_themoviedb_by_imdb_id: %s." % e)
@@ -1778,8 +1778,8 @@ def get_themoviedb_info(rating_key=None, media_type=None, themoviedb_id=None):
     db = database.MonitorDatabase()
 
     try:
-        query = 'SELECT themoviedb_json FROM themoviedb_lookup ' \
-                'WHERE rating_key = ?'
+        query = "SELECT themoviedb_json FROM themoviedb_lookup " \
+                "WHERE rating_key = ?"
         result = db.select_single(query, args=[rating_key])
     except Exception as e:
         logger.warn("Tautulli NotificationHandler :: Unable to execute database query for get_themoviedb_info: %s." % e)
@@ -1829,8 +1829,8 @@ def lookup_musicbrainz_info(musicbrainz_type=None, rating_key=None, artist=None,
     db = database.MonitorDatabase()
 
     try:
-        query = 'SELECT musicbrainz_id, musicbrainz_url, musicbrainz_type FROM musicbrainz_lookup ' \
-                'WHERE rating_key = ?'
+        query = "SELECT musicbrainz_id, musicbrainz_url, musicbrainz_type FROM musicbrainz_lookup " \
+                "WHERE rating_key = ?"
         musicbrainz_info = db.select_single(query, args=[rating_key])
     except Exception as e:
         logger.warn("Tautulli NotificationHandler :: Unable to execute database query for lookup_musicbrainz: %s." % e)
diff --git a/plexpy/notifiers.py b/plexpy/notifiers.py
index c7580603..a2fa6341 100644
--- a/plexpy/notifiers.py
+++ b/plexpy/notifiers.py
@@ -507,7 +507,7 @@ def get_notifiers(notifier_id=None, notify_action=None):
         where += ' AND '.join([w for w in [where_id, where_action] if w])
 
     db = database.MonitorDatabase()
-    result = db.select('SELECT id, agent_id, agent_name, agent_label, friendly_name, %s FROM notifiers %s'
+    result = db.select("SELECT id, agent_id, agent_name, agent_label, friendly_name, %s FROM notifiers %s"
                        % (', '.join(notify_actions), where), args=args)
 
     for item in result:
@@ -522,7 +522,7 @@ def delete_notifier(notifier_id=None):
     if str(notifier_id).isdigit():
         logger.debug("Tautulli Notifiers :: Deleting notifier_id %s from the database."
                      % notifier_id)
-        result = db.action('DELETE FROM notifiers WHERE id = ?', args=[notifier_id])
+        result = db.action("DELETE FROM notifiers WHERE id = ?", args=[notifier_id])
         return True
     else:
         return False
@@ -537,7 +537,7 @@ def get_notifier_config(notifier_id=None, mask_passwords=False):
         return None
 
     db = database.MonitorDatabase()
-    result = db.select_single('SELECT * FROM notifiers WHERE id = ?', args=[notifier_id])
+    result = db.select_single("SELECT * FROM notifiers WHERE id = ?", args=[notifier_id])
 
     if not result:
         return None
@@ -3866,8 +3866,8 @@ class TAUTULLIREMOTEAPP(Notifier):
         db = database.MonitorDatabase()
 
         try:
-            query = 'SELECT * FROM mobile_devices WHERE official = 1 ' \
-                    'AND onesignal_id IS NOT NULL AND onesignal_id != ""'
+            query = "SELECT * FROM mobile_devices WHERE official = 1 " \
+                    "AND onesignal_id IS NOT NULL AND onesignal_id != ''"
             return db.select(query=query)
         except Exception as e:
             logger.warn("Tautulli Notifiers :: Unable to retrieve Tautulli Remote app devices list: %s." % e)
@@ -4472,8 +4472,8 @@ def check_browser_enabled():
 
 def get_browser_notifications():
     db = database.MonitorDatabase()
-    result = db.select('SELECT notifier_id, subject_text, body_text FROM notify_log '
-                       'WHERE agent_id = 17 AND timestamp >= ? ',
+    result = db.select("SELECT notifier_id, subject_text, body_text FROM notify_log "
+                       "WHERE agent_id = 17 AND timestamp >= ? ",
                        args=[time.time() - 5])
 
     notifications = []
diff --git a/plexpy/plexivity_import.py b/plexpy/plexivity_import.py
index 3e5350bc..644782a2 100644
--- a/plexpy/plexivity_import.py
+++ b/plexpy/plexivity_import.py
@@ -304,27 +304,27 @@ def import_from_plexivity(database_file=None, table_name=None, import_ignore_int
         logger.debug("Tautulli Importer :: Unable to refresh the users list. Aborting import.")
         return None
 
-    query = 'SELECT id AS id, ' \
-            'time AS started, ' \
-            'stopped, ' \
-            'null AS user_id, ' \
-            'user, ' \
-            'ip_address, ' \
-            'paused_counter, ' \
-            'platform AS player, ' \
-            'null AS platform, ' \
-            'null as machine_id, ' \
-            'null AS media_type, ' \
-            'null AS view_offset, ' \
-            'xml, ' \
-            'rating as content_rating,' \
-            'summary,' \
-            'title AS full_title,' \
-            '(case when orig_title_ep = "n/a" then orig_title else ' \
-            'orig_title_ep end) as title,' \
-            '(case when orig_title_ep != "n/a" then orig_title else ' \
-            'null end) as grandparent_title ' \
-            'FROM ' + table_name + ' ORDER BY id'
+    query = "SELECT id AS id, " \
+            "time AS started, " \
+            "stopped, " \
+            "null AS user_id, " \
+            "user, " \
+            "ip_address, " \
+            "paused_counter, " \
+            "platform AS player, " \
+            "null AS platform, " \
+            "null as machine_id, " \
+            "null AS media_type, " \
+            "null AS view_offset, " \
+            "xml, " \
+            "rating as content_rating," \
+            "summary," \
+            "title AS full_title," \
+            "(case when orig_title_ep = 'n/a' then orig_title else " \
+            "orig_title_ep end) as title," \
+            "(case when orig_title_ep != 'n/a' then orig_title else " \
+            "null end) as grandparent_title " \
+            "FROM " + table_name + " ORDER BY id"
 
     result = connection.execute(query)
 
@@ -456,9 +456,9 @@ def import_users():
     logger.debug("Tautulli Importer :: Importing Plexivity Users...")
     monitor_db = database.MonitorDatabase()
 
-    query = 'INSERT OR IGNORE INTO users (user_id, username) ' \
-            'SELECT user_id, user ' \
-            'FROM session_history WHERE user_id != 1 GROUP BY user_id'
+    query = "INSERT OR IGNORE INTO users (user_id, username) " \
+            "SELECT user_id, user " \
+            "FROM session_history WHERE user_id != 1 GROUP BY user_id"
 
     try:
         monitor_db.action(query)
diff --git a/plexpy/plexwatch_import.py b/plexpy/plexwatch_import.py
index ac0fd7b0..4d8ec80b 100644
--- a/plexpy/plexwatch_import.py
+++ b/plexpy/plexwatch_import.py
@@ -295,29 +295,29 @@ def import_from_plexwatch(database_file=None, table_name=None, import_ignore_int
         logger.debug("Tautulli Importer :: Unable to refresh the users list. Aborting import.")
         return None
 
-    query = 'SELECT time AS started, ' \
-            'stopped, ' \
-            'cast(ratingKey as text) AS rating_key, ' \
-            'null AS user_id, ' \
-            'user, ' \
-            'ip_address, ' \
-            'paused_counter, ' \
-            'platform AS player, ' \
-            'null AS platform, ' \
-            'null as machine_id, ' \
-            'parentRatingKey as parent_rating_key, ' \
-            'grandparentRatingKey as grandparent_rating_key, ' \
-            'null AS media_type, ' \
-            'null AS view_offset, ' \
-            'xml, ' \
-            'rating as content_rating,' \
-            'summary,' \
-            'title AS full_title,' \
-            '(case when orig_title_ep = "" then orig_title else ' \
-            'orig_title_ep end) as title,' \
-            '(case when orig_title_ep != "" then orig_title else ' \
-            'null end) as grandparent_title ' \
-            'FROM ' + table_name + ' ORDER BY id'
+    query = "SELECT time AS started, " \
+            "stopped, " \
+            "cast(ratingKey as text) AS rating_key, " \
+            "null AS user_id, " \
+            "user, " \
+            "ip_address, " \
+            "paused_counter, " \
+            "platform AS player, " \
+            "null AS platform, " \
+            "null as machine_id, " \
+            "parentRatingKey as parent_rating_key, " \
+            "grandparentRatingKey as grandparent_rating_key, " \
+            "null AS media_type, " \
+            "null AS view_offset, " \
+            "xml, " \
+            "rating as content_rating," \
+            "summary," \
+            "title AS full_title," \
+            "(case when orig_title_ep = '' then orig_title else " \
+            "orig_title_ep end) as title," \
+            "(case when orig_title_ep != '' then orig_title else " \
+            "null end) as grandparent_title " \
+            "FROM " + table_name + " ORDER BY id"
 
     result = connection.execute(query)
 
@@ -450,9 +450,9 @@ def import_users():
     logger.debug("Tautulli Importer :: Importing PlexWatch Users...")
     monitor_db = database.MonitorDatabase()
 
-    query = 'INSERT OR IGNORE INTO users (user_id, username) ' \
-            'SELECT user_id, user ' \
-            'FROM session_history WHERE user_id != 1 GROUP BY user_id'
+    query = "INSERT OR IGNORE INTO users (user_id, username) " \
+            "SELECT user_id, user " \
+            "FROM session_history WHERE user_id != 1 GROUP BY user_id"
 
     try:
         monitor_db.action(query)
diff --git a/plexpy/users.py b/plexpy/users.py
index 5ec093ff..0e201791 100644
--- a/plexpy/users.py
+++ b/plexpy/users.py
@@ -75,8 +75,8 @@ def refresh_users():
 
             # Check if we've set a custom avatar if so don't overwrite it.
             if keys_dict['user_id']:
-                avatar_urls = monitor_db.select('SELECT thumb, custom_avatar_url '
-                                                'FROM users WHERE user_id = ?',
+                avatar_urls = monitor_db.select("SELECT thumb, custom_avatar_url "
+                                                "FROM users WHERE user_id = ?",
                                                 [keys_dict['user_id']])
                 if avatar_urls:
                     if not avatar_urls[0]['custom_avatar_url'] or \
@@ -98,7 +98,7 @@ def refresh_users():
             if result == 'insert':
                 new_users.append(item['username'])
 
-        query = 'UPDATE users SET is_active = 0 WHERE user_id NOT IN ({})'.format(', '.join(['?'] * len(user_ids)))
+        query = "UPDATE users SET is_active = 0 WHERE user_id NOT IN ({})".format(", ".join(["?"] * len(user_ids)))
         monitor_db.action(query=query, args=user_ids)
 
         # Add new users to loger username filter
@@ -137,43 +137,43 @@ class Users(object):
 
         group_by = 'session_history.reference_id' if grouping else 'session_history.id'
 
-        columns = ['users.id AS row_id',
-                   'users.user_id',
-                   'users.username',
-                   '(CASE WHEN users.friendly_name IS NULL OR TRIM(users.friendly_name) = "" \
-                    THEN users.username ELSE users.friendly_name END) AS friendly_name',
-                   'users.title',
-                   'users.email',
-                   'users.thumb AS user_thumb',
-                   'users.custom_avatar_url AS custom_thumb',
-                   'COUNT(DISTINCT %s) AS plays' % group_by,
-                   'SUM(CASE WHEN session_history.stopped > 0 THEN (session_history.stopped - session_history.started) \
+        columns = ["users.id AS row_id",
+                   "users.user_id",
+                   "users.username",
+                   "(CASE WHEN users.friendly_name IS NULL OR TRIM(users.friendly_name) = '' \
+                    THEN users.username ELSE users.friendly_name END) AS friendly_name",
+                   "users.title",
+                   "users.email",
+                   "users.thumb AS user_thumb",
+                   "users.custom_avatar_url AS custom_thumb",
+                   "COUNT(DISTINCT %s) AS plays" % group_by,
+                   "SUM(CASE WHEN session_history.stopped > 0 THEN (session_history.stopped - session_history.started) \
                     ELSE 0 END) - SUM(CASE WHEN session_history.paused_counter IS NULL THEN 0 ELSE \
-                    session_history.paused_counter END) AS duration',
-                   'MAX(session_history.started) AS last_seen',
-                   'MAX(session_history.id) AS history_row_id',
-                   'session_history_metadata.full_title AS last_played',
-                   'session_history.ip_address',
-                   'session_history.platform',
-                   'session_history.player',
-                   'session_history.rating_key',
-                   'session_history_metadata.media_type',
-                   'session_history_metadata.thumb',
-                   'session_history_metadata.parent_thumb',
-                   'session_history_metadata.grandparent_thumb',
-                   'session_history_metadata.parent_title',
-                   'session_history_metadata.year',
-                   'session_history_metadata.media_index',
-                   'session_history_metadata.parent_media_index',
-                   'session_history_metadata.live',
-                   'session_history_metadata.added_at',
-                   'session_history_metadata.originally_available_at',
-                   'session_history_metadata.guid',
-                   'session_history_media_info.transcode_decision',
-                   'users.do_notify AS do_notify',
-                   'users.keep_history AS keep_history',
-                   'users.allow_guest AS allow_guest',
-                   'users.is_active AS is_active'
+                    session_history.paused_counter END) AS duration",
+                   "MAX(session_history.started) AS last_seen",
+                   "MAX(session_history.id) AS history_row_id",
+                   "session_history_metadata.full_title AS last_played",
+                   "session_history.ip_address",
+                   "session_history.platform",
+                   "session_history.player",
+                   "session_history.rating_key",
+                   "session_history_metadata.media_type",
+                   "session_history_metadata.thumb",
+                   "session_history_metadata.parent_thumb",
+                   "session_history_metadata.grandparent_thumb",
+                   "session_history_metadata.parent_title",
+                   "session_history_metadata.year",
+                   "session_history_metadata.media_index",
+                   "session_history_metadata.parent_media_index",
+                   "session_history_metadata.live",
+                   "session_history_metadata.added_at",
+                   "session_history_metadata.originally_available_at",
+                   "session_history_metadata.guid",
+                   "session_history_media_info.transcode_decision",
+                   "users.do_notify AS do_notify",
+                   "users.keep_history AS keep_history",
+                   "users.allow_guest AS allow_guest",
+                   "users.is_active AS is_active"
                    ]
         try:
             query = data_tables.ssp_query(table_name='users',
@@ -270,32 +270,32 @@ class Users(object):
 
         custom_where = ['users.user_id', user_id]
 
-        columns = ['session_history.id AS history_row_id',
-                   'MIN(session_history.started) AS first_seen',
-                   'MAX(session_history.started) AS last_seen',
-                   'session_history.ip_address',
-                   'COUNT(session_history.id) AS play_count',
-                   'session_history.platform',
-                   'session_history.player',
-                   'session_history.rating_key',
-                   'session_history_metadata.full_title AS last_played',
-                   'session_history_metadata.thumb',
-                   'session_history_metadata.parent_thumb',
-                   'session_history_metadata.grandparent_thumb',
-                   'session_history_metadata.media_type',
-                   'session_history_metadata.parent_title',
-                   'session_history_metadata.year',
-                   'session_history_metadata.media_index',
-                   'session_history_metadata.parent_media_index',
-                   'session_history_metadata.live',
-                   'session_history_metadata.added_at',
-                   'session_history_metadata.originally_available_at',
-                   'session_history_metadata.guid',
-                   'session_history_media_info.transcode_decision',
-                   'session_history.user',
-                   'session_history.user_id as custom_user_id',
-                   '(CASE WHEN users.friendly_name IS NULL OR TRIM(users.friendly_name) = "" \
-                    THEN users.username ELSE users.friendly_name END) AS friendly_name'
+        columns = ["session_history.id AS history_row_id",
+                   "MIN(session_history.started) AS first_seen",
+                   "MAX(session_history.started) AS last_seen",
+                   "session_history.ip_address",
+                   "COUNT(session_history.id) AS play_count",
+                   "session_history.platform",
+                   "session_history.player",
+                   "session_history.rating_key",
+                   "session_history_metadata.full_title AS last_played",
+                   "session_history_metadata.thumb",
+                   "session_history_metadata.parent_thumb",
+                   "session_history_metadata.grandparent_thumb",
+                   "session_history_metadata.media_type",
+                   "session_history_metadata.parent_title",
+                   "session_history_metadata.year",
+                   "session_history_metadata.media_index",
+                   "session_history_metadata.parent_media_index",
+                   "session_history_metadata.live",
+                   "session_history_metadata.added_at",
+                   "session_history_metadata.originally_available_at",
+                   "session_history_metadata.guid",
+                   "session_history_media_info.transcode_decision",
+                   "session_history.user",
+                   "session_history.user_id as custom_user_id",
+                   "(CASE WHEN users.friendly_name IS NULL OR TRIM(users.friendly_name) = '' \
+                    THEN users.username ELSE users.friendly_name END) AS friendly_name"
                    ]
 
         try:
@@ -436,31 +436,31 @@ class Users(object):
         last_seen = 'NULL'
         join = ''
         if include_last_seen:
-            last_seen = 'MAX(session_history.started)'
-            join = 'LEFT OUTER JOIN session_history ON users.user_id = session_history.user_id'
+            last_seen = "MAX(session_history.started)"
+            join = "LEFT OUTER JOIN session_history ON users.user_id = session_history.user_id"
 
         monitor_db = database.MonitorDatabase()
 
         try:
             if str(user_id).isdigit():
-                where = 'users.user_id = ?'
+                where = "users.user_id = ?"
                 args = [user_id]
             elif user:
-                where = 'users.username = ?'
+                where = "users.username = ?"
                 args = [user]
             elif email:
-                where = 'users.email = ?'
+                where = "users.email = ?"
                 args = [email]
             else:
-                raise Exception('Missing user_id, username, or email')
+                raise Exception("Missing user_id, username, or email")
 
-            query = 'SELECT users.id AS row_id, users.user_id, username, friendly_name, ' \
-                    'thumb AS user_thumb, custom_avatar_url AS custom_thumb, ' \
-                    'email, is_active, is_admin, is_home_user, is_allow_sync, is_restricted, ' \
-                    'do_notify, keep_history, deleted_user, ' \
-                    'allow_guest, shared_libraries, %s AS last_seen ' \
-                    'FROM users %s ' \
-                    'WHERE %s COLLATE NOCASE' % (last_seen, join, where)
+            query = "SELECT users.id AS row_id, users.user_id, username, friendly_name, " \
+                    "thumb AS user_thumb, custom_avatar_url AS custom_thumb, " \
+                    "email, is_active, is_admin, is_home_user, is_allow_sync, is_restricted, " \
+                    "do_notify, keep_history, deleted_user, " \
+                    "allow_guest, shared_libraries, %s AS last_seen " \
+                    "FROM users %s " \
+                    "WHERE %s COLLATE NOCASE" % (last_seen, join, where)
             result = monitor_db.select(query, args=args)
         except Exception as e:
             logger.warn("Tautulli Users :: Unable to execute database query for get_user_details: %s." % e)
@@ -531,22 +531,22 @@ class Users(object):
             try:
                 if days > 0:
                     if str(user_id).isdigit():
-                        query = 'SELECT (SUM(stopped - started) - ' \
-                                '   SUM(CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END)) AS total_time, ' \
-                                'COUNT(DISTINCT %s) AS total_plays ' \
-                                'FROM session_history ' \
-                                'WHERE stopped >= %s ' \
-                                'AND user_id = ? ' % (group_by, timestamp_query)
+                        query = "SELECT (SUM(stopped - started) - " \
+                                "   SUM(CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END)) AS total_time, " \
+                                "COUNT(DISTINCT %s) AS total_plays " \
+                                "FROM session_history " \
+                                "WHERE stopped >= %s " \
+                                "AND user_id = ? " % (group_by, timestamp_query)
                         result = monitor_db.select(query, args=[user_id])
                     else:
                         result = []
                 else:
                     if str(user_id).isdigit():
-                        query = 'SELECT (SUM(stopped - started) - ' \
-                                '   SUM(CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END)) AS total_time, ' \
-                                'COUNT(DISTINCT %s) AS total_plays ' \
-                                'FROM session_history ' \
-                                'WHERE user_id = ? ' % group_by
+                        query = "SELECT (SUM(stopped - started) - " \
+                                "   SUM(CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END)) AS total_time, " \
+                                "COUNT(DISTINCT %s) AS total_plays " \
+                                "FROM session_history " \
+                                "WHERE user_id = ? " % group_by
                         result = monitor_db.select(query, args=[user_id])
                     else:
                         result = []
@@ -587,13 +587,13 @@ class Users(object):
 
         try:
             if str(user_id).isdigit():
-                query = 'SELECT player, COUNT(DISTINCT %s) as total_plays, (SUM(stopped - started) - ' \
-                        'SUM(CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END)) AS total_time, ' \
-                        'platform ' \
-                        'FROM session_history ' \
-                        'WHERE user_id = ? ' \
-                        'GROUP BY player ' \
-                        'ORDER BY total_plays DESC, total_time DESC' % group_by
+                query = "SELECT player, COUNT(DISTINCT %s) as total_plays, (SUM(stopped - started) - " \
+                        "SUM(CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END)) AS total_time, " \
+                        "platform " \
+                        "FROM session_history " \
+                        "WHERE user_id = ? " \
+                        "GROUP BY player " \
+                        "ORDER BY total_plays DESC, total_time DESC" % group_by
                 result = monitor_db.select(query, args=[user_id])
             else:
                 result = []
@@ -630,17 +630,17 @@ class Users(object):
 
         try:
             if str(user_id).isdigit():
-                query = 'SELECT session_history.id, session_history.media_type, guid, ' \
-                        'session_history.rating_key, session_history.parent_rating_key, session_history.grandparent_rating_key, ' \
-                        'title, parent_title, grandparent_title, original_title, ' \
-                        'thumb, parent_thumb, grandparent_thumb, media_index, parent_media_index, ' \
-                        'year, originally_available_at, added_at, live, started, user ' \
-                        'FROM session_history_metadata ' \
-                        'JOIN session_history ON session_history_metadata.id = session_history.id ' \
-                        'WHERE user_id = ? ' \
-                        'GROUP BY (CASE WHEN session_history.media_type = "track" THEN session_history.parent_rating_key ' \
-                        '   ELSE session_history.rating_key END) ' \
-                        'ORDER BY MAX(started) DESC LIMIT ?'
+                query = "SELECT session_history.id, session_history.media_type, guid, " \
+                        "session_history.rating_key, session_history.parent_rating_key, session_history.grandparent_rating_key, " \
+                        "title, parent_title, grandparent_title, original_title, " \
+                        "thumb, parent_thumb, grandparent_thumb, media_index, parent_media_index, " \
+                        "year, originally_available_at, added_at, live, started, user " \
+                        "FROM session_history_metadata " \
+                        "JOIN session_history ON session_history_metadata.id = session_history.id " \
+                        "WHERE user_id = ? " \
+                        "GROUP BY (CASE WHEN session_history.media_type = 'track' THEN session_history.parent_rating_key " \
+                        "   ELSE session_history.rating_key END) " \
+                        "ORDER BY MAX(started) DESC LIMIT ?"
                 result = monitor_db.select(query, args=[user_id, limit])
             else:
                 result = []
@@ -683,11 +683,11 @@ class Users(object):
         monitor_db = database.MonitorDatabase()
 
         try:
-            query = 'SELECT id AS row_id, user_id, username, friendly_name, thumb, custom_avatar_url, email, ' \
-                    'is_active, is_admin, is_home_user, is_allow_sync, is_restricted, ' \
-                    'do_notify, keep_history, allow_guest, shared_libraries, ' \
-                    'filter_all, filter_movies, filter_tv, filter_music, filter_photos ' \
-                    'FROM users WHERE deleted_user = 0'
+            query = "SELECT id AS row_id, user_id, username, friendly_name, thumb, custom_avatar_url, email, " \
+                    "is_active, is_admin, is_home_user, is_allow_sync, is_restricted, " \
+                    "do_notify, keep_history, allow_guest, shared_libraries, " \
+                    "filter_all, filter_movies, filter_tv, filter_music, filter_photos " \
+                    "FROM users WHERE deleted_user = 0"
             result = monitor_db.select(query=query)
         except Exception as e:
             logger.warn("Tautulli Users :: Unable to execute database query for get_users: %s." % e)
@@ -729,8 +729,8 @@ class Users(object):
             row_ids = list(map(helpers.cast_to_int, row_ids.split(',')))
 
             # Get the user_ids corresponding to the row_ids
-            result = monitor_db.select('SELECT user_id FROM users '
-                                       'WHERE id IN ({})'.format(','.join(['?'] * len(row_ids))), row_ids)
+            result = monitor_db.select("SELECT user_id FROM users "
+                                       "WHERE id IN ({})".format(",".join(["?"] * len(row_ids))), row_ids)
 
             success = []
             for user in result:
@@ -747,9 +747,9 @@ class Users(object):
                 logger.info("Tautulli Users :: Deleting user with user_id %s from database."
                             % user_id)
                 try:
-                    monitor_db.action('UPDATE users '
-                                      'SET deleted_user = 1, keep_history = 0, do_notify = 0 '
-                                      'WHERE user_id = ?', [user_id])
+                    monitor_db.action("UPDATE users "
+                                      "SET deleted_user = 1, keep_history = 0, do_notify = 0 "
+                                      "WHERE user_id = ?", [user_id])
                     return delete_success
                 except Exception as e:
                     logger.warn("Tautulli Users :: Unable to execute database query for delete: %s." % e)
@@ -762,25 +762,25 @@ class Users(object):
 
         try:
             if user_id and str(user_id).isdigit():
-                query = 'SELECT * FROM users WHERE user_id = ?'
+                query = "SELECT * FROM users WHERE user_id = ?"
                 result = monitor_db.select(query=query, args=[user_id])
                 if result:
                     logger.info("Tautulli Users :: Re-adding user with id %s to database." % user_id)
-                    monitor_db.action('UPDATE users '
-                                      'SET deleted_user = 0, keep_history = 1, do_notify = 1 '
-                                      'WHERE user_id = ?', [user_id])
+                    monitor_db.action("UPDATE users "
+                                      "SET deleted_user = 0, keep_history = 1, do_notify = 1 "
+                                      "WHERE user_id = ?", [user_id])
                     return True
                 else:
                     return False
 
             elif username:
-                query = 'SELECT * FROM users WHERE username = ?'
+                query = "SELECT * FROM users WHERE username = ?"
                 result = monitor_db.select(query=query, args=[username])
                 if result:
                     logger.info("Tautulli Users :: Re-adding user with username %s to database." % username)
-                    monitor_db.action('UPDATE users '
-                                      'SET deleted_user = 0, keep_history = 1, do_notify = 1 '
-                                      'WHERE username = ?', [username])
+                    monitor_db.action("UPDATE users "
+                                      "SET deleted_user = 0, keep_history = 1, do_notify = 1 "
+                                      "WHERE username = ?", [username])
                     return True
                 else:
                     return False
@@ -793,7 +793,7 @@ class Users(object):
         if user:
             try:
                 monitor_db = database.MonitorDatabase()
-                query = 'SELECT user_id FROM users WHERE username = ?'
+                query = "SELECT user_id FROM users WHERE username = ?"
                 result = monitor_db.select_single(query, args=[user])
                 if result:
                     return result['user_id']
@@ -809,14 +809,14 @@ class Users(object):
 
         user_cond = ''
         if session.get_session_user_id():
-            user_cond = 'AND user_id = %s ' % session.get_session_user_id()
+            user_cond = "AND user_id = %s " % session.get_session_user_id()
 
         try:
-            query = 'SELECT user_id, ' \
-                    '(CASE WHEN users.friendly_name IS NULL OR TRIM(users.friendly_name) = "" \
-                    THEN users.username ELSE users.friendly_name END) AS friendly_name ' \
-                    'FROM users ' \
-                    'WHERE deleted_user = 0 %s' % user_cond
+            query = "SELECT user_id, " \
+                    "(CASE WHEN users.friendly_name IS NULL OR TRIM(users.friendly_name) = '' \
+                    THEN users.username ELSE users.friendly_name END) AS friendly_name " \
+                    "FROM users " \
+                    "WHERE deleted_user = 0 %s" % user_cond
 
             result = monitor_db.select(query)
         except Exception as e:
@@ -835,8 +835,8 @@ class Users(object):
         if user_id:
             try:
                 monitor_db = database.MonitorDatabase()
-                query = 'SELECT allow_guest, user_token, server_token FROM users ' \
-                        'WHERE user_id = ? AND deleted_user = 0'
+                query = "SELECT allow_guest, user_token, server_token FROM users " \
+                        "WHERE user_id = ? AND deleted_user = 0"
                 result = monitor_db.select_single(query, args=[user_id])
                 if result:
                     tokens = {'allow_guest': result['allow_guest'],
@@ -857,8 +857,8 @@ class Users(object):
 
         try:
             monitor_db = database.MonitorDatabase()
-            query = 'SELECT filter_all, filter_movies, filter_tv, filter_music, filter_photos FROM users ' \
-                    'WHERE user_id = ?'
+            query = "SELECT filter_all, filter_movies, filter_tv, filter_music, filter_photos FROM users " \
+                    "WHERE user_id = ?"
             result = monitor_db.select_single(query, args=[user_id])
         except Exception as e:
             logger.warn("Tautulli Users :: Unable to execute database query for get_filters: %s." % e)
@@ -907,8 +907,8 @@ class Users(object):
 
     def get_user_login(self, jwt_token):
         monitor_db = database.MonitorDatabase()
-        result = monitor_db.select_single('SELECT * FROM user_login '
-                                          'WHERE jwt_token = ?',
+        result = monitor_db.select_single("SELECT * FROM user_login "
+                                          "WHERE jwt_token = ?",
                                           [jwt_token])
         return result
 
@@ -918,8 +918,8 @@ class Users(object):
         if jwt_token:
             logger.debug("Tautulli Users :: Clearing user JWT token.")
             try:
-                monitor_db.action('UPDATE user_login SET jwt_token = NULL '
-                                  'WHERE jwt_token = ?',
+                monitor_db.action("UPDATE user_login SET jwt_token = NULL "
+                                  "WHERE jwt_token = ?",
                                   [jwt_token])
             except Exception as e:
                 logger.error("Tautulli Users :: Unable to clear user JWT token: %s.", e)
@@ -929,8 +929,8 @@ class Users(object):
             row_ids = list(map(helpers.cast_to_int, row_ids.split(',')))
             logger.debug("Tautulli Users :: Clearing JWT tokens for row_ids %s.", row_ids)
             try:
-                monitor_db.action('UPDATE user_login SET jwt_token = NULL '
-                                  'WHERE id in ({})'.format(','.join(['?'] * len(row_ids))),
+                monitor_db.action("UPDATE user_login SET jwt_token = NULL "
+                                  "WHERE id in ({})".format(",".join(["?"] * len(row_ids))),
                                   row_ids)
             except Exception as e:
                 logger.error("Tautulli Users :: Unable to clear JWT tokens: %s.", e)
@@ -954,19 +954,19 @@ class Users(object):
         else:
             custom_where = [['user_login.user_id', user_id]] if user_id else []
 
-        columns = ['user_login.id AS row_id',
-                   'user_login.timestamp',
-                   'user_login.user_id',
-                   'user_login.user',
-                   'user_login.user_group',
-                   'user_login.ip_address',
-                   'user_login.host',
-                   'user_login.user_agent',
-                   'user_login.success',
-                   'user_login.expiry',
-                   'user_login.jwt_token',
-                   '(CASE WHEN users.friendly_name IS NULL OR TRIM(users.friendly_name) = "" \
-                    THEN users.username ELSE users.friendly_name END) AS friendly_name'
+        columns = ["user_login.id AS row_id",
+                   "user_login.timestamp",
+                   "user_login.user_id",
+                   "user_login.user",
+                   "user_login.user_group",
+                   "user_login.ip_address",
+                   "user_login.host",
+                   "user_login.user_agent",
+                   "user_login.success",
+                   "user_login.expiry",
+                   "user_login.jwt_token",
+                   "(CASE WHEN users.friendly_name IS NULL OR TRIM(users.friendly_name) = '' \
+                    THEN users.username ELSE users.friendly_name END) AS friendly_name"
                    ]
 
         try:
diff --git a/plexpy/webauth.py b/plexpy/webauth.py
index 50ce2d2c..d105a8c2 100644
--- a/plexpy/webauth.py
+++ b/plexpy/webauth.py
@@ -99,7 +99,7 @@ def plex_user_login(token=None, headers=None):
             try:
                 logger.debug("Tautulli WebAuth :: Registering token for user '%s' in the database."
                              % user_details['username'])
-                result = monitor_db.action('UPDATE users SET server_token = ? WHERE user_id = ?',
+                result = monitor_db.action("UPDATE users SET server_token = ? WHERE user_id = ?",
                                            [server_token, user_details['user_id']])
 
                 if result:
@@ -246,12 +246,12 @@ def all_of(*conditions):
 
 def check_rate_limit(ip_address):
     monitor_db = MonitorDatabase()
-    result = monitor_db.select('SELECT timestamp, success FROM user_login '
-                               'WHERE ip_address = ? '
-                               'AND timestamp >= ( '
-                               'SELECT CASE WHEN MAX(timestamp) IS NULL THEN 0 ELSE MAX(timestamp) END '
-                               'FROM user_login WHERE ip_address = ? AND success = 1) '
-                               'ORDER BY timestamp DESC',
+    result = monitor_db.select("SELECT timestamp, success FROM user_login "
+                               "WHERE ip_address = ? "
+                               "AND timestamp >= ( "
+                               "SELECT CASE WHEN MAX(timestamp) IS NULL THEN 0 ELSE MAX(timestamp) END "
+                               "FROM user_login WHERE ip_address = ? AND success = 1) "
+                               "ORDER BY timestamp DESC",
                                [ip_address, ip_address])
 
     try:

From ea6c6078df410f333a060016dfce18c21ad134c9 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 23 May 2023 10:03:36 -0700
Subject: [PATCH 396/743] v2.12.4

---
 CHANGELOG.md      | 11 +++++++++++
 plexpy/version.py |  2 +-
 2 files changed, 12 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index b3c6c4a1..24baf072 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,16 @@
 # Changelog
 
+## v2.12.4 (2023-05-23)
+
+* History:
+  * Fix: Set view offset equal to duration if a stream is stopped within the last 10 sec.
+* Other:
+  * Fix: Database import may fail for some older databases.
+  * Fix: Double-quoted strings for newer versions of SQLite. (#2015, #2057)
+* API:
+  * Change: Return the ID for async API calls (export_metadata, notify, notify_newsletter).
+
+
 ## v2.12.3 (2023-04-14)
 
 * Activity:
diff --git a/plexpy/version.py b/plexpy/version.py
index 47ba56cb..119e0b07 100644
--- a/plexpy/version.py
+++ b/plexpy/version.py
@@ -18,4 +18,4 @@
 from __future__ import unicode_literals
 
 PLEXPY_BRANCH = "master"
-PLEXPY_RELEASE_VERSION = "v2.12.3"
\ No newline at end of file
+PLEXPY_RELEASE_VERSION = "v2.12.4"
\ No newline at end of file

From 2a48e3375a5ab3d8f9a031ef0949664b4444dc39 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 25 Jun 2023 17:35:16 -0700
Subject: [PATCH 397/743] Add `d3d11va` hardware decoder

---
 plexpy/common.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/plexpy/common.py b/plexpy/common.py
index cf1180dc..889d3f73 100644
--- a/plexpy/common.py
+++ b/plexpy/common.py
@@ -216,6 +216,7 @@ AUDIO_QUALITY_PROFILES = {
 AUDIO_QUALITY_PROFILES = OrderedDict(sorted(list(AUDIO_QUALITY_PROFILES.items()), key=lambda k: k[0], reverse=True))
 
 HW_DECODERS = [
+    'd3d11va',
     'dxva2',
     'videotoolbox',
     'mediacodecndk',

From d9b3b311b947ccf8430fadee3c051a49bda0750c Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 27 Jun 2023 14:23:02 -0700
Subject: [PATCH 398/743] Only initialize mako TemplateLookup once

* Ref: sqlalchemy/mako#378
---
 plexpy/webserve.py | 16 ++++++++++------
 1 file changed, 10 insertions(+), 6 deletions(-)

diff --git a/plexpy/webserve.py b/plexpy/webserve.py
index 88b65174..b893b661 100644
--- a/plexpy/webserve.py
+++ b/plexpy/webserve.py
@@ -119,12 +119,16 @@ else:
         from plexpy import macos
 
 
-def serve_template(templatename, **kwargs):
-    interface_dir = os.path.join(str(plexpy.PROG_DIR), 'data/interfaces/')
-    template_dir = os.path.join(str(interface_dir), plexpy.CONFIG.INTERFACE)
+TEMPLATE_LOOKUP = None
 
-    _hplookup = TemplateLookup(directories=[template_dir], default_filters=['unicode', 'h'],
-                               error_handler=mako_error_handler)
+
+def serve_template(template_name, **kwargs):
+    global TEMPLATE_LOOKUP
+    if TEMPLATE_LOOKUP is None:
+        interface_dir = os.path.join(str(plexpy.PROG_DIR), 'data/interfaces/')
+        template_dir = os.path.join(str(interface_dir), plexpy.CONFIG.INTERFACE)
+        TEMPLATE_LOOKUP = TemplateLookup(directories=[template_dir], default_filters=['unicode', 'h'],
+                            error_handler=mako_error_handler)
 
     http_root = plexpy.HTTP_ROOT
     server_name = helpers.pms_name()
@@ -133,7 +137,7 @@ def serve_template(templatename, **kwargs):
     _session = get_session_info()
 
     try:
-        template = _hplookup.get_template(templatename)
+        template = TEMPLATE_LOOKUP.get_template(template_name)
         return template.render(http_root=http_root, server_name=server_name, cache_param=cache_param,
                                _session=_session, **kwargs)
     except Exception as e:

From 7ff3abe8b73921ce5a5a05fd7a5821b1b6575869 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 27 Jun 2023 17:20:21 -0700
Subject: [PATCH 399/743] Rename template_name argument

---
 plexpy/newsletters.py |   8 +-
 plexpy/webserve.py    | 170 +++++++++++++++++++++---------------------
 2 files changed, 89 insertions(+), 89 deletions(-)

diff --git a/plexpy/newsletters.py b/plexpy/newsletters.py
index 94f73c8f..661a2b42 100644
--- a/plexpy/newsletters.py
+++ b/plexpy/newsletters.py
@@ -318,7 +318,7 @@ def blacklist_logger():
         logger.blacklist_config(email_config)
 
 
-def serve_template(templatename, **kwargs):
+def serve_template(template_name, **kwargs):
     if plexpy.CONFIG.NEWSLETTER_CUSTOM_DIR:
         logger.info("Tautulli Newsletters :: Using custom newsletter template directory.")
         template_dir = plexpy.CONFIG.NEWSLETTER_CUSTOM_DIR
@@ -327,12 +327,12 @@ def serve_template(templatename, **kwargs):
         template_dir = os.path.join(str(interface_dir), plexpy.CONFIG.NEWSLETTER_TEMPLATES)
 
         if not plexpy.CONFIG.NEWSLETTER_INLINE_STYLES:
-            templatename = templatename.replace('.html', '.internal.html')
+            template_name = template_name.replace('.html', '.internal.html')
 
     _hplookup = TemplateLookup(directories=[template_dir], default_filters=['unicode', 'h'])
 
     try:
-        template = _hplookup.get_template(templatename)
+        template = _hplookup.get_template(template_name)
         return template.render(**kwargs), False
     except:
         return exceptions.html_error_template().render(), True
@@ -477,7 +477,7 @@ class Newsletter(object):
         logger.info("Tautulli Newsletters :: Generating newsletter%s." % (' preview' if self.is_preview else ''))
 
         newsletter_rendered, self.template_error = serve_template(
-            templatename=self._TEMPLATE,
+            template_name=self._TEMPLATE,
             uuid=self.uuid,
             subject=self.subject_formatted,
             body=self.body_formatted,
diff --git a/plexpy/webserve.py b/plexpy/webserve.py
index b893b661..72eb9170 100644
--- a/plexpy/webserve.py
+++ b/plexpy/webserve.py
@@ -226,7 +226,7 @@ class WebInterface(object):
             plexpy.initialize_scheduler()
             raise cherrypy.HTTPRedirect(plexpy.HTTP_ROOT + "home")
         else:
-            return serve_template(templatename="welcome.html", title="Welcome", config=config)
+            return serve_template(template_name="welcome.html", title="Welcome", config=config)
 
     @cherrypy.expose
     @cherrypy.tools.json_out()
@@ -291,7 +291,7 @@ class WebInterface(object):
             "update_show_changelog": plexpy.CONFIG.UPDATE_SHOW_CHANGELOG,
             "first_run_complete": plexpy.CONFIG.FIRST_RUN_COMPLETE
         }
-        return serve_template(templatename="index.html", title="Home", config=config)
+        return serve_template(template_name="index.html", title="Home", config=config)
 
     @cherrypy.expose
     @cherrypy.tools.json_out()
@@ -336,10 +336,10 @@ class WebInterface(object):
         result = pms_connect.get_current_activity()
 
         if result:
-            return serve_template(templatename="current_activity.html", data=result)
+            return serve_template(template_name="current_activity.html", data=result)
         else:
             logger.warn("Unable to retrieve data for get_current_activity.")
-            return serve_template(templatename="current_activity.html", data=None)
+            return serve_template(template_name="current_activity.html", data=None)
 
     @cherrypy.expose
     @requireAuth()
@@ -350,9 +350,9 @@ class WebInterface(object):
 
         if result:
             session = next((s for s in result['sessions'] if s['session_key'] == session_key), None)
-            return serve_template(templatename="current_activity_instance.html", session=session)
+            return serve_template(template_name="current_activity_instance.html", session=session)
         else:
-            return serve_template(templatename="current_activity_instance.html", session=None)
+            return serve_template(template_name="current_activity_instance.html", session=None)
 
     @cherrypy.expose
     @cherrypy.tools.json_out()
@@ -395,7 +395,7 @@ class WebInterface(object):
             endpoint = endpoint.format(machine_id=plexpy.CONFIG.PMS_IDENTIFIER)
 
         url = base_url + endpoint + ('?' + urlencode(kwargs) if kwargs else '')
-        return serve_template(templatename="xml_shortcut.html", title="Plex XML", url=url)
+        return serve_template(template_name="xml_shortcut.html", title="Plex XML", url=url)
 
     @cherrypy.expose
     @requireAuth()
@@ -405,7 +405,7 @@ class WebInterface(object):
                                                  stats_type=stats_type,
                                                  stats_count=stats_count)
 
-        return serve_template(templatename="home_stats.html", title="Stats", data=stats_data)
+        return serve_template(template_name="home_stats.html", title="Stats", data=stats_data)
 
     @cherrypy.expose
     @requireAuth()
@@ -416,7 +416,7 @@ class WebInterface(object):
 
         stats_data = data_factory.get_library_stats(library_cards=library_cards)
 
-        return serve_template(templatename="library_stats.html", title="Library Stats", data=stats_data)
+        return serve_template(template_name="library_stats.html", title="Library Stats", data=stats_data)
 
     @cherrypy.expose
     @requireAuth()
@@ -426,13 +426,13 @@ class WebInterface(object):
             pms_connect = pmsconnect.PmsConnect()
             result = pms_connect.get_recently_added_details(count=count, media_type=media_type)
         except IOError as e:
-            return serve_template(templatename="recently_added.html", data=None)
+            return serve_template(template_name="recently_added.html", data=None)
 
         if result and 'recently_added' in result:
-            return serve_template(templatename="recently_added.html", data=result['recently_added'])
+            return serve_template(template_name="recently_added.html", data=result['recently_added'])
         else:
             logger.warn("Unable to retrieve data for get_recently_added.")
-            return serve_template(templatename="recently_added.html", data=None)
+            return serve_template(template_name="recently_added.html", data=None)
 
     @cherrypy.expose
     @cherrypy.tools.json_out()
@@ -467,7 +467,7 @@ class WebInterface(object):
     @cherrypy.expose
     @requireAuth()
     def libraries(self, **kwargs):
-        return serve_template(templatename="libraries.html", title="Libraries")
+        return serve_template(template_name="libraries.html", title="Libraries")
 
     @cherrypy.expose
     @cherrypy.tools.json_out()
@@ -620,12 +620,12 @@ class WebInterface(object):
                 library_details = library_data.get_details(section_id=section_id)
             except:
                 logger.warn("Unable to retrieve library details for section_id %s " % section_id)
-                return serve_template(templatename="library.html", title="Library", data=None, config=config)
+                return serve_template(template_name="library.html", title="Library", data=None, config=config)
         else:
             logger.debug("Library page requested but no section_id received.")
-            return serve_template(templatename="library.html", title="Library", data=None, config=config)
+            return serve_template(template_name="library.html", title="Library", data=None, config=config)
 
-        return serve_template(templatename="library.html", title="Library", data=library_details, config=config)
+        return serve_template(template_name="library.html", title="Library", data=library_details, config=config)
 
     @cherrypy.expose
     @requireAuth(member_of("admin"))
@@ -638,7 +638,7 @@ class WebInterface(object):
             result = None
             status_message = 'An error occured.'
 
-        return serve_template(templatename="edit_library.html", title="Edit Library",
+        return serve_template(template_name="edit_library.html", title="Edit Library",
                               data=result, server_id=plexpy.CONFIG.PMS_IDENTIFIER, status_message=status_message)
 
     @cherrypy.expose
@@ -685,7 +685,7 @@ class WebInterface(object):
     @requireAuth()
     def library_watch_time_stats(self, section_id=None, **kwargs):
         if not allow_session_library(section_id):
-            return serve_template(templatename="user_watch_time_stats.html", data=None, title="Watch Stats")
+            return serve_template(template_name="user_watch_time_stats.html", data=None, title="Watch Stats")
 
         if section_id:
             library_data = libraries.Libraries()
@@ -694,16 +694,16 @@ class WebInterface(object):
             result = None
 
         if result:
-            return serve_template(templatename="user_watch_time_stats.html", data=result, title="Watch Stats")
+            return serve_template(template_name="user_watch_time_stats.html", data=result, title="Watch Stats")
         else:
             logger.warn("Unable to retrieve data for library_watch_time_stats.")
-            return serve_template(templatename="user_watch_time_stats.html", data=None, title="Watch Stats")
+            return serve_template(template_name="user_watch_time_stats.html", data=None, title="Watch Stats")
 
     @cherrypy.expose
     @requireAuth()
     def library_user_stats(self, section_id=None, **kwargs):
         if not allow_session_library(section_id):
-            return serve_template(templatename="library_user_stats.html", data=None, title="Player Stats")
+            return serve_template(template_name="library_user_stats.html", data=None, title="Player Stats")
 
         if section_id:
             library_data = libraries.Libraries()
@@ -712,16 +712,16 @@ class WebInterface(object):
             result = None
 
         if result:
-            return serve_template(templatename="library_user_stats.html", data=result, title="Player Stats")
+            return serve_template(template_name="library_user_stats.html", data=result, title="Player Stats")
         else:
             logger.warn("Unable to retrieve data for library_user_stats.")
-            return serve_template(templatename="library_user_stats.html", data=None, title="Player Stats")
+            return serve_template(template_name="library_user_stats.html", data=None, title="Player Stats")
 
     @cherrypy.expose
     @requireAuth()
     def library_recently_watched(self, section_id=None, limit='10', **kwargs):
         if not allow_session_library(section_id):
-            return serve_template(templatename="user_recently_watched.html", data=None, title="Recently Watched")
+            return serve_template(template_name="user_recently_watched.html", data=None, title="Recently Watched")
 
         if section_id:
             library_data = libraries.Libraries()
@@ -730,16 +730,16 @@ class WebInterface(object):
             result = None
 
         if result:
-            return serve_template(templatename="user_recently_watched.html", data=result, title="Recently Watched")
+            return serve_template(template_name="user_recently_watched.html", data=result, title="Recently Watched")
         else:
             logger.warn("Unable to retrieve data for library_recently_watched.")
-            return serve_template(templatename="user_recently_watched.html", data=None, title="Recently Watched")
+            return serve_template(template_name="user_recently_watched.html", data=None, title="Recently Watched")
 
     @cherrypy.expose
     @requireAuth()
     def library_recently_added(self, section_id=None, limit='10', **kwargs):
         if not allow_session_library(section_id):
-            return serve_template(templatename="library_recently_added.html", data=None, title="Recently Added")
+            return serve_template(template_name="library_recently_added.html", data=None, title="Recently Added")
 
         if section_id:
             pms_connect = pmsconnect.PmsConnect()
@@ -748,10 +748,10 @@ class WebInterface(object):
             result = None
 
         if result and result['recently_added']:
-            return serve_template(templatename="library_recently_added.html", data=result['recently_added'], title="Recently Added")
+            return serve_template(template_name="library_recently_added.html", data=result['recently_added'], title="Recently Added")
         else:
             logger.warn("Unable to retrieve data for library_recently_added.")
-            return serve_template(templatename="library_recently_added.html", data=None, title="Recently Added")
+            return serve_template(template_name="library_recently_added.html", data=None, title="Recently Added")
 
     @cherrypy.expose
     @cherrypy.tools.json_out()
@@ -1243,7 +1243,7 @@ class WebInterface(object):
     @cherrypy.expose
     @requireAuth()
     def users(self, **kwargs):
-        return serve_template(templatename="users.html", title="Users")
+        return serve_template(template_name="users.html", title="Users")
 
     @cherrypy.expose
     @cherrypy.tools.json_out()
@@ -1359,12 +1359,12 @@ class WebInterface(object):
                 user_details = user_data.get_details(user_id=user_id)
             except:
                 logger.warn("Unable to retrieve user details for user_id %s " % user_id)
-                return serve_template(templatename="user.html", title="User", data=None)
+                return serve_template(template_name="user.html", title="User", data=None)
         else:
             logger.debug("User page requested but no user_id received.")
-            return serve_template(templatename="user.html", title="User", data=None)
+            return serve_template(template_name="user.html", title="User", data=None)
 
-        return serve_template(templatename="user.html", title="User", data=user_details)
+        return serve_template(template_name="user.html", title="User", data=user_details)
 
     @cherrypy.expose
     @requireAuth(member_of("admin"))
@@ -1377,7 +1377,7 @@ class WebInterface(object):
             result = None
             status_message = 'An error occured.'
 
-        return serve_template(templatename="edit_user.html", title="Edit User", data=result, status_message=status_message)
+        return serve_template(template_name="edit_user.html", title="Edit User", data=result, status_message=status_message)
 
     @cherrypy.expose
     @requireAuth(member_of("admin"))
@@ -1425,7 +1425,7 @@ class WebInterface(object):
     @requireAuth()
     def user_watch_time_stats(self, user=None, user_id=None, **kwargs):
         if not allow_session_user(user_id):
-            return serve_template(templatename="user_watch_time_stats.html", data=None, title="Watch Stats")
+            return serve_template(template_name="user_watch_time_stats.html", data=None, title="Watch Stats")
 
         if user_id or user:
             user_data = users.Users()
@@ -1434,16 +1434,16 @@ class WebInterface(object):
             result = None
 
         if result:
-            return serve_template(templatename="user_watch_time_stats.html", data=result, title="Watch Stats")
+            return serve_template(template_name="user_watch_time_stats.html", data=result, title="Watch Stats")
         else:
             logger.warn("Unable to retrieve data for user_watch_time_stats.")
-            return serve_template(templatename="user_watch_time_stats.html", data=None, title="Watch Stats")
+            return serve_template(template_name="user_watch_time_stats.html", data=None, title="Watch Stats")
 
     @cherrypy.expose
     @requireAuth()
     def user_player_stats(self, user=None, user_id=None, **kwargs):
         if not allow_session_user(user_id):
-            return serve_template(templatename="user_player_stats.html", data=None, title="Player Stats")
+            return serve_template(template_name="user_player_stats.html", data=None, title="Player Stats")
 
         if user_id or user:
             user_data = users.Users()
@@ -1452,16 +1452,16 @@ class WebInterface(object):
             result = None
 
         if result:
-            return serve_template(templatename="user_player_stats.html", data=result, title="Player Stats")
+            return serve_template(template_name="user_player_stats.html", data=result, title="Player Stats")
         else:
             logger.warn("Unable to retrieve data for user_player_stats.")
-            return serve_template(templatename="user_player_stats.html", data=None, title="Player Stats")
+            return serve_template(template_name="user_player_stats.html", data=None, title="Player Stats")
 
     @cherrypy.expose
     @requireAuth()
     def get_user_recently_watched(self, user=None, user_id=None, limit='10', **kwargs):
         if not allow_session_user(user_id):
-            return serve_template(templatename="user_recently_watched.html", data=None, title="Recently Watched")
+            return serve_template(template_name="user_recently_watched.html", data=None, title="Recently Watched")
 
         if user_id or user:
             user_data = users.Users()
@@ -1470,10 +1470,10 @@ class WebInterface(object):
             result = None
 
         if result:
-            return serve_template(templatename="user_recently_watched.html", data=result, title="Recently Watched")
+            return serve_template(template_name="user_recently_watched.html", data=result, title="Recently Watched")
         else:
             logger.warn("Unable to retrieve data for get_user_recently_watched.")
-            return serve_template(templatename="user_recently_watched.html", data=None, title="Recently Watched")
+            return serve_template(template_name="user_recently_watched.html", data=None, title="Recently Watched")
 
     @cherrypy.expose
     @cherrypy.tools.json_out()
@@ -1879,7 +1879,7 @@ class WebInterface(object):
             "database_is_importing": database.IS_IMPORTING,
         }
 
-        return serve_template(templatename="history.html", title="History", config=config)
+        return serve_template(template_name="history.html", title="History", config=config)
 
     @cherrypy.expose
     @cherrypy.tools.json_out()
@@ -2067,7 +2067,7 @@ class WebInterface(object):
         data_factory = datafactory.DataFactory()
         stream_data = data_factory.get_stream_details(row_id, session_key)
 
-        return serve_template(templatename="stream_data.html", title="Stream Data", data=stream_data, user=user)
+        return serve_template(template_name="stream_data.html", title="Stream Data", data=stream_data, user=user)
 
     @cherrypy.expose
     @cherrypy.tools.json_out()
@@ -2158,7 +2158,7 @@ class WebInterface(object):
 
         public = helpers.is_public_ip(ip_address)
 
-        return serve_template(templatename="ip_address_modal.html", title="IP Address Details",
+        return serve_template(template_name="ip_address_modal.html", title="IP Address Details",
                               data=ip_address, public=public, kwargs=kwargs)
 
     @cherrypy.expose
@@ -2197,7 +2197,7 @@ class WebInterface(object):
     @cherrypy.expose
     @requireAuth()
     def graphs(self, **kwargs):
-        return serve_template(templatename="graphs.html", title="Graphs")
+        return serve_template(template_name="graphs.html", title="Graphs")
 
     @cherrypy.expose
     @cherrypy.tools.json_out()
@@ -2711,9 +2711,9 @@ class WebInterface(object):
     @requireAuth()
     def history_table_modal(self, **kwargs):
         if kwargs.get('user_id') and not allow_session_user(kwargs['user_id']):
-            return serve_template(templatename="history_table_modal.html", title="History Data", data=None)
+            return serve_template(template_name="history_table_modal.html", title="History Data", data=None)
 
-        return serve_template(templatename="history_table_modal.html", title="History Data", data=kwargs)
+        return serve_template(template_name="history_table_modal.html", title="History Data", data=kwargs)
 
 
     ##### Sync #####
@@ -2721,7 +2721,7 @@ class WebInterface(object):
     @cherrypy.expose
     @requireAuth()
     def sync(self, **kwargs):
-        return serve_template(templatename="sync.html", title="Synced Items")
+        return serve_template(template_name="sync.html", title="Synced Items")
 
     @cherrypy.expose
     @cherrypy.tools.json_out()
@@ -2780,7 +2780,7 @@ class WebInterface(object):
     @requireAuth(member_of("admin"))
     def logs(self, **kwargs):
         plex_log_files = log_reader.list_plex_logs()
-        return serve_template(templatename="logs.html", title="Log", plex_log_files=plex_log_files)
+        return serve_template(template_name="logs.html", title="Log", plex_log_files=plex_log_files)
 
     @cherrypy.expose
     @requireAuth(member_of("admin"))
@@ -3174,7 +3174,7 @@ class WebInterface(object):
         for key in ('home_sections', 'home_stats_cards', 'home_library_cards'):
             settings_dict[key] = json.dumps(settings_dict[key])
 
-        return serve_template(templatename="settings.html", title="Settings", config=settings_dict)
+        return serve_template(template_name="settings.html", title="Settings", config=settings_dict)
 
     @cherrypy.expose
     @cherrypy.tools.json_out()
@@ -3365,17 +3365,17 @@ class WebInterface(object):
     @cherrypy.expose
     @requireAuth(member_of("admin"))
     def get_configuration_table(self, **kwargs):
-        return serve_template(templatename="configuration_table.html")
+        return serve_template(template_name="configuration_table.html")
 
     @cherrypy.expose
     @requireAuth(member_of("admin"))
     def get_scheduler_table(self, **kwargs):
-        return serve_template(templatename="scheduler_table.html")
+        return serve_template(template_name="scheduler_table.html")
 
     @cherrypy.expose
     @requireAuth(member_of("admin"))
     def get_queue_modal(self, queue=None, **kwargs):
-        return serve_template(templatename="queue_modal.html", queue=queue)
+        return serve_template(template_name="queue_modal.html", queue=queue)
 
     @cherrypy.expose
     @cherrypy.tools.json_out()
@@ -3439,7 +3439,7 @@ class WebInterface(object):
     @requireAuth(member_of("admin"))
     def get_notifiers_table(self, **kwargs):
         result = notifiers.get_notifiers()
-        return serve_template(templatename="notifiers_table.html", notifiers_list=result)
+        return serve_template(template_name="notifiers_table.html", notifiers_list=result)
 
     @cherrypy.expose
     @cherrypy.tools.json_out()
@@ -3522,7 +3522,7 @@ class WebInterface(object):
                 for category in common.NOTIFICATION_PARAMETERS for param in category['parameters']
             ]
 
-        return serve_template(templatename="notifier_config.html", notifier=result, parameters=parameters)
+        return serve_template(template_name="notifier_config.html", notifier=result, parameters=parameters)
 
     @cherrypy.expose
     @cherrypy.tools.json_out()
@@ -3605,7 +3605,7 @@ class WebInterface(object):
 
             text.append({'media_type': media_type, 'subject': test_subject, 'body': test_body})
 
-        return serve_template(templatename="notifier_text_preview.html", text=text, agent=agent_name)
+        return serve_template(template_name="notifier_text_preview.html", text=text, agent=agent_name)
 
     @cherrypy.expose
     @cherrypy.tools.json_out()
@@ -3783,7 +3783,7 @@ class WebInterface(object):
     @requireAuth(member_of("admin"))
     def get_mobile_devices_table(self, **kwargs):
         result = mobile_app.get_mobile_devices()
-        return serve_template(templatename="mobile_devices_table.html", devices_list=result)
+        return serve_template(template_name="mobile_devices_table.html", devices_list=result)
 
     @cherrypy.expose
     @cherrypy.tools.json_out()
@@ -3806,7 +3806,7 @@ class WebInterface(object):
     def get_mobile_device_config_modal(self, mobile_device_id=None, **kwargs):
         result = mobile_app.get_mobile_device_config(mobile_device_id=mobile_device_id)
 
-        return serve_template(templatename="mobile_device_config.html", device=result)
+        return serve_template(template_name="mobile_device_config.html", device=result)
 
     @cherrypy.expose
     @cherrypy.tools.json_out()
@@ -4016,11 +4016,11 @@ class WebInterface(object):
     @requireAuth(member_of("admin"))
     def import_database_tool(self, app=None, **kwargs):
         if app == 'tautulli':
-            return serve_template(templatename="app_import.html", title="Import Tautulli Database", app="Tautulli")
+            return serve_template(template_name="app_import.html", title="Import Tautulli Database", app="Tautulli")
         elif app == 'plexwatch':
-            return serve_template(templatename="app_import.html", title="Import PlexWatch Database", app="PlexWatch")
+            return serve_template(template_name="app_import.html", title="Import PlexWatch Database", app="PlexWatch")
         elif app == 'plexivity':
-            return serve_template(templatename="app_import.html", title="Import Plexivity Database", app="Plexivity")
+            return serve_template(template_name="app_import.html", title="Import Plexivity Database", app="Plexivity")
 
         logger.warn("No app specified for import.")
         return
@@ -4028,7 +4028,7 @@ class WebInterface(object):
     @cherrypy.expose
     @requireAuth(member_of("admin"))
     def import_config_tool(self, **kwargs):
-        return serve_template(templatename="config_import.html", title="Import Tautulli Configuration")
+        return serve_template(template_name="config_import.html", title="Import Tautulli Configuration")
 
     @cherrypy.expose
     @cherrypy.tools.json_out()
@@ -4301,7 +4301,7 @@ class WebInterface(object):
         else:
             new_http_root = '/'
 
-        return serve_template(templatename="shutdown.html", signal=signal, title=title,
+        return serve_template(template_name="shutdown.html", signal=signal, title=title,
                               new_http_root=new_http_root, message=message, timer=timer, quote=quote)
 
     @cherrypy.expose
@@ -4411,7 +4411,7 @@ class WebInterface(object):
             if metadata['section_id'] and not allow_session_library(metadata['section_id']):
                 raise cherrypy.HTTPRedirect(plexpy.HTTP_ROOT)
 
-            return serve_template(templatename="info.html", metadata=metadata, title="Info",
+            return serve_template(template_name="info.html", metadata=metadata, title="Info",
                                   config=config, source=source, user_info=user_info)
         else:
             if get_session_user_id():
@@ -4427,11 +4427,11 @@ class WebInterface(object):
         result = pms_connect.get_item_children(rating_key=rating_key, media_type=media_type)
 
         if result:
-            return serve_template(templatename="info_children_list.html", data=result,
+            return serve_template(template_name="info_children_list.html", data=result,
                                   media_type=media_type, title="Children List")
         else:
             logger.warn("Unable to retrieve data for get_item_children.")
-            return serve_template(templatename="info_children_list.html", data=None, title="Children List")
+            return serve_template(template_name="info_children_list.html", data=None, title="Children List")
 
     @cherrypy.expose
     @requireAuth()
@@ -4441,9 +4441,9 @@ class WebInterface(object):
         result = pms_connect.get_item_children_related(rating_key=rating_key)
 
         if result:
-            return serve_template(templatename="info_collection_list.html", data=result, title=title)
+            return serve_template(template_name="info_collection_list.html", data=result, title=title)
         else:
-            return serve_template(templatename="info_collection_list.html", data=None, title=title)
+            return serve_template(template_name="info_collection_list.html", data=None, title=title)
 
     @cherrypy.expose
     @requireAuth()
@@ -4455,10 +4455,10 @@ class WebInterface(object):
             result = None
 
         if result:
-            return serve_template(templatename="user_watch_time_stats.html", data=result, title="Watch Stats")
+            return serve_template(template_name="user_watch_time_stats.html", data=result, title="Watch Stats")
         else:
             logger.warn("Unable to retrieve data for item_watch_time_stats.")
-            return serve_template(templatename="user_watch_time_stats.html", data=None, title="Watch Stats")
+            return serve_template(template_name="user_watch_time_stats.html", data=None, title="Watch Stats")
 
     @cherrypy.expose
     @requireAuth()
@@ -4470,10 +4470,10 @@ class WebInterface(object):
             result = None
 
         if result:
-            return serve_template(templatename="library_user_stats.html", data=result, title="Player Stats")
+            return serve_template(template_name="library_user_stats.html", data=result, title="Player Stats")
         else:
             logger.warn("Unable to retrieve data for item_user_stats.")
-            return serve_template(templatename="library_user_stats.html", data=None, title="Player Stats")
+            return serve_template(template_name="library_user_stats.html", data=None, title="Player Stats")
 
     @cherrypy.expose
     @cherrypy.tools.json_out()
@@ -5095,7 +5095,7 @@ class WebInterface(object):
     @cherrypy.expose
     @requireAuth()
     def search(self, query='', **kwargs):
-        return serve_template(templatename="search.html", title="Search", query=query)
+        return serve_template(template_name="search.html", title="Search", query=query)
 
     @cherrypy.expose
     @cherrypy.tools.json_out()
@@ -5152,10 +5152,10 @@ class WebInterface(object):
                                                 if season['media_index'] == season_index]
 
         if result:
-            return serve_template(templatename="info_search_results_list.html", data=result, title="Search Result List")
+            return serve_template(template_name="info_search_results_list.html", data=result, title="Search Result List")
         else:
             logger.warn("Unable to retrieve data for get_search_results_children.")
-            return serve_template(templatename="info_search_results_list.html", data=None, title="Search Result List")
+            return serve_template(template_name="info_search_results_list.html", data=None, title="Search Result List")
 
 
     ##### Update Metadata #####
@@ -5172,10 +5172,10 @@ class WebInterface(object):
             query['query_string'] = query_string
 
         if query:
-            return serve_template(templatename="update_metadata.html", query=query, update=update, title="Info")
+            return serve_template(template_name="update_metadata.html", query=query, update=update, title="Info")
         else:
             logger.warn("Unable to retrieve data for update_metadata.")
-            return serve_template(templatename="update_metadata.html", query=query, update=update, title="Info")
+            return serve_template(template_name="update_metadata.html", query=query, update=update, title="Info")
 
     @cherrypy.expose
     @cherrypy.tools.json_out()
@@ -6578,7 +6578,7 @@ class WebInterface(object):
     @requireAuth(member_of("admin"))
     def get_newsletters_table(self, **kwargs):
         result = newsletters.get_newsletters()
-        return serve_template(templatename="newsletters_table.html", newsletters_list=result)
+        return serve_template(template_name="newsletters_table.html", newsletters_list=result)
 
     @cherrypy.expose
     @cherrypy.tools.json_out()
@@ -6653,7 +6653,7 @@ class WebInterface(object):
     @requireAuth(member_of("admin"))
     def get_newsletter_config_modal(self, newsletter_id=None, **kwargs):
         result = newsletters.get_newsletter_config(newsletter_id=newsletter_id, mask_passwords=True)
-        return serve_template(templatename="newsletter_config.html", newsletter=result)
+        return serve_template(template_name="newsletter_config.html", newsletter=result)
 
     @cherrypy.expose
     @cherrypy.tools.json_out()
@@ -6761,7 +6761,7 @@ class WebInterface(object):
             elif kwargs.pop('key', None) == plexpy.CONFIG.NEWSLETTER_PASSWORD:
                 return self.newsletter_auth(*args, **kwargs)
             else:
-                return serve_template(templatename="newsletter_auth.html",
+                return serve_template(template_name="newsletter_auth.html",
                                       title="Newsletter Login",
                                       uri=request_uri)
 
@@ -6798,7 +6798,7 @@ class WebInterface(object):
     @requireAuth(member_of("admin"))
     def newsletter_preview(self, **kwargs):
         kwargs['preview'] = 'true'
-        return serve_template(templatename="newsletter_preview.html",
+        return serve_template(template_name="newsletter_preview.html",
                               title="Newsletter",
                               kwargs=kwargs)
 
@@ -6837,7 +6837,7 @@ class WebInterface(object):
     @cherrypy.expose
     @requireAuth(member_of("admin"))
     def support(self, **kwargs):
-        return serve_template(templatename="support.html", title="Support")
+        return serve_template(template_name="support.html", title="Support")
 
     @cherrypy.expose
     @cherrypy.tools.json_out()
@@ -6992,7 +6992,7 @@ class WebInterface(object):
         if media_type == 'photo_album':
             media_type = 'photoalbum'
 
-        return serve_template(templatename="export_modal.html", title="Export Metadata",
+        return serve_template(template_name="export_modal.html", title="Export Metadata",
                               section_id=section_id, user_id=user_id, rating_key=rating_key,
                               media_type=media_type, sub_media_type=sub_media_type,
                               export_type=export_type, file_formats=file_formats)

From c761e6e8d09491886bcfc8b056da0abcb70b401d Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 29 Jun 2023 00:07:43 -0700
Subject: [PATCH 400/743] Fix `template_name` argument for login page

---
 plexpy/webauth.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/plexpy/webauth.py b/plexpy/webauth.py
index d105a8c2..5487f2ea 100644
--- a/plexpy/webauth.py
+++ b/plexpy/webauth.py
@@ -314,7 +314,7 @@ class AuthController(object):
 
     def get_loginform(self, redirect_uri=''):
         from plexpy.webserve import serve_template
-        return serve_template(templatename="login.html", title="Login", redirect_uri=unquote(redirect_uri))
+        return serve_template(template_name="login.html", title="Login", redirect_uri=unquote(redirect_uri))
 
     @cherrypy.expose
     def index(self, *args, **kwargs):

From 085cfa4bef90e7c3847a51789f2c18ed174c5bee Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 7 Jul 2023 11:51:54 -0700
Subject: [PATCH 401/743] Fix history grouping incorrect for watched content

---
 plexpy/activity_processor.py | 21 +++++++++++----------
 1 file changed, 11 insertions(+), 10 deletions(-)

diff --git a/plexpy/activity_processor.py b/plexpy/activity_processor.py
index 588e91ce..2d752104 100644
--- a/plexpy/activity_processor.py
+++ b/plexpy/activity_processor.py
@@ -1,4 +1,4 @@
-# This file is part of Tautulli.
+# This file is part of Tautulli.
 #
 #  Tautulli is free software: you can redistribute it and/or modify
 #  it under the terms of the GNU General Public License as published by
@@ -327,7 +327,7 @@ class ActivityProcessor(object):
                 # Get the last insert row id
                 last_id = self.db.last_insert_id()
                 new_session = prev_session = None
-                watched = False
+                prev_watched = None
 
                 if session['live']:
                     # Check if we should group the session, select the last guid from the user
@@ -370,24 +370,25 @@ class ActivityProcessor(object):
                                         'reference_id': result[1]['reference_id']}
 
                         marker_first, marker_final = helpers.get_first_final_marker(metadata['markers'])
-                        watched = helpers.check_watched(
-                            session['media_type'], session['view_offset'], session['duration'],
+                        prev_watched = helpers.check_watched(
+                            session['media_type'], prev_session['view_offset'], session['duration'],
                             marker_first, marker_final
                         )
 
                 query = "UPDATE session_history SET reference_id = ? WHERE id = ? "
 
-                # If previous session view offset less than watched percent,
+                # If previous session view offset less than watched threshold,
                 # and new session view offset is greater,
                 # then set the reference_id to the previous row,
                 # else set the reference_id to the new id
-                if prev_session is None and new_session is None:
-                    args = [last_id, last_id]
-                elif watched and prev_session['view_offset'] <= new_session['view_offset'] or \
-                        session['live'] and prev_session['guid'] == new_session['guid']:
+                if (prev_watched is False and prev_session['view_offset'] <= new_session['view_offset'] or 
+                        session['live'] and prev_session['guid'] == new_session['guid']):
+                    logger.debug("Tautulli ActivityProcessor :: Grouping history for sessionKey %s", session['session_key'])
                     args = [prev_session['reference_id'], new_session['id']]
+
                 else:
-                    args = [new_session['id'], new_session['id']]
+                    logger.debug("Tautulli ActivityProcessor :: Not grouping history for sessionKey %s", session['session_key'])
+                    args = [last_id, last_id]
 
                 self.db.action(query=query, args=args)
                 

From 1fe6d1505f5524c2706934093b77034b00c94374 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 7 Jul 2023 13:02:45 -0700
Subject: [PATCH 402/743] Add method to regroup history

---
 plexpy/activity_processor.py | 159 ++++++++++++++++++++---------------
 1 file changed, 93 insertions(+), 66 deletions(-)

diff --git a/plexpy/activity_processor.py b/plexpy/activity_processor.py
index 2d752104..6851263b 100644
--- a/plexpy/activity_processor.py
+++ b/plexpy/activity_processor.py
@@ -1,4 +1,4 @@
-# This file is part of Tautulli.
+# This file is part of Tautulli.
 #
 #  Tautulli is free software: you can redistribute it and/or modify
 #  it under the terms of the GNU General Public License as published by
@@ -326,71 +326,7 @@ class ActivityProcessor(object):
 
                 # Get the last insert row id
                 last_id = self.db.last_insert_id()
-                new_session = prev_session = None
-                prev_watched = None
-
-                if session['live']:
-                    # Check if we should group the session, select the last guid from the user
-                    query = "SELECT session_history.id, session_history_metadata.guid, session_history.reference_id " \
-                            "FROM session_history " \
-                            "JOIN session_history_metadata ON session_history.id == session_history_metadata.id " \
-                            "WHERE session_history.user_id = ? ORDER BY session_history.id DESC LIMIT 1 "
-
-                    args = [session['user_id']]
-
-                    result = self.db.select(query=query, args=args)
-
-                    if len(result) > 0:
-                        new_session = {'id': last_id,
-                                       'guid': metadata['guid'],
-                                       'reference_id': last_id}
-
-                        prev_session = {'id': result[0]['id'],
-                                        'guid': result[0]['guid'],
-                                        'reference_id': result[0]['reference_id']}
-
-                else:
-                    # Check if we should group the session, select the last two rows from the user
-                    query = "SELECT id, rating_key, view_offset, reference_id FROM session_history " \
-                            "WHERE user_id = ? AND rating_key = ? ORDER BY id DESC LIMIT 2 "
-
-                    args = [session['user_id'], session['rating_key']]
-
-                    result = self.db.select(query=query, args=args)
-
-                    if len(result) > 1:
-                        new_session = {'id': result[0]['id'],
-                                       'rating_key': result[0]['rating_key'],
-                                       'view_offset': result[0]['view_offset'],
-                                       'reference_id': result[0]['reference_id']}
-
-                        prev_session = {'id': result[1]['id'],
-                                        'rating_key': result[1]['rating_key'],
-                                        'view_offset': result[1]['view_offset'],
-                                        'reference_id': result[1]['reference_id']}
-
-                        marker_first, marker_final = helpers.get_first_final_marker(metadata['markers'])
-                        prev_watched = helpers.check_watched(
-                            session['media_type'], prev_session['view_offset'], session['duration'],
-                            marker_first, marker_final
-                        )
-
-                query = "UPDATE session_history SET reference_id = ? WHERE id = ? "
-
-                # If previous session view offset less than watched threshold,
-                # and new session view offset is greater,
-                # then set the reference_id to the previous row,
-                # else set the reference_id to the new id
-                if (prev_watched is False and prev_session['view_offset'] <= new_session['view_offset'] or 
-                        session['live'] and prev_session['guid'] == new_session['guid']):
-                    logger.debug("Tautulli ActivityProcessor :: Grouping history for sessionKey %s", session['session_key'])
-                    args = [prev_session['reference_id'], new_session['id']]
-
-                else:
-                    logger.debug("Tautulli ActivityProcessor :: Not grouping history for sessionKey %s", session['session_key'])
-                    args = [last_id, last_id]
-
-                self.db.action(query=query, args=args)
+                self.group_history(last_id, session, metadata)
                 
                 # logger.debug("Tautulli ActivityProcessor :: Successfully written history item, last id for session_history is %s"
                 #              % last_id)
@@ -547,6 +483,80 @@ class ActivityProcessor(object):
             # Return the session row id when the session is successfully written to the database
             return session['id']
 
+    def group_history(self, last_id, session, metadata=None):
+        new_session = prev_session = None
+        prev_watched = None
+
+        if session['live']:
+            # Check if we should group the session, select the last guid from the user
+            query = "SELECT session_history.id, session_history_metadata.guid, session_history.reference_id " \
+                    "FROM session_history " \
+                    "JOIN session_history_metadata ON session_history.id == session_history_metadata.id " \
+                    "WHERE session_history.id <= ? AND session_history.user_id = ? ORDER BY session_history.id DESC LIMIT 1 "
+
+            args = [last_id, session['user_id']]
+
+            result = self.db.select(query=query, args=args)
+
+            if len(result) > 0:
+                new_session = {'id': last_id,
+                                'guid': metadata['guid'] if metadata else session['guid'],
+                                'reference_id': last_id}
+
+                prev_session = {'id': result[0]['id'],
+                                'guid': result[0]['guid'],
+                                'reference_id': result[0]['reference_id']}
+
+        else:
+            # Check if we should group the session, select the last two rows from the user
+            query = "SELECT id, rating_key, view_offset, reference_id FROM session_history " \
+                    "WHERE id <= ? AND user_id = ? AND rating_key = ? ORDER BY id DESC LIMIT 2 "
+
+            args = [last_id, session['user_id'], session['rating_key']]
+
+            result = self.db.select(query=query, args=args)
+
+            if len(result) > 1:
+                new_session = {'id': result[0]['id'],
+                                'rating_key': result[0]['rating_key'],
+                                'view_offset': result[0]['view_offset'],
+                                'reference_id': result[0]['reference_id']}
+
+                prev_session = {'id': result[1]['id'],
+                                'rating_key': result[1]['rating_key'],
+                                'view_offset': result[1]['view_offset'],
+                                'reference_id': result[1]['reference_id']}
+
+                if metadata:
+                    marker_first, marker_final = helpers.get_first_final_marker(metadata['markers'])
+                else:
+                    marker_first = session['marker_credits_first']
+                    marker_final = session['marker_credits_final']
+
+                prev_watched = helpers.check_watched(
+                    session['media_type'], prev_session['view_offset'], session['duration'],
+                    marker_first, marker_final
+                )
+
+        query = "UPDATE session_history SET reference_id = ? WHERE id = ? "
+
+        # If previous session view offset less than watched threshold,
+        # and new session view offset is greater,
+        # then set the reference_id to the previous row,
+        # else set the reference_id to the new id
+        if (prev_watched is False and prev_session['view_offset'] <= new_session['view_offset'] or 
+                session['live'] and prev_session['guid'] == new_session['guid']):
+            if metadata:
+                logger.debug("Tautulli ActivityProcessor :: Grouping history for sessionKey %s", session['session_key'])
+            args = [prev_session['reference_id'], new_session['id']]
+
+        else:
+            if metadata:
+                logger.debug("Tautulli ActivityProcessor :: Not grouping history for sessionKey %s", session['session_key'])
+            args = [last_id, last_id]
+
+        self.db.action(query=query, args=args)
+
     def get_sessions(self, user_id=None, ip_address=None):
         query = "SELECT * FROM sessions"
         args = []
@@ -696,3 +706,20 @@ class ActivityProcessor(object):
                                              "ORDER BY stopped DESC",
                                              [user_id, machine_id, media_type])
         return int(started - last_session.get('stopped', 0) >= plexpy.CONFIG.NOTIFY_CONTINUED_SESSION_THRESHOLD)
+
+    def regroup_history(self):
+        logger.info("Tautulli ActivityProcessor :: Creating database backup...")
+        database.make_backup()
+
+        logger.info("Tautulli ActivityProcessor :: Regrouping session history...")
+
+        query = (
+            "SELECT * FROM session_history "
+            "JOIN session_history_metadata ON session_history.id = session_history_metadata.id"
+        )
+        results = self.db.select(query)
+
+        for session in results:
+            self.group_history(session['id'], session)
+
+        logger.info("Tautulli ActivityProcessor :: Regrouping session history complete.")

From b144e6527fabb13cad9eb90bac49985f8dc89ac8 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 7 Jul 2023 13:26:11 -0700
Subject: [PATCH 403/743] Add button to regroup play history

---
 data/interfaces/default/settings.html | 31 +++++++++++++++++++++------
 plexpy/activity_processor.py          | 10 +++++++--
 plexpy/webserve.py                    | 16 ++++++++++++++
 3 files changed, 49 insertions(+), 8 deletions(-)

diff --git a/data/interfaces/default/settings.html b/data/interfaces/default/settings.html
index fd234da2..7cd614e0 100644
--- a/data/interfaces/default/settings.html
+++ b/data/interfaces/default/settings.html
@@ -132,12 +132,6 @@
                             </label>
                             <p class="help-block">Change the "<em>Play by day of week</em>" graph to start on Monday. Default is start on Sunday.</p>
                         </div>
-                        <div class="checkbox advanced-setting">
-                            <label>
-                                <input type="checkbox" id="group_history_tables" name="group_history_tables" value="1" ${config['group_history_tables']}> Group Play History
-                            </label>
-                            <p class="help-block">Group play history for the same item and user as a single entry when progress is less than the watched percent.</p>
-                        </div>
                         <div class="checkbox advanced-setting">
                             <label>
                                 <input type="checkbox" id="history_table_activity" name="history_table_activity" value="1" ${config['history_table_activity']}> Current Activity in History Tables
@@ -227,6 +221,25 @@
                             </div>
                             <p class="help-block">Decide whether to use end credits markers to determine the 'watched' state of video items. When markers are not available the selected threshold percentage will be used.</p>
                         </div>
+                        <div class="checkbox advanced-setting">
+                            <label>
+                                <input type="checkbox" id="group_history_tables" name="group_history_tables" value="1" ${config['group_history_tables']}> Group Play History
+                            </label>
+                            <p class="help-block">Group play history for the same item and user as a single entry when progress is less than the watched percent.</p>
+                        </div>
+                        <div class="form-group advanced-setting">
+                            <label>Regroup Play History</label>
+                            <p class="help-block">
+                                Fix grouping of play history in the database.<br />
+                            </p>
+                            <div class="row">
+                                <div class="col-md-4">
+                                    <div class="btn-group">
+                                        <button class="btn btn-form" type="button" id="regroup_history">Regroup</button>
+                                    </div>
+                                </div>
+                            </div>
+                        </div>
                         <div class="form-group advanced-setting">
                             <label>Flush Temporary Sessions</label>
                             <p class="help-block">
@@ -2484,6 +2497,12 @@ $(document).ready(function() {
         confirmAjaxCall(url, msg);
     });
 
+    $("#regroup_history").click(function () {
+        var msg = 'Are you sure you want to regroup play history in the database?';
+        var url = 'regroup_history';
+        confirmAjaxCall(url, msg, null, 'Regrouping play history...');
+    });
+
     $("#delete_temp_sessions").click(function () {
         var msg = 'Are you sure you want to flush the temporary sessions?<br /><br /><strong>This will reset all currently active sessions.</strong>';
         var url = 'delete_temp_sessions';
diff --git a/plexpy/activity_processor.py b/plexpy/activity_processor.py
index 6851263b..b1558a56 100644
--- a/plexpy/activity_processor.py
+++ b/plexpy/activity_processor.py
@@ -709,7 +709,8 @@ class ActivityProcessor(object):
 
     def regroup_history(self):
         logger.info("Tautulli ActivityProcessor :: Creating database backup...")
-        database.make_backup()
+        if not database.make_backup():
+            return False
 
         logger.info("Tautulli ActivityProcessor :: Regrouping session history...")
 
@@ -720,6 +721,11 @@ class ActivityProcessor(object):
         results = self.db.select(query)
 
         for session in results:
-            self.group_history(session['id'], session)
+            try:
+                self.group_history(session['id'], session)
+            except Exception as e:
+                logger.error("Tautulli ActivityProcessor :: Error regrouping session history: %s", e)
+                return False
 
         logger.info("Tautulli ActivityProcessor :: Regrouping session history complete.")
+        return True
diff --git a/plexpy/webserve.py b/plexpy/webserve.py
index 72eb9170..06a9a802 100644
--- a/plexpy/webserve.py
+++ b/plexpy/webserve.py
@@ -51,6 +51,7 @@ if sys.version_info >= (3, 6):
 import plexpy
 if plexpy.PYTHON2:
     import activity_pinger
+    import activity_processor
     import common
     import config
     import database
@@ -85,6 +86,7 @@ if plexpy.PYTHON2:
         import macos
 else:
     from plexpy import activity_pinger
+    from plexpy import activity_processor
     from plexpy import common
     from plexpy import config
     from plexpy import database
@@ -434,6 +436,20 @@ class WebInterface(object):
             logger.warn("Unable to retrieve data for get_recently_added.")
             return serve_template(template_name="recently_added.html", data=None)
 
+    @cherrypy.expose
+    @cherrypy.tools.json_out()
+    @requireAuth(member_of("admin"))
+    @addtoapi()
+    def regroup_history(self, **kwargs):
+        """ Regroup play history in the database."""
+
+        result = activity_processor.ActivityProcessor().regroup_history()
+
+        if result:
+            return {'result': 'success', 'message': 'Regrouped play history.'}
+        else:
+            return {'result': 'error', 'message': 'Regrouping play history failed.'}
+
     @cherrypy.expose
     @cherrypy.tools.json_out()
     @requireAuth(member_of("admin"))

From 343a3e928169843d458b435a81637b736b5261e6 Mon Sep 17 00:00:00 2001
From: Tom Niget <zippedfire@free.fr>
Date: Sat, 8 Jul 2023 02:15:16 +0200
Subject: [PATCH 404/743] Multiselect user filters (#2090)

* Extract user filter generation code into method

* Extend make_user_cond to allow lists of user IDs

* Update documentation for stats APIs to indicate handling of ID lists

* Use multiselect dropdown for user filter on graphs page

Use standard concatenation

Fix select style

Move settings to JS constructor

Change text for no users checked

Don't call selectAll on page init

Add it back

Remove attributes

Fix emptiness check

Allow deselect all

Only refresh if user id changed

* Show "N users" starting at 2 users

Co-authored-by: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>

* Use helper function split_strip

Co-authored-by: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>

* Move make_user_cond at bottom and make private

* Add new user picker to history page

* Fix copy-paste error

* Again

* Add CSS for bootstrap-select

---------

Co-authored-by: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
---
 .../default/css/bootstrap-select.min.css      |  6 ++
 data/interfaces/default/css/tautulli.css      |  2 +-
 data/interfaces/default/graphs.html           | 47 ++++++++---
 data/interfaces/default/history.html          | 42 ++++++++--
 .../default/js/bootstrap-select.min.js        |  9 +++
 plexpy/graphs.py                              | 79 ++++++-------------
 plexpy/webserve.py                            | 22 +++---
 7 files changed, 125 insertions(+), 82 deletions(-)
 create mode 100644 data/interfaces/default/css/bootstrap-select.min.css
 create mode 100644 data/interfaces/default/js/bootstrap-select.min.js

diff --git a/data/interfaces/default/css/bootstrap-select.min.css b/data/interfaces/default/css/bootstrap-select.min.css
new file mode 100644
index 00000000..d22faa63
--- /dev/null
+++ b/data/interfaces/default/css/bootstrap-select.min.css
@@ -0,0 +1,6 @@
+/*!
+ * Bootstrap-select v1.13.14 (https://developer.snapappointments.com/bootstrap-select)
+ *
+ * Copyright 2012-2020 SnapAppointments, LLC
+ * Licensed under MIT (https://github.com/snapappointments/bootstrap-select/blob/master/LICENSE)
+ */@-webkit-keyframes bs-notify-fadeOut{0%{opacity:.9}100%{opacity:0}}@-o-keyframes bs-notify-fadeOut{0%{opacity:.9}100%{opacity:0}}@keyframes bs-notify-fadeOut{0%{opacity:.9}100%{opacity:0}}.bootstrap-select>select.bs-select-hidden,select.bs-select-hidden,select.selectpicker{display:none!important}.bootstrap-select{width:220px\0;vertical-align:middle}.bootstrap-select>.dropdown-toggle{position:relative;width:100%;text-align:right;white-space:nowrap;display:-webkit-inline-box;display:-webkit-inline-flex;display:-ms-inline-flexbox;display:inline-flex;-webkit-box-align:center;-webkit-align-items:center;-ms-flex-align:center;align-items:center;-webkit-box-pack:justify;-webkit-justify-content:space-between;-ms-flex-pack:justify;justify-content:space-between}.bootstrap-select>.dropdown-toggle:after{margin-top:-1px}.bootstrap-select>.dropdown-toggle.bs-placeholder,.bootstrap-select>.dropdown-toggle.bs-placeholder:active,.bootstrap-select>.dropdown-toggle.bs-placeholder:focus,.bootstrap-select>.dropdown-toggle.bs-placeholder:hover{color:#999}.bootstrap-select>.dropdown-toggle.bs-placeholder.btn-danger,.bootstrap-select>.dropdown-toggle.bs-placeholder.btn-danger:active,.bootstrap-select>.dropdown-toggle.bs-placeholder.btn-danger:focus,.bootstrap-select>.dropdown-toggle.bs-placeholder.btn-danger:hover,.bootstrap-select>.dropdown-toggle.bs-placeholder.btn-dark,.bootstrap-select>.dropdown-toggle.bs-placeholder.btn-dark:active,.bootstrap-select>.dropdown-toggle.bs-placeholder.btn-dark:focus,.bootstrap-select>.dropdown-toggle.bs-placeholder.btn-dark:hover,.bootstrap-select>.dropdown-toggle.bs-placeholder.btn-info,.bootstrap-select>.dropdown-toggle.bs-placeholder.btn-info:active,.bootstrap-select>.dropdown-toggle.bs-placeholder.btn-info:focus,.bootstrap-select>.dropdown-toggle.bs-placeholder.btn-info:hover,.bootstrap-select>.dropdown-toggle.bs-placeholder.btn-primary,.bootstrap-select>.dropdown-toggle.bs-placeholder.btn-primary:active,.bootstrap-select>.dropdown-toggle.bs-placeholder.btn-primary:focus,.bootstrap-select>.dropdown-toggle.bs-placeholder.btn-primary:hover,.bootstrap-select>.dropdown-toggle.bs-placeholder.btn-secondary,.bootstrap-select>.dropdown-toggle.bs-placeholder.btn-secondary:active,.bootstrap-select>.dropdown-toggle.bs-placeholder.btn-secondary:focus,.bootstrap-select>.dropdown-toggle.bs-placeholder.btn-secondary:hover,.bootstrap-select>.dropdown-toggle.bs-placeholder.btn-success,.bootstrap-select>.dropdown-toggle.bs-placeholder.btn-success:active,.bootstrap-select>.dropdown-toggle.bs-placeholder.btn-success:focus,.bootstrap-select>.dropdown-toggle.bs-placeholder.btn-success:hover{color:rgba(255,255,255,.5)}.bootstrap-select>select{position:absolute!important;bottom:0;left:50%;display:block!important;width:.5px!important;height:100%!important;padding:0!important;opacity:0!important;border:none;z-index:0!important}.bootstrap-select>select.mobile-device{top:0;left:0;display:block!important;width:100%!important;z-index:2!important}.bootstrap-select.is-invalid .dropdown-toggle,.error .bootstrap-select .dropdown-toggle,.has-error .bootstrap-select .dropdown-toggle,.was-validated .bootstrap-select select:invalid+.dropdown-toggle{border-color:#b94a48}.bootstrap-select.is-valid .dropdown-toggle,.was-validated .bootstrap-select select:valid+.dropdown-toggle{border-color:#28a745}.bootstrap-select.fit-width{width:auto!important}.bootstrap-select:not([class*=col-]):not([class*=form-control]):not(.input-group-btn){width:220px}.bootstrap-select .dropdown-toggle:focus,.bootstrap-select>select.mobile-device:focus+.dropdown-toggle{outline:thin dotted #333!important;outline:5px auto -webkit-focus-ring-color!important;outline-offset:-2px}.bootstrap-select.form-control{margin-bottom:0;padding:0;border:none;height:auto}:not(.input-group)>.bootstrap-select.form-control:not([class*=col-]){width:100%}.bootstrap-select.form-control.input-group-btn{float:none;z-index:auto}.form-inline .bootstrap-select,.form-inline .bootstrap-select.form-control:not([class*=col-]){width:auto}.bootstrap-select:not(.input-group-btn),.bootstrap-select[class*=col-]{float:none;display:inline-block;margin-left:0}.bootstrap-select.dropdown-menu-right,.bootstrap-select[class*=col-].dropdown-menu-right,.row .bootstrap-select[class*=col-].dropdown-menu-right{float:right}.form-group .bootstrap-select,.form-horizontal .bootstrap-select,.form-inline .bootstrap-select{margin-bottom:0}.form-group-lg .bootstrap-select.form-control,.form-group-sm .bootstrap-select.form-control{padding:0}.form-group-lg .bootstrap-select.form-control .dropdown-toggle,.form-group-sm .bootstrap-select.form-control .dropdown-toggle{height:100%;font-size:inherit;line-height:inherit;border-radius:inherit}.bootstrap-select.form-control-lg .dropdown-toggle,.bootstrap-select.form-control-sm .dropdown-toggle{font-size:inherit;line-height:inherit;border-radius:inherit}.bootstrap-select.form-control-sm .dropdown-toggle{padding:.25rem .5rem}.bootstrap-select.form-control-lg .dropdown-toggle{padding:.5rem 1rem}.form-inline .bootstrap-select .form-control{width:100%}.bootstrap-select.disabled,.bootstrap-select>.disabled{cursor:not-allowed}.bootstrap-select.disabled:focus,.bootstrap-select>.disabled:focus{outline:0!important}.bootstrap-select.bs-container{position:absolute;top:0;left:0;height:0!important;padding:0!important}.bootstrap-select.bs-container .dropdown-menu{z-index:1060}.bootstrap-select .dropdown-toggle .filter-option{position:static;top:0;left:0;float:left;height:100%;width:100%;text-align:left;overflow:hidden;-webkit-box-flex:0;-webkit-flex:0 1 auto;-ms-flex:0 1 auto;flex:0 1 auto}.bs3.bootstrap-select .dropdown-toggle .filter-option{padding-right:inherit}.input-group .bs3-has-addon.bootstrap-select .dropdown-toggle .filter-option{position:absolute;padding-top:inherit;padding-bottom:inherit;padding-left:inherit;float:none}.input-group .bs3-has-addon.bootstrap-select .dropdown-toggle .filter-option .filter-option-inner{padding-right:inherit}.bootstrap-select .dropdown-toggle .filter-option-inner-inner{overflow:hidden}.bootstrap-select .dropdown-toggle .filter-expand{width:0!important;float:left;opacity:0!important;overflow:hidden}.bootstrap-select .dropdown-toggle .caret{position:absolute;top:50%;right:12px;margin-top:-2px;vertical-align:middle}.input-group .bootstrap-select.form-control .dropdown-toggle{border-radius:inherit}.bootstrap-select[class*=col-] .dropdown-toggle{width:100%}.bootstrap-select .dropdown-menu{min-width:100%;-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box}.bootstrap-select .dropdown-menu>.inner:focus{outline:0!important}.bootstrap-select .dropdown-menu.inner{position:static;float:none;border:0;padding:0;margin:0;border-radius:0;-webkit-box-shadow:none;box-shadow:none}.bootstrap-select .dropdown-menu li{position:relative}.bootstrap-select .dropdown-menu li.active small{color:rgba(255,255,255,.5)!important}.bootstrap-select .dropdown-menu li.disabled a{cursor:not-allowed}.bootstrap-select .dropdown-menu li a{cursor:pointer;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none}.bootstrap-select .dropdown-menu li a.opt{position:relative;padding-left:2.25em}.bootstrap-select .dropdown-menu li a span.check-mark{display:none}.bootstrap-select .dropdown-menu li a span.text{display:inline-block}.bootstrap-select .dropdown-menu li small{padding-left:.5em}.bootstrap-select .dropdown-menu .notify{position:absolute;bottom:5px;width:96%;margin:0 2%;min-height:26px;padding:3px 5px;background:#f5f5f5;border:1px solid #e3e3e3;-webkit-box-shadow:inset 0 1px 1px rgba(0,0,0,.05);box-shadow:inset 0 1px 1px rgba(0,0,0,.05);pointer-events:none;opacity:.9;-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box}.bootstrap-select .dropdown-menu .notify.fadeOut{-webkit-animation:.3s linear 750ms forwards bs-notify-fadeOut;-o-animation:.3s linear 750ms forwards bs-notify-fadeOut;animation:.3s linear 750ms forwards bs-notify-fadeOut}.bootstrap-select .no-results{padding:3px;background:#f5f5f5;margin:0 5px;white-space:nowrap}.bootstrap-select.fit-width .dropdown-toggle .filter-option{position:static;display:inline;padding:0}.bootstrap-select.fit-width .dropdown-toggle .filter-option-inner,.bootstrap-select.fit-width .dropdown-toggle .filter-option-inner-inner{display:inline}.bootstrap-select.fit-width .dropdown-toggle .bs-caret:before{content:'\00a0'}.bootstrap-select.fit-width .dropdown-toggle .caret{position:static;top:auto;margin-top:-1px}.bootstrap-select.show-tick .dropdown-menu .selected span.check-mark{position:absolute;display:inline-block;right:15px;top:5px}.bootstrap-select.show-tick .dropdown-menu li a span.text{margin-right:34px}.bootstrap-select .bs-ok-default:after{content:'';display:block;width:.5em;height:1em;border-style:solid;border-width:0 .26em .26em 0;-webkit-transform:rotate(45deg);-ms-transform:rotate(45deg);-o-transform:rotate(45deg);transform:rotate(45deg)}.bootstrap-select.show-menu-arrow.open>.dropdown-toggle,.bootstrap-select.show-menu-arrow.show>.dropdown-toggle{z-index:1061}.bootstrap-select.show-menu-arrow .dropdown-toggle .filter-option:before{content:'';border-left:7px solid transparent;border-right:7px solid transparent;border-bottom:7px solid rgba(204,204,204,.2);position:absolute;bottom:-4px;left:9px;display:none}.bootstrap-select.show-menu-arrow .dropdown-toggle .filter-option:after{content:'';border-left:6px solid transparent;border-right:6px solid transparent;border-bottom:6px solid #fff;position:absolute;bottom:-4px;left:10px;display:none}.bootstrap-select.show-menu-arrow.dropup .dropdown-toggle .filter-option:before{bottom:auto;top:-4px;border-top:7px solid rgba(204,204,204,.2);border-bottom:0}.bootstrap-select.show-menu-arrow.dropup .dropdown-toggle .filter-option:after{bottom:auto;top:-4px;border-top:6px solid #fff;border-bottom:0}.bootstrap-select.show-menu-arrow.pull-right .dropdown-toggle .filter-option:before{right:12px;left:auto}.bootstrap-select.show-menu-arrow.pull-right .dropdown-toggle .filter-option:after{right:13px;left:auto}.bootstrap-select.show-menu-arrow.open>.dropdown-toggle .filter-option:after,.bootstrap-select.show-menu-arrow.open>.dropdown-toggle .filter-option:before,.bootstrap-select.show-menu-arrow.show>.dropdown-toggle .filter-option:after,.bootstrap-select.show-menu-arrow.show>.dropdown-toggle .filter-option:before{display:block}.bs-actionsbox,.bs-donebutton,.bs-searchbox{padding:4px 8px}.bs-actionsbox{width:100%;-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box}.bs-actionsbox .btn-group button{width:50%}.bs-donebutton{float:left;width:100%;-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box}.bs-donebutton .btn-group button{width:100%}.bs-searchbox+.bs-actionsbox{padding:0 8px 4px}.bs-searchbox .form-control{margin-bottom:0;width:100%;float:none}
\ No newline at end of file
diff --git a/data/interfaces/default/css/tautulli.css b/data/interfaces/default/css/tautulli.css
index 5f1d90a0..e256d2d7 100644
--- a/data/interfaces/default/css/tautulli.css
+++ b/data/interfaces/default/css/tautulli.css
@@ -2914,7 +2914,7 @@ a .home-platforms-list-cover-face:hover
     margin-bottom: -20px;
     width: 100%;
     max-width: 1750px;
-    overflow: hidden;
+    display: flow-root;
 }
 .table-card-back td {
     font-size: 12px;
diff --git a/data/interfaces/default/graphs.html b/data/interfaces/default/graphs.html
index 3f189112..8435df20 100644
--- a/data/interfaces/default/graphs.html
+++ b/data/interfaces/default/graphs.html
@@ -1,6 +1,7 @@
 <%inherit file="base.html"/>
 
 <%def name="headIncludes()">
+<link rel="stylesheet" href="${http_root}css/bootstrap-select.min.css">
 <link rel="stylesheet" href="${http_root}css/dataTables.bootstrap.min.css">
 <link rel="stylesheet" href="${http_root}css/tautulli-dataTables.css">
 </%def>
@@ -14,9 +15,7 @@
         <div class="button-bar">
             <div class="btn-group" id="user-selection">
                 <label>
-                    <select name="graph-user" id="graph-user" class="btn" style="color: inherit;">
-                        <option value="">All Users</option>
-                        <option disabled>&#9472;&#9472;&#9472;&#9472;&#9472;&#9472;&#9472;&#9472;&#9472;&#9472;&#9472;&#9472;</option>
+                    <select name="graph-user" id="graph-user" multiple>
                     </select>
                 </label>
             </div>
@@ -225,6 +224,7 @@
 </%def>
 
 <%def name="javascriptIncludes()">
+<script src="${http_root}js/bootstrap-select.min.js"></script>
 <script src="${http_root}js/highcharts.min.js"></script>
 <script src="${http_root}js/jquery.dataTables.min.js"></script>
 <script src="${http_root}js/dataTables.bootstrap.min.js"></script>
@@ -373,14 +373,35 @@
             type: 'get',
             dataType: "json",
             success: function (data) {
-                var select = $('#graph-user');
+                let select = $('#graph-user');
+                let by_id = {};
                 data.sort(function(a, b) {
                     return a.friendly_name.localeCompare(b.friendly_name);
                 });
                 data.forEach(function(item) {
                     select.append('<option value="' + item.user_id + '">' +
                         item.friendly_name + '</option>');
+                    by_id[item.user_id] = item.friendly_name;
                 });
+                select.selectpicker({
+                    countSelectedText: function(sel, total) {
+                        if (sel === 0 || sel === total) {
+                            return 'All users';
+                        } else if (sel > 1) {
+                            return sel + ' users';
+                        } else {
+                            return select.val().map(function(id) {
+                                return by_id[id];
+                            }).join(', ');
+                        }
+                    },
+                    style: 'btn-dark',
+                    actionsBox: true,
+                    selectedTextFormat: 'count',
+                    noneSelectedText: 'All users'
+                });
+                select.selectpicker('render');
+                select.selectpicker('selectAll');
             }
         });
 
@@ -602,11 +623,6 @@
             $('#nav-tabs-total').tab('show');
         }
 
-        // Set initial state
-        if (current_tab === '#tabs-plays') { loadGraphsTab1(current_day_range, yaxis); }
-        if (current_tab === '#tabs-stream') { loadGraphsTab2(current_day_range, yaxis); }
-        if (current_tab === '#tabs-total') { loadGraphsTab3(current_month_range, yaxis); }
-
         // Tab1 opened
         $('#nav-tabs-plays').on('shown.bs.tab', function (e) {
             e.preventDefault();
@@ -652,9 +668,20 @@
             $('.months').text(current_month_range);
         });
 
+        let graph_user_last_id = undefined;
+
         // User changed
         $('#graph-user').on('change', function() {
-            selected_user_id = $(this).val() || null;
+            let val = $(this).val();
+            if (val.length === 0 || val.length === $(this).children().length) {
+                selected_user_id = null; // if all users are selected, just send an empty list
+            } else {
+                selected_user_id = val.join(",");
+            }
+            if (selected_user_id === graph_user_last_id) {
+                return;
+            }
+            graph_user_last_id = selected_user_id;
             if (current_tab === '#tabs-plays') { loadGraphsTab1(current_day_range, yaxis); }
             if (current_tab === '#tabs-stream') { loadGraphsTab2(current_day_range, yaxis); }
             if (current_tab === '#tabs-total') { loadGraphsTab3(current_month_range, yaxis); }
diff --git a/data/interfaces/default/history.html b/data/interfaces/default/history.html
index 327b99b7..8ab8b19e 100644
--- a/data/interfaces/default/history.html
+++ b/data/interfaces/default/history.html
@@ -1,6 +1,7 @@
 <%inherit file="base.html"/>
 
 <%def name="headIncludes()">
+<link rel="stylesheet" href="${http_root}css/bootstrap-select.min.css">
 <link rel="stylesheet" href="${http_root}css/dataTables.bootstrap.min.css">
 <link rel="stylesheet" href="${http_root}css/dataTables.colVis.css">
 <link rel="stylesheet" href="${http_root}css/tautulli-dataTables.css">
@@ -31,9 +32,7 @@
             % if _session['user_group'] == 'admin':
             <div class="btn-group" id="user-selection">
                 <label>
-                    <select name="history-user" id="history-user" class="btn" style="color: inherit;">
-                        <option value="">All Users</option>
-                        <option disabled>&#9472;&#9472;&#9472;&#9472;&#9472;&#9472;&#9472;&#9472;&#9472;&#9472;&#9472;&#9472;</option>
+                    <select name="history-user" id="history-user" multiple>
                     </select>
                 </label>
             </div>
@@ -121,6 +120,7 @@
 </%def>
 
 <%def name="javascriptIncludes()">
+<script src="${http_root}js/bootstrap-select.min.js"></script>
 <script src="${http_root}js/jquery.dataTables.min.js"></script>
 <script src="${http_root}js/dataTables.colVis.js"></script>
 <script src="${http_root}js/dataTables.bootstrap.min.js"></script>
@@ -134,17 +134,40 @@
             type: 'GET',
             dataType: 'json',
             success: function (data) {
-                var select = $('#history-user');
+                let select = $('#history-user');
+                let by_id = {};
                 data.sort(function (a, b) {
                     return a.friendly_name.localeCompare(b.friendly_name);
                 });
                 data.forEach(function (item) {
                     select.append('<option value="' + item.user_id + '">' +
                         item.friendly_name + '</option>');
+                    by_id[item.user_id] = item.friendly_name;
                 });
+                select.selectpicker({
+                    countSelectedText: function(sel, total) {
+                        if (sel === 0 || sel === total) {
+                            return 'All users';
+                        } else if (sel > 1) {
+                            return sel + ' users';
+                        } else {
+                            return select.val().map(function(id) {
+                                return by_id[id];
+                            }).join(', ');
+                        }
+                    },
+                    style: 'btn-dark',
+                    actionsBox: true,
+                    selectedTextFormat: 'count',
+                    noneSelectedText: 'All users'
+                });
+                select.selectpicker('render');
+                select.selectpicker('selectAll');
             }
         });
 
+        let history_user_last_id = undefined;
+
         function loadHistoryTable(media_type, transcode_decision, selected_user_id) {
             history_table_options.ajax = {
                 url: 'get_history',
@@ -187,7 +210,16 @@
             });
 
             $('#history-user').on('change', function () {
-                selected_user_id = $(this).val() || null;
+                let val = $(this).val();
+                if (val.length === 0 || val.length === $(this).children().length) {
+                    selected_user_id = null; // if all users are selected, just send an empty list
+                } else {
+                    selected_user_id = val.join(",");
+                }
+                if (selected_user_id === history_user_last_id) {
+                    return;
+                }
+                history_user_last_id = selected_user_id;
                 history_table.draw();
             });
         }
diff --git a/data/interfaces/default/js/bootstrap-select.min.js b/data/interfaces/default/js/bootstrap-select.min.js
new file mode 100644
index 00000000..92e3a32e
--- /dev/null
+++ b/data/interfaces/default/js/bootstrap-select.min.js
@@ -0,0 +1,9 @@
+/*!
+ * Bootstrap-select v1.13.14 (https://developer.snapappointments.com/bootstrap-select)
+ *
+ * Copyright 2012-2020 SnapAppointments, LLC
+ * Licensed under MIT (https://github.com/snapappointments/bootstrap-select/blob/master/LICENSE)
+ */
+
+!function(e,t){void 0===e&&void 0!==window&&(e=window),"function"==typeof define&&define.amd?define(["jquery"],function(e){return t(e)}):"object"==typeof module&&module.exports?module.exports=t(require("jquery")):t(e.jQuery)}(this,function(e){!function(z){"use strict";var d=["sanitize","whiteList","sanitizeFn"],r=["background","cite","href","itemtype","longdesc","poster","src","xlink:href"],e={"*":["class","dir","id","lang","role","tabindex","style",/^aria-[\w-]*$/i],a:["target","href","title","rel"],area:[],b:[],br:[],col:[],code:[],div:[],em:[],hr:[],h1:[],h2:[],h3:[],h4:[],h5:[],h6:[],i:[],img:["src","alt","title","width","height"],li:[],ol:[],p:[],pre:[],s:[],small:[],span:[],sub:[],sup:[],strong:[],u:[],ul:[]},l=/^(?:(?:https?|mailto|ftp|tel|file):|[^&:/?#]*(?:[/?#]|$))/gi,a=/^data:(?:image\/(?:bmp|gif|jpeg|jpg|png|tiff|webp)|video\/(?:mpeg|mp4|ogg|webm)|audio\/(?:mp3|oga|ogg|opus));base64,[a-z0-9+/]+=*$/i;function v(e,t){var i=e.nodeName.toLowerCase();if(-1!==z.inArray(i,t))return-1===z.inArray(i,r)||Boolean(e.nodeValue.match(l)||e.nodeValue.match(a));for(var s=z(t).filter(function(e,t){return t instanceof RegExp}),n=0,o=s.length;n<o;n++)if(i.match(s[n]))return!0;return!1}function P(e,t,i){if(i&&"function"==typeof i)return i(e);for(var s=Object.keys(t),n=0,o=e.length;n<o;n++)for(var r=e[n].querySelectorAll("*"),l=0,a=r.length;l<a;l++){var c=r[l],d=c.nodeName.toLowerCase();if(-1!==s.indexOf(d))for(var h=[].slice.call(c.attributes),p=[].concat(t["*"]||[],t[d]||[]),u=0,f=h.length;u<f;u++){var m=h[u];v(m,p)||c.removeAttribute(m.nodeName)}else c.parentNode.removeChild(c)}}"classList"in document.createElement("_")||function(e){if("Element"in e){var t="classList",i="prototype",s=e.Element[i],n=Object,o=function(){var i=z(this);return{add:function(e){return e=Array.prototype.slice.call(arguments).join(" "),i.addClass(e)},remove:function(e){return e=Array.prototype.slice.call(arguments).join(" "),i.removeClass(e)},toggle:function(e,t){return i.toggleClass(e,t)},contains:function(e){return i.hasClass(e)}}};if(n.defineProperty){var r={get:o,enumerable:!0,configurable:!0};try{n.defineProperty(s,t,r)}catch(e){void 0!==e.number&&-2146823252!==e.number||(r.enumerable=!1,n.defineProperty(s,t,r))}}else n[i].__defineGetter__&&s.__defineGetter__(t,o)}}(window);var t,c,i=document.createElement("_");if(i.classList.add("c1","c2"),!i.classList.contains("c2")){var s=DOMTokenList.prototype.add,n=DOMTokenList.prototype.remove;DOMTokenList.prototype.add=function(){Array.prototype.forEach.call(arguments,s.bind(this))},DOMTokenList.prototype.remove=function(){Array.prototype.forEach.call(arguments,n.bind(this))}}if(i.classList.toggle("c3",!1),i.classList.contains("c3")){var o=DOMTokenList.prototype.toggle;DOMTokenList.prototype.toggle=function(e,t){return 1 in arguments&&!this.contains(e)==!t?t:o.call(this,e)}}function h(e){if(null==this)throw new TypeError;var t=String(this);if(e&&"[object RegExp]"==c.call(e))throw new TypeError;var i=t.length,s=String(e),n=s.length,o=1<arguments.length?arguments[1]:void 0,r=o?Number(o):0;r!=r&&(r=0);var l=Math.min(Math.max(r,0),i);if(i<n+l)return!1;for(var a=-1;++a<n;)if(t.charCodeAt(l+a)!=s.charCodeAt(a))return!1;return!0}function O(e,t){var i,s=e.selectedOptions,n=[];if(t){for(var o=0,r=s.length;o<r;o++)(i=s[o]).disabled||"OPTGROUP"===i.parentNode.tagName&&i.parentNode.disabled||n.push(i);return n}return s}function T(e,t){for(var i,s=[],n=t||e.selectedOptions,o=0,r=n.length;o<r;o++)(i=n[o]).disabled||"OPTGROUP"===i.parentNode.tagName&&i.parentNode.disabled||s.push(i.value);return e.multiple?s:s.length?s[0]:null}i=null,String.prototype.startsWith||(t=function(){try{var e={},t=Object.defineProperty,i=t(e,e,e)&&t}catch(e){}return i}(),c={}.toString,t?t(String.prototype,"startsWith",{value:h,configurable:!0,writable:!0}):String.prototype.startsWith=h),Object.keys||(Object.keys=function(e,t,i){for(t in i=[],e)i.hasOwnProperty.call(e,t)&&i.push(t);return i}),HTMLSelectElement&&!HTMLSelectElement.prototype.hasOwnProperty("selectedOptions")&&Object.defineProperty(HTMLSelectElement.prototype,"selectedOptions",{get:function(){return this.querySelectorAll(":checked")}});var p={useDefault:!1,_set:z.valHooks.select.set};z.valHooks.select.set=function(e,t){return t&&!p.useDefault&&z(e).data("selected",!0),p._set.apply(this,arguments)};var A=null,u=function(){try{return new Event("change"),!0}catch(e){return!1}}();function k(e,t,i,s){for(var n=["display","subtext","tokens"],o=!1,r=0;r<n.length;r++){var l=n[r],a=e[l];if(a&&(a=a.toString(),"display"===l&&(a=a.replace(/<[^>]+>/g,"")),s&&(a=w(a)),a=a.toUpperCase(),o="contains"===i?0<=a.indexOf(t):a.startsWith(t)))break}return o}function L(e){return parseInt(e,10)||0}z.fn.triggerNative=function(e){var t,i=this[0];i.dispatchEvent?(u?t=new Event(e,{bubbles:!0}):(t=document.createEvent("Event")).initEvent(e,!0,!1),i.dispatchEvent(t)):i.fireEvent?((t=document.createEventObject()).eventType=e,i.fireEvent("on"+e,t)):this.trigger(e)};var f={"\xc0":"A","\xc1":"A","\xc2":"A","\xc3":"A","\xc4":"A","\xc5":"A","\xe0":"a","\xe1":"a","\xe2":"a","\xe3":"a","\xe4":"a","\xe5":"a","\xc7":"C","\xe7":"c","\xd0":"D","\xf0":"d","\xc8":"E","\xc9":"E","\xca":"E","\xcb":"E","\xe8":"e","\xe9":"e","\xea":"e","\xeb":"e","\xcc":"I","\xcd":"I","\xce":"I","\xcf":"I","\xec":"i","\xed":"i","\xee":"i","\xef":"i","\xd1":"N","\xf1":"n","\xd2":"O","\xd3":"O","\xd4":"O","\xd5":"O","\xd6":"O","\xd8":"O","\xf2":"o","\xf3":"o","\xf4":"o","\xf5":"o","\xf6":"o","\xf8":"o","\xd9":"U","\xda":"U","\xdb":"U","\xdc":"U","\xf9":"u","\xfa":"u","\xfb":"u","\xfc":"u","\xdd":"Y","\xfd":"y","\xff":"y","\xc6":"Ae","\xe6":"ae","\xde":"Th","\xfe":"th","\xdf":"ss","\u0100":"A","\u0102":"A","\u0104":"A","\u0101":"a","\u0103":"a","\u0105":"a","\u0106":"C","\u0108":"C","\u010a":"C","\u010c":"C","\u0107":"c","\u0109":"c","\u010b":"c","\u010d":"c","\u010e":"D","\u0110":"D","\u010f":"d","\u0111":"d","\u0112":"E","\u0114":"E","\u0116":"E","\u0118":"E","\u011a":"E","\u0113":"e","\u0115":"e","\u0117":"e","\u0119":"e","\u011b":"e","\u011c":"G","\u011e":"G","\u0120":"G","\u0122":"G","\u011d":"g","\u011f":"g","\u0121":"g","\u0123":"g","\u0124":"H","\u0126":"H","\u0125":"h","\u0127":"h","\u0128":"I","\u012a":"I","\u012c":"I","\u012e":"I","\u0130":"I","\u0129":"i","\u012b":"i","\u012d":"i","\u012f":"i","\u0131":"i","\u0134":"J","\u0135":"j","\u0136":"K","\u0137":"k","\u0138":"k","\u0139":"L","\u013b":"L","\u013d":"L","\u013f":"L","\u0141":"L","\u013a":"l","\u013c":"l","\u013e":"l","\u0140":"l","\u0142":"l","\u0143":"N","\u0145":"N","\u0147":"N","\u014a":"N","\u0144":"n","\u0146":"n","\u0148":"n","\u014b":"n","\u014c":"O","\u014e":"O","\u0150":"O","\u014d":"o","\u014f":"o","\u0151":"o","\u0154":"R","\u0156":"R","\u0158":"R","\u0155":"r","\u0157":"r","\u0159":"r","\u015a":"S","\u015c":"S","\u015e":"S","\u0160":"S","\u015b":"s","\u015d":"s","\u015f":"s","\u0161":"s","\u0162":"T","\u0164":"T","\u0166":"T","\u0163":"t","\u0165":"t","\u0167":"t","\u0168":"U","\u016a":"U","\u016c":"U","\u016e":"U","\u0170":"U","\u0172":"U","\u0169":"u","\u016b":"u","\u016d":"u","\u016f":"u","\u0171":"u","\u0173":"u","\u0174":"W","\u0175":"w","\u0176":"Y","\u0177":"y","\u0178":"Y","\u0179":"Z","\u017b":"Z","\u017d":"Z","\u017a":"z","\u017c":"z","\u017e":"z","\u0132":"IJ","\u0133":"ij","\u0152":"Oe","\u0153":"oe","\u0149":"'n","\u017f":"s"},m=/[\xc0-\xd6\xd8-\xf6\xf8-\xff\u0100-\u017f]/g,g=RegExp("[\\u0300-\\u036f\\ufe20-\\ufe2f\\u20d0-\\u20ff\\u1ab0-\\u1aff\\u1dc0-\\u1dff]","g");function b(e){return f[e]}function w(e){return(e=e.toString())&&e.replace(m,b).replace(g,"")}var I,x,y,$,S=(I={"&":"&amp;","<":"&lt;",">":"&gt;",'"':"&quot;","'":"&#x27;","`":"&#x60;"},x="(?:"+Object.keys(I).join("|")+")",y=RegExp(x),$=RegExp(x,"g"),function(e){return e=null==e?"":""+e,y.test(e)?e.replace($,E):e});function E(e){return I[e]}var C={32:" ",48:"0",49:"1",50:"2",51:"3",52:"4",53:"5",54:"6",55:"7",56:"8",57:"9",59:";",65:"A",66:"B",67:"C",68:"D",69:"E",70:"F",71:"G",72:"H",73:"I",74:"J",75:"K",76:"L",77:"M",78:"N",79:"O",80:"P",81:"Q",82:"R",83:"S",84:"T",85:"U",86:"V",87:"W",88:"X",89:"Y",90:"Z",96:"0",97:"1",98:"2",99:"3",100:"4",101:"5",102:"6",103:"7",104:"8",105:"9"},N=27,D=13,H=32,W=9,B=38,M=40,R={success:!1,major:"3"};try{R.full=(z.fn.dropdown.Constructor.VERSION||"").split(" ")[0].split("."),R.major=R.full[0],R.success=!0}catch(e){}var U=0,j=".bs.select",V={DISABLED:"disabled",DIVIDER:"divider",SHOW:"open",DROPUP:"dropup",MENU:"dropdown-menu",MENURIGHT:"dropdown-menu-right",MENULEFT:"dropdown-menu-left",BUTTONCLASS:"btn-default",POPOVERHEADER:"popover-title",ICONBASE:"glyphicon",TICKICON:"glyphicon-ok"},F={MENU:"."+V.MENU},_={span:document.createElement("span"),i:document.createElement("i"),subtext:document.createElement("small"),a:document.createElement("a"),li:document.createElement("li"),whitespace:document.createTextNode("\xa0"),fragment:document.createDocumentFragment()};_.a.setAttribute("role","option"),"4"===R.major&&(_.a.className="dropdown-item"),_.subtext.className="text-muted",_.text=_.span.cloneNode(!1),_.text.className="text",_.checkMark=_.span.cloneNode(!1);var G=new RegExp(B+"|"+M),q=new RegExp("^"+W+"$|"+N),K={li:function(e,t,i){var s=_.li.cloneNode(!1);return e&&(1===e.nodeType||11===e.nodeType?s.appendChild(e):s.innerHTML=e),void 0!==t&&""!==t&&(s.className=t),null!=i&&s.classList.add("optgroup-"+i),s},a:function(e,t,i){var s=_.a.cloneNode(!0);return e&&(11===e.nodeType?s.appendChild(e):s.insertAdjacentHTML("beforeend",e)),void 0!==t&&""!==t&&s.classList.add.apply(s.classList,t.split(" ")),i&&s.setAttribute("style",i),s},text:function(e,t){var i,s,n=_.text.cloneNode(!1);if(e.content)n.innerHTML=e.content;else{if(n.textContent=e.text,e.icon){var o=_.whitespace.cloneNode(!1);(s=(!0===t?_.i:_.span).cloneNode(!1)).className=this.options.iconBase+" "+e.icon,_.fragment.appendChild(s),_.fragment.appendChild(o)}e.subtext&&((i=_.subtext.cloneNode(!1)).textContent=e.subtext,n.appendChild(i))}if(!0===t)for(;0<n.childNodes.length;)_.fragment.appendChild(n.childNodes[0]);else _.fragment.appendChild(n);return _.fragment},label:function(e){var t,i,s=_.text.cloneNode(!1);if(s.innerHTML=e.display,e.icon){var n=_.whitespace.cloneNode(!1);(i=_.span.cloneNode(!1)).className=this.options.iconBase+" "+e.icon,_.fragment.appendChild(i),_.fragment.appendChild(n)}return e.subtext&&((t=_.subtext.cloneNode(!1)).textContent=e.subtext,s.appendChild(t)),_.fragment.appendChild(s),_.fragment}},Y=function(e,t){var i=this;p.useDefault||(z.valHooks.select.set=p._set,p.useDefault=!0),this.$element=z(e),this.$newElement=null,this.$button=null,this.$menu=null,this.options=t,this.selectpicker={main:{},search:{},current:{},view:{},isSearching:!1,keydown:{keyHistory:"",resetKeyHistory:{start:function(){return setTimeout(function(){i.selectpicker.keydown.keyHistory=""},800)}}}},this.sizeInfo={},null===this.options.title&&(this.options.title=this.$element.attr("title"));var s=this.options.windowPadding;"number"==typeof s&&(this.options.windowPadding=[s,s,s,s]),this.val=Y.prototype.val,this.render=Y.prototype.render,this.refresh=Y.prototype.refresh,this.setStyle=Y.prototype.setStyle,this.selectAll=Y.prototype.selectAll,this.deselectAll=Y.prototype.deselectAll,this.destroy=Y.prototype.destroy,this.remove=Y.prototype.remove,this.show=Y.prototype.show,this.hide=Y.prototype.hide,this.init()};function Z(e){var l,a=arguments,c=e;if([].shift.apply(a),!R.success){try{R.full=(z.fn.dropdown.Constructor.VERSION||"").split(" ")[0].split(".")}catch(e){Y.BootstrapVersion?R.full=Y.BootstrapVersion.split(" ")[0].split("."):(R.full=[R.major,"0","0"],console.warn("There was an issue retrieving Bootstrap's version. Ensure Bootstrap is being loaded before bootstrap-select and there is no namespace collision. If loading Bootstrap asynchronously, the version may need to be manually specified via $.fn.selectpicker.Constructor.BootstrapVersion.",e))}R.major=R.full[0],R.success=!0}if("4"===R.major){var t=[];Y.DEFAULTS.style===V.BUTTONCLASS&&t.push({name:"style",className:"BUTTONCLASS"}),Y.DEFAULTS.iconBase===V.ICONBASE&&t.push({name:"iconBase",className:"ICONBASE"}),Y.DEFAULTS.tickIcon===V.TICKICON&&t.push({name:"tickIcon",className:"TICKICON"}),V.DIVIDER="dropdown-divider",V.SHOW="show",V.BUTTONCLASS="btn-light",V.POPOVERHEADER="popover-header",V.ICONBASE="",V.TICKICON="bs-ok-default";for(var i=0;i<t.length;i++){e=t[i];Y.DEFAULTS[e.name]=V[e.className]}}var s=this.each(function(){var e=z(this);if(e.is("select")){var t=e.data("selectpicker"),i="object"==typeof c&&c;if(t){if(i)for(var s in i)i.hasOwnProperty(s)&&(t.options[s]=i[s])}else{var n=e.data();for(var o in n)n.hasOwnProperty(o)&&-1!==z.inArray(o,d)&&delete n[o];var r=z.extend({},Y.DEFAULTS,z.fn.selectpicker.defaults||{},n,i);r.template=z.extend({},Y.DEFAULTS.template,z.fn.selectpicker.defaults?z.fn.selectpicker.defaults.template:{},n.template,i.template),e.data("selectpicker",t=new Y(this,r))}"string"==typeof c&&(l=t[c]instanceof Function?t[c].apply(t,a):t.options[c])}});return void 0!==l?l:s}Y.VERSION="1.13.14",Y.DEFAULTS={noneSelectedText:"Nothing selected",noneResultsText:"No results matched {0}",countSelectedText:function(e,t){return 1==e?"{0} item selected":"{0} items selected"},maxOptionsText:function(e,t){return[1==e?"Limit reached ({n} item max)":"Limit reached ({n} items max)",1==t?"Group limit reached ({n} item max)":"Group limit reached ({n} items max)"]},selectAllText:"Select All",deselectAllText:"Deselect All",doneButton:!1,doneButtonText:"Close",multipleSeparator:", ",styleBase:"btn",style:V.BUTTONCLASS,size:"auto",title:null,selectedTextFormat:"values",width:!1,container:!1,hideDisabled:!1,showSubtext:!1,showIcon:!0,showContent:!0,dropupAuto:!0,header:!1,liveSearch:!1,liveSearchPlaceholder:null,liveSearchNormalize:!1,liveSearchStyle:"contains",actionsBox:!1,iconBase:V.ICONBASE,tickIcon:V.TICKICON,showTick:!1,template:{caret:'<span class="caret"></span>'},maxOptions:!1,mobile:!1,selectOnTab:!1,dropdownAlignRight:!1,windowPadding:0,virtualScroll:600,display:!1,sanitize:!0,sanitizeFn:null,whiteList:e},Y.prototype={constructor:Y,init:function(){var i=this,e=this.$element.attr("id");U++,this.selectId="bs-select-"+U,this.$element[0].classList.add("bs-select-hidden"),this.multiple=this.$element.prop("multiple"),this.autofocus=this.$element.prop("autofocus"),this.$element[0].classList.contains("show-tick")&&(this.options.showTick=!0),this.$newElement=this.createDropdown(),this.buildData(),this.$element.after(this.$newElement).prependTo(this.$newElement),this.$button=this.$newElement.children("button"),this.$menu=this.$newElement.children(F.MENU),this.$menuInner=this.$menu.children(".inner"),this.$searchbox=this.$menu.find("input"),this.$element[0].classList.remove("bs-select-hidden"),!0===this.options.dropdownAlignRight&&this.$menu[0].classList.add(V.MENURIGHT),void 0!==e&&this.$button.attr("data-id",e),this.checkDisabled(),this.clickListener(),this.options.liveSearch?(this.liveSearchListener(),this.focusedParent=this.$searchbox[0]):this.focusedParent=this.$menuInner[0],this.setStyle(),this.render(),this.setWidth(),this.options.container?this.selectPosition():this.$element.on("hide"+j,function(){if(i.isVirtual()){var e=i.$menuInner[0],t=e.firstChild.cloneNode(!1);e.replaceChild(t,e.firstChild),e.scrollTop=0}}),this.$menu.data("this",this),this.$newElement.data("this",this),this.options.mobile&&this.mobile(),this.$newElement.on({"hide.bs.dropdown":function(e){i.$element.trigger("hide"+j,e)},"hidden.bs.dropdown":function(e){i.$element.trigger("hidden"+j,e)},"show.bs.dropdown":function(e){i.$element.trigger("show"+j,e)},"shown.bs.dropdown":function(e){i.$element.trigger("shown"+j,e)}}),i.$element[0].hasAttribute("required")&&this.$element.on("invalid"+j,function(){i.$button[0].classList.add("bs-invalid"),i.$element.on("shown"+j+".invalid",function(){i.$element.val(i.$element.val()).off("shown"+j+".invalid")}).on("rendered"+j,function(){this.validity.valid&&i.$button[0].classList.remove("bs-invalid"),i.$element.off("rendered"+j)}),i.$button.on("blur"+j,function(){i.$element.trigger("focus").trigger("blur"),i.$button.off("blur"+j)})}),setTimeout(function(){i.buildList(),i.$element.trigger("loaded"+j)})},createDropdown:function(){var e=this.multiple||this.options.showTick?" show-tick":"",t=this.multiple?' aria-multiselectable="true"':"",i="",s=this.autofocus?" autofocus":"";R.major<4&&this.$element.parent().hasClass("input-group")&&(i=" input-group-btn");var n,o="",r="",l="",a="";return this.options.header&&(o='<div class="'+V.POPOVERHEADER+'"><button type="button" class="close" aria-hidden="true">&times;</button>'+this.options.header+"</div>"),this.options.liveSearch&&(r='<div class="bs-searchbox"><input type="search" class="form-control" autocomplete="off"'+(null===this.options.liveSearchPlaceholder?"":' placeholder="'+S(this.options.liveSearchPlaceholder)+'"')+' role="combobox" aria-label="Search" aria-controls="'+this.selectId+'" aria-autocomplete="list"></div>'),this.multiple&&this.options.actionsBox&&(l='<div class="bs-actionsbox"><div class="btn-group btn-group-sm btn-block"><button type="button" class="actions-btn bs-select-all btn '+V.BUTTONCLASS+'">'+this.options.selectAllText+'</button><button type="button" class="actions-btn bs-deselect-all btn '+V.BUTTONCLASS+'">'+this.options.deselectAllText+"</button></div></div>"),this.multiple&&this.options.doneButton&&(a='<div class="bs-donebutton"><div class="btn-group btn-block"><button type="button" class="btn btn-sm '+V.BUTTONCLASS+'">'+this.options.doneButtonText+"</button></div></div>"),n='<div class="dropdown bootstrap-select'+e+i+'"><button type="button" class="'+this.options.styleBase+' dropdown-toggle" '+("static"===this.options.display?'data-display="static"':"")+'data-toggle="dropdown"'+s+' role="combobox" aria-owns="'+this.selectId+'" aria-haspopup="listbox" aria-expanded="false"><div class="filter-option"><div class="filter-option-inner"><div class="filter-option-inner-inner"></div></div> </div>'+("4"===R.major?"":'<span class="bs-caret">'+this.options.template.caret+"</span>")+'</button><div class="'+V.MENU+" "+("4"===R.major?"":V.SHOW)+'">'+o+r+l+'<div class="inner '+V.SHOW+'" role="listbox" id="'+this.selectId+'" tabindex="-1" '+t+'><ul class="'+V.MENU+" inner "+("4"===R.major?V.SHOW:"")+'" role="presentation"></ul></div>'+a+"</div></div>",z(n)},setPositionData:function(){this.selectpicker.view.canHighlight=[];for(var e=this.selectpicker.view.size=0;e<this.selectpicker.current.data.length;e++){var t=this.selectpicker.current.data[e],i=!0;"divider"===t.type?(i=!1,t.height=this.sizeInfo.dividerHeight):"optgroup-label"===t.type?(i=!1,t.height=this.sizeInfo.dropdownHeaderHeight):t.height=this.sizeInfo.liHeight,t.disabled&&(i=!1),this.selectpicker.view.canHighlight.push(i),i&&(this.selectpicker.view.size++,t.posinset=this.selectpicker.view.size),t.position=(0===e?0:this.selectpicker.current.data[e-1].position)+t.height}},isVirtual:function(){return!1!==this.options.virtualScroll&&this.selectpicker.main.elements.length>=this.options.virtualScroll||!0===this.options.virtualScroll},createView:function(A,e,t){var L,N,D=this,i=0,H=[];if(this.selectpicker.isSearching=A,this.selectpicker.current=A?this.selectpicker.search:this.selectpicker.main,this.setPositionData(),e)if(t)i=this.$menuInner[0].scrollTop;else if(!D.multiple){var s=D.$element[0],n=(s.options[s.selectedIndex]||{}).liIndex;if("number"==typeof n&&!1!==D.options.size){var o=D.selectpicker.main.data[n],r=o&&o.position;r&&(i=r-(D.sizeInfo.menuInnerHeight+D.sizeInfo.liHeight)/2)}}function l(e,t){var i,s,n,o,r,l,a,c,d=D.selectpicker.current.elements.length,h=[],p=!0,u=D.isVirtual();D.selectpicker.view.scrollTop=e,i=Math.ceil(D.sizeInfo.menuInnerHeight/D.sizeInfo.liHeight*1.5),s=Math.round(d/i)||1;for(var f=0;f<s;f++){var m=(f+1)*i;if(f===s-1&&(m=d),h[f]=[f*i+(f?1:0),m],!d)break;void 0===r&&e-1<=D.selectpicker.current.data[m-1].position-D.sizeInfo.menuInnerHeight&&(r=f)}if(void 0===r&&(r=0),l=[D.selectpicker.view.position0,D.selectpicker.view.position1],n=Math.max(0,r-1),o=Math.min(s-1,r+1),D.selectpicker.view.position0=!1===u?0:Math.max(0,h[n][0])||0,D.selectpicker.view.position1=!1===u?d:Math.min(d,h[o][1])||0,a=l[0]!==D.selectpicker.view.position0||l[1]!==D.selectpicker.view.position1,void 0!==D.activeIndex&&(N=D.selectpicker.main.elements[D.prevActiveIndex],H=D.selectpicker.main.elements[D.activeIndex],L=D.selectpicker.main.elements[D.selectedIndex],t&&(D.activeIndex!==D.selectedIndex&&D.defocusItem(H),D.activeIndex=void 0),D.activeIndex&&D.activeIndex!==D.selectedIndex&&D.defocusItem(L)),void 0!==D.prevActiveIndex&&D.prevActiveIndex!==D.activeIndex&&D.prevActiveIndex!==D.selectedIndex&&D.defocusItem(N),(t||a)&&(c=D.selectpicker.view.visibleElements?D.selectpicker.view.visibleElements.slice():[],D.selectpicker.view.visibleElements=!1===u?D.selectpicker.current.elements:D.selectpicker.current.elements.slice(D.selectpicker.view.position0,D.selectpicker.view.position1),D.setOptionStatus(),(A||!1===u&&t)&&(p=!function(e,i){return e.length===i.length&&e.every(function(e,t){return e===i[t]})}(c,D.selectpicker.view.visibleElements)),(t||!0===u)&&p)){var v,g,b=D.$menuInner[0],w=document.createDocumentFragment(),I=b.firstChild.cloneNode(!1),x=D.selectpicker.view.visibleElements,k=[];b.replaceChild(I,b.firstChild);f=0;for(var y=x.length;f<y;f++){var $,S,E=x[f];D.options.sanitize&&($=E.lastChild)&&(S=D.selectpicker.current.data[f+D.selectpicker.view.position0])&&S.content&&!S.sanitized&&(k.push($),S.sanitized=!0),w.appendChild(E)}if(D.options.sanitize&&k.length&&P(k,D.options.whiteList,D.options.sanitizeFn),!0===u?(v=0===D.selectpicker.view.position0?0:D.selectpicker.current.data[D.selectpicker.view.position0-1].position,g=D.selectpicker.view.position1>d-1?0:D.selectpicker.current.data[d-1].position-D.selectpicker.current.data[D.selectpicker.view.position1-1].position,b.firstChild.style.marginTop=v+"px",b.firstChild.style.marginBottom=g+"px"):(b.firstChild.style.marginTop=0,b.firstChild.style.marginBottom=0),b.firstChild.appendChild(w),!0===u&&D.sizeInfo.hasScrollBar){var C=b.firstChild.offsetWidth;if(t&&C<D.sizeInfo.menuInnerInnerWidth&&D.sizeInfo.totalMenuWidth>D.sizeInfo.selectWidth)b.firstChild.style.minWidth=D.sizeInfo.menuInnerInnerWidth+"px";else if(C>D.sizeInfo.menuInnerInnerWidth){D.$menu[0].style.minWidth=0;var O=b.firstChild.offsetWidth;O>D.sizeInfo.menuInnerInnerWidth&&(D.sizeInfo.menuInnerInnerWidth=O,b.firstChild.style.minWidth=D.sizeInfo.menuInnerInnerWidth+"px"),D.$menu[0].style.minWidth=""}}}if(D.prevActiveIndex=D.activeIndex,D.options.liveSearch){if(A&&t){var z,T=0;D.selectpicker.view.canHighlight[T]||(T=1+D.selectpicker.view.canHighlight.slice(1).indexOf(!0)),z=D.selectpicker.view.visibleElements[T],D.defocusItem(D.selectpicker.view.currentActive),D.activeIndex=(D.selectpicker.current.data[T]||{}).index,D.focusItem(z)}}else D.$menuInner.trigger("focus")}l(i,!0),this.$menuInner.off("scroll.createView").on("scroll.createView",function(e,t){D.noScroll||l(this.scrollTop,t),D.noScroll=!1}),z(window).off("resize"+j+"."+this.selectId+".createView").on("resize"+j+"."+this.selectId+".createView",function(){D.$newElement.hasClass(V.SHOW)&&l(D.$menuInner[0].scrollTop)})},focusItem:function(e,t,i){if(e){t=t||this.selectpicker.main.data[this.activeIndex];var s=e.firstChild;s&&(s.setAttribute("aria-setsize",this.selectpicker.view.size),s.setAttribute("aria-posinset",t.posinset),!0!==i&&(this.focusedParent.setAttribute("aria-activedescendant",s.id),e.classList.add("active"),s.classList.add("active")))}},defocusItem:function(e){e&&(e.classList.remove("active"),e.firstChild&&e.firstChild.classList.remove("active"))},setPlaceholder:function(){var e=!1;if(this.options.title&&!this.multiple){this.selectpicker.view.titleOption||(this.selectpicker.view.titleOption=document.createElement("option")),e=!0;var t=this.$element[0],i=!1,s=!this.selectpicker.view.titleOption.parentNode;if(s)this.selectpicker.view.titleOption.className="bs-title-option",this.selectpicker.view.titleOption.value="",i=void 0===z(t.options[t.selectedIndex]).attr("selected")&&void 0===this.$element.data("selected");!s&&0===this.selectpicker.view.titleOption.index||t.insertBefore(this.selectpicker.view.titleOption,t.firstChild),i&&(t.selectedIndex=0)}return e},buildData:function(){var p=':not([hidden]):not([data-hidden="true"])',u=[],f=0,e=this.setPlaceholder()?1:0;this.options.hideDisabled&&(p+=":not(:disabled)");var t=this.$element[0].querySelectorAll("select > *"+p);function m(e){var t=u[u.length-1];t&&"divider"===t.type&&(t.optID||e.optID)||((e=e||{}).type="divider",u.push(e))}function v(e,t){if((t=t||{}).divider="true"===e.getAttribute("data-divider"),t.divider)m({optID:t.optID});else{var i=u.length,s=e.style.cssText,n=s?S(s):"",o=(e.className||"")+(t.optgroupClass||"");t.optID&&(o="opt "+o),t.optionClass=o.trim(),t.inlineStyle=n,t.text=e.textContent,t.content=e.getAttribute("data-content"),t.tokens=e.getAttribute("data-tokens"),t.subtext=e.getAttribute("data-subtext"),t.icon=e.getAttribute("data-icon"),e.liIndex=i,t.display=t.content||t.text,t.type="option",t.index=i,t.option=e,t.selected=!!e.selected,t.disabled=t.disabled||!!e.disabled,u.push(t)}}function i(e,t){var i=t[e],s=t[e-1],n=t[e+1],o=i.querySelectorAll("option"+p);if(o.length){var r,l,a={display:S(i.label),subtext:i.getAttribute("data-subtext"),icon:i.getAttribute("data-icon"),type:"optgroup-label",optgroupClass:" "+(i.className||"")};f++,s&&m({optID:f}),a.optID=f,u.push(a);for(var c=0,d=o.length;c<d;c++){var h=o[c];0===c&&(l=(r=u.length-1)+d),v(h,{headerIndex:r,lastIndex:l,optID:a.optID,optgroupClass:a.optgroupClass,disabled:i.disabled})}n&&m({optID:f})}}for(var s=t.length;e<s;e++){var n=t[e];"OPTGROUP"!==n.tagName?v(n,{}):i(e,t)}this.selectpicker.main.data=this.selectpicker.current.data=u},buildList:function(){var s=this,e=this.selectpicker.main.data,n=[],o=0;function t(e){var t,i=0;switch(e.type){case"divider":t=K.li(!1,V.DIVIDER,e.optID?e.optID+"div":void 0);break;case"option":(t=K.li(K.a(K.text.call(s,e),e.optionClass,e.inlineStyle),"",e.optID)).firstChild&&(t.firstChild.id=s.selectId+"-"+e.index);break;case"optgroup-label":t=K.li(K.label.call(s,e),"dropdown-header"+e.optgroupClass,e.optID)}n.push(t),e.display&&(i+=e.display.length),e.subtext&&(i+=e.subtext.length),e.icon&&(i+=1),o<i&&(o=i,s.selectpicker.view.widestOption=n[n.length-1])}!s.options.showTick&&!s.multiple||_.checkMark.parentNode||(_.checkMark.className=this.options.iconBase+" "+s.options.tickIcon+" check-mark",_.a.appendChild(_.checkMark));for(var i=e.length,r=0;r<i;r++){t(e[r])}this.selectpicker.main.elements=this.selectpicker.current.elements=n},findLis:function(){return this.$menuInner.find(".inner > li")},render:function(){var e,t=this,i=this.$element[0],s=this.setPlaceholder()&&0===i.selectedIndex,n=O(i,this.options.hideDisabled),o=n.length,r=this.$button[0],l=r.querySelector(".filter-option-inner-inner"),a=document.createTextNode(this.options.multipleSeparator),c=_.fragment.cloneNode(!1),d=!1;if(r.classList.toggle("bs-placeholder",t.multiple?!o:!T(i,n)),this.tabIndex(),"static"===this.options.selectedTextFormat)c=K.text.call(this,{text:this.options.title},!0);else if(!1===(this.multiple&&-1!==this.options.selectedTextFormat.indexOf("count")&&1<o&&(1<(e=this.options.selectedTextFormat.split(">")).length&&o>e[1]||1===e.length&&2<=o))){if(!s){for(var h=0;h<o&&h<50;h++){var p=n[h],u=this.selectpicker.main.data[p.liIndex],f={};this.multiple&&0<h&&c.appendChild(a.cloneNode(!1)),p.title?f.text=p.title:u&&(u.content&&t.options.showContent?(f.content=u.content.toString(),d=!0):(t.options.showIcon&&(f.icon=u.icon),t.options.showSubtext&&!t.multiple&&u.subtext&&(f.subtext=" "+u.subtext),f.text=p.textContent.trim())),c.appendChild(K.text.call(this,f,!0))}49<o&&c.appendChild(document.createTextNode("..."))}}else{var m=':not([hidden]):not([data-hidden="true"]):not([data-divider="true"])';this.options.hideDisabled&&(m+=":not(:disabled)");var v=this.$element[0].querySelectorAll("select > option"+m+", optgroup"+m+" option"+m).length,g="function"==typeof this.options.countSelectedText?this.options.countSelectedText(o,v):this.options.countSelectedText;c=K.text.call(this,{text:g.replace("{0}",o.toString()).replace("{1}",v.toString())},!0)}if(null==this.options.title&&(this.options.title=this.$element.attr("title")),c.childNodes.length||(c=K.text.call(this,{text:void 0!==this.options.title?this.options.title:this.options.noneSelectedText},!0)),r.title=c.textContent.replace(/<[^>]*>?/g,"").trim(),this.options.sanitize&&d&&P([c],t.options.whiteList,t.options.sanitizeFn),l.innerHTML="",l.appendChild(c),R.major<4&&this.$newElement[0].classList.contains("bs3-has-addon")){var b=r.querySelector(".filter-expand"),w=l.cloneNode(!0);w.className="filter-expand",b?r.replaceChild(w,b):r.appendChild(w)}this.$element.trigger("rendered"+j)},setStyle:function(e,t){var i,s=this.$button[0],n=this.$newElement[0],o=this.options.style.trim();this.$element.attr("class")&&this.$newElement.addClass(this.$element.attr("class").replace(/selectpicker|mobile-device|bs-select-hidden|validate\[.*\]/gi,"")),R.major<4&&(n.classList.add("bs3"),n.parentNode.classList.contains("input-group")&&(n.previousElementSibling||n.nextElementSibling)&&(n.previousElementSibling||n.nextElementSibling).classList.contains("input-group-addon")&&n.classList.add("bs3-has-addon")),i=e?e.trim():o,"add"==t?i&&s.classList.add.apply(s.classList,i.split(" ")):"remove"==t?i&&s.classList.remove.apply(s.classList,i.split(" ")):(o&&s.classList.remove.apply(s.classList,o.split(" ")),i&&s.classList.add.apply(s.classList,i.split(" ")))},liHeight:function(e){if(e||!1!==this.options.size&&!Object.keys(this.sizeInfo).length){var t=document.createElement("div"),i=document.createElement("div"),s=document.createElement("div"),n=document.createElement("ul"),o=document.createElement("li"),r=document.createElement("li"),l=document.createElement("li"),a=document.createElement("a"),c=document.createElement("span"),d=this.options.header&&0<this.$menu.find("."+V.POPOVERHEADER).length?this.$menu.find("."+V.POPOVERHEADER)[0].cloneNode(!0):null,h=this.options.liveSearch?document.createElement("div"):null,p=this.options.actionsBox&&this.multiple&&0<this.$menu.find(".bs-actionsbox").length?this.$menu.find(".bs-actionsbox")[0].cloneNode(!0):null,u=this.options.doneButton&&this.multiple&&0<this.$menu.find(".bs-donebutton").length?this.$menu.find(".bs-donebutton")[0].cloneNode(!0):null,f=this.$element.find("option")[0];if(this.sizeInfo.selectWidth=this.$newElement[0].offsetWidth,c.className="text",a.className="dropdown-item "+(f?f.className:""),t.className=this.$menu[0].parentNode.className+" "+V.SHOW,t.style.width=0,"auto"===this.options.width&&(i.style.minWidth=0),i.className=V.MENU+" "+V.SHOW,s.className="inner "+V.SHOW,n.className=V.MENU+" inner "+("4"===R.major?V.SHOW:""),o.className=V.DIVIDER,r.className="dropdown-header",c.appendChild(document.createTextNode("\u200b")),a.appendChild(c),l.appendChild(a),r.appendChild(c.cloneNode(!0)),this.selectpicker.view.widestOption&&n.appendChild(this.selectpicker.view.widestOption.cloneNode(!0)),n.appendChild(l),n.appendChild(o),n.appendChild(r),d&&i.appendChild(d),h){var m=document.createElement("input");h.className="bs-searchbox",m.className="form-control",h.appendChild(m),i.appendChild(h)}p&&i.appendChild(p),s.appendChild(n),i.appendChild(s),u&&i.appendChild(u),t.appendChild(i),document.body.appendChild(t);var v,g=l.offsetHeight,b=r?r.offsetHeight:0,w=d?d.offsetHeight:0,I=h?h.offsetHeight:0,x=p?p.offsetHeight:0,k=u?u.offsetHeight:0,y=z(o).outerHeight(!0),$=!!window.getComputedStyle&&window.getComputedStyle(i),S=i.offsetWidth,E=$?null:z(i),C={vert:L($?$.paddingTop:E.css("paddingTop"))+L($?$.paddingBottom:E.css("paddingBottom"))+L($?$.borderTopWidth:E.css("borderTopWidth"))+L($?$.borderBottomWidth:E.css("borderBottomWidth")),horiz:L($?$.paddingLeft:E.css("paddingLeft"))+L($?$.paddingRight:E.css("paddingRight"))+L($?$.borderLeftWidth:E.css("borderLeftWidth"))+L($?$.borderRightWidth:E.css("borderRightWidth"))},O={vert:C.vert+L($?$.marginTop:E.css("marginTop"))+L($?$.marginBottom:E.css("marginBottom"))+2,horiz:C.horiz+L($?$.marginLeft:E.css("marginLeft"))+L($?$.marginRight:E.css("marginRight"))+2};s.style.overflowY="scroll",v=i.offsetWidth-S,document.body.removeChild(t),this.sizeInfo.liHeight=g,this.sizeInfo.dropdownHeaderHeight=b,this.sizeInfo.headerHeight=w,this.sizeInfo.searchHeight=I,this.sizeInfo.actionsHeight=x,this.sizeInfo.doneButtonHeight=k,this.sizeInfo.dividerHeight=y,this.sizeInfo.menuPadding=C,this.sizeInfo.menuExtras=O,this.sizeInfo.menuWidth=S,this.sizeInfo.menuInnerInnerWidth=S-C.horiz,this.sizeInfo.totalMenuWidth=this.sizeInfo.menuWidth,this.sizeInfo.scrollBarWidth=v,this.sizeInfo.selectHeight=this.$newElement[0].offsetHeight,this.setPositionData()}},getSelectPosition:function(){var e,t=z(window),i=this.$newElement.offset(),s=z(this.options.container);this.options.container&&s.length&&!s.is("body")?((e=s.offset()).top+=parseInt(s.css("borderTopWidth")),e.left+=parseInt(s.css("borderLeftWidth"))):e={top:0,left:0};var n=this.options.windowPadding;this.sizeInfo.selectOffsetTop=i.top-e.top-t.scrollTop(),this.sizeInfo.selectOffsetBot=t.height()-this.sizeInfo.selectOffsetTop-this.sizeInfo.selectHeight-e.top-n[2],this.sizeInfo.selectOffsetLeft=i.left-e.left-t.scrollLeft(),this.sizeInfo.selectOffsetRight=t.width()-this.sizeInfo.selectOffsetLeft-this.sizeInfo.selectWidth-e.left-n[1],this.sizeInfo.selectOffsetTop-=n[0],this.sizeInfo.selectOffsetLeft-=n[3]},setMenuSize:function(e){this.getSelectPosition();var t,i,s,n,o,r,l,a,c=this.sizeInfo.selectWidth,d=this.sizeInfo.liHeight,h=this.sizeInfo.headerHeight,p=this.sizeInfo.searchHeight,u=this.sizeInfo.actionsHeight,f=this.sizeInfo.doneButtonHeight,m=this.sizeInfo.dividerHeight,v=this.sizeInfo.menuPadding,g=0;if(this.options.dropupAuto&&(l=d*this.selectpicker.current.elements.length+v.vert,a=this.sizeInfo.selectOffsetTop-this.sizeInfo.selectOffsetBot>this.sizeInfo.menuExtras.vert&&l+this.sizeInfo.menuExtras.vert+50>this.sizeInfo.selectOffsetBot,!0===this.selectpicker.isSearching&&(a=this.selectpicker.dropup),this.$newElement.toggleClass(V.DROPUP,a),this.selectpicker.dropup=a),"auto"===this.options.size)n=3<this.selectpicker.current.elements.length?3*this.sizeInfo.liHeight+this.sizeInfo.menuExtras.vert-2:0,i=this.sizeInfo.selectOffsetBot-this.sizeInfo.menuExtras.vert,s=n+h+p+u+f,r=Math.max(n-v.vert,0),this.$newElement.hasClass(V.DROPUP)&&(i=this.sizeInfo.selectOffsetTop-this.sizeInfo.menuExtras.vert),t=(o=i)-h-p-u-f-v.vert;else if(this.options.size&&"auto"!=this.options.size&&this.selectpicker.current.elements.length>this.options.size){for(var b=0;b<this.options.size;b++)"divider"===this.selectpicker.current.data[b].type&&g++;t=(i=d*this.options.size+g*m+v.vert)-v.vert,o=i+h+p+u+f,s=r=""}this.$menu.css({"max-height":o+"px",overflow:"hidden","min-height":s+"px"}),this.$menuInner.css({"max-height":t+"px","overflow-y":"auto","min-height":r+"px"}),this.sizeInfo.menuInnerHeight=Math.max(t,1),this.selectpicker.current.data.length&&this.selectpicker.current.data[this.selectpicker.current.data.length-1].position>this.sizeInfo.menuInnerHeight&&(this.sizeInfo.hasScrollBar=!0,this.sizeInfo.totalMenuWidth=this.sizeInfo.menuWidth+this.sizeInfo.scrollBarWidth),"auto"===this.options.dropdownAlignRight&&this.$menu.toggleClass(V.MENURIGHT,this.sizeInfo.selectOffsetLeft>this.sizeInfo.selectOffsetRight&&this.sizeInfo.selectOffsetRight<this.sizeInfo.totalMenuWidth-c),this.dropdown&&this.dropdown._popper&&this.dropdown._popper.update()},setSize:function(e){if(this.liHeight(e),this.options.header&&this.$menu.css("padding-top",0),!1!==this.options.size){var t=this,i=z(window);this.setMenuSize(),this.options.liveSearch&&this.$searchbox.off("input.setMenuSize propertychange.setMenuSize").on("input.setMenuSize propertychange.setMenuSize",function(){return t.setMenuSize()}),"auto"===this.options.size?i.off("resize"+j+"."+this.selectId+".setMenuSize scroll"+j+"."+this.selectId+".setMenuSize").on("resize"+j+"."+this.selectId+".setMenuSize scroll"+j+"."+this.selectId+".setMenuSize",function(){return t.setMenuSize()}):this.options.size&&"auto"!=this.options.size&&this.selectpicker.current.elements.length>this.options.size&&i.off("resize"+j+"."+this.selectId+".setMenuSize scroll"+j+"."+this.selectId+".setMenuSize")}this.createView(!1,!0,e)},setWidth:function(){var i=this;"auto"===this.options.width?requestAnimationFrame(function(){i.$menu.css("min-width","0"),i.$element.on("loaded"+j,function(){i.liHeight(),i.setMenuSize();var e=i.$newElement.clone().appendTo("body"),t=e.css("width","auto").children("button").outerWidth();e.remove(),i.sizeInfo.selectWidth=Math.max(i.sizeInfo.totalMenuWidth,t),i.$newElement.css("width",i.sizeInfo.selectWidth+"px")})}):"fit"===this.options.width?(this.$menu.css("min-width",""),this.$newElement.css("width","").addClass("fit-width")):this.options.width?(this.$menu.css("min-width",""),this.$newElement.css("width",this.options.width)):(this.$menu.css("min-width",""),this.$newElement.css("width","")),this.$newElement.hasClass("fit-width")&&"fit"!==this.options.width&&this.$newElement[0].classList.remove("fit-width")},selectPosition:function(){this.$bsContainer=z('<div class="bs-container" />');function e(e){var t={},i=r.options.display||!!z.fn.dropdown.Constructor.Default&&z.fn.dropdown.Constructor.Default.display;r.$bsContainer.addClass(e.attr("class").replace(/form-control|fit-width/gi,"")).toggleClass(V.DROPUP,e.hasClass(V.DROPUP)),s=e.offset(),l.is("body")?n={top:0,left:0}:((n=l.offset()).top+=parseInt(l.css("borderTopWidth"))-l.scrollTop(),n.left+=parseInt(l.css("borderLeftWidth"))-l.scrollLeft()),o=e.hasClass(V.DROPUP)?0:e[0].offsetHeight,(R.major<4||"static"===i)&&(t.top=s.top-n.top+o,t.left=s.left-n.left),t.width=e[0].offsetWidth,r.$bsContainer.css(t)}var s,n,o,r=this,l=z(this.options.container);this.$button.on("click.bs.dropdown.data-api",function(){r.isDisabled()||(e(r.$newElement),r.$bsContainer.appendTo(r.options.container).toggleClass(V.SHOW,!r.$button.hasClass(V.SHOW)).append(r.$menu))}),z(window).off("resize"+j+"."+this.selectId+" scroll"+j+"."+this.selectId).on("resize"+j+"."+this.selectId+" scroll"+j+"."+this.selectId,function(){r.$newElement.hasClass(V.SHOW)&&e(r.$newElement)}),this.$element.on("hide"+j,function(){r.$menu.data("height",r.$menu.height()),r.$bsContainer.detach()})},setOptionStatus:function(e){var t=this;if(t.noScroll=!1,t.selectpicker.view.visibleElements&&t.selectpicker.view.visibleElements.length)for(var i=0;i<t.selectpicker.view.visibleElements.length;i++){var s=t.selectpicker.current.data[i+t.selectpicker.view.position0],n=s.option;n&&(!0!==e&&t.setDisabled(s.index,s.disabled),t.setSelected(s.index,n.selected))}},setSelected:function(e,t){var i,s,n=this.selectpicker.main.elements[e],o=this.selectpicker.main.data[e],r=void 0!==this.activeIndex,l=this.activeIndex===e||t&&!this.multiple&&!r;o.selected=t,s=n.firstChild,t&&(this.selectedIndex=e),n.classList.toggle("selected",t),l?(this.focusItem(n,o),this.selectpicker.view.currentActive=n,this.activeIndex=e):this.defocusItem(n),s&&(s.classList.toggle("selected",t),t?s.setAttribute("aria-selected",!0):this.multiple?s.setAttribute("aria-selected",!1):s.removeAttribute("aria-selected")),l||r||!t||void 0===this.prevActiveIndex||(i=this.selectpicker.main.elements[this.prevActiveIndex],this.defocusItem(i))},setDisabled:function(e,t){var i,s=this.selectpicker.main.elements[e];this.selectpicker.main.data[e].disabled=t,i=s.firstChild,s.classList.toggle(V.DISABLED,t),i&&("4"===R.major&&i.classList.toggle(V.DISABLED,t),t?(i.setAttribute("aria-disabled",t),i.setAttribute("tabindex",-1)):(i.removeAttribute("aria-disabled"),i.setAttribute("tabindex",0)))},isDisabled:function(){return this.$element[0].disabled},checkDisabled:function(){this.isDisabled()?(this.$newElement[0].classList.add(V.DISABLED),this.$button.addClass(V.DISABLED).attr("tabindex",-1).attr("aria-disabled",!0)):(this.$button[0].classList.contains(V.DISABLED)&&(this.$newElement[0].classList.remove(V.DISABLED),this.$button.removeClass(V.DISABLED).attr("aria-disabled",!1)),-1!=this.$button.attr("tabindex")||this.$element.data("tabindex")||this.$button.removeAttr("tabindex"))},tabIndex:function(){this.$element.data("tabindex")!==this.$element.attr("tabindex")&&-98!==this.$element.attr("tabindex")&&"-98"!==this.$element.attr("tabindex")&&(this.$element.data("tabindex",this.$element.attr("tabindex")),this.$button.attr("tabindex",this.$element.data("tabindex"))),this.$element.attr("tabindex",-98)},clickListener:function(){var C=this,t=z(document);function e(){C.options.liveSearch?C.$searchbox.trigger("focus"):C.$menuInner.trigger("focus")}function i(){C.dropdown&&C.dropdown._popper&&C.dropdown._popper.state.isCreated?e():requestAnimationFrame(i)}t.data("spaceSelect",!1),this.$button.on("keyup",function(e){/(32)/.test(e.keyCode.toString(10))&&t.data("spaceSelect")&&(e.preventDefault(),t.data("spaceSelect",!1))}),this.$newElement.on("show.bs.dropdown",function(){3<R.major&&!C.dropdown&&(C.dropdown=C.$button.data("bs.dropdown"),C.dropdown._menu=C.$menu[0])}),this.$button.on("click.bs.dropdown.data-api",function(){C.$newElement.hasClass(V.SHOW)||C.setSize()}),this.$element.on("shown"+j,function(){C.$menuInner[0].scrollTop!==C.selectpicker.view.scrollTop&&(C.$menuInner[0].scrollTop=C.selectpicker.view.scrollTop),3<R.major?requestAnimationFrame(i):e()}),this.$menuInner.on("mouseenter","li a",function(e){var t=this.parentElement,i=C.isVirtual()?C.selectpicker.view.position0:0,s=Array.prototype.indexOf.call(t.parentElement.children,t),n=C.selectpicker.current.data[s+i];C.focusItem(t,n,!0)}),this.$menuInner.on("click","li a",function(e,t){var i=z(this),s=C.$element[0],n=C.isVirtual()?C.selectpicker.view.position0:0,o=C.selectpicker.current.data[i.parent().index()+n],r=o.index,l=T(s),a=s.selectedIndex,c=s.options[a],d=!0;if(C.multiple&&1!==C.options.maxOptions&&e.stopPropagation(),e.preventDefault(),!C.isDisabled()&&!i.parent().hasClass(V.DISABLED)){var h=o.option,p=z(h),u=h.selected,f=p.parent("optgroup"),m=f.find("option"),v=C.options.maxOptions,g=f.data("maxOptions")||!1;if(r===C.activeIndex&&(t=!0),t||(C.prevActiveIndex=C.activeIndex,C.activeIndex=void 0),C.multiple){if(h.selected=!u,C.setSelected(r,!u),i.trigger("blur"),!1!==v||!1!==g){var b=v<O(s).length,w=g<f.find("option:selected").length;if(v&&b||g&&w)if(v&&1==v)s.selectedIndex=-1,h.selected=!0,C.setOptionStatus(!0);else if(g&&1==g){for(var I=0;I<m.length;I++){var x=m[I];x.selected=!1,C.setSelected(x.liIndex,!1)}h.selected=!0,C.setSelected(r,!0)}else{var k="string"==typeof C.options.maxOptionsText?[C.options.maxOptionsText,C.options.maxOptionsText]:C.options.maxOptionsText,y="function"==typeof k?k(v,g):k,$=y[0].replace("{n}",v),S=y[1].replace("{n}",g),E=z('<div class="notify"></div>');y[2]&&($=$.replace("{var}",y[2][1<v?0:1]),S=S.replace("{var}",y[2][1<g?0:1])),h.selected=!1,C.$menu.append(E),v&&b&&(E.append(z("<div>"+$+"</div>")),d=!1,C.$element.trigger("maxReached"+j)),g&&w&&(E.append(z("<div>"+S+"</div>")),d=!1,C.$element.trigger("maxReachedGrp"+j)),setTimeout(function(){C.setSelected(r,!1)},10),E[0].classList.add("fadeOut"),setTimeout(function(){E.remove()},1050)}}}else c&&(c.selected=!1),h.selected=!0,C.setSelected(r,!0);!C.multiple||C.multiple&&1===C.options.maxOptions?C.$button.trigger("focus"):C.options.liveSearch&&C.$searchbox.trigger("focus"),d&&(!C.multiple&&a===s.selectedIndex||(A=[h.index,p.prop("selected"),l],C.$element.triggerNative("change")))}}),this.$menu.on("click","li."+V.DISABLED+" a, ."+V.POPOVERHEADER+", ."+V.POPOVERHEADER+" :not(.close)",function(e){e.currentTarget==this&&(e.preventDefault(),e.stopPropagation(),C.options.liveSearch&&!z(e.target).hasClass("close")?C.$searchbox.trigger("focus"):C.$button.trigger("focus"))}),this.$menuInner.on("click",".divider, .dropdown-header",function(e){e.preventDefault(),e.stopPropagation(),C.options.liveSearch?C.$searchbox.trigger("focus"):C.$button.trigger("focus")}),this.$menu.on("click","."+V.POPOVERHEADER+" .close",function(){C.$button.trigger("click")}),this.$searchbox.on("click",function(e){e.stopPropagation()}),this.$menu.on("click",".actions-btn",function(e){C.options.liveSearch?C.$searchbox.trigger("focus"):C.$button.trigger("focus"),e.preventDefault(),e.stopPropagation(),z(this).hasClass("bs-select-all")?C.selectAll():C.deselectAll()}),this.$element.on("change"+j,function(){C.render(),C.$element.trigger("changed"+j,A),A=null}).on("focus"+j,function(){C.options.mobile||C.$button.trigger("focus")})},liveSearchListener:function(){var u=this,f=document.createElement("li");this.$button.on("click.bs.dropdown.data-api",function(){u.$searchbox.val()&&u.$searchbox.val("")}),this.$searchbox.on("click.bs.dropdown.data-api focus.bs.dropdown.data-api touchend.bs.dropdown.data-api",function(e){e.stopPropagation()}),this.$searchbox.on("input propertychange",function(){var e=u.$searchbox.val();if(u.selectpicker.search.elements=[],u.selectpicker.search.data=[],e){var t=[],i=e.toUpperCase(),s={},n=[],o=u._searchStyle(),r=u.options.liveSearchNormalize;r&&(i=w(i));for(var l=0;l<u.selectpicker.main.data.length;l++){var a=u.selectpicker.main.data[l];s[l]||(s[l]=k(a,i,o,r)),s[l]&&void 0!==a.headerIndex&&-1===n.indexOf(a.headerIndex)&&(0<a.headerIndex&&(s[a.headerIndex-1]=!0,n.push(a.headerIndex-1)),s[a.headerIndex]=!0,n.push(a.headerIndex),s[a.lastIndex+1]=!0),s[l]&&"optgroup-label"!==a.type&&n.push(l)}l=0;for(var c=n.length;l<c;l++){var d=n[l],h=n[l-1],p=(a=u.selectpicker.main.data[d],u.selectpicker.main.data[h]);("divider"!==a.type||"divider"===a.type&&p&&"divider"!==p.type&&c-1!==l)&&(u.selectpicker.search.data.push(a),t.push(u.selectpicker.main.elements[d]))}u.activeIndex=void 0,u.noScroll=!0,u.$menuInner.scrollTop(0),u.selectpicker.search.elements=t,u.createView(!0),t.length||(f.className="no-results",f.innerHTML=u.options.noneResultsText.replace("{0}",'"'+S(e)+'"'),u.$menuInner[0].firstChild.appendChild(f))}else u.$menuInner.scrollTop(0),u.createView(!1)})},_searchStyle:function(){return this.options.liveSearchStyle||"contains"},val:function(e){var t=this.$element[0];if(void 0===e)return this.$element.val();var i=T(t);if(A=[null,null,i],this.$element.val(e).trigger("changed"+j,A),this.$newElement.hasClass(V.SHOW))if(this.multiple)this.setOptionStatus(!0);else{var s=(t.options[t.selectedIndex]||{}).liIndex;"number"==typeof s&&(this.setSelected(this.selectedIndex,!1),this.setSelected(s,!0))}return this.render(),A=null,this.$element},changeAll:function(e){if(this.multiple){void 0===e&&(e=!0);var t=this.$element[0],i=0,s=0,n=T(t);t.classList.add("bs-select-hidden");for(var o=0,r=this.selectpicker.current.data,l=r.length;o<l;o++){var a=r[o],c=a.option;c&&!a.disabled&&"divider"!==a.type&&(a.selected&&i++,!0===(c.selected=e)&&s++)}t.classList.remove("bs-select-hidden"),i!==s&&(this.setOptionStatus(),A=[null,null,n],this.$element.triggerNative("change"))}},selectAll:function(){return this.changeAll(!0)},deselectAll:function(){return this.changeAll(!1)},toggle:function(e){(e=e||window.event)&&e.stopPropagation(),this.$button.trigger("click.bs.dropdown.data-api")},keydown:function(e){var t,i,s,n,o,r=z(this),l=r.hasClass("dropdown-toggle"),a=(l?r.closest(".dropdown"):r.closest(F.MENU)).data("this"),c=a.findLis(),d=!1,h=e.which===W&&!l&&!a.options.selectOnTab,p=G.test(e.which)||h,u=a.$menuInner[0].scrollTop,f=!0===a.isVirtual()?a.selectpicker.view.position0:0;if(!(112<=e.which&&e.which<=123))if(!(i=a.$newElement.hasClass(V.SHOW))&&(p||48<=e.which&&e.which<=57||96<=e.which&&e.which<=105||65<=e.which&&e.which<=90)&&(a.$button.trigger("click.bs.dropdown.data-api"),a.options.liveSearch))a.$searchbox.trigger("focus");else{if(e.which===N&&i&&(e.preventDefault(),a.$button.trigger("click.bs.dropdown.data-api").trigger("focus")),p){if(!c.length)return;-1!==(t=(s=a.selectpicker.main.elements[a.activeIndex])?Array.prototype.indexOf.call(s.parentElement.children,s):-1)&&a.defocusItem(s),e.which===B?(-1!==t&&t--,t+f<0&&(t+=c.length),a.selectpicker.view.canHighlight[t+f]||-1===(t=a.selectpicker.view.canHighlight.slice(0,t+f).lastIndexOf(!0)-f)&&(t=c.length-1)):e.which!==M&&!h||(++t+f>=a.selectpicker.view.canHighlight.length&&(t=0),a.selectpicker.view.canHighlight[t+f]||(t=t+1+a.selectpicker.view.canHighlight.slice(t+f+1).indexOf(!0))),e.preventDefault();var m=f+t;e.which===B?0===f&&t===c.length-1?(a.$menuInner[0].scrollTop=a.$menuInner[0].scrollHeight,m=a.selectpicker.current.elements.length-1):d=(o=(n=a.selectpicker.current.data[m]).position-n.height)<u:e.which!==M&&!h||(0===t?m=a.$menuInner[0].scrollTop=0:d=u<(o=(n=a.selectpicker.current.data[m]).position-a.sizeInfo.menuInnerHeight)),s=a.selectpicker.current.elements[m],a.activeIndex=a.selectpicker.current.data[m].index,a.focusItem(s),a.selectpicker.view.currentActive=s,d&&(a.$menuInner[0].scrollTop=o),a.options.liveSearch?a.$searchbox.trigger("focus"):r.trigger("focus")}else if(!r.is("input")&&!q.test(e.which)||e.which===H&&a.selectpicker.keydown.keyHistory){var v,g,b=[];e.preventDefault(),a.selectpicker.keydown.keyHistory+=C[e.which],a.selectpicker.keydown.resetKeyHistory.cancel&&clearTimeout(a.selectpicker.keydown.resetKeyHistory.cancel),a.selectpicker.keydown.resetKeyHistory.cancel=a.selectpicker.keydown.resetKeyHistory.start(),g=a.selectpicker.keydown.keyHistory,/^(.)\1+$/.test(g)&&(g=g.charAt(0));for(var w=0;w<a.selectpicker.current.data.length;w++){var I=a.selectpicker.current.data[w];k(I,g,"startsWith",!0)&&a.selectpicker.view.canHighlight[w]&&b.push(I.index)}if(b.length){var x=0;c.removeClass("active").find("a").removeClass("active"),1===g.length&&(-1===(x=b.indexOf(a.activeIndex))||x===b.length-1?x=0:x++),v=b[x],d=0<u-(n=a.selectpicker.main.data[v]).position?(o=n.position-n.height,!0):(o=n.position-a.sizeInfo.menuInnerHeight,n.position>u+a.sizeInfo.menuInnerHeight),s=a.selectpicker.main.elements[v],a.activeIndex=b[x],a.focusItem(s),s&&s.firstChild.focus(),d&&(a.$menuInner[0].scrollTop=o),r.trigger("focus")}}i&&(e.which===H&&!a.selectpicker.keydown.keyHistory||e.which===D||e.which===W&&a.options.selectOnTab)&&(e.which!==H&&e.preventDefault(),a.options.liveSearch&&e.which===H||(a.$menuInner.find(".active a").trigger("click",!0),r.trigger("focus"),a.options.liveSearch||(e.preventDefault(),z(document).data("spaceSelect",!0))))}},mobile:function(){this.$element[0].classList.add("mobile-device")},refresh:function(){var e=z.extend({},this.options,this.$element.data());this.options=e,this.checkDisabled(),this.setStyle(),this.render(),this.buildData(),this.buildList(),this.setWidth(),this.setSize(!0),this.$element.trigger("refreshed"+j)},hide:function(){this.$newElement.hide()},show:function(){this.$newElement.show()},remove:function(){this.$newElement.remove(),this.$element.remove()},destroy:function(){this.$newElement.before(this.$element).remove(),this.$bsContainer?this.$bsContainer.remove():this.$menu.remove(),this.$element.off(j).removeData("selectpicker").removeClass("bs-select-hidden selectpicker"),z(window).off(j+"."+this.selectId)}};var J=z.fn.selectpicker;z.fn.selectpicker=Z,z.fn.selectpicker.Constructor=Y,z.fn.selectpicker.noConflict=function(){return z.fn.selectpicker=J,this};var Q=z.fn.dropdown.Constructor._dataApiKeydownHandler||z.fn.dropdown.Constructor.prototype.keydown;z(document).off("keydown.bs.dropdown.data-api").on("keydown.bs.dropdown.data-api",':not(.bootstrap-select) > [data-toggle="dropdown"]',Q).on("keydown.bs.dropdown.data-api",":not(.bootstrap-select) > .dropdown-menu",Q).on("keydown"+j,'.bootstrap-select [data-toggle="dropdown"], .bootstrap-select [role="listbox"], .bootstrap-select .bs-searchbox input',Y.prototype.keydown).on("focusin.modal",'.bootstrap-select [data-toggle="dropdown"], .bootstrap-select [role="listbox"], .bootstrap-select .bs-searchbox input',function(e){e.stopPropagation()}),z(window).on("load"+j+".data-api",function(){z(".selectpicker").each(function(){var e=z(this);Z.call(e,e.data())})})}(e)});
+//# sourceMappingURL=bootstrap-select.min.js.map
\ No newline at end of file
diff --git a/plexpy/graphs.py b/plexpy/graphs.py
index 49dfee57..58a199c0 100644
--- a/plexpy/graphs.py
+++ b/plexpy/graphs.py
@@ -51,11 +51,7 @@ class Graphs(object):
         time_range = helpers.cast_to_int(time_range) or 30
         timestamp = helpers.timestamp() - time_range * 24 * 60 * 60
 
-        user_cond = ''
-        if session.get_session_user_id() and user_id and user_id != str(session.get_session_user_id()):
-            user_cond = 'AND session_history.user_id = %s ' % session.get_session_user_id()
-        elif user_id and user_id.isdigit():
-            user_cond = 'AND session_history.user_id = %s ' % user_id
+        user_cond = self._make_user_cond(user_id)
 
         if grouping is None:
             grouping = plexpy.CONFIG.GROUP_HISTORY_TABLES
@@ -171,11 +167,7 @@ class Graphs(object):
         time_range = helpers.cast_to_int(time_range) or 30
         timestamp = helpers.timestamp() - time_range * 24 * 60 * 60
 
-        user_cond = ''
-        if session.get_session_user_id() and user_id and user_id != str(session.get_session_user_id()):
-            user_cond = "AND session_history.user_id = %s " % session.get_session_user_id()
-        elif user_id and user_id.isdigit():
-            user_cond = "AND session_history.user_id = %s " % user_id
+        user_cond = self._make_user_cond(user_id)
 
         if grouping is None:
             grouping = plexpy.CONFIG.GROUP_HISTORY_TABLES
@@ -308,11 +300,7 @@ class Graphs(object):
         time_range = helpers.cast_to_int(time_range) or 30
         timestamp = helpers.timestamp() - time_range * 24 * 60 * 60
 
-        user_cond = ''
-        if session.get_session_user_id() and user_id and user_id != str(session.get_session_user_id()):
-            user_cond = 'AND session_history.user_id = %s ' % session.get_session_user_id()
-        elif user_id and user_id.isdigit():
-            user_cond = 'AND session_history.user_id = %s ' % user_id
+        user_cond = self._make_user_cond(user_id)
 
         if grouping is None:
             grouping = plexpy.CONFIG.GROUP_HISTORY_TABLES
@@ -427,11 +415,7 @@ class Graphs(object):
         time_range = helpers.cast_to_int(time_range) or 12
         timestamp = arrow.get(helpers.timestamp()).shift(months=-time_range).floor('month').timestamp()
 
-        user_cond = ''
-        if session.get_session_user_id() and user_id and user_id != str(session.get_session_user_id()):
-            user_cond = 'AND session_history.user_id = %s ' % session.get_session_user_id()
-        elif user_id and user_id.isdigit():
-            user_cond = 'AND session_history.user_id = %s ' % user_id
+        user_cond = self._make_user_cond(user_id)
 
         if grouping is None:
             grouping = plexpy.CONFIG.GROUP_HISTORY_TABLES
@@ -554,11 +538,7 @@ class Graphs(object):
         time_range = helpers.cast_to_int(time_range) or 30
         timestamp = helpers.timestamp() - time_range * 24 * 60 * 60
 
-        user_cond = ''
-        if session.get_session_user_id() and user_id and user_id != str(session.get_session_user_id()):
-            user_cond = 'AND session_history.user_id = %s ' % session.get_session_user_id()
-        elif user_id and user_id.isdigit():
-            user_cond = 'AND session_history.user_id = %s ' % user_id
+        user_cond = self._make_user_cond(user_id)
 
         if grouping is None:
             grouping = plexpy.CONFIG.GROUP_HISTORY_TABLES
@@ -653,11 +633,7 @@ class Graphs(object):
         time_range = helpers.cast_to_int(time_range) or 30
         timestamp = helpers.timestamp() - time_range * 24 * 60 * 60
 
-        user_cond = ''
-        if session.get_session_user_id() and user_id and user_id != str(session.get_session_user_id()):
-            user_cond = 'AND session_history.user_id = %s ' % session.get_session_user_id()
-        elif user_id and user_id.isdigit():
-            user_cond = 'AND session_history.user_id = %s ' % user_id
+        user_cond = self._make_user_cond(user_id)
 
         if grouping is None:
             grouping = plexpy.CONFIG.GROUP_HISTORY_TABLES
@@ -763,11 +739,7 @@ class Graphs(object):
         time_range = helpers.cast_to_int(time_range) or 30
         timestamp = helpers.timestamp() - time_range * 24 * 60 * 60
 
-        user_cond = ''
-        if session.get_session_user_id() and user_id and user_id != str(session.get_session_user_id()):
-            user_cond = 'AND session_history.user_id = %s ' % session.get_session_user_id()
-        elif user_id and user_id.isdigit():
-            user_cond = 'AND session_history.user_id = %s ' % user_id
+        user_cond = self._make_user_cond(user_id)
 
         if grouping is None:
             grouping = plexpy.CONFIG.GROUP_HISTORY_TABLES
@@ -860,11 +832,7 @@ class Graphs(object):
         time_range = helpers.cast_to_int(time_range) or 30
         timestamp = helpers.timestamp() - time_range * 24 * 60 * 60
 
-        user_cond = ''
-        if session.get_session_user_id() and user_id and user_id != str(session.get_session_user_id()):
-            user_cond = 'AND session_history.user_id = %s ' % session.get_session_user_id()
-        elif user_id and user_id.isdigit():
-            user_cond = 'AND session_history.user_id = %s ' % user_id
+        user_cond = self._make_user_cond(user_id)
 
         if grouping is None:
             grouping = plexpy.CONFIG.GROUP_HISTORY_TABLES
@@ -941,11 +909,7 @@ class Graphs(object):
         time_range = helpers.cast_to_int(time_range) or 30
         timestamp = helpers.timestamp() - time_range * 24 * 60 * 60
 
-        user_cond = ''
-        if session.get_session_user_id() and user_id and user_id != str(session.get_session_user_id()):
-            user_cond = 'AND session_history.user_id = %s ' % session.get_session_user_id()
-        elif user_id and user_id.isdigit():
-            user_cond = 'AND session_history.user_id = %s ' % user_id
+        user_cond = self._make_user_cond(user_id)
 
         if grouping is None:
             grouping = plexpy.CONFIG.GROUP_HISTORY_TABLES
@@ -1048,11 +1012,7 @@ class Graphs(object):
         time_range = helpers.cast_to_int(time_range) or 30
         timestamp = helpers.timestamp() - time_range * 24 * 60 * 60
 
-        user_cond = ''
-        if session.get_session_user_id() and user_id and user_id != str(session.get_session_user_id()):
-            user_cond = 'AND session_history.user_id = %s ' % session.get_session_user_id()
-        elif user_id and user_id.isdigit():
-            user_cond = 'AND session_history.user_id = %s ' % user_id
+        user_cond = self._make_user_cond(user_id)
 
         if grouping is None:
             grouping = plexpy.CONFIG.GROUP_HISTORY_TABLES
@@ -1128,11 +1088,7 @@ class Graphs(object):
         time_range = helpers.cast_to_int(time_range) or 30
         timestamp = helpers.timestamp() - time_range * 24 * 60 * 60
 
-        user_cond = ''
-        if session.get_session_user_id() and user_id and user_id != str(session.get_session_user_id()):
-            user_cond = 'AND session_history.user_id = %s ' % session.get_session_user_id()
-        elif user_id and user_id.isdigit():
-            user_cond = 'AND session_history.user_id = %s ' % user_id
+        user_cond = self._make_user_cond(user_id)
 
         if grouping is None:
             grouping = plexpy.CONFIG.GROUP_HISTORY_TABLES
@@ -1212,3 +1168,16 @@ class Graphs(object):
                   'series': [series_1_output, series_2_output, series_3_output]}
 
         return output
+
+    def _make_user_cond(self, user_id):
+        """
+        Expects user_id to be a comma-separated list of ints.
+        """
+        user_cond = ''
+        if session.get_session_user_id() and user_id and user_id != str(session.get_session_user_id()):
+            user_cond = 'AND session_history.user_id = %s ' % session.get_session_user_id()
+        elif user_id:
+            user_ids = helpers.split_strip(user_id)
+            if all(id.isdigit() for id in user_ids):
+                user_cond = 'AND session_history.user_id IN (%s) ' % ','.join(user_ids)
+        return user_cond
diff --git a/plexpy/webserve.py b/plexpy/webserve.py
index 06a9a802..7549aefa 100644
--- a/plexpy/webserve.py
+++ b/plexpy/webserve.py
@@ -2258,7 +2258,7 @@ class WebInterface(object):
             Optional parameters:
                 time_range (str):       The number of days of data to return
                 y_axis (str):           "plays" or "duration"
-                user_id (str):          The user id to filter the data
+                user_id (str):          Comma separated list of user id to filter the data
                 grouping (int):         0 or 1
 
             Returns:
@@ -2302,7 +2302,7 @@ class WebInterface(object):
             Optional parameters:
                 time_range (str):       The number of days of data to return
                 y_axis (str):           "plays" or "duration"
-                user_id (str):          The user id to filter the data
+                user_id (str):          Comma separated list of user id to filter the data
                 grouping (int):         0 or 1
 
             Returns:
@@ -2346,7 +2346,7 @@ class WebInterface(object):
             Optional parameters:
                 time_range (str):       The number of days of data to return
                 y_axis (str):           "plays" or "duration"
-                user_id (str):          The user id to filter the data
+                user_id (str):          Comma separated list of user id to filter the data
                 grouping (int):         0 or 1
 
             Returns:
@@ -2390,7 +2390,7 @@ class WebInterface(object):
             Optional parameters:
                 time_range (str):       The number of months of data to return
                 y_axis (str):           "plays" or "duration"
-                user_id (str):          The user id to filter the data
+                user_id (str):          Comma separated list of user id to filter the data
                 grouping (int):         0 or 1
 
             Returns:
@@ -2434,7 +2434,7 @@ class WebInterface(object):
             Optional parameters:
                 time_range (str):       The number of days of data to return
                 y_axis (str):           "plays" or "duration"
-                user_id (str):          The user id to filter the data
+                user_id (str):          Comma separated list of user id to filter the data
                 grouping (int):         0 or 1
 
             Returns:
@@ -2478,7 +2478,7 @@ class WebInterface(object):
             Optional parameters:
                 time_range (str):       The number of days of data to return
                 y_axis (str):           "plays" or "duration"
-                user_id (str):          The user id to filter the data
+                user_id (str):          Comma separated list of user id to filter the data
                 grouping (int):         0 or 1
 
             Returns:
@@ -2522,7 +2522,7 @@ class WebInterface(object):
             Optional parameters:
                 time_range (str):       The number of days of data to return
                 y_axis (str):           "plays" or "duration"
-                user_id (str):          The user id to filter the data
+                user_id (str):          Comma separated list of user id to filter the data
                 grouping (int):         0 or 1
 
             Returns:
@@ -2565,7 +2565,7 @@ class WebInterface(object):
             Optional parameters:
                 time_range (str):       The number of days of data to return
                 y_axis (str):           "plays" or "duration"
-                user_id (str):          The user id to filter the data
+                user_id (str):          Comma separated list of user id to filter the data
                 grouping (int):         0 or 1
 
             Returns:
@@ -2608,7 +2608,7 @@ class WebInterface(object):
             Optional parameters:
                 time_range (str):       The number of days of data to return
                 y_axis (str):           "plays" or "duration"
-                user_id (str):          The user id to filter the data
+                user_id (str):          Comma separated list of user id to filter the data
                 grouping (int):         0 or 1
 
             Returns:
@@ -2651,7 +2651,7 @@ class WebInterface(object):
             Optional parameters:
                 time_range (str):       The number of days of data to return
                 y_axis (str):           "plays" or "duration"
-                user_id (str):          The user id to filter the data
+                user_id (str):          Comma separated list of user id to filter the data
                 grouping (int):         0 or 1
 
             Returns:
@@ -2694,7 +2694,7 @@ class WebInterface(object):
             Optional parameters:
                 time_range (str):       The number of days of data to return
                 y_axis (str):           "plays" or "duration"
-                user_id (str):          The user id to filter the data
+                user_id (str):          Comma separated list of user id to filter the data
                 grouping (int):         0 or 1
 
             Returns:

From d91e561a56a14728970b3f581a3329a40cff0abf Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 7 Jul 2023 17:47:38 -0700
Subject: [PATCH 405/743] Regroup history in separate thread and improve
 logging

---
 data/interfaces/default/settings.html |  4 ++--
 plexpy/activity_processor.py          | 12 +++++++++++-
 plexpy/webserve.py                    |  8 +++-----
 3 files changed, 16 insertions(+), 8 deletions(-)

diff --git a/data/interfaces/default/settings.html b/data/interfaces/default/settings.html
index 7cd614e0..c5d8fe37 100644
--- a/data/interfaces/default/settings.html
+++ b/data/interfaces/default/settings.html
@@ -2498,9 +2498,9 @@ $(document).ready(function() {
     });
 
     $("#regroup_history").click(function () {
-        var msg = 'Are you sure you want to regroup play history in the database?';
+        var msg = 'Are you sure you want to regroup play history in the database?<br /><br /><strong>This make take a long time for large databases.<br />Regrouping will continue in the background.</strong>';
         var url = 'regroup_history';
-        confirmAjaxCall(url, msg, null, 'Regrouping play history...');
+        confirmAjaxCall(url, msg);
     });
 
     $("#delete_temp_sessions").click(function () {
diff --git a/plexpy/activity_processor.py b/plexpy/activity_processor.py
index b1558a56..0437d2d5 100644
--- a/plexpy/activity_processor.py
+++ b/plexpy/activity_processor.py
@@ -719,8 +719,14 @@ class ActivityProcessor(object):
             "JOIN session_history_metadata ON session_history.id = session_history_metadata.id"
         )
         results = self.db.select(query)
+        count = len(results)
+        progress = 0
+
+        for i, session in enumerate(results, start=1):
+            if int(i / count * 10) > progress:
+                progress = int(i / count * 10)
+                logger.info("Tautulli ActivityProcessor :: Regrouping session history: %d%%", progress * 10)
 
-        for session in results:
             try:
                 self.group_history(session['id'], session)
             except Exception as e:
@@ -729,3 +735,7 @@ class ActivityProcessor(object):
 
         logger.info("Tautulli ActivityProcessor :: Regrouping session history complete.")
         return True
+
+
+def regroup_history():
+    ActivityProcessor().regroup_history()
diff --git a/plexpy/webserve.py b/plexpy/webserve.py
index 7549aefa..b98c9e7c 100644
--- a/plexpy/webserve.py
+++ b/plexpy/webserve.py
@@ -443,12 +443,10 @@ class WebInterface(object):
     def regroup_history(self, **kwargs):
         """ Regroup play history in the database."""
 
-        result = activity_processor.ActivityProcessor().regroup_history()
+        threading.Thread(target=activity_processor.regroup_history).start()
 
-        if result:
-            return {'result': 'success', 'message': 'Regrouped play history.'}
-        else:
-            return {'result': 'error', 'message': 'Regrouping play history failed.'}
+        return {'result': 'success',
+                'message': 'Regrouping play history started. Check the logs to monitor any problems.'}
 
     @cherrypy.expose
     @cherrypy.tools.json_out()

From 6010e406c817ecfb11d873824e0adcc22f5bcc80 Mon Sep 17 00:00:00 2001
From: David Pooley <dave@pooley-mail.co.uk>
Date: Sun, 9 Jul 2023 00:32:42 +0100
Subject: [PATCH 406/743] Fix simultaneous streams per IP not behaving as
 expected with IPv6 (#2096)

* Fix IPv6 comparisson for concurrent streams

* Update regex to allow numbers in config variables

* Remove additional logging for local testing

* Update plexpy/notification_handler.py

Co-authored-by: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>

---------

Co-authored-by: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
---
 plexpy/config.py               |  3 ++-
 plexpy/helpers.py              | 16 ++++++++++++++++
 plexpy/notification_handler.py |  9 ++++++++-
 3 files changed, 26 insertions(+), 2 deletions(-)

diff --git a/plexpy/config.py b/plexpy/config.py
index 7b583d8d..6f2926d9 100644
--- a/plexpy/config.py
+++ b/plexpy/config.py
@@ -177,6 +177,7 @@ _CONFIG_DEFINITIONS = {
     'NOTIFY_RECENTLY_ADDED_UPGRADE': (int, 'Monitoring', 0),
     'NOTIFY_REMOTE_ACCESS_THRESHOLD': (int, 'Monitoring', 60),
     'NOTIFY_CONCURRENT_BY_IP': (int, 'Monitoring', 0),
+    'NOTIFY_CONCURRENT_IPV6_CIDR': (str, 'Monitoring', '/64'),
     'NOTIFY_CONCURRENT_THRESHOLD': (int, 'Monitoring', 2),
     'NOTIFY_NEW_DEVICE_INITIAL_ONLY': (int, 'Monitoring', 1),
     'NOTIFY_SERVER_CONNECTION_THRESHOLD': (int, 'Monitoring', 60),
@@ -536,7 +537,7 @@ class Config(object):
         Returns something from the ini unless it is a real property
         of the configuration object or is not all caps.
         """
-        if not re.match(r'[A-Z_]+$', name):
+        if not re.match(r'[A-Z0-9_]+$', name):
             return super(Config, self).__getattr__(name)
         else:
             return self.check_setting(name)
diff --git a/plexpy/helpers.py b/plexpy/helpers.py
index 9cfb9c45..085dfc12 100644
--- a/plexpy/helpers.py
+++ b/plexpy/helpers.py
@@ -33,6 +33,7 @@ from functools import reduce, wraps
 import hashlib
 import imghdr
 from future.moves.itertools import islice, zip_longest
+from ipaddress import ip_address, ip_network, IPv4Address
 import ipwhois
 import ipwhois.exceptions
 import ipwhois.utils
@@ -1777,3 +1778,18 @@ def check_watched(media_type, view_offset, duration, marker_credits_first=None,
 
 def pms_name():
     return plexpy.CONFIG.PMS_NAME_OVERRIDE or plexpy.CONFIG.PMS_NAME
+
+
+def ip_type(ip: str) -> str:
+    try:
+        return "IPv4" if type(ip_address(ip)) is IPv4Address else "IPv6"
+    except ValueError:
+        return "Invalid"
+
+
+def get_ipv6_network_address(ip: str) -> str:
+    cidr = "/64"
+    cidr_pattern = re.compile(r'^/(1([0-1]\d|2[0-8]))$|^/(\d\d)$|^/[1-9]$')
+    if cidr_pattern.match(plexpy.CONFIG.NOTIFY_CONCURRENT_IPV6_CIDR):
+        cidr = plexpy.CONFIG.NOTIFY_CONCURRENT_IPV6_CIDR
+    return str(ip_network(ip+cidr, strict=False).network_address)
diff --git a/plexpy/notification_handler.py b/plexpy/notification_handler.py
index 7dd81627..8b4b8583 100644
--- a/plexpy/notification_handler.py
+++ b/plexpy/notification_handler.py
@@ -160,6 +160,7 @@ def add_notifier_each(notifier_id=None, notify_action=None, stream_data=None, ti
 
 def notify_conditions(notify_action=None, stream_data=None, timeline_data=None, **kwargs):
     logger.debug("Tautulli NotificationHandler :: Checking global notification conditions.")
+    evaluated = False
 
     # Activity notifications
     if stream_data:
@@ -187,7 +188,13 @@ def notify_conditions(notify_action=None, stream_data=None, timeline_data=None,
                 user_sessions = [s for s in result['sessions'] if s['user_id'] == stream_data['user_id']]
 
             if plexpy.CONFIG.NOTIFY_CONCURRENT_BY_IP:
-                evaluated = len(Counter(s['ip_address'] for s in user_sessions)) >= plexpy.CONFIG.NOTIFY_CONCURRENT_THRESHOLD
+                ip_addresses = set()
+                for s in user_sessions:
+                    if helpers.ip_type(s['ip_address']) == 'IPv6':
+                        ip_addresses.add(helpers.get_ipv6_network_address(s['ip_address']))
+                    elif helpers.ip_type(s['ip_address']) == 'IPv4':
+                        ip_addresses.add(s['ip_address'])
+                evaluated = len(ip_addresses) >= plexpy.CONFIG.NOTIFY_CONCURRENT_THRESHOLD
             else:
                 evaluated = len(user_sessions) >= plexpy.CONFIG.NOTIFY_CONCURRENT_THRESHOLD
 

From 571a6b6d2df91d209907800af3f1b5c7356e2577 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 10 Jul 2023 08:56:27 -0700
Subject: [PATCH 407/743] Cast view_offset to int for regrouping history

---
 plexpy/activity_processor.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/plexpy/activity_processor.py b/plexpy/activity_processor.py
index 0437d2d5..9115f332 100644
--- a/plexpy/activity_processor.py
+++ b/plexpy/activity_processor.py
@@ -519,12 +519,12 @@ class ActivityProcessor(object):
             if len(result) > 1:
                 new_session = {'id': result[0]['id'],
                                 'rating_key': result[0]['rating_key'],
-                                'view_offset': result[0]['view_offset'],
+                                'view_offset': helpers.cast_to_int(result[0]['view_offset']),
                                 'reference_id': result[0]['reference_id']}
 
                 prev_session = {'id': result[1]['id'],
                                 'rating_key': result[1]['rating_key'],
-                                'view_offset': result[1]['view_offset'],
+                                'view_offset': helpers.cast_to_int(result[1]['view_offset']),
                                 'reference_id': result[1]['reference_id']}
 
                 if metadata:

From b953b951fb46400f7d30a22cdc2791faa8d6e233 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 13 Jul 2023 15:50:39 -0700
Subject: [PATCH 408/743] v2.12.6

---
 CHANGELOG.md      | 17 +++++++++++++++++
 plexpy/version.py |  2 +-
 2 files changed, 18 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 24baf072..974e69ce 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,22 @@
 # Changelog
 
+## v2.12.5 (2023-07-13)
+
+* Activity:
+  * New: Added d3d11va to list of hardware decoders.
+* History:
+  * Fix: Incorrect grouping of play history.
+  * New: Added button in settings to regroup play history.
+* Notifications:
+  * Fix: Incorrect concurrent streams notifications by IP addresss for IPv6 addresses (#2096) (Thanks @pooley182)
+* UI:
+  * Fix: Occasional UI crashing on Python 3.11.
+  * New: Added multiselect user filters to History and Graphs pages. (#2090) (Thanks @zdimension)
+* API:
+  * New: Added regroup_history API command.
+  * Change: Updated graph API commands to accept a comma separated list of user IDs.
+
+
 ## v2.12.4 (2023-05-23)
 
 * History:
diff --git a/plexpy/version.py b/plexpy/version.py
index 119e0b07..116f4687 100644
--- a/plexpy/version.py
+++ b/plexpy/version.py
@@ -18,4 +18,4 @@
 from __future__ import unicode_literals
 
 PLEXPY_BRANCH = "master"
-PLEXPY_RELEASE_VERSION = "v2.12.4"
\ No newline at end of file
+PLEXPY_RELEASE_VERSION = "v2.12.5"
\ No newline at end of file

From 765804c93b8304629b19140f1ed58b7dbace1c4e Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 20 Jul 2023 14:19:05 -0700
Subject: [PATCH 409/743] Don't expose do_state_change

---
 plexpy/webserve.py | 2 --
 1 file changed, 2 deletions(-)

diff --git a/plexpy/webserve.py b/plexpy/webserve.py
index b98c9e7c..b643f84b 100644
--- a/plexpy/webserve.py
+++ b/plexpy/webserve.py
@@ -4302,8 +4302,6 @@ class WebInterface(object):
 
         return update
 
-    @cherrypy.expose
-    @requireAuth(member_of("admin"))
     def do_state_change(self, signal, title, timer, **kwargs):
         message = title
         quote = self.random_arnold_quotes()

From d701d18a813246eff84034205c6ced99f7c09c63 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 27 Jul 2023 20:04:03 -0700
Subject: [PATCH 410/743] Update workflows action version refs

---
 .github/workflows/publish-installers.yml | 8 ++++----
 .github/workflows/publish-snap.yml       | 2 +-
 .github/workflows/pull-requests.yml      | 1 -
 3 files changed, 5 insertions(+), 6 deletions(-)

diff --git a/.github/workflows/publish-installers.yml b/.github/workflows/publish-installers.yml
index 49d53233..0b6eec36 100644
--- a/.github/workflows/publish-installers.yml
+++ b/.github/workflows/publish-installers.yml
@@ -68,7 +68,7 @@ jobs:
           pyinstaller -y ./package/Tautulli-${{ matrix.os }}.spec
 
       - name: Create Windows Installer
-        uses: joncloud/makensis-action@v3.7
+        uses: joncloud/makensis-action@v4
         if: matrix.os == 'windows'
         with:
           script-file: ./package/Tautulli.nsi
@@ -100,10 +100,10 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Get Build Job Status
-        uses: technote-space/workflow-conclusion-action@v3.0
+        uses: technote-space/workflow-conclusion-action@v3
 
       - name: Checkout Code
-        uses: actions/checkout@v3.2.0
+        uses: actions/checkout@v3
 
       - name: Set Release Version
         id: get_version
@@ -168,7 +168,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Get Build Job Status
-        uses: technote-space/workflow-conclusion-action@v3.0
+        uses: technote-space/workflow-conclusion-action@v3
 
       - name: Combine Job Status
         id: status
diff --git a/.github/workflows/publish-snap.yml b/.github/workflows/publish-snap.yml
index 9df4d2fd..dd74c3a3 100644
--- a/.github/workflows/publish-snap.yml
+++ b/.github/workflows/publish-snap.yml
@@ -70,7 +70,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Get Build Job Status
-        uses: technote-space/workflow-conclusion-action@v3.0
+        uses: technote-space/workflow-conclusion-action@v3
 
       - name: Combine Job Status
         id: status
diff --git a/.github/workflows/pull-requests.yml b/.github/workflows/pull-requests.yml
index 58cb4ee4..1a24cf24 100644
--- a/.github/workflows/pull-requests.yml
+++ b/.github/workflows/pull-requests.yml
@@ -18,7 +18,6 @@ jobs:
         with:
           message: Pull requests must be made to the `nightly` branch. Thanks.
           repo-token: ${{ secrets.GITHUB_TOKEN }}
-          repo-token-user-login: 'github-actions[bot]'
 
       - name: Fail Workflow
         if: github.base_ref != 'nightly'

From b984a99d512b32795031fd6ed3816afe11d516db Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 27 Jul 2023 20:04:27 -0700
Subject: [PATCH 411/743] Update workflows action version refs

---
 .github/workflows/publish-docker.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/publish-docker.yml b/.github/workflows/publish-docker.yml
index 6480575f..6d91bbf6 100644
--- a/.github/workflows/publish-docker.yml
+++ b/.github/workflows/publish-docker.yml
@@ -95,7 +95,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Get Build Job Status
-        uses: technote-space/workflow-conclusion-action@v3.0
+        uses: technote-space/workflow-conclusion-action@v3
 
       - name: Combine Job Status
         id: status

From e2cb15ef49ed6df5493b35e95f51835829879446 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Wed, 2 Aug 2023 16:51:20 -0700
Subject: [PATCH 412/743] Add notification image option for iOS Tautulli Remote
 App

---
 plexpy/notifiers.py | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/plexpy/notifiers.py b/plexpy/notifiers.py
index a2fa6341..2611aaea 100644
--- a/plexpy/notifiers.py
+++ b/plexpy/notifiers.py
@@ -3967,6 +3967,14 @@ class TAUTULLIREMOTEAPP(Notifier):
                     2: 'Large image (Non-expandable text)'
                 }
             })
+        elif platform == 'ios':
+            config_option.append({
+                'label': 'Include Poster Image',
+                'value': self.config['notification_type'],
+                'name': 'remoteapp_notification_type',
+                'description': 'Include a poster with the notifications.',
+                'input_type': 'checkbox'
+            })
 
         return config_option
 

From 842e36485a6b4e718ad870cf0024c23bdc7d8d16 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 15 Aug 2023 08:42:01 -0700
Subject: [PATCH 413/743] Bump actions/stale from 7 to 8 (#2025)

Bumps [actions/stale](https://github.com/actions/stale) from 7 to 8.
- [Release notes](https://github.com/actions/stale/releases)
- [Changelog](https://github.com/actions/stale/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/stale/compare/v7...v8)

---
updated-dependencies:
- dependency-name: actions/stale
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 .github/workflows/issues-stale.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/issues-stale.yml b/.github/workflows/issues-stale.yml
index 0643cb0a..26b8aa5f 100644
--- a/.github/workflows/issues-stale.yml
+++ b/.github/workflows/issues-stale.yml
@@ -10,7 +10,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Stale
-        uses: actions/stale@v7
+        uses: actions/stale@v8
         with:
           stale-issue-message: >
             This issue is stale because it has been open for 30 days with no activity.
@@ -30,7 +30,7 @@ jobs:
           days-before-close: 5
 
       - name: Invalid Template
-        uses: actions/stale@v7
+        uses: actions/stale@v8
         with:
           stale-issue-message: >
             Invalid issues template.

From 31543d267f4f793689be599fa66a1ce17879bab6 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 23 Aug 2023 21:19:39 -0700
Subject: [PATCH 414/743] Bump pywin32 from 305 to 306 (#2028)

Bumps [pywin32](https://github.com/mhammond/pywin32) from 305 to 306.
- [Release notes](https://github.com/mhammond/pywin32/releases)
- [Changelog](https://github.com/mhammond/pywin32/blob/main/CHANGES.txt)
- [Commits](https://github.com/mhammond/pywin32/commits)

---
updated-dependencies:
- dependency-name: pywin32
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 package/requirements-package.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index e8ccd0b8..d3c6d57b 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -8,4 +8,4 @@ pycryptodomex==3.17
 pyobjc-core==9.0.1; platform_system == "Darwin"
 pyobjc-framework-Cocoa==9.0.1; platform_system == "Darwin"
 
-pywin32==305; platform_system == "Windows"
+pywin32==306; platform_system == "Windows"

From 6fa8bb376828cdb954ecf08eda804d70747e7502 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 23 Aug 2023 21:20:05 -0700
Subject: [PATCH 415/743] Bump pyopenssl from 23.0.0 to 23.2.0 (#2081)

Bumps [pyopenssl](https://github.com/pyca/pyopenssl) from 23.0.0 to 23.2.0.
- [Changelog](https://github.com/pyca/pyopenssl/blob/main/CHANGELOG.rst)
- [Commits](https://github.com/pyca/pyopenssl/compare/23.0.0...23.2.0)

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

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 package/requirements-package.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index d3c6d57b..f432c59b 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -2,7 +2,7 @@ apscheduler==3.10.1
 importlib-metadata==6.0.0
 importlib-resources==5.12.0
 pyinstaller==5.8.0
-pyopenssl==23.0.0
+pyopenssl==23.2.0
 pycryptodomex==3.17
 
 pyobjc-core==9.0.1; platform_system == "Darwin"

From b7c0b104e94b9ea77a6230192d67c22d0ab08325 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 23 Aug 2023 21:20:54 -0700
Subject: [PATCH 416/743] Bump pycryptodomex from 3.17 to 3.18.0 (#2076)

Bumps [pycryptodomex](https://github.com/Legrandin/pycryptodome) from 3.17 to 3.18.0.
- [Release notes](https://github.com/Legrandin/pycryptodome/releases)
- [Changelog](https://github.com/Legrandin/pycryptodome/blob/master/Changelog.rst)
- [Commits](https://github.com/Legrandin/pycryptodome/compare/v3.17.0...v3.18.0)

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

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

[skip ci]
---
 package/requirements-package.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index f432c59b..ee3cc800 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -3,7 +3,7 @@ importlib-metadata==6.0.0
 importlib-resources==5.12.0
 pyinstaller==5.8.0
 pyopenssl==23.2.0
-pycryptodomex==3.17
+pycryptodomex==3.18.0
 
 pyobjc-core==9.0.1; platform_system == "Darwin"
 pyobjc-framework-Cocoa==9.0.1; platform_system == "Darwin"

From a84b5b51ed23354cff8903b0dab038fa384b6a32 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 23 Aug 2023 21:21:16 -0700
Subject: [PATCH 417/743] Bump pyobjc-core from 9.0.1 to 9.2 (#2082)

Bumps [pyobjc-core](https://github.com/ronaldoussoren/pyobjc) from 9.0.1 to 9.2.
- [Release notes](https://github.com/ronaldoussoren/pyobjc/releases)
- [Changelog](https://github.com/ronaldoussoren/pyobjc/blob/master/docs/changelog.rst)
- [Commits](https://github.com/ronaldoussoren/pyobjc/compare/v9.0.1...v9.2)

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

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 package/requirements-package.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index ee3cc800..70cd4cb0 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -5,7 +5,7 @@ pyinstaller==5.8.0
 pyopenssl==23.2.0
 pycryptodomex==3.18.0
 
-pyobjc-core==9.0.1; platform_system == "Darwin"
+pyobjc-core==9.2; platform_system == "Darwin"
 pyobjc-framework-Cocoa==9.0.1; platform_system == "Darwin"
 
 pywin32==306; platform_system == "Windows"

From e11a4c50bafacd0dad8ef192a6b9533a033d883b Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 23 Aug 2023 21:21:55 -0700
Subject: [PATCH 418/743] Bump pyobjc-framework-cocoa from 9.0.1 to 9.2 (#2083)

Bumps [pyobjc-framework-cocoa](https://github.com/ronaldoussoren/pyobjc) from 9.0.1 to 9.2.
- [Release notes](https://github.com/ronaldoussoren/pyobjc/releases)
- [Changelog](https://github.com/ronaldoussoren/pyobjc/blob/master/docs/changelog.rst)
- [Commits](https://github.com/ronaldoussoren/pyobjc/compare/v9.0.1...v9.2)

---
updated-dependencies:
- dependency-name: pyobjc-framework-cocoa
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

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

[skip ci]
---
 package/requirements-package.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index 70cd4cb0..064d2246 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -6,6 +6,6 @@ pyopenssl==23.2.0
 pycryptodomex==3.18.0
 
 pyobjc-core==9.2; platform_system == "Darwin"
-pyobjc-framework-Cocoa==9.0.1; platform_system == "Darwin"
+pyobjc-framework-Cocoa==9.2; platform_system == "Darwin"
 
 pywin32==306; platform_system == "Windows"

From f80cd739825051224a48ff4288cc9b148d32b7cd Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 23 Aug 2023 21:22:24 -0700
Subject: [PATCH 419/743] Bump importlib-metadata from 6.0.0 to 6.8.0 (#2112)

Bumps [importlib-metadata](https://github.com/python/importlib_metadata) from 6.0.0 to 6.8.0.
- [Release notes](https://github.com/python/importlib_metadata/releases)
- [Changelog](https://github.com/python/importlib_metadata/blob/main/NEWS.rst)
- [Commits](https://github.com/python/importlib_metadata/compare/v6.0.0...v6.8.0)

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

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 package/requirements-package.txt | 2 +-
 requirements.txt                 | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index 064d2246..075aa916 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -1,5 +1,5 @@
 apscheduler==3.10.1
-importlib-metadata==6.0.0
+importlib-metadata==6.8.0
 importlib-resources==5.12.0
 pyinstaller==5.8.0
 pyopenssl==23.2.0
diff --git a/requirements.txt b/requirements.txt
index 49c32ff6..ee495cb7 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -19,7 +19,7 @@ gntp==1.0.3
 html5lib==1.1
 httpagentparser==1.9.5
 idna==3.4
-importlib-metadata==6.0.0
+importlib-metadata==6.8.0
 importlib-resources==5.12.0
 git+https://github.com/Tautulli/ipwhois.git@master#egg=ipwhois
 IPy==1.01

From a21fffd227617d17f3c184965797c0a864df433a Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 23 Aug 2023 21:23:35 -0700
Subject: [PATCH 420/743] Bump pyinstaller from 5.8.0 to 5.13.0 (#2114)

Bumps [pyinstaller](https://github.com/pyinstaller/pyinstaller) from 5.8.0 to 5.13.0.
- [Release notes](https://github.com/pyinstaller/pyinstaller/releases)
- [Changelog](https://github.com/pyinstaller/pyinstaller/blob/develop/doc/CHANGES.rst)
- [Commits](https://github.com/pyinstaller/pyinstaller/compare/v5.8.0...v5.13.0)

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

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 package/requirements-package.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index 075aa916..5847d597 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -1,7 +1,7 @@
 apscheduler==3.10.1
 importlib-metadata==6.8.0
 importlib-resources==5.12.0
-pyinstaller==5.8.0
+pyinstaller==5.13.0
 pyopenssl==23.2.0
 pycryptodomex==3.18.0
 

From 835ea34bea88fa9f2fb31d26e210b75e42952b80 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 23 Aug 2023 21:38:17 -0700
Subject: [PATCH 421/743] Bump pytz from 2022.7.1 to 2023.3 (#2031)

* Bump pytz from 2022.7.1 to 2023.3

Bumps [pytz](https://github.com/stub42/pytz) from 2022.7.1 to 2023.3.
- [Release notes](https://github.com/stub42/pytz/releases)
- [Commits](https://github.com/stub42/pytz/compare/release_2022.7.1...release_2023.3)

---
updated-dependencies:
- dependency-name: pytz
  dependency-type: direct:production
  update-type: version-update:semver-major
...

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

* Update pytz==2023.3

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/pytz/__init__.py                  |   5 +-
 lib/pytz/zoneinfo/Africa/Cairo        | Bin 1955 -> 2399 bytes
 lib/pytz/zoneinfo/Africa/Casablanca   | Bin 2429 -> 2429 bytes
 lib/pytz/zoneinfo/Africa/El_Aaiun     | Bin 2295 -> 2295 bytes
 lib/pytz/zoneinfo/America/Godthab     | Bin 1448 -> 1903 bytes
 lib/pytz/zoneinfo/America/Nuuk        | Bin 1448 -> 1903 bytes
 lib/pytz/zoneinfo/America/Yellowknife | Bin 2136 -> 2332 bytes
 lib/pytz/zoneinfo/Asia/Gaza           | Bin 2422 -> 3808 bytes
 lib/pytz/zoneinfo/Asia/Hebron         | Bin 2450 -> 3836 bytes
 lib/pytz/zoneinfo/Egypt               | Bin 1955 -> 2399 bytes
 lib/pytz/zoneinfo/Europe/Kirov        | Bin 1139 -> 1185 bytes
 lib/pytz/zoneinfo/Europe/Volgograd    | Bin 1151 -> 1193 bytes
 lib/pytz/zoneinfo/iso3166.tab         |   2 +-
 lib/pytz/zoneinfo/leapseconds         |   8 +-
 lib/pytz/zoneinfo/tzdata.zi           | 130 ++++++++++++++++++++------
 lib/pytz/zoneinfo/zone.tab            |  29 +++---
 lib/pytz/zoneinfo/zone1970.tab        |  58 ++++++------
 requirements.txt                      |   2 +-
 18 files changed, 156 insertions(+), 78 deletions(-)

diff --git a/lib/pytz/__init__.py b/lib/pytz/__init__.py
index 11d2e2ca..98b66553 100644
--- a/lib/pytz/__init__.py
+++ b/lib/pytz/__init__.py
@@ -22,8 +22,8 @@ from pytz.tzfile import build_tzinfo
 
 
 # The IANA (nee Olson) database is updated several times a year.
-OLSON_VERSION = '2022g'
-VERSION = '2022.7.1'  # pip compatible version number.
+OLSON_VERSION = '2023c'
+VERSION = '2023.3'  # pip compatible version number.
 __version__ = VERSION
 
 OLSEN_VERSION = OLSON_VERSION  # Old releases had this misspelling
@@ -1311,7 +1311,6 @@ common_timezones = \
  'America/Whitehorse',
  'America/Winnipeg',
  'America/Yakutat',
- 'America/Yellowknife',
  'Antarctica/Casey',
  'Antarctica/Davis',
  'Antarctica/DumontDUrville',
diff --git a/lib/pytz/zoneinfo/Africa/Cairo b/lib/pytz/zoneinfo/Africa/Cairo
index d3f819623fc9ef90d327380fad15341ec1a0e202..dd538c65db6ed0a0e47feb7b6001640516958e19 100644
GIT binary patch
delta 474
zcmZ9|ze@sP9LMqQ5()`|)}#g_C`?V1NTP<gMHC)T$hK$bmt{XSwVyZi4+Li|;pEU<
zx-~^(%Tta)9<<d^L!(9awk5h7UeEY>f2+OCzEiJOxf*im=0fa4E=C(-Y4lMpd*9WH
zyDl@G4=VF|E>~Y_YOQf?XYbC`daZ14REuiUD%e{m^J+Vnws*1xkxNGHd^|07r{-kA
z7ZpX%q%8G#M5)y;_ujt6{?nH{xVOdOO;aA#Tk81YR+{B!rEBfqn$Tm`jNWY}x`v(i
zfOV<IwMz9<cbOf|$2w#ovJzQ}tVI^Lbyg$Gk@ZLcQh}5pHAoRsg-)3%c#wxABAG}k
zl8Yp_b+VCkBp*2eat7oS$T{%ONq!HbS=0LLzsrmax(y>W7BY-v%9jZHBmPJr=u3<T
LomV&z3cG&*+R&F`

delta 40
qcmcaFw3vT_GGqNl6&9w+3z+IBi*ssDPGbg&Ebd}vfr{ueasdDbN(;6C

diff --git a/lib/pytz/zoneinfo/Africa/Casablanca b/lib/pytz/zoneinfo/Africa/Casablanca
index 17e0d1b89f093e1e4452a8921ffff9a91287eb4c..d39016b89d3c945030ce95f721ebb592c8105064 100644
GIT binary patch
delta 105
zcmew>^jBzuE+ezcM1{!)jJC}8WEX5MVEn`c7D#2O1qn=k3Z%<dDNIgftz{N81M-3N
us>47&TP?GTKadZk@7@9O*@5aZfP8je=4qA+lTA5vnFYQoY)<8nU<3g6DJ6&i

delta 105
zcmew>^jBzuE+ez==>?Mw7;TxKM<{GAVEn`c7D#2O1qn=k3ZxsJESQ|iTFWd|2;>9l
u&3}P>wpwQ2E+8LBKNkb?*@5a71NrQ}%=3#EOg81vWtP%kusM}Of)N0ak|(nO

diff --git a/lib/pytz/zoneinfo/Africa/El_Aaiun b/lib/pytz/zoneinfo/Africa/El_Aaiun
index 64f1b7694418a8c284febe195659c4dd53359b1a..066fbed008cf662455eeca2c012ab8cb5bf1731a 100644
GIT binary patch
delta 105
zcmew^_+4-VBO|lRM1{#LjJC}8WEX69VVubX7I?s13lf-|z*5UxzDi;810XGE2IRBW
vGOs!e<O69Je;}W&mig`-ARkDVX8`%^zRc4s6((<B*JT#?s<8P1yEr2Nvn(ZK

delta 105
zcmew^_+4-VBO|l#=>?Nn7;TxKM<{G|VVubX7I?s13lf-|z*5WH@MOW{2S8e?5Xfh(
uW#0T3$OqECT|hn?P@Nc%52PCw1NrQ}%=3#EOy0n*%Pgh8VDkfZaYg`5l_!q?

diff --git a/lib/pytz/zoneinfo/America/Godthab b/lib/pytz/zoneinfo/America/Godthab
index 883dfa055532c8319a833d80c82707b3ca5d4d5a..adb7934aadf5f45928ce67e82efa92ca92391703 100644
GIT binary patch
delta 653
zcmb8sJ4nMo9LMooeNv^IgE(m?x3o<fy0zW9NDE3c>EdD^)>o@7jjwFtB!9>t9o(dJ
zDvCI{h=@3etAmR!PFg2%koy0nZX(oNF5k-yf%~K}^yX8|*?h)Oeq95+gNdum6Ki>@
z&I@}X)}+kfIc3L*vM+~}`zlfX)}qBnlM0PFTDmF9<^33~)YEb`=cl#3h%C-TWhpZz
z*Yydxk@%G55k*!)qf}`<$*S*zs`uB@dVQeHle*lxyP)mb740;SXxBO>`@kmA>*@I!
zPEAbt`K7P_@8LX)$?10cy(NZ|DN_k(2G1~0olhYI?oR%5__L(v(qr=n6bPVDKq29l
zHBgA4P(dMsLI;Hq3MCX$D6~+Bp-@91hq7M5U4Rf9U_?RbmN`+7x@A@rv?zE{5Tjs5
qL5+eN?T|Yp(%ncWx{>xq`47ay{M6%W$_Pe+S}35aDP41yn)e%>`jLMC

delta 176
zcmaFQw}M+IBq}q_hyeqz0YyL<1R{VK#OB$klfXE6B3t-mR(4evAKwrLT?1nv25Dzx
c1QKA96azQEWIDhEGf@GTiCi{7JM4_O00VIpA^-pY

diff --git a/lib/pytz/zoneinfo/America/Nuuk b/lib/pytz/zoneinfo/America/Nuuk
index 883dfa055532c8319a833d80c82707b3ca5d4d5a..adb7934aadf5f45928ce67e82efa92ca92391703 100644
GIT binary patch
delta 653
zcmb8sJ4nMo9LMooeNv^IgE(m?x3o<fy0zW9NDE3c>EdD^)>o@7jjwFtB!9>t9o(dJ
zDvCI{h=@3etAmR!PFg2%koy0nZX(oNF5k-yf%~K}^yX8|*?h)Oeq95+gNdum6Ki>@
z&I@}X)}+kfIc3L*vM+~}`zlfX)}qBnlM0PFTDmF9<^33~)YEb`=cl#3h%C-TWhpZz
z*Yydxk@%G55k*!)qf}`<$*S*zs`uB@dVQeHle*lxyP)mb740;SXxBO>`@kmA>*@I!
zPEAbt`K7P_@8LX)$?10cy(NZ|DN_k(2G1~0olhYI?oR%5__L(v(qr=n6bPVDKq29l
zHBgA4P(dMsLI;Hq3MCX$D6~+Bp-@91hq7M5U4Rf9U_?RbmN`+7x@A@rv?zE{5Tjs5
qL5+eN?T|Yp(%ncWx{>xq`47ay{M6%W$_Pe+S}35aDP41yn)e%>`jLMC

delta 176
zcmaFQw}M+IBq}q_hyeqz0YyL<1R{VK#OB$klfXE6B3t-mR(4evAKwrLT?1nv25Dzx
c1QKA96azQEWIDhEGf@GTiCi{7JM4_O00VIpA^-pY

diff --git a/lib/pytz/zoneinfo/America/Yellowknife b/lib/pytz/zoneinfo/America/Yellowknife
index efc9ab037fea7aa699c70b59d011150043c51cd9..cd78a6f8be1dd55ac5afd25bbae39bd5706e42d1 100644
GIT binary patch
delta 680
zcmca1Fh^*Da=<hO1_o9j7U{Tm?!mkr>nF_L&EBwJ#>5E=F10o+>UuF@aSI#6lB`n`
zmYN=JSQh+TV7chhh84yq1y=k!#BjQkXTl}rF9nwpB^a)TJ{Gv9aA%{nAX7aPBNAk0
zLE<1w(2O07!@~dnr!HV%`2T<P0!Ehq|L0C%-~h9Ez@&hWZwQ003lIkbaX1hMgaE^Z
zfq@ZBOi-?e2i1Qd00kF_1_c?21_c|41_d3M1_mF91_dFA1_dLC1_dRE1_dXG1_ddI
y1_djK1_dpc1_m#P1_d#QzN9Sqr2xzThBb%=g*S)>hWX}bW<{3a80eE7I3xgGqsjdM

delta 503
zcmbOubVFc*vP1_10|P4%i|o^qU^v~$GvSi*mx4=)5*v#Jnd+GtnV4Ay4!Xjv209Q3
z{{LUSfRP1Ea{T{4cLD<sm@S}dV8GxT9>U-o0K~yS>=FW0%?Q#0Bqk_pz&-gN2tXbM
y(IC%)Xpo1&bfUy&K^8@pf%bJQRea3_3<z^zK<M}y>lx`8==d5M>KW=8Z~*|6j!`oJ

diff --git a/lib/pytz/zoneinfo/Asia/Gaza b/lib/pytz/zoneinfo/Asia/Gaza
index 22c47593d4698743bc60ad98e60e45e3c48da7b1..c9b2ff90823a5809d877fb68c10494a38ab183b1 100644
GIT binary patch
delta 1402
zcmYMycT5vu7zXf<R)rD=Dh`Mew8p(7!6-OmTqG(ns6=rjls|}C^dHpdok9^o86Kky
z3tCVFaj-=|C_+(01d7E%A~;Z@(bL2kjP`v#6R&~Z?|q*4E2Q^rOz-5|BNSu(f>^N6
zDp}*!%t9tjl|$qsqU5RA<!t<_Jr%x=3CA;~K&L@TP)=1iEG#xETa;@13SG2D@3cx6
zt>c}JkQ_?|`w?V1hA#V2$i<yA;L{sa@R_A5IKtx&`VoGwxdU9_$O-S^$PXT{P8}=K
zK<D)Zj&g8>qf8Al&7<TWuyA&q1%<P{0~kc79fYIJ+4dS^(O=8pbG6MPIYwiHV+`xL
zJN0mEb|HM;_q0sC^Pwf&H6`!`F&>U{orQkfn%z_rSezjRh4_78D8%=rppf9EgcDAM
zBTw8IM++>m!k4>Wi~M3xAT057nWW3-uAYc~(h46qS>+EW@AlWyO>&IR{##%yWyUTH
zQU;cwkh=IM7E<@m6=|S%T#j7-a6Ixfra_+OZQ*`98F_lqVvz>v){$_=(ACH@8vnqV
z7hREO=A7W}ekaoBvrAX|FffFDL&0!@KO=^s1RRhRRgXMd_zhn^{6eOiD*-toy&JdG
z!8y}L!?_ELaPF_W6tioibnrD>2AuaP1ioH*5}(iVyCSue6r}G(;YNi9E<DcvgPZyd
z@U1{K^4sCF;X7+riZm$NIUFulPk~FkKf<L-{uP!@ah9o9_VNw#3ibi6Fqs7m?pl+u
zP+7pA>U%erqfiywNPDb0@)h!$&^-9Q|5mtma|~QJ^E>)=J7$YCF#X9wUO%rL`GXez
z2Q~~jhP=^OjDBOA(2s#x<&6ci#Sd-@^F*O3k3V!x18&G4mdr=~Xnhm>Nburr_d>rp
z$pwDwaTtE=cZIuX0^D-+3*7R)2Yw=`H!-@NB=U!@b<Zfc)x^J&R=FI08rF@4HlNRM
zTiP6MbC5`b_HEU0$D|JA9U48iVHj*#lm%M`OW{u6Ra&|cIzx|Q@XWmmgJ(Udu+_N`
zwytp(X<+?jfV--WA@AzjF4N8Pi6;2DO+;?XO%`cjD<9<UUx2*3@_<(9p!ok9qNJB}
V$SFeVRV@4WGhK3521@}d&%dG5crX9}

delta 131
zcmaDL`%P#AFO#sGWkafs!-q8XFotv)r4Q-PEf^*%Fhz2&)&Ede;mT0oEBIluHt)2_
z(R`_s>zS397^ZDr%zTzv8K{o|2tay4G)O-PfXo2XAaf?OZxsfb1LA|s0s$oRS^=Ow
BCfNW0

diff --git a/lib/pytz/zoneinfo/Asia/Hebron b/lib/pytz/zoneinfo/Asia/Hebron
index 0ee464803029ae4885814acae9e3291771401e62..64194fd85c676a5407878a197f6f9a011f2ff067 100644
GIT binary patch
delta 1395
zcmX}sc}SCS7zgm5n<bMDL(P<uY=Pa9BnE0H(Ir$8Wny+f^ACw;{bNPGZ{^Iiyyh{F
zrg@}ktGtiYa;4MEOr6bUQFd5T)LYPrQG33>=pFjLpXd91-YI)oy7R=Go31kF;0Sgo
zaE+vL?_rU%=Sh*$QBk`<w#Tvft2#Dj0~1c<*Cfg2+R5yEYYg&da;2?L2kp?A_UNEp
zoN3?SP$$^-$#f4oZ1+JfhI+%NH!0vVD;4lr&nooK2EXRs<pjsMy@%sIc)}WGl1KxM
z-xoOE&H;`$c1Sdjmwv#)Iaf0Z=U$9skdSj2PB0bPYK$d(t%uLw=@H3^Dl43*-^e|r
zgOdsk@P(k$67?=b)pEDh!WYF9IN4<(`pN6UsV1;weHIES`=e1v8O=f=)m;v!#>OB|
z+nh`bEUht!drXZyJt7R&^7}Harh>b57Wx^h0^v+W2%H%nqNa<?M2+pYz*v^|9t^U^
zSD=vX`x6V<2bPF5&^ZJk*LBZCp2JkgbNtQRZ|5M-t@agZkZYL+=S^CRJg@T)oS*K3
zJip{5_sBbu-k)8%GKzsd`Wp)Rll&RcSEu3z1@U*07Ye`O%SWC|bWyacM5J@^wsyE=
z{tUR(rx-5%)kHBXo34S&ta)(xr%3o}^C`SPs~C<`Q&O3`4~1)uD%fy>{|DD~o8TK^
zO5`_V7Qt2PSBo^L4xIwmD81lX|BrB;oPUJ%UXBv=>R-M=-pD?{jYgAzL6ao|3(b}M
zslIhR0EL#MPTFIwaj%fKMU}(1L$<?rwkE>u3%;Y@zI%~K1LL0p<ad`2Aivkk|G*CW
z<H$RUYtZlP7sfC!Dg3cuG6%z5(Q{GgD(4Sf*SI_K?%HL@?{Dma?+bq11AgfDWH`YO
zJdeN+f{VDT-QeD1U*O*NPvM7xatov5VH$tv`u0wT`;7b}>604ZN6{l#=nwo1_vb9;
zHbsau7}(JY56&J$KB&@h>nFqJ<pr>Lq7EJkTBD{5VJPYt29G^jFnIhl8@4zaV9PoW
zkp`AudU&|yIP&4qof2I<nPr5ZSViR4(oB&C)`ki0F(2e3%?H(T+t=g&m%W@`+5(wI
PE6G;;`|;IIRcQVK8CrGB

delta 122
zcmew(J4twhD3h?9Wkafs!-q8XFotv)r4Q-PEf^+iFhz2$)&Ede;mT0oE4aCvNr91x
zVaDdQ%y*fUf$AB60Hg;*gY<y_NH3TM>0isfRS2jb#0QxH0zh*ncQgH)e1}f~0Lm;Q
AHvj+t

diff --git a/lib/pytz/zoneinfo/Egypt b/lib/pytz/zoneinfo/Egypt
index d3f819623fc9ef90d327380fad15341ec1a0e202..dd538c65db6ed0a0e47feb7b6001640516958e19 100644
GIT binary patch
delta 474
zcmZ9|ze@sP9LMqQ5()`|)}#g_C`?V1NTP<gMHC)T$hK$bmt{XSwVyZi4+Li|;pEU<
zx-~^(%Tta)9<<d^L!(9awk5h7UeEY>f2+OCzEiJOxf*im=0fa4E=C(-Y4lMpd*9WH
zyDl@G4=VF|E>~Y_YOQf?XYbC`daZ14REuiUD%e{m^J+Vnws*1xkxNGHd^|07r{-kA
z7ZpX%q%8G#M5)y;_ujt6{?nH{xVOdOO;aA#Tk81YR+{B!rEBfqn$Tm`jNWY}x`v(i
zfOV<IwMz9<cbOf|$2w#ovJzQ}tVI^Lbyg$Gk@ZLcQh}5pHAoRsg-)3%c#wxABAG}k
zl8Yp_b+VCkBp*2eat7oS$T{%ONq!HbS=0LLzsrmax(y>W7BY-v%9jZHBmPJr=u3<T
LomV&z3cG&*+R&F`

delta 40
qcmcaFw3vT_GGqNl6&9w+3z+IBi*ssDPGbg&Ebd}vfr{ueasdDbN(;6C

diff --git a/lib/pytz/zoneinfo/Europe/Kirov b/lib/pytz/zoneinfo/Europe/Kirov
index 61e17f2b5697fd42477f1acb30411c5ab1ba83c3..0cfb956be223ab593ca27569ad554dae9b106117 100644
GIT binary patch
delta 204
zcmey&v5<3uxF{C`0|N+yfISd{*b*CcEEyR&CQGttSqd;PXc;hwFfdp+fJhMA$2WvQ
z+rSuzO@Y{i!8h0ih`kvY7=Z{3K&;6d8D+7XzWFhuDHFtaH?oZfxfkeKpuM`rTmYro
B7ajlr

delta 162
zcmZ3;`I%#axF`n$0|N+yfISd{*a91MEEySDCL6M7sq-)}Xc;iD`1pn}Xd4&<u_+Ln
jFfcFz5fFfA5Wr>9=HHB_Oc0|Ch%}1J256C;t}zz?p*aw~

diff --git a/lib/pytz/zoneinfo/Europe/Volgograd b/lib/pytz/zoneinfo/Europe/Volgograd
index 5539bac6ced7d584136fc705e8dcb80b300ad6b4..9d51a38c0ea719c5042837d47e0f427057b845f0 100644
GIT binary patch
delta 180
zcmey*v66Fwv>+D)1ULdI5L;rSjw2%@$K*Ul9a8}Y1}y^y5e5be2M`Hj`}l@1Xd4&<
nu?Y~HGWZ6&0I@gN3`Q`(X6ELnjIK-&Lv6@1lnZEwt}zz?S>6{H

delta 138
zcmZ3<`JZEgv>*oq1ULdI5L;lQjw2%@%Vb9u9eE&M%YcE!$2WvQ+rSuzO@P=Gtez1F
Zu<73Xo6(gCqFsZ4b}k#Bp?12)TmZ?I5as{?

diff --git a/lib/pytz/zoneinfo/iso3166.tab b/lib/pytz/zoneinfo/iso3166.tab
index 911af5e8..be3348d1 100644
--- a/lib/pytz/zoneinfo/iso3166.tab
+++ b/lib/pytz/zoneinfo/iso3166.tab
@@ -238,7 +238,7 @@ SY	Syria
 SZ	Eswatini (Swaziland)
 TC	Turks & Caicos Is
 TD	Chad
-TF	French Southern Territories
+TF	French S. Terr.
 TG	Togo
 TH	Thailand
 TJ	Tajikistan
diff --git a/lib/pytz/zoneinfo/leapseconds b/lib/pytz/zoneinfo/leapseconds
index 6826ac4a..a6a170aa 100644
--- a/lib/pytz/zoneinfo/leapseconds
+++ b/lib/pytz/zoneinfo/leapseconds
@@ -72,11 +72,11 @@ Leap	2016	Dec	31	23:59:60	+	S
 # Any additional leap seconds will come after this.
 # This Expires line is commented out for now,
 # so that pre-2020a zic implementations do not reject this file.
-#Expires 2023	Jun	28	00:00:00
+#Expires 2023	Dec	28	00:00:00
 
 # POSIX timestamps for the data in this file:
 #updated 1467936000 (2016-07-08 00:00:00 UTC)
-#expires 1687910400 (2023-06-28 00:00:00 UTC)
+#expires 1703721600 (2023-12-28 00:00:00 UTC)
 
-#	Updated through IERS Bulletin C64
-#	File expires on:  28 June 2023
+#	Updated through IERS Bulletin C65
+#	File expires on:  28 December 2023
diff --git a/lib/pytz/zoneinfo/tzdata.zi b/lib/pytz/zoneinfo/tzdata.zi
index 7c88530c..23d99be4 100644
--- a/lib/pytz/zoneinfo/tzdata.zi
+++ b/lib/pytz/zoneinfo/tzdata.zi
@@ -75,6 +75,8 @@ R K 2014 o - May 15 24 1 S
 R K 2014 o - Jun 26 24 0 -
 R K 2014 o - Jul 31 24 1 S
 R K 2014 o - S lastTh 24 0 -
+R K 2023 ma - Ap lastF 0 1 S
+R K 2023 ma - O lastTh 24 0 -
 Z Africa/Cairo 2:5:9 - LMT 1900 O
 2 K EE%sT
 Z Africa/Bissau -1:2:20 - LMT 1912 Ja 1 1u
@@ -172,7 +174,7 @@ R M 2021 o - May 16 2 0 -
 R M 2022 o - Mar 27 3 -1 -
 R M 2022 o - May 8 2 0 -
 R M 2023 o - Mar 19 3 -1 -
-R M 2023 o - Ap 30 2 0 -
+R M 2023 o - Ap 23 2 0 -
 R M 2024 o - Mar 10 3 -1 -
 R M 2024 o - Ap 14 2 0 -
 R M 2025 o - F 23 3 -1 -
@@ -188,7 +190,7 @@ R M 2029 o - F 18 2 0 -
 R M 2029 o - D 30 3 -1 -
 R M 2030 o - F 10 2 0 -
 R M 2030 o - D 22 3 -1 -
-R M 2031 o - F 2 2 0 -
+R M 2031 o - Ja 26 2 0 -
 R M 2031 o - D 14 3 -1 -
 R M 2032 o - Ja 18 2 0 -
 R M 2032 o - N 28 3 -1 -
@@ -204,7 +206,7 @@ R M 2036 o - N 23 2 0 -
 R M 2037 o - O 4 3 -1 -
 R M 2037 o - N 15 2 0 -
 R M 2038 o - S 26 3 -1 -
-R M 2038 o - N 7 2 0 -
+R M 2038 o - O 31 2 0 -
 R M 2039 o - S 18 3 -1 -
 R M 2039 o - O 23 2 0 -
 R M 2040 o - S 2 3 -1 -
@@ -220,7 +222,7 @@ R M 2044 o - Au 28 2 0 -
 R M 2045 o - Jul 9 3 -1 -
 R M 2045 o - Au 20 2 0 -
 R M 2046 o - Jul 1 3 -1 -
-R M 2046 o - Au 12 2 0 -
+R M 2046 o - Au 5 2 0 -
 R M 2047 o - Jun 23 3 -1 -
 R M 2047 o - Jul 28 2 0 -
 R M 2048 o - Jun 7 3 -1 -
@@ -236,7 +238,7 @@ R M 2052 o - Jun 2 2 0 -
 R M 2053 o - Ap 13 3 -1 -
 R M 2053 o - May 25 2 0 -
 R M 2054 o - Ap 5 3 -1 -
-R M 2054 o - May 17 2 0 -
+R M 2054 o - May 10 2 0 -
 R M 2055 o - Mar 28 3 -1 -
 R M 2055 o - May 2 2 0 -
 R M 2056 o - Mar 12 3 -1 -
@@ -252,7 +254,7 @@ R M 2060 o - Mar 7 2 0 -
 R M 2061 o - Ja 16 3 -1 -
 R M 2061 o - F 27 2 0 -
 R M 2062 o - Ja 8 3 -1 -
-R M 2062 o - F 19 2 0 -
+R M 2062 o - F 12 2 0 -
 R M 2062 o - D 31 3 -1 -
 R M 2063 o - F 4 2 0 -
 R M 2063 o - D 16 3 -1 -
@@ -268,7 +270,7 @@ R M 2067 o - D 11 2 0 -
 R M 2068 o - O 21 3 -1 -
 R M 2068 o - D 2 2 0 -
 R M 2069 o - O 13 3 -1 -
-R M 2069 o - N 24 2 0 -
+R M 2069 o - N 17 2 0 -
 R M 2070 o - O 5 3 -1 -
 R M 2070 o - N 9 2 0 -
 R M 2071 o - S 20 3 -1 -
@@ -284,7 +286,7 @@ R M 2075 o - S 15 2 0 -
 R M 2076 o - Jul 26 3 -1 -
 R M 2076 o - S 6 2 0 -
 R M 2077 o - Jul 18 3 -1 -
-R M 2077 o - Au 29 2 0 -
+R M 2077 o - Au 22 2 0 -
 R M 2078 o - Jul 10 3 -1 -
 R M 2078 o - Au 14 2 0 -
 R M 2079 o - Jun 25 3 -1 -
@@ -294,13 +296,13 @@ R M 2080 o - Jul 21 2 0 -
 R M 2081 o - Jun 1 3 -1 -
 R M 2081 o - Jul 13 2 0 -
 R M 2082 o - May 24 3 -1 -
-R M 2082 o - Jul 5 2 0 -
+R M 2082 o - Jun 28 2 0 -
 R M 2083 o - May 16 3 -1 -
 R M 2083 o - Jun 20 2 0 -
 R M 2084 o - Ap 30 3 -1 -
 R M 2084 o - Jun 11 2 0 -
 R M 2085 o - Ap 22 3 -1 -
-R M 2085 o - Jun 3 2 0 -
+R M 2085 o - May 27 2 0 -
 R M 2086 o - Ap 14 3 -1 -
 R M 2086 o - May 19 2 0 -
 R M 2087 o - Mar 30 3 -1 -
@@ -997,8 +999,86 @@ R P 2020 2021 - Mar Sa<=30 0 1 S
 R P 2020 o - O 24 1 0 -
 R P 2021 o - O 29 1 0 -
 R P 2022 o - Mar 27 0 1 S
-R P 2022 ma - O Sa<=30 2 0 -
-R P 2023 ma - Mar Sa<=30 2 1 S
+R P 2022 2035 - O Sa<=30 2 0 -
+R P 2023 o - Ap 29 2 1 S
+R P 2024 o - Ap 13 2 1 S
+R P 2025 o - Ap 5 2 1 S
+R P 2026 2054 - Mar Sa<=30 2 1 S
+R P 2036 o - O 18 2 0 -
+R P 2037 o - O 10 2 0 -
+R P 2038 o - S 25 2 0 -
+R P 2039 o - S 17 2 0 -
+R P 2039 o - O 22 2 1 S
+R P 2039 2067 - O Sa<=30 2 0 -
+R P 2040 o - S 1 2 0 -
+R P 2040 o - O 13 2 1 S
+R P 2041 o - Au 24 2 0 -
+R P 2041 o - S 28 2 1 S
+R P 2042 o - Au 16 2 0 -
+R P 2042 o - S 20 2 1 S
+R P 2043 o - Au 1 2 0 -
+R P 2043 o - S 12 2 1 S
+R P 2044 o - Jul 23 2 0 -
+R P 2044 o - Au 27 2 1 S
+R P 2045 o - Jul 15 2 0 -
+R P 2045 o - Au 19 2 1 S
+R P 2046 o - Jun 30 2 0 -
+R P 2046 o - Au 11 2 1 S
+R P 2047 o - Jun 22 2 0 -
+R P 2047 o - Jul 27 2 1 S
+R P 2048 o - Jun 6 2 0 -
+R P 2048 o - Jul 18 2 1 S
+R P 2049 o - May 29 2 0 -
+R P 2049 o - Jul 3 2 1 S
+R P 2050 o - May 21 2 0 -
+R P 2050 o - Jun 25 2 1 S
+R P 2051 o - May 6 2 0 -
+R P 2051 o - Jun 17 2 1 S
+R P 2052 o - Ap 27 2 0 -
+R P 2052 o - Jun 1 2 1 S
+R P 2053 o - Ap 12 2 0 -
+R P 2053 o - May 24 2 1 S
+R P 2054 o - Ap 4 2 0 -
+R P 2054 o - May 16 2 1 S
+R P 2055 o - May 1 2 1 S
+R P 2056 o - Ap 22 2 1 S
+R P 2057 o - Ap 7 2 1 S
+R P 2058 ma - Mar Sa<=30 2 1 S
+R P 2068 o - O 20 2 0 -
+R P 2069 o - O 12 2 0 -
+R P 2070 o - O 4 2 0 -
+R P 2071 o - S 19 2 0 -
+R P 2072 o - S 10 2 0 -
+R P 2072 o - O 15 2 1 S
+R P 2073 o - S 2 2 0 -
+R P 2073 o - O 7 2 1 S
+R P 2074 o - Au 18 2 0 -
+R P 2074 o - S 29 2 1 S
+R P 2075 o - Au 10 2 0 -
+R P 2075 o - S 14 2 1 S
+R P 2075 ma - O Sa<=30 2 0 -
+R P 2076 o - Jul 25 2 0 -
+R P 2076 o - S 5 2 1 S
+R P 2077 o - Jul 17 2 0 -
+R P 2077 o - Au 28 2 1 S
+R P 2078 o - Jul 9 2 0 -
+R P 2078 o - Au 13 2 1 S
+R P 2079 o - Jun 24 2 0 -
+R P 2079 o - Au 5 2 1 S
+R P 2080 o - Jun 15 2 0 -
+R P 2080 o - Jul 20 2 1 S
+R P 2081 o - Jun 7 2 0 -
+R P 2081 o - Jul 12 2 1 S
+R P 2082 o - May 23 2 0 -
+R P 2082 o - Jul 4 2 1 S
+R P 2083 o - May 15 2 0 -
+R P 2083 o - Jun 19 2 1 S
+R P 2084 o - Ap 29 2 0 -
+R P 2084 o - Jun 10 2 1 S
+R P 2085 o - Ap 21 2 0 -
+R P 2085 o - Jun 2 2 1 S
+R P 2086 o - Ap 13 2 0 -
+R P 2086 o - May 18 2 1 S
 Z Asia/Gaza 2:17:52 - LMT 1900 O
 2 Z EET/EEST 1948 May 15
 2 K EE%sT 1967 Jun 5
@@ -1754,8 +1834,8 @@ Z America/Scoresbysund -1:27:52 - LMT 1916 Jul 28
 -1 E -01/+00
 Z America/Nuuk -3:26:56 - LMT 1916 Jul 28
 -3 - -03 1980 Ap 6 2
--3 E -03/-02 2023 Mar 25 22
--2 - -02
+-3 E -03/-02 2023 O 29 1u
+-2 E -02/-01
 Z America/Thule -4:35:8 - LMT 1916 Jul 28
 -4 Th A%sT
 Z Europe/Tallinn 1:39 - LMT 1880
@@ -2175,13 +2255,13 @@ Z Europe/Volgograd 2:57:40 - LMT 1920 Ja 3
 3 - +03 1930 Jun 21
 4 - +04 1961 N 11
 4 R +04/+05 1988 Mar 27 2s
-3 R +03/+04 1991 Mar 31 2s
+3 R MSK/MSD 1991 Mar 31 2s
 4 - +04 1992 Mar 29 2s
-3 R +03/+04 2011 Mar 27 2s
-4 - +04 2014 O 26 2s
-3 - +03 2018 O 28 2s
+3 R MSK/MSD 2011 Mar 27 2s
+4 - MSK 2014 O 26 2s
+3 - MSK 2018 O 28 2s
 4 - +04 2020 D 27 2s
-3 - +03
+3 - MSK
 Z Europe/Saratov 3:4:18 - LMT 1919 Jul 1 0u
 3 - +03 1930 Jun 21
 4 R +04/+05 1988 Mar 27 2s
@@ -2194,11 +2274,11 @@ Z Europe/Saratov 3:4:18 - LMT 1919 Jul 1 0u
 Z Europe/Kirov 3:18:48 - LMT 1919 Jul 1 0u
 3 - +03 1930 Jun 21
 4 R +04/+05 1989 Mar 26 2s
-3 R +03/+04 1991 Mar 31 2s
+3 R MSK/MSD 1991 Mar 31 2s
 4 - +04 1992 Mar 29 2s
-3 R +03/+04 2011 Mar 27 2s
-4 - +04 2014 O 26 2s
-3 - +03
+3 R MSK/MSD 2011 Mar 27 2s
+4 - MSK 2014 O 26 2s
+3 - MSK
 Z Europe/Samara 3:20:20 - LMT 1919 Jul 1 0u
 3 - +03 1930 Jun 21
 4 - +04 1935 Ja 27
@@ -3070,9 +3150,6 @@ Z America/Cambridge_Bay 0 - -00 1920
 -5 - EST 2000 N 5
 -6 - CST 2001 Ap 1 3
 -7 C M%sT
-Z America/Yellowknife 0 - -00 1935
--7 Y M%sT 1980
--7 C M%sT
 Z America/Inuvik 0 - -00 1953
 -8 Y P%sT 1979 Ap lastSu 2
 -7 Y M%sT 1980
@@ -4171,6 +4248,7 @@ L America/Argentina/Cordoba America/Rosario
 L America/Tijuana America/Santa_Isabel
 L America/Denver America/Shiprock
 L America/Toronto America/Thunder_Bay
+L America/Edmonton America/Yellowknife
 L Pacific/Auckland Antarctica/South_Pole
 L Asia/Shanghai Asia/Chongqing
 L Asia/Shanghai Asia/Harbin
diff --git a/lib/pytz/zoneinfo/zone.tab b/lib/pytz/zoneinfo/zone.tab
index 6e5adb9f..dbcb6179 100644
--- a/lib/pytz/zoneinfo/zone.tab
+++ b/lib/pytz/zoneinfo/zone.tab
@@ -121,9 +121,8 @@ CA	+744144-0944945	America/Resolute	Central - NU (Resolute)
 CA	+624900-0920459	America/Rankin_Inlet	Central - NU (central)
 CA	+5024-10439	America/Regina	CST - SK (most areas)
 CA	+5017-10750	America/Swift_Current	CST - SK (midwest)
-CA	+5333-11328	America/Edmonton	Mountain - AB; BC (E); SK (W)
+CA	+5333-11328	America/Edmonton	Mountain - AB; BC (E); NT (E); SK (W)
 CA	+690650-1050310	America/Cambridge_Bay	Mountain - NU (west)
-CA	+6227-11421	America/Yellowknife	Mountain - NT (central)
 CA	+682059-1334300	America/Inuvik	Mountain - NT (west)
 CA	+4906-11631	America/Creston	MST - BC (Creston)
 CA	+5546-12014	America/Dawson_Creek	MST - BC (Dawson Cr, Ft St John)
@@ -139,7 +138,7 @@ CG	-0416+01517	Africa/Brazzaville
 CH	+4723+00832	Europe/Zurich
 CI	+0519-00402	Africa/Abidjan
 CK	-2114-15946	Pacific/Rarotonga
-CL	-3327-07040	America/Santiago	Chile (most areas)
+CL	-3327-07040	America/Santiago	most of Chile
 CL	-5309-07055	America/Punta_Arenas	Region of Magallanes
 CL	-2709-10926	Pacific/Easter	Easter Island
 CM	+0403+00942	Africa/Douala
@@ -151,10 +150,10 @@ CU	+2308-08222	America/Havana
 CV	+1455-02331	Atlantic/Cape_Verde
 CW	+1211-06900	America/Curacao
 CX	-1025+10543	Indian/Christmas
-CY	+3510+03322	Asia/Nicosia	Cyprus (most areas)
+CY	+3510+03322	Asia/Nicosia	most of Cyprus
 CY	+3507+03357	Asia/Famagusta	Northern Cyprus
 CZ	+5005+01426	Europe/Prague
-DE	+5230+01322	Europe/Berlin	Germany (most areas)
+DE	+5230+01322	Europe/Berlin	most of Germany
 DE	+4742+00841	Europe/Busingen	Busingen
 DJ	+1136+04309	Africa/Djibouti
 DK	+5540+01235	Europe/Copenhagen
@@ -187,7 +186,7 @@ GF	+0456-05220	America/Cayenne
 GG	+492717-0023210	Europe/Guernsey
 GH	+0533-00013	Africa/Accra
 GI	+3608-00521	Europe/Gibraltar
-GL	+6411-05144	America/Nuuk	Greenland (most areas)
+GL	+6411-05144	America/Nuuk	most of Greenland
 GL	+7646-01840	America/Danmarkshavn	National Park (east coast)
 GL	+7029-02158	America/Scoresbysund	Scoresbysund/Ittoqqortoormiit
 GL	+7634-06847	America/Thule	Thule/Pituffik
@@ -235,7 +234,7 @@ KP	+3901+12545	Asia/Pyongyang
 KR	+3733+12658	Asia/Seoul
 KW	+2920+04759	Asia/Kuwait
 KY	+1918-08123	America/Cayman
-KZ	+4315+07657	Asia/Almaty	Kazakhstan (most areas)
+KZ	+4315+07657	Asia/Almaty	most of Kazakhstan
 KZ	+4448+06528	Asia/Qyzylorda	Qyzylorda/Kyzylorda/Kzyl-Orda
 KZ	+5312+06337	Asia/Qostanay	Qostanay/Kostanay/Kustanay
 KZ	+5017+05710	Asia/Aqtobe	Aqtobe/Aktobe
@@ -259,12 +258,12 @@ MD	+4700+02850	Europe/Chisinau
 ME	+4226+01916	Europe/Podgorica
 MF	+1804-06305	America/Marigot
 MG	-1855+04731	Indian/Antananarivo
-MH	+0709+17112	Pacific/Majuro	Marshall Islands (most areas)
+MH	+0709+17112	Pacific/Majuro	most of Marshall Islands
 MH	+0905+16720	Pacific/Kwajalein	Kwajalein
 MK	+4159+02126	Europe/Skopje
 ML	+1239-00800	Africa/Bamako
 MM	+1647+09610	Asia/Yangon
-MN	+4755+10653	Asia/Ulaanbaatar	Mongolia (most areas)
+MN	+4755+10653	Asia/Ulaanbaatar	most of Mongolia
 MN	+4801+09139	Asia/Hovd	Bayan-Olgiy, Govi-Altai, Hovd, Uvs, Zavkhan
 MN	+4804+11430	Asia/Choibalsan	Dornod, Sukhbaatar
 MO	+221150+1133230	Asia/Macau
@@ -302,7 +301,7 @@ NO	+5955+01045	Europe/Oslo
 NP	+2743+08519	Asia/Kathmandu
 NR	-0031+16655	Pacific/Nauru
 NU	-1901-16955	Pacific/Niue
-NZ	-3652+17446	Pacific/Auckland	New Zealand (most areas)
+NZ	-3652+17446	Pacific/Auckland	most of New Zealand
 NZ	-4357-17633	Pacific/Chatham	Chatham Islands
 OM	+2336+05835	Asia/Muscat
 PA	+0858-07932	America/Panama
@@ -310,7 +309,7 @@ PE	-1203-07703	America/Lima
 PF	-1732-14934	Pacific/Tahiti	Society Islands
 PF	-0900-13930	Pacific/Marquesas	Marquesas Islands
 PF	-2308-13457	Pacific/Gambier	Gambier Islands
-PG	-0930+14710	Pacific/Port_Moresby	Papua New Guinea (most areas)
+PG	-0930+14710	Pacific/Port_Moresby	most of Papua New Guinea
 PG	-0613+15534	Pacific/Bougainville	Bougainville
 PH	+1435+12100	Asia/Manila
 PK	+2452+06703	Asia/Karachi
@@ -356,7 +355,7 @@ RU	+4310+13156	Asia/Vladivostok	MSK+07 - Amur River
 RU	+643337+1431336	Asia/Ust-Nera	MSK+07 - Oymyakonsky
 RU	+5934+15048	Asia/Magadan	MSK+08 - Magadan
 RU	+4658+14242	Asia/Sakhalin	MSK+08 - Sakhalin Island
-RU	+6728+15343	Asia/Srednekolymsk	MSK+08 - Sakha (E); North Kuril Is
+RU	+6728+15343	Asia/Srednekolymsk	MSK+08 - Sakha (E); N Kuril Is
 RU	+5301+15839	Asia/Kamchatka	MSK+09 - Kamchatka
 RU	+6445+17729	Asia/Anadyr	MSK+09 - Bering Sea
 RW	-0157+03004	Africa/Kigali
@@ -397,7 +396,7 @@ TT	+1039-06131	America/Port_of_Spain
 TV	-0831+17913	Pacific/Funafuti
 TW	+2503+12130	Asia/Taipei
 TZ	-0648+03917	Africa/Dar_es_Salaam
-UA	+5026+03031	Europe/Kyiv	Ukraine (most areas)
+UA	+5026+03031	Europe/Kyiv	most of Ukraine
 UG	+0019+03225	Africa/Kampala
 UM	+2813-17722	Pacific/Midway	Midway Islands
 UM	+1917+16637	Pacific/Wake	Wake Island
@@ -420,7 +419,7 @@ US	+465042-1012439	America/North_Dakota/New_Salem	Central - ND (Morton rural)
 US	+471551-1014640	America/North_Dakota/Beulah	Central - ND (Mercer)
 US	+394421-1045903	America/Denver	Mountain (most areas)
 US	+433649-1161209	America/Boise	Mountain - ID (south); OR (east)
-US	+332654-1120424	America/Phoenix	MST - Arizona (except Navajo)
+US	+332654-1120424	America/Phoenix	MST - AZ (except Navajo)
 US	+340308-1181434	America/Los_Angeles	Pacific
 US	+611305-1495401	America/Anchorage	Alaska (most areas)
 US	+581807-1342511	America/Juneau	Alaska - Juneau area
@@ -428,7 +427,7 @@ US	+571035-1351807	America/Sitka	Alaska - Sitka area
 US	+550737-1313435	America/Metlakatla	Alaska - Annette Island
 US	+593249-1394338	America/Yakutat	Alaska - Yakutat
 US	+643004-1652423	America/Nome	Alaska (west)
-US	+515248-1763929	America/Adak	Aleutian Islands
+US	+515248-1763929	America/Adak	Alaska - western Aleutians
 US	+211825-1575130	Pacific/Honolulu	Hawaii
 UY	-345433-0561245	America/Montevideo
 UZ	+3940+06648	Asia/Samarkand	Uzbekistan (west)
diff --git a/lib/pytz/zoneinfo/zone1970.tab b/lib/pytz/zoneinfo/zone1970.tab
index a9b36d36..1f1cecb8 100644
--- a/lib/pytz/zoneinfo/zone1970.tab
+++ b/lib/pytz/zoneinfo/zone1970.tab
@@ -18,7 +18,10 @@
 #     Please see the theory.html file for how these names are chosen.
 #     If multiple timezones overlap a country, each has a row in the
 #     table, with each column 1 containing the country code.
-# 4.  Comments; present if and only if a country has multiple timezones.
+# 4.  Comments; present if and only if countries have multiple timezones,
+#     and useful only for those countries.  For example, the comments
+#     for the row with countries CH,DE,LI and name Europe/Zurich
+#     are useful only for DE, since CH and LI have no other timezones.
 #
 # If a timezone covers multiple countries, the most-populous city is used,
 # and that country is listed first in column 1; any other countries
@@ -34,7 +37,7 @@
 #country-
 #codes	coordinates	TZ	comments
 AD	+4230+00131	Europe/Andorra
-AE,OM,RE,SC,TF	+2518+05518	Asia/Dubai	UAE, Oman, Réunion, Seychelles, Crozet, Scattered Is
+AE,OM,RE,SC,TF	+2518+05518	Asia/Dubai	Crozet, Scattered Is
 AF	+3431+06912	Asia/Kabul
 AL	+4120+01950	Europe/Tirane
 AM	+4011+04430	Asia/Yerevan
@@ -45,7 +48,7 @@ AQ	-6448-06406	Antarctica/Palmer	Palmer
 AQ	-6734-06808	Antarctica/Rothera	Rothera
 AQ	-720041+0023206	Antarctica/Troll	Troll
 AR	-3436-05827	America/Argentina/Buenos_Aires	Buenos Aires (BA, CF)
-AR	-3124-06411	America/Argentina/Cordoba	Argentina (most areas: CB, CC, CN, ER, FM, MN, SE, SF)
+AR	-3124-06411	America/Argentina/Cordoba	most areas: CB, CC, CN, ER, FM, MN, SE, SF
 AR	-2447-06525	America/Argentina/Salta	Salta (SA, LP, NQ, RN)
 AR	-2411-06518	America/Argentina/Jujuy	Jujuy (JY)
 AR	-2649-06513	America/Argentina/Tucuman	Tucumán (TM)
@@ -56,7 +59,7 @@ AR	-3253-06849	America/Argentina/Mendoza	Mendoza (MZ)
 AR	-3319-06621	America/Argentina/San_Luis	San Luis (SL)
 AR	-5138-06913	America/Argentina/Rio_Gallegos	Santa Cruz (SC)
 AR	-5448-06818	America/Argentina/Ushuaia	Tierra del Fuego (TF)
-AS,UM	-1416-17042	Pacific/Pago_Pago	Samoa, Midway
+AS,UM	-1416-17042	Pacific/Pago_Pago	Midway
 AT	+4813+01620	Europe/Vienna
 AU	-3133+15905	Australia/Lord_Howe	Lord Howe Island
 AU	-5430+15857	Antarctica/Macquarie	Macquarie Island
@@ -101,26 +104,25 @@ CA	+4439-06336	America/Halifax	Atlantic - NS (most areas); PE
 CA	+4612-05957	America/Glace_Bay	Atlantic - NS (Cape Breton)
 CA	+4606-06447	America/Moncton	Atlantic - New Brunswick
 CA	+5320-06025	America/Goose_Bay	Atlantic - Labrador (most areas)
-CA,BS	+4339-07923	America/Toronto	Eastern - ON, QC (most areas), Bahamas
+CA,BS	+4339-07923	America/Toronto	Eastern - ON, QC (most areas)
 CA	+6344-06828	America/Iqaluit	Eastern - NU (most areas)
 CA	+4953-09709	America/Winnipeg	Central - ON (west); Manitoba
 CA	+744144-0944945	America/Resolute	Central - NU (Resolute)
 CA	+624900-0920459	America/Rankin_Inlet	Central - NU (central)
 CA	+5024-10439	America/Regina	CST - SK (most areas)
 CA	+5017-10750	America/Swift_Current	CST - SK (midwest)
-CA	+5333-11328	America/Edmonton	Mountain - AB; BC (E); SK (W)
+CA	+5333-11328	America/Edmonton	Mountain - AB; BC (E); NT (E); SK (W)
 CA	+690650-1050310	America/Cambridge_Bay	Mountain - NU (west)
-CA	+6227-11421	America/Yellowknife	Mountain - NT (central)
 CA	+682059-1334300	America/Inuvik	Mountain - NT (west)
 CA	+5546-12014	America/Dawson_Creek	MST - BC (Dawson Cr, Ft St John)
 CA	+5848-12242	America/Fort_Nelson	MST - BC (Ft Nelson)
 CA	+6043-13503	America/Whitehorse	MST - Yukon (east)
 CA	+6404-13925	America/Dawson	MST - Yukon (west)
 CA	+4916-12307	America/Vancouver	Pacific - BC (most areas)
-CH,DE,LI	+4723+00832	Europe/Zurich	Swiss time
+CH,DE,LI	+4723+00832	Europe/Zurich	Büsingen
 CI,BF,GH,GM,GN,IS,ML,MR,SH,SL,SN,TG	+0519-00402	Africa/Abidjan
 CK	-2114-15946	Pacific/Rarotonga
-CL	-3327-07040	America/Santiago	Chile (most areas)
+CL	-3327-07040	America/Santiago	most of Chile
 CL	-5309-07055	America/Punta_Arenas	Region of Magallanes
 CL	-2709-10926	Pacific/Easter	Easter Island
 CN	+3114+12128	Asia/Shanghai	Beijing Time
@@ -129,10 +131,10 @@ CO	+0436-07405	America/Bogota
 CR	+0956-08405	America/Costa_Rica
 CU	+2308-08222	America/Havana
 CV	+1455-02331	Atlantic/Cape_Verde
-CY	+3510+03322	Asia/Nicosia	Cyprus (most areas)
+CY	+3510+03322	Asia/Nicosia	most of Cyprus
 CY	+3507+03357	Asia/Famagusta	Northern Cyprus
 CZ,SK	+5005+01426	Europe/Prague
-DE,DK,NO,SE,SJ	+5230+01322	Europe/Berlin	Germany (most areas), Scandinavia
+DE,DK,NO,SE,SJ	+5230+01322	Europe/Berlin	most of Germany
 DO	+1828-06954	America/Santo_Domingo
 DZ	+3647+00303	Africa/Algiers
 EC	-0210-07950	America/Guayaquil	Ecuador (mainland)
@@ -153,7 +155,7 @@ GB,GG,IM,JE	+513030-0000731	Europe/London
 GE	+4143+04449	Asia/Tbilisi
 GF	+0456-05220	America/Cayenne
 GI	+3608-00521	Europe/Gibraltar
-GL	+6411-05144	America/Nuuk	Greenland (most areas)
+GL	+6411-05144	America/Nuuk	most of Greenland
 GL	+7646-01840	America/Danmarkshavn	National Park (east coast)
 GL	+7029-02158	America/Scoresbysund	Scoresbysund/Ittoqqortoormiit
 GL	+7634-06847	America/Thule	Thule/Pituffik
@@ -183,12 +185,12 @@ JO	+3157+03556	Asia/Amman
 JP	+353916+1394441	Asia/Tokyo
 KE,DJ,ER,ET,KM,MG,SO,TZ,UG,YT	-0117+03649	Africa/Nairobi
 KG	+4254+07436	Asia/Bishkek
-KI,MH,TV,UM,WF	+0125+17300	Pacific/Tarawa	Gilberts, Marshalls, Tuvalu, Wallis & Futuna, Wake
+KI,MH,TV,UM,WF	+0125+17300	Pacific/Tarawa	Gilberts, Marshalls, Wake
 KI	-0247-17143	Pacific/Kanton	Phoenix Islands
 KI	+0152-15720	Pacific/Kiritimati	Line Islands
 KP	+3901+12545	Asia/Pyongyang
 KR	+3733+12658	Asia/Seoul
-KZ	+4315+07657	Asia/Almaty	Kazakhstan (most areas)
+KZ	+4315+07657	Asia/Almaty	most of Kazakhstan
 KZ	+4448+06528	Asia/Qyzylorda	Qyzylorda/Kyzylorda/Kzyl-Orda
 KZ	+5312+06337	Asia/Qostanay	Qostanay/Kostanay/Kustanay
 KZ	+5017+05710	Asia/Aqtobe	Aqtöbe/Aktobe
@@ -205,14 +207,14 @@ MA	+3339-00735	Africa/Casablanca
 MD	+4700+02850	Europe/Chisinau
 MH	+0905+16720	Pacific/Kwajalein	Kwajalein
 MM,CC	+1647+09610	Asia/Yangon
-MN	+4755+10653	Asia/Ulaanbaatar	Mongolia (most areas)
+MN	+4755+10653	Asia/Ulaanbaatar	most of Mongolia
 MN	+4801+09139	Asia/Hovd	Bayan-Ölgii, Govi-Altai, Hovd, Uvs, Zavkhan
 MN	+4804+11430	Asia/Choibalsan	Dornod, Sükhbaatar
 MO	+221150+1133230	Asia/Macau
 MQ	+1436-06105	America/Martinique
 MT	+3554+01431	Europe/Malta
 MU	-2010+05730	Indian/Mauritius
-MV,TF	+0410+07330	Indian/Maldives	Maldives, Kerguelen, St Paul I, Amsterdam I
+MV,TF	+0410+07330	Indian/Maldives	Kerguelen, St Paul I, Amsterdam I
 MX	+1924-09909	America/Mexico_City	Central Mexico
 MX	+2105-08646	America/Cancun	Quintana Roo
 MX	+2058-08937	America/Merida	Campeche, Yucatán
@@ -225,7 +227,7 @@ MX	+2313-10625	America/Mazatlan	Baja California Sur, Nayarit (most areas), Sinal
 MX	+2048-10515	America/Bahia_Banderas	Bahía de Banderas
 MX	+2904-11058	America/Hermosillo	Sonora
 MX	+3232-11701	America/Tijuana	Baja California
-MY,BN	+0133+11020	Asia/Kuching	Sabah, Sarawak, Brunei
+MY,BN	+0133+11020	Asia/Kuching	Sabah, Sarawak
 MZ,BI,BW,CD,MW,RW,ZM,ZW	-2558+03235	Africa/Maputo	Central Africa Time
 NA	-2234+01706	Africa/Windhoek
 NC	-2216+16627	Pacific/Noumea
@@ -237,7 +239,7 @@ NR	-0031+16655	Pacific/Nauru
 NU	-1901-16955	Pacific/Niue
 NZ,AQ	-3652+17446	Pacific/Auckland	New Zealand time
 NZ	-4357-17633	Pacific/Chatham	Chatham Islands
-PA,CA,KY	+0858-07932	America/Panama	EST - Panama, Cayman, ON (Atikokan), NU (Coral H)
+PA,CA,KY	+0858-07932	America/Panama	EST - ON (Atikokan), NU (Coral H)
 PE	-1203-07703	America/Lima
 PF	-1732-14934	Pacific/Tahiti	Society Islands
 PF	-0900-13930	Pacific/Marquesas	Marquesas Islands
@@ -285,13 +287,13 @@ RU	+4310+13156	Asia/Vladivostok	MSK+07 - Amur River
 RU	+643337+1431336	Asia/Ust-Nera	MSK+07 - Oymyakonsky
 RU	+5934+15048	Asia/Magadan	MSK+08 - Magadan
 RU	+4658+14242	Asia/Sakhalin	MSK+08 - Sakhalin Island
-RU	+6728+15343	Asia/Srednekolymsk	MSK+08 - Sakha (E); North Kuril Is
+RU	+6728+15343	Asia/Srednekolymsk	MSK+08 - Sakha (E); N Kuril Is
 RU	+5301+15839	Asia/Kamchatka	MSK+09 - Kamchatka
 RU	+6445+17729	Asia/Anadyr	MSK+09 - Bering Sea
-SA,AQ,KW,YE	+2438+04643	Asia/Riyadh	Arabia, Syowa
-SB,FM	-0932+16012	Pacific/Guadalcanal	Solomons, Pohnpei
+SA,AQ,KW,YE	+2438+04643	Asia/Riyadh	Syowa
+SB,FM	-0932+16012	Pacific/Guadalcanal	Pohnpei
 SD	+1536+03232	Africa/Khartoum
-SG,MY	+0117+10351	Asia/Singapore	Singapore, peninsular Malaysia
+SG,MY	+0117+10351	Asia/Singapore	peninsular Malaysia
 SR	+0550-05510	America/Paramaribo
 SS	+0451+03137	Africa/Juba
 ST	+0020+00644	Africa/Sao_Tome
@@ -299,7 +301,7 @@ SV	+1342-08912	America/El_Salvador
 SY	+3330+03618	Asia/Damascus
 TC	+2128-07108	America/Grand_Turk
 TD	+1207+01503	Africa/Ndjamena
-TH,CX,KH,LA,VN	+1345+10031	Asia/Bangkok	Indochina (most areas)
+TH,CX,KH,LA,VN	+1345+10031	Asia/Bangkok	north Vietnam
 TJ	+3835+06848	Asia/Dushanbe
 TK	-0922-17114	Pacific/Fakaofo
 TL	-0833+12535	Asia/Dili
@@ -308,7 +310,7 @@ TN	+3648+01011	Africa/Tunis
 TO	-210800-1751200	Pacific/Tongatapu
 TR	+4101+02858	Europe/Istanbul
 TW	+2503+12130	Asia/Taipei
-UA	+5026+03031	Europe/Kyiv	Ukraine (most areas)
+UA	+5026+03031	Europe/Kyiv	most of Ukraine
 US	+404251-0740023	America/New_York	Eastern (most areas)
 US	+421953-0830245	America/Detroit	Eastern - MI (most areas)
 US	+381515-0854534	America/Kentucky/Louisville	Eastern - KY (Louisville area)
@@ -328,7 +330,7 @@ US	+465042-1012439	America/North_Dakota/New_Salem	Central - ND (Morton rural)
 US	+471551-1014640	America/North_Dakota/Beulah	Central - ND (Mercer)
 US	+394421-1045903	America/Denver	Mountain (most areas)
 US	+433649-1161209	America/Boise	Mountain - ID (south); OR (east)
-US,CA	+332654-1120424	America/Phoenix	MST - Arizona (except Navajo), Creston BC
+US,CA	+332654-1120424	America/Phoenix	MST - AZ (most areas), Creston BC
 US	+340308-1181434	America/Los_Angeles	Pacific
 US	+611305-1495401	America/Anchorage	Alaska (most areas)
 US	+581807-1342511	America/Juneau	Alaska - Juneau area
@@ -336,13 +338,13 @@ US	+571035-1351807	America/Sitka	Alaska - Sitka area
 US	+550737-1313435	America/Metlakatla	Alaska - Annette Island
 US	+593249-1394338	America/Yakutat	Alaska - Yakutat
 US	+643004-1652423	America/Nome	Alaska (west)
-US	+515248-1763929	America/Adak	Aleutian Islands
-US,UM	+211825-1575130	Pacific/Honolulu	Hawaii
+US	+515248-1763929	America/Adak	Alaska - western Aleutians
+US	+211825-1575130	Pacific/Honolulu	Hawaii
 UY	-345433-0561245	America/Montevideo
 UZ	+3940+06648	Asia/Samarkand	Uzbekistan (west)
 UZ	+4120+06918	Asia/Tashkent	Uzbekistan (east)
 VE	+1030-06656	America/Caracas
-VN	+1045+10640	Asia/Ho_Chi_Minh	Vietnam (south)
+VN	+1045+10640	Asia/Ho_Chi_Minh	south Vietnam
 VU	-1740+16825	Pacific/Efate
 WS	-1350-17144	Pacific/Apia
 ZA,LS,SZ	-2615+02800	Africa/Johannesburg
diff --git a/requirements.txt b/requirements.txt
index ee495cb7..00e17bde 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -35,7 +35,7 @@ PyJWT==2.6.0
 pyparsing==3.0.9
 python-dateutil==2.8.2
 python-twitter==3.5
-pytz==2022.7.1
+pytz==2023.3
 requests==2.28.2
 requests-oauthlib==1.3.1
 rumps==0.4.0; platform_system == "Darwin"

From 70fb00280bb40e6d51455078d0ade91be6aeec66 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 23 Aug 2023 21:38:28 -0700
Subject: [PATCH 422/743] Bump tzdata from 2022.7 to 2023.3 (#2032)

* Bump tzdata from 2022.7 to 2023.3

Bumps [tzdata](https://github.com/python/tzdata) from 2022.7 to 2023.3.
- [Release notes](https://github.com/python/tzdata/releases)
- [Changelog](https://github.com/python/tzdata/blob/master/NEWS.md)
- [Commits](https://github.com/python/tzdata/compare/2022.7...2023.3)

---
updated-dependencies:
- dependency-name: tzdata
  dependency-type: direct:production
  update-type: version-update:semver-major
...

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

* Update tzdata==2023.3

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/tzdata/__init__.py                  |   4 +-
 lib/tzdata/zoneinfo/Africa/Cairo        | Bin 1276 -> 1309 bytes
 lib/tzdata/zoneinfo/Africa/Casablanca   | Bin 1919 -> 1919 bytes
 lib/tzdata/zoneinfo/Africa/El_Aaiun     | Bin 1830 -> 1830 bytes
 lib/tzdata/zoneinfo/America/Godthab     | Bin 931 -> 965 bytes
 lib/tzdata/zoneinfo/America/Nuuk        | Bin 931 -> 965 bytes
 lib/tzdata/zoneinfo/America/Yellowknife | Bin 844 -> 970 bytes
 lib/tzdata/zoneinfo/Asia/Gaza           | Bin 1258 -> 2518 bytes
 lib/tzdata/zoneinfo/Asia/Hebron         | Bin 1276 -> 2536 bytes
 lib/tzdata/zoneinfo/Egypt               | Bin 1276 -> 1309 bytes
 lib/tzdata/zoneinfo/Europe/Kirov        | Bin 717 -> 735 bytes
 lib/tzdata/zoneinfo/Europe/Volgograd    | Bin 735 -> 753 bytes
 lib/tzdata/zoneinfo/iso3166.tab         |   2 +-
 lib/tzdata/zoneinfo/leapseconds         |   8 +-
 lib/tzdata/zoneinfo/tzdata.zi           | 132 +++++++++++++++++++-----
 lib/tzdata/zoneinfo/zone.tab            |  29 +++---
 lib/tzdata/zoneinfo/zone1970.tab        |  58 ++++++-----
 lib/tzdata/zones                        |   2 +-
 requirements.txt                        |   2 +-
 19 files changed, 158 insertions(+), 79 deletions(-)

diff --git a/lib/tzdata/__init__.py b/lib/tzdata/__init__.py
index 96456857..a7d6b0b5 100644
--- a/lib/tzdata/__init__.py
+++ b/lib/tzdata/__init__.py
@@ -1,6 +1,6 @@
 # IANA versions like 2020a are not valid PEP 440 identifiers; the recommended
 # way to translate the version is to use YYYY.n where `n` is a 0-based index.
-__version__ = "2022.7"
+__version__ = "2023.3"
 
 # This exposes the original IANA version number.
-IANA_VERSION = "2022g"
+IANA_VERSION = "2023c"
diff --git a/lib/tzdata/zoneinfo/Africa/Cairo b/lib/tzdata/zoneinfo/Africa/Cairo
index ea38c970086c6ddca48d6f5703cee91ed1ac98b4..1e6d48d1ca4e5416913c41e8814dc045c57d5b58 100644
GIT binary patch
delta 58
zcmeyvIhSif7-Pf2a25^*AV~50kT5xsrF3!u3-{z}EUJ>OuE8NXz9xF6dZzjYI=+Sm
LK$eNVkqH+7|I-hF

delta 23
fcmbQs^@npp7-RjyaF)r5EOm@blkc;rGI9X`W1|Ny

diff --git a/lib/tzdata/zoneinfo/Africa/Casablanca b/lib/tzdata/zoneinfo/Africa/Casablanca
index 0263c90bd0d82565a86d414b0aa86205e01dad85..240ebb2bfb22642570a6053445a6e71864e7f48a 100644
GIT binary patch
delta 88
zcmey*_n&V=3KO%-M1{%eOtsASWEV_+4y4Oh0r||e%z|b>K9F8@7|3U-Wp?og@`3c-
gJ3u}wP+bO)&+5xO%~D~qIh!uCz*mLM>1+~=0NOGj4FCWD

delta 88
zcmey*_n&V=3KO&M=>?P1nQEDzM<`5w4x}5N0Qt<d%u<CwK9Ju07szL+W%lg?@`3bo
gF(986sBSTk&+5xOzj(o9b2eRODg6bT)7c~#0YC{Mu>b%7

diff --git a/lib/tzdata/zoneinfo/Africa/El_Aaiun b/lib/tzdata/zoneinfo/Africa/El_Aaiun
index 772e23c4cd8bb1942efdc18155585f9b8f0e8429..909c5f9682927c14e3e64e21da75559ad2e598f9 100644
GIT binary patch
delta 88
zcmZ3+w~TKC4->P?M1{%xOtsASWEV{C2h!!MfPCg!W<fI`A4sn{4CJ%aGQ0Q#`9S*a
g9Uz|-s4fG@XZ2;CW~ngwKC3RXz*mLM{A}Wk00W;KkpKVy

delta 88
zcmZ3+w~TKC4->QR=>?PdnQEDzM<`702ht5sfPCg!W~o9TA4qTh3*@uZGW&J``9S))
g7?95jRJRz&XZ2;CU%X)QeO6s&Dg6bT`Psx70cmF*H2?qr

diff --git a/lib/tzdata/zoneinfo/America/Godthab b/lib/tzdata/zoneinfo/America/Godthab
index 79d7a45464b3f1dac470b9ea5f6a12b1344c8173..00b57bb13fbfa802e61f8b93d08622163a35a9a4 100644
GIT binary patch
delta 85
zcmZ3?ew3XxBq}q_c%q=#L<RPV3ak^=1sI_`CWgq3;U}0l7=R$vcHM-@ip-(ROpHvE
f%b0bfY;+9_?R0#N^-T2)^mPq&d<_l2Oam?eg*g*H

delta 51
zcmX@gzL=dgBq}q_XriFlL<RPV3ak^=1sI_`CWeTO;U}0T8#4P%wrA#?T+gh-$OQmu
CoDC-c

diff --git a/lib/tzdata/zoneinfo/America/Nuuk b/lib/tzdata/zoneinfo/America/Nuuk
index 79d7a45464b3f1dac470b9ea5f6a12b1344c8173..00b57bb13fbfa802e61f8b93d08622163a35a9a4 100644
GIT binary patch
delta 85
zcmZ3?ew3XxBq}q_c%q=#L<RPV3ak^=1sI_`CWgq3;U}0l7=R$vcHM-@ip-(ROpHvE
f%b0bfY;+9_?R0#N^-T2)^mPq&d<_l2Oam?eg*g*H

delta 51
zcmX@gzL=dgBq}q_XriFlL<RPV3ak^=1sI_`CWeTO;U}0T8#4P%wrA#?T+gh-$OQmu
CoDC-c

diff --git a/lib/tzdata/zoneinfo/America/Yellowknife b/lib/tzdata/zoneinfo/America/Yellowknife
index ff3eb8781ee7283c74b186b7c897ce929619929d..645ee9453073acf4cff9f9420b358a8ebbe40f93 100644
GIT binary patch
delta 329
zcmX@Zc8YyMSbZb|0|P4%i~I+Ij(g`GfarNU)=vP@^LMj1fanD?CW843F13RBi@IKb
z`HNfF7(nt%vQB~dOHB`h<(CCN7XXPb7hMYGuP{Cd=CAm72(12eCl6TtC1uGk1t5i&
z5+%SAS3@6z6<$-gv$4*Ssh)`u2{N-FagZg*VE_L=bpZp=%GC=PS^oc@JAr`%%;o`;
t0zSSW48ATQ3@X0CKt?za2ZS(i0XgPCQ5|1nJtI8>9bZF3JwrVME&yiRjywPW

delta 183
zcmX@beuiyAn1(k40|P4%i~I+IeOeL>Ao_GC&jb*CN%>0wm`;?~_|B54o|%z}nT0wK
xXeAK*|G#<xBMX@1`2T<I1O^^3TR_*qfWbFBguyoeh=YOHC4_;?ck&iyF#v(jFf0H7

diff --git a/lib/tzdata/zoneinfo/Asia/Gaza b/lib/tzdata/zoneinfo/Asia/Gaza
index bed968e7ecb2a6ac44642b400c85927105ab43ea..7e83389819c406774f07f97300106d665dbc12c1 100644
GIT binary patch
delta 1178
zcmZA0dq`7Z7zXgqwvcr*$u34oW?)HTNMWF6_lyj~NKM3wY+B2lRx&l+QMaj^&FOT`
zOLH~vrsgG?mgXh5LL>^y(5S4mEXxtt4a4?5=fBQB@A<vY^Bp#J_L=u$h3dot8*X#R
zBaWC@ugHK1I><Sn-4;6ej)QcNsC66RC`&v;9X-c|&zsj$k_%&#u%K!VzBs@U(wi9B
zYxq*d1RTrnfrSz?92fYCp^Ny)S}_)vJ-V^DvR?sTwbR21?$s7rOqfZBMN6|`(UV9x
z@v8t%YB~rf4;_WCY0naRr5I*~bf$_9&_TpWWyqOOS2)dI%)=smCl8AZr)C_;2>8G{
zcsVRt{RNgxJHb*H1w$9o9p7P@jV&ze8?ey5%<>D)Tse$9^X(LzRU89nnf2BdAz9+t
zb}X`c1{u1L^G9L1?hxzeT3DfPfOCA)EVP#+Xk*>o2481#VWq<s^p$(VX^kj#8sxdB
z<B;c$YmloPIj~rjDncReu#)ykp3#@}q!5Mth%i{qK9{Jab*#JApkJ`d2QK6V!G+;L
zLV8mum%<v?ldxuLJ6z=X8~vg)TN&#@OtiM%C}<zALZO)OQ7HBrX8mzJ@{$%$dVrLS
zEQ3oI?m=E^nup8s9gvq*B(om-1mCC{hjnp3U|ll%QtMh&*7Mf)zg*Ujf?oXBx*+6c
z>>CT6w}LAeIt_unaK$EjxYEM_SN`dsF{!qb!quataLr5<T-%uf*S(Yo=}mpfDfqUL
z4>u%PzX1LJHER8_XbN*d;f}}+Zr<m|&_zq=61dgH8E*6X2H)kdzhS%cA`9)cznegA
zB-605&kT2r6rkT(&%V_68oiO<SC~jNJ=i6Ak3zSghLSu8ItKR~k;A>4f8s!Ih#Nx}
zee>nW``w=*e>lW`zyWR|a+9GIebduP*v#`1s-3wT)PCGh^){}(TF7<%Z!T6BagYB4
D!F(-F

delta 25
hcmca6{EBlzC=)})#_$u&lN&h{CeP=HnB2@63;=&u2~Pk3

diff --git a/lib/tzdata/zoneinfo/Asia/Hebron b/lib/tzdata/zoneinfo/Asia/Hebron
index 3ce1bac63134c393682a2a91f5d13c7b05ab2db4..fcf923bd283a4a6f21d789551c29ff5e2680108d 100644
GIT binary patch
delta 1178
zcmZA0dq`7Z7zXgqwvt6<l3k3F%)pdHlEOeOyBisXk(!7V*|e59tz>Gtqi$0-o0sXF
zm*#5oo|>0rTAG*K2$3iZMWeFPlq^SJHw@eNoc}uiyyy2m&v)3^*&=UdUH;i+HY-{}
z$2ekQy`lmm=^&SV{VjCz9f#;3(Ob5|(Ut^;I%bgzUomf{Bv&V<VL|mGd~J{;q&Km$
zxA1kt6dcFzg@qC`93S+Cp^Jp5Ix!YEJbSRXc|-x<veUtd9yJzPOq|bvMXPgQ(TgZJ
z>8k)vZaxO544;B;Yc3IbrRo=ibf$@p(m}+@708(|S2#UD%)=sM9}kO6rxqN@4E)48
zWGyV&_yv~CIl)pF1w$9oz29M(jV&zeAGFZD%<>D)T0eq3>-{X8T^b8#n|0O}A=%=E
z4lHtdhZwq$^T%Pi_BiX;8d#xggmeAUEwq;_XlLEi4&Pz&V5Nf_`pQEQv__O#HS)X*
z@yPQg)yVT5Ij}fCO@u<h2_@~50;3=6X(0-Qk>Rk4eJ)W+>sfbiLceIgFI>zEhKnPD
zh4iLaE``;u=V0~h9=OEoH~J+PcQMw5m}qQ$P|!TzfI=zZqfqKS!us=8<Yld1^Z+Rv
zT?3adKZv~Cv;<caIv}qwq_Cctf$vsN!rJ&Bur`H#skN>7*7Mf)zfv}Uf=>L`x*+6U
z+&c@M_d^T}o%*0Y*s#MMuJY8wRew5ZOls_;aLsr*Tst2P*L9`B^<xqty=f>r4?i&S
z;l^a^7oh*YCQSeq&EYO6JQTUZEr$;<bkQ2N3T|_8hTFZr!H+oXZ`k3y(n5P3AEuBS
z$sBC#H^ZHyMd)`murKxFCLiQa6ebcw4|YpFqR=C#r6f;-Ps6<@<#6B5pE%GL>dw$b
z|57FL0gqS6pAEAgaFCmX+@x<q-}G`CHuJoNs@>desvvH-%AaemVz_SqO<PqR_sl=U
CLoOHq

delta 25
hcmaDM{D*TwC=)}~#_$`=lP7X0OkU3sHF+v$FaU)a3Aq3O

diff --git a/lib/tzdata/zoneinfo/Egypt b/lib/tzdata/zoneinfo/Egypt
index ea38c970086c6ddca48d6f5703cee91ed1ac98b4..1e6d48d1ca4e5416913c41e8814dc045c57d5b58 100644
GIT binary patch
delta 58
zcmeyvIhSif7-Pf2a25^*AV~50kT5xsrF3!u3-{z}EUJ>OuE8NXz9xF6dZzjYI=+Sm
LK$eNVkqH+7|I-hF

delta 23
fcmbQs^@npp7-RjyaF)r5EOm@blkc;rGI9X`W1|Ny

diff --git a/lib/tzdata/zoneinfo/Europe/Kirov b/lib/tzdata/zoneinfo/Europe/Kirov
index d1c93c540c2670f5fd6d04cf837f31d9c2b0c530..bfac56111d9cc81a93cce85205c685880433b96f 100644
GIT binary patch
delta 134
zcmX@hdY^Sd6e~Le1B1lIcy6XrRu)!f79c?wvavES=*<9XWY98TU}0cz3t;46V6bpt
o-~o}00$_0wu!x9{ZwQ07fiV!90<j5$Z?FpxdoyqW30-3@0GSUCumAu6

delta 116
zcmcc5dX{xU6e}wO1B1ZEcy6X-Mixe979c?wGBYwT=*<9XWY98TU}0cz3t;46V6bpt
e-~o}0JU+f54B7_9Kx_)cCJbCQK%SkhF&6-wBMXTD

diff --git a/lib/tzdata/zoneinfo/Europe/Volgograd b/lib/tzdata/zoneinfo/Europe/Volgograd
index c5170026042fa121010903fb5bd88542b1be22bd..0715d58bc1873c8bae589a08752cbbae562692c7 100644
GIT binary patch
delta 114
zcmcc5`jK@)6e~Le1B1lIcu6J$Ru&*+0uh8E8!Hp*<P}V^Isyy~S_TXv3=9?y3?e?h
bAq?6E#z1TW#HI|s!7f1T&A<gDbd9+H)=&*{

delta 96
zcmey!dY^Sd6e}wO1B1ZEcu6J$MiwAs0uh8E6C)Gj<P}V^QXD?MAq?6E#z1TW#HI{f
LHb9=8t}zz?`!xza

diff --git a/lib/tzdata/zoneinfo/iso3166.tab b/lib/tzdata/zoneinfo/iso3166.tab
index 911af5e8..be3348d1 100644
--- a/lib/tzdata/zoneinfo/iso3166.tab
+++ b/lib/tzdata/zoneinfo/iso3166.tab
@@ -238,7 +238,7 @@ SY	Syria
 SZ	Eswatini (Swaziland)
 TC	Turks & Caicos Is
 TD	Chad
-TF	French Southern Territories
+TF	French S. Terr.
 TG	Togo
 TH	Thailand
 TJ	Tajikistan
diff --git a/lib/tzdata/zoneinfo/leapseconds b/lib/tzdata/zoneinfo/leapseconds
index 6826ac4a..a6a170aa 100644
--- a/lib/tzdata/zoneinfo/leapseconds
+++ b/lib/tzdata/zoneinfo/leapseconds
@@ -72,11 +72,11 @@ Leap	2016	Dec	31	23:59:60	+	S
 # Any additional leap seconds will come after this.
 # This Expires line is commented out for now,
 # so that pre-2020a zic implementations do not reject this file.
-#Expires 2023	Jun	28	00:00:00
+#Expires 2023	Dec	28	00:00:00
 
 # POSIX timestamps for the data in this file:
 #updated 1467936000 (2016-07-08 00:00:00 UTC)
-#expires 1687910400 (2023-06-28 00:00:00 UTC)
+#expires 1703721600 (2023-12-28 00:00:00 UTC)
 
-#	Updated through IERS Bulletin C64
-#	File expires on:  28 June 2023
+#	Updated through IERS Bulletin C65
+#	File expires on:  28 December 2023
diff --git a/lib/tzdata/zoneinfo/tzdata.zi b/lib/tzdata/zoneinfo/tzdata.zi
index 3db1460e..b522e395 100644
--- a/lib/tzdata/zoneinfo/tzdata.zi
+++ b/lib/tzdata/zoneinfo/tzdata.zi
@@ -1,4 +1,4 @@
-# version 2022g
+# version 2023c
 # This zic input file is in the public domain.
 R d 1916 o - Jun 14 23s 1 S
 R d 1916 1919 - O Su>=1 23s 0 -
@@ -75,6 +75,8 @@ R K 2014 o - May 15 24 1 S
 R K 2014 o - Jun 26 24 0 -
 R K 2014 o - Jul 31 24 1 S
 R K 2014 o - S lastTh 24 0 -
+R K 2023 ma - Ap lastF 0 1 S
+R K 2023 ma - O lastTh 24 0 -
 Z Africa/Cairo 2:5:9 - LMT 1900 O
 2 K EE%sT
 Z Africa/Bissau -1:2:20 - LMT 1912 Ja 1 1u
@@ -172,7 +174,7 @@ R M 2021 o - May 16 2 0 -
 R M 2022 o - Mar 27 3 -1 -
 R M 2022 o - May 8 2 0 -
 R M 2023 o - Mar 19 3 -1 -
-R M 2023 o - Ap 30 2 0 -
+R M 2023 o - Ap 23 2 0 -
 R M 2024 o - Mar 10 3 -1 -
 R M 2024 o - Ap 14 2 0 -
 R M 2025 o - F 23 3 -1 -
@@ -188,7 +190,7 @@ R M 2029 o - F 18 2 0 -
 R M 2029 o - D 30 3 -1 -
 R M 2030 o - F 10 2 0 -
 R M 2030 o - D 22 3 -1 -
-R M 2031 o - F 2 2 0 -
+R M 2031 o - Ja 26 2 0 -
 R M 2031 o - D 14 3 -1 -
 R M 2032 o - Ja 18 2 0 -
 R M 2032 o - N 28 3 -1 -
@@ -204,7 +206,7 @@ R M 2036 o - N 23 2 0 -
 R M 2037 o - O 4 3 -1 -
 R M 2037 o - N 15 2 0 -
 R M 2038 o - S 26 3 -1 -
-R M 2038 o - N 7 2 0 -
+R M 2038 o - O 31 2 0 -
 R M 2039 o - S 18 3 -1 -
 R M 2039 o - O 23 2 0 -
 R M 2040 o - S 2 3 -1 -
@@ -220,7 +222,7 @@ R M 2044 o - Au 28 2 0 -
 R M 2045 o - Jul 9 3 -1 -
 R M 2045 o - Au 20 2 0 -
 R M 2046 o - Jul 1 3 -1 -
-R M 2046 o - Au 12 2 0 -
+R M 2046 o - Au 5 2 0 -
 R M 2047 o - Jun 23 3 -1 -
 R M 2047 o - Jul 28 2 0 -
 R M 2048 o - Jun 7 3 -1 -
@@ -236,7 +238,7 @@ R M 2052 o - Jun 2 2 0 -
 R M 2053 o - Ap 13 3 -1 -
 R M 2053 o - May 25 2 0 -
 R M 2054 o - Ap 5 3 -1 -
-R M 2054 o - May 17 2 0 -
+R M 2054 o - May 10 2 0 -
 R M 2055 o - Mar 28 3 -1 -
 R M 2055 o - May 2 2 0 -
 R M 2056 o - Mar 12 3 -1 -
@@ -252,7 +254,7 @@ R M 2060 o - Mar 7 2 0 -
 R M 2061 o - Ja 16 3 -1 -
 R M 2061 o - F 27 2 0 -
 R M 2062 o - Ja 8 3 -1 -
-R M 2062 o - F 19 2 0 -
+R M 2062 o - F 12 2 0 -
 R M 2062 o - D 31 3 -1 -
 R M 2063 o - F 4 2 0 -
 R M 2063 o - D 16 3 -1 -
@@ -268,7 +270,7 @@ R M 2067 o - D 11 2 0 -
 R M 2068 o - O 21 3 -1 -
 R M 2068 o - D 2 2 0 -
 R M 2069 o - O 13 3 -1 -
-R M 2069 o - N 24 2 0 -
+R M 2069 o - N 17 2 0 -
 R M 2070 o - O 5 3 -1 -
 R M 2070 o - N 9 2 0 -
 R M 2071 o - S 20 3 -1 -
@@ -284,7 +286,7 @@ R M 2075 o - S 15 2 0 -
 R M 2076 o - Jul 26 3 -1 -
 R M 2076 o - S 6 2 0 -
 R M 2077 o - Jul 18 3 -1 -
-R M 2077 o - Au 29 2 0 -
+R M 2077 o - Au 22 2 0 -
 R M 2078 o - Jul 10 3 -1 -
 R M 2078 o - Au 14 2 0 -
 R M 2079 o - Jun 25 3 -1 -
@@ -294,13 +296,13 @@ R M 2080 o - Jul 21 2 0 -
 R M 2081 o - Jun 1 3 -1 -
 R M 2081 o - Jul 13 2 0 -
 R M 2082 o - May 24 3 -1 -
-R M 2082 o - Jul 5 2 0 -
+R M 2082 o - Jun 28 2 0 -
 R M 2083 o - May 16 3 -1 -
 R M 2083 o - Jun 20 2 0 -
 R M 2084 o - Ap 30 3 -1 -
 R M 2084 o - Jun 11 2 0 -
 R M 2085 o - Ap 22 3 -1 -
-R M 2085 o - Jun 3 2 0 -
+R M 2085 o - May 27 2 0 -
 R M 2086 o - Ap 14 3 -1 -
 R M 2086 o - May 19 2 0 -
 R M 2087 o - Mar 30 3 -1 -
@@ -997,8 +999,86 @@ R P 2020 2021 - Mar Sa<=30 0 1 S
 R P 2020 o - O 24 1 0 -
 R P 2021 o - O 29 1 0 -
 R P 2022 o - Mar 27 0 1 S
-R P 2022 ma - O Sa<=30 2 0 -
-R P 2023 ma - Mar Sa<=30 2 1 S
+R P 2022 2035 - O Sa<=30 2 0 -
+R P 2023 o - Ap 29 2 1 S
+R P 2024 o - Ap 13 2 1 S
+R P 2025 o - Ap 5 2 1 S
+R P 2026 2054 - Mar Sa<=30 2 1 S
+R P 2036 o - O 18 2 0 -
+R P 2037 o - O 10 2 0 -
+R P 2038 o - S 25 2 0 -
+R P 2039 o - S 17 2 0 -
+R P 2039 o - O 22 2 1 S
+R P 2039 2067 - O Sa<=30 2 0 -
+R P 2040 o - S 1 2 0 -
+R P 2040 o - O 13 2 1 S
+R P 2041 o - Au 24 2 0 -
+R P 2041 o - S 28 2 1 S
+R P 2042 o - Au 16 2 0 -
+R P 2042 o - S 20 2 1 S
+R P 2043 o - Au 1 2 0 -
+R P 2043 o - S 12 2 1 S
+R P 2044 o - Jul 23 2 0 -
+R P 2044 o - Au 27 2 1 S
+R P 2045 o - Jul 15 2 0 -
+R P 2045 o - Au 19 2 1 S
+R P 2046 o - Jun 30 2 0 -
+R P 2046 o - Au 11 2 1 S
+R P 2047 o - Jun 22 2 0 -
+R P 2047 o - Jul 27 2 1 S
+R P 2048 o - Jun 6 2 0 -
+R P 2048 o - Jul 18 2 1 S
+R P 2049 o - May 29 2 0 -
+R P 2049 o - Jul 3 2 1 S
+R P 2050 o - May 21 2 0 -
+R P 2050 o - Jun 25 2 1 S
+R P 2051 o - May 6 2 0 -
+R P 2051 o - Jun 17 2 1 S
+R P 2052 o - Ap 27 2 0 -
+R P 2052 o - Jun 1 2 1 S
+R P 2053 o - Ap 12 2 0 -
+R P 2053 o - May 24 2 1 S
+R P 2054 o - Ap 4 2 0 -
+R P 2054 o - May 16 2 1 S
+R P 2055 o - May 1 2 1 S
+R P 2056 o - Ap 22 2 1 S
+R P 2057 o - Ap 7 2 1 S
+R P 2058 ma - Mar Sa<=30 2 1 S
+R P 2068 o - O 20 2 0 -
+R P 2069 o - O 12 2 0 -
+R P 2070 o - O 4 2 0 -
+R P 2071 o - S 19 2 0 -
+R P 2072 o - S 10 2 0 -
+R P 2072 o - O 15 2 1 S
+R P 2073 o - S 2 2 0 -
+R P 2073 o - O 7 2 1 S
+R P 2074 o - Au 18 2 0 -
+R P 2074 o - S 29 2 1 S
+R P 2075 o - Au 10 2 0 -
+R P 2075 o - S 14 2 1 S
+R P 2075 ma - O Sa<=30 2 0 -
+R P 2076 o - Jul 25 2 0 -
+R P 2076 o - S 5 2 1 S
+R P 2077 o - Jul 17 2 0 -
+R P 2077 o - Au 28 2 1 S
+R P 2078 o - Jul 9 2 0 -
+R P 2078 o - Au 13 2 1 S
+R P 2079 o - Jun 24 2 0 -
+R P 2079 o - Au 5 2 1 S
+R P 2080 o - Jun 15 2 0 -
+R P 2080 o - Jul 20 2 1 S
+R P 2081 o - Jun 7 2 0 -
+R P 2081 o - Jul 12 2 1 S
+R P 2082 o - May 23 2 0 -
+R P 2082 o - Jul 4 2 1 S
+R P 2083 o - May 15 2 0 -
+R P 2083 o - Jun 19 2 1 S
+R P 2084 o - Ap 29 2 0 -
+R P 2084 o - Jun 10 2 1 S
+R P 2085 o - Ap 21 2 0 -
+R P 2085 o - Jun 2 2 1 S
+R P 2086 o - Ap 13 2 0 -
+R P 2086 o - May 18 2 1 S
 Z Asia/Gaza 2:17:52 - LMT 1900 O
 2 Z EET/EEST 1948 May 15
 2 K EE%sT 1967 Jun 5
@@ -1754,8 +1834,8 @@ Z America/Scoresbysund -1:27:52 - LMT 1916 Jul 28
 -1 E -01/+00
 Z America/Nuuk -3:26:56 - LMT 1916 Jul 28
 -3 - -03 1980 Ap 6 2
--3 E -03/-02 2023 Mar 25 22
--2 - -02
+-3 E -03/-02 2023 O 29 1u
+-2 E -02/-01
 Z America/Thule -4:35:8 - LMT 1916 Jul 28
 -4 Th A%sT
 Z Europe/Tallinn 1:39 - LMT 1880
@@ -2175,13 +2255,13 @@ Z Europe/Volgograd 2:57:40 - LMT 1920 Ja 3
 3 - +03 1930 Jun 21
 4 - +04 1961 N 11
 4 R +04/+05 1988 Mar 27 2s
-3 R +03/+04 1991 Mar 31 2s
+3 R MSK/MSD 1991 Mar 31 2s
 4 - +04 1992 Mar 29 2s
-3 R +03/+04 2011 Mar 27 2s
-4 - +04 2014 O 26 2s
-3 - +03 2018 O 28 2s
+3 R MSK/MSD 2011 Mar 27 2s
+4 - MSK 2014 O 26 2s
+3 - MSK 2018 O 28 2s
 4 - +04 2020 D 27 2s
-3 - +03
+3 - MSK
 Z Europe/Saratov 3:4:18 - LMT 1919 Jul 1 0u
 3 - +03 1930 Jun 21
 4 R +04/+05 1988 Mar 27 2s
@@ -2194,11 +2274,11 @@ Z Europe/Saratov 3:4:18 - LMT 1919 Jul 1 0u
 Z Europe/Kirov 3:18:48 - LMT 1919 Jul 1 0u
 3 - +03 1930 Jun 21
 4 R +04/+05 1989 Mar 26 2s
-3 R +03/+04 1991 Mar 31 2s
+3 R MSK/MSD 1991 Mar 31 2s
 4 - +04 1992 Mar 29 2s
-3 R +03/+04 2011 Mar 27 2s
-4 - +04 2014 O 26 2s
-3 - +03
+3 R MSK/MSD 2011 Mar 27 2s
+4 - MSK 2014 O 26 2s
+3 - MSK
 Z Europe/Samara 3:20:20 - LMT 1919 Jul 1 0u
 3 - +03 1930 Jun 21
 4 - +04 1935 Ja 27
@@ -3070,9 +3150,6 @@ Z America/Cambridge_Bay 0 - -00 1920
 -5 - EST 2000 N 5
 -6 - CST 2001 Ap 1 3
 -7 C M%sT
-Z America/Yellowknife 0 - -00 1935
--7 Y M%sT 1980
--7 C M%sT
 Z America/Inuvik 0 - -00 1953
 -8 Y P%sT 1979 Ap lastSu 2
 -7 Y M%sT 1980
@@ -4171,6 +4248,7 @@ L America/Argentina/Cordoba America/Rosario
 L America/Tijuana America/Santa_Isabel
 L America/Denver America/Shiprock
 L America/Toronto America/Thunder_Bay
+L America/Edmonton America/Yellowknife
 L Pacific/Auckland Antarctica/South_Pole
 L Asia/Shanghai Asia/Chongqing
 L Asia/Shanghai Asia/Harbin
diff --git a/lib/tzdata/zoneinfo/zone.tab b/lib/tzdata/zoneinfo/zone.tab
index 6e5adb9f..dbcb6179 100644
--- a/lib/tzdata/zoneinfo/zone.tab
+++ b/lib/tzdata/zoneinfo/zone.tab
@@ -121,9 +121,8 @@ CA	+744144-0944945	America/Resolute	Central - NU (Resolute)
 CA	+624900-0920459	America/Rankin_Inlet	Central - NU (central)
 CA	+5024-10439	America/Regina	CST - SK (most areas)
 CA	+5017-10750	America/Swift_Current	CST - SK (midwest)
-CA	+5333-11328	America/Edmonton	Mountain - AB; BC (E); SK (W)
+CA	+5333-11328	America/Edmonton	Mountain - AB; BC (E); NT (E); SK (W)
 CA	+690650-1050310	America/Cambridge_Bay	Mountain - NU (west)
-CA	+6227-11421	America/Yellowknife	Mountain - NT (central)
 CA	+682059-1334300	America/Inuvik	Mountain - NT (west)
 CA	+4906-11631	America/Creston	MST - BC (Creston)
 CA	+5546-12014	America/Dawson_Creek	MST - BC (Dawson Cr, Ft St John)
@@ -139,7 +138,7 @@ CG	-0416+01517	Africa/Brazzaville
 CH	+4723+00832	Europe/Zurich
 CI	+0519-00402	Africa/Abidjan
 CK	-2114-15946	Pacific/Rarotonga
-CL	-3327-07040	America/Santiago	Chile (most areas)
+CL	-3327-07040	America/Santiago	most of Chile
 CL	-5309-07055	America/Punta_Arenas	Region of Magallanes
 CL	-2709-10926	Pacific/Easter	Easter Island
 CM	+0403+00942	Africa/Douala
@@ -151,10 +150,10 @@ CU	+2308-08222	America/Havana
 CV	+1455-02331	Atlantic/Cape_Verde
 CW	+1211-06900	America/Curacao
 CX	-1025+10543	Indian/Christmas
-CY	+3510+03322	Asia/Nicosia	Cyprus (most areas)
+CY	+3510+03322	Asia/Nicosia	most of Cyprus
 CY	+3507+03357	Asia/Famagusta	Northern Cyprus
 CZ	+5005+01426	Europe/Prague
-DE	+5230+01322	Europe/Berlin	Germany (most areas)
+DE	+5230+01322	Europe/Berlin	most of Germany
 DE	+4742+00841	Europe/Busingen	Busingen
 DJ	+1136+04309	Africa/Djibouti
 DK	+5540+01235	Europe/Copenhagen
@@ -187,7 +186,7 @@ GF	+0456-05220	America/Cayenne
 GG	+492717-0023210	Europe/Guernsey
 GH	+0533-00013	Africa/Accra
 GI	+3608-00521	Europe/Gibraltar
-GL	+6411-05144	America/Nuuk	Greenland (most areas)
+GL	+6411-05144	America/Nuuk	most of Greenland
 GL	+7646-01840	America/Danmarkshavn	National Park (east coast)
 GL	+7029-02158	America/Scoresbysund	Scoresbysund/Ittoqqortoormiit
 GL	+7634-06847	America/Thule	Thule/Pituffik
@@ -235,7 +234,7 @@ KP	+3901+12545	Asia/Pyongyang
 KR	+3733+12658	Asia/Seoul
 KW	+2920+04759	Asia/Kuwait
 KY	+1918-08123	America/Cayman
-KZ	+4315+07657	Asia/Almaty	Kazakhstan (most areas)
+KZ	+4315+07657	Asia/Almaty	most of Kazakhstan
 KZ	+4448+06528	Asia/Qyzylorda	Qyzylorda/Kyzylorda/Kzyl-Orda
 KZ	+5312+06337	Asia/Qostanay	Qostanay/Kostanay/Kustanay
 KZ	+5017+05710	Asia/Aqtobe	Aqtobe/Aktobe
@@ -259,12 +258,12 @@ MD	+4700+02850	Europe/Chisinau
 ME	+4226+01916	Europe/Podgorica
 MF	+1804-06305	America/Marigot
 MG	-1855+04731	Indian/Antananarivo
-MH	+0709+17112	Pacific/Majuro	Marshall Islands (most areas)
+MH	+0709+17112	Pacific/Majuro	most of Marshall Islands
 MH	+0905+16720	Pacific/Kwajalein	Kwajalein
 MK	+4159+02126	Europe/Skopje
 ML	+1239-00800	Africa/Bamako
 MM	+1647+09610	Asia/Yangon
-MN	+4755+10653	Asia/Ulaanbaatar	Mongolia (most areas)
+MN	+4755+10653	Asia/Ulaanbaatar	most of Mongolia
 MN	+4801+09139	Asia/Hovd	Bayan-Olgiy, Govi-Altai, Hovd, Uvs, Zavkhan
 MN	+4804+11430	Asia/Choibalsan	Dornod, Sukhbaatar
 MO	+221150+1133230	Asia/Macau
@@ -302,7 +301,7 @@ NO	+5955+01045	Europe/Oslo
 NP	+2743+08519	Asia/Kathmandu
 NR	-0031+16655	Pacific/Nauru
 NU	-1901-16955	Pacific/Niue
-NZ	-3652+17446	Pacific/Auckland	New Zealand (most areas)
+NZ	-3652+17446	Pacific/Auckland	most of New Zealand
 NZ	-4357-17633	Pacific/Chatham	Chatham Islands
 OM	+2336+05835	Asia/Muscat
 PA	+0858-07932	America/Panama
@@ -310,7 +309,7 @@ PE	-1203-07703	America/Lima
 PF	-1732-14934	Pacific/Tahiti	Society Islands
 PF	-0900-13930	Pacific/Marquesas	Marquesas Islands
 PF	-2308-13457	Pacific/Gambier	Gambier Islands
-PG	-0930+14710	Pacific/Port_Moresby	Papua New Guinea (most areas)
+PG	-0930+14710	Pacific/Port_Moresby	most of Papua New Guinea
 PG	-0613+15534	Pacific/Bougainville	Bougainville
 PH	+1435+12100	Asia/Manila
 PK	+2452+06703	Asia/Karachi
@@ -356,7 +355,7 @@ RU	+4310+13156	Asia/Vladivostok	MSK+07 - Amur River
 RU	+643337+1431336	Asia/Ust-Nera	MSK+07 - Oymyakonsky
 RU	+5934+15048	Asia/Magadan	MSK+08 - Magadan
 RU	+4658+14242	Asia/Sakhalin	MSK+08 - Sakhalin Island
-RU	+6728+15343	Asia/Srednekolymsk	MSK+08 - Sakha (E); North Kuril Is
+RU	+6728+15343	Asia/Srednekolymsk	MSK+08 - Sakha (E); N Kuril Is
 RU	+5301+15839	Asia/Kamchatka	MSK+09 - Kamchatka
 RU	+6445+17729	Asia/Anadyr	MSK+09 - Bering Sea
 RW	-0157+03004	Africa/Kigali
@@ -397,7 +396,7 @@ TT	+1039-06131	America/Port_of_Spain
 TV	-0831+17913	Pacific/Funafuti
 TW	+2503+12130	Asia/Taipei
 TZ	-0648+03917	Africa/Dar_es_Salaam
-UA	+5026+03031	Europe/Kyiv	Ukraine (most areas)
+UA	+5026+03031	Europe/Kyiv	most of Ukraine
 UG	+0019+03225	Africa/Kampala
 UM	+2813-17722	Pacific/Midway	Midway Islands
 UM	+1917+16637	Pacific/Wake	Wake Island
@@ -420,7 +419,7 @@ US	+465042-1012439	America/North_Dakota/New_Salem	Central - ND (Morton rural)
 US	+471551-1014640	America/North_Dakota/Beulah	Central - ND (Mercer)
 US	+394421-1045903	America/Denver	Mountain (most areas)
 US	+433649-1161209	America/Boise	Mountain - ID (south); OR (east)
-US	+332654-1120424	America/Phoenix	MST - Arizona (except Navajo)
+US	+332654-1120424	America/Phoenix	MST - AZ (except Navajo)
 US	+340308-1181434	America/Los_Angeles	Pacific
 US	+611305-1495401	America/Anchorage	Alaska (most areas)
 US	+581807-1342511	America/Juneau	Alaska - Juneau area
@@ -428,7 +427,7 @@ US	+571035-1351807	America/Sitka	Alaska - Sitka area
 US	+550737-1313435	America/Metlakatla	Alaska - Annette Island
 US	+593249-1394338	America/Yakutat	Alaska - Yakutat
 US	+643004-1652423	America/Nome	Alaska (west)
-US	+515248-1763929	America/Adak	Aleutian Islands
+US	+515248-1763929	America/Adak	Alaska - western Aleutians
 US	+211825-1575130	Pacific/Honolulu	Hawaii
 UY	-345433-0561245	America/Montevideo
 UZ	+3940+06648	Asia/Samarkand	Uzbekistan (west)
diff --git a/lib/tzdata/zoneinfo/zone1970.tab b/lib/tzdata/zoneinfo/zone1970.tab
index a9b36d36..1f1cecb8 100644
--- a/lib/tzdata/zoneinfo/zone1970.tab
+++ b/lib/tzdata/zoneinfo/zone1970.tab
@@ -18,7 +18,10 @@
 #     Please see the theory.html file for how these names are chosen.
 #     If multiple timezones overlap a country, each has a row in the
 #     table, with each column 1 containing the country code.
-# 4.  Comments; present if and only if a country has multiple timezones.
+# 4.  Comments; present if and only if countries have multiple timezones,
+#     and useful only for those countries.  For example, the comments
+#     for the row with countries CH,DE,LI and name Europe/Zurich
+#     are useful only for DE, since CH and LI have no other timezones.
 #
 # If a timezone covers multiple countries, the most-populous city is used,
 # and that country is listed first in column 1; any other countries
@@ -34,7 +37,7 @@
 #country-
 #codes	coordinates	TZ	comments
 AD	+4230+00131	Europe/Andorra
-AE,OM,RE,SC,TF	+2518+05518	Asia/Dubai	UAE, Oman, Réunion, Seychelles, Crozet, Scattered Is
+AE,OM,RE,SC,TF	+2518+05518	Asia/Dubai	Crozet, Scattered Is
 AF	+3431+06912	Asia/Kabul
 AL	+4120+01950	Europe/Tirane
 AM	+4011+04430	Asia/Yerevan
@@ -45,7 +48,7 @@ AQ	-6448-06406	Antarctica/Palmer	Palmer
 AQ	-6734-06808	Antarctica/Rothera	Rothera
 AQ	-720041+0023206	Antarctica/Troll	Troll
 AR	-3436-05827	America/Argentina/Buenos_Aires	Buenos Aires (BA, CF)
-AR	-3124-06411	America/Argentina/Cordoba	Argentina (most areas: CB, CC, CN, ER, FM, MN, SE, SF)
+AR	-3124-06411	America/Argentina/Cordoba	most areas: CB, CC, CN, ER, FM, MN, SE, SF
 AR	-2447-06525	America/Argentina/Salta	Salta (SA, LP, NQ, RN)
 AR	-2411-06518	America/Argentina/Jujuy	Jujuy (JY)
 AR	-2649-06513	America/Argentina/Tucuman	Tucumán (TM)
@@ -56,7 +59,7 @@ AR	-3253-06849	America/Argentina/Mendoza	Mendoza (MZ)
 AR	-3319-06621	America/Argentina/San_Luis	San Luis (SL)
 AR	-5138-06913	America/Argentina/Rio_Gallegos	Santa Cruz (SC)
 AR	-5448-06818	America/Argentina/Ushuaia	Tierra del Fuego (TF)
-AS,UM	-1416-17042	Pacific/Pago_Pago	Samoa, Midway
+AS,UM	-1416-17042	Pacific/Pago_Pago	Midway
 AT	+4813+01620	Europe/Vienna
 AU	-3133+15905	Australia/Lord_Howe	Lord Howe Island
 AU	-5430+15857	Antarctica/Macquarie	Macquarie Island
@@ -101,26 +104,25 @@ CA	+4439-06336	America/Halifax	Atlantic - NS (most areas); PE
 CA	+4612-05957	America/Glace_Bay	Atlantic - NS (Cape Breton)
 CA	+4606-06447	America/Moncton	Atlantic - New Brunswick
 CA	+5320-06025	America/Goose_Bay	Atlantic - Labrador (most areas)
-CA,BS	+4339-07923	America/Toronto	Eastern - ON, QC (most areas), Bahamas
+CA,BS	+4339-07923	America/Toronto	Eastern - ON, QC (most areas)
 CA	+6344-06828	America/Iqaluit	Eastern - NU (most areas)
 CA	+4953-09709	America/Winnipeg	Central - ON (west); Manitoba
 CA	+744144-0944945	America/Resolute	Central - NU (Resolute)
 CA	+624900-0920459	America/Rankin_Inlet	Central - NU (central)
 CA	+5024-10439	America/Regina	CST - SK (most areas)
 CA	+5017-10750	America/Swift_Current	CST - SK (midwest)
-CA	+5333-11328	America/Edmonton	Mountain - AB; BC (E); SK (W)
+CA	+5333-11328	America/Edmonton	Mountain - AB; BC (E); NT (E); SK (W)
 CA	+690650-1050310	America/Cambridge_Bay	Mountain - NU (west)
-CA	+6227-11421	America/Yellowknife	Mountain - NT (central)
 CA	+682059-1334300	America/Inuvik	Mountain - NT (west)
 CA	+5546-12014	America/Dawson_Creek	MST - BC (Dawson Cr, Ft St John)
 CA	+5848-12242	America/Fort_Nelson	MST - BC (Ft Nelson)
 CA	+6043-13503	America/Whitehorse	MST - Yukon (east)
 CA	+6404-13925	America/Dawson	MST - Yukon (west)
 CA	+4916-12307	America/Vancouver	Pacific - BC (most areas)
-CH,DE,LI	+4723+00832	Europe/Zurich	Swiss time
+CH,DE,LI	+4723+00832	Europe/Zurich	Büsingen
 CI,BF,GH,GM,GN,IS,ML,MR,SH,SL,SN,TG	+0519-00402	Africa/Abidjan
 CK	-2114-15946	Pacific/Rarotonga
-CL	-3327-07040	America/Santiago	Chile (most areas)
+CL	-3327-07040	America/Santiago	most of Chile
 CL	-5309-07055	America/Punta_Arenas	Region of Magallanes
 CL	-2709-10926	Pacific/Easter	Easter Island
 CN	+3114+12128	Asia/Shanghai	Beijing Time
@@ -129,10 +131,10 @@ CO	+0436-07405	America/Bogota
 CR	+0956-08405	America/Costa_Rica
 CU	+2308-08222	America/Havana
 CV	+1455-02331	Atlantic/Cape_Verde
-CY	+3510+03322	Asia/Nicosia	Cyprus (most areas)
+CY	+3510+03322	Asia/Nicosia	most of Cyprus
 CY	+3507+03357	Asia/Famagusta	Northern Cyprus
 CZ,SK	+5005+01426	Europe/Prague
-DE,DK,NO,SE,SJ	+5230+01322	Europe/Berlin	Germany (most areas), Scandinavia
+DE,DK,NO,SE,SJ	+5230+01322	Europe/Berlin	most of Germany
 DO	+1828-06954	America/Santo_Domingo
 DZ	+3647+00303	Africa/Algiers
 EC	-0210-07950	America/Guayaquil	Ecuador (mainland)
@@ -153,7 +155,7 @@ GB,GG,IM,JE	+513030-0000731	Europe/London
 GE	+4143+04449	Asia/Tbilisi
 GF	+0456-05220	America/Cayenne
 GI	+3608-00521	Europe/Gibraltar
-GL	+6411-05144	America/Nuuk	Greenland (most areas)
+GL	+6411-05144	America/Nuuk	most of Greenland
 GL	+7646-01840	America/Danmarkshavn	National Park (east coast)
 GL	+7029-02158	America/Scoresbysund	Scoresbysund/Ittoqqortoormiit
 GL	+7634-06847	America/Thule	Thule/Pituffik
@@ -183,12 +185,12 @@ JO	+3157+03556	Asia/Amman
 JP	+353916+1394441	Asia/Tokyo
 KE,DJ,ER,ET,KM,MG,SO,TZ,UG,YT	-0117+03649	Africa/Nairobi
 KG	+4254+07436	Asia/Bishkek
-KI,MH,TV,UM,WF	+0125+17300	Pacific/Tarawa	Gilberts, Marshalls, Tuvalu, Wallis & Futuna, Wake
+KI,MH,TV,UM,WF	+0125+17300	Pacific/Tarawa	Gilberts, Marshalls, Wake
 KI	-0247-17143	Pacific/Kanton	Phoenix Islands
 KI	+0152-15720	Pacific/Kiritimati	Line Islands
 KP	+3901+12545	Asia/Pyongyang
 KR	+3733+12658	Asia/Seoul
-KZ	+4315+07657	Asia/Almaty	Kazakhstan (most areas)
+KZ	+4315+07657	Asia/Almaty	most of Kazakhstan
 KZ	+4448+06528	Asia/Qyzylorda	Qyzylorda/Kyzylorda/Kzyl-Orda
 KZ	+5312+06337	Asia/Qostanay	Qostanay/Kostanay/Kustanay
 KZ	+5017+05710	Asia/Aqtobe	Aqtöbe/Aktobe
@@ -205,14 +207,14 @@ MA	+3339-00735	Africa/Casablanca
 MD	+4700+02850	Europe/Chisinau
 MH	+0905+16720	Pacific/Kwajalein	Kwajalein
 MM,CC	+1647+09610	Asia/Yangon
-MN	+4755+10653	Asia/Ulaanbaatar	Mongolia (most areas)
+MN	+4755+10653	Asia/Ulaanbaatar	most of Mongolia
 MN	+4801+09139	Asia/Hovd	Bayan-Ölgii, Govi-Altai, Hovd, Uvs, Zavkhan
 MN	+4804+11430	Asia/Choibalsan	Dornod, Sükhbaatar
 MO	+221150+1133230	Asia/Macau
 MQ	+1436-06105	America/Martinique
 MT	+3554+01431	Europe/Malta
 MU	-2010+05730	Indian/Mauritius
-MV,TF	+0410+07330	Indian/Maldives	Maldives, Kerguelen, St Paul I, Amsterdam I
+MV,TF	+0410+07330	Indian/Maldives	Kerguelen, St Paul I, Amsterdam I
 MX	+1924-09909	America/Mexico_City	Central Mexico
 MX	+2105-08646	America/Cancun	Quintana Roo
 MX	+2058-08937	America/Merida	Campeche, Yucatán
@@ -225,7 +227,7 @@ MX	+2313-10625	America/Mazatlan	Baja California Sur, Nayarit (most areas), Sinal
 MX	+2048-10515	America/Bahia_Banderas	Bahía de Banderas
 MX	+2904-11058	America/Hermosillo	Sonora
 MX	+3232-11701	America/Tijuana	Baja California
-MY,BN	+0133+11020	Asia/Kuching	Sabah, Sarawak, Brunei
+MY,BN	+0133+11020	Asia/Kuching	Sabah, Sarawak
 MZ,BI,BW,CD,MW,RW,ZM,ZW	-2558+03235	Africa/Maputo	Central Africa Time
 NA	-2234+01706	Africa/Windhoek
 NC	-2216+16627	Pacific/Noumea
@@ -237,7 +239,7 @@ NR	-0031+16655	Pacific/Nauru
 NU	-1901-16955	Pacific/Niue
 NZ,AQ	-3652+17446	Pacific/Auckland	New Zealand time
 NZ	-4357-17633	Pacific/Chatham	Chatham Islands
-PA,CA,KY	+0858-07932	America/Panama	EST - Panama, Cayman, ON (Atikokan), NU (Coral H)
+PA,CA,KY	+0858-07932	America/Panama	EST - ON (Atikokan), NU (Coral H)
 PE	-1203-07703	America/Lima
 PF	-1732-14934	Pacific/Tahiti	Society Islands
 PF	-0900-13930	Pacific/Marquesas	Marquesas Islands
@@ -285,13 +287,13 @@ RU	+4310+13156	Asia/Vladivostok	MSK+07 - Amur River
 RU	+643337+1431336	Asia/Ust-Nera	MSK+07 - Oymyakonsky
 RU	+5934+15048	Asia/Magadan	MSK+08 - Magadan
 RU	+4658+14242	Asia/Sakhalin	MSK+08 - Sakhalin Island
-RU	+6728+15343	Asia/Srednekolymsk	MSK+08 - Sakha (E); North Kuril Is
+RU	+6728+15343	Asia/Srednekolymsk	MSK+08 - Sakha (E); N Kuril Is
 RU	+5301+15839	Asia/Kamchatka	MSK+09 - Kamchatka
 RU	+6445+17729	Asia/Anadyr	MSK+09 - Bering Sea
-SA,AQ,KW,YE	+2438+04643	Asia/Riyadh	Arabia, Syowa
-SB,FM	-0932+16012	Pacific/Guadalcanal	Solomons, Pohnpei
+SA,AQ,KW,YE	+2438+04643	Asia/Riyadh	Syowa
+SB,FM	-0932+16012	Pacific/Guadalcanal	Pohnpei
 SD	+1536+03232	Africa/Khartoum
-SG,MY	+0117+10351	Asia/Singapore	Singapore, peninsular Malaysia
+SG,MY	+0117+10351	Asia/Singapore	peninsular Malaysia
 SR	+0550-05510	America/Paramaribo
 SS	+0451+03137	Africa/Juba
 ST	+0020+00644	Africa/Sao_Tome
@@ -299,7 +301,7 @@ SV	+1342-08912	America/El_Salvador
 SY	+3330+03618	Asia/Damascus
 TC	+2128-07108	America/Grand_Turk
 TD	+1207+01503	Africa/Ndjamena
-TH,CX,KH,LA,VN	+1345+10031	Asia/Bangkok	Indochina (most areas)
+TH,CX,KH,LA,VN	+1345+10031	Asia/Bangkok	north Vietnam
 TJ	+3835+06848	Asia/Dushanbe
 TK	-0922-17114	Pacific/Fakaofo
 TL	-0833+12535	Asia/Dili
@@ -308,7 +310,7 @@ TN	+3648+01011	Africa/Tunis
 TO	-210800-1751200	Pacific/Tongatapu
 TR	+4101+02858	Europe/Istanbul
 TW	+2503+12130	Asia/Taipei
-UA	+5026+03031	Europe/Kyiv	Ukraine (most areas)
+UA	+5026+03031	Europe/Kyiv	most of Ukraine
 US	+404251-0740023	America/New_York	Eastern (most areas)
 US	+421953-0830245	America/Detroit	Eastern - MI (most areas)
 US	+381515-0854534	America/Kentucky/Louisville	Eastern - KY (Louisville area)
@@ -328,7 +330,7 @@ US	+465042-1012439	America/North_Dakota/New_Salem	Central - ND (Morton rural)
 US	+471551-1014640	America/North_Dakota/Beulah	Central - ND (Mercer)
 US	+394421-1045903	America/Denver	Mountain (most areas)
 US	+433649-1161209	America/Boise	Mountain - ID (south); OR (east)
-US,CA	+332654-1120424	America/Phoenix	MST - Arizona (except Navajo), Creston BC
+US,CA	+332654-1120424	America/Phoenix	MST - AZ (most areas), Creston BC
 US	+340308-1181434	America/Los_Angeles	Pacific
 US	+611305-1495401	America/Anchorage	Alaska (most areas)
 US	+581807-1342511	America/Juneau	Alaska - Juneau area
@@ -336,13 +338,13 @@ US	+571035-1351807	America/Sitka	Alaska - Sitka area
 US	+550737-1313435	America/Metlakatla	Alaska - Annette Island
 US	+593249-1394338	America/Yakutat	Alaska - Yakutat
 US	+643004-1652423	America/Nome	Alaska (west)
-US	+515248-1763929	America/Adak	Aleutian Islands
-US,UM	+211825-1575130	Pacific/Honolulu	Hawaii
+US	+515248-1763929	America/Adak	Alaska - western Aleutians
+US	+211825-1575130	Pacific/Honolulu	Hawaii
 UY	-345433-0561245	America/Montevideo
 UZ	+3940+06648	Asia/Samarkand	Uzbekistan (west)
 UZ	+4120+06918	Asia/Tashkent	Uzbekistan (east)
 VE	+1030-06656	America/Caracas
-VN	+1045+10640	Asia/Ho_Chi_Minh	Vietnam (south)
+VN	+1045+10640	Asia/Ho_Chi_Minh	south Vietnam
 VU	-1740+16825	Pacific/Efate
 WS	-1350-17144	Pacific/Apia
 ZA,LS,SZ	-2615+02800	Africa/Johannesburg
diff --git a/lib/tzdata/zones b/lib/tzdata/zones
index 8d9892ed..9300ebb0 100644
--- a/lib/tzdata/zones
+++ b/lib/tzdata/zones
@@ -243,7 +243,6 @@ America/Iqaluit
 America/Resolute
 America/Rankin_Inlet
 America/Cambridge_Bay
-America/Yellowknife
 America/Inuvik
 America/Whitehorse
 America/Dawson
@@ -561,6 +560,7 @@ America/Rosario
 America/Santa_Isabel
 America/Shiprock
 America/Thunder_Bay
+America/Yellowknife
 Antarctica/South_Pole
 Asia/Chongqing
 Asia/Harbin
diff --git a/requirements.txt b/requirements.txt
index 00e17bde..55053413 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -44,7 +44,7 @@ six==1.16.0
 soupsieve==2.4
 tempora==5.2.1
 tokenize-rt==5.0.0
-tzdata==2022.7
+tzdata==2023.3
 tzlocal==4.2
 urllib3==1.26.15
 webencodings==0.5.1

From 1798594569686658df7a1418af032332efb30be6 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 23 Aug 2023 21:38:39 -0700
Subject: [PATCH 423/743] Bump simplejson from 3.18.3 to 3.19.1 (#2036)

* Bump simplejson from 3.18.3 to 3.19.1

Bumps [simplejson](https://github.com/simplejson/simplejson) from 3.18.3 to 3.19.1.
- [Release notes](https://github.com/simplejson/simplejson/releases)
- [Changelog](https://github.com/simplejson/simplejson/blob/master/CHANGES.txt)
- [Commits](https://github.com/simplejson/simplejson/compare/v3.18.3...v3.19.1)

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

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

* Update simplejson==3.19.1

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/simplejson/__init__.py              | 106 ++++++++++--------------
 lib/simplejson/decoder.py               |  82 ++++++++++--------
 lib/simplejson/encoder.py               |  30 +++----
 lib/simplejson/scanner.py               |   6 +-
 lib/simplejson/tests/test_decode.py     |   8 ++
 lib/simplejson/tests/test_fail.py       |   4 +-
 lib/simplejson/tests/test_float.py      |   7 +-
 lib/simplejson/tests/test_scanstring.py |   4 +-
 requirements.txt                        |   2 +-
 9 files changed, 128 insertions(+), 121 deletions(-)

diff --git a/lib/simplejson/__init__.py b/lib/simplejson/__init__.py
index 993d64d3..7e533a24 100644
--- a/lib/simplejson/__init__.py
+++ b/lib/simplejson/__init__.py
@@ -118,7 +118,7 @@ Serializing multiple objects to JSON lines (newline-delimited JSON)::
 
 """
 from __future__ import absolute_import
-__version__ = '3.18.3'
+__version__ = '3.19.1'
 __all__ = [
     'dump', 'dumps', 'load', 'loads',
     'JSONDecoder', 'JSONDecodeError', 'JSONEncoder',
@@ -149,28 +149,10 @@ def _import_c_make_encoder():
     except ImportError:
         return None
 
-_default_encoder = JSONEncoder(
-    skipkeys=False,
-    ensure_ascii=True,
-    check_circular=True,
-    allow_nan=True,
-    indent=None,
-    separators=None,
-    encoding='utf-8',
-    default=None,
-    use_decimal=True,
-    namedtuple_as_object=True,
-    tuple_as_array=True,
-    iterable_as_array=False,
-    bigint_as_string=False,
-    item_sort_key=None,
-    for_json=False,
-    ignore_nan=False,
-    int_as_string_bitcount=None,
-)
+_default_encoder = JSONEncoder()
 
 def dump(obj, fp, skipkeys=False, ensure_ascii=True, check_circular=True,
-         allow_nan=True, cls=None, indent=None, separators=None,
+         allow_nan=False, cls=None, indent=None, separators=None,
          encoding='utf-8', default=None, use_decimal=True,
          namedtuple_as_object=True, tuple_as_array=True,
          bigint_as_string=False, sort_keys=False, item_sort_key=None,
@@ -187,10 +169,10 @@ def dump(obj, fp, skipkeys=False, ensure_ascii=True, check_circular=True,
     contain non-ASCII characters, so long as they do not need to be escaped
     by JSON. When it is true, all non-ASCII characters are escaped.
 
-    If *allow_nan* is false, then it will be a ``ValueError`` to
-    serialize out of range ``float`` values (``nan``, ``inf``, ``-inf``)
-    in strict compliance of the original JSON specification, instead of using
-    the JavaScript equivalents (``NaN``, ``Infinity``, ``-Infinity``). See
+    If *allow_nan* is true (default: ``False``), then out of range ``float``
+    values (``nan``, ``inf``, ``-inf``) will be serialized to
+    their JavaScript equivalents (``NaN``, ``Infinity``, ``-Infinity``)
+    instead of raising a ValueError. See
     *ignore_nan* for ECMA-262 compliant behavior.
 
     If *indent* is a string, then JSON array elements and object members
@@ -258,7 +240,7 @@ def dump(obj, fp, skipkeys=False, ensure_ascii=True, check_circular=True,
     """
     # cached encoder
     if (not skipkeys and ensure_ascii and
-        check_circular and allow_nan and
+        check_circular and not allow_nan and
         cls is None and indent is None and separators is None and
         encoding == 'utf-8' and default is None and use_decimal
         and namedtuple_as_object and tuple_as_array and not iterable_as_array
@@ -292,7 +274,7 @@ def dump(obj, fp, skipkeys=False, ensure_ascii=True, check_circular=True,
 
 
 def dumps(obj, skipkeys=False, ensure_ascii=True, check_circular=True,
-          allow_nan=True, cls=None, indent=None, separators=None,
+          allow_nan=False, cls=None, indent=None, separators=None,
           encoding='utf-8', default=None, use_decimal=True,
           namedtuple_as_object=True, tuple_as_array=True,
           bigint_as_string=False, sort_keys=False, item_sort_key=None,
@@ -312,10 +294,11 @@ def dumps(obj, skipkeys=False, ensure_ascii=True, check_circular=True,
     for container types will be skipped and a circular reference will
     result in an ``OverflowError`` (or worse).
 
-    If ``allow_nan`` is false, then it will be a ``ValueError`` to
-    serialize out of range ``float`` values (``nan``, ``inf``, ``-inf``) in
-    strict compliance of the JSON specification, instead of using the
-    JavaScript equivalents (``NaN``, ``Infinity``, ``-Infinity``).
+    If *allow_nan* is true (default: ``False``), then out of range ``float``
+    values (``nan``, ``inf``, ``-inf``) will be serialized to
+    their JavaScript equivalents (``NaN``, ``Infinity``, ``-Infinity``)
+    instead of raising a ValueError. See
+    *ignore_nan* for ECMA-262 compliant behavior.
 
     If ``indent`` is a string, then JSON array elements and object members
     will be pretty-printed with a newline followed by that string repeated
@@ -383,7 +366,7 @@ def dumps(obj, skipkeys=False, ensure_ascii=True, check_circular=True,
     """
     # cached encoder
     if (not skipkeys and ensure_ascii and
-        check_circular and allow_nan and
+        check_circular and not allow_nan and
         cls is None and indent is None and separators is None and
         encoding == 'utf-8' and default is None and use_decimal
         and namedtuple_as_object and tuple_as_array and not iterable_as_array
@@ -412,14 +395,12 @@ def dumps(obj, skipkeys=False, ensure_ascii=True, check_circular=True,
         **kw).encode(obj)
 
 
-_default_decoder = JSONDecoder(encoding=None, object_hook=None,
-                               object_pairs_hook=None)
+_default_decoder = JSONDecoder()
 
 
 def load(fp, encoding=None, cls=None, object_hook=None, parse_float=None,
         parse_int=None, parse_constant=None, object_pairs_hook=None,
-        use_decimal=False, namedtuple_as_object=True, tuple_as_array=True,
-        **kw):
+        use_decimal=False, allow_nan=False, **kw):
     """Deserialize ``fp`` (a ``.read()``-supporting file-like object containing
     a JSON document as `str` or `bytes`) to a Python object.
 
@@ -442,23 +423,27 @@ def load(fp, encoding=None, cls=None, object_hook=None, parse_float=None,
     takes priority.
 
     *parse_float*, if specified, will be called with the string of every
-    JSON float to be decoded.  By default, this is equivalent to
+    JSON float to be decoded. By default, this is equivalent to
     ``float(num_str)``. This can be used to use another datatype or parser
     for JSON floats (e.g. :class:`decimal.Decimal`).
 
     *parse_int*, if specified, will be called with the string of every
-    JSON int to be decoded.  By default, this is equivalent to
+    JSON int to be decoded. By default, this is equivalent to
     ``int(num_str)``.  This can be used to use another datatype or parser
     for JSON integers (e.g. :class:`float`).
 
-    *parse_constant*, if specified, will be called with one of the
-    following strings: ``'-Infinity'``, ``'Infinity'``, ``'NaN'``.  This
-    can be used to raise an exception if invalid JSON numbers are
-    encountered.
+    *allow_nan*, if True (default false), will allow the parser to
+    accept the non-standard floats ``NaN``, ``Infinity``, and ``-Infinity``
+    and enable the use of the deprecated *parse_constant*.
 
     If *use_decimal* is true (default: ``False``) then it implies
     parse_float=decimal.Decimal for parity with ``dump``.
 
+    *parse_constant*, if specified, will be
+    called with one of the following strings: ``'-Infinity'``,
+    ``'Infinity'``, ``'NaN'``. It is not recommended to use this feature,
+    as it is rare to parse non-compliant JSON containing these values.
+
     To use a custom ``JSONDecoder`` subclass, specify it with the ``cls``
     kwarg. NOTE: You should use *object_hook* or *object_pairs_hook* instead
     of subclassing whenever possible.
@@ -468,12 +453,12 @@ def load(fp, encoding=None, cls=None, object_hook=None, parse_float=None,
         encoding=encoding, cls=cls, object_hook=object_hook,
         parse_float=parse_float, parse_int=parse_int,
         parse_constant=parse_constant, object_pairs_hook=object_pairs_hook,
-        use_decimal=use_decimal, **kw)
+        use_decimal=use_decimal, allow_nan=allow_nan, **kw)
 
 
 def loads(s, encoding=None, cls=None, object_hook=None, parse_float=None,
         parse_int=None, parse_constant=None, object_pairs_hook=None,
-        use_decimal=False, **kw):
+        use_decimal=False, allow_nan=False, **kw):
     """Deserialize ``s`` (a ``str`` or ``unicode`` instance containing a JSON
     document) to a Python object.
 
@@ -505,14 +490,18 @@ def loads(s, encoding=None, cls=None, object_hook=None, parse_float=None,
     ``int(num_str)``.  This can be used to use another datatype or parser
     for JSON integers (e.g. :class:`float`).
 
-    *parse_constant*, if specified, will be called with one of the
-    following strings: ``'-Infinity'``, ``'Infinity'``, ``'NaN'``.  This
-    can be used to raise an exception if invalid JSON numbers are
-    encountered.
+    *allow_nan*, if True (default false), will allow the parser to
+    accept the non-standard floats ``NaN``, ``Infinity``, and ``-Infinity``
+    and enable the use of the deprecated *parse_constant*.
 
     If *use_decimal* is true (default: ``False``) then it implies
     parse_float=decimal.Decimal for parity with ``dump``.
 
+    *parse_constant*, if specified, will be
+    called with one of the following strings: ``'-Infinity'``,
+    ``'Infinity'``, ``'NaN'``. It is not recommended to use this feature,
+    as it is rare to parse non-compliant JSON containing these values.
+
     To use a custom ``JSONDecoder`` subclass, specify it with the ``cls``
     kwarg. NOTE: You should use *object_hook* or *object_pairs_hook* instead
     of subclassing whenever possible.
@@ -521,7 +510,7 @@ def loads(s, encoding=None, cls=None, object_hook=None, parse_float=None,
     if (cls is None and encoding is None and object_hook is None and
             parse_int is None and parse_float is None and
             parse_constant is None and object_pairs_hook is None
-            and not use_decimal and not kw):
+            and not use_decimal and not allow_nan and not kw):
         return _default_decoder.decode(s)
     if cls is None:
         cls = JSONDecoder
@@ -539,6 +528,8 @@ def loads(s, encoding=None, cls=None, object_hook=None, parse_float=None,
         if parse_float is not None:
             raise TypeError("use_decimal=True implies parse_float=Decimal")
         kw['parse_float'] = Decimal
+    if allow_nan:
+        kw['allow_nan'] = True
     return cls(encoding=encoding, **kw).decode(s)
 
 
@@ -560,22 +551,9 @@ def _toggle_speedups(enabled):
         scan.make_scanner = scan.py_make_scanner
     dec.make_scanner = scan.make_scanner
     global _default_decoder
-    _default_decoder = JSONDecoder(
-        encoding=None,
-        object_hook=None,
-        object_pairs_hook=None,
-    )
+    _default_decoder = JSONDecoder()
     global _default_encoder
-    _default_encoder = JSONEncoder(
-       skipkeys=False,
-       ensure_ascii=True,
-       check_circular=True,
-       allow_nan=True,
-       indent=None,
-       separators=None,
-       encoding='utf-8',
-       default=None,
-   )
+    _default_encoder = JSONEncoder()
 
 def simple_first(kv):
     """Helper function to pass to item_sort_key to sort simple
diff --git a/lib/simplejson/decoder.py b/lib/simplejson/decoder.py
index 1a8f772f..c99a976d 100644
--- a/lib/simplejson/decoder.py
+++ b/lib/simplejson/decoder.py
@@ -46,9 +46,35 @@ BACKSLASH = {
 
 DEFAULT_ENCODING = "utf-8"
 
+if hasattr(sys, 'get_int_max_str_digits'):
+    bounded_int = int
+else:
+    def bounded_int(s, INT_MAX_STR_DIGITS=4300):
+        """Backport of the integer string length conversion limitation
+
+        https://docs.python.org/3/library/stdtypes.html#int-max-str-digits
+        """
+        if len(s) > INT_MAX_STR_DIGITS:
+            raise ValueError("Exceeds the limit (%s) for integer string conversion: value has %s digits" % (INT_MAX_STR_DIGITS, len(s)))
+        return int(s)
+
+
+def scan_four_digit_hex(s, end, _m=re.compile(r'^[0-9a-fA-F]{4}$').match):
+    """Scan a four digit hex number from s[end:end + 4]
+    """
+    msg = "Invalid \\uXXXX escape sequence"
+    esc = s[end:end + 4]
+    if not _m(esc):
+        raise JSONDecodeError(msg, s, end - 2)
+    try:
+        return int(esc, 16), end + 4
+    except ValueError:
+        raise JSONDecodeError(msg, s, end - 2)
+
 def py_scanstring(s, end, encoding=None, strict=True,
         _b=BACKSLASH, _m=STRINGCHUNK.match, _join=u''.join,
-        _PY3=PY3, _maxunicode=sys.maxunicode):
+        _PY3=PY3, _maxunicode=sys.maxunicode,
+        _scan_four_digit_hex=scan_four_digit_hex):
     """Scan the string s for a JSON string. End is the index of the
     character in s after the quote that started the JSON string.
     Unescapes all valid JSON string escape sequences and raises ValueError
@@ -67,6 +93,7 @@ def py_scanstring(s, end, encoding=None, strict=True,
         if chunk is None:
             raise JSONDecodeError(
                 "Unterminated string starting at", s, begin)
+        prev_end = end
         end = chunk.end()
         content, terminator = chunk.groups()
         # Content is contains zero or more unescaped string characters
@@ -81,7 +108,7 @@ def py_scanstring(s, end, encoding=None, strict=True,
         elif terminator != '\\':
             if strict:
                 msg = "Invalid control character %r at"
-                raise JSONDecodeError(msg, s, end)
+                raise JSONDecodeError(msg, s, prev_end)
             else:
                 _append(terminator)
                 continue
@@ -100,35 +127,18 @@ def py_scanstring(s, end, encoding=None, strict=True,
             end += 1
         else:
             # Unicode escape sequence
-            msg = "Invalid \\uXXXX escape sequence"
-            esc = s[end + 1:end + 5]
-            escX = esc[1:2]
-            if len(esc) != 4 or escX == 'x' or escX == 'X':
-                raise JSONDecodeError(msg, s, end - 1)
-            try:
-                uni = int(esc, 16)
-            except ValueError:
-                raise JSONDecodeError(msg, s, end - 1)
-            if uni < 0 or uni > _maxunicode:
-                raise JSONDecodeError(msg, s, end - 1)
-            end += 5
+            uni, end = _scan_four_digit_hex(s, end + 1)
             # Check for surrogate pair on UCS-4 systems
             # Note that this will join high/low surrogate pairs
             # but will also pass unpaired surrogates through
             if (_maxunicode > 65535 and
                 uni & 0xfc00 == 0xd800 and
                 s[end:end + 2] == '\\u'):
-                esc2 = s[end + 2:end + 6]
-                escX = esc2[1:2]
-                if len(esc2) == 4 and not (escX == 'x' or escX == 'X'):
-                    try:
-                        uni2 = int(esc2, 16)
-                    except ValueError:
-                        raise JSONDecodeError(msg, s, end)
-                    if uni2 & 0xfc00 == 0xdc00:
-                        uni = 0x10000 + (((uni - 0xd800) << 10) |
-                                         (uni2 - 0xdc00))
-                        end += 6
+                uni2, end2 = _scan_four_digit_hex(s, end + 2)
+                if uni2 & 0xfc00 == 0xdc00:
+                    uni = 0x10000 + (((uni - 0xd800) << 10) |
+                                        (uni2 - 0xdc00))
+                    end = end2
             char = unichr(uni)
         # Append the unescaped character
         _append(char)
@@ -169,7 +179,7 @@ def JSONObject(state, encoding, strict, scan_once, object_hook,
             return pairs, end + 1
         elif nextchar != '"':
             raise JSONDecodeError(
-                "Expecting property name enclosed in double quotes",
+                "Expecting property name enclosed in double quotes or '}'",
                 s, end)
     end += 1
     while True:
@@ -296,14 +306,15 @@ class JSONDecoder(object):
     | null          | None              |
     +---------------+-------------------+
 
-    It also understands ``NaN``, ``Infinity``, and ``-Infinity`` as
+    When allow_nan=True, it also understands
+    ``NaN``, ``Infinity``, and ``-Infinity`` as
     their corresponding ``float`` values, which is outside the JSON spec.
 
     """
 
     def __init__(self, encoding=None, object_hook=None, parse_float=None,
             parse_int=None, parse_constant=None, strict=True,
-            object_pairs_hook=None):
+            object_pairs_hook=None, allow_nan=False):
         """
         *encoding* determines the encoding used to interpret any
         :class:`str` objects decoded by this instance (``'utf-8'`` by
@@ -336,10 +347,13 @@ class JSONDecoder(object):
         ``int(num_str)``.  This can be used to use another datatype or parser
         for JSON integers (e.g. :class:`float`).
 
-        *parse_constant*, if specified, will be called with one of the
-        following strings: ``'-Infinity'``, ``'Infinity'``, ``'NaN'``.  This
-        can be used to raise an exception if invalid JSON numbers are
-        encountered.
+        *allow_nan*, if True (default false), will allow the parser to
+        accept the non-standard floats ``NaN``, ``Infinity``, and ``-Infinity``.
+
+        *parse_constant*, if specified, will be
+        called with one of the following strings: ``'-Infinity'``,
+        ``'Infinity'``, ``'NaN'``. It is not recommended to use this feature,
+        as it is rare to parse non-compliant JSON containing these values.
 
         *strict* controls the parser's behavior when it encounters an
         invalid control character in a string. The default setting of
@@ -353,8 +367,8 @@ class JSONDecoder(object):
         self.object_hook = object_hook
         self.object_pairs_hook = object_pairs_hook
         self.parse_float = parse_float or float
-        self.parse_int = parse_int or int
-        self.parse_constant = parse_constant or _CONSTANTS.__getitem__
+        self.parse_int = parse_int or bounded_int
+        self.parse_constant = parse_constant or (allow_nan and _CONSTANTS.__getitem__ or None)
         self.strict = strict
         self.parse_object = JSONObject
         self.parse_array = JSONArray
diff --git a/lib/simplejson/encoder.py b/lib/simplejson/encoder.py
index e93fe43f..661ff361 100644
--- a/lib/simplejson/encoder.py
+++ b/lib/simplejson/encoder.py
@@ -5,7 +5,7 @@ import re
 from operator import itemgetter
 # Do not import Decimal directly to avoid reload issues
 import decimal
-from .compat import unichr, binary_type, text_type, string_types, integer_types, PY3
+from .compat import binary_type, text_type, string_types, integer_types, PY3
 def _import_speedups():
     try:
         from . import _speedups
@@ -140,7 +140,7 @@ class JSONEncoder(object):
     key_separator = ': '
 
     def __init__(self, skipkeys=False, ensure_ascii=True,
-                 check_circular=True, allow_nan=True, sort_keys=False,
+                 check_circular=True, allow_nan=False, sort_keys=False,
                  indent=None, separators=None, encoding='utf-8', default=None,
                  use_decimal=True, namedtuple_as_object=True,
                  tuple_as_array=True, bigint_as_string=False,
@@ -161,10 +161,11 @@ class JSONEncoder(object):
         prevent an infinite recursion (which would cause an OverflowError).
         Otherwise, no such check takes place.
 
-        If allow_nan is true, then NaN, Infinity, and -Infinity will be
-        encoded as such.  This behavior is not JSON specification compliant,
-        but is consistent with most JavaScript based encoders and decoders.
-        Otherwise, it will be a ValueError to encode such floats.
+        If allow_nan is true (default: False), then out of range float
+        values (nan, inf, -inf) will be serialized to
+        their JavaScript equivalents (NaN, Infinity, -Infinity)
+        instead of raising a ValueError. See
+        ignore_nan for ECMA-262 compliant behavior.
 
         If sort_keys is true, then the output of dictionaries will be
         sorted by key; this is useful for regression tests to ensure
@@ -294,7 +295,7 @@ class JSONEncoder(object):
         # This doesn't pass the iterator directly to ''.join() because the
         # exceptions aren't as detailed.  The list call should be roughly
         # equivalent to the PySequence_Fast that ''.join() would do.
-        chunks = self.iterencode(o, _one_shot=True)
+        chunks = self.iterencode(o)
         if not isinstance(chunks, (list, tuple)):
             chunks = list(chunks)
         if self.ensure_ascii:
@@ -302,7 +303,7 @@ class JSONEncoder(object):
         else:
             return u''.join(chunks)
 
-    def iterencode(self, o, _one_shot=False):
+    def iterencode(self, o):
         """Encode the given object and yield each string
         representation as available.
 
@@ -356,8 +357,7 @@ class JSONEncoder(object):
         key_memo = {}
         int_as_string_bitcount = (
             53 if self.bigint_as_string else self.int_as_string_bitcount)
-        if (_one_shot and c_make_encoder is not None
-                and self.indent is None):
+        if (c_make_encoder is not None and self.indent is None):
             _iterencode = c_make_encoder(
                 markers, self.default, _encoder, self.indent,
                 self.key_separator, self.item_separator, self.sort_keys,
@@ -370,7 +370,7 @@ class JSONEncoder(object):
             _iterencode = _make_iterencode(
                 markers, self.default, _encoder, self.indent, floatstr,
                 self.key_separator, self.item_separator, self.sort_keys,
-                self.skipkeys, _one_shot, self.use_decimal,
+                self.skipkeys, self.use_decimal,
                 self.namedtuple_as_object, self.tuple_as_array,
                 int_as_string_bitcount,
                 self.item_sort_key, self.encoding, self.for_json,
@@ -398,14 +398,14 @@ class JSONEncoderForHTML(JSONEncoder):
     def encode(self, o):
         # Override JSONEncoder.encode because it has hacks for
         # performance that make things more complicated.
-        chunks = self.iterencode(o, True)
+        chunks = self.iterencode(o)
         if self.ensure_ascii:
             return ''.join(chunks)
         else:
             return u''.join(chunks)
 
-    def iterencode(self, o, _one_shot=False):
-        chunks = super(JSONEncoderForHTML, self).iterencode(o, _one_shot)
+    def iterencode(self, o):
+        chunks = super(JSONEncoderForHTML, self).iterencode(o)
         for chunk in chunks:
             chunk = chunk.replace('&', '\\u0026')
             chunk = chunk.replace('<', '\\u003c')
@@ -419,7 +419,7 @@ class JSONEncoderForHTML(JSONEncoder):
 
 
 def _make_iterencode(markers, _default, _encoder, _indent, _floatstr,
-        _key_separator, _item_separator, _sort_keys, _skipkeys, _one_shot,
+        _key_separator, _item_separator, _sort_keys, _skipkeys,
         _use_decimal, _namedtuple_as_object, _tuple_as_array,
         _int_as_string_bitcount, _item_sort_key,
         _encoding,_for_json,
diff --git a/lib/simplejson/scanner.py b/lib/simplejson/scanner.py
index 85e385e1..34710d68 100644
--- a/lib/simplejson/scanner.py
+++ b/lib/simplejson/scanner.py
@@ -60,11 +60,11 @@ def py_make_scanner(context):
             else:
                 res = parse_int(integer)
             return res, m.end()
-        elif nextchar == 'N' and string[idx:idx + 3] == 'NaN':
+        elif parse_constant and nextchar == 'N' and string[idx:idx + 3] == 'NaN':
             return parse_constant('NaN'), idx + 3
-        elif nextchar == 'I' and string[idx:idx + 8] == 'Infinity':
+        elif parse_constant and nextchar == 'I' and string[idx:idx + 8] == 'Infinity':
             return parse_constant('Infinity'), idx + 8
-        elif nextchar == '-' and string[idx:idx + 9] == '-Infinity':
+        elif parse_constant and nextchar == '-' and string[idx:idx + 9] == '-Infinity':
             return parse_constant('-Infinity'), idx + 9
         else:
             raise JSONDecodeError(errmsg, string, idx)
diff --git a/lib/simplejson/tests/test_decode.py b/lib/simplejson/tests/test_decode.py
index 6960ee58..317b4f98 100644
--- a/lib/simplejson/tests/test_decode.py
+++ b/lib/simplejson/tests/test_decode.py
@@ -2,6 +2,7 @@ from __future__ import absolute_import
 import decimal
 from unittest import TestCase
 
+import sys
 import simplejson as json
 from simplejson.compat import StringIO, b, binary_type
 from simplejson import OrderedDict
@@ -117,3 +118,10 @@ class TestDecode(TestCase):
         diff = id(x) - id(y)
         self.assertRaises(ValueError, j.scan_once, y, diff)
         self.assertRaises(ValueError, j.raw_decode, y, i)
+
+    def test_bounded_int(self):
+        # SJ-PT-23-03, limit quadratic number parsing per Python 3.11
+        max_str_digits = getattr(sys, 'get_int_max_str_digits', lambda: 4300)()
+        s = '1' + '0' * (max_str_digits - 1)
+        self.assertEqual(json.loads(s), int(s))
+        self.assertRaises(ValueError, json.loads, s + '0')
diff --git a/lib/simplejson/tests/test_fail.py b/lib/simplejson/tests/test_fail.py
index 788f3a52..5f9a8f69 100644
--- a/lib/simplejson/tests/test_fail.py
+++ b/lib/simplejson/tests/test_fail.py
@@ -145,7 +145,7 @@ class TestFail(TestCase):
             ('["spam', 'Unterminated string starting at', 1),
             ('["spam"', "Expecting ',' delimiter", 7),
             ('["spam",', 'Expecting value', 8),
-            ('{', 'Expecting property name enclosed in double quotes', 1),
+            ('{', "Expecting property name enclosed in double quotes or '}'", 1),
             ('{"', 'Unterminated string starting at', 1),
             ('{"spam', 'Unterminated string starting at', 1),
             ('{"spam"', "Expecting ':' delimiter", 7),
@@ -156,6 +156,8 @@ class TestFail(TestCase):
             ('"', 'Unterminated string starting at', 0),
             ('"spam', 'Unterminated string starting at', 0),
             ('[,', "Expecting value", 1),
+            ('--', 'Expecting value', 0),
+            ('"\x18d', "Invalid control character %r", 1),
         ]
         for data, msg, idx in test_cases:
             try:
diff --git a/lib/simplejson/tests/test_float.py b/lib/simplejson/tests/test_float.py
index e382ec21..a9779694 100644
--- a/lib/simplejson/tests/test_float.py
+++ b/lib/simplejson/tests/test_float.py
@@ -7,9 +7,9 @@ from simplejson.decoder import NaN, PosInf, NegInf
 class TestFloat(TestCase):
     def test_degenerates_allow(self):
         for inf in (PosInf, NegInf):
-            self.assertEqual(json.loads(json.dumps(inf)), inf)
+            self.assertEqual(json.loads(json.dumps(inf, allow_nan=True), allow_nan=True), inf)
         # Python 2.5 doesn't have math.isnan
-        nan = json.loads(json.dumps(NaN))
+        nan = json.loads(json.dumps(NaN, allow_nan=True), allow_nan=True)
         self.assertTrue((0 + nan) != nan)
 
     def test_degenerates_ignore(self):
@@ -19,6 +19,9 @@ class TestFloat(TestCase):
     def test_degenerates_deny(self):
         for f in (PosInf, NegInf, NaN):
             self.assertRaises(ValueError, json.dumps, f, allow_nan=False)
+        for s in ('Infinity', '-Infinity', 'NaN'):
+            self.assertRaises(ValueError, json.loads, s, allow_nan=False)
+            self.assertRaises(ValueError, json.loads, s)
 
     def test_floats(self):
         for num in [1617161771.7650001, math.pi, math.pi**100,
diff --git a/lib/simplejson/tests/test_scanstring.py b/lib/simplejson/tests/test_scanstring.py
index c6c53b81..1f544834 100644
--- a/lib/simplejson/tests/test_scanstring.py
+++ b/lib/simplejson/tests/test_scanstring.py
@@ -132,7 +132,9 @@ class TestScanString(TestCase):
             self.assertRaises(ValueError,
                               scanstring, '\\ud834\\x0123"', 0, None, True)
 
-        self.assertRaises(json.JSONDecodeError, scanstring, "\\u-123", 0, None, True)
+        self.assertRaises(json.JSONDecodeError, scanstring, '\\u-123"', 0, None, True)
+        # SJ-PT-23-01: Invalid Handling of Broken Unicode Escape Sequences
+        self.assertRaises(json.JSONDecodeError, scanstring, '\\u EDD"', 0, None, True)
 
     def test_issue3623(self):
         self.assertRaises(ValueError, json.decoder.scanstring, "xxx", 1,
diff --git a/requirements.txt b/requirements.txt
index 55053413..b9a561d1 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -39,7 +39,7 @@ pytz==2023.3
 requests==2.28.2
 requests-oauthlib==1.3.1
 rumps==0.4.0; platform_system == "Darwin"
-simplejson==3.18.3
+simplejson==3.19.1
 six==1.16.0
 soupsieve==2.4
 tempora==5.2.1

From e70e08c3f5ab27daf8ad3f7531819f07d97b5351 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 23 Aug 2023 21:38:49 -0700
Subject: [PATCH 424/743] Bump beautifulsoup4 from 4.11.2 to 4.12.2 (#2037)

* Bump beautifulsoup4 from 4.11.2 to 4.12.2

Bumps [beautifulsoup4](https://www.crummy.com/software/BeautifulSoup/bs4/) from 4.11.2 to 4.12.2.

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

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

* Update beautifulsoup4==4.12.2

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/bs4/__init__.py                           |  59 ++-
 lib/bs4/builder/_htmlparser.py                |  25 +-
 lib/bs4/css.py                                | 280 ++++++++++
 lib/bs4/diagnose.py                           |  15 -
 lib/bs4/element.py                            | 470 ++++++++++-------
 lib/bs4/formatter.py                          |   2 +-
 lib/bs4/tests/__init__.py                     |  40 +-
 ...mized-bs4_fuzzer-4818336571064320.testcase |   1 +
 ...mized-bs4_fuzzer-4999465949331456.testcase |   1 +
 ...mized-bs4_fuzzer-5167584867909632.testcase | Bin 0 -> 19469 bytes
 ...mized-bs4_fuzzer-5703933063462912.testcase |   2 +
 ...mized-bs4_fuzzer-5843991618256896.testcase |   1 +
 ...mized-bs4_fuzzer-5984173902397440.testcase | Bin 0 -> 51495 bytes
 ...mized-bs4_fuzzer-6124268085182464.testcase |   1 +
 ...mized-bs4_fuzzer-6241471367348224.testcase |   1 +
 ...mized-bs4_fuzzer-6450958476902400.testcase | Bin 0 -> 3546 bytes
 ...mized-bs4_fuzzer-6600557255327744.testcase | Bin 0 -> 124 bytes
 ...0c8ed8bcd0785b67000fcd5dea1d33f08.testcase | Bin 0 -> 2607 bytes
 lib/bs4/tests/test_css.py                     | 487 ++++++++++++++++++
 lib/bs4/tests/test_formatter.py               |  20 +-
 lib/bs4/tests/test_fuzz.py                    |  91 ++++
 lib/bs4/tests/test_htmlparser.py              |  24 +
 lib/bs4/tests/test_lxml.py                    |  12 +-
 lib/bs4/tests/test_pageelement.py             | 480 ++---------------
 lib/bs4/tests/test_soup.py                    |  42 ++
 lib/soupsieve/__init__.py                     |  30 +-
 lib/soupsieve/__meta__.py                     |   2 +-
 lib/soupsieve/css_match.py                    |  54 +-
 lib/soupsieve/css_parser.py                   |  22 +-
 lib/soupsieve/css_types.py                    |  24 +-
 lib/soupsieve/util.py                         |   6 +-
 requirements.txt                              |   2 +-
 32 files changed, 1439 insertions(+), 755 deletions(-)
 create mode 100644 lib/bs4/css.py
 create mode 100644 lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-4818336571064320.testcase
 create mode 100644 lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-4999465949331456.testcase
 create mode 100644 lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-5167584867909632.testcase
 create mode 100644 lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-5703933063462912.testcase
 create mode 100644 lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-5843991618256896.testcase
 create mode 100644 lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-5984173902397440.testcase
 create mode 100644 lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-6124268085182464.testcase
 create mode 100644 lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-6241471367348224.testcase
 create mode 100644 lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-6450958476902400.testcase
 create mode 100644 lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-6600557255327744.testcase
 create mode 100644 lib/bs4/tests/fuzz/crash-0d306a50c8ed8bcd0785b67000fcd5dea1d33f08.testcase
 create mode 100644 lib/bs4/tests/test_css.py
 create mode 100644 lib/bs4/tests/test_fuzz.py

diff --git a/lib/bs4/__init__.py b/lib/bs4/__init__.py
index db71cc7c..3d2ab09a 100644
--- a/lib/bs4/__init__.py
+++ b/lib/bs4/__init__.py
@@ -15,7 +15,7 @@ documentation: http://www.crummy.com/software/BeautifulSoup/bs4/doc/
 """
 
 __author__ = "Leonard Richardson (leonardr@segfault.org)"
-__version__ = "4.11.2"
+__version__ = "4.12.2"
 __copyright__ = "Copyright (c) 2004-2023 Leonard Richardson"
 # Use of this source code is governed by the MIT license.
 __license__ = "MIT"
@@ -38,11 +38,13 @@ from .builder import (
     builder_registry,
     ParserRejectedMarkup,
     XMLParsedAsHTMLWarning,
+    HTMLParserTreeBuilder
 )
 from .dammit import UnicodeDammit
 from .element import (
     CData,
     Comment,
+    CSS,
     DEFAULT_OUTPUT_ENCODING,
     Declaration,
     Doctype,
@@ -116,7 +118,7 @@ class BeautifulSoup(Tag):
     ASCII_SPACES = '\x20\x0a\x09\x0c\x0d'
 
     NO_PARSER_SPECIFIED_WARNING = "No parser was explicitly specified, so I'm using the best available %(markup_type)s parser for this system (\"%(parser)s\"). This usually isn't a problem, but if you run this code on another system, or in a different virtual environment, it may use a different parser and behave differently.\n\nThe code that caused this warning is on line %(line_number)s of the file %(filename)s. To get rid of this warning, pass the additional argument 'features=\"%(parser)s\"' to the BeautifulSoup constructor.\n"
-    
+   
     def __init__(self, markup="", features=None, builder=None,
                  parse_only=None, from_encoding=None, exclude_encodings=None,
                  element_classes=None, **kwargs):
@@ -348,25 +350,49 @@ class BeautifulSoup(Tag):
         self.markup = None
         self.builder.soup = None
 
-    def __copy__(self):
-        """Copy a BeautifulSoup object by converting the document to a string and parsing it again."""
-        copy = type(self)(
-            self.encode('utf-8'), builder=self.builder, from_encoding='utf-8'
-        )
+    def _clone(self):
+        """Create a new BeautifulSoup object with the same TreeBuilder,
+        but not associated with any markup.
 
-        # Although we encoded the tree to UTF-8, that may not have
-        # been the encoding of the original markup. Set the copy's
-        # .original_encoding to reflect the original object's
-        # .original_encoding.
-        copy.original_encoding = self.original_encoding
-        return copy
+        This is the first step of the deepcopy process.
+        """
+        clone = type(self)("", None, self.builder)
 
+        # Keep track of the encoding of the original document,
+        # since we won't be parsing it again.
+        clone.original_encoding = self.original_encoding
+        return clone
+        
     def __getstate__(self):
         # Frequently a tree builder can't be pickled.
         d = dict(self.__dict__)
         if 'builder' in d and d['builder'] is not None and not self.builder.picklable:
-            d['builder'] = None
+            d['builder'] = type(self.builder)
+        # Store the contents as a Unicode string.
+        d['contents'] = []
+        d['markup'] = self.decode()
+
+        # If _most_recent_element is present, it's a Tag object left
+        # over from initial parse. It might not be picklable and we
+        # don't need it.
+        if '_most_recent_element' in d:
+            del d['_most_recent_element']
         return d
+
+    def __setstate__(self, state):
+        # If necessary, restore the TreeBuilder by looking it up.
+        self.__dict__ = state
+        if isinstance(self.builder, type):
+            self.builder = self.builder()
+        elif not self.builder:
+            # We don't know which builder was used to build this
+            # parse tree, so use a default we know is always available.
+            self.builder = HTMLParserTreeBuilder()
+        self.builder.soup = self
+        self.reset()
+        self._feed()
+        return state
+
     
     @classmethod
     def _decode_markup(cls, markup):
@@ -468,6 +494,7 @@ class BeautifulSoup(Tag):
         self.open_tag_counter = Counter()
         self.preserve_whitespace_tag_stack = []
         self.string_container_stack = []
+        self._most_recent_element = None
         self.pushTag(self)
 
     def new_tag(self, name, namespace=None, nsprefix=None, attrs={},
@@ -749,7 +776,7 @@ class BeautifulSoup(Tag):
        
     def decode(self, pretty_print=False,
                eventual_encoding=DEFAULT_OUTPUT_ENCODING,
-               formatter="minimal"):
+               formatter="minimal", iterator=None):
         """Returns a string or Unicode representation of the parse tree
             as an HTML or XML document.
 
@@ -776,7 +803,7 @@ class BeautifulSoup(Tag):
         else:
             indent_level = 0
         return prefix + super(BeautifulSoup, self).decode(
-            indent_level, eventual_encoding, formatter)
+            indent_level, eventual_encoding, formatter, iterator)
 
 # Aliases to make it easier to get started quickly, e.g. 'from bs4 import _soup'
 _s = BeautifulSoup
diff --git a/lib/bs4/builder/_htmlparser.py b/lib/bs4/builder/_htmlparser.py
index e48b6a0e..e065096b 100644
--- a/lib/bs4/builder/_htmlparser.py
+++ b/lib/bs4/builder/_htmlparser.py
@@ -24,6 +24,7 @@ from bs4.dammit import EntitySubstitution, UnicodeDammit
 
 from bs4.builder import (
     DetectsXMLParsedAsHTML,
+    ParserRejectedMarkup,
     HTML,
     HTMLTreeBuilder,
     STRICT,
@@ -70,6 +71,22 @@ class BeautifulSoupHTMLParser(HTMLParser, DetectsXMLParsedAsHTML):
 
         self._initialize_xml_detector()
 
+    def error(self, message):
+        # NOTE: This method is required so long as Python 3.9 is
+        # supported. The corresponding code is removed from HTMLParser
+        # in 3.5, but not removed from ParserBase until 3.10.
+        # https://github.com/python/cpython/issues/76025
+        #
+        # The original implementation turned the error into a warning,
+        # but in every case I discovered, this made HTMLParser
+        # immediately crash with an error message that was less
+        # helpful than the warning. The new implementation makes it
+        # more clear that html.parser just can't parse this
+        # markup. The 3.10 implementation does the same, though it
+        # raises AssertionError rather than calling a method. (We
+        # catch this error and wrap it in a ParserRejectedMarkup.)
+        raise ParserRejectedMarkup(message)
+
     def handle_startendtag(self, name, attrs):
         """Handle an incoming empty-element tag.
 
@@ -359,6 +376,12 @@ class HTMLParserTreeBuilder(HTMLTreeBuilder):
         args, kwargs = self.parser_args
         parser = BeautifulSoupHTMLParser(*args, **kwargs)
         parser.soup = self.soup
-        parser.feed(markup)
+        try:
+            parser.feed(markup)
+        except AssertionError as e:
+            # html.parser raises AssertionError in rare cases to
+            # indicate a fatal problem with the markup, especially
+            # when there's an error in the doctype declaration.
+            raise ParserRejectedMarkup(e)
         parser.close()
         parser.already_closed_empty_element = []
diff --git a/lib/bs4/css.py b/lib/bs4/css.py
new file mode 100644
index 00000000..245ac601
--- /dev/null
+++ b/lib/bs4/css.py
@@ -0,0 +1,280 @@
+"""Integration code for CSS selectors using Soup Sieve (pypi: soupsieve)."""
+
+import warnings
+try:
+    import soupsieve
+except ImportError as e:
+    soupsieve = None
+    warnings.warn(
+        'The soupsieve package is not installed. CSS selectors cannot be used.'
+    )
+
+
+class CSS(object):
+    """A proxy object against the soupsieve library, to simplify its
+    CSS selector API.
+
+    Acquire this object through the .css attribute on the
+    BeautifulSoup object, or on the Tag you want to use as the
+    starting point for a CSS selector.
+
+    The main advantage of doing this is that the tag to be selected
+    against doesn't need to be explicitly specified in the function
+    calls, since it's already scoped to a tag.
+    """
+
+    def __init__(self, tag, api=soupsieve):
+        """Constructor.
+
+        You don't need to instantiate this class yourself; instead,
+        access the .css attribute on the BeautifulSoup object, or on
+        the Tag you want to use as the starting point for your CSS
+        selector.
+
+        :param tag: All CSS selectors will use this as their starting
+        point.
+
+        :param api: A plug-in replacement for the soupsieve module,
+        designed mainly for use in tests.
+        """
+        if api is None:
+            raise NotImplementedError(
+                "Cannot execute CSS selectors because the soupsieve package is not installed."
+            )
+        self.api = api
+        self.tag = tag
+
+    def escape(self, ident):
+        """Escape a CSS identifier.
+
+        This is a simple wrapper around soupselect.escape(). See the
+        documentation for that function for more information.
+        """
+        if soupsieve is None:
+            raise NotImplementedError(
+                "Cannot escape CSS identifiers because the soupsieve package is not installed."
+            )
+        return self.api.escape(ident)
+
+    def _ns(self, ns, select):
+        """Normalize a dictionary of namespaces."""
+        if not isinstance(select, self.api.SoupSieve) and ns is None:
+            # If the selector is a precompiled pattern, it already has
+            # a namespace context compiled in, which cannot be
+            # replaced.
+            ns = self.tag._namespaces
+        return ns
+
+    def _rs(self, results):
+        """Normalize a list of results to a Resultset.
+
+        A ResultSet is more consistent with the rest of Beautiful
+        Soup's API, and ResultSet.__getattr__ has a helpful error
+        message if you try to treat a list of results as a single
+        result (a common mistake).
+        """
+        # Import here to avoid circular import
+        from bs4.element import ResultSet
+        return ResultSet(None, results)
+
+    def compile(self, select, namespaces=None, flags=0, **kwargs):
+        """Pre-compile a selector and return the compiled object.
+
+        :param selector: A CSS selector.
+
+        :param namespaces: A dictionary mapping namespace prefixes
+           used in the CSS selector to namespace URIs. By default,
+           Beautiful Soup will use the prefixes it encountered while
+           parsing the document.
+
+        :param flags: Flags to be passed into Soup Sieve's
+            soupsieve.compile() method.
+
+        :param kwargs: Keyword arguments to be passed into SoupSieve's
+           soupsieve.compile() method.
+
+        :return: A precompiled selector object.
+        :rtype: soupsieve.SoupSieve
+        """
+        return self.api.compile(
+            select, self._ns(namespaces, select), flags, **kwargs
+        )
+
+    def select_one(self, select, namespaces=None, flags=0, **kwargs):
+        """Perform a CSS selection operation on the current Tag and return the
+        first result.
+
+        This uses the Soup Sieve library. For more information, see
+        that library's documentation for the soupsieve.select_one()
+        method.
+
+        :param selector: A CSS selector.
+
+        :param namespaces: A dictionary mapping namespace prefixes
+           used in the CSS selector to namespace URIs. By default,
+           Beautiful Soup will use the prefixes it encountered while
+           parsing the document.
+
+        :param flags: Flags to be passed into Soup Sieve's
+            soupsieve.select_one() method.
+
+        :param kwargs: Keyword arguments to be passed into SoupSieve's
+           soupsieve.select_one() method.
+
+        :return: A Tag, or None if the selector has no match.
+        :rtype: bs4.element.Tag
+
+        """
+        return self.api.select_one(
+            select, self.tag, self._ns(namespaces, select), flags, **kwargs
+        )
+
+    def select(self, select, namespaces=None, limit=0, flags=0, **kwargs):
+        """Perform a CSS selection operation on the current Tag.
+
+        This uses the Soup Sieve library. For more information, see
+        that library's documentation for the soupsieve.select()
+        method.
+
+        :param selector: A string containing a CSS selector.
+
+        :param namespaces: A dictionary mapping namespace prefixes
+            used in the CSS selector to namespace URIs. By default,
+            Beautiful Soup will pass in the prefixes it encountered while
+            parsing the document.
+
+        :param limit: After finding this number of results, stop looking.
+
+        :param flags: Flags to be passed into Soup Sieve's
+            soupsieve.select() method.
+
+        :param kwargs: Keyword arguments to be passed into SoupSieve's
+            soupsieve.select() method.
+
+        :return: A ResultSet of Tag objects.
+        :rtype: bs4.element.ResultSet
+
+        """
+        if limit is None:
+            limit = 0
+
+        return self._rs(
+            self.api.select(
+                select, self.tag, self._ns(namespaces, select), limit, flags,
+                **kwargs
+            )
+        )
+
+    def iselect(self, select, namespaces=None, limit=0, flags=0, **kwargs):
+        """Perform a CSS selection operation on the current Tag.
+
+        This uses the Soup Sieve library. For more information, see
+        that library's documentation for the soupsieve.iselect()
+        method. It is the same as select(), but it returns a generator
+        instead of a list.
+
+        :param selector: A string containing a CSS selector.
+
+        :param namespaces: A dictionary mapping namespace prefixes
+            used in the CSS selector to namespace URIs. By default,
+            Beautiful Soup will pass in the prefixes it encountered while
+            parsing the document.
+
+        :param limit: After finding this number of results, stop looking.
+
+        :param flags: Flags to be passed into Soup Sieve's
+            soupsieve.iselect() method.
+
+        :param kwargs: Keyword arguments to be passed into SoupSieve's
+            soupsieve.iselect() method.
+
+        :return: A generator
+        :rtype: types.GeneratorType
+        """
+        return self.api.iselect(
+            select, self.tag, self._ns(namespaces, select), limit, flags, **kwargs
+        )
+
+    def closest(self, select, namespaces=None, flags=0, **kwargs):
+        """Find the Tag closest to this one that matches the given selector.
+
+        This uses the Soup Sieve library. For more information, see
+        that library's documentation for the soupsieve.closest()
+        method.
+
+        :param selector: A string containing a CSS selector.
+
+        :param namespaces: A dictionary mapping namespace prefixes
+            used in the CSS selector to namespace URIs. By default,
+            Beautiful Soup will pass in the prefixes it encountered while
+            parsing the document.
+
+        :param flags: Flags to be passed into Soup Sieve's
+            soupsieve.closest() method.
+
+        :param kwargs: Keyword arguments to be passed into SoupSieve's
+            soupsieve.closest() method.
+
+        :return: A Tag, or None if there is no match.
+        :rtype: bs4.Tag
+
+        """
+        return self.api.closest(
+            select, self.tag, self._ns(namespaces, select), flags, **kwargs
+        )
+
+    def match(self, select, namespaces=None, flags=0, **kwargs):
+        """Check whether this Tag matches the given CSS selector.
+
+        This uses the Soup Sieve library. For more information, see
+        that library's documentation for the soupsieve.match()
+        method.
+
+        :param: a CSS selector.
+
+        :param namespaces: A dictionary mapping namespace prefixes
+            used in the CSS selector to namespace URIs. By default,
+            Beautiful Soup will pass in the prefixes it encountered while
+            parsing the document.
+
+        :param flags: Flags to be passed into Soup Sieve's
+            soupsieve.match() method.
+
+        :param kwargs: Keyword arguments to be passed into SoupSieve's
+            soupsieve.match() method.
+
+        :return: True if this Tag matches the selector; False otherwise.
+        :rtype: bool
+        """
+        return self.api.match(
+            select, self.tag, self._ns(namespaces, select), flags, **kwargs
+        )
+
+    def filter(self, select, namespaces=None, flags=0, **kwargs):
+        """Filter this Tag's direct children based on the given CSS selector.
+
+        This uses the Soup Sieve library. It works the same way as
+        passing this Tag into that library's soupsieve.filter()
+        method. More information, for more information see the
+        documentation for soupsieve.filter().
+
+        :param namespaces: A dictionary mapping namespace prefixes
+            used in the CSS selector to namespace URIs. By default,
+            Beautiful Soup will pass in the prefixes it encountered while
+            parsing the document.
+
+        :param flags: Flags to be passed into Soup Sieve's
+            soupsieve.filter() method.
+
+        :param kwargs: Keyword arguments to be passed into SoupSieve's
+            soupsieve.filter() method.
+
+        :return: A ResultSet of Tag objects.
+        :rtype: bs4.element.ResultSet
+
+        """
+        return self._rs(
+            self.api.filter(
+                select, self.tag, self._ns(namespaces, select), flags, **kwargs
+            )
+        )
diff --git a/lib/bs4/diagnose.py b/lib/bs4/diagnose.py
index 3bf583f5..e079772e 100644
--- a/lib/bs4/diagnose.py
+++ b/lib/bs4/diagnose.py
@@ -59,21 +59,6 @@ def diagnose(data):
 
     if hasattr(data, 'read'):
         data = data.read()
-    elif data.startswith("http:") or data.startswith("https:"):
-        print(('"%s" looks like a URL. Beautiful Soup is not an HTTP client.' % data))
-        print("You need to use some other library to get the document behind the URL, and feed that document to Beautiful Soup.")
-        return
-    else:
-        try:
-            if os.path.exists(data):
-                print(('"%s" looks like a filename. Reading data from the file.' % data))
-                with open(data) as fp:
-                    data = fp.read()
-        except ValueError:
-            # This can happen on some platforms when the 'filename' is
-            # too long. Assume it's data and not a filename.
-            pass
-        print("")
 
     for parser in basic_parsers:
         print(("Trying to parse your markup with %s" % parser))
diff --git a/lib/bs4/element.py b/lib/bs4/element.py
index 583d0e8a..9c73957c 100644
--- a/lib/bs4/element.py
+++ b/lib/bs4/element.py
@@ -8,14 +8,8 @@ except ImportError as e:
 import re
 import sys
 import warnings
-try:
-    import soupsieve
-except ImportError as e:
-    soupsieve = None
-    warnings.warn(
-        'The soupsieve package is not installed. CSS selectors cannot be used.'
-    )
 
+from bs4.css import CSS
 from bs4.formatter import (
     Formatter,
     HTMLFormatter,
@@ -69,13 +63,13 @@ PYTHON_SPECIFIC_ENCODINGS = set([
     "string-escape",
     "string_escape",
 ])
-    
+
 
 class NamespacedAttribute(str):
     """A namespaced string (e.g. 'xml:lang') that remembers the namespace
     ('xml') and the name ('lang') that were used to create it.
     """
-    
+
     def __new__(cls, prefix, name=None, namespace=None):
         if not name:
             # This is the default namespace. Its name "has no value"
@@ -146,14 +140,19 @@ class ContentMetaAttributeValue(AttributeValueWithCharsetSubstitution):
             return match.group(1) + encoding
         return self.CHARSET_RE.sub(rewrite, self.original_value)
 
-    
+
 class PageElement(object):
     """Contains the navigational information for some part of the page:
     that is, its current location in the parse tree.
 
     NavigableString, Tag, etc. are all subclasses of PageElement.
     """
-   
+
+    # In general, we can't tell just by looking at an element whether
+    # it's contained in an XML document or an HTML document. But for
+    # Tags (q.v.) we can store this information at parse time.
+    known_xml = None
+
     def setup(self, parent=None, previous_element=None, next_element=None,
               previous_sibling=None, next_sibling=None):
         """Sets up the initial relations between this element and
@@ -163,7 +162,7 @@ class PageElement(object):
 
         :param previous_element: The element parsed immediately before
             this one.
-        
+
         :param next_element: The element parsed immediately before
             this one.
 
@@ -257,11 +256,11 @@ class PageElement(object):
     default = object()
     def _all_strings(self, strip=False, types=default):
         """Yield all strings of certain classes, possibly stripping them.
-        
+
         This is implemented differently in Tag and NavigableString.
         """
         raise NotImplementedError()
-   
+
     @property
     def stripped_strings(self):
         """Yield all strings in this PageElement, stripping them first.
@@ -294,11 +293,11 @@ class PageElement(object):
                     strip, types=types)])
     getText = get_text
     text = property(get_text)
-    
+
     def replace_with(self, *args):
-        """Replace this PageElement with one or more PageElements, keeping the 
+        """Replace this PageElement with one or more PageElements, keeping the
         rest of the tree the same.
-        
+
         :param args: One or more PageElements.
         :return: `self`, no longer part of the tree.
         """
@@ -410,7 +409,7 @@ class PageElement(object):
         This works the same way as `list.insert`.
 
         :param position: The numeric position that should be occupied
-           in `self.children` by the new PageElement. 
+           in `self.children` by the new PageElement.
         :param new_child: A PageElement.
         """
         if new_child is None:
@@ -546,7 +545,7 @@ class PageElement(object):
                 "Element has no parent, so 'after' has no meaning.")
         if any(x is self for x in args):
             raise ValueError("Can't insert an element after itself.")
-        
+
         offset = 0
         for successor in args:
             # Extract first so that the index won't be screwed up if they
@@ -912,7 +911,7 @@ class PageElement(object):
         :rtype: bool
         """
         return getattr(self, '_decomposed', False) or False
-            
+   
     # Old non-property versions of the generators, for backwards
     # compatibility with BS3.
     def nextGenerator(self):
@@ -936,16 +935,11 @@ class NavigableString(str, PageElement):
 
     When Beautiful Soup parses the markup <b>penguin</b>, it will
     create a NavigableString for the string "penguin".
-    """   
+    """
 
     PREFIX = ''
     SUFFIX = ''
 
-    # We can't tell just by looking at a string whether it's contained
-    # in an XML document or an HTML document.
-
-    known_xml = None
-
     def __new__(cls, value):
         """Create a new NavigableString.
 
@@ -961,12 +955,22 @@ class NavigableString(str, PageElement):
         u.setup()
         return u
 
-    def __copy__(self):
+    def __deepcopy__(self, memo, recursive=False):
         """A copy of a NavigableString has the same contents and class
         as the original, but it is not connected to the parse tree.
+
+        :param recursive: This parameter is ignored; it's only defined
+           so that NavigableString.__deepcopy__ implements the same
+           signature as Tag.__deepcopy__.
         """
         return type(self)(self)
 
+    def __copy__(self):
+        """A copy of a NavigableString can only be a deep copy, because
+        only one PageElement can occupy a given place in a parse tree.
+        """
+        return self.__deepcopy__({})
+
     def __getnewargs__(self):
         return (str(self),)
 
@@ -1059,10 +1063,10 @@ class PreformattedString(NavigableString):
     as comments (the Comment class) and CDATA blocks (the CData
     class).
     """
-    
+
     PREFIX = ''
     SUFFIX = ''
-    
+
     def output_ready(self, formatter=None):
         """Make this string ready for output by adding any subclass-specific
             prefix or suffix.
@@ -1144,7 +1148,7 @@ class Stylesheet(NavigableString):
     """
     pass
 
-    
+
 class Script(NavigableString):
     """A NavigableString representing an executable script (probably
     Javascript).
@@ -1250,7 +1254,7 @@ class Tag(PageElement):
         if ((not builder or builder.store_line_numbers)
             and (sourceline is not None or sourcepos is not None)):
             self.sourceline = sourceline
-            self.sourcepos = sourcepos        
+            self.sourcepos = sourcepos
         if attrs is None:
             attrs = {}
         elif attrs:
@@ -1308,13 +1312,49 @@ class Tag(PageElement):
                 self.interesting_string_types = builder.string_containers[self.name]
             else:
                 self.interesting_string_types = self.DEFAULT_INTERESTING_STRING_TYPES
-            
+
     parserClass = _alias("parser_class")  # BS3
 
-    def __copy__(self):
-        """A copy of a Tag is a new Tag, unconnected to the parse tree.
+    def __deepcopy__(self, memo, recursive=True):
+        """A deepcopy of a Tag is a new Tag, unconnected to the parse tree.
         Its contents are a copy of the old Tag's contents.
         """
+        clone = self._clone()
+
+        if recursive:
+            # Clone this tag's descendants recursively, but without
+            # making any recursive function calls.
+            tag_stack = [clone]
+            for event, element in self._event_stream(self.descendants):
+                if event is Tag.END_ELEMENT_EVENT:
+                    # Stop appending incoming Tags to the Tag that was
+                    # just closed.
+                    tag_stack.pop()
+                else:
+                    descendant_clone = element.__deepcopy__(
+                        memo, recursive=False
+                    )
+                    # Add to its parent's .contents
+                    tag_stack[-1].append(descendant_clone)
+
+                    if event is Tag.START_ELEMENT_EVENT:
+                        # Add the Tag itself to the stack so that its
+                        # children will be .appended to it.
+                        tag_stack.append(descendant_clone)
+        return clone
+
+    def __copy__(self):
+        """A copy of a Tag must always be a deep copy, because a Tag's
+        children can only have one parent at a time.
+        """
+        return self.__deepcopy__({})
+
+    def _clone(self):
+        """Create a new Tag just like this one, but with no
+        contents and unattached to any parse tree.
+
+        This is the first step in the deepcopy process.
+        """
         clone = type(self)(
             None, self.builder, self.name, self.namespace,
             self.prefix, self.attrs, is_xml=self._is_xml,
@@ -1326,8 +1366,6 @@ class Tag(PageElement):
         )
         for attr in ('can_be_empty_element', 'hidden'):
             setattr(clone, attr, getattr(self, attr))
-        for child in self.contents:
-            clone.append(child.__copy__())
         return clone
     
     @property
@@ -1433,7 +1471,7 @@ class Tag(PageElement):
             i.contents = []
             i._decomposed = True
             i = n
-           
+
     def clear(self, decompose=False):
         """Wipe out all children of this PageElement by calling extract()
            on them.
@@ -1521,7 +1559,7 @@ class Tag(PageElement):
         if not isinstance(value, list):
             value = [value]
         return value
-    
+
     def has_attr(self, key):
         """Does this PageElement have an attribute with the given name?"""
         return key in self.attrs
@@ -1608,7 +1646,7 @@ class Tag(PageElement):
     def __repr__(self, encoding="unicode-escape"):
         """Renders this PageElement as a string.
 
-        :param encoding: The encoding to use (Python 2 only). 
+        :param encoding: The encoding to use (Python 2 only).
             TODO: This is now ignored and a warning should be issued
             if a value is provided.
         :return: A (Unicode) string.
@@ -1650,106 +1688,212 @@ class Tag(PageElement):
 
     def decode(self, indent_level=None,
                eventual_encoding=DEFAULT_OUTPUT_ENCODING,
-               formatter="minimal"):
-        """Render a Unicode representation of this PageElement and its
-        contents.
-
-        :param indent_level: Each line of the rendering will be
-             indented this many spaces. Used internally in
-             recursive calls while pretty-printing.
-        :param eventual_encoding: The tag is destined to be
-            encoded into this encoding. This method is _not_
-            responsible for performing that encoding. This information
-            is passed in so that it can be substituted in if the
-            document contains a <META> tag that mentions the document's
-            encoding.
-        :param formatter: A Formatter object, or a string naming one of
-            the standard formatters.
-        """
-
+               formatter="minimal",
+               iterator=None):
+        pieces = []
         # First off, turn a non-Formatter `formatter` into a Formatter
         # object. This will stop the lookup from happening over and
         # over again.
         if not isinstance(formatter, Formatter):
             formatter = self.formatter_for_name(formatter)
-        attributes = formatter.attributes(self)
-        attrs = []
-        for key, val in attributes:
-            if val is None:
-                decoded = key
+
+        if indent_level is True:
+            indent_level = 0
+
+        # The currently active tag that put us into string literal
+        # mode. Until this element is closed, children will be treated
+        # as string literals and not pretty-printed. String literal
+        # mode is turned on immediately after this tag begins, and
+        # turned off immediately before it's closed. This means there
+        # will be whitespace before and after the tag itself.
+        string_literal_tag = None
+
+        for event, element in self._event_stream(iterator):
+            if event in (Tag.START_ELEMENT_EVENT, Tag.EMPTY_ELEMENT_EVENT):
+                piece = element._format_tag(
+                    eventual_encoding, formatter, opening=True
+                )
+            elif event is Tag.END_ELEMENT_EVENT:
+                piece = element._format_tag(
+                    eventual_encoding, formatter, opening=False
+                )
+                if indent_level is not None:
+                    indent_level -= 1
             else:
-                if isinstance(val, list) or isinstance(val, tuple):
-                    val = ' '.join(val)
-                elif not isinstance(val, str):
-                    val = str(val)
-                elif (
-                        isinstance(val, AttributeValueWithCharsetSubstitution)
-                        and eventual_encoding is not None
-                ):
-                    val = val.encode(eventual_encoding)
+                piece = element.output_ready(formatter)
 
-                text = formatter.attribute_value(val)
-                decoded = (
-                    str(key) + '='
-                    + formatter.quoted_attribute_value(text))
-            attrs.append(decoded)
-        close = ''
-        closeTag = ''
+            # Now we need to apply the 'prettiness' -- extra
+            # whitespace before and/or after this tag. This can get
+            # complicated because certain tags, like <pre> and
+            # <script>, can't be prettified, since adding whitespace would
+            # change the meaning of the content.
 
+            # The default behavior is to add whitespace before and
+            # after an element when string literal mode is off, and to
+            # leave things as they are when string literal mode is on.
+            if string_literal_tag:
+                indent_before = indent_after = False
+            else:
+                indent_before = indent_after = True
+
+            # The only time the behavior is more complex than that is
+            # when we encounter an opening or closing tag that might
+            # put us into or out of string literal mode.
+            if (event is Tag.START_ELEMENT_EVENT
+                and not string_literal_tag
+                and not element._should_pretty_print()):
+                    # We are about to enter string literal mode. Add
+                    # whitespace before this tag, but not after. We
+                    # will stay in string literal mode until this tag
+                    # is closed.
+                    indent_before = True
+                    indent_after = False
+                    string_literal_tag = element
+            elif (event is Tag.END_ELEMENT_EVENT
+                  and element is string_literal_tag):
+                # We are about to exit string literal mode by closing
+                # the tag that sent us into that mode. Add whitespace
+                # after this tag, but not before.
+                indent_before = False
+                indent_after = True
+                string_literal_tag = None
+
+            # Now we know whether to add whitespace before and/or
+            # after this element.
+            if indent_level is not None:
+                if (indent_before or indent_after):
+                    if isinstance(element, NavigableString):
+                        piece = piece.strip()
+                    if piece:
+                        piece = self._indent_string(
+                            piece, indent_level, formatter,
+                            indent_before, indent_after
+                        )
+                if event == Tag.START_ELEMENT_EVENT:
+                    indent_level += 1
+            pieces.append(piece)
+        return "".join(pieces)
+
+    # Names for the different events yielded by _event_stream
+    START_ELEMENT_EVENT = object()
+    END_ELEMENT_EVENT = object()
+    EMPTY_ELEMENT_EVENT = object()
+    STRING_ELEMENT_EVENT = object()
+
+    def _event_stream(self, iterator=None):
+        """Yield a sequence of events that can be used to reconstruct the DOM
+        for this element.
+
+        This lets us recreate the nested structure of this element
+        (e.g. when formatting it as a string) without using recursive
+        method calls.
+
+        This is similar in concept to the SAX API, but it's a simpler
+        interface designed for internal use. The events are different
+        from SAX and the arguments associated with the events are Tags
+        and other Beautiful Soup objects.
+
+        :param iterator: An alternate iterator to use when traversing
+         the tree.
+        """
+        tag_stack = []
+
+        iterator = iterator or self.self_and_descendants
+
+        for c in iterator:
+            # If the parent of the element we're about to yield is not
+            # the tag currently on the stack, it means that the tag on
+            # the stack closed before this element appeared.
+            while tag_stack and c.parent != tag_stack[-1]:
+                now_closed_tag = tag_stack.pop()
+                yield Tag.END_ELEMENT_EVENT, now_closed_tag
+
+            if isinstance(c, Tag):
+                if c.is_empty_element:
+                    yield Tag.EMPTY_ELEMENT_EVENT, c
+                else:
+                    yield Tag.START_ELEMENT_EVENT, c
+                    tag_stack.append(c)
+                    continue
+            else:
+                yield Tag.STRING_ELEMENT_EVENT, c
+
+        while tag_stack:
+            now_closed_tag = tag_stack.pop()
+            yield Tag.END_ELEMENT_EVENT, now_closed_tag
+
+    def _indent_string(self, s, indent_level, formatter,
+                       indent_before, indent_after):
+        """Add indentation whitespace before and/or after a string.
+
+        :param s: The string to amend with whitespace.
+        :param indent_level: The indentation level; affects how much
+           whitespace goes before the string.
+        :param indent_before: Whether or not to add whitespace
+           before the string.
+        :param indent_after: Whether or not to add whitespace
+           (a newline) after the string.
+        """
+        space_before = ''
+        if indent_before and indent_level:
+            space_before = (formatter.indent * indent_level)
+
+        space_after = ''
+        if indent_after:
+            space_after = "\n"
+
+        return space_before + s + space_after
+
+    def _format_tag(self, eventual_encoding, formatter, opening):
+        # A tag starts with the < character (see below).
+
+        # Then the / character, if this is a closing tag.
+        closing_slash = ''
+        if not opening:
+            closing_slash = '/'
+
+        # Then an optional namespace prefix.
         prefix = ''
         if self.prefix:
             prefix = self.prefix + ":"
 
-        if self.is_empty_element:
-            close = formatter.void_element_close_prefix or ''
-        else:
-            closeTag = '</%s%s>' % (prefix, self.name)
+        # Then a list of attribute values, if this is an opening tag.
+        attribute_string = ''
+        if opening:
+            attributes = formatter.attributes(self)
+            attrs = []
+            for key, val in attributes:
+                if val is None:
+                    decoded = key
+                else:
+                    if isinstance(val, list) or isinstance(val, tuple):
+                        val = ' '.join(val)
+                    elif not isinstance(val, str):
+                        val = str(val)
+                    elif (
+                            isinstance(val, AttributeValueWithCharsetSubstitution)
+                            and eventual_encoding is not None
+                    ):
+                        val = val.encode(eventual_encoding)
 
-        pretty_print = self._should_pretty_print(indent_level)
-        space = ''
-        indent_space = ''
-        if indent_level is not None:
-            indent_space = (formatter.indent * (indent_level - 1))
-        if pretty_print:
-            space = indent_space
-            indent_contents = indent_level + 1
-        else:
-            indent_contents = None
-        contents = self.decode_contents(
-            indent_contents, eventual_encoding, formatter
-        )
-
-        if self.hidden:
-            # This is the 'document root' object.
-            s = contents
-        else:
-            s = []
-            attribute_string = ''
+                    text = formatter.attribute_value(val)
+                    decoded = (
+                        str(key) + '='
+                        + formatter.quoted_attribute_value(text))
+                attrs.append(decoded)
             if attrs:
                 attribute_string = ' ' + ' '.join(attrs)
-            if indent_level is not None:
-                # Even if this particular tag is not pretty-printed,
-                # we should indent up to the start of the tag.
-                s.append(indent_space)
-            s.append('<%s%s%s%s>' % (
-                    prefix, self.name, attribute_string, close))
-            if pretty_print:
-                s.append("\n")
-            s.append(contents)
-            if pretty_print and contents and contents[-1] != "\n":
-                s.append("\n")
-            if pretty_print and closeTag:
-                s.append(space)
-            s.append(closeTag)
-            if indent_level is not None and closeTag and self.next_sibling:
-                # Even if this particular tag is not pretty-printed,
-                # we're now done with the tag, and we should add a
-                # newline if appropriate.
-                s.append("\n")
-            s = ''.join(s)
-        return s
 
-    def _should_pretty_print(self, indent_level):
+        # Then an optional closing slash (for a void element in an
+        # XML document).
+        void_element_closing_slash = ''
+        if self.is_empty_element:
+            void_element_closing_slash = formatter.void_element_close_prefix or ''
+
+        # Put it all together.
+        return '<' + closing_slash + prefix + self.name + attribute_string + void_element_closing_slash + '>'
+
+    def _should_pretty_print(self, indent_level=1):
         """Should this tag be pretty-printed?
 
         Most of them should, but some (such as <pre> in HTML
@@ -1770,7 +1914,7 @@ class Tag(PageElement):
             a Unicode string will be returned.
         :param formatter: A Formatter object, or a string naming one of
             the standard formatters.
-        :return: A Unicode string (if encoding==None) or a bytestring 
+        :return: A Unicode string (if encoding==None) or a bytestring
             (otherwise).
         """
         if encoding is None:
@@ -1800,33 +1944,9 @@ class Tag(PageElement):
             the standard Formatters.
 
         """
-        # First off, turn a string formatter into a Formatter object. This
-        # will stop the lookup from happening over and over again.
-        if not isinstance(formatter, Formatter):
-            formatter = self.formatter_for_name(formatter)
+        return self.decode(indent_level, eventual_encoding, formatter,
+                           iterator=self.descendants)
 
-        pretty_print = (indent_level is not None)
-        s = []
-        for c in self:
-            text = None
-            if isinstance(c, NavigableString):
-                text = c.output_ready(formatter)
-            elif isinstance(c, Tag):
-                s.append(c.decode(indent_level, eventual_encoding,
-                                  formatter))
-            preserve_whitespace = (
-                self.preserve_whitespace_tags and self.name in self.preserve_whitespace_tags
-            )
-            if text and indent_level and not preserve_whitespace:
-                text = text.strip()
-            if text:
-                if pretty_print and not preserve_whitespace:
-                    s.append(formatter.indent * (indent_level - 1))
-                s.append(text)
-                if pretty_print and not preserve_whitespace:
-                    s.append("\n")
-        return ''.join(s)
-       
     def encode_contents(
         self, indent_level=None, encoding=DEFAULT_OUTPUT_ENCODING,
         formatter="minimal"):
@@ -1922,6 +2042,18 @@ class Tag(PageElement):
         # return iter() to make the purpose of the method clear
         return iter(self.contents)  # XXX This seems to be untested.
 
+    @property
+    def self_and_descendants(self):
+        """Iterate over this PageElement and its children in a
+        breadth-first sequence.
+
+        :yield: A sequence of PageElements.
+        """
+        if not self.hidden:
+            yield self
+        for i in self.descendants:
+            yield i
+
     @property
     def descendants(self):
         """Iterate over all children of this PageElement in a
@@ -1948,16 +2080,13 @@ class Tag(PageElement):
            Beautiful Soup will use the prefixes it encountered while
            parsing the document.
 
-        :param kwargs: Keyword arguments to be passed into SoupSieve's 
+        :param kwargs: Keyword arguments to be passed into Soup Sieve's
            soupsieve.select() method.
 
         :return: A Tag.
         :rtype: bs4.element.Tag
         """
-        value = self.select(selector, namespaces, 1, **kwargs)
-        if value:
-            return value[0]
-        return None
+        return self.css.select_one(selector, namespaces, **kwargs)
 
     def select(self, selector, namespaces=None, limit=None, **kwargs):
         """Perform a CSS selection operation on the current element.
@@ -1973,27 +2102,18 @@ class Tag(PageElement):
 
         :param limit: After finding this number of results, stop looking.
 
-        :param kwargs: Keyword arguments to be passed into SoupSieve's 
+        :param kwargs: Keyword arguments to be passed into SoupSieve's
            soupsieve.select() method.
 
         :return: A ResultSet of Tags.
         :rtype: bs4.element.ResultSet
         """
-        if namespaces is None:
-            namespaces = self._namespaces
-        
-        if limit is None:
-            limit = 0
-        if soupsieve is None:
-            raise NotImplementedError(
-                "Cannot execute CSS selectors because the soupsieve package is not installed."
-            )
-            
-        results = soupsieve.select(selector, self, namespaces, limit, **kwargs)
+        return self.css.select(selector, namespaces, limit, **kwargs)
 
-        # We do this because it's more consistent and because
-        # ResultSet.__getattr__ has a helpful error message.
-        return ResultSet(None, results)
+    @property
+    def css(self):
+        """Return an interface to the CSS selector API."""
+        return CSS(self)
 
     # Old names for backwards compatibility
     def childGenerator(self):
@@ -2038,7 +2158,7 @@ class SoupStrainer(object):
         :param attrs: A dictionary of filters on attribute values.
         :param string: A filter for a NavigableString with specific text.
         :kwargs: A dictionary of filters on attribute values.
-        """        
+        """
         if string is None and 'text' in kwargs:
             string = kwargs.pop('text')
             warnings.warn(
@@ -2137,7 +2257,7 @@ class SoupStrainer(object):
             # looking at a tag with a different name.
             if markup and not markup.prefix and self.name != markup.name:
                  return False
-            
+
         call_function_with_tag_data = (
             isinstance(self.name, Callable)
             and not isinstance(markup_name, Tag))
@@ -2223,7 +2343,7 @@ class SoupStrainer(object):
             if self._matches(' '.join(markup), match_against):
                 return True
             return False
-        
+
         if match_against is True:
             # True matches any non-None value.
             return markup is not None
@@ -2267,11 +2387,11 @@ class SoupStrainer(object):
                         return True
             else:
                 return False
-        
+
         # Beyond this point we might need to run the test twice: once against
         # the tag's name and once against its prefixed name.
         match = False
-        
+
         if not match and isinstance(match_against, str):
             # Exact string match
             match = markup == match_against
diff --git a/lib/bs4/formatter.py b/lib/bs4/formatter.py
index 83cc1c5c..c821318d 100644
--- a/lib/bs4/formatter.py
+++ b/lib/bs4/formatter.py
@@ -97,7 +97,7 @@ class Formatter(EntitySubstitution):
         else:
             indent = ' '
         self.indent = indent
-        
+
     def substitute(self, ns):
         """Process a string that needs to undergo entity substitution.
         This may be a string encountered in an attribute value or as
diff --git a/lib/bs4/tests/__init__.py b/lib/bs4/tests/__init__.py
index f4d62db9..dbb1593e 100644
--- a/lib/bs4/tests/__init__.py
+++ b/lib/bs4/tests/__init__.py
@@ -297,37 +297,11 @@ class TreeBuilderSmokeTest(object):
             markup, multi_valued_attributes=multi_valued_attributes
         )
         assert soup.a['class'] == ['a', 'b', 'c']
-        
-    def test_fuzzed_input(self):
-        # This test centralizes in one place the various fuzz tests
-        # for Beautiful Soup created by the oss-fuzz project.
-        
-        # These strings superficially resemble markup, but they
-        # generally can't be parsed into anything. The best we can
-        # hope for is that parsing these strings won't crash the
-        # parser.
-        #
-        # n.b. This markup is commented out because these fuzz tests
-        # _do_ crash the parser. However the crashes are due to bugs
-        # in html.parser, not Beautiful Soup -- otherwise I'd fix the
-        # bugs!
-        
-        bad_markup = [
-            # https://bugs.chromium.org/p/oss-fuzz/issues/detail?id=28873
-            # https://github.com/guidovranken/python-library-fuzzers/blob/master/corp-html/519e5b4269a01185a0d5e76295251921da2f0700
-            # https://bugs.python.org/issue37747
-            #
-            #b'\n<![\xff\xfe\xfe\xcd\x00',
 
-            #https://github.com/guidovranken/python-library-fuzzers/blob/master/corp-html/de32aa55785be29bbc72a1a8e06b00611fb3d9f8
-            # https://bugs.python.org/issue34480
-            #
-            #b'<![n\x00'
-        ]
-        for markup in bad_markup:
-            with warnings.catch_warnings(record=False):
-                soup = self.soup(markup)
-        
+    def test_invalid_doctype(self):
+        markup = '<![if word]>content<![endif]>'
+        markup = '<!DOCTYPE html]ff>'
+        soup = self.soup(markup)
 
 class HTMLTreeBuilderSmokeTest(TreeBuilderSmokeTest):
 
@@ -577,8 +551,8 @@ Hello, world!
         """Whitespace must be preserved in <pre> and <textarea> tags,
         even if that would mean not prettifying the markup.
         """
-        pre_markup = "<pre>   </pre>"
-        textarea_markup = "<textarea> woo\nwoo  </textarea>"
+        pre_markup = "<pre>a   z</pre>\n"
+        textarea_markup = "<textarea> woo\nwoo  </textarea>\n"
         self.assert_soup(pre_markup)
         self.assert_soup(textarea_markup)
 
@@ -589,7 +563,7 @@ Hello, world!
         assert soup.textarea.prettify() == textarea_markup
 
         soup = self.soup("<textarea></textarea>")
-        assert soup.textarea.prettify() == "<textarea></textarea>"
+        assert soup.textarea.prettify() == "<textarea></textarea>\n"
 
     def test_nested_inline_elements(self):
         """Inline elements can be nested indefinitely."""
diff --git a/lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-4818336571064320.testcase b/lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-4818336571064320.testcase
new file mode 100644
index 00000000..b34be8b1
--- /dev/null
+++ b/lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-4818336571064320.testcase
@@ -0,0 +1 @@
+�<!DOCTyPEV PUBLIC'''�'
\ No newline at end of file
diff --git a/lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-4999465949331456.testcase b/lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-4999465949331456.testcase
new file mode 100644
index 00000000..dbeed3f5
--- /dev/null
+++ b/lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-4999465949331456.testcase
@@ -0,0 +1 @@
+)<a><math><TR><a><mI><a><p><a>
\ No newline at end of file
diff --git a/lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-5167584867909632.testcase b/lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-5167584867909632.testcase
new file mode 100644
index 0000000000000000000000000000000000000000..0fe66dd23fe94a8e451dfb1a84da38ed0984c1f9
GIT binary patch
literal 19469
zcmeHP%}&BV5UwW1c<}1c&|0d-m{hN9YYZMVF=z-E6E3Azz?Aa07`*ugp1gb37w}np
z1J6Ey_J;^Y+hVrDb~+?vcLObSXLo15`M%w!71Cc4g4b8Y>@_=7*S$g~EsGkt2Bn={
zt2=1kXi~B5P|KmamD`Rb<;<X^nGK`Yx2QItS06grU)?6usM(fI$_MX{ch5wFbf-~=
z6<|JH^0p&7#8HrZKh1kQWpOUUvtoAEVYFQ;ym8Bm7qS&0Kp&aQ>p=_zIm%<U;o4d^
z3(+uhKXH#5?6O64qxL(Jc?&Snf;%C?Fi|Ez5wF95)p-6CR(XB80A!~DYtJVEfRF}S
z@`dl2h>4C&qy-Vu088oOsuGz>Kq!-D0_0%~Ls_F?gfesF!B~xlP=*UCbCH?n*-O%0
z!Q*F>?46hl=N3}p9^s$pfQ;#K?C}VRg&?#Cu4<z#ND}HckaI%yP7L#SLd2u9V&wvy
zMrnpVaE1%AQl~FU{ZeyF@7)`fe!HRA)D~awsb6s$rwVaDHzvR1)y3di?;8KJYOm_Z
zJ9$SwKdc<*FL#>Gl`M+NhN`Lsc{A^94o$;0t3y>S870B{5&zz9DFt<}-BMx(8V;~9
zu^`3{e->4K<9oQkG(Mym>pheEPdQ^GK5fr%nc+{ydd)pa{!emW8I*DurdQ@~y8Kk4
zgV7-WU60=nl>ER&`8c&A8JzU^4}@gt+g^h^gT@rwKLtV<2l@NX63OYId;^?(0~P60
z?9W6QN1A0E6WR+_CBVe3&|S@XJ2R{CP{xr=dJz@rVH;L3n4Q9zrUy|Y_Y}rG!O4js
mqyYzMPzM!p)C@wIG(#Cwq{BE*384&|DuI`yvfSgo2>k@d3|T1v

literal 0
HcmV?d00001

diff --git a/lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-5703933063462912.testcase b/lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-5703933063462912.testcase
new file mode 100644
index 00000000..367106c7
--- /dev/null
+++ b/lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-5703933063462912.testcase
@@ -0,0 +1,2 @@
+
+<![ 
\ No newline at end of file
diff --git a/lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-5843991618256896.testcase b/lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-5843991618256896.testcase
new file mode 100644
index 00000000..b8536ef0
--- /dev/null
+++ b/lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-5843991618256896.testcase
@@ -0,0 +1 @@
+-<math><sElect><mi><sElect><sElect>
\ No newline at end of file
diff --git a/lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-5984173902397440.testcase b/lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-5984173902397440.testcase
new file mode 100644
index 0000000000000000000000000000000000000000..d8b549c55aa2fa4988dc1097054c8a995542a271
GIT binary patch
literal 51495
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

literal 0
HcmV?d00001

diff --git a/lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-6124268085182464.testcase b/lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-6124268085182464.testcase
new file mode 100644
index 00000000..123e56d4
--- /dev/null
+++ b/lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-6124268085182464.testcase
@@ -0,0 +1 @@
+)<math><math><math><math><math><math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&)<math><math><annotation-xul>&
\ No newline at end of file
diff --git a/lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-6241471367348224.testcase b/lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-6241471367348224.testcase
new file mode 100644
index 00000000..2831c484
--- /dev/null
+++ b/lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-6241471367348224.testcase
@@ -0,0 +1 @@
+�<table><svg><html>
\ No newline at end of file
diff --git a/lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-6450958476902400.testcase b/lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-6450958476902400.testcase
new file mode 100644
index 0000000000000000000000000000000000000000..a823d557b4bebed8a9cdb880d281c9de69a1aa0a
GIT binary patch
literal 3546
zcmdP2$xSTDup1>uLtr!nMnhmU1V%$(Gz3ONU^E0qLtw~<Kw@5=e@S9VW`2DEgB|l|
OJ9jh$hIa^{rgs27o$$l}

literal 0
HcmV?d00001

diff --git a/lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-6600557255327744.testcase b/lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-6600557255327744.testcase
new file mode 100644
index 0000000000000000000000000000000000000000..65af44d8c1bdb043fa6810902e1ce623533bd34a
GIT binary patch
literal 124
zcmd<I32}7takaCtQM9uLVi2uolarckXH$}4muY8{XlIj~Si-<)lbgu^VQ1KZ<!o|2
u?UFMRi&9cc68{5%4P4Zw1_~T)ic^6`mDt(X6_(oX1DcZoRg{?u6afH;Au9m@

literal 0
HcmV?d00001

diff --git a/lib/bs4/tests/fuzz/crash-0d306a50c8ed8bcd0785b67000fcd5dea1d33f08.testcase b/lib/bs4/tests/fuzz/crash-0d306a50c8ed8bcd0785b67000fcd5dea1d33f08.testcase
new file mode 100644
index 0000000000000000000000000000000000000000..5559adbb352524a8992fcae8243952cb82d01d27
GIT binary patch
literal 2607
zcmcgu&2H2%5Z(fZk~iRhG>uwSNNv*}xU^oQ<wpXEQXwu#2&vA-X`&`^nm7xUcnKsf
zhzH@sp(^_T9Jp}c0(V{jX&L8llig&stq>!vv$DtbH{XnB<{4q&MBMIvxRFa&-_pUv
zaZ?A@)wk1eCmnC=bU*Q=8+sfD%u9F-wunGF9Af5kU{XeIH<5gU7$((-<qjy3%rret
z3~5muA~i6az^_^!D|wuQYjyP<9rvIb>f1t0?R%dI;Jq*Qch%_#M(x|K>?1-n+*fFB
zm6{d^8#<{hj+7bdpv`Q#2CcfFkUioNUyXr5z+=fRP%u7K(G*r#6$M^Z_&u?|;XuBN
z@N6(okxftZk53XI6>lL`P<epY&Z0BLJhoL~&P}_J1()+f;gRJAS1yl3K)Gash!!F*
z2O|rkN;u36FTsc%VIap`Qev*WzM>*y0e{H4&t=5>jM|{*N|q#^8%sAhqM+Y3%AITJ
zj+ie=x^@H_p!D;o#ZMNvPoPiY!4dto?gr%>8ZfxWSt4CK@!+{gLI_zD^Y~@@!h9AT
z<J77`0)0oV$j*;z#F4&7q4*e2N8~FIqgPDi%SM3n?@<5jd}?WGA{e=$q@a<d2M70W
z%1n?3{DU|7OgaWVHt{_ZGhduk&ZnC{Z72}lpYHithP(lP#mX7hJj9)m_X^%RQWENc
z?>hwtJ(69K8%&(5%E2fpgGkYsM!X=s?z8oHP}&TI@w9WRoXm;n8Ha{-ib=yrZ_~b;
zLif2&eN24}r`0u!2Q^n!;Z(g+b!QW%0&VHg*@TwX)&r$x>#WdFWGZjuEVhzaKfVQc
zE1wv%%}(9W_#3HHZI>9f_+=c57M9cCNo@`2bnw)yoeHG+-$q-W|1arjzM|GxoYGoC
z;*bTH!DdtxtcOJ%%uC0=se>6mD|1!l76U4^eq4Nq!{I_ly+tmKJqqfTb*ceU6z362
ztyNgQGww04iSboml65FWdBXI!jzWnWgo#v19R>P(S{7XznX3V~Twq+Re44__&~>h>
q43wHvMb7{ew`wA?1}AsyPlT5DF{Md(5}xqoqavh!LXgNIAN~adfn_KF

literal 0
HcmV?d00001

diff --git a/lib/bs4/tests/test_css.py b/lib/bs4/tests/test_css.py
new file mode 100644
index 00000000..359dbcd2
--- /dev/null
+++ b/lib/bs4/tests/test_css.py
@@ -0,0 +1,487 @@
+import pytest
+import types
+from unittest.mock import MagicMock
+
+from bs4 import (
+    CSS,
+    BeautifulSoup,
+    ResultSet,
+)
+
+from . import (
+    SoupTest,
+    SOUP_SIEVE_PRESENT,
+)
+
+if SOUP_SIEVE_PRESENT:
+    from soupsieve import SelectorSyntaxError
+
+
+@pytest.mark.skipif(not SOUP_SIEVE_PRESENT, reason="Soup Sieve not installed")
+class TestCSSSelectors(SoupTest):
+    """Test basic CSS selector functionality.
+
+    This functionality is implemented in soupsieve, which has a much
+    more comprehensive test suite, so this is basically an extra check
+    that soupsieve works as expected.
+    """
+
+    HTML = """
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
+"http://www.w3.org/TR/html4/strict.dtd">
+<html>
+<head>
+<title>The title</title>
+<link rel="stylesheet" href="blah.css" type="text/css" id="l1">
+</head>
+<body>
+<custom-dashed-tag class="dashed" id="dash1">Hello there.</custom-dashed-tag>
+<div id="main" class="fancy">
+<div id="inner">
+<h1 id="header1">An H1</h1>
+<p>Some text</p>
+<p class="onep" id="p1">Some more text</p>
+<h2 id="header2">An H2</h2>
+<p class="class1 class2 class3" id="pmulti">Another</p>
+<a href="http://bob.example.org/" rel="friend met" id="bob">Bob</a>
+<h2 id="header3">Another H2</h2>
+<a id="me" href="http://simonwillison.net/" rel="me">me</a>
+<span class="s1">
+<a href="#" id="s1a1">span1a1</a>
+<a href="#" id="s1a2">span1a2 <span id="s1a2s1">test</span></a>
+<span class="span2">
+<a href="#" id="s2a1">span2a1</a>
+</span>
+<span class="span3"></span>
+<custom-dashed-tag class="dashed" id="dash2"/>
+<div data-tag="dashedvalue" id="data1"/>
+</span>
+</div>
+<x id="xid">
+<z id="zida"/>
+<z id="zidab"/>
+<z id="zidac"/>
+</x>
+<y id="yid">
+<z id="zidb"/>
+</y>
+<p lang="en" id="lang-en">English</p>
+<p lang="en-gb" id="lang-en-gb">English UK</p>
+<p lang="en-us" id="lang-en-us">English US</p>
+<p lang="fr" id="lang-fr">French</p>
+</div>
+
+<div id="footer">
+</div>
+"""
+
+    def setup_method(self):
+        self.soup = BeautifulSoup(self.HTML, 'html.parser')
+
+    def assert_selects(self, selector, expected_ids, **kwargs):
+        results = self.soup.select(selector, **kwargs)
+        assert isinstance(results, ResultSet)
+        el_ids = [el['id'] for el in results]
+        el_ids.sort()
+        expected_ids.sort()
+        assert expected_ids == el_ids, "Selector %s, expected [%s], got [%s]" % (
+                selector, ', '.join(expected_ids), ', '.join(el_ids)
+        )
+
+    assertSelect = assert_selects
+
+    def assert_select_multiple(self, *tests):
+        for selector, expected_ids in tests:
+            self.assert_selects(selector, expected_ids)
+
+    def test_precompiled(self):
+        sel = self.soup.css.compile('div')
+
+        els = self.soup.select(sel)
+        assert len(els) == 4
+        for div in els:
+            assert div.name == 'div'
+
+        el = self.soup.select_one(sel)
+        assert 'main' == el['id']
+
+    def test_one_tag_one(self):
+        els = self.soup.select('title')
+        assert len(els) == 1
+        assert els[0].name == 'title'
+        assert els[0].contents == ['The title']
+
+    def test_one_tag_many(self):
+        els = self.soup.select('div')
+        assert len(els) == 4
+        for div in els:
+            assert div.name == 'div'
+
+        el = self.soup.select_one('div')
+        assert 'main' == el['id']
+
+    def test_select_one_returns_none_if_no_match(self):
+        match = self.soup.select_one('nonexistenttag')
+        assert None == match
+
+
+    def test_tag_in_tag_one(self):
+        els = self.soup.select('div div')
+        self.assert_selects('div div', ['inner', 'data1'])
+
+    def test_tag_in_tag_many(self):
+        for selector in ('html div', 'html body div', 'body div'):
+            self.assert_selects(selector, ['data1', 'main', 'inner', 'footer'])
+
+
+    def test_limit(self):
+        self.assert_selects('html div', ['main'], limit=1)
+        self.assert_selects('html body div', ['inner', 'main'], limit=2)
+        self.assert_selects('body div', ['data1', 'main', 'inner', 'footer'],
+                           limit=10)
+
+    def test_tag_no_match(self):
+        assert len(self.soup.select('del')) == 0
+
+    def test_invalid_tag(self):
+        with pytest.raises(SelectorSyntaxError):
+            self.soup.select('tag%t')
+
+    def test_select_dashed_tag_ids(self):
+        self.assert_selects('custom-dashed-tag', ['dash1', 'dash2'])
+
+    def test_select_dashed_by_id(self):
+        dashed = self.soup.select('custom-dashed-tag[id=\"dash2\"]')
+        assert dashed[0].name == 'custom-dashed-tag'
+        assert dashed[0]['id'] == 'dash2'
+
+    def test_dashed_tag_text(self):
+        assert self.soup.select('body > custom-dashed-tag')[0].text == 'Hello there.'
+
+    def test_select_dashed_matches_find_all(self):
+        assert self.soup.select('custom-dashed-tag') == self.soup.find_all('custom-dashed-tag')
+
+    def test_header_tags(self):
+        self.assert_select_multiple(
+            ('h1', ['header1']),
+            ('h2', ['header2', 'header3']),
+        )
+
+    def test_class_one(self):
+        for selector in ('.onep', 'p.onep', 'html p.onep'):
+            els = self.soup.select(selector)
+            assert len(els) == 1
+            assert els[0].name == 'p'
+            assert els[0]['class'] == ['onep']
+
+    def test_class_mismatched_tag(self):
+        els = self.soup.select('div.onep')
+        assert len(els) == 0
+
+    def test_one_id(self):
+        for selector in ('div#inner', '#inner', 'div div#inner'):
+            self.assert_selects(selector, ['inner'])
+
+    def test_bad_id(self):
+        els = self.soup.select('#doesnotexist')
+        assert len(els) == 0
+
+    def test_items_in_id(self):
+        els = self.soup.select('div#inner p')
+        assert len(els) == 3
+        for el in els:
+            assert el.name == 'p'
+        assert els[1]['class'] == ['onep']
+        assert not els[0].has_attr('class')
+
+    def test_a_bunch_of_emptys(self):
+        for selector in ('div#main del', 'div#main div.oops', 'div div#main'):
+            assert len(self.soup.select(selector)) == 0
+
+    def test_multi_class_support(self):
+        for selector in ('.class1', 'p.class1', '.class2', 'p.class2',
+            '.class3', 'p.class3', 'html p.class2', 'div#inner .class2'):
+            self.assert_selects(selector, ['pmulti'])
+
+    def test_multi_class_selection(self):
+        for selector in ('.class1.class3', '.class3.class2',
+                         '.class1.class2.class3'):
+            self.assert_selects(selector, ['pmulti'])
+
+    def test_child_selector(self):
+        self.assert_selects('.s1 > a', ['s1a1', 's1a2'])
+        self.assert_selects('.s1 > a span', ['s1a2s1'])
+
+    def test_child_selector_id(self):
+        self.assert_selects('.s1 > a#s1a2 span', ['s1a2s1'])
+
+    def test_attribute_equals(self):
+        self.assert_select_multiple(
+            ('p[class="onep"]', ['p1']),
+            ('p[id="p1"]', ['p1']),
+            ('[class="onep"]', ['p1']),
+            ('[id="p1"]', ['p1']),
+            ('link[rel="stylesheet"]', ['l1']),
+            ('link[type="text/css"]', ['l1']),
+            ('link[href="blah.css"]', ['l1']),
+            ('link[href="no-blah.css"]', []),
+            ('[rel="stylesheet"]', ['l1']),
+            ('[type="text/css"]', ['l1']),
+            ('[href="blah.css"]', ['l1']),
+            ('[href="no-blah.css"]', []),
+            ('p[href="no-blah.css"]', []),
+            ('[href="no-blah.css"]', []),
+        )
+
+    def test_attribute_tilde(self):
+        self.assert_select_multiple(
+            ('p[class~="class1"]', ['pmulti']),
+            ('p[class~="class2"]', ['pmulti']),
+            ('p[class~="class3"]', ['pmulti']),
+            ('[class~="class1"]', ['pmulti']),
+            ('[class~="class2"]', ['pmulti']),
+            ('[class~="class3"]', ['pmulti']),
+            ('a[rel~="friend"]', ['bob']),
+            ('a[rel~="met"]', ['bob']),
+            ('[rel~="friend"]', ['bob']),
+            ('[rel~="met"]', ['bob']),
+        )
+
+    def test_attribute_startswith(self):
+        self.assert_select_multiple(
+            ('[rel^="style"]', ['l1']),
+            ('link[rel^="style"]', ['l1']),
+            ('notlink[rel^="notstyle"]', []),
+            ('[rel^="notstyle"]', []),
+            ('link[rel^="notstyle"]', []),
+            ('link[href^="bla"]', ['l1']),
+            ('a[href^="http://"]', ['bob', 'me']),
+            ('[href^="http://"]', ['bob', 'me']),
+            ('[id^="p"]', ['pmulti', 'p1']),
+            ('[id^="m"]', ['me', 'main']),
+            ('div[id^="m"]', ['main']),
+            ('a[id^="m"]', ['me']),
+            ('div[data-tag^="dashed"]', ['data1'])
+        )
+
+    def test_attribute_endswith(self):
+        self.assert_select_multiple(
+            ('[href$=".css"]', ['l1']),
+            ('link[href$=".css"]', ['l1']),
+            ('link[id$="1"]', ['l1']),
+            ('[id$="1"]', ['data1', 'l1', 'p1', 'header1', 's1a1', 's2a1', 's1a2s1', 'dash1']),
+            ('div[id$="1"]', ['data1']),
+            ('[id$="noending"]', []),
+        )
+
+    def test_attribute_contains(self):
+        self.assert_select_multiple(
+            # From test_attribute_startswith
+            ('[rel*="style"]', ['l1']),
+            ('link[rel*="style"]', ['l1']),
+            ('notlink[rel*="notstyle"]', []),
+            ('[rel*="notstyle"]', []),
+            ('link[rel*="notstyle"]', []),
+            ('link[href*="bla"]', ['l1']),
+            ('[href*="http://"]', ['bob', 'me']),
+            ('[id*="p"]', ['pmulti', 'p1']),
+            ('div[id*="m"]', ['main']),
+            ('a[id*="m"]', ['me']),
+            # From test_attribute_endswith
+            ('[href*=".css"]', ['l1']),
+            ('link[href*=".css"]', ['l1']),
+            ('link[id*="1"]', ['l1']),
+            ('[id*="1"]', ['data1', 'l1', 'p1', 'header1', 's1a1', 's1a2', 's2a1', 's1a2s1', 'dash1']),
+            ('div[id*="1"]', ['data1']),
+            ('[id*="noending"]', []),
+            # New for this test
+            ('[href*="."]', ['bob', 'me', 'l1']),
+            ('a[href*="."]', ['bob', 'me']),
+            ('link[href*="."]', ['l1']),
+            ('div[id*="n"]', ['main', 'inner']),
+            ('div[id*="nn"]', ['inner']),
+            ('div[data-tag*="edval"]', ['data1'])
+        )
+
+    def test_attribute_exact_or_hypen(self):
+        self.assert_select_multiple(
+            ('p[lang|="en"]', ['lang-en', 'lang-en-gb', 'lang-en-us']),
+            ('[lang|="en"]', ['lang-en', 'lang-en-gb', 'lang-en-us']),
+            ('p[lang|="fr"]', ['lang-fr']),
+            ('p[lang|="gb"]', []),
+        )
+
+    def test_attribute_exists(self):
+        self.assert_select_multiple(
+            ('[rel]', ['l1', 'bob', 'me']),
+            ('link[rel]', ['l1']),
+            ('a[rel]', ['bob', 'me']),
+            ('[lang]', ['lang-en', 'lang-en-gb', 'lang-en-us', 'lang-fr']),
+            ('p[class]', ['p1', 'pmulti']),
+            ('[blah]', []),
+            ('p[blah]', []),
+            ('div[data-tag]', ['data1'])
+        )
+
+    def test_quoted_space_in_selector_name(self):
+        html = """<div style="display: wrong">nope</div>
+        <div style="display: right">yes</div>
+        """
+        soup = BeautifulSoup(html, 'html.parser')
+        [chosen] = soup.select('div[style="display: right"]')
+        assert "yes" == chosen.string
+
+    def test_unsupported_pseudoclass(self):
+        with pytest.raises(NotImplementedError):
+            self.soup.select("a:no-such-pseudoclass")
+
+        with pytest.raises(SelectorSyntaxError):
+            self.soup.select("a:nth-of-type(a)")
+
+    def test_nth_of_type(self):
+        # Try to select first paragraph
+        els = self.soup.select('div#inner p:nth-of-type(1)')
+        assert len(els) == 1
+        assert els[0].string == 'Some text'
+
+        # Try to select third paragraph
+        els = self.soup.select('div#inner p:nth-of-type(3)')
+        assert len(els) == 1
+        assert els[0].string == 'Another'
+
+        # Try to select (non-existent!) fourth paragraph
+        els = self.soup.select('div#inner p:nth-of-type(4)')
+        assert len(els) == 0
+
+        # Zero will select no tags.
+        els = self.soup.select('div p:nth-of-type(0)')
+        assert len(els) == 0
+
+    def test_nth_of_type_direct_descendant(self):
+        els = self.soup.select('div#inner > p:nth-of-type(1)')
+        assert len(els) == 1
+        assert els[0].string == 'Some text'
+
+    def test_id_child_selector_nth_of_type(self):
+        self.assert_selects('#inner > p:nth-of-type(2)', ['p1'])
+
+    def test_select_on_element(self):
+        # Other tests operate on the tree; this operates on an element
+        # within the tree.
+        inner = self.soup.find("div", id="main")
+        selected = inner.select("div")
+        # The <div id="inner"> tag was selected. The <div id="footer">
+        # tag was not.
+        self.assert_selects_ids(selected, ['inner', 'data1'])
+
+    def test_overspecified_child_id(self):
+        self.assert_selects(".fancy #inner", ['inner'])
+        self.assert_selects(".normal #inner", [])
+
+    def test_adjacent_sibling_selector(self):
+        self.assert_selects('#p1 + h2', ['header2'])
+        self.assert_selects('#p1 + h2 + p', ['pmulti'])
+        self.assert_selects('#p1 + #header2 + .class1', ['pmulti'])
+        assert [] == self.soup.select('#p1 + p')
+
+    def test_general_sibling_selector(self):
+        self.assert_selects('#p1 ~ h2', ['header2', 'header3'])
+        self.assert_selects('#p1 ~ #header2', ['header2'])
+        self.assert_selects('#p1 ~ h2 + a', ['me'])
+        self.assert_selects('#p1 ~ h2 + [rel="me"]', ['me'])
+        assert [] == self.soup.select('#inner ~ h2')
+
+    def test_dangling_combinator(self):
+        with pytest.raises(SelectorSyntaxError):
+            self.soup.select('h1 >')
+
+    def test_sibling_combinator_wont_select_same_tag_twice(self):
+        self.assert_selects('p[lang] ~ p', ['lang-en-gb', 'lang-en-us', 'lang-fr'])
+
+    # Test the selector grouping operator (the comma)
+    def test_multiple_select(self):
+        self.assert_selects('x, y', ['xid', 'yid'])
+
+    def test_multiple_select_with_no_space(self):
+        self.assert_selects('x,y', ['xid', 'yid'])
+
+    def test_multiple_select_with_more_space(self):
+        self.assert_selects('x,    y', ['xid', 'yid'])
+
+    def test_multiple_select_duplicated(self):
+        self.assert_selects('x, x', ['xid'])
+
+    def test_multiple_select_sibling(self):
+        self.assert_selects('x, y ~ p[lang=fr]', ['xid', 'lang-fr'])
+
+    def test_multiple_select_tag_and_direct_descendant(self):
+        self.assert_selects('x, y > z', ['xid', 'zidb'])
+
+    def test_multiple_select_direct_descendant_and_tags(self):
+        self.assert_selects('div > x, y, z', ['xid', 'yid', 'zida', 'zidb', 'zidab', 'zidac'])
+
+    def test_multiple_select_indirect_descendant(self):
+        self.assert_selects('div x,y,  z', ['xid', 'yid', 'zida', 'zidb', 'zidab', 'zidac'])
+
+    def test_invalid_multiple_select(self):
+        with pytest.raises(SelectorSyntaxError):
+            self.soup.select(',x, y')
+        with pytest.raises(SelectorSyntaxError):
+            self.soup.select('x,,y')
+
+    def test_multiple_select_attrs(self):
+        self.assert_selects('p[lang=en], p[lang=en-gb]', ['lang-en', 'lang-en-gb'])
+
+    def test_multiple_select_ids(self):
+        self.assert_selects('x, y > z[id=zida], z[id=zidab], z[id=zidb]', ['xid', 'zidb', 'zidab'])
+
+    def test_multiple_select_nested(self):
+        self.assert_selects('body > div > x, y > z', ['xid', 'zidb'])
+
+    def test_select_duplicate_elements(self):
+        # When markup contains duplicate elements, a multiple select
+        # will find all of them.
+        markup = '<div class="c1"/><div class="c2"/><div class="c1"/>'
+        soup = BeautifulSoup(markup, 'html.parser')
+        selected = soup.select(".c1, .c2")
+        assert 3 == len(selected)
+
+        # Verify that find_all finds the same elements, though because
+        # of an implementation detail it finds them in a different
+        # order.
+        for element in soup.find_all(class_=['c1', 'c2']):
+            assert element in selected
+
+    def test_closest(self):
+        inner = self.soup.find("div", id="inner")
+        closest = inner.css.closest("div[id=main]")
+        assert closest == self.soup.find("div", id="main")
+
+    def test_match(self):
+        inner = self.soup.find("div", id="inner")
+        main = self.soup.find("div", id="main")
+        assert inner.css.match("div[id=main]") == False
+        assert main.css.match("div[id=main]") == True
+
+    def test_iselect(self):
+        gen = self.soup.css.iselect("h2")
+        assert isinstance(gen, types.GeneratorType)
+        [header2, header3] = gen
+        assert header2['id'] == 'header2'
+        assert header3['id'] == 'header3'
+
+    def test_filter(self):
+        inner = self.soup.find("div", id="inner")
+        results = inner.css.filter("h2")
+        assert len(inner.css.filter("h2")) == 2
+
+        results = inner.css.filter("h2[id=header3]")
+        assert isinstance(results, ResultSet)
+        [result] = results
+        assert result['id'] == 'header3'
+
+    def test_escape(self):
+        m = self.soup.css.escape
+        assert m(".foo#bar") == '\\.foo\\#bar'
+        assert m("()[]{}") == '\\(\\)\\[\\]\\{\\}'
+        assert m(".foo") == self.soup.css.escape(".foo")
diff --git a/lib/bs4/tests/test_formatter.py b/lib/bs4/tests/test_formatter.py
index 84d4e3b2..528b16d5 100644
--- a/lib/bs4/tests/test_formatter.py
+++ b/lib/bs4/tests/test_formatter.py
@@ -80,20 +80,20 @@ class TestFormatter(SoupTest):
     @pytest.mark.parametrize(
         "indent,expect",
         [
-            (None, '<a>\n<b>\ntext\n</b>\n</a>'),
-            (-1, '<a>\n<b>\ntext\n</b>\n</a>'),
-            (0, '<a>\n<b>\ntext\n</b>\n</a>'),
-            ("", '<a>\n<b>\ntext\n</b>\n</a>'),
+            (None, '<a>\n<b>\ntext\n</b>\n</a>\n'),
+            (-1, '<a>\n<b>\ntext\n</b>\n</a>\n'),
+            (0, '<a>\n<b>\ntext\n</b>\n</a>\n'),
+            ("", '<a>\n<b>\ntext\n</b>\n</a>\n'),
 
-            (1, '<a>\n <b>\n  text\n </b>\n</a>'),
-            (2, '<a>\n  <b>\n    text\n  </b>\n</a>'),
+            (1, '<a>\n <b>\n  text\n </b>\n</a>\n'),
+            (2, '<a>\n  <b>\n    text\n  </b>\n</a>\n'),
 
-            ("\t", '<a>\n\t<b>\n\t\ttext\n\t</b>\n</a>'),
-            ('abc', '<a>\nabc<b>\nabcabctext\nabc</b>\n</a>'),
+            ("\t", '<a>\n\t<b>\n\t\ttext\n\t</b>\n</a>\n'),
+            ('abc', '<a>\nabc<b>\nabcabctext\nabc</b>\n</a>\n'),
 
             # Some invalid inputs -- the default behavior is used.
-            (object(), '<a>\n <b>\n  text\n </b>\n</a>'),
-            (b'bytes', '<a>\n <b>\n  text\n </b>\n</a>'),
+            (object(), '<a>\n <b>\n  text\n </b>\n</a>\n'),
+            (b'bytes', '<a>\n <b>\n  text\n </b>\n</a>\n'),
         ]
     )
     def test_indent(self, indent, expect):
diff --git a/lib/bs4/tests/test_fuzz.py b/lib/bs4/tests/test_fuzz.py
new file mode 100644
index 00000000..f778539a
--- /dev/null
+++ b/lib/bs4/tests/test_fuzz.py
@@ -0,0 +1,91 @@
+"""This file contains test cases reported by third parties using
+fuzzing tools, primarily from Google's oss-fuzz project. Some of these
+represent real problems with Beautiful Soup, but many are problems in
+libraries that Beautiful Soup depends on, and many of the test cases
+represent different ways of triggering the same problem.
+
+Grouping these test cases together makes it easy to see which test
+cases represent the same problem, and puts the test cases in close
+proximity to code that can trigger the problems.
+"""
+import os
+import pytest
+from bs4 import (
+    BeautifulSoup,
+    ParserRejectedMarkup,
+)
+
+class TestFuzz(object):
+
+    # Test case markup files from fuzzers are given this extension so
+    # they can be included in builds.
+    TESTCASE_SUFFIX = ".testcase"
+
+    # This class of error has been fixed by catching a less helpful
+    # exception from html.parser and raising ParserRejectedMarkup
+    # instead.
+    @pytest.mark.parametrize(
+        "filename", [
+            "clusterfuzz-testcase-minimized-bs4_fuzzer-5703933063462912",
+        ]
+    )
+    def test_rejected_markup(self, filename):
+        markup = self.__markup(filename)
+        with pytest.raises(ParserRejectedMarkup):
+            BeautifulSoup(markup, 'html.parser')
+
+    # This class of error has to do with very deeply nested documents
+    # which overflow the Python call stack when the tree is converted
+    # to a string. This is an issue with Beautiful Soup which was fixed
+    # as part of [bug=1471755].
+    @pytest.mark.parametrize(
+        "filename", [
+            "clusterfuzz-testcase-minimized-bs4_fuzzer-5984173902397440",
+            "clusterfuzz-testcase-minimized-bs4_fuzzer-5167584867909632",
+            "clusterfuzz-testcase-minimized-bs4_fuzzer-6124268085182464",
+            "clusterfuzz-testcase-minimized-bs4_fuzzer-6450958476902400",
+        ]
+    )
+    def test_deeply_nested_document(self, filename):
+        # Parsing the document and encoding it back to a string is
+        # sufficient to demonstrate that the overflow problem has
+        # been fixed.
+        markup = self.__markup(filename)
+        BeautifulSoup(markup, 'html.parser').encode()
+
+    # This class of error represents problems with html5lib's parser,
+    # not Beautiful Soup. I use
+    # https://github.com/html5lib/html5lib-python/issues/568 to notify
+    # the html5lib developers of these issues.
+    @pytest.mark.skip("html5lib problems")
+    @pytest.mark.parametrize(
+        "filename", [
+            # b"""ÿ<!DOCTyPEV PUBLIC'''Ð'"""
+            "clusterfuzz-testcase-minimized-bs4_fuzzer-4818336571064320",
+
+            # b')<a><math><TR><a><mI><a><p><a>'
+            "clusterfuzz-testcase-minimized-bs4_fuzzer-4999465949331456",
+
+            # b'-<math><sElect><mi><sElect><sElect>'
+            "clusterfuzz-testcase-minimized-bs4_fuzzer-5843991618256896",
+
+            # b'ñ<table><svg><html>'
+            "clusterfuzz-testcase-minimized-bs4_fuzzer-6241471367348224",
+
+            # <TABLE>, some ^@ characters, some <math> tags.
+            "clusterfuzz-testcase-minimized-bs4_fuzzer-6600557255327744",
+
+            # Nested table
+            "crash-0d306a50c8ed8bcd0785b67000fcd5dea1d33f08"
+        ]
+    )
+    def test_html5lib_parse_errors(self, filename):
+        markup = self.__markup(filename)
+        print(BeautifulSoup(markup, 'html5lib').encode())
+
+    def __markup(self, filename):
+        if not filename.endswith(self.TESTCASE_SUFFIX):
+            filename += self.TESTCASE_SUFFIX
+        this_dir = os.path.split(__file__)[0]
+        path = os.path.join(this_dir, 'fuzz', filename)
+        return open(path, 'rb').read()
diff --git a/lib/bs4/tests/test_htmlparser.py b/lib/bs4/tests/test_htmlparser.py
index 470d3936..a1195d81 100644
--- a/lib/bs4/tests/test_htmlparser.py
+++ b/lib/bs4/tests/test_htmlparser.py
@@ -3,9 +3,11 @@ trees."""
 
 from pdb import set_trace
 import pickle
+import pytest
 import warnings
 from bs4.builder import (
     HTMLParserTreeBuilder,
+    ParserRejectedMarkup,
     XMLParsedAsHTMLWarning,
 )
 from bs4.builder._htmlparser import BeautifulSoupHTMLParser
@@ -15,6 +17,28 @@ class TestHTMLParserTreeBuilder(SoupTest, HTMLTreeBuilderSmokeTest):
 
     default_builder = HTMLParserTreeBuilder
 
+    def test_rejected_input(self):
+        # Python's html.parser will occasionally reject markup,
+        # especially when there is a problem with the initial DOCTYPE
+        # declaration. Different versions of Python sound the alarm in
+        # different ways, but Beautiful Soup consistently raises
+        # errors as ParserRejectedMarkup exceptions.
+        bad_markup = [
+            # https://bugs.chromium.org/p/oss-fuzz/issues/detail?id=28873
+            # https://github.com/guidovranken/python-library-fuzzers/blob/master/corp-html/519e5b4269a01185a0d5e76295251921da2f0700
+            # https://github.com/python/cpython/issues/81928
+            b'\n<![\xff\xfe\xfe\xcd\x00',
+
+            #https://github.com/guidovranken/python-library-fuzzers/blob/master/corp-html/de32aa55785be29bbc72a1a8e06b00611fb3d9f8
+            # https://github.com/python/cpython/issues/78661
+            #
+            b'<![n\x00',
+            b"<![UNKNOWN[]]>",
+        ]
+        for markup in bad_markup:
+            with pytest.raises(ParserRejectedMarkup):
+                soup = self.soup(markup)
+    
     def test_namespaced_system_doctype(self):
         # html.parser can't handle namespaced doctypes, so skip this one.
         pass
diff --git a/lib/bs4/tests/test_lxml.py b/lib/bs4/tests/test_lxml.py
index c7bf45d3..5065b6fc 100644
--- a/lib/bs4/tests/test_lxml.py
+++ b/lib/bs4/tests/test_lxml.py
@@ -189,13 +189,15 @@ class TestLXMLXMLTreeBuilder(SoupTest, XMLTreeBuilderSmokeTest):
         assert soup.find('prefix:tag3').name == 'tag3'
         assert soup.subtag.find('prefix:tag3').name == 'tag3'
 
-    def test_pickle_removes_builder(self):
-        # The lxml TreeBuilder is not picklable, so it won't be
-        # preserved in a pickle/unpickle operation.
-
+    def test_pickle_restores_builder(self):
+        # The lxml TreeBuilder is not picklable, so when unpickling
+        # a document created with it, a new TreeBuilder of the
+        # appropriate class is created.
         soup = self.soup("<a>some markup</a>")
         assert isinstance(soup.builder, self.default_builder)
         pickled = pickle.dumps(soup)
         unpickled = pickle.loads(pickled)
+
         assert "some markup" == unpickled.a.string
-        assert unpickled.builder is None
+        assert unpickled.builder != soup.builder
+        assert isinstance(unpickled.builder, self.default_builder)
diff --git a/lib/bs4/tests/test_pageelement.py b/lib/bs4/tests/test_pageelement.py
index 6674dadf..24f9385d 100644
--- a/lib/bs4/tests/test_pageelement.py
+++ b/lib/bs4/tests/test_pageelement.py
@@ -2,20 +2,18 @@
 import copy
 import pickle
 import pytest
+import sys
 
 from bs4 import BeautifulSoup
 from bs4.element import (
     Comment,
+    ResultSet,
     SoupStrainer,
 )
 from . import (
     SoupTest,
-    SOUP_SIEVE_PRESENT,
 )
 
-if SOUP_SIEVE_PRESENT:
-    from soupsieve import SelectorSyntaxError
-
 class TestEncoding(SoupTest):
     """Test the ability to encode objects into strings."""
 
@@ -51,10 +49,21 @@ class TestEncoding(SoupTest):
         assert "\N{SNOWMAN}".encode("utf8") == soup.b.encode_contents(
             encoding="utf8"
         )
+        
+    def test_encode_deeply_nested_document(self):
+        # This test verifies that encoding a string doesn't involve
+        # any recursive function calls. If it did, this test would
+        # overflow the Python interpreter stack.
+        limit = sys.getrecursionlimit() + 1
+        markup = "<span>" * limit
+        soup = self.soup(markup)
+        encoded = soup.encode()
+        assert limit == encoded.count(b"<span>")
 
     def test_deprecated_renderContents(self):
         html = "<b>\N{SNOWMAN}</b>"
         soup = self.soup(html)
+        soup.renderContents()
         assert "\N{SNOWMAN}".encode("utf8") == soup.b.renderContents()
 
     def test_repr(self):
@@ -159,7 +168,31 @@ class TestFormatters(SoupTest):
         soup = self.soup("<div>  foo  <pre>  \tbar\n  \n  </pre>  baz  <textarea> eee\nfff\t</textarea></div>")
         # Everything outside the <pre> tag is reformatted, but everything
         # inside is left alone.
-        assert '<div>\n foo\n <pre>  \tbar\n  \n  </pre>\n baz\n <textarea> eee\nfff\t</textarea>\n</div>' == soup.div.prettify()
+        assert '<div>\n foo\n <pre>  \tbar\n  \n  </pre>\n baz\n <textarea> eee\nfff\t</textarea>\n</div>\n' == soup.div.prettify()
+
+    def test_prettify_handles_nested_string_literal_tags(self):
+        # Most of this markup is inside a <pre> tag, so prettify()
+        # only does three things to it:
+        # 1. Add a newline and a space between the <div> and the <pre>
+        # 2. Add a newline after the </pre>
+        # 3. Add a newline at the end.
+        #
+        # The contents of the <pre> tag are left completely alone.  In
+        # particular, we don't start adding whitespace again once we
+        # encounter the first </pre> tag, because we know it's not
+        # the one that put us into string literal mode.
+        markup = """<div><pre><code>some
+<script><pre>code</pre></script> for you 
+</code></pre></div>"""
+
+        expect = """<div>
+ <pre><code>some
+<script><pre>code</pre></script> for you 
+</code></pre>
+</div>
+"""
+        soup = self.soup(markup)
+        assert expect == soup.div.prettify()
 
     def test_prettify_accepts_formatter_function(self):
         soup = BeautifulSoup("<html><body>foo</body></html>", 'html.parser')
@@ -216,429 +249,6 @@ class TestFormatters(SoupTest):
         assert soup.contents[0].name == 'pre'
 
 
-@pytest.mark.skipif(not SOUP_SIEVE_PRESENT, reason="Soup Sieve not installed")
-class TestCSSSelectors(SoupTest):
-    """Test basic CSS selector functionality.
-
-    This functionality is implemented in soupsieve, which has a much
-    more comprehensive test suite, so this is basically an extra check
-    that soupsieve works as expected.
-    """
-
-    HTML = """
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
-"http://www.w3.org/TR/html4/strict.dtd">
-<html>
-<head>
-<title>The title</title>
-<link rel="stylesheet" href="blah.css" type="text/css" id="l1">
-</head>
-<body>
-<custom-dashed-tag class="dashed" id="dash1">Hello there.</custom-dashed-tag>
-<div id="main" class="fancy">
-<div id="inner">
-<h1 id="header1">An H1</h1>
-<p>Some text</p>
-<p class="onep" id="p1">Some more text</p>
-<h2 id="header2">An H2</h2>
-<p class="class1 class2 class3" id="pmulti">Another</p>
-<a href="http://bob.example.org/" rel="friend met" id="bob">Bob</a>
-<h2 id="header3">Another H2</h2>
-<a id="me" href="http://simonwillison.net/" rel="me">me</a>
-<span class="s1">
-<a href="#" id="s1a1">span1a1</a>
-<a href="#" id="s1a2">span1a2 <span id="s1a2s1">test</span></a>
-<span class="span2">
-<a href="#" id="s2a1">span2a1</a>
-</span>
-<span class="span3"></span>
-<custom-dashed-tag class="dashed" id="dash2"/>
-<div data-tag="dashedvalue" id="data1"/>
-</span>
-</div>
-<x id="xid">
-<z id="zida"/>
-<z id="zidab"/>
-<z id="zidac"/>
-</x>
-<y id="yid">
-<z id="zidb"/>
-</y>
-<p lang="en" id="lang-en">English</p>
-<p lang="en-gb" id="lang-en-gb">English UK</p>
-<p lang="en-us" id="lang-en-us">English US</p>
-<p lang="fr" id="lang-fr">French</p>
-</div>
-
-<div id="footer">
-</div>
-"""
-
-    def setup_method(self):
-        self.soup = BeautifulSoup(self.HTML, 'html.parser')
-
-    def assert_selects(self, selector, expected_ids, **kwargs):
-        el_ids = [el['id'] for el in self.soup.select(selector, **kwargs)]
-        el_ids.sort()
-        expected_ids.sort()
-        assert expected_ids == el_ids, "Selector %s, expected [%s], got [%s]" % (
-                selector, ', '.join(expected_ids), ', '.join(el_ids)
-        )
-
-    assertSelect = assert_selects
-
-    def assert_select_multiple(self, *tests):
-        for selector, expected_ids in tests:
-            self.assert_selects(selector, expected_ids)
-
-    def test_one_tag_one(self):
-        els = self.soup.select('title')
-        assert len(els) == 1
-        assert els[0].name == 'title'
-        assert els[0].contents == ['The title']
-
-    def test_one_tag_many(self):
-        els = self.soup.select('div')
-        assert len(els) == 4
-        for div in els:
-            assert div.name == 'div'
-
-        el = self.soup.select_one('div')
-        assert 'main' == el['id']
-
-    def test_select_one_returns_none_if_no_match(self):
-        match = self.soup.select_one('nonexistenttag')
-        assert None == match
-
-
-    def test_tag_in_tag_one(self):
-        els = self.soup.select('div div')
-        self.assert_selects('div div', ['inner', 'data1'])
-
-    def test_tag_in_tag_many(self):
-        for selector in ('html div', 'html body div', 'body div'):
-            self.assert_selects(selector, ['data1', 'main', 'inner', 'footer'])
-
-
-    def test_limit(self):
-        self.assert_selects('html div', ['main'], limit=1)
-        self.assert_selects('html body div', ['inner', 'main'], limit=2)
-        self.assert_selects('body div', ['data1', 'main', 'inner', 'footer'],
-                           limit=10)
-
-    def test_tag_no_match(self):
-        assert len(self.soup.select('del')) == 0
-
-    def test_invalid_tag(self):
-        with pytest.raises(SelectorSyntaxError):
-            self.soup.select('tag%t')
-
-    def test_select_dashed_tag_ids(self):
-        self.assert_selects('custom-dashed-tag', ['dash1', 'dash2'])
-
-    def test_select_dashed_by_id(self):
-        dashed = self.soup.select('custom-dashed-tag[id=\"dash2\"]')
-        assert dashed[0].name == 'custom-dashed-tag'
-        assert dashed[0]['id'] == 'dash2'
-
-    def test_dashed_tag_text(self):
-        assert self.soup.select('body > custom-dashed-tag')[0].text == 'Hello there.'
-
-    def test_select_dashed_matches_find_all(self):
-        assert self.soup.select('custom-dashed-tag') == self.soup.find_all('custom-dashed-tag')
-
-    def test_header_tags(self):
-        self.assert_select_multiple(
-            ('h1', ['header1']),
-            ('h2', ['header2', 'header3']),
-        )
-
-    def test_class_one(self):
-        for selector in ('.onep', 'p.onep', 'html p.onep'):
-            els = self.soup.select(selector)
-            assert len(els) == 1
-            assert els[0].name == 'p'
-            assert els[0]['class'] == ['onep']
-
-    def test_class_mismatched_tag(self):
-        els = self.soup.select('div.onep')
-        assert len(els) == 0
-
-    def test_one_id(self):
-        for selector in ('div#inner', '#inner', 'div div#inner'):
-            self.assert_selects(selector, ['inner'])
-
-    def test_bad_id(self):
-        els = self.soup.select('#doesnotexist')
-        assert len(els) == 0
-
-    def test_items_in_id(self):
-        els = self.soup.select('div#inner p')
-        assert len(els) == 3
-        for el in els:
-            assert el.name == 'p'
-        assert els[1]['class'] == ['onep']
-        assert not els[0].has_attr('class')
-
-    def test_a_bunch_of_emptys(self):
-        for selector in ('div#main del', 'div#main div.oops', 'div div#main'):
-            assert len(self.soup.select(selector)) == 0
-
-    def test_multi_class_support(self):
-        for selector in ('.class1', 'p.class1', '.class2', 'p.class2',
-            '.class3', 'p.class3', 'html p.class2', 'div#inner .class2'):
-            self.assert_selects(selector, ['pmulti'])
-
-    def test_multi_class_selection(self):
-        for selector in ('.class1.class3', '.class3.class2',
-                         '.class1.class2.class3'):
-            self.assert_selects(selector, ['pmulti'])
-
-    def test_child_selector(self):
-        self.assert_selects('.s1 > a', ['s1a1', 's1a2'])
-        self.assert_selects('.s1 > a span', ['s1a2s1'])
-
-    def test_child_selector_id(self):
-        self.assert_selects('.s1 > a#s1a2 span', ['s1a2s1'])
-
-    def test_attribute_equals(self):
-        self.assert_select_multiple(
-            ('p[class="onep"]', ['p1']),
-            ('p[id="p1"]', ['p1']),
-            ('[class="onep"]', ['p1']),
-            ('[id="p1"]', ['p1']),
-            ('link[rel="stylesheet"]', ['l1']),
-            ('link[type="text/css"]', ['l1']),
-            ('link[href="blah.css"]', ['l1']),
-            ('link[href="no-blah.css"]', []),
-            ('[rel="stylesheet"]', ['l1']),
-            ('[type="text/css"]', ['l1']),
-            ('[href="blah.css"]', ['l1']),
-            ('[href="no-blah.css"]', []),
-            ('p[href="no-blah.css"]', []),
-            ('[href="no-blah.css"]', []),
-        )
-
-    def test_attribute_tilde(self):
-        self.assert_select_multiple(
-            ('p[class~="class1"]', ['pmulti']),
-            ('p[class~="class2"]', ['pmulti']),
-            ('p[class~="class3"]', ['pmulti']),
-            ('[class~="class1"]', ['pmulti']),
-            ('[class~="class2"]', ['pmulti']),
-            ('[class~="class3"]', ['pmulti']),
-            ('a[rel~="friend"]', ['bob']),
-            ('a[rel~="met"]', ['bob']),
-            ('[rel~="friend"]', ['bob']),
-            ('[rel~="met"]', ['bob']),
-        )
-
-    def test_attribute_startswith(self):
-        self.assert_select_multiple(
-            ('[rel^="style"]', ['l1']),
-            ('link[rel^="style"]', ['l1']),
-            ('notlink[rel^="notstyle"]', []),
-            ('[rel^="notstyle"]', []),
-            ('link[rel^="notstyle"]', []),
-            ('link[href^="bla"]', ['l1']),
-            ('a[href^="http://"]', ['bob', 'me']),
-            ('[href^="http://"]', ['bob', 'me']),
-            ('[id^="p"]', ['pmulti', 'p1']),
-            ('[id^="m"]', ['me', 'main']),
-            ('div[id^="m"]', ['main']),
-            ('a[id^="m"]', ['me']),
-            ('div[data-tag^="dashed"]', ['data1'])
-        )
-
-    def test_attribute_endswith(self):
-        self.assert_select_multiple(
-            ('[href$=".css"]', ['l1']),
-            ('link[href$=".css"]', ['l1']),
-            ('link[id$="1"]', ['l1']),
-            ('[id$="1"]', ['data1', 'l1', 'p1', 'header1', 's1a1', 's2a1', 's1a2s1', 'dash1']),
-            ('div[id$="1"]', ['data1']),
-            ('[id$="noending"]', []),
-        )
-
-    def test_attribute_contains(self):
-        self.assert_select_multiple(
-            # From test_attribute_startswith
-            ('[rel*="style"]', ['l1']),
-            ('link[rel*="style"]', ['l1']),
-            ('notlink[rel*="notstyle"]', []),
-            ('[rel*="notstyle"]', []),
-            ('link[rel*="notstyle"]', []),
-            ('link[href*="bla"]', ['l1']),
-            ('[href*="http://"]', ['bob', 'me']),
-            ('[id*="p"]', ['pmulti', 'p1']),
-            ('div[id*="m"]', ['main']),
-            ('a[id*="m"]', ['me']),
-            # From test_attribute_endswith
-            ('[href*=".css"]', ['l1']),
-            ('link[href*=".css"]', ['l1']),
-            ('link[id*="1"]', ['l1']),
-            ('[id*="1"]', ['data1', 'l1', 'p1', 'header1', 's1a1', 's1a2', 's2a1', 's1a2s1', 'dash1']),
-            ('div[id*="1"]', ['data1']),
-            ('[id*="noending"]', []),
-            # New for this test
-            ('[href*="."]', ['bob', 'me', 'l1']),
-            ('a[href*="."]', ['bob', 'me']),
-            ('link[href*="."]', ['l1']),
-            ('div[id*="n"]', ['main', 'inner']),
-            ('div[id*="nn"]', ['inner']),
-            ('div[data-tag*="edval"]', ['data1'])
-        )
-
-    def test_attribute_exact_or_hypen(self):
-        self.assert_select_multiple(
-            ('p[lang|="en"]', ['lang-en', 'lang-en-gb', 'lang-en-us']),
-            ('[lang|="en"]', ['lang-en', 'lang-en-gb', 'lang-en-us']),
-            ('p[lang|="fr"]', ['lang-fr']),
-            ('p[lang|="gb"]', []),
-        )
-
-    def test_attribute_exists(self):
-        self.assert_select_multiple(
-            ('[rel]', ['l1', 'bob', 'me']),
-            ('link[rel]', ['l1']),
-            ('a[rel]', ['bob', 'me']),
-            ('[lang]', ['lang-en', 'lang-en-gb', 'lang-en-us', 'lang-fr']),
-            ('p[class]', ['p1', 'pmulti']),
-            ('[blah]', []),
-            ('p[blah]', []),
-            ('div[data-tag]', ['data1'])
-        )
-
-    def test_quoted_space_in_selector_name(self):
-        html = """<div style="display: wrong">nope</div>
-        <div style="display: right">yes</div>
-        """
-        soup = BeautifulSoup(html, 'html.parser')
-        [chosen] = soup.select('div[style="display: right"]')
-        assert "yes" == chosen.string
-
-    def test_unsupported_pseudoclass(self):
-        with pytest.raises(NotImplementedError):
-            self.soup.select("a:no-such-pseudoclass")
-
-        with pytest.raises(SelectorSyntaxError):
-            self.soup.select("a:nth-of-type(a)")
-
-    def test_nth_of_type(self):
-        # Try to select first paragraph
-        els = self.soup.select('div#inner p:nth-of-type(1)')
-        assert len(els) == 1
-        assert els[0].string == 'Some text'
-
-        # Try to select third paragraph
-        els = self.soup.select('div#inner p:nth-of-type(3)')
-        assert len(els) == 1
-        assert els[0].string == 'Another'
-
-        # Try to select (non-existent!) fourth paragraph
-        els = self.soup.select('div#inner p:nth-of-type(4)')
-        assert len(els) == 0
-
-        # Zero will select no tags.
-        els = self.soup.select('div p:nth-of-type(0)')
-        assert len(els) == 0
-
-    def test_nth_of_type_direct_descendant(self):
-        els = self.soup.select('div#inner > p:nth-of-type(1)')
-        assert len(els) == 1
-        assert els[0].string == 'Some text'
-
-    def test_id_child_selector_nth_of_type(self):
-        self.assert_selects('#inner > p:nth-of-type(2)', ['p1'])
-
-    def test_select_on_element(self):
-        # Other tests operate on the tree; this operates on an element
-        # within the tree.
-        inner = self.soup.find("div", id="main")
-        selected = inner.select("div")
-        # The <div id="inner"> tag was selected. The <div id="footer">
-        # tag was not.
-        self.assert_selects_ids(selected, ['inner', 'data1'])
-
-    def test_overspecified_child_id(self):
-        self.assert_selects(".fancy #inner", ['inner'])
-        self.assert_selects(".normal #inner", [])
-
-    def test_adjacent_sibling_selector(self):
-        self.assert_selects('#p1 + h2', ['header2'])
-        self.assert_selects('#p1 + h2 + p', ['pmulti'])
-        self.assert_selects('#p1 + #header2 + .class1', ['pmulti'])
-        assert [] == self.soup.select('#p1 + p')
-
-    def test_general_sibling_selector(self):
-        self.assert_selects('#p1 ~ h2', ['header2', 'header3'])
-        self.assert_selects('#p1 ~ #header2', ['header2'])
-        self.assert_selects('#p1 ~ h2 + a', ['me'])
-        self.assert_selects('#p1 ~ h2 + [rel="me"]', ['me'])
-        assert [] == self.soup.select('#inner ~ h2')
-
-    def test_dangling_combinator(self):
-        with pytest.raises(SelectorSyntaxError):
-            self.soup.select('h1 >')
-
-    def test_sibling_combinator_wont_select_same_tag_twice(self):
-        self.assert_selects('p[lang] ~ p', ['lang-en-gb', 'lang-en-us', 'lang-fr'])
-
-    # Test the selector grouping operator (the comma)
-    def test_multiple_select(self):
-        self.assert_selects('x, y', ['xid', 'yid'])
-
-    def test_multiple_select_with_no_space(self):
-        self.assert_selects('x,y', ['xid', 'yid'])
-
-    def test_multiple_select_with_more_space(self):
-        self.assert_selects('x,    y', ['xid', 'yid'])
-
-    def test_multiple_select_duplicated(self):
-        self.assert_selects('x, x', ['xid'])
-
-    def test_multiple_select_sibling(self):
-        self.assert_selects('x, y ~ p[lang=fr]', ['xid', 'lang-fr'])
-
-    def test_multiple_select_tag_and_direct_descendant(self):
-        self.assert_selects('x, y > z', ['xid', 'zidb'])
-
-    def test_multiple_select_direct_descendant_and_tags(self):
-        self.assert_selects('div > x, y, z', ['xid', 'yid', 'zida', 'zidb', 'zidab', 'zidac'])
-
-    def test_multiple_select_indirect_descendant(self):
-        self.assert_selects('div x,y,  z', ['xid', 'yid', 'zida', 'zidb', 'zidab', 'zidac'])
-
-    def test_invalid_multiple_select(self):
-        with pytest.raises(SelectorSyntaxError):
-            self.soup.select(',x, y')
-        with pytest.raises(SelectorSyntaxError):
-            self.soup.select('x,,y')
-
-    def test_multiple_select_attrs(self):
-        self.assert_selects('p[lang=en], p[lang=en-gb]', ['lang-en', 'lang-en-gb'])
-
-    def test_multiple_select_ids(self):
-        self.assert_selects('x, y > z[id=zida], z[id=zidab], z[id=zidb]', ['xid', 'zidb', 'zidab'])
-
-    def test_multiple_select_nested(self):
-        self.assert_selects('body > div > x, y > z', ['xid', 'zidb'])
-
-    def test_select_duplicate_elements(self):
-        # When markup contains duplicate elements, a multiple select
-        # will find all of them.
-        markup = '<div class="c1"/><div class="c2"/><div class="c1"/>'
-        soup = BeautifulSoup(markup, 'html.parser')
-        selected = soup.select(".c1, .c2")
-        assert 3 == len(selected)
-
-        # Verify that find_all finds the same elements, though because
-        # of an implementation detail it finds them in a different
-        # order.
-        for element in soup.find_all(class_=['c1', 'c2']):
-            assert element in selected
-
-
 class TestPersistence(SoupTest):
     "Testing features like pickle and deepcopy."
 
@@ -668,12 +278,24 @@ class TestPersistence(SoupTest):
         loaded = pickle.loads(dumped)
         assert loaded.__class__ == BeautifulSoup
         assert loaded.decode() == self.tree.decode()
-
+        
     def test_deepcopy_identity(self):
         # Making a deepcopy of a tree yields an identical tree.
         copied = copy.deepcopy(self.tree)
         assert copied.decode() == self.tree.decode()
 
+    def test_copy_deeply_nested_document(self):
+        # This test verifies that copy and deepcopy don't involve any
+        # recursive function calls. If they did, this test would
+        # overflow the Python interpreter stack.
+        limit = sys.getrecursionlimit() + 1
+        markup = "<span>" * limit
+
+        soup = self.soup(markup)
+        
+        copied = copy.copy(soup)
+        copied = copy.deepcopy(soup)
+
     def test_copy_preserves_encoding(self):
         soup = BeautifulSoup(b'<p>&nbsp;</p>', 'html.parser')
         encoding = soup.original_encoding
diff --git a/lib/bs4/tests/test_soup.py b/lib/bs4/tests/test_soup.py
index 64b8cf12..28013b87 100644
--- a/lib/bs4/tests/test_soup.py
+++ b/lib/bs4/tests/test_soup.py
@@ -24,6 +24,7 @@ from bs4.builder import (
 from bs4.element import (
     Comment,
     SoupStrainer,
+    PYTHON_SPECIFIC_ENCODINGS,
     Tag,
     NavigableString,
 )
@@ -210,6 +211,47 @@ class TestConstructor(SoupTest):
         assert [] == soup.string_container_stack
 
 
+class TestOutput(SoupTest):
+
+    @pytest.mark.parametrize(
+        "eventual_encoding,actual_encoding", [
+            ("utf-8", "utf-8"),
+            ("utf-16", "utf-16"),
+        ]
+    )
+    def test_decode_xml_declaration(self, eventual_encoding, actual_encoding):
+        # Most of the time, calling decode() on an XML document will
+        # give you a document declaration that mentions the encoding
+        # you intend to use when encoding the document as a
+        # bytestring.
+        soup = self.soup("<tag></tag>")
+        soup.is_xml = True
+        assert (f'<?xml version="1.0" encoding="{actual_encoding}"?>\n<tag></tag>'
+                == soup.decode(eventual_encoding=eventual_encoding))
+
+    @pytest.mark.parametrize(
+        "eventual_encoding", [x for x in PYTHON_SPECIFIC_ENCODINGS] + [None]
+    )
+    def test_decode_xml_declaration_with_missing_or_python_internal_eventual_encoding(self, eventual_encoding):
+        # But if you pass a Python internal encoding into decode(), or
+        # omit the eventual_encoding altogether, the document
+        # declaration won't mention any particular encoding.
+        soup = BeautifulSoup("<tag></tag>", "html.parser")
+        soup.is_xml = True
+        assert (f'<?xml version="1.0"?>\n<tag></tag>'
+                == soup.decode(eventual_encoding=eventual_encoding))
+
+    def test(self):
+        # BeautifulSoup subclasses Tag and extends the decode() method.
+        # Make sure the other Tag methods which call decode() call
+        # it correctly.
+        soup = self.soup("<tag></tag>")
+        assert b"<tag></tag>" == soup.encode(encoding="utf-8")
+        assert b"<tag></tag>" == soup.encode_contents(encoding="utf-8")
+        assert "<tag></tag>" == soup.decode_contents()
+        assert "<tag>\n</tag>\n" == soup.prettify()
+
+        
 class TestWarnings(SoupTest):
     # Note that some of the tests in this class create BeautifulSoup
     # objects directly rather than using self.soup(). That's
diff --git a/lib/soupsieve/__init__.py b/lib/soupsieve/__init__.py
index 591a4f4f..06403633 100644
--- a/lib/soupsieve/__init__.py
+++ b/lib/soupsieve/__init__.py
@@ -32,7 +32,7 @@ from . import css_match as cm
 from . import css_types as ct
 from .util import DEBUG, SelectorSyntaxError  # noqa: F401
 import bs4  # type: ignore[import]
-from typing import Optional, Any, Iterator, Iterable
+from typing import Any, Iterator, Iterable
 
 __all__ = (
     'DEBUG', 'SelectorSyntaxError', 'SoupSieve',
@@ -45,10 +45,10 @@ SoupSieve = cm.SoupSieve
 
 def compile(  # noqa: A001
     pattern: str,
-    namespaces: Optional[dict[str, str]] = None,
+    namespaces: dict[str, str] | None = None,
     flags: int = 0,
     *,
-    custom: Optional[dict[str, str]] = None,
+    custom: dict[str, str] | None = None,
     **kwargs: Any
 ) -> cm.SoupSieve:
     """Compile CSS pattern."""
@@ -79,10 +79,10 @@ def purge() -> None:
 def closest(
     select: str,
     tag: 'bs4.Tag',
-    namespaces: Optional[dict[str, str]] = None,
+    namespaces: dict[str, str] | None = None,
     flags: int = 0,
     *,
-    custom: Optional[dict[str, str]] = None,
+    custom: dict[str, str] | None = None,
     **kwargs: Any
 ) -> 'bs4.Tag':
     """Match closest ancestor."""
@@ -93,10 +93,10 @@ def closest(
 def match(
     select: str,
     tag: 'bs4.Tag',
-    namespaces: Optional[dict[str, str]] = None,
+    namespaces: dict[str, str] | None = None,
     flags: int = 0,
     *,
-    custom: Optional[dict[str, str]] = None,
+    custom: dict[str, str] | None = None,
     **kwargs: Any
 ) -> bool:
     """Match node."""
@@ -107,10 +107,10 @@ def match(
 def filter(  # noqa: A001
     select: str,
     iterable: Iterable['bs4.Tag'],
-    namespaces: Optional[dict[str, str]] = None,
+    namespaces: dict[str, str] | None = None,
     flags: int = 0,
     *,
-    custom: Optional[dict[str, str]] = None,
+    custom: dict[str, str] | None = None,
     **kwargs: Any
 ) -> list['bs4.Tag']:
     """Filter list of nodes."""
@@ -121,10 +121,10 @@ def filter(  # noqa: A001
 def select_one(
     select: str,
     tag: 'bs4.Tag',
-    namespaces: Optional[dict[str, str]] = None,
+    namespaces: dict[str, str] | None = None,
     flags: int = 0,
     *,
-    custom: Optional[dict[str, str]] = None,
+    custom: dict[str, str] | None = None,
     **kwargs: Any
 ) -> 'bs4.Tag':
     """Select a single tag."""
@@ -135,11 +135,11 @@ def select_one(
 def select(
     select: str,
     tag: 'bs4.Tag',
-    namespaces: Optional[dict[str, str]] = None,
+    namespaces: dict[str, str] | None = None,
     limit: int = 0,
     flags: int = 0,
     *,
-    custom: Optional[dict[str, str]] = None,
+    custom: dict[str, str] | None = None,
     **kwargs: Any
 ) -> list['bs4.Tag']:
     """Select the specified tags."""
@@ -150,11 +150,11 @@ def select(
 def iselect(
     select: str,
     tag: 'bs4.Tag',
-    namespaces: Optional[dict[str, str]] = None,
+    namespaces: dict[str, str] | None = None,
     limit: int = 0,
     flags: int = 0,
     *,
-    custom: Optional[dict[str, str]] = None,
+    custom: dict[str, str] | None = None,
     **kwargs: Any
 ) -> Iterator['bs4.Tag']:
     """Iterate the specified tags."""
diff --git a/lib/soupsieve/__meta__.py b/lib/soupsieve/__meta__.py
index 5369314e..6f35e152 100644
--- a/lib/soupsieve/__meta__.py
+++ b/lib/soupsieve/__meta__.py
@@ -193,5 +193,5 @@ def parse_version(ver: str) -> Version:
     return Version(major, minor, micro, release, pre, post, dev)
 
 
-__version_info__ = Version(2, 4, 0, "final")
+__version_info__ = Version(2, 4, 1, "final")
 __version__ = __version_info__._get_canonical()
diff --git a/lib/soupsieve/css_match.py b/lib/soupsieve/css_match.py
index 65752829..168e4be6 100644
--- a/lib/soupsieve/css_match.py
+++ b/lib/soupsieve/css_match.py
@@ -6,7 +6,7 @@ import re
 from . import css_types as ct
 import unicodedata
 import bs4  # type: ignore[import]
-from typing import Iterator, Iterable, Any, Optional, Callable, Sequence, cast  # noqa: F401
+from typing import Iterator, Iterable, Any, Callable, Sequence, cast  # noqa: F401
 
 # Empty tag pattern (whitespace okay)
 RE_NOT_EMPTY = re.compile('[^ \t\r\n\f]')
@@ -171,7 +171,7 @@ class _DocumentNav:
     def get_children(
         self,
         el: bs4.Tag,
-        start: Optional[int] = None,
+        start: int | None = None,
         reverse: bool = False,
         tags: bool = True,
         no_iframe: bool = False
@@ -239,22 +239,22 @@ class _DocumentNav:
         return parent
 
     @staticmethod
-    def get_tag_name(el: bs4.Tag) -> Optional[str]:
+    def get_tag_name(el: bs4.Tag) -> str | None:
         """Get tag."""
 
-        return cast(Optional[str], el.name)
+        return cast('str | None', el.name)
 
     @staticmethod
-    def get_prefix_name(el: bs4.Tag) -> Optional[str]:
+    def get_prefix_name(el: bs4.Tag) -> str | None:
         """Get prefix."""
 
-        return cast(Optional[str], el.prefix)
+        return cast('str | None', el.prefix)
 
     @staticmethod
-    def get_uri(el: bs4.Tag) -> Optional[str]:
+    def get_uri(el: bs4.Tag) -> str | None:
         """Get namespace `URI`."""
 
-        return cast(Optional[str], el.namespace)
+        return cast('str | None', el.namespace)
 
     @classmethod
     def get_next(cls, el: bs4.Tag, tags: bool = True) -> bs4.PageElement:
@@ -287,7 +287,7 @@ class _DocumentNav:
         return bool(ns and ns == NS_XHTML)
 
     @staticmethod
-    def split_namespace(el: bs4.Tag, attr_name: str) -> tuple[Optional[str], Optional[str]]:
+    def split_namespace(el: bs4.Tag, attr_name: str) -> tuple[str | None, str | None]:
         """Return namespace and attribute name without the prefix."""
 
         return getattr(attr_name, 'namespace', None), getattr(attr_name, 'name', None)
@@ -330,8 +330,8 @@ class _DocumentNav:
         cls,
         el: bs4.Tag,
         name: str,
-        default: Optional[str | Sequence[str]] = None
-    ) -> Optional[str | Sequence[str]]:
+        default: str | Sequence[str] | None = None
+    ) -> str | Sequence[str] | None:
         """Get attribute by name."""
 
         value = default
@@ -348,7 +348,7 @@ class _DocumentNav:
         return value
 
     @classmethod
-    def iter_attributes(cls, el: bs4.Tag) -> Iterator[tuple[str, Optional[str | Sequence[str]]]]:
+    def iter_attributes(cls, el: bs4.Tag) -> Iterator[tuple[str, str | Sequence[str] | None]]:
         """Iterate attributes."""
 
         for k, v in el.attrs.items():
@@ -424,10 +424,10 @@ class Inputs:
         return 0 <= minutes <= 59
 
     @classmethod
-    def parse_value(cls, itype: str, value: Optional[str]) -> Optional[tuple[float, ...]]:
+    def parse_value(cls, itype: str, value: str | None) -> tuple[float, ...] | None:
         """Parse the input value."""
 
-        parsed = None  # type: Optional[tuple[float, ...]]
+        parsed = None  # type: tuple[float, ...] | None
         if value is None:
             return value
         if itype == "date":
@@ -486,7 +486,7 @@ class CSSMatch(_DocumentNav):
         self,
         selectors: ct.SelectorList,
         scope: bs4.Tag,
-        namespaces: Optional[ct.Namespaces],
+        namespaces: ct.Namespaces | None,
         flags: int
     ) -> None:
         """Initialize."""
@@ -545,19 +545,19 @@ class CSSMatch(_DocumentNav):
 
         return self.get_tag_ns(el) == NS_XHTML
 
-    def get_tag(self, el: bs4.Tag) -> Optional[str]:
+    def get_tag(self, el: bs4.Tag) -> str | None:
         """Get tag."""
 
         name = self.get_tag_name(el)
         return util.lower(name) if name is not None and not self.is_xml else name
 
-    def get_prefix(self, el: bs4.Tag) -> Optional[str]:
+    def get_prefix(self, el: bs4.Tag) -> str | None:
         """Get prefix."""
 
         prefix = self.get_prefix_name(el)
         return util.lower(prefix) if prefix is not None and not self.is_xml else prefix
 
-    def find_bidi(self, el: bs4.Tag) -> Optional[int]:
+    def find_bidi(self, el: bs4.Tag) -> int | None:
         """Get directionality from element text."""
 
         for node in self.get_children(el, tags=False):
@@ -653,8 +653,8 @@ class CSSMatch(_DocumentNav):
         self,
         el: bs4.Tag,
         attr: str,
-        prefix: Optional[str]
-    ) -> Optional[str | Sequence[str]]:
+        prefix: str | None
+    ) -> str | Sequence[str] | None:
         """Match attribute name and return value if it exists."""
 
         value = None
@@ -751,7 +751,7 @@ class CSSMatch(_DocumentNav):
             name not in (self.get_tag(el), '*')
         )
 
-    def match_tag(self, el: bs4.Tag, tag: Optional[ct.SelectorTag]) -> bool:
+    def match_tag(self, el: bs4.Tag, tag: ct.SelectorTag | None) -> bool:
         """Match the tag."""
 
         match = True
@@ -1030,7 +1030,7 @@ class CSSMatch(_DocumentNav):
         """Match element if it contains text."""
 
         match = True
-        content = None  # type: Optional[str | Sequence[str]]
+        content = None  # type: str | Sequence[str] | None
         for contain_list in contains:
             if content is None:
                 if contain_list.own:
@@ -1099,7 +1099,7 @@ class CSSMatch(_DocumentNav):
         match = False
         name = cast(str, self.get_attribute_by_name(el, 'name'))
 
-        def get_parent_form(el: bs4.Tag) -> Optional[bs4.Tag]:
+        def get_parent_form(el: bs4.Tag) -> bs4.Tag | None:
             """Find this input's form."""
             form = None
             parent = self.get_parent(el, no_iframe=True)
@@ -1478,7 +1478,7 @@ class CSSMatch(_DocumentNav):
                     if lim < 1:
                         break
 
-    def closest(self) -> Optional[bs4.Tag]:
+    def closest(self) -> bs4.Tag | None:
         """Match closest ancestor."""
 
         current = self.tag
@@ -1506,7 +1506,7 @@ class SoupSieve(ct.Immutable):
 
     pattern: str
     selectors: ct.SelectorList
-    namespaces: Optional[ct.Namespaces]
+    namespaces: ct.Namespaces | None
     custom: dict[str, str]
     flags: int
 
@@ -1516,8 +1516,8 @@ class SoupSieve(ct.Immutable):
         self,
         pattern: str,
         selectors: ct.SelectorList,
-        namespaces: Optional[ct.Namespaces],
-        custom: Optional[ct.CustomSelectors],
+        namespaces: ct.Namespaces | None,
+        custom: ct.CustomSelectors | None,
         flags: int
     ):
         """Initialize."""
diff --git a/lib/soupsieve/css_parser.py b/lib/soupsieve/css_parser.py
index 4b8db186..10ac6f21 100644
--- a/lib/soupsieve/css_parser.py
+++ b/lib/soupsieve/css_parser.py
@@ -7,7 +7,7 @@ from . import css_match as cm
 from . import css_types as ct
 from .util import SelectorSyntaxError
 import warnings
-from typing import Optional, Match, Any, Iterator, cast
+from typing import Match, Any, Iterator, cast
 
 UNICODE_REPLACEMENT_CHAR = 0xFFFD
 
@@ -113,7 +113,7 @@ VALUE = r'''
 '''.format(nl=NEWLINE, ident=IDENTIFIER)
 # Attribute value comparison. `!=` is handled special as it is non-standard.
 ATTR = r'''
-(?:{ws}*(?P<cmp>[!~^|*$]?=){ws}*(?P<value>{value})(?:{ws}+(?P<case>[is]))?)?{ws}*\]
+(?:{ws}*(?P<cmp>[!~^|*$]?=){ws}*(?P<value>{value})(?:{ws}*(?P<case>[is]))?)?{ws}*\]
 '''.format(ws=WSC, value=VALUE)
 
 # Selector patterns
@@ -207,8 +207,8 @@ _MAXCACHE = 500
 @lru_cache(maxsize=_MAXCACHE)
 def _cached_css_compile(
     pattern: str,
-    namespaces: Optional[ct.Namespaces],
-    custom: Optional[ct.CustomSelectors],
+    namespaces: ct.Namespaces | None,
+    custom: ct.CustomSelectors | None,
     flags: int
 ) -> cm.SoupSieve:
     """Cached CSS compile."""
@@ -233,7 +233,7 @@ def _purge_cache() -> None:
     _cached_css_compile.cache_clear()
 
 
-def process_custom(custom: Optional[ct.CustomSelectors]) -> dict[str, str | ct.SelectorList]:
+def process_custom(custom: ct.CustomSelectors | None) -> dict[str, str | ct.SelectorList]:
     """Process custom."""
 
     custom_selectors = {}
@@ -317,7 +317,7 @@ class SelectorPattern:
 
         return self.name
 
-    def match(self, selector: str, index: int, flags: int) -> Optional[Match[str]]:
+    def match(self, selector: str, index: int, flags: int) -> Match[str] | None:
         """Match the selector."""
 
         return self.re_pattern.match(selector, index)
@@ -336,7 +336,7 @@ class SpecialPseudoPattern(SelectorPattern):
             for pseudo in p[1]:
                 self.patterns[pseudo] = pattern
 
-        self.matched_name = None  # type: Optional[SelectorPattern]
+        self.matched_name = None  # type: SelectorPattern | None
         self.re_pseudo_name = re.compile(PAT_PSEUDO_CLASS_SPECIAL, re.I | re.X | re.U)
 
     def get_name(self) -> str:
@@ -344,7 +344,7 @@ class SpecialPseudoPattern(SelectorPattern):
 
         return '' if self.matched_name is None else self.matched_name.get_name()
 
-    def match(self, selector: str, index: int, flags: int) -> Optional[Match[str]]:
+    def match(self, selector: str, index: int, flags: int) -> Match[str] | None:
         """Match the selector."""
 
         pseudo = None
@@ -372,14 +372,14 @@ class _Selector:
     def __init__(self, **kwargs: Any) -> None:
         """Initialize."""
 
-        self.tag = kwargs.get('tag', None)  # type: Optional[ct.SelectorTag]
+        self.tag = kwargs.get('tag', None)  # type: ct.SelectorTag | None
         self.ids = kwargs.get('ids', [])  # type: list[str]
         self.classes = kwargs.get('classes', [])  # type: list[str]
         self.attributes = kwargs.get('attributes', [])  # type: list[ct.SelectorAttribute]
         self.nth = kwargs.get('nth', [])  # type: list[ct.SelectorNth]
         self.selectors = kwargs.get('selectors', [])  # type: list[ct.SelectorList]
         self.relations = kwargs.get('relations', [])  # type: list[_Selector]
-        self.rel_type = kwargs.get('rel_type', None)  # type: Optional[str]
+        self.rel_type = kwargs.get('rel_type', None)  # type: str | None
         self.contains = kwargs.get('contains', [])  # type: list[ct.SelectorContains]
         self.lang = kwargs.get('lang', [])  # type: list[ct.SelectorLang]
         self.flags = kwargs.get('flags', 0)  # type: int
@@ -462,7 +462,7 @@ class CSSParser:
     def __init__(
         self,
         selector: str,
-        custom: Optional[dict[str, str | ct.SelectorList]] = None,
+        custom: dict[str, str | ct.SelectorList] | None = None,
         flags: int = 0
     ) -> None:
         """Initialize."""
diff --git a/lib/soupsieve/css_types.py b/lib/soupsieve/css_types.py
index a97d5f4b..c263bb04 100644
--- a/lib/soupsieve/css_types.py
+++ b/lib/soupsieve/css_types.py
@@ -2,7 +2,7 @@
 from __future__ import annotations
 import copyreg
 from .pretty import pretty
-from typing import Any, Iterator, Hashable, Optional, Pattern, Iterable, Mapping
+from typing import Any, Iterator, Hashable, Pattern, Iterable, Mapping
 
 __all__ = (
     'Selector',
@@ -189,28 +189,28 @@ class Selector(Immutable):
         'relation', 'rel_type', 'contains', 'lang', 'flags', '_hash'
     )
 
-    tag: Optional[SelectorTag]
+    tag: SelectorTag | None
     ids: tuple[str, ...]
     classes: tuple[str, ...]
     attributes: tuple[SelectorAttribute, ...]
     nth: tuple[SelectorNth, ...]
     selectors: tuple[SelectorList, ...]
     relation: SelectorList
-    rel_type: Optional[str]
+    rel_type: str | None
     contains: tuple[SelectorContains, ...]
     lang: tuple[SelectorLang, ...]
     flags: int
 
     def __init__(
         self,
-        tag: Optional[SelectorTag],
+        tag: SelectorTag | None,
         ids: tuple[str, ...],
         classes: tuple[str, ...],
         attributes: tuple[SelectorAttribute, ...],
         nth: tuple[SelectorNth, ...],
         selectors: tuple[SelectorList, ...],
         relation: SelectorList,
-        rel_type: Optional[str],
+        rel_type: str | None,
         contains: tuple[SelectorContains, ...],
         lang: tuple[SelectorLang, ...],
         flags: int
@@ -247,9 +247,9 @@ class SelectorTag(Immutable):
     __slots__ = ("name", "prefix", "_hash")
 
     name: str
-    prefix: Optional[str]
+    prefix: str | None
 
-    def __init__(self, name: str, prefix: Optional[str]) -> None:
+    def __init__(self, name: str, prefix: str | None) -> None:
         """Initialize."""
 
         super().__init__(name=name, prefix=prefix)
@@ -262,15 +262,15 @@ class SelectorAttribute(Immutable):
 
     attribute: str
     prefix: str
-    pattern: Optional[Pattern[str]]
-    xml_type_pattern: Optional[Pattern[str]]
+    pattern: Pattern[str] | None
+    xml_type_pattern: Pattern[str] | None
 
     def __init__(
         self,
         attribute: str,
         prefix: str,
-        pattern: Optional[Pattern[str]],
-        xml_type_pattern: Optional[Pattern[str]]
+        pattern: Pattern[str] | None,
+        xml_type_pattern: Pattern[str] | None
     ) -> None:
         """Initialize."""
 
@@ -360,7 +360,7 @@ class SelectorList(Immutable):
 
     def __init__(
         self,
-        selectors: Optional[Iterable[Selector | SelectorNull]] = None,
+        selectors: Iterable[Selector | SelectorNull] | None = None,
         is_not: bool = False,
         is_html: bool = False
     ) -> None:
diff --git a/lib/soupsieve/util.py b/lib/soupsieve/util.py
index cf4dc5cc..9f91233b 100644
--- a/lib/soupsieve/util.py
+++ b/lib/soupsieve/util.py
@@ -3,7 +3,7 @@ from __future__ import annotations
 from functools import wraps, lru_cache
 import warnings
 import re
-from typing import Callable, Any, Optional
+from typing import Callable, Any
 
 DEBUG = 0x00001
 
@@ -27,7 +27,7 @@ def lower(string: str) -> str:
 class SelectorSyntaxError(Exception):
     """Syntax error in a CSS selector."""
 
-    def __init__(self, msg: str, pattern: Optional[str] = None, index: Optional[int] = None) -> None:
+    def __init__(self, msg: str, pattern: str | None = None, index: int | None = None) -> None:
         """Initialize."""
 
         self.line = None
@@ -84,7 +84,7 @@ def get_pattern_context(pattern: str, index: int) -> tuple[str, int, int]:
     col = 1
     text = []  # type: list[str]
     line = 1
-    offset = None  # type: Optional[int]
+    offset = None  # type: int | None
 
     # Split pattern by newline and handle the text before the newline
     for m in RE_PATTERN_LINE_SPLIT.finditer(pattern):
diff --git a/requirements.txt b/requirements.txt
index b9a561d1..bba4cea0 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -4,7 +4,7 @@ arrow==1.2.3
 backports.csv==1.0.7
 backports.functools-lru-cache==1.6.4
 backports.zoneinfo==0.2.1;python_version<"3.9"
-beautifulsoup4==4.11.2
+beautifulsoup4==4.12.2
 bleach==6.0.0
 certifi==2022.12.7
 cheroot==9.0.0

From c5bbaaf39c8d46153dead0380e7d681c1deb903c Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 23 Aug 2023 21:38:59 -0700
Subject: [PATCH 425/743] Bump packaging from 23.0 to 23.1 (#2043)

* Bump packaging from 23.0 to 23.1

Bumps [packaging](https://github.com/pypa/packaging) from 23.0 to 23.1.
- [Release notes](https://github.com/pypa/packaging/releases)
- [Changelog](https://github.com/pypa/packaging/blob/main/CHANGELOG.rst)
- [Commits](https://github.com/pypa/packaging/compare/23.0...23.1)

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

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

* Update packaging==23.1

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/packaging/__init__.py     |   2 +-
 lib/packaging/_manylinux.py   |   2 +
 lib/packaging/_parser.py      |  31 ++-
 lib/packaging/_tokenizer.py   |  10 +-
 lib/packaging/markers.py      |  11 +-
 lib/packaging/metadata.py     | 408 ++++++++++++++++++++++++++++++++++
 lib/packaging/requirements.py |   4 +-
 lib/packaging/specifiers.py   |   7 +-
 lib/packaging/tags.py         |   4 +-
 lib/packaging/version.py      |   5 +-
 requirements.txt              |   2 +-
 11 files changed, 468 insertions(+), 18 deletions(-)
 create mode 100644 lib/packaging/metadata.py

diff --git a/lib/packaging/__init__.py b/lib/packaging/__init__.py
index 4112fec0..13cadc7f 100644
--- a/lib/packaging/__init__.py
+++ b/lib/packaging/__init__.py
@@ -6,7 +6,7 @@ __title__ = "packaging"
 __summary__ = "Core utilities for Python packages"
 __uri__ = "https://github.com/pypa/packaging"
 
-__version__ = "23.0"
+__version__ = "23.1"
 
 __author__ = "Donald Stufft and individual contributors"
 __email__ = "donald@stufft.io"
diff --git a/lib/packaging/_manylinux.py b/lib/packaging/_manylinux.py
index 2f0cc743..449c655b 100644
--- a/lib/packaging/_manylinux.py
+++ b/lib/packaging/_manylinux.py
@@ -14,6 +14,8 @@ EF_ARM_ABI_VER5 = 0x05000000
 EF_ARM_ABI_FLOAT_HARD = 0x00000400
 
 
+# `os.PathLike` not a generic type until Python 3.9, so sticking with `str`
+# as the type for `path` until then.
 @contextlib.contextmanager
 def _parse_elf(path: str) -> Generator[Optional[ELFFile], None, None]:
     try:
diff --git a/lib/packaging/_parser.py b/lib/packaging/_parser.py
index 2bc6a8f9..5a18b758 100644
--- a/lib/packaging/_parser.py
+++ b/lib/packaging/_parser.py
@@ -163,7 +163,11 @@ def _parse_extras(tokenizer: Tokenizer) -> List[str]:
     if not tokenizer.check("LEFT_BRACKET", peek=True):
         return []
 
-    with tokenizer.enclosing_tokens("LEFT_BRACKET", "RIGHT_BRACKET"):
+    with tokenizer.enclosing_tokens(
+        "LEFT_BRACKET",
+        "RIGHT_BRACKET",
+        around="extras",
+    ):
         tokenizer.consume("WS")
         extras = _parse_extras_list(tokenizer)
         tokenizer.consume("WS")
@@ -203,7 +207,11 @@ def _parse_specifier(tokenizer: Tokenizer) -> str:
     specifier = LEFT_PARENTHESIS WS? version_many WS? RIGHT_PARENTHESIS
               | WS? version_many WS?
     """
-    with tokenizer.enclosing_tokens("LEFT_PARENTHESIS", "RIGHT_PARENTHESIS"):
+    with tokenizer.enclosing_tokens(
+        "LEFT_PARENTHESIS",
+        "RIGHT_PARENTHESIS",
+        around="version specifier",
+    ):
         tokenizer.consume("WS")
         parsed_specifiers = _parse_version_many(tokenizer)
         tokenizer.consume("WS")
@@ -217,7 +225,20 @@ def _parse_version_many(tokenizer: Tokenizer) -> str:
     """
     parsed_specifiers = ""
     while tokenizer.check("SPECIFIER"):
+        span_start = tokenizer.position
         parsed_specifiers += tokenizer.read().text
+        if tokenizer.check("VERSION_PREFIX_TRAIL", peek=True):
+            tokenizer.raise_syntax_error(
+                ".* suffix can only be used with `==` or `!=` operators",
+                span_start=span_start,
+                span_end=tokenizer.position + 1,
+            )
+        if tokenizer.check("VERSION_LOCAL_LABEL_TRAIL", peek=True):
+            tokenizer.raise_syntax_error(
+                "Local version label can only be used with `==` or `!=` operators",
+                span_start=span_start,
+                span_end=tokenizer.position,
+            )
         tokenizer.consume("WS")
         if not tokenizer.check("COMMA"):
             break
@@ -254,7 +275,11 @@ def _parse_marker_atom(tokenizer: Tokenizer) -> MarkerAtom:
 
     tokenizer.consume("WS")
     if tokenizer.check("LEFT_PARENTHESIS", peek=True):
-        with tokenizer.enclosing_tokens("LEFT_PARENTHESIS", "RIGHT_PARENTHESIS"):
+        with tokenizer.enclosing_tokens(
+            "LEFT_PARENTHESIS",
+            "RIGHT_PARENTHESIS",
+            around="marker expression",
+        ):
             tokenizer.consume("WS")
             marker: MarkerAtom = _parse_marker(tokenizer)
             tokenizer.consume("WS")
diff --git a/lib/packaging/_tokenizer.py b/lib/packaging/_tokenizer.py
index b1fb207c..dd0d648d 100644
--- a/lib/packaging/_tokenizer.py
+++ b/lib/packaging/_tokenizer.py
@@ -78,6 +78,8 @@ DEFAULT_RULES: "Dict[str, Union[str, re.Pattern[str]]]" = {
     "AT": r"\@",
     "URL": r"[^ \t]+",
     "IDENTIFIER": r"\b[a-zA-Z0-9][a-zA-Z0-9._-]*\b",
+    "VERSION_PREFIX_TRAIL": r"\.\*",
+    "VERSION_LOCAL_LABEL_TRAIL": r"\+[a-z0-9]+(?:[-_\.][a-z0-9]+)*",
     "WS": r"[ \t]+",
     "END": r"$",
 }
@@ -167,21 +169,23 @@ class Tokenizer:
         )
 
     @contextlib.contextmanager
-    def enclosing_tokens(self, open_token: str, close_token: str) -> Iterator[bool]:
+    def enclosing_tokens(
+        self, open_token: str, close_token: str, *, around: str
+    ) -> Iterator[None]:
         if self.check(open_token):
             open_position = self.position
             self.read()
         else:
             open_position = None
 
-        yield open_position is not None
+        yield
 
         if open_position is None:
             return
 
         if not self.check(close_token):
             self.raise_syntax_error(
-                f"Expected closing {close_token}",
+                f"Expected matching {close_token} for {open_token}, after {around}",
                 span_start=open_position,
             )
 
diff --git a/lib/packaging/markers.py b/lib/packaging/markers.py
index 68369c98..8b98fca7 100644
--- a/lib/packaging/markers.py
+++ b/lib/packaging/markers.py
@@ -8,7 +8,14 @@ import platform
 import sys
 from typing import Any, Callable, Dict, List, Optional, Tuple, Union
 
-from ._parser import MarkerAtom, MarkerList, Op, Value, Variable, parse_marker
+from ._parser import (
+    MarkerAtom,
+    MarkerList,
+    Op,
+    Value,
+    Variable,
+    parse_marker as _parse_marker,
+)
 from ._tokenizer import ParserSyntaxError
 from .specifiers import InvalidSpecifier, Specifier
 from .utils import canonicalize_name
@@ -189,7 +196,7 @@ class Marker:
         #       packaging.requirements.Requirement. If any additional logic is
         #       added here, make sure to mirror/adapt Requirement.
         try:
-            self._markers = _normalize_extra_values(parse_marker(marker))
+            self._markers = _normalize_extra_values(_parse_marker(marker))
             # The attribute `_markers` can be described in terms of a recursive type:
             # MarkerList = List[Union[Tuple[Node, ...], str, MarkerList]]
             #
diff --git a/lib/packaging/metadata.py b/lib/packaging/metadata.py
new file mode 100644
index 00000000..e76a60c3
--- /dev/null
+++ b/lib/packaging/metadata.py
@@ -0,0 +1,408 @@
+import email.feedparser
+import email.header
+import email.message
+import email.parser
+import email.policy
+import sys
+import typing
+from typing import Dict, List, Optional, Tuple, Union, cast
+
+if sys.version_info >= (3, 8):  # pragma: no cover
+    from typing import TypedDict
+else:  # pragma: no cover
+    if typing.TYPE_CHECKING:
+        from typing_extensions import TypedDict
+    else:
+        try:
+            from typing_extensions import TypedDict
+        except ImportError:
+
+            class TypedDict:
+                def __init_subclass__(*_args, **_kwargs):
+                    pass
+
+
+# The RawMetadata class attempts to make as few assumptions about the underlying
+# serialization formats as possible. The idea is that as long as a serialization
+# formats offer some very basic primitives in *some* way then we can support
+# serializing to and from that format.
+class RawMetadata(TypedDict, total=False):
+    """A dictionary of raw core metadata.
+
+    Each field in core metadata maps to a key of this dictionary (when data is
+    provided). The key is lower-case and underscores are used instead of dashes
+    compared to the equivalent core metadata field. Any core metadata field that
+    can be specified multiple times or can hold multiple values in a single
+    field have a key with a plural name.
+
+    Core metadata fields that can be specified multiple times are stored as a
+    list or dict depending on which is appropriate for the field. Any fields
+    which hold multiple values in a single field are stored as a list.
+
+    """
+
+    # Metadata 1.0 - PEP 241
+    metadata_version: str
+    name: str
+    version: str
+    platforms: List[str]
+    summary: str
+    description: str
+    keywords: List[str]
+    home_page: str
+    author: str
+    author_email: str
+    license: str
+
+    # Metadata 1.1 - PEP 314
+    supported_platforms: List[str]
+    download_url: str
+    classifiers: List[str]
+    requires: List[str]
+    provides: List[str]
+    obsoletes: List[str]
+
+    # Metadata 1.2 - PEP 345
+    maintainer: str
+    maintainer_email: str
+    requires_dist: List[str]
+    provides_dist: List[str]
+    obsoletes_dist: List[str]
+    requires_python: str
+    requires_external: List[str]
+    project_urls: Dict[str, str]
+
+    # Metadata 2.0
+    # PEP 426 attempted to completely revamp the metadata format
+    # but got stuck without ever being able to build consensus on
+    # it and ultimately ended up withdrawn.
+    #
+    # However, a number of tools had started emiting METADATA with
+    # `2.0` Metadata-Version, so for historical reasons, this version
+    # was skipped.
+
+    # Metadata 2.1 - PEP 566
+    description_content_type: str
+    provides_extra: List[str]
+
+    # Metadata 2.2 - PEP 643
+    dynamic: List[str]
+
+    # Metadata 2.3 - PEP 685
+    # No new fields were added in PEP 685, just some edge case were
+    # tightened up to provide better interoptability.
+
+
+_STRING_FIELDS = {
+    "author",
+    "author_email",
+    "description",
+    "description_content_type",
+    "download_url",
+    "home_page",
+    "license",
+    "maintainer",
+    "maintainer_email",
+    "metadata_version",
+    "name",
+    "requires_python",
+    "summary",
+    "version",
+}
+
+_LIST_STRING_FIELDS = {
+    "classifiers",
+    "dynamic",
+    "obsoletes",
+    "obsoletes_dist",
+    "platforms",
+    "provides",
+    "provides_dist",
+    "provides_extra",
+    "requires",
+    "requires_dist",
+    "requires_external",
+    "supported_platforms",
+}
+
+
+def _parse_keywords(data: str) -> List[str]:
+    """Split a string of comma-separate keyboards into a list of keywords."""
+    return [k.strip() for k in data.split(",")]
+
+
+def _parse_project_urls(data: List[str]) -> Dict[str, str]:
+    """Parse a list of label/URL string pairings separated by a comma."""
+    urls = {}
+    for pair in data:
+        # Our logic is slightly tricky here as we want to try and do
+        # *something* reasonable with malformed data.
+        #
+        # The main thing that we have to worry about, is data that does
+        # not have a ',' at all to split the label from the Value. There
+        # isn't a singular right answer here, and we will fail validation
+        # later on (if the caller is validating) so it doesn't *really*
+        # matter, but since the missing value has to be an empty str
+        # and our return value is dict[str, str], if we let the key
+        # be the missing value, then they'd have multiple '' values that
+        # overwrite each other in a accumulating dict.
+        #
+        # The other potentional issue is that it's possible to have the
+        # same label multiple times in the metadata, with no solid "right"
+        # answer with what to do in that case. As such, we'll do the only
+        # thing we can, which is treat the field as unparseable and add it
+        # to our list of unparsed fields.
+        parts = [p.strip() for p in pair.split(",", 1)]
+        parts.extend([""] * (max(0, 2 - len(parts))))  # Ensure 2 items
+
+        # TODO: The spec doesn't say anything about if the keys should be
+        #       considered case sensitive or not... logically they should
+        #       be case-preserving and case-insensitive, but doing that
+        #       would open up more cases where we might have duplicate
+        #       entries.
+        label, url = parts
+        if label in urls:
+            # The label already exists in our set of urls, so this field
+            # is unparseable, and we can just add the whole thing to our
+            # unparseable data and stop processing it.
+            raise KeyError("duplicate labels in project urls")
+        urls[label] = url
+
+    return urls
+
+
+def _get_payload(msg: email.message.Message, source: Union[bytes, str]) -> str:
+    """Get the body of the message."""
+    # If our source is a str, then our caller has managed encodings for us,
+    # and we don't need to deal with it.
+    if isinstance(source, str):
+        payload: str = msg.get_payload()
+        return payload
+    # If our source is a bytes, then we're managing the encoding and we need
+    # to deal with it.
+    else:
+        bpayload: bytes = msg.get_payload(decode=True)
+        try:
+            return bpayload.decode("utf8", "strict")
+        except UnicodeDecodeError:
+            raise ValueError("payload in an invalid encoding")
+
+
+# The various parse_FORMAT functions here are intended to be as lenient as
+# possible in their parsing, while still returning a correctly typed
+# RawMetadata.
+#
+# To aid in this, we also generally want to do as little touching of the
+# data as possible, except where there are possibly some historic holdovers
+# that make valid data awkward to work with.
+#
+# While this is a lower level, intermediate format than our ``Metadata``
+# class, some light touch ups can make a massive difference in usability.
+
+# Map METADATA fields to RawMetadata.
+_EMAIL_TO_RAW_MAPPING = {
+    "author": "author",
+    "author-email": "author_email",
+    "classifier": "classifiers",
+    "description": "description",
+    "description-content-type": "description_content_type",
+    "download-url": "download_url",
+    "dynamic": "dynamic",
+    "home-page": "home_page",
+    "keywords": "keywords",
+    "license": "license",
+    "maintainer": "maintainer",
+    "maintainer-email": "maintainer_email",
+    "metadata-version": "metadata_version",
+    "name": "name",
+    "obsoletes": "obsoletes",
+    "obsoletes-dist": "obsoletes_dist",
+    "platform": "platforms",
+    "project-url": "project_urls",
+    "provides": "provides",
+    "provides-dist": "provides_dist",
+    "provides-extra": "provides_extra",
+    "requires": "requires",
+    "requires-dist": "requires_dist",
+    "requires-external": "requires_external",
+    "requires-python": "requires_python",
+    "summary": "summary",
+    "supported-platform": "supported_platforms",
+    "version": "version",
+}
+
+
+def parse_email(data: Union[bytes, str]) -> Tuple[RawMetadata, Dict[str, List[str]]]:
+    """Parse a distribution's metadata.
+
+    This function returns a two-item tuple of dicts. The first dict is of
+    recognized fields from the core metadata specification. Fields that can be
+    parsed and translated into Python's built-in types are converted
+    appropriately. All other fields are left as-is. Fields that are allowed to
+    appear multiple times are stored as lists.
+
+    The second dict contains all other fields from the metadata. This includes
+    any unrecognized fields. It also includes any fields which are expected to
+    be parsed into a built-in type but were not formatted appropriately. Finally,
+    any fields that are expected to appear only once but are repeated are
+    included in this dict.
+
+    """
+    raw: Dict[str, Union[str, List[str], Dict[str, str]]] = {}
+    unparsed: Dict[str, List[str]] = {}
+
+    if isinstance(data, str):
+        parsed = email.parser.Parser(policy=email.policy.compat32).parsestr(data)
+    else:
+        parsed = email.parser.BytesParser(policy=email.policy.compat32).parsebytes(data)
+
+    # We have to wrap parsed.keys() in a set, because in the case of multiple
+    # values for a key (a list), the key will appear multiple times in the
+    # list of keys, but we're avoiding that by using get_all().
+    for name in frozenset(parsed.keys()):
+        # Header names in RFC are case insensitive, so we'll normalize to all
+        # lower case to make comparisons easier.
+        name = name.lower()
+
+        # We use get_all() here, even for fields that aren't multiple use,
+        # because otherwise someone could have e.g. two Name fields, and we
+        # would just silently ignore it rather than doing something about it.
+        headers = parsed.get_all(name)
+
+        # The way the email module works when parsing bytes is that it
+        # unconditionally decodes the bytes as ascii using the surrogateescape
+        # handler. When you pull that data back out (such as with get_all() ),
+        # it looks to see if the str has any surrogate escapes, and if it does
+        # it wraps it in a Header object instead of returning the string.
+        #
+        # As such, we'll look for those Header objects, and fix up the encoding.
+        value = []
+        # Flag if we have run into any issues processing the headers, thus
+        # signalling that the data belongs in 'unparsed'.
+        valid_encoding = True
+        for h in headers:
+            # It's unclear if this can return more types than just a Header or
+            # a str, so we'll just assert here to make sure.
+            assert isinstance(h, (email.header.Header, str))
+
+            # If it's a header object, we need to do our little dance to get
+            # the real data out of it. In cases where there is invalid data
+            # we're going to end up with mojibake, but there's no obvious, good
+            # way around that without reimplementing parts of the Header object
+            # ourselves.
+            #
+            # That should be fine since, if mojibacked happens, this key is
+            # going into the unparsed dict anyways.
+            if isinstance(h, email.header.Header):
+                # The Header object stores it's data as chunks, and each chunk
+                # can be independently encoded, so we'll need to check each
+                # of them.
+                chunks: List[Tuple[bytes, Optional[str]]] = []
+                for bin, encoding in email.header.decode_header(h):
+                    try:
+                        bin.decode("utf8", "strict")
+                    except UnicodeDecodeError:
+                        # Enable mojibake.
+                        encoding = "latin1"
+                        valid_encoding = False
+                    else:
+                        encoding = "utf8"
+                    chunks.append((bin, encoding))
+
+                # Turn our chunks back into a Header object, then let that
+                # Header object do the right thing to turn them into a
+                # string for us.
+                value.append(str(email.header.make_header(chunks)))
+            # This is already a string, so just add it.
+            else:
+                value.append(h)
+
+        # We've processed all of our values to get them into a list of str,
+        # but we may have mojibake data, in which case this is an unparsed
+        # field.
+        if not valid_encoding:
+            unparsed[name] = value
+            continue
+
+        raw_name = _EMAIL_TO_RAW_MAPPING.get(name)
+        if raw_name is None:
+            # This is a bit of a weird situation, we've encountered a key that
+            # we don't know what it means, so we don't know whether it's meant
+            # to be a list or not.
+            #
+            # Since we can't really tell one way or another, we'll just leave it
+            # as a list, even though it may be a single item list, because that's
+            # what makes the most sense for email headers.
+            unparsed[name] = value
+            continue
+
+        # If this is one of our string fields, then we'll check to see if our
+        # value is a list of a single item. If it is then we'll assume that
+        # it was emitted as a single string, and unwrap the str from inside
+        # the list.
+        #
+        # If it's any other kind of data, then we haven't the faintest clue
+        # what we should parse it as, and we have to just add it to our list
+        # of unparsed stuff.
+        if raw_name in _STRING_FIELDS and len(value) == 1:
+            raw[raw_name] = value[0]
+        # If this is one of our list of string fields, then we can just assign
+        # the value, since email *only* has strings, and our get_all() call
+        # above ensures that this is a list.
+        elif raw_name in _LIST_STRING_FIELDS:
+            raw[raw_name] = value
+        # Special Case: Keywords
+        # The keywords field is implemented in the metadata spec as a str,
+        # but it conceptually is a list of strings, and is serialized using
+        # ", ".join(keywords), so we'll do some light data massaging to turn
+        # this into what it logically is.
+        elif raw_name == "keywords" and len(value) == 1:
+            raw[raw_name] = _parse_keywords(value[0])
+        # Special Case: Project-URL
+        # The project urls is implemented in the metadata spec as a list of
+        # specially-formatted strings that represent a key and a value, which
+        # is fundamentally a mapping, however the email format doesn't support
+        # mappings in a sane way, so it was crammed into a list of strings
+        # instead.
+        #
+        # We will do a little light data massaging to turn this into a map as
+        # it logically should be.
+        elif raw_name == "project_urls":
+            try:
+                raw[raw_name] = _parse_project_urls(value)
+            except KeyError:
+                unparsed[name] = value
+        # Nothing that we've done has managed to parse this, so it'll just
+        # throw it in our unparseable data and move on.
+        else:
+            unparsed[name] = value
+
+    # We need to support getting the Description from the message payload in
+    # addition to getting it from the the headers. This does mean, though, there
+    # is the possibility of it being set both ways, in which case we put both
+    # in 'unparsed' since we don't know which is right.
+    try:
+        payload = _get_payload(parsed, data)
+    except ValueError:
+        unparsed.setdefault("description", []).append(
+            parsed.get_payload(decode=isinstance(data, bytes))
+        )
+    else:
+        if payload:
+            # Check to see if we've already got a description, if so then both
+            # it, and this body move to unparseable.
+            if "description" in raw:
+                description_header = cast(str, raw.pop("description"))
+                unparsed.setdefault("description", []).extend(
+                    [description_header, payload]
+                )
+            elif "description" in unparsed:
+                unparsed["description"].append(payload)
+            else:
+                raw["description"] = payload
+
+    # We need to cast our `raw` to a metadata, because a TypedDict only support
+    # literal key names, but we're computing our key names on purpose, but the
+    # way this function is implemented, our `TypedDict` can only have valid key
+    # names.
+    return cast(RawMetadata, raw), unparsed
diff --git a/lib/packaging/requirements.py b/lib/packaging/requirements.py
index a9f9b9c7..f34bfa85 100644
--- a/lib/packaging/requirements.py
+++ b/lib/packaging/requirements.py
@@ -5,7 +5,7 @@
 import urllib.parse
 from typing import Any, List, Optional, Set
 
-from ._parser import parse_requirement
+from ._parser import parse_requirement as _parse_requirement
 from ._tokenizer import ParserSyntaxError
 from .markers import Marker, _normalize_extra_values
 from .specifiers import SpecifierSet
@@ -32,7 +32,7 @@ class Requirement:
 
     def __init__(self, requirement_string: str) -> None:
         try:
-            parsed = parse_requirement(requirement_string)
+            parsed = _parse_requirement(requirement_string)
         except ParserSyntaxError as e:
             raise InvalidRequirement(str(e)) from e
 
diff --git a/lib/packaging/specifiers.py b/lib/packaging/specifiers.py
index e715ecc8..ba8fe37b 100644
--- a/lib/packaging/specifiers.py
+++ b/lib/packaging/specifiers.py
@@ -252,7 +252,8 @@ class Specifier(BaseSpecifier):
         # Store whether or not this Specifier should accept prereleases
         self._prereleases = prereleases
 
-    @property
+    # https://github.com/python/mypy/pull/13475#pullrequestreview-1079784515
+    @property  # type: ignore[override]
     def prereleases(self) -> bool:
         # If there is an explicit prereleases set for this, then we'll just
         # blindly use that.
@@ -398,7 +399,9 @@ class Specifier(BaseSpecifier):
         # We need special logic to handle prefix matching
         if spec.endswith(".*"):
             # In the case of prefix matching we want to ignore local segment.
-            normalized_prospective = canonicalize_version(prospective.public)
+            normalized_prospective = canonicalize_version(
+                prospective.public, strip_trailing_zero=False
+            )
             # Get the normalized version string ignoring the trailing .*
             normalized_spec = canonicalize_version(spec[:-2], strip_trailing_zero=False)
             # Split the spec out by dots, and pretend that there is an implicit
diff --git a/lib/packaging/tags.py b/lib/packaging/tags.py
index 19ccbde3..76d24341 100644
--- a/lib/packaging/tags.py
+++ b/lib/packaging/tags.py
@@ -111,7 +111,7 @@ def parse_tag(tag: str) -> FrozenSet[Tag]:
 
 
 def _get_config_var(name: str, warn: bool = False) -> Union[int, str, None]:
-    value = sysconfig.get_config_var(name)
+    value: Union[int, str, None] = sysconfig.get_config_var(name)
     if value is None and warn:
         logger.debug(
             "Config variable '%s' is unset, Python ABI tag may be incorrect", name
@@ -120,7 +120,7 @@ def _get_config_var(name: str, warn: bool = False) -> Union[int, str, None]:
 
 
 def _normalize_string(string: str) -> str:
-    return string.replace(".", "_").replace("-", "_")
+    return string.replace(".", "_").replace("-", "_").replace(" ", "_")
 
 
 def _abi3_applies(python_version: PythonVersion) -> bool:
diff --git a/lib/packaging/version.py b/lib/packaging/version.py
index e5c738cf..b30e8cbf 100644
--- a/lib/packaging/version.py
+++ b/lib/packaging/version.py
@@ -10,7 +10,7 @@
 import collections
 import itertools
 import re
-from typing import Callable, Optional, SupportsInt, Tuple, Union
+from typing import Any, Callable, Optional, SupportsInt, Tuple, Union
 
 from ._structures import Infinity, InfinityType, NegativeInfinity, NegativeInfinityType
 
@@ -63,7 +63,7 @@ class InvalidVersion(ValueError):
 
 
 class _BaseVersion:
-    _key: CmpKey
+    _key: Tuple[Any, ...]
 
     def __hash__(self) -> int:
         return hash(self._key)
@@ -179,6 +179,7 @@ class Version(_BaseVersion):
     """
 
     _regex = re.compile(r"^\s*" + VERSION_PATTERN + r"\s*$", re.VERBOSE | re.IGNORECASE)
+    _key: CmpKey
 
     def __init__(self, version: str) -> None:
         """Initialize a Version object.
diff --git a/requirements.txt b/requirements.txt
index bba4cea0..926a4075 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -26,7 +26,7 @@ IPy==1.01
 Mako==1.2.4
 MarkupSafe==2.1.2
 musicbrainzngs==0.7.1
-packaging==23.0
+packaging==23.1
 paho-mqtt==1.6.1
 plexapi==4.13.4
 portend==3.1.0

From 478d9e6aa5f604381dd14469ba5ea6d05d0bac5b Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 23 Aug 2023 21:39:21 -0700
Subject: [PATCH 426/743] Bump soupsieve from 2.4 to 2.4.1 (#2051)

* Bump soupsieve from 2.4 to 2.4.1

Bumps [soupsieve](https://github.com/facelessuser/soupsieve) from 2.4 to 2.4.1.
- [Release notes](https://github.com/facelessuser/soupsieve/releases)
- [Commits](https://github.com/facelessuser/soupsieve/compare/2.4...2.4.1)

---
updated-dependencies:
- dependency-name: soupsieve
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

* Remove soupsieve

---------

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

[skip ci]
---
 requirements.txt | 1 -
 1 file changed, 1 deletion(-)

diff --git a/requirements.txt b/requirements.txt
index 926a4075..231adbca 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -41,7 +41,6 @@ requests-oauthlib==1.3.1
 rumps==0.4.0; platform_system == "Darwin"
 simplejson==3.19.1
 six==1.16.0
-soupsieve==2.4
 tempora==5.2.1
 tokenize-rt==5.0.0
 tzdata==2023.3

From 6b6d43ef43e8b8f85d97aec07312279c06edd6aa Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 23 Aug 2023 21:40:02 -0700
Subject: [PATCH 427/743] Bump requests from 2.28.2 to 2.31.0 (#2078)

* Bump requests from 2.28.2 to 2.31.0

Bumps [requests](https://github.com/psf/requests) from 2.28.2 to 2.31.0.
- [Release notes](https://github.com/psf/requests/releases)
- [Changelog](https://github.com/psf/requests/blob/main/HISTORY.md)
- [Commits](https://github.com/psf/requests/compare/v2.28.2...v2.31.0)

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

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

* Update requests==2.31.0

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/certifi/__init__.py                       |    2 +-
 lib/certifi/cacert.pem                        |  386 +++---
 lib/charset_normalizer/__init__.py            |    3 +-
 lib/charset_normalizer/api.py                 |   80 +-
 lib/charset_normalizer/md.py                  |   17 +-
 lib/charset_normalizer/utils.py               |    4 +-
 lib/charset_normalizer/version.py             |    2 +-
 lib/requests/__init__.py                      |    8 +-
 lib/requests/__version__.py                   |    4 +-
 lib/requests/_internal_utils.py               |    6 +-
 lib/requests/adapters.py                      |   72 +-
 lib/requests/api.py                           |    6 +-
 lib/requests/sessions.py                      |    4 +-
 lib/requests/utils.py                         |   32 +-
 lib/urllib3/__init__.py                       |   90 +-
 lib/urllib3/_base_connection.py               |  173 +++
 lib/urllib3/_collections.py                   |  402 +++---
 .../{request.py => _request_methods.py}       |  107 +-
 lib/urllib3/_version.py                       |    4 +-
 lib/urllib3/connection.py                     |  946 ++++++++++-----
 lib/urllib3/connectionpool.py                 |  804 ++++++------
 lib/urllib3/contrib/_appengine_environ.py     |   36 -
 .../contrib/_securetransport/bindings.py      |  111 +-
 .../contrib/_securetransport/low_level.py     |  121 +-
 lib/urllib3/contrib/appengine.py              |  314 -----
 lib/urllib3/contrib/ntlmpool.py               |  130 --
 lib/urllib3/contrib/pyopenssl.py              |  381 +++---
 lib/urllib3/contrib/securetransport.py        |  398 +++---
 lib/urllib3/contrib/socks.py                  |   87 +-
 lib/urllib3/exceptions.py                     |  189 ++-
 lib/urllib3/fields.py                         |  267 ++--
 lib/urllib3/filepost.py                       |   67 +-
 lib/urllib3/packages/__init__.py              |    0
 lib/urllib3/packages/backports/__init__.py    |    0
 lib/urllib3/packages/backports/makefile.py    |   51 -
 lib/urllib3/packages/six.py                   | 1076 -----------------
 lib/urllib3/poolmanager.py                    |  347 ++++--
 lib/urllib3/py.typed                          |    2 +
 lib/urllib3/response.py                       |  895 +++++++++-----
 lib/urllib3/util/__init__.py                  |   17 +-
 lib/urllib3/util/connection.py                |   80 +-
 lib/urllib3/util/proxy.py                     |   38 +-
 lib/urllib3/util/queue.py                     |   22 -
 lib/urllib3/util/request.py                   |  170 ++-
 lib/urllib3/util/response.py                  |   78 +-
 lib/urllib3/util/retry.py                     |  357 ++----
 lib/urllib3/util/ssl_.py                      |  534 ++++----
 lib/urllib3/util/ssl_match_hostname.py        |   94 +-
 lib/urllib3/util/ssltransport.py              |  165 ++-
 lib/urllib3/util/timeout.py                   |  112 +-
 lib/urllib3/util/url.py                       |  396 +++---
 lib/urllib3/util/util.py                      |   42 +
 lib/urllib3/util/wait.py                      |   88 +-
 requirements.txt                              |    2 +-
 54 files changed, 4861 insertions(+), 4958 deletions(-)
 create mode 100644 lib/urllib3/_base_connection.py
 rename lib/urllib3/{request.py => _request_methods.py} (63%)
 delete mode 100644 lib/urllib3/contrib/_appengine_environ.py
 delete mode 100644 lib/urllib3/contrib/appengine.py
 delete mode 100644 lib/urllib3/contrib/ntlmpool.py
 delete mode 100644 lib/urllib3/packages/__init__.py
 delete mode 100644 lib/urllib3/packages/backports/__init__.py
 delete mode 100644 lib/urllib3/packages/backports/makefile.py
 delete mode 100644 lib/urllib3/packages/six.py
 create mode 100644 lib/urllib3/py.typed
 delete mode 100644 lib/urllib3/util/queue.py
 create mode 100644 lib/urllib3/util/util.py

diff --git a/lib/certifi/__init__.py b/lib/certifi/__init__.py
index a3546f12..8ce89cef 100644
--- a/lib/certifi/__init__.py
+++ b/lib/certifi/__init__.py
@@ -1,4 +1,4 @@
 from .core import contents, where
 
 __all__ = ["contents", "where"]
-__version__ = "2022.12.07"
+__version__ = "2023.07.22"
diff --git a/lib/certifi/cacert.pem b/lib/certifi/cacert.pem
index df9e4e3c..02123695 100644
--- a/lib/certifi/cacert.pem
+++ b/lib/certifi/cacert.pem
@@ -791,34 +791,6 @@ uLjbvrW5KfnaNwUASZQDhETnv0Mxz3WLJdH0pmT1kvarBes96aULNmLazAZfNou2
 XjG4Kvte9nHfRCaexOYNkbQudZWAUWpLMKawYqGT8ZvYzsRjdT9ZR7E=
 -----END CERTIFICATE-----
 
-# Issuer: CN=Hongkong Post Root CA 1 O=Hongkong Post
-# Subject: CN=Hongkong Post Root CA 1 O=Hongkong Post
-# Label: "Hongkong Post Root CA 1"
-# Serial: 1000
-# MD5 Fingerprint: a8:0d:6f:39:78:b9:43:6d:77:42:6d:98:5a:cc:23:ca
-# SHA1 Fingerprint: d6:da:a8:20:8d:09:d2:15:4d:24:b5:2f:cb:34:6e:b2:58:b2:8a:58
-# SHA256 Fingerprint: f9:e6:7d:33:6c:51:00:2a:c0:54:c6:32:02:2d:66:dd:a2:e7:e3:ff:f1:0a:d0:61:ed:31:d8:bb:b4:10:cf:b2
------BEGIN CERTIFICATE-----
-MIIDMDCCAhigAwIBAgICA+gwDQYJKoZIhvcNAQEFBQAwRzELMAkGA1UEBhMCSEsx
-FjAUBgNVBAoTDUhvbmdrb25nIFBvc3QxIDAeBgNVBAMTF0hvbmdrb25nIFBvc3Qg
-Um9vdCBDQSAxMB4XDTAzMDUxNTA1MTMxNFoXDTIzMDUxNTA0NTIyOVowRzELMAkG
-A1UEBhMCSEsxFjAUBgNVBAoTDUhvbmdrb25nIFBvc3QxIDAeBgNVBAMTF0hvbmdr
-b25nIFBvc3QgUm9vdCBDQSAxMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKC
-AQEArP84tulmAknjorThkPlAj3n54r15/gK97iSSHSL22oVyaf7XPwnU3ZG1ApzQ
-jVrhVcNQhrkpJsLj2aDxaQMoIIBFIi1WpztUlVYiWR8o3x8gPW2iNr4joLFutbEn
-PzlTCeqrauh0ssJlXI6/fMN4hM2eFvz1Lk8gKgifd/PFHsSaUmYeSF7jEAaPIpjh
-ZY4bXSNmO7ilMlHIhqqhqZ5/dpTCpmy3QfDVyAY45tQM4vM7TG1QjMSDJ8EThFk9
-nnV0ttgCXjqQesBCNnLsak3c78QA3xMYV18meMjWCnl3v/evt3a5pQuEF10Q6m/h
-q5URX208o1xNg1vysxmKgIsLhwIDAQABoyYwJDASBgNVHRMBAf8ECDAGAQH/AgED
-MA4GA1UdDwEB/wQEAwIBxjANBgkqhkiG9w0BAQUFAAOCAQEADkbVPK7ih9legYsC
-mEEIjEy82tvuJxuC52pF7BaLT4Wg87JwvVqWuspube5Gi27nKi6Wsxkz67SfqLI3
-7piol7Yutmcn1KZJ/RyTZXaeQi/cImyaT/JaFTmxcdcrUehtHJjA2Sr0oYJ71clB
-oiMBdDhViw+5LmeiIAQ32pwL0xch4I+XeTRvhEgCIDMb5jREn5Fw9IBehEPCKdJs
-EhTkYY2sEJCehFC78JZvRZ+K88psT/oROhUVRsPNH4NbLUES7VBnQRM9IauUiqpO
-fMGx+6fWtScvl6tu4B3i0RwsH0Ti/L6RoZz71ilTc4afU9hDDl3WY4JxHYB0yvbi
-AmvZWg==
------END CERTIFICATE-----
-
 # Issuer: CN=SecureSign RootCA11 O=Japan Certification Services, Inc.
 # Subject: CN=SecureSign RootCA11 O=Japan Certification Services, Inc.
 # Label: "SecureSign RootCA11"
@@ -1676,50 +1648,6 @@ HL/EVlP6Y2XQ8xwOFvVrhlhNGNTkDY6lnVuR3HYkUD/GKvvZt5y11ubQ2egZixVx
 SK236thZiNSQvxaz2emsWWFUyBy6ysHK4bkgTI86k4mloMy/0/Z1pHWWbVY=
 -----END CERTIFICATE-----
 
-# Issuer: CN=E-Tugra Certification Authority O=E-Tu\u011fra EBG Bili\u015fim Teknolojileri ve Hizmetleri A.\u015e. OU=E-Tugra Sertifikasyon Merkezi
-# Subject: CN=E-Tugra Certification Authority O=E-Tu\u011fra EBG Bili\u015fim Teknolojileri ve Hizmetleri A.\u015e. OU=E-Tugra Sertifikasyon Merkezi
-# Label: "E-Tugra Certification Authority"
-# Serial: 7667447206703254355
-# MD5 Fingerprint: b8:a1:03:63:b0:bd:21:71:70:8a:6f:13:3a:bb:79:49
-# SHA1 Fingerprint: 51:c6:e7:08:49:06:6e:f3:92:d4:5c:a0:0d:6d:a3:62:8f:c3:52:39
-# SHA256 Fingerprint: b0:bf:d5:2b:b0:d7:d9:bd:92:bf:5d:4d:c1:3d:a2:55:c0:2c:54:2f:37:83:65:ea:89:39:11:f5:5e:55:f2:3c
------BEGIN CERTIFICATE-----
-MIIGSzCCBDOgAwIBAgIIamg+nFGby1MwDQYJKoZIhvcNAQELBQAwgbIxCzAJBgNV
-BAYTAlRSMQ8wDQYDVQQHDAZBbmthcmExQDA+BgNVBAoMN0UtVHXEn3JhIEVCRyBC
-aWxpxZ9pbSBUZWtub2xvamlsZXJpIHZlIEhpem1ldGxlcmkgQS7Fni4xJjAkBgNV
-BAsMHUUtVHVncmEgU2VydGlmaWthc3lvbiBNZXJrZXppMSgwJgYDVQQDDB9FLVR1
-Z3JhIENlcnRpZmljYXRpb24gQXV0aG9yaXR5MB4XDTEzMDMwNTEyMDk0OFoXDTIz
-MDMwMzEyMDk0OFowgbIxCzAJBgNVBAYTAlRSMQ8wDQYDVQQHDAZBbmthcmExQDA+
-BgNVBAoMN0UtVHXEn3JhIEVCRyBCaWxpxZ9pbSBUZWtub2xvamlsZXJpIHZlIEhp
-em1ldGxlcmkgQS7Fni4xJjAkBgNVBAsMHUUtVHVncmEgU2VydGlmaWthc3lvbiBN
-ZXJrZXppMSgwJgYDVQQDDB9FLVR1Z3JhIENlcnRpZmljYXRpb24gQXV0aG9yaXR5
-MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA4vU/kwVRHoViVF56C/UY
-B4Oufq9899SKa6VjQzm5S/fDxmSJPZQuVIBSOTkHS0vdhQd2h8y/L5VMzH2nPbxH
-D5hw+IyFHnSOkm0bQNGZDbt1bsipa5rAhDGvykPL6ys06I+XawGb1Q5KCKpbknSF
-Q9OArqGIW66z6l7LFpp3RMih9lRozt6Plyu6W0ACDGQXwLWTzeHxE2bODHnv0ZEo
-q1+gElIwcxmOj+GMB6LDu0rw6h8VqO4lzKRG+Bsi77MOQ7osJLjFLFzUHPhdZL3D
-k14opz8n8Y4e0ypQBaNV2cvnOVPAmJ6MVGKLJrD3fY185MaeZkJVgkfnsliNZvcH
-fC425lAcP9tDJMW/hkd5s3kc91r0E+xs+D/iWR+V7kI+ua2oMoVJl0b+SzGPWsut
-dEcf6ZG33ygEIqDUD13ieU/qbIWGvaimzuT6w+Gzrt48Ue7LE3wBf4QOXVGUnhMM
-ti6lTPk5cDZvlsouDERVxcr6XQKj39ZkjFqzAQqptQpHF//vkUAqjqFGOjGY5RH8
-zLtJVor8udBhmm9lbObDyz51Sf6Pp+KJxWfXnUYTTjF2OySznhFlhqt/7x3U+Lzn
-rFpct1pHXFXOVbQicVtbC/DP3KBhZOqp12gKY6fgDT+gr9Oq0n7vUaDmUStVkhUX
-U8u3Zg5mTPj5dUyQ5xJwx0UCAwEAAaNjMGEwHQYDVR0OBBYEFC7j27JJ0JxUeVz6
-Jyr+zE7S6E5UMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAULuPbsknQnFR5
-XPonKv7MTtLoTlQwDgYDVR0PAQH/BAQDAgEGMA0GCSqGSIb3DQEBCwUAA4ICAQAF
-Nzr0TbdF4kV1JI+2d1LoHNgQk2Xz8lkGpD4eKexd0dCrfOAKkEh47U6YA5n+KGCR
-HTAduGN8qOY1tfrTYXbm1gdLymmasoR6d5NFFxWfJNCYExL/u6Au/U5Mh/jOXKqY
-GwXgAEZKgoClM4so3O0409/lPun++1ndYYRP0lSWE2ETPo+Aab6TR7U1Q9Jauz1c
-77NCR807VRMGsAnb/WP2OogKmW9+4c4bU2pEZiNRCHu8W1Ki/QY3OEBhj0qWuJA3
-+GbHeJAAFS6LrVE1Uweoa2iu+U48BybNCAVwzDk/dr2l02cmAYamU9JgO3xDf1WK
-vJUawSg5TB9D0pH0clmKuVb8P7Sd2nCcdlqMQ1DujjByTd//SffGqWfZbawCEeI6
-FiWnWAjLb1NBnEg4R2gz0dfHj9R0IdTDBZB6/86WiLEVKV0jq9BgoRJP3vQXzTLl
-yb/IQ639Lo7xr+L0mPoSHyDYwKcMhcWQ9DstliaxLL5Mq+ux0orJ23gTDx4JnW2P
-AJ8C2sH6H3p6CcRK5ogql5+Ji/03X186zjhZhkuvcQu02PJwT58yE+Owp1fl2tpD
-y4Q08ijE6m30Ku/Ba3ba+367hTzSU8JNvnHhRdH9I2cNE3X7z2VnIp2usAnRCf8d
-NL/+I5c30jn6PQ0GC7TbO6Orb1wdtn7os4I07QZcJA==
------END CERTIFICATE-----
-
 # Issuer: CN=T-TeleSec GlobalRoot Class 2 O=T-Systems Enterprise Services GmbH OU=T-Systems Trust Center
 # Subject: CN=T-TeleSec GlobalRoot Class 2 O=T-Systems Enterprise Services GmbH OU=T-Systems Trust Center
 # Label: "T-TeleSec GlobalRoot Class 2"
@@ -4397,73 +4325,6 @@ ut6Dacpps6kFtZaSF4fC0urQe87YQVt8rgIwRt7qy12a7DLCZRawTDBcMPPaTnOG
 BtjOiQRINzf43TNRnXCve1XYAS59BWQOhriR
 -----END CERTIFICATE-----
 
-# Issuer: CN=E-Tugra Global Root CA RSA v3 O=E-Tugra EBG A.S. OU=E-Tugra Trust Center
-# Subject: CN=E-Tugra Global Root CA RSA v3 O=E-Tugra EBG A.S. OU=E-Tugra Trust Center
-# Label: "E-Tugra Global Root CA RSA v3"
-# Serial: 75951268308633135324246244059508261641472512052
-# MD5 Fingerprint: 22:be:10:f6:c2:f8:03:88:73:5f:33:29:47:28:47:a4
-# SHA1 Fingerprint: e9:a8:5d:22:14:52:1c:5b:aa:0a:b4:be:24:6a:23:8a:c9:ba:e2:a9
-# SHA256 Fingerprint: ef:66:b0:b1:0a:3c:db:9f:2e:36:48:c7:6b:d2:af:18:ea:d2:bf:e6:f1:17:65:5e:28:c4:06:0d:a1:a3:f4:c2
------BEGIN CERTIFICATE-----
-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
------END CERTIFICATE-----
-
-# Issuer: CN=E-Tugra Global Root CA ECC v3 O=E-Tugra EBG A.S. OU=E-Tugra Trust Center
-# Subject: CN=E-Tugra Global Root CA ECC v3 O=E-Tugra EBG A.S. OU=E-Tugra Trust Center
-# Label: "E-Tugra Global Root CA ECC v3"
-# Serial: 218504919822255052842371958738296604628416471745
-# MD5 Fingerprint: 46:bc:81:bb:f1:b5:1e:f7:4b:96:bc:14:e2:e7:27:64
-# SHA1 Fingerprint: 8a:2f:af:57:53:b1:b0:e6:a1:04:ec:5b:6a:69:71:6d:f6:1c:e2:84
-# SHA256 Fingerprint: 87:3f:46:85:fa:7f:56:36:25:25:2e:6d:36:bc:d7:f1:6f:c2:49:51:f2:64:e4:7e:1b:95:4f:49:08:cd:ca:13
------BEGIN CERTIFICATE-----
-MIICpTCCAiqgAwIBAgIUJkYZdzHhT28oNt45UYbm1JeIIsEwCgYIKoZIzj0EAwMw
-gYAxCzAJBgNVBAYTAlRSMQ8wDQYDVQQHEwZBbmthcmExGTAXBgNVBAoTEEUtVHVn
-cmEgRUJHIEEuUy4xHTAbBgNVBAsTFEUtVHVncmEgVHJ1c3QgQ2VudGVyMSYwJAYD
-VQQDEx1FLVR1Z3JhIEdsb2JhbCBSb290IENBIEVDQyB2MzAeFw0yMDAzMTgwOTQ2
-NThaFw00NTAzMTIwOTQ2NThaMIGAMQswCQYDVQQGEwJUUjEPMA0GA1UEBxMGQW5r
-YXJhMRkwFwYDVQQKExBFLVR1Z3JhIEVCRyBBLlMuMR0wGwYDVQQLExRFLVR1Z3Jh
-IFRydXN0IENlbnRlcjEmMCQGA1UEAxMdRS1UdWdyYSBHbG9iYWwgUm9vdCBDQSBF
-Q0MgdjMwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAASOmCm/xxAeJ9urA8woLNheSBkQ
-KczLWYHMjLiSF4mDKpL2w6QdTGLVn9agRtwcvHbB40fQWxPa56WzZkjnIZpKT4YK
-fWzqTTKACrJ6CZtpS5iB4i7sAnCWH/31Rs7K3IKjYzBhMA8GA1UdEwEB/wQFMAMB
-Af8wHwYDVR0jBBgwFoAU/4Ixcj75xGZsrTie0bBRiKWQzPUwHQYDVR0OBBYEFP+C
-MXI++cRmbK04ntGwUYilkMz1MA4GA1UdDwEB/wQEAwIBBjAKBggqhkjOPQQDAwNp
-ADBmAjEA5gVYaWHlLcoNy/EZCL3W/VGSGn5jVASQkZo1kTmZ+gepZpO6yGjUij/6
-7W4WAie3AjEA3VoXK3YdZUKWpqxdinlW2Iob35reX8dQj7FbcQwm32pAAOwzkSFx
-vmjkI6TZraE3
------END CERTIFICATE-----
-
 # Issuer: CN=Security Communication RootCA3 O=SECOM Trust Systems CO.,LTD.
 # Subject: CN=Security Communication RootCA3 O=SECOM Trust Systems CO.,LTD.
 # Label: "Security Communication RootCA3"
@@ -4525,3 +4386,250 @@ BAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAKBggqhkjOPQQDAwNoADBlAjAVXUI9/Lbu
 9zuxNuie9sRGKEkz0FhDKmMpzE2xtHqiuQ04pV1IKv3LsnNdo4gIxwwCMQDAqy0O
 be0YottT6SXbVQjgUMzfRGEWgqtJsLKB7HOHeLRMsmIbEvoWTSVLY70eN9k=
 -----END CERTIFICATE-----
+
+# Issuer: CN=BJCA Global Root CA1 O=BEIJING CERTIFICATE AUTHORITY
+# Subject: CN=BJCA Global Root CA1 O=BEIJING CERTIFICATE AUTHORITY
+# Label: "BJCA Global Root CA1"
+# Serial: 113562791157148395269083148143378328608
+# MD5 Fingerprint: 42:32:99:76:43:33:36:24:35:07:82:9b:28:f9:d0:90
+# SHA1 Fingerprint: d5:ec:8d:7b:4c:ba:79:f4:e7:e8:cb:9d:6b:ae:77:83:10:03:21:6a
+# SHA256 Fingerprint: f3:89:6f:88:fe:7c:0a:88:27:66:a7:fa:6a:d2:74:9f:b5:7a:7f:3e:98:fb:76:9c:1f:a7:b0:9c:2c:44:d5:ae
+-----BEGIN CERTIFICATE-----
+MIIFdDCCA1ygAwIBAgIQVW9l47TZkGobCdFsPsBsIDANBgkqhkiG9w0BAQsFADBU
+MQswCQYDVQQGEwJDTjEmMCQGA1UECgwdQkVJSklORyBDRVJUSUZJQ0FURSBBVVRI
+T1JJVFkxHTAbBgNVBAMMFEJKQ0EgR2xvYmFsIFJvb3QgQ0ExMB4XDTE5MTIxOTAz
+MTYxN1oXDTQ0MTIxMjAzMTYxN1owVDELMAkGA1UEBhMCQ04xJjAkBgNVBAoMHUJF
+SUpJTkcgQ0VSVElGSUNBVEUgQVVUSE9SSVRZMR0wGwYDVQQDDBRCSkNBIEdsb2Jh
+bCBSb290IENBMTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAPFmCL3Z
+xRVhy4QEQaVpN3cdwbB7+sN3SJATcmTRuHyQNZ0YeYjjlwE8R4HyDqKYDZ4/N+AZ
+spDyRhySsTphzvq3Rp4Dhtczbu33RYx2N95ulpH3134rhxfVizXuhJFyV9xgw8O5
+58dnJCNPYwpj9mZ9S1WnP3hkSWkSl+BMDdMJoDIwOvqfwPKcxRIqLhy1BDPapDgR
+at7GGPZHOiJBhyL8xIkoVNiMpTAK+BcWyqw3/XmnkRd4OJmtWO2y3syJfQOcs4ll
+5+M7sSKGjwZteAf9kRJ/sGsciQ35uMt0WwfCyPQ10WRjeulumijWML3mG90Vr4Tq
+nMfK9Q7q8l0ph49pczm+LiRvRSGsxdRpJQaDrXpIhRMsDQa4bHlW/KNnMoH1V6XK
+V0Jp6VwkYe/iMBhORJhVb3rCk9gZtt58R4oRTklH2yiUAguUSiz5EtBP6DF+bHq/
+pj+bOT0CFqMYs2esWz8sgytnOYFcuX6U1WTdno9uruh8W7TXakdI136z1C2OVnZO
+z2nxbkRs1CTqjSShGL+9V/6pmTW12xB3uD1IutbB5/EjPtffhZ0nPNRAvQoMvfXn
+jSXWgXSHRtQpdaJCbPdzied9v3pKH9MiyRVVz99vfFXQpIsHETdfg6YmV6YBW37+
+WGgHqel62bno/1Afq8K0wM7o6v0PvY1NuLxxAgMBAAGjQjBAMB0GA1UdDgQWBBTF
+7+3M2I0hxkjk49cULqcWk+WYATAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQE
+AwIBBjANBgkqhkiG9w0BAQsFAAOCAgEAUoKsITQfI/Ki2Pm4rzc2IInRNwPWaZ+4
+YRC6ojGYWUfo0Q0lHhVBDOAqVdVXUsv45Mdpox1NcQJeXyFFYEhcCY5JEMEE3Kli
+awLwQ8hOnThJdMkycFRtwUf8jrQ2ntScvd0g1lPJGKm1Vrl2i5VnZu69mP6u775u
++2D2/VnGKhs/I0qUJDAnyIm860Qkmss9vk/Ves6OF8tiwdneHg56/0OGNFK8YT88
+X7vZdrRTvJez/opMEi4r89fO4aL/3Xtw+zuhTaRjAv04l5U/BXCga99igUOLtFkN
+SoxUnMW7gZ/NfaXvCyUeOiDbHPwfmGcCCtRzRBPbUYQaVQNW4AB+dAb/OMRyHdOo
+P2gxXdMJxy6MW2Pg6Nwe0uxhHvLe5e/2mXZgLR6UcnHGCyoyx5JO1UbXHfmpGQrI
++pXObSOYqgs4rZpWDW+N8TEAiMEXnM0ZNjX+VVOg4DwzX5Ze4jLp3zO7Bkqp2IRz
+znfSxqxx4VyjHQy7Ct9f4qNx2No3WqB4K/TUfet27fJhcKVlmtOJNBir+3I+17Q9
+eVzYH6Eze9mCUAyTF6ps3MKCuwJXNq+YJyo5UOGwifUll35HaBC07HPKs5fRJNz2
+YqAo07WjuGS3iGJCz51TzZm+ZGiPTx4SSPfSKcOYKMryMguTjClPPGAyzQWWYezy
+r/6zcCwupvI=
+-----END CERTIFICATE-----
+
+# Issuer: CN=BJCA Global Root CA2 O=BEIJING CERTIFICATE AUTHORITY
+# Subject: CN=BJCA Global Root CA2 O=BEIJING CERTIFICATE AUTHORITY
+# Label: "BJCA Global Root CA2"
+# Serial: 58605626836079930195615843123109055211
+# MD5 Fingerprint: 5e:0a:f6:47:5f:a6:14:e8:11:01:95:3f:4d:01:eb:3c
+# SHA1 Fingerprint: f4:27:86:eb:6e:b8:6d:88:31:67:02:fb:ba:66:a4:53:00:aa:7a:a6
+# SHA256 Fingerprint: 57:4d:f6:93:1e:27:80:39:66:7b:72:0a:fd:c1:60:0f:c2:7e:b6:6d:d3:09:29:79:fb:73:85:64:87:21:28:82
+-----BEGIN CERTIFICATE-----
+MIICJTCCAaugAwIBAgIQLBcIfWQqwP6FGFkGz7RK6zAKBggqhkjOPQQDAzBUMQsw
+CQYDVQQGEwJDTjEmMCQGA1UECgwdQkVJSklORyBDRVJUSUZJQ0FURSBBVVRIT1JJ
+VFkxHTAbBgNVBAMMFEJKQ0EgR2xvYmFsIFJvb3QgQ0EyMB4XDTE5MTIxOTAzMTgy
+MVoXDTQ0MTIxMjAzMTgyMVowVDELMAkGA1UEBhMCQ04xJjAkBgNVBAoMHUJFSUpJ
+TkcgQ0VSVElGSUNBVEUgQVVUSE9SSVRZMR0wGwYDVQQDDBRCSkNBIEdsb2JhbCBS
+b290IENBMjB2MBAGByqGSM49AgEGBSuBBAAiA2IABJ3LgJGNU2e1uVCxA/jlSR9B
+IgmwUVJY1is0j8USRhTFiy8shP8sbqjV8QnjAyEUxEM9fMEsxEtqSs3ph+B99iK+
++kpRuDCK/eHeGBIK9ke35xe/J4rUQUyWPGCWwf0VHKNCMEAwHQYDVR0OBBYEFNJK
+sVF/BvDRgh9Obl+rg/xI1LCRMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQD
+AgEGMAoGCCqGSM49BAMDA2gAMGUCMBq8W9f+qdJUDkpd0m2xQNz0Q9XSSpkZElaA
+94M04TVOSG0ED1cxMDAtsaqdAzjbBgIxAMvMh1PLet8gUXOQwKhbYdDFUDn9hf7B
+43j4ptZLvZuHjw/l1lOWqzzIQNph91Oj9w==
+-----END CERTIFICATE-----
+
+# Issuer: CN=Sectigo Public Server Authentication Root E46 O=Sectigo Limited
+# Subject: CN=Sectigo Public Server Authentication Root E46 O=Sectigo Limited
+# Label: "Sectigo Public Server Authentication Root E46"
+# Serial: 88989738453351742415770396670917916916
+# MD5 Fingerprint: 28:23:f8:b2:98:5c:37:16:3b:3e:46:13:4e:b0:b3:01
+# SHA1 Fingerprint: ec:8a:39:6c:40:f0:2e:bc:42:75:d4:9f:ab:1c:1a:5b:67:be:d2:9a
+# SHA256 Fingerprint: c9:0f:26:f0:fb:1b:40:18:b2:22:27:51:9b:5c:a2:b5:3e:2c:a5:b3:be:5c:f1:8e:fe:1b:ef:47:38:0c:53:83
+-----BEGIN CERTIFICATE-----
+MIICOjCCAcGgAwIBAgIQQvLM2htpN0RfFf51KBC49DAKBggqhkjOPQQDAzBfMQsw
+CQYDVQQGEwJHQjEYMBYGA1UEChMPU2VjdGlnbyBMaW1pdGVkMTYwNAYDVQQDEy1T
+ZWN0aWdvIFB1YmxpYyBTZXJ2ZXIgQXV0aGVudGljYXRpb24gUm9vdCBFNDYwHhcN
+MjEwMzIyMDAwMDAwWhcNNDYwMzIxMjM1OTU5WjBfMQswCQYDVQQGEwJHQjEYMBYG
+A1UEChMPU2VjdGlnbyBMaW1pdGVkMTYwNAYDVQQDEy1TZWN0aWdvIFB1YmxpYyBT
+ZXJ2ZXIgQXV0aGVudGljYXRpb24gUm9vdCBFNDYwdjAQBgcqhkjOPQIBBgUrgQQA
+IgNiAAR2+pmpbiDt+dd34wc7qNs9Xzjoq1WmVk/WSOrsfy2qw7LFeeyZYX8QeccC
+WvkEN/U0NSt3zn8gj1KjAIns1aeibVvjS5KToID1AZTc8GgHHs3u/iVStSBDHBv+
+6xnOQ6OjQjBAMB0GA1UdDgQWBBTRItpMWfFLXyY4qp3W7usNw/upYTAOBgNVHQ8B
+Af8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAKBggqhkjOPQQDAwNnADBkAjAn7qRa
+qCG76UeXlImldCBteU/IvZNeWBj7LRoAasm4PdCkT0RHlAFWovgzJQxC36oCMB3q
+4S6ILuH5px0CMk7yn2xVdOOurvulGu7t0vzCAxHrRVxgED1cf5kDW21USAGKcw==
+-----END CERTIFICATE-----
+
+# Issuer: CN=Sectigo Public Server Authentication Root R46 O=Sectigo Limited
+# Subject: CN=Sectigo Public Server Authentication Root R46 O=Sectigo Limited
+# Label: "Sectigo Public Server Authentication Root R46"
+# Serial: 156256931880233212765902055439220583700
+# MD5 Fingerprint: 32:10:09:52:00:d5:7e:6c:43:df:15:c0:b1:16:93:e5
+# SHA1 Fingerprint: ad:98:f9:f3:e4:7d:75:3b:65:d4:82:b3:a4:52:17:bb:6e:f5:e4:38
+# SHA256 Fingerprint: 7b:b6:47:a6:2a:ee:ac:88:bf:25:7a:a5:22:d0:1f:fe:a3:95:e0:ab:45:c7:3f:93:f6:56:54:ec:38:f2:5a:06
+-----BEGIN CERTIFICATE-----
+MIIFijCCA3KgAwIBAgIQdY39i658BwD6qSWn4cetFDANBgkqhkiG9w0BAQwFADBf
+MQswCQYDVQQGEwJHQjEYMBYGA1UEChMPU2VjdGlnbyBMaW1pdGVkMTYwNAYDVQQD
+Ey1TZWN0aWdvIFB1YmxpYyBTZXJ2ZXIgQXV0aGVudGljYXRpb24gUm9vdCBSNDYw
+HhcNMjEwMzIyMDAwMDAwWhcNNDYwMzIxMjM1OTU5WjBfMQswCQYDVQQGEwJHQjEY
+MBYGA1UEChMPU2VjdGlnbyBMaW1pdGVkMTYwNAYDVQQDEy1TZWN0aWdvIFB1Ymxp
+YyBTZXJ2ZXIgQXV0aGVudGljYXRpb24gUm9vdCBSNDYwggIiMA0GCSqGSIb3DQEB
+AQUAA4ICDwAwggIKAoICAQCTvtU2UnXYASOgHEdCSe5jtrch/cSV1UgrJnwUUxDa
+ef0rty2k1Cz66jLdScK5vQ9IPXtamFSvnl0xdE8H/FAh3aTPaE8bEmNtJZlMKpnz
+SDBh+oF8HqcIStw+KxwfGExxqjWMrfhu6DtK2eWUAtaJhBOqbchPM8xQljeSM9xf
+iOefVNlI8JhD1mb9nxc4Q8UBUQvX4yMPFF1bFOdLvt30yNoDN9HWOaEhUTCDsG3X
+ME6WW5HwcCSrv0WBZEMNvSE6Lzzpng3LILVCJ8zab5vuZDCQOc2TZYEhMbUjUDM3
+IuM47fgxMMxF/mL50V0yeUKH32rMVhlATc6qu/m1dkmU8Sf4kaWD5QazYw6A3OAS
+VYCmO2a0OYctyPDQ0RTp5A1NDvZdV3LFOxxHVp3i1fuBYYzMTYCQNFu31xR13NgE
+SJ/AwSiItOkcyqex8Va3e0lMWeUgFaiEAin6OJRpmkkGj80feRQXEgyDet4fsZfu
++Zd4KKTIRJLpfSYFplhym3kT2BFfrsU4YjRosoYwjviQYZ4ybPUHNs2iTG7sijbt
+8uaZFURww3y8nDnAtOFr94MlI1fZEoDlSfB1D++N6xybVCi0ITz8fAr/73trdf+L
+HaAZBav6+CuBQug4urv7qv094PPK306Xlynt8xhW6aWWrL3DkJiy4Pmi1KZHQ3xt
+zwIDAQABo0IwQDAdBgNVHQ4EFgQUVnNYZJX5khqwEioEYnmhQBWIIUkwDgYDVR0P
+AQH/BAQDAgGGMA8GA1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcNAQEMBQADggIBAC9c
+mTz8Bl6MlC5w6tIyMY208FHVvArzZJ8HXtXBc2hkeqK5Duj5XYUtqDdFqij0lgVQ
+YKlJfp/imTYpE0RHap1VIDzYm/EDMrraQKFz6oOht0SmDpkBm+S8f74TlH7Kph52
+gDY9hAaLMyZlbcp+nv4fjFg4exqDsQ+8FxG75gbMY/qB8oFM2gsQa6H61SilzwZA
+Fv97fRheORKkU55+MkIQpiGRqRxOF3yEvJ+M0ejf5lG5Nkc/kLnHvALcWxxPDkjB
+JYOcCj+esQMzEhonrPcibCTRAUH4WAP+JWgiH5paPHxsnnVI84HxZmduTILA7rpX
+DhjvLpr3Etiga+kFpaHpaPi8TD8SHkXoUsCjvxInebnMMTzD9joiFgOgyY9mpFui
+TdaBJQbpdqQACj7LzTWb4OE4y2BThihCQRxEV+ioratF4yUQvNs+ZUH7G6aXD+u5
+dHn5HrwdVw1Hr8Mvn4dGp+smWg9WY7ViYG4A++MnESLn/pmPNPW56MORcr3Ywx65
+LvKRRFHQV80MNNVIIb/bE/FmJUNS0nAiNs2fxBx1IK1jcmMGDw4nztJqDby1ORrp
+0XZ60Vzk50lJLVU3aPAaOpg+VBeHVOmmJ1CJeyAvP/+/oYtKR5j/K3tJPsMpRmAY
+QqszKbrAKbkTidOIijlBO8n9pu0f9GBj39ItVQGL
+-----END CERTIFICATE-----
+
+# Issuer: CN=SSL.com TLS RSA Root CA 2022 O=SSL Corporation
+# Subject: CN=SSL.com TLS RSA Root CA 2022 O=SSL Corporation
+# Label: "SSL.com TLS RSA Root CA 2022"
+# Serial: 148535279242832292258835760425842727825
+# MD5 Fingerprint: d8:4e:c6:59:30:d8:fe:a0:d6:7a:5a:2c:2c:69:78:da
+# SHA1 Fingerprint: ec:2c:83:40:72:af:26:95:10:ff:0e:f2:03:ee:31:70:f6:78:9d:ca
+# SHA256 Fingerprint: 8f:af:7d:2e:2c:b4:70:9b:b8:e0:b3:36:66:bf:75:a5:dd:45:b5:de:48:0f:8e:a8:d4:bf:e6:be:bc:17:f2:ed
+-----BEGIN CERTIFICATE-----
+MIIFiTCCA3GgAwIBAgIQb77arXO9CEDii02+1PdbkTANBgkqhkiG9w0BAQsFADBO
+MQswCQYDVQQGEwJVUzEYMBYGA1UECgwPU1NMIENvcnBvcmF0aW9uMSUwIwYDVQQD
+DBxTU0wuY29tIFRMUyBSU0EgUm9vdCBDQSAyMDIyMB4XDTIyMDgyNTE2MzQyMloX
+DTQ2MDgxOTE2MzQyMVowTjELMAkGA1UEBhMCVVMxGDAWBgNVBAoMD1NTTCBDb3Jw
+b3JhdGlvbjElMCMGA1UEAwwcU1NMLmNvbSBUTFMgUlNBIFJvb3QgQ0EgMjAyMjCC
+AiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBANCkCXJPQIgSYT41I57u9nTP
+L3tYPc48DRAokC+X94xI2KDYJbFMsBFMF3NQ0CJKY7uB0ylu1bUJPiYYf7ISf5OY
+t6/wNr/y7hienDtSxUcZXXTzZGbVXcdotL8bHAajvI9AI7YexoS9UcQbOcGV0ins
+S657Lb85/bRi3pZ7QcacoOAGcvvwB5cJOYF0r/c0WRFXCsJbwST0MXMwgsadugL3
+PnxEX4MN8/HdIGkWCVDi1FW24IBydm5MR7d1VVm0U3TZlMZBrViKMWYPHqIbKUBO
+L9975hYsLfy/7PO0+r4Y9ptJ1O4Fbtk085zx7AGL0SDGD6C1vBdOSHtRwvzpXGk3
+R2azaPgVKPC506QVzFpPulJwoxJF3ca6TvvC0PeoUidtbnm1jPx7jMEWTO6Af77w
+dr5BUxIzrlo4QqvXDz5BjXYHMtWrifZOZ9mxQnUjbvPNQrL8VfVThxc7wDNY8VLS
++YCk8OjwO4s4zKTGkH8PnP2L0aPP2oOnaclQNtVcBdIKQXTbYxE3waWglksejBYS
+d66UNHsef8JmAOSqg+qKkK3ONkRN0VHpvB/zagX9wHQfJRlAUW7qglFA35u5CCoG
+AtUjHBPW6dvbxrB6y3snm/vg1UYk7RBLY0ulBY+6uB0rpvqR4pJSvezrZ5dtmi2f
+gTIFZzL7SAg/2SW4BCUvAgMBAAGjYzBhMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0j
+BBgwFoAU+y437uOEeicuzRk1sTN8/9REQrkwHQYDVR0OBBYEFPsuN+7jhHonLs0Z
+NbEzfP/UREK5MA4GA1UdDwEB/wQEAwIBhjANBgkqhkiG9w0BAQsFAAOCAgEAjYlt
+hEUY8U+zoO9opMAdrDC8Z2awms22qyIZZtM7QbUQnRC6cm4pJCAcAZli05bg4vsM
+QtfhWsSWTVTNj8pDU/0quOr4ZcoBwq1gaAafORpR2eCNJvkLTqVTJXojpBzOCBvf
+R4iyrT7gJ4eLSYwfqUdYe5byiB0YrrPRpgqU+tvT5TgKa3kSM/tKWTcWQA673vWJ
+DPFs0/dRa1419dvAJuoSc06pkZCmF8NsLzjUo3KUQyxi4U5cMj29TH0ZR6LDSeeW
+P4+a0zvkEdiLA9z2tmBVGKaBUfPhqBVq6+AL8BQx1rmMRTqoENjwuSfr98t67wVy
+lrXEj5ZzxOhWc5y8aVFjvO9nHEMaX3cZHxj4HCUp+UmZKbaSPaKDN7EgkaibMOlq
+bLQjk2UEqxHzDh1TJElTHaE/nUiSEeJ9DU/1172iWD54nR4fK/4huxoTtrEoZP2w
+AgDHbICivRZQIA9ygV/MlP+7mea6kMvq+cYMwq7FGc4zoWtcu358NFcXrfA/rs3q
+r5nsLFR+jM4uElZI7xc7P0peYNLcdDa8pUNjyw9bowJWCZ4kLOGGgYz+qxcs+sji
+Mho6/4UIyYOf8kpIEFR3N+2ivEC+5BB09+Rbu7nzifmPQdjH5FCQNYA+HLhNkNPU
+98OwoX6EyneSMSy4kLGCenROmxMmtNVQZlR4rmA=
+-----END CERTIFICATE-----
+
+# Issuer: CN=SSL.com TLS ECC Root CA 2022 O=SSL Corporation
+# Subject: CN=SSL.com TLS ECC Root CA 2022 O=SSL Corporation
+# Label: "SSL.com TLS ECC Root CA 2022"
+# Serial: 26605119622390491762507526719404364228
+# MD5 Fingerprint: 99:d7:5c:f1:51:36:cc:e9:ce:d9:19:2e:77:71:56:c5
+# SHA1 Fingerprint: 9f:5f:d9:1a:54:6d:f5:0c:71:f0:ee:7a:bd:17:49:98:84:73:e2:39
+# SHA256 Fingerprint: c3:2f:fd:9f:46:f9:36:d1:6c:36:73:99:09:59:43:4b:9a:d6:0a:af:bb:9e:7c:f3:36:54:f1:44:cc:1b:a1:43
+-----BEGIN CERTIFICATE-----
+MIICOjCCAcCgAwIBAgIQFAP1q/s3ixdAW+JDsqXRxDAKBggqhkjOPQQDAzBOMQsw
+CQYDVQQGEwJVUzEYMBYGA1UECgwPU1NMIENvcnBvcmF0aW9uMSUwIwYDVQQDDBxT
+U0wuY29tIFRMUyBFQ0MgUm9vdCBDQSAyMDIyMB4XDTIyMDgyNTE2MzM0OFoXDTQ2
+MDgxOTE2MzM0N1owTjELMAkGA1UEBhMCVVMxGDAWBgNVBAoMD1NTTCBDb3Jwb3Jh
+dGlvbjElMCMGA1UEAwwcU1NMLmNvbSBUTFMgRUNDIFJvb3QgQ0EgMjAyMjB2MBAG
+ByqGSM49AgEGBSuBBAAiA2IABEUpNXP6wrgjzhR9qLFNoFs27iosU8NgCTWyJGYm
+acCzldZdkkAZDsalE3D07xJRKF3nzL35PIXBz5SQySvOkkJYWWf9lCcQZIxPBLFN
+SeR7T5v15wj4A4j3p8OSSxlUgaNjMGEwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSME
+GDAWgBSJjy+j6CugFFR781a4Jl9nOAuc0DAdBgNVHQ4EFgQUiY8vo+groBRUe/NW
+uCZfZzgLnNAwDgYDVR0PAQH/BAQDAgGGMAoGCCqGSM49BAMDA2gAMGUCMFXjIlbp
+15IkWE8elDIPDAI2wv2sdDJO4fscgIijzPvX6yv/N33w7deedWo1dlJF4AIxAMeN
+b0Igj762TVntd00pxCAgRWSGOlDGxK0tk/UYfXLtqc/ErFc2KAhl3zx5Zn6g6g==
+-----END CERTIFICATE-----
+
+# Issuer: CN=Atos TrustedRoot Root CA ECC TLS 2021 O=Atos
+# Subject: CN=Atos TrustedRoot Root CA ECC TLS 2021 O=Atos
+# Label: "Atos TrustedRoot Root CA ECC TLS 2021"
+# Serial: 81873346711060652204712539181482831616
+# MD5 Fingerprint: 16:9f:ad:f1:70:ad:79:d6:ed:29:b4:d1:c5:79:70:a8
+# SHA1 Fingerprint: 9e:bc:75:10:42:b3:02:f3:81:f4:f7:30:62:d4:8f:c3:a7:51:b2:dd
+# SHA256 Fingerprint: b2:fa:e5:3e:14:cc:d7:ab:92:12:06:47:01:ae:27:9c:1d:89:88:fa:cb:77:5f:a8:a0:08:91:4e:66:39:88:a8
+-----BEGIN CERTIFICATE-----
+MIICFTCCAZugAwIBAgIQPZg7pmY9kGP3fiZXOATvADAKBggqhkjOPQQDAzBMMS4w
+LAYDVQQDDCVBdG9zIFRydXN0ZWRSb290IFJvb3QgQ0EgRUNDIFRMUyAyMDIxMQ0w
+CwYDVQQKDARBdG9zMQswCQYDVQQGEwJERTAeFw0yMTA0MjIwOTI2MjNaFw00MTA0
+MTcwOTI2MjJaMEwxLjAsBgNVBAMMJUF0b3MgVHJ1c3RlZFJvb3QgUm9vdCBDQSBF
+Q0MgVExTIDIwMjExDTALBgNVBAoMBEF0b3MxCzAJBgNVBAYTAkRFMHYwEAYHKoZI
+zj0CAQYFK4EEACIDYgAEloZYKDcKZ9Cg3iQZGeHkBQcfl+3oZIK59sRxUM6KDP/X
+tXa7oWyTbIOiaG6l2b4siJVBzV3dscqDY4PMwL502eCdpO5KTlbgmClBk1IQ1SQ4
+AjJn8ZQSb+/Xxd4u/RmAo0IwQDAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBR2
+KCXWfeBmmnoJsmo7jjPXNtNPojAOBgNVHQ8BAf8EBAMCAYYwCgYIKoZIzj0EAwMD
+aAAwZQIwW5kp85wxtolrbNa9d+F851F+uDrNozZffPc8dz7kUK2o59JZDCaOMDtu
+CCrCp1rIAjEAmeMM56PDr9NJLkaCI2ZdyQAUEv049OGYa3cpetskz2VAv9LcjBHo
+9H1/IISpQuQo
+-----END CERTIFICATE-----
+
+# Issuer: CN=Atos TrustedRoot Root CA RSA TLS 2021 O=Atos
+# Subject: CN=Atos TrustedRoot Root CA RSA TLS 2021 O=Atos
+# Label: "Atos TrustedRoot Root CA RSA TLS 2021"
+# Serial: 111436099570196163832749341232207667876
+# MD5 Fingerprint: d4:d3:46:b8:9a:c0:9c:76:5d:9e:3a:c3:b9:99:31:d2
+# SHA1 Fingerprint: 18:52:3b:0d:06:37:e4:d6:3a:df:23:e4:98:fb:5b:16:fb:86:74:48
+# SHA256 Fingerprint: 81:a9:08:8e:a5:9f:b3:64:c5:48:a6:f8:55:59:09:9b:6f:04:05:ef:bf:18:e5:32:4e:c9:f4:57:ba:00:11:2f
+-----BEGIN CERTIFICATE-----
+MIIFZDCCA0ygAwIBAgIQU9XP5hmTC/srBRLYwiqipDANBgkqhkiG9w0BAQwFADBM
+MS4wLAYDVQQDDCVBdG9zIFRydXN0ZWRSb290IFJvb3QgQ0EgUlNBIFRMUyAyMDIx
+MQ0wCwYDVQQKDARBdG9zMQswCQYDVQQGEwJERTAeFw0yMTA0MjIwOTIxMTBaFw00
+MTA0MTcwOTIxMDlaMEwxLjAsBgNVBAMMJUF0b3MgVHJ1c3RlZFJvb3QgUm9vdCBD
+QSBSU0EgVExTIDIwMjExDTALBgNVBAoMBEF0b3MxCzAJBgNVBAYTAkRFMIICIjAN
+BgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAtoAOxHm9BYx9sKOdTSJNy/BBl01Z
+4NH+VoyX8te9j2y3I49f1cTYQcvyAh5x5en2XssIKl4w8i1mx4QbZFc4nXUtVsYv
+Ye+W/CBGvevUez8/fEc4BKkbqlLfEzfTFRVOvV98r61jx3ncCHvVoOX3W3WsgFWZ
+kmGbzSoXfduP9LVq6hdKZChmFSlsAvFr1bqjM9xaZ6cF4r9lthawEO3NUDPJcFDs
+GY6wx/J0W2tExn2WuZgIWWbeKQGb9Cpt0xU6kGpn8bRrZtkh68rZYnxGEFzedUln
+nkL5/nWpo63/dgpnQOPF943HhZpZnmKaau1Fh5hnstVKPNe0OwANwI8f4UDErmwh
+3El+fsqyjW22v5MvoVw+j8rtgI5Y4dtXz4U2OLJxpAmMkokIiEjxQGMYsluMWuPD
+0xeqqxmjLBvk1cbiZnrXghmmOxYsL3GHX0WelXOTwkKBIROW1527k2gV+p2kHYzy
+geBYBr3JtuP2iV2J+axEoctr+hbxx1A9JNr3w+SH1VbxT5Aw+kUJWdo0zuATHAR8
+ANSbhqRAvNncTFd+rrcztl524WWLZt+NyteYr842mIycg5kDcPOvdO3GDjbnvezB
+c6eUWsuSZIKmAMFwoW4sKeFYV+xafJlrJaSQOoD0IJ2azsct+bJLKZWD6TWNp0lI
+pw9MGZHQ9b8Q4HECAwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQU
+dEmZ0f+0emhFdcN+tNzMzjkz2ggwDgYDVR0PAQH/BAQDAgGGMA0GCSqGSIb3DQEB
+DAUAA4ICAQAjQ1MkYlxt/T7Cz1UAbMVWiLkO3TriJQ2VSpfKgInuKs1l+NsW4AmS
+4BjHeJi78+xCUvuppILXTdiK/ORO/auQxDh1MoSf/7OwKwIzNsAQkG8dnK/haZPs
+o0UvFJ/1TCplQ3IM98P4lYsU84UgYt1UU90s3BiVaU+DR3BAM1h3Egyi61IxHkzJ
+qM7F78PRreBrAwA0JrRUITWXAdxfG/F851X6LWh3e9NpzNMOa7pNdkTWwhWaJuyw
+xfW70Xp0wmzNxbVe9kzmWy2B27O3Opee7c9GslA9hGCZcbUztVdF5kJHdWoOsAgM
+rr3e97sPWD2PAzHoPYJQyi9eDF20l74gNAf0xBLh7tew2VktafcxBPTy+av5EzH4
+AXcOPUIjJsyacmdRIXrMPIWo6iFqO9taPKU0nprALN+AnCng33eU0aKAQv9qTFsR
+0PXNor6uzFFcw9VUewyu1rkGd4Di7wcaaMxZUa1+XGdrudviB0JbuAEFWDlN5LuY
+o7Ey7Nmj1m+UI/87tyll5gfp77YZ6ufCOB0yiJA8EytuzO+rdwY0d4RPcuSBhPm5
+dDTedk+SKlOxJTnbPP/lPqYO5Wue/9vsL3SD3460s6neFE3/MaNFcyT6lSnMEpcE
+oji2jbDwN/zIIX8/syQbPYtuzE2wFg2WHYMfRsCbvUOZ58SWLs5fyQ==
+-----END CERTIFICATE-----
diff --git a/lib/charset_normalizer/__init__.py b/lib/charset_normalizer/__init__.py
index ebb5da89..55991fc3 100644
--- a/lib/charset_normalizer/__init__.py
+++ b/lib/charset_normalizer/__init__.py
@@ -21,7 +21,7 @@ at <https://github.com/Ousret/charset_normalizer>.
 """
 import logging
 
-from .api import from_bytes, from_fp, from_path
+from .api import from_bytes, from_fp, from_path, is_binary
 from .legacy import detect
 from .models import CharsetMatch, CharsetMatches
 from .utils import set_logging_handler
@@ -31,6 +31,7 @@ __all__ = (
     "from_fp",
     "from_path",
     "from_bytes",
+    "is_binary",
     "detect",
     "CharsetMatch",
     "CharsetMatches",
diff --git a/lib/charset_normalizer/api.py b/lib/charset_normalizer/api.py
index 9dbf4201..0ba08e3a 100644
--- a/lib/charset_normalizer/api.py
+++ b/lib/charset_normalizer/api.py
@@ -1,6 +1,6 @@
 import logging
 from os import PathLike
-from typing import Any, BinaryIO, List, Optional, Set
+from typing import BinaryIO, List, Optional, Set, Union
 
 from .cd import (
     coherence_ratio,
@@ -31,7 +31,7 @@ explain_handler.setFormatter(
 
 
 def from_bytes(
-    sequences: bytes,
+    sequences: Union[bytes, bytearray],
     steps: int = 5,
     chunk_size: int = 512,
     threshold: float = 0.2,
@@ -40,6 +40,7 @@ def from_bytes(
     preemptive_behaviour: bool = True,
     explain: bool = False,
     language_threshold: float = 0.1,
+    enable_fallback: bool = True,
 ) -> CharsetMatches:
     """
     Given a raw bytes sequence, return the best possibles charset usable to render str objects.
@@ -361,7 +362,8 @@ def from_bytes(
             )
             # Preparing those fallbacks in case we got nothing.
             if (
-                encoding_iana in ["ascii", "utf_8", specified_encoding]
+                enable_fallback
+                and encoding_iana in ["ascii", "utf_8", specified_encoding]
                 and not lazy_str_hard_failure
             ):
                 fallback_entry = CharsetMatch(
@@ -507,6 +509,7 @@ def from_fp(
     preemptive_behaviour: bool = True,
     explain: bool = False,
     language_threshold: float = 0.1,
+    enable_fallback: bool = True,
 ) -> CharsetMatches:
     """
     Same thing than the function from_bytes but using a file pointer that is already ready.
@@ -522,11 +525,12 @@ def from_fp(
         preemptive_behaviour,
         explain,
         language_threshold,
+        enable_fallback,
     )
 
 
 def from_path(
-    path: "PathLike[Any]",
+    path: Union[str, bytes, PathLike],  # type: ignore[type-arg]
     steps: int = 5,
     chunk_size: int = 512,
     threshold: float = 0.20,
@@ -535,6 +539,7 @@ def from_path(
     preemptive_behaviour: bool = True,
     explain: bool = False,
     language_threshold: float = 0.1,
+    enable_fallback: bool = True,
 ) -> CharsetMatches:
     """
     Same thing than the function from_bytes but with one extra step. Opening and reading given file path in binary mode.
@@ -551,4 +556,71 @@ def from_path(
             preemptive_behaviour,
             explain,
             language_threshold,
+            enable_fallback,
         )
+
+
+def is_binary(
+    fp_or_path_or_payload: Union[PathLike, str, BinaryIO, bytes],  # type: ignore[type-arg]
+    steps: int = 5,
+    chunk_size: int = 512,
+    threshold: float = 0.20,
+    cp_isolation: Optional[List[str]] = None,
+    cp_exclusion: Optional[List[str]] = None,
+    preemptive_behaviour: bool = True,
+    explain: bool = False,
+    language_threshold: float = 0.1,
+    enable_fallback: bool = False,
+) -> bool:
+    """
+    Detect if the given input (file, bytes, or path) points to a binary file. aka. not a string.
+    Based on the same main heuristic algorithms and default kwargs at the sole exception that fallbacks match
+    are disabled to be stricter around ASCII-compatible but unlikely to be a string.
+    """
+    if isinstance(fp_or_path_or_payload, (str, PathLike)):
+        guesses = from_path(
+            fp_or_path_or_payload,
+            steps=steps,
+            chunk_size=chunk_size,
+            threshold=threshold,
+            cp_isolation=cp_isolation,
+            cp_exclusion=cp_exclusion,
+            preemptive_behaviour=preemptive_behaviour,
+            explain=explain,
+            language_threshold=language_threshold,
+            enable_fallback=enable_fallback,
+        )
+    elif isinstance(
+        fp_or_path_or_payload,
+        (
+            bytes,
+            bytearray,
+        ),
+    ):
+        guesses = from_bytes(
+            fp_or_path_or_payload,
+            steps=steps,
+            chunk_size=chunk_size,
+            threshold=threshold,
+            cp_isolation=cp_isolation,
+            cp_exclusion=cp_exclusion,
+            preemptive_behaviour=preemptive_behaviour,
+            explain=explain,
+            language_threshold=language_threshold,
+            enable_fallback=enable_fallback,
+        )
+    else:
+        guesses = from_fp(
+            fp_or_path_or_payload,
+            steps=steps,
+            chunk_size=chunk_size,
+            threshold=threshold,
+            cp_isolation=cp_isolation,
+            cp_exclusion=cp_exclusion,
+            preemptive_behaviour=preemptive_behaviour,
+            explain=explain,
+            language_threshold=language_threshold,
+            enable_fallback=enable_fallback,
+        )
+
+    return not guesses
diff --git a/lib/charset_normalizer/md.py b/lib/charset_normalizer/md.py
index 56e9321a..13aa062e 100644
--- a/lib/charset_normalizer/md.py
+++ b/lib/charset_normalizer/md.py
@@ -294,14 +294,25 @@ class SuperWeirdWordPlugin(MessDetectorPlugin):
             if buffer_length >= 4:
                 if self._buffer_accent_count / buffer_length > 0.34:
                     self._is_current_word_bad = True
-                # Word/Buffer ending with a upper case accentuated letter are so rare,
+                # Word/Buffer ending with an upper case accentuated letter are so rare,
                 # that we will consider them all as suspicious. Same weight as foreign_long suspicious.
                 if is_accentuated(self._buffer[-1]) and self._buffer[-1].isupper():
                     self._foreign_long_count += 1
                     self._is_current_word_bad = True
             if buffer_length >= 24 and self._foreign_long_watch:
-                self._foreign_long_count += 1
-                self._is_current_word_bad = True
+                camel_case_dst = [
+                    i
+                    for c, i in zip(self._buffer, range(0, buffer_length))
+                    if c.isupper()
+                ]
+                probable_camel_cased: bool = False
+
+                if camel_case_dst and (len(camel_case_dst) / buffer_length <= 0.3):
+                    probable_camel_cased = True
+
+                if not probable_camel_cased:
+                    self._foreign_long_count += 1
+                    self._is_current_word_bad = True
 
             if self._is_current_word_bad:
                 self._bad_word_count += 1
diff --git a/lib/charset_normalizer/utils.py b/lib/charset_normalizer/utils.py
index 76eafc64..bf2767a0 100644
--- a/lib/charset_normalizer/utils.py
+++ b/lib/charset_normalizer/utils.py
@@ -120,12 +120,12 @@ def is_emoticon(character: str) -> bool:
 
 @lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION)
 def is_separator(character: str) -> bool:
-    if character.isspace() or character in {"｜", "+", ",", ";", "<", ">"}:
+    if character.isspace() or character in {"｜", "+", "<", ">"}:
         return True
 
     character_category: str = unicodedata.category(character)
 
-    return "Z" in character_category
+    return "Z" in character_category or character_category in {"Po", "Pd", "Pc"}
 
 
 @lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION)
diff --git a/lib/charset_normalizer/version.py b/lib/charset_normalizer/version.py
index b74c2643..5eed49a4 100644
--- a/lib/charset_normalizer/version.py
+++ b/lib/charset_normalizer/version.py
@@ -2,5 +2,5 @@
 Expose version
 """
 
-__version__ = "3.1.0"
+__version__ = "3.2.0"
 VERSION = __version__.split(".")
diff --git a/lib/requests/__init__.py b/lib/requests/__init__.py
index 22db3c1d..300a16c5 100644
--- a/lib/requests/__init__.py
+++ b/lib/requests/__init__.py
@@ -66,10 +66,10 @@ def check_compatibility(urllib3_version, chardet_version, charset_normalizer_ver
     # Check urllib3 for compatibility.
     major, minor, patch = urllib3_version  # noqa: F811
     major, minor, patch = int(major), int(minor), int(patch)
-    # urllib3 >= 1.21.1, <= 1.26
-    assert major == 1
-    assert minor >= 21
-    assert minor <= 26
+    # urllib3 >= 1.21.1
+    assert major >= 1
+    if major == 1:
+        assert minor >= 21
 
     # Check charset_normalizer for compatibility.
     if chardet_version:
diff --git a/lib/requests/__version__.py b/lib/requests/__version__.py
index 69be3dec..5063c3f8 100644
--- a/lib/requests/__version__.py
+++ b/lib/requests/__version__.py
@@ -5,8 +5,8 @@
 __title__ = "requests"
 __description__ = "Python HTTP for Humans."
 __url__ = "https://requests.readthedocs.io"
-__version__ = "2.28.2"
-__build__ = 0x022802
+__version__ = "2.31.0"
+__build__ = 0x023100
 __author__ = "Kenneth Reitz"
 __author_email__ = "me@kennethreitz.org"
 __license__ = "Apache 2.0"
diff --git a/lib/requests/_internal_utils.py b/lib/requests/_internal_utils.py
index 7dc9bc53..f2cf635e 100644
--- a/lib/requests/_internal_utils.py
+++ b/lib/requests/_internal_utils.py
@@ -14,9 +14,11 @@ _VALID_HEADER_NAME_RE_STR = re.compile(r"^[^:\s][^:\r\n]*$")
 _VALID_HEADER_VALUE_RE_BYTE = re.compile(rb"^\S[^\r\n]*$|^$")
 _VALID_HEADER_VALUE_RE_STR = re.compile(r"^\S[^\r\n]*$|^$")
 
+_HEADER_VALIDATORS_STR = (_VALID_HEADER_NAME_RE_STR, _VALID_HEADER_VALUE_RE_STR)
+_HEADER_VALIDATORS_BYTE = (_VALID_HEADER_NAME_RE_BYTE, _VALID_HEADER_VALUE_RE_BYTE)
 HEADER_VALIDATORS = {
-    bytes: (_VALID_HEADER_NAME_RE_BYTE, _VALID_HEADER_VALUE_RE_BYTE),
-    str: (_VALID_HEADER_NAME_RE_STR, _VALID_HEADER_VALUE_RE_STR),
+    bytes: _HEADER_VALIDATORS_BYTE,
+    str: _HEADER_VALIDATORS_STR,
 }
 
 
diff --git a/lib/requests/adapters.py b/lib/requests/adapters.py
index d3b2d5bb..78e3bb6e 100644
--- a/lib/requests/adapters.py
+++ b/lib/requests/adapters.py
@@ -22,7 +22,6 @@ from urllib3.exceptions import ProxyError as _ProxyError
 from urllib3.exceptions import ReadTimeoutError, ResponseError
 from urllib3.exceptions import SSLError as _SSLError
 from urllib3.poolmanager import PoolManager, proxy_from_url
-from urllib3.response import HTTPResponse
 from urllib3.util import Timeout as TimeoutSauce
 from urllib3.util import parse_url
 from urllib3.util.retry import Retry
@@ -194,7 +193,6 @@ class HTTPAdapter(BaseAdapter):
             num_pools=connections,
             maxsize=maxsize,
             block=block,
-            strict=True,
             **pool_kwargs,
         )
 
@@ -485,63 +483,19 @@ class HTTPAdapter(BaseAdapter):
             timeout = TimeoutSauce(connect=timeout, read=timeout)
 
         try:
-            if not chunked:
-                resp = conn.urlopen(
-                    method=request.method,
-                    url=url,
-                    body=request.body,
-                    headers=request.headers,
-                    redirect=False,
-                    assert_same_host=False,
-                    preload_content=False,
-                    decode_content=False,
-                    retries=self.max_retries,
-                    timeout=timeout,
-                )
-
-            # Send the request.
-            else:
-                if hasattr(conn, "proxy_pool"):
-                    conn = conn.proxy_pool
-
-                low_conn = conn._get_conn(timeout=DEFAULT_POOL_TIMEOUT)
-
-                try:
-                    skip_host = "Host" in request.headers
-                    low_conn.putrequest(
-                        request.method,
-                        url,
-                        skip_accept_encoding=True,
-                        skip_host=skip_host,
-                    )
-
-                    for header, value in request.headers.items():
-                        low_conn.putheader(header, value)
-
-                    low_conn.endheaders()
-
-                    for i in request.body:
-                        low_conn.send(hex(len(i))[2:].encode("utf-8"))
-                        low_conn.send(b"\r\n")
-                        low_conn.send(i)
-                        low_conn.send(b"\r\n")
-                    low_conn.send(b"0\r\n\r\n")
-
-                    # Receive the response from the server
-                    r = low_conn.getresponse()
-
-                    resp = HTTPResponse.from_httplib(
-                        r,
-                        pool=conn,
-                        connection=low_conn,
-                        preload_content=False,
-                        decode_content=False,
-                    )
-                except Exception:
-                    # If we hit any problems here, clean up the connection.
-                    # Then, raise so that we can handle the actual exception.
-                    low_conn.close()
-                    raise
+            resp = conn.urlopen(
+                method=request.method,
+                url=url,
+                body=request.body,
+                headers=request.headers,
+                redirect=False,
+                assert_same_host=False,
+                preload_content=False,
+                decode_content=False,
+                retries=self.max_retries,
+                timeout=timeout,
+                chunked=chunked,
+            )
 
         except (ProtocolError, OSError) as err:
             raise ConnectionError(err, request=request)
diff --git a/lib/requests/api.py b/lib/requests/api.py
index 2f71aaed..cd0b3eea 100644
--- a/lib/requests/api.py
+++ b/lib/requests/api.py
@@ -106,7 +106,7 @@ def post(url, data=None, json=None, **kwargs):
     :param url: URL for the new :class:`Request` object.
     :param data: (optional) Dictionary, list of tuples, bytes, or file-like
         object to send in the body of the :class:`Request`.
-    :param json: (optional) json data to send in the body of the :class:`Request`.
+    :param json: (optional) A JSON serializable Python object to send in the body of the :class:`Request`.
     :param \*\*kwargs: Optional arguments that ``request`` takes.
     :return: :class:`Response <Response>` object
     :rtype: requests.Response
@@ -121,7 +121,7 @@ def put(url, data=None, **kwargs):
     :param url: URL for the new :class:`Request` object.
     :param data: (optional) Dictionary, list of tuples, bytes, or file-like
         object to send in the body of the :class:`Request`.
-    :param json: (optional) json data to send in the body of the :class:`Request`.
+    :param json: (optional) A JSON serializable Python object to send in the body of the :class:`Request`.
     :param \*\*kwargs: Optional arguments that ``request`` takes.
     :return: :class:`Response <Response>` object
     :rtype: requests.Response
@@ -136,7 +136,7 @@ def patch(url, data=None, **kwargs):
     :param url: URL for the new :class:`Request` object.
     :param data: (optional) Dictionary, list of tuples, bytes, or file-like
         object to send in the body of the :class:`Request`.
-    :param json: (optional) json data to send in the body of the :class:`Request`.
+    :param json: (optional) A JSON serializable Python object to send in the body of the :class:`Request`.
     :param \*\*kwargs: Optional arguments that ``request`` takes.
     :return: :class:`Response <Response>` object
     :rtype: requests.Response
diff --git a/lib/requests/sessions.py b/lib/requests/sessions.py
index 6cb3b4da..dbcf2a7b 100644
--- a/lib/requests/sessions.py
+++ b/lib/requests/sessions.py
@@ -324,7 +324,9 @@ class SessionRedirectMixin:
         except KeyError:
             username, password = None, None
 
-        if username and password:
+        # urllib3 handles proxy authorization for us in the standard adapter.
+        # Avoid appending this to TLS tunneled requests where it may be leaked.
+        if not scheme.startswith('https') and username and password:
             headers["Proxy-Authorization"] = _basic_auth_str(username, password)
 
         return new_proxies
diff --git a/lib/requests/utils.py b/lib/requests/utils.py
index ad535838..a367417f 100644
--- a/lib/requests/utils.py
+++ b/lib/requests/utils.py
@@ -25,7 +25,12 @@ from . import certs
 from .__version__ import __version__
 
 # to_native_string is unused here, but imported here for backwards compatibility
-from ._internal_utils import HEADER_VALIDATORS, to_native_string  # noqa: F401
+from ._internal_utils import (  # noqa: F401
+    _HEADER_VALIDATORS_BYTE,
+    _HEADER_VALIDATORS_STR,
+    HEADER_VALIDATORS,
+    to_native_string,
+)
 from .compat import (
     Mapping,
     basestring,
@@ -1031,20 +1036,23 @@ def check_header_validity(header):
     :param header: tuple, in the format (name, value).
     """
     name, value = header
-
-    for part in header:
-        if type(part) not in HEADER_VALIDATORS:
-            raise InvalidHeader(
-                f"Header part ({part!r}) from {{{name!r}: {value!r}}} must be "
-                f"of type str or bytes, not {type(part)}"
-            )
-
-    _validate_header_part(name, "name", HEADER_VALIDATORS[type(name)][0])
-    _validate_header_part(value, "value", HEADER_VALIDATORS[type(value)][1])
+    _validate_header_part(header, name, 0)
+    _validate_header_part(header, value, 1)
 
 
-def _validate_header_part(header_part, header_kind, validator):
+def _validate_header_part(header, header_part, header_validator_index):
+    if isinstance(header_part, str):
+        validator = _HEADER_VALIDATORS_STR[header_validator_index]
+    elif isinstance(header_part, bytes):
+        validator = _HEADER_VALIDATORS_BYTE[header_validator_index]
+    else:
+        raise InvalidHeader(
+            f"Header part ({header_part!r}) from {header} "
+            f"must be of type str or bytes, not {type(header_part)}"
+        )
+
     if not validator.match(header_part):
+        header_kind = "name" if header_validator_index == 0 else "value"
         raise InvalidHeader(
             f"Invalid leading whitespace, reserved character(s), or return"
             f"character(s) in header {header_kind}: {header_part!r}"
diff --git a/lib/urllib3/__init__.py b/lib/urllib3/__init__.py
index c6fa3821..32c1f002 100644
--- a/lib/urllib3/__init__.py
+++ b/lib/urllib3/__init__.py
@@ -1,23 +1,48 @@
 """
 Python HTTP library with thread-safe connection pooling, file post support, user friendly, and more
 """
-from __future__ import absolute_import
+
+from __future__ import annotations
 
 # Set default logging handler to avoid "No handler found" warnings.
 import logging
+import typing
 import warnings
 from logging import NullHandler
 
 from . import exceptions
+from ._base_connection import _TYPE_BODY
+from ._collections import HTTPHeaderDict
 from ._version import __version__
 from .connectionpool import HTTPConnectionPool, HTTPSConnectionPool, connection_from_url
-from .filepost import encode_multipart_formdata
+from .filepost import _TYPE_FIELDS, encode_multipart_formdata
 from .poolmanager import PoolManager, ProxyManager, proxy_from_url
-from .response import HTTPResponse
+from .response import BaseHTTPResponse, HTTPResponse
 from .util.request import make_headers
 from .util.retry import Retry
 from .util.timeout import Timeout
-from .util.url import get_host
+
+# Ensure that Python is compiled with OpenSSL 1.1.1+
+# If the 'ssl' module isn't available at all that's
+# fine, we only care if the module is available.
+try:
+    import ssl
+except ImportError:
+    pass
+else:
+    if not ssl.OPENSSL_VERSION.startswith("OpenSSL "):  # Defensive:
+        warnings.warn(
+            "urllib3 v2.0 only supports OpenSSL 1.1.1+, currently "
+            f"the 'ssl' module is compiled with {ssl.OPENSSL_VERSION!r}. "
+            "See: https://github.com/urllib3/urllib3/issues/3020",
+            exceptions.NotOpenSSLWarning,
+        )
+    elif ssl.OPENSSL_VERSION_INFO < (1, 1, 1):  # Defensive:
+        raise ImportError(
+            "urllib3 v2.0 only supports OpenSSL 1.1.1+, currently "
+            f"the 'ssl' module is compiled with {ssl.OPENSSL_VERSION!r}. "
+            "See: https://github.com/urllib3/urllib3/issues/2168"
+        )
 
 # === NOTE TO REPACKAGERS AND VENDORS ===
 # Please delete this block, this logic is only
@@ -25,12 +50,12 @@ from .util.url import get_host
 # See: https://github.com/urllib3/urllib3/issues/2680
 try:
     import urllib3_secure_extra  # type: ignore # noqa: F401
-except ImportError:
+except ModuleNotFoundError:
     pass
 else:
     warnings.warn(
         "'urllib3[secure]' extra is deprecated and will be removed "
-        "in a future release of urllib3 2.x. Read more in this issue: "
+        "in urllib3 v2.1.0. Read more in this issue: "
         "https://github.com/urllib3/urllib3/issues/2680",
         category=DeprecationWarning,
         stacklevel=2,
@@ -42,6 +67,7 @@ __version__ = __version__
 
 __all__ = (
     "HTTPConnectionPool",
+    "HTTPHeaderDict",
     "HTTPSConnectionPool",
     "PoolManager",
     "ProxyManager",
@@ -52,15 +78,18 @@ __all__ = (
     "connection_from_url",
     "disable_warnings",
     "encode_multipart_formdata",
-    "get_host",
     "make_headers",
     "proxy_from_url",
+    "request",
+    "BaseHTTPResponse",
 )
 
 logging.getLogger(__name__).addHandler(NullHandler())
 
 
-def add_stderr_logger(level=logging.DEBUG):
+def add_stderr_logger(
+    level: int = logging.DEBUG,
+) -> logging.StreamHandler[typing.TextIO]:
     """
     Helper for quickly adding a StreamHandler to the logger. Useful for
     debugging.
@@ -87,16 +116,51 @@ del NullHandler
 # mechanisms to silence them.
 # SecurityWarning's always go off by default.
 warnings.simplefilter("always", exceptions.SecurityWarning, append=True)
-# SubjectAltNameWarning's should go off once per host
-warnings.simplefilter("default", exceptions.SubjectAltNameWarning, append=True)
 # InsecurePlatformWarning's don't vary between requests, so we keep it default.
 warnings.simplefilter("default", exceptions.InsecurePlatformWarning, append=True)
-# SNIMissingWarnings should go off only once.
-warnings.simplefilter("default", exceptions.SNIMissingWarning, append=True)
 
 
-def disable_warnings(category=exceptions.HTTPWarning):
+def disable_warnings(category: type[Warning] = exceptions.HTTPWarning) -> None:
     """
     Helper for quickly disabling all urllib3 warnings.
     """
     warnings.simplefilter("ignore", category)
+
+
+_DEFAULT_POOL = PoolManager()
+
+
+def request(
+    method: str,
+    url: str,
+    *,
+    body: _TYPE_BODY | None = None,
+    fields: _TYPE_FIELDS | None = None,
+    headers: typing.Mapping[str, str] | None = None,
+    preload_content: bool | None = True,
+    decode_content: bool | None = True,
+    redirect: bool | None = True,
+    retries: Retry | bool | int | None = None,
+    timeout: Timeout | float | int | None = 3,
+    json: typing.Any | None = None,
+) -> BaseHTTPResponse:
+    """
+    A convenience, top-level request method. It uses a module-global ``PoolManager`` instance.
+    Therefore, its side effects could be shared across dependencies relying on it.
+    To avoid side effects create a new ``PoolManager`` instance and use it instead.
+    The method does not accept low-level ``**urlopen_kw`` keyword arguments.
+    """
+
+    return _DEFAULT_POOL.request(
+        method,
+        url,
+        body=body,
+        fields=fields,
+        headers=headers,
+        preload_content=preload_content,
+        decode_content=decode_content,
+        redirect=redirect,
+        retries=retries,
+        timeout=timeout,
+        json=json,
+    )
diff --git a/lib/urllib3/_base_connection.py b/lib/urllib3/_base_connection.py
new file mode 100644
index 00000000..3afed765
--- /dev/null
+++ b/lib/urllib3/_base_connection.py
@@ -0,0 +1,173 @@
+from __future__ import annotations
+
+import typing
+
+from .util.connection import _TYPE_SOCKET_OPTIONS
+from .util.timeout import _DEFAULT_TIMEOUT, _TYPE_TIMEOUT
+from .util.url import Url
+
+_TYPE_BODY = typing.Union[bytes, typing.IO[typing.Any], typing.Iterable[bytes], str]
+
+
+class ProxyConfig(typing.NamedTuple):
+    ssl_context: ssl.SSLContext | None
+    use_forwarding_for_https: bool
+    assert_hostname: None | str | Literal[False]
+    assert_fingerprint: str | None
+
+
+class _ResponseOptions(typing.NamedTuple):
+    # TODO: Remove this in favor of a better
+    # HTTP request/response lifecycle tracking.
+    request_method: str
+    request_url: str
+    preload_content: bool
+    decode_content: bool
+    enforce_content_length: bool
+
+
+if typing.TYPE_CHECKING:
+    import ssl
+
+    from typing_extensions import Literal, Protocol
+
+    from .response import BaseHTTPResponse
+
+    class BaseHTTPConnection(Protocol):
+        default_port: typing.ClassVar[int]
+        default_socket_options: typing.ClassVar[_TYPE_SOCKET_OPTIONS]
+
+        host: str
+        port: int
+        timeout: None | (
+            float
+        )  # Instance doesn't store _DEFAULT_TIMEOUT, must be resolved.
+        blocksize: int
+        source_address: tuple[str, int] | None
+        socket_options: _TYPE_SOCKET_OPTIONS | None
+
+        proxy: Url | None
+        proxy_config: ProxyConfig | None
+
+        is_verified: bool
+        proxy_is_verified: bool | None
+
+        def __init__(
+            self,
+            host: str,
+            port: int | None = None,
+            *,
+            timeout: _TYPE_TIMEOUT = _DEFAULT_TIMEOUT,
+            source_address: tuple[str, int] | None = None,
+            blocksize: int = 8192,
+            socket_options: _TYPE_SOCKET_OPTIONS | None = ...,
+            proxy: Url | None = None,
+            proxy_config: ProxyConfig | None = None,
+        ) -> None:
+            ...
+
+        def set_tunnel(
+            self,
+            host: str,
+            port: int | None = None,
+            headers: typing.Mapping[str, str] | None = None,
+            scheme: str = "http",
+        ) -> None:
+            ...
+
+        def connect(self) -> None:
+            ...
+
+        def request(
+            self,
+            method: str,
+            url: str,
+            body: _TYPE_BODY | None = None,
+            headers: typing.Mapping[str, str] | None = None,
+            # We know *at least* botocore is depending on the order of the
+            # first 3 parameters so to be safe we only mark the later ones
+            # as keyword-only to ensure we have space to extend.
+            *,
+            chunked: bool = False,
+            preload_content: bool = True,
+            decode_content: bool = True,
+            enforce_content_length: bool = True,
+        ) -> None:
+            ...
+
+        def getresponse(self) -> BaseHTTPResponse:
+            ...
+
+        def close(self) -> None:
+            ...
+
+        @property
+        def is_closed(self) -> bool:
+            """Whether the connection either is brand new or has been previously closed.
+            If this property is True then both ``is_connected`` and ``has_connected_to_proxy``
+            properties must be False.
+            """
+
+        @property
+        def is_connected(self) -> bool:
+            """Whether the connection is actively connected to any origin (proxy or target)"""
+
+        @property
+        def has_connected_to_proxy(self) -> bool:
+            """Whether the connection has successfully connected to its proxy.
+            This returns False if no proxy is in use. Used to determine whether
+            errors are coming from the proxy layer or from tunnelling to the target origin.
+            """
+
+    class BaseHTTPSConnection(BaseHTTPConnection, Protocol):
+        default_port: typing.ClassVar[int]
+        default_socket_options: typing.ClassVar[_TYPE_SOCKET_OPTIONS]
+
+        # Certificate verification methods
+        cert_reqs: int | str | None
+        assert_hostname: None | str | Literal[False]
+        assert_fingerprint: str | None
+        ssl_context: ssl.SSLContext | None
+
+        # Trusted CAs
+        ca_certs: str | None
+        ca_cert_dir: str | None
+        ca_cert_data: None | str | bytes
+
+        # TLS version
+        ssl_minimum_version: int | None
+        ssl_maximum_version: int | None
+        ssl_version: int | str | None  # Deprecated
+
+        # Client certificates
+        cert_file: str | None
+        key_file: str | None
+        key_password: str | None
+
+        def __init__(
+            self,
+            host: str,
+            port: int | None = None,
+            *,
+            timeout: _TYPE_TIMEOUT = _DEFAULT_TIMEOUT,
+            source_address: tuple[str, int] | None = None,
+            blocksize: int = 8192,
+            socket_options: _TYPE_SOCKET_OPTIONS | None = ...,
+            proxy: Url | None = None,
+            proxy_config: ProxyConfig | None = None,
+            cert_reqs: int | str | None = None,
+            assert_hostname: None | str | Literal[False] = None,
+            assert_fingerprint: str | None = None,
+            server_hostname: str | None = None,
+            ssl_context: ssl.SSLContext | None = None,
+            ca_certs: str | None = None,
+            ca_cert_dir: str | None = None,
+            ca_cert_data: None | str | bytes = None,
+            ssl_minimum_version: int | None = None,
+            ssl_maximum_version: int | None = None,
+            ssl_version: int | str | None = None,  # Deprecated
+            cert_file: str | None = None,
+            key_file: str | None = None,
+            key_password: str | None = None,
+        ) -> None:
+            ...
diff --git a/lib/urllib3/_collections.py b/lib/urllib3/_collections.py
index da9857e9..7f9dca7f 100644
--- a/lib/urllib3/_collections.py
+++ b/lib/urllib3/_collections.py
@@ -1,34 +1,66 @@
-from __future__ import absolute_import
-
-try:
-    from collections.abc import Mapping, MutableMapping
-except ImportError:
-    from collections import Mapping, MutableMapping
-try:
-    from threading import RLock
-except ImportError:  # Platform-specific: No threads available
-
-    class RLock:
-        def __enter__(self):
-            pass
-
-        def __exit__(self, exc_type, exc_value, traceback):
-            pass
-
+from __future__ import annotations
 
+import typing
 from collections import OrderedDict
+from enum import Enum, auto
+from threading import RLock
+
+if typing.TYPE_CHECKING:
+    # We can only import Protocol if TYPE_CHECKING because it's a development
+    # dependency, and is not available at runtime.
+    from typing_extensions import Protocol
+
+    class HasGettableStringKeys(Protocol):
+        def keys(self) -> typing.Iterator[str]:
+            ...
+
+        def __getitem__(self, key: str) -> str:
+            ...
 
-from .exceptions import InvalidHeader
-from .packages import six
-from .packages.six import iterkeys, itervalues
 
 __all__ = ["RecentlyUsedContainer", "HTTPHeaderDict"]
 
 
-_Null = object()
+# Key type
+_KT = typing.TypeVar("_KT")
+# Value type
+_VT = typing.TypeVar("_VT")
+# Default type
+_DT = typing.TypeVar("_DT")
+
+ValidHTTPHeaderSource = typing.Union[
+    "HTTPHeaderDict",
+    typing.Mapping[str, str],
+    typing.Iterable[typing.Tuple[str, str]],
+    "HasGettableStringKeys",
+]
 
 
-class RecentlyUsedContainer(MutableMapping):
+class _Sentinel(Enum):
+    not_passed = auto()
+
+
+def ensure_can_construct_http_header_dict(
+    potential: object,
+) -> ValidHTTPHeaderSource | None:
+    if isinstance(potential, HTTPHeaderDict):
+        return potential
+    elif isinstance(potential, typing.Mapping):
+        # Full runtime checking of the contents of a Mapping is expensive, so for the
+        # purposes of typechecking, we assume that any Mapping is the right shape.
+        return typing.cast(typing.Mapping[str, str], potential)
+    elif isinstance(potential, typing.Iterable):
+        # Similarly to Mapping, full runtime checking of the contents of an Iterable is
+        # expensive, so for the purposes of typechecking, we assume that any Iterable
+        # is the right shape.
+        return typing.cast(typing.Iterable[typing.Tuple[str, str]], potential)
+    elif hasattr(potential, "keys") and hasattr(potential, "__getitem__"):
+        return typing.cast("HasGettableStringKeys", potential)
+    else:
+        return None
+
+
+class RecentlyUsedContainer(typing.Generic[_KT, _VT], typing.MutableMapping[_KT, _VT]):
     """
     Provides a thread-safe dict-like container which maintains up to
     ``maxsize`` keys while throwing away the least-recently-used keys beyond
@@ -42,69 +74,134 @@ class RecentlyUsedContainer(MutableMapping):
         ``dispose_func(value)`` is called.  Callback which will get called
     """
 
-    ContainerCls = OrderedDict
+    _container: typing.OrderedDict[_KT, _VT]
+    _maxsize: int
+    dispose_func: typing.Callable[[_VT], None] | None
+    lock: RLock
 
-    def __init__(self, maxsize=10, dispose_func=None):
+    def __init__(
+        self,
+        maxsize: int = 10,
+        dispose_func: typing.Callable[[_VT], None] | None = None,
+    ) -> None:
+        super().__init__()
         self._maxsize = maxsize
         self.dispose_func = dispose_func
-
-        self._container = self.ContainerCls()
+        self._container = OrderedDict()
         self.lock = RLock()
 
-    def __getitem__(self, key):
+    def __getitem__(self, key: _KT) -> _VT:
         # Re-insert the item, moving it to the end of the eviction line.
         with self.lock:
             item = self._container.pop(key)
             self._container[key] = item
             return item
 
-    def __setitem__(self, key, value):
-        evicted_value = _Null
+    def __setitem__(self, key: _KT, value: _VT) -> None:
+        evicted_item = None
         with self.lock:
             # Possibly evict the existing value of 'key'
-            evicted_value = self._container.get(key, _Null)
-            self._container[key] = value
+            try:
+                # If the key exists, we'll overwrite it, which won't change the
+                # size of the pool. Because accessing a key should move it to
+                # the end of the eviction line, we pop it out first.
+                evicted_item = key, self._container.pop(key)
+                self._container[key] = value
+            except KeyError:
+                # When the key does not exist, we insert the value first so that
+                # evicting works in all cases, including when self._maxsize is 0
+                self._container[key] = value
+                if len(self._container) > self._maxsize:
+                    # If we didn't evict an existing value, and we've hit our maximum
+                    # size, then we have to evict the least recently used item from
+                    # the beginning of the container.
+                    evicted_item = self._container.popitem(last=False)
 
-            # If we didn't evict an existing value, we might have to evict the
-            # least recently used item from the beginning of the container.
-            if len(self._container) > self._maxsize:
-                _key, evicted_value = self._container.popitem(last=False)
-
-        if self.dispose_func and evicted_value is not _Null:
+        # After releasing the lock on the pool, dispose of any evicted value.
+        if evicted_item is not None and self.dispose_func:
+            _, evicted_value = evicted_item
             self.dispose_func(evicted_value)
 
-    def __delitem__(self, key):
+    def __delitem__(self, key: _KT) -> None:
         with self.lock:
             value = self._container.pop(key)
 
         if self.dispose_func:
             self.dispose_func(value)
 
-    def __len__(self):
+    def __len__(self) -> int:
         with self.lock:
             return len(self._container)
 
-    def __iter__(self):
+    def __iter__(self) -> typing.NoReturn:
         raise NotImplementedError(
             "Iteration over this class is unlikely to be threadsafe."
         )
 
-    def clear(self):
+    def clear(self) -> None:
         with self.lock:
             # Copy pointers to all values, then wipe the mapping
-            values = list(itervalues(self._container))
+            values = list(self._container.values())
             self._container.clear()
 
         if self.dispose_func:
             for value in values:
                 self.dispose_func(value)
 
-    def keys(self):
+    def keys(self) -> set[_KT]:  # type: ignore[override]
         with self.lock:
-            return list(iterkeys(self._container))
+            return set(self._container.keys())
 
 
-class HTTPHeaderDict(MutableMapping):
+class HTTPHeaderDictItemView(typing.Set[typing.Tuple[str, str]]):
+    """
+    HTTPHeaderDict is unusual for a Mapping[str, str] in that it has two modes of
+    address.
+
+    If we directly try to get an item with a particular name, we will get a string
+    back that is the concatenated version of all the values:
+
+    >>> d['X-Header-Name']
+    'Value1, Value2, Value3'
+
+    However, if we iterate over an HTTPHeaderDict's items, we will optionally combine
+    these values based on whether combine=True was called when building up the dictionary
+
+    >>> d = HTTPHeaderDict({"A": "1", "B": "foo"})
+    >>> d.add("A", "2", combine=True)
+    >>> d.add("B", "bar")
+    >>> list(d.items())
+    [
+        ('A', '1, 2'),
+        ('B', 'foo'),
+        ('B', 'bar'),
+    ]
+
+    This class conforms to the interface required by the MutableMapping ABC while
+    also giving us the nonstandard iteration behavior we want; items with duplicate
+    keys, ordered by time of first insertion.
+    """
+
+    _headers: HTTPHeaderDict
+
+    def __init__(self, headers: HTTPHeaderDict) -> None:
+        self._headers = headers
+
+    def __len__(self) -> int:
+        return len(list(self._headers.iteritems()))
+
+    def __iter__(self) -> typing.Iterator[tuple[str, str]]:
+        return self._headers.iteritems()
+
+    def __contains__(self, item: object) -> bool:
+        if isinstance(item, tuple) and len(item) == 2:
+            passed_key, passed_val = item
+            if isinstance(passed_key, str) and isinstance(passed_val, str):
+                return self._headers._has_value_for_header(passed_key, passed_val)
+        return False
+
+
+class HTTPHeaderDict(typing.MutableMapping[str, str]):
     """
     :param headers:
         An iterable of field-value pairs. Must not contain multiple field names
@@ -138,9 +235,11 @@ class HTTPHeaderDict(MutableMapping):
     '7'
     """
 
-    def __init__(self, headers=None, **kwargs):
-        super(HTTPHeaderDict, self).__init__()
-        self._container = OrderedDict()
+    _container: typing.MutableMapping[str, list[str]]
+
+    def __init__(self, headers: ValidHTTPHeaderSource | None = None, **kwargs: str):
+        super().__init__()
+        self._container = {}  # 'dict' is insert-ordered in Python 3.7+
         if headers is not None:
             if isinstance(headers, HTTPHeaderDict):
                 self._copy_from(headers)
@@ -149,123 +248,147 @@ class HTTPHeaderDict(MutableMapping):
         if kwargs:
             self.extend(kwargs)
 
-    def __setitem__(self, key, val):
+    def __setitem__(self, key: str, val: str) -> None:
+        # avoid a bytes/str comparison by decoding before httplib
+        if isinstance(key, bytes):
+            key = key.decode("latin-1")
         self._container[key.lower()] = [key, val]
-        return self._container[key.lower()]
 
-    def __getitem__(self, key):
+    def __getitem__(self, key: str) -> str:
         val = self._container[key.lower()]
         return ", ".join(val[1:])
 
-    def __delitem__(self, key):
+    def __delitem__(self, key: str) -> None:
         del self._container[key.lower()]
 
-    def __contains__(self, key):
-        return key.lower() in self._container
+    def __contains__(self, key: object) -> bool:
+        if isinstance(key, str):
+            return key.lower() in self._container
+        return False
 
-    def __eq__(self, other):
-        if not isinstance(other, Mapping) and not hasattr(other, "keys"):
+    def setdefault(self, key: str, default: str = "") -> str:
+        return super().setdefault(key, default)
+
+    def __eq__(self, other: object) -> bool:
+        maybe_constructable = ensure_can_construct_http_header_dict(other)
+        if maybe_constructable is None:
             return False
-        if not isinstance(other, type(self)):
-            other = type(self)(other)
-        return dict((k.lower(), v) for k, v in self.itermerged()) == dict(
-            (k.lower(), v) for k, v in other.itermerged()
-        )
+        else:
+            other_as_http_header_dict = type(self)(maybe_constructable)
 
-    def __ne__(self, other):
+        return {k.lower(): v for k, v in self.itermerged()} == {
+            k.lower(): v for k, v in other_as_http_header_dict.itermerged()
+        }
+
+    def __ne__(self, other: object) -> bool:
         return not self.__eq__(other)
 
-    if six.PY2:  # Python 2
-        iterkeys = MutableMapping.iterkeys
-        itervalues = MutableMapping.itervalues
-
-    __marker = object()
-
-    def __len__(self):
+    def __len__(self) -> int:
         return len(self._container)
 
-    def __iter__(self):
+    def __iter__(self) -> typing.Iterator[str]:
         # Only provide the originally cased names
         for vals in self._container.values():
             yield vals[0]
 
-    def pop(self, key, default=__marker):
-        """D.pop(k[,d]) -> v, remove specified key and return the corresponding value.
-        If key is not found, d is returned if given, otherwise KeyError is raised.
-        """
-        # Using the MutableMapping function directly fails due to the private marker.
-        # Using ordinary dict.pop would expose the internal structures.
-        # So let's reinvent the wheel.
-        try:
-            value = self[key]
-        except KeyError:
-            if default is self.__marker:
-                raise
-            return default
-        else:
-            del self[key]
-            return value
-
-    def discard(self, key):
+    def discard(self, key: str) -> None:
         try:
             del self[key]
         except KeyError:
             pass
 
-    def add(self, key, val):
+    def add(self, key: str, val: str, *, combine: bool = False) -> None:
         """Adds a (name, value) pair, doesn't overwrite the value if it already
         exists.
 
+        If this is called with combine=True, instead of adding a new header value
+        as a distinct item during iteration, this will instead append the value to
+        any existing header value with a comma. If no existing header value exists
+        for the key, then the value will simply be added, ignoring the combine parameter.
+
         >>> headers = HTTPHeaderDict(foo='bar')
         >>> headers.add('Foo', 'baz')
         >>> headers['foo']
         'bar, baz'
+        >>> list(headers.items())
+        [('foo', 'bar'), ('foo', 'baz')]
+        >>> headers.add('foo', 'quz', combine=True)
+        >>> list(headers.items())
+        [('foo', 'bar, baz, quz')]
         """
+        # avoid a bytes/str comparison by decoding before httplib
+        if isinstance(key, bytes):
+            key = key.decode("latin-1")
         key_lower = key.lower()
         new_vals = [key, val]
         # Keep the common case aka no item present as fast as possible
         vals = self._container.setdefault(key_lower, new_vals)
         if new_vals is not vals:
-            vals.append(val)
+            # if there are values here, then there is at least the initial
+            # key/value pair
+            assert len(vals) >= 2
+            if combine:
+                vals[-1] = vals[-1] + ", " + val
+            else:
+                vals.append(val)
 
-    def extend(self, *args, **kwargs):
+    def extend(self, *args: ValidHTTPHeaderSource, **kwargs: str) -> None:
         """Generic import function for any type of header-like object.
         Adapted version of MutableMapping.update in order to insert items
         with self.add instead of self.__setitem__
         """
         if len(args) > 1:
             raise TypeError(
-                "extend() takes at most 1 positional "
-                "arguments ({0} given)".format(len(args))
+                f"extend() takes at most 1 positional arguments ({len(args)} given)"
             )
         other = args[0] if len(args) >= 1 else ()
 
         if isinstance(other, HTTPHeaderDict):
             for key, val in other.iteritems():
                 self.add(key, val)
-        elif isinstance(other, Mapping):
-            for key in other:
-                self.add(key, other[key])
-        elif hasattr(other, "keys"):
-            for key in other.keys():
-                self.add(key, other[key])
-        else:
+        elif isinstance(other, typing.Mapping):
+            for key, val in other.items():
+                self.add(key, val)
+        elif isinstance(other, typing.Iterable):
+            other = typing.cast(typing.Iterable[typing.Tuple[str, str]], other)
             for key, value in other:
                 self.add(key, value)
+        elif hasattr(other, "keys") and hasattr(other, "__getitem__"):
+            # THIS IS NOT A TYPESAFE BRANCH
+            # In this branch, the object has a `keys` attr but is not a Mapping or any of
+            # the other types indicated in the method signature. We do some stuff with
+            # it as though it partially implements the Mapping interface, but we're not
+            # doing that stuff safely AT ALL.
+            for key in other.keys():
+                self.add(key, other[key])
 
         for key, value in kwargs.items():
             self.add(key, value)
 
-    def getlist(self, key, default=__marker):
+    @typing.overload
+    def getlist(self, key: str) -> list[str]:
+        ...
+
+    @typing.overload
+    def getlist(self, key: str, default: _DT) -> list[str] | _DT:
+        ...
+
+    def getlist(
+        self, key: str, default: _Sentinel | _DT = _Sentinel.not_passed
+    ) -> list[str] | _DT:
         """Returns a list of all the values for the named field. Returns an
         empty list if the key doesn't exist."""
         try:
             vals = self._container[key.lower()]
         except KeyError:
-            if default is self.__marker:
+            if default is _Sentinel.not_passed:
+                # _DT is unbound; empty list is instance of List[str]
                 return []
+            # _DT is bound; default is instance of _DT
             return default
         else:
+            # _DT may or may not be bound; vals[1:] is instance of List[str], which
+            # meets our external interface requirement of `Union[List[str], _DT]`.
             return vals[1:]
 
     # Backwards compatibility for httplib
@@ -276,62 +399,65 @@ class HTTPHeaderDict(MutableMapping):
     # Backwards compatibility for http.cookiejar
     get_all = getlist
 
-    def __repr__(self):
-        return "%s(%s)" % (type(self).__name__, dict(self.itermerged()))
+    def __repr__(self) -> str:
+        return f"{type(self).__name__}({dict(self.itermerged())})"
 
-    def _copy_from(self, other):
+    def _copy_from(self, other: HTTPHeaderDict) -> None:
         for key in other:
             val = other.getlist(key)
-            if isinstance(val, list):
-                # Don't need to convert tuples
-                val = list(val)
-            self._container[key.lower()] = [key] + val
+            self._container[key.lower()] = [key, *val]
 
-    def copy(self):
+    def copy(self) -> HTTPHeaderDict:
         clone = type(self)()
         clone._copy_from(self)
         return clone
 
-    def iteritems(self):
+    def iteritems(self) -> typing.Iterator[tuple[str, str]]:
         """Iterate over all header lines, including duplicate ones."""
         for key in self:
             vals = self._container[key.lower()]
             for val in vals[1:]:
                 yield vals[0], val
 
-    def itermerged(self):
+    def itermerged(self) -> typing.Iterator[tuple[str, str]]:
         """Iterate over all headers, merging duplicate ones together."""
         for key in self:
             val = self._container[key.lower()]
             yield val[0], ", ".join(val[1:])
 
-    def items(self):
-        return list(self.iteritems())
+    def items(self) -> HTTPHeaderDictItemView:  # type: ignore[override]
+        return HTTPHeaderDictItemView(self)
 
-    @classmethod
-    def from_httplib(cls, message):  # Python 2
-        """Read headers from a Python 2 httplib message object."""
-        # python2.7 does not expose a proper API for exporting multiheaders
-        # efficiently. This function re-reads raw lines from the message
-        # object and extracts the multiheaders properly.
-        obs_fold_continued_leaders = (" ", "\t")
-        headers = []
+    def _has_value_for_header(self, header_name: str, potential_value: str) -> bool:
+        if header_name in self:
+            return potential_value in self._container[header_name.lower()][1:]
+        return False
 
-        for line in message.headers:
-            if line.startswith(obs_fold_continued_leaders):
-                if not headers:
-                    # We received a header line that starts with OWS as described
-                    # in RFC-7230 S3.2.4. This indicates a multiline header, but
-                    # there exists no previous header to which we can attach it.
-                    raise InvalidHeader(
-                        "Header continuation with no previous header: %s" % line
-                    )
-                else:
-                    key, value = headers[-1]
-                    headers[-1] = (key, value + " " + line.strip())
-                    continue
+    def __ior__(self, other: object) -> HTTPHeaderDict:
+        # Supports extending a header dict in-place using operator |=
+        # combining items with add instead of __setitem__
+        maybe_constructable = ensure_can_construct_http_header_dict(other)
+        if maybe_constructable is None:
+            return NotImplemented
+        self.extend(maybe_constructable)
+        return self
 
-            key, value = line.split(":", 1)
-            headers.append((key, value.strip()))
+    def __or__(self, other: object) -> HTTPHeaderDict:
+        # Supports merging header dicts using operator |
+        # combining items with add instead of __setitem__
+        maybe_constructable = ensure_can_construct_http_header_dict(other)
+        if maybe_constructable is None:
+            return NotImplemented
+        result = self.copy()
+        result.extend(maybe_constructable)
+        return result
 
-        return cls(headers)
+    def __ror__(self, other: object) -> HTTPHeaderDict:
+        # Supports merging header dicts using operator | when other is on left side
+        # combining items with add instead of __setitem__
+        maybe_constructable = ensure_can_construct_http_header_dict(other)
+        if maybe_constructable is None:
+            return NotImplemented
+        result = type(self)(maybe_constructable)
+        result.extend(self)
+        return result
diff --git a/lib/urllib3/request.py b/lib/urllib3/_request_methods.py
similarity index 63%
rename from lib/urllib3/request.py
rename to lib/urllib3/_request_methods.py
index 398386a5..1d0f3465 100644
--- a/lib/urllib3/request.py
+++ b/lib/urllib3/_request_methods.py
@@ -1,12 +1,23 @@
-from __future__ import absolute_import
+from __future__ import annotations
 
-from .filepost import encode_multipart_formdata
-from .packages.six.moves.urllib.parse import urlencode
+import json as _json
+import typing
+from urllib.parse import urlencode
+
+from ._base_connection import _TYPE_BODY
+from ._collections import HTTPHeaderDict
+from .filepost import _TYPE_FIELDS, encode_multipart_formdata
+from .response import BaseHTTPResponse
 
 __all__ = ["RequestMethods"]
 
+_TYPE_ENCODE_URL_FIELDS = typing.Union[
+    typing.Sequence[typing.Tuple[str, typing.Union[str, bytes]]],
+    typing.Mapping[str, typing.Union[str, bytes]],
+]
 
-class RequestMethods(object):
+
+class RequestMethods:
     """
     Convenience mixin for classes who implement a :meth:`urlopen` method, such
     as :class:`urllib3.HTTPConnectionPool` and
@@ -37,25 +48,34 @@ class RequestMethods(object):
 
     _encode_url_methods = {"DELETE", "GET", "HEAD", "OPTIONS"}
 
-    def __init__(self, headers=None):
+    def __init__(self, headers: typing.Mapping[str, str] | None = None) -> None:
         self.headers = headers or {}
 
     def urlopen(
         self,
-        method,
-        url,
-        body=None,
-        headers=None,
-        encode_multipart=True,
-        multipart_boundary=None,
-        **kw
-    ):  # Abstract
+        method: str,
+        url: str,
+        body: _TYPE_BODY | None = None,
+        headers: typing.Mapping[str, str] | None = None,
+        encode_multipart: bool = True,
+        multipart_boundary: str | None = None,
+        **kw: typing.Any,
+    ) -> BaseHTTPResponse:  # Abstract
         raise NotImplementedError(
             "Classes extending RequestMethods must implement "
             "their own ``urlopen`` method."
         )
 
-    def request(self, method, url, fields=None, headers=None, **urlopen_kw):
+    def request(
+        self,
+        method: str,
+        url: str,
+        body: _TYPE_BODY | None = None,
+        fields: _TYPE_FIELDS | None = None,
+        headers: typing.Mapping[str, str] | None = None,
+        json: typing.Any | None = None,
+        **urlopen_kw: typing.Any,
+    ) -> BaseHTTPResponse:
         """
         Make a request using :meth:`urlopen` with the appropriate encoding of
         ``fields`` based on the ``method`` used.
@@ -68,18 +88,45 @@ class RequestMethods(object):
         """
         method = method.upper()
 
-        urlopen_kw["request_url"] = url
+        if json is not None and body is not None:
+            raise TypeError(
+                "request got values for both 'body' and 'json' parameters which are mutually exclusive"
+            )
+
+        if json is not None:
+            if headers is None:
+                headers = self.headers.copy()  # type: ignore
+            if not ("content-type" in map(str.lower, headers.keys())):
+                headers["Content-Type"] = "application/json"  # type: ignore
+
+            body = _json.dumps(json, separators=(",", ":"), ensure_ascii=False).encode(
+                "utf-8"
+            )
+
+        if body is not None:
+            urlopen_kw["body"] = body
 
         if method in self._encode_url_methods:
             return self.request_encode_url(
-                method, url, fields=fields, headers=headers, **urlopen_kw
+                method,
+                url,
+                fields=fields,  # type: ignore[arg-type]
+                headers=headers,
+                **urlopen_kw,
             )
         else:
             return self.request_encode_body(
                 method, url, fields=fields, headers=headers, **urlopen_kw
             )
 
-    def request_encode_url(self, method, url, fields=None, headers=None, **urlopen_kw):
+    def request_encode_url(
+        self,
+        method: str,
+        url: str,
+        fields: _TYPE_ENCODE_URL_FIELDS | None = None,
+        headers: typing.Mapping[str, str] | None = None,
+        **urlopen_kw: str,
+    ) -> BaseHTTPResponse:
         """
         Make a request using :meth:`urlopen` with the ``fields`` encoded in
         the url. This is useful for request methods like GET, HEAD, DELETE, etc.
@@ -87,7 +134,7 @@ class RequestMethods(object):
         if headers is None:
             headers = self.headers
 
-        extra_kw = {"headers": headers}
+        extra_kw: dict[str, typing.Any] = {"headers": headers}
         extra_kw.update(urlopen_kw)
 
         if fields:
@@ -97,14 +144,14 @@ class RequestMethods(object):
 
     def request_encode_body(
         self,
-        method,
-        url,
-        fields=None,
-        headers=None,
-        encode_multipart=True,
-        multipart_boundary=None,
-        **urlopen_kw
-    ):
+        method: str,
+        url: str,
+        fields: _TYPE_FIELDS | None = None,
+        headers: typing.Mapping[str, str] | None = None,
+        encode_multipart: bool = True,
+        multipart_boundary: str | None = None,
+        **urlopen_kw: str,
+    ) -> BaseHTTPResponse:
         """
         Make a request using :meth:`urlopen` with the ``fields`` encoded in
         the body. This is useful for request methods like POST, PUT, PATCH, etc.
@@ -143,7 +190,8 @@ class RequestMethods(object):
         if headers is None:
             headers = self.headers
 
-        extra_kw = {"headers": {}}
+        extra_kw: dict[str, typing.Any] = {"headers": HTTPHeaderDict(headers)}
+        body: bytes | str
 
         if fields:
             if "body" in urlopen_kw:
@@ -157,14 +205,13 @@ class RequestMethods(object):
                 )
             else:
                 body, content_type = (
-                    urlencode(fields),
+                    urlencode(fields),  # type: ignore[arg-type]
                     "application/x-www-form-urlencoded",
                 )
 
             extra_kw["body"] = body
-            extra_kw["headers"] = {"Content-Type": content_type}
+            extra_kw["headers"].setdefault("Content-Type", content_type)
 
-        extra_kw["headers"].update(headers)
         extra_kw.update(urlopen_kw)
 
         return self.urlopen(method, url, **extra_kw)
diff --git a/lib/urllib3/_version.py b/lib/urllib3/_version.py
index e12dd0e7..782af433 100644
--- a/lib/urllib3/_version.py
+++ b/lib/urllib3/_version.py
@@ -1,2 +1,4 @@
 # This file is protected via CODEOWNERS
-__version__ = "1.26.15"
+from __future__ import annotations
+
+__version__ = "2.0.4"
diff --git a/lib/urllib3/connection.py b/lib/urllib3/connection.py
index 54b96b19..10109fa9 100644
--- a/lib/urllib3/connection.py
+++ b/lib/urllib3/connection.py
@@ -1,59 +1,58 @@
-from __future__ import absolute_import
+from __future__ import annotations
 
 import datetime
 import logging
 import os
 import re
 import socket
+import sys
+import typing
 import warnings
-from socket import error as SocketError
+from http.client import HTTPConnection as _HTTPConnection
+from http.client import HTTPException as HTTPException  # noqa: F401
+from http.client import ResponseNotReady
 from socket import timeout as SocketTimeout
 
-from .packages import six
-from .packages.six.moves.http_client import HTTPConnection as _HTTPConnection
-from .packages.six.moves.http_client import HTTPException  # noqa: F401
-from .util.proxy import create_proxy_ssl_context
+if typing.TYPE_CHECKING:
+    from typing_extensions import Literal
+
+    from .response import HTTPResponse
+    from .util.ssl_ import _TYPE_PEER_CERT_RET_DICT
+    from .util.ssltransport import SSLTransport
+
+from ._collections import HTTPHeaderDict
+from .util.response import assert_header_parsing
+from .util.timeout import _DEFAULT_TIMEOUT, _TYPE_TIMEOUT, Timeout
+from .util.util import to_str
+from .util.wait import wait_for_read
 
 try:  # Compiled with SSL?
     import ssl
 
     BaseSSLError = ssl.SSLError
-except (ImportError, AttributeError):  # Platform-specific: No SSL.
-    ssl = None
+except (ImportError, AttributeError):
+    ssl = None  # type: ignore[assignment]
 
-    class BaseSSLError(BaseException):
+    class BaseSSLError(BaseException):  # type: ignore[no-redef]
         pass
 
 
-try:
-    # Python 3: not a no-op, we're adding this to the namespace so it can be imported.
-    ConnectionError = ConnectionError
-except NameError:
-    # Python 2
-    class ConnectionError(Exception):
-        pass
-
-
-try:  # Python 3:
-    # Not a no-op, we're adding this to the namespace so it can be imported.
-    BrokenPipeError = BrokenPipeError
-except NameError:  # Python 2:
-
-    class BrokenPipeError(Exception):
-        pass
-
-
-from ._collections import HTTPHeaderDict  # noqa (historical, removed in v2)
+from ._base_connection import _TYPE_BODY
+from ._base_connection import ProxyConfig as ProxyConfig
+from ._base_connection import _ResponseOptions as _ResponseOptions
 from ._version import __version__
 from .exceptions import (
     ConnectTimeoutError,
+    HeaderParsingError,
+    NameResolutionError,
     NewConnectionError,
-    SubjectAltNameWarning,
+    ProxyError,
     SystemTimeWarning,
 )
-from .util import SKIP_HEADER, SKIPPABLE_HEADERS, connection
+from .util import SKIP_HEADER, SKIPPABLE_HEADERS, connection, ssl_
+from .util.request import body_to_chunks
+from .util.ssl_ import assert_fingerprint as _assert_fingerprint
 from .util.ssl_ import (
-    assert_fingerprint,
     create_urllib3_context,
     is_ipaddress,
     resolve_cert_reqs,
@@ -61,6 +60,12 @@ from .util.ssl_ import (
     ssl_wrap_socket,
 )
 from .util.ssl_match_hostname import CertificateError, match_hostname
+from .util.url import Url
+
+# Not a no-op, we're adding this to the namespace so it can be imported.
+ConnectionError = ConnectionError
+BrokenPipeError = BrokenPipeError
+
 
 log = logging.getLogger(__name__)
 
@@ -72,8 +77,10 @@ RECENT_DATE = datetime.date(2022, 1, 1)
 
 _CONTAINS_CONTROL_CHAR_RE = re.compile(r"[^-!#$%&'*+.^_`|~0-9a-zA-Z]")
 
+_HAS_SYS_AUDIT = hasattr(sys, "audit")
 
-class HTTPConnection(_HTTPConnection, object):
+
+class HTTPConnection(_HTTPConnection):
     """
     Based on :class:`http.client.HTTPConnection` but provides an extra constructor
     backwards-compatibility layer between older and newer Pythons.
@@ -81,7 +88,6 @@ class HTTPConnection(_HTTPConnection, object):
     Additional keyword parameters are used to configure attributes of the connection.
     Accepted parameters include:
 
-    - ``strict``: See the documentation on :class:`urllib3.connectionpool.HTTPConnectionPool`
     - ``source_address``: Set the source address for the current connection.
     - ``socket_options``: Set specific options on the underlying socket. If not specified, then
       defaults are loaded from ``HTTPConnection.default_socket_options`` which includes disabling
@@ -99,38 +105,68 @@ class HTTPConnection(_HTTPConnection, object):
       Or you may want to disable the defaults by passing an empty list (e.g., ``[]``).
     """
 
-    default_port = port_by_scheme["http"]
+    default_port: typing.ClassVar[int] = port_by_scheme["http"]  # type: ignore[misc]
 
     #: Disable Nagle's algorithm by default.
     #: ``[(socket.IPPROTO_TCP, socket.TCP_NODELAY, 1)]``
-    default_socket_options = [(socket.IPPROTO_TCP, socket.TCP_NODELAY, 1)]
+    default_socket_options: typing.ClassVar[connection._TYPE_SOCKET_OPTIONS] = [
+        (socket.IPPROTO_TCP, socket.TCP_NODELAY, 1)
+    ]
 
     #: Whether this connection verifies the host's certificate.
-    is_verified = False
+    is_verified: bool = False
 
-    #: Whether this proxy connection (if used) verifies the proxy host's
-    #: certificate.
-    proxy_is_verified = None
+    #: Whether this proxy connection verified the proxy host's certificate.
+    # If no proxy is currently connected to the value will be ``None``.
+    proxy_is_verified: bool | None = None
 
-    def __init__(self, *args, **kw):
-        if not six.PY2:
-            kw.pop("strict", None)
+    blocksize: int
+    source_address: tuple[str, int] | None
+    socket_options: connection._TYPE_SOCKET_OPTIONS | None
 
-        # Pre-set source_address.
-        self.source_address = kw.get("source_address")
+    _has_connected_to_proxy: bool
+    _response_options: _ResponseOptions | None
+    _tunnel_host: str | None
+    _tunnel_port: int | None
+    _tunnel_scheme: str | None
 
-        #: The socket options provided by the user. If no options are
-        #: provided, we use the default options.
-        self.socket_options = kw.pop("socket_options", self.default_socket_options)
+    def __init__(
+        self,
+        host: str,
+        port: int | None = None,
+        *,
+        timeout: _TYPE_TIMEOUT = _DEFAULT_TIMEOUT,
+        source_address: tuple[str, int] | None = None,
+        blocksize: int = 8192,
+        socket_options: None
+        | (connection._TYPE_SOCKET_OPTIONS) = default_socket_options,
+        proxy: Url | None = None,
+        proxy_config: ProxyConfig | None = None,
+    ) -> None:
+        super().__init__(
+            host=host,
+            port=port,
+            timeout=Timeout.resolve_default_timeout(timeout),
+            source_address=source_address,
+            blocksize=blocksize,
+        )
+        self.socket_options = socket_options
+        self.proxy = proxy
+        self.proxy_config = proxy_config
 
-        # Proxy options provided by the user.
-        self.proxy = kw.pop("proxy", None)
-        self.proxy_config = kw.pop("proxy_config", None)
-
-        _HTTPConnection.__init__(self, *args, **kw)
+        self._has_connected_to_proxy = False
+        self._response_options = None
+        self._tunnel_host: str | None = None
+        self._tunnel_port: int | None = None
+        self._tunnel_scheme: str | None = None
 
+    # https://github.com/python/mypy/issues/4125
+    # Mypy treats this as LSP violation, which is considered a bug.
+    # If `host` is made a property it violates LSP, because a writeable attribute is overridden with a read-only one.
+    # However, there is also a `host` setter so LSP is not violated.
+    # Potentially, a `@host.deleter` might be needed depending on how this issue will be fixed.
     @property
-    def host(self):
+    def host(self) -> str:
         """
         Getter method to remove any trailing dots that indicate the hostname is an FQDN.
 
@@ -149,7 +185,7 @@ class HTTPConnection(_HTTPConnection, object):
         return self._dns_host.rstrip(".")
 
     @host.setter
-    def host(self, value):
+    def host(self, value: str) -> None:
         """
         Setter for the `host` property.
 
@@ -158,129 +194,298 @@ class HTTPConnection(_HTTPConnection, object):
         """
         self._dns_host = value
 
-    def _new_conn(self):
+    def _new_conn(self) -> socket.socket:
         """Establish a socket connection and set nodelay settings on it.
 
         :return: New socket connection.
         """
-        extra_kw = {}
-        if self.source_address:
-            extra_kw["source_address"] = self.source_address
-
-        if self.socket_options:
-            extra_kw["socket_options"] = self.socket_options
-
         try:
-            conn = connection.create_connection(
-                (self._dns_host, self.port), self.timeout, **extra_kw
+            sock = connection.create_connection(
+                (self._dns_host, self.port),
+                self.timeout,
+                source_address=self.source_address,
+                socket_options=self.socket_options,
             )
-
-        except SocketTimeout:
+        except socket.gaierror as e:
+            raise NameResolutionError(self.host, self, e) from e
+        except SocketTimeout as e:
             raise ConnectTimeoutError(
                 self,
-                "Connection to %s timed out. (connect timeout=%s)"
-                % (self.host, self.timeout),
-            )
+                f"Connection to {self.host} timed out. (connect timeout={self.timeout})",
+            ) from e
 
-        except SocketError as e:
+        except OSError as e:
             raise NewConnectionError(
-                self, "Failed to establish a new connection: %s" % e
+                self, f"Failed to establish a new connection: {e}"
+            ) from e
+
+        # Audit hooks are only available in Python 3.8+
+        if _HAS_SYS_AUDIT:
+            sys.audit("http.client.connect", self, self.host, self.port)
+
+        return sock
+
+    def set_tunnel(
+        self,
+        host: str,
+        port: int | None = None,
+        headers: typing.Mapping[str, str] | None = None,
+        scheme: str = "http",
+    ) -> None:
+        if scheme not in ("http", "https"):
+            raise ValueError(
+                f"Invalid proxy scheme for tunneling: {scheme!r}, must be either 'http' or 'https'"
             )
+        super().set_tunnel(host, port=port, headers=headers)
+        self._tunnel_scheme = scheme
 
-        return conn
+    def connect(self) -> None:
+        self.sock = self._new_conn()
+        if self._tunnel_host:
+            # If we're tunneling it means we're connected to our proxy.
+            self._has_connected_to_proxy = True
 
-    def _is_using_tunnel(self):
-        # Google App Engine's httplib does not define _tunnel_host
-        return getattr(self, "_tunnel_host", None)
-
-    def _prepare_conn(self, conn):
-        self.sock = conn
-        if self._is_using_tunnel():
             # TODO: Fix tunnel so it doesn't depend on self.sock state.
-            self._tunnel()
-            # Mark this connection as not reusable
-            self.auto_open = 0
+            self._tunnel()  # type: ignore[attr-defined]
 
-    def connect(self):
-        conn = self._new_conn()
-        self._prepare_conn(conn)
+        # If there's a proxy to be connected to we are fully connected.
+        # This is set twice (once above and here) due to forwarding proxies
+        # not using tunnelling.
+        self._has_connected_to_proxy = bool(self.proxy)
 
-    def putrequest(self, method, url, *args, **kwargs):
-        """ """
+    @property
+    def is_closed(self) -> bool:
+        return self.sock is None
+
+    @property
+    def is_connected(self) -> bool:
+        if self.sock is None:
+            return False
+        return not wait_for_read(self.sock, timeout=0.0)
+
+    @property
+    def has_connected_to_proxy(self) -> bool:
+        return self._has_connected_to_proxy
+
+    def close(self) -> None:
+        try:
+            super().close()
+        finally:
+            # Reset all stateful properties so connection
+            # can be re-used without leaking prior configs.
+            self.sock = None
+            self.is_verified = False
+            self.proxy_is_verified = None
+            self._has_connected_to_proxy = False
+            self._response_options = None
+            self._tunnel_host = None
+            self._tunnel_port = None
+            self._tunnel_scheme = None
+
+    def putrequest(
+        self,
+        method: str,
+        url: str,
+        skip_host: bool = False,
+        skip_accept_encoding: bool = False,
+    ) -> None:
+        """"""
         # Empty docstring because the indentation of CPython's implementation
         # is broken but we don't want this method in our documentation.
         match = _CONTAINS_CONTROL_CHAR_RE.search(method)
         if match:
             raise ValueError(
-                "Method cannot contain non-token characters %r (found at least %r)"
-                % (method, match.group())
+                f"Method cannot contain non-token characters {method!r} (found at least {match.group()!r})"
             )
 
-        return _HTTPConnection.putrequest(self, method, url, *args, **kwargs)
+        return super().putrequest(
+            method, url, skip_host=skip_host, skip_accept_encoding=skip_accept_encoding
+        )
 
-    def putheader(self, header, *values):
-        """ """
+    def putheader(self, header: str, *values: str) -> None:
+        """"""
         if not any(isinstance(v, str) and v == SKIP_HEADER for v in values):
-            _HTTPConnection.putheader(self, header, *values)
-        elif six.ensure_str(header.lower()) not in SKIPPABLE_HEADERS:
+            super().putheader(header, *values)
+        elif to_str(header.lower()) not in SKIPPABLE_HEADERS:
+            skippable_headers = "', '".join(
+                [str.title(header) for header in sorted(SKIPPABLE_HEADERS)]
+            )
             raise ValueError(
-                "urllib3.util.SKIP_HEADER only supports '%s'"
-                % ("', '".join(map(str.title, sorted(SKIPPABLE_HEADERS))),)
+                f"urllib3.util.SKIP_HEADER only supports '{skippable_headers}'"
             )
 
-    def request(self, method, url, body=None, headers=None):
+    # `request` method's signature intentionally violates LSP.
+    # urllib3's API is different from `http.client.HTTPConnection` and the subclassing is only incidental.
+    def request(  # type: ignore[override]
+        self,
+        method: str,
+        url: str,
+        body: _TYPE_BODY | None = None,
+        headers: typing.Mapping[str, str] | None = None,
+        *,
+        chunked: bool = False,
+        preload_content: bool = True,
+        decode_content: bool = True,
+        enforce_content_length: bool = True,
+    ) -> None:
         # Update the inner socket's timeout value to send the request.
         # This only triggers if the connection is re-used.
-        if getattr(self, "sock", None) is not None:
+        if self.sock is not None:
             self.sock.settimeout(self.timeout)
 
+        # Store these values to be fed into the HTTPResponse
+        # object later. TODO: Remove this in favor of a real
+        # HTTP lifecycle mechanism.
+
+        # We have to store these before we call .request()
+        # because sometimes we can still salvage a response
+        # off the wire even if we aren't able to completely
+        # send the request body.
+        self._response_options = _ResponseOptions(
+            request_method=method,
+            request_url=url,
+            preload_content=preload_content,
+            decode_content=decode_content,
+            enforce_content_length=enforce_content_length,
+        )
+
         if headers is None:
             headers = {}
-        else:
-            # Avoid modifying the headers passed into .request()
-            headers = headers.copy()
-        if "user-agent" not in (six.ensure_str(k.lower()) for k in headers):
-            headers["User-Agent"] = _get_default_user_agent()
-        super(HTTPConnection, self).request(method, url, body=body, headers=headers)
-
-    def request_chunked(self, method, url, body=None, headers=None):
-        """
-        Alternative to the common request method, which sends the
-        body with chunked encoding and not as one block
-        """
-        headers = headers or {}
-        header_keys = set([six.ensure_str(k.lower()) for k in headers])
+        header_keys = frozenset(to_str(k.lower()) for k in headers)
         skip_accept_encoding = "accept-encoding" in header_keys
         skip_host = "host" in header_keys
         self.putrequest(
             method, url, skip_accept_encoding=skip_accept_encoding, skip_host=skip_host
         )
+
+        # Transform the body into an iterable of sendall()-able chunks
+        # and detect if an explicit Content-Length is doable.
+        chunks_and_cl = body_to_chunks(body, method=method, blocksize=self.blocksize)
+        chunks = chunks_and_cl.chunks
+        content_length = chunks_and_cl.content_length
+
+        # When chunked is explicit set to 'True' we respect that.
+        if chunked:
+            if "transfer-encoding" not in header_keys:
+                self.putheader("Transfer-Encoding", "chunked")
+        else:
+            # Detect whether a framing mechanism is already in use. If so
+            # we respect that value, otherwise we pick chunked vs content-length
+            # depending on the type of 'body'.
+            if "content-length" in header_keys:
+                chunked = False
+            elif "transfer-encoding" in header_keys:
+                chunked = True
+
+            # Otherwise we go off the recommendation of 'body_to_chunks()'.
+            else:
+                chunked = False
+                if content_length is None:
+                    if chunks is not None:
+                        chunked = True
+                        self.putheader("Transfer-Encoding", "chunked")
+                else:
+                    self.putheader("Content-Length", str(content_length))
+
+        # Now that framing headers are out of the way we send all the other headers.
         if "user-agent" not in header_keys:
             self.putheader("User-Agent", _get_default_user_agent())
         for header, value in headers.items():
             self.putheader(header, value)
-        if "transfer-encoding" not in header_keys:
-            self.putheader("Transfer-Encoding", "chunked")
         self.endheaders()
 
-        if body is not None:
-            stringish_types = six.string_types + (bytes,)
-            if isinstance(body, stringish_types):
-                body = (body,)
-            for chunk in body:
+        # If we're given a body we start sending that in chunks.
+        if chunks is not None:
+            for chunk in chunks:
+                # Sending empty chunks isn't allowed for TE: chunked
+                # as it indicates the end of the body.
                 if not chunk:
                     continue
-                if not isinstance(chunk, bytes):
-                    chunk = chunk.encode("utf8")
-                len_str = hex(len(chunk))[2:]
-                to_send = bytearray(len_str.encode())
-                to_send += b"\r\n"
-                to_send += chunk
-                to_send += b"\r\n"
-                self.send(to_send)
+                if isinstance(chunk, str):
+                    chunk = chunk.encode("utf-8")
+                if chunked:
+                    self.send(b"%x\r\n%b\r\n" % (len(chunk), chunk))
+                else:
+                    self.send(chunk)
 
-        # After the if clause, to always have a closed body
-        self.send(b"0\r\n\r\n")
+        # Regardless of whether we have a body or not, if we're in
+        # chunked mode we want to send an explicit empty chunk.
+        if chunked:
+            self.send(b"0\r\n\r\n")
+
+    def request_chunked(
+        self,
+        method: str,
+        url: str,
+        body: _TYPE_BODY | None = None,
+        headers: typing.Mapping[str, str] | None = None,
+    ) -> None:
+        """
+        Alternative to the common request method, which sends the
+        body with chunked encoding and not as one block
+        """
+        warnings.warn(
+            "HTTPConnection.request_chunked() is deprecated and will be removed "
+            "in urllib3 v2.1.0. Instead use HTTPConnection.request(..., chunked=True).",
+            category=DeprecationWarning,
+            stacklevel=2,
+        )
+        self.request(method, url, body=body, headers=headers, chunked=True)
+
+    def getresponse(  # type: ignore[override]
+        self,
+    ) -> HTTPResponse:
+        """
+        Get the response from the server.
+
+        If the HTTPConnection is in the correct state, returns an instance of HTTPResponse or of whatever object is returned by the response_class variable.
+
+        If a request has not been sent or if a previous response has not be handled, ResponseNotReady is raised. If the HTTP response indicates that the connection should be closed, then it will be closed before the response is returned. When the connection is closed, the underlying socket is closed.
+        """
+        # Raise the same error as http.client.HTTPConnection
+        if self._response_options is None:
+            raise ResponseNotReady()
+
+        # Reset this attribute for being used again.
+        resp_options = self._response_options
+        self._response_options = None
+
+        # Since the connection's timeout value may have been updated
+        # we need to set the timeout on the socket.
+        self.sock.settimeout(self.timeout)
+
+        # This is needed here to avoid circular import errors
+        from .response import HTTPResponse
+
+        # Get the response from http.client.HTTPConnection
+        httplib_response = super().getresponse()
+
+        try:
+            assert_header_parsing(httplib_response.msg)
+        except (HeaderParsingError, TypeError) as hpe:
+            log.warning(
+                "Failed to parse headers (url=%s): %s",
+                _url_from_connection(self, resp_options.request_url),
+                hpe,
+                exc_info=True,
+            )
+
+        headers = HTTPHeaderDict(httplib_response.msg.items())
+
+        response = HTTPResponse(
+            body=httplib_response,
+            headers=headers,
+            status=httplib_response.status,
+            version=httplib_response.version,
+            reason=httplib_response.reason,
+            preload_content=resp_options.preload_content,
+            decode_content=resp_options.decode_content,
+            original_response=httplib_response,
+            enforce_content_length=resp_options.enforce_content_length,
+            request_method=resp_options.request_method,
+            request_url=resp_options.request_url,
+        )
+        return response
 
 
 class HTTPSConnection(HTTPConnection):
@@ -289,57 +494,100 @@ class HTTPSConnection(HTTPConnection):
     socket by means of :py:func:`urllib3.util.ssl_wrap_socket`.
     """
 
-    default_port = port_by_scheme["https"]
+    default_port = port_by_scheme["https"]  # type: ignore[misc]
 
-    cert_reqs = None
-    ca_certs = None
-    ca_cert_dir = None
-    ca_cert_data = None
-    ssl_version = None
-    assert_fingerprint = None
-    tls_in_tls_required = False
+    cert_reqs: int | str | None = None
+    ca_certs: str | None = None
+    ca_cert_dir: str | None = None
+    ca_cert_data: None | str | bytes = None
+    ssl_version: int | str | None = None
+    ssl_minimum_version: int | None = None
+    ssl_maximum_version: int | None = None
+    assert_fingerprint: str | None = None
 
     def __init__(
         self,
-        host,
-        port=None,
-        key_file=None,
-        cert_file=None,
-        key_password=None,
-        strict=None,
-        timeout=socket._GLOBAL_DEFAULT_TIMEOUT,
-        ssl_context=None,
-        server_hostname=None,
-        **kw
-    ):
-
-        HTTPConnection.__init__(self, host, port, strict=strict, timeout=timeout, **kw)
+        host: str,
+        port: int | None = None,
+        *,
+        timeout: _TYPE_TIMEOUT = _DEFAULT_TIMEOUT,
+        source_address: tuple[str, int] | None = None,
+        blocksize: int = 8192,
+        socket_options: None
+        | (connection._TYPE_SOCKET_OPTIONS) = HTTPConnection.default_socket_options,
+        proxy: Url | None = None,
+        proxy_config: ProxyConfig | None = None,
+        cert_reqs: int | str | None = None,
+        assert_hostname: None | str | Literal[False] = None,
+        assert_fingerprint: str | None = None,
+        server_hostname: str | None = None,
+        ssl_context: ssl.SSLContext | None = None,
+        ca_certs: str | None = None,
+        ca_cert_dir: str | None = None,
+        ca_cert_data: None | str | bytes = None,
+        ssl_minimum_version: int | None = None,
+        ssl_maximum_version: int | None = None,
+        ssl_version: int | str | None = None,  # Deprecated
+        cert_file: str | None = None,
+        key_file: str | None = None,
+        key_password: str | None = None,
+    ) -> None:
+        super().__init__(
+            host,
+            port=port,
+            timeout=timeout,
+            source_address=source_address,
+            blocksize=blocksize,
+            socket_options=socket_options,
+            proxy=proxy,
+            proxy_config=proxy_config,
+        )
 
         self.key_file = key_file
         self.cert_file = cert_file
         self.key_password = key_password
         self.ssl_context = ssl_context
         self.server_hostname = server_hostname
+        self.assert_hostname = assert_hostname
+        self.assert_fingerprint = assert_fingerprint
+        self.ssl_version = ssl_version
+        self.ssl_minimum_version = ssl_minimum_version
+        self.ssl_maximum_version = ssl_maximum_version
+        self.ca_certs = ca_certs and os.path.expanduser(ca_certs)
+        self.ca_cert_dir = ca_cert_dir and os.path.expanduser(ca_cert_dir)
+        self.ca_cert_data = ca_cert_data
 
-        # Required property for Google AppEngine 1.9.0 which otherwise causes
-        # HTTPS requests to go out as HTTP. (See Issue #356)
-        self._protocol = "https"
+        # cert_reqs depends on ssl_context so calculate last.
+        if cert_reqs is None:
+            if self.ssl_context is not None:
+                cert_reqs = self.ssl_context.verify_mode
+            else:
+                cert_reqs = resolve_cert_reqs(None)
+        self.cert_reqs = cert_reqs
 
     def set_cert(
         self,
-        key_file=None,
-        cert_file=None,
-        cert_reqs=None,
-        key_password=None,
-        ca_certs=None,
-        assert_hostname=None,
-        assert_fingerprint=None,
-        ca_cert_dir=None,
-        ca_cert_data=None,
-    ):
+        key_file: str | None = None,
+        cert_file: str | None = None,
+        cert_reqs: int | str | None = None,
+        key_password: str | None = None,
+        ca_certs: str | None = None,
+        assert_hostname: None | str | Literal[False] = None,
+        assert_fingerprint: str | None = None,
+        ca_cert_dir: str | None = None,
+        ca_cert_data: None | str | bytes = None,
+    ) -> None:
         """
         This method should only be called once, before the connection is used.
         """
+        warnings.warn(
+            "HTTPSConnection.set_cert() is deprecated and will be removed "
+            "in urllib3 v2.1.0. Instead provide the parameters to the "
+            "HTTPSConnection constructor.",
+            category=DeprecationWarning,
+            stacklevel=2,
+        )
+
         # If cert_reqs is not provided we'll assume CERT_REQUIRED unless we also
         # have an SSLContext object in which case we'll use its verify_mode.
         if cert_reqs is None:
@@ -358,27 +606,26 @@ class HTTPSConnection(HTTPConnection):
         self.ca_cert_dir = ca_cert_dir and os.path.expanduser(ca_cert_dir)
         self.ca_cert_data = ca_cert_data
 
-    def connect(self):
-        # Add certificate verification
-        self.sock = conn = self._new_conn()
-        hostname = self.host
+    def connect(self) -> None:
+        sock: socket.socket | ssl.SSLSocket
+        self.sock = sock = self._new_conn()
+        server_hostname: str = self.host
         tls_in_tls = False
 
-        if self._is_using_tunnel():
-            if self.tls_in_tls_required:
-                self.sock = conn = self._connect_tls_proxy(hostname, conn)
+        # Do we need to establish a tunnel?
+        if self._tunnel_host is not None:
+            # We're tunneling to an HTTPS origin so need to do TLS-in-TLS.
+            if self._tunnel_scheme == "https":
+                self.sock = sock = self._connect_tls_proxy(self.host, sock)
                 tls_in_tls = True
 
-            # Calls self._set_hostport(), so self.host is
-            # self._tunnel_host below.
-            self._tunnel()
-            # Mark this connection as not reusable
-            self.auto_open = 0
+            # If we're tunneling it means we're connected to our proxy.
+            self._has_connected_to_proxy = True
 
+            self._tunnel()  # type: ignore[attr-defined]
             # Override the host with the one we're requesting data from.
-            hostname = self._tunnel_host
+            server_hostname = self._tunnel_host
 
-        server_hostname = hostname
         if self.server_hostname is not None:
             server_hostname = self.server_hostname
 
@@ -386,163 +633,218 @@ class HTTPSConnection(HTTPConnection):
         if is_time_off:
             warnings.warn(
                 (
-                    "System time is way off (before {0}). This will probably "
+                    f"System time is way off (before {RECENT_DATE}). This will probably "
                     "lead to SSL verification errors"
-                ).format(RECENT_DATE),
+                ),
                 SystemTimeWarning,
             )
 
-        # Wrap socket using verification with the root certs in
-        # trusted_root_certs
-        default_ssl_context = False
-        if self.ssl_context is None:
-            default_ssl_context = True
-            self.ssl_context = create_urllib3_context(
-                ssl_version=resolve_ssl_version(self.ssl_version),
-                cert_reqs=resolve_cert_reqs(self.cert_reqs),
-            )
-
-        context = self.ssl_context
-        context.verify_mode = resolve_cert_reqs(self.cert_reqs)
-
-        # Try to load OS default certs if none are given.
-        # Works well on Windows (requires Python3.4+)
-        if (
-            not self.ca_certs
-            and not self.ca_cert_dir
-            and not self.ca_cert_data
-            and default_ssl_context
-            and hasattr(context, "load_default_certs")
-        ):
-            context.load_default_certs()
-
-        self.sock = ssl_wrap_socket(
-            sock=conn,
-            keyfile=self.key_file,
-            certfile=self.cert_file,
-            key_password=self.key_password,
+        sock_and_verified = _ssl_wrap_socket_and_match_hostname(
+            sock=sock,
+            cert_reqs=self.cert_reqs,
+            ssl_version=self.ssl_version,
+            ssl_minimum_version=self.ssl_minimum_version,
+            ssl_maximum_version=self.ssl_maximum_version,
             ca_certs=self.ca_certs,
             ca_cert_dir=self.ca_cert_dir,
             ca_cert_data=self.ca_cert_data,
+            cert_file=self.cert_file,
+            key_file=self.key_file,
+            key_password=self.key_password,
             server_hostname=server_hostname,
-            ssl_context=context,
+            ssl_context=self.ssl_context,
             tls_in_tls=tls_in_tls,
+            assert_hostname=self.assert_hostname,
+            assert_fingerprint=self.assert_fingerprint,
         )
+        self.sock = sock_and_verified.socket
+        self.is_verified = sock_and_verified.is_verified
 
-        # If we're using all defaults and the connection
-        # is TLSv1 or TLSv1.1 we throw a DeprecationWarning
-        # for the host.
-        if (
-            default_ssl_context
-            and self.ssl_version is None
-            and hasattr(self.sock, "version")
-            and self.sock.version() in {"TLSv1", "TLSv1.1"}
-        ):
-            warnings.warn(
-                "Negotiating TLSv1/TLSv1.1 by default is deprecated "
-                "and will be disabled in urllib3 v2.0.0. Connecting to "
-                "'%s' with '%s' can be enabled by explicitly opting-in "
-                "with 'ssl_version'" % (self.host, self.sock.version()),
-                DeprecationWarning,
-            )
+        # If there's a proxy to be connected to we are fully connected.
+        # This is set twice (once above and here) due to forwarding proxies
+        # not using tunnelling.
+        self._has_connected_to_proxy = bool(self.proxy)
 
-        if self.assert_fingerprint:
-            assert_fingerprint(
-                self.sock.getpeercert(binary_form=True), self.assert_fingerprint
-            )
-        elif (
-            context.verify_mode != ssl.CERT_NONE
-            and not getattr(context, "check_hostname", False)
-            and self.assert_hostname is not False
-        ):
-            # While urllib3 attempts to always turn off hostname matching from
-            # the TLS library, this cannot always be done. So we check whether
-            # the TLS Library still thinks it's matching hostnames.
-            cert = self.sock.getpeercert()
-            if not cert.get("subjectAltName", ()):
-                warnings.warn(
-                    (
-                        "Certificate for {0} has no `subjectAltName`, falling back to check for a "
-                        "`commonName` for now. This feature is being removed by major browsers and "
-                        "deprecated by RFC 2818. (See https://github.com/urllib3/urllib3/issues/497 "
-                        "for details.)".format(hostname)
-                    ),
-                    SubjectAltNameWarning,
-                )
-            _match_hostname(cert, self.assert_hostname or server_hostname)
-
-        self.is_verified = (
-            context.verify_mode == ssl.CERT_REQUIRED
-            or self.assert_fingerprint is not None
-        )
-
-    def _connect_tls_proxy(self, hostname, conn):
+    def _connect_tls_proxy(self, hostname: str, sock: socket.socket) -> ssl.SSLSocket:
         """
         Establish a TLS connection to the proxy using the provided SSL context.
         """
-        proxy_config = self.proxy_config
+        # `_connect_tls_proxy` is called when self._tunnel_host is truthy.
+        proxy_config = typing.cast(ProxyConfig, self.proxy_config)
         ssl_context = proxy_config.ssl_context
-        if ssl_context:
-            # If the user provided a proxy context, we assume CA and client
-            # certificates have already been set
-            return ssl_wrap_socket(
-                sock=conn,
-                server_hostname=hostname,
-                ssl_context=ssl_context,
-            )
-
-        ssl_context = create_proxy_ssl_context(
-            self.ssl_version,
-            self.cert_reqs,
-            self.ca_certs,
-            self.ca_cert_dir,
-            self.ca_cert_data,
-        )
-
-        # If no cert was provided, use only the default options for server
-        # certificate validation
-        socket = ssl_wrap_socket(
-            sock=conn,
+        sock_and_verified = _ssl_wrap_socket_and_match_hostname(
+            sock,
+            cert_reqs=self.cert_reqs,
+            ssl_version=self.ssl_version,
+            ssl_minimum_version=self.ssl_minimum_version,
+            ssl_maximum_version=self.ssl_maximum_version,
             ca_certs=self.ca_certs,
             ca_cert_dir=self.ca_cert_dir,
             ca_cert_data=self.ca_cert_data,
             server_hostname=hostname,
             ssl_context=ssl_context,
+            assert_hostname=proxy_config.assert_hostname,
+            assert_fingerprint=proxy_config.assert_fingerprint,
+            # Features that aren't implemented for proxies yet:
+            cert_file=None,
+            key_file=None,
+            key_password=None,
+            tls_in_tls=False,
         )
+        self.proxy_is_verified = sock_and_verified.is_verified
+        return sock_and_verified.socket  # type: ignore[return-value]
 
-        if ssl_context.verify_mode != ssl.CERT_NONE and not getattr(
-            ssl_context, "check_hostname", False
+
+class _WrappedAndVerifiedSocket(typing.NamedTuple):
+    """
+    Wrapped socket and whether the connection is
+    verified after the TLS handshake
+    """
+
+    socket: ssl.SSLSocket | SSLTransport
+    is_verified: bool
+
+
+def _ssl_wrap_socket_and_match_hostname(
+    sock: socket.socket,
+    *,
+    cert_reqs: None | str | int,
+    ssl_version: None | str | int,
+    ssl_minimum_version: int | None,
+    ssl_maximum_version: int | None,
+    cert_file: str | None,
+    key_file: str | None,
+    key_password: str | None,
+    ca_certs: str | None,
+    ca_cert_dir: str | None,
+    ca_cert_data: None | str | bytes,
+    assert_hostname: None | str | Literal[False],
+    assert_fingerprint: str | None,
+    server_hostname: str | None,
+    ssl_context: ssl.SSLContext | None,
+    tls_in_tls: bool = False,
+) -> _WrappedAndVerifiedSocket:
+    """Logic for constructing an SSLContext from all TLS parameters, passing
+    that down into ssl_wrap_socket, and then doing certificate verification
+    either via hostname or fingerprint. This function exists to guarantee
+    that both proxies and targets have the same behavior when connecting via TLS.
+    """
+    default_ssl_context = False
+    if ssl_context is None:
+        default_ssl_context = True
+        context = create_urllib3_context(
+            ssl_version=resolve_ssl_version(ssl_version),
+            ssl_minimum_version=ssl_minimum_version,
+            ssl_maximum_version=ssl_maximum_version,
+            cert_reqs=resolve_cert_reqs(cert_reqs),
+        )
+    else:
+        context = ssl_context
+
+    context.verify_mode = resolve_cert_reqs(cert_reqs)
+
+    # In some cases, we want to verify hostnames ourselves
+    if (
+        # `ssl` can't verify fingerprints or alternate hostnames
+        assert_fingerprint
+        or assert_hostname
+        # assert_hostname can be set to False to disable hostname checking
+        or assert_hostname is False
+        # We still support OpenSSL 1.0.2, which prevents us from verifying
+        # hostnames easily: https://github.com/pyca/pyopenssl/pull/933
+        or ssl_.IS_PYOPENSSL
+        or not ssl_.HAS_NEVER_CHECK_COMMON_NAME
+    ):
+        context.check_hostname = False
+
+    # Try to load OS default certs if none are given.
+    # We need to do the hasattr() check for our custom
+    # pyOpenSSL and SecureTransport SSLContext objects
+    # because neither support load_default_certs().
+    if (
+        not ca_certs
+        and not ca_cert_dir
+        and not ca_cert_data
+        and default_ssl_context
+        and hasattr(context, "load_default_certs")
+    ):
+        context.load_default_certs()
+
+    # Ensure that IPv6 addresses are in the proper format and don't have a
+    # scope ID. Python's SSL module fails to recognize scoped IPv6 addresses
+    # and interprets them as DNS hostnames.
+    if server_hostname is not None:
+        normalized = server_hostname.strip("[]")
+        if "%" in normalized:
+            normalized = normalized[: normalized.rfind("%")]
+        if is_ipaddress(normalized):
+            server_hostname = normalized
+
+    ssl_sock = ssl_wrap_socket(
+        sock=sock,
+        keyfile=key_file,
+        certfile=cert_file,
+        key_password=key_password,
+        ca_certs=ca_certs,
+        ca_cert_dir=ca_cert_dir,
+        ca_cert_data=ca_cert_data,
+        server_hostname=server_hostname,
+        ssl_context=context,
+        tls_in_tls=tls_in_tls,
+    )
+
+    try:
+        if assert_fingerprint:
+            _assert_fingerprint(
+                ssl_sock.getpeercert(binary_form=True), assert_fingerprint
+            )
+        elif (
+            context.verify_mode != ssl.CERT_NONE
+            and not context.check_hostname
+            and assert_hostname is not False
         ):
-            # While urllib3 attempts to always turn off hostname matching from
-            # the TLS library, this cannot always be done. So we check whether
-            # the TLS Library still thinks it's matching hostnames.
-            cert = socket.getpeercert()
-            if not cert.get("subjectAltName", ()):
-                warnings.warn(
-                    (
-                        "Certificate for {0} has no `subjectAltName`, falling back to check for a "
-                        "`commonName` for now. This feature is being removed by major browsers and "
-                        "deprecated by RFC 2818. (See https://github.com/urllib3/urllib3/issues/497 "
-                        "for details.)".format(hostname)
-                    ),
-                    SubjectAltNameWarning,
+            cert: _TYPE_PEER_CERT_RET_DICT = ssl_sock.getpeercert()  # type: ignore[assignment]
+
+            # Need to signal to our match_hostname whether to use 'commonName' or not.
+            # If we're using our own constructed SSLContext we explicitly set 'False'
+            # because PyPy hard-codes 'True' from SSLContext.hostname_checks_common_name.
+            if default_ssl_context:
+                hostname_checks_common_name = False
+            else:
+                hostname_checks_common_name = (
+                    getattr(context, "hostname_checks_common_name", False) or False
                 )
-            _match_hostname(cert, hostname)
 
-        self.proxy_is_verified = ssl_context.verify_mode == ssl.CERT_REQUIRED
-        return socket
+            _match_hostname(
+                cert,
+                assert_hostname or server_hostname,  # type: ignore[arg-type]
+                hostname_checks_common_name,
+            )
+
+        return _WrappedAndVerifiedSocket(
+            socket=ssl_sock,
+            is_verified=context.verify_mode == ssl.CERT_REQUIRED
+            or bool(assert_fingerprint),
+        )
+    except BaseException:
+        ssl_sock.close()
+        raise
 
 
-def _match_hostname(cert, asserted_hostname):
+def _match_hostname(
+    cert: _TYPE_PEER_CERT_RET_DICT | None,
+    asserted_hostname: str,
+    hostname_checks_common_name: bool = False,
+) -> None:
     # Our upstream implementation of ssl.match_hostname()
     # only applies this normalization to IP addresses so it doesn't
     # match DNS SANs so we do the same thing!
-    stripped_hostname = asserted_hostname.strip("u[]")
+    stripped_hostname = asserted_hostname.strip("[]")
     if is_ipaddress(stripped_hostname):
         asserted_hostname = stripped_hostname
 
     try:
-        match_hostname(cert, asserted_hostname)
+        match_hostname(cert, asserted_hostname, hostname_checks_common_name)
     except CertificateError as e:
         log.warning(
             "Certificate did not match expected hostname: %s. Certificate: %s",
@@ -551,22 +853,54 @@ def _match_hostname(cert, asserted_hostname):
         )
         # Add cert to exception and reraise so client code can inspect
         # the cert when catching the exception, if they want to
-        e._peer_cert = cert
+        e._peer_cert = cert  # type: ignore[attr-defined]
         raise
 
 
-def _get_default_user_agent():
-    return "python-urllib3/%s" % __version__
+def _wrap_proxy_error(err: Exception, proxy_scheme: str | None) -> ProxyError:
+    # Look for the phrase 'wrong version number', if found
+    # then we should warn the user that we're very sure that
+    # this proxy is HTTP-only and they have a configuration issue.
+    error_normalized = " ".join(re.split("[^a-z]", str(err).lower()))
+    is_likely_http_proxy = (
+        "wrong version number" in error_normalized
+        or "unknown protocol" in error_normalized
+    )
+    http_proxy_warning = (
+        ". Your proxy appears to only use HTTP and not HTTPS, "
+        "try changing your proxy URL to be HTTP. See: "
+        "https://urllib3.readthedocs.io/en/latest/advanced-usage.html"
+        "#https-proxy-error-http-proxy"
+    )
+    new_err = ProxyError(
+        f"Unable to connect to proxy"
+        f"{http_proxy_warning if is_likely_http_proxy and proxy_scheme == 'https' else ''}",
+        err,
+    )
+    new_err.__cause__ = err
+    return new_err
 
 
-class DummyConnection(object):
+def _get_default_user_agent() -> str:
+    return f"python-urllib3/{__version__}"
+
+
+class DummyConnection:
     """Used to detect a failed ConnectionCls import."""
 
-    pass
-
 
 if not ssl:
-    HTTPSConnection = DummyConnection  # noqa: F811
+    HTTPSConnection = DummyConnection  # type: ignore[misc, assignment] # noqa: F811
 
 
 VerifiedHTTPSConnection = HTTPSConnection
+
+
+def _url_from_connection(
+    conn: HTTPConnection | HTTPSConnection, path: str | None = None
+) -> str:
+    """Returns the URL from a given connection. This is mainly used for testing and logging."""
+
+    scheme = "https" if isinstance(conn, HTTPSConnection) else "http"
+
+    return Url(scheme=scheme, host=conn.host, port=conn.port, path=path).url
diff --git a/lib/urllib3/connectionpool.py b/lib/urllib3/connectionpool.py
index c23d736b..2479405b 100644
--- a/lib/urllib3/connectionpool.py
+++ b/lib/urllib3/connectionpool.py
@@ -1,14 +1,17 @@
-from __future__ import absolute_import
+from __future__ import annotations
 
 import errno
 import logging
-import re
-import socket
+import queue
 import sys
+import typing
 import warnings
-from socket import error as SocketError
+import weakref
 from socket import timeout as SocketTimeout
+from types import TracebackType
 
+from ._base_connection import _TYPE_BODY
+from ._request_methods import RequestMethods
 from .connection import (
     BaseSSLError,
     BrokenPipeError,
@@ -16,13 +19,14 @@ from .connection import (
     HTTPConnection,
     HTTPException,
     HTTPSConnection,
-    VerifiedHTTPSConnection,
-    port_by_scheme,
+    ProxyConfig,
+    _wrap_proxy_error,
 )
+from .connection import port_by_scheme as port_by_scheme
 from .exceptions import (
     ClosedPoolError,
     EmptyPoolError,
-    HeaderParsingError,
+    FullPoolError,
     HostChangedError,
     InsecureRequestWarning,
     LocationValueError,
@@ -34,31 +38,34 @@ from .exceptions import (
     SSLError,
     TimeoutError,
 )
-from .packages import six
-from .packages.six.moves import queue
-from .request import RequestMethods
-from .response import HTTPResponse
+from .response import BaseHTTPResponse
 from .util.connection import is_connection_dropped
 from .util.proxy import connection_requires_http_tunnel
-from .util.queue import LifoQueue
-from .util.request import set_file_position
-from .util.response import assert_header_parsing
+from .util.request import _TYPE_BODY_POSITION, set_file_position
 from .util.retry import Retry
 from .util.ssl_match_hostname import CertificateError
-from .util.timeout import Timeout
+from .util.timeout import _DEFAULT_TIMEOUT, _TYPE_DEFAULT, Timeout
 from .util.url import Url, _encode_target
 from .util.url import _normalize_host as normalize_host
-from .util.url import get_host, parse_url
+from .util.url import parse_url
+from .util.util import to_str
 
-xrange = six.moves.xrange
+if typing.TYPE_CHECKING:
+    import ssl
+
+    from typing_extensions import Literal
+
+    from ._base_connection import BaseHTTPConnection, BaseHTTPSConnection
 
 log = logging.getLogger(__name__)
 
-_Default = object()
+_TYPE_TIMEOUT = typing.Union[Timeout, float, _TYPE_DEFAULT, None]
+
+_SelfT = typing.TypeVar("_SelfT")
 
 
 # Pool objects
-class ConnectionPool(object):
+class ConnectionPool:
     """
     Base class for all connection pools, such as
     :class:`.HTTPConnectionPool` and :class:`.HTTPSConnectionPool`.
@@ -69,33 +76,42 @@ class ConnectionPool(object):
        target URIs.
     """
 
-    scheme = None
-    QueueCls = LifoQueue
+    scheme: str | None = None
+    QueueCls = queue.LifoQueue
 
-    def __init__(self, host, port=None):
+    def __init__(self, host: str, port: int | None = None) -> None:
         if not host:
             raise LocationValueError("No host specified.")
 
         self.host = _normalize_host(host, scheme=self.scheme)
-        self._proxy_host = host.lower()
         self.port = port
 
-    def __str__(self):
-        return "%s(host=%r, port=%r)" % (type(self).__name__, self.host, self.port)
+        # This property uses 'normalize_host()' (not '_normalize_host()')
+        # to avoid removing square braces around IPv6 addresses.
+        # This value is sent to `HTTPConnection.set_tunnel()` if called
+        # because square braces are required for HTTP CONNECT tunneling.
+        self._tunnel_host = normalize_host(host, scheme=self.scheme).lower()
 
-    def __enter__(self):
+    def __str__(self) -> str:
+        return f"{type(self).__name__}(host={self.host!r}, port={self.port!r})"
+
+    def __enter__(self: _SelfT) -> _SelfT:
         return self
 
-    def __exit__(self, exc_type, exc_val, exc_tb):
+    def __exit__(
+        self,
+        exc_type: type[BaseException] | None,
+        exc_val: BaseException | None,
+        exc_tb: TracebackType | None,
+    ) -> Literal[False]:
         self.close()
         # Return False to re-raise any potential exceptions
         return False
 
-    def close(self):
+    def close(self) -> None:
         """
         Close all pooled connections and disable the pool.
         """
-        pass
 
 
 # This is taken from http://hg.python.org/cpython/file/7aaba721ebc0/Lib/socket.py#l252
@@ -114,14 +130,6 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
         Port used for this HTTP Connection (None is equivalent to 80), passed
         into :class:`http.client.HTTPConnection`.
 
-    :param strict:
-        Causes BadStatusLine to be raised if the status line can't be parsed
-        as a valid HTTP/1.0 or 1.1 status line, passed into
-        :class:`http.client.HTTPConnection`.
-
-        .. note::
-           Only works in Python 2. This parameter is ignored in Python 3.
-
     :param timeout:
         Socket timeout in seconds for each individual connection. This can
         be a float or integer, which sets the timeout for the HTTP request,
@@ -163,29 +171,27 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
     """
 
     scheme = "http"
-    ConnectionCls = HTTPConnection
-    ResponseCls = HTTPResponse
+    ConnectionCls: (
+        type[BaseHTTPConnection] | type[BaseHTTPSConnection]
+    ) = HTTPConnection
 
     def __init__(
         self,
-        host,
-        port=None,
-        strict=False,
-        timeout=Timeout.DEFAULT_TIMEOUT,
-        maxsize=1,
-        block=False,
-        headers=None,
-        retries=None,
-        _proxy=None,
-        _proxy_headers=None,
-        _proxy_config=None,
-        **conn_kw
+        host: str,
+        port: int | None = None,
+        timeout: _TYPE_TIMEOUT | None = _DEFAULT_TIMEOUT,
+        maxsize: int = 1,
+        block: bool = False,
+        headers: typing.Mapping[str, str] | None = None,
+        retries: Retry | bool | int | None = None,
+        _proxy: Url | None = None,
+        _proxy_headers: typing.Mapping[str, str] | None = None,
+        _proxy_config: ProxyConfig | None = None,
+        **conn_kw: typing.Any,
     ):
         ConnectionPool.__init__(self, host, port)
         RequestMethods.__init__(self, headers)
 
-        self.strict = strict
-
         if not isinstance(timeout, Timeout):
             timeout = Timeout.from_float(timeout)
 
@@ -195,7 +201,7 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
         self.timeout = timeout
         self.retries = retries
 
-        self.pool = self.QueueCls(maxsize)
+        self.pool: queue.LifoQueue[typing.Any] | None = self.QueueCls(maxsize)
         self.block = block
 
         self.proxy = _proxy
@@ -203,7 +209,7 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
         self.proxy_config = _proxy_config
 
         # Fill the queue up so that doing get() on it will block properly
-        for _ in xrange(maxsize):
+        for _ in range(maxsize):
             self.pool.put(None)
 
         # These are mostly for testing and debugging purposes.
@@ -220,7 +226,17 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
             self.conn_kw["proxy"] = self.proxy
             self.conn_kw["proxy_config"] = self.proxy_config
 
-    def _new_conn(self):
+        # Do not pass 'self' as callback to 'finalize'.
+        # Then the 'finalize' would keep an endless living (leak) to self.
+        # By just passing a reference to the pool allows the garbage collector
+        # to free self if nobody else has a reference to it.
+        pool = self.pool
+
+        # Close all the HTTPConnections in the pool before the
+        # HTTPConnectionPool object is garbage collected.
+        weakref.finalize(self, _close_pool_connections, pool)
+
+    def _new_conn(self) -> BaseHTTPConnection:
         """
         Return a fresh :class:`HTTPConnection`.
         """
@@ -236,12 +252,11 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
             host=self.host,
             port=self.port,
             timeout=self.timeout.connect_timeout,
-            strict=self.strict,
-            **self.conn_kw
+            **self.conn_kw,
         )
         return conn
 
-    def _get_conn(self, timeout=None):
+    def _get_conn(self, timeout: float | None = None) -> BaseHTTPConnection:
         """
         Get a connection. Will return a pooled connection if one is available.
 
@@ -254,33 +269,32 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
             :prop:`.block` is ``True``.
         """
         conn = None
+
+        if self.pool is None:
+            raise ClosedPoolError(self, "Pool is closed.")
+
         try:
             conn = self.pool.get(block=self.block, timeout=timeout)
 
         except AttributeError:  # self.pool is None
-            raise ClosedPoolError(self, "Pool is closed.")
+            raise ClosedPoolError(self, "Pool is closed.") from None  # Defensive:
 
         except queue.Empty:
             if self.block:
                 raise EmptyPoolError(
                     self,
-                    "Pool reached maximum size and no more connections are allowed.",
-                )
+                    "Pool is empty and a new connection can't be opened due to blocking mode.",
+                ) from None
             pass  # Oh well, we'll create a new connection then
 
         # If this is a persistent connection, check if it got disconnected
         if conn and is_connection_dropped(conn):
             log.debug("Resetting dropped connection: %s", self.host)
             conn.close()
-            if getattr(conn, "auto_open", 1) == 0:
-                # This is a proxied connection that has been mutated by
-                # http.client._tunnel() and cannot be reused (since it would
-                # attempt to bypass the proxy)
-                conn = None
 
         return conn or self._new_conn()
 
-    def _put_conn(self, conn):
+    def _put_conn(self, conn: BaseHTTPConnection | None) -> None:
         """
         Put a connection back into the pool.
 
@@ -294,36 +308,47 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
 
         If the pool is closed, then the connection will be closed and discarded.
         """
-        try:
-            self.pool.put(conn, block=False)
-            return  # Everything is dandy, done.
-        except AttributeError:
-            # self.pool is None.
-            pass
-        except queue.Full:
-            # This should never happen if self.block == True
-            log.warning(
-                "Connection pool is full, discarding connection: %s. Connection pool size: %s",
-                self.host,
-                self.pool.qsize(),
-            )
+        if self.pool is not None:
+            try:
+                self.pool.put(conn, block=False)
+                return  # Everything is dandy, done.
+            except AttributeError:
+                # self.pool is None.
+                pass
+            except queue.Full:
+                # Connection never got put back into the pool, close it.
+                if conn:
+                    conn.close()
+
+                if self.block:
+                    # This should never happen if you got the conn from self._get_conn
+                    raise FullPoolError(
+                        self,
+                        "Pool reached maximum size and no more connections are allowed.",
+                    ) from None
+
+                log.warning(
+                    "Connection pool is full, discarding connection: %s. Connection pool size: %s",
+                    self.host,
+                    self.pool.qsize(),
+                )
+
         # Connection never got put back into the pool, close it.
         if conn:
             conn.close()
 
-    def _validate_conn(self, conn):
+    def _validate_conn(self, conn: BaseHTTPConnection) -> None:
         """
         Called right before a request is made, after the socket is created.
         """
-        pass
 
-    def _prepare_proxy(self, conn):
+    def _prepare_proxy(self, conn: BaseHTTPConnection) -> None:
         # Nothing to do for HTTP connections.
         pass
 
-    def _get_timeout(self, timeout):
+    def _get_timeout(self, timeout: _TYPE_TIMEOUT) -> Timeout:
         """Helper that always returns a :class:`urllib3.util.Timeout`"""
-        if timeout is _Default:
+        if timeout is _DEFAULT_TIMEOUT:
             return self.timeout.clone()
 
         if isinstance(timeout, Timeout):
@@ -333,34 +358,40 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
             # can be removed later
             return Timeout.from_float(timeout)
 
-    def _raise_timeout(self, err, url, timeout_value):
+    def _raise_timeout(
+        self,
+        err: BaseSSLError | OSError | SocketTimeout,
+        url: str,
+        timeout_value: _TYPE_TIMEOUT | None,
+    ) -> None:
         """Is the error actually a timeout? Will raise a ReadTimeout or pass"""
 
         if isinstance(err, SocketTimeout):
             raise ReadTimeoutError(
-                self, url, "Read timed out. (read timeout=%s)" % timeout_value
-            )
+                self, url, f"Read timed out. (read timeout={timeout_value})"
+            ) from err
 
-        # See the above comment about EAGAIN in Python 3. In Python 2 we have
-        # to specifically catch it and throw the timeout error
+        # See the above comment about EAGAIN in Python 3.
         if hasattr(err, "errno") and err.errno in _blocking_errnos:
             raise ReadTimeoutError(
-                self, url, "Read timed out. (read timeout=%s)" % timeout_value
-            )
-
-        # Catch possible read timeouts thrown as SSL errors. If not the
-        # case, rethrow the original. We need to do this because of:
-        # http://bugs.python.org/issue10272
-        if "timed out" in str(err) or "did not complete (read)" in str(
-            err
-        ):  # Python < 2.7.4
-            raise ReadTimeoutError(
-                self, url, "Read timed out. (read timeout=%s)" % timeout_value
-            )
+                self, url, f"Read timed out. (read timeout={timeout_value})"
+            ) from err
 
     def _make_request(
-        self, conn, method, url, timeout=_Default, chunked=False, **httplib_request_kw
-    ):
+        self,
+        conn: BaseHTTPConnection,
+        method: str,
+        url: str,
+        body: _TYPE_BODY | None = None,
+        headers: typing.Mapping[str, str] | None = None,
+        retries: Retry | None = None,
+        timeout: _TYPE_TIMEOUT = _DEFAULT_TIMEOUT,
+        chunked: bool = False,
+        response_conn: BaseHTTPConnection | None = None,
+        preload_content: bool = True,
+        decode_content: bool = True,
+        enforce_content_length: bool = True,
+    ) -> BaseHTTPResponse:
         """
         Perform a request on a given urllib connection object taken from our
         pool.
@@ -368,12 +399,61 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
         :param conn:
             a connection from one of our connection pools
 
+        :param method:
+            HTTP request method (such as GET, POST, PUT, etc.)
+
+        :param url:
+            The URL to perform the request on.
+
+        :param body:
+            Data to send in the request body, either :class:`str`, :class:`bytes`,
+            an iterable of :class:`str`/:class:`bytes`, or a file-like object.
+
+        :param headers:
+            Dictionary of custom headers to send, such as User-Agent,
+            If-None-Match, etc. If None, pool headers are used. If provided,
+            these headers completely replace any pool-specific headers.
+
+        :param retries:
+            Configure the number of retries to allow before raising a
+            :class:`~urllib3.exceptions.MaxRetryError` exception.
+
+            Pass ``None`` to retry until you receive a response. Pass a
+            :class:`~urllib3.util.retry.Retry` object for fine-grained control
+            over different types of retries.
+            Pass an integer number to retry connection errors that many times,
+            but no other types of errors. Pass zero to never retry.
+
+            If ``False``, then retries are disabled and any exception is raised
+            immediately. Also, instead of raising a MaxRetryError on redirects,
+            the redirect response will be returned.
+
+        :type retries: :class:`~urllib3.util.retry.Retry`, False, or an int.
+
         :param timeout:
-            Socket timeout in seconds for the request. This can be a
-            float or integer, which will set the same timeout value for
-            the socket connect and the socket read, or an instance of
-            :class:`urllib3.util.Timeout`, which gives you more fine-grained
-            control over your timeouts.
+            If specified, overrides the default timeout for this one
+            request. It may be a float (in seconds) or an instance of
+            :class:`urllib3.util.Timeout`.
+
+        :param chunked:
+            If True, urllib3 will send the body using chunked transfer
+            encoding. Otherwise, urllib3 will send the body using the standard
+            content-length form. Defaults to False.
+
+        :param response_conn:
+            Set this to ``None`` if you will handle releasing the connection or
+            set the connection to have the response release it.
+
+        :param preload_content:
+          If True, the response's body will be preloaded during construction.
+
+        :param decode_content:
+            If True, will attempt to decode the body based on the
+            'content-encoding' header.
+
+        :param enforce_content_length:
+            Enforce content length checking. Body returned by server must match
+            value of Content-Length header, if present. Otherwise, raise error.
         """
         self.num_requests += 1
 
@@ -381,44 +461,65 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
         timeout_obj.start_connect()
         conn.timeout = Timeout.resolve_default_timeout(timeout_obj.connect_timeout)
 
-        # Trigger any extra validation we need to do.
         try:
-            self._validate_conn(conn)
-        except (SocketTimeout, BaseSSLError) as e:
-            # Py2 raises this as a BaseSSLError, Py3 raises it as socket timeout.
-            self._raise_timeout(err=e, url=url, timeout_value=conn.timeout)
-            raise
+            # Trigger any extra validation we need to do.
+            try:
+                self._validate_conn(conn)
+            except (SocketTimeout, BaseSSLError) as e:
+                self._raise_timeout(err=e, url=url, timeout_value=conn.timeout)
+                raise
+
+        # _validate_conn() starts the connection to an HTTPS proxy
+        # so we need to wrap errors with 'ProxyError' here too.
+        except (
+            OSError,
+            NewConnectionError,
+            TimeoutError,
+            BaseSSLError,
+            CertificateError,
+            SSLError,
+        ) as e:
+            new_e: Exception = e
+            if isinstance(e, (BaseSSLError, CertificateError)):
+                new_e = SSLError(e)
+            # If the connection didn't successfully connect to it's proxy
+            # then there
+            if isinstance(
+                new_e, (OSError, NewConnectionError, TimeoutError, SSLError)
+            ) and (conn and conn.proxy and not conn.has_connected_to_proxy):
+                new_e = _wrap_proxy_error(new_e, conn.proxy.scheme)
+            raise new_e
 
         # conn.request() calls http.client.*.request, not the method in
         # urllib3.request. It also calls makefile (recv) on the socket.
         try:
-            if chunked:
-                conn.request_chunked(method, url, **httplib_request_kw)
-            else:
-                conn.request(method, url, **httplib_request_kw)
+            conn.request(
+                method,
+                url,
+                body=body,
+                headers=headers,
+                chunked=chunked,
+                preload_content=preload_content,
+                decode_content=decode_content,
+                enforce_content_length=enforce_content_length,
+            )
 
         # We are swallowing BrokenPipeError (errno.EPIPE) since the server is
         # legitimately able to close the connection after sending a valid response.
         # With this behaviour, the received response is still readable.
         except BrokenPipeError:
-            # Python 3
             pass
-        except IOError as e:
-            # Python 2 and macOS/Linux
-            # EPIPE and ESHUTDOWN are BrokenPipeError on Python 2, and EPROTOTYPE is needed on macOS
+        except OSError as e:
+            # MacOS/Linux
+            # EPROTOTYPE is needed on macOS
             # https://erickt.github.io/blog/2014/11/19/adventures-in-debugging-a-potential-osx-kernel-bug/
-            if e.errno not in {
-                errno.EPIPE,
-                errno.ESHUTDOWN,
-                errno.EPROTOTYPE,
-            }:
+            if e.errno != errno.EPROTOTYPE:
                 raise
 
         # Reset the timeout for the recv() on the socket
         read_timeout = timeout_obj.read_timeout
 
-        # App Engine doesn't have a sock attr
-        if getattr(conn, "sock", None):
+        if not conn.is_closed:
             # In Python 3 socket.py will catch EAGAIN and return None when you
             # try and read into the file pointer created by http.client, which
             # instead raises a BadStatusLine exception. Instead of catching
@@ -426,33 +527,22 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
             # timeouts, check for a zero timeout before making the request.
             if read_timeout == 0:
                 raise ReadTimeoutError(
-                    self, url, "Read timed out. (read timeout=%s)" % read_timeout
+                    self, url, f"Read timed out. (read timeout={read_timeout})"
                 )
-            if read_timeout is Timeout.DEFAULT_TIMEOUT:
-                conn.sock.settimeout(socket.getdefaulttimeout())
-            else:  # None or a value
-                conn.sock.settimeout(read_timeout)
+            conn.timeout = read_timeout
 
         # Receive the response from the server
         try:
-            try:
-                # Python 2.7, use buffering of HTTP responses
-                httplib_response = conn.getresponse(buffering=True)
-            except TypeError:
-                # Python 3
-                try:
-                    httplib_response = conn.getresponse()
-                except BaseException as e:
-                    # Remove the TypeError from the exception chain in
-                    # Python 3 (including for exceptions like SystemExit).
-                    # Otherwise it looks like a bug in the code.
-                    six.raise_from(e, None)
-        except (SocketTimeout, BaseSSLError, SocketError) as e:
+            response = conn.getresponse()
+        except (BaseSSLError, OSError) as e:
             self._raise_timeout(err=e, url=url, timeout_value=read_timeout)
             raise
 
-        # AppEngine doesn't have a version attr.
-        http_version = getattr(conn, "_http_vsn_str", "HTTP/?")
+        # Set properties that are used by the pooling layer.
+        response.retries = retries
+        response._connection = response_conn  # type: ignore[attr-defined]
+        response._pool = self  # type: ignore[attr-defined]
+
         log.debug(
             '%s://%s:%s "%s %s %s" %s %s',
             self.scheme,
@@ -460,27 +550,15 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
             self.port,
             method,
             url,
-            http_version,
-            httplib_response.status,
-            httplib_response.length,
+            # HTTP version
+            conn._http_vsn_str,  # type: ignore[attr-defined]
+            response.status,
+            response.length_remaining,  # type: ignore[attr-defined]
         )
 
-        try:
-            assert_header_parsing(httplib_response.msg)
-        except (HeaderParsingError, TypeError) as hpe:  # Platform-specific: Python 3
-            log.warning(
-                "Failed to parse headers (url=%s): %s",
-                self._absolute_url(url),
-                hpe,
-                exc_info=True,
-            )
+        return response
 
-        return httplib_response
-
-    def _absolute_url(self, path):
-        return Url(scheme=self.scheme, host=self.host, port=self.port, path=path).url
-
-    def close(self):
+    def close(self) -> None:
         """
         Close all pooled connections and disable the pool.
         """
@@ -489,16 +567,10 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
         # Disable access to the pool
         old_pool, self.pool = self.pool, None
 
-        try:
-            while True:
-                conn = old_pool.get(block=False)
-                if conn:
-                    conn.close()
+        # Close all the HTTPConnections in the pool.
+        _close_pool_connections(old_pool)
 
-        except queue.Empty:
-            pass  # Done.
-
-    def is_same_host(self, url):
+    def is_same_host(self, url: str) -> bool:
         """
         Check if the given ``url`` is a member of the same host as this
         connection pool.
@@ -507,7 +579,8 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
             return True
 
         # TODO: Add optional support for socket.gethostbyname checking.
-        scheme, host, port = get_host(url)
+        scheme, _, host, port, *_ = parse_url(url)
+        scheme = scheme or "http"
         if host is not None:
             host = _normalize_host(host, scheme=scheme)
 
@@ -519,22 +592,24 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
 
         return (scheme, host, port) == (self.scheme, self.host, self.port)
 
-    def urlopen(
+    def urlopen(  # type: ignore[override]
         self,
-        method,
-        url,
-        body=None,
-        headers=None,
-        retries=None,
-        redirect=True,
-        assert_same_host=True,
-        timeout=_Default,
-        pool_timeout=None,
-        release_conn=None,
-        chunked=False,
-        body_pos=None,
-        **response_kw
-    ):
+        method: str,
+        url: str,
+        body: _TYPE_BODY | None = None,
+        headers: typing.Mapping[str, str] | None = None,
+        retries: Retry | bool | int | None = None,
+        redirect: bool = True,
+        assert_same_host: bool = True,
+        timeout: _TYPE_TIMEOUT = _DEFAULT_TIMEOUT,
+        pool_timeout: int | None = None,
+        release_conn: bool | None = None,
+        chunked: bool = False,
+        body_pos: _TYPE_BODY_POSITION | None = None,
+        preload_content: bool = True,
+        decode_content: bool = True,
+        **response_kw: typing.Any,
+    ) -> BaseHTTPResponse:
         """
         Get a connection from the pool and perform an HTTP request. This is the
         lowest level call for making a request, so you'll need to specify all
@@ -542,8 +617,8 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
 
         .. note::
 
-           More commonly, it's appropriate to use a convenience method provided
-           by :class:`.RequestMethods`, such as :meth:`request`.
+           More commonly, it's appropriate to use a convenience method
+           such as :meth:`request`.
 
         .. note::
 
@@ -603,6 +678,13 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
             block for ``pool_timeout`` seconds and raise EmptyPoolError if no
             connection is available within the time period.
 
+        :param bool preload_content:
+            If True, the response's body will be preloaded into memory.
+
+        :param bool decode_content:
+            If True, will attempt to decode the body based on the
+            'content-encoding' header.
+
         :param release_conn:
             If False, then the urlopen call will not release the connection
             back into the pool once a response is received (but will release if
@@ -610,10 +692,10 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
             `preload_content=True`). This is useful if you're not preloading
             the response's content immediately. You will need to call
             ``r.release_conn()`` on the response ``r`` to return the connection
-            back into the pool. If None, it takes the value of
-            ``response_kw.get('preload_content', True)``.
+            back into the pool. If None, it takes the value of ``preload_content``
+            which defaults to ``True``.
 
-        :param chunked:
+        :param bool chunked:
             If True, urllib3 will send the body using chunked transfer
             encoding. Otherwise, urllib3 will send the body using the standard
             content-length form. Defaults to False.
@@ -622,12 +704,7 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
             Position to seek to in file-like body in the event of a retry or
             redirect. Typically this won't need to be set because urllib3 will
             auto-populate the value when needed.
-
-        :param \\**response_kw:
-            Additional parameters are passed to
-            :meth:`urllib3.response.HTTPResponse.from_httplib`
         """
-
         parsed_url = parse_url(url)
         destination_scheme = parsed_url.scheme
 
@@ -638,7 +715,7 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
             retries = Retry.from_int(retries, redirect=redirect, default=self.retries)
 
         if release_conn is None:
-            release_conn = response_kw.get("preload_content", True)
+            release_conn = preload_content
 
         # Check host
         if assert_same_host and not self.is_same_host(url):
@@ -646,9 +723,9 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
 
         # Ensure that the URL we're connecting to is properly encoded
         if url.startswith("/"):
-            url = six.ensure_str(_encode_target(url))
+            url = to_str(_encode_target(url))
         else:
-            url = six.ensure_str(parsed_url.url)
+            url = to_str(parsed_url.url)
 
         conn = None
 
@@ -671,8 +748,8 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
         # have to copy the headers dict so we can safely change it without those
         # changes being reflected in anyone else's copy.
         if not http_tunnel_required:
-            headers = headers.copy()
-            headers.update(self.proxy_headers)
+            headers = headers.copy()  # type: ignore[attr-defined]
+            headers.update(self.proxy_headers)  # type: ignore[union-attr]
 
         # Must keep the exception bound to a separate variable or else Python 3
         # complains about UnboundLocalError.
@@ -691,24 +768,17 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
             timeout_obj = self._get_timeout(timeout)
             conn = self._get_conn(timeout=pool_timeout)
 
-            conn.timeout = timeout_obj.connect_timeout
+            conn.timeout = timeout_obj.connect_timeout  # type: ignore[assignment]
 
-            is_new_proxy_conn = self.proxy is not None and not getattr(
-                conn, "sock", None
-            )
-            if is_new_proxy_conn and http_tunnel_required:
-                self._prepare_proxy(conn)
-
-            # Make the request on the httplib connection object.
-            httplib_response = self._make_request(
-                conn,
-                method,
-                url,
-                timeout=timeout_obj,
-                body=body,
-                headers=headers,
-                chunked=chunked,
-            )
+            # Is this a closed/new connection that requires CONNECT tunnelling?
+            if self.proxy is not None and http_tunnel_required and conn.is_closed:
+                try:
+                    self._prepare_proxy(conn)
+                except (BaseSSLError, OSError, SocketTimeout) as e:
+                    self._raise_timeout(
+                        err=e, url=self.proxy.url, timeout_value=conn.timeout
+                    )
+                    raise
 
             # If we're going to release the connection in ``finally:``, then
             # the response doesn't need to know about the connection. Otherwise
@@ -716,16 +786,20 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
             # mess.
             response_conn = conn if not release_conn else None
 
-            # Pass method to Response for length checking
-            response_kw["request_method"] = method
-
-            # Import httplib's response into our own wrapper object
-            response = self.ResponseCls.from_httplib(
-                httplib_response,
-                pool=self,
-                connection=response_conn,
+            # Make the request on the HTTPConnection object
+            response = self._make_request(
+                conn,
+                method,
+                url,
+                timeout=timeout_obj,
+                body=body,
+                headers=headers,
+                chunked=chunked,
                 retries=retries,
-                **response_kw
+                response_conn=response_conn,
+                preload_content=preload_content,
+                decode_content=decode_content,
+                **response_kw,
             )
 
             # Everything went great!
@@ -740,52 +814,35 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
         except (
             TimeoutError,
             HTTPException,
-            SocketError,
+            OSError,
             ProtocolError,
             BaseSSLError,
             SSLError,
             CertificateError,
+            ProxyError,
         ) as e:
             # Discard the connection for these exceptions. It will be
             # replaced during the next _get_conn() call.
             clean_exit = False
-
-            def _is_ssl_error_message_from_http_proxy(ssl_error):
-                # We're trying to detect the message 'WRONG_VERSION_NUMBER' but
-                # SSLErrors are kinda all over the place when it comes to the message,
-                # so we try to cover our bases here!
-                message = " ".join(re.split("[^a-z]", str(ssl_error).lower()))
-                return (
-                    "wrong version number" in message or "unknown protocol" in message
-                )
-
-            # Try to detect a common user error with proxies which is to
-            # set an HTTP proxy to be HTTPS when it should be 'http://'
-            # (ie {'http': 'http://proxy', 'https': 'https://proxy'})
-            # Instead we add a nice error message and point to a URL.
-            if (
-                isinstance(e, BaseSSLError)
-                and self.proxy
-                and _is_ssl_error_message_from_http_proxy(e)
-                and conn.proxy
-                and conn.proxy.scheme == "https"
-            ):
-                e = ProxyError(
-                    "Your proxy appears to only use HTTP and not HTTPS, "
-                    "try changing your proxy URL to be HTTP. See: "
-                    "https://urllib3.readthedocs.io/en/1.26.x/advanced-usage.html"
-                    "#https-proxy-error-http-proxy",
-                    SSLError(e),
-                )
-            elif isinstance(e, (BaseSSLError, CertificateError)):
-                e = SSLError(e)
-            elif isinstance(e, (SocketError, NewConnectionError)) and self.proxy:
-                e = ProxyError("Cannot connect to proxy.", e)
-            elif isinstance(e, (SocketError, HTTPException)):
-                e = ProtocolError("Connection aborted.", e)
+            new_e: Exception = e
+            if isinstance(e, (BaseSSLError, CertificateError)):
+                new_e = SSLError(e)
+            if isinstance(
+                new_e,
+                (
+                    OSError,
+                    NewConnectionError,
+                    TimeoutError,
+                    SSLError,
+                    HTTPException,
+                ),
+            ) and (conn and conn.proxy and not conn.has_connected_to_proxy):
+                new_e = _wrap_proxy_error(new_e, conn.proxy.scheme)
+            elif isinstance(new_e, (OSError, HTTPException)):
+                new_e = ProtocolError("Connection aborted.", new_e)
 
             retries = retries.increment(
-                method, url, error=e, _pool=self, _stacktrace=sys.exc_info()[2]
+                method, url, error=new_e, _pool=self, _stacktrace=sys.exc_info()[2]
             )
             retries.sleep()
 
@@ -798,7 +855,9 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
                 # to throw the connection away unless explicitly told not to.
                 # Close the connection, set the variable to None, and make sure
                 # we put the None back in the pool to avoid leaking it.
-                conn = conn and conn.close()
+                if conn:
+                    conn.close()
+                    conn = None
                 release_this_conn = True
 
             if release_this_conn:
@@ -825,7 +884,9 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
                 release_conn=release_conn,
                 chunked=chunked,
                 body_pos=body_pos,
-                **response_kw
+                preload_content=preload_content,
+                decode_content=decode_content,
+                **response_kw,
             )
 
         # Handle redirect?
@@ -858,7 +919,9 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
                 release_conn=release_conn,
                 chunked=chunked,
                 body_pos=body_pos,
-                **response_kw
+                preload_content=preload_content,
+                decode_content=decode_content,
+                **response_kw,
             )
 
         # Check if we should retry the HTTP response.
@@ -888,7 +951,9 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
                 release_conn=release_conn,
                 chunked=chunked,
                 body_pos=body_pos,
-                **response_kw
+                preload_content=preload_content,
+                decode_content=decode_content,
+                **response_kw,
             )
 
         return response
@@ -909,37 +974,35 @@ class HTTPSConnectionPool(HTTPConnectionPool):
     """
 
     scheme = "https"
-    ConnectionCls = HTTPSConnection
+    ConnectionCls: type[BaseHTTPSConnection] = HTTPSConnection
 
     def __init__(
         self,
-        host,
-        port=None,
-        strict=False,
-        timeout=Timeout.DEFAULT_TIMEOUT,
-        maxsize=1,
-        block=False,
-        headers=None,
-        retries=None,
-        _proxy=None,
-        _proxy_headers=None,
-        key_file=None,
-        cert_file=None,
-        cert_reqs=None,
-        key_password=None,
-        ca_certs=None,
-        ssl_version=None,
-        assert_hostname=None,
-        assert_fingerprint=None,
-        ca_cert_dir=None,
-        **conn_kw
-    ):
-
-        HTTPConnectionPool.__init__(
-            self,
+        host: str,
+        port: int | None = None,
+        timeout: _TYPE_TIMEOUT | None = _DEFAULT_TIMEOUT,
+        maxsize: int = 1,
+        block: bool = False,
+        headers: typing.Mapping[str, str] | None = None,
+        retries: Retry | bool | int | None = None,
+        _proxy: Url | None = None,
+        _proxy_headers: typing.Mapping[str, str] | None = None,
+        key_file: str | None = None,
+        cert_file: str | None = None,
+        cert_reqs: int | str | None = None,
+        key_password: str | None = None,
+        ca_certs: str | None = None,
+        ssl_version: int | str | None = None,
+        ssl_minimum_version: ssl.TLSVersion | None = None,
+        ssl_maximum_version: ssl.TLSVersion | None = None,
+        assert_hostname: str | Literal[False] | None = None,
+        assert_fingerprint: str | None = None,
+        ca_cert_dir: str | None = None,
+        **conn_kw: typing.Any,
+    ) -> None:
+        super().__init__(
             host,
             port,
-            strict,
             timeout,
             maxsize,
             block,
@@ -947,7 +1010,7 @@ class HTTPSConnectionPool(HTTPConnectionPool):
             retries,
             _proxy,
             _proxy_headers,
-            **conn_kw
+            **conn_kw,
         )
 
         self.key_file = key_file
@@ -957,47 +1020,29 @@ class HTTPSConnectionPool(HTTPConnectionPool):
         self.ca_certs = ca_certs
         self.ca_cert_dir = ca_cert_dir
         self.ssl_version = ssl_version
+        self.ssl_minimum_version = ssl_minimum_version
+        self.ssl_maximum_version = ssl_maximum_version
         self.assert_hostname = assert_hostname
         self.assert_fingerprint = assert_fingerprint
 
-    def _prepare_conn(self, conn):
-        """
-        Prepare the ``connection`` for :meth:`urllib3.util.ssl_wrap_socket`
-        and establish the tunnel if proxy is used.
-        """
-
-        if isinstance(conn, VerifiedHTTPSConnection):
-            conn.set_cert(
-                key_file=self.key_file,
-                key_password=self.key_password,
-                cert_file=self.cert_file,
-                cert_reqs=self.cert_reqs,
-                ca_certs=self.ca_certs,
-                ca_cert_dir=self.ca_cert_dir,
-                assert_hostname=self.assert_hostname,
-                assert_fingerprint=self.assert_fingerprint,
-            )
-            conn.ssl_version = self.ssl_version
-        return conn
-
-    def _prepare_proxy(self, conn):
-        """
-        Establishes a tunnel connection through HTTP CONNECT.
-
-        Tunnel connection is established early because otherwise httplib would
-        improperly set Host: header to proxy's IP:port.
-        """
-
-        conn.set_tunnel(self._proxy_host, self.port, self.proxy_headers)
-
-        if self.proxy.scheme == "https":
-            conn.tls_in_tls_required = True
+    def _prepare_proxy(self, conn: HTTPSConnection) -> None:  # type: ignore[override]
+        """Establishes a tunnel connection through HTTP CONNECT."""
+        if self.proxy and self.proxy.scheme == "https":
+            tunnel_scheme = "https"
+        else:
+            tunnel_scheme = "http"
 
+        conn.set_tunnel(
+            scheme=tunnel_scheme,
+            host=self._tunnel_host,
+            port=self.port,
+            headers=self.proxy_headers,
+        )
         conn.connect()
 
-    def _new_conn(self):
+    def _new_conn(self) -> BaseHTTPSConnection:
         """
-        Return a fresh :class:`http.client.HTTPSConnection`.
+        Return a fresh :class:`urllib3.connection.HTTPConnection`.
         """
         self.num_connections += 1
         log.debug(
@@ -1007,64 +1052,58 @@ class HTTPSConnectionPool(HTTPConnectionPool):
             self.port or "443",
         )
 
-        if not self.ConnectionCls or self.ConnectionCls is DummyConnection:
-            raise SSLError(
+        if not self.ConnectionCls or self.ConnectionCls is DummyConnection:  # type: ignore[comparison-overlap]
+            raise ImportError(
                 "Can't connect to HTTPS URL because the SSL module is not available."
             )
 
-        actual_host = self.host
+        actual_host: str = self.host
         actual_port = self.port
-        if self.proxy is not None:
+        if self.proxy is not None and self.proxy.host is not None:
             actual_host = self.proxy.host
             actual_port = self.proxy.port
 
-        conn = self.ConnectionCls(
+        return self.ConnectionCls(
             host=actual_host,
             port=actual_port,
             timeout=self.timeout.connect_timeout,
-            strict=self.strict,
             cert_file=self.cert_file,
             key_file=self.key_file,
             key_password=self.key_password,
-            **self.conn_kw
+            cert_reqs=self.cert_reqs,
+            ca_certs=self.ca_certs,
+            ca_cert_dir=self.ca_cert_dir,
+            assert_hostname=self.assert_hostname,
+            assert_fingerprint=self.assert_fingerprint,
+            ssl_version=self.ssl_version,
+            ssl_minimum_version=self.ssl_minimum_version,
+            ssl_maximum_version=self.ssl_maximum_version,
+            **self.conn_kw,
         )
 
-        return self._prepare_conn(conn)
-
-    def _validate_conn(self, conn):
+    def _validate_conn(self, conn: BaseHTTPConnection) -> None:
         """
         Called right before a request is made, after the socket is created.
         """
-        super(HTTPSConnectionPool, self)._validate_conn(conn)
+        super()._validate_conn(conn)
 
         # Force connect early to allow us to validate the connection.
-        if not getattr(conn, "sock", None):  # AppEngine might not have  `.sock`
+        if conn.is_closed:
             conn.connect()
 
         if not conn.is_verified:
             warnings.warn(
                 (
-                    "Unverified HTTPS request is being made to host '%s'. "
+                    f"Unverified HTTPS request is being made to host '{conn.host}'. "
                     "Adding certificate verification is strongly advised. See: "
-                    "https://urllib3.readthedocs.io/en/1.26.x/advanced-usage.html"
-                    "#ssl-warnings" % conn.host
-                ),
-                InsecureRequestWarning,
-            )
-
-        if getattr(conn, "proxy_is_verified", None) is False:
-            warnings.warn(
-                (
-                    "Unverified HTTPS connection done to an HTTPS proxy. "
-                    "Adding certificate verification is strongly advised. See: "
-                    "https://urllib3.readthedocs.io/en/1.26.x/advanced-usage.html"
-                    "#ssl-warnings"
+                    "https://urllib3.readthedocs.io/en/latest/advanced-usage.html"
+                    "#tls-warnings"
                 ),
                 InsecureRequestWarning,
             )
 
 
-def connection_from_url(url, **kw):
+def connection_from_url(url: str, **kw: typing.Any) -> HTTPConnectionPool:
     """
     Given a url, return an :class:`.ConnectionPool` instance of its host.
 
@@ -1084,15 +1123,26 @@ def connection_from_url(url, **kw):
         >>> conn = connection_from_url('http://google.com/')
         >>> r = conn.request('GET', '/')
     """
-    scheme, host, port = get_host(url)
+    scheme, _, host, port, *_ = parse_url(url)
+    scheme = scheme or "http"
     port = port or port_by_scheme.get(scheme, 80)
     if scheme == "https":
-        return HTTPSConnectionPool(host, port=port, **kw)
+        return HTTPSConnectionPool(host, port=port, **kw)  # type: ignore[arg-type]
     else:
-        return HTTPConnectionPool(host, port=port, **kw)
+        return HTTPConnectionPool(host, port=port, **kw)  # type: ignore[arg-type]
 
 
-def _normalize_host(host, scheme):
+@typing.overload
+def _normalize_host(host: None, scheme: str | None) -> None:
+    ...
+
+
+@typing.overload
+def _normalize_host(host: str, scheme: str | None) -> str:
+    ...
+
+
+def _normalize_host(host: str | None, scheme: str | None) -> str | None:
     """
     Normalize hosts for comparisons and use with sockets.
     """
@@ -1105,6 +1155,24 @@ def _normalize_host(host, scheme):
     # Instead, we need to make sure we never pass ``None`` as the port.
     # However, for backward compatibility reasons we can't actually
     # *assert* that.  See http://bugs.python.org/issue28539
-    if host.startswith("[") and host.endswith("]"):
+    if host and host.startswith("[") and host.endswith("]"):
         host = host[1:-1]
     return host
+
+
+def _url_from_pool(
+    pool: HTTPConnectionPool | HTTPSConnectionPool, path: str | None = None
+) -> str:
+    """Returns the URL from a given connection pool. This is mainly used for testing and logging."""
+    return Url(scheme=pool.scheme, host=pool.host, port=pool.port, path=path).url
+
+
+def _close_pool_connections(pool: queue.LifoQueue[typing.Any]) -> None:
+    """Drains a queue of connections and closes each one."""
+    try:
+        while True:
+            conn = pool.get(block=False)
+            if conn:
+                conn.close()
+    except queue.Empty:
+        pass  # Done.
diff --git a/lib/urllib3/contrib/_appengine_environ.py b/lib/urllib3/contrib/_appengine_environ.py
deleted file mode 100644
index 8765b907..00000000
--- a/lib/urllib3/contrib/_appengine_environ.py
+++ /dev/null
@@ -1,36 +0,0 @@
-"""
-This module provides means to detect the App Engine environment.
-"""
-
-import os
-
-
-def is_appengine():
-    return is_local_appengine() or is_prod_appengine()
-
-
-def is_appengine_sandbox():
-    """Reports if the app is running in the first generation sandbox.
-
-    The second generation runtimes are technically still in a sandbox, but it
-    is much less restrictive, so generally you shouldn't need to check for it.
-    see https://cloud.google.com/appengine/docs/standard/runtimes
-    """
-    return is_appengine() and os.environ["APPENGINE_RUNTIME"] == "python27"
-
-
-def is_local_appengine():
-    return "APPENGINE_RUNTIME" in os.environ and os.environ.get(
-        "SERVER_SOFTWARE", ""
-    ).startswith("Development/")
-
-
-def is_prod_appengine():
-    return "APPENGINE_RUNTIME" in os.environ and os.environ.get(
-        "SERVER_SOFTWARE", ""
-    ).startswith("Google App Engine/")
-
-
-def is_prod_appengine_mvms():
-    """Deprecated."""
-    return False
diff --git a/lib/urllib3/contrib/_securetransport/bindings.py b/lib/urllib3/contrib/_securetransport/bindings.py
index 264d564d..3e4cd466 100644
--- a/lib/urllib3/contrib/_securetransport/bindings.py
+++ b/lib/urllib3/contrib/_securetransport/bindings.py
@@ -1,3 +1,5 @@
+# type: ignore
+
 """
 This module uses ctypes to bind a whole bunch of functions and constants from
 SecureTransport. The goal here is to provide the low-level API to
@@ -29,7 +31,8 @@ license and by oscrypto's:
     FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
     DEALINGS IN THE SOFTWARE.
 """
-from __future__ import absolute_import
+
+from __future__ import annotations
 
 import platform
 from ctypes import (
@@ -48,8 +51,6 @@ from ctypes import (
 )
 from ctypes.util import find_library
 
-from ...packages.six import raise_from
-
 if platform.system() != "Darwin":
     raise ImportError("Only macOS is supported")
 
@@ -57,16 +58,16 @@ version = platform.mac_ver()[0]
 version_info = tuple(map(int, version.split(".")))
 if version_info < (10, 8):
     raise OSError(
-        "Only OS X 10.8 and newer are supported, not %s.%s"
-        % (version_info[0], version_info[1])
+        f"Only OS X 10.8 and newer are supported, not {version_info[0]}.{version_info[1]}"
     )
 
 
-def load_cdll(name, macos10_16_path):
+def load_cdll(name: str, macos10_16_path: str) -> CDLL:
     """Loads a CDLL by name, falling back to known path on 10.16+"""
     try:
         # Big Sur is technically 11 but we use 10.16 due to the Big Sur
         # beta being labeled as 10.16.
+        path: str | None
         if version_info >= (10, 16):
             path = macos10_16_path
         else:
@@ -75,7 +76,7 @@ def load_cdll(name, macos10_16_path):
             raise OSError  # Caught and reraised as 'ImportError'
         return CDLL(path, use_errno=True)
     except OSError:
-        raise_from(ImportError("The library %s failed to load" % name), None)
+        raise ImportError(f"The library {name} failed to load") from None
 
 
 Security = load_cdll(
@@ -416,104 +417,14 @@ try:
     CoreFoundation.CFStringRef = CFStringRef
     CoreFoundation.CFDictionaryRef = CFDictionaryRef
 
-except (AttributeError):
-    raise ImportError("Error initializing ctypes")
+except AttributeError:
+    raise ImportError("Error initializing ctypes") from None
 
 
-class CFConst(object):
+class CFConst:
     """
     A class object that acts as essentially a namespace for CoreFoundation
     constants.
     """
 
     kCFStringEncodingUTF8 = CFStringEncoding(0x08000100)
-
-
-class SecurityConst(object):
-    """
-    A class object that acts as essentially a namespace for Security constants.
-    """
-
-    kSSLSessionOptionBreakOnServerAuth = 0
-
-    kSSLProtocol2 = 1
-    kSSLProtocol3 = 2
-    kTLSProtocol1 = 4
-    kTLSProtocol11 = 7
-    kTLSProtocol12 = 8
-    # SecureTransport does not support TLS 1.3 even if there's a constant for it
-    kTLSProtocol13 = 10
-    kTLSProtocolMaxSupported = 999
-
-    kSSLClientSide = 1
-    kSSLStreamType = 0
-
-    kSecFormatPEMSequence = 10
-
-    kSecTrustResultInvalid = 0
-    kSecTrustResultProceed = 1
-    # This gap is present on purpose: this was kSecTrustResultConfirm, which
-    # is deprecated.
-    kSecTrustResultDeny = 3
-    kSecTrustResultUnspecified = 4
-    kSecTrustResultRecoverableTrustFailure = 5
-    kSecTrustResultFatalTrustFailure = 6
-    kSecTrustResultOtherError = 7
-
-    errSSLProtocol = -9800
-    errSSLWouldBlock = -9803
-    errSSLClosedGraceful = -9805
-    errSSLClosedNoNotify = -9816
-    errSSLClosedAbort = -9806
-
-    errSSLXCertChainInvalid = -9807
-    errSSLCrypto = -9809
-    errSSLInternal = -9810
-    errSSLCertExpired = -9814
-    errSSLCertNotYetValid = -9815
-    errSSLUnknownRootCert = -9812
-    errSSLNoRootCert = -9813
-    errSSLHostNameMismatch = -9843
-    errSSLPeerHandshakeFail = -9824
-    errSSLPeerUserCancelled = -9839
-    errSSLWeakPeerEphemeralDHKey = -9850
-    errSSLServerAuthCompleted = -9841
-    errSSLRecordOverflow = -9847
-
-    errSecVerifyFailed = -67808
-    errSecNoTrustSettings = -25263
-    errSecItemNotFound = -25300
-    errSecInvalidTrustSettings = -25262
-
-    # Cipher suites. We only pick the ones our default cipher string allows.
-    # Source: https://developer.apple.com/documentation/security/1550981-ssl_cipher_suite_values
-    TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384 = 0xC02C
-    TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 = 0xC030
-    TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256 = 0xC02B
-    TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 = 0xC02F
-    TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256 = 0xCCA9
-    TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256 = 0xCCA8
-    TLS_DHE_RSA_WITH_AES_256_GCM_SHA384 = 0x009F
-    TLS_DHE_RSA_WITH_AES_128_GCM_SHA256 = 0x009E
-    TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384 = 0xC024
-    TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384 = 0xC028
-    TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA = 0xC00A
-    TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA = 0xC014
-    TLS_DHE_RSA_WITH_AES_256_CBC_SHA256 = 0x006B
-    TLS_DHE_RSA_WITH_AES_256_CBC_SHA = 0x0039
-    TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256 = 0xC023
-    TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256 = 0xC027
-    TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA = 0xC009
-    TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA = 0xC013
-    TLS_DHE_RSA_WITH_AES_128_CBC_SHA256 = 0x0067
-    TLS_DHE_RSA_WITH_AES_128_CBC_SHA = 0x0033
-    TLS_RSA_WITH_AES_256_GCM_SHA384 = 0x009D
-    TLS_RSA_WITH_AES_128_GCM_SHA256 = 0x009C
-    TLS_RSA_WITH_AES_256_CBC_SHA256 = 0x003D
-    TLS_RSA_WITH_AES_128_CBC_SHA256 = 0x003C
-    TLS_RSA_WITH_AES_256_CBC_SHA = 0x0035
-    TLS_RSA_WITH_AES_128_CBC_SHA = 0x002F
-    TLS_AES_128_GCM_SHA256 = 0x1301
-    TLS_AES_256_GCM_SHA384 = 0x1302
-    TLS_AES_128_CCM_8_SHA256 = 0x1305
-    TLS_AES_128_CCM_SHA256 = 0x1304
diff --git a/lib/urllib3/contrib/_securetransport/low_level.py b/lib/urllib3/contrib/_securetransport/low_level.py
index fa0b245d..e2356997 100644
--- a/lib/urllib3/contrib/_securetransport/low_level.py
+++ b/lib/urllib3/contrib/_securetransport/low_level.py
@@ -7,6 +7,8 @@ CoreFoundation messing about and memory management. The concerns in this module
 are almost entirely about trying to avoid memory leaks and providing
 appropriate and useful assistance to the higher-level code.
 """
+from __future__ import annotations
+
 import base64
 import ctypes
 import itertools
@@ -15,8 +17,20 @@ import re
 import ssl
 import struct
 import tempfile
+import typing
 
-from .bindings import CFConst, CoreFoundation, Security
+from .bindings import (  # type: ignore[attr-defined]
+    CFArray,
+    CFConst,
+    CFData,
+    CFDictionary,
+    CFMutableArray,
+    CFString,
+    CFTypeRef,
+    CoreFoundation,
+    SecKeychainRef,
+    Security,
+)
 
 # This regular expression is used to grab PEM data out of a PEM bundle.
 _PEM_CERTS_RE = re.compile(
@@ -24,7 +38,7 @@ _PEM_CERTS_RE = re.compile(
 )
 
 
-def _cf_data_from_bytes(bytestring):
+def _cf_data_from_bytes(bytestring: bytes) -> CFData:
     """
     Given a bytestring, create a CFData object from it. This CFData object must
     be CFReleased by the caller.
@@ -34,7 +48,9 @@ def _cf_data_from_bytes(bytestring):
     )
 
 
-def _cf_dictionary_from_tuples(tuples):
+def _cf_dictionary_from_tuples(
+    tuples: list[tuple[typing.Any, typing.Any]]
+) -> CFDictionary:
     """
     Given a list of Python tuples, create an associated CFDictionary.
     """
@@ -56,7 +72,7 @@ def _cf_dictionary_from_tuples(tuples):
     )
 
 
-def _cfstr(py_bstr):
+def _cfstr(py_bstr: bytes) -> CFString:
     """
     Given a Python binary data, create a CFString.
     The string must be CFReleased by the caller.
@@ -70,7 +86,7 @@ def _cfstr(py_bstr):
     return cf_str
 
 
-def _create_cfstring_array(lst):
+def _create_cfstring_array(lst: list[bytes]) -> CFMutableArray:
     """
     Given a list of Python binary data, create an associated CFMutableArray.
     The array must be CFReleased by the caller.
@@ -97,11 +113,11 @@ def _create_cfstring_array(lst):
     except BaseException as e:
         if cf_arr:
             CoreFoundation.CFRelease(cf_arr)
-        raise ssl.SSLError("Unable to allocate array: %s" % (e,))
+        raise ssl.SSLError(f"Unable to allocate array: {e}") from None
     return cf_arr
 
 
-def _cf_string_to_unicode(value):
+def _cf_string_to_unicode(value: CFString) -> str | None:
     """
     Creates a Unicode string from a CFString object. Used entirely for error
     reporting.
@@ -123,10 +139,12 @@ def _cf_string_to_unicode(value):
         string = buffer.value
     if string is not None:
         string = string.decode("utf-8")
-    return string
+    return string  # type: ignore[no-any-return]
 
 
-def _assert_no_error(error, exception_class=None):
+def _assert_no_error(
+    error: int, exception_class: type[BaseException] | None = None
+) -> None:
     """
     Checks the return code and throws an exception if there is an error to
     report
@@ -138,8 +156,8 @@ def _assert_no_error(error, exception_class=None):
     output = _cf_string_to_unicode(cf_error_string)
     CoreFoundation.CFRelease(cf_error_string)
 
-    if output is None or output == u"":
-        output = u"OSStatus %s" % error
+    if output is None or output == "":
+        output = f"OSStatus {error}"
 
     if exception_class is None:
         exception_class = ssl.SSLError
@@ -147,7 +165,7 @@ def _assert_no_error(error, exception_class=None):
     raise exception_class(output)
 
 
-def _cert_array_from_pem(pem_bundle):
+def _cert_array_from_pem(pem_bundle: bytes) -> CFArray:
     """
     Given a bundle of certs in PEM format, turns them into a CFArray of certs
     that can be used to validate a cert chain.
@@ -193,23 +211,23 @@ def _cert_array_from_pem(pem_bundle):
     return cert_array
 
 
-def _is_cert(item):
+def _is_cert(item: CFTypeRef) -> bool:
     """
     Returns True if a given CFTypeRef is a certificate.
     """
     expected = Security.SecCertificateGetTypeID()
-    return CoreFoundation.CFGetTypeID(item) == expected
+    return CoreFoundation.CFGetTypeID(item) == expected  # type: ignore[no-any-return]
 
 
-def _is_identity(item):
+def _is_identity(item: CFTypeRef) -> bool:
     """
     Returns True if a given CFTypeRef is an identity.
     """
     expected = Security.SecIdentityGetTypeID()
-    return CoreFoundation.CFGetTypeID(item) == expected
+    return CoreFoundation.CFGetTypeID(item) == expected  # type: ignore[no-any-return]
 
 
-def _temporary_keychain():
+def _temporary_keychain() -> tuple[SecKeychainRef, str]:
     """
     This function creates a temporary Mac keychain that we can use to work with
     credentials. This keychain uses a one-time password and a temporary file to
@@ -244,7 +262,9 @@ def _temporary_keychain():
     return keychain, tempdirectory
 
 
-def _load_items_from_file(keychain, path):
+def _load_items_from_file(
+    keychain: SecKeychainRef, path: str
+) -> tuple[list[CFTypeRef], list[CFTypeRef]]:
     """
     Given a single file, loads all the trust objects from it into arrays and
     the keychain.
@@ -299,7 +319,7 @@ def _load_items_from_file(keychain, path):
     return (identities, certificates)
 
 
-def _load_client_cert_chain(keychain, *paths):
+def _load_client_cert_chain(keychain: SecKeychainRef, *paths: str | None) -> CFArray:
     """
     Load certificates and maybe keys from a number of files. Has the end goal
     of returning a CFArray containing one SecIdentityRef, and then zero or more
@@ -335,10 +355,10 @@ def _load_client_cert_chain(keychain, *paths):
     identities = []
 
     # Filter out bad paths.
-    paths = (path for path in paths if path)
+    filtered_paths = (path for path in paths if path)
 
     try:
-        for file_path in paths:
+        for file_path in filtered_paths:
             new_identities, new_certs = _load_items_from_file(keychain, file_path)
             identities.extend(new_identities)
             certificates.extend(new_certs)
@@ -383,7 +403,7 @@ TLS_PROTOCOL_VERSIONS = {
 }
 
 
-def _build_tls_unknown_ca_alert(version):
+def _build_tls_unknown_ca_alert(version: str) -> bytes:
     """
     Builds a TLS alert record for an unknown CA.
     """
@@ -395,3 +415,60 @@ def _build_tls_unknown_ca_alert(version):
     record_type_alert = 0x15
     record = struct.pack(">BBBH", record_type_alert, ver_maj, ver_min, msg_len) + msg
     return record
+
+
+class SecurityConst:
+    """
+    A class object that acts as essentially a namespace for Security constants.
+    """
+
+    kSSLSessionOptionBreakOnServerAuth = 0
+
+    kSSLProtocol2 = 1
+    kSSLProtocol3 = 2
+    kTLSProtocol1 = 4
+    kTLSProtocol11 = 7
+    kTLSProtocol12 = 8
+    # SecureTransport does not support TLS 1.3 even if there's a constant for it
+    kTLSProtocol13 = 10
+    kTLSProtocolMaxSupported = 999
+
+    kSSLClientSide = 1
+    kSSLStreamType = 0
+
+    kSecFormatPEMSequence = 10
+
+    kSecTrustResultInvalid = 0
+    kSecTrustResultProceed = 1
+    # This gap is present on purpose: this was kSecTrustResultConfirm, which
+    # is deprecated.
+    kSecTrustResultDeny = 3
+    kSecTrustResultUnspecified = 4
+    kSecTrustResultRecoverableTrustFailure = 5
+    kSecTrustResultFatalTrustFailure = 6
+    kSecTrustResultOtherError = 7
+
+    errSSLProtocol = -9800
+    errSSLWouldBlock = -9803
+    errSSLClosedGraceful = -9805
+    errSSLClosedNoNotify = -9816
+    errSSLClosedAbort = -9806
+
+    errSSLXCertChainInvalid = -9807
+    errSSLCrypto = -9809
+    errSSLInternal = -9810
+    errSSLCertExpired = -9814
+    errSSLCertNotYetValid = -9815
+    errSSLUnknownRootCert = -9812
+    errSSLNoRootCert = -9813
+    errSSLHostNameMismatch = -9843
+    errSSLPeerHandshakeFail = -9824
+    errSSLPeerUserCancelled = -9839
+    errSSLWeakPeerEphemeralDHKey = -9850
+    errSSLServerAuthCompleted = -9841
+    errSSLRecordOverflow = -9847
+
+    errSecVerifyFailed = -67808
+    errSecNoTrustSettings = -25263
+    errSecItemNotFound = -25300
+    errSecInvalidTrustSettings = -25262
diff --git a/lib/urllib3/contrib/appengine.py b/lib/urllib3/contrib/appengine.py
deleted file mode 100644
index a5a6d910..00000000
--- a/lib/urllib3/contrib/appengine.py
+++ /dev/null
@@ -1,314 +0,0 @@
-"""
-This module provides a pool manager that uses Google App Engine's
-`URLFetch Service <https://cloud.google.com/appengine/docs/python/urlfetch>`_.
-
-Example usage::
-
-    from urllib3 import PoolManager
-    from urllib3.contrib.appengine import AppEngineManager, is_appengine_sandbox
-
-    if is_appengine_sandbox():
-        # AppEngineManager uses AppEngine's URLFetch API behind the scenes
-        http = AppEngineManager()
-    else:
-        # PoolManager uses a socket-level API behind the scenes
-        http = PoolManager()
-
-    r = http.request('GET', 'https://google.com/')
-
-There are `limitations <https://cloud.google.com/appengine/docs/python/\
-urlfetch/#Python_Quotas_and_limits>`_ to the URLFetch service and it may not be
-the best choice for your application. There are three options for using
-urllib3 on Google App Engine:
-
-1. You can use :class:`AppEngineManager` with URLFetch. URLFetch is
-   cost-effective in many circumstances as long as your usage is within the
-   limitations.
-2. You can use a normal :class:`~urllib3.PoolManager` by enabling sockets.
-   Sockets also have `limitations and restrictions
-   <https://cloud.google.com/appengine/docs/python/sockets/\
-   #limitations-and-restrictions>`_ and have a lower free quota than URLFetch.
-   To use sockets, be sure to specify the following in your ``app.yaml``::
-
-        env_variables:
-            GAE_USE_SOCKETS_HTTPLIB : 'true'
-
-3. If you are using `App Engine Flexible
-<https://cloud.google.com/appengine/docs/flexible/>`_, you can use the standard
-:class:`PoolManager` without any configuration or special environment variables.
-"""
-
-from __future__ import absolute_import
-
-import io
-import logging
-import warnings
-
-from ..exceptions import (
-    HTTPError,
-    HTTPWarning,
-    MaxRetryError,
-    ProtocolError,
-    SSLError,
-    TimeoutError,
-)
-from ..packages.six.moves.urllib.parse import urljoin
-from ..request import RequestMethods
-from ..response import HTTPResponse
-from ..util.retry import Retry
-from ..util.timeout import Timeout
-from . import _appengine_environ
-
-try:
-    from google.appengine.api import urlfetch
-except ImportError:
-    urlfetch = None
-
-
-log = logging.getLogger(__name__)
-
-
-class AppEnginePlatformWarning(HTTPWarning):
-    pass
-
-
-class AppEnginePlatformError(HTTPError):
-    pass
-
-
-class AppEngineManager(RequestMethods):
-    """
-    Connection manager for Google App Engine sandbox applications.
-
-    This manager uses the URLFetch service directly instead of using the
-    emulated httplib, and is subject to URLFetch limitations as described in
-    the App Engine documentation `here
-    <https://cloud.google.com/appengine/docs/python/urlfetch>`_.
-
-    Notably it will raise an :class:`AppEnginePlatformError` if:
-        * URLFetch is not available.
-        * If you attempt to use this on App Engine Flexible, as full socket
-          support is available.
-        * If a request size is more than 10 megabytes.
-        * If a response size is more than 32 megabytes.
-        * If you use an unsupported request method such as OPTIONS.
-
-    Beyond those cases, it will raise normal urllib3 errors.
-    """
-
-    def __init__(
-        self,
-        headers=None,
-        retries=None,
-        validate_certificate=True,
-        urlfetch_retries=True,
-    ):
-        if not urlfetch:
-            raise AppEnginePlatformError(
-                "URLFetch is not available in this environment."
-            )
-
-        warnings.warn(
-            "urllib3 is using URLFetch on Google App Engine sandbox instead "
-            "of sockets. To use sockets directly instead of URLFetch see "
-            "https://urllib3.readthedocs.io/en/1.26.x/reference/urllib3.contrib.html.",
-            AppEnginePlatformWarning,
-        )
-
-        RequestMethods.__init__(self, headers)
-        self.validate_certificate = validate_certificate
-        self.urlfetch_retries = urlfetch_retries
-
-        self.retries = retries or Retry.DEFAULT
-
-    def __enter__(self):
-        return self
-
-    def __exit__(self, exc_type, exc_val, exc_tb):
-        # Return False to re-raise any potential exceptions
-        return False
-
-    def urlopen(
-        self,
-        method,
-        url,
-        body=None,
-        headers=None,
-        retries=None,
-        redirect=True,
-        timeout=Timeout.DEFAULT_TIMEOUT,
-        **response_kw
-    ):
-
-        retries = self._get_retries(retries, redirect)
-
-        try:
-            follow_redirects = redirect and retries.redirect != 0 and retries.total
-            response = urlfetch.fetch(
-                url,
-                payload=body,
-                method=method,
-                headers=headers or {},
-                allow_truncated=False,
-                follow_redirects=self.urlfetch_retries and follow_redirects,
-                deadline=self._get_absolute_timeout(timeout),
-                validate_certificate=self.validate_certificate,
-            )
-        except urlfetch.DeadlineExceededError as e:
-            raise TimeoutError(self, e)
-
-        except urlfetch.InvalidURLError as e:
-            if "too large" in str(e):
-                raise AppEnginePlatformError(
-                    "URLFetch request too large, URLFetch only "
-                    "supports requests up to 10mb in size.",
-                    e,
-                )
-            raise ProtocolError(e)
-
-        except urlfetch.DownloadError as e:
-            if "Too many redirects" in str(e):
-                raise MaxRetryError(self, url, reason=e)
-            raise ProtocolError(e)
-
-        except urlfetch.ResponseTooLargeError as e:
-            raise AppEnginePlatformError(
-                "URLFetch response too large, URLFetch only supports"
-                "responses up to 32mb in size.",
-                e,
-            )
-
-        except urlfetch.SSLCertificateError as e:
-            raise SSLError(e)
-
-        except urlfetch.InvalidMethodError as e:
-            raise AppEnginePlatformError(
-                "URLFetch does not support method: %s" % method, e
-            )
-
-        http_response = self._urlfetch_response_to_http_response(
-            response, retries=retries, **response_kw
-        )
-
-        # Handle redirect?
-        redirect_location = redirect and http_response.get_redirect_location()
-        if redirect_location:
-            # Check for redirect response
-            if self.urlfetch_retries and retries.raise_on_redirect:
-                raise MaxRetryError(self, url, "too many redirects")
-            else:
-                if http_response.status == 303:
-                    method = "GET"
-
-                try:
-                    retries = retries.increment(
-                        method, url, response=http_response, _pool=self
-                    )
-                except MaxRetryError:
-                    if retries.raise_on_redirect:
-                        raise MaxRetryError(self, url, "too many redirects")
-                    return http_response
-
-                retries.sleep_for_retry(http_response)
-                log.debug("Redirecting %s -> %s", url, redirect_location)
-                redirect_url = urljoin(url, redirect_location)
-                return self.urlopen(
-                    method,
-                    redirect_url,
-                    body,
-                    headers,
-                    retries=retries,
-                    redirect=redirect,
-                    timeout=timeout,
-                    **response_kw
-                )
-
-        # Check if we should retry the HTTP response.
-        has_retry_after = bool(http_response.headers.get("Retry-After"))
-        if retries.is_retry(method, http_response.status, has_retry_after):
-            retries = retries.increment(method, url, response=http_response, _pool=self)
-            log.debug("Retry: %s", url)
-            retries.sleep(http_response)
-            return self.urlopen(
-                method,
-                url,
-                body=body,
-                headers=headers,
-                retries=retries,
-                redirect=redirect,
-                timeout=timeout,
-                **response_kw
-            )
-
-        return http_response
-
-    def _urlfetch_response_to_http_response(self, urlfetch_resp, **response_kw):
-
-        if is_prod_appengine():
-            # Production GAE handles deflate encoding automatically, but does
-            # not remove the encoding header.
-            content_encoding = urlfetch_resp.headers.get("content-encoding")
-
-            if content_encoding == "deflate":
-                del urlfetch_resp.headers["content-encoding"]
-
-        transfer_encoding = urlfetch_resp.headers.get("transfer-encoding")
-        # We have a full response's content,
-        # so let's make sure we don't report ourselves as chunked data.
-        if transfer_encoding == "chunked":
-            encodings = transfer_encoding.split(",")
-            encodings.remove("chunked")
-            urlfetch_resp.headers["transfer-encoding"] = ",".join(encodings)
-
-        original_response = HTTPResponse(
-            # In order for decoding to work, we must present the content as
-            # a file-like object.
-            body=io.BytesIO(urlfetch_resp.content),
-            msg=urlfetch_resp.header_msg,
-            headers=urlfetch_resp.headers,
-            status=urlfetch_resp.status_code,
-            **response_kw
-        )
-
-        return HTTPResponse(
-            body=io.BytesIO(urlfetch_resp.content),
-            headers=urlfetch_resp.headers,
-            status=urlfetch_resp.status_code,
-            original_response=original_response,
-            **response_kw
-        )
-
-    def _get_absolute_timeout(self, timeout):
-        if timeout is Timeout.DEFAULT_TIMEOUT:
-            return None  # Defer to URLFetch's default.
-        if isinstance(timeout, Timeout):
-            if timeout._read is not None or timeout._connect is not None:
-                warnings.warn(
-                    "URLFetch does not support granular timeout settings, "
-                    "reverting to total or default URLFetch timeout.",
-                    AppEnginePlatformWarning,
-                )
-            return timeout.total
-        return timeout
-
-    def _get_retries(self, retries, redirect):
-        if not isinstance(retries, Retry):
-            retries = Retry.from_int(retries, redirect=redirect, default=self.retries)
-
-        if retries.connect or retries.read or retries.redirect:
-            warnings.warn(
-                "URLFetch only supports total retries and does not "
-                "recognize connect, read, or redirect retry parameters.",
-                AppEnginePlatformWarning,
-            )
-
-        return retries
-
-
-# Alias methods from _appengine_environ to maintain public API interface.
-
-is_appengine = _appengine_environ.is_appengine
-is_appengine_sandbox = _appengine_environ.is_appengine_sandbox
-is_local_appengine = _appengine_environ.is_local_appengine
-is_prod_appengine = _appengine_environ.is_prod_appengine
-is_prod_appengine_mvms = _appengine_environ.is_prod_appengine_mvms
diff --git a/lib/urllib3/contrib/ntlmpool.py b/lib/urllib3/contrib/ntlmpool.py
deleted file mode 100644
index 47166575..00000000
--- a/lib/urllib3/contrib/ntlmpool.py
+++ /dev/null
@@ -1,130 +0,0 @@
-"""
-NTLM authenticating pool, contributed by erikcederstran
-
-Issue #10, see: http://code.google.com/p/urllib3/issues/detail?id=10
-"""
-from __future__ import absolute_import
-
-import warnings
-from logging import getLogger
-
-from ntlm import ntlm
-
-from .. import HTTPSConnectionPool
-from ..packages.six.moves.http_client import HTTPSConnection
-
-warnings.warn(
-    "The 'urllib3.contrib.ntlmpool' module is deprecated and will be removed "
-    "in urllib3 v2.0 release, urllib3 is not able to support it properly due "
-    "to reasons listed in issue: https://github.com/urllib3/urllib3/issues/2282. "
-    "If you are a user of this module please comment in the mentioned issue.",
-    DeprecationWarning,
-)
-
-log = getLogger(__name__)
-
-
-class NTLMConnectionPool(HTTPSConnectionPool):
-    """
-    Implements an NTLM authentication version of an urllib3 connection pool
-    """
-
-    scheme = "https"
-
-    def __init__(self, user, pw, authurl, *args, **kwargs):
-        """
-        authurl is a random URL on the server that is protected by NTLM.
-        user is the Windows user, probably in the DOMAIN\\username format.
-        pw is the password for the user.
-        """
-        super(NTLMConnectionPool, self).__init__(*args, **kwargs)
-        self.authurl = authurl
-        self.rawuser = user
-        user_parts = user.split("\\", 1)
-        self.domain = user_parts[0].upper()
-        self.user = user_parts[1]
-        self.pw = pw
-
-    def _new_conn(self):
-        # Performs the NTLM handshake that secures the connection. The socket
-        # must be kept open while requests are performed.
-        self.num_connections += 1
-        log.debug(
-            "Starting NTLM HTTPS connection no. %d: https://%s%s",
-            self.num_connections,
-            self.host,
-            self.authurl,
-        )
-
-        headers = {"Connection": "Keep-Alive"}
-        req_header = "Authorization"
-        resp_header = "www-authenticate"
-
-        conn = HTTPSConnection(host=self.host, port=self.port)
-
-        # Send negotiation message
-        headers[req_header] = "NTLM %s" % ntlm.create_NTLM_NEGOTIATE_MESSAGE(
-            self.rawuser
-        )
-        log.debug("Request headers: %s", headers)
-        conn.request("GET", self.authurl, None, headers)
-        res = conn.getresponse()
-        reshdr = dict(res.headers)
-        log.debug("Response status: %s %s", res.status, res.reason)
-        log.debug("Response headers: %s", reshdr)
-        log.debug("Response data: %s [...]", res.read(100))
-
-        # Remove the reference to the socket, so that it can not be closed by
-        # the response object (we want to keep the socket open)
-        res.fp = None
-
-        # Server should respond with a challenge message
-        auth_header_values = reshdr[resp_header].split(", ")
-        auth_header_value = None
-        for s in auth_header_values:
-            if s[:5] == "NTLM ":
-                auth_header_value = s[5:]
-        if auth_header_value is None:
-            raise Exception(
-                "Unexpected %s response header: %s" % (resp_header, reshdr[resp_header])
-            )
-
-        # Send authentication message
-        ServerChallenge, NegotiateFlags = ntlm.parse_NTLM_CHALLENGE_MESSAGE(
-            auth_header_value
-        )
-        auth_msg = ntlm.create_NTLM_AUTHENTICATE_MESSAGE(
-            ServerChallenge, self.user, self.domain, self.pw, NegotiateFlags
-        )
-        headers[req_header] = "NTLM %s" % auth_msg
-        log.debug("Request headers: %s", headers)
-        conn.request("GET", self.authurl, None, headers)
-        res = conn.getresponse()
-        log.debug("Response status: %s %s", res.status, res.reason)
-        log.debug("Response headers: %s", dict(res.headers))
-        log.debug("Response data: %s [...]", res.read()[:100])
-        if res.status != 200:
-            if res.status == 401:
-                raise Exception("Server rejected request: wrong username or password")
-            raise Exception("Wrong server response: %s %s" % (res.status, res.reason))
-
-        res.fp = None
-        log.debug("Connection established")
-        return conn
-
-    def urlopen(
-        self,
-        method,
-        url,
-        body=None,
-        headers=None,
-        retries=3,
-        redirect=True,
-        assert_same_host=True,
-    ):
-        if headers is None:
-            headers = {}
-        headers["Connection"] = "Keep-Alive"
-        return super(NTLMConnectionPool, self).urlopen(
-            method, url, body, headers, retries, redirect, assert_same_host
-        )
diff --git a/lib/urllib3/contrib/pyopenssl.py b/lib/urllib3/contrib/pyopenssl.py
index 1ed214b1..0089cd27 100644
--- a/lib/urllib3/contrib/pyopenssl.py
+++ b/lib/urllib3/contrib/pyopenssl.py
@@ -1,8 +1,8 @@
 """
-TLS with SNI_-support for Python 2. Follow these instructions if you would
-like to verify TLS certificates in Python 2. Note, the default libraries do
-*not* do certificate checking; you need to do additional work to validate
-certificates yourself.
+Module for using pyOpenSSL as a TLS backend. This module was relevant before
+the standard library ``ssl`` module supported SNI, but now that we've dropped
+support for Python 2.7 all relevant Python versions support SNI so
+**this module is no longer recommended**.
 
 This needs the following packages installed:
 
@@ -10,7 +10,7 @@ This needs the following packages installed:
 * `cryptography`_ (minimum 1.3.4, from pyopenssl)
 * `idna`_ (minimum 2.0, from cryptography)
 
-However, pyopenssl depends on cryptography, which depends on idna, so while we
+However, pyOpenSSL depends on cryptography, which depends on idna, so while we
 use all three directly here we end up having relatively few packages required.
 
 You can install them with the following command:
@@ -33,75 +33,55 @@ like this:
     except ImportError:
         pass
 
-Now you can use :mod:`urllib3` as you normally would, and it will support SNI
-when the required modules are installed.
-
-Activating this module also has the positive side effect of disabling SSL/TLS
-compression in Python 2 (see `CRIME attack`_).
-
-.. _sni: https://en.wikipedia.org/wiki/Server_Name_Indication
-.. _crime attack: https://en.wikipedia.org/wiki/CRIME_(security_exploit)
 .. _pyopenssl: https://www.pyopenssl.org
 .. _cryptography: https://cryptography.io
 .. _idna: https://github.com/kjd/idna
 """
-from __future__ import absolute_import
 
-import OpenSSL.crypto
-import OpenSSL.SSL
+from __future__ import annotations
+
+import OpenSSL.SSL  # type: ignore[import]
 from cryptography import x509
-from cryptography.hazmat.backends.openssl import backend as openssl_backend
 
 try:
-    from cryptography.x509 import UnsupportedExtension
+    from cryptography.x509 import UnsupportedExtension  # type: ignore[attr-defined]
 except ImportError:
     # UnsupportedExtension is gone in cryptography >= 2.1.0
-    class UnsupportedExtension(Exception):
+    class UnsupportedExtension(Exception):  # type: ignore[no-redef]
         pass
 
 
-from io import BytesIO
-from socket import error as SocketError
-from socket import timeout
-
-try:  # Platform-specific: Python 2
-    from socket import _fileobject
-except ImportError:  # Platform-specific: Python 3
-    _fileobject = None
-    from ..packages.backports.makefile import backport_makefile
-
 import logging
 import ssl
-import sys
+import typing
 import warnings
+from io import BytesIO
+from socket import socket as socket_cls
+from socket import timeout
 
 from .. import util
-from ..packages import six
-from ..util.ssl_ import PROTOCOL_TLS_CLIENT
 
 warnings.warn(
     "'urllib3.contrib.pyopenssl' module is deprecated and will be removed "
-    "in a future release of urllib3 2.x. Read more in this issue: "
+    "in urllib3 v2.1.0. Read more in this issue: "
     "https://github.com/urllib3/urllib3/issues/2680",
     category=DeprecationWarning,
     stacklevel=2,
 )
 
-__all__ = ["inject_into_urllib3", "extract_from_urllib3"]
+if typing.TYPE_CHECKING:
+    from OpenSSL.crypto import X509  # type: ignore[import]
 
-# SNI always works.
-HAS_SNI = True
+
+__all__ = ["inject_into_urllib3", "extract_from_urllib3"]
 
 # Map from urllib3 to PyOpenSSL compatible parameter-values.
 _openssl_versions = {
-    util.PROTOCOL_TLS: OpenSSL.SSL.SSLv23_METHOD,
-    PROTOCOL_TLS_CLIENT: OpenSSL.SSL.SSLv23_METHOD,
+    util.ssl_.PROTOCOL_TLS: OpenSSL.SSL.SSLv23_METHOD,  # type: ignore[attr-defined]
+    util.ssl_.PROTOCOL_TLS_CLIENT: OpenSSL.SSL.SSLv23_METHOD,  # type: ignore[attr-defined]
     ssl.PROTOCOL_TLSv1: OpenSSL.SSL.TLSv1_METHOD,
 }
 
-if hasattr(ssl, "PROTOCOL_SSLv3") and hasattr(OpenSSL.SSL, "SSLv3_METHOD"):
-    _openssl_versions[ssl.PROTOCOL_SSLv3] = OpenSSL.SSL.SSLv3_METHOD
-
 if hasattr(ssl, "PROTOCOL_TLSv1_1") and hasattr(OpenSSL.SSL, "TLSv1_1_METHOD"):
     _openssl_versions[ssl.PROTOCOL_TLSv1_1] = OpenSSL.SSL.TLSv1_1_METHOD
 
@@ -115,43 +95,77 @@ _stdlib_to_openssl_verify = {
     ssl.CERT_REQUIRED: OpenSSL.SSL.VERIFY_PEER
     + OpenSSL.SSL.VERIFY_FAIL_IF_NO_PEER_CERT,
 }
-_openssl_to_stdlib_verify = dict((v, k) for k, v in _stdlib_to_openssl_verify.items())
+_openssl_to_stdlib_verify = {v: k for k, v in _stdlib_to_openssl_verify.items()}
+
+# The SSLvX values are the most likely to be missing in the future
+# but we check them all just to be sure.
+_OP_NO_SSLv2_OR_SSLv3: int = getattr(OpenSSL.SSL, "OP_NO_SSLv2", 0) | getattr(
+    OpenSSL.SSL, "OP_NO_SSLv3", 0
+)
+_OP_NO_TLSv1: int = getattr(OpenSSL.SSL, "OP_NO_TLSv1", 0)
+_OP_NO_TLSv1_1: int = getattr(OpenSSL.SSL, "OP_NO_TLSv1_1", 0)
+_OP_NO_TLSv1_2: int = getattr(OpenSSL.SSL, "OP_NO_TLSv1_2", 0)
+_OP_NO_TLSv1_3: int = getattr(OpenSSL.SSL, "OP_NO_TLSv1_3", 0)
+
+_openssl_to_ssl_minimum_version: dict[int, int] = {
+    ssl.TLSVersion.MINIMUM_SUPPORTED: _OP_NO_SSLv2_OR_SSLv3,
+    ssl.TLSVersion.TLSv1: _OP_NO_SSLv2_OR_SSLv3,
+    ssl.TLSVersion.TLSv1_1: _OP_NO_SSLv2_OR_SSLv3 | _OP_NO_TLSv1,
+    ssl.TLSVersion.TLSv1_2: _OP_NO_SSLv2_OR_SSLv3 | _OP_NO_TLSv1 | _OP_NO_TLSv1_1,
+    ssl.TLSVersion.TLSv1_3: (
+        _OP_NO_SSLv2_OR_SSLv3 | _OP_NO_TLSv1 | _OP_NO_TLSv1_1 | _OP_NO_TLSv1_2
+    ),
+    ssl.TLSVersion.MAXIMUM_SUPPORTED: (
+        _OP_NO_SSLv2_OR_SSLv3 | _OP_NO_TLSv1 | _OP_NO_TLSv1_1 | _OP_NO_TLSv1_2
+    ),
+}
+_openssl_to_ssl_maximum_version: dict[int, int] = {
+    ssl.TLSVersion.MINIMUM_SUPPORTED: (
+        _OP_NO_SSLv2_OR_SSLv3
+        | _OP_NO_TLSv1
+        | _OP_NO_TLSv1_1
+        | _OP_NO_TLSv1_2
+        | _OP_NO_TLSv1_3
+    ),
+    ssl.TLSVersion.TLSv1: (
+        _OP_NO_SSLv2_OR_SSLv3 | _OP_NO_TLSv1_1 | _OP_NO_TLSv1_2 | _OP_NO_TLSv1_3
+    ),
+    ssl.TLSVersion.TLSv1_1: _OP_NO_SSLv2_OR_SSLv3 | _OP_NO_TLSv1_2 | _OP_NO_TLSv1_3,
+    ssl.TLSVersion.TLSv1_2: _OP_NO_SSLv2_OR_SSLv3 | _OP_NO_TLSv1_3,
+    ssl.TLSVersion.TLSv1_3: _OP_NO_SSLv2_OR_SSLv3,
+    ssl.TLSVersion.MAXIMUM_SUPPORTED: _OP_NO_SSLv2_OR_SSLv3,
+}
 
 # OpenSSL will only write 16K at a time
 SSL_WRITE_BLOCKSIZE = 16384
 
-orig_util_HAS_SNI = util.HAS_SNI
 orig_util_SSLContext = util.ssl_.SSLContext
 
 
 log = logging.getLogger(__name__)
 
 
-def inject_into_urllib3():
+def inject_into_urllib3() -> None:
     "Monkey-patch urllib3 with PyOpenSSL-backed SSL-support."
 
     _validate_dependencies_met()
 
-    util.SSLContext = PyOpenSSLContext
-    util.ssl_.SSLContext = PyOpenSSLContext
-    util.HAS_SNI = HAS_SNI
-    util.ssl_.HAS_SNI = HAS_SNI
+    util.SSLContext = PyOpenSSLContext  # type: ignore[assignment]
+    util.ssl_.SSLContext = PyOpenSSLContext  # type: ignore[assignment]
     util.IS_PYOPENSSL = True
     util.ssl_.IS_PYOPENSSL = True
 
 
-def extract_from_urllib3():
+def extract_from_urllib3() -> None:
     "Undo monkey-patching by :func:`inject_into_urllib3`."
 
     util.SSLContext = orig_util_SSLContext
     util.ssl_.SSLContext = orig_util_SSLContext
-    util.HAS_SNI = orig_util_HAS_SNI
-    util.ssl_.HAS_SNI = orig_util_HAS_SNI
     util.IS_PYOPENSSL = False
     util.ssl_.IS_PYOPENSSL = False
 
 
-def _validate_dependencies_met():
+def _validate_dependencies_met() -> None:
     """
     Verifies that PyOpenSSL's package-level dependencies have been met.
     Throws `ImportError` if they are not met.
@@ -177,7 +191,7 @@ def _validate_dependencies_met():
         )
 
 
-def _dnsname_to_stdlib(name):
+def _dnsname_to_stdlib(name: str) -> str | None:
     """
     Converts a dNSName SubjectAlternativeName field to the form used by the
     standard library on the given Python version.
@@ -191,7 +205,7 @@ def _dnsname_to_stdlib(name):
     the name given should be skipped.
     """
 
-    def idna_encode(name):
+    def idna_encode(name: str) -> bytes | None:
         """
         Borrowed wholesale from the Python Cryptography Project. It turns out
         that we can't just safely call `idna.encode`: it can explode for
@@ -200,7 +214,7 @@ def _dnsname_to_stdlib(name):
         import idna
 
         try:
-            for prefix in [u"*.", u"."]:
+            for prefix in ["*.", "."]:
                 if name.startswith(prefix):
                     name = name[len(prefix) :]
                     return prefix.encode("ascii") + idna.encode(name)
@@ -212,24 +226,17 @@ def _dnsname_to_stdlib(name):
     if ":" in name:
         return name
 
-    name = idna_encode(name)
-    if name is None:
+    encoded_name = idna_encode(name)
+    if encoded_name is None:
         return None
-    elif sys.version_info >= (3, 0):
-        name = name.decode("utf-8")
-    return name
+    return encoded_name.decode("utf-8")
 
 
-def get_subj_alt_name(peer_cert):
+def get_subj_alt_name(peer_cert: X509) -> list[tuple[str, str]]:
     """
     Given an PyOpenSSL certificate, provides all the subject alternative names.
     """
-    # Pass the cert to cryptography, which has much better APIs for this.
-    if hasattr(peer_cert, "to_cryptography"):
-        cert = peer_cert.to_cryptography()
-    else:
-        der = OpenSSL.crypto.dump_certificate(OpenSSL.crypto.FILETYPE_ASN1, peer_cert)
-        cert = x509.load_der_x509_certificate(der, openssl_backend)
+    cert = peer_cert.to_cryptography()
 
     # We want to find the SAN extension. Ask Cryptography to locate it (it's
     # faster than looping in Python)
@@ -273,93 +280,94 @@ def get_subj_alt_name(peer_cert):
     return names
 
 
-class WrappedSocket(object):
-    """API-compatibility wrapper for Python OpenSSL's Connection-class.
+class WrappedSocket:
+    """API-compatibility wrapper for Python OpenSSL's Connection-class."""
 
-    Note: _makefile_refs, _drop() and _reuse() are needed for the garbage
-    collector of pypy.
-    """
-
-    def __init__(self, connection, socket, suppress_ragged_eofs=True):
+    def __init__(
+        self,
+        connection: OpenSSL.SSL.Connection,
+        socket: socket_cls,
+        suppress_ragged_eofs: bool = True,
+    ) -> None:
         self.connection = connection
         self.socket = socket
         self.suppress_ragged_eofs = suppress_ragged_eofs
-        self._makefile_refs = 0
+        self._io_refs = 0
         self._closed = False
 
-    def fileno(self):
+    def fileno(self) -> int:
         return self.socket.fileno()
 
     # Copy-pasted from Python 3.5 source code
-    def _decref_socketios(self):
-        if self._makefile_refs > 0:
-            self._makefile_refs -= 1
+    def _decref_socketios(self) -> None:
+        if self._io_refs > 0:
+            self._io_refs -= 1
         if self._closed:
             self.close()
 
-    def recv(self, *args, **kwargs):
+    def recv(self, *args: typing.Any, **kwargs: typing.Any) -> bytes:
         try:
             data = self.connection.recv(*args, **kwargs)
         except OpenSSL.SSL.SysCallError as e:
             if self.suppress_ragged_eofs and e.args == (-1, "Unexpected EOF"):
                 return b""
             else:
-                raise SocketError(str(e))
+                raise OSError(e.args[0], str(e)) from e
         except OpenSSL.SSL.ZeroReturnError:
             if self.connection.get_shutdown() == OpenSSL.SSL.RECEIVED_SHUTDOWN:
                 return b""
             else:
                 raise
-        except OpenSSL.SSL.WantReadError:
+        except OpenSSL.SSL.WantReadError as e:
             if not util.wait_for_read(self.socket, self.socket.gettimeout()):
-                raise timeout("The read operation timed out")
+                raise timeout("The read operation timed out") from e
             else:
                 return self.recv(*args, **kwargs)
 
         # TLS 1.3 post-handshake authentication
         except OpenSSL.SSL.Error as e:
-            raise ssl.SSLError("read error: %r" % e)
+            raise ssl.SSLError(f"read error: {e!r}") from e
         else:
-            return data
+            return data  # type: ignore[no-any-return]
 
-    def recv_into(self, *args, **kwargs):
+    def recv_into(self, *args: typing.Any, **kwargs: typing.Any) -> int:
         try:
-            return self.connection.recv_into(*args, **kwargs)
+            return self.connection.recv_into(*args, **kwargs)  # type: ignore[no-any-return]
         except OpenSSL.SSL.SysCallError as e:
             if self.suppress_ragged_eofs and e.args == (-1, "Unexpected EOF"):
                 return 0
             else:
-                raise SocketError(str(e))
+                raise OSError(e.args[0], str(e)) from e
         except OpenSSL.SSL.ZeroReturnError:
             if self.connection.get_shutdown() == OpenSSL.SSL.RECEIVED_SHUTDOWN:
                 return 0
             else:
                 raise
-        except OpenSSL.SSL.WantReadError:
+        except OpenSSL.SSL.WantReadError as e:
             if not util.wait_for_read(self.socket, self.socket.gettimeout()):
-                raise timeout("The read operation timed out")
+                raise timeout("The read operation timed out") from e
             else:
                 return self.recv_into(*args, **kwargs)
 
         # TLS 1.3 post-handshake authentication
         except OpenSSL.SSL.Error as e:
-            raise ssl.SSLError("read error: %r" % e)
+            raise ssl.SSLError(f"read error: {e!r}") from e
 
-    def settimeout(self, timeout):
+    def settimeout(self, timeout: float) -> None:
         return self.socket.settimeout(timeout)
 
-    def _send_until_done(self, data):
+    def _send_until_done(self, data: bytes) -> int:
         while True:
             try:
-                return self.connection.send(data)
-            except OpenSSL.SSL.WantWriteError:
+                return self.connection.send(data)  # type: ignore[no-any-return]
+            except OpenSSL.SSL.WantWriteError as e:
                 if not util.wait_for_write(self.socket, self.socket.gettimeout()):
-                    raise timeout()
+                    raise timeout() from e
                 continue
             except OpenSSL.SSL.SysCallError as e:
-                raise SocketError(str(e))
+                raise OSError(e.args[0], str(e)) from e
 
-    def sendall(self, data):
+    def sendall(self, data: bytes) -> None:
         total_sent = 0
         while total_sent < len(data):
             sent = self._send_until_done(
@@ -367,135 +375,135 @@ class WrappedSocket(object):
             )
             total_sent += sent
 
-    def shutdown(self):
+    def shutdown(self) -> None:
         # FIXME rethrow compatible exceptions should we ever use this
         self.connection.shutdown()
 
-    def close(self):
-        if self._makefile_refs < 1:
-            try:
-                self._closed = True
-                return self.connection.close()
-            except OpenSSL.SSL.Error:
-                return
-        else:
-            self._makefile_refs -= 1
+    def close(self) -> None:
+        self._closed = True
+        if self._io_refs <= 0:
+            self._real_close()
 
-    def getpeercert(self, binary_form=False):
+    def _real_close(self) -> None:
+        try:
+            return self.connection.close()  # type: ignore[no-any-return]
+        except OpenSSL.SSL.Error:
+            return
+
+    def getpeercert(
+        self, binary_form: bool = False
+    ) -> dict[str, list[typing.Any]] | None:
         x509 = self.connection.get_peer_certificate()
 
         if not x509:
-            return x509
+            return x509  # type: ignore[no-any-return]
 
         if binary_form:
-            return OpenSSL.crypto.dump_certificate(OpenSSL.crypto.FILETYPE_ASN1, x509)
+            return OpenSSL.crypto.dump_certificate(OpenSSL.crypto.FILETYPE_ASN1, x509)  # type: ignore[no-any-return]
 
         return {
-            "subject": ((("commonName", x509.get_subject().CN),),),
+            "subject": ((("commonName", x509.get_subject().CN),),),  # type: ignore[dict-item]
             "subjectAltName": get_subj_alt_name(x509),
         }
 
-    def version(self):
-        return self.connection.get_protocol_version_name()
-
-    def _reuse(self):
-        self._makefile_refs += 1
-
-    def _drop(self):
-        if self._makefile_refs < 1:
-            self.close()
-        else:
-            self._makefile_refs -= 1
+    def version(self) -> str:
+        return self.connection.get_protocol_version_name()  # type: ignore[no-any-return]
 
 
-if _fileobject:  # Platform-specific: Python 2
-
-    def makefile(self, mode, bufsize=-1):
-        self._makefile_refs += 1
-        return _fileobject(self, mode, bufsize, close=True)
-
-else:  # Platform-specific: Python 3
-    makefile = backport_makefile
-
-WrappedSocket.makefile = makefile
+WrappedSocket.makefile = socket_cls.makefile  # type: ignore[attr-defined]
 
 
-class PyOpenSSLContext(object):
+class PyOpenSSLContext:
     """
     I am a wrapper class for the PyOpenSSL ``Context`` object. I am responsible
     for translating the interface of the standard library ``SSLContext`` object
     to calls into PyOpenSSL.
     """
 
-    def __init__(self, protocol):
+    def __init__(self, protocol: int) -> None:
         self.protocol = _openssl_versions[protocol]
         self._ctx = OpenSSL.SSL.Context(self.protocol)
         self._options = 0
         self.check_hostname = False
+        self._minimum_version: int = ssl.TLSVersion.MINIMUM_SUPPORTED
+        self._maximum_version: int = ssl.TLSVersion.MAXIMUM_SUPPORTED
 
     @property
-    def options(self):
+    def options(self) -> int:
         return self._options
 
     @options.setter
-    def options(self, value):
+    def options(self, value: int) -> None:
         self._options = value
-        self._ctx.set_options(value)
+        self._set_ctx_options()
 
     @property
-    def verify_mode(self):
+    def verify_mode(self) -> int:
         return _openssl_to_stdlib_verify[self._ctx.get_verify_mode()]
 
     @verify_mode.setter
-    def verify_mode(self, value):
+    def verify_mode(self, value: ssl.VerifyMode) -> None:
         self._ctx.set_verify(_stdlib_to_openssl_verify[value], _verify_callback)
 
-    def set_default_verify_paths(self):
+    def set_default_verify_paths(self) -> None:
         self._ctx.set_default_verify_paths()
 
-    def set_ciphers(self, ciphers):
-        if isinstance(ciphers, six.text_type):
+    def set_ciphers(self, ciphers: bytes | str) -> None:
+        if isinstance(ciphers, str):
             ciphers = ciphers.encode("utf-8")
         self._ctx.set_cipher_list(ciphers)
 
-    def load_verify_locations(self, cafile=None, capath=None, cadata=None):
+    def load_verify_locations(
+        self,
+        cafile: str | None = None,
+        capath: str | None = None,
+        cadata: bytes | None = None,
+    ) -> None:
         if cafile is not None:
-            cafile = cafile.encode("utf-8")
+            cafile = cafile.encode("utf-8")  # type: ignore[assignment]
         if capath is not None:
-            capath = capath.encode("utf-8")
+            capath = capath.encode("utf-8")  # type: ignore[assignment]
         try:
             self._ctx.load_verify_locations(cafile, capath)
             if cadata is not None:
                 self._ctx.load_verify_locations(BytesIO(cadata))
         except OpenSSL.SSL.Error as e:
-            raise ssl.SSLError("unable to load trusted certificates: %r" % e)
+            raise ssl.SSLError(f"unable to load trusted certificates: {e!r}") from e
 
-    def load_cert_chain(self, certfile, keyfile=None, password=None):
-        self._ctx.use_certificate_chain_file(certfile)
-        if password is not None:
-            if not isinstance(password, six.binary_type):
-                password = password.encode("utf-8")
-            self._ctx.set_passwd_cb(lambda *_: password)
-        self._ctx.use_privatekey_file(keyfile or certfile)
+    def load_cert_chain(
+        self,
+        certfile: str,
+        keyfile: str | None = None,
+        password: str | None = None,
+    ) -> None:
+        try:
+            self._ctx.use_certificate_chain_file(certfile)
+            if password is not None:
+                if not isinstance(password, bytes):
+                    password = password.encode("utf-8")  # type: ignore[assignment]
+                self._ctx.set_passwd_cb(lambda *_: password)
+            self._ctx.use_privatekey_file(keyfile or certfile)
+        except OpenSSL.SSL.Error as e:
+            raise ssl.SSLError(f"Unable to load certificate chain: {e!r}") from e
 
-    def set_alpn_protocols(self, protocols):
-        protocols = [six.ensure_binary(p) for p in protocols]
-        return self._ctx.set_alpn_protos(protocols)
+    def set_alpn_protocols(self, protocols: list[bytes | str]) -> None:
+        protocols = [util.util.to_bytes(p, "ascii") for p in protocols]
+        return self._ctx.set_alpn_protos(protocols)  # type: ignore[no-any-return]
 
     def wrap_socket(
         self,
-        sock,
-        server_side=False,
-        do_handshake_on_connect=True,
-        suppress_ragged_eofs=True,
-        server_hostname=None,
-    ):
+        sock: socket_cls,
+        server_side: bool = False,
+        do_handshake_on_connect: bool = True,
+        suppress_ragged_eofs: bool = True,
+        server_hostname: bytes | str | None = None,
+    ) -> WrappedSocket:
         cnx = OpenSSL.SSL.Connection(self._ctx, sock)
 
-        if isinstance(server_hostname, six.text_type):  # Platform-specific: Python 3
-            server_hostname = server_hostname.encode("utf-8")
-
-        if server_hostname is not None:
+        # If server_hostname is an IP, don't use it for SNI, per RFC6066 Section 3
+        if server_hostname and not util.ssl_.is_ipaddress(server_hostname):
+            if isinstance(server_hostname, str):
+                server_hostname = server_hostname.encode("utf-8")
             cnx.set_tlsext_host_name(server_hostname)
 
         cnx.set_connect_state()
@@ -503,16 +511,47 @@ class PyOpenSSLContext(object):
         while True:
             try:
                 cnx.do_handshake()
-            except OpenSSL.SSL.WantReadError:
+            except OpenSSL.SSL.WantReadError as e:
                 if not util.wait_for_read(sock, sock.gettimeout()):
-                    raise timeout("select timed out")
+                    raise timeout("select timed out") from e
                 continue
             except OpenSSL.SSL.Error as e:
-                raise ssl.SSLError("bad handshake: %r" % e)
+                raise ssl.SSLError(f"bad handshake: {e!r}") from e
             break
 
         return WrappedSocket(cnx, sock)
 
+    def _set_ctx_options(self) -> None:
+        self._ctx.set_options(
+            self._options
+            | _openssl_to_ssl_minimum_version[self._minimum_version]
+            | _openssl_to_ssl_maximum_version[self._maximum_version]
+        )
 
-def _verify_callback(cnx, x509, err_no, err_depth, return_code):
+    @property
+    def minimum_version(self) -> int:
+        return self._minimum_version
+
+    @minimum_version.setter
+    def minimum_version(self, minimum_version: int) -> None:
+        self._minimum_version = minimum_version
+        self._set_ctx_options()
+
+    @property
+    def maximum_version(self) -> int:
+        return self._maximum_version
+
+    @maximum_version.setter
+    def maximum_version(self, maximum_version: int) -> None:
+        self._maximum_version = maximum_version
+        self._set_ctx_options()
+
+
+def _verify_callback(
+    cnx: OpenSSL.SSL.Connection,
+    x509: X509,
+    err_no: int,
+    err_depth: int,
+    return_code: int,
+) -> bool:
     return err_no == 0
diff --git a/lib/urllib3/contrib/securetransport.py b/lib/urllib3/contrib/securetransport.py
index 6c46a3b9..11beb3df 100644
--- a/lib/urllib3/contrib/securetransport.py
+++ b/lib/urllib3/contrib/securetransport.py
@@ -51,7 +51,8 @@ license and by oscrypto's:
     FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
     DEALINGS IN THE SOFTWARE.
 """
-from __future__ import absolute_import
+
+from __future__ import annotations
 
 import contextlib
 import ctypes
@@ -62,14 +63,18 @@ import socket
 import ssl
 import struct
 import threading
+import typing
+import warnings
 import weakref
-
-import six
+from socket import socket as socket_cls
 
 from .. import util
-from ..util.ssl_ import PROTOCOL_TLS_CLIENT
-from ._securetransport.bindings import CoreFoundation, Security, SecurityConst
+from ._securetransport.bindings import (  # type: ignore[attr-defined]
+    CoreFoundation,
+    Security,
+)
 from ._securetransport.low_level import (
+    SecurityConst,
     _assert_no_error,
     _build_tls_unknown_ca_alert,
     _cert_array_from_pem,
@@ -78,18 +83,19 @@ from ._securetransport.low_level import (
     _temporary_keychain,
 )
 
-try:  # Platform-specific: Python 2
-    from socket import _fileobject
-except ImportError:  # Platform-specific: Python 3
-    _fileobject = None
-    from ..packages.backports.makefile import backport_makefile
+warnings.warn(
+    "'urllib3.contrib.securetransport' module is deprecated and will be removed "
+    "in urllib3 v2.1.0. Read more in this issue: "
+    "https://github.com/urllib3/urllib3/issues/2681",
+    category=DeprecationWarning,
+    stacklevel=2,
+)
+
+if typing.TYPE_CHECKING:
+    from typing_extensions import Literal
 
 __all__ = ["inject_into_urllib3", "extract_from_urllib3"]
 
-# SNI always works
-HAS_SNI = True
-
-orig_util_HAS_SNI = util.HAS_SNI
 orig_util_SSLContext = util.ssl_.SSLContext
 
 # This dictionary is used by the read callback to obtain a handle to the
@@ -108,55 +114,24 @@ orig_util_SSLContext = util.ssl_.SSLContext
 #
 # This is good: if we had to lock in the callbacks we'd drastically slow down
 # the performance of this code.
-_connection_refs = weakref.WeakValueDictionary()
+_connection_refs: weakref.WeakValueDictionary[
+    int, WrappedSocket
+] = weakref.WeakValueDictionary()
 _connection_ref_lock = threading.Lock()
 
 # Limit writes to 16kB. This is OpenSSL's limit, but we'll cargo-cult it over
 # for no better reason than we need *a* limit, and this one is right there.
 SSL_WRITE_BLOCKSIZE = 16384
 
-# This is our equivalent of util.ssl_.DEFAULT_CIPHERS, but expanded out to
-# individual cipher suites. We need to do this because this is how
-# SecureTransport wants them.
-CIPHER_SUITES = [
-    SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384,
-    SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256,
-    SecurityConst.TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384,
-    SecurityConst.TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256,
-    SecurityConst.TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256,
-    SecurityConst.TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256,
-    SecurityConst.TLS_DHE_RSA_WITH_AES_256_GCM_SHA384,
-    SecurityConst.TLS_DHE_RSA_WITH_AES_128_GCM_SHA256,
-    SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384,
-    SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA,
-    SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256,
-    SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA,
-    SecurityConst.TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384,
-    SecurityConst.TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA,
-    SecurityConst.TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256,
-    SecurityConst.TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA,
-    SecurityConst.TLS_DHE_RSA_WITH_AES_256_CBC_SHA256,
-    SecurityConst.TLS_DHE_RSA_WITH_AES_256_CBC_SHA,
-    SecurityConst.TLS_DHE_RSA_WITH_AES_128_CBC_SHA256,
-    SecurityConst.TLS_DHE_RSA_WITH_AES_128_CBC_SHA,
-    SecurityConst.TLS_AES_256_GCM_SHA384,
-    SecurityConst.TLS_AES_128_GCM_SHA256,
-    SecurityConst.TLS_RSA_WITH_AES_256_GCM_SHA384,
-    SecurityConst.TLS_RSA_WITH_AES_128_GCM_SHA256,
-    SecurityConst.TLS_AES_128_CCM_8_SHA256,
-    SecurityConst.TLS_AES_128_CCM_SHA256,
-    SecurityConst.TLS_RSA_WITH_AES_256_CBC_SHA256,
-    SecurityConst.TLS_RSA_WITH_AES_128_CBC_SHA256,
-    SecurityConst.TLS_RSA_WITH_AES_256_CBC_SHA,
-    SecurityConst.TLS_RSA_WITH_AES_128_CBC_SHA,
-]
-
 # Basically this is simple: for PROTOCOL_SSLv23 we turn it into a low of
 # TLSv1 and a high of TLSv1.2. For everything else, we pin to that version.
 # TLSv1 to 1.2 are supported on macOS 10.8+
 _protocol_to_min_max = {
-    util.PROTOCOL_TLS: (SecurityConst.kTLSProtocol1, SecurityConst.kTLSProtocol12),
-    PROTOCOL_TLS_CLIENT: (SecurityConst.kTLSProtocol1, SecurityConst.kTLSProtocol12),
+    util.ssl_.PROTOCOL_TLS: (SecurityConst.kTLSProtocol1, SecurityConst.kTLSProtocol12),  # type: ignore[attr-defined]
+    util.ssl_.PROTOCOL_TLS_CLIENT: (  # type: ignore[attr-defined]
+        SecurityConst.kTLSProtocol1,
+        SecurityConst.kTLSProtocol12,
+    ),
 }
 
 if hasattr(ssl, "PROTOCOL_SSLv2"):
@@ -186,31 +161,38 @@ if hasattr(ssl, "PROTOCOL_TLSv1_2"):
     )
 
 
-def inject_into_urllib3():
+_tls_version_to_st: dict[int, int] = {
+    ssl.TLSVersion.MINIMUM_SUPPORTED: SecurityConst.kTLSProtocol1,
+    ssl.TLSVersion.TLSv1: SecurityConst.kTLSProtocol1,
+    ssl.TLSVersion.TLSv1_1: SecurityConst.kTLSProtocol11,
+    ssl.TLSVersion.TLSv1_2: SecurityConst.kTLSProtocol12,
+    ssl.TLSVersion.MAXIMUM_SUPPORTED: SecurityConst.kTLSProtocol12,
+}
+
+
+def inject_into_urllib3() -> None:
     """
     Monkey-patch urllib3 with SecureTransport-backed SSL-support.
     """
-    util.SSLContext = SecureTransportContext
-    util.ssl_.SSLContext = SecureTransportContext
-    util.HAS_SNI = HAS_SNI
-    util.ssl_.HAS_SNI = HAS_SNI
+    util.SSLContext = SecureTransportContext  # type: ignore[assignment]
+    util.ssl_.SSLContext = SecureTransportContext  # type: ignore[assignment]
     util.IS_SECURETRANSPORT = True
     util.ssl_.IS_SECURETRANSPORT = True
 
 
-def extract_from_urllib3():
+def extract_from_urllib3() -> None:
     """
     Undo monkey-patching by :func:`inject_into_urllib3`.
     """
     util.SSLContext = orig_util_SSLContext
     util.ssl_.SSLContext = orig_util_SSLContext
-    util.HAS_SNI = orig_util_HAS_SNI
-    util.ssl_.HAS_SNI = orig_util_HAS_SNI
     util.IS_SECURETRANSPORT = False
     util.ssl_.IS_SECURETRANSPORT = False
 
 
-def _read_callback(connection_id, data_buffer, data_length_pointer):
+def _read_callback(
+    connection_id: int, data_buffer: int, data_length_pointer: bytearray
+) -> int:
     """
     SecureTransport read callback. This is called by ST to request that data
     be returned from the socket.
@@ -232,7 +214,7 @@ def _read_callback(connection_id, data_buffer, data_length_pointer):
             while read_count < requested_length:
                 if timeout is None or timeout >= 0:
                     if not util.wait_for_read(base_socket, timeout):
-                        raise socket.error(errno.EAGAIN, "timed out")
+                        raise OSError(errno.EAGAIN, "timed out")
 
                 remaining = requested_length - read_count
                 buffer = (ctypes.c_char * remaining).from_address(
@@ -244,7 +226,7 @@ def _read_callback(connection_id, data_buffer, data_length_pointer):
                     if not read_count:
                         return SecurityConst.errSSLClosedGraceful
                     break
-        except (socket.error) as e:
+        except OSError as e:
             error = e.errno
 
             if error is not None and error != errno.EAGAIN:
@@ -265,7 +247,9 @@ def _read_callback(connection_id, data_buffer, data_length_pointer):
         return SecurityConst.errSSLInternal
 
 
-def _write_callback(connection_id, data_buffer, data_length_pointer):
+def _write_callback(
+    connection_id: int, data_buffer: int, data_length_pointer: bytearray
+) -> int:
     """
     SecureTransport write callback. This is called by ST to request that data
     actually be sent on the network.
@@ -288,14 +272,14 @@ def _write_callback(connection_id, data_buffer, data_length_pointer):
             while sent < bytes_to_write:
                 if timeout is None or timeout >= 0:
                     if not util.wait_for_write(base_socket, timeout):
-                        raise socket.error(errno.EAGAIN, "timed out")
+                        raise OSError(errno.EAGAIN, "timed out")
                 chunk_sent = base_socket.send(data)
                 sent += chunk_sent
 
                 # This has some needless copying here, but I'm not sure there's
                 # much value in optimising this data path.
                 data = data[chunk_sent:]
-        except (socket.error) as e:
+        except OSError as e:
             error = e.errno
 
             if error is not None and error != errno.EAGAIN:
@@ -323,22 +307,20 @@ _read_callback_pointer = Security.SSLReadFunc(_read_callback)
 _write_callback_pointer = Security.SSLWriteFunc(_write_callback)
 
 
-class WrappedSocket(object):
+class WrappedSocket:
     """
     API-compatibility wrapper for Python's OpenSSL wrapped socket object.
-
-    Note: _makefile_refs, _drop(), and _reuse() are needed for the garbage
-    collector of PyPy.
     """
 
-    def __init__(self, socket):
+    def __init__(self, socket: socket_cls) -> None:
         self.socket = socket
         self.context = None
-        self._makefile_refs = 0
+        self._io_refs = 0
         self._closed = False
-        self._exception = None
+        self._real_closed = False
+        self._exception: Exception | None = None
         self._keychain = None
-        self._keychain_dir = None
+        self._keychain_dir: str | None = None
         self._client_cert_chain = None
 
         # We save off the previously-configured timeout and then set it to
@@ -350,7 +332,7 @@ class WrappedSocket(object):
         self.socket.settimeout(0)
 
     @contextlib.contextmanager
-    def _raise_on_error(self):
+    def _raise_on_error(self) -> typing.Generator[None, None, None]:
         """
         A context manager that can be used to wrap calls that do I/O from
         SecureTransport. If any of the I/O callbacks hit an exception, this
@@ -367,23 +349,10 @@ class WrappedSocket(object):
         yield
         if self._exception is not None:
             exception, self._exception = self._exception, None
-            self.close()
+            self._real_close()
             raise exception
 
-    def _set_ciphers(self):
-        """
-        Sets up the allowed ciphers. By default this matches the set in
-        util.ssl_.DEFAULT_CIPHERS, at least as supported by macOS. This is done
-        custom and doesn't allow changing at this time, mostly because parsing
-        OpenSSL cipher strings is going to be a freaking nightmare.
-        """
-        ciphers = (Security.SSLCipherSuite * len(CIPHER_SUITES))(*CIPHER_SUITES)
-        result = Security.SSLSetEnabledCiphers(
-            self.context, ciphers, len(CIPHER_SUITES)
-        )
-        _assert_no_error(result)
-
-    def _set_alpn_protocols(self, protocols):
+    def _set_alpn_protocols(self, protocols: list[bytes] | None) -> None:
         """
         Sets up the ALPN protocols on the context.
         """
@@ -396,7 +365,7 @@ class WrappedSocket(object):
         finally:
             CoreFoundation.CFRelease(protocols_arr)
 
-    def _custom_validate(self, verify, trust_bundle):
+    def _custom_validate(self, verify: bool, trust_bundle: bytes | None) -> None:
         """
         Called when we have set custom validation. We do this in two cases:
         first, when cert validation is entirely disabled; and second, when
@@ -404,7 +373,7 @@ class WrappedSocket(object):
         Raises an SSLError if the connection is not trusted.
         """
         # If we disabled cert validation, just say: cool.
-        if not verify:
+        if not verify or trust_bundle is None:
             return
 
         successes = (
@@ -415,10 +384,12 @@ class WrappedSocket(object):
             trust_result = self._evaluate_trust(trust_bundle)
             if trust_result in successes:
                 return
-            reason = "error code: %d" % (trust_result,)
+            reason = f"error code: {int(trust_result)}"
+            exc = None
         except Exception as e:
             # Do not trust on error
-            reason = "exception: %r" % (e,)
+            reason = f"exception: {e!r}"
+            exc = e
 
         # SecureTransport does not send an alert nor shuts down the connection.
         rec = _build_tls_unknown_ca_alert(self.version())
@@ -428,10 +399,10 @@ class WrappedSocket(object):
         # l_linger = 0, linger for 0 seoncds
         opts = struct.pack("ii", 1, 0)
         self.socket.setsockopt(socket.SOL_SOCKET, socket.SO_LINGER, opts)
-        self.close()
-        raise ssl.SSLError("certificate verify failed, %s" % reason)
+        self._real_close()
+        raise ssl.SSLError(f"certificate verify failed, {reason}") from exc
 
-    def _evaluate_trust(self, trust_bundle):
+    def _evaluate_trust(self, trust_bundle: bytes) -> int:
         # We want data in memory, so load it up.
         if os.path.isfile(trust_bundle):
             with open(trust_bundle, "rb") as f:
@@ -469,20 +440,20 @@ class WrappedSocket(object):
             if cert_array is not None:
                 CoreFoundation.CFRelease(cert_array)
 
-        return trust_result.value
+        return trust_result.value  # type: ignore[no-any-return]
 
     def handshake(
         self,
-        server_hostname,
-        verify,
-        trust_bundle,
-        min_version,
-        max_version,
-        client_cert,
-        client_key,
-        client_key_passphrase,
-        alpn_protocols,
-    ):
+        server_hostname: bytes | str | None,
+        verify: bool,
+        trust_bundle: bytes | None,
+        min_version: int,
+        max_version: int,
+        client_cert: str | None,
+        client_key: str | None,
+        client_key_passphrase: typing.Any,
+        alpn_protocols: list[bytes] | None,
+    ) -> None:
         """
         Actually performs the TLS handshake. This is run automatically by
         wrapped socket, and shouldn't be needed in user code.
@@ -510,6 +481,8 @@ class WrappedSocket(object):
         _assert_no_error(result)
 
         # If we have a server hostname, we should set that too.
+        # RFC6066 Section 3 tells us not to use SNI when the host is an IP, but we have
+        # to do it anyway to match server_hostname against the server certificate
         if server_hostname:
             if not isinstance(server_hostname, bytes):
                 server_hostname = server_hostname.encode("utf-8")
@@ -519,9 +492,6 @@ class WrappedSocket(object):
             )
             _assert_no_error(result)
 
-        # Setup the ciphers.
-        self._set_ciphers()
-
         # Setup the ALPN protocols.
         self._set_alpn_protocols(alpn_protocols)
 
@@ -564,25 +534,27 @@ class WrappedSocket(object):
                     _assert_no_error(result)
                     break
 
-    def fileno(self):
+    def fileno(self) -> int:
         return self.socket.fileno()
 
     # Copy-pasted from Python 3.5 source code
-    def _decref_socketios(self):
-        if self._makefile_refs > 0:
-            self._makefile_refs -= 1
+    def _decref_socketios(self) -> None:
+        if self._io_refs > 0:
+            self._io_refs -= 1
         if self._closed:
             self.close()
 
-    def recv(self, bufsiz):
+    def recv(self, bufsiz: int) -> bytes:
         buffer = ctypes.create_string_buffer(bufsiz)
         bytes_read = self.recv_into(buffer, bufsiz)
         data = buffer[:bytes_read]
-        return data
+        return typing.cast(bytes, data)
 
-    def recv_into(self, buffer, nbytes=None):
+    def recv_into(
+        self, buffer: ctypes.Array[ctypes.c_char], nbytes: int | None = None
+    ) -> int:
         # Read short on EOF.
-        if self._closed:
+        if self._real_closed:
             return 0
 
         if nbytes is None:
@@ -615,7 +587,7 @@ class WrappedSocket(object):
             # well. Note that we don't actually return here because in
             # principle this could actually be fired along with return data.
             # It's unlikely though.
-            self.close()
+            self._real_close()
         else:
             _assert_no_error(result)
 
@@ -623,13 +595,13 @@ class WrappedSocket(object):
         # was actually read.
         return processed_bytes.value
 
-    def settimeout(self, timeout):
+    def settimeout(self, timeout: float) -> None:
         self._timeout = timeout
 
-    def gettimeout(self):
+    def gettimeout(self) -> float | None:
         return self._timeout
 
-    def send(self, data):
+    def send(self, data: bytes) -> int:
         processed_bytes = ctypes.c_size_t(0)
 
         with self._raise_on_error():
@@ -646,36 +618,38 @@ class WrappedSocket(object):
         # We sent, and probably succeeded. Tell them how much we sent.
         return processed_bytes.value
 
-    def sendall(self, data):
+    def sendall(self, data: bytes) -> None:
         total_sent = 0
         while total_sent < len(data):
             sent = self.send(data[total_sent : total_sent + SSL_WRITE_BLOCKSIZE])
             total_sent += sent
 
-    def shutdown(self):
+    def shutdown(self) -> None:
         with self._raise_on_error():
             Security.SSLClose(self.context)
 
-    def close(self):
+    def close(self) -> None:
+        self._closed = True
         # TODO: should I do clean shutdown here? Do I have to?
-        if self._makefile_refs < 1:
-            self._closed = True
-            if self.context:
-                CoreFoundation.CFRelease(self.context)
-                self.context = None
-            if self._client_cert_chain:
-                CoreFoundation.CFRelease(self._client_cert_chain)
-                self._client_cert_chain = None
-            if self._keychain:
-                Security.SecKeychainDelete(self._keychain)
-                CoreFoundation.CFRelease(self._keychain)
-                shutil.rmtree(self._keychain_dir)
-                self._keychain = self._keychain_dir = None
-            return self.socket.close()
-        else:
-            self._makefile_refs -= 1
+        if self._io_refs <= 0:
+            self._real_close()
 
-    def getpeercert(self, binary_form=False):
+    def _real_close(self) -> None:
+        self._real_closed = True
+        if self.context:
+            CoreFoundation.CFRelease(self.context)
+            self.context = None
+        if self._client_cert_chain:
+            CoreFoundation.CFRelease(self._client_cert_chain)
+            self._client_cert_chain = None
+        if self._keychain:
+            Security.SecKeychainDelete(self._keychain)
+            CoreFoundation.CFRelease(self._keychain)
+            shutil.rmtree(self._keychain_dir)
+            self._keychain = self._keychain_dir = None
+        return self.socket.close()
+
+    def getpeercert(self, binary_form: bool = False) -> bytes | None:
         # Urgh, annoying.
         #
         # Here's how we do this:
@@ -733,7 +707,7 @@ class WrappedSocket(object):
 
         return der_bytes
 
-    def version(self):
+    def version(self) -> str:
         protocol = Security.SSLProtocol()
         result = Security.SSLGetNegotiatedProtocolVersion(
             self.context, ctypes.byref(protocol)
@@ -752,55 +726,50 @@ class WrappedSocket(object):
         elif protocol.value == SecurityConst.kSSLProtocol2:
             return "SSLv2"
         else:
-            raise ssl.SSLError("Unknown TLS version: %r" % protocol)
-
-    def _reuse(self):
-        self._makefile_refs += 1
-
-    def _drop(self):
-        if self._makefile_refs < 1:
-            self.close()
-        else:
-            self._makefile_refs -= 1
+            raise ssl.SSLError(f"Unknown TLS version: {protocol!r}")
 
 
-if _fileobject:  # Platform-specific: Python 2
-
-    def makefile(self, mode, bufsize=-1):
-        self._makefile_refs += 1
-        return _fileobject(self, mode, bufsize, close=True)
-
-else:  # Platform-specific: Python 3
-
-    def makefile(self, mode="r", buffering=None, *args, **kwargs):
-        # We disable buffering with SecureTransport because it conflicts with
-        # the buffering that ST does internally (see issue #1153 for more).
-        buffering = 0
-        return backport_makefile(self, mode, buffering, *args, **kwargs)
+def makefile(
+    self: socket_cls,
+    mode: (
+        Literal["r"] | Literal["w"] | Literal["rw"] | Literal["wr"] | Literal[""]
+    ) = "r",
+    buffering: int | None = None,
+    *args: typing.Any,
+    **kwargs: typing.Any,
+) -> typing.BinaryIO | typing.TextIO:
+    # We disable buffering with SecureTransport because it conflicts with
+    # the buffering that ST does internally (see issue #1153 for more).
+    buffering = 0
+    return socket_cls.makefile(self, mode, buffering, *args, **kwargs)
 
 
-WrappedSocket.makefile = makefile
+WrappedSocket.makefile = makefile  # type: ignore[attr-defined]
 
 
-class SecureTransportContext(object):
+class SecureTransportContext:
     """
     I am a wrapper class for the SecureTransport library, to translate the
     interface of the standard library ``SSLContext`` object to calls into
     SecureTransport.
     """
 
-    def __init__(self, protocol):
-        self._min_version, self._max_version = _protocol_to_min_max[protocol]
+    def __init__(self, protocol: int) -> None:
+        self._minimum_version: int = ssl.TLSVersion.MINIMUM_SUPPORTED
+        self._maximum_version: int = ssl.TLSVersion.MAXIMUM_SUPPORTED
+        if protocol not in (None, ssl.PROTOCOL_TLS, ssl.PROTOCOL_TLS_CLIENT):
+            self._min_version, self._max_version = _protocol_to_min_max[protocol]
+
         self._options = 0
         self._verify = False
-        self._trust_bundle = None
-        self._client_cert = None
-        self._client_key = None
+        self._trust_bundle: bytes | None = None
+        self._client_cert: str | None = None
+        self._client_key: str | None = None
         self._client_key_passphrase = None
-        self._alpn_protocols = None
+        self._alpn_protocols: list[bytes] | None = None
 
     @property
-    def check_hostname(self):
+    def check_hostname(self) -> Literal[True]:
         """
         SecureTransport cannot have its hostname checking disabled. For more,
         see the comment on getpeercert() in this file.
@@ -808,15 +777,14 @@ class SecureTransportContext(object):
         return True
 
     @check_hostname.setter
-    def check_hostname(self, value):
+    def check_hostname(self, value: typing.Any) -> None:
         """
         SecureTransport cannot have its hostname checking disabled. For more,
         see the comment on getpeercert() in this file.
         """
-        pass
 
     @property
-    def options(self):
+    def options(self) -> int:
         # TODO: Well, crap.
         #
         # So this is the bit of the code that is the most likely to cause us
@@ -826,19 +794,19 @@ class SecureTransportContext(object):
         return self._options
 
     @options.setter
-    def options(self, value):
+    def options(self, value: int) -> None:
         # TODO: Update in line with above.
         self._options = value
 
     @property
-    def verify_mode(self):
+    def verify_mode(self) -> int:
         return ssl.CERT_REQUIRED if self._verify else ssl.CERT_NONE
 
     @verify_mode.setter
-    def verify_mode(self, value):
-        self._verify = True if value == ssl.CERT_REQUIRED else False
+    def verify_mode(self, value: int) -> None:
+        self._verify = value == ssl.CERT_REQUIRED
 
-    def set_default_verify_paths(self):
+    def set_default_verify_paths(self) -> None:
         # So, this has to do something a bit weird. Specifically, what it does
         # is nothing.
         #
@@ -850,15 +818,18 @@ class SecureTransportContext(object):
         # ignoring it.
         pass
 
-    def load_default_certs(self):
+    def load_default_certs(self) -> None:
         return self.set_default_verify_paths()
 
-    def set_ciphers(self, ciphers):
-        # For now, we just require the default cipher string.
-        if ciphers != util.ssl_.DEFAULT_CIPHERS:
-            raise ValueError("SecureTransport doesn't support custom cipher strings")
+    def set_ciphers(self, ciphers: typing.Any) -> None:
+        raise ValueError("SecureTransport doesn't support custom cipher strings")
 
-    def load_verify_locations(self, cafile=None, capath=None, cadata=None):
+    def load_verify_locations(
+        self,
+        cafile: str | None = None,
+        capath: str | None = None,
+        cadata: bytes | None = None,
+    ) -> None:
         # OK, we only really support cadata and cafile.
         if capath is not None:
             raise ValueError("SecureTransport does not support cert directories")
@@ -868,14 +839,19 @@ class SecureTransportContext(object):
             with open(cafile):
                 pass
 
-        self._trust_bundle = cafile or cadata
+        self._trust_bundle = cafile or cadata  # type: ignore[assignment]
 
-    def load_cert_chain(self, certfile, keyfile=None, password=None):
+    def load_cert_chain(
+        self,
+        certfile: str,
+        keyfile: str | None = None,
+        password: str | None = None,
+    ) -> None:
         self._client_cert = certfile
         self._client_key = keyfile
         self._client_cert_passphrase = password
 
-    def set_alpn_protocols(self, protocols):
+    def set_alpn_protocols(self, protocols: list[str | bytes]) -> None:
         """
         Sets the ALPN protocols that will later be set on the context.
 
@@ -885,16 +861,16 @@ class SecureTransportContext(object):
             raise NotImplementedError(
                 "SecureTransport supports ALPN only in macOS 10.12+"
             )
-        self._alpn_protocols = [six.ensure_binary(p) for p in protocols]
+        self._alpn_protocols = [util.util.to_bytes(p, "ascii") for p in protocols]
 
     def wrap_socket(
         self,
-        sock,
-        server_side=False,
-        do_handshake_on_connect=True,
-        suppress_ragged_eofs=True,
-        server_hostname=None,
-    ):
+        sock: socket_cls,
+        server_side: bool = False,
+        do_handshake_on_connect: bool = True,
+        suppress_ragged_eofs: bool = True,
+        server_hostname: bytes | str | None = None,
+    ) -> WrappedSocket:
         # So, what do we do here? Firstly, we assert some properties. This is a
         # stripped down shim, so there is some functionality we don't support.
         # See PEP 543 for the real deal.
@@ -911,11 +887,27 @@ class SecureTransportContext(object):
             server_hostname,
             self._verify,
             self._trust_bundle,
-            self._min_version,
-            self._max_version,
+            _tls_version_to_st[self._minimum_version],
+            _tls_version_to_st[self._maximum_version],
             self._client_cert,
             self._client_key,
             self._client_key_passphrase,
             self._alpn_protocols,
         )
         return wrapped_socket
+
+    @property
+    def minimum_version(self) -> int:
+        return self._minimum_version
+
+    @minimum_version.setter
+    def minimum_version(self, minimum_version: int) -> None:
+        self._minimum_version = minimum_version
+
+    @property
+    def maximum_version(self) -> int:
+        return self._maximum_version
+
+    @maximum_version.setter
+    def maximum_version(self, maximum_version: int) -> None:
+        self._maximum_version = maximum_version
diff --git a/lib/urllib3/contrib/socks.py b/lib/urllib3/contrib/socks.py
index c326e80d..5e552dda 100644
--- a/lib/urllib3/contrib/socks.py
+++ b/lib/urllib3/contrib/socks.py
@@ -1,4 +1,3 @@
-# -*- coding: utf-8 -*-
 """
 This module contains provisional support for SOCKS proxies from within
 urllib3. This module supports SOCKS4, SOCKS4A (an extension of SOCKS4), and
@@ -38,10 +37,11 @@ with the proxy:
     proxy_url="socks5h://<username>:<password>@proxy-host"
 
 """
-from __future__ import absolute_import
+
+from __future__ import annotations
 
 try:
-    import socks
+    import socks  # type: ignore[import]
 except ImportError:
     import warnings
 
@@ -51,13 +51,13 @@ except ImportError:
         (
             "SOCKS support in urllib3 requires the installation of optional "
             "dependencies: specifically, PySocks.  For more information, see "
-            "https://urllib3.readthedocs.io/en/1.26.x/contrib.html#socks-proxies"
+            "https://urllib3.readthedocs.io/en/latest/contrib.html#socks-proxies"
         ),
         DependencyWarning,
     )
     raise
 
-from socket import error as SocketError
+import typing
 from socket import timeout as SocketTimeout
 
 from ..connection import HTTPConnection, HTTPSConnection
@@ -69,7 +69,21 @@ from ..util.url import parse_url
 try:
     import ssl
 except ImportError:
-    ssl = None
+    ssl = None  # type: ignore[assignment]
+
+try:
+    from typing import TypedDict
+
+    class _TYPE_SOCKS_OPTIONS(TypedDict):
+        socks_version: int
+        proxy_host: str | None
+        proxy_port: str | None
+        username: str | None
+        password: str | None
+        rdns: bool
+
+except ImportError:  # Python 3.7
+    _TYPE_SOCKS_OPTIONS = typing.Dict[str, typing.Any]  # type: ignore[misc, assignment]
 
 
 class SOCKSConnection(HTTPConnection):
@@ -77,15 +91,20 @@ class SOCKSConnection(HTTPConnection):
     A plain-text HTTP connection that connects via a SOCKS proxy.
     """
 
-    def __init__(self, *args, **kwargs):
-        self._socks_options = kwargs.pop("_socks_options")
-        super(SOCKSConnection, self).__init__(*args, **kwargs)
+    def __init__(
+        self,
+        _socks_options: _TYPE_SOCKS_OPTIONS,
+        *args: typing.Any,
+        **kwargs: typing.Any,
+    ) -> None:
+        self._socks_options = _socks_options
+        super().__init__(*args, **kwargs)
 
-    def _new_conn(self):
+    def _new_conn(self) -> socks.socksocket:
         """
         Establish a new connection via the SOCKS proxy.
         """
-        extra_kw = {}
+        extra_kw: dict[str, typing.Any] = {}
         if self.source_address:
             extra_kw["source_address"] = self.source_address
 
@@ -102,15 +121,14 @@ class SOCKSConnection(HTTPConnection):
                 proxy_password=self._socks_options["password"],
                 proxy_rdns=self._socks_options["rdns"],
                 timeout=self.timeout,
-                **extra_kw
+                **extra_kw,
             )
 
-        except SocketTimeout:
+        except SocketTimeout as e:
             raise ConnectTimeoutError(
                 self,
-                "Connection to %s timed out. (connect timeout=%s)"
-                % (self.host, self.timeout),
-            )
+                f"Connection to {self.host} timed out. (connect timeout={self.timeout})",
+            ) from e
 
         except socks.ProxyError as e:
             # This is fragile as hell, but it seems to be the only way to raise
@@ -120,22 +138,23 @@ class SOCKSConnection(HTTPConnection):
                 if isinstance(error, SocketTimeout):
                     raise ConnectTimeoutError(
                         self,
-                        "Connection to %s timed out. (connect timeout=%s)"
-                        % (self.host, self.timeout),
-                    )
+                        f"Connection to {self.host} timed out. (connect timeout={self.timeout})",
+                    ) from e
                 else:
+                    # Adding `from e` messes with coverage somehow, so it's omitted.
+                    # See #2386.
                     raise NewConnectionError(
-                        self, "Failed to establish a new connection: %s" % error
+                        self, f"Failed to establish a new connection: {error}"
                     )
             else:
                 raise NewConnectionError(
-                    self, "Failed to establish a new connection: %s" % e
-                )
+                    self, f"Failed to establish a new connection: {e}"
+                ) from e
 
-        except SocketError as e:  # Defensive: PySocks should catch all these.
+        except OSError as e:  # Defensive: PySocks should catch all these.
             raise NewConnectionError(
-                self, "Failed to establish a new connection: %s" % e
-            )
+                self, f"Failed to establish a new connection: {e}"
+            ) from e
 
         return conn
 
@@ -169,12 +188,12 @@ class SOCKSProxyManager(PoolManager):
 
     def __init__(
         self,
-        proxy_url,
-        username=None,
-        password=None,
-        num_pools=10,
-        headers=None,
-        **connection_pool_kw
+        proxy_url: str,
+        username: str | None = None,
+        password: str | None = None,
+        num_pools: int = 10,
+        headers: typing.Mapping[str, str] | None = None,
+        **connection_pool_kw: typing.Any,
     ):
         parsed = parse_url(proxy_url)
 
@@ -195,7 +214,7 @@ class SOCKSProxyManager(PoolManager):
             socks_version = socks.PROXY_TYPE_SOCKS4
             rdns = True
         else:
-            raise ValueError("Unable to determine SOCKS version from %s" % proxy_url)
+            raise ValueError(f"Unable to determine SOCKS version from {proxy_url}")
 
         self.proxy_url = proxy_url
 
@@ -209,8 +228,6 @@ class SOCKSProxyManager(PoolManager):
         }
         connection_pool_kw["_socks_options"] = socks_options
 
-        super(SOCKSProxyManager, self).__init__(
-            num_pools, headers, **connection_pool_kw
-        )
+        super().__init__(num_pools, headers, **connection_pool_kw)
 
         self.pool_classes_by_scheme = SOCKSProxyManager.pool_classes_by_scheme
diff --git a/lib/urllib3/exceptions.py b/lib/urllib3/exceptions.py
index cba6f3f5..5bb92369 100644
--- a/lib/urllib3/exceptions.py
+++ b/lib/urllib3/exceptions.py
@@ -1,6 +1,16 @@
-from __future__ import absolute_import
+from __future__ import annotations
 
-from .packages.six.moves.http_client import IncompleteRead as httplib_IncompleteRead
+import socket
+import typing
+import warnings
+from email.errors import MessageDefect
+from http.client import IncompleteRead as httplib_IncompleteRead
+
+if typing.TYPE_CHECKING:
+    from .connection import HTTPConnection
+    from .connectionpool import ConnectionPool
+    from .response import HTTPResponse
+    from .util.retry import Retry
 
 # Base Exceptions
 
@@ -8,23 +18,24 @@ from .packages.six.moves.http_client import IncompleteRead as httplib_Incomplete
 class HTTPError(Exception):
     """Base exception used by this module."""
 
-    pass
-
 
 class HTTPWarning(Warning):
     """Base warning used by this module."""
 
-    pass
+
+_TYPE_REDUCE_RESULT = typing.Tuple[
+    typing.Callable[..., object], typing.Tuple[object, ...]
+]
 
 
 class PoolError(HTTPError):
     """Base exception for errors caused within a pool."""
 
-    def __init__(self, pool, message):
+    def __init__(self, pool: ConnectionPool, message: str) -> None:
         self.pool = pool
-        HTTPError.__init__(self, "%s: %s" % (pool, message))
+        super().__init__(f"{pool}: {message}")
 
-    def __reduce__(self):
+    def __reduce__(self) -> _TYPE_REDUCE_RESULT:
         # For pickling purposes.
         return self.__class__, (None, None)
 
@@ -32,11 +43,11 @@ class PoolError(HTTPError):
 class RequestError(PoolError):
     """Base exception for PoolErrors that have associated URLs."""
 
-    def __init__(self, pool, url, message):
+    def __init__(self, pool: ConnectionPool, url: str, message: str) -> None:
         self.url = url
-        PoolError.__init__(self, pool, message)
+        super().__init__(pool, message)
 
-    def __reduce__(self):
+    def __reduce__(self) -> _TYPE_REDUCE_RESULT:
         # For pickling purposes.
         return self.__class__, (None, self.url, None)
 
@@ -44,28 +55,25 @@ class RequestError(PoolError):
 class SSLError(HTTPError):
     """Raised when SSL certificate fails in an HTTPS connection."""
 
-    pass
-
 
 class ProxyError(HTTPError):
     """Raised when the connection to a proxy fails."""
 
-    def __init__(self, message, error, *args):
-        super(ProxyError, self).__init__(message, error, *args)
+    # The original error is also available as __cause__.
+    original_error: Exception
+
+    def __init__(self, message: str, error: Exception) -> None:
+        super().__init__(message, error)
         self.original_error = error
 
 
 class DecodeError(HTTPError):
     """Raised when automatic decoding based on Content-Type fails."""
 
-    pass
-
 
 class ProtocolError(HTTPError):
     """Raised when something unexpected happens mid-request/response."""
 
-    pass
-
 
 #: Renamed to ProtocolError but aliased for backwards compatibility.
 ConnectionError = ProtocolError
@@ -79,33 +87,36 @@ class MaxRetryError(RequestError):
 
     :param pool: The connection pool
     :type pool: :class:`~urllib3.connectionpool.HTTPConnectionPool`
-    :param string url: The requested Url
-    :param exceptions.Exception reason: The underlying error
+    :param str url: The requested Url
+    :param reason: The underlying error
+    :type reason: :class:`Exception`
 
     """
 
-    def __init__(self, pool, url, reason=None):
+    def __init__(
+        self, pool: ConnectionPool, url: str, reason: Exception | None = None
+    ) -> None:
         self.reason = reason
 
-        message = "Max retries exceeded with url: %s (Caused by %r)" % (url, reason)
+        message = f"Max retries exceeded with url: {url} (Caused by {reason!r})"
 
-        RequestError.__init__(self, pool, url, message)
+        super().__init__(pool, url, message)
 
 
 class HostChangedError(RequestError):
     """Raised when an existing pool gets a request for a foreign host."""
 
-    def __init__(self, pool, url, retries=3):
-        message = "Tried to open a foreign host with url: %s" % url
-        RequestError.__init__(self, pool, url, message)
+    def __init__(
+        self, pool: ConnectionPool, url: str, retries: Retry | int = 3
+    ) -> None:
+        message = f"Tried to open a foreign host with url: {url}"
+        super().__init__(pool, url, message)
         self.retries = retries
 
 
 class TimeoutStateError(HTTPError):
     """Raised when passing an invalid state to a timeout"""
 
-    pass
-
 
 class TimeoutError(HTTPError):
     """Raised when a socket timeout error occurs.
@@ -114,53 +125,66 @@ class TimeoutError(HTTPError):
     <ReadTimeoutError>` and :exc:`ConnectTimeoutErrors <ConnectTimeoutError>`.
     """
 
-    pass
-
 
 class ReadTimeoutError(TimeoutError, RequestError):
     """Raised when a socket timeout occurs while receiving data from a server"""
 
-    pass
-
 
 # This timeout error does not have a URL attached and needs to inherit from the
 # base HTTPError
 class ConnectTimeoutError(TimeoutError):
     """Raised when a socket timeout occurs while connecting to a server"""
 
-    pass
 
-
-class NewConnectionError(ConnectTimeoutError, PoolError):
+class NewConnectionError(ConnectTimeoutError, HTTPError):
     """Raised when we fail to establish a new connection. Usually ECONNREFUSED."""
 
-    pass
+    def __init__(self, conn: HTTPConnection, message: str) -> None:
+        self.conn = conn
+        super().__init__(f"{conn}: {message}")
+
+    @property
+    def pool(self) -> HTTPConnection:
+        warnings.warn(
+            "The 'pool' property is deprecated and will be removed "
+            "in urllib3 v2.1.0. Use 'conn' instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+
+        return self.conn
+
+
+class NameResolutionError(NewConnectionError):
+    """Raised when host name resolution fails."""
+
+    def __init__(self, host: str, conn: HTTPConnection, reason: socket.gaierror):
+        message = f"Failed to resolve '{host}' ({reason})"
+        super().__init__(conn, message)
 
 
 class EmptyPoolError(PoolError):
     """Raised when a pool runs out of connections and no more are allowed."""
 
-    pass
+
+class FullPoolError(PoolError):
+    """Raised when we try to add a connection to a full pool in blocking mode."""
 
 
 class ClosedPoolError(PoolError):
     """Raised when a request enters a pool after the pool has been closed."""
 
-    pass
-
 
 class LocationValueError(ValueError, HTTPError):
     """Raised when there is something wrong with a given URL input."""
 
-    pass
-
 
 class LocationParseError(LocationValueError):
     """Raised when get_host or similar fails to parse the URL input."""
 
-    def __init__(self, location):
-        message = "Failed to parse: %s" % location
-        HTTPError.__init__(self, message)
+    def __init__(self, location: str) -> None:
+        message = f"Failed to parse: {location}"
+        super().__init__(message)
 
         self.location = location
 
@@ -168,9 +192,9 @@ class LocationParseError(LocationValueError):
 class URLSchemeUnknown(LocationValueError):
     """Raised when a URL input has an unsupported scheme."""
 
-    def __init__(self, scheme):
-        message = "Not supported URL scheme %s" % scheme
-        super(URLSchemeUnknown, self).__init__(message)
+    def __init__(self, scheme: str):
+        message = f"Not supported URL scheme {scheme}"
+        super().__init__(message)
 
         self.scheme = scheme
 
@@ -185,38 +209,22 @@ class ResponseError(HTTPError):
 class SecurityWarning(HTTPWarning):
     """Warned when performing security reducing actions"""
 
-    pass
-
-
-class SubjectAltNameWarning(SecurityWarning):
-    """Warned when connecting to a host with a certificate missing a SAN."""
-
-    pass
-
 
 class InsecureRequestWarning(SecurityWarning):
     """Warned when making an unverified HTTPS request."""
 
-    pass
+
+class NotOpenSSLWarning(SecurityWarning):
+    """Warned when using unsupported SSL library"""
 
 
 class SystemTimeWarning(SecurityWarning):
     """Warned when system time is suspected to be wrong"""
 
-    pass
-
 
 class InsecurePlatformWarning(SecurityWarning):
     """Warned when certain TLS/SSL configuration is not available on a platform."""
 
-    pass
-
-
-class SNIMissingWarning(HTTPWarning):
-    """Warned when making a HTTPS request without SNI available."""
-
-    pass
-
 
 class DependencyWarning(HTTPWarning):
     """
@@ -224,14 +232,10 @@ class DependencyWarning(HTTPWarning):
     dependencies.
     """
 
-    pass
-
 
 class ResponseNotChunked(ProtocolError, ValueError):
     """Response needs to be chunked in order to read it as chunks."""
 
-    pass
-
 
 class BodyNotHttplibCompatible(HTTPError):
     """
@@ -239,8 +243,6 @@ class BodyNotHttplibCompatible(HTTPError):
     (have an fp attribute which returns raw chunks) for read_chunked().
     """
 
-    pass
-
 
 class IncompleteRead(HTTPError, httplib_IncompleteRead):
     """
@@ -250,12 +252,13 @@ class IncompleteRead(HTTPError, httplib_IncompleteRead):
     for ``partial`` to avoid creating large objects on streamed reads.
     """
 
-    def __init__(self, partial, expected):
-        super(IncompleteRead, self).__init__(partial, expected)
+    def __init__(self, partial: int, expected: int) -> None:
+        self.partial = partial  # type: ignore[assignment]
+        self.expected = expected
 
-    def __repr__(self):
+    def __repr__(self) -> str:
         return "IncompleteRead(%i bytes read, %i more expected)" % (
-            self.partial,
+            self.partial,  # type: ignore[str-format]
             self.expected,
         )
 
@@ -263,14 +266,13 @@ class IncompleteRead(HTTPError, httplib_IncompleteRead):
 class InvalidChunkLength(HTTPError, httplib_IncompleteRead):
     """Invalid chunk length in a chunked response."""
 
-    def __init__(self, response, length):
-        super(InvalidChunkLength, self).__init__(
-            response.tell(), response.length_remaining
-        )
+    def __init__(self, response: HTTPResponse, length: bytes) -> None:
+        self.partial: int = response.tell()  # type: ignore[assignment]
+        self.expected: int | None = response.length_remaining
         self.response = response
         self.length = length
 
-    def __repr__(self):
+    def __repr__(self) -> str:
         return "InvalidChunkLength(got length %r, %i bytes read)" % (
             self.length,
             self.partial,
@@ -280,15 +282,13 @@ class InvalidChunkLength(HTTPError, httplib_IncompleteRead):
 class InvalidHeader(HTTPError):
     """The header provided was somehow invalid."""
 
-    pass
-
 
 class ProxySchemeUnknown(AssertionError, URLSchemeUnknown):
     """ProxyManager does not support the supplied scheme"""
 
     # TODO(t-8ch): Stop inheriting from AssertionError in v2.0.
 
-    def __init__(self, scheme):
+    def __init__(self, scheme: str | None) -> None:
         # 'localhost' is here because our URL parser parses
         # localhost:8080 -> scheme=localhost, remove if we fix this.
         if scheme == "localhost":
@@ -296,28 +296,23 @@ class ProxySchemeUnknown(AssertionError, URLSchemeUnknown):
         if scheme is None:
             message = "Proxy URL had no scheme, should start with http:// or https://"
         else:
-            message = (
-                "Proxy URL had unsupported scheme %s, should use http:// or https://"
-                % scheme
-            )
-        super(ProxySchemeUnknown, self).__init__(message)
+            message = f"Proxy URL had unsupported scheme {scheme}, should use http:// or https://"
+        super().__init__(message)
 
 
 class ProxySchemeUnsupported(ValueError):
     """Fetching HTTPS resources through HTTPS proxies is unsupported"""
 
-    pass
-
 
 class HeaderParsingError(HTTPError):
     """Raised by assert_header_parsing, but we convert it to a log.warning statement."""
 
-    def __init__(self, defects, unparsed_data):
-        message = "%s, unparsed data: %r" % (defects or "Unknown", unparsed_data)
-        super(HeaderParsingError, self).__init__(message)
+    def __init__(
+        self, defects: list[MessageDefect], unparsed_data: bytes | str | None
+    ) -> None:
+        message = f"{defects or 'Unknown'}, unparsed data: {unparsed_data!r}"
+        super().__init__(message)
 
 
 class UnrewindableBodyError(HTTPError):
     """urllib3 encountered an error when trying to rewind a body"""
-
-    pass
diff --git a/lib/urllib3/fields.py b/lib/urllib3/fields.py
index 9d630f49..51d898e2 100644
--- a/lib/urllib3/fields.py
+++ b/lib/urllib3/fields.py
@@ -1,13 +1,20 @@
-from __future__ import absolute_import
+from __future__ import annotations
 
 import email.utils
 import mimetypes
-import re
+import typing
 
-from .packages import six
+_TYPE_FIELD_VALUE = typing.Union[str, bytes]
+_TYPE_FIELD_VALUE_TUPLE = typing.Union[
+    _TYPE_FIELD_VALUE,
+    typing.Tuple[str, _TYPE_FIELD_VALUE],
+    typing.Tuple[str, _TYPE_FIELD_VALUE, str],
+]
 
 
-def guess_content_type(filename, default="application/octet-stream"):
+def guess_content_type(
+    filename: str | None, default: str = "application/octet-stream"
+) -> str:
     """
     Guess the "Content-Type" of a file.
 
@@ -21,7 +28,7 @@ def guess_content_type(filename, default="application/octet-stream"):
     return default
 
 
-def format_header_param_rfc2231(name, value):
+def format_header_param_rfc2231(name: str, value: _TYPE_FIELD_VALUE) -> str:
     """
     Helper function to format and quote a single header parameter using the
     strategy defined in RFC 2231.
@@ -34,14 +41,28 @@ def format_header_param_rfc2231(name, value):
         The name of the parameter, a string expected to be ASCII only.
     :param value:
         The value of the parameter, provided as ``bytes`` or `str``.
-    :ret:
+    :returns:
         An RFC-2231-formatted unicode string.
+
+    .. deprecated:: 2.0.0
+        Will be removed in urllib3 v2.1.0. This is not valid for
+        ``multipart/form-data`` header parameters.
     """
-    if isinstance(value, six.binary_type):
+    import warnings
+
+    warnings.warn(
+        "'format_header_param_rfc2231' is deprecated and will be "
+        "removed in urllib3 v2.1.0. This is not valid for "
+        "multipart/form-data header parameters.",
+        DeprecationWarning,
+        stacklevel=2,
+    )
+
+    if isinstance(value, bytes):
         value = value.decode("utf-8")
 
     if not any(ch in value for ch in '"\\\r\n'):
-        result = u'%s="%s"' % (name, value)
+        result = f'{name}="{value}"'
         try:
             result.encode("ascii")
         except (UnicodeEncodeError, UnicodeDecodeError):
@@ -49,81 +70,87 @@ def format_header_param_rfc2231(name, value):
         else:
             return result
 
-    if six.PY2:  # Python 2:
-        value = value.encode("utf-8")
-
-    # encode_rfc2231 accepts an encoded string and returns an ascii-encoded
-    # string in Python 2 but accepts and returns unicode strings in Python 3
     value = email.utils.encode_rfc2231(value, "utf-8")
-    value = "%s*=%s" % (name, value)
-
-    if six.PY2:  # Python 2:
-        value = value.decode("utf-8")
+    value = f"{name}*={value}"
 
     return value
 
 
-_HTML5_REPLACEMENTS = {
-    u"\u0022": u"%22",
-    # Replace "\" with "\\".
-    u"\u005C": u"\u005C\u005C",
-}
-
-# All control characters from 0x00 to 0x1F *except* 0x1B.
-_HTML5_REPLACEMENTS.update(
-    {
-        six.unichr(cc): u"%{:02X}".format(cc)
-        for cc in range(0x00, 0x1F + 1)
-        if cc not in (0x1B,)
-    }
-)
-
-
-def _replace_multiple(value, needles_and_replacements):
-    def replacer(match):
-        return needles_and_replacements[match.group(0)]
-
-    pattern = re.compile(
-        r"|".join([re.escape(needle) for needle in needles_and_replacements.keys()])
-    )
-
-    result = pattern.sub(replacer, value)
-
-    return result
-
-
-def format_header_param_html5(name, value):
+def format_multipart_header_param(name: str, value: _TYPE_FIELD_VALUE) -> str:
     """
-    Helper function to format and quote a single header parameter using the
-    HTML5 strategy.
+    Format and quote a single multipart header parameter.
 
-    Particularly useful for header parameters which might contain
-    non-ASCII values, like file names. This follows the `HTML5 Working Draft
-    Section 4.10.22.7`_ and matches the behavior of curl and modern browsers.
+    This follows the `WHATWG HTML Standard`_ as of 2021/06/10, matching
+    the behavior of current browser and curl versions. Values are
+    assumed to be UTF-8. The ``\\n``, ``\\r``, and ``"`` characters are
+    percent encoded.
 
-    .. _HTML5 Working Draft Section 4.10.22.7:
-        https://w3c.github.io/html/sec-forms.html#multipart-form-data
+    .. _WHATWG HTML Standard:
+        https://html.spec.whatwg.org/multipage/
+        form-control-infrastructure.html#multipart-form-data
 
     :param name:
-        The name of the parameter, a string expected to be ASCII only.
+        The name of the parameter, an ASCII-only ``str``.
     :param value:
-        The value of the parameter, provided as ``bytes`` or `str``.
-    :ret:
-        A unicode string, stripped of troublesome characters.
+        The value of the parameter, a ``str`` or UTF-8 encoded
+        ``bytes``.
+    :returns:
+        A string ``name="value"`` with the escaped value.
+
+    .. versionchanged:: 2.0.0
+        Matches the WHATWG HTML Standard as of 2021/06/10. Control
+        characters are no longer percent encoded.
+
+    .. versionchanged:: 2.0.0
+        Renamed from ``format_header_param_html5`` and
+        ``format_header_param``. The old names will be removed in
+        urllib3 v2.1.0.
     """
-    if isinstance(value, six.binary_type):
+    if isinstance(value, bytes):
         value = value.decode("utf-8")
 
-    value = _replace_multiple(value, _HTML5_REPLACEMENTS)
-
-    return u'%s="%s"' % (name, value)
+    # percent encode \n \r "
+    value = value.translate({10: "%0A", 13: "%0D", 34: "%22"})
+    return f'{name}="{value}"'
 
 
-# For backwards-compatibility.
-format_header_param = format_header_param_html5
+def format_header_param_html5(name: str, value: _TYPE_FIELD_VALUE) -> str:
+    """
+    .. deprecated:: 2.0.0
+        Renamed to :func:`format_multipart_header_param`. Will be
+        removed in urllib3 v2.1.0.
+    """
+    import warnings
+
+    warnings.warn(
+        "'format_header_param_html5' has been renamed to "
+        "'format_multipart_header_param'. The old name will be "
+        "removed in urllib3 v2.1.0.",
+        DeprecationWarning,
+        stacklevel=2,
+    )
+    return format_multipart_header_param(name, value)
 
 
-class RequestField(object):
+def format_header_param(name: str, value: _TYPE_FIELD_VALUE) -> str:
+    """
+    .. deprecated:: 2.0.0
+        Renamed to :func:`format_multipart_header_param`. Will be
+        removed in urllib3 v2.1.0.
+    """
+    import warnings
+
+    warnings.warn(
+        "'format_header_param' has been renamed to "
+        "'format_multipart_header_param'. The old name will be "
+        "removed in urllib3 v2.1.0.",
+        DeprecationWarning,
+        stacklevel=2,
+    )
+    return format_multipart_header_param(name, value)
+
+
+class RequestField:
     """
     A data container for request body parameters.
 
@@ -135,29 +162,47 @@ class RequestField(object):
         An optional filename of the request field. Must be unicode.
     :param headers:
         An optional dict-like object of headers to initially use for the field.
-    :param header_formatter:
-        An optional callable that is used to encode and format the headers. By
-        default, this is :func:`format_header_param_html5`.
+
+    .. versionchanged:: 2.0.0
+        The ``header_formatter`` parameter is deprecated and will
+        be removed in urllib3 v2.1.0.
     """
 
     def __init__(
         self,
-        name,
-        data,
-        filename=None,
-        headers=None,
-        header_formatter=format_header_param_html5,
+        name: str,
+        data: _TYPE_FIELD_VALUE,
+        filename: str | None = None,
+        headers: typing.Mapping[str, str] | None = None,
+        header_formatter: typing.Callable[[str, _TYPE_FIELD_VALUE], str] | None = None,
     ):
         self._name = name
         self._filename = filename
         self.data = data
-        self.headers = {}
+        self.headers: dict[str, str | None] = {}
         if headers:
             self.headers = dict(headers)
-        self.header_formatter = header_formatter
+
+        if header_formatter is not None:
+            import warnings
+
+            warnings.warn(
+                "The 'header_formatter' parameter is deprecated and "
+                "will be removed in urllib3 v2.1.0.",
+                DeprecationWarning,
+                stacklevel=2,
+            )
+            self.header_formatter = header_formatter
+        else:
+            self.header_formatter = format_multipart_header_param
 
     @classmethod
-    def from_tuples(cls, fieldname, value, header_formatter=format_header_param_html5):
+    def from_tuples(
+        cls,
+        fieldname: str,
+        value: _TYPE_FIELD_VALUE_TUPLE,
+        header_formatter: typing.Callable[[str, _TYPE_FIELD_VALUE], str] | None = None,
+    ) -> RequestField:
         """
         A :class:`~urllib3.fields.RequestField` factory from old-style tuple parameters.
 
@@ -174,11 +219,19 @@ class RequestField(object):
 
         Field names and filenames must be unicode.
         """
+        filename: str | None
+        content_type: str | None
+        data: _TYPE_FIELD_VALUE
+
         if isinstance(value, tuple):
             if len(value) == 3:
-                filename, data, content_type = value
+                filename, data, content_type = typing.cast(
+                    typing.Tuple[str, _TYPE_FIELD_VALUE, str], value
+                )
             else:
-                filename, data = value
+                filename, data = typing.cast(
+                    typing.Tuple[str, _TYPE_FIELD_VALUE], value
+                )
                 content_type = guess_content_type(filename)
         else:
             filename = None
@@ -192,20 +245,29 @@ class RequestField(object):
 
         return request_param
 
-    def _render_part(self, name, value):
+    def _render_part(self, name: str, value: _TYPE_FIELD_VALUE) -> str:
         """
-        Overridable helper function to format a single header parameter. By
-        default, this calls ``self.header_formatter``.
+        Override this method to change how each multipart header
+        parameter is formatted. By default, this calls
+        :func:`format_multipart_header_param`.
 
         :param name:
-            The name of the parameter, a string expected to be ASCII only.
+            The name of the parameter, an ASCII-only ``str``.
         :param value:
-            The value of the parameter, provided as a unicode string.
-        """
+            The value of the parameter, a ``str`` or UTF-8 encoded
+            ``bytes``.
 
+        :meta public:
+        """
         return self.header_formatter(name, value)
 
-    def _render_parts(self, header_parts):
+    def _render_parts(
+        self,
+        header_parts: (
+            dict[str, _TYPE_FIELD_VALUE | None]
+            | typing.Sequence[tuple[str, _TYPE_FIELD_VALUE | None]]
+        ),
+    ) -> str:
         """
         Helper function to format and quote a single header.
 
@@ -216,18 +278,21 @@ class RequestField(object):
             A sequence of (k, v) tuples or a :class:`dict` of (k, v) to format
             as `k1="v1"; k2="v2"; ...`.
         """
+        iterable: typing.Iterable[tuple[str, _TYPE_FIELD_VALUE | None]]
+
         parts = []
-        iterable = header_parts
         if isinstance(header_parts, dict):
             iterable = header_parts.items()
+        else:
+            iterable = header_parts
 
         for name, value in iterable:
             if value is not None:
                 parts.append(self._render_part(name, value))
 
-        return u"; ".join(parts)
+        return "; ".join(parts)
 
-    def render_headers(self):
+    def render_headers(self) -> str:
         """
         Renders the headers for this request field.
         """
@@ -236,39 +301,45 @@ class RequestField(object):
         sort_keys = ["Content-Disposition", "Content-Type", "Content-Location"]
         for sort_key in sort_keys:
             if self.headers.get(sort_key, False):
-                lines.append(u"%s: %s" % (sort_key, self.headers[sort_key]))
+                lines.append(f"{sort_key}: {self.headers[sort_key]}")
 
         for header_name, header_value in self.headers.items():
             if header_name not in sort_keys:
                 if header_value:
-                    lines.append(u"%s: %s" % (header_name, header_value))
+                    lines.append(f"{header_name}: {header_value}")
 
-        lines.append(u"\r\n")
-        return u"\r\n".join(lines)
+        lines.append("\r\n")
+        return "\r\n".join(lines)
 
     def make_multipart(
-        self, content_disposition=None, content_type=None, content_location=None
-    ):
+        self,
+        content_disposition: str | None = None,
+        content_type: str | None = None,
+        content_location: str | None = None,
+    ) -> None:
         """
         Makes this request field into a multipart request field.
 
         This method overrides "Content-Disposition", "Content-Type" and
         "Content-Location" headers to the request parameter.
 
+        :param content_disposition:
+            The 'Content-Disposition' of the request body. Defaults to 'form-data'
         :param content_type:
             The 'Content-Type' of the request body.
         :param content_location:
             The 'Content-Location' of the request body.
 
         """
-        self.headers["Content-Disposition"] = content_disposition or u"form-data"
-        self.headers["Content-Disposition"] += u"; ".join(
+        content_disposition = (content_disposition or "form-data") + "; ".join(
             [
-                u"",
+                "",
                 self._render_parts(
-                    ((u"name", self._name), (u"filename", self._filename))
+                    (("name", self._name), ("filename", self._filename))
                 ),
             ]
         )
+
+        self.headers["Content-Disposition"] = content_disposition
         self.headers["Content-Type"] = content_type
         self.headers["Content-Location"] = content_location
diff --git a/lib/urllib3/filepost.py b/lib/urllib3/filepost.py
index 36c9252c..1c90a211 100644
--- a/lib/urllib3/filepost.py
+++ b/lib/urllib3/filepost.py
@@ -1,28 +1,32 @@
-from __future__ import absolute_import
+from __future__ import annotations
 
 import binascii
 import codecs
 import os
+import typing
 from io import BytesIO
 
-from .fields import RequestField
-from .packages import six
-from .packages.six import b
+from .fields import _TYPE_FIELD_VALUE_TUPLE, RequestField
 
 writer = codecs.lookup("utf-8")[3]
 
+_TYPE_FIELDS_SEQUENCE = typing.Sequence[
+    typing.Union[typing.Tuple[str, _TYPE_FIELD_VALUE_TUPLE], RequestField]
+]
+_TYPE_FIELDS = typing.Union[
+    _TYPE_FIELDS_SEQUENCE,
+    typing.Mapping[str, _TYPE_FIELD_VALUE_TUPLE],
+]
 
-def choose_boundary():
+
+def choose_boundary() -> str:
     """
     Our embarrassingly-simple replacement for mimetools.choose_boundary.
     """
-    boundary = binascii.hexlify(os.urandom(16))
-    if not six.PY2:
-        boundary = boundary.decode("ascii")
-    return boundary
+    return binascii.hexlify(os.urandom(16)).decode()
 
 
-def iter_field_objects(fields):
+def iter_field_objects(fields: _TYPE_FIELDS) -> typing.Iterable[RequestField]:
     """
     Iterate over fields.
 
@@ -30,42 +34,29 @@ def iter_field_objects(fields):
     :class:`~urllib3.fields.RequestField`.
 
     """
-    if isinstance(fields, dict):
-        i = six.iteritems(fields)
-    else:
-        i = iter(fields)
+    iterable: typing.Iterable[RequestField | tuple[str, _TYPE_FIELD_VALUE_TUPLE]]
 
-    for field in i:
+    if isinstance(fields, typing.Mapping):
+        iterable = fields.items()
+    else:
+        iterable = fields
+
+    for field in iterable:
         if isinstance(field, RequestField):
             yield field
         else:
             yield RequestField.from_tuples(*field)
 
 
-def iter_fields(fields):
-    """
-    .. deprecated:: 1.6
-
-    Iterate over fields.
-
-    The addition of :class:`~urllib3.fields.RequestField` makes this function
-    obsolete. Instead, use :func:`iter_field_objects`, which returns
-    :class:`~urllib3.fields.RequestField` objects.
-
-    Supports list of (k, v) tuples and dicts.
-    """
-    if isinstance(fields, dict):
-        return ((k, v) for k, v in six.iteritems(fields))
-
-    return ((k, v) for k, v in fields)
-
-
-def encode_multipart_formdata(fields, boundary=None):
+def encode_multipart_formdata(
+    fields: _TYPE_FIELDS, boundary: str | None = None
+) -> tuple[bytes, str]:
     """
     Encode a dictionary of ``fields`` using the multipart/form-data MIME format.
 
     :param fields:
         Dictionary of fields or list of (key, :class:`~urllib3.fields.RequestField`).
+        Values are processed by :func:`urllib3.fields.RequestField.from_tuples`.
 
     :param boundary:
         If not specified, then a random boundary will be generated using
@@ -76,7 +67,7 @@ def encode_multipart_formdata(fields, boundary=None):
         boundary = choose_boundary()
 
     for field in iter_field_objects(fields):
-        body.write(b("--%s\r\n" % (boundary)))
+        body.write(f"--{boundary}\r\n".encode("latin-1"))
 
         writer(body).write(field.render_headers())
         data = field.data
@@ -84,15 +75,15 @@ def encode_multipart_formdata(fields, boundary=None):
         if isinstance(data, int):
             data = str(data)  # Backwards compatibility
 
-        if isinstance(data, six.text_type):
+        if isinstance(data, str):
             writer(body).write(data)
         else:
             body.write(data)
 
         body.write(b"\r\n")
 
-    body.write(b("--%s--\r\n" % (boundary)))
+    body.write(f"--{boundary}--\r\n".encode("latin-1"))
 
-    content_type = str("multipart/form-data; boundary=%s" % boundary)
+    content_type = f"multipart/form-data; boundary={boundary}"
 
     return body.getvalue(), content_type
diff --git a/lib/urllib3/packages/__init__.py b/lib/urllib3/packages/__init__.py
deleted file mode 100644
index e69de29b..00000000
diff --git a/lib/urllib3/packages/backports/__init__.py b/lib/urllib3/packages/backports/__init__.py
deleted file mode 100644
index e69de29b..00000000
diff --git a/lib/urllib3/packages/backports/makefile.py b/lib/urllib3/packages/backports/makefile.py
deleted file mode 100644
index b8fb2154..00000000
--- a/lib/urllib3/packages/backports/makefile.py
+++ /dev/null
@@ -1,51 +0,0 @@
-# -*- coding: utf-8 -*-
-"""
-backports.makefile
-~~~~~~~~~~~~~~~~~~
-
-Backports the Python 3 ``socket.makefile`` method for use with anything that
-wants to create a "fake" socket object.
-"""
-import io
-from socket import SocketIO
-
-
-def backport_makefile(
-    self, mode="r", buffering=None, encoding=None, errors=None, newline=None
-):
-    """
-    Backport of ``socket.makefile`` from Python 3.5.
-    """
-    if not set(mode) <= {"r", "w", "b"}:
-        raise ValueError("invalid mode %r (only r, w, b allowed)" % (mode,))
-    writing = "w" in mode
-    reading = "r" in mode or not writing
-    assert reading or writing
-    binary = "b" in mode
-    rawmode = ""
-    if reading:
-        rawmode += "r"
-    if writing:
-        rawmode += "w"
-    raw = SocketIO(self, rawmode)
-    self._makefile_refs += 1
-    if buffering is None:
-        buffering = -1
-    if buffering < 0:
-        buffering = io.DEFAULT_BUFFER_SIZE
-    if buffering == 0:
-        if not binary:
-            raise ValueError("unbuffered streams must be binary")
-        return raw
-    if reading and writing:
-        buffer = io.BufferedRWPair(raw, raw, buffering)
-    elif reading:
-        buffer = io.BufferedReader(raw, buffering)
-    else:
-        assert writing
-        buffer = io.BufferedWriter(raw, buffering)
-    if binary:
-        return buffer
-    text = io.TextIOWrapper(buffer, encoding, errors, newline)
-    text.mode = mode
-    return text
diff --git a/lib/urllib3/packages/six.py b/lib/urllib3/packages/six.py
deleted file mode 100644
index f099a3dc..00000000
--- a/lib/urllib3/packages/six.py
+++ /dev/null
@@ -1,1076 +0,0 @@
-# Copyright (c) 2010-2020 Benjamin Peterson
-#
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-#
-# The above copyright notice and this permission notice shall be included in all
-# copies or substantial portions of the Software.
-#
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-# SOFTWARE.
-
-"""Utilities for writing code that runs on Python 2 and 3"""
-
-from __future__ import absolute_import
-
-import functools
-import itertools
-import operator
-import sys
-import types
-
-__author__ = "Benjamin Peterson <benjamin@python.org>"
-__version__ = "1.16.0"
-
-
-# Useful for very coarse version differentiation.
-PY2 = sys.version_info[0] == 2
-PY3 = sys.version_info[0] == 3
-PY34 = sys.version_info[0:2] >= (3, 4)
-
-if PY3:
-    string_types = (str,)
-    integer_types = (int,)
-    class_types = (type,)
-    text_type = str
-    binary_type = bytes
-
-    MAXSIZE = sys.maxsize
-else:
-    string_types = (basestring,)
-    integer_types = (int, long)
-    class_types = (type, types.ClassType)
-    text_type = unicode
-    binary_type = str
-
-    if sys.platform.startswith("java"):
-        # Jython always uses 32 bits.
-        MAXSIZE = int((1 << 31) - 1)
-    else:
-        # It's possible to have sizeof(long) != sizeof(Py_ssize_t).
-        class X(object):
-            def __len__(self):
-                return 1 << 31
-
-        try:
-            len(X())
-        except OverflowError:
-            # 32-bit
-            MAXSIZE = int((1 << 31) - 1)
-        else:
-            # 64-bit
-            MAXSIZE = int((1 << 63) - 1)
-        del X
-
-if PY34:
-    from importlib.util import spec_from_loader
-else:
-    spec_from_loader = None
-
-
-def _add_doc(func, doc):
-    """Add documentation to a function."""
-    func.__doc__ = doc
-
-
-def _import_module(name):
-    """Import module, returning the module after the last dot."""
-    __import__(name)
-    return sys.modules[name]
-
-
-class _LazyDescr(object):
-    def __init__(self, name):
-        self.name = name
-
-    def __get__(self, obj, tp):
-        result = self._resolve()
-        setattr(obj, self.name, result)  # Invokes __set__.
-        try:
-            # This is a bit ugly, but it avoids running this again by
-            # removing this descriptor.
-            delattr(obj.__class__, self.name)
-        except AttributeError:
-            pass
-        return result
-
-
-class MovedModule(_LazyDescr):
-    def __init__(self, name, old, new=None):
-        super(MovedModule, self).__init__(name)
-        if PY3:
-            if new is None:
-                new = name
-            self.mod = new
-        else:
-            self.mod = old
-
-    def _resolve(self):
-        return _import_module(self.mod)
-
-    def __getattr__(self, attr):
-        _module = self._resolve()
-        value = getattr(_module, attr)
-        setattr(self, attr, value)
-        return value
-
-
-class _LazyModule(types.ModuleType):
-    def __init__(self, name):
-        super(_LazyModule, self).__init__(name)
-        self.__doc__ = self.__class__.__doc__
-
-    def __dir__(self):
-        attrs = ["__doc__", "__name__"]
-        attrs += [attr.name for attr in self._moved_attributes]
-        return attrs
-
-    # Subclasses should override this
-    _moved_attributes = []
-
-
-class MovedAttribute(_LazyDescr):
-    def __init__(self, name, old_mod, new_mod, old_attr=None, new_attr=None):
-        super(MovedAttribute, self).__init__(name)
-        if PY3:
-            if new_mod is None:
-                new_mod = name
-            self.mod = new_mod
-            if new_attr is None:
-                if old_attr is None:
-                    new_attr = name
-                else:
-                    new_attr = old_attr
-            self.attr = new_attr
-        else:
-            self.mod = old_mod
-            if old_attr is None:
-                old_attr = name
-            self.attr = old_attr
-
-    def _resolve(self):
-        module = _import_module(self.mod)
-        return getattr(module, self.attr)
-
-
-class _SixMetaPathImporter(object):
-
-    """
-    A meta path importer to import six.moves and its submodules.
-
-    This class implements a PEP302 finder and loader. It should be compatible
-    with Python 2.5 and all existing versions of Python3
-    """
-
-    def __init__(self, six_module_name):
-        self.name = six_module_name
-        self.known_modules = {}
-
-    def _add_module(self, mod, *fullnames):
-        for fullname in fullnames:
-            self.known_modules[self.name + "." + fullname] = mod
-
-    def _get_module(self, fullname):
-        return self.known_modules[self.name + "." + fullname]
-
-    def find_module(self, fullname, path=None):
-        if fullname in self.known_modules:
-            return self
-        return None
-
-    def find_spec(self, fullname, path, target=None):
-        if fullname in self.known_modules:
-            return spec_from_loader(fullname, self)
-        return None
-
-    def __get_module(self, fullname):
-        try:
-            return self.known_modules[fullname]
-        except KeyError:
-            raise ImportError("This loader does not know module " + fullname)
-
-    def load_module(self, fullname):
-        try:
-            # in case of a reload
-            return sys.modules[fullname]
-        except KeyError:
-            pass
-        mod = self.__get_module(fullname)
-        if isinstance(mod, MovedModule):
-            mod = mod._resolve()
-        else:
-            mod.__loader__ = self
-        sys.modules[fullname] = mod
-        return mod
-
-    def is_package(self, fullname):
-        """
-        Return true, if the named module is a package.
-
-        We need this method to get correct spec objects with
-        Python 3.4 (see PEP451)
-        """
-        return hasattr(self.__get_module(fullname), "__path__")
-
-    def get_code(self, fullname):
-        """Return None
-
-        Required, if is_package is implemented"""
-        self.__get_module(fullname)  # eventually raises ImportError
-        return None
-
-    get_source = get_code  # same as get_code
-
-    def create_module(self, spec):
-        return self.load_module(spec.name)
-
-    def exec_module(self, module):
-        pass
-
-
-_importer = _SixMetaPathImporter(__name__)
-
-
-class _MovedItems(_LazyModule):
-
-    """Lazy loading of moved objects"""
-
-    __path__ = []  # mark as package
-
-
-_moved_attributes = [
-    MovedAttribute("cStringIO", "cStringIO", "io", "StringIO"),
-    MovedAttribute("filter", "itertools", "builtins", "ifilter", "filter"),
-    MovedAttribute(
-        "filterfalse", "itertools", "itertools", "ifilterfalse", "filterfalse"
-    ),
-    MovedAttribute("input", "__builtin__", "builtins", "raw_input", "input"),
-    MovedAttribute("intern", "__builtin__", "sys"),
-    MovedAttribute("map", "itertools", "builtins", "imap", "map"),
-    MovedAttribute("getcwd", "os", "os", "getcwdu", "getcwd"),
-    MovedAttribute("getcwdb", "os", "os", "getcwd", "getcwdb"),
-    MovedAttribute("getoutput", "commands", "subprocess"),
-    MovedAttribute("range", "__builtin__", "builtins", "xrange", "range"),
-    MovedAttribute(
-        "reload_module", "__builtin__", "importlib" if PY34 else "imp", "reload"
-    ),
-    MovedAttribute("reduce", "__builtin__", "functools"),
-    MovedAttribute("shlex_quote", "pipes", "shlex", "quote"),
-    MovedAttribute("StringIO", "StringIO", "io"),
-    MovedAttribute("UserDict", "UserDict", "collections"),
-    MovedAttribute("UserList", "UserList", "collections"),
-    MovedAttribute("UserString", "UserString", "collections"),
-    MovedAttribute("xrange", "__builtin__", "builtins", "xrange", "range"),
-    MovedAttribute("zip", "itertools", "builtins", "izip", "zip"),
-    MovedAttribute(
-        "zip_longest", "itertools", "itertools", "izip_longest", "zip_longest"
-    ),
-    MovedModule("builtins", "__builtin__"),
-    MovedModule("configparser", "ConfigParser"),
-    MovedModule(
-        "collections_abc",
-        "collections",
-        "collections.abc" if sys.version_info >= (3, 3) else "collections",
-    ),
-    MovedModule("copyreg", "copy_reg"),
-    MovedModule("dbm_gnu", "gdbm", "dbm.gnu"),
-    MovedModule("dbm_ndbm", "dbm", "dbm.ndbm"),
-    MovedModule(
-        "_dummy_thread",
-        "dummy_thread",
-        "_dummy_thread" if sys.version_info < (3, 9) else "_thread",
-    ),
-    MovedModule("http_cookiejar", "cookielib", "http.cookiejar"),
-    MovedModule("http_cookies", "Cookie", "http.cookies"),
-    MovedModule("html_entities", "htmlentitydefs", "html.entities"),
-    MovedModule("html_parser", "HTMLParser", "html.parser"),
-    MovedModule("http_client", "httplib", "http.client"),
-    MovedModule("email_mime_base", "email.MIMEBase", "email.mime.base"),
-    MovedModule("email_mime_image", "email.MIMEImage", "email.mime.image"),
-    MovedModule("email_mime_multipart", "email.MIMEMultipart", "email.mime.multipart"),
-    MovedModule(
-        "email_mime_nonmultipart", "email.MIMENonMultipart", "email.mime.nonmultipart"
-    ),
-    MovedModule("email_mime_text", "email.MIMEText", "email.mime.text"),
-    MovedModule("BaseHTTPServer", "BaseHTTPServer", "http.server"),
-    MovedModule("CGIHTTPServer", "CGIHTTPServer", "http.server"),
-    MovedModule("SimpleHTTPServer", "SimpleHTTPServer", "http.server"),
-    MovedModule("cPickle", "cPickle", "pickle"),
-    MovedModule("queue", "Queue"),
-    MovedModule("reprlib", "repr"),
-    MovedModule("socketserver", "SocketServer"),
-    MovedModule("_thread", "thread", "_thread"),
-    MovedModule("tkinter", "Tkinter"),
-    MovedModule("tkinter_dialog", "Dialog", "tkinter.dialog"),
-    MovedModule("tkinter_filedialog", "FileDialog", "tkinter.filedialog"),
-    MovedModule("tkinter_scrolledtext", "ScrolledText", "tkinter.scrolledtext"),
-    MovedModule("tkinter_simpledialog", "SimpleDialog", "tkinter.simpledialog"),
-    MovedModule("tkinter_tix", "Tix", "tkinter.tix"),
-    MovedModule("tkinter_ttk", "ttk", "tkinter.ttk"),
-    MovedModule("tkinter_constants", "Tkconstants", "tkinter.constants"),
-    MovedModule("tkinter_dnd", "Tkdnd", "tkinter.dnd"),
-    MovedModule("tkinter_colorchooser", "tkColorChooser", "tkinter.colorchooser"),
-    MovedModule("tkinter_commondialog", "tkCommonDialog", "tkinter.commondialog"),
-    MovedModule("tkinter_tkfiledialog", "tkFileDialog", "tkinter.filedialog"),
-    MovedModule("tkinter_font", "tkFont", "tkinter.font"),
-    MovedModule("tkinter_messagebox", "tkMessageBox", "tkinter.messagebox"),
-    MovedModule("tkinter_tksimpledialog", "tkSimpleDialog", "tkinter.simpledialog"),
-    MovedModule("urllib_parse", __name__ + ".moves.urllib_parse", "urllib.parse"),
-    MovedModule("urllib_error", __name__ + ".moves.urllib_error", "urllib.error"),
-    MovedModule("urllib", __name__ + ".moves.urllib", __name__ + ".moves.urllib"),
-    MovedModule("urllib_robotparser", "robotparser", "urllib.robotparser"),
-    MovedModule("xmlrpc_client", "xmlrpclib", "xmlrpc.client"),
-    MovedModule("xmlrpc_server", "SimpleXMLRPCServer", "xmlrpc.server"),
-]
-# Add windows specific modules.
-if sys.platform == "win32":
-    _moved_attributes += [
-        MovedModule("winreg", "_winreg"),
-    ]
-
-for attr in _moved_attributes:
-    setattr(_MovedItems, attr.name, attr)
-    if isinstance(attr, MovedModule):
-        _importer._add_module(attr, "moves." + attr.name)
-del attr
-
-_MovedItems._moved_attributes = _moved_attributes
-
-moves = _MovedItems(__name__ + ".moves")
-_importer._add_module(moves, "moves")
-
-
-class Module_six_moves_urllib_parse(_LazyModule):
-
-    """Lazy loading of moved objects in six.moves.urllib_parse"""
-
-
-_urllib_parse_moved_attributes = [
-    MovedAttribute("ParseResult", "urlparse", "urllib.parse"),
-    MovedAttribute("SplitResult", "urlparse", "urllib.parse"),
-    MovedAttribute("parse_qs", "urlparse", "urllib.parse"),
-    MovedAttribute("parse_qsl", "urlparse", "urllib.parse"),
-    MovedAttribute("urldefrag", "urlparse", "urllib.parse"),
-    MovedAttribute("urljoin", "urlparse", "urllib.parse"),
-    MovedAttribute("urlparse", "urlparse", "urllib.parse"),
-    MovedAttribute("urlsplit", "urlparse", "urllib.parse"),
-    MovedAttribute("urlunparse", "urlparse", "urllib.parse"),
-    MovedAttribute("urlunsplit", "urlparse", "urllib.parse"),
-    MovedAttribute("quote", "urllib", "urllib.parse"),
-    MovedAttribute("quote_plus", "urllib", "urllib.parse"),
-    MovedAttribute("unquote", "urllib", "urllib.parse"),
-    MovedAttribute("unquote_plus", "urllib", "urllib.parse"),
-    MovedAttribute(
-        "unquote_to_bytes", "urllib", "urllib.parse", "unquote", "unquote_to_bytes"
-    ),
-    MovedAttribute("urlencode", "urllib", "urllib.parse"),
-    MovedAttribute("splitquery", "urllib", "urllib.parse"),
-    MovedAttribute("splittag", "urllib", "urllib.parse"),
-    MovedAttribute("splituser", "urllib", "urllib.parse"),
-    MovedAttribute("splitvalue", "urllib", "urllib.parse"),
-    MovedAttribute("uses_fragment", "urlparse", "urllib.parse"),
-    MovedAttribute("uses_netloc", "urlparse", "urllib.parse"),
-    MovedAttribute("uses_params", "urlparse", "urllib.parse"),
-    MovedAttribute("uses_query", "urlparse", "urllib.parse"),
-    MovedAttribute("uses_relative", "urlparse", "urllib.parse"),
-]
-for attr in _urllib_parse_moved_attributes:
-    setattr(Module_six_moves_urllib_parse, attr.name, attr)
-del attr
-
-Module_six_moves_urllib_parse._moved_attributes = _urllib_parse_moved_attributes
-
-_importer._add_module(
-    Module_six_moves_urllib_parse(__name__ + ".moves.urllib_parse"),
-    "moves.urllib_parse",
-    "moves.urllib.parse",
-)
-
-
-class Module_six_moves_urllib_error(_LazyModule):
-
-    """Lazy loading of moved objects in six.moves.urllib_error"""
-
-
-_urllib_error_moved_attributes = [
-    MovedAttribute("URLError", "urllib2", "urllib.error"),
-    MovedAttribute("HTTPError", "urllib2", "urllib.error"),
-    MovedAttribute("ContentTooShortError", "urllib", "urllib.error"),
-]
-for attr in _urllib_error_moved_attributes:
-    setattr(Module_six_moves_urllib_error, attr.name, attr)
-del attr
-
-Module_six_moves_urllib_error._moved_attributes = _urllib_error_moved_attributes
-
-_importer._add_module(
-    Module_six_moves_urllib_error(__name__ + ".moves.urllib.error"),
-    "moves.urllib_error",
-    "moves.urllib.error",
-)
-
-
-class Module_six_moves_urllib_request(_LazyModule):
-
-    """Lazy loading of moved objects in six.moves.urllib_request"""
-
-
-_urllib_request_moved_attributes = [
-    MovedAttribute("urlopen", "urllib2", "urllib.request"),
-    MovedAttribute("install_opener", "urllib2", "urllib.request"),
-    MovedAttribute("build_opener", "urllib2", "urllib.request"),
-    MovedAttribute("pathname2url", "urllib", "urllib.request"),
-    MovedAttribute("url2pathname", "urllib", "urllib.request"),
-    MovedAttribute("getproxies", "urllib", "urllib.request"),
-    MovedAttribute("Request", "urllib2", "urllib.request"),
-    MovedAttribute("OpenerDirector", "urllib2", "urllib.request"),
-    MovedAttribute("HTTPDefaultErrorHandler", "urllib2", "urllib.request"),
-    MovedAttribute("HTTPRedirectHandler", "urllib2", "urllib.request"),
-    MovedAttribute("HTTPCookieProcessor", "urllib2", "urllib.request"),
-    MovedAttribute("ProxyHandler", "urllib2", "urllib.request"),
-    MovedAttribute("BaseHandler", "urllib2", "urllib.request"),
-    MovedAttribute("HTTPPasswordMgr", "urllib2", "urllib.request"),
-    MovedAttribute("HTTPPasswordMgrWithDefaultRealm", "urllib2", "urllib.request"),
-    MovedAttribute("AbstractBasicAuthHandler", "urllib2", "urllib.request"),
-    MovedAttribute("HTTPBasicAuthHandler", "urllib2", "urllib.request"),
-    MovedAttribute("ProxyBasicAuthHandler", "urllib2", "urllib.request"),
-    MovedAttribute("AbstractDigestAuthHandler", "urllib2", "urllib.request"),
-    MovedAttribute("HTTPDigestAuthHandler", "urllib2", "urllib.request"),
-    MovedAttribute("ProxyDigestAuthHandler", "urllib2", "urllib.request"),
-    MovedAttribute("HTTPHandler", "urllib2", "urllib.request"),
-    MovedAttribute("HTTPSHandler", "urllib2", "urllib.request"),
-    MovedAttribute("FileHandler", "urllib2", "urllib.request"),
-    MovedAttribute("FTPHandler", "urllib2", "urllib.request"),
-    MovedAttribute("CacheFTPHandler", "urllib2", "urllib.request"),
-    MovedAttribute("UnknownHandler", "urllib2", "urllib.request"),
-    MovedAttribute("HTTPErrorProcessor", "urllib2", "urllib.request"),
-    MovedAttribute("urlretrieve", "urllib", "urllib.request"),
-    MovedAttribute("urlcleanup", "urllib", "urllib.request"),
-    MovedAttribute("URLopener", "urllib", "urllib.request"),
-    MovedAttribute("FancyURLopener", "urllib", "urllib.request"),
-    MovedAttribute("proxy_bypass", "urllib", "urllib.request"),
-    MovedAttribute("parse_http_list", "urllib2", "urllib.request"),
-    MovedAttribute("parse_keqv_list", "urllib2", "urllib.request"),
-]
-for attr in _urllib_request_moved_attributes:
-    setattr(Module_six_moves_urllib_request, attr.name, attr)
-del attr
-
-Module_six_moves_urllib_request._moved_attributes = _urllib_request_moved_attributes
-
-_importer._add_module(
-    Module_six_moves_urllib_request(__name__ + ".moves.urllib.request"),
-    "moves.urllib_request",
-    "moves.urllib.request",
-)
-
-
-class Module_six_moves_urllib_response(_LazyModule):
-
-    """Lazy loading of moved objects in six.moves.urllib_response"""
-
-
-_urllib_response_moved_attributes = [
-    MovedAttribute("addbase", "urllib", "urllib.response"),
-    MovedAttribute("addclosehook", "urllib", "urllib.response"),
-    MovedAttribute("addinfo", "urllib", "urllib.response"),
-    MovedAttribute("addinfourl", "urllib", "urllib.response"),
-]
-for attr in _urllib_response_moved_attributes:
-    setattr(Module_six_moves_urllib_response, attr.name, attr)
-del attr
-
-Module_six_moves_urllib_response._moved_attributes = _urllib_response_moved_attributes
-
-_importer._add_module(
-    Module_six_moves_urllib_response(__name__ + ".moves.urllib.response"),
-    "moves.urllib_response",
-    "moves.urllib.response",
-)
-
-
-class Module_six_moves_urllib_robotparser(_LazyModule):
-
-    """Lazy loading of moved objects in six.moves.urllib_robotparser"""
-
-
-_urllib_robotparser_moved_attributes = [
-    MovedAttribute("RobotFileParser", "robotparser", "urllib.robotparser"),
-]
-for attr in _urllib_robotparser_moved_attributes:
-    setattr(Module_six_moves_urllib_robotparser, attr.name, attr)
-del attr
-
-Module_six_moves_urllib_robotparser._moved_attributes = (
-    _urllib_robotparser_moved_attributes
-)
-
-_importer._add_module(
-    Module_six_moves_urllib_robotparser(__name__ + ".moves.urllib.robotparser"),
-    "moves.urllib_robotparser",
-    "moves.urllib.robotparser",
-)
-
-
-class Module_six_moves_urllib(types.ModuleType):
-
-    """Create a six.moves.urllib namespace that resembles the Python 3 namespace"""
-
-    __path__ = []  # mark as package
-    parse = _importer._get_module("moves.urllib_parse")
-    error = _importer._get_module("moves.urllib_error")
-    request = _importer._get_module("moves.urllib_request")
-    response = _importer._get_module("moves.urllib_response")
-    robotparser = _importer._get_module("moves.urllib_robotparser")
-
-    def __dir__(self):
-        return ["parse", "error", "request", "response", "robotparser"]
-
-
-_importer._add_module(
-    Module_six_moves_urllib(__name__ + ".moves.urllib"), "moves.urllib"
-)
-
-
-def add_move(move):
-    """Add an item to six.moves."""
-    setattr(_MovedItems, move.name, move)
-
-
-def remove_move(name):
-    """Remove item from six.moves."""
-    try:
-        delattr(_MovedItems, name)
-    except AttributeError:
-        try:
-            del moves.__dict__[name]
-        except KeyError:
-            raise AttributeError("no such move, %r" % (name,))
-
-
-if PY3:
-    _meth_func = "__func__"
-    _meth_self = "__self__"
-
-    _func_closure = "__closure__"
-    _func_code = "__code__"
-    _func_defaults = "__defaults__"
-    _func_globals = "__globals__"
-else:
-    _meth_func = "im_func"
-    _meth_self = "im_self"
-
-    _func_closure = "func_closure"
-    _func_code = "func_code"
-    _func_defaults = "func_defaults"
-    _func_globals = "func_globals"
-
-
-try:
-    advance_iterator = next
-except NameError:
-
-    def advance_iterator(it):
-        return it.next()
-
-
-next = advance_iterator
-
-
-try:
-    callable = callable
-except NameError:
-
-    def callable(obj):
-        return any("__call__" in klass.__dict__ for klass in type(obj).__mro__)
-
-
-if PY3:
-
-    def get_unbound_function(unbound):
-        return unbound
-
-    create_bound_method = types.MethodType
-
-    def create_unbound_method(func, cls):
-        return func
-
-    Iterator = object
-else:
-
-    def get_unbound_function(unbound):
-        return unbound.im_func
-
-    def create_bound_method(func, obj):
-        return types.MethodType(func, obj, obj.__class__)
-
-    def create_unbound_method(func, cls):
-        return types.MethodType(func, None, cls)
-
-    class Iterator(object):
-        def next(self):
-            return type(self).__next__(self)
-
-    callable = callable
-_add_doc(
-    get_unbound_function, """Get the function out of a possibly unbound function"""
-)
-
-
-get_method_function = operator.attrgetter(_meth_func)
-get_method_self = operator.attrgetter(_meth_self)
-get_function_closure = operator.attrgetter(_func_closure)
-get_function_code = operator.attrgetter(_func_code)
-get_function_defaults = operator.attrgetter(_func_defaults)
-get_function_globals = operator.attrgetter(_func_globals)
-
-
-if PY3:
-
-    def iterkeys(d, **kw):
-        return iter(d.keys(**kw))
-
-    def itervalues(d, **kw):
-        return iter(d.values(**kw))
-
-    def iteritems(d, **kw):
-        return iter(d.items(**kw))
-
-    def iterlists(d, **kw):
-        return iter(d.lists(**kw))
-
-    viewkeys = operator.methodcaller("keys")
-
-    viewvalues = operator.methodcaller("values")
-
-    viewitems = operator.methodcaller("items")
-else:
-
-    def iterkeys(d, **kw):
-        return d.iterkeys(**kw)
-
-    def itervalues(d, **kw):
-        return d.itervalues(**kw)
-
-    def iteritems(d, **kw):
-        return d.iteritems(**kw)
-
-    def iterlists(d, **kw):
-        return d.iterlists(**kw)
-
-    viewkeys = operator.methodcaller("viewkeys")
-
-    viewvalues = operator.methodcaller("viewvalues")
-
-    viewitems = operator.methodcaller("viewitems")
-
-_add_doc(iterkeys, "Return an iterator over the keys of a dictionary.")
-_add_doc(itervalues, "Return an iterator over the values of a dictionary.")
-_add_doc(iteritems, "Return an iterator over the (key, value) pairs of a dictionary.")
-_add_doc(
-    iterlists, "Return an iterator over the (key, [values]) pairs of a dictionary."
-)
-
-
-if PY3:
-
-    def b(s):
-        return s.encode("latin-1")
-
-    def u(s):
-        return s
-
-    unichr = chr
-    import struct
-
-    int2byte = struct.Struct(">B").pack
-    del struct
-    byte2int = operator.itemgetter(0)
-    indexbytes = operator.getitem
-    iterbytes = iter
-    import io
-
-    StringIO = io.StringIO
-    BytesIO = io.BytesIO
-    del io
-    _assertCountEqual = "assertCountEqual"
-    if sys.version_info[1] <= 1:
-        _assertRaisesRegex = "assertRaisesRegexp"
-        _assertRegex = "assertRegexpMatches"
-        _assertNotRegex = "assertNotRegexpMatches"
-    else:
-        _assertRaisesRegex = "assertRaisesRegex"
-        _assertRegex = "assertRegex"
-        _assertNotRegex = "assertNotRegex"
-else:
-
-    def b(s):
-        return s
-
-    # Workaround for standalone backslash
-
-    def u(s):
-        return unicode(s.replace(r"\\", r"\\\\"), "unicode_escape")
-
-    unichr = unichr
-    int2byte = chr
-
-    def byte2int(bs):
-        return ord(bs[0])
-
-    def indexbytes(buf, i):
-        return ord(buf[i])
-
-    iterbytes = functools.partial(itertools.imap, ord)
-    import StringIO
-
-    StringIO = BytesIO = StringIO.StringIO
-    _assertCountEqual = "assertItemsEqual"
-    _assertRaisesRegex = "assertRaisesRegexp"
-    _assertRegex = "assertRegexpMatches"
-    _assertNotRegex = "assertNotRegexpMatches"
-_add_doc(b, """Byte literal""")
-_add_doc(u, """Text literal""")
-
-
-def assertCountEqual(self, *args, **kwargs):
-    return getattr(self, _assertCountEqual)(*args, **kwargs)
-
-
-def assertRaisesRegex(self, *args, **kwargs):
-    return getattr(self, _assertRaisesRegex)(*args, **kwargs)
-
-
-def assertRegex(self, *args, **kwargs):
-    return getattr(self, _assertRegex)(*args, **kwargs)
-
-
-def assertNotRegex(self, *args, **kwargs):
-    return getattr(self, _assertNotRegex)(*args, **kwargs)
-
-
-if PY3:
-    exec_ = getattr(moves.builtins, "exec")
-
-    def reraise(tp, value, tb=None):
-        try:
-            if value is None:
-                value = tp()
-            if value.__traceback__ is not tb:
-                raise value.with_traceback(tb)
-            raise value
-        finally:
-            value = None
-            tb = None
-
-else:
-
-    def exec_(_code_, _globs_=None, _locs_=None):
-        """Execute code in a namespace."""
-        if _globs_ is None:
-            frame = sys._getframe(1)
-            _globs_ = frame.f_globals
-            if _locs_ is None:
-                _locs_ = frame.f_locals
-            del frame
-        elif _locs_ is None:
-            _locs_ = _globs_
-        exec ("""exec _code_ in _globs_, _locs_""")
-
-    exec_(
-        """def reraise(tp, value, tb=None):
-    try:
-        raise tp, value, tb
-    finally:
-        tb = None
-"""
-    )
-
-
-if sys.version_info[:2] > (3,):
-    exec_(
-        """def raise_from(value, from_value):
-    try:
-        raise value from from_value
-    finally:
-        value = None
-"""
-    )
-else:
-
-    def raise_from(value, from_value):
-        raise value
-
-
-print_ = getattr(moves.builtins, "print", None)
-if print_ is None:
-
-    def print_(*args, **kwargs):
-        """The new-style print function for Python 2.4 and 2.5."""
-        fp = kwargs.pop("file", sys.stdout)
-        if fp is None:
-            return
-
-        def write(data):
-            if not isinstance(data, basestring):
-                data = str(data)
-            # If the file has an encoding, encode unicode with it.
-            if (
-                isinstance(fp, file)
-                and isinstance(data, unicode)
-                and fp.encoding is not None
-            ):
-                errors = getattr(fp, "errors", None)
-                if errors is None:
-                    errors = "strict"
-                data = data.encode(fp.encoding, errors)
-            fp.write(data)
-
-        want_unicode = False
-        sep = kwargs.pop("sep", None)
-        if sep is not None:
-            if isinstance(sep, unicode):
-                want_unicode = True
-            elif not isinstance(sep, str):
-                raise TypeError("sep must be None or a string")
-        end = kwargs.pop("end", None)
-        if end is not None:
-            if isinstance(end, unicode):
-                want_unicode = True
-            elif not isinstance(end, str):
-                raise TypeError("end must be None or a string")
-        if kwargs:
-            raise TypeError("invalid keyword arguments to print()")
-        if not want_unicode:
-            for arg in args:
-                if isinstance(arg, unicode):
-                    want_unicode = True
-                    break
-        if want_unicode:
-            newline = unicode("\n")
-            space = unicode(" ")
-        else:
-            newline = "\n"
-            space = " "
-        if sep is None:
-            sep = space
-        if end is None:
-            end = newline
-        for i, arg in enumerate(args):
-            if i:
-                write(sep)
-            write(arg)
-        write(end)
-
-
-if sys.version_info[:2] < (3, 3):
-    _print = print_
-
-    def print_(*args, **kwargs):
-        fp = kwargs.get("file", sys.stdout)
-        flush = kwargs.pop("flush", False)
-        _print(*args, **kwargs)
-        if flush and fp is not None:
-            fp.flush()
-
-
-_add_doc(reraise, """Reraise an exception.""")
-
-if sys.version_info[0:2] < (3, 4):
-    # This does exactly the same what the :func:`py3:functools.update_wrapper`
-    # function does on Python versions after 3.2. It sets the ``__wrapped__``
-    # attribute on ``wrapper`` object and it doesn't raise an error if any of
-    # the attributes mentioned in ``assigned`` and ``updated`` are missing on
-    # ``wrapped`` object.
-    def _update_wrapper(
-        wrapper,
-        wrapped,
-        assigned=functools.WRAPPER_ASSIGNMENTS,
-        updated=functools.WRAPPER_UPDATES,
-    ):
-        for attr in assigned:
-            try:
-                value = getattr(wrapped, attr)
-            except AttributeError:
-                continue
-            else:
-                setattr(wrapper, attr, value)
-        for attr in updated:
-            getattr(wrapper, attr).update(getattr(wrapped, attr, {}))
-        wrapper.__wrapped__ = wrapped
-        return wrapper
-
-    _update_wrapper.__doc__ = functools.update_wrapper.__doc__
-
-    def wraps(
-        wrapped,
-        assigned=functools.WRAPPER_ASSIGNMENTS,
-        updated=functools.WRAPPER_UPDATES,
-    ):
-        return functools.partial(
-            _update_wrapper, wrapped=wrapped, assigned=assigned, updated=updated
-        )
-
-    wraps.__doc__ = functools.wraps.__doc__
-
-else:
-    wraps = functools.wraps
-
-
-def with_metaclass(meta, *bases):
-    """Create a base class with a metaclass."""
-    # This requires a bit of explanation: the basic idea is to make a dummy
-    # metaclass for one level of class instantiation that replaces itself with
-    # the actual metaclass.
-    class metaclass(type):
-        def __new__(cls, name, this_bases, d):
-            if sys.version_info[:2] >= (3, 7):
-                # This version introduced PEP 560 that requires a bit
-                # of extra care (we mimic what is done by __build_class__).
-                resolved_bases = types.resolve_bases(bases)
-                if resolved_bases is not bases:
-                    d["__orig_bases__"] = bases
-            else:
-                resolved_bases = bases
-            return meta(name, resolved_bases, d)
-
-        @classmethod
-        def __prepare__(cls, name, this_bases):
-            return meta.__prepare__(name, bases)
-
-    return type.__new__(metaclass, "temporary_class", (), {})
-
-
-def add_metaclass(metaclass):
-    """Class decorator for creating a class with a metaclass."""
-
-    def wrapper(cls):
-        orig_vars = cls.__dict__.copy()
-        slots = orig_vars.get("__slots__")
-        if slots is not None:
-            if isinstance(slots, str):
-                slots = [slots]
-            for slots_var in slots:
-                orig_vars.pop(slots_var)
-        orig_vars.pop("__dict__", None)
-        orig_vars.pop("__weakref__", None)
-        if hasattr(cls, "__qualname__"):
-            orig_vars["__qualname__"] = cls.__qualname__
-        return metaclass(cls.__name__, cls.__bases__, orig_vars)
-
-    return wrapper
-
-
-def ensure_binary(s, encoding="utf-8", errors="strict"):
-    """Coerce **s** to six.binary_type.
-
-    For Python 2:
-      - `unicode` -> encoded to `str`
-      - `str` -> `str`
-
-    For Python 3:
-      - `str` -> encoded to `bytes`
-      - `bytes` -> `bytes`
-    """
-    if isinstance(s, binary_type):
-        return s
-    if isinstance(s, text_type):
-        return s.encode(encoding, errors)
-    raise TypeError("not expecting type '%s'" % type(s))
-
-
-def ensure_str(s, encoding="utf-8", errors="strict"):
-    """Coerce *s* to `str`.
-
-    For Python 2:
-      - `unicode` -> encoded to `str`
-      - `str` -> `str`
-
-    For Python 3:
-      - `str` -> `str`
-      - `bytes` -> decoded to `str`
-    """
-    # Optimization: Fast return for the common case.
-    if type(s) is str:
-        return s
-    if PY2 and isinstance(s, text_type):
-        return s.encode(encoding, errors)
-    elif PY3 and isinstance(s, binary_type):
-        return s.decode(encoding, errors)
-    elif not isinstance(s, (text_type, binary_type)):
-        raise TypeError("not expecting type '%s'" % type(s))
-    return s
-
-
-def ensure_text(s, encoding="utf-8", errors="strict"):
-    """Coerce *s* to six.text_type.
-
-    For Python 2:
-      - `unicode` -> `unicode`
-      - `str` -> `unicode`
-
-    For Python 3:
-      - `str` -> `str`
-      - `bytes` -> decoded to `str`
-    """
-    if isinstance(s, binary_type):
-        return s.decode(encoding, errors)
-    elif isinstance(s, text_type):
-        return s
-    else:
-        raise TypeError("not expecting type '%s'" % type(s))
-
-
-def python_2_unicode_compatible(klass):
-    """
-    A class decorator that defines __unicode__ and __str__ methods under Python 2.
-    Under Python 3 it does nothing.
-
-    To support Python 2 and 3 with a single code base, define a __str__ method
-    returning text and apply this decorator to the class.
-    """
-    if PY2:
-        if "__str__" not in klass.__dict__:
-            raise ValueError(
-                "@python_2_unicode_compatible cannot be applied "
-                "to %s because it doesn't define __str__()." % klass.__name__
-            )
-        klass.__unicode__ = klass.__str__
-        klass.__str__ = lambda self: self.__unicode__().encode("utf-8")
-    return klass
-
-
-# Complete the moves implementation.
-# This code is at the end of this module to speed up module loading.
-# Turn this module into a package.
-__path__ = []  # required for PEP 302 and PEP 451
-__package__ = __name__  # see PEP 366 @ReservedAssignment
-if globals().get("__spec__") is not None:
-    __spec__.submodule_search_locations = []  # PEP 451 @UndefinedVariable
-# Remove other six meta path importers, since they cause problems. This can
-# happen if six is removed from sys.modules and then reloaded. (Setuptools does
-# this for some reason.)
-if sys.meta_path:
-    for i, importer in enumerate(sys.meta_path):
-        # Here's some real nastiness: Another "instance" of the six module might
-        # be floating around. Therefore, we can't use isinstance() to check for
-        # the six meta path importer, since the other six instance will have
-        # inserted an importer with different class.
-        if (
-            type(importer).__name__ == "_SixMetaPathImporter"
-            and importer.name == __name__
-        ):
-            del sys.meta_path[i]
-            break
-    del i, importer
-# Finally, add the importer to the meta path import hook.
-sys.meta_path.append(_importer)
diff --git a/lib/urllib3/poolmanager.py b/lib/urllib3/poolmanager.py
index ca4ec341..02b2f622 100644
--- a/lib/urllib3/poolmanager.py
+++ b/lib/urllib3/poolmanager.py
@@ -1,24 +1,33 @@
-from __future__ import absolute_import
+from __future__ import annotations
 
-import collections
 import functools
 import logging
+import typing
+import warnings
+from types import TracebackType
+from urllib.parse import urljoin
 
 from ._collections import RecentlyUsedContainer
+from ._request_methods import RequestMethods
+from .connection import ProxyConfig
 from .connectionpool import HTTPConnectionPool, HTTPSConnectionPool, port_by_scheme
 from .exceptions import (
     LocationValueError,
     MaxRetryError,
     ProxySchemeUnknown,
-    ProxySchemeUnsupported,
     URLSchemeUnknown,
 )
-from .packages import six
-from .packages.six.moves.urllib.parse import urljoin
-from .request import RequestMethods
+from .response import BaseHTTPResponse
+from .util.connection import _TYPE_SOCKET_OPTIONS
 from .util.proxy import connection_requires_http_tunnel
 from .util.retry import Retry
-from .util.url import parse_url
+from .util.timeout import Timeout
+from .util.url import Url, parse_url
+
+if typing.TYPE_CHECKING:
+    import ssl
+
+    from typing_extensions import Literal
 
 __all__ = ["PoolManager", "ProxyManager", "proxy_from_url"]
 
@@ -31,52 +40,61 @@ SSL_KEYWORDS = (
     "cert_reqs",
     "ca_certs",
     "ssl_version",
+    "ssl_minimum_version",
+    "ssl_maximum_version",
     "ca_cert_dir",
     "ssl_context",
     "key_password",
     "server_hostname",
 )
+# Default value for `blocksize` - a new parameter introduced to
+# http.client.HTTPConnection & http.client.HTTPSConnection in Python 3.7
+_DEFAULT_BLOCKSIZE = 16384
 
-# All known keyword arguments that could be provided to the pool manager, its
-# pools, or the underlying connections. This is used to construct a pool key.
-_key_fields = (
-    "key_scheme",  # str
-    "key_host",  # str
-    "key_port",  # int
-    "key_timeout",  # int or float or Timeout
-    "key_retries",  # int or Retry
-    "key_strict",  # bool
-    "key_block",  # bool
-    "key_source_address",  # str
-    "key_key_file",  # str
-    "key_key_password",  # str
-    "key_cert_file",  # str
-    "key_cert_reqs",  # str
-    "key_ca_certs",  # str
-    "key_ssl_version",  # str
-    "key_ca_cert_dir",  # str
-    "key_ssl_context",  # instance of ssl.SSLContext or urllib3.util.ssl_.SSLContext
-    "key_maxsize",  # int
-    "key_headers",  # dict
-    "key__proxy",  # parsed proxy url
-    "key__proxy_headers",  # dict
-    "key__proxy_config",  # class
-    "key_socket_options",  # list of (level (int), optname (int), value (int or str)) tuples
-    "key__socks_options",  # dict
-    "key_assert_hostname",  # bool or string
-    "key_assert_fingerprint",  # str
-    "key_server_hostname",  # str
-)
-
-#: The namedtuple class used to construct keys for the connection pool.
-#: All custom key schemes should include the fields in this key at a minimum.
-PoolKey = collections.namedtuple("PoolKey", _key_fields)
-
-_proxy_config_fields = ("ssl_context", "use_forwarding_for_https")
-ProxyConfig = collections.namedtuple("ProxyConfig", _proxy_config_fields)
+_SelfT = typing.TypeVar("_SelfT")
 
 
-def _default_key_normalizer(key_class, request_context):
+class PoolKey(typing.NamedTuple):
+    """
+    All known keyword arguments that could be provided to the pool manager, its
+    pools, or the underlying connections.
+
+    All custom key schemes should include the fields in this key at a minimum.
+    """
+
+    key_scheme: str
+    key_host: str
+    key_port: int | None
+    key_timeout: Timeout | float | int | None
+    key_retries: Retry | bool | int | None
+    key_block: bool | None
+    key_source_address: tuple[str, int] | None
+    key_key_file: str | None
+    key_key_password: str | None
+    key_cert_file: str | None
+    key_cert_reqs: str | None
+    key_ca_certs: str | None
+    key_ssl_version: int | str | None
+    key_ssl_minimum_version: ssl.TLSVersion | None
+    key_ssl_maximum_version: ssl.TLSVersion | None
+    key_ca_cert_dir: str | None
+    key_ssl_context: ssl.SSLContext | None
+    key_maxsize: int | None
+    key_headers: frozenset[tuple[str, str]] | None
+    key__proxy: Url | None
+    key__proxy_headers: frozenset[tuple[str, str]] | None
+    key__proxy_config: ProxyConfig | None
+    key_socket_options: _TYPE_SOCKET_OPTIONS | None
+    key__socks_options: frozenset[tuple[str, str]] | None
+    key_assert_hostname: bool | str | None
+    key_assert_fingerprint: str | None
+    key_server_hostname: str | None
+    key_blocksize: int | None
+
+
+def _default_key_normalizer(
+    key_class: type[PoolKey], request_context: dict[str, typing.Any]
+) -> PoolKey:
     """
     Create a pool key out of a request context dictionary.
 
@@ -122,6 +140,10 @@ def _default_key_normalizer(key_class, request_context):
         if field not in context:
             context[field] = None
 
+    # Default key_blocksize to _DEFAULT_BLOCKSIZE if missing from the context
+    if context.get("key_blocksize") is None:
+        context["key_blocksize"] = _DEFAULT_BLOCKSIZE
+
     return key_class(**context)
 
 
@@ -154,39 +176,63 @@ class PoolManager(RequestMethods):
         Additional parameters are used to create fresh
         :class:`urllib3.connectionpool.ConnectionPool` instances.
 
-    Example::
+    Example:
 
-        >>> manager = PoolManager(num_pools=2)
-        >>> r = manager.request('GET', 'http://google.com/')
-        >>> r = manager.request('GET', 'http://google.com/mail')
-        >>> r = manager.request('GET', 'http://yahoo.com/')
-        >>> len(manager.pools)
-        2
+    .. code-block:: python
+
+        import urllib3
+
+        http = urllib3.PoolManager(num_pools=2)
+
+        resp1 = http.request("GET", "https://google.com/")
+        resp2 = http.request("GET", "https://google.com/mail")
+        resp3 = http.request("GET", "https://yahoo.com/")
+
+        print(len(http.pools))
+        # 2
 
     """
 
-    proxy = None
-    proxy_config = None
+    proxy: Url | None = None
+    proxy_config: ProxyConfig | None = None
 
-    def __init__(self, num_pools=10, headers=None, **connection_pool_kw):
-        RequestMethods.__init__(self, headers)
+    def __init__(
+        self,
+        num_pools: int = 10,
+        headers: typing.Mapping[str, str] | None = None,
+        **connection_pool_kw: typing.Any,
+    ) -> None:
+        super().__init__(headers)
         self.connection_pool_kw = connection_pool_kw
-        self.pools = RecentlyUsedContainer(num_pools, dispose_func=lambda p: p.close())
+
+        self.pools: RecentlyUsedContainer[PoolKey, HTTPConnectionPool]
+        self.pools = RecentlyUsedContainer(num_pools)
 
         # Locally set the pool classes and keys so other PoolManagers can
         # override them.
         self.pool_classes_by_scheme = pool_classes_by_scheme
         self.key_fn_by_scheme = key_fn_by_scheme.copy()
 
-    def __enter__(self):
+    def __enter__(self: _SelfT) -> _SelfT:
         return self
 
-    def __exit__(self, exc_type, exc_val, exc_tb):
+    def __exit__(
+        self,
+        exc_type: type[BaseException] | None,
+        exc_val: BaseException | None,
+        exc_tb: TracebackType | None,
+    ) -> Literal[False]:
         self.clear()
         # Return False to re-raise any potential exceptions
         return False
 
-    def _new_pool(self, scheme, host, port, request_context=None):
+    def _new_pool(
+        self,
+        scheme: str,
+        host: str,
+        port: int,
+        request_context: dict[str, typing.Any] | None = None,
+    ) -> HTTPConnectionPool:
         """
         Create a new :class:`urllib3.connectionpool.ConnectionPool` based on host, port, scheme, and
         any additional pool keyword arguments.
@@ -196,10 +242,15 @@ class PoolManager(RequestMethods):
         connection pools handed out by :meth:`connection_from_url` and
         companion methods. It is intended to be overridden for customization.
         """
-        pool_cls = self.pool_classes_by_scheme[scheme]
+        pool_cls: type[HTTPConnectionPool] = self.pool_classes_by_scheme[scheme]
         if request_context is None:
             request_context = self.connection_pool_kw.copy()
 
+        # Default blocksize to _DEFAULT_BLOCKSIZE if missing or explicitly
+        # set to 'None' in the request_context.
+        if request_context.get("blocksize") is None:
+            request_context["blocksize"] = _DEFAULT_BLOCKSIZE
+
         # Although the context has everything necessary to create the pool,
         # this function has historically only used the scheme, host, and port
         # in the positional args. When an API change is acceptable these can
@@ -213,7 +264,7 @@ class PoolManager(RequestMethods):
 
         return pool_cls(host, port, **request_context)
 
-    def clear(self):
+    def clear(self) -> None:
         """
         Empty our store of pools and direct them all to close.
 
@@ -222,7 +273,13 @@ class PoolManager(RequestMethods):
         """
         self.pools.clear()
 
-    def connection_from_host(self, host, port=None, scheme="http", pool_kwargs=None):
+    def connection_from_host(
+        self,
+        host: str | None,
+        port: int | None = None,
+        scheme: str | None = "http",
+        pool_kwargs: dict[str, typing.Any] | None = None,
+    ) -> HTTPConnectionPool:
         """
         Get a :class:`urllib3.connectionpool.ConnectionPool` based on the host, port, and scheme.
 
@@ -245,13 +302,23 @@ class PoolManager(RequestMethods):
 
         return self.connection_from_context(request_context)
 
-    def connection_from_context(self, request_context):
+    def connection_from_context(
+        self, request_context: dict[str, typing.Any]
+    ) -> HTTPConnectionPool:
         """
         Get a :class:`urllib3.connectionpool.ConnectionPool` based on the request context.
 
         ``request_context`` must at least contain the ``scheme`` key and its
         value must be a key in ``key_fn_by_scheme`` instance variable.
         """
+        if "strict" in request_context:
+            warnings.warn(
+                "The 'strict' parameter is no longer needed on Python 3+. "
+                "This will raise an error in urllib3 v2.1.0.",
+                DeprecationWarning,
+            )
+            request_context.pop("strict")
+
         scheme = request_context["scheme"].lower()
         pool_key_constructor = self.key_fn_by_scheme.get(scheme)
         if not pool_key_constructor:
@@ -260,7 +327,9 @@ class PoolManager(RequestMethods):
 
         return self.connection_from_pool_key(pool_key, request_context=request_context)
 
-    def connection_from_pool_key(self, pool_key, request_context=None):
+    def connection_from_pool_key(
+        self, pool_key: PoolKey, request_context: dict[str, typing.Any]
+    ) -> HTTPConnectionPool:
         """
         Get a :class:`urllib3.connectionpool.ConnectionPool` based on the provided pool key.
 
@@ -284,7 +353,9 @@ class PoolManager(RequestMethods):
 
         return pool
 
-    def connection_from_url(self, url, pool_kwargs=None):
+    def connection_from_url(
+        self, url: str, pool_kwargs: dict[str, typing.Any] | None = None
+    ) -> HTTPConnectionPool:
         """
         Similar to :func:`urllib3.connectionpool.connection_from_url`.
 
@@ -300,7 +371,9 @@ class PoolManager(RequestMethods):
             u.host, port=u.port, scheme=u.scheme, pool_kwargs=pool_kwargs
         )
 
-    def _merge_pool_kwargs(self, override):
+    def _merge_pool_kwargs(
+        self, override: dict[str, typing.Any] | None
+    ) -> dict[str, typing.Any]:
         """
         Merge a dictionary of override values for self.connection_pool_kw.
 
@@ -320,7 +393,7 @@ class PoolManager(RequestMethods):
                     base_pool_kwargs[key] = value
         return base_pool_kwargs
 
-    def _proxy_requires_url_absolute_form(self, parsed_url):
+    def _proxy_requires_url_absolute_form(self, parsed_url: Url) -> bool:
         """
         Indicates if the proxy requires the complete destination URL in the
         request.  Normally this is only needed when not using an HTTP CONNECT
@@ -333,24 +406,9 @@ class PoolManager(RequestMethods):
             self.proxy, self.proxy_config, parsed_url.scheme
         )
 
-    def _validate_proxy_scheme_url_selection(self, url_scheme):
-        """
-        Validates that were not attempting to do TLS in TLS connections on
-        Python2 or with unsupported SSL implementations.
-        """
-        if self.proxy is None or url_scheme != "https":
-            return
-
-        if self.proxy.scheme != "https":
-            return
-
-        if six.PY2 and not self.proxy_config.use_forwarding_for_https:
-            raise ProxySchemeUnsupported(
-                "Contacting HTTPS destinations through HTTPS proxies "
-                "'via CONNECT tunnels' is not supported in Python 2"
-            )
-
-    def urlopen(self, method, url, redirect=True, **kw):
+    def urlopen(  # type: ignore[override]
+        self, method: str, url: str, redirect: bool = True, **kw: typing.Any
+    ) -> BaseHTTPResponse:
         """
         Same as :meth:`urllib3.HTTPConnectionPool.urlopen`
         with custom cross-host redirect logic and only sends the request-uri
@@ -360,7 +418,16 @@ class PoolManager(RequestMethods):
         :class:`urllib3.connectionpool.ConnectionPool` can be chosen for it.
         """
         u = parse_url(url)
-        self._validate_proxy_scheme_url_selection(u.scheme)
+
+        if u.scheme is None:
+            warnings.warn(
+                "URLs without a scheme (ie 'https://') are deprecated and will raise an error "
+                "in a future version of urllib3. To avoid this DeprecationWarning ensure all URLs "
+                "start with 'https://' or 'http://'. Read more in this issue: "
+                "https://github.com/urllib3/urllib3/issues/2920",
+                category=DeprecationWarning,
+                stacklevel=2,
+            )
 
         conn = self.connection_from_host(u.host, port=u.port, scheme=u.scheme)
 
@@ -368,7 +435,7 @@ class PoolManager(RequestMethods):
         kw["redirect"] = False
 
         if "headers" not in kw:
-            kw["headers"] = self.headers.copy()
+            kw["headers"] = self.headers
 
         if self._proxy_requires_url_absolute_form(u):
             response = conn.urlopen(method, url, **kw)
@@ -396,10 +463,11 @@ class PoolManager(RequestMethods):
         if retries.remove_headers_on_redirect and not conn.is_same_host(
             redirect_location
         ):
-            headers = list(six.iterkeys(kw["headers"]))
-            for header in headers:
+            new_headers = kw["headers"].copy()
+            for header in kw["headers"]:
                 if header.lower() in retries.remove_headers_on_redirect:
-                    kw["headers"].pop(header, None)
+                    new_headers.pop(header, None)
+            kw["headers"] = new_headers
 
         try:
             retries = retries.increment(method, url, response=response, _pool=conn)
@@ -445,37 +513,51 @@ class ProxyManager(PoolManager):
         private.  IP address, target hostname, SNI, and port are always visible
         to an HTTPS proxy even when this flag is disabled.
 
+    :param proxy_assert_hostname:
+        The hostname of the certificate to verify against.
+
+    :param proxy_assert_fingerprint:
+        The fingerprint of the certificate to verify against.
+
     Example:
-        >>> proxy = urllib3.ProxyManager('http://localhost:3128/')
-        >>> r1 = proxy.request('GET', 'http://google.com/')
-        >>> r2 = proxy.request('GET', 'http://httpbin.org/')
-        >>> len(proxy.pools)
-        1
-        >>> r3 = proxy.request('GET', 'https://httpbin.org/')
-        >>> r4 = proxy.request('GET', 'https://twitter.com/')
-        >>> len(proxy.pools)
-        3
+
+    .. code-block:: python
+
+        import urllib3
+
+        proxy = urllib3.ProxyManager("https://localhost:3128/")
+
+        resp1 = proxy.request("GET", "https://google.com/")
+        resp2 = proxy.request("GET", "https://httpbin.org/")
+
+        print(len(proxy.pools))
+        # 1
+
+        resp3 = proxy.request("GET", "https://httpbin.org/")
+        resp4 = proxy.request("GET", "https://twitter.com/")
+
+        print(len(proxy.pools))
+        # 3
 
     """
 
     def __init__(
         self,
-        proxy_url,
-        num_pools=10,
-        headers=None,
-        proxy_headers=None,
-        proxy_ssl_context=None,
-        use_forwarding_for_https=False,
-        **connection_pool_kw
-    ):
-
+        proxy_url: str,
+        num_pools: int = 10,
+        headers: typing.Mapping[str, str] | None = None,
+        proxy_headers: typing.Mapping[str, str] | None = None,
+        proxy_ssl_context: ssl.SSLContext | None = None,
+        use_forwarding_for_https: bool = False,
+        proxy_assert_hostname: None | str | Literal[False] = None,
+        proxy_assert_fingerprint: str | None = None,
+        **connection_pool_kw: typing.Any,
+    ) -> None:
         if isinstance(proxy_url, HTTPConnectionPool):
-            proxy_url = "%s://%s:%i" % (
-                proxy_url.scheme,
-                proxy_url.host,
-                proxy_url.port,
-            )
-        proxy = parse_url(proxy_url)
+            str_proxy_url = f"{proxy_url.scheme}://{proxy_url.host}:{proxy_url.port}"
+        else:
+            str_proxy_url = proxy_url
+        proxy = parse_url(str_proxy_url)
 
         if proxy.scheme not in ("http", "https"):
             raise ProxySchemeUnknown(proxy.scheme)
@@ -487,25 +569,38 @@ class ProxyManager(PoolManager):
         self.proxy = proxy
         self.proxy_headers = proxy_headers or {}
         self.proxy_ssl_context = proxy_ssl_context
-        self.proxy_config = ProxyConfig(proxy_ssl_context, use_forwarding_for_https)
+        self.proxy_config = ProxyConfig(
+            proxy_ssl_context,
+            use_forwarding_for_https,
+            proxy_assert_hostname,
+            proxy_assert_fingerprint,
+        )
 
         connection_pool_kw["_proxy"] = self.proxy
         connection_pool_kw["_proxy_headers"] = self.proxy_headers
         connection_pool_kw["_proxy_config"] = self.proxy_config
 
-        super(ProxyManager, self).__init__(num_pools, headers, **connection_pool_kw)
+        super().__init__(num_pools, headers, **connection_pool_kw)
 
-    def connection_from_host(self, host, port=None, scheme="http", pool_kwargs=None):
+    def connection_from_host(
+        self,
+        host: str | None,
+        port: int | None = None,
+        scheme: str | None = "http",
+        pool_kwargs: dict[str, typing.Any] | None = None,
+    ) -> HTTPConnectionPool:
         if scheme == "https":
-            return super(ProxyManager, self).connection_from_host(
+            return super().connection_from_host(
                 host, port, scheme, pool_kwargs=pool_kwargs
             )
 
-        return super(ProxyManager, self).connection_from_host(
-            self.proxy.host, self.proxy.port, self.proxy.scheme, pool_kwargs=pool_kwargs
+        return super().connection_from_host(
+            self.proxy.host, self.proxy.port, self.proxy.scheme, pool_kwargs=pool_kwargs  # type: ignore[union-attr]
         )
 
-    def _set_proxy_headers(self, url, headers=None):
+    def _set_proxy_headers(
+        self, url: str, headers: typing.Mapping[str, str] | None = None
+    ) -> typing.Mapping[str, str]:
         """
         Sets headers needed by proxies: specifically, the Accept and Host
         headers. Only sets headers not provided by the user.
@@ -520,7 +615,9 @@ class ProxyManager(PoolManager):
             headers_.update(headers)
         return headers_
 
-    def urlopen(self, method, url, redirect=True, **kw):
+    def urlopen(  # type: ignore[override]
+        self, method: str, url: str, redirect: bool = True, **kw: typing.Any
+    ) -> BaseHTTPResponse:
         "Same as HTTP(S)ConnectionPool.urlopen, ``url`` must be absolute."
         u = parse_url(url)
         if not connection_requires_http_tunnel(self.proxy, self.proxy_config, u.scheme):
@@ -530,8 +627,8 @@ class ProxyManager(PoolManager):
             headers = kw.get("headers", self.headers)
             kw["headers"] = self._set_proxy_headers(url, headers)
 
-        return super(ProxyManager, self).urlopen(method, url, redirect=redirect, **kw)
+        return super().urlopen(method, url, redirect=redirect, **kw)
 
 
-def proxy_from_url(url, **kw):
+def proxy_from_url(url: str, **kw: typing.Any) -> ProxyManager:
     return ProxyManager(proxy_url=url, **kw)
diff --git a/lib/urllib3/py.typed b/lib/urllib3/py.typed
new file mode 100644
index 00000000..5f3ea3d9
--- /dev/null
+++ b/lib/urllib3/py.typed
@@ -0,0 +1,2 @@
+# Instruct type checkers to look for inline type annotations in this package.
+# See PEP 561.
diff --git a/lib/urllib3/response.py b/lib/urllib3/response.py
index 0bd13d40..50e4d88f 100644
--- a/lib/urllib3/response.py
+++ b/lib/urllib3/response.py
@@ -1,25 +1,47 @@
-from __future__ import absolute_import
+from __future__ import annotations
 
+import collections
 import io
+import json as _json
 import logging
+import re
 import sys
+import typing
 import warnings
 import zlib
 from contextlib import contextmanager
-from socket import error as SocketError
+from http.client import HTTPMessage as _HttplibHTTPMessage
+from http.client import HTTPResponse as _HttplibHTTPResponse
 from socket import timeout as SocketTimeout
 
 try:
     try:
-        import brotlicffi as brotli
+        import brotlicffi as brotli  # type: ignore[import]
     except ImportError:
-        import brotli
+        import brotli  # type: ignore[import]
 except ImportError:
     brotli = None
 
+try:
+    import zstandard as zstd  # type: ignore[import]
+
+    # The package 'zstandard' added the 'eof' property starting
+    # in v0.18.0 which we require to ensure a complete and
+    # valid zstd stream was fed into the ZstdDecoder.
+    # See: https://github.com/urllib3/urllib3/pull/2624
+    _zstd_version = _zstd_version = tuple(
+        map(int, re.search(r"^([0-9]+)\.([0-9]+)", zstd.__version__).groups())  # type: ignore[union-attr]
+    )
+    if _zstd_version < (0, 18):  # Defensive:
+        zstd = None
+
+except (AttributeError, ImportError, ValueError):  # Defensive:
+    zstd = None
+
 from . import util
+from ._base_connection import _TYPE_BODY
 from ._collections import HTTPHeaderDict
-from .connection import BaseSSLError, HTTPException
+from .connection import BaseSSLError, HTTPConnection, HTTPException
 from .exceptions import (
     BodyNotHttplibCompatible,
     DecodeError,
@@ -32,22 +54,32 @@ from .exceptions import (
     ResponseNotChunked,
     SSLError,
 )
-from .packages import six
 from .util.response import is_fp_closed, is_response_to_head
+from .util.retry import Retry
+
+if typing.TYPE_CHECKING:
+    from typing_extensions import Literal
+
+    from .connectionpool import HTTPConnectionPool
 
 log = logging.getLogger(__name__)
 
 
-class DeflateDecoder(object):
-    def __init__(self):
+class ContentDecoder:
+    def decompress(self, data: bytes) -> bytes:
+        raise NotImplementedError()
+
+    def flush(self) -> bytes:
+        raise NotImplementedError()
+
+
+class DeflateDecoder(ContentDecoder):
+    def __init__(self) -> None:
         self._first_try = True
         self._data = b""
         self._obj = zlib.decompressobj()
 
-    def __getattr__(self, name):
-        return getattr(self._obj, name)
-
-    def decompress(self, data):
+    def decompress(self, data: bytes) -> bytes:
         if not data:
             return data
 
@@ -59,7 +91,7 @@ class DeflateDecoder(object):
             decompressed = self._obj.decompress(data)
             if decompressed:
                 self._first_try = False
-                self._data = None
+                self._data = None  # type: ignore[assignment]
             return decompressed
         except zlib.error:
             self._first_try = False
@@ -67,25 +99,24 @@ class DeflateDecoder(object):
             try:
                 return self.decompress(self._data)
             finally:
-                self._data = None
+                self._data = None  # type: ignore[assignment]
+
+    def flush(self) -> bytes:
+        return self._obj.flush()
 
 
-class GzipDecoderState(object):
-
+class GzipDecoderState:
     FIRST_MEMBER = 0
     OTHER_MEMBERS = 1
     SWALLOW_DATA = 2
 
 
-class GzipDecoder(object):
-    def __init__(self):
+class GzipDecoder(ContentDecoder):
+    def __init__(self) -> None:
         self._obj = zlib.decompressobj(16 + zlib.MAX_WBITS)
         self._state = GzipDecoderState.FIRST_MEMBER
 
-    def __getattr__(self, name):
-        return getattr(self._obj, name)
-
-    def decompress(self, data):
+    def decompress(self, data: bytes) -> bytes:
         ret = bytearray()
         if self._state == GzipDecoderState.SWALLOW_DATA or not data:
             return bytes(ret)
@@ -106,27 +137,53 @@ class GzipDecoder(object):
             self._state = GzipDecoderState.OTHER_MEMBERS
             self._obj = zlib.decompressobj(16 + zlib.MAX_WBITS)
 
+    def flush(self) -> bytes:
+        return self._obj.flush()
+
 
 if brotli is not None:
 
-    class BrotliDecoder(object):
+    class BrotliDecoder(ContentDecoder):
         # Supports both 'brotlipy' and 'Brotli' packages
         # since they share an import name. The top branches
         # are for 'brotlipy' and bottom branches for 'Brotli'
-        def __init__(self):
+        def __init__(self) -> None:
             self._obj = brotli.Decompressor()
             if hasattr(self._obj, "decompress"):
-                self.decompress = self._obj.decompress
+                setattr(self, "decompress", self._obj.decompress)
             else:
-                self.decompress = self._obj.process
+                setattr(self, "decompress", self._obj.process)
 
-        def flush(self):
+        def flush(self) -> bytes:
             if hasattr(self._obj, "flush"):
-                return self._obj.flush()
+                return self._obj.flush()  # type: ignore[no-any-return]
             return b""
 
 
-class MultiDecoder(object):
+if zstd is not None:
+
+    class ZstdDecoder(ContentDecoder):
+        def __init__(self) -> None:
+            self._obj = zstd.ZstdDecompressor().decompressobj()
+
+        def decompress(self, data: bytes) -> bytes:
+            if not data:
+                return b""
+            data_parts = [self._obj.decompress(data)]
+            while self._obj.eof and self._obj.unused_data:
+                unused_data = self._obj.unused_data
+                self._obj = zstd.ZstdDecompressor().decompressobj()
+                data_parts.append(self._obj.decompress(unused_data))
+            return b"".join(data_parts)
+
+        def flush(self) -> bytes:
+            ret = self._obj.flush()  # note: this is a no-op
+            if not self._obj.eof:
+                raise DecodeError("Zstandard data is incomplete")
+            return ret  # type: ignore[no-any-return]
+
+
+class MultiDecoder(ContentDecoder):
     """
     From RFC7231:
         If one or more encodings have been applied to a representation, the
@@ -135,19 +192,19 @@ class MultiDecoder(object):
         they were applied.
     """
 
-    def __init__(self, modes):
+    def __init__(self, modes: str) -> None:
         self._decoders = [_get_decoder(m.strip()) for m in modes.split(",")]
 
-    def flush(self):
+    def flush(self) -> bytes:
         return self._decoders[0].flush()
 
-    def decompress(self, data):
+    def decompress(self, data: bytes) -> bytes:
         for d in reversed(self._decoders):
             data = d.decompress(data)
         return data
 
 
-def _get_decoder(mode):
+def _get_decoder(mode: str) -> ContentDecoder:
     if "," in mode:
         return MultiDecoder(mode)
 
@@ -157,10 +214,294 @@ def _get_decoder(mode):
     if brotli is not None and mode == "br":
         return BrotliDecoder()
 
+    if zstd is not None and mode == "zstd":
+        return ZstdDecoder()
+
     return DeflateDecoder()
 
 
-class HTTPResponse(io.IOBase):
+class BytesQueueBuffer:
+    """Memory-efficient bytes buffer
+
+    To return decoded data in read() and still follow the BufferedIOBase API, we need a
+    buffer to always return the correct amount of bytes.
+
+    This buffer should be filled using calls to put()
+
+    Our maximum memory usage is determined by the sum of the size of:
+
+     * self.buffer, which contains the full data
+     * the largest chunk that we will copy in get()
+
+    The worst case scenario is a single chunk, in which case we'll make a full copy of
+    the data inside get().
+    """
+
+    def __init__(self) -> None:
+        self.buffer: typing.Deque[bytes] = collections.deque()
+        self._size: int = 0
+
+    def __len__(self) -> int:
+        return self._size
+
+    def put(self, data: bytes) -> None:
+        self.buffer.append(data)
+        self._size += len(data)
+
+    def get(self, n: int) -> bytes:
+        if n == 0:
+            return b""
+        elif not self.buffer:
+            raise RuntimeError("buffer is empty")
+        elif n < 0:
+            raise ValueError("n should be > 0")
+
+        fetched = 0
+        ret = io.BytesIO()
+        while fetched < n:
+            remaining = n - fetched
+            chunk = self.buffer.popleft()
+            chunk_length = len(chunk)
+            if remaining < chunk_length:
+                left_chunk, right_chunk = chunk[:remaining], chunk[remaining:]
+                ret.write(left_chunk)
+                self.buffer.appendleft(right_chunk)
+                self._size -= remaining
+                break
+            else:
+                ret.write(chunk)
+                self._size -= chunk_length
+            fetched += chunk_length
+
+            if not self.buffer:
+                break
+
+        return ret.getvalue()
+
+
+class BaseHTTPResponse(io.IOBase):
+    CONTENT_DECODERS = ["gzip", "deflate"]
+    if brotli is not None:
+        CONTENT_DECODERS += ["br"]
+    if zstd is not None:
+        CONTENT_DECODERS += ["zstd"]
+    REDIRECT_STATUSES = [301, 302, 303, 307, 308]
+
+    DECODER_ERROR_CLASSES: tuple[type[Exception], ...] = (IOError, zlib.error)
+    if brotli is not None:
+        DECODER_ERROR_CLASSES += (brotli.error,)
+
+    if zstd is not None:
+        DECODER_ERROR_CLASSES += (zstd.ZstdError,)
+
+    def __init__(
+        self,
+        *,
+        headers: typing.Mapping[str, str] | typing.Mapping[bytes, bytes] | None = None,
+        status: int,
+        version: int,
+        reason: str | None,
+        decode_content: bool,
+        request_url: str | None,
+        retries: Retry | None = None,
+    ) -> None:
+        if isinstance(headers, HTTPHeaderDict):
+            self.headers = headers
+        else:
+            self.headers = HTTPHeaderDict(headers)  # type: ignore[arg-type]
+        self.status = status
+        self.version = version
+        self.reason = reason
+        self.decode_content = decode_content
+        self._has_decoded_content = False
+        self._request_url: str | None = request_url
+        self.retries = retries
+
+        self.chunked = False
+        tr_enc = self.headers.get("transfer-encoding", "").lower()
+        # Don't incur the penalty of creating a list and then discarding it
+        encodings = (enc.strip() for enc in tr_enc.split(","))
+        if "chunked" in encodings:
+            self.chunked = True
+
+        self._decoder: ContentDecoder | None = None
+
+    def get_redirect_location(self) -> str | None | Literal[False]:
+        """
+        Should we redirect and where to?
+
+        :returns: Truthy redirect location string if we got a redirect status
+            code and valid location. ``None`` if redirect status and no
+            location. ``False`` if not a redirect status code.
+        """
+        if self.status in self.REDIRECT_STATUSES:
+            return self.headers.get("location")
+        return False
+
+    @property
+    def data(self) -> bytes:
+        raise NotImplementedError()
+
+    def json(self) -> typing.Any:
+        """
+        Parses the body of the HTTP response as JSON.
+
+        To use a custom JSON decoder pass the result of :attr:`HTTPResponse.data` to the decoder.
+
+        This method can raise either `UnicodeDecodeError` or `json.JSONDecodeError`.
+
+        Read more :ref:`here <json>`.
+        """
+        data = self.data.decode("utf-8")
+        return _json.loads(data)
+
+    @property
+    def url(self) -> str | None:
+        raise NotImplementedError()
+
+    @url.setter
+    def url(self, url: str | None) -> None:
+        raise NotImplementedError()
+
+    @property
+    def connection(self) -> HTTPConnection | None:
+        raise NotImplementedError()
+
+    @property
+    def retries(self) -> Retry | None:
+        return self._retries
+
+    @retries.setter
+    def retries(self, retries: Retry | None) -> None:
+        # Override the request_url if retries has a redirect location.
+        if retries is not None and retries.history:
+            self.url = retries.history[-1].redirect_location
+        self._retries = retries
+
+    def stream(
+        self, amt: int | None = 2**16, decode_content: bool | None = None
+    ) -> typing.Iterator[bytes]:
+        raise NotImplementedError()
+
+    def read(
+        self,
+        amt: int | None = None,
+        decode_content: bool | None = None,
+        cache_content: bool = False,
+    ) -> bytes:
+        raise NotImplementedError()
+
+    def read_chunked(
+        self,
+        amt: int | None = None,
+        decode_content: bool | None = None,
+    ) -> typing.Iterator[bytes]:
+        raise NotImplementedError()
+
+    def release_conn(self) -> None:
+        raise NotImplementedError()
+
+    def drain_conn(self) -> None:
+        raise NotImplementedError()
+
+    def close(self) -> None:
+        raise NotImplementedError()
+
+    def _init_decoder(self) -> None:
+        """
+        Set-up the _decoder attribute if necessary.
+        """
+        # Note: content-encoding value should be case-insensitive, per RFC 7230
+        # Section 3.2
+        content_encoding = self.headers.get("content-encoding", "").lower()
+        if self._decoder is None:
+            if content_encoding in self.CONTENT_DECODERS:
+                self._decoder = _get_decoder(content_encoding)
+            elif "," in content_encoding:
+                encodings = [
+                    e.strip()
+                    for e in content_encoding.split(",")
+                    if e.strip() in self.CONTENT_DECODERS
+                ]
+                if encodings:
+                    self._decoder = _get_decoder(content_encoding)
+
+    def _decode(
+        self, data: bytes, decode_content: bool | None, flush_decoder: bool
+    ) -> bytes:
+        """
+        Decode the data passed in and potentially flush the decoder.
+        """
+        if not decode_content:
+            if self._has_decoded_content:
+                raise RuntimeError(
+                    "Calling read(decode_content=False) is not supported after "
+                    "read(decode_content=True) was called."
+                )
+            return data
+
+        try:
+            if self._decoder:
+                data = self._decoder.decompress(data)
+                self._has_decoded_content = True
+        except self.DECODER_ERROR_CLASSES as e:
+            content_encoding = self.headers.get("content-encoding", "").lower()
+            raise DecodeError(
+                "Received response with content-encoding: %s, but "
+                "failed to decode it." % content_encoding,
+                e,
+            ) from e
+        if flush_decoder:
+            data += self._flush_decoder()
+
+        return data
+
+    def _flush_decoder(self) -> bytes:
+        """
+        Flushes the decoder. Should only be called if the decoder is actually
+        being used.
+        """
+        if self._decoder:
+            return self._decoder.decompress(b"") + self._decoder.flush()
+        return b""
+
+    # Compatibility methods for `io` module
+    def readinto(self, b: bytearray) -> int:
+        temp = self.read(len(b))
+        if len(temp) == 0:
+            return 0
+        else:
+            b[: len(temp)] = temp
+            return len(temp)
+
+    # Compatibility methods for http.client.HTTPResponse
+    def getheaders(self) -> HTTPHeaderDict:
+        warnings.warn(
+            "HTTPResponse.getheaders() is deprecated and will be removed "
+            "in urllib3 v2.1.0. Instead access HTTPResponse.headers directly.",
+            category=DeprecationWarning,
+            stacklevel=2,
+        )
+        return self.headers
+
+    def getheader(self, name: str, default: str | None = None) -> str | None:
+        warnings.warn(
+            "HTTPResponse.getheader() is deprecated and will be removed "
+            "in urllib3 v2.1.0. Instead use HTTPResponse.headers.get(name, default).",
+            category=DeprecationWarning,
+            stacklevel=2,
+        )
+        return self.headers.get(name, default)
+
+    # Compatibility method for http.cookiejar
+    def info(self) -> HTTPHeaderDict:
+        return self.headers
+
+    def geturl(self) -> str | None:
+        return self.url
+
+
+class HTTPResponse(BaseHTTPResponse):
     """
     HTTP Response container.
 
@@ -193,99 +534,74 @@ class HTTPResponse(io.IOBase):
         value of Content-Length header, if present. Otherwise, raise error.
     """
 
-    CONTENT_DECODERS = ["gzip", "deflate"]
-    if brotli is not None:
-        CONTENT_DECODERS += ["br"]
-    REDIRECT_STATUSES = [301, 302, 303, 307, 308]
-
     def __init__(
         self,
-        body="",
-        headers=None,
-        status=0,
-        version=0,
-        reason=None,
-        strict=0,
-        preload_content=True,
-        decode_content=True,
-        original_response=None,
-        pool=None,
-        connection=None,
-        msg=None,
-        retries=None,
-        enforce_content_length=False,
-        request_method=None,
-        request_url=None,
-        auto_close=True,
-    ):
+        body: _TYPE_BODY = "",
+        headers: typing.Mapping[str, str] | typing.Mapping[bytes, bytes] | None = None,
+        status: int = 0,
+        version: int = 0,
+        reason: str | None = None,
+        preload_content: bool = True,
+        decode_content: bool = True,
+        original_response: _HttplibHTTPResponse | None = None,
+        pool: HTTPConnectionPool | None = None,
+        connection: HTTPConnection | None = None,
+        msg: _HttplibHTTPMessage | None = None,
+        retries: Retry | None = None,
+        enforce_content_length: bool = True,
+        request_method: str | None = None,
+        request_url: str | None = None,
+        auto_close: bool = True,
+    ) -> None:
+        super().__init__(
+            headers=headers,
+            status=status,
+            version=version,
+            reason=reason,
+            decode_content=decode_content,
+            request_url=request_url,
+            retries=retries,
+        )
 
-        if isinstance(headers, HTTPHeaderDict):
-            self.headers = headers
-        else:
-            self.headers = HTTPHeaderDict(headers)
-        self.status = status
-        self.version = version
-        self.reason = reason
-        self.strict = strict
-        self.decode_content = decode_content
-        self.retries = retries
         self.enforce_content_length = enforce_content_length
         self.auto_close = auto_close
 
-        self._decoder = None
         self._body = None
-        self._fp = None
+        self._fp: _HttplibHTTPResponse | None = None
         self._original_response = original_response
         self._fp_bytes_read = 0
         self.msg = msg
-        self._request_url = request_url
 
-        if body and isinstance(body, (six.string_types, bytes)):
+        if body and isinstance(body, (str, bytes)):
             self._body = body
 
         self._pool = pool
         self._connection = connection
 
         if hasattr(body, "read"):
-            self._fp = body
+            self._fp = body  # type: ignore[assignment]
 
         # Are we using the chunked-style of transfer encoding?
-        self.chunked = False
-        self.chunk_left = None
-        tr_enc = self.headers.get("transfer-encoding", "").lower()
-        # Don't incur the penalty of creating a list and then discarding it
-        encodings = (enc.strip() for enc in tr_enc.split(","))
-        if "chunked" in encodings:
-            self.chunked = True
+        self.chunk_left: int | None = None
 
         # Determine length of response
         self.length_remaining = self._init_length(request_method)
 
+        # Used to return the correct amount of bytes for partial read()s
+        self._decoded_buffer = BytesQueueBuffer()
+
         # If requested, preload the body.
         if preload_content and not self._body:
             self._body = self.read(decode_content=decode_content)
 
-    def get_redirect_location(self):
-        """
-        Should we redirect and where to?
-
-        :returns: Truthy redirect location string if we got a redirect status
-            code and valid location. ``None`` if redirect status and no
-            location. ``False`` if not a redirect status code.
-        """
-        if self.status in self.REDIRECT_STATUSES:
-            return self.headers.get("location")
-
-        return False
-
-    def release_conn(self):
+    def release_conn(self) -> None:
         if not self._pool or not self._connection:
-            return
+            return None
 
         self._pool._put_conn(self._connection)
         self._connection = None
 
-    def drain_conn(self):
+    def drain_conn(self) -> None:
         """
         Read and discard any remaining HTTP response data in the response connection.
 
@@ -293,26 +609,28 @@ class HTTPResponse(io.IOBase):
         """
         try:
             self.read()
-        except (HTTPError, SocketError, BaseSSLError, HTTPException):
+        except (HTTPError, OSError, BaseSSLError, HTTPException):
             pass
 
     @property
-    def data(self):
+    def data(self) -> bytes:
         # For backwards-compat with earlier urllib3 0.4 and earlier.
         if self._body:
-            return self._body
+            return self._body  # type: ignore[return-value]
 
         if self._fp:
             return self.read(cache_content=True)
 
+        return None  # type: ignore[return-value]
+
     @property
-    def connection(self):
+    def connection(self) -> HTTPConnection | None:
         return self._connection
 
-    def isclosed(self):
+    def isclosed(self) -> bool:
         return is_fp_closed(self._fp)
 
-    def tell(self):
+    def tell(self) -> int:
         """
         Obtain the number of bytes pulled over the wire so far. May differ from
         the amount of content returned by :meth:``urllib3.response.HTTPResponse.read``
@@ -320,13 +638,14 @@ class HTTPResponse(io.IOBase):
         """
         return self._fp_bytes_read
 
-    def _init_length(self, request_method):
+    def _init_length(self, request_method: str | None) -> int | None:
         """
         Set initial length value for Response content if available.
         """
-        length = self.headers.get("content-length")
+        length: int | None
+        content_length: str | None = self.headers.get("content-length")
 
-        if length is not None:
+        if content_length is not None:
             if self.chunked:
                 # This Response will fail with an IncompleteRead if it can't be
                 # received as chunked. This method falls back to attempt reading
@@ -346,11 +665,11 @@ class HTTPResponse(io.IOBase):
                 # (e.g. Content-Length: 42, 42). This line ensures the values
                 # are all valid ints and that as long as the `set` length is 1,
                 # all values are the same. Otherwise, the header is invalid.
-                lengths = set([int(val) for val in length.split(",")])
+                lengths = {int(val) for val in content_length.split(",")}
                 if len(lengths) > 1:
                     raise InvalidHeader(
                         "Content-Length contained multiple "
-                        "unmatching values (%s)" % length
+                        "unmatching values (%s)" % content_length
                     )
                 length = lengths.pop()
             except ValueError:
@@ -359,6 +678,9 @@ class HTTPResponse(io.IOBase):
                 if length < 0:
                     length = None
 
+        else:  # if content_length is None
+            length = None
+
         # Convert status to int for comparison
         # In some cases, httplib returns a status of "_UNKNOWN"
         try:
@@ -372,64 +694,8 @@ class HTTPResponse(io.IOBase):
 
         return length
 
-    def _init_decoder(self):
-        """
-        Set-up the _decoder attribute if necessary.
-        """
-        # Note: content-encoding value should be case-insensitive, per RFC 7230
-        # Section 3.2
-        content_encoding = self.headers.get("content-encoding", "").lower()
-        if self._decoder is None:
-            if content_encoding in self.CONTENT_DECODERS:
-                self._decoder = _get_decoder(content_encoding)
-            elif "," in content_encoding:
-                encodings = [
-                    e.strip()
-                    for e in content_encoding.split(",")
-                    if e.strip() in self.CONTENT_DECODERS
-                ]
-                if len(encodings):
-                    self._decoder = _get_decoder(content_encoding)
-
-    DECODER_ERROR_CLASSES = (IOError, zlib.error)
-    if brotli is not None:
-        DECODER_ERROR_CLASSES += (brotli.error,)
-
-    def _decode(self, data, decode_content, flush_decoder):
-        """
-        Decode the data passed in and potentially flush the decoder.
-        """
-        if not decode_content:
-            return data
-
-        try:
-            if self._decoder:
-                data = self._decoder.decompress(data)
-        except self.DECODER_ERROR_CLASSES as e:
-            content_encoding = self.headers.get("content-encoding", "").lower()
-            raise DecodeError(
-                "Received response with content-encoding: %s, but "
-                "failed to decode it." % content_encoding,
-                e,
-            )
-        if flush_decoder:
-            data += self._flush_decoder()
-
-        return data
-
-    def _flush_decoder(self):
-        """
-        Flushes the decoder. Should only be called if the decoder is actually
-        being used.
-        """
-        if self._decoder:
-            buf = self._decoder.decompress(b"")
-            return buf + self._decoder.flush()
-
-        return b""
-
     @contextmanager
-    def _error_catcher(self):
+    def _error_catcher(self) -> typing.Generator[None, None, None]:
         """
         Catch low-level python exceptions, instead re-raising urllib3
         variants, so that low-level exceptions are not leaked in the
@@ -443,22 +709,22 @@ class HTTPResponse(io.IOBase):
             try:
                 yield
 
-            except SocketTimeout:
+            except SocketTimeout as e:
                 # FIXME: Ideally we'd like to include the url in the ReadTimeoutError but
                 # there is yet no clean way to get at it from this context.
-                raise ReadTimeoutError(self._pool, None, "Read timed out.")
+                raise ReadTimeoutError(self._pool, None, "Read timed out.") from e  # type: ignore[arg-type]
 
             except BaseSSLError as e:
                 # FIXME: Is there a better way to differentiate between SSLErrors?
                 if "read operation timed out" not in str(e):
                     # SSL errors related to framing/MAC get wrapped and reraised here
-                    raise SSLError(e)
+                    raise SSLError(e) from e
 
-                raise ReadTimeoutError(self._pool, None, "Read timed out.")
+                raise ReadTimeoutError(self._pool, None, "Read timed out.") from e  # type: ignore[arg-type]
 
-            except (HTTPException, SocketError) as e:
+            except (HTTPException, OSError) as e:
                 # This includes IncompleteRead.
-                raise ProtocolError("Connection broken: %r" % e, e)
+                raise ProtocolError(f"Connection broken: {e!r}", e) from e
 
             # If no exception is thrown, we should avoid cleaning up
             # unnecessarily.
@@ -484,7 +750,7 @@ class HTTPResponse(io.IOBase):
             if self._original_response and self._original_response.isclosed():
                 self.release_conn()
 
-    def _fp_read(self, amt):
+    def _fp_read(self, amt: int | None = None) -> bytes:
         """
         Read a response with the thought that reading the number of bytes
         larger than can fit in a 32-bit int at a time via SSL in some
@@ -499,7 +765,7 @@ class HTTPResponse(io.IOBase):
           * CPython < 3.10 only when `amt` does not fit 32-bit int.
         """
         assert self._fp
-        c_int_max = 2 ** 31 - 1
+        c_int_max = 2**31 - 1
         if (
             (
                 (amt and amt > c_int_max)
@@ -515,7 +781,7 @@ class HTTPResponse(io.IOBase):
             # `c_int_max` equal to 2 GiB - 1 byte is the actual maximum
             # chunk size that does not lead to an overflow error, but
             # 256 MiB is a compromise.
-            max_chunk_amt = 2 ** 28
+            max_chunk_amt = 2**28
             while amt is None or amt != 0:
                 if amt is not None:
                     chunk_amt = min(amt, max_chunk_amt)
@@ -532,7 +798,54 @@ class HTTPResponse(io.IOBase):
             # StringIO doesn't like amt=None
             return self._fp.read(amt) if amt is not None else self._fp.read()
 
-    def read(self, amt=None, decode_content=None, cache_content=False):
+    def _raw_read(
+        self,
+        amt: int | None = None,
+    ) -> bytes:
+        """
+        Reads `amt` of bytes from the socket.
+        """
+        if self._fp is None:
+            return None  # type: ignore[return-value]
+
+        fp_closed = getattr(self._fp, "closed", False)
+
+        with self._error_catcher():
+            data = self._fp_read(amt) if not fp_closed else b""
+            if amt is not None and amt != 0 and not data:
+                # Platform-specific: Buggy versions of Python.
+                # Close the connection when no data is returned
+                #
+                # This is redundant to what httplib/http.client _should_
+                # already do.  However, versions of python released before
+                # December 15, 2012 (http://bugs.python.org/issue16298) do
+                # not properly close the connection in all cases. There is
+                # no harm in redundantly calling close.
+                self._fp.close()
+                if (
+                    self.enforce_content_length
+                    and self.length_remaining is not None
+                    and self.length_remaining != 0
+                ):
+                    # This is an edge case that httplib failed to cover due
+                    # to concerns of backward compatibility. We're
+                    # addressing it here to make sure IncompleteRead is
+                    # raised during streaming, so all calls with incorrect
+                    # Content-Length are caught.
+                    raise IncompleteRead(self._fp_bytes_read, self.length_remaining)
+
+        if data:
+            self._fp_bytes_read += len(data)
+            if self.length_remaining is not None:
+                self.length_remaining -= len(data)
+        return data
+
+    def read(
+        self,
+        amt: int | None = None,
+        decode_content: bool | None = None,
+        cache_content: bool = False,
+    ) -> bytes:
         """
         Similar to :meth:`http.client.HTTPResponse.read`, but with two additional
         parameters: ``decode_content`` and ``cache_content``.
@@ -557,54 +870,54 @@ class HTTPResponse(io.IOBase):
         if decode_content is None:
             decode_content = self.decode_content
 
-        if self._fp is None:
-            return
+        if amt is not None:
+            cache_content = False
+
+            if len(self._decoded_buffer) >= amt:
+                return self._decoded_buffer.get(amt)
+
+        data = self._raw_read(amt)
 
         flush_decoder = False
-        fp_closed = getattr(self._fp, "closed", False)
+        if amt is None:
+            flush_decoder = True
+        elif amt != 0 and not data:
+            flush_decoder = True
 
-        with self._error_catcher():
-            data = self._fp_read(amt) if not fp_closed else b""
-            if amt is None:
-                flush_decoder = True
-            else:
-                cache_content = False
-                if (
-                    amt != 0 and not data
-                ):  # Platform-specific: Buggy versions of Python.
-                    # Close the connection when no data is returned
-                    #
-                    # This is redundant to what httplib/http.client _should_
-                    # already do.  However, versions of python released before
-                    # December 15, 2012 (http://bugs.python.org/issue16298) do
-                    # not properly close the connection in all cases. There is
-                    # no harm in redundantly calling close.
-                    self._fp.close()
-                    flush_decoder = True
-                    if self.enforce_content_length and self.length_remaining not in (
-                        0,
-                        None,
-                    ):
-                        # This is an edge case that httplib failed to cover due
-                        # to concerns of backward compatibility. We're
-                        # addressing it here to make sure IncompleteRead is
-                        # raised during streaming, so all calls with incorrect
-                        # Content-Length are caught.
-                        raise IncompleteRead(self._fp_bytes_read, self.length_remaining)
-
-        if data:
-            self._fp_bytes_read += len(data)
-            if self.length_remaining is not None:
-                self.length_remaining -= len(data)
+        if not data and len(self._decoded_buffer) == 0:
+            return data
 
+        if amt is None:
             data = self._decode(data, decode_content, flush_decoder)
-
             if cache_content:
                 self._body = data
+        else:
+            # do not waste memory on buffer when not decoding
+            if not decode_content:
+                if self._has_decoded_content:
+                    raise RuntimeError(
+                        "Calling read(decode_content=False) is not supported after "
+                        "read(decode_content=True) was called."
+                    )
+                return data
+
+            decoded_data = self._decode(data, decode_content, flush_decoder)
+            self._decoded_buffer.put(decoded_data)
+
+            while len(self._decoded_buffer) < amt and data:
+                # TODO make sure to initially read enough data to get past the headers
+                # For example, the GZ file header takes 10 bytes, we don't want to read
+                # it one byte at a time
+                data = self._raw_read(amt)
+                decoded_data = self._decode(data, decode_content, flush_decoder)
+                self._decoded_buffer.put(decoded_data)
+            data = self._decoded_buffer.get(amt)
 
         return data
 
-    def stream(self, amt=2 ** 16, decode_content=None):
+    def stream(
+        self, amt: int | None = 2**16, decode_content: bool | None = None
+    ) -> typing.Generator[bytes, None, None]:
         """
         A generator wrapper for the read() method. A call will block until
         ``amt`` bytes have been read from the connection or until the
@@ -621,73 +934,20 @@ class HTTPResponse(io.IOBase):
             'content-encoding' header.
         """
         if self.chunked and self.supports_chunked_reads():
-            for line in self.read_chunked(amt, decode_content=decode_content):
-                yield line
+            yield from self.read_chunked(amt, decode_content=decode_content)
         else:
-            while not is_fp_closed(self._fp):
+            while not is_fp_closed(self._fp) or len(self._decoded_buffer) > 0:
                 data = self.read(amt=amt, decode_content=decode_content)
 
                 if data:
                     yield data
 
-    @classmethod
-    def from_httplib(ResponseCls, r, **response_kw):
-        """
-        Given an :class:`http.client.HTTPResponse` instance ``r``, return a
-        corresponding :class:`urllib3.response.HTTPResponse` object.
-
-        Remaining parameters are passed to the HTTPResponse constructor, along
-        with ``original_response=r``.
-        """
-        headers = r.msg
-
-        if not isinstance(headers, HTTPHeaderDict):
-            if six.PY2:
-                # Python 2.7
-                headers = HTTPHeaderDict.from_httplib(headers)
-            else:
-                headers = HTTPHeaderDict(headers.items())
-
-        # HTTPResponse objects in Python 3 don't have a .strict attribute
-        strict = getattr(r, "strict", 0)
-        resp = ResponseCls(
-            body=r,
-            headers=headers,
-            status=r.status,
-            version=r.version,
-            reason=r.reason,
-            strict=strict,
-            original_response=r,
-            **response_kw
-        )
-        return resp
-
-    # Backwards-compatibility methods for http.client.HTTPResponse
-    def getheaders(self):
-        warnings.warn(
-            "HTTPResponse.getheaders() is deprecated and will be removed "
-            "in urllib3 v2.1.0. Instead access HTTPResponse.headers directly.",
-            category=DeprecationWarning,
-            stacklevel=2,
-        )
-        return self.headers
-
-    def getheader(self, name, default=None):
-        warnings.warn(
-            "HTTPResponse.getheader() is deprecated and will be removed "
-            "in urllib3 v2.1.0. Instead use HTTPResponse.headers.get(name, default).",
-            category=DeprecationWarning,
-            stacklevel=2,
-        )
-        return self.headers.get(name, default)
-
-    # Backwards compatibility for http.cookiejar
-    def info(self):
-        return self.headers
-
     # Overrides from io.IOBase
-    def close(self):
-        if not self.closed:
+    def readable(self) -> bool:
+        return True
+
+    def close(self) -> None:
+        if not self.closed and self._fp:
             self._fp.close()
 
         if self._connection:
@@ -697,9 +957,9 @@ class HTTPResponse(io.IOBase):
             io.IOBase.close(self)
 
     @property
-    def closed(self):
+    def closed(self) -> bool:
         if not self.auto_close:
-            return io.IOBase.closed.__get__(self)
+            return io.IOBase.closed.__get__(self)  # type: ignore[no-any-return]
         elif self._fp is None:
             return True
         elif hasattr(self._fp, "isclosed"):
@@ -709,18 +969,18 @@ class HTTPResponse(io.IOBase):
         else:
             return True
 
-    def fileno(self):
+    def fileno(self) -> int:
         if self._fp is None:
-            raise IOError("HTTPResponse has no file to get a fileno from")
+            raise OSError("HTTPResponse has no file to get a fileno from")
         elif hasattr(self._fp, "fileno"):
             return self._fp.fileno()
         else:
-            raise IOError(
+            raise OSError(
                 "The file-like object this HTTPResponse is wrapped "
                 "around has no file descriptor"
             )
 
-    def flush(self):
+    def flush(self) -> None:
         if (
             self._fp is not None
             and hasattr(self._fp, "flush")
@@ -728,20 +988,7 @@ class HTTPResponse(io.IOBase):
         ):
             return self._fp.flush()
 
-    def readable(self):
-        # This method is required for `io` module compatibility.
-        return True
-
-    def readinto(self, b):
-        # This method is required for `io` module compatibility.
-        temp = self.read(len(b))
-        if len(temp) == 0:
-            return 0
-        else:
-            b[: len(temp)] = temp
-            return len(temp)
-
-    def supports_chunked_reads(self):
+    def supports_chunked_reads(self) -> bool:
         """
         Checks if the underlying file-like object looks like a
         :class:`http.client.HTTPResponse` object. We do this by testing for
@@ -750,43 +997,45 @@ class HTTPResponse(io.IOBase):
         """
         return hasattr(self._fp, "fp")
 
-    def _update_chunk_length(self):
+    def _update_chunk_length(self) -> None:
         # First, we'll figure out length of a chunk and then
         # we'll try to read it from socket.
         if self.chunk_left is not None:
-            return
-        line = self._fp.fp.readline()
+            return None
+        line = self._fp.fp.readline()  # type: ignore[union-attr]
         line = line.split(b";", 1)[0]
         try:
             self.chunk_left = int(line, 16)
         except ValueError:
             # Invalid chunked protocol response, abort.
             self.close()
-            raise InvalidChunkLength(self, line)
+            raise InvalidChunkLength(self, line) from None
 
-    def _handle_chunk(self, amt):
+    def _handle_chunk(self, amt: int | None) -> bytes:
         returned_chunk = None
         if amt is None:
-            chunk = self._fp._safe_read(self.chunk_left)
+            chunk = self._fp._safe_read(self.chunk_left)  # type: ignore[union-attr]
             returned_chunk = chunk
-            self._fp._safe_read(2)  # Toss the CRLF at the end of the chunk.
+            self._fp._safe_read(2)  # type: ignore[union-attr] # Toss the CRLF at the end of the chunk.
             self.chunk_left = None
-        elif amt < self.chunk_left:
-            value = self._fp._safe_read(amt)
+        elif self.chunk_left is not None and amt < self.chunk_left:
+            value = self._fp._safe_read(amt)  # type: ignore[union-attr]
             self.chunk_left = self.chunk_left - amt
             returned_chunk = value
         elif amt == self.chunk_left:
-            value = self._fp._safe_read(amt)
-            self._fp._safe_read(2)  # Toss the CRLF at the end of the chunk.
+            value = self._fp._safe_read(amt)  # type: ignore[union-attr]
+            self._fp._safe_read(2)  # type: ignore[union-attr] # Toss the CRLF at the end of the chunk.
             self.chunk_left = None
             returned_chunk = value
         else:  # amt > self.chunk_left
-            returned_chunk = self._fp._safe_read(self.chunk_left)
-            self._fp._safe_read(2)  # Toss the CRLF at the end of the chunk.
+            returned_chunk = self._fp._safe_read(self.chunk_left)  # type: ignore[union-attr]
+            self._fp._safe_read(2)  # type: ignore[union-attr] # Toss the CRLF at the end of the chunk.
             self.chunk_left = None
-        return returned_chunk
+        return returned_chunk  # type: ignore[no-any-return]
 
-    def read_chunked(self, amt=None, decode_content=None):
+    def read_chunked(
+        self, amt: int | None = None, decode_content: bool | None = None
+    ) -> typing.Generator[bytes, None, None]:
         """
         Similar to :meth:`HTTPResponse.read`, but with an additional
         parameter: ``decode_content``.
@@ -817,12 +1066,12 @@ class HTTPResponse(io.IOBase):
             # Don't bother reading the body of a HEAD request.
             if self._original_response and is_response_to_head(self._original_response):
                 self._original_response.close()
-                return
+                return None
 
             # If a response is already read and closed
             # then return immediately.
-            if self._fp.fp is None:
-                return
+            if self._fp.fp is None:  # type: ignore[union-attr]
+                return None
 
             while True:
                 self._update_chunk_length()
@@ -844,7 +1093,7 @@ class HTTPResponse(io.IOBase):
                     yield decoded
 
             # Chunk content ends with \r\n: discard it.
-            while True:
+            while self._fp is not None:
                 line = self._fp.fp.readline()
                 if not line:
                     # Some sites may not end with '\r\n'.
@@ -856,27 +1105,29 @@ class HTTPResponse(io.IOBase):
             if self._original_response:
                 self._original_response.close()
 
-    def geturl(self):
+    @property
+    def url(self) -> str | None:
         """
         Returns the URL that was the source of this response.
         If the request that generated this response redirected, this method
         will return the final redirect location.
         """
-        if self.retries is not None and len(self.retries.history):
-            return self.retries.history[-1].redirect_location
-        else:
-            return self._request_url
+        return self._request_url
 
-    def __iter__(self):
-        buffer = []
+    @url.setter
+    def url(self, url: str) -> None:
+        self._request_url = url
+
+    def __iter__(self) -> typing.Iterator[bytes]:
+        buffer: list[bytes] = []
         for chunk in self.stream(decode_content=True):
             if b"\n" in chunk:
-                chunk = chunk.split(b"\n")
-                yield b"".join(buffer) + chunk[0] + b"\n"
-                for x in chunk[1:-1]:
+                chunks = chunk.split(b"\n")
+                yield b"".join(buffer) + chunks[0] + b"\n"
+                for x in chunks[1:-1]:
                     yield x + b"\n"
-                if chunk[-1]:
-                    buffer = [chunk[-1]]
+                if chunks[-1]:
+                    buffer = [chunks[-1]]
                 else:
                     buffer = []
             else:
diff --git a/lib/urllib3/util/__init__.py b/lib/urllib3/util/__init__.py
index 4547fc52..ff56c55b 100644
--- a/lib/urllib3/util/__init__.py
+++ b/lib/urllib3/util/__init__.py
@@ -1,46 +1,41 @@
-from __future__ import absolute_import
-
 # For backwards compatibility, provide imports that used to be here.
+from __future__ import annotations
+
 from .connection import is_connection_dropped
 from .request import SKIP_HEADER, SKIPPABLE_HEADERS, make_headers
 from .response import is_fp_closed
 from .retry import Retry
 from .ssl_ import (
     ALPN_PROTOCOLS,
-    HAS_SNI,
     IS_PYOPENSSL,
     IS_SECURETRANSPORT,
-    PROTOCOL_TLS,
     SSLContext,
     assert_fingerprint,
+    create_urllib3_context,
     resolve_cert_reqs,
     resolve_ssl_version,
     ssl_wrap_socket,
 )
-from .timeout import Timeout, current_time
-from .url import Url, get_host, parse_url, split_first
+from .timeout import Timeout
+from .url import Url, parse_url
 from .wait import wait_for_read, wait_for_write
 
 __all__ = (
-    "HAS_SNI",
     "IS_PYOPENSSL",
     "IS_SECURETRANSPORT",
     "SSLContext",
-    "PROTOCOL_TLS",
     "ALPN_PROTOCOLS",
     "Retry",
     "Timeout",
     "Url",
     "assert_fingerprint",
-    "current_time",
+    "create_urllib3_context",
     "is_connection_dropped",
     "is_fp_closed",
-    "get_host",
     "parse_url",
     "make_headers",
     "resolve_cert_reqs",
     "resolve_ssl_version",
-    "split_first",
     "ssl_wrap_socket",
     "wait_for_read",
     "wait_for_write",
diff --git a/lib/urllib3/util/connection.py b/lib/urllib3/util/connection.py
index 6af1138f..5c7da73f 100644
--- a/lib/urllib3/util/connection.py
+++ b/lib/urllib3/util/connection.py
@@ -1,33 +1,23 @@
-from __future__ import absolute_import
+from __future__ import annotations
 
 import socket
+import typing
 
-from ..contrib import _appengine_environ
 from ..exceptions import LocationParseError
-from ..packages import six
-from .wait import NoWayToWaitForSocketError, wait_for_read
+from .timeout import _DEFAULT_TIMEOUT, _TYPE_TIMEOUT
+
+_TYPE_SOCKET_OPTIONS = typing.Sequence[typing.Tuple[int, int, typing.Union[int, bytes]]]
+
+if typing.TYPE_CHECKING:
+    from .._base_connection import BaseHTTPConnection
 
 
-def is_connection_dropped(conn):  # Platform-specific
+def is_connection_dropped(conn: BaseHTTPConnection) -> bool:  # Platform-specific
     """
     Returns True if the connection is dropped and should be closed.
-
-    :param conn:
-        :class:`http.client.HTTPConnection` object.
-
-    Note: For platforms like AppEngine, this will always return ``False`` to
-    let the platform handle connection recycling transparently for us.
+    :param conn: :class:`urllib3.connection.HTTPConnection` object.
     """
-    sock = getattr(conn, "sock", False)
-    if sock is False:  # Platform-specific: AppEngine
-        return False
-    if sock is None:  # Connection already closed (such as by httplib).
-        return True
-    try:
-        # Returns True if readable, which here means it's been dropped
-        return wait_for_read(sock, timeout=0.0)
-    except NoWayToWaitForSocketError:  # Platform-specific: AppEngine
-        return False
+    return not conn.is_connected
 
 
 # This function is copied from socket.py in the Python 2.7 standard
@@ -35,11 +25,11 @@ def is_connection_dropped(conn):  # Platform-specific
 # One additional modification is that we avoid binding to IPv6 servers
 # discovered in DNS if the system doesn't have IPv6 functionality.
 def create_connection(
-    address,
-    timeout=socket._GLOBAL_DEFAULT_TIMEOUT,
-    source_address=None,
-    socket_options=None,
-):
+    address: tuple[str, int],
+    timeout: _TYPE_TIMEOUT = _DEFAULT_TIMEOUT,
+    source_address: tuple[str, int] | None = None,
+    socket_options: _TYPE_SOCKET_OPTIONS | None = None,
+) -> socket.socket:
     """Connect to *address* and return the socket object.
 
     Convenience function.  Connect to *address* (a 2-tuple ``(host,
@@ -65,9 +55,7 @@ def create_connection(
     try:
         host.encode("idna")
     except UnicodeError:
-        return six.raise_from(
-            LocationParseError(u"'%s', label empty or too long" % host), None
-        )
+        raise LocationParseError(f"'{host}', label empty or too long") from None
 
     for res in socket.getaddrinfo(host, port, family, socket.SOCK_STREAM):
         af, socktype, proto, canonname, sa = res
@@ -78,26 +66,33 @@ def create_connection(
             # If provided, set socket level options before connecting.
             _set_socket_options(sock, socket_options)
 
-            if timeout is not socket._GLOBAL_DEFAULT_TIMEOUT:
+            if timeout is not _DEFAULT_TIMEOUT:
                 sock.settimeout(timeout)
             if source_address:
                 sock.bind(source_address)
             sock.connect(sa)
+            # Break explicitly a reference cycle
+            err = None
             return sock
 
-        except socket.error as e:
-            err = e
+        except OSError as _:
+            err = _
             if sock is not None:
                 sock.close()
-                sock = None
 
     if err is not None:
-        raise err
-
-    raise socket.error("getaddrinfo returns an empty list")
+        try:
+            raise err
+        finally:
+            # Break explicitly a reference cycle
+            err = None
+    else:
+        raise OSError("getaddrinfo returns an empty list")
 
 
-def _set_socket_options(sock, options):
+def _set_socket_options(
+    sock: socket.socket, options: _TYPE_SOCKET_OPTIONS | None
+) -> None:
     if options is None:
         return
 
@@ -105,7 +100,7 @@ def _set_socket_options(sock, options):
         sock.setsockopt(*opt)
 
 
-def allowed_gai_family():
+def allowed_gai_family() -> socket.AddressFamily:
     """This function is designed to work in the context of
     getaddrinfo, where family=socket.AF_UNSPEC is the default and
     will perform a DNS search for both IPv6 and IPv4 records."""
@@ -116,18 +111,11 @@ def allowed_gai_family():
     return family
 
 
-def _has_ipv6(host):
+def _has_ipv6(host: str) -> bool:
     """Returns True if the system can bind an IPv6 address."""
     sock = None
     has_ipv6 = False
 
-    # App Engine doesn't support IPV6 sockets and actually has a quota on the
-    # number of sockets that can be used, so just early out here instead of
-    # creating a socket needlessly.
-    # See https://github.com/urllib3/urllib3/issues/1446
-    if _appengine_environ.is_appengine_sandbox():
-        return False
-
     if socket.has_ipv6:
         # has_ipv6 returns true if cPython was compiled with IPv6 support.
         # It does not tell us if the system has IPv6 support enabled. To
diff --git a/lib/urllib3/util/proxy.py b/lib/urllib3/util/proxy.py
index 2199cc7b..908fc662 100644
--- a/lib/urllib3/util/proxy.py
+++ b/lib/urllib3/util/proxy.py
@@ -1,9 +1,18 @@
-from .ssl_ import create_urllib3_context, resolve_cert_reqs, resolve_ssl_version
+from __future__ import annotations
+
+import typing
+
+from .url import Url
+
+if typing.TYPE_CHECKING:
+    from ..connection import ProxyConfig
 
 
 def connection_requires_http_tunnel(
-    proxy_url=None, proxy_config=None, destination_scheme=None
-):
+    proxy_url: Url | None = None,
+    proxy_config: ProxyConfig | None = None,
+    destination_scheme: str | None = None,
+) -> bool:
     """
     Returns True if the connection requires an HTTP CONNECT through the proxy.
 
@@ -32,26 +41,3 @@ def connection_requires_http_tunnel(
 
     # Otherwise always use a tunnel.
     return True
-
-
-def create_proxy_ssl_context(
-    ssl_version, cert_reqs, ca_certs=None, ca_cert_dir=None, ca_cert_data=None
-):
-    """
-    Generates a default proxy ssl context if one hasn't been provided by the
-    user.
-    """
-    ssl_context = create_urllib3_context(
-        ssl_version=resolve_ssl_version(ssl_version),
-        cert_reqs=resolve_cert_reqs(cert_reqs),
-    )
-
-    if (
-        not ca_certs
-        and not ca_cert_dir
-        and not ca_cert_data
-        and hasattr(ssl_context, "load_default_certs")
-    ):
-        ssl_context.load_default_certs()
-
-    return ssl_context
diff --git a/lib/urllib3/util/queue.py b/lib/urllib3/util/queue.py
deleted file mode 100644
index 41784104..00000000
--- a/lib/urllib3/util/queue.py
+++ /dev/null
@@ -1,22 +0,0 @@
-import collections
-
-from ..packages import six
-from ..packages.six.moves import queue
-
-if six.PY2:
-    # Queue is imported for side effects on MS Windows. See issue #229.
-    import Queue as _unused_module_Queue  # noqa: F401
-
-
-class LifoQueue(queue.Queue):
-    def _init(self, _):
-        self.queue = collections.deque()
-
-    def _qsize(self, len=len):
-        return len(self.queue)
-
-    def _put(self, item):
-        self.queue.append(item)
-
-    def _get(self):
-        return self.queue.pop()
diff --git a/lib/urllib3/util/request.py b/lib/urllib3/util/request.py
index b574b081..7d6866f3 100644
--- a/lib/urllib3/util/request.py
+++ b/lib/urllib3/util/request.py
@@ -1,9 +1,15 @@
-from __future__ import absolute_import
+from __future__ import annotations
 
+import io
+import typing
 from base64 import b64encode
+from enum import Enum
 
 from ..exceptions import UnrewindableBodyError
-from ..packages.six import b, integer_types
+from .util import to_bytes
+
+if typing.TYPE_CHECKING:
+    from typing_extensions import Final
 
 # Pass as a value within ``headers`` to skip
 # emitting some HTTP headers that are added automatically.
@@ -15,25 +21,45 @@ SKIPPABLE_HEADERS = frozenset(["accept-encoding", "host", "user-agent"])
 ACCEPT_ENCODING = "gzip,deflate"
 try:
     try:
-        import brotlicffi as _unused_module_brotli  # noqa: F401
+        import brotlicffi as _unused_module_brotli  # type: ignore[import] # noqa: F401
     except ImportError:
-        import brotli as _unused_module_brotli  # noqa: F401
+        import brotli as _unused_module_brotli  # type: ignore[import] # noqa: F401
 except ImportError:
     pass
 else:
     ACCEPT_ENCODING += ",br"
+try:
+    import zstandard as _unused_module_zstd  # type: ignore[import] # noqa: F401
+except ImportError:
+    pass
+else:
+    ACCEPT_ENCODING += ",zstd"
 
-_FAILEDTELL = object()
+
+class _TYPE_FAILEDTELL(Enum):
+    token = 0
+
+
+_FAILEDTELL: Final[_TYPE_FAILEDTELL] = _TYPE_FAILEDTELL.token
+
+_TYPE_BODY_POSITION = typing.Union[int, _TYPE_FAILEDTELL]
+
+# When sending a request with these methods we aren't expecting
+# a body so don't need to set an explicit 'Content-Length: 0'
+# The reason we do this in the negative instead of tracking methods
+# which 'should' have a body is because unknown methods should be
+# treated as if they were 'POST' which *does* expect a body.
+_METHODS_NOT_EXPECTING_BODY = {"GET", "HEAD", "DELETE", "TRACE", "OPTIONS", "CONNECT"}
 
 
 def make_headers(
-    keep_alive=None,
-    accept_encoding=None,
-    user_agent=None,
-    basic_auth=None,
-    proxy_basic_auth=None,
-    disable_cache=None,
-):
+    keep_alive: bool | None = None,
+    accept_encoding: bool | list[str] | str | None = None,
+    user_agent: str | None = None,
+    basic_auth: str | None = None,
+    proxy_basic_auth: str | None = None,
+    disable_cache: bool | None = None,
+) -> dict[str, str]:
     """
     Shortcuts for generating request headers.
 
@@ -42,7 +68,8 @@ def make_headers(
 
     :param accept_encoding:
         Can be a boolean, list, or string.
-        ``True`` translates to 'gzip,deflate'.
+        ``True`` translates to 'gzip,deflate'.  If either the ``brotli`` or
+        ``brotlicffi`` package is installed 'gzip,deflate,br' is used instead.
         List will get joined by comma.
         String will be used as provided.
 
@@ -61,14 +88,18 @@ def make_headers(
     :param disable_cache:
         If ``True``, adds 'cache-control: no-cache' header.
 
-    Example::
+    Example:
 
-        >>> make_headers(keep_alive=True, user_agent="Batman/1.0")
-        {'connection': 'keep-alive', 'user-agent': 'Batman/1.0'}
-        >>> make_headers(accept_encoding=True)
-        {'accept-encoding': 'gzip,deflate'}
+    .. code-block:: python
+
+        import urllib3
+
+        print(urllib3.util.make_headers(keep_alive=True, user_agent="Batman/1.0"))
+        # {'connection': 'keep-alive', 'user-agent': 'Batman/1.0'}
+        print(urllib3.util.make_headers(accept_encoding=True))
+        # {'accept-encoding': 'gzip,deflate'}
     """
-    headers = {}
+    headers: dict[str, str] = {}
     if accept_encoding:
         if isinstance(accept_encoding, str):
             pass
@@ -85,12 +116,14 @@ def make_headers(
         headers["connection"] = "keep-alive"
 
     if basic_auth:
-        headers["authorization"] = "Basic " + b64encode(b(basic_auth)).decode("utf-8")
+        headers[
+            "authorization"
+        ] = f"Basic {b64encode(basic_auth.encode('latin-1')).decode()}"
 
     if proxy_basic_auth:
-        headers["proxy-authorization"] = "Basic " + b64encode(
-            b(proxy_basic_auth)
-        ).decode("utf-8")
+        headers[
+            "proxy-authorization"
+        ] = f"Basic {b64encode(proxy_basic_auth.encode('latin-1')).decode()}"
 
     if disable_cache:
         headers["cache-control"] = "no-cache"
@@ -98,7 +131,9 @@ def make_headers(
     return headers
 
 
-def set_file_position(body, pos):
+def set_file_position(
+    body: typing.Any, pos: _TYPE_BODY_POSITION | None
+) -> _TYPE_BODY_POSITION | None:
     """
     If a position is provided, move file to that point.
     Otherwise, we'll attempt to record a position for future use.
@@ -108,7 +143,7 @@ def set_file_position(body, pos):
     elif getattr(body, "tell", None) is not None:
         try:
             pos = body.tell()
-        except (IOError, OSError):
+        except OSError:
             # This differentiates from None, allowing us to catch
             # a failed `tell()` later when trying to rewind the body.
             pos = _FAILEDTELL
@@ -116,7 +151,7 @@ def set_file_position(body, pos):
     return pos
 
 
-def rewind_body(body, body_pos):
+def rewind_body(body: typing.IO[typing.AnyStr], body_pos: _TYPE_BODY_POSITION) -> None:
     """
     Attempt to rewind body to a certain position.
     Primarily used for request redirects and retries.
@@ -128,13 +163,13 @@ def rewind_body(body, body_pos):
         Position to seek to in file.
     """
     body_seek = getattr(body, "seek", None)
-    if body_seek is not None and isinstance(body_pos, integer_types):
+    if body_seek is not None and isinstance(body_pos, int):
         try:
             body_seek(body_pos)
-        except (IOError, OSError):
+        except OSError as e:
             raise UnrewindableBodyError(
                 "An error occurred when rewinding request body for redirect/retry."
-            )
+            ) from e
     elif body_pos is _FAILEDTELL:
         raise UnrewindableBodyError(
             "Unable to record file position for rewinding "
@@ -142,5 +177,80 @@ def rewind_body(body, body_pos):
         )
     else:
         raise ValueError(
-            "body_pos must be of type integer, instead it was %s." % type(body_pos)
+            f"body_pos must be of type integer, instead it was {type(body_pos)}."
         )
+
+
+class ChunksAndContentLength(typing.NamedTuple):
+    chunks: typing.Iterable[bytes] | None
+    content_length: int | None
+
+
+def body_to_chunks(
+    body: typing.Any | None, method: str, blocksize: int
+) -> ChunksAndContentLength:
+    """Takes the HTTP request method, body, and blocksize and
+    transforms them into an iterable of chunks to pass to
+    socket.sendall() and an optional 'Content-Length' header.
+
+    A 'Content-Length' of 'None' indicates the length of the body
+    can't be determined so should use 'Transfer-Encoding: chunked'
+    for framing instead.
+    """
+
+    chunks: typing.Iterable[bytes] | None
+    content_length: int | None
+
+    # No body, we need to make a recommendation on 'Content-Length'
+    # based on whether that request method is expected to have
+    # a body or not.
+    if body is None:
+        chunks = None
+        if method.upper() not in _METHODS_NOT_EXPECTING_BODY:
+            content_length = 0
+        else:
+            content_length = None
+
+    # Bytes or strings become bytes
+    elif isinstance(body, (str, bytes)):
+        chunks = (to_bytes(body),)
+        content_length = len(chunks[0])
+
+    # File-like object, TODO: use seek() and tell() for length?
+    elif hasattr(body, "read"):
+
+        def chunk_readable() -> typing.Iterable[bytes]:
+            nonlocal body, blocksize
+            encode = isinstance(body, io.TextIOBase)
+            while True:
+                datablock = body.read(blocksize)
+                if not datablock:
+                    break
+                if encode:
+                    datablock = datablock.encode("iso-8859-1")
+                yield datablock
+
+        chunks = chunk_readable()
+        content_length = None
+
+    # Otherwise we need to start checking via duck-typing.
+    else:
+        try:
+            # Check if the body implements the buffer API.
+            mv = memoryview(body)
+        except TypeError:
+            try:
+                # Check if the body is an iterable
+                chunks = iter(body)
+                content_length = None
+            except TypeError:
+                raise TypeError(
+                    f"'body' must be a bytes-like object, file-like "
+                    f"object, or iterable. Instead was {body!r}"
+                ) from None
+        else:
+            # Since it implements the buffer API can be passed directly to socket.sendall()
+            chunks = (body,)
+            content_length = mv.nbytes
+
+    return ChunksAndContentLength(chunks=chunks, content_length=content_length)
diff --git a/lib/urllib3/util/response.py b/lib/urllib3/util/response.py
index 5ea609cc..0f457869 100644
--- a/lib/urllib3/util/response.py
+++ b/lib/urllib3/util/response.py
@@ -1,12 +1,12 @@
-from __future__ import absolute_import
+from __future__ import annotations
 
+import http.client as httplib
 from email.errors import MultipartInvariantViolationDefect, StartBoundaryNotFoundDefect
 
 from ..exceptions import HeaderParsingError
-from ..packages.six.moves import http_client as httplib
 
 
-def is_fp_closed(obj):
+def is_fp_closed(obj: object) -> bool:
     """
     Checks whether a given file-like object is closed.
 
@@ -17,27 +17,27 @@ def is_fp_closed(obj):
     try:
         # Check `isclosed()` first, in case Python3 doesn't set `closed`.
         # GH Issue #928
-        return obj.isclosed()
+        return obj.isclosed()  # type: ignore[no-any-return, attr-defined]
     except AttributeError:
         pass
 
     try:
         # Check via the official file-like-object way.
-        return obj.closed
+        return obj.closed  # type: ignore[no-any-return, attr-defined]
     except AttributeError:
         pass
 
     try:
         # Check if the object is a container for another file-like object that
         # gets released on exhaustion (e.g. HTTPResponse).
-        return obj.fp is None
+        return obj.fp is None  # type: ignore[attr-defined]
     except AttributeError:
         pass
 
     raise ValueError("Unable to determine whether fp is closed.")
 
 
-def assert_header_parsing(headers):
+def assert_header_parsing(headers: httplib.HTTPMessage) -> None:
     """
     Asserts whether all headers have been successfully parsed.
     Extracts encountered errors from the result of parsing headers.
@@ -53,55 +53,49 @@ def assert_header_parsing(headers):
     # This will fail silently if we pass in the wrong kind of parameter.
     # To make debugging easier add an explicit check.
     if not isinstance(headers, httplib.HTTPMessage):
-        raise TypeError("expected httplib.Message, got {0}.".format(type(headers)))
-
-    defects = getattr(headers, "defects", None)
-    get_payload = getattr(headers, "get_payload", None)
+        raise TypeError(f"expected httplib.Message, got {type(headers)}.")
 
     unparsed_data = None
-    if get_payload:
-        # get_payload is actually email.message.Message.get_payload;
-        # we're only interested in the result if it's not a multipart message
-        if not headers.is_multipart():
-            payload = get_payload()
 
-            if isinstance(payload, (bytes, str)):
-                unparsed_data = payload
-    if defects:
-        # httplib is assuming a response body is available
-        # when parsing headers even when httplib only sends
-        # header data to parse_headers() This results in
-        # defects on multipart responses in particular.
-        # See: https://github.com/urllib3/urllib3/issues/800
+    # get_payload is actually email.message.Message.get_payload;
+    # we're only interested in the result if it's not a multipart message
+    if not headers.is_multipart():
+        payload = headers.get_payload()
 
-        # So we ignore the following defects:
-        # - StartBoundaryNotFoundDefect:
-        #     The claimed start boundary was never found.
-        # - MultipartInvariantViolationDefect:
-        #     A message claimed to be a multipart but no subparts were found.
-        defects = [
-            defect
-            for defect in defects
-            if not isinstance(
-                defect, (StartBoundaryNotFoundDefect, MultipartInvariantViolationDefect)
-            )
-        ]
+        if isinstance(payload, (bytes, str)):
+            unparsed_data = payload
+
+    # httplib is assuming a response body is available
+    # when parsing headers even when httplib only sends
+    # header data to parse_headers() This results in
+    # defects on multipart responses in particular.
+    # See: https://github.com/urllib3/urllib3/issues/800
+
+    # So we ignore the following defects:
+    # - StartBoundaryNotFoundDefect:
+    #     The claimed start boundary was never found.
+    # - MultipartInvariantViolationDefect:
+    #     A message claimed to be a multipart but no subparts were found.
+    defects = [
+        defect
+        for defect in headers.defects
+        if not isinstance(
+            defect, (StartBoundaryNotFoundDefect, MultipartInvariantViolationDefect)
+        )
+    ]
 
     if defects or unparsed_data:
         raise HeaderParsingError(defects=defects, unparsed_data=unparsed_data)
 
 
-def is_response_to_head(response):
+def is_response_to_head(response: httplib.HTTPResponse) -> bool:
     """
     Checks whether the request of a response has been a HEAD-request.
-    Handles the quirks of AppEngine.
 
     :param http.client.HTTPResponse response:
         Response to check if the originating request
         used 'HEAD' as a method.
     """
     # FIXME: Can we do this somehow without accessing private httplib _method?
-    method = response._method
-    if isinstance(method, int):  # Platform-specific: Appengine
-        return method == 3
-    return method.upper() == "HEAD"
+    method_str = response._method  # type: str  # type: ignore[attr-defined]
+    return method_str.upper() == "HEAD"
diff --git a/lib/urllib3/util/retry.py b/lib/urllib3/util/retry.py
index 2490d5e5..ea48afe3 100644
--- a/lib/urllib3/util/retry.py
+++ b/lib/urllib3/util/retry.py
@@ -1,12 +1,13 @@
-from __future__ import absolute_import
+from __future__ import annotations
 
 import email
 import logging
+import random
 import re
 import time
-import warnings
-from collections import namedtuple
+import typing
 from itertools import takewhile
+from types import TracebackType
 
 from ..exceptions import (
     ConnectTimeoutError,
@@ -17,97 +18,49 @@ from ..exceptions import (
     ReadTimeoutError,
     ResponseError,
 )
-from ..packages import six
+from .util import reraise
+
+if typing.TYPE_CHECKING:
+    from ..connectionpool import ConnectionPool
+    from ..response import BaseHTTPResponse
 
 log = logging.getLogger(__name__)
 
 
 # Data structure for representing the metadata of requests that result in a retry.
-RequestHistory = namedtuple(
-    "RequestHistory", ["method", "url", "error", "status", "redirect_location"]
-)
+class RequestHistory(typing.NamedTuple):
+    method: str | None
+    url: str | None
+    error: Exception | None
+    status: int | None
+    redirect_location: str | None
 
 
-# TODO: In v2 we can remove this sentinel and metaclass with deprecated options.
-_Default = object()
-
-
-class _RetryMeta(type):
-    @property
-    def DEFAULT_METHOD_WHITELIST(cls):
-        warnings.warn(
-            "Using 'Retry.DEFAULT_METHOD_WHITELIST' is deprecated and "
-            "will be removed in v2.0. Use 'Retry.DEFAULT_ALLOWED_METHODS' instead",
-            DeprecationWarning,
-        )
-        return cls.DEFAULT_ALLOWED_METHODS
-
-    @DEFAULT_METHOD_WHITELIST.setter
-    def DEFAULT_METHOD_WHITELIST(cls, value):
-        warnings.warn(
-            "Using 'Retry.DEFAULT_METHOD_WHITELIST' is deprecated and "
-            "will be removed in v2.0. Use 'Retry.DEFAULT_ALLOWED_METHODS' instead",
-            DeprecationWarning,
-        )
-        cls.DEFAULT_ALLOWED_METHODS = value
-
-    @property
-    def DEFAULT_REDIRECT_HEADERS_BLACKLIST(cls):
-        warnings.warn(
-            "Using 'Retry.DEFAULT_REDIRECT_HEADERS_BLACKLIST' is deprecated and "
-            "will be removed in v2.0. Use 'Retry.DEFAULT_REMOVE_HEADERS_ON_REDIRECT' instead",
-            DeprecationWarning,
-        )
-        return cls.DEFAULT_REMOVE_HEADERS_ON_REDIRECT
-
-    @DEFAULT_REDIRECT_HEADERS_BLACKLIST.setter
-    def DEFAULT_REDIRECT_HEADERS_BLACKLIST(cls, value):
-        warnings.warn(
-            "Using 'Retry.DEFAULT_REDIRECT_HEADERS_BLACKLIST' is deprecated and "
-            "will be removed in v2.0. Use 'Retry.DEFAULT_REMOVE_HEADERS_ON_REDIRECT' instead",
-            DeprecationWarning,
-        )
-        cls.DEFAULT_REMOVE_HEADERS_ON_REDIRECT = value
-
-    @property
-    def BACKOFF_MAX(cls):
-        warnings.warn(
-            "Using 'Retry.BACKOFF_MAX' is deprecated and "
-            "will be removed in v2.0. Use 'Retry.DEFAULT_BACKOFF_MAX' instead",
-            DeprecationWarning,
-        )
-        return cls.DEFAULT_BACKOFF_MAX
-
-    @BACKOFF_MAX.setter
-    def BACKOFF_MAX(cls, value):
-        warnings.warn(
-            "Using 'Retry.BACKOFF_MAX' is deprecated and "
-            "will be removed in v2.0. Use 'Retry.DEFAULT_BACKOFF_MAX' instead",
-            DeprecationWarning,
-        )
-        cls.DEFAULT_BACKOFF_MAX = value
-
-
-@six.add_metaclass(_RetryMeta)
-class Retry(object):
+class Retry:
     """Retry configuration.
 
     Each retry attempt will create a new Retry object with updated values, so
     they can be safely reused.
 
-    Retries can be defined as a default for a pool::
+    Retries can be defined as a default for a pool:
+
+    .. code-block:: python
 
         retries = Retry(connect=5, read=2, redirect=5)
         http = PoolManager(retries=retries)
-        response = http.request('GET', 'http://example.com/')
+        response = http.request("GET", "https://example.com/")
 
-    Or per-request (which overrides the default for the pool)::
+    Or per-request (which overrides the default for the pool):
 
-        response = http.request('GET', 'http://example.com/', retries=Retry(10))
+    .. code-block:: python
 
-    Retries can be disabled by passing ``False``::
+        response = http.request("GET", "https://example.com/", retries=Retry(10))
 
-        response = http.request('GET', 'http://example.com/', retries=False)
+    Retries can be disabled by passing ``False``:
+
+    .. code-block:: python
+
+        response = http.request("GET", "https://example.com/", retries=False)
 
     Errors will be wrapped in :class:`~urllib3.exceptions.MaxRetryError` unless
     retries are disabled, in which case the causing exception will be raised.
@@ -169,21 +122,16 @@ class Retry(object):
         If ``total`` is not set, it's a good idea to set this to 0 to account
         for unexpected edge cases and avoid infinite retry loops.
 
-    :param iterable allowed_methods:
+    :param Collection allowed_methods:
         Set of uppercased HTTP method verbs that we should retry on.
 
         By default, we only retry on methods which are considered to be
         idempotent (multiple requests with the same parameters end with the
         same state). See :attr:`Retry.DEFAULT_ALLOWED_METHODS`.
 
-        Set to a ``False`` value to retry on any verb.
+        Set to a ``None`` value to retry on any verb.
 
-        .. warning::
-
-            Previously this parameter was named ``method_whitelist``, that
-            usage is deprecated in v1.26.0 and will be removed in v2.0.
-
-    :param iterable status_forcelist:
+    :param Collection status_forcelist:
         A set of integer HTTP status codes that we should force a retry on.
         A retry is initiated if the request method is in ``allowed_methods``
         and the response status code is in ``status_forcelist``.
@@ -195,13 +143,17 @@ class Retry(object):
         (most errors are resolved immediately by a second try without a
         delay). urllib3 will sleep for::
 
-            {backoff factor} * (2 ** ({number of total retries} - 1))
+            {backoff factor} * (2 ** ({number of previous retries}))
 
-        seconds. If the backoff_factor is 0.1, then :func:`.sleep` will sleep
-        for [0.0s, 0.2s, 0.4s, ...] between retries. It will never be longer
-        than :attr:`Retry.DEFAULT_BACKOFF_MAX`.
+        seconds. If `backoff_jitter` is non-zero, this sleep is extended by::
 
-        By default, backoff is disabled (set to 0).
+            random.uniform(0, {backoff jitter})
+
+        seconds. For example, if the backoff_factor is 0.1, then :func:`Retry.sleep` will
+        sleep for [0.0s, 0.2s, 0.4s, 0.8s, ...] between retries. No backoff will ever
+        be longer than `backoff_max`.
+
+        By default, backoff is disabled (factor set to 0).
 
     :param bool raise_on_redirect: Whether, if the number of redirects is
         exhausted, to raise a MaxRetryError, or to return a response with a
@@ -220,7 +172,7 @@ class Retry(object):
         Whether to respect Retry-After header on status codes defined as
         :attr:`Retry.RETRY_AFTER_STATUS_CODES` or not.
 
-    :param iterable remove_headers_on_redirect:
+    :param Collection remove_headers_on_redirect:
         Sequence of headers to remove from the request when a response
         indicating a redirect is returned before firing off the redirected
         request.
@@ -237,48 +189,33 @@ class Retry(object):
     #: Default headers to be used for ``remove_headers_on_redirect``
     DEFAULT_REMOVE_HEADERS_ON_REDIRECT = frozenset(["Authorization"])
 
-    #: Maximum backoff time.
+    #: Default maximum backoff time.
     DEFAULT_BACKOFF_MAX = 120
 
+    # Backward compatibility; assigned outside of the class.
+    DEFAULT: typing.ClassVar[Retry]
+
     def __init__(
         self,
-        total=10,
-        connect=None,
-        read=None,
-        redirect=None,
-        status=None,
-        other=None,
-        allowed_methods=_Default,
-        status_forcelist=None,
-        backoff_factor=0,
-        raise_on_redirect=True,
-        raise_on_status=True,
-        history=None,
-        respect_retry_after_header=True,
-        remove_headers_on_redirect=_Default,
-        # TODO: Deprecated, remove in v2.0
-        method_whitelist=_Default,
-    ):
-
-        if method_whitelist is not _Default:
-            if allowed_methods is not _Default:
-                raise ValueError(
-                    "Using both 'allowed_methods' and "
-                    "'method_whitelist' together is not allowed. "
-                    "Instead only use 'allowed_methods'"
-                )
-            warnings.warn(
-                "Using 'method_whitelist' with Retry is deprecated and "
-                "will be removed in v2.0. Use 'allowed_methods' instead",
-                DeprecationWarning,
-                stacklevel=2,
-            )
-            allowed_methods = method_whitelist
-        if allowed_methods is _Default:
-            allowed_methods = self.DEFAULT_ALLOWED_METHODS
-        if remove_headers_on_redirect is _Default:
-            remove_headers_on_redirect = self.DEFAULT_REMOVE_HEADERS_ON_REDIRECT
-
+        total: bool | int | None = 10,
+        connect: int | None = None,
+        read: int | None = None,
+        redirect: bool | int | None = None,
+        status: int | None = None,
+        other: int | None = None,
+        allowed_methods: typing.Collection[str] | None = DEFAULT_ALLOWED_METHODS,
+        status_forcelist: typing.Collection[int] | None = None,
+        backoff_factor: float = 0,
+        backoff_max: float = DEFAULT_BACKOFF_MAX,
+        raise_on_redirect: bool = True,
+        raise_on_status: bool = True,
+        history: tuple[RequestHistory, ...] | None = None,
+        respect_retry_after_header: bool = True,
+        remove_headers_on_redirect: typing.Collection[
+            str
+        ] = DEFAULT_REMOVE_HEADERS_ON_REDIRECT,
+        backoff_jitter: float = 0.0,
+    ) -> None:
         self.total = total
         self.connect = connect
         self.read = read
@@ -293,15 +230,17 @@ class Retry(object):
         self.status_forcelist = status_forcelist or set()
         self.allowed_methods = allowed_methods
         self.backoff_factor = backoff_factor
+        self.backoff_max = backoff_max
         self.raise_on_redirect = raise_on_redirect
         self.raise_on_status = raise_on_status
-        self.history = history or tuple()
+        self.history = history or ()
         self.respect_retry_after_header = respect_retry_after_header
         self.remove_headers_on_redirect = frozenset(
-            [h.lower() for h in remove_headers_on_redirect]
+            h.lower() for h in remove_headers_on_redirect
         )
+        self.backoff_jitter = backoff_jitter
 
-    def new(self, **kw):
+    def new(self, **kw: typing.Any) -> Retry:
         params = dict(
             total=self.total,
             connect=self.connect,
@@ -309,36 +248,28 @@ class Retry(object):
             redirect=self.redirect,
             status=self.status,
             other=self.other,
+            allowed_methods=self.allowed_methods,
             status_forcelist=self.status_forcelist,
             backoff_factor=self.backoff_factor,
+            backoff_max=self.backoff_max,
             raise_on_redirect=self.raise_on_redirect,
             raise_on_status=self.raise_on_status,
             history=self.history,
             remove_headers_on_redirect=self.remove_headers_on_redirect,
             respect_retry_after_header=self.respect_retry_after_header,
+            backoff_jitter=self.backoff_jitter,
         )
 
-        # TODO: If already given in **kw we use what's given to us
-        # If not given we need to figure out what to pass. We decide
-        # based on whether our class has the 'method_whitelist' property
-        # and if so we pass the deprecated 'method_whitelist' otherwise
-        # we use 'allowed_methods'. Remove in v2.0
-        if "method_whitelist" not in kw and "allowed_methods" not in kw:
-            if "method_whitelist" in self.__dict__:
-                warnings.warn(
-                    "Using 'method_whitelist' with Retry is deprecated and "
-                    "will be removed in v2.0. Use 'allowed_methods' instead",
-                    DeprecationWarning,
-                )
-                params["method_whitelist"] = self.allowed_methods
-            else:
-                params["allowed_methods"] = self.allowed_methods
-
         params.update(kw)
-        return type(self)(**params)
+        return type(self)(**params)  # type: ignore[arg-type]
 
     @classmethod
-    def from_int(cls, retries, redirect=True, default=None):
+    def from_int(
+        cls,
+        retries: Retry | bool | int | None,
+        redirect: bool | int | None = True,
+        default: Retry | bool | int | None = None,
+    ) -> Retry:
         """Backwards-compatibility for the old retries format."""
         if retries is None:
             retries = default if default is not None else cls.DEFAULT
@@ -351,7 +282,7 @@ class Retry(object):
         log.debug("Converted retries value: %r -> %r", retries, new_retries)
         return new_retries
 
-    def get_backoff_time(self):
+    def get_backoff_time(self) -> float:
         """Formula for computing the current backoff
 
         :rtype: float
@@ -366,32 +297,28 @@ class Retry(object):
             return 0
 
         backoff_value = self.backoff_factor * (2 ** (consecutive_errors_len - 1))
-        return min(self.DEFAULT_BACKOFF_MAX, backoff_value)
+        if self.backoff_jitter != 0.0:
+            backoff_value += random.random() * self.backoff_jitter
+        return float(max(0, min(self.backoff_max, backoff_value)))
 
-    def parse_retry_after(self, retry_after):
+    def parse_retry_after(self, retry_after: str) -> float:
+        seconds: float
         # Whitespace: https://tools.ietf.org/html/rfc7230#section-3.2.4
         if re.match(r"^\s*[0-9]+\s*$", retry_after):
             seconds = int(retry_after)
         else:
             retry_date_tuple = email.utils.parsedate_tz(retry_after)
             if retry_date_tuple is None:
-                raise InvalidHeader("Invalid Retry-After header: %s" % retry_after)
-            if retry_date_tuple[9] is None:  # Python 2
-                # Assume UTC if no timezone was specified
-                # On Python2.7, parsedate_tz returns None for a timezone offset
-                # instead of 0 if no timezone is given, where mktime_tz treats
-                # a None timezone offset as local time.
-                retry_date_tuple = retry_date_tuple[:9] + (0,) + retry_date_tuple[10:]
+                raise InvalidHeader(f"Invalid Retry-After header: {retry_after}")
 
             retry_date = email.utils.mktime_tz(retry_date_tuple)
             seconds = retry_date - time.time()
 
-        if seconds < 0:
-            seconds = 0
+        seconds = max(seconds, 0)
 
         return seconds
 
-    def get_retry_after(self, response):
+    def get_retry_after(self, response: BaseHTTPResponse) -> float | None:
         """Get the value of Retry-After in seconds."""
 
         retry_after = response.headers.get("Retry-After")
@@ -401,7 +328,7 @@ class Retry(object):
 
         return self.parse_retry_after(retry_after)
 
-    def sleep_for_retry(self, response=None):
+    def sleep_for_retry(self, response: BaseHTTPResponse) -> bool:
         retry_after = self.get_retry_after(response)
         if retry_after:
             time.sleep(retry_after)
@@ -409,13 +336,13 @@ class Retry(object):
 
         return False
 
-    def _sleep_backoff(self):
+    def _sleep_backoff(self) -> None:
         backoff = self.get_backoff_time()
         if backoff <= 0:
             return
         time.sleep(backoff)
 
-    def sleep(self, response=None):
+    def sleep(self, response: BaseHTTPResponse | None = None) -> None:
         """Sleep between retry attempts.
 
         This method will respect a server's ``Retry-After`` response header
@@ -431,7 +358,7 @@ class Retry(object):
 
         self._sleep_backoff()
 
-    def _is_connection_error(self, err):
+    def _is_connection_error(self, err: Exception) -> bool:
         """Errors when we're fairly sure that the server did not receive the
         request, so it should be safe to retry.
         """
@@ -439,33 +366,23 @@ class Retry(object):
             err = err.original_error
         return isinstance(err, ConnectTimeoutError)
 
-    def _is_read_error(self, err):
+    def _is_read_error(self, err: Exception) -> bool:
         """Errors that occur after the request has been started, so we should
         assume that the server began processing it.
         """
         return isinstance(err, (ReadTimeoutError, ProtocolError))
 
-    def _is_method_retryable(self, method):
+    def _is_method_retryable(self, method: str) -> bool:
         """Checks if a given HTTP method should be retried upon, depending if
         it is included in the allowed_methods
         """
-        # TODO: For now favor if the Retry implementation sets its own method_whitelist
-        # property outside of our constructor to avoid breaking custom implementations.
-        if "method_whitelist" in self.__dict__:
-            warnings.warn(
-                "Using 'method_whitelist' with Retry is deprecated and "
-                "will be removed in v2.0. Use 'allowed_methods' instead",
-                DeprecationWarning,
-            )
-            allowed_methods = self.method_whitelist
-        else:
-            allowed_methods = self.allowed_methods
-
-        if allowed_methods and method.upper() not in allowed_methods:
+        if self.allowed_methods and method.upper() not in self.allowed_methods:
             return False
         return True
 
-    def is_retry(self, method, status_code, has_retry_after=False):
+    def is_retry(
+        self, method: str, status_code: int, has_retry_after: bool = False
+    ) -> bool:
         """Is this method/status code retryable? (Based on allowlists and control
         variables such as the number of total retries to allow, whether to
         respect the Retry-After header, whether this header is present, and
@@ -478,24 +395,27 @@ class Retry(object):
         if self.status_forcelist and status_code in self.status_forcelist:
             return True
 
-        return (
+        return bool(
             self.total
             and self.respect_retry_after_header
             and has_retry_after
             and (status_code in self.RETRY_AFTER_STATUS_CODES)
         )
 
-    def is_exhausted(self):
+    def is_exhausted(self) -> bool:
         """Are we out of retries?"""
-        retry_counts = (
-            self.total,
-            self.connect,
-            self.read,
-            self.redirect,
-            self.status,
-            self.other,
-        )
-        retry_counts = list(filter(None, retry_counts))
+        retry_counts = [
+            x
+            for x in (
+                self.total,
+                self.connect,
+                self.read,
+                self.redirect,
+                self.status,
+                self.other,
+            )
+            if x
+        ]
         if not retry_counts:
             return False
 
@@ -503,18 +423,18 @@ class Retry(object):
 
     def increment(
         self,
-        method=None,
-        url=None,
-        response=None,
-        error=None,
-        _pool=None,
-        _stacktrace=None,
-    ):
+        method: str | None = None,
+        url: str | None = None,
+        response: BaseHTTPResponse | None = None,
+        error: Exception | None = None,
+        _pool: ConnectionPool | None = None,
+        _stacktrace: TracebackType | None = None,
+    ) -> Retry:
         """Return a new Retry object with incremented retry counters.
 
         :param response: A response object, or None, if the server did not
             return a response.
-        :type response: :class:`~urllib3.response.HTTPResponse`
+        :type response: :class:`~urllib3.response.BaseHTTPResponse`
         :param Exception error: An error encountered during the request, or
             None if the response was received successfully.
 
@@ -522,7 +442,7 @@ class Retry(object):
         """
         if self.total is False and error:
             # Disabled, indicate to re-raise the error.
-            raise six.reraise(type(error), error, _stacktrace)
+            raise reraise(type(error), error, _stacktrace)
 
         total = self.total
         if total is not None:
@@ -540,14 +460,14 @@ class Retry(object):
         if error and self._is_connection_error(error):
             # Connect retry?
             if connect is False:
-                raise six.reraise(type(error), error, _stacktrace)
+                raise reraise(type(error), error, _stacktrace)
             elif connect is not None:
                 connect -= 1
 
         elif error and self._is_read_error(error):
             # Read retry?
-            if read is False or not self._is_method_retryable(method):
-                raise six.reraise(type(error), error, _stacktrace)
+            if read is False or method is None or not self._is_method_retryable(method):
+                raise reraise(type(error), error, _stacktrace)
             elif read is not None:
                 read -= 1
 
@@ -561,7 +481,9 @@ class Retry(object):
             if redirect is not None:
                 redirect -= 1
             cause = "too many redirects"
-            redirect_location = response.get_redirect_location()
+            response_redirect_location = response.get_redirect_location()
+            if response_redirect_location:
+                redirect_location = response_redirect_location
             status = response.status
 
         else:
@@ -589,31 +511,18 @@ class Retry(object):
         )
 
         if new_retry.is_exhausted():
-            raise MaxRetryError(_pool, url, error or ResponseError(cause))
+            reason = error or ResponseError(cause)
+            raise MaxRetryError(_pool, url, reason) from reason  # type: ignore[arg-type]
 
         log.debug("Incremented Retry for (url='%s'): %r", url, new_retry)
 
         return new_retry
 
-    def __repr__(self):
+    def __repr__(self) -> str:
         return (
-            "{cls.__name__}(total={self.total}, connect={self.connect}, "
-            "read={self.read}, redirect={self.redirect}, status={self.status})"
-        ).format(cls=type(self), self=self)
-
-    def __getattr__(self, item):
-        if item == "method_whitelist":
-            # TODO: Remove this deprecated alias in v2.0
-            warnings.warn(
-                "Using 'method_whitelist' with Retry is deprecated and "
-                "will be removed in v2.0. Use 'allowed_methods' instead",
-                DeprecationWarning,
-            )
-            return self.allowed_methods
-        try:
-            return getattr(super(Retry, self), item)
-        except AttributeError:
-            return getattr(Retry, item)
+            f"{type(self).__name__}(total={self.total}, connect={self.connect}, "
+            f"read={self.read}, redirect={self.redirect}, status={self.status})"
+        )
 
 
 # For backwards compatibility (equivalent to pre-v1.9):
diff --git a/lib/urllib3/util/ssl_.py b/lib/urllib3/util/ssl_.py
index 8f867812..77628032 100644
--- a/lib/urllib3/util/ssl_.py
+++ b/lib/urllib3/util/ssl_.py
@@ -1,185 +1,152 @@
-from __future__ import absolute_import
+from __future__ import annotations
 
 import hmac
 import os
+import socket
 import sys
+import typing
 import warnings
-from binascii import hexlify, unhexlify
+from binascii import unhexlify
 from hashlib import md5, sha1, sha256
 
-from ..exceptions import (
-    InsecurePlatformWarning,
-    ProxySchemeUnsupported,
-    SNIMissingWarning,
-    SSLError,
-)
-from ..packages import six
-from .url import BRACELESS_IPV6_ADDRZ_RE, IPV4_RE
+from ..exceptions import ProxySchemeUnsupported, SSLError
+from .url import _BRACELESS_IPV6_ADDRZ_RE, _IPV4_RE
 
 SSLContext = None
 SSLTransport = None
-HAS_SNI = False
+HAS_NEVER_CHECK_COMMON_NAME = False
 IS_PYOPENSSL = False
 IS_SECURETRANSPORT = False
 ALPN_PROTOCOLS = ["http/1.1"]
 
+_TYPE_VERSION_INFO = typing.Tuple[int, int, int, str, int]
+
 # Maps the length of a digest to a possible hash function producing this digest
 HASHFUNC_MAP = {32: md5, 40: sha1, 64: sha256}
 
 
-def _const_compare_digest_backport(a, b):
+def _is_bpo_43522_fixed(
+    implementation_name: str,
+    version_info: _TYPE_VERSION_INFO,
+    pypy_version_info: _TYPE_VERSION_INFO | None,
+) -> bool:
+    """Return True for CPython 3.8.9+, 3.9.3+ or 3.10+ and PyPy 7.3.8+ where
+    setting SSLContext.hostname_checks_common_name to False works.
+
+    Outside of CPython and PyPy we don't know which implementations work
+    or not so we conservatively use our hostname matching as we know that works
+    on all implementations.
+
+    https://github.com/urllib3/urllib3/issues/2192#issuecomment-821832963
+    https://foss.heptapod.net/pypy/pypy/-/issues/3539
     """
-    Compare two digests of equal length in constant time.
-
-    The digests must be of type str/bytes.
-    Returns True if the digests match, and False otherwise.
-    """
-    result = abs(len(a) - len(b))
-    for left, right in zip(bytearray(a), bytearray(b)):
-        result |= left ^ right
-    return result == 0
+    if implementation_name == "pypy":
+        # https://foss.heptapod.net/pypy/pypy/-/issues/3129
+        return pypy_version_info >= (7, 3, 8) and version_info >= (3, 8)  # type: ignore[operator]
+    elif implementation_name == "cpython":
+        major_minor = version_info[:2]
+        micro = version_info[2]
+        return (
+            (major_minor == (3, 8) and micro >= 9)
+            or (major_minor == (3, 9) and micro >= 3)
+            or major_minor >= (3, 10)
+        )
+    else:  # Defensive:
+        return False
 
 
-_const_compare_digest = getattr(hmac, "compare_digest", _const_compare_digest_backport)
+def _is_has_never_check_common_name_reliable(
+    openssl_version: str,
+    openssl_version_number: int,
+    implementation_name: str,
+    version_info: _TYPE_VERSION_INFO,
+    pypy_version_info: _TYPE_VERSION_INFO | None,
+) -> bool:
+    # As of May 2023, all released versions of LibreSSL fail to reject certificates with
+    # only common names, see https://github.com/urllib3/urllib3/pull/3024
+    is_openssl = openssl_version.startswith("OpenSSL ")
+    # Before fixing OpenSSL issue #14579, the SSL_new() API was not copying hostflags
+    # like X509_CHECK_FLAG_NEVER_CHECK_SUBJECT, which tripped up CPython.
+    # https://github.com/openssl/openssl/issues/14579
+    # This was released in OpenSSL 1.1.1l+ (>=0x101010cf)
+    is_openssl_issue_14579_fixed = openssl_version_number >= 0x101010CF
 
-try:  # Test for SSL features
+    return is_openssl and (
+        is_openssl_issue_14579_fixed
+        or _is_bpo_43522_fixed(implementation_name, version_info, pypy_version_info)
+    )
+
+
+if typing.TYPE_CHECKING:
+    from ssl import VerifyMode
+
+    from typing_extensions import Literal, TypedDict
+
+    from .ssltransport import SSLTransport as SSLTransportType
+
+    class _TYPE_PEER_CERT_RET_DICT(TypedDict, total=False):
+        subjectAltName: tuple[tuple[str, str], ...]
+        subject: tuple[tuple[tuple[str, str], ...], ...]
+        serialNumber: str
+
+
+# Mapping from 'ssl.PROTOCOL_TLSX' to 'TLSVersion.X'
+_SSL_VERSION_TO_TLS_VERSION: dict[int, int] = {}
+
+try:  # Do we have ssl at all?
     import ssl
-    from ssl import CERT_REQUIRED, wrap_socket
-except ImportError:
-    pass
-
-try:
-    from ssl import HAS_SNI  # Has SNI?
-except ImportError:
-    pass
-
-try:
-    from .ssltransport import SSLTransport
-except ImportError:
-    pass
-
-
-try:  # Platform-specific: Python 3.6
-    from ssl import PROTOCOL_TLS
+    from ssl import (  # type: ignore[assignment]
+        CERT_REQUIRED,
+        HAS_NEVER_CHECK_COMMON_NAME,
+        OP_NO_COMPRESSION,
+        OP_NO_TICKET,
+        OPENSSL_VERSION,
+        OPENSSL_VERSION_NUMBER,
+        PROTOCOL_TLS,
+        PROTOCOL_TLS_CLIENT,
+        OP_NO_SSLv2,
+        OP_NO_SSLv3,
+        SSLContext,
+        TLSVersion,
+    )
 
     PROTOCOL_SSLv23 = PROTOCOL_TLS
-except ImportError:
-    try:
-        from ssl import PROTOCOL_SSLv23 as PROTOCOL_TLS
 
-        PROTOCOL_SSLv23 = PROTOCOL_TLS
-    except ImportError:
-        PROTOCOL_SSLv23 = PROTOCOL_TLS = 2
+    # Setting SSLContext.hostname_checks_common_name = False didn't work before CPython
+    # 3.8.9, 3.9.3, and 3.10 (but OK on PyPy) or OpenSSL 1.1.1l+
+    if HAS_NEVER_CHECK_COMMON_NAME and not _is_has_never_check_common_name_reliable(
+        OPENSSL_VERSION,
+        OPENSSL_VERSION_NUMBER,
+        sys.implementation.name,
+        sys.version_info,
+        sys.pypy_version_info if sys.implementation.name == "pypy" else None,  # type: ignore[attr-defined]
+    ):
+        HAS_NEVER_CHECK_COMMON_NAME = False
 
-try:
-    from ssl import PROTOCOL_TLS_CLIENT
-except ImportError:
-    PROTOCOL_TLS_CLIENT = PROTOCOL_TLS
-
-
-try:
-    from ssl import OP_NO_COMPRESSION, OP_NO_SSLv2, OP_NO_SSLv3
-except ImportError:
-    OP_NO_SSLv2, OP_NO_SSLv3 = 0x1000000, 0x2000000
-    OP_NO_COMPRESSION = 0x20000
-
-
-try:  # OP_NO_TICKET was added in Python 3.6
-    from ssl import OP_NO_TICKET
-except ImportError:
-    OP_NO_TICKET = 0x4000
-
-
-# A secure default.
-# Sources for more information on TLS ciphers:
-#
-# - https://wiki.mozilla.org/Security/Server_Side_TLS
-# - https://www.ssllabs.com/projects/best-practices/index.html
-# - https://hynek.me/articles/hardening-your-web-servers-ssl-ciphers/
-#
-# The general intent is:
-# - prefer cipher suites that offer perfect forward secrecy (DHE/ECDHE),
-# - prefer ECDHE over DHE for better performance,
-# - prefer any AES-GCM and ChaCha20 over any AES-CBC for better performance and
-#   security,
-# - prefer AES-GCM over ChaCha20 because hardware-accelerated AES is common,
-# - disable NULL authentication, MD5 MACs, DSS, and other
-#   insecure ciphers for security reasons.
-# - NOTE: TLS 1.3 cipher suites are managed through a different interface
-#   not exposed by CPython (yet!) and are enabled by default if they're available.
-DEFAULT_CIPHERS = ":".join(
-    [
-        "ECDHE+AESGCM",
-        "ECDHE+CHACHA20",
-        "DHE+AESGCM",
-        "DHE+CHACHA20",
-        "ECDH+AESGCM",
-        "DH+AESGCM",
-        "ECDH+AES",
-        "DH+AES",
-        "RSA+AESGCM",
-        "RSA+AES",
-        "!aNULL",
-        "!eNULL",
-        "!MD5",
-        "!DSS",
-    ]
-)
-
-try:
-    from ssl import SSLContext  # Modern SSL?
-except ImportError:
-
-    class SSLContext(object):  # Platform-specific: Python 2
-        def __init__(self, protocol_version):
-            self.protocol = protocol_version
-            # Use default values from a real SSLContext
-            self.check_hostname = False
-            self.verify_mode = ssl.CERT_NONE
-            self.ca_certs = None
-            self.options = 0
-            self.certfile = None
-            self.keyfile = None
-            self.ciphers = None
-
-        def load_cert_chain(self, certfile, keyfile):
-            self.certfile = certfile
-            self.keyfile = keyfile
-
-        def load_verify_locations(self, cafile=None, capath=None, cadata=None):
-            self.ca_certs = cafile
-
-            if capath is not None:
-                raise SSLError("CA directories not supported in older Pythons")
-
-            if cadata is not None:
-                raise SSLError("CA data not supported in older Pythons")
-
-        def set_ciphers(self, cipher_suite):
-            self.ciphers = cipher_suite
-
-        def wrap_socket(self, socket, server_hostname=None, server_side=False):
-            warnings.warn(
-                "A true SSLContext object is not available. This prevents "
-                "urllib3 from configuring SSL appropriately and may cause "
-                "certain SSL connections to fail. You can upgrade to a newer "
-                "version of Python to solve this. For more information, see "
-                "https://urllib3.readthedocs.io/en/1.26.x/advanced-usage.html"
-                "#ssl-warnings",
-                InsecurePlatformWarning,
+    # Need to be careful here in case old TLS versions get
+    # removed in future 'ssl' module implementations.
+    for attr in ("TLSv1", "TLSv1_1", "TLSv1_2"):
+        try:
+            _SSL_VERSION_TO_TLS_VERSION[getattr(ssl, f"PROTOCOL_{attr}")] = getattr(
+                TLSVersion, attr
             )
-            kwargs = {
-                "keyfile": self.keyfile,
-                "certfile": self.certfile,
-                "ca_certs": self.ca_certs,
-                "cert_reqs": self.verify_mode,
-                "ssl_version": self.protocol,
-                "server_side": server_side,
-            }
-            return wrap_socket(socket, ciphers=self.ciphers, **kwargs)
+        except AttributeError:  # Defensive:
+            continue
+
+    from .ssltransport import SSLTransport  # type: ignore[assignment]
+except ImportError:
+    OP_NO_COMPRESSION = 0x20000  # type: ignore[assignment]
+    OP_NO_TICKET = 0x4000  # type: ignore[assignment]
+    OP_NO_SSLv2 = 0x1000000  # type: ignore[assignment]
+    OP_NO_SSLv3 = 0x2000000  # type: ignore[assignment]
+    PROTOCOL_SSLv23 = PROTOCOL_TLS = 2  # type: ignore[assignment]
+    PROTOCOL_TLS_CLIENT = 16  # type: ignore[assignment]
 
 
-def assert_fingerprint(cert, fingerprint):
+_TYPE_PEER_CERT_RET = typing.Union["_TYPE_PEER_CERT_RET_DICT", bytes, None]
+
+
+def assert_fingerprint(cert: bytes | None, fingerprint: str) -> None:
     """
     Checks if given fingerprint matches the supplied certificate.
 
@@ -189,26 +156,27 @@ def assert_fingerprint(cert, fingerprint):
         Fingerprint as string of hexdigits, can be interspersed by colons.
     """
 
+    if cert is None:
+        raise SSLError("No certificate for the peer.")
+
     fingerprint = fingerprint.replace(":", "").lower()
     digest_length = len(fingerprint)
     hashfunc = HASHFUNC_MAP.get(digest_length)
     if not hashfunc:
-        raise SSLError("Fingerprint of invalid length: {0}".format(fingerprint))
+        raise SSLError(f"Fingerprint of invalid length: {fingerprint}")
 
     # We need encode() here for py32; works on py2 and p33.
     fingerprint_bytes = unhexlify(fingerprint.encode())
 
     cert_digest = hashfunc(cert).digest()
 
-    if not _const_compare_digest(cert_digest, fingerprint_bytes):
+    if not hmac.compare_digest(cert_digest, fingerprint_bytes):
         raise SSLError(
-            'Fingerprints did not match. Expected "{0}", got "{1}".'.format(
-                fingerprint, hexlify(cert_digest)
-            )
+            f'Fingerprints did not match. Expected "{fingerprint}", got "{cert_digest.hex()}"'
         )
 
 
-def resolve_cert_reqs(candidate):
+def resolve_cert_reqs(candidate: None | int | str) -> VerifyMode:
     """
     Resolves the argument to a numeric constant, which can be passed to
     the wrap_socket function/method from the ssl module.
@@ -226,12 +194,12 @@ def resolve_cert_reqs(candidate):
         res = getattr(ssl, candidate, None)
         if res is None:
             res = getattr(ssl, "CERT_" + candidate)
-        return res
+        return res  # type: ignore[no-any-return]
 
-    return candidate
+    return candidate  # type: ignore[return-value]
 
 
-def resolve_ssl_version(candidate):
+def resolve_ssl_version(candidate: None | int | str) -> int:
     """
     like resolve_cert_reqs
     """
@@ -242,35 +210,33 @@ def resolve_ssl_version(candidate):
         res = getattr(ssl, candidate, None)
         if res is None:
             res = getattr(ssl, "PROTOCOL_" + candidate)
-        return res
+        return typing.cast(int, res)
 
     return candidate
 
 
 def create_urllib3_context(
-    ssl_version=None, cert_reqs=None, options=None, ciphers=None
-):
-    """All arguments have the same meaning as ``ssl_wrap_socket``.
-
-    By default, this function does a lot of the same work that
-    ``ssl.create_default_context`` does on Python 3.4+. It:
-
-    - Disables SSLv2, SSLv3, and compression
-    - Sets a restricted set of server ciphers
-
-    If you wish to enable SSLv3, you can do::
-
-        from urllib3.util import ssl_
-        context = ssl_.create_urllib3_context()
-        context.options &= ~ssl_.OP_NO_SSLv3
-
-    You can do the same to enable compression (substituting ``COMPRESSION``
-    for ``SSLv3`` in the last line above).
+    ssl_version: int | None = None,
+    cert_reqs: int | None = None,
+    options: int | None = None,
+    ciphers: str | None = None,
+    ssl_minimum_version: int | None = None,
+    ssl_maximum_version: int | None = None,
+) -> ssl.SSLContext:
+    """Creates and configures an :class:`ssl.SSLContext` instance for use with urllib3.
 
     :param ssl_version:
         The desired protocol version to use. This will default to
         PROTOCOL_SSLv23 which will negotiate the highest protocol that both
         the server and your installation of OpenSSL support.
+
+        This parameter is deprecated instead use 'ssl_minimum_version'.
+    :param ssl_minimum_version:
+        The minimum version of TLS to be used. Use the 'ssl.TLSVersion' enum for specifying the value.
+    :param ssl_maximum_version:
+        The maximum version of TLS to be used. Use the 'ssl.TLSVersion' enum for specifying the value.
+        Not recommended to set to anything other than 'ssl.TLSVersion.MAXIMUM_SUPPORTED' which is the
+        default value.
     :param cert_reqs:
         Whether to require the certificate verification. This defaults to
         ``ssl.CERT_REQUIRED``.
@@ -278,18 +244,60 @@ def create_urllib3_context(
         Specific OpenSSL options. These default to ``ssl.OP_NO_SSLv2``,
         ``ssl.OP_NO_SSLv3``, ``ssl.OP_NO_COMPRESSION``, and ``ssl.OP_NO_TICKET``.
     :param ciphers:
-        Which cipher suites to allow the server to select.
+        Which cipher suites to allow the server to select. Defaults to either system configured
+        ciphers if OpenSSL 1.1.1+, otherwise uses a secure default set of ciphers.
     :returns:
         Constructed SSLContext object with specified options
     :rtype: SSLContext
     """
-    # PROTOCOL_TLS is deprecated in Python 3.10
-    if not ssl_version or ssl_version == PROTOCOL_TLS:
-        ssl_version = PROTOCOL_TLS_CLIENT
+    if SSLContext is None:
+        raise TypeError("Can't create an SSLContext object without an ssl module")
 
-    context = SSLContext(ssl_version)
+    # This means 'ssl_version' was specified as an exact value.
+    if ssl_version not in (None, PROTOCOL_TLS, PROTOCOL_TLS_CLIENT):
+        # Disallow setting 'ssl_version' and 'ssl_minimum|maximum_version'
+        # to avoid conflicts.
+        if ssl_minimum_version is not None or ssl_maximum_version is not None:
+            raise ValueError(
+                "Can't specify both 'ssl_version' and either "
+                "'ssl_minimum_version' or 'ssl_maximum_version'"
+            )
 
-    context.set_ciphers(ciphers or DEFAULT_CIPHERS)
+        # 'ssl_version' is deprecated and will be removed in the future.
+        else:
+            # Use 'ssl_minimum_version' and 'ssl_maximum_version' instead.
+            ssl_minimum_version = _SSL_VERSION_TO_TLS_VERSION.get(
+                ssl_version, TLSVersion.MINIMUM_SUPPORTED
+            )
+            ssl_maximum_version = _SSL_VERSION_TO_TLS_VERSION.get(
+                ssl_version, TLSVersion.MAXIMUM_SUPPORTED
+            )
+
+            # This warning message is pushing users to use 'ssl_minimum_version'
+            # instead of both min/max. Best practice is to only set the minimum version and
+            # keep the maximum version to be it's default value: 'TLSVersion.MAXIMUM_SUPPORTED'
+            warnings.warn(
+                "'ssl_version' option is deprecated and will be "
+                "removed in urllib3 v2.1.0. Instead use 'ssl_minimum_version'",
+                category=DeprecationWarning,
+                stacklevel=2,
+            )
+
+    # PROTOCOL_TLS is deprecated in Python 3.10 so we always use PROTOCOL_TLS_CLIENT
+    context = SSLContext(PROTOCOL_TLS_CLIENT)
+
+    if ssl_minimum_version is not None:
+        context.minimum_version = ssl_minimum_version
+    else:  # Python <3.10 defaults to 'MINIMUM_SUPPORTED' so explicitly set TLSv1.2 here
+        context.minimum_version = TLSVersion.TLSv1_2
+
+    if ssl_maximum_version is not None:
+        context.maximum_version = ssl_maximum_version
+
+    # Unless we're given ciphers defer to either system ciphers in
+    # the case of OpenSSL 1.1.1+ or use our own secure default ciphers.
+    if ciphers:
+        context.set_ciphers(ciphers)
 
     # Setting the default here, as we may have no ssl module on import
     cert_reqs = ssl.CERT_REQUIRED if cert_reqs is None else cert_reqs
@@ -322,26 +330,23 @@ def create_urllib3_context(
     ) is not None:
         context.post_handshake_auth = True
 
-    def disable_check_hostname():
-        if (
-            getattr(context, "check_hostname", None) is not None
-        ):  # Platform-specific: Python 3.2
-            # We do our own verification, including fingerprints and alternative
-            # hostnames. So disable it here
-            context.check_hostname = False
-
     # The order of the below lines setting verify_mode and check_hostname
     # matter due to safe-guards SSLContext has to prevent an SSLContext with
-    # check_hostname=True, verify_mode=NONE/OPTIONAL. This is made even more
-    # complex because we don't know whether PROTOCOL_TLS_CLIENT will be used
-    # or not so we don't know the initial state of the freshly created SSLContext.
-    if cert_reqs == ssl.CERT_REQUIRED:
+    # check_hostname=True, verify_mode=NONE/OPTIONAL.
+    # We always set 'check_hostname=False' for pyOpenSSL so we rely on our own
+    # 'ssl.match_hostname()' implementation.
+    if cert_reqs == ssl.CERT_REQUIRED and not IS_PYOPENSSL:
         context.verify_mode = cert_reqs
-        disable_check_hostname()
+        context.check_hostname = True
     else:
-        disable_check_hostname()
+        context.check_hostname = False
         context.verify_mode = cert_reqs
 
+    try:
+        context.hostname_checks_common_name = False
+    except AttributeError:  # Defensive: for CPython < 3.8.9 and 3.9.3; for PyPy < 7.3.8
+        pass
+
     # Enable logging of TLS session keys via defacto standard environment variable
     # 'SSLKEYLOGFILE', if the feature is available (Python 3.8+). Skip empty values.
     if hasattr(context, "keylog_filename"):
@@ -352,21 +357,59 @@ def create_urllib3_context(
     return context
 
 
+@typing.overload
 def ssl_wrap_socket(
-    sock,
-    keyfile=None,
-    certfile=None,
-    cert_reqs=None,
-    ca_certs=None,
-    server_hostname=None,
-    ssl_version=None,
-    ciphers=None,
-    ssl_context=None,
-    ca_cert_dir=None,
-    key_password=None,
-    ca_cert_data=None,
-    tls_in_tls=False,
-):
+    sock: socket.socket,
+    keyfile: str | None = ...,
+    certfile: str | None = ...,
+    cert_reqs: int | None = ...,
+    ca_certs: str | None = ...,
+    server_hostname: str | None = ...,
+    ssl_version: int | None = ...,
+    ciphers: str | None = ...,
+    ssl_context: ssl.SSLContext | None = ...,
+    ca_cert_dir: str | None = ...,
+    key_password: str | None = ...,
+    ca_cert_data: None | str | bytes = ...,
+    tls_in_tls: Literal[False] = ...,
+) -> ssl.SSLSocket:
+    ...
+
+
+@typing.overload
+def ssl_wrap_socket(
+    sock: socket.socket,
+    keyfile: str | None = ...,
+    certfile: str | None = ...,
+    cert_reqs: int | None = ...,
+    ca_certs: str | None = ...,
+    server_hostname: str | None = ...,
+    ssl_version: int | None = ...,
+    ciphers: str | None = ...,
+    ssl_context: ssl.SSLContext | None = ...,
+    ca_cert_dir: str | None = ...,
+    key_password: str | None = ...,
+    ca_cert_data: None | str | bytes = ...,
+    tls_in_tls: bool = ...,
+) -> ssl.SSLSocket | SSLTransportType:
+    ...
+
+
+def ssl_wrap_socket(
+    sock: socket.socket,
+    keyfile: str | None = None,
+    certfile: str | None = None,
+    cert_reqs: int | None = None,
+    ca_certs: str | None = None,
+    server_hostname: str | None = None,
+    ssl_version: int | None = None,
+    ciphers: str | None = None,
+    ssl_context: ssl.SSLContext | None = None,
+    ca_cert_dir: str | None = None,
+    key_password: str | None = None,
+    ca_cert_data: None | str | bytes = None,
+    tls_in_tls: bool = False,
+) -> ssl.SSLSocket | SSLTransportType:
     """
     All arguments except for server_hostname, ssl_context, and ca_cert_dir have
     the same meaning as they do when using :func:`ssl.wrap_socket`.
@@ -392,19 +435,18 @@ def ssl_wrap_socket(
     """
     context = ssl_context
     if context is None:
-        # Note: This branch of code and all the variables in it are no longer
-        # used by urllib3 itself. We should consider deprecating and removing
-        # this code.
+        # Note: This branch of code and all the variables in it are only used in tests.
+        # We should consider deprecating and removing this code.
         context = create_urllib3_context(ssl_version, cert_reqs, ciphers=ciphers)
 
     if ca_certs or ca_cert_dir or ca_cert_data:
         try:
             context.load_verify_locations(ca_certs, ca_cert_dir, ca_cert_data)
-        except (IOError, OSError) as e:
-            raise SSLError(e)
+        except OSError as e:
+            raise SSLError(e) from e
 
     elif ssl_context is None and hasattr(context, "load_default_certs"):
-        # try to load OS default certs; works well on Windows (require Python3.4+)
+        # try to load OS default certs; works well on Windows.
         context.load_default_certs()
 
     # Attempt to detect if we get the goofy behavior of the
@@ -420,56 +462,30 @@ def ssl_wrap_socket(
             context.load_cert_chain(certfile, keyfile, key_password)
 
     try:
-        if hasattr(context, "set_alpn_protocols"):
-            context.set_alpn_protocols(ALPN_PROTOCOLS)
+        context.set_alpn_protocols(ALPN_PROTOCOLS)
     except NotImplementedError:  # Defensive: in CI, we always have set_alpn_protocols
         pass
 
-    # If we detect server_hostname is an IP address then the SNI
-    # extension should not be used according to RFC3546 Section 3.1
-    use_sni_hostname = server_hostname and not is_ipaddress(server_hostname)
-    # SecureTransport uses server_hostname in certificate verification.
-    send_sni = (use_sni_hostname and HAS_SNI) or (
-        IS_SECURETRANSPORT and server_hostname
-    )
-    # Do not warn the user if server_hostname is an invalid SNI hostname.
-    if not HAS_SNI and use_sni_hostname:
-        warnings.warn(
-            "An HTTPS request has been made, but the SNI (Server Name "
-            "Indication) extension to TLS is not available on this platform. "
-            "This may cause the server to present an incorrect TLS "
-            "certificate, which can cause validation failures. You can upgrade to "
-            "a newer version of Python to solve this. For more information, see "
-            "https://urllib3.readthedocs.io/en/1.26.x/advanced-usage.html"
-            "#ssl-warnings",
-            SNIMissingWarning,
-        )
-
-    if send_sni:
-        ssl_sock = _ssl_wrap_socket_impl(
-            sock, context, tls_in_tls, server_hostname=server_hostname
-        )
-    else:
-        ssl_sock = _ssl_wrap_socket_impl(sock, context, tls_in_tls)
+    ssl_sock = _ssl_wrap_socket_impl(sock, context, tls_in_tls, server_hostname)
     return ssl_sock
 
 
-def is_ipaddress(hostname):
+def is_ipaddress(hostname: str | bytes) -> bool:
     """Detects whether the hostname given is an IPv4 or IPv6 address.
     Also detects IPv6 addresses with Zone IDs.
 
     :param str hostname: Hostname to examine.
     :return: True if the hostname is an IP address, False otherwise.
     """
-    if not six.PY2 and isinstance(hostname, bytes):
+    if isinstance(hostname, bytes):
         # IDN A-label bytes are ASCII compatible.
         hostname = hostname.decode("ascii")
-    return bool(IPV4_RE.match(hostname) or BRACELESS_IPV6_ADDRZ_RE.match(hostname))
+    return bool(_IPV4_RE.match(hostname) or _BRACELESS_IPV6_ADDRZ_RE.match(hostname))
 
 
-def _is_key_file_encrypted(key_file):
+def _is_key_file_encrypted(key_file: str) -> bool:
     """Detects if a key file is encrypted or not."""
-    with open(key_file, "r") as f:
+    with open(key_file) as f:
         for line in f:
             # Look for Proc-Type: 4,ENCRYPTED
             if "ENCRYPTED" in line:
@@ -478,7 +494,12 @@ def _is_key_file_encrypted(key_file):
     return False
 
 
-def _ssl_wrap_socket_impl(sock, ssl_context, tls_in_tls, server_hostname=None):
+def _ssl_wrap_socket_impl(
+    sock: socket.socket,
+    ssl_context: ssl.SSLContext,
+    tls_in_tls: bool,
+    server_hostname: str | None = None,
+) -> ssl.SSLSocket | SSLTransportType:
     if tls_in_tls:
         if not SSLTransport:
             # Import error, ssl is not available.
@@ -489,7 +510,4 @@ def _ssl_wrap_socket_impl(sock, ssl_context, tls_in_tls, server_hostname=None):
         SSLTransport._validate_ssl_context_for_tls_in_tls(ssl_context)
         return SSLTransport(sock, ssl_context, server_hostname)
 
-    if server_hostname:
-        return ssl_context.wrap_socket(sock, server_hostname=server_hostname)
-    else:
-        return ssl_context.wrap_socket(sock)
+    return ssl_context.wrap_socket(sock, server_hostname=server_hostname)
diff --git a/lib/urllib3/util/ssl_match_hostname.py b/lib/urllib3/util/ssl_match_hostname.py
index 1dd950c4..453cfd42 100644
--- a/lib/urllib3/util/ssl_match_hostname.py
+++ b/lib/urllib3/util/ssl_match_hostname.py
@@ -1,19 +1,18 @@
-"""The match_hostname() function from Python 3.3.3, essential when using SSL."""
+"""The match_hostname() function from Python 3.5, essential when using SSL."""
 
 # Note: This file is under the PSF license as the code comes from the python
 # stdlib.   http://docs.python.org/3/license.html
+# It is modified to remove commonName support.
 
+from __future__ import annotations
+
+import ipaddress
 import re
-import sys
+import typing
+from ipaddress import IPv4Address, IPv6Address
 
-# ipaddress has been backported to 2.6+ in pypi.  If it is installed on the
-# system, use it to handle IPAddress ServerAltnames (this was added in
-# python-3.5) otherwise only do DNS matching.  This allows
-# util.ssl_match_hostname to continue to be used in Python 2.7.
-try:
-    import ipaddress
-except ImportError:
-    ipaddress = None
+if typing.TYPE_CHECKING:
+    from .ssl_ import _TYPE_PEER_CERT_RET_DICT
 
 __version__ = "3.5.0.1"
 
@@ -22,7 +21,9 @@ class CertificateError(ValueError):
     pass
 
 
-def _dnsname_match(dn, hostname, max_wildcards=1):
+def _dnsname_match(
+    dn: typing.Any, hostname: str, max_wildcards: int = 1
+) -> typing.Match[str] | None | bool:
     """Matching according to RFC 6125, section 6.4.3
 
     http://tools.ietf.org/html/rfc6125#section-6.4.3
@@ -49,7 +50,7 @@ def _dnsname_match(dn, hostname, max_wildcards=1):
 
     # speed up common case w/o wildcards
     if not wildcards:
-        return dn.lower() == hostname.lower()
+        return bool(dn.lower() == hostname.lower())
 
     # RFC 6125, section 6.4.3, subitem 1.
     # The client SHOULD NOT attempt to match a presented identifier in which
@@ -76,26 +77,26 @@ def _dnsname_match(dn, hostname, max_wildcards=1):
     return pat.match(hostname)
 
 
-def _to_unicode(obj):
-    if isinstance(obj, str) and sys.version_info < (3,):
-        # ignored flake8 # F821 to support python 2.7 function
-        obj = unicode(obj, encoding="ascii", errors="strict")  # noqa: F821
-    return obj
-
-
-def _ipaddress_match(ipname, host_ip):
+def _ipaddress_match(ipname: str, host_ip: IPv4Address | IPv6Address) -> bool:
     """Exact matching of IP addresses.
 
-    RFC 6125 explicitly doesn't define an algorithm for this
-    (section 1.7.2 - "Out of Scope").
+    RFC 9110 section 4.3.5: "A reference identity of IP-ID contains the decoded
+    bytes of the IP address. An IP version 4 address is 4 octets, and an IP
+    version 6 address is 16 octets. [...] A reference identity of type IP-ID
+    matches if the address is identical to an iPAddress value of the
+    subjectAltName extension of the certificate."
     """
     # OpenSSL may add a trailing newline to a subjectAltName's IP address
     # Divergence from upstream: ipaddress can't handle byte str
-    ip = ipaddress.ip_address(_to_unicode(ipname).rstrip())
-    return ip == host_ip
+    ip = ipaddress.ip_address(ipname.rstrip())
+    return bool(ip.packed == host_ip.packed)
 
 
-def match_hostname(cert, hostname):
+def match_hostname(
+    cert: _TYPE_PEER_CERT_RET_DICT | None,
+    hostname: str,
+    hostname_checks_common_name: bool = False,
+) -> None:
     """Verify that *cert* (in decoded format as returned by
     SSLSocket.getpeercert()) matches the *hostname*.  RFC 2818 and RFC 6125
     rules are followed, but IP addresses are not accepted for *hostname*.
@@ -111,21 +112,22 @@ def match_hostname(cert, hostname):
         )
     try:
         # Divergence from upstream: ipaddress can't handle byte str
-        host_ip = ipaddress.ip_address(_to_unicode(hostname))
-    except (UnicodeError, ValueError):
-        # ValueError: Not an IP address (common case)
-        # UnicodeError: Divergence from upstream: Have to deal with ipaddress not taking
-        # byte strings.  addresses should be all ascii, so we consider it not
-        # an ipaddress in this case
+        #
+        # The ipaddress module shipped with Python < 3.9 does not support
+        # scoped IPv6 addresses so we unconditionally strip the Zone IDs for
+        # now. Once we drop support for Python 3.9 we can remove this branch.
+        if "%" in hostname:
+            host_ip = ipaddress.ip_address(hostname[: hostname.rfind("%")])
+        else:
+            host_ip = ipaddress.ip_address(hostname)
+
+    except ValueError:
+        # Not an IP address (common case)
         host_ip = None
-    except AttributeError:
-        # Divergence from upstream: Make ipaddress library optional
-        if ipaddress is None:
-            host_ip = None
-        else:  # Defensive
-            raise
     dnsnames = []
-    san = cert.get("subjectAltName", ())
+    san: tuple[tuple[str, str], ...] = cert.get("subjectAltName", ())
+    key: str
+    value: str
     for key, value in san:
         if key == "DNS":
             if host_ip is None and _dnsname_match(value, hostname):
@@ -135,25 +137,23 @@ def match_hostname(cert, hostname):
             if host_ip is not None and _ipaddress_match(value, host_ip):
                 return
             dnsnames.append(value)
-    if not dnsnames:
-        # The subject is only checked when there is no dNSName entry
-        # in subjectAltName
+
+    # We only check 'commonName' if it's enabled and we're not verifying
+    # an IP address. IP addresses aren't valid within 'commonName'.
+    if hostname_checks_common_name and host_ip is None and not dnsnames:
         for sub in cert.get("subject", ()):
             for key, value in sub:
-                # XXX according to RFC 2818, the most specific Common Name
-                # must be used.
                 if key == "commonName":
                     if _dnsname_match(value, hostname):
                         return
                     dnsnames.append(value)
+
     if len(dnsnames) > 1:
         raise CertificateError(
             "hostname %r "
             "doesn't match either of %s" % (hostname, ", ".join(map(repr, dnsnames)))
         )
     elif len(dnsnames) == 1:
-        raise CertificateError("hostname %r doesn't match %r" % (hostname, dnsnames[0]))
+        raise CertificateError(f"hostname {hostname!r} doesn't match {dnsnames[0]!r}")
     else:
-        raise CertificateError(
-            "no appropriate commonName or subjectAltName fields were found"
-        )
+        raise CertificateError("no appropriate subjectAltName fields were found")
diff --git a/lib/urllib3/util/ssltransport.py b/lib/urllib3/util/ssltransport.py
index 4a7105d1..5ec86473 100644
--- a/lib/urllib3/util/ssltransport.py
+++ b/lib/urllib3/util/ssltransport.py
@@ -1,9 +1,21 @@
+from __future__ import annotations
+
 import io
 import socket
 import ssl
+import typing
 
 from ..exceptions import ProxySchemeUnsupported
-from ..packages import six
+
+if typing.TYPE_CHECKING:
+    from typing_extensions import Literal
+
+    from .ssl_ import _TYPE_PEER_CERT_RET, _TYPE_PEER_CERT_RET_DICT
+
+
+_SelfT = typing.TypeVar("_SelfT", bound="SSLTransport")
+_WriteBuffer = typing.Union[bytearray, memoryview]
+_ReturnValue = typing.TypeVar("_ReturnValue")
 
 SSL_BLOCKSIZE = 16384
 
@@ -20,7 +32,7 @@ class SSLTransport:
     """
 
     @staticmethod
-    def _validate_ssl_context_for_tls_in_tls(ssl_context):
+    def _validate_ssl_context_for_tls_in_tls(ssl_context: ssl.SSLContext) -> None:
         """
         Raises a ProxySchemeUnsupported if the provided ssl_context can't be used
         for TLS in TLS.
@@ -30,20 +42,18 @@ class SSLTransport:
         """
 
         if not hasattr(ssl_context, "wrap_bio"):
-            if six.PY2:
-                raise ProxySchemeUnsupported(
-                    "TLS in TLS requires SSLContext.wrap_bio() which isn't "
-                    "supported on Python 2"
-                )
-            else:
-                raise ProxySchemeUnsupported(
-                    "TLS in TLS requires SSLContext.wrap_bio() which isn't "
-                    "available on non-native SSLContext"
-                )
+            raise ProxySchemeUnsupported(
+                "TLS in TLS requires SSLContext.wrap_bio() which isn't "
+                "available on non-native SSLContext"
+            )
 
     def __init__(
-        self, socket, ssl_context, server_hostname=None, suppress_ragged_eofs=True
-    ):
+        self,
+        socket: socket.socket,
+        ssl_context: ssl.SSLContext,
+        server_hostname: str | None = None,
+        suppress_ragged_eofs: bool = True,
+    ) -> None:
         """
         Create an SSLTransport around socket using the provided ssl_context.
         """
@@ -60,33 +70,36 @@ class SSLTransport:
         # Perform initial handshake.
         self._ssl_io_loop(self.sslobj.do_handshake)
 
-    def __enter__(self):
+    def __enter__(self: _SelfT) -> _SelfT:
         return self
 
-    def __exit__(self, *_):
+    def __exit__(self, *_: typing.Any) -> None:
         self.close()
 
-    def fileno(self):
+    def fileno(self) -> int:
         return self.socket.fileno()
 
-    def read(self, len=1024, buffer=None):
+    def read(self, len: int = 1024, buffer: typing.Any | None = None) -> int | bytes:
         return self._wrap_ssl_read(len, buffer)
 
-    def recv(self, len=1024, flags=0):
+    def recv(self, buflen: int = 1024, flags: int = 0) -> int | bytes:
         if flags != 0:
             raise ValueError("non-zero flags not allowed in calls to recv")
-        return self._wrap_ssl_read(len)
+        return self._wrap_ssl_read(buflen)
 
-    def recv_into(self, buffer, nbytes=None, flags=0):
+    def recv_into(
+        self,
+        buffer: _WriteBuffer,
+        nbytes: int | None = None,
+        flags: int = 0,
+    ) -> None | int | bytes:
         if flags != 0:
             raise ValueError("non-zero flags not allowed in calls to recv_into")
-        if buffer and (nbytes is None):
+        if nbytes is None:
             nbytes = len(buffer)
-        elif nbytes is None:
-            nbytes = 1024
         return self.read(nbytes, buffer)
 
-    def sendall(self, data, flags=0):
+    def sendall(self, data: bytes, flags: int = 0) -> None:
         if flags != 0:
             raise ValueError("non-zero flags not allowed in calls to sendall")
         count = 0
@@ -96,15 +109,20 @@ class SSLTransport:
                 v = self.send(byte_view[count:])
                 count += v
 
-    def send(self, data, flags=0):
+    def send(self, data: bytes, flags: int = 0) -> int:
         if flags != 0:
             raise ValueError("non-zero flags not allowed in calls to send")
-        response = self._ssl_io_loop(self.sslobj.write, data)
-        return response
+        return self._ssl_io_loop(self.sslobj.write, data)
 
     def makefile(
-        self, mode="r", buffering=None, encoding=None, errors=None, newline=None
-    ):
+        self,
+        mode: str,
+        buffering: int | None = None,
+        *,
+        encoding: str | None = None,
+        errors: str | None = None,
+        newline: str | None = None,
+    ) -> typing.BinaryIO | typing.TextIO | socket.SocketIO:
         """
         Python's httpclient uses makefile and buffered io when reading HTTP
         messages and we need to support it.
@@ -113,7 +131,7 @@ class SSLTransport:
         changes to point to the socket directly.
         """
         if not set(mode) <= {"r", "w", "b"}:
-            raise ValueError("invalid mode %r (only r, w, b allowed)" % (mode,))
+            raise ValueError(f"invalid mode {mode!r} (only r, w, b allowed)")
 
         writing = "w" in mode
         reading = "r" in mode or not writing
@@ -124,8 +142,8 @@ class SSLTransport:
             rawmode += "r"
         if writing:
             rawmode += "w"
-        raw = socket.SocketIO(self, rawmode)
-        self.socket._io_refs += 1
+        raw = socket.SocketIO(self, rawmode)  # type: ignore[arg-type]
+        self.socket._io_refs += 1  # type: ignore[attr-defined]
         if buffering is None:
             buffering = -1
         if buffering < 0:
@@ -134,8 +152,9 @@ class SSLTransport:
             if not binary:
                 raise ValueError("unbuffered streams must be binary")
             return raw
+        buffer: typing.BinaryIO
         if reading and writing:
-            buffer = io.BufferedRWPair(raw, raw, buffering)
+            buffer = io.BufferedRWPair(raw, raw, buffering)  # type: ignore[assignment]
         elif reading:
             buffer = io.BufferedReader(raw, buffering)
         else:
@@ -144,46 +163,56 @@ class SSLTransport:
         if binary:
             return buffer
         text = io.TextIOWrapper(buffer, encoding, errors, newline)
-        text.mode = mode
+        text.mode = mode  # type: ignore[misc]
         return text
 
-    def unwrap(self):
+    def unwrap(self) -> None:
         self._ssl_io_loop(self.sslobj.unwrap)
 
-    def close(self):
+    def close(self) -> None:
         self.socket.close()
 
-    def getpeercert(self, binary_form=False):
-        return self.sslobj.getpeercert(binary_form)
+    @typing.overload
+    def getpeercert(
+        self, binary_form: Literal[False] = ...
+    ) -> _TYPE_PEER_CERT_RET_DICT | None:
+        ...
 
-    def version(self):
+    @typing.overload
+    def getpeercert(self, binary_form: Literal[True]) -> bytes | None:
+        ...
+
+    def getpeercert(self, binary_form: bool = False) -> _TYPE_PEER_CERT_RET:
+        return self.sslobj.getpeercert(binary_form)  # type: ignore[return-value]
+
+    def version(self) -> str | None:
         return self.sslobj.version()
 
-    def cipher(self):
+    def cipher(self) -> tuple[str, str, int] | None:
         return self.sslobj.cipher()
 
-    def selected_alpn_protocol(self):
+    def selected_alpn_protocol(self) -> str | None:
         return self.sslobj.selected_alpn_protocol()
 
-    def selected_npn_protocol(self):
+    def selected_npn_protocol(self) -> str | None:
         return self.sslobj.selected_npn_protocol()
 
-    def shared_ciphers(self):
+    def shared_ciphers(self) -> list[tuple[str, str, int]] | None:
         return self.sslobj.shared_ciphers()
 
-    def compression(self):
+    def compression(self) -> str | None:
         return self.sslobj.compression()
 
-    def settimeout(self, value):
+    def settimeout(self, value: float | None) -> None:
         self.socket.settimeout(value)
 
-    def gettimeout(self):
+    def gettimeout(self) -> float | None:
         return self.socket.gettimeout()
 
-    def _decref_socketios(self):
-        self.socket._decref_socketios()
+    def _decref_socketios(self) -> None:
+        self.socket._decref_socketios()  # type: ignore[attr-defined]
 
-    def _wrap_ssl_read(self, len, buffer=None):
+    def _wrap_ssl_read(self, len: int, buffer: bytearray | None = None) -> int | bytes:
         try:
             return self._ssl_io_loop(self.sslobj.read, len, buffer)
         except ssl.SSLError as e:
@@ -192,7 +221,32 @@ class SSLTransport:
             else:
                 raise
 
-    def _ssl_io_loop(self, func, *args):
+    # func is sslobj.do_handshake or sslobj.unwrap
+    @typing.overload
+    def _ssl_io_loop(self, func: typing.Callable[[], None]) -> None:
+        ...
+
+    # func is sslobj.write, arg1 is data
+    @typing.overload
+    def _ssl_io_loop(self, func: typing.Callable[[bytes], int], arg1: bytes) -> int:
+        ...
+
+    # func is sslobj.read, arg1 is len, arg2 is buffer
+    @typing.overload
+    def _ssl_io_loop(
+        self,
+        func: typing.Callable[[int, bytearray | None], bytes],
+        arg1: int,
+        arg2: bytearray | None,
+    ) -> bytes:
+        ...
+
+    def _ssl_io_loop(
+        self,
+        func: typing.Callable[..., _ReturnValue],
+        arg1: None | bytes | int = None,
+        arg2: bytearray | None = None,
+    ) -> _ReturnValue:
         """Performs an I/O loop between incoming/outgoing and the socket."""
         should_loop = True
         ret = None
@@ -200,7 +254,12 @@ class SSLTransport:
         while should_loop:
             errno = None
             try:
-                ret = func(*args)
+                if arg1 is None and arg2 is None:
+                    ret = func()
+                elif arg2 is None:
+                    ret = func(arg1)
+                else:
+                    ret = func(arg1, arg2)
             except ssl.SSLError as e:
                 if e.errno not in (ssl.SSL_ERROR_WANT_READ, ssl.SSL_ERROR_WANT_WRITE):
                     # WANT_READ, and WANT_WRITE are expected, others are not.
@@ -218,4 +277,4 @@ class SSLTransport:
                     self.incoming.write(buf)
                 else:
                     self.incoming.write_eof()
-        return ret
+        return typing.cast(_ReturnValue, ret)
diff --git a/lib/urllib3/util/timeout.py b/lib/urllib3/util/timeout.py
index 78e18a62..ec090f69 100644
--- a/lib/urllib3/util/timeout.py
+++ b/lib/urllib3/util/timeout.py
@@ -1,44 +1,56 @@
-from __future__ import absolute_import
+from __future__ import annotations
 
 import time
-
-# The default socket timeout, used by httplib to indicate that no timeout was; specified by the user
-from socket import _GLOBAL_DEFAULT_TIMEOUT, getdefaulttimeout
+import typing
+from enum import Enum
+from socket import getdefaulttimeout
 
 from ..exceptions import TimeoutStateError
 
-# A sentinel value to indicate that no timeout was specified by the user in
-# urllib3
-_Default = object()
+if typing.TYPE_CHECKING:
+    from typing_extensions import Final
 
 
-# Use time.monotonic if available.
-current_time = getattr(time, "monotonic", time.time)
+class _TYPE_DEFAULT(Enum):
+    # This value should never be passed to socket.settimeout() so for safety we use a -1.
+    # socket.settimout() raises a ValueError for negative values.
+    token = -1
 
 
-class Timeout(object):
+_DEFAULT_TIMEOUT: Final[_TYPE_DEFAULT] = _TYPE_DEFAULT.token
+
+_TYPE_TIMEOUT = typing.Optional[typing.Union[float, _TYPE_DEFAULT]]
+
+
+class Timeout:
     """Timeout configuration.
 
     Timeouts can be defined as a default for a pool:
 
     .. code-block:: python
 
-       timeout = Timeout(connect=2.0, read=7.0)
-       http = PoolManager(timeout=timeout)
-       response = http.request('GET', 'http://example.com/')
+        import urllib3
+
+        timeout = urllib3.util.Timeout(connect=2.0, read=7.0)
+
+        http = urllib3.PoolManager(timeout=timeout)
+
+        resp = http.request("GET", "https://example.com/")
+
+        print(resp.status)
 
     Or per-request (which overrides the default for the pool):
 
     .. code-block:: python
 
-       response = http.request('GET', 'http://example.com/', timeout=Timeout(10))
+       response = http.request("GET", "https://example.com/", timeout=Timeout(10))
 
     Timeouts can be disabled by setting all the parameters to ``None``:
 
     .. code-block:: python
 
        no_timeout = Timeout(connect=None, read=None)
-       response = http.request('GET', 'http://example.com/, timeout=no_timeout)
+       response = http.request("GET", "https://example.com/", timeout=no_timeout)
 
 
     :param total:
@@ -96,31 +108,31 @@ class Timeout(object):
     """
 
     #: A sentinel object representing the default timeout value
-    DEFAULT_TIMEOUT = _GLOBAL_DEFAULT_TIMEOUT
+    DEFAULT_TIMEOUT: _TYPE_TIMEOUT = _DEFAULT_TIMEOUT
 
-    def __init__(self, total=None, connect=_Default, read=_Default):
+    def __init__(
+        self,
+        total: _TYPE_TIMEOUT = None,
+        connect: _TYPE_TIMEOUT = _DEFAULT_TIMEOUT,
+        read: _TYPE_TIMEOUT = _DEFAULT_TIMEOUT,
+    ) -> None:
         self._connect = self._validate_timeout(connect, "connect")
         self._read = self._validate_timeout(read, "read")
         self.total = self._validate_timeout(total, "total")
-        self._start_connect = None
+        self._start_connect: float | None = None
 
-    def __repr__(self):
-        return "%s(connect=%r, read=%r, total=%r)" % (
-            type(self).__name__,
-            self._connect,
-            self._read,
-            self.total,
-        )
+    def __repr__(self) -> str:
+        return f"{type(self).__name__}(connect={self._connect!r}, read={self._read!r}, total={self.total!r})"
 
     # __str__ provided for backwards compatibility
     __str__ = __repr__
 
-    @classmethod
-    def resolve_default_timeout(cls, timeout):
-        return getdefaulttimeout() if timeout is cls.DEFAULT_TIMEOUT else timeout
+    @staticmethod
+    def resolve_default_timeout(timeout: _TYPE_TIMEOUT) -> float | None:
+        return getdefaulttimeout() if timeout is _DEFAULT_TIMEOUT else timeout
 
     @classmethod
-    def _validate_timeout(cls, value, name):
+    def _validate_timeout(cls, value: _TYPE_TIMEOUT, name: str) -> _TYPE_TIMEOUT:
         """Check that a timeout attribute is valid.
 
         :param value: The timeout value to validate
@@ -130,10 +142,7 @@ class Timeout(object):
         :raises ValueError: If it is a numeric value less than or equal to
             zero, or the type is not an integer, float, or None.
         """
-        if value is _Default:
-            return cls.DEFAULT_TIMEOUT
-
-        if value is None or value is cls.DEFAULT_TIMEOUT:
+        if value is None or value is _DEFAULT_TIMEOUT:
             return value
 
         if isinstance(value, bool):
@@ -147,7 +156,7 @@ class Timeout(object):
             raise ValueError(
                 "Timeout value %s was %s, but it must be an "
                 "int, float or None." % (name, value)
-            )
+            ) from None
 
         try:
             if value <= 0:
@@ -157,16 +166,15 @@ class Timeout(object):
                     "than or equal to 0." % (name, value)
                 )
         except TypeError:
-            # Python 3
             raise ValueError(
                 "Timeout value %s was %s, but it must be an "
                 "int, float or None." % (name, value)
-            )
+            ) from None
 
         return value
 
     @classmethod
-    def from_float(cls, timeout):
+    def from_float(cls, timeout: _TYPE_TIMEOUT) -> Timeout:
         """Create a new Timeout from a legacy timeout value.
 
         The timeout value used by httplib.py sets the same timeout on the
@@ -175,13 +183,13 @@ class Timeout(object):
         passed to this function.
 
         :param timeout: The legacy timeout value.
-        :type timeout: integer, float, sentinel default object, or None
+        :type timeout: integer, float, :attr:`urllib3.util.Timeout.DEFAULT_TIMEOUT`, or None
         :return: Timeout object
         :rtype: :class:`Timeout`
         """
         return Timeout(read=timeout, connect=timeout)
 
-    def clone(self):
+    def clone(self) -> Timeout:
         """Create a copy of the timeout object
 
         Timeout properties are stored per-pool but each request needs a fresh
@@ -195,7 +203,7 @@ class Timeout(object):
         # detect the user default.
         return Timeout(connect=self._connect, read=self._read, total=self.total)
 
-    def start_connect(self):
+    def start_connect(self) -> float:
         """Start the timeout clock, used during a connect() attempt
 
         :raises urllib3.exceptions.TimeoutStateError: if you attempt
@@ -203,10 +211,10 @@ class Timeout(object):
         """
         if self._start_connect is not None:
             raise TimeoutStateError("Timeout timer has already been started.")
-        self._start_connect = current_time()
+        self._start_connect = time.monotonic()
         return self._start_connect
 
-    def get_connect_duration(self):
+    def get_connect_duration(self) -> float:
         """Gets the time elapsed since the call to :meth:`start_connect`.
 
         :return: Elapsed time in seconds.
@@ -218,10 +226,10 @@ class Timeout(object):
             raise TimeoutStateError(
                 "Can't get connect duration for timer that has not started."
             )
-        return current_time() - self._start_connect
+        return time.monotonic() - self._start_connect
 
     @property
-    def connect_timeout(self):
+    def connect_timeout(self) -> _TYPE_TIMEOUT:
         """Get the value to use when setting a connection timeout.
 
         This will be a positive float or integer, the value None
@@ -233,13 +241,13 @@ class Timeout(object):
         if self.total is None:
             return self._connect
 
-        if self._connect is None or self._connect is self.DEFAULT_TIMEOUT:
+        if self._connect is None or self._connect is _DEFAULT_TIMEOUT:
             return self.total
 
-        return min(self._connect, self.total)
+        return min(self._connect, self.total)  # type: ignore[type-var]
 
     @property
-    def read_timeout(self):
+    def read_timeout(self) -> float | None:
         """Get the value for the read timeout.
 
         This assumes some time has elapsed in the connection timeout and
@@ -251,21 +259,21 @@ class Timeout(object):
         raised.
 
         :return: Value to use for the read timeout.
-        :rtype: int, float, :attr:`Timeout.DEFAULT_TIMEOUT` or None
+        :rtype: int, float or None
         :raises urllib3.exceptions.TimeoutStateError: If :meth:`start_connect`
             has not yet been called on this object.
         """
         if (
             self.total is not None
-            and self.total is not self.DEFAULT_TIMEOUT
+            and self.total is not _DEFAULT_TIMEOUT
             and self._read is not None
-            and self._read is not self.DEFAULT_TIMEOUT
+            and self._read is not _DEFAULT_TIMEOUT
         ):
             # In case the connect timeout has not yet been established.
             if self._start_connect is None:
                 return self._read
             return max(0, min(self.total - self.get_connect_duration(), self._read))
-        elif self.total is not None and self.total is not self.DEFAULT_TIMEOUT:
+        elif self.total is not None and self.total is not _DEFAULT_TIMEOUT:
             return max(0, self.total - self.get_connect_duration())
         else:
-            return self._read
+            return self.resolve_default_timeout(self._read)
diff --git a/lib/urllib3/util/url.py b/lib/urllib3/util/url.py
index e5682d3b..d53ea932 100644
--- a/lib/urllib3/util/url.py
+++ b/lib/urllib3/util/url.py
@@ -1,22 +1,20 @@
-from __future__ import absolute_import
+from __future__ import annotations
 
 import re
-from collections import namedtuple
+import typing
 
 from ..exceptions import LocationParseError
-from ..packages import six
-
-url_attrs = ["scheme", "auth", "host", "port", "path", "query", "fragment"]
+from .util import to_str
 
 # We only want to normalize urls with an HTTP(S) scheme.
 # urllib3 infers URLs without a scheme (None) to be http.
-NORMALIZABLE_SCHEMES = ("http", "https", None)
+_NORMALIZABLE_SCHEMES = ("http", "https", None)
 
 # Almost all of these patterns were derived from the
 # 'rfc3986' module: https://github.com/python-hyper/rfc3986
-PERCENT_RE = re.compile(r"%[a-fA-F0-9]{2}")
-SCHEME_RE = re.compile(r"^(?:[a-zA-Z][a-zA-Z0-9+-]*:|/)")
-URI_RE = re.compile(
+_PERCENT_RE = re.compile(r"%[a-fA-F0-9]{2}")
+_SCHEME_RE = re.compile(r"^(?:[a-zA-Z][a-zA-Z0-9+-]*:|/)")
+_URI_RE = re.compile(
     r"^(?:([a-zA-Z][a-zA-Z0-9+.-]*):)?"
     r"(?://([^\\/?#]*))?"
     r"([^?#]*)"
@@ -25,10 +23,10 @@ URI_RE = re.compile(
     re.UNICODE | re.DOTALL,
 )
 
-IPV4_PAT = r"(?:[0-9]{1,3}\.){3}[0-9]{1,3}"
-HEX_PAT = "[0-9A-Fa-f]{1,4}"
-LS32_PAT = "(?:{hex}:{hex}|{ipv4})".format(hex=HEX_PAT, ipv4=IPV4_PAT)
-_subs = {"hex": HEX_PAT, "ls32": LS32_PAT}
+_IPV4_PAT = r"(?:[0-9]{1,3}\.){3}[0-9]{1,3}"
+_HEX_PAT = "[0-9A-Fa-f]{1,4}"
+_LS32_PAT = "(?:{hex}:{hex}|{ipv4})".format(hex=_HEX_PAT, ipv4=_IPV4_PAT)
+_subs = {"hex": _HEX_PAT, "ls32": _LS32_PAT}
 _variations = [
     #                            6( h16 ":" ) ls32
     "(?:%(hex)s:){6}%(ls32)s",
@@ -50,69 +48,78 @@ _variations = [
     "(?:(?:%(hex)s:){0,6}%(hex)s)?::",
 ]
 
-UNRESERVED_PAT = r"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789._\-~"
-IPV6_PAT = "(?:" + "|".join([x % _subs for x in _variations]) + ")"
-ZONE_ID_PAT = "(?:%25|%)(?:[" + UNRESERVED_PAT + "]|%[a-fA-F0-9]{2})+"
-IPV6_ADDRZ_PAT = r"\[" + IPV6_PAT + r"(?:" + ZONE_ID_PAT + r")?\]"
-REG_NAME_PAT = r"(?:[^\[\]%:/?#]|%[a-fA-F0-9]{2})*"
-TARGET_RE = re.compile(r"^(/[^?#]*)(?:\?([^#]*))?(?:#.*)?$")
+_UNRESERVED_PAT = r"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789._\-~"
+_IPV6_PAT = "(?:" + "|".join([x % _subs for x in _variations]) + ")"
+_ZONE_ID_PAT = "(?:%25|%)(?:[" + _UNRESERVED_PAT + "]|%[a-fA-F0-9]{2})+"
+_IPV6_ADDRZ_PAT = r"\[" + _IPV6_PAT + r"(?:" + _ZONE_ID_PAT + r")?\]"
+_REG_NAME_PAT = r"(?:[^\[\]%:/?#]|%[a-fA-F0-9]{2})*"
+_TARGET_RE = re.compile(r"^(/[^?#]*)(?:\?([^#]*))?(?:#.*)?$")
 
-IPV4_RE = re.compile("^" + IPV4_PAT + "$")
-IPV6_RE = re.compile("^" + IPV6_PAT + "$")
-IPV6_ADDRZ_RE = re.compile("^" + IPV6_ADDRZ_PAT + "$")
-BRACELESS_IPV6_ADDRZ_RE = re.compile("^" + IPV6_ADDRZ_PAT[2:-2] + "$")
-ZONE_ID_RE = re.compile("(" + ZONE_ID_PAT + r")\]$")
+_IPV4_RE = re.compile("^" + _IPV4_PAT + "$")
+_IPV6_RE = re.compile("^" + _IPV6_PAT + "$")
+_IPV6_ADDRZ_RE = re.compile("^" + _IPV6_ADDRZ_PAT + "$")
+_BRACELESS_IPV6_ADDRZ_RE = re.compile("^" + _IPV6_ADDRZ_PAT[2:-2] + "$")
+_ZONE_ID_RE = re.compile("(" + _ZONE_ID_PAT + r")\]$")
 
 _HOST_PORT_PAT = ("^(%s|%s|%s)(?::0*?(|0|[1-9][0-9]{0,4}))?$") % (
-    REG_NAME_PAT,
-    IPV4_PAT,
-    IPV6_ADDRZ_PAT,
+    _REG_NAME_PAT,
+    _IPV4_PAT,
+    _IPV6_ADDRZ_PAT,
 )
 _HOST_PORT_RE = re.compile(_HOST_PORT_PAT, re.UNICODE | re.DOTALL)
 
-UNRESERVED_CHARS = set(
+_UNRESERVED_CHARS = set(
     "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789._-~"
 )
-SUB_DELIM_CHARS = set("!$&'()*+,;=")
-USERINFO_CHARS = UNRESERVED_CHARS | SUB_DELIM_CHARS | {":"}
-PATH_CHARS = USERINFO_CHARS | {"@", "/"}
-QUERY_CHARS = FRAGMENT_CHARS = PATH_CHARS | {"?"}
+_SUB_DELIM_CHARS = set("!$&'()*+,;=")
+_USERINFO_CHARS = _UNRESERVED_CHARS | _SUB_DELIM_CHARS | {":"}
+_PATH_CHARS = _USERINFO_CHARS | {"@", "/"}
+_QUERY_CHARS = _FRAGMENT_CHARS = _PATH_CHARS | {"?"}
 
 
-class Url(namedtuple("Url", url_attrs)):
+class Url(
+    typing.NamedTuple(
+        "Url",
+        [
+            ("scheme", typing.Optional[str]),
+            ("auth", typing.Optional[str]),
+            ("host", typing.Optional[str]),
+            ("port", typing.Optional[int]),
+            ("path", typing.Optional[str]),
+            ("query", typing.Optional[str]),
+            ("fragment", typing.Optional[str]),
+        ],
+    )
+):
     """
     Data structure for representing an HTTP URL. Used as a return value for
     :func:`parse_url`. Both the scheme and host are normalized as they are
     both case-insensitive according to RFC 3986.
     """
 
-    __slots__ = ()
-
-    def __new__(
+    def __new__(  # type: ignore[no-untyped-def]
         cls,
-        scheme=None,
-        auth=None,
-        host=None,
-        port=None,
-        path=None,
-        query=None,
-        fragment=None,
+        scheme: str | None = None,
+        auth: str | None = None,
+        host: str | None = None,
+        port: int | None = None,
+        path: str | None = None,
+        query: str | None = None,
+        fragment: str | None = None,
     ):
         if path and not path.startswith("/"):
             path = "/" + path
         if scheme is not None:
             scheme = scheme.lower()
-        return super(Url, cls).__new__(
-            cls, scheme, auth, host, port, path, query, fragment
-        )
+        return super().__new__(cls, scheme, auth, host, port, path, query, fragment)
 
     @property
-    def hostname(self):
+    def hostname(self) -> str | None:
         """For backwards-compatibility with urlparse. We're nice like that."""
         return self.host
 
     @property
-    def request_uri(self):
+    def request_uri(self) -> str:
         """Absolute path including the query string."""
         uri = self.path or "/"
 
@@ -122,14 +129,37 @@ class Url(namedtuple("Url", url_attrs)):
         return uri
 
     @property
-    def netloc(self):
-        """Network location including host and port"""
+    def authority(self) -> str | None:
+        """
+        Authority component as defined in RFC 3986 3.2.
+        This includes userinfo (auth), host and port.
+
+        i.e.
+            userinfo@host:port
+        """
+        userinfo = self.auth
+        netloc = self.netloc
+        if netloc is None or userinfo is None:
+            return netloc
+        else:
+            return f"{userinfo}@{netloc}"
+
+    @property
+    def netloc(self) -> str | None:
+        """
+        Network location including host and port.
+
+        If you need the equivalent of urllib.parse's ``netloc``,
+        use the ``authority`` property instead.
+        """
+        if self.host is None:
+            return None
         if self.port:
-            return "%s:%d" % (self.host, self.port)
+            return f"{self.host}:{self.port}"
         return self.host
 
     @property
-    def url(self):
+    def url(self) -> str:
         """
         Convert self into a url
 
@@ -138,88 +168,77 @@ class Url(namedtuple("Url", url_attrs)):
         :func:`.parse_url`, but it should be equivalent by the RFC (e.g., urls
         with a blank port will have : removed).
 
-        Example: ::
+        Example:
 
-            >>> U = parse_url('http://google.com/mail/')
-            >>> U.url
-            'http://google.com/mail/'
-            >>> Url('http', 'username:password', 'host.com', 80,
-            ... '/path', 'query', 'fragment').url
-            'http://username:password@host.com:80/path?query#fragment'
+        .. code-block:: python
+
+            import urllib3
+
+            U = urllib3.util.parse_url("https://google.com/mail/")
+
+            print(U.url)
+            # "https://google.com/mail/"
+
+            print( urllib3.util.Url("https", "username:password",
+                                    "host.com", 80, "/path", "query", "fragment"
+                                    ).url
+                )
+            # "https://username:password@host.com:80/path?query#fragment"
         """
         scheme, auth, host, port, path, query, fragment = self
-        url = u""
+        url = ""
 
         # We use "is not None" we want things to happen with empty strings (or 0 port)
         if scheme is not None:
-            url += scheme + u"://"
+            url += scheme + "://"
         if auth is not None:
-            url += auth + u"@"
+            url += auth + "@"
         if host is not None:
             url += host
         if port is not None:
-            url += u":" + str(port)
+            url += ":" + str(port)
         if path is not None:
             url += path
         if query is not None:
-            url += u"?" + query
+            url += "?" + query
         if fragment is not None:
-            url += u"#" + fragment
+            url += "#" + fragment
 
         return url
 
-    def __str__(self):
+    def __str__(self) -> str:
         return self.url
 
 
-def split_first(s, delims):
-    """
-    .. deprecated:: 1.25
-
-    Given a string and an iterable of delimiters, split on the first found
-    delimiter. Return two split parts and the matched delimiter.
-
-    If not found, then the first part is the full input string.
-
-    Example::
-
-        >>> split_first('foo/bar?baz', '?/=')
-        ('foo', 'bar?baz', '/')
-        >>> split_first('foo/bar?baz', '123')
-        ('foo/bar?baz', '', None)
-
-    Scales linearly with number of delims. Not ideal for large number of delims.
-    """
-    min_idx = None
-    min_delim = None
-    for d in delims:
-        idx = s.find(d)
-        if idx < 0:
-            continue
-
-        if min_idx is None or idx < min_idx:
-            min_idx = idx
-            min_delim = d
-
-    if min_idx is None or min_idx < 0:
-        return s, "", None
-
-    return s[:min_idx], s[min_idx + 1 :], min_delim
+@typing.overload
+def _encode_invalid_chars(
+    component: str, allowed_chars: typing.Container[str]
+) -> str:  # Abstract
+    ...
 
 
-def _encode_invalid_chars(component, allowed_chars, encoding="utf-8"):
+@typing.overload
+def _encode_invalid_chars(
+    component: None, allowed_chars: typing.Container[str]
+) -> None:  # Abstract
+    ...
+
+
+def _encode_invalid_chars(
+    component: str | None, allowed_chars: typing.Container[str]
+) -> str | None:
     """Percent-encodes a URI component without reapplying
     onto an already percent-encoded component.
     """
     if component is None:
         return component
 
-    component = six.ensure_text(component)
+    component = to_str(component)
 
     # Normalize existing percent-encoded bytes.
     # Try to see if the component we're encoding is already percent-encoded
     # so we can skip all '%' characters but still encode all others.
-    component, percent_encodings = PERCENT_RE.subn(
+    component, percent_encodings = _PERCENT_RE.subn(
         lambda match: match.group(0).upper(), component
     )
 
@@ -228,7 +247,7 @@ def _encode_invalid_chars(component, allowed_chars, encoding="utf-8"):
     encoded_component = bytearray()
 
     for i in range(0, len(uri_bytes)):
-        # Will return a single character bytestring on both Python 2 & 3
+        # Will return a single character bytestring
         byte = uri_bytes[i : i + 1]
         byte_ord = ord(byte)
         if (is_percent_encoded and byte == b"%") or (
@@ -238,10 +257,10 @@ def _encode_invalid_chars(component, allowed_chars, encoding="utf-8"):
             continue
         encoded_component.extend(b"%" + (hex(byte_ord)[2:].encode().zfill(2).upper()))
 
-    return encoded_component.decode(encoding)
+    return encoded_component.decode()
 
 
-def _remove_path_dot_segments(path):
+def _remove_path_dot_segments(path: str) -> str:
     # See http://tools.ietf.org/html/rfc3986#section-5.2.4 for pseudo-code
     segments = path.split("/")  # Turn the path into a list of segments
     output = []  # Initialize the variable to use to store output
@@ -251,7 +270,7 @@ def _remove_path_dot_segments(path):
         if segment == ".":
             continue
         # Anything other than '..', should be appended to the output
-        elif segment != "..":
+        if segment != "..":
             output.append(segment)
         # In this case segment == '..', if we can, we should pop the last
         # element
@@ -271,18 +290,25 @@ def _remove_path_dot_segments(path):
     return "/".join(output)
 
 
-def _normalize_host(host, scheme):
-    if host:
-        if isinstance(host, six.binary_type):
-            host = six.ensure_str(host)
+@typing.overload
+def _normalize_host(host: None, scheme: str | None) -> None:
+    ...
 
-        if scheme in NORMALIZABLE_SCHEMES:
-            is_ipv6 = IPV6_ADDRZ_RE.match(host)
+
+@typing.overload
+def _normalize_host(host: str, scheme: str | None) -> str:
+    ...
+
+
+def _normalize_host(host: str | None, scheme: str | None) -> str | None:
+    if host:
+        if scheme in _NORMALIZABLE_SCHEMES:
+            is_ipv6 = _IPV6_ADDRZ_RE.match(host)
             if is_ipv6:
                 # IPv6 hosts of the form 'a::b%zone' are encoded in a URL as
                 # such per RFC 6874: 'a::b%25zone'. Unquote the ZoneID
                 # separator as necessary to return a valid RFC 4007 scoped IP.
-                match = ZONE_ID_RE.search(host)
+                match = _ZONE_ID_RE.search(host)
                 if match:
                     start, end = match.span(1)
                     zone_id = host[start:end]
@@ -291,46 +317,56 @@ def _normalize_host(host, scheme):
                         zone_id = zone_id[3:]
                     else:
                         zone_id = zone_id[1:]
-                    zone_id = "%" + _encode_invalid_chars(zone_id, UNRESERVED_CHARS)
-                    return host[:start].lower() + zone_id + host[end:]
+                    zone_id = _encode_invalid_chars(zone_id, _UNRESERVED_CHARS)
+                    return f"{host[:start].lower()}%{zone_id}{host[end:]}"
                 else:
                     return host.lower()
-            elif not IPV4_RE.match(host):
-                return six.ensure_str(
-                    b".".join([_idna_encode(label) for label in host.split(".")])
+            elif not _IPV4_RE.match(host):
+                return to_str(
+                    b".".join([_idna_encode(label) for label in host.split(".")]),
+                    "ascii",
                 )
     return host
 
 
-def _idna_encode(name):
-    if name and any(ord(x) >= 128 for x in name):
+def _idna_encode(name: str) -> bytes:
+    if not name.isascii():
         try:
             import idna
         except ImportError:
-            six.raise_from(
-                LocationParseError("Unable to parse URL without the 'idna' module"),
-                None,
-            )
+            raise LocationParseError(
+                "Unable to parse URL without the 'idna' module"
+            ) from None
+
         try:
             return idna.encode(name.lower(), strict=True, std3_rules=True)
         except idna.IDNAError:
-            six.raise_from(
-                LocationParseError(u"Name '%s' is not a valid IDNA label" % name), None
-            )
+            raise LocationParseError(
+                f"Name '{name}' is not a valid IDNA label"
+            ) from None
+
     return name.lower().encode("ascii")
 
 
-def _encode_target(target):
-    """Percent-encodes a request target so that there are no invalid characters"""
-    path, query = TARGET_RE.match(target).groups()
-    target = _encode_invalid_chars(path, PATH_CHARS)
-    query = _encode_invalid_chars(query, QUERY_CHARS)
+def _encode_target(target: str) -> str:
+    """Percent-encodes a request target so that there are no invalid characters
+
+    Pre-condition for this function is that 'target' must start with '/'.
+    If that is the case then _TARGET_RE will always produce a match.
+    """
+    match = _TARGET_RE.match(target)
+    if not match:  # Defensive:
+        raise LocationParseError(f"{target!r} is not a valid request URI")
+
+    path, query = match.groups()
+    encoded_target = _encode_invalid_chars(path, _PATH_CHARS)
     if query is not None:
-        target += "?" + query
-    return target
+        query = _encode_invalid_chars(query, _QUERY_CHARS)
+        encoded_target += "?" + query
+    return encoded_target
 
 
-def parse_url(url):
+def parse_url(url: str) -> Url:
     """
     Given a url, return a parsed :class:`.Url` namedtuple. Best-effort is
     performed to parse incomplete urls. Fields not provided will be None.
@@ -341,28 +377,44 @@ def parse_url(url):
 
     :param str url: URL to parse into a :class:`.Url` namedtuple.
 
-    Partly backwards-compatible with :mod:`urlparse`.
+    Partly backwards-compatible with :mod:`urllib.parse`.
 
-    Example::
+    Example:
 
-        >>> parse_url('http://google.com/mail/')
-        Url(scheme='http', host='google.com', port=None, path='/mail/', ...)
-        >>> parse_url('google.com:80')
-        Url(scheme=None, host='google.com', port=80, path=None, ...)
-        >>> parse_url('/foo?bar')
-        Url(scheme=None, host=None, port=None, path='/foo', query='bar', ...)
+    .. code-block:: python
+
+        import urllib3
+
+        print( urllib3.util.parse_url('http://google.com/mail/'))
+        # Url(scheme='http', host='google.com', port=None, path='/mail/', ...)
+
+        print( urllib3.util.parse_url('google.com:80'))
+        # Url(scheme=None, host='google.com', port=80, path=None, ...)
+
+        print( urllib3.util.parse_url('/foo?bar'))
+        # Url(scheme=None, host=None, port=None, path='/foo', query='bar', ...)
     """
     if not url:
         # Empty
         return Url()
 
     source_url = url
-    if not SCHEME_RE.search(url):
+    if not _SCHEME_RE.search(url):
         url = "//" + url
 
+    scheme: str | None
+    authority: str | None
+    auth: str | None
+    host: str | None
+    port: str | None
+    port_int: int | None
+    path: str | None
+    query: str | None
+    fragment: str | None
+
     try:
-        scheme, authority, path, query, fragment = URI_RE.match(url).groups()
-        normalize_uri = scheme is None or scheme.lower() in NORMALIZABLE_SCHEMES
+        scheme, authority, path, query, fragment = _URI_RE.match(url).groups()  # type: ignore[union-attr]
+        normalize_uri = scheme is None or scheme.lower() in _NORMALIZABLE_SCHEMES
 
         if scheme:
             scheme = scheme.lower()
@@ -370,31 +422,33 @@ def parse_url(url):
         if authority:
             auth, _, host_port = authority.rpartition("@")
             auth = auth or None
-            host, port = _HOST_PORT_RE.match(host_port).groups()
+            host, port = _HOST_PORT_RE.match(host_port).groups()  # type: ignore[union-attr]
             if auth and normalize_uri:
-                auth = _encode_invalid_chars(auth, USERINFO_CHARS)
+                auth = _encode_invalid_chars(auth, _USERINFO_CHARS)
             if port == "":
                 port = None
         else:
             auth, host, port = None, None, None
 
         if port is not None:
-            port = int(port)
-            if not (0 <= port <= 65535):
+            port_int = int(port)
+            if not (0 <= port_int <= 65535):
                 raise LocationParseError(url)
+        else:
+            port_int = None
 
         host = _normalize_host(host, scheme)
 
         if normalize_uri and path:
             path = _remove_path_dot_segments(path)
-            path = _encode_invalid_chars(path, PATH_CHARS)
+            path = _encode_invalid_chars(path, _PATH_CHARS)
         if normalize_uri and query:
-            query = _encode_invalid_chars(query, QUERY_CHARS)
+            query = _encode_invalid_chars(query, _QUERY_CHARS)
         if normalize_uri and fragment:
-            fragment = _encode_invalid_chars(fragment, FRAGMENT_CHARS)
+            fragment = _encode_invalid_chars(fragment, _FRAGMENT_CHARS)
 
-    except (ValueError, AttributeError):
-        return six.raise_from(LocationParseError(source_url), None)
+    except (ValueError, AttributeError) as e:
+        raise LocationParseError(source_url) from e
 
     # For the sake of backwards compatibility we put empty
     # string values for path if there are any defined values
@@ -406,30 +460,12 @@ def parse_url(url):
         else:
             path = None
 
-    # Ensure that each part of the URL is a `str` for
-    # backwards compatibility.
-    if isinstance(url, six.text_type):
-        ensure_func = six.ensure_text
-    else:
-        ensure_func = six.ensure_str
-
-    def ensure_type(x):
-        return x if x is None else ensure_func(x)
-
     return Url(
-        scheme=ensure_type(scheme),
-        auth=ensure_type(auth),
-        host=ensure_type(host),
-        port=port,
-        path=ensure_type(path),
-        query=ensure_type(query),
-        fragment=ensure_type(fragment),
+        scheme=scheme,
+        auth=auth,
+        host=host,
+        port=port_int,
+        path=path,
+        query=query,
+        fragment=fragment,
     )
-
-
-def get_host(url):
-    """
-    Deprecated. Use :func:`parse_url` instead.
-    """
-    p = parse_url(url)
-    return p.scheme or "http", p.hostname, p.port
diff --git a/lib/urllib3/util/util.py b/lib/urllib3/util/util.py
new file mode 100644
index 00000000..35c77e40
--- /dev/null
+++ b/lib/urllib3/util/util.py
@@ -0,0 +1,42 @@
+from __future__ import annotations
+
+import typing
+from types import TracebackType
+
+
+def to_bytes(
+    x: str | bytes, encoding: str | None = None, errors: str | None = None
+) -> bytes:
+    if isinstance(x, bytes):
+        return x
+    elif not isinstance(x, str):
+        raise TypeError(f"not expecting type {type(x).__name__}")
+    if encoding or errors:
+        return x.encode(encoding or "utf-8", errors=errors or "strict")
+    return x.encode()
+
+
+def to_str(
+    x: str | bytes, encoding: str | None = None, errors: str | None = None
+) -> str:
+    if isinstance(x, str):
+        return x
+    elif not isinstance(x, bytes):
+        raise TypeError(f"not expecting type {type(x).__name__}")
+    if encoding or errors:
+        return x.decode(encoding or "utf-8", errors=errors or "strict")
+    return x.decode()
+
+
+def reraise(
+    tp: type[BaseException] | None,
+    value: BaseException,
+    tb: TracebackType | None = None,
+) -> typing.NoReturn:
+    try:
+        if value.__traceback__ is not tb:
+            raise value.with_traceback(tb)
+        raise value
+    finally:
+        value = None  # type: ignore[assignment]
+        tb = None
diff --git a/lib/urllib3/util/wait.py b/lib/urllib3/util/wait.py
index 21b4590b..aeca0c7a 100644
--- a/lib/urllib3/util/wait.py
+++ b/lib/urllib3/util/wait.py
@@ -1,18 +1,10 @@
-import errno
+from __future__ import annotations
+
 import select
-import sys
+import socket
 from functools import partial
 
-try:
-    from time import monotonic
-except ImportError:
-    from time import time as monotonic
-
-__all__ = ["NoWayToWaitForSocketError", "wait_for_read", "wait_for_write"]
-
-
-class NoWayToWaitForSocketError(Exception):
-    pass
+__all__ = ["wait_for_read", "wait_for_write"]
 
 
 # How should we wait on sockets?
@@ -37,37 +29,13 @@ class NoWayToWaitForSocketError(Exception):
 # So: on Windows we use select(), and everywhere else we use poll(). We also
 # fall back to select() in case poll() is somehow broken or missing.
 
-if sys.version_info >= (3, 5):
-    # Modern Python, that retries syscalls by default
-    def _retry_on_intr(fn, timeout):
-        return fn(timeout)
 
-else:
-    # Old and broken Pythons.
-    def _retry_on_intr(fn, timeout):
-        if timeout is None:
-            deadline = float("inf")
-        else:
-            deadline = monotonic() + timeout
-
-        while True:
-            try:
-                return fn(timeout)
-            # OSError for 3 <= pyver < 3.5, select.error for pyver <= 2.7
-            except (OSError, select.error) as e:
-                # 'e.args[0]' incantation works for both OSError and select.error
-                if e.args[0] != errno.EINTR:
-                    raise
-                else:
-                    timeout = deadline - monotonic()
-                    if timeout < 0:
-                        timeout = 0
-                    if timeout == float("inf"):
-                        timeout = None
-                    continue
-
-
-def select_wait_for_socket(sock, read=False, write=False, timeout=None):
+def select_wait_for_socket(
+    sock: socket.socket,
+    read: bool = False,
+    write: bool = False,
+    timeout: float | None = None,
+) -> bool:
     if not read and not write:
         raise RuntimeError("must specify at least one of read=True, write=True")
     rcheck = []
@@ -82,11 +50,16 @@ def select_wait_for_socket(sock, read=False, write=False, timeout=None):
     # sockets for both conditions. (The stdlib selectors module does the same
     # thing.)
     fn = partial(select.select, rcheck, wcheck, wcheck)
-    rready, wready, xready = _retry_on_intr(fn, timeout)
+    rready, wready, xready = fn(timeout)
     return bool(rready or wready or xready)
 
 
-def poll_wait_for_socket(sock, read=False, write=False, timeout=None):
+def poll_wait_for_socket(
+    sock: socket.socket,
+    read: bool = False,
+    write: bool = False,
+    timeout: float | None = None,
+) -> bool:
     if not read and not write:
         raise RuntimeError("must specify at least one of read=True, write=True")
     mask = 0
@@ -98,32 +71,33 @@ def poll_wait_for_socket(sock, read=False, write=False, timeout=None):
     poll_obj.register(sock, mask)
 
     # For some reason, poll() takes timeout in milliseconds
-    def do_poll(t):
+    def do_poll(t: float | None) -> list[tuple[int, int]]:
         if t is not None:
             t *= 1000
         return poll_obj.poll(t)
 
-    return bool(_retry_on_intr(do_poll, timeout))
+    return bool(do_poll(timeout))
 
 
-def null_wait_for_socket(*args, **kwargs):
-    raise NoWayToWaitForSocketError("no select-equivalent available")
-
-
-def _have_working_poll():
+def _have_working_poll() -> bool:
     # Apparently some systems have a select.poll that fails as soon as you try
     # to use it, either due to strange configuration or broken monkeypatching
     # from libraries like eventlet/greenlet.
     try:
         poll_obj = select.poll()
-        _retry_on_intr(poll_obj.poll, 0)
+        poll_obj.poll(0)
     except (AttributeError, OSError):
         return False
     else:
         return True
 
 
-def wait_for_socket(*args, **kwargs):
+def wait_for_socket(
+    sock: socket.socket,
+    read: bool = False,
+    write: bool = False,
+    timeout: float | None = None,
+) -> bool:
     # We delay choosing which implementation to use until the first time we're
     # called. We could do it at import time, but then we might make the wrong
     # decision if someone goes wild with monkeypatching select.poll after
@@ -133,19 +107,17 @@ def wait_for_socket(*args, **kwargs):
         wait_for_socket = poll_wait_for_socket
     elif hasattr(select, "select"):
         wait_for_socket = select_wait_for_socket
-    else:  # Platform-specific: Appengine.
-        wait_for_socket = null_wait_for_socket
-    return wait_for_socket(*args, **kwargs)
+    return wait_for_socket(sock, read, write, timeout)
 
 
-def wait_for_read(sock, timeout=None):
+def wait_for_read(sock: socket.socket, timeout: float | None = None) -> bool:
     """Waits for reading to be available on a given socket.
     Returns True if the socket is readable, or False if the timeout expired.
     """
     return wait_for_socket(sock, read=True, timeout=timeout)
 
 
-def wait_for_write(sock, timeout=None):
+def wait_for_write(sock: socket.socket, timeout: float | None = None) -> bool:
     """Waits for writing to be available on a given socket.
     Returns True if the socket is readable, or False if the timeout expired.
     """
diff --git a/requirements.txt b/requirements.txt
index 231adbca..72a96b37 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -36,7 +36,7 @@ pyparsing==3.0.9
 python-dateutil==2.8.2
 python-twitter==3.5
 pytz==2023.3
-requests==2.28.2
+requests==2.31.0
 requests-oauthlib==1.3.1
 rumps==0.4.0; platform_system == "Darwin"
 simplejson==3.19.1

From 9a196f3dcafd3c4ef76c4bf47c01298fca0558f7 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 23 Aug 2023 21:42:53 -0700
Subject: [PATCH 428/743] Bump certifi from 2022.12.7 to 2023.7.22 (#2110)

* Bump certifi from 2022.12.7 to 2023.7.22

Bumps [certifi](https://github.com/certifi/python-certifi) from 2022.12.7 to 2023.7.22.
- [Commits](https://github.com/certifi/python-certifi/compare/2022.12.07...2023.07.22)

---
updated-dependencies:
- dependency-name: certifi
  dependency-type: direct:production
  update-type: version-update:semver-major
...

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

* Update certifi==2023.7.22

---------

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

[skip ci]
---
 requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements.txt b/requirements.txt
index 72a96b37..94849c2e 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -6,7 +6,7 @@ backports.functools-lru-cache==1.6.4
 backports.zoneinfo==0.2.1;python_version<"3.9"
 beautifulsoup4==4.12.2
 bleach==6.0.0
-certifi==2022.12.7
+certifi==2023.7.22
 cheroot==9.0.0
 cherrypy==18.8.0
 cloudinary==1.32.0

From 1e903b164b0a69efa48a6cf0cd16d1e932cd66f7 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 23 Aug 2023 21:43:27 -0700
Subject: [PATCH 429/743] Bump tempora from 5.2.1 to 5.5.0 (#2111)

* Bump tempora from 5.2.1 to 5.5.0

Bumps [tempora](https://github.com/jaraco/tempora) from 5.2.1 to 5.5.0.
- [Release notes](https://github.com/jaraco/tempora/releases)
- [Changelog](https://github.com/jaraco/tempora/blob/main/NEWS.rst)
- [Commits](https://github.com/jaraco/tempora/compare/v5.2.1...v5.5.0)

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

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

* Update tempora==5.5.0

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/jaraco/functools.py        |  62 +++++++-
 lib/more_itertools/__init__.py |   2 +-
 lib/more_itertools/more.py     | 279 +++++++++++++++++++++++++++------
 lib/more_itertools/more.pyi    |  18 +++
 lib/more_itertools/recipes.py  | 161 ++++++++++++-------
 lib/more_itertools/recipes.pyi |  13 +-
 lib/tempora/__init__.py        |   6 +-
 lib/tempora/schedule.py        |   4 +-
 lib/tempora/timing.py          |  15 +-
 requirements.txt               |   2 +-
 10 files changed, 429 insertions(+), 133 deletions(-)

diff --git a/lib/jaraco/functools.py b/lib/jaraco/functools.py
index 6ae9e31d..43c009f9 100644
--- a/lib/jaraco/functools.py
+++ b/lib/jaraco/functools.py
@@ -1,9 +1,10 @@
-import functools
-import time
-import inspect
 import collections
-import types
+import functools
+import inspect
 import itertools
+import operator
+import time
+import types
 import warnings
 
 import more_itertools
@@ -183,8 +184,9 @@ def method_cache(
     # Support cache clear even before cache has been created.
     wrapper.cache_clear = lambda: None  # type: ignore[attr-defined]
 
-    return (  # type: ignore[return-value]
-        _special_method_cache(method, cache_wrapper) or wrapper
+    return (
+        _special_method_cache(method, cache_wrapper)  # type: ignore[return-value]
+        or wrapper
     )
 
 
@@ -554,3 +556,51 @@ def except_(*exceptions, replace=None, use=None):
         return wrapper
 
     return decorate
+
+
+def identity(x):
+    return x
+
+
+def bypass_when(check, *, _op=identity):
+    """
+    Decorate a function to return its parameter when ``check``.
+
+    >>> bypassed = []  # False
+
+    >>> @bypass_when(bypassed)
+    ... def double(x):
+    ...     return x * 2
+    >>> double(2)
+    4
+    >>> bypassed[:] = [object()]  # True
+    >>> double(2)
+    2
+    """
+
+    def decorate(func):
+        @functools.wraps(func)
+        def wrapper(param):
+            return param if _op(check) else func(param)
+
+        return wrapper
+
+    return decorate
+
+
+def bypass_unless(check):
+    """
+    Decorate a function to return its parameter unless ``check``.
+
+    >>> enabled = [object()]  # True
+
+    >>> @bypass_unless(enabled)
+    ... def double(x):
+    ...     return x * 2
+    >>> double(2)
+    4
+    >>> del enabled[:]  # False
+    >>> double(2)
+    2
+    """
+    return bypass_when(check, _op=operator.not_)
diff --git a/lib/more_itertools/__init__.py b/lib/more_itertools/__init__.py
index 66443971..28ffadcf 100644
--- a/lib/more_itertools/__init__.py
+++ b/lib/more_itertools/__init__.py
@@ -3,4 +3,4 @@
 from .more import *  # noqa
 from .recipes import *  # noqa
 
-__version__ = '9.1.0'
+__version__ = '10.1.0'
diff --git a/lib/more_itertools/more.py b/lib/more_itertools/more.py
index cc8b8b48..59c2f1a4 100755
--- a/lib/more_itertools/more.py
+++ b/lib/more_itertools/more.py
@@ -2,7 +2,7 @@ import warnings
 
 from collections import Counter, defaultdict, deque, abc
 from collections.abc import Sequence
-from functools import partial, reduce, wraps
+from functools import cached_property, partial, reduce, wraps
 from heapq import heapify, heapreplace, heappop
 from itertools import (
     chain,
@@ -17,6 +17,7 @@ from itertools import (
     takewhile,
     tee,
     zip_longest,
+    product,
 )
 from math import exp, factorial, floor, log
 from queue import Empty, Queue
@@ -36,6 +37,7 @@ from .recipes import (
     take,
     unique_everseen,
     all_equal,
+    batched,
 )
 
 __all__ = [
@@ -53,6 +55,7 @@ __all__ = [
     'circular_shifts',
     'collapse',
     'combination_index',
+    'combination_with_replacement_index',
     'consecutive_groups',
     'constrained_batches',
     'consumer',
@@ -93,10 +96,13 @@ __all__ = [
     'nth_or_last',
     'nth_permutation',
     'nth_product',
+    'nth_combination_with_replacement',
     'numeric_range',
     'one',
     'only',
+    'outer_product',
     'padded',
+    'partial_product',
     'partitions',
     'peekable',
     'permutation_index',
@@ -125,6 +131,7 @@ __all__ = [
     'strictly_n',
     'substrings',
     'substrings_indexes',
+    'takewhile_inclusive',
     'time_limited',
     'unique_in_window',
     'unique_to_each',
@@ -472,7 +479,10 @@ def iterate(func, start):
     """
     while True:
         yield start
-        start = func(start)
+        try:
+            start = func(start)
+        except StopIteration:
+            break
 
 
 def with_iter(context_manager):
@@ -2069,7 +2079,6 @@ class numeric_range(abc.Sequence, abc.Hashable):
         if self._step == self._zero:
             raise ValueError('numeric_range() arg 3 must not be zero')
         self._growing = self._step > self._zero
-        self._init_len()
 
     def __bool__(self):
         if self._growing:
@@ -2145,7 +2154,8 @@ class numeric_range(abc.Sequence, abc.Hashable):
     def __len__(self):
         return self._len
 
-    def _init_len(self):
+    @cached_property
+    def _len(self):
         if self._growing:
             start = self._start
             stop = self._stop
@@ -2156,10 +2166,10 @@ class numeric_range(abc.Sequence, abc.Hashable):
             step = -self._step
         distance = stop - start
         if distance <= self._zero:
-            self._len = 0
+            return 0
         else:  # distance > 0 and step > 0: regular euclidean division
             q, r = divmod(distance, step)
-            self._len = int(q) + int(r != self._zero)
+            return int(q) + int(r != self._zero)
 
     def __reduce__(self):
         return numeric_range, (self._start, self._stop, self._step)
@@ -2699,6 +2709,9 @@ class seekable:
         >>> it.seek(10)
         >>> next(it)
         '10'
+        >>> it.relative_seek(-2)  # Seeking relative to the current position
+        >>> next(it)
+        '9'
         >>> it.seek(20)  # Seeking past the end of the source isn't a problem
         >>> list(it)
         []
@@ -2812,6 +2825,10 @@ class seekable:
         if remainder > 0:
             consume(self, remainder)
 
+    def relative_seek(self, count):
+        index = len(self._cache)
+        self.seek(max(index + count, 0))
+
 
 class run_length:
     """
@@ -3859,6 +3876,54 @@ def nth_permutation(iterable, r, index):
     return tuple(map(pool.pop, result))
 
 
+def nth_combination_with_replacement(iterable, r, index):
+    """Equivalent to
+    ``list(combinations_with_replacement(iterable, r))[index]``.
+
+
+    The subsequences with repetition of *iterable* that are of length *r* can
+    be ordered lexicographically. :func:`nth_combination_with_replacement`
+    computes the subsequence at sort position *index* directly, without
+    computing the previous subsequences with replacement.
+
+        >>> nth_combination_with_replacement(range(5), 3, 5)
+        (0, 1, 1)
+
+    ``ValueError`` will be raised If *r* is negative or greater than the length
+    of *iterable*.
+    ``IndexError`` will be raised if the given *index* is invalid.
+    """
+    pool = tuple(iterable)
+    n = len(pool)
+    if (r < 0) or (r > n):
+        raise ValueError
+
+    c = factorial(n + r - 1) // (factorial(r) * factorial(n - 1))
+
+    if index < 0:
+        index += c
+
+    if (index < 0) or (index >= c):
+        raise IndexError
+
+    result = []
+    i = 0
+    while r:
+        r -= 1
+        while n >= 0:
+            num_combs = factorial(n + r - 1) // (
+                factorial(r) * factorial(n - 1)
+            )
+            if index < num_combs:
+                break
+            n -= 1
+            i += 1
+            index -= num_combs
+        result.append(pool[i])
+
+    return tuple(result)
+
+
 def value_chain(*args):
     """Yield all arguments passed to the function in the same order in which
     they were passed. If an argument itself is iterable then iterate over its
@@ -3955,6 +4020,61 @@ def combination_index(element, iterable):
     return factorial(n + 1) // (factorial(k + 1) * factorial(n - k)) - index
 
 
+def combination_with_replacement_index(element, iterable):
+    """Equivalent to
+    ``list(combinations_with_replacement(iterable, r)).index(element)``
+
+    The subsequences with repetition of *iterable* that are of length *r* can
+    be ordered lexicographically. :func:`combination_with_replacement_index`
+    computes the index of the first *element*, without computing the previous
+    combinations with replacement.
+
+        >>> combination_with_replacement_index('adf', 'abcdefg')
+        20
+
+    ``ValueError`` will be raised if the given *element* isn't one of the
+    combinations with replacement of *iterable*.
+    """
+    element = tuple(element)
+    l = len(element)
+    element = enumerate(element)
+
+    k, y = next(element, (None, None))
+    if k is None:
+        return 0
+
+    indexes = []
+    pool = tuple(iterable)
+    for n, x in enumerate(pool):
+        while x == y:
+            indexes.append(n)
+            tmp, y = next(element, (None, None))
+            if tmp is None:
+                break
+            else:
+                k = tmp
+        if y is None:
+            break
+    else:
+        raise ValueError(
+            'element is not a combination with replacment of iterable'
+        )
+
+    n = len(pool)
+    occupations = [0] * n
+    for p in indexes:
+        occupations[p] += 1
+
+    index = 0
+    for k in range(1, n):
+        j = l + n - 1 - k - sum(occupations[:k])
+        i = n - k
+        if i <= j:
+            index += factorial(j) // (factorial(i) * factorial(j - i))
+
+    return index
+
+
 def permutation_index(element, iterable):
     """Equivalent to ``list(permutations(iterable, r)).index(element)```
 
@@ -4057,26 +4177,20 @@ def _chunked_even_finite(iterable, N, n):
     num_full = N - partial_size * num_lists
     num_partial = num_lists - num_full
 
-    buffer = []
-    iterator = iter(iterable)
-
     # Yield num_full lists of full_size
-    for x in iterator:
-        buffer.append(x)
-        if len(buffer) == full_size:
-            yield buffer
-            buffer = []
-            num_full -= 1
-            if num_full <= 0:
-                break
+    partial_start_idx = num_full * full_size
+    if full_size > 0:
+        for i in range(0, partial_start_idx, full_size):
+            yield list(islice(iterable, i, i + full_size))
 
     # Yield num_partial lists of partial_size
-    for x in iterator:
-        buffer.append(x)
-        if len(buffer) == partial_size:
-            yield buffer
-            buffer = []
-            num_partial -= 1
+    if partial_size > 0:
+        for i in range(
+            partial_start_idx,
+            partial_start_idx + (num_partial * partial_size),
+            partial_size,
+        ):
+            yield list(islice(iterable, i, i + partial_size))
 
 
 def zip_broadcast(*objects, scalar_types=(str, bytes), strict=False):
@@ -4115,30 +4229,23 @@ def zip_broadcast(*objects, scalar_types=(str, bytes), strict=False):
     if not size:
         return
 
+    new_item = [None] * size
     iterables, iterable_positions = [], []
-    scalars, scalar_positions = [], []
     for i, obj in enumerate(objects):
         if is_scalar(obj):
-            scalars.append(obj)
-            scalar_positions.append(i)
+            new_item[i] = obj
         else:
             iterables.append(iter(obj))
             iterable_positions.append(i)
 
-    if len(scalars) == size:
+    if not iterables:
         yield tuple(objects)
         return
 
     zipper = _zip_equal if strict else zip
     for item in zipper(*iterables):
-        new_item = [None] * size
-
-        for i, elem in zip(iterable_positions, item):
-            new_item[i] = elem
-
-        for i, elem in zip(scalar_positions, scalars):
-            new_item[i] = elem
-
+        for i, new_item[i] in zip(iterable_positions, item):
+            pass
         yield tuple(new_item)
 
 
@@ -4163,22 +4270,23 @@ def unique_in_window(iterable, n, key=None):
         raise ValueError('n must be greater than 0')
 
     window = deque(maxlen=n)
-    uniques = set()
+    counts = defaultdict(int)
     use_key = key is not None
 
     for item in iterable:
+        if len(window) == n:
+            to_discard = window[0]
+            if counts[to_discard] == 1:
+                del counts[to_discard]
+            else:
+                counts[to_discard] -= 1
+
         k = key(item) if use_key else item
-        if k in uniques:
-            continue
-
-        if len(uniques) == n:
-            uniques.discard(window[0])
-
-        uniques.add(k)
+        if k not in counts:
+            yield item
+        counts[k] += 1
         window.append(k)
 
-        yield item
-
 
 def duplicates_everseen(iterable, key=None):
     """Yield duplicate elements after their first appearance.
@@ -4221,12 +4329,7 @@ def duplicates_justseen(iterable, key=None):
     This function is analagous to :func:`unique_justseen`.
 
     """
-    return flatten(
-        map(
-            lambda group_tuple: islice_extended(group_tuple[1])[1:],
-            groupby(iterable, key),
-        )
-    )
+    return flatten(g for _, g in groupby(iterable, key) for _ in g)
 
 
 def minmax(iterable_or_value, *others, key=None, default=_marker):
@@ -4390,3 +4493,77 @@ def gray_product(*iterables):
             o[j] = -o[j]
             f[j] = f[j + 1]
             f[j + 1] = j + 1
+
+
+def partial_product(*iterables):
+    """Yields tuples containing one item from each iterator, with subsequent
+    tuples changing a single item at a time by advancing each iterator until it
+    is exhausted. This sequence guarantees every value in each iterable is
+    output at least once without generating all possible combinations.
+
+    This may be useful, for example, when testing an expensive function.
+
+        >>> list(partial_product('AB', 'C', 'DEF'))
+        [('A', 'C', 'D'), ('B', 'C', 'D'), ('B', 'C', 'E'), ('B', 'C', 'F')]
+    """
+
+    iterators = list(map(iter, iterables))
+
+    try:
+        prod = [next(it) for it in iterators]
+    except StopIteration:
+        return
+    yield tuple(prod)
+
+    for i, it in enumerate(iterators):
+        for prod[i] in it:
+            yield tuple(prod)
+
+
+def takewhile_inclusive(predicate, iterable):
+    """A variant of :func:`takewhile` that yields one additional element.
+
+        >>> list(takewhile_inclusive(lambda x: x < 5, [1, 4, 6, 4, 1]))
+        [1, 4, 6]
+
+    :func:`takewhile` would return ``[1, 4]``.
+    """
+    for x in iterable:
+        if predicate(x):
+            yield x
+        else:
+            yield x
+            break
+
+
+def outer_product(func, xs, ys, *args, **kwargs):
+    """A generalized outer product that applies a binary function to all
+    pairs of items. Returns a 2D matrix with ``len(xs)`` rows and ``len(ys)``
+    columns.
+    Also accepts ``*args`` and ``**kwargs`` that are passed to ``func``.
+
+    Multiplication table:
+
+    >>> list(outer_product(mul, range(1, 4), range(1, 6)))
+    [(1, 2, 3, 4, 5), (2, 4, 6, 8, 10), (3, 6, 9, 12, 15)]
+
+    Cross tabulation:
+
+    >>> xs = ['A', 'B', 'A', 'A', 'B', 'B', 'A', 'A', 'B', 'B']
+    >>> ys = ['X', 'X', 'X', 'Y', 'Z', 'Z', 'Y', 'Y', 'Z', 'Z']
+    >>> rows = list(zip(xs, ys))
+    >>> count_rows = lambda x, y: rows.count((x, y))
+    >>> list(outer_product(count_rows, sorted(set(xs)), sorted(set(ys))))
+    [(2, 3, 0), (1, 0, 4)]
+
+    Usage with ``*args`` and ``**kwargs``:
+
+    >>> animals = ['cat', 'wolf', 'mouse']
+    >>> list(outer_product(min, animals, animals, key=len))
+    [('cat', 'cat', 'cat'), ('cat', 'wolf', 'wolf'), ('cat', 'wolf', 'mouse')]
+    """
+    ys = tuple(ys)
+    return batched(
+        starmap(lambda x, y: func(x, y, *args, **kwargs), product(xs, ys)),
+        n=len(ys),
+    )
diff --git a/lib/more_itertools/more.pyi b/lib/more_itertools/more.pyi
index 75c5232c..07bfc155 100644
--- a/lib/more_itertools/more.pyi
+++ b/lib/more_itertools/more.pyi
@@ -440,6 +440,7 @@ class seekable(Generic[_T], Iterator[_T]):
     def peek(self, default: _U) -> _T | _U: ...
     def elements(self) -> SequenceView[_T]: ...
     def seek(self, index: int) -> None: ...
+    def relative_seek(self, count: int) -> None: ...
 
 class run_length:
     @staticmethod
@@ -578,6 +579,9 @@ def all_unique(
     iterable: Iterable[_T], key: Callable[[_T], _U] | None = ...
 ) -> bool: ...
 def nth_product(index: int, *args: Iterable[_T]) -> tuple[_T, ...]: ...
+def nth_combination_with_replacement(
+    iterable: Iterable[_T], r: int, index: int
+) -> tuple[_T, ...]: ...
 def nth_permutation(
     iterable: Iterable[_T], r: int, index: int
 ) -> tuple[_T, ...]: ...
@@ -586,6 +590,9 @@ def product_index(element: Iterable[_T], *args: Iterable[_T]) -> int: ...
 def combination_index(
     element: Iterable[_T], iterable: Iterable[_T]
 ) -> int: ...
+def combination_with_replacement_index(
+    element: Iterable[_T], iterable: Iterable[_T]
+) -> int: ...
 def permutation_index(
     element: Iterable[_T], iterable: Iterable[_T]
 ) -> int: ...
@@ -664,3 +671,14 @@ def constrained_batches(
     strict: bool = ...,
 ) -> Iterator[tuple[_T]]: ...
 def gray_product(*iterables: Iterable[_T]) -> Iterator[tuple[_T, ...]]: ...
+def partial_product(*iterables: Iterable[_T]) -> Iterator[tuple[_T, ...]]: ...
+def takewhile_inclusive(
+    predicate: Callable[[_T], bool], iterable: Iterable[_T]
+) -> Iterator[_T]: ...
+def outer_product(
+    func: Callable[[_T, _U], _V],
+    xs: Iterable[_T],
+    ys: Iterable[_U],
+    *args: Any,
+    **kwargs: Any,
+) -> Iterator[tuple[_V, ...]]: ...
diff --git a/lib/more_itertools/recipes.py b/lib/more_itertools/recipes.py
index 3facc2e3..a0bdbece 100644
--- a/lib/more_itertools/recipes.py
+++ b/lib/more_itertools/recipes.py
@@ -9,11 +9,10 @@ Some backward-compatible usability improvements have been made.
 """
 import math
 import operator
-import warnings
 
 from collections import deque
 from collections.abc import Sized
-from functools import reduce
+from functools import partial, reduce
 from itertools import (
     chain,
     combinations,
@@ -29,7 +28,6 @@ from itertools import (
     zip_longest,
 )
 from random import randrange, sample, choice
-from sys import hexversion
 
 __all__ = [
     'all_equal',
@@ -52,7 +50,9 @@ __all__ = [
     'pad_none',
     'pairwise',
     'partition',
+    'polynomial_eval',
     'polynomial_from_roots',
+    'polynomial_derivative',
     'powerset',
     'prepend',
     'quantify',
@@ -65,6 +65,7 @@ __all__ = [
     'sieve',
     'sliding_window',
     'subslices',
+    'sum_of_squares',
     'tabulate',
     'tail',
     'take',
@@ -77,6 +78,18 @@ __all__ = [
 _marker = object()
 
 
+# zip with strict is available for Python 3.10+
+try:
+    zip(strict=True)
+except TypeError:
+    _zip_strict = zip
+else:
+    _zip_strict = partial(zip, strict=True)
+
+# math.sumprod is available for Python 3.12+
+_sumprod = getattr(math, 'sumprod', lambda x, y: dotproduct(x, y))
+
+
 def take(n, iterable):
     """Return first *n* items of the iterable as a list.
 
@@ -293,7 +306,7 @@ def _pairwise(iterable):
     """
     a, b = tee(iterable)
     next(b, None)
-    yield from zip(a, b)
+    return zip(a, b)
 
 
 try:
@@ -303,7 +316,7 @@ except ImportError:
 else:
 
     def pairwise(iterable):
-        yield from itertools_pairwise(iterable)
+        return itertools_pairwise(iterable)
 
     pairwise.__doc__ = _pairwise.__doc__
 
@@ -334,13 +347,9 @@ def _zip_equal(*iterables):
         for i, it in enumerate(iterables[1:], 1):
             size = len(it)
             if size != first_size:
-                break
-        else:
-            # If we didn't break out, we can use the built-in zip.
-            return zip(*iterables)
-
-        # If we did break out, there was a mismatch.
-        raise UnequalIterablesError(details=(first_size, i, size))
+                raise UnequalIterablesError(details=(first_size, i, size))
+        # All sizes are equal, we can use the built-in zip.
+        return zip(*iterables)
     # If any one of the iterables didn't have a length, start reading
     # them until one runs out.
     except TypeError:
@@ -433,12 +442,9 @@ def partition(pred, iterable):
     if pred is None:
         pred = bool
 
-    evaluations = ((pred(x), x) for x in iterable)
-    t1, t2 = tee(evaluations)
-    return (
-        (x for (cond, x) in t1 if not cond),
-        (x for (cond, x) in t2 if cond),
-    )
+    t1, t2, p = tee(iterable, 3)
+    p1, p2 = tee(map(pred, p))
+    return (compress(t1, map(operator.not_, p1)), compress(t2, p2))
 
 
 def powerset(iterable):
@@ -712,12 +718,14 @@ def convolve(signal, kernel):
     is immediately consumed and stored.
 
     """
+    # This implementation intentionally doesn't match the one in the itertools
+    # documentation.
     kernel = tuple(kernel)[::-1]
     n = len(kernel)
     window = deque([0], maxlen=n) * n
     for x in chain(signal, repeat(0, n - 1)):
         window.append(x)
-        yield sum(map(operator.mul, kernel, window))
+        yield _sumprod(kernel, window)
 
 
 def before_and_after(predicate, it):
@@ -778,9 +786,7 @@ def sliding_window(iterable, n):
     For a variant with more features, see :func:`windowed`.
     """
     it = iter(iterable)
-    window = deque(islice(it, n), maxlen=n)
-    if len(window) == n:
-        yield tuple(window)
+    window = deque(islice(it, n - 1), maxlen=n)
     for x in it:
         window.append(x)
         yield tuple(window)
@@ -807,12 +813,8 @@ def polynomial_from_roots(roots):
     >>> polynomial_from_roots(roots)  # x^3 - 4 * x^2 - 17 * x + 60
     [1, -4, -17, 60]
     """
-    # Use math.prod for Python 3.8+,
-    prod = getattr(math, 'prod', lambda x: reduce(operator.mul, x, 1))
-    roots = list(map(operator.neg, roots))
-    return [
-        sum(map(prod, combinations(roots, k))) for k in range(len(roots) + 1)
-    ]
+    factors = zip(repeat(1), map(operator.neg, roots))
+    return list(reduce(convolve, factors, [1]))
 
 
 def iter_index(iterable, value, start=0):
@@ -830,9 +832,13 @@ def iter_index(iterable, value, start=0):
     except AttributeError:
         # Slow path for general iterables
         it = islice(iterable, start, None)
-        for i, element in enumerate(it, start):
-            if element is value or element == value:
+        i = start - 1
+        try:
+            while True:
+                i = i + operator.indexOf(it, value) + 1
                 yield i
+        except ValueError:
+            pass
     else:
         # Fast path for sequences
         i = start - 1
@@ -850,43 +856,45 @@ def sieve(n):
     >>> list(sieve(30))
     [2, 3, 5, 7, 11, 13, 17, 19, 23, 29]
     """
-    isqrt = getattr(math, 'isqrt', lambda x: int(math.sqrt(x)))
     data = bytearray((0, 1)) * (n // 2)
     data[:3] = 0, 0, 0
-    limit = isqrt(n) + 1
+    limit = math.isqrt(n) + 1
     for p in compress(range(limit), data):
         data[p * p : n : p + p] = bytes(len(range(p * p, n, p + p)))
     data[2] = 1
     return iter_index(data, 1) if n > 2 else iter([])
 
 
-def batched(iterable, n):
+def _batched(iterable, n):
     """Batch data into lists of length *n*. The last batch may be shorter.
 
     >>> list(batched('ABCDEFG', 3))
-    [['A', 'B', 'C'], ['D', 'E', 'F'], ['G']]
+    [('A', 'B', 'C'), ('D', 'E', 'F'), ('G',)]
 
-    This recipe is from the ``itertools`` docs. This library also provides
-    :func:`chunked`, which has a different implementation.
+    On Python 3.12 and above, this is an alias for :func:`itertools.batched`.
     """
-    if hexversion >= 0x30C00A0:  # Python 3.12.0a0
-        warnings.warn(
-            (
-                'batched will be removed in a future version of '
-                'more-itertools. Use the standard library '
-                'itertools.batched function instead'
-            ),
-            DeprecationWarning,
-        )
-
+    if n < 1:
+        raise ValueError('n must be at least one')
     it = iter(iterable)
     while True:
-        batch = list(islice(it, n))
+        batch = tuple(islice(it, n))
         if not batch:
             break
         yield batch
 
 
+try:
+    from itertools import batched as itertools_batched
+except ImportError:
+    batched = _batched
+else:
+
+    def batched(iterable, n):
+        return itertools_batched(iterable, n)
+
+    batched.__doc__ = _batched.__doc__
+
+
 def transpose(it):
     """Swap the rows and columns of the input.
 
@@ -894,21 +902,21 @@ def transpose(it):
     [(1, 11), (2, 22), (3, 33)]
 
     The caller should ensure that the dimensions of the input are compatible.
+    If the input is empty, no output will be produced.
     """
-    # TODO: when 3.9 goes end-of-life, add stric=True to this.
-    return zip(*it)
+    return _zip_strict(*it)
 
 
 def matmul(m1, m2):
     """Multiply two matrices.
     >>> list(matmul([(7, 5), (3, 5)], [(2, 5), (7, 9)]))
-    [[49, 80], [41, 60]]
+    [(49, 80), (41, 60)]
 
     The caller should ensure that the dimensions of the input matrices are
     compatible with each other.
     """
     n = len(m2[0])
-    return batched(starmap(dotproduct, product(m1, transpose(m2))), n)
+    return batched(starmap(_sumprod, product(m1, transpose(m2))), n)
 
 
 def factor(n):
@@ -916,15 +924,54 @@ def factor(n):
     >>> list(factor(360))
     [2, 2, 2, 3, 3, 5]
     """
-    isqrt = getattr(math, 'isqrt', lambda x: int(math.sqrt(x)))
-    for prime in sieve(isqrt(n) + 1):
+    for prime in sieve(math.isqrt(n) + 1):
         while True:
-            quotient, remainder = divmod(n, prime)
-            if remainder:
+            if n % prime:
                 break
             yield prime
-            n = quotient
+            n //= prime
             if n == 1:
                 return
-    if n >= 2:
+    if n > 1:
         yield n
+
+
+def polynomial_eval(coefficients, x):
+    """Evaluate a polynomial at a specific value.
+
+    Example: evaluating x^3 - 4 * x^2 - 17 * x + 60 at x = 2.5:
+
+    >>> coefficients = [1, -4, -17, 60]
+    >>> x = 2.5
+    >>> polynomial_eval(coefficients, x)
+    8.125
+    """
+    n = len(coefficients)
+    if n == 0:
+        return x * 0  # coerce zero to the type of x
+    powers = map(pow, repeat(x), reversed(range(n)))
+    return _sumprod(coefficients, powers)
+
+
+def sum_of_squares(it):
+    """Return the sum of the squares of the input values.
+
+    >>> sum_of_squares([10, 20, 30])
+    1400
+    """
+    return _sumprod(*tee(it))
+
+
+def polynomial_derivative(coefficients):
+    """Compute the first derivative of a polynomial.
+
+    Example: evaluating the derivative of x^3 - 4 * x^2 - 17 * x + 60
+
+    >>> coefficients = [1, -4, -17, 60]
+    >>> derivative_coefficients = polynomial_derivative(coefficients)
+    >>> derivative_coefficients
+    [3, -8, -17]
+    """
+    n = len(coefficients)
+    powers = reversed(range(1, n))
+    return list(map(operator.mul, coefficients, powers))
diff --git a/lib/more_itertools/recipes.pyi b/lib/more_itertools/recipes.pyi
index 0267ed56..ef883864 100644
--- a/lib/more_itertools/recipes.pyi
+++ b/lib/more_itertools/recipes.pyi
@@ -21,7 +21,7 @@ def tabulate(
     function: Callable[[int], _T], start: int = ...
 ) -> Iterator[_T]: ...
 def tail(n: int, iterable: Iterable[_T]) -> Iterator[_T]: ...
-def consume(iterator: Iterable[object], n: int | None = ...) -> None: ...
+def consume(iterator: Iterable[_T], n: int | None = ...) -> None: ...
 @overload
 def nth(iterable: Iterable[_T], n: int) -> _T | None: ...
 @overload
@@ -101,7 +101,7 @@ def sliding_window(
     iterable: Iterable[_T], n: int
 ) -> Iterator[tuple[_T, ...]]: ...
 def subslices(iterable: Iterable[_T]) -> Iterator[list[_T]]: ...
-def polynomial_from_roots(roots: Sequence[int]) -> list[int]: ...
+def polynomial_from_roots(roots: Sequence[_T]) -> list[_T]: ...
 def iter_index(
     iterable: Iterable[object],
     value: Any,
@@ -111,9 +111,12 @@ def sieve(n: int) -> Iterator[int]: ...
 def batched(
     iterable: Iterable[_T],
     n: int,
-) -> Iterator[list[_T]]: ...
+) -> Iterator[tuple[_T]]: ...
 def transpose(
     it: Iterable[Iterable[_T]],
-) -> tuple[Iterator[_T], ...]: ...
-def matmul(m1: Sequence[_T], m2: Sequence[_T]) -> Iterator[list[_T]]: ...
+) -> Iterator[tuple[_T, ...]]: ...
+def matmul(m1: Sequence[_T], m2: Sequence[_T]) -> Iterator[tuple[_T]]: ...
 def factor(n: int) -> Iterator[int]: ...
+def polynomial_eval(coefficients: Sequence[_T], x: _U) -> _U: ...
+def sum_of_squares(it: Iterable[_T]) -> _T: ...
+def polynomial_derivative(coefficients: Sequence[_T]) -> list[_T]: ...
diff --git a/lib/tempora/__init__.py b/lib/tempora/__init__.py
index 27d5e828..b2690a74 100644
--- a/lib/tempora/__init__.py
+++ b/lib/tempora/__init__.py
@@ -383,9 +383,9 @@ def parse_timedelta(str):
     Note that months and years strict intervals, not aligned
     to a calendar:
 
-    >>> now = datetime.datetime.now()
-    >>> later = now + parse_timedelta('1 year')
-    >>> diff = later.replace(year=now.year) - now
+    >>> date = datetime.datetime.fromisoformat('2000-01-01')
+    >>> later = date + parse_timedelta('1 year')
+    >>> diff = later.replace(year=date.year) - date
     >>> diff.seconds
     20940
 
diff --git a/lib/tempora/schedule.py b/lib/tempora/schedule.py
index b6ad8aac..49c70b10 100644
--- a/lib/tempora/schedule.py
+++ b/lib/tempora/schedule.py
@@ -28,7 +28,7 @@ def now():
     A client may override this function to change the default behavior,
     such as to use local time or timezone-naïve times.
     """
-    return datetime.datetime.utcnow().replace(tzinfo=pytz.utc)
+    return datetime.datetime.now(pytz.utc)
 
 
 def from_timestamp(ts):
@@ -38,7 +38,7 @@ def from_timestamp(ts):
     A client may override this function to change the default behavior,
     such as to use local time or timezone-naïve times.
     """
-    return datetime.datetime.utcfromtimestamp(ts).replace(tzinfo=pytz.utc)
+    return datetime.datetime.fromtimestamp(ts, pytz.utc)
 
 
 class DelayedCommand(datetime.datetime):
diff --git a/lib/tempora/timing.py b/lib/tempora/timing.py
index c43a3d94..aed0d336 100644
--- a/lib/tempora/timing.py
+++ b/lib/tempora/timing.py
@@ -48,20 +48,21 @@ class Stopwatch:
     def reset(self):
         self.elapsed = datetime.timedelta(0)
         with contextlib.suppress(AttributeError):
-            del self.start_time
+            del self._start
+
+    def _diff(self):
+        return datetime.timedelta(seconds=time.monotonic() - self._start)
 
     def start(self):
-        self.start_time = datetime.datetime.utcnow()
+        self._start = time.monotonic()
 
     def stop(self):
-        stop_time = datetime.datetime.utcnow()
-        self.elapsed += stop_time - self.start_time
-        del self.start_time
+        self.elapsed += self._diff()
+        del self._start
         return self.elapsed
 
     def split(self):
-        local_duration = datetime.datetime.utcnow() - self.start_time
-        return self.elapsed + local_duration
+        return self.elapsed + self._diff()
 
     # context manager support
     def __enter__(self):
diff --git a/requirements.txt b/requirements.txt
index 94849c2e..8215a2b8 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -41,7 +41,7 @@ requests-oauthlib==1.3.1
 rumps==0.4.0; platform_system == "Darwin"
 simplejson==3.19.1
 six==1.16.0
-tempora==5.2.1
+tempora==5.5.0
 tokenize-rt==5.0.0
 tzdata==2023.3
 tzlocal==4.2

From 77f38bbf93580a3287537a3ebfd9b4e47c09a02a Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 23 Aug 2023 21:44:36 -0700
Subject: [PATCH 430/743] Bump urllib3 from 1.26.15 to 2.0.4 (#2113)

* Bump urllib3 from 1.26.15 to 2.0.4

Bumps [urllib3](https://github.com/urllib3/urllib3) from 1.26.15 to 2.0.4.
- [Release notes](https://github.com/urllib3/urllib3/releases)
- [Changelog](https://github.com/urllib3/urllib3/blob/main/CHANGES.rst)
- [Commits](https://github.com/urllib3/urllib3/compare/1.26.15...2.0.4)

---
updated-dependencies:
- dependency-name: urllib3
  dependency-type: direct:production
  update-type: version-update:semver-major
...

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

* Update urllib3==2.0.4

---------

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

[skip ci]
---
 requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements.txt b/requirements.txt
index 8215a2b8..755f9a21 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -45,7 +45,7 @@ tempora==5.5.0
 tokenize-rt==5.0.0
 tzdata==2023.3
 tzlocal==4.2
-urllib3==1.26.15
+urllib3==2.0.4
 webencodings==0.5.1
 websocket-client==1.5.1
 xmltodict==0.13.0

From c93f470371c41a7f87792078507875db0333dedd Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 23 Aug 2023 21:45:15 -0700
Subject: [PATCH 431/743] Bump pyjwt from 2.6.0 to 2.8.0 (#2115)

* Bump pyjwt from 2.6.0 to 2.8.0

Bumps [pyjwt](https://github.com/jpadilla/pyjwt) from 2.6.0 to 2.8.0.
- [Release notes](https://github.com/jpadilla/pyjwt/releases)
- [Changelog](https://github.com/jpadilla/pyjwt/blob/master/CHANGELOG.rst)
- [Commits](https://github.com/jpadilla/pyjwt/compare/2.6.0...2.8.0)

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

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

* Update pyjwt==2.8.0

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/jwt/__init__.py      |   4 +-
 lib/jwt/algorithms.py    | 420 ++++++++++++++++++++++++++-------------
 lib/jwt/api_jwk.py       |  41 ++--
 lib/jwt/api_jws.py       |  49 +++--
 lib/jwt/api_jwt.py       | 205 +++++++++++++------
 lib/jwt/exceptions.py    |   8 +-
 lib/jwt/help.py          |   8 +-
 lib/jwt/jwk_set_cache.py |   5 +-
 lib/jwt/jwks_client.py   |  27 ++-
 lib/jwt/types.py         |   5 +
 lib/jwt/utils.py         |  28 ++-
 requirements.txt         |   2 +-
 12 files changed, 542 insertions(+), 260 deletions(-)
 create mode 100644 lib/jwt/types.py

diff --git a/lib/jwt/__init__.py b/lib/jwt/__init__.py
index 26c79b24..68d09c1c 100644
--- a/lib/jwt/__init__.py
+++ b/lib/jwt/__init__.py
@@ -19,6 +19,7 @@ from .exceptions import (
     InvalidSignatureError,
     InvalidTokenError,
     MissingRequiredClaimError,
+    PyJWKClientConnectionError,
     PyJWKClientError,
     PyJWKError,
     PyJWKSetError,
@@ -26,7 +27,7 @@ from .exceptions import (
 )
 from .jwks_client import PyJWKClient
 
-__version__ = "2.6.0"
+__version__ = "2.8.0"
 
 __title__ = "PyJWT"
 __description__ = "JSON Web Token implementation in Python"
@@ -65,6 +66,7 @@ __all__ = [
     "InvalidSignatureError",
     "InvalidTokenError",
     "MissingRequiredClaimError",
+    "PyJWKClientConnectionError",
     "PyJWKClientError",
     "PyJWKError",
     "PyJWKSetError",
diff --git a/lib/jwt/algorithms.py b/lib/jwt/algorithms.py
index 93fadf4c..ed187152 100644
--- a/lib/jwt/algorithms.py
+++ b/lib/jwt/algorithms.py
@@ -1,8 +1,14 @@
+from __future__ import annotations
+
 import hashlib
 import hmac
 import json
+import sys
+from abc import ABC, abstractmethod
+from typing import TYPE_CHECKING, Any, ClassVar, NoReturn, Union, cast, overload
 
 from .exceptions import InvalidKeyError
+from .types import HashlibHash, JWKDict
 from .utils import (
     base64url_decode,
     base64url_encode,
@@ -15,14 +21,28 @@ from .utils import (
     to_base64url_uint,
 )
 
+if sys.version_info >= (3, 8):
+    from typing import Literal
+else:
+    from typing_extensions import Literal
+
+
 try:
-    import cryptography.exceptions
     from cryptography.exceptions import InvalidSignature
+    from cryptography.hazmat.backends import default_backend
     from cryptography.hazmat.primitives import hashes
-    from cryptography.hazmat.primitives.asymmetric import ec, padding
+    from cryptography.hazmat.primitives.asymmetric import padding
     from cryptography.hazmat.primitives.asymmetric.ec import (
+        ECDSA,
+        SECP256K1,
+        SECP256R1,
+        SECP384R1,
+        SECP521R1,
+        EllipticCurve,
         EllipticCurvePrivateKey,
+        EllipticCurvePrivateNumbers,
         EllipticCurvePublicKey,
+        EllipticCurvePublicNumbers,
     )
     from cryptography.hazmat.primitives.asymmetric.ed448 import (
         Ed448PrivateKey,
@@ -56,6 +76,23 @@ try:
 except ModuleNotFoundError:
     has_crypto = False
 
+
+if TYPE_CHECKING:
+    # Type aliases for convenience in algorithms method signatures
+    AllowedRSAKeys = RSAPrivateKey | RSAPublicKey
+    AllowedECKeys = EllipticCurvePrivateKey | EllipticCurvePublicKey
+    AllowedOKPKeys = (
+        Ed25519PrivateKey | Ed25519PublicKey | Ed448PrivateKey | Ed448PublicKey
+    )
+    AllowedKeys = AllowedRSAKeys | AllowedECKeys | AllowedOKPKeys
+    AllowedPrivateKeys = (
+        RSAPrivateKey | EllipticCurvePrivateKey | Ed25519PrivateKey | Ed448PrivateKey
+    )
+    AllowedPublicKeys = (
+        RSAPublicKey | EllipticCurvePublicKey | Ed25519PublicKey | Ed448PublicKey
+    )
+
+
 requires_cryptography = {
     "RS256",
     "RS384",
@@ -72,7 +109,7 @@ requires_cryptography = {
 }
 
 
-def get_default_algorithms():
+def get_default_algorithms() -> dict[str, Algorithm]:
     """
     Returns the algorithms that are implemented by the library.
     """
@@ -106,45 +143,79 @@ def get_default_algorithms():
     return default_algorithms
 
 
-class Algorithm:
+class Algorithm(ABC):
     """
     The interface for an algorithm used to sign and verify tokens.
     """
 
-    def prepare_key(self, key):
+    def compute_hash_digest(self, bytestr: bytes) -> bytes:
+        """
+        Compute a hash digest using the specified algorithm's hash algorithm.
+
+        If there is no hash algorithm, raises a NotImplementedError.
+        """
+        # lookup self.hash_alg if defined in a way that mypy can understand
+        hash_alg = getattr(self, "hash_alg", None)
+        if hash_alg is None:
+            raise NotImplementedError
+
+        if (
+            has_crypto
+            and isinstance(hash_alg, type)
+            and issubclass(hash_alg, hashes.HashAlgorithm)
+        ):
+            digest = hashes.Hash(hash_alg(), backend=default_backend())
+            digest.update(bytestr)
+            return bytes(digest.finalize())
+        else:
+            return bytes(hash_alg(bytestr).digest())
+
+    @abstractmethod
+    def prepare_key(self, key: Any) -> Any:
         """
         Performs necessary validation and conversions on the key and returns
         the key value in the proper format for sign() and verify().
         """
-        raise NotImplementedError
 
-    def sign(self, msg, key):
+    @abstractmethod
+    def sign(self, msg: bytes, key: Any) -> bytes:
         """
         Returns a digital signature for the specified message
         using the specified key value.
         """
-        raise NotImplementedError
 
-    def verify(self, msg, key, sig):
+    @abstractmethod
+    def verify(self, msg: bytes, key: Any, sig: bytes) -> bool:
         """
         Verifies that the specified digital signature is valid
         for the specified message and key values.
         """
-        raise NotImplementedError
+
+    @overload
+    @staticmethod
+    @abstractmethod
+    def to_jwk(key_obj, as_dict: Literal[True]) -> JWKDict:
+        ...  # pragma: no cover
+
+    @overload
+    @staticmethod
+    @abstractmethod
+    def to_jwk(key_obj, as_dict: Literal[False] = False) -> str:
+        ...  # pragma: no cover
 
     @staticmethod
-    def to_jwk(key_obj):
+    @abstractmethod
+    def to_jwk(key_obj, as_dict: bool = False) -> Union[JWKDict, str]:
         """
-        Serializes a given RSA key into a JWK
+        Serializes a given key into a JWK
         """
-        raise NotImplementedError
 
     @staticmethod
-    def from_jwk(jwk):
+    @abstractmethod
+    def from_jwk(jwk: str | JWKDict) -> Any:
         """
-        Deserializes a given RSA key from JWK back into a PublicKey or PrivateKey object
+        Deserializes a given key from JWK back into a key object
         """
-        raise NotImplementedError
 
 
 class NoneAlgorithm(Algorithm):
@@ -153,7 +224,7 @@ class NoneAlgorithm(Algorithm):
     operations are required.
     """
 
-    def prepare_key(self, key):
+    def prepare_key(self, key: str | None) -> None:
         if key == "":
             key = None
 
@@ -162,12 +233,20 @@ class NoneAlgorithm(Algorithm):
 
         return key
 
-    def sign(self, msg, key):
+    def sign(self, msg: bytes, key: None) -> bytes:
         return b""
 
-    def verify(self, msg, key, sig):
+    def verify(self, msg: bytes, key: None, sig: bytes) -> bool:
         return False
 
+    @staticmethod
+    def to_jwk(key_obj: Any, as_dict: bool = False) -> NoReturn:
+        raise NotImplementedError()
+
+    @staticmethod
+    def from_jwk(jwk: str | JWKDict) -> NoReturn:
+        raise NotImplementedError()
+
 
 class HMACAlgorithm(Algorithm):
     """
@@ -175,38 +254,51 @@ class HMACAlgorithm(Algorithm):
     and the specified hash function.
     """
 
-    SHA256 = hashlib.sha256
-    SHA384 = hashlib.sha384
-    SHA512 = hashlib.sha512
+    SHA256: ClassVar[HashlibHash] = hashlib.sha256
+    SHA384: ClassVar[HashlibHash] = hashlib.sha384
+    SHA512: ClassVar[HashlibHash] = hashlib.sha512
 
-    def __init__(self, hash_alg):
+    def __init__(self, hash_alg: HashlibHash) -> None:
         self.hash_alg = hash_alg
 
-    def prepare_key(self, key):
-        key = force_bytes(key)
+    def prepare_key(self, key: str | bytes) -> bytes:
+        key_bytes = force_bytes(key)
 
-        if is_pem_format(key) or is_ssh_key(key):
+        if is_pem_format(key_bytes) or is_ssh_key(key_bytes):
             raise InvalidKeyError(
                 "The specified key is an asymmetric key or x509 certificate and"
                 " should not be used as an HMAC secret."
             )
 
-        return key
+        return key_bytes
+
+    @overload
+    @staticmethod
+    def to_jwk(key_obj: str | bytes, as_dict: Literal[True]) -> JWKDict:
+        ...  # pragma: no cover
+
+    @overload
+    @staticmethod
+    def to_jwk(key_obj: str | bytes, as_dict: Literal[False] = False) -> str:
+        ...  # pragma: no cover
 
     @staticmethod
-    def to_jwk(key_obj):
-        return json.dumps(
-            {
-                "k": base64url_encode(force_bytes(key_obj)).decode(),
-                "kty": "oct",
-            }
-        )
+    def to_jwk(key_obj: str | bytes, as_dict: bool = False) -> Union[JWKDict, str]:
+        jwk = {
+            "k": base64url_encode(force_bytes(key_obj)).decode(),
+            "kty": "oct",
+        }
+
+        if as_dict:
+            return jwk
+        else:
+            return json.dumps(jwk)
 
     @staticmethod
-    def from_jwk(jwk):
+    def from_jwk(jwk: str | JWKDict) -> bytes:
         try:
             if isinstance(jwk, str):
-                obj = json.loads(jwk)
+                obj: JWKDict = json.loads(jwk)
             elif isinstance(jwk, dict):
                 obj = jwk
             else:
@@ -219,10 +311,10 @@ class HMACAlgorithm(Algorithm):
 
         return base64url_decode(obj["k"])
 
-    def sign(self, msg, key):
+    def sign(self, msg: bytes, key: bytes) -> bytes:
         return hmac.new(key, msg, self.hash_alg).digest()
 
-    def verify(self, msg, key, sig):
+    def verify(self, msg: bytes, key: bytes, sig: bytes) -> bool:
         return hmac.compare_digest(sig, self.sign(msg, key))
 
 
@@ -234,36 +326,49 @@ if has_crypto:
         RSASSA-PKCS-v1_5 and the specified hash function.
         """
 
-        SHA256 = hashes.SHA256
-        SHA384 = hashes.SHA384
-        SHA512 = hashes.SHA512
+        SHA256: ClassVar[type[hashes.HashAlgorithm]] = hashes.SHA256
+        SHA384: ClassVar[type[hashes.HashAlgorithm]] = hashes.SHA384
+        SHA512: ClassVar[type[hashes.HashAlgorithm]] = hashes.SHA512
 
-        def __init__(self, hash_alg):
+        def __init__(self, hash_alg: type[hashes.HashAlgorithm]) -> None:
             self.hash_alg = hash_alg
 
-        def prepare_key(self, key):
+        def prepare_key(self, key: AllowedRSAKeys | str | bytes) -> AllowedRSAKeys:
             if isinstance(key, (RSAPrivateKey, RSAPublicKey)):
                 return key
 
             if not isinstance(key, (bytes, str)):
                 raise TypeError("Expecting a PEM-formatted key.")
 
-            key = force_bytes(key)
+            key_bytes = force_bytes(key)
 
             try:
-                if key.startswith(b"ssh-rsa"):
-                    key = load_ssh_public_key(key)
+                if key_bytes.startswith(b"ssh-rsa"):
+                    return cast(RSAPublicKey, load_ssh_public_key(key_bytes))
                 else:
-                    key = load_pem_private_key(key, password=None)
+                    return cast(
+                        RSAPrivateKey, load_pem_private_key(key_bytes, password=None)
+                    )
             except ValueError:
-                key = load_pem_public_key(key)
-            return key
+                return cast(RSAPublicKey, load_pem_public_key(key_bytes))
+
+        @overload
+        @staticmethod
+        def to_jwk(key_obj: AllowedRSAKeys, as_dict: Literal[True]) -> JWKDict:
+            ...  # pragma: no cover
+
+        @overload
+        @staticmethod
+        def to_jwk(key_obj: AllowedRSAKeys, as_dict: Literal[False] = False) -> str:
+            ...  # pragma: no cover
 
         @staticmethod
-        def to_jwk(key_obj):
-            obj = None
+        def to_jwk(
+            key_obj: AllowedRSAKeys, as_dict: bool = False
+        ) -> Union[JWKDict, str]:
+            obj: dict[str, Any] | None = None
 
-            if getattr(key_obj, "private_numbers", None):
+            if hasattr(key_obj, "private_numbers"):
                 # Private key
                 numbers = key_obj.private_numbers()
 
@@ -280,7 +385,7 @@ if has_crypto:
                     "qi": to_base64url_uint(numbers.iqmp).decode(),
                 }
 
-            elif getattr(key_obj, "verify", None):
+            elif hasattr(key_obj, "verify"):
                 # Public key
                 numbers = key_obj.public_numbers()
 
@@ -293,10 +398,13 @@ if has_crypto:
             else:
                 raise InvalidKeyError("Not a public or private key")
 
-            return json.dumps(obj)
+            if as_dict:
+                return obj
+            else:
+                return json.dumps(obj)
 
         @staticmethod
-        def from_jwk(jwk):
+        def from_jwk(jwk: str | JWKDict) -> AllowedRSAKeys:
             try:
                 if isinstance(jwk, str):
                     obj = json.loads(jwk)
@@ -360,19 +468,17 @@ if has_crypto:
                 return numbers.private_key()
             elif "n" in obj and "e" in obj:
                 # Public key
-                numbers = RSAPublicNumbers(
+                return RSAPublicNumbers(
                     from_base64url_uint(obj["e"]),
                     from_base64url_uint(obj["n"]),
-                )
-
-                return numbers.public_key()
+                ).public_key()
             else:
                 raise InvalidKeyError("Not a public or private key")
 
-        def sign(self, msg, key):
+        def sign(self, msg: bytes, key: RSAPrivateKey) -> bytes:
             return key.sign(msg, padding.PKCS1v15(), self.hash_alg())
 
-        def verify(self, msg, key, sig):
+        def verify(self, msg: bytes, key: RSAPublicKey, sig: bytes) -> bool:
             try:
                 key.verify(sig, msg, padding.PKCS1v15(), self.hash_alg())
                 return True
@@ -385,63 +491,79 @@ if has_crypto:
         ECDSA and the specified hash function
         """
 
-        SHA256 = hashes.SHA256
-        SHA384 = hashes.SHA384
-        SHA512 = hashes.SHA512
+        SHA256: ClassVar[type[hashes.HashAlgorithm]] = hashes.SHA256
+        SHA384: ClassVar[type[hashes.HashAlgorithm]] = hashes.SHA384
+        SHA512: ClassVar[type[hashes.HashAlgorithm]] = hashes.SHA512
 
-        def __init__(self, hash_alg):
+        def __init__(self, hash_alg: type[hashes.HashAlgorithm]) -> None:
             self.hash_alg = hash_alg
 
-        def prepare_key(self, key):
+        def prepare_key(self, key: AllowedECKeys | str | bytes) -> AllowedECKeys:
             if isinstance(key, (EllipticCurvePrivateKey, EllipticCurvePublicKey)):
                 return key
 
             if not isinstance(key, (bytes, str)):
                 raise TypeError("Expecting a PEM-formatted key.")
 
-            key = force_bytes(key)
+            key_bytes = force_bytes(key)
 
             # Attempt to load key. We don't know if it's
             # a Signing Key or a Verifying Key, so we try
             # the Verifying Key first.
             try:
-                if key.startswith(b"ecdsa-sha2-"):
-                    key = load_ssh_public_key(key)
+                if key_bytes.startswith(b"ecdsa-sha2-"):
+                    crypto_key = load_ssh_public_key(key_bytes)
                 else:
-                    key = load_pem_public_key(key)
+                    crypto_key = load_pem_public_key(key_bytes)  # type: ignore[assignment]
             except ValueError:
-                key = load_pem_private_key(key, password=None)
+                crypto_key = load_pem_private_key(key_bytes, password=None)  # type: ignore[assignment]
 
             # Explicit check the key to prevent confusing errors from cryptography
-            if not isinstance(key, (EllipticCurvePrivateKey, EllipticCurvePublicKey)):
+            if not isinstance(
+                crypto_key, (EllipticCurvePrivateKey, EllipticCurvePublicKey)
+            ):
                 raise InvalidKeyError(
                     "Expecting a EllipticCurvePrivateKey/EllipticCurvePublicKey. Wrong key provided for ECDSA algorithms"
                 )
 
-            return key
+            return crypto_key
 
-        def sign(self, msg, key):
-            der_sig = key.sign(msg, ec.ECDSA(self.hash_alg()))
+        def sign(self, msg: bytes, key: EllipticCurvePrivateKey) -> bytes:
+            der_sig = key.sign(msg, ECDSA(self.hash_alg()))
 
             return der_to_raw_signature(der_sig, key.curve)
 
-        def verify(self, msg, key, sig):
+        def verify(self, msg: bytes, key: "AllowedECKeys", sig: bytes) -> bool:
             try:
                 der_sig = raw_to_der_signature(sig, key.curve)
             except ValueError:
                 return False
 
             try:
-                if isinstance(key, EllipticCurvePrivateKey):
-                    key = key.public_key()
-                key.verify(der_sig, msg, ec.ECDSA(self.hash_alg()))
+                public_key = (
+                    key.public_key()
+                    if isinstance(key, EllipticCurvePrivateKey)
+                    else key
+                )
+                public_key.verify(der_sig, msg, ECDSA(self.hash_alg()))
                 return True
             except InvalidSignature:
                 return False
 
+        @overload
         @staticmethod
-        def to_jwk(key_obj):
+        def to_jwk(key_obj: AllowedECKeys, as_dict: Literal[True]) -> JWKDict:
+            ...  # pragma: no cover
 
+        @overload
+        @staticmethod
+        def to_jwk(key_obj: AllowedECKeys, as_dict: Literal[False] = False) -> str:
+            ...  # pragma: no cover
+
+        @staticmethod
+        def to_jwk(
+            key_obj: AllowedECKeys, as_dict: bool = False
+        ) -> Union[JWKDict, str]:
             if isinstance(key_obj, EllipticCurvePrivateKey):
                 public_numbers = key_obj.public_key().public_numbers()
             elif isinstance(key_obj, EllipticCurvePublicKey):
@@ -449,18 +571,18 @@ if has_crypto:
             else:
                 raise InvalidKeyError("Not a public or private key")
 
-            if isinstance(key_obj.curve, ec.SECP256R1):
+            if isinstance(key_obj.curve, SECP256R1):
                 crv = "P-256"
-            elif isinstance(key_obj.curve, ec.SECP384R1):
+            elif isinstance(key_obj.curve, SECP384R1):
                 crv = "P-384"
-            elif isinstance(key_obj.curve, ec.SECP521R1):
+            elif isinstance(key_obj.curve, SECP521R1):
                 crv = "P-521"
-            elif isinstance(key_obj.curve, ec.SECP256K1):
+            elif isinstance(key_obj.curve, SECP256K1):
                 crv = "secp256k1"
             else:
                 raise InvalidKeyError(f"Invalid curve: {key_obj.curve}")
 
-            obj = {
+            obj: dict[str, Any] = {
                 "kty": "EC",
                 "crv": crv,
                 "x": to_base64url_uint(public_numbers.x).decode(),
@@ -472,10 +594,13 @@ if has_crypto:
                     key_obj.private_numbers().private_value
                 ).decode()
 
-            return json.dumps(obj)
+            if as_dict:
+                return obj
+            else:
+                return json.dumps(obj)
 
         @staticmethod
-        def from_jwk(jwk):
+        def from_jwk(jwk: str | JWKDict) -> AllowedECKeys:
             try:
                 if isinstance(jwk, str):
                     obj = json.loads(jwk)
@@ -496,24 +621,26 @@ if has_crypto:
             y = base64url_decode(obj.get("y"))
 
             curve = obj.get("crv")
+            curve_obj: EllipticCurve
+
             if curve == "P-256":
                 if len(x) == len(y) == 32:
-                    curve_obj = ec.SECP256R1()
+                    curve_obj = SECP256R1()
                 else:
                     raise InvalidKeyError("Coords should be 32 bytes for curve P-256")
             elif curve == "P-384":
                 if len(x) == len(y) == 48:
-                    curve_obj = ec.SECP384R1()
+                    curve_obj = SECP384R1()
                 else:
                     raise InvalidKeyError("Coords should be 48 bytes for curve P-384")
             elif curve == "P-521":
                 if len(x) == len(y) == 66:
-                    curve_obj = ec.SECP521R1()
+                    curve_obj = SECP521R1()
                 else:
                     raise InvalidKeyError("Coords should be 66 bytes for curve P-521")
             elif curve == "secp256k1":
                 if len(x) == len(y) == 32:
-                    curve_obj = ec.SECP256K1()
+                    curve_obj = SECP256K1()
                 else:
                     raise InvalidKeyError(
                         "Coords should be 32 bytes for curve secp256k1"
@@ -521,7 +648,7 @@ if has_crypto:
             else:
                 raise InvalidKeyError(f"Invalid curve: {curve}")
 
-            public_numbers = ec.EllipticCurvePublicNumbers(
+            public_numbers = EllipticCurvePublicNumbers(
                 x=int.from_bytes(x, byteorder="big"),
                 y=int.from_bytes(y, byteorder="big"),
                 curve=curve_obj,
@@ -536,7 +663,7 @@ if has_crypto:
                     "D should be {} bytes for curve {}", len(x), curve
                 )
 
-            return ec.EllipticCurvePrivateNumbers(
+            return EllipticCurvePrivateNumbers(
                 int.from_bytes(d, byteorder="big"), public_numbers
             ).private_key()
 
@@ -545,24 +672,24 @@ if has_crypto:
         Performs a signature using RSASSA-PSS with MGF1
         """
 
-        def sign(self, msg, key):
+        def sign(self, msg: bytes, key: RSAPrivateKey) -> bytes:
             return key.sign(
                 msg,
                 padding.PSS(
                     mgf=padding.MGF1(self.hash_alg()),
-                    salt_length=self.hash_alg.digest_size,
+                    salt_length=self.hash_alg().digest_size,
                 ),
                 self.hash_alg(),
             )
 
-        def verify(self, msg, key, sig):
+        def verify(self, msg: bytes, key: RSAPublicKey, sig: bytes) -> bool:
             try:
                 key.verify(
                     sig,
                     msg,
                     padding.PSS(
                         mgf=padding.MGF1(self.hash_alg()),
-                        salt_length=self.hash_alg.digest_size,
+                        salt_length=self.hash_alg().digest_size,
                     ),
                     self.hash_alg(),
                 )
@@ -577,21 +704,20 @@ if has_crypto:
         This class requires ``cryptography>=2.6`` to be installed.
         """
 
-        def __init__(self, **kwargs):
+        def __init__(self, **kwargs: Any) -> None:
             pass
 
-        def prepare_key(self, key):
+        def prepare_key(self, key: AllowedOKPKeys | str | bytes) -> AllowedOKPKeys:
             if isinstance(key, (bytes, str)):
-                if isinstance(key, str):
-                    key = key.encode("utf-8")
-                str_key = key.decode("utf-8")
+                key_str = key.decode("utf-8") if isinstance(key, bytes) else key
+                key_bytes = key.encode("utf-8") if isinstance(key, str) else key
 
-                if "-----BEGIN PUBLIC" in str_key:
-                    key = load_pem_public_key(key)
-                elif "-----BEGIN PRIVATE" in str_key:
-                    key = load_pem_private_key(key, password=None)
-                elif str_key[0:4] == "ssh-":
-                    key = load_ssh_public_key(key)
+                if "-----BEGIN PUBLIC" in key_str:
+                    key = load_pem_public_key(key_bytes)  # type: ignore[assignment]
+                elif "-----BEGIN PRIVATE" in key_str:
+                    key = load_pem_private_key(key_bytes, password=None)  # type: ignore[assignment]
+                elif key_str[0:4] == "ssh-":
+                    key = load_ssh_public_key(key_bytes)  # type: ignore[assignment]
 
             # Explicit check the key to prevent confusing errors from cryptography
             if not isinstance(
@@ -604,7 +730,9 @@ if has_crypto:
 
             return key
 
-        def sign(self, msg, key):
+        def sign(
+            self, msg: str | bytes, key: Ed25519PrivateKey | Ed448PrivateKey
+        ) -> bytes:
             """
             Sign a message ``msg`` using the EdDSA private key ``key``
             :param str|bytes msg: Message to sign
@@ -612,10 +740,12 @@ if has_crypto:
                 or :class:`.Ed448PrivateKey` isinstance
             :return bytes signature: The signature, as bytes
             """
-            msg = bytes(msg, "utf-8") if type(msg) is not bytes else msg
-            return key.sign(msg)
+            msg_bytes = msg.encode("utf-8") if isinstance(msg, str) else msg
+            return key.sign(msg_bytes)
 
-        def verify(self, msg, key, sig):
+        def verify(
+            self, msg: str | bytes, key: AllowedOKPKeys, sig: str | bytes
+        ) -> bool:
             """
             Verify a given ``msg`` against a signature ``sig`` using the EdDSA key ``key``
 
@@ -626,31 +756,48 @@ if has_crypto:
             :return bool verified: True if signature is valid, False if not.
             """
             try:
-                msg = bytes(msg, "utf-8") if type(msg) is not bytes else msg
-                sig = bytes(sig, "utf-8") if type(sig) is not bytes else sig
+                msg_bytes = msg.encode("utf-8") if isinstance(msg, str) else msg
+                sig_bytes = sig.encode("utf-8") if isinstance(sig, str) else sig
 
-                if isinstance(key, (Ed25519PrivateKey, Ed448PrivateKey)):
-                    key = key.public_key()
-                key.verify(sig, msg)
+                public_key = (
+                    key.public_key()
+                    if isinstance(key, (Ed25519PrivateKey, Ed448PrivateKey))
+                    else key
+                )
+                public_key.verify(sig_bytes, msg_bytes)
                 return True  # If no exception was raised, the signature is valid.
-            except cryptography.exceptions.InvalidSignature:
+            except InvalidSignature:
                 return False
 
+        @overload
         @staticmethod
-        def to_jwk(key):
+        def to_jwk(key: AllowedOKPKeys, as_dict: Literal[True]) -> JWKDict:
+            ...  # pragma: no cover
+
+        @overload
+        @staticmethod
+        def to_jwk(key: AllowedOKPKeys, as_dict: Literal[False] = False) -> str:
+            ...  # pragma: no cover
+
+        @staticmethod
+        def to_jwk(key: AllowedOKPKeys, as_dict: bool = False) -> Union[JWKDict, str]:
             if isinstance(key, (Ed25519PublicKey, Ed448PublicKey)):
                 x = key.public_bytes(
                     encoding=Encoding.Raw,
                     format=PublicFormat.Raw,
                 )
                 crv = "Ed25519" if isinstance(key, Ed25519PublicKey) else "Ed448"
-                return json.dumps(
-                    {
-                        "x": base64url_encode(force_bytes(x)).decode(),
-                        "kty": "OKP",
-                        "crv": crv,
-                    }
-                )
+
+                obj = {
+                    "x": base64url_encode(force_bytes(x)).decode(),
+                    "kty": "OKP",
+                    "crv": crv,
+                }
+
+                if as_dict:
+                    return obj
+                else:
+                    return json.dumps(obj)
 
             if isinstance(key, (Ed25519PrivateKey, Ed448PrivateKey)):
                 d = key.private_bytes(
@@ -665,19 +812,22 @@ if has_crypto:
                 )
 
                 crv = "Ed25519" if isinstance(key, Ed25519PrivateKey) else "Ed448"
-                return json.dumps(
-                    {
-                        "x": base64url_encode(force_bytes(x)).decode(),
-                        "d": base64url_encode(force_bytes(d)).decode(),
-                        "kty": "OKP",
-                        "crv": crv,
-                    }
-                )
+                obj = {
+                    "x": base64url_encode(force_bytes(x)).decode(),
+                    "d": base64url_encode(force_bytes(d)).decode(),
+                    "kty": "OKP",
+                    "crv": crv,
+                }
+
+                if as_dict:
+                    return obj
+                else:
+                    return json.dumps(obj)
 
             raise InvalidKeyError("Not a public or private key")
 
         @staticmethod
-        def from_jwk(jwk):
+        def from_jwk(jwk: str | JWKDict) -> AllowedOKPKeys:
             try:
                 if isinstance(jwk, str):
                     obj = json.loads(jwk)
diff --git a/lib/jwt/api_jwk.py b/lib/jwt/api_jwk.py
index aa3dd321..456c7f4d 100644
--- a/lib/jwt/api_jwk.py
+++ b/lib/jwt/api_jwk.py
@@ -2,13 +2,15 @@ from __future__ import annotations
 
 import json
 import time
+from typing import Any
 
-from .algorithms import get_default_algorithms
-from .exceptions import InvalidKeyError, PyJWKError, PyJWKSetError
+from .algorithms import get_default_algorithms, has_crypto, requires_cryptography
+from .exceptions import InvalidKeyError, PyJWKError, PyJWKSetError, PyJWTError
+from .types import JWKDict
 
 
 class PyJWK:
-    def __init__(self, jwk_data, algorithm=None):
+    def __init__(self, jwk_data: JWKDict, algorithm: str | None = None) -> None:
         self._algorithms = get_default_algorithms()
         self._jwk_data = jwk_data
 
@@ -47,37 +49,40 @@ class PyJWK:
             else:
                 raise InvalidKeyError(f"Unsupported kty: {kty}")
 
+        if not has_crypto and algorithm in requires_cryptography:
+            raise PyJWKError(f"{algorithm} requires 'cryptography' to be installed.")
+
         self.Algorithm = self._algorithms.get(algorithm)
 
         if not self.Algorithm:
-            raise PyJWKError(f"Unable to find a algorithm for key: {self._jwk_data}")
+            raise PyJWKError(f"Unable to find an algorithm for key: {self._jwk_data}")
 
         self.key = self.Algorithm.from_jwk(self._jwk_data)
 
     @staticmethod
-    def from_dict(obj, algorithm=None):
+    def from_dict(obj: JWKDict, algorithm: str | None = None) -> "PyJWK":
         return PyJWK(obj, algorithm)
 
     @staticmethod
-    def from_json(data, algorithm=None):
+    def from_json(data: str, algorithm: None = None) -> "PyJWK":
         obj = json.loads(data)
         return PyJWK.from_dict(obj, algorithm)
 
     @property
-    def key_type(self):
+    def key_type(self) -> str | None:
         return self._jwk_data.get("kty", None)
 
     @property
-    def key_id(self):
+    def key_id(self) -> str | None:
         return self._jwk_data.get("kid", None)
 
     @property
-    def public_key_use(self):
+    def public_key_use(self) -> str | None:
         return self._jwk_data.get("use", None)
 
 
 class PyJWKSet:
-    def __init__(self, keys: list[dict]) -> None:
+    def __init__(self, keys: list[JWKDict]) -> None:
         self.keys = []
 
         if not keys:
@@ -89,24 +94,26 @@ class PyJWKSet:
         for key in keys:
             try:
                 self.keys.append(PyJWK(key))
-            except PyJWKError:
+            except PyJWTError:
                 # skip unusable keys
                 continue
 
         if len(self.keys) == 0:
-            raise PyJWKSetError("The JWK Set did not contain any usable keys")
+            raise PyJWKSetError(
+                "The JWK Set did not contain any usable keys. Perhaps 'cryptography' is not installed?"
+            )
 
     @staticmethod
-    def from_dict(obj):
+    def from_dict(obj: dict[str, Any]) -> "PyJWKSet":
         keys = obj.get("keys", [])
         return PyJWKSet(keys)
 
     @staticmethod
-    def from_json(data):
+    def from_json(data: str) -> "PyJWKSet":
         obj = json.loads(data)
         return PyJWKSet.from_dict(obj)
 
-    def __getitem__(self, kid):
+    def __getitem__(self, kid: str) -> "PyJWK":
         for key in self.keys:
             if key.key_id == kid:
                 return key
@@ -118,8 +125,8 @@ class PyJWTSetWithTimestamp:
         self.jwk_set = jwk_set
         self.timestamp = time.monotonic()
 
-    def get_jwk_set(self):
+    def get_jwk_set(self) -> PyJWKSet:
         return self.jwk_set
 
-    def get_timestamp(self):
+    def get_timestamp(self) -> float:
         return self.timestamp
diff --git a/lib/jwt/api_jws.py b/lib/jwt/api_jws.py
index ab8490f9..fa6708cc 100644
--- a/lib/jwt/api_jws.py
+++ b/lib/jwt/api_jws.py
@@ -3,7 +3,7 @@ from __future__ import annotations
 import binascii
 import json
 import warnings
-from typing import Any, Type
+from typing import TYPE_CHECKING, Any
 
 from .algorithms import (
     Algorithm,
@@ -20,11 +20,18 @@ from .exceptions import (
 from .utils import base64url_decode, base64url_encode
 from .warnings import RemovedInPyjwt3Warning
 
+if TYPE_CHECKING:
+    from .algorithms import AllowedPrivateKeys, AllowedPublicKeys
+
 
 class PyJWS:
     header_typ = "JWT"
 
-    def __init__(self, algorithms=None, options=None) -> None:
+    def __init__(
+        self,
+        algorithms: list[str] | None = None,
+        options: dict[str, Any] | None = None,
+    ) -> None:
         self._algorithms = get_default_algorithms()
         self._valid_algs = (
             set(algorithms) if algorithms is not None else set(self._algorithms)
@@ -96,11 +103,12 @@ class PyJWS:
     def encode(
         self,
         payload: bytes,
-        key: str,
+        key: AllowedPrivateKeys | str | bytes,
         algorithm: str | None = "HS256",
         headers: dict[str, Any] | None = None,
-        json_encoder: Type[json.JSONEncoder] | None = None,
+        json_encoder: type[json.JSONEncoder] | None = None,
         is_payload_detached: bool = False,
+        sort_headers: bool = True,
     ) -> str:
         segments = []
 
@@ -133,9 +141,8 @@ class PyJWS:
             # True is the standard value for b64, so no need for it
             del header["b64"]
 
-        # Fix for headers misorder - issue #715
         json_header = json.dumps(
-            header, separators=(",", ":"), cls=json_encoder, sort_keys=True
+            header, separators=(",", ":"), cls=json_encoder, sort_keys=sort_headers
         ).encode()
 
         segments.append(base64url_encode(json_header))
@@ -164,8 +171,8 @@ class PyJWS:
 
     def decode_complete(
         self,
-        jwt: str,
-        key: str = "",
+        jwt: str | bytes,
+        key: AllowedPublicKeys | str | bytes = "",
         algorithms: list[str] | None = None,
         options: dict[str, Any] | None = None,
         detached_payload: bytes | None = None,
@@ -209,13 +216,13 @@ class PyJWS:
 
     def decode(
         self,
-        jwt: str,
-        key: str = "",
+        jwt: str | bytes,
+        key: AllowedPublicKeys | str | bytes = "",
         algorithms: list[str] | None = None,
         options: dict[str, Any] | None = None,
         detached_payload: bytes | None = None,
         **kwargs,
-    ) -> str:
+    ) -> Any:
         if kwargs:
             warnings.warn(
                 "passing additional kwargs to decode() is deprecated "
@@ -228,7 +235,7 @@ class PyJWS:
         )
         return decoded["payload"]
 
-    def get_unverified_header(self, jwt: str | bytes) -> dict:
+    def get_unverified_header(self, jwt: str | bytes) -> dict[str, Any]:
         """Returns back the JWT header parameters as a dict()
 
         Note: The signature is not verified so the header parameters
@@ -239,7 +246,7 @@ class PyJWS:
 
         return headers
 
-    def _load(self, jwt: str | bytes) -> tuple[bytes, bytes, dict, bytes]:
+    def _load(self, jwt: str | bytes) -> tuple[bytes, bytes, dict[str, Any], bytes]:
         if isinstance(jwt, str):
             jwt = jwt.encode("utf-8")
 
@@ -280,13 +287,15 @@ class PyJWS:
     def _verify_signature(
         self,
         signing_input: bytes,
-        header: dict,
+        header: dict[str, Any],
         signature: bytes,
-        key: str = "",
+        key: AllowedPublicKeys | str | bytes = "",
         algorithms: list[str] | None = None,
     ) -> None:
-
-        alg = header.get("alg")
+        try:
+            alg = header["alg"]
+        except KeyError:
+            raise InvalidAlgorithmError("Algorithm not specified")
 
         if not alg or (algorithms is not None and alg not in algorithms):
             raise InvalidAlgorithmError("The specified alg value is not allowed")
@@ -295,16 +304,16 @@ class PyJWS:
             alg_obj = self.get_algorithm_by_name(alg)
         except NotImplementedError as e:
             raise InvalidAlgorithmError("Algorithm not supported") from e
-        key = alg_obj.prepare_key(key)
+        prepared_key = alg_obj.prepare_key(key)
 
-        if not alg_obj.verify(signing_input, key, signature):
+        if not alg_obj.verify(signing_input, prepared_key, signature):
             raise InvalidSignatureError("Signature verification failed")
 
     def _validate_headers(self, headers: dict[str, Any]) -> None:
         if "kid" in headers:
             self._validate_kid(headers["kid"])
 
-    def _validate_kid(self, kid: str) -> None:
+    def _validate_kid(self, kid: Any) -> None:
         if not isinstance(kid, str):
             raise InvalidTokenError("Key ID header parameter must be a string")
 
diff --git a/lib/jwt/api_jwt.py b/lib/jwt/api_jwt.py
index 4bb1ee1f..48d739ad 100644
--- a/lib/jwt/api_jwt.py
+++ b/lib/jwt/api_jwt.py
@@ -3,9 +3,9 @@ from __future__ import annotations
 import json
 import warnings
 from calendar import timegm
-from collections.abc import Iterable, Mapping
+from collections.abc import Iterable
 from datetime import datetime, timedelta, timezone
-from typing import Any, Dict, List, Optional, Type, Union
+from typing import TYPE_CHECKING, Any
 
 from . import api_jws
 from .exceptions import (
@@ -19,15 +19,18 @@ from .exceptions import (
 )
 from .warnings import RemovedInPyjwt3Warning
 
+if TYPE_CHECKING:
+    from .algorithms import AllowedPrivateKeys, AllowedPublicKeys
+
 
 class PyJWT:
-    def __init__(self, options=None):
+    def __init__(self, options: dict[str, Any] | None = None) -> None:
         if options is None:
             options = {}
-        self.options = {**self._get_default_options(), **options}
+        self.options: dict[str, Any] = {**self._get_default_options(), **options}
 
     @staticmethod
-    def _get_default_options() -> Dict[str, Union[bool, List[str]]]:
+    def _get_default_options() -> dict[str, bool | list[str]]:
         return {
             "verify_signature": True,
             "verify_exp": True,
@@ -40,16 +43,17 @@ class PyJWT:
 
     def encode(
         self,
-        payload: Dict[str, Any],
-        key: str,
-        algorithm: Optional[str] = "HS256",
-        headers: Optional[Dict[str, Any]] = None,
-        json_encoder: Optional[Type[json.JSONEncoder]] = None,
+        payload: dict[str, Any],
+        key: AllowedPrivateKeys | str | bytes,
+        algorithm: str | None = "HS256",
+        headers: dict[str, Any] | None = None,
+        json_encoder: type[json.JSONEncoder] | None = None,
+        sort_headers: bool = True,
     ) -> str:
-        # Check that we get a mapping
-        if not isinstance(payload, Mapping):
+        # Check that we get a dict
+        if not isinstance(payload, dict):
             raise TypeError(
-                "Expecting a mapping object, as JWT only supports "
+                "Expecting a dict object, as JWT only supports "
                 "JSON objects as payloads."
             )
 
@@ -60,30 +64,57 @@ class PyJWT:
             if isinstance(payload.get(time_claim), datetime):
                 payload[time_claim] = timegm(payload[time_claim].utctimetuple())
 
-        json_payload = json.dumps(
-            payload, separators=(",", ":"), cls=json_encoder
-        ).encode("utf-8")
+        json_payload = self._encode_payload(
+            payload,
+            headers=headers,
+            json_encoder=json_encoder,
+        )
 
-        return api_jws.encode(json_payload, key, algorithm, headers, json_encoder)
+        return api_jws.encode(
+            json_payload,
+            key,
+            algorithm,
+            headers,
+            json_encoder,
+            sort_headers=sort_headers,
+        )
+
+    def _encode_payload(
+        self,
+        payload: dict[str, Any],
+        headers: dict[str, Any] | None = None,
+        json_encoder: type[json.JSONEncoder] | None = None,
+    ) -> bytes:
+        """
+        Encode a given payload to the bytes to be signed.
+
+        This method is intended to be overridden by subclasses that need to
+        encode the payload in a different way, e.g. compress the payload.
+        """
+        return json.dumps(
+            payload,
+            separators=(",", ":"),
+            cls=json_encoder,
+        ).encode("utf-8")
 
     def decode_complete(
         self,
-        jwt: str,
-        key: str = "",
-        algorithms: Optional[List[str]] = None,
-        options: Optional[Dict[str, Any]] = None,
+        jwt: str | bytes,
+        key: AllowedPublicKeys | str | bytes = "",
+        algorithms: list[str] | None = None,
+        options: dict[str, Any] | None = None,
         # deprecated arg, remove in pyjwt3
-        verify: Optional[bool] = None,
+        verify: bool | None = None,
         # could be used as passthrough to api_jws, consider removal in pyjwt3
-        detached_payload: Optional[bytes] = None,
+        detached_payload: bytes | None = None,
         # passthrough arguments to _validate_claims
         # consider putting in options
-        audience: Optional[Union[str, Iterable[str]]] = None,
-        issuer: Optional[str] = None,
-        leeway: Union[int, float, timedelta] = 0,
+        audience: str | Iterable[str] | None = None,
+        issuer: str | None = None,
+        leeway: float | timedelta = 0,
         # kwargs
-        **kwargs,
-    ) -> Dict[str, Any]:
+        **kwargs: Any,
+    ) -> dict[str, Any]:
         if kwargs:
             warnings.warn(
                 "passing additional kwargs to decode_complete() is deprecated "
@@ -125,12 +156,7 @@ class PyJWT:
             detached_payload=detached_payload,
         )
 
-        try:
-            payload = json.loads(decoded["payload"])
-        except ValueError as e:
-            raise DecodeError(f"Invalid payload string: {e}")
-        if not isinstance(payload, dict):
-            raise DecodeError("Invalid payload string: must be a json object")
+        payload = self._decode_payload(decoded)
 
         merged_options = {**self.options, **options}
         self._validate_claims(
@@ -140,24 +166,40 @@ class PyJWT:
         decoded["payload"] = payload
         return decoded
 
+    def _decode_payload(self, decoded: dict[str, Any]) -> Any:
+        """
+        Decode the payload from a JWS dictionary (payload, signature, header).
+
+        This method is intended to be overridden by subclasses that need to
+        decode the payload in a different way, e.g. decompress compressed
+        payloads.
+        """
+        try:
+            payload = json.loads(decoded["payload"])
+        except ValueError as e:
+            raise DecodeError(f"Invalid payload string: {e}")
+        if not isinstance(payload, dict):
+            raise DecodeError("Invalid payload string: must be a json object")
+        return payload
+
     def decode(
         self,
-        jwt: str,
-        key: str = "",
-        algorithms: Optional[List[str]] = None,
-        options: Optional[Dict[str, Any]] = None,
+        jwt: str | bytes,
+        key: AllowedPublicKeys | str | bytes = "",
+        algorithms: list[str] | None = None,
+        options: dict[str, Any] | None = None,
         # deprecated arg, remove in pyjwt3
-        verify: Optional[bool] = None,
+        verify: bool | None = None,
         # could be used as passthrough to api_jws, consider removal in pyjwt3
-        detached_payload: Optional[bytes] = None,
+        detached_payload: bytes | None = None,
         # passthrough arguments to _validate_claims
         # consider putting in options
-        audience: Optional[Union[str, Iterable[str]]] = None,
-        issuer: Optional[str] = None,
-        leeway: Union[int, float, timedelta] = 0,
+        audience: str | Iterable[str] | None = None,
+        issuer: str | None = None,
+        leeway: float | timedelta = 0,
         # kwargs
-        **kwargs,
-    ) -> Dict[str, Any]:
+        **kwargs: Any,
+    ) -> Any:
         if kwargs:
             warnings.warn(
                 "passing additional kwargs to decode() is deprecated "
@@ -178,7 +220,14 @@ class PyJWT:
         )
         return decoded["payload"]
 
-    def _validate_claims(self, payload, options, audience=None, issuer=None, leeway=0):
+    def _validate_claims(
+        self,
+        payload: dict[str, Any],
+        options: dict[str, Any],
+        audience=None,
+        issuer=None,
+        leeway: float | timedelta = 0,
+    ) -> None:
         if isinstance(leeway, timedelta):
             leeway = leeway.total_seconds()
 
@@ -187,7 +236,7 @@ class PyJWT:
 
         self._validate_required_claims(payload, options)
 
-        now = timegm(datetime.now(tz=timezone.utc).utctimetuple())
+        now = datetime.now(tz=timezone.utc).timestamp()
 
         if "iat" in payload and options["verify_iat"]:
             self._validate_iat(payload, now, leeway)
@@ -202,23 +251,38 @@ class PyJWT:
             self._validate_iss(payload, issuer)
 
         if options["verify_aud"]:
-            self._validate_aud(payload, audience)
+            self._validate_aud(
+                payload, audience, strict=options.get("strict_aud", False)
+            )
 
-    def _validate_required_claims(self, payload, options):
+    def _validate_required_claims(
+        self,
+        payload: dict[str, Any],
+        options: dict[str, Any],
+    ) -> None:
         for claim in options["require"]:
             if payload.get(claim) is None:
                 raise MissingRequiredClaimError(claim)
 
-    def _validate_iat(self, payload, now, leeway):
-        iat = payload["iat"]
+    def _validate_iat(
+        self,
+        payload: dict[str, Any],
+        now: float,
+        leeway: float,
+    ) -> None:
         try:
-            int(iat)
+            iat = int(payload["iat"])
         except ValueError:
             raise InvalidIssuedAtError("Issued At claim (iat) must be an integer.")
         if iat > (now + leeway):
             raise ImmatureSignatureError("The token is not yet valid (iat)")
 
-    def _validate_nbf(self, payload, now, leeway):
+    def _validate_nbf(
+        self,
+        payload: dict[str, Any],
+        now: float,
+        leeway: float,
+    ) -> None:
         try:
             nbf = int(payload["nbf"])
         except ValueError:
@@ -227,7 +291,12 @@ class PyJWT:
         if nbf > (now + leeway):
             raise ImmatureSignatureError("The token is not yet valid (nbf)")
 
-    def _validate_exp(self, payload, now, leeway):
+    def _validate_exp(
+        self,
+        payload: dict[str, Any],
+        now: float,
+        leeway: float,
+    ) -> None:
         try:
             exp = int(payload["exp"])
         except ValueError:
@@ -236,7 +305,13 @@ class PyJWT:
         if exp <= (now - leeway):
             raise ExpiredSignatureError("Signature has expired")
 
-    def _validate_aud(self, payload, audience):
+    def _validate_aud(
+        self,
+        payload: dict[str, Any],
+        audience: str | Iterable[str] | None,
+        *,
+        strict: bool = False,
+    ) -> None:
         if audience is None:
             if "aud" not in payload or not payload["aud"]:
                 return
@@ -251,6 +326,22 @@ class PyJWT:
 
         audience_claims = payload["aud"]
 
+        # In strict mode, we forbid list matching: the supplied audience
+        # must be a string, and it must exactly match the audience claim.
+        if strict:
+            # Only a single audience is allowed in strict mode.
+            if not isinstance(audience, str):
+                raise InvalidAudienceError("Invalid audience (strict)")
+
+            # Only a single audience claim is allowed in strict mode.
+            if not isinstance(audience_claims, str):
+                raise InvalidAudienceError("Invalid claim format in token (strict)")
+
+            if audience != audience_claims:
+                raise InvalidAudienceError("Audience doesn't match (strict)")
+
+            return
+
         if isinstance(audience_claims, str):
             audience_claims = [audience_claims]
         if not isinstance(audience_claims, list):
@@ -262,9 +353,9 @@ class PyJWT:
             audience = [audience]
 
         if all(aud not in audience_claims for aud in audience):
-            raise InvalidAudienceError("Invalid audience")
+            raise InvalidAudienceError("Audience doesn't match")
 
-    def _validate_iss(self, payload, issuer):
+    def _validate_iss(self, payload: dict[str, Any], issuer: Any) -> None:
         if issuer is None:
             return
 
diff --git a/lib/jwt/exceptions.py b/lib/jwt/exceptions.py
index ee201add..8ac6ecf7 100644
--- a/lib/jwt/exceptions.py
+++ b/lib/jwt/exceptions.py
@@ -47,10 +47,10 @@ class InvalidAlgorithmError(InvalidTokenError):
 
 
 class MissingRequiredClaimError(InvalidTokenError):
-    def __init__(self, claim):
+    def __init__(self, claim: str) -> None:
         self.claim = claim
 
-    def __str__(self):
+    def __str__(self) -> str:
         return f'Token is missing the "{self.claim}" claim'
 
 
@@ -64,3 +64,7 @@ class PyJWKSetError(PyJWTError):
 
 class PyJWKClientError(PyJWTError):
     pass
+
+
+class PyJWKClientConnectionError(PyJWKClientError):
+    pass
diff --git a/lib/jwt/help.py b/lib/jwt/help.py
index 0c02eb92..80b0ca56 100644
--- a/lib/jwt/help.py
+++ b/lib/jwt/help.py
@@ -7,8 +7,10 @@ from . import __version__ as pyjwt_version
 
 try:
     import cryptography
+
+    cryptography_version = cryptography.__version__
 except ModuleNotFoundError:
-    cryptography = None
+    cryptography_version = ""
 
 
 def info() -> Dict[str, Dict[str, str]]:
@@ -29,7 +31,7 @@ def info() -> Dict[str, Dict[str, str]]:
     if implementation == "CPython":
         implementation_version = platform.python_version()
     elif implementation == "PyPy":
-        pypy_version_info = getattr(sys, "pypy_version_info")
+        pypy_version_info = sys.pypy_version_info  # type: ignore[attr-defined]
         implementation_version = (
             f"{pypy_version_info.major}."
             f"{pypy_version_info.minor}."
@@ -48,7 +50,7 @@ def info() -> Dict[str, Dict[str, str]]:
             "name": implementation,
             "version": implementation_version,
         },
-        "cryptography": {"version": getattr(cryptography, "__version__", "")},
+        "cryptography": {"version": cryptography_version},
         "pyjwt": {"version": pyjwt_version},
     }
 
diff --git a/lib/jwt/jwk_set_cache.py b/lib/jwt/jwk_set_cache.py
index e8c2a7e0..24325630 100644
--- a/lib/jwt/jwk_set_cache.py
+++ b/lib/jwt/jwk_set_cache.py
@@ -5,11 +5,11 @@ from .api_jwk import PyJWKSet, PyJWTSetWithTimestamp
 
 
 class JWKSetCache:
-    def __init__(self, lifespan: int):
+    def __init__(self, lifespan: int) -> None:
         self.jwk_set_with_timestamp: Optional[PyJWTSetWithTimestamp] = None
         self.lifespan = lifespan
 
-    def put(self, jwk_set: PyJWKSet):
+    def put(self, jwk_set: PyJWKSet) -> None:
         if jwk_set is not None:
             self.jwk_set_with_timestamp = PyJWTSetWithTimestamp(jwk_set)
         else:
@@ -23,7 +23,6 @@ class JWKSetCache:
         return self.jwk_set_with_timestamp.get_jwk_set()
 
     def is_expired(self) -> bool:
-
         return (
             self.jwk_set_with_timestamp is not None
             and self.lifespan > -1
diff --git a/lib/jwt/jwks_client.py b/lib/jwt/jwks_client.py
index b4e98007..f19b10ac 100644
--- a/lib/jwt/jwks_client.py
+++ b/lib/jwt/jwks_client.py
@@ -1,12 +1,13 @@
 import json
 import urllib.request
 from functools import lru_cache
-from typing import Any, List, Optional
+from ssl import SSLContext
+from typing import Any, Dict, List, Optional
 from urllib.error import URLError
 
 from .api_jwk import PyJWK, PyJWKSet
 from .api_jwt import decode_complete as decode_token
-from .exceptions import PyJWKClientError
+from .exceptions import PyJWKClientConnectionError, PyJWKClientError
 from .jwk_set_cache import JWKSetCache
 
 
@@ -18,9 +19,17 @@ class PyJWKClient:
         max_cached_keys: int = 16,
         cache_jwk_set: bool = True,
         lifespan: int = 300,
+        headers: Optional[Dict[str, Any]] = None,
+        timeout: int = 30,
+        ssl_context: Optional[SSLContext] = None,
     ):
+        if headers is None:
+            headers = {}
         self.uri = uri
         self.jwk_set_cache: Optional[JWKSetCache] = None
+        self.headers = headers
+        self.timeout = timeout
+        self.ssl_context = ssl_context
 
         if cache_jwk_set:
             # Init jwt set cache with default or given lifespan.
@@ -41,10 +50,15 @@ class PyJWKClient:
     def fetch_data(self) -> Any:
         jwk_set: Any = None
         try:
-            with urllib.request.urlopen(self.uri) as response:
+            r = urllib.request.Request(url=self.uri, headers=self.headers)
+            with urllib.request.urlopen(
+                r, timeout=self.timeout, context=self.ssl_context
+            ) as response:
                 jwk_set = json.load(response)
-        except URLError as e:
-            raise PyJWKClientError(f'Fail to fetch data from the url, err: "{e}"')
+        except (URLError, TimeoutError) as e:
+            raise PyJWKClientConnectionError(
+                f'Fail to fetch data from the url, err: "{e}"'
+            )
         else:
             return jwk_set
         finally:
@@ -59,6 +73,9 @@ class PyJWKClient:
         if data is None:
             data = self.fetch_data()
 
+        if not isinstance(data, dict):
+            raise PyJWKClientError("The JWKS endpoint did not return a JSON object")
+
         return PyJWKSet.from_dict(data)
 
     def get_signing_keys(self, refresh: bool = False) -> List[PyJWK]:
diff --git a/lib/jwt/types.py b/lib/jwt/types.py
new file mode 100644
index 00000000..7d993520
--- /dev/null
+++ b/lib/jwt/types.py
@@ -0,0 +1,5 @@
+from typing import Any, Callable, Dict
+
+JWKDict = Dict[str, Any]
+
+HashlibHash = Callable[..., Any]
diff --git a/lib/jwt/utils.py b/lib/jwt/utils.py
index 16cae066..81c5ee41 100644
--- a/lib/jwt/utils.py
+++ b/lib/jwt/utils.py
@@ -10,10 +10,10 @@ try:
         encode_dss_signature,
     )
 except ModuleNotFoundError:
-    EllipticCurve = None
+    pass
 
 
-def force_bytes(value: Union[str, bytes]) -> bytes:
+def force_bytes(value: Union[bytes, str]) -> bytes:
     if isinstance(value, str):
         return value.encode("utf-8")
     elif isinstance(value, bytes):
@@ -22,16 +22,15 @@ def force_bytes(value: Union[str, bytes]) -> bytes:
         raise TypeError("Expected a string value")
 
 
-def base64url_decode(input: Union[str, bytes]) -> bytes:
-    if isinstance(input, str):
-        input = input.encode("ascii")
+def base64url_decode(input: Union[bytes, str]) -> bytes:
+    input_bytes = force_bytes(input)
 
-    rem = len(input) % 4
+    rem = len(input_bytes) % 4
 
     if rem > 0:
-        input += b"=" * (4 - rem)
+        input_bytes += b"=" * (4 - rem)
 
-    return base64.urlsafe_b64decode(input)
+    return base64.urlsafe_b64decode(input_bytes)
 
 
 def base64url_encode(input: bytes) -> bytes:
@@ -50,11 +49,8 @@ def to_base64url_uint(val: int) -> bytes:
     return base64url_encode(int_bytes)
 
 
-def from_base64url_uint(val: Union[str, bytes]) -> int:
-    if isinstance(val, str):
-        val = val.encode("ascii")
-
-    data = base64url_decode(val)
+def from_base64url_uint(val: Union[bytes, str]) -> int:
+    data = base64url_decode(force_bytes(val))
     return int.from_bytes(data, byteorder="big")
 
 
@@ -78,7 +74,7 @@ def bytes_from_int(val: int) -> bytes:
     return val.to_bytes(byte_length, "big", signed=False)
 
 
-def der_to_raw_signature(der_sig: bytes, curve: EllipticCurve) -> bytes:
+def der_to_raw_signature(der_sig: bytes, curve: "EllipticCurve") -> bytes:
     num_bits = curve.key_size
     num_bytes = (num_bits + 7) // 8
 
@@ -87,7 +83,7 @@ def der_to_raw_signature(der_sig: bytes, curve: EllipticCurve) -> bytes:
     return number_to_bytes(r, num_bytes) + number_to_bytes(s, num_bytes)
 
 
-def raw_to_der_signature(raw_sig: bytes, curve: EllipticCurve) -> bytes:
+def raw_to_der_signature(raw_sig: bytes, curve: "EllipticCurve") -> bytes:
     num_bits = curve.key_size
     num_bytes = (num_bits + 7) // 8
 
@@ -97,7 +93,7 @@ def raw_to_der_signature(raw_sig: bytes, curve: EllipticCurve) -> bytes:
     r = bytes_to_number(raw_sig[:num_bytes])
     s = bytes_to_number(raw_sig[num_bytes:])
 
-    return encode_dss_signature(r, s)
+    return bytes(encode_dss_signature(r, s))
 
 
 # Based on https://github.com/hynek/pem/blob/7ad94db26b0bc21d10953f5dbad3acfdfacf57aa/src/pem/_core.py#L224-L252
diff --git a/requirements.txt b/requirements.txt
index 755f9a21..0ac5222b 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -31,7 +31,7 @@ paho-mqtt==1.6.1
 plexapi==4.13.4
 portend==3.1.0
 profilehooks==1.12.0
-PyJWT==2.6.0
+PyJWT==2.8.0
 pyparsing==3.0.9
 python-dateutil==2.8.2
 python-twitter==3.5

From eac78a30474f39d25b05b4ee1ec520c3a3c8648e Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 23 Aug 2023 21:45:28 -0700
Subject: [PATCH 432/743] Bump websocket-client from 1.5.1 to 1.6.2 (#2122)

* Bump websocket-client from 1.5.1 to 1.6.2

Bumps [websocket-client](https://github.com/websocket-client/websocket-client) from 1.5.1 to 1.6.2.
- [Release notes](https://github.com/websocket-client/websocket-client/releases)
- [Changelog](https://github.com/websocket-client/websocket-client/blob/master/ChangeLog)
- [Commits](https://github.com/websocket-client/websocket-client/compare/v1.5.1...v1.6.2)

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

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

* Update websocket-client==1.6.2

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/websocket/__init__.py             |   4 +-
 lib/websocket/_abnf.py                |  50 +++----
 lib/websocket/_app.py                 | 187 +++++++++++++++-----------
 lib/websocket/_cookiejar.py           |  10 +-
 lib/websocket/_core.py                |  38 +++---
 lib/websocket/_exceptions.py          |   8 +-
 lib/websocket/_handshake.py           |  49 +++----
 lib/websocket/_http.py                |  20 +--
 lib/websocket/_logging.py             |  26 ++--
 lib/websocket/_socket.py              |  14 +-
 lib/websocket/_ssl_compat.py          |   2 +-
 lib/websocket/_url.py                 |  40 +++---
 lib/websocket/_utils.py               |  18 +--
 lib/websocket/_wsdump.py              |  32 ++---
 lib/websocket/tests/echo-server.py    |   2 +-
 lib/websocket/tests/test_abnf.py      |   2 +-
 lib/websocket/tests/test_app.py       |  25 +---
 lib/websocket/tests/test_cookiejar.py |   2 +-
 lib/websocket/tests/test_http.py      |   2 +-
 lib/websocket/tests/test_url.py       |  20 ++-
 lib/websocket/tests/test_websocket.py |   2 +-
 requirements.txt                      |   2 +-
 22 files changed, 295 insertions(+), 260 deletions(-)

diff --git a/lib/websocket/__init__.py b/lib/websocket/__init__.py
index a579342d..bfa71981 100644
--- a/lib/websocket/__init__.py
+++ b/lib/websocket/__init__.py
@@ -2,7 +2,7 @@
 __init__.py
 websocket - WebSocket client library for Python
 
-Copyright 2022 engn33r
+Copyright 2023 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
@@ -23,4 +23,4 @@ from ._exceptions import *
 from ._logging import *
 from ._socket import *
 
-__version__ = "1.5.1"
+__version__ = "1.6.2"
diff --git a/lib/websocket/_abnf.py b/lib/websocket/_abnf.py
index 2e5ad97c..6c2466ad 100644
--- a/lib/websocket/_abnf.py
+++ b/lib/websocket/_abnf.py
@@ -11,7 +11,7 @@ from threading import Lock
 _abnf.py
 websocket - WebSocket client library for Python
 
-Copyright 2022 engn33r
+Copyright 2023 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
@@ -33,14 +33,14 @@ try:
     # Note that wsaccel is unmaintained.
     from wsaccel.xormask import XorMaskerSimple
 
-    def _mask(_m, _d):
+    def _mask(_m, _d) -> bytes:
         return XorMaskerSimple(_m).process(_d)
 
 except ImportError:
     # wsaccel is not available, use websocket-client _mask()
     native_byteorder = sys.byteorder
 
-    def _mask(mask_value, data_value):
+    def _mask(mask_value: array.array, data_value: array.array) -> bytes:
         datalen = len(data_value)
         data_value = int.from_bytes(data_value, native_byteorder)
         mask_value = int.from_bytes(mask_value * (datalen // 4) + mask_value[: datalen % 4], native_byteorder)
@@ -131,8 +131,8 @@ class ABNF:
     LENGTH_16 = 1 << 16
     LENGTH_63 = 1 << 63
 
-    def __init__(self, fin=0, rsv1=0, rsv2=0, rsv3=0,
-                 opcode=OPCODE_TEXT, mask=1, data=""):
+    def __init__(self, fin: int = 0, rsv1: int = 0, rsv2: int = 0, rsv3: int = 0,
+                 opcode: int = OPCODE_TEXT, mask: int = 1, data: str or bytes = "") -> None:
         """
         Constructor for ABNF. Please check RFC for arguments.
         """
@@ -147,7 +147,7 @@ class ABNF:
         self.data = data
         self.get_mask_key = os.urandom
 
-    def validate(self, skip_utf8_validation=False) -> None:
+    def validate(self, skip_utf8_validation: bool = False) -> None:
         """
         Validate the ABNF frame.
 
@@ -187,19 +187,19 @@ class ABNF:
             + " data=" + str(self.data)
 
     @staticmethod
-    def create_frame(data, opcode, fin=1):
+    def create_frame(data: str, opcode: int, fin: int = 1) -> 'ABNF':
         """
         Create frame to send text, binary and other data.
 
         Parameters
         ----------
-        data: <type>
+        data: str
             data to send. This is string value(byte array).
             If opcode is OPCODE_TEXT and this value is unicode,
             data value is converted into unicode string, automatically.
-        opcode: <type>
-            operation code. please see OPCODE_XXX.
-        fin: <type>
+        opcode: int
+            operation code. please see OPCODE_MAP.
+        fin: int
             fin flag. if set to 0, create continue fragmentation.
         """
         if opcode == ABNF.OPCODE_TEXT and isinstance(data, str):
@@ -237,7 +237,7 @@ class ABNF:
             mask_key = self.get_mask_key(4)
             return frame_header + self._get_masked(mask_key)
 
-    def _get_masked(self, mask_key):
+    def _get_masked(self, mask_key: str or bytes) -> bytes:
         s = ABNF.mask(mask_key, self.data)
 
         if isinstance(mask_key, str):
@@ -246,7 +246,7 @@ class ABNF:
         return mask_key + s
 
     @staticmethod
-    def mask(mask_key, data):
+    def mask(mask_key: str or bytes, data: str or bytes) -> bytes:
         """
         Mask or unmask data. Just do xor for each byte
 
@@ -273,7 +273,7 @@ class frame_buffer:
     _HEADER_MASK_INDEX = 5
     _HEADER_LENGTH_INDEX = 6
 
-    def __init__(self, recv_fn, skip_utf8_validation):
+    def __init__(self, recv_fn: int, skip_utf8_validation: bool) -> None:
         self.recv = recv_fn
         self.skip_utf8_validation = skip_utf8_validation
         # Buffers over the packets from the layer beneath until desired amount
@@ -282,7 +282,7 @@ class frame_buffer:
         self.clear()
         self.lock = Lock()
 
-    def clear(self):
+    def clear(self) -> None:
         self.header = None
         self.length = None
         self.mask = None
@@ -290,7 +290,7 @@ class frame_buffer:
     def has_received_header(self) -> bool:
         return self.header is None
 
-    def recv_header(self):
+    def recv_header(self) -> None:
         header = self.recv_strict(2)
         b1 = header[0]
         fin = b1 >> 7 & 1
@@ -304,7 +304,7 @@ class frame_buffer:
 
         self.header = (fin, rsv1, rsv2, rsv3, opcode, has_mask, length_bits)
 
-    def has_mask(self):
+    def has_mask(self) -> bool or int:
         if not self.header:
             return False
         return self.header[frame_buffer._HEADER_MASK_INDEX]
@@ -312,7 +312,7 @@ class frame_buffer:
     def has_received_length(self) -> bool:
         return self.length is None
 
-    def recv_length(self):
+    def recv_length(self) -> None:
         bits = self.header[frame_buffer._HEADER_LENGTH_INDEX]
         length_bits = bits & 0x7f
         if length_bits == 0x7e:
@@ -327,10 +327,10 @@ class frame_buffer:
     def has_received_mask(self) -> bool:
         return self.mask is None
 
-    def recv_mask(self):
+    def recv_mask(self) -> None:
         self.mask = self.recv_strict(4) if self.has_mask() else ""
 
-    def recv_frame(self):
+    def recv_frame(self) -> ABNF:
 
         with self.lock:
             # Header
@@ -386,20 +386,20 @@ class frame_buffer:
 
 class continuous_frame:
 
-    def __init__(self, fire_cont_frame, skip_utf8_validation):
+    def __init__(self, fire_cont_frame: bool, skip_utf8_validation: bool) -> None:
         self.fire_cont_frame = fire_cont_frame
         self.skip_utf8_validation = skip_utf8_validation
         self.cont_data = None
         self.recving_frames = None
 
-    def validate(self, frame):
+    def validate(self, frame: ABNF) -> None:
         if not self.recving_frames and frame.opcode == ABNF.OPCODE_CONT:
             raise WebSocketProtocolException("Illegal frame")
         if self.recving_frames and \
                 frame.opcode in (ABNF.OPCODE_TEXT, ABNF.OPCODE_BINARY):
             raise WebSocketProtocolException("Illegal frame")
 
-    def add(self, frame):
+    def add(self, frame: ABNF) -> None:
         if self.cont_data:
             self.cont_data[1] += frame.data
         else:
@@ -410,10 +410,10 @@ class continuous_frame:
         if frame.fin:
             self.recving_frames = None
 
-    def is_fire(self, frame):
+    def is_fire(self, frame: ABNF) -> bool or int:
         return frame.fin or self.fire_cont_frame
 
-    def extract(self, frame):
+    def extract(self, frame: ABNF) -> list:
         data = self.cont_data
         self.cont_data = None
         frame.data = data[1]
diff --git a/lib/websocket/_app.py b/lib/websocket/_app.py
index 0a16ddb6..2577f1ba 100644
--- a/lib/websocket/_app.py
+++ b/lib/websocket/_app.py
@@ -4,6 +4,9 @@ import sys
 import threading
 import time
 import traceback
+import socket
+
+from typing import Callable, Any
 
 from . import _logging
 from ._abnf import ABNF
@@ -15,7 +18,7 @@ from ._exceptions import *
 _app.py
 websocket - WebSocket client library for Python
 
-Copyright 2022 engn33r
+Copyright 2023 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
@@ -35,7 +38,7 @@ __all__ = ["WebSocketApp"]
 RECONNECT = 0
 
 
-def setReconnect(reconnectInterval):
+def setReconnect(reconnectInterval: int) -> None:
     global RECONNECT
     RECONNECT = reconnectInterval
 
@@ -44,37 +47,40 @@ class DispatcherBase:
     """
     DispatcherBase
     """
-    def __init__(self, app, ping_timeout):
+    def __init__(self, app: Any, ping_timeout: float) -> None:
         self.app = app
         self.ping_timeout = ping_timeout
 
-    def timeout(self, seconds, callback):
+    def timeout(self, seconds: int, callback: Callable) -> None:
         time.sleep(seconds)
         callback()
 
-    def reconnect(self, seconds, reconnector):
+    def reconnect(self, seconds: int, reconnector: Callable) -> None:
         try:
-            _logging.info("reconnect() - retrying in %s seconds [%s frames in stack]" % (seconds, len(inspect.stack())))
+            _logging.info("reconnect() - retrying in {seconds_count} seconds [{frame_count} frames in stack]".format(
+                seconds_count=seconds, frame_count=len(inspect.stack())))
             time.sleep(seconds)
             reconnector(reconnecting=True)
         except KeyboardInterrupt as e:
-            _logging.info("User exited %s" % (e,))
+            _logging.info("User exited {err}".format(err=e))
+            raise e
 
 
 class Dispatcher(DispatcherBase):
     """
     Dispatcher
     """
-    def read(self, sock, read_callback, check_callback):
-        while self.app.keep_running:
-            sel = selectors.DefaultSelector()
-            sel.register(self.app.sock.sock, selectors.EVENT_READ)
-
-            r = sel.select(self.ping_timeout)
-            if r:
-                if not read_callback():
-                    break
-            check_callback()
+    def read(self, sock: socket.socket, read_callback: Callable, check_callback: Callable) -> None:
+        sel = selectors.DefaultSelector()
+        sel.register(self.app.sock.sock, selectors.EVENT_READ)
+        try:
+            while self.app.keep_running:
+                r = sel.select(self.ping_timeout)
+                if r:
+                    if not read_callback():
+                        break
+                check_callback()
+        finally:
             sel.close()
 
 
@@ -82,24 +88,26 @@ class SSLDispatcher(DispatcherBase):
     """
     SSLDispatcher
     """
-    def read(self, sock, read_callback, check_callback):
-        while self.app.keep_running:
-            r = self.select()
-            if r:
-                if not read_callback():
-                    break
-            check_callback()
+    def read(self, sock: socket.socket, read_callback: Callable, check_callback: Callable) -> None:
+        sock = self.app.sock.sock
+        sel = selectors.DefaultSelector()
+        sel.register(sock, selectors.EVENT_READ)
+        try:
+            while self.app.keep_running:
+                r = self.select(sock, sel)
+                if r:
+                    if not read_callback():
+                        break
+                check_callback()
+        finally:
+            sel.close()
 
-    def select(self):
+    def select(self, sock, sel:selectors.DefaultSelector):
         sock = self.app.sock.sock
         if sock.pending():
             return [sock,]
 
-        sel = selectors.DefaultSelector()
-        sel.register(sock, selectors.EVENT_READ)
-
         r = sel.select(self.ping_timeout)
-        sel.close()
 
         if len(r) > 0:
             return r[0][0]
@@ -109,20 +117,20 @@ class WrappedDispatcher:
     """
     WrappedDispatcher
     """
-    def __init__(self, app, ping_timeout, dispatcher):
+    def __init__(self, app, ping_timeout: float, dispatcher: Dispatcher) -> None:
         self.app = app
         self.ping_timeout = ping_timeout
         self.dispatcher = dispatcher
         dispatcher.signal(2, dispatcher.abort)  # keyboard interrupt
 
-    def read(self, sock, read_callback, check_callback):
+    def read(self, sock: socket.socket, read_callback: Callable, check_callback: Callable) -> None:
         self.dispatcher.read(sock, read_callback)
         self.ping_timeout and self.timeout(self.ping_timeout, check_callback)
 
-    def timeout(self, seconds, callback):
+    def timeout(self, seconds: int, callback: Callable) -> None:
         self.dispatcher.timeout(seconds, callback)
 
-    def reconnect(self, seconds, reconnector):
+    def reconnect(self, seconds: int, reconnector: Callable) -> None:
         self.timeout(seconds, reconnector)
 
 
@@ -131,14 +139,14 @@ class WebSocketApp:
     Higher level of APIs are provided. The interface is like JavaScript WebSocket object.
     """
 
-    def __init__(self, url, header=None,
-                 on_open=None, on_message=None, on_error=None,
-                 on_close=None, on_ping=None, on_pong=None,
-                 on_cont_message=None,
-                 keep_running=True, get_mask_key=None, cookie=None,
-                 subprotocols=None,
-                 on_data=None,
-                 socket=None):
+    def __init__(self, url: str, header: list or dict or Callable = None,
+                 on_open: Callable = None, on_message: Callable = None, on_error: Callable = None,
+                 on_close: Callable = None, on_ping: Callable = None, on_pong: Callable = None,
+                 on_cont_message: Callable = None,
+                 keep_running: bool = True, get_mask_key: Callable = None, cookie: str = None,
+                 subprotocols: list = None,
+                 on_data: Callable = None,
+                 socket: socket.socket = None) -> None:
         """
         WebSocketApp initialization
 
@@ -146,8 +154,11 @@ class WebSocketApp:
         ----------
         url: str
             Websocket url.
-        header: list or dict
+        header: list or dict or Callable
             Custom header for websocket handshake.
+            If the parameter is a callable object, it is called just before the connection attempt.
+            The returned dict or list is used as custom header value.
+            This could be useful in order to properly setup timestamp dependent headers.
         on_open: function
             Callback object which is called at opening websocket.
             on_open has one argument.
@@ -222,8 +233,10 @@ class WebSocketApp:
         self.subprotocols = subprotocols
         self.prepared_socket = socket
         self.has_errored = False
+        self.has_done_teardown = False
+        self.has_done_teardown_lock = threading.Lock()
 
-    def send(self, data, opcode=ABNF.OPCODE_TEXT):
+    def send(self, data: str, opcode: int = ABNF.OPCODE_TEXT) -> None:
         """
         send message
 
@@ -240,7 +253,7 @@ class WebSocketApp:
             raise WebSocketConnectionClosedException(
                 "Connection is already closed.")
 
-    def close(self, **kwargs):
+    def close(self, **kwargs) -> None:
         """
         Close websocket connection.
         """
@@ -249,41 +262,41 @@ class WebSocketApp:
             self.sock.close(**kwargs)
             self.sock = None
 
-    def _start_ping_thread(self):
+    def _start_ping_thread(self) -> None:
         self.last_ping_tm = self.last_pong_tm = 0
         self.stop_ping = threading.Event()
         self.ping_thread = threading.Thread(target=self._send_ping)
         self.ping_thread.daemon = True
         self.ping_thread.start()
 
-    def _stop_ping_thread(self):
+    def _stop_ping_thread(self) -> None:
         if self.stop_ping:
             self.stop_ping.set()
         if self.ping_thread and self.ping_thread.is_alive():
             self.ping_thread.join(3)
         self.last_ping_tm = self.last_pong_tm = 0
 
-    def _send_ping(self):
-        if self.stop_ping.wait(self.ping_interval):
+    def _send_ping(self) -> None:
+        if self.stop_ping.wait(self.ping_interval) or self.keep_running is False:
             return
-        while not self.stop_ping.wait(self.ping_interval):
+        while not self.stop_ping.wait(self.ping_interval) and self.keep_running is True:
             if self.sock:
                 self.last_ping_tm = time.time()
                 try:
                     _logging.debug("Sending ping")
                     self.sock.ping(self.ping_payload)
-                except Exception as ex:
-                    _logging.debug("Failed to send ping: %s", ex)
+                except Exception as e:
+                    _logging.debug("Failed to send ping: {err}".format(err=e))
 
-    def run_forever(self, sockopt=None, sslopt=None,
-                    ping_interval=0, ping_timeout=None,
-                    ping_payload="",
-                    http_proxy_host=None, http_proxy_port=None,
-                    http_no_proxy=None, http_proxy_auth=None,
-                    http_proxy_timeout=None,
-                    skip_utf8_validation=False,
-                    host=None, origin=None, dispatcher=None,
-                    suppress_origin=False, proxy_type=None, reconnect=None):
+    def run_forever(self, sockopt: tuple = None, sslopt: dict = None,
+                    ping_interval: float = 0, ping_timeout: float or None = None,
+                    ping_payload: str = "",
+                    http_proxy_host: str = None, http_proxy_port: int or str = None,
+                    http_no_proxy: list = None, http_proxy_auth: tuple = None,
+                    http_proxy_timeout: float = None,
+                    skip_utf8_validation: bool = False,
+                    host: str = None, origin: str = None, dispatcher: Dispatcher = None,
+                    suppress_origin: bool = False, proxy_type: str = None, reconnect: int = None) -> bool:
         """
         Run event loop for WebSocket framework.
 
@@ -358,7 +371,7 @@ class WebSocketApp:
         self.ping_payload = ping_payload
         self.keep_running = True
 
-        def teardown(close_frame=None):
+        def teardown(close_frame: ABNF = None):
             """
             Tears down the connection.
 
@@ -369,6 +382,13 @@ class WebSocketApp:
                 with the statusCode and reason from the provided frame.
             """
 
+            # teardown() is called in many code paths to ensure resources are cleaned up and on_close is fired.
+            # To ensure the work is only done once, we use this bool and lock.
+            with self.has_done_teardown_lock:
+                if self.has_done_teardown:
+                    return
+                self.has_done_teardown = True
+
             self._stop_ping_thread()
             self.keep_running = False
             if self.sock:
@@ -380,7 +400,7 @@ class WebSocketApp:
             # Finally call the callback AFTER all teardown is complete
             self._callback(self.on_close, close_status_code, close_reason)
 
-        def setSock(reconnecting=False):
+        def setSock(reconnecting: bool = False) -> None:
             if reconnecting and self.sock:
                 self.sock.shutdown()
 
@@ -392,8 +412,11 @@ class WebSocketApp:
 
             self.sock.settimeout(getdefaulttimeout())
             try:
+
+                header = self.header() if callable(self.header) else self.header
+
                 self.sock.connect(
-                    self.url, header=self.header, cookie=self.cookie,
+                    self.url, header=header, cookie=self.cookie,
                     http_proxy_host=http_proxy_host,
                     http_proxy_port=http_proxy_port, http_no_proxy=http_no_proxy,
                     http_proxy_auth=http_proxy_auth, http_proxy_timeout=http_proxy_timeout,
@@ -412,7 +435,7 @@ class WebSocketApp:
             except (WebSocketConnectionClosedException, ConnectionRefusedError, KeyboardInterrupt, SystemExit, Exception) as e:
                 handleDisconnect(e, reconnecting)
 
-        def read():
+        def read() -> bool:
             if not self.keep_running:
                 return teardown()
 
@@ -445,7 +468,7 @@ class WebSocketApp:
 
             return True
 
-        def check():
+        def check() -> bool:
             if (self.ping_timeout):
                 has_timeout_expired = time.time() - self.last_ping_tm > self.ping_timeout
                 has_pong_not_arrived_after_last_ping = self.last_pong_tm - self.last_ping_tm < 0
@@ -457,7 +480,7 @@ class WebSocketApp:
                     raise WebSocketTimeoutException("ping/pong timed out")
             return True
 
-        def handleDisconnect(e, reconnecting=False):
+        def handleDisconnect(e: Exception, reconnecting: bool = False) -> bool:
             self.has_errored = True
             self._stop_ping_thread()
             if not reconnecting:
@@ -469,26 +492,34 @@ class WebSocketApp:
                 raise
 
             if reconnect:
-                _logging.info("%s - reconnect" % e)
+                _logging.info("{err} - reconnect".format(err=e))
                 if custom_dispatcher:
-                    _logging.debug("Calling custom dispatcher reconnect [%s frames in stack]" % len(inspect.stack()))
+                    _logging.debug("Calling custom dispatcher reconnect [{frame_count} frames in stack]".format(frame_count=len(inspect.stack())))
                     dispatcher.reconnect(reconnect, setSock)
             else:
-                _logging.error("%s - goodbye" % e)
+                _logging.error("{err} - goodbye".format(err=e))
                 teardown()
 
         custom_dispatcher = bool(dispatcher)
         dispatcher = self.create_dispatcher(ping_timeout, dispatcher, parse_url(self.url)[3])
 
-        setSock()
-        if not custom_dispatcher and reconnect:
-            while self.keep_running:
-                _logging.debug("Calling dispatcher reconnect [%s frames in stack]" % len(inspect.stack()))
-                dispatcher.reconnect(reconnect, setSock)
+        try:
+            setSock()
+            if not custom_dispatcher and reconnect:
+                while self.keep_running:
+                    _logging.debug("Calling dispatcher reconnect [{frame_count} frames in stack]".format(frame_count=len(inspect.stack())))
+                    dispatcher.reconnect(reconnect, setSock)
+        except (KeyboardInterrupt, Exception) as e:
+            _logging.info("tearing down on exception {err}".format(err=e))
+            teardown()
+        finally:
+            if not custom_dispatcher:
+                # Ensure teardown was called before returning from run_forever
+                teardown()
 
         return self.has_errored
 
-    def create_dispatcher(self, ping_timeout, dispatcher=None, is_ssl=False):
+    def create_dispatcher(self, ping_timeout: int, dispatcher: Dispatcher = None, is_ssl: bool = False) -> DispatcherBase:
         if dispatcher:  # If custom dispatcher is set, use WrappedDispatcher
             return WrappedDispatcher(self, ping_timeout, dispatcher)
         timeout = ping_timeout or 10
@@ -497,7 +528,7 @@ class WebSocketApp:
 
         return Dispatcher(self, timeout)
 
-    def _get_close_args(self, close_frame):
+    def _get_close_args(self, close_frame: ABNF) -> list:
         """
         _get_close_args extracts the close code and reason from the close body
         if it exists (RFC6455 says WebSocket Connection Close Code is optional)
@@ -516,12 +547,12 @@ class WebSocketApp:
             # Most likely reached this because len(close_frame_data.data) < 2
             return [None, None]
 
-    def _callback(self, callback, *args):
+    def _callback(self, callback, *args) -> None:
         if callback:
             try:
                 callback(self, *args)
 
             except Exception as e:
-                _logging.error("error from callback {}: {}".format(callback, e))
+                _logging.error("error from callback {callback}: {err}".format(callback=callback, err=e))
                 if self.on_error:
                     self.on_error(self, e)
diff --git a/lib/websocket/_cookiejar.py b/lib/websocket/_cookiejar.py
index 5476d1d4..2047eddd 100644
--- a/lib/websocket/_cookiejar.py
+++ b/lib/websocket/_cookiejar.py
@@ -4,7 +4,7 @@ import http.cookies
 _cookiejar.py
 websocket - WebSocket client library for Python
 
-Copyright 2022 engn33r
+Copyright 2023 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
@@ -21,10 +21,10 @@ limitations under the License.
 
 
 class SimpleCookieJar:
-    def __init__(self):
+    def __init__(self) -> None:
         self.jar = dict()
 
-    def add(self, set_cookie):
+    def add(self, set_cookie: str) -> None:
         if set_cookie:
             simpleCookie = http.cookies.SimpleCookie(set_cookie)
 
@@ -37,7 +37,7 @@ class SimpleCookieJar:
                     cookie.update(simpleCookie)
                     self.jar[domain.lower()] = cookie
 
-    def set(self, set_cookie):
+    def set(self, set_cookie: str) -> None:
         if set_cookie:
             simpleCookie = http.cookies.SimpleCookie(set_cookie)
 
@@ -48,7 +48,7 @@ class SimpleCookieJar:
                         domain = "." + domain
                     self.jar[domain.lower()] = simpleCookie
 
-    def get(self, host):
+    def get(self, host: str) -> str:
         if not host:
             return ""
 
diff --git a/lib/websocket/_core.py b/lib/websocket/_core.py
index 1d688294..e81066ad 100644
--- a/lib/websocket/_core.py
+++ b/lib/websocket/_core.py
@@ -17,7 +17,7 @@ from ._utils import *
 _core.py
 websocket - WebSocket client library for Python
 
-Copyright 2022 engn33r
+Copyright 2023 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
@@ -74,8 +74,8 @@ class WebSocket:
     """
 
     def __init__(self, get_mask_key=None, sockopt=None, sslopt=None,
-                 fire_cont_frame=False, enable_multithread=True,
-                 skip_utf8_validation=False, **_):
+                 fire_cont_frame: bool = False, enable_multithread: bool = True,
+                 skip_utf8_validation: bool = False, **_):
         """
         Initialize WebSocket object.
 
@@ -133,7 +133,7 @@ class WebSocket:
         """
         self.get_mask_key = func
 
-    def gettimeout(self):
+    def gettimeout(self) -> float:
         """
         Get the websocket timeout (in seconds) as an int or float
 
@@ -144,7 +144,7 @@ class WebSocket:
         """
         return self.sock_opt.timeout
 
-    def settimeout(self, timeout):
+    def settimeout(self, timeout: float):
         """
         Set the timeout to the websocket.
 
@@ -265,7 +265,7 @@ class WebSocket:
                 self.sock = None
             raise
 
-    def send(self, payload, opcode=ABNF.OPCODE_TEXT):
+    def send(self, payload: bytes or str, opcode: int = ABNF.OPCODE_TEXT) -> int:
         """
         Send the data as string.
 
@@ -282,7 +282,7 @@ class WebSocket:
         frame = ABNF.create_frame(payload, opcode)
         return self.send_frame(frame)
 
-    def send_frame(self, frame):
+    def send_frame(self, frame) -> int:
         """
         Send the data frame.
 
@@ -313,7 +313,7 @@ class WebSocket:
 
         return length
 
-    def send_binary(self, payload):
+    def send_binary(self, payload: bytes) -> int:
         """
         Send a binary message (OPCODE_BINARY).
 
@@ -324,7 +324,7 @@ class WebSocket:
         """
         return self.send(payload, ABNF.OPCODE_BINARY)
 
-    def ping(self, payload=""):
+    def ping(self, payload: str or bytes = ""):
         """
         Send ping data.
 
@@ -337,7 +337,7 @@ class WebSocket:
             payload = payload.encode("utf-8")
         self.send(payload, ABNF.OPCODE_PING)
 
-    def pong(self, payload=""):
+    def pong(self, payload: str or bytes = ""):
         """
         Send pong data.
 
@@ -350,7 +350,7 @@ class WebSocket:
             payload = payload.encode("utf-8")
         self.send(payload, ABNF.OPCODE_PONG)
 
-    def recv(self):
+    def recv(self) -> str or bytes:
         """
         Receive string data(byte array) from the server.
 
@@ -367,7 +367,7 @@ class WebSocket:
         else:
             return ''
 
-    def recv_data(self, control_frame=False):
+    def recv_data(self, control_frame: bool = False) -> tuple:
         """
         Receive data with operation code.
 
@@ -385,7 +385,7 @@ class WebSocket:
         opcode, frame = self.recv_data_frame(control_frame)
         return opcode, frame.data
 
-    def recv_data_frame(self, control_frame=False):
+    def recv_data_frame(self, control_frame: bool = False):
         """
         Receive data with operation code.
 
@@ -411,7 +411,7 @@ class WebSocket:
                 # handle error:
                 # 'NoneType' object has no attribute 'opcode'
                 raise WebSocketProtocolException(
-                    "Not a valid frame %s" % frame)
+                    "Not a valid frame {frame}".format(frame=frame))
             elif frame.opcode in (ABNF.OPCODE_TEXT, ABNF.OPCODE_BINARY, ABNF.OPCODE_CONT):
                 self.cont_frame.validate(frame)
                 self.cont_frame.add(frame)
@@ -444,7 +444,7 @@ class WebSocket:
         """
         return self.frame_buffer.recv_frame()
 
-    def send_close(self, status=STATUS_NORMAL, reason=b""):
+    def send_close(self, status: int = STATUS_NORMAL, reason: bytes = b""):
         """
         Send close data to the server.
 
@@ -460,14 +460,14 @@ class WebSocket:
         self.connected = False
         self.send(struct.pack('!H', status) + reason, ABNF.OPCODE_CLOSE)
 
-    def close(self, status=STATUS_NORMAL, reason=b"", timeout=3):
+    def close(self, status: int = STATUS_NORMAL, reason: bytes = b"", timeout: float = 3):
         """
         Close Websocket object
 
         Parameters
         ----------
         status: int
-            Status code to send. See STATUS_XXX.
+            Status code to send. See VALID_CLOSE_STATUS in ABNF.
         reason: bytes
             The reason to close in UTF-8.
         timeout: int or float
@@ -521,7 +521,7 @@ class WebSocket:
             self.sock = None
             self.connected = False
 
-    def _send(self, data):
+    def _send(self, data: str or bytes):
         return send(self.sock, data)
 
     def _recv(self, bufsize):
@@ -535,7 +535,7 @@ class WebSocket:
             raise
 
 
-def create_connection(url, timeout=None, class_=WebSocket, **options):
+def create_connection(url: str, timeout=None, class_=WebSocket, **options):
     """
     Connect to url and return websocket object.
 
diff --git a/lib/websocket/_exceptions.py b/lib/websocket/_exceptions.py
index 811d5945..48f40a07 100644
--- a/lib/websocket/_exceptions.py
+++ b/lib/websocket/_exceptions.py
@@ -2,7 +2,7 @@
 _exceptions.py
 websocket - WebSocket client library for Python
 
-Copyright 2022 engn33r
+Copyright 2023 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
@@ -66,11 +66,11 @@ class WebSocketBadStatusException(WebSocketException):
     WebSocketBadStatusException will be raised when we get bad handshake status code.
     """
 
-    def __init__(self, message, status_code, status_message=None, resp_headers=None):
-        msg = message % (status_code, status_message)
-        super().__init__(msg)
+    def __init__(self, message: str, status_code: int, status_message=None, resp_headers=None, resp_body=None):
+        super().__init__(message)
         self.status_code = status_code
         self.resp_headers = resp_headers
+        self.resp_body = resp_body
 
 
 class WebSocketAddressException(WebSocketException):
diff --git a/lib/websocket/_handshake.py b/lib/websocket/_handshake.py
index 07a4cfb2..d28aefd7 100644
--- a/lib/websocket/_handshake.py
+++ b/lib/websocket/_handshake.py
@@ -2,7 +2,7 @@
 _handshake.py
 websocket - WebSocket client library for Python
 
-Copyright 2022 engn33r
+Copyright 2023 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
@@ -40,14 +40,14 @@ CookieJar = SimpleCookieJar()
 
 class handshake_response:
 
-    def __init__(self, status, headers, subprotocol):
+    def __init__(self, status: int, headers: dict, subprotocol):
         self.status = status
         self.headers = headers
         self.subprotocol = subprotocol
         CookieJar.add(headers.get("set-cookie"))
 
 
-def handshake(sock, url, hostname, port, resource, **options):
+def handshake(sock, url: str, hostname: str, port: int, resource: str, **options):
     headers, key = _get_handshake_headers(resource, url, hostname, port, options)
 
     header_str = "\r\n".join(headers)
@@ -64,7 +64,7 @@ def handshake(sock, url, hostname, port, resource, **options):
     return handshake_response(status, resp, subproto)
 
 
-def _pack_hostname(hostname):
+def _pack_hostname(hostname: str) -> str:
     # IPv6 address
     if ':' in hostname:
         return '[' + hostname + ']'
@@ -72,41 +72,41 @@ def _pack_hostname(hostname):
     return hostname
 
 
-def _get_handshake_headers(resource, url, host, port, options):
+def _get_handshake_headers(resource: str, url: str, host: str, port: int, options: dict):
     headers = [
-        "GET %s HTTP/1.1" % resource,
+        "GET {resource} HTTP/1.1".format(resource=resource),
         "Upgrade: websocket"
     ]
     if port == 80 or port == 443:
         hostport = _pack_hostname(host)
     else:
-        hostport = "%s:%d" % (_pack_hostname(host), port)
+        hostport = "{h}:{p}".format(h=_pack_hostname(host), p=port)
     if options.get("host"):
-        headers.append("Host: %s" % options["host"])
+        headers.append("Host: {h}".format(h=options["host"]))
     else:
-        headers.append("Host: %s" % hostport)
+        headers.append("Host: {hp}".format(hp=hostport))
 
     # scheme indicates whether http or https is used in Origin
     # The same approach is used in parse_url of _url.py to set default port
     scheme, url = url.split(":", 1)
     if not options.get("suppress_origin"):
         if "origin" in options and options["origin"] is not None:
-            headers.append("Origin: %s" % options["origin"])
+            headers.append("Origin: {origin}".format(origin=options["origin"]))
         elif scheme == "wss":
-            headers.append("Origin: https://%s" % hostport)
+            headers.append("Origin: https://{hp}".format(hp=hostport))
         else:
-            headers.append("Origin: http://%s" % hostport)
+            headers.append("Origin: http://{hp}".format(hp=hostport))
 
     key = _create_sec_websocket_key()
 
     # Append Sec-WebSocket-Key & Sec-WebSocket-Version if not manually specified
     if not options.get('header') or 'Sec-WebSocket-Key' not in options['header']:
-        headers.append("Sec-WebSocket-Key: %s" % key)
+        headers.append("Sec-WebSocket-Key: {key}".format(key=key))
     else:
         key = options['header']['Sec-WebSocket-Key']
 
     if not options.get('header') or 'Sec-WebSocket-Version' not in options['header']:
-        headers.append("Sec-WebSocket-Version: %s" % VERSION)
+        headers.append("Sec-WebSocket-Version: {version}".format(version=VERSION))
 
     if not options.get('connection'):
         headers.append('Connection: Upgrade')
@@ -115,7 +115,7 @@ def _get_handshake_headers(resource, url, host, port, options):
 
     subprotocols = options.get("subprotocols")
     if subprotocols:
-        headers.append("Sec-WebSocket-Protocol: %s" % ",".join(subprotocols))
+        headers.append("Sec-WebSocket-Protocol: {protocols}".format(protocols=",".join(subprotocols)))
 
     header = options.get("header")
     if header:
@@ -133,18 +133,21 @@ def _get_handshake_headers(resource, url, host, port, options):
     cookie = "; ".join(filter(None, [server_cookie, client_cookie]))
 
     if cookie:
-        headers.append("Cookie: %s" % cookie)
-
-    headers.append("")
-    headers.append("")
+        headers.append("Cookie: {cookie}".format(cookie=cookie))
 
+    headers.extend(("", ""))
     return headers, key
 
 
-def _get_resp_headers(sock, success_statuses=SUCCESS_STATUSES):
+def _get_resp_headers(sock, success_statuses: tuple = SUCCESS_STATUSES) -> tuple:
     status, resp_headers, status_message = read_headers(sock)
     if status not in success_statuses:
-        raise WebSocketBadStatusException("Handshake status %d %s", status, status_message, resp_headers)
+        content_len = resp_headers.get('content-length')
+        if content_len:
+            response_body = sock.recv(int(content_len))  # read the body of the HTTP error message response and include it in the exception
+        else:
+            response_body = None
+        raise WebSocketBadStatusException("Handshake status {status} {message} -+-+- {headers} -+-+- {body}".format(status=status, message=status_message, headers=resp_headers, body=response_body), status, status_message, resp_headers, response_body)
     return status, resp_headers
 
 
@@ -154,7 +157,7 @@ _HEADERS_TO_CHECK = {
 }
 
 
-def _validate(headers, key, subprotocols):
+def _validate(headers, key: str, subprotocols):
     subproto = None
     for k, v in _HEADERS_TO_CHECK.items():
         r = headers.get(k, None)
@@ -189,6 +192,6 @@ def _validate(headers, key, subprotocols):
         return False, None
 
 
-def _create_sec_websocket_key():
+def _create_sec_websocket_key() -> str:
     randomness = os.urandom(16)
     return base64encode(randomness).decode('utf-8').strip()
diff --git a/lib/websocket/_http.py b/lib/websocket/_http.py
index 17d3f8aa..13183b20 100644
--- a/lib/websocket/_http.py
+++ b/lib/websocket/_http.py
@@ -2,7 +2,7 @@
 _http.py
 websocket - WebSocket client library for Python
 
-Copyright 2022 engn33r
+Copyright 2023 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
@@ -19,7 +19,6 @@ limitations under the License.
 import errno
 import os
 import socket
-import sys
 
 from ._exceptions import *
 from ._logging import *
@@ -69,7 +68,7 @@ class proxy_info:
             self.proxy_protocol = "http"
 
 
-def _start_proxied_socket(url, options, proxy):
+def _start_proxied_socket(url: str, options, proxy):
     if not HAVE_PYTHON_SOCKS:
         raise WebSocketException("Python Socks is needed for SOCKS proxying but is not available")
 
@@ -107,7 +106,7 @@ def _start_proxied_socket(url, options, proxy):
     return sock, (hostname, port, resource)
 
 
-def connect(url, options, proxy, socket):
+def connect(url: str, options, proxy, socket):
     # Use _start_proxied_socket() only for socks4 or socks5 proxy
     # Use _tunnel() for http proxy
     # TODO: Use python-socks for http protocol also, to standardize flow
@@ -211,6 +210,11 @@ def _wrap_sni_socket(sock, sslopt, hostname, check_hostname):
     context = sslopt.get('context', None)
     if not context:
         context = ssl.SSLContext(sslopt.get('ssl_version', ssl.PROTOCOL_TLS_CLIENT))
+        # Non default context need to manually enable SSLKEYLOGFILE support by setting the keylog_filename attribute.
+        # For more details see also:
+        # * https://docs.python.org/3.8/library/ssl.html?highlight=sslkeylogfile#context-creation
+        # * https://docs.python.org/3.8/library/ssl.html?highlight=sslkeylogfile#ssl.SSLContext.keylog_filename
+        context.keylog_filename = os.environ.get("SSLKEYLOGFILE", None)
 
         if sslopt.get('cert_reqs', ssl.CERT_NONE) != ssl.CERT_NONE:
             cafile = sslopt.get('ca_certs', None)
@@ -275,8 +279,8 @@ def _ssl_socket(sock, user_sslopt, hostname):
 
 def _tunnel(sock, host, port, auth):
     debug("Connecting proxy...")
-    connect_header = "CONNECT %s:%d HTTP/1.1\r\n" % (host, port)
-    connect_header += "Host: %s:%d\r\n" % (host, port)
+    connect_header = "CONNECT {h}:{p} HTTP/1.1\r\n".format(h=host, p=port)
+    connect_header += "Host: {h}:{p}\r\n".format(h=host, p=port)
 
     # TODO: support digest auth.
     if auth and auth[0]:
@@ -284,7 +288,7 @@ def _tunnel(sock, host, port, auth):
         if auth[1]:
             auth_str += ":" + auth[1]
         encoded_str = base64encode(auth_str.encode()).strip().decode().replace('\n', '')
-        connect_header += "Proxy-Authorization: Basic %s\r\n" % encoded_str
+        connect_header += "Proxy-Authorization: Basic {str}\r\n".format(str=encoded_str)
     connect_header += "\r\n"
     dump("request header", connect_header)
 
@@ -297,7 +301,7 @@ def _tunnel(sock, host, port, auth):
 
     if status != 200:
         raise WebSocketProxyException(
-            "failed CONNECT via proxy status: %r" % status)
+            "failed CONNECT via proxy status: {status}".format(status=status))
 
     return sock
 
diff --git a/lib/websocket/_logging.py b/lib/websocket/_logging.py
index 3921111d..806de4d4 100644
--- a/lib/websocket/_logging.py
+++ b/lib/websocket/_logging.py
@@ -4,7 +4,7 @@ import logging
 _logging.py
 websocket - WebSocket client library for Python
 
-Copyright 2022 engn33r
+Copyright 2023 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
@@ -24,7 +24,7 @@ try:
     from logging import NullHandler
 except ImportError:
     class NullHandler(logging.Handler):
-        def emit(self, record):
+        def emit(self, record) -> None:
             pass
 
 _logger.addHandler(NullHandler())
@@ -35,7 +35,9 @@ __all__ = ["enableTrace", "dump", "error", "warning", "debug", "trace",
            "isEnabledForError", "isEnabledForDebug", "isEnabledForTrace"]
 
 
-def enableTrace(traceable, handler=logging.StreamHandler(), level="DEBUG"):
+def enableTrace(traceable: bool,
+                handler: logging.StreamHandler = logging.StreamHandler(),
+                level: str = "DEBUG") -> None:
     """
     Turn on/off the traceability.
 
@@ -51,41 +53,41 @@ def enableTrace(traceable, handler=logging.StreamHandler(), level="DEBUG"):
         _logger.setLevel(getattr(logging, level))
 
 
-def dump(title, message):
+def dump(title: str, message: str) -> None:
     if _traceEnabled:
         _logger.debug("--- " + title + " ---")
         _logger.debug(message)
         _logger.debug("-----------------------")
 
 
-def error(msg):
+def error(msg: str) -> None:
     _logger.error(msg)
 
 
-def warning(msg):
+def warning(msg: str) -> None:
     _logger.warning(msg)
 
 
-def debug(msg):
+def debug(msg: str) -> None:
     _logger.debug(msg)
 
 
-def info(msg):
+def info(msg: str) -> None:
     _logger.info(msg)
 
 
-def trace(msg):
+def trace(msg: str) -> None:
     if _traceEnabled:
         _logger.debug(msg)
 
 
-def isEnabledForError():
+def isEnabledForError() -> bool:
     return _logger.isEnabledFor(logging.ERROR)
 
 
-def isEnabledForDebug():
+def isEnabledForDebug() -> bool:
     return _logger.isEnabledFor(logging.DEBUG)
 
 
-def isEnabledForTrace():
+def isEnabledForTrace() -> bool:
     return _traceEnabled
diff --git a/lib/websocket/_socket.py b/lib/websocket/_socket.py
index 7cc02164..e8858fc8 100644
--- a/lib/websocket/_socket.py
+++ b/lib/websocket/_socket.py
@@ -10,7 +10,7 @@ from ._utils import *
 _socket.py
 websocket - WebSocket client library for Python
 
-Copyright 2022 engn33r
+Copyright 2023 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
@@ -43,7 +43,7 @@ __all__ = ["DEFAULT_SOCKET_OPTION", "sock_opt", "setdefaulttimeout", "getdefault
 
 class sock_opt:
 
-    def __init__(self, sockopt, sslopt):
+    def __init__(self, sockopt: list, sslopt: dict) -> None:
         if sockopt is None:
             sockopt = []
         if sslopt is None:
@@ -53,7 +53,7 @@ class sock_opt:
         self.timeout = None
 
 
-def setdefaulttimeout(timeout):
+def setdefaulttimeout(timeout: int or float) -> None:
     """
     Set the global timeout setting to connect.
 
@@ -66,7 +66,7 @@ def setdefaulttimeout(timeout):
     _default_timeout = timeout
 
 
-def getdefaulttimeout():
+def getdefaulttimeout() -> int or float:
     """
     Get default timeout
 
@@ -78,7 +78,7 @@ def getdefaulttimeout():
     return _default_timeout
 
 
-def recv(sock, bufsize):
+def recv(sock: socket.socket, bufsize: int) -> bytes:
     if not sock:
         raise WebSocketConnectionClosedException("socket is already closed.")
 
@@ -125,7 +125,7 @@ def recv(sock, bufsize):
     return bytes_
 
 
-def recv_line(sock):
+def recv_line(sock: socket.socket) -> bytes:
     line = []
     while True:
         c = recv(sock, 1)
@@ -135,7 +135,7 @@ def recv_line(sock):
     return b''.join(line)
 
 
-def send(sock, data):
+def send(sock: socket.socket, data: bytes) -> int:
     if isinstance(data, str):
         data = data.encode('utf-8')
 
diff --git a/lib/websocket/_ssl_compat.py b/lib/websocket/_ssl_compat.py
index e2278401..b2eba387 100644
--- a/lib/websocket/_ssl_compat.py
+++ b/lib/websocket/_ssl_compat.py
@@ -2,7 +2,7 @@
 _ssl_compat.py
 websocket - WebSocket client library for Python
 
-Copyright 2022 engn33r
+Copyright 2023 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
diff --git a/lib/websocket/_url.py b/lib/websocket/_url.py
index 2d3d2653..2141b021 100644
--- a/lib/websocket/_url.py
+++ b/lib/websocket/_url.py
@@ -8,7 +8,7 @@ from urllib.parse import unquote, urlparse
 _url.py
 websocket - WebSocket client library for Python
 
-Copyright 2022 engn33r
+Copyright 2023 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
@@ -26,7 +26,7 @@ limitations under the License.
 __all__ = ["parse_url", "get_proxy_info"]
 
 
-def parse_url(url):
+def parse_url(url: str) -> tuple:
     """
     parse url and the result is tuple of
     (hostname, port, resource path and the flag of secure mode)
@@ -75,7 +75,7 @@ def parse_url(url):
 DEFAULT_NO_PROXY_HOST = ["localhost", "127.0.0.1"]
 
 
-def _is_ip_address(addr):
+def _is_ip_address(addr: str) -> bool:
     try:
         socket.inet_aton(addr)
     except socket.error:
@@ -84,7 +84,7 @@ def _is_ip_address(addr):
         return True
 
 
-def _is_subnet_address(hostname):
+def _is_subnet_address(hostname: str) -> bool:
     try:
         addr, netmask = hostname.split("/")
         return _is_ip_address(addr) and 0 <= int(netmask) < 32
@@ -92,7 +92,7 @@ def _is_subnet_address(hostname):
         return False
 
 
-def _is_address_in_network(ip, net):
+def _is_address_in_network(ip: str, net: str) -> bool:
     ipaddr = struct.unpack('!I', socket.inet_aton(ip))[0]
     netaddr, netmask = net.split('/')
     netaddr = struct.unpack('!I', socket.inet_aton(netaddr))[0]
@@ -101,7 +101,7 @@ def _is_address_in_network(ip, net):
     return ipaddr & netmask == netaddr
 
 
-def _is_no_proxy_host(hostname, no_proxy):
+def _is_no_proxy_host(hostname: str, no_proxy: list) -> bool:
     if not no_proxy:
         v = os.environ.get("no_proxy", os.environ.get("NO_PROXY", "")).replace(" ", "")
         if v:
@@ -122,8 +122,8 @@ def _is_no_proxy_host(hostname, no_proxy):
 
 
 def get_proxy_info(
-        hostname, is_secure, proxy_host=None, proxy_port=0, proxy_auth=None,
-        no_proxy=None, proxy_type='http'):
+        hostname: str, is_secure: bool, proxy_host: str = None, proxy_port: int = 0, proxy_auth: tuple = None,
+        no_proxy: list = None, proxy_type: str = 'http') -> tuple:
     """
     Try to retrieve proxy host and port from environment
     if not provided in options.
@@ -137,14 +137,14 @@ def get_proxy_info(
         Websocket server name.
     is_secure: bool
         Is the connection secure? (wss) looks for "https_proxy" in env
-        before falling back to "http_proxy"
+        instead of "http_proxy"
     proxy_host: str
         http proxy host name.
-    http_proxy_port: str or int
+    proxy_port: str or int
         http proxy port.
-    http_no_proxy: list
+    no_proxy: list
         Whitelisted host names that don't use the proxy.
-    http_proxy_auth: tuple
+    proxy_auth: tuple
         HTTP proxy auth information. Tuple of username and password. Default is None.
     proxy_type: str
         Specify the proxy protocol (http, socks4, socks4a, socks5, socks5h). Default is "http".
@@ -158,15 +158,11 @@ def get_proxy_info(
         auth = proxy_auth
         return proxy_host, port, auth
 
-    env_keys = ["http_proxy"]
-    if is_secure:
-        env_keys.insert(0, "https_proxy")
-
-    for key in env_keys:
-        value = os.environ.get(key, os.environ.get(key.upper(), "")).replace(" ", "")
-        if value:
-            proxy = urlparse(value)
-            auth = (unquote(proxy.username), unquote(proxy.password)) if proxy.username else None
-            return proxy.hostname, proxy.port, auth
+    env_key = "https_proxy" if is_secure else "http_proxy"
+    value = os.environ.get(env_key, os.environ.get(env_key.upper(), "")).replace(" ", "")
+    if value:
+        proxy = urlparse(value)
+        auth = (unquote(proxy.username), unquote(proxy.password)) if proxy.username else None
+        return proxy.hostname, proxy.port, auth
 
     return None, 0, None
diff --git a/lib/websocket/_utils.py b/lib/websocket/_utils.py
index fdcf345b..3db2d83b 100644
--- a/lib/websocket/_utils.py
+++ b/lib/websocket/_utils.py
@@ -2,7 +2,7 @@
 _url.py
 websocket - WebSocket client library for Python
 
-Copyright 2022 engn33r
+Copyright 2023 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
@@ -21,10 +21,10 @@ __all__ = ["NoLock", "validate_utf8", "extract_err_message", "extract_error_code
 
 class NoLock:
 
-    def __enter__(self):
+    def __enter__(self) -> None:
         pass
 
-    def __exit__(self, exc_type, exc_value, traceback):
+    def __exit__(self, exc_type, exc_value, traceback) -> None:
         pass
 
 
@@ -33,7 +33,7 @@ try:
     # strings.
     from wsaccel.utf8validator import Utf8Validator
 
-    def _validate_utf8(utfbytes):
+    def _validate_utf8(utfbytes: bytes) -> bool:
         return Utf8Validator().validate(utfbytes)[0]
 
 except ImportError:
@@ -63,7 +63,7 @@ except ImportError:
         12,12,12,12,12,12,12,36,12,36,12,12, 12,36,12,12,12,12,12,36,12,36,12,12,
         12,36,12,12,12,12,12,12,12,12,12,12, ]
 
-    def _decode(state, codep, ch):
+    def _decode(state: int, codep: int, ch: int) -> tuple:
         tp = _UTF8D[ch]
 
         codep = (ch & 0x3f) | (codep << 6) if (
@@ -72,7 +72,7 @@ except ImportError:
 
         return state, codep
 
-    def _validate_utf8(utfbytes):
+    def _validate_utf8(utfbytes: str or bytes) -> bool:
         state = _UTF8_ACCEPT
         codep = 0
         for i in utfbytes:
@@ -83,7 +83,7 @@ except ImportError:
         return True
 
 
-def validate_utf8(utfbytes):
+def validate_utf8(utfbytes: str or bytes) -> bool:
     """
     validate utf8 byte string.
     utfbytes: utf byte string to check.
@@ -92,13 +92,13 @@ def validate_utf8(utfbytes):
     return _validate_utf8(utfbytes)
 
 
-def extract_err_message(exception):
+def extract_err_message(exception: Exception) -> str or None:
     if exception.args:
         return exception.args[0]
     else:
         return None
 
 
-def extract_error_code(exception):
+def extract_error_code(exception: Exception) -> int or None:
     if exception.args and len(exception.args) > 1:
         return exception.args[0] if isinstance(exception.args[0], int) else None
diff --git a/lib/websocket/_wsdump.py b/lib/websocket/_wsdump.py
index 860ac342..d637ce2b 100644
--- a/lib/websocket/_wsdump.py
+++ b/lib/websocket/_wsdump.py
@@ -4,7 +4,7 @@
 wsdump.py
 websocket - WebSocket client library for Python
 
-Copyright 2022 engn33r
+Copyright 2023 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
@@ -37,7 +37,7 @@ except ImportError:
     pass
 
 
-def get_encoding():
+def get_encoding() -> str:
     encoding = getattr(sys.stdin, "encoding", "")
     if not encoding:
         return "utf-8"
@@ -51,7 +51,7 @@ ENCODING = get_encoding()
 
 class VAction(argparse.Action):
 
-    def __call__(self, parser, args, values, option_string=None):
+    def __call__(self, parser: argparse.Namespace, args: tuple, values: str, option_string: str = None) -> None:
         if values is None:
             values = "1"
         try:
@@ -61,7 +61,7 @@ class VAction(argparse.Action):
         setattr(args, self.dest, values)
 
 
-def parse_args():
+def parse_args() -> argparse.Namespace:
     parser = argparse.ArgumentParser(description="WebSocket Simple Dump Tool")
     parser.add_argument("url", metavar="ws_url",
                         help="websocket url. ex. ws://echo.websocket.events/")
@@ -93,7 +93,7 @@ def parse_args():
 
 class RawInput:
 
-    def raw_input(self, prompt):
+    def raw_input(self, prompt: str = "") -> str:
         line = input(prompt)
 
         if ENCODING and ENCODING != "utf-8" and not isinstance(line, str):
@@ -106,29 +106,29 @@ class RawInput:
 
 class InteractiveConsole(RawInput, code.InteractiveConsole):
 
-    def write(self, data):
+    def write(self, data: str) -> None:
         sys.stdout.write("\033[2K\033[E")
         # sys.stdout.write("\n")
         sys.stdout.write("\033[34m< " + data + "\033[39m")
         sys.stdout.write("\n> ")
         sys.stdout.flush()
 
-    def read(self):
+    def read(self) -> str:
         return self.raw_input("> ")
 
 
 class NonInteractive(RawInput):
 
-    def write(self, data):
+    def write(self, data: str) -> None:
         sys.stdout.write(data)
         sys.stdout.write("\n")
         sys.stdout.flush()
 
-    def read(self):
+    def read(self) -> str:
         return self.raw_input("")
 
 
-def main():
+def main() -> None:
     start_time = time.time()
     args = parse_args()
     if args.verbose > 1:
@@ -154,25 +154,25 @@ def main():
         console = InteractiveConsole()
         print("Press Ctrl+C to quit")
 
-    def recv():
+    def recv() -> tuple:
         try:
             frame = ws.recv_frame()
         except websocket.WebSocketException:
-            return websocket.ABNF.OPCODE_CLOSE, None
+            return websocket.ABNF.OPCODE_CLOSE, ""
         if not frame:
-            raise websocket.WebSocketException("Not a valid frame %s" % frame)
+            raise websocket.WebSocketException("Not a valid frame {frame}".format(frame=frame))
         elif frame.opcode in OPCODE_DATA:
             return frame.opcode, frame.data
         elif frame.opcode == websocket.ABNF.OPCODE_CLOSE:
             ws.send_close()
-            return frame.opcode, None
+            return frame.opcode, ""
         elif frame.opcode == websocket.ABNF.OPCODE_PING:
             ws.pong(frame.data)
             return frame.opcode, frame.data
 
         return frame.opcode, frame.data
 
-    def recv_ws():
+    def recv_ws() -> None:
         while True:
             opcode, data = recv()
             msg = None
@@ -193,7 +193,7 @@ def main():
                 data = repr(data)
 
             if args.verbose:
-                msg = "%s: %s" % (websocket.ABNF.OPCODE_MAP.get(opcode), data)
+                msg = "{opcode}: {data}".format(opcode=websocket.ABNF.OPCODE_MAP.get(opcode), data=data)
             else:
                 msg = data
 
diff --git a/lib/websocket/tests/echo-server.py b/lib/websocket/tests/echo-server.py
index 08d108ab..42dd9e43 100644
--- a/lib/websocket/tests/echo-server.py
+++ b/lib/websocket/tests/echo-server.py
@@ -6,7 +6,7 @@ import asyncio
 import websockets
 import os
 
-LOCAL_WS_SERVER_PORT = os.environ.get('LOCAL_WS_SERVER_PORT', '8765')
+LOCAL_WS_SERVER_PORT = int(os.environ.get('LOCAL_WS_SERVER_PORT', '8765'))
 
 
 async def echo(websocket, path):
diff --git a/lib/websocket/tests/test_abnf.py b/lib/websocket/tests/test_abnf.py
index 7c9d89d8..dbf9b636 100644
--- a/lib/websocket/tests/test_abnf.py
+++ b/lib/websocket/tests/test_abnf.py
@@ -8,7 +8,7 @@ import unittest
 test_abnf.py
 websocket - WebSocket client library for Python
 
-Copyright 2022 engn33r
+Copyright 2023 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
diff --git a/lib/websocket/tests/test_app.py b/lib/websocket/tests/test_app.py
index ac563c6e..ff90a0aa 100644
--- a/lib/websocket/tests/test_app.py
+++ b/lib/websocket/tests/test_app.py
@@ -11,7 +11,7 @@ import unittest
 test_app.py
 websocket - WebSocket client library for Python
 
-Copyright 2022 engn33r
+Copyright 2023 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
@@ -112,25 +112,6 @@ class WebSocketAppTest(unittest.TestCase):
         teardown = app.run_forever()
         self.assertEqual(teardown, False)
 
-    @unittest.skipUnless(TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled")
-    def testRunForeverTeardownExceptionalExit(self):
-        """ The WebSocketApp.run_forever() method should return `True` when the application ends with an exception.
-        It should also invoke the `on_error` callback before exiting.
-        """
-
-        def break_it():
-            # Deliberately break the WebSocketApp by closing the inner socket.
-            app.sock.close()
-
-        def on_error(_, err):
-            WebSocketAppTest.on_error_data = str(err)
-
-        app = ws.WebSocketApp('ws://127.0.0.1:' + LOCAL_WS_SERVER_PORT, on_error=on_error)
-        threading.Timer(interval=0.2, function=break_it).start()
-        teardown = app.run_forever(ping_timeout=0.1)
-        self.assertEqual(teardown, True)
-        self.assertTrue(len(WebSocketAppTest.on_error_data) > 0)
-
     @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled")
     def testSockMaskKey(self):
         """ A WebSocketApp should forward the received mask_key function down
@@ -310,8 +291,8 @@ class WebSocketAppTest(unittest.TestCase):
         app.run_forever(ping_interval=2, ping_timeout=1, reconnect=3)
 
         self.assertEqual(pong_count, 2)
-        self.assertIsInstance(exc, ValueError)
-        self.assertEqual(str(exc), "Invalid file object: None")
+        self.assertIsInstance(exc, ws.WebSocketTimeoutException)
+        self.assertEqual(str(exc), "ping/pong timed out")
 
 
 if __name__ == "__main__":
diff --git a/lib/websocket/tests/test_cookiejar.py b/lib/websocket/tests/test_cookiejar.py
index 559b2e00..8f835e9e 100644
--- a/lib/websocket/tests/test_cookiejar.py
+++ b/lib/websocket/tests/test_cookiejar.py
@@ -5,7 +5,7 @@ from websocket._cookiejar import SimpleCookieJar
 test_cookiejar.py
 websocket - WebSocket client library for Python
 
-Copyright 2022 engn33r
+Copyright 2023 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
diff --git a/lib/websocket/tests/test_http.py b/lib/websocket/tests/test_http.py
index ffcbde25..d7de29d3 100644
--- a/lib/websocket/tests/test_http.py
+++ b/lib/websocket/tests/test_http.py
@@ -13,7 +13,7 @@ import socket
 test_http.py
 websocket - WebSocket client library for Python
 
-Copyright 2022 engn33r
+Copyright 2023 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
diff --git a/lib/websocket/tests/test_url.py b/lib/websocket/tests/test_url.py
index 7e155fd1..a74dd766 100644
--- a/lib/websocket/tests/test_url.py
+++ b/lib/websocket/tests/test_url.py
@@ -8,7 +8,7 @@ from websocket._url import get_proxy_info, parse_url, _is_address_in_network, _i
 test_url.py
 websocket - WebSocket client library for Python
 
-Copyright 2022 engn33r
+Copyright 2023 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
@@ -254,6 +254,24 @@ class ProxyInfoTest(unittest.TestCase):
         os.environ["https_proxy"] = "http://localhost2:3128/"
         self.assertEqual(get_proxy_info("echo.websocket.events", True), ("localhost2", 3128, None))
 
+        os.environ["http_proxy"] = ""
+        os.environ["https_proxy"] = "http://localhost2/"
+        self.assertEqual(get_proxy_info("echo.websocket.events", True), ("localhost2", None, None))
+        self.assertEqual(get_proxy_info("echo.websocket.events", False), (None, 0, None))
+        os.environ["http_proxy"] = ""
+        os.environ["https_proxy"] = "http://localhost2:3128/"
+        self.assertEqual(get_proxy_info("echo.websocket.events", True), ("localhost2", 3128, None))
+        self.assertEqual(get_proxy_info("echo.websocket.events", False), (None, 0, None))
+
+        os.environ["http_proxy"] = "http://localhost/"
+        os.environ["https_proxy"] = ""
+        self.assertEqual(get_proxy_info("echo.websocket.events", True), (None, 0, None))
+        self.assertEqual(get_proxy_info("echo.websocket.events", False), ("localhost", None, None))
+        os.environ["http_proxy"] = "http://localhost:3128/"
+        os.environ["https_proxy"] = ""
+        self.assertEqual(get_proxy_info("echo.websocket.events", True), (None, 0, None))
+        self.assertEqual(get_proxy_info("echo.websocket.events", False), ("localhost", 3128, None))
+
         os.environ["http_proxy"] = "http://a:b@localhost/"
         self.assertEqual(get_proxy_info("echo.websocket.events", False), ("localhost", None, ("a", "b")))
         os.environ["http_proxy"] = "http://a:b@localhost:3128/"
diff --git a/lib/websocket/tests/test_websocket.py b/lib/websocket/tests/test_websocket.py
index d47d73e5..a140066e 100644
--- a/lib/websocket/tests/test_websocket.py
+++ b/lib/websocket/tests/test_websocket.py
@@ -15,7 +15,7 @@ from base64 import decodebytes as base64decode
 test_websocket.py
 websocket - WebSocket client library for Python
 
-Copyright 2022 engn33r
+Copyright 2023 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
diff --git a/requirements.txt b/requirements.txt
index 0ac5222b..09b22544 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -47,7 +47,7 @@ tzdata==2023.3
 tzlocal==4.2
 urllib3==2.0.4
 webencodings==0.5.1
-websocket-client==1.5.1
+websocket-client==1.6.2
 xmltodict==0.13.0
 zipp==3.15.0
 

From d6b3ed178e708b1ababf58c5574553a004151694 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Wed, 23 Aug 2023 21:52:33 -0700
Subject: [PATCH 433/743] Downgraade urllib3==1.26.16

---
 lib/urllib3/__init__.py                       |   90 +-
 lib/urllib3/_base_connection.py               |  173 ---
 lib/urllib3/_collections.py                   |  402 +++---
 lib/urllib3/_version.py                       |    4 +-
 lib/urllib3/connection.py                     |  950 +++++----------
 lib/urllib3/connectionpool.py                 |  778 ++++++------
 lib/urllib3/contrib/_appengine_environ.py     |   36 +
 .../contrib/_securetransport/bindings.py      |  111 +-
 .../contrib/_securetransport/low_level.py     |  121 +-
 lib/urllib3/contrib/appengine.py              |  314 +++++
 lib/urllib3/contrib/ntlmpool.py               |  130 ++
 lib/urllib3/contrib/pyopenssl.py              |  383 +++---
 lib/urllib3/contrib/securetransport.py        |  398 +++---
 lib/urllib3/contrib/socks.py                  |   87 +-
 lib/urllib3/exceptions.py                     |  189 +--
 lib/urllib3/fields.py                         |  267 ++--
 lib/urllib3/filepost.py                       |   65 +-
 lib/urllib3/packages/__init__.py              |    0
 lib/urllib3/packages/backports/__init__.py    |    0
 lib/urllib3/packages/backports/makefile.py    |   51 +
 .../packages/backports/weakref_finalize.py    |  155 +++
 lib/urllib3/packages/six.py                   | 1076 +++++++++++++++++
 lib/urllib3/poolmanager.py                    |  345 ++----
 lib/urllib3/py.typed                          |    2 -
 .../{_request_methods.py => request.py}       |  107 +-
 lib/urllib3/response.py                       |  895 +++++---------
 lib/urllib3/util/__init__.py                  |   17 +-
 lib/urllib3/util/connection.py                |   80 +-
 lib/urllib3/util/proxy.py                     |   38 +-
 lib/urllib3/util/queue.py                     |   22 +
 lib/urllib3/util/request.py                   |  170 +--
 lib/urllib3/util/response.py                  |   78 +-
 lib/urllib3/util/retry.py                     |  357 ++++--
 lib/urllib3/util/ssl_.py                      |  534 ++++----
 lib/urllib3/util/ssl_match_hostname.py        |   94 +-
 lib/urllib3/util/ssltransport.py              |  165 +--
 lib/urllib3/util/timeout.py                   |  112 +-
 lib/urllib3/util/url.py                       |  396 +++---
 lib/urllib3/util/util.py                      |   42 -
 lib/urllib3/util/wait.py                      |   88 +-
 40 files changed, 4877 insertions(+), 4445 deletions(-)
 delete mode 100644 lib/urllib3/_base_connection.py
 create mode 100644 lib/urllib3/contrib/_appengine_environ.py
 create mode 100644 lib/urllib3/contrib/appengine.py
 create mode 100644 lib/urllib3/contrib/ntlmpool.py
 create mode 100644 lib/urllib3/packages/__init__.py
 create mode 100644 lib/urllib3/packages/backports/__init__.py
 create mode 100644 lib/urllib3/packages/backports/makefile.py
 create mode 100644 lib/urllib3/packages/backports/weakref_finalize.py
 create mode 100644 lib/urllib3/packages/six.py
 delete mode 100644 lib/urllib3/py.typed
 rename lib/urllib3/{_request_methods.py => request.py} (63%)
 create mode 100644 lib/urllib3/util/queue.py
 delete mode 100644 lib/urllib3/util/util.py

diff --git a/lib/urllib3/__init__.py b/lib/urllib3/__init__.py
index 32c1f002..c6fa3821 100644
--- a/lib/urllib3/__init__.py
+++ b/lib/urllib3/__init__.py
@@ -1,48 +1,23 @@
 """
 Python HTTP library with thread-safe connection pooling, file post support, user friendly, and more
 """
-
-from __future__ import annotations
+from __future__ import absolute_import
 
 # Set default logging handler to avoid "No handler found" warnings.
 import logging
-import typing
 import warnings
 from logging import NullHandler
 
 from . import exceptions
-from ._base_connection import _TYPE_BODY
-from ._collections import HTTPHeaderDict
 from ._version import __version__
 from .connectionpool import HTTPConnectionPool, HTTPSConnectionPool, connection_from_url
-from .filepost import _TYPE_FIELDS, encode_multipart_formdata
+from .filepost import encode_multipart_formdata
 from .poolmanager import PoolManager, ProxyManager, proxy_from_url
-from .response import BaseHTTPResponse, HTTPResponse
+from .response import HTTPResponse
 from .util.request import make_headers
 from .util.retry import Retry
 from .util.timeout import Timeout
-
-# Ensure that Python is compiled with OpenSSL 1.1.1+
-# If the 'ssl' module isn't available at all that's
-# fine, we only care if the module is available.
-try:
-    import ssl
-except ImportError:
-    pass
-else:
-    if not ssl.OPENSSL_VERSION.startswith("OpenSSL "):  # Defensive:
-        warnings.warn(
-            "urllib3 v2.0 only supports OpenSSL 1.1.1+, currently "
-            f"the 'ssl' module is compiled with {ssl.OPENSSL_VERSION!r}. "
-            "See: https://github.com/urllib3/urllib3/issues/3020",
-            exceptions.NotOpenSSLWarning,
-        )
-    elif ssl.OPENSSL_VERSION_INFO < (1, 1, 1):  # Defensive:
-        raise ImportError(
-            "urllib3 v2.0 only supports OpenSSL 1.1.1+, currently "
-            f"the 'ssl' module is compiled with {ssl.OPENSSL_VERSION!r}. "
-            "See: https://github.com/urllib3/urllib3/issues/2168"
-        )
+from .util.url import get_host
 
 # === NOTE TO REPACKAGERS AND VENDORS ===
 # Please delete this block, this logic is only
@@ -50,12 +25,12 @@ else:
 # See: https://github.com/urllib3/urllib3/issues/2680
 try:
     import urllib3_secure_extra  # type: ignore # noqa: F401
-except ModuleNotFoundError:
+except ImportError:
     pass
 else:
     warnings.warn(
         "'urllib3[secure]' extra is deprecated and will be removed "
-        "in urllib3 v2.1.0. Read more in this issue: "
+        "in a future release of urllib3 2.x. Read more in this issue: "
         "https://github.com/urllib3/urllib3/issues/2680",
         category=DeprecationWarning,
         stacklevel=2,
@@ -67,7 +42,6 @@ __version__ = __version__
 
 __all__ = (
     "HTTPConnectionPool",
-    "HTTPHeaderDict",
     "HTTPSConnectionPool",
     "PoolManager",
     "ProxyManager",
@@ -78,18 +52,15 @@ __all__ = (
     "connection_from_url",
     "disable_warnings",
     "encode_multipart_formdata",
+    "get_host",
     "make_headers",
     "proxy_from_url",
-    "request",
-    "BaseHTTPResponse",
 )
 
 logging.getLogger(__name__).addHandler(NullHandler())
 
 
-def add_stderr_logger(
-    level: int = logging.DEBUG,
-) -> logging.StreamHandler[typing.TextIO]:
+def add_stderr_logger(level=logging.DEBUG):
     """
     Helper for quickly adding a StreamHandler to the logger. Useful for
     debugging.
@@ -116,51 +87,16 @@ del NullHandler
 # mechanisms to silence them.
 # SecurityWarning's always go off by default.
 warnings.simplefilter("always", exceptions.SecurityWarning, append=True)
+# SubjectAltNameWarning's should go off once per host
+warnings.simplefilter("default", exceptions.SubjectAltNameWarning, append=True)
 # InsecurePlatformWarning's don't vary between requests, so we keep it default.
 warnings.simplefilter("default", exceptions.InsecurePlatformWarning, append=True)
+# SNIMissingWarnings should go off only once.
+warnings.simplefilter("default", exceptions.SNIMissingWarning, append=True)
 
 
-def disable_warnings(category: type[Warning] = exceptions.HTTPWarning) -> None:
+def disable_warnings(category=exceptions.HTTPWarning):
     """
     Helper for quickly disabling all urllib3 warnings.
     """
     warnings.simplefilter("ignore", category)
-
-
-_DEFAULT_POOL = PoolManager()
-
-
-def request(
-    method: str,
-    url: str,
-    *,
-    body: _TYPE_BODY | None = None,
-    fields: _TYPE_FIELDS | None = None,
-    headers: typing.Mapping[str, str] | None = None,
-    preload_content: bool | None = True,
-    decode_content: bool | None = True,
-    redirect: bool | None = True,
-    retries: Retry | bool | int | None = None,
-    timeout: Timeout | float | int | None = 3,
-    json: typing.Any | None = None,
-) -> BaseHTTPResponse:
-    """
-    A convenience, top-level request method. It uses a module-global ``PoolManager`` instance.
-    Therefore, its side effects could be shared across dependencies relying on it.
-    To avoid side effects create a new ``PoolManager`` instance and use it instead.
-    The method does not accept low-level ``**urlopen_kw`` keyword arguments.
-    """
-
-    return _DEFAULT_POOL.request(
-        method,
-        url,
-        body=body,
-        fields=fields,
-        headers=headers,
-        preload_content=preload_content,
-        decode_content=decode_content,
-        redirect=redirect,
-        retries=retries,
-        timeout=timeout,
-        json=json,
-    )
diff --git a/lib/urllib3/_base_connection.py b/lib/urllib3/_base_connection.py
deleted file mode 100644
index 3afed765..00000000
--- a/lib/urllib3/_base_connection.py
+++ /dev/null
@@ -1,173 +0,0 @@
-from __future__ import annotations
-
-import typing
-
-from .util.connection import _TYPE_SOCKET_OPTIONS
-from .util.timeout import _DEFAULT_TIMEOUT, _TYPE_TIMEOUT
-from .util.url import Url
-
-_TYPE_BODY = typing.Union[bytes, typing.IO[typing.Any], typing.Iterable[bytes], str]
-
-
-class ProxyConfig(typing.NamedTuple):
-    ssl_context: ssl.SSLContext | None
-    use_forwarding_for_https: bool
-    assert_hostname: None | str | Literal[False]
-    assert_fingerprint: str | None
-
-
-class _ResponseOptions(typing.NamedTuple):
-    # TODO: Remove this in favor of a better
-    # HTTP request/response lifecycle tracking.
-    request_method: str
-    request_url: str
-    preload_content: bool
-    decode_content: bool
-    enforce_content_length: bool
-
-
-if typing.TYPE_CHECKING:
-    import ssl
-
-    from typing_extensions import Literal, Protocol
-
-    from .response import BaseHTTPResponse
-
-    class BaseHTTPConnection(Protocol):
-        default_port: typing.ClassVar[int]
-        default_socket_options: typing.ClassVar[_TYPE_SOCKET_OPTIONS]
-
-        host: str
-        port: int
-        timeout: None | (
-            float
-        )  # Instance doesn't store _DEFAULT_TIMEOUT, must be resolved.
-        blocksize: int
-        source_address: tuple[str, int] | None
-        socket_options: _TYPE_SOCKET_OPTIONS | None
-
-        proxy: Url | None
-        proxy_config: ProxyConfig | None
-
-        is_verified: bool
-        proxy_is_verified: bool | None
-
-        def __init__(
-            self,
-            host: str,
-            port: int | None = None,
-            *,
-            timeout: _TYPE_TIMEOUT = _DEFAULT_TIMEOUT,
-            source_address: tuple[str, int] | None = None,
-            blocksize: int = 8192,
-            socket_options: _TYPE_SOCKET_OPTIONS | None = ...,
-            proxy: Url | None = None,
-            proxy_config: ProxyConfig | None = None,
-        ) -> None:
-            ...
-
-        def set_tunnel(
-            self,
-            host: str,
-            port: int | None = None,
-            headers: typing.Mapping[str, str] | None = None,
-            scheme: str = "http",
-        ) -> None:
-            ...
-
-        def connect(self) -> None:
-            ...
-
-        def request(
-            self,
-            method: str,
-            url: str,
-            body: _TYPE_BODY | None = None,
-            headers: typing.Mapping[str, str] | None = None,
-            # We know *at least* botocore is depending on the order of the
-            # first 3 parameters so to be safe we only mark the later ones
-            # as keyword-only to ensure we have space to extend.
-            *,
-            chunked: bool = False,
-            preload_content: bool = True,
-            decode_content: bool = True,
-            enforce_content_length: bool = True,
-        ) -> None:
-            ...
-
-        def getresponse(self) -> BaseHTTPResponse:
-            ...
-
-        def close(self) -> None:
-            ...
-
-        @property
-        def is_closed(self) -> bool:
-            """Whether the connection either is brand new or has been previously closed.
-            If this property is True then both ``is_connected`` and ``has_connected_to_proxy``
-            properties must be False.
-            """
-
-        @property
-        def is_connected(self) -> bool:
-            """Whether the connection is actively connected to any origin (proxy or target)"""
-
-        @property
-        def has_connected_to_proxy(self) -> bool:
-            """Whether the connection has successfully connected to its proxy.
-            This returns False if no proxy is in use. Used to determine whether
-            errors are coming from the proxy layer or from tunnelling to the target origin.
-            """
-
-    class BaseHTTPSConnection(BaseHTTPConnection, Protocol):
-        default_port: typing.ClassVar[int]
-        default_socket_options: typing.ClassVar[_TYPE_SOCKET_OPTIONS]
-
-        # Certificate verification methods
-        cert_reqs: int | str | None
-        assert_hostname: None | str | Literal[False]
-        assert_fingerprint: str | None
-        ssl_context: ssl.SSLContext | None
-
-        # Trusted CAs
-        ca_certs: str | None
-        ca_cert_dir: str | None
-        ca_cert_data: None | str | bytes
-
-        # TLS version
-        ssl_minimum_version: int | None
-        ssl_maximum_version: int | None
-        ssl_version: int | str | None  # Deprecated
-
-        # Client certificates
-        cert_file: str | None
-        key_file: str | None
-        key_password: str | None
-
-        def __init__(
-            self,
-            host: str,
-            port: int | None = None,
-            *,
-            timeout: _TYPE_TIMEOUT = _DEFAULT_TIMEOUT,
-            source_address: tuple[str, int] | None = None,
-            blocksize: int = 8192,
-            socket_options: _TYPE_SOCKET_OPTIONS | None = ...,
-            proxy: Url | None = None,
-            proxy_config: ProxyConfig | None = None,
-            cert_reqs: int | str | None = None,
-            assert_hostname: None | str | Literal[False] = None,
-            assert_fingerprint: str | None = None,
-            server_hostname: str | None = None,
-            ssl_context: ssl.SSLContext | None = None,
-            ca_certs: str | None = None,
-            ca_cert_dir: str | None = None,
-            ca_cert_data: None | str | bytes = None,
-            ssl_minimum_version: int | None = None,
-            ssl_maximum_version: int | None = None,
-            ssl_version: int | str | None = None,  # Deprecated
-            cert_file: str | None = None,
-            key_file: str | None = None,
-            key_password: str | None = None,
-        ) -> None:
-            ...
diff --git a/lib/urllib3/_collections.py b/lib/urllib3/_collections.py
index 7f9dca7f..da9857e9 100644
--- a/lib/urllib3/_collections.py
+++ b/lib/urllib3/_collections.py
@@ -1,66 +1,34 @@
-from __future__ import annotations
+from __future__ import absolute_import
+
+try:
+    from collections.abc import Mapping, MutableMapping
+except ImportError:
+    from collections import Mapping, MutableMapping
+try:
+    from threading import RLock
+except ImportError:  # Platform-specific: No threads available
+
+    class RLock:
+        def __enter__(self):
+            pass
+
+        def __exit__(self, exc_type, exc_value, traceback):
+            pass
+
 
-import typing
 from collections import OrderedDict
-from enum import Enum, auto
-from threading import RLock
-
-if typing.TYPE_CHECKING:
-    # We can only import Protocol if TYPE_CHECKING because it's a development
-    # dependency, and is not available at runtime.
-    from typing_extensions import Protocol
-
-    class HasGettableStringKeys(Protocol):
-        def keys(self) -> typing.Iterator[str]:
-            ...
-
-        def __getitem__(self, key: str) -> str:
-            ...
 
+from .exceptions import InvalidHeader
+from .packages import six
+from .packages.six import iterkeys, itervalues
 
 __all__ = ["RecentlyUsedContainer", "HTTPHeaderDict"]
 
 
-# Key type
-_KT = typing.TypeVar("_KT")
-# Value type
-_VT = typing.TypeVar("_VT")
-# Default type
-_DT = typing.TypeVar("_DT")
-
-ValidHTTPHeaderSource = typing.Union[
-    "HTTPHeaderDict",
-    typing.Mapping[str, str],
-    typing.Iterable[typing.Tuple[str, str]],
-    "HasGettableStringKeys",
-]
+_Null = object()
 
 
-class _Sentinel(Enum):
-    not_passed = auto()
-
-
-def ensure_can_construct_http_header_dict(
-    potential: object,
-) -> ValidHTTPHeaderSource | None:
-    if isinstance(potential, HTTPHeaderDict):
-        return potential
-    elif isinstance(potential, typing.Mapping):
-        # Full runtime checking of the contents of a Mapping is expensive, so for the
-        # purposes of typechecking, we assume that any Mapping is the right shape.
-        return typing.cast(typing.Mapping[str, str], potential)
-    elif isinstance(potential, typing.Iterable):
-        # Similarly to Mapping, full runtime checking of the contents of an Iterable is
-        # expensive, so for the purposes of typechecking, we assume that any Iterable
-        # is the right shape.
-        return typing.cast(typing.Iterable[typing.Tuple[str, str]], potential)
-    elif hasattr(potential, "keys") and hasattr(potential, "__getitem__"):
-        return typing.cast("HasGettableStringKeys", potential)
-    else:
-        return None
-
-
-class RecentlyUsedContainer(typing.Generic[_KT, _VT], typing.MutableMapping[_KT, _VT]):
+class RecentlyUsedContainer(MutableMapping):
     """
     Provides a thread-safe dict-like container which maintains up to
     ``maxsize`` keys while throwing away the least-recently-used keys beyond
@@ -74,134 +42,69 @@ class RecentlyUsedContainer(typing.Generic[_KT, _VT], typing.MutableMapping[_KT,
         ``dispose_func(value)`` is called.  Callback which will get called
     """
 
-    _container: typing.OrderedDict[_KT, _VT]
-    _maxsize: int
-    dispose_func: typing.Callable[[_VT], None] | None
-    lock: RLock
+    ContainerCls = OrderedDict
 
-    def __init__(
-        self,
-        maxsize: int = 10,
-        dispose_func: typing.Callable[[_VT], None] | None = None,
-    ) -> None:
-        super().__init__()
+    def __init__(self, maxsize=10, dispose_func=None):
         self._maxsize = maxsize
         self.dispose_func = dispose_func
-        self._container = OrderedDict()
+
+        self._container = self.ContainerCls()
         self.lock = RLock()
 
-    def __getitem__(self, key: _KT) -> _VT:
+    def __getitem__(self, key):
         # Re-insert the item, moving it to the end of the eviction line.
         with self.lock:
             item = self._container.pop(key)
             self._container[key] = item
             return item
 
-    def __setitem__(self, key: _KT, value: _VT) -> None:
-        evicted_item = None
+    def __setitem__(self, key, value):
+        evicted_value = _Null
         with self.lock:
             # Possibly evict the existing value of 'key'
-            try:
-                # If the key exists, we'll overwrite it, which won't change the
-                # size of the pool. Because accessing a key should move it to
-                # the end of the eviction line, we pop it out first.
-                evicted_item = key, self._container.pop(key)
-                self._container[key] = value
-            except KeyError:
-                # When the key does not exist, we insert the value first so that
-                # evicting works in all cases, including when self._maxsize is 0
-                self._container[key] = value
-                if len(self._container) > self._maxsize:
-                    # If we didn't evict an existing value, and we've hit our maximum
-                    # size, then we have to evict the least recently used item from
-                    # the beginning of the container.
-                    evicted_item = self._container.popitem(last=False)
+            evicted_value = self._container.get(key, _Null)
+            self._container[key] = value
 
-        # After releasing the lock on the pool, dispose of any evicted value.
-        if evicted_item is not None and self.dispose_func:
-            _, evicted_value = evicted_item
+            # If we didn't evict an existing value, we might have to evict the
+            # least recently used item from the beginning of the container.
+            if len(self._container) > self._maxsize:
+                _key, evicted_value = self._container.popitem(last=False)
+
+        if self.dispose_func and evicted_value is not _Null:
             self.dispose_func(evicted_value)
 
-    def __delitem__(self, key: _KT) -> None:
+    def __delitem__(self, key):
         with self.lock:
             value = self._container.pop(key)
 
         if self.dispose_func:
             self.dispose_func(value)
 
-    def __len__(self) -> int:
+    def __len__(self):
         with self.lock:
             return len(self._container)
 
-    def __iter__(self) -> typing.NoReturn:
+    def __iter__(self):
         raise NotImplementedError(
             "Iteration over this class is unlikely to be threadsafe."
         )
 
-    def clear(self) -> None:
+    def clear(self):
         with self.lock:
             # Copy pointers to all values, then wipe the mapping
-            values = list(self._container.values())
+            values = list(itervalues(self._container))
             self._container.clear()
 
         if self.dispose_func:
             for value in values:
                 self.dispose_func(value)
 
-    def keys(self) -> set[_KT]:  # type: ignore[override]
+    def keys(self):
         with self.lock:
-            return set(self._container.keys())
+            return list(iterkeys(self._container))
 
 
-class HTTPHeaderDictItemView(typing.Set[typing.Tuple[str, str]]):
-    """
-    HTTPHeaderDict is unusual for a Mapping[str, str] in that it has two modes of
-    address.
-
-    If we directly try to get an item with a particular name, we will get a string
-    back that is the concatenated version of all the values:
-
-    >>> d['X-Header-Name']
-    'Value1, Value2, Value3'
-
-    However, if we iterate over an HTTPHeaderDict's items, we will optionally combine
-    these values based on whether combine=True was called when building up the dictionary
-
-    >>> d = HTTPHeaderDict({"A": "1", "B": "foo"})
-    >>> d.add("A", "2", combine=True)
-    >>> d.add("B", "bar")
-    >>> list(d.items())
-    [
-        ('A', '1, 2'),
-        ('B', 'foo'),
-        ('B', 'bar'),
-    ]
-
-    This class conforms to the interface required by the MutableMapping ABC while
-    also giving us the nonstandard iteration behavior we want; items with duplicate
-    keys, ordered by time of first insertion.
-    """
-
-    _headers: HTTPHeaderDict
-
-    def __init__(self, headers: HTTPHeaderDict) -> None:
-        self._headers = headers
-
-    def __len__(self) -> int:
-        return len(list(self._headers.iteritems()))
-
-    def __iter__(self) -> typing.Iterator[tuple[str, str]]:
-        return self._headers.iteritems()
-
-    def __contains__(self, item: object) -> bool:
-        if isinstance(item, tuple) and len(item) == 2:
-            passed_key, passed_val = item
-            if isinstance(passed_key, str) and isinstance(passed_val, str):
-                return self._headers._has_value_for_header(passed_key, passed_val)
-        return False
-
-
-class HTTPHeaderDict(typing.MutableMapping[str, str]):
+class HTTPHeaderDict(MutableMapping):
     """
     :param headers:
         An iterable of field-value pairs. Must not contain multiple field names
@@ -235,11 +138,9 @@ class HTTPHeaderDict(typing.MutableMapping[str, str]):
     '7'
     """
 
-    _container: typing.MutableMapping[str, list[str]]
-
-    def __init__(self, headers: ValidHTTPHeaderSource | None = None, **kwargs: str):
-        super().__init__()
-        self._container = {}  # 'dict' is insert-ordered in Python 3.7+
+    def __init__(self, headers=None, **kwargs):
+        super(HTTPHeaderDict, self).__init__()
+        self._container = OrderedDict()
         if headers is not None:
             if isinstance(headers, HTTPHeaderDict):
                 self._copy_from(headers)
@@ -248,147 +149,123 @@ class HTTPHeaderDict(typing.MutableMapping[str, str]):
         if kwargs:
             self.extend(kwargs)
 
-    def __setitem__(self, key: str, val: str) -> None:
-        # avoid a bytes/str comparison by decoding before httplib
-        if isinstance(key, bytes):
-            key = key.decode("latin-1")
+    def __setitem__(self, key, val):
         self._container[key.lower()] = [key, val]
+        return self._container[key.lower()]
 
-    def __getitem__(self, key: str) -> str:
+    def __getitem__(self, key):
         val = self._container[key.lower()]
         return ", ".join(val[1:])
 
-    def __delitem__(self, key: str) -> None:
+    def __delitem__(self, key):
         del self._container[key.lower()]
 
-    def __contains__(self, key: object) -> bool:
-        if isinstance(key, str):
-            return key.lower() in self._container
-        return False
+    def __contains__(self, key):
+        return key.lower() in self._container
 
-    def setdefault(self, key: str, default: str = "") -> str:
-        return super().setdefault(key, default)
-
-    def __eq__(self, other: object) -> bool:
-        maybe_constructable = ensure_can_construct_http_header_dict(other)
-        if maybe_constructable is None:
+    def __eq__(self, other):
+        if not isinstance(other, Mapping) and not hasattr(other, "keys"):
             return False
-        else:
-            other_as_http_header_dict = type(self)(maybe_constructable)
+        if not isinstance(other, type(self)):
+            other = type(self)(other)
+        return dict((k.lower(), v) for k, v in self.itermerged()) == dict(
+            (k.lower(), v) for k, v in other.itermerged()
+        )
 
-        return {k.lower(): v for k, v in self.itermerged()} == {
-            k.lower(): v for k, v in other_as_http_header_dict.itermerged()
-        }
-
-    def __ne__(self, other: object) -> bool:
+    def __ne__(self, other):
         return not self.__eq__(other)
 
-    def __len__(self) -> int:
+    if six.PY2:  # Python 2
+        iterkeys = MutableMapping.iterkeys
+        itervalues = MutableMapping.itervalues
+
+    __marker = object()
+
+    def __len__(self):
         return len(self._container)
 
-    def __iter__(self) -> typing.Iterator[str]:
+    def __iter__(self):
         # Only provide the originally cased names
         for vals in self._container.values():
             yield vals[0]
 
-    def discard(self, key: str) -> None:
+    def pop(self, key, default=__marker):
+        """D.pop(k[,d]) -> v, remove specified key and return the corresponding value.
+        If key is not found, d is returned if given, otherwise KeyError is raised.
+        """
+        # Using the MutableMapping function directly fails due to the private marker.
+        # Using ordinary dict.pop would expose the internal structures.
+        # So let's reinvent the wheel.
+        try:
+            value = self[key]
+        except KeyError:
+            if default is self.__marker:
+                raise
+            return default
+        else:
+            del self[key]
+            return value
+
+    def discard(self, key):
         try:
             del self[key]
         except KeyError:
             pass
 
-    def add(self, key: str, val: str, *, combine: bool = False) -> None:
+    def add(self, key, val):
         """Adds a (name, value) pair, doesn't overwrite the value if it already
         exists.
 
-        If this is called with combine=True, instead of adding a new header value
-        as a distinct item during iteration, this will instead append the value to
-        any existing header value with a comma. If no existing header value exists
-        for the key, then the value will simply be added, ignoring the combine parameter.
-
         >>> headers = HTTPHeaderDict(foo='bar')
         >>> headers.add('Foo', 'baz')
         >>> headers['foo']
         'bar, baz'
-        >>> list(headers.items())
-        [('foo', 'bar'), ('foo', 'baz')]
-        >>> headers.add('foo', 'quz', combine=True)
-        >>> list(headers.items())
-        [('foo', 'bar, baz, quz')]
         """
-        # avoid a bytes/str comparison by decoding before httplib
-        if isinstance(key, bytes):
-            key = key.decode("latin-1")
         key_lower = key.lower()
         new_vals = [key, val]
         # Keep the common case aka no item present as fast as possible
         vals = self._container.setdefault(key_lower, new_vals)
         if new_vals is not vals:
-            # if there are values here, then there is at least the initial
-            # key/value pair
-            assert len(vals) >= 2
-            if combine:
-                vals[-1] = vals[-1] + ", " + val
-            else:
-                vals.append(val)
+            vals.append(val)
 
-    def extend(self, *args: ValidHTTPHeaderSource, **kwargs: str) -> None:
+    def extend(self, *args, **kwargs):
         """Generic import function for any type of header-like object.
         Adapted version of MutableMapping.update in order to insert items
         with self.add instead of self.__setitem__
         """
         if len(args) > 1:
             raise TypeError(
-                f"extend() takes at most 1 positional arguments ({len(args)} given)"
+                "extend() takes at most 1 positional "
+                "arguments ({0} given)".format(len(args))
             )
         other = args[0] if len(args) >= 1 else ()
 
         if isinstance(other, HTTPHeaderDict):
             for key, val in other.iteritems():
                 self.add(key, val)
-        elif isinstance(other, typing.Mapping):
-            for key, val in other.items():
-                self.add(key, val)
-        elif isinstance(other, typing.Iterable):
-            other = typing.cast(typing.Iterable[typing.Tuple[str, str]], other)
-            for key, value in other:
-                self.add(key, value)
-        elif hasattr(other, "keys") and hasattr(other, "__getitem__"):
-            # THIS IS NOT A TYPESAFE BRANCH
-            # In this branch, the object has a `keys` attr but is not a Mapping or any of
-            # the other types indicated in the method signature. We do some stuff with
-            # it as though it partially implements the Mapping interface, but we're not
-            # doing that stuff safely AT ALL.
+        elif isinstance(other, Mapping):
+            for key in other:
+                self.add(key, other[key])
+        elif hasattr(other, "keys"):
             for key in other.keys():
                 self.add(key, other[key])
+        else:
+            for key, value in other:
+                self.add(key, value)
 
         for key, value in kwargs.items():
             self.add(key, value)
 
-    @typing.overload
-    def getlist(self, key: str) -> list[str]:
-        ...
-
-    @typing.overload
-    def getlist(self, key: str, default: _DT) -> list[str] | _DT:
-        ...
-
-    def getlist(
-        self, key: str, default: _Sentinel | _DT = _Sentinel.not_passed
-    ) -> list[str] | _DT:
+    def getlist(self, key, default=__marker):
         """Returns a list of all the values for the named field. Returns an
         empty list if the key doesn't exist."""
         try:
             vals = self._container[key.lower()]
         except KeyError:
-            if default is _Sentinel.not_passed:
-                # _DT is unbound; empty list is instance of List[str]
+            if default is self.__marker:
                 return []
-            # _DT is bound; default is instance of _DT
             return default
         else:
-            # _DT may or may not be bound; vals[1:] is instance of List[str], which
-            # meets our external interface requirement of `Union[List[str], _DT]`.
             return vals[1:]
 
     # Backwards compatibility for httplib
@@ -399,65 +276,62 @@ class HTTPHeaderDict(typing.MutableMapping[str, str]):
     # Backwards compatibility for http.cookiejar
     get_all = getlist
 
-    def __repr__(self) -> str:
-        return f"{type(self).__name__}({dict(self.itermerged())})"
+    def __repr__(self):
+        return "%s(%s)" % (type(self).__name__, dict(self.itermerged()))
 
-    def _copy_from(self, other: HTTPHeaderDict) -> None:
+    def _copy_from(self, other):
         for key in other:
             val = other.getlist(key)
-            self._container[key.lower()] = [key, *val]
+            if isinstance(val, list):
+                # Don't need to convert tuples
+                val = list(val)
+            self._container[key.lower()] = [key] + val
 
-    def copy(self) -> HTTPHeaderDict:
+    def copy(self):
         clone = type(self)()
         clone._copy_from(self)
         return clone
 
-    def iteritems(self) -> typing.Iterator[tuple[str, str]]:
+    def iteritems(self):
         """Iterate over all header lines, including duplicate ones."""
         for key in self:
             vals = self._container[key.lower()]
             for val in vals[1:]:
                 yield vals[0], val
 
-    def itermerged(self) -> typing.Iterator[tuple[str, str]]:
+    def itermerged(self):
         """Iterate over all headers, merging duplicate ones together."""
         for key in self:
             val = self._container[key.lower()]
             yield val[0], ", ".join(val[1:])
 
-    def items(self) -> HTTPHeaderDictItemView:  # type: ignore[override]
-        return HTTPHeaderDictItemView(self)
+    def items(self):
+        return list(self.iteritems())
 
-    def _has_value_for_header(self, header_name: str, potential_value: str) -> bool:
-        if header_name in self:
-            return potential_value in self._container[header_name.lower()][1:]
-        return False
+    @classmethod
+    def from_httplib(cls, message):  # Python 2
+        """Read headers from a Python 2 httplib message object."""
+        # python2.7 does not expose a proper API for exporting multiheaders
+        # efficiently. This function re-reads raw lines from the message
+        # object and extracts the multiheaders properly.
+        obs_fold_continued_leaders = (" ", "\t")
+        headers = []
 
-    def __ior__(self, other: object) -> HTTPHeaderDict:
-        # Supports extending a header dict in-place using operator |=
-        # combining items with add instead of __setitem__
-        maybe_constructable = ensure_can_construct_http_header_dict(other)
-        if maybe_constructable is None:
-            return NotImplemented
-        self.extend(maybe_constructable)
-        return self
+        for line in message.headers:
+            if line.startswith(obs_fold_continued_leaders):
+                if not headers:
+                    # We received a header line that starts with OWS as described
+                    # in RFC-7230 S3.2.4. This indicates a multiline header, but
+                    # there exists no previous header to which we can attach it.
+                    raise InvalidHeader(
+                        "Header continuation with no previous header: %s" % line
+                    )
+                else:
+                    key, value = headers[-1]
+                    headers[-1] = (key, value + " " + line.strip())
+                    continue
 
-    def __or__(self, other: object) -> HTTPHeaderDict:
-        # Supports merging header dicts using operator |
-        # combining items with add instead of __setitem__
-        maybe_constructable = ensure_can_construct_http_header_dict(other)
-        if maybe_constructable is None:
-            return NotImplemented
-        result = self.copy()
-        result.extend(maybe_constructable)
-        return result
+            key, value = line.split(":", 1)
+            headers.append((key, value.strip()))
 
-    def __ror__(self, other: object) -> HTTPHeaderDict:
-        # Supports merging header dicts using operator | when other is on left side
-        # combining items with add instead of __setitem__
-        maybe_constructable = ensure_can_construct_http_header_dict(other)
-        if maybe_constructable is None:
-            return NotImplemented
-        result = type(self)(maybe_constructable)
-        result.extend(self)
-        return result
+        return cls(headers)
diff --git a/lib/urllib3/_version.py b/lib/urllib3/_version.py
index 782af433..d69ca314 100644
--- a/lib/urllib3/_version.py
+++ b/lib/urllib3/_version.py
@@ -1,4 +1,2 @@
 # This file is protected via CODEOWNERS
-from __future__ import annotations
-
-__version__ = "2.0.4"
+__version__ = "1.26.16"
diff --git a/lib/urllib3/connection.py b/lib/urllib3/connection.py
index 10109fa9..54b96b19 100644
--- a/lib/urllib3/connection.py
+++ b/lib/urllib3/connection.py
@@ -1,58 +1,59 @@
-from __future__ import annotations
+from __future__ import absolute_import
 
 import datetime
 import logging
 import os
 import re
 import socket
-import sys
-import typing
 import warnings
-from http.client import HTTPConnection as _HTTPConnection
-from http.client import HTTPException as HTTPException  # noqa: F401
-from http.client import ResponseNotReady
+from socket import error as SocketError
 from socket import timeout as SocketTimeout
 
-if typing.TYPE_CHECKING:
-    from typing_extensions import Literal
-
-    from .response import HTTPResponse
-    from .util.ssl_ import _TYPE_PEER_CERT_RET_DICT
-    from .util.ssltransport import SSLTransport
-
-from ._collections import HTTPHeaderDict
-from .util.response import assert_header_parsing
-from .util.timeout import _DEFAULT_TIMEOUT, _TYPE_TIMEOUT, Timeout
-from .util.util import to_str
-from .util.wait import wait_for_read
+from .packages import six
+from .packages.six.moves.http_client import HTTPConnection as _HTTPConnection
+from .packages.six.moves.http_client import HTTPException  # noqa: F401
+from .util.proxy import create_proxy_ssl_context
 
 try:  # Compiled with SSL?
     import ssl
 
     BaseSSLError = ssl.SSLError
-except (ImportError, AttributeError):
-    ssl = None  # type: ignore[assignment]
+except (ImportError, AttributeError):  # Platform-specific: No SSL.
+    ssl = None
 
-    class BaseSSLError(BaseException):  # type: ignore[no-redef]
+    class BaseSSLError(BaseException):
         pass
 
 
-from ._base_connection import _TYPE_BODY
-from ._base_connection import ProxyConfig as ProxyConfig
-from ._base_connection import _ResponseOptions as _ResponseOptions
+try:
+    # Python 3: not a no-op, we're adding this to the namespace so it can be imported.
+    ConnectionError = ConnectionError
+except NameError:
+    # Python 2
+    class ConnectionError(Exception):
+        pass
+
+
+try:  # Python 3:
+    # Not a no-op, we're adding this to the namespace so it can be imported.
+    BrokenPipeError = BrokenPipeError
+except NameError:  # Python 2:
+
+    class BrokenPipeError(Exception):
+        pass
+
+
+from ._collections import HTTPHeaderDict  # noqa (historical, removed in v2)
 from ._version import __version__
 from .exceptions import (
     ConnectTimeoutError,
-    HeaderParsingError,
-    NameResolutionError,
     NewConnectionError,
-    ProxyError,
+    SubjectAltNameWarning,
     SystemTimeWarning,
 )
-from .util import SKIP_HEADER, SKIPPABLE_HEADERS, connection, ssl_
-from .util.request import body_to_chunks
-from .util.ssl_ import assert_fingerprint as _assert_fingerprint
+from .util import SKIP_HEADER, SKIPPABLE_HEADERS, connection
 from .util.ssl_ import (
+    assert_fingerprint,
     create_urllib3_context,
     is_ipaddress,
     resolve_cert_reqs,
@@ -60,12 +61,6 @@ from .util.ssl_ import (
     ssl_wrap_socket,
 )
 from .util.ssl_match_hostname import CertificateError, match_hostname
-from .util.url import Url
-
-# Not a no-op, we're adding this to the namespace so it can be imported.
-ConnectionError = ConnectionError
-BrokenPipeError = BrokenPipeError
-
 
 log = logging.getLogger(__name__)
 
@@ -77,10 +72,8 @@ RECENT_DATE = datetime.date(2022, 1, 1)
 
 _CONTAINS_CONTROL_CHAR_RE = re.compile(r"[^-!#$%&'*+.^_`|~0-9a-zA-Z]")
 
-_HAS_SYS_AUDIT = hasattr(sys, "audit")
 
-
-class HTTPConnection(_HTTPConnection):
+class HTTPConnection(_HTTPConnection, object):
     """
     Based on :class:`http.client.HTTPConnection` but provides an extra constructor
     backwards-compatibility layer between older and newer Pythons.
@@ -88,6 +81,7 @@ class HTTPConnection(_HTTPConnection):
     Additional keyword parameters are used to configure attributes of the connection.
     Accepted parameters include:
 
+    - ``strict``: See the documentation on :class:`urllib3.connectionpool.HTTPConnectionPool`
     - ``source_address``: Set the source address for the current connection.
     - ``socket_options``: Set specific options on the underlying socket. If not specified, then
       defaults are loaded from ``HTTPConnection.default_socket_options`` which includes disabling
@@ -105,68 +99,38 @@ class HTTPConnection(_HTTPConnection):
       Or you may want to disable the defaults by passing an empty list (e.g., ``[]``).
     """
 
-    default_port: typing.ClassVar[int] = port_by_scheme["http"]  # type: ignore[misc]
+    default_port = port_by_scheme["http"]
 
     #: Disable Nagle's algorithm by default.
     #: ``[(socket.IPPROTO_TCP, socket.TCP_NODELAY, 1)]``
-    default_socket_options: typing.ClassVar[connection._TYPE_SOCKET_OPTIONS] = [
-        (socket.IPPROTO_TCP, socket.TCP_NODELAY, 1)
-    ]
+    default_socket_options = [(socket.IPPROTO_TCP, socket.TCP_NODELAY, 1)]
 
     #: Whether this connection verifies the host's certificate.
-    is_verified: bool = False
+    is_verified = False
 
-    #: Whether this proxy connection verified the proxy host's certificate.
-    # If no proxy is currently connected to the value will be ``None``.
-    proxy_is_verified: bool | None = None
+    #: Whether this proxy connection (if used) verifies the proxy host's
+    #: certificate.
+    proxy_is_verified = None
 
-    blocksize: int
-    source_address: tuple[str, int] | None
-    socket_options: connection._TYPE_SOCKET_OPTIONS | None
+    def __init__(self, *args, **kw):
+        if not six.PY2:
+            kw.pop("strict", None)
 
-    _has_connected_to_proxy: bool
-    _response_options: _ResponseOptions | None
-    _tunnel_host: str | None
-    _tunnel_port: int | None
-    _tunnel_scheme: str | None
+        # Pre-set source_address.
+        self.source_address = kw.get("source_address")
 
-    def __init__(
-        self,
-        host: str,
-        port: int | None = None,
-        *,
-        timeout: _TYPE_TIMEOUT = _DEFAULT_TIMEOUT,
-        source_address: tuple[str, int] | None = None,
-        blocksize: int = 8192,
-        socket_options: None
-        | (connection._TYPE_SOCKET_OPTIONS) = default_socket_options,
-        proxy: Url | None = None,
-        proxy_config: ProxyConfig | None = None,
-    ) -> None:
-        super().__init__(
-            host=host,
-            port=port,
-            timeout=Timeout.resolve_default_timeout(timeout),
-            source_address=source_address,
-            blocksize=blocksize,
-        )
-        self.socket_options = socket_options
-        self.proxy = proxy
-        self.proxy_config = proxy_config
+        #: The socket options provided by the user. If no options are
+        #: provided, we use the default options.
+        self.socket_options = kw.pop("socket_options", self.default_socket_options)
 
-        self._has_connected_to_proxy = False
-        self._response_options = None
-        self._tunnel_host: str | None = None
-        self._tunnel_port: int | None = None
-        self._tunnel_scheme: str | None = None
+        # Proxy options provided by the user.
+        self.proxy = kw.pop("proxy", None)
+        self.proxy_config = kw.pop("proxy_config", None)
+
+        _HTTPConnection.__init__(self, *args, **kw)
 
-    # https://github.com/python/mypy/issues/4125
-    # Mypy treats this as LSP violation, which is considered a bug.
-    # If `host` is made a property it violates LSP, because a writeable attribute is overridden with a read-only one.
-    # However, there is also a `host` setter so LSP is not violated.
-    # Potentially, a `@host.deleter` might be needed depending on how this issue will be fixed.
     @property
-    def host(self) -> str:
+    def host(self):
         """
         Getter method to remove any trailing dots that indicate the hostname is an FQDN.
 
@@ -185,7 +149,7 @@ class HTTPConnection(_HTTPConnection):
         return self._dns_host.rstrip(".")
 
     @host.setter
-    def host(self, value: str) -> None:
+    def host(self, value):
         """
         Setter for the `host` property.
 
@@ -194,298 +158,129 @@ class HTTPConnection(_HTTPConnection):
         """
         self._dns_host = value
 
-    def _new_conn(self) -> socket.socket:
+    def _new_conn(self):
         """Establish a socket connection and set nodelay settings on it.
 
         :return: New socket connection.
         """
+        extra_kw = {}
+        if self.source_address:
+            extra_kw["source_address"] = self.source_address
+
+        if self.socket_options:
+            extra_kw["socket_options"] = self.socket_options
+
         try:
-            sock = connection.create_connection(
-                (self._dns_host, self.port),
-                self.timeout,
-                source_address=self.source_address,
-                socket_options=self.socket_options,
+            conn = connection.create_connection(
+                (self._dns_host, self.port), self.timeout, **extra_kw
             )
-        except socket.gaierror as e:
-            raise NameResolutionError(self.host, self, e) from e
-        except SocketTimeout as e:
+
+        except SocketTimeout:
             raise ConnectTimeoutError(
                 self,
-                f"Connection to {self.host} timed out. (connect timeout={self.timeout})",
-            ) from e
-
-        except OSError as e:
-            raise NewConnectionError(
-                self, f"Failed to establish a new connection: {e}"
-            ) from e
-
-        # Audit hooks are only available in Python 3.8+
-        if _HAS_SYS_AUDIT:
-            sys.audit("http.client.connect", self, self.host, self.port)
-
-        return sock
-
-    def set_tunnel(
-        self,
-        host: str,
-        port: int | None = None,
-        headers: typing.Mapping[str, str] | None = None,
-        scheme: str = "http",
-    ) -> None:
-        if scheme not in ("http", "https"):
-            raise ValueError(
-                f"Invalid proxy scheme for tunneling: {scheme!r}, must be either 'http' or 'https'"
+                "Connection to %s timed out. (connect timeout=%s)"
+                % (self.host, self.timeout),
             )
-        super().set_tunnel(host, port=port, headers=headers)
-        self._tunnel_scheme = scheme
 
-    def connect(self) -> None:
-        self.sock = self._new_conn()
-        if self._tunnel_host:
-            # If we're tunneling it means we're connected to our proxy.
-            self._has_connected_to_proxy = True
+        except SocketError as e:
+            raise NewConnectionError(
+                self, "Failed to establish a new connection: %s" % e
+            )
 
+        return conn
+
+    def _is_using_tunnel(self):
+        # Google App Engine's httplib does not define _tunnel_host
+        return getattr(self, "_tunnel_host", None)
+
+    def _prepare_conn(self, conn):
+        self.sock = conn
+        if self._is_using_tunnel():
             # TODO: Fix tunnel so it doesn't depend on self.sock state.
-            self._tunnel()  # type: ignore[attr-defined]
+            self._tunnel()
+            # Mark this connection as not reusable
+            self.auto_open = 0
 
-        # If there's a proxy to be connected to we are fully connected.
-        # This is set twice (once above and here) due to forwarding proxies
-        # not using tunnelling.
-        self._has_connected_to_proxy = bool(self.proxy)
+    def connect(self):
+        conn = self._new_conn()
+        self._prepare_conn(conn)
 
-    @property
-    def is_closed(self) -> bool:
-        return self.sock is None
-
-    @property
-    def is_connected(self) -> bool:
-        if self.sock is None:
-            return False
-        return not wait_for_read(self.sock, timeout=0.0)
-
-    @property
-    def has_connected_to_proxy(self) -> bool:
-        return self._has_connected_to_proxy
-
-    def close(self) -> None:
-        try:
-            super().close()
-        finally:
-            # Reset all stateful properties so connection
-            # can be re-used without leaking prior configs.
-            self.sock = None
-            self.is_verified = False
-            self.proxy_is_verified = None
-            self._has_connected_to_proxy = False
-            self._response_options = None
-            self._tunnel_host = None
-            self._tunnel_port = None
-            self._tunnel_scheme = None
-
-    def putrequest(
-        self,
-        method: str,
-        url: str,
-        skip_host: bool = False,
-        skip_accept_encoding: bool = False,
-    ) -> None:
-        """"""
+    def putrequest(self, method, url, *args, **kwargs):
+        """ """
         # Empty docstring because the indentation of CPython's implementation
         # is broken but we don't want this method in our documentation.
         match = _CONTAINS_CONTROL_CHAR_RE.search(method)
         if match:
             raise ValueError(
-                f"Method cannot contain non-token characters {method!r} (found at least {match.group()!r})"
+                "Method cannot contain non-token characters %r (found at least %r)"
+                % (method, match.group())
             )
 
-        return super().putrequest(
-            method, url, skip_host=skip_host, skip_accept_encoding=skip_accept_encoding
-        )
+        return _HTTPConnection.putrequest(self, method, url, *args, **kwargs)
 
-    def putheader(self, header: str, *values: str) -> None:
-        """"""
+    def putheader(self, header, *values):
+        """ """
         if not any(isinstance(v, str) and v == SKIP_HEADER for v in values):
-            super().putheader(header, *values)
-        elif to_str(header.lower()) not in SKIPPABLE_HEADERS:
-            skippable_headers = "', '".join(
-                [str.title(header) for header in sorted(SKIPPABLE_HEADERS)]
-            )
+            _HTTPConnection.putheader(self, header, *values)
+        elif six.ensure_str(header.lower()) not in SKIPPABLE_HEADERS:
             raise ValueError(
-                f"urllib3.util.SKIP_HEADER only supports '{skippable_headers}'"
+                "urllib3.util.SKIP_HEADER only supports '%s'"
+                % ("', '".join(map(str.title, sorted(SKIPPABLE_HEADERS))),)
             )
 
-    # `request` method's signature intentionally violates LSP.
-    # urllib3's API is different from `http.client.HTTPConnection` and the subclassing is only incidental.
-    def request(  # type: ignore[override]
-        self,
-        method: str,
-        url: str,
-        body: _TYPE_BODY | None = None,
-        headers: typing.Mapping[str, str] | None = None,
-        *,
-        chunked: bool = False,
-        preload_content: bool = True,
-        decode_content: bool = True,
-        enforce_content_length: bool = True,
-    ) -> None:
+    def request(self, method, url, body=None, headers=None):
         # Update the inner socket's timeout value to send the request.
         # This only triggers if the connection is re-used.
-        if self.sock is not None:
+        if getattr(self, "sock", None) is not None:
             self.sock.settimeout(self.timeout)
 
-        # Store these values to be fed into the HTTPResponse
-        # object later. TODO: Remove this in favor of a real
-        # HTTP lifecycle mechanism.
-
-        # We have to store these before we call .request()
-        # because sometimes we can still salvage a response
-        # off the wire even if we aren't able to completely
-        # send the request body.
-        self._response_options = _ResponseOptions(
-            request_method=method,
-            request_url=url,
-            preload_content=preload_content,
-            decode_content=decode_content,
-            enforce_content_length=enforce_content_length,
-        )
-
         if headers is None:
             headers = {}
-        header_keys = frozenset(to_str(k.lower()) for k in headers)
+        else:
+            # Avoid modifying the headers passed into .request()
+            headers = headers.copy()
+        if "user-agent" not in (six.ensure_str(k.lower()) for k in headers):
+            headers["User-Agent"] = _get_default_user_agent()
+        super(HTTPConnection, self).request(method, url, body=body, headers=headers)
+
+    def request_chunked(self, method, url, body=None, headers=None):
+        """
+        Alternative to the common request method, which sends the
+        body with chunked encoding and not as one block
+        """
+        headers = headers or {}
+        header_keys = set([six.ensure_str(k.lower()) for k in headers])
         skip_accept_encoding = "accept-encoding" in header_keys
         skip_host = "host" in header_keys
         self.putrequest(
             method, url, skip_accept_encoding=skip_accept_encoding, skip_host=skip_host
         )
-
-        # Transform the body into an iterable of sendall()-able chunks
-        # and detect if an explicit Content-Length is doable.
-        chunks_and_cl = body_to_chunks(body, method=method, blocksize=self.blocksize)
-        chunks = chunks_and_cl.chunks
-        content_length = chunks_and_cl.content_length
-
-        # When chunked is explicit set to 'True' we respect that.
-        if chunked:
-            if "transfer-encoding" not in header_keys:
-                self.putheader("Transfer-Encoding", "chunked")
-        else:
-            # Detect whether a framing mechanism is already in use. If so
-            # we respect that value, otherwise we pick chunked vs content-length
-            # depending on the type of 'body'.
-            if "content-length" in header_keys:
-                chunked = False
-            elif "transfer-encoding" in header_keys:
-                chunked = True
-
-            # Otherwise we go off the recommendation of 'body_to_chunks()'.
-            else:
-                chunked = False
-                if content_length is None:
-                    if chunks is not None:
-                        chunked = True
-                        self.putheader("Transfer-Encoding", "chunked")
-                else:
-                    self.putheader("Content-Length", str(content_length))
-
-        # Now that framing headers are out of the way we send all the other headers.
         if "user-agent" not in header_keys:
             self.putheader("User-Agent", _get_default_user_agent())
         for header, value in headers.items():
             self.putheader(header, value)
+        if "transfer-encoding" not in header_keys:
+            self.putheader("Transfer-Encoding", "chunked")
         self.endheaders()
 
-        # If we're given a body we start sending that in chunks.
-        if chunks is not None:
-            for chunk in chunks:
-                # Sending empty chunks isn't allowed for TE: chunked
-                # as it indicates the end of the body.
+        if body is not None:
+            stringish_types = six.string_types + (bytes,)
+            if isinstance(body, stringish_types):
+                body = (body,)
+            for chunk in body:
                 if not chunk:
                     continue
-                if isinstance(chunk, str):
-                    chunk = chunk.encode("utf-8")
-                if chunked:
-                    self.send(b"%x\r\n%b\r\n" % (len(chunk), chunk))
-                else:
-                    self.send(chunk)
+                if not isinstance(chunk, bytes):
+                    chunk = chunk.encode("utf8")
+                len_str = hex(len(chunk))[2:]
+                to_send = bytearray(len_str.encode())
+                to_send += b"\r\n"
+                to_send += chunk
+                to_send += b"\r\n"
+                self.send(to_send)
 
-        # Regardless of whether we have a body or not, if we're in
-        # chunked mode we want to send an explicit empty chunk.
-        if chunked:
-            self.send(b"0\r\n\r\n")
-
-    def request_chunked(
-        self,
-        method: str,
-        url: str,
-        body: _TYPE_BODY | None = None,
-        headers: typing.Mapping[str, str] | None = None,
-    ) -> None:
-        """
-        Alternative to the common request method, which sends the
-        body with chunked encoding and not as one block
-        """
-        warnings.warn(
-            "HTTPConnection.request_chunked() is deprecated and will be removed "
-            "in urllib3 v2.1.0. Instead use HTTPConnection.request(..., chunked=True).",
-            category=DeprecationWarning,
-            stacklevel=2,
-        )
-        self.request(method, url, body=body, headers=headers, chunked=True)
-
-    def getresponse(  # type: ignore[override]
-        self,
-    ) -> HTTPResponse:
-        """
-        Get the response from the server.
-
-        If the HTTPConnection is in the correct state, returns an instance of HTTPResponse or of whatever object is returned by the response_class variable.
-
-        If a request has not been sent or if a previous response has not be handled, ResponseNotReady is raised. If the HTTP response indicates that the connection should be closed, then it will be closed before the response is returned. When the connection is closed, the underlying socket is closed.
-        """
-        # Raise the same error as http.client.HTTPConnection
-        if self._response_options is None:
-            raise ResponseNotReady()
-
-        # Reset this attribute for being used again.
-        resp_options = self._response_options
-        self._response_options = None
-
-        # Since the connection's timeout value may have been updated
-        # we need to set the timeout on the socket.
-        self.sock.settimeout(self.timeout)
-
-        # This is needed here to avoid circular import errors
-        from .response import HTTPResponse
-
-        # Get the response from http.client.HTTPConnection
-        httplib_response = super().getresponse()
-
-        try:
-            assert_header_parsing(httplib_response.msg)
-        except (HeaderParsingError, TypeError) as hpe:
-            log.warning(
-                "Failed to parse headers (url=%s): %s",
-                _url_from_connection(self, resp_options.request_url),
-                hpe,
-                exc_info=True,
-            )
-
-        headers = HTTPHeaderDict(httplib_response.msg.items())
-
-        response = HTTPResponse(
-            body=httplib_response,
-            headers=headers,
-            status=httplib_response.status,
-            version=httplib_response.version,
-            reason=httplib_response.reason,
-            preload_content=resp_options.preload_content,
-            decode_content=resp_options.decode_content,
-            original_response=httplib_response,
-            enforce_content_length=resp_options.enforce_content_length,
-            request_method=resp_options.request_method,
-            request_url=resp_options.request_url,
-        )
-        return response
+        # After the if clause, to always have a closed body
+        self.send(b"0\r\n\r\n")
 
 
 class HTTPSConnection(HTTPConnection):
@@ -494,100 +289,57 @@ class HTTPSConnection(HTTPConnection):
     socket by means of :py:func:`urllib3.util.ssl_wrap_socket`.
     """
 
-    default_port = port_by_scheme["https"]  # type: ignore[misc]
+    default_port = port_by_scheme["https"]
 
-    cert_reqs: int | str | None = None
-    ca_certs: str | None = None
-    ca_cert_dir: str | None = None
-    ca_cert_data: None | str | bytes = None
-    ssl_version: int | str | None = None
-    ssl_minimum_version: int | None = None
-    ssl_maximum_version: int | None = None
-    assert_fingerprint: str | None = None
+    cert_reqs = None
+    ca_certs = None
+    ca_cert_dir = None
+    ca_cert_data = None
+    ssl_version = None
+    assert_fingerprint = None
+    tls_in_tls_required = False
 
     def __init__(
         self,
-        host: str,
-        port: int | None = None,
-        *,
-        timeout: _TYPE_TIMEOUT = _DEFAULT_TIMEOUT,
-        source_address: tuple[str, int] | None = None,
-        blocksize: int = 8192,
-        socket_options: None
-        | (connection._TYPE_SOCKET_OPTIONS) = HTTPConnection.default_socket_options,
-        proxy: Url | None = None,
-        proxy_config: ProxyConfig | None = None,
-        cert_reqs: int | str | None = None,
-        assert_hostname: None | str | Literal[False] = None,
-        assert_fingerprint: str | None = None,
-        server_hostname: str | None = None,
-        ssl_context: ssl.SSLContext | None = None,
-        ca_certs: str | None = None,
-        ca_cert_dir: str | None = None,
-        ca_cert_data: None | str | bytes = None,
-        ssl_minimum_version: int | None = None,
-        ssl_maximum_version: int | None = None,
-        ssl_version: int | str | None = None,  # Deprecated
-        cert_file: str | None = None,
-        key_file: str | None = None,
-        key_password: str | None = None,
-    ) -> None:
-        super().__init__(
-            host,
-            port=port,
-            timeout=timeout,
-            source_address=source_address,
-            blocksize=blocksize,
-            socket_options=socket_options,
-            proxy=proxy,
-            proxy_config=proxy_config,
-        )
+        host,
+        port=None,
+        key_file=None,
+        cert_file=None,
+        key_password=None,
+        strict=None,
+        timeout=socket._GLOBAL_DEFAULT_TIMEOUT,
+        ssl_context=None,
+        server_hostname=None,
+        **kw
+    ):
+
+        HTTPConnection.__init__(self, host, port, strict=strict, timeout=timeout, **kw)
 
         self.key_file = key_file
         self.cert_file = cert_file
         self.key_password = key_password
         self.ssl_context = ssl_context
         self.server_hostname = server_hostname
-        self.assert_hostname = assert_hostname
-        self.assert_fingerprint = assert_fingerprint
-        self.ssl_version = ssl_version
-        self.ssl_minimum_version = ssl_minimum_version
-        self.ssl_maximum_version = ssl_maximum_version
-        self.ca_certs = ca_certs and os.path.expanduser(ca_certs)
-        self.ca_cert_dir = ca_cert_dir and os.path.expanduser(ca_cert_dir)
-        self.ca_cert_data = ca_cert_data
 
-        # cert_reqs depends on ssl_context so calculate last.
-        if cert_reqs is None:
-            if self.ssl_context is not None:
-                cert_reqs = self.ssl_context.verify_mode
-            else:
-                cert_reqs = resolve_cert_reqs(None)
-        self.cert_reqs = cert_reqs
+        # Required property for Google AppEngine 1.9.0 which otherwise causes
+        # HTTPS requests to go out as HTTP. (See Issue #356)
+        self._protocol = "https"
 
     def set_cert(
         self,
-        key_file: str | None = None,
-        cert_file: str | None = None,
-        cert_reqs: int | str | None = None,
-        key_password: str | None = None,
-        ca_certs: str | None = None,
-        assert_hostname: None | str | Literal[False] = None,
-        assert_fingerprint: str | None = None,
-        ca_cert_dir: str | None = None,
-        ca_cert_data: None | str | bytes = None,
-    ) -> None:
+        key_file=None,
+        cert_file=None,
+        cert_reqs=None,
+        key_password=None,
+        ca_certs=None,
+        assert_hostname=None,
+        assert_fingerprint=None,
+        ca_cert_dir=None,
+        ca_cert_data=None,
+    ):
         """
         This method should only be called once, before the connection is used.
         """
-        warnings.warn(
-            "HTTPSConnection.set_cert() is deprecated and will be removed "
-            "in urllib3 v2.1.0. Instead provide the parameters to the "
-            "HTTPSConnection constructor.",
-            category=DeprecationWarning,
-            stacklevel=2,
-        )
-
         # If cert_reqs is not provided we'll assume CERT_REQUIRED unless we also
         # have an SSLContext object in which case we'll use its verify_mode.
         if cert_reqs is None:
@@ -606,26 +358,27 @@ class HTTPSConnection(HTTPConnection):
         self.ca_cert_dir = ca_cert_dir and os.path.expanduser(ca_cert_dir)
         self.ca_cert_data = ca_cert_data
 
-    def connect(self) -> None:
-        sock: socket.socket | ssl.SSLSocket
-        self.sock = sock = self._new_conn()
-        server_hostname: str = self.host
+    def connect(self):
+        # Add certificate verification
+        self.sock = conn = self._new_conn()
+        hostname = self.host
         tls_in_tls = False
 
-        # Do we need to establish a tunnel?
-        if self._tunnel_host is not None:
-            # We're tunneling to an HTTPS origin so need to do TLS-in-TLS.
-            if self._tunnel_scheme == "https":
-                self.sock = sock = self._connect_tls_proxy(self.host, sock)
+        if self._is_using_tunnel():
+            if self.tls_in_tls_required:
+                self.sock = conn = self._connect_tls_proxy(hostname, conn)
                 tls_in_tls = True
 
-            # If we're tunneling it means we're connected to our proxy.
-            self._has_connected_to_proxy = True
+            # Calls self._set_hostport(), so self.host is
+            # self._tunnel_host below.
+            self._tunnel()
+            # Mark this connection as not reusable
+            self.auto_open = 0
 
-            self._tunnel()  # type: ignore[attr-defined]
             # Override the host with the one we're requesting data from.
-            server_hostname = self._tunnel_host
+            hostname = self._tunnel_host
 
+        server_hostname = hostname
         if self.server_hostname is not None:
             server_hostname = self.server_hostname
 
@@ -633,218 +386,163 @@ class HTTPSConnection(HTTPConnection):
         if is_time_off:
             warnings.warn(
                 (
-                    f"System time is way off (before {RECENT_DATE}). This will probably "
+                    "System time is way off (before {0}). This will probably "
                     "lead to SSL verification errors"
-                ),
+                ).format(RECENT_DATE),
                 SystemTimeWarning,
             )
 
-        sock_and_verified = _ssl_wrap_socket_and_match_hostname(
-            sock=sock,
-            cert_reqs=self.cert_reqs,
-            ssl_version=self.ssl_version,
-            ssl_minimum_version=self.ssl_minimum_version,
-            ssl_maximum_version=self.ssl_maximum_version,
+        # Wrap socket using verification with the root certs in
+        # trusted_root_certs
+        default_ssl_context = False
+        if self.ssl_context is None:
+            default_ssl_context = True
+            self.ssl_context = create_urllib3_context(
+                ssl_version=resolve_ssl_version(self.ssl_version),
+                cert_reqs=resolve_cert_reqs(self.cert_reqs),
+            )
+
+        context = self.ssl_context
+        context.verify_mode = resolve_cert_reqs(self.cert_reqs)
+
+        # Try to load OS default certs if none are given.
+        # Works well on Windows (requires Python3.4+)
+        if (
+            not self.ca_certs
+            and not self.ca_cert_dir
+            and not self.ca_cert_data
+            and default_ssl_context
+            and hasattr(context, "load_default_certs")
+        ):
+            context.load_default_certs()
+
+        self.sock = ssl_wrap_socket(
+            sock=conn,
+            keyfile=self.key_file,
+            certfile=self.cert_file,
+            key_password=self.key_password,
             ca_certs=self.ca_certs,
             ca_cert_dir=self.ca_cert_dir,
             ca_cert_data=self.ca_cert_data,
-            cert_file=self.cert_file,
-            key_file=self.key_file,
-            key_password=self.key_password,
             server_hostname=server_hostname,
-            ssl_context=self.ssl_context,
+            ssl_context=context,
             tls_in_tls=tls_in_tls,
-            assert_hostname=self.assert_hostname,
-            assert_fingerprint=self.assert_fingerprint,
         )
-        self.sock = sock_and_verified.socket
-        self.is_verified = sock_and_verified.is_verified
 
-        # If there's a proxy to be connected to we are fully connected.
-        # This is set twice (once above and here) due to forwarding proxies
-        # not using tunnelling.
-        self._has_connected_to_proxy = bool(self.proxy)
+        # If we're using all defaults and the connection
+        # is TLSv1 or TLSv1.1 we throw a DeprecationWarning
+        # for the host.
+        if (
+            default_ssl_context
+            and self.ssl_version is None
+            and hasattr(self.sock, "version")
+            and self.sock.version() in {"TLSv1", "TLSv1.1"}
+        ):
+            warnings.warn(
+                "Negotiating TLSv1/TLSv1.1 by default is deprecated "
+                "and will be disabled in urllib3 v2.0.0. Connecting to "
+                "'%s' with '%s' can be enabled by explicitly opting-in "
+                "with 'ssl_version'" % (self.host, self.sock.version()),
+                DeprecationWarning,
+            )
 
-    def _connect_tls_proxy(self, hostname: str, sock: socket.socket) -> ssl.SSLSocket:
+        if self.assert_fingerprint:
+            assert_fingerprint(
+                self.sock.getpeercert(binary_form=True), self.assert_fingerprint
+            )
+        elif (
+            context.verify_mode != ssl.CERT_NONE
+            and not getattr(context, "check_hostname", False)
+            and self.assert_hostname is not False
+        ):
+            # While urllib3 attempts to always turn off hostname matching from
+            # the TLS library, this cannot always be done. So we check whether
+            # the TLS Library still thinks it's matching hostnames.
+            cert = self.sock.getpeercert()
+            if not cert.get("subjectAltName", ()):
+                warnings.warn(
+                    (
+                        "Certificate for {0} has no `subjectAltName`, falling back to check for a "
+                        "`commonName` for now. This feature is being removed by major browsers and "
+                        "deprecated by RFC 2818. (See https://github.com/urllib3/urllib3/issues/497 "
+                        "for details.)".format(hostname)
+                    ),
+                    SubjectAltNameWarning,
+                )
+            _match_hostname(cert, self.assert_hostname or server_hostname)
+
+        self.is_verified = (
+            context.verify_mode == ssl.CERT_REQUIRED
+            or self.assert_fingerprint is not None
+        )
+
+    def _connect_tls_proxy(self, hostname, conn):
         """
         Establish a TLS connection to the proxy using the provided SSL context.
         """
-        # `_connect_tls_proxy` is called when self._tunnel_host is truthy.
-        proxy_config = typing.cast(ProxyConfig, self.proxy_config)
+        proxy_config = self.proxy_config
         ssl_context = proxy_config.ssl_context
-        sock_and_verified = _ssl_wrap_socket_and_match_hostname(
-            sock,
-            cert_reqs=self.cert_reqs,
-            ssl_version=self.ssl_version,
-            ssl_minimum_version=self.ssl_minimum_version,
-            ssl_maximum_version=self.ssl_maximum_version,
+        if ssl_context:
+            # If the user provided a proxy context, we assume CA and client
+            # certificates have already been set
+            return ssl_wrap_socket(
+                sock=conn,
+                server_hostname=hostname,
+                ssl_context=ssl_context,
+            )
+
+        ssl_context = create_proxy_ssl_context(
+            self.ssl_version,
+            self.cert_reqs,
+            self.ca_certs,
+            self.ca_cert_dir,
+            self.ca_cert_data,
+        )
+
+        # If no cert was provided, use only the default options for server
+        # certificate validation
+        socket = ssl_wrap_socket(
+            sock=conn,
             ca_certs=self.ca_certs,
             ca_cert_dir=self.ca_cert_dir,
             ca_cert_data=self.ca_cert_data,
             server_hostname=hostname,
             ssl_context=ssl_context,
-            assert_hostname=proxy_config.assert_hostname,
-            assert_fingerprint=proxy_config.assert_fingerprint,
-            # Features that aren't implemented for proxies yet:
-            cert_file=None,
-            key_file=None,
-            key_password=None,
-            tls_in_tls=False,
         )
-        self.proxy_is_verified = sock_and_verified.is_verified
-        return sock_and_verified.socket  # type: ignore[return-value]
 
-
-class _WrappedAndVerifiedSocket(typing.NamedTuple):
-    """
-    Wrapped socket and whether the connection is
-    verified after the TLS handshake
-    """
-
-    socket: ssl.SSLSocket | SSLTransport
-    is_verified: bool
-
-
-def _ssl_wrap_socket_and_match_hostname(
-    sock: socket.socket,
-    *,
-    cert_reqs: None | str | int,
-    ssl_version: None | str | int,
-    ssl_minimum_version: int | None,
-    ssl_maximum_version: int | None,
-    cert_file: str | None,
-    key_file: str | None,
-    key_password: str | None,
-    ca_certs: str | None,
-    ca_cert_dir: str | None,
-    ca_cert_data: None | str | bytes,
-    assert_hostname: None | str | Literal[False],
-    assert_fingerprint: str | None,
-    server_hostname: str | None,
-    ssl_context: ssl.SSLContext | None,
-    tls_in_tls: bool = False,
-) -> _WrappedAndVerifiedSocket:
-    """Logic for constructing an SSLContext from all TLS parameters, passing
-    that down into ssl_wrap_socket, and then doing certificate verification
-    either via hostname or fingerprint. This function exists to guarantee
-    that both proxies and targets have the same behavior when connecting via TLS.
-    """
-    default_ssl_context = False
-    if ssl_context is None:
-        default_ssl_context = True
-        context = create_urllib3_context(
-            ssl_version=resolve_ssl_version(ssl_version),
-            ssl_minimum_version=ssl_minimum_version,
-            ssl_maximum_version=ssl_maximum_version,
-            cert_reqs=resolve_cert_reqs(cert_reqs),
-        )
-    else:
-        context = ssl_context
-
-    context.verify_mode = resolve_cert_reqs(cert_reqs)
-
-    # In some cases, we want to verify hostnames ourselves
-    if (
-        # `ssl` can't verify fingerprints or alternate hostnames
-        assert_fingerprint
-        or assert_hostname
-        # assert_hostname can be set to False to disable hostname checking
-        or assert_hostname is False
-        # We still support OpenSSL 1.0.2, which prevents us from verifying
-        # hostnames easily: https://github.com/pyca/pyopenssl/pull/933
-        or ssl_.IS_PYOPENSSL
-        or not ssl_.HAS_NEVER_CHECK_COMMON_NAME
-    ):
-        context.check_hostname = False
-
-    # Try to load OS default certs if none are given.
-    # We need to do the hasattr() check for our custom
-    # pyOpenSSL and SecureTransport SSLContext objects
-    # because neither support load_default_certs().
-    if (
-        not ca_certs
-        and not ca_cert_dir
-        and not ca_cert_data
-        and default_ssl_context
-        and hasattr(context, "load_default_certs")
-    ):
-        context.load_default_certs()
-
-    # Ensure that IPv6 addresses are in the proper format and don't have a
-    # scope ID. Python's SSL module fails to recognize scoped IPv6 addresses
-    # and interprets them as DNS hostnames.
-    if server_hostname is not None:
-        normalized = server_hostname.strip("[]")
-        if "%" in normalized:
-            normalized = normalized[: normalized.rfind("%")]
-        if is_ipaddress(normalized):
-            server_hostname = normalized
-
-    ssl_sock = ssl_wrap_socket(
-        sock=sock,
-        keyfile=key_file,
-        certfile=cert_file,
-        key_password=key_password,
-        ca_certs=ca_certs,
-        ca_cert_dir=ca_cert_dir,
-        ca_cert_data=ca_cert_data,
-        server_hostname=server_hostname,
-        ssl_context=context,
-        tls_in_tls=tls_in_tls,
-    )
-
-    try:
-        if assert_fingerprint:
-            _assert_fingerprint(
-                ssl_sock.getpeercert(binary_form=True), assert_fingerprint
-            )
-        elif (
-            context.verify_mode != ssl.CERT_NONE
-            and not context.check_hostname
-            and assert_hostname is not False
+        if ssl_context.verify_mode != ssl.CERT_NONE and not getattr(
+            ssl_context, "check_hostname", False
         ):
-            cert: _TYPE_PEER_CERT_RET_DICT = ssl_sock.getpeercert()  # type: ignore[assignment]
-
-            # Need to signal to our match_hostname whether to use 'commonName' or not.
-            # If we're using our own constructed SSLContext we explicitly set 'False'
-            # because PyPy hard-codes 'True' from SSLContext.hostname_checks_common_name.
-            if default_ssl_context:
-                hostname_checks_common_name = False
-            else:
-                hostname_checks_common_name = (
-                    getattr(context, "hostname_checks_common_name", False) or False
+            # While urllib3 attempts to always turn off hostname matching from
+            # the TLS library, this cannot always be done. So we check whether
+            # the TLS Library still thinks it's matching hostnames.
+            cert = socket.getpeercert()
+            if not cert.get("subjectAltName", ()):
+                warnings.warn(
+                    (
+                        "Certificate for {0} has no `subjectAltName`, falling back to check for a "
+                        "`commonName` for now. This feature is being removed by major browsers and "
+                        "deprecated by RFC 2818. (See https://github.com/urllib3/urllib3/issues/497 "
+                        "for details.)".format(hostname)
+                    ),
+                    SubjectAltNameWarning,
                 )
+            _match_hostname(cert, hostname)
 
-            _match_hostname(
-                cert,
-                assert_hostname or server_hostname,  # type: ignore[arg-type]
-                hostname_checks_common_name,
-            )
-
-        return _WrappedAndVerifiedSocket(
-            socket=ssl_sock,
-            is_verified=context.verify_mode == ssl.CERT_REQUIRED
-            or bool(assert_fingerprint),
-        )
-    except BaseException:
-        ssl_sock.close()
-        raise
+        self.proxy_is_verified = ssl_context.verify_mode == ssl.CERT_REQUIRED
+        return socket
 
 
-def _match_hostname(
-    cert: _TYPE_PEER_CERT_RET_DICT | None,
-    asserted_hostname: str,
-    hostname_checks_common_name: bool = False,
-) -> None:
+def _match_hostname(cert, asserted_hostname):
     # Our upstream implementation of ssl.match_hostname()
     # only applies this normalization to IP addresses so it doesn't
     # match DNS SANs so we do the same thing!
-    stripped_hostname = asserted_hostname.strip("[]")
+    stripped_hostname = asserted_hostname.strip("u[]")
     if is_ipaddress(stripped_hostname):
         asserted_hostname = stripped_hostname
 
     try:
-        match_hostname(cert, asserted_hostname, hostname_checks_common_name)
+        match_hostname(cert, asserted_hostname)
     except CertificateError as e:
         log.warning(
             "Certificate did not match expected hostname: %s. Certificate: %s",
@@ -853,54 +551,22 @@ def _match_hostname(
         )
         # Add cert to exception and reraise so client code can inspect
         # the cert when catching the exception, if they want to
-        e._peer_cert = cert  # type: ignore[attr-defined]
+        e._peer_cert = cert
         raise
 
 
-def _wrap_proxy_error(err: Exception, proxy_scheme: str | None) -> ProxyError:
-    # Look for the phrase 'wrong version number', if found
-    # then we should warn the user that we're very sure that
-    # this proxy is HTTP-only and they have a configuration issue.
-    error_normalized = " ".join(re.split("[^a-z]", str(err).lower()))
-    is_likely_http_proxy = (
-        "wrong version number" in error_normalized
-        or "unknown protocol" in error_normalized
-    )
-    http_proxy_warning = (
-        ". Your proxy appears to only use HTTP and not HTTPS, "
-        "try changing your proxy URL to be HTTP. See: "
-        "https://urllib3.readthedocs.io/en/latest/advanced-usage.html"
-        "#https-proxy-error-http-proxy"
-    )
-    new_err = ProxyError(
-        f"Unable to connect to proxy"
-        f"{http_proxy_warning if is_likely_http_proxy and proxy_scheme == 'https' else ''}",
-        err,
-    )
-    new_err.__cause__ = err
-    return new_err
+def _get_default_user_agent():
+    return "python-urllib3/%s" % __version__
 
 
-def _get_default_user_agent() -> str:
-    return f"python-urllib3/{__version__}"
-
-
-class DummyConnection:
+class DummyConnection(object):
     """Used to detect a failed ConnectionCls import."""
 
+    pass
+
 
 if not ssl:
-    HTTPSConnection = DummyConnection  # type: ignore[misc, assignment] # noqa: F811
+    HTTPSConnection = DummyConnection  # noqa: F811
 
 
 VerifiedHTTPSConnection = HTTPSConnection
-
-
-def _url_from_connection(
-    conn: HTTPConnection | HTTPSConnection, path: str | None = None
-) -> str:
-    """Returns the URL from a given connection. This is mainly used for testing and logging."""
-
-    scheme = "https" if isinstance(conn, HTTPSConnection) else "http"
-
-    return Url(scheme=scheme, host=conn.host, port=conn.port, path=path).url
diff --git a/lib/urllib3/connectionpool.py b/lib/urllib3/connectionpool.py
index 2479405b..96844d93 100644
--- a/lib/urllib3/connectionpool.py
+++ b/lib/urllib3/connectionpool.py
@@ -1,17 +1,14 @@
-from __future__ import annotations
+from __future__ import absolute_import
 
 import errno
 import logging
-import queue
+import re
+import socket
 import sys
-import typing
 import warnings
-import weakref
+from socket import error as SocketError
 from socket import timeout as SocketTimeout
-from types import TracebackType
 
-from ._base_connection import _TYPE_BODY
-from ._request_methods import RequestMethods
 from .connection import (
     BaseSSLError,
     BrokenPipeError,
@@ -19,14 +16,13 @@ from .connection import (
     HTTPConnection,
     HTTPException,
     HTTPSConnection,
-    ProxyConfig,
-    _wrap_proxy_error,
+    VerifiedHTTPSConnection,
+    port_by_scheme,
 )
-from .connection import port_by_scheme as port_by_scheme
 from .exceptions import (
     ClosedPoolError,
     EmptyPoolError,
-    FullPoolError,
+    HeaderParsingError,
     HostChangedError,
     InsecureRequestWarning,
     LocationValueError,
@@ -38,34 +34,38 @@ from .exceptions import (
     SSLError,
     TimeoutError,
 )
-from .response import BaseHTTPResponse
+from .packages import six
+from .packages.six.moves import queue
+from .request import RequestMethods
+from .response import HTTPResponse
 from .util.connection import is_connection_dropped
 from .util.proxy import connection_requires_http_tunnel
-from .util.request import _TYPE_BODY_POSITION, set_file_position
+from .util.queue import LifoQueue
+from .util.request import set_file_position
+from .util.response import assert_header_parsing
 from .util.retry import Retry
 from .util.ssl_match_hostname import CertificateError
-from .util.timeout import _DEFAULT_TIMEOUT, _TYPE_DEFAULT, Timeout
+from .util.timeout import Timeout
 from .util.url import Url, _encode_target
 from .util.url import _normalize_host as normalize_host
-from .util.url import parse_url
-from .util.util import to_str
+from .util.url import get_host, parse_url
 
-if typing.TYPE_CHECKING:
-    import ssl
+try:  # Platform-specific: Python 3
+    import weakref
 
-    from typing_extensions import Literal
+    weakref_finalize = weakref.finalize
+except AttributeError:  # Platform-specific: Python 2
+    from .packages.backports.weakref_finalize import weakref_finalize
 
-    from ._base_connection import BaseHTTPConnection, BaseHTTPSConnection
+xrange = six.moves.xrange
 
 log = logging.getLogger(__name__)
 
-_TYPE_TIMEOUT = typing.Union[Timeout, float, _TYPE_DEFAULT, None]
-
-_SelfT = typing.TypeVar("_SelfT")
+_Default = object()
 
 
 # Pool objects
-class ConnectionPool:
+class ConnectionPool(object):
     """
     Base class for all connection pools, such as
     :class:`.HTTPConnectionPool` and :class:`.HTTPSConnectionPool`.
@@ -76,42 +76,33 @@ class ConnectionPool:
        target URIs.
     """
 
-    scheme: str | None = None
-    QueueCls = queue.LifoQueue
+    scheme = None
+    QueueCls = LifoQueue
 
-    def __init__(self, host: str, port: int | None = None) -> None:
+    def __init__(self, host, port=None):
         if not host:
             raise LocationValueError("No host specified.")
 
         self.host = _normalize_host(host, scheme=self.scheme)
+        self._proxy_host = host.lower()
         self.port = port
 
-        # This property uses 'normalize_host()' (not '_normalize_host()')
-        # to avoid removing square braces around IPv6 addresses.
-        # This value is sent to `HTTPConnection.set_tunnel()` if called
-        # because square braces are required for HTTP CONNECT tunneling.
-        self._tunnel_host = normalize_host(host, scheme=self.scheme).lower()
+    def __str__(self):
+        return "%s(host=%r, port=%r)" % (type(self).__name__, self.host, self.port)
 
-    def __str__(self) -> str:
-        return f"{type(self).__name__}(host={self.host!r}, port={self.port!r})"
-
-    def __enter__(self: _SelfT) -> _SelfT:
+    def __enter__(self):
         return self
 
-    def __exit__(
-        self,
-        exc_type: type[BaseException] | None,
-        exc_val: BaseException | None,
-        exc_tb: TracebackType | None,
-    ) -> Literal[False]:
+    def __exit__(self, exc_type, exc_val, exc_tb):
         self.close()
         # Return False to re-raise any potential exceptions
         return False
 
-    def close(self) -> None:
+    def close(self):
         """
         Close all pooled connections and disable the pool.
         """
+        pass
 
 
 # This is taken from http://hg.python.org/cpython/file/7aaba721ebc0/Lib/socket.py#l252
@@ -130,6 +121,14 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
         Port used for this HTTP Connection (None is equivalent to 80), passed
         into :class:`http.client.HTTPConnection`.
 
+    :param strict:
+        Causes BadStatusLine to be raised if the status line can't be parsed
+        as a valid HTTP/1.0 or 1.1 status line, passed into
+        :class:`http.client.HTTPConnection`.
+
+        .. note::
+           Only works in Python 2. This parameter is ignored in Python 3.
+
     :param timeout:
         Socket timeout in seconds for each individual connection. This can
         be a float or integer, which sets the timeout for the HTTP request,
@@ -171,27 +170,29 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
     """
 
     scheme = "http"
-    ConnectionCls: (
-        type[BaseHTTPConnection] | type[BaseHTTPSConnection]
-    ) = HTTPConnection
+    ConnectionCls = HTTPConnection
+    ResponseCls = HTTPResponse
 
     def __init__(
         self,
-        host: str,
-        port: int | None = None,
-        timeout: _TYPE_TIMEOUT | None = _DEFAULT_TIMEOUT,
-        maxsize: int = 1,
-        block: bool = False,
-        headers: typing.Mapping[str, str] | None = None,
-        retries: Retry | bool | int | None = None,
-        _proxy: Url | None = None,
-        _proxy_headers: typing.Mapping[str, str] | None = None,
-        _proxy_config: ProxyConfig | None = None,
-        **conn_kw: typing.Any,
+        host,
+        port=None,
+        strict=False,
+        timeout=Timeout.DEFAULT_TIMEOUT,
+        maxsize=1,
+        block=False,
+        headers=None,
+        retries=None,
+        _proxy=None,
+        _proxy_headers=None,
+        _proxy_config=None,
+        **conn_kw
     ):
         ConnectionPool.__init__(self, host, port)
         RequestMethods.__init__(self, headers)
 
+        self.strict = strict
+
         if not isinstance(timeout, Timeout):
             timeout = Timeout.from_float(timeout)
 
@@ -201,7 +202,7 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
         self.timeout = timeout
         self.retries = retries
 
-        self.pool: queue.LifoQueue[typing.Any] | None = self.QueueCls(maxsize)
+        self.pool = self.QueueCls(maxsize)
         self.block = block
 
         self.proxy = _proxy
@@ -209,7 +210,7 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
         self.proxy_config = _proxy_config
 
         # Fill the queue up so that doing get() on it will block properly
-        for _ in range(maxsize):
+        for _ in xrange(maxsize):
             self.pool.put(None)
 
         # These are mostly for testing and debugging purposes.
@@ -234,9 +235,9 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
 
         # Close all the HTTPConnections in the pool before the
         # HTTPConnectionPool object is garbage collected.
-        weakref.finalize(self, _close_pool_connections, pool)
+        weakref_finalize(self, _close_pool_connections, pool)
 
-    def _new_conn(self) -> BaseHTTPConnection:
+    def _new_conn(self):
         """
         Return a fresh :class:`HTTPConnection`.
         """
@@ -252,11 +253,12 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
             host=self.host,
             port=self.port,
             timeout=self.timeout.connect_timeout,
-            **self.conn_kw,
+            strict=self.strict,
+            **self.conn_kw
         )
         return conn
 
-    def _get_conn(self, timeout: float | None = None) -> BaseHTTPConnection:
+    def _get_conn(self, timeout=None):
         """
         Get a connection. Will return a pooled connection if one is available.
 
@@ -269,32 +271,33 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
             :prop:`.block` is ``True``.
         """
         conn = None
-
-        if self.pool is None:
-            raise ClosedPoolError(self, "Pool is closed.")
-
         try:
             conn = self.pool.get(block=self.block, timeout=timeout)
 
         except AttributeError:  # self.pool is None
-            raise ClosedPoolError(self, "Pool is closed.") from None  # Defensive:
+            raise ClosedPoolError(self, "Pool is closed.")
 
         except queue.Empty:
             if self.block:
                 raise EmptyPoolError(
                     self,
-                    "Pool is empty and a new connection can't be opened due to blocking mode.",
-                ) from None
+                    "Pool reached maximum size and no more connections are allowed.",
+                )
             pass  # Oh well, we'll create a new connection then
 
         # If this is a persistent connection, check if it got disconnected
         if conn and is_connection_dropped(conn):
             log.debug("Resetting dropped connection: %s", self.host)
             conn.close()
+            if getattr(conn, "auto_open", 1) == 0:
+                # This is a proxied connection that has been mutated by
+                # http.client._tunnel() and cannot be reused (since it would
+                # attempt to bypass the proxy)
+                conn = None
 
         return conn or self._new_conn()
 
-    def _put_conn(self, conn: BaseHTTPConnection | None) -> None:
+    def _put_conn(self, conn):
         """
         Put a connection back into the pool.
 
@@ -308,47 +311,36 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
 
         If the pool is closed, then the connection will be closed and discarded.
         """
-        if self.pool is not None:
-            try:
-                self.pool.put(conn, block=False)
-                return  # Everything is dandy, done.
-            except AttributeError:
-                # self.pool is None.
-                pass
-            except queue.Full:
-                # Connection never got put back into the pool, close it.
-                if conn:
-                    conn.close()
-
-                if self.block:
-                    # This should never happen if you got the conn from self._get_conn
-                    raise FullPoolError(
-                        self,
-                        "Pool reached maximum size and no more connections are allowed.",
-                    ) from None
-
-                log.warning(
-                    "Connection pool is full, discarding connection: %s. Connection pool size: %s",
-                    self.host,
-                    self.pool.qsize(),
-                )
-
+        try:
+            self.pool.put(conn, block=False)
+            return  # Everything is dandy, done.
+        except AttributeError:
+            # self.pool is None.
+            pass
+        except queue.Full:
+            # This should never happen if self.block == True
+            log.warning(
+                "Connection pool is full, discarding connection: %s. Connection pool size: %s",
+                self.host,
+                self.pool.qsize(),
+            )
         # Connection never got put back into the pool, close it.
         if conn:
             conn.close()
 
-    def _validate_conn(self, conn: BaseHTTPConnection) -> None:
+    def _validate_conn(self, conn):
         """
         Called right before a request is made, after the socket is created.
         """
+        pass
 
-    def _prepare_proxy(self, conn: BaseHTTPConnection) -> None:
+    def _prepare_proxy(self, conn):
         # Nothing to do for HTTP connections.
         pass
 
-    def _get_timeout(self, timeout: _TYPE_TIMEOUT) -> Timeout:
+    def _get_timeout(self, timeout):
         """Helper that always returns a :class:`urllib3.util.Timeout`"""
-        if timeout is _DEFAULT_TIMEOUT:
+        if timeout is _Default:
             return self.timeout.clone()
 
         if isinstance(timeout, Timeout):
@@ -358,40 +350,34 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
             # can be removed later
             return Timeout.from_float(timeout)
 
-    def _raise_timeout(
-        self,
-        err: BaseSSLError | OSError | SocketTimeout,
-        url: str,
-        timeout_value: _TYPE_TIMEOUT | None,
-    ) -> None:
+    def _raise_timeout(self, err, url, timeout_value):
         """Is the error actually a timeout? Will raise a ReadTimeout or pass"""
 
         if isinstance(err, SocketTimeout):
             raise ReadTimeoutError(
-                self, url, f"Read timed out. (read timeout={timeout_value})"
-            ) from err
+                self, url, "Read timed out. (read timeout=%s)" % timeout_value
+            )
 
-        # See the above comment about EAGAIN in Python 3.
+        # See the above comment about EAGAIN in Python 3. In Python 2 we have
+        # to specifically catch it and throw the timeout error
         if hasattr(err, "errno") and err.errno in _blocking_errnos:
             raise ReadTimeoutError(
-                self, url, f"Read timed out. (read timeout={timeout_value})"
-            ) from err
+                self, url, "Read timed out. (read timeout=%s)" % timeout_value
+            )
+
+        # Catch possible read timeouts thrown as SSL errors. If not the
+        # case, rethrow the original. We need to do this because of:
+        # http://bugs.python.org/issue10272
+        if "timed out" in str(err) or "did not complete (read)" in str(
+            err
+        ):  # Python < 2.7.4
+            raise ReadTimeoutError(
+                self, url, "Read timed out. (read timeout=%s)" % timeout_value
+            )
 
     def _make_request(
-        self,
-        conn: BaseHTTPConnection,
-        method: str,
-        url: str,
-        body: _TYPE_BODY | None = None,
-        headers: typing.Mapping[str, str] | None = None,
-        retries: Retry | None = None,
-        timeout: _TYPE_TIMEOUT = _DEFAULT_TIMEOUT,
-        chunked: bool = False,
-        response_conn: BaseHTTPConnection | None = None,
-        preload_content: bool = True,
-        decode_content: bool = True,
-        enforce_content_length: bool = True,
-    ) -> BaseHTTPResponse:
+        self, conn, method, url, timeout=_Default, chunked=False, **httplib_request_kw
+    ):
         """
         Perform a request on a given urllib connection object taken from our
         pool.
@@ -399,61 +385,12 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
         :param conn:
             a connection from one of our connection pools
 
-        :param method:
-            HTTP request method (such as GET, POST, PUT, etc.)
-
-        :param url:
-            The URL to perform the request on.
-
-        :param body:
-            Data to send in the request body, either :class:`str`, :class:`bytes`,
-            an iterable of :class:`str`/:class:`bytes`, or a file-like object.
-
-        :param headers:
-            Dictionary of custom headers to send, such as User-Agent,
-            If-None-Match, etc. If None, pool headers are used. If provided,
-            these headers completely replace any pool-specific headers.
-
-        :param retries:
-            Configure the number of retries to allow before raising a
-            :class:`~urllib3.exceptions.MaxRetryError` exception.
-
-            Pass ``None`` to retry until you receive a response. Pass a
-            :class:`~urllib3.util.retry.Retry` object for fine-grained control
-            over different types of retries.
-            Pass an integer number to retry connection errors that many times,
-            but no other types of errors. Pass zero to never retry.
-
-            If ``False``, then retries are disabled and any exception is raised
-            immediately. Also, instead of raising a MaxRetryError on redirects,
-            the redirect response will be returned.
-
-        :type retries: :class:`~urllib3.util.retry.Retry`, False, or an int.
-
         :param timeout:
-            If specified, overrides the default timeout for this one
-            request. It may be a float (in seconds) or an instance of
-            :class:`urllib3.util.Timeout`.
-
-        :param chunked:
-            If True, urllib3 will send the body using chunked transfer
-            encoding. Otherwise, urllib3 will send the body using the standard
-            content-length form. Defaults to False.
-
-        :param response_conn:
-            Set this to ``None`` if you will handle releasing the connection or
-            set the connection to have the response release it.
-
-        :param preload_content:
-          If True, the response's body will be preloaded during construction.
-
-        :param decode_content:
-            If True, will attempt to decode the body based on the
-            'content-encoding' header.
-
-        :param enforce_content_length:
-            Enforce content length checking. Body returned by server must match
-            value of Content-Length header, if present. Otherwise, raise error.
+            Socket timeout in seconds for the request. This can be a
+            float or integer, which will set the same timeout value for
+            the socket connect and the socket read, or an instance of
+            :class:`urllib3.util.Timeout`, which gives you more fine-grained
+            control over your timeouts.
         """
         self.num_requests += 1
 
@@ -461,65 +398,44 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
         timeout_obj.start_connect()
         conn.timeout = Timeout.resolve_default_timeout(timeout_obj.connect_timeout)
 
+        # Trigger any extra validation we need to do.
         try:
-            # Trigger any extra validation we need to do.
-            try:
-                self._validate_conn(conn)
-            except (SocketTimeout, BaseSSLError) as e:
-                self._raise_timeout(err=e, url=url, timeout_value=conn.timeout)
-                raise
-
-        # _validate_conn() starts the connection to an HTTPS proxy
-        # so we need to wrap errors with 'ProxyError' here too.
-        except (
-            OSError,
-            NewConnectionError,
-            TimeoutError,
-            BaseSSLError,
-            CertificateError,
-            SSLError,
-        ) as e:
-            new_e: Exception = e
-            if isinstance(e, (BaseSSLError, CertificateError)):
-                new_e = SSLError(e)
-            # If the connection didn't successfully connect to it's proxy
-            # then there
-            if isinstance(
-                new_e, (OSError, NewConnectionError, TimeoutError, SSLError)
-            ) and (conn and conn.proxy and not conn.has_connected_to_proxy):
-                new_e = _wrap_proxy_error(new_e, conn.proxy.scheme)
-            raise new_e
+            self._validate_conn(conn)
+        except (SocketTimeout, BaseSSLError) as e:
+            # Py2 raises this as a BaseSSLError, Py3 raises it as socket timeout.
+            self._raise_timeout(err=e, url=url, timeout_value=conn.timeout)
+            raise
 
         # conn.request() calls http.client.*.request, not the method in
         # urllib3.request. It also calls makefile (recv) on the socket.
         try:
-            conn.request(
-                method,
-                url,
-                body=body,
-                headers=headers,
-                chunked=chunked,
-                preload_content=preload_content,
-                decode_content=decode_content,
-                enforce_content_length=enforce_content_length,
-            )
+            if chunked:
+                conn.request_chunked(method, url, **httplib_request_kw)
+            else:
+                conn.request(method, url, **httplib_request_kw)
 
         # We are swallowing BrokenPipeError (errno.EPIPE) since the server is
         # legitimately able to close the connection after sending a valid response.
         # With this behaviour, the received response is still readable.
         except BrokenPipeError:
+            # Python 3
             pass
-        except OSError as e:
-            # MacOS/Linux
-            # EPROTOTYPE is needed on macOS
+        except IOError as e:
+            # Python 2 and macOS/Linux
+            # EPIPE and ESHUTDOWN are BrokenPipeError on Python 2, and EPROTOTYPE is needed on macOS
             # https://erickt.github.io/blog/2014/11/19/adventures-in-debugging-a-potential-osx-kernel-bug/
-            if e.errno != errno.EPROTOTYPE:
+            if e.errno not in {
+                errno.EPIPE,
+                errno.ESHUTDOWN,
+                errno.EPROTOTYPE,
+            }:
                 raise
 
         # Reset the timeout for the recv() on the socket
         read_timeout = timeout_obj.read_timeout
 
-        if not conn.is_closed:
+        # App Engine doesn't have a sock attr
+        if getattr(conn, "sock", None):
             # In Python 3 socket.py will catch EAGAIN and return None when you
             # try and read into the file pointer created by http.client, which
             # instead raises a BadStatusLine exception. Instead of catching
@@ -527,22 +443,33 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
             # timeouts, check for a zero timeout before making the request.
             if read_timeout == 0:
                 raise ReadTimeoutError(
-                    self, url, f"Read timed out. (read timeout={read_timeout})"
+                    self, url, "Read timed out. (read timeout=%s)" % read_timeout
                 )
-            conn.timeout = read_timeout
+            if read_timeout is Timeout.DEFAULT_TIMEOUT:
+                conn.sock.settimeout(socket.getdefaulttimeout())
+            else:  # None or a value
+                conn.sock.settimeout(read_timeout)
 
         # Receive the response from the server
         try:
-            response = conn.getresponse()
-        except (BaseSSLError, OSError) as e:
+            try:
+                # Python 2.7, use buffering of HTTP responses
+                httplib_response = conn.getresponse(buffering=True)
+            except TypeError:
+                # Python 3
+                try:
+                    httplib_response = conn.getresponse()
+                except BaseException as e:
+                    # Remove the TypeError from the exception chain in
+                    # Python 3 (including for exceptions like SystemExit).
+                    # Otherwise it looks like a bug in the code.
+                    six.raise_from(e, None)
+        except (SocketTimeout, BaseSSLError, SocketError) as e:
             self._raise_timeout(err=e, url=url, timeout_value=read_timeout)
             raise
 
-        # Set properties that are used by the pooling layer.
-        response.retries = retries
-        response._connection = response_conn  # type: ignore[attr-defined]
-        response._pool = self  # type: ignore[attr-defined]
-
+        # AppEngine doesn't have a version attr.
+        http_version = getattr(conn, "_http_vsn_str", "HTTP/?")
         log.debug(
             '%s://%s:%s "%s %s %s" %s %s',
             self.scheme,
@@ -550,15 +477,27 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
             self.port,
             method,
             url,
-            # HTTP version
-            conn._http_vsn_str,  # type: ignore[attr-defined]
-            response.status,
-            response.length_remaining,  # type: ignore[attr-defined]
+            http_version,
+            httplib_response.status,
+            httplib_response.length,
         )
 
-        return response
+        try:
+            assert_header_parsing(httplib_response.msg)
+        except (HeaderParsingError, TypeError) as hpe:  # Platform-specific: Python 3
+            log.warning(
+                "Failed to parse headers (url=%s): %s",
+                self._absolute_url(url),
+                hpe,
+                exc_info=True,
+            )
 
-    def close(self) -> None:
+        return httplib_response
+
+    def _absolute_url(self, path):
+        return Url(scheme=self.scheme, host=self.host, port=self.port, path=path).url
+
+    def close(self):
         """
         Close all pooled connections and disable the pool.
         """
@@ -570,7 +509,7 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
         # Close all the HTTPConnections in the pool.
         _close_pool_connections(old_pool)
 
-    def is_same_host(self, url: str) -> bool:
+    def is_same_host(self, url):
         """
         Check if the given ``url`` is a member of the same host as this
         connection pool.
@@ -579,8 +518,7 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
             return True
 
         # TODO: Add optional support for socket.gethostbyname checking.
-        scheme, _, host, port, *_ = parse_url(url)
-        scheme = scheme or "http"
+        scheme, host, port = get_host(url)
         if host is not None:
             host = _normalize_host(host, scheme=scheme)
 
@@ -592,24 +530,22 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
 
         return (scheme, host, port) == (self.scheme, self.host, self.port)
 
-    def urlopen(  # type: ignore[override]
+    def urlopen(
         self,
-        method: str,
-        url: str,
-        body: _TYPE_BODY | None = None,
-        headers: typing.Mapping[str, str] | None = None,
-        retries: Retry | bool | int | None = None,
-        redirect: bool = True,
-        assert_same_host: bool = True,
-        timeout: _TYPE_TIMEOUT = _DEFAULT_TIMEOUT,
-        pool_timeout: int | None = None,
-        release_conn: bool | None = None,
-        chunked: bool = False,
-        body_pos: _TYPE_BODY_POSITION | None = None,
-        preload_content: bool = True,
-        decode_content: bool = True,
-        **response_kw: typing.Any,
-    ) -> BaseHTTPResponse:
+        method,
+        url,
+        body=None,
+        headers=None,
+        retries=None,
+        redirect=True,
+        assert_same_host=True,
+        timeout=_Default,
+        pool_timeout=None,
+        release_conn=None,
+        chunked=False,
+        body_pos=None,
+        **response_kw
+    ):
         """
         Get a connection from the pool and perform an HTTP request. This is the
         lowest level call for making a request, so you'll need to specify all
@@ -617,8 +553,8 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
 
         .. note::
 
-           More commonly, it's appropriate to use a convenience method
-           such as :meth:`request`.
+           More commonly, it's appropriate to use a convenience method provided
+           by :class:`.RequestMethods`, such as :meth:`request`.
 
         .. note::
 
@@ -678,13 +614,6 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
             block for ``pool_timeout`` seconds and raise EmptyPoolError if no
             connection is available within the time period.
 
-        :param bool preload_content:
-            If True, the response's body will be preloaded into memory.
-
-        :param bool decode_content:
-            If True, will attempt to decode the body based on the
-            'content-encoding' header.
-
         :param release_conn:
             If False, then the urlopen call will not release the connection
             back into the pool once a response is received (but will release if
@@ -692,10 +621,10 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
             `preload_content=True`). This is useful if you're not preloading
             the response's content immediately. You will need to call
             ``r.release_conn()`` on the response ``r`` to return the connection
-            back into the pool. If None, it takes the value of ``preload_content``
-            which defaults to ``True``.
+            back into the pool. If None, it takes the value of
+            ``response_kw.get('preload_content', True)``.
 
-        :param bool chunked:
+        :param chunked:
             If True, urllib3 will send the body using chunked transfer
             encoding. Otherwise, urllib3 will send the body using the standard
             content-length form. Defaults to False.
@@ -704,7 +633,12 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
             Position to seek to in file-like body in the event of a retry or
             redirect. Typically this won't need to be set because urllib3 will
             auto-populate the value when needed.
+
+        :param \\**response_kw:
+            Additional parameters are passed to
+            :meth:`urllib3.response.HTTPResponse.from_httplib`
         """
+
         parsed_url = parse_url(url)
         destination_scheme = parsed_url.scheme
 
@@ -715,7 +649,7 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
             retries = Retry.from_int(retries, redirect=redirect, default=self.retries)
 
         if release_conn is None:
-            release_conn = preload_content
+            release_conn = response_kw.get("preload_content", True)
 
         # Check host
         if assert_same_host and not self.is_same_host(url):
@@ -723,9 +657,9 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
 
         # Ensure that the URL we're connecting to is properly encoded
         if url.startswith("/"):
-            url = to_str(_encode_target(url))
+            url = six.ensure_str(_encode_target(url))
         else:
-            url = to_str(parsed_url.url)
+            url = six.ensure_str(parsed_url.url)
 
         conn = None
 
@@ -748,8 +682,8 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
         # have to copy the headers dict so we can safely change it without those
         # changes being reflected in anyone else's copy.
         if not http_tunnel_required:
-            headers = headers.copy()  # type: ignore[attr-defined]
-            headers.update(self.proxy_headers)  # type: ignore[union-attr]
+            headers = headers.copy()
+            headers.update(self.proxy_headers)
 
         # Must keep the exception bound to a separate variable or else Python 3
         # complains about UnboundLocalError.
@@ -768,26 +702,16 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
             timeout_obj = self._get_timeout(timeout)
             conn = self._get_conn(timeout=pool_timeout)
 
-            conn.timeout = timeout_obj.connect_timeout  # type: ignore[assignment]
+            conn.timeout = timeout_obj.connect_timeout
 
-            # Is this a closed/new connection that requires CONNECT tunnelling?
-            if self.proxy is not None and http_tunnel_required and conn.is_closed:
-                try:
-                    self._prepare_proxy(conn)
-                except (BaseSSLError, OSError, SocketTimeout) as e:
-                    self._raise_timeout(
-                        err=e, url=self.proxy.url, timeout_value=conn.timeout
-                    )
-                    raise
+            is_new_proxy_conn = self.proxy is not None and not getattr(
+                conn, "sock", None
+            )
+            if is_new_proxy_conn and http_tunnel_required:
+                self._prepare_proxy(conn)
 
-            # If we're going to release the connection in ``finally:``, then
-            # the response doesn't need to know about the connection. Otherwise
-            # it will also try to release it and we'll have a double-release
-            # mess.
-            response_conn = conn if not release_conn else None
-
-            # Make the request on the HTTPConnection object
-            response = self._make_request(
+            # Make the request on the httplib connection object.
+            httplib_response = self._make_request(
                 conn,
                 method,
                 url,
@@ -795,11 +719,24 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
                 body=body,
                 headers=headers,
                 chunked=chunked,
+            )
+
+            # If we're going to release the connection in ``finally:``, then
+            # the response doesn't need to know about the connection. Otherwise
+            # it will also try to release it and we'll have a double-release
+            # mess.
+            response_conn = conn if not release_conn else None
+
+            # Pass method to Response for length checking
+            response_kw["request_method"] = method
+
+            # Import httplib's response into our own wrapper object
+            response = self.ResponseCls.from_httplib(
+                httplib_response,
+                pool=self,
+                connection=response_conn,
                 retries=retries,
-                response_conn=response_conn,
-                preload_content=preload_content,
-                decode_content=decode_content,
-                **response_kw,
+                **response_kw
             )
 
             # Everything went great!
@@ -814,35 +751,52 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
         except (
             TimeoutError,
             HTTPException,
-            OSError,
+            SocketError,
             ProtocolError,
             BaseSSLError,
             SSLError,
             CertificateError,
-            ProxyError,
         ) as e:
             # Discard the connection for these exceptions. It will be
             # replaced during the next _get_conn() call.
             clean_exit = False
-            new_e: Exception = e
-            if isinstance(e, (BaseSSLError, CertificateError)):
-                new_e = SSLError(e)
-            if isinstance(
-                new_e,
-                (
-                    OSError,
-                    NewConnectionError,
-                    TimeoutError,
-                    SSLError,
-                    HTTPException,
-                ),
-            ) and (conn and conn.proxy and not conn.has_connected_to_proxy):
-                new_e = _wrap_proxy_error(new_e, conn.proxy.scheme)
-            elif isinstance(new_e, (OSError, HTTPException)):
-                new_e = ProtocolError("Connection aborted.", new_e)
+
+            def _is_ssl_error_message_from_http_proxy(ssl_error):
+                # We're trying to detect the message 'WRONG_VERSION_NUMBER' but
+                # SSLErrors are kinda all over the place when it comes to the message,
+                # so we try to cover our bases here!
+                message = " ".join(re.split("[^a-z]", str(ssl_error).lower()))
+                return (
+                    "wrong version number" in message or "unknown protocol" in message
+                )
+
+            # Try to detect a common user error with proxies which is to
+            # set an HTTP proxy to be HTTPS when it should be 'http://'
+            # (ie {'http': 'http://proxy', 'https': 'https://proxy'})
+            # Instead we add a nice error message and point to a URL.
+            if (
+                isinstance(e, BaseSSLError)
+                and self.proxy
+                and _is_ssl_error_message_from_http_proxy(e)
+                and conn.proxy
+                and conn.proxy.scheme == "https"
+            ):
+                e = ProxyError(
+                    "Your proxy appears to only use HTTP and not HTTPS, "
+                    "try changing your proxy URL to be HTTP. See: "
+                    "https://urllib3.readthedocs.io/en/1.26.x/advanced-usage.html"
+                    "#https-proxy-error-http-proxy",
+                    SSLError(e),
+                )
+            elif isinstance(e, (BaseSSLError, CertificateError)):
+                e = SSLError(e)
+            elif isinstance(e, (SocketError, NewConnectionError)) and self.proxy:
+                e = ProxyError("Cannot connect to proxy.", e)
+            elif isinstance(e, (SocketError, HTTPException)):
+                e = ProtocolError("Connection aborted.", e)
 
             retries = retries.increment(
-                method, url, error=new_e, _pool=self, _stacktrace=sys.exc_info()[2]
+                method, url, error=e, _pool=self, _stacktrace=sys.exc_info()[2]
             )
             retries.sleep()
 
@@ -855,9 +809,7 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
                 # to throw the connection away unless explicitly told not to.
                 # Close the connection, set the variable to None, and make sure
                 # we put the None back in the pool to avoid leaking it.
-                if conn:
-                    conn.close()
-                    conn = None
+                conn = conn and conn.close()
                 release_this_conn = True
 
             if release_this_conn:
@@ -884,9 +836,7 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
                 release_conn=release_conn,
                 chunked=chunked,
                 body_pos=body_pos,
-                preload_content=preload_content,
-                decode_content=decode_content,
-                **response_kw,
+                **response_kw
             )
 
         # Handle redirect?
@@ -919,9 +869,7 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
                 release_conn=release_conn,
                 chunked=chunked,
                 body_pos=body_pos,
-                preload_content=preload_content,
-                decode_content=decode_content,
-                **response_kw,
+                **response_kw
             )
 
         # Check if we should retry the HTTP response.
@@ -951,9 +899,7 @@ class HTTPConnectionPool(ConnectionPool, RequestMethods):
                 release_conn=release_conn,
                 chunked=chunked,
                 body_pos=body_pos,
-                preload_content=preload_content,
-                decode_content=decode_content,
-                **response_kw,
+                **response_kw
             )
 
         return response
@@ -974,35 +920,37 @@ class HTTPSConnectionPool(HTTPConnectionPool):
     """
 
     scheme = "https"
-    ConnectionCls: type[BaseHTTPSConnection] = HTTPSConnection
+    ConnectionCls = HTTPSConnection
 
     def __init__(
         self,
-        host: str,
-        port: int | None = None,
-        timeout: _TYPE_TIMEOUT | None = _DEFAULT_TIMEOUT,
-        maxsize: int = 1,
-        block: bool = False,
-        headers: typing.Mapping[str, str] | None = None,
-        retries: Retry | bool | int | None = None,
-        _proxy: Url | None = None,
-        _proxy_headers: typing.Mapping[str, str] | None = None,
-        key_file: str | None = None,
-        cert_file: str | None = None,
-        cert_reqs: int | str | None = None,
-        key_password: str | None = None,
-        ca_certs: str | None = None,
-        ssl_version: int | str | None = None,
-        ssl_minimum_version: ssl.TLSVersion | None = None,
-        ssl_maximum_version: ssl.TLSVersion | None = None,
-        assert_hostname: str | Literal[False] | None = None,
-        assert_fingerprint: str | None = None,
-        ca_cert_dir: str | None = None,
-        **conn_kw: typing.Any,
-    ) -> None:
-        super().__init__(
+        host,
+        port=None,
+        strict=False,
+        timeout=Timeout.DEFAULT_TIMEOUT,
+        maxsize=1,
+        block=False,
+        headers=None,
+        retries=None,
+        _proxy=None,
+        _proxy_headers=None,
+        key_file=None,
+        cert_file=None,
+        cert_reqs=None,
+        key_password=None,
+        ca_certs=None,
+        ssl_version=None,
+        assert_hostname=None,
+        assert_fingerprint=None,
+        ca_cert_dir=None,
+        **conn_kw
+    ):
+
+        HTTPConnectionPool.__init__(
+            self,
             host,
             port,
+            strict,
             timeout,
             maxsize,
             block,
@@ -1010,7 +958,7 @@ class HTTPSConnectionPool(HTTPConnectionPool):
             retries,
             _proxy,
             _proxy_headers,
-            **conn_kw,
+            **conn_kw
         )
 
         self.key_file = key_file
@@ -1020,29 +968,47 @@ class HTTPSConnectionPool(HTTPConnectionPool):
         self.ca_certs = ca_certs
         self.ca_cert_dir = ca_cert_dir
         self.ssl_version = ssl_version
-        self.ssl_minimum_version = ssl_minimum_version
-        self.ssl_maximum_version = ssl_maximum_version
         self.assert_hostname = assert_hostname
         self.assert_fingerprint = assert_fingerprint
 
-    def _prepare_proxy(self, conn: HTTPSConnection) -> None:  # type: ignore[override]
-        """Establishes a tunnel connection through HTTP CONNECT."""
-        if self.proxy and self.proxy.scheme == "https":
-            tunnel_scheme = "https"
-        else:
-            tunnel_scheme = "http"
+    def _prepare_conn(self, conn):
+        """
+        Prepare the ``connection`` for :meth:`urllib3.util.ssl_wrap_socket`
+        and establish the tunnel if proxy is used.
+        """
+
+        if isinstance(conn, VerifiedHTTPSConnection):
+            conn.set_cert(
+                key_file=self.key_file,
+                key_password=self.key_password,
+                cert_file=self.cert_file,
+                cert_reqs=self.cert_reqs,
+                ca_certs=self.ca_certs,
+                ca_cert_dir=self.ca_cert_dir,
+                assert_hostname=self.assert_hostname,
+                assert_fingerprint=self.assert_fingerprint,
+            )
+            conn.ssl_version = self.ssl_version
+        return conn
+
+    def _prepare_proxy(self, conn):
+        """
+        Establishes a tunnel connection through HTTP CONNECT.
+
+        Tunnel connection is established early because otherwise httplib would
+        improperly set Host: header to proxy's IP:port.
+        """
+
+        conn.set_tunnel(self._proxy_host, self.port, self.proxy_headers)
+
+        if self.proxy.scheme == "https":
+            conn.tls_in_tls_required = True
 
-        conn.set_tunnel(
-            scheme=tunnel_scheme,
-            host=self._tunnel_host,
-            port=self.port,
-            headers=self.proxy_headers,
-        )
         conn.connect()
 
-    def _new_conn(self) -> BaseHTTPSConnection:
+    def _new_conn(self):
         """
-        Return a fresh :class:`urllib3.connection.HTTPConnection`.
+        Return a fresh :class:`http.client.HTTPSConnection`.
         """
         self.num_connections += 1
         log.debug(
@@ -1052,58 +1018,64 @@ class HTTPSConnectionPool(HTTPConnectionPool):
             self.port or "443",
         )
 
-        if not self.ConnectionCls or self.ConnectionCls is DummyConnection:  # type: ignore[comparison-overlap]
-            raise ImportError(
+        if not self.ConnectionCls or self.ConnectionCls is DummyConnection:
+            raise SSLError(
                 "Can't connect to HTTPS URL because the SSL module is not available."
             )
 
-        actual_host: str = self.host
+        actual_host = self.host
         actual_port = self.port
-        if self.proxy is not None and self.proxy.host is not None:
+        if self.proxy is not None:
             actual_host = self.proxy.host
             actual_port = self.proxy.port
 
-        return self.ConnectionCls(
+        conn = self.ConnectionCls(
             host=actual_host,
             port=actual_port,
             timeout=self.timeout.connect_timeout,
+            strict=self.strict,
             cert_file=self.cert_file,
             key_file=self.key_file,
             key_password=self.key_password,
-            cert_reqs=self.cert_reqs,
-            ca_certs=self.ca_certs,
-            ca_cert_dir=self.ca_cert_dir,
-            assert_hostname=self.assert_hostname,
-            assert_fingerprint=self.assert_fingerprint,
-            ssl_version=self.ssl_version,
-            ssl_minimum_version=self.ssl_minimum_version,
-            ssl_maximum_version=self.ssl_maximum_version,
-            **self.conn_kw,
+            **self.conn_kw
         )
 
-    def _validate_conn(self, conn: BaseHTTPConnection) -> None:
+        return self._prepare_conn(conn)
+
+    def _validate_conn(self, conn):
         """
         Called right before a request is made, after the socket is created.
         """
-        super()._validate_conn(conn)
+        super(HTTPSConnectionPool, self)._validate_conn(conn)
 
         # Force connect early to allow us to validate the connection.
-        if conn.is_closed:
+        if not getattr(conn, "sock", None):  # AppEngine might not have  `.sock`
             conn.connect()
 
         if not conn.is_verified:
             warnings.warn(
                 (
-                    f"Unverified HTTPS request is being made to host '{conn.host}'. "
+                    "Unverified HTTPS request is being made to host '%s'. "
                     "Adding certificate verification is strongly advised. See: "
-                    "https://urllib3.readthedocs.io/en/latest/advanced-usage.html"
-                    "#tls-warnings"
+                    "https://urllib3.readthedocs.io/en/1.26.x/advanced-usage.html"
+                    "#ssl-warnings" % conn.host
+                ),
+                InsecureRequestWarning,
+            )
+
+        if getattr(conn, "proxy_is_verified", None) is False:
+            warnings.warn(
+                (
+                    "Unverified HTTPS connection done to an HTTPS proxy. "
+                    "Adding certificate verification is strongly advised. See: "
+                    "https://urllib3.readthedocs.io/en/1.26.x/advanced-usage.html"
+                    "#ssl-warnings"
                 ),
                 InsecureRequestWarning,
             )
 
 
-def connection_from_url(url: str, **kw: typing.Any) -> HTTPConnectionPool:
+def connection_from_url(url, **kw):
     """
     Given a url, return an :class:`.ConnectionPool` instance of its host.
 
@@ -1123,26 +1095,15 @@ def connection_from_url(url: str, **kw: typing.Any) -> HTTPConnectionPool:
         >>> conn = connection_from_url('http://google.com/')
         >>> r = conn.request('GET', '/')
     """
-    scheme, _, host, port, *_ = parse_url(url)
-    scheme = scheme or "http"
+    scheme, host, port = get_host(url)
     port = port or port_by_scheme.get(scheme, 80)
     if scheme == "https":
-        return HTTPSConnectionPool(host, port=port, **kw)  # type: ignore[arg-type]
+        return HTTPSConnectionPool(host, port=port, **kw)
     else:
-        return HTTPConnectionPool(host, port=port, **kw)  # type: ignore[arg-type]
+        return HTTPConnectionPool(host, port=port, **kw)
 
 
-@typing.overload
-def _normalize_host(host: None, scheme: str | None) -> None:
-    ...
-
-
-@typing.overload
-def _normalize_host(host: str, scheme: str | None) -> str:
-    ...
-
-
-def _normalize_host(host: str | None, scheme: str | None) -> str | None:
+def _normalize_host(host, scheme):
     """
     Normalize hosts for comparisons and use with sockets.
     """
@@ -1155,19 +1116,12 @@ def _normalize_host(host: str | None, scheme: str | None) -> str | None:
     # Instead, we need to make sure we never pass ``None`` as the port.
     # However, for backward compatibility reasons we can't actually
     # *assert* that.  See http://bugs.python.org/issue28539
-    if host and host.startswith("[") and host.endswith("]"):
+    if host.startswith("[") and host.endswith("]"):
         host = host[1:-1]
     return host
 
 
-def _url_from_pool(
-    pool: HTTPConnectionPool | HTTPSConnectionPool, path: str | None = None
-) -> str:
-    """Returns the URL from a given connection pool. This is mainly used for testing and logging."""
-    return Url(scheme=pool.scheme, host=pool.host, port=pool.port, path=path).url
-
-
-def _close_pool_connections(pool: queue.LifoQueue[typing.Any]) -> None:
+def _close_pool_connections(pool):
     """Drains a queue of connections and closes each one."""
     try:
         while True:
diff --git a/lib/urllib3/contrib/_appengine_environ.py b/lib/urllib3/contrib/_appengine_environ.py
new file mode 100644
index 00000000..8765b907
--- /dev/null
+++ b/lib/urllib3/contrib/_appengine_environ.py
@@ -0,0 +1,36 @@
+"""
+This module provides means to detect the App Engine environment.
+"""
+
+import os
+
+
+def is_appengine():
+    return is_local_appengine() or is_prod_appengine()
+
+
+def is_appengine_sandbox():
+    """Reports if the app is running in the first generation sandbox.
+
+    The second generation runtimes are technically still in a sandbox, but it
+    is much less restrictive, so generally you shouldn't need to check for it.
+    see https://cloud.google.com/appengine/docs/standard/runtimes
+    """
+    return is_appengine() and os.environ["APPENGINE_RUNTIME"] == "python27"
+
+
+def is_local_appengine():
+    return "APPENGINE_RUNTIME" in os.environ and os.environ.get(
+        "SERVER_SOFTWARE", ""
+    ).startswith("Development/")
+
+
+def is_prod_appengine():
+    return "APPENGINE_RUNTIME" in os.environ and os.environ.get(
+        "SERVER_SOFTWARE", ""
+    ).startswith("Google App Engine/")
+
+
+def is_prod_appengine_mvms():
+    """Deprecated."""
+    return False
diff --git a/lib/urllib3/contrib/_securetransport/bindings.py b/lib/urllib3/contrib/_securetransport/bindings.py
index 3e4cd466..264d564d 100644
--- a/lib/urllib3/contrib/_securetransport/bindings.py
+++ b/lib/urllib3/contrib/_securetransport/bindings.py
@@ -1,5 +1,3 @@
-# type: ignore
-
 """
 This module uses ctypes to bind a whole bunch of functions and constants from
 SecureTransport. The goal here is to provide the low-level API to
@@ -31,8 +29,7 @@ license and by oscrypto's:
     FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
     DEALINGS IN THE SOFTWARE.
 """
-
-from __future__ import annotations
+from __future__ import absolute_import
 
 import platform
 from ctypes import (
@@ -51,6 +48,8 @@ from ctypes import (
 )
 from ctypes.util import find_library
 
+from ...packages.six import raise_from
+
 if platform.system() != "Darwin":
     raise ImportError("Only macOS is supported")
 
@@ -58,16 +57,16 @@ version = platform.mac_ver()[0]
 version_info = tuple(map(int, version.split(".")))
 if version_info < (10, 8):
     raise OSError(
-        f"Only OS X 10.8 and newer are supported, not {version_info[0]}.{version_info[1]}"
+        "Only OS X 10.8 and newer are supported, not %s.%s"
+        % (version_info[0], version_info[1])
     )
 
 
-def load_cdll(name: str, macos10_16_path: str) -> CDLL:
+def load_cdll(name, macos10_16_path):
     """Loads a CDLL by name, falling back to known path on 10.16+"""
     try:
         # Big Sur is technically 11 but we use 10.16 due to the Big Sur
         # beta being labeled as 10.16.
-        path: str | None
         if version_info >= (10, 16):
             path = macos10_16_path
         else:
@@ -76,7 +75,7 @@ def load_cdll(name: str, macos10_16_path: str) -> CDLL:
             raise OSError  # Caught and reraised as 'ImportError'
         return CDLL(path, use_errno=True)
     except OSError:
-        raise ImportError(f"The library {name} failed to load") from None
+        raise_from(ImportError("The library %s failed to load" % name), None)
 
 
 Security = load_cdll(
@@ -417,14 +416,104 @@ try:
     CoreFoundation.CFStringRef = CFStringRef
     CoreFoundation.CFDictionaryRef = CFDictionaryRef
 
-except AttributeError:
-    raise ImportError("Error initializing ctypes") from None
+except (AttributeError):
+    raise ImportError("Error initializing ctypes")
 
 
-class CFConst:
+class CFConst(object):
     """
     A class object that acts as essentially a namespace for CoreFoundation
     constants.
     """
 
     kCFStringEncodingUTF8 = CFStringEncoding(0x08000100)
+
+
+class SecurityConst(object):
+    """
+    A class object that acts as essentially a namespace for Security constants.
+    """
+
+    kSSLSessionOptionBreakOnServerAuth = 0
+
+    kSSLProtocol2 = 1
+    kSSLProtocol3 = 2
+    kTLSProtocol1 = 4
+    kTLSProtocol11 = 7
+    kTLSProtocol12 = 8
+    # SecureTransport does not support TLS 1.3 even if there's a constant for it
+    kTLSProtocol13 = 10
+    kTLSProtocolMaxSupported = 999
+
+    kSSLClientSide = 1
+    kSSLStreamType = 0
+
+    kSecFormatPEMSequence = 10
+
+    kSecTrustResultInvalid = 0
+    kSecTrustResultProceed = 1
+    # This gap is present on purpose: this was kSecTrustResultConfirm, which
+    # is deprecated.
+    kSecTrustResultDeny = 3
+    kSecTrustResultUnspecified = 4
+    kSecTrustResultRecoverableTrustFailure = 5
+    kSecTrustResultFatalTrustFailure = 6
+    kSecTrustResultOtherError = 7
+
+    errSSLProtocol = -9800
+    errSSLWouldBlock = -9803
+    errSSLClosedGraceful = -9805
+    errSSLClosedNoNotify = -9816
+    errSSLClosedAbort = -9806
+
+    errSSLXCertChainInvalid = -9807
+    errSSLCrypto = -9809
+    errSSLInternal = -9810
+    errSSLCertExpired = -9814
+    errSSLCertNotYetValid = -9815
+    errSSLUnknownRootCert = -9812
+    errSSLNoRootCert = -9813
+    errSSLHostNameMismatch = -9843
+    errSSLPeerHandshakeFail = -9824
+    errSSLPeerUserCancelled = -9839
+    errSSLWeakPeerEphemeralDHKey = -9850
+    errSSLServerAuthCompleted = -9841
+    errSSLRecordOverflow = -9847
+
+    errSecVerifyFailed = -67808
+    errSecNoTrustSettings = -25263
+    errSecItemNotFound = -25300
+    errSecInvalidTrustSettings = -25262
+
+    # Cipher suites. We only pick the ones our default cipher string allows.
+    # Source: https://developer.apple.com/documentation/security/1550981-ssl_cipher_suite_values
+    TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384 = 0xC02C
+    TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 = 0xC030
+    TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256 = 0xC02B
+    TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 = 0xC02F
+    TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256 = 0xCCA9
+    TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256 = 0xCCA8
+    TLS_DHE_RSA_WITH_AES_256_GCM_SHA384 = 0x009F
+    TLS_DHE_RSA_WITH_AES_128_GCM_SHA256 = 0x009E
+    TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384 = 0xC024
+    TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384 = 0xC028
+    TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA = 0xC00A
+    TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA = 0xC014
+    TLS_DHE_RSA_WITH_AES_256_CBC_SHA256 = 0x006B
+    TLS_DHE_RSA_WITH_AES_256_CBC_SHA = 0x0039
+    TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256 = 0xC023
+    TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256 = 0xC027
+    TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA = 0xC009
+    TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA = 0xC013
+    TLS_DHE_RSA_WITH_AES_128_CBC_SHA256 = 0x0067
+    TLS_DHE_RSA_WITH_AES_128_CBC_SHA = 0x0033
+    TLS_RSA_WITH_AES_256_GCM_SHA384 = 0x009D
+    TLS_RSA_WITH_AES_128_GCM_SHA256 = 0x009C
+    TLS_RSA_WITH_AES_256_CBC_SHA256 = 0x003D
+    TLS_RSA_WITH_AES_128_CBC_SHA256 = 0x003C
+    TLS_RSA_WITH_AES_256_CBC_SHA = 0x0035
+    TLS_RSA_WITH_AES_128_CBC_SHA = 0x002F
+    TLS_AES_128_GCM_SHA256 = 0x1301
+    TLS_AES_256_GCM_SHA384 = 0x1302
+    TLS_AES_128_CCM_8_SHA256 = 0x1305
+    TLS_AES_128_CCM_SHA256 = 0x1304
diff --git a/lib/urllib3/contrib/_securetransport/low_level.py b/lib/urllib3/contrib/_securetransport/low_level.py
index e2356997..fa0b245d 100644
--- a/lib/urllib3/contrib/_securetransport/low_level.py
+++ b/lib/urllib3/contrib/_securetransport/low_level.py
@@ -7,8 +7,6 @@ CoreFoundation messing about and memory management. The concerns in this module
 are almost entirely about trying to avoid memory leaks and providing
 appropriate and useful assistance to the higher-level code.
 """
-from __future__ import annotations
-
 import base64
 import ctypes
 import itertools
@@ -17,20 +15,8 @@ import re
 import ssl
 import struct
 import tempfile
-import typing
 
-from .bindings import (  # type: ignore[attr-defined]
-    CFArray,
-    CFConst,
-    CFData,
-    CFDictionary,
-    CFMutableArray,
-    CFString,
-    CFTypeRef,
-    CoreFoundation,
-    SecKeychainRef,
-    Security,
-)
+from .bindings import CFConst, CoreFoundation, Security
 
 # This regular expression is used to grab PEM data out of a PEM bundle.
 _PEM_CERTS_RE = re.compile(
@@ -38,7 +24,7 @@ _PEM_CERTS_RE = re.compile(
 )
 
 
-def _cf_data_from_bytes(bytestring: bytes) -> CFData:
+def _cf_data_from_bytes(bytestring):
     """
     Given a bytestring, create a CFData object from it. This CFData object must
     be CFReleased by the caller.
@@ -48,9 +34,7 @@ def _cf_data_from_bytes(bytestring: bytes) -> CFData:
     )
 
 
-def _cf_dictionary_from_tuples(
-    tuples: list[tuple[typing.Any, typing.Any]]
-) -> CFDictionary:
+def _cf_dictionary_from_tuples(tuples):
     """
     Given a list of Python tuples, create an associated CFDictionary.
     """
@@ -72,7 +56,7 @@ def _cf_dictionary_from_tuples(
     )
 
 
-def _cfstr(py_bstr: bytes) -> CFString:
+def _cfstr(py_bstr):
     """
     Given a Python binary data, create a CFString.
     The string must be CFReleased by the caller.
@@ -86,7 +70,7 @@ def _cfstr(py_bstr: bytes) -> CFString:
     return cf_str
 
 
-def _create_cfstring_array(lst: list[bytes]) -> CFMutableArray:
+def _create_cfstring_array(lst):
     """
     Given a list of Python binary data, create an associated CFMutableArray.
     The array must be CFReleased by the caller.
@@ -113,11 +97,11 @@ def _create_cfstring_array(lst: list[bytes]) -> CFMutableArray:
     except BaseException as e:
         if cf_arr:
             CoreFoundation.CFRelease(cf_arr)
-        raise ssl.SSLError(f"Unable to allocate array: {e}") from None
+        raise ssl.SSLError("Unable to allocate array: %s" % (e,))
     return cf_arr
 
 
-def _cf_string_to_unicode(value: CFString) -> str | None:
+def _cf_string_to_unicode(value):
     """
     Creates a Unicode string from a CFString object. Used entirely for error
     reporting.
@@ -139,12 +123,10 @@ def _cf_string_to_unicode(value: CFString) -> str | None:
         string = buffer.value
     if string is not None:
         string = string.decode("utf-8")
-    return string  # type: ignore[no-any-return]
+    return string
 
 
-def _assert_no_error(
-    error: int, exception_class: type[BaseException] | None = None
-) -> None:
+def _assert_no_error(error, exception_class=None):
     """
     Checks the return code and throws an exception if there is an error to
     report
@@ -156,8 +138,8 @@ def _assert_no_error(
     output = _cf_string_to_unicode(cf_error_string)
     CoreFoundation.CFRelease(cf_error_string)
 
-    if output is None or output == "":
-        output = f"OSStatus {error}"
+    if output is None or output == u"":
+        output = u"OSStatus %s" % error
 
     if exception_class is None:
         exception_class = ssl.SSLError
@@ -165,7 +147,7 @@ def _assert_no_error(
     raise exception_class(output)
 
 
-def _cert_array_from_pem(pem_bundle: bytes) -> CFArray:
+def _cert_array_from_pem(pem_bundle):
     """
     Given a bundle of certs in PEM format, turns them into a CFArray of certs
     that can be used to validate a cert chain.
@@ -211,23 +193,23 @@ def _cert_array_from_pem(pem_bundle: bytes) -> CFArray:
     return cert_array
 
 
-def _is_cert(item: CFTypeRef) -> bool:
+def _is_cert(item):
     """
     Returns True if a given CFTypeRef is a certificate.
     """
     expected = Security.SecCertificateGetTypeID()
-    return CoreFoundation.CFGetTypeID(item) == expected  # type: ignore[no-any-return]
+    return CoreFoundation.CFGetTypeID(item) == expected
 
 
-def _is_identity(item: CFTypeRef) -> bool:
+def _is_identity(item):
     """
     Returns True if a given CFTypeRef is an identity.
     """
     expected = Security.SecIdentityGetTypeID()
-    return CoreFoundation.CFGetTypeID(item) == expected  # type: ignore[no-any-return]
+    return CoreFoundation.CFGetTypeID(item) == expected
 
 
-def _temporary_keychain() -> tuple[SecKeychainRef, str]:
+def _temporary_keychain():
     """
     This function creates a temporary Mac keychain that we can use to work with
     credentials. This keychain uses a one-time password and a temporary file to
@@ -262,9 +244,7 @@ def _temporary_keychain() -> tuple[SecKeychainRef, str]:
     return keychain, tempdirectory
 
 
-def _load_items_from_file(
-    keychain: SecKeychainRef, path: str
-) -> tuple[list[CFTypeRef], list[CFTypeRef]]:
+def _load_items_from_file(keychain, path):
     """
     Given a single file, loads all the trust objects from it into arrays and
     the keychain.
@@ -319,7 +299,7 @@ def _load_items_from_file(
     return (identities, certificates)
 
 
-def _load_client_cert_chain(keychain: SecKeychainRef, *paths: str | None) -> CFArray:
+def _load_client_cert_chain(keychain, *paths):
     """
     Load certificates and maybe keys from a number of files. Has the end goal
     of returning a CFArray containing one SecIdentityRef, and then zero or more
@@ -355,10 +335,10 @@ def _load_client_cert_chain(keychain: SecKeychainRef, *paths: str | None) -> CFA
     identities = []
 
     # Filter out bad paths.
-    filtered_paths = (path for path in paths if path)
+    paths = (path for path in paths if path)
 
     try:
-        for file_path in filtered_paths:
+        for file_path in paths:
             new_identities, new_certs = _load_items_from_file(keychain, file_path)
             identities.extend(new_identities)
             certificates.extend(new_certs)
@@ -403,7 +383,7 @@ TLS_PROTOCOL_VERSIONS = {
 }
 
 
-def _build_tls_unknown_ca_alert(version: str) -> bytes:
+def _build_tls_unknown_ca_alert(version):
     """
     Builds a TLS alert record for an unknown CA.
     """
@@ -415,60 +395,3 @@ def _build_tls_unknown_ca_alert(version: str) -> bytes:
     record_type_alert = 0x15
     record = struct.pack(">BBBH", record_type_alert, ver_maj, ver_min, msg_len) + msg
     return record
-
-
-class SecurityConst:
-    """
-    A class object that acts as essentially a namespace for Security constants.
-    """
-
-    kSSLSessionOptionBreakOnServerAuth = 0
-
-    kSSLProtocol2 = 1
-    kSSLProtocol3 = 2
-    kTLSProtocol1 = 4
-    kTLSProtocol11 = 7
-    kTLSProtocol12 = 8
-    # SecureTransport does not support TLS 1.3 even if there's a constant for it
-    kTLSProtocol13 = 10
-    kTLSProtocolMaxSupported = 999
-
-    kSSLClientSide = 1
-    kSSLStreamType = 0
-
-    kSecFormatPEMSequence = 10
-
-    kSecTrustResultInvalid = 0
-    kSecTrustResultProceed = 1
-    # This gap is present on purpose: this was kSecTrustResultConfirm, which
-    # is deprecated.
-    kSecTrustResultDeny = 3
-    kSecTrustResultUnspecified = 4
-    kSecTrustResultRecoverableTrustFailure = 5
-    kSecTrustResultFatalTrustFailure = 6
-    kSecTrustResultOtherError = 7
-
-    errSSLProtocol = -9800
-    errSSLWouldBlock = -9803
-    errSSLClosedGraceful = -9805
-    errSSLClosedNoNotify = -9816
-    errSSLClosedAbort = -9806
-
-    errSSLXCertChainInvalid = -9807
-    errSSLCrypto = -9809
-    errSSLInternal = -9810
-    errSSLCertExpired = -9814
-    errSSLCertNotYetValid = -9815
-    errSSLUnknownRootCert = -9812
-    errSSLNoRootCert = -9813
-    errSSLHostNameMismatch = -9843
-    errSSLPeerHandshakeFail = -9824
-    errSSLPeerUserCancelled = -9839
-    errSSLWeakPeerEphemeralDHKey = -9850
-    errSSLServerAuthCompleted = -9841
-    errSSLRecordOverflow = -9847
-
-    errSecVerifyFailed = -67808
-    errSecNoTrustSettings = -25263
-    errSecItemNotFound = -25300
-    errSecInvalidTrustSettings = -25262
diff --git a/lib/urllib3/contrib/appengine.py b/lib/urllib3/contrib/appengine.py
new file mode 100644
index 00000000..a5a6d910
--- /dev/null
+++ b/lib/urllib3/contrib/appengine.py
@@ -0,0 +1,314 @@
+"""
+This module provides a pool manager that uses Google App Engine's
+`URLFetch Service <https://cloud.google.com/appengine/docs/python/urlfetch>`_.
+
+Example usage::
+
+    from urllib3 import PoolManager
+    from urllib3.contrib.appengine import AppEngineManager, is_appengine_sandbox
+
+    if is_appengine_sandbox():
+        # AppEngineManager uses AppEngine's URLFetch API behind the scenes
+        http = AppEngineManager()
+    else:
+        # PoolManager uses a socket-level API behind the scenes
+        http = PoolManager()
+
+    r = http.request('GET', 'https://google.com/')
+
+There are `limitations <https://cloud.google.com/appengine/docs/python/\
+urlfetch/#Python_Quotas_and_limits>`_ to the URLFetch service and it may not be
+the best choice for your application. There are three options for using
+urllib3 on Google App Engine:
+
+1. You can use :class:`AppEngineManager` with URLFetch. URLFetch is
+   cost-effective in many circumstances as long as your usage is within the
+   limitations.
+2. You can use a normal :class:`~urllib3.PoolManager` by enabling sockets.
+   Sockets also have `limitations and restrictions
+   <https://cloud.google.com/appengine/docs/python/sockets/\
+   #limitations-and-restrictions>`_ and have a lower free quota than URLFetch.
+   To use sockets, be sure to specify the following in your ``app.yaml``::
+
+        env_variables:
+            GAE_USE_SOCKETS_HTTPLIB : 'true'
+
+3. If you are using `App Engine Flexible
+<https://cloud.google.com/appengine/docs/flexible/>`_, you can use the standard
+:class:`PoolManager` without any configuration or special environment variables.
+"""
+
+from __future__ import absolute_import
+
+import io
+import logging
+import warnings
+
+from ..exceptions import (
+    HTTPError,
+    HTTPWarning,
+    MaxRetryError,
+    ProtocolError,
+    SSLError,
+    TimeoutError,
+)
+from ..packages.six.moves.urllib.parse import urljoin
+from ..request import RequestMethods
+from ..response import HTTPResponse
+from ..util.retry import Retry
+from ..util.timeout import Timeout
+from . import _appengine_environ
+
+try:
+    from google.appengine.api import urlfetch
+except ImportError:
+    urlfetch = None
+
+
+log = logging.getLogger(__name__)
+
+
+class AppEnginePlatformWarning(HTTPWarning):
+    pass
+
+
+class AppEnginePlatformError(HTTPError):
+    pass
+
+
+class AppEngineManager(RequestMethods):
+    """
+    Connection manager for Google App Engine sandbox applications.
+
+    This manager uses the URLFetch service directly instead of using the
+    emulated httplib, and is subject to URLFetch limitations as described in
+    the App Engine documentation `here
+    <https://cloud.google.com/appengine/docs/python/urlfetch>`_.
+
+    Notably it will raise an :class:`AppEnginePlatformError` if:
+        * URLFetch is not available.
+        * If you attempt to use this on App Engine Flexible, as full socket
+          support is available.
+        * If a request size is more than 10 megabytes.
+        * If a response size is more than 32 megabytes.
+        * If you use an unsupported request method such as OPTIONS.
+
+    Beyond those cases, it will raise normal urllib3 errors.
+    """
+
+    def __init__(
+        self,
+        headers=None,
+        retries=None,
+        validate_certificate=True,
+        urlfetch_retries=True,
+    ):
+        if not urlfetch:
+            raise AppEnginePlatformError(
+                "URLFetch is not available in this environment."
+            )
+
+        warnings.warn(
+            "urllib3 is using URLFetch on Google App Engine sandbox instead "
+            "of sockets. To use sockets directly instead of URLFetch see "
+            "https://urllib3.readthedocs.io/en/1.26.x/reference/urllib3.contrib.html.",
+            AppEnginePlatformWarning,
+        )
+
+        RequestMethods.__init__(self, headers)
+        self.validate_certificate = validate_certificate
+        self.urlfetch_retries = urlfetch_retries
+
+        self.retries = retries or Retry.DEFAULT
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        # Return False to re-raise any potential exceptions
+        return False
+
+    def urlopen(
+        self,
+        method,
+        url,
+        body=None,
+        headers=None,
+        retries=None,
+        redirect=True,
+        timeout=Timeout.DEFAULT_TIMEOUT,
+        **response_kw
+    ):
+
+        retries = self._get_retries(retries, redirect)
+
+        try:
+            follow_redirects = redirect and retries.redirect != 0 and retries.total
+            response = urlfetch.fetch(
+                url,
+                payload=body,
+                method=method,
+                headers=headers or {},
+                allow_truncated=False,
+                follow_redirects=self.urlfetch_retries and follow_redirects,
+                deadline=self._get_absolute_timeout(timeout),
+                validate_certificate=self.validate_certificate,
+            )
+        except urlfetch.DeadlineExceededError as e:
+            raise TimeoutError(self, e)
+
+        except urlfetch.InvalidURLError as e:
+            if "too large" in str(e):
+                raise AppEnginePlatformError(
+                    "URLFetch request too large, URLFetch only "
+                    "supports requests up to 10mb in size.",
+                    e,
+                )
+            raise ProtocolError(e)
+
+        except urlfetch.DownloadError as e:
+            if "Too many redirects" in str(e):
+                raise MaxRetryError(self, url, reason=e)
+            raise ProtocolError(e)
+
+        except urlfetch.ResponseTooLargeError as e:
+            raise AppEnginePlatformError(
+                "URLFetch response too large, URLFetch only supports"
+                "responses up to 32mb in size.",
+                e,
+            )
+
+        except urlfetch.SSLCertificateError as e:
+            raise SSLError(e)
+
+        except urlfetch.InvalidMethodError as e:
+            raise AppEnginePlatformError(
+                "URLFetch does not support method: %s" % method, e
+            )
+
+        http_response = self._urlfetch_response_to_http_response(
+            response, retries=retries, **response_kw
+        )
+
+        # Handle redirect?
+        redirect_location = redirect and http_response.get_redirect_location()
+        if redirect_location:
+            # Check for redirect response
+            if self.urlfetch_retries and retries.raise_on_redirect:
+                raise MaxRetryError(self, url, "too many redirects")
+            else:
+                if http_response.status == 303:
+                    method = "GET"
+
+                try:
+                    retries = retries.increment(
+                        method, url, response=http_response, _pool=self
+                    )
+                except MaxRetryError:
+                    if retries.raise_on_redirect:
+                        raise MaxRetryError(self, url, "too many redirects")
+                    return http_response
+
+                retries.sleep_for_retry(http_response)
+                log.debug("Redirecting %s -> %s", url, redirect_location)
+                redirect_url = urljoin(url, redirect_location)
+                return self.urlopen(
+                    method,
+                    redirect_url,
+                    body,
+                    headers,
+                    retries=retries,
+                    redirect=redirect,
+                    timeout=timeout,
+                    **response_kw
+                )
+
+        # Check if we should retry the HTTP response.
+        has_retry_after = bool(http_response.headers.get("Retry-After"))
+        if retries.is_retry(method, http_response.status, has_retry_after):
+            retries = retries.increment(method, url, response=http_response, _pool=self)
+            log.debug("Retry: %s", url)
+            retries.sleep(http_response)
+            return self.urlopen(
+                method,
+                url,
+                body=body,
+                headers=headers,
+                retries=retries,
+                redirect=redirect,
+                timeout=timeout,
+                **response_kw
+            )
+
+        return http_response
+
+    def _urlfetch_response_to_http_response(self, urlfetch_resp, **response_kw):
+
+        if is_prod_appengine():
+            # Production GAE handles deflate encoding automatically, but does
+            # not remove the encoding header.
+            content_encoding = urlfetch_resp.headers.get("content-encoding")
+
+            if content_encoding == "deflate":
+                del urlfetch_resp.headers["content-encoding"]
+
+        transfer_encoding = urlfetch_resp.headers.get("transfer-encoding")
+        # We have a full response's content,
+        # so let's make sure we don't report ourselves as chunked data.
+        if transfer_encoding == "chunked":
+            encodings = transfer_encoding.split(",")
+            encodings.remove("chunked")
+            urlfetch_resp.headers["transfer-encoding"] = ",".join(encodings)
+
+        original_response = HTTPResponse(
+            # In order for decoding to work, we must present the content as
+            # a file-like object.
+            body=io.BytesIO(urlfetch_resp.content),
+            msg=urlfetch_resp.header_msg,
+            headers=urlfetch_resp.headers,
+            status=urlfetch_resp.status_code,
+            **response_kw
+        )
+
+        return HTTPResponse(
+            body=io.BytesIO(urlfetch_resp.content),
+            headers=urlfetch_resp.headers,
+            status=urlfetch_resp.status_code,
+            original_response=original_response,
+            **response_kw
+        )
+
+    def _get_absolute_timeout(self, timeout):
+        if timeout is Timeout.DEFAULT_TIMEOUT:
+            return None  # Defer to URLFetch's default.
+        if isinstance(timeout, Timeout):
+            if timeout._read is not None or timeout._connect is not None:
+                warnings.warn(
+                    "URLFetch does not support granular timeout settings, "
+                    "reverting to total or default URLFetch timeout.",
+                    AppEnginePlatformWarning,
+                )
+            return timeout.total
+        return timeout
+
+    def _get_retries(self, retries, redirect):
+        if not isinstance(retries, Retry):
+            retries = Retry.from_int(retries, redirect=redirect, default=self.retries)
+
+        if retries.connect or retries.read or retries.redirect:
+            warnings.warn(
+                "URLFetch only supports total retries and does not "
+                "recognize connect, read, or redirect retry parameters.",
+                AppEnginePlatformWarning,
+            )
+
+        return retries
+
+
+# Alias methods from _appengine_environ to maintain public API interface.
+
+is_appengine = _appengine_environ.is_appengine
+is_appengine_sandbox = _appengine_environ.is_appengine_sandbox
+is_local_appengine = _appengine_environ.is_local_appengine
+is_prod_appengine = _appengine_environ.is_prod_appengine
+is_prod_appengine_mvms = _appengine_environ.is_prod_appengine_mvms
diff --git a/lib/urllib3/contrib/ntlmpool.py b/lib/urllib3/contrib/ntlmpool.py
new file mode 100644
index 00000000..47166575
--- /dev/null
+++ b/lib/urllib3/contrib/ntlmpool.py
@@ -0,0 +1,130 @@
+"""
+NTLM authenticating pool, contributed by erikcederstran
+
+Issue #10, see: http://code.google.com/p/urllib3/issues/detail?id=10
+"""
+from __future__ import absolute_import
+
+import warnings
+from logging import getLogger
+
+from ntlm import ntlm
+
+from .. import HTTPSConnectionPool
+from ..packages.six.moves.http_client import HTTPSConnection
+
+warnings.warn(
+    "The 'urllib3.contrib.ntlmpool' module is deprecated and will be removed "
+    "in urllib3 v2.0 release, urllib3 is not able to support it properly due "
+    "to reasons listed in issue: https://github.com/urllib3/urllib3/issues/2282. "
+    "If you are a user of this module please comment in the mentioned issue.",
+    DeprecationWarning,
+)
+
+log = getLogger(__name__)
+
+
+class NTLMConnectionPool(HTTPSConnectionPool):
+    """
+    Implements an NTLM authentication version of an urllib3 connection pool
+    """
+
+    scheme = "https"
+
+    def __init__(self, user, pw, authurl, *args, **kwargs):
+        """
+        authurl is a random URL on the server that is protected by NTLM.
+        user is the Windows user, probably in the DOMAIN\\username format.
+        pw is the password for the user.
+        """
+        super(NTLMConnectionPool, self).__init__(*args, **kwargs)
+        self.authurl = authurl
+        self.rawuser = user
+        user_parts = user.split("\\", 1)
+        self.domain = user_parts[0].upper()
+        self.user = user_parts[1]
+        self.pw = pw
+
+    def _new_conn(self):
+        # Performs the NTLM handshake that secures the connection. The socket
+        # must be kept open while requests are performed.
+        self.num_connections += 1
+        log.debug(
+            "Starting NTLM HTTPS connection no. %d: https://%s%s",
+            self.num_connections,
+            self.host,
+            self.authurl,
+        )
+
+        headers = {"Connection": "Keep-Alive"}
+        req_header = "Authorization"
+        resp_header = "www-authenticate"
+
+        conn = HTTPSConnection(host=self.host, port=self.port)
+
+        # Send negotiation message
+        headers[req_header] = "NTLM %s" % ntlm.create_NTLM_NEGOTIATE_MESSAGE(
+            self.rawuser
+        )
+        log.debug("Request headers: %s", headers)
+        conn.request("GET", self.authurl, None, headers)
+        res = conn.getresponse()
+        reshdr = dict(res.headers)
+        log.debug("Response status: %s %s", res.status, res.reason)
+        log.debug("Response headers: %s", reshdr)
+        log.debug("Response data: %s [...]", res.read(100))
+
+        # Remove the reference to the socket, so that it can not be closed by
+        # the response object (we want to keep the socket open)
+        res.fp = None
+
+        # Server should respond with a challenge message
+        auth_header_values = reshdr[resp_header].split(", ")
+        auth_header_value = None
+        for s in auth_header_values:
+            if s[:5] == "NTLM ":
+                auth_header_value = s[5:]
+        if auth_header_value is None:
+            raise Exception(
+                "Unexpected %s response header: %s" % (resp_header, reshdr[resp_header])
+            )
+
+        # Send authentication message
+        ServerChallenge, NegotiateFlags = ntlm.parse_NTLM_CHALLENGE_MESSAGE(
+            auth_header_value
+        )
+        auth_msg = ntlm.create_NTLM_AUTHENTICATE_MESSAGE(
+            ServerChallenge, self.user, self.domain, self.pw, NegotiateFlags
+        )
+        headers[req_header] = "NTLM %s" % auth_msg
+        log.debug("Request headers: %s", headers)
+        conn.request("GET", self.authurl, None, headers)
+        res = conn.getresponse()
+        log.debug("Response status: %s %s", res.status, res.reason)
+        log.debug("Response headers: %s", dict(res.headers))
+        log.debug("Response data: %s [...]", res.read()[:100])
+        if res.status != 200:
+            if res.status == 401:
+                raise Exception("Server rejected request: wrong username or password")
+            raise Exception("Wrong server response: %s %s" % (res.status, res.reason))
+
+        res.fp = None
+        log.debug("Connection established")
+        return conn
+
+    def urlopen(
+        self,
+        method,
+        url,
+        body=None,
+        headers=None,
+        retries=3,
+        redirect=True,
+        assert_same_host=True,
+    ):
+        if headers is None:
+            headers = {}
+        headers["Connection"] = "Keep-Alive"
+        return super(NTLMConnectionPool, self).urlopen(
+            method, url, body, headers, retries, redirect, assert_same_host
+        )
diff --git a/lib/urllib3/contrib/pyopenssl.py b/lib/urllib3/contrib/pyopenssl.py
index 0089cd27..1ed214b1 100644
--- a/lib/urllib3/contrib/pyopenssl.py
+++ b/lib/urllib3/contrib/pyopenssl.py
@@ -1,8 +1,8 @@
 """
-Module for using pyOpenSSL as a TLS backend. This module was relevant before
-the standard library ``ssl`` module supported SNI, but now that we've dropped
-support for Python 2.7 all relevant Python versions support SNI so
-**this module is no longer recommended**.
+TLS with SNI_-support for Python 2. Follow these instructions if you would
+like to verify TLS certificates in Python 2. Note, the default libraries do
+*not* do certificate checking; you need to do additional work to validate
+certificates yourself.
 
 This needs the following packages installed:
 
@@ -10,7 +10,7 @@ This needs the following packages installed:
 * `cryptography`_ (minimum 1.3.4, from pyopenssl)
 * `idna`_ (minimum 2.0, from cryptography)
 
-However, pyOpenSSL depends on cryptography, which depends on idna, so while we
+However, pyopenssl depends on cryptography, which depends on idna, so while we
 use all three directly here we end up having relatively few packages required.
 
 You can install them with the following command:
@@ -33,55 +33,75 @@ like this:
     except ImportError:
         pass
 
+Now you can use :mod:`urllib3` as you normally would, and it will support SNI
+when the required modules are installed.
+
+Activating this module also has the positive side effect of disabling SSL/TLS
+compression in Python 2 (see `CRIME attack`_).
+
+.. _sni: https://en.wikipedia.org/wiki/Server_Name_Indication
+.. _crime attack: https://en.wikipedia.org/wiki/CRIME_(security_exploit)
 .. _pyopenssl: https://www.pyopenssl.org
 .. _cryptography: https://cryptography.io
 .. _idna: https://github.com/kjd/idna
 """
+from __future__ import absolute_import
 
-from __future__ import annotations
-
-import OpenSSL.SSL  # type: ignore[import]
+import OpenSSL.crypto
+import OpenSSL.SSL
 from cryptography import x509
+from cryptography.hazmat.backends.openssl import backend as openssl_backend
 
 try:
-    from cryptography.x509 import UnsupportedExtension  # type: ignore[attr-defined]
+    from cryptography.x509 import UnsupportedExtension
 except ImportError:
     # UnsupportedExtension is gone in cryptography >= 2.1.0
-    class UnsupportedExtension(Exception):  # type: ignore[no-redef]
+    class UnsupportedExtension(Exception):
         pass
 
 
-import logging
-import ssl
-import typing
-import warnings
 from io import BytesIO
-from socket import socket as socket_cls
+from socket import error as SocketError
 from socket import timeout
 
+try:  # Platform-specific: Python 2
+    from socket import _fileobject
+except ImportError:  # Platform-specific: Python 3
+    _fileobject = None
+    from ..packages.backports.makefile import backport_makefile
+
+import logging
+import ssl
+import sys
+import warnings
+
 from .. import util
+from ..packages import six
+from ..util.ssl_ import PROTOCOL_TLS_CLIENT
 
 warnings.warn(
     "'urllib3.contrib.pyopenssl' module is deprecated and will be removed "
-    "in urllib3 v2.1.0. Read more in this issue: "
+    "in a future release of urllib3 2.x. Read more in this issue: "
     "https://github.com/urllib3/urllib3/issues/2680",
     category=DeprecationWarning,
     stacklevel=2,
 )
 
-if typing.TYPE_CHECKING:
-    from OpenSSL.crypto import X509  # type: ignore[import]
-
-
 __all__ = ["inject_into_urllib3", "extract_from_urllib3"]
 
+# SNI always works.
+HAS_SNI = True
+
 # Map from urllib3 to PyOpenSSL compatible parameter-values.
 _openssl_versions = {
-    util.ssl_.PROTOCOL_TLS: OpenSSL.SSL.SSLv23_METHOD,  # type: ignore[attr-defined]
-    util.ssl_.PROTOCOL_TLS_CLIENT: OpenSSL.SSL.SSLv23_METHOD,  # type: ignore[attr-defined]
+    util.PROTOCOL_TLS: OpenSSL.SSL.SSLv23_METHOD,
+    PROTOCOL_TLS_CLIENT: OpenSSL.SSL.SSLv23_METHOD,
     ssl.PROTOCOL_TLSv1: OpenSSL.SSL.TLSv1_METHOD,
 }
 
+if hasattr(ssl, "PROTOCOL_SSLv3") and hasattr(OpenSSL.SSL, "SSLv3_METHOD"):
+    _openssl_versions[ssl.PROTOCOL_SSLv3] = OpenSSL.SSL.SSLv3_METHOD
+
 if hasattr(ssl, "PROTOCOL_TLSv1_1") and hasattr(OpenSSL.SSL, "TLSv1_1_METHOD"):
     _openssl_versions[ssl.PROTOCOL_TLSv1_1] = OpenSSL.SSL.TLSv1_1_METHOD
 
@@ -95,77 +115,43 @@ _stdlib_to_openssl_verify = {
     ssl.CERT_REQUIRED: OpenSSL.SSL.VERIFY_PEER
     + OpenSSL.SSL.VERIFY_FAIL_IF_NO_PEER_CERT,
 }
-_openssl_to_stdlib_verify = {v: k for k, v in _stdlib_to_openssl_verify.items()}
-
-# The SSLvX values are the most likely to be missing in the future
-# but we check them all just to be sure.
-_OP_NO_SSLv2_OR_SSLv3: int = getattr(OpenSSL.SSL, "OP_NO_SSLv2", 0) | getattr(
-    OpenSSL.SSL, "OP_NO_SSLv3", 0
-)
-_OP_NO_TLSv1: int = getattr(OpenSSL.SSL, "OP_NO_TLSv1", 0)
-_OP_NO_TLSv1_1: int = getattr(OpenSSL.SSL, "OP_NO_TLSv1_1", 0)
-_OP_NO_TLSv1_2: int = getattr(OpenSSL.SSL, "OP_NO_TLSv1_2", 0)
-_OP_NO_TLSv1_3: int = getattr(OpenSSL.SSL, "OP_NO_TLSv1_3", 0)
-
-_openssl_to_ssl_minimum_version: dict[int, int] = {
-    ssl.TLSVersion.MINIMUM_SUPPORTED: _OP_NO_SSLv2_OR_SSLv3,
-    ssl.TLSVersion.TLSv1: _OP_NO_SSLv2_OR_SSLv3,
-    ssl.TLSVersion.TLSv1_1: _OP_NO_SSLv2_OR_SSLv3 | _OP_NO_TLSv1,
-    ssl.TLSVersion.TLSv1_2: _OP_NO_SSLv2_OR_SSLv3 | _OP_NO_TLSv1 | _OP_NO_TLSv1_1,
-    ssl.TLSVersion.TLSv1_3: (
-        _OP_NO_SSLv2_OR_SSLv3 | _OP_NO_TLSv1 | _OP_NO_TLSv1_1 | _OP_NO_TLSv1_2
-    ),
-    ssl.TLSVersion.MAXIMUM_SUPPORTED: (
-        _OP_NO_SSLv2_OR_SSLv3 | _OP_NO_TLSv1 | _OP_NO_TLSv1_1 | _OP_NO_TLSv1_2
-    ),
-}
-_openssl_to_ssl_maximum_version: dict[int, int] = {
-    ssl.TLSVersion.MINIMUM_SUPPORTED: (
-        _OP_NO_SSLv2_OR_SSLv3
-        | _OP_NO_TLSv1
-        | _OP_NO_TLSv1_1
-        | _OP_NO_TLSv1_2
-        | _OP_NO_TLSv1_3
-    ),
-    ssl.TLSVersion.TLSv1: (
-        _OP_NO_SSLv2_OR_SSLv3 | _OP_NO_TLSv1_1 | _OP_NO_TLSv1_2 | _OP_NO_TLSv1_3
-    ),
-    ssl.TLSVersion.TLSv1_1: _OP_NO_SSLv2_OR_SSLv3 | _OP_NO_TLSv1_2 | _OP_NO_TLSv1_3,
-    ssl.TLSVersion.TLSv1_2: _OP_NO_SSLv2_OR_SSLv3 | _OP_NO_TLSv1_3,
-    ssl.TLSVersion.TLSv1_3: _OP_NO_SSLv2_OR_SSLv3,
-    ssl.TLSVersion.MAXIMUM_SUPPORTED: _OP_NO_SSLv2_OR_SSLv3,
-}
+_openssl_to_stdlib_verify = dict((v, k) for k, v in _stdlib_to_openssl_verify.items())
 
 # OpenSSL will only write 16K at a time
 SSL_WRITE_BLOCKSIZE = 16384
 
+orig_util_HAS_SNI = util.HAS_SNI
 orig_util_SSLContext = util.ssl_.SSLContext
 
 
 log = logging.getLogger(__name__)
 
 
-def inject_into_urllib3() -> None:
+def inject_into_urllib3():
     "Monkey-patch urllib3 with PyOpenSSL-backed SSL-support."
 
     _validate_dependencies_met()
 
-    util.SSLContext = PyOpenSSLContext  # type: ignore[assignment]
-    util.ssl_.SSLContext = PyOpenSSLContext  # type: ignore[assignment]
+    util.SSLContext = PyOpenSSLContext
+    util.ssl_.SSLContext = PyOpenSSLContext
+    util.HAS_SNI = HAS_SNI
+    util.ssl_.HAS_SNI = HAS_SNI
     util.IS_PYOPENSSL = True
     util.ssl_.IS_PYOPENSSL = True
 
 
-def extract_from_urllib3() -> None:
+def extract_from_urllib3():
     "Undo monkey-patching by :func:`inject_into_urllib3`."
 
     util.SSLContext = orig_util_SSLContext
     util.ssl_.SSLContext = orig_util_SSLContext
+    util.HAS_SNI = orig_util_HAS_SNI
+    util.ssl_.HAS_SNI = orig_util_HAS_SNI
     util.IS_PYOPENSSL = False
     util.ssl_.IS_PYOPENSSL = False
 
 
-def _validate_dependencies_met() -> None:
+def _validate_dependencies_met():
     """
     Verifies that PyOpenSSL's package-level dependencies have been met.
     Throws `ImportError` if they are not met.
@@ -191,7 +177,7 @@ def _validate_dependencies_met() -> None:
         )
 
 
-def _dnsname_to_stdlib(name: str) -> str | None:
+def _dnsname_to_stdlib(name):
     """
     Converts a dNSName SubjectAlternativeName field to the form used by the
     standard library on the given Python version.
@@ -205,7 +191,7 @@ def _dnsname_to_stdlib(name: str) -> str | None:
     the name given should be skipped.
     """
 
-    def idna_encode(name: str) -> bytes | None:
+    def idna_encode(name):
         """
         Borrowed wholesale from the Python Cryptography Project. It turns out
         that we can't just safely call `idna.encode`: it can explode for
@@ -214,7 +200,7 @@ def _dnsname_to_stdlib(name: str) -> str | None:
         import idna
 
         try:
-            for prefix in ["*.", "."]:
+            for prefix in [u"*.", u"."]:
                 if name.startswith(prefix):
                     name = name[len(prefix) :]
                     return prefix.encode("ascii") + idna.encode(name)
@@ -226,17 +212,24 @@ def _dnsname_to_stdlib(name: str) -> str | None:
     if ":" in name:
         return name
 
-    encoded_name = idna_encode(name)
-    if encoded_name is None:
+    name = idna_encode(name)
+    if name is None:
         return None
-    return encoded_name.decode("utf-8")
+    elif sys.version_info >= (3, 0):
+        name = name.decode("utf-8")
+    return name
 
 
-def get_subj_alt_name(peer_cert: X509) -> list[tuple[str, str]]:
+def get_subj_alt_name(peer_cert):
     """
     Given an PyOpenSSL certificate, provides all the subject alternative names.
     """
-    cert = peer_cert.to_cryptography()
+    # Pass the cert to cryptography, which has much better APIs for this.
+    if hasattr(peer_cert, "to_cryptography"):
+        cert = peer_cert.to_cryptography()
+    else:
+        der = OpenSSL.crypto.dump_certificate(OpenSSL.crypto.FILETYPE_ASN1, peer_cert)
+        cert = x509.load_der_x509_certificate(der, openssl_backend)
 
     # We want to find the SAN extension. Ask Cryptography to locate it (it's
     # faster than looping in Python)
@@ -280,94 +273,93 @@ def get_subj_alt_name(peer_cert: X509) -> list[tuple[str, str]]:
     return names
 
 
-class WrappedSocket:
-    """API-compatibility wrapper for Python OpenSSL's Connection-class."""
+class WrappedSocket(object):
+    """API-compatibility wrapper for Python OpenSSL's Connection-class.
 
-    def __init__(
-        self,
-        connection: OpenSSL.SSL.Connection,
-        socket: socket_cls,
-        suppress_ragged_eofs: bool = True,
-    ) -> None:
+    Note: _makefile_refs, _drop() and _reuse() are needed for the garbage
+    collector of pypy.
+    """
+
+    def __init__(self, connection, socket, suppress_ragged_eofs=True):
         self.connection = connection
         self.socket = socket
         self.suppress_ragged_eofs = suppress_ragged_eofs
-        self._io_refs = 0
+        self._makefile_refs = 0
         self._closed = False
 
-    def fileno(self) -> int:
+    def fileno(self):
         return self.socket.fileno()
 
     # Copy-pasted from Python 3.5 source code
-    def _decref_socketios(self) -> None:
-        if self._io_refs > 0:
-            self._io_refs -= 1
+    def _decref_socketios(self):
+        if self._makefile_refs > 0:
+            self._makefile_refs -= 1
         if self._closed:
             self.close()
 
-    def recv(self, *args: typing.Any, **kwargs: typing.Any) -> bytes:
+    def recv(self, *args, **kwargs):
         try:
             data = self.connection.recv(*args, **kwargs)
         except OpenSSL.SSL.SysCallError as e:
             if self.suppress_ragged_eofs and e.args == (-1, "Unexpected EOF"):
                 return b""
             else:
-                raise OSError(e.args[0], str(e)) from e
+                raise SocketError(str(e))
         except OpenSSL.SSL.ZeroReturnError:
             if self.connection.get_shutdown() == OpenSSL.SSL.RECEIVED_SHUTDOWN:
                 return b""
             else:
                 raise
-        except OpenSSL.SSL.WantReadError as e:
+        except OpenSSL.SSL.WantReadError:
             if not util.wait_for_read(self.socket, self.socket.gettimeout()):
-                raise timeout("The read operation timed out") from e
+                raise timeout("The read operation timed out")
             else:
                 return self.recv(*args, **kwargs)
 
         # TLS 1.3 post-handshake authentication
         except OpenSSL.SSL.Error as e:
-            raise ssl.SSLError(f"read error: {e!r}") from e
+            raise ssl.SSLError("read error: %r" % e)
         else:
-            return data  # type: ignore[no-any-return]
+            return data
 
-    def recv_into(self, *args: typing.Any, **kwargs: typing.Any) -> int:
+    def recv_into(self, *args, **kwargs):
         try:
-            return self.connection.recv_into(*args, **kwargs)  # type: ignore[no-any-return]
+            return self.connection.recv_into(*args, **kwargs)
         except OpenSSL.SSL.SysCallError as e:
             if self.suppress_ragged_eofs and e.args == (-1, "Unexpected EOF"):
                 return 0
             else:
-                raise OSError(e.args[0], str(e)) from e
+                raise SocketError(str(e))
         except OpenSSL.SSL.ZeroReturnError:
             if self.connection.get_shutdown() == OpenSSL.SSL.RECEIVED_SHUTDOWN:
                 return 0
             else:
                 raise
-        except OpenSSL.SSL.WantReadError as e:
+        except OpenSSL.SSL.WantReadError:
             if not util.wait_for_read(self.socket, self.socket.gettimeout()):
-                raise timeout("The read operation timed out") from e
+                raise timeout("The read operation timed out")
             else:
                 return self.recv_into(*args, **kwargs)
 
         # TLS 1.3 post-handshake authentication
         except OpenSSL.SSL.Error as e:
-            raise ssl.SSLError(f"read error: {e!r}") from e
+            raise ssl.SSLError("read error: %r" % e)
 
-    def settimeout(self, timeout: float) -> None:
+    def settimeout(self, timeout):
         return self.socket.settimeout(timeout)
 
-    def _send_until_done(self, data: bytes) -> int:
+    def _send_until_done(self, data):
         while True:
             try:
-                return self.connection.send(data)  # type: ignore[no-any-return]
-            except OpenSSL.SSL.WantWriteError as e:
+                return self.connection.send(data)
+            except OpenSSL.SSL.WantWriteError:
                 if not util.wait_for_write(self.socket, self.socket.gettimeout()):
-                    raise timeout() from e
+                    raise timeout()
                 continue
             except OpenSSL.SSL.SysCallError as e:
-                raise OSError(e.args[0], str(e)) from e
+                raise SocketError(str(e))
 
-    def sendall(self, data: bytes) -> None:
+    def sendall(self, data):
         total_sent = 0
         while total_sent < len(data):
             sent = self._send_until_done(
@@ -375,135 +367,135 @@ class WrappedSocket:
             )
             total_sent += sent
 
-    def shutdown(self) -> None:
+    def shutdown(self):
         # FIXME rethrow compatible exceptions should we ever use this
         self.connection.shutdown()
 
-    def close(self) -> None:
-        self._closed = True
-        if self._io_refs <= 0:
-            self._real_close()
+    def close(self):
+        if self._makefile_refs < 1:
+            try:
+                self._closed = True
+                return self.connection.close()
+            except OpenSSL.SSL.Error:
+                return
+        else:
+            self._makefile_refs -= 1
 
-    def _real_close(self) -> None:
-        try:
-            return self.connection.close()  # type: ignore[no-any-return]
-        except OpenSSL.SSL.Error:
-            return
-
-    def getpeercert(
-        self, binary_form: bool = False
-    ) -> dict[str, list[typing.Any]] | None:
+    def getpeercert(self, binary_form=False):
         x509 = self.connection.get_peer_certificate()
 
         if not x509:
-            return x509  # type: ignore[no-any-return]
+            return x509
 
         if binary_form:
-            return OpenSSL.crypto.dump_certificate(OpenSSL.crypto.FILETYPE_ASN1, x509)  # type: ignore[no-any-return]
+            return OpenSSL.crypto.dump_certificate(OpenSSL.crypto.FILETYPE_ASN1, x509)
 
         return {
-            "subject": ((("commonName", x509.get_subject().CN),),),  # type: ignore[dict-item]
+            "subject": ((("commonName", x509.get_subject().CN),),),
             "subjectAltName": get_subj_alt_name(x509),
         }
 
-    def version(self) -> str:
-        return self.connection.get_protocol_version_name()  # type: ignore[no-any-return]
+    def version(self):
+        return self.connection.get_protocol_version_name()
+
+    def _reuse(self):
+        self._makefile_refs += 1
+
+    def _drop(self):
+        if self._makefile_refs < 1:
+            self.close()
+        else:
+            self._makefile_refs -= 1
 
 
-WrappedSocket.makefile = socket_cls.makefile  # type: ignore[attr-defined]
+if _fileobject:  # Platform-specific: Python 2
+
+    def makefile(self, mode, bufsize=-1):
+        self._makefile_refs += 1
+        return _fileobject(self, mode, bufsize, close=True)
+
+else:  # Platform-specific: Python 3
+    makefile = backport_makefile
+
+WrappedSocket.makefile = makefile
 
 
-class PyOpenSSLContext:
+class PyOpenSSLContext(object):
     """
     I am a wrapper class for the PyOpenSSL ``Context`` object. I am responsible
     for translating the interface of the standard library ``SSLContext`` object
     to calls into PyOpenSSL.
     """
 
-    def __init__(self, protocol: int) -> None:
+    def __init__(self, protocol):
         self.protocol = _openssl_versions[protocol]
         self._ctx = OpenSSL.SSL.Context(self.protocol)
         self._options = 0
         self.check_hostname = False
-        self._minimum_version: int = ssl.TLSVersion.MINIMUM_SUPPORTED
-        self._maximum_version: int = ssl.TLSVersion.MAXIMUM_SUPPORTED
 
     @property
-    def options(self) -> int:
+    def options(self):
         return self._options
 
     @options.setter
-    def options(self, value: int) -> None:
+    def options(self, value):
         self._options = value
-        self._set_ctx_options()
+        self._ctx.set_options(value)
 
     @property
-    def verify_mode(self) -> int:
+    def verify_mode(self):
         return _openssl_to_stdlib_verify[self._ctx.get_verify_mode()]
 
     @verify_mode.setter
-    def verify_mode(self, value: ssl.VerifyMode) -> None:
+    def verify_mode(self, value):
         self._ctx.set_verify(_stdlib_to_openssl_verify[value], _verify_callback)
 
-    def set_default_verify_paths(self) -> None:
+    def set_default_verify_paths(self):
         self._ctx.set_default_verify_paths()
 
-    def set_ciphers(self, ciphers: bytes | str) -> None:
-        if isinstance(ciphers, str):
+    def set_ciphers(self, ciphers):
+        if isinstance(ciphers, six.text_type):
             ciphers = ciphers.encode("utf-8")
         self._ctx.set_cipher_list(ciphers)
 
-    def load_verify_locations(
-        self,
-        cafile: str | None = None,
-        capath: str | None = None,
-        cadata: bytes | None = None,
-    ) -> None:
+    def load_verify_locations(self, cafile=None, capath=None, cadata=None):
         if cafile is not None:
-            cafile = cafile.encode("utf-8")  # type: ignore[assignment]
+            cafile = cafile.encode("utf-8")
         if capath is not None:
-            capath = capath.encode("utf-8")  # type: ignore[assignment]
+            capath = capath.encode("utf-8")
         try:
             self._ctx.load_verify_locations(cafile, capath)
             if cadata is not None:
                 self._ctx.load_verify_locations(BytesIO(cadata))
         except OpenSSL.SSL.Error as e:
-            raise ssl.SSLError(f"unable to load trusted certificates: {e!r}") from e
+            raise ssl.SSLError("unable to load trusted certificates: %r" % e)
 
-    def load_cert_chain(
-        self,
-        certfile: str,
-        keyfile: str | None = None,
-        password: str | None = None,
-    ) -> None:
-        try:
-            self._ctx.use_certificate_chain_file(certfile)
-            if password is not None:
-                if not isinstance(password, bytes):
-                    password = password.encode("utf-8")  # type: ignore[assignment]
-                self._ctx.set_passwd_cb(lambda *_: password)
-            self._ctx.use_privatekey_file(keyfile or certfile)
-        except OpenSSL.SSL.Error as e:
-            raise ssl.SSLError(f"Unable to load certificate chain: {e!r}") from e
+    def load_cert_chain(self, certfile, keyfile=None, password=None):
+        self._ctx.use_certificate_chain_file(certfile)
+        if password is not None:
+            if not isinstance(password, six.binary_type):
+                password = password.encode("utf-8")
+            self._ctx.set_passwd_cb(lambda *_: password)
+        self._ctx.use_privatekey_file(keyfile or certfile)
 
-    def set_alpn_protocols(self, protocols: list[bytes | str]) -> None:
-        protocols = [util.util.to_bytes(p, "ascii") for p in protocols]
-        return self._ctx.set_alpn_protos(protocols)  # type: ignore[no-any-return]
+    def set_alpn_protocols(self, protocols):
+        protocols = [six.ensure_binary(p) for p in protocols]
+        return self._ctx.set_alpn_protos(protocols)
 
     def wrap_socket(
         self,
-        sock: socket_cls,
-        server_side: bool = False,
-        do_handshake_on_connect: bool = True,
-        suppress_ragged_eofs: bool = True,
-        server_hostname: bytes | str | None = None,
-    ) -> WrappedSocket:
+        sock,
+        server_side=False,
+        do_handshake_on_connect=True,
+        suppress_ragged_eofs=True,
+        server_hostname=None,
+    ):
         cnx = OpenSSL.SSL.Connection(self._ctx, sock)
 
-        # If server_hostname is an IP, don't use it for SNI, per RFC6066 Section 3
-        if server_hostname and not util.ssl_.is_ipaddress(server_hostname):
-            if isinstance(server_hostname, str):
-                server_hostname = server_hostname.encode("utf-8")
+        if isinstance(server_hostname, six.text_type):  # Platform-specific: Python 3
+            server_hostname = server_hostname.encode("utf-8")
+
+        if server_hostname is not None:
             cnx.set_tlsext_host_name(server_hostname)
 
         cnx.set_connect_state()
@@ -511,47 +503,16 @@ class PyOpenSSLContext:
         while True:
             try:
                 cnx.do_handshake()
-            except OpenSSL.SSL.WantReadError as e:
+            except OpenSSL.SSL.WantReadError:
                 if not util.wait_for_read(sock, sock.gettimeout()):
-                    raise timeout("select timed out") from e
+                    raise timeout("select timed out")
                 continue
             except OpenSSL.SSL.Error as e:
-                raise ssl.SSLError(f"bad handshake: {e!r}") from e
+                raise ssl.SSLError("bad handshake: %r" % e)
             break
 
         return WrappedSocket(cnx, sock)
 
-    def _set_ctx_options(self) -> None:
-        self._ctx.set_options(
-            self._options
-            | _openssl_to_ssl_minimum_version[self._minimum_version]
-            | _openssl_to_ssl_maximum_version[self._maximum_version]
-        )
 
-    @property
-    def minimum_version(self) -> int:
-        return self._minimum_version
-
-    @minimum_version.setter
-    def minimum_version(self, minimum_version: int) -> None:
-        self._minimum_version = minimum_version
-        self._set_ctx_options()
-
-    @property
-    def maximum_version(self) -> int:
-        return self._maximum_version
-
-    @maximum_version.setter
-    def maximum_version(self, maximum_version: int) -> None:
-        self._maximum_version = maximum_version
-        self._set_ctx_options()
-
-
-def _verify_callback(
-    cnx: OpenSSL.SSL.Connection,
-    x509: X509,
-    err_no: int,
-    err_depth: int,
-    return_code: int,
-) -> bool:
+def _verify_callback(cnx, x509, err_no, err_depth, return_code):
     return err_no == 0
diff --git a/lib/urllib3/contrib/securetransport.py b/lib/urllib3/contrib/securetransport.py
index 11beb3df..6c46a3b9 100644
--- a/lib/urllib3/contrib/securetransport.py
+++ b/lib/urllib3/contrib/securetransport.py
@@ -51,8 +51,7 @@ license and by oscrypto's:
     FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
     DEALINGS IN THE SOFTWARE.
 """
-
-from __future__ import annotations
+from __future__ import absolute_import
 
 import contextlib
 import ctypes
@@ -63,18 +62,14 @@ import socket
 import ssl
 import struct
 import threading
-import typing
-import warnings
 import weakref
-from socket import socket as socket_cls
+
+import six
 
 from .. import util
-from ._securetransport.bindings import (  # type: ignore[attr-defined]
-    CoreFoundation,
-    Security,
-)
+from ..util.ssl_ import PROTOCOL_TLS_CLIENT
+from ._securetransport.bindings import CoreFoundation, Security, SecurityConst
 from ._securetransport.low_level import (
-    SecurityConst,
     _assert_no_error,
     _build_tls_unknown_ca_alert,
     _cert_array_from_pem,
@@ -83,19 +78,18 @@ from ._securetransport.low_level import (
     _temporary_keychain,
 )
 
-warnings.warn(
-    "'urllib3.contrib.securetransport' module is deprecated and will be removed "
-    "in urllib3 v2.1.0. Read more in this issue: "
-    "https://github.com/urllib3/urllib3/issues/2681",
-    category=DeprecationWarning,
-    stacklevel=2,
-)
-
-if typing.TYPE_CHECKING:
-    from typing_extensions import Literal
+try:  # Platform-specific: Python 2
+    from socket import _fileobject
+except ImportError:  # Platform-specific: Python 3
+    _fileobject = None
+    from ..packages.backports.makefile import backport_makefile
 
 __all__ = ["inject_into_urllib3", "extract_from_urllib3"]
 
+# SNI always works
+HAS_SNI = True
+
+orig_util_HAS_SNI = util.HAS_SNI
 orig_util_SSLContext = util.ssl_.SSLContext
 
 # This dictionary is used by the read callback to obtain a handle to the
@@ -114,24 +108,55 @@ orig_util_SSLContext = util.ssl_.SSLContext
 #
 # This is good: if we had to lock in the callbacks we'd drastically slow down
 # the performance of this code.
-_connection_refs: weakref.WeakValueDictionary[
-    int, WrappedSocket
-] = weakref.WeakValueDictionary()
+_connection_refs = weakref.WeakValueDictionary()
 _connection_ref_lock = threading.Lock()
 
 # Limit writes to 16kB. This is OpenSSL's limit, but we'll cargo-cult it over
 # for no better reason than we need *a* limit, and this one is right there.
 SSL_WRITE_BLOCKSIZE = 16384
 
+# This is our equivalent of util.ssl_.DEFAULT_CIPHERS, but expanded out to
+# individual cipher suites. We need to do this because this is how
+# SecureTransport wants them.
+CIPHER_SUITES = [
+    SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384,
+    SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256,
+    SecurityConst.TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384,
+    SecurityConst.TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256,
+    SecurityConst.TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256,
+    SecurityConst.TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256,
+    SecurityConst.TLS_DHE_RSA_WITH_AES_256_GCM_SHA384,
+    SecurityConst.TLS_DHE_RSA_WITH_AES_128_GCM_SHA256,
+    SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384,
+    SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA,
+    SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256,
+    SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA,
+    SecurityConst.TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384,
+    SecurityConst.TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA,
+    SecurityConst.TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256,
+    SecurityConst.TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA,
+    SecurityConst.TLS_DHE_RSA_WITH_AES_256_CBC_SHA256,
+    SecurityConst.TLS_DHE_RSA_WITH_AES_256_CBC_SHA,
+    SecurityConst.TLS_DHE_RSA_WITH_AES_128_CBC_SHA256,
+    SecurityConst.TLS_DHE_RSA_WITH_AES_128_CBC_SHA,
+    SecurityConst.TLS_AES_256_GCM_SHA384,
+    SecurityConst.TLS_AES_128_GCM_SHA256,
+    SecurityConst.TLS_RSA_WITH_AES_256_GCM_SHA384,
+    SecurityConst.TLS_RSA_WITH_AES_128_GCM_SHA256,
+    SecurityConst.TLS_AES_128_CCM_8_SHA256,
+    SecurityConst.TLS_AES_128_CCM_SHA256,
+    SecurityConst.TLS_RSA_WITH_AES_256_CBC_SHA256,
+    SecurityConst.TLS_RSA_WITH_AES_128_CBC_SHA256,
+    SecurityConst.TLS_RSA_WITH_AES_256_CBC_SHA,
+    SecurityConst.TLS_RSA_WITH_AES_128_CBC_SHA,
+]
+
 # Basically this is simple: for PROTOCOL_SSLv23 we turn it into a low of
 # TLSv1 and a high of TLSv1.2. For everything else, we pin to that version.
 # TLSv1 to 1.2 are supported on macOS 10.8+
 _protocol_to_min_max = {
-    util.ssl_.PROTOCOL_TLS: (SecurityConst.kTLSProtocol1, SecurityConst.kTLSProtocol12),  # type: ignore[attr-defined]
-    util.ssl_.PROTOCOL_TLS_CLIENT: (  # type: ignore[attr-defined]
-        SecurityConst.kTLSProtocol1,
-        SecurityConst.kTLSProtocol12,
-    ),
+    util.PROTOCOL_TLS: (SecurityConst.kTLSProtocol1, SecurityConst.kTLSProtocol12),
+    PROTOCOL_TLS_CLIENT: (SecurityConst.kTLSProtocol1, SecurityConst.kTLSProtocol12),
 }
 
 if hasattr(ssl, "PROTOCOL_SSLv2"):
@@ -161,38 +186,31 @@ if hasattr(ssl, "PROTOCOL_TLSv1_2"):
     )
 
 
-_tls_version_to_st: dict[int, int] = {
-    ssl.TLSVersion.MINIMUM_SUPPORTED: SecurityConst.kTLSProtocol1,
-    ssl.TLSVersion.TLSv1: SecurityConst.kTLSProtocol1,
-    ssl.TLSVersion.TLSv1_1: SecurityConst.kTLSProtocol11,
-    ssl.TLSVersion.TLSv1_2: SecurityConst.kTLSProtocol12,
-    ssl.TLSVersion.MAXIMUM_SUPPORTED: SecurityConst.kTLSProtocol12,
-}
-
-
-def inject_into_urllib3() -> None:
+def inject_into_urllib3():
     """
     Monkey-patch urllib3 with SecureTransport-backed SSL-support.
     """
-    util.SSLContext = SecureTransportContext  # type: ignore[assignment]
-    util.ssl_.SSLContext = SecureTransportContext  # type: ignore[assignment]
+    util.SSLContext = SecureTransportContext
+    util.ssl_.SSLContext = SecureTransportContext
+    util.HAS_SNI = HAS_SNI
+    util.ssl_.HAS_SNI = HAS_SNI
     util.IS_SECURETRANSPORT = True
     util.ssl_.IS_SECURETRANSPORT = True
 
 
-def extract_from_urllib3() -> None:
+def extract_from_urllib3():
     """
     Undo monkey-patching by :func:`inject_into_urllib3`.
     """
     util.SSLContext = orig_util_SSLContext
     util.ssl_.SSLContext = orig_util_SSLContext
+    util.HAS_SNI = orig_util_HAS_SNI
+    util.ssl_.HAS_SNI = orig_util_HAS_SNI
     util.IS_SECURETRANSPORT = False
     util.ssl_.IS_SECURETRANSPORT = False
 
 
-def _read_callback(
-    connection_id: int, data_buffer: int, data_length_pointer: bytearray
-) -> int:
+def _read_callback(connection_id, data_buffer, data_length_pointer):
     """
     SecureTransport read callback. This is called by ST to request that data
     be returned from the socket.
@@ -214,7 +232,7 @@ def _read_callback(
             while read_count < requested_length:
                 if timeout is None or timeout >= 0:
                     if not util.wait_for_read(base_socket, timeout):
-                        raise OSError(errno.EAGAIN, "timed out")
+                        raise socket.error(errno.EAGAIN, "timed out")
 
                 remaining = requested_length - read_count
                 buffer = (ctypes.c_char * remaining).from_address(
@@ -226,7 +244,7 @@ def _read_callback(
                     if not read_count:
                         return SecurityConst.errSSLClosedGraceful
                     break
-        except OSError as e:
+        except (socket.error) as e:
             error = e.errno
 
             if error is not None and error != errno.EAGAIN:
@@ -247,9 +265,7 @@ def _read_callback(
         return SecurityConst.errSSLInternal
 
 
-def _write_callback(
-    connection_id: int, data_buffer: int, data_length_pointer: bytearray
-) -> int:
+def _write_callback(connection_id, data_buffer, data_length_pointer):
     """
     SecureTransport write callback. This is called by ST to request that data
     actually be sent on the network.
@@ -272,14 +288,14 @@ def _write_callback(
             while sent < bytes_to_write:
                 if timeout is None or timeout >= 0:
                     if not util.wait_for_write(base_socket, timeout):
-                        raise OSError(errno.EAGAIN, "timed out")
+                        raise socket.error(errno.EAGAIN, "timed out")
                 chunk_sent = base_socket.send(data)
                 sent += chunk_sent
 
                 # This has some needless copying here, but I'm not sure there's
                 # much value in optimising this data path.
                 data = data[chunk_sent:]
-        except OSError as e:
+        except (socket.error) as e:
             error = e.errno
 
             if error is not None and error != errno.EAGAIN:
@@ -307,20 +323,22 @@ _read_callback_pointer = Security.SSLReadFunc(_read_callback)
 _write_callback_pointer = Security.SSLWriteFunc(_write_callback)
 
 
-class WrappedSocket:
+class WrappedSocket(object):
     """
     API-compatibility wrapper for Python's OpenSSL wrapped socket object.
+
+    Note: _makefile_refs, _drop(), and _reuse() are needed for the garbage
+    collector of PyPy.
     """
 
-    def __init__(self, socket: socket_cls) -> None:
+    def __init__(self, socket):
         self.socket = socket
         self.context = None
-        self._io_refs = 0
+        self._makefile_refs = 0
         self._closed = False
-        self._real_closed = False
-        self._exception: Exception | None = None
+        self._exception = None
         self._keychain = None
-        self._keychain_dir: str | None = None
+        self._keychain_dir = None
         self._client_cert_chain = None
 
         # We save off the previously-configured timeout and then set it to
@@ -332,7 +350,7 @@ class WrappedSocket:
         self.socket.settimeout(0)
 
     @contextlib.contextmanager
-    def _raise_on_error(self) -> typing.Generator[None, None, None]:
+    def _raise_on_error(self):
         """
         A context manager that can be used to wrap calls that do I/O from
         SecureTransport. If any of the I/O callbacks hit an exception, this
@@ -349,10 +367,23 @@ class WrappedSocket:
         yield
         if self._exception is not None:
             exception, self._exception = self._exception, None
-            self._real_close()
+            self.close()
             raise exception
 
-    def _set_alpn_protocols(self, protocols: list[bytes] | None) -> None:
+    def _set_ciphers(self):
+        """
+        Sets up the allowed ciphers. By default this matches the set in
+        util.ssl_.DEFAULT_CIPHERS, at least as supported by macOS. This is done
+        custom and doesn't allow changing at this time, mostly because parsing
+        OpenSSL cipher strings is going to be a freaking nightmare.
+        """
+        ciphers = (Security.SSLCipherSuite * len(CIPHER_SUITES))(*CIPHER_SUITES)
+        result = Security.SSLSetEnabledCiphers(
+            self.context, ciphers, len(CIPHER_SUITES)
+        )
+        _assert_no_error(result)
+
+    def _set_alpn_protocols(self, protocols):
         """
         Sets up the ALPN protocols on the context.
         """
@@ -365,7 +396,7 @@ class WrappedSocket:
         finally:
             CoreFoundation.CFRelease(protocols_arr)
 
-    def _custom_validate(self, verify: bool, trust_bundle: bytes | None) -> None:
+    def _custom_validate(self, verify, trust_bundle):
         """
         Called when we have set custom validation. We do this in two cases:
         first, when cert validation is entirely disabled; and second, when
@@ -373,7 +404,7 @@ class WrappedSocket:
         Raises an SSLError if the connection is not trusted.
         """
         # If we disabled cert validation, just say: cool.
-        if not verify or trust_bundle is None:
+        if not verify:
             return
 
         successes = (
@@ -384,12 +415,10 @@ class WrappedSocket:
             trust_result = self._evaluate_trust(trust_bundle)
             if trust_result in successes:
                 return
-            reason = f"error code: {int(trust_result)}"
-            exc = None
+            reason = "error code: %d" % (trust_result,)
         except Exception as e:
             # Do not trust on error
-            reason = f"exception: {e!r}"
-            exc = e
+            reason = "exception: %r" % (e,)
 
         # SecureTransport does not send an alert nor shuts down the connection.
         rec = _build_tls_unknown_ca_alert(self.version())
@@ -399,10 +428,10 @@ class WrappedSocket:
         # l_linger = 0, linger for 0 seoncds
         opts = struct.pack("ii", 1, 0)
         self.socket.setsockopt(socket.SOL_SOCKET, socket.SO_LINGER, opts)
-        self._real_close()
-        raise ssl.SSLError(f"certificate verify failed, {reason}") from exc
+        self.close()
+        raise ssl.SSLError("certificate verify failed, %s" % reason)
 
-    def _evaluate_trust(self, trust_bundle: bytes) -> int:
+    def _evaluate_trust(self, trust_bundle):
         # We want data in memory, so load it up.
         if os.path.isfile(trust_bundle):
             with open(trust_bundle, "rb") as f:
@@ -440,20 +469,20 @@ class WrappedSocket:
             if cert_array is not None:
                 CoreFoundation.CFRelease(cert_array)
 
-        return trust_result.value  # type: ignore[no-any-return]
+        return trust_result.value
 
     def handshake(
         self,
-        server_hostname: bytes | str | None,
-        verify: bool,
-        trust_bundle: bytes | None,
-        min_version: int,
-        max_version: int,
-        client_cert: str | None,
-        client_key: str | None,
-        client_key_passphrase: typing.Any,
-        alpn_protocols: list[bytes] | None,
-    ) -> None:
+        server_hostname,
+        verify,
+        trust_bundle,
+        min_version,
+        max_version,
+        client_cert,
+        client_key,
+        client_key_passphrase,
+        alpn_protocols,
+    ):
         """
         Actually performs the TLS handshake. This is run automatically by
         wrapped socket, and shouldn't be needed in user code.
@@ -481,8 +510,6 @@ class WrappedSocket:
         _assert_no_error(result)
 
         # If we have a server hostname, we should set that too.
-        # RFC6066 Section 3 tells us not to use SNI when the host is an IP, but we have
-        # to do it anyway to match server_hostname against the server certificate
         if server_hostname:
             if not isinstance(server_hostname, bytes):
                 server_hostname = server_hostname.encode("utf-8")
@@ -492,6 +519,9 @@ class WrappedSocket:
             )
             _assert_no_error(result)
 
+        # Setup the ciphers.
+        self._set_ciphers()
+
         # Setup the ALPN protocols.
         self._set_alpn_protocols(alpn_protocols)
 
@@ -534,27 +564,25 @@ class WrappedSocket:
                     _assert_no_error(result)
                     break
 
-    def fileno(self) -> int:
+    def fileno(self):
         return self.socket.fileno()
 
     # Copy-pasted from Python 3.5 source code
-    def _decref_socketios(self) -> None:
-        if self._io_refs > 0:
-            self._io_refs -= 1
+    def _decref_socketios(self):
+        if self._makefile_refs > 0:
+            self._makefile_refs -= 1
         if self._closed:
             self.close()
 
-    def recv(self, bufsiz: int) -> bytes:
+    def recv(self, bufsiz):
         buffer = ctypes.create_string_buffer(bufsiz)
         bytes_read = self.recv_into(buffer, bufsiz)
         data = buffer[:bytes_read]
-        return typing.cast(bytes, data)
+        return data
 
-    def recv_into(
-        self, buffer: ctypes.Array[ctypes.c_char], nbytes: int | None = None
-    ) -> int:
+    def recv_into(self, buffer, nbytes=None):
         # Read short on EOF.
-        if self._real_closed:
+        if self._closed:
             return 0
 
         if nbytes is None:
@@ -587,7 +615,7 @@ class WrappedSocket:
             # well. Note that we don't actually return here because in
             # principle this could actually be fired along with return data.
             # It's unlikely though.
-            self._real_close()
+            self.close()
         else:
             _assert_no_error(result)
 
@@ -595,13 +623,13 @@ class WrappedSocket:
         # was actually read.
         return processed_bytes.value
 
-    def settimeout(self, timeout: float) -> None:
+    def settimeout(self, timeout):
         self._timeout = timeout
 
-    def gettimeout(self) -> float | None:
+    def gettimeout(self):
         return self._timeout
 
-    def send(self, data: bytes) -> int:
+    def send(self, data):
         processed_bytes = ctypes.c_size_t(0)
 
         with self._raise_on_error():
@@ -618,38 +646,36 @@ class WrappedSocket:
         # We sent, and probably succeeded. Tell them how much we sent.
         return processed_bytes.value
 
-    def sendall(self, data: bytes) -> None:
+    def sendall(self, data):
         total_sent = 0
         while total_sent < len(data):
             sent = self.send(data[total_sent : total_sent + SSL_WRITE_BLOCKSIZE])
             total_sent += sent
 
-    def shutdown(self) -> None:
+    def shutdown(self):
         with self._raise_on_error():
             Security.SSLClose(self.context)
 
-    def close(self) -> None:
-        self._closed = True
+    def close(self):
         # TODO: should I do clean shutdown here? Do I have to?
-        if self._io_refs <= 0:
-            self._real_close()
+        if self._makefile_refs < 1:
+            self._closed = True
+            if self.context:
+                CoreFoundation.CFRelease(self.context)
+                self.context = None
+            if self._client_cert_chain:
+                CoreFoundation.CFRelease(self._client_cert_chain)
+                self._client_cert_chain = None
+            if self._keychain:
+                Security.SecKeychainDelete(self._keychain)
+                CoreFoundation.CFRelease(self._keychain)
+                shutil.rmtree(self._keychain_dir)
+                self._keychain = self._keychain_dir = None
+            return self.socket.close()
+        else:
+            self._makefile_refs -= 1
 
-    def _real_close(self) -> None:
-        self._real_closed = True
-        if self.context:
-            CoreFoundation.CFRelease(self.context)
-            self.context = None
-        if self._client_cert_chain:
-            CoreFoundation.CFRelease(self._client_cert_chain)
-            self._client_cert_chain = None
-        if self._keychain:
-            Security.SecKeychainDelete(self._keychain)
-            CoreFoundation.CFRelease(self._keychain)
-            shutil.rmtree(self._keychain_dir)
-            self._keychain = self._keychain_dir = None
-        return self.socket.close()
-
-    def getpeercert(self, binary_form: bool = False) -> bytes | None:
+    def getpeercert(self, binary_form=False):
         # Urgh, annoying.
         #
         # Here's how we do this:
@@ -707,7 +733,7 @@ class WrappedSocket:
 
         return der_bytes
 
-    def version(self) -> str:
+    def version(self):
         protocol = Security.SSLProtocol()
         result = Security.SSLGetNegotiatedProtocolVersion(
             self.context, ctypes.byref(protocol)
@@ -726,50 +752,55 @@ class WrappedSocket:
         elif protocol.value == SecurityConst.kSSLProtocol2:
             return "SSLv2"
         else:
-            raise ssl.SSLError(f"Unknown TLS version: {protocol!r}")
+            raise ssl.SSLError("Unknown TLS version: %r" % protocol)
+
+    def _reuse(self):
+        self._makefile_refs += 1
+
+    def _drop(self):
+        if self._makefile_refs < 1:
+            self.close()
+        else:
+            self._makefile_refs -= 1
 
 
-def makefile(
-    self: socket_cls,
-    mode: (
-        Literal["r"] | Literal["w"] | Literal["rw"] | Literal["wr"] | Literal[""]
-    ) = "r",
-    buffering: int | None = None,
-    *args: typing.Any,
-    **kwargs: typing.Any,
-) -> typing.BinaryIO | typing.TextIO:
-    # We disable buffering with SecureTransport because it conflicts with
-    # the buffering that ST does internally (see issue #1153 for more).
-    buffering = 0
-    return socket_cls.makefile(self, mode, buffering, *args, **kwargs)
+if _fileobject:  # Platform-specific: Python 2
+
+    def makefile(self, mode, bufsize=-1):
+        self._makefile_refs += 1
+        return _fileobject(self, mode, bufsize, close=True)
+
+else:  # Platform-specific: Python 3
+
+    def makefile(self, mode="r", buffering=None, *args, **kwargs):
+        # We disable buffering with SecureTransport because it conflicts with
+        # the buffering that ST does internally (see issue #1153 for more).
+        buffering = 0
+        return backport_makefile(self, mode, buffering, *args, **kwargs)
 
 
-WrappedSocket.makefile = makefile  # type: ignore[attr-defined]
+WrappedSocket.makefile = makefile
 
 
-class SecureTransportContext:
+class SecureTransportContext(object):
     """
     I am a wrapper class for the SecureTransport library, to translate the
     interface of the standard library ``SSLContext`` object to calls into
     SecureTransport.
     """
 
-    def __init__(self, protocol: int) -> None:
-        self._minimum_version: int = ssl.TLSVersion.MINIMUM_SUPPORTED
-        self._maximum_version: int = ssl.TLSVersion.MAXIMUM_SUPPORTED
-        if protocol not in (None, ssl.PROTOCOL_TLS, ssl.PROTOCOL_TLS_CLIENT):
-            self._min_version, self._max_version = _protocol_to_min_max[protocol]
-
+    def __init__(self, protocol):
+        self._min_version, self._max_version = _protocol_to_min_max[protocol]
         self._options = 0
         self._verify = False
-        self._trust_bundle: bytes | None = None
-        self._client_cert: str | None = None
-        self._client_key: str | None = None
+        self._trust_bundle = None
+        self._client_cert = None
+        self._client_key = None
         self._client_key_passphrase = None
-        self._alpn_protocols: list[bytes] | None = None
+        self._alpn_protocols = None
 
     @property
-    def check_hostname(self) -> Literal[True]:
+    def check_hostname(self):
         """
         SecureTransport cannot have its hostname checking disabled. For more,
         see the comment on getpeercert() in this file.
@@ -777,14 +808,15 @@ class SecureTransportContext:
         return True
 
     @check_hostname.setter
-    def check_hostname(self, value: typing.Any) -> None:
+    def check_hostname(self, value):
         """
         SecureTransport cannot have its hostname checking disabled. For more,
         see the comment on getpeercert() in this file.
         """
+        pass
 
     @property
-    def options(self) -> int:
+    def options(self):
         # TODO: Well, crap.
         #
         # So this is the bit of the code that is the most likely to cause us
@@ -794,19 +826,19 @@ class SecureTransportContext:
         return self._options
 
     @options.setter
-    def options(self, value: int) -> None:
+    def options(self, value):
         # TODO: Update in line with above.
         self._options = value
 
     @property
-    def verify_mode(self) -> int:
+    def verify_mode(self):
         return ssl.CERT_REQUIRED if self._verify else ssl.CERT_NONE
 
     @verify_mode.setter
-    def verify_mode(self, value: int) -> None:
-        self._verify = value == ssl.CERT_REQUIRED
+    def verify_mode(self, value):
+        self._verify = True if value == ssl.CERT_REQUIRED else False
 
-    def set_default_verify_paths(self) -> None:
+    def set_default_verify_paths(self):
         # So, this has to do something a bit weird. Specifically, what it does
         # is nothing.
         #
@@ -818,18 +850,15 @@ class SecureTransportContext:
         # ignoring it.
         pass
 
-    def load_default_certs(self) -> None:
+    def load_default_certs(self):
         return self.set_default_verify_paths()
 
-    def set_ciphers(self, ciphers: typing.Any) -> None:
-        raise ValueError("SecureTransport doesn't support custom cipher strings")
+    def set_ciphers(self, ciphers):
+        # For now, we just require the default cipher string.
+        if ciphers != util.ssl_.DEFAULT_CIPHERS:
+            raise ValueError("SecureTransport doesn't support custom cipher strings")
 
-    def load_verify_locations(
-        self,
-        cafile: str | None = None,
-        capath: str | None = None,
-        cadata: bytes | None = None,
-    ) -> None:
+    def load_verify_locations(self, cafile=None, capath=None, cadata=None):
         # OK, we only really support cadata and cafile.
         if capath is not None:
             raise ValueError("SecureTransport does not support cert directories")
@@ -839,19 +868,14 @@ class SecureTransportContext:
             with open(cafile):
                 pass
 
-        self._trust_bundle = cafile or cadata  # type: ignore[assignment]
+        self._trust_bundle = cafile or cadata
 
-    def load_cert_chain(
-        self,
-        certfile: str,
-        keyfile: str | None = None,
-        password: str | None = None,
-    ) -> None:
+    def load_cert_chain(self, certfile, keyfile=None, password=None):
         self._client_cert = certfile
         self._client_key = keyfile
         self._client_cert_passphrase = password
 
-    def set_alpn_protocols(self, protocols: list[str | bytes]) -> None:
+    def set_alpn_protocols(self, protocols):
         """
         Sets the ALPN protocols that will later be set on the context.
 
@@ -861,16 +885,16 @@ class SecureTransportContext:
             raise NotImplementedError(
                 "SecureTransport supports ALPN only in macOS 10.12+"
             )
-        self._alpn_protocols = [util.util.to_bytes(p, "ascii") for p in protocols]
+        self._alpn_protocols = [six.ensure_binary(p) for p in protocols]
 
     def wrap_socket(
         self,
-        sock: socket_cls,
-        server_side: bool = False,
-        do_handshake_on_connect: bool = True,
-        suppress_ragged_eofs: bool = True,
-        server_hostname: bytes | str | None = None,
-    ) -> WrappedSocket:
+        sock,
+        server_side=False,
+        do_handshake_on_connect=True,
+        suppress_ragged_eofs=True,
+        server_hostname=None,
+    ):
         # So, what do we do here? Firstly, we assert some properties. This is a
         # stripped down shim, so there is some functionality we don't support.
         # See PEP 543 for the real deal.
@@ -887,27 +911,11 @@ class SecureTransportContext:
             server_hostname,
             self._verify,
             self._trust_bundle,
-            _tls_version_to_st[self._minimum_version],
-            _tls_version_to_st[self._maximum_version],
+            self._min_version,
+            self._max_version,
             self._client_cert,
             self._client_key,
             self._client_key_passphrase,
             self._alpn_protocols,
         )
         return wrapped_socket
-
-    @property
-    def minimum_version(self) -> int:
-        return self._minimum_version
-
-    @minimum_version.setter
-    def minimum_version(self, minimum_version: int) -> None:
-        self._minimum_version = minimum_version
-
-    @property
-    def maximum_version(self) -> int:
-        return self._maximum_version
-
-    @maximum_version.setter
-    def maximum_version(self, maximum_version: int) -> None:
-        self._maximum_version = maximum_version
diff --git a/lib/urllib3/contrib/socks.py b/lib/urllib3/contrib/socks.py
index 5e552dda..c326e80d 100644
--- a/lib/urllib3/contrib/socks.py
+++ b/lib/urllib3/contrib/socks.py
@@ -1,3 +1,4 @@
+# -*- coding: utf-8 -*-
 """
 This module contains provisional support for SOCKS proxies from within
 urllib3. This module supports SOCKS4, SOCKS4A (an extension of SOCKS4), and
@@ -37,11 +38,10 @@ with the proxy:
     proxy_url="socks5h://<username>:<password>@proxy-host"
 
 """
-
-from __future__ import annotations
+from __future__ import absolute_import
 
 try:
-    import socks  # type: ignore[import]
+    import socks
 except ImportError:
     import warnings
 
@@ -51,13 +51,13 @@ except ImportError:
         (
             "SOCKS support in urllib3 requires the installation of optional "
             "dependencies: specifically, PySocks.  For more information, see "
-            "https://urllib3.readthedocs.io/en/latest/contrib.html#socks-proxies"
+            "https://urllib3.readthedocs.io/en/1.26.x/contrib.html#socks-proxies"
         ),
         DependencyWarning,
     )
     raise
 
-import typing
+from socket import error as SocketError
 from socket import timeout as SocketTimeout
 
 from ..connection import HTTPConnection, HTTPSConnection
@@ -69,21 +69,7 @@ from ..util.url import parse_url
 try:
     import ssl
 except ImportError:
-    ssl = None  # type: ignore[assignment]
-
-try:
-    from typing import TypedDict
-
-    class _TYPE_SOCKS_OPTIONS(TypedDict):
-        socks_version: int
-        proxy_host: str | None
-        proxy_port: str | None
-        username: str | None
-        password: str | None
-        rdns: bool
-
-except ImportError:  # Python 3.7
-    _TYPE_SOCKS_OPTIONS = typing.Dict[str, typing.Any]  # type: ignore[misc, assignment]
+    ssl = None
 
 
 class SOCKSConnection(HTTPConnection):
@@ -91,20 +77,15 @@ class SOCKSConnection(HTTPConnection):
     A plain-text HTTP connection that connects via a SOCKS proxy.
     """
 
-    def __init__(
-        self,
-        _socks_options: _TYPE_SOCKS_OPTIONS,
-        *args: typing.Any,
-        **kwargs: typing.Any,
-    ) -> None:
-        self._socks_options = _socks_options
-        super().__init__(*args, **kwargs)
+    def __init__(self, *args, **kwargs):
+        self._socks_options = kwargs.pop("_socks_options")
+        super(SOCKSConnection, self).__init__(*args, **kwargs)
 
-    def _new_conn(self) -> socks.socksocket:
+    def _new_conn(self):
         """
         Establish a new connection via the SOCKS proxy.
         """
-        extra_kw: dict[str, typing.Any] = {}
+        extra_kw = {}
         if self.source_address:
             extra_kw["source_address"] = self.source_address
 
@@ -121,14 +102,15 @@ class SOCKSConnection(HTTPConnection):
                 proxy_password=self._socks_options["password"],
                 proxy_rdns=self._socks_options["rdns"],
                 timeout=self.timeout,
-                **extra_kw,
+                **extra_kw
             )
 
-        except SocketTimeout as e:
+        except SocketTimeout:
             raise ConnectTimeoutError(
                 self,
-                f"Connection to {self.host} timed out. (connect timeout={self.timeout})",
-            ) from e
+                "Connection to %s timed out. (connect timeout=%s)"
+                % (self.host, self.timeout),
+            )
 
         except socks.ProxyError as e:
             # This is fragile as hell, but it seems to be the only way to raise
@@ -138,23 +120,22 @@ class SOCKSConnection(HTTPConnection):
                 if isinstance(error, SocketTimeout):
                     raise ConnectTimeoutError(
                         self,
-                        f"Connection to {self.host} timed out. (connect timeout={self.timeout})",
-                    ) from e
+                        "Connection to %s timed out. (connect timeout=%s)"
+                        % (self.host, self.timeout),
+                    )
                 else:
-                    # Adding `from e` messes with coverage somehow, so it's omitted.
-                    # See #2386.
                     raise NewConnectionError(
-                        self, f"Failed to establish a new connection: {error}"
+                        self, "Failed to establish a new connection: %s" % error
                     )
             else:
                 raise NewConnectionError(
-                    self, f"Failed to establish a new connection: {e}"
-                ) from e
+                    self, "Failed to establish a new connection: %s" % e
+                )
 
-        except OSError as e:  # Defensive: PySocks should catch all these.
+        except SocketError as e:  # Defensive: PySocks should catch all these.
             raise NewConnectionError(
-                self, f"Failed to establish a new connection: {e}"
-            ) from e
+                self, "Failed to establish a new connection: %s" % e
+            )
 
         return conn
 
@@ -188,12 +169,12 @@ class SOCKSProxyManager(PoolManager):
 
     def __init__(
         self,
-        proxy_url: str,
-        username: str | None = None,
-        password: str | None = None,
-        num_pools: int = 10,
-        headers: typing.Mapping[str, str] | None = None,
-        **connection_pool_kw: typing.Any,
+        proxy_url,
+        username=None,
+        password=None,
+        num_pools=10,
+        headers=None,
+        **connection_pool_kw
     ):
         parsed = parse_url(proxy_url)
 
@@ -214,7 +195,7 @@ class SOCKSProxyManager(PoolManager):
             socks_version = socks.PROXY_TYPE_SOCKS4
             rdns = True
         else:
-            raise ValueError(f"Unable to determine SOCKS version from {proxy_url}")
+            raise ValueError("Unable to determine SOCKS version from %s" % proxy_url)
 
         self.proxy_url = proxy_url
 
@@ -228,6 +209,8 @@ class SOCKSProxyManager(PoolManager):
         }
         connection_pool_kw["_socks_options"] = socks_options
 
-        super().__init__(num_pools, headers, **connection_pool_kw)
+        super(SOCKSProxyManager, self).__init__(
+            num_pools, headers, **connection_pool_kw
+        )
 
         self.pool_classes_by_scheme = SOCKSProxyManager.pool_classes_by_scheme
diff --git a/lib/urllib3/exceptions.py b/lib/urllib3/exceptions.py
index 5bb92369..cba6f3f5 100644
--- a/lib/urllib3/exceptions.py
+++ b/lib/urllib3/exceptions.py
@@ -1,16 +1,6 @@
-from __future__ import annotations
+from __future__ import absolute_import
 
-import socket
-import typing
-import warnings
-from email.errors import MessageDefect
-from http.client import IncompleteRead as httplib_IncompleteRead
-
-if typing.TYPE_CHECKING:
-    from .connection import HTTPConnection
-    from .connectionpool import ConnectionPool
-    from .response import HTTPResponse
-    from .util.retry import Retry
+from .packages.six.moves.http_client import IncompleteRead as httplib_IncompleteRead
 
 # Base Exceptions
 
@@ -18,24 +8,23 @@ if typing.TYPE_CHECKING:
 class HTTPError(Exception):
     """Base exception used by this module."""
 
+    pass
+
 
 class HTTPWarning(Warning):
     """Base warning used by this module."""
 
-
-_TYPE_REDUCE_RESULT = typing.Tuple[
-    typing.Callable[..., object], typing.Tuple[object, ...]
-]
+    pass
 
 
 class PoolError(HTTPError):
     """Base exception for errors caused within a pool."""
 
-    def __init__(self, pool: ConnectionPool, message: str) -> None:
+    def __init__(self, pool, message):
         self.pool = pool
-        super().__init__(f"{pool}: {message}")
+        HTTPError.__init__(self, "%s: %s" % (pool, message))
 
-    def __reduce__(self) -> _TYPE_REDUCE_RESULT:
+    def __reduce__(self):
         # For pickling purposes.
         return self.__class__, (None, None)
 
@@ -43,11 +32,11 @@ class PoolError(HTTPError):
 class RequestError(PoolError):
     """Base exception for PoolErrors that have associated URLs."""
 
-    def __init__(self, pool: ConnectionPool, url: str, message: str) -> None:
+    def __init__(self, pool, url, message):
         self.url = url
-        super().__init__(pool, message)
+        PoolError.__init__(self, pool, message)
 
-    def __reduce__(self) -> _TYPE_REDUCE_RESULT:
+    def __reduce__(self):
         # For pickling purposes.
         return self.__class__, (None, self.url, None)
 
@@ -55,25 +44,28 @@ class RequestError(PoolError):
 class SSLError(HTTPError):
     """Raised when SSL certificate fails in an HTTPS connection."""
 
+    pass
+
 
 class ProxyError(HTTPError):
     """Raised when the connection to a proxy fails."""
 
-    # The original error is also available as __cause__.
-    original_error: Exception
-
-    def __init__(self, message: str, error: Exception) -> None:
-        super().__init__(message, error)
+    def __init__(self, message, error, *args):
+        super(ProxyError, self).__init__(message, error, *args)
         self.original_error = error
 
 
 class DecodeError(HTTPError):
     """Raised when automatic decoding based on Content-Type fails."""
 
+    pass
+
 
 class ProtocolError(HTTPError):
     """Raised when something unexpected happens mid-request/response."""
 
+    pass
+
 
 #: Renamed to ProtocolError but aliased for backwards compatibility.
 ConnectionError = ProtocolError
@@ -87,36 +79,33 @@ class MaxRetryError(RequestError):
 
     :param pool: The connection pool
     :type pool: :class:`~urllib3.connectionpool.HTTPConnectionPool`
-    :param str url: The requested Url
-    :param reason: The underlying error
-    :type reason: :class:`Exception`
+    :param string url: The requested Url
+    :param exceptions.Exception reason: The underlying error
 
     """
 
-    def __init__(
-        self, pool: ConnectionPool, url: str, reason: Exception | None = None
-    ) -> None:
+    def __init__(self, pool, url, reason=None):
         self.reason = reason
 
-        message = f"Max retries exceeded with url: {url} (Caused by {reason!r})"
+        message = "Max retries exceeded with url: %s (Caused by %r)" % (url, reason)
 
-        super().__init__(pool, url, message)
+        RequestError.__init__(self, pool, url, message)
 
 
 class HostChangedError(RequestError):
     """Raised when an existing pool gets a request for a foreign host."""
 
-    def __init__(
-        self, pool: ConnectionPool, url: str, retries: Retry | int = 3
-    ) -> None:
-        message = f"Tried to open a foreign host with url: {url}"
-        super().__init__(pool, url, message)
+    def __init__(self, pool, url, retries=3):
+        message = "Tried to open a foreign host with url: %s" % url
+        RequestError.__init__(self, pool, url, message)
         self.retries = retries
 
 
 class TimeoutStateError(HTTPError):
     """Raised when passing an invalid state to a timeout"""
 
+    pass
+
 
 class TimeoutError(HTTPError):
     """Raised when a socket timeout error occurs.
@@ -125,66 +114,53 @@ class TimeoutError(HTTPError):
     <ReadTimeoutError>` and :exc:`ConnectTimeoutErrors <ConnectTimeoutError>`.
     """
 
+    pass
+
 
 class ReadTimeoutError(TimeoutError, RequestError):
     """Raised when a socket timeout occurs while receiving data from a server"""
 
+    pass
+
 
 # This timeout error does not have a URL attached and needs to inherit from the
 # base HTTPError
 class ConnectTimeoutError(TimeoutError):
     """Raised when a socket timeout occurs while connecting to a server"""
 
+    pass
 
-class NewConnectionError(ConnectTimeoutError, HTTPError):
+
+class NewConnectionError(ConnectTimeoutError, PoolError):
     """Raised when we fail to establish a new connection. Usually ECONNREFUSED."""
 
-    def __init__(self, conn: HTTPConnection, message: str) -> None:
-        self.conn = conn
-        super().__init__(f"{conn}: {message}")
-
-    @property
-    def pool(self) -> HTTPConnection:
-        warnings.warn(
-            "The 'pool' property is deprecated and will be removed "
-            "in urllib3 v2.1.0. Use 'conn' instead.",
-            DeprecationWarning,
-            stacklevel=2,
-        )
-
-        return self.conn
-
-
-class NameResolutionError(NewConnectionError):
-    """Raised when host name resolution fails."""
-
-    def __init__(self, host: str, conn: HTTPConnection, reason: socket.gaierror):
-        message = f"Failed to resolve '{host}' ({reason})"
-        super().__init__(conn, message)
+    pass
 
 
 class EmptyPoolError(PoolError):
     """Raised when a pool runs out of connections and no more are allowed."""
 
-
-class FullPoolError(PoolError):
-    """Raised when we try to add a connection to a full pool in blocking mode."""
+    pass
 
 
 class ClosedPoolError(PoolError):
     """Raised when a request enters a pool after the pool has been closed."""
 
+    pass
+
 
 class LocationValueError(ValueError, HTTPError):
     """Raised when there is something wrong with a given URL input."""
 
+    pass
+
 
 class LocationParseError(LocationValueError):
     """Raised when get_host or similar fails to parse the URL input."""
 
-    def __init__(self, location: str) -> None:
-        message = f"Failed to parse: {location}"
-        super().__init__(message)
+    def __init__(self, location):
+        message = "Failed to parse: %s" % location
+        HTTPError.__init__(self, message)
 
         self.location = location
 
@@ -192,9 +168,9 @@ class LocationParseError(LocationValueError):
 class URLSchemeUnknown(LocationValueError):
     """Raised when a URL input has an unsupported scheme."""
 
-    def __init__(self, scheme: str):
-        message = f"Not supported URL scheme {scheme}"
-        super().__init__(message)
+    def __init__(self, scheme):
+        message = "Not supported URL scheme %s" % scheme
+        super(URLSchemeUnknown, self).__init__(message)
 
         self.scheme = scheme
 
@@ -209,22 +185,38 @@ class ResponseError(HTTPError):
 class SecurityWarning(HTTPWarning):
     """Warned when performing security reducing actions"""
 
+    pass
+
+
+class SubjectAltNameWarning(SecurityWarning):
+    """Warned when connecting to a host with a certificate missing a SAN."""
+
+    pass
+
 
 class InsecureRequestWarning(SecurityWarning):
     """Warned when making an unverified HTTPS request."""
 
-
-class NotOpenSSLWarning(SecurityWarning):
-    """Warned when using unsupported SSL library"""
+    pass
 
 
 class SystemTimeWarning(SecurityWarning):
     """Warned when system time is suspected to be wrong"""
 
+    pass
+
 
 class InsecurePlatformWarning(SecurityWarning):
     """Warned when certain TLS/SSL configuration is not available on a platform."""
 
+    pass
+
+
+class SNIMissingWarning(HTTPWarning):
+    """Warned when making a HTTPS request without SNI available."""
+
+    pass
+
 
 class DependencyWarning(HTTPWarning):
     """
@@ -232,10 +224,14 @@ class DependencyWarning(HTTPWarning):
     dependencies.
     """
 
+    pass
+
 
 class ResponseNotChunked(ProtocolError, ValueError):
     """Response needs to be chunked in order to read it as chunks."""
 
+    pass
+
 
 class BodyNotHttplibCompatible(HTTPError):
     """
@@ -243,6 +239,8 @@ class BodyNotHttplibCompatible(HTTPError):
     (have an fp attribute which returns raw chunks) for read_chunked().
     """
 
+    pass
+
 
 class IncompleteRead(HTTPError, httplib_IncompleteRead):
     """
@@ -252,13 +250,12 @@ class IncompleteRead(HTTPError, httplib_IncompleteRead):
     for ``partial`` to avoid creating large objects on streamed reads.
     """
 
-    def __init__(self, partial: int, expected: int) -> None:
-        self.partial = partial  # type: ignore[assignment]
-        self.expected = expected
+    def __init__(self, partial, expected):
+        super(IncompleteRead, self).__init__(partial, expected)
 
-    def __repr__(self) -> str:
+    def __repr__(self):
         return "IncompleteRead(%i bytes read, %i more expected)" % (
-            self.partial,  # type: ignore[str-format]
+            self.partial,
             self.expected,
         )
 
@@ -266,13 +263,14 @@ class IncompleteRead(HTTPError, httplib_IncompleteRead):
 class InvalidChunkLength(HTTPError, httplib_IncompleteRead):
     """Invalid chunk length in a chunked response."""
 
-    def __init__(self, response: HTTPResponse, length: bytes) -> None:
-        self.partial: int = response.tell()  # type: ignore[assignment]
-        self.expected: int | None = response.length_remaining
+    def __init__(self, response, length):
+        super(InvalidChunkLength, self).__init__(
+            response.tell(), response.length_remaining
+        )
         self.response = response
         self.length = length
 
-    def __repr__(self) -> str:
+    def __repr__(self):
         return "InvalidChunkLength(got length %r, %i bytes read)" % (
             self.length,
             self.partial,
@@ -282,13 +280,15 @@ class InvalidChunkLength(HTTPError, httplib_IncompleteRead):
 class InvalidHeader(HTTPError):
     """The header provided was somehow invalid."""
 
+    pass
+
 
 class ProxySchemeUnknown(AssertionError, URLSchemeUnknown):
     """ProxyManager does not support the supplied scheme"""
 
     # TODO(t-8ch): Stop inheriting from AssertionError in v2.0.
 
-    def __init__(self, scheme: str | None) -> None:
+    def __init__(self, scheme):
         # 'localhost' is here because our URL parser parses
         # localhost:8080 -> scheme=localhost, remove if we fix this.
         if scheme == "localhost":
@@ -296,23 +296,28 @@ class ProxySchemeUnknown(AssertionError, URLSchemeUnknown):
         if scheme is None:
             message = "Proxy URL had no scheme, should start with http:// or https://"
         else:
-            message = f"Proxy URL had unsupported scheme {scheme}, should use http:// or https://"
-        super().__init__(message)
+            message = (
+                "Proxy URL had unsupported scheme %s, should use http:// or https://"
+                % scheme
+            )
+        super(ProxySchemeUnknown, self).__init__(message)
 
 
 class ProxySchemeUnsupported(ValueError):
     """Fetching HTTPS resources through HTTPS proxies is unsupported"""
 
+    pass
+
 
 class HeaderParsingError(HTTPError):
     """Raised by assert_header_parsing, but we convert it to a log.warning statement."""
 
-    def __init__(
-        self, defects: list[MessageDefect], unparsed_data: bytes | str | None
-    ) -> None:
-        message = f"{defects or 'Unknown'}, unparsed data: {unparsed_data!r}"
-        super().__init__(message)
+    def __init__(self, defects, unparsed_data):
+        message = "%s, unparsed data: %r" % (defects or "Unknown", unparsed_data)
+        super(HeaderParsingError, self).__init__(message)
 
 
 class UnrewindableBodyError(HTTPError):
     """urllib3 encountered an error when trying to rewind a body"""
+
+    pass
diff --git a/lib/urllib3/fields.py b/lib/urllib3/fields.py
index 51d898e2..9d630f49 100644
--- a/lib/urllib3/fields.py
+++ b/lib/urllib3/fields.py
@@ -1,20 +1,13 @@
-from __future__ import annotations
+from __future__ import absolute_import
 
 import email.utils
 import mimetypes
-import typing
+import re
 
-_TYPE_FIELD_VALUE = typing.Union[str, bytes]
-_TYPE_FIELD_VALUE_TUPLE = typing.Union[
-    _TYPE_FIELD_VALUE,
-    typing.Tuple[str, _TYPE_FIELD_VALUE],
-    typing.Tuple[str, _TYPE_FIELD_VALUE, str],
-]
+from .packages import six
 
 
-def guess_content_type(
-    filename: str | None, default: str = "application/octet-stream"
-) -> str:
+def guess_content_type(filename, default="application/octet-stream"):
     """
     Guess the "Content-Type" of a file.
 
@@ -28,7 +21,7 @@ def guess_content_type(
     return default
 
 
-def format_header_param_rfc2231(name: str, value: _TYPE_FIELD_VALUE) -> str:
+def format_header_param_rfc2231(name, value):
     """
     Helper function to format and quote a single header parameter using the
     strategy defined in RFC 2231.
@@ -41,28 +34,14 @@ def format_header_param_rfc2231(name: str, value: _TYPE_FIELD_VALUE) -> str:
         The name of the parameter, a string expected to be ASCII only.
     :param value:
         The value of the parameter, provided as ``bytes`` or `str``.
-    :returns:
+    :ret:
         An RFC-2231-formatted unicode string.
-
-    .. deprecated:: 2.0.0
-        Will be removed in urllib3 v2.1.0. This is not valid for
-        ``multipart/form-data`` header parameters.
     """
-    import warnings
-
-    warnings.warn(
-        "'format_header_param_rfc2231' is deprecated and will be "
-        "removed in urllib3 v2.1.0. This is not valid for "
-        "multipart/form-data header parameters.",
-        DeprecationWarning,
-        stacklevel=2,
-    )
-
-    if isinstance(value, bytes):
+    if isinstance(value, six.binary_type):
         value = value.decode("utf-8")
 
     if not any(ch in value for ch in '"\\\r\n'):
-        result = f'{name}="{value}"'
+        result = u'%s="%s"' % (name, value)
         try:
             result.encode("ascii")
         except (UnicodeEncodeError, UnicodeDecodeError):
@@ -70,87 +49,81 @@ def format_header_param_rfc2231(name: str, value: _TYPE_FIELD_VALUE) -> str:
         else:
             return result
 
+    if six.PY2:  # Python 2:
+        value = value.encode("utf-8")
+
+    # encode_rfc2231 accepts an encoded string and returns an ascii-encoded
+    # string in Python 2 but accepts and returns unicode strings in Python 3
     value = email.utils.encode_rfc2231(value, "utf-8")
-    value = f"{name}*={value}"
+    value = "%s*=%s" % (name, value)
+
+    if six.PY2:  # Python 2:
+        value = value.decode("utf-8")
 
     return value
 
 
-def format_multipart_header_param(name: str, value: _TYPE_FIELD_VALUE) -> str:
+_HTML5_REPLACEMENTS = {
+    u"\u0022": u"%22",
+    # Replace "\" with "\\".
+    u"\u005C": u"\u005C\u005C",
+}
+
+# All control characters from 0x00 to 0x1F *except* 0x1B.
+_HTML5_REPLACEMENTS.update(
+    {
+        six.unichr(cc): u"%{:02X}".format(cc)
+        for cc in range(0x00, 0x1F + 1)
+        if cc not in (0x1B,)
+    }
+)
+
+
+def _replace_multiple(value, needles_and_replacements):
+    def replacer(match):
+        return needles_and_replacements[match.group(0)]
+
+    pattern = re.compile(
+        r"|".join([re.escape(needle) for needle in needles_and_replacements.keys()])
+    )
+
+    result = pattern.sub(replacer, value)
+
+    return result
+
+
+def format_header_param_html5(name, value):
     """
-    Format and quote a single multipart header parameter.
+    Helper function to format and quote a single header parameter using the
+    HTML5 strategy.
 
-    This follows the `WHATWG HTML Standard`_ as of 2021/06/10, matching
-    the behavior of current browser and curl versions. Values are
-    assumed to be UTF-8. The ``\\n``, ``\\r``, and ``"`` characters are
-    percent encoded.
+    Particularly useful for header parameters which might contain
+    non-ASCII values, like file names. This follows the `HTML5 Working Draft
+    Section 4.10.22.7`_ and matches the behavior of curl and modern browsers.
 
-    .. _WHATWG HTML Standard:
-        https://html.spec.whatwg.org/multipage/
-        form-control-infrastructure.html#multipart-form-data
+    .. _HTML5 Working Draft Section 4.10.22.7:
+        https://w3c.github.io/html/sec-forms.html#multipart-form-data
 
     :param name:
-        The name of the parameter, an ASCII-only ``str``.
+        The name of the parameter, a string expected to be ASCII only.
     :param value:
-        The value of the parameter, a ``str`` or UTF-8 encoded
-        ``bytes``.
-    :returns:
-        A string ``name="value"`` with the escaped value.
-
-    .. versionchanged:: 2.0.0
-        Matches the WHATWG HTML Standard as of 2021/06/10. Control
-        characters are no longer percent encoded.
-
-    .. versionchanged:: 2.0.0
-        Renamed from ``format_header_param_html5`` and
-        ``format_header_param``. The old names will be removed in
-        urllib3 v2.1.0.
+        The value of the parameter, provided as ``bytes`` or `str``.
+    :ret:
+        A unicode string, stripped of troublesome characters.
     """
-    if isinstance(value, bytes):
+    if isinstance(value, six.binary_type):
         value = value.decode("utf-8")
 
-    # percent encode \n \r "
-    value = value.translate({10: "%0A", 13: "%0D", 34: "%22"})
-    return f'{name}="{value}"'
+    value = _replace_multiple(value, _HTML5_REPLACEMENTS)
+
+    return u'%s="%s"' % (name, value)
 
 
-def format_header_param_html5(name: str, value: _TYPE_FIELD_VALUE) -> str:
-    """
-    .. deprecated:: 2.0.0
-        Renamed to :func:`format_multipart_header_param`. Will be
-        removed in urllib3 v2.1.0.
-    """
-    import warnings
-
-    warnings.warn(
-        "'format_header_param_html5' has been renamed to "
-        "'format_multipart_header_param'. The old name will be "
-        "removed in urllib3 v2.1.0.",
-        DeprecationWarning,
-        stacklevel=2,
-    )
-    return format_multipart_header_param(name, value)
+# For backwards-compatibility.
+format_header_param = format_header_param_html5
 
 
-def format_header_param(name: str, value: _TYPE_FIELD_VALUE) -> str:
-    """
-    .. deprecated:: 2.0.0
-        Renamed to :func:`format_multipart_header_param`. Will be
-        removed in urllib3 v2.1.0.
-    """
-    import warnings
-
-    warnings.warn(
-        "'format_header_param' has been renamed to "
-        "'format_multipart_header_param'. The old name will be "
-        "removed in urllib3 v2.1.0.",
-        DeprecationWarning,
-        stacklevel=2,
-    )
-    return format_multipart_header_param(name, value)
-
-
-class RequestField:
+class RequestField(object):
     """
     A data container for request body parameters.
 
@@ -162,47 +135,29 @@ class RequestField:
         An optional filename of the request field. Must be unicode.
     :param headers:
         An optional dict-like object of headers to initially use for the field.
-
-    .. versionchanged:: 2.0.0
-        The ``header_formatter`` parameter is deprecated and will
-        be removed in urllib3 v2.1.0.
+    :param header_formatter:
+        An optional callable that is used to encode and format the headers. By
+        default, this is :func:`format_header_param_html5`.
     """
 
     def __init__(
         self,
-        name: str,
-        data: _TYPE_FIELD_VALUE,
-        filename: str | None = None,
-        headers: typing.Mapping[str, str] | None = None,
-        header_formatter: typing.Callable[[str, _TYPE_FIELD_VALUE], str] | None = None,
+        name,
+        data,
+        filename=None,
+        headers=None,
+        header_formatter=format_header_param_html5,
     ):
         self._name = name
         self._filename = filename
         self.data = data
-        self.headers: dict[str, str | None] = {}
+        self.headers = {}
         if headers:
             self.headers = dict(headers)
-
-        if header_formatter is not None:
-            import warnings
-
-            warnings.warn(
-                "The 'header_formatter' parameter is deprecated and "
-                "will be removed in urllib3 v2.1.0.",
-                DeprecationWarning,
-                stacklevel=2,
-            )
-            self.header_formatter = header_formatter
-        else:
-            self.header_formatter = format_multipart_header_param
+        self.header_formatter = header_formatter
 
     @classmethod
-    def from_tuples(
-        cls,
-        fieldname: str,
-        value: _TYPE_FIELD_VALUE_TUPLE,
-        header_formatter: typing.Callable[[str, _TYPE_FIELD_VALUE], str] | None = None,
-    ) -> RequestField:
+    def from_tuples(cls, fieldname, value, header_formatter=format_header_param_html5):
         """
         A :class:`~urllib3.fields.RequestField` factory from old-style tuple parameters.
 
@@ -219,19 +174,11 @@ class RequestField:
 
         Field names and filenames must be unicode.
         """
-        filename: str | None
-        content_type: str | None
-        data: _TYPE_FIELD_VALUE
-
         if isinstance(value, tuple):
             if len(value) == 3:
-                filename, data, content_type = typing.cast(
-                    typing.Tuple[str, _TYPE_FIELD_VALUE, str], value
-                )
+                filename, data, content_type = value
             else:
-                filename, data = typing.cast(
-                    typing.Tuple[str, _TYPE_FIELD_VALUE], value
-                )
+                filename, data = value
                 content_type = guess_content_type(filename)
         else:
             filename = None
@@ -245,29 +192,20 @@ class RequestField:
 
         return request_param
 
-    def _render_part(self, name: str, value: _TYPE_FIELD_VALUE) -> str:
+    def _render_part(self, name, value):
         """
-        Override this method to change how each multipart header
-        parameter is formatted. By default, this calls
-        :func:`format_multipart_header_param`.
+        Overridable helper function to format a single header parameter. By
+        default, this calls ``self.header_formatter``.
 
         :param name:
-            The name of the parameter, an ASCII-only ``str``.
+            The name of the parameter, a string expected to be ASCII only.
         :param value:
-            The value of the parameter, a ``str`` or UTF-8 encoded
-            ``bytes``.
-
-        :meta public:
+            The value of the parameter, provided as a unicode string.
         """
+
         return self.header_formatter(name, value)
 
-    def _render_parts(
-        self,
-        header_parts: (
-            dict[str, _TYPE_FIELD_VALUE | None]
-            | typing.Sequence[tuple[str, _TYPE_FIELD_VALUE | None]]
-        ),
-    ) -> str:
+    def _render_parts(self, header_parts):
         """
         Helper function to format and quote a single header.
 
@@ -278,21 +216,18 @@ class RequestField:
             A sequence of (k, v) tuples or a :class:`dict` of (k, v) to format
             as `k1="v1"; k2="v2"; ...`.
         """
-        iterable: typing.Iterable[tuple[str, _TYPE_FIELD_VALUE | None]]
-
         parts = []
+        iterable = header_parts
         if isinstance(header_parts, dict):
             iterable = header_parts.items()
-        else:
-            iterable = header_parts
 
         for name, value in iterable:
             if value is not None:
                 parts.append(self._render_part(name, value))
 
-        return "; ".join(parts)
+        return u"; ".join(parts)
 
-    def render_headers(self) -> str:
+    def render_headers(self):
         """
         Renders the headers for this request field.
         """
@@ -301,45 +236,39 @@ class RequestField:
         sort_keys = ["Content-Disposition", "Content-Type", "Content-Location"]
         for sort_key in sort_keys:
             if self.headers.get(sort_key, False):
-                lines.append(f"{sort_key}: {self.headers[sort_key]}")
+                lines.append(u"%s: %s" % (sort_key, self.headers[sort_key]))
 
         for header_name, header_value in self.headers.items():
             if header_name not in sort_keys:
                 if header_value:
-                    lines.append(f"{header_name}: {header_value}")
+                    lines.append(u"%s: %s" % (header_name, header_value))
 
-        lines.append("\r\n")
-        return "\r\n".join(lines)
+        lines.append(u"\r\n")
+        return u"\r\n".join(lines)
 
     def make_multipart(
-        self,
-        content_disposition: str | None = None,
-        content_type: str | None = None,
-        content_location: str | None = None,
-    ) -> None:
+        self, content_disposition=None, content_type=None, content_location=None
+    ):
         """
         Makes this request field into a multipart request field.
 
         This method overrides "Content-Disposition", "Content-Type" and
         "Content-Location" headers to the request parameter.
 
-        :param content_disposition:
-            The 'Content-Disposition' of the request body. Defaults to 'form-data'
         :param content_type:
             The 'Content-Type' of the request body.
         :param content_location:
             The 'Content-Location' of the request body.
 
         """
-        content_disposition = (content_disposition or "form-data") + "; ".join(
+        self.headers["Content-Disposition"] = content_disposition or u"form-data"
+        self.headers["Content-Disposition"] += u"; ".join(
             [
-                "",
+                u"",
                 self._render_parts(
-                    (("name", self._name), ("filename", self._filename))
+                    ((u"name", self._name), (u"filename", self._filename))
                 ),
             ]
         )
-
-        self.headers["Content-Disposition"] = content_disposition
         self.headers["Content-Type"] = content_type
         self.headers["Content-Location"] = content_location
diff --git a/lib/urllib3/filepost.py b/lib/urllib3/filepost.py
index 1c90a211..36c9252c 100644
--- a/lib/urllib3/filepost.py
+++ b/lib/urllib3/filepost.py
@@ -1,32 +1,28 @@
-from __future__ import annotations
+from __future__ import absolute_import
 
 import binascii
 import codecs
 import os
-import typing
 from io import BytesIO
 
-from .fields import _TYPE_FIELD_VALUE_TUPLE, RequestField
+from .fields import RequestField
+from .packages import six
+from .packages.six import b
 
 writer = codecs.lookup("utf-8")[3]
 
-_TYPE_FIELDS_SEQUENCE = typing.Sequence[
-    typing.Union[typing.Tuple[str, _TYPE_FIELD_VALUE_TUPLE], RequestField]
-]
-_TYPE_FIELDS = typing.Union[
-    _TYPE_FIELDS_SEQUENCE,
-    typing.Mapping[str, _TYPE_FIELD_VALUE_TUPLE],
-]
 
-
-def choose_boundary() -> str:
+def choose_boundary():
     """
     Our embarrassingly-simple replacement for mimetools.choose_boundary.
     """
-    return binascii.hexlify(os.urandom(16)).decode()
+    boundary = binascii.hexlify(os.urandom(16))
+    if not six.PY2:
+        boundary = boundary.decode("ascii")
+    return boundary
 
 
-def iter_field_objects(fields: _TYPE_FIELDS) -> typing.Iterable[RequestField]:
+def iter_field_objects(fields):
     """
     Iterate over fields.
 
@@ -34,29 +30,42 @@ def iter_field_objects(fields: _TYPE_FIELDS) -> typing.Iterable[RequestField]:
     :class:`~urllib3.fields.RequestField`.
 
     """
-    iterable: typing.Iterable[RequestField | tuple[str, _TYPE_FIELD_VALUE_TUPLE]]
-
-    if isinstance(fields, typing.Mapping):
-        iterable = fields.items()
+    if isinstance(fields, dict):
+        i = six.iteritems(fields)
     else:
-        iterable = fields
+        i = iter(fields)
 
-    for field in iterable:
+    for field in i:
         if isinstance(field, RequestField):
             yield field
         else:
             yield RequestField.from_tuples(*field)
 
 
-def encode_multipart_formdata(
-    fields: _TYPE_FIELDS, boundary: str | None = None
-) -> tuple[bytes, str]:
+def iter_fields(fields):
+    """
+    .. deprecated:: 1.6
+
+    Iterate over fields.
+
+    The addition of :class:`~urllib3.fields.RequestField` makes this function
+    obsolete. Instead, use :func:`iter_field_objects`, which returns
+    :class:`~urllib3.fields.RequestField` objects.
+
+    Supports list of (k, v) tuples and dicts.
+    """
+    if isinstance(fields, dict):
+        return ((k, v) for k, v in six.iteritems(fields))
+
+    return ((k, v) for k, v in fields)
+
+
+def encode_multipart_formdata(fields, boundary=None):
     """
     Encode a dictionary of ``fields`` using the multipart/form-data MIME format.
 
     :param fields:
         Dictionary of fields or list of (key, :class:`~urllib3.fields.RequestField`).
-        Values are processed by :func:`urllib3.fields.RequestField.from_tuples`.
 
     :param boundary:
         If not specified, then a random boundary will be generated using
@@ -67,7 +76,7 @@ def encode_multipart_formdata(
         boundary = choose_boundary()
 
     for field in iter_field_objects(fields):
-        body.write(f"--{boundary}\r\n".encode("latin-1"))
+        body.write(b("--%s\r\n" % (boundary)))
 
         writer(body).write(field.render_headers())
         data = field.data
@@ -75,15 +84,15 @@ def encode_multipart_formdata(
         if isinstance(data, int):
             data = str(data)  # Backwards compatibility
 
-        if isinstance(data, str):
+        if isinstance(data, six.text_type):
             writer(body).write(data)
         else:
             body.write(data)
 
         body.write(b"\r\n")
 
-    body.write(f"--{boundary}--\r\n".encode("latin-1"))
+    body.write(b("--%s--\r\n" % (boundary)))
 
-    content_type = f"multipart/form-data; boundary={boundary}"
+    content_type = str("multipart/form-data; boundary=%s" % boundary)
 
     return body.getvalue(), content_type
diff --git a/lib/urllib3/packages/__init__.py b/lib/urllib3/packages/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/lib/urllib3/packages/backports/__init__.py b/lib/urllib3/packages/backports/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/lib/urllib3/packages/backports/makefile.py b/lib/urllib3/packages/backports/makefile.py
new file mode 100644
index 00000000..b8fb2154
--- /dev/null
+++ b/lib/urllib3/packages/backports/makefile.py
@@ -0,0 +1,51 @@
+# -*- coding: utf-8 -*-
+"""
+backports.makefile
+~~~~~~~~~~~~~~~~~~
+
+Backports the Python 3 ``socket.makefile`` method for use with anything that
+wants to create a "fake" socket object.
+"""
+import io
+from socket import SocketIO
+
+
+def backport_makefile(
+    self, mode="r", buffering=None, encoding=None, errors=None, newline=None
+):
+    """
+    Backport of ``socket.makefile`` from Python 3.5.
+    """
+    if not set(mode) <= {"r", "w", "b"}:
+        raise ValueError("invalid mode %r (only r, w, b allowed)" % (mode,))
+    writing = "w" in mode
+    reading = "r" in mode or not writing
+    assert reading or writing
+    binary = "b" in mode
+    rawmode = ""
+    if reading:
+        rawmode += "r"
+    if writing:
+        rawmode += "w"
+    raw = SocketIO(self, rawmode)
+    self._makefile_refs += 1
+    if buffering is None:
+        buffering = -1
+    if buffering < 0:
+        buffering = io.DEFAULT_BUFFER_SIZE
+    if buffering == 0:
+        if not binary:
+            raise ValueError("unbuffered streams must be binary")
+        return raw
+    if reading and writing:
+        buffer = io.BufferedRWPair(raw, raw, buffering)
+    elif reading:
+        buffer = io.BufferedReader(raw, buffering)
+    else:
+        assert writing
+        buffer = io.BufferedWriter(raw, buffering)
+    if binary:
+        return buffer
+    text = io.TextIOWrapper(buffer, encoding, errors, newline)
+    text.mode = mode
+    return text
diff --git a/lib/urllib3/packages/backports/weakref_finalize.py b/lib/urllib3/packages/backports/weakref_finalize.py
new file mode 100644
index 00000000..a2f2966e
--- /dev/null
+++ b/lib/urllib3/packages/backports/weakref_finalize.py
@@ -0,0 +1,155 @@
+# -*- coding: utf-8 -*-
+"""
+backports.weakref_finalize
+~~~~~~~~~~~~~~~~~~
+
+Backports the Python 3 ``weakref.finalize`` method.
+"""
+from __future__ import absolute_import
+
+import itertools
+import sys
+from weakref import ref
+
+__all__ = ["weakref_finalize"]
+
+
+class weakref_finalize(object):
+    """Class for finalization of weakrefable objects
+    finalize(obj, func, *args, **kwargs) returns a callable finalizer
+    object which will be called when obj is garbage collected. The
+    first time the finalizer is called it evaluates func(*arg, **kwargs)
+    and returns the result. After this the finalizer is dead, and
+    calling it just returns None.
+    When the program exits any remaining finalizers for which the
+    atexit attribute is true will be run in reverse order of creation.
+    By default atexit is true.
+    """
+
+    # Finalizer objects don't have any state of their own.  They are
+    # just used as keys to lookup _Info objects in the registry.  This
+    # ensures that they cannot be part of a ref-cycle.
+
+    __slots__ = ()
+    _registry = {}
+    _shutdown = False
+    _index_iter = itertools.count()
+    _dirty = False
+    _registered_with_atexit = False
+
+    class _Info(object):
+        __slots__ = ("weakref", "func", "args", "kwargs", "atexit", "index")
+
+    def __init__(self, obj, func, *args, **kwargs):
+        if not self._registered_with_atexit:
+            # We may register the exit function more than once because
+            # of a thread race, but that is harmless
+            import atexit
+
+            atexit.register(self._exitfunc)
+            weakref_finalize._registered_with_atexit = True
+        info = self._Info()
+        info.weakref = ref(obj, self)
+        info.func = func
+        info.args = args
+        info.kwargs = kwargs or None
+        info.atexit = True
+        info.index = next(self._index_iter)
+        self._registry[self] = info
+        weakref_finalize._dirty = True
+
+    def __call__(self, _=None):
+        """If alive then mark as dead and return func(*args, **kwargs);
+        otherwise return None"""
+        info = self._registry.pop(self, None)
+        if info and not self._shutdown:
+            return info.func(*info.args, **(info.kwargs or {}))
+
+    def detach(self):
+        """If alive then mark as dead and return (obj, func, args, kwargs);
+        otherwise return None"""
+        info = self._registry.get(self)
+        obj = info and info.weakref()
+        if obj is not None and self._registry.pop(self, None):
+            return (obj, info.func, info.args, info.kwargs or {})
+
+    def peek(self):
+        """If alive then return (obj, func, args, kwargs);
+        otherwise return None"""
+        info = self._registry.get(self)
+        obj = info and info.weakref()
+        if obj is not None:
+            return (obj, info.func, info.args, info.kwargs or {})
+
+    @property
+    def alive(self):
+        """Whether finalizer is alive"""
+        return self in self._registry
+
+    @property
+    def atexit(self):
+        """Whether finalizer should be called at exit"""
+        info = self._registry.get(self)
+        return bool(info) and info.atexit
+
+    @atexit.setter
+    def atexit(self, value):
+        info = self._registry.get(self)
+        if info:
+            info.atexit = bool(value)
+
+    def __repr__(self):
+        info = self._registry.get(self)
+        obj = info and info.weakref()
+        if obj is None:
+            return "<%s object at %#x; dead>" % (type(self).__name__, id(self))
+        else:
+            return "<%s object at %#x; for %r at %#x>" % (
+                type(self).__name__,
+                id(self),
+                type(obj).__name__,
+                id(obj),
+            )
+
+    @classmethod
+    def _select_for_exit(cls):
+        # Return live finalizers marked for exit, oldest first
+        L = [(f, i) for (f, i) in cls._registry.items() if i.atexit]
+        L.sort(key=lambda item: item[1].index)
+        return [f for (f, i) in L]
+
+    @classmethod
+    def _exitfunc(cls):
+        # At shutdown invoke finalizers for which atexit is true.
+        # This is called once all other non-daemonic threads have been
+        # joined.
+        reenable_gc = False
+        try:
+            if cls._registry:
+                import gc
+
+                if gc.isenabled():
+                    reenable_gc = True
+                    gc.disable()
+                pending = None
+                while True:
+                    if pending is None or weakref_finalize._dirty:
+                        pending = cls._select_for_exit()
+                        weakref_finalize._dirty = False
+                    if not pending:
+                        break
+                    f = pending.pop()
+                    try:
+                        # gc is disabled, so (assuming no daemonic
+                        # threads) the following is the only line in
+                        # this function which might trigger creation
+                        # of a new finalizer
+                        f()
+                    except Exception:
+                        sys.excepthook(*sys.exc_info())
+                    assert f not in cls._registry
+        finally:
+            # prevent any more finalizers from executing during shutdown
+            weakref_finalize._shutdown = True
+            if reenable_gc:
+                gc.enable()
diff --git a/lib/urllib3/packages/six.py b/lib/urllib3/packages/six.py
new file mode 100644
index 00000000..f099a3dc
--- /dev/null
+++ b/lib/urllib3/packages/six.py
@@ -0,0 +1,1076 @@
+# Copyright (c) 2010-2020 Benjamin Peterson
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+
+"""Utilities for writing code that runs on Python 2 and 3"""
+
+from __future__ import absolute_import
+
+import functools
+import itertools
+import operator
+import sys
+import types
+
+__author__ = "Benjamin Peterson <benjamin@python.org>"
+__version__ = "1.16.0"
+
+
+# Useful for very coarse version differentiation.
+PY2 = sys.version_info[0] == 2
+PY3 = sys.version_info[0] == 3
+PY34 = sys.version_info[0:2] >= (3, 4)
+
+if PY3:
+    string_types = (str,)
+    integer_types = (int,)
+    class_types = (type,)
+    text_type = str
+    binary_type = bytes
+
+    MAXSIZE = sys.maxsize
+else:
+    string_types = (basestring,)
+    integer_types = (int, long)
+    class_types = (type, types.ClassType)
+    text_type = unicode
+    binary_type = str
+
+    if sys.platform.startswith("java"):
+        # Jython always uses 32 bits.
+        MAXSIZE = int((1 << 31) - 1)
+    else:
+        # It's possible to have sizeof(long) != sizeof(Py_ssize_t).
+        class X(object):
+            def __len__(self):
+                return 1 << 31
+
+        try:
+            len(X())
+        except OverflowError:
+            # 32-bit
+            MAXSIZE = int((1 << 31) - 1)
+        else:
+            # 64-bit
+            MAXSIZE = int((1 << 63) - 1)
+        del X
+
+if PY34:
+    from importlib.util import spec_from_loader
+else:
+    spec_from_loader = None
+
+
+def _add_doc(func, doc):
+    """Add documentation to a function."""
+    func.__doc__ = doc
+
+
+def _import_module(name):
+    """Import module, returning the module after the last dot."""
+    __import__(name)
+    return sys.modules[name]
+
+
+class _LazyDescr(object):
+    def __init__(self, name):
+        self.name = name
+
+    def __get__(self, obj, tp):
+        result = self._resolve()
+        setattr(obj, self.name, result)  # Invokes __set__.
+        try:
+            # This is a bit ugly, but it avoids running this again by
+            # removing this descriptor.
+            delattr(obj.__class__, self.name)
+        except AttributeError:
+            pass
+        return result
+
+
+class MovedModule(_LazyDescr):
+    def __init__(self, name, old, new=None):
+        super(MovedModule, self).__init__(name)
+        if PY3:
+            if new is None:
+                new = name
+            self.mod = new
+        else:
+            self.mod = old
+
+    def _resolve(self):
+        return _import_module(self.mod)
+
+    def __getattr__(self, attr):
+        _module = self._resolve()
+        value = getattr(_module, attr)
+        setattr(self, attr, value)
+        return value
+
+
+class _LazyModule(types.ModuleType):
+    def __init__(self, name):
+        super(_LazyModule, self).__init__(name)
+        self.__doc__ = self.__class__.__doc__
+
+    def __dir__(self):
+        attrs = ["__doc__", "__name__"]
+        attrs += [attr.name for attr in self._moved_attributes]
+        return attrs
+
+    # Subclasses should override this
+    _moved_attributes = []
+
+
+class MovedAttribute(_LazyDescr):
+    def __init__(self, name, old_mod, new_mod, old_attr=None, new_attr=None):
+        super(MovedAttribute, self).__init__(name)
+        if PY3:
+            if new_mod is None:
+                new_mod = name
+            self.mod = new_mod
+            if new_attr is None:
+                if old_attr is None:
+                    new_attr = name
+                else:
+                    new_attr = old_attr
+            self.attr = new_attr
+        else:
+            self.mod = old_mod
+            if old_attr is None:
+                old_attr = name
+            self.attr = old_attr
+
+    def _resolve(self):
+        module = _import_module(self.mod)
+        return getattr(module, self.attr)
+
+
+class _SixMetaPathImporter(object):
+
+    """
+    A meta path importer to import six.moves and its submodules.
+
+    This class implements a PEP302 finder and loader. It should be compatible
+    with Python 2.5 and all existing versions of Python3
+    """
+
+    def __init__(self, six_module_name):
+        self.name = six_module_name
+        self.known_modules = {}
+
+    def _add_module(self, mod, *fullnames):
+        for fullname in fullnames:
+            self.known_modules[self.name + "." + fullname] = mod
+
+    def _get_module(self, fullname):
+        return self.known_modules[self.name + "." + fullname]
+
+    def find_module(self, fullname, path=None):
+        if fullname in self.known_modules:
+            return self
+        return None
+
+    def find_spec(self, fullname, path, target=None):
+        if fullname in self.known_modules:
+            return spec_from_loader(fullname, self)
+        return None
+
+    def __get_module(self, fullname):
+        try:
+            return self.known_modules[fullname]
+        except KeyError:
+            raise ImportError("This loader does not know module " + fullname)
+
+    def load_module(self, fullname):
+        try:
+            # in case of a reload
+            return sys.modules[fullname]
+        except KeyError:
+            pass
+        mod = self.__get_module(fullname)
+        if isinstance(mod, MovedModule):
+            mod = mod._resolve()
+        else:
+            mod.__loader__ = self
+        sys.modules[fullname] = mod
+        return mod
+
+    def is_package(self, fullname):
+        """
+        Return true, if the named module is a package.
+
+        We need this method to get correct spec objects with
+        Python 3.4 (see PEP451)
+        """
+        return hasattr(self.__get_module(fullname), "__path__")
+
+    def get_code(self, fullname):
+        """Return None
+
+        Required, if is_package is implemented"""
+        self.__get_module(fullname)  # eventually raises ImportError
+        return None
+
+    get_source = get_code  # same as get_code
+
+    def create_module(self, spec):
+        return self.load_module(spec.name)
+
+    def exec_module(self, module):
+        pass
+
+
+_importer = _SixMetaPathImporter(__name__)
+
+
+class _MovedItems(_LazyModule):
+
+    """Lazy loading of moved objects"""
+
+    __path__ = []  # mark as package
+
+
+_moved_attributes = [
+    MovedAttribute("cStringIO", "cStringIO", "io", "StringIO"),
+    MovedAttribute("filter", "itertools", "builtins", "ifilter", "filter"),
+    MovedAttribute(
+        "filterfalse", "itertools", "itertools", "ifilterfalse", "filterfalse"
+    ),
+    MovedAttribute("input", "__builtin__", "builtins", "raw_input", "input"),
+    MovedAttribute("intern", "__builtin__", "sys"),
+    MovedAttribute("map", "itertools", "builtins", "imap", "map"),
+    MovedAttribute("getcwd", "os", "os", "getcwdu", "getcwd"),
+    MovedAttribute("getcwdb", "os", "os", "getcwd", "getcwdb"),
+    MovedAttribute("getoutput", "commands", "subprocess"),
+    MovedAttribute("range", "__builtin__", "builtins", "xrange", "range"),
+    MovedAttribute(
+        "reload_module", "__builtin__", "importlib" if PY34 else "imp", "reload"
+    ),
+    MovedAttribute("reduce", "__builtin__", "functools"),
+    MovedAttribute("shlex_quote", "pipes", "shlex", "quote"),
+    MovedAttribute("StringIO", "StringIO", "io"),
+    MovedAttribute("UserDict", "UserDict", "collections"),
+    MovedAttribute("UserList", "UserList", "collections"),
+    MovedAttribute("UserString", "UserString", "collections"),
+    MovedAttribute("xrange", "__builtin__", "builtins", "xrange", "range"),
+    MovedAttribute("zip", "itertools", "builtins", "izip", "zip"),
+    MovedAttribute(
+        "zip_longest", "itertools", "itertools", "izip_longest", "zip_longest"
+    ),
+    MovedModule("builtins", "__builtin__"),
+    MovedModule("configparser", "ConfigParser"),
+    MovedModule(
+        "collections_abc",
+        "collections",
+        "collections.abc" if sys.version_info >= (3, 3) else "collections",
+    ),
+    MovedModule("copyreg", "copy_reg"),
+    MovedModule("dbm_gnu", "gdbm", "dbm.gnu"),
+    MovedModule("dbm_ndbm", "dbm", "dbm.ndbm"),
+    MovedModule(
+        "_dummy_thread",
+        "dummy_thread",
+        "_dummy_thread" if sys.version_info < (3, 9) else "_thread",
+    ),
+    MovedModule("http_cookiejar", "cookielib", "http.cookiejar"),
+    MovedModule("http_cookies", "Cookie", "http.cookies"),
+    MovedModule("html_entities", "htmlentitydefs", "html.entities"),
+    MovedModule("html_parser", "HTMLParser", "html.parser"),
+    MovedModule("http_client", "httplib", "http.client"),
+    MovedModule("email_mime_base", "email.MIMEBase", "email.mime.base"),
+    MovedModule("email_mime_image", "email.MIMEImage", "email.mime.image"),
+    MovedModule("email_mime_multipart", "email.MIMEMultipart", "email.mime.multipart"),
+    MovedModule(
+        "email_mime_nonmultipart", "email.MIMENonMultipart", "email.mime.nonmultipart"
+    ),
+    MovedModule("email_mime_text", "email.MIMEText", "email.mime.text"),
+    MovedModule("BaseHTTPServer", "BaseHTTPServer", "http.server"),
+    MovedModule("CGIHTTPServer", "CGIHTTPServer", "http.server"),
+    MovedModule("SimpleHTTPServer", "SimpleHTTPServer", "http.server"),
+    MovedModule("cPickle", "cPickle", "pickle"),
+    MovedModule("queue", "Queue"),
+    MovedModule("reprlib", "repr"),
+    MovedModule("socketserver", "SocketServer"),
+    MovedModule("_thread", "thread", "_thread"),
+    MovedModule("tkinter", "Tkinter"),
+    MovedModule("tkinter_dialog", "Dialog", "tkinter.dialog"),
+    MovedModule("tkinter_filedialog", "FileDialog", "tkinter.filedialog"),
+    MovedModule("tkinter_scrolledtext", "ScrolledText", "tkinter.scrolledtext"),
+    MovedModule("tkinter_simpledialog", "SimpleDialog", "tkinter.simpledialog"),
+    MovedModule("tkinter_tix", "Tix", "tkinter.tix"),
+    MovedModule("tkinter_ttk", "ttk", "tkinter.ttk"),
+    MovedModule("tkinter_constants", "Tkconstants", "tkinter.constants"),
+    MovedModule("tkinter_dnd", "Tkdnd", "tkinter.dnd"),
+    MovedModule("tkinter_colorchooser", "tkColorChooser", "tkinter.colorchooser"),
+    MovedModule("tkinter_commondialog", "tkCommonDialog", "tkinter.commondialog"),
+    MovedModule("tkinter_tkfiledialog", "tkFileDialog", "tkinter.filedialog"),
+    MovedModule("tkinter_font", "tkFont", "tkinter.font"),
+    MovedModule("tkinter_messagebox", "tkMessageBox", "tkinter.messagebox"),
+    MovedModule("tkinter_tksimpledialog", "tkSimpleDialog", "tkinter.simpledialog"),
+    MovedModule("urllib_parse", __name__ + ".moves.urllib_parse", "urllib.parse"),
+    MovedModule("urllib_error", __name__ + ".moves.urllib_error", "urllib.error"),
+    MovedModule("urllib", __name__ + ".moves.urllib", __name__ + ".moves.urllib"),
+    MovedModule("urllib_robotparser", "robotparser", "urllib.robotparser"),
+    MovedModule("xmlrpc_client", "xmlrpclib", "xmlrpc.client"),
+    MovedModule("xmlrpc_server", "SimpleXMLRPCServer", "xmlrpc.server"),
+]
+# Add windows specific modules.
+if sys.platform == "win32":
+    _moved_attributes += [
+        MovedModule("winreg", "_winreg"),
+    ]
+
+for attr in _moved_attributes:
+    setattr(_MovedItems, attr.name, attr)
+    if isinstance(attr, MovedModule):
+        _importer._add_module(attr, "moves." + attr.name)
+del attr
+
+_MovedItems._moved_attributes = _moved_attributes
+
+moves = _MovedItems(__name__ + ".moves")
+_importer._add_module(moves, "moves")
+
+
+class Module_six_moves_urllib_parse(_LazyModule):
+
+    """Lazy loading of moved objects in six.moves.urllib_parse"""
+
+
+_urllib_parse_moved_attributes = [
+    MovedAttribute("ParseResult", "urlparse", "urllib.parse"),
+    MovedAttribute("SplitResult", "urlparse", "urllib.parse"),
+    MovedAttribute("parse_qs", "urlparse", "urllib.parse"),
+    MovedAttribute("parse_qsl", "urlparse", "urllib.parse"),
+    MovedAttribute("urldefrag", "urlparse", "urllib.parse"),
+    MovedAttribute("urljoin", "urlparse", "urllib.parse"),
+    MovedAttribute("urlparse", "urlparse", "urllib.parse"),
+    MovedAttribute("urlsplit", "urlparse", "urllib.parse"),
+    MovedAttribute("urlunparse", "urlparse", "urllib.parse"),
+    MovedAttribute("urlunsplit", "urlparse", "urllib.parse"),
+    MovedAttribute("quote", "urllib", "urllib.parse"),
+    MovedAttribute("quote_plus", "urllib", "urllib.parse"),
+    MovedAttribute("unquote", "urllib", "urllib.parse"),
+    MovedAttribute("unquote_plus", "urllib", "urllib.parse"),
+    MovedAttribute(
+        "unquote_to_bytes", "urllib", "urllib.parse", "unquote", "unquote_to_bytes"
+    ),
+    MovedAttribute("urlencode", "urllib", "urllib.parse"),
+    MovedAttribute("splitquery", "urllib", "urllib.parse"),
+    MovedAttribute("splittag", "urllib", "urllib.parse"),
+    MovedAttribute("splituser", "urllib", "urllib.parse"),
+    MovedAttribute("splitvalue", "urllib", "urllib.parse"),
+    MovedAttribute("uses_fragment", "urlparse", "urllib.parse"),
+    MovedAttribute("uses_netloc", "urlparse", "urllib.parse"),
+    MovedAttribute("uses_params", "urlparse", "urllib.parse"),
+    MovedAttribute("uses_query", "urlparse", "urllib.parse"),
+    MovedAttribute("uses_relative", "urlparse", "urllib.parse"),
+]
+for attr in _urllib_parse_moved_attributes:
+    setattr(Module_six_moves_urllib_parse, attr.name, attr)
+del attr
+
+Module_six_moves_urllib_parse._moved_attributes = _urllib_parse_moved_attributes
+
+_importer._add_module(
+    Module_six_moves_urllib_parse(__name__ + ".moves.urllib_parse"),
+    "moves.urllib_parse",
+    "moves.urllib.parse",
+)
+
+
+class Module_six_moves_urllib_error(_LazyModule):
+
+    """Lazy loading of moved objects in six.moves.urllib_error"""
+
+
+_urllib_error_moved_attributes = [
+    MovedAttribute("URLError", "urllib2", "urllib.error"),
+    MovedAttribute("HTTPError", "urllib2", "urllib.error"),
+    MovedAttribute("ContentTooShortError", "urllib", "urllib.error"),
+]
+for attr in _urllib_error_moved_attributes:
+    setattr(Module_six_moves_urllib_error, attr.name, attr)
+del attr
+
+Module_six_moves_urllib_error._moved_attributes = _urllib_error_moved_attributes
+
+_importer._add_module(
+    Module_six_moves_urllib_error(__name__ + ".moves.urllib.error"),
+    "moves.urllib_error",
+    "moves.urllib.error",
+)
+
+
+class Module_six_moves_urllib_request(_LazyModule):
+
+    """Lazy loading of moved objects in six.moves.urllib_request"""
+
+
+_urllib_request_moved_attributes = [
+    MovedAttribute("urlopen", "urllib2", "urllib.request"),
+    MovedAttribute("install_opener", "urllib2", "urllib.request"),
+    MovedAttribute("build_opener", "urllib2", "urllib.request"),
+    MovedAttribute("pathname2url", "urllib", "urllib.request"),
+    MovedAttribute("url2pathname", "urllib", "urllib.request"),
+    MovedAttribute("getproxies", "urllib", "urllib.request"),
+    MovedAttribute("Request", "urllib2", "urllib.request"),
+    MovedAttribute("OpenerDirector", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPDefaultErrorHandler", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPRedirectHandler", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPCookieProcessor", "urllib2", "urllib.request"),
+    MovedAttribute("ProxyHandler", "urllib2", "urllib.request"),
+    MovedAttribute("BaseHandler", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPPasswordMgr", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPPasswordMgrWithDefaultRealm", "urllib2", "urllib.request"),
+    MovedAttribute("AbstractBasicAuthHandler", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPBasicAuthHandler", "urllib2", "urllib.request"),
+    MovedAttribute("ProxyBasicAuthHandler", "urllib2", "urllib.request"),
+    MovedAttribute("AbstractDigestAuthHandler", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPDigestAuthHandler", "urllib2", "urllib.request"),
+    MovedAttribute("ProxyDigestAuthHandler", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPHandler", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPSHandler", "urllib2", "urllib.request"),
+    MovedAttribute("FileHandler", "urllib2", "urllib.request"),
+    MovedAttribute("FTPHandler", "urllib2", "urllib.request"),
+    MovedAttribute("CacheFTPHandler", "urllib2", "urllib.request"),
+    MovedAttribute("UnknownHandler", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPErrorProcessor", "urllib2", "urllib.request"),
+    MovedAttribute("urlretrieve", "urllib", "urllib.request"),
+    MovedAttribute("urlcleanup", "urllib", "urllib.request"),
+    MovedAttribute("URLopener", "urllib", "urllib.request"),
+    MovedAttribute("FancyURLopener", "urllib", "urllib.request"),
+    MovedAttribute("proxy_bypass", "urllib", "urllib.request"),
+    MovedAttribute("parse_http_list", "urllib2", "urllib.request"),
+    MovedAttribute("parse_keqv_list", "urllib2", "urllib.request"),
+]
+for attr in _urllib_request_moved_attributes:
+    setattr(Module_six_moves_urllib_request, attr.name, attr)
+del attr
+
+Module_six_moves_urllib_request._moved_attributes = _urllib_request_moved_attributes
+
+_importer._add_module(
+    Module_six_moves_urllib_request(__name__ + ".moves.urllib.request"),
+    "moves.urllib_request",
+    "moves.urllib.request",
+)
+
+
+class Module_six_moves_urllib_response(_LazyModule):
+
+    """Lazy loading of moved objects in six.moves.urllib_response"""
+
+
+_urllib_response_moved_attributes = [
+    MovedAttribute("addbase", "urllib", "urllib.response"),
+    MovedAttribute("addclosehook", "urllib", "urllib.response"),
+    MovedAttribute("addinfo", "urllib", "urllib.response"),
+    MovedAttribute("addinfourl", "urllib", "urllib.response"),
+]
+for attr in _urllib_response_moved_attributes:
+    setattr(Module_six_moves_urllib_response, attr.name, attr)
+del attr
+
+Module_six_moves_urllib_response._moved_attributes = _urllib_response_moved_attributes
+
+_importer._add_module(
+    Module_six_moves_urllib_response(__name__ + ".moves.urllib.response"),
+    "moves.urllib_response",
+    "moves.urllib.response",
+)
+
+
+class Module_six_moves_urllib_robotparser(_LazyModule):
+
+    """Lazy loading of moved objects in six.moves.urllib_robotparser"""
+
+
+_urllib_robotparser_moved_attributes = [
+    MovedAttribute("RobotFileParser", "robotparser", "urllib.robotparser"),
+]
+for attr in _urllib_robotparser_moved_attributes:
+    setattr(Module_six_moves_urllib_robotparser, attr.name, attr)
+del attr
+
+Module_six_moves_urllib_robotparser._moved_attributes = (
+    _urllib_robotparser_moved_attributes
+)
+
+_importer._add_module(
+    Module_six_moves_urllib_robotparser(__name__ + ".moves.urllib.robotparser"),
+    "moves.urllib_robotparser",
+    "moves.urllib.robotparser",
+)
+
+
+class Module_six_moves_urllib(types.ModuleType):
+
+    """Create a six.moves.urllib namespace that resembles the Python 3 namespace"""
+
+    __path__ = []  # mark as package
+    parse = _importer._get_module("moves.urllib_parse")
+    error = _importer._get_module("moves.urllib_error")
+    request = _importer._get_module("moves.urllib_request")
+    response = _importer._get_module("moves.urllib_response")
+    robotparser = _importer._get_module("moves.urllib_robotparser")
+
+    def __dir__(self):
+        return ["parse", "error", "request", "response", "robotparser"]
+
+
+_importer._add_module(
+    Module_six_moves_urllib(__name__ + ".moves.urllib"), "moves.urllib"
+)
+
+
+def add_move(move):
+    """Add an item to six.moves."""
+    setattr(_MovedItems, move.name, move)
+
+
+def remove_move(name):
+    """Remove item from six.moves."""
+    try:
+        delattr(_MovedItems, name)
+    except AttributeError:
+        try:
+            del moves.__dict__[name]
+        except KeyError:
+            raise AttributeError("no such move, %r" % (name,))
+
+
+if PY3:
+    _meth_func = "__func__"
+    _meth_self = "__self__"
+
+    _func_closure = "__closure__"
+    _func_code = "__code__"
+    _func_defaults = "__defaults__"
+    _func_globals = "__globals__"
+else:
+    _meth_func = "im_func"
+    _meth_self = "im_self"
+
+    _func_closure = "func_closure"
+    _func_code = "func_code"
+    _func_defaults = "func_defaults"
+    _func_globals = "func_globals"
+
+
+try:
+    advance_iterator = next
+except NameError:
+
+    def advance_iterator(it):
+        return it.next()
+
+
+next = advance_iterator
+
+
+try:
+    callable = callable
+except NameError:
+
+    def callable(obj):
+        return any("__call__" in klass.__dict__ for klass in type(obj).__mro__)
+
+
+if PY3:
+
+    def get_unbound_function(unbound):
+        return unbound
+
+    create_bound_method = types.MethodType
+
+    def create_unbound_method(func, cls):
+        return func
+
+    Iterator = object
+else:
+
+    def get_unbound_function(unbound):
+        return unbound.im_func
+
+    def create_bound_method(func, obj):
+        return types.MethodType(func, obj, obj.__class__)
+
+    def create_unbound_method(func, cls):
+        return types.MethodType(func, None, cls)
+
+    class Iterator(object):
+        def next(self):
+            return type(self).__next__(self)
+
+    callable = callable
+_add_doc(
+    get_unbound_function, """Get the function out of a possibly unbound function"""
+)
+
+
+get_method_function = operator.attrgetter(_meth_func)
+get_method_self = operator.attrgetter(_meth_self)
+get_function_closure = operator.attrgetter(_func_closure)
+get_function_code = operator.attrgetter(_func_code)
+get_function_defaults = operator.attrgetter(_func_defaults)
+get_function_globals = operator.attrgetter(_func_globals)
+
+
+if PY3:
+
+    def iterkeys(d, **kw):
+        return iter(d.keys(**kw))
+
+    def itervalues(d, **kw):
+        return iter(d.values(**kw))
+
+    def iteritems(d, **kw):
+        return iter(d.items(**kw))
+
+    def iterlists(d, **kw):
+        return iter(d.lists(**kw))
+
+    viewkeys = operator.methodcaller("keys")
+
+    viewvalues = operator.methodcaller("values")
+
+    viewitems = operator.methodcaller("items")
+else:
+
+    def iterkeys(d, **kw):
+        return d.iterkeys(**kw)
+
+    def itervalues(d, **kw):
+        return d.itervalues(**kw)
+
+    def iteritems(d, **kw):
+        return d.iteritems(**kw)
+
+    def iterlists(d, **kw):
+        return d.iterlists(**kw)
+
+    viewkeys = operator.methodcaller("viewkeys")
+
+    viewvalues = operator.methodcaller("viewvalues")
+
+    viewitems = operator.methodcaller("viewitems")
+
+_add_doc(iterkeys, "Return an iterator over the keys of a dictionary.")
+_add_doc(itervalues, "Return an iterator over the values of a dictionary.")
+_add_doc(iteritems, "Return an iterator over the (key, value) pairs of a dictionary.")
+_add_doc(
+    iterlists, "Return an iterator over the (key, [values]) pairs of a dictionary."
+)
+
+
+if PY3:
+
+    def b(s):
+        return s.encode("latin-1")
+
+    def u(s):
+        return s
+
+    unichr = chr
+    import struct
+
+    int2byte = struct.Struct(">B").pack
+    del struct
+    byte2int = operator.itemgetter(0)
+    indexbytes = operator.getitem
+    iterbytes = iter
+    import io
+
+    StringIO = io.StringIO
+    BytesIO = io.BytesIO
+    del io
+    _assertCountEqual = "assertCountEqual"
+    if sys.version_info[1] <= 1:
+        _assertRaisesRegex = "assertRaisesRegexp"
+        _assertRegex = "assertRegexpMatches"
+        _assertNotRegex = "assertNotRegexpMatches"
+    else:
+        _assertRaisesRegex = "assertRaisesRegex"
+        _assertRegex = "assertRegex"
+        _assertNotRegex = "assertNotRegex"
+else:
+
+    def b(s):
+        return s
+
+    # Workaround for standalone backslash
+
+    def u(s):
+        return unicode(s.replace(r"\\", r"\\\\"), "unicode_escape")
+
+    unichr = unichr
+    int2byte = chr
+
+    def byte2int(bs):
+        return ord(bs[0])
+
+    def indexbytes(buf, i):
+        return ord(buf[i])
+
+    iterbytes = functools.partial(itertools.imap, ord)
+    import StringIO
+
+    StringIO = BytesIO = StringIO.StringIO
+    _assertCountEqual = "assertItemsEqual"
+    _assertRaisesRegex = "assertRaisesRegexp"
+    _assertRegex = "assertRegexpMatches"
+    _assertNotRegex = "assertNotRegexpMatches"
+_add_doc(b, """Byte literal""")
+_add_doc(u, """Text literal""")
+
+
+def assertCountEqual(self, *args, **kwargs):
+    return getattr(self, _assertCountEqual)(*args, **kwargs)
+
+
+def assertRaisesRegex(self, *args, **kwargs):
+    return getattr(self, _assertRaisesRegex)(*args, **kwargs)
+
+
+def assertRegex(self, *args, **kwargs):
+    return getattr(self, _assertRegex)(*args, **kwargs)
+
+
+def assertNotRegex(self, *args, **kwargs):
+    return getattr(self, _assertNotRegex)(*args, **kwargs)
+
+
+if PY3:
+    exec_ = getattr(moves.builtins, "exec")
+
+    def reraise(tp, value, tb=None):
+        try:
+            if value is None:
+                value = tp()
+            if value.__traceback__ is not tb:
+                raise value.with_traceback(tb)
+            raise value
+        finally:
+            value = None
+            tb = None
+
+else:
+
+    def exec_(_code_, _globs_=None, _locs_=None):
+        """Execute code in a namespace."""
+        if _globs_ is None:
+            frame = sys._getframe(1)
+            _globs_ = frame.f_globals
+            if _locs_ is None:
+                _locs_ = frame.f_locals
+            del frame
+        elif _locs_ is None:
+            _locs_ = _globs_
+        exec ("""exec _code_ in _globs_, _locs_""")
+
+    exec_(
+        """def reraise(tp, value, tb=None):
+    try:
+        raise tp, value, tb
+    finally:
+        tb = None
+"""
+    )
+
+
+if sys.version_info[:2] > (3,):
+    exec_(
+        """def raise_from(value, from_value):
+    try:
+        raise value from from_value
+    finally:
+        value = None
+"""
+    )
+else:
+
+    def raise_from(value, from_value):
+        raise value
+
+
+print_ = getattr(moves.builtins, "print", None)
+if print_ is None:
+
+    def print_(*args, **kwargs):
+        """The new-style print function for Python 2.4 and 2.5."""
+        fp = kwargs.pop("file", sys.stdout)
+        if fp is None:
+            return
+
+        def write(data):
+            if not isinstance(data, basestring):
+                data = str(data)
+            # If the file has an encoding, encode unicode with it.
+            if (
+                isinstance(fp, file)
+                and isinstance(data, unicode)
+                and fp.encoding is not None
+            ):
+                errors = getattr(fp, "errors", None)
+                if errors is None:
+                    errors = "strict"
+                data = data.encode(fp.encoding, errors)
+            fp.write(data)
+
+        want_unicode = False
+        sep = kwargs.pop("sep", None)
+        if sep is not None:
+            if isinstance(sep, unicode):
+                want_unicode = True
+            elif not isinstance(sep, str):
+                raise TypeError("sep must be None or a string")
+        end = kwargs.pop("end", None)
+        if end is not None:
+            if isinstance(end, unicode):
+                want_unicode = True
+            elif not isinstance(end, str):
+                raise TypeError("end must be None or a string")
+        if kwargs:
+            raise TypeError("invalid keyword arguments to print()")
+        if not want_unicode:
+            for arg in args:
+                if isinstance(arg, unicode):
+                    want_unicode = True
+                    break
+        if want_unicode:
+            newline = unicode("\n")
+            space = unicode(" ")
+        else:
+            newline = "\n"
+            space = " "
+        if sep is None:
+            sep = space
+        if end is None:
+            end = newline
+        for i, arg in enumerate(args):
+            if i:
+                write(sep)
+            write(arg)
+        write(end)
+
+
+if sys.version_info[:2] < (3, 3):
+    _print = print_
+
+    def print_(*args, **kwargs):
+        fp = kwargs.get("file", sys.stdout)
+        flush = kwargs.pop("flush", False)
+        _print(*args, **kwargs)
+        if flush and fp is not None:
+            fp.flush()
+
+
+_add_doc(reraise, """Reraise an exception.""")
+
+if sys.version_info[0:2] < (3, 4):
+    # This does exactly the same what the :func:`py3:functools.update_wrapper`
+    # function does on Python versions after 3.2. It sets the ``__wrapped__``
+    # attribute on ``wrapper`` object and it doesn't raise an error if any of
+    # the attributes mentioned in ``assigned`` and ``updated`` are missing on
+    # ``wrapped`` object.
+    def _update_wrapper(
+        wrapper,
+        wrapped,
+        assigned=functools.WRAPPER_ASSIGNMENTS,
+        updated=functools.WRAPPER_UPDATES,
+    ):
+        for attr in assigned:
+            try:
+                value = getattr(wrapped, attr)
+            except AttributeError:
+                continue
+            else:
+                setattr(wrapper, attr, value)
+        for attr in updated:
+            getattr(wrapper, attr).update(getattr(wrapped, attr, {}))
+        wrapper.__wrapped__ = wrapped
+        return wrapper
+
+    _update_wrapper.__doc__ = functools.update_wrapper.__doc__
+
+    def wraps(
+        wrapped,
+        assigned=functools.WRAPPER_ASSIGNMENTS,
+        updated=functools.WRAPPER_UPDATES,
+    ):
+        return functools.partial(
+            _update_wrapper, wrapped=wrapped, assigned=assigned, updated=updated
+        )
+
+    wraps.__doc__ = functools.wraps.__doc__
+
+else:
+    wraps = functools.wraps
+
+
+def with_metaclass(meta, *bases):
+    """Create a base class with a metaclass."""
+    # This requires a bit of explanation: the basic idea is to make a dummy
+    # metaclass for one level of class instantiation that replaces itself with
+    # the actual metaclass.
+    class metaclass(type):
+        def __new__(cls, name, this_bases, d):
+            if sys.version_info[:2] >= (3, 7):
+                # This version introduced PEP 560 that requires a bit
+                # of extra care (we mimic what is done by __build_class__).
+                resolved_bases = types.resolve_bases(bases)
+                if resolved_bases is not bases:
+                    d["__orig_bases__"] = bases
+            else:
+                resolved_bases = bases
+            return meta(name, resolved_bases, d)
+
+        @classmethod
+        def __prepare__(cls, name, this_bases):
+            return meta.__prepare__(name, bases)
+
+    return type.__new__(metaclass, "temporary_class", (), {})
+
+
+def add_metaclass(metaclass):
+    """Class decorator for creating a class with a metaclass."""
+
+    def wrapper(cls):
+        orig_vars = cls.__dict__.copy()
+        slots = orig_vars.get("__slots__")
+        if slots is not None:
+            if isinstance(slots, str):
+                slots = [slots]
+            for slots_var in slots:
+                orig_vars.pop(slots_var)
+        orig_vars.pop("__dict__", None)
+        orig_vars.pop("__weakref__", None)
+        if hasattr(cls, "__qualname__"):
+            orig_vars["__qualname__"] = cls.__qualname__
+        return metaclass(cls.__name__, cls.__bases__, orig_vars)
+
+    return wrapper
+
+
+def ensure_binary(s, encoding="utf-8", errors="strict"):
+    """Coerce **s** to six.binary_type.
+
+    For Python 2:
+      - `unicode` -> encoded to `str`
+      - `str` -> `str`
+
+    For Python 3:
+      - `str` -> encoded to `bytes`
+      - `bytes` -> `bytes`
+    """
+    if isinstance(s, binary_type):
+        return s
+    if isinstance(s, text_type):
+        return s.encode(encoding, errors)
+    raise TypeError("not expecting type '%s'" % type(s))
+
+
+def ensure_str(s, encoding="utf-8", errors="strict"):
+    """Coerce *s* to `str`.
+
+    For Python 2:
+      - `unicode` -> encoded to `str`
+      - `str` -> `str`
+
+    For Python 3:
+      - `str` -> `str`
+      - `bytes` -> decoded to `str`
+    """
+    # Optimization: Fast return for the common case.
+    if type(s) is str:
+        return s
+    if PY2 and isinstance(s, text_type):
+        return s.encode(encoding, errors)
+    elif PY3 and isinstance(s, binary_type):
+        return s.decode(encoding, errors)
+    elif not isinstance(s, (text_type, binary_type)):
+        raise TypeError("not expecting type '%s'" % type(s))
+    return s
+
+
+def ensure_text(s, encoding="utf-8", errors="strict"):
+    """Coerce *s* to six.text_type.
+
+    For Python 2:
+      - `unicode` -> `unicode`
+      - `str` -> `unicode`
+
+    For Python 3:
+      - `str` -> `str`
+      - `bytes` -> decoded to `str`
+    """
+    if isinstance(s, binary_type):
+        return s.decode(encoding, errors)
+    elif isinstance(s, text_type):
+        return s
+    else:
+        raise TypeError("not expecting type '%s'" % type(s))
+
+
+def python_2_unicode_compatible(klass):
+    """
+    A class decorator that defines __unicode__ and __str__ methods under Python 2.
+    Under Python 3 it does nothing.
+
+    To support Python 2 and 3 with a single code base, define a __str__ method
+    returning text and apply this decorator to the class.
+    """
+    if PY2:
+        if "__str__" not in klass.__dict__:
+            raise ValueError(
+                "@python_2_unicode_compatible cannot be applied "
+                "to %s because it doesn't define __str__()." % klass.__name__
+            )
+        klass.__unicode__ = klass.__str__
+        klass.__str__ = lambda self: self.__unicode__().encode("utf-8")
+    return klass
+
+
+# Complete the moves implementation.
+# This code is at the end of this module to speed up module loading.
+# Turn this module into a package.
+__path__ = []  # required for PEP 302 and PEP 451
+__package__ = __name__  # see PEP 366 @ReservedAssignment
+if globals().get("__spec__") is not None:
+    __spec__.submodule_search_locations = []  # PEP 451 @UndefinedVariable
+# Remove other six meta path importers, since they cause problems. This can
+# happen if six is removed from sys.modules and then reloaded. (Setuptools does
+# this for some reason.)
+if sys.meta_path:
+    for i, importer in enumerate(sys.meta_path):
+        # Here's some real nastiness: Another "instance" of the six module might
+        # be floating around. Therefore, we can't use isinstance() to check for
+        # the six meta path importer, since the other six instance will have
+        # inserted an importer with different class.
+        if (
+            type(importer).__name__ == "_SixMetaPathImporter"
+            and importer.name == __name__
+        ):
+            del sys.meta_path[i]
+            break
+    del i, importer
+# Finally, add the importer to the meta path import hook.
+sys.meta_path.append(_importer)
diff --git a/lib/urllib3/poolmanager.py b/lib/urllib3/poolmanager.py
index 02b2f622..14b10daf 100644
--- a/lib/urllib3/poolmanager.py
+++ b/lib/urllib3/poolmanager.py
@@ -1,33 +1,24 @@
-from __future__ import annotations
+from __future__ import absolute_import
 
+import collections
 import functools
 import logging
-import typing
-import warnings
-from types import TracebackType
-from urllib.parse import urljoin
 
 from ._collections import RecentlyUsedContainer
-from ._request_methods import RequestMethods
-from .connection import ProxyConfig
 from .connectionpool import HTTPConnectionPool, HTTPSConnectionPool, port_by_scheme
 from .exceptions import (
     LocationValueError,
     MaxRetryError,
     ProxySchemeUnknown,
+    ProxySchemeUnsupported,
     URLSchemeUnknown,
 )
-from .response import BaseHTTPResponse
-from .util.connection import _TYPE_SOCKET_OPTIONS
+from .packages import six
+from .packages.six.moves.urllib.parse import urljoin
+from .request import RequestMethods
 from .util.proxy import connection_requires_http_tunnel
 from .util.retry import Retry
-from .util.timeout import Timeout
-from .util.url import Url, parse_url
-
-if typing.TYPE_CHECKING:
-    import ssl
-
-    from typing_extensions import Literal
+from .util.url import parse_url
 
 __all__ = ["PoolManager", "ProxyManager", "proxy_from_url"]
 
@@ -40,61 +31,52 @@ SSL_KEYWORDS = (
     "cert_reqs",
     "ca_certs",
     "ssl_version",
-    "ssl_minimum_version",
-    "ssl_maximum_version",
     "ca_cert_dir",
     "ssl_context",
     "key_password",
     "server_hostname",
 )
-# Default value for `blocksize` - a new parameter introduced to
-# http.client.HTTPConnection & http.client.HTTPSConnection in Python 3.7
-_DEFAULT_BLOCKSIZE = 16384
 
-_SelfT = typing.TypeVar("_SelfT")
+# All known keyword arguments that could be provided to the pool manager, its
+# pools, or the underlying connections. This is used to construct a pool key.
+_key_fields = (
+    "key_scheme",  # str
+    "key_host",  # str
+    "key_port",  # int
+    "key_timeout",  # int or float or Timeout
+    "key_retries",  # int or Retry
+    "key_strict",  # bool
+    "key_block",  # bool
+    "key_source_address",  # str
+    "key_key_file",  # str
+    "key_key_password",  # str
+    "key_cert_file",  # str
+    "key_cert_reqs",  # str
+    "key_ca_certs",  # str
+    "key_ssl_version",  # str
+    "key_ca_cert_dir",  # str
+    "key_ssl_context",  # instance of ssl.SSLContext or urllib3.util.ssl_.SSLContext
+    "key_maxsize",  # int
+    "key_headers",  # dict
+    "key__proxy",  # parsed proxy url
+    "key__proxy_headers",  # dict
+    "key__proxy_config",  # class
+    "key_socket_options",  # list of (level (int), optname (int), value (int or str)) tuples
+    "key__socks_options",  # dict
+    "key_assert_hostname",  # bool or string
+    "key_assert_fingerprint",  # str
+    "key_server_hostname",  # str
+)
+
+#: The namedtuple class used to construct keys for the connection pool.
+#: All custom key schemes should include the fields in this key at a minimum.
+PoolKey = collections.namedtuple("PoolKey", _key_fields)
+
+_proxy_config_fields = ("ssl_context", "use_forwarding_for_https")
+ProxyConfig = collections.namedtuple("ProxyConfig", _proxy_config_fields)
 
 
-class PoolKey(typing.NamedTuple):
-    """
-    All known keyword arguments that could be provided to the pool manager, its
-    pools, or the underlying connections.
-
-    All custom key schemes should include the fields in this key at a minimum.
-    """
-
-    key_scheme: str
-    key_host: str
-    key_port: int | None
-    key_timeout: Timeout | float | int | None
-    key_retries: Retry | bool | int | None
-    key_block: bool | None
-    key_source_address: tuple[str, int] | None
-    key_key_file: str | None
-    key_key_password: str | None
-    key_cert_file: str | None
-    key_cert_reqs: str | None
-    key_ca_certs: str | None
-    key_ssl_version: int | str | None
-    key_ssl_minimum_version: ssl.TLSVersion | None
-    key_ssl_maximum_version: ssl.TLSVersion | None
-    key_ca_cert_dir: str | None
-    key_ssl_context: ssl.SSLContext | None
-    key_maxsize: int | None
-    key_headers: frozenset[tuple[str, str]] | None
-    key__proxy: Url | None
-    key__proxy_headers: frozenset[tuple[str, str]] | None
-    key__proxy_config: ProxyConfig | None
-    key_socket_options: _TYPE_SOCKET_OPTIONS | None
-    key__socks_options: frozenset[tuple[str, str]] | None
-    key_assert_hostname: bool | str | None
-    key_assert_fingerprint: str | None
-    key_server_hostname: str | None
-    key_blocksize: int | None
-
-
-def _default_key_normalizer(
-    key_class: type[PoolKey], request_context: dict[str, typing.Any]
-) -> PoolKey:
+def _default_key_normalizer(key_class, request_context):
     """
     Create a pool key out of a request context dictionary.
 
@@ -140,10 +122,6 @@ def _default_key_normalizer(
         if field not in context:
             context[field] = None
 
-    # Default key_blocksize to _DEFAULT_BLOCKSIZE if missing from the context
-    if context.get("key_blocksize") is None:
-        context["key_blocksize"] = _DEFAULT_BLOCKSIZE
-
     return key_class(**context)
 
 
@@ -176,36 +154,23 @@ class PoolManager(RequestMethods):
         Additional parameters are used to create fresh
         :class:`urllib3.connectionpool.ConnectionPool` instances.
 
-    Example:
+    Example::
 
-    .. code-block:: python
-
-        import urllib3
-
-        http = urllib3.PoolManager(num_pools=2)
-
-        resp1 = http.request("GET", "https://google.com/")
-        resp2 = http.request("GET", "https://google.com/mail")
-        resp3 = http.request("GET", "https://yahoo.com/")
-
-        print(len(http.pools))
-        # 2
+        >>> manager = PoolManager(num_pools=2)
+        >>> r = manager.request('GET', 'http://google.com/')
+        >>> r = manager.request('GET', 'http://google.com/mail')
+        >>> r = manager.request('GET', 'http://yahoo.com/')
+        >>> len(manager.pools)
+        2
 
     """
 
-    proxy: Url | None = None
-    proxy_config: ProxyConfig | None = None
+    proxy = None
+    proxy_config = None
 
-    def __init__(
-        self,
-        num_pools: int = 10,
-        headers: typing.Mapping[str, str] | None = None,
-        **connection_pool_kw: typing.Any,
-    ) -> None:
-        super().__init__(headers)
+    def __init__(self, num_pools=10, headers=None, **connection_pool_kw):
+        RequestMethods.__init__(self, headers)
         self.connection_pool_kw = connection_pool_kw
-
-        self.pools: RecentlyUsedContainer[PoolKey, HTTPConnectionPool]
         self.pools = RecentlyUsedContainer(num_pools)
 
         # Locally set the pool classes and keys so other PoolManagers can
@@ -213,26 +178,15 @@ class PoolManager(RequestMethods):
         self.pool_classes_by_scheme = pool_classes_by_scheme
         self.key_fn_by_scheme = key_fn_by_scheme.copy()
 
-    def __enter__(self: _SelfT) -> _SelfT:
+    def __enter__(self):
         return self
 
-    def __exit__(
-        self,
-        exc_type: type[BaseException] | None,
-        exc_val: BaseException | None,
-        exc_tb: TracebackType | None,
-    ) -> Literal[False]:
+    def __exit__(self, exc_type, exc_val, exc_tb):
         self.clear()
         # Return False to re-raise any potential exceptions
         return False
 
-    def _new_pool(
-        self,
-        scheme: str,
-        host: str,
-        port: int,
-        request_context: dict[str, typing.Any] | None = None,
-    ) -> HTTPConnectionPool:
+    def _new_pool(self, scheme, host, port, request_context=None):
         """
         Create a new :class:`urllib3.connectionpool.ConnectionPool` based on host, port, scheme, and
         any additional pool keyword arguments.
@@ -242,15 +196,10 @@ class PoolManager(RequestMethods):
         connection pools handed out by :meth:`connection_from_url` and
         companion methods. It is intended to be overridden for customization.
         """
-        pool_cls: type[HTTPConnectionPool] = self.pool_classes_by_scheme[scheme]
+        pool_cls = self.pool_classes_by_scheme[scheme]
         if request_context is None:
             request_context = self.connection_pool_kw.copy()
 
-        # Default blocksize to _DEFAULT_BLOCKSIZE if missing or explicitly
-        # set to 'None' in the request_context.
-        if request_context.get("blocksize") is None:
-            request_context["blocksize"] = _DEFAULT_BLOCKSIZE
-
         # Although the context has everything necessary to create the pool,
         # this function has historically only used the scheme, host, and port
         # in the positional args. When an API change is acceptable these can
@@ -264,7 +213,7 @@ class PoolManager(RequestMethods):
 
         return pool_cls(host, port, **request_context)
 
-    def clear(self) -> None:
+    def clear(self):
         """
         Empty our store of pools and direct them all to close.
 
@@ -273,13 +222,7 @@ class PoolManager(RequestMethods):
         """
         self.pools.clear()
 
-    def connection_from_host(
-        self,
-        host: str | None,
-        port: int | None = None,
-        scheme: str | None = "http",
-        pool_kwargs: dict[str, typing.Any] | None = None,
-    ) -> HTTPConnectionPool:
+    def connection_from_host(self, host, port=None, scheme="http", pool_kwargs=None):
         """
         Get a :class:`urllib3.connectionpool.ConnectionPool` based on the host, port, and scheme.
 
@@ -302,23 +245,13 @@ class PoolManager(RequestMethods):
 
         return self.connection_from_context(request_context)
 
-    def connection_from_context(
-        self, request_context: dict[str, typing.Any]
-    ) -> HTTPConnectionPool:
+    def connection_from_context(self, request_context):
         """
         Get a :class:`urllib3.connectionpool.ConnectionPool` based on the request context.
 
         ``request_context`` must at least contain the ``scheme`` key and its
         value must be a key in ``key_fn_by_scheme`` instance variable.
         """
-        if "strict" in request_context:
-            warnings.warn(
-                "The 'strict' parameter is no longer needed on Python 3+. "
-                "This will raise an error in urllib3 v2.1.0.",
-                DeprecationWarning,
-            )
-            request_context.pop("strict")
-
         scheme = request_context["scheme"].lower()
         pool_key_constructor = self.key_fn_by_scheme.get(scheme)
         if not pool_key_constructor:
@@ -327,9 +260,7 @@ class PoolManager(RequestMethods):
 
         return self.connection_from_pool_key(pool_key, request_context=request_context)
 
-    def connection_from_pool_key(
-        self, pool_key: PoolKey, request_context: dict[str, typing.Any]
-    ) -> HTTPConnectionPool:
+    def connection_from_pool_key(self, pool_key, request_context=None):
         """
         Get a :class:`urllib3.connectionpool.ConnectionPool` based on the provided pool key.
 
@@ -353,9 +284,7 @@ class PoolManager(RequestMethods):
 
         return pool
 
-    def connection_from_url(
-        self, url: str, pool_kwargs: dict[str, typing.Any] | None = None
-    ) -> HTTPConnectionPool:
+    def connection_from_url(self, url, pool_kwargs=None):
         """
         Similar to :func:`urllib3.connectionpool.connection_from_url`.
 
@@ -371,9 +300,7 @@ class PoolManager(RequestMethods):
             u.host, port=u.port, scheme=u.scheme, pool_kwargs=pool_kwargs
         )
 
-    def _merge_pool_kwargs(
-        self, override: dict[str, typing.Any] | None
-    ) -> dict[str, typing.Any]:
+    def _merge_pool_kwargs(self, override):
         """
         Merge a dictionary of override values for self.connection_pool_kw.
 
@@ -393,7 +320,7 @@ class PoolManager(RequestMethods):
                     base_pool_kwargs[key] = value
         return base_pool_kwargs
 
-    def _proxy_requires_url_absolute_form(self, parsed_url: Url) -> bool:
+    def _proxy_requires_url_absolute_form(self, parsed_url):
         """
         Indicates if the proxy requires the complete destination URL in the
         request.  Normally this is only needed when not using an HTTP CONNECT
@@ -406,9 +333,24 @@ class PoolManager(RequestMethods):
             self.proxy, self.proxy_config, parsed_url.scheme
         )
 
-    def urlopen(  # type: ignore[override]
-        self, method: str, url: str, redirect: bool = True, **kw: typing.Any
-    ) -> BaseHTTPResponse:
+    def _validate_proxy_scheme_url_selection(self, url_scheme):
+        """
+        Validates that were not attempting to do TLS in TLS connections on
+        Python2 or with unsupported SSL implementations.
+        """
+        if self.proxy is None or url_scheme != "https":
+            return
+
+        if self.proxy.scheme != "https":
+            return
+
+        if six.PY2 and not self.proxy_config.use_forwarding_for_https:
+            raise ProxySchemeUnsupported(
+                "Contacting HTTPS destinations through HTTPS proxies "
+                "'via CONNECT tunnels' is not supported in Python 2"
+            )
+
+    def urlopen(self, method, url, redirect=True, **kw):
         """
         Same as :meth:`urllib3.HTTPConnectionPool.urlopen`
         with custom cross-host redirect logic and only sends the request-uri
@@ -418,16 +360,7 @@ class PoolManager(RequestMethods):
         :class:`urllib3.connectionpool.ConnectionPool` can be chosen for it.
         """
         u = parse_url(url)
-
-        if u.scheme is None:
-            warnings.warn(
-                "URLs without a scheme (ie 'https://') are deprecated and will raise an error "
-                "in a future version of urllib3. To avoid this DeprecationWarning ensure all URLs "
-                "start with 'https://' or 'http://'. Read more in this issue: "
-                "https://github.com/urllib3/urllib3/issues/2920",
-                category=DeprecationWarning,
-                stacklevel=2,
-            )
+        self._validate_proxy_scheme_url_selection(u.scheme)
 
         conn = self.connection_from_host(u.host, port=u.port, scheme=u.scheme)
 
@@ -435,7 +368,7 @@ class PoolManager(RequestMethods):
         kw["redirect"] = False
 
         if "headers" not in kw:
-            kw["headers"] = self.headers
+            kw["headers"] = self.headers.copy()
 
         if self._proxy_requires_url_absolute_form(u):
             response = conn.urlopen(method, url, **kw)
@@ -463,11 +396,10 @@ class PoolManager(RequestMethods):
         if retries.remove_headers_on_redirect and not conn.is_same_host(
             redirect_location
         ):
-            new_headers = kw["headers"].copy()
-            for header in kw["headers"]:
+            headers = list(six.iterkeys(kw["headers"]))
+            for header in headers:
                 if header.lower() in retries.remove_headers_on_redirect:
-                    new_headers.pop(header, None)
-            kw["headers"] = new_headers
+                    kw["headers"].pop(header, None)
 
         try:
             retries = retries.increment(method, url, response=response, _pool=conn)
@@ -513,51 +445,37 @@ class ProxyManager(PoolManager):
         private.  IP address, target hostname, SNI, and port are always visible
         to an HTTPS proxy even when this flag is disabled.
 
-    :param proxy_assert_hostname:
-        The hostname of the certificate to verify against.
-
-    :param proxy_assert_fingerprint:
-        The fingerprint of the certificate to verify against.
-
     Example:
-
-    .. code-block:: python
-
-        import urllib3
-
-        proxy = urllib3.ProxyManager("https://localhost:3128/")
-
-        resp1 = proxy.request("GET", "https://google.com/")
-        resp2 = proxy.request("GET", "https://httpbin.org/")
-
-        print(len(proxy.pools))
-        # 1
-
-        resp3 = proxy.request("GET", "https://httpbin.org/")
-        resp4 = proxy.request("GET", "https://twitter.com/")
-
-        print(len(proxy.pools))
-        # 3
+        >>> proxy = urllib3.ProxyManager('http://localhost:3128/')
+        >>> r1 = proxy.request('GET', 'http://google.com/')
+        >>> r2 = proxy.request('GET', 'http://httpbin.org/')
+        >>> len(proxy.pools)
+        1
+        >>> r3 = proxy.request('GET', 'https://httpbin.org/')
+        >>> r4 = proxy.request('GET', 'https://twitter.com/')
+        >>> len(proxy.pools)
+        3
 
     """
 
     def __init__(
         self,
-        proxy_url: str,
-        num_pools: int = 10,
-        headers: typing.Mapping[str, str] | None = None,
-        proxy_headers: typing.Mapping[str, str] | None = None,
-        proxy_ssl_context: ssl.SSLContext | None = None,
-        use_forwarding_for_https: bool = False,
-        proxy_assert_hostname: None | str | Literal[False] = None,
-        proxy_assert_fingerprint: str | None = None,
-        **connection_pool_kw: typing.Any,
-    ) -> None:
+        proxy_url,
+        num_pools=10,
+        headers=None,
+        proxy_headers=None,
+        proxy_ssl_context=None,
+        use_forwarding_for_https=False,
+        **connection_pool_kw
+    ):
+
         if isinstance(proxy_url, HTTPConnectionPool):
-            str_proxy_url = f"{proxy_url.scheme}://{proxy_url.host}:{proxy_url.port}"
-        else:
-            str_proxy_url = proxy_url
-        proxy = parse_url(str_proxy_url)
+            proxy_url = "%s://%s:%i" % (
+                proxy_url.scheme,
+                proxy_url.host,
+                proxy_url.port,
+            )
+        proxy = parse_url(proxy_url)
 
         if proxy.scheme not in ("http", "https"):
             raise ProxySchemeUnknown(proxy.scheme)
@@ -569,38 +487,25 @@ class ProxyManager(PoolManager):
         self.proxy = proxy
         self.proxy_headers = proxy_headers or {}
         self.proxy_ssl_context = proxy_ssl_context
-        self.proxy_config = ProxyConfig(
-            proxy_ssl_context,
-            use_forwarding_for_https,
-            proxy_assert_hostname,
-            proxy_assert_fingerprint,
-        )
+        self.proxy_config = ProxyConfig(proxy_ssl_context, use_forwarding_for_https)
 
         connection_pool_kw["_proxy"] = self.proxy
         connection_pool_kw["_proxy_headers"] = self.proxy_headers
         connection_pool_kw["_proxy_config"] = self.proxy_config
 
-        super().__init__(num_pools, headers, **connection_pool_kw)
+        super(ProxyManager, self).__init__(num_pools, headers, **connection_pool_kw)
 
-    def connection_from_host(
-        self,
-        host: str | None,
-        port: int | None = None,
-        scheme: str | None = "http",
-        pool_kwargs: dict[str, typing.Any] | None = None,
-    ) -> HTTPConnectionPool:
+    def connection_from_host(self, host, port=None, scheme="http", pool_kwargs=None):
         if scheme == "https":
-            return super().connection_from_host(
+            return super(ProxyManager, self).connection_from_host(
                 host, port, scheme, pool_kwargs=pool_kwargs
             )
 
-        return super().connection_from_host(
-            self.proxy.host, self.proxy.port, self.proxy.scheme, pool_kwargs=pool_kwargs  # type: ignore[union-attr]
+        return super(ProxyManager, self).connection_from_host(
+            self.proxy.host, self.proxy.port, self.proxy.scheme, pool_kwargs=pool_kwargs
         )
 
-    def _set_proxy_headers(
-        self, url: str, headers: typing.Mapping[str, str] | None = None
-    ) -> typing.Mapping[str, str]:
+    def _set_proxy_headers(self, url, headers=None):
         """
         Sets headers needed by proxies: specifically, the Accept and Host
         headers. Only sets headers not provided by the user.
@@ -615,9 +520,7 @@ class ProxyManager(PoolManager):
             headers_.update(headers)
         return headers_
 
-    def urlopen(  # type: ignore[override]
-        self, method: str, url: str, redirect: bool = True, **kw: typing.Any
-    ) -> BaseHTTPResponse:
+    def urlopen(self, method, url, redirect=True, **kw):
         "Same as HTTP(S)ConnectionPool.urlopen, ``url`` must be absolute."
         u = parse_url(url)
         if not connection_requires_http_tunnel(self.proxy, self.proxy_config, u.scheme):
@@ -627,8 +530,8 @@ class ProxyManager(PoolManager):
             headers = kw.get("headers", self.headers)
             kw["headers"] = self._set_proxy_headers(url, headers)
 
-        return super().urlopen(method, url, redirect=redirect, **kw)
+        return super(ProxyManager, self).urlopen(method, url, redirect=redirect, **kw)
 
 
-def proxy_from_url(url: str, **kw: typing.Any) -> ProxyManager:
+def proxy_from_url(url, **kw):
     return ProxyManager(proxy_url=url, **kw)
diff --git a/lib/urllib3/py.typed b/lib/urllib3/py.typed
deleted file mode 100644
index 5f3ea3d9..00000000
--- a/lib/urllib3/py.typed
+++ /dev/null
@@ -1,2 +0,0 @@
-# Instruct type checkers to look for inline type annotations in this package.
-# See PEP 561.
diff --git a/lib/urllib3/_request_methods.py b/lib/urllib3/request.py
similarity index 63%
rename from lib/urllib3/_request_methods.py
rename to lib/urllib3/request.py
index 1d0f3465..398386a5 100644
--- a/lib/urllib3/_request_methods.py
+++ b/lib/urllib3/request.py
@@ -1,23 +1,12 @@
-from __future__ import annotations
+from __future__ import absolute_import
 
-import json as _json
-import typing
-from urllib.parse import urlencode
-
-from ._base_connection import _TYPE_BODY
-from ._collections import HTTPHeaderDict
-from .filepost import _TYPE_FIELDS, encode_multipart_formdata
-from .response import BaseHTTPResponse
+from .filepost import encode_multipart_formdata
+from .packages.six.moves.urllib.parse import urlencode
 
 __all__ = ["RequestMethods"]
 
-_TYPE_ENCODE_URL_FIELDS = typing.Union[
-    typing.Sequence[typing.Tuple[str, typing.Union[str, bytes]]],
-    typing.Mapping[str, typing.Union[str, bytes]],
-]
 
-
-class RequestMethods:
+class RequestMethods(object):
     """
     Convenience mixin for classes who implement a :meth:`urlopen` method, such
     as :class:`urllib3.HTTPConnectionPool` and
@@ -48,34 +37,25 @@ class RequestMethods:
 
     _encode_url_methods = {"DELETE", "GET", "HEAD", "OPTIONS"}
 
-    def __init__(self, headers: typing.Mapping[str, str] | None = None) -> None:
+    def __init__(self, headers=None):
         self.headers = headers or {}
 
     def urlopen(
         self,
-        method: str,
-        url: str,
-        body: _TYPE_BODY | None = None,
-        headers: typing.Mapping[str, str] | None = None,
-        encode_multipart: bool = True,
-        multipart_boundary: str | None = None,
-        **kw: typing.Any,
-    ) -> BaseHTTPResponse:  # Abstract
+        method,
+        url,
+        body=None,
+        headers=None,
+        encode_multipart=True,
+        multipart_boundary=None,
+        **kw
+    ):  # Abstract
         raise NotImplementedError(
             "Classes extending RequestMethods must implement "
             "their own ``urlopen`` method."
         )
 
-    def request(
-        self,
-        method: str,
-        url: str,
-        body: _TYPE_BODY | None = None,
-        fields: _TYPE_FIELDS | None = None,
-        headers: typing.Mapping[str, str] | None = None,
-        json: typing.Any | None = None,
-        **urlopen_kw: typing.Any,
-    ) -> BaseHTTPResponse:
+    def request(self, method, url, fields=None, headers=None, **urlopen_kw):
         """
         Make a request using :meth:`urlopen` with the appropriate encoding of
         ``fields`` based on the ``method`` used.
@@ -88,45 +68,18 @@ class RequestMethods:
         """
         method = method.upper()
 
-        if json is not None and body is not None:
-            raise TypeError(
-                "request got values for both 'body' and 'json' parameters which are mutually exclusive"
-            )
-
-        if json is not None:
-            if headers is None:
-                headers = self.headers.copy()  # type: ignore
-            if not ("content-type" in map(str.lower, headers.keys())):
-                headers["Content-Type"] = "application/json"  # type: ignore
-
-            body = _json.dumps(json, separators=(",", ":"), ensure_ascii=False).encode(
-                "utf-8"
-            )
-
-        if body is not None:
-            urlopen_kw["body"] = body
+        urlopen_kw["request_url"] = url
 
         if method in self._encode_url_methods:
             return self.request_encode_url(
-                method,
-                url,
-                fields=fields,  # type: ignore[arg-type]
-                headers=headers,
-                **urlopen_kw,
+                method, url, fields=fields, headers=headers, **urlopen_kw
             )
         else:
             return self.request_encode_body(
                 method, url, fields=fields, headers=headers, **urlopen_kw
             )
 
-    def request_encode_url(
-        self,
-        method: str,
-        url: str,
-        fields: _TYPE_ENCODE_URL_FIELDS | None = None,
-        headers: typing.Mapping[str, str] | None = None,
-        **urlopen_kw: str,
-    ) -> BaseHTTPResponse:
+    def request_encode_url(self, method, url, fields=None, headers=None, **urlopen_kw):
         """
         Make a request using :meth:`urlopen` with the ``fields`` encoded in
         the url. This is useful for request methods like GET, HEAD, DELETE, etc.
@@ -134,7 +87,7 @@ class RequestMethods:
         if headers is None:
             headers = self.headers
 
-        extra_kw: dict[str, typing.Any] = {"headers": headers}
+        extra_kw = {"headers": headers}
         extra_kw.update(urlopen_kw)
 
         if fields:
@@ -144,14 +97,14 @@ class RequestMethods:
 
     def request_encode_body(
         self,
-        method: str,
-        url: str,
-        fields: _TYPE_FIELDS | None = None,
-        headers: typing.Mapping[str, str] | None = None,
-        encode_multipart: bool = True,
-        multipart_boundary: str | None = None,
-        **urlopen_kw: str,
-    ) -> BaseHTTPResponse:
+        method,
+        url,
+        fields=None,
+        headers=None,
+        encode_multipart=True,
+        multipart_boundary=None,
+        **urlopen_kw
+    ):
         """
         Make a request using :meth:`urlopen` with the ``fields`` encoded in
         the body. This is useful for request methods like POST, PUT, PATCH, etc.
@@ -190,8 +143,7 @@ class RequestMethods:
         if headers is None:
             headers = self.headers
 
-        extra_kw: dict[str, typing.Any] = {"headers": HTTPHeaderDict(headers)}
-        body: bytes | str
+        extra_kw = {"headers": {}}
 
         if fields:
             if "body" in urlopen_kw:
@@ -205,13 +157,14 @@ class RequestMethods:
                 )
             else:
                 body, content_type = (
-                    urlencode(fields),  # type: ignore[arg-type]
+                    urlencode(fields),
                     "application/x-www-form-urlencoded",
                 )
 
             extra_kw["body"] = body
-            extra_kw["headers"].setdefault("Content-Type", content_type)
+            extra_kw["headers"] = {"Content-Type": content_type}
 
+        extra_kw["headers"].update(headers)
         extra_kw.update(urlopen_kw)
 
         return self.urlopen(method, url, **extra_kw)
diff --git a/lib/urllib3/response.py b/lib/urllib3/response.py
index 50e4d88f..0bd13d40 100644
--- a/lib/urllib3/response.py
+++ b/lib/urllib3/response.py
@@ -1,47 +1,25 @@
-from __future__ import annotations
+from __future__ import absolute_import
 
-import collections
 import io
-import json as _json
 import logging
-import re
 import sys
-import typing
 import warnings
 import zlib
 from contextlib import contextmanager
-from http.client import HTTPMessage as _HttplibHTTPMessage
-from http.client import HTTPResponse as _HttplibHTTPResponse
+from socket import error as SocketError
 from socket import timeout as SocketTimeout
 
 try:
     try:
-        import brotlicffi as brotli  # type: ignore[import]
+        import brotlicffi as brotli
     except ImportError:
-        import brotli  # type: ignore[import]
+        import brotli
 except ImportError:
     brotli = None
 
-try:
-    import zstandard as zstd  # type: ignore[import]
-
-    # The package 'zstandard' added the 'eof' property starting
-    # in v0.18.0 which we require to ensure a complete and
-    # valid zstd stream was fed into the ZstdDecoder.
-    # See: https://github.com/urllib3/urllib3/pull/2624
-    _zstd_version = _zstd_version = tuple(
-        map(int, re.search(r"^([0-9]+)\.([0-9]+)", zstd.__version__).groups())  # type: ignore[union-attr]
-    )
-    if _zstd_version < (0, 18):  # Defensive:
-        zstd = None
-
-except (AttributeError, ImportError, ValueError):  # Defensive:
-    zstd = None
-
 from . import util
-from ._base_connection import _TYPE_BODY
 from ._collections import HTTPHeaderDict
-from .connection import BaseSSLError, HTTPConnection, HTTPException
+from .connection import BaseSSLError, HTTPException
 from .exceptions import (
     BodyNotHttplibCompatible,
     DecodeError,
@@ -54,32 +32,22 @@ from .exceptions import (
     ResponseNotChunked,
     SSLError,
 )
+from .packages import six
 from .util.response import is_fp_closed, is_response_to_head
-from .util.retry import Retry
-
-if typing.TYPE_CHECKING:
-    from typing_extensions import Literal
-
-    from .connectionpool import HTTPConnectionPool
 
 log = logging.getLogger(__name__)
 
 
-class ContentDecoder:
-    def decompress(self, data: bytes) -> bytes:
-        raise NotImplementedError()
-
-    def flush(self) -> bytes:
-        raise NotImplementedError()
-
-
-class DeflateDecoder(ContentDecoder):
-    def __init__(self) -> None:
+class DeflateDecoder(object):
+    def __init__(self):
         self._first_try = True
         self._data = b""
         self._obj = zlib.decompressobj()
 
-    def decompress(self, data: bytes) -> bytes:
+    def __getattr__(self, name):
+        return getattr(self._obj, name)
+
+    def decompress(self, data):
         if not data:
             return data
 
@@ -91,7 +59,7 @@ class DeflateDecoder(ContentDecoder):
             decompressed = self._obj.decompress(data)
             if decompressed:
                 self._first_try = False
-                self._data = None  # type: ignore[assignment]
+                self._data = None
             return decompressed
         except zlib.error:
             self._first_try = False
@@ -99,24 +67,25 @@ class DeflateDecoder(ContentDecoder):
             try:
                 return self.decompress(self._data)
             finally:
-                self._data = None  # type: ignore[assignment]
-
-    def flush(self) -> bytes:
-        return self._obj.flush()
+                self._data = None
 
 
-class GzipDecoderState:
+class GzipDecoderState(object):
+
     FIRST_MEMBER = 0
     OTHER_MEMBERS = 1
     SWALLOW_DATA = 2
 
 
-class GzipDecoder(ContentDecoder):
-    def __init__(self) -> None:
+class GzipDecoder(object):
+    def __init__(self):
         self._obj = zlib.decompressobj(16 + zlib.MAX_WBITS)
         self._state = GzipDecoderState.FIRST_MEMBER
 
-    def decompress(self, data: bytes) -> bytes:
+    def __getattr__(self, name):
+        return getattr(self._obj, name)
+
+    def decompress(self, data):
         ret = bytearray()
         if self._state == GzipDecoderState.SWALLOW_DATA or not data:
             return bytes(ret)
@@ -137,53 +106,27 @@ class GzipDecoder(ContentDecoder):
             self._state = GzipDecoderState.OTHER_MEMBERS
             self._obj = zlib.decompressobj(16 + zlib.MAX_WBITS)
 
-    def flush(self) -> bytes:
-        return self._obj.flush()
-
 
 if brotli is not None:
 
-    class BrotliDecoder(ContentDecoder):
+    class BrotliDecoder(object):
         # Supports both 'brotlipy' and 'Brotli' packages
         # since they share an import name. The top branches
         # are for 'brotlipy' and bottom branches for 'Brotli'
-        def __init__(self) -> None:
+        def __init__(self):
             self._obj = brotli.Decompressor()
             if hasattr(self._obj, "decompress"):
-                setattr(self, "decompress", self._obj.decompress)
+                self.decompress = self._obj.decompress
             else:
-                setattr(self, "decompress", self._obj.process)
+                self.decompress = self._obj.process
 
-        def flush(self) -> bytes:
+        def flush(self):
             if hasattr(self._obj, "flush"):
-                return self._obj.flush()  # type: ignore[no-any-return]
+                return self._obj.flush()
             return b""
 
 
-if zstd is not None:
-
-    class ZstdDecoder(ContentDecoder):
-        def __init__(self) -> None:
-            self._obj = zstd.ZstdDecompressor().decompressobj()
-
-        def decompress(self, data: bytes) -> bytes:
-            if not data:
-                return b""
-            data_parts = [self._obj.decompress(data)]
-            while self._obj.eof and self._obj.unused_data:
-                unused_data = self._obj.unused_data
-                self._obj = zstd.ZstdDecompressor().decompressobj()
-                data_parts.append(self._obj.decompress(unused_data))
-            return b"".join(data_parts)
-
-        def flush(self) -> bytes:
-            ret = self._obj.flush()  # note: this is a no-op
-            if not self._obj.eof:
-                raise DecodeError("Zstandard data is incomplete")
-            return ret  # type: ignore[no-any-return]
-
-
-class MultiDecoder(ContentDecoder):
+class MultiDecoder(object):
     """
     From RFC7231:
         If one or more encodings have been applied to a representation, the
@@ -192,19 +135,19 @@ class MultiDecoder(ContentDecoder):
         they were applied.
     """
 
-    def __init__(self, modes: str) -> None:
+    def __init__(self, modes):
         self._decoders = [_get_decoder(m.strip()) for m in modes.split(",")]
 
-    def flush(self) -> bytes:
+    def flush(self):
         return self._decoders[0].flush()
 
-    def decompress(self, data: bytes) -> bytes:
+    def decompress(self, data):
         for d in reversed(self._decoders):
             data = d.decompress(data)
         return data
 
 
-def _get_decoder(mode: str) -> ContentDecoder:
+def _get_decoder(mode):
     if "," in mode:
         return MultiDecoder(mode)
 
@@ -214,294 +157,10 @@ def _get_decoder(mode: str) -> ContentDecoder:
     if brotli is not None and mode == "br":
         return BrotliDecoder()
 
-    if zstd is not None and mode == "zstd":
-        return ZstdDecoder()
-
     return DeflateDecoder()
 
 
-class BytesQueueBuffer:
-    """Memory-efficient bytes buffer
-
-    To return decoded data in read() and still follow the BufferedIOBase API, we need a
-    buffer to always return the correct amount of bytes.
-
-    This buffer should be filled using calls to put()
-
-    Our maximum memory usage is determined by the sum of the size of:
-
-     * self.buffer, which contains the full data
-     * the largest chunk that we will copy in get()
-
-    The worst case scenario is a single chunk, in which case we'll make a full copy of
-    the data inside get().
-    """
-
-    def __init__(self) -> None:
-        self.buffer: typing.Deque[bytes] = collections.deque()
-        self._size: int = 0
-
-    def __len__(self) -> int:
-        return self._size
-
-    def put(self, data: bytes) -> None:
-        self.buffer.append(data)
-        self._size += len(data)
-
-    def get(self, n: int) -> bytes:
-        if n == 0:
-            return b""
-        elif not self.buffer:
-            raise RuntimeError("buffer is empty")
-        elif n < 0:
-            raise ValueError("n should be > 0")
-
-        fetched = 0
-        ret = io.BytesIO()
-        while fetched < n:
-            remaining = n - fetched
-            chunk = self.buffer.popleft()
-            chunk_length = len(chunk)
-            if remaining < chunk_length:
-                left_chunk, right_chunk = chunk[:remaining], chunk[remaining:]
-                ret.write(left_chunk)
-                self.buffer.appendleft(right_chunk)
-                self._size -= remaining
-                break
-            else:
-                ret.write(chunk)
-                self._size -= chunk_length
-            fetched += chunk_length
-
-            if not self.buffer:
-                break
-
-        return ret.getvalue()
-
-
-class BaseHTTPResponse(io.IOBase):
-    CONTENT_DECODERS = ["gzip", "deflate"]
-    if brotli is not None:
-        CONTENT_DECODERS += ["br"]
-    if zstd is not None:
-        CONTENT_DECODERS += ["zstd"]
-    REDIRECT_STATUSES = [301, 302, 303, 307, 308]
-
-    DECODER_ERROR_CLASSES: tuple[type[Exception], ...] = (IOError, zlib.error)
-    if brotli is not None:
-        DECODER_ERROR_CLASSES += (brotli.error,)
-
-    if zstd is not None:
-        DECODER_ERROR_CLASSES += (zstd.ZstdError,)
-
-    def __init__(
-        self,
-        *,
-        headers: typing.Mapping[str, str] | typing.Mapping[bytes, bytes] | None = None,
-        status: int,
-        version: int,
-        reason: str | None,
-        decode_content: bool,
-        request_url: str | None,
-        retries: Retry | None = None,
-    ) -> None:
-        if isinstance(headers, HTTPHeaderDict):
-            self.headers = headers
-        else:
-            self.headers = HTTPHeaderDict(headers)  # type: ignore[arg-type]
-        self.status = status
-        self.version = version
-        self.reason = reason
-        self.decode_content = decode_content
-        self._has_decoded_content = False
-        self._request_url: str | None = request_url
-        self.retries = retries
-
-        self.chunked = False
-        tr_enc = self.headers.get("transfer-encoding", "").lower()
-        # Don't incur the penalty of creating a list and then discarding it
-        encodings = (enc.strip() for enc in tr_enc.split(","))
-        if "chunked" in encodings:
-            self.chunked = True
-
-        self._decoder: ContentDecoder | None = None
-
-    def get_redirect_location(self) -> str | None | Literal[False]:
-        """
-        Should we redirect and where to?
-
-        :returns: Truthy redirect location string if we got a redirect status
-            code and valid location. ``None`` if redirect status and no
-            location. ``False`` if not a redirect status code.
-        """
-        if self.status in self.REDIRECT_STATUSES:
-            return self.headers.get("location")
-        return False
-
-    @property
-    def data(self) -> bytes:
-        raise NotImplementedError()
-
-    def json(self) -> typing.Any:
-        """
-        Parses the body of the HTTP response as JSON.
-
-        To use a custom JSON decoder pass the result of :attr:`HTTPResponse.data` to the decoder.
-
-        This method can raise either `UnicodeDecodeError` or `json.JSONDecodeError`.
-
-        Read more :ref:`here <json>`.
-        """
-        data = self.data.decode("utf-8")
-        return _json.loads(data)
-
-    @property
-    def url(self) -> str | None:
-        raise NotImplementedError()
-
-    @url.setter
-    def url(self, url: str | None) -> None:
-        raise NotImplementedError()
-
-    @property
-    def connection(self) -> HTTPConnection | None:
-        raise NotImplementedError()
-
-    @property
-    def retries(self) -> Retry | None:
-        return self._retries
-
-    @retries.setter
-    def retries(self, retries: Retry | None) -> None:
-        # Override the request_url if retries has a redirect location.
-        if retries is not None and retries.history:
-            self.url = retries.history[-1].redirect_location
-        self._retries = retries
-
-    def stream(
-        self, amt: int | None = 2**16, decode_content: bool | None = None
-    ) -> typing.Iterator[bytes]:
-        raise NotImplementedError()
-
-    def read(
-        self,
-        amt: int | None = None,
-        decode_content: bool | None = None,
-        cache_content: bool = False,
-    ) -> bytes:
-        raise NotImplementedError()
-
-    def read_chunked(
-        self,
-        amt: int | None = None,
-        decode_content: bool | None = None,
-    ) -> typing.Iterator[bytes]:
-        raise NotImplementedError()
-
-    def release_conn(self) -> None:
-        raise NotImplementedError()
-
-    def drain_conn(self) -> None:
-        raise NotImplementedError()
-
-    def close(self) -> None:
-        raise NotImplementedError()
-
-    def _init_decoder(self) -> None:
-        """
-        Set-up the _decoder attribute if necessary.
-        """
-        # Note: content-encoding value should be case-insensitive, per RFC 7230
-        # Section 3.2
-        content_encoding = self.headers.get("content-encoding", "").lower()
-        if self._decoder is None:
-            if content_encoding in self.CONTENT_DECODERS:
-                self._decoder = _get_decoder(content_encoding)
-            elif "," in content_encoding:
-                encodings = [
-                    e.strip()
-                    for e in content_encoding.split(",")
-                    if e.strip() in self.CONTENT_DECODERS
-                ]
-                if encodings:
-                    self._decoder = _get_decoder(content_encoding)
-
-    def _decode(
-        self, data: bytes, decode_content: bool | None, flush_decoder: bool
-    ) -> bytes:
-        """
-        Decode the data passed in and potentially flush the decoder.
-        """
-        if not decode_content:
-            if self._has_decoded_content:
-                raise RuntimeError(
-                    "Calling read(decode_content=False) is not supported after "
-                    "read(decode_content=True) was called."
-                )
-            return data
-
-        try:
-            if self._decoder:
-                data = self._decoder.decompress(data)
-                self._has_decoded_content = True
-        except self.DECODER_ERROR_CLASSES as e:
-            content_encoding = self.headers.get("content-encoding", "").lower()
-            raise DecodeError(
-                "Received response with content-encoding: %s, but "
-                "failed to decode it." % content_encoding,
-                e,
-            ) from e
-        if flush_decoder:
-            data += self._flush_decoder()
-
-        return data
-
-    def _flush_decoder(self) -> bytes:
-        """
-        Flushes the decoder. Should only be called if the decoder is actually
-        being used.
-        """
-        if self._decoder:
-            return self._decoder.decompress(b"") + self._decoder.flush()
-        return b""
-
-    # Compatibility methods for `io` module
-    def readinto(self, b: bytearray) -> int:
-        temp = self.read(len(b))
-        if len(temp) == 0:
-            return 0
-        else:
-            b[: len(temp)] = temp
-            return len(temp)
-
-    # Compatibility methods for http.client.HTTPResponse
-    def getheaders(self) -> HTTPHeaderDict:
-        warnings.warn(
-            "HTTPResponse.getheaders() is deprecated and will be removed "
-            "in urllib3 v2.1.0. Instead access HTTPResponse.headers directly.",
-            category=DeprecationWarning,
-            stacklevel=2,
-        )
-        return self.headers
-
-    def getheader(self, name: str, default: str | None = None) -> str | None:
-        warnings.warn(
-            "HTTPResponse.getheader() is deprecated and will be removed "
-            "in urllib3 v2.1.0. Instead use HTTPResponse.headers.get(name, default).",
-            category=DeprecationWarning,
-            stacklevel=2,
-        )
-        return self.headers.get(name, default)
-
-    # Compatibility method for http.cookiejar
-    def info(self) -> HTTPHeaderDict:
-        return self.headers
-
-    def geturl(self) -> str | None:
-        return self.url
-
-
-class HTTPResponse(BaseHTTPResponse):
+class HTTPResponse(io.IOBase):
     """
     HTTP Response container.
 
@@ -534,74 +193,99 @@ class HTTPResponse(BaseHTTPResponse):
         value of Content-Length header, if present. Otherwise, raise error.
     """
 
+    CONTENT_DECODERS = ["gzip", "deflate"]
+    if brotli is not None:
+        CONTENT_DECODERS += ["br"]
+    REDIRECT_STATUSES = [301, 302, 303, 307, 308]
+
     def __init__(
         self,
-        body: _TYPE_BODY = "",
-        headers: typing.Mapping[str, str] | typing.Mapping[bytes, bytes] | None = None,
-        status: int = 0,
-        version: int = 0,
-        reason: str | None = None,
-        preload_content: bool = True,
-        decode_content: bool = True,
-        original_response: _HttplibHTTPResponse | None = None,
-        pool: HTTPConnectionPool | None = None,
-        connection: HTTPConnection | None = None,
-        msg: _HttplibHTTPMessage | None = None,
-        retries: Retry | None = None,
-        enforce_content_length: bool = True,
-        request_method: str | None = None,
-        request_url: str | None = None,
-        auto_close: bool = True,
-    ) -> None:
-        super().__init__(
-            headers=headers,
-            status=status,
-            version=version,
-            reason=reason,
-            decode_content=decode_content,
-            request_url=request_url,
-            retries=retries,
-        )
+        body="",
+        headers=None,
+        status=0,
+        version=0,
+        reason=None,
+        strict=0,
+        preload_content=True,
+        decode_content=True,
+        original_response=None,
+        pool=None,
+        connection=None,
+        msg=None,
+        retries=None,
+        enforce_content_length=False,
+        request_method=None,
+        request_url=None,
+        auto_close=True,
+    ):
 
+        if isinstance(headers, HTTPHeaderDict):
+            self.headers = headers
+        else:
+            self.headers = HTTPHeaderDict(headers)
+        self.status = status
+        self.version = version
+        self.reason = reason
+        self.strict = strict
+        self.decode_content = decode_content
+        self.retries = retries
         self.enforce_content_length = enforce_content_length
         self.auto_close = auto_close
 
+        self._decoder = None
         self._body = None
-        self._fp: _HttplibHTTPResponse | None = None
+        self._fp = None
         self._original_response = original_response
         self._fp_bytes_read = 0
         self.msg = msg
+        self._request_url = request_url
 
-        if body and isinstance(body, (str, bytes)):
+        if body and isinstance(body, (six.string_types, bytes)):
             self._body = body
 
         self._pool = pool
         self._connection = connection
 
         if hasattr(body, "read"):
-            self._fp = body  # type: ignore[assignment]
+            self._fp = body
 
         # Are we using the chunked-style of transfer encoding?
-        self.chunk_left: int | None = None
+        self.chunked = False
+        self.chunk_left = None
+        tr_enc = self.headers.get("transfer-encoding", "").lower()
+        # Don't incur the penalty of creating a list and then discarding it
+        encodings = (enc.strip() for enc in tr_enc.split(","))
+        if "chunked" in encodings:
+            self.chunked = True
 
         # Determine length of response
         self.length_remaining = self._init_length(request_method)
 
-        # Used to return the correct amount of bytes for partial read()s
-        self._decoded_buffer = BytesQueueBuffer()
-
         # If requested, preload the body.
         if preload_content and not self._body:
             self._body = self.read(decode_content=decode_content)
 
-    def release_conn(self) -> None:
+    def get_redirect_location(self):
+        """
+        Should we redirect and where to?
+
+        :returns: Truthy redirect location string if we got a redirect status
+            code and valid location. ``None`` if redirect status and no
+            location. ``False`` if not a redirect status code.
+        """
+        if self.status in self.REDIRECT_STATUSES:
+            return self.headers.get("location")
+
+        return False
+
+    def release_conn(self):
         if not self._pool or not self._connection:
-            return None
+            return
 
         self._pool._put_conn(self._connection)
         self._connection = None
 
-    def drain_conn(self) -> None:
+    def drain_conn(self):
         """
         Read and discard any remaining HTTP response data in the response connection.
 
@@ -609,28 +293,26 @@ class HTTPResponse(BaseHTTPResponse):
         """
         try:
             self.read()
-        except (HTTPError, OSError, BaseSSLError, HTTPException):
+        except (HTTPError, SocketError, BaseSSLError, HTTPException):
             pass
 
     @property
-    def data(self) -> bytes:
+    def data(self):
         # For backwards-compat with earlier urllib3 0.4 and earlier.
         if self._body:
-            return self._body  # type: ignore[return-value]
+            return self._body
 
         if self._fp:
             return self.read(cache_content=True)
 
-        return None  # type: ignore[return-value]
-
     @property
-    def connection(self) -> HTTPConnection | None:
+    def connection(self):
         return self._connection
 
-    def isclosed(self) -> bool:
+    def isclosed(self):
         return is_fp_closed(self._fp)
 
-    def tell(self) -> int:
+    def tell(self):
         """
         Obtain the number of bytes pulled over the wire so far. May differ from
         the amount of content returned by :meth:``urllib3.response.HTTPResponse.read``
@@ -638,14 +320,13 @@ class HTTPResponse(BaseHTTPResponse):
         """
         return self._fp_bytes_read
 
-    def _init_length(self, request_method: str | None) -> int | None:
+    def _init_length(self, request_method):
         """
         Set initial length value for Response content if available.
         """
-        length: int | None
-        content_length: str | None = self.headers.get("content-length")
+        length = self.headers.get("content-length")
 
-        if content_length is not None:
+        if length is not None:
             if self.chunked:
                 # This Response will fail with an IncompleteRead if it can't be
                 # received as chunked. This method falls back to attempt reading
@@ -665,11 +346,11 @@ class HTTPResponse(BaseHTTPResponse):
                 # (e.g. Content-Length: 42, 42). This line ensures the values
                 # are all valid ints and that as long as the `set` length is 1,
                 # all values are the same. Otherwise, the header is invalid.
-                lengths = {int(val) for val in content_length.split(",")}
+                lengths = set([int(val) for val in length.split(",")])
                 if len(lengths) > 1:
                     raise InvalidHeader(
                         "Content-Length contained multiple "
-                        "unmatching values (%s)" % content_length
+                        "unmatching values (%s)" % length
                     )
                 length = lengths.pop()
             except ValueError:
@@ -678,9 +359,6 @@ class HTTPResponse(BaseHTTPResponse):
                 if length < 0:
                     length = None
 
-        else:  # if content_length is None
-            length = None
-
         # Convert status to int for comparison
         # In some cases, httplib returns a status of "_UNKNOWN"
         try:
@@ -694,8 +372,64 @@ class HTTPResponse(BaseHTTPResponse):
 
         return length
 
+    def _init_decoder(self):
+        """
+        Set-up the _decoder attribute if necessary.
+        """
+        # Note: content-encoding value should be case-insensitive, per RFC 7230
+        # Section 3.2
+        content_encoding = self.headers.get("content-encoding", "").lower()
+        if self._decoder is None:
+            if content_encoding in self.CONTENT_DECODERS:
+                self._decoder = _get_decoder(content_encoding)
+            elif "," in content_encoding:
+                encodings = [
+                    e.strip()
+                    for e in content_encoding.split(",")
+                    if e.strip() in self.CONTENT_DECODERS
+                ]
+                if len(encodings):
+                    self._decoder = _get_decoder(content_encoding)
+
+    DECODER_ERROR_CLASSES = (IOError, zlib.error)
+    if brotli is not None:
+        DECODER_ERROR_CLASSES += (brotli.error,)
+
+    def _decode(self, data, decode_content, flush_decoder):
+        """
+        Decode the data passed in and potentially flush the decoder.
+        """
+        if not decode_content:
+            return data
+
+        try:
+            if self._decoder:
+                data = self._decoder.decompress(data)
+        except self.DECODER_ERROR_CLASSES as e:
+            content_encoding = self.headers.get("content-encoding", "").lower()
+            raise DecodeError(
+                "Received response with content-encoding: %s, but "
+                "failed to decode it." % content_encoding,
+                e,
+            )
+        if flush_decoder:
+            data += self._flush_decoder()
+
+        return data
+
+    def _flush_decoder(self):
+        """
+        Flushes the decoder. Should only be called if the decoder is actually
+        being used.
+        """
+        if self._decoder:
+            buf = self._decoder.decompress(b"")
+            return buf + self._decoder.flush()
+
+        return b""
+
     @contextmanager
-    def _error_catcher(self) -> typing.Generator[None, None, None]:
+    def _error_catcher(self):
         """
         Catch low-level python exceptions, instead re-raising urllib3
         variants, so that low-level exceptions are not leaked in the
@@ -709,22 +443,22 @@ class HTTPResponse(BaseHTTPResponse):
             try:
                 yield
 
-            except SocketTimeout as e:
+            except SocketTimeout:
                 # FIXME: Ideally we'd like to include the url in the ReadTimeoutError but
                 # there is yet no clean way to get at it from this context.
-                raise ReadTimeoutError(self._pool, None, "Read timed out.") from e  # type: ignore[arg-type]
+                raise ReadTimeoutError(self._pool, None, "Read timed out.")
 
             except BaseSSLError as e:
                 # FIXME: Is there a better way to differentiate between SSLErrors?
                 if "read operation timed out" not in str(e):
                     # SSL errors related to framing/MAC get wrapped and reraised here
-                    raise SSLError(e) from e
+                    raise SSLError(e)
 
-                raise ReadTimeoutError(self._pool, None, "Read timed out.") from e  # type: ignore[arg-type]
+                raise ReadTimeoutError(self._pool, None, "Read timed out.")
 
-            except (HTTPException, OSError) as e:
+            except (HTTPException, SocketError) as e:
                 # This includes IncompleteRead.
-                raise ProtocolError(f"Connection broken: {e!r}", e) from e
+                raise ProtocolError("Connection broken: %r" % e, e)
 
             # If no exception is thrown, we should avoid cleaning up
             # unnecessarily.
@@ -750,7 +484,7 @@ class HTTPResponse(BaseHTTPResponse):
             if self._original_response and self._original_response.isclosed():
                 self.release_conn()
 
-    def _fp_read(self, amt: int | None = None) -> bytes:
+    def _fp_read(self, amt):
         """
         Read a response with the thought that reading the number of bytes
         larger than can fit in a 32-bit int at a time via SSL in some
@@ -765,7 +499,7 @@ class HTTPResponse(BaseHTTPResponse):
           * CPython < 3.10 only when `amt` does not fit 32-bit int.
         """
         assert self._fp
-        c_int_max = 2**31 - 1
+        c_int_max = 2 ** 31 - 1
         if (
             (
                 (amt and amt > c_int_max)
@@ -781,7 +515,7 @@ class HTTPResponse(BaseHTTPResponse):
             # `c_int_max` equal to 2 GiB - 1 byte is the actual maximum
             # chunk size that does not lead to an overflow error, but
             # 256 MiB is a compromise.
-            max_chunk_amt = 2**28
+            max_chunk_amt = 2 ** 28
             while amt is None or amt != 0:
                 if amt is not None:
                     chunk_amt = min(amt, max_chunk_amt)
@@ -798,54 +532,7 @@ class HTTPResponse(BaseHTTPResponse):
             # StringIO doesn't like amt=None
             return self._fp.read(amt) if amt is not None else self._fp.read()
 
-    def _raw_read(
-        self,
-        amt: int | None = None,
-    ) -> bytes:
-        """
-        Reads `amt` of bytes from the socket.
-        """
-        if self._fp is None:
-            return None  # type: ignore[return-value]
-
-        fp_closed = getattr(self._fp, "closed", False)
-
-        with self._error_catcher():
-            data = self._fp_read(amt) if not fp_closed else b""
-            if amt is not None and amt != 0 and not data:
-                # Platform-specific: Buggy versions of Python.
-                # Close the connection when no data is returned
-                #
-                # This is redundant to what httplib/http.client _should_
-                # already do.  However, versions of python released before
-                # December 15, 2012 (http://bugs.python.org/issue16298) do
-                # not properly close the connection in all cases. There is
-                # no harm in redundantly calling close.
-                self._fp.close()
-                if (
-                    self.enforce_content_length
-                    and self.length_remaining is not None
-                    and self.length_remaining != 0
-                ):
-                    # This is an edge case that httplib failed to cover due
-                    # to concerns of backward compatibility. We're
-                    # addressing it here to make sure IncompleteRead is
-                    # raised during streaming, so all calls with incorrect
-                    # Content-Length are caught.
-                    raise IncompleteRead(self._fp_bytes_read, self.length_remaining)
-
-        if data:
-            self._fp_bytes_read += len(data)
-            if self.length_remaining is not None:
-                self.length_remaining -= len(data)
-        return data
-
-    def read(
-        self,
-        amt: int | None = None,
-        decode_content: bool | None = None,
-        cache_content: bool = False,
-    ) -> bytes:
+    def read(self, amt=None, decode_content=None, cache_content=False):
         """
         Similar to :meth:`http.client.HTTPResponse.read`, but with two additional
         parameters: ``decode_content`` and ``cache_content``.
@@ -870,54 +557,54 @@ class HTTPResponse(BaseHTTPResponse):
         if decode_content is None:
             decode_content = self.decode_content
 
-        if amt is not None:
-            cache_content = False
-
-            if len(self._decoded_buffer) >= amt:
-                return self._decoded_buffer.get(amt)
-
-        data = self._raw_read(amt)
+        if self._fp is None:
+            return
 
         flush_decoder = False
-        if amt is None:
-            flush_decoder = True
-        elif amt != 0 and not data:
-            flush_decoder = True
+        fp_closed = getattr(self._fp, "closed", False)
 
-        if not data and len(self._decoded_buffer) == 0:
-            return data
+        with self._error_catcher():
+            data = self._fp_read(amt) if not fp_closed else b""
+            if amt is None:
+                flush_decoder = True
+            else:
+                cache_content = False
+                if (
+                    amt != 0 and not data
+                ):  # Platform-specific: Buggy versions of Python.
+                    # Close the connection when no data is returned
+                    #
+                    # This is redundant to what httplib/http.client _should_
+                    # already do.  However, versions of python released before
+                    # December 15, 2012 (http://bugs.python.org/issue16298) do
+                    # not properly close the connection in all cases. There is
+                    # no harm in redundantly calling close.
+                    self._fp.close()
+                    flush_decoder = True
+                    if self.enforce_content_length and self.length_remaining not in (
+                        0,
+                        None,
+                    ):
+                        # This is an edge case that httplib failed to cover due
+                        # to concerns of backward compatibility. We're
+                        # addressing it here to make sure IncompleteRead is
+                        # raised during streaming, so all calls with incorrect
+                        # Content-Length are caught.
+                        raise IncompleteRead(self._fp_bytes_read, self.length_remaining)
+
+        if data:
+            self._fp_bytes_read += len(data)
+            if self.length_remaining is not None:
+                self.length_remaining -= len(data)
 
-        if amt is None:
             data = self._decode(data, decode_content, flush_decoder)
+
             if cache_content:
                 self._body = data
-        else:
-            # do not waste memory on buffer when not decoding
-            if not decode_content:
-                if self._has_decoded_content:
-                    raise RuntimeError(
-                        "Calling read(decode_content=False) is not supported after "
-                        "read(decode_content=True) was called."
-                    )
-                return data
-
-            decoded_data = self._decode(data, decode_content, flush_decoder)
-            self._decoded_buffer.put(decoded_data)
-
-            while len(self._decoded_buffer) < amt and data:
-                # TODO make sure to initially read enough data to get past the headers
-                # For example, the GZ file header takes 10 bytes, we don't want to read
-                # it one byte at a time
-                data = self._raw_read(amt)
-                decoded_data = self._decode(data, decode_content, flush_decoder)
-                self._decoded_buffer.put(decoded_data)
-            data = self._decoded_buffer.get(amt)
 
         return data
 
-    def stream(
-        self, amt: int | None = 2**16, decode_content: bool | None = None
-    ) -> typing.Generator[bytes, None, None]:
+    def stream(self, amt=2 ** 16, decode_content=None):
         """
         A generator wrapper for the read() method. A call will block until
         ``amt`` bytes have been read from the connection or until the
@@ -934,20 +621,73 @@ class HTTPResponse(BaseHTTPResponse):
             'content-encoding' header.
         """
         if self.chunked and self.supports_chunked_reads():
-            yield from self.read_chunked(amt, decode_content=decode_content)
+            for line in self.read_chunked(amt, decode_content=decode_content):
+                yield line
         else:
-            while not is_fp_closed(self._fp) or len(self._decoded_buffer) > 0:
+            while not is_fp_closed(self._fp):
                 data = self.read(amt=amt, decode_content=decode_content)
 
                 if data:
                     yield data
 
-    # Overrides from io.IOBase
-    def readable(self) -> bool:
-        return True
+    @classmethod
+    def from_httplib(ResponseCls, r, **response_kw):
+        """
+        Given an :class:`http.client.HTTPResponse` instance ``r``, return a
+        corresponding :class:`urllib3.response.HTTPResponse` object.
 
-    def close(self) -> None:
-        if not self.closed and self._fp:
+        Remaining parameters are passed to the HTTPResponse constructor, along
+        with ``original_response=r``.
+        """
+        headers = r.msg
+
+        if not isinstance(headers, HTTPHeaderDict):
+            if six.PY2:
+                # Python 2.7
+                headers = HTTPHeaderDict.from_httplib(headers)
+            else:
+                headers = HTTPHeaderDict(headers.items())
+
+        # HTTPResponse objects in Python 3 don't have a .strict attribute
+        strict = getattr(r, "strict", 0)
+        resp = ResponseCls(
+            body=r,
+            headers=headers,
+            status=r.status,
+            version=r.version,
+            reason=r.reason,
+            strict=strict,
+            original_response=r,
+            **response_kw
+        )
+        return resp
+
+    # Backwards-compatibility methods for http.client.HTTPResponse
+    def getheaders(self):
+        warnings.warn(
+            "HTTPResponse.getheaders() is deprecated and will be removed "
+            "in urllib3 v2.1.0. Instead access HTTPResponse.headers directly.",
+            category=DeprecationWarning,
+            stacklevel=2,
+        )
+        return self.headers
+
+    def getheader(self, name, default=None):
+        warnings.warn(
+            "HTTPResponse.getheader() is deprecated and will be removed "
+            "in urllib3 v2.1.0. Instead use HTTPResponse.headers.get(name, default).",
+            category=DeprecationWarning,
+            stacklevel=2,
+        )
+        return self.headers.get(name, default)
+
+    # Backwards compatibility for http.cookiejar
+    def info(self):
+        return self.headers
+
+    # Overrides from io.IOBase
+    def close(self):
+        if not self.closed:
             self._fp.close()
 
         if self._connection:
@@ -957,9 +697,9 @@ class HTTPResponse(BaseHTTPResponse):
             io.IOBase.close(self)
 
     @property
-    def closed(self) -> bool:
+    def closed(self):
         if not self.auto_close:
-            return io.IOBase.closed.__get__(self)  # type: ignore[no-any-return]
+            return io.IOBase.closed.__get__(self)
         elif self._fp is None:
             return True
         elif hasattr(self._fp, "isclosed"):
@@ -969,18 +709,18 @@ class HTTPResponse(BaseHTTPResponse):
         else:
             return True
 
-    def fileno(self) -> int:
+    def fileno(self):
         if self._fp is None:
-            raise OSError("HTTPResponse has no file to get a fileno from")
+            raise IOError("HTTPResponse has no file to get a fileno from")
         elif hasattr(self._fp, "fileno"):
             return self._fp.fileno()
         else:
-            raise OSError(
+            raise IOError(
                 "The file-like object this HTTPResponse is wrapped "
                 "around has no file descriptor"
             )
 
-    def flush(self) -> None:
+    def flush(self):
         if (
             self._fp is not None
             and hasattr(self._fp, "flush")
@@ -988,7 +728,20 @@ class HTTPResponse(BaseHTTPResponse):
         ):
             return self._fp.flush()
 
-    def supports_chunked_reads(self) -> bool:
+    def readable(self):
+        # This method is required for `io` module compatibility.
+        return True
+
+    def readinto(self, b):
+        # This method is required for `io` module compatibility.
+        temp = self.read(len(b))
+        if len(temp) == 0:
+            return 0
+        else:
+            b[: len(temp)] = temp
+            return len(temp)
+
+    def supports_chunked_reads(self):
         """
         Checks if the underlying file-like object looks like a
         :class:`http.client.HTTPResponse` object. We do this by testing for
@@ -997,45 +750,43 @@ class HTTPResponse(BaseHTTPResponse):
         """
         return hasattr(self._fp, "fp")
 
-    def _update_chunk_length(self) -> None:
+    def _update_chunk_length(self):
         # First, we'll figure out length of a chunk and then
         # we'll try to read it from socket.
         if self.chunk_left is not None:
-            return None
-        line = self._fp.fp.readline()  # type: ignore[union-attr]
+            return
+        line = self._fp.fp.readline()
         line = line.split(b";", 1)[0]
         try:
             self.chunk_left = int(line, 16)
         except ValueError:
             # Invalid chunked protocol response, abort.
             self.close()
-            raise InvalidChunkLength(self, line) from None
+            raise InvalidChunkLength(self, line)
 
-    def _handle_chunk(self, amt: int | None) -> bytes:
+    def _handle_chunk(self, amt):
         returned_chunk = None
         if amt is None:
-            chunk = self._fp._safe_read(self.chunk_left)  # type: ignore[union-attr]
+            chunk = self._fp._safe_read(self.chunk_left)
             returned_chunk = chunk
-            self._fp._safe_read(2)  # type: ignore[union-attr] # Toss the CRLF at the end of the chunk.
+            self._fp._safe_read(2)  # Toss the CRLF at the end of the chunk.
             self.chunk_left = None
-        elif self.chunk_left is not None and amt < self.chunk_left:
-            value = self._fp._safe_read(amt)  # type: ignore[union-attr]
+        elif amt < self.chunk_left:
+            value = self._fp._safe_read(amt)
             self.chunk_left = self.chunk_left - amt
             returned_chunk = value
         elif amt == self.chunk_left:
-            value = self._fp._safe_read(amt)  # type: ignore[union-attr]
-            self._fp._safe_read(2)  # type: ignore[union-attr] # Toss the CRLF at the end of the chunk.
+            value = self._fp._safe_read(amt)
+            self._fp._safe_read(2)  # Toss the CRLF at the end of the chunk.
             self.chunk_left = None
             returned_chunk = value
         else:  # amt > self.chunk_left
-            returned_chunk = self._fp._safe_read(self.chunk_left)  # type: ignore[union-attr]
-            self._fp._safe_read(2)  # type: ignore[union-attr] # Toss the CRLF at the end of the chunk.
+            returned_chunk = self._fp._safe_read(self.chunk_left)
+            self._fp._safe_read(2)  # Toss the CRLF at the end of the chunk.
             self.chunk_left = None
-        return returned_chunk  # type: ignore[no-any-return]
+        return returned_chunk
 
-    def read_chunked(
-        self, amt: int | None = None, decode_content: bool | None = None
-    ) -> typing.Generator[bytes, None, None]:
+    def read_chunked(self, amt=None, decode_content=None):
         """
         Similar to :meth:`HTTPResponse.read`, but with an additional
         parameter: ``decode_content``.
@@ -1066,12 +817,12 @@ class HTTPResponse(BaseHTTPResponse):
             # Don't bother reading the body of a HEAD request.
             if self._original_response and is_response_to_head(self._original_response):
                 self._original_response.close()
-                return None
+                return
 
             # If a response is already read and closed
             # then return immediately.
-            if self._fp.fp is None:  # type: ignore[union-attr]
-                return None
+            if self._fp.fp is None:
+                return
 
             while True:
                 self._update_chunk_length()
@@ -1093,7 +844,7 @@ class HTTPResponse(BaseHTTPResponse):
                     yield decoded
 
             # Chunk content ends with \r\n: discard it.
-            while self._fp is not None:
+            while True:
                 line = self._fp.fp.readline()
                 if not line:
                     # Some sites may not end with '\r\n'.
@@ -1105,29 +856,27 @@ class HTTPResponse(BaseHTTPResponse):
             if self._original_response:
                 self._original_response.close()
 
-    @property
-    def url(self) -> str | None:
+    def geturl(self):
         """
         Returns the URL that was the source of this response.
         If the request that generated this response redirected, this method
         will return the final redirect location.
         """
-        return self._request_url
+        if self.retries is not None and len(self.retries.history):
+            return self.retries.history[-1].redirect_location
+        else:
+            return self._request_url
 
-    @url.setter
-    def url(self, url: str) -> None:
-        self._request_url = url
-
-    def __iter__(self) -> typing.Iterator[bytes]:
-        buffer: list[bytes] = []
+    def __iter__(self):
+        buffer = []
         for chunk in self.stream(decode_content=True):
             if b"\n" in chunk:
-                chunks = chunk.split(b"\n")
-                yield b"".join(buffer) + chunks[0] + b"\n"
-                for x in chunks[1:-1]:
+                chunk = chunk.split(b"\n")
+                yield b"".join(buffer) + chunk[0] + b"\n"
+                for x in chunk[1:-1]:
                     yield x + b"\n"
-                if chunks[-1]:
-                    buffer = [chunks[-1]]
+                if chunk[-1]:
+                    buffer = [chunk[-1]]
                 else:
                     buffer = []
             else:
diff --git a/lib/urllib3/util/__init__.py b/lib/urllib3/util/__init__.py
index ff56c55b..4547fc52 100644
--- a/lib/urllib3/util/__init__.py
+++ b/lib/urllib3/util/__init__.py
@@ -1,41 +1,46 @@
-# For backwards compatibility, provide imports that used to be here.
-from __future__ import annotations
+from __future__ import absolute_import
 
+# For backwards compatibility, provide imports that used to be here.
 from .connection import is_connection_dropped
 from .request import SKIP_HEADER, SKIPPABLE_HEADERS, make_headers
 from .response import is_fp_closed
 from .retry import Retry
 from .ssl_ import (
     ALPN_PROTOCOLS,
+    HAS_SNI,
     IS_PYOPENSSL,
     IS_SECURETRANSPORT,
+    PROTOCOL_TLS,
     SSLContext,
     assert_fingerprint,
-    create_urllib3_context,
     resolve_cert_reqs,
     resolve_ssl_version,
     ssl_wrap_socket,
 )
-from .timeout import Timeout
-from .url import Url, parse_url
+from .timeout import Timeout, current_time
+from .url import Url, get_host, parse_url, split_first
 from .wait import wait_for_read, wait_for_write
 
 __all__ = (
+    "HAS_SNI",
     "IS_PYOPENSSL",
     "IS_SECURETRANSPORT",
     "SSLContext",
+    "PROTOCOL_TLS",
     "ALPN_PROTOCOLS",
     "Retry",
     "Timeout",
     "Url",
     "assert_fingerprint",
-    "create_urllib3_context",
+    "current_time",
     "is_connection_dropped",
     "is_fp_closed",
+    "get_host",
     "parse_url",
     "make_headers",
     "resolve_cert_reqs",
     "resolve_ssl_version",
+    "split_first",
     "ssl_wrap_socket",
     "wait_for_read",
     "wait_for_write",
diff --git a/lib/urllib3/util/connection.py b/lib/urllib3/util/connection.py
index 5c7da73f..6af1138f 100644
--- a/lib/urllib3/util/connection.py
+++ b/lib/urllib3/util/connection.py
@@ -1,23 +1,33 @@
-from __future__ import annotations
+from __future__ import absolute_import
 
 import socket
-import typing
 
+from ..contrib import _appengine_environ
 from ..exceptions import LocationParseError
-from .timeout import _DEFAULT_TIMEOUT, _TYPE_TIMEOUT
-
-_TYPE_SOCKET_OPTIONS = typing.Sequence[typing.Tuple[int, int, typing.Union[int, bytes]]]
-
-if typing.TYPE_CHECKING:
-    from .._base_connection import BaseHTTPConnection
+from ..packages import six
+from .wait import NoWayToWaitForSocketError, wait_for_read
 
 
-def is_connection_dropped(conn: BaseHTTPConnection) -> bool:  # Platform-specific
+def is_connection_dropped(conn):  # Platform-specific
     """
     Returns True if the connection is dropped and should be closed.
-    :param conn: :class:`urllib3.connection.HTTPConnection` object.
+
+    :param conn:
+        :class:`http.client.HTTPConnection` object.
+
+    Note: For platforms like AppEngine, this will always return ``False`` to
+    let the platform handle connection recycling transparently for us.
     """
-    return not conn.is_connected
+    sock = getattr(conn, "sock", False)
+    if sock is False:  # Platform-specific: AppEngine
+        return False
+    if sock is None:  # Connection already closed (such as by httplib).
+        return True
+    try:
+        # Returns True if readable, which here means it's been dropped
+        return wait_for_read(sock, timeout=0.0)
+    except NoWayToWaitForSocketError:  # Platform-specific: AppEngine
+        return False
 
 
 # This function is copied from socket.py in the Python 2.7 standard
@@ -25,11 +35,11 @@ def is_connection_dropped(conn: BaseHTTPConnection) -> bool:  # Platform-specifi
 # One additional modification is that we avoid binding to IPv6 servers
 # discovered in DNS if the system doesn't have IPv6 functionality.
 def create_connection(
-    address: tuple[str, int],
-    timeout: _TYPE_TIMEOUT = _DEFAULT_TIMEOUT,
-    source_address: tuple[str, int] | None = None,
-    socket_options: _TYPE_SOCKET_OPTIONS | None = None,
-) -> socket.socket:
+    address,
+    timeout=socket._GLOBAL_DEFAULT_TIMEOUT,
+    source_address=None,
+    socket_options=None,
+):
     """Connect to *address* and return the socket object.
 
     Convenience function.  Connect to *address* (a 2-tuple ``(host,
@@ -55,7 +65,9 @@ def create_connection(
     try:
         host.encode("idna")
     except UnicodeError:
-        raise LocationParseError(f"'{host}', label empty or too long") from None
+        return six.raise_from(
+            LocationParseError(u"'%s', label empty or too long" % host), None
+        )
 
     for res in socket.getaddrinfo(host, port, family, socket.SOCK_STREAM):
         af, socktype, proto, canonname, sa = res
@@ -66,33 +78,26 @@ def create_connection(
             # If provided, set socket level options before connecting.
             _set_socket_options(sock, socket_options)
 
-            if timeout is not _DEFAULT_TIMEOUT:
+            if timeout is not socket._GLOBAL_DEFAULT_TIMEOUT:
                 sock.settimeout(timeout)
             if source_address:
                 sock.bind(source_address)
             sock.connect(sa)
-            # Break explicitly a reference cycle
-            err = None
             return sock
 
-        except OSError as _:
-            err = _
+        except socket.error as e:
+            err = e
             if sock is not None:
                 sock.close()
+                sock = None
 
     if err is not None:
-        try:
-            raise err
-        finally:
-            # Break explicitly a reference cycle
-            err = None
-    else:
-        raise OSError("getaddrinfo returns an empty list")
+        raise err
+
+    raise socket.error("getaddrinfo returns an empty list")
 
 
-def _set_socket_options(
-    sock: socket.socket, options: _TYPE_SOCKET_OPTIONS | None
-) -> None:
+def _set_socket_options(sock, options):
     if options is None:
         return
 
@@ -100,7 +105,7 @@ def _set_socket_options(
         sock.setsockopt(*opt)
 
 
-def allowed_gai_family() -> socket.AddressFamily:
+def allowed_gai_family():
     """This function is designed to work in the context of
     getaddrinfo, where family=socket.AF_UNSPEC is the default and
     will perform a DNS search for both IPv6 and IPv4 records."""
@@ -111,11 +116,18 @@ def allowed_gai_family() -> socket.AddressFamily:
     return family
 
 
-def _has_ipv6(host: str) -> bool:
+def _has_ipv6(host):
     """Returns True if the system can bind an IPv6 address."""
     sock = None
     has_ipv6 = False
 
+    # App Engine doesn't support IPV6 sockets and actually has a quota on the
+    # number of sockets that can be used, so just early out here instead of
+    # creating a socket needlessly.
+    # See https://github.com/urllib3/urllib3/issues/1446
+    if _appengine_environ.is_appengine_sandbox():
+        return False
+
     if socket.has_ipv6:
         # has_ipv6 returns true if cPython was compiled with IPv6 support.
         # It does not tell us if the system has IPv6 support enabled. To
diff --git a/lib/urllib3/util/proxy.py b/lib/urllib3/util/proxy.py
index 908fc662..2199cc7b 100644
--- a/lib/urllib3/util/proxy.py
+++ b/lib/urllib3/util/proxy.py
@@ -1,18 +1,9 @@
-from __future__ import annotations
-
-import typing
-
-from .url import Url
-
-if typing.TYPE_CHECKING:
-    from ..connection import ProxyConfig
+from .ssl_ import create_urllib3_context, resolve_cert_reqs, resolve_ssl_version
 
 
 def connection_requires_http_tunnel(
-    proxy_url: Url | None = None,
-    proxy_config: ProxyConfig | None = None,
-    destination_scheme: str | None = None,
-) -> bool:
+    proxy_url=None, proxy_config=None, destination_scheme=None
+):
     """
     Returns True if the connection requires an HTTP CONNECT through the proxy.
 
@@ -41,3 +32,26 @@ def connection_requires_http_tunnel(
 
     # Otherwise always use a tunnel.
     return True
+
+
+def create_proxy_ssl_context(
+    ssl_version, cert_reqs, ca_certs=None, ca_cert_dir=None, ca_cert_data=None
+):
+    """
+    Generates a default proxy ssl context if one hasn't been provided by the
+    user.
+    """
+    ssl_context = create_urllib3_context(
+        ssl_version=resolve_ssl_version(ssl_version),
+        cert_reqs=resolve_cert_reqs(cert_reqs),
+    )
+
+    if (
+        not ca_certs
+        and not ca_cert_dir
+        and not ca_cert_data
+        and hasattr(ssl_context, "load_default_certs")
+    ):
+        ssl_context.load_default_certs()
+
+    return ssl_context
diff --git a/lib/urllib3/util/queue.py b/lib/urllib3/util/queue.py
new file mode 100644
index 00000000..41784104
--- /dev/null
+++ b/lib/urllib3/util/queue.py
@@ -0,0 +1,22 @@
+import collections
+
+from ..packages import six
+from ..packages.six.moves import queue
+
+if six.PY2:
+    # Queue is imported for side effects on MS Windows. See issue #229.
+    import Queue as _unused_module_Queue  # noqa: F401
+
+
+class LifoQueue(queue.Queue):
+    def _init(self, _):
+        self.queue = collections.deque()
+
+    def _qsize(self, len=len):
+        return len(self.queue)
+
+    def _put(self, item):
+        self.queue.append(item)
+
+    def _get(self):
+        return self.queue.pop()
diff --git a/lib/urllib3/util/request.py b/lib/urllib3/util/request.py
index 7d6866f3..b574b081 100644
--- a/lib/urllib3/util/request.py
+++ b/lib/urllib3/util/request.py
@@ -1,15 +1,9 @@
-from __future__ import annotations
+from __future__ import absolute_import
 
-import io
-import typing
 from base64 import b64encode
-from enum import Enum
 
 from ..exceptions import UnrewindableBodyError
-from .util import to_bytes
-
-if typing.TYPE_CHECKING:
-    from typing_extensions import Final
+from ..packages.six import b, integer_types
 
 # Pass as a value within ``headers`` to skip
 # emitting some HTTP headers that are added automatically.
@@ -21,45 +15,25 @@ SKIPPABLE_HEADERS = frozenset(["accept-encoding", "host", "user-agent"])
 ACCEPT_ENCODING = "gzip,deflate"
 try:
     try:
-        import brotlicffi as _unused_module_brotli  # type: ignore[import] # noqa: F401
+        import brotlicffi as _unused_module_brotli  # noqa: F401
     except ImportError:
-        import brotli as _unused_module_brotli  # type: ignore[import] # noqa: F401
+        import brotli as _unused_module_brotli  # noqa: F401
 except ImportError:
     pass
 else:
     ACCEPT_ENCODING += ",br"
-try:
-    import zstandard as _unused_module_zstd  # type: ignore[import] # noqa: F401
-except ImportError:
-    pass
-else:
-    ACCEPT_ENCODING += ",zstd"
 
-
-class _TYPE_FAILEDTELL(Enum):
-    token = 0
-
-
-_FAILEDTELL: Final[_TYPE_FAILEDTELL] = _TYPE_FAILEDTELL.token
-
-_TYPE_BODY_POSITION = typing.Union[int, _TYPE_FAILEDTELL]
-
-# When sending a request with these methods we aren't expecting
-# a body so don't need to set an explicit 'Content-Length: 0'
-# The reason we do this in the negative instead of tracking methods
-# which 'should' have a body is because unknown methods should be
-# treated as if they were 'POST' which *does* expect a body.
-_METHODS_NOT_EXPECTING_BODY = {"GET", "HEAD", "DELETE", "TRACE", "OPTIONS", "CONNECT"}
+_FAILEDTELL = object()
 
 
 def make_headers(
-    keep_alive: bool | None = None,
-    accept_encoding: bool | list[str] | str | None = None,
-    user_agent: str | None = None,
-    basic_auth: str | None = None,
-    proxy_basic_auth: str | None = None,
-    disable_cache: bool | None = None,
-) -> dict[str, str]:
+    keep_alive=None,
+    accept_encoding=None,
+    user_agent=None,
+    basic_auth=None,
+    proxy_basic_auth=None,
+    disable_cache=None,
+):
     """
     Shortcuts for generating request headers.
 
@@ -68,8 +42,7 @@ def make_headers(
 
     :param accept_encoding:
         Can be a boolean, list, or string.
-        ``True`` translates to 'gzip,deflate'.  If either the ``brotli`` or
-        ``brotlicffi`` package is installed 'gzip,deflate,br' is used instead.
+        ``True`` translates to 'gzip,deflate'.
         List will get joined by comma.
         String will be used as provided.
 
@@ -88,18 +61,14 @@ def make_headers(
     :param disable_cache:
         If ``True``, adds 'cache-control: no-cache' header.
 
-    Example:
+    Example::
 
-    .. code-block:: python
-
-        import urllib3
-
-        print(urllib3.util.make_headers(keep_alive=True, user_agent="Batman/1.0"))
-        # {'connection': 'keep-alive', 'user-agent': 'Batman/1.0'}
-        print(urllib3.util.make_headers(accept_encoding=True))
-        # {'accept-encoding': 'gzip,deflate'}
+        >>> make_headers(keep_alive=True, user_agent="Batman/1.0")
+        {'connection': 'keep-alive', 'user-agent': 'Batman/1.0'}
+        >>> make_headers(accept_encoding=True)
+        {'accept-encoding': 'gzip,deflate'}
     """
-    headers: dict[str, str] = {}
+    headers = {}
     if accept_encoding:
         if isinstance(accept_encoding, str):
             pass
@@ -116,14 +85,12 @@ def make_headers(
         headers["connection"] = "keep-alive"
 
     if basic_auth:
-        headers[
-            "authorization"
-        ] = f"Basic {b64encode(basic_auth.encode('latin-1')).decode()}"
+        headers["authorization"] = "Basic " + b64encode(b(basic_auth)).decode("utf-8")
 
     if proxy_basic_auth:
-        headers[
-            "proxy-authorization"
-        ] = f"Basic {b64encode(proxy_basic_auth.encode('latin-1')).decode()}"
+        headers["proxy-authorization"] = "Basic " + b64encode(
+            b(proxy_basic_auth)
+        ).decode("utf-8")
 
     if disable_cache:
         headers["cache-control"] = "no-cache"
@@ -131,9 +98,7 @@ def make_headers(
     return headers
 
 
-def set_file_position(
-    body: typing.Any, pos: _TYPE_BODY_POSITION | None
-) -> _TYPE_BODY_POSITION | None:
+def set_file_position(body, pos):
     """
     If a position is provided, move file to that point.
     Otherwise, we'll attempt to record a position for future use.
@@ -143,7 +108,7 @@ def set_file_position(
     elif getattr(body, "tell", None) is not None:
         try:
             pos = body.tell()
-        except OSError:
+        except (IOError, OSError):
             # This differentiates from None, allowing us to catch
             # a failed `tell()` later when trying to rewind the body.
             pos = _FAILEDTELL
@@ -151,7 +116,7 @@ def set_file_position(
     return pos
 
 
-def rewind_body(body: typing.IO[typing.AnyStr], body_pos: _TYPE_BODY_POSITION) -> None:
+def rewind_body(body, body_pos):
     """
     Attempt to rewind body to a certain position.
     Primarily used for request redirects and retries.
@@ -163,13 +128,13 @@ def rewind_body(body: typing.IO[typing.AnyStr], body_pos: _TYPE_BODY_POSITION) -
         Position to seek to in file.
     """
     body_seek = getattr(body, "seek", None)
-    if body_seek is not None and isinstance(body_pos, int):
+    if body_seek is not None and isinstance(body_pos, integer_types):
         try:
             body_seek(body_pos)
-        except OSError as e:
+        except (IOError, OSError):
             raise UnrewindableBodyError(
                 "An error occurred when rewinding request body for redirect/retry."
-            ) from e
+            )
     elif body_pos is _FAILEDTELL:
         raise UnrewindableBodyError(
             "Unable to record file position for rewinding "
@@ -177,80 +142,5 @@ def rewind_body(body: typing.IO[typing.AnyStr], body_pos: _TYPE_BODY_POSITION) -
         )
     else:
         raise ValueError(
-            f"body_pos must be of type integer, instead it was {type(body_pos)}."
+            "body_pos must be of type integer, instead it was %s." % type(body_pos)
         )
-
-
-class ChunksAndContentLength(typing.NamedTuple):
-    chunks: typing.Iterable[bytes] | None
-    content_length: int | None
-
-
-def body_to_chunks(
-    body: typing.Any | None, method: str, blocksize: int
-) -> ChunksAndContentLength:
-    """Takes the HTTP request method, body, and blocksize and
-    transforms them into an iterable of chunks to pass to
-    socket.sendall() and an optional 'Content-Length' header.
-
-    A 'Content-Length' of 'None' indicates the length of the body
-    can't be determined so should use 'Transfer-Encoding: chunked'
-    for framing instead.
-    """
-
-    chunks: typing.Iterable[bytes] | None
-    content_length: int | None
-
-    # No body, we need to make a recommendation on 'Content-Length'
-    # based on whether that request method is expected to have
-    # a body or not.
-    if body is None:
-        chunks = None
-        if method.upper() not in _METHODS_NOT_EXPECTING_BODY:
-            content_length = 0
-        else:
-            content_length = None
-
-    # Bytes or strings become bytes
-    elif isinstance(body, (str, bytes)):
-        chunks = (to_bytes(body),)
-        content_length = len(chunks[0])
-
-    # File-like object, TODO: use seek() and tell() for length?
-    elif hasattr(body, "read"):
-
-        def chunk_readable() -> typing.Iterable[bytes]:
-            nonlocal body, blocksize
-            encode = isinstance(body, io.TextIOBase)
-            while True:
-                datablock = body.read(blocksize)
-                if not datablock:
-                    break
-                if encode:
-                    datablock = datablock.encode("iso-8859-1")
-                yield datablock
-
-        chunks = chunk_readable()
-        content_length = None
-
-    # Otherwise we need to start checking via duck-typing.
-    else:
-        try:
-            # Check if the body implements the buffer API.
-            mv = memoryview(body)
-        except TypeError:
-            try:
-                # Check if the body is an iterable
-                chunks = iter(body)
-                content_length = None
-            except TypeError:
-                raise TypeError(
-                    f"'body' must be a bytes-like object, file-like "
-                    f"object, or iterable. Instead was {body!r}"
-                ) from None
-        else:
-            # Since it implements the buffer API can be passed directly to socket.sendall()
-            chunks = (body,)
-            content_length = mv.nbytes
-
-    return ChunksAndContentLength(chunks=chunks, content_length=content_length)
diff --git a/lib/urllib3/util/response.py b/lib/urllib3/util/response.py
index 0f457869..5ea609cc 100644
--- a/lib/urllib3/util/response.py
+++ b/lib/urllib3/util/response.py
@@ -1,12 +1,12 @@
-from __future__ import annotations
+from __future__ import absolute_import
 
-import http.client as httplib
 from email.errors import MultipartInvariantViolationDefect, StartBoundaryNotFoundDefect
 
 from ..exceptions import HeaderParsingError
+from ..packages.six.moves import http_client as httplib
 
 
-def is_fp_closed(obj: object) -> bool:
+def is_fp_closed(obj):
     """
     Checks whether a given file-like object is closed.
 
@@ -17,27 +17,27 @@ def is_fp_closed(obj: object) -> bool:
     try:
         # Check `isclosed()` first, in case Python3 doesn't set `closed`.
         # GH Issue #928
-        return obj.isclosed()  # type: ignore[no-any-return, attr-defined]
+        return obj.isclosed()
     except AttributeError:
         pass
 
     try:
         # Check via the official file-like-object way.
-        return obj.closed  # type: ignore[no-any-return, attr-defined]
+        return obj.closed
     except AttributeError:
         pass
 
     try:
         # Check if the object is a container for another file-like object that
         # gets released on exhaustion (e.g. HTTPResponse).
-        return obj.fp is None  # type: ignore[attr-defined]
+        return obj.fp is None
     except AttributeError:
         pass
 
     raise ValueError("Unable to determine whether fp is closed.")
 
 
-def assert_header_parsing(headers: httplib.HTTPMessage) -> None:
+def assert_header_parsing(headers):
     """
     Asserts whether all headers have been successfully parsed.
     Extracts encountered errors from the result of parsing headers.
@@ -53,49 +53,55 @@ def assert_header_parsing(headers: httplib.HTTPMessage) -> None:
     # This will fail silently if we pass in the wrong kind of parameter.
     # To make debugging easier add an explicit check.
     if not isinstance(headers, httplib.HTTPMessage):
-        raise TypeError(f"expected httplib.Message, got {type(headers)}.")
+        raise TypeError("expected httplib.Message, got {0}.".format(type(headers)))
+
+    defects = getattr(headers, "defects", None)
+    get_payload = getattr(headers, "get_payload", None)
 
     unparsed_data = None
+    if get_payload:
+        # get_payload is actually email.message.Message.get_payload;
+        # we're only interested in the result if it's not a multipart message
+        if not headers.is_multipart():
+            payload = get_payload()
 
-    # get_payload is actually email.message.Message.get_payload;
-    # we're only interested in the result if it's not a multipart message
-    if not headers.is_multipart():
-        payload = headers.get_payload()
+            if isinstance(payload, (bytes, str)):
+                unparsed_data = payload
+    if defects:
+        # httplib is assuming a response body is available
+        # when parsing headers even when httplib only sends
+        # header data to parse_headers() This results in
+        # defects on multipart responses in particular.
+        # See: https://github.com/urllib3/urllib3/issues/800
 
-        if isinstance(payload, (bytes, str)):
-            unparsed_data = payload
-
-    # httplib is assuming a response body is available
-    # when parsing headers even when httplib only sends
-    # header data to parse_headers() This results in
-    # defects on multipart responses in particular.
-    # See: https://github.com/urllib3/urllib3/issues/800
-
-    # So we ignore the following defects:
-    # - StartBoundaryNotFoundDefect:
-    #     The claimed start boundary was never found.
-    # - MultipartInvariantViolationDefect:
-    #     A message claimed to be a multipart but no subparts were found.
-    defects = [
-        defect
-        for defect in headers.defects
-        if not isinstance(
-            defect, (StartBoundaryNotFoundDefect, MultipartInvariantViolationDefect)
-        )
-    ]
+        # So we ignore the following defects:
+        # - StartBoundaryNotFoundDefect:
+        #     The claimed start boundary was never found.
+        # - MultipartInvariantViolationDefect:
+        #     A message claimed to be a multipart but no subparts were found.
+        defects = [
+            defect
+            for defect in defects
+            if not isinstance(
+                defect, (StartBoundaryNotFoundDefect, MultipartInvariantViolationDefect)
+            )
+        ]
 
     if defects or unparsed_data:
         raise HeaderParsingError(defects=defects, unparsed_data=unparsed_data)
 
 
-def is_response_to_head(response: httplib.HTTPResponse) -> bool:
+def is_response_to_head(response):
     """
     Checks whether the request of a response has been a HEAD-request.
+    Handles the quirks of AppEngine.
 
     :param http.client.HTTPResponse response:
         Response to check if the originating request
         used 'HEAD' as a method.
     """
     # FIXME: Can we do this somehow without accessing private httplib _method?
-    method_str = response._method  # type: str  # type: ignore[attr-defined]
-    return method_str.upper() == "HEAD"
+    method = response._method
+    if isinstance(method, int):  # Platform-specific: Appengine
+        return method == 3
+    return method.upper() == "HEAD"
diff --git a/lib/urllib3/util/retry.py b/lib/urllib3/util/retry.py
index ea48afe3..2490d5e5 100644
--- a/lib/urllib3/util/retry.py
+++ b/lib/urllib3/util/retry.py
@@ -1,13 +1,12 @@
-from __future__ import annotations
+from __future__ import absolute_import
 
 import email
 import logging
-import random
 import re
 import time
-import typing
+import warnings
+from collections import namedtuple
 from itertools import takewhile
-from types import TracebackType
 
 from ..exceptions import (
     ConnectTimeoutError,
@@ -18,49 +17,97 @@ from ..exceptions import (
     ReadTimeoutError,
     ResponseError,
 )
-from .util import reraise
-
-if typing.TYPE_CHECKING:
-    from ..connectionpool import ConnectionPool
-    from ..response import BaseHTTPResponse
+from ..packages import six
 
 log = logging.getLogger(__name__)
 
 
 # Data structure for representing the metadata of requests that result in a retry.
-class RequestHistory(typing.NamedTuple):
-    method: str | None
-    url: str | None
-    error: Exception | None
-    status: int | None
-    redirect_location: str | None
+RequestHistory = namedtuple(
+    "RequestHistory", ["method", "url", "error", "status", "redirect_location"]
+)
 
 
-class Retry:
+# TODO: In v2 we can remove this sentinel and metaclass with deprecated options.
+_Default = object()
+
+
+class _RetryMeta(type):
+    @property
+    def DEFAULT_METHOD_WHITELIST(cls):
+        warnings.warn(
+            "Using 'Retry.DEFAULT_METHOD_WHITELIST' is deprecated and "
+            "will be removed in v2.0. Use 'Retry.DEFAULT_ALLOWED_METHODS' instead",
+            DeprecationWarning,
+        )
+        return cls.DEFAULT_ALLOWED_METHODS
+
+    @DEFAULT_METHOD_WHITELIST.setter
+    def DEFAULT_METHOD_WHITELIST(cls, value):
+        warnings.warn(
+            "Using 'Retry.DEFAULT_METHOD_WHITELIST' is deprecated and "
+            "will be removed in v2.0. Use 'Retry.DEFAULT_ALLOWED_METHODS' instead",
+            DeprecationWarning,
+        )
+        cls.DEFAULT_ALLOWED_METHODS = value
+
+    @property
+    def DEFAULT_REDIRECT_HEADERS_BLACKLIST(cls):
+        warnings.warn(
+            "Using 'Retry.DEFAULT_REDIRECT_HEADERS_BLACKLIST' is deprecated and "
+            "will be removed in v2.0. Use 'Retry.DEFAULT_REMOVE_HEADERS_ON_REDIRECT' instead",
+            DeprecationWarning,
+        )
+        return cls.DEFAULT_REMOVE_HEADERS_ON_REDIRECT
+
+    @DEFAULT_REDIRECT_HEADERS_BLACKLIST.setter
+    def DEFAULT_REDIRECT_HEADERS_BLACKLIST(cls, value):
+        warnings.warn(
+            "Using 'Retry.DEFAULT_REDIRECT_HEADERS_BLACKLIST' is deprecated and "
+            "will be removed in v2.0. Use 'Retry.DEFAULT_REMOVE_HEADERS_ON_REDIRECT' instead",
+            DeprecationWarning,
+        )
+        cls.DEFAULT_REMOVE_HEADERS_ON_REDIRECT = value
+
+    @property
+    def BACKOFF_MAX(cls):
+        warnings.warn(
+            "Using 'Retry.BACKOFF_MAX' is deprecated and "
+            "will be removed in v2.0. Use 'Retry.DEFAULT_BACKOFF_MAX' instead",
+            DeprecationWarning,
+        )
+        return cls.DEFAULT_BACKOFF_MAX
+
+    @BACKOFF_MAX.setter
+    def BACKOFF_MAX(cls, value):
+        warnings.warn(
+            "Using 'Retry.BACKOFF_MAX' is deprecated and "
+            "will be removed in v2.0. Use 'Retry.DEFAULT_BACKOFF_MAX' instead",
+            DeprecationWarning,
+        )
+        cls.DEFAULT_BACKOFF_MAX = value
+
+
+@six.add_metaclass(_RetryMeta)
+class Retry(object):
     """Retry configuration.
 
     Each retry attempt will create a new Retry object with updated values, so
     they can be safely reused.
 
-    Retries can be defined as a default for a pool:
-
-    .. code-block:: python
+    Retries can be defined as a default for a pool::
 
         retries = Retry(connect=5, read=2, redirect=5)
         http = PoolManager(retries=retries)
-        response = http.request("GET", "https://example.com/")
+        response = http.request('GET', 'http://example.com/')
 
-    Or per-request (which overrides the default for the pool):
+    Or per-request (which overrides the default for the pool)::
 
-    .. code-block:: python
+        response = http.request('GET', 'http://example.com/', retries=Retry(10))
 
-        response = http.request("GET", "https://example.com/", retries=Retry(10))
+    Retries can be disabled by passing ``False``::
 
-    Retries can be disabled by passing ``False``:
-
-    .. code-block:: python
-
-        response = http.request("GET", "https://example.com/", retries=False)
+        response = http.request('GET', 'http://example.com/', retries=False)
 
     Errors will be wrapped in :class:`~urllib3.exceptions.MaxRetryError` unless
     retries are disabled, in which case the causing exception will be raised.
@@ -122,16 +169,21 @@ class Retry:
         If ``total`` is not set, it's a good idea to set this to 0 to account
         for unexpected edge cases and avoid infinite retry loops.
 
-    :param Collection allowed_methods:
+    :param iterable allowed_methods:
         Set of uppercased HTTP method verbs that we should retry on.
 
         By default, we only retry on methods which are considered to be
         idempotent (multiple requests with the same parameters end with the
         same state). See :attr:`Retry.DEFAULT_ALLOWED_METHODS`.
 
-        Set to a ``None`` value to retry on any verb.
+        Set to a ``False`` value to retry on any verb.
 
-    :param Collection status_forcelist:
+        .. warning::
+
+            Previously this parameter was named ``method_whitelist``, that
+            usage is deprecated in v1.26.0 and will be removed in v2.0.
+
+    :param iterable status_forcelist:
         A set of integer HTTP status codes that we should force a retry on.
         A retry is initiated if the request method is in ``allowed_methods``
         and the response status code is in ``status_forcelist``.
@@ -143,17 +195,13 @@ class Retry:
         (most errors are resolved immediately by a second try without a
         delay). urllib3 will sleep for::
 
-            {backoff factor} * (2 ** ({number of previous retries}))
+            {backoff factor} * (2 ** ({number of total retries} - 1))
 
-        seconds. If `backoff_jitter` is non-zero, this sleep is extended by::
+        seconds. If the backoff_factor is 0.1, then :func:`.sleep` will sleep
+        for [0.0s, 0.2s, 0.4s, ...] between retries. It will never be longer
+        than :attr:`Retry.DEFAULT_BACKOFF_MAX`.
 
-            random.uniform(0, {backoff jitter})
-
-        seconds. For example, if the backoff_factor is 0.1, then :func:`Retry.sleep` will
-        sleep for [0.0s, 0.2s, 0.4s, 0.8s, ...] between retries. No backoff will ever
-        be longer than `backoff_max`.
-
-        By default, backoff is disabled (factor set to 0).
+        By default, backoff is disabled (set to 0).
 
     :param bool raise_on_redirect: Whether, if the number of redirects is
         exhausted, to raise a MaxRetryError, or to return a response with a
@@ -172,7 +220,7 @@ class Retry:
         Whether to respect Retry-After header on status codes defined as
         :attr:`Retry.RETRY_AFTER_STATUS_CODES` or not.
 
-    :param Collection remove_headers_on_redirect:
+    :param iterable remove_headers_on_redirect:
         Sequence of headers to remove from the request when a response
         indicating a redirect is returned before firing off the redirected
         request.
@@ -189,33 +237,48 @@ class Retry:
     #: Default headers to be used for ``remove_headers_on_redirect``
     DEFAULT_REMOVE_HEADERS_ON_REDIRECT = frozenset(["Authorization"])
 
-    #: Default maximum backoff time.
+    #: Maximum backoff time.
     DEFAULT_BACKOFF_MAX = 120
 
-    # Backward compatibility; assigned outside of the class.
-    DEFAULT: typing.ClassVar[Retry]
-
     def __init__(
         self,
-        total: bool | int | None = 10,
-        connect: int | None = None,
-        read: int | None = None,
-        redirect: bool | int | None = None,
-        status: int | None = None,
-        other: int | None = None,
-        allowed_methods: typing.Collection[str] | None = DEFAULT_ALLOWED_METHODS,
-        status_forcelist: typing.Collection[int] | None = None,
-        backoff_factor: float = 0,
-        backoff_max: float = DEFAULT_BACKOFF_MAX,
-        raise_on_redirect: bool = True,
-        raise_on_status: bool = True,
-        history: tuple[RequestHistory, ...] | None = None,
-        respect_retry_after_header: bool = True,
-        remove_headers_on_redirect: typing.Collection[
-            str
-        ] = DEFAULT_REMOVE_HEADERS_ON_REDIRECT,
-        backoff_jitter: float = 0.0,
-    ) -> None:
+        total=10,
+        connect=None,
+        read=None,
+        redirect=None,
+        status=None,
+        other=None,
+        allowed_methods=_Default,
+        status_forcelist=None,
+        backoff_factor=0,
+        raise_on_redirect=True,
+        raise_on_status=True,
+        history=None,
+        respect_retry_after_header=True,
+        remove_headers_on_redirect=_Default,
+        # TODO: Deprecated, remove in v2.0
+        method_whitelist=_Default,
+    ):
+
+        if method_whitelist is not _Default:
+            if allowed_methods is not _Default:
+                raise ValueError(
+                    "Using both 'allowed_methods' and "
+                    "'method_whitelist' together is not allowed. "
+                    "Instead only use 'allowed_methods'"
+                )
+            warnings.warn(
+                "Using 'method_whitelist' with Retry is deprecated and "
+                "will be removed in v2.0. Use 'allowed_methods' instead",
+                DeprecationWarning,
+                stacklevel=2,
+            )
+            allowed_methods = method_whitelist
+        if allowed_methods is _Default:
+            allowed_methods = self.DEFAULT_ALLOWED_METHODS
+        if remove_headers_on_redirect is _Default:
+            remove_headers_on_redirect = self.DEFAULT_REMOVE_HEADERS_ON_REDIRECT
+
         self.total = total
         self.connect = connect
         self.read = read
@@ -230,17 +293,15 @@ class Retry:
         self.status_forcelist = status_forcelist or set()
         self.allowed_methods = allowed_methods
         self.backoff_factor = backoff_factor
-        self.backoff_max = backoff_max
         self.raise_on_redirect = raise_on_redirect
         self.raise_on_status = raise_on_status
-        self.history = history or ()
+        self.history = history or tuple()
         self.respect_retry_after_header = respect_retry_after_header
         self.remove_headers_on_redirect = frozenset(
-            h.lower() for h in remove_headers_on_redirect
+            [h.lower() for h in remove_headers_on_redirect]
         )
-        self.backoff_jitter = backoff_jitter
 
-    def new(self, **kw: typing.Any) -> Retry:
+    def new(self, **kw):
         params = dict(
             total=self.total,
             connect=self.connect,
@@ -248,28 +309,36 @@ class Retry:
             redirect=self.redirect,
             status=self.status,
             other=self.other,
-            allowed_methods=self.allowed_methods,
             status_forcelist=self.status_forcelist,
             backoff_factor=self.backoff_factor,
-            backoff_max=self.backoff_max,
             raise_on_redirect=self.raise_on_redirect,
             raise_on_status=self.raise_on_status,
             history=self.history,
             remove_headers_on_redirect=self.remove_headers_on_redirect,
             respect_retry_after_header=self.respect_retry_after_header,
-            backoff_jitter=self.backoff_jitter,
         )
 
+        # TODO: If already given in **kw we use what's given to us
+        # If not given we need to figure out what to pass. We decide
+        # based on whether our class has the 'method_whitelist' property
+        # and if so we pass the deprecated 'method_whitelist' otherwise
+        # we use 'allowed_methods'. Remove in v2.0
+        if "method_whitelist" not in kw and "allowed_methods" not in kw:
+            if "method_whitelist" in self.__dict__:
+                warnings.warn(
+                    "Using 'method_whitelist' with Retry is deprecated and "
+                    "will be removed in v2.0. Use 'allowed_methods' instead",
+                    DeprecationWarning,
+                )
+                params["method_whitelist"] = self.allowed_methods
+            else:
+                params["allowed_methods"] = self.allowed_methods
+
         params.update(kw)
-        return type(self)(**params)  # type: ignore[arg-type]
+        return type(self)(**params)
 
     @classmethod
-    def from_int(
-        cls,
-        retries: Retry | bool | int | None,
-        redirect: bool | int | None = True,
-        default: Retry | bool | int | None = None,
-    ) -> Retry:
+    def from_int(cls, retries, redirect=True, default=None):
         """Backwards-compatibility for the old retries format."""
         if retries is None:
             retries = default if default is not None else cls.DEFAULT
@@ -282,7 +351,7 @@ class Retry:
         log.debug("Converted retries value: %r -> %r", retries, new_retries)
         return new_retries
 
-    def get_backoff_time(self) -> float:
+    def get_backoff_time(self):
         """Formula for computing the current backoff
 
         :rtype: float
@@ -297,28 +366,32 @@ class Retry:
             return 0
 
         backoff_value = self.backoff_factor * (2 ** (consecutive_errors_len - 1))
-        if self.backoff_jitter != 0.0:
-            backoff_value += random.random() * self.backoff_jitter
-        return float(max(0, min(self.backoff_max, backoff_value)))
+        return min(self.DEFAULT_BACKOFF_MAX, backoff_value)
 
-    def parse_retry_after(self, retry_after: str) -> float:
-        seconds: float
+    def parse_retry_after(self, retry_after):
         # Whitespace: https://tools.ietf.org/html/rfc7230#section-3.2.4
         if re.match(r"^\s*[0-9]+\s*$", retry_after):
             seconds = int(retry_after)
         else:
             retry_date_tuple = email.utils.parsedate_tz(retry_after)
             if retry_date_tuple is None:
-                raise InvalidHeader(f"Invalid Retry-After header: {retry_after}")
+                raise InvalidHeader("Invalid Retry-After header: %s" % retry_after)
+            if retry_date_tuple[9] is None:  # Python 2
+                # Assume UTC if no timezone was specified
+                # On Python2.7, parsedate_tz returns None for a timezone offset
+                # instead of 0 if no timezone is given, where mktime_tz treats
+                # a None timezone offset as local time.
+                retry_date_tuple = retry_date_tuple[:9] + (0,) + retry_date_tuple[10:]
 
             retry_date = email.utils.mktime_tz(retry_date_tuple)
             seconds = retry_date - time.time()
 
-        seconds = max(seconds, 0)
+        if seconds < 0:
+            seconds = 0
 
         return seconds
 
-    def get_retry_after(self, response: BaseHTTPResponse) -> float | None:
+    def get_retry_after(self, response):
         """Get the value of Retry-After in seconds."""
 
         retry_after = response.headers.get("Retry-After")
@@ -328,7 +401,7 @@ class Retry:
 
         return self.parse_retry_after(retry_after)
 
-    def sleep_for_retry(self, response: BaseHTTPResponse) -> bool:
+    def sleep_for_retry(self, response=None):
         retry_after = self.get_retry_after(response)
         if retry_after:
             time.sleep(retry_after)
@@ -336,13 +409,13 @@ class Retry:
 
         return False
 
-    def _sleep_backoff(self) -> None:
+    def _sleep_backoff(self):
         backoff = self.get_backoff_time()
         if backoff <= 0:
             return
         time.sleep(backoff)
 
-    def sleep(self, response: BaseHTTPResponse | None = None) -> None:
+    def sleep(self, response=None):
         """Sleep between retry attempts.
 
         This method will respect a server's ``Retry-After`` response header
@@ -358,7 +431,7 @@ class Retry:
 
         self._sleep_backoff()
 
-    def _is_connection_error(self, err: Exception) -> bool:
+    def _is_connection_error(self, err):
         """Errors when we're fairly sure that the server did not receive the
         request, so it should be safe to retry.
         """
@@ -366,23 +439,33 @@ class Retry:
             err = err.original_error
         return isinstance(err, ConnectTimeoutError)
 
-    def _is_read_error(self, err: Exception) -> bool:
+    def _is_read_error(self, err):
         """Errors that occur after the request has been started, so we should
         assume that the server began processing it.
         """
         return isinstance(err, (ReadTimeoutError, ProtocolError))
 
-    def _is_method_retryable(self, method: str) -> bool:
+    def _is_method_retryable(self, method):
         """Checks if a given HTTP method should be retried upon, depending if
         it is included in the allowed_methods
         """
-        if self.allowed_methods and method.upper() not in self.allowed_methods:
+        # TODO: For now favor if the Retry implementation sets its own method_whitelist
+        # property outside of our constructor to avoid breaking custom implementations.
+        if "method_whitelist" in self.__dict__:
+            warnings.warn(
+                "Using 'method_whitelist' with Retry is deprecated and "
+                "will be removed in v2.0. Use 'allowed_methods' instead",
+                DeprecationWarning,
+            )
+            allowed_methods = self.method_whitelist
+        else:
+            allowed_methods = self.allowed_methods
+
+        if allowed_methods and method.upper() not in allowed_methods:
             return False
         return True
 
-    def is_retry(
-        self, method: str, status_code: int, has_retry_after: bool = False
-    ) -> bool:
+    def is_retry(self, method, status_code, has_retry_after=False):
         """Is this method/status code retryable? (Based on allowlists and control
         variables such as the number of total retries to allow, whether to
         respect the Retry-After header, whether this header is present, and
@@ -395,27 +478,24 @@ class Retry:
         if self.status_forcelist and status_code in self.status_forcelist:
             return True
 
-        return bool(
+        return (
             self.total
             and self.respect_retry_after_header
             and has_retry_after
             and (status_code in self.RETRY_AFTER_STATUS_CODES)
         )
 
-    def is_exhausted(self) -> bool:
+    def is_exhausted(self):
         """Are we out of retries?"""
-        retry_counts = [
-            x
-            for x in (
-                self.total,
-                self.connect,
-                self.read,
-                self.redirect,
-                self.status,
-                self.other,
-            )
-            if x
-        ]
+        retry_counts = (
+            self.total,
+            self.connect,
+            self.read,
+            self.redirect,
+            self.status,
+            self.other,
+        )
+        retry_counts = list(filter(None, retry_counts))
         if not retry_counts:
             return False
 
@@ -423,18 +503,18 @@ class Retry:
 
     def increment(
         self,
-        method: str | None = None,
-        url: str | None = None,
-        response: BaseHTTPResponse | None = None,
-        error: Exception | None = None,
-        _pool: ConnectionPool | None = None,
-        _stacktrace: TracebackType | None = None,
-    ) -> Retry:
+        method=None,
+        url=None,
+        response=None,
+        error=None,
+        _pool=None,
+        _stacktrace=None,
+    ):
         """Return a new Retry object with incremented retry counters.
 
         :param response: A response object, or None, if the server did not
             return a response.
-        :type response: :class:`~urllib3.response.BaseHTTPResponse`
+        :type response: :class:`~urllib3.response.HTTPResponse`
         :param Exception error: An error encountered during the request, or
             None if the response was received successfully.
 
@@ -442,7 +522,7 @@ class Retry:
         """
         if self.total is False and error:
             # Disabled, indicate to re-raise the error.
-            raise reraise(type(error), error, _stacktrace)
+            raise six.reraise(type(error), error, _stacktrace)
 
         total = self.total
         if total is not None:
@@ -460,14 +540,14 @@ class Retry:
         if error and self._is_connection_error(error):
             # Connect retry?
             if connect is False:
-                raise reraise(type(error), error, _stacktrace)
+                raise six.reraise(type(error), error, _stacktrace)
             elif connect is not None:
                 connect -= 1
 
         elif error and self._is_read_error(error):
             # Read retry?
-            if read is False or method is None or not self._is_method_retryable(method):
-                raise reraise(type(error), error, _stacktrace)
+            if read is False or not self._is_method_retryable(method):
+                raise six.reraise(type(error), error, _stacktrace)
             elif read is not None:
                 read -= 1
 
@@ -481,9 +561,7 @@ class Retry:
             if redirect is not None:
                 redirect -= 1
             cause = "too many redirects"
-            response_redirect_location = response.get_redirect_location()
-            if response_redirect_location:
-                redirect_location = response_redirect_location
+            redirect_location = response.get_redirect_location()
             status = response.status
 
         else:
@@ -511,18 +589,31 @@ class Retry:
         )
 
         if new_retry.is_exhausted():
-            reason = error or ResponseError(cause)
-            raise MaxRetryError(_pool, url, reason) from reason  # type: ignore[arg-type]
+            raise MaxRetryError(_pool, url, error or ResponseError(cause))
 
         log.debug("Incremented Retry for (url='%s'): %r", url, new_retry)
 
         return new_retry
 
-    def __repr__(self) -> str:
+    def __repr__(self):
         return (
-            f"{type(self).__name__}(total={self.total}, connect={self.connect}, "
-            f"read={self.read}, redirect={self.redirect}, status={self.status})"
-        )
+            "{cls.__name__}(total={self.total}, connect={self.connect}, "
+            "read={self.read}, redirect={self.redirect}, status={self.status})"
+        ).format(cls=type(self), self=self)
+
+    def __getattr__(self, item):
+        if item == "method_whitelist":
+            # TODO: Remove this deprecated alias in v2.0
+            warnings.warn(
+                "Using 'method_whitelist' with Retry is deprecated and "
+                "will be removed in v2.0. Use 'allowed_methods' instead",
+                DeprecationWarning,
+            )
+            return self.allowed_methods
+        try:
+            return getattr(super(Retry, self), item)
+        except AttributeError:
+            return getattr(Retry, item)
 
 
 # For backwards compatibility (equivalent to pre-v1.9):
diff --git a/lib/urllib3/util/ssl_.py b/lib/urllib3/util/ssl_.py
index 77628032..8f867812 100644
--- a/lib/urllib3/util/ssl_.py
+++ b/lib/urllib3/util/ssl_.py
@@ -1,152 +1,185 @@
-from __future__ import annotations
+from __future__ import absolute_import
 
 import hmac
 import os
-import socket
 import sys
-import typing
 import warnings
-from binascii import unhexlify
+from binascii import hexlify, unhexlify
 from hashlib import md5, sha1, sha256
 
-from ..exceptions import ProxySchemeUnsupported, SSLError
-from .url import _BRACELESS_IPV6_ADDRZ_RE, _IPV4_RE
+from ..exceptions import (
+    InsecurePlatformWarning,
+    ProxySchemeUnsupported,
+    SNIMissingWarning,
+    SSLError,
+)
+from ..packages import six
+from .url import BRACELESS_IPV6_ADDRZ_RE, IPV4_RE
 
 SSLContext = None
 SSLTransport = None
-HAS_NEVER_CHECK_COMMON_NAME = False
+HAS_SNI = False
 IS_PYOPENSSL = False
 IS_SECURETRANSPORT = False
 ALPN_PROTOCOLS = ["http/1.1"]
 
-_TYPE_VERSION_INFO = typing.Tuple[int, int, int, str, int]
-
 # Maps the length of a digest to a possible hash function producing this digest
 HASHFUNC_MAP = {32: md5, 40: sha1, 64: sha256}
 
 
-def _is_bpo_43522_fixed(
-    implementation_name: str,
-    version_info: _TYPE_VERSION_INFO,
-    pypy_version_info: _TYPE_VERSION_INFO | None,
-) -> bool:
-    """Return True for CPython 3.8.9+, 3.9.3+ or 3.10+ and PyPy 7.3.8+ where
-    setting SSLContext.hostname_checks_common_name to False works.
-
-    Outside of CPython and PyPy we don't know which implementations work
-    or not so we conservatively use our hostname matching as we know that works
-    on all implementations.
-
-    https://github.com/urllib3/urllib3/issues/2192#issuecomment-821832963
-    https://foss.heptapod.net/pypy/pypy/-/issues/3539
+def _const_compare_digest_backport(a, b):
     """
-    if implementation_name == "pypy":
-        # https://foss.heptapod.net/pypy/pypy/-/issues/3129
-        return pypy_version_info >= (7, 3, 8) and version_info >= (3, 8)  # type: ignore[operator]
-    elif implementation_name == "cpython":
-        major_minor = version_info[:2]
-        micro = version_info[2]
-        return (
-            (major_minor == (3, 8) and micro >= 9)
-            or (major_minor == (3, 9) and micro >= 3)
-            or major_minor >= (3, 10)
-        )
-    else:  # Defensive:
-        return False
+    Compare two digests of equal length in constant time.
+
+    The digests must be of type str/bytes.
+    Returns True if the digests match, and False otherwise.
+    """
+    result = abs(len(a) - len(b))
+    for left, right in zip(bytearray(a), bytearray(b)):
+        result |= left ^ right
+    return result == 0
 
 
-def _is_has_never_check_common_name_reliable(
-    openssl_version: str,
-    openssl_version_number: int,
-    implementation_name: str,
-    version_info: _TYPE_VERSION_INFO,
-    pypy_version_info: _TYPE_VERSION_INFO | None,
-) -> bool:
-    # As of May 2023, all released versions of LibreSSL fail to reject certificates with
-    # only common names, see https://github.com/urllib3/urllib3/pull/3024
-    is_openssl = openssl_version.startswith("OpenSSL ")
-    # Before fixing OpenSSL issue #14579, the SSL_new() API was not copying hostflags
-    # like X509_CHECK_FLAG_NEVER_CHECK_SUBJECT, which tripped up CPython.
-    # https://github.com/openssl/openssl/issues/14579
-    # This was released in OpenSSL 1.1.1l+ (>=0x101010cf)
-    is_openssl_issue_14579_fixed = openssl_version_number >= 0x101010CF
+_const_compare_digest = getattr(hmac, "compare_digest", _const_compare_digest_backport)
 
-    return is_openssl and (
-        is_openssl_issue_14579_fixed
-        or _is_bpo_43522_fixed(implementation_name, version_info, pypy_version_info)
-    )
-
-
-if typing.TYPE_CHECKING:
-    from ssl import VerifyMode
-
-    from typing_extensions import Literal, TypedDict
-
-    from .ssltransport import SSLTransport as SSLTransportType
-
-    class _TYPE_PEER_CERT_RET_DICT(TypedDict, total=False):
-        subjectAltName: tuple[tuple[str, str], ...]
-        subject: tuple[tuple[tuple[str, str], ...], ...]
-        serialNumber: str
-
-
-# Mapping from 'ssl.PROTOCOL_TLSX' to 'TLSVersion.X'
-_SSL_VERSION_TO_TLS_VERSION: dict[int, int] = {}
-
-try:  # Do we have ssl at all?
+try:  # Test for SSL features
     import ssl
-    from ssl import (  # type: ignore[assignment]
-        CERT_REQUIRED,
-        HAS_NEVER_CHECK_COMMON_NAME,
-        OP_NO_COMPRESSION,
-        OP_NO_TICKET,
-        OPENSSL_VERSION,
-        OPENSSL_VERSION_NUMBER,
-        PROTOCOL_TLS,
-        PROTOCOL_TLS_CLIENT,
-        OP_NO_SSLv2,
-        OP_NO_SSLv3,
-        SSLContext,
-        TLSVersion,
-    )
+    from ssl import CERT_REQUIRED, wrap_socket
+except ImportError:
+    pass
+
+try:
+    from ssl import HAS_SNI  # Has SNI?
+except ImportError:
+    pass
+
+try:
+    from .ssltransport import SSLTransport
+except ImportError:
+    pass
+
+
+try:  # Platform-specific: Python 3.6
+    from ssl import PROTOCOL_TLS
 
     PROTOCOL_SSLv23 = PROTOCOL_TLS
-
-    # Setting SSLContext.hostname_checks_common_name = False didn't work before CPython
-    # 3.8.9, 3.9.3, and 3.10 (but OK on PyPy) or OpenSSL 1.1.1l+
-    if HAS_NEVER_CHECK_COMMON_NAME and not _is_has_never_check_common_name_reliable(
-        OPENSSL_VERSION,
-        OPENSSL_VERSION_NUMBER,
-        sys.implementation.name,
-        sys.version_info,
-        sys.pypy_version_info if sys.implementation.name == "pypy" else None,  # type: ignore[attr-defined]
-    ):
-        HAS_NEVER_CHECK_COMMON_NAME = False
-
-    # Need to be careful here in case old TLS versions get
-    # removed in future 'ssl' module implementations.
-    for attr in ("TLSv1", "TLSv1_1", "TLSv1_2"):
-        try:
-            _SSL_VERSION_TO_TLS_VERSION[getattr(ssl, f"PROTOCOL_{attr}")] = getattr(
-                TLSVersion, attr
-            )
-        except AttributeError:  # Defensive:
-            continue
-
-    from .ssltransport import SSLTransport  # type: ignore[assignment]
 except ImportError:
-    OP_NO_COMPRESSION = 0x20000  # type: ignore[assignment]
-    OP_NO_TICKET = 0x4000  # type: ignore[assignment]
-    OP_NO_SSLv2 = 0x1000000  # type: ignore[assignment]
-    OP_NO_SSLv3 = 0x2000000  # type: ignore[assignment]
-    PROTOCOL_SSLv23 = PROTOCOL_TLS = 2  # type: ignore[assignment]
-    PROTOCOL_TLS_CLIENT = 16  # type: ignore[assignment]
+    try:
+        from ssl import PROTOCOL_SSLv23 as PROTOCOL_TLS
+
+        PROTOCOL_SSLv23 = PROTOCOL_TLS
+    except ImportError:
+        PROTOCOL_SSLv23 = PROTOCOL_TLS = 2
+
+try:
+    from ssl import PROTOCOL_TLS_CLIENT
+except ImportError:
+    PROTOCOL_TLS_CLIENT = PROTOCOL_TLS
 
 
-_TYPE_PEER_CERT_RET = typing.Union["_TYPE_PEER_CERT_RET_DICT", bytes, None]
+try:
+    from ssl import OP_NO_COMPRESSION, OP_NO_SSLv2, OP_NO_SSLv3
+except ImportError:
+    OP_NO_SSLv2, OP_NO_SSLv3 = 0x1000000, 0x2000000
+    OP_NO_COMPRESSION = 0x20000
 
 
-def assert_fingerprint(cert: bytes | None, fingerprint: str) -> None:
+try:  # OP_NO_TICKET was added in Python 3.6
+    from ssl import OP_NO_TICKET
+except ImportError:
+    OP_NO_TICKET = 0x4000
+
+
+# A secure default.
+# Sources for more information on TLS ciphers:
+#
+# - https://wiki.mozilla.org/Security/Server_Side_TLS
+# - https://www.ssllabs.com/projects/best-practices/index.html
+# - https://hynek.me/articles/hardening-your-web-servers-ssl-ciphers/
+#
+# The general intent is:
+# - prefer cipher suites that offer perfect forward secrecy (DHE/ECDHE),
+# - prefer ECDHE over DHE for better performance,
+# - prefer any AES-GCM and ChaCha20 over any AES-CBC for better performance and
+#   security,
+# - prefer AES-GCM over ChaCha20 because hardware-accelerated AES is common,
+# - disable NULL authentication, MD5 MACs, DSS, and other
+#   insecure ciphers for security reasons.
+# - NOTE: TLS 1.3 cipher suites are managed through a different interface
+#   not exposed by CPython (yet!) and are enabled by default if they're available.
+DEFAULT_CIPHERS = ":".join(
+    [
+        "ECDHE+AESGCM",
+        "ECDHE+CHACHA20",
+        "DHE+AESGCM",
+        "DHE+CHACHA20",
+        "ECDH+AESGCM",
+        "DH+AESGCM",
+        "ECDH+AES",
+        "DH+AES",
+        "RSA+AESGCM",
+        "RSA+AES",
+        "!aNULL",
+        "!eNULL",
+        "!MD5",
+        "!DSS",
+    ]
+)
+
+try:
+    from ssl import SSLContext  # Modern SSL?
+except ImportError:
+
+    class SSLContext(object):  # Platform-specific: Python 2
+        def __init__(self, protocol_version):
+            self.protocol = protocol_version
+            # Use default values from a real SSLContext
+            self.check_hostname = False
+            self.verify_mode = ssl.CERT_NONE
+            self.ca_certs = None
+            self.options = 0
+            self.certfile = None
+            self.keyfile = None
+            self.ciphers = None
+
+        def load_cert_chain(self, certfile, keyfile):
+            self.certfile = certfile
+            self.keyfile = keyfile
+
+        def load_verify_locations(self, cafile=None, capath=None, cadata=None):
+            self.ca_certs = cafile
+
+            if capath is not None:
+                raise SSLError("CA directories not supported in older Pythons")
+
+            if cadata is not None:
+                raise SSLError("CA data not supported in older Pythons")
+
+        def set_ciphers(self, cipher_suite):
+            self.ciphers = cipher_suite
+
+        def wrap_socket(self, socket, server_hostname=None, server_side=False):
+            warnings.warn(
+                "A true SSLContext object is not available. This prevents "
+                "urllib3 from configuring SSL appropriately and may cause "
+                "certain SSL connections to fail. You can upgrade to a newer "
+                "version of Python to solve this. For more information, see "
+                "https://urllib3.readthedocs.io/en/1.26.x/advanced-usage.html"
+                "#ssl-warnings",
+                InsecurePlatformWarning,
+            )
+            kwargs = {
+                "keyfile": self.keyfile,
+                "certfile": self.certfile,
+                "ca_certs": self.ca_certs,
+                "cert_reqs": self.verify_mode,
+                "ssl_version": self.protocol,
+                "server_side": server_side,
+            }
+            return wrap_socket(socket, ciphers=self.ciphers, **kwargs)
+
+
+def assert_fingerprint(cert, fingerprint):
     """
     Checks if given fingerprint matches the supplied certificate.
 
@@ -156,27 +189,26 @@ def assert_fingerprint(cert: bytes | None, fingerprint: str) -> None:
         Fingerprint as string of hexdigits, can be interspersed by colons.
     """
 
-    if cert is None:
-        raise SSLError("No certificate for the peer.")
-
     fingerprint = fingerprint.replace(":", "").lower()
     digest_length = len(fingerprint)
     hashfunc = HASHFUNC_MAP.get(digest_length)
     if not hashfunc:
-        raise SSLError(f"Fingerprint of invalid length: {fingerprint}")
+        raise SSLError("Fingerprint of invalid length: {0}".format(fingerprint))
 
     # We need encode() here for py32; works on py2 and p33.
     fingerprint_bytes = unhexlify(fingerprint.encode())
 
     cert_digest = hashfunc(cert).digest()
 
-    if not hmac.compare_digest(cert_digest, fingerprint_bytes):
+    if not _const_compare_digest(cert_digest, fingerprint_bytes):
         raise SSLError(
-            f'Fingerprints did not match. Expected "{fingerprint}", got "{cert_digest.hex()}"'
+            'Fingerprints did not match. Expected "{0}", got "{1}".'.format(
+                fingerprint, hexlify(cert_digest)
+            )
         )
 
 
-def resolve_cert_reqs(candidate: None | int | str) -> VerifyMode:
+def resolve_cert_reqs(candidate):
     """
     Resolves the argument to a numeric constant, which can be passed to
     the wrap_socket function/method from the ssl module.
@@ -194,12 +226,12 @@ def resolve_cert_reqs(candidate: None | int | str) -> VerifyMode:
         res = getattr(ssl, candidate, None)
         if res is None:
             res = getattr(ssl, "CERT_" + candidate)
-        return res  # type: ignore[no-any-return]
+        return res
 
-    return candidate  # type: ignore[return-value]
+    return candidate
 
 
-def resolve_ssl_version(candidate: None | int | str) -> int:
+def resolve_ssl_version(candidate):
     """
     like resolve_cert_reqs
     """
@@ -210,33 +242,35 @@ def resolve_ssl_version(candidate: None | int | str) -> int:
         res = getattr(ssl, candidate, None)
         if res is None:
             res = getattr(ssl, "PROTOCOL_" + candidate)
-        return typing.cast(int, res)
+        return res
 
     return candidate
 
 
 def create_urllib3_context(
-    ssl_version: int | None = None,
-    cert_reqs: int | None = None,
-    options: int | None = None,
-    ciphers: str | None = None,
-    ssl_minimum_version: int | None = None,
-    ssl_maximum_version: int | None = None,
-) -> ssl.SSLContext:
-    """Creates and configures an :class:`ssl.SSLContext` instance for use with urllib3.
+    ssl_version=None, cert_reqs=None, options=None, ciphers=None
+):
+    """All arguments have the same meaning as ``ssl_wrap_socket``.
+
+    By default, this function does a lot of the same work that
+    ``ssl.create_default_context`` does on Python 3.4+. It:
+
+    - Disables SSLv2, SSLv3, and compression
+    - Sets a restricted set of server ciphers
+
+    If you wish to enable SSLv3, you can do::
+
+        from urllib3.util import ssl_
+        context = ssl_.create_urllib3_context()
+        context.options &= ~ssl_.OP_NO_SSLv3
+
+    You can do the same to enable compression (substituting ``COMPRESSION``
+    for ``SSLv3`` in the last line above).
 
     :param ssl_version:
         The desired protocol version to use. This will default to
         PROTOCOL_SSLv23 which will negotiate the highest protocol that both
         the server and your installation of OpenSSL support.
-
-        This parameter is deprecated instead use 'ssl_minimum_version'.
-    :param ssl_minimum_version:
-        The minimum version of TLS to be used. Use the 'ssl.TLSVersion' enum for specifying the value.
-    :param ssl_maximum_version:
-        The maximum version of TLS to be used. Use the 'ssl.TLSVersion' enum for specifying the value.
-        Not recommended to set to anything other than 'ssl.TLSVersion.MAXIMUM_SUPPORTED' which is the
-        default value.
     :param cert_reqs:
         Whether to require the certificate verification. This defaults to
         ``ssl.CERT_REQUIRED``.
@@ -244,60 +278,18 @@ def create_urllib3_context(
         Specific OpenSSL options. These default to ``ssl.OP_NO_SSLv2``,
         ``ssl.OP_NO_SSLv3``, ``ssl.OP_NO_COMPRESSION``, and ``ssl.OP_NO_TICKET``.
     :param ciphers:
-        Which cipher suites to allow the server to select. Defaults to either system configured
-        ciphers if OpenSSL 1.1.1+, otherwise uses a secure default set of ciphers.
+        Which cipher suites to allow the server to select.
     :returns:
         Constructed SSLContext object with specified options
     :rtype: SSLContext
     """
-    if SSLContext is None:
-        raise TypeError("Can't create an SSLContext object without an ssl module")
+    # PROTOCOL_TLS is deprecated in Python 3.10
+    if not ssl_version or ssl_version == PROTOCOL_TLS:
+        ssl_version = PROTOCOL_TLS_CLIENT
 
-    # This means 'ssl_version' was specified as an exact value.
-    if ssl_version not in (None, PROTOCOL_TLS, PROTOCOL_TLS_CLIENT):
-        # Disallow setting 'ssl_version' and 'ssl_minimum|maximum_version'
-        # to avoid conflicts.
-        if ssl_minimum_version is not None or ssl_maximum_version is not None:
-            raise ValueError(
-                "Can't specify both 'ssl_version' and either "
-                "'ssl_minimum_version' or 'ssl_maximum_version'"
-            )
+    context = SSLContext(ssl_version)
 
-        # 'ssl_version' is deprecated and will be removed in the future.
-        else:
-            # Use 'ssl_minimum_version' and 'ssl_maximum_version' instead.
-            ssl_minimum_version = _SSL_VERSION_TO_TLS_VERSION.get(
-                ssl_version, TLSVersion.MINIMUM_SUPPORTED
-            )
-            ssl_maximum_version = _SSL_VERSION_TO_TLS_VERSION.get(
-                ssl_version, TLSVersion.MAXIMUM_SUPPORTED
-            )
-
-            # This warning message is pushing users to use 'ssl_minimum_version'
-            # instead of both min/max. Best practice is to only set the minimum version and
-            # keep the maximum version to be it's default value: 'TLSVersion.MAXIMUM_SUPPORTED'
-            warnings.warn(
-                "'ssl_version' option is deprecated and will be "
-                "removed in urllib3 v2.1.0. Instead use 'ssl_minimum_version'",
-                category=DeprecationWarning,
-                stacklevel=2,
-            )
-
-    # PROTOCOL_TLS is deprecated in Python 3.10 so we always use PROTOCOL_TLS_CLIENT
-    context = SSLContext(PROTOCOL_TLS_CLIENT)
-
-    if ssl_minimum_version is not None:
-        context.minimum_version = ssl_minimum_version
-    else:  # Python <3.10 defaults to 'MINIMUM_SUPPORTED' so explicitly set TLSv1.2 here
-        context.minimum_version = TLSVersion.TLSv1_2
-
-    if ssl_maximum_version is not None:
-        context.maximum_version = ssl_maximum_version
-
-    # Unless we're given ciphers defer to either system ciphers in
-    # the case of OpenSSL 1.1.1+ or use our own secure default ciphers.
-    if ciphers:
-        context.set_ciphers(ciphers)
+    context.set_ciphers(ciphers or DEFAULT_CIPHERS)
 
     # Setting the default here, as we may have no ssl module on import
     cert_reqs = ssl.CERT_REQUIRED if cert_reqs is None else cert_reqs
@@ -330,23 +322,26 @@ def create_urllib3_context(
     ) is not None:
         context.post_handshake_auth = True
 
+    def disable_check_hostname():
+        if (
+            getattr(context, "check_hostname", None) is not None
+        ):  # Platform-specific: Python 3.2
+            # We do our own verification, including fingerprints and alternative
+            # hostnames. So disable it here
+            context.check_hostname = False
+
     # The order of the below lines setting verify_mode and check_hostname
     # matter due to safe-guards SSLContext has to prevent an SSLContext with
-    # check_hostname=True, verify_mode=NONE/OPTIONAL.
-    # We always set 'check_hostname=False' for pyOpenSSL so we rely on our own
-    # 'ssl.match_hostname()' implementation.
-    if cert_reqs == ssl.CERT_REQUIRED and not IS_PYOPENSSL:
+    # check_hostname=True, verify_mode=NONE/OPTIONAL. This is made even more
+    # complex because we don't know whether PROTOCOL_TLS_CLIENT will be used
+    # or not so we don't know the initial state of the freshly created SSLContext.
+    if cert_reqs == ssl.CERT_REQUIRED:
         context.verify_mode = cert_reqs
-        context.check_hostname = True
+        disable_check_hostname()
     else:
-        context.check_hostname = False
+        disable_check_hostname()
         context.verify_mode = cert_reqs
 
-    try:
-        context.hostname_checks_common_name = False
-    except AttributeError:  # Defensive: for CPython < 3.8.9 and 3.9.3; for PyPy < 7.3.8
-        pass
-
     # Enable logging of TLS session keys via defacto standard environment variable
     # 'SSLKEYLOGFILE', if the feature is available (Python 3.8+). Skip empty values.
     if hasattr(context, "keylog_filename"):
@@ -357,59 +352,21 @@ def create_urllib3_context(
     return context
 
 
-@typing.overload
 def ssl_wrap_socket(
-    sock: socket.socket,
-    keyfile: str | None = ...,
-    certfile: str | None = ...,
-    cert_reqs: int | None = ...,
-    ca_certs: str | None = ...,
-    server_hostname: str | None = ...,
-    ssl_version: int | None = ...,
-    ciphers: str | None = ...,
-    ssl_context: ssl.SSLContext | None = ...,
-    ca_cert_dir: str | None = ...,
-    key_password: str | None = ...,
-    ca_cert_data: None | str | bytes = ...,
-    tls_in_tls: Literal[False] = ...,
-) -> ssl.SSLSocket:
-    ...
-
-
-@typing.overload
-def ssl_wrap_socket(
-    sock: socket.socket,
-    keyfile: str | None = ...,
-    certfile: str | None = ...,
-    cert_reqs: int | None = ...,
-    ca_certs: str | None = ...,
-    server_hostname: str | None = ...,
-    ssl_version: int | None = ...,
-    ciphers: str | None = ...,
-    ssl_context: ssl.SSLContext | None = ...,
-    ca_cert_dir: str | None = ...,
-    key_password: str | None = ...,
-    ca_cert_data: None | str | bytes = ...,
-    tls_in_tls: bool = ...,
-) -> ssl.SSLSocket | SSLTransportType:
-    ...
-
-
-def ssl_wrap_socket(
-    sock: socket.socket,
-    keyfile: str | None = None,
-    certfile: str | None = None,
-    cert_reqs: int | None = None,
-    ca_certs: str | None = None,
-    server_hostname: str | None = None,
-    ssl_version: int | None = None,
-    ciphers: str | None = None,
-    ssl_context: ssl.SSLContext | None = None,
-    ca_cert_dir: str | None = None,
-    key_password: str | None = None,
-    ca_cert_data: None | str | bytes = None,
-    tls_in_tls: bool = False,
-) -> ssl.SSLSocket | SSLTransportType:
+    sock,
+    keyfile=None,
+    certfile=None,
+    cert_reqs=None,
+    ca_certs=None,
+    server_hostname=None,
+    ssl_version=None,
+    ciphers=None,
+    ssl_context=None,
+    ca_cert_dir=None,
+    key_password=None,
+    ca_cert_data=None,
+    tls_in_tls=False,
+):
     """
     All arguments except for server_hostname, ssl_context, and ca_cert_dir have
     the same meaning as they do when using :func:`ssl.wrap_socket`.
@@ -435,18 +392,19 @@ def ssl_wrap_socket(
     """
     context = ssl_context
     if context is None:
-        # Note: This branch of code and all the variables in it are only used in tests.
-        # We should consider deprecating and removing this code.
+        # Note: This branch of code and all the variables in it are no longer
+        # used by urllib3 itself. We should consider deprecating and removing
+        # this code.
         context = create_urllib3_context(ssl_version, cert_reqs, ciphers=ciphers)
 
     if ca_certs or ca_cert_dir or ca_cert_data:
         try:
             context.load_verify_locations(ca_certs, ca_cert_dir, ca_cert_data)
-        except OSError as e:
-            raise SSLError(e) from e
+        except (IOError, OSError) as e:
+            raise SSLError(e)
 
     elif ssl_context is None and hasattr(context, "load_default_certs"):
-        # try to load OS default certs; works well on Windows.
+        # try to load OS default certs; works well on Windows (require Python3.4+)
         context.load_default_certs()
 
     # Attempt to detect if we get the goofy behavior of the
@@ -462,30 +420,56 @@ def ssl_wrap_socket(
             context.load_cert_chain(certfile, keyfile, key_password)
 
     try:
-        context.set_alpn_protocols(ALPN_PROTOCOLS)
+        if hasattr(context, "set_alpn_protocols"):
+            context.set_alpn_protocols(ALPN_PROTOCOLS)
     except NotImplementedError:  # Defensive: in CI, we always have set_alpn_protocols
         pass
 
-    ssl_sock = _ssl_wrap_socket_impl(sock, context, tls_in_tls, server_hostname)
+    # If we detect server_hostname is an IP address then the SNI
+    # extension should not be used according to RFC3546 Section 3.1
+    use_sni_hostname = server_hostname and not is_ipaddress(server_hostname)
+    # SecureTransport uses server_hostname in certificate verification.
+    send_sni = (use_sni_hostname and HAS_SNI) or (
+        IS_SECURETRANSPORT and server_hostname
+    )
+    # Do not warn the user if server_hostname is an invalid SNI hostname.
+    if not HAS_SNI and use_sni_hostname:
+        warnings.warn(
+            "An HTTPS request has been made, but the SNI (Server Name "
+            "Indication) extension to TLS is not available on this platform. "
+            "This may cause the server to present an incorrect TLS "
+            "certificate, which can cause validation failures. You can upgrade to "
+            "a newer version of Python to solve this. For more information, see "
+            "https://urllib3.readthedocs.io/en/1.26.x/advanced-usage.html"
+            "#ssl-warnings",
+            SNIMissingWarning,
+        )
+
+    if send_sni:
+        ssl_sock = _ssl_wrap_socket_impl(
+            sock, context, tls_in_tls, server_hostname=server_hostname
+        )
+    else:
+        ssl_sock = _ssl_wrap_socket_impl(sock, context, tls_in_tls)
     return ssl_sock
 
 
-def is_ipaddress(hostname: str | bytes) -> bool:
+def is_ipaddress(hostname):
     """Detects whether the hostname given is an IPv4 or IPv6 address.
     Also detects IPv6 addresses with Zone IDs.
 
     :param str hostname: Hostname to examine.
     :return: True if the hostname is an IP address, False otherwise.
     """
-    if isinstance(hostname, bytes):
+    if not six.PY2 and isinstance(hostname, bytes):
         # IDN A-label bytes are ASCII compatible.
         hostname = hostname.decode("ascii")
-    return bool(_IPV4_RE.match(hostname) or _BRACELESS_IPV6_ADDRZ_RE.match(hostname))
+    return bool(IPV4_RE.match(hostname) or BRACELESS_IPV6_ADDRZ_RE.match(hostname))
 
 
-def _is_key_file_encrypted(key_file: str) -> bool:
+def _is_key_file_encrypted(key_file):
     """Detects if a key file is encrypted or not."""
-    with open(key_file) as f:
+    with open(key_file, "r") as f:
         for line in f:
             # Look for Proc-Type: 4,ENCRYPTED
             if "ENCRYPTED" in line:
@@ -494,12 +478,7 @@ def _is_key_file_encrypted(key_file: str) -> bool:
     return False
 
 
-def _ssl_wrap_socket_impl(
-    sock: socket.socket,
-    ssl_context: ssl.SSLContext,
-    tls_in_tls: bool,
-    server_hostname: str | None = None,
-) -> ssl.SSLSocket | SSLTransportType:
+def _ssl_wrap_socket_impl(sock, ssl_context, tls_in_tls, server_hostname=None):
     if tls_in_tls:
         if not SSLTransport:
             # Import error, ssl is not available.
@@ -510,4 +489,7 @@ def _ssl_wrap_socket_impl(
         SSLTransport._validate_ssl_context_for_tls_in_tls(ssl_context)
         return SSLTransport(sock, ssl_context, server_hostname)
 
-    return ssl_context.wrap_socket(sock, server_hostname=server_hostname)
+    if server_hostname:
+        return ssl_context.wrap_socket(sock, server_hostname=server_hostname)
+    else:
+        return ssl_context.wrap_socket(sock)
diff --git a/lib/urllib3/util/ssl_match_hostname.py b/lib/urllib3/util/ssl_match_hostname.py
index 453cfd42..1dd950c4 100644
--- a/lib/urllib3/util/ssl_match_hostname.py
+++ b/lib/urllib3/util/ssl_match_hostname.py
@@ -1,18 +1,19 @@
-"""The match_hostname() function from Python 3.5, essential when using SSL."""
+"""The match_hostname() function from Python 3.3.3, essential when using SSL."""
 
 # Note: This file is under the PSF license as the code comes from the python
 # stdlib.   http://docs.python.org/3/license.html
-# It is modified to remove commonName support.
 
-from __future__ import annotations
-
-import ipaddress
 import re
-import typing
-from ipaddress import IPv4Address, IPv6Address
+import sys
 
-if typing.TYPE_CHECKING:
-    from .ssl_ import _TYPE_PEER_CERT_RET_DICT
+# ipaddress has been backported to 2.6+ in pypi.  If it is installed on the
+# system, use it to handle IPAddress ServerAltnames (this was added in
+# python-3.5) otherwise only do DNS matching.  This allows
+# util.ssl_match_hostname to continue to be used in Python 2.7.
+try:
+    import ipaddress
+except ImportError:
+    ipaddress = None
 
 __version__ = "3.5.0.1"
 
@@ -21,9 +22,7 @@ class CertificateError(ValueError):
     pass
 
 
-def _dnsname_match(
-    dn: typing.Any, hostname: str, max_wildcards: int = 1
-) -> typing.Match[str] | None | bool:
+def _dnsname_match(dn, hostname, max_wildcards=1):
     """Matching according to RFC 6125, section 6.4.3
 
     http://tools.ietf.org/html/rfc6125#section-6.4.3
@@ -50,7 +49,7 @@ def _dnsname_match(
 
     # speed up common case w/o wildcards
     if not wildcards:
-        return bool(dn.lower() == hostname.lower())
+        return dn.lower() == hostname.lower()
 
     # RFC 6125, section 6.4.3, subitem 1.
     # The client SHOULD NOT attempt to match a presented identifier in which
@@ -77,26 +76,26 @@ def _dnsname_match(
     return pat.match(hostname)
 
 
-def _ipaddress_match(ipname: str, host_ip: IPv4Address | IPv6Address) -> bool:
+def _to_unicode(obj):
+    if isinstance(obj, str) and sys.version_info < (3,):
+        # ignored flake8 # F821 to support python 2.7 function
+        obj = unicode(obj, encoding="ascii", errors="strict")  # noqa: F821
+    return obj
+
+
+def _ipaddress_match(ipname, host_ip):
     """Exact matching of IP addresses.
 
-    RFC 9110 section 4.3.5: "A reference identity of IP-ID contains the decoded
-    bytes of the IP address. An IP version 4 address is 4 octets, and an IP
-    version 6 address is 16 octets. [...] A reference identity of type IP-ID
-    matches if the address is identical to an iPAddress value of the
-    subjectAltName extension of the certificate."
+    RFC 6125 explicitly doesn't define an algorithm for this
+    (section 1.7.2 - "Out of Scope").
     """
     # OpenSSL may add a trailing newline to a subjectAltName's IP address
     # Divergence from upstream: ipaddress can't handle byte str
-    ip = ipaddress.ip_address(ipname.rstrip())
-    return bool(ip.packed == host_ip.packed)
+    ip = ipaddress.ip_address(_to_unicode(ipname).rstrip())
+    return ip == host_ip
 
 
-def match_hostname(
-    cert: _TYPE_PEER_CERT_RET_DICT | None,
-    hostname: str,
-    hostname_checks_common_name: bool = False,
-) -> None:
+def match_hostname(cert, hostname):
     """Verify that *cert* (in decoded format as returned by
     SSLSocket.getpeercert()) matches the *hostname*.  RFC 2818 and RFC 6125
     rules are followed, but IP addresses are not accepted for *hostname*.
@@ -112,22 +111,21 @@ def match_hostname(
         )
     try:
         # Divergence from upstream: ipaddress can't handle byte str
-        #
-        # The ipaddress module shipped with Python < 3.9 does not support
-        # scoped IPv6 addresses so we unconditionally strip the Zone IDs for
-        # now. Once we drop support for Python 3.9 we can remove this branch.
-        if "%" in hostname:
-            host_ip = ipaddress.ip_address(hostname[: hostname.rfind("%")])
-        else:
-            host_ip = ipaddress.ip_address(hostname)
-
-    except ValueError:
-        # Not an IP address (common case)
+        host_ip = ipaddress.ip_address(_to_unicode(hostname))
+    except (UnicodeError, ValueError):
+        # ValueError: Not an IP address (common case)
+        # UnicodeError: Divergence from upstream: Have to deal with ipaddress not taking
+        # byte strings.  addresses should be all ascii, so we consider it not
+        # an ipaddress in this case
         host_ip = None
+    except AttributeError:
+        # Divergence from upstream: Make ipaddress library optional
+        if ipaddress is None:
+            host_ip = None
+        else:  # Defensive
+            raise
     dnsnames = []
-    san: tuple[tuple[str, str], ...] = cert.get("subjectAltName", ())
-    key: str
-    value: str
+    san = cert.get("subjectAltName", ())
     for key, value in san:
         if key == "DNS":
             if host_ip is None and _dnsname_match(value, hostname):
@@ -137,23 +135,25 @@ def match_hostname(
             if host_ip is not None and _ipaddress_match(value, host_ip):
                 return
             dnsnames.append(value)
-
-    # We only check 'commonName' if it's enabled and we're not verifying
-    # an IP address. IP addresses aren't valid within 'commonName'.
-    if hostname_checks_common_name and host_ip is None and not dnsnames:
+    if not dnsnames:
+        # The subject is only checked when there is no dNSName entry
+        # in subjectAltName
         for sub in cert.get("subject", ()):
             for key, value in sub:
+                # XXX according to RFC 2818, the most specific Common Name
+                # must be used.
                 if key == "commonName":
                     if _dnsname_match(value, hostname):
                         return
                     dnsnames.append(value)
-
     if len(dnsnames) > 1:
         raise CertificateError(
             "hostname %r "
             "doesn't match either of %s" % (hostname, ", ".join(map(repr, dnsnames)))
         )
     elif len(dnsnames) == 1:
-        raise CertificateError(f"hostname {hostname!r} doesn't match {dnsnames[0]!r}")
+        raise CertificateError("hostname %r doesn't match %r" % (hostname, dnsnames[0]))
     else:
-        raise CertificateError("no appropriate subjectAltName fields were found")
+        raise CertificateError(
+            "no appropriate commonName or subjectAltName fields were found"
+        )
diff --git a/lib/urllib3/util/ssltransport.py b/lib/urllib3/util/ssltransport.py
index 5ec86473..4a7105d1 100644
--- a/lib/urllib3/util/ssltransport.py
+++ b/lib/urllib3/util/ssltransport.py
@@ -1,21 +1,9 @@
-from __future__ import annotations
-
 import io
 import socket
 import ssl
-import typing
 
 from ..exceptions import ProxySchemeUnsupported
-
-if typing.TYPE_CHECKING:
-    from typing_extensions import Literal
-
-    from .ssl_ import _TYPE_PEER_CERT_RET, _TYPE_PEER_CERT_RET_DICT
-
-
-_SelfT = typing.TypeVar("_SelfT", bound="SSLTransport")
-_WriteBuffer = typing.Union[bytearray, memoryview]
-_ReturnValue = typing.TypeVar("_ReturnValue")
+from ..packages import six
 
 SSL_BLOCKSIZE = 16384
 
@@ -32,7 +20,7 @@ class SSLTransport:
     """
 
     @staticmethod
-    def _validate_ssl_context_for_tls_in_tls(ssl_context: ssl.SSLContext) -> None:
+    def _validate_ssl_context_for_tls_in_tls(ssl_context):
         """
         Raises a ProxySchemeUnsupported if the provided ssl_context can't be used
         for TLS in TLS.
@@ -42,18 +30,20 @@ class SSLTransport:
         """
 
         if not hasattr(ssl_context, "wrap_bio"):
-            raise ProxySchemeUnsupported(
-                "TLS in TLS requires SSLContext.wrap_bio() which isn't "
-                "available on non-native SSLContext"
-            )
+            if six.PY2:
+                raise ProxySchemeUnsupported(
+                    "TLS in TLS requires SSLContext.wrap_bio() which isn't "
+                    "supported on Python 2"
+                )
+            else:
+                raise ProxySchemeUnsupported(
+                    "TLS in TLS requires SSLContext.wrap_bio() which isn't "
+                    "available on non-native SSLContext"
+                )
 
     def __init__(
-        self,
-        socket: socket.socket,
-        ssl_context: ssl.SSLContext,
-        server_hostname: str | None = None,
-        suppress_ragged_eofs: bool = True,
-    ) -> None:
+        self, socket, ssl_context, server_hostname=None, suppress_ragged_eofs=True
+    ):
         """
         Create an SSLTransport around socket using the provided ssl_context.
         """
@@ -70,36 +60,33 @@ class SSLTransport:
         # Perform initial handshake.
         self._ssl_io_loop(self.sslobj.do_handshake)
 
-    def __enter__(self: _SelfT) -> _SelfT:
+    def __enter__(self):
         return self
 
-    def __exit__(self, *_: typing.Any) -> None:
+    def __exit__(self, *_):
         self.close()
 
-    def fileno(self) -> int:
+    def fileno(self):
         return self.socket.fileno()
 
-    def read(self, len: int = 1024, buffer: typing.Any | None = None) -> int | bytes:
+    def read(self, len=1024, buffer=None):
         return self._wrap_ssl_read(len, buffer)
 
-    def recv(self, buflen: int = 1024, flags: int = 0) -> int | bytes:
+    def recv(self, len=1024, flags=0):
         if flags != 0:
             raise ValueError("non-zero flags not allowed in calls to recv")
-        return self._wrap_ssl_read(buflen)
+        return self._wrap_ssl_read(len)
 
-    def recv_into(
-        self,
-        buffer: _WriteBuffer,
-        nbytes: int | None = None,
-        flags: int = 0,
-    ) -> None | int | bytes:
+    def recv_into(self, buffer, nbytes=None, flags=0):
         if flags != 0:
             raise ValueError("non-zero flags not allowed in calls to recv_into")
-        if nbytes is None:
+        if buffer and (nbytes is None):
             nbytes = len(buffer)
+        elif nbytes is None:
+            nbytes = 1024
         return self.read(nbytes, buffer)
 
-    def sendall(self, data: bytes, flags: int = 0) -> None:
+    def sendall(self, data, flags=0):
         if flags != 0:
             raise ValueError("non-zero flags not allowed in calls to sendall")
         count = 0
@@ -109,20 +96,15 @@ class SSLTransport:
                 v = self.send(byte_view[count:])
                 count += v
 
-    def send(self, data: bytes, flags: int = 0) -> int:
+    def send(self, data, flags=0):
         if flags != 0:
             raise ValueError("non-zero flags not allowed in calls to send")
-        return self._ssl_io_loop(self.sslobj.write, data)
+        response = self._ssl_io_loop(self.sslobj.write, data)
+        return response
 
     def makefile(
-        self,
-        mode: str,
-        buffering: int | None = None,
-        *,
-        encoding: str | None = None,
-        errors: str | None = None,
-        newline: str | None = None,
-    ) -> typing.BinaryIO | typing.TextIO | socket.SocketIO:
+        self, mode="r", buffering=None, encoding=None, errors=None, newline=None
+    ):
         """
         Python's httpclient uses makefile and buffered io when reading HTTP
         messages and we need to support it.
@@ -131,7 +113,7 @@ class SSLTransport:
         changes to point to the socket directly.
         """
         if not set(mode) <= {"r", "w", "b"}:
-            raise ValueError(f"invalid mode {mode!r} (only r, w, b allowed)")
+            raise ValueError("invalid mode %r (only r, w, b allowed)" % (mode,))
 
         writing = "w" in mode
         reading = "r" in mode or not writing
@@ -142,8 +124,8 @@ class SSLTransport:
             rawmode += "r"
         if writing:
             rawmode += "w"
-        raw = socket.SocketIO(self, rawmode)  # type: ignore[arg-type]
-        self.socket._io_refs += 1  # type: ignore[attr-defined]
+        raw = socket.SocketIO(self, rawmode)
+        self.socket._io_refs += 1
         if buffering is None:
             buffering = -1
         if buffering < 0:
@@ -152,9 +134,8 @@ class SSLTransport:
             if not binary:
                 raise ValueError("unbuffered streams must be binary")
             return raw
-        buffer: typing.BinaryIO
         if reading and writing:
-            buffer = io.BufferedRWPair(raw, raw, buffering)  # type: ignore[assignment]
+            buffer = io.BufferedRWPair(raw, raw, buffering)
         elif reading:
             buffer = io.BufferedReader(raw, buffering)
         else:
@@ -163,56 +144,46 @@ class SSLTransport:
         if binary:
             return buffer
         text = io.TextIOWrapper(buffer, encoding, errors, newline)
-        text.mode = mode  # type: ignore[misc]
+        text.mode = mode
         return text
 
-    def unwrap(self) -> None:
+    def unwrap(self):
         self._ssl_io_loop(self.sslobj.unwrap)
 
-    def close(self) -> None:
+    def close(self):
         self.socket.close()
 
-    @typing.overload
-    def getpeercert(
-        self, binary_form: Literal[False] = ...
-    ) -> _TYPE_PEER_CERT_RET_DICT | None:
-        ...
+    def getpeercert(self, binary_form=False):
+        return self.sslobj.getpeercert(binary_form)
 
-    @typing.overload
-    def getpeercert(self, binary_form: Literal[True]) -> bytes | None:
-        ...
-
-    def getpeercert(self, binary_form: bool = False) -> _TYPE_PEER_CERT_RET:
-        return self.sslobj.getpeercert(binary_form)  # type: ignore[return-value]
-
-    def version(self) -> str | None:
+    def version(self):
         return self.sslobj.version()
 
-    def cipher(self) -> tuple[str, str, int] | None:
+    def cipher(self):
         return self.sslobj.cipher()
 
-    def selected_alpn_protocol(self) -> str | None:
+    def selected_alpn_protocol(self):
         return self.sslobj.selected_alpn_protocol()
 
-    def selected_npn_protocol(self) -> str | None:
+    def selected_npn_protocol(self):
         return self.sslobj.selected_npn_protocol()
 
-    def shared_ciphers(self) -> list[tuple[str, str, int]] | None:
+    def shared_ciphers(self):
         return self.sslobj.shared_ciphers()
 
-    def compression(self) -> str | None:
+    def compression(self):
         return self.sslobj.compression()
 
-    def settimeout(self, value: float | None) -> None:
+    def settimeout(self, value):
         self.socket.settimeout(value)
 
-    def gettimeout(self) -> float | None:
+    def gettimeout(self):
         return self.socket.gettimeout()
 
-    def _decref_socketios(self) -> None:
-        self.socket._decref_socketios()  # type: ignore[attr-defined]
+    def _decref_socketios(self):
+        self.socket._decref_socketios()
 
-    def _wrap_ssl_read(self, len: int, buffer: bytearray | None = None) -> int | bytes:
+    def _wrap_ssl_read(self, len, buffer=None):
         try:
             return self._ssl_io_loop(self.sslobj.read, len, buffer)
         except ssl.SSLError as e:
@@ -221,32 +192,7 @@ class SSLTransport:
             else:
                 raise
 
-    # func is sslobj.do_handshake or sslobj.unwrap
-    @typing.overload
-    def _ssl_io_loop(self, func: typing.Callable[[], None]) -> None:
-        ...
-
-    # func is sslobj.write, arg1 is data
-    @typing.overload
-    def _ssl_io_loop(self, func: typing.Callable[[bytes], int], arg1: bytes) -> int:
-        ...
-
-    # func is sslobj.read, arg1 is len, arg2 is buffer
-    @typing.overload
-    def _ssl_io_loop(
-        self,
-        func: typing.Callable[[int, bytearray | None], bytes],
-        arg1: int,
-        arg2: bytearray | None,
-    ) -> bytes:
-        ...
-
-    def _ssl_io_loop(
-        self,
-        func: typing.Callable[..., _ReturnValue],
-        arg1: None | bytes | int = None,
-        arg2: bytearray | None = None,
-    ) -> _ReturnValue:
+    def _ssl_io_loop(self, func, *args):
         """Performs an I/O loop between incoming/outgoing and the socket."""
         should_loop = True
         ret = None
@@ -254,12 +200,7 @@ class SSLTransport:
         while should_loop:
             errno = None
             try:
-                if arg1 is None and arg2 is None:
-                    ret = func()
-                elif arg2 is None:
-                    ret = func(arg1)
-                else:
-                    ret = func(arg1, arg2)
+                ret = func(*args)
             except ssl.SSLError as e:
                 if e.errno not in (ssl.SSL_ERROR_WANT_READ, ssl.SSL_ERROR_WANT_WRITE):
                     # WANT_READ, and WANT_WRITE are expected, others are not.
@@ -277,4 +218,4 @@ class SSLTransport:
                     self.incoming.write(buf)
                 else:
                     self.incoming.write_eof()
-        return typing.cast(_ReturnValue, ret)
+        return ret
diff --git a/lib/urllib3/util/timeout.py b/lib/urllib3/util/timeout.py
index ec090f69..78e18a62 100644
--- a/lib/urllib3/util/timeout.py
+++ b/lib/urllib3/util/timeout.py
@@ -1,56 +1,44 @@
-from __future__ import annotations
+from __future__ import absolute_import
 
 import time
-import typing
-from enum import Enum
-from socket import getdefaulttimeout
+
+# The default socket timeout, used by httplib to indicate that no timeout was; specified by the user
+from socket import _GLOBAL_DEFAULT_TIMEOUT, getdefaulttimeout
 
 from ..exceptions import TimeoutStateError
 
-if typing.TYPE_CHECKING:
-    from typing_extensions import Final
+# A sentinel value to indicate that no timeout was specified by the user in
+# urllib3
+_Default = object()
 
 
-class _TYPE_DEFAULT(Enum):
-    # This value should never be passed to socket.settimeout() so for safety we use a -1.
-    # socket.settimout() raises a ValueError for negative values.
-    token = -1
+# Use time.monotonic if available.
+current_time = getattr(time, "monotonic", time.time)
 
 
-_DEFAULT_TIMEOUT: Final[_TYPE_DEFAULT] = _TYPE_DEFAULT.token
-
-_TYPE_TIMEOUT = typing.Optional[typing.Union[float, _TYPE_DEFAULT]]
-
-
-class Timeout:
+class Timeout(object):
     """Timeout configuration.
 
     Timeouts can be defined as a default for a pool:
 
     .. code-block:: python
 
-        import urllib3
-
-        timeout = urllib3.util.Timeout(connect=2.0, read=7.0)
-
-        http = urllib3.PoolManager(timeout=timeout)
-
-        resp = http.request("GET", "https://example.com/")
-
-        print(resp.status)
+       timeout = Timeout(connect=2.0, read=7.0)
+       http = PoolManager(timeout=timeout)
+       response = http.request('GET', 'http://example.com/')
 
     Or per-request (which overrides the default for the pool):
 
     .. code-block:: python
 
-       response = http.request("GET", "https://example.com/", timeout=Timeout(10))
+       response = http.request('GET', 'http://example.com/', timeout=Timeout(10))
 
     Timeouts can be disabled by setting all the parameters to ``None``:
 
     .. code-block:: python
 
        no_timeout = Timeout(connect=None, read=None)
-       response = http.request("GET", "https://example.com/", timeout=no_timeout)
+       response = http.request('GET', 'http://example.com/, timeout=no_timeout)
 
 
     :param total:
@@ -108,31 +96,31 @@ class Timeout:
     """
 
     #: A sentinel object representing the default timeout value
-    DEFAULT_TIMEOUT: _TYPE_TIMEOUT = _DEFAULT_TIMEOUT
+    DEFAULT_TIMEOUT = _GLOBAL_DEFAULT_TIMEOUT
 
-    def __init__(
-        self,
-        total: _TYPE_TIMEOUT = None,
-        connect: _TYPE_TIMEOUT = _DEFAULT_TIMEOUT,
-        read: _TYPE_TIMEOUT = _DEFAULT_TIMEOUT,
-    ) -> None:
+    def __init__(self, total=None, connect=_Default, read=_Default):
         self._connect = self._validate_timeout(connect, "connect")
         self._read = self._validate_timeout(read, "read")
         self.total = self._validate_timeout(total, "total")
-        self._start_connect: float | None = None
+        self._start_connect = None
 
-    def __repr__(self) -> str:
-        return f"{type(self).__name__}(connect={self._connect!r}, read={self._read!r}, total={self.total!r})"
+    def __repr__(self):
+        return "%s(connect=%r, read=%r, total=%r)" % (
+            type(self).__name__,
+            self._connect,
+            self._read,
+            self.total,
+        )
 
     # __str__ provided for backwards compatibility
     __str__ = __repr__
 
-    @staticmethod
-    def resolve_default_timeout(timeout: _TYPE_TIMEOUT) -> float | None:
-        return getdefaulttimeout() if timeout is _DEFAULT_TIMEOUT else timeout
+    @classmethod
+    def resolve_default_timeout(cls, timeout):
+        return getdefaulttimeout() if timeout is cls.DEFAULT_TIMEOUT else timeout
 
     @classmethod
-    def _validate_timeout(cls, value: _TYPE_TIMEOUT, name: str) -> _TYPE_TIMEOUT:
+    def _validate_timeout(cls, value, name):
         """Check that a timeout attribute is valid.
 
         :param value: The timeout value to validate
@@ -142,7 +130,10 @@ class Timeout:
         :raises ValueError: If it is a numeric value less than or equal to
             zero, or the type is not an integer, float, or None.
         """
-        if value is None or value is _DEFAULT_TIMEOUT:
+        if value is _Default:
+            return cls.DEFAULT_TIMEOUT
+
+        if value is None or value is cls.DEFAULT_TIMEOUT:
             return value
 
         if isinstance(value, bool):
@@ -156,7 +147,7 @@ class Timeout:
             raise ValueError(
                 "Timeout value %s was %s, but it must be an "
                 "int, float or None." % (name, value)
-            ) from None
+            )
 
         try:
             if value <= 0:
@@ -166,15 +157,16 @@ class Timeout:
                     "than or equal to 0." % (name, value)
                 )
         except TypeError:
+            # Python 3
             raise ValueError(
                 "Timeout value %s was %s, but it must be an "
                 "int, float or None." % (name, value)
-            ) from None
+            )
 
         return value
 
     @classmethod
-    def from_float(cls, timeout: _TYPE_TIMEOUT) -> Timeout:
+    def from_float(cls, timeout):
         """Create a new Timeout from a legacy timeout value.
 
         The timeout value used by httplib.py sets the same timeout on the
@@ -183,13 +175,13 @@ class Timeout:
         passed to this function.
 
         :param timeout: The legacy timeout value.
-        :type timeout: integer, float, :attr:`urllib3.util.Timeout.DEFAULT_TIMEOUT`, or None
+        :type timeout: integer, float, sentinel default object, or None
         :return: Timeout object
         :rtype: :class:`Timeout`
         """
         return Timeout(read=timeout, connect=timeout)
 
-    def clone(self) -> Timeout:
+    def clone(self):
         """Create a copy of the timeout object
 
         Timeout properties are stored per-pool but each request needs a fresh
@@ -203,7 +195,7 @@ class Timeout:
         # detect the user default.
         return Timeout(connect=self._connect, read=self._read, total=self.total)
 
-    def start_connect(self) -> float:
+    def start_connect(self):
         """Start the timeout clock, used during a connect() attempt
 
         :raises urllib3.exceptions.TimeoutStateError: if you attempt
@@ -211,10 +203,10 @@ class Timeout:
         """
         if self._start_connect is not None:
             raise TimeoutStateError("Timeout timer has already been started.")
-        self._start_connect = time.monotonic()
+        self._start_connect = current_time()
         return self._start_connect
 
-    def get_connect_duration(self) -> float:
+    def get_connect_duration(self):
         """Gets the time elapsed since the call to :meth:`start_connect`.
 
         :return: Elapsed time in seconds.
@@ -226,10 +218,10 @@ class Timeout:
             raise TimeoutStateError(
                 "Can't get connect duration for timer that has not started."
             )
-        return time.monotonic() - self._start_connect
+        return current_time() - self._start_connect
 
     @property
-    def connect_timeout(self) -> _TYPE_TIMEOUT:
+    def connect_timeout(self):
         """Get the value to use when setting a connection timeout.
 
         This will be a positive float or integer, the value None
@@ -241,13 +233,13 @@ class Timeout:
         if self.total is None:
             return self._connect
 
-        if self._connect is None or self._connect is _DEFAULT_TIMEOUT:
+        if self._connect is None or self._connect is self.DEFAULT_TIMEOUT:
             return self.total
 
-        return min(self._connect, self.total)  # type: ignore[type-var]
+        return min(self._connect, self.total)
 
     @property
-    def read_timeout(self) -> float | None:
+    def read_timeout(self):
         """Get the value for the read timeout.
 
         This assumes some time has elapsed in the connection timeout and
@@ -259,21 +251,21 @@ class Timeout:
         raised.
 
         :return: Value to use for the read timeout.
-        :rtype: int, float or None
+        :rtype: int, float, :attr:`Timeout.DEFAULT_TIMEOUT` or None
         :raises urllib3.exceptions.TimeoutStateError: If :meth:`start_connect`
             has not yet been called on this object.
         """
         if (
             self.total is not None
-            and self.total is not _DEFAULT_TIMEOUT
+            and self.total is not self.DEFAULT_TIMEOUT
             and self._read is not None
-            and self._read is not _DEFAULT_TIMEOUT
+            and self._read is not self.DEFAULT_TIMEOUT
         ):
             # In case the connect timeout has not yet been established.
             if self._start_connect is None:
                 return self._read
             return max(0, min(self.total - self.get_connect_duration(), self._read))
-        elif self.total is not None and self.total is not _DEFAULT_TIMEOUT:
+        elif self.total is not None and self.total is not self.DEFAULT_TIMEOUT:
             return max(0, self.total - self.get_connect_duration())
         else:
-            return self.resolve_default_timeout(self._read)
+            return self._read
diff --git a/lib/urllib3/util/url.py b/lib/urllib3/util/url.py
index d53ea932..e5682d3b 100644
--- a/lib/urllib3/util/url.py
+++ b/lib/urllib3/util/url.py
@@ -1,20 +1,22 @@
-from __future__ import annotations
+from __future__ import absolute_import
 
 import re
-import typing
+from collections import namedtuple
 
 from ..exceptions import LocationParseError
-from .util import to_str
+from ..packages import six
+
+url_attrs = ["scheme", "auth", "host", "port", "path", "query", "fragment"]
 
 # We only want to normalize urls with an HTTP(S) scheme.
 # urllib3 infers URLs without a scheme (None) to be http.
-_NORMALIZABLE_SCHEMES = ("http", "https", None)
+NORMALIZABLE_SCHEMES = ("http", "https", None)
 
 # Almost all of these patterns were derived from the
 # 'rfc3986' module: https://github.com/python-hyper/rfc3986
-_PERCENT_RE = re.compile(r"%[a-fA-F0-9]{2}")
-_SCHEME_RE = re.compile(r"^(?:[a-zA-Z][a-zA-Z0-9+-]*:|/)")
-_URI_RE = re.compile(
+PERCENT_RE = re.compile(r"%[a-fA-F0-9]{2}")
+SCHEME_RE = re.compile(r"^(?:[a-zA-Z][a-zA-Z0-9+-]*:|/)")
+URI_RE = re.compile(
     r"^(?:([a-zA-Z][a-zA-Z0-9+.-]*):)?"
     r"(?://([^\\/?#]*))?"
     r"([^?#]*)"
@@ -23,10 +25,10 @@ _URI_RE = re.compile(
     re.UNICODE | re.DOTALL,
 )
 
-_IPV4_PAT = r"(?:[0-9]{1,3}\.){3}[0-9]{1,3}"
-_HEX_PAT = "[0-9A-Fa-f]{1,4}"
-_LS32_PAT = "(?:{hex}:{hex}|{ipv4})".format(hex=_HEX_PAT, ipv4=_IPV4_PAT)
-_subs = {"hex": _HEX_PAT, "ls32": _LS32_PAT}
+IPV4_PAT = r"(?:[0-9]{1,3}\.){3}[0-9]{1,3}"
+HEX_PAT = "[0-9A-Fa-f]{1,4}"
+LS32_PAT = "(?:{hex}:{hex}|{ipv4})".format(hex=HEX_PAT, ipv4=IPV4_PAT)
+_subs = {"hex": HEX_PAT, "ls32": LS32_PAT}
 _variations = [
     #                            6( h16 ":" ) ls32
     "(?:%(hex)s:){6}%(ls32)s",
@@ -48,78 +50,69 @@ _variations = [
     "(?:(?:%(hex)s:){0,6}%(hex)s)?::",
 ]
 
-_UNRESERVED_PAT = r"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789._\-~"
-_IPV6_PAT = "(?:" + "|".join([x % _subs for x in _variations]) + ")"
-_ZONE_ID_PAT = "(?:%25|%)(?:[" + _UNRESERVED_PAT + "]|%[a-fA-F0-9]{2})+"
-_IPV6_ADDRZ_PAT = r"\[" + _IPV6_PAT + r"(?:" + _ZONE_ID_PAT + r")?\]"
-_REG_NAME_PAT = r"(?:[^\[\]%:/?#]|%[a-fA-F0-9]{2})*"
-_TARGET_RE = re.compile(r"^(/[^?#]*)(?:\?([^#]*))?(?:#.*)?$")
+UNRESERVED_PAT = r"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789._\-~"
+IPV6_PAT = "(?:" + "|".join([x % _subs for x in _variations]) + ")"
+ZONE_ID_PAT = "(?:%25|%)(?:[" + UNRESERVED_PAT + "]|%[a-fA-F0-9]{2})+"
+IPV6_ADDRZ_PAT = r"\[" + IPV6_PAT + r"(?:" + ZONE_ID_PAT + r")?\]"
+REG_NAME_PAT = r"(?:[^\[\]%:/?#]|%[a-fA-F0-9]{2})*"
+TARGET_RE = re.compile(r"^(/[^?#]*)(?:\?([^#]*))?(?:#.*)?$")
 
-_IPV4_RE = re.compile("^" + _IPV4_PAT + "$")
-_IPV6_RE = re.compile("^" + _IPV6_PAT + "$")
-_IPV6_ADDRZ_RE = re.compile("^" + _IPV6_ADDRZ_PAT + "$")
-_BRACELESS_IPV6_ADDRZ_RE = re.compile("^" + _IPV6_ADDRZ_PAT[2:-2] + "$")
-_ZONE_ID_RE = re.compile("(" + _ZONE_ID_PAT + r")\]$")
+IPV4_RE = re.compile("^" + IPV4_PAT + "$")
+IPV6_RE = re.compile("^" + IPV6_PAT + "$")
+IPV6_ADDRZ_RE = re.compile("^" + IPV6_ADDRZ_PAT + "$")
+BRACELESS_IPV6_ADDRZ_RE = re.compile("^" + IPV6_ADDRZ_PAT[2:-2] + "$")
+ZONE_ID_RE = re.compile("(" + ZONE_ID_PAT + r")\]$")
 
 _HOST_PORT_PAT = ("^(%s|%s|%s)(?::0*?(|0|[1-9][0-9]{0,4}))?$") % (
-    _REG_NAME_PAT,
-    _IPV4_PAT,
-    _IPV6_ADDRZ_PAT,
+    REG_NAME_PAT,
+    IPV4_PAT,
+    IPV6_ADDRZ_PAT,
 )
 _HOST_PORT_RE = re.compile(_HOST_PORT_PAT, re.UNICODE | re.DOTALL)
 
-_UNRESERVED_CHARS = set(
+UNRESERVED_CHARS = set(
     "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789._-~"
 )
-_SUB_DELIM_CHARS = set("!$&'()*+,;=")
-_USERINFO_CHARS = _UNRESERVED_CHARS | _SUB_DELIM_CHARS | {":"}
-_PATH_CHARS = _USERINFO_CHARS | {"@", "/"}
-_QUERY_CHARS = _FRAGMENT_CHARS = _PATH_CHARS | {"?"}
+SUB_DELIM_CHARS = set("!$&'()*+,;=")
+USERINFO_CHARS = UNRESERVED_CHARS | SUB_DELIM_CHARS | {":"}
+PATH_CHARS = USERINFO_CHARS | {"@", "/"}
+QUERY_CHARS = FRAGMENT_CHARS = PATH_CHARS | {"?"}
 
 
-class Url(
-    typing.NamedTuple(
-        "Url",
-        [
-            ("scheme", typing.Optional[str]),
-            ("auth", typing.Optional[str]),
-            ("host", typing.Optional[str]),
-            ("port", typing.Optional[int]),
-            ("path", typing.Optional[str]),
-            ("query", typing.Optional[str]),
-            ("fragment", typing.Optional[str]),
-        ],
-    )
-):
+class Url(namedtuple("Url", url_attrs)):
     """
     Data structure for representing an HTTP URL. Used as a return value for
     :func:`parse_url`. Both the scheme and host are normalized as they are
     both case-insensitive according to RFC 3986.
     """
 
-    def __new__(  # type: ignore[no-untyped-def]
+    __slots__ = ()
+
+    def __new__(
         cls,
-        scheme: str | None = None,
-        auth: str | None = None,
-        host: str | None = None,
-        port: int | None = None,
-        path: str | None = None,
-        query: str | None = None,
-        fragment: str | None = None,
+        scheme=None,
+        auth=None,
+        host=None,
+        port=None,
+        path=None,
+        query=None,
+        fragment=None,
     ):
         if path and not path.startswith("/"):
             path = "/" + path
         if scheme is not None:
             scheme = scheme.lower()
-        return super().__new__(cls, scheme, auth, host, port, path, query, fragment)
+        return super(Url, cls).__new__(
+            cls, scheme, auth, host, port, path, query, fragment
+        )
 
     @property
-    def hostname(self) -> str | None:
+    def hostname(self):
         """For backwards-compatibility with urlparse. We're nice like that."""
         return self.host
 
     @property
-    def request_uri(self) -> str:
+    def request_uri(self):
         """Absolute path including the query string."""
         uri = self.path or "/"
 
@@ -129,37 +122,14 @@ class Url(
         return uri
 
     @property
-    def authority(self) -> str | None:
-        """
-        Authority component as defined in RFC 3986 3.2.
-        This includes userinfo (auth), host and port.
-
-        i.e.
-            userinfo@host:port
-        """
-        userinfo = self.auth
-        netloc = self.netloc
-        if netloc is None or userinfo is None:
-            return netloc
-        else:
-            return f"{userinfo}@{netloc}"
-
-    @property
-    def netloc(self) -> str | None:
-        """
-        Network location including host and port.
-
-        If you need the equivalent of urllib.parse's ``netloc``,
-        use the ``authority`` property instead.
-        """
-        if self.host is None:
-            return None
+    def netloc(self):
+        """Network location including host and port"""
         if self.port:
-            return f"{self.host}:{self.port}"
+            return "%s:%d" % (self.host, self.port)
         return self.host
 
     @property
-    def url(self) -> str:
+    def url(self):
         """
         Convert self into a url
 
@@ -168,77 +138,88 @@ class Url(
         :func:`.parse_url`, but it should be equivalent by the RFC (e.g., urls
         with a blank port will have : removed).
 
-        Example:
+        Example: ::
 
-        .. code-block:: python
-
-            import urllib3
-
-            U = urllib3.util.parse_url("https://google.com/mail/")
-
-            print(U.url)
-            # "https://google.com/mail/"
-
-            print( urllib3.util.Url("https", "username:password",
-                                    "host.com", 80, "/path", "query", "fragment"
-                                    ).url
-                )
-            # "https://username:password@host.com:80/path?query#fragment"
+            >>> U = parse_url('http://google.com/mail/')
+            >>> U.url
+            'http://google.com/mail/'
+            >>> Url('http', 'username:password', 'host.com', 80,
+            ... '/path', 'query', 'fragment').url
+            'http://username:password@host.com:80/path?query#fragment'
         """
         scheme, auth, host, port, path, query, fragment = self
-        url = ""
+        url = u""
 
         # We use "is not None" we want things to happen with empty strings (or 0 port)
         if scheme is not None:
-            url += scheme + "://"
+            url += scheme + u"://"
         if auth is not None:
-            url += auth + "@"
+            url += auth + u"@"
         if host is not None:
             url += host
         if port is not None:
-            url += ":" + str(port)
+            url += u":" + str(port)
         if path is not None:
             url += path
         if query is not None:
-            url += "?" + query
+            url += u"?" + query
         if fragment is not None:
-            url += "#" + fragment
+            url += u"#" + fragment
 
         return url
 
-    def __str__(self) -> str:
+    def __str__(self):
         return self.url
 
 
-@typing.overload
-def _encode_invalid_chars(
-    component: str, allowed_chars: typing.Container[str]
-) -> str:  # Abstract
-    ...
+def split_first(s, delims):
+    """
+    .. deprecated:: 1.25
+
+    Given a string and an iterable of delimiters, split on the first found
+    delimiter. Return two split parts and the matched delimiter.
+
+    If not found, then the first part is the full input string.
+
+    Example::
+
+        >>> split_first('foo/bar?baz', '?/=')
+        ('foo', 'bar?baz', '/')
+        >>> split_first('foo/bar?baz', '123')
+        ('foo/bar?baz', '', None)
+
+    Scales linearly with number of delims. Not ideal for large number of delims.
+    """
+    min_idx = None
+    min_delim = None
+    for d in delims:
+        idx = s.find(d)
+        if idx < 0:
+            continue
+
+        if min_idx is None or idx < min_idx:
+            min_idx = idx
+            min_delim = d
+
+    if min_idx is None or min_idx < 0:
+        return s, "", None
+
+    return s[:min_idx], s[min_idx + 1 :], min_delim
 
 
-@typing.overload
-def _encode_invalid_chars(
-    component: None, allowed_chars: typing.Container[str]
-) -> None:  # Abstract
-    ...
-
-
-def _encode_invalid_chars(
-    component: str | None, allowed_chars: typing.Container[str]
-) -> str | None:
+def _encode_invalid_chars(component, allowed_chars, encoding="utf-8"):
     """Percent-encodes a URI component without reapplying
     onto an already percent-encoded component.
     """
     if component is None:
         return component
 
-    component = to_str(component)
+    component = six.ensure_text(component)
 
     # Normalize existing percent-encoded bytes.
     # Try to see if the component we're encoding is already percent-encoded
     # so we can skip all '%' characters but still encode all others.
-    component, percent_encodings = _PERCENT_RE.subn(
+    component, percent_encodings = PERCENT_RE.subn(
         lambda match: match.group(0).upper(), component
     )
 
@@ -247,7 +228,7 @@ def _encode_invalid_chars(
     encoded_component = bytearray()
 
     for i in range(0, len(uri_bytes)):
-        # Will return a single character bytestring
+        # Will return a single character bytestring on both Python 2 & 3
         byte = uri_bytes[i : i + 1]
         byte_ord = ord(byte)
         if (is_percent_encoded and byte == b"%") or (
@@ -257,10 +238,10 @@ def _encode_invalid_chars(
             continue
         encoded_component.extend(b"%" + (hex(byte_ord)[2:].encode().zfill(2).upper()))
 
-    return encoded_component.decode()
+    return encoded_component.decode(encoding)
 
 
-def _remove_path_dot_segments(path: str) -> str:
+def _remove_path_dot_segments(path):
     # See http://tools.ietf.org/html/rfc3986#section-5.2.4 for pseudo-code
     segments = path.split("/")  # Turn the path into a list of segments
     output = []  # Initialize the variable to use to store output
@@ -270,7 +251,7 @@ def _remove_path_dot_segments(path: str) -> str:
         if segment == ".":
             continue
         # Anything other than '..', should be appended to the output
-        if segment != "..":
+        elif segment != "..":
             output.append(segment)
         # In this case segment == '..', if we can, we should pop the last
         # element
@@ -290,25 +271,18 @@ def _remove_path_dot_segments(path: str) -> str:
     return "/".join(output)
 
 
-@typing.overload
-def _normalize_host(host: None, scheme: str | None) -> None:
-    ...
-
-
-@typing.overload
-def _normalize_host(host: str, scheme: str | None) -> str:
-    ...
-
-
-def _normalize_host(host: str | None, scheme: str | None) -> str | None:
+def _normalize_host(host, scheme):
     if host:
-        if scheme in _NORMALIZABLE_SCHEMES:
-            is_ipv6 = _IPV6_ADDRZ_RE.match(host)
+        if isinstance(host, six.binary_type):
+            host = six.ensure_str(host)
+
+        if scheme in NORMALIZABLE_SCHEMES:
+            is_ipv6 = IPV6_ADDRZ_RE.match(host)
             if is_ipv6:
                 # IPv6 hosts of the form 'a::b%zone' are encoded in a URL as
                 # such per RFC 6874: 'a::b%25zone'. Unquote the ZoneID
                 # separator as necessary to return a valid RFC 4007 scoped IP.
-                match = _ZONE_ID_RE.search(host)
+                match = ZONE_ID_RE.search(host)
                 if match:
                     start, end = match.span(1)
                     zone_id = host[start:end]
@@ -317,56 +291,46 @@ def _normalize_host(host: str | None, scheme: str | None) -> str | None:
                         zone_id = zone_id[3:]
                     else:
                         zone_id = zone_id[1:]
-                    zone_id = _encode_invalid_chars(zone_id, _UNRESERVED_CHARS)
-                    return f"{host[:start].lower()}%{zone_id}{host[end:]}"
+                    zone_id = "%" + _encode_invalid_chars(zone_id, UNRESERVED_CHARS)
+                    return host[:start].lower() + zone_id + host[end:]
                 else:
                     return host.lower()
-            elif not _IPV4_RE.match(host):
-                return to_str(
-                    b".".join([_idna_encode(label) for label in host.split(".")]),
-                    "ascii",
+            elif not IPV4_RE.match(host):
+                return six.ensure_str(
+                    b".".join([_idna_encode(label) for label in host.split(".")])
                 )
     return host
 
 
-def _idna_encode(name: str) -> bytes:
-    if not name.isascii():
+def _idna_encode(name):
+    if name and any(ord(x) >= 128 for x in name):
         try:
             import idna
         except ImportError:
-            raise LocationParseError(
-                "Unable to parse URL without the 'idna' module"
-            ) from None
-
+            six.raise_from(
+                LocationParseError("Unable to parse URL without the 'idna' module"),
+                None,
+            )
         try:
             return idna.encode(name.lower(), strict=True, std3_rules=True)
         except idna.IDNAError:
-            raise LocationParseError(
-                f"Name '{name}' is not a valid IDNA label"
-            ) from None
-
+            six.raise_from(
+                LocationParseError(u"Name '%s' is not a valid IDNA label" % name), None
+            )
     return name.lower().encode("ascii")
 
 
-def _encode_target(target: str) -> str:
-    """Percent-encodes a request target so that there are no invalid characters
-
-    Pre-condition for this function is that 'target' must start with '/'.
-    If that is the case then _TARGET_RE will always produce a match.
-    """
-    match = _TARGET_RE.match(target)
-    if not match:  # Defensive:
-        raise LocationParseError(f"{target!r} is not a valid request URI")
-
-    path, query = match.groups()
-    encoded_target = _encode_invalid_chars(path, _PATH_CHARS)
+def _encode_target(target):
+    """Percent-encodes a request target so that there are no invalid characters"""
+    path, query = TARGET_RE.match(target).groups()
+    target = _encode_invalid_chars(path, PATH_CHARS)
+    query = _encode_invalid_chars(query, QUERY_CHARS)
     if query is not None:
-        query = _encode_invalid_chars(query, _QUERY_CHARS)
-        encoded_target += "?" + query
-    return encoded_target
+        target += "?" + query
+    return target
 
 
-def parse_url(url: str) -> Url:
+def parse_url(url):
     """
     Given a url, return a parsed :class:`.Url` namedtuple. Best-effort is
     performed to parse incomplete urls. Fields not provided will be None.
@@ -377,44 +341,28 @@ def parse_url(url: str) -> Url:
 
     :param str url: URL to parse into a :class:`.Url` namedtuple.
 
-    Partly backwards-compatible with :mod:`urllib.parse`.
+    Partly backwards-compatible with :mod:`urlparse`.
 
-    Example:
+    Example::
 
-    .. code-block:: python
-
-        import urllib3
-
-        print( urllib3.util.parse_url('http://google.com/mail/'))
-        # Url(scheme='http', host='google.com', port=None, path='/mail/', ...)
-
-        print( urllib3.util.parse_url('google.com:80'))
-        # Url(scheme=None, host='google.com', port=80, path=None, ...)
-
-        print( urllib3.util.parse_url('/foo?bar'))
-        # Url(scheme=None, host=None, port=None, path='/foo', query='bar', ...)
+        >>> parse_url('http://google.com/mail/')
+        Url(scheme='http', host='google.com', port=None, path='/mail/', ...)
+        >>> parse_url('google.com:80')
+        Url(scheme=None, host='google.com', port=80, path=None, ...)
+        >>> parse_url('/foo?bar')
+        Url(scheme=None, host=None, port=None, path='/foo', query='bar', ...)
     """
     if not url:
         # Empty
         return Url()
 
     source_url = url
-    if not _SCHEME_RE.search(url):
+    if not SCHEME_RE.search(url):
         url = "//" + url
 
-    scheme: str | None
-    authority: str | None
-    auth: str | None
-    host: str | None
-    port: str | None
-    port_int: int | None
-    path: str | None
-    query: str | None
-    fragment: str | None
-
     try:
-        scheme, authority, path, query, fragment = _URI_RE.match(url).groups()  # type: ignore[union-attr]
-        normalize_uri = scheme is None or scheme.lower() in _NORMALIZABLE_SCHEMES
+        scheme, authority, path, query, fragment = URI_RE.match(url).groups()
+        normalize_uri = scheme is None or scheme.lower() in NORMALIZABLE_SCHEMES
 
         if scheme:
             scheme = scheme.lower()
@@ -422,33 +370,31 @@ def parse_url(url: str) -> Url:
         if authority:
             auth, _, host_port = authority.rpartition("@")
             auth = auth or None
-            host, port = _HOST_PORT_RE.match(host_port).groups()  # type: ignore[union-attr]
+            host, port = _HOST_PORT_RE.match(host_port).groups()
             if auth and normalize_uri:
-                auth = _encode_invalid_chars(auth, _USERINFO_CHARS)
+                auth = _encode_invalid_chars(auth, USERINFO_CHARS)
             if port == "":
                 port = None
         else:
             auth, host, port = None, None, None
 
         if port is not None:
-            port_int = int(port)
-            if not (0 <= port_int <= 65535):
+            port = int(port)
+            if not (0 <= port <= 65535):
                 raise LocationParseError(url)
-        else:
-            port_int = None
 
         host = _normalize_host(host, scheme)
 
         if normalize_uri and path:
             path = _remove_path_dot_segments(path)
-            path = _encode_invalid_chars(path, _PATH_CHARS)
+            path = _encode_invalid_chars(path, PATH_CHARS)
         if normalize_uri and query:
-            query = _encode_invalid_chars(query, _QUERY_CHARS)
+            query = _encode_invalid_chars(query, QUERY_CHARS)
         if normalize_uri and fragment:
-            fragment = _encode_invalid_chars(fragment, _FRAGMENT_CHARS)
+            fragment = _encode_invalid_chars(fragment, FRAGMENT_CHARS)
 
-    except (ValueError, AttributeError) as e:
-        raise LocationParseError(source_url) from e
+    except (ValueError, AttributeError):
+        return six.raise_from(LocationParseError(source_url), None)
 
     # For the sake of backwards compatibility we put empty
     # string values for path if there are any defined values
@@ -460,12 +406,30 @@ def parse_url(url: str) -> Url:
         else:
             path = None
 
+    # Ensure that each part of the URL is a `str` for
+    # backwards compatibility.
+    if isinstance(url, six.text_type):
+        ensure_func = six.ensure_text
+    else:
+        ensure_func = six.ensure_str
+
+    def ensure_type(x):
+        return x if x is None else ensure_func(x)
+
     return Url(
-        scheme=scheme,
-        auth=auth,
-        host=host,
-        port=port_int,
-        path=path,
-        query=query,
-        fragment=fragment,
+        scheme=ensure_type(scheme),
+        auth=ensure_type(auth),
+        host=ensure_type(host),
+        port=port,
+        path=ensure_type(path),
+        query=ensure_type(query),
+        fragment=ensure_type(fragment),
     )
+
+
+def get_host(url):
+    """
+    Deprecated. Use :func:`parse_url` instead.
+    """
+    p = parse_url(url)
+    return p.scheme or "http", p.hostname, p.port
diff --git a/lib/urllib3/util/util.py b/lib/urllib3/util/util.py
deleted file mode 100644
index 35c77e40..00000000
--- a/lib/urllib3/util/util.py
+++ /dev/null
@@ -1,42 +0,0 @@
-from __future__ import annotations
-
-import typing
-from types import TracebackType
-
-
-def to_bytes(
-    x: str | bytes, encoding: str | None = None, errors: str | None = None
-) -> bytes:
-    if isinstance(x, bytes):
-        return x
-    elif not isinstance(x, str):
-        raise TypeError(f"not expecting type {type(x).__name__}")
-    if encoding or errors:
-        return x.encode(encoding or "utf-8", errors=errors or "strict")
-    return x.encode()
-
-
-def to_str(
-    x: str | bytes, encoding: str | None = None, errors: str | None = None
-) -> str:
-    if isinstance(x, str):
-        return x
-    elif not isinstance(x, bytes):
-        raise TypeError(f"not expecting type {type(x).__name__}")
-    if encoding or errors:
-        return x.decode(encoding or "utf-8", errors=errors or "strict")
-    return x.decode()
-
-
-def reraise(
-    tp: type[BaseException] | None,
-    value: BaseException,
-    tb: TracebackType | None = None,
-) -> typing.NoReturn:
-    try:
-        if value.__traceback__ is not tb:
-            raise value.with_traceback(tb)
-        raise value
-    finally:
-        value = None  # type: ignore[assignment]
-        tb = None
diff --git a/lib/urllib3/util/wait.py b/lib/urllib3/util/wait.py
index aeca0c7a..21b4590b 100644
--- a/lib/urllib3/util/wait.py
+++ b/lib/urllib3/util/wait.py
@@ -1,10 +1,18 @@
-from __future__ import annotations
-
+import errno
 import select
-import socket
+import sys
 from functools import partial
 
-__all__ = ["wait_for_read", "wait_for_write"]
+try:
+    from time import monotonic
+except ImportError:
+    from time import time as monotonic
+
+__all__ = ["NoWayToWaitForSocketError", "wait_for_read", "wait_for_write"]
+
+
+class NoWayToWaitForSocketError(Exception):
+    pass
 
 
 # How should we wait on sockets?
@@ -29,13 +37,37 @@ __all__ = ["wait_for_read", "wait_for_write"]
 # So: on Windows we use select(), and everywhere else we use poll(). We also
 # fall back to select() in case poll() is somehow broken or missing.
 
+if sys.version_info >= (3, 5):
+    # Modern Python, that retries syscalls by default
+    def _retry_on_intr(fn, timeout):
+        return fn(timeout)
 
-def select_wait_for_socket(
-    sock: socket.socket,
-    read: bool = False,
-    write: bool = False,
-    timeout: float | None = None,
-) -> bool:
+else:
+    # Old and broken Pythons.
+    def _retry_on_intr(fn, timeout):
+        if timeout is None:
+            deadline = float("inf")
+        else:
+            deadline = monotonic() + timeout
+
+        while True:
+            try:
+                return fn(timeout)
+            # OSError for 3 <= pyver < 3.5, select.error for pyver <= 2.7
+            except (OSError, select.error) as e:
+                # 'e.args[0]' incantation works for both OSError and select.error
+                if e.args[0] != errno.EINTR:
+                    raise
+                else:
+                    timeout = deadline - monotonic()
+                    if timeout < 0:
+                        timeout = 0
+                    if timeout == float("inf"):
+                        timeout = None
+                    continue
+
+
+def select_wait_for_socket(sock, read=False, write=False, timeout=None):
     if not read and not write:
         raise RuntimeError("must specify at least one of read=True, write=True")
     rcheck = []
@@ -50,16 +82,11 @@ def select_wait_for_socket(
     # sockets for both conditions. (The stdlib selectors module does the same
     # thing.)
     fn = partial(select.select, rcheck, wcheck, wcheck)
-    rready, wready, xready = fn(timeout)
+    rready, wready, xready = _retry_on_intr(fn, timeout)
     return bool(rready or wready or xready)
 
 
-def poll_wait_for_socket(
-    sock: socket.socket,
-    read: bool = False,
-    write: bool = False,
-    timeout: float | None = None,
-) -> bool:
+def poll_wait_for_socket(sock, read=False, write=False, timeout=None):
     if not read and not write:
         raise RuntimeError("must specify at least one of read=True, write=True")
     mask = 0
@@ -71,33 +98,32 @@ def poll_wait_for_socket(
     poll_obj.register(sock, mask)
 
     # For some reason, poll() takes timeout in milliseconds
-    def do_poll(t: float | None) -> list[tuple[int, int]]:
+    def do_poll(t):
         if t is not None:
             t *= 1000
         return poll_obj.poll(t)
 
-    return bool(do_poll(timeout))
+    return bool(_retry_on_intr(do_poll, timeout))
 
 
-def _have_working_poll() -> bool:
+def null_wait_for_socket(*args, **kwargs):
+    raise NoWayToWaitForSocketError("no select-equivalent available")
+
+
+def _have_working_poll():
     # Apparently some systems have a select.poll that fails as soon as you try
     # to use it, either due to strange configuration or broken monkeypatching
     # from libraries like eventlet/greenlet.
     try:
         poll_obj = select.poll()
-        poll_obj.poll(0)
+        _retry_on_intr(poll_obj.poll, 0)
     except (AttributeError, OSError):
         return False
     else:
         return True
 
 
-def wait_for_socket(
-    sock: socket.socket,
-    read: bool = False,
-    write: bool = False,
-    timeout: float | None = None,
-) -> bool:
+def wait_for_socket(*args, **kwargs):
     # We delay choosing which implementation to use until the first time we're
     # called. We could do it at import time, but then we might make the wrong
     # decision if someone goes wild with monkeypatching select.poll after
@@ -107,17 +133,19 @@ def wait_for_socket(
         wait_for_socket = poll_wait_for_socket
     elif hasattr(select, "select"):
         wait_for_socket = select_wait_for_socket
-    return wait_for_socket(sock, read, write, timeout)
+    else:  # Platform-specific: Appengine.
+        wait_for_socket = null_wait_for_socket
+    return wait_for_socket(*args, **kwargs)
 
 
-def wait_for_read(sock: socket.socket, timeout: float | None = None) -> bool:
+def wait_for_read(sock, timeout=None):
     """Waits for reading to be available on a given socket.
     Returns True if the socket is readable, or False if the timeout expired.
     """
     return wait_for_socket(sock, read=True, timeout=timeout)
 
 
-def wait_for_write(sock: socket.socket, timeout: float | None = None) -> bool:
+def wait_for_write(sock, timeout=None):
     """Waits for writing to be available on a given socket.
     Returns True if the socket is readable, or False if the timeout expired.
     """

From edd8c5fdc31291eab2f8805e33aaa65781547f13 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Wed, 23 Aug 2023 21:54:51 -0700
Subject: [PATCH 434/743] Pin urllib3<2 in requirements.txt

[skip ci]
---
 requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements.txt b/requirements.txt
index 09b22544..8aeaadb0 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -45,7 +45,7 @@ tempora==5.5.0
 tokenize-rt==5.0.0
 tzdata==2023.3
 tzlocal==4.2
-urllib3==2.0.4
+urllib3<2
 webencodings==0.5.1
 websocket-client==1.6.2
 xmltodict==0.13.0

From 7266a60343b7ecb3570a3948e901c1ef16448670 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 23 Aug 2023 21:56:41 -0700
Subject: [PATCH 435/743] Bump cloudinary from 1.32.0 to 1.34.0 (#2109)

* Bump cloudinary from 1.32.0 to 1.34.0

Bumps [cloudinary](https://github.com/cloudinary/pycloudinary) from 1.32.0 to 1.34.0.
- [Release notes](https://github.com/cloudinary/pycloudinary/releases)
- [Changelog](https://github.com/cloudinary/pycloudinary/blob/master/CHANGELOG.md)
- [Commits](https://github.com/cloudinary/pycloudinary/compare/1.32.0...1.34.0)

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

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

* Update cloudinary==1.34.0

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/cloudinary/__init__.py            |  2 +-
 lib/cloudinary/api.py                 | 56 ++++++++++++++++++++++
 lib/cloudinary/api_client/call_api.py |  5 +-
 lib/cloudinary/search.py              | 69 ++++++++++++++++++++++++---
 lib/cloudinary/uploader.py            |  6 ++-
 lib/cloudinary/utils.py               | 56 +++++++++++++++-------
 requirements.txt                      |  2 +-
 7 files changed, 167 insertions(+), 29 deletions(-)

diff --git a/lib/cloudinary/__init__.py b/lib/cloudinary/__init__.py
index 7746e365..2cc24dc4 100644
--- a/lib/cloudinary/__init__.py
+++ b/lib/cloudinary/__init__.py
@@ -38,7 +38,7 @@ CL_BLANK = "data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAA
 URI_SCHEME = "cloudinary"
 API_VERSION = "v1_1"
 
-VERSION = "1.32.0"
+VERSION = "1.34.0"
 
 _USER_PLATFORM_DETAILS = "; ".join((platform(), "Python {}".format(python_version())))
 
diff --git a/lib/cloudinary/api.py b/lib/cloudinary/api.py
index dd34686e..8f07ee9e 100644
--- a/lib/cloudinary/api.py
+++ b/lib/cloudinary/api.py
@@ -155,6 +155,26 @@ def resources_by_context(key, value=None, **options):
     return call_api("get", uri, params, **options)
 
 
+def visual_search(image_url=None, image_asset_id=None, text=None, **options):
+    """
+    Find images based on their visual content.
+
+    :param image_url:       The URL of an image.
+    :type image_url:        str
+    :param image_asset_id:  The asset_id of an image in your account.
+    :type image_asset_id:   str
+    :param text:            A textual description, e.g., "cat"
+    :type text:             str
+    :param options:         Additional options
+    :type options:          dict, optional
+    :return:                Resources (assets) that were found
+    :rtype:                 Response
+    """
+    uri = ["resources", "visual_search"]
+    params = {"image_url": image_url, "image_asset_id": image_asset_id, "text": text}
+    return call_api("get", uri, params, **options)
+
+
 def resource(public_id, **options):
     resource_type = options.pop("resource_type", "image")
     upload_type = options.pop("type", "upload")
@@ -317,6 +337,24 @@ def add_related_assets(public_id, assets_to_relate, resource_type="image", type=
     return call_json_api("post", uri, params, **options)
 
 
+def add_related_assets_by_asset_ids(asset_id, assets_to_relate, **options):
+    """
+    Relates an asset to other assets by asset IDs.
+
+    :param asset_id: The asset ID of the asset to update.
+    :type asset_id: str
+    :param assets_to_relate: The array of up to 10 asset IDs.
+    :type assets_to_relate: list[str]
+    :param options: Additional options.
+    :type options: dict, optional
+    :return: The result of the command.
+    :rtype: dict
+    """
+    uri = ["resources", "related_assets", asset_id]
+    params = {"assets_to_relate": utils.build_array(assets_to_relate)}
+    return call_json_api("post", uri, params, **options)
+
+
 def delete_related_assets(public_id, assets_to_unrelate, resource_type="image", type="upload", **options):
     """
     Unrelates an asset from other assets by public IDs.
@@ -339,6 +377,24 @@ def delete_related_assets(public_id, assets_to_unrelate, resource_type="image",
     return call_json_api("delete", uri, params, **options)
 
 
+def delete_related_assets_by_asset_ids(asset_id, assets_to_unrelate, **options):
+    """
+    Unrelates an asset from other assets by asset IDs.
+
+    :param asset_id: The asset ID of the asset to update.
+    :type asset_id: str
+    :param assets_to_unrelate: The array of up to 10 asset IDs.
+    :type assets_to_unrelate: list[str]
+    :param options: Additional options.
+    :type options: dict, optional
+    :return: The result of the command.
+    :rtype: dict
+    """
+    uri = ["resources", "related_assets", asset_id]
+    params = {"assets_to_unrelate": utils.build_array(assets_to_unrelate)}
+    return call_json_api("delete", uri, params, **options)
+
+
 def tags(**options):
     resource_type = options.pop("resource_type", "image")
     uri = ["tags", resource_type]
diff --git a/lib/cloudinary/api_client/call_api.py b/lib/cloudinary/api_client/call_api.py
index 5b5eb4f5..916a396a 100644
--- a/lib/cloudinary/api_client/call_api.py
+++ b/lib/cloudinary/api_client/call_api.py
@@ -31,7 +31,7 @@ def call_api(method, uri, params, **options):
     return _call_api(method, uri, params=params, **options)
 
 
-def _call_api(method, uri, params=None, body=None, headers=None, **options):
+def _call_api(method, uri, params=None, body=None, headers=None, extra_headers=None, **options):
     prefix = options.pop("upload_prefix",
                          cloudinary.config().upload_prefix) or "https://api.cloudinary.com"
     cloud_name = options.pop("cloud_name", cloudinary.config().cloud_name)
@@ -50,6 +50,9 @@ def _call_api(method, uri, params=None, body=None, headers=None, **options):
     if body is not None:
         options["body"] = body
 
+    if extra_headers is not None:
+        headers.update(extra_headers)
+
     return execute_request(http_connector=_http,
                            method=method,
                            params=params,
diff --git a/lib/cloudinary/search.py b/lib/cloudinary/search.py
index 0e4b0ee0..7af1773c 100644
--- a/lib/cloudinary/search.py
+++ b/lib/cloudinary/search.py
@@ -1,7 +1,10 @@
+import base64
 import json
 
+import cloudinary
 from cloudinary.api_client.call_api import call_json_api
-from cloudinary.utils import unique
+from cloudinary.utils import unique, unsigned_download_url_prefix, build_distribution_domain, base64url_encode, \
+    json_encode, compute_hex_hash, SIGNATURE_SHA256
 
 
 class Search(object):
@@ -15,7 +18,10 @@ class Search(object):
         'with_field': None,
     }
 
+    _ttl = 300  # Used for search URLs
+
     """Build and execute a search query."""
+
     def __init__(self):
         self.query = {}
 
@@ -51,6 +57,16 @@ class Search(object):
         self._add("with_field", value)
         return self
 
+    def ttl(self, ttl):
+        """
+        Sets the time to live of the search URL.
+
+        :param ttl: The time to live in seconds.
+        :return: self
+        """
+        self._ttl = ttl
+        return self
+
     def to_json(self):
         return json.dumps(self.as_dict())
 
@@ -60,12 +76,6 @@ class Search(object):
         uri = [self._endpoint, 'search']
         return call_json_api('post', uri, self.as_dict(), **options)
 
-    def _add(self, name, value):
-        if name not in self.query:
-            self.query[name] = []
-        self.query[name].append(value)
-        return self
-
     def as_dict(self):
         to_return = {}
 
@@ -77,6 +87,51 @@ class Search(object):
 
         return to_return
 
+    def to_url(self, ttl=None, next_cursor=None, **options):
+        """
+        Creates a signed Search URL that can be used on the client side.
+
+        :param ttl: The time to live in seconds.
+        :param next_cursor: Starting position.
+        :param options: Additional url delivery options.
+        :return: The resulting search URL.
+        """
+        api_secret = options.get("api_secret", cloudinary.config().api_secret or None)
+        if not api_secret:
+            raise ValueError("Must supply api_secret")
+
+        if ttl is None:
+            ttl = self._ttl
+
+        query = self.as_dict()
+
+        _next_cursor = query.pop("next_cursor", None)
+        if next_cursor is None:
+            next_cursor = _next_cursor
+
+        b64query = base64url_encode(json_encode(query, sort_keys=True))
+
+        prefix = build_distribution_domain(options)
+
+        signature = compute_hex_hash("{ttl}{b64query}{api_secret}".format(
+            ttl=ttl,
+            b64query=b64query,
+            api_secret=api_secret
+        ), algorithm=SIGNATURE_SHA256)
+
+        return "{prefix}/search/{signature}/{ttl}/{b64query}{next_cursor}".format(
+            prefix=prefix,
+            signature=signature,
+            ttl=ttl,
+            b64query=b64query,
+            next_cursor="/{}".format(next_cursor) if next_cursor else "")
+
     def endpoint(self, endpoint):
         self._endpoint = endpoint
         return self
+
+    def _add(self, name, value):
+        if name not in self.query:
+            self.query[name] = []
+        self.query[name].append(value)
+        return self
diff --git a/lib/cloudinary/uploader.py b/lib/cloudinary/uploader.py
index 188c06e0..d4039ccc 100644
--- a/lib/cloudinary/uploader.py
+++ b/lib/cloudinary/uploader.py
@@ -472,7 +472,8 @@ def call_cacheable_api(action, params, http_headers=None, return_error=False, un
     return result
 
 
-def call_api(action, params, http_headers=None, return_error=False, unsigned=False, file=None, timeout=None, **options):
+def call_api(action, params, http_headers=None, return_error=False, unsigned=False, file=None, timeout=None,
+             extra_headers=None, **options):
     params = utils.cleanup_params(params)
 
     headers = {"User-Agent": cloudinary.get_user_agent()}
@@ -480,6 +481,9 @@ def call_api(action, params, http_headers=None, return_error=False, unsigned=Fal
     if http_headers is not None:
         headers.update(http_headers)
 
+    if extra_headers is not None:
+        headers.update(extra_headers)
+
     oauth_token = options.get("oauth_token", cloudinary.config().oauth_token)
 
     if oauth_token:
diff --git a/lib/cloudinary/utils.py b/lib/cloudinary/utils.py
index 7aac086b..680c175e 100644
--- a/lib/cloudinary/utils.py
+++ b/lib/cloudinary/utils.py
@@ -92,6 +92,7 @@ __SIMPLE_UPLOAD_PARAMS = [
     "eager_notification_url",
     "eager_async",
     "eval",
+    "on_success",
     "proxy",
     "folder",
     "asset_folder",
@@ -106,6 +107,7 @@ __SIMPLE_UPLOAD_PARAMS = [
     "categorization",
     "detection",
     "similarity_search",
+    "visual_search",
     "background_removal",
     "upload_preset",
     "phash",
@@ -281,7 +283,7 @@ def encode_context(context):
     return "|".join(("{}={}".format(k, normalize_context_value(v))) for k, v in iteritems(context))
 
 
-def json_encode(value):
+def json_encode(value, sort_keys=False):
     """
     Converts value to a json encoded string
 
@@ -289,7 +291,7 @@ def json_encode(value):
 
     :return: JSON encoded string
     """
-    return json.dumps(value, default=__json_serializer, separators=(',', ':'))
+    return json.dumps(value, default=__json_serializer, separators=(',', ':'), sort_keys=sort_keys)
 
 
 def encode_date_to_usage_api_format(date_obj):
@@ -373,8 +375,17 @@ def generate_transformation_string(**options):
     flags = ".".join(build_array(options.pop("flags", None)))
     dpr = options.pop("dpr", cloudinary.config().dpr)
     duration = norm_range_value(options.pop("duration", None))
-    start_offset = norm_auto_range_value(options.pop("start_offset", None))
-    end_offset = norm_range_value(options.pop("end_offset", None))
+    
+    so_raw = options.pop("start_offset", None)
+    start_offset = norm_auto_range_value(so_raw)
+    if start_offset == None:
+        start_offset = so_raw
+
+    eo_raw = options.pop("end_offset", None)
+    end_offset = norm_range_value(eo_raw)
+    if end_offset == None:
+        end_offset = eo_raw
+
     offset = split_range(options.pop("offset", None))
     if offset:
         start_offset = norm_auto_range_value(offset[0])
@@ -700,6 +711,25 @@ def unsigned_download_url_prefix(source, cloud_name, private_cdn, cdn_subdomain,
     return prefix
 
 
+def build_distribution_domain(options):
+    source = options.pop('source', '')
+    cloud_name = options.pop("cloud_name", cloudinary.config().cloud_name or None)
+    if cloud_name is None:
+        raise ValueError("Must supply cloud_name in tag or in configuration")
+    secure = options.pop("secure", cloudinary.config().secure)
+    private_cdn = options.pop("private_cdn", cloudinary.config().private_cdn)
+    cname = options.pop("cname", cloudinary.config().cname)
+    secure_distribution = options.pop("secure_distribution",
+                                      cloudinary.config().secure_distribution)
+    cdn_subdomain = options.pop("cdn_subdomain", cloudinary.config().cdn_subdomain)
+    secure_cdn_subdomain = options.pop("secure_cdn_subdomain",
+                                       cloudinary.config().secure_cdn_subdomain)
+
+    return unsigned_download_url_prefix(
+        source, cloud_name, private_cdn, cdn_subdomain, secure_cdn_subdomain,
+        cname, secure, secure_distribution)
+
+
 def merge(*dict_args):
     result = None
     for dictionary in dict_args:
@@ -728,19 +758,8 @@ def cloudinary_url(source, **options):
     version = options.pop("version", None)
 
     format = options.pop("format", None)
-    cdn_subdomain = options.pop("cdn_subdomain", cloudinary.config().cdn_subdomain)
-    secure_cdn_subdomain = options.pop("secure_cdn_subdomain",
-                                       cloudinary.config().secure_cdn_subdomain)
-    cname = options.pop("cname", cloudinary.config().cname)
     shorten = options.pop("shorten", cloudinary.config().shorten)
 
-    cloud_name = options.pop("cloud_name", cloudinary.config().cloud_name or None)
-    if cloud_name is None:
-        raise ValueError("Must supply cloud_name in tag or in configuration")
-    secure = options.pop("secure", cloudinary.config().secure)
-    private_cdn = options.pop("private_cdn", cloudinary.config().private_cdn)
-    secure_distribution = options.pop("secure_distribution",
-                                      cloudinary.config().secure_distribution)
     sign_url = options.pop("sign_url", cloudinary.config().sign_url)
     api_secret = options.pop("api_secret", cloudinary.config().api_secret)
     url_suffix = options.pop("url_suffix", None)
@@ -786,9 +805,9 @@ def cloudinary_url(source, **options):
             base64.urlsafe_b64encode(
                 hash_fn(to_bytes(to_sign + api_secret)).digest())[0:chars_length]) + "--"
 
-    prefix = unsigned_download_url_prefix(
-        source, cloud_name, private_cdn, cdn_subdomain, secure_cdn_subdomain,
-        cname, secure, secure_distribution)
+    options["source"] = source
+    prefix = build_distribution_domain(options)
+
     source = "/".join(__compact(
         [prefix, resource_type, type, signature, transformation, version, source]))
     if sign_url and auth_token:
@@ -999,6 +1018,7 @@ def archive_params(**options):
         "skip_transformation_name": options.get("skip_transformation_name"),
         "tags": options.get("tags") and build_array(options.get("tags")),
         "target_format": options.get("target_format"),
+        "target_asset_folder": options.get("target_asset_folder"),
         "target_public_id": options.get("target_public_id"),
         "target_tags": options.get("target_tags") and build_array(options.get("target_tags")),
         "timestamp": timestamp,
diff --git a/requirements.txt b/requirements.txt
index 8aeaadb0..03b49577 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -9,7 +9,7 @@ bleach==6.0.0
 certifi==2023.7.22
 cheroot==9.0.0
 cherrypy==18.8.0
-cloudinary==1.32.0
+cloudinary==1.34.0
 distro==1.8.0
 dnspython==2.3.0
 facebook-sdk==3.1.0

From 9f00f5dafa26c594d64f36a55e4ba8df8294fce7 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Wed, 23 Aug 2023 22:04:27 -0700
Subject: [PATCH 436/743] Fix watched notification trigger description

Fixes #2104
---
 plexpy/notifiers.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/plexpy/notifiers.py b/plexpy/notifiers.py
index 2611aaea..ec8ad5b9 100644
--- a/plexpy/notifiers.py
+++ b/plexpy/notifiers.py
@@ -366,7 +366,7 @@ def available_notification_actions(agent_id=None):
                 },
                {'label': 'Watched',
                 'name': 'on_watched',
-                'description': 'Trigger a notification when a video stream reaches the specified watch percentage.',
+                'description': 'Trigger a notification when a stream reaches the specified watched or listened threshold.',
                 'subject': 'Tautulli ({server_name})',
                 'body': '{user} ({player}) has watched {title}.',
                 'icon': 'fa-eye',

From c0aa4e49968b283d54a44669314a4ecb17fa697a Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 24 Aug 2023 12:05:11 -0700
Subject: [PATCH 437/743] Bump dnspython from 2.3.0 to 2.4.2 (#2123)

* Bump dnspython from 2.3.0 to 2.4.2

Bumps [dnspython](https://github.com/rthalley/dnspython) from 2.3.0 to 2.4.2.
- [Release notes](https://github.com/rthalley/dnspython/releases)
- [Changelog](https://github.com/rthalley/dnspython/blob/master/doc/whatsnew.rst)
- [Commits](https://github.com/rthalley/dnspython/compare/v2.3.0...v2.4.2)

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

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

* Update dnspython==2.4.2

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/dns/__init__.py                |   1 +
 lib/dns/_asyncbackend.py           |  14 +
 lib/dns/_asyncio_backend.py        | 118 ++++-
 lib/dns/_curio_backend.py          | 122 ------
 lib/dns/_ddr.py                    | 154 +++++++
 lib/dns/_immutable_ctx.py          |   1 -
 lib/dns/_trio_backend.py           | 116 ++++-
 lib/dns/asyncbackend.py            |  23 +-
 lib/dns/asyncquery.py              |  77 ++--
 lib/dns/asyncresolver.py           | 245 +++++++++--
 lib/dns/dnssec.py                  | 671 +++++++++++++----------------
 lib/dns/dnssecalgs/__init__.py     | 121 ++++++
 lib/dns/dnssecalgs/base.py         |  84 ++++
 lib/dns/dnssecalgs/cryptography.py |  68 +++
 lib/dns/dnssecalgs/dsa.py          | 101 +++++
 lib/dns/dnssecalgs/ecdsa.py        |  89 ++++
 lib/dns/dnssecalgs/eddsa.py        |  65 +++
 lib/dns/dnssecalgs/rsa.py          | 119 +++++
 lib/dns/edns.py                    |  11 +-
 lib/dns/entropy.py                 |   6 +-
 lib/dns/enum.py                    |  34 +-
 lib/dns/exception.py               |  16 +
 lib/dns/flags.py                   |   3 +-
 lib/dns/immutable.py               |   3 +-
 lib/dns/inet.py                    |  13 +-
 lib/dns/ipv4.py                    |   3 +-
 lib/dns/ipv6.py                    |   5 +-
 lib/dns/message.py                 | 102 +++--
 lib/dns/name.py                    |   9 +-
 lib/dns/nameserver.py              | 329 ++++++++++++++
 lib/dns/node.py                    |   6 +-
 lib/dns/query.py                   | 260 ++++++-----
 lib/dns/quic/__init__.py           |   7 +-
 lib/dns/quic/_asyncio.py           |  45 +-
 lib/dns/quic/_common.py            |  10 +-
 lib/dns/quic/_sync.py              |  68 +--
 lib/dns/quic/_trio.py              |  69 +--
 lib/dns/rdata.py                   |  27 +-
 lib/dns/rdataset.py                |  13 +-
 lib/dns/rdtypes/ANY/AFSDB.py       |   2 +-
 lib/dns/rdtypes/ANY/AVC.py         |   2 +-
 lib/dns/rdtypes/ANY/CDNSKEY.py     |   8 +-
 lib/dns/rdtypes/ANY/CDS.py         |   2 +-
 lib/dns/rdtypes/ANY/CERT.py        |   4 +-
 lib/dns/rdtypes/ANY/CNAME.py       |   2 +-
 lib/dns/rdtypes/ANY/CSYNC.py       |   2 +-
 lib/dns/rdtypes/ANY/DLV.py         |   2 +-
 lib/dns/rdtypes/ANY/DNAME.py       |   2 +-
 lib/dns/rdtypes/ANY/DNSKEY.py      |   8 +-
 lib/dns/rdtypes/ANY/DS.py          |   2 +-
 lib/dns/rdtypes/ANY/EUI48.py       |   2 +-
 lib/dns/rdtypes/ANY/EUI64.py       |   2 +-
 lib/dns/rdtypes/ANY/HIP.py         |   2 +-
 lib/dns/rdtypes/ANY/LOC.py         |   3 +-
 lib/dns/rdtypes/ANY/MX.py          |   2 +-
 lib/dns/rdtypes/ANY/NINFO.py       |   2 +-
 lib/dns/rdtypes/ANY/NS.py          |   2 +-
 lib/dns/rdtypes/ANY/NSEC.py        |   2 +-
 lib/dns/rdtypes/ANY/NSEC3.py       |   6 +-
 lib/dns/rdtypes/ANY/NSEC3PARAM.py  |   2 +-
 lib/dns/rdtypes/ANY/OPT.py         |   3 +-
 lib/dns/rdtypes/ANY/PTR.py         |   2 +-
 lib/dns/rdtypes/ANY/RP.py          |   2 +-
 lib/dns/rdtypes/ANY/RRSIG.py       |   2 +-
 lib/dns/rdtypes/ANY/RT.py          |   2 +-
 lib/dns/rdtypes/ANY/SOA.py         |   2 +-
 lib/dns/rdtypes/ANY/SPF.py         |   2 +-
 lib/dns/rdtypes/ANY/SSHFP.py       |   4 +-
 lib/dns/rdtypes/ANY/TKEY.py        |   2 +-
 lib/dns/rdtypes/ANY/TXT.py         |   2 +-
 lib/dns/rdtypes/ANY/URI.py         |   2 +-
 lib/dns/rdtypes/ANY/ZONEMD.py      |   2 +-
 lib/dns/rdtypes/CH/A.py            |   2 +-
 lib/dns/rdtypes/IN/APL.py          |   1 -
 lib/dns/rdtypes/IN/HTTPS.py        |   2 +-
 lib/dns/rdtypes/IN/IPSECKEY.py     |   2 +-
 lib/dns/rdtypes/IN/KX.py           |   2 +-
 lib/dns/rdtypes/IN/NSAP_PTR.py     |   2 +-
 lib/dns/rdtypes/IN/PX.py           |   2 +-
 lib/dns/rdtypes/IN/SRV.py          |   2 +-
 lib/dns/rdtypes/IN/SVCB.py         |   2 +-
 lib/dns/rdtypes/IN/WKS.py          |   2 +-
 lib/dns/rdtypes/dnskeybase.py      |   4 +-
 lib/dns/rdtypes/dsbase.py          |   4 +-
 lib/dns/rdtypes/euibase.py         |   2 +-
 lib/dns/rdtypes/mxbase.py          |   2 +-
 lib/dns/rdtypes/nsbase.py          |   2 +-
 lib/dns/rdtypes/svcbbase.py        |   1 +
 lib/dns/rdtypes/tlsabase.py        |   4 +-
 lib/dns/rdtypes/txtbase.py         |   3 +-
 lib/dns/rdtypes/util.py            |  25 +-
 lib/dns/renderer.py                |   3 +-
 lib/dns/resolver.py                | 537 +++++++++++++++++------
 lib/dns/reversename.py             |   4 +-
 lib/dns/rrset.py                   |  10 +-
 lib/dns/tokenizer.py               |   3 +-
 lib/dns/transaction.py             |  32 +-
 lib/dns/tsig.py                    |   6 +-
 lib/dns/tsigkeyring.py             |   7 +-
 lib/dns/update.py                  |   7 +-
 lib/dns/version.py                 |   6 +-
 lib/dns/versioned.py               |   6 +-
 lib/dns/win32util.py               |   8 +-
 lib/dns/wire.py                    |   3 +-
 lib/dns/xfr.py                     |   2 +-
 lib/dns/zone.py                    |  55 +--
 lib/dns/zonefile.py                |  48 ++-
 requirements.txt                   |   2 +-
 108 files changed, 2985 insertions(+), 1136 deletions(-)
 delete mode 100644 lib/dns/_curio_backend.py
 create mode 100644 lib/dns/_ddr.py
 create mode 100644 lib/dns/dnssecalgs/__init__.py
 create mode 100644 lib/dns/dnssecalgs/base.py
 create mode 100644 lib/dns/dnssecalgs/cryptography.py
 create mode 100644 lib/dns/dnssecalgs/dsa.py
 create mode 100644 lib/dns/dnssecalgs/ecdsa.py
 create mode 100644 lib/dns/dnssecalgs/eddsa.py
 create mode 100644 lib/dns/dnssecalgs/rsa.py
 create mode 100644 lib/dns/nameserver.py

diff --git a/lib/dns/__init__.py b/lib/dns/__init__.py
index 9abdf018..a4249b9e 100644
--- a/lib/dns/__init__.py
+++ b/lib/dns/__init__.py
@@ -22,6 +22,7 @@ __all__ = [
     "asyncquery",
     "asyncresolver",
     "dnssec",
+    "dnssecalgs",
     "dnssectypes",
     "e164",
     "edns",
diff --git a/lib/dns/_asyncbackend.py b/lib/dns/_asyncbackend.py
index ff24604f..49f14fed 100644
--- a/lib/dns/_asyncbackend.py
+++ b/lib/dns/_asyncbackend.py
@@ -35,6 +35,9 @@ class Socket:  # pragma: no cover
     async def getsockname(self):
         raise NotImplementedError
 
+    async def getpeercert(self, timeout):
+        raise NotImplementedError
+
     async def __aenter__(self):
         return self
 
@@ -61,6 +64,11 @@ class StreamSocket(Socket):  # pragma: no cover
         raise NotImplementedError
 
 
+class NullTransport:
+    async def connect_tcp(self, host, port, timeout, local_address):
+        raise NotImplementedError
+
+
 class Backend:  # pragma: no cover
     def name(self):
         return "unknown"
@@ -83,3 +91,9 @@ class Backend:  # pragma: no cover
 
     async def sleep(self, interval):
         raise NotImplementedError
+
+    def get_transport_class(self):
+        raise NotImplementedError
+
+    async def wait_for(self, awaitable, timeout):
+        raise NotImplementedError
diff --git a/lib/dns/_asyncio_backend.py b/lib/dns/_asyncio_backend.py
index 82a06249..2631228e 100644
--- a/lib/dns/_asyncio_backend.py
+++ b/lib/dns/_asyncio_backend.py
@@ -2,14 +2,13 @@
 
 """asyncio library query support"""
 
-import socket
 import asyncio
+import socket
 import sys
 
 import dns._asyncbackend
 import dns.exception
 
-
 _is_win32 = sys.platform == "win32"
 
 
@@ -38,14 +37,21 @@ class _DatagramProtocol:
 
     def connection_lost(self, exc):
         if self.recvfrom and not self.recvfrom.done():
-            self.recvfrom.set_exception(exc)
+            if exc is None:
+                # EOF we triggered.  Is there a better way to do this?
+                try:
+                    raise EOFError
+                except EOFError as e:
+                    self.recvfrom.set_exception(e)
+            else:
+                self.recvfrom.set_exception(exc)
 
     def close(self):
         self.transport.close()
 
 
 async def _maybe_wait_for(awaitable, timeout):
-    if timeout:
+    if timeout is not None:
         try:
             return await asyncio.wait_for(awaitable, timeout)
         except asyncio.TimeoutError:
@@ -85,6 +91,9 @@ class DatagramSocket(dns._asyncbackend.DatagramSocket):
     async def getsockname(self):
         return self.transport.get_extra_info("sockname")
 
+    async def getpeercert(self, timeout):
+        raise NotImplementedError
+
 
 class StreamSocket(dns._asyncbackend.StreamSocket):
     def __init__(self, af, reader, writer):
@@ -101,10 +110,6 @@ class StreamSocket(dns._asyncbackend.StreamSocket):
 
     async def close(self):
         self.writer.close()
-        try:
-            await self.writer.wait_closed()
-        except AttributeError:  # pragma: no cover
-            pass
 
     async def getpeername(self):
         return self.writer.get_extra_info("peername")
@@ -112,6 +117,97 @@ class StreamSocket(dns._asyncbackend.StreamSocket):
     async def getsockname(self):
         return self.writer.get_extra_info("sockname")
 
+    async def getpeercert(self, timeout):
+        return self.writer.get_extra_info("peercert")
+
+
+try:
+    import anyio
+    import httpcore
+    import httpcore._backends.anyio
+    import httpx
+
+    _CoreAsyncNetworkBackend = httpcore.AsyncNetworkBackend
+    _CoreAnyIOStream = httpcore._backends.anyio.AnyIOStream
+
+    from dns.query import _compute_times, _expiration_for_this_attempt, _remaining
+
+    class _NetworkBackend(_CoreAsyncNetworkBackend):
+        def __init__(self, resolver, local_port, bootstrap_address, family):
+            super().__init__()
+            self._local_port = local_port
+            self._resolver = resolver
+            self._bootstrap_address = bootstrap_address
+            self._family = family
+            if local_port != 0:
+                raise NotImplementedError(
+                    "the asyncio transport for HTTPX cannot set the local port"
+                )
+
+        async def connect_tcp(
+            self, host, port, timeout, local_address, socket_options=None
+        ):  # pylint: disable=signature-differs
+            addresses = []
+            _, expiration = _compute_times(timeout)
+            if dns.inet.is_address(host):
+                addresses.append(host)
+            elif self._bootstrap_address is not None:
+                addresses.append(self._bootstrap_address)
+            else:
+                timeout = _remaining(expiration)
+                family = self._family
+                if local_address:
+                    family = dns.inet.af_for_address(local_address)
+                answers = await self._resolver.resolve_name(
+                    host, family=family, lifetime=timeout
+                )
+                addresses = answers.addresses()
+            for address in addresses:
+                try:
+                    attempt_expiration = _expiration_for_this_attempt(2.0, expiration)
+                    timeout = _remaining(attempt_expiration)
+                    with anyio.fail_after(timeout):
+                        stream = await anyio.connect_tcp(
+                            remote_host=address,
+                            remote_port=port,
+                            local_host=local_address,
+                        )
+                    return _CoreAnyIOStream(stream)
+                except Exception:
+                    pass
+            raise httpcore.ConnectError
+
+        async def connect_unix_socket(
+            self, path, timeout, socket_options=None
+        ):  # pylint: disable=signature-differs
+            raise NotImplementedError
+
+        async def sleep(self, seconds):  # pylint: disable=signature-differs
+            await anyio.sleep(seconds)
+
+    class _HTTPTransport(httpx.AsyncHTTPTransport):
+        def __init__(
+            self,
+            *args,
+            local_port=0,
+            bootstrap_address=None,
+            resolver=None,
+            family=socket.AF_UNSPEC,
+            **kwargs,
+        ):
+            if resolver is None:
+                # pylint: disable=import-outside-toplevel,redefined-outer-name
+                import dns.asyncresolver
+
+                resolver = dns.asyncresolver.Resolver()
+            super().__init__(*args, **kwargs)
+            self._pool._network_backend = _NetworkBackend(
+                resolver, local_port, bootstrap_address, family
+            )
+
+except ImportError:
+    _HTTPTransport = dns._asyncbackend.NullTransport  # type: ignore
+
 
 class Backend(dns._asyncbackend.Backend):
     def name(self):
@@ -171,3 +267,9 @@ class Backend(dns._asyncbackend.Backend):
 
     def datagram_connection_required(self):
         return _is_win32
+
+    def get_transport_class(self):
+        return _HTTPTransport
+
+    async def wait_for(self, awaitable, timeout):
+        return await _maybe_wait_for(awaitable, timeout)
diff --git a/lib/dns/_curio_backend.py b/lib/dns/_curio_backend.py
deleted file mode 100644
index 765d6471..00000000
--- a/lib/dns/_curio_backend.py
+++ /dev/null
@@ -1,122 +0,0 @@
-# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license
-
-"""curio async I/O library query support"""
-
-import socket
-import curio
-import curio.socket  # type: ignore
-
-import dns._asyncbackend
-import dns.exception
-import dns.inet
-
-
-def _maybe_timeout(timeout):
-    if timeout:
-        return curio.ignore_after(timeout)
-    else:
-        return dns._asyncbackend.NullContext()
-
-
-# for brevity
-_lltuple = dns.inet.low_level_address_tuple
-
-# pylint: disable=redefined-outer-name
-
-
-class DatagramSocket(dns._asyncbackend.DatagramSocket):
-    def __init__(self, socket):
-        super().__init__(socket.family)
-        self.socket = socket
-
-    async def sendto(self, what, destination, timeout):
-        async with _maybe_timeout(timeout):
-            return await self.socket.sendto(what, destination)
-        raise dns.exception.Timeout(
-            timeout=timeout
-        )  # pragma: no cover  lgtm[py/unreachable-statement]
-
-    async def recvfrom(self, size, timeout):
-        async with _maybe_timeout(timeout):
-            return await self.socket.recvfrom(size)
-        raise dns.exception.Timeout(timeout=timeout)  # lgtm[py/unreachable-statement]
-
-    async def close(self):
-        await self.socket.close()
-
-    async def getpeername(self):
-        return self.socket.getpeername()
-
-    async def getsockname(self):
-        return self.socket.getsockname()
-
-
-class StreamSocket(dns._asyncbackend.StreamSocket):
-    def __init__(self, socket):
-        self.socket = socket
-        self.family = socket.family
-
-    async def sendall(self, what, timeout):
-        async with _maybe_timeout(timeout):
-            return await self.socket.sendall(what)
-        raise dns.exception.Timeout(timeout=timeout)  # lgtm[py/unreachable-statement]
-
-    async def recv(self, size, timeout):
-        async with _maybe_timeout(timeout):
-            return await self.socket.recv(size)
-        raise dns.exception.Timeout(timeout=timeout)  # lgtm[py/unreachable-statement]
-
-    async def close(self):
-        await self.socket.close()
-
-    async def getpeername(self):
-        return self.socket.getpeername()
-
-    async def getsockname(self):
-        return self.socket.getsockname()
-
-
-class Backend(dns._asyncbackend.Backend):
-    def name(self):
-        return "curio"
-
-    async def make_socket(
-        self,
-        af,
-        socktype,
-        proto=0,
-        source=None,
-        destination=None,
-        timeout=None,
-        ssl_context=None,
-        server_hostname=None,
-    ):
-        if socktype == socket.SOCK_DGRAM:
-            s = curio.socket.socket(af, socktype, proto)
-            try:
-                if source:
-                    s.bind(_lltuple(source, af))
-            except Exception:  # pragma: no cover
-                await s.close()
-                raise
-            return DatagramSocket(s)
-        elif socktype == socket.SOCK_STREAM:
-            if source:
-                source_addr = _lltuple(source, af)
-            else:
-                source_addr = None
-            async with _maybe_timeout(timeout):
-                s = await curio.open_connection(
-                    destination[0],
-                    destination[1],
-                    ssl=ssl_context,
-                    source_addr=source_addr,
-                    server_hostname=server_hostname,
-                )
-            return StreamSocket(s)
-        raise NotImplementedError(
-            "unsupported socket " + f"type {socktype}"
-        )  # pragma: no cover
-
-    async def sleep(self, interval):
-        await curio.sleep(interval)
diff --git a/lib/dns/_ddr.py b/lib/dns/_ddr.py
new file mode 100644
index 00000000..bf5c11eb
--- /dev/null
+++ b/lib/dns/_ddr.py
@@ -0,0 +1,154 @@
+# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license
+#
+# Support for Discovery of Designated Resolvers
+
+import socket
+import time
+from urllib.parse import urlparse
+
+import dns.asyncbackend
+import dns.inet
+import dns.name
+import dns.nameserver
+import dns.query
+import dns.rdtypes.svcbbase
+
+# The special name of the local resolver when using DDR
+_local_resolver_name = dns.name.from_text("_dns.resolver.arpa")
+
+
+#
+# Processing is split up into I/O independent and I/O dependent parts to
+# make supporting sync and async versions easy.
+#
+
+
+class _SVCBInfo:
+    def __init__(self, bootstrap_address, port, hostname, nameservers):
+        self.bootstrap_address = bootstrap_address
+        self.port = port
+        self.hostname = hostname
+        self.nameservers = nameservers
+
+    def ddr_check_certificate(self, cert):
+        """Verify that the _SVCBInfo's address is in the cert's subjectAltName (SAN)"""
+        for name, value in cert["subjectAltName"]:
+            if name == "IP Address" and value == self.bootstrap_address:
+                return True
+        return False
+
+    def make_tls_context(self):
+        ssl = dns.query.ssl
+        ctx = ssl.create_default_context()
+        ctx.minimum_version = ssl.TLSVersion.TLSv1_2
+        return ctx
+
+    def ddr_tls_check_sync(self, lifetime):
+        ctx = self.make_tls_context()
+        expiration = time.time() + lifetime
+        with socket.create_connection(
+            (self.bootstrap_address, self.port), lifetime
+        ) as s:
+            with ctx.wrap_socket(s, server_hostname=self.hostname) as ts:
+                ts.settimeout(dns.query._remaining(expiration))
+                ts.do_handshake()
+                cert = ts.getpeercert()
+                return self.ddr_check_certificate(cert)
+
+    async def ddr_tls_check_async(self, lifetime, backend=None):
+        if backend is None:
+            backend = dns.asyncbackend.get_default_backend()
+        ctx = self.make_tls_context()
+        expiration = time.time() + lifetime
+        async with await backend.make_socket(
+            dns.inet.af_for_address(self.bootstrap_address),
+            socket.SOCK_STREAM,
+            0,
+            None,
+            (self.bootstrap_address, self.port),
+            lifetime,
+            ctx,
+            self.hostname,
+        ) as ts:
+            cert = await ts.getpeercert(dns.query._remaining(expiration))
+            return self.ddr_check_certificate(cert)
+
+
+def _extract_nameservers_from_svcb(answer):
+    bootstrap_address = answer.nameserver
+    if not dns.inet.is_address(bootstrap_address):
+        return []
+    infos = []
+    for rr in answer.rrset.processing_order():
+        nameservers = []
+        param = rr.params.get(dns.rdtypes.svcbbase.ParamKey.ALPN)
+        if param is None:
+            continue
+        alpns = set(param.ids)
+        host = rr.target.to_text(omit_final_dot=True)
+        port = None
+        param = rr.params.get(dns.rdtypes.svcbbase.ParamKey.PORT)
+        if param is not None:
+            port = param.port
+        # For now we ignore address hints and address resolution and always use the
+        # bootstrap address
+        if b"h2" in alpns:
+            param = rr.params.get(dns.rdtypes.svcbbase.ParamKey.DOHPATH)
+            if param is None or not param.value.endswith(b"{?dns}"):
+                continue
+            path = param.value[:-6].decode()
+            if not path.startswith("/"):
+                path = "/" + path
+            if port is None:
+                port = 443
+            url = f"https://{host}:{port}{path}"
+            # check the URL
+            try:
+                urlparse(url)
+                nameservers.append(dns.nameserver.DoHNameserver(url, bootstrap_address))
+            except Exception:
+                # continue processing other ALPN types
+                pass
+        if b"dot" in alpns:
+            if port is None:
+                port = 853
+            nameservers.append(
+                dns.nameserver.DoTNameserver(bootstrap_address, port, host)
+            )
+        if b"doq" in alpns:
+            if port is None:
+                port = 853
+            nameservers.append(
+                dns.nameserver.DoQNameserver(bootstrap_address, port, True, host)
+            )
+        if len(nameservers) > 0:
+            infos.append(_SVCBInfo(bootstrap_address, port, host, nameservers))
+    return infos
+
+
+def _get_nameservers_sync(answer, lifetime):
+    """Return a list of TLS-validated resolver nameservers extracted from an SVCB
+    answer."""
+    nameservers = []
+    infos = _extract_nameservers_from_svcb(answer)
+    for info in infos:
+        try:
+            if info.ddr_tls_check_sync(lifetime):
+                nameservers.extend(info.nameservers)
+        except Exception:
+            pass
+    return nameservers
+
+
+async def _get_nameservers_async(answer, lifetime):
+    """Return a list of TLS-validated resolver nameservers extracted from an SVCB
+    answer."""
+    nameservers = []
+    infos = _extract_nameservers_from_svcb(answer)
+    for info in infos:
+        try:
+            if await info.ddr_tls_check_async(lifetime):
+                nameservers.extend(info.nameservers)
+        except Exception:
+            pass
+    return nameservers
diff --git a/lib/dns/_immutable_ctx.py b/lib/dns/_immutable_ctx.py
index 63c0a2d3..ae7a33bf 100644
--- a/lib/dns/_immutable_ctx.py
+++ b/lib/dns/_immutable_ctx.py
@@ -7,7 +7,6 @@
 import contextvars
 import inspect
 
-
 _in__init__ = contextvars.ContextVar("_immutable_in__init__", default=False)
 
 
diff --git a/lib/dns/_trio_backend.py b/lib/dns/_trio_backend.py
index b0c02103..4d9fb820 100644
--- a/lib/dns/_trio_backend.py
+++ b/lib/dns/_trio_backend.py
@@ -3,6 +3,7 @@
 """trio async I/O library query support"""
 
 import socket
+
 import trio
 import trio.socket  # type: ignore
 
@@ -12,7 +13,7 @@ import dns.inet
 
 
 def _maybe_timeout(timeout):
-    if timeout:
+    if timeout is not None:
         return trio.move_on_after(timeout)
     else:
         return dns._asyncbackend.NullContext()
@@ -50,6 +51,9 @@ class DatagramSocket(dns._asyncbackend.DatagramSocket):
     async def getsockname(self):
         return self.socket.getsockname()
 
+    async def getpeercert(self, timeout):
+        raise NotImplementedError
+
 
 class StreamSocket(dns._asyncbackend.StreamSocket):
     def __init__(self, family, stream, tls=False):
@@ -82,6 +86,100 @@ class StreamSocket(dns._asyncbackend.StreamSocket):
         else:
             return self.stream.socket.getsockname()
 
+    async def getpeercert(self, timeout):
+        if self.tls:
+            with _maybe_timeout(timeout):
+                await self.stream.do_handshake()
+            return self.stream.getpeercert()
+        else:
+            raise NotImplementedError
+
+
+try:
+    import httpcore
+    import httpcore._backends.trio
+    import httpx
+
+    _CoreAsyncNetworkBackend = httpcore.AsyncNetworkBackend
+    _CoreTrioStream = httpcore._backends.trio.TrioStream
+
+    from dns.query import _compute_times, _expiration_for_this_attempt, _remaining
+
+    class _NetworkBackend(_CoreAsyncNetworkBackend):
+        def __init__(self, resolver, local_port, bootstrap_address, family):
+            super().__init__()
+            self._local_port = local_port
+            self._resolver = resolver
+            self._bootstrap_address = bootstrap_address
+            self._family = family
+
+        async def connect_tcp(
+            self, host, port, timeout, local_address, socket_options=None
+        ):  # pylint: disable=signature-differs
+            addresses = []
+            _, expiration = _compute_times(timeout)
+            if dns.inet.is_address(host):
+                addresses.append(host)
+            elif self._bootstrap_address is not None:
+                addresses.append(self._bootstrap_address)
+            else:
+                timeout = _remaining(expiration)
+                family = self._family
+                if local_address:
+                    family = dns.inet.af_for_address(local_address)
+                answers = await self._resolver.resolve_name(
+                    host, family=family, lifetime=timeout
+                )
+                addresses = answers.addresses()
+            for address in addresses:
+                try:
+                    af = dns.inet.af_for_address(address)
+                    if local_address is not None or self._local_port != 0:
+                        source = (local_address, self._local_port)
+                    else:
+                        source = None
+                    destination = (address, port)
+                    attempt_expiration = _expiration_for_this_attempt(2.0, expiration)
+                    timeout = _remaining(attempt_expiration)
+                    sock = await Backend().make_socket(
+                        af, socket.SOCK_STREAM, 0, source, destination, timeout
+                    )
+                    return _CoreTrioStream(sock.stream)
+                except Exception:
+                    continue
+            raise httpcore.ConnectError
+
+        async def connect_unix_socket(
+            self, path, timeout, socket_options=None
+        ):  # pylint: disable=signature-differs
+            raise NotImplementedError
+
+        async def sleep(self, seconds):  # pylint: disable=signature-differs
+            await trio.sleep(seconds)
+
+    class _HTTPTransport(httpx.AsyncHTTPTransport):
+        def __init__(
+            self,
+            *args,
+            local_port=0,
+            bootstrap_address=None,
+            resolver=None,
+            family=socket.AF_UNSPEC,
+            **kwargs,
+        ):
+            if resolver is None:
+                # pylint: disable=import-outside-toplevel,redefined-outer-name
+                import dns.asyncresolver
+
+                resolver = dns.asyncresolver.Resolver()
+            super().__init__(*args, **kwargs)
+            self._pool._network_backend = _NetworkBackend(
+                resolver, local_port, bootstrap_address, family
+            )
+
+except ImportError:
+    _HTTPTransport = dns._asyncbackend.NullTransport  # type: ignore
+
 
 class Backend(dns._asyncbackend.Backend):
     def name(self):
@@ -104,8 +202,14 @@ class Backend(dns._asyncbackend.Backend):
             if source:
                 await s.bind(_lltuple(source, af))
             if socktype == socket.SOCK_STREAM:
+                connected = False
                 with _maybe_timeout(timeout):
                     await s.connect(_lltuple(destination, af))
+                    connected = True
+                if not connected:
+                    raise dns.exception.Timeout(
+                        timeout=timeout
+                    )  # lgtm[py/unreachable-statement]
         except Exception:  # pragma: no cover
             s.close()
             raise
@@ -130,3 +234,13 @@ class Backend(dns._asyncbackend.Backend):
 
     async def sleep(self, interval):
         await trio.sleep(interval)
+
+    def get_transport_class(self):
+        return _HTTPTransport
+
+    async def wait_for(self, awaitable, timeout):
+        with _maybe_timeout(timeout):
+            return await awaitable
+        raise dns.exception.Timeout(
+            timeout=timeout
+        )  # pragma: no cover  lgtm[py/unreachable-statement]
diff --git a/lib/dns/asyncbackend.py b/lib/dns/asyncbackend.py
index c7565a99..07d50e1e 100644
--- a/lib/dns/asyncbackend.py
+++ b/lib/dns/asyncbackend.py
@@ -5,13 +5,12 @@ from typing import Dict
 import dns.exception
 
 # pylint: disable=unused-import
-
-from dns._asyncbackend import (
-    Socket,
-    DatagramSocket,
-    StreamSocket,
+from dns._asyncbackend import (  # noqa: F401  lgtm[py/unused-import]
     Backend,
-)  # noqa: F401  lgtm[py/unused-import]
+    DatagramSocket,
+    Socket,
+    StreamSocket,
+)
 
 # pylint: enable=unused-import
 
@@ -30,8 +29,8 @@ class AsyncLibraryNotFoundError(dns.exception.DNSException):
 def get_backend(name: str) -> Backend:
     """Get the specified asynchronous backend.
 
-    *name*, a ``str``, the name of the backend.  Currently the "trio",
-    "curio", and "asyncio" backends are available.
+    *name*, a ``str``, the name of the backend.  Currently the "trio"
+    and "asyncio" backends are available.
 
     Raises NotImplementError if an unknown backend name is specified.
     """
@@ -43,10 +42,6 @@ def get_backend(name: str) -> Backend:
         import dns._trio_backend
 
         backend = dns._trio_backend.Backend()
-    elif name == "curio":
-        import dns._curio_backend
-
-        backend = dns._curio_backend.Backend()
     elif name == "asyncio":
         import dns._asyncio_backend
 
@@ -73,9 +68,7 @@ def sniff() -> str:
         try:
             return sniffio.current_async_library()
         except sniffio.AsyncLibraryNotFoundError:
-            raise AsyncLibraryNotFoundError(
-                "sniffio cannot determine " + "async library"
-            )
+            raise AsyncLibraryNotFoundError("sniffio cannot determine async library")
     except ImportError:
         import asyncio
 
diff --git a/lib/dns/asyncquery.py b/lib/dns/asyncquery.py
index 459c611d..ecf9c1a5 100644
--- a/lib/dns/asyncquery.py
+++ b/lib/dns/asyncquery.py
@@ -17,39 +17,38 @@
 
 """Talk to a DNS server."""
 
-from typing import Any, Dict, Optional, Tuple, Union
-
 import base64
 import contextlib
 import socket
 import struct
 import time
+from typing import Any, Dict, Optional, Tuple, Union
 
 import dns.asyncbackend
 import dns.exception
 import dns.inet
-import dns.name
 import dns.message
+import dns.name
 import dns.quic
 import dns.rcode
 import dns.rdataclass
 import dns.rdatatype
 import dns.transaction
-
 from dns._asyncbackend import NullContext
 from dns.query import (
-    _compute_times,
-    _matches_destination,
     BadResponse,
-    ssl,
-    UDPMode,
-    _have_httpx,
-    _have_http2,
     NoDOH,
     NoDOQ,
+    UDPMode,
+    _compute_times,
+    _have_http2,
+    _matches_destination,
+    _remaining,
+    have_doh,
+    ssl,
 )
 
-if _have_httpx:
+if have_doh:
     import httpx
 
 # for brevity
@@ -73,7 +72,7 @@ def _source_tuple(af, address, port):
 
 
 def _timeout(expiration, now=None):
-    if expiration:
+    if expiration is not None:
         if not now:
             now = time.time()
         return max(expiration - now, 0)
@@ -445,9 +444,6 @@ async def tls(
             ssl_context.minimum_version = ssl.TLSVersion.TLSv1_2
             if server_hostname is None:
                 ssl_context.check_hostname = False
-        else:
-            ssl_context = None
-            server_hostname = None
         af = dns.inet.af_for_address(where)
         stuple = _source_tuple(af, source, source_port)
         dtuple = (where, port)
@@ -495,6 +491,9 @@ async def https(
     path: str = "/dns-query",
     post: bool = True,
     verify: Union[bool, str] = True,
+    bootstrap_address: Optional[str] = None,
+    resolver: Optional["dns.asyncresolver.Resolver"] = None,
+    family: Optional[int] = socket.AF_UNSPEC,
 ) -> dns.message.Message:
     """Return the response obtained after sending a query via DNS-over-HTTPS.
 
@@ -508,8 +507,10 @@ async def https(
     parameters, exceptions, and return type of this method.
     """
 
-    if not _have_httpx:
-        raise NoDOH("httpx is not available.")  # pragma: no cover
+    if not have_doh:
+        raise NoDOH  # pragma: no cover
+    if client and not isinstance(client, httpx.AsyncClient):
+        raise ValueError("session parameter must be an httpx.AsyncClient")
 
     wire = q.to_wire()
     try:
@@ -518,15 +519,32 @@ async def https(
         af = None
     transport = None
     headers = {"accept": "application/dns-message"}
-    if af is not None:
+    if af is not None and dns.inet.is_address(where):
         if af == socket.AF_INET:
             url = "https://{}:{}{}".format(where, port, path)
         elif af == socket.AF_INET6:
             url = "https://[{}]:{}{}".format(where, port, path)
     else:
         url = where
-    if source is not None:
-        transport = httpx.AsyncHTTPTransport(local_address=source[0])
+
+    backend = dns.asyncbackend.get_default_backend()
+
+    if source is None:
+        local_address = None
+        local_port = 0
+    else:
+        local_address = source
+        local_port = source_port
+    transport = backend.get_transport_class()(
+        local_address=local_address,
+        http1=True,
+        http2=_have_http2,
+        verify=verify,
+        local_port=local_port,
+        bootstrap_address=bootstrap_address,
+        resolver=resolver,
+        family=family,
+    )
 
     if client:
         cm: contextlib.AbstractAsyncContextManager = NullContext(client)
@@ -545,14 +563,14 @@ async def https(
                     "content-length": str(len(wire)),
                 }
             )
-            response = await the_client.post(
-                url, headers=headers, content=wire, timeout=timeout
+            response = await backend.wait_for(
+                the_client.post(url, headers=headers, content=wire), timeout
             )
         else:
             wire = base64.urlsafe_b64encode(wire).rstrip(b"=")
             twire = wire.decode()  # httpx does a repr() if we give it bytes
-            response = await the_client.get(
-                url, headers=headers, timeout=timeout, params={"dns": twire}
+            response = await backend.wait_for(
+                the_client.get(url, headers=headers, params={"dns": twire}), timeout
             )
 
     # see https://tools.ietf.org/html/rfc8484#section-4.2.1 for info about DoH
@@ -690,6 +708,7 @@ async def quic(
     connection: Optional[dns.quic.AsyncQuicConnection] = None,
     verify: Union[bool, str] = True,
     backend: Optional[dns.asyncbackend.Backend] = None,
+    server_hostname: Optional[str] = None,
 ) -> dns.message.Message:
     """Return the response obtained after sending an asynchronous query via
     DNS-over-QUIC.
@@ -715,14 +734,16 @@ async def quic(
         (cfactory, mfactory) = dns.quic.factories_for_backend(backend)
 
     async with cfactory() as context:
-        async with mfactory(context, verify_mode=verify) as the_manager:
+        async with mfactory(
+            context, verify_mode=verify, server_name=server_hostname
+        ) as the_manager:
             if not connection:
                 the_connection = the_manager.connect(where, port, source, source_port)
-            start = time.time()
-            stream = await the_connection.make_stream()
+            (start, expiration) = _compute_times(timeout)
+            stream = await the_connection.make_stream(timeout)
             async with stream:
                 await stream.send(wire, True)
-                wire = await stream.receive(timeout)
+                wire = await stream.receive(_remaining(expiration))
             finish = time.time()
         r = dns.message.from_wire(
             wire,
diff --git a/lib/dns/asyncresolver.py b/lib/dns/asyncresolver.py
index 506530e2..8f5e062a 100644
--- a/lib/dns/asyncresolver.py
+++ b/lib/dns/asyncresolver.py
@@ -17,10 +17,11 @@
 
 """Asynchronous DNS stub resolver."""
 
-from typing import Any, Dict, Optional, Union
-
+import socket
 import time
+from typing import Any, Dict, List, Optional, Union
 
+import dns._ddr
 import dns.asyncbackend
 import dns.asyncquery
 import dns.exception
@@ -31,8 +32,7 @@ import dns.rdatatype
 import dns.resolver  # lgtm[py/import-and-import-from]
 
 # import some resolver symbols for brevity
-from dns.resolver import NXDOMAIN, NoAnswer, NotAbsolute, NoRootSOA
-
+from dns.resolver import NXDOMAIN, NoAnswer, NoRootSOA, NotAbsolute
 
 # for indentation purposes below
 _udp = dns.asyncquery.udp
@@ -83,37 +83,19 @@ class Resolver(dns.resolver.BaseResolver):
             assert request is not None  # needed for type checking
             done = False
             while not done:
-                (nameserver, port, tcp, backoff) = resolution.next_nameserver()
+                (nameserver, tcp, backoff) = resolution.next_nameserver()
                 if backoff:
                     await backend.sleep(backoff)
                 timeout = self._compute_timeout(start, lifetime, resolution.errors)
                 try:
-                    if dns.inet.is_address(nameserver):
-                        if tcp:
-                            response = await _tcp(
-                                request,
-                                nameserver,
-                                timeout,
-                                port,
-                                source,
-                                source_port,
-                                backend=backend,
-                            )
-                        else:
-                            response = await _udp(
-                                request,
-                                nameserver,
-                                timeout,
-                                port,
-                                source,
-                                source_port,
-                                raise_on_truncation=True,
-                                backend=backend,
-                            )
-                    else:
-                        response = await dns.asyncquery.https(
-                            request, nameserver, timeout=timeout
-                        )
+                    response = await nameserver.async_query(
+                        request,
+                        timeout=timeout,
+                        source=source,
+                        source_port=source_port,
+                        max_size=tcp,
+                        backend=backend,
+                    )
                 except Exception as ex:
                     (_, done) = resolution.query_result(None, ex)
                     continue
@@ -153,6 +135,73 @@ class Resolver(dns.resolver.BaseResolver):
             dns.reversename.from_address(ipaddr), *args, **modified_kwargs
         )
 
+    async def resolve_name(
+        self,
+        name: Union[dns.name.Name, str],
+        family: int = socket.AF_UNSPEC,
+        **kwargs: Any,
+    ) -> dns.resolver.HostAnswers:
+        """Use an asynchronous resolver to query for address records.
+
+        This utilizes the resolve() method to perform A and/or AAAA lookups on
+        the specified name.
+
+        *qname*, a ``dns.name.Name`` or ``str``, the name to resolve.
+
+        *family*, an ``int``, the address family.  If socket.AF_UNSPEC
+        (the default), both A and AAAA records will be retrieved.
+
+        All other arguments that can be passed to the resolve() function
+        except for rdtype and rdclass are also supported by this
+        function.
+        """
+        # We make a modified kwargs for type checking happiness, as otherwise
+        # we get a legit warning about possibly having rdtype and rdclass
+        # in the kwargs more than once.
+        modified_kwargs: Dict[str, Any] = {}
+        modified_kwargs.update(kwargs)
+        modified_kwargs.pop("rdtype", None)
+        modified_kwargs["rdclass"] = dns.rdataclass.IN
+
+        if family == socket.AF_INET:
+            v4 = await self.resolve(name, dns.rdatatype.A, **modified_kwargs)
+            return dns.resolver.HostAnswers.make(v4=v4)
+        elif family == socket.AF_INET6:
+            v6 = await self.resolve(name, dns.rdatatype.AAAA, **modified_kwargs)
+            return dns.resolver.HostAnswers.make(v6=v6)
+        elif family != socket.AF_UNSPEC:
+            raise NotImplementedError(f"unknown address family {family}")
+
+        raise_on_no_answer = modified_kwargs.pop("raise_on_no_answer", True)
+        lifetime = modified_kwargs.pop("lifetime", None)
+        start = time.time()
+        v6 = await self.resolve(
+            name,
+            dns.rdatatype.AAAA,
+            raise_on_no_answer=False,
+            lifetime=self._compute_timeout(start, lifetime),
+            **modified_kwargs,
+        )
+        # Note that setting name ensures we query the same name
+        # for A as we did for AAAA.  (This is just in case search lists
+        # are active by default in the resolver configuration and
+        # we might be talking to a server that says NXDOMAIN when it
+        # wants to say NOERROR no data.
+        name = v6.qname
+        v4 = await self.resolve(
+            name,
+            dns.rdatatype.A,
+            raise_on_no_answer=False,
+            lifetime=self._compute_timeout(start, lifetime),
+            **modified_kwargs,
+        )
+        answers = dns.resolver.HostAnswers.make(
+            v6=v6, v4=v4, add_empty=not raise_on_no_answer
+        )
+        if not answers:
+            raise NoAnswer(response=v6.response)
+        return answers
+
     # pylint: disable=redefined-outer-name
 
     async def canonical_name(self, name: Union[dns.name.Name, str]) -> dns.name.Name:
@@ -176,6 +225,37 @@ class Resolver(dns.resolver.BaseResolver):
             canonical_name = e.canonical_name
         return canonical_name
 
+    async def try_ddr(self, lifetime: float = 5.0) -> None:
+        """Try to update the resolver's nameservers using Discovery of Designated
+        Resolvers (DDR).  If successful, the resolver will subsequently use
+        DNS-over-HTTPS or DNS-over-TLS for future queries.
+
+        *lifetime*, a float, is the maximum time to spend attempting DDR.  The default
+        is 5 seconds.
+
+        If the SVCB query is successful and results in a non-empty list of nameservers,
+        then the resolver's nameservers are set to the returned servers in priority
+        order.
+
+        The current implementation does not use any address hints from the SVCB record,
+        nor does it resolve addresses for the SCVB target name, rather it assumes that
+        the bootstrap nameserver will always be one of the addresses and uses it.
+        A future revision to the code may offer fuller support.  The code verifies that
+        the bootstrap nameserver is in the Subject Alternative Name field of the
+        TLS certficate.
+        """
+        try:
+            expiration = time.time() + lifetime
+            answer = await self.resolve(
+                dns._ddr._local_resolver_name, "svcb", lifetime=lifetime
+            )
+            timeout = dns.query._remaining(expiration)
+            nameservers = await dns._ddr._get_nameservers_async(answer, timeout)
+            if len(nameservers) > 0:
+                self.nameservers = nameservers
+        except Exception:
+            pass
+
 
 default_resolver = None
 
@@ -246,6 +326,18 @@ async def resolve_address(
     return await get_default_resolver().resolve_address(ipaddr, *args, **kwargs)
 
 
+async def resolve_name(
+    name: Union[dns.name.Name, str], family: int = socket.AF_UNSPEC, **kwargs: Any
+) -> dns.resolver.HostAnswers:
+    """Use a resolver to asynchronously query for address records.
+
+    See :py:func:`dns.asyncresolver.Resolver.resolve_name` for more
+    information on the parameters.
+    """
+
+    return await get_default_resolver().resolve_name(name, family, **kwargs)
+
+
 async def canonical_name(name: Union[dns.name.Name, str]) -> dns.name.Name:
     """Determine the canonical name of *name*.
 
@@ -256,6 +348,16 @@ async def canonical_name(name: Union[dns.name.Name, str]) -> dns.name.Name:
     return await get_default_resolver().canonical_name(name)
 
 
+async def try_ddr(timeout: float = 5.0) -> None:
+    """Try to update the default resolver's nameservers using Discovery of Designated
+    Resolvers (DDR).  If successful, the resolver will subsequently use
+    DNS-over-HTTPS or DNS-over-TLS for future queries.
+
+    See :py:func:`dns.resolver.Resolver.try_ddr` for more information.
+    """
+    return await get_default_resolver().try_ddr(timeout)
+
+
 async def zone_for_name(
     name: Union[dns.name.Name, str],
     rdclass: dns.rdataclass.RdataClass = dns.rdataclass.IN,
@@ -290,3 +392,84 @@ async def zone_for_name(
             name = name.parent()
         except dns.name.NoParent:  # pragma: no cover
             raise NoRootSOA
+
+
+async def make_resolver_at(
+    where: Union[dns.name.Name, str],
+    port: int = 53,
+    family: int = socket.AF_UNSPEC,
+    resolver: Optional[Resolver] = None,
+) -> Resolver:
+    """Make a stub resolver using the specified destination as the full resolver.
+
+    *where*, a ``dns.name.Name`` or ``str`` the domain name or IP address of the
+    full resolver.
+
+    *port*, an ``int``, the port to use.  If not specified, the default is 53.
+
+    *family*, an ``int``, the address family to use.  This parameter is used if
+    *where* is not an address.  The default is ``socket.AF_UNSPEC`` in which case
+    the first address returned by ``resolve_name()`` will be used, otherwise the
+    first address of the specified family will be used.
+
+    *resolver*, a ``dns.asyncresolver.Resolver`` or ``None``, the resolver to use for
+    resolution of hostnames.  If not specified, the default resolver will be used.
+
+    Returns a ``dns.resolver.Resolver`` or raises an exception.
+    """
+    if resolver is None:
+        resolver = get_default_resolver()
+    nameservers: List[Union[str, dns.nameserver.Nameserver]] = []
+    if isinstance(where, str) and dns.inet.is_address(where):
+        nameservers.append(dns.nameserver.Do53Nameserver(where, port))
+    else:
+        answers = await resolver.resolve_name(where, family)
+        for address in answers.addresses():
+            nameservers.append(dns.nameserver.Do53Nameserver(address, port))
+    res = dns.asyncresolver.Resolver(configure=False)
+    res.nameservers = nameservers
+    return res
+
+
+async def resolve_at(
+    where: Union[dns.name.Name, str],
+    qname: Union[dns.name.Name, str],
+    rdtype: Union[dns.rdatatype.RdataType, str] = dns.rdatatype.A,
+    rdclass: Union[dns.rdataclass.RdataClass, str] = dns.rdataclass.IN,
+    tcp: bool = False,
+    source: Optional[str] = None,
+    raise_on_no_answer: bool = True,
+    source_port: int = 0,
+    lifetime: Optional[float] = None,
+    search: Optional[bool] = None,
+    backend: Optional[dns.asyncbackend.Backend] = None,
+    port: int = 53,
+    family: int = socket.AF_UNSPEC,
+    resolver: Optional[Resolver] = None,
+) -> dns.resolver.Answer:
+    """Query nameservers to find the answer to the question.
+
+    This is a convenience function that calls ``dns.asyncresolver.make_resolver_at()``
+    to make a resolver, and then uses it to resolve the query.
+
+    See ``dns.asyncresolver.Resolver.resolve`` for more information on the resolution
+    parameters, and ``dns.asyncresolver.make_resolver_at`` for information about the
+    resolver parameters *where*, *port*, *family*, and *resolver*.
+
+    If making more than one query, it is more efficient to call
+    ``dns.asyncresolver.make_resolver_at()`` and then use that resolver for the queries
+    instead of calling ``resolve_at()`` multiple times.
+    """
+    res = await make_resolver_at(where, port, family, resolver)
+    return await res.resolve(
+        qname,
+        rdtype,
+        rdclass,
+        tcp,
+        source,
+        raise_on_no_answer,
+        source_port,
+        lifetime,
+        search,
+        backend,
+    )
diff --git a/lib/dns/dnssec.py b/lib/dns/dnssec.py
index 5dc26223..2949f619 100644
--- a/lib/dns/dnssec.py
+++ b/lib/dns/dnssec.py
@@ -17,50 +17,44 @@
 
 """Common DNSSEC-related functions and constants."""
 
-from typing import Any, cast, Dict, List, Optional, Set, Tuple, Union
 
+import base64
+import contextlib
+import functools
 import hashlib
-import math
 import struct
 import time
-import base64
 from datetime import datetime
-
-from dns.dnssectypes import Algorithm, DSDigest, NSEC3Hash
+from typing import Callable, Dict, List, Optional, Set, Tuple, Union, cast
 
 import dns.exception
 import dns.name
 import dns.node
-import dns.rdataset
 import dns.rdata
-import dns.rdatatype
 import dns.rdataclass
+import dns.rdataset
+import dns.rdatatype
 import dns.rrset
+import dns.transaction
+import dns.zone
+from dns.dnssectypes import Algorithm, DSDigest, NSEC3Hash
+from dns.exception import (  # pylint: disable=W0611
+    AlgorithmKeyMismatch,
+    DeniedByPolicy,
+    UnsupportedAlgorithm,
+    ValidationFailure,
+)
 from dns.rdtypes.ANY.CDNSKEY import CDNSKEY
 from dns.rdtypes.ANY.CDS import CDS
 from dns.rdtypes.ANY.DNSKEY import DNSKEY
 from dns.rdtypes.ANY.DS import DS
+from dns.rdtypes.ANY.NSEC import NSEC, Bitmap
+from dns.rdtypes.ANY.NSEC3PARAM import NSEC3PARAM
 from dns.rdtypes.ANY.RRSIG import RRSIG, sigtime_to_posixtime
 from dns.rdtypes.dnskeybase import Flag
 
-
-class UnsupportedAlgorithm(dns.exception.DNSException):
-    """The DNSSEC algorithm is not supported."""
-
-
-class AlgorithmKeyMismatch(UnsupportedAlgorithm):
-    """The DNSSEC algorithm is not supported for the given key type."""
-
-
-class ValidationFailure(dns.exception.DNSException):
-    """The DNSSEC signature is invalid."""
-
-
-class DeniedByPolicy(dns.exception.DNSException):
-    """Denied by DNSSEC policy."""
-
-
 PublicKey = Union[
+    "GenericPublicKey",
     "rsa.RSAPublicKey",
     "ec.EllipticCurvePublicKey",
     "ed25519.Ed25519PublicKey",
@@ -68,12 +62,15 @@ PublicKey = Union[
 ]
 
 PrivateKey = Union[
+    "GenericPrivateKey",
     "rsa.RSAPrivateKey",
     "ec.EllipticCurvePrivateKey",
     "ed25519.Ed25519PrivateKey",
     "ed448.Ed448PrivateKey",
 ]
 
+RRsetSigner = Callable[[dns.transaction.Transaction, dns.rrset.RRset], None]
+
 
 def algorithm_from_text(text: str) -> Algorithm:
     """Convert text into a DNSSEC algorithm value.
@@ -308,113 +305,13 @@ def _find_candidate_keys(
     return [
         cast(DNSKEY, rd)
         for rd in rdataset
-        if rd.algorithm == rrsig.algorithm and key_id(rd) == rrsig.key_tag
+        if rd.algorithm == rrsig.algorithm
+        and key_id(rd) == rrsig.key_tag
+        and (rd.flags & Flag.ZONE) == Flag.ZONE  # RFC 4034 2.1.1
+        and rd.protocol == 3  # RFC 4034 2.1.2
     ]
 
 
-def _is_rsa(algorithm: int) -> bool:
-    return algorithm in (
-        Algorithm.RSAMD5,
-        Algorithm.RSASHA1,
-        Algorithm.RSASHA1NSEC3SHA1,
-        Algorithm.RSASHA256,
-        Algorithm.RSASHA512,
-    )
-
-
-def _is_dsa(algorithm: int) -> bool:
-    return algorithm in (Algorithm.DSA, Algorithm.DSANSEC3SHA1)
-
-
-def _is_ecdsa(algorithm: int) -> bool:
-    return algorithm in (Algorithm.ECDSAP256SHA256, Algorithm.ECDSAP384SHA384)
-
-
-def _is_eddsa(algorithm: int) -> bool:
-    return algorithm in (Algorithm.ED25519, Algorithm.ED448)
-
-
-def _is_gost(algorithm: int) -> bool:
-    return algorithm == Algorithm.ECCGOST
-
-
-def _is_md5(algorithm: int) -> bool:
-    return algorithm == Algorithm.RSAMD5
-
-
-def _is_sha1(algorithm: int) -> bool:
-    return algorithm in (
-        Algorithm.DSA,
-        Algorithm.RSASHA1,
-        Algorithm.DSANSEC3SHA1,
-        Algorithm.RSASHA1NSEC3SHA1,
-    )
-
-
-def _is_sha256(algorithm: int) -> bool:
-    return algorithm in (Algorithm.RSASHA256, Algorithm.ECDSAP256SHA256)
-
-
-def _is_sha384(algorithm: int) -> bool:
-    return algorithm == Algorithm.ECDSAP384SHA384
-
-
-def _is_sha512(algorithm: int) -> bool:
-    return algorithm == Algorithm.RSASHA512
-
-
-def _ensure_algorithm_key_combination(algorithm: int, key: PublicKey) -> None:
-    """Ensure algorithm is valid for key type, throwing an exception on
-    mismatch."""
-    if isinstance(key, rsa.RSAPublicKey):
-        if _is_rsa(algorithm):
-            return
-        raise AlgorithmKeyMismatch('algorithm "%s" not valid for RSA key' % algorithm)
-    if isinstance(key, dsa.DSAPublicKey):
-        if _is_dsa(algorithm):
-            return
-        raise AlgorithmKeyMismatch('algorithm "%s" not valid for DSA key' % algorithm)
-    if isinstance(key, ec.EllipticCurvePublicKey):
-        if _is_ecdsa(algorithm):
-            return
-        raise AlgorithmKeyMismatch('algorithm "%s" not valid for ECDSA key' % algorithm)
-    if isinstance(key, ed25519.Ed25519PublicKey):
-        if algorithm == Algorithm.ED25519:
-            return
-        raise AlgorithmKeyMismatch(
-            'algorithm "%s" not valid for ED25519 key' % algorithm
-        )
-    if isinstance(key, ed448.Ed448PublicKey):
-        if algorithm == Algorithm.ED448:
-            return
-        raise AlgorithmKeyMismatch('algorithm "%s" not valid for ED448 key' % algorithm)
-
-    raise TypeError("unsupported key type")
-
-
-def _make_hash(algorithm: int) -> Any:
-    if _is_md5(algorithm):
-        return hashes.MD5()
-    if _is_sha1(algorithm):
-        return hashes.SHA1()
-    if _is_sha256(algorithm):
-        return hashes.SHA256()
-    if _is_sha384(algorithm):
-        return hashes.SHA384()
-    if _is_sha512(algorithm):
-        return hashes.SHA512()
-    if algorithm == Algorithm.ED25519:
-        return hashes.SHA512()
-    if algorithm == Algorithm.ED448:
-        return hashes.SHAKE256(114)
-
-    raise ValidationFailure("unknown hash for algorithm %u" % algorithm)
-
-
-def _bytes_to_long(b: bytes) -> int:
-    return int.from_bytes(b, "big")
-
-
 def _get_rrname_rdataset(
     rrset: Union[dns.rrset.RRset, Tuple[dns.name.Name, dns.rdataset.Rdataset]],
 ) -> Tuple[dns.name.Name, dns.rdataset.Rdataset]:
@@ -424,85 +321,13 @@ def _get_rrname_rdataset(
         return rrset.name, rrset
 
 
-def _validate_signature(sig: bytes, data: bytes, key: DNSKEY, chosen_hash: Any) -> None:
-    keyptr: bytes
-    if _is_rsa(key.algorithm):
-        # we ignore because mypy is confused and thinks key.key is a str for unknown
-        # reasons.
-        keyptr = key.key
-        (bytes_,) = struct.unpack("!B", keyptr[0:1])
-        keyptr = keyptr[1:]
-        if bytes_ == 0:
-            (bytes_,) = struct.unpack("!H", keyptr[0:2])
-            keyptr = keyptr[2:]
-        rsa_e = keyptr[0:bytes_]
-        rsa_n = keyptr[bytes_:]
-        try:
-            rsa_public_key = rsa.RSAPublicNumbers(
-                _bytes_to_long(rsa_e), _bytes_to_long(rsa_n)
-            ).public_key(default_backend())
-        except ValueError:
-            raise ValidationFailure("invalid public key")
-        rsa_public_key.verify(sig, data, padding.PKCS1v15(), chosen_hash)
-    elif _is_dsa(key.algorithm):
-        keyptr = key.key
-        (t,) = struct.unpack("!B", keyptr[0:1])
-        keyptr = keyptr[1:]
-        octets = 64 + t * 8
-        dsa_q = keyptr[0:20]
-        keyptr = keyptr[20:]
-        dsa_p = keyptr[0:octets]
-        keyptr = keyptr[octets:]
-        dsa_g = keyptr[0:octets]
-        keyptr = keyptr[octets:]
-        dsa_y = keyptr[0:octets]
-        try:
-            dsa_public_key = dsa.DSAPublicNumbers(  # type: ignore
-                _bytes_to_long(dsa_y),
-                dsa.DSAParameterNumbers(
-                    _bytes_to_long(dsa_p), _bytes_to_long(dsa_q), _bytes_to_long(dsa_g)
-                ),
-            ).public_key(default_backend())
-        except ValueError:
-            raise ValidationFailure("invalid public key")
-        dsa_public_key.verify(sig, data, chosen_hash)
-    elif _is_ecdsa(key.algorithm):
-        keyptr = key.key
-        curve: Any
-        if key.algorithm == Algorithm.ECDSAP256SHA256:
-            curve = ec.SECP256R1()
-            octets = 32
-        else:
-            curve = ec.SECP384R1()
-            octets = 48
-        ecdsa_x = keyptr[0:octets]
-        ecdsa_y = keyptr[octets : octets * 2]
-        try:
-            ecdsa_public_key = ec.EllipticCurvePublicNumbers(
-                curve=curve, x=_bytes_to_long(ecdsa_x), y=_bytes_to_long(ecdsa_y)
-            ).public_key(default_backend())
-        except ValueError:
-            raise ValidationFailure("invalid public key")
-        ecdsa_public_key.verify(sig, data, ec.ECDSA(chosen_hash))
-    elif _is_eddsa(key.algorithm):
-        keyptr = key.key
-        loader: Any
-        if key.algorithm == Algorithm.ED25519:
-            loader = ed25519.Ed25519PublicKey
-        else:
-            loader = ed448.Ed448PublicKey
-        try:
-            eddsa_public_key = loader.from_public_bytes(keyptr)
-        except ValueError:
-            raise ValidationFailure("invalid public key")
-        eddsa_public_key.verify(sig, data)
-    elif _is_gost(key.algorithm):
-        raise UnsupportedAlgorithm(
-            'algorithm "%s" not supported by dnspython'
-            % algorithm_to_text(key.algorithm)
-        )
-    else:
-        raise ValidationFailure("unknown algorithm %u" % key.algorithm)
+def _validate_signature(sig: bytes, data: bytes, key: DNSKEY) -> None:
+    public_cls = get_algorithm_cls_from_dnskey(key).public_cls
+    try:
+        public_key = public_cls.from_dnskey(key)
+    except ValueError:
+        raise ValidationFailure("invalid public key")
+    public_key.verify(sig, data)
 
 
 def _validate_rrsig(
@@ -559,29 +384,13 @@ def _validate_rrsig(
     if rrsig.inception > now:
         raise ValidationFailure("not yet valid")
 
-    if _is_dsa(rrsig.algorithm):
-        sig_r = rrsig.signature[1:21]
-        sig_s = rrsig.signature[21:]
-        sig = utils.encode_dss_signature(_bytes_to_long(sig_r), _bytes_to_long(sig_s))
-    elif _is_ecdsa(rrsig.algorithm):
-        if rrsig.algorithm == Algorithm.ECDSAP256SHA256:
-            octets = 32
-        else:
-            octets = 48
-        sig_r = rrsig.signature[0:octets]
-        sig_s = rrsig.signature[octets:]
-        sig = utils.encode_dss_signature(_bytes_to_long(sig_r), _bytes_to_long(sig_s))
-    else:
-        sig = rrsig.signature
-
     data = _make_rrsig_signature_data(rrset, rrsig, origin)
-    chosen_hash = _make_hash(rrsig.algorithm)
 
     for candidate_key in candidate_keys:
         if not policy.ok_to_validate(candidate_key):
             continue
         try:
-            _validate_signature(sig, data, candidate_key, chosen_hash)
+            _validate_signature(rrsig.signature, data, candidate_key)
             return
         except (InvalidSignature, ValidationFailure):
             # this happens on an individual validation failure
@@ -673,6 +482,7 @@ def _sign(
     lifetime: Optional[int] = None,
     verify: bool = False,
     policy: Optional[Policy] = None,
+    origin: Optional[dns.name.Name] = None,
 ) -> RRSIG:
     """Sign RRset using private key.
 
@@ -708,6 +518,10 @@ def _sign(
     *policy*, a ``dns.dnssec.Policy`` or ``None``.  If ``None``, the default policy,
     ``dns.dnssec.default_policy`` is used; this policy defaults to that of RFC 8624.
 
+    *origin*, a ``dns.name.Name`` or ``None``.  If ``None``, the default, then all
+    names in the rrset (including its owner name) must be absolute; otherwise the
+    specified origin will be used to make names absolute when signing.
+
     Raises ``DeniedByPolicy`` if the signature is denied by policy.
     """
 
@@ -735,16 +549,26 @@ def _sign(
     if expiration is not None:
         rrsig_expiration = to_timestamp(expiration)
     elif lifetime is not None:
-        rrsig_expiration = int(time.time()) + lifetime
+        rrsig_expiration = rrsig_inception + lifetime
     else:
         raise ValueError("expiration or lifetime must be specified")
 
+    # Derelativize now because we need a correct labels length for the
+    # rrsig_template.
+    if origin is not None:
+        rrname = rrname.derelativize(origin)
+    labels = len(rrname) - 1
+
+    # Adjust labels appropriately for wildcards.
+    if rrname.is_wild():
+        labels -= 1
+
     rrsig_template = RRSIG(
         rdclass=rdclass,
         rdtype=dns.rdatatype.RRSIG,
         type_covered=rdtype,
         algorithm=dnskey.algorithm,
-        labels=len(rrname) - 1,
+        labels=labels,
         original_ttl=original_ttl,
         expiration=rrsig_expiration,
         inception=rrsig_inception,
@@ -753,63 +577,18 @@ def _sign(
         signature=b"",
     )
 
-    data = dns.dnssec._make_rrsig_signature_data(rrset, rrsig_template)
-    chosen_hash = _make_hash(rrsig_template.algorithm)
-    signature = None
+    data = dns.dnssec._make_rrsig_signature_data(rrset, rrsig_template, origin)
 
-    if isinstance(private_key, rsa.RSAPrivateKey):
-        if not _is_rsa(dnskey.algorithm):
-            raise ValueError("Invalid DNSKEY algorithm for RSA key")
-        signature = private_key.sign(data, padding.PKCS1v15(), chosen_hash)
-        if verify:
-            private_key.public_key().verify(
-                signature, data, padding.PKCS1v15(), chosen_hash
-            )
-    elif isinstance(private_key, dsa.DSAPrivateKey):
-        if not _is_dsa(dnskey.algorithm):
-            raise ValueError("Invalid DNSKEY algorithm for DSA key")
-        public_dsa_key = private_key.public_key()
-        if public_dsa_key.key_size > 1024:
-            raise ValueError("DSA key size overflow")
-        der_signature = private_key.sign(data, chosen_hash)
-        if verify:
-            public_dsa_key.verify(der_signature, data, chosen_hash)
-        dsa_r, dsa_s = utils.decode_dss_signature(der_signature)
-        dsa_t = (public_dsa_key.key_size // 8 - 64) // 8
-        octets = 20
-        signature = (
-            struct.pack("!B", dsa_t)
-            + int.to_bytes(dsa_r, length=octets, byteorder="big")
-            + int.to_bytes(dsa_s, length=octets, byteorder="big")
-        )
-    elif isinstance(private_key, ec.EllipticCurvePrivateKey):
-        if not _is_ecdsa(dnskey.algorithm):
-            raise ValueError("Invalid DNSKEY algorithm for EC key")
-        der_signature = private_key.sign(data, ec.ECDSA(chosen_hash))
-        if verify:
-            private_key.public_key().verify(der_signature, data, ec.ECDSA(chosen_hash))
-        if dnskey.algorithm == Algorithm.ECDSAP256SHA256:
-            octets = 32
-        else:
-            octets = 48
-        dsa_r, dsa_s = utils.decode_dss_signature(der_signature)
-        signature = int.to_bytes(dsa_r, length=octets, byteorder="big") + int.to_bytes(
-            dsa_s, length=octets, byteorder="big"
-        )
-    elif isinstance(private_key, ed25519.Ed25519PrivateKey):
-        if dnskey.algorithm != Algorithm.ED25519:
-            raise ValueError("Invalid DNSKEY algorithm for ED25519 key")
-        signature = private_key.sign(data)
-        if verify:
-            private_key.public_key().verify(signature, data)
-    elif isinstance(private_key, ed448.Ed448PrivateKey):
-        if dnskey.algorithm != Algorithm.ED448:
-            raise ValueError("Invalid DNSKEY algorithm for ED448 key")
-        signature = private_key.sign(data)
-        if verify:
-            private_key.public_key().verify(signature, data)
+    if isinstance(private_key, GenericPrivateKey):
+        signing_key = private_key
     else:
-        raise TypeError("Unsupported key algorithm")
+        try:
+            private_cls = get_algorithm_cls_from_dnskey(dnskey)
+            signing_key = private_cls(key=private_key)
+        except UnsupportedAlgorithm:
+            raise TypeError("Unsupported key algorithm")
+
+    signature = signing_key.sign(data, verify)
 
     return cast(RRSIG, rrsig_template.replace(signature=signature))
 
@@ -858,9 +637,12 @@ def _make_rrsig_signature_data(
             raise ValidationFailure("relative RR name without an origin specified")
         rrname = rrname.derelativize(origin)
 
-    if len(rrname) - 1 < rrsig.labels:
+    name_len = len(rrname)
+    if rrname.is_wild() and rrsig.labels != name_len - 2:
+        raise ValidationFailure("wild owner name has wrong label length")
+    if name_len - 1 < rrsig.labels:
         raise ValidationFailure("owner name longer than RRSIG labels")
-    elif rrsig.labels < len(rrname) - 1:
+    elif rrsig.labels < name_len - 1:
         suffix = rrname.split(rrsig.labels + 1)[1]
         rrname = dns.name.from_text("*", suffix)
     rrnamebuf = rrname.to_digestable()
@@ -884,9 +666,8 @@ def _make_dnskey(
 ) -> DNSKEY:
     """Convert a public key to DNSKEY Rdata
 
-    *public_key*, the public key to convert, a
-    ``cryptography.hazmat.primitives.asymmetric`` public key class applicable
-    for DNSSEC.
+    *public_key*, a ``PublicKey`` (``GenericPublicKey`` or
+    ``cryptography.hazmat.primitives.asymmetric``) to convert.
 
     *algorithm*, a ``str`` or ``int`` specifying the DNSKEY algorithm.
 
@@ -902,72 +683,13 @@ def _make_dnskey(
     Return DNSKEY ``Rdata``.
     """
 
-    def encode_rsa_public_key(public_key: "rsa.RSAPublicKey") -> bytes:
-        """Encode a public key per RFC 3110, section 2."""
-        pn = public_key.public_numbers()
-        _exp_len = math.ceil(int.bit_length(pn.e) / 8)
-        exp = int.to_bytes(pn.e, length=_exp_len, byteorder="big")
-        if _exp_len > 255:
-            exp_header = b"\0" + struct.pack("!H", _exp_len)
-        else:
-            exp_header = struct.pack("!B", _exp_len)
-        if pn.n.bit_length() < 512 or pn.n.bit_length() > 4096:
-            raise ValueError("unsupported RSA key length")
-        return exp_header + exp + pn.n.to_bytes((pn.n.bit_length() + 7) // 8, "big")
+    algorithm = Algorithm.make(algorithm)
 
-    def encode_dsa_public_key(public_key: "dsa.DSAPublicKey") -> bytes:
-        """Encode a public key per RFC 2536, section 2."""
-        pn = public_key.public_numbers()
-        dsa_t = (public_key.key_size // 8 - 64) // 8
-        if dsa_t > 8:
-            raise ValueError("unsupported DSA key size")
-        octets = 64 + dsa_t * 8
-        res = struct.pack("!B", dsa_t)
-        res += pn.parameter_numbers.q.to_bytes(20, "big")
-        res += pn.parameter_numbers.p.to_bytes(octets, "big")
-        res += pn.parameter_numbers.g.to_bytes(octets, "big")
-        res += pn.y.to_bytes(octets, "big")
-        return res
-
-    def encode_ecdsa_public_key(public_key: "ec.EllipticCurvePublicKey") -> bytes:
-        """Encode a public key per RFC 6605, section 4."""
-        pn = public_key.public_numbers()
-        if isinstance(public_key.curve, ec.SECP256R1):
-            return pn.x.to_bytes(32, "big") + pn.y.to_bytes(32, "big")
-        elif isinstance(public_key.curve, ec.SECP384R1):
-            return pn.x.to_bytes(48, "big") + pn.y.to_bytes(48, "big")
-        else:
-            raise ValueError("unsupported ECDSA curve")
-
-    the_algorithm = Algorithm.make(algorithm)
-
-    _ensure_algorithm_key_combination(the_algorithm, public_key)
-
-    if isinstance(public_key, rsa.RSAPublicKey):
-        key_bytes = encode_rsa_public_key(public_key)
-    elif isinstance(public_key, dsa.DSAPublicKey):
-        key_bytes = encode_dsa_public_key(public_key)
-    elif isinstance(public_key, ec.EllipticCurvePublicKey):
-        key_bytes = encode_ecdsa_public_key(public_key)
-    elif isinstance(public_key, ed25519.Ed25519PublicKey):
-        key_bytes = public_key.public_bytes(
-            encoding=serialization.Encoding.Raw, format=serialization.PublicFormat.Raw
-        )
-    elif isinstance(public_key, ed448.Ed448PublicKey):
-        key_bytes = public_key.public_bytes(
-            encoding=serialization.Encoding.Raw, format=serialization.PublicFormat.Raw
-        )
+    if isinstance(public_key, GenericPublicKey):
+        return public_key.to_dnskey(flags=flags, protocol=protocol)
     else:
-        raise TypeError("unsupported key algorithm")
-
-    return DNSKEY(
-        rdclass=dns.rdataclass.IN,
-        rdtype=dns.rdatatype.DNSKEY,
-        flags=flags,
-        protocol=protocol,
-        algorithm=the_algorithm,
-        key=key_bytes,
-    )
+        public_cls = get_algorithm_cls(algorithm).public_cls
+        return public_cls(key=public_key).to_dnskey(flags=flags, protocol=protocol)
 
 
 def _make_cdnskey(
@@ -1216,23 +938,252 @@ def dnskey_rdataset_to_cdnskey_rdataset(
     return dns.rdataset.from_rdata_list(rdataset.ttl, res)
 
 
+def default_rrset_signer(
+    txn: dns.transaction.Transaction,
+    rrset: dns.rrset.RRset,
+    signer: dns.name.Name,
+    ksks: List[Tuple[PrivateKey, DNSKEY]],
+    zsks: List[Tuple[PrivateKey, DNSKEY]],
+    inception: Optional[Union[datetime, str, int, float]] = None,
+    expiration: Optional[Union[datetime, str, int, float]] = None,
+    lifetime: Optional[int] = None,
+    policy: Optional[Policy] = None,
+    origin: Optional[dns.name.Name] = None,
+) -> None:
+    """Default RRset signer"""
+
+    if rrset.rdtype in set(
+        [
+            dns.rdatatype.RdataType.DNSKEY,
+            dns.rdatatype.RdataType.CDS,
+            dns.rdatatype.RdataType.CDNSKEY,
+        ]
+    ):
+        keys = ksks
+    else:
+        keys = zsks
+
+    for private_key, dnskey in keys:
+        rrsig = dns.dnssec.sign(
+            rrset=rrset,
+            private_key=private_key,
+            dnskey=dnskey,
+            inception=inception,
+            expiration=expiration,
+            lifetime=lifetime,
+            signer=signer,
+            policy=policy,
+            origin=origin,
+        )
+        txn.add(rrset.name, rrset.ttl, rrsig)
+
+
+def sign_zone(
+    zone: dns.zone.Zone,
+    txn: Optional[dns.transaction.Transaction] = None,
+    keys: Optional[List[Tuple[PrivateKey, DNSKEY]]] = None,
+    add_dnskey: bool = True,
+    dnskey_ttl: Optional[int] = None,
+    inception: Optional[Union[datetime, str, int, float]] = None,
+    expiration: Optional[Union[datetime, str, int, float]] = None,
+    lifetime: Optional[int] = None,
+    nsec3: Optional[NSEC3PARAM] = None,
+    rrset_signer: Optional[RRsetSigner] = None,
+    policy: Optional[Policy] = None,
+) -> None:
+    """Sign zone.
+
+    *zone*, a ``dns.zone.Zone``, the zone to sign.
+
+    *txn*, a ``dns.transaction.Transaction``, an optional transaction to use for
+    signing.
+
+    *keys*, a list of (``PrivateKey``, ``DNSKEY``) tuples, to use for signing. KSK/ZSK
+    roles are assigned automatically if the SEP flag is used, otherwise all RRsets are
+    signed by all keys.
+
+    *add_dnskey*, a ``bool``.  If ``True``, the default, all specified DNSKEYs are
+    automatically added to the zone on signing.
+
+    *dnskey_ttl*, a``int``, specifies the TTL for DNSKEY RRs. If not specified the TTL
+    of the existing DNSKEY RRset used or the TTL of the SOA RRset.
+
+    *inception*, a ``datetime``, ``str``, ``int``, ``float`` or ``None``, the signature
+    inception time.  If ``None``, the current time is used.  If a ``str``, the format is
+    "YYYYMMDDHHMMSS" or alternatively the number of seconds since the UNIX epoch in text
+    form; this is the same the RRSIG rdata's text form. Values of type `int` or `float`
+    are interpreted as seconds since the UNIX epoch.
+
+    *expiration*, a ``datetime``, ``str``, ``int``, ``float`` or ``None``, the signature
+    expiration time.  If ``None``, the expiration time will be the inception time plus
+    the value of the *lifetime* parameter.  See the description of *inception* above for
+    how the various parameter types are interpreted.
+
+    *lifetime*, an ``int`` or ``None``, the signature lifetime in seconds.  This
+    parameter is only meaningful if *expiration* is ``None``.
+
+    *nsec3*, a ``NSEC3PARAM`` Rdata, configures signing using NSEC3. Not yet
+    implemented.
+
+    *rrset_signer*, a ``Callable``, an optional function for signing RRsets. The
+    function requires two arguments: transaction and RRset. If the not specified,
+    ``dns.dnssec.default_rrset_signer`` will be used.
+
+    Returns ``None``.
+    """
+
+    ksks = []
+    zsks = []
+
+    # if we have both KSKs and ZSKs, split by SEP flag. if not, sign all
+    # records with all keys
+    if keys:
+        for key in keys:
+            if key[1].flags & Flag.SEP:
+                ksks.append(key)
+            else:
+                zsks.append(key)
+        if not ksks:
+            ksks = keys
+        if not zsks:
+            zsks = keys
+    else:
+        keys = []
+
+    if txn:
+        cm: contextlib.AbstractContextManager = contextlib.nullcontext(txn)
+    else:
+        cm = zone.writer()
+
+    with cm as _txn:
+        if add_dnskey:
+            if dnskey_ttl is None:
+                dnskey = _txn.get(zone.origin, dns.rdatatype.DNSKEY)
+                if dnskey:
+                    dnskey_ttl = dnskey.ttl
+                else:
+                    soa = _txn.get(zone.origin, dns.rdatatype.SOA)
+                    dnskey_ttl = soa.ttl
+            for _, dnskey in keys:
+                _txn.add(zone.origin, dnskey_ttl, dnskey)
+
+        if nsec3:
+            raise NotImplementedError("Signing with NSEC3 not yet implemented")
+        else:
+            _rrset_signer = rrset_signer or functools.partial(
+                default_rrset_signer,
+                signer=zone.origin,
+                ksks=ksks,
+                zsks=zsks,
+                inception=inception,
+                expiration=expiration,
+                lifetime=lifetime,
+                policy=policy,
+                origin=zone.origin,
+            )
+            return _sign_zone_nsec(zone, _txn, _rrset_signer)
+
+
+def _sign_zone_nsec(
+    zone: dns.zone.Zone,
+    txn: dns.transaction.Transaction,
+    rrset_signer: Optional[RRsetSigner] = None,
+) -> None:
+    """NSEC zone signer"""
+
+    def _txn_add_nsec(
+        txn: dns.transaction.Transaction,
+        name: dns.name.Name,
+        next_secure: Optional[dns.name.Name],
+        rdclass: dns.rdataclass.RdataClass,
+        ttl: int,
+        rrset_signer: Optional[RRsetSigner] = None,
+    ) -> None:
+        """NSEC zone signer helper"""
+        mandatory_types = set(
+            [dns.rdatatype.RdataType.RRSIG, dns.rdatatype.RdataType.NSEC]
+        )
+        node = txn.get_node(name)
+        if node and next_secure:
+            types = (
+                set([rdataset.rdtype for rdataset in node.rdatasets]) | mandatory_types
+            )
+            windows = Bitmap.from_rdtypes(list(types))
+            rrset = dns.rrset.from_rdata(
+                name,
+                ttl,
+                NSEC(
+                    rdclass=rdclass,
+                    rdtype=dns.rdatatype.RdataType.NSEC,
+                    next=next_secure,
+                    windows=windows,
+                ),
+            )
+            txn.add(rrset)
+            if rrset_signer:
+                rrset_signer(txn, rrset)
+
+    rrsig_ttl = zone.get_soa().minimum
+    delegation = None
+    last_secure = None
+
+    for name in sorted(txn.iterate_names()):
+        if delegation and name.is_subdomain(delegation):
+            # names below delegations are not secure
+            continue
+        elif txn.get(name, dns.rdatatype.NS) and name != zone.origin:
+            # inside delegation
+            delegation = name
+        else:
+            # outside delegation
+            delegation = None
+
+        if rrset_signer:
+            node = txn.get_node(name)
+            if node:
+                for rdataset in node.rdatasets:
+                    if rdataset.rdtype == dns.rdatatype.RRSIG:
+                        # do not sign RRSIGs
+                        continue
+                    elif delegation and rdataset.rdtype != dns.rdatatype.DS:
+                        # do not sign delegations except DS records
+                        continue
+                    else:
+                        rrset = dns.rrset.from_rdata(name, rdataset.ttl, *rdataset)
+                        rrset_signer(txn, rrset)
+
+        # We need "is not None" as the empty name is False because its length is 0.
+        if last_secure is not None:
+            _txn_add_nsec(txn, last_secure, name, zone.rdclass, rrsig_ttl, rrset_signer)
+        last_secure = name
+
+    if last_secure:
+        _txn_add_nsec(
+            txn, last_secure, zone.origin, zone.rdclass, rrsig_ttl, rrset_signer
+        )
+
+
 def _need_pyca(*args, **kwargs):
     raise ImportError(
-        "DNSSEC validation requires " + "python cryptography"
+        "DNSSEC validation requires python cryptography"
     )  # pragma: no cover
 
 
 try:
     from cryptography.exceptions import InvalidSignature
-    from cryptography.hazmat.backends import default_backend
-    from cryptography.hazmat.primitives import hashes, serialization
-    from cryptography.hazmat.primitives.asymmetric import padding
-    from cryptography.hazmat.primitives.asymmetric import utils
-    from cryptography.hazmat.primitives.asymmetric import dsa
-    from cryptography.hazmat.primitives.asymmetric import ec
-    from cryptography.hazmat.primitives.asymmetric import ed25519
-    from cryptography.hazmat.primitives.asymmetric import ed448
-    from cryptography.hazmat.primitives.asymmetric import rsa
+    from cryptography.hazmat.primitives.asymmetric import dsa  # pylint: disable=W0611
+    from cryptography.hazmat.primitives.asymmetric import ec  # pylint: disable=W0611
+    from cryptography.hazmat.primitives.asymmetric import ed448  # pylint: disable=W0611
+    from cryptography.hazmat.primitives.asymmetric import rsa  # pylint: disable=W0611
+    from cryptography.hazmat.primitives.asymmetric import (  # pylint: disable=W0611
+        ed25519,
+    )
+
+    from dns.dnssecalgs import (  # pylint: disable=C0412
+        get_algorithm_cls,
+        get_algorithm_cls_from_dnskey,
+    )
+    from dns.dnssecalgs.base import GenericPrivateKey, GenericPublicKey
 except ImportError:  # pragma: no cover
     validate = _need_pyca
     validate_rrsig = _need_pyca
diff --git a/lib/dns/dnssecalgs/__init__.py b/lib/dns/dnssecalgs/__init__.py
new file mode 100644
index 00000000..d1ffd519
--- /dev/null
+++ b/lib/dns/dnssecalgs/__init__.py
@@ -0,0 +1,121 @@
+from typing import Dict, Optional, Tuple, Type, Union
+
+import dns.name
+
+try:
+    from dns.dnssecalgs.base import GenericPrivateKey
+    from dns.dnssecalgs.dsa import PrivateDSA, PrivateDSANSEC3SHA1
+    from dns.dnssecalgs.ecdsa import PrivateECDSAP256SHA256, PrivateECDSAP384SHA384
+    from dns.dnssecalgs.eddsa import PrivateED448, PrivateED25519
+    from dns.dnssecalgs.rsa import (
+        PrivateRSAMD5,
+        PrivateRSASHA1,
+        PrivateRSASHA1NSEC3SHA1,
+        PrivateRSASHA256,
+        PrivateRSASHA512,
+    )
+
+    _have_cryptography = True
+except ImportError:
+    _have_cryptography = False
+
+from dns.dnssectypes import Algorithm
+from dns.exception import UnsupportedAlgorithm
+from dns.rdtypes.ANY.DNSKEY import DNSKEY
+
+AlgorithmPrefix = Optional[Union[bytes, dns.name.Name]]
+
+algorithms: Dict[Tuple[Algorithm, AlgorithmPrefix], Type[GenericPrivateKey]] = {}
+if _have_cryptography:
+    algorithms.update(
+        {
+            (Algorithm.RSAMD5, None): PrivateRSAMD5,
+            (Algorithm.DSA, None): PrivateDSA,
+            (Algorithm.RSASHA1, None): PrivateRSASHA1,
+            (Algorithm.DSANSEC3SHA1, None): PrivateDSANSEC3SHA1,
+            (Algorithm.RSASHA1NSEC3SHA1, None): PrivateRSASHA1NSEC3SHA1,
+            (Algorithm.RSASHA256, None): PrivateRSASHA256,
+            (Algorithm.RSASHA512, None): PrivateRSASHA512,
+            (Algorithm.ECDSAP256SHA256, None): PrivateECDSAP256SHA256,
+            (Algorithm.ECDSAP384SHA384, None): PrivateECDSAP384SHA384,
+            (Algorithm.ED25519, None): PrivateED25519,
+            (Algorithm.ED448, None): PrivateED448,
+        }
+    )
+
+
+def get_algorithm_cls(
+    algorithm: Union[int, str], prefix: AlgorithmPrefix = None
+) -> Type[GenericPrivateKey]:
+    """Get Private Key class from Algorithm.
+
+    *algorithm*, a ``str`` or ``int`` specifying the DNSKEY algorithm.
+
+    Raises ``UnsupportedAlgorithm`` if the algorithm is unknown.
+
+    Returns a ``dns.dnssecalgs.GenericPrivateKey``
+    """
+    algorithm = Algorithm.make(algorithm)
+    cls = algorithms.get((algorithm, prefix))
+    if cls:
+        return cls
+    raise UnsupportedAlgorithm(
+        'algorithm "%s" not supported by dnspython' % Algorithm.to_text(algorithm)
+    )
+
+
+def get_algorithm_cls_from_dnskey(dnskey: DNSKEY) -> Type[GenericPrivateKey]:
+    """Get Private Key class from DNSKEY.
+
+    *dnskey*, a ``DNSKEY`` to get Algorithm class for.
+
+    Raises ``UnsupportedAlgorithm`` if the algorithm is unknown.
+
+    Returns a ``dns.dnssecalgs.GenericPrivateKey``
+    """
+    prefix: AlgorithmPrefix = None
+    if dnskey.algorithm == Algorithm.PRIVATEDNS:
+        prefix, _ = dns.name.from_wire(dnskey.key, 0)
+    elif dnskey.algorithm == Algorithm.PRIVATEOID:
+        length = int(dnskey.key[0])
+        prefix = dnskey.key[0 : length + 1]
+    return get_algorithm_cls(dnskey.algorithm, prefix)
+
+
+def register_algorithm_cls(
+    algorithm: Union[int, str],
+    algorithm_cls: Type[GenericPrivateKey],
+    name: Optional[Union[dns.name.Name, str]] = None,
+    oid: Optional[bytes] = None,
+) -> None:
+    """Register Algorithm Private Key class.
+
+    *algorithm*, a ``str`` or ``int`` specifying the DNSKEY algorithm.
+
+    *algorithm_cls*: A `GenericPrivateKey` class.
+
+    *name*, an optional ``dns.name.Name`` or ``str``, for for PRIVATEDNS algorithms.
+
+    *oid*: an optional BER-encoded `bytes` for PRIVATEOID algorithms.
+
+    Raises ``ValueError`` if a name or oid is specified incorrectly.
+    """
+    if not issubclass(algorithm_cls, GenericPrivateKey):
+        raise TypeError("Invalid algorithm class")
+    algorithm = Algorithm.make(algorithm)
+    prefix: AlgorithmPrefix = None
+    if algorithm == Algorithm.PRIVATEDNS:
+        if name is None:
+            raise ValueError("Name required for PRIVATEDNS algorithms")
+        if isinstance(name, str):
+            name = dns.name.from_text(name)
+        prefix = name
+    elif algorithm == Algorithm.PRIVATEOID:
+        if oid is None:
+            raise ValueError("OID required for PRIVATEOID algorithms")
+        prefix = bytes([len(oid)]) + oid
+    elif name:
+        raise ValueError("Name only supported for PRIVATEDNS algorithm")
+    elif oid:
+        raise ValueError("OID only supported for PRIVATEOID algorithm")
+    algorithms[(algorithm, prefix)] = algorithm_cls
diff --git a/lib/dns/dnssecalgs/base.py b/lib/dns/dnssecalgs/base.py
new file mode 100644
index 00000000..e990575a
--- /dev/null
+++ b/lib/dns/dnssecalgs/base.py
@@ -0,0 +1,84 @@
+from abc import ABC, abstractmethod  # pylint: disable=no-name-in-module
+from typing import Any, Optional, Type
+
+import dns.rdataclass
+import dns.rdatatype
+from dns.dnssectypes import Algorithm
+from dns.exception import AlgorithmKeyMismatch
+from dns.rdtypes.ANY.DNSKEY import DNSKEY
+from dns.rdtypes.dnskeybase import Flag
+
+
+class GenericPublicKey(ABC):
+    algorithm: Algorithm
+
+    @abstractmethod
+    def __init__(self, key: Any) -> None:
+        pass
+
+    @abstractmethod
+    def verify(self, signature: bytes, data: bytes) -> None:
+        """Verify signed DNSSEC data"""
+
+    @abstractmethod
+    def encode_key_bytes(self) -> bytes:
+        """Encode key as bytes for DNSKEY"""
+
+    @classmethod
+    def _ensure_algorithm_key_combination(cls, key: DNSKEY) -> None:
+        if key.algorithm != cls.algorithm:
+            raise AlgorithmKeyMismatch
+
+    def to_dnskey(self, flags: int = Flag.ZONE, protocol: int = 3) -> DNSKEY:
+        """Return public key as DNSKEY"""
+        return DNSKEY(
+            rdclass=dns.rdataclass.IN,
+            rdtype=dns.rdatatype.DNSKEY,
+            flags=flags,
+            protocol=protocol,
+            algorithm=self.algorithm,
+            key=self.encode_key_bytes(),
+        )
+
+    @classmethod
+    @abstractmethod
+    def from_dnskey(cls, key: DNSKEY) -> "GenericPublicKey":
+        """Create public key from DNSKEY"""
+
+    @classmethod
+    @abstractmethod
+    def from_pem(cls, public_pem: bytes) -> "GenericPublicKey":
+        """Create public key from PEM-encoded SubjectPublicKeyInfo as specified
+        in RFC 5280"""
+
+    @abstractmethod
+    def to_pem(self) -> bytes:
+        """Return public-key as PEM-encoded SubjectPublicKeyInfo as specified
+        in RFC 5280"""
+
+
+class GenericPrivateKey(ABC):
+    public_cls: Type[GenericPublicKey]
+
+    @abstractmethod
+    def __init__(self, key: Any) -> None:
+        pass
+
+    @abstractmethod
+    def sign(self, data: bytes, verify: bool = False) -> bytes:
+        """Sign DNSSEC data"""
+
+    @abstractmethod
+    def public_key(self) -> "GenericPublicKey":
+        """Return public key instance"""
+
+    @classmethod
+    @abstractmethod
+    def from_pem(
+        cls, private_pem: bytes, password: Optional[bytes] = None
+    ) -> "GenericPrivateKey":
+        """Create private key from PEM-encoded PKCS#8"""
+
+    @abstractmethod
+    def to_pem(self, password: Optional[bytes] = None) -> bytes:
+        """Return private key as PEM-encoded PKCS#8"""
diff --git a/lib/dns/dnssecalgs/cryptography.py b/lib/dns/dnssecalgs/cryptography.py
new file mode 100644
index 00000000..5a31a812
--- /dev/null
+++ b/lib/dns/dnssecalgs/cryptography.py
@@ -0,0 +1,68 @@
+from typing import Any, Optional, Type
+
+from cryptography.hazmat.primitives import serialization
+
+from dns.dnssecalgs.base import GenericPrivateKey, GenericPublicKey
+from dns.exception import AlgorithmKeyMismatch
+
+
+class CryptographyPublicKey(GenericPublicKey):
+    key: Any = None
+    key_cls: Any = None
+
+    def __init__(self, key: Any) -> None:  # pylint: disable=super-init-not-called
+        if self.key_cls is None:
+            raise TypeError("Undefined private key class")
+        if not isinstance(  # pylint: disable=isinstance-second-argument-not-valid-type
+            key, self.key_cls
+        ):
+            raise AlgorithmKeyMismatch
+        self.key = key
+
+    @classmethod
+    def from_pem(cls, public_pem: bytes) -> "GenericPublicKey":
+        key = serialization.load_pem_public_key(public_pem)
+        return cls(key=key)
+
+    def to_pem(self) -> bytes:
+        return self.key.public_bytes(
+            encoding=serialization.Encoding.PEM,
+            format=serialization.PublicFormat.SubjectPublicKeyInfo,
+        )
+
+
+class CryptographyPrivateKey(GenericPrivateKey):
+    key: Any = None
+    key_cls: Any = None
+    public_cls: Type[CryptographyPublicKey]
+
+    def __init__(self, key: Any) -> None:  # pylint: disable=super-init-not-called
+        if self.key_cls is None:
+            raise TypeError("Undefined private key class")
+        if not isinstance(  # pylint: disable=isinstance-second-argument-not-valid-type
+            key, self.key_cls
+        ):
+            raise AlgorithmKeyMismatch
+        self.key = key
+
+    def public_key(self) -> "CryptographyPublicKey":
+        return self.public_cls(key=self.key.public_key())
+
+    @classmethod
+    def from_pem(
+        cls, private_pem: bytes, password: Optional[bytes] = None
+    ) -> "GenericPrivateKey":
+        key = serialization.load_pem_private_key(private_pem, password=password)
+        return cls(key=key)
+
+    def to_pem(self, password: Optional[bytes] = None) -> bytes:
+        encryption_algorithm: serialization.KeySerializationEncryption
+        if password:
+            encryption_algorithm = serialization.BestAvailableEncryption(password)
+        else:
+            encryption_algorithm = serialization.NoEncryption()
+        return self.key.private_bytes(
+            encoding=serialization.Encoding.PEM,
+            format=serialization.PrivateFormat.PKCS8,
+            encryption_algorithm=encryption_algorithm,
+        )
diff --git a/lib/dns/dnssecalgs/dsa.py b/lib/dns/dnssecalgs/dsa.py
new file mode 100644
index 00000000..0fe4690d
--- /dev/null
+++ b/lib/dns/dnssecalgs/dsa.py
@@ -0,0 +1,101 @@
+import struct
+
+from cryptography.hazmat.backends import default_backend
+from cryptography.hazmat.primitives import hashes
+from cryptography.hazmat.primitives.asymmetric import dsa, utils
+
+from dns.dnssecalgs.cryptography import CryptographyPrivateKey, CryptographyPublicKey
+from dns.dnssectypes import Algorithm
+from dns.rdtypes.ANY.DNSKEY import DNSKEY
+
+
+class PublicDSA(CryptographyPublicKey):
+    key: dsa.DSAPublicKey
+    key_cls = dsa.DSAPublicKey
+    algorithm = Algorithm.DSA
+    chosen_hash = hashes.SHA1()
+
+    def verify(self, signature: bytes, data: bytes) -> None:
+        sig_r = signature[1:21]
+        sig_s = signature[21:]
+        sig = utils.encode_dss_signature(
+            int.from_bytes(sig_r, "big"), int.from_bytes(sig_s, "big")
+        )
+        self.key.verify(sig, data, self.chosen_hash)
+
+    def encode_key_bytes(self) -> bytes:
+        """Encode a public key per RFC 2536, section 2."""
+        pn = self.key.public_numbers()
+        dsa_t = (self.key.key_size // 8 - 64) // 8
+        if dsa_t > 8:
+            raise ValueError("unsupported DSA key size")
+        octets = 64 + dsa_t * 8
+        res = struct.pack("!B", dsa_t)
+        res += pn.parameter_numbers.q.to_bytes(20, "big")
+        res += pn.parameter_numbers.p.to_bytes(octets, "big")
+        res += pn.parameter_numbers.g.to_bytes(octets, "big")
+        res += pn.y.to_bytes(octets, "big")
+        return res
+
+    @classmethod
+    def from_dnskey(cls, key: DNSKEY) -> "PublicDSA":
+        cls._ensure_algorithm_key_combination(key)
+        keyptr = key.key
+        (t,) = struct.unpack("!B", keyptr[0:1])
+        keyptr = keyptr[1:]
+        octets = 64 + t * 8
+        dsa_q = keyptr[0:20]
+        keyptr = keyptr[20:]
+        dsa_p = keyptr[0:octets]
+        keyptr = keyptr[octets:]
+        dsa_g = keyptr[0:octets]
+        keyptr = keyptr[octets:]
+        dsa_y = keyptr[0:octets]
+        return cls(
+            key=dsa.DSAPublicNumbers(  # type: ignore
+                int.from_bytes(dsa_y, "big"),
+                dsa.DSAParameterNumbers(
+                    int.from_bytes(dsa_p, "big"),
+                    int.from_bytes(dsa_q, "big"),
+                    int.from_bytes(dsa_g, "big"),
+                ),
+            ).public_key(default_backend()),
+        )
+
+
+class PrivateDSA(CryptographyPrivateKey):
+    key: dsa.DSAPrivateKey
+    key_cls = dsa.DSAPrivateKey
+    public_cls = PublicDSA
+
+    def sign(self, data: bytes, verify: bool = False) -> bytes:
+        """Sign using a private key per RFC 2536, section 3."""
+        public_dsa_key = self.key.public_key()
+        if public_dsa_key.key_size > 1024:
+            raise ValueError("DSA key size overflow")
+        der_signature = self.key.sign(data, self.public_cls.chosen_hash)
+        dsa_r, dsa_s = utils.decode_dss_signature(der_signature)
+        dsa_t = (public_dsa_key.key_size // 8 - 64) // 8
+        octets = 20
+        signature = (
+            struct.pack("!B", dsa_t)
+            + int.to_bytes(dsa_r, length=octets, byteorder="big")
+            + int.to_bytes(dsa_s, length=octets, byteorder="big")
+        )
+        if verify:
+            self.public_key().verify(signature, data)
+        return signature
+
+    @classmethod
+    def generate(cls, key_size: int) -> "PrivateDSA":
+        return cls(
+            key=dsa.generate_private_key(key_size=key_size),
+        )
+
+
+class PublicDSANSEC3SHA1(PublicDSA):
+    algorithm = Algorithm.DSANSEC3SHA1
+
+
+class PrivateDSANSEC3SHA1(PrivateDSA):
+    public_cls = PublicDSANSEC3SHA1
diff --git a/lib/dns/dnssecalgs/ecdsa.py b/lib/dns/dnssecalgs/ecdsa.py
new file mode 100644
index 00000000..a31d79f2
--- /dev/null
+++ b/lib/dns/dnssecalgs/ecdsa.py
@@ -0,0 +1,89 @@
+from cryptography.hazmat.backends import default_backend
+from cryptography.hazmat.primitives import hashes
+from cryptography.hazmat.primitives.asymmetric import ec, utils
+
+from dns.dnssecalgs.cryptography import CryptographyPrivateKey, CryptographyPublicKey
+from dns.dnssectypes import Algorithm
+from dns.rdtypes.ANY.DNSKEY import DNSKEY
+
+
+class PublicECDSA(CryptographyPublicKey):
+    key: ec.EllipticCurvePublicKey
+    key_cls = ec.EllipticCurvePublicKey
+    algorithm: Algorithm
+    chosen_hash: hashes.HashAlgorithm
+    curve: ec.EllipticCurve
+    octets: int
+
+    def verify(self, signature: bytes, data: bytes) -> None:
+        sig_r = signature[0 : self.octets]
+        sig_s = signature[self.octets :]
+        sig = utils.encode_dss_signature(
+            int.from_bytes(sig_r, "big"), int.from_bytes(sig_s, "big")
+        )
+        self.key.verify(sig, data, ec.ECDSA(self.chosen_hash))
+
+    def encode_key_bytes(self) -> bytes:
+        """Encode a public key per RFC 6605, section 4."""
+        pn = self.key.public_numbers()
+        return pn.x.to_bytes(self.octets, "big") + pn.y.to_bytes(self.octets, "big")
+
+    @classmethod
+    def from_dnskey(cls, key: DNSKEY) -> "PublicECDSA":
+        cls._ensure_algorithm_key_combination(key)
+        ecdsa_x = key.key[0 : cls.octets]
+        ecdsa_y = key.key[cls.octets : cls.octets * 2]
+        return cls(
+            key=ec.EllipticCurvePublicNumbers(
+                curve=cls.curve,
+                x=int.from_bytes(ecdsa_x, "big"),
+                y=int.from_bytes(ecdsa_y, "big"),
+            ).public_key(default_backend()),
+        )
+
+
+class PrivateECDSA(CryptographyPrivateKey):
+    key: ec.EllipticCurvePrivateKey
+    key_cls = ec.EllipticCurvePrivateKey
+    public_cls = PublicECDSA
+
+    def sign(self, data: bytes, verify: bool = False) -> bytes:
+        """Sign using a private key per RFC 6605, section 4."""
+        der_signature = self.key.sign(data, ec.ECDSA(self.public_cls.chosen_hash))
+        dsa_r, dsa_s = utils.decode_dss_signature(der_signature)
+        signature = int.to_bytes(
+            dsa_r, length=self.public_cls.octets, byteorder="big"
+        ) + int.to_bytes(dsa_s, length=self.public_cls.octets, byteorder="big")
+        if verify:
+            self.public_key().verify(signature, data)
+        return signature
+
+    @classmethod
+    def generate(cls) -> "PrivateECDSA":
+        return cls(
+            key=ec.generate_private_key(
+                curve=cls.public_cls.curve, backend=default_backend()
+            ),
+        )
+
+
+class PublicECDSAP256SHA256(PublicECDSA):
+    algorithm = Algorithm.ECDSAP256SHA256
+    chosen_hash = hashes.SHA256()
+    curve = ec.SECP256R1()
+    octets = 32
+
+
+class PrivateECDSAP256SHA256(PrivateECDSA):
+    public_cls = PublicECDSAP256SHA256
+
+
+class PublicECDSAP384SHA384(PublicECDSA):
+    algorithm = Algorithm.ECDSAP384SHA384
+    chosen_hash = hashes.SHA384()
+    curve = ec.SECP384R1()
+    octets = 48
+
+
+class PrivateECDSAP384SHA384(PrivateECDSA):
+    public_cls = PublicECDSAP384SHA384
diff --git a/lib/dns/dnssecalgs/eddsa.py b/lib/dns/dnssecalgs/eddsa.py
new file mode 100644
index 00000000..70505342
--- /dev/null
+++ b/lib/dns/dnssecalgs/eddsa.py
@@ -0,0 +1,65 @@
+from typing import Type
+
+from cryptography.hazmat.primitives import serialization
+from cryptography.hazmat.primitives.asymmetric import ed448, ed25519
+
+from dns.dnssecalgs.cryptography import CryptographyPrivateKey, CryptographyPublicKey
+from dns.dnssectypes import Algorithm
+from dns.rdtypes.ANY.DNSKEY import DNSKEY
+
+
+class PublicEDDSA(CryptographyPublicKey):
+    def verify(self, signature: bytes, data: bytes) -> None:
+        self.key.verify(signature, data)
+
+    def encode_key_bytes(self) -> bytes:
+        """Encode a public key per RFC 8080, section 3."""
+        return self.key.public_bytes(
+            encoding=serialization.Encoding.Raw, format=serialization.PublicFormat.Raw
+        )
+
+    @classmethod
+    def from_dnskey(cls, key: DNSKEY) -> "PublicEDDSA":
+        cls._ensure_algorithm_key_combination(key)
+        return cls(
+            key=cls.key_cls.from_public_bytes(key.key),
+        )
+
+
+class PrivateEDDSA(CryptographyPrivateKey):
+    public_cls: Type[PublicEDDSA]
+
+    def sign(self, data: bytes, verify: bool = False) -> bytes:
+        """Sign using a private key per RFC 8080, section 4."""
+        signature = self.key.sign(data)
+        if verify:
+            self.public_key().verify(signature, data)
+        return signature
+
+    @classmethod
+    def generate(cls) -> "PrivateEDDSA":
+        return cls(key=cls.key_cls.generate())
+
+
+class PublicED25519(PublicEDDSA):
+    key: ed25519.Ed25519PublicKey
+    key_cls = ed25519.Ed25519PublicKey
+    algorithm = Algorithm.ED25519
+
+
+class PrivateED25519(PrivateEDDSA):
+    key: ed25519.Ed25519PrivateKey
+    key_cls = ed25519.Ed25519PrivateKey
+    public_cls = PublicED25519
+
+
+class PublicED448(PublicEDDSA):
+    key: ed448.Ed448PublicKey
+    key_cls = ed448.Ed448PublicKey
+    algorithm = Algorithm.ED448
+
+
+class PrivateED448(PrivateEDDSA):
+    key: ed448.Ed448PrivateKey
+    key_cls = ed448.Ed448PrivateKey
+    public_cls = PublicED448
diff --git a/lib/dns/dnssecalgs/rsa.py b/lib/dns/dnssecalgs/rsa.py
new file mode 100644
index 00000000..e95dcf1d
--- /dev/null
+++ b/lib/dns/dnssecalgs/rsa.py
@@ -0,0 +1,119 @@
+import math
+import struct
+
+from cryptography.hazmat.backends import default_backend
+from cryptography.hazmat.primitives import hashes
+from cryptography.hazmat.primitives.asymmetric import padding, rsa
+
+from dns.dnssecalgs.cryptography import CryptographyPrivateKey, CryptographyPublicKey
+from dns.dnssectypes import Algorithm
+from dns.rdtypes.ANY.DNSKEY import DNSKEY
+
+
+class PublicRSA(CryptographyPublicKey):
+    key: rsa.RSAPublicKey
+    key_cls = rsa.RSAPublicKey
+    algorithm: Algorithm
+    chosen_hash: hashes.HashAlgorithm
+
+    def verify(self, signature: bytes, data: bytes) -> None:
+        self.key.verify(signature, data, padding.PKCS1v15(), self.chosen_hash)
+
+    def encode_key_bytes(self) -> bytes:
+        """Encode a public key per RFC 3110, section 2."""
+        pn = self.key.public_numbers()
+        _exp_len = math.ceil(int.bit_length(pn.e) / 8)
+        exp = int.to_bytes(pn.e, length=_exp_len, byteorder="big")
+        if _exp_len > 255:
+            exp_header = b"\0" + struct.pack("!H", _exp_len)
+        else:
+            exp_header = struct.pack("!B", _exp_len)
+        if pn.n.bit_length() < 512 or pn.n.bit_length() > 4096:
+            raise ValueError("unsupported RSA key length")
+        return exp_header + exp + pn.n.to_bytes((pn.n.bit_length() + 7) // 8, "big")
+
+    @classmethod
+    def from_dnskey(cls, key: DNSKEY) -> "PublicRSA":
+        cls._ensure_algorithm_key_combination(key)
+        keyptr = key.key
+        (bytes_,) = struct.unpack("!B", keyptr[0:1])
+        keyptr = keyptr[1:]
+        if bytes_ == 0:
+            (bytes_,) = struct.unpack("!H", keyptr[0:2])
+            keyptr = keyptr[2:]
+        rsa_e = keyptr[0:bytes_]
+        rsa_n = keyptr[bytes_:]
+        return cls(
+            key=rsa.RSAPublicNumbers(
+                int.from_bytes(rsa_e, "big"), int.from_bytes(rsa_n, "big")
+            ).public_key(default_backend())
+        )
+
+
+class PrivateRSA(CryptographyPrivateKey):
+    key: rsa.RSAPrivateKey
+    key_cls = rsa.RSAPrivateKey
+    public_cls = PublicRSA
+    default_public_exponent = 65537
+
+    def sign(self, data: bytes, verify: bool = False) -> bytes:
+        """Sign using a private key per RFC 3110, section 3."""
+        signature = self.key.sign(data, padding.PKCS1v15(), self.public_cls.chosen_hash)
+        if verify:
+            self.public_key().verify(signature, data)
+        return signature
+
+    @classmethod
+    def generate(cls, key_size: int) -> "PrivateRSA":
+        return cls(
+            key=rsa.generate_private_key(
+                public_exponent=cls.default_public_exponent,
+                key_size=key_size,
+                backend=default_backend(),
+            )
+        )
+
+
+class PublicRSAMD5(PublicRSA):
+    algorithm = Algorithm.RSAMD5
+    chosen_hash = hashes.MD5()
+
+
+class PrivateRSAMD5(PrivateRSA):
+    public_cls = PublicRSAMD5
+
+
+class PublicRSASHA1(PublicRSA):
+    algorithm = Algorithm.RSASHA1
+    chosen_hash = hashes.SHA1()
+
+
+class PrivateRSASHA1(PrivateRSA):
+    public_cls = PublicRSASHA1
+
+
+class PublicRSASHA1NSEC3SHA1(PublicRSA):
+    algorithm = Algorithm.RSASHA1NSEC3SHA1
+    chosen_hash = hashes.SHA1()
+
+
+class PrivateRSASHA1NSEC3SHA1(PrivateRSA):
+    public_cls = PublicRSASHA1NSEC3SHA1
+
+
+class PublicRSASHA256(PublicRSA):
+    algorithm = Algorithm.RSASHA256
+    chosen_hash = hashes.SHA256()
+
+
+class PrivateRSASHA256(PrivateRSA):
+    public_cls = PublicRSASHA256
+
+
+class PublicRSASHA512(PublicRSA):
+    algorithm = Algorithm.RSASHA512
+    chosen_hash = hashes.SHA512()
+
+
+class PrivateRSASHA512(PrivateRSA):
+    public_cls = PublicRSASHA512
diff --git a/lib/dns/edns.py b/lib/dns/edns.py
index 64436cde..f05baac4 100644
--- a/lib/dns/edns.py
+++ b/lib/dns/edns.py
@@ -17,11 +17,10 @@
 
 """EDNS Options"""
 
-from typing import Any, Dict, Optional, Union
-
 import math
 import socket
 import struct
+from typing import Any, Dict, Optional, Union
 
 import dns.enum
 import dns.inet
@@ -380,7 +379,7 @@ class EDEOption(Option):  # lgtm[py/missing-equals]
     def from_wire_parser(
         cls, otype: Union[OptionType, str], parser: "dns.wire.Parser"
     ) -> Option:
-        the_code = EDECode.make(parser.get_uint16())
+        code = EDECode.make(parser.get_uint16())
         text = parser.get_remaining()
 
         if text:
@@ -390,7 +389,7 @@ class EDEOption(Option):  # lgtm[py/missing-equals]
         else:
             btext = None
 
-        return cls(the_code, btext)
+        return cls(code, btext)
 
 
 _type_to_class: Dict[OptionType, Any] = {
@@ -424,8 +423,8 @@ def option_from_wire_parser(
 
     Returns an instance of a subclass of ``dns.edns.Option``.
     """
-    the_otype = OptionType.make(otype)
-    cls = get_option_class(the_otype)
+    otype = OptionType.make(otype)
+    cls = get_option_class(otype)
     return cls.from_wire_parser(otype, parser)
 
 
diff --git a/lib/dns/entropy.py b/lib/dns/entropy.py
index 5e1f5e23..4dcdc627 100644
--- a/lib/dns/entropy.py
+++ b/lib/dns/entropy.py
@@ -15,17 +15,15 @@
 # ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
 # OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 
-from typing import Any, Optional
-
-import os
 import hashlib
+import os
 import random
 import threading
 import time
+from typing import Any, Optional
 
 
 class EntropyPool:
-
     # This is an entropy pool for Python implementations that do not
     # have a working SystemRandom.  I'm not sure there are any, but
     # leaving this code doesn't hurt anything as the library code
diff --git a/lib/dns/enum.py b/lib/dns/enum.py
index b5a4aed8..71461f17 100644
--- a/lib/dns/enum.py
+++ b/lib/dns/enum.py
@@ -16,18 +16,31 @@
 # OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 
 import enum
+from typing import Type, TypeVar, Union
+
+TIntEnum = TypeVar("TIntEnum", bound="IntEnum")
 
 
 class IntEnum(enum.IntEnum):
     @classmethod
-    def _check_value(cls, value):
-        max = cls._maximum()
-        if value < 0 or value > max:
-            name = cls._short_name()
-            raise ValueError(f"{name} must be between >= 0 and <= {max}")
+    def _missing_(cls, value):
+        cls._check_value(value)
+        val = int.__new__(cls, value)
+        val._name_ = cls._extra_to_text(value, None) or f"{cls._prefix()}{value}"
+        val._value_ = value
+        return val
 
     @classmethod
-    def from_text(cls, text):
+    def _check_value(cls, value):
+        max = cls._maximum()
+        if not isinstance(value, int):
+            raise TypeError
+        if value < 0 or value > max:
+            name = cls._short_name()
+            raise ValueError(f"{name} must be an int between >= 0 and <= {max}")
+
+    @classmethod
+    def from_text(cls: Type[TIntEnum], text: str) -> TIntEnum:
         text = text.upper()
         try:
             return cls[text]
@@ -47,7 +60,7 @@ class IntEnum(enum.IntEnum):
         raise cls._unknown_exception_class()
 
     @classmethod
-    def to_text(cls, value):
+    def to_text(cls: Type[TIntEnum], value: int) -> str:
         cls._check_value(value)
         try:
             text = cls(value).name
@@ -59,7 +72,7 @@ class IntEnum(enum.IntEnum):
         return text
 
     @classmethod
-    def make(cls, value):
+    def make(cls: Type[TIntEnum], value: Union[int, str]) -> TIntEnum:
         """Convert text or a value into an enumerated type, if possible.
 
         *value*, the ``int`` or ``str`` to convert.
@@ -76,10 +89,7 @@ class IntEnum(enum.IntEnum):
         if isinstance(value, str):
             return cls.from_text(value)
         cls._check_value(value)
-        try:
-            return cls(value)
-        except ValueError:
-            return value
+        return cls(value)
 
     @classmethod
     def _maximum(cls):
diff --git a/lib/dns/exception.py b/lib/dns/exception.py
index 4b1481d1..6982373d 100644
--- a/lib/dns/exception.py
+++ b/lib/dns/exception.py
@@ -140,6 +140,22 @@ class Timeout(DNSException):
         super().__init__(*args, **kwargs)
 
 
+class UnsupportedAlgorithm(DNSException):
+    """The DNSSEC algorithm is not supported."""
+
+
+class AlgorithmKeyMismatch(UnsupportedAlgorithm):
+    """The DNSSEC algorithm is not supported for the given key type."""
+
+
+class ValidationFailure(DNSException):
+    """The DNSSEC signature is invalid."""
+
+
+class DeniedByPolicy(DNSException):
+    """Denied by DNSSEC policy."""
+
+
 class ExceptionWrapper:
     def __init__(self, exception_class):
         self.exception_class = exception_class
diff --git a/lib/dns/flags.py b/lib/dns/flags.py
index b21b8e3b..4c60be13 100644
--- a/lib/dns/flags.py
+++ b/lib/dns/flags.py
@@ -17,9 +17,8 @@
 
 """DNS Message Flags."""
 
-from typing import Any
-
 import enum
+from typing import Any
 
 # Standard DNS flags
 
diff --git a/lib/dns/immutable.py b/lib/dns/immutable.py
index 38fbe597..cab8d6fb 100644
--- a/lib/dns/immutable.py
+++ b/lib/dns/immutable.py
@@ -1,8 +1,7 @@
 # Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license
 
-from typing import Any
-
 import collections.abc
+from typing import Any
 
 from dns._immutable_ctx import immutable
 
diff --git a/lib/dns/inet.py b/lib/dns/inet.py
index 11180c96..02e925c6 100644
--- a/lib/dns/inet.py
+++ b/lib/dns/inet.py
@@ -17,14 +17,12 @@
 
 """Generic Internet address helper functions."""
 
-from typing import Any, Optional, Tuple
-
 import socket
+from typing import Any, Optional, Tuple
 
 import dns.ipv4
 import dns.ipv6
 
-
 # We assume that AF_INET and AF_INET6 are always defined.  We keep
 # these here for the benefit of any old code (unlikely though that
 # is!).
@@ -171,3 +169,12 @@ def low_level_address_tuple(
             return tup
     else:
         raise NotImplementedError(f"unknown address family {af}")
+
+
+def any_for_af(af):
+    """Return the 'any' address for the specified address family."""
+    if af == socket.AF_INET:
+        return "0.0.0.0"
+    elif af == socket.AF_INET6:
+        return "::"
+    raise NotImplementedError(f"unknown address family {af}")
diff --git a/lib/dns/ipv4.py b/lib/dns/ipv4.py
index b8e148f3..f549150a 100644
--- a/lib/dns/ipv4.py
+++ b/lib/dns/ipv4.py
@@ -17,9 +17,8 @@
 
 """IPv4 helper functions."""
 
-from typing import Union
-
 import struct
+from typing import Union
 
 import dns.exception
 
diff --git a/lib/dns/ipv6.py b/lib/dns/ipv6.py
index fbd49623..0cc3d868 100644
--- a/lib/dns/ipv6.py
+++ b/lib/dns/ipv6.py
@@ -17,10 +17,9 @@
 
 """IPv6 helper functions."""
 
-from typing import List, Union
-
-import re
 import binascii
+import re
+from typing import List, Union
 
 import dns.exception
 import dns.ipv4
diff --git a/lib/dns/message.py b/lib/dns/message.py
index 8250db3b..daae6363 100644
--- a/lib/dns/message.py
+++ b/lib/dns/message.py
@@ -17,30 +17,29 @@
 
 """DNS Messages"""
 
-from typing import Any, Dict, List, Optional, Tuple, Union
-
 import contextlib
 import io
 import time
+from typing import Any, Dict, List, Optional, Tuple, Union
 
-import dns.wire
 import dns.edns
+import dns.entropy
 import dns.enum
 import dns.exception
 import dns.flags
 import dns.name
 import dns.opcode
-import dns.entropy
 import dns.rcode
 import dns.rdata
 import dns.rdataclass
 import dns.rdatatype
-import dns.rrset
-import dns.renderer
-import dns.ttl
-import dns.tsig
 import dns.rdtypes.ANY.OPT
 import dns.rdtypes.ANY.TSIG
+import dns.renderer
+import dns.rrset
+import dns.tsig
+import dns.ttl
+import dns.wire
 
 
 class ShortHeader(dns.exception.FormError):
@@ -135,7 +134,7 @@ IndexKeyType = Tuple[
     Optional[dns.rdataclass.RdataClass],
 ]
 IndexType = Dict[IndexKeyType, dns.rrset.RRset]
-SectionType = Union[int, List[dns.rrset.RRset]]
+SectionType = Union[int, str, List[dns.rrset.RRset]]
 
 
 class Message:
@@ -231,7 +230,7 @@ class Message:
             s.write("payload %d\n" % self.payload)
         for opt in self.options:
             s.write("option %s\n" % opt.to_text())
-        for (name, which) in self._section_enum.__members__.items():
+        for name, which in self._section_enum.__members__.items():
             s.write(f";{name}\n")
             for rrset in self.section_from_number(which):
                 s.write(rrset.to_text(origin, relativize, **kw))
@@ -348,27 +347,29 @@ class Message:
         deleting: Optional[dns.rdataclass.RdataClass] = None,
         create: bool = False,
         force_unique: bool = False,
+        idna_codec: Optional[dns.name.IDNACodec] = None,
     ) -> dns.rrset.RRset:
         """Find the RRset with the given attributes in the specified section.
 
-        *section*, an ``int`` section number, or one of the section
-        attributes of this message.  This specifies the
+        *section*, an ``int`` section number, a ``str`` section name, or one of
+        the section attributes of this message.  This specifies the
         the section of the message to search.  For example::
 
             my_message.find_rrset(my_message.answer, name, rdclass, rdtype)
             my_message.find_rrset(dns.message.ANSWER, name, rdclass, rdtype)
+            my_message.find_rrset("ANSWER", name, rdclass, rdtype)
 
-        *name*, a ``dns.name.Name``, the name of the RRset.
+        *name*, a ``dns.name.Name`` or ``str``, the name of the RRset.
 
-        *rdclass*, an ``int``, the class of the RRset.
+        *rdclass*, an ``int`` or ``str``, the class of the RRset.
 
-        *rdtype*, an ``int``, the type of the RRset.
+        *rdtype*, an ``int`` or ``str``, the type of the RRset.
 
-        *covers*, an ``int`` or ``None``, the covers value of the RRset.
-        The default is ``None``.
+        *covers*, an ``int`` or ``str``, the covers value of the RRset.
+        The default is ``dns.rdatatype.NONE``.
 
-        *deleting*, an ``int`` or ``None``, the deleting value of the RRset.
-        The default is ``None``.
+        *deleting*, an ``int``, ``str``, or ``None``, the deleting value of the
+        RRset.  The default is ``None``.
 
         *create*, a ``bool``.  If ``True``, create the RRset if it is not found.
         The created RRset is appended to *section*.
@@ -378,6 +379,10 @@ class Message:
         already.  The default is ``False``.  This is useful when creating
         DDNS Update messages, as order matters for them.
 
+        *idna_codec*, a ``dns.name.IDNACodec``, specifies the IDNA
+        encoder/decoder.  If ``None``, the default IDNA 2003 encoder/decoder
+        is used.
+
         Raises ``KeyError`` if the RRset was not found and create was
         ``False``.
 
@@ -386,10 +391,19 @@ class Message:
 
         if isinstance(section, int):
             section_number = section
-            the_section = self.section_from_number(section_number)
+            section = self.section_from_number(section_number)
+        elif isinstance(section, str):
+            section_number = MessageSection.from_text(section)
+            section = self.section_from_number(section_number)
         else:
             section_number = self.section_number(section)
-            the_section = section
+        if isinstance(name, str):
+            name = dns.name.from_text(name, idna_codec=idna_codec)
+        rdtype = dns.rdatatype.RdataType.make(rdtype)
+        rdclass = dns.rdataclass.RdataClass.make(rdclass)
+        covers = dns.rdatatype.RdataType.make(covers)
+        if deleting is not None:
+            deleting = dns.rdataclass.RdataClass.make(deleting)
         key = (section_number, name, rdclass, rdtype, covers, deleting)
         if not force_unique:
             if self.index is not None:
@@ -397,13 +411,13 @@ class Message:
                 if rrset is not None:
                     return rrset
             else:
-                for rrset in the_section:
+                for rrset in section:
                     if rrset.full_match(name, rdclass, rdtype, covers, deleting):
                         return rrset
         if not create:
             raise KeyError
         rrset = dns.rrset.RRset(name, rdclass, rdtype, covers, deleting)
-        the_section.append(rrset)
+        section.append(rrset)
         if self.index is not None:
             self.index[key] = rrset
         return rrset
@@ -418,29 +432,31 @@ class Message:
         deleting: Optional[dns.rdataclass.RdataClass] = None,
         create: bool = False,
         force_unique: bool = False,
+        idna_codec: Optional[dns.name.IDNACodec] = None,
     ) -> Optional[dns.rrset.RRset]:
         """Get the RRset with the given attributes in the specified section.
 
         If the RRset is not found, None is returned.
 
-        *section*, an ``int`` section number, or one of the section
-        attributes of this message.  This specifies the
+        *section*, an ``int`` section number, a ``str`` section name, or one of
+        the section attributes of this message.  This specifies the
         the section of the message to search.  For example::
 
             my_message.get_rrset(my_message.answer, name, rdclass, rdtype)
             my_message.get_rrset(dns.message.ANSWER, name, rdclass, rdtype)
+            my_message.get_rrset("ANSWER", name, rdclass, rdtype)
 
-        *name*, a ``dns.name.Name``, the name of the RRset.
+        *name*, a ``dns.name.Name`` or ``str``, the name of the RRset.
 
-        *rdclass*, an ``int``, the class of the RRset.
+        *rdclass*, an ``int`` or ``str``, the class of the RRset.
 
-        *rdtype*, an ``int``, the type of the RRset.
+        *rdtype*, an ``int`` or ``str``, the type of the RRset.
 
-        *covers*, an ``int`` or ``None``, the covers value of the RRset.
-        The default is ``None``.
+        *covers*, an ``int`` or ``str``, the covers value of the RRset.
+        The default is ``dns.rdatatype.NONE``.
 
-        *deleting*, an ``int`` or ``None``, the deleting value of the RRset.
-        The default is ``None``.
+        *deleting*, an ``int``, ``str``, or ``None``, the deleting value of the
+        RRset.  The default is ``None``.
 
         *create*, a ``bool``.  If ``True``, create the RRset if it is not found.
         The created RRset is appended to *section*.
@@ -450,12 +466,24 @@ class Message:
         already.  The default is ``False``.  This is useful when creating
         DDNS Update messages, as order matters for them.
 
+        *idna_codec*, a ``dns.name.IDNACodec``, specifies the IDNA
+        encoder/decoder.  If ``None``, the default IDNA 2003 encoder/decoder
+        is used.
+
         Returns a ``dns.rrset.RRset object`` or ``None``.
         """
 
         try:
             rrset = self.find_rrset(
-                section, name, rdclass, rdtype, covers, deleting, create, force_unique
+                section,
+                name,
+                rdclass,
+                rdtype,
+                covers,
+                deleting,
+                create,
+                force_unique,
+                idna_codec,
             )
         except KeyError:
             rrset = None
@@ -1708,13 +1736,11 @@ def make_query(
 
     if isinstance(qname, str):
         qname = dns.name.from_text(qname, idna_codec=idna_codec)
-    the_rdtype = dns.rdatatype.RdataType.make(rdtype)
-    the_rdclass = dns.rdataclass.RdataClass.make(rdclass)
+    rdtype = dns.rdatatype.RdataType.make(rdtype)
+    rdclass = dns.rdataclass.RdataClass.make(rdclass)
     m = QueryMessage(id=id)
     m.flags = dns.flags.Flag(flags)
-    m.find_rrset(
-        m.question, qname, the_rdclass, the_rdtype, create=True, force_unique=True
-    )
+    m.find_rrset(m.question, qname, rdclass, rdtype, create=True, force_unique=True)
     # only pass keywords on to use_edns if they have been set to a
     # non-None value.  Setting a field will turn EDNS on if it hasn't
     # been configured.
diff --git a/lib/dns/name.py b/lib/dns/name.py
index 612af021..f452bfed 100644
--- a/lib/dns/name.py
+++ b/lib/dns/name.py
@@ -18,12 +18,10 @@
 """DNS Names.
 """
 
-from typing import Any, Dict, Iterable, Optional, Tuple, Union
-
 import copy
-import struct
-
 import encodings.idna  # type: ignore
+import struct
+from typing import Any, Dict, Iterable, Optional, Tuple, Union
 
 try:
     import idna  # type: ignore
@@ -33,10 +31,9 @@ except ImportError:  # pragma: no cover
     have_idna_2008 = False
 
 import dns.enum
-import dns.wire
 import dns.exception
 import dns.immutable
-
+import dns.wire
 
 CompressType = Dict["Name", int]
 
diff --git a/lib/dns/nameserver.py b/lib/dns/nameserver.py
new file mode 100644
index 00000000..5910139e
--- /dev/null
+++ b/lib/dns/nameserver.py
@@ -0,0 +1,329 @@
+from typing import Optional, Union
+from urllib.parse import urlparse
+
+import dns.asyncbackend
+import dns.asyncquery
+import dns.inet
+import dns.message
+import dns.query
+
+
+class Nameserver:
+    def __init__(self):
+        pass
+
+    def __str__(self):
+        raise NotImplementedError
+
+    def kind(self) -> str:
+        raise NotImplementedError
+
+    def is_always_max_size(self) -> bool:
+        raise NotImplementedError
+
+    def answer_nameserver(self) -> str:
+        raise NotImplementedError
+
+    def answer_port(self) -> int:
+        raise NotImplementedError
+
+    def query(
+        self,
+        request: dns.message.QueryMessage,
+        timeout: float,
+        source: Optional[str],
+        source_port: int,
+        max_size: bool,
+        one_rr_per_rrset: bool = False,
+        ignore_trailing: bool = False,
+    ) -> dns.message.Message:
+        raise NotImplementedError
+
+    async def async_query(
+        self,
+        request: dns.message.QueryMessage,
+        timeout: float,
+        source: Optional[str],
+        source_port: int,
+        max_size: bool,
+        backend: dns.asyncbackend.Backend,
+        one_rr_per_rrset: bool = False,
+        ignore_trailing: bool = False,
+    ) -> dns.message.Message:
+        raise NotImplementedError
+
+
+class AddressAndPortNameserver(Nameserver):
+    def __init__(self, address: str, port: int):
+        super().__init__()
+        self.address = address
+        self.port = port
+
+    def kind(self) -> str:
+        raise NotImplementedError
+
+    def is_always_max_size(self) -> bool:
+        return False
+
+    def __str__(self):
+        ns_kind = self.kind()
+        return f"{ns_kind}:{self.address}@{self.port}"
+
+    def answer_nameserver(self) -> str:
+        return self.address
+
+    def answer_port(self) -> int:
+        return self.port
+
+
+class Do53Nameserver(AddressAndPortNameserver):
+    def __init__(self, address: str, port: int = 53):
+        super().__init__(address, port)
+
+    def kind(self):
+        return "Do53"
+
+    def query(
+        self,
+        request: dns.message.QueryMessage,
+        timeout: float,
+        source: Optional[str],
+        source_port: int,
+        max_size: bool,
+        one_rr_per_rrset: bool = False,
+        ignore_trailing: bool = False,
+    ) -> dns.message.Message:
+        if max_size:
+            response = dns.query.tcp(
+                request,
+                self.address,
+                timeout=timeout,
+                port=self.port,
+                source=source,
+                source_port=source_port,
+                one_rr_per_rrset=one_rr_per_rrset,
+                ignore_trailing=ignore_trailing,
+            )
+        else:
+            response = dns.query.udp(
+                request,
+                self.address,
+                timeout=timeout,
+                port=self.port,
+                source=source,
+                source_port=source_port,
+                raise_on_truncation=True,
+                one_rr_per_rrset=one_rr_per_rrset,
+                ignore_trailing=ignore_trailing,
+            )
+        return response
+
+    async def async_query(
+        self,
+        request: dns.message.QueryMessage,
+        timeout: float,
+        source: Optional[str],
+        source_port: int,
+        max_size: bool,
+        backend: dns.asyncbackend.Backend,
+        one_rr_per_rrset: bool = False,
+        ignore_trailing: bool = False,
+    ) -> dns.message.Message:
+        if max_size:
+            response = await dns.asyncquery.tcp(
+                request,
+                self.address,
+                timeout=timeout,
+                port=self.port,
+                source=source,
+                source_port=source_port,
+                backend=backend,
+                one_rr_per_rrset=one_rr_per_rrset,
+                ignore_trailing=ignore_trailing,
+            )
+        else:
+            response = await dns.asyncquery.udp(
+                request,
+                self.address,
+                timeout=timeout,
+                port=self.port,
+                source=source,
+                source_port=source_port,
+                raise_on_truncation=True,
+                backend=backend,
+                one_rr_per_rrset=one_rr_per_rrset,
+                ignore_trailing=ignore_trailing,
+            )
+        return response
+
+
+class DoHNameserver(Nameserver):
+    def __init__(self, url: str, bootstrap_address: Optional[str] = None):
+        super().__init__()
+        self.url = url
+        self.bootstrap_address = bootstrap_address
+
+    def kind(self):
+        return "DoH"
+
+    def is_always_max_size(self) -> bool:
+        return True
+
+    def __str__(self):
+        return self.url
+
+    def answer_nameserver(self) -> str:
+        return self.url
+
+    def answer_port(self) -> int:
+        port = urlparse(self.url).port
+        if port is None:
+            port = 443
+        return port
+
+    def query(
+        self,
+        request: dns.message.QueryMessage,
+        timeout: float,
+        source: Optional[str],
+        source_port: int,
+        max_size: bool = False,
+        one_rr_per_rrset: bool = False,
+        ignore_trailing: bool = False,
+    ) -> dns.message.Message:
+        return dns.query.https(
+            request,
+            self.url,
+            timeout=timeout,
+            bootstrap_address=self.bootstrap_address,
+            one_rr_per_rrset=one_rr_per_rrset,
+            ignore_trailing=ignore_trailing,
+        )
+
+    async def async_query(
+        self,
+        request: dns.message.QueryMessage,
+        timeout: float,
+        source: Optional[str],
+        source_port: int,
+        max_size: bool,
+        backend: dns.asyncbackend.Backend,
+        one_rr_per_rrset: bool = False,
+        ignore_trailing: bool = False,
+    ) -> dns.message.Message:
+        return await dns.asyncquery.https(
+            request,
+            self.url,
+            timeout=timeout,
+            one_rr_per_rrset=one_rr_per_rrset,
+            ignore_trailing=ignore_trailing,
+        )
+
+
+class DoTNameserver(AddressAndPortNameserver):
+    def __init__(self, address: str, port: int = 853, hostname: Optional[str] = None):
+        super().__init__(address, port)
+        self.hostname = hostname
+
+    def kind(self):
+        return "DoT"
+
+    def query(
+        self,
+        request: dns.message.QueryMessage,
+        timeout: float,
+        source: Optional[str],
+        source_port: int,
+        max_size: bool = False,
+        one_rr_per_rrset: bool = False,
+        ignore_trailing: bool = False,
+    ) -> dns.message.Message:
+        return dns.query.tls(
+            request,
+            self.address,
+            port=self.port,
+            timeout=timeout,
+            one_rr_per_rrset=one_rr_per_rrset,
+            ignore_trailing=ignore_trailing,
+            server_hostname=self.hostname,
+        )
+
+    async def async_query(
+        self,
+        request: dns.message.QueryMessage,
+        timeout: float,
+        source: Optional[str],
+        source_port: int,
+        max_size: bool,
+        backend: dns.asyncbackend.Backend,
+        one_rr_per_rrset: bool = False,
+        ignore_trailing: bool = False,
+    ) -> dns.message.Message:
+        return await dns.asyncquery.tls(
+            request,
+            self.address,
+            port=self.port,
+            timeout=timeout,
+            one_rr_per_rrset=one_rr_per_rrset,
+            ignore_trailing=ignore_trailing,
+            server_hostname=self.hostname,
+        )
+
+
+class DoQNameserver(AddressAndPortNameserver):
+    def __init__(
+        self,
+        address: str,
+        port: int = 853,
+        verify: Union[bool, str] = True,
+        server_hostname: Optional[str] = None,
+    ):
+        super().__init__(address, port)
+        self.verify = verify
+        self.server_hostname = server_hostname
+
+    def kind(self):
+        return "DoQ"
+
+    def query(
+        self,
+        request: dns.message.QueryMessage,
+        timeout: float,
+        source: Optional[str],
+        source_port: int,
+        max_size: bool = False,
+        one_rr_per_rrset: bool = False,
+        ignore_trailing: bool = False,
+    ) -> dns.message.Message:
+        return dns.query.quic(
+            request,
+            self.address,
+            port=self.port,
+            timeout=timeout,
+            one_rr_per_rrset=one_rr_per_rrset,
+            ignore_trailing=ignore_trailing,
+            verify=self.verify,
+            server_hostname=self.server_hostname,
+        )
+
+    async def async_query(
+        self,
+        request: dns.message.QueryMessage,
+        timeout: float,
+        source: Optional[str],
+        source_port: int,
+        max_size: bool,
+        backend: dns.asyncbackend.Backend,
+        one_rr_per_rrset: bool = False,
+        ignore_trailing: bool = False,
+    ) -> dns.message.Message:
+        return await dns.asyncquery.quic(
+            request,
+            self.address,
+            port=self.port,
+            timeout=timeout,
+            one_rr_per_rrset=one_rr_per_rrset,
+            ignore_trailing=ignore_trailing,
+            verify=self.verify,
+            server_hostname=self.server_hostname,
+        )
diff --git a/lib/dns/node.py b/lib/dns/node.py
index 22bbe7cb..c670243c 100644
--- a/lib/dns/node.py
+++ b/lib/dns/node.py
@@ -17,19 +17,17 @@
 
 """DNS nodes.  A node is a set of rdatasets."""
 
-from typing import Any, Dict, Optional
-
 import enum
 import io
+from typing import Any, Dict, Optional
 
 import dns.immutable
 import dns.name
 import dns.rdataclass
 import dns.rdataset
 import dns.rdatatype
-import dns.rrset
 import dns.renderer
-
+import dns.rrset
 
 _cname_types = {
     dns.rdatatype.CNAME,
diff --git a/lib/dns/query.py b/lib/dns/query.py
index b4cd69f7..0d711251 100644
--- a/lib/dns/query.py
+++ b/lib/dns/query.py
@@ -17,8 +17,6 @@
 
 """Talk to a DNS server."""
 
-from typing import Any, Dict, Optional, Tuple, Union
-
 import base64
 import contextlib
 import enum
@@ -28,12 +26,12 @@ import selectors
 import socket
 import struct
 import time
-import urllib.parse
+from typing import Any, Dict, Optional, Tuple, Union
 
 import dns.exception
 import dns.inet
-import dns.name
 import dns.message
+import dns.name
 import dns.quic
 import dns.rcode
 import dns.rdataclass
@@ -43,20 +41,32 @@ import dns.transaction
 import dns.tsig
 import dns.xfr
 
-try:
-    import requests
-    from requests_toolbelt.adapters.source import SourceAddressAdapter
-    from requests_toolbelt.adapters.host_header_ssl import HostHeaderSSLAdapter
 
-    _have_requests = True
-except ImportError:  # pragma: no cover
-    _have_requests = False
+def _remaining(expiration):
+    if expiration is None:
+        return None
+    timeout = expiration - time.time()
+    if timeout <= 0.0:
+        raise dns.exception.Timeout
+    return timeout
+
+
+def _expiration_for_this_attempt(timeout, expiration):
+    if expiration is None:
+        return None
+    return min(time.time() + timeout, expiration)
+
 
 _have_httpx = False
 _have_http2 = False
 try:
+    import httpcore
+    import httpcore._backends.sync
     import httpx
 
+    _CoreNetworkBackend = httpcore.NetworkBackend
+    _CoreSyncStream = httpcore._backends.sync.SyncStream
+
     _have_httpx = True
     try:
         # See if http2 support is available.
@@ -64,10 +74,87 @@ try:
             _have_http2 = True
     except Exception:
         pass
-except ImportError:  # pragma: no cover
-    pass
 
-have_doh = _have_requests or _have_httpx
+    class _NetworkBackend(_CoreNetworkBackend):
+        def __init__(self, resolver, local_port, bootstrap_address, family):
+            super().__init__()
+            self._local_port = local_port
+            self._resolver = resolver
+            self._bootstrap_address = bootstrap_address
+            self._family = family
+
+        def connect_tcp(
+            self, host, port, timeout, local_address, socket_options=None
+        ):  # pylint: disable=signature-differs
+            addresses = []
+            _, expiration = _compute_times(timeout)
+            if dns.inet.is_address(host):
+                addresses.append(host)
+            elif self._bootstrap_address is not None:
+                addresses.append(self._bootstrap_address)
+            else:
+                timeout = _remaining(expiration)
+                family = self._family
+                if local_address:
+                    family = dns.inet.af_for_address(local_address)
+                answers = self._resolver.resolve_name(
+                    host, family=family, lifetime=timeout
+                )
+                addresses = answers.addresses()
+            for address in addresses:
+                af = dns.inet.af_for_address(address)
+                if local_address is not None or self._local_port != 0:
+                    source = dns.inet.low_level_address_tuple(
+                        (local_address, self._local_port), af
+                    )
+                else:
+                    source = None
+                sock = _make_socket(af, socket.SOCK_STREAM, source)
+                attempt_expiration = _expiration_for_this_attempt(2.0, expiration)
+                try:
+                    _connect(
+                        sock,
+                        dns.inet.low_level_address_tuple((address, port), af),
+                        attempt_expiration,
+                    )
+                    return _CoreSyncStream(sock)
+                except Exception:
+                    pass
+            raise httpcore.ConnectError
+
+        def connect_unix_socket(
+            self, path, timeout, socket_options=None
+        ):  # pylint: disable=signature-differs
+            raise NotImplementedError
+
+    class _HTTPTransport(httpx.HTTPTransport):
+        def __init__(
+            self,
+            *args,
+            local_port=0,
+            bootstrap_address=None,
+            resolver=None,
+            family=socket.AF_UNSPEC,
+            **kwargs,
+        ):
+            if resolver is None:
+                # pylint: disable=import-outside-toplevel,redefined-outer-name
+                import dns.resolver
+
+                resolver = dns.resolver.Resolver()
+            super().__init__(*args, **kwargs)
+            self._pool._network_backend = _NetworkBackend(
+                resolver, local_port, bootstrap_address, family
+            )
+
+except ImportError:  # pragma: no cover
+
+    class _HTTPTransport:  # type: ignore
+        def connect_tcp(self, host, port, timeout, local_address):
+            raise NotImplementedError
+
+
+have_doh = _have_httpx
 
 try:
     import ssl
@@ -88,7 +175,7 @@ except ImportError:  # pragma: no cover
 
         @classmethod
         def create_default_context(cls, *args, **kwargs):
-            raise Exception("no ssl support")
+            raise Exception("no ssl support")  # pylint: disable=broad-exception-raised
 
 
 # Function used to create a socket.  Can be overridden if needed in special
@@ -105,7 +192,7 @@ class BadResponse(dns.exception.FormError):
 
 
 class NoDOH(dns.exception.DNSException):
-    """DNS over HTTPS (DOH) was requested but the requests module is not
+    """DNS over HTTPS (DOH) was requested but the httpx module is not
     available."""
 
 
@@ -230,7 +317,7 @@ def _destination_and_source(
             # We know the destination af, so source had better agree!
             if saf != af:
                 raise ValueError(
-                    "different address families for source " + "and destination"
+                    "different address families for source and destination"
                 )
         else:
             # We didn't know the destination af, but we know the source,
@@ -240,11 +327,10 @@ def _destination_and_source(
         # Caller has specified a source_port but not an address, so we
         # need to return a source, and we need to use the appropriate
         # wildcard address as the address.
-        if af == socket.AF_INET:
-            source = "0.0.0.0"
-        elif af == socket.AF_INET6:
-            source = "::"
-        else:
+        try:
+            source = dns.inet.any_for_af(af)
+        except Exception:
+            # we catch this and raise ValueError for backwards compatibility
             raise ValueError("source_port specified but address family is unknown")
     # Convert high-level (address, port) tuples into low-level address
     # tuples.
@@ -289,6 +375,8 @@ def https(
     post: bool = True,
     bootstrap_address: Optional[str] = None,
     verify: Union[bool, str] = True,
+    resolver: Optional["dns.resolver.Resolver"] = None,
+    family: Optional[int] = socket.AF_UNSPEC,
 ) -> dns.message.Message:
     """Return the response obtained after sending a query via DNS-over-HTTPS.
 
@@ -314,91 +402,78 @@ def https(
     *ignore_trailing*, a ``bool``. If ``True``, ignore trailing junk at end of the
     received message.
 
-    *session*, an ``httpx.Client`` or ``requests.session.Session``.  If provided, the
-    client/session to use to send the queries.
+    *session*, an ``httpx.Client``.  If provided, the client session to use to send the
+    queries.
 
     *path*, a ``str``. If *where* is an IP address, then *path* will be used to
     construct the URL to send the DNS query to.
 
     *post*, a ``bool``. If ``True``, the default, POST method will be used.
 
-    *bootstrap_address*, a ``str``, the IP address to use to bypass the system's DNS
-    resolver.
+    *bootstrap_address*, a ``str``, the IP address to use to bypass resolution.
 
     *verify*, a ``bool`` or ``str``.  If a ``True``, then TLS certificate verification
     of the server is done using the default CA bundle; if ``False``, then no
     verification is done; if a `str` then it specifies the path to a certificate file or
     directory which will be used for verification.
 
+    *resolver*, a ``dns.resolver.Resolver`` or ``None``, the resolver to use for
+    resolution of hostnames in URLs.  If not specified, a new resolver with a default
+    configuration will be used; note this is *not* the default resolver as that resolver
+    might have been configured to use DoH causing a chicken-and-egg problem.  This
+    parameter only has an effect if the HTTP library is httpx.
+
+    *family*, an ``int``, the address family.  If socket.AF_UNSPEC (the default), both A
+    and AAAA records will be retrieved.
+
     Returns a ``dns.message.Message``.
     """
 
     if not have_doh:
-        raise NoDOH("Neither httpx nor requests is available.")  # pragma: no cover
-
-    _httpx_ok = _have_httpx
+        raise NoDOH  # pragma: no cover
+    if session and not isinstance(session, httpx.Client):
+        raise ValueError("session parameter must be an httpx.Client")
 
     wire = q.to_wire()
-    (af, _, source) = _destination_and_source(where, port, source, source_port, False)
-    transport_adapter = None
+    (af, _, the_source) = _destination_and_source(
+        where, port, source, source_port, False
+    )
     transport = None
     headers = {"accept": "application/dns-message"}
-    if af is not None:
+    if af is not None and dns.inet.is_address(where):
         if af == socket.AF_INET:
             url = "https://{}:{}{}".format(where, port, path)
         elif af == socket.AF_INET6:
             url = "https://[{}]:{}{}".format(where, port, path)
-    elif bootstrap_address is not None:
-        _httpx_ok = False
-        split_url = urllib.parse.urlsplit(where)
-        if split_url.hostname is None:
-            raise ValueError("DoH URL has no hostname")
-        headers["Host"] = split_url.hostname
-        url = where.replace(split_url.hostname, bootstrap_address)
-        if _have_requests:
-            transport_adapter = HostHeaderSSLAdapter()
     else:
         url = where
-    if source is not None:
-        # set source port and source address
-        if _have_httpx:
-            if source_port == 0:
-                transport = httpx.HTTPTransport(local_address=source[0], verify=verify)
-            else:
-                _httpx_ok = False
-        if _have_requests:
-            transport_adapter = SourceAddressAdapter(source)
 
-    if session:
-        if _have_httpx:
-            _is_httpx = isinstance(session, httpx.Client)
-        else:
-            _is_httpx = False
-        if _is_httpx and not _httpx_ok:
-            raise NoDOH(
-                "Session is httpx, but httpx cannot be used for "
-                "the requested operation."
-            )
+    # set source port and source address
+
+    if the_source is None:
+        local_address = None
+        local_port = 0
     else:
-        _is_httpx = _httpx_ok
-
-    if not _httpx_ok and not _have_requests:
-        raise NoDOH(
-            "Cannot use httpx for this operation, and requests is not available."
-        )
+        local_address = the_source[0]
+        local_port = the_source[1]
+    transport = _HTTPTransport(
+        local_address=local_address,
+        http1=True,
+        http2=_have_http2,
+        verify=verify,
+        local_port=local_port,
+        bootstrap_address=bootstrap_address,
+        resolver=resolver,
+        family=family,
+    )
 
     if session:
         cm: contextlib.AbstractContextManager = contextlib.nullcontext(session)
-    elif _is_httpx:
+    else:
         cm = httpx.Client(
             http1=True, http2=_have_http2, verify=verify, transport=transport
         )
-    else:
-        cm = requests.sessions.Session()
     with cm as session:
-        if transport_adapter and not _is_httpx:
-            session.mount(url, transport_adapter)
-
         # see https://tools.ietf.org/html/rfc8484#section-4.1.1 for DoH
         # GET and POST examples
         if post:
@@ -408,29 +483,13 @@ def https(
                     "content-length": str(len(wire)),
                 }
             )
-            if _is_httpx:
-                response = session.post(
-                    url, headers=headers, content=wire, timeout=timeout
-                )
-            else:
-                response = session.post(
-                    url, headers=headers, data=wire, timeout=timeout, verify=verify
-                )
+            response = session.post(url, headers=headers, content=wire, timeout=timeout)
         else:
             wire = base64.urlsafe_b64encode(wire).rstrip(b"=")
-            if _is_httpx:
-                twire = wire.decode()  # httpx does a repr() if we give it bytes
-                response = session.get(
-                    url, headers=headers, timeout=timeout, params={"dns": twire}
-                )
-            else:
-                response = session.get(
-                    url,
-                    headers=headers,
-                    timeout=timeout,
-                    verify=verify,
-                    params={"dns": wire},
-                )
+            twire = wire.decode()  # httpx does a repr() if we give it bytes
+            response = session.get(
+                url, headers=headers, timeout=timeout, params={"dns": twire}
+            )
 
     # see https://tools.ietf.org/html/rfc8484#section-4.2.1 for info about DoH
     # status codes
@@ -1070,6 +1129,7 @@ def quic(
     ignore_trailing: bool = False,
     connection: Optional[dns.quic.SyncQuicConnection] = None,
     verify: Union[bool, str] = True,
+    server_hostname: Optional[str] = None,
 ) -> dns.message.Message:
     """Return the response obtained after sending a query via DNS-over-QUIC.
 
@@ -1101,6 +1161,10 @@ def quic(
     verification is done; if a `str` then it specifies the path to a certificate file or
     directory which will be used for verification.
 
+    *server_hostname*, a ``str`` containing the server's hostname.  The
+    default is ``None``, which means that no hostname is known, and if an
+    SSL context is created, hostname checking will be disabled.
+
     Returns a ``dns.message.Message``.
     """
 
@@ -1115,16 +1179,18 @@ def quic(
         manager: contextlib.AbstractContextManager = contextlib.nullcontext(None)
         the_connection = connection
     else:
-        manager = dns.quic.SyncQuicManager(verify_mode=verify)
+        manager = dns.quic.SyncQuicManager(
+            verify_mode=verify, server_name=server_hostname
+        )
         the_manager = manager  # for type checking happiness
 
     with manager:
         if not connection:
             the_connection = the_manager.connect(where, port, source, source_port)
-        start = time.time()
-        with the_connection.make_stream() as stream:
+        (start, expiration) = _compute_times(timeout)
+        with the_connection.make_stream(timeout) as stream:
             stream.send(wire, True)
-            wire = stream.receive(timeout)
+            wire = stream.receive(_remaining(expiration))
         finish = time.time()
     r = dns.message.from_wire(
         wire,
diff --git a/lib/dns/quic/__init__.py b/lib/dns/quic/__init__.py
index f48ecf57..69813f9f 100644
--- a/lib/dns/quic/__init__.py
+++ b/lib/dns/quic/__init__.py
@@ -5,13 +5,13 @@ try:
 
     import dns.asyncbackend
     from dns._asyncbackend import NullContext
-    from dns.quic._sync import SyncQuicManager, SyncQuicConnection, SyncQuicStream
     from dns.quic._asyncio import (
-        AsyncioQuicManager,
         AsyncioQuicConnection,
+        AsyncioQuicManager,
         AsyncioQuicStream,
     )
     from dns.quic._common import AsyncQuicConnection, AsyncQuicManager
+    from dns.quic._sync import SyncQuicConnection, SyncQuicManager, SyncQuicStream
 
     have_quic = True
 
@@ -33,9 +33,10 @@ try:
 
     try:
         import trio
+
         from dns.quic._trio import (  # pylint: disable=ungrouped-imports
-            TrioQuicManager,
             TrioQuicConnection,
+            TrioQuicManager,
             TrioQuicStream,
         )
 
diff --git a/lib/dns/quic/_asyncio.py b/lib/dns/quic/_asyncio.py
index 0a2e220d..e1c52339 100644
--- a/lib/dns/quic/_asyncio.py
+++ b/lib/dns/quic/_asyncio.py
@@ -9,14 +9,16 @@ import time
 import aioquic.quic.configuration  # type: ignore
 import aioquic.quic.connection  # type: ignore
 import aioquic.quic.events  # type: ignore
-import dns.inet
-import dns.asyncbackend
 
+import dns.asyncbackend
+import dns.exception
+import dns.inet
 from dns.quic._common import (
-    BaseQuicStream,
+    QUIC_MAX_DATAGRAM,
     AsyncQuicConnection,
     AsyncQuicManager,
-    QUIC_MAX_DATAGRAM,
+    BaseQuicStream,
+    UnexpectedEOF,
 )
 
 
@@ -30,15 +32,15 @@ class AsyncioQuicStream(BaseQuicStream):
             await self._wake_up.wait()
 
     async def wait_for(self, amount, expiration):
-        timeout = self._timeout_from_expiration(expiration)
         while True:
+            timeout = self._timeout_from_expiration(expiration)
             if self._buffer.have(amount):
                 return
             self._expecting = amount
             try:
                 await asyncio.wait_for(self._wait_for_wake_up(), timeout)
-            except Exception:
-                pass
+            except TimeoutError:
+                raise dns.exception.Timeout
             self._expecting = 0
 
     async def receive(self, timeout=None):
@@ -86,8 +88,10 @@ class AsyncioQuicConnection(AsyncQuicConnection):
         try:
             af = dns.inet.af_for_address(self._address)
             backend = dns.asyncbackend.get_backend("asyncio")
+            # Note that peer is a low-level address tuple, but make_socket() wants
+            # a high-level address tuple, so we convert.
             self._socket = await backend.make_socket(
-                af, socket.SOCK_DGRAM, 0, self._source, self._peer
+                af, socket.SOCK_DGRAM, 0, self._source, (self._peer[0], self._peer[1])
             )
             self._socket_created.set()
             async with self._socket:
@@ -106,6 +110,11 @@ class AsyncioQuicConnection(AsyncQuicConnection):
                         self._wake_timer.notify_all()
         except Exception:
             pass
+        finally:
+            self._done = True
+            async with self._wake_timer:
+                self._wake_timer.notify_all()
+            self._handshake_complete.set()
 
     async def _wait_for_wake_timer(self):
         async with self._wake_timer:
@@ -115,7 +124,7 @@ class AsyncioQuicConnection(AsyncQuicConnection):
         await self._socket_created.wait()
         while not self._done:
             datagrams = self._connection.datagrams_to_send(time.time())
-            for (datagram, address) in datagrams:
+            for datagram, address in datagrams:
                 assert address == self._peer[0]
                 await self._socket.sendto(datagram, self._peer, None)
             (expiration, interval) = self._get_timer_values()
@@ -160,8 +169,13 @@ class AsyncioQuicConnection(AsyncQuicConnection):
         self._receiver_task = asyncio.Task(self._receiver())
         self._sender_task = asyncio.Task(self._sender())
 
-    async def make_stream(self):
-        await self._handshake_complete.wait()
+    async def make_stream(self, timeout=None):
+        try:
+            await asyncio.wait_for(self._handshake_complete.wait(), timeout)
+        except TimeoutError:
+            raise dns.exception.Timeout
+        if self._done:
+            raise UnexpectedEOF
         stream_id = self._connection.get_next_available_stream_id(False)
         stream = AsyncioQuicStream(self, stream_id)
         self._streams[stream_id] = stream
@@ -172,6 +186,9 @@ class AsyncioQuicConnection(AsyncQuicConnection):
             self._manager.closed(self._peer[0], self._peer[1])
             self._closed = True
             self._connection.close()
+            # sender might be blocked on this, so set it
+            self._socket_created.set()
+            await self._socket.close()
             async with self._wake_timer:
                 self._wake_timer.notify_all()
             try:
@@ -185,8 +202,8 @@ class AsyncioQuicConnection(AsyncQuicConnection):
 
 
 class AsyncioQuicManager(AsyncQuicManager):
-    def __init__(self, conf=None, verify_mode=ssl.CERT_REQUIRED):
-        super().__init__(conf, verify_mode, AsyncioQuicConnection)
+    def __init__(self, conf=None, verify_mode=ssl.CERT_REQUIRED, server_name=None):
+        super().__init__(conf, verify_mode, AsyncioQuicConnection, server_name)
 
     def connect(self, address, port=853, source=None, source_port=0):
         (connection, start) = self._connect(address, port, source, source_port)
@@ -198,7 +215,7 @@ class AsyncioQuicManager(AsyncQuicManager):
         return self
 
     async def __aexit__(self, exc_type, exc_val, exc_tb):
-        # Copy the itertor into a list as exiting things will mutate the connections
+        # Copy the iterator into a list as exiting things will mutate the connections
         # table.
         connections = list(self._connections.values())
         for connection in connections:
diff --git a/lib/dns/quic/_common.py b/lib/dns/quic/_common.py
index d8f6f7fd..38ec103f 100644
--- a/lib/dns/quic/_common.py
+++ b/lib/dns/quic/_common.py
@@ -3,13 +3,12 @@
 import socket
 import struct
 import time
-
-from typing import Any
+from typing import Any, Optional
 
 import aioquic.quic.configuration  # type: ignore
 import aioquic.quic.connection  # type: ignore
-import dns.inet
 
+import dns.inet
 
 QUIC_MAX_DATAGRAM = 2048
 
@@ -135,12 +134,12 @@ class BaseQuicConnection:
 
 
 class AsyncQuicConnection(BaseQuicConnection):
-    async def make_stream(self) -> Any:
+    async def make_stream(self, timeout: Optional[float] = None) -> Any:
         pass
 
 
 class BaseQuicManager:
-    def __init__(self, conf, verify_mode, connection_factory):
+    def __init__(self, conf, verify_mode, connection_factory, server_name=None):
         self._connections = {}
         self._connection_factory = connection_factory
         if conf is None:
@@ -151,6 +150,7 @@ class BaseQuicManager:
             conf = aioquic.quic.configuration.QuicConfiguration(
                 alpn_protocols=["doq", "doq-i03"],
                 verify_mode=verify_mode,
+                server_name=server_name,
             )
             if verify_path is not None:
                 conf.load_verify_locations(verify_path)
diff --git a/lib/dns/quic/_sync.py b/lib/dns/quic/_sync.py
index be005ba9..e944784d 100644
--- a/lib/dns/quic/_sync.py
+++ b/lib/dns/quic/_sync.py
@@ -1,8 +1,8 @@
 # Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license
 
+import selectors
 import socket
 import ssl
-import selectors
 import struct
 import threading
 import time
@@ -10,13 +10,15 @@ import time
 import aioquic.quic.configuration  # type: ignore
 import aioquic.quic.connection  # type: ignore
 import aioquic.quic.events  # type: ignore
-import dns.inet
 
+import dns.exception
+import dns.inet
 from dns.quic._common import (
-    BaseQuicStream,
+    QUIC_MAX_DATAGRAM,
     BaseQuicConnection,
     BaseQuicManager,
-    QUIC_MAX_DATAGRAM,
+    BaseQuicStream,
+    UnexpectedEOF,
 )
 
 # Avoid circularity with dns.query
@@ -33,14 +35,15 @@ class SyncQuicStream(BaseQuicStream):
         self._lock = threading.Lock()
 
     def wait_for(self, amount, expiration):
-        timeout = self._timeout_from_expiration(expiration)
         while True:
+            timeout = self._timeout_from_expiration(expiration)
             with self._lock:
                 if self._buffer.have(amount):
                     return
                 self._expecting = amount
             with self._wake_up:
-                self._wake_up.wait(timeout)
+                if not self._wake_up.wait(timeout):
+                    raise dns.exception.Timeout
             self._expecting = 0
 
     def receive(self, timeout=None):
@@ -114,24 +117,30 @@ class SyncQuicConnection(BaseQuicConnection):
                 return
 
     def _worker(self):
-        sel = _selector_class()
-        sel.register(self._socket, selectors.EVENT_READ, self._read)
-        sel.register(self._receive_wakeup, selectors.EVENT_READ, self._drain_wakeup)
-        while not self._done:
-            (expiration, interval) = self._get_timer_values(False)
-            items = sel.select(interval)
-            for (key, _) in items:
-                key.data()
+        try:
+            sel = _selector_class()
+            sel.register(self._socket, selectors.EVENT_READ, self._read)
+            sel.register(self._receive_wakeup, selectors.EVENT_READ, self._drain_wakeup)
+            while not self._done:
+                (expiration, interval) = self._get_timer_values(False)
+                items = sel.select(interval)
+                for key, _ in items:
+                    key.data()
+                with self._lock:
+                    self._handle_timer(expiration)
+                    datagrams = self._connection.datagrams_to_send(time.time())
+                for datagram, _ in datagrams:
+                    try:
+                        self._socket.send(datagram)
+                    except BlockingIOError:
+                        # we let QUIC handle any lossage
+                        pass
+                self._handle_events()
+        finally:
             with self._lock:
-                self._handle_timer(expiration)
-                datagrams = self._connection.datagrams_to_send(time.time())
-            for (datagram, _) in datagrams:
-                try:
-                    self._socket.send(datagram)
-                except BlockingIOError:
-                    # we let QUIC handle any lossage
-                    pass
-            self._handle_events()
+                self._done = True
+            # Ensure anyone waiting for this gets woken up.
+            self._handshake_complete.set()
 
     def _handle_events(self):
         while True:
@@ -163,9 +172,12 @@ class SyncQuicConnection(BaseQuicConnection):
         self._worker_thread = threading.Thread(target=self._worker)
         self._worker_thread.start()
 
-    def make_stream(self):
-        self._handshake_complete.wait()
+    def make_stream(self, timeout=None):
+        if not self._handshake_complete.wait(timeout):
+            raise dns.exception.Timeout
         with self._lock:
+            if self._done:
+                raise UnexpectedEOF
             stream_id = self._connection.get_next_available_stream_id(False)
             stream = SyncQuicStream(self, stream_id)
             self._streams[stream_id] = stream
@@ -187,8 +199,8 @@ class SyncQuicConnection(BaseQuicConnection):
 
 
 class SyncQuicManager(BaseQuicManager):
-    def __init__(self, conf=None, verify_mode=ssl.CERT_REQUIRED):
-        super().__init__(conf, verify_mode, SyncQuicConnection)
+    def __init__(self, conf=None, verify_mode=ssl.CERT_REQUIRED, server_name=None):
+        super().__init__(conf, verify_mode, SyncQuicConnection, server_name)
         self._lock = threading.Lock()
 
     def connect(self, address, port=853, source=None, source_port=0):
@@ -206,7 +218,7 @@ class SyncQuicManager(BaseQuicManager):
         return self
 
     def __exit__(self, exc_type, exc_val, exc_tb):
-        # Copy the itertor into a list as exiting things will mutate the connections
+        # Copy the iterator into a list as exiting things will mutate the connections
         # table.
         connections = list(self._connections.values())
         for connection in connections:
diff --git a/lib/dns/quic/_trio.py b/lib/dns/quic/_trio.py
index 1e47a5a6..ee07e4f6 100644
--- a/lib/dns/quic/_trio.py
+++ b/lib/dns/quic/_trio.py
@@ -10,13 +10,15 @@ import aioquic.quic.connection  # type: ignore
 import aioquic.quic.events  # type: ignore
 import trio
 
+import dns.exception
 import dns.inet
 from dns._asyncbackend import NullContext
 from dns.quic._common import (
-    BaseQuicStream,
+    QUIC_MAX_DATAGRAM,
     AsyncQuicConnection,
     AsyncQuicManager,
-    QUIC_MAX_DATAGRAM,
+    BaseQuicStream,
+    UnexpectedEOF,
 )
 
 
@@ -44,6 +46,7 @@ class TrioQuicStream(BaseQuicStream):
             (size,) = struct.unpack("!H", self._buffer.get(2))
             await self.wait_for(size)
             return self._buffer.get(size)
+        raise dns.exception.Timeout
 
     async def send(self, datagram, is_end=False):
         data = self._encapsulate(datagram)
@@ -80,20 +83,26 @@ class TrioQuicConnection(AsyncQuicConnection):
         self._worker_scope = None
 
     async def _worker(self):
-        await self._socket.connect(self._peer)
-        while not self._done:
-            (expiration, interval) = self._get_timer_values(False)
-            with trio.CancelScope(
-                deadline=trio.current_time() + interval
-            ) as self._worker_scope:
-                datagram = await self._socket.recv(QUIC_MAX_DATAGRAM)
-                self._connection.receive_datagram(datagram, self._peer[0], time.time())
-            self._worker_scope = None
-            self._handle_timer(expiration)
-            datagrams = self._connection.datagrams_to_send(time.time())
-            for (datagram, _) in datagrams:
-                await self._socket.send(datagram)
-            await self._handle_events()
+        try:
+            await self._socket.connect(self._peer)
+            while not self._done:
+                (expiration, interval) = self._get_timer_values(False)
+                with trio.CancelScope(
+                    deadline=trio.current_time() + interval
+                ) as self._worker_scope:
+                    datagram = await self._socket.recv(QUIC_MAX_DATAGRAM)
+                    self._connection.receive_datagram(
+                        datagram, self._peer[0], time.time()
+                    )
+                self._worker_scope = None
+                self._handle_timer(expiration)
+                datagrams = self._connection.datagrams_to_send(time.time())
+                for datagram, _ in datagrams:
+                    await self._socket.send(datagram)
+                await self._handle_events()
+        finally:
+            self._done = True
+            self._handshake_complete.set()
 
     async def _handle_events(self):
         count = 0
@@ -130,12 +139,20 @@ class TrioQuicConnection(AsyncQuicConnection):
             nursery.start_soon(self._worker)
         self._run_done.set()
 
-    async def make_stream(self):
-        await self._handshake_complete.wait()
-        stream_id = self._connection.get_next_available_stream_id(False)
-        stream = TrioQuicStream(self, stream_id)
-        self._streams[stream_id] = stream
-        return stream
+    async def make_stream(self, timeout=None):
+        if timeout is None:
+            context = NullContext(None)
+        else:
+            context = trio.move_on_after(timeout)
+        with context:
+            await self._handshake_complete.wait()
+            if self._done:
+                raise UnexpectedEOF
+            stream_id = self._connection.get_next_available_stream_id(False)
+            stream = TrioQuicStream(self, stream_id)
+            self._streams[stream_id] = stream
+            return stream
+        raise dns.exception.Timeout
 
     async def close(self):
         if not self._closed:
@@ -148,8 +165,10 @@ class TrioQuicConnection(AsyncQuicConnection):
 
 
 class TrioQuicManager(AsyncQuicManager):
-    def __init__(self, nursery, conf=None, verify_mode=ssl.CERT_REQUIRED):
-        super().__init__(conf, verify_mode, TrioQuicConnection)
+    def __init__(
+        self, nursery, conf=None, verify_mode=ssl.CERT_REQUIRED, server_name=None
+    ):
+        super().__init__(conf, verify_mode, TrioQuicConnection, server_name)
         self._nursery = nursery
 
     def connect(self, address, port=853, source=None, source_port=0):
@@ -162,7 +181,7 @@ class TrioQuicManager(AsyncQuicManager):
         return self
 
     async def __aexit__(self, exc_type, exc_val, exc_tb):
-        # Copy the itertor into a list as exiting things will mutate the connections
+        # Copy the iterator into a list as exiting things will mutate the connections
         # table.
         connections = list(self._connections.values())
         for connection in connections:
diff --git a/lib/dns/rdata.py b/lib/dns/rdata.py
index 1dd6ed90..0d262e8d 100644
--- a/lib/dns/rdata.py
+++ b/lib/dns/rdata.py
@@ -17,17 +17,15 @@
 
 """DNS rdata."""
 
-from typing import Any, Dict, Optional, Tuple, Union
-
-from importlib import import_module
 import base64
 import binascii
-import io
 import inspect
+import io
 import itertools
 import random
+from importlib import import_module
+from typing import Any, Dict, Optional, Tuple, Union
 
-import dns.wire
 import dns.exception
 import dns.immutable
 import dns.ipv4
@@ -37,6 +35,7 @@ import dns.rdataclass
 import dns.rdatatype
 import dns.tokenizer
 import dns.ttl
+import dns.wire
 
 _chunksize = 32
 
@@ -358,7 +357,6 @@ class Rdata:
             or self.rdclass != other.rdclass
             or self.rdtype != other.rdtype
         ):
-
             return NotImplemented
         return self._cmp(other) < 0
 
@@ -881,16 +879,11 @@ def register_type(
     it applies to all classes.
     """
 
-    the_rdtype = dns.rdatatype.RdataType.make(rdtype)
-    existing_cls = get_rdata_class(rdclass, the_rdtype)
-    if existing_cls != GenericRdata or dns.rdatatype.is_metatype(the_rdtype):
-        raise RdatatypeExists(rdclass=rdclass, rdtype=the_rdtype)
-    try:
-        if dns.rdatatype.RdataType(the_rdtype).name != rdtype_text:
-            raise RdatatypeExists(rdclass=rdclass, rdtype=the_rdtype)
-    except ValueError:
-        pass
-    _rdata_classes[(rdclass, the_rdtype)] = getattr(
+    rdtype = dns.rdatatype.RdataType.make(rdtype)
+    existing_cls = get_rdata_class(rdclass, rdtype)
+    if existing_cls != GenericRdata or dns.rdatatype.is_metatype(rdtype):
+        raise RdatatypeExists(rdclass=rdclass, rdtype=rdtype)
+    _rdata_classes[(rdclass, rdtype)] = getattr(
         implementation, rdtype_text.replace("-", "_")
     )
-    dns.rdatatype.register_type(the_rdtype, rdtype_text, is_singleton)
+    dns.rdatatype.register_type(rdtype, rdtype_text, is_singleton)
diff --git a/lib/dns/rdataset.py b/lib/dns/rdataset.py
index c0ede425..31124afc 100644
--- a/lib/dns/rdataset.py
+++ b/lib/dns/rdataset.py
@@ -17,18 +17,17 @@
 
 """DNS rdatasets (an rdataset is a set of rdatas of a given type and class)"""
 
-from typing import Any, cast, Collection, Dict, List, Optional, Union
-
 import io
 import random
 import struct
+from typing import Any, Collection, Dict, List, Optional, Union, cast
 
 import dns.exception
 import dns.immutable
 import dns.name
-import dns.rdatatype
-import dns.rdataclass
 import dns.rdata
+import dns.rdataclass
+import dns.rdatatype
 import dns.set
 import dns.ttl
 
@@ -471,9 +470,9 @@ def from_text_list(
     Returns a ``dns.rdataset.Rdataset`` object.
     """
 
-    the_rdclass = dns.rdataclass.RdataClass.make(rdclass)
-    the_rdtype = dns.rdatatype.RdataType.make(rdtype)
-    r = Rdataset(the_rdclass, the_rdtype)
+    rdclass = dns.rdataclass.RdataClass.make(rdclass)
+    rdtype = dns.rdatatype.RdataType.make(rdtype)
+    r = Rdataset(rdclass, rdtype)
     r.update_ttl(ttl)
     for t in text_rdatas:
         rd = dns.rdata.from_text(
diff --git a/lib/dns/rdtypes/ANY/AFSDB.py b/lib/dns/rdtypes/ANY/AFSDB.py
index d7838e7e..3d287f6e 100644
--- a/lib/dns/rdtypes/ANY/AFSDB.py
+++ b/lib/dns/rdtypes/ANY/AFSDB.py
@@ -15,8 +15,8 @@
 # ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
 # OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 
-import dns.rdtypes.mxbase
 import dns.immutable
+import dns.rdtypes.mxbase
 
 
 @dns.immutable.immutable
diff --git a/lib/dns/rdtypes/ANY/AVC.py b/lib/dns/rdtypes/ANY/AVC.py
index 11e026d0..766d5e2d 100644
--- a/lib/dns/rdtypes/ANY/AVC.py
+++ b/lib/dns/rdtypes/ANY/AVC.py
@@ -15,8 +15,8 @@
 # ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
 # OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 
-import dns.rdtypes.txtbase
 import dns.immutable
+import dns.rdtypes.txtbase
 
 
 @dns.immutable.immutable
diff --git a/lib/dns/rdtypes/ANY/CDNSKEY.py b/lib/dns/rdtypes/ANY/CDNSKEY.py
index 869523fb..38b8a8da 100644
--- a/lib/dns/rdtypes/ANY/CDNSKEY.py
+++ b/lib/dns/rdtypes/ANY/CDNSKEY.py
@@ -15,15 +15,15 @@
 # ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
 # OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 
-import dns.rdtypes.dnskeybase  # lgtm[py/import-and-import-from]
 import dns.immutable
+import dns.rdtypes.dnskeybase  # lgtm[py/import-and-import-from]
 
 # pylint: disable=unused-import
-from dns.rdtypes.dnskeybase import (
-    SEP,
+from dns.rdtypes.dnskeybase import (  # noqa: F401  lgtm[py/unused-import]
     REVOKE,
+    SEP,
     ZONE,
-)  # noqa: F401  lgtm[py/unused-import]
+)
 
 # pylint: enable=unused-import
 
diff --git a/lib/dns/rdtypes/ANY/CDS.py b/lib/dns/rdtypes/ANY/CDS.py
index 094de12b..2ff42d9a 100644
--- a/lib/dns/rdtypes/ANY/CDS.py
+++ b/lib/dns/rdtypes/ANY/CDS.py
@@ -15,8 +15,8 @@
 # ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
 # OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 
-import dns.rdtypes.dsbase
 import dns.immutable
+import dns.rdtypes.dsbase
 
 
 @dns.immutable.immutable
diff --git a/lib/dns/rdtypes/ANY/CERT.py b/lib/dns/rdtypes/ANY/CERT.py
index 1b0cbeca..30fe863f 100644
--- a/lib/dns/rdtypes/ANY/CERT.py
+++ b/lib/dns/rdtypes/ANY/CERT.py
@@ -15,12 +15,12 @@
 # ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
 # OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 
-import struct
 import base64
+import struct
 
+import dns.dnssectypes
 import dns.exception
 import dns.immutable
-import dns.dnssectypes
 import dns.rdata
 import dns.tokenizer
 
diff --git a/lib/dns/rdtypes/ANY/CNAME.py b/lib/dns/rdtypes/ANY/CNAME.py
index a4fcfa88..759adb90 100644
--- a/lib/dns/rdtypes/ANY/CNAME.py
+++ b/lib/dns/rdtypes/ANY/CNAME.py
@@ -15,8 +15,8 @@
 # ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
 # OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 
-import dns.rdtypes.nsbase
 import dns.immutable
+import dns.rdtypes.nsbase
 
 
 @dns.immutable.immutable
diff --git a/lib/dns/rdtypes/ANY/CSYNC.py b/lib/dns/rdtypes/ANY/CSYNC.py
index f819c08c..315da9ff 100644
--- a/lib/dns/rdtypes/ANY/CSYNC.py
+++ b/lib/dns/rdtypes/ANY/CSYNC.py
@@ -19,9 +19,9 @@ import struct
 
 import dns.exception
 import dns.immutable
+import dns.name
 import dns.rdata
 import dns.rdatatype
-import dns.name
 import dns.rdtypes.util
 
 
diff --git a/lib/dns/rdtypes/ANY/DLV.py b/lib/dns/rdtypes/ANY/DLV.py
index 947dc42e..632e90f8 100644
--- a/lib/dns/rdtypes/ANY/DLV.py
+++ b/lib/dns/rdtypes/ANY/DLV.py
@@ -15,8 +15,8 @@
 # ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
 # OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 
-import dns.rdtypes.dsbase
 import dns.immutable
+import dns.rdtypes.dsbase
 
 
 @dns.immutable.immutable
diff --git a/lib/dns/rdtypes/ANY/DNAME.py b/lib/dns/rdtypes/ANY/DNAME.py
index f4984b55..556bff59 100644
--- a/lib/dns/rdtypes/ANY/DNAME.py
+++ b/lib/dns/rdtypes/ANY/DNAME.py
@@ -15,8 +15,8 @@
 # ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
 # OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 
-import dns.rdtypes.nsbase
 import dns.immutable
+import dns.rdtypes.nsbase
 
 
 @dns.immutable.immutable
diff --git a/lib/dns/rdtypes/ANY/DNSKEY.py b/lib/dns/rdtypes/ANY/DNSKEY.py
index 50fa05b7..f1a63062 100644
--- a/lib/dns/rdtypes/ANY/DNSKEY.py
+++ b/lib/dns/rdtypes/ANY/DNSKEY.py
@@ -15,15 +15,15 @@
 # ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
 # OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 
-import dns.rdtypes.dnskeybase  # lgtm[py/import-and-import-from]
 import dns.immutable
+import dns.rdtypes.dnskeybase  # lgtm[py/import-and-import-from]
 
 # pylint: disable=unused-import
-from dns.rdtypes.dnskeybase import (
-    SEP,
+from dns.rdtypes.dnskeybase import (  # noqa: F401  lgtm[py/unused-import]
     REVOKE,
+    SEP,
     ZONE,
-)  # noqa: F401  lgtm[py/unused-import]
+)
 
 # pylint: enable=unused-import
 
diff --git a/lib/dns/rdtypes/ANY/DS.py b/lib/dns/rdtypes/ANY/DS.py
index 3f6c3ee8..097ecfa0 100644
--- a/lib/dns/rdtypes/ANY/DS.py
+++ b/lib/dns/rdtypes/ANY/DS.py
@@ -15,8 +15,8 @@
 # ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
 # OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 
-import dns.rdtypes.dsbase
 import dns.immutable
+import dns.rdtypes.dsbase
 
 
 @dns.immutable.immutable
diff --git a/lib/dns/rdtypes/ANY/EUI48.py b/lib/dns/rdtypes/ANY/EUI48.py
index 0ab88ad0..7e4e1ff3 100644
--- a/lib/dns/rdtypes/ANY/EUI48.py
+++ b/lib/dns/rdtypes/ANY/EUI48.py
@@ -16,8 +16,8 @@
 # ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
 # OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 
-import dns.rdtypes.euibase
 import dns.immutable
+import dns.rdtypes.euibase
 
 
 @dns.immutable.immutable
diff --git a/lib/dns/rdtypes/ANY/EUI64.py b/lib/dns/rdtypes/ANY/EUI64.py
index c42957ef..68b5820f 100644
--- a/lib/dns/rdtypes/ANY/EUI64.py
+++ b/lib/dns/rdtypes/ANY/EUI64.py
@@ -16,8 +16,8 @@
 # ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
 # OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 
-import dns.rdtypes.euibase
 import dns.immutable
+import dns.rdtypes.euibase
 
 
 @dns.immutable.immutable
diff --git a/lib/dns/rdtypes/ANY/HIP.py b/lib/dns/rdtypes/ANY/HIP.py
index 01fec822..a20aa1e5 100644
--- a/lib/dns/rdtypes/ANY/HIP.py
+++ b/lib/dns/rdtypes/ANY/HIP.py
@@ -15,9 +15,9 @@
 # ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
 # OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 
-import struct
 import base64
 import binascii
+import struct
 
 import dns.exception
 import dns.immutable
diff --git a/lib/dns/rdtypes/ANY/LOC.py b/lib/dns/rdtypes/ANY/LOC.py
index 52c97532..783d54af 100644
--- a/lib/dns/rdtypes/ANY/LOC.py
+++ b/lib/dns/rdtypes/ANY/LOC.py
@@ -21,7 +21,6 @@ import dns.exception
 import dns.immutable
 import dns.rdata
 
-
 _pows = tuple(10**i for i in range(0, 11))
 
 # default values are in centimeters
@@ -40,7 +39,7 @@ def _exponent_of(what, desc):
     if what == 0:
         return 0
     exp = None
-    for (i, pow) in enumerate(_pows):
+    for i, pow in enumerate(_pows):
         if what < pow:
             exp = i - 1
             break
diff --git a/lib/dns/rdtypes/ANY/MX.py b/lib/dns/rdtypes/ANY/MX.py
index a697ea45..1f9df21f 100644
--- a/lib/dns/rdtypes/ANY/MX.py
+++ b/lib/dns/rdtypes/ANY/MX.py
@@ -15,8 +15,8 @@
 # ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
 # OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 
-import dns.rdtypes.mxbase
 import dns.immutable
+import dns.rdtypes.mxbase
 
 
 @dns.immutable.immutable
diff --git a/lib/dns/rdtypes/ANY/NINFO.py b/lib/dns/rdtypes/ANY/NINFO.py
index d53e9676..55bc5614 100644
--- a/lib/dns/rdtypes/ANY/NINFO.py
+++ b/lib/dns/rdtypes/ANY/NINFO.py
@@ -15,8 +15,8 @@
 # ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
 # OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 
-import dns.rdtypes.txtbase
 import dns.immutable
+import dns.rdtypes.txtbase
 
 
 @dns.immutable.immutable
diff --git a/lib/dns/rdtypes/ANY/NS.py b/lib/dns/rdtypes/ANY/NS.py
index a0cc232a..fe453f0d 100644
--- a/lib/dns/rdtypes/ANY/NS.py
+++ b/lib/dns/rdtypes/ANY/NS.py
@@ -15,8 +15,8 @@
 # ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
 # OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 
-import dns.rdtypes.nsbase
 import dns.immutable
+import dns.rdtypes.nsbase
 
 
 @dns.immutable.immutable
diff --git a/lib/dns/rdtypes/ANY/NSEC.py b/lib/dns/rdtypes/ANY/NSEC.py
index 7af7b77f..a2d98fa7 100644
--- a/lib/dns/rdtypes/ANY/NSEC.py
+++ b/lib/dns/rdtypes/ANY/NSEC.py
@@ -17,9 +17,9 @@
 
 import dns.exception
 import dns.immutable
+import dns.name
 import dns.rdata
 import dns.rdatatype
-import dns.name
 import dns.rdtypes.util
 
 
diff --git a/lib/dns/rdtypes/ANY/NSEC3.py b/lib/dns/rdtypes/ANY/NSEC3.py
index 6eae16e0..d32fe169 100644
--- a/lib/dns/rdtypes/ANY/NSEC3.py
+++ b/lib/dns/rdtypes/ANY/NSEC3.py
@@ -25,7 +25,6 @@ import dns.rdata
 import dns.rdatatype
 import dns.rdtypes.util
 
-
 b32_hex_to_normal = bytes.maketrans(
     b"0123456789ABCDEFGHIJKLMNOPQRSTUV", b"ABCDEFGHIJKLMNOPQRSTUVWXYZ234567"
 )
@@ -67,6 +66,7 @@ class NSEC3(dns.rdata.Rdata):
 
     def to_text(self, origin=None, relativize=True, **kw):
         next = base64.b32encode(self.next).translate(b32_normal_to_hex).lower().decode()
+        next = next.rstrip("=")
         if self.salt == b"":
             salt = "-"
         else:
@@ -94,6 +94,10 @@ class NSEC3(dns.rdata.Rdata):
         else:
             salt = binascii.unhexlify(salt.encode("ascii"))
         next = tok.get_string().encode("ascii").upper().translate(b32_hex_to_normal)
+        if next.endswith(b"="):
+            raise binascii.Error("Incorrect padding")
+        if len(next) % 8 != 0:
+            next += b"=" * (8 - len(next) % 8)
         next = base64.b32decode(next)
         bitmap = Bitmap.from_text(tok)
         return cls(rdclass, rdtype, algorithm, flags, iterations, salt, next, bitmap)
diff --git a/lib/dns/rdtypes/ANY/NSEC3PARAM.py b/lib/dns/rdtypes/ANY/NSEC3PARAM.py
index 1b7269a0..1a0c0e08 100644
--- a/lib/dns/rdtypes/ANY/NSEC3PARAM.py
+++ b/lib/dns/rdtypes/ANY/NSEC3PARAM.py
@@ -15,8 +15,8 @@
 # ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
 # OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 
-import struct
 import binascii
+import struct
 
 import dns.exception
 import dns.immutable
diff --git a/lib/dns/rdtypes/ANY/OPT.py b/lib/dns/rdtypes/ANY/OPT.py
index 36d4c7c6..d70e5373 100644
--- a/lib/dns/rdtypes/ANY/OPT.py
+++ b/lib/dns/rdtypes/ANY/OPT.py
@@ -18,11 +18,10 @@
 import struct
 
 import dns.edns
-import dns.immutable
 import dns.exception
+import dns.immutable
 import dns.rdata
 
-
 # We don't implement from_text, and that's ok.
 # pylint: disable=abstract-method
 
diff --git a/lib/dns/rdtypes/ANY/PTR.py b/lib/dns/rdtypes/ANY/PTR.py
index 265bed03..7fd5547d 100644
--- a/lib/dns/rdtypes/ANY/PTR.py
+++ b/lib/dns/rdtypes/ANY/PTR.py
@@ -15,8 +15,8 @@
 # ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
 # OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 
-import dns.rdtypes.nsbase
 import dns.immutable
+import dns.rdtypes.nsbase
 
 
 @dns.immutable.immutable
diff --git a/lib/dns/rdtypes/ANY/RP.py b/lib/dns/rdtypes/ANY/RP.py
index c0c316b5..9c64c6e2 100644
--- a/lib/dns/rdtypes/ANY/RP.py
+++ b/lib/dns/rdtypes/ANY/RP.py
@@ -17,8 +17,8 @@
 
 import dns.exception
 import dns.immutable
-import dns.rdata
 import dns.name
+import dns.rdata
 
 
 @dns.immutable.immutable
diff --git a/lib/dns/rdtypes/ANY/RRSIG.py b/lib/dns/rdtypes/ANY/RRSIG.py
index 3d5ad0f3..11605026 100644
--- a/lib/dns/rdtypes/ANY/RRSIG.py
+++ b/lib/dns/rdtypes/ANY/RRSIG.py
@@ -21,8 +21,8 @@ import struct
 import time
 
 import dns.dnssectypes
-import dns.immutable
 import dns.exception
+import dns.immutable
 import dns.rdata
 import dns.rdatatype
 
diff --git a/lib/dns/rdtypes/ANY/RT.py b/lib/dns/rdtypes/ANY/RT.py
index 8d9c6bd0..950f2a06 100644
--- a/lib/dns/rdtypes/ANY/RT.py
+++ b/lib/dns/rdtypes/ANY/RT.py
@@ -15,8 +15,8 @@
 # ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
 # OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 
-import dns.rdtypes.mxbase
 import dns.immutable
+import dns.rdtypes.mxbase
 
 
 @dns.immutable.immutable
diff --git a/lib/dns/rdtypes/ANY/SOA.py b/lib/dns/rdtypes/ANY/SOA.py
index 6f6fe58b..bde55e15 100644
--- a/lib/dns/rdtypes/ANY/SOA.py
+++ b/lib/dns/rdtypes/ANY/SOA.py
@@ -19,8 +19,8 @@ import struct
 
 import dns.exception
 import dns.immutable
-import dns.rdata
 import dns.name
+import dns.rdata
 
 
 @dns.immutable.immutable
diff --git a/lib/dns/rdtypes/ANY/SPF.py b/lib/dns/rdtypes/ANY/SPF.py
index 1190e0de..c403589a 100644
--- a/lib/dns/rdtypes/ANY/SPF.py
+++ b/lib/dns/rdtypes/ANY/SPF.py
@@ -15,8 +15,8 @@
 # ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
 # OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 
-import dns.rdtypes.txtbase
 import dns.immutable
+import dns.rdtypes.txtbase
 
 
 @dns.immutable.immutable
diff --git a/lib/dns/rdtypes/ANY/SSHFP.py b/lib/dns/rdtypes/ANY/SSHFP.py
index 58ffcbbc..67805452 100644
--- a/lib/dns/rdtypes/ANY/SSHFP.py
+++ b/lib/dns/rdtypes/ANY/SSHFP.py
@@ -15,11 +15,11 @@
 # ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
 # OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 
-import struct
 import binascii
+import struct
 
-import dns.rdata
 import dns.immutable
+import dns.rdata
 import dns.rdatatype
 
 
diff --git a/lib/dns/rdtypes/ANY/TKEY.py b/lib/dns/rdtypes/ANY/TKEY.py
index 070f03af..d5f5fc45 100644
--- a/lib/dns/rdtypes/ANY/TKEY.py
+++ b/lib/dns/rdtypes/ANY/TKEY.py
@@ -18,8 +18,8 @@
 import base64
 import struct
 
-import dns.immutable
 import dns.exception
+import dns.immutable
 import dns.rdata
 
 
diff --git a/lib/dns/rdtypes/ANY/TXT.py b/lib/dns/rdtypes/ANY/TXT.py
index cc4b6611..f4e61930 100644
--- a/lib/dns/rdtypes/ANY/TXT.py
+++ b/lib/dns/rdtypes/ANY/TXT.py
@@ -15,8 +15,8 @@
 # ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
 # OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 
-import dns.rdtypes.txtbase
 import dns.immutable
+import dns.rdtypes.txtbase
 
 
 @dns.immutable.immutable
diff --git a/lib/dns/rdtypes/ANY/URI.py b/lib/dns/rdtypes/ANY/URI.py
index b4c95a3b..7463e277 100644
--- a/lib/dns/rdtypes/ANY/URI.py
+++ b/lib/dns/rdtypes/ANY/URI.py
@@ -20,9 +20,9 @@ import struct
 
 import dns.exception
 import dns.immutable
+import dns.name
 import dns.rdata
 import dns.rdtypes.util
-import dns.name
 
 
 @dns.immutable.immutable
diff --git a/lib/dns/rdtypes/ANY/ZONEMD.py b/lib/dns/rdtypes/ANY/ZONEMD.py
index 1f86ba49..3062843b 100644
--- a/lib/dns/rdtypes/ANY/ZONEMD.py
+++ b/lib/dns/rdtypes/ANY/ZONEMD.py
@@ -1,7 +1,7 @@
 # Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license
 
-import struct
 import binascii
+import struct
 
 import dns.immutable
 import dns.rdata
diff --git a/lib/dns/rdtypes/CH/A.py b/lib/dns/rdtypes/CH/A.py
index 9905c7c9..e457f38a 100644
--- a/lib/dns/rdtypes/CH/A.py
+++ b/lib/dns/rdtypes/CH/A.py
@@ -17,8 +17,8 @@
 
 import struct
 
-import dns.rdtypes.mxbase
 import dns.immutable
+import dns.rdtypes.mxbase
 
 
 @dns.immutable.immutable
diff --git a/lib/dns/rdtypes/IN/APL.py b/lib/dns/rdtypes/IN/APL.py
index 05e1689f..f1bb01db 100644
--- a/lib/dns/rdtypes/IN/APL.py
+++ b/lib/dns/rdtypes/IN/APL.py
@@ -124,7 +124,6 @@ class APL(dns.rdata.Rdata):
 
     @classmethod
     def from_wire_parser(cls, rdclass, rdtype, parser, origin=None):
-
         items = []
         while parser.remaining() > 0:
             header = parser.get_struct("!HBB")
diff --git a/lib/dns/rdtypes/IN/HTTPS.py b/lib/dns/rdtypes/IN/HTTPS.py
index 7797fbaf..15464cbd 100644
--- a/lib/dns/rdtypes/IN/HTTPS.py
+++ b/lib/dns/rdtypes/IN/HTTPS.py
@@ -1,7 +1,7 @@
 # Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license
 
-import dns.rdtypes.svcbbase
 import dns.immutable
+import dns.rdtypes.svcbbase
 
 
 @dns.immutable.immutable
diff --git a/lib/dns/rdtypes/IN/IPSECKEY.py b/lib/dns/rdtypes/IN/IPSECKEY.py
index 1255739f..8bb2bcb6 100644
--- a/lib/dns/rdtypes/IN/IPSECKEY.py
+++ b/lib/dns/rdtypes/IN/IPSECKEY.py
@@ -15,8 +15,8 @@
 # ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
 # OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 
-import struct
 import base64
+import struct
 
 import dns.exception
 import dns.immutable
diff --git a/lib/dns/rdtypes/IN/KX.py b/lib/dns/rdtypes/IN/KX.py
index c27e9215..a03d1d51 100644
--- a/lib/dns/rdtypes/IN/KX.py
+++ b/lib/dns/rdtypes/IN/KX.py
@@ -15,8 +15,8 @@
 # ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
 # OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 
-import dns.rdtypes.mxbase
 import dns.immutable
+import dns.rdtypes.mxbase
 
 
 @dns.immutable.immutable
diff --git a/lib/dns/rdtypes/IN/NSAP_PTR.py b/lib/dns/rdtypes/IN/NSAP_PTR.py
index 57dadd47..0a18fdce 100644
--- a/lib/dns/rdtypes/IN/NSAP_PTR.py
+++ b/lib/dns/rdtypes/IN/NSAP_PTR.py
@@ -15,8 +15,8 @@
 # ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
 # OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 
-import dns.rdtypes.nsbase
 import dns.immutable
+import dns.rdtypes.nsbase
 
 
 @dns.immutable.immutable
diff --git a/lib/dns/rdtypes/IN/PX.py b/lib/dns/rdtypes/IN/PX.py
index b2216d6b..5c0aa81e 100644
--- a/lib/dns/rdtypes/IN/PX.py
+++ b/lib/dns/rdtypes/IN/PX.py
@@ -19,9 +19,9 @@ import struct
 
 import dns.exception
 import dns.immutable
+import dns.name
 import dns.rdata
 import dns.rdtypes.util
-import dns.name
 
 
 @dns.immutable.immutable
diff --git a/lib/dns/rdtypes/IN/SRV.py b/lib/dns/rdtypes/IN/SRV.py
index 8b0b6bf7..84c54007 100644
--- a/lib/dns/rdtypes/IN/SRV.py
+++ b/lib/dns/rdtypes/IN/SRV.py
@@ -19,9 +19,9 @@ import struct
 
 import dns.exception
 import dns.immutable
+import dns.name
 import dns.rdata
 import dns.rdtypes.util
-import dns.name
 
 
 @dns.immutable.immutable
diff --git a/lib/dns/rdtypes/IN/SVCB.py b/lib/dns/rdtypes/IN/SVCB.py
index 9a1ad101..ff3e9327 100644
--- a/lib/dns/rdtypes/IN/SVCB.py
+++ b/lib/dns/rdtypes/IN/SVCB.py
@@ -1,7 +1,7 @@
 # Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license
 
-import dns.rdtypes.svcbbase
 import dns.immutable
+import dns.rdtypes.svcbbase
 
 
 @dns.immutable.immutable
diff --git a/lib/dns/rdtypes/IN/WKS.py b/lib/dns/rdtypes/IN/WKS.py
index a671e203..26d287a3 100644
--- a/lib/dns/rdtypes/IN/WKS.py
+++ b/lib/dns/rdtypes/IN/WKS.py
@@ -18,8 +18,8 @@
 import socket
 import struct
 
-import dns.ipv4
 import dns.immutable
+import dns.ipv4
 import dns.rdata
 
 try:
diff --git a/lib/dns/rdtypes/dnskeybase.py b/lib/dns/rdtypes/dnskeybase.py
index 1d17f70f..3bfcf860 100644
--- a/lib/dns/rdtypes/dnskeybase.py
+++ b/lib/dns/rdtypes/dnskeybase.py
@@ -19,9 +19,9 @@ import base64
 import enum
 import struct
 
+import dns.dnssectypes
 import dns.exception
 import dns.immutable
-import dns.dnssectypes
 import dns.rdata
 
 # wildcard import
@@ -43,7 +43,7 @@ class DNSKEYBase(dns.rdata.Rdata):
 
     def __init__(self, rdclass, rdtype, flags, protocol, algorithm, key):
         super().__init__(rdclass, rdtype)
-        self.flags = self._as_uint16(flags)
+        self.flags = Flag(self._as_uint16(flags))
         self.protocol = self._as_uint8(protocol)
         self.algorithm = dns.dnssectypes.Algorithm.make(algorithm)
         self.key = self._as_bytes(key)
diff --git a/lib/dns/rdtypes/dsbase.py b/lib/dns/rdtypes/dsbase.py
index b6032b0f..1ad0b7a5 100644
--- a/lib/dns/rdtypes/dsbase.py
+++ b/lib/dns/rdtypes/dsbase.py
@@ -15,8 +15,8 @@
 # ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
 # OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 
-import struct
 import binascii
+import struct
 
 import dns.dnssectypes
 import dns.immutable
@@ -44,7 +44,7 @@ class DSBase(dns.rdata.Rdata):
         super().__init__(rdclass, rdtype)
         self.key_tag = self._as_uint16(key_tag)
         self.algorithm = dns.dnssectypes.Algorithm.make(algorithm)
-        self.digest_type = self._as_uint8(digest_type)
+        self.digest_type = dns.dnssectypes.DSDigest.make(self._as_uint8(digest_type))
         self.digest = self._as_bytes(digest)
         try:
             if len(self.digest) != self._digest_length_by_type[self.digest_type]:
diff --git a/lib/dns/rdtypes/euibase.py b/lib/dns/rdtypes/euibase.py
index e524aea9..4c4068b2 100644
--- a/lib/dns/rdtypes/euibase.py
+++ b/lib/dns/rdtypes/euibase.py
@@ -16,8 +16,8 @@
 
 import binascii
 
-import dns.rdata
 import dns.immutable
+import dns.rdata
 
 
 @dns.immutable.immutable
diff --git a/lib/dns/rdtypes/mxbase.py b/lib/dns/rdtypes/mxbase.py
index b4b9b088..a6bae078 100644
--- a/lib/dns/rdtypes/mxbase.py
+++ b/lib/dns/rdtypes/mxbase.py
@@ -21,8 +21,8 @@ import struct
 
 import dns.exception
 import dns.immutable
-import dns.rdata
 import dns.name
+import dns.rdata
 import dns.rdtypes.util
 
 
diff --git a/lib/dns/rdtypes/nsbase.py b/lib/dns/rdtypes/nsbase.py
index ba7a2ab7..56d94235 100644
--- a/lib/dns/rdtypes/nsbase.py
+++ b/lib/dns/rdtypes/nsbase.py
@@ -19,8 +19,8 @@
 
 import dns.exception
 import dns.immutable
-import dns.rdata
 import dns.name
+import dns.rdata
 
 
 @dns.immutable.immutable
diff --git a/lib/dns/rdtypes/svcbbase.py b/lib/dns/rdtypes/svcbbase.py
index 8d6fb1c6..ba5b53d2 100644
--- a/lib/dns/rdtypes/svcbbase.py
+++ b/lib/dns/rdtypes/svcbbase.py
@@ -34,6 +34,7 @@ class ParamKey(dns.enum.IntEnum):
     IPV4HINT = 4
     ECH = 5
     IPV6HINT = 6
+    DOHPATH = 7
 
     @classmethod
     def _maximum(cls):
diff --git a/lib/dns/rdtypes/tlsabase.py b/lib/dns/rdtypes/tlsabase.py
index a3fdc354..4cdb7ab3 100644
--- a/lib/dns/rdtypes/tlsabase.py
+++ b/lib/dns/rdtypes/tlsabase.py
@@ -15,11 +15,11 @@
 # ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
 # OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 
-import struct
 import binascii
+import struct
 
-import dns.rdata
 import dns.immutable
+import dns.rdata
 import dns.rdatatype
 
 
diff --git a/lib/dns/rdtypes/txtbase.py b/lib/dns/rdtypes/txtbase.py
index d4cb9bb2..fdbfb646 100644
--- a/lib/dns/rdtypes/txtbase.py
+++ b/lib/dns/rdtypes/txtbase.py
@@ -17,9 +17,8 @@
 
 """TXT-like base class."""
 
-from typing import Any, Dict, Iterable, Optional, Tuple, Union
-
 import struct
+from typing import Any, Dict, Iterable, Optional, Tuple, Union
 
 import dns.exception
 import dns.immutable
diff --git a/lib/dns/rdtypes/util.py b/lib/dns/rdtypes/util.py
index 74596f05..54908fdc 100644
--- a/lib/dns/rdtypes/util.py
+++ b/lib/dns/rdtypes/util.py
@@ -18,6 +18,7 @@
 import collections
 import random
 import struct
+from typing import Any, List
 
 import dns.exception
 import dns.ipv4
@@ -119,7 +120,7 @@ class Bitmap:
     def __init__(self, windows=None):
         last_window = -1
         self.windows = windows
-        for (window, bitmap) in self.windows:
+        for window, bitmap in self.windows:
             if not isinstance(window, int):
                 raise ValueError(f"bad {self.type_name} window type")
             if window <= last_window:
@@ -132,11 +133,11 @@ class Bitmap:
             if len(bitmap) == 0 or len(bitmap) > 32:
                 raise ValueError(f"bad {self.type_name} octets")
 
-    def to_text(self):
+    def to_text(self) -> str:
         text = ""
-        for (window, bitmap) in self.windows:
+        for window, bitmap in self.windows:
             bits = []
-            for (i, byte) in enumerate(bitmap):
+            for i, byte in enumerate(bitmap):
                 for j in range(0, 8):
                     if byte & (0x80 >> j):
                         rdtype = window * 256 + i * 8 + j
@@ -145,14 +146,18 @@ class Bitmap:
         return text
 
     @classmethod
-    def from_text(cls, tok):
+    def from_text(cls, tok: "dns.tokenizer.Tokenizer") -> "Bitmap":
         rdtypes = []
         for token in tok.get_remaining():
             rdtype = dns.rdatatype.from_text(token.unescape().value)
             if rdtype == 0:
                 raise dns.exception.SyntaxError(f"{cls.type_name} with bit 0")
             rdtypes.append(rdtype)
-        rdtypes.sort()
+        return cls.from_rdtypes(rdtypes)
+
+    @classmethod
+    def from_rdtypes(cls, rdtypes: List[dns.rdatatype.RdataType]) -> "Bitmap":
+        rdtypes = sorted(rdtypes)
         window = 0
         octets = 0
         prior_rdtype = 0
@@ -177,13 +182,13 @@ class Bitmap:
             windows.append((window, bytes(bitmap[0:octets])))
         return cls(windows)
 
-    def to_wire(self, file):
-        for (window, bitmap) in self.windows:
+    def to_wire(self, file: Any) -> None:
+        for window, bitmap in self.windows:
             file.write(struct.pack("!BB", window, len(bitmap)))
             file.write(bitmap)
 
     @classmethod
-    def from_wire_parser(cls, parser):
+    def from_wire_parser(cls, parser: "dns.wire.Parser") -> "Bitmap":
         windows = []
         while parser.remaining() > 0:
             window = parser.get_uint8()
@@ -226,7 +231,7 @@ def weighted_processing_order(iterable):
         total = sum(rdata._processing_weight() or _no_weight for rdata in rdatas)
         while len(rdatas) > 1:
             r = random.uniform(0, total)
-            for (n, rdata) in enumerate(rdatas):
+            for n, rdata in enumerate(rdatas):
                 weight = rdata._processing_weight() or _no_weight
                 if weight > r:
                     break
diff --git a/lib/dns/renderer.py b/lib/dns/renderer.py
index 3c495f61..53e7c0f6 100644
--- a/lib/dns/renderer.py
+++ b/lib/dns/renderer.py
@@ -19,14 +19,13 @@
 
 import contextlib
 import io
-import struct
 import random
+import struct
 import time
 
 import dns.exception
 import dns.tsig
 
-
 QUESTION = 0
 ANSWER = 1
 AUTHORITY = 2
diff --git a/lib/dns/resolver.py b/lib/dns/resolver.py
index a5b66c1d..f08f824d 100644
--- a/lib/dns/resolver.py
+++ b/lib/dns/resolver.py
@@ -17,29 +17,31 @@
 
 """DNS stub resolver."""
 
-from typing import Any, Dict, List, Optional, Tuple, Union
-
-from urllib.parse import urlparse
 import contextlib
+import random
 import socket
 import sys
 import threading
 import time
-import random
 import warnings
+from typing import Any, Dict, Iterator, List, Optional, Sequence, Tuple, Union
+from urllib.parse import urlparse
 
-import dns.exception
+import dns._ddr
 import dns.edns
+import dns.exception
 import dns.flags
 import dns.inet
 import dns.ipv4
 import dns.ipv6
 import dns.message
 import dns.name
+import dns.nameserver
 import dns.query
 import dns.rcode
 import dns.rdataclass
 import dns.rdatatype
+import dns.rdtypes.svcbbase
 import dns.reversename
 import dns.tsig
 
@@ -72,7 +74,7 @@ class NXDOMAIN(dns.exception.DNSException):
         kwargs = dict(qnames=qnames, responses=responses)
         return kwargs
 
-    def __str__(self):
+    def __str__(self) -> str:
         if "qnames" not in self.kwargs:
             return super().__str__()
         qnames = self.kwargs["qnames"]
@@ -140,7 +142,11 @@ class YXDOMAIN(dns.exception.DNSException):
 
 
 ErrorTuple = Tuple[
-    Optional[str], bool, int, Union[Exception, str], Optional[dns.message.Message]
+    Optional[str],
+    bool,
+    int,
+    Union[Exception, str],
+    Optional[dns.message.Message],
 ]
 
 
@@ -148,11 +154,7 @@ def _errors_to_text(errors: List[ErrorTuple]) -> List[str]:
     """Turn a resolution errors trace into a list of text."""
     texts = []
     for err in errors:
-        texts.append(
-            "Server {} {} port {} answered {}".format(
-                err[0], "TCP" if err[1] else "UDP", err[2], err[3]
-            )
-        )
+        texts.append("Server {} answered {}".format(err[0], err[3]))
     return texts
 
 
@@ -184,7 +186,7 @@ Timeout = LifetimeTimeout
 class NoAnswer(dns.exception.DNSException):
     """The DNS response does not contain an answer to the question."""
 
-    fmt = "The DNS response does not contain an answer " + "to the question: {query}"
+    fmt = "The DNS response does not contain an answer to the question: {query}"
     supp_kwargs = {"response"}
 
     # We do this as otherwise mypy complains about unexpected keyword argument
@@ -264,7 +266,7 @@ class Answer:
         response: dns.message.QueryMessage,
         nameserver: Optional[str] = None,
         port: Optional[int] = None,
-    ):
+    ) -> None:
         self.qname = qname
         self.rdtype = rdtype
         self.rdclass = rdclass
@@ -292,7 +294,7 @@ class Answer:
         else:
             raise AttributeError(attr)
 
-    def __len__(self):
+    def __len__(self) -> int:
         return self.rrset and len(self.rrset) or 0
 
     def __iter__(self):
@@ -309,14 +311,67 @@ class Answer:
         del self.rrset[i]
 
 
+class Answers(dict):
+    """A dict of DNS stub resolver answers, indexed by type."""
+
+
+class HostAnswers(Answers):
+    """A dict of DNS stub resolver answers to a host name lookup, indexed by
+    type.
+    """
+
+    @classmethod
+    def make(
+        cls,
+        v6: Optional[Answer] = None,
+        v4: Optional[Answer] = None,
+        add_empty: bool = True,
+    ) -> "HostAnswers":
+        answers = HostAnswers()
+        if v6 is not None and (add_empty or v6.rrset):
+            answers[dns.rdatatype.AAAA] = v6
+        if v4 is not None and (add_empty or v4.rrset):
+            answers[dns.rdatatype.A] = v4
+        return answers
+
+    # Returns pairs of (address, family) from this result, potentiallys
+    # filtering by address family.
+    def addresses_and_families(
+        self, family: int = socket.AF_UNSPEC
+    ) -> Iterator[Tuple[str, int]]:
+        if family == socket.AF_UNSPEC:
+            yield from self.addresses_and_families(socket.AF_INET6)
+            yield from self.addresses_and_families(socket.AF_INET)
+            return
+        elif family == socket.AF_INET6:
+            answer = self.get(dns.rdatatype.AAAA)
+        elif family == socket.AF_INET:
+            answer = self.get(dns.rdatatype.A)
+        else:
+            raise NotImplementedError(f"unknown address family {family}")
+        if answer:
+            for rdata in answer:
+                yield (rdata.address, family)
+
+    # Returns addresses from this result, potentially filtering by
+    # address family.
+    def addresses(self, family: int = socket.AF_UNSPEC) -> Iterator[str]:
+        return (pair[0] for pair in self.addresses_and_families(family))
+
+    # Returns the canonical name from this result.
+    def canonical_name(self) -> dns.name.Name:
+        answer = self.get(dns.rdatatype.AAAA, self.get(dns.rdatatype.A))
+        return answer.canonical_name
+
+
 class CacheStatistics:
     """Cache Statistics"""
 
-    def __init__(self, hits=0, misses=0):
+    def __init__(self, hits: int = 0, misses: int = 0) -> None:
         self.hits = hits
         self.misses = misses
 
-    def reset(self):
+    def reset(self) -> None:
         self.hits = 0
         self.misses = 0
 
@@ -325,7 +380,7 @@ class CacheStatistics:
 
 
 class CacheBase:
-    def __init__(self):
+    def __init__(self) -> None:
         self.lock = threading.Lock()
         self.statistics = CacheStatistics()
 
@@ -361,7 +416,7 @@ CacheKey = Tuple[dns.name.Name, dns.rdatatype.RdataType, dns.rdataclass.RdataCla
 class Cache(CacheBase):
     """Simple thread-safe DNS answer cache."""
 
-    def __init__(self, cleaning_interval: float = 300.0):
+    def __init__(self, cleaning_interval: float = 300.0) -> None:
         """*cleaning_interval*, a ``float`` is the number of seconds between
         periodic cleanings.
         """
@@ -377,7 +432,7 @@ class Cache(CacheBase):
         now = time.time()
         if self.next_cleaning <= now:
             keys_to_delete = []
-            for (k, v) in self.data.items():
+            for k, v in self.data.items():
                 if v.expiration <= now:
                     keys_to_delete.append(k)
             for k in keys_to_delete:
@@ -447,13 +502,13 @@ class LRUCacheNode:
         self.prev = self
         self.next = self
 
-    def link_after(self, node):
+    def link_after(self, node: "LRUCacheNode") -> None:
         self.prev = node
         self.next = node.next
         node.next.prev = self
         node.next = self
 
-    def unlink(self):
+    def unlink(self) -> None:
         self.next.prev = self.prev
         self.prev.next = self.next
 
@@ -468,7 +523,7 @@ class LRUCache(CacheBase):
     for a new one.
     """
 
-    def __init__(self, max_size: int = 100000):
+    def __init__(self, max_size: int = 100000) -> None:
         """*max_size*, an ``int``, is the maximum number of nodes to cache;
         it must be greater than 0.
         """
@@ -590,30 +645,29 @@ class _Resolution:
         tcp: bool,
         raise_on_no_answer: bool,
         search: Optional[bool],
-    ):
+    ) -> None:
         if isinstance(qname, str):
             qname = dns.name.from_text(qname, None)
-        the_rdtype = dns.rdatatype.RdataType.make(rdtype)
-        if dns.rdatatype.is_metatype(the_rdtype):
+        rdtype = dns.rdatatype.RdataType.make(rdtype)
+        if dns.rdatatype.is_metatype(rdtype):
             raise NoMetaqueries
-        the_rdclass = dns.rdataclass.RdataClass.make(rdclass)
-        if dns.rdataclass.is_metaclass(the_rdclass):
+        rdclass = dns.rdataclass.RdataClass.make(rdclass)
+        if dns.rdataclass.is_metaclass(rdclass):
             raise NoMetaqueries
         self.resolver = resolver
         self.qnames_to_try = resolver._get_qnames_to_try(qname, search)
         self.qnames = self.qnames_to_try[:]
-        self.rdtype = the_rdtype
-        self.rdclass = the_rdclass
+        self.rdtype = rdtype
+        self.rdclass = rdclass
         self.tcp = tcp
         self.raise_on_no_answer = raise_on_no_answer
         self.nxdomain_responses: Dict[dns.name.Name, dns.message.QueryMessage] = {}
         # Initialize other things to help analysis tools
         self.qname = dns.name.empty
-        self.nameservers: List[str] = []
-        self.current_nameservers: List[str] = []
+        self.nameservers: List[dns.nameserver.Nameserver] = []
+        self.current_nameservers: List[dns.nameserver.Nameserver] = []
         self.errors: List[ErrorTuple] = []
-        self.nameserver: Optional[str] = None
-        self.port = 0
+        self.nameserver: Optional[dns.nameserver.Nameserver] = None
         self.tcp_attempt = False
         self.retry_with_tcp = False
         self.request: Optional[dns.message.QueryMessage] = None
@@ -670,7 +724,11 @@ class _Resolution:
             if self.resolver.flags is not None:
                 request.flags = self.resolver.flags
 
-            self.nameservers = self.resolver.nameservers[:]
+            self.nameservers = self.resolver._enrich_nameservers(
+                self.resolver._nameservers,
+                self.resolver.nameserver_ports,
+                self.resolver.port,
+            )
             if self.resolver.rotate:
                 random.shuffle(self.nameservers)
             self.current_nameservers = self.nameservers[:]
@@ -690,12 +748,13 @@ class _Resolution:
         #
         raise NXDOMAIN(qnames=self.qnames_to_try, responses=self.nxdomain_responses)
 
-    def next_nameserver(self) -> Tuple[str, int, bool, float]:
+    def next_nameserver(self) -> Tuple[dns.nameserver.Nameserver, bool, float]:
         if self.retry_with_tcp:
             assert self.nameserver is not None
+            assert not self.nameserver.is_always_max_size()
             self.tcp_attempt = True
             self.retry_with_tcp = False
-            return (self.nameserver, self.port, True, 0)
+            return (self.nameserver, True, 0)
 
         backoff = 0.0
         if not self.current_nameservers:
@@ -707,11 +766,8 @@ class _Resolution:
             self.backoff = min(self.backoff * 2, 2)
 
         self.nameserver = self.current_nameservers.pop(0)
-        self.port = self.resolver.nameserver_ports.get(
-            self.nameserver, self.resolver.port
-        )
-        self.tcp_attempt = self.tcp
-        return (self.nameserver, self.port, self.tcp_attempt, backoff)
+        self.tcp_attempt = self.tcp or self.nameserver.is_always_max_size()
+        return (self.nameserver, self.tcp_attempt, backoff)
 
     def query_result(
         self, response: Optional[dns.message.Message], ex: Optional[Exception]
@@ -724,7 +780,13 @@ class _Resolution:
             # Exception during I/O or from_wire()
             assert response is None
             self.errors.append(
-                (self.nameserver, self.tcp_attempt, self.port, ex, response)
+                (
+                    str(self.nameserver),
+                    self.tcp_attempt,
+                    self.nameserver.answer_port(),
+                    ex,
+                    response,
+                )
             )
             if (
                 isinstance(ex, dns.exception.FormError)
@@ -752,12 +814,18 @@ class _Resolution:
                     self.rdtype,
                     self.rdclass,
                     response,
-                    self.nameserver,
-                    self.port,
+                    self.nameserver.answer_nameserver(),
+                    self.nameserver.answer_port(),
                 )
             except Exception as e:
                 self.errors.append(
-                    (self.nameserver, self.tcp_attempt, self.port, e, response)
+                    (
+                        str(self.nameserver),
+                        self.tcp_attempt,
+                        self.nameserver.answer_port(),
+                        e,
+                        response,
+                    )
                 )
                 # The nameserver is no good, take it out of the mix.
                 self.nameservers.remove(self.nameserver)
@@ -776,7 +844,13 @@ class _Resolution:
                 )
             except Exception as e:
                 self.errors.append(
-                    (self.nameserver, self.tcp_attempt, self.port, e, response)
+                    (
+                        str(self.nameserver),
+                        self.tcp_attempt,
+                        self.nameserver.answer_port(),
+                        e,
+                        response,
+                    )
                 )
                 # The nameserver is no good, take it out of the mix.
                 self.nameservers.remove(self.nameserver)
@@ -792,7 +866,13 @@ class _Resolution:
         elif rcode == dns.rcode.YXDOMAIN:
             yex = YXDOMAIN()
             self.errors.append(
-                (self.nameserver, self.tcp_attempt, self.port, yex, response)
+                (
+                    str(self.nameserver),
+                    self.tcp_attempt,
+                    self.nameserver.answer_port(),
+                    yex,
+                    response,
+                )
             )
             raise yex
         else:
@@ -804,9 +884,9 @@ class _Resolution:
                 self.nameservers.remove(self.nameserver)
             self.errors.append(
                 (
-                    self.nameserver,
+                    str(self.nameserver),
                     self.tcp_attempt,
-                    self.port,
+                    self.nameserver.answer_port(),
                     dns.rcode.to_text(rcode),
                     response,
                 )
@@ -840,8 +920,11 @@ class BaseResolver:
     retry_servfail: bool
     rotate: bool
     ndots: Optional[int]
+    _nameservers: Sequence[Union[str, dns.nameserver.Nameserver]]
 
-    def __init__(self, filename: str = "/etc/resolv.conf", configure: bool = True):
+    def __init__(
+        self, filename: str = "/etc/resolv.conf", configure: bool = True
+    ) -> None:
         """*filename*, a ``str`` or file object, specifying a file
         in standard /etc/resolv.conf format.  This parameter is meaningful
         only when *configure* is true and the platform is POSIX.
@@ -860,13 +943,13 @@ class BaseResolver:
             elif filename:
                 self.read_resolv_conf(filename)
 
-    def reset(self):
+    def reset(self) -> None:
         """Reset all resolver configuration to the defaults."""
 
         self.domain = dns.name.Name(dns.name.from_text(socket.gethostname())[1:])
         if len(self.domain) == 0:
             self.domain = dns.name.root
-        self.nameservers = []
+        self._nameservers = []
         self.nameserver_ports = {}
         self.port = 53
         self.search = []
@@ -903,6 +986,7 @@ class BaseResolver:
 
         """
 
+        nameservers = []
         if isinstance(f, str):
             try:
                 cm: contextlib.AbstractContextManager = open(f)
@@ -922,7 +1006,7 @@ class BaseResolver:
                     continue
 
                 if tokens[0] == "nameserver":
-                    self.nameservers.append(tokens[1])
+                    nameservers.append(tokens[1])
                 elif tokens[0] == "domain":
                     self.domain = dns.name.from_text(tokens[1])
                     # domain and search are exclusive
@@ -950,8 +1034,11 @@ class BaseResolver:
                                 self.ndots = int(opt.split(":")[1])
                             except (ValueError, IndexError):
                                 pass
-        if len(self.nameservers) == 0:
+        if len(nameservers) == 0:
             raise NoResolverConfiguration("no nameservers")
+        # Assigning directly instead of appending means we invoke the
+        # setter logic, with additonal checking and enrichment.
+        self.nameservers = nameservers
 
     def read_registry(self) -> None:
         """Extract resolver configuration from the Windows registry."""
@@ -1086,34 +1173,64 @@ class BaseResolver:
 
         self.flags = flags
 
-    @property
-    def nameservers(self) -> List[str]:
-        return self._nameservers
-
-    @nameservers.setter
-    def nameservers(self, nameservers: List[str]) -> None:
-        """
-        *nameservers*, a ``list`` of nameservers.
-
-        Raises ``ValueError`` if *nameservers* is anything other than a
-        ``list``.
-        """
+    @classmethod
+    def _enrich_nameservers(
+        cls,
+        nameservers: Sequence[Union[str, dns.nameserver.Nameserver]],
+        nameserver_ports: Dict[str, int],
+        default_port: int,
+    ) -> List[dns.nameserver.Nameserver]:
+        enriched_nameservers = []
         if isinstance(nameservers, list):
             for nameserver in nameservers:
-                if not dns.inet.is_address(nameserver):
+                enriched_nameserver: dns.nameserver.Nameserver
+                if isinstance(nameserver, dns.nameserver.Nameserver):
+                    enriched_nameserver = nameserver
+                elif dns.inet.is_address(nameserver):
+                    port = nameserver_ports.get(nameserver, default_port)
+                    enriched_nameserver = dns.nameserver.Do53Nameserver(
+                        nameserver, port
+                    )
+                else:
                     try:
                         if urlparse(nameserver).scheme != "https":
                             raise NotImplementedError
                     except Exception:
                         raise ValueError(
-                            f"nameserver {nameserver} is not an "
-                            "IP address or valid https URL"
+                            f"nameserver {nameserver} is not a "
+                            "dns.nameserver.Nameserver instance or text form, "
+                            "IP address, nor a valid https URL"
                         )
-            self._nameservers = nameservers
+                    enriched_nameserver = dns.nameserver.DoHNameserver(nameserver)
+                enriched_nameservers.append(enriched_nameserver)
         else:
             raise ValueError(
-                "nameservers must be a list (not a {})".format(type(nameservers))
+                "nameservers must be a list or tuple (not a {})".format(
+                    type(nameservers)
+                )
             )
+        return enriched_nameservers
+
+    @property
+    def nameservers(
+        self,
+    ) -> Sequence[Union[str, dns.nameserver.Nameserver]]:
+        return self._nameservers
+
+    @nameservers.setter
+    def nameservers(
+        self, nameservers: Sequence[Union[str, dns.nameserver.Nameserver]]
+    ) -> None:
+        """
+        *nameservers*, a ``list`` of nameservers, where a nameserver is either
+        a string interpretable as a nameserver, or a ``dns.nameserver.Nameserver``
+        instance.
+
+        Raises ``ValueError`` if *nameservers* is not a list of nameservers.
+        """
+        # We just call _enrich_nameservers() for checking
+        self._enrich_nameservers(nameservers, self.nameserver_ports, self.port)
+        self._nameservers = nameservers
 
 
 class Resolver(BaseResolver):
@@ -1198,33 +1315,18 @@ class Resolver(BaseResolver):
             assert request is not None  # needed for type checking
             done = False
             while not done:
-                (nameserver, port, tcp, backoff) = resolution.next_nameserver()
+                (nameserver, tcp, backoff) = resolution.next_nameserver()
                 if backoff:
                     time.sleep(backoff)
                 timeout = self._compute_timeout(start, lifetime, resolution.errors)
                 try:
-                    if dns.inet.is_address(nameserver):
-                        if tcp:
-                            response = dns.query.tcp(
-                                request,
-                                nameserver,
-                                timeout=timeout,
-                                port=port,
-                                source=source,
-                                source_port=source_port,
-                            )
-                        else:
-                            response = dns.query.udp(
-                                request,
-                                nameserver,
-                                timeout=timeout,
-                                port=port,
-                                source=source,
-                                source_port=source_port,
-                                raise_on_truncation=True,
-                            )
-                    else:
-                        response = dns.query.https(request, nameserver, timeout=timeout)
+                    response = nameserver.query(
+                        request,
+                        timeout=timeout,
+                        source=source,
+                        source_port=source_port,
+                        max_size=tcp,
+                    )
                 except Exception as ex:
                     (_, done) = resolution.query_result(None, ex)
                     continue
@@ -1293,7 +1395,72 @@ class Resolver(BaseResolver):
         modified_kwargs["rdclass"] = dns.rdataclass.IN
         return self.resolve(
             dns.reversename.from_address(ipaddr), *args, **modified_kwargs
-        )  # type: ignore[arg-type]
+        )
+
+    def resolve_name(
+        self,
+        name: Union[dns.name.Name, str],
+        family: int = socket.AF_UNSPEC,
+        **kwargs: Any,
+    ) -> HostAnswers:
+        """Use a resolver to query for address records.
+
+        This utilizes the resolve() method to perform A and/or AAAA lookups on
+        the specified name.
+
+        *qname*, a ``dns.name.Name`` or ``str``, the name to resolve.
+
+        *family*, an ``int``, the address family.  If socket.AF_UNSPEC
+        (the default), both A and AAAA records will be retrieved.
+
+        All other arguments that can be passed to the resolve() function
+        except for rdtype and rdclass are also supported by this
+        function.
+        """
+        # We make a modified kwargs for type checking happiness, as otherwise
+        # we get a legit warning about possibly having rdtype and rdclass
+        # in the kwargs more than once.
+        modified_kwargs: Dict[str, Any] = {}
+        modified_kwargs.update(kwargs)
+        modified_kwargs.pop("rdtype", None)
+        modified_kwargs["rdclass"] = dns.rdataclass.IN
+
+        if family == socket.AF_INET:
+            v4 = self.resolve(name, dns.rdatatype.A, **modified_kwargs)
+            return HostAnswers.make(v4=v4)
+        elif family == socket.AF_INET6:
+            v6 = self.resolve(name, dns.rdatatype.AAAA, **modified_kwargs)
+            return HostAnswers.make(v6=v6)
+        elif family != socket.AF_UNSPEC:
+            raise NotImplementedError(f"unknown address family {family}")
+
+        raise_on_no_answer = modified_kwargs.pop("raise_on_no_answer", True)
+        lifetime = modified_kwargs.pop("lifetime", None)
+        start = time.time()
+        v6 = self.resolve(
+            name,
+            dns.rdatatype.AAAA,
+            raise_on_no_answer=False,
+            lifetime=self._compute_timeout(start, lifetime),
+            **modified_kwargs,
+        )
+        # Note that setting name ensures we query the same name
+        # for A as we did for AAAA.  (This is just in case search lists
+        # are active by default in the resolver configuration and
+        # we might be talking to a server that says NXDOMAIN when it
+        # wants to say NOERROR no data.
+        name = v6.qname
+        v4 = self.resolve(
+            name,
+            dns.rdatatype.A,
+            raise_on_no_answer=False,
+            lifetime=self._compute_timeout(start, lifetime),
+            **modified_kwargs,
+        )
+        answers = HostAnswers.make(v6=v6, v4=v4, add_empty=not raise_on_no_answer)
+        if not answers:
+            raise NoAnswer(response=v6.response)
+        return answers
 
     # pylint: disable=redefined-outer-name
 
@@ -1320,6 +1487,37 @@ class Resolver(BaseResolver):
 
     # pylint: enable=redefined-outer-name
 
+    def try_ddr(self, lifetime: float = 5.0) -> None:
+        """Try to update the resolver's nameservers using Discovery of Designated
+        Resolvers (DDR).  If successful, the resolver will subsequently use
+        DNS-over-HTTPS or DNS-over-TLS for future queries.
+
+        *lifetime*, a float, is the maximum time to spend attempting DDR.  The default
+        is 5 seconds.
+
+        If the SVCB query is successful and results in a non-empty list of nameservers,
+        then the resolver's nameservers are set to the returned servers in priority
+        order.
+
+        The current implementation does not use any address hints from the SVCB record,
+        nor does it resolve addresses for the SCVB target name, rather it assumes that
+        the bootstrap nameserver will always be one of the addresses and uses it.
+        A future revision to the code may offer fuller support.  The code verifies that
+        the bootstrap nameserver is in the Subject Alternative Name field of the
+        TLS certficate.
+        """
+        try:
+            expiration = time.time() + lifetime
+            answer = self.resolve(
+                dns._ddr._local_resolver_name, "SVCB", lifetime=lifetime
+            )
+            timeout = dns.query._remaining(expiration)
+            nameservers = dns._ddr._get_nameservers_sync(answer, timeout)
+            if len(nameservers) > 0:
+                self.nameservers = nameservers
+        except Exception:
+            pass
+
 
 #: The default resolver.
 default_resolver: Optional[Resolver] = None
@@ -1333,7 +1531,7 @@ def get_default_resolver() -> Resolver:
     return default_resolver
 
 
-def reset_default_resolver():
+def reset_default_resolver() -> None:
     """Re-initialize default resolver.
 
     Note that the resolver configuration (i.e. /etc/resolv.conf on UNIX
@@ -1355,7 +1553,6 @@ def resolve(
     lifetime: Optional[float] = None,
     search: Optional[bool] = None,
 ) -> Answer:  # pragma: no cover
-
     """Query nameservers to find the answer to the question.
 
     This is a convenience function that uses the default resolver
@@ -1421,6 +1618,18 @@ def resolve_address(ipaddr: str, *args: Any, **kwargs: Any) -> Answer:
     return get_default_resolver().resolve_address(ipaddr, *args, **kwargs)
 
 
+def resolve_name(
+    name: Union[dns.name.Name, str], family: int = socket.AF_UNSPEC, **kwargs: Any
+) -> HostAnswers:
+    """Use a resolver to query for address records.
+
+    See ``dns.resolver.Resolver.resolve_name`` for more information on the
+    parameters.
+    """
+
+    return get_default_resolver().resolve_name(name, family, **kwargs)
+
+
 def canonical_name(name: Union[dns.name.Name, str]) -> dns.name.Name:
     """Determine the canonical name of *name*.
 
@@ -1431,6 +1640,16 @@ def canonical_name(name: Union[dns.name.Name, str]) -> dns.name.Name:
     return get_default_resolver().canonical_name(name)
 
 
+def try_ddr(lifetime: float = 5.0) -> None:
+    """Try to update the default resolver's nameservers using Discovery of Designated
+    Resolvers (DDR).  If successful, the resolver will subsequently use
+    DNS-over-HTTPS or DNS-over-TLS for future queries.
+
+    See :py:func:`dns.resolver.Resolver.try_ddr` for more information.
+    """
+    return get_default_resolver().try_ddr(lifetime)
+
+
 def zone_for_name(
     name: Union[dns.name.Name, str],
     rdclass: dns.rdataclass.RdataClass = dns.rdataclass.IN,
@@ -1478,7 +1697,7 @@ def zone_for_name(
     while 1:
         try:
             rlifetime: Optional[float]
-            if expiration:
+            if expiration is not None:
                 rlifetime = expiration - time.time()
                 if rlifetime <= 0:
                     rlifetime = 0
@@ -1516,6 +1735,83 @@ def zone_for_name(
             raise NoRootSOA
 
 
+def make_resolver_at(
+    where: Union[dns.name.Name, str],
+    port: int = 53,
+    family: int = socket.AF_UNSPEC,
+    resolver: Optional[Resolver] = None,
+) -> Resolver:
+    """Make a stub resolver using the specified destination as the full resolver.
+
+    *where*, a ``dns.name.Name`` or ``str`` the domain name or IP address of the
+    full resolver.
+
+    *port*, an ``int``, the port to use.  If not specified, the default is 53.
+
+    *family*, an ``int``, the address family to use.  This parameter is used if
+    *where* is not an address.  The default is ``socket.AF_UNSPEC`` in which case
+    the first address returned by ``resolve_name()`` will be used, otherwise the
+    first address of the specified family will be used.
+
+    *resolver*, a ``dns.resolver.Resolver`` or ``None``, the resolver to use for
+    resolution of hostnames.  If not specified, the default resolver will be used.
+
+    Returns a ``dns.resolver.Resolver`` or raises an exception.
+    """
+    if resolver is None:
+        resolver = get_default_resolver()
+    nameservers: List[Union[str, dns.nameserver.Nameserver]] = []
+    if isinstance(where, str) and dns.inet.is_address(where):
+        nameservers.append(dns.nameserver.Do53Nameserver(where, port))
+    else:
+        for address in resolver.resolve_name(where, family).addresses():
+            nameservers.append(dns.nameserver.Do53Nameserver(address, port))
+    res = dns.resolver.Resolver(configure=False)
+    res.nameservers = nameservers
+    return res
+
+
+def resolve_at(
+    where: Union[dns.name.Name, str],
+    qname: Union[dns.name.Name, str],
+    rdtype: Union[dns.rdatatype.RdataType, str] = dns.rdatatype.A,
+    rdclass: Union[dns.rdataclass.RdataClass, str] = dns.rdataclass.IN,
+    tcp: bool = False,
+    source: Optional[str] = None,
+    raise_on_no_answer: bool = True,
+    source_port: int = 0,
+    lifetime: Optional[float] = None,
+    search: Optional[bool] = None,
+    port: int = 53,
+    family: int = socket.AF_UNSPEC,
+    resolver: Optional[Resolver] = None,
+) -> Answer:
+    """Query nameservers to find the answer to the question.
+
+    This is a convenience function that calls ``dns.resolver.make_resolver_at()`` to
+    make a resolver, and then uses it to resolve the query.
+
+    See ``dns.resolver.Resolver.resolve`` for more information on the resolution
+    parameters, and ``dns.resolver.make_resolver_at`` for information about the resolver
+    parameters *where*, *port*, *family*, and *resolver*.
+
+    If making more than one query, it is more efficient to call
+    ``dns.resolver.make_resolver_at()`` and then use that resolver for the queries
+    instead of calling ``resolve_at()`` multiple times.
+    """
+    return make_resolver_at(where, port, family, resolver).resolve(
+        qname,
+        rdtype,
+        rdclass,
+        tcp,
+        source,
+        raise_on_no_answer,
+        source_port,
+        lifetime,
+        search,
+    )
+
+
 #
 # Support for overriding the system resolver for all python code in the
 # running process.
@@ -1559,8 +1855,7 @@ def _getaddrinfo(
         )
     if host is None and service is None:
         raise socket.gaierror(socket.EAI_NONAME, "Name or service not known")
-    v6addrs = []
-    v4addrs = []
+    addrs = []
     canonical_name = None  # pylint: disable=redefined-outer-name
     # Is host None or an address literal?  If so, use the system's
     # getaddrinfo().
@@ -1576,24 +1871,9 @@ def _getaddrinfo(
         pass
     # Something needs resolution!
     try:
-        if family == socket.AF_INET6 or family == socket.AF_UNSPEC:
-            v6 = _resolver.resolve(host, dns.rdatatype.AAAA, raise_on_no_answer=False)
-            # Note that setting host ensures we query the same name
-            # for A as we did for AAAA.  (This is just in case search lists
-            # are active by default in the resolver configuration and
-            # we might be talking to a server that says NXDOMAIN when it
-            # wants to say NOERROR no data.
-            host = v6.qname
-            canonical_name = v6.canonical_name.to_text(True)
-            if v6.rrset is not None:
-                for rdata in v6.rrset:
-                    v6addrs.append(rdata.address)
-        if family == socket.AF_INET or family == socket.AF_UNSPEC:
-            v4 = _resolver.resolve(host, dns.rdatatype.A, raise_on_no_answer=False)
-            canonical_name = v4.canonical_name.to_text(True)
-            if v4.rrset is not None:
-                for rdata in v4.rrset:
-                    v4addrs.append(rdata.address)
+        answers = _resolver.resolve_name(host, family)
+        addrs = answers.addresses_and_families()
+        canonical_name = answers.canonical_name().to_text(True)
     except dns.resolver.NXDOMAIN:
         raise socket.gaierror(socket.EAI_NONAME, "Name or service not known")
     except Exception:
@@ -1625,20 +1905,11 @@ def _getaddrinfo(
         cname = canonical_name
     else:
         cname = ""
-    if family == socket.AF_INET6 or family == socket.AF_UNSPEC:
-        for addr in v6addrs:
-            for socktype in socktypes:
-                for proto in _protocols_for_socktype[socktype]:
-                    tuples.append(
-                        (socket.AF_INET6, socktype, proto, cname, (addr, port, 0, 0))
-                    )
-    if family == socket.AF_INET or family == socket.AF_UNSPEC:
-        for addr in v4addrs:
-            for socktype in socktypes:
-                for proto in _protocols_for_socktype[socktype]:
-                    tuples.append(
-                        (socket.AF_INET, socktype, proto, cname, (addr, port))
-                    )
+    for addr, af in addrs:
+        for socktype in socktypes:
+            for proto in _protocols_for_socktype[socktype]:
+                addr_tuple = dns.inet.low_level_address_tuple((addr, port), af)
+                tuples.append((af, socktype, proto, cname, addr_tuple))
     if len(tuples) == 0:
         raise socket.gaierror(socket.EAI_NONAME, "Name or service not known")
     return tuples
diff --git a/lib/dns/reversename.py b/lib/dns/reversename.py
index eb6a3b6b..8236c711 100644
--- a/lib/dns/reversename.py
+++ b/lib/dns/reversename.py
@@ -19,9 +19,9 @@
 
 import binascii
 
-import dns.name
-import dns.ipv6
 import dns.ipv4
+import dns.ipv6
+import dns.name
 
 ipv4_reverse_domain = dns.name.from_text("in-addr.arpa.")
 ipv6_reverse_domain = dns.name.from_text("ip6.arpa.")
diff --git a/lib/dns/rrset.py b/lib/dns/rrset.py
index 3f22a90c..350de13e 100644
--- a/lib/dns/rrset.py
+++ b/lib/dns/rrset.py
@@ -17,11 +17,11 @@
 
 """DNS RRsets (an RRset is a named rdataset)"""
 
-from typing import Any, cast, Collection, Dict, Optional, Union
+from typing import Any, Collection, Dict, Optional, Union, cast
 
 import dns.name
-import dns.rdataset
 import dns.rdataclass
+import dns.rdataset
 import dns.renderer
 
 
@@ -214,9 +214,9 @@ def from_text_list(
 
     if isinstance(name, str):
         name = dns.name.from_text(name, None, idna_codec=idna_codec)
-    the_rdclass = dns.rdataclass.RdataClass.make(rdclass)
-    the_rdtype = dns.rdatatype.RdataType.make(rdtype)
-    r = RRset(name, the_rdclass, the_rdtype)
+    rdclass = dns.rdataclass.RdataClass.make(rdclass)
+    rdtype = dns.rdatatype.RdataType.make(rdtype)
+    r = RRset(name, rdclass, rdtype)
     r.update_ttl(ttl)
     for t in text_rdatas:
         rd = dns.rdata.from_text(
diff --git a/lib/dns/tokenizer.py b/lib/dns/tokenizer.py
index 0551578a..454cac4a 100644
--- a/lib/dns/tokenizer.py
+++ b/lib/dns/tokenizer.py
@@ -17,10 +17,9 @@
 
 """Tokenize DNS zone file format"""
 
-from typing import Any, Optional, List, Tuple
-
 import io
 import sys
+from typing import Any, List, Optional, Tuple
 
 import dns.exception
 import dns.name
diff --git a/lib/dns/transaction.py b/lib/dns/transaction.py
index c4a9e1f6..21dea775 100644
--- a/lib/dns/transaction.py
+++ b/lib/dns/transaction.py
@@ -1,8 +1,7 @@
 # Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license
 
-from typing import Any, Callable, List, Optional, Tuple, Union
-
 import collections
+from typing import Any, Callable, Iterator, List, Optional, Tuple, Union
 
 import dns.exception
 import dns.name
@@ -357,6 +356,27 @@ class Transaction:
         """
         self._check_delete_name.append(check)
 
+    def iterate_rdatasets(
+        self,
+    ) -> Iterator[Tuple[dns.name.Name, dns.rdataset.Rdataset]]:
+        """Iterate all the rdatasets in the transaction, returning
+        (`dns.name.Name`, `dns.rdataset.Rdataset`) tuples.
+
+        Note that as is usual with python iterators, adding or removing items
+        while iterating will invalidate the iterator and may raise `RuntimeError`
+        or fail to iterate over all entries."""
+        self._check_ended()
+        return self._iterate_rdatasets()
+
+    def iterate_names(self) -> Iterator[dns.name.Name]:
+        """Iterate all the names in the transaction.
+
+        Note that as is usual with python iterators, adding or removing names
+        while iterating will invalidate the iterator and may raise `RuntimeError`
+        or fail to iterate over all entries."""
+        self._check_ended()
+        return self._iterate_names()
+
     #
     # Helper methods
     #
@@ -416,7 +436,7 @@ class Transaction:
                 rdataset = rrset.to_rdataset()
             else:
                 raise TypeError(
-                    f"{method} requires a name or RRset " + "as the first argument"
+                    f"{method} requires a name or RRset as the first argument"
                 )
             if rdataset.rdclass != self.manager.get_class():
                 raise ValueError(f"{method} has objects of wrong RdataClass")
@@ -475,7 +495,7 @@ class Transaction:
                 name = rdataset.name
             else:
                 raise TypeError(
-                    f"{method} requires a name or RRset " + "as the first argument"
+                    f"{method} requires a name or RRset as the first argument"
                 )
             self._raise_if_not_empty(method, args)
             if rdataset:
@@ -610,6 +630,10 @@ class Transaction:
         """Return an iterator that yields (name, rdataset) tuples."""
         raise NotImplementedError  # pragma: no cover
 
+    def _iterate_names(self):
+        """Return an iterator that yields a name."""
+        raise NotImplementedError  # pragma: no cover
+
     def _get_node(self, name):
         """Return the node at *name*, if any.
 
diff --git a/lib/dns/tsig.py b/lib/dns/tsig.py
index 2476fdfb..58760f5f 100644
--- a/lib/dns/tsig.py
+++ b/lib/dns/tsig.py
@@ -23,9 +23,9 @@ import hmac
 import struct
 
 import dns.exception
-import dns.rdataclass
 import dns.name
 import dns.rcode
+import dns.rdataclass
 
 
 class BadTime(dns.exception.DNSException):
@@ -187,9 +187,7 @@ class HMACTSig:
         try:
             hashinfo = self._hashes[algorithm]
         except KeyError:
-            raise NotImplementedError(
-                f"TSIG algorithm {algorithm} " + "is not supported"
-            )
+            raise NotImplementedError(f"TSIG algorithm {algorithm} is not supported")
 
         # create the HMAC context
         if isinstance(hashinfo, tuple):
diff --git a/lib/dns/tsigkeyring.py b/lib/dns/tsigkeyring.py
index 6adba284..1010a79f 100644
--- a/lib/dns/tsigkeyring.py
+++ b/lib/dns/tsigkeyring.py
@@ -17,9 +17,8 @@
 
 """A place to store TSIG keys."""
 
-from typing import Any, Dict
-
 import base64
+from typing import Any, Dict
 
 import dns.name
 import dns.tsig
@@ -33,7 +32,7 @@ def from_text(textring: Dict[str, Any]) -> Dict[dns.name.Name, dns.tsig.Key]:
     @rtype: dict"""
 
     keyring = {}
-    for (name, value) in textring.items():
+    for name, value in textring.items():
         kname = dns.name.from_text(name)
         if isinstance(value, str):
             keyring[kname] = dns.tsig.Key(kname, value).secret
@@ -55,7 +54,7 @@ def to_text(keyring: Dict[dns.name.Name, Any]) -> Dict[str, Any]:
     def b64encode(secret):
         return base64.encodebytes(secret).decode().rstrip()
 
-    for (name, key) in keyring.items():
+    for name, key in keyring.items():
         tname = name.to_text()
         if isinstance(key, bytes):
             textring[tname] = b64encode(key)
diff --git a/lib/dns/update.py b/lib/dns/update.py
index 647e5b19..bf1157ac 100644
--- a/lib/dns/update.py
+++ b/lib/dns/update.py
@@ -24,8 +24,8 @@ import dns.name
 import dns.opcode
 import dns.rdata
 import dns.rdataclass
-import dns.rdatatype
 import dns.rdataset
+import dns.rdatatype
 import dns.tsig
 
 
@@ -43,7 +43,6 @@ class UpdateSection(dns.enum.IntEnum):
 
 
 class UpdateMessage(dns.message.Message):  # lgtm[py/missing-equals]
-
     # ignore the mypy error here as we mean to use a different enum
     _section_enum = UpdateSection  # type: ignore
 
@@ -336,12 +335,12 @@ class UpdateMessage(dns.message.Message):  # lgtm[py/missing-equals]
                 True,
             )
         else:
-            the_rdtype = dns.rdatatype.RdataType.make(rdtype)
+            rdtype = dns.rdatatype.RdataType.make(rdtype)
             self.find_rrset(
                 self.prerequisite,
                 name,
                 dns.rdataclass.NONE,
-                the_rdtype,
+                rdtype,
                 dns.rdatatype.NONE,
                 None,
                 True,
diff --git a/lib/dns/version.py b/lib/dns/version.py
index 89d4cf1a..1f1fbf2d 100644
--- a/lib/dns/version.py
+++ b/lib/dns/version.py
@@ -20,13 +20,13 @@
 #: MAJOR
 MAJOR = 2
 #: MINOR
-MINOR = 3
+MINOR = 4
 #: MICRO
-MICRO = 0
+MICRO = 2
 #: RELEASELEVEL
 RELEASELEVEL = 0x0F
 #: SERIAL
-SERIAL = 1
+SERIAL = 0
 
 if RELEASELEVEL == 0x0F:  # pragma: no cover  lgtm[py/unreachable-statement]
     #: version
diff --git a/lib/dns/versioned.py b/lib/dns/versioned.py
index 02e24122..fd78e674 100644
--- a/lib/dns/versioned.py
+++ b/lib/dns/versioned.py
@@ -2,10 +2,9 @@
 
 """DNS Versioned Zones."""
 
-from typing import Callable, Deque, Optional, Set, Union
-
 import collections
 import threading
+from typing import Callable, Deque, Optional, Set, Union
 
 import dns.exception
 import dns.immutable
@@ -32,7 +31,6 @@ Transaction = dns.zone.Transaction
 
 
 class Zone(dns.zone.Zone):  # lgtm[py/missing-equals]
-
     __slots__ = [
         "_versions",
         "_versions_lock",
@@ -152,7 +150,7 @@ class Zone(dns.zone.Zone):  # lgtm[py/missing-equals]
             #
             # This is not a problem with Threading module threads as
             # they cannot be canceled, but could be an issue with trio
-            # or curio tasks when we do the async version of writer().
+            # tasks when we do the async version of writer().
             # I.e. we'd need to do something like:
             #
             # try:
diff --git a/lib/dns/win32util.py b/lib/dns/win32util.py
index ac314750..b2ca61da 100644
--- a/lib/dns/win32util.py
+++ b/lib/dns/win32util.py
@@ -1,7 +1,6 @@
 import sys
 
 if sys.platform == "win32":
-
     from typing import Any
 
     import dns.name
@@ -18,6 +17,7 @@ if sys.platform == "win32":
 
     try:
         import threading
+
         import pythoncom  # pylint: disable=import-error
         import wmi  # pylint: disable=import-error
 
@@ -206,7 +206,7 @@ if sys.platform == "win32":
             lm = winreg.ConnectRegistry(None, winreg.HKEY_LOCAL_MACHINE)
             try:
                 tcp_params = winreg.OpenKey(
-                    lm, r"SYSTEM\CurrentControlSet" r"\Services\Tcpip\Parameters"
+                    lm, r"SYSTEM\CurrentControlSet\Services\Tcpip\Parameters"
                 )
                 try:
                     self._config_fromkey(tcp_params, True)
@@ -214,9 +214,7 @@ if sys.platform == "win32":
                     tcp_params.Close()
                 interfaces = winreg.OpenKey(
                     lm,
-                    r"SYSTEM\CurrentControlSet"
-                    r"\Services\Tcpip\Parameters"
-                    r"\Interfaces",
+                    r"SYSTEM\CurrentControlSet\Services\Tcpip\Parameters\Interfaces",
                 )
                 try:
                     i = 0
diff --git a/lib/dns/wire.py b/lib/dns/wire.py
index cadf1686..9f9b1573 100644
--- a/lib/dns/wire.py
+++ b/lib/dns/wire.py
@@ -1,9 +1,8 @@
 # Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license
 
-from typing import Iterator, Optional, Tuple
-
 import contextlib
 import struct
+from typing import Iterator, Optional, Tuple
 
 import dns.exception
 import dns.name
diff --git a/lib/dns/xfr.py b/lib/dns/xfr.py
index bb165888..dd247d33 100644
--- a/lib/dns/xfr.py
+++ b/lib/dns/xfr.py
@@ -21,9 +21,9 @@ import dns.exception
 import dns.message
 import dns.name
 import dns.rcode
-import dns.serial
 import dns.rdataset
 import dns.rdatatype
+import dns.serial
 import dns.transaction
 import dns.tsig
 import dns.zone
diff --git a/lib/dns/zone.py b/lib/dns/zone.py
index cc8268da..9e763f5f 100644
--- a/lib/dns/zone.py
+++ b/lib/dns/zone.py
@@ -17,30 +17,29 @@
 
 """DNS Zones."""
 
-from typing import Any, Dict, Iterator, Iterable, List, Optional, Set, Tuple, Union
-
 import contextlib
 import io
 import os
 import struct
+from typing import Any, Dict, Iterable, Iterator, List, Optional, Set, Tuple, Union
 
 import dns.exception
+import dns.grange
 import dns.immutable
 import dns.name
 import dns.node
-import dns.rdataclass
-import dns.rdatatype
 import dns.rdata
+import dns.rdataclass
 import dns.rdataset
+import dns.rdatatype
 import dns.rdtypes.ANY.SOA
 import dns.rdtypes.ANY.ZONEMD
 import dns.rrset
 import dns.tokenizer
 import dns.transaction
 import dns.ttl
-import dns.grange
 import dns.zonefile
-from dns.zonetypes import DigestScheme, DigestHashAlgorithm, _digest_hashers
+from dns.zonetypes import DigestHashAlgorithm, DigestScheme, _digest_hashers
 
 
 class BadZone(dns.exception.DNSException):
@@ -321,11 +320,11 @@ class Zone(dns.transaction.TransactionManager):
         Returns a ``dns.rdataset.Rdataset``.
         """
 
-        the_name = self._validate_name(name)
-        the_rdtype = dns.rdatatype.RdataType.make(rdtype)
-        the_covers = dns.rdatatype.RdataType.make(covers)
-        node = self.find_node(the_name, create)
-        return node.find_rdataset(self.rdclass, the_rdtype, the_covers, create)
+        name = self._validate_name(name)
+        rdtype = dns.rdatatype.RdataType.make(rdtype)
+        covers = dns.rdatatype.RdataType.make(covers)
+        node = self.find_node(name, create)
+        return node.find_rdataset(self.rdclass, rdtype, covers, create)
 
     def get_rdataset(
         self,
@@ -404,14 +403,14 @@ class Zone(dns.transaction.TransactionManager):
         types were aggregated into a single RRSIG rdataset.
         """
 
-        the_name = self._validate_name(name)
-        the_rdtype = dns.rdatatype.RdataType.make(rdtype)
-        the_covers = dns.rdatatype.RdataType.make(covers)
-        node = self.get_node(the_name)
+        name = self._validate_name(name)
+        rdtype = dns.rdatatype.RdataType.make(rdtype)
+        covers = dns.rdatatype.RdataType.make(covers)
+        node = self.get_node(name)
         if node is not None:
-            node.delete_rdataset(self.rdclass, the_rdtype, the_covers)
+            node.delete_rdataset(self.rdclass, rdtype, covers)
             if len(node) == 0:
-                self.delete_node(the_name)
+                self.delete_node(name)
 
     def replace_rdataset(
         self, name: Union[dns.name.Name, str], replacement: dns.rdataset.Rdataset
@@ -484,10 +483,10 @@ class Zone(dns.transaction.TransactionManager):
         """
 
         vname = self._validate_name(name)
-        the_rdtype = dns.rdatatype.RdataType.make(rdtype)
-        the_covers = dns.rdatatype.RdataType.make(covers)
-        rdataset = self.nodes[vname].find_rdataset(self.rdclass, the_rdtype, the_covers)
-        rrset = dns.rrset.RRset(vname, self.rdclass, the_rdtype, the_covers)
+        rdtype = dns.rdatatype.RdataType.make(rdtype)
+        covers = dns.rdatatype.RdataType.make(covers)
+        rdataset = self.nodes[vname].find_rdataset(self.rdclass, rdtype, covers)
+        rrset = dns.rrset.RRset(vname, self.rdclass, rdtype, covers)
         rrset.update(rdataset)
         return rrset
 
@@ -565,7 +564,7 @@ class Zone(dns.transaction.TransactionManager):
 
         rdtype = dns.rdatatype.RdataType.make(rdtype)
         covers = dns.rdatatype.RdataType.make(covers)
-        for (name, node) in self.items():
+        for name, node in self.items():
             for rds in node:
                 if rdtype == dns.rdatatype.ANY or (
                     rds.rdtype == rdtype and rds.covers == covers
@@ -597,7 +596,7 @@ class Zone(dns.transaction.TransactionManager):
 
         rdtype = dns.rdatatype.RdataType.make(rdtype)
         covers = dns.rdatatype.RdataType.make(covers)
-        for (name, node) in self.items():
+        for name, node in self.items():
             for rds in node:
                 if rdtype == dns.rdatatype.ANY or (
                     rds.rdtype == rdtype and rds.covers == covers
@@ -795,7 +794,7 @@ class Zone(dns.transaction.TransactionManager):
             assert self.origin is not None
             origin_name = self.origin
         hasher = hashinfo()
-        for (name, node) in sorted(self.items()):
+        for name, node in sorted(self.items()):
             rrnamebuf = name.to_digestable(self.origin)
             for rdataset in sorted(node, key=lambda rds: (rds.rdtype, rds.covers)):
                 if name == origin_name and dns.rdatatype.ZONEMD in (
@@ -997,6 +996,9 @@ class Version:
             return None
         return node.get_rdataset(self.zone.rdclass, rdtype, covers)
 
+    def keys(self):
+        return self.nodes.keys()
+
     def items(self):
         return self.nodes.items()
 
@@ -1143,10 +1145,13 @@ class Transaction(dns.transaction.Transaction):
             self.version.origin = origin
 
     def _iterate_rdatasets(self):
-        for (name, node) in self.version.items():
+        for name, node in self.version.items():
             for rdataset in node:
                 yield (name, rdataset)
 
+    def _iterate_names(self):
+        return self.version.keys()
+
     def _get_node(self, name):
         return self.version.get_node(name)
 
diff --git a/lib/dns/zonefile.py b/lib/dns/zonefile.py
index 1a53f5bc..27f04924 100644
--- a/lib/dns/zonefile.py
+++ b/lib/dns/zonefile.py
@@ -17,23 +17,22 @@
 
 """DNS Zones."""
 
-from typing import Any, Iterable, List, Optional, Set, Tuple, Union
-
 import re
 import sys
+from typing import Any, Iterable, List, Optional, Set, Tuple, Union
 
 import dns.exception
+import dns.grange
 import dns.name
 import dns.node
+import dns.rdata
 import dns.rdataclass
 import dns.rdatatype
-import dns.rdata
 import dns.rdtypes.ANY.SOA
 import dns.rrset
 import dns.tokenizer
 import dns.transaction
 import dns.ttl
-import dns.grange
 
 
 class UnknownOrigin(dns.exception.DNSException):
@@ -191,10 +190,6 @@ class Reader:
                 self.last_ttl_known = True
                 token = None
             except dns.ttl.BadTTL:
-                if self.default_ttl_known:
-                    ttl = self.default_ttl
-                elif self.last_ttl_known:
-                    ttl = self.last_ttl
                 self.tok.unget(token)
 
         # Class
@@ -212,6 +207,22 @@ class Reader:
             if rdclass != self.zone_rdclass:
                 raise dns.exception.SyntaxError("RR class is not zone's class")
 
+        if ttl is None:
+            # support for <class> <ttl> <type> syntax
+            token = self._get_identifier()
+            ttl = None
+            try:
+                ttl = dns.ttl.from_text(token.value)
+                self.last_ttl = ttl
+                self.last_ttl_known = True
+                token = None
+            except dns.ttl.BadTTL:
+                if self.default_ttl_known:
+                    ttl = self.default_ttl
+                elif self.last_ttl_known:
+                    ttl = self.last_ttl
+                self.tok.unget(token)
+
         # Type
         if self.force_rdtype is not None:
             rdtype = self.force_rdtype
@@ -581,7 +592,7 @@ class RRsetsReaderTransaction(dns.transaction.Transaction):
             pass
 
     def _name_exists(self, name):
-        for (n, _, _) in self.rdatasets:
+        for n, _, _ in self.rdatasets:
             if n == name:
                 return True
         return False
@@ -606,6 +617,9 @@ class RRsetsReaderTransaction(dns.transaction.Transaction):
     def _iterate_rdatasets(self):
         raise NotImplementedError  # pragma: no cover
 
+    def _iterate_names(self):
+        raise NotImplementedError  # pragma: no cover
+
 
 class RRSetsReaderManager(dns.transaction.TransactionManager):
     def __init__(
@@ -707,26 +721,26 @@ def read_rrsets(
     if isinstance(default_ttl, str):
         default_ttl = dns.ttl.from_text(default_ttl)
     if rdclass is not None:
-        the_rdclass = dns.rdataclass.RdataClass.make(rdclass)
+        rdclass = dns.rdataclass.RdataClass.make(rdclass)
     else:
-        the_rdclass = None
-    the_default_rdclass = dns.rdataclass.RdataClass.make(default_rdclass)
+        rdclass = None
+    default_rdclass = dns.rdataclass.RdataClass.make(default_rdclass)
     if rdtype is not None:
-        the_rdtype = dns.rdatatype.RdataType.make(rdtype)
+        rdtype = dns.rdatatype.RdataType.make(rdtype)
     else:
-        the_rdtype = None
+        rdtype = None
     manager = RRSetsReaderManager(origin, relativize, default_rdclass)
     with manager.writer(True) as txn:
         tok = dns.tokenizer.Tokenizer(text, "<input>", idna_codec=idna_codec)
         reader = Reader(
             tok,
-            the_default_rdclass,
+            default_rdclass,
             txn,
             allow_directives=False,
             force_name=name,
             force_ttl=ttl,
-            force_rdclass=the_rdclass,
-            force_rdtype=the_rdtype,
+            force_rdclass=rdclass,
+            force_rdtype=rdtype,
             default_ttl=default_ttl,
         )
         reader.read()
diff --git a/requirements.txt b/requirements.txt
index 03b49577..d4e4442f 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -11,7 +11,7 @@ cheroot==9.0.0
 cherrypy==18.8.0
 cloudinary==1.34.0
 distro==1.8.0
-dnspython==2.3.0
+dnspython==2.4.2
 facebook-sdk==3.1.0
 future==0.18.3
 ga4mp==2.0.4

From 69d052f758511c5b4523ea5210a433ce14f8c30d Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 24 Aug 2023 12:05:25 -0700
Subject: [PATCH 438/743] Bump zipp from 3.15.0 to 3.16.2 (#2124)

* Bump zipp from 3.15.0 to 3.16.2

Bumps [zipp](https://github.com/jaraco/zipp) from 3.15.0 to 3.16.2.
- [Release notes](https://github.com/jaraco/zipp/releases)
- [Changelog](https://github.com/jaraco/zipp/blob/main/NEWS.rst)
- [Commits](https://github.com/jaraco/zipp/compare/v3.15.0...v3.16.2)

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

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

* Update zipp==3.16.2

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/zipp/__init__.py    | 30 ++++++++++++------------------
 lib/zipp/glob.py        | 40 ++++++++++++++++++++++++++++++++++++++++
 lib/zipp/py310compat.py |  5 ++---
 requirements.txt        |  2 +-
 4 files changed, 55 insertions(+), 22 deletions(-)
 create mode 100644 lib/zipp/glob.py

diff --git a/lib/zipp/__init__.py b/lib/zipp/__init__.py
index ddfa0a64..3354c2bb 100644
--- a/lib/zipp/__init__.py
+++ b/lib/zipp/__init__.py
@@ -5,9 +5,9 @@ import itertools
 import contextlib
 import pathlib
 import re
-import fnmatch
 
 from .py310compat import text_encoding
+from .glob import translate
 
 
 __all__ = ['Path']
@@ -298,21 +298,24 @@ class Path:
         encoding, args, kwargs = _extract_text_encoding(*args, **kwargs)
         return io.TextIOWrapper(stream, encoding, *args, **kwargs)
 
+    def _base(self):
+        return pathlib.PurePosixPath(self.at or self.root.filename)
+
     @property
     def name(self):
-        return pathlib.Path(self.at).name or self.filename.name
+        return self._base().name
 
     @property
     def suffix(self):
-        return pathlib.Path(self.at).suffix or self.filename.suffix
+        return self._base().suffix
 
     @property
     def suffixes(self):
-        return pathlib.Path(self.at).suffixes or self.filename.suffixes
+        return self._base().suffixes
 
     @property
     def stem(self):
-        return pathlib.Path(self.at).stem or self.filename.stem
+        return self._base().stem
 
     @property
     def filename(self):
@@ -349,7 +352,7 @@ class Path:
         return filter(self._is_child, subs)
 
     def match(self, path_pattern):
-        return pathlib.Path(self.at).match(path_pattern)
+        return pathlib.PurePosixPath(self.at).match(path_pattern)
 
     def is_symlink(self):
         """
@@ -357,22 +360,13 @@ class Path:
         """
         return False
 
-    def _descendants(self):
-        for child in self.iterdir():
-            yield child
-            if child.is_dir():
-                yield from child._descendants()
-
     def glob(self, pattern):
         if not pattern:
             raise ValueError(f"Unacceptable pattern: {pattern!r}")
 
-        matches = re.compile(fnmatch.translate(pattern)).fullmatch
-        return (
-            child
-            for child in self._descendants()
-            if matches(str(child.relative_to(self)))
-        )
+        prefix = re.escape(self.at)
+        matches = re.compile(prefix + translate(pattern)).fullmatch
+        return map(self._next, filter(matches, self.root.namelist()))
 
     def rglob(self, pattern):
         return self.glob(f'**/{pattern}')
diff --git a/lib/zipp/glob.py b/lib/zipp/glob.py
new file mode 100644
index 00000000..4a2e665e
--- /dev/null
+++ b/lib/zipp/glob.py
@@ -0,0 +1,40 @@
+import re
+
+
+def translate(pattern):
+    r"""
+    Given a glob pattern, produce a regex that matches it.
+
+    >>> translate('*.txt')
+    '[^/]*\\.txt'
+    >>> translate('a?txt')
+    'a.txt'
+    >>> translate('**/*')
+    '.*/[^/]*'
+    """
+    return ''.join(map(replace, separate(pattern)))
+
+
+def separate(pattern):
+    """
+    Separate out character sets to avoid translating their contents.
+
+    >>> [m.group(0) for m in separate('*.txt')]
+    ['*.txt']
+    >>> [m.group(0) for m in separate('a[?]txt')]
+    ['a', '[?]', 'txt']
+    """
+    return re.finditer(r'([^\[]+)|(?P<set>[\[].*?[\]])|([\[][^\]]*$)', pattern)
+
+
+def replace(match):
+    """
+    Perform the replacements for a match from :func:`separate`.
+    """
+
+    return match.group('set') or (
+        re.escape(match.group(0))
+        .replace('\\*\\*', r'.*')
+        .replace('\\*', r'[^/]*')
+        .replace('\\?', r'.')
+    )
diff --git a/lib/zipp/py310compat.py b/lib/zipp/py310compat.py
index 8244124c..d5ca53e0 100644
--- a/lib/zipp/py310compat.py
+++ b/lib/zipp/py310compat.py
@@ -2,9 +2,8 @@ import sys
 import io
 
 
-te_impl = 'lambda encoding, stacklevel=2, /: encoding'
-te_impl_37 = te_impl.replace(', /', '')
-_text_encoding = eval(te_impl) if sys.version_info > (3, 8) else eval(te_impl_37)
+def _text_encoding(encoding, stacklevel=2, /):  # pragma: no cover
+    return encoding
 
 
 text_encoding = (
diff --git a/requirements.txt b/requirements.txt
index d4e4442f..7157e7b6 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -49,7 +49,7 @@ urllib3<2
 webencodings==0.5.1
 websocket-client==1.6.2
 xmltodict==0.13.0
-zipp==3.15.0
+zipp==3.16.2
 
 # configobj==5.1.0
 # sgmllib3k==1.0.0

From 9383d5120c4232388f5a12e013a531bdca587587 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 24 Aug 2023 12:05:41 -0700
Subject: [PATCH 439/743] Bump portend from 3.1.0 to 3.2.0 (#2125)

Bumps [portend](https://github.com/jaraco/portend) from 3.1.0 to 3.2.0.
- [Release notes](https://github.com/jaraco/portend/releases)
- [Changelog](https://github.com/jaraco/portend/blob/main/NEWS.rst)
- [Commits](https://github.com/jaraco/portend/compare/v3.1.0...v3.2.0)

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

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements.txt b/requirements.txt
index 7157e7b6..82b2e93d 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -29,7 +29,7 @@ musicbrainzngs==0.7.1
 packaging==23.1
 paho-mqtt==1.6.1
 plexapi==4.13.4
-portend==3.1.0
+portend==3.2.0
 profilehooks==1.12.0
 PyJWT==2.8.0
 pyparsing==3.0.9

From 72f1ce786543d832a49b6fd1cff5cbd1597ef468 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 24 Aug 2023 12:05:53 -0700
Subject: [PATCH 440/743] Bump importlib-resources from 5.12.0 to 6.0.1 (#2126)

* Bump importlib-resources from 5.12.0 to 6.0.1

Bumps [importlib-resources](https://github.com/python/importlib_resources) from 5.12.0 to 6.0.1.
- [Release notes](https://github.com/python/importlib_resources/releases)
- [Changelog](https://github.com/python/importlib_resources/blob/main/NEWS.rst)
- [Commits](https://github.com/python/importlib_resources/compare/v5.12.0...v6.0.1)

---
updated-dependencies:
- dependency-name: importlib-resources
  dependency-type: direct:production
  update-type: version-update:semver-major
...

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

* Update importlib-resources==6.0.1

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/importlib_resources/__init__.py |  19 -----
 lib/importlib_resources/_legacy.py  | 120 ----------------------------
 package/requirements-package.txt    |   2 +-
 requirements.txt                    |   2 +-
 4 files changed, 2 insertions(+), 141 deletions(-)
 delete mode 100644 lib/importlib_resources/_legacy.py

diff --git a/lib/importlib_resources/__init__.py b/lib/importlib_resources/__init__.py
index 34e3a995..e6b60c18 100644
--- a/lib/importlib_resources/__init__.py
+++ b/lib/importlib_resources/__init__.py
@@ -6,31 +6,12 @@ from ._common import (
     Package,
 )
 
-from ._legacy import (
-    contents,
-    open_binary,
-    read_binary,
-    open_text,
-    read_text,
-    is_resource,
-    path,
-    Resource,
-)
-
 from .abc import ResourceReader
 
 
 __all__ = [
     'Package',
-    'Resource',
     'ResourceReader',
     'as_file',
-    'contents',
     'files',
-    'is_resource',
-    'open_binary',
-    'open_text',
-    'path',
-    'read_binary',
-    'read_text',
 ]
diff --git a/lib/importlib_resources/_legacy.py b/lib/importlib_resources/_legacy.py
deleted file mode 100644
index b1ea8105..00000000
--- a/lib/importlib_resources/_legacy.py
+++ /dev/null
@@ -1,120 +0,0 @@
-import functools
-import os
-import pathlib
-import types
-import warnings
-
-from typing import Union, Iterable, ContextManager, BinaryIO, TextIO, Any
-
-from . import _common
-
-Package = Union[types.ModuleType, str]
-Resource = str
-
-
-def deprecated(func):
-    @functools.wraps(func)
-    def wrapper(*args, **kwargs):
-        warnings.warn(
-            f"{func.__name__} is deprecated. Use files() instead. "
-            "Refer to https://importlib-resources.readthedocs.io"
-            "/en/latest/using.html#migrating-from-legacy for migration advice.",
-            DeprecationWarning,
-            stacklevel=2,
-        )
-        return func(*args, **kwargs)
-
-    return wrapper
-
-
-def normalize_path(path: Any) -> str:
-    """Normalize a path by ensuring it is a string.
-
-    If the resulting string contains path separators, an exception is raised.
-    """
-    str_path = str(path)
-    parent, file_name = os.path.split(str_path)
-    if parent:
-        raise ValueError(f'{path!r} must be only a file name')
-    return file_name
-
-
-@deprecated
-def open_binary(package: Package, resource: Resource) -> BinaryIO:
-    """Return a file-like object opened for binary reading of the resource."""
-    return (_common.files(package) / normalize_path(resource)).open('rb')
-
-
-@deprecated
-def read_binary(package: Package, resource: Resource) -> bytes:
-    """Return the binary contents of the resource."""
-    return (_common.files(package) / normalize_path(resource)).read_bytes()
-
-
-@deprecated
-def open_text(
-    package: Package,
-    resource: Resource,
-    encoding: str = 'utf-8',
-    errors: str = 'strict',
-) -> TextIO:
-    """Return a file-like object opened for text reading of the resource."""
-    return (_common.files(package) / normalize_path(resource)).open(
-        'r', encoding=encoding, errors=errors
-    )
-
-
-@deprecated
-def read_text(
-    package: Package,
-    resource: Resource,
-    encoding: str = 'utf-8',
-    errors: str = 'strict',
-) -> str:
-    """Return the decoded string of the resource.
-
-    The decoding-related arguments have the same semantics as those of
-    bytes.decode().
-    """
-    with open_text(package, resource, encoding, errors) as fp:
-        return fp.read()
-
-
-@deprecated
-def contents(package: Package) -> Iterable[str]:
-    """Return an iterable of entries in `package`.
-
-    Note that not all entries are resources.  Specifically, directories are
-    not considered resources.  Use `is_resource()` on each entry returned here
-    to check if it is a resource or not.
-    """
-    return [path.name for path in _common.files(package).iterdir()]
-
-
-@deprecated
-def is_resource(package: Package, name: str) -> bool:
-    """True if `name` is a resource inside `package`.
-
-    Directories are *not* resources.
-    """
-    resource = normalize_path(name)
-    return any(
-        traversable.name == resource and traversable.is_file()
-        for traversable in _common.files(package).iterdir()
-    )
-
-
-@deprecated
-def path(
-    package: Package,
-    resource: Resource,
-) -> ContextManager[pathlib.Path]:
-    """A context manager providing a file path object to the resource.
-
-    If the resource does not already exist on its own on the file system,
-    a temporary file will be created. If the file was created, the file
-    will be deleted upon exiting the context manager (no exception is
-    raised if the file was deleted prior to the context manager
-    exiting).
-    """
-    return _common.as_file(_common.files(package) / normalize_path(resource))
diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index 5847d597..e0bd159b 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -1,6 +1,6 @@
 apscheduler==3.10.1
 importlib-metadata==6.8.0
-importlib-resources==5.12.0
+importlib-resources==6.0.1
 pyinstaller==5.13.0
 pyopenssl==23.2.0
 pycryptodomex==3.18.0
diff --git a/requirements.txt b/requirements.txt
index 82b2e93d..5f3de400 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -20,7 +20,7 @@ html5lib==1.1
 httpagentparser==1.9.5
 idna==3.4
 importlib-metadata==6.8.0
-importlib-resources==5.12.0
+importlib-resources==6.0.1
 git+https://github.com/Tautulli/ipwhois.git@master#egg=ipwhois
 IPy==1.01
 Mako==1.2.4

From 9423f65a9024c68c5ab6b3bcc2cce52f824dac6f Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 24 Aug 2023 12:06:08 -0700
Subject: [PATCH 441/743] Bump backports-functools-lru-cache from 1.6.4 to
 1.6.6 (#2127)

* Bump backports-functools-lru-cache from 1.6.4 to 1.6.6

Bumps [backports-functools-lru-cache](https://github.com/jaraco/backports.functools_lru_cache) from 1.6.4 to 1.6.6.
- [Release notes](https://github.com/jaraco/backports.functools_lru_cache/releases)
- [Changelog](https://github.com/jaraco/backports.functools_lru_cache/blob/main/NEWS.rst)
- [Commits](https://github.com/jaraco/backports.functools_lru_cache/compare/v1.6.4...v1.6.6)

---
updated-dependencies:
- dependency-name: backports-functools-lru-cache
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

* Update backports-functools-lru-cache==1.6.6

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/backports/__init__.py            | 6 +-----
 lib/backports/functools_lru_cache.py | 1 -
 requirements.txt                     | 2 +-
 3 files changed, 2 insertions(+), 7 deletions(-)

diff --git a/lib/backports/__init__.py b/lib/backports/__init__.py
index b09491b2..0d1f7edf 100644
--- a/lib/backports/__init__.py
+++ b/lib/backports/__init__.py
@@ -1,5 +1 @@
-# A Python "namespace package" http://www.python.org/dev/peps/pep-0382/
-# This always goes inside of a namespace package's __init__.py
-from pkgutil import extend_path
-
-__path__ = extend_path(__path__, __name__)  # type: ignore
+__path__ = __import__('pkgutil').extend_path(__path__, __name__)  # type: ignore
diff --git a/lib/backports/functools_lru_cache.py b/lib/backports/functools_lru_cache.py
index 8be4515f..1b83fe99 100644
--- a/lib/backports/functools_lru_cache.py
+++ b/lib/backports/functools_lru_cache.py
@@ -89,7 +89,6 @@ def lru_cache(maxsize=100, typed=False):  # noqa: C901
     # to allow the implementation to change (including a possible C version).
 
     def decorating_function(user_function):
-
         cache = dict()
         stats = [0, 0]  # make statistics updateable non-locally
         HITS, MISSES = 0, 1  # names for the stats fields
diff --git a/requirements.txt b/requirements.txt
index 5f3de400..e8dbb20d 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -2,7 +2,7 @@ appdirs==1.4.4
 apscheduler==3.10.1
 arrow==1.2.3
 backports.csv==1.0.7
-backports.functools-lru-cache==1.6.4
+backports.functools-lru-cache==1.6.6
 backports.zoneinfo==0.2.1;python_version<"3.9"
 beautifulsoup4==4.12.2
 bleach==6.0.0

From 4033114175244ddb80c6bcf565cf4a12b1731ce2 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 24 Aug 2023 12:09:15 -0700
Subject: [PATCH 442/743] Bump cheroot from 9.0.0 to 10.0.0 (#2128)

* Bump cheroot from 9.0.0 to 10.0.0

Bumps [cheroot](https://github.com/cherrypy/cheroot) from 9.0.0 to 10.0.0.
- [Release notes](https://github.com/cherrypy/cheroot/releases)
- [Changelog](https://github.com/cherrypy/cheroot/blob/main/CHANGES.rst)
- [Commits](https://github.com/cherrypy/cheroot/compare/v9.0.0...v10.0.0)

---
updated-dependencies:
- dependency-name: cheroot
  dependency-type: direct:production
  update-type: version-update:semver-major
...

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

* Update cheroot==10.0.0

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/cheroot/_compat.py             |   1 +
 lib/cheroot/_compat.pyi            |   1 +
 lib/cheroot/connections.py         |   7 +-
 lib/cheroot/errors.py              |   7 +-
 lib/cheroot/server.py              |  46 +++++++++++-
 lib/cheroot/server.pyi             |   7 +-
 lib/cheroot/ssl/__init__.pyi       |   4 +-
 lib/cheroot/test/_pytest_plugin.py |  17 -----
 lib/cheroot/test/test_conn.py      |   3 +-
 lib/cheroot/test/test_core.py      |   6 +-
 lib/cheroot/test/test_errors.py    |   3 +-
 lib/cheroot/test/test_server.py    | 117 +++++++++++++++++++++++++++++
 lib/cheroot/test/test_ssl.py       |  12 ---
 lib/cheroot/test/webtest.py        |   5 +-
 lib/cheroot/testing.py             |   4 +-
 lib/cheroot/workers/threadpool.py  |  54 +++++++------
 lib/cheroot/wsgi.py                |   2 +
 lib/cheroot/wsgi.pyi               |   2 +-
 requirements.txt                   |   2 +-
 19 files changed, 215 insertions(+), 85 deletions(-)

diff --git a/lib/cheroot/_compat.py b/lib/cheroot/_compat.py
index 20c993de..dbe5c6d2 100644
--- a/lib/cheroot/_compat.py
+++ b/lib/cheroot/_compat.py
@@ -24,6 +24,7 @@ SYS_PLATFORM = platform.system()
 IS_WINDOWS = SYS_PLATFORM == 'Windows'
 IS_LINUX = SYS_PLATFORM == 'Linux'
 IS_MACOS = SYS_PLATFORM == 'Darwin'
+IS_SOLARIS = SYS_PLATFORM == 'SunOS'
 
 PLATFORM_ARCH = platform.machine()
 IS_PPC = PLATFORM_ARCH.startswith('ppc')
diff --git a/lib/cheroot/_compat.pyi b/lib/cheroot/_compat.pyi
index 023bad8c..67d93cf6 100644
--- a/lib/cheroot/_compat.pyi
+++ b/lib/cheroot/_compat.pyi
@@ -10,6 +10,7 @@ SYS_PLATFORM: str
 IS_WINDOWS: bool
 IS_LINUX: bool
 IS_MACOS: bool
+IS_SOLARIS: bool
 PLATFORM_ARCH: str
 IS_PPC: bool
 
diff --git a/lib/cheroot/connections.py b/lib/cheroot/connections.py
index 9b6366e5..9346bc6a 100644
--- a/lib/cheroot/connections.py
+++ b/lib/cheroot/connections.py
@@ -274,8 +274,7 @@ class ConnectionManager:
             # One of the reason on why a socket could cause an error
             # is that the socket is already closed, ignore the
             # socket error if we try to close it at this point.
-            # This is equivalent to OSError in Py3
-            with suppress(socket.error):
+            with suppress(OSError):
                 conn.close()
 
     def _from_server_socket(self, server_socket):  # noqa: C901  # FIXME
@@ -308,7 +307,7 @@ class ConnectionManager:
                     wfile = mf(s, 'wb', io.DEFAULT_BUFFER_SIZE)
                     try:
                         wfile.write(''.join(buf).encode('ISO-8859-1'))
-                    except socket.error as ex:
+                    except OSError as ex:
                         if ex.args[0] not in errors.socket_errors_to_ignore:
                             raise
                     return
@@ -343,7 +342,7 @@ class ConnectionManager:
             # notice keyboard interrupts on Win32, which don't interrupt
             # accept() by default
             return
-        except socket.error as ex:
+        except OSError as ex:
             if self.server.stats['Enabled']:
                 self.server.stats['Socket Errors'] += 1
             if ex.args[0] in errors.socket_error_eintr:
diff --git a/lib/cheroot/errors.py b/lib/cheroot/errors.py
index 046263ad..f6b588c2 100644
--- a/lib/cheroot/errors.py
+++ b/lib/cheroot/errors.py
@@ -77,9 +77,4 @@ Refs:
 * https://docs.microsoft.com/windows/win32/api/winsock/nf-winsock-shutdown
 """
 
-try:  # py3
-    acceptable_sock_shutdown_exceptions = (
-        BrokenPipeError, ConnectionResetError,
-    )
-except NameError:  # py2
-    acceptable_sock_shutdown_exceptions = ()
+acceptable_sock_shutdown_exceptions = (BrokenPipeError, ConnectionResetError)
diff --git a/lib/cheroot/server.py b/lib/cheroot/server.py
index 6b8e37a9..bceeb2c9 100644
--- a/lib/cheroot/server.py
+++ b/lib/cheroot/server.py
@@ -1572,6 +1572,9 @@ class HTTPServer:
     ``PEERCREDS``-provided IDs.
     """
 
+    reuse_port = False
+    """If True, set SO_REUSEPORT on the socket."""
+
     keep_alive_conn_limit = 10
     """Maximum number of waiting keep-alive connections that will be kept open.
 
@@ -1581,6 +1584,7 @@ class HTTPServer:
         self, bind_addr, gateway,
         minthreads=10, maxthreads=-1, server_name=None,
         peercreds_enabled=False, peercreds_resolve_enabled=False,
+        reuse_port=False,
     ):
         """Initialize HTTPServer instance.
 
@@ -1591,6 +1595,8 @@ class HTTPServer:
             maxthreads (int): maximum number of threads for HTTP thread pool
             server_name (str): web server name to be advertised via Server
                 HTTP header
+            reuse_port (bool): if True SO_REUSEPORT option would be set to
+                socket
         """
         self.bind_addr = bind_addr
         self.gateway = gateway
@@ -1606,6 +1612,7 @@ class HTTPServer:
         self.peercreds_resolve_enabled = (
             peercreds_resolve_enabled and peercreds_enabled
         )
+        self.reuse_port = reuse_port
         self.clear_stats()
 
     def clear_stats(self):
@@ -1880,6 +1887,7 @@ class HTTPServer:
             self.bind_addr,
             family, type, proto,
             self.nodelay, self.ssl_adapter,
+            self.reuse_port,
         )
         sock = self.socket = self.bind_socket(sock, self.bind_addr)
         self.bind_addr = self.resolve_real_bind_addr(sock)
@@ -1911,9 +1919,6 @@ class HTTPServer:
                     'remove() argument 1 must be encoded '
                     'string without null bytes, not unicode'
                     not in err_msg
-                    and 'embedded NUL character' not in err_msg  # py34
-                    and 'argument must be a '
-                    'string without NUL characters' not in err_msg  # pypy2
             ):
                 raise
         except ValueError as val_err:
@@ -1931,6 +1936,7 @@ class HTTPServer:
             bind_addr=bind_addr,
             family=socket.AF_UNIX, type=socket.SOCK_STREAM, proto=0,
             nodelay=self.nodelay, ssl_adapter=self.ssl_adapter,
+            reuse_port=self.reuse_port,
         )
 
         try:
@@ -1971,7 +1977,36 @@ class HTTPServer:
         return sock
 
     @staticmethod
-    def prepare_socket(bind_addr, family, type, proto, nodelay, ssl_adapter):
+    def _make_socket_reusable(socket_, bind_addr):
+        host, port = bind_addr[:2]
+        IS_EPHEMERAL_PORT = port == 0
+
+        if socket_.family not in (socket.AF_INET, socket.AF_INET6):
+            raise ValueError('Cannot reuse a non-IP socket')
+
+        if IS_EPHEMERAL_PORT:
+            raise ValueError('Cannot reuse an ephemeral port (0)')
+
+        # Most BSD kernels implement SO_REUSEPORT the way that only the
+        # latest listener can read from socket. Some of BSD kernels also
+        # have SO_REUSEPORT_LB that works similarly to SO_REUSEPORT
+        # in Linux.
+        if hasattr(socket, 'SO_REUSEPORT_LB'):
+            socket_.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEPORT_LB, 1)
+        elif hasattr(socket, 'SO_REUSEPORT'):
+            socket_.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEPORT, 1)
+        elif IS_WINDOWS:
+            socket_.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
+        else:
+            raise NotImplementedError(
+                'Current platform does not support port reuse',
+            )
+
+    @classmethod
+    def prepare_socket(
+            cls, bind_addr, family, type, proto, nodelay, ssl_adapter,
+            reuse_port=False,
+    ):
         """Create and prepare the socket object."""
         sock = socket.socket(family, type, proto)
         connections.prevent_socket_inheritance(sock)
@@ -1979,6 +2014,9 @@ class HTTPServer:
         host, port = bind_addr[:2]
         IS_EPHEMERAL_PORT = port == 0
 
+        if reuse_port:
+            cls._make_socket_reusable(socket_=sock, bind_addr=bind_addr)
+
         if not (IS_WINDOWS or IS_EPHEMERAL_PORT):
             """Enable SO_REUSEADDR for the current socket.
 
diff --git a/lib/cheroot/server.pyi b/lib/cheroot/server.pyi
index 864adff4..ecbe2f27 100644
--- a/lib/cheroot/server.pyi
+++ b/lib/cheroot/server.pyi
@@ -130,9 +130,10 @@ class HTTPServer:
     ssl_adapter: Any
     peercreds_enabled: bool
     peercreds_resolve_enabled: bool
+    reuse_port: bool
     keep_alive_conn_limit: int
     requests: Any
-    def __init__(self, bind_addr, gateway, minthreads: int = ..., maxthreads: int = ..., server_name: Any | None = ..., peercreds_enabled: bool = ..., peercreds_resolve_enabled: bool = ...) -> None: ...
+    def __init__(self, bind_addr, gateway, minthreads: int = ..., maxthreads: int = ..., server_name: Any | None = ..., peercreds_enabled: bool = ..., peercreds_resolve_enabled: bool = ..., reuse_port: bool = ...) -> None: ...
     stats: Any
     def clear_stats(self): ...
     def runtime(self): ...
@@ -152,7 +153,9 @@ class HTTPServer:
     def bind(self, family, type, proto: int = ...): ...
     def bind_unix_socket(self, bind_addr): ...
     @staticmethod
-    def prepare_socket(bind_addr, family, type, proto, nodelay, ssl_adapter): ...
+    def _make_socket_reusable(socket_, bind_addr) -> None: ...
+    @classmethod
+    def prepare_socket(cls, bind_addr, family, type, proto, nodelay, ssl_adapter, reuse_port: bool = ...): ...
     @staticmethod
     def bind_socket(socket_, bind_addr): ...
     @staticmethod
diff --git a/lib/cheroot/ssl/__init__.pyi b/lib/cheroot/ssl/__init__.pyi
index a9807660..4801fbdd 100644
--- a/lib/cheroot/ssl/__init__.pyi
+++ b/lib/cheroot/ssl/__init__.pyi
@@ -1,7 +1,7 @@
-from abc import abstractmethod
+from abc import abstractmethod, ABCMeta
 from typing import Any
 
-class Adapter():
+class Adapter(metaclass=ABCMeta):
     certificate: Any
     private_key: Any
     certificate_chain: Any
diff --git a/lib/cheroot/test/_pytest_plugin.py b/lib/cheroot/test/_pytest_plugin.py
index 8ff3b02c..61f2efe1 100644
--- a/lib/cheroot/test/_pytest_plugin.py
+++ b/lib/cheroot/test/_pytest_plugin.py
@@ -4,11 +4,7 @@ Contains hooks, which are tightly bound to the Cheroot framework
 itself, useless for end-users' app testing.
 """
 
-from __future__ import absolute_import, division, print_function
-__metaclass__ = type
-
 import pytest
-import six
 
 
 pytest_version = tuple(map(int, pytest.__version__.split('.')))
@@ -45,16 +41,3 @@ def pytest_load_initial_conftests(early_config, parser, args):
         'type=SocketKind.SOCK_STREAM, proto=.:'
         'pytest.PytestUnraisableExceptionWarning:_pytest.unraisableexception',
     ))
-
-    if six.PY2:
-        return
-
-    # NOTE: `ResourceWarning` does not exist under Python 2 and so using
-    # NOTE: it in warning filters results in an `_OptionError` exception
-    # NOTE: being raised.
-    early_config._inicache['filterwarnings'].extend((
-        # FIXME: Try to figure out what causes this and ensure that the socket
-        # FIXME: gets closed.
-        'ignore:unclosed <socket.socket fd=:ResourceWarning',
-        'ignore:unclosed <ssl.SSLSocket fd=:ResourceWarning',
-    ))
diff --git a/lib/cheroot/test/test_conn.py b/lib/cheroot/test/test_conn.py
index 57c21ac7..f2d2cdb2 100644
--- a/lib/cheroot/test/test_conn.py
+++ b/lib/cheroot/test/test_conn.py
@@ -1218,8 +1218,7 @@ def test_No_CRLF(test_client, invalid_terminator):
     # Initialize a persistent HTTP connection
     conn = test_client.get_connection()
 
-    # (b'%s' % b'') is not supported in Python 3.4, so just use bytes.join()
-    conn.send(b''.join((b'GET /hello HTTP/1.1', invalid_terminator)))
+    conn.send(b'GET /hello HTTP/1.1%s' % invalid_terminator)
     response = conn.response_class(conn.sock, method='GET')
     response.begin()
     actual_resp_body = response.read()
diff --git a/lib/cheroot/test/test_core.py b/lib/cheroot/test/test_core.py
index 0203c2f7..7732b6f7 100644
--- a/lib/cheroot/test/test_core.py
+++ b/lib/cheroot/test/test_core.py
@@ -69,11 +69,7 @@ class HelloController(helper.Controller):
 
 
 def _get_http_response(connection, method='GET'):
-    c = connection
-    kwargs = {'strict': c.strict} if hasattr(c, 'strict') else {}
-    # Python 3.2 removed the 'strict' feature, saying:
-    # "http.client now always assumes HTTP/1.x compliant servers."
-    return c.response_class(c.sock, method=method, **kwargs)
+    return connection.response_class(connection.sock, method=method)
 
 
 @pytest.fixture
diff --git a/lib/cheroot/test/test_errors.py b/lib/cheroot/test/test_errors.py
index a3eee67b..a5dd5c2b 100644
--- a/lib/cheroot/test/test_errors.py
+++ b/lib/cheroot/test/test_errors.py
@@ -4,7 +4,7 @@ import pytest
 
 from cheroot import errors
 
-from .._compat import IS_LINUX, IS_MACOS, IS_WINDOWS  # noqa: WPS130
+from .._compat import IS_LINUX, IS_MACOS, IS_SOLARIS, IS_WINDOWS  # noqa: WPS130
 
 
 @pytest.mark.parametrize(
@@ -18,6 +18,7 @@ from .._compat import IS_LINUX, IS_MACOS, IS_WINDOWS  # noqa: WPS130
             ),
             (91, 11, 32) if IS_LINUX else
             (32, 35, 41) if IS_MACOS else
+            (98, 11, 32) if IS_SOLARIS else
             (32, 10041, 11, 10035) if IS_WINDOWS else
             (),
         ),
diff --git a/lib/cheroot/test/test_server.py b/lib/cheroot/test/test_server.py
index 5e0a6832..e2e5f788 100644
--- a/lib/cheroot/test/test_server.py
+++ b/lib/cheroot/test/test_server.py
@@ -5,6 +5,7 @@ import queue
 import socket
 import tempfile
 import threading
+import types
 import uuid
 import urllib.parse  # noqa: WPS301
 
@@ -17,6 +18,7 @@ from pypytools.gc.custom import DefaultGc
 from .._compat import bton, ntob
 from .._compat import IS_LINUX, IS_MACOS, IS_WINDOWS, SYS_PLATFORM
 from ..server import IS_UID_GID_RESOLVABLE, Gateway, HTTPServer
+from ..workers.threadpool import ThreadPool
 from ..testing import (
     ANY_INTERFACE_IPV4,
     ANY_INTERFACE_IPV6,
@@ -254,6 +256,7 @@ def peercreds_enabled_server(http_server, unix_sock_file):
 
 @unix_only_sock_test
 @non_macos_sock_test
+@pytest.mark.flaky(reruns=3, reruns_delay=2)
 def test_peercreds_unix_sock(http_request_timeout, peercreds_enabled_server):
     """Check that ``PEERCRED`` lookup works when enabled."""
     httpserver = peercreds_enabled_server
@@ -370,6 +373,33 @@ def test_high_number_of_file_descriptors(native_server_client, resource_limit):
     assert any(fn >= resource_limit for fn in native_process_conn.filenos)
 
 
+@pytest.mark.skipif(
+    not hasattr(socket, 'SO_REUSEPORT'),
+    reason='socket.SO_REUSEPORT is not supported on this platform',
+)
+@pytest.mark.parametrize(
+    'ip_addr',
+    (
+        ANY_INTERFACE_IPV4,
+        ANY_INTERFACE_IPV6,
+    ),
+)
+def test_reuse_port(http_server, ip_addr, mocker):
+    """Check that port initialized externally can be reused."""
+    family = socket.getaddrinfo(ip_addr, EPHEMERAL_PORT)[0][0]
+    s = socket.socket(family)
+    s.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEPORT, 1)
+    s.bind((ip_addr, EPHEMERAL_PORT))
+    server = HTTPServer(
+        bind_addr=s.getsockname()[:2], gateway=Gateway, reuse_port=True,
+    )
+    spy = mocker.spy(server, 'prepare')
+    server.prepare()
+    server.stop()
+    s.close()
+    assert spy.spy_exception is None
+
+
 ISSUE511 = IS_MACOS
 
 
@@ -439,3 +469,90 @@ def many_open_sockets(request, resource_limit):
         # Close our open resources
         for test_socket in test_sockets:
             test_socket.close()
+
+
+@pytest.mark.parametrize(
+    ('minthreads', 'maxthreads', 'inited_maxthreads'),
+    (
+        (
+            # NOTE: The docstring only mentions -1 to mean "no max", but other
+            # NOTE: negative numbers should also work.
+            1,
+            -2,
+            float('inf'),
+        ),
+        (1, -1, float('inf')),
+        (1, 1, 1),
+        (1, 2, 2),
+        (1, float('inf'), float('inf')),
+        (2, -2, float('inf')),
+        (2, -1, float('inf')),
+        (2, 2, 2),
+        (2, float('inf'), float('inf')),
+    ),
+)
+def test_threadpool_threadrange_set(minthreads, maxthreads, inited_maxthreads):
+    """Test setting the number of threads in a ThreadPool.
+
+    The ThreadPool should properly set the min+max number of the threads to use
+    in the pool if those limits are valid.
+    """
+    tp = ThreadPool(
+        server=None,
+        min=minthreads,
+        max=maxthreads,
+    )
+    assert tp.min == minthreads
+    assert tp.max == inited_maxthreads
+
+
+@pytest.mark.parametrize(
+    ('minthreads', 'maxthreads', 'error'),
+    (
+        (-1, -1, 'min=-1 must be > 0'),
+        (-1, 0, 'min=-1 must be > 0'),
+        (-1, 1, 'min=-1 must be > 0'),
+        (-1, 2, 'min=-1 must be > 0'),
+        (0, -1, 'min=0 must be > 0'),
+        (0, 0, 'min=0 must be > 0'),
+        (0, 1, 'min=0 must be > 0'),
+        (0, 2, 'min=0 must be > 0'),
+        (1, 0, 'Expected an integer or the infinity value for the `max` argument but got 0.'),
+        (1, 0.5, 'Expected an integer or the infinity value for the `max` argument but got 0.5.'),
+        (2, 0, 'Expected an integer or the infinity value for the `max` argument but got 0.'),
+        (2, '1', "Expected an integer or the infinity value for the `max` argument but got '1'."),
+        (2, 1, 'max=1 must be > min=2'),
+    ),
+)
+def test_threadpool_invalid_threadrange(minthreads, maxthreads, error):
+    """Test that a ThreadPool rejects invalid min/max values.
+
+    The ThreadPool should raise an error with the proper message when
+    initialized with an invalid min+max number of threads.
+    """
+    with pytest.raises((ValueError, TypeError), match=error):
+        ThreadPool(
+            server=None,
+            min=minthreads,
+            max=maxthreads,
+        )
+
+
+def test_threadpool_multistart_validation(monkeypatch):
+    """Test for ThreadPool multi-start behavior.
+
+    Tests that when calling start() on a ThreadPool multiple times raises a
+    :exc:`RuntimeError`
+    """
+    # replace _spawn_worker with a function that returns a placeholder to avoid
+    # actually starting any threads
+    monkeypatch.setattr(
+        ThreadPool,
+        '_spawn_worker',
+        lambda _: types.SimpleNamespace(ready=True),
+    )
+
+    tp = ThreadPool(server=None)
+    tp.start()
+    with pytest.raises(RuntimeError, match='Threadpools can only be started once.'):
+        tp.start()
diff --git a/lib/cheroot/test/test_ssl.py b/lib/cheroot/test/test_ssl.py
index c55e156f..1900e20d 100644
--- a/lib/cheroot/test/test_ssl.py
+++ b/lib/cheroot/test/test_ssl.py
@@ -55,17 +55,6 @@ _stdlib_to_openssl_verify = {
 }
 
 
-fails_under_py3 = pytest.mark.xfail(
-    reason='Fails under Python 3+',
-)
-
-
-fails_under_py3_in_pypy = pytest.mark.xfail(
-    IS_PYPY,
-    reason='Fails under PyPy3',
-)
-
-
 missing_ipv6 = pytest.mark.skipif(
     not _probe_ipv6_sock('::1'),
     reason=''
@@ -556,7 +545,6 @@ def test_ssl_env(  # noqa: C901  # FIXME
 
     # builtin ssl environment generation may use a loopback socket
     # ensure no ResourceWarning was raised during the test
-    # NOTE: python 2.7 does not emit ResourceWarning for ssl sockets
     if IS_PYPY:
         # NOTE: PyPy doesn't have ResourceWarning
         # Ref: https://doc.pypy.org/en/latest/cpython_differences.html
diff --git a/lib/cheroot/test/webtest.py b/lib/cheroot/test/webtest.py
index 1630c8ef..eafa2dd6 100644
--- a/lib/cheroot/test/webtest.py
+++ b/lib/cheroot/test/webtest.py
@@ -463,16 +463,13 @@ def shb(response):
     return resp_status_line, response.getheaders(), response.read()
 
 
-# def openURL(*args, raise_subcls=(), **kwargs):
-# py27 compatible signature:
-def openURL(*args, **kwargs):
+def openURL(*args, raise_subcls=(), **kwargs):
     """
     Open a URL, retrying when it fails.
 
     Specify ``raise_subcls`` (class or tuple of classes) to exclude
     those socket.error subclasses from being suppressed and retried.
     """
-    raise_subcls = kwargs.pop('raise_subcls', ())
     opener = functools.partial(_open_url_once, *args, **kwargs)
 
     def on_exception():
diff --git a/lib/cheroot/testing.py b/lib/cheroot/testing.py
index 169142bf..3e404e59 100644
--- a/lib/cheroot/testing.py
+++ b/lib/cheroot/testing.py
@@ -119,9 +119,7 @@ def _probe_ipv6_sock(interface):
     try:
         with closing(socket.socket(family=socket.AF_INET6)) as sock:
             sock.bind((interface, 0))
-    except (OSError, socket.error) as sock_err:
-        # In Python 3 socket.error is an alias for OSError
-        # In Python 2 socket.error is a subclass of IOError
+    except OSError as sock_err:
         if sock_err.errno != errno.EADDRNOTAVAIL:
             raise
     else:
diff --git a/lib/cheroot/workers/threadpool.py b/lib/cheroot/workers/threadpool.py
index 2a9878dc..3437d9bd 100644
--- a/lib/cheroot/workers/threadpool.py
+++ b/lib/cheroot/workers/threadpool.py
@@ -151,12 +151,33 @@ class ThreadPool:
             server (cheroot.server.HTTPServer): web server object
                 receiving this request
             min (int): minimum number of worker threads
-            max (int): maximum number of worker threads
+            max (int): maximum number of worker threads (-1/inf for no max)
             accepted_queue_size (int): maximum number of active
                 requests in queue
             accepted_queue_timeout (int): timeout for putting request
                 into queue
+
+        :raises ValueError: if the min/max values are invalid
+        :raises TypeError: if the max is not an integer or inf
         """
+        if min < 1:
+            raise ValueError(f'min={min!s} must be > 0')
+
+        if max == float('inf'):
+            pass
+        elif not isinstance(max, int) or max == 0:
+            raise TypeError(
+                'Expected an integer or the infinity value for the `max` '
+                f'argument but got {max!r}.',
+            )
+        elif max < 0:
+            max = float('inf')
+
+        if max < min:
+            raise ValueError(
+                f'max={max!s} must be > min={min!s} (or infinity for no max)',
+            )
+
         self.server = server
         self.min = min
         self.max = max
@@ -167,18 +188,13 @@ class ThreadPool:
         self._pending_shutdowns = collections.deque()
 
     def start(self):
-        """Start the pool of threads."""
-        for _ in range(self.min):
-            self._threads.append(WorkerThread(self.server))
-        for worker in self._threads:
-            worker.name = (
-                'CP Server {worker_name!s}'.
-                format(worker_name=worker.name)
-            )
-            worker.start()
-        for worker in self._threads:
-            while not worker.ready:
-                time.sleep(.1)
+        """Start the pool of threads.
+
+        :raises RuntimeError: if the pool is already started
+        """
+        if self._threads:
+            raise RuntimeError('Threadpools can only be started once.')
+        self.grow(self.min)
 
     @property
     def idle(self):  # noqa: D401; irrelevant for properties
@@ -206,17 +222,13 @@ class ThreadPool:
 
     def grow(self, amount):
         """Spawn new worker threads (not above self.max)."""
-        if self.max > 0:
-            budget = max(self.max - len(self._threads), 0)
-        else:
-            # self.max <= 0 indicates no maximum
-            budget = float('inf')
-
+        budget = max(self.max - len(self._threads), 0)
         n_new = min(amount, budget)
 
         workers = [self._spawn_worker() for i in range(n_new)]
-        while not all(worker.ready for worker in workers):
-            time.sleep(.1)
+        for worker in workers:
+            while not worker.ready:
+                time.sleep(.1)
         self._threads.extend(workers)
 
     def _spawn_worker(self):
diff --git a/lib/cheroot/wsgi.py b/lib/cheroot/wsgi.py
index 82faca3e..1dbe10ee 100644
--- a/lib/cheroot/wsgi.py
+++ b/lib/cheroot/wsgi.py
@@ -43,6 +43,7 @@ class Server(server.HTTPServer):
         max=-1, request_queue_size=5, timeout=10, shutdown_timeout=5,
         accepted_queue_size=-1, accepted_queue_timeout=10,
         peercreds_enabled=False, peercreds_resolve_enabled=False,
+        reuse_port=False,
     ):
         """Initialize WSGI Server instance.
 
@@ -69,6 +70,7 @@ class Server(server.HTTPServer):
             server_name=server_name,
             peercreds_enabled=peercreds_enabled,
             peercreds_resolve_enabled=peercreds_resolve_enabled,
+            reuse_port=reuse_port,
         )
         self.wsgi_app = wsgi_app
         self.request_queue_size = request_queue_size
diff --git a/lib/cheroot/wsgi.pyi b/lib/cheroot/wsgi.pyi
index 96075633..f96a18f9 100644
--- a/lib/cheroot/wsgi.pyi
+++ b/lib/cheroot/wsgi.pyi
@@ -8,7 +8,7 @@ class Server(server.HTTPServer):
     timeout: Any
     shutdown_timeout: Any
     requests: Any
-    def __init__(self, bind_addr, wsgi_app, numthreads: int = ..., server_name: Any | None = ..., max: int = ..., request_queue_size: int = ..., timeout: int = ..., shutdown_timeout: int = ..., accepted_queue_size: int = ..., accepted_queue_timeout: int = ..., peercreds_enabled: bool = ..., peercreds_resolve_enabled: bool = ...) -> None: ...
+    def __init__(self, bind_addr, wsgi_app, numthreads: int = ..., server_name: Any | None = ..., max: int = ..., request_queue_size: int = ..., timeout: int = ..., shutdown_timeout: int = ..., accepted_queue_size: int = ..., accepted_queue_timeout: int = ..., peercreds_enabled: bool = ..., peercreds_resolve_enabled: bool = ..., reuse_port: bool = ...) -> None: ...
     @property
     def numthreads(self): ...
     @numthreads.setter
diff --git a/requirements.txt b/requirements.txt
index e8dbb20d..5abbaaa8 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -7,7 +7,7 @@ backports.zoneinfo==0.2.1;python_version<"3.9"
 beautifulsoup4==4.12.2
 bleach==6.0.0
 certifi==2023.7.22
-cheroot==9.0.0
+cheroot==10.0.0
 cherrypy==18.8.0
 cloudinary==1.34.0
 distro==1.8.0

From 371d35433c38c92177ca09beb0ab7dd9d02842cb Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 24 Aug 2023 12:09:28 -0700
Subject: [PATCH 443/743] Bump tokenize-rt from 5.0.0 to 5.2.0 (#2129)

* Bump tokenize-rt from 5.0.0 to 5.2.0

Bumps [tokenize-rt](https://github.com/asottile/tokenize-rt) from 5.0.0 to 5.2.0.
- [Commits](https://github.com/asottile/tokenize-rt/compare/v5.0.0...v5.2.0)

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

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

* Update tokenize-rt==5.2.0

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/tokenize_rt.py | 5 ++++-
 requirements.txt   | 2 +-
 2 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/lib/tokenize_rt.py b/lib/tokenize_rt.py
index f0922c16..ae91cc40 100644
--- a/lib/tokenize_rt.py
+++ b/lib/tokenize_rt.py
@@ -18,7 +18,7 @@ if (  # pragma: no branch
         callable(getattr(tokenize, '_compile', None))
 ):  # pragma: <3.10 cover
     from functools import lru_cache
-    tokenize._compile = lru_cache()(tokenize._compile)
+    tokenize._compile = lru_cache(tokenize._compile)
 
 ESCAPED_NL = 'ESCAPED_NL'
 UNIMPORTANT_WS = 'UNIMPORTANT_WS'
@@ -40,6 +40,9 @@ class Token(NamedTuple):
     def offset(self) -> Offset:
         return Offset(self.line, self.utf8_byte_offset)
 
+    def matches(self, *, name: str, src: str) -> bool:
+        return self.name == name and self.src == src
+
 
 _string_re = re.compile('^([^\'"]*)(.*)$', re.DOTALL)
 _escaped_nl_re = re.compile(r'\\(\n|\r\n|\r)')
diff --git a/requirements.txt b/requirements.txt
index 5abbaaa8..8fd57e4d 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -42,7 +42,7 @@ rumps==0.4.0; platform_system == "Darwin"
 simplejson==3.19.1
 six==1.16.0
 tempora==5.5.0
-tokenize-rt==5.0.0
+tokenize-rt==5.2.0
 tzdata==2023.3
 tzlocal==4.2
 urllib3<2

From d0c7f25a3f9361efcef3ecaeb70b340d897ddcac Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 24 Aug 2023 12:09:39 -0700
Subject: [PATCH 444/743] Bump markupsafe from 2.1.2 to 2.1.3 (#2130)

* Bump markupsafe from 2.1.2 to 2.1.3

Bumps [markupsafe](https://github.com/pallets/markupsafe) from 2.1.2 to 2.1.3.
- [Release notes](https://github.com/pallets/markupsafe/releases)
- [Changelog](https://github.com/pallets/markupsafe/blob/main/CHANGES.rst)
- [Commits](https://github.com/pallets/markupsafe/compare/2.1.2...2.1.3)

---
updated-dependencies:
- dependency-name: markupsafe
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

* Update markupsave==2.1.3

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/markupsafe/__init__.py | 109 ++++++++++++++++++++-----------------
 requirements.txt           |   2 +-
 2 files changed, 60 insertions(+), 51 deletions(-)

diff --git a/lib/markupsafe/__init__.py b/lib/markupsafe/__init__.py
index 7166b192..21d31960 100644
--- a/lib/markupsafe/__init__.py
+++ b/lib/markupsafe/__init__.py
@@ -1,6 +1,7 @@
 import functools
 import re
 import string
+import sys
 import typing as t
 
 if t.TYPE_CHECKING:
@@ -10,23 +11,23 @@ if t.TYPE_CHECKING:
         def __html__(self) -> str:
             pass
 
+    _P = te.ParamSpec("_P")
 
-__version__ = "2.1.2"
+
+__version__ = "2.1.3"
 
 _strip_comments_re = re.compile(r"<!--.*?-->", re.DOTALL)
 _strip_tags_re = re.compile(r"<.*?>", re.DOTALL)
 
 
-def _simple_escaping_wrapper(name: str) -> t.Callable[..., "Markup"]:
-    orig = getattr(str, name)
-
-    @functools.wraps(orig)
-    def wrapped(self: "Markup", *args: t.Any, **kwargs: t.Any) -> "Markup":
-        args = _escape_argspec(list(args), enumerate(args), self.escape)  # type: ignore
+def _simple_escaping_wrapper(func: "t.Callable[_P, str]") -> "t.Callable[_P, Markup]":
+    @functools.wraps(func)
+    def wrapped(self: "Markup", *args: "_P.args", **kwargs: "_P.kwargs") -> "Markup":
+        arg_list = _escape_argspec(list(args), enumerate(args), self.escape)
         _escape_argspec(kwargs, kwargs.items(), self.escape)
-        return self.__class__(orig(self, *args, **kwargs))
+        return self.__class__(func(self, *arg_list, **kwargs))  # type: ignore[arg-type]
 
-    return wrapped
+    return wrapped  # type: ignore[return-value]
 
 
 class Markup(str):
@@ -69,7 +70,7 @@ class Markup(str):
 
     def __new__(
         cls, base: t.Any = "", encoding: t.Optional[str] = None, errors: str = "strict"
-    ) -> "Markup":
+    ) -> "te.Self":
         if hasattr(base, "__html__"):
             base = base.__html__()
 
@@ -78,22 +79,22 @@ class Markup(str):
 
         return super().__new__(cls, base, encoding, errors)
 
-    def __html__(self) -> "Markup":
+    def __html__(self) -> "te.Self":
         return self
 
-    def __add__(self, other: t.Union[str, "HasHTML"]) -> "Markup":
+    def __add__(self, other: t.Union[str, "HasHTML"]) -> "te.Self":
         if isinstance(other, str) or hasattr(other, "__html__"):
             return self.__class__(super().__add__(self.escape(other)))
 
         return NotImplemented
 
-    def __radd__(self, other: t.Union[str, "HasHTML"]) -> "Markup":
+    def __radd__(self, other: t.Union[str, "HasHTML"]) -> "te.Self":
         if isinstance(other, str) or hasattr(other, "__html__"):
             return self.escape(other).__add__(self)
 
         return NotImplemented
 
-    def __mul__(self, num: "te.SupportsIndex") -> "Markup":
+    def __mul__(self, num: "te.SupportsIndex") -> "te.Self":
         if isinstance(num, int):
             return self.__class__(super().__mul__(num))
 
@@ -101,7 +102,7 @@ class Markup(str):
 
     __rmul__ = __mul__
 
-    def __mod__(self, arg: t.Any) -> "Markup":
+    def __mod__(self, arg: t.Any) -> "te.Self":
         if isinstance(arg, tuple):
             # a tuple of arguments, each wrapped
             arg = tuple(_MarkupEscapeHelper(x, self.escape) for x in arg)
@@ -117,26 +118,28 @@ class Markup(str):
     def __repr__(self) -> str:
         return f"{self.__class__.__name__}({super().__repr__()})"
 
-    def join(self, seq: t.Iterable[t.Union[str, "HasHTML"]]) -> "Markup":
+    def join(self, seq: t.Iterable[t.Union[str, "HasHTML"]]) -> "te.Self":
         return self.__class__(super().join(map(self.escape, seq)))
 
     join.__doc__ = str.join.__doc__
 
-    def split(  # type: ignore
+    def split(  # type: ignore[override]
         self, sep: t.Optional[str] = None, maxsplit: int = -1
-    ) -> t.List["Markup"]:
+    ) -> t.List["te.Self"]:
         return [self.__class__(v) for v in super().split(sep, maxsplit)]
 
     split.__doc__ = str.split.__doc__
 
-    def rsplit(  # type: ignore
+    def rsplit(  # type: ignore[override]
         self, sep: t.Optional[str] = None, maxsplit: int = -1
-    ) -> t.List["Markup"]:
+    ) -> t.List["te.Self"]:
         return [self.__class__(v) for v in super().rsplit(sep, maxsplit)]
 
     rsplit.__doc__ = str.rsplit.__doc__
 
-    def splitlines(self, keepends: bool = False) -> t.List["Markup"]:  # type: ignore
+    def splitlines(  # type: ignore[override]
+        self, keepends: bool = False
+    ) -> t.List["te.Self"]:
         return [self.__class__(v) for v in super().splitlines(keepends)]
 
     splitlines.__doc__ = str.splitlines.__doc__
@@ -163,10 +166,10 @@ class Markup(str):
         value = _strip_comments_re.sub("", self)
         value = _strip_tags_re.sub("", value)
         value = " ".join(value.split())
-        return Markup(value).unescape()
+        return self.__class__(value).unescape()
 
     @classmethod
-    def escape(cls, s: t.Any) -> "Markup":
+    def escape(cls, s: t.Any) -> "te.Self":
         """Escape a string. Calls :func:`escape` and ensures that for
         subclasses the correct type is returned.
         """
@@ -175,45 +178,51 @@ class Markup(str):
         if rv.__class__ is not cls:
             return cls(rv)
 
-        return rv
+        return rv  # type: ignore[return-value]
 
-    for method in (
-        "__getitem__",
-        "capitalize",
-        "title",
-        "lower",
-        "upper",
-        "replace",
-        "ljust",
-        "rjust",
-        "lstrip",
-        "rstrip",
-        "center",
-        "strip",
-        "translate",
-        "expandtabs",
-        "swapcase",
-        "zfill",
-    ):
-        locals()[method] = _simple_escaping_wrapper(method)
+    __getitem__ = _simple_escaping_wrapper(str.__getitem__)
+    capitalize = _simple_escaping_wrapper(str.capitalize)
+    title = _simple_escaping_wrapper(str.title)
+    lower = _simple_escaping_wrapper(str.lower)
+    upper = _simple_escaping_wrapper(str.upper)
+    replace = _simple_escaping_wrapper(str.replace)
+    ljust = _simple_escaping_wrapper(str.ljust)
+    rjust = _simple_escaping_wrapper(str.rjust)
+    lstrip = _simple_escaping_wrapper(str.lstrip)
+    rstrip = _simple_escaping_wrapper(str.rstrip)
+    center = _simple_escaping_wrapper(str.center)
+    strip = _simple_escaping_wrapper(str.strip)
+    translate = _simple_escaping_wrapper(str.translate)
+    expandtabs = _simple_escaping_wrapper(str.expandtabs)
+    swapcase = _simple_escaping_wrapper(str.swapcase)
+    zfill = _simple_escaping_wrapper(str.zfill)
+    casefold = _simple_escaping_wrapper(str.casefold)
 
-    del method
+    if sys.version_info >= (3, 9):
+        removeprefix = _simple_escaping_wrapper(str.removeprefix)
+        removesuffix = _simple_escaping_wrapper(str.removesuffix)
 
-    def partition(self, sep: str) -> t.Tuple["Markup", "Markup", "Markup"]:
+    def partition(self, sep: str) -> t.Tuple["te.Self", "te.Self", "te.Self"]:
         l, s, r = super().partition(self.escape(sep))
         cls = self.__class__
         return cls(l), cls(s), cls(r)
 
-    def rpartition(self, sep: str) -> t.Tuple["Markup", "Markup", "Markup"]:
+    def rpartition(self, sep: str) -> t.Tuple["te.Self", "te.Self", "te.Self"]:
         l, s, r = super().rpartition(self.escape(sep))
         cls = self.__class__
         return cls(l), cls(s), cls(r)
 
-    def format(self, *args: t.Any, **kwargs: t.Any) -> "Markup":
+    def format(self, *args: t.Any, **kwargs: t.Any) -> "te.Self":
         formatter = EscapeFormatter(self.escape)
         return self.__class__(formatter.vformat(self, args, kwargs))
 
-    def __html_format__(self, format_spec: str) -> "Markup":
+    def format_map(  # type: ignore[override]
+        self, map: t.Mapping[str, t.Any]
+    ) -> "te.Self":
+        formatter = EscapeFormatter(self.escape)
+        return self.__class__(formatter.vformat(self, (), map))
+
+    def __html_format__(self, format_spec: str) -> "te.Self":
         if format_spec:
             raise ValueError("Unsupported format specification for Markup.")
 
@@ -268,8 +277,8 @@ class _MarkupEscapeHelper:
         self.obj = obj
         self.escape = escape
 
-    def __getitem__(self, item: t.Any) -> "_MarkupEscapeHelper":
-        return _MarkupEscapeHelper(self.obj[item], self.escape)
+    def __getitem__(self, item: t.Any) -> "te.Self":
+        return self.__class__(self.obj[item], self.escape)
 
     def __str__(self) -> str:
         return str(self.escape(self.obj))
diff --git a/requirements.txt b/requirements.txt
index 8fd57e4d..dc879875 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -24,7 +24,7 @@ importlib-resources==6.0.1
 git+https://github.com/Tautulli/ipwhois.git@master#egg=ipwhois
 IPy==1.01
 Mako==1.2.4
-MarkupSafe==2.1.2
+MarkupSafe==2.1.3
 musicbrainzngs==0.7.1
 packaging==23.1
 paho-mqtt==1.6.1

From 3debeada2a040b3a1be5749c2df39d603f97e931 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 24 Aug 2023 12:09:51 -0700
Subject: [PATCH 445/743] Bump pyparsing from 3.0.9 to 3.1.1 (#2131)

* Bump pyparsing from 3.0.9 to 3.1.1

Bumps [pyparsing](https://github.com/pyparsing/pyparsing) from 3.0.9 to 3.1.1.
- [Release notes](https://github.com/pyparsing/pyparsing/releases)
- [Changelog](https://github.com/pyparsing/pyparsing/blob/master/CHANGES)
- [Commits](https://github.com/pyparsing/pyparsing/compare/pyparsing_3.0.9...3.1.1)

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

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

* Update pyparsing==3.1.1

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/pyparsing/__init__.py         |   78 +-
 lib/pyparsing/actions.py          |   34 +-
 lib/pyparsing/common.py           |   58 +-
 lib/pyparsing/core.py             | 1295 ++++++++++++++++++-----------
 lib/pyparsing/diagram/__init__.py |   32 +-
 lib/pyparsing/exceptions.py       |   64 +-
 lib/pyparsing/helpers.py          |  196 +++--
 lib/pyparsing/results.py          |  128 ++-
 lib/pyparsing/testing.py          |   24 +-
 lib/pyparsing/unicode.py          |  103 +--
 lib/pyparsing/util.py             |   89 +-
 requirements.txt                  |    2 +-
 12 files changed, 1306 insertions(+), 797 deletions(-)

diff --git a/lib/pyparsing/__init__.py b/lib/pyparsing/__init__.py
index 7802ff15..3dbc3cf8 100644
--- a/lib/pyparsing/__init__.py
+++ b/lib/pyparsing/__init__.py
@@ -56,7 +56,7 @@ self-explanatory class names, and the use of :class:`'+'<And>`,
 :class:`'|'<MatchFirst>`, :class:`'^'<Or>` and :class:`'&'<Each>` operators.
 
 The :class:`ParseResults` object returned from
-:class:`ParserElement.parseString` can be
+:class:`ParserElement.parse_string` can be
 accessed as a nested list, a dictionary, or an object with named
 attributes.
 
@@ -85,11 +85,11 @@ classes inherit from. Use the docstrings for examples of how to:
    and :class:`'&'<Each>` operators to combine simple expressions into
    more complex ones
  - associate names with your parsed results using
-   :class:`ParserElement.setResultsName`
+   :class:`ParserElement.set_results_name`
  - access the parsed data, which is returned as a :class:`ParseResults`
    object
- - find some helpful expression short-cuts like :class:`delimitedList`
-   and :class:`oneOf`
+ - find some helpful expression short-cuts like :class:`DelimitedList`
+   and :class:`one_of`
  - find more useful common expressions in the :class:`pyparsing_common`
    namespace class
 """
@@ -106,30 +106,22 @@ class version_info(NamedTuple):
     @property
     def __version__(self):
         return (
-            "{}.{}.{}".format(self.major, self.minor, self.micro)
+            f"{self.major}.{self.minor}.{self.micro}"
             + (
-                "{}{}{}".format(
-                    "r" if self.releaselevel[0] == "c" else "",
-                    self.releaselevel[0],
-                    self.serial,
-                ),
+                f"{'r' if self.releaselevel[0] == 'c' else ''}{self.releaselevel[0]}{self.serial}",
                 "",
             )[self.releaselevel == "final"]
         )
 
     def __str__(self):
-        return "{} {} / {}".format(__name__, self.__version__, __version_time__)
+        return f"{__name__} {self.__version__} / {__version_time__}"
 
     def __repr__(self):
-        return "{}.{}({})".format(
-            __name__,
-            type(self).__name__,
-            ", ".join("{}={!r}".format(*nv) for nv in zip(self._fields, self)),
-        )
+        return f"{__name__}.{type(self).__name__}({', '.join('{}={!r}'.format(*nv) for nv in zip(self._fields, self))})"
 
 
-__version_info__ = version_info(3, 0, 9, "final", 0)
-__version_time__ = "05 May 2022 07:02 UTC"
+__version_info__ = version_info(3, 1, 1, "final", 1)
+__version_time__ = "29 Jul 2023 22:27 UTC"
 __version__ = __version_info__.__version__
 __versionTime__ = __version_time__
 __author__ = "Paul McGuire <ptmcg.gm+pyparsing@gmail.com>"
@@ -139,9 +131,9 @@ from .exceptions import *
 from .actions import *
 from .core import __diag__, __compat__
 from .results import *
-from .core import *
+from .core import *  # type: ignore[misc, assignment]
 from .core import _builtin_exprs as core_builtin_exprs
-from .helpers import *
+from .helpers import *  # type: ignore[misc, assignment]
 from .helpers import _builtin_exprs as helper_builtin_exprs
 
 from .unicode import unicode_set, UnicodeRangeList, pyparsing_unicode as unicode
@@ -153,11 +145,11 @@ from .common import (
 
 # define backward compat synonyms
 if "pyparsing_unicode" not in globals():
-    pyparsing_unicode = unicode
+    pyparsing_unicode = unicode  # type: ignore[misc]
 if "pyparsing_common" not in globals():
-    pyparsing_common = common
+    pyparsing_common = common  # type: ignore[misc]
 if "pyparsing_test" not in globals():
-    pyparsing_test = testing
+    pyparsing_test = testing  # type: ignore[misc]
 
 core_builtin_exprs += common_builtin_exprs + helper_builtin_exprs
 
@@ -174,7 +166,9 @@ __all__ = [
     "CaselessKeyword",
     "CaselessLiteral",
     "CharsNotIn",
+    "CloseMatch",
     "Combine",
+    "DelimitedList",
     "Dict",
     "Each",
     "Empty",
@@ -227,9 +221,11 @@ __all__ = [
     "alphas8bit",
     "any_close_tag",
     "any_open_tag",
+    "autoname_elements",
     "c_style_comment",
     "col",
     "common_html_entity",
+    "condition_as_parse_action",
     "counted_array",
     "cpp_style_comment",
     "dbl_quoted_string",
@@ -241,6 +237,7 @@ __all__ = [
     "html_comment",
     "identchars",
     "identbodychars",
+    "infix_notation",
     "java_style_comment",
     "line",
     "line_end",
@@ -255,8 +252,12 @@ __all__ = [
     "null_debug_action",
     "nums",
     "one_of",
+    "original_text_for",
     "printables",
     "punc8bit",
+    "pyparsing_common",
+    "pyparsing_test",
+    "pyparsing_unicode",
     "python_style_comment",
     "quoted_string",
     "remove_quotes",
@@ -267,28 +268,20 @@ __all__ = [
     "srange",
     "string_end",
     "string_start",
+    "token_map",
     "trace_parse_action",
+    "ungroup",
+    "unicode_set",
     "unicode_string",
     "with_attribute",
-    "indentedBlock",
-    "original_text_for",
-    "ungroup",
-    "infix_notation",
-    "locatedExpr",
     "with_class",
-    "CloseMatch",
-    "token_map",
-    "pyparsing_common",
-    "pyparsing_unicode",
-    "unicode_set",
-    "condition_as_parse_action",
-    "pyparsing_test",
     # pre-PEP8 compatibility names
     "__versionTime__",
     "anyCloseTag",
     "anyOpenTag",
     "cStyleComment",
     "commonHTMLEntity",
+    "conditionAsParseAction",
     "countedArray",
     "cppStyleComment",
     "dblQuotedString",
@@ -296,9 +289,12 @@ __all__ = [
     "delimitedList",
     "dictOf",
     "htmlComment",
+    "indentedBlock",
+    "infixNotation",
     "javaStyleComment",
     "lineEnd",
     "lineStart",
+    "locatedExpr",
     "makeHTMLTags",
     "makeXMLTags",
     "matchOnlyAtCol",
@@ -308,6 +304,7 @@ __all__ = [
     "nullDebugAction",
     "oneOf",
     "opAssoc",
+    "originalTextFor",
     "pythonStyleComment",
     "quotedString",
     "removeQuotes",
@@ -317,15 +314,12 @@ __all__ = [
     "sglQuotedString",
     "stringEnd",
     "stringStart",
+    "tokenMap",
     "traceParseAction",
     "unicodeString",
     "withAttribute",
-    "indentedBlock",
-    "originalTextFor",
-    "infixNotation",
-    "locatedExpr",
     "withClass",
-    "tokenMap",
-    "conditionAsParseAction",
-    "autoname_elements",
+    "common",
+    "unicode",
+    "testing",
 ]
diff --git a/lib/pyparsing/actions.py b/lib/pyparsing/actions.py
index f72c66e7..ca6e4c6a 100644
--- a/lib/pyparsing/actions.py
+++ b/lib/pyparsing/actions.py
@@ -1,7 +1,7 @@
 # actions.py
 
 from .exceptions import ParseException
-from .util import col
+from .util import col, replaced_by_pep8
 
 
 class OnlyOnce:
@@ -38,7 +38,7 @@ def match_only_at_col(n):
 
     def verify_col(strg, locn, toks):
         if col(locn, strg) != n:
-            raise ParseException(strg, locn, "matched token not at column {}".format(n))
+            raise ParseException(strg, locn, f"matched token not at column {n}")
 
     return verify_col
 
@@ -148,15 +148,13 @@ def with_attribute(*args, **attr_dict):
                 raise ParseException(
                     s,
                     l,
-                    "attribute {!r} has value {!r}, must be {!r}".format(
-                        attrName, tokens[attrName], attrValue
-                    ),
+                    f"attribute {attrName!r} has value {tokens[attrName]!r}, must be {attrValue!r}",
                 )
 
     return pa
 
 
-with_attribute.ANY_VALUE = object()
+with_attribute.ANY_VALUE = object()  # type: ignore [attr-defined]
 
 
 def with_class(classname, namespace=""):
@@ -195,13 +193,25 @@ def with_class(classname, namespace=""):
         1 4 0 1 0
         1,3 2,3 1,1
     """
-    classattr = "{}:class".format(namespace) if namespace else "class"
+    classattr = f"{namespace}:class" if namespace else "class"
     return with_attribute(**{classattr: classname})
 
 
 # pre-PEP8 compatibility symbols
-replaceWith = replace_with
-removeQuotes = remove_quotes
-withAttribute = with_attribute
-withClass = with_class
-matchOnlyAtCol = match_only_at_col
+# fmt: off
+@replaced_by_pep8(replace_with)
+def replaceWith(): ...
+
+@replaced_by_pep8(remove_quotes)
+def removeQuotes(): ...
+
+@replaced_by_pep8(with_attribute)
+def withAttribute(): ...
+
+@replaced_by_pep8(with_class)
+def withClass(): ...
+
+@replaced_by_pep8(match_only_at_col)
+def matchOnlyAtCol(): ...
+
+# fmt: on
diff --git a/lib/pyparsing/common.py b/lib/pyparsing/common.py
index 1859fb79..7a666b27 100644
--- a/lib/pyparsing/common.py
+++ b/lib/pyparsing/common.py
@@ -1,6 +1,6 @@
 # common.py
 from .core import *
-from .helpers import delimited_list, any_open_tag, any_close_tag
+from .helpers import DelimitedList, any_open_tag, any_close_tag
 from datetime import datetime
 
 
@@ -22,17 +22,17 @@ class pyparsing_common:
 
     Parse actions:
 
-    - :class:`convertToInteger`
-    - :class:`convertToFloat`
-    - :class:`convertToDate`
-    - :class:`convertToDatetime`
-    - :class:`stripHTMLTags`
-    - :class:`upcaseTokens`
-    - :class:`downcaseTokens`
+    - :class:`convert_to_integer`
+    - :class:`convert_to_float`
+    - :class:`convert_to_date`
+    - :class:`convert_to_datetime`
+    - :class:`strip_html_tags`
+    - :class:`upcase_tokens`
+    - :class:`downcase_tokens`
 
     Example::
 
-        pyparsing_common.number.runTests('''
+        pyparsing_common.number.run_tests('''
             # any int or real number, returned as the appropriate type
             100
             -100
@@ -42,7 +42,7 @@ class pyparsing_common:
             1e-12
             ''')
 
-        pyparsing_common.fnumber.runTests('''
+        pyparsing_common.fnumber.run_tests('''
             # any int or real number, returned as float
             100
             -100
@@ -52,19 +52,19 @@ class pyparsing_common:
             1e-12
             ''')
 
-        pyparsing_common.hex_integer.runTests('''
+        pyparsing_common.hex_integer.run_tests('''
             # hex numbers
             100
             FF
             ''')
 
-        pyparsing_common.fraction.runTests('''
+        pyparsing_common.fraction.run_tests('''
             # fractions
             1/2
             -3/4
             ''')
 
-        pyparsing_common.mixed_integer.runTests('''
+        pyparsing_common.mixed_integer.run_tests('''
             # mixed fractions
             1
             1/2
@@ -73,8 +73,8 @@ class pyparsing_common:
             ''')
 
         import uuid
-        pyparsing_common.uuid.setParseAction(tokenMap(uuid.UUID))
-        pyparsing_common.uuid.runTests('''
+        pyparsing_common.uuid.set_parse_action(token_map(uuid.UUID))
+        pyparsing_common.uuid.run_tests('''
             # uuid
             12345678-1234-5678-1234-567812345678
             ''')
@@ -260,8 +260,8 @@ class pyparsing_common:
         Example::
 
             date_expr = pyparsing_common.iso8601_date.copy()
-            date_expr.setParseAction(pyparsing_common.convertToDate())
-            print(date_expr.parseString("1999-12-31"))
+            date_expr.set_parse_action(pyparsing_common.convert_to_date())
+            print(date_expr.parse_string("1999-12-31"))
 
         prints::
 
@@ -287,8 +287,8 @@ class pyparsing_common:
         Example::
 
             dt_expr = pyparsing_common.iso8601_datetime.copy()
-            dt_expr.setParseAction(pyparsing_common.convertToDatetime())
-            print(dt_expr.parseString("1999-12-31T23:59:59.999"))
+            dt_expr.set_parse_action(pyparsing_common.convert_to_datetime())
+            print(dt_expr.parse_string("1999-12-31T23:59:59.999"))
 
         prints::
 
@@ -326,9 +326,9 @@ class pyparsing_common:
 
             # strip HTML links from normal text
             text = '<td>More info at the <a href="https://github.com/pyparsing/pyparsing/wiki">pyparsing</a> wiki page</td>'
-            td, td_end = makeHTMLTags("TD")
-            table_text = td + SkipTo(td_end).setParseAction(pyparsing_common.stripHTMLTags)("body") + td_end
-            print(table_text.parseString(text).body)
+            td, td_end = make_html_tags("TD")
+            table_text = td + SkipTo(td_end).set_parse_action(pyparsing_common.strip_html_tags)("body") + td_end
+            print(table_text.parse_string(text).body)
 
         Prints::
 
@@ -348,7 +348,7 @@ class pyparsing_common:
         .streamline()
         .set_name("commaItem")
     )
-    comma_separated_list = delimited_list(
+    comma_separated_list = DelimitedList(
         Opt(quoted_string.copy() | _commasepitem, default="")
     ).set_name("comma separated list")
     """Predefined expression of 1 or more printable words or quoted strings, separated by commas."""
@@ -363,7 +363,7 @@ class pyparsing_common:
     url = Regex(
         # https://mathiasbynens.be/demo/url-regex
         # https://gist.github.com/dperini/729294
-        r"^" +
+        r"(?P<url>" +
         # protocol identifier (optional)
         # short syntax // still required
         r"(?:(?:(?P<scheme>https?|ftp):)?\/\/)" +
@@ -405,18 +405,26 @@ class pyparsing_common:
         r"(\?(?P<query>[^#]*))?" +
         # fragment (optional)
         r"(#(?P<fragment>\S*))?" +
-        r"$"
+        r")"
     ).set_name("url")
+    """URL (http/https/ftp scheme)"""
     # fmt: on
 
     # pre-PEP8 compatibility names
     convertToInteger = convert_to_integer
+    """Deprecated - use :class:`convert_to_integer`"""
     convertToFloat = convert_to_float
+    """Deprecated - use :class:`convert_to_float`"""
     convertToDate = convert_to_date
+    """Deprecated - use :class:`convert_to_date`"""
     convertToDatetime = convert_to_datetime
+    """Deprecated - use :class:`convert_to_datetime`"""
     stripHTMLTags = strip_html_tags
+    """Deprecated - use :class:`strip_html_tags`"""
     upcaseTokens = upcase_tokens
+    """Deprecated - use :class:`upcase_tokens`"""
     downcaseTokens = downcase_tokens
+    """Deprecated - use :class:`downcase_tokens`"""
 
 
 _builtin_exprs = [
diff --git a/lib/pyparsing/core.py b/lib/pyparsing/core.py
index 9acba3f3..73514ed0 100644
--- a/lib/pyparsing/core.py
+++ b/lib/pyparsing/core.py
@@ -1,19 +1,22 @@
 #
 # core.py
 #
+
+from collections import deque
 import os
 import typing
 from typing import (
-    NamedTuple,
-    Union,
-    Callable,
     Any,
+    Callable,
     Generator,
-    Tuple,
     List,
-    TextIO,
-    Set,
+    NamedTuple,
     Sequence,
+    Set,
+    TextIO,
+    Tuple,
+    Union,
+    cast,
 )
 from abc import ABC, abstractmethod
 from enum import Enum
@@ -40,6 +43,7 @@ from .util import (
     _flatten,
     LRUMemo as _LRUMemo,
     UnboundedMemo as _UnboundedMemo,
+    replaced_by_pep8,
 )
 from .exceptions import *
 from .actions import *
@@ -134,6 +138,7 @@ class __diag__(__config_flags):
 class Diagnostics(Enum):
     """
     Diagnostic configuration (all default to disabled)
+
     - ``warn_multiple_tokens_in_named_alternation`` - flag to enable warnings when a results
       name is defined on a :class:`MatchFirst` or :class:`Or` expression with one or more :class:`And` subexpressions
     - ``warn_ungrouped_named_tokens_in_collection`` - flag to enable warnings when a results
@@ -228,6 +233,8 @@ _single_arg_builtins = {
 }
 
 _generatorType = types.GeneratorType
+ParseImplReturnType = Tuple[int, Any]
+PostParseReturnType = Union[ParseResults, Sequence[ParseResults]]
 ParseAction = Union[
     Callable[[], Any],
     Callable[[ParseResults], Any],
@@ -256,7 +263,7 @@ hexnums = nums + "ABCDEFabcdef"
 alphanums = alphas + nums
 printables = "".join([c for c in string.printable if c not in string.whitespace])
 
-_trim_arity_call_line: traceback.StackSummary = None
+_trim_arity_call_line: traceback.StackSummary = None  # type: ignore[assignment]
 
 
 def _trim_arity(func, max_limit=3):
@@ -269,11 +276,6 @@ def _trim_arity(func, max_limit=3):
     limit = 0
     found_arity = False
 
-    def extract_tb(tb, limit=0):
-        frames = traceback.extract_tb(tb, limit=limit)
-        frame_summary = frames[-1]
-        return [frame_summary[:2]]
-
     # synthesize what would be returned by traceback.extract_stack at the call to
     # user's parse action 'func', so that we don't incur call penalty at parse time
 
@@ -297,8 +299,10 @@ def _trim_arity(func, max_limit=3):
                     raise
                 else:
                     tb = te.__traceback__
+                    frames = traceback.extract_tb(tb, limit=2)
+                    frame_summary = frames[-1]
                     trim_arity_type_error = (
-                        extract_tb(tb, limit=2)[-1][:2] == pa_call_line_synth
+                        [frame_summary[:2]][-1][:2] == pa_call_line_synth
                     )
                     del tb
 
@@ -320,7 +324,7 @@ def _trim_arity(func, max_limit=3):
 
 
 def condition_as_parse_action(
-    fn: ParseCondition, message: str = None, fatal: bool = False
+    fn: ParseCondition, message: typing.Optional[str] = None, fatal: bool = False
 ) -> ParseAction:
     """
     Function to convert a simple predicate function that returns ``True`` or ``False``
@@ -353,15 +357,9 @@ def _default_start_debug_action(
     cache_hit_str = "*" if cache_hit else ""
     print(
         (
-            "{}Match {} at loc {}({},{})\n  {}\n  {}^".format(
-                cache_hit_str,
-                expr,
-                loc,
-                lineno(loc, instring),
-                col(loc, instring),
-                line(loc, instring),
-                " " * (col(loc, instring) - 1),
-            )
+            f"{cache_hit_str}Match {expr} at loc {loc}({lineno(loc, instring)},{col(loc, instring)})\n"
+            f"  {line(loc, instring)}\n"
+            f"  {' ' * (col(loc, instring) - 1)}^"
         )
     )
 
@@ -375,7 +373,7 @@ def _default_success_debug_action(
     cache_hit: bool = False,
 ):
     cache_hit_str = "*" if cache_hit else ""
-    print("{}Matched {} -> {}".format(cache_hit_str, expr, toks.as_list()))
+    print(f"{cache_hit_str}Matched {expr} -> {toks.as_list()}")
 
 
 def _default_exception_debug_action(
@@ -386,11 +384,7 @@ def _default_exception_debug_action(
     cache_hit: bool = False,
 ):
     cache_hit_str = "*" if cache_hit else ""
-    print(
-        "{}Match {} failed, {} raised: {}".format(
-            cache_hit_str, expr, type(exc).__name__, exc
-        )
-    )
+    print(f"{cache_hit_str}Match {expr} failed, {type(exc).__name__} raised: {exc}")
 
 
 def null_debug_action(*args):
@@ -402,7 +396,7 @@ class ParserElement(ABC):
 
     DEFAULT_WHITE_CHARS: str = " \n\t\r"
     verbose_stacktrace: bool = False
-    _literalStringClass: typing.Optional[type] = None
+    _literalStringClass: type = None  # type: ignore[assignment]
 
     @staticmethod
     def set_default_whitespace_chars(chars: str) -> None:
@@ -447,6 +441,18 @@ class ParserElement(ABC):
         """
         ParserElement._literalStringClass = cls
 
+    @classmethod
+    def using_each(cls, seq, **class_kwargs):
+        """
+        Yields a sequence of class(obj, **class_kwargs) for obj in seq.
+
+        Example::
+
+            LPAR, RPAR, LBRACE, RBRACE, SEMI = Suppress.using_each("(){};")
+
+        """
+        yield from (cls(obj, **class_kwargs) for obj in seq)
+
     class DebugActions(NamedTuple):
         debug_try: typing.Optional[DebugStartAction]
         debug_match: typing.Optional[DebugSuccessAction]
@@ -455,9 +461,9 @@ class ParserElement(ABC):
     def __init__(self, savelist: bool = False):
         self.parseAction: List[ParseAction] = list()
         self.failAction: typing.Optional[ParseFailAction] = None
-        self.customName = None
-        self._defaultName = None
-        self.resultsName = None
+        self.customName: str = None  # type: ignore[assignment]
+        self._defaultName: typing.Optional[str] = None
+        self.resultsName: str = None  # type: ignore[assignment]
         self.saveAsList = savelist
         self.skipWhitespace = True
         self.whiteChars = set(ParserElement.DEFAULT_WHITE_CHARS)
@@ -490,12 +496,29 @@ class ParserElement(ABC):
             base.suppress_warning(Diagnostics.warn_on_parse_using_empty_Forward)
 
             # statement would normally raise a warning, but is now suppressed
-            print(base.parseString("x"))
+            print(base.parse_string("x"))
 
         """
         self.suppress_warnings_.append(warning_type)
         return self
 
+    def visit_all(self):
+        """General-purpose method to yield all expressions and sub-expressions
+        in a grammar. Typically just for internal use.
+        """
+        to_visit = deque([self])
+        seen = set()
+        while to_visit:
+            cur = to_visit.popleft()
+
+            # guard against looping forever through recursive grammars
+            if cur in seen:
+                continue
+            seen.add(cur)
+
+            to_visit.extend(cur.recurse())
+            yield cur
+
     def copy(self) -> "ParserElement":
         """
         Make a copy of this :class:`ParserElement`.  Useful for defining
@@ -585,11 +608,11 @@ class ParserElement(ABC):
                 pdb.set_trace()
                 return _parseMethod(instring, loc, doActions, callPreParse)
 
-            breaker._originalParseMethod = _parseMethod
-            self._parse = breaker
+            breaker._originalParseMethod = _parseMethod  # type: ignore [attr-defined]
+            self._parse = breaker  # type: ignore [assignment]
         else:
             if hasattr(self._parse, "_originalParseMethod"):
-                self._parse = self._parse._originalParseMethod
+                self._parse = self._parse._originalParseMethod  # type: ignore [attr-defined, assignment]
         return self
 
     def set_parse_action(self, *fns: ParseAction, **kwargs) -> "ParserElement":
@@ -601,9 +624,9 @@ class ParserElement(ABC):
         Each parse action ``fn`` is a callable method with 0-3 arguments, called as
         ``fn(s, loc, toks)`` , ``fn(loc, toks)`` , ``fn(toks)`` , or just ``fn()`` , where:
 
-        - s   = the original string being parsed (see note below)
-        - loc = the location of the matching substring
-        - toks = a list of the matched tokens, packaged as a :class:`ParseResults` object
+        - ``s``    = the original string being parsed (see note below)
+        - ``loc``  = the location of the matching substring
+        - ``toks`` = a list of the matched tokens, packaged as a :class:`ParseResults` object
 
         The parsed tokens are passed to the parse action as ParseResults. They can be
         modified in place using list-style append, extend, and pop operations to update
@@ -621,7 +644,7 @@ class ParserElement(ABC):
 
         Optional keyword arguments:
 
-        - call_during_try = (default= ``False``) indicate if parse action should be run during
+        - ``call_during_try`` = (default= ``False``) indicate if parse action should be run during
           lookaheads and alternate testing. For parse actions that have side effects, it is
           important to only call the parse action once it is determined that it is being
           called as part of a successful parse. For parse actions that perform additional
@@ -697,10 +720,10 @@ class ParserElement(ABC):
 
         Optional keyword arguments:
 
-        - message = define a custom message to be used in the raised exception
-        - fatal = if True, will raise ParseFatalException to stop parsing immediately; otherwise will raise
+        - ``message`` = define a custom message to be used in the raised exception
+        - ``fatal`` = if True, will raise ParseFatalException to stop parsing immediately; otherwise will raise
           ParseException
-        - call_during_try = boolean to indicate if this method should be called during internal tryParse calls,
+        - ``call_during_try`` = boolean to indicate if this method should be called during internal tryParse calls,
           default=False
 
         Example::
@@ -716,7 +739,9 @@ class ParserElement(ABC):
         for fn in fns:
             self.parseAction.append(
                 condition_as_parse_action(
-                    fn, message=kwargs.get("message"), fatal=kwargs.get("fatal", False)
+                    fn,
+                    message=str(kwargs.get("message")),
+                    fatal=bool(kwargs.get("fatal", False)),
                 )
             )
 
@@ -731,30 +756,38 @@ class ParserElement(ABC):
         Fail acton fn is a callable function that takes the arguments
         ``fn(s, loc, expr, err)`` where:
 
-        - s = string being parsed
-        - loc = location where expression match was attempted and failed
-        - expr = the parse expression that failed
-        - err = the exception thrown
+        - ``s`` = string being parsed
+        - ``loc`` = location where expression match was attempted and failed
+        - ``expr`` = the parse expression that failed
+        - ``err`` = the exception thrown
 
         The function returns no value.  It may throw :class:`ParseFatalException`
         if it is desired to stop parsing immediately."""
         self.failAction = fn
         return self
 
-    def _skipIgnorables(self, instring, loc):
+    def _skipIgnorables(self, instring: str, loc: int) -> int:
+        if not self.ignoreExprs:
+            return loc
         exprsFound = True
+        ignore_expr_fns = [e._parse for e in self.ignoreExprs]
+        last_loc = loc
         while exprsFound:
             exprsFound = False
-            for e in self.ignoreExprs:
+            for ignore_fn in ignore_expr_fns:
                 try:
                     while 1:
-                        loc, dummy = e._parse(instring, loc)
+                        loc, dummy = ignore_fn(instring, loc)
                         exprsFound = True
                 except ParseException:
                     pass
+            # check if all ignore exprs matched but didn't actually advance the parse location
+            if loc == last_loc:
+                break
+            last_loc = loc
         return loc
 
-    def preParse(self, instring, loc):
+    def preParse(self, instring: str, loc: int) -> int:
         if self.ignoreExprs:
             loc = self._skipIgnorables(instring, loc)
 
@@ -830,7 +863,7 @@ class ParserElement(ABC):
                 try:
                     for fn in self.parseAction:
                         try:
-                            tokens = fn(instring, tokens_start, ret_tokens)
+                            tokens = fn(instring, tokens_start, ret_tokens)  # type: ignore [call-arg, arg-type]
                         except IndexError as parse_action_exc:
                             exc = ParseException("exception raised in parse action")
                             raise exc from parse_action_exc
@@ -853,7 +886,7 @@ class ParserElement(ABC):
             else:
                 for fn in self.parseAction:
                     try:
-                        tokens = fn(instring, tokens_start, ret_tokens)
+                        tokens = fn(instring, tokens_start, ret_tokens)  # type: ignore [call-arg, arg-type]
                     except IndexError as parse_action_exc:
                         exc = ParseException("exception raised in parse action")
                         raise exc from parse_action_exc
@@ -875,17 +908,24 @@ class ParserElement(ABC):
 
         return loc, ret_tokens
 
-    def try_parse(self, instring: str, loc: int, raise_fatal: bool = False) -> int:
+    def try_parse(
+        self,
+        instring: str,
+        loc: int,
+        *,
+        raise_fatal: bool = False,
+        do_actions: bool = False,
+    ) -> int:
         try:
-            return self._parse(instring, loc, doActions=False)[0]
+            return self._parse(instring, loc, doActions=do_actions)[0]
         except ParseFatalException:
             if raise_fatal:
                 raise
             raise ParseException(instring, loc, self.errmsg, self)
 
-    def can_parse_next(self, instring: str, loc: int) -> bool:
+    def can_parse_next(self, instring: str, loc: int, do_actions: bool = False) -> bool:
         try:
-            self.try_parse(instring, loc)
+            self.try_parse(instring, loc, do_actions=do_actions)
         except (ParseException, IndexError):
             return False
         else:
@@ -897,10 +937,23 @@ class ParserElement(ABC):
         Tuple[int, "Forward", bool], Tuple[int, Union[ParseResults, Exception]]
     ] = {}
 
+    class _CacheType(dict):
+        """
+        class to help type checking
+        """
+
+        not_in_cache: bool
+
+        def get(self, *args):
+            ...
+
+        def set(self, *args):
+            ...
+
     # argument cache for optimizing repeated calls when backtracking through recursive expressions
     packrat_cache = (
-        {}
-    )  # this is set later by enabled_packrat(); this is here so that reset_cache() doesn't fail
+        _CacheType()
+    )  # set later by enable_packrat(); this is here so that reset_cache() doesn't fail
     packrat_cache_lock = RLock()
     packrat_cache_stats = [0, 0]
 
@@ -930,24 +983,25 @@ class ParserElement(ABC):
                 ParserElement.packrat_cache_stats[HIT] += 1
                 if self.debug and self.debugActions.debug_try:
                     try:
-                        self.debugActions.debug_try(instring, loc, self, cache_hit=True)
+                        self.debugActions.debug_try(instring, loc, self, cache_hit=True)  # type: ignore [call-arg]
                     except TypeError:
                         pass
                 if isinstance(value, Exception):
                     if self.debug and self.debugActions.debug_fail:
                         try:
                             self.debugActions.debug_fail(
-                                instring, loc, self, value, cache_hit=True
+                                instring, loc, self, value, cache_hit=True  # type: ignore [call-arg]
                             )
                         except TypeError:
                             pass
                     raise value
 
+                value = cast(Tuple[int, ParseResults, int], value)
                 loc_, result, endloc = value[0], value[1].copy(), value[2]
                 if self.debug and self.debugActions.debug_match:
                     try:
                         self.debugActions.debug_match(
-                            instring, loc_, endloc, self, result, cache_hit=True
+                            instring, loc_, endloc, self, result, cache_hit=True  # type: ignore [call-arg]
                         )
                     except TypeError:
                         pass
@@ -1009,7 +1063,7 @@ class ParserElement(ABC):
 
         Parameters:
 
-        - cache_size_limit - (default=``None``) - memoize at most this many
+        - ``cache_size_limit`` - (default=``None``) - memoize at most this many
           ``Forward`` elements during matching; if ``None`` (the default),
           memoize all ``Forward`` elements.
 
@@ -1022,15 +1076,17 @@ class ParserElement(ABC):
         elif ParserElement._packratEnabled:
             raise RuntimeError("Packrat and Bounded Recursion are not compatible")
         if cache_size_limit is None:
-            ParserElement.recursion_memos = _UnboundedMemo()
+            ParserElement.recursion_memos = _UnboundedMemo()  # type: ignore[assignment]
         elif cache_size_limit > 0:
-            ParserElement.recursion_memos = _LRUMemo(capacity=cache_size_limit)
+            ParserElement.recursion_memos = _LRUMemo(capacity=cache_size_limit)  # type: ignore[assignment]
         else:
             raise NotImplementedError("Memo size of %s" % cache_size_limit)
         ParserElement._left_recursion_enabled = True
 
     @staticmethod
-    def enable_packrat(cache_size_limit: int = 128, *, force: bool = False) -> None:
+    def enable_packrat(
+        cache_size_limit: Union[int, None] = 128, *, force: bool = False
+    ) -> None:
         """
         Enables "packrat" parsing, which adds memoizing to the parsing logic.
         Repeated parse attempts at the same string location (which happens
@@ -1040,7 +1096,7 @@ class ParserElement(ABC):
 
         Parameters:
 
-        - cache_size_limit - (default= ``128``) - if an integer value is provided
+        - ``cache_size_limit`` - (default= ``128``) - if an integer value is provided
           will limit the size of the packrat cache; if None is passed, then
           the cache size will be unbounded; if 0 is passed, the cache will
           be effectively disabled.
@@ -1070,7 +1126,7 @@ class ParserElement(ABC):
             if cache_size_limit is None:
                 ParserElement.packrat_cache = _UnboundedCache()
             else:
-                ParserElement.packrat_cache = _FifoCache(cache_size_limit)
+                ParserElement.packrat_cache = _FifoCache(cache_size_limit)  # type: ignore[assignment]
             ParserElement._parse = ParserElement._parseCache
 
     def parse_string(
@@ -1088,7 +1144,7 @@ class ParserElement(ABC):
           an object with attributes if the given parser includes results names.
 
         If the input string is required to match the entire grammar, ``parse_all`` flag must be set to ``True``. This
-        is also equivalent to ending the grammar with :class:`StringEnd`().
+        is also equivalent to ending the grammar with :class:`StringEnd`\\ ().
 
         To report proper column numbers, ``parse_string`` operates on a copy of the input string where all tabs are
         converted to spaces (8 spaces per tab, as per the default in ``string.expandtabs``). If the input string
@@ -1198,7 +1254,9 @@ class ParserElement(ABC):
         try:
             while loc <= instrlen and matches < maxMatches:
                 try:
-                    preloc = preparseFn(instring, loc)
+                    preloc: int = preparseFn(instring, loc)
+                    nextLoc: int
+                    tokens: ParseResults
                     nextLoc, tokens = parseFn(instring, preloc, callPreParse=False)
                 except ParseException:
                     loc = preloc + 1
@@ -1352,7 +1410,7 @@ class ParserElement(ABC):
     def __add__(self, other) -> "ParserElement":
         """
         Implementation of ``+`` operator - returns :class:`And`. Adding strings to a :class:`ParserElement`
-        converts them to :class:`Literal`s by default.
+        converts them to :class:`Literal`\\ s by default.
 
         Example::
 
@@ -1364,11 +1422,11 @@ class ParserElement(ABC):
 
             Hello, World! -> ['Hello', ',', 'World', '!']
 
-        ``...`` may be used as a parse expression as a short form of :class:`SkipTo`.
+        ``...`` may be used as a parse expression as a short form of :class:`SkipTo`::
 
             Literal('start') + ... + Literal('end')
 
-        is equivalent to:
+        is equivalent to::
 
             Literal('start') + SkipTo('end')("_skipped*") + Literal('end')
 
@@ -1382,11 +1440,7 @@ class ParserElement(ABC):
         if isinstance(other, str_type):
             other = self._literalStringClass(other)
         if not isinstance(other, ParserElement):
-            raise TypeError(
-                "Cannot combine element of type {} with ParserElement".format(
-                    type(other).__name__
-                )
-            )
+            return NotImplemented
         return And([self, other])
 
     def __radd__(self, other) -> "ParserElement":
@@ -1399,11 +1453,7 @@ class ParserElement(ABC):
         if isinstance(other, str_type):
             other = self._literalStringClass(other)
         if not isinstance(other, ParserElement):
-            raise TypeError(
-                "Cannot combine element of type {} with ParserElement".format(
-                    type(other).__name__
-                )
-            )
+            return NotImplemented
         return other + self
 
     def __sub__(self, other) -> "ParserElement":
@@ -1413,11 +1463,7 @@ class ParserElement(ABC):
         if isinstance(other, str_type):
             other = self._literalStringClass(other)
         if not isinstance(other, ParserElement):
-            raise TypeError(
-                "Cannot combine element of type {} with ParserElement".format(
-                    type(other).__name__
-                )
-            )
+            return NotImplemented
         return self + And._ErrorStop() + other
 
     def __rsub__(self, other) -> "ParserElement":
@@ -1427,11 +1473,7 @@ class ParserElement(ABC):
         if isinstance(other, str_type):
             other = self._literalStringClass(other)
         if not isinstance(other, ParserElement):
-            raise TypeError(
-                "Cannot combine element of type {} with ParserElement".format(
-                    type(other).__name__
-                )
-            )
+            return NotImplemented
         return other - self
 
     def __mul__(self, other) -> "ParserElement":
@@ -1440,11 +1482,12 @@ class ParserElement(ABC):
         ``expr + expr + expr``.  Expressions may also be multiplied by a 2-integer
         tuple, similar to ``{min, max}`` multipliers in regular expressions.  Tuples
         may also include ``None`` as in:
+
         - ``expr*(n, None)`` or ``expr*(n, )`` is equivalent
-             to ``expr*n + ZeroOrMore(expr)``
-             (read as "at least n instances of ``expr``")
+          to ``expr*n + ZeroOrMore(expr)``
+          (read as "at least n instances of ``expr``")
         - ``expr*(None, n)`` is equivalent to ``expr*(0, n)``
-             (read as "0 to n instances of ``expr``")
+          (read as "0 to n instances of ``expr``")
         - ``expr*(None, None)`` is equivalent to ``ZeroOrMore(expr)``
         - ``expr*(1, None)`` is equivalent to ``OneOrMore(expr)``
 
@@ -1477,17 +1520,9 @@ class ParserElement(ABC):
                 minElements, optElements = other
                 optElements -= minElements
             else:
-                raise TypeError(
-                    "cannot multiply ParserElement and ({}) objects".format(
-                        ",".join(type(item).__name__ for item in other)
-                    )
-                )
+                return NotImplemented
         else:
-            raise TypeError(
-                "cannot multiply ParserElement and {} objects".format(
-                    type(other).__name__
-                )
-            )
+            return NotImplemented
 
         if minElements < 0:
             raise ValueError("cannot multiply ParserElement by negative value")
@@ -1531,13 +1566,12 @@ class ParserElement(ABC):
             return _PendingSkip(self, must_skip=True)
 
         if isinstance(other, str_type):
+            # `expr | ""` is equivalent to `Opt(expr)`
+            if other == "":
+                return Opt(self)
             other = self._literalStringClass(other)
         if not isinstance(other, ParserElement):
-            raise TypeError(
-                "Cannot combine element of type {} with ParserElement".format(
-                    type(other).__name__
-                )
-            )
+            return NotImplemented
         return MatchFirst([self, other])
 
     def __ror__(self, other) -> "ParserElement":
@@ -1547,11 +1581,7 @@ class ParserElement(ABC):
         if isinstance(other, str_type):
             other = self._literalStringClass(other)
         if not isinstance(other, ParserElement):
-            raise TypeError(
-                "Cannot combine element of type {} with ParserElement".format(
-                    type(other).__name__
-                )
-            )
+            return NotImplemented
         return other | self
 
     def __xor__(self, other) -> "ParserElement":
@@ -1561,11 +1591,7 @@ class ParserElement(ABC):
         if isinstance(other, str_type):
             other = self._literalStringClass(other)
         if not isinstance(other, ParserElement):
-            raise TypeError(
-                "Cannot combine element of type {} with ParserElement".format(
-                    type(other).__name__
-                )
-            )
+            return NotImplemented
         return Or([self, other])
 
     def __rxor__(self, other) -> "ParserElement":
@@ -1575,11 +1601,7 @@ class ParserElement(ABC):
         if isinstance(other, str_type):
             other = self._literalStringClass(other)
         if not isinstance(other, ParserElement):
-            raise TypeError(
-                "Cannot combine element of type {} with ParserElement".format(
-                    type(other).__name__
-                )
-            )
+            return NotImplemented
         return other ^ self
 
     def __and__(self, other) -> "ParserElement":
@@ -1589,11 +1611,7 @@ class ParserElement(ABC):
         if isinstance(other, str_type):
             other = self._literalStringClass(other)
         if not isinstance(other, ParserElement):
-            raise TypeError(
-                "Cannot combine element of type {} with ParserElement".format(
-                    type(other).__name__
-                )
-            )
+            return NotImplemented
         return Each([self, other])
 
     def __rand__(self, other) -> "ParserElement":
@@ -1603,11 +1621,7 @@ class ParserElement(ABC):
         if isinstance(other, str_type):
             other = self._literalStringClass(other)
         if not isinstance(other, ParserElement):
-            raise TypeError(
-                "Cannot combine element of type {} with ParserElement".format(
-                    type(other).__name__
-                )
-            )
+            return NotImplemented
         return other & self
 
     def __invert__(self) -> "ParserElement":
@@ -1636,38 +1650,58 @@ class ParserElement(ABC):
 
         ``None`` may be used in place of ``...``.
 
-        Note that ``expr[..., n]`` and ``expr[m, n]``do not raise an exception
-        if more than ``n`` ``expr``s exist in the input stream.  If this behavior is
+        Note that ``expr[..., n]`` and ``expr[m, n]`` do not raise an exception
+        if more than ``n`` ``expr``\\ s exist in the input stream.  If this behavior is
         desired, then write ``expr[..., n] + ~expr``.
+
+        For repetition with a stop_on expression, use slice notation:
+
+        - ``expr[...: end_expr]`` and ``expr[0, ...: end_expr]`` are equivalent to ``ZeroOrMore(expr, stop_on=end_expr)``
+        - ``expr[1, ...: end_expr]`` is equivalent to ``OneOrMore(expr, stop_on=end_expr)``
+
         """
 
+        stop_on_defined = False
+        stop_on = NoMatch()
+        if isinstance(key, slice):
+            key, stop_on = key.start, key.stop
+            if key is None:
+                key = ...
+            stop_on_defined = True
+        elif isinstance(key, tuple) and isinstance(key[-1], slice):
+            key, stop_on = (key[0], key[1].start), key[1].stop
+            stop_on_defined = True
+
         # convert single arg keys to tuples
+        if isinstance(key, str_type):
+            key = (key,)
         try:
-            if isinstance(key, str_type):
-                key = (key,)
             iter(key)
         except TypeError:
             key = (key, key)
 
         if len(key) > 2:
             raise TypeError(
-                "only 1 or 2 index arguments supported ({}{})".format(
-                    key[:5], "... [{}]".format(len(key)) if len(key) > 5 else ""
-                )
+                f"only 1 or 2 index arguments supported ({key[:5]}{f'... [{len(key)}]' if len(key) > 5 else ''})"
             )
 
         # clip to 2 elements
         ret = self * tuple(key[:2])
+        ret = typing.cast(_MultipleMatch, ret)
+
+        if stop_on_defined:
+            ret.stopOn(stop_on)
+
         return ret
 
-    def __call__(self, name: str = None) -> "ParserElement":
+    def __call__(self, name: typing.Optional[str] = None) -> "ParserElement":
         """
         Shortcut for :class:`set_results_name`, with ``list_all_matches=False``.
 
         If ``name`` is given with a trailing ``'*'`` character, then ``list_all_matches`` will be
         passed as ``True``.
 
-        If ``name` is omitted, same as calling :class:`copy`.
+        If ``name`` is omitted, same as calling :class:`copy`.
 
         Example::
 
@@ -1775,17 +1809,18 @@ class ParserElement(ABC):
           should have the signature ``fn(input_string: str, location: int, expression: ParserElement, exception: Exception, cache_hit: bool)``
         """
         self.debugActions = self.DebugActions(
-            start_action or _default_start_debug_action,
-            success_action or _default_success_debug_action,
-            exception_action or _default_exception_debug_action,
+            start_action or _default_start_debug_action,  # type: ignore[truthy-function]
+            success_action or _default_success_debug_action,  # type: ignore[truthy-function]
+            exception_action or _default_exception_debug_action,  # type: ignore[truthy-function]
         )
         self.debug = True
         return self
 
-    def set_debug(self, flag: bool = True) -> "ParserElement":
+    def set_debug(self, flag: bool = True, recurse: bool = False) -> "ParserElement":
         """
         Enable display of debugging messages while doing pattern matching.
         Set ``flag`` to ``True`` to enable, ``False`` to disable.
+        Set ``recurse`` to ``True`` to set the debug flag on this expression and all sub-expressions.
 
         Example::
 
@@ -1819,6 +1854,11 @@ class ParserElement(ABC):
         which makes debugging and exception messages easier to understand - for instance, the default
         name created for the :class:`Word` expression without calling ``set_name`` is ``"W:(A-Za-z)"``.
         """
+        if recurse:
+            for expr in self.visit_all():
+                expr.set_debug(flag, recurse=False)
+            return self
+
         if flag:
             self.set_debug_actions(
                 _default_start_debug_action,
@@ -1836,7 +1876,7 @@ class ParserElement(ABC):
         return self._defaultName
 
     @abstractmethod
-    def _generateDefaultName(self):
+    def _generateDefaultName(self) -> str:
         """
         Child classes must define this method, which defines how the ``default_name`` is set.
         """
@@ -1844,7 +1884,9 @@ class ParserElement(ABC):
     def set_name(self, name: str) -> "ParserElement":
         """
         Define name for this expression, makes debugging and exception messages clearer.
+
         Example::
+
             Word(nums).parse_string("ABC")  # -> Exception: Expected W:(0-9) (at char 0), (line:1, col:1)
             Word(nums).set_name("integer").parse_string("ABC")  # -> Exception: Expected integer (at char 0), (line:1, col:1)
         """
@@ -1870,7 +1912,7 @@ class ParserElement(ABC):
         self._defaultName = None
         return self
 
-    def recurse(self) -> Sequence["ParserElement"]:
+    def recurse(self) -> List["ParserElement"]:
         return []
 
     def _checkRecursion(self, parseElementList):
@@ -1882,6 +1924,11 @@ class ParserElement(ABC):
         """
         Check defined expressions for valid structure, check for infinite recursive definitions.
         """
+        warnings.warn(
+            "ParserElement.validate() is deprecated, and should not be used to check for left recursion",
+            DeprecationWarning,
+            stacklevel=2,
+        )
         self._checkRecursion([])
 
     def parse_file(
@@ -1899,8 +1946,10 @@ class ParserElement(ABC):
         """
         parseAll = parseAll or parse_all
         try:
+            file_or_filename = typing.cast(TextIO, file_or_filename)
             file_contents = file_or_filename.read()
         except AttributeError:
+            file_or_filename = typing.cast(str, file_or_filename)
             with open(file_or_filename, "r", encoding=encoding) as f:
                 file_contents = f.read()
         try:
@@ -1932,6 +1981,7 @@ class ParserElement(ABC):
         inline microtests of sub expressions while building up larger parser.
 
         Parameters:
+
         - ``test_string`` - to test against this expression for a match
         - ``parse_all`` - (default= ``True``) - flag to pass to :class:`parse_string` when running tests
 
@@ -1955,7 +2005,7 @@ class ParserElement(ABC):
         full_dump: bool = True,
         print_results: bool = True,
         failure_tests: bool = False,
-        post_parse: Callable[[str, ParseResults], str] = None,
+        post_parse: typing.Optional[Callable[[str, ParseResults], str]] = None,
         file: typing.Optional[TextIO] = None,
         with_line_numbers: bool = False,
         *,
@@ -1963,7 +2013,7 @@ class ParserElement(ABC):
         fullDump: bool = True,
         printResults: bool = True,
         failureTests: bool = False,
-        postParse: Callable[[str, ParseResults], str] = None,
+        postParse: typing.Optional[Callable[[str, ParseResults], str]] = None,
     ) -> Tuple[bool, List[Tuple[str, Union[ParseResults, Exception]]]]:
         """
         Execute the parse expression on a series of test strings, showing each
@@ -1971,6 +2021,7 @@ class ParserElement(ABC):
         run a parse expression against a list of sample strings.
 
         Parameters:
+
         - ``tests`` - a list of separate test strings, or a multiline string of test strings
         - ``parse_all`` - (default= ``True``) - flag to pass to :class:`parse_string` when running tests
         - ``comment`` - (default= ``'#'``) - expression for indicating embedded comments in the test
@@ -2067,22 +2118,27 @@ class ParserElement(ABC):
         failureTests = failureTests or failure_tests
         postParse = postParse or post_parse
         if isinstance(tests, str_type):
+            tests = typing.cast(str, tests)
             line_strip = type(tests).strip
             tests = [line_strip(test_line) for test_line in tests.rstrip().splitlines()]
-        if isinstance(comment, str_type):
-            comment = Literal(comment)
+        comment_specified = comment is not None
+        if comment_specified:
+            if isinstance(comment, str_type):
+                comment = typing.cast(str, comment)
+                comment = Literal(comment)
+        comment = typing.cast(ParserElement, comment)
         if file is None:
             file = sys.stdout
         print_ = file.write
 
         result: Union[ParseResults, Exception]
-        allResults = []
-        comments = []
+        allResults: List[Tuple[str, Union[ParseResults, Exception]]] = []
+        comments: List[str] = []
         success = True
         NL = Literal(r"\n").add_parse_action(replace_with("\n")).ignore(quoted_string)
         BOM = "\ufeff"
         for t in tests:
-            if comment is not None and comment.matches(t, False) or comments and not t:
+            if comment_specified and comment.matches(t, False) or comments and not t:
                 comments.append(
                     pyparsing_test.with_line_numbers(t) if with_line_numbers else t
                 )
@@ -2107,7 +2163,7 @@ class ParserElement(ABC):
                 success = success and failureTests
                 result = pe
             except Exception as exc:
-                out.append("FAIL-EXCEPTION: {}: {}".format(type(exc).__name__, exc))
+                out.append(f"FAIL-EXCEPTION: {type(exc).__name__}: {exc}")
                 if ParserElement.verbose_stacktrace:
                     out.extend(traceback.format_tb(exc.__traceback__))
                 success = success and failureTests
@@ -2127,9 +2183,7 @@ class ParserElement(ABC):
                     except Exception as e:
                         out.append(result.dump(full=fullDump))
                         out.append(
-                            "{} failed: {}: {}".format(
-                                postParse.__name__, type(e).__name__, e
-                            )
+                            f"{postParse.__name__} failed: {type(e).__name__}: {e}"
                         )
                 else:
                     out.append(result.dump(full=fullDump))
@@ -2148,19 +2202,28 @@ class ParserElement(ABC):
         vertical: int = 3,
         show_results_names: bool = False,
         show_groups: bool = False,
+        embed: bool = False,
         **kwargs,
     ) -> None:
         """
         Create a railroad diagram for the parser.
 
         Parameters:
-        - output_html (str or file-like object) - output target for generated
+
+        - ``output_html`` (str or file-like object) - output target for generated
           diagram HTML
-        - vertical (int) - threshold for formatting multiple alternatives vertically
+        - ``vertical`` (int) - threshold for formatting multiple alternatives vertically
           instead of horizontally (default=3)
-        - show_results_names - bool flag whether diagram should show annotations for
+        - ``show_results_names`` - bool flag whether diagram should show annotations for
           defined results names
-        - show_groups - bool flag whether groups should be highlighted with an unlabeled surrounding box
+        - ``show_groups`` - bool flag whether groups should be highlighted with an unlabeled surrounding box
+        - ``embed`` - bool flag whether generated HTML should omit <HEAD>, <BODY>, and <DOCTYPE> tags to embed
+          the resulting HTML in an enclosing HTML source
+        - ``head`` - str containing additional HTML to insert into the <HEAD> section of the generated code;
+          can be used to insert custom CSS styling
+        - ``body`` - str containing additional HTML to insert at the beginning of the <BODY> section of the
+          generated code
+
         Additional diagram-formatting keyword arguments can also be included;
         see railroad.Diagram class.
         """
@@ -2183,38 +2246,93 @@ class ParserElement(ABC):
         )
         if isinstance(output_html, (str, Path)):
             with open(output_html, "w", encoding="utf-8") as diag_file:
-                diag_file.write(railroad_to_html(railroad))
+                diag_file.write(railroad_to_html(railroad, embed=embed, **kwargs))
         else:
             # we were passed a file-like object, just write to it
-            output_html.write(railroad_to_html(railroad))
+            output_html.write(railroad_to_html(railroad, embed=embed, **kwargs))
+
+    # Compatibility synonyms
+    # fmt: off
+    @staticmethod
+    @replaced_by_pep8(inline_literals_using)
+    def inlineLiteralsUsing(): ...
+
+    @staticmethod
+    @replaced_by_pep8(set_default_whitespace_chars)
+    def setDefaultWhitespaceChars(): ...
+
+    @replaced_by_pep8(set_results_name)
+    def setResultsName(self): ...
+
+    @replaced_by_pep8(set_break)
+    def setBreak(self): ...
+
+    @replaced_by_pep8(set_parse_action)
+    def setParseAction(self): ...
+
+    @replaced_by_pep8(add_parse_action)
+    def addParseAction(self): ...
+
+    @replaced_by_pep8(add_condition)
+    def addCondition(self): ...
+
+    @replaced_by_pep8(set_fail_action)
+    def setFailAction(self): ...
+
+    @replaced_by_pep8(try_parse)
+    def tryParse(self): ...
+
+    @staticmethod
+    @replaced_by_pep8(enable_left_recursion)
+    def enableLeftRecursion(): ...
+
+    @staticmethod
+    @replaced_by_pep8(enable_packrat)
+    def enablePackrat(): ...
+
+    @replaced_by_pep8(parse_string)
+    def parseString(self): ...
+
+    @replaced_by_pep8(scan_string)
+    def scanString(self): ...
+
+    @replaced_by_pep8(transform_string)
+    def transformString(self): ...
+
+    @replaced_by_pep8(search_string)
+    def searchString(self): ...
+
+    @replaced_by_pep8(ignore_whitespace)
+    def ignoreWhitespace(self): ...
+
+    @replaced_by_pep8(leave_whitespace)
+    def leaveWhitespace(self): ...
+
+    @replaced_by_pep8(set_whitespace_chars)
+    def setWhitespaceChars(self): ...
+
+    @replaced_by_pep8(parse_with_tabs)
+    def parseWithTabs(self): ...
+
+    @replaced_by_pep8(set_debug_actions)
+    def setDebugActions(self): ...
+
+    @replaced_by_pep8(set_debug)
+    def setDebug(self): ...
+
+    @replaced_by_pep8(set_name)
+    def setName(self): ...
+
+    @replaced_by_pep8(parse_file)
+    def parseFile(self): ...
+
+    @replaced_by_pep8(run_tests)
+    def runTests(self): ...
 
-    setDefaultWhitespaceChars = set_default_whitespace_chars
-    inlineLiteralsUsing = inline_literals_using
-    setResultsName = set_results_name
-    setBreak = set_break
-    setParseAction = set_parse_action
-    addParseAction = add_parse_action
-    addCondition = add_condition
-    setFailAction = set_fail_action
-    tryParse = try_parse
     canParseNext = can_parse_next
     resetCache = reset_cache
-    enableLeftRecursion = enable_left_recursion
-    enablePackrat = enable_packrat
-    parseString = parse_string
-    scanString = scan_string
-    searchString = search_string
-    transformString = transform_string
-    setWhitespaceChars = set_whitespace_chars
-    parseWithTabs = parse_with_tabs
-    setDebugActions = set_debug_actions
-    setDebug = set_debug
     defaultName = default_name
-    setName = set_name
-    parseFile = parse_file
-    runTests = run_tests
-    ignoreWhitespace = ignore_whitespace
-    leaveWhitespace = leave_whitespace
+    # fmt: on
 
 
 class _PendingSkip(ParserElement):
@@ -2225,7 +2343,7 @@ class _PendingSkip(ParserElement):
         self.anchor = expr
         self.must_skip = must_skip
 
-    def _generateDefaultName(self):
+    def _generateDefaultName(self) -> str:
         return str(self.anchor + Empty()).replace("Empty", "...")
 
     def __add__(self, other) -> "ParserElement":
@@ -2266,21 +2384,10 @@ class Token(ParserElement):
     def __init__(self):
         super().__init__(savelist=False)
 
-    def _generateDefaultName(self):
+    def _generateDefaultName(self) -> str:
         return type(self).__name__
 
 
-class Empty(Token):
-    """
-    An empty token, will always match.
-    """
-
-    def __init__(self):
-        super().__init__()
-        self.mayReturnEmpty = True
-        self.mayIndexError = False
-
-
 class NoMatch(Token):
     """
     A token that will never match.
@@ -2312,25 +2419,33 @@ class Literal(Token):
     use :class:`Keyword` or :class:`CaselessKeyword`.
     """
 
+    def __new__(cls, match_string: str = "", *, matchString: str = ""):
+        # Performance tuning: select a subclass with optimized parseImpl
+        if cls is Literal:
+            match_string = matchString or match_string
+            if not match_string:
+                return super().__new__(Empty)
+            if len(match_string) == 1:
+                return super().__new__(_SingleCharLiteral)
+
+        # Default behavior
+        return super().__new__(cls)
+
+    # Needed to make copy.copy() work correctly if we customize __new__
+    def __getnewargs__(self):
+        return (self.match,)
+
     def __init__(self, match_string: str = "", *, matchString: str = ""):
         super().__init__()
         match_string = matchString or match_string
         self.match = match_string
         self.matchLen = len(match_string)
-        try:
-            self.firstMatchChar = match_string[0]
-        except IndexError:
-            raise ValueError("null string passed to Literal; use Empty() instead")
+        self.firstMatchChar = match_string[:1]
         self.errmsg = "Expected " + self.name
         self.mayReturnEmpty = False
         self.mayIndexError = False
 
-        # Performance tuning: modify __class__ to select
-        # a parseImpl optimized for single-character check
-        if self.matchLen == 1 and type(self) is Literal:
-            self.__class__ = _SingleCharLiteral
-
-    def _generateDefaultName(self):
+    def _generateDefaultName(self) -> str:
         return repr(self.match)
 
     def parseImpl(self, instring, loc, doActions=True):
@@ -2341,6 +2456,23 @@ class Literal(Token):
         raise ParseException(instring, loc, self.errmsg, self)
 
 
+class Empty(Literal):
+    """
+    An empty token, will always match.
+    """
+
+    def __init__(self, match_string="", *, matchString=""):
+        super().__init__("")
+        self.mayReturnEmpty = True
+        self.mayIndexError = False
+
+    def _generateDefaultName(self) -> str:
+        return "Empty"
+
+    def parseImpl(self, instring, loc, doActions=True):
+        return loc, []
+
+
 class _SingleCharLiteral(Literal):
     def parseImpl(self, instring, loc, doActions=True):
         if instring[loc] == self.firstMatchChar:
@@ -2354,8 +2486,8 @@ ParserElement._literalStringClass = Literal
 class Keyword(Token):
     """
     Token to exactly match a specified string as a keyword, that is,
-    it must be immediately followed by a non-keyword character.  Compare
-    with :class:`Literal`:
+    it must be immediately preceded and followed by whitespace or
+    non-keyword characters. Compare with :class:`Literal`:
 
     - ``Literal("if")`` will match the leading ``'if'`` in
       ``'ifAndOnlyIf'``.
@@ -2365,7 +2497,7 @@ class Keyword(Token):
     Accepts two optional constructor arguments in addition to the
     keyword string:
 
-    - ``identChars`` is a string of characters that would be valid
+    - ``ident_chars`` is a string of characters that would be valid
       identifier characters, defaulting to all alphanumerics + "_" and
       "$"
     - ``caseless`` allows case-insensitive matching, default is ``False``.
@@ -2400,7 +2532,7 @@ class Keyword(Token):
             self.firstMatchChar = match_string[0]
         except IndexError:
             raise ValueError("null string passed to Keyword; use Empty() instead")
-        self.errmsg = "Expected {} {}".format(type(self).__name__, self.name)
+        self.errmsg = f"Expected {type(self).__name__} {self.name}"
         self.mayReturnEmpty = False
         self.mayIndexError = False
         self.caseless = caseless
@@ -2409,7 +2541,7 @@ class Keyword(Token):
             identChars = identChars.upper()
         self.identChars = set(identChars)
 
-    def _generateDefaultName(self):
+    def _generateDefaultName(self) -> str:
         return repr(self.match)
 
     def parseImpl(self, instring, loc, doActions=True):
@@ -2559,7 +2691,7 @@ class CloseMatch(Token):
     def __init__(
         self,
         match_string: str,
-        max_mismatches: int = None,
+        max_mismatches: typing.Optional[int] = None,
         *,
         maxMismatches: int = 1,
         caseless=False,
@@ -2568,15 +2700,13 @@ class CloseMatch(Token):
         super().__init__()
         self.match_string = match_string
         self.maxMismatches = maxMismatches
-        self.errmsg = "Expected {!r} (with up to {} mismatches)".format(
-            self.match_string, self.maxMismatches
-        )
+        self.errmsg = f"Expected {self.match_string!r} (with up to {self.maxMismatches} mismatches)"
         self.caseless = caseless
         self.mayIndexError = False
         self.mayReturnEmpty = False
 
-    def _generateDefaultName(self):
-        return "{}:{!r}".format(type(self).__name__, self.match_string)
+    def _generateDefaultName(self) -> str:
+        return f"{type(self).__name__}:{self.match_string!r}"
 
     def parseImpl(self, instring, loc, doActions=True):
         start = loc
@@ -2612,7 +2742,9 @@ class CloseMatch(Token):
 
 class Word(Token):
     """Token for matching words composed of allowed character sets.
+
     Parameters:
+
     - ``init_chars`` - string of all characters that should be used to
       match as a word; "ABC" will match "AAA", "ABAB", "CBAC", etc.;
       if ``body_chars`` is also specified, then this is the string of
@@ -2697,26 +2829,24 @@ class Word(Token):
         super().__init__()
         if not initChars:
             raise ValueError(
-                "invalid {}, initChars cannot be empty string".format(
-                    type(self).__name__
-                )
+                f"invalid {type(self).__name__}, initChars cannot be empty string"
             )
 
-        initChars = set(initChars)
-        self.initChars = initChars
+        initChars_set = set(initChars)
         if excludeChars:
-            excludeChars = set(excludeChars)
-            initChars -= excludeChars
+            excludeChars_set = set(excludeChars)
+            initChars_set -= excludeChars_set
             if bodyChars:
-                bodyChars = set(bodyChars) - excludeChars
-        self.initCharsOrig = "".join(sorted(initChars))
+                bodyChars = "".join(set(bodyChars) - excludeChars_set)
+        self.initChars = initChars_set
+        self.initCharsOrig = "".join(sorted(initChars_set))
 
         if bodyChars:
-            self.bodyCharsOrig = "".join(sorted(bodyChars))
             self.bodyChars = set(bodyChars)
+            self.bodyCharsOrig = "".join(sorted(bodyChars))
         else:
-            self.bodyCharsOrig = "".join(sorted(initChars))
-            self.bodyChars = set(initChars)
+            self.bodyChars = initChars_set
+            self.bodyCharsOrig = self.initCharsOrig
 
         self.maxSpecified = max > 0
 
@@ -2725,6 +2855,11 @@ class Word(Token):
                 "cannot specify a minimum length < 1; use Opt(Word()) if zero-length word is permitted"
             )
 
+        if self.maxSpecified and min > max:
+            raise ValueError(
+                f"invalid args, if min and max both specified min must be <= max (min={min}, max={max})"
+            )
+
         self.minLen = min
 
         if max > 0:
@@ -2733,62 +2868,64 @@ class Word(Token):
             self.maxLen = _MAX_INT
 
         if exact > 0:
+            min = max = exact
             self.maxLen = exact
             self.minLen = exact
 
         self.errmsg = "Expected " + self.name
         self.mayIndexError = False
         self.asKeyword = asKeyword
+        if self.asKeyword:
+            self.errmsg += " as a keyword"
 
         # see if we can make a regex for this Word
-        if " " not in self.initChars | self.bodyChars and (min == 1 and exact == 0):
+        if " " not in (self.initChars | self.bodyChars):
+            if len(self.initChars) == 1:
+                re_leading_fragment = re.escape(self.initCharsOrig)
+            else:
+                re_leading_fragment = f"[{_collapse_string_to_ranges(self.initChars)}]"
+
             if self.bodyChars == self.initChars:
-                if max == 0:
+                if max == 0 and self.minLen == 1:
                     repeat = "+"
                 elif max == 1:
                     repeat = ""
                 else:
-                    repeat = "{{{},{}}}".format(
-                        self.minLen, "" if self.maxLen == _MAX_INT else self.maxLen
-                    )
-                self.reString = "[{}]{}".format(
-                    _collapse_string_to_ranges(self.initChars),
-                    repeat,
-                )
-            elif len(self.initChars) == 1:
-                if max == 0:
-                    repeat = "*"
-                else:
-                    repeat = "{{0,{}}}".format(max - 1)
-                self.reString = "{}[{}]{}".format(
-                    re.escape(self.initCharsOrig),
-                    _collapse_string_to_ranges(self.bodyChars),
-                    repeat,
-                )
+                    if self.minLen != self.maxLen:
+                        repeat = f"{{{self.minLen},{'' if self.maxLen == _MAX_INT else self.maxLen}}}"
+                    else:
+                        repeat = f"{{{self.minLen}}}"
+                self.reString = f"{re_leading_fragment}{repeat}"
             else:
-                if max == 0:
-                    repeat = "*"
-                elif max == 2:
+                if max == 1:
+                    re_body_fragment = ""
                     repeat = ""
                 else:
-                    repeat = "{{0,{}}}".format(max - 1)
-                self.reString = "[{}][{}]{}".format(
-                    _collapse_string_to_ranges(self.initChars),
-                    _collapse_string_to_ranges(self.bodyChars),
-                    repeat,
-                )
+                    re_body_fragment = f"[{_collapse_string_to_ranges(self.bodyChars)}]"
+                    if max == 0 and self.minLen == 1:
+                        repeat = "*"
+                    elif max == 2:
+                        repeat = "?" if min <= 1 else ""
+                    else:
+                        if min != max:
+                            repeat = f"{{{min - 1 if min > 0 else ''},{max - 1 if max > 0 else ''}}}"
+                        else:
+                            repeat = f"{{{min - 1 if min > 0 else ''}}}"
+
+                self.reString = f"{re_leading_fragment}{re_body_fragment}{repeat}"
+
             if self.asKeyword:
-                self.reString = r"\b" + self.reString + r"\b"
+                self.reString = rf"\b{self.reString}\b"
 
             try:
                 self.re = re.compile(self.reString)
             except re.error:
-                self.re = None
+                self.re = None  # type: ignore[assignment]
             else:
                 self.re_match = self.re.match
-                self.__class__ = _WordRegex
+                self.parseImpl = self.parseImpl_regex  # type: ignore[assignment]
 
-    def _generateDefaultName(self):
+    def _generateDefaultName(self) -> str:
         def charsAsStr(s):
             max_repr_len = 16
             s = _collapse_string_to_ranges(s, re_escape=False)
@@ -2798,11 +2935,9 @@ class Word(Token):
                 return s
 
         if self.initChars != self.bodyChars:
-            base = "W:({}, {})".format(
-                charsAsStr(self.initChars), charsAsStr(self.bodyChars)
-            )
+            base = f"W:({charsAsStr(self.initChars)}, {charsAsStr(self.bodyChars)})"
         else:
-            base = "W:({})".format(charsAsStr(self.initChars))
+            base = f"W:({charsAsStr(self.initChars)})"
 
         # add length specification
         if self.minLen > 1 or self.maxLen != _MAX_INT:
@@ -2810,11 +2945,11 @@ class Word(Token):
                 if self.minLen == 1:
                     return base[2:]
                 else:
-                    return base + "{{{}}}".format(self.minLen)
+                    return base + f"{{{self.minLen}}}"
             elif self.maxLen == _MAX_INT:
-                return base + "{{{},...}}".format(self.minLen)
+                return base + f"{{{self.minLen},...}}"
             else:
-                return base + "{{{},{}}}".format(self.minLen, self.maxLen)
+                return base + f"{{{self.minLen},{self.maxLen}}}"
         return base
 
     def parseImpl(self, instring, loc, doActions=True):
@@ -2849,9 +2984,7 @@ class Word(Token):
 
         return loc, instring[start:loc]
 
-
-class _WordRegex(Word):
-    def parseImpl(self, instring, loc, doActions=True):
+    def parseImpl_regex(self, instring, loc, doActions=True):
         result = self.re_match(instring, loc)
         if not result:
             raise ParseException(instring, loc, self.errmsg, self)
@@ -2860,7 +2993,7 @@ class _WordRegex(Word):
         return loc, result.group()
 
 
-class Char(_WordRegex):
+class Char(Word):
     """A short-cut class for defining :class:`Word` ``(characters, exact=1)``,
     when defining a match of any single character in a string of
     characters.
@@ -2878,13 +3011,8 @@ class Char(_WordRegex):
         asKeyword = asKeyword or as_keyword
         excludeChars = excludeChars or exclude_chars
         super().__init__(
-            charset, exact=1, asKeyword=asKeyword, excludeChars=excludeChars
+            charset, exact=1, as_keyword=asKeyword, exclude_chars=excludeChars
         )
-        self.reString = "[{}]".format(_collapse_string_to_ranges(self.initChars))
-        if asKeyword:
-            self.reString = r"\b{}\b".format(self.reString)
-        self.re = re.compile(self.reString)
-        self.re_match = self.re.match
 
 
 class Regex(Token):
@@ -2954,9 +3082,9 @@ class Regex(Token):
         self.asGroupList = asGroupList
         self.asMatch = asMatch
         if self.asGroupList:
-            self.parseImpl = self.parseImplAsGroupList
+            self.parseImpl = self.parseImplAsGroupList  # type: ignore [assignment]
         if self.asMatch:
-            self.parseImpl = self.parseImplAsMatch
+            self.parseImpl = self.parseImplAsMatch  # type: ignore [assignment]
 
     @cached_property
     def re(self):
@@ -2966,9 +3094,7 @@ class Regex(Token):
             try:
                 return re.compile(self.pattern, self.flags)
             except re.error:
-                raise ValueError(
-                    "invalid pattern ({!r}) passed to Regex".format(self.pattern)
-                )
+                raise ValueError(f"invalid pattern ({self.pattern!r}) passed to Regex")
 
     @cached_property
     def re_match(self):
@@ -2978,7 +3104,7 @@ class Regex(Token):
     def mayReturnEmpty(self):
         return self.re_match("") is not None
 
-    def _generateDefaultName(self):
+    def _generateDefaultName(self) -> str:
         return "Re:({})".format(repr(self.pattern).replace("\\\\", "\\"))
 
     def parseImpl(self, instring, loc, doActions=True):
@@ -3024,10 +3150,12 @@ class Regex(Token):
             # prints "<h1>main title</h1>"
         """
         if self.asGroupList:
-            raise TypeError("cannot use sub() with Regex(asGroupList=True)")
+            raise TypeError("cannot use sub() with Regex(as_group_list=True)")
 
         if self.asMatch and callable(repl):
-            raise TypeError("cannot use sub() with a callable with Regex(asMatch=True)")
+            raise TypeError(
+                "cannot use sub() with a callable with Regex(as_match=True)"
+            )
 
         if self.asMatch:
 
@@ -3081,7 +3209,7 @@ class QuotedString(Token):
         [['This is the "quote"']]
         [['This is the quote with "embedded" quotes']]
     """
-    ws_map = ((r"\t", "\t"), (r"\n", "\n"), (r"\f", "\f"), (r"\r", "\r"))
+    ws_map = dict(((r"\t", "\t"), (r"\n", "\n"), (r"\f", "\f"), (r"\r", "\r")))
 
     def __init__(
         self,
@@ -3101,139 +3229,164 @@ class QuotedString(Token):
         convertWhitespaceEscapes: bool = True,
     ):
         super().__init__()
-        escChar = escChar or esc_char
-        escQuote = escQuote or esc_quote
-        unquoteResults = unquoteResults and unquote_results
-        endQuoteChar = endQuoteChar or end_quote_char
-        convertWhitespaceEscapes = (
+        esc_char = escChar or esc_char
+        esc_quote = escQuote or esc_quote
+        unquote_results = unquoteResults and unquote_results
+        end_quote_char = endQuoteChar or end_quote_char
+        convert_whitespace_escapes = (
             convertWhitespaceEscapes and convert_whitespace_escapes
         )
         quote_char = quoteChar or quote_char
 
-        # remove white space from quote chars - wont work anyway
+        # remove white space from quote chars
         quote_char = quote_char.strip()
         if not quote_char:
             raise ValueError("quote_char cannot be the empty string")
 
-        if endQuoteChar is None:
-            endQuoteChar = quote_char
+        if end_quote_char is None:
+            end_quote_char = quote_char
         else:
-            endQuoteChar = endQuoteChar.strip()
-            if not endQuoteChar:
-                raise ValueError("endQuoteChar cannot be the empty string")
+            end_quote_char = end_quote_char.strip()
+            if not end_quote_char:
+                raise ValueError("end_quote_char cannot be the empty string")
 
-        self.quoteChar = quote_char
-        self.quoteCharLen = len(quote_char)
-        self.firstQuoteChar = quote_char[0]
-        self.endQuoteChar = endQuoteChar
-        self.endQuoteCharLen = len(endQuoteChar)
-        self.escChar = escChar
-        self.escQuote = escQuote
-        self.unquoteResults = unquoteResults
-        self.convertWhitespaceEscapes = convertWhitespaceEscapes
+        self.quote_char: str = quote_char
+        self.quote_char_len: int = len(quote_char)
+        self.first_quote_char: str = quote_char[0]
+        self.end_quote_char: str = end_quote_char
+        self.end_quote_char_len: int = len(end_quote_char)
+        self.esc_char: str = esc_char or ""
+        self.has_esc_char: bool = esc_char is not None
+        self.esc_quote: str = esc_quote or ""
+        self.unquote_results: bool = unquote_results
+        self.convert_whitespace_escapes: bool = convert_whitespace_escapes
+        self.multiline = multiline
+        self.re_flags = re.RegexFlag(0)
 
-        sep = ""
-        inner_pattern = ""
+        # fmt: off
+        # build up re pattern for the content between the quote delimiters
+        inner_pattern = []
 
-        if escQuote:
-            inner_pattern += r"{}(?:{})".format(sep, re.escape(escQuote))
-            sep = "|"
+        if esc_quote:
+            inner_pattern.append(rf"(?:{re.escape(esc_quote)})")
 
-        if escChar:
-            inner_pattern += r"{}(?:{}.)".format(sep, re.escape(escChar))
-            sep = "|"
-            self.escCharReplacePattern = re.escape(self.escChar) + "(.)"
+        if esc_char:
+            inner_pattern.append(rf"(?:{re.escape(esc_char)}.)")
 
-        if len(self.endQuoteChar) > 1:
-            inner_pattern += (
-                "{}(?:".format(sep)
+        if len(self.end_quote_char) > 1:
+            inner_pattern.append(
+                "(?:"
                 + "|".join(
-                    "(?:{}(?!{}))".format(
-                        re.escape(self.endQuoteChar[:i]),
-                        re.escape(self.endQuoteChar[i:]),
-                    )
-                    for i in range(len(self.endQuoteChar) - 1, 0, -1)
+                    f"(?:{re.escape(self.end_quote_char[:i])}(?!{re.escape(self.end_quote_char[i:])}))"
+                    for i in range(len(self.end_quote_char) - 1, 0, -1)
                 )
                 + ")"
             )
-            sep = "|"
 
-        if multiline:
-            self.flags = re.MULTILINE | re.DOTALL
-            inner_pattern += r"{}(?:[^{}{}])".format(
-                sep,
-                _escape_regex_range_chars(self.endQuoteChar[0]),
-                (_escape_regex_range_chars(escChar) if escChar is not None else ""),
+        if self.multiline:
+            self.re_flags |= re.MULTILINE | re.DOTALL
+            inner_pattern.append(
+                rf"(?:[^{_escape_regex_range_chars(self.end_quote_char[0])}"
+                rf"{(_escape_regex_range_chars(esc_char) if self.has_esc_char else '')}])"
             )
         else:
-            self.flags = 0
-            inner_pattern += r"{}(?:[^{}\n\r{}])".format(
-                sep,
-                _escape_regex_range_chars(self.endQuoteChar[0]),
-                (_escape_regex_range_chars(escChar) if escChar is not None else ""),
+            inner_pattern.append(
+                rf"(?:[^{_escape_regex_range_chars(self.end_quote_char[0])}\n\r"
+                rf"{(_escape_regex_range_chars(esc_char) if self.has_esc_char else '')}])"
             )
 
         self.pattern = "".join(
             [
-                re.escape(self.quoteChar),
+                re.escape(self.quote_char),
                 "(?:",
-                inner_pattern,
+                '|'.join(inner_pattern),
                 ")*",
-                re.escape(self.endQuoteChar),
+                re.escape(self.end_quote_char),
             ]
         )
 
+        if self.unquote_results:
+            if self.convert_whitespace_escapes:
+                self.unquote_scan_re = re.compile(
+                    rf"({'|'.join(re.escape(k) for k in self.ws_map)})"
+                    rf"|({re.escape(self.esc_char)}.)"
+                    rf"|(\n|.)",
+                    flags=self.re_flags,
+                )
+            else:
+                self.unquote_scan_re = re.compile(
+                    rf"({re.escape(self.esc_char)}.)"
+                    rf"|(\n|.)",
+                    flags=self.re_flags
+                )
+        # fmt: on
+
         try:
-            self.re = re.compile(self.pattern, self.flags)
+            self.re = re.compile(self.pattern, self.re_flags)
             self.reString = self.pattern
             self.re_match = self.re.match
         except re.error:
-            raise ValueError(
-                "invalid pattern {!r} passed to Regex".format(self.pattern)
-            )
+            raise ValueError(f"invalid pattern {self.pattern!r} passed to Regex")
 
         self.errmsg = "Expected " + self.name
         self.mayIndexError = False
         self.mayReturnEmpty = True
 
-    def _generateDefaultName(self):
-        if self.quoteChar == self.endQuoteChar and isinstance(self.quoteChar, str_type):
-            return "string enclosed in {!r}".format(self.quoteChar)
+    def _generateDefaultName(self) -> str:
+        if self.quote_char == self.end_quote_char and isinstance(
+            self.quote_char, str_type
+        ):
+            return f"string enclosed in {self.quote_char!r}"
 
-        return "quoted string, starting with {} ending with {}".format(
-            self.quoteChar, self.endQuoteChar
-        )
+        return f"quoted string, starting with {self.quote_char} ending with {self.end_quote_char}"
 
     def parseImpl(self, instring, loc, doActions=True):
+        # check first character of opening quote to see if that is a match
+        # before doing the more complicated regex match
         result = (
-            instring[loc] == self.firstQuoteChar
+            instring[loc] == self.first_quote_char
             and self.re_match(instring, loc)
             or None
         )
         if not result:
             raise ParseException(instring, loc, self.errmsg, self)
 
+        # get ending loc and matched string from regex matching result
         loc = result.end()
         ret = result.group()
 
-        if self.unquoteResults:
-
+        if self.unquote_results:
             # strip off quotes
-            ret = ret[self.quoteCharLen : -self.endQuoteCharLen]
+            ret = ret[self.quote_char_len : -self.end_quote_char_len]
 
             if isinstance(ret, str_type):
-                # replace escaped whitespace
-                if "\\" in ret and self.convertWhitespaceEscapes:
-                    for wslit, wschar in self.ws_map:
-                        ret = ret.replace(wslit, wschar)
-
-                # replace escaped characters
-                if self.escChar:
-                    ret = re.sub(self.escCharReplacePattern, r"\g<1>", ret)
+                # fmt: off
+                if self.convert_whitespace_escapes:
+                    # as we iterate over matches in the input string,
+                    # collect from whichever match group of the unquote_scan_re
+                    # regex matches (only 1 group will match at any given time)
+                    ret = "".join(
+                        # match group 1 matches \t, \n, etc.
+                        self.ws_map[match.group(1)] if match.group(1)
+                        # match group 2 matches escaped characters
+                        else match.group(2)[-1] if match.group(2)
+                        # match group 3 matches any character
+                        else match.group(3)
+                        for match in self.unquote_scan_re.finditer(ret)
+                    )
+                else:
+                    ret = "".join(
+                        # match group 1 matches escaped characters
+                        match.group(1)[-1] if match.group(1)
+                        # match group 2 matches any character
+                        else match.group(2)
+                        for match in self.unquote_scan_re.finditer(ret)
+                    )
+                # fmt: on
 
                 # replace escaped quotes
-                if self.escQuote:
-                    ret = ret.replace(self.escQuote, self.endQuoteChar)
+                if self.esc_quote:
+                    ret = ret.replace(self.esc_quote, self.end_quote_char)
 
         return loc, ret
 
@@ -3252,7 +3405,7 @@ class CharsNotIn(Token):
 
         # define a comma-separated-value as anything that is not a ','
         csv_value = CharsNotIn(',')
-        print(delimited_list(csv_value).parse_string("dkls,lsdkjf,s12 34,@!#,213"))
+        print(DelimitedList(csv_value).parse_string("dkls,lsdkjf,s12 34,@!#,213"))
 
     prints::
 
@@ -3294,12 +3447,12 @@ class CharsNotIn(Token):
         self.mayReturnEmpty = self.minLen == 0
         self.mayIndexError = False
 
-    def _generateDefaultName(self):
+    def _generateDefaultName(self) -> str:
         not_chars_str = _collapse_string_to_ranges(self.notChars)
         if len(not_chars_str) > 16:
-            return "!W:({}...)".format(self.notChars[: 16 - 3])
+            return f"!W:({self.notChars[: 16 - 3]}...)"
         else:
-            return "!W:({})".format(self.notChars)
+            return f"!W:({self.notChars})"
 
     def parseImpl(self, instring, loc, doActions=True):
         notchars = self.notCharsSet
@@ -3376,7 +3529,7 @@ class White(Token):
             self.maxLen = exact
             self.minLen = exact
 
-    def _generateDefaultName(self):
+    def _generateDefaultName(self) -> str:
         return "".join(White.whiteStrs[c] for c in self.matchWhite)
 
     def parseImpl(self, instring, loc, doActions=True):
@@ -3411,7 +3564,7 @@ class GoToColumn(PositionToken):
         super().__init__()
         self.col = colno
 
-    def preParse(self, instring, loc):
+    def preParse(self, instring: str, loc: int) -> int:
         if col(loc, instring) != self.col:
             instrlen = len(instring)
             if self.ignoreExprs:
@@ -3446,7 +3599,7 @@ class LineStart(PositionToken):
         B AAA and definitely not this one
         '''
 
-        for t in (LineStart() + 'AAA' + restOfLine).search_string(test):
+        for t in (LineStart() + 'AAA' + rest_of_line).search_string(test):
             print(t)
 
     prints::
@@ -3464,7 +3617,7 @@ class LineStart(PositionToken):
         self.skipper = Empty().set_whitespace_chars(self.whiteChars)
         self.errmsg = "Expected start of line"
 
-    def preParse(self, instring, loc):
+    def preParse(self, instring: str, loc: int) -> int:
         if loc == 0:
             return loc
         else:
@@ -3624,7 +3777,7 @@ class ParseExpression(ParserElement):
                 self.exprs = [exprs]
         self.callPreparse = False
 
-    def recurse(self) -> Sequence[ParserElement]:
+    def recurse(self) -> List[ParserElement]:
         return self.exprs[:]
 
     def append(self, other) -> ParserElement:
@@ -3669,8 +3822,8 @@ class ParseExpression(ParserElement):
                 e.ignore(self.ignoreExprs[-1])
         return self
 
-    def _generateDefaultName(self):
-        return "{}:({})".format(self.__class__.__name__, str(self.exprs))
+    def _generateDefaultName(self) -> str:
+        return f"{self.__class__.__name__}:({str(self.exprs)})"
 
     def streamline(self) -> ParserElement:
         if self.streamlined:
@@ -3714,6 +3867,11 @@ class ParseExpression(ParserElement):
         return self
 
     def validate(self, validateTrace=None) -> None:
+        warnings.warn(
+            "ParserElement.validate() is deprecated, and should not be used to check for left recursion",
+            DeprecationWarning,
+            stacklevel=2,
+        )
         tmp = (validateTrace if validateTrace is not None else [])[:] + [self]
         for e in self.exprs:
             e.validate(tmp)
@@ -3721,6 +3879,7 @@ class ParseExpression(ParserElement):
 
     def copy(self) -> ParserElement:
         ret = super().copy()
+        ret = typing.cast(ParseExpression, ret)
         ret.exprs = [e.copy() for e in self.exprs]
         return ret
 
@@ -3750,8 +3909,14 @@ class ParseExpression(ParserElement):
 
         return super()._setResultsName(name, listAllMatches)
 
-    ignoreWhitespace = ignore_whitespace
-    leaveWhitespace = leave_whitespace
+    # Compatibility synonyms
+    # fmt: off
+    @replaced_by_pep8(leave_whitespace)
+    def leaveWhitespace(self): ...
+
+    @replaced_by_pep8(ignore_whitespace)
+    def ignoreWhitespace(self): ...
+    # fmt: on
 
 
 class And(ParseExpression):
@@ -3777,7 +3942,7 @@ class And(ParseExpression):
             super().__init__(*args, **kwargs)
             self.leave_whitespace()
 
-        def _generateDefaultName(self):
+        def _generateDefaultName(self) -> str:
             return "-"
 
     def __init__(
@@ -3789,7 +3954,9 @@ class And(ParseExpression):
             for i, expr in enumerate(exprs):
                 if expr is Ellipsis:
                     if i < len(exprs) - 1:
-                        skipto_arg: ParserElement = (Empty() + exprs[i + 1]).exprs[-1]
+                        skipto_arg: ParserElement = typing.cast(
+                            ParseExpression, (Empty() + exprs[i + 1])
+                        ).exprs[-1]
                         tmp.append(SkipTo(skipto_arg)("_skipped*"))
                     else:
                         raise Exception(
@@ -3822,8 +3989,9 @@ class And(ParseExpression):
                 and isinstance(e.exprs[-1], _PendingSkip)
                 for e in self.exprs[:-1]
             ):
+                deleted_expr_marker = NoMatch()
                 for i, e in enumerate(self.exprs[:-1]):
-                    if e is None:
+                    if e is deleted_expr_marker:
                         continue
                     if (
                         isinstance(e, ParseExpression)
@@ -3831,17 +3999,19 @@ class And(ParseExpression):
                         and isinstance(e.exprs[-1], _PendingSkip)
                     ):
                         e.exprs[-1] = e.exprs[-1] + self.exprs[i + 1]
-                        self.exprs[i + 1] = None
-                self.exprs = [e for e in self.exprs if e is not None]
+                        self.exprs[i + 1] = deleted_expr_marker
+                self.exprs = [e for e in self.exprs if e is not deleted_expr_marker]
 
         super().streamline()
 
         # link any IndentedBlocks to the prior expression
+        prev: ParserElement
+        cur: ParserElement
         for prev, cur in zip(self.exprs, self.exprs[1:]):
             # traverse cur or any first embedded expr of cur looking for an IndentedBlock
             # (but watch out for recursive grammar)
             seen = set()
-            while cur:
+            while True:
                 if id(cur) in seen:
                     break
                 seen.add(id(cur))
@@ -3853,7 +4023,10 @@ class And(ParseExpression):
                     )
                     break
                 subs = cur.recurse()
-                cur = next(iter(subs), None)
+                next_first = next(iter(subs), None)
+                if next_first is None:
+                    break
+                cur = typing.cast(ParserElement, next_first)
 
         self.mayReturnEmpty = all(e.mayReturnEmpty for e in self.exprs)
         return self
@@ -3884,13 +4057,14 @@ class And(ParseExpression):
                     )
             else:
                 loc, exprtokens = e._parse(instring, loc, doActions)
-            if exprtokens or exprtokens.haskeys():
-                resultlist += exprtokens
+            resultlist += exprtokens
         return loc, resultlist
 
     def __iadd__(self, other):
         if isinstance(other, str_type):
             other = self._literalStringClass(other)
+        if not isinstance(other, ParserElement):
+            return NotImplemented
         return self.append(other)  # And([self, other])
 
     def _checkRecursion(self, parseElementList):
@@ -3900,7 +4074,7 @@ class And(ParseExpression):
             if not e.mayReturnEmpty:
                 break
 
-    def _generateDefaultName(self):
+    def _generateDefaultName(self) -> str:
         inner = " ".join(str(e) for e in self.exprs)
         # strip off redundant inner {}'s
         while len(inner) > 1 and inner[0 :: len(inner) - 1] == "{}":
@@ -3958,7 +4132,7 @@ class Or(ParseExpression):
                 loc2 = e.try_parse(instring, loc, raise_fatal=True)
             except ParseFatalException as pfe:
                 pfe.__traceback__ = None
-                pfe.parserElement = e
+                pfe.parser_element = e
                 fatals.append(pfe)
                 maxException = None
                 maxExcLoc = -1
@@ -4016,12 +4190,15 @@ class Or(ParseExpression):
             if len(fatals) > 1:
                 fatals.sort(key=lambda e: -e.loc)
                 if fatals[0].loc == fatals[1].loc:
-                    fatals.sort(key=lambda e: (-e.loc, -len(str(e.parserElement))))
+                    fatals.sort(key=lambda e: (-e.loc, -len(str(e.parser_element))))
             max_fatal = fatals[0]
             raise max_fatal
 
         if maxException is not None:
-            maxException.msg = self.errmsg
+            # infer from this check that all alternatives failed at the current position
+            # so emit this collective error message instead of any single error message
+            if maxExcLoc == loc:
+                maxException.msg = self.errmsg
             raise maxException
         else:
             raise ParseException(
@@ -4031,9 +4208,11 @@ class Or(ParseExpression):
     def __ixor__(self, other):
         if isinstance(other, str_type):
             other = self._literalStringClass(other)
+        if not isinstance(other, ParserElement):
+            return NotImplemented
         return self.append(other)  # Or([self, other])
 
-    def _generateDefaultName(self):
+    def _generateDefaultName(self) -> str:
         return "{" + " ^ ".join(str(e) for e in self.exprs) + "}"
 
     def _setResultsName(self, name, listAllMatches=False):
@@ -4118,7 +4297,7 @@ class MatchFirst(ParseExpression):
                 )
             except ParseFatalException as pfe:
                 pfe.__traceback__ = None
-                pfe.parserElement = e
+                pfe.parser_element = e
                 raise
             except ParseException as err:
                 if err.loc > maxExcLoc:
@@ -4132,7 +4311,10 @@ class MatchFirst(ParseExpression):
                     maxExcLoc = len(instring)
 
         if maxException is not None:
-            maxException.msg = self.errmsg
+            # infer from this check that all alternatives failed at the current position
+            # so emit this collective error message instead of any individual error message
+            if maxExcLoc == loc:
+                maxException.msg = self.errmsg
             raise maxException
         else:
             raise ParseException(
@@ -4142,9 +4324,11 @@ class MatchFirst(ParseExpression):
     def __ior__(self, other):
         if isinstance(other, str_type):
             other = self._literalStringClass(other)
+        if not isinstance(other, ParserElement):
+            return NotImplemented
         return self.append(other)  # MatchFirst([self, other])
 
-    def _generateDefaultName(self):
+    def _generateDefaultName(self) -> str:
         return "{" + " | ".join(str(e) for e in self.exprs) + "}"
 
     def _setResultsName(self, name, listAllMatches=False):
@@ -4242,6 +4426,13 @@ class Each(ParseExpression):
         self.initExprGroups = True
         self.saveAsList = True
 
+    def __iand__(self, other):
+        if isinstance(other, str_type):
+            other = self._literalStringClass(other)
+        if not isinstance(other, ParserElement):
+            return NotImplemented
+        return self.append(other)  # Each([self, other])
+
     def streamline(self) -> ParserElement:
         super().streamline()
         if self.exprs:
@@ -4296,7 +4487,7 @@ class Each(ParseExpression):
                     tmpLoc = e.try_parse(instring, tmpLoc, raise_fatal=True)
                 except ParseFatalException as pfe:
                     pfe.__traceback__ = None
-                    pfe.parserElement = e
+                    pfe.parser_element = e
                     fatals.append(pfe)
                     failed.append(e)
                 except ParseException:
@@ -4315,7 +4506,7 @@ class Each(ParseExpression):
             if len(fatals) > 1:
                 fatals.sort(key=lambda e: -e.loc)
                 if fatals[0].loc == fatals[1].loc:
-                    fatals.sort(key=lambda e: (-e.loc, -len(str(e.parserElement))))
+                    fatals.sort(key=lambda e: (-e.loc, -len(str(e.parser_element))))
             max_fatal = fatals[0]
             raise max_fatal
 
@@ -4324,7 +4515,7 @@ class Each(ParseExpression):
             raise ParseException(
                 instring,
                 loc,
-                "Missing one or more required elements ({})".format(missing),
+                f"Missing one or more required elements ({missing})",
             )
 
         # add any unmatched Opts, in case they have default values defined
@@ -4337,7 +4528,7 @@ class Each(ParseExpression):
 
         return loc, total_results
 
-    def _generateDefaultName(self):
+    def _generateDefaultName(self) -> str:
         return "{" + " & ".join(str(e) for e in self.exprs) + "}"
 
 
@@ -4349,12 +4540,14 @@ class ParseElementEnhance(ParserElement):
     def __init__(self, expr: Union[ParserElement, str], savelist: bool = False):
         super().__init__(savelist)
         if isinstance(expr, str_type):
+            expr_str = typing.cast(str, expr)
             if issubclass(self._literalStringClass, Token):
-                expr = self._literalStringClass(expr)
+                expr = self._literalStringClass(expr_str)  # type: ignore[call-arg]
             elif issubclass(type(self), self._literalStringClass):
-                expr = Literal(expr)
+                expr = Literal(expr_str)
             else:
-                expr = self._literalStringClass(Literal(expr))
+                expr = self._literalStringClass(Literal(expr_str))  # type: ignore[assignment, call-arg]
+        expr = typing.cast(ParserElement, expr)
         self.expr = expr
         if expr is not None:
             self.mayIndexError = expr.mayIndexError
@@ -4367,12 +4560,17 @@ class ParseElementEnhance(ParserElement):
             self.callPreparse = expr.callPreparse
             self.ignoreExprs.extend(expr.ignoreExprs)
 
-    def recurse(self) -> Sequence[ParserElement]:
+    def recurse(self) -> List[ParserElement]:
         return [self.expr] if self.expr is not None else []
 
     def parseImpl(self, instring, loc, doActions=True):
         if self.expr is not None:
-            return self.expr._parse(instring, loc, doActions, callPreParse=False)
+            try:
+                return self.expr._parse(instring, loc, doActions, callPreParse=False)
+            except ParseBaseException as pbe:
+                if not isinstance(self, Forward) or self.customName is not None:
+                    pbe.msg = self.errmsg
+                raise
         else:
             raise ParseException(instring, loc, "No expression defined", self)
 
@@ -4380,8 +4578,8 @@ class ParseElementEnhance(ParserElement):
         super().leave_whitespace(recursive)
 
         if recursive:
-            self.expr = self.expr.copy()
             if self.expr is not None:
+                self.expr = self.expr.copy()
                 self.expr.leave_whitespace(recursive)
         return self
 
@@ -4389,8 +4587,8 @@ class ParseElementEnhance(ParserElement):
         super().ignore_whitespace(recursive)
 
         if recursive:
-            self.expr = self.expr.copy()
             if self.expr is not None:
+                self.expr = self.expr.copy()
                 self.expr.ignore_whitespace(recursive)
         return self
 
@@ -4420,6 +4618,11 @@ class ParseElementEnhance(ParserElement):
             self.expr._checkRecursion(subRecCheckList)
 
     def validate(self, validateTrace=None) -> None:
+        warnings.warn(
+            "ParserElement.validate() is deprecated, and should not be used to check for left recursion",
+            DeprecationWarning,
+            stacklevel=2,
+        )
         if validateTrace is None:
             validateTrace = []
         tmp = validateTrace[:] + [self]
@@ -4427,11 +4630,17 @@ class ParseElementEnhance(ParserElement):
             self.expr.validate(tmp)
         self._checkRecursion([])
 
-    def _generateDefaultName(self):
-        return "{}:({})".format(self.__class__.__name__, str(self.expr))
+    def _generateDefaultName(self) -> str:
+        return f"{self.__class__.__name__}:({str(self.expr)})"
 
-    ignoreWhitespace = ignore_whitespace
-    leaveWhitespace = leave_whitespace
+    # Compatibility synonyms
+    # fmt: off
+    @replaced_by_pep8(leave_whitespace)
+    def leaveWhitespace(self): ...
+
+    @replaced_by_pep8(ignore_whitespace)
+    def ignoreWhitespace(self): ...
+    # fmt: on
 
 
 class IndentedBlock(ParseElementEnhance):
@@ -4443,13 +4652,13 @@ class IndentedBlock(ParseElementEnhance):
     class _Indent(Empty):
         def __init__(self, ref_col: int):
             super().__init__()
-            self.errmsg = "expected indent at column {}".format(ref_col)
+            self.errmsg = f"expected indent at column {ref_col}"
             self.add_condition(lambda s, l, t: col(l, s) == ref_col)
 
     class _IndentGreater(Empty):
         def __init__(self, ref_col: int):
             super().__init__()
-            self.errmsg = "expected indent at column greater than {}".format(ref_col)
+            self.errmsg = f"expected indent at column greater than {ref_col}"
             self.add_condition(lambda s, l, t: col(l, s) > ref_col)
 
     def __init__(
@@ -4469,7 +4678,7 @@ class IndentedBlock(ParseElementEnhance):
 
         # see if self.expr matches at the current location - if not it will raise an exception
         # and no further work is necessary
-        self.expr.try_parse(instring, anchor_loc, doActions)
+        self.expr.try_parse(instring, anchor_loc, do_actions=doActions)
 
         indent_col = col(anchor_loc, instring)
         peer_detect_expr = self._Indent(indent_col)
@@ -4532,7 +4741,7 @@ class AtLineStart(ParseElementEnhance):
         B AAA and definitely not this one
         '''
 
-        for t in (AtLineStart('AAA') + restOfLine).search_string(test):
+        for t in (AtLineStart('AAA') + rest_of_line).search_string(test):
             print(t)
 
     prints::
@@ -4598,9 +4807,9 @@ class PrecededBy(ParseElementEnhance):
 
     Parameters:
 
-    - expr - expression that must match prior to the current parse
+    - ``expr`` - expression that must match prior to the current parse
       location
-    - retreat - (default= ``None``) - (int) maximum number of characters
+    - ``retreat`` - (default= ``None``) - (int) maximum number of characters
       to lookbehind prior to the current parse location
 
     If the lookbehind expression is a string, :class:`Literal`,
@@ -4627,6 +4836,7 @@ class PrecededBy(ParseElementEnhance):
         self.mayIndexError = False
         self.exact = False
         if isinstance(expr, str_type):
+            expr = typing.cast(str, expr)
             retreat = len(expr)
             self.exact = True
         elif isinstance(expr, (Literal, Keyword)):
@@ -4746,18 +4956,18 @@ class NotAny(ParseElementEnhance):
         self.errmsg = "Found unwanted token, " + str(self.expr)
 
     def parseImpl(self, instring, loc, doActions=True):
-        if self.expr.can_parse_next(instring, loc):
+        if self.expr.can_parse_next(instring, loc, do_actions=doActions):
             raise ParseException(instring, loc, self.errmsg, self)
         return loc, []
 
-    def _generateDefaultName(self):
+    def _generateDefaultName(self) -> str:
         return "~{" + str(self.expr) + "}"
 
 
 class _MultipleMatch(ParseElementEnhance):
     def __init__(
         self,
-        expr: ParserElement,
+        expr: Union[str, ParserElement],
         stop_on: typing.Optional[Union[ParserElement, str]] = None,
         *,
         stopOn: typing.Optional[Union[ParserElement, str]] = None,
@@ -4781,7 +4991,7 @@ class _MultipleMatch(ParseElementEnhance):
         self_skip_ignorables = self._skipIgnorables
         check_ender = self.not_ender is not None
         if check_ender:
-            try_not_ender = self.not_ender.tryParse
+            try_not_ender = self.not_ender.try_parse
 
         # must be at least one (but first see if we are the stopOn sentinel;
         # if so, fail)
@@ -4798,8 +5008,7 @@ class _MultipleMatch(ParseElementEnhance):
                 else:
                     preloc = loc
                 loc, tmptokens = self_expr_parse(instring, preloc, doActions)
-                if tmptokens or tmptokens.haskeys():
-                    tokens += tmptokens
+                tokens += tmptokens
         except (ParseException, IndexError):
             pass
 
@@ -4837,10 +5046,11 @@ class OneOrMore(_MultipleMatch):
     Repetition of one or more of the given expression.
 
     Parameters:
-    - expr - expression that must match one or more times
-    - stop_on - (default= ``None``) - expression for a terminating sentinel
-         (only required if the sentinel would ordinarily match the repetition
-         expression)
+
+    - ``expr`` - expression that must match one or more times
+    - ``stop_on`` - (default= ``None``) - expression for a terminating sentinel
+      (only required if the sentinel would ordinarily match the repetition
+      expression)
 
     Example::
 
@@ -4859,7 +5069,7 @@ class OneOrMore(_MultipleMatch):
         (attr_expr * (1,)).parse_string(text).pprint()
     """
 
-    def _generateDefaultName(self):
+    def _generateDefaultName(self) -> str:
         return "{" + str(self.expr) + "}..."
 
 
@@ -4868,6 +5078,7 @@ class ZeroOrMore(_MultipleMatch):
     Optional repetition of zero or more of the given expression.
 
     Parameters:
+
     - ``expr`` - expression that must match zero or more times
     - ``stop_on`` - expression for a terminating sentinel
       (only required if the sentinel would ordinarily match the repetition
@@ -4878,7 +5089,7 @@ class ZeroOrMore(_MultipleMatch):
 
     def __init__(
         self,
-        expr: ParserElement,
+        expr: Union[str, ParserElement],
         stop_on: typing.Optional[Union[ParserElement, str]] = None,
         *,
         stopOn: typing.Optional[Union[ParserElement, str]] = None,
@@ -4892,10 +5103,75 @@ class ZeroOrMore(_MultipleMatch):
         except (ParseException, IndexError):
             return loc, ParseResults([], name=self.resultsName)
 
-    def _generateDefaultName(self):
+    def _generateDefaultName(self) -> str:
         return "[" + str(self.expr) + "]..."
 
 
+class DelimitedList(ParseElementEnhance):
+    def __init__(
+        self,
+        expr: Union[str, ParserElement],
+        delim: Union[str, ParserElement] = ",",
+        combine: bool = False,
+        min: typing.Optional[int] = None,
+        max: typing.Optional[int] = None,
+        *,
+        allow_trailing_delim: bool = False,
+    ):
+        """Helper to define a delimited list of expressions - the delimiter
+        defaults to ','. By default, the list elements and delimiters can
+        have intervening whitespace, and comments, but this can be
+        overridden by passing ``combine=True`` in the constructor. If
+        ``combine`` is set to ``True``, the matching tokens are
+        returned as a single token string, with the delimiters included;
+        otherwise, the matching tokens are returned as a list of tokens,
+        with the delimiters suppressed.
+
+        If ``allow_trailing_delim`` is set to True, then the list may end with
+        a delimiter.
+
+        Example::
+
+            DelimitedList(Word(alphas)).parse_string("aa,bb,cc") # -> ['aa', 'bb', 'cc']
+            DelimitedList(Word(hexnums), delim=':', combine=True).parse_string("AA:BB:CC:DD:EE") # -> ['AA:BB:CC:DD:EE']
+        """
+        if isinstance(expr, str_type):
+            expr = ParserElement._literalStringClass(expr)
+        expr = typing.cast(ParserElement, expr)
+
+        if min is not None:
+            if min < 1:
+                raise ValueError("min must be greater than 0")
+        if max is not None:
+            if min is not None and max < min:
+                raise ValueError("max must be greater than, or equal to min")
+
+        self.content = expr
+        self.raw_delim = str(delim)
+        self.delim = delim
+        self.combine = combine
+        if not combine:
+            self.delim = Suppress(delim)
+        self.min = min or 1
+        self.max = max
+        self.allow_trailing_delim = allow_trailing_delim
+
+        delim_list_expr = self.content + (self.delim + self.content) * (
+            self.min - 1,
+            None if self.max is None else self.max - 1,
+        )
+        if self.allow_trailing_delim:
+            delim_list_expr += Opt(self.delim)
+
+        if self.combine:
+            delim_list_expr = Combine(delim_list_expr)
+
+        super().__init__(delim_list_expr, savelist=True)
+
+    def _generateDefaultName(self) -> str:
+        return "{0} [{1} {0}]...".format(self.content.streamline(), self.raw_delim)
+
+
 class _NullToken:
     def __bool__(self):
         return False
@@ -4909,6 +5185,7 @@ class Opt(ParseElementEnhance):
     Optional matching of the given expression.
 
     Parameters:
+
     - ``expr`` - expression that must match zero or more times
     - ``default`` (optional) - value to be returned if the optional expression is not found.
 
@@ -4969,7 +5246,7 @@ class Opt(ParseElementEnhance):
                 tokens = []
         return loc, tokens
 
-    def _generateDefaultName(self):
+    def _generateDefaultName(self) -> str:
         inner = str(self.expr)
         # strip off redundant inner {}'s
         while len(inner) > 1 and inner[0 :: len(inner) - 1] == "{}":
@@ -4986,6 +5263,7 @@ class SkipTo(ParseElementEnhance):
     expression is found.
 
     Parameters:
+
     - ``expr`` - target expression marking the end of the data to be skipped
     - ``include`` - if ``True``, the target expression is also parsed
       (the skipped text and target expression are returned as a 2-element
@@ -5045,10 +5323,10 @@ class SkipTo(ParseElementEnhance):
         self,
         other: Union[ParserElement, str],
         include: bool = False,
-        ignore: bool = None,
+        ignore: typing.Optional[Union[ParserElement, str]] = None,
         fail_on: typing.Optional[Union[ParserElement, str]] = None,
         *,
-        failOn: Union[ParserElement, str] = None,
+        failOn: typing.Optional[Union[ParserElement, str]] = None,
     ):
         super().__init__(other)
         failOn = failOn or fail_on
@@ -5062,6 +5340,20 @@ class SkipTo(ParseElementEnhance):
         else:
             self.failOn = failOn
         self.errmsg = "No match found for " + str(self.expr)
+        self.ignorer = Empty().leave_whitespace()
+        self._update_ignorer()
+
+    def _update_ignorer(self):
+        # rebuild internal ignore expr from current ignore exprs and assigned ignoreExpr
+        self.ignorer.ignoreExprs.clear()
+        for e in self.expr.ignoreExprs:
+            self.ignorer.ignore(e)
+        if self.ignoreExpr:
+            self.ignorer.ignore(self.ignoreExpr)
+
+    def ignore(self, expr):
+        super().ignore(expr)
+        self._update_ignorer()
 
     def parseImpl(self, instring, loc, doActions=True):
         startloc = loc
@@ -5070,9 +5362,7 @@ class SkipTo(ParseElementEnhance):
         self_failOn_canParseNext = (
             self.failOn.canParseNext if self.failOn is not None else None
         )
-        self_ignoreExpr_tryParse = (
-            self.ignoreExpr.tryParse if self.ignoreExpr is not None else None
-        )
+        ignorer_try_parse = self.ignorer.try_parse if self.ignorer.ignoreExprs else None
 
         tmploc = loc
         while tmploc <= instrlen:
@@ -5081,13 +5371,18 @@ class SkipTo(ParseElementEnhance):
                 if self_failOn_canParseNext(instring, tmploc):
                     break
 
-            if self_ignoreExpr_tryParse is not None:
+            if ignorer_try_parse is not None:
                 # advance past ignore expressions
+                prev_tmploc = tmploc
                 while 1:
                     try:
-                        tmploc = self_ignoreExpr_tryParse(instring, tmploc)
+                        tmploc = ignorer_try_parse(instring, tmploc)
                     except ParseBaseException:
                         break
+                    # see if all ignorers matched, but didn't actually ignore anything
+                    if tmploc == prev_tmploc:
+                        break
+                    prev_tmploc = tmploc
 
             try:
                 self_expr_parse(instring, tmploc, doActions=False, callPreParse=False)
@@ -5145,15 +5440,20 @@ class Forward(ParseElementEnhance):
 
     def __init__(self, other: typing.Optional[Union[ParserElement, str]] = None):
         self.caller_frame = traceback.extract_stack(limit=2)[0]
-        super().__init__(other, savelist=False)
+        super().__init__(other, savelist=False)  # type: ignore[arg-type]
         self.lshift_line = None
 
-    def __lshift__(self, other):
+    def __lshift__(self, other) -> "Forward":
         if hasattr(self, "caller_frame"):
             del self.caller_frame
         if isinstance(other, str_type):
             other = self._literalStringClass(other)
+
+        if not isinstance(other, ParserElement):
+            return NotImplemented
+
         self.expr = other
+        self.streamlined = other.streamlined
         self.mayIndexError = self.expr.mayIndexError
         self.mayReturnEmpty = self.expr.mayReturnEmpty
         self.set_whitespace_chars(
@@ -5162,13 +5462,16 @@ class Forward(ParseElementEnhance):
         self.skipWhitespace = self.expr.skipWhitespace
         self.saveAsList = self.expr.saveAsList
         self.ignoreExprs.extend(self.expr.ignoreExprs)
-        self.lshift_line = traceback.extract_stack(limit=2)[-2]
+        self.lshift_line = traceback.extract_stack(limit=2)[-2]  # type: ignore[assignment]
         return self
 
-    def __ilshift__(self, other):
+    def __ilshift__(self, other) -> "Forward":
+        if not isinstance(other, ParserElement):
+            return NotImplemented
+
         return self << other
 
-    def __or__(self, other):
+    def __or__(self, other) -> "ParserElement":
         caller_line = traceback.extract_stack(limit=2)[-2]
         if (
             __diag__.warn_on_match_first_with_lshift_operator
@@ -5205,12 +5508,12 @@ class Forward(ParseElementEnhance):
             not in self.suppress_warnings_
         ):
             # walk stack until parse_string, scan_string, search_string, or transform_string is found
-            parse_fns = [
+            parse_fns = (
                 "parse_string",
                 "scan_string",
                 "search_string",
                 "transform_string",
-            ]
+            )
             tb = traceback.extract_stack(limit=200)
             for i, frm in enumerate(reversed(tb), start=1):
                 if frm.name in parse_fns:
@@ -5308,6 +5611,11 @@ class Forward(ParseElementEnhance):
         return self
 
     def validate(self, validateTrace=None) -> None:
+        warnings.warn(
+            "ParserElement.validate() is deprecated, and should not be used to check for left recursion",
+            DeprecationWarning,
+            stacklevel=2,
+        )
         if validateTrace is None:
             validateTrace = []
 
@@ -5317,7 +5625,7 @@ class Forward(ParseElementEnhance):
                 self.expr.validate(tmp)
         self._checkRecursion([])
 
-    def _generateDefaultName(self):
+    def _generateDefaultName(self) -> str:
         # Avoid infinite recursion by setting a temporary _defaultName
         self._defaultName = ": ..."
 
@@ -5356,8 +5664,14 @@ class Forward(ParseElementEnhance):
 
         return super()._setResultsName(name, list_all_matches)
 
-    ignoreWhitespace = ignore_whitespace
-    leaveWhitespace = leave_whitespace
+    # Compatibility synonyms
+    # fmt: off
+    @replaced_by_pep8(leave_whitespace)
+    def leaveWhitespace(self): ...
+
+    @replaced_by_pep8(ignore_whitespace)
+    def ignoreWhitespace(self): ...
+    # fmt: on
 
 
 class TokenConverter(ParseElementEnhance):
@@ -5439,11 +5753,11 @@ class Group(TokenConverter):
         ident = Word(alphas)
         num = Word(nums)
         term = ident | num
-        func = ident + Opt(delimited_list(term))
+        func = ident + Opt(DelimitedList(term))
         print(func.parse_string("fn a, b, 100"))
         # -> ['fn', 'a', 'b', '100']
 
-        func = ident + Group(Opt(delimited_list(term)))
+        func = ident + Group(Opt(DelimitedList(term)))
         print(func.parse_string("fn a, b, 100"))
         # -> ['fn', ['a', 'b', '100']]
     """
@@ -5579,7 +5893,7 @@ class Suppress(TokenConverter):
         ['a', 'b', 'c', 'd']
         ['START', 'relevant text ', 'END']
 
-    (See also :class:`delimited_list`.)
+    (See also :class:`DelimitedList`.)
     """
 
     def __init__(self, expr: Union[ParserElement, str], savelist: bool = False):
@@ -5638,15 +5952,13 @@ def trace_parse_action(f: ParseAction) -> ParseAction:
         s, l, t = paArgs[-3:]
         if len(paArgs) > 3:
             thisFunc = paArgs[0].__class__.__name__ + "." + thisFunc
-        sys.stderr.write(
-            ">>entering {}(line: {!r}, {}, {!r})\n".format(thisFunc, line(l, s), l, t)
-        )
+        sys.stderr.write(f">>entering {thisFunc}(line: {line(l, s)!r}, {l}, {t!r})\n")
         try:
             ret = f(*paArgs)
         except Exception as exc:
-            sys.stderr.write("<<leaving {} (exception: {})\n".format(thisFunc, exc))
+            sys.stderr.write(f"<<leaving {thisFunc} (exception: {exc})\n")
             raise
-        sys.stderr.write("<<leaving {} (ret: {!r})\n".format(thisFunc, ret))
+        sys.stderr.write(f"<<leaving {thisFunc} (ret: {ret!r})\n")
         return ret
 
     z.__name__ = f.__name__
@@ -5660,7 +5972,7 @@ line_end = LineEnd().set_name("line_end")
 string_start = StringStart().set_name("string_start")
 string_end = StringEnd().set_name("string_end")
 
-_escapedPunc = Word(_bslash, r"\[]-*.$+^?()~ ", exact=2).set_parse_action(
+_escapedPunc = Regex(r"\\[\\[\]\/\-\*\.\$\+\^\?()~ ]").set_parse_action(
     lambda s, l, t: t[0][1]
 )
 _escapedHexChar = Regex(r"\\0?[xX][0-9a-fA-F]+").set_parse_action(
@@ -5677,7 +5989,7 @@ _reBracketExpr = (
     Literal("[")
     + Opt("^").set_results_name("negate")
     + Group(OneOrMore(_charRange | _singleChar)).set_results_name("body")
-    + "]"
+    + Literal("]")
 )
 
 
@@ -5714,7 +6026,7 @@ def srange(s: str) -> str:
     )
     try:
         return "".join(_expanded(part) for part in _reBracketExpr.parse_string(s).body)
-    except Exception:
+    except Exception as e:
         return ""
 
 
@@ -5769,7 +6081,11 @@ def autoname_elements() -> None:
     Utility to simplify mass-naming of parser elements, for
     generating railroad diagram with named subdiagrams.
     """
-    for name, var in sys._getframe().f_back.f_locals.items():
+    calling_frame = sys._getframe().f_back
+    if calling_frame is None:
+        return
+    calling_frame = typing.cast(types.FrameType, calling_frame)
+    for name, var in calling_frame.f_locals.items():
         if isinstance(var, ParserElement) and not var.customName:
             var.set_name(name)
 
@@ -5783,9 +6099,28 @@ sgl_quoted_string = Combine(
 ).set_name("string enclosed in single quotes")
 
 quoted_string = Combine(
-    Regex(r'"(?:[^"\n\r\\]|(?:"")|(?:\\(?:[^x]|x[0-9a-fA-F]+)))*') + '"'
-    | Regex(r"'(?:[^'\n\r\\]|(?:'')|(?:\\(?:[^x]|x[0-9a-fA-F]+)))*") + "'"
-).set_name("quotedString using single or double quotes")
+    (Regex(r'"(?:[^"\n\r\\]|(?:"")|(?:\\(?:[^x]|x[0-9a-fA-F]+)))*') + '"').set_name(
+        "double quoted string"
+    )
+    | (Regex(r"'(?:[^'\n\r\\]|(?:'')|(?:\\(?:[^x]|x[0-9a-fA-F]+)))*") + "'").set_name(
+        "single quoted string"
+    )
+).set_name("quoted string using single or double quotes")
+
+python_quoted_string = Combine(
+    (Regex(r'"""(?:[^"\\]|""(?!")|"(?!"")|\\.)*', flags=re.MULTILINE) + '"""').set_name(
+        "multiline double quoted string"
+    )
+    ^ (
+        Regex(r"'''(?:[^'\\]|''(?!')|'(?!'')|\\.)*", flags=re.MULTILINE) + "'''"
+    ).set_name("multiline single quoted string")
+    ^ (Regex(r'"(?:[^"\n\r\\]|(?:\\")|(?:\\(?:[^x]|x[0-9a-fA-F]+)))*') + '"').set_name(
+        "double quoted string"
+    )
+    ^ (Regex(r"'(?:[^'\n\r\\]|(?:\\')|(?:\\(?:[^x]|x[0-9a-fA-F]+)))*") + "'").set_name(
+        "single quoted string"
+    )
+).set_name("Python quoted string")
 
 unicode_string = Combine("u" + quoted_string.copy()).set_name("unicode string literal")
 
@@ -5800,9 +6135,7 @@ _builtin_exprs: List[ParserElement] = [
 ]
 
 # backward compatibility names
-tokenMap = token_map
-conditionAsParseAction = condition_as_parse_action
-nullDebugAction = null_debug_action
+# fmt: off
 sglQuotedString = sgl_quoted_string
 dblQuotedString = dbl_quoted_string
 quotedString = quoted_string
@@ -5811,4 +6144,16 @@ lineStart = line_start
 lineEnd = line_end
 stringStart = string_start
 stringEnd = string_end
-traceParseAction = trace_parse_action
+
+@replaced_by_pep8(null_debug_action)
+def nullDebugAction(): ...
+
+@replaced_by_pep8(trace_parse_action)
+def traceParseAction(): ...
+
+@replaced_by_pep8(condition_as_parse_action)
+def conditionAsParseAction(): ...
+
+@replaced_by_pep8(token_map)
+def tokenMap(): ...
+# fmt: on
diff --git a/lib/pyparsing/diagram/__init__.py b/lib/pyparsing/diagram/__init__.py
index 89864475..267f3447 100644
--- a/lib/pyparsing/diagram/__init__.py
+++ b/lib/pyparsing/diagram/__init__.py
@@ -1,3 +1,4 @@
+# mypy: ignore-errors
 import railroad
 import pyparsing
 import typing
@@ -17,11 +18,13 @@ import inspect
 
 
 jinja2_template_source = """\
+{% if not embed %}
 <!DOCTYPE html>
 <html>
 <head>
+{% endif %}
     {% if not head %}
-        <style type="text/css">
+        <style>
             .railroad-heading {
                 font-family: monospace;
             }
@@ -29,8 +32,10 @@ jinja2_template_source = """\
     {% else %}
         {{ head | safe }}
     {% endif %}
+{% if not embed %}
 </head>
 <body>
+{% endif %}
 {{ body | safe }}
 {% for diagram in diagrams %}
     <div class="railroad-group">
@@ -41,8 +46,10 @@ jinja2_template_source = """\
         </div>
     </div>
 {% endfor %}
+{% if not embed %}
 </body>
 </html>
+{% endif %}
 """
 
 template = Template(jinja2_template_source)
@@ -127,7 +134,7 @@ class EditablePartial(Generic[T]):
         return self.func(*args, **kwargs)
 
 
-def railroad_to_html(diagrams: List[NamedDiagram], **kwargs) -> str:
+def railroad_to_html(diagrams: List[NamedDiagram], embed=False, **kwargs) -> str:
     """
     Given a list of NamedDiagram, produce a single HTML string that visualises those diagrams
     :params kwargs: kwargs to be passed in to the template
@@ -137,13 +144,17 @@ def railroad_to_html(diagrams: List[NamedDiagram], **kwargs) -> str:
         if diagram.diagram is None:
             continue
         io = StringIO()
-        diagram.diagram.writeSvg(io.write)
+        try:
+            css = kwargs.get('css')
+            diagram.diagram.writeStandalone(io.write, css=css)
+        except AttributeError:
+            diagram.diagram.writeSvg(io.write)
         title = diagram.name
         if diagram.index == 0:
             title += " (root)"
         data.append({"title": title, "text": "", "svg": io.getvalue()})
 
-    return template.render(diagrams=data, **kwargs)
+    return template.render(diagrams=data, embed=embed, **kwargs)
 
 
 def resolve_partial(partial: "EditablePartial[T]") -> T:
@@ -398,7 +409,6 @@ def _apply_diagram_item_enhancements(fn):
         show_results_names: bool = False,
         show_groups: bool = False,
     ) -> typing.Optional[EditablePartial]:
-
         ret = fn(
             element,
             parent,
@@ -555,9 +565,11 @@ def _to_diagram_element(
         else:
             ret = EditablePartial.from_call(railroad.Group, label="", item="")
     elif isinstance(element, pyparsing.TokenConverter):
-        ret = EditablePartial.from_call(
-            AnnotatedItem, label=type(element).__name__.lower(), item=""
-        )
+        label = type(element).__name__.lower()
+        if label == "tokenconverter":
+            ret = EditablePartial.from_call(railroad.Sequence, items=[])
+        else:
+            ret = EditablePartial.from_call(AnnotatedItem, label=label, item="")
     elif isinstance(element, pyparsing.Opt):
         ret = EditablePartial.from_call(railroad.Optional, item="")
     elif isinstance(element, pyparsing.OneOrMore):
@@ -571,10 +583,12 @@ def _to_diagram_element(
     elif isinstance(element, pyparsing.Empty) and not element.customName:
         # Skip unnamed "Empty" elements
         ret = None
-    elif len(exprs) > 1:
+    elif isinstance(element, pyparsing.ParseElementEnhance):
         ret = EditablePartial.from_call(railroad.Sequence, items=[])
     elif len(exprs) > 0 and not element_results_name:
         ret = EditablePartial.from_call(railroad.Group, item="", label=name)
+    elif len(exprs) > 0:
+        ret = EditablePartial.from_call(railroad.Sequence, items=[])
     else:
         terminal = EditablePartial.from_call(railroad.Terminal, element.defaultName)
         ret = terminal
diff --git a/lib/pyparsing/exceptions.py b/lib/pyparsing/exceptions.py
index a38447bb..12219f12 100644
--- a/lib/pyparsing/exceptions.py
+++ b/lib/pyparsing/exceptions.py
@@ -4,7 +4,13 @@ import re
 import sys
 import typing
 
-from .util import col, line, lineno, _collapse_string_to_ranges
+from .util import (
+    col,
+    line,
+    lineno,
+    _collapse_string_to_ranges,
+    replaced_by_pep8,
+)
 from .unicode import pyparsing_unicode as ppu
 
 
@@ -19,6 +25,20 @@ _exception_word_extractor = re.compile("([" + _extract_alphanums + "]{1,16})|.")
 class ParseBaseException(Exception):
     """base exception class for all parsing runtime exceptions"""
 
+    loc: int
+    msg: str
+    pstr: str
+    parser_element: typing.Any  # "ParserElement"
+    args: typing.Tuple[str, int, typing.Optional[str]]
+
+    __slots__ = (
+        "loc",
+        "msg",
+        "pstr",
+        "parser_element",
+        "args",
+    )
+
     # Performance tuning: we construct a *lot* of these, so keep this
     # constructor as small and fast as possible
     def __init__(
@@ -35,7 +55,7 @@ class ParseBaseException(Exception):
         else:
             self.msg = msg
             self.pstr = pstr
-        self.parser_element = self.parserElement = elem
+        self.parser_element = elem
         self.args = (pstr, loc, msg)
 
     @staticmethod
@@ -64,7 +84,7 @@ class ParseBaseException(Exception):
         if isinstance(exc, ParseBaseException):
             ret.append(exc.line)
             ret.append(" " * (exc.column - 1) + "^")
-        ret.append("{}: {}".format(type(exc).__name__, exc))
+        ret.append(f"{type(exc).__name__}: {exc}")
 
         if depth > 0:
             callers = inspect.getinnerframes(exc.__traceback__, context=depth)
@@ -74,7 +94,9 @@ class ParseBaseException(Exception):
 
                 f_self = frm.f_locals.get("self", None)
                 if isinstance(f_self, ParserElement):
-                    if frm.f_code.co_name not in ("parseImpl", "_parseNoCache"):
+                    if not frm.f_code.co_name.startswith(
+                        ("parseImpl", "_parseNoCache")
+                    ):
                         continue
                     if id(f_self) in seen:
                         continue
@@ -82,21 +104,19 @@ class ParseBaseException(Exception):
 
                     self_type = type(f_self)
                     ret.append(
-                        "{}.{} - {}".format(
-                            self_type.__module__, self_type.__name__, f_self
-                        )
+                        f"{self_type.__module__}.{self_type.__name__} - {f_self}"
                     )
 
                 elif f_self is not None:
                     self_type = type(f_self)
-                    ret.append("{}.{}".format(self_type.__module__, self_type.__name__))
+                    ret.append(f"{self_type.__module__}.{self_type.__name__}")
 
                 else:
                     code = frm.f_code
                     if code.co_name in ("wrapper", "<module>"):
                         continue
 
-                    ret.append("{}".format(code.co_name))
+                    ret.append(code.co_name)
 
                 depth -= 1
                 if not depth:
@@ -110,7 +130,7 @@ class ParseBaseException(Exception):
         internal factory method to simplify creating one type of ParseException
         from another - avoids having __init__ signature conflicts among subclasses
         """
-        return cls(pe.pstr, pe.loc, pe.msg, pe.parserElement)
+        return cls(pe.pstr, pe.loc, pe.msg, pe.parser_element)
 
     @property
     def line(self) -> str:
@@ -140,6 +160,15 @@ class ParseBaseException(Exception):
         """
         return col(self.loc, self.pstr)
 
+    # pre-PEP8 compatibility
+    @property
+    def parserElement(self):
+        return self.parser_element
+
+    @parserElement.setter
+    def parserElement(self, elem):
+        self.parser_element = elem
+
     def __str__(self) -> str:
         if self.pstr:
             if self.loc >= len(self.pstr):
@@ -154,14 +183,14 @@ class ParseBaseException(Exception):
                 foundstr = (", found %r" % found).replace(r"\\", "\\")
         else:
             foundstr = ""
-        return "{}{}  (at char {}), (line:{}, col:{})".format(
-            self.msg, foundstr, self.loc, self.lineno, self.column
-        )
+        return f"{self.msg}{foundstr}  (at char {self.loc}), (line:{self.lineno}, col:{self.column})"
 
     def __repr__(self):
         return str(self)
 
-    def mark_input_line(self, marker_string: str = None, *, markerString=">!<") -> str:
+    def mark_input_line(
+        self, marker_string: typing.Optional[str] = None, *, markerString: str = ">!<"
+    ) -> str:
         """
         Extracts the exception line from the input string, and marks
         the location of the exception with a special symbol.
@@ -214,7 +243,10 @@ class ParseBaseException(Exception):
         """
         return self.explain_exception(self, depth)
 
-    markInputline = mark_input_line
+    # fmt: off
+    @replaced_by_pep8(mark_input_line)
+    def markInputline(self): ...
+    # fmt: on
 
 
 class ParseException(ParseBaseException):
@@ -264,4 +296,4 @@ class RecursiveGrammarException(Exception):
         self.parseElementTrace = parseElementList
 
     def __str__(self) -> str:
-        return "RecursiveGrammarException: {}".format(self.parseElementTrace)
+        return f"RecursiveGrammarException: {self.parseElementTrace}"
diff --git a/lib/pyparsing/helpers.py b/lib/pyparsing/helpers.py
index 9588b3b7..018f0d6a 100644
--- a/lib/pyparsing/helpers.py
+++ b/lib/pyparsing/helpers.py
@@ -1,73 +1,22 @@
 # helpers.py
 import html.entities
 import re
+import sys
 import typing
 
 from . import __diag__
 from .core import *
-from .util import _bslash, _flatten, _escape_regex_range_chars
+from .util import (
+    _bslash,
+    _flatten,
+    _escape_regex_range_chars,
+    replaced_by_pep8,
+)
 
 
 #
 # global helpers
 #
-def delimited_list(
-    expr: Union[str, ParserElement],
-    delim: Union[str, ParserElement] = ",",
-    combine: bool = False,
-    min: typing.Optional[int] = None,
-    max: typing.Optional[int] = None,
-    *,
-    allow_trailing_delim: bool = False,
-) -> ParserElement:
-    """Helper to define a delimited list of expressions - the delimiter
-    defaults to ','. By default, the list elements and delimiters can
-    have intervening whitespace, and comments, but this can be
-    overridden by passing ``combine=True`` in the constructor. If
-    ``combine`` is set to ``True``, the matching tokens are
-    returned as a single token string, with the delimiters included;
-    otherwise, the matching tokens are returned as a list of tokens,
-    with the delimiters suppressed.
-
-    If ``allow_trailing_delim`` is set to True, then the list may end with
-    a delimiter.
-
-    Example::
-
-        delimited_list(Word(alphas)).parse_string("aa,bb,cc") # -> ['aa', 'bb', 'cc']
-        delimited_list(Word(hexnums), delim=':', combine=True).parse_string("AA:BB:CC:DD:EE") # -> ['AA:BB:CC:DD:EE']
-    """
-    if isinstance(expr, str_type):
-        expr = ParserElement._literalStringClass(expr)
-
-    dlName = "{expr} [{delim} {expr}]...{end}".format(
-        expr=str(expr.copy().streamline()),
-        delim=str(delim),
-        end=" [{}]".format(str(delim)) if allow_trailing_delim else "",
-    )
-
-    if not combine:
-        delim = Suppress(delim)
-
-    if min is not None:
-        if min < 1:
-            raise ValueError("min must be greater than 0")
-        min -= 1
-    if max is not None:
-        if min is not None and max <= min:
-            raise ValueError("max must be greater than, or equal to min")
-        max -= 1
-    delimited_list_expr = expr + (delim + expr)[min, max]
-
-    if allow_trailing_delim:
-        delimited_list_expr += Opt(delim)
-
-    if combine:
-        return Combine(delimited_list_expr).set_name(dlName)
-    else:
-        return delimited_list_expr.set_name(dlName)
-
-
 def counted_array(
     expr: ParserElement,
     int_expr: typing.Optional[ParserElement] = None,
@@ -187,7 +136,7 @@ def match_previous_expr(expr: ParserElement) -> ParserElement:
             theseTokens = _flatten(t.as_list())
             if theseTokens != matchTokens:
                 raise ParseException(
-                    s, l, "Expected {}, found{}".format(matchTokens, theseTokens)
+                    s, l, f"Expected {matchTokens}, found{theseTokens}"
                 )
 
         rep.set_parse_action(must_match_these_tokens, callDuringTry=True)
@@ -218,7 +167,7 @@ def one_of(
     - ``caseless`` - treat all literals as caseless - (default= ``False``)
     - ``use_regex`` - as an optimization, will
       generate a :class:`Regex` object; otherwise, will generate
-      a :class:`MatchFirst` object (if ``caseless=True`` or ``asKeyword=True``, or if
+      a :class:`MatchFirst` object (if ``caseless=True`` or ``as_keyword=True``, or if
       creating a :class:`Regex` raises an exception) - (default= ``True``)
     - ``as_keyword`` - enforce :class:`Keyword`-style matching on the
       generated expressions - (default= ``False``)
@@ -262,6 +211,7 @@ def one_of(
 
     symbols: List[str] = []
     if isinstance(strs, str_type):
+        strs = typing.cast(str, strs)
         symbols = strs.split()
     elif isinstance(strs, Iterable):
         symbols = list(strs)
@@ -293,15 +243,13 @@ def one_of(
         try:
             if all(len(sym) == 1 for sym in symbols):
                 # symbols are just single characters, create range regex pattern
-                patt = "[{}]".format(
-                    "".join(_escape_regex_range_chars(sym) for sym in symbols)
-                )
+                patt = f"[{''.join(_escape_regex_range_chars(sym) for sym in symbols)}]"
             else:
                 patt = "|".join(re.escape(sym) for sym in symbols)
 
             # wrap with \b word break markers if defining as keywords
             if asKeyword:
-                patt = r"\b(?:{})\b".format(patt)
+                patt = rf"\b(?:{patt})\b"
 
             ret = Regex(patt, flags=re_flags).set_name(" | ".join(symbols))
 
@@ -371,7 +319,7 @@ def original_text_for(
     expression.  Useful to restore the parsed fields of an HTML start
     tag into the raw tag text itself, or to revert separate tokens with
     intervening whitespace back to the original matching input text. By
-    default, returns astring containing the original parsed text.
+    default, returns a string containing the original parsed text.
 
     If the optional ``as_string`` argument is passed as
     ``False``, then the return value is
@@ -390,7 +338,7 @@ def original_text_for(
         src = "this is test <b> bold <i>text</i> </b> normal text "
         for tag in ("b", "i"):
             opener, closer = make_html_tags(tag)
-            patt = original_text_for(opener + SkipTo(closer) + closer)
+            patt = original_text_for(opener + ... + closer)
             print(patt.search_string(src)[0])
 
     prints::
@@ -426,7 +374,7 @@ def ungroup(expr: ParserElement) -> ParserElement:
 
 def locatedExpr(expr: ParserElement) -> ParserElement:
     """
-    (DEPRECATED - future code should use the Located class)
+    (DEPRECATED - future code should use the :class:`Located` class)
     Helper to decorate a returned token with its starting and ending
     locations in the input string.
 
@@ -437,12 +385,12 @@ def locatedExpr(expr: ParserElement) -> ParserElement:
     - ``value`` - the actual parsed results
 
     Be careful if the input text contains ``<TAB>`` characters, you
-    may want to call :class:`ParserElement.parseWithTabs`
+    may want to call :class:`ParserElement.parse_with_tabs`
 
     Example::
 
         wd = Word(alphas)
-        for match in locatedExpr(wd).searchString("ljsdf123lksdjjf123lkkjj1222"):
+        for match in locatedExpr(wd).search_string("ljsdf123lksdjjf123lkkjj1222"):
             print(match)
 
     prints::
@@ -471,6 +419,7 @@ def nested_expr(
     closing delimiters (``"("`` and ``")"`` are the default).
 
     Parameters:
+
     - ``opener`` - opening character for a nested list
       (default= ``"("``); can also be a pyparsing expression
     - ``closer`` - closing character for a nested list
@@ -507,7 +456,7 @@ def nested_expr(
 
         c_function = (decl_data_type("type")
                       + ident("name")
-                      + LPAR + Opt(delimited_list(arg), [])("args") + RPAR
+                      + LPAR + Opt(DelimitedList(arg), [])("args") + RPAR
                       + code_body("body"))
         c_function.ignore(c_style_comment)
 
@@ -539,6 +488,8 @@ def nested_expr(
         raise ValueError("opening and closing strings cannot be the same")
     if content is None:
         if isinstance(opener, str_type) and isinstance(closer, str_type):
+            opener = typing.cast(str, opener)
+            closer = typing.cast(str, closer)
             if len(opener) == 1 and len(closer) == 1:
                 if ignoreExpr is not None:
                     content = Combine(
@@ -695,12 +646,15 @@ common_html_entity = Regex("&(?P<entity>" + "|".join(_htmlEntityMap) + ");").set
 )
 
 
-def replace_html_entity(t):
+def replace_html_entity(s, l, t):
     """Helper parser action to replace common HTML entities with their special characters"""
     return _htmlEntityMap.get(t.entity)
 
 
 class OpAssoc(Enum):
+    """Enumeration of operator associativity
+    - used in constructing InfixNotationOperatorSpec for :class:`infix_notation`"""
+
     LEFT = 1
     RIGHT = 2
 
@@ -742,6 +696,7 @@ def infix_notation(
     improve your parser performance.
 
     Parameters:
+
     - ``base_expr`` - expression representing the most basic operand to
       be used in the expression
     - ``op_list`` - list of tuples, one for each operator precedence level
@@ -764,11 +719,11 @@ def infix_notation(
         ``set_parse_action(*fn)``
         (:class:`ParserElement.set_parse_action`)
     - ``lpar`` - expression for matching left-parentheses; if passed as a
-      str, then will be parsed as Suppress(lpar). If lpar is passed as
+      str, then will be parsed as ``Suppress(lpar)``. If lpar is passed as
       an expression (such as ``Literal('(')``), then it will be kept in
       the parsed results, and grouped with them. (default= ``Suppress('(')``)
     - ``rpar`` - expression for matching right-parentheses; if passed as a
-      str, then will be parsed as Suppress(rpar). If rpar is passed as
+      str, then will be parsed as ``Suppress(rpar)``. If rpar is passed as
       an expression (such as ``Literal(')')``), then it will be kept in
       the parsed results, and grouped with them. (default= ``Suppress(')')``)
 
@@ -800,9 +755,13 @@ def infix_notation(
         (5+3)*6
         [[[5, '+', 3], '*', 6]]
 
+        (5+x)*y
+        [[[5, '+', 'x'], '*', 'y']]
+
         -2--11
         [[['-', 2], '-', ['-', 11]]]
     """
+
     # captive version of FollowedBy that does not do parse actions or capture results names
     class _FB(FollowedBy):
         def parseImpl(self, instring, loc, doActions=True):
@@ -823,19 +782,25 @@ def infix_notation(
     else:
         lastExpr = base_expr | (lpar + ret + rpar)
 
+    arity: int
+    rightLeftAssoc: opAssoc
+    pa: typing.Optional[ParseAction]
+    opExpr1: ParserElement
+    opExpr2: ParserElement
     for i, operDef in enumerate(op_list):
-        opExpr, arity, rightLeftAssoc, pa = (operDef + (None,))[:4]
+        opExpr, arity, rightLeftAssoc, pa = (operDef + (None,))[:4]  # type: ignore[assignment]
         if isinstance(opExpr, str_type):
             opExpr = ParserElement._literalStringClass(opExpr)
+        opExpr = typing.cast(ParserElement, opExpr)
         if arity == 3:
             if not isinstance(opExpr, (tuple, list)) or len(opExpr) != 2:
                 raise ValueError(
                     "if numterms=3, opExpr must be a tuple or list of two expressions"
                 )
             opExpr1, opExpr2 = opExpr
-            term_name = "{}{} term".format(opExpr1, opExpr2)
+            term_name = f"{opExpr1}{opExpr2} term"
         else:
-            term_name = "{} term".format(opExpr)
+            term_name = f"{opExpr} term"
 
         if not 1 <= arity <= 3:
             raise ValueError("operator must be unary (1), binary (2), or ternary (3)")
@@ -843,7 +808,8 @@ def infix_notation(
         if rightLeftAssoc not in (OpAssoc.LEFT, OpAssoc.RIGHT):
             raise ValueError("operator must indicate right or left associativity")
 
-        thisExpr: Forward = Forward().set_name(term_name)
+        thisExpr: ParserElement = Forward().set_name(term_name)
+        thisExpr = typing.cast(Forward, thisExpr)
         if rightLeftAssoc is OpAssoc.LEFT:
             if arity == 1:
                 matchExpr = _FB(lastExpr + opExpr) + Group(lastExpr + opExpr[1, ...])
@@ -890,7 +856,7 @@ def infix_notation(
 
 def indentedBlock(blockStatementExpr, indentStack, indent=True, backup_stacks=[]):
     """
-    (DEPRECATED - use IndentedBlock class instead)
+    (DEPRECATED - use :class:`IndentedBlock` class instead)
     Helper method for defining space-delimited indentation blocks,
     such as those used to define block statements in Python source code.
 
@@ -1063,22 +1029,28 @@ _builtin_exprs: List[ParserElement] = [
 ]
 
 
+# compatibility function, superseded by DelimitedList class
+def delimited_list(
+    expr: Union[str, ParserElement],
+    delim: Union[str, ParserElement] = ",",
+    combine: bool = False,
+    min: typing.Optional[int] = None,
+    max: typing.Optional[int] = None,
+    *,
+    allow_trailing_delim: bool = False,
+) -> ParserElement:
+    """(DEPRECATED - use :class:`DelimitedList` class)"""
+    return DelimitedList(
+        expr, delim, combine, min, max, allow_trailing_delim=allow_trailing_delim
+    )
+
+
 # pre-PEP8 compatible names
-delimitedList = delimited_list
-countedArray = counted_array
-matchPreviousLiteral = match_previous_literal
-matchPreviousExpr = match_previous_expr
-oneOf = one_of
-dictOf = dict_of
-originalTextFor = original_text_for
-nestedExpr = nested_expr
-makeHTMLTags = make_html_tags
-makeXMLTags = make_xml_tags
-anyOpenTag, anyCloseTag = any_open_tag, any_close_tag
-commonHTMLEntity = common_html_entity
-replaceHTMLEntity = replace_html_entity
+# fmt: off
 opAssoc = OpAssoc
-infixNotation = infix_notation
+anyOpenTag = any_open_tag
+anyCloseTag = any_close_tag
+commonHTMLEntity = common_html_entity
 cStyleComment = c_style_comment
 htmlComment = html_comment
 restOfLine = rest_of_line
@@ -1086,3 +1058,43 @@ dblSlashComment = dbl_slash_comment
 cppStyleComment = cpp_style_comment
 javaStyleComment = java_style_comment
 pythonStyleComment = python_style_comment
+
+@replaced_by_pep8(DelimitedList)
+def delimitedList(): ...
+
+@replaced_by_pep8(DelimitedList)
+def delimited_list(): ...
+
+@replaced_by_pep8(counted_array)
+def countedArray(): ...
+
+@replaced_by_pep8(match_previous_literal)
+def matchPreviousLiteral(): ...
+
+@replaced_by_pep8(match_previous_expr)
+def matchPreviousExpr(): ...
+
+@replaced_by_pep8(one_of)
+def oneOf(): ...
+
+@replaced_by_pep8(dict_of)
+def dictOf(): ...
+
+@replaced_by_pep8(original_text_for)
+def originalTextFor(): ...
+
+@replaced_by_pep8(nested_expr)
+def nestedExpr(): ...
+
+@replaced_by_pep8(make_html_tags)
+def makeHTMLTags(): ...
+
+@replaced_by_pep8(make_xml_tags)
+def makeXMLTags(): ...
+
+@replaced_by_pep8(replace_html_entity)
+def replaceHTMLEntity(): ...
+
+@replaced_by_pep8(infix_notation)
+def infixNotation(): ...
+# fmt: on
diff --git a/lib/pyparsing/results.py b/lib/pyparsing/results.py
index 00c9421d..03130497 100644
--- a/lib/pyparsing/results.py
+++ b/lib/pyparsing/results.py
@@ -1,18 +1,25 @@
 # results.py
-from collections.abc import MutableMapping, Mapping, MutableSequence, Iterator
+from collections.abc import (
+    MutableMapping,
+    Mapping,
+    MutableSequence,
+    Iterator,
+    Sequence,
+    Container,
+)
 import pprint
-from weakref import ref as wkref
-from typing import Tuple, Any
+from typing import Tuple, Any, Dict, Set, List
 
 str_type: Tuple[type, ...] = (str, bytes)
 _generator_type = type((_ for _ in ()))
 
 
 class _ParseResultsWithOffset:
+    tup: Tuple["ParseResults", int]
     __slots__ = ["tup"]
 
-    def __init__(self, p1, p2):
-        self.tup = (p1, p2)
+    def __init__(self, p1: "ParseResults", p2: int):
+        self.tup: Tuple[ParseResults, int] = (p1, p2)
 
     def __getitem__(self, i):
         return self.tup[i]
@@ -47,7 +54,7 @@ class ParseResults:
         result = date_str.parse_string("1999/12/31")
 
         def test(s, fn=repr):
-            print("{} -> {}".format(s, fn(eval(s))))
+            print(f"{s} -> {fn(eval(s))}")
         test("list(result)")
         test("result[0]")
         test("result['month']")
@@ -70,27 +77,33 @@ class ParseResults:
         - year: '1999'
     """
 
-    _null_values: Tuple[Any, ...] = (None, [], "", ())
+    _null_values: Tuple[Any, ...] = (None, [], ())
 
-    __slots__ = [
+    _name: str
+    _parent: "ParseResults"
+    _all_names: Set[str]
+    _modal: bool
+    _toklist: List[Any]
+    _tokdict: Dict[str, Any]
+
+    __slots__ = (
         "_name",
         "_parent",
         "_all_names",
         "_modal",
         "_toklist",
         "_tokdict",
-        "__weakref__",
-    ]
+    )
 
     class List(list):
         """
         Simple wrapper class to distinguish parsed list results that should be preserved
-        as actual Python lists, instead of being converted to :class:`ParseResults`:
+        as actual Python lists, instead of being converted to :class:`ParseResults`::
 
             LBRACK, RBRACK = map(pp.Suppress, "[]")
             element = pp.Forward()
             item = ppc.integer
-            element_list = LBRACK + pp.delimited_list(element) + RBRACK
+            element_list = LBRACK + pp.DelimitedList(element) + RBRACK
 
             # add parse actions to convert from ParseResults to actual Python collection types
             def as_python_list(t):
@@ -107,7 +120,7 @@ class ParseResults:
                 (2,3,4)
                 ''', post_parse=lambda s, r: (r[0], type(r[0])))
 
-        prints:
+        prints::
 
             100
             (100, <class 'int'>)
@@ -127,8 +140,7 @@ class ParseResults:
 
             if not isinstance(contained, list):
                 raise TypeError(
-                    "{} may only be constructed with a list,"
-                    " not {}".format(cls.__name__, type(contained).__name__)
+                    f"{cls.__name__} may only be constructed with a list, not {type(contained).__name__}"
                 )
 
             return list.__new__(cls)
@@ -159,6 +171,7 @@ class ParseResults:
     def __init__(
         self, toklist=None, name=None, asList=True, modal=True, isinstance=isinstance
     ):
+        self._tokdict: Dict[str, _ParseResultsWithOffset]
         self._modal = modal
         if name is not None and name != "":
             if isinstance(name, int):
@@ -210,7 +223,7 @@ class ParseResults:
             ]
             sub = v
         if isinstance(sub, ParseResults):
-            sub._parent = wkref(self)
+            sub._parent = self
 
     def __delitem__(self, i):
         if isinstance(i, (int, slice)):
@@ -263,7 +276,7 @@ class ParseResults:
         """
         Since ``keys()`` returns an iterator, this method is helpful in bypassing
         code that looks for the existence of any defined results names."""
-        return bool(self._tokdict)
+        return not not self._tokdict
 
     def pop(self, *args, **kwargs):
         """
@@ -311,9 +324,7 @@ class ParseResults:
             if k == "default":
                 args = (args[0], v)
             else:
-                raise TypeError(
-                    "pop() got an unexpected keyword argument {!r}".format(k)
-                )
+                raise TypeError(f"pop() got an unexpected keyword argument {k!r}")
         if isinstance(args[0], int) or len(args) == 1 or args[0] in self:
             index = args[0]
             ret = self[index]
@@ -423,12 +434,15 @@ class ParseResults:
                 raise AttributeError(name)
             return ""
 
-    def __add__(self, other) -> "ParseResults":
+    def __add__(self, other: "ParseResults") -> "ParseResults":
         ret = self.copy()
         ret += other
         return ret
 
-    def __iadd__(self, other) -> "ParseResults":
+    def __iadd__(self, other: "ParseResults") -> "ParseResults":
+        if not other:
+            return self
+
         if other._tokdict:
             offset = len(self._toklist)
             addoffset = lambda a: offset if a < 0 else a + offset
@@ -441,7 +455,7 @@ class ParseResults:
             for k, v in otherdictitems:
                 self[k] = v
                 if isinstance(v[0], ParseResults):
-                    v[0]._parent = wkref(self)
+                    v[0]._parent = self
 
         self._toklist += other._toklist
         self._all_names |= other._all_names
@@ -456,7 +470,7 @@ class ParseResults:
             return other + self
 
     def __repr__(self) -> str:
-        return "{}({!r}, {})".format(type(self).__name__, self._toklist, self.as_dict())
+        return f"{type(self).__name__}({self._toklist!r}, {self.as_dict()})"
 
     def __str__(self) -> str:
         return (
@@ -532,7 +546,10 @@ class ParseResults:
 
     def copy(self) -> "ParseResults":
         """
-        Returns a new copy of a :class:`ParseResults` object.
+        Returns a new shallow copy of a :class:`ParseResults` object. `ParseResults`
+        items contained within the source are shared with the copy. Use
+        :class:`ParseResults.deepcopy()` to create a copy with its own separate
+        content values.
         """
         ret = ParseResults(self._toklist)
         ret._tokdict = self._tokdict.copy()
@@ -541,6 +558,27 @@ class ParseResults:
         ret._name = self._name
         return ret
 
+    def deepcopy(self) -> "ParseResults":
+        """
+        Returns a new deep copy of a :class:`ParseResults` object.
+        """
+        ret = self.copy()
+        # replace values with copies if they are of known mutable types
+        for i, obj in enumerate(self._toklist):
+            if isinstance(obj, ParseResults):
+                self._toklist[i] = obj.deepcopy()
+            elif isinstance(obj, (str, bytes)):
+                pass
+            elif isinstance(obj, MutableMapping):
+                self._toklist[i] = dest = type(obj)()
+                for k, v in obj.items():
+                    dest[k] = v.deepcopy() if isinstance(v, ParseResults) else v
+            elif isinstance(obj, Container):
+                self._toklist[i] = type(obj)(
+                    v.deepcopy() if isinstance(v, ParseResults) else v for v in obj
+                )
+        return ret
+
     def get_name(self):
         r"""
         Returns the results name for this token expression. Useful when several
@@ -569,20 +607,17 @@ class ParseResults:
         if self._name:
             return self._name
         elif self._parent:
-            par = self._parent()
-
-            def find_in_parent(sub):
-                return next(
-                    (
-                        k
-                        for k, vlist in par._tokdict.items()
-                        for v, loc in vlist
-                        if sub is v
-                    ),
-                    None,
-                )
-
-            return find_in_parent(self) if par else None
+            par: "ParseResults" = self._parent
+            parent_tokdict_items = par._tokdict.items()
+            return next(
+                (
+                    k
+                    for k, vlist in parent_tokdict_items
+                    for v, loc in vlist
+                    if v is self
+                ),
+                None,
+            )
         elif (
             len(self) == 1
             and len(self._tokdict) == 1
@@ -623,7 +658,7 @@ class ParseResults:
                 for k, v in items:
                     if out:
                         out.append(NL)
-                    out.append("{}{}- {}: ".format(indent, ("  " * _depth), k))
+                    out.append(f"{indent}{('  ' * _depth)}- {k}: ")
                     if isinstance(v, ParseResults):
                         if v:
                             out.append(
@@ -685,7 +720,7 @@ class ParseResults:
             num = Word(nums)
             func = Forward()
             term = ident | num | Group('(' + func + ')')
-            func <<= ident + Group(Optional(delimited_list(term)))
+            func <<= ident + Group(Optional(DelimitedList(term)))
             result = func.parse_string("fna a,b,(fnb c,d,200),100")
             result.pprint(width=40)
 
@@ -705,7 +740,7 @@ class ParseResults:
             self._toklist,
             (
                 self._tokdict.copy(),
-                self._parent is not None and self._parent() or None,
+                None,
                 self._all_names,
                 self._name,
             ),
@@ -714,10 +749,7 @@ class ParseResults:
     def __setstate__(self, state):
         self._toklist, (self._tokdict, par, inAccumNames, self._name) = state
         self._all_names = set(inAccumNames)
-        if par is not None:
-            self._parent = wkref(par)
-        else:
-            self._parent = None
+        self._parent = None
 
     def __getnewargs__(self):
         return self._toklist, self._name
@@ -738,6 +770,7 @@ class ParseResults:
                 iter(obj)
             except Exception:
                 return False
+            # str's are iterable, but in pyparsing, we don't want to iterate over them
             else:
                 return not isinstance(obj, str_type)
 
@@ -752,8 +785,11 @@ class ParseResults:
         return ret
 
     asList = as_list
+    """Deprecated - use :class:`as_list`"""
     asDict = as_dict
+    """Deprecated - use :class:`as_dict`"""
     getName = get_name
+    """Deprecated - use :class:`get_name`"""
 
 
 MutableMapping.register(ParseResults)
diff --git a/lib/pyparsing/testing.py b/lib/pyparsing/testing.py
index 84a0ef17..6a254c1c 100644
--- a/lib/pyparsing/testing.py
+++ b/lib/pyparsing/testing.py
@@ -222,7 +222,7 @@ class pyparsing_test:
                             )
                         else:
                             # warning here maybe?
-                            print("no validation for {!r}".format(test_string))
+                            print(f"no validation for {test_string!r}")
 
             # do this last, in case some specific test results can be reported instead
             self.assertTrue(
@@ -265,15 +265,18 @@ class pyparsing_test:
         if expand_tabs:
             s = s.expandtabs()
         if mark_control is not None:
+            mark_control = typing.cast(str, mark_control)
             if mark_control == "unicode":
-                tbl = str.maketrans(
-                    {c: u for c, u in zip(range(0, 33), range(0x2400, 0x2433))}
-                    | {127: 0x2421}
-                )
+                transtable_map = {
+                    c: u for c, u in zip(range(0, 33), range(0x2400, 0x2433))
+                }
+                transtable_map[127] = 0x2421
+                tbl = str.maketrans(transtable_map)
                 eol_mark = ""
             else:
+                ord_mark_control = ord(mark_control)
                 tbl = str.maketrans(
-                    {c: mark_control for c in list(range(0, 32)) + [127]}
+                    {c: ord_mark_control for c in list(range(0, 32)) + [127]}
                 )
             s = s.translate(tbl)
         if mark_spaces is not None and mark_spaces != " ":
@@ -303,7 +306,7 @@ class pyparsing_test:
             header0 = (
                 lead
                 + "".join(
-                    "{}{}".format(" " * 99, (i + 1) % 100)
+                    f"{' ' * 99}{(i + 1) % 100}"
                     for i in range(max(max_line_len // 100, 1))
                 )
                 + "\n"
@@ -313,10 +316,7 @@ class pyparsing_test:
         header1 = (
             header0
             + lead
-            + "".join(
-                "         {}".format((i + 1) % 10)
-                for i in range(-(-max_line_len // 10))
-            )
+            + "".join(f"         {(i + 1) % 10}" for i in range(-(-max_line_len // 10)))
             + "\n"
         )
         header2 = lead + "1234567890" * (-(-max_line_len // 10)) + "\n"
@@ -324,7 +324,7 @@ class pyparsing_test:
             header1
             + header2
             + "\n".join(
-                "{:{}d}:{}{}".format(i, lineno_width, line, eol_mark)
+                f"{i:{lineno_width}d}:{line}{eol_mark}"
                 for i, line in enumerate(s_lines, start=start_line)
             )
             + "\n"
diff --git a/lib/pyparsing/unicode.py b/lib/pyparsing/unicode.py
index 06526203..b0a87b23 100644
--- a/lib/pyparsing/unicode.py
+++ b/lib/pyparsing/unicode.py
@@ -64,27 +64,27 @@ class unicode_set:
 
     @_lazyclassproperty
     def printables(cls):
-        "all non-whitespace characters in this range"
+        """all non-whitespace characters in this range"""
         return "".join(filterfalse(str.isspace, cls._chars_for_ranges))
 
     @_lazyclassproperty
     def alphas(cls):
-        "all alphabetic characters in this range"
+        """all alphabetic characters in this range"""
         return "".join(filter(str.isalpha, cls._chars_for_ranges))
 
     @_lazyclassproperty
     def nums(cls):
-        "all numeric digit characters in this range"
+        """all numeric digit characters in this range"""
         return "".join(filter(str.isdigit, cls._chars_for_ranges))
 
     @_lazyclassproperty
     def alphanums(cls):
-        "all alphanumeric characters in this range"
+        """all alphanumeric characters in this range"""
         return cls.alphas + cls.nums
 
     @_lazyclassproperty
     def identchars(cls):
-        "all characters in this range that are valid identifier characters, plus underscore '_'"
+        """all characters in this range that are valid identifier characters, plus underscore '_'"""
         return "".join(
             sorted(
                 set(
@@ -100,13 +100,13 @@ class unicode_set:
     def identbodychars(cls):
         """
         all characters in this range that are valid identifier body characters,
-        plus the digits 0-9
+        plus the digits 0-9, and · (Unicode MIDDLE DOT)
         """
         return "".join(
             sorted(
                 set(
                     cls.identchars
-                    + "0123456789"
+                    + "0123456789·"
                     + "".join(
                         [c for c in cls._chars_for_ranges if ("_" + c).isidentifier()]
                     )
@@ -114,6 +114,16 @@ class unicode_set:
             )
         )
 
+    @_lazyclassproperty
+    def identifier(cls):
+        """
+        a pyparsing Word expression for an identifier using this range's definitions for
+        identchars and identbodychars
+        """
+        from pyparsing import Word
+
+        return Word(cls.identchars, cls.identbodychars)
+
 
 class pyparsing_unicode(unicode_set):
     """
@@ -128,32 +138,32 @@ class pyparsing_unicode(unicode_set):
     ]
 
     class BasicMultilingualPlane(unicode_set):
-        "Unicode set for the Basic Multilingual Plane"
+        """Unicode set for the Basic Multilingual Plane"""
         _ranges: UnicodeRangeList = [
             (0x0020, 0xFFFF),
         ]
 
     class Latin1(unicode_set):
-        "Unicode set for Latin-1 Unicode Character Range"
+        """Unicode set for Latin-1 Unicode Character Range"""
         _ranges: UnicodeRangeList = [
             (0x0020, 0x007E),
             (0x00A0, 0x00FF),
         ]
 
     class LatinA(unicode_set):
-        "Unicode set for Latin-A Unicode Character Range"
+        """Unicode set for Latin-A Unicode Character Range"""
         _ranges: UnicodeRangeList = [
             (0x0100, 0x017F),
         ]
 
     class LatinB(unicode_set):
-        "Unicode set for Latin-B Unicode Character Range"
+        """Unicode set for Latin-B Unicode Character Range"""
         _ranges: UnicodeRangeList = [
             (0x0180, 0x024F),
         ]
 
     class Greek(unicode_set):
-        "Unicode set for Greek Unicode Character Ranges"
+        """Unicode set for Greek Unicode Character Ranges"""
         _ranges: UnicodeRangeList = [
             (0x0342, 0x0345),
             (0x0370, 0x0377),
@@ -193,7 +203,7 @@ class pyparsing_unicode(unicode_set):
         ]
 
     class Cyrillic(unicode_set):
-        "Unicode set for Cyrillic Unicode Character Range"
+        """Unicode set for Cyrillic Unicode Character Range"""
         _ranges: UnicodeRangeList = [
             (0x0400, 0x052F),
             (0x1C80, 0x1C88),
@@ -206,7 +216,7 @@ class pyparsing_unicode(unicode_set):
         ]
 
     class Chinese(unicode_set):
-        "Unicode set for Chinese Unicode Character Range"
+        """Unicode set for Chinese Unicode Character Range"""
         _ranges: UnicodeRangeList = [
             (0x2E80, 0x2E99),
             (0x2E9B, 0x2EF3),
@@ -229,8 +239,7 @@ class pyparsing_unicode(unicode_set):
         ]
 
     class Japanese(unicode_set):
-        "Unicode set for Japanese Unicode Character Range, combining Kanji, Hiragana, and Katakana ranges"
-        _ranges: UnicodeRangeList = []
+        """Unicode set for Japanese Unicode Character Range, combining Kanji, Hiragana, and Katakana ranges"""
 
         class Kanji(unicode_set):
             "Unicode set for Kanji Unicode Character Range"
@@ -240,7 +249,7 @@ class pyparsing_unicode(unicode_set):
             ]
 
         class Hiragana(unicode_set):
-            "Unicode set for Hiragana Unicode Character Range"
+            """Unicode set for Hiragana Unicode Character Range"""
             _ranges: UnicodeRangeList = [
                 (0x3041, 0x3096),
                 (0x3099, 0x30A0),
@@ -252,7 +261,7 @@ class pyparsing_unicode(unicode_set):
             ]
 
         class Katakana(unicode_set):
-            "Unicode set for Katakana  Unicode Character Range"
+            """Unicode set for Katakana  Unicode Character Range"""
             _ranges: UnicodeRangeList = [
                 (0x3099, 0x309C),
                 (0x30A0, 0x30FF),
@@ -265,8 +274,18 @@ class pyparsing_unicode(unicode_set):
                 (0x1F213,),
             ]
 
+        漢字 = Kanji
+        カタカナ = Katakana
+        ひらがな = Hiragana
+
+        _ranges = (
+            Kanji._ranges
+            + Hiragana._ranges
+            + Katakana._ranges
+        )
+
     class Hangul(unicode_set):
-        "Unicode set for Hangul (Korean) Unicode Character Range"
+        """Unicode set for Hangul (Korean) Unicode Character Range"""
         _ranges: UnicodeRangeList = [
             (0x1100, 0x11FF),
             (0x302E, 0x302F),
@@ -288,17 +307,17 @@ class pyparsing_unicode(unicode_set):
     Korean = Hangul
 
     class CJK(Chinese, Japanese, Hangul):
-        "Unicode set for combined Chinese, Japanese, and Korean (CJK) Unicode Character Range"
+        """Unicode set for combined Chinese, Japanese, and Korean (CJK) Unicode Character Range"""
 
     class Thai(unicode_set):
-        "Unicode set for Thai Unicode Character Range"
+        """Unicode set for Thai Unicode Character Range"""
         _ranges: UnicodeRangeList = [
             (0x0E01, 0x0E3A),
             (0x0E3F, 0x0E5B)
         ]
 
     class Arabic(unicode_set):
-        "Unicode set for Arabic Unicode Character Range"
+        """Unicode set for Arabic Unicode Character Range"""
         _ranges: UnicodeRangeList = [
             (0x0600, 0x061B),
             (0x061E, 0x06FF),
@@ -306,7 +325,7 @@ class pyparsing_unicode(unicode_set):
         ]
 
     class Hebrew(unicode_set):
-        "Unicode set for Hebrew Unicode Character Range"
+        """Unicode set for Hebrew Unicode Character Range"""
         _ranges: UnicodeRangeList = [
             (0x0591, 0x05C7),
             (0x05D0, 0x05EA),
@@ -320,33 +339,23 @@ class pyparsing_unicode(unicode_set):
         ]
 
     class Devanagari(unicode_set):
-        "Unicode set for Devanagari Unicode Character Range"
+        """Unicode set for Devanagari Unicode Character Range"""
         _ranges: UnicodeRangeList = [
             (0x0900, 0x097F),
             (0xA8E0, 0xA8FF)
         ]
 
+    BMP = BasicMultilingualPlane
+
+    # add language identifiers using language Unicode
+    العربية = Arabic
+    中文 = Chinese
+    кириллица = Cyrillic
+    Ελληνικά = Greek
+    עִברִית = Hebrew
+    日本語 = Japanese
+    한국어 = Korean
+    ไทย = Thai
+    देवनागरी = Devanagari
+
     # fmt: on
-
-
-pyparsing_unicode.Japanese._ranges = (
-    pyparsing_unicode.Japanese.Kanji._ranges
-    + pyparsing_unicode.Japanese.Hiragana._ranges
-    + pyparsing_unicode.Japanese.Katakana._ranges
-)
-
-pyparsing_unicode.BMP = pyparsing_unicode.BasicMultilingualPlane
-
-# add language identifiers using language Unicode
-pyparsing_unicode.العربية = pyparsing_unicode.Arabic
-pyparsing_unicode.中文 = pyparsing_unicode.Chinese
-pyparsing_unicode.кириллица = pyparsing_unicode.Cyrillic
-pyparsing_unicode.Ελληνικά = pyparsing_unicode.Greek
-pyparsing_unicode.עִברִית = pyparsing_unicode.Hebrew
-pyparsing_unicode.日本語 = pyparsing_unicode.Japanese
-pyparsing_unicode.Japanese.漢字 = pyparsing_unicode.Japanese.Kanji
-pyparsing_unicode.Japanese.カタカナ = pyparsing_unicode.Japanese.Katakana
-pyparsing_unicode.Japanese.ひらがな = pyparsing_unicode.Japanese.Hiragana
-pyparsing_unicode.한국어 = pyparsing_unicode.Korean
-pyparsing_unicode.ไทย = pyparsing_unicode.Thai
-pyparsing_unicode.देवनागरी = pyparsing_unicode.Devanagari
diff --git a/lib/pyparsing/util.py b/lib/pyparsing/util.py
index 34ce092c..d8d3f414 100644
--- a/lib/pyparsing/util.py
+++ b/lib/pyparsing/util.py
@@ -1,12 +1,14 @@
 # util.py
+import inspect
 import warnings
 import types
 import collections
 import itertools
-from functools import lru_cache
-from typing import List, Union, Iterable
+from functools import lru_cache, wraps
+from typing import Callable, List, Union, Iterable, TypeVar, cast
 
 _bslash = chr(92)
+C = TypeVar("C", bound=Callable)
 
 
 class __config_flags:
@@ -20,18 +22,15 @@ class __config_flags:
     def _set(cls, dname, value):
         if dname in cls._fixed_names:
             warnings.warn(
-                "{}.{} {} is {} and cannot be overridden".format(
-                    cls.__name__,
-                    dname,
-                    cls._type_desc,
-                    str(getattr(cls, dname)).upper(),
-                )
+                f"{cls.__name__}.{dname} {cls._type_desc} is {str(getattr(cls, dname)).upper()}"
+                f" and cannot be overridden",
+                stacklevel=3,
             )
             return
         if dname in cls._all_names:
             setattr(cls, dname, value)
         else:
-            raise ValueError("no such {} {!r}".format(cls._type_desc, dname))
+            raise ValueError(f"no such {cls._type_desc} {dname!r}")
 
     enable = classmethod(lambda cls, name: cls._set(name, True))
     disable = classmethod(lambda cls, name: cls._set(name, False))
@@ -45,7 +44,7 @@ def col(loc: int, strg: str) -> int:
 
     Note: the default parsing behavior is to expand tabs in the input string
     before starting the parsing process.  See
-    :class:`ParserElement.parseString` for more
+    :class:`ParserElement.parse_string` for more
     information on parsing strings containing ``<TAB>`` s, and suggested
     methods to maintain a consistent view of the parsed string, the parse
     location, and line and column positions within the parsed string.
@@ -60,7 +59,7 @@ def lineno(loc: int, strg: str) -> int:
     The first line is number 1.
 
     Note - the default parsing behavior is to expand tabs in the input string
-    before starting the parsing process.  See :class:`ParserElement.parseString`
+    before starting the parsing process.  See :class:`ParserElement.parse_string`
     for more information on parsing strings containing ``<TAB>`` s, and
     suggested methods to maintain a consistent view of the parsed string, the
     parse location, and line and column positions within the parsed string.
@@ -102,19 +101,24 @@ class _UnboundedCache:
 class _FifoCache:
     def __init__(self, size):
         self.not_in_cache = not_in_cache = object()
-        cache = collections.OrderedDict()
+        cache = {}
+        keyring = [object()] * size
         cache_get = cache.get
+        cache_pop = cache.pop
+        keyiter = itertools.cycle(range(size))
 
         def get(_, key):
             return cache_get(key, not_in_cache)
 
         def set_(_, key, value):
             cache[key] = value
-            while len(cache) > size:
-                cache.popitem(last=False)
+            i = next(keyiter)
+            cache_pop(keyring[i], None)
+            keyring[i] = key
 
         def clear(_):
             cache.clear()
+            keyring[:] = [object()] * size
 
         self.size = size
         self.get = types.MethodType(get, self)
@@ -189,9 +193,9 @@ def _collapse_string_to_ranges(
             is_consecutive.value = next(is_consecutive.counter)
         return is_consecutive.value
 
-    is_consecutive.prev = 0
-    is_consecutive.counter = itertools.count()
-    is_consecutive.value = -1
+    is_consecutive.prev = 0  # type: ignore [attr-defined]
+    is_consecutive.counter = itertools.count()  # type: ignore [attr-defined]
+    is_consecutive.value = -1  # type: ignore [attr-defined]
 
     def escape_re_range_char(c):
         return "\\" + c if c in r"\^-][" else c
@@ -215,9 +219,7 @@ def _collapse_string_to_ranges(
             else:
                 sep = "" if ord(last) == ord(first) + 1 else "-"
                 ret.append(
-                    "{}{}{}".format(
-                        escape_re_range_char(first), sep, escape_re_range_char(last)
-                    )
+                    f"{escape_re_range_char(first)}{sep}{escape_re_range_char(last)}"
                 )
     else:
         ret = [escape_re_range_char(c) for c in s]
@@ -233,3 +235,50 @@ def _flatten(ll: list) -> list:
         else:
             ret.append(i)
     return ret
+
+
+def _make_synonym_function(compat_name: str, fn: C) -> C:
+    # In a future version, uncomment the code in the internal _inner() functions
+    # to begin emitting DeprecationWarnings.
+
+    # Unwrap staticmethod/classmethod
+    fn = getattr(fn, "__func__", fn)
+
+    # (Presence of 'self' arg in signature is used by explain_exception() methods, so we take
+    # some extra steps to add it if present in decorated function.)
+    if "self" == list(inspect.signature(fn).parameters)[0]:
+
+        @wraps(fn)
+        def _inner(self, *args, **kwargs):
+            # warnings.warn(
+            #     f"Deprecated - use {fn.__name__}", DeprecationWarning, stacklevel=3
+            # )
+            return fn(self, *args, **kwargs)
+
+    else:
+
+        @wraps(fn)
+        def _inner(*args, **kwargs):
+            # warnings.warn(
+            #     f"Deprecated - use {fn.__name__}", DeprecationWarning, stacklevel=3
+            # )
+            return fn(*args, **kwargs)
+
+    _inner.__doc__ = f"""Deprecated - use :class:`{fn.__name__}`"""
+    _inner.__name__ = compat_name
+    _inner.__annotations__ = fn.__annotations__
+    if isinstance(fn, types.FunctionType):
+        _inner.__kwdefaults__ = fn.__kwdefaults__
+    elif isinstance(fn, type) and hasattr(fn, "__init__"):
+        _inner.__kwdefaults__ = fn.__init__.__kwdefaults__
+    else:
+        _inner.__kwdefaults__ = None
+    _inner.__qualname__ = fn.__qualname__
+    return cast(C, _inner)
+
+
+def replaced_by_pep8(fn: C) -> Callable[[Callable], C]:
+    """
+    Decorator for pre-PEP8 compatibility synonyms, to link them to the new function.
+    """
+    return lambda other: _make_synonym_function(other.__name__, fn)
diff --git a/requirements.txt b/requirements.txt
index dc879875..85039862 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -32,7 +32,7 @@ plexapi==4.13.4
 portend==3.2.0
 profilehooks==1.12.0
 PyJWT==2.8.0
-pyparsing==3.0.9
+pyparsing==3.1.1
 python-dateutil==2.8.2
 python-twitter==3.5
 pytz==2023.3

From 2c421507997f23ac904259f019e9fc3c7eefea65 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 24 Aug 2023 12:10:08 -0700
Subject: [PATCH 446/743] Bump apscheduler from 3.10.1 to 3.10.4 (#2133)

* Bump apscheduler from 3.10.1 to 3.10.4

Bumps [apscheduler](https://github.com/agronholm/apscheduler) from 3.10.1 to 3.10.4.
- [Changelog](https://github.com/agronholm/apscheduler/blob/3.10.4/docs/versionhistory.rst)
- [Commits](https://github.com/agronholm/apscheduler/compare/3.10.1...3.10.4)

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

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

* Update apscheduler==3.10.4

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/apscheduler/__init__.py        |   13 +-
 lib/apscheduler/schedulers/base.py |   19 +-
 lib/apscheduler/schedulers/qt.py   |   28 +-
 lib/apscheduler/util.py            |   39 +-
 lib/tzlocal/__init__.py            |    9 +-
 lib/tzlocal/unix.py                |   63 +-
 lib/tzlocal/utils.py               |   68 +-
 lib/tzlocal/win32.py               |   32 +-
 lib/tzlocal/windows_tz.py          | 1405 ++++++++++++++--------------
 package/requirements-package.txt   |    2 +-
 requirements.txt                   |    2 +-
 11 files changed, 855 insertions(+), 825 deletions(-)

diff --git a/lib/apscheduler/__init__.py b/lib/apscheduler/__init__.py
index 968169a9..651aba49 100644
--- a/lib/apscheduler/__init__.py
+++ b/lib/apscheduler/__init__.py
@@ -1,10 +1,15 @@
-from pkg_resources import get_distribution, DistributionNotFound
+import sys
+if sys.version_info >= (3, 8):
+    import importlib.metadata as importlib_metadata
+else:
+    import importlib_metadata
+
 
 try:
-    release = get_distribution('APScheduler').version.split('-')[0]
-except DistributionNotFound:
+    release = importlib_metadata.version('APScheduler').split('-')[0]
+except importlib_metadata.PackageNotFoundError:
     release = '3.5.0'
 
 version_info = tuple(int(x) if x.isdigit() else x for x in release.split('.'))
 version = __version__ = '.'.join(str(x) for x in version_info[:3])
-del get_distribution, DistributionNotFound
+del sys, importlib_metadata
diff --git a/lib/apscheduler/schedulers/base.py b/lib/apscheduler/schedulers/base.py
index 444de8ef..f751c955 100644
--- a/lib/apscheduler/schedulers/base.py
+++ b/lib/apscheduler/schedulers/base.py
@@ -7,7 +7,6 @@ from logging import getLogger
 import warnings
 import sys
 
-from pkg_resources import iter_entry_points
 from tzlocal import get_localzone
 import six
 
@@ -31,6 +30,11 @@ try:
 except ImportError:
     from collections import MutableMapping
 
+try:
+    from importlib.metadata import entry_points
+except ModuleNotFoundError:
+    from importlib_metadata import entry_points
+
 #: constant indicating a scheduler's stopped state
 STATE_STOPPED = 0
 #: constant indicating a scheduler's running state (started and processing jobs)
@@ -62,12 +66,18 @@ class BaseScheduler(six.with_metaclass(ABCMeta)):
 
     .. seealso:: :ref:`scheduler-config`
     """
+    # The `group=...` API is only available in the backport, used in <=3.7, and in std>=3.10.
+    if (3, 8) <= sys.version_info < (3, 10):
+        _trigger_plugins = {ep.name: ep for ep in entry_points()['apscheduler.triggers']}
+        _executor_plugins = {ep.name: ep for ep in entry_points()['apscheduler.executors']}
+        _jobstore_plugins = {ep.name: ep for ep in entry_points()['apscheduler.jobstores']}
+    else:
+        _trigger_plugins = {ep.name: ep for ep in entry_points(group='apscheduler.triggers')}
+        _executor_plugins = {ep.name: ep for ep in entry_points(group='apscheduler.executors')}
+        _jobstore_plugins = {ep.name: ep for ep in entry_points(group='apscheduler.jobstores')}
 
-    _trigger_plugins = dict((ep.name, ep) for ep in iter_entry_points('apscheduler.triggers'))
     _trigger_classes = {}
-    _executor_plugins = dict((ep.name, ep) for ep in iter_entry_points('apscheduler.executors'))
     _executor_classes = {}
-    _jobstore_plugins = dict((ep.name, ep) for ep in iter_entry_points('apscheduler.jobstores'))
     _jobstore_classes = {}
 
     #
@@ -1019,6 +1029,7 @@ class BaseScheduler(six.with_metaclass(ABCMeta)):
             wait_seconds = None
             self._logger.debug('No jobs; waiting until a job is added')
         else:
+            now = datetime.now(self.timezone)
             wait_seconds = min(max(timedelta_seconds(next_wakeup_time - now), 0), TIMEOUT_MAX)
             self._logger.debug('Next wakeup is due at %s (in %f seconds)', next_wakeup_time,
                                wait_seconds)
diff --git a/lib/apscheduler/schedulers/qt.py b/lib/apscheduler/schedulers/qt.py
index 890a44a8..6762c5c3 100644
--- a/lib/apscheduler/schedulers/qt.py
+++ b/lib/apscheduler/schedulers/qt.py
@@ -1,24 +1,22 @@
 from __future__ import absolute_import
 
+from importlib import import_module
+from itertools import product
+
 from apscheduler.schedulers.base import BaseScheduler
 
-try:
-    from PyQt5.QtCore import QObject, QTimer
-except (ImportError, RuntimeError):  # pragma: nocover
+for version, pkgname in product(range(6, 1, -1), ("PySide", "PyQt")):
     try:
-        from PyQt4.QtCore import QObject, QTimer
+        qtcore = import_module(pkgname + str(version) + ".QtCore")
     except ImportError:
-        try:
-            from PySide6.QtCore import QObject, QTimer  # noqa
-        except ImportError:
-            try:
-                from PySide2.QtCore import QObject, QTimer  # noqa
-            except ImportError:
-                try:
-                    from PySide.QtCore import QObject, QTimer  # noqa
-                except ImportError:
-                    raise ImportError('QtScheduler requires either PyQt5, PyQt4, PySide6, PySide2 '
-                                      'or PySide installed')
+        pass
+    else:
+        QTimer = qtcore.QTimer
+        break
+else:
+    raise ImportError(
+        "QtScheduler requires either PySide/PyQt (v6 to v2) installed"
+    )
 
 
 class QtScheduler(BaseScheduler):
diff --git a/lib/apscheduler/util.py b/lib/apscheduler/util.py
index 64b27d7b..003b30f5 100644
--- a/lib/apscheduler/util.py
+++ b/lib/apscheduler/util.py
@@ -6,7 +6,7 @@ from asyncio import iscoroutinefunction
 from datetime import date, datetime, time, timedelta, tzinfo
 from calendar import timegm
 from functools import partial
-from inspect import isclass, ismethod
+from inspect import isbuiltin, isclass, isfunction, ismethod
 import re
 import sys
 
@@ -214,28 +214,15 @@ def get_callable_name(func):
     :rtype: str
 
     """
-    # the easy case (on Python 3.3+)
-    if hasattr(func, '__qualname__'):
+    if ismethod(func):
+        self = func.__self__
+        cls = self if isclass(self) else type(self)
+        return f"{cls.__qualname__}.{func.__name__}"
+    elif isclass(func) or isfunction(func) or isbuiltin(func):
         return func.__qualname__
-
-    # class methods, bound and unbound methods
-    f_self = getattr(func, '__self__', None) or getattr(func, 'im_self', None)
-    if f_self and hasattr(func, '__name__'):
-        f_class = f_self if isclass(f_self) else f_self.__class__
-    else:
-        f_class = getattr(func, 'im_class', None)
-
-    if f_class and hasattr(func, '__name__'):
-        return '%s.%s' % (f_class.__name__, func.__name__)
-
-    # class or class instance
-    if hasattr(func, '__call__'):
-        # class
-        if hasattr(func, '__name__'):
-            return func.__name__
-
+    elif hasattr(func, '__call__') and callable(func.__call__):
         # instance of a class with a __call__ method
-        return func.__class__.__name__
+        return type(func).__qualname__
 
     raise TypeError('Unable to determine a name for %r -- maybe it is not a callable?' % func)
 
@@ -260,16 +247,10 @@ def obj_to_ref(obj):
         raise ValueError('Cannot create a reference to a nested function')
 
     if ismethod(obj):
-        if hasattr(obj, 'im_self') and obj.im_self:
-            # bound method
-            module = obj.im_self.__module__
-        elif hasattr(obj, 'im_class') and obj.im_class:
-            # unbound method
-            module = obj.im_class.__module__
-        else:
-            module = obj.__module__
+        module = obj.__self__.__module__
     else:
         module = obj.__module__
+
     return '%s:%s' % (module, name)
 
 
diff --git a/lib/tzlocal/__init__.py b/lib/tzlocal/__init__.py
index 98ed04fd..50abb093 100644
--- a/lib/tzlocal/__init__.py
+++ b/lib/tzlocal/__init__.py
@@ -9,5 +9,12 @@ if sys.platform == "win32":
 else:
     from tzlocal.unix import get_localzone, get_localzone_name, reload_localzone
 
+from tzlocal.utils import assert_tz_offset
 
-__all__ = ["get_localzone", "get_localzone_name", "reload_localzone"]
+
+__all__ = [
+    "get_localzone",
+    "get_localzone_name",
+    "reload_localzone",
+    "assert_tz_offset",
+]
diff --git a/lib/tzlocal/unix.py b/lib/tzlocal/unix.py
index eaf96d92..f510c12c 100644
--- a/lib/tzlocal/unix.py
+++ b/lib/tzlocal/unix.py
@@ -1,20 +1,21 @@
+import logging
 import os
 import re
 import sys
 import warnings
 from datetime import timezone
-import pytz_deprecation_shim as pds
 
 from tzlocal import utils
 
 if sys.version_info >= (3, 9):
-    from zoneinfo import ZoneInfo  # pragma: no cover
+    import zoneinfo  # pragma: no cover
 else:
-    from backports.zoneinfo import ZoneInfo  # pragma: no cover
+    from backports import zoneinfo  # pragma: no cover
 
 _cache_tz = None
 _cache_tz_name = None
 
+log = logging.getLogger("tzlocal")
 
 def _get_localzone_name(_root="/"):
     """Tries to find the local timezone configuration.
@@ -32,14 +33,21 @@ def _get_localzone_name(_root="/"):
 
     # Are we under Termux on Android?
     if os.path.exists(os.path.join(_root, "system/bin/getprop")):
+        log.debug("This looks like Termux")
+
         import subprocess
 
-        androidtz = (
-            subprocess.check_output(["getprop", "persist.sys.timezone"])
-            .strip()
-            .decode()
-        )
-        return androidtz
+        try:
+            androidtz = (
+                subprocess.check_output(["getprop", "persist.sys.timezone"])
+                .strip()
+                .decode()
+            )
+            return androidtz
+        except (OSError, subprocess.CalledProcessError):
+            # proot environment or failed to getprop
+            log.debug("It's not termux?")
+            pass
 
     # Now look for distribution specific configuration files
     # that contain the timezone name.
@@ -50,10 +58,11 @@ def _get_localzone_name(_root="/"):
     for configfile in ("etc/timezone", "var/db/zoneinfo"):
         tzpath = os.path.join(_root, configfile)
         try:
-            with open(tzpath, "rt") as tzfile:
+            with open(tzpath) as tzfile:
                 data = tzfile.read()
+                log.debug(f"{tzpath} found, contents:\n {data}")
 
-                etctz = data.strip('/ \t\r\n')
+                etctz = data.strip("/ \t\r\n")
                 if not etctz:
                     # Empty file, skip
                     continue
@@ -68,7 +77,7 @@ def _get_localzone_name(_root="/"):
 
                     found_configs[tzpath] = etctz.replace(" ", "_")
 
-        except (IOError, UnicodeDecodeError):
+        except (OSError, UnicodeDecodeError):
             # File doesn't exist or is a directory, or it's a binary file.
             continue
 
@@ -86,6 +95,7 @@ def _get_localzone_name(_root="/"):
         try:
             with open(tzpath, "rt") as tzfile:
                 data = tzfile.readlines()
+                log.debug(f"{tzpath} found, contents:\n {data}")
 
             for line in data:
                 # Look for the ZONE= setting.
@@ -95,13 +105,13 @@ def _get_localzone_name(_root="/"):
                     match = timezone_re.match(line)
                 if match is not None:
                     # Some setting existed
-                    line = line[match.end():]
+                    line = line[match.end() :]
                     etctz = line[: end_re.search(line).start()]
 
                     # We found a timezone
                     found_configs[tzpath] = etctz.replace(" ", "_")
 
-        except (IOError, UnicodeDecodeError):
+        except (OSError, UnicodeDecodeError):
             # UnicodeDecode handles when clock is symlink to /etc/localtime
             continue
 
@@ -109,30 +119,34 @@ def _get_localzone_name(_root="/"):
     # see manpage of localtime(5) and timedatectl(1)
     tzpath = os.path.join(_root, "etc/localtime")
     if os.path.exists(tzpath) and os.path.islink(tzpath):
-        etctz = realtzpath = os.path.realpath(tzpath)
+        log.debug(f"{tzpath} found")
+        etctz = os.path.realpath(tzpath)
         start = etctz.find("/") + 1
         while start != 0:
             etctz = etctz[start:]
             try:
-                pds.timezone(etctz)
+                zoneinfo.ZoneInfo(etctz)
                 tzinfo = f"{tzpath} is a symlink to"
                 found_configs[tzinfo] = etctz.replace(" ", "_")
-            except pds.UnknownTimeZoneError:
+                # Only need first valid relative path in simlink.
+                break
+            except zoneinfo.ZoneInfoNotFoundError:
                 pass
             start = etctz.find("/") + 1
 
     if len(found_configs) > 0:
+        log.debug(f"{len(found_configs)} found:\n {found_configs}")
         # We found some explicit config of some sort!
         if len(found_configs) > 1:
             # Uh-oh, multiple configs. See if they match:
             unique_tzs = set()
-            zoneinfo = os.path.join(_root, "usr", "share", "zoneinfo")
-            directory_depth = len(zoneinfo.split(os.path.sep))
+            zoneinfopath = os.path.join(_root, "usr", "share", "zoneinfo")
+            directory_depth = len(zoneinfopath.split(os.path.sep))
 
             for tzname in found_configs.values():
                 # Look them up in /usr/share/zoneinfo, and find what they
                 # really point to:
-                path = os.path.realpath(os.path.join(zoneinfo, *tzname.split("/")))
+                path = os.path.realpath(os.path.join(zoneinfopath, *tzname.split("/")))
                 real_zone_name = "/".join(path.split(os.path.sep)[directory_depth:])
                 unique_tzs.add(real_zone_name)
 
@@ -141,7 +155,7 @@ def _get_localzone_name(_root="/"):
                 for key, value in found_configs.items():
                     message += f"{key}: {value}\n"
                 message += "Fix the configuration, or set the time zone in a TZ environment variable.\n"
-                raise utils.ZoneInfoNotFoundError(message)
+                raise zoneinfo.ZoneInfoNotFoundError(message)
 
         # We found exactly one config! Use it.
         return list(found_configs.values())[0]
@@ -165,24 +179,25 @@ def _get_localzone(_root="/"):
     tzname = _get_localzone_name(_root)
     if tzname is None:
         # No explicit setting existed. Use localtime
+        log.debug("No explicit setting existed. Use localtime")
         for filename in ("etc/localtime", "usr/local/etc/localtime"):
             tzpath = os.path.join(_root, filename)
 
             if not os.path.exists(tzpath):
                 continue
             with open(tzpath, "rb") as tzfile:
-                tz = pds.wrap_zone(ZoneInfo.from_file(tzfile, key="local"))
+                tz = zoneinfo.ZoneInfo.from_file(tzfile, key="local")
                 break
         else:
             warnings.warn("Can not find any timezone configuration, defaulting to UTC.")
             tz = timezone.utc
     else:
-        tz = pds.timezone(tzname)
+        tz = zoneinfo.ZoneInfo(tzname)
 
     if _root == "/":
         # We are using a file in etc to name the timezone.
         # Verify that the timezone specified there is actually used:
-        utils.assert_tz_offset(tz)
+        utils.assert_tz_offset(tz, error=False)
     return tz
 
 
diff --git a/lib/tzlocal/utils.py b/lib/tzlocal/utils.py
index d1026b32..4ba82d3d 100644
--- a/lib/tzlocal/utils.py
+++ b/lib/tzlocal/utils.py
@@ -1,9 +1,9 @@
-# -*- coding: utf-8 -*-
+import logging
 import os
 import time
 import datetime
 import calendar
-import pytz_deprecation_shim as pds
+import warnings
 
 try:
     import zoneinfo  # pragma: no cover
@@ -12,35 +12,7 @@ except ImportError:
 
 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():
-    """Get system's timezone offset using built-in library time.
-
-    For the Timezone constants (altzone, daylight, timezone, and tzname), the
-    value is determined by the timezone rules in effect at module load time or
-    the last time tzset() is called and may be incorrect for times in the past.
-
-    To keep compatibility with Windows, we're always importing time module here.
-    """
-
-    localtime = calendar.timegm(time.localtime())
-    gmtime = calendar.timegm(time.gmtime())
-    offset = gmtime - localtime
-    # We could get the localtime and gmtime on either side of a second switch
-    # 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  # pragma: no cover
-    else:
-        return -time.timezone  # pragma: no cover
+log = logging.getLogger("tzlocal")
 
 
 def get_tz_offset(tz):
@@ -48,19 +20,27 @@ def get_tz_offset(tz):
     return int(datetime.datetime.now(tz).utcoffset().total_seconds())
 
 
-def assert_tz_offset(tz):
+def assert_tz_offset(tz, error=True):
     """Assert that system's timezone offset equals to the timezone offset found.
 
     If they don't match, we probably have a misconfiguration, for example, an
-    incorrect timezone set in /etc/timezone file in systemd distributions."""
+    incorrect timezone set in /etc/timezone file in systemd distributions.
+
+    If error is True, this method will raise a ValueError, otherwise it will
+    emit a warning.
+    """
+
     tz_offset = get_tz_offset(tz)
-    system_offset = get_system_offset()
-    if tz_offset != system_offset:
+    system_offset = calendar.timegm(time.localtime()) - calendar.timegm(time.gmtime())
+    # No one has timezone offsets less than a minute, so this should be close enough:
+    if abs(tz_offset - system_offset) > 60:
         msg = (
             "Timezone offset does not match system offset: {} != {}. "
             "Please, check your config files."
         ).format(tz_offset, system_offset)
-        raise ValueError(msg)
+        if error:
+            raise ValueError(msg)
+        warnings.warn(msg)
 
 
 def _tz_name_from_env(tzenv=None):
@@ -70,6 +50,8 @@ def _tz_name_from_env(tzenv=None):
     if not tzenv:
         return None
 
+    log.debug(f"Found a TZ environment: {tzenv}")
+
     if tzenv[0] == ":":
         tzenv = tzenv[1:]
 
@@ -92,6 +74,9 @@ def _tz_name_from_env(tzenv=None):
             # Indeed
             return parts[-1]
 
+    log.debug("TZ does not contain a time zone name")
+    return None
+
 
 def _tz_from_env(tzenv=None):
     if tzenv is None:
@@ -112,17 +97,16 @@ def _tz_from_env(tzenv=None):
             # 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)
+            return zoneinfo.ZoneInfo.from_file(tzfile, key=tzname)
 
     # TZ must specify a zoneinfo zone.
     try:
-        tz = pds.timezone(tzenv)
+        tz = zoneinfo.ZoneInfo(tzenv)
         # That worked, so we return this:
         return tz
-    except pds.UnknownTimeZoneError:
+    except zoneinfo.ZoneInfoNotFoundError:
         # Nope, it's something like "PST4DST" etc, we can't handle that.
-        raise ZoneInfoNotFoundError(
+        raise zoneinfo.ZoneInfoNotFoundError(
             "tzlocal() does not support non-zoneinfo timezones like %s. \n"
-            "Please use a timezone in the form of Continent/City"
+            "Please use a timezone in the form of Continent/City" % tzenv
         ) from None
diff --git a/lib/tzlocal/win32.py b/lib/tzlocal/win32.py
index 720ab2b7..9e8dc735 100644
--- a/lib/tzlocal/win32.py
+++ b/lib/tzlocal/win32.py
@@ -1,17 +1,24 @@
+import logging
 from datetime import datetime
-import pytz_deprecation_shim as pds
 
 try:
     import _winreg as winreg
 except ImportError:
     import winreg
 
+try:
+    import zoneinfo  # pragma: no cover
+except ImportError:
+    from backports import zoneinfo  # pragma: no cover
+
 from tzlocal.windows_tz import win_tz
 from tzlocal import utils
 
 _cache_tz = None
 _cache_tz_name = None
 
+log = logging.getLogger("tzlocal")
+
 
 def valuestodict(key):
     """Convert a registry key's values to a dictionary."""
@@ -48,6 +55,7 @@ def _get_localzone_name():
     if tzenv:
         return tzenv
 
+    log.debug("Looking up time zone info from registry")
     handle = winreg.ConnectRegistry(None, winreg.HKEY_LOCAL_MACHINE)
 
     TZLOCALKEYNAME = r"SYSTEM\CurrentControlSet\Control\TimeZoneInformation"
@@ -74,13 +82,13 @@ def _get_localzone_name():
 
     # Return what we have.
     if timezone is None:
-        raise utils.ZoneInfoNotFoundError(tzkeyname)
+        raise zoneinfo.ZoneInfoNotFoundError(tzkeyname)
 
     if keyvalues.get("DynamicDaylightTimeDisabled", 0) == 1:
         # DST is disabled, so don't return the timezone name,
         # instead return Etc/GMT+offset
 
-        tz = pds.timezone(timezone)
+        tz = zoneinfo.ZoneInfo(timezone)
         has_dst, std_offset, dst_offset = _get_dst_info(tz)
         if not has_dst:
             # The DST is turned off in the windows configuration,
@@ -88,13 +96,15 @@ def _get_localzone_name():
             return timezone
 
         if std_offset is None:
-            raise utils.ZoneInfoNotFoundError(
-                f"{tzkeyname} claims to not have a non-DST time!?")
+            raise zoneinfo.ZoneInfoNotFoundError(
+                f"{tzkeyname} claims to not have a non-DST time!?"
+            )
 
         if std_offset % 3600:
             # I can't convert this to an hourly offset
-            raise utils.ZoneInfoNotFoundError(
-                f"tzlocal can't support disabling DST in the {timezone} zone.")
+            raise zoneinfo.ZoneInfoNotFoundError(
+                f"tzlocal can't support disabling DST in the {timezone} zone."
+            )
 
         # This has whole hours as offset, return it as Etc/GMT
         return f"Etc/GMT{-std_offset//3600:+.0f}"
@@ -116,13 +126,13 @@ def get_localzone():
 
     global _cache_tz
     if _cache_tz is None:
-        _cache_tz = pds.timezone(get_localzone_name())
+        _cache_tz = zoneinfo.ZoneInfo(get_localzone_name())
 
     if not utils._tz_name_from_env():
         # If the timezone does NOT come from a TZ environment variable,
         # verify that it's correct. If it's from the environment,
         # we accept it, this is so you can run tests with different timezones.
-        utils.assert_tz_offset(_cache_tz)
+        utils.assert_tz_offset(_cache_tz, error=False)
 
     return _cache_tz
 
@@ -132,6 +142,6 @@ def reload_localzone():
     global _cache_tz
     global _cache_tz_name
     _cache_tz_name = _get_localzone_name()
-    _cache_tz = pds.timezone(_cache_tz_name)
-    utils.assert_tz_offset(_cache_tz)
+    _cache_tz = zoneinfo.ZoneInfo(_cache_tz_name)
+    utils.assert_tz_offset(_cache_tz, error=False)
     return _cache_tz
diff --git a/lib/tzlocal/windows_tz.py b/lib/tzlocal/windows_tz.py
index 0d285037..ed49c4ac 100644
--- a/lib/tzlocal/windows_tz.py
+++ b/lib/tzlocal/windows_tz.py
@@ -1,699 +1,718 @@
 # This file is autogenerated by the update_windows_mapping.py script
 # Do not edit.
-win_tz = {'AUS Central Standard Time': 'Australia/Darwin',
- 'AUS Eastern Standard Time': 'Australia/Sydney',
- 'Afghanistan Standard Time': 'Asia/Kabul',
- 'Alaskan Standard Time': 'America/Anchorage',
- 'Aleutian Standard Time': 'America/Adak',
- 'Altai Standard Time': 'Asia/Barnaul',
- 'Arab Standard Time': 'Asia/Riyadh',
- 'Arabian Standard Time': 'Asia/Dubai',
- 'Arabic Standard Time': 'Asia/Baghdad',
- 'Argentina Standard Time': 'America/Buenos_Aires',
- 'Astrakhan Standard Time': 'Europe/Astrakhan',
- 'Atlantic Standard Time': 'America/Halifax',
- 'Aus Central W. Standard Time': 'Australia/Eucla',
- 'Azerbaijan Standard Time': 'Asia/Baku',
- 'Azores Standard Time': 'Atlantic/Azores',
- 'Bahia Standard Time': 'America/Bahia',
- 'Bangladesh Standard Time': 'Asia/Dhaka',
- 'Belarus Standard Time': 'Europe/Minsk',
- 'Bougainville Standard Time': 'Pacific/Bougainville',
- 'Canada Central Standard Time': 'America/Regina',
- 'Cape Verde Standard Time': 'Atlantic/Cape_Verde',
- 'Caucasus Standard Time': 'Asia/Yerevan',
- 'Cen. Australia Standard Time': 'Australia/Adelaide',
- 'Central America Standard Time': 'America/Guatemala',
- 'Central Asia Standard Time': 'Asia/Almaty',
- 'Central Brazilian Standard Time': 'America/Cuiaba',
- 'Central Europe Standard Time': 'Europe/Budapest',
- 'Central European Standard Time': 'Europe/Warsaw',
- 'Central Pacific Standard Time': 'Pacific/Guadalcanal',
- 'Central Standard Time': 'America/Chicago',
- 'Central Standard Time (Mexico)': 'America/Mexico_City',
- 'Chatham Islands Standard Time': 'Pacific/Chatham',
- 'China Standard Time': 'Asia/Shanghai',
- 'Cuba Standard Time': 'America/Havana',
- 'Dateline Standard Time': 'Etc/GMT+12',
- 'E. Africa Standard Time': 'Africa/Nairobi',
- 'E. Australia Standard Time': 'Australia/Brisbane',
- 'E. Europe Standard Time': 'Europe/Chisinau',
- 'E. South America Standard Time': 'America/Sao_Paulo',
- 'Easter Island Standard Time': 'Pacific/Easter',
- 'Eastern Standard Time': 'America/New_York',
- 'Eastern Standard Time (Mexico)': 'America/Cancun',
- 'Egypt Standard Time': 'Africa/Cairo',
- 'Ekaterinburg Standard Time': 'Asia/Yekaterinburg',
- 'FLE Standard Time': 'Europe/Kiev',
- 'Fiji Standard Time': 'Pacific/Fiji',
- 'GMT Standard Time': 'Europe/London',
- 'GTB Standard Time': 'Europe/Bucharest',
- 'Georgian Standard Time': 'Asia/Tbilisi',
- 'Greenland Standard Time': 'America/Godthab',
- 'Greenwich Standard Time': 'Atlantic/Reykjavik',
- 'Haiti Standard Time': 'America/Port-au-Prince',
- 'Hawaiian Standard Time': 'Pacific/Honolulu',
- 'India Standard Time': 'Asia/Calcutta',
- 'Iran Standard Time': 'Asia/Tehran',
- 'Israel Standard Time': 'Asia/Jerusalem',
- 'Jordan Standard Time': 'Asia/Amman',
- 'Kaliningrad Standard Time': 'Europe/Kaliningrad',
- 'Korea Standard Time': 'Asia/Seoul',
- 'Libya Standard Time': 'Africa/Tripoli',
- 'Line Islands Standard Time': 'Pacific/Kiritimati',
- 'Lord Howe Standard Time': 'Australia/Lord_Howe',
- 'Magadan Standard Time': 'Asia/Magadan',
- 'Magallanes Standard Time': 'America/Punta_Arenas',
- 'Marquesas Standard Time': 'Pacific/Marquesas',
- 'Mauritius Standard Time': 'Indian/Mauritius',
- 'Middle East Standard Time': 'Asia/Beirut',
- 'Montevideo Standard Time': 'America/Montevideo',
- 'Morocco Standard Time': 'Africa/Casablanca',
- 'Mountain Standard Time': 'America/Denver',
- 'Mountain Standard Time (Mexico)': 'America/Chihuahua',
- 'Myanmar Standard Time': 'Asia/Rangoon',
- 'N. Central Asia Standard Time': 'Asia/Novosibirsk',
- 'Namibia Standard Time': 'Africa/Windhoek',
- 'Nepal Standard Time': 'Asia/Katmandu',
- 'New Zealand Standard Time': 'Pacific/Auckland',
- 'Newfoundland Standard Time': 'America/St_Johns',
- 'Norfolk Standard Time': 'Pacific/Norfolk',
- 'North Asia East Standard Time': 'Asia/Irkutsk',
- 'North Asia Standard Time': 'Asia/Krasnoyarsk',
- 'North Korea Standard Time': 'Asia/Pyongyang',
- 'Omsk Standard Time': 'Asia/Omsk',
- 'Pacific SA Standard Time': 'America/Santiago',
- 'Pacific Standard Time': 'America/Los_Angeles',
- 'Pacific Standard Time (Mexico)': 'America/Tijuana',
- 'Pakistan Standard Time': 'Asia/Karachi',
- 'Paraguay Standard Time': 'America/Asuncion',
- 'Qyzylorda Standard Time': 'Asia/Qyzylorda',
- 'Romance Standard Time': 'Europe/Paris',
- 'Russia Time Zone 10': 'Asia/Srednekolymsk',
- 'Russia Time Zone 11': 'Asia/Kamchatka',
- 'Russia Time Zone 3': 'Europe/Samara',
- 'Russian Standard Time': 'Europe/Moscow',
- 'SA Eastern Standard Time': 'America/Cayenne',
- 'SA Pacific Standard Time': 'America/Bogota',
- 'SA Western Standard Time': 'America/La_Paz',
- 'SE Asia Standard Time': 'Asia/Bangkok',
- 'Saint Pierre Standard Time': 'America/Miquelon',
- 'Sakhalin Standard Time': 'Asia/Sakhalin',
- 'Samoa Standard Time': 'Pacific/Apia',
- 'Sao Tome Standard Time': 'Africa/Sao_Tome',
- 'Saratov Standard Time': 'Europe/Saratov',
- 'Singapore Standard Time': 'Asia/Singapore',
- 'South Africa Standard Time': 'Africa/Johannesburg',
- 'South Sudan Standard Time': 'Africa/Juba',
- 'Sri Lanka Standard Time': 'Asia/Colombo',
- 'Sudan Standard Time': 'Africa/Khartoum',
- 'Syria Standard Time': 'Asia/Damascus',
- 'Taipei Standard Time': 'Asia/Taipei',
- 'Tasmania Standard Time': 'Australia/Hobart',
- 'Tocantins Standard Time': 'America/Araguaina',
- 'Tokyo Standard Time': 'Asia/Tokyo',
- 'Tomsk Standard Time': 'Asia/Tomsk',
- 'Tonga Standard Time': 'Pacific/Tongatapu',
- 'Transbaikal Standard Time': 'Asia/Chita',
- 'Turkey Standard Time': 'Europe/Istanbul',
- 'Turks And Caicos Standard Time': 'America/Grand_Turk',
- 'US Eastern Standard Time': 'America/Indianapolis',
- 'US Mountain Standard Time': 'America/Phoenix',
- 'UTC': 'Etc/UTC',
- 'UTC+12': 'Etc/GMT-12',
- 'UTC+13': 'Etc/GMT-13',
- 'UTC-02': 'Etc/GMT+2',
- 'UTC-08': 'Etc/GMT+8',
- 'UTC-09': 'Etc/GMT+9',
- 'UTC-11': 'Etc/GMT+11',
- 'Ulaanbaatar Standard Time': 'Asia/Ulaanbaatar',
- 'Venezuela Standard Time': 'America/Caracas',
- 'Vladivostok Standard Time': 'Asia/Vladivostok',
- 'Volgograd Standard Time': 'Europe/Volgograd',
- 'W. Australia Standard Time': 'Australia/Perth',
- 'W. Central Africa Standard Time': 'Africa/Lagos',
- 'W. Europe Standard Time': 'Europe/Berlin',
- 'W. Mongolia Standard Time': 'Asia/Hovd',
- 'West Asia Standard Time': 'Asia/Tashkent',
- 'West Bank Standard Time': 'Asia/Hebron',
- 'West Pacific Standard Time': 'Pacific/Port_Moresby',
- 'Yakutsk Standard Time': 'Asia/Yakutsk',
- 'Yukon Standard Time': 'America/Whitehorse'}
+win_tz = {
+    "AUS Central Standard Time": "Australia/Darwin",
+    "AUS Eastern Standard Time": "Australia/Sydney",
+    "Afghanistan Standard Time": "Asia/Kabul",
+    "Alaskan Standard Time": "America/Anchorage",
+    "Aleutian Standard Time": "America/Adak",
+    "Altai Standard Time": "Asia/Barnaul",
+    "Arab Standard Time": "Asia/Riyadh",
+    "Arabian Standard Time": "Asia/Dubai",
+    "Arabic Standard Time": "Asia/Baghdad",
+    "Argentina Standard Time": "America/Buenos_Aires",
+    "Astrakhan Standard Time": "Europe/Astrakhan",
+    "Atlantic Standard Time": "America/Halifax",
+    "Aus Central W. Standard Time": "Australia/Eucla",
+    "Azerbaijan Standard Time": "Asia/Baku",
+    "Azores Standard Time": "Atlantic/Azores",
+    "Bahia Standard Time": "America/Bahia",
+    "Bangladesh Standard Time": "Asia/Dhaka",
+    "Belarus Standard Time": "Europe/Minsk",
+    "Bougainville Standard Time": "Pacific/Bougainville",
+    "Canada Central Standard Time": "America/Regina",
+    "Cape Verde Standard Time": "Atlantic/Cape_Verde",
+    "Caucasus Standard Time": "Asia/Yerevan",
+    "Cen. Australia Standard Time": "Australia/Adelaide",
+    "Central America Standard Time": "America/Guatemala",
+    "Central Asia Standard Time": "Asia/Almaty",
+    "Central Brazilian Standard Time": "America/Cuiaba",
+    "Central Europe Standard Time": "Europe/Budapest",
+    "Central European Standard Time": "Europe/Warsaw",
+    "Central Pacific Standard Time": "Pacific/Guadalcanal",
+    "Central Standard Time": "America/Chicago",
+    "Central Standard Time (Mexico)": "America/Mexico_City",
+    "Chatham Islands Standard Time": "Pacific/Chatham",
+    "China Standard Time": "Asia/Shanghai",
+    "Cuba Standard Time": "America/Havana",
+    "Dateline Standard Time": "Etc/GMT+12",
+    "E. Africa Standard Time": "Africa/Nairobi",
+    "E. Australia Standard Time": "Australia/Brisbane",
+    "E. Europe Standard Time": "Europe/Chisinau",
+    "E. South America Standard Time": "America/Sao_Paulo",
+    "Easter Island Standard Time": "Pacific/Easter",
+    "Eastern Standard Time": "America/New_York",
+    "Eastern Standard Time (Mexico)": "America/Cancun",
+    "Egypt Standard Time": "Africa/Cairo",
+    "Ekaterinburg Standard Time": "Asia/Yekaterinburg",
+    "FLE Standard Time": "Europe/Kiev",
+    "Fiji Standard Time": "Pacific/Fiji",
+    "GMT Standard Time": "Europe/London",
+    "GTB Standard Time": "Europe/Bucharest",
+    "Georgian Standard Time": "Asia/Tbilisi",
+    "Greenland Standard Time": "America/Godthab",
+    "Greenwich Standard Time": "Atlantic/Reykjavik",
+    "Haiti Standard Time": "America/Port-au-Prince",
+    "Hawaiian Standard Time": "Pacific/Honolulu",
+    "India Standard Time": "Asia/Calcutta",
+    "Iran Standard Time": "Asia/Tehran",
+    "Israel Standard Time": "Asia/Jerusalem",
+    "Jordan Standard Time": "Asia/Amman",
+    "Kaliningrad Standard Time": "Europe/Kaliningrad",
+    "Korea Standard Time": "Asia/Seoul",
+    "Libya Standard Time": "Africa/Tripoli",
+    "Line Islands Standard Time": "Pacific/Kiritimati",
+    "Lord Howe Standard Time": "Australia/Lord_Howe",
+    "Magadan Standard Time": "Asia/Magadan",
+    "Magallanes Standard Time": "America/Punta_Arenas",
+    "Marquesas Standard Time": "Pacific/Marquesas",
+    "Mauritius Standard Time": "Indian/Mauritius",
+    "Middle East Standard Time": "Asia/Beirut",
+    "Montevideo Standard Time": "America/Montevideo",
+    "Morocco Standard Time": "Africa/Casablanca",
+    "Mountain Standard Time": "America/Denver",
+    "Mountain Standard Time (Mexico)": "America/Mazatlan",
+    "Myanmar Standard Time": "Asia/Rangoon",
+    "N. Central Asia Standard Time": "Asia/Novosibirsk",
+    "Namibia Standard Time": "Africa/Windhoek",
+    "Nepal Standard Time": "Asia/Katmandu",
+    "New Zealand Standard Time": "Pacific/Auckland",
+    "Newfoundland Standard Time": "America/St_Johns",
+    "Norfolk Standard Time": "Pacific/Norfolk",
+    "North Asia East Standard Time": "Asia/Irkutsk",
+    "North Asia Standard Time": "Asia/Krasnoyarsk",
+    "North Korea Standard Time": "Asia/Pyongyang",
+    "Omsk Standard Time": "Asia/Omsk",
+    "Pacific SA Standard Time": "America/Santiago",
+    "Pacific Standard Time": "America/Los_Angeles",
+    "Pacific Standard Time (Mexico)": "America/Tijuana",
+    "Pakistan Standard Time": "Asia/Karachi",
+    "Paraguay Standard Time": "America/Asuncion",
+    "Qyzylorda Standard Time": "Asia/Qyzylorda",
+    "Romance Standard Time": "Europe/Paris",
+    "Russia Time Zone 10": "Asia/Srednekolymsk",
+    "Russia Time Zone 11": "Asia/Kamchatka",
+    "Russia Time Zone 3": "Europe/Samara",
+    "Russian Standard Time": "Europe/Moscow",
+    "SA Eastern Standard Time": "America/Cayenne",
+    "SA Pacific Standard Time": "America/Bogota",
+    "SA Western Standard Time": "America/La_Paz",
+    "SE Asia Standard Time": "Asia/Bangkok",
+    "Saint Pierre Standard Time": "America/Miquelon",
+    "Sakhalin Standard Time": "Asia/Sakhalin",
+    "Samoa Standard Time": "Pacific/Apia",
+    "Sao Tome Standard Time": "Africa/Sao_Tome",
+    "Saratov Standard Time": "Europe/Saratov",
+    "Singapore Standard Time": "Asia/Singapore",
+    "South Africa Standard Time": "Africa/Johannesburg",
+    "South Sudan Standard Time": "Africa/Juba",
+    "Sri Lanka Standard Time": "Asia/Colombo",
+    "Sudan Standard Time": "Africa/Khartoum",
+    "Syria Standard Time": "Asia/Damascus",
+    "Taipei Standard Time": "Asia/Taipei",
+    "Tasmania Standard Time": "Australia/Hobart",
+    "Tocantins Standard Time": "America/Araguaina",
+    "Tokyo Standard Time": "Asia/Tokyo",
+    "Tomsk Standard Time": "Asia/Tomsk",
+    "Tonga Standard Time": "Pacific/Tongatapu",
+    "Transbaikal Standard Time": "Asia/Chita",
+    "Turkey Standard Time": "Europe/Istanbul",
+    "Turks And Caicos Standard Time": "America/Grand_Turk",
+    "US Eastern Standard Time": "America/Indianapolis",
+    "US Mountain Standard Time": "America/Phoenix",
+    "UTC": "Etc/UTC",
+    "UTC+12": "Etc/GMT-12",
+    "UTC+13": "Etc/GMT-13",
+    "UTC-02": "Etc/GMT+2",
+    "UTC-08": "Etc/GMT+8",
+    "UTC-09": "Etc/GMT+9",
+    "UTC-11": "Etc/GMT+11",
+    "Ulaanbaatar Standard Time": "Asia/Ulaanbaatar",
+    "Venezuela Standard Time": "America/Caracas",
+    "Vladivostok Standard Time": "Asia/Vladivostok",
+    "Volgograd Standard Time": "Europe/Volgograd",
+    "W. Australia Standard Time": "Australia/Perth",
+    "W. Central Africa Standard Time": "Africa/Lagos",
+    "W. Europe Standard Time": "Europe/Berlin",
+    "W. Mongolia Standard Time": "Asia/Hovd",
+    "West Asia Standard Time": "Asia/Tashkent",
+    "West Bank Standard Time": "Asia/Hebron",
+    "West Pacific Standard Time": "Pacific/Port_Moresby",
+    "Yakutsk Standard Time": "Asia/Yakutsk",
+    "Yukon Standard Time": "America/Whitehorse",
+}
 
 # Old name for the win_tz variable:
 tz_names = win_tz
 
-tz_win = {'Africa/Abidjan': 'Greenwich Standard Time',
- 'Africa/Accra': 'Greenwich Standard Time',
- 'Africa/Addis_Ababa': 'E. Africa Standard Time',
- 'Africa/Algiers': 'W. Central Africa Standard Time',
- 'Africa/Asmera': 'E. Africa Standard Time',
- 'Africa/Bamako': 'Greenwich Standard Time',
- 'Africa/Bangui': 'W. Central Africa Standard Time',
- 'Africa/Banjul': 'Greenwich Standard Time',
- 'Africa/Bissau': 'Greenwich Standard Time',
- 'Africa/Blantyre': 'South Africa Standard Time',
- 'Africa/Brazzaville': 'W. Central Africa Standard Time',
- 'Africa/Bujumbura': 'South Africa Standard Time',
- 'Africa/Cairo': 'Egypt Standard Time',
- 'Africa/Casablanca': 'Morocco Standard Time',
- 'Africa/Ceuta': 'Romance Standard Time',
- 'Africa/Conakry': 'Greenwich Standard Time',
- 'Africa/Dakar': 'Greenwich Standard Time',
- 'Africa/Dar_es_Salaam': 'E. Africa Standard Time',
- 'Africa/Djibouti': 'E. Africa Standard Time',
- 'Africa/Douala': 'W. Central Africa Standard Time',
- 'Africa/El_Aaiun': 'Morocco Standard Time',
- 'Africa/Freetown': 'Greenwich Standard Time',
- 'Africa/Gaborone': 'South Africa Standard Time',
- 'Africa/Harare': 'South Africa Standard Time',
- 'Africa/Johannesburg': 'South Africa Standard Time',
- 'Africa/Juba': 'South Sudan Standard Time',
- 'Africa/Kampala': 'E. Africa Standard Time',
- 'Africa/Khartoum': 'Sudan Standard Time',
- 'Africa/Kigali': 'South Africa Standard Time',
- 'Africa/Kinshasa': 'W. Central Africa Standard Time',
- 'Africa/Lagos': 'W. Central Africa Standard Time',
- 'Africa/Libreville': 'W. Central Africa Standard Time',
- 'Africa/Lome': 'Greenwich Standard Time',
- 'Africa/Luanda': 'W. Central Africa Standard Time',
- 'Africa/Lubumbashi': 'South Africa Standard Time',
- 'Africa/Lusaka': 'South Africa Standard Time',
- 'Africa/Malabo': 'W. Central Africa Standard Time',
- 'Africa/Maputo': 'South Africa Standard Time',
- 'Africa/Maseru': 'South Africa Standard Time',
- 'Africa/Mbabane': 'South Africa Standard Time',
- 'Africa/Mogadishu': 'E. Africa Standard Time',
- 'Africa/Monrovia': 'Greenwich Standard Time',
- 'Africa/Nairobi': 'E. Africa Standard Time',
- 'Africa/Ndjamena': 'W. Central Africa Standard Time',
- 'Africa/Niamey': 'W. Central Africa Standard Time',
- 'Africa/Nouakchott': 'Greenwich Standard Time',
- 'Africa/Ouagadougou': 'Greenwich Standard Time',
- 'Africa/Porto-Novo': 'W. Central Africa Standard Time',
- 'Africa/Sao_Tome': 'Sao Tome Standard Time',
- 'Africa/Timbuktu': 'Greenwich Standard Time',
- 'Africa/Tripoli': 'Libya Standard Time',
- 'Africa/Tunis': 'W. Central Africa Standard Time',
- 'Africa/Windhoek': 'Namibia Standard Time',
- 'America/Adak': 'Aleutian Standard Time',
- 'America/Anchorage': 'Alaskan Standard Time',
- 'America/Anguilla': 'SA Western Standard Time',
- 'America/Antigua': 'SA Western Standard Time',
- 'America/Araguaina': 'Tocantins Standard Time',
- 'America/Argentina/La_Rioja': 'Argentina Standard Time',
- 'America/Argentina/Rio_Gallegos': 'Argentina Standard Time',
- 'America/Argentina/Salta': 'Argentina Standard Time',
- 'America/Argentina/San_Juan': 'Argentina Standard Time',
- 'America/Argentina/San_Luis': 'Argentina Standard Time',
- 'America/Argentina/Tucuman': 'Argentina Standard Time',
- 'America/Argentina/Ushuaia': 'Argentina Standard Time',
- 'America/Aruba': 'SA Western Standard Time',
- 'America/Asuncion': 'Paraguay Standard Time',
- 'America/Atka': 'Aleutian Standard Time',
- 'America/Bahia': 'Bahia Standard Time',
- 'America/Bahia_Banderas': 'Central Standard Time (Mexico)',
- 'America/Barbados': 'SA Western Standard Time',
- 'America/Belem': 'SA Eastern Standard Time',
- 'America/Belize': 'Central America Standard Time',
- 'America/Blanc-Sablon': 'SA Western Standard Time',
- 'America/Boa_Vista': 'SA Western Standard Time',
- 'America/Bogota': 'SA Pacific Standard Time',
- 'America/Boise': 'Mountain Standard Time',
- 'America/Buenos_Aires': 'Argentina Standard Time',
- 'America/Cambridge_Bay': 'Mountain Standard Time',
- 'America/Campo_Grande': 'Central Brazilian Standard Time',
- 'America/Cancun': 'Eastern Standard Time (Mexico)',
- 'America/Caracas': 'Venezuela Standard Time',
- 'America/Catamarca': 'Argentina Standard Time',
- 'America/Cayenne': 'SA Eastern Standard Time',
- 'America/Cayman': 'SA Pacific Standard Time',
- 'America/Chicago': 'Central Standard Time',
- 'America/Chihuahua': 'Mountain Standard Time (Mexico)',
- 'America/Coral_Harbour': 'SA Pacific Standard Time',
- 'America/Cordoba': 'Argentina Standard Time',
- 'America/Costa_Rica': 'Central America Standard Time',
- 'America/Creston': 'US Mountain Standard Time',
- 'America/Cuiaba': 'Central Brazilian Standard Time',
- 'America/Curacao': 'SA Western Standard Time',
- 'America/Danmarkshavn': 'Greenwich Standard Time',
- 'America/Dawson': 'Yukon Standard Time',
- 'America/Dawson_Creek': 'US Mountain Standard Time',
- 'America/Denver': 'Mountain Standard Time',
- 'America/Detroit': 'Eastern Standard Time',
- 'America/Dominica': 'SA Western Standard Time',
- 'America/Edmonton': 'Mountain Standard Time',
- 'America/Eirunepe': 'SA Pacific Standard Time',
- 'America/El_Salvador': 'Central America Standard Time',
- 'America/Ensenada': 'Pacific Standard Time (Mexico)',
- 'America/Fort_Nelson': 'US Mountain Standard Time',
- 'America/Fortaleza': 'SA Eastern Standard Time',
- 'America/Glace_Bay': 'Atlantic Standard Time',
- 'America/Godthab': 'Greenland Standard Time',
- 'America/Goose_Bay': 'Atlantic Standard Time',
- 'America/Grand_Turk': 'Turks And Caicos Standard Time',
- 'America/Grenada': 'SA Western Standard Time',
- 'America/Guadeloupe': 'SA Western Standard Time',
- 'America/Guatemala': 'Central America Standard Time',
- 'America/Guayaquil': 'SA Pacific Standard Time',
- 'America/Guyana': 'SA Western Standard Time',
- 'America/Halifax': 'Atlantic Standard Time',
- 'America/Havana': 'Cuba Standard Time',
- 'America/Hermosillo': 'US Mountain Standard Time',
- 'America/Indiana/Knox': 'Central Standard Time',
- 'America/Indiana/Marengo': 'US Eastern Standard Time',
- 'America/Indiana/Petersburg': 'Eastern Standard Time',
- 'America/Indiana/Tell_City': 'Central Standard Time',
- 'America/Indiana/Vevay': 'US Eastern Standard Time',
- 'America/Indiana/Vincennes': 'Eastern Standard Time',
- 'America/Indiana/Winamac': 'Eastern Standard Time',
- 'America/Indianapolis': 'US Eastern Standard Time',
- 'America/Inuvik': 'Mountain Standard Time',
- 'America/Iqaluit': 'Eastern Standard Time',
- 'America/Jamaica': 'SA Pacific Standard Time',
- 'America/Jujuy': 'Argentina Standard Time',
- 'America/Juneau': 'Alaskan Standard Time',
- 'America/Kentucky/Monticello': 'Eastern Standard Time',
- 'America/Knox_IN': 'Central Standard Time',
- 'America/Kralendijk': 'SA Western Standard Time',
- 'America/La_Paz': 'SA Western Standard Time',
- 'America/Lima': 'SA Pacific Standard Time',
- 'America/Los_Angeles': 'Pacific Standard Time',
- 'America/Louisville': 'Eastern Standard Time',
- 'America/Lower_Princes': 'SA Western Standard Time',
- 'America/Maceio': 'SA Eastern Standard Time',
- 'America/Managua': 'Central America Standard Time',
- 'America/Manaus': 'SA Western Standard Time',
- 'America/Marigot': 'SA Western Standard Time',
- 'America/Martinique': 'SA Western Standard Time',
- 'America/Matamoros': 'Central Standard Time',
- 'America/Mazatlan': 'Mountain Standard Time (Mexico)',
- 'America/Mendoza': 'Argentina Standard Time',
- 'America/Menominee': 'Central Standard Time',
- 'America/Merida': 'Central Standard Time (Mexico)',
- 'America/Metlakatla': 'Alaskan Standard Time',
- 'America/Mexico_City': 'Central Standard Time (Mexico)',
- 'America/Miquelon': 'Saint Pierre Standard Time',
- 'America/Moncton': 'Atlantic Standard Time',
- 'America/Monterrey': 'Central Standard Time (Mexico)',
- 'America/Montevideo': 'Montevideo Standard Time',
- 'America/Montreal': 'Eastern Standard Time',
- 'America/Montserrat': 'SA Western Standard Time',
- 'America/Nassau': 'Eastern Standard Time',
- 'America/New_York': 'Eastern Standard Time',
- 'America/Nipigon': 'Eastern Standard Time',
- 'America/Nome': 'Alaskan Standard Time',
- 'America/Noronha': 'UTC-02',
- 'America/North_Dakota/Beulah': 'Central Standard Time',
- 'America/North_Dakota/Center': 'Central Standard Time',
- 'America/North_Dakota/New_Salem': 'Central Standard Time',
- 'America/Ojinaga': 'Mountain Standard Time',
- 'America/Panama': 'SA Pacific Standard Time',
- 'America/Pangnirtung': 'Eastern Standard Time',
- 'America/Paramaribo': 'SA Eastern Standard Time',
- 'America/Phoenix': 'US Mountain Standard Time',
- 'America/Port-au-Prince': 'Haiti Standard Time',
- 'America/Port_of_Spain': 'SA Western Standard Time',
- 'America/Porto_Acre': 'SA Pacific Standard Time',
- 'America/Porto_Velho': 'SA Western Standard Time',
- 'America/Puerto_Rico': 'SA Western Standard Time',
- 'America/Punta_Arenas': 'Magallanes Standard Time',
- 'America/Rainy_River': 'Central Standard Time',
- 'America/Rankin_Inlet': 'Central Standard Time',
- 'America/Recife': 'SA Eastern Standard Time',
- 'America/Regina': 'Canada Central Standard Time',
- 'America/Resolute': 'Central Standard Time',
- 'America/Rio_Branco': 'SA Pacific Standard Time',
- 'America/Santa_Isabel': 'Pacific Standard Time (Mexico)',
- 'America/Santarem': 'SA Eastern Standard Time',
- 'America/Santiago': 'Pacific SA Standard Time',
- 'America/Santo_Domingo': 'SA Western Standard Time',
- 'America/Sao_Paulo': 'E. South America Standard Time',
- 'America/Scoresbysund': 'Azores Standard Time',
- 'America/Shiprock': 'Mountain Standard Time',
- 'America/Sitka': 'Alaskan Standard Time',
- 'America/St_Barthelemy': 'SA Western Standard Time',
- 'America/St_Johns': 'Newfoundland Standard Time',
- 'America/St_Kitts': 'SA Western Standard Time',
- 'America/St_Lucia': 'SA Western Standard Time',
- 'America/St_Thomas': 'SA Western Standard Time',
- 'America/St_Vincent': 'SA Western Standard Time',
- 'America/Swift_Current': 'Canada Central Standard Time',
- 'America/Tegucigalpa': 'Central America Standard Time',
- 'America/Thule': 'Atlantic Standard Time',
- 'America/Thunder_Bay': 'Eastern Standard Time',
- 'America/Tijuana': 'Pacific Standard Time (Mexico)',
- 'America/Toronto': 'Eastern Standard Time',
- 'America/Tortola': 'SA Western Standard Time',
- 'America/Vancouver': 'Pacific Standard Time',
- 'America/Virgin': 'SA Western Standard Time',
- 'America/Whitehorse': 'Yukon Standard Time',
- 'America/Winnipeg': 'Central Standard Time',
- 'America/Yakutat': 'Alaskan Standard Time',
- 'America/Yellowknife': 'Mountain Standard Time',
- 'Antarctica/Casey': 'Central Pacific Standard Time',
- 'Antarctica/Davis': 'SE Asia Standard Time',
- 'Antarctica/DumontDUrville': 'West Pacific Standard Time',
- 'Antarctica/Macquarie': 'Tasmania Standard Time',
- 'Antarctica/Mawson': 'West Asia Standard Time',
- 'Antarctica/McMurdo': 'New Zealand Standard Time',
- 'Antarctica/Palmer': 'SA Eastern Standard Time',
- 'Antarctica/Rothera': 'SA Eastern Standard Time',
- 'Antarctica/South_Pole': 'New Zealand Standard Time',
- 'Antarctica/Syowa': 'E. Africa Standard Time',
- 'Antarctica/Vostok': 'Central Asia Standard Time',
- 'Arctic/Longyearbyen': 'W. Europe Standard Time',
- 'Asia/Aden': 'Arab Standard Time',
- 'Asia/Almaty': 'Central Asia Standard Time',
- 'Asia/Amman': 'Jordan Standard Time',
- 'Asia/Anadyr': 'Russia Time Zone 11',
- 'Asia/Aqtau': 'West Asia Standard Time',
- 'Asia/Aqtobe': 'West Asia Standard Time',
- 'Asia/Ashgabat': 'West Asia Standard Time',
- 'Asia/Ashkhabad': 'West Asia Standard Time',
- 'Asia/Atyrau': 'West Asia Standard Time',
- 'Asia/Baghdad': 'Arabic Standard Time',
- 'Asia/Bahrain': 'Arab Standard Time',
- 'Asia/Baku': 'Azerbaijan Standard Time',
- 'Asia/Bangkok': 'SE Asia Standard Time',
- 'Asia/Barnaul': 'Altai Standard Time',
- 'Asia/Beirut': 'Middle East Standard Time',
- 'Asia/Bishkek': 'Central Asia Standard Time',
- 'Asia/Brunei': 'Singapore Standard Time',
- 'Asia/Calcutta': 'India Standard Time',
- 'Asia/Chita': 'Transbaikal Standard Time',
- 'Asia/Choibalsan': 'Ulaanbaatar Standard Time',
- 'Asia/Chongqing': 'China Standard Time',
- 'Asia/Chungking': 'China Standard Time',
- 'Asia/Colombo': 'Sri Lanka Standard Time',
- 'Asia/Dacca': 'Bangladesh Standard Time',
- 'Asia/Damascus': 'Syria Standard Time',
- 'Asia/Dhaka': 'Bangladesh Standard Time',
- 'Asia/Dili': 'Tokyo Standard Time',
- 'Asia/Dubai': 'Arabian Standard Time',
- 'Asia/Dushanbe': 'West Asia Standard Time',
- 'Asia/Famagusta': 'GTB Standard Time',
- 'Asia/Gaza': 'West Bank Standard Time',
- 'Asia/Harbin': 'China Standard Time',
- 'Asia/Hebron': 'West Bank Standard Time',
- 'Asia/Hong_Kong': 'China Standard Time',
- 'Asia/Hovd': 'W. Mongolia Standard Time',
- 'Asia/Irkutsk': 'North Asia East Standard Time',
- 'Asia/Jakarta': 'SE Asia Standard Time',
- 'Asia/Jayapura': 'Tokyo Standard Time',
- 'Asia/Jerusalem': 'Israel Standard Time',
- 'Asia/Kabul': 'Afghanistan Standard Time',
- 'Asia/Kamchatka': 'Russia Time Zone 11',
- 'Asia/Karachi': 'Pakistan Standard Time',
- 'Asia/Kashgar': 'Central Asia Standard Time',
- 'Asia/Katmandu': 'Nepal Standard Time',
- 'Asia/Khandyga': 'Yakutsk Standard Time',
- 'Asia/Krasnoyarsk': 'North Asia Standard Time',
- 'Asia/Kuala_Lumpur': 'Singapore Standard Time',
- 'Asia/Kuching': 'Singapore Standard Time',
- 'Asia/Kuwait': 'Arab Standard Time',
- 'Asia/Macao': 'China Standard Time',
- 'Asia/Macau': 'China Standard Time',
- 'Asia/Magadan': 'Magadan Standard Time',
- 'Asia/Makassar': 'Singapore Standard Time',
- 'Asia/Manila': 'Singapore Standard Time',
- 'Asia/Muscat': 'Arabian Standard Time',
- 'Asia/Nicosia': 'GTB Standard Time',
- 'Asia/Novokuznetsk': 'North Asia Standard Time',
- 'Asia/Novosibirsk': 'N. Central Asia Standard Time',
- 'Asia/Omsk': 'Omsk Standard Time',
- 'Asia/Oral': 'West Asia Standard Time',
- 'Asia/Phnom_Penh': 'SE Asia Standard Time',
- 'Asia/Pontianak': 'SE Asia Standard Time',
- 'Asia/Pyongyang': 'North Korea Standard Time',
- 'Asia/Qatar': 'Arab Standard Time',
- 'Asia/Qostanay': 'Central Asia Standard Time',
- 'Asia/Qyzylorda': 'Qyzylorda Standard Time',
- 'Asia/Rangoon': 'Myanmar Standard Time',
- 'Asia/Riyadh': 'Arab Standard Time',
- 'Asia/Saigon': 'SE Asia Standard Time',
- 'Asia/Sakhalin': 'Sakhalin Standard Time',
- 'Asia/Samarkand': 'West Asia Standard Time',
- 'Asia/Seoul': 'Korea Standard Time',
- 'Asia/Shanghai': 'China Standard Time',
- 'Asia/Singapore': 'Singapore Standard Time',
- 'Asia/Srednekolymsk': 'Russia Time Zone 10',
- 'Asia/Taipei': 'Taipei Standard Time',
- 'Asia/Tashkent': 'West Asia Standard Time',
- 'Asia/Tbilisi': 'Georgian Standard Time',
- 'Asia/Tehran': 'Iran Standard Time',
- 'Asia/Tel_Aviv': 'Israel Standard Time',
- 'Asia/Thimbu': 'Bangladesh Standard Time',
- 'Asia/Thimphu': 'Bangladesh Standard Time',
- 'Asia/Tokyo': 'Tokyo Standard Time',
- 'Asia/Tomsk': 'Tomsk Standard Time',
- 'Asia/Ujung_Pandang': 'Singapore Standard Time',
- 'Asia/Ulaanbaatar': 'Ulaanbaatar Standard Time',
- 'Asia/Ulan_Bator': 'Ulaanbaatar Standard Time',
- 'Asia/Urumqi': 'Central Asia Standard Time',
- 'Asia/Ust-Nera': 'Vladivostok Standard Time',
- 'Asia/Vientiane': 'SE Asia Standard Time',
- 'Asia/Vladivostok': 'Vladivostok Standard Time',
- 'Asia/Yakutsk': 'Yakutsk Standard Time',
- 'Asia/Yekaterinburg': 'Ekaterinburg Standard Time',
- 'Asia/Yerevan': 'Caucasus Standard Time',
- 'Atlantic/Azores': 'Azores Standard Time',
- 'Atlantic/Bermuda': 'Atlantic Standard Time',
- 'Atlantic/Canary': 'GMT Standard Time',
- 'Atlantic/Cape_Verde': 'Cape Verde Standard Time',
- 'Atlantic/Faeroe': 'GMT Standard Time',
- 'Atlantic/Jan_Mayen': 'W. Europe Standard Time',
- 'Atlantic/Madeira': 'GMT Standard Time',
- 'Atlantic/Reykjavik': 'Greenwich Standard Time',
- 'Atlantic/South_Georgia': 'UTC-02',
- 'Atlantic/St_Helena': 'Greenwich Standard Time',
- 'Atlantic/Stanley': 'SA Eastern Standard Time',
- 'Australia/ACT': 'AUS Eastern Standard Time',
- 'Australia/Adelaide': 'Cen. Australia Standard Time',
- 'Australia/Brisbane': 'E. Australia Standard Time',
- 'Australia/Broken_Hill': 'Cen. Australia Standard Time',
- 'Australia/Canberra': 'AUS Eastern Standard Time',
- 'Australia/Currie': 'Tasmania Standard Time',
- 'Australia/Darwin': 'AUS Central Standard Time',
- 'Australia/Eucla': 'Aus Central W. Standard Time',
- 'Australia/Hobart': 'Tasmania Standard Time',
- 'Australia/LHI': 'Lord Howe Standard Time',
- 'Australia/Lindeman': 'E. Australia Standard Time',
- 'Australia/Lord_Howe': 'Lord Howe Standard Time',
- 'Australia/Melbourne': 'AUS Eastern Standard Time',
- 'Australia/NSW': 'AUS Eastern Standard Time',
- 'Australia/North': 'AUS Central Standard Time',
- 'Australia/Perth': 'W. Australia Standard Time',
- 'Australia/Queensland': 'E. Australia Standard Time',
- 'Australia/South': 'Cen. Australia Standard Time',
- 'Australia/Sydney': 'AUS Eastern Standard Time',
- 'Australia/Tasmania': 'Tasmania Standard Time',
- 'Australia/Victoria': 'AUS Eastern Standard Time',
- 'Australia/West': 'W. Australia Standard Time',
- 'Australia/Yancowinna': 'Cen. Australia Standard Time',
- 'Brazil/Acre': 'SA Pacific Standard Time',
- 'Brazil/DeNoronha': 'UTC-02',
- 'Brazil/East': 'E. South America Standard Time',
- 'Brazil/West': 'SA Western Standard Time',
- 'CST6CDT': 'Central Standard Time',
- 'Canada/Atlantic': 'Atlantic Standard Time',
- 'Canada/Central': 'Central Standard Time',
- 'Canada/Eastern': 'Eastern Standard Time',
- 'Canada/Mountain': 'Mountain Standard Time',
- 'Canada/Newfoundland': 'Newfoundland Standard Time',
- 'Canada/Pacific': 'Pacific Standard Time',
- 'Canada/Saskatchewan': 'Canada Central Standard Time',
- 'Canada/Yukon': 'Yukon Standard Time',
- 'Chile/Continental': 'Pacific SA Standard Time',
- 'Chile/EasterIsland': 'Easter Island Standard Time',
- 'Cuba': 'Cuba Standard Time',
- 'EST5EDT': 'Eastern Standard Time',
- 'Egypt': 'Egypt Standard Time',
- 'Eire': 'GMT Standard Time',
- 'Etc/GMT': 'UTC',
- 'Etc/GMT+1': 'Cape Verde Standard Time',
- 'Etc/GMT+10': 'Hawaiian Standard Time',
- 'Etc/GMT+11': 'UTC-11',
- 'Etc/GMT+12': 'Dateline Standard Time',
- 'Etc/GMT+2': 'UTC-02',
- 'Etc/GMT+3': 'SA Eastern Standard Time',
- 'Etc/GMT+4': 'SA Western Standard Time',
- 'Etc/GMT+5': 'SA Pacific Standard Time',
- 'Etc/GMT+6': 'Central America Standard Time',
- 'Etc/GMT+7': 'US Mountain Standard Time',
- 'Etc/GMT+8': 'UTC-08',
- 'Etc/GMT+9': 'UTC-09',
- 'Etc/GMT-1': 'W. Central Africa Standard Time',
- 'Etc/GMT-10': 'West Pacific Standard Time',
- 'Etc/GMT-11': 'Central Pacific Standard Time',
- 'Etc/GMT-12': 'UTC+12',
- 'Etc/GMT-13': 'UTC+13',
- 'Etc/GMT-14': 'Line Islands Standard Time',
- 'Etc/GMT-2': 'South Africa Standard Time',
- 'Etc/GMT-3': 'E. Africa Standard Time',
- 'Etc/GMT-4': 'Arabian Standard Time',
- 'Etc/GMT-5': 'West Asia Standard Time',
- 'Etc/GMT-6': 'Central Asia Standard Time',
- 'Etc/GMT-7': 'SE Asia Standard Time',
- 'Etc/GMT-8': 'Singapore Standard Time',
- 'Etc/GMT-9': 'Tokyo Standard Time',
- 'Etc/UCT': 'UTC',
- 'Etc/UTC': 'UTC',
- 'Europe/Amsterdam': 'W. Europe Standard Time',
- 'Europe/Andorra': 'W. Europe Standard Time',
- 'Europe/Astrakhan': 'Astrakhan Standard Time',
- 'Europe/Athens': 'GTB Standard Time',
- 'Europe/Belfast': 'GMT Standard Time',
- 'Europe/Belgrade': 'Central Europe Standard Time',
- 'Europe/Berlin': 'W. Europe Standard Time',
- 'Europe/Bratislava': 'Central Europe Standard Time',
- 'Europe/Brussels': 'Romance Standard Time',
- 'Europe/Bucharest': 'GTB Standard Time',
- 'Europe/Budapest': 'Central Europe Standard Time',
- 'Europe/Busingen': 'W. Europe Standard Time',
- 'Europe/Chisinau': 'E. Europe Standard Time',
- 'Europe/Copenhagen': 'Romance Standard Time',
- 'Europe/Dublin': 'GMT Standard Time',
- 'Europe/Gibraltar': 'W. Europe Standard Time',
- 'Europe/Guernsey': 'GMT Standard Time',
- 'Europe/Helsinki': 'FLE Standard Time',
- 'Europe/Isle_of_Man': 'GMT Standard Time',
- 'Europe/Istanbul': 'Turkey Standard Time',
- 'Europe/Jersey': 'GMT Standard Time',
- 'Europe/Kaliningrad': 'Kaliningrad Standard Time',
- 'Europe/Kiev': 'FLE Standard Time',
- 'Europe/Kirov': 'Russian Standard Time',
- 'Europe/Lisbon': 'GMT Standard Time',
- 'Europe/Ljubljana': 'Central Europe Standard Time',
- 'Europe/London': 'GMT Standard Time',
- 'Europe/Luxembourg': 'W. Europe Standard Time',
- 'Europe/Madrid': 'Romance Standard Time',
- 'Europe/Malta': 'W. Europe Standard Time',
- 'Europe/Mariehamn': 'FLE Standard Time',
- 'Europe/Minsk': 'Belarus Standard Time',
- 'Europe/Monaco': 'W. Europe Standard Time',
- 'Europe/Moscow': 'Russian Standard Time',
- 'Europe/Oslo': 'W. Europe Standard Time',
- 'Europe/Paris': 'Romance Standard Time',
- 'Europe/Podgorica': 'Central Europe Standard Time',
- 'Europe/Prague': 'Central Europe Standard Time',
- 'Europe/Riga': 'FLE Standard Time',
- 'Europe/Rome': 'W. Europe Standard Time',
- 'Europe/Samara': 'Russia Time Zone 3',
- 'Europe/San_Marino': 'W. Europe Standard Time',
- 'Europe/Sarajevo': 'Central European Standard Time',
- 'Europe/Saratov': 'Saratov Standard Time',
- 'Europe/Simferopol': 'Russian Standard Time',
- 'Europe/Skopje': 'Central European Standard Time',
- 'Europe/Sofia': 'FLE Standard Time',
- 'Europe/Stockholm': 'W. Europe Standard Time',
- 'Europe/Tallinn': 'FLE Standard Time',
- 'Europe/Tirane': 'Central Europe Standard Time',
- 'Europe/Tiraspol': 'E. Europe Standard Time',
- 'Europe/Ulyanovsk': 'Astrakhan Standard Time',
- 'Europe/Uzhgorod': 'FLE Standard Time',
- 'Europe/Vaduz': 'W. Europe Standard Time',
- 'Europe/Vatican': 'W. Europe Standard Time',
- 'Europe/Vienna': 'W. Europe Standard Time',
- 'Europe/Vilnius': 'FLE Standard Time',
- 'Europe/Volgograd': 'Volgograd Standard Time',
- 'Europe/Warsaw': 'Central European Standard Time',
- 'Europe/Zagreb': 'Central European Standard Time',
- 'Europe/Zaporozhye': 'FLE Standard Time',
- 'Europe/Zurich': 'W. Europe Standard Time',
- 'GB': 'GMT Standard Time',
- 'GB-Eire': 'GMT Standard Time',
- 'GMT+0': 'UTC',
- 'GMT-0': 'UTC',
- 'GMT0': 'UTC',
- 'Greenwich': 'UTC',
- 'Hongkong': 'China Standard Time',
- 'Iceland': 'Greenwich Standard Time',
- 'Indian/Antananarivo': 'E. Africa Standard Time',
- 'Indian/Chagos': 'Central Asia Standard Time',
- 'Indian/Christmas': 'SE Asia Standard Time',
- 'Indian/Cocos': 'Myanmar Standard Time',
- 'Indian/Comoro': 'E. Africa Standard Time',
- 'Indian/Kerguelen': 'West Asia Standard Time',
- 'Indian/Mahe': 'Mauritius Standard Time',
- 'Indian/Maldives': 'West Asia Standard Time',
- 'Indian/Mauritius': 'Mauritius Standard Time',
- 'Indian/Mayotte': 'E. Africa Standard Time',
- 'Indian/Reunion': 'Mauritius Standard Time',
- 'Iran': 'Iran Standard Time',
- 'Israel': 'Israel Standard Time',
- 'Jamaica': 'SA Pacific Standard Time',
- 'Japan': 'Tokyo Standard Time',
- 'Kwajalein': 'UTC+12',
- 'Libya': 'Libya Standard Time',
- 'MST7MDT': 'Mountain Standard Time',
- 'Mexico/BajaNorte': 'Pacific Standard Time (Mexico)',
- 'Mexico/BajaSur': 'Mountain Standard Time (Mexico)',
- 'Mexico/General': 'Central Standard Time (Mexico)',
- 'NZ': 'New Zealand Standard Time',
- 'NZ-CHAT': 'Chatham Islands Standard Time',
- 'Navajo': 'Mountain Standard Time',
- 'PRC': 'China Standard Time',
- 'PST8PDT': 'Pacific Standard Time',
- 'Pacific/Apia': 'Samoa Standard Time',
- 'Pacific/Auckland': 'New Zealand Standard Time',
- 'Pacific/Bougainville': 'Bougainville Standard Time',
- 'Pacific/Chatham': 'Chatham Islands Standard Time',
- 'Pacific/Easter': 'Easter Island Standard Time',
- 'Pacific/Efate': 'Central Pacific Standard Time',
- 'Pacific/Enderbury': 'UTC+13',
- 'Pacific/Fakaofo': 'UTC+13',
- 'Pacific/Fiji': 'Fiji Standard Time',
- 'Pacific/Funafuti': 'UTC+12',
- 'Pacific/Galapagos': 'Central America Standard Time',
- 'Pacific/Gambier': 'UTC-09',
- 'Pacific/Guadalcanal': 'Central Pacific Standard Time',
- 'Pacific/Guam': 'West Pacific Standard Time',
- 'Pacific/Honolulu': 'Hawaiian Standard Time',
- 'Pacific/Johnston': 'Hawaiian Standard Time',
- 'Pacific/Kiritimati': 'Line Islands Standard Time',
- 'Pacific/Kosrae': 'Central Pacific Standard Time',
- 'Pacific/Kwajalein': 'UTC+12',
- 'Pacific/Majuro': 'UTC+12',
- 'Pacific/Marquesas': 'Marquesas Standard Time',
- 'Pacific/Midway': 'UTC-11',
- 'Pacific/Nauru': 'UTC+12',
- 'Pacific/Niue': 'UTC-11',
- 'Pacific/Norfolk': 'Norfolk Standard Time',
- 'Pacific/Noumea': 'Central Pacific Standard Time',
- 'Pacific/Pago_Pago': 'UTC-11',
- 'Pacific/Palau': 'Tokyo Standard Time',
- 'Pacific/Pitcairn': 'UTC-08',
- 'Pacific/Ponape': 'Central Pacific Standard Time',
- 'Pacific/Port_Moresby': 'West Pacific Standard Time',
- 'Pacific/Rarotonga': 'Hawaiian Standard Time',
- 'Pacific/Saipan': 'West Pacific Standard Time',
- 'Pacific/Samoa': 'UTC-11',
- 'Pacific/Tahiti': 'Hawaiian Standard Time',
- 'Pacific/Tarawa': 'UTC+12',
- 'Pacific/Tongatapu': 'Tonga Standard Time',
- 'Pacific/Truk': 'West Pacific Standard Time',
- 'Pacific/Wake': 'UTC+12',
- 'Pacific/Wallis': 'UTC+12',
- 'Poland': 'Central European Standard Time',
- 'Portugal': 'GMT Standard Time',
- 'ROC': 'Taipei Standard Time',
- 'ROK': 'Korea Standard Time',
- 'Singapore': 'Singapore Standard Time',
- 'Turkey': 'Turkey Standard Time',
- 'UCT': 'UTC',
- 'US/Alaska': 'Alaskan Standard Time',
- 'US/Aleutian': 'Aleutian Standard Time',
- 'US/Arizona': 'US Mountain Standard Time',
- 'US/Central': 'Central Standard Time',
- 'US/Eastern': 'Eastern Standard Time',
- 'US/Hawaii': 'Hawaiian Standard Time',
- 'US/Indiana-Starke': 'Central Standard Time',
- 'US/Michigan': 'Eastern Standard Time',
- 'US/Mountain': 'Mountain Standard Time',
- 'US/Pacific': 'Pacific Standard Time',
- 'US/Samoa': 'UTC-11',
- 'UTC': 'UTC',
- 'Universal': 'UTC',
- 'W-SU': 'Russian Standard Time',
- 'Zulu': 'UTC'}
+tz_win = {
+    "": "Central Standard Time (Mexico)",
+    "Africa/Abidjan": "Greenwich Standard Time",
+    "Africa/Accra": "Greenwich Standard Time",
+    "Africa/Addis_Ababa": "E. Africa Standard Time",
+    "Africa/Algiers": "W. Central Africa Standard Time",
+    "Africa/Asmara": "E. Africa Standard Time",
+    "Africa/Asmera": "E. Africa Standard Time",
+    "Africa/Bamako": "Greenwich Standard Time",
+    "Africa/Bangui": "W. Central Africa Standard Time",
+    "Africa/Banjul": "Greenwich Standard Time",
+    "Africa/Bissau": "Greenwich Standard Time",
+    "Africa/Blantyre": "South Africa Standard Time",
+    "Africa/Brazzaville": "W. Central Africa Standard Time",
+    "Africa/Bujumbura": "South Africa Standard Time",
+    "Africa/Cairo": "Egypt Standard Time",
+    "Africa/Casablanca": "Morocco Standard Time",
+    "Africa/Ceuta": "Romance Standard Time",
+    "Africa/Conakry": "Greenwich Standard Time",
+    "Africa/Dakar": "Greenwich Standard Time",
+    "Africa/Dar_es_Salaam": "E. Africa Standard Time",
+    "Africa/Djibouti": "E. Africa Standard Time",
+    "Africa/Douala": "W. Central Africa Standard Time",
+    "Africa/El_Aaiun": "Morocco Standard Time",
+    "Africa/Freetown": "Greenwich Standard Time",
+    "Africa/Gaborone": "South Africa Standard Time",
+    "Africa/Harare": "South Africa Standard Time",
+    "Africa/Johannesburg": "South Africa Standard Time",
+    "Africa/Juba": "South Sudan Standard Time",
+    "Africa/Kampala": "E. Africa Standard Time",
+    "Africa/Khartoum": "Sudan Standard Time",
+    "Africa/Kigali": "South Africa Standard Time",
+    "Africa/Kinshasa": "W. Central Africa Standard Time",
+    "Africa/Lagos": "W. Central Africa Standard Time",
+    "Africa/Libreville": "W. Central Africa Standard Time",
+    "Africa/Lome": "Greenwich Standard Time",
+    "Africa/Luanda": "W. Central Africa Standard Time",
+    "Africa/Lubumbashi": "South Africa Standard Time",
+    "Africa/Lusaka": "South Africa Standard Time",
+    "Africa/Malabo": "W. Central Africa Standard Time",
+    "Africa/Maputo": "South Africa Standard Time",
+    "Africa/Maseru": "South Africa Standard Time",
+    "Africa/Mbabane": "South Africa Standard Time",
+    "Africa/Mogadishu": "E. Africa Standard Time",
+    "Africa/Monrovia": "Greenwich Standard Time",
+    "Africa/Nairobi": "E. Africa Standard Time",
+    "Africa/Ndjamena": "W. Central Africa Standard Time",
+    "Africa/Niamey": "W. Central Africa Standard Time",
+    "Africa/Nouakchott": "Greenwich Standard Time",
+    "Africa/Ouagadougou": "Greenwich Standard Time",
+    "Africa/Porto-Novo": "W. Central Africa Standard Time",
+    "Africa/Sao_Tome": "Sao Tome Standard Time",
+    "Africa/Timbuktu": "Greenwich Standard Time",
+    "Africa/Tripoli": "Libya Standard Time",
+    "Africa/Tunis": "W. Central Africa Standard Time",
+    "Africa/Windhoek": "Namibia Standard Time",
+    "America/Adak": "Aleutian Standard Time",
+    "America/Anchorage": "Alaskan Standard Time",
+    "America/Anguilla": "SA Western Standard Time",
+    "America/Antigua": "SA Western Standard Time",
+    "America/Araguaina": "Tocantins Standard Time",
+    "America/Argentina/La_Rioja": "Argentina Standard Time",
+    "America/Argentina/Rio_Gallegos": "Argentina Standard Time",
+    "America/Argentina/Salta": "Argentina Standard Time",
+    "America/Argentina/San_Juan": "Argentina Standard Time",
+    "America/Argentina/San_Luis": "Argentina Standard Time",
+    "America/Argentina/Tucuman": "Argentina Standard Time",
+    "America/Argentina/Ushuaia": "Argentina Standard Time",
+    "America/Aruba": "SA Western Standard Time",
+    "America/Asuncion": "Paraguay Standard Time",
+    "America/Atikokan": "SA Pacific Standard Time",
+    "America/Atka": "Aleutian Standard Time",
+    "America/Bahia": "Bahia Standard Time",
+    "America/Bahia_Banderas": "Central Standard Time (Mexico)",
+    "America/Barbados": "SA Western Standard Time",
+    "America/Belem": "SA Eastern Standard Time",
+    "America/Belize": "Central America Standard Time",
+    "America/Blanc-Sablon": "SA Western Standard Time",
+    "America/Boa_Vista": "SA Western Standard Time",
+    "America/Bogota": "SA Pacific Standard Time",
+    "America/Boise": "Mountain Standard Time",
+    "America/Buenos_Aires": "Argentina Standard Time",
+    "America/Cambridge_Bay": "Mountain Standard Time",
+    "America/Campo_Grande": "Central Brazilian Standard Time",
+    "America/Cancun": "Eastern Standard Time (Mexico)",
+    "America/Caracas": "Venezuela Standard Time",
+    "America/Catamarca": "Argentina Standard Time",
+    "America/Cayenne": "SA Eastern Standard Time",
+    "America/Cayman": "SA Pacific Standard Time",
+    "America/Chicago": "Central Standard Time",
+    "America/Chihuahua": "Central Standard Time (Mexico)",
+    "America/Ciudad_Juarez": "Mountain Standard Time",
+    "America/Coral_Harbour": "SA Pacific Standard Time",
+    "America/Cordoba": "Argentina Standard Time",
+    "America/Costa_Rica": "Central America Standard Time",
+    "America/Creston": "US Mountain Standard Time",
+    "America/Cuiaba": "Central Brazilian Standard Time",
+    "America/Curacao": "SA Western Standard Time",
+    "America/Danmarkshavn": "Greenwich Standard Time",
+    "America/Dawson": "Yukon Standard Time",
+    "America/Dawson_Creek": "US Mountain Standard Time",
+    "America/Denver": "Mountain Standard Time",
+    "America/Detroit": "Eastern Standard Time",
+    "America/Dominica": "SA Western Standard Time",
+    "America/Edmonton": "Mountain Standard Time",
+    "America/Eirunepe": "SA Pacific Standard Time",
+    "America/El_Salvador": "Central America Standard Time",
+    "America/Ensenada": "Pacific Standard Time (Mexico)",
+    "America/Fort_Nelson": "US Mountain Standard Time",
+    "America/Fortaleza": "SA Eastern Standard Time",
+    "America/Glace_Bay": "Atlantic Standard Time",
+    "America/Godthab": "Greenland Standard Time",
+    "America/Goose_Bay": "Atlantic Standard Time",
+    "America/Grand_Turk": "Turks And Caicos Standard Time",
+    "America/Grenada": "SA Western Standard Time",
+    "America/Guadeloupe": "SA Western Standard Time",
+    "America/Guatemala": "Central America Standard Time",
+    "America/Guayaquil": "SA Pacific Standard Time",
+    "America/Guyana": "SA Western Standard Time",
+    "America/Halifax": "Atlantic Standard Time",
+    "America/Havana": "Cuba Standard Time",
+    "America/Hermosillo": "US Mountain Standard Time",
+    "America/Indiana/Knox": "Central Standard Time",
+    "America/Indiana/Marengo": "US Eastern Standard Time",
+    "America/Indiana/Petersburg": "Eastern Standard Time",
+    "America/Indiana/Tell_City": "Central Standard Time",
+    "America/Indiana/Vevay": "US Eastern Standard Time",
+    "America/Indiana/Vincennes": "Eastern Standard Time",
+    "America/Indiana/Winamac": "Eastern Standard Time",
+    "America/Indianapolis": "US Eastern Standard Time",
+    "America/Inuvik": "Mountain Standard Time",
+    "America/Iqaluit": "Eastern Standard Time",
+    "America/Jamaica": "SA Pacific Standard Time",
+    "America/Jujuy": "Argentina Standard Time",
+    "America/Juneau": "Alaskan Standard Time",
+    "America/Kentucky/Monticello": "Eastern Standard Time",
+    "America/Knox_IN": "Central Standard Time",
+    "America/Kralendijk": "SA Western Standard Time",
+    "America/La_Paz": "SA Western Standard Time",
+    "America/Lima": "SA Pacific Standard Time",
+    "America/Los_Angeles": "Pacific Standard Time",
+    "America/Louisville": "Eastern Standard Time",
+    "America/Lower_Princes": "SA Western Standard Time",
+    "America/Maceio": "SA Eastern Standard Time",
+    "America/Managua": "Central America Standard Time",
+    "America/Manaus": "SA Western Standard Time",
+    "America/Marigot": "SA Western Standard Time",
+    "America/Martinique": "SA Western Standard Time",
+    "America/Matamoros": "Central Standard Time",
+    "America/Mazatlan": "Mountain Standard Time (Mexico)",
+    "America/Mendoza": "Argentina Standard Time",
+    "America/Menominee": "Central Standard Time",
+    "America/Merida": "Central Standard Time (Mexico)",
+    "America/Metlakatla": "Alaskan Standard Time",
+    "America/Mexico_City": "Central Standard Time (Mexico)",
+    "America/Miquelon": "Saint Pierre Standard Time",
+    "America/Moncton": "Atlantic Standard Time",
+    "America/Monterrey": "Central Standard Time (Mexico)",
+    "America/Montevideo": "Montevideo Standard Time",
+    "America/Montreal": "Eastern Standard Time",
+    "America/Montserrat": "SA Western Standard Time",
+    "America/Nassau": "Eastern Standard Time",
+    "America/New_York": "Eastern Standard Time",
+    "America/Nipigon": "Eastern Standard Time",
+    "America/Nome": "Alaskan Standard Time",
+    "America/Noronha": "UTC-02",
+    "America/North_Dakota/Beulah": "Central Standard Time",
+    "America/North_Dakota/Center": "Central Standard Time",
+    "America/North_Dakota/New_Salem": "Central Standard Time",
+    "America/Ojinaga": "Central Standard Time",
+    "America/Panama": "SA Pacific Standard Time",
+    "America/Pangnirtung": "Eastern Standard Time",
+    "America/Paramaribo": "SA Eastern Standard Time",
+    "America/Phoenix": "US Mountain Standard Time",
+    "America/Port-au-Prince": "Haiti Standard Time",
+    "America/Port_of_Spain": "SA Western Standard Time",
+    "America/Porto_Acre": "SA Pacific Standard Time",
+    "America/Porto_Velho": "SA Western Standard Time",
+    "America/Puerto_Rico": "SA Western Standard Time",
+    "America/Punta_Arenas": "Magallanes Standard Time",
+    "America/Rainy_River": "Central Standard Time",
+    "America/Rankin_Inlet": "Central Standard Time",
+    "America/Recife": "SA Eastern Standard Time",
+    "America/Regina": "Canada Central Standard Time",
+    "America/Resolute": "Central Standard Time",
+    "America/Rio_Branco": "SA Pacific Standard Time",
+    "America/Santa_Isabel": "Pacific Standard Time (Mexico)",
+    "America/Santarem": "SA Eastern Standard Time",
+    "America/Santiago": "Pacific SA Standard Time",
+    "America/Santo_Domingo": "SA Western Standard Time",
+    "America/Sao_Paulo": "E. South America Standard Time",
+    "America/Scoresbysund": "Azores Standard Time",
+    "America/Shiprock": "Mountain Standard Time",
+    "America/Sitka": "Alaskan Standard Time",
+    "America/St_Barthelemy": "SA Western Standard Time",
+    "America/St_Johns": "Newfoundland Standard Time",
+    "America/St_Kitts": "SA Western Standard Time",
+    "America/St_Lucia": "SA Western Standard Time",
+    "America/St_Thomas": "SA Western Standard Time",
+    "America/St_Vincent": "SA Western Standard Time",
+    "America/Swift_Current": "Canada Central Standard Time",
+    "America/Tegucigalpa": "Central America Standard Time",
+    "America/Thule": "Atlantic Standard Time",
+    "America/Thunder_Bay": "Eastern Standard Time",
+    "America/Tijuana": "Pacific Standard Time (Mexico)",
+    "America/Toronto": "Eastern Standard Time",
+    "America/Tortola": "SA Western Standard Time",
+    "America/Vancouver": "Pacific Standard Time",
+    "America/Virgin": "SA Western Standard Time",
+    "America/Whitehorse": "Yukon Standard Time",
+    "America/Winnipeg": "Central Standard Time",
+    "America/Yakutat": "Alaskan Standard Time",
+    "America/Yellowknife": "Mountain Standard Time",
+    "Antarctica/Casey": "Central Pacific Standard Time",
+    "Antarctica/Davis": "SE Asia Standard Time",
+    "Antarctica/DumontDUrville": "West Pacific Standard Time",
+    "Antarctica/Macquarie": "Tasmania Standard Time",
+    "Antarctica/Mawson": "West Asia Standard Time",
+    "Antarctica/McMurdo": "New Zealand Standard Time",
+    "Antarctica/Palmer": "SA Eastern Standard Time",
+    "Antarctica/Rothera": "SA Eastern Standard Time",
+    "Antarctica/South_Pole": "New Zealand Standard Time",
+    "Antarctica/Syowa": "Arab Standard Time",
+    "Antarctica/Vostok": "Central Asia Standard Time",
+    "Arctic/Longyearbyen": "W. Europe Standard Time",
+    "Asia/Aden": "Arab Standard Time",
+    "Asia/Almaty": "Central Asia Standard Time",
+    "Asia/Amman": "Jordan Standard Time",
+    "Asia/Anadyr": "Russia Time Zone 11",
+    "Asia/Aqtau": "West Asia Standard Time",
+    "Asia/Aqtobe": "West Asia Standard Time",
+    "Asia/Ashgabat": "West Asia Standard Time",
+    "Asia/Ashkhabad": "West Asia Standard Time",
+    "Asia/Atyrau": "West Asia Standard Time",
+    "Asia/Baghdad": "Arabic Standard Time",
+    "Asia/Bahrain": "Arab Standard Time",
+    "Asia/Baku": "Azerbaijan Standard Time",
+    "Asia/Bangkok": "SE Asia Standard Time",
+    "Asia/Barnaul": "Altai Standard Time",
+    "Asia/Beirut": "Middle East Standard Time",
+    "Asia/Bishkek": "Central Asia Standard Time",
+    "Asia/Brunei": "Singapore Standard Time",
+    "Asia/Calcutta": "India Standard Time",
+    "Asia/Chita": "Transbaikal Standard Time",
+    "Asia/Choibalsan": "Ulaanbaatar Standard Time",
+    "Asia/Chongqing": "China Standard Time",
+    "Asia/Chungking": "China Standard Time",
+    "Asia/Colombo": "Sri Lanka Standard Time",
+    "Asia/Dacca": "Bangladesh Standard Time",
+    "Asia/Damascus": "Syria Standard Time",
+    "Asia/Dhaka": "Bangladesh Standard Time",
+    "Asia/Dili": "Tokyo Standard Time",
+    "Asia/Dubai": "Arabian Standard Time",
+    "Asia/Dushanbe": "West Asia Standard Time",
+    "Asia/Famagusta": "GTB Standard Time",
+    "Asia/Gaza": "West Bank Standard Time",
+    "Asia/Harbin": "China Standard Time",
+    "Asia/Hebron": "West Bank Standard Time",
+    "Asia/Hong_Kong": "China Standard Time",
+    "Asia/Hovd": "W. Mongolia Standard Time",
+    "Asia/Irkutsk": "North Asia East Standard Time",
+    "Asia/Istanbul": "Turkey Standard Time",
+    "Asia/Jakarta": "SE Asia Standard Time",
+    "Asia/Jayapura": "Tokyo Standard Time",
+    "Asia/Jerusalem": "Israel Standard Time",
+    "Asia/Kabul": "Afghanistan Standard Time",
+    "Asia/Kamchatka": "Russia Time Zone 11",
+    "Asia/Karachi": "Pakistan Standard Time",
+    "Asia/Kashgar": "Central Asia Standard Time",
+    "Asia/Katmandu": "Nepal Standard Time",
+    "Asia/Khandyga": "Yakutsk Standard Time",
+    "Asia/Krasnoyarsk": "North Asia Standard Time",
+    "Asia/Kuala_Lumpur": "Singapore Standard Time",
+    "Asia/Kuching": "Singapore Standard Time",
+    "Asia/Kuwait": "Arab Standard Time",
+    "Asia/Macao": "China Standard Time",
+    "Asia/Macau": "China Standard Time",
+    "Asia/Magadan": "Magadan Standard Time",
+    "Asia/Makassar": "Singapore Standard Time",
+    "Asia/Manila": "Singapore Standard Time",
+    "Asia/Muscat": "Arabian Standard Time",
+    "Asia/Nicosia": "GTB Standard Time",
+    "Asia/Novokuznetsk": "North Asia Standard Time",
+    "Asia/Novosibirsk": "N. Central Asia Standard Time",
+    "Asia/Omsk": "Omsk Standard Time",
+    "Asia/Oral": "West Asia Standard Time",
+    "Asia/Phnom_Penh": "SE Asia Standard Time",
+    "Asia/Pontianak": "SE Asia Standard Time",
+    "Asia/Pyongyang": "North Korea Standard Time",
+    "Asia/Qatar": "Arab Standard Time",
+    "Asia/Qostanay": "Central Asia Standard Time",
+    "Asia/Qyzylorda": "Qyzylorda Standard Time",
+    "Asia/Rangoon": "Myanmar Standard Time",
+    "Asia/Riyadh": "Arab Standard Time",
+    "Asia/Saigon": "SE Asia Standard Time",
+    "Asia/Sakhalin": "Sakhalin Standard Time",
+    "Asia/Samarkand": "West Asia Standard Time",
+    "Asia/Seoul": "Korea Standard Time",
+    "Asia/Shanghai": "China Standard Time",
+    "Asia/Singapore": "Singapore Standard Time",
+    "Asia/Srednekolymsk": "Russia Time Zone 10",
+    "Asia/Taipei": "Taipei Standard Time",
+    "Asia/Tashkent": "West Asia Standard Time",
+    "Asia/Tbilisi": "Georgian Standard Time",
+    "Asia/Tehran": "Iran Standard Time",
+    "Asia/Tel_Aviv": "Israel Standard Time",
+    "Asia/Thimbu": "Bangladesh Standard Time",
+    "Asia/Thimphu": "Bangladesh Standard Time",
+    "Asia/Tokyo": "Tokyo Standard Time",
+    "Asia/Tomsk": "Tomsk Standard Time",
+    "Asia/Ujung_Pandang": "Singapore Standard Time",
+    "Asia/Ulaanbaatar": "Ulaanbaatar Standard Time",
+    "Asia/Ulan_Bator": "Ulaanbaatar Standard Time",
+    "Asia/Urumqi": "Central Asia Standard Time",
+    "Asia/Ust-Nera": "Vladivostok Standard Time",
+    "Asia/Vientiane": "SE Asia Standard Time",
+    "Asia/Vladivostok": "Vladivostok Standard Time",
+    "Asia/Yakutsk": "Yakutsk Standard Time",
+    "Asia/Yekaterinburg": "Ekaterinburg Standard Time",
+    "Asia/Yerevan": "Caucasus Standard Time",
+    "Atlantic/Azores": "Azores Standard Time",
+    "Atlantic/Bermuda": "Atlantic Standard Time",
+    "Atlantic/Canary": "GMT Standard Time",
+    "Atlantic/Cape_Verde": "Cape Verde Standard Time",
+    "Atlantic/Faeroe": "GMT Standard Time",
+    "Atlantic/Jan_Mayen": "W. Europe Standard Time",
+    "Atlantic/Madeira": "GMT Standard Time",
+    "Atlantic/Reykjavik": "Greenwich Standard Time",
+    "Atlantic/South_Georgia": "UTC-02",
+    "Atlantic/St_Helena": "Greenwich Standard Time",
+    "Atlantic/Stanley": "SA Eastern Standard Time",
+    "Australia/ACT": "AUS Eastern Standard Time",
+    "Australia/Adelaide": "Cen. Australia Standard Time",
+    "Australia/Brisbane": "E. Australia Standard Time",
+    "Australia/Broken_Hill": "Cen. Australia Standard Time",
+    "Australia/Canberra": "AUS Eastern Standard Time",
+    "Australia/Currie": "Tasmania Standard Time",
+    "Australia/Darwin": "AUS Central Standard Time",
+    "Australia/Eucla": "Aus Central W. Standard Time",
+    "Australia/Hobart": "Tasmania Standard Time",
+    "Australia/LHI": "Lord Howe Standard Time",
+    "Australia/Lindeman": "E. Australia Standard Time",
+    "Australia/Lord_Howe": "Lord Howe Standard Time",
+    "Australia/Melbourne": "AUS Eastern Standard Time",
+    "Australia/NSW": "AUS Eastern Standard Time",
+    "Australia/North": "AUS Central Standard Time",
+    "Australia/Perth": "W. Australia Standard Time",
+    "Australia/Queensland": "E. Australia Standard Time",
+    "Australia/South": "Cen. Australia Standard Time",
+    "Australia/Sydney": "AUS Eastern Standard Time",
+    "Australia/Tasmania": "Tasmania Standard Time",
+    "Australia/Victoria": "AUS Eastern Standard Time",
+    "Australia/West": "W. Australia Standard Time",
+    "Australia/Yancowinna": "Cen. Australia Standard Time",
+    "Brazil/Acre": "SA Pacific Standard Time",
+    "Brazil/DeNoronha": "UTC-02",
+    "Brazil/East": "E. South America Standard Time",
+    "Brazil/West": "SA Western Standard Time",
+    "CST6CDT": "Central Standard Time",
+    "Canada/Atlantic": "Atlantic Standard Time",
+    "Canada/Central": "Central Standard Time",
+    "Canada/Eastern": "Eastern Standard Time",
+    "Canada/Mountain": "Mountain Standard Time",
+    "Canada/Newfoundland": "Newfoundland Standard Time",
+    "Canada/Pacific": "Pacific Standard Time",
+    "Canada/Saskatchewan": "Canada Central Standard Time",
+    "Canada/Yukon": "Yukon Standard Time",
+    "Chile/Continental": "Pacific SA Standard Time",
+    "Chile/EasterIsland": "Easter Island Standard Time",
+    "Cuba": "Cuba Standard Time",
+    "EST5EDT": "Eastern Standard Time",
+    "Egypt": "Egypt Standard Time",
+    "Eire": "GMT Standard Time",
+    "Etc/GMT": "UTC",
+    "Etc/GMT+0": "UTC",
+    "Etc/GMT+1": "Cape Verde Standard Time",
+    "Etc/GMT+10": "Hawaiian Standard Time",
+    "Etc/GMT+11": "UTC-11",
+    "Etc/GMT+12": "Dateline Standard Time",
+    "Etc/GMT+2": "UTC-02",
+    "Etc/GMT+3": "SA Eastern Standard Time",
+    "Etc/GMT+4": "SA Western Standard Time",
+    "Etc/GMT+5": "SA Pacific Standard Time",
+    "Etc/GMT+6": "Central America Standard Time",
+    "Etc/GMT+7": "US Mountain Standard Time",
+    "Etc/GMT+8": "UTC-08",
+    "Etc/GMT+9": "UTC-09",
+    "Etc/GMT-0": "UTC",
+    "Etc/GMT-1": "W. Central Africa Standard Time",
+    "Etc/GMT-10": "West Pacific Standard Time",
+    "Etc/GMT-11": "Central Pacific Standard Time",
+    "Etc/GMT-12": "UTC+12",
+    "Etc/GMT-13": "UTC+13",
+    "Etc/GMT-14": "Line Islands Standard Time",
+    "Etc/GMT-2": "South Africa Standard Time",
+    "Etc/GMT-3": "E. Africa Standard Time",
+    "Etc/GMT-4": "Arabian Standard Time",
+    "Etc/GMT-5": "West Asia Standard Time",
+    "Etc/GMT-6": "Central Asia Standard Time",
+    "Etc/GMT-7": "SE Asia Standard Time",
+    "Etc/GMT-8": "Singapore Standard Time",
+    "Etc/GMT-9": "Tokyo Standard Time",
+    "Etc/GMT0": "UTC",
+    "Etc/Greenwich": "UTC",
+    "Etc/UCT": "UTC",
+    "Etc/UTC": "UTC",
+    "Etc/Universal": "UTC",
+    "Etc/Zulu": "UTC",
+    "Europe/Amsterdam": "Romance Standard Time",
+    "Europe/Andorra": "W. Europe Standard Time",
+    "Europe/Astrakhan": "Astrakhan Standard Time",
+    "Europe/Athens": "GTB Standard Time",
+    "Europe/Belfast": "GMT Standard Time",
+    "Europe/Belgrade": "Central Europe Standard Time",
+    "Europe/Berlin": "W. Europe Standard Time",
+    "Europe/Bratislava": "Central Europe Standard Time",
+    "Europe/Brussels": "Romance Standard Time",
+    "Europe/Bucharest": "GTB Standard Time",
+    "Europe/Budapest": "Central Europe Standard Time",
+    "Europe/Busingen": "W. Europe Standard Time",
+    "Europe/Chisinau": "E. Europe Standard Time",
+    "Europe/Copenhagen": "W. Europe Standard Time",
+    "Europe/Dublin": "GMT Standard Time",
+    "Europe/Gibraltar": "W. Europe Standard Time",
+    "Europe/Guernsey": "GMT Standard Time",
+    "Europe/Helsinki": "FLE Standard Time",
+    "Europe/Isle_of_Man": "GMT Standard Time",
+    "Europe/Istanbul": "Turkey Standard Time",
+    "Europe/Jersey": "GMT Standard Time",
+    "Europe/Kaliningrad": "Kaliningrad Standard Time",
+    "Europe/Kiev": "FLE Standard Time",
+    "Europe/Kirov": "Russian Standard Time",
+    "Europe/Lisbon": "GMT Standard Time",
+    "Europe/Ljubljana": "Central Europe Standard Time",
+    "Europe/London": "GMT Standard Time",
+    "Europe/Luxembourg": "Romance Standard Time",
+    "Europe/Madrid": "Romance Standard Time",
+    "Europe/Malta": "W. Europe Standard Time",
+    "Europe/Mariehamn": "FLE Standard Time",
+    "Europe/Minsk": "Belarus Standard Time",
+    "Europe/Monaco": "Romance Standard Time",
+    "Europe/Moscow": "Russian Standard Time",
+    "Europe/Nicosia": "GTB Standard Time",
+    "Europe/Oslo": "W. Europe Standard Time",
+    "Europe/Paris": "Romance Standard Time",
+    "Europe/Podgorica": "Central Europe Standard Time",
+    "Europe/Prague": "Central Europe Standard Time",
+    "Europe/Riga": "FLE Standard Time",
+    "Europe/Rome": "W. Europe Standard Time",
+    "Europe/Samara": "Russia Time Zone 3",
+    "Europe/San_Marino": "W. Europe Standard Time",
+    "Europe/Sarajevo": "Central Europe Standard Time",
+    "Europe/Saratov": "Saratov Standard Time",
+    "Europe/Simferopol": "Russian Standard Time",
+    "Europe/Skopje": "Central Europe Standard Time",
+    "Europe/Sofia": "FLE Standard Time",
+    "Europe/Stockholm": "W. Europe Standard Time",
+    "Europe/Tallinn": "FLE Standard Time",
+    "Europe/Tirane": "Central Europe Standard Time",
+    "Europe/Tiraspol": "E. Europe Standard Time",
+    "Europe/Ulyanovsk": "Astrakhan Standard Time",
+    "Europe/Uzhgorod": "FLE Standard Time",
+    "Europe/Vaduz": "W. Europe Standard Time",
+    "Europe/Vatican": "W. Europe Standard Time",
+    "Europe/Vienna": "W. Europe Standard Time",
+    "Europe/Vilnius": "FLE Standard Time",
+    "Europe/Volgograd": "Volgograd Standard Time",
+    "Europe/Warsaw": "Central European Standard Time",
+    "Europe/Zagreb": "Central Europe Standard Time",
+    "Europe/Zaporozhye": "FLE Standard Time",
+    "Europe/Zurich": "W. Europe Standard Time",
+    "GB": "GMT Standard Time",
+    "GB-Eire": "GMT Standard Time",
+    "GMT+0": "UTC",
+    "GMT-0": "UTC",
+    "GMT0": "UTC",
+    "Greenwich": "UTC",
+    "Hongkong": "China Standard Time",
+    "Iceland": "Greenwich Standard Time",
+    "Indian/Antananarivo": "E. Africa Standard Time",
+    "Indian/Chagos": "Central Asia Standard Time",
+    "Indian/Christmas": "SE Asia Standard Time",
+    "Indian/Cocos": "Myanmar Standard Time",
+    "Indian/Comoro": "E. Africa Standard Time",
+    "Indian/Kerguelen": "West Asia Standard Time",
+    "Indian/Mahe": "Arabian Standard Time",
+    "Indian/Maldives": "West Asia Standard Time",
+    "Indian/Mauritius": "Mauritius Standard Time",
+    "Indian/Mayotte": "E. Africa Standard Time",
+    "Indian/Reunion": "Arabian Standard Time",
+    "Iran": "Iran Standard Time",
+    "Israel": "Israel Standard Time",
+    "Jamaica": "SA Pacific Standard Time",
+    "Japan": "Tokyo Standard Time",
+    "Kwajalein": "UTC+12",
+    "Libya": "Libya Standard Time",
+    "MST7MDT": "Mountain Standard Time",
+    "Mexico/BajaNorte": "Pacific Standard Time (Mexico)",
+    "Mexico/BajaSur": "Mountain Standard Time (Mexico)",
+    "Mexico/General": "Central Standard Time (Mexico)",
+    "NZ": "New Zealand Standard Time",
+    "NZ-CHAT": "Chatham Islands Standard Time",
+    "Navajo": "Mountain Standard Time",
+    "PRC": "China Standard Time",
+    "PST8PDT": "Pacific Standard Time",
+    "Pacific/Apia": "Samoa Standard Time",
+    "Pacific/Auckland": "New Zealand Standard Time",
+    "Pacific/Bougainville": "Bougainville Standard Time",
+    "Pacific/Chatham": "Chatham Islands Standard Time",
+    "Pacific/Chuuk": "West Pacific Standard Time",
+    "Pacific/Easter": "Easter Island Standard Time",
+    "Pacific/Efate": "Central Pacific Standard Time",
+    "Pacific/Enderbury": "UTC+13",
+    "Pacific/Fakaofo": "UTC+13",
+    "Pacific/Fiji": "Fiji Standard Time",
+    "Pacific/Funafuti": "UTC+12",
+    "Pacific/Galapagos": "Central America Standard Time",
+    "Pacific/Gambier": "UTC-09",
+    "Pacific/Guadalcanal": "Central Pacific Standard Time",
+    "Pacific/Guam": "West Pacific Standard Time",
+    "Pacific/Honolulu": "Hawaiian Standard Time",
+    "Pacific/Johnston": "Hawaiian Standard Time",
+    "Pacific/Kiritimati": "Line Islands Standard Time",
+    "Pacific/Kosrae": "Central Pacific Standard Time",
+    "Pacific/Kwajalein": "UTC+12",
+    "Pacific/Majuro": "UTC+12",
+    "Pacific/Marquesas": "Marquesas Standard Time",
+    "Pacific/Midway": "UTC-11",
+    "Pacific/Nauru": "UTC+12",
+    "Pacific/Niue": "UTC-11",
+    "Pacific/Norfolk": "Norfolk Standard Time",
+    "Pacific/Noumea": "Central Pacific Standard Time",
+    "Pacific/Pago_Pago": "UTC-11",
+    "Pacific/Palau": "Tokyo Standard Time",
+    "Pacific/Pitcairn": "UTC-08",
+    "Pacific/Pohnpei": "Central Pacific Standard Time",
+    "Pacific/Ponape": "Central Pacific Standard Time",
+    "Pacific/Port_Moresby": "West Pacific Standard Time",
+    "Pacific/Rarotonga": "Hawaiian Standard Time",
+    "Pacific/Saipan": "West Pacific Standard Time",
+    "Pacific/Samoa": "UTC-11",
+    "Pacific/Tahiti": "Hawaiian Standard Time",
+    "Pacific/Tarawa": "UTC+12",
+    "Pacific/Tongatapu": "Tonga Standard Time",
+    "Pacific/Truk": "West Pacific Standard Time",
+    "Pacific/Wake": "UTC+12",
+    "Pacific/Wallis": "UTC+12",
+    "Pacific/Yap": "West Pacific Standard Time",
+    "Poland": "Central European Standard Time",
+    "Portugal": "GMT Standard Time",
+    "ROC": "Taipei Standard Time",
+    "ROK": "Korea Standard Time",
+    "Singapore": "Singapore Standard Time",
+    "Turkey": "Turkey Standard Time",
+    "UCT": "UTC",
+    "US/Alaska": "Alaskan Standard Time",
+    "US/Aleutian": "Aleutian Standard Time",
+    "US/Arizona": "US Mountain Standard Time",
+    "US/Central": "Central Standard Time",
+    "US/Eastern": "Eastern Standard Time",
+    "US/Hawaii": "Hawaiian Standard Time",
+    "US/Indiana-Starke": "Central Standard Time",
+    "US/Michigan": "Eastern Standard Time",
+    "US/Mountain": "Mountain Standard Time",
+    "US/Pacific": "Pacific Standard Time",
+    "US/Samoa": "UTC-11",
+    "UTC": "UTC",
+    "Universal": "UTC",
+    "W-SU": "Russian Standard Time",
+    "Zulu": "UTC",
+}
diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index e0bd159b..1027cf23 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -1,4 +1,4 @@
-apscheduler==3.10.1
+apscheduler==3.10.4
 importlib-metadata==6.8.0
 importlib-resources==6.0.1
 pyinstaller==5.13.0
diff --git a/requirements.txt b/requirements.txt
index 85039862..472235de 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,5 +1,5 @@
 appdirs==1.4.4
-apscheduler==3.10.1
+apscheduler==3.10.4
 arrow==1.2.3
 backports.csv==1.0.7
 backports.functools-lru-cache==1.6.6

From b2c16eba078b20691b2fbb632db054fcfb9f00a8 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 24 Aug 2023 12:10:56 -0700
Subject: [PATCH 447/743] Bump plexapi from 4.13.4 to 4.15.0 (#2132)

* Bump plexapi from 4.13.4 to 4.15.0

Bumps [plexapi](https://github.com/pkkid/python-plexapi) from 4.13.4 to 4.15.0.
- [Release notes](https://github.com/pkkid/python-plexapi/releases)
- [Commits](https://github.com/pkkid/python-plexapi/compare/4.13.4...4.15.0)

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

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

* Update plexapi==4.15.0

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/plexapi/audio.py      |  73 ++++---
 lib/plexapi/base.py       | 222 +++++++++++++---------
 lib/plexapi/client.py     |   1 +
 lib/plexapi/collection.py |   9 +-
 lib/plexapi/config.py     |   4 +-
 lib/plexapi/const.py      |   4 +-
 lib/plexapi/library.py    | 360 ++++++++++++++++++++++++-----------
 lib/plexapi/media.py      |  15 +-
 lib/plexapi/mixins.py     | 218 +++++++++++++--------
 lib/plexapi/myplex.py     | 388 +++++++++++++++++++++++++-------------
 lib/plexapi/photo.py      |   8 +-
 lib/plexapi/playlist.py   |   3 +-
 lib/plexapi/playqueue.py  |   2 +-
 lib/plexapi/server.py     |  48 ++---
 lib/plexapi/settings.py   |   2 +-
 lib/plexapi/sonos.py      |   1 +
 lib/plexapi/utils.py      |  30 ++-
 lib/plexapi/video.py      | 132 ++++++++-----
 requirements.txt          |   2 +-
 19 files changed, 988 insertions(+), 534 deletions(-)

diff --git a/lib/plexapi/audio.py b/lib/plexapi/audio.py
index e5455fc8..e1382760 100644
--- a/lib/plexapi/audio.py
+++ b/lib/plexapi/audio.py
@@ -3,19 +3,17 @@ import os
 from urllib.parse import quote_plus
 
 from plexapi import media, utils
-from plexapi.base import Playable, PlexPartialObject, PlexSession
-from plexapi.exceptions import BadRequest, NotFound
+from plexapi.base import Playable, PlexPartialObject, PlexHistory, PlexSession
+from plexapi.exceptions import BadRequest
 from plexapi.mixins import (
     AdvancedSettingsMixin, SplitMergeMixin, UnmatchMatchMixin, ExtrasMixin, HubsMixin, PlayedUnplayedMixin, RatingMixin,
     ArtUrlMixin, ArtMixin, PosterUrlMixin, PosterMixin, ThemeMixin, ThemeUrlMixin,
-    AddedAtMixin, OriginallyAvailableMixin, SortTitleMixin, StudioMixin, SummaryMixin, TitleMixin,
-    TrackArtistMixin, TrackDiscNumberMixin, TrackNumberMixin,
-    CollectionMixin, CountryMixin, GenreMixin, LabelMixin, MoodMixin, SimilarArtistMixin, StyleMixin
+    ArtistEditMixins, AlbumEditMixins, TrackEditMixins
 )
 from plexapi.playlist import Playlist
 
 
-class Audio(PlexPartialObject, PlayedUnplayedMixin, AddedAtMixin):
+class Audio(PlexPartialObject, PlayedUnplayedMixin):
     """ Base class for all audio objects including :class:`~plexapi.audio.Artist`,
         :class:`~plexapi.audio.Album`, and :class:`~plexapi.audio.Track`.
 
@@ -132,8 +130,7 @@ class Artist(
     Audio,
     AdvancedSettingsMixin, SplitMergeMixin, UnmatchMatchMixin, ExtrasMixin, HubsMixin, RatingMixin,
     ArtMixin, PosterMixin, ThemeMixin,
-    SortTitleMixin, SummaryMixin, TitleMixin,
-    CollectionMixin, CountryMixin, GenreMixin, LabelMixin, MoodMixin, SimilarArtistMixin, StyleMixin
+    ArtistEditMixins
 ):
     """ Represents a single Artist.
 
@@ -181,14 +178,19 @@ class Artist(
             Parameters:
                 title (str): Title of the album to return.
         """
-        try:
-            return self.section().search(title, libtype='album', filters={'artist.id': self.ratingKey})[0]
-        except IndexError:
-            raise NotFound(f"Unable to find album '{title}'") from None
+        return self.section().get(
+            title=title,
+            libtype='album',
+            filters={'artist.id': self.ratingKey}
+        )
 
     def albums(self, **kwargs):
         """ Returns a list of :class:`~plexapi.audio.Album` objects by the artist. """
-        return self.section().search(libtype='album', filters={'artist.id': self.ratingKey}, **kwargs)
+        return self.section().search(
+            libtype='album',
+            filters={'artist.id': self.ratingKey},
+            **kwargs
+        )
 
     def track(self, title=None, album=None, track=None):
         """ Returns the :class:`~plexapi.audio.Track` that matches the specified title.
@@ -244,8 +246,7 @@ class Album(
     Audio,
     UnmatchMatchMixin, RatingMixin,
     ArtMixin, PosterMixin, ThemeUrlMixin,
-    OriginallyAvailableMixin, SortTitleMixin, StudioMixin, SummaryMixin, TitleMixin,
-    CollectionMixin, GenreMixin, LabelMixin, MoodMixin, StyleMixin
+    AlbumEditMixins
 ):
     """ Represents a single Album.
 
@@ -364,14 +365,14 @@ class Track(
     Audio, Playable,
     ExtrasMixin, RatingMixin,
     ArtUrlMixin, PosterUrlMixin, ThemeUrlMixin,
-    TitleMixin, TrackArtistMixin, TrackNumberMixin, TrackDiscNumberMixin,
-    CollectionMixin, LabelMixin, MoodMixin
+    TrackEditMixins
 ):
     """ Represents a single Track.
 
         Attributes:
             TAG (str): 'Directory'
             TYPE (str): 'track'
+            chapters (List<:class:`~plexapi.media.Chapter`>): List of Chapter objects.
             chapterSource (str): Unknown
             collections (List<:class:`~plexapi.media.Collection`>): List of collection objects.
             duration (int): Length of the track in milliseconds.
@@ -407,6 +408,7 @@ class Track(
         """ Load attribute values from Plex XML response. """
         Audio._loadData(self, data)
         Playable._loadData(self, data)
+        self.chapters = self.findItems(data, media.Chapter)
         self.chapterSource = data.attrib.get('chapterSource')
         self.collections = self.findItems(data, media.Collection)
         self.duration = utils.cast(int, data.attrib.get('duration'))
@@ -433,18 +435,6 @@ class Track(
         self.viewOffset = utils.cast(int, data.attrib.get('viewOffset', 0))
         self.year = utils.cast(int, data.attrib.get('year'))
 
-    def _prettyfilename(self):
-        """ Returns a filename for use in download. """
-        return f'{self.grandparentTitle} - {self.parentTitle} - {str(self.trackNumber).zfill(2)} - {self.title}'
-
-    def album(self):
-        """ Return the track's :class:`~plexapi.audio.Album`. """
-        return self.fetchItem(self.parentKey)
-
-    def artist(self):
-        """ Return the track's :class:`~plexapi.audio.Artist`. """
-        return self.fetchItem(self.grandparentKey)
-
     @property
     def locations(self):
         """ This does not exist in plex xml response but is added to have a common
@@ -460,6 +450,18 @@ class Track(
         """ Returns the track number. """
         return self.index
 
+    def _prettyfilename(self):
+        """ Returns a filename for use in download. """
+        return f'{self.grandparentTitle} - {self.parentTitle} - {str(self.trackNumber).zfill(2)} - {self.title}'
+
+    def album(self):
+        """ Return the track's :class:`~plexapi.audio.Album`. """
+        return self.fetchItem(self.parentKey)
+
+    def artist(self):
+        """ Return the track's :class:`~plexapi.audio.Artist`. """
+        return self.fetchItem(self.grandparentKey)
+
     def _defaultSyncTitle(self):
         """ Returns str, default title for a new syncItem. """
         return f'{self.grandparentTitle} - {self.parentTitle} - {self.title}'
@@ -480,3 +482,16 @@ class TrackSession(PlexSession, Track):
         """ Load attribute values from Plex XML response. """
         Track._loadData(self, data)
         PlexSession._loadData(self, data)
+
+
+@utils.registerPlexObject
+class TrackHistory(PlexHistory, Track):
+    """ Represents a single Track history entry
+        loaded from :func:`~plexapi.server.PlexServer.history`.
+    """
+    _HISTORYTYPE = True
+
+    def _loadData(self, data):
+        """ Load attribute values from Plex XML response. """
+        Track._loadData(self, data)
+        PlexHistory._loadData(self, data)
diff --git a/lib/plexapi/base.py b/lib/plexapi/base.py
index 9f888eed..88a31bbe 100644
--- a/lib/plexapi/base.py
+++ b/lib/plexapi/base.py
@@ -1,12 +1,12 @@
 # -*- coding: utf-8 -*-
 import re
 import weakref
+from functools import cached_property
 from urllib.parse import urlencode
 from xml.etree import ElementTree
 
-from plexapi import log, utils
+from plexapi import CONFIG, X_PLEX_CONTAINER_SIZE, log, utils
 from plexapi.exceptions import BadRequest, NotFound, UnknownType, Unsupported
-from plexapi.utils import cached_property
 
 USER_DONT_RELOAD_FOR_KEYS = set()
 _DONT_RELOAD_FOR_KEYS = {'key'}
@@ -50,9 +50,14 @@ class PlexObject:
         self._initpath = initpath or self.key
         self._parent = weakref.ref(parent) if parent is not None else None
         self._details_key = None
-        self._overwriteNone = True  # Allow overwriting previous attribute values with `None` when manually reloading
-        self._autoReload = True  # Automatically reload the object when accessing a missing attribute
-        self._edits = None  # Save batch edits for a single API call
+
+        # Allow overwriting previous attribute values with `None` when manually reloading
+        self._overwriteNone = True
+        # Automatically reload the object when accessing a missing attribute
+        self._autoReload = CONFIG.get('plexapi.autoreload', True, bool)
+        # Attribute to save batch edits for a single API call
+        self._edits = None
+
         if data is not None:
             self._loadData(data)
         self._details_key = self._buildDetailsKey()
@@ -87,7 +92,9 @@ class PlexObject:
         etype = elem.attrib.get('streamType', elem.attrib.get('tagType', elem.attrib.get('type')))
         ehash = f'{elem.tag}.{etype}' if etype else elem.tag
         if initpath == '/status/sessions':
-            ehash = f"{ehash}.{'session'}"
+            ehash = f"{ehash}.session"
+        elif initpath.startswith('/status/sessions/history'):
+            ehash = f"{ehash}.history"
         ecls = utils.PLEXOBJECTS.get(ehash, utils.PLEXOBJECTS.get(elem.tag))
         # log.debug('Building %s as %s', elem.tag, ecls.__name__)
         if ecls is not None:
@@ -147,47 +154,14 @@ class PlexObject:
         elem = ElementTree.fromstring(xml)
         return self._buildItemOrNone(elem, cls)
 
-    def fetchItem(self, ekey, cls=None, **kwargs):
-        """ Load the specified key to find and build the first item with the
-            specified tag and attrs. If no tag or attrs are specified then
-            the first item in the result set is returned.
-
-            Parameters:
-                ekey (str or int): Path in Plex to fetch items from. If an int is passed
-                    in, the key will be translated to /library/metadata/<key>. This allows
-                    fetching an item only knowing its key-id.
-                cls (:class:`~plexapi.base.PlexObject`): If you know the class of the
-                    items to be fetched, passing this in will help the parser ensure
-                    it only returns those items. By default we convert the xml elements
-                    with the best guess PlexObjects based on tag and type attrs.
-                etag (str): Only fetch items with the specified tag.
-                **kwargs (dict): Optionally add XML attribute to filter the items.
-                    See :func:`~plexapi.base.PlexObject.fetchItems` for more details
-                    on how this is used.
-        """
-        if ekey is None:
-            raise BadRequest('ekey was not provided')
-        if isinstance(ekey, int):
-            ekey = f'/library/metadata/{ekey}'
-
-        data = self._server.query(ekey)
-        item = self.findItem(data, cls, ekey, **kwargs)
-
-        if item:
-            librarySectionID = utils.cast(int, data.attrib.get('librarySectionID'))
-            if librarySectionID:
-                item.librarySectionID = librarySectionID
-            return item
-
-        clsname = cls.__name__ if cls else 'None'
-        raise NotFound(f'Unable to find elem: cls={clsname}, attrs={kwargs}')
-
-    def fetchItems(self, ekey, cls=None, container_start=None, container_size=None, **kwargs):
+    def fetchItems(self, ekey, cls=None, container_start=None, container_size=None, maxresults=None, **kwargs):
         """ Load the specified key to find and build all items with the specified tag
             and attrs.
 
             Parameters:
-                ekey (str): API URL path in Plex to fetch items from.
+                ekey (str or List<int>): API URL path in Plex to fetch items from. If a list of ints is passed
+                    in, the key will be translated to /library/metadata/<key1,key2,key3>. This allows
+                    fetching multiple items only knowing their key-ids.
                 cls (:class:`~plexapi.base.PlexObject`): If you know the class of the
                     items to be fetched, passing this in will help the parser ensure
                     it only returns those items. By default we convert the xml elements
@@ -195,6 +169,7 @@ class PlexObject:
                 etag (str): Only fetch items with the specified tag.
                 container_start (None, int): offset to get a subset of the data
                 container_size (None, int): How many items in data
+                maxresults (int, optional): Only return the specified number of results.
                 **kwargs (dict): Optionally add XML attribute to filter the items.
                     See the details below for more info.
 
@@ -259,39 +234,80 @@ class PlexObject:
         if ekey is None:
             raise BadRequest('ekey was not provided')
 
-        params = {}
-        if container_start is not None:
-            params["X-Plex-Container-Start"] = container_start
-        if container_size is not None:
-            params["X-Plex-Container-Size"] = container_size
+        if isinstance(ekey, list) and all(isinstance(key, int) for key in ekey):
+            ekey = f'/library/metadata/{",".join(str(key) for key in ekey)}'
 
-        data = self._server.query(ekey, params=params)
-        items = self.findItems(data, cls, ekey, **kwargs)
+        container_start = container_start or 0
+        container_size = container_size or X_PLEX_CONTAINER_SIZE
+        offset = container_start
 
-        librarySectionID = utils.cast(int, data.attrib.get('librarySectionID'))
-        if librarySectionID:
-            for item in items:
-                item.librarySectionID = librarySectionID
-        return items
+        if maxresults is not None:
+            container_size = min(container_size, maxresults)
 
-    def findItem(self, data, cls=None, initpath=None, rtag=None, **kwargs):
-        """ Load the specified data to find and build the first items with the specified tag
-            and attrs. See :func:`~plexapi.base.PlexObject.fetchItem` for more details
-            on how this is used.
+        results = []
+        subresults = []
+        headers = {}
+
+        while True:
+            headers['X-Plex-Container-Start'] = str(container_start)
+            headers['X-Plex-Container-Size'] = str(container_size)
+
+            data = self._server.query(ekey, headers=headers)
+            subresults = self.findItems(data, cls, ekey, **kwargs)
+            total_size = utils.cast(int, data.attrib.get('totalSize') or data.attrib.get('size')) or len(subresults)
+
+            if not subresults:
+                if offset > total_size:
+                    log.info('container_start is greater than the number of items')
+
+            librarySectionID = utils.cast(int, data.attrib.get('librarySectionID'))
+            if librarySectionID:
+                for item in subresults:
+                    item.librarySectionID = librarySectionID
+
+            results.extend(subresults)
+
+            wanted_number_of_items = total_size - offset
+            if maxresults is not None:
+                wanted_number_of_items = min(maxresults, wanted_number_of_items)
+                container_size = min(container_size, wanted_number_of_items - len(results))
+
+            if wanted_number_of_items <= len(results):
+                break
+
+            container_start += container_size
+
+            if container_start > total_size:
+                break
+
+        return results
+
+    def fetchItem(self, ekey, cls=None, **kwargs):
+        """ Load the specified key to find and build the first item with the
+            specified tag and attrs. If no tag or attrs are specified then
+            the first item in the result set is returned.
+
+            Parameters:
+                ekey (str or int): Path in Plex to fetch items from. If an int is passed
+                    in, the key will be translated to /library/metadata/<key>. This allows
+                    fetching an item only knowing its key-id.
+                cls (:class:`~plexapi.base.PlexObject`): If you know the class of the
+                    items to be fetched, passing this in will help the parser ensure
+                    it only returns those items. By default we convert the xml elements
+                    with the best guess PlexObjects based on tag and type attrs.
+                etag (str): Only fetch items with the specified tag.
+                **kwargs (dict): Optionally add XML attribute to filter the items.
+                    See :func:`~plexapi.base.PlexObject.fetchItems` for more details
+                    on how this is used.
         """
-        # filter on cls attrs if specified
-        if cls and cls.TAG and 'tag' not in kwargs:
-            kwargs['etag'] = cls.TAG
-        if cls and cls.TYPE and 'type' not in kwargs:
-            kwargs['type'] = cls.TYPE
-        # rtag to iter on a specific root tag
-        if rtag:
-            data = next(data.iter(rtag), [])
-        # loop through all data elements to find matches
-        for elem in data:
-            if self._checkAttrs(elem, **kwargs):
-                item = self._buildItemOrNone(elem, cls, initpath)
-                return item
+        if isinstance(ekey, int):
+            ekey = f'/library/metadata/{ekey}'
+
+        try:
+            return self.fetchItems(ekey, cls, **kwargs)[0]
+        except IndexError:
+            clsname = cls.__name__ if cls else 'None'
+            raise NotFound(f'Unable to find elem: cls={clsname}, attrs={kwargs}') from None
 
     def findItems(self, data, cls=None, initpath=None, rtag=None, **kwargs):
         """ Load the specified data to find and build all items with the specified tag
@@ -315,6 +331,16 @@ class PlexObject:
                     items.append(item)
         return items
 
+    def findItem(self, data, cls=None, initpath=None, rtag=None, **kwargs):
+        """ Load the specified data to find and build the first items with the specified tag
+            and attrs. See :func:`~plexapi.base.PlexObject.fetchItem` for more details
+            on how this is used.
+        """
+        try:
+            return self.findItems(data, cls, initpath, rtag, **kwargs)[0]
+        except IndexError:
+            return None
+
     def firstAttr(self, *attrs):
         """ Return the first attribute in attrs that is not None. """
         for attr in attrs:
@@ -475,7 +501,9 @@ class PlexPartialObject(PlexObject):
     }
 
     def __eq__(self, other):
-        return other not in [None, []] and self.key == other.key
+        if isinstance(other, PlexPartialObject):
+            return other not in [None, []] and self.key == other.key
+        return NotImplemented
 
     def __hash__(self):
         return hash(repr(self))
@@ -492,7 +520,7 @@ class PlexPartialObject(PlexObject):
         if attr.startswith('_'): return value
         if value not in (None, []): return value
         if self.isFullObject(): return value
-        if isinstance(self, PlexSession): return value
+        if isinstance(self, (PlexSession, PlexHistory)): return value
         if self._autoReload is False: return value
         # Log the reload.
         clsname = self.__class__.__name__
@@ -543,13 +571,10 @@ class PlexPartialObject(PlexObject):
             self._edits.update(kwargs)
             return self
 
-        if 'id' not in kwargs:
-            kwargs['id'] = self.ratingKey
         if 'type' not in kwargs:
             kwargs['type'] = utils.searchType(self._searchType)
 
-        part = f'/library/sections/{self.librarySectionID}/all{utils.joinArgs(kwargs)}'
-        self._server.query(part, method=self._server._session.put)
+        self.section()._edit(items=self, **kwargs)
         return self
 
     def edit(self, **kwargs):
@@ -643,7 +668,7 @@ class PlexPartialObject(PlexObject):
                 'have not allowed items to be deleted', self.key)
             raise
 
-    def history(self, maxresults=9999999, mindate=None):
+    def history(self, maxresults=None, mindate=None):
         """ Get Play History for a media item.
 
             Parameters:
@@ -681,17 +706,11 @@ class Playable:
         Albums which are all not playable.
 
         Attributes:
-            viewedAt (datetime): Datetime item was last viewed (history).
-            accountID (int): The associated :class:`~plexapi.server.SystemAccount` ID.
-            deviceID (int): The associated :class:`~plexapi.server.SystemDevice` ID.
             playlistItemID (int): Playlist item ID (only populated for :class:`~plexapi.playlist.Playlist` items).
             playQueueItemID (int): PlayQueue item ID (only populated for :class:`~plexapi.playlist.PlayQueue` items).
     """
 
     def _loadData(self, data):
-        self.viewedAt = utils.toDatetime(data.attrib.get('viewedAt'))               # history
-        self.accountID = utils.cast(int, data.attrib.get('accountID'))              # history
-        self.deviceID = utils.cast(int, data.attrib.get('deviceID'))                # history
         self.playlistItemID = utils.cast(int, data.attrib.get('playlistItemID'))    # playlist
         self.playQueueItemID = utils.cast(int, data.attrib.get('playQueueItemID'))  # playqueue
 
@@ -812,7 +831,7 @@ class Playable:
         """
         key = f'/:/progress?key={self.ratingKey}&identifier=com.plexapp.plugins.library&time={time}&state={state}'
         self._server.query(key)
-        self._reload(_overwriteNone=False)
+        return self
 
     def updateTimeline(self, time, state='stopped', duration=None):
         """ Set the timeline progress for this video.
@@ -830,7 +849,7 @@ class Playable:
         key = (f'/:/timeline?ratingKey={self.ratingKey}&key={self.key}&'
                f'identifier=com.plexapp.plugins.library&time={int(time)}&state={state}{durationStr}')
         self._server.query(key)
-        self._reload(_overwriteNone=False)
+        return self
 
 
 class PlexSession(object):
@@ -912,6 +931,35 @@ class PlexSession(object):
         return self._server.query(key, params=params)
 
 
+class PlexHistory(object):
+    """ This is a general place to store functions specific to media that is a Plex history item.
+
+        Attributes:
+            accountID (int): The associated :class:`~plexapi.server.SystemAccount` ID.
+            deviceID (int): The associated :class:`~plexapi.server.SystemDevice` ID.
+            historyKey (str): API URL (/status/sessions/history/<historyID>).
+            viewedAt (datetime): Datetime item was last watched.
+    """
+
+    def _loadData(self, data):
+        self.accountID = utils.cast(int, data.attrib.get('accountID'))
+        self.deviceID = utils.cast(int, data.attrib.get('deviceID'))
+        self.historyKey = data.attrib.get('historyKey')
+        self.viewedAt = utils.toDatetime(data.attrib.get('viewedAt'))
+
+    def _reload(self, **kwargs):
+        """ Reload the data for the history entry. """
+        raise NotImplementedError('History objects cannot be reloaded. Use source() to get the source media item.')
+
+    def source(self):
+        """ Return the source media object for the history entry. """
+        return self.fetchItem(self._details_key)
+
+    def delete(self):
+        """ Delete the history entry. """
+        return self._server.query(self.historyKey, method=self._server._session.delete)
+
+
 class MediaContainer(PlexObject):
     """ Represents a single MediaContainer.
 
diff --git a/lib/plexapi/client.py b/lib/plexapi/client.py
index b23518ad..2b4283c7 100644
--- a/lib/plexapi/client.py
+++ b/lib/plexapi/client.py
@@ -3,6 +3,7 @@ import time
 from xml.etree import ElementTree
 
 import requests
+
 from plexapi import BASE_HEADERS, CONFIG, TIMEOUT, log, logfilter, utils
 from plexapi.base import PlexObject
 from plexapi.exceptions import BadRequest, NotFound, Unauthorized, Unsupported
diff --git a/lib/plexapi/collection.py b/lib/plexapi/collection.py
index 9d754b1b..d4820fe2 100644
--- a/lib/plexapi/collection.py
+++ b/lib/plexapi/collection.py
@@ -8,8 +8,7 @@ from plexapi.library import LibrarySection, ManagedHub
 from plexapi.mixins import (
     AdvancedSettingsMixin, SmartFilterMixin, HubsMixin, RatingMixin,
     ArtMixin, PosterMixin, ThemeMixin,
-    AddedAtMixin, ContentRatingMixin, SortTitleMixin, SummaryMixin, TitleMixin,
-    LabelMixin
+    CollectionEditMixins
 )
 from plexapi.utils import deprecated
 
@@ -19,8 +18,7 @@ class Collection(
     PlexPartialObject,
     AdvancedSettingsMixin, SmartFilterMixin, HubsMixin, RatingMixin,
     ArtMixin, PosterMixin, ThemeMixin,
-    AddedAtMixin, ContentRatingMixin, SortTitleMixin, SummaryMixin, TitleMixin,
-    LabelMixin
+    CollectionEditMixins
 ):
     """ Represents a single Collection.
 
@@ -222,6 +220,7 @@ class Collection(
                 .. code-block:: python
 
                     collection.updateMode(user="user")
+
         """
         if not self.smart:
             raise BadRequest('Cannot change collection filtering user for a non-smart collection.')
@@ -250,6 +249,7 @@ class Collection(
                 .. code-block:: python
 
                     collection.updateMode(mode="hide")
+
         """
         mode_dict = {
             'default': -1,
@@ -276,6 +276,7 @@ class Collection(
                 .. code-block:: python
 
                     collection.updateSort(mode="alpha")
+
         """
         if self.smart:
             raise BadRequest('Cannot change collection order for a smart collection.')
diff --git a/lib/plexapi/config.py b/lib/plexapi/config.py
index 3b93f869..8bbf1f31 100644
--- a/lib/plexapi/config.py
+++ b/lib/plexapi/config.py
@@ -3,6 +3,8 @@ import os
 from collections import defaultdict
 from configparser import ConfigParser
 
+from plexapi import utils
+
 
 class PlexConfig(ConfigParser):
     """ PlexAPI configuration object. Settings are stored in an INI file within the
@@ -35,7 +37,7 @@ class PlexConfig(ConfigParser):
                 # Second: check the config file has attr
                 section, name = key.lower().split('.')
                 value = self.data.get(section, {}).get(name, default)
-            return cast(value) if cast else value
+            return utils.cast(cast, value) if cast else value
         except:  # noqa: E722
             return default
 
diff --git a/lib/plexapi/const.py b/lib/plexapi/const.py
index 86659c57..df86ff5d 100644
--- a/lib/plexapi/const.py
+++ b/lib/plexapi/const.py
@@ -3,7 +3,7 @@
 
 # Library version
 MAJOR_VERSION = 4
-MINOR_VERSION = 13
-PATCH_VERSION = 4
+MINOR_VERSION = 15
+PATCH_VERSION = 0
 __short_version__ = f"{MAJOR_VERSION}.{MINOR_VERSION}"
 __version__ = f"{__short_version__}.{PATCH_VERSION}"
diff --git a/lib/plexapi/library.py b/lib/plexapi/library.py
index ce2df733..cbca4246 100644
--- a/lib/plexapi/library.py
+++ b/lib/plexapi/library.py
@@ -1,13 +1,18 @@
 # -*- coding: utf-8 -*-
 import re
 from datetime import datetime
-from urllib.parse import quote_plus, urlencode
+from functools import cached_property
+from urllib.parse import parse_qs, quote_plus, urlencode, urlparse
 
-from plexapi import X_PLEX_CONTAINER_SIZE, log, media, utils
+from plexapi import log, media, utils
 from plexapi.base import OPERATORS, PlexObject
 from plexapi.exceptions import BadRequest, NotFound
+from plexapi.mixins import (
+    MovieEditMixins, ShowEditMixins, SeasonEditMixins, EpisodeEditMixins,
+    ArtistEditMixins, AlbumEditMixins, TrackEditMixins, PhotoalbumEditMixins, PhotoEditMixins
+)
 from plexapi.settings import Setting
-from plexapi.utils import cached_property, deprecated
+from plexapi.utils import deprecated
 
 
 class Library(PlexObject):
@@ -352,7 +357,7 @@ class Library(PlexObject):
             part += urlencode(kwargs)
         return self._server.query(part, method=self._server._session.post)
 
-    def history(self, maxresults=9999999, mindate=None):
+    def history(self, maxresults=None, mindate=None):
         """ Get Play History for all library Sections for the owner.
             Parameters:
                 maxresults (int): Only return the specified number of results (optional).
@@ -421,40 +426,6 @@ class LibrarySection(PlexObject):
         self._totalDuration = None
         self._totalStorage = None
 
-    def fetchItems(self, ekey, cls=None, container_start=None, container_size=None, **kwargs):
-        """ Load the specified key to find and build all items with the specified tag
-            and attrs. See :func:`~plexapi.base.PlexObject.fetchItem` for more details
-            on how this is used.
-
-            Parameters:
-                container_start (None, int): offset to get a subset of the data
-                container_size (None, int): How many items in data
-
-        """
-        url_kw = {}
-        if container_start is not None:
-            url_kw["X-Plex-Container-Start"] = container_start
-        if container_size is not None:
-            url_kw["X-Plex-Container-Size"] = container_size
-
-        if ekey is None:
-            raise BadRequest('ekey was not provided')
-        data = self._server.query(ekey, params=url_kw)
-
-        if '/all' in ekey:
-            # totalSize is only included in the xml response
-            # if container size is used.
-            total_size = data.attrib.get("totalSize") or data.attrib.get("size")
-            self._totalViewSize = utils.cast(int, total_size)
-
-        items = self.findItems(data, cls, ekey, **kwargs)
-
-        librarySectionID = utils.cast(int, data.attrib.get('librarySectionID'))
-        if librarySectionID:
-            for item in items:
-                item.librarySectionID = librarySectionID
-        return items
-
     @cached_property
     def totalSize(self):
         """ Returns the total number of items in the library for the default library type. """
@@ -474,6 +445,20 @@ class LibrarySection(PlexObject):
             self._getTotalDurationStorage()
         return self._totalStorage
 
+    def __getattribute__(self, attr):
+        # Intercept to call EditFieldMixin and EditTagMixin methods
+        # based on the item type being batch multi-edited
+        value = super().__getattribute__(attr)
+        if attr.startswith('_'): return value
+        if callable(value) and 'Mixin' in value.__qualname__:
+            if not isinstance(self._edits, dict):
+                raise AttributeError("Must enable batchMultiEdit() to use this method")
+            elif not hasattr(self._edits['items'][0], attr):
+                raise AttributeError(
+                    f"Batch multi-editing '{self._edits['items'][0].__class__.__name__}' object has no attribute '{attr}'"
+                )
+        return value
+
     def _getTotalDurationStorage(self):
         """ Queries the Plex server for the total library duration and storage and caches the values. """
         data = self._server.query('/media/providers?includeStorage=1')
@@ -565,8 +550,9 @@ class LibrarySection(PlexObject):
 
                 .. code-block:: python
 
-                LibrarySection.addLocations('/path/1')
-                LibrarySection.addLocations(['/path/1', 'path/2', '/path/3'])
+                    LibrarySection.addLocations('/path/1')
+                    LibrarySection.addLocations(['/path/1', 'path/2', '/path/3'])
+
         """
         locations = self.locations
         if isinstance(location, str):
@@ -587,8 +573,9 @@ class LibrarySection(PlexObject):
 
                 .. code-block:: python
 
-                LibrarySection.removeLocations('/path/1')
-                LibrarySection.removeLocations(['/path/1', 'path/2', '/path/3'])
+                    LibrarySection.removeLocations('/path/1')
+                    LibrarySection.removeLocations(['/path/1', 'path/2', '/path/3'])
+
         """
         locations = self.locations
         if isinstance(location, str):
@@ -602,19 +589,24 @@ class LibrarySection(PlexObject):
             raise BadRequest('You are unable to remove all locations from a library.')
         return self.edit(location=locations)
 
-    def get(self, title):
-        """ Returns the media item with the specified title.
+    def get(self, title, **kwargs):
+        """ Returns the media item with the specified title and kwargs.
 
             Parameters:
                 title (str): Title of the item to return.
+                kwargs (dict): Additional search parameters.
+                    See :func:`~plexapi.library.LibrarySection.search` for more info.
 
             Raises:
                 :exc:`~plexapi.exceptions.NotFound`: The title is not found in the library.
         """
         try:
-            return self.search(title)[0]
+            return self.search(title, limit=1, **kwargs)[0]
         except IndexError:
-            raise NotFound(f"Unable to find item '{title}'") from None
+            msg = f"Unable to find item with title '{title}'"
+            if kwargs:
+                msg += f" and kwargs {kwargs}"
+            raise NotFound(msg) from None
 
     def getGuid(self, guid):
         """ Returns the media item with the specified external Plex, IMDB, TMDB, or TVDB ID.
@@ -781,6 +773,11 @@ class LibrarySection(PlexObject):
         key = f'/library/sections/{self.key}/onDeck'
         return self.fetchItems(key)
 
+    def continueWatching(self):
+        """ Return a list of media items in the library's Continue Watching hub. """
+        key = f'/hubs/sections/{self.key}/continueWatching/items'
+        return self.fetchItems(key)
+
     def recentlyAdded(self, maxresults=50, libtype=None):
         """ Returns a list of media items recently added from this library section.
 
@@ -1261,7 +1258,7 @@ class LibrarySection(PlexObject):
         return self._server.search(query, mediatype, limit, sectionId=self.key)
 
     def search(self, title=None, sort=None, maxresults=None, libtype=None,
-               container_start=0, container_size=X_PLEX_CONTAINER_SIZE, limit=None, filters=None, **kwargs):
+               container_start=None, container_size=None, limit=None, filters=None, **kwargs):
         """ Search the library. The http requests will be batched in container_size. If you are only looking for the
             first <num> results, it would be wise to set the maxresults option to that amount so the search doesn't iterate
             over all results on the server.
@@ -1517,43 +1514,8 @@ class LibrarySection(PlexObject):
         """
         key, kwargs = self._buildSearchKey(
             title=title, sort=sort, libtype=libtype, limit=limit, filters=filters, returnKwargs=True, **kwargs)
-        return self._search(key, maxresults, container_start, container_size, **kwargs)
-
-    def _search(self, key, maxresults, container_start, container_size, **kwargs):
-        """ Perform the actual library search and return the results. """
-        results = []
-        subresults = []
-        offset = container_start
-
-        if maxresults is not None:
-            container_size = min(container_size, maxresults)
-
-        while True:
-            subresults = self.fetchItems(key, container_start=container_start,
-                                         container_size=container_size, **kwargs)
-            if not len(subresults):
-                if offset > self._totalViewSize:
-                    log.info("container_start is higher than the number of items in the library")
-
-            results.extend(subresults)
-
-            # self._totalViewSize is not used as a condition in the while loop as
-            # this require a additional http request.
-            # self._totalViewSize is updated from self.fetchItems
-            wanted_number_of_items = self._totalViewSize - offset
-            if maxresults is not None:
-                wanted_number_of_items = min(maxresults, wanted_number_of_items)
-                container_size = min(container_size, maxresults - len(results))
-
-            if wanted_number_of_items <= len(results):
-                break
-
-            container_start += container_size
-
-            if container_start > self._totalViewSize:
-                break
-
-        return results
+        return self.fetchItems(
+            key, container_start=container_start, container_size=container_size, maxresults=maxresults, **kwargs)
 
     def _locations(self):
         """ Returns a list of :class:`~plexapi.library.Location` objects
@@ -1630,7 +1592,7 @@ class LibrarySection(PlexObject):
 
         return myplex.sync(client=client, clientId=clientId, sync_item=sync_item)
 
-    def history(self, maxresults=9999999, mindate=None):
+    def history(self, maxresults=None, mindate=None):
         """ Get Play History for this library Section for the owner.
             Parameters:
                 maxresults (int): Only return the specified number of results (optional).
@@ -1720,8 +1682,101 @@ class LibrarySection(PlexObject):
             params['pageType'] = 'list'
         return self._server._buildWebURL(base=base, **params)
 
+    def _validateItems(self, items):
+        """ Validates the specified items are from this library and of the same type. """
+        if not items:
+            raise BadRequest('No items specified.')
+        
+        if not isinstance(items, list):
+            items = [items]
+        
+        itemType = items[0].type
+        for item in items:
+            if item.librarySectionID != self.key:
+                raise BadRequest(f'{item.title} is not from this library.')
+            elif item.type != itemType:
+                raise BadRequest(f'Cannot mix items of different type: {itemType} and {item.type}')
 
-class MovieSection(LibrarySection):
+        return items
+
+    def common(self, items):
+        """ Returns a :class:`~plexapi.library.Common` object for the specified items. """
+        params = {
+            'id': ','.join(str(item.ratingKey) for item in self._validateItems(items)),
+            'type': utils.searchType(items[0].type)
+        }
+        part = f'/library/sections/{self.key}/common{utils.joinArgs(params)}'
+        return self.fetchItem(part, cls=Common)
+
+    def _edit(self, items=None, **kwargs):
+        """ Actually edit multiple objects. """
+        if isinstance(self._edits, dict):
+            self._edits.update(kwargs)
+            return self
+
+        kwargs['id'] = ','.join(str(item.ratingKey) for item in self._validateItems(items))
+        if 'type' not in kwargs:
+            kwargs['type'] = utils.searchType(items[0].type)
+
+        part = f'/library/sections/{self.key}/all{utils.joinArgs(kwargs)}'
+        self._server.query(part, method=self._server._session.put)
+        return self
+
+    def multiEdit(self, items, **kwargs):
+        """ Edit multiple objects at once.
+            Note: This is a low level method and you need to know all the field/tag keys.
+            See :class:`~plexapi.LibrarySection.batchMultiEdits` instead.
+
+            Parameters:
+                items (List): List of :class:`~plexapi.audio.Audio`, :class:`~plexapi.video.Video`,
+                    :class:`~plexapi.photo.Photo`, or :class:`~plexapi.collection.Collection`
+                    objects to be edited.
+                kwargs (dict): Dict of settings to edit.
+        """
+        return self._edit(items, **kwargs)
+
+    def batchMultiEdits(self, items):
+        """ Enable batch multi-editing mode to save API calls.
+            Must call :func:`~plexapi.library.LibrarySection.saveMultiEdits` at the end to save all the edits.
+            See :class:`~plexapi.mixins.EditFieldMixin` and :class:`~plexapi.mixins.EditTagsMixin`
+            for individual field and tag editing methods.
+
+            Parameters:
+                items (List): List of :class:`~plexapi.audio.Audio`, :class:`~plexapi.video.Video`,
+                    :class:`~plexapi.photo.Photo`, or :class:`~plexapi.collection.Collection`
+                    objects to be edited.
+
+            Example:
+
+                .. code-block:: python
+
+                    movies = MovieSection.all()
+                    items = [movies[0], movies[3], movies[5]]
+
+                    # Batch multi-editing multiple fields and tags in a single API call
+                    MovieSection.batchMultiEdits(items)
+                    MovieSection.editTitle('A New Title').editSummary('A new summary').editTagline('A new tagline') \\
+                        .addCollection('New Collection').removeGenre('Action').addLabel('Favorite')
+                    MovieSection.saveMultiEdits()
+
+        """
+        self._edits = {'items': self._validateItems(items)}
+        return self
+
+    def saveMultiEdits(self):
+        """ Save all the batch multi-edits.
+            See :func:`~plexapi.library.LibrarySection.batchMultiEdits` for details.
+        """
+        if not isinstance(self._edits, dict):
+            raise BadRequest('Batch multi-editing mode not enabled. Must call `batchMultiEdits()` first.')
+
+        edits = self._edits
+        self._edits = None
+        self._edit(items=edits.pop('items'), **edits)
+        return self
+
+
+class MovieSection(LibrarySection, MovieEditMixins):
     """ Represents a :class:`~plexapi.library.LibrarySection` section containing movies.
 
         Attributes:
@@ -1781,7 +1836,7 @@ class MovieSection(LibrarySection):
         return super(MovieSection, self).sync(**kwargs)
 
 
-class ShowSection(LibrarySection):
+class ShowSection(LibrarySection, ShowEditMixins, SeasonEditMixins, EpisodeEditMixins):
     """ Represents a :class:`~plexapi.library.LibrarySection` section containing tv shows.
 
         Attributes:
@@ -1865,7 +1920,7 @@ class ShowSection(LibrarySection):
         return super(ShowSection, self).sync(**kwargs)
 
 
-class MusicSection(LibrarySection):
+class MusicSection(LibrarySection, ArtistEditMixins, AlbumEditMixins, TrackEditMixins):
     """ Represents a :class:`~plexapi.library.LibrarySection` section containing music artists.
 
         Attributes:
@@ -1957,7 +2012,7 @@ class MusicSection(LibrarySection):
         return super(MusicSection, self).sync(**kwargs)
 
 
-class PhotoSection(LibrarySection):
+class PhotoSection(LibrarySection, PhotoalbumEditMixins, PhotoEditMixins):
     """ Represents a :class:`~plexapi.library.LibrarySection` section containing photos.
 
         Attributes:
@@ -1979,13 +2034,13 @@ class PhotoSection(LibrarySection):
     def collections(self, **kwargs):
         raise NotImplementedError('Collections are not available for a Photo library.')
 
-    def searchAlbums(self, title, **kwargs):
+    def searchAlbums(self, **kwargs):
         """ Search for a photo album. See :func:`~plexapi.library.LibrarySection.search` for usage. """
-        return self.search(libtype='photoalbum', title=title, **kwargs)
+        return self.search(libtype='photoalbum', **kwargs)
 
-    def searchPhotos(self, title, **kwargs):
+    def searchPhotos(self, **kwargs):
         """ Search for a photo. See :func:`~plexapi.library.LibrarySection.search` for usage. """
-        return self.search(libtype='photo', title=title, **kwargs)
+        return self.search(libtype='photo', **kwargs)
 
     def recentlyAddedAlbums(self, maxresults=50):
         """ Returns a list of recently added photo albums from this library section.
@@ -2157,8 +2212,10 @@ class LibraryMediaTag(PlexObject):
             reason (str): The reason for the search result.
             reasonID (int): The reason ID for the search result.
             reasonTitle (str): The reason title for the search result.
+            score (float): The score for the search result.
             type (str): The type of search result (tag).
             tag (str): The title of the tag.
+            tagKey (str): The Plex Discover ratingKey (guid) for people.
             tagType (int): The type ID of the tag.
             tagValue (int): The value of the tag.
             thumb (str): The URL for the thumbnail of the tag (if available).
@@ -2179,8 +2236,10 @@ class LibraryMediaTag(PlexObject):
         self.reason = data.attrib.get('reason')
         self.reasonID = utils.cast(int, data.attrib.get('reasonID'))
         self.reasonTitle = data.attrib.get('reasonTitle')
+        self.score = utils.cast(float, data.attrib.get('score'))
         self.type = data.attrib.get('type')
         self.tag = data.attrib.get('tag')
+        self.tagKey = data.attrib.get('tagKey')
         self.tagType = utils.cast(int, data.attrib.get('tagType'))
         self.tagValue = utils.cast(int, data.attrib.get('tagValue'))
         self.thumb = data.attrib.get('thumb')
@@ -2222,16 +2281,6 @@ class Autotag(LibraryMediaTag):
     TAGTYPE = 207
 
 
-@utils.registerPlexObject
-class Banner(LibraryMediaTag):
-    """ Represents a single Banner library media tag.
-
-        Attributes:
-            TAGTYPE (int): 311
-    """
-    TAGTYPE = 311
-
-
 @utils.registerPlexObject
 class Chapter(LibraryMediaTag):
     """ Represents a single Chapter library media tag.
@@ -2958,6 +3007,7 @@ class ManagedHub(PlexObject):
                     managedHub.updateVisibility(recommended=True, home=True, shared=False).reload()
                     # or using chained methods
                     managedHub.promoteRecommended().promoteHome().demoteShared().reload()
+
         """
         params = {
             'promotedToRecommended': int(self.promotedToRecommended),
@@ -3066,7 +3116,6 @@ class Path(PlexObject):
 
         Attributes:
             TAG (str): 'Path'
-
             home (bool): True if the path is the home directory
             key (str): API URL (/services/browse/<base64path>)
             network (bool): True if path is a network location
@@ -3098,7 +3147,6 @@ class File(PlexObject):
 
         Attributes:
             TAG (str): 'File'
-
             key (str): API URL (/services/browse/<base64path>)
             path (str): Full path to file
             title (str): File name
@@ -3109,3 +3157,105 @@ class File(PlexObject):
         self.key = data.attrib.get('key')
         self.path = data.attrib.get('path')
         self.title = data.attrib.get('title')
+
+
+@utils.registerPlexObject
+class Common(PlexObject):
+    """ Represents a Common element from a library. This object lists common fields between multiple objects.
+
+        Attributes:
+            TAG (str): 'Common'
+            collections (List<:class:`~plexapi.media.Collection`>): List of collection objects.
+            contentRating (str): Content rating of the items.
+            countries (List<:class:`~plexapi.media.Country`>): List of countries objects.
+            directors (List<:class:`~plexapi.media.Director`>): List of director objects.
+            editionTitle (str): Edition title of the items.
+            fields (List<:class:`~plexapi.media.Field`>): List of field objects.
+            genres (List<:class:`~plexapi.media.Genre`>): List of genre objects.
+            grandparentRatingKey (int): Grandparent rating key of the items.
+            grandparentTitle (str): Grandparent title of the items.
+            guid (str): Plex GUID of the items.
+            guids (List<:class:`~plexapi.media.Guid`>): List of guid objects.
+            index (int): Index of the items.
+            key (str): API URL (/library/metadata/<ratingkey>).
+            labels (List<:class:`~plexapi.media.Label`>): List of label objects.
+            mixedFields (List<str>): List of mixed fields.
+            moods (List<:class:`~plexapi.media.Mood`>): List of mood objects.
+            originallyAvailableAt (datetime): Datetime of the release date of the items.
+            parentRatingKey (int): Parent rating key of the items.
+            parentTitle (str): Parent title of the items.
+            producers (List<:class:`~plexapi.media.Producer`>): List of producer objects.
+            ratingKey (int): Rating key of the items.
+            ratings (List<:class:`~plexapi.media.Rating`>): List of rating objects.
+            roles (List<:class:`~plexapi.media.Role`>): List of role objects.
+            studio (str): Studio name of the items.
+            styles (List<:class:`~plexapi.media.Style`>): List of style objects.
+            summary (str): Summary of the items.
+            tagline (str): Tagline of the items.
+            tags (List<:class:`~plexapi.media.Tag`>): List of tag objects.
+            title (str): Title of the items.
+            titleSort (str): Title to use when sorting of the items.
+            type (str): Type of the media (common).
+            writers (List<:class:`~plexapi.media.Writer`>): List of writer objects.
+            year (int): Year of the items.
+    """
+    TAG = 'Common'
+
+    def _loadData(self, data):
+        self._data = data
+        self.collections = self.findItems(data, media.Collection)
+        self.contentRating = data.attrib.get('contentRating')
+        self.countries = self.findItems(data, media.Country)
+        self.directors = self.findItems(data, media.Director)
+        self.editionTitle = data.attrib.get('editionTitle')
+        self.fields = self.findItems(data, media.Field)
+        self.genres = self.findItems(data, media.Genre)
+        self.grandparentRatingKey = utils.cast(int, data.attrib.get('grandparentRatingKey'))
+        self.grandparentTitle = data.attrib.get('grandparentTitle')
+        self.guid = data.attrib.get('guid')
+        self.guids = self.findItems(data, media.Guid)
+        self.index = utils.cast(int, data.attrib.get('index'))
+        self.key = data.attrib.get('key')
+        self.labels = self.findItems(data, media.Label)
+        self.mixedFields = data.attrib.get('mixedFields').split(',')
+        self.moods = self.findItems(data, media.Mood)
+        self.originallyAvailableAt = utils.toDatetime(data.attrib.get('originallyAvailableAt'))
+        self.parentRatingKey = utils.cast(int, data.attrib.get('parentRatingKey'))
+        self.parentTitle = data.attrib.get('parentTitle')
+        self.producers = self.findItems(data, media.Producer)
+        self.ratingKey = utils.cast(int, data.attrib.get('ratingKey'))
+        self.ratings = self.findItems(data, media.Rating)
+        self.roles = self.findItems(data, media.Role)
+        self.studio = data.attrib.get('studio')
+        self.styles = self.findItems(data, media.Style)
+        self.summary = data.attrib.get('summary')
+        self.tagline = data.attrib.get('tagline')
+        self.tags = self.findItems(data, media.Tag)
+        self.title = data.attrib.get('title')
+        self.titleSort = data.attrib.get('titleSort')
+        self.type = data.attrib.get('type')
+        self.writers = self.findItems(data, media.Writer)
+        self.year = utils.cast(int, data.attrib.get('year'))
+
+    def __repr__(self):
+        return '<%s:%s:%s>' % (
+            self.__class__.__name__,
+            self.commonType,
+            ','.join(str(key) for key in self.ratingKeys)
+        )
+
+    @property
+    def commonType(self):
+        """ Returns the media type of the common items. """
+        parsed_query = parse_qs(urlparse(self._initpath).query)
+        return utils.reverseSearchType(parsed_query['type'][0])
+
+    @property
+    def ratingKeys(self):
+        """ Returns a list of rating keys for the common items. """
+        parsed_query = parse_qs(urlparse(self._initpath).query)
+        return [int(value.strip()) for value in parsed_query['id'][0].split(',')]
+
+    def items(self):
+        """ Returns a list of the common items. """
+        return self._server.fetchItems(self.ratingKeys)
diff --git a/lib/plexapi/media.py b/lib/plexapi/media.py
index bf401ee0..8793463f 100644
--- a/lib/plexapi/media.py
+++ b/lib/plexapi/media.py
@@ -415,7 +415,11 @@ class SubtitleStream(MediaPartStream):
             forced (bool): True if this is a forced subtitle.
             format (str): The format of the subtitle stream (ex: srt).
             headerCompression (str): The header compression of the subtitle stream.
+            providerTitle (str): The provider title where the on-demand subtitle is downloaded from.
+            score (int): The match score of the on-demand subtitle.
+            sourceKey (str): The source key of the on-demand subtitle.
             transient (str): Unknown.
+            userID (int): The user id of the user that downloaded the on-demand subtitle.
     """
     TAG = 'Stream'
     STREAMTYPE = 3
@@ -427,7 +431,11 @@ class SubtitleStream(MediaPartStream):
         self.forced = utils.cast(bool, data.attrib.get('forced', '0'))
         self.format = data.attrib.get('format')
         self.headerCompression = data.attrib.get('headerCompression')
+        self.providerTitle = data.attrib.get('providerTitle')
+        self.score = utils.cast(int, data.attrib.get('score'))
+        self.sourceKey = data.attrib.get('sourceKey')
         self.transient = data.attrib.get('transient')
+        self.userID = utils.cast(int, data.attrib.get('userID'))
 
     def setDefault(self):
         """ Sets this subtitle stream as the default subtitle stream. """
@@ -955,7 +963,7 @@ class Review(PlexObject):
 
 
 class BaseResource(PlexObject):
-    """ Base class for all Art, Banner, Poster, and Theme objects.
+    """ Base class for all Art, Poster, and Theme objects.
 
         Attributes:
             TAG (str): 'Photo' or 'Track'
@@ -987,11 +995,6 @@ class Art(BaseResource):
     TAG = 'Photo'
 
 
-class Banner(BaseResource):
-    """ Represents a single Banner object. """
-    TAG = 'Photo'
-
-
 class Poster(BaseResource):
     """ Represents a single Poster object. """
     TAG = 'Photo'
diff --git a/lib/plexapi/mixins.py b/lib/plexapi/mixins.py
index b004ad74..f0c21cfe 100644
--- a/lib/plexapi/mixins.py
+++ b/lib/plexapi/mixins.py
@@ -1,6 +1,5 @@
 # -*- coding: utf-8 -*-
 from datetime import datetime
-
 from urllib.parse import parse_qsl, quote, quote_plus, unquote, urlencode, urlsplit
 
 from plexapi import media, settings, utils
@@ -139,7 +138,7 @@ class SplitMergeMixin:
         if not isinstance(ratingKeys, list):
             ratingKeys = str(ratingKeys).split(',')
 
-        key = f"{self.key}/merge?ids={','.join([str(r) for r in ratingKeys])}"
+        key = f"{self.key}/merge?ids={','.join(str(r) for r in ratingKeys)}"
         self._server.query(key, method=self._server._session.put)
         return self
 
@@ -329,7 +328,19 @@ class ArtUrlMixin:
         return self._server.url(art, includeToken=True) if art else None
 
 
-class ArtMixin(ArtUrlMixin):
+class ArtLockMixin:
+    """ Mixin for Plex objects that can have a locked background artwork. """
+
+    def lockArt(self):
+        """ Lock the background artwork for a Plex object. """
+        return self._edit(**{'art.locked': 1})
+
+    def unlockArt(self):
+        """ Unlock the background artwork for a Plex object. """
+        return self._edit(**{'art.locked': 0})
+
+
+class ArtMixin(ArtUrlMixin, ArtLockMixin):
     """ Mixin for Plex objects that can have background artwork. """
 
     def arts(self):
@@ -361,65 +372,6 @@ class ArtMixin(ArtUrlMixin):
         art.select()
         return self
 
-    def lockArt(self):
-        """ Lock the background artwork for a Plex object. """
-        return self._edit(**{'art.locked': 1})
-
-    def unlockArt(self):
-        """ Unlock the background artwork for a Plex object. """
-        return self._edit(**{'art.locked': 0})
-
-
-class BannerUrlMixin:
-    """ Mixin for Plex objects that can have a banner url. """
-
-    @property
-    def bannerUrl(self):
-        """ Return the banner url for the Plex object. """
-        banner = self.firstAttr('banner')
-        return self._server.url(banner, includeToken=True) if banner else None
-
-
-class BannerMixin(BannerUrlMixin):
-    """ Mixin for Plex objects that can have banners. """
-
-    def banners(self):
-        """ Returns list of available :class:`~plexapi.media.Banner` objects. """
-        return self.fetchItems(f'/library/metadata/{self.ratingKey}/banners', cls=media.Banner)
-
-    def uploadBanner(self, url=None, filepath=None):
-        """ Upload a banner from a url or filepath.
-        
-            Parameters:
-                url (str): The full URL to the image to upload.
-                filepath (str): The full file path the the image to upload or file-like object.
-        """
-        if url:
-            key = f'/library/metadata/{self.ratingKey}/banners?url={quote_plus(url)}'
-            self._server.query(key, method=self._server._session.post)
-        elif filepath:
-            key = f'/library/metadata/{self.ratingKey}/banners'
-            data = openOrRead(filepath)
-            self._server.query(key, method=self._server._session.post, data=data)
-        return self
-
-    def setBanner(self, banner):
-        """ Set the banner for a Plex object.
-        
-            Parameters:
-                banner (:class:`~plexapi.media.Banner`): The banner object to select.
-        """
-        banner.select()
-        return self
-
-    def lockBanner(self):
-        """ Lock the banner for a Plex object. """
-        return self._edit(**{'banner.locked': 1})
-
-    def unlockBanner(self):
-        """ Unlock the banner for a Plex object. """
-        return self._edit(**{'banner.locked': 0})
-
 
 class PosterUrlMixin:
     """ Mixin for Plex objects that can have a poster url. """
@@ -436,7 +388,19 @@ class PosterUrlMixin:
         return self.thumbUrl
 
 
-class PosterMixin(PosterUrlMixin):
+class PosterLockMixin:
+    """ Mixin for Plex objects that can have a locked poster. """
+
+    def lockPoster(self):
+        """ Lock the poster for a Plex object. """
+        return self._edit(**{'thumb.locked': 1})
+
+    def unlockPoster(self):
+        """ Unlock the poster for a Plex object. """
+        return self._edit(**{'thumb.locked': 0})
+
+
+class PosterMixin(PosterUrlMixin, PosterLockMixin):
     """ Mixin for Plex objects that can have posters. """
 
     def posters(self):
@@ -468,14 +432,6 @@ class PosterMixin(PosterUrlMixin):
         poster.select()
         return self
 
-    def lockPoster(self):
-        """ Lock the poster for a Plex object. """
-        return self._edit(**{'thumb.locked': 1})
-
-    def unlockPoster(self):
-        """ Unlock the poster for a Plex object. """
-        return self._edit(**{'thumb.locked': 0})
-
 
 class ThemeUrlMixin:
     """ Mixin for Plex objects that can have a theme url. """
@@ -487,7 +443,19 @@ class ThemeUrlMixin:
         return self._server.url(theme, includeToken=True) if theme else None
 
 
-class ThemeMixin(ThemeUrlMixin):
+class ThemeLockMixin:
+    """ Mixin for Plex objects that can have a locked theme. """
+
+    def lockTheme(self):
+        """ Lock the theme for a Plex object. """
+        return self._edit(**{'theme.locked': 1})
+
+    def unlockTheme(self):
+        """ Unlock the theme for a Plex object. """
+        return self._edit(**{'theme.locked': 0})
+
+
+class ThemeMixin(ThemeUrlMixin, ThemeLockMixin):
     """ Mixin for Plex objects that can have themes. """
 
     def themes(self):
@@ -520,14 +488,6 @@ class ThemeMixin(ThemeUrlMixin):
             'Re-upload the theme using "uploadTheme" to set it.'
         )
 
-    def lockTheme(self):
-        """ Lock the theme for a Plex object. """
-        return self._edit(**{'theme.locked': 1})
-
-    def unlockTheme(self):
-        """ Unlock the theme for a Plex object. """
-        return self._edit(**{'theme.locked': 0})
-
 
 class EditFieldMixin:
     """ Mixin for editing Plex object fields. """
@@ -752,6 +712,19 @@ class PhotoCapturedTimeMixin(EditFieldMixin):
         return self.editField('originallyAvailableAt', capturedTime, locked=locked)
 
 
+class UserRatingMixin(EditFieldMixin):
+    """ Mixin for Plex objects that can have a user rating. """
+
+    def editUserRating(self, userRating, locked=True):
+        """ Edit the user rating.
+
+            Parameters:
+                userRating (int): The new value.
+                locked (bool): True (default) to lock the field, False to unlock the field.
+        """
+        return self.editField('userRating', userRating, locked=locked)
+
+
 class EditTagsMixin:
     """ Mixin for editing Plex object tags. """
 
@@ -781,7 +754,7 @@ class EditTagsMixin:
             items = [items]
 
         if not remove:
-            tags = getattr(self, self._tagPlural(tag))
+            tags = getattr(self, self._tagPlural(tag), [])
             items = tags + items
 
         edits = self._tagHelper(self._tagSingular(tag), items, locked, remove)
@@ -822,7 +795,7 @@ class EditTagsMixin:
 
         if remove:
             tagname = f'{tag}[].tag.tag-'
-            data[tagname] = ','.join([quote(str(t)) for t in items])
+            data[tagname] = ','.join(quote(str(t)) for t in items)
         else:
             for i, item in enumerate(items):
                 tagname = f'{str(tag)}[{i}].tag.tag'
@@ -1135,3 +1108,84 @@ class WatchlistMixin:
         ratingKey = self.guid.rsplit('/', 1)[-1]
         data = account.query(f"{account.METADATA}/library/metadata/{ratingKey}/availabilities")
         return self.findItems(data)
+
+
+class MovieEditMixins(
+    ArtLockMixin, PosterLockMixin, ThemeLockMixin,
+    AddedAtMixin, ContentRatingMixin, EditionTitleMixin, OriginallyAvailableMixin, OriginalTitleMixin, SortTitleMixin,
+    StudioMixin, SummaryMixin, TaglineMixin, TitleMixin, UserRatingMixin,
+    CollectionMixin, CountryMixin, DirectorMixin, GenreMixin, LabelMixin, ProducerMixin, WriterMixin
+):
+    pass
+
+
+class ShowEditMixins(
+    ArtLockMixin, PosterLockMixin, ThemeLockMixin,
+    AddedAtMixin, ContentRatingMixin, OriginallyAvailableMixin, OriginalTitleMixin, SortTitleMixin, StudioMixin,
+    SummaryMixin, TaglineMixin, TitleMixin, UserRatingMixin,
+    CollectionMixin, GenreMixin, LabelMixin,
+):
+    pass
+
+
+class SeasonEditMixins(
+    ArtLockMixin, PosterLockMixin, ThemeLockMixin,
+    AddedAtMixin, SummaryMixin, TitleMixin, UserRatingMixin,
+    CollectionMixin, LabelMixin
+):
+    pass
+
+
+class EpisodeEditMixins(
+    ArtLockMixin, PosterLockMixin, ThemeLockMixin,
+    AddedAtMixin, ContentRatingMixin, OriginallyAvailableMixin, SortTitleMixin, SummaryMixin, TitleMixin, UserRatingMixin,
+    CollectionMixin, DirectorMixin, LabelMixin, WriterMixin
+):
+    pass
+
+
+class ArtistEditMixins(
+    ArtLockMixin, PosterLockMixin, ThemeLockMixin,
+    AddedAtMixin, SortTitleMixin, SummaryMixin, TitleMixin, UserRatingMixin,
+    CollectionMixin, CountryMixin, GenreMixin, LabelMixin, MoodMixin, SimilarArtistMixin, StyleMixin
+):
+    pass
+
+
+class AlbumEditMixins(
+    ArtLockMixin, PosterLockMixin, ThemeLockMixin,
+    AddedAtMixin, OriginallyAvailableMixin, SortTitleMixin, StudioMixin, SummaryMixin, TitleMixin, UserRatingMixin,
+    CollectionMixin, GenreMixin, LabelMixin, MoodMixin, StyleMixin
+):
+    pass
+
+
+class TrackEditMixins(
+    ArtLockMixin, PosterLockMixin, ThemeLockMixin,
+    AddedAtMixin, TitleMixin, TrackArtistMixin, TrackNumberMixin, TrackDiscNumberMixin, UserRatingMixin,
+    CollectionMixin, LabelMixin, MoodMixin
+):
+    pass
+
+
+class PhotoalbumEditMixins(
+    ArtLockMixin, PosterLockMixin,
+    AddedAtMixin, SortTitleMixin, SummaryMixin, TitleMixin, UserRatingMixin
+):
+    pass
+
+
+class PhotoEditMixins(
+    ArtLockMixin, PosterLockMixin,
+    AddedAtMixin, PhotoCapturedTimeMixin, SortTitleMixin, SummaryMixin, TitleMixin, UserRatingMixin,
+    TagMixin
+):
+    pass
+
+
+class CollectionEditMixins(
+    ArtLockMixin, PosterLockMixin, ThemeLockMixin,
+    AddedAtMixin, ContentRatingMixin, SortTitleMixin, SummaryMixin, TitleMixin, UserRatingMixin,
+    LabelMixin
+):
+    pass
diff --git a/lib/plexapi/myplex.py b/lib/plexapi/myplex.py
index ca3f026a..c90b5d33 100644
--- a/lib/plexapi/myplex.py
+++ b/lib/plexapi/myplex.py
@@ -7,8 +7,9 @@ from urllib.parse import parse_qsl, urlencode, urlsplit, urlunsplit
 from xml.etree import ElementTree
 
 import requests
-from plexapi import (BASE_HEADERS, CONFIG, TIMEOUT, X_PLEX_CONTAINER_SIZE,
-                     X_PLEX_ENABLE_FAST_CONNECT, X_PLEX_IDENTIFIER, log, logfilter, utils)
+
+from plexapi import (BASE_HEADERS, CONFIG, TIMEOUT, X_PLEX_ENABLE_FAST_CONNECT, X_PLEX_IDENTIFIER,
+                     log, logfilter, utils)
 from plexapi.base import PlexObject
 from plexapi.client import PlexClient
 from plexapi.exceptions import BadRequest, NotFound, Unauthorized
@@ -21,51 +22,76 @@ from requests.status_codes import _codes as codes
 
 class MyPlexAccount(PlexObject):
     """ MyPlex account and profile information. This object represents the data found Account on
-        the myplex.tv servers at the url https://plex.tv/users/account. You may create this object
+        the myplex.tv servers at the url https://plex.tv/api/v2/user. You may create this object
         directly by passing in your username & password (or token). There is also a convenience
         method provided at :class:`~plexapi.server.PlexServer.myPlexAccount()` which will create
         and return this object.
 
         Parameters:
-            username (str): Your MyPlex username.
-            password (str): Your MyPlex password.
+            username (str): Plex login username if not using a token.
+            password (str): Plex login password if not using a token.
+            token (str): Plex authentication token instead of username and password.
             session (requests.Session, optional): Use your own session object if you want to
-                cache the http responses from PMS
+                cache the http responses from PMS.
             timeout (int): timeout in seconds on initial connect to myplex (default config.TIMEOUT).
-            code (str): Two-factor authentication code to use when logging in.
+            code (str): Two-factor authentication code to use when logging in with username and password.
+            remember (bool): Remember the account token for 14 days (Default True).
 
         Attributes:
-            SIGNIN (str): 'https://plex.tv/users/sign_in.xml'
-            key (str): 'https://plex.tv/users/account'
-            authenticationToken (str): Unknown.
-            certificateVersion (str): Unknown.
-            cloudSyncDevice (str): Unknown.
-            email (str): Your current Plex email address.
+            key (str): 'https://plex.tv/api/v2/user'
+            adsConsent (str): Unknown.
+            adsConsentReminderAt (str): Unknown.
+            adsConsentSetAt (str): Unknown.
+            anonymous (str): Unknown.
+            authToken (str): The account token.
+            backupCodesCreated (bool): If the two-factor authentication backup codes have been created.
+            confirmed (bool): If the account has been confirmed.
+            country (str): The account country.
+            email (str): The account email address.
+            emailOnlyAuth (bool): If login with email only is enabled.
+            experimentalFeatures (bool): If experimental features are enabled.
+            friendlyName (str): Your account full name.
             entitlements (List<str>): List of devices your allowed to use with this account.
-            guest (bool): Unknown.
-            home (bool): Unknown.
-            homeSize (int): Unknown.
-            id (int): Your Plex account ID.
-            locale (str): Your Plex locale
-            mailing_list_status (str): Your current mailing list status.
-            maxHomeSize (int): Unknown.
+            guest (bool): If the account is a Plex Home guest user.
+            hasPassword (bool): If the account has a password.
+            home (bool): If the account is a Plex Home user.
+            homeAdmin (bool): If the account is the Plex Home admin.
+            homeSize (int): The number of accounts in the Plex Home.
+            id (int): The Plex account ID.
+            joinedAt (datetime): Date the account joined Plex.
+            locale (str): the account locale
+            mailingListActive (bool): If you are subscribed to the Plex newsletter.
+            mailingListStatus (str): Your current mailing list status.
+            maxHomeSize (int): The maximum number of accounts allowed in the Plex Home.
             pin (str): The hashed Plex Home PIN.
-            queueEmail (str): Email address to add items to your `Watch Later` queue.
-            queueUid (str): Unknown.
-            restricted (bool): Unknown.
+            profileAutoSelectAudio (bool): If the account has automatically select audio and subtitle tracks enabled.
+            profileDefaultAudioLanguage (str): The preferred audio language for the account.
+            profileDefaultSubtitleLanguage (str): The preferred subtitle language for the account.
+            profileAutoSelectSubtitle (int): The auto-select subtitle mode
+                (0 = Manually selected, 1 = Shown with foreign audio, 2 = Always enabled).
+            profileDefaultSubtitleAccessibility (int): The subtitles for the deaf or hard-of-hearing (SDH) searches mode
+                (0 = Prefer non-SDH subtitles, 1 = Prefer SDH subtitles, 2 = Only show SDH subtitles,
+                3 = Only shown non-SDH subtitles).
+            profileDefaultSubtitleForced (int): The forced subtitles searches mode
+                (0 = Prefer non-forced subtitles, 1 = Prefer forced subtitles, 2 = Only show forced subtitles,
+                3 = Only show non-forced subtitles).
+            protected (bool): If the account has a Plex Home PIN enabled.
+            rememberExpiresAt (datetime): Date the token expires.
+            restricted (bool): If the account is a Plex Home managed user.
             roles: (List<str>) Lit of account roles. Plexpass membership listed here.
-            scrobbleTypes (str): Description
-            secure (bool): Description
-            subscriptionActive (bool): True if your subscription is active.
-            subscriptionFeatures: (List<str>) List of features allowed on your subscription.
-            subscriptionPlan (str): Name of subscription plan.
-            subscriptionStatus (str): String representation of `subscriptionActive`.
-            thumb (str): URL of your account thumbnail.
-            title (str): Unknown. - Looks like an alias for `username`.
-            username (str): Your account username.
-            uuid (str): Unknown.
-            _token (str): Token used to access this client.
-            _session (obj): Requests session object used to access this client.
+            scrobbleTypes (List<int>): Unknown.
+            subscriptionActive (bool): If the account's Plex Pass subscription is active.
+            subscriptionDescription (str): Description of the Plex Pass subscription.
+            subscriptionFeatures: (List<str>) List of features allowed on your Plex Pass subscription.
+            subscriptionPaymentService (str): Payment service used for your Plex Pass subscription.
+            subscriptionPlan (str): Name of Plex Pass subscription plan.
+            subscriptionStatus (str): String representation of ``subscriptionActive``.
+            subscriptionSubscribedAt (datetime): Date the account subscribed to Plex Pass.
+            thumb (str): URL of the account thumbnail.
+            title (str): The title of the account (username or friendly name).
+            twoFactorEnabled (bool): If two-factor authentication is enabled.
+            username (str): The account username.
+            uuid (str): The account UUID.
     """
     FRIENDINVITE = 'https://plex.tv/api/servers/{machineId}/shared_servers'                     # post with data
     HOMEUSERS = 'https://plex.tv/api/home/users'
@@ -76,7 +102,8 @@ class MyPlexAccount(PlexObject):
     FRIENDUPDATE = 'https://plex.tv/api/friends/{userId}'                                       # put with args, delete
     HOMEUSER = 'https://plex.tv/api/home/users/{userId}'                                        # delete, put
     MANAGEDHOMEUSER = 'https://plex.tv/api/v2/home/users/restricted/{userId}'                   # put
-    SIGNIN = 'https://plex.tv/users/sign_in.xml'                                                # get with auth
+    SIGNIN = 'https://plex.tv/api/v2/users/signin'                                              # post with auth
+    SIGNOUT = 'https://plex.tv/api/v2/users/signout'                                            # delete
     WEBHOOKS = 'https://plex.tv/api/v2/user/webhooks'                                           # get, post with data
     OPTOUTS = 'https://plex.tv/api/v2/user/{userUUID}/settings/opt_outs'                        # get
     LINK = 'https://plex.tv/api/v2/pins/link'                                                   # put
@@ -85,86 +112,106 @@ class MyPlexAccount(PlexObject):
     VOD = 'https://vod.provider.plex.tv'                                                        # get
     MUSIC = 'https://music.provider.plex.tv'                                                    # get
     METADATA = 'https://metadata.provider.plex.tv'
-    # Key may someday switch to the following url. For now the current value works.
-    # https://plex.tv/api/v2/user?X-Plex-Token={token}&X-Plex-Client-Identifier={clientId}
-    key = 'https://plex.tv/users/account'
+    key = 'https://plex.tv/api/v2/user'
 
-    def __init__(self, username=None, password=None, token=None, session=None, timeout=None, code=None):
-        self._token = token or CONFIG.get('auth.server_token')
+    def __init__(self, username=None, password=None, token=None, session=None, timeout=None, code=None, remember=True):
+        self._token = logfilter.add_secret(token or CONFIG.get('auth.server_token'))
         self._session = session or requests.Session()
         self._sonos_cache = []
         self._sonos_cache_timestamp = 0
-        data, initpath = self._signin(username, password, code, timeout)
+        data, initpath = self._signin(username, password, code, remember, timeout)
         super(MyPlexAccount, self).__init__(self, data, initpath)
 
-    def _signin(self, username, password, code, timeout):
+    def _signin(self, username, password, code, remember, timeout):
         if self._token:
             return self.query(self.key), self.key
-        username = username or CONFIG.get('auth.myplex_username')
-        password = password or CONFIG.get('auth.myplex_password')
+        payload = {
+            'login': username or CONFIG.get('auth.myplex_username'),
+            'password': password or CONFIG.get('auth.myplex_password'),
+            'rememberMe': remember
+        }
         if code:
-            password += code
-        data = self.query(self.SIGNIN, method=self._session.post, auth=(username, password), timeout=timeout)
+            payload['verificationCode'] = code
+        data = self.query(self.SIGNIN, method=self._session.post, data=payload, timeout=timeout)
         return data, self.SIGNIN
 
+    def signout(self):
+        """ Sign out of the Plex account. Invalidates the authentication token. """
+        return self.query(self.SIGNOUT, method=self._session.delete)
+
     def _loadData(self, data):
         """ Load attribute values from Plex XML response. """
         self._data = data
-        self._token = logfilter.add_secret(data.attrib.get('authenticationToken'))
+        self._token = logfilter.add_secret(data.attrib.get('authToken'))
         self._webhooks = []
-        self.authenticationToken = self._token
-        self.certificateVersion = data.attrib.get('certificateVersion')
-        self.cloudSyncDevice = data.attrib.get('cloudSyncDevice')
+
+        self.adsConsent = data.attrib.get('adsConsent')
+        self.adsConsentReminderAt = data.attrib.get('adsConsentReminderAt')
+        self.adsConsentSetAt = data.attrib.get('adsConsentSetAt')
+        self.anonymous = data.attrib.get('anonymous')
+        self.authToken = self._token
+        self.backupCodesCreated = utils.cast(bool, data.attrib.get('backupCodesCreated'))
+        self.confirmed = utils.cast(bool, data.attrib.get('confirmed'))
+        self.country = data.attrib.get('country')
         self.email = data.attrib.get('email')
+        self.emailOnlyAuth = utils.cast(bool, data.attrib.get('emailOnlyAuth'))
+        self.experimentalFeatures = utils.cast(bool, data.attrib.get('experimentalFeatures'))
+        self.friendlyName = data.attrib.get('friendlyName')
         self.guest = utils.cast(bool, data.attrib.get('guest'))
+        self.hasPassword = utils.cast(bool, data.attrib.get('hasPassword'))
         self.home = utils.cast(bool, data.attrib.get('home'))
+        self.homeAdmin = utils.cast(bool, data.attrib.get('homeAdmin'))
         self.homeSize = utils.cast(int, data.attrib.get('homeSize'))
         self.id = utils.cast(int, data.attrib.get('id'))
+        self.joinedAt = utils.toDatetime(data.attrib.get('joinedAt'))
         self.locale = data.attrib.get('locale')
-        self.mailing_list_status = data.attrib.get('mailing_list_status')
+        self.mailingListActive = utils.cast(bool, data.attrib.get('mailingListActive'))
+        self.mailingListStatus = data.attrib.get('mailingListStatus')
         self.maxHomeSize = utils.cast(int, data.attrib.get('maxHomeSize'))
         self.pin = data.attrib.get('pin')
-        self.queueEmail = data.attrib.get('queueEmail')
-        self.queueUid = data.attrib.get('queueUid')
+        self.protected = utils.cast(bool, data.attrib.get('protected'))
+        self.rememberExpiresAt = utils.toDatetime(data.attrib.get('rememberExpiresAt'))
         self.restricted = utils.cast(bool, data.attrib.get('restricted'))
-        self.scrobbleTypes = data.attrib.get('scrobbleTypes')
-        self.secure = utils.cast(bool, data.attrib.get('secure'))
+        self.scrobbleTypes = [utils.cast(int, x) for x in data.attrib.get('scrobbleTypes').split(',')]
         self.thumb = data.attrib.get('thumb')
         self.title = data.attrib.get('title')
+        self.twoFactorEnabled = utils.cast(bool, data.attrib.get('twoFactorEnabled'))
         self.username = data.attrib.get('username')
         self.uuid = data.attrib.get('uuid')
 
         subscription = data.find('subscription')
         self.subscriptionActive = utils.cast(bool, subscription.attrib.get('active'))
-        self.subscriptionStatus = subscription.attrib.get('status')
+        self.subscriptionDescription = data.attrib.get('subscriptionDescription')
+        self.subscriptionFeatures = self.listAttrs(subscription, 'id', rtag='features', etag='feature')
+        self.subscriptionPaymentService = subscription.attrib.get('paymentService')
         self.subscriptionPlan = subscription.attrib.get('plan')
-        self.subscriptionFeatures = self.listAttrs(subscription, 'id', etag='feature')
+        self.subscriptionStatus = subscription.attrib.get('status')
+        self.subscriptionSubscribedAt = utils.toDatetime(subscription.attrib.get('subscribedAt'), '%Y-%m-%d %H:%M:%S %Z')
 
-        self.roles = self.listAttrs(data, 'id', rtag='roles', etag='role')
+        profile = data.find('profile')
+        self.profileAutoSelectAudio = utils.cast(bool, profile.attrib.get('autoSelectAudio'))
+        self.profileDefaultAudioLanguage = profile.attrib.get('defaultAudioLanguage')
+        self.profileDefaultSubtitleLanguage = profile.attrib.get('defaultSubtitleLanguage')
+        self.profileAutoSelectSubtitle = utils.cast(int, profile.attrib.get('autoSelectSubtitle'))
+        self.profileDefaultSubtitleAccessibility = utils.cast(int, profile.attrib.get('defaultSubtitleAccessibility'))
+        self.profileDefaultSubtitleForces = utils.cast(int, profile.attrib.get('defaultSubtitleForces'))
 
         self.entitlements = self.listAttrs(data, 'id', rtag='entitlements', etag='entitlement')
+        self.roles = self.listAttrs(data, 'id', rtag='roles', etag='role')
 
-        # TODO: Fetch missing MyPlexAccount attributes
-        self.profile_settings = None
+        # TODO: Fetch missing MyPlexAccount services
         self.services = None
-        self.joined_at = None
 
-    def device(self, name=None, clientId=None):
-        """ Returns the :class:`~plexapi.myplex.MyPlexDevice` that matches the name specified.
+    @property
+    def authenticationToken(self):
+        """ Returns the authentication token for the account. Alias for ``authToken``. """
+        return self.authToken
 
-            Parameters:
-                name (str): Name to match against.
-                clientId (str): clientIdentifier to match against.
-        """
-        for device in self.devices():
-            if (name and device.name.lower() == name.lower() or device.clientIdentifier == clientId):
-                return device
-        raise NotFound(f'Unable to find device {name}')
-
-    def devices(self):
-        """ Returns a list of all :class:`~plexapi.myplex.MyPlexDevice` objects connected to the server. """
-        data = self.query(MyPlexDevice.key)
-        return [MyPlexDevice(self, elem) for elem in data]
+    def _reload(self, key=None, **kwargs):
+        """ Perform the actual reload. """
+        data = self.query(self.key)
+        self._loadData(data)
+        return self
 
     def _headers(self, **kwargs):
         """ Returns dict containing base headers for all requests to the server. """
@@ -188,6 +235,8 @@ class MyPlexAccount(PlexObject):
                 raise Unauthorized(message)
             elif response.status_code == 404:
                 raise NotFound(message)
+            elif response.status_code == 422 and "Invalid token" in response.text:
+                raise Unauthorized(message)
             else:
                 raise BadRequest(message)
         if headers.get('Accept') == 'application/json':
@@ -195,6 +244,23 @@ class MyPlexAccount(PlexObject):
         data = response.text.encode('utf8')
         return ElementTree.fromstring(data) if data.strip() else None
 
+    def device(self, name=None, clientId=None):
+        """ Returns the :class:`~plexapi.myplex.MyPlexDevice` that matches the name specified.
+
+            Parameters:
+                name (str): Name to match against.
+                clientId (str): clientIdentifier to match against.
+        """
+        for device in self.devices():
+            if (name and device.name.lower() == name.lower() or device.clientIdentifier == clientId):
+                return device
+        raise NotFound(f'Unable to find device {name}')
+
+    def devices(self):
+        """ Returns a list of all :class:`~plexapi.myplex.MyPlexDevice` objects connected to the server. """
+        data = self.query(MyPlexDevice.key)
+        return [MyPlexDevice(self, elem) for elem in data]
+
     def resource(self, name):
         """ Returns the :class:`~plexapi.myplex.MyPlexResource` that matches the name specified.
 
@@ -784,7 +850,7 @@ class MyPlexAccount(PlexObject):
             raise BadRequest(f'({response.status_code}) {codename} {response.url}; {errtext}')
         return response.json()['token']
 
-    def history(self, maxresults=9999999, mindate=None):
+    def history(self, maxresults=None, mindate=None):
         """ Get Play History for all library sections on all servers for the owner.
 
             Parameters:
@@ -817,7 +883,7 @@ class MyPlexAccount(PlexObject):
         data = self.query(f'{self.MUSIC}/hubs')
         return self.findItems(data)
 
-    def watchlist(self, filter=None, sort=None, libtype=None, maxresults=9999999, **kwargs):
+    def watchlist(self, filter=None, sort=None, libtype=None, maxresults=None, **kwargs):
         """ Returns a list of :class:`~plexapi.video.Movie` and :class:`~plexapi.video.Show` items in the user's watchlist.
             Note: The objects returned are from Plex's online metadata. To get the matching item on a Plex server,
             search for the media using the guid.
@@ -857,23 +923,10 @@ class MyPlexAccount(PlexObject):
         if libtype:
             params['type'] = utils.searchType(libtype)
 
-        params['X-Plex-Container-Start'] = 0
-        params['X-Plex-Container-Size'] = min(X_PLEX_CONTAINER_SIZE, maxresults)
         params.update(kwargs)
 
-        results, subresults = [], '_init'
-        while subresults and maxresults > len(results):
-            data = self.query(f'{self.METADATA}/library/sections/watchlist/{filter}', params=params)
-            subresults = self.findItems(data)
-            results += subresults[:maxresults - len(results)]
-            params['X-Plex-Container-Start'] += params['X-Plex-Container-Size']
-
-            # totalSize is available in first response, update maxresults from it
-            totalSize = utils.cast(int, data.attrib.get('totalSize'))
-            if maxresults > totalSize:
-                maxresults = totalSize
-
-        return self._toOnlineMetadata(results, **kwargs)
+        key = f'{self.METADATA}/library/sections/watchlist/{filter}{utils.joinArgs(params)}'
+        return self._toOnlineMetadata(self.fetchItems(key, maxresults=maxresults), **kwargs)
 
     def onWatchlist(self, item):
         """ Returns True if the item is on the user's watchlist.
@@ -936,6 +989,48 @@ class MyPlexAccount(PlexObject):
         data = self.query(f"{self.METADATA}/library/metadata/{ratingKey}/userState")
         return self.findItem(data, cls=UserState)
 
+    def isPlayed(self, item):
+        """ Return True if the item is played on Discover.
+
+            Parameters:
+                item (:class:`~plexapi.video.Movie`,
+                :class:`~plexapi.video.Show`, :class:`~plexapi.video.Season` or
+                :class:`~plexapi.video.Episode`): Object from searchDiscover().
+                Can be also result from Plex Movie or Plex TV Series agent.
+        """
+        userState = self.userState(item)
+        return bool(userState.viewCount > 0) if userState.viewCount else False
+
+    def markPlayed(self, item):
+        """ Mark the Plex object as played on Discover.
+
+            Parameters:
+                item (:class:`~plexapi.video.Movie`,
+                :class:`~plexapi.video.Show`, :class:`~plexapi.video.Season` or
+                :class:`~plexapi.video.Episode`): Object from searchDiscover().
+                Can be also result from Plex Movie or Plex TV Series agent.
+        """
+        key = f'{self.METADATA}/actions/scrobble'
+        ratingKey = item.guid.rsplit('/', 1)[-1]
+        params = {'key': ratingKey, 'identifier': 'com.plexapp.plugins.library'}
+        self.query(key, params=params)
+        return self
+
+    def markUnplayed(self, item):
+        """ Mark the Plex object as unplayed on Discover.
+
+            Parameters:
+                item (:class:`~plexapi.video.Movie`,
+                :class:`~plexapi.video.Show`, :class:`~plexapi.video.Season` or
+                :class:`~plexapi.video.Episode`): Object from searchDiscover().
+                Can be also result from Plex Movie or Plex TV Series agent.
+        """
+        key = f'{self.METADATA}/actions/unscrobble'
+        ratingKey = item.guid.rsplit('/', 1)[-1]
+        params = {'key': ratingKey, 'identifier': 'com.plexapp.plugins.library'}
+        self.query(key, params=params)
+        return self
+
     def searchDiscover(self, query, limit=30, libtype=None):
         """ Search for movies and TV shows in Discover.
             Returns a list of :class:`~plexapi.video.Movie` and :class:`~plexapi.video.Show` objects.
@@ -1117,7 +1212,7 @@ class MyPlexUser(PlexObject):
 
         raise NotFound(f'Unable to find server {name}')
 
-    def history(self, maxresults=9999999, mindate=None):
+    def history(self, maxresults=None, mindate=None):
         """ Get all Play History for a user in all shared servers.
             Parameters:
                 maxresults (int): Only return the specified number of results (optional).
@@ -1191,7 +1286,7 @@ class Section(PlexObject):
         self.sectionId = self.id  # For backwards compatibility
         self.sectionKey = self.key  # For backwards compatibility
 
-    def history(self, maxresults=9999999, mindate=None):
+    def history(self, maxresults=None, mindate=None):
         """ Get all Play History for a user for this section in this shared server.
             Parameters:
                 maxresults (int): Only return the specified number of results (optional).
@@ -1266,21 +1361,25 @@ class MyPlexResource(PlexObject):
     """ This object represents resources connected to your Plex server that can provide
         content such as Plex Media Servers, iPhone or Android clients, etc. The raw xml
         for the data presented here can be found at:
-        https://plex.tv/api/resources?includeHttps=1&includeRelay=1
+        https://plex.tv/api/v2/resources?includeHttps=1&includeRelay=1
 
         Attributes:
             TAG (str): 'Device'
-            key (str): 'https://plex.tv/api/resources?includeHttps=1&includeRelay=1'
-            accessToken (str): This resources accesstoken.
+            key (str): 'https://plex.tv/api/v2/resources?includeHttps=1&includeRelay=1'
+            accessToken (str): This resource's Plex access token.
             clientIdentifier (str): Unique ID for this resource.
             connections (list): List of :class:`~plexapi.myplex.ResourceConnection` objects
                 for this resource.
             createdAt (datetime): Timestamp this resource first connected to your server.
             device (str): Best guess on the type of device this is (PS, iPhone, Linux, etc).
+            dnsRebindingProtection (bool): True if the server had DNS rebinding protection.
             home (bool): Unknown
+            httpsRequired (bool): True if the resource requires https.
             lastSeenAt (datetime): Timestamp this resource last connected.
             name (str): Descriptive name of this resource.
+            natLoopbackSupported (bool): True if the resource supports NAT loopback.
             owned (bool): True if this resource is one of your own (you logged into it).
+            ownerId (int): ID of the user that owns this resource (shared resources only).
             platform (str): OS the resource is running (Linux, Windows, Chrome, etc.)
             platformVersion (str): Version of the platform.
             presence (bool): True if the resource is online
@@ -1288,10 +1387,13 @@ class MyPlexResource(PlexObject):
             productVersion (str): Version of the product.
             provides (str): List of services this resource provides (client, server,
                 player, pubsub-player, etc.)
+            publicAddressMatches (bool): True if the public IP address matches the client's public IP address.
+            relay (bool): True if this resource has the Plex Relay enabled.
+            sourceTitle (str): Username of the user that owns this resource (shared resources only).
             synced (bool): Unknown (possibly True if the resource has synced content?)
     """
-    TAG = 'Device'
-    key = 'https://plex.tv/api/resources?includeHttps=1&includeRelay=1'
+    TAG = 'resource'
+    key = 'https://plex.tv/api/v2/resources?includeHttps=1&includeRelay=1'
 
     # Default order to prioritize available resource connections
     DEFAULT_LOCATION_ORDER = ['local', 'remote', 'relay']
@@ -1299,33 +1401,35 @@ class MyPlexResource(PlexObject):
 
     def _loadData(self, data):
         self._data = data
-        self.name = data.attrib.get('name')
         self.accessToken = logfilter.add_secret(data.attrib.get('accessToken'))
-        self.product = data.attrib.get('product')
-        self.productVersion = data.attrib.get('productVersion')
+        self.clientIdentifier = data.attrib.get('clientIdentifier')
+        self.connections = self.findItems(data, ResourceConnection, rtag='connections')
+        self.createdAt = utils.toDatetime(data.attrib.get('createdAt'), "%Y-%m-%dT%H:%M:%SZ")
+        self.device = data.attrib.get('device')
+        self.dnsRebindingProtection = utils.cast(bool, data.attrib.get('dnsRebindingProtection'))
+        self.home = utils.cast(bool, data.attrib.get('home'))
+        self.httpsRequired = utils.cast(bool, data.attrib.get('httpsRequired'))
+        self.lastSeenAt = utils.toDatetime(data.attrib.get('lastSeenAt'), "%Y-%m-%dT%H:%M:%SZ")
+        self.name = data.attrib.get('name')
+        self.natLoopbackSupported = utils.cast(bool, data.attrib.get('natLoopbackSupported'))
+        self.owned = utils.cast(bool, data.attrib.get('owned'))
+        self.ownerId = utils.cast(int, data.attrib.get('ownerId', 0))
         self.platform = data.attrib.get('platform')
         self.platformVersion = data.attrib.get('platformVersion')
-        self.device = data.attrib.get('device')
-        self.clientIdentifier = data.attrib.get('clientIdentifier')
-        self.createdAt = utils.toDatetime(data.attrib.get('createdAt'))
-        self.lastSeenAt = utils.toDatetime(data.attrib.get('lastSeenAt'))
-        self.provides = data.attrib.get('provides')
-        self.owned = utils.cast(bool, data.attrib.get('owned'))
-        self.home = utils.cast(bool, data.attrib.get('home'))
-        self.synced = utils.cast(bool, data.attrib.get('synced'))
         self.presence = utils.cast(bool, data.attrib.get('presence'))
-        self.connections = self.findItems(data, ResourceConnection)
+        self.product = data.attrib.get('product')
+        self.productVersion = data.attrib.get('productVersion')
+        self.provides = data.attrib.get('provides')
         self.publicAddressMatches = utils.cast(bool, data.attrib.get('publicAddressMatches'))
-        # This seems to only be available if its not your device (say are shared server)
-        self.httpsRequired = utils.cast(bool, data.attrib.get('httpsRequired'))
-        self.ownerid = utils.cast(int, data.attrib.get('ownerId', 0))
-        self.sourceTitle = data.attrib.get('sourceTitle')  # owners plex username.
+        self.relay = utils.cast(bool, data.attrib.get('relay'))
+        self.sourceTitle = data.attrib.get('sourceTitle')
+        self.synced = utils.cast(bool, data.attrib.get('synced'))
 
     def preferred_connections(
         self,
         ssl=None,
-        locations=DEFAULT_LOCATION_ORDER,
-        schemes=DEFAULT_SCHEME_ORDER,
+        locations=None,
+        schemes=None,
     ):
         """ Returns a sorted list of the available connection addresses for this resource.
             Often times there is more than one address specified for a server or client.
@@ -1336,6 +1440,11 @@ class MyPlexResource(PlexObject):
                     only connect to HTTP connections. Set None (default) to connect to any
                     HTTP or HTTPS connection.
         """
+        if locations is None:
+            locations = self.DEFAULT_LOCATION_ORDER[:]
+        if schemes is None:
+            schemes = self.DEFAULT_SCHEME_ORDER[:]
+
         connections_dict = {location: {scheme: [] for scheme in schemes} for location in locations}
         for connection in self.connections:
             # Only check non-local connections unless we own the resource
@@ -1359,8 +1468,8 @@ class MyPlexResource(PlexObject):
         self,
         ssl=None,
         timeout=None,
-        locations=DEFAULT_LOCATION_ORDER,
-        schemes=DEFAULT_SCHEME_ORDER,
+        locations=None,
+        schemes=None,
     ):
         """ Returns a new :class:`~plexapi.server.PlexServer` or :class:`~plexapi.client.PlexClient` object.
             Uses `MyPlexResource.preferred_connections()` to generate the priority order of connection addresses.
@@ -1376,11 +1485,16 @@ class MyPlexResource(PlexObject):
             Raises:
                 :exc:`~plexapi.exceptions.NotFound`: When unable to connect to any addresses for this resource.
         """
+        if locations is None:
+            locations = self.DEFAULT_LOCATION_ORDER[:]
+        if schemes is None:
+            schemes = self.DEFAULT_SCHEME_ORDER[:]
+
         connections = self.preferred_connections(ssl, locations, schemes)
         # Try connecting to all known resource connections in parallel, but
         # only return the first server (in order) that provides a response.
         cls = PlexServer if 'server' in self.provides else PlexClient
-        listargs = [[cls, url, self.accessToken, timeout] for url in connections]
+        listargs = [[cls, url, self.accessToken, self._server._session, timeout] for url in connections]
         log.debug('Testing %s resource connections..', len(listargs))
         results = utils.threaded(_connect, listargs)
         return _chooseConnection('Resource', self.name, results)
@@ -1392,24 +1506,27 @@ class ResourceConnection(PlexObject):
 
         Attributes:
             TAG (str): 'Connection'
-            address (str): Local IP address
-            httpuri (str): Full local address
-            local (bool): True if local
-            port (int): 32400
+            address (str): The connection IP address
+            httpuri (str): Full HTTP URL
+            ipv6 (bool): True if the address is IPv6
+            local (bool): True if the address is local
+            port (int): The connection port
             protocol (str): HTTP or HTTPS
-            uri (str): External address
+            relay (bool): True if the address uses the Plex Relay
+            uri (str): Full connetion URL
     """
-    TAG = 'Connection'
+    TAG = 'connection'
 
     def _loadData(self, data):
         self._data = data
-        self.protocol = data.attrib.get('protocol')
         self.address = data.attrib.get('address')
-        self.port = utils.cast(int, data.attrib.get('port'))
-        self.uri = data.attrib.get('uri')
+        self.ipv6 = utils.cast(bool, data.attrib.get('IPv6'))
         self.local = utils.cast(bool, data.attrib.get('local'))
-        self.httpuri = f'http://{self.address}:{self.port}'
+        self.port = utils.cast(int, data.attrib.get('port'))
+        self.protocol = data.attrib.get('protocol')
         self.relay = utils.cast(bool, data.attrib.get('relay'))
+        self.uri = data.attrib.get('uri')
+        self.httpuri = f'http://{self.address}:{self.port}'
 
 
 class MyPlexDevice(PlexObject):
@@ -1475,7 +1592,7 @@ class MyPlexDevice(PlexObject):
                 :exc:`~plexapi.exceptions.NotFound`: When unable to connect to any addresses for this device.
         """
         cls = PlexServer if 'server' in self.provides else PlexClient
-        listargs = [[cls, url, self.token, timeout] for url in self.connections]
+        listargs = [[cls, url, self.token, self._server._session, timeout] for url in self.connections]
         log.debug('Testing %s device connections..', len(listargs))
         results = utils.threaded(_connect, listargs)
         return _chooseConnection('Device', self.name, results)
@@ -1725,7 +1842,7 @@ class MyPlexPinLogin:
         return ElementTree.fromstring(data) if data.strip() else None
 
 
-def _connect(cls, url, token, timeout, results, i, job_is_done_event=None):
+def _connect(cls, url, token, session, timeout, results, i, job_is_done_event=None):
     """ Connects to the specified cls with url and token. Stores the connection
         information to results[i] in a threadsafe way.
 
@@ -1733,6 +1850,7 @@ def _connect(cls, url, token, timeout, results, i, job_is_done_event=None):
             cls: the class which is responsible for establishing connection, basically it's
                  :class:`~plexapi.client.PlexClient` or :class:`~plexapi.server.PlexServer`
             url (str): url which should be passed as `baseurl` argument to cls.__init__()
+            session (requests.Session): session which sould be passed as `session` argument to cls.__init()
             token (str): authentication token which should be passed as `baseurl` argument to cls.__init__()
             timeout (int): timeout which should be passed as `baseurl` argument to cls.__init__()
             results (list): pre-filled list for results
@@ -1742,7 +1860,7 @@ def _connect(cls, url, token, timeout, results, i, job_is_done_event=None):
     """
     starttime = time.time()
     try:
-        device = cls(baseurl=url, token=token, timeout=timeout)
+        device = cls(baseurl=url, token=token, session=session, timeout=timeout)
         runtime = int(time.time() - starttime)
         results[i] = (url, token, device, runtime)
         if X_PLEX_ENABLE_FAST_CONNECT and job_is_done_event:
diff --git a/lib/plexapi/photo.py b/lib/plexapi/photo.py
index 4c3d89b5..039ac80c 100644
--- a/lib/plexapi/photo.py
+++ b/lib/plexapi/photo.py
@@ -8,8 +8,7 @@ from plexapi.exceptions import BadRequest
 from plexapi.mixins import (
     RatingMixin,
     ArtUrlMixin, ArtMixin, PosterUrlMixin, PosterMixin,
-    AddedAtMixin, SortTitleMixin, SummaryMixin, TitleMixin, PhotoCapturedTimeMixin,
-    TagMixin
+    PhotoalbumEditMixins, PhotoEditMixins
 )
 
 
@@ -18,7 +17,7 @@ class Photoalbum(
     PlexPartialObject,
     RatingMixin,
     ArtMixin, PosterMixin,
-    AddedAtMixin, SortTitleMixin, SummaryMixin, TitleMixin
+    PhotoalbumEditMixins
 ):
     """ Represents a single Photoalbum (collection of photos).
 
@@ -146,8 +145,7 @@ class Photo(
     PlexPartialObject, Playable,
     RatingMixin,
     ArtUrlMixin, PosterUrlMixin,
-    AddedAtMixin, PhotoCapturedTimeMixin, SortTitleMixin, SummaryMixin, TitleMixin,
-    TagMixin
+    PhotoEditMixins
 ):
     """ Represents a single Photo.
 
diff --git a/lib/plexapi/playlist.py b/lib/plexapi/playlist.py
index f5ece634..c435613a 100644
--- a/lib/plexapi/playlist.py
+++ b/lib/plexapi/playlist.py
@@ -433,7 +433,8 @@ class Playlist(
         """ Copy playlist to another user account.
         
             Parameters:
-                user (str): Username, email or user id of the user to copy the playlist to.
+                user (:class:`~plexapi.myplex.MyPlexUser` or str): `MyPlexUser` object, username,
+                    email, or user id of the user to copy the playlist to.
         """
         userServer = self._server.switchUser(user)
         return self.create(server=userServer, title=self.title, items=self.items())
diff --git a/lib/plexapi/playqueue.py b/lib/plexapi/playqueue.py
index 4c49f8d2..9835c0dd 100644
--- a/lib/plexapi/playqueue.py
+++ b/lib/plexapi/playqueue.py
@@ -170,7 +170,7 @@ class PlayQueue(PlexObject):
         }
 
         if isinstance(items, list):
-            item_keys = ",".join([str(x.ratingKey) for x in items])
+            item_keys = ",".join(str(x.ratingKey) for x in items)
             uri_args = quote_plus(f"/library/metadata/{item_keys}")
             args["uri"] = f"library:///directory/{uri_args}"
             args["type"] = items[0].listType
diff --git a/lib/plexapi/server.py b/lib/plexapi/server.py
index 4a1a51ce..69d5f89a 100644
--- a/lib/plexapi/server.py
+++ b/lib/plexapi/server.py
@@ -1,11 +1,12 @@
 # -*- coding: utf-8 -*-
+import os
+from functools import cached_property
 from urllib.parse import urlencode
 from xml.etree import ElementTree
 
 import requests
-import os
-from plexapi import (BASE_HEADERS, CONFIG, TIMEOUT, X_PLEX_CONTAINER_SIZE, log,
-                     logfilter)
+
+from plexapi import BASE_HEADERS, CONFIG, TIMEOUT, log, logfilter
 from plexapi import utils
 from plexapi.alert import AlertListener
 from plexapi.base import PlexObject
@@ -17,7 +18,7 @@ from plexapi.media import Conversion, Optimized
 from plexapi.playlist import Playlist
 from plexapi.playqueue import PlayQueue
 from plexapi.settings import Settings
-from plexapi.utils import cached_property, deprecated
+from plexapi.utils import deprecated
 from requests.status_codes import _codes as codes
 
 # Need these imports to populate utils.PLEXOBJECTS
@@ -236,12 +237,13 @@ class PlexServer(PlexObject):
         q = self.query(f'/security/token?type={type}&scope={scope}')
         return q.attrib.get('token')
 
-    def switchUser(self, username, session=None, timeout=None):
+    def switchUser(self, user, session=None, timeout=None):
         """ Returns a new :class:`~plexapi.server.PlexServer` object logged in as the given username.
             Note: Only the admin account can switch to other users.
         
             Parameters:
-                username (str): Username, email or user id of the user to log in to the server.
+                user (:class:`~plexapi.myplex.MyPlexUser` or str): `MyPlexUser` object, username,
+                    email, or user id of the user to log in to the server.
                 session (requests.Session, optional): Use your own session object if you want to
                     cache the http responses from the server. This will default to the same
                     session as the admin account if no new session is provided.
@@ -260,7 +262,8 @@ class PlexServer(PlexObject):
                     userPlex = plex.switchUser("Username")
 
         """
-        user = self.myPlexAccount().user(username)
+        from plexapi.myplex import MyPlexUser
+        user = user if isinstance(user, MyPlexUser) else self.myPlexAccount().user(user)
         userToken = user.get_token(self.machineIdentifier)
         if session is None:
             session = self._session
@@ -470,6 +473,7 @@ class PlexServer(PlexObject):
                         sort="episode.originallyAvailableAt:desc",
                         filters={"episode.originallyAvailableAt>>": "4w", "genre": "comedy"}
                     )
+
         """
         return Collection.create(
             self, title, section, items=items, smart=smart, limit=limit,
@@ -535,6 +539,7 @@ class PlexServer(PlexObject):
                         section="Music",
                         m3ufilepath="/path/to/playlist.m3u"
                     )
+
         """
         return Playlist.create(
             self, title, section=section, items=items, smart=smart, limit=limit,
@@ -549,26 +554,28 @@ class PlexServer(PlexObject):
         """
         return PlayQueue.create(self, item, **kwargs)
 
-    def downloadDatabases(self, savepath=None, unpack=False):
+    def downloadDatabases(self, savepath=None, unpack=False, showstatus=False):
         """ Download databases.
 
             Parameters:
                 savepath (str): Defaults to current working dir.
                 unpack (bool): Unpack the zip file.
+                showstatus(bool): Display a progressbar.
         """
         url = self.url('/diagnostics/databases')
-        filepath = utils.download(url, self._token, None, savepath, self._session, unpack=unpack)
+        filepath = utils.download(url, self._token, None, savepath, self._session, unpack=unpack, showstatus=showstatus)
         return filepath
 
-    def downloadLogs(self, savepath=None, unpack=False):
+    def downloadLogs(self, savepath=None, unpack=False, showstatus=False):
         """ Download server logs.
 
             Parameters:
                 savepath (str): Defaults to current working dir.
                 unpack (bool): Unpack the zip file.
+                showstatus(bool): Display a progressbar.
         """
         url = self.url('/diagnostics/logs')
-        filepath = utils.download(url, self._token, None, savepath, self._session, unpack=unpack)
+        filepath = utils.download(url, self._token, None, savepath, self._session, unpack=unpack, showstatus=showstatus)
         return filepath
 
     def butlerTasks(self):
@@ -588,6 +595,7 @@ class PlexServer(PlexObject):
 
                     availableTasks = [task.name for task in plex.butlerTasks()]
                     print("Available butler tasks:", availableTasks)
+
         """
         validTasks = [task.name for task in self.butlerTasks()]
         if task not in validTasks:
@@ -630,7 +638,7 @@ class PlexServer(PlexObject):
             # figure out what method this is..
             return self.query(part, method=self._session.put)
 
-    def history(self, maxresults=9999999, mindate=None, ratingKey=None, accountID=None, librarySectionID=None):
+    def history(self, maxresults=None, mindate=None, ratingKey=None, accountID=None, librarySectionID=None):
         """ Returns a list of media items from watched history. If there are many results, they will
             be fetched from the server in batches of X_PLEX_CONTAINER_SIZE amounts. If you're only
             looking for the first <num> results, it would be wise to set the maxresults option to that
@@ -644,7 +652,6 @@ class PlexServer(PlexObject):
                 accountID (int/str) Request history for a specific account ID.
                 librarySectionID (int/str) Request history for a specific library section ID.
         """
-        results, subresults = [], '_init'
         args = {'sort': 'viewedAt:desc'}
         if ratingKey:
             args['metadataItemID'] = ratingKey
@@ -654,14 +661,9 @@ class PlexServer(PlexObject):
             args['librarySectionID'] = librarySectionID
         if mindate:
             args['viewedAt>'] = int(mindate.timestamp())
-        args['X-Plex-Container-Start'] = 0
-        args['X-Plex-Container-Size'] = min(X_PLEX_CONTAINER_SIZE, maxresults)
-        while subresults and maxresults > len(results):
-            key = f'/status/sessions/history/all{utils.joinArgs(args)}'
-            subresults = self.fetchItems(key)
-            results += subresults[:maxresults - len(results)]
-            args['X-Plex-Container-Start'] += args['X-Plex-Container-Size']
-        return results
+        
+        key = f'/status/sessions/history/all{utils.joinArgs(args)}'
+        return self.fetchItems(key, maxresults=maxresults)
 
     def playlists(self, playlistType=None, sectionId=None, title=None, sort=None, **kwargs):
         """ Returns a list of all :class:`~plexapi.playlist.Playlist` objects on the server.
@@ -794,6 +796,10 @@ class PlexServer(PlexObject):
                 results += hub.items
         return results
 
+    def continueWatching(self):
+        """ Return a list of all items in the Continue Watching hub. """
+        return self.fetchItems('/hubs/continueWatching/items')
+
     def sessions(self):
         """ Returns a list of all active session (currently playing) media objects. """
         return self.fetchItems('/status/sessions')
diff --git a/lib/plexapi/settings.py b/lib/plexapi/settings.py
index ef91391b..c191e368 100644
--- a/lib/plexapi/settings.py
+++ b/lib/plexapi/settings.py
@@ -81,7 +81,7 @@ class Settings(PlexObject):
                 params[setting.id] = quote(setting._setValue)
         if not params:
             raise BadRequest('No setting have been modified.')
-        querystr = '&'.join([f'{k}={v}' for k, v in params.items()])
+        querystr = '&'.join(f'{k}={v}' for k, v in params.items())
         url = f'{self.key}?{querystr}'
         self._server.query(url, self._server._session.put)
         self.reload()
diff --git a/lib/plexapi/sonos.py b/lib/plexapi/sonos.py
index a7a57f4d..14f83d31 100644
--- a/lib/plexapi/sonos.py
+++ b/lib/plexapi/sonos.py
@@ -1,5 +1,6 @@
 # -*- coding: utf-8 -*-
 import requests
+
 from plexapi import CONFIG, X_PLEX_IDENTIFIER
 from plexapi.client import PlexClient
 from plexapi.exceptions import BadRequest
diff --git a/lib/plexapi/utils.py b/lib/plexapi/utils.py
index d7d5afd1..d1882fbb 100644
--- a/lib/plexapi/utils.py
+++ b/lib/plexapi/utils.py
@@ -15,20 +15,17 @@ from datetime import datetime
 from getpass import getpass
 from threading import Event, Thread
 from urllib.parse import quote
+from requests.status_codes import _codes as codes
 
 import requests
-from plexapi.exceptions import BadRequest, NotFound
+
+from plexapi.exceptions import BadRequest, NotFound, Unauthorized
 
 try:
     from tqdm import tqdm
 except ImportError:
     tqdm = None
 
-try:
-    from functools import cached_property
-except ImportError:
-    from backports.cached_property import cached_property  # noqa: F401
-
 log = logging.getLogger('plexapi')
 
 # Search Types - Plex uses these to filter specific media types when searching.
@@ -106,7 +103,7 @@ class SecretsFilter(logging.Filter):
         self.secrets = secrets or set()
 
     def add_secret(self, secret):
-        if secret is not None:
+        if secret is not None and secret != '':
             self.secrets.add(secret)
         return secret
 
@@ -128,7 +125,9 @@ def registerPlexObject(cls):
     etype = getattr(cls, 'STREAMTYPE', getattr(cls, 'TAGTYPE', cls.TYPE))
     ehash = f'{cls.TAG}.{etype}' if etype else cls.TAG
     if getattr(cls, '_SESSIONTYPE', None):
-        ehash = f"{ehash}.{'session'}"
+        ehash = f"{ehash}.session"
+    elif getattr(cls, '_HISTORYTYPE', None):
+        ehash = f"{ehash}.history"
     if ehash in PLEXOBJECTS:
         raise Exception(f'Ambiguous PlexObject definition {cls.__name__}(tag={cls.TAG}, type={etype}) '
                         f'with {PLEXOBJECTS[ehash].__name__}')
@@ -391,12 +390,12 @@ def downloadSessionImages(server, filename=None, height=150, width=150,
                 prettyname = media._prettyfilename()
                 filename = f'session_transcode_{media.usernames[0]}_{prettyname}_{int(time.time())}'
             url = server.transcodeImage(url, height, width, opacity, saturation)
-            filepath = download(url, filename=filename)
+            filepath = download(url, server._token, filename=filename)
             info['username'] = {'filepath': filepath, 'url': url}
     return info
 
 
-def download(url, token, filename=None, savepath=None, session=None, chunksize=4024,
+def download(url, token, filename=None, savepath=None, session=None, chunksize=4024,   # noqa: C901
              unpack=False, mocked=False, showstatus=False):
     """ Helper to download a thumb, videofile or other media item. Returns the local
         path to the downloaded file.
@@ -419,6 +418,17 @@ def download(url, token, filename=None, savepath=None, session=None, chunksize=4
     session = session or requests.Session()
     headers = {'X-Plex-Token': token}
     response = session.get(url, headers=headers, stream=True)
+    if response.status_code not in (200, 201, 204):
+        codename = codes.get(response.status_code)[0]
+        errtext = response.text.replace('\n', ' ')
+        message = f'({response.status_code}) {codename}; {response.url} {errtext}'
+        if response.status_code == 401:
+            raise Unauthorized(message)
+        elif response.status_code == 404:
+            raise NotFound(message)
+        else:
+            raise BadRequest(message)
+
     # make sure the savepath directory exists
     savepath = savepath or os.getcwd()
     os.makedirs(savepath, exist_ok=True)
diff --git a/lib/plexapi/video.py b/lib/plexapi/video.py
index d7f4d665..486bb5ca 100644
--- a/lib/plexapi/video.py
+++ b/lib/plexapi/video.py
@@ -3,19 +3,17 @@ import os
 from urllib.parse import quote_plus
 
 from plexapi import media, utils
-from plexapi.base import Playable, PlexPartialObject, PlexSession
+from plexapi.base import Playable, PlexPartialObject, PlexHistory, PlexSession
 from plexapi.exceptions import BadRequest
 from plexapi.mixins import (
     AdvancedSettingsMixin, SplitMergeMixin, UnmatchMatchMixin, ExtrasMixin, HubsMixin, PlayedUnplayedMixin, RatingMixin,
-    ArtUrlMixin, ArtMixin, BannerMixin, PosterUrlMixin, PosterMixin, ThemeUrlMixin, ThemeMixin,
-    AddedAtMixin, ContentRatingMixin, EditionTitleMixin, OriginallyAvailableMixin, OriginalTitleMixin, SortTitleMixin,
-    StudioMixin, SummaryMixin, TaglineMixin, TitleMixin,
-    CollectionMixin, CountryMixin, DirectorMixin, GenreMixin, LabelMixin, ProducerMixin, WriterMixin,
+    ArtUrlMixin, ArtMixin, PosterUrlMixin, PosterMixin, ThemeUrlMixin, ThemeMixin,
+    MovieEditMixins, ShowEditMixins, SeasonEditMixins, EpisodeEditMixins,
     WatchlistMixin
 )
 
 
-class Video(PlexPartialObject, PlayedUnplayedMixin, AddedAtMixin):
+class Video(PlexPartialObject, PlayedUnplayedMixin):
     """ Base class for all video objects including :class:`~plexapi.video.Movie`,
         :class:`~plexapi.video.Show`, :class:`~plexapi.video.Season`,
         :class:`~plexapi.video.Episode`, and :class:`~plexapi.video.Clip`.
@@ -186,20 +184,20 @@ class Video(PlexPartialObject, PlayedUnplayedMixin, AddedAtMixin):
 
                 .. code-block:: python
 
-                # Optimize for mobile using defaults
-                video.optimize(target="mobile")
+                    # Optimize for mobile using defaults
+                    video.optimize(target="mobile")
 
-                # Optimize for Android at 10 Mbps 1080p
-                from plexapi.sync import VIDEO_QUALITY_10_MBPS_1080p
-                video.optimize(deviceProfile="Android", videoQuality=sync.VIDEO_QUALITY_10_MBPS_1080p)
+                    # Optimize for Android at 10 Mbps 1080p
+                    from plexapi.sync import VIDEO_QUALITY_10_MBPS_1080p
+                    video.optimize(deviceProfile="Android", videoQuality=sync.VIDEO_QUALITY_10_MBPS_1080p)
 
-                # Optimize for iOS at original quality in library location
-                from plexapi.sync import VIDEO_QUALITY_ORIGINAL
-                locations = plex.library.section("Movies")._locations()
-                video.optimize(deviceProfile="iOS", videoQuality=VIDEO_QUALITY_ORIGINAL, locationID=locations[0])
+                    # Optimize for iOS at original quality in library location
+                    from plexapi.sync import VIDEO_QUALITY_ORIGINAL
+                    locations = plex.library.section("Movies")._locations()
+                    video.optimize(deviceProfile="iOS", videoQuality=VIDEO_QUALITY_ORIGINAL, locationID=locations[0])
 
-                # Optimize for tv the next 5 unwatched episodes
-                show.optimize(target="tv", limit=5, unwatched=True)
+                    # Optimize for tv the next 5 unwatched episodes
+                    show.optimize(target="tv", limit=5, unwatched=True)
 
         """
         from plexapi.library import Location
@@ -309,9 +307,7 @@ class Movie(
     Video, Playable,
     AdvancedSettingsMixin, SplitMergeMixin, UnmatchMatchMixin, ExtrasMixin, HubsMixin, RatingMixin,
     ArtMixin, PosterMixin, ThemeMixin,
-    ContentRatingMixin, EditionTitleMixin, OriginallyAvailableMixin, OriginalTitleMixin, SortTitleMixin, StudioMixin,
-    SummaryMixin, TaglineMixin, TitleMixin,
-    CollectionMixin, CountryMixin, DirectorMixin, GenreMixin, LabelMixin, ProducerMixin, WriterMixin,
+    MovieEditMixins,
     WatchlistMixin
 ):
     """ Represents a single Movie.
@@ -330,6 +326,7 @@ class Movie(
             duration (int): Duration of the movie in milliseconds.
             editionTitle (str): The edition title of the movie (e.g. Director's Cut, Extended Edition, etc.).
             enableCreditsMarkerGeneration (int): Setting that indicates if credits markers detection is enabled.
+                (-1 = Library default, 0 = Disabled)
             genres (List<:class:`~plexapi.media.Genre`>): List of genre objects.
             guids (List<:class:`~plexapi.media.Guid`>): List of guid objects.
             labels (List<:class:`~plexapi.media.Label`>): List of label objects.
@@ -441,15 +438,20 @@ class Movie(
         }
         return self.section().search(filters=filters)
 
+    def removeFromContinueWatching(self):
+        """ Remove the movie from continue watching. """
+        key = '/actions/removeFromContinueWatching'
+        params = {'ratingKey': self.ratingKey}
+        self._server.query(key, params=params, method=self._server._session.put)
+        return self
+
 
 @utils.registerPlexObject
 class Show(
     Video,
     AdvancedSettingsMixin, SplitMergeMixin, UnmatchMatchMixin, ExtrasMixin, HubsMixin, RatingMixin,
-    ArtMixin, BannerMixin, PosterMixin, ThemeMixin,
-    ContentRatingMixin, OriginallyAvailableMixin, OriginalTitleMixin, SortTitleMixin, StudioMixin,
-    SummaryMixin, TaglineMixin, TitleMixin,
-    CollectionMixin, GenreMixin, LabelMixin,
+    ArtMixin, PosterMixin, ThemeMixin,
+    ShowEditMixins,
     WatchlistMixin
 ):
     """ Represents a single Show (including all seasons and episodes).
@@ -467,12 +469,12 @@ class Show(
             autoDeletionItemPolicyWatchedLibrary (int): Setting that indicates if episodes are deleted
                 after being watched for the show (0 = Never, 1 = After a day, 7 = After a week,
                 100 = On next refresh).
-            banner (str): Key to banner artwork (/library/metadata/<ratingkey>/banner/<bannerid>).
             childCount (int): Number of seasons (including Specials) in the show.
             collections (List<:class:`~plexapi.media.Collection`>): List of collection objects.
             contentRating (str) Content rating (PG-13; NR; TV-G).
             duration (int): Typical duration of the show episodes in milliseconds.
             enableCreditsMarkerGeneration (int): Setting that indicates if credits markers detection is enabled.
+                (-1 = Library default, 0 = Disabled).
             episodeSort (int): Setting that indicates how episodes are sorted for the show
                 (-1 = Library default, 0 = Oldest first, 1 = Newest first).
             flattenSeasons (int): Setting that indicates if seasons are set to hidden for the show
@@ -494,7 +496,8 @@ class Show(
             roles (List<:class:`~plexapi.media.Role`>): List of role objects.
             seasonCount (int): Number of seasons (excluding Specials) in the show.
             showOrdering (str): Setting that indicates the episode ordering for the show
-                (None = Library default).
+                (None = Library default, tmdbAiring = The Movie Database (Aired),
+                aired = TheTVDB (Aired), dvd = TheTVDB (DVD), absolute = TheTVDB (Absolute)).
             similar (List<:class:`~plexapi.media.Similar`>): List of Similar objects.
             studio (str): Studio that created show (Di Bonaventura Pictures; 21 Laps Entertainment).
             subtitleLanguage (str): Setting that indicates the preferred subtitle language.
@@ -521,7 +524,6 @@ class Show(
             int, data.attrib.get('autoDeletionItemPolicyUnwatchedLibrary', '0'))
         self.autoDeletionItemPolicyWatchedLibrary = utils.cast(
             int, data.attrib.get('autoDeletionItemPolicyWatchedLibrary', '0'))
-        self.banner = data.attrib.get('banner')
         self.childCount = utils.cast(int, data.attrib.get('childCount'))
         self.collections = self.findItems(data, media.Collection)
         self.contentRating = data.attrib.get('contentRating')
@@ -659,8 +661,7 @@ class Season(
     Video,
     AdvancedSettingsMixin, ExtrasMixin, RatingMixin,
     ArtMixin, PosterMixin, ThemeUrlMixin,
-    SummaryMixin, TitleMixin,
-    CollectionMixin, LabelMixin
+    SeasonEditMixins
 ):
     """ Represents a single Show Season (including all episodes).
 
@@ -740,10 +741,12 @@ class Season(
         """ Returns the season number. """
         return self.index
 
-    def episodes(self, **kwargs):
-        """ Returns a list of :class:`~plexapi.video.Episode` objects in the season. """
-        key = f'{self.key}/children'
-        return self.fetchItems(key, Episode, **kwargs)
+    def onDeck(self):
+        """ Returns season's On Deck :class:`~plexapi.video.Video` object or `None`.
+            Will only return a match if the show's On Deck episode is in this season.
+        """
+        data = self._server.query(self._details_key)
+        return next(iter(self.findItems(data, rtag='OnDeck')), None)
 
     def episode(self, title=None, episode=None):
         """ Returns the episode with the given title or number.
@@ -766,17 +769,15 @@ class Season(
             return self.fetchItem(key, Episode, parentIndex=self.index, index=index)
         raise BadRequest('Missing argument: title or episode is required')
 
+    def episodes(self, **kwargs):
+        """ Returns a list of :class:`~plexapi.video.Episode` objects in the season. """
+        key = f'{self.key}/children'
+        return self.fetchItems(key, Episode, **kwargs)
+
     def get(self, title=None, episode=None):
         """ Alias to :func:`~plexapi.video.Season.episode`. """
         return self.episode(title, episode)
 
-    def onDeck(self):
-        """ Returns season's On Deck :class:`~plexapi.video.Video` object or `None`.
-            Will only return a match if the show's On Deck episode is in this season.
-        """
-        data = self._server.query(self._details_key)
-        return next(iter(self.findItems(data, rtag='OnDeck')), None)
-
     def show(self):
         """ Return the season's :class:`~plexapi.video.Show`. """
         return self.fetchItem(self.parentKey)
@@ -813,8 +814,7 @@ class Episode(
     Video, Playable,
     ExtrasMixin, RatingMixin,
     ArtMixin, PosterMixin, ThemeUrlMixin,
-    ContentRatingMixin, OriginallyAvailableMixin, SortTitleMixin, SummaryMixin, TitleMixin,
-    CollectionMixin, DirectorMixin, LabelMixin, WriterMixin
+    EpisodeEditMixins
 ):
     """ Represents a single Shows Episode.
 
@@ -906,7 +906,7 @@ class Episode(
 
         # If seasons are hidden, parentKey and parentRatingKey are missing from the XML response.
         # https://forums.plex.tv/t/parentratingkey-not-in-episode-xml-when-seasons-are-hidden/300553
-        if self.skipParent and not self.parentRatingKey:
+        if self.skipParent and data.attrib.get('parentRatingKey') is None:
             # Parse the parentRatingKey from the parentThumb
             if self.parentThumb and self.parentThumb.startswith('/library/metadata/'):
                 self.parentRatingKey = utils.cast(int, self.parentThumb.split('/')[3])
@@ -993,6 +993,13 @@ class Episode(
         """ Returns str, default title for a new syncItem. """
         return f'{self.grandparentTitle} - {self.parentTitle} - ({self.seasonEpisode}) {self.title}'
 
+    def removeFromContinueWatching(self):
+        """ Remove the movie from continue watching. """
+        key = '/actions/removeFromContinueWatching'
+        params = {'ratingKey': self.ratingKey}
+        self._server.query(key, params=params, method=self._server._session.put)
+        return self
+
 
 @utils.registerPlexObject
 class Clip(
@@ -1105,3 +1112,42 @@ class ClipSession(PlexSession, Clip):
         """ Load attribute values from Plex XML response. """
         Clip._loadData(self, data)
         PlexSession._loadData(self, data)
+
+
+@utils.registerPlexObject
+class MovieHistory(PlexHistory, Movie):
+    """ Represents a single Movie history entry
+        loaded from :func:`~plexapi.server.PlexServer.history`.
+    """
+    _HISTORYTYPE = True
+
+    def _loadData(self, data):
+        """ Load attribute values from Plex XML response. """
+        Movie._loadData(self, data)
+        PlexHistory._loadData(self, data)
+
+
+@utils.registerPlexObject
+class EpisodeHistory(PlexHistory, Episode):
+    """ Represents a single Episode history entry
+        loaded from :func:`~plexapi.server.PlexServer.history`.
+    """
+    _HISTORYTYPE = True
+
+    def _loadData(self, data):
+        """ Load attribute values from Plex XML response. """
+        Episode._loadData(self, data)
+        PlexHistory._loadData(self, data)
+
+
+@utils.registerPlexObject
+class ClipHistory(PlexHistory, Clip):
+    """ Represents a single Clip history entry
+        loaded from :func:`~plexapi.server.PlexServer.history`.
+    """
+    _HISTORYTYPE = True
+
+    def _loadData(self, data):
+        """ Load attribute values from Plex XML response. """
+        Clip._loadData(self, data)
+        PlexHistory._loadData(self, data)
diff --git a/requirements.txt b/requirements.txt
index 472235de..3fc87314 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -28,7 +28,7 @@ MarkupSafe==2.1.3
 musicbrainzngs==0.7.1
 packaging==23.1
 paho-mqtt==1.6.1
-plexapi==4.13.4
+plexapi==4.15.0
 portend==3.2.0
 profilehooks==1.12.0
 PyJWT==2.8.0

From 24fbc9a17a139f2bb62f4cdab6c2be79bc3510ae Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 24 Aug 2023 12:17:21 -0700
Subject: [PATCH 448/743] Add track chapter exporter fields

---
 plexpy/exporter.py | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/plexpy/exporter.py b/plexpy/exporter.py
index 3a48c6d7..2c92a072 100644
--- a/plexpy/exporter.py
+++ b/plexpy/exporter.py
@@ -956,6 +956,14 @@ class Export(object):
                 'addedAt': helpers.datetime_to_iso,
                 'art': None,
                 'artBlurHash': None,
+                'chapters': {
+                    'id': None,
+                    'tag': None,
+                    'index': None,
+                    'start': None,
+                    'end': None,
+                    'thumb': None
+                },
                 'chapterSource': None,
                 'collections': {
                     'id': None,

From 67842cfa021709f3ba614dfc7d3005f440c14b60 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 24 Aug 2023 12:17:38 -0700
Subject: [PATCH 449/743] Add subtitleStream exporter fields for on-demand
 subtitles

---
 plexpy/exporter.py | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/plexpy/exporter.py b/plexpy/exporter.py
index 2c92a072..f1c730a4 100644
--- a/plexpy/exporter.py
+++ b/plexpy/exporter.py
@@ -363,7 +363,11 @@ class Export(object):
                             'forced': None,
                             'format': None,
                             'headerCompression': None,
-                            'transient': None
+                            'providerTitle': None,
+                            'score': None,
+                            'sourceKey': None,
+                            'transient': None,
+                            'userID': None
                         }
                     }
                 },
@@ -759,7 +763,11 @@ class Export(object):
                             'forced': None,
                             'format': None,
                             'headerCompression': None,
-                            'transient': None
+                            'providerTitle': None,
+                            'score': None,
+                            'sourceKey': None,
+                            'transient': None,
+                            'userID': None
                         }
                     }
                 },

From b133904b481be3bb6ab216a2700717dcb8ce124e Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 24 Aug 2023 12:20:50 -0700
Subject: [PATCH 450/743] Drop support for Python 3.7

---
 CONTRIBUTING.md | 2 +-
 README.md       | 2 +-
 start.sh        | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 19644c56..46a644e5 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -9,7 +9,7 @@ All pull requests should be based on the `nightly` branch, to minimize cross mer
 ### Python Code
 
 #### Compatibility
-The code should work with Python 3.7+. Note that Tautulli runs on many different platforms.
+The code should work with Python 3.8+. Note that Tautulli runs on many different platforms.
 
 Re-use existing code. Do not hesitate to add logging in your code. You can the logger module `plexpy.logger.*` for this. Web requests are invoked via `plexpy.request.*` and derived ones. Use these methods to automatically add proper and meaningful error handling.
 
diff --git a/README.md b/README.md
index d38f69e1..a6a3e4e4 100644
--- a/README.md
+++ b/README.md
@@ -36,7 +36,7 @@ and [PlexWatchWeb](https://github.com/ecleese/plexWatchWeb).
 [![Docker Stars][badge-docker-stars]][DockerHub]
 [![Downloads][badge-downloads]][Releases Latest]
 
-[badge-python]: https://img.shields.io/badge/python->=3.7-blue?style=flat-square
+[badge-python]: https://img.shields.io/badge/python->=3.8-blue?style=flat-square
 [badge-docker-pulls]: https://img.shields.io/docker/pulls/tautulli/tautulli?style=flat-square
 [badge-docker-stars]: https://img.shields.io/docker/stars/tautulli/tautulli?style=flat-square
 [badge-downloads]: https://img.shields.io/github/downloads/Tautulli/Tautulli/total?style=flat-square
diff --git a/start.sh b/start.sh
index 7869c3c6..a9970df7 100755
--- a/start.sh
+++ b/start.sh
@@ -12,7 +12,7 @@ if [[ "$TAUTULLI_DOCKER" == "True" ]]; then
     echo "Running Tautulli using user tautulli (uid=$(id -u tautulli)) and group tautulli (gid=$(id -g tautulli))"
     exec gosu tautulli "$@"
 else
-    python_versions=("python3" "python3.8" "python3.7" "python3.6" "python" "python2" "python2.7")
+    python_versions=("python3.11" "python3.10" "python3.9" "python3.8" "python3" "python")
     for cmd in "${python_versions[@]}"; do
         if command -v "$cmd" >/dev/null; then
             echo "Starting Tautulli with $cmd."

From 38435ae81c5b029e54f87aa460d6f9394e6c3180 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 24 Aug 2023 13:49:16 -0700
Subject: [PATCH 451/743] Remove importlib-metadata and importlib-resources

---
 lib/importlib_metadata/__init__.py            | 904 ------------------
 lib/importlib_metadata/_adapters.py           |  90 --
 lib/importlib_metadata/_collections.py        |  30 -
 lib/importlib_metadata/_compat.py             |  72 --
 lib/importlib_metadata/_functools.py          | 104 --
 lib/importlib_metadata/_itertools.py          |  73 --
 lib/importlib_metadata/_meta.py               |  49 -
 lib/importlib_metadata/_py39compat.py         |  35 -
 lib/importlib_metadata/_text.py               |  99 --
 lib/importlib_metadata/py.typed               |   0
 lib/importlib_resources/__init__.py           |  17 -
 lib/importlib_resources/_adapters.py          | 168 ----
 lib/importlib_resources/_common.py            | 207 ----
 lib/importlib_resources/_compat.py            | 109 ---
 lib/importlib_resources/_itertools.py         |  38 -
 lib/importlib_resources/abc.py                | 170 ----
 lib/importlib_resources/py.typed              |   0
 lib/importlib_resources/readers.py            | 144 ---
 lib/importlib_resources/simple.py             | 106 --
 lib/importlib_resources/tests/__init__.py     |   0
 lib/importlib_resources/tests/_compat.py      |  32 -
 lib/importlib_resources/tests/_path.py        |  56 --
 .../tests/data01/__init__.py                  |   0
 .../tests/data01/binary.file                  | Bin 4 -> 0 bytes
 .../tests/data01/subdirectory/__init__.py     |   0
 .../tests/data01/subdirectory/binary.file     | Bin 4 -> 0 bytes
 .../tests/data01/utf-16.file                  | Bin 44 -> 0 bytes
 .../tests/data01/utf-8.file                   |   1 -
 .../tests/data02/__init__.py                  |   0
 .../tests/data02/one/__init__.py              |   0
 .../tests/data02/one/resource1.txt            |   1 -
 .../subdirectory/subsubdir/resource.txt       |   1 -
 .../tests/data02/two/__init__.py              |   0
 .../tests/data02/two/resource2.txt            |   1 -
 .../tests/namespacedata01/binary.file         | Bin 4 -> 0 bytes
 .../tests/namespacedata01/utf-16.file         | Bin 44 -> 0 bytes
 .../tests/namespacedata01/utf-8.file          |   1 -
 .../tests/test_compatibilty_files.py          | 104 --
 .../tests/test_contents.py                    |  43 -
 lib/importlib_resources/tests/test_custom.py  |  45 -
 lib/importlib_resources/tests/test_files.py   | 112 ---
 lib/importlib_resources/tests/test_open.py    |  85 --
 lib/importlib_resources/tests/test_path.py    |  69 --
 lib/importlib_resources/tests/test_read.py    |  82 --
 lib/importlib_resources/tests/test_reader.py  | 144 ---
 .../tests/test_resource.py                    | 252 -----
 lib/importlib_resources/tests/update-zips.py  |  53 -
 lib/importlib_resources/tests/util.py         | 179 ----
 .../tests/zipdata01/__init__.py               |   0
 .../tests/zipdata01/ziptestdata.zip           | Bin 876 -> 0 bytes
 .../tests/zipdata02/__init__.py               |   0
 .../tests/zipdata02/ziptestdata.zip           | Bin 698 -> 0 bytes
 requirements.txt                              |   2 -
 53 files changed, 3678 deletions(-)
 delete mode 100644 lib/importlib_metadata/__init__.py
 delete mode 100644 lib/importlib_metadata/_adapters.py
 delete mode 100644 lib/importlib_metadata/_collections.py
 delete mode 100644 lib/importlib_metadata/_compat.py
 delete mode 100644 lib/importlib_metadata/_functools.py
 delete mode 100644 lib/importlib_metadata/_itertools.py
 delete mode 100644 lib/importlib_metadata/_meta.py
 delete mode 100644 lib/importlib_metadata/_py39compat.py
 delete mode 100644 lib/importlib_metadata/_text.py
 delete mode 100644 lib/importlib_metadata/py.typed
 delete mode 100644 lib/importlib_resources/__init__.py
 delete mode 100644 lib/importlib_resources/_adapters.py
 delete mode 100644 lib/importlib_resources/_common.py
 delete mode 100644 lib/importlib_resources/_compat.py
 delete mode 100644 lib/importlib_resources/_itertools.py
 delete mode 100644 lib/importlib_resources/abc.py
 delete mode 100644 lib/importlib_resources/py.typed
 delete mode 100644 lib/importlib_resources/readers.py
 delete mode 100644 lib/importlib_resources/simple.py
 delete mode 100644 lib/importlib_resources/tests/__init__.py
 delete mode 100644 lib/importlib_resources/tests/_compat.py
 delete mode 100644 lib/importlib_resources/tests/_path.py
 delete mode 100644 lib/importlib_resources/tests/data01/__init__.py
 delete mode 100644 lib/importlib_resources/tests/data01/binary.file
 delete mode 100644 lib/importlib_resources/tests/data01/subdirectory/__init__.py
 delete mode 100644 lib/importlib_resources/tests/data01/subdirectory/binary.file
 delete mode 100644 lib/importlib_resources/tests/data01/utf-16.file
 delete mode 100644 lib/importlib_resources/tests/data01/utf-8.file
 delete mode 100644 lib/importlib_resources/tests/data02/__init__.py
 delete mode 100644 lib/importlib_resources/tests/data02/one/__init__.py
 delete mode 100644 lib/importlib_resources/tests/data02/one/resource1.txt
 delete mode 100644 lib/importlib_resources/tests/data02/subdirectory/subsubdir/resource.txt
 delete mode 100644 lib/importlib_resources/tests/data02/two/__init__.py
 delete mode 100644 lib/importlib_resources/tests/data02/two/resource2.txt
 delete mode 100644 lib/importlib_resources/tests/namespacedata01/binary.file
 delete mode 100644 lib/importlib_resources/tests/namespacedata01/utf-16.file
 delete mode 100644 lib/importlib_resources/tests/namespacedata01/utf-8.file
 delete mode 100644 lib/importlib_resources/tests/test_compatibilty_files.py
 delete mode 100644 lib/importlib_resources/tests/test_contents.py
 delete mode 100644 lib/importlib_resources/tests/test_custom.py
 delete mode 100644 lib/importlib_resources/tests/test_files.py
 delete mode 100644 lib/importlib_resources/tests/test_open.py
 delete mode 100644 lib/importlib_resources/tests/test_path.py
 delete mode 100644 lib/importlib_resources/tests/test_read.py
 delete mode 100644 lib/importlib_resources/tests/test_reader.py
 delete mode 100644 lib/importlib_resources/tests/test_resource.py
 delete mode 100644 lib/importlib_resources/tests/update-zips.py
 delete mode 100644 lib/importlib_resources/tests/util.py
 delete mode 100644 lib/importlib_resources/tests/zipdata01/__init__.py
 delete mode 100644 lib/importlib_resources/tests/zipdata01/ziptestdata.zip
 delete mode 100644 lib/importlib_resources/tests/zipdata02/__init__.py
 delete mode 100644 lib/importlib_resources/tests/zipdata02/ziptestdata.zip

diff --git a/lib/importlib_metadata/__init__.py b/lib/importlib_metadata/__init__.py
deleted file mode 100644
index 9a36a8e6..00000000
--- a/lib/importlib_metadata/__init__.py
+++ /dev/null
@@ -1,904 +0,0 @@
-import os
-import re
-import abc
-import csv
-import sys
-import zipp
-import email
-import pathlib
-import operator
-import textwrap
-import warnings
-import functools
-import itertools
-import posixpath
-import collections
-
-from . import _adapters, _meta, _py39compat
-from ._collections import FreezableDefaultDict, Pair
-from ._compat import (
-    NullFinder,
-    install,
-    pypy_partial,
-)
-from ._functools import method_cache, pass_none
-from ._itertools import always_iterable, unique_everseen
-from ._meta import PackageMetadata, SimplePath
-
-from contextlib import suppress
-from importlib import import_module
-from importlib.abc import MetaPathFinder
-from itertools import starmap
-from typing import List, Mapping, Optional
-
-
-__all__ = [
-    'Distribution',
-    'DistributionFinder',
-    'PackageMetadata',
-    'PackageNotFoundError',
-    'distribution',
-    'distributions',
-    'entry_points',
-    'files',
-    'metadata',
-    'packages_distributions',
-    'requires',
-    'version',
-]
-
-
-class PackageNotFoundError(ModuleNotFoundError):
-    """The package was not found."""
-
-    def __str__(self):
-        return f"No package metadata was found for {self.name}"
-
-    @property
-    def name(self):
-        (name,) = self.args
-        return name
-
-
-class Sectioned:
-    """
-    A simple entry point config parser for performance
-
-    >>> for item in Sectioned.read(Sectioned._sample):
-    ...     print(item)
-    Pair(name='sec1', value='# comments ignored')
-    Pair(name='sec1', value='a = 1')
-    Pair(name='sec1', value='b = 2')
-    Pair(name='sec2', value='a = 2')
-
-    >>> res = Sectioned.section_pairs(Sectioned._sample)
-    >>> item = next(res)
-    >>> item.name
-    'sec1'
-    >>> item.value
-    Pair(name='a', value='1')
-    >>> item = next(res)
-    >>> item.value
-    Pair(name='b', value='2')
-    >>> item = next(res)
-    >>> item.name
-    'sec2'
-    >>> item.value
-    Pair(name='a', value='2')
-    >>> list(res)
-    []
-    """
-
-    _sample = textwrap.dedent(
-        """
-        [sec1]
-        # comments ignored
-        a = 1
-        b = 2
-
-        [sec2]
-        a = 2
-        """
-    ).lstrip()
-
-    @classmethod
-    def section_pairs(cls, text):
-        return (
-            section._replace(value=Pair.parse(section.value))
-            for section in cls.read(text, filter_=cls.valid)
-            if section.name is not None
-        )
-
-    @staticmethod
-    def read(text, filter_=None):
-        lines = filter(filter_, map(str.strip, text.splitlines()))
-        name = None
-        for value in lines:
-            section_match = value.startswith('[') and value.endswith(']')
-            if section_match:
-                name = value.strip('[]')
-                continue
-            yield Pair(name, value)
-
-    @staticmethod
-    def valid(line):
-        return line and not line.startswith('#')
-
-
-class DeprecatedTuple:
-    """
-    Provide subscript item access for backward compatibility.
-
-    >>> recwarn = getfixture('recwarn')
-    >>> ep = EntryPoint(name='name', value='value', group='group')
-    >>> ep[:]
-    ('name', 'value', 'group')
-    >>> ep[0]
-    'name'
-    >>> len(recwarn)
-    1
-    """
-
-    # Do not remove prior to 2023-05-01 or Python 3.13
-    _warn = functools.partial(
-        warnings.warn,
-        "EntryPoint tuple interface is deprecated. Access members by name.",
-        DeprecationWarning,
-        stacklevel=pypy_partial(2),
-    )
-
-    def __getitem__(self, item):
-        self._warn()
-        return self._key()[item]
-
-
-class EntryPoint(DeprecatedTuple):
-    """An entry point as defined by Python packaging conventions.
-
-    See `the packaging docs on entry points
-    <https://packaging.python.org/specifications/entry-points/>`_
-    for more information.
-
-    >>> ep = EntryPoint(
-    ...     name=None, group=None, value='package.module:attr [extra1, extra2]')
-    >>> ep.module
-    'package.module'
-    >>> ep.attr
-    'attr'
-    >>> ep.extras
-    ['extra1', 'extra2']
-    """
-
-    pattern = re.compile(
-        r'(?P<module>[\w.]+)\s*'
-        r'(:\s*(?P<attr>[\w.]+)\s*)?'
-        r'((?P<extras>\[.*\])\s*)?$'
-    )
-    """
-    A regular expression describing the syntax for an entry point,
-    which might look like:
-
-        - module
-        - package.module
-        - package.module:attribute
-        - package.module:object.attribute
-        - package.module:attr [extra1, extra2]
-
-    Other combinations are possible as well.
-
-    The expression is lenient about whitespace around the ':',
-    following the attr, and following any extras.
-    """
-
-    name: str
-    value: str
-    group: str
-
-    dist: Optional['Distribution'] = None
-
-    def __init__(self, name, value, group):
-        vars(self).update(name=name, value=value, group=group)
-
-    def load(self):
-        """Load the entry point from its definition. If only a module
-        is indicated by the value, return that module. Otherwise,
-        return the named object.
-        """
-        match = self.pattern.match(self.value)
-        module = import_module(match.group('module'))
-        attrs = filter(None, (match.group('attr') or '').split('.'))
-        return functools.reduce(getattr, attrs, module)
-
-    @property
-    def module(self):
-        match = self.pattern.match(self.value)
-        return match.group('module')
-
-    @property
-    def attr(self):
-        match = self.pattern.match(self.value)
-        return match.group('attr')
-
-    @property
-    def extras(self):
-        match = self.pattern.match(self.value)
-        return re.findall(r'\w+', match.group('extras') or '')
-
-    def _for(self, dist):
-        vars(self).update(dist=dist)
-        return self
-
-    def matches(self, **params):
-        """
-        EntryPoint matches the given parameters.
-
-        >>> ep = EntryPoint(group='foo', name='bar', value='bing:bong [extra1, extra2]')
-        >>> ep.matches(group='foo')
-        True
-        >>> ep.matches(name='bar', value='bing:bong [extra1, extra2]')
-        True
-        >>> ep.matches(group='foo', name='other')
-        False
-        >>> ep.matches()
-        True
-        >>> ep.matches(extras=['extra1', 'extra2'])
-        True
-        >>> ep.matches(module='bing')
-        True
-        >>> ep.matches(attr='bong')
-        True
-        """
-        attrs = (getattr(self, param) for param in params)
-        return all(map(operator.eq, params.values(), attrs))
-
-    def _key(self):
-        return self.name, self.value, self.group
-
-    def __lt__(self, other):
-        return self._key() < other._key()
-
-    def __eq__(self, other):
-        return self._key() == other._key()
-
-    def __setattr__(self, name, value):
-        raise AttributeError("EntryPoint objects are immutable.")
-
-    def __repr__(self):
-        return (
-            f'EntryPoint(name={self.name!r}, value={self.value!r}, '
-            f'group={self.group!r})'
-        )
-
-    def __hash__(self):
-        return hash(self._key())
-
-
-class EntryPoints(tuple):
-    """
-    An immutable collection of selectable EntryPoint objects.
-    """
-
-    __slots__ = ()
-
-    def __getitem__(self, name):  # -> EntryPoint:
-        """
-        Get the EntryPoint in self matching name.
-        """
-        try:
-            return next(iter(self.select(name=name)))
-        except StopIteration:
-            raise KeyError(name)
-
-    def select(self, **params):
-        """
-        Select entry points from self that match the
-        given parameters (typically group and/or name).
-        """
-        return EntryPoints(ep for ep in self if _py39compat.ep_matches(ep, **params))
-
-    @property
-    def names(self):
-        """
-        Return the set of all names of all entry points.
-        """
-        return {ep.name for ep in self}
-
-    @property
-    def groups(self):
-        """
-        Return the set of all groups of all entry points.
-        """
-        return {ep.group for ep in self}
-
-    @classmethod
-    def _from_text_for(cls, text, dist):
-        return cls(ep._for(dist) for ep in cls._from_text(text))
-
-    @staticmethod
-    def _from_text(text):
-        return (
-            EntryPoint(name=item.value.name, value=item.value.value, group=item.name)
-            for item in Sectioned.section_pairs(text or '')
-        )
-
-
-class PackagePath(pathlib.PurePosixPath):
-    """A reference to a path in a package"""
-
-    def read_text(self, encoding='utf-8'):
-        with self.locate().open(encoding=encoding) as stream:
-            return stream.read()
-
-    def read_binary(self):
-        with self.locate().open('rb') as stream:
-            return stream.read()
-
-    def locate(self):
-        """Return a path-like object for this path"""
-        return self.dist.locate_file(self)
-
-
-class FileHash:
-    def __init__(self, spec):
-        self.mode, _, self.value = spec.partition('=')
-
-    def __repr__(self):
-        return f'<FileHash mode: {self.mode} value: {self.value}>'
-
-
-class Distribution(metaclass=abc.ABCMeta):
-    """A Python distribution package."""
-
-    @abc.abstractmethod
-    def read_text(self, filename):
-        """Attempt to load metadata file given by the name.
-
-        :param filename: The name of the file in the distribution info.
-        :return: The text if found, otherwise None.
-        """
-
-    @abc.abstractmethod
-    def locate_file(self, path):
-        """
-        Given a path to a file in this distribution, return a path
-        to it.
-        """
-
-    @classmethod
-    def from_name(cls, name: str):
-        """Return the Distribution for the given package name.
-
-        :param name: The name of the distribution package to search for.
-        :return: The Distribution instance (or subclass thereof) for the named
-            package, if found.
-        :raises PackageNotFoundError: When the named package's distribution
-            metadata cannot be found.
-        :raises ValueError: When an invalid value is supplied for name.
-        """
-        if not name:
-            raise ValueError("A distribution name is required.")
-        try:
-            return next(cls.discover(name=name))
-        except StopIteration:
-            raise PackageNotFoundError(name)
-
-    @classmethod
-    def discover(cls, **kwargs):
-        """Return an iterable of Distribution objects for all packages.
-
-        Pass a ``context`` or pass keyword arguments for constructing
-        a context.
-
-        :context: A ``DistributionFinder.Context`` object.
-        :return: Iterable of Distribution objects for all packages.
-        """
-        context = kwargs.pop('context', None)
-        if context and kwargs:
-            raise ValueError("cannot accept context and kwargs")
-        context = context or DistributionFinder.Context(**kwargs)
-        return itertools.chain.from_iterable(
-            resolver(context) for resolver in cls._discover_resolvers()
-        )
-
-    @staticmethod
-    def at(path):
-        """Return a Distribution for the indicated metadata path
-
-        :param path: a string or path-like object
-        :return: a concrete Distribution instance for the path
-        """
-        return PathDistribution(pathlib.Path(path))
-
-    @staticmethod
-    def _discover_resolvers():
-        """Search the meta_path for resolvers."""
-        declared = (
-            getattr(finder, 'find_distributions', None) for finder in sys.meta_path
-        )
-        return filter(None, declared)
-
-    @property
-    def metadata(self) -> _meta.PackageMetadata:
-        """Return the parsed metadata for this Distribution.
-
-        The returned object will have keys that name the various bits of
-        metadata.  See PEP 566 for details.
-        """
-        text = (
-            self.read_text('METADATA')
-            or self.read_text('PKG-INFO')
-            # This last clause is here to support old egg-info files.  Its
-            # effect is to just end up using the PathDistribution's self._path
-            # (which points to the egg-info file) attribute unchanged.
-            or self.read_text('')
-        )
-        return _adapters.Message(email.message_from_string(text))
-
-    @property
-    def name(self):
-        """Return the 'Name' metadata for the distribution package."""
-        return self.metadata['Name']
-
-    @property
-    def _normalized_name(self):
-        """Return a normalized version of the name."""
-        return Prepared.normalize(self.name)
-
-    @property
-    def version(self):
-        """Return the 'Version' metadata for the distribution package."""
-        return self.metadata['Version']
-
-    @property
-    def entry_points(self):
-        return EntryPoints._from_text_for(self.read_text('entry_points.txt'), self)
-
-    @property
-    def files(self):
-        """Files in this distribution.
-
-        :return: List of PackagePath for this distribution or None
-
-        Result is `None` if the metadata file that enumerates files
-        (i.e. RECORD for dist-info or SOURCES.txt for egg-info) is
-        missing.
-        Result may be empty if the metadata exists but is empty.
-        """
-
-        def make_file(name, hash=None, size_str=None):
-            result = PackagePath(name)
-            result.hash = FileHash(hash) if hash else None
-            result.size = int(size_str) if size_str else None
-            result.dist = self
-            return result
-
-        @pass_none
-        def make_files(lines):
-            return list(starmap(make_file, csv.reader(lines)))
-
-        return make_files(self._read_files_distinfo() or self._read_files_egginfo())
-
-    def _read_files_distinfo(self):
-        """
-        Read the lines of RECORD
-        """
-        text = self.read_text('RECORD')
-        return text and text.splitlines()
-
-    def _read_files_egginfo(self):
-        """
-        SOURCES.txt might contain literal commas, so wrap each line
-        in quotes.
-        """
-        text = self.read_text('SOURCES.txt')
-        return text and map('"{}"'.format, text.splitlines())
-
-    @property
-    def requires(self):
-        """Generated requirements specified for this Distribution"""
-        reqs = self._read_dist_info_reqs() or self._read_egg_info_reqs()
-        return reqs and list(reqs)
-
-    def _read_dist_info_reqs(self):
-        return self.metadata.get_all('Requires-Dist')
-
-    def _read_egg_info_reqs(self):
-        source = self.read_text('requires.txt')
-        return pass_none(self._deps_from_requires_text)(source)
-
-    @classmethod
-    def _deps_from_requires_text(cls, source):
-        return cls._convert_egg_info_reqs_to_simple_reqs(Sectioned.read(source))
-
-    @staticmethod
-    def _convert_egg_info_reqs_to_simple_reqs(sections):
-        """
-        Historically, setuptools would solicit and store 'extra'
-        requirements, including those with environment markers,
-        in separate sections. More modern tools expect each
-        dependency to be defined separately, with any relevant
-        extras and environment markers attached directly to that
-        requirement. This method converts the former to the
-        latter. See _test_deps_from_requires_text for an example.
-        """
-
-        def make_condition(name):
-            return name and f'extra == "{name}"'
-
-        def quoted_marker(section):
-            section = section or ''
-            extra, sep, markers = section.partition(':')
-            if extra and markers:
-                markers = f'({markers})'
-            conditions = list(filter(None, [markers, make_condition(extra)]))
-            return '; ' + ' and '.join(conditions) if conditions else ''
-
-        def url_req_space(req):
-            """
-            PEP 508 requires a space between the url_spec and the quoted_marker.
-            Ref python/importlib_metadata#357.
-            """
-            # '@' is uniquely indicative of a url_req.
-            return ' ' * ('@' in req)
-
-        for section in sections:
-            space = url_req_space(section.value)
-            yield section.value + space + quoted_marker(section.name)
-
-
-class DistributionFinder(MetaPathFinder):
-    """
-    A MetaPathFinder capable of discovering installed distributions.
-    """
-
-    class Context:
-        """
-        Keyword arguments presented by the caller to
-        ``distributions()`` or ``Distribution.discover()``
-        to narrow the scope of a search for distributions
-        in all DistributionFinders.
-
-        Each DistributionFinder may expect any parameters
-        and should attempt to honor the canonical
-        parameters defined below when appropriate.
-        """
-
-        name = None
-        """
-        Specific name for which a distribution finder should match.
-        A name of ``None`` matches all distributions.
-        """
-
-        def __init__(self, **kwargs):
-            vars(self).update(kwargs)
-
-        @property
-        def path(self):
-            """
-            The sequence of directory path that a distribution finder
-            should search.
-
-            Typically refers to Python installed package paths such as
-            "site-packages" directories and defaults to ``sys.path``.
-            """
-            return vars(self).get('path', sys.path)
-
-    @abc.abstractmethod
-    def find_distributions(self, context=Context()):
-        """
-        Find distributions.
-
-        Return an iterable of all Distribution instances capable of
-        loading the metadata for packages matching the ``context``,
-        a DistributionFinder.Context instance.
-        """
-
-
-class FastPath:
-    """
-    Micro-optimized class for searching a path for
-    children.
-
-    >>> FastPath('').children()
-    ['...']
-    """
-
-    @functools.lru_cache()  # type: ignore
-    def __new__(cls, root):
-        return super().__new__(cls)
-
-    def __init__(self, root):
-        self.root = root
-
-    def joinpath(self, child):
-        return pathlib.Path(self.root, child)
-
-    def children(self):
-        with suppress(Exception):
-            return os.listdir(self.root or '.')
-        with suppress(Exception):
-            return self.zip_children()
-        return []
-
-    def zip_children(self):
-        zip_path = zipp.Path(self.root)
-        names = zip_path.root.namelist()
-        self.joinpath = zip_path.joinpath
-
-        return dict.fromkeys(child.split(posixpath.sep, 1)[0] for child in names)
-
-    def search(self, name):
-        return self.lookup(self.mtime).search(name)
-
-    @property
-    def mtime(self):
-        with suppress(OSError):
-            return os.stat(self.root).st_mtime
-        self.lookup.cache_clear()
-
-    @method_cache
-    def lookup(self, mtime):
-        return Lookup(self)
-
-
-class Lookup:
-    def __init__(self, path: FastPath):
-        base = os.path.basename(path.root).lower()
-        base_is_egg = base.endswith(".egg")
-        self.infos = FreezableDefaultDict(list)
-        self.eggs = FreezableDefaultDict(list)
-
-        for child in path.children():
-            low = child.lower()
-            if low.endswith((".dist-info", ".egg-info")):
-                # rpartition is faster than splitext and suitable for this purpose.
-                name = low.rpartition(".")[0].partition("-")[0]
-                normalized = Prepared.normalize(name)
-                self.infos[normalized].append(path.joinpath(child))
-            elif base_is_egg and low == "egg-info":
-                name = base.rpartition(".")[0].partition("-")[0]
-                legacy_normalized = Prepared.legacy_normalize(name)
-                self.eggs[legacy_normalized].append(path.joinpath(child))
-
-        self.infos.freeze()
-        self.eggs.freeze()
-
-    def search(self, prepared):
-        infos = (
-            self.infos[prepared.normalized]
-            if prepared
-            else itertools.chain.from_iterable(self.infos.values())
-        )
-        eggs = (
-            self.eggs[prepared.legacy_normalized]
-            if prepared
-            else itertools.chain.from_iterable(self.eggs.values())
-        )
-        return itertools.chain(infos, eggs)
-
-
-class Prepared:
-    """
-    A prepared search for metadata on a possibly-named package.
-    """
-
-    normalized = None
-    legacy_normalized = None
-
-    def __init__(self, name):
-        self.name = name
-        if name is None:
-            return
-        self.normalized = self.normalize(name)
-        self.legacy_normalized = self.legacy_normalize(name)
-
-    @staticmethod
-    def normalize(name):
-        """
-        PEP 503 normalization plus dashes as underscores.
-        """
-        return re.sub(r"[-_.]+", "-", name).lower().replace('-', '_')
-
-    @staticmethod
-    def legacy_normalize(name):
-        """
-        Normalize the package name as found in the convention in
-        older packaging tools versions and specs.
-        """
-        return name.lower().replace('-', '_')
-
-    def __bool__(self):
-        return bool(self.name)
-
-
-@install
-class MetadataPathFinder(NullFinder, DistributionFinder):
-    """A degenerate finder for distribution packages on the file system.
-
-    This finder supplies only a find_distributions() method for versions
-    of Python that do not have a PathFinder find_distributions().
-    """
-
-    def find_distributions(self, context=DistributionFinder.Context()):
-        """
-        Find distributions.
-
-        Return an iterable of all Distribution instances capable of
-        loading the metadata for packages matching ``context.name``
-        (or all names if ``None`` indicated) along the paths in the list
-        of directories ``context.path``.
-        """
-        found = self._search_paths(context.name, context.path)
-        return map(PathDistribution, found)
-
-    @classmethod
-    def _search_paths(cls, name, paths):
-        """Find metadata directories in paths heuristically."""
-        prepared = Prepared(name)
-        return itertools.chain.from_iterable(
-            path.search(prepared) for path in map(FastPath, paths)
-        )
-
-    def invalidate_caches(cls):
-        FastPath.__new__.cache_clear()
-
-
-class PathDistribution(Distribution):
-    def __init__(self, path: SimplePath):
-        """Construct a distribution.
-
-        :param path: SimplePath indicating the metadata directory.
-        """
-        self._path = path
-
-    def read_text(self, filename):
-        with suppress(
-            FileNotFoundError,
-            IsADirectoryError,
-            KeyError,
-            NotADirectoryError,
-            PermissionError,
-        ):
-            return self._path.joinpath(filename).read_text(encoding='utf-8')
-
-    read_text.__doc__ = Distribution.read_text.__doc__
-
-    def locate_file(self, path):
-        return self._path.parent / path
-
-    @property
-    def _normalized_name(self):
-        """
-        Performance optimization: where possible, resolve the
-        normalized name from the file system path.
-        """
-        stem = os.path.basename(str(self._path))
-        return (
-            pass_none(Prepared.normalize)(self._name_from_stem(stem))
-            or super()._normalized_name
-        )
-
-    @staticmethod
-    def _name_from_stem(stem):
-        """
-        >>> PathDistribution._name_from_stem('foo-3.0.egg-info')
-        'foo'
-        >>> PathDistribution._name_from_stem('CherryPy-3.0.dist-info')
-        'CherryPy'
-        >>> PathDistribution._name_from_stem('face.egg-info')
-        'face'
-        >>> PathDistribution._name_from_stem('foo.bar')
-        """
-        filename, ext = os.path.splitext(stem)
-        if ext not in ('.dist-info', '.egg-info'):
-            return
-        name, sep, rest = filename.partition('-')
-        return name
-
-
-def distribution(distribution_name):
-    """Get the ``Distribution`` instance for the named package.
-
-    :param distribution_name: The name of the distribution package as a string.
-    :return: A ``Distribution`` instance (or subclass thereof).
-    """
-    return Distribution.from_name(distribution_name)
-
-
-def distributions(**kwargs):
-    """Get all ``Distribution`` instances in the current environment.
-
-    :return: An iterable of ``Distribution`` instances.
-    """
-    return Distribution.discover(**kwargs)
-
-
-def metadata(distribution_name) -> _meta.PackageMetadata:
-    """Get the metadata for the named package.
-
-    :param distribution_name: The name of the distribution package to query.
-    :return: A PackageMetadata containing the parsed metadata.
-    """
-    return Distribution.from_name(distribution_name).metadata
-
-
-def version(distribution_name):
-    """Get the version string for the named package.
-
-    :param distribution_name: The name of the distribution package to query.
-    :return: The version string for the package as defined in the package's
-        "Version" metadata key.
-    """
-    return distribution(distribution_name).version
-
-
-_unique = functools.partial(
-    unique_everseen,
-    key=_py39compat.normalized_name,
-)
-"""
-Wrapper for ``distributions`` to return unique distributions by name.
-"""
-
-
-def entry_points(**params) -> EntryPoints:
-    """Return EntryPoint objects for all installed packages.
-
-    Pass selection parameters (group or name) to filter the
-    result to entry points matching those properties (see
-    EntryPoints.select()).
-
-    :return: EntryPoints for all installed packages.
-    """
-    eps = itertools.chain.from_iterable(
-        dist.entry_points for dist in _unique(distributions())
-    )
-    return EntryPoints(eps).select(**params)
-
-
-def files(distribution_name):
-    """Return a list of files for the named package.
-
-    :param distribution_name: The name of the distribution package to query.
-    :return: List of files composing the distribution.
-    """
-    return distribution(distribution_name).files
-
-
-def requires(distribution_name):
-    """
-    Return a list of requirements for the named package.
-
-    :return: An iterator of requirements, suitable for
-        packaging.requirement.Requirement.
-    """
-    return distribution(distribution_name).requires
-
-
-def packages_distributions() -> Mapping[str, List[str]]:
-    """
-    Return a mapping of top-level packages to their
-    distributions.
-
-    >>> import collections.abc
-    >>> pkgs = packages_distributions()
-    >>> all(isinstance(dist, collections.abc.Sequence) for dist in pkgs.values())
-    True
-    """
-    pkg_to_dist = collections.defaultdict(list)
-    for dist in distributions():
-        for pkg in _top_level_declared(dist) or _top_level_inferred(dist):
-            pkg_to_dist[pkg].append(dist.metadata['Name'])
-    return dict(pkg_to_dist)
-
-
-def _top_level_declared(dist):
-    return (dist.read_text('top_level.txt') or '').split()
-
-
-def _top_level_inferred(dist):
-    return {
-        f.parts[0] if len(f.parts) > 1 else f.with_suffix('').name
-        for f in always_iterable(dist.files)
-        if f.suffix == ".py"
-    }
diff --git a/lib/importlib_metadata/_adapters.py b/lib/importlib_metadata/_adapters.py
deleted file mode 100644
index e33cba5e..00000000
--- a/lib/importlib_metadata/_adapters.py
+++ /dev/null
@@ -1,90 +0,0 @@
-import functools
-import warnings
-import re
-import textwrap
-import email.message
-
-from ._text import FoldedCase
-from ._compat import pypy_partial
-
-
-# Do not remove prior to 2024-01-01 or Python 3.14
-_warn = functools.partial(
-    warnings.warn,
-    "Implicit None on return values is deprecated and will raise KeyErrors.",
-    DeprecationWarning,
-    stacklevel=pypy_partial(2),
-)
-
-
-class Message(email.message.Message):
-    multiple_use_keys = set(
-        map(
-            FoldedCase,
-            [
-                'Classifier',
-                'Obsoletes-Dist',
-                'Platform',
-                'Project-URL',
-                'Provides-Dist',
-                'Provides-Extra',
-                'Requires-Dist',
-                'Requires-External',
-                'Supported-Platform',
-                'Dynamic',
-            ],
-        )
-    )
-    """
-    Keys that may be indicated multiple times per PEP 566.
-    """
-
-    def __new__(cls, orig: email.message.Message):
-        res = super().__new__(cls)
-        vars(res).update(vars(orig))
-        return res
-
-    def __init__(self, *args, **kwargs):
-        self._headers = self._repair_headers()
-
-    # suppress spurious error from mypy
-    def __iter__(self):
-        return super().__iter__()
-
-    def __getitem__(self, item):
-        """
-        Warn users that a ``KeyError`` can be expected when a
-        mising key is supplied. Ref python/importlib_metadata#371.
-        """
-        res = super().__getitem__(item)
-        if res is None:
-            _warn()
-        return res
-
-    def _repair_headers(self):
-        def redent(value):
-            "Correct for RFC822 indentation"
-            if not value or '\n' not in value:
-                return value
-            return textwrap.dedent(' ' * 8 + value)
-
-        headers = [(key, redent(value)) for key, value in vars(self)['_headers']]
-        if self._payload:
-            headers.append(('Description', self.get_payload()))
-        return headers
-
-    @property
-    def json(self):
-        """
-        Convert PackageMetadata to a JSON-compatible format
-        per PEP 0566.
-        """
-
-        def transform(key):
-            value = self.get_all(key) if key in self.multiple_use_keys else self[key]
-            if key == 'Keywords':
-                value = re.split(r'\s+', value)
-            tk = key.lower().replace('-', '_')
-            return tk, value
-
-        return dict(map(transform, map(FoldedCase, self)))
diff --git a/lib/importlib_metadata/_collections.py b/lib/importlib_metadata/_collections.py
deleted file mode 100644
index cf0954e1..00000000
--- a/lib/importlib_metadata/_collections.py
+++ /dev/null
@@ -1,30 +0,0 @@
-import collections
-
-
-# from jaraco.collections 3.3
-class FreezableDefaultDict(collections.defaultdict):
-    """
-    Often it is desirable to prevent the mutation of
-    a default dict after its initial construction, such
-    as to prevent mutation during iteration.
-
-    >>> dd = FreezableDefaultDict(list)
-    >>> dd[0].append('1')
-    >>> dd.freeze()
-    >>> dd[1]
-    []
-    >>> len(dd)
-    1
-    """
-
-    def __missing__(self, key):
-        return getattr(self, '_frozen', super().__missing__)(key)
-
-    def freeze(self):
-        self._frozen = lambda key: self.default_factory()
-
-
-class Pair(collections.namedtuple('Pair', 'name value')):
-    @classmethod
-    def parse(cls, text):
-        return cls(*map(str.strip, text.split("=", 1)))
diff --git a/lib/importlib_metadata/_compat.py b/lib/importlib_metadata/_compat.py
deleted file mode 100644
index 3d78566e..00000000
--- a/lib/importlib_metadata/_compat.py
+++ /dev/null
@@ -1,72 +0,0 @@
-import sys
-import platform
-
-
-__all__ = ['install', 'NullFinder', 'Protocol']
-
-
-try:
-    from typing import Protocol
-except ImportError:  # pragma: no cover
-    # Python 3.7 compatibility
-    from typing_extensions import Protocol  # type: ignore
-
-
-def install(cls):
-    """
-    Class decorator for installation on sys.meta_path.
-
-    Adds the backport DistributionFinder to sys.meta_path and
-    attempts to disable the finder functionality of the stdlib
-    DistributionFinder.
-    """
-    sys.meta_path.append(cls())
-    disable_stdlib_finder()
-    return cls
-
-
-def disable_stdlib_finder():
-    """
-    Give the backport primacy for discovering path-based distributions
-    by monkey-patching the stdlib O_O.
-
-    See #91 for more background for rationale on this sketchy
-    behavior.
-    """
-
-    def matches(finder):
-        return getattr(
-            finder, '__module__', None
-        ) == '_frozen_importlib_external' and hasattr(finder, 'find_distributions')
-
-    for finder in filter(matches, sys.meta_path):  # pragma: nocover
-        del finder.find_distributions
-
-
-class NullFinder:
-    """
-    A "Finder" (aka "MetaClassFinder") that never finds any modules,
-    but may find distributions.
-    """
-
-    @staticmethod
-    def find_spec(*args, **kwargs):
-        return None
-
-    # In Python 2, the import system requires finders
-    # to have a find_module() method, but this usage
-    # is deprecated in Python 3 in favor of find_spec().
-    # For the purposes of this finder (i.e. being present
-    # on sys.meta_path but having no other import
-    # system functionality), the two methods are identical.
-    find_module = find_spec
-
-
-def pypy_partial(val):
-    """
-    Adjust for variable stacklevel on partial under PyPy.
-
-    Workaround for #327.
-    """
-    is_pypy = platform.python_implementation() == 'PyPy'
-    return val + is_pypy
diff --git a/lib/importlib_metadata/_functools.py b/lib/importlib_metadata/_functools.py
deleted file mode 100644
index 71f66bd0..00000000
--- a/lib/importlib_metadata/_functools.py
+++ /dev/null
@@ -1,104 +0,0 @@
-import types
-import functools
-
-
-# from jaraco.functools 3.3
-def method_cache(method, cache_wrapper=None):
-    """
-    Wrap lru_cache to support storing the cache data in the object instances.
-
-    Abstracts the common paradigm where the method explicitly saves an
-    underscore-prefixed protected property on first call and returns that
-    subsequently.
-
-    >>> class MyClass:
-    ...     calls = 0
-    ...
-    ...     @method_cache
-    ...     def method(self, value):
-    ...         self.calls += 1
-    ...         return value
-
-    >>> a = MyClass()
-    >>> a.method(3)
-    3
-    >>> for x in range(75):
-    ...     res = a.method(x)
-    >>> a.calls
-    75
-
-    Note that the apparent behavior will be exactly like that of lru_cache
-    except that the cache is stored on each instance, so values in one
-    instance will not flush values from another, and when an instance is
-    deleted, so are the cached values for that instance.
-
-    >>> b = MyClass()
-    >>> for x in range(35):
-    ...     res = b.method(x)
-    >>> b.calls
-    35
-    >>> a.method(0)
-    0
-    >>> a.calls
-    75
-
-    Note that if method had been decorated with ``functools.lru_cache()``,
-    a.calls would have been 76 (due to the cached value of 0 having been
-    flushed by the 'b' instance).
-
-    Clear the cache with ``.cache_clear()``
-
-    >>> a.method.cache_clear()
-
-    Same for a method that hasn't yet been called.
-
-    >>> c = MyClass()
-    >>> c.method.cache_clear()
-
-    Another cache wrapper may be supplied:
-
-    >>> cache = functools.lru_cache(maxsize=2)
-    >>> MyClass.method2 = method_cache(lambda self: 3, cache_wrapper=cache)
-    >>> a = MyClass()
-    >>> a.method2()
-    3
-
-    Caution - do not subsequently wrap the method with another decorator, such
-    as ``@property``, which changes the semantics of the function.
-
-    See also
-    http://code.activestate.com/recipes/577452-a-memoize-decorator-for-instance-methods/
-    for another implementation and additional justification.
-    """
-    cache_wrapper = cache_wrapper or functools.lru_cache()
-
-    def wrapper(self, *args, **kwargs):
-        # it's the first call, replace the method with a cached, bound method
-        bound_method = types.MethodType(method, self)
-        cached_method = cache_wrapper(bound_method)
-        setattr(self, method.__name__, cached_method)
-        return cached_method(*args, **kwargs)
-
-    # Support cache clear even before cache has been created.
-    wrapper.cache_clear = lambda: None
-
-    return wrapper
-
-
-# From jaraco.functools 3.3
-def pass_none(func):
-    """
-    Wrap func so it's not called if its first param is None
-
-    >>> print_text = pass_none(print)
-    >>> print_text('text')
-    text
-    >>> print_text(None)
-    """
-
-    @functools.wraps(func)
-    def wrapper(param, *args, **kwargs):
-        if param is not None:
-            return func(param, *args, **kwargs)
-
-    return wrapper
diff --git a/lib/importlib_metadata/_itertools.py b/lib/importlib_metadata/_itertools.py
deleted file mode 100644
index d4ca9b91..00000000
--- a/lib/importlib_metadata/_itertools.py
+++ /dev/null
@@ -1,73 +0,0 @@
-from itertools import filterfalse
-
-
-def unique_everseen(iterable, key=None):
-    "List unique elements, preserving order. Remember all elements ever seen."
-    # unique_everseen('AAAABBBCCDAABBB') --> A B C D
-    # unique_everseen('ABBCcAD', str.lower) --> A B C D
-    seen = set()
-    seen_add = seen.add
-    if key is None:
-        for element in filterfalse(seen.__contains__, iterable):
-            seen_add(element)
-            yield element
-    else:
-        for element in iterable:
-            k = key(element)
-            if k not in seen:
-                seen_add(k)
-                yield element
-
-
-# copied from more_itertools 8.8
-def always_iterable(obj, base_type=(str, bytes)):
-    """If *obj* is iterable, return an iterator over its items::
-
-        >>> obj = (1, 2, 3)
-        >>> list(always_iterable(obj))
-        [1, 2, 3]
-
-    If *obj* is not iterable, return a one-item iterable containing *obj*::
-
-        >>> obj = 1
-        >>> list(always_iterable(obj))
-        [1]
-
-    If *obj* is ``None``, return an empty iterable:
-
-        >>> obj = None
-        >>> list(always_iterable(None))
-        []
-
-    By default, binary and text strings are not considered iterable::
-
-        >>> obj = 'foo'
-        >>> list(always_iterable(obj))
-        ['foo']
-
-    If *base_type* is set, objects for which ``isinstance(obj, base_type)``
-    returns ``True`` won't be considered iterable.
-
-        >>> obj = {'a': 1}
-        >>> list(always_iterable(obj))  # Iterate over the dict's keys
-        ['a']
-        >>> list(always_iterable(obj, base_type=dict))  # Treat dicts as a unit
-        [{'a': 1}]
-
-    Set *base_type* to ``None`` to avoid any special handling and treat objects
-    Python considers iterable as iterable:
-
-        >>> obj = 'foo'
-        >>> list(always_iterable(obj, base_type=None))
-        ['f', 'o', 'o']
-    """
-    if obj is None:
-        return iter(())
-
-    if (base_type is not None) and isinstance(obj, base_type):
-        return iter((obj,))
-
-    try:
-        return iter(obj)
-    except TypeError:
-        return iter((obj,))
diff --git a/lib/importlib_metadata/_meta.py b/lib/importlib_metadata/_meta.py
deleted file mode 100644
index 259b15ba..00000000
--- a/lib/importlib_metadata/_meta.py
+++ /dev/null
@@ -1,49 +0,0 @@
-from ._compat import Protocol
-from typing import Any, Dict, Iterator, List, TypeVar, Union
-
-
-_T = TypeVar("_T")
-
-
-class PackageMetadata(Protocol):
-    def __len__(self) -> int:
-        ...  # pragma: no cover
-
-    def __contains__(self, item: str) -> bool:
-        ...  # pragma: no cover
-
-    def __getitem__(self, key: str) -> str:
-        ...  # pragma: no cover
-
-    def __iter__(self) -> Iterator[str]:
-        ...  # pragma: no cover
-
-    def get_all(self, name: str, failobj: _T = ...) -> Union[List[Any], _T]:
-        """
-        Return all values associated with a possibly multi-valued key.
-        """
-
-    @property
-    def json(self) -> Dict[str, Union[str, List[str]]]:
-        """
-        A JSON-compatible form of the metadata.
-        """
-
-
-class SimplePath(Protocol[_T]):
-    """
-    A minimal subset of pathlib.Path required by PathDistribution.
-    """
-
-    def joinpath(self) -> _T:
-        ...  # pragma: no cover
-
-    def __truediv__(self, other: Union[str, _T]) -> _T:
-        ...  # pragma: no cover
-
-    @property
-    def parent(self) -> _T:
-        ...  # pragma: no cover
-
-    def read_text(self) -> str:
-        ...  # pragma: no cover
diff --git a/lib/importlib_metadata/_py39compat.py b/lib/importlib_metadata/_py39compat.py
deleted file mode 100644
index cde4558f..00000000
--- a/lib/importlib_metadata/_py39compat.py
+++ /dev/null
@@ -1,35 +0,0 @@
-"""
-Compatibility layer with Python 3.8/3.9
-"""
-from typing import TYPE_CHECKING, Any, Optional
-
-if TYPE_CHECKING:  # pragma: no cover
-    # Prevent circular imports on runtime.
-    from . import Distribution, EntryPoint
-else:
-    Distribution = EntryPoint = Any
-
-
-def normalized_name(dist: Distribution) -> Optional[str]:
-    """
-    Honor name normalization for distributions that don't provide ``_normalized_name``.
-    """
-    try:
-        return dist._normalized_name
-    except AttributeError:
-        from . import Prepared  # -> delay to prevent circular imports.
-
-        return Prepared.normalize(getattr(dist, "name", None) or dist.metadata['Name'])
-
-
-def ep_matches(ep: EntryPoint, **params) -> bool:
-    """
-    Workaround for ``EntryPoint`` objects without the ``matches`` method.
-    """
-    try:
-        return ep.matches(**params)
-    except AttributeError:
-        from . import EntryPoint  # -> delay to prevent circular imports.
-
-        # Reconstruct the EntryPoint object to make sure it is compatible.
-        return EntryPoint(ep.name, ep.value, ep.group).matches(**params)
diff --git a/lib/importlib_metadata/_text.py b/lib/importlib_metadata/_text.py
deleted file mode 100644
index c88cfbb2..00000000
--- a/lib/importlib_metadata/_text.py
+++ /dev/null
@@ -1,99 +0,0 @@
-import re
-
-from ._functools import method_cache
-
-
-# from jaraco.text 3.5
-class FoldedCase(str):
-    """
-    A case insensitive string class; behaves just like str
-    except compares equal when the only variation is case.
-
-    >>> s = FoldedCase('hello world')
-
-    >>> s == 'Hello World'
-    True
-
-    >>> 'Hello World' == s
-    True
-
-    >>> s != 'Hello World'
-    False
-
-    >>> s.index('O')
-    4
-
-    >>> s.split('O')
-    ['hell', ' w', 'rld']
-
-    >>> sorted(map(FoldedCase, ['GAMMA', 'alpha', 'Beta']))
-    ['alpha', 'Beta', 'GAMMA']
-
-    Sequence membership is straightforward.
-
-    >>> "Hello World" in [s]
-    True
-    >>> s in ["Hello World"]
-    True
-
-    You may test for set inclusion, but candidate and elements
-    must both be folded.
-
-    >>> FoldedCase("Hello World") in {s}
-    True
-    >>> s in {FoldedCase("Hello World")}
-    True
-
-    String inclusion works as long as the FoldedCase object
-    is on the right.
-
-    >>> "hello" in FoldedCase("Hello World")
-    True
-
-    But not if the FoldedCase object is on the left:
-
-    >>> FoldedCase('hello') in 'Hello World'
-    False
-
-    In that case, use in_:
-
-    >>> FoldedCase('hello').in_('Hello World')
-    True
-
-    >>> FoldedCase('hello') > FoldedCase('Hello')
-    False
-    """
-
-    def __lt__(self, other):
-        return self.lower() < other.lower()
-
-    def __gt__(self, other):
-        return self.lower() > other.lower()
-
-    def __eq__(self, other):
-        return self.lower() == other.lower()
-
-    def __ne__(self, other):
-        return self.lower() != other.lower()
-
-    def __hash__(self):
-        return hash(self.lower())
-
-    def __contains__(self, other):
-        return super().lower().__contains__(other.lower())
-
-    def in_(self, other):
-        "Does self appear in other?"
-        return self in FoldedCase(other)
-
-    # cache lower since it's likely to be called frequently.
-    @method_cache
-    def lower(self):
-        return super().lower()
-
-    def index(self, sub):
-        return self.lower().index(sub.lower())
-
-    def split(self, splitter=' ', maxsplit=0):
-        pattern = re.compile(re.escape(splitter), re.I)
-        return pattern.split(self, maxsplit)
diff --git a/lib/importlib_metadata/py.typed b/lib/importlib_metadata/py.typed
deleted file mode 100644
index e69de29b..00000000
diff --git a/lib/importlib_resources/__init__.py b/lib/importlib_resources/__init__.py
deleted file mode 100644
index e6b60c18..00000000
--- a/lib/importlib_resources/__init__.py
+++ /dev/null
@@ -1,17 +0,0 @@
-"""Read resources contained within a package."""
-
-from ._common import (
-    as_file,
-    files,
-    Package,
-)
-
-from .abc import ResourceReader
-
-
-__all__ = [
-    'Package',
-    'ResourceReader',
-    'as_file',
-    'files',
-]
diff --git a/lib/importlib_resources/_adapters.py b/lib/importlib_resources/_adapters.py
deleted file mode 100644
index 50688fbb..00000000
--- a/lib/importlib_resources/_adapters.py
+++ /dev/null
@@ -1,168 +0,0 @@
-from contextlib import suppress
-from io import TextIOWrapper
-
-from . import abc
-
-
-class SpecLoaderAdapter:
-    """
-    Adapt a package spec to adapt the underlying loader.
-    """
-
-    def __init__(self, spec, adapter=lambda spec: spec.loader):
-        self.spec = spec
-        self.loader = adapter(spec)
-
-    def __getattr__(self, name):
-        return getattr(self.spec, name)
-
-
-class TraversableResourcesLoader:
-    """
-    Adapt a loader to provide TraversableResources.
-    """
-
-    def __init__(self, spec):
-        self.spec = spec
-
-    def get_resource_reader(self, name):
-        return CompatibilityFiles(self.spec)._native()
-
-
-def _io_wrapper(file, mode='r', *args, **kwargs):
-    if mode == 'r':
-        return TextIOWrapper(file, *args, **kwargs)
-    elif mode == 'rb':
-        return file
-    raise ValueError(f"Invalid mode value '{mode}', only 'r' and 'rb' are supported")
-
-
-class CompatibilityFiles:
-    """
-    Adapter for an existing or non-existent resource reader
-    to provide a compatibility .files().
-    """
-
-    class SpecPath(abc.Traversable):
-        """
-        Path tied to a module spec.
-        Can be read and exposes the resource reader children.
-        """
-
-        def __init__(self, spec, reader):
-            self._spec = spec
-            self._reader = reader
-
-        def iterdir(self):
-            if not self._reader:
-                return iter(())
-            return iter(
-                CompatibilityFiles.ChildPath(self._reader, path)
-                for path in self._reader.contents()
-            )
-
-        def is_file(self):
-            return False
-
-        is_dir = is_file
-
-        def joinpath(self, other):
-            if not self._reader:
-                return CompatibilityFiles.OrphanPath(other)
-            return CompatibilityFiles.ChildPath(self._reader, other)
-
-        @property
-        def name(self):
-            return self._spec.name
-
-        def open(self, mode='r', *args, **kwargs):
-            return _io_wrapper(self._reader.open_resource(None), mode, *args, **kwargs)
-
-    class ChildPath(abc.Traversable):
-        """
-        Path tied to a resource reader child.
-        Can be read but doesn't expose any meaningful children.
-        """
-
-        def __init__(self, reader, name):
-            self._reader = reader
-            self._name = name
-
-        def iterdir(self):
-            return iter(())
-
-        def is_file(self):
-            return self._reader.is_resource(self.name)
-
-        def is_dir(self):
-            return not self.is_file()
-
-        def joinpath(self, other):
-            return CompatibilityFiles.OrphanPath(self.name, other)
-
-        @property
-        def name(self):
-            return self._name
-
-        def open(self, mode='r', *args, **kwargs):
-            return _io_wrapper(
-                self._reader.open_resource(self.name), mode, *args, **kwargs
-            )
-
-    class OrphanPath(abc.Traversable):
-        """
-        Orphan path, not tied to a module spec or resource reader.
-        Can't be read and doesn't expose any meaningful children.
-        """
-
-        def __init__(self, *path_parts):
-            if len(path_parts) < 1:
-                raise ValueError('Need at least one path part to construct a path')
-            self._path = path_parts
-
-        def iterdir(self):
-            return iter(())
-
-        def is_file(self):
-            return False
-
-        is_dir = is_file
-
-        def joinpath(self, other):
-            return CompatibilityFiles.OrphanPath(*self._path, other)
-
-        @property
-        def name(self):
-            return self._path[-1]
-
-        def open(self, mode='r', *args, **kwargs):
-            raise FileNotFoundError("Can't open orphan path")
-
-    def __init__(self, spec):
-        self.spec = spec
-
-    @property
-    def _reader(self):
-        with suppress(AttributeError):
-            return self.spec.loader.get_resource_reader(self.spec.name)
-
-    def _native(self):
-        """
-        Return the native reader if it supports files().
-        """
-        reader = self._reader
-        return reader if hasattr(reader, 'files') else self
-
-    def __getattr__(self, attr):
-        return getattr(self._reader, attr)
-
-    def files(self):
-        return CompatibilityFiles.SpecPath(self.spec, self._reader)
-
-
-def wrap_spec(package):
-    """
-    Construct a package spec with traversable compatibility
-    on the spec/loader/reader.
-    """
-    return SpecLoaderAdapter(package.__spec__, TraversableResourcesLoader)
diff --git a/lib/importlib_resources/_common.py b/lib/importlib_resources/_common.py
deleted file mode 100644
index 3c6de1cf..00000000
--- a/lib/importlib_resources/_common.py
+++ /dev/null
@@ -1,207 +0,0 @@
-import os
-import pathlib
-import tempfile
-import functools
-import contextlib
-import types
-import importlib
-import inspect
-import warnings
-import itertools
-
-from typing import Union, Optional, cast
-from .abc import ResourceReader, Traversable
-
-from ._compat import wrap_spec
-
-Package = Union[types.ModuleType, str]
-Anchor = Package
-
-
-def package_to_anchor(func):
-    """
-    Replace 'package' parameter as 'anchor' and warn about the change.
-
-    Other errors should fall through.
-
-    >>> files('a', 'b')
-    Traceback (most recent call last):
-    TypeError: files() takes from 0 to 1 positional arguments but 2 were given
-    """
-    undefined = object()
-
-    @functools.wraps(func)
-    def wrapper(anchor=undefined, package=undefined):
-        if package is not undefined:
-            if anchor is not undefined:
-                return func(anchor, package)
-            warnings.warn(
-                "First parameter to files is renamed to 'anchor'",
-                DeprecationWarning,
-                stacklevel=2,
-            )
-            return func(package)
-        elif anchor is undefined:
-            return func()
-        return func(anchor)
-
-    return wrapper
-
-
-@package_to_anchor
-def files(anchor: Optional[Anchor] = None) -> Traversable:
-    """
-    Get a Traversable resource for an anchor.
-    """
-    return from_package(resolve(anchor))
-
-
-def get_resource_reader(package: types.ModuleType) -> Optional[ResourceReader]:
-    """
-    Return the package's loader if it's a ResourceReader.
-    """
-    # We can't use
-    # a issubclass() check here because apparently abc.'s __subclasscheck__()
-    # hook wants to create a weak reference to the object, but
-    # zipimport.zipimporter does not support weak references, resulting in a
-    # TypeError.  That seems terrible.
-    spec = package.__spec__
-    reader = getattr(spec.loader, 'get_resource_reader', None)  # type: ignore
-    if reader is None:
-        return None
-    return reader(spec.name)  # type: ignore
-
-
-@functools.singledispatch
-def resolve(cand: Optional[Anchor]) -> types.ModuleType:
-    return cast(types.ModuleType, cand)
-
-
-@resolve.register
-def _(cand: str) -> types.ModuleType:
-    return importlib.import_module(cand)
-
-
-@resolve.register
-def _(cand: None) -> types.ModuleType:
-    return resolve(_infer_caller().f_globals['__name__'])
-
-
-def _infer_caller():
-    """
-    Walk the stack and find the frame of the first caller not in this module.
-    """
-
-    def is_this_file(frame_info):
-        return frame_info.filename == __file__
-
-    def is_wrapper(frame_info):
-        return frame_info.function == 'wrapper'
-
-    not_this_file = itertools.filterfalse(is_this_file, inspect.stack())
-    # also exclude 'wrapper' due to singledispatch in the call stack
-    callers = itertools.filterfalse(is_wrapper, not_this_file)
-    return next(callers).frame
-
-
-def from_package(package: types.ModuleType):
-    """
-    Return a Traversable object for the given package.
-
-    """
-    spec = wrap_spec(package)
-    reader = spec.loader.get_resource_reader(spec.name)
-    return reader.files()
-
-
-@contextlib.contextmanager
-def _tempfile(
-    reader,
-    suffix='',
-    # gh-93353: Keep a reference to call os.remove() in late Python
-    # finalization.
-    *,
-    _os_remove=os.remove,
-):
-    # Not using tempfile.NamedTemporaryFile as it leads to deeper 'try'
-    # blocks due to the need to close the temporary file to work on Windows
-    # properly.
-    fd, raw_path = tempfile.mkstemp(suffix=suffix)
-    try:
-        try:
-            os.write(fd, reader())
-        finally:
-            os.close(fd)
-        del reader
-        yield pathlib.Path(raw_path)
-    finally:
-        try:
-            _os_remove(raw_path)
-        except FileNotFoundError:
-            pass
-
-
-def _temp_file(path):
-    return _tempfile(path.read_bytes, suffix=path.name)
-
-
-def _is_present_dir(path: Traversable) -> bool:
-    """
-    Some Traversables implement ``is_dir()`` to raise an
-    exception (i.e. ``FileNotFoundError``) when the
-    directory doesn't exist. This function wraps that call
-    to always return a boolean and only return True
-    if there's a dir and it exists.
-    """
-    with contextlib.suppress(FileNotFoundError):
-        return path.is_dir()
-    return False
-
-
-@functools.singledispatch
-def as_file(path):
-    """
-    Given a Traversable object, return that object as a
-    path on the local file system in a context manager.
-    """
-    return _temp_dir(path) if _is_present_dir(path) else _temp_file(path)
-
-
-@as_file.register(pathlib.Path)
-@contextlib.contextmanager
-def _(path):
-    """
-    Degenerate behavior for pathlib.Path objects.
-    """
-    yield path
-
-
-@contextlib.contextmanager
-def _temp_path(dir: tempfile.TemporaryDirectory):
-    """
-    Wrap tempfile.TemporyDirectory to return a pathlib object.
-    """
-    with dir as result:
-        yield pathlib.Path(result)
-
-
-@contextlib.contextmanager
-def _temp_dir(path):
-    """
-    Given a traversable dir, recursively replicate the whole tree
-    to the file system in a context manager.
-    """
-    assert path.is_dir()
-    with _temp_path(tempfile.TemporaryDirectory()) as temp_dir:
-        yield _write_contents(temp_dir, path)
-
-
-def _write_contents(target, source):
-    child = target.joinpath(source.name)
-    if source.is_dir():
-        child.mkdir()
-        for item in source.iterdir():
-            _write_contents(child, item)
-    else:
-        child.write_bytes(source.read_bytes())
-    return child
diff --git a/lib/importlib_resources/_compat.py b/lib/importlib_resources/_compat.py
deleted file mode 100644
index a93a8826..00000000
--- a/lib/importlib_resources/_compat.py
+++ /dev/null
@@ -1,109 +0,0 @@
-# flake8: noqa
-
-import abc
-import os
-import sys
-import pathlib
-from contextlib import suppress
-from typing import Union
-
-
-if sys.version_info >= (3, 10):
-    from zipfile import Path as ZipPath  # type: ignore
-else:
-    from zipp import Path as ZipPath  # type: ignore
-
-
-try:
-    from typing import runtime_checkable  # type: ignore
-except ImportError:
-
-    def runtime_checkable(cls):  # type: ignore
-        return cls
-
-
-try:
-    from typing import Protocol  # type: ignore
-except ImportError:
-    Protocol = abc.ABC  # type: ignore
-
-
-class TraversableResourcesLoader:
-    """
-    Adapt loaders to provide TraversableResources and other
-    compatibility.
-
-    Used primarily for Python 3.9 and earlier where the native
-    loaders do not yet implement TraversableResources.
-    """
-
-    def __init__(self, spec):
-        self.spec = spec
-
-    @property
-    def path(self):
-        return self.spec.origin
-
-    def get_resource_reader(self, name):
-        from . import readers, _adapters
-
-        def _zip_reader(spec):
-            with suppress(AttributeError):
-                return readers.ZipReader(spec.loader, spec.name)
-
-        def _namespace_reader(spec):
-            with suppress(AttributeError, ValueError):
-                return readers.NamespaceReader(spec.submodule_search_locations)
-
-        def _available_reader(spec):
-            with suppress(AttributeError):
-                return spec.loader.get_resource_reader(spec.name)
-
-        def _native_reader(spec):
-            reader = _available_reader(spec)
-            return reader if hasattr(reader, 'files') else None
-
-        def _file_reader(spec):
-            try:
-                path = pathlib.Path(self.path)
-            except TypeError:
-                return None
-            if path.exists():
-                return readers.FileReader(self)
-
-        return (
-            # local ZipReader if a zip module
-            _zip_reader(self.spec)
-            or
-            # local NamespaceReader if a namespace module
-            _namespace_reader(self.spec)
-            or
-            # local FileReader
-            _file_reader(self.spec)
-            or
-            # native reader if it supplies 'files'
-            _native_reader(self.spec)
-            or
-            # fallback - adapt the spec ResourceReader to TraversableReader
-            _adapters.CompatibilityFiles(self.spec)
-        )
-
-
-def wrap_spec(package):
-    """
-    Construct a package spec with traversable compatibility
-    on the spec/loader/reader.
-
-    Supersedes _adapters.wrap_spec to use TraversableResourcesLoader
-    from above for older Python compatibility (<3.10).
-    """
-    from . import _adapters
-
-    return _adapters.SpecLoaderAdapter(package.__spec__, TraversableResourcesLoader)
-
-
-if sys.version_info >= (3, 9):
-    StrPath = Union[str, os.PathLike[str]]
-else:
-    # PathLike is only subscriptable at runtime in 3.9+
-    StrPath = Union[str, "os.PathLike[str]"]
diff --git a/lib/importlib_resources/_itertools.py b/lib/importlib_resources/_itertools.py
deleted file mode 100644
index 7b775ef5..00000000
--- a/lib/importlib_resources/_itertools.py
+++ /dev/null
@@ -1,38 +0,0 @@
-# from more_itertools 9.0
-def only(iterable, default=None, too_long=None):
-    """If *iterable* has only one item, return it.
-    If it has zero items, return *default*.
-    If it has more than one item, raise the exception given by *too_long*,
-    which is ``ValueError`` by default.
-    >>> only([], default='missing')
-    'missing'
-    >>> only([1])
-    1
-    >>> only([1, 2])  # doctest: +IGNORE_EXCEPTION_DETAIL
-    Traceback (most recent call last):
-    ...
-    ValueError: Expected exactly one item in iterable, but got 1, 2,
-     and perhaps more.'
-    >>> only([1, 2], too_long=TypeError)  # doctest: +IGNORE_EXCEPTION_DETAIL
-    Traceback (most recent call last):
-    ...
-    TypeError
-    Note that :func:`only` attempts to advance *iterable* twice to ensure there
-    is only one item.  See :func:`spy` or :func:`peekable` to check
-    iterable contents less destructively.
-    """
-    it = iter(iterable)
-    first_value = next(it, default)
-
-    try:
-        second_value = next(it)
-    except StopIteration:
-        pass
-    else:
-        msg = (
-            'Expected exactly one item in iterable, but got {!r}, {!r}, '
-            'and perhaps more.'.format(first_value, second_value)
-        )
-        raise too_long or ValueError(msg)
-
-    return first_value
diff --git a/lib/importlib_resources/abc.py b/lib/importlib_resources/abc.py
deleted file mode 100644
index 23b6aeaf..00000000
--- a/lib/importlib_resources/abc.py
+++ /dev/null
@@ -1,170 +0,0 @@
-import abc
-import io
-import itertools
-import pathlib
-from typing import Any, BinaryIO, Iterable, Iterator, NoReturn, Text, Optional
-
-from ._compat import runtime_checkable, Protocol, StrPath
-
-
-__all__ = ["ResourceReader", "Traversable", "TraversableResources"]
-
-
-class ResourceReader(metaclass=abc.ABCMeta):
-    """Abstract base class for loaders to provide resource reading support."""
-
-    @abc.abstractmethod
-    def open_resource(self, resource: Text) -> BinaryIO:
-        """Return an opened, file-like object for binary reading.
-
-        The 'resource' argument is expected to represent only a file name.
-        If the resource cannot be found, FileNotFoundError is raised.
-        """
-        # This deliberately raises FileNotFoundError instead of
-        # NotImplementedError so that if this method is accidentally called,
-        # it'll still do the right thing.
-        raise FileNotFoundError
-
-    @abc.abstractmethod
-    def resource_path(self, resource: Text) -> Text:
-        """Return the file system path to the specified resource.
-
-        The 'resource' argument is expected to represent only a file name.
-        If the resource does not exist on the file system, raise
-        FileNotFoundError.
-        """
-        # This deliberately raises FileNotFoundError instead of
-        # NotImplementedError so that if this method is accidentally called,
-        # it'll still do the right thing.
-        raise FileNotFoundError
-
-    @abc.abstractmethod
-    def is_resource(self, path: Text) -> bool:
-        """Return True if the named 'path' is a resource.
-
-        Files are resources, directories are not.
-        """
-        raise FileNotFoundError
-
-    @abc.abstractmethod
-    def contents(self) -> Iterable[str]:
-        """Return an iterable of entries in `package`."""
-        raise FileNotFoundError
-
-
-class TraversalError(Exception):
-    pass
-
-
-@runtime_checkable
-class Traversable(Protocol):
-    """
-    An object with a subset of pathlib.Path methods suitable for
-    traversing directories and opening files.
-
-    Any exceptions that occur when accessing the backing resource
-    may propagate unaltered.
-    """
-
-    @abc.abstractmethod
-    def iterdir(self) -> Iterator["Traversable"]:
-        """
-        Yield Traversable objects in self
-        """
-
-    def read_bytes(self) -> bytes:
-        """
-        Read contents of self as bytes
-        """
-        with self.open('rb') as strm:
-            return strm.read()
-
-    def read_text(self, encoding: Optional[str] = None) -> str:
-        """
-        Read contents of self as text
-        """
-        with self.open(encoding=encoding) as strm:
-            return strm.read()
-
-    @abc.abstractmethod
-    def is_dir(self) -> bool:
-        """
-        Return True if self is a directory
-        """
-
-    @abc.abstractmethod
-    def is_file(self) -> bool:
-        """
-        Return True if self is a file
-        """
-
-    def joinpath(self, *descendants: StrPath) -> "Traversable":
-        """
-        Return Traversable resolved with any descendants applied.
-
-        Each descendant should be a path segment relative to self
-        and each may contain multiple levels separated by
-        ``posixpath.sep`` (``/``).
-        """
-        if not descendants:
-            return self
-        names = itertools.chain.from_iterable(
-            path.parts for path in map(pathlib.PurePosixPath, descendants)
-        )
-        target = next(names)
-        matches = (
-            traversable for traversable in self.iterdir() if traversable.name == target
-        )
-        try:
-            match = next(matches)
-        except StopIteration:
-            raise TraversalError(
-                "Target not found during traversal.", target, list(names)
-            )
-        return match.joinpath(*names)
-
-    def __truediv__(self, child: StrPath) -> "Traversable":
-        """
-        Return Traversable child in self
-        """
-        return self.joinpath(child)
-
-    @abc.abstractmethod
-    def open(self, mode='r', *args, **kwargs):
-        """
-        mode may be 'r' or 'rb' to open as text or binary. Return a handle
-        suitable for reading (same as pathlib.Path.open).
-
-        When opening as text, accepts encoding parameters such as those
-        accepted by io.TextIOWrapper.
-        """
-
-    @property
-    @abc.abstractmethod
-    def name(self) -> str:
-        """
-        The base name of this object without any parent references.
-        """
-
-
-class TraversableResources(ResourceReader):
-    """
-    The required interface for providing traversable
-    resources.
-    """
-
-    @abc.abstractmethod
-    def files(self) -> "Traversable":
-        """Return a Traversable object for the loaded package."""
-
-    def open_resource(self, resource: StrPath) -> io.BufferedReader:
-        return self.files().joinpath(resource).open('rb')
-
-    def resource_path(self, resource: Any) -> NoReturn:
-        raise FileNotFoundError(resource)
-
-    def is_resource(self, path: StrPath) -> bool:
-        return self.files().joinpath(path).is_file()
-
-    def contents(self) -> Iterator[str]:
-        return (item.name for item in self.files().iterdir())
diff --git a/lib/importlib_resources/py.typed b/lib/importlib_resources/py.typed
deleted file mode 100644
index e69de29b..00000000
diff --git a/lib/importlib_resources/readers.py b/lib/importlib_resources/readers.py
deleted file mode 100644
index 51d030a6..00000000
--- a/lib/importlib_resources/readers.py
+++ /dev/null
@@ -1,144 +0,0 @@
-import collections
-import itertools
-import pathlib
-import operator
-
-from . import abc
-
-from ._itertools import only
-from ._compat import ZipPath
-
-
-def remove_duplicates(items):
-    return iter(collections.OrderedDict.fromkeys(items))
-
-
-class FileReader(abc.TraversableResources):
-    def __init__(self, loader):
-        self.path = pathlib.Path(loader.path).parent
-
-    def resource_path(self, resource):
-        """
-        Return the file system path to prevent
-        `resources.path()` from creating a temporary
-        copy.
-        """
-        return str(self.path.joinpath(resource))
-
-    def files(self):
-        return self.path
-
-
-class ZipReader(abc.TraversableResources):
-    def __init__(self, loader, module):
-        _, _, name = module.rpartition('.')
-        self.prefix = loader.prefix.replace('\\', '/') + name + '/'
-        self.archive = loader.archive
-
-    def open_resource(self, resource):
-        try:
-            return super().open_resource(resource)
-        except KeyError as exc:
-            raise FileNotFoundError(exc.args[0])
-
-    def is_resource(self, path):
-        """
-        Workaround for `zipfile.Path.is_file` returning true
-        for non-existent paths.
-        """
-        target = self.files().joinpath(path)
-        return target.is_file() and target.exists()
-
-    def files(self):
-        return ZipPath(self.archive, self.prefix)
-
-
-class MultiplexedPath(abc.Traversable):
-    """
-    Given a series of Traversable objects, implement a merged
-    version of the interface across all objects. Useful for
-    namespace packages which may be multihomed at a single
-    name.
-    """
-
-    def __init__(self, *paths):
-        self._paths = list(map(pathlib.Path, remove_duplicates(paths)))
-        if not self._paths:
-            message = 'MultiplexedPath must contain at least one path'
-            raise FileNotFoundError(message)
-        if not all(path.is_dir() for path in self._paths):
-            raise NotADirectoryError('MultiplexedPath only supports directories')
-
-    def iterdir(self):
-        children = (child for path in self._paths for child in path.iterdir())
-        by_name = operator.attrgetter('name')
-        groups = itertools.groupby(sorted(children, key=by_name), key=by_name)
-        return map(self._follow, (locs for name, locs in groups))
-
-    def read_bytes(self):
-        raise FileNotFoundError(f'{self} is not a file')
-
-    def read_text(self, *args, **kwargs):
-        raise FileNotFoundError(f'{self} is not a file')
-
-    def is_dir(self):
-        return True
-
-    def is_file(self):
-        return False
-
-    def joinpath(self, *descendants):
-        try:
-            return super().joinpath(*descendants)
-        except abc.TraversalError:
-            # One of the paths did not resolve (a directory does not exist).
-            # Just return something that will not exist.
-            return self._paths[0].joinpath(*descendants)
-
-    @classmethod
-    def _follow(cls, children):
-        """
-        Construct a MultiplexedPath if needed.
-
-        If children contains a sole element, return it.
-        Otherwise, return a MultiplexedPath of the items.
-        Unless one of the items is not a Directory, then return the first.
-        """
-        subdirs, one_dir, one_file = itertools.tee(children, 3)
-
-        try:
-            return only(one_dir)
-        except ValueError:
-            try:
-                return cls(*subdirs)
-            except NotADirectoryError:
-                return next(one_file)
-
-    def open(self, *args, **kwargs):
-        raise FileNotFoundError(f'{self} is not a file')
-
-    @property
-    def name(self):
-        return self._paths[0].name
-
-    def __repr__(self):
-        paths = ', '.join(f"'{path}'" for path in self._paths)
-        return f'MultiplexedPath({paths})'
-
-
-class NamespaceReader(abc.TraversableResources):
-    def __init__(self, namespace_path):
-        if 'NamespacePath' not in str(namespace_path):
-            raise ValueError('Invalid path')
-        self.path = MultiplexedPath(*list(namespace_path))
-
-    def resource_path(self, resource):
-        """
-        Return the file system path to prevent
-        `resources.path()` from creating a temporary
-        copy.
-        """
-        return str(self.path.joinpath(resource))
-
-    def files(self):
-        return self.path
diff --git a/lib/importlib_resources/simple.py b/lib/importlib_resources/simple.py
deleted file mode 100644
index 7770c922..00000000
--- a/lib/importlib_resources/simple.py
+++ /dev/null
@@ -1,106 +0,0 @@
-"""
-Interface adapters for low-level readers.
-"""
-
-import abc
-import io
-import itertools
-from typing import BinaryIO, List
-
-from .abc import Traversable, TraversableResources
-
-
-class SimpleReader(abc.ABC):
-    """
-    The minimum, low-level interface required from a resource
-    provider.
-    """
-
-    @property
-    @abc.abstractmethod
-    def package(self) -> str:
-        """
-        The name of the package for which this reader loads resources.
-        """
-
-    @abc.abstractmethod
-    def children(self) -> List['SimpleReader']:
-        """
-        Obtain an iterable of SimpleReader for available
-        child containers (e.g. directories).
-        """
-
-    @abc.abstractmethod
-    def resources(self) -> List[str]:
-        """
-        Obtain available named resources for this virtual package.
-        """
-
-    @abc.abstractmethod
-    def open_binary(self, resource: str) -> BinaryIO:
-        """
-        Obtain a File-like for a named resource.
-        """
-
-    @property
-    def name(self):
-        return self.package.split('.')[-1]
-
-
-class ResourceContainer(Traversable):
-    """
-    Traversable container for a package's resources via its reader.
-    """
-
-    def __init__(self, reader: SimpleReader):
-        self.reader = reader
-
-    def is_dir(self):
-        return True
-
-    def is_file(self):
-        return False
-
-    def iterdir(self):
-        files = (ResourceHandle(self, name) for name in self.reader.resources)
-        dirs = map(ResourceContainer, self.reader.children())
-        return itertools.chain(files, dirs)
-
-    def open(self, *args, **kwargs):
-        raise IsADirectoryError()
-
-
-class ResourceHandle(Traversable):
-    """
-    Handle to a named resource in a ResourceReader.
-    """
-
-    def __init__(self, parent: ResourceContainer, name: str):
-        self.parent = parent
-        self.name = name  # type: ignore
-
-    def is_file(self):
-        return True
-
-    def is_dir(self):
-        return False
-
-    def open(self, mode='r', *args, **kwargs):
-        stream = self.parent.reader.open_binary(self.name)
-        if 'b' not in mode:
-            stream = io.TextIOWrapper(*args, **kwargs)
-        return stream
-
-    def joinpath(self, name):
-        raise RuntimeError("Cannot traverse into a resource")
-
-
-class TraversableReader(TraversableResources, SimpleReader):
-    """
-    A TraversableResources based on SimpleReader. Resource providers
-    may derive from this class to provide the TraversableResources
-    interface by supplying the SimpleReader interface.
-    """
-
-    def files(self):
-        return ResourceContainer(self)
diff --git a/lib/importlib_resources/tests/__init__.py b/lib/importlib_resources/tests/__init__.py
deleted file mode 100644
index e69de29b..00000000
diff --git a/lib/importlib_resources/tests/_compat.py b/lib/importlib_resources/tests/_compat.py
deleted file mode 100644
index e7bf06dd..00000000
--- a/lib/importlib_resources/tests/_compat.py
+++ /dev/null
@@ -1,32 +0,0 @@
-import os
-
-
-try:
-    from test.support import import_helper  # type: ignore
-except ImportError:
-    # Python 3.9 and earlier
-    class import_helper:  # type: ignore
-        from test.support import (
-            modules_setup,
-            modules_cleanup,
-            DirsOnSysPath,
-            CleanImport,
-        )
-
-
-try:
-    from test.support import os_helper  # type: ignore
-except ImportError:
-    # Python 3.9 compat
-    class os_helper:  # type:ignore
-        from test.support import temp_dir
-
-
-try:
-    # Python 3.10
-    from test.support.os_helper import unlink
-except ImportError:
-    from test.support import unlink as _unlink
-
-    def unlink(target):
-        return _unlink(os.fspath(target))
diff --git a/lib/importlib_resources/tests/_path.py b/lib/importlib_resources/tests/_path.py
deleted file mode 100644
index 1f97c961..00000000
--- a/lib/importlib_resources/tests/_path.py
+++ /dev/null
@@ -1,56 +0,0 @@
-import pathlib
-import functools
-
-from typing import Dict, Union
-
-
-####
-# from jaraco.path 3.4.1
-
-FilesSpec = Dict[str, Union[str, bytes, 'FilesSpec']]  # type: ignore
-
-
-def build(spec: FilesSpec, prefix=pathlib.Path()):
-    """
-    Build a set of files/directories, as described by the spec.
-
-    Each key represents a pathname, and the value represents
-    the content. Content may be a nested directory.
-
-    >>> spec = {
-    ...     'README.txt': "A README file",
-    ...     "foo": {
-    ...         "__init__.py": "",
-    ...         "bar": {
-    ...             "__init__.py": "",
-    ...         },
-    ...         "baz.py": "# Some code",
-    ...     }
-    ... }
-    >>> target = getfixture('tmp_path')
-    >>> build(spec, target)
-    >>> target.joinpath('foo/baz.py').read_text(encoding='utf-8')
-    '# Some code'
-    """
-    for name, contents in spec.items():
-        create(contents, pathlib.Path(prefix) / name)
-
-
-@functools.singledispatch
-def create(content: Union[str, bytes, FilesSpec], path):
-    path.mkdir(exist_ok=True)
-    build(content, prefix=path)  # type: ignore
-
-
-@create.register
-def _(content: bytes, path):
-    path.write_bytes(content)
-
-
-@create.register
-def _(content: str, path):
-    path.write_text(content, encoding='utf-8')
-
-
-# end from jaraco.path
-####
diff --git a/lib/importlib_resources/tests/data01/__init__.py b/lib/importlib_resources/tests/data01/__init__.py
deleted file mode 100644
index e69de29b..00000000
diff --git a/lib/importlib_resources/tests/data01/binary.file b/lib/importlib_resources/tests/data01/binary.file
deleted file mode 100644
index eaf36c1daccfdf325514461cd1a2ffbc139b5464..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 4
LcmZQzWMT#Y01f~L

diff --git a/lib/importlib_resources/tests/data01/subdirectory/__init__.py b/lib/importlib_resources/tests/data01/subdirectory/__init__.py
deleted file mode 100644
index e69de29b..00000000
diff --git a/lib/importlib_resources/tests/data01/subdirectory/binary.file b/lib/importlib_resources/tests/data01/subdirectory/binary.file
deleted file mode 100644
index eaf36c1daccfdf325514461cd1a2ffbc139b5464..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 4
LcmZQzWMT#Y01f~L

diff --git a/lib/importlib_resources/tests/data01/utf-16.file b/lib/importlib_resources/tests/data01/utf-16.file
deleted file mode 100644
index 2cb772295ef4b480a8d83725bd5006a0236d8f68..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 44
ucmezW&x0YAAqNQa8FUyF7(y9B7~B|i84MZBfV^^`Xc15@g+Y;liva-T)Ce>H

diff --git a/lib/importlib_resources/tests/data01/utf-8.file b/lib/importlib_resources/tests/data01/utf-8.file
deleted file mode 100644
index 1c0132ad..00000000
--- a/lib/importlib_resources/tests/data01/utf-8.file
+++ /dev/null
@@ -1 +0,0 @@
-Hello, UTF-8 world!
diff --git a/lib/importlib_resources/tests/data02/__init__.py b/lib/importlib_resources/tests/data02/__init__.py
deleted file mode 100644
index e69de29b..00000000
diff --git a/lib/importlib_resources/tests/data02/one/__init__.py b/lib/importlib_resources/tests/data02/one/__init__.py
deleted file mode 100644
index e69de29b..00000000
diff --git a/lib/importlib_resources/tests/data02/one/resource1.txt b/lib/importlib_resources/tests/data02/one/resource1.txt
deleted file mode 100644
index 61a813e4..00000000
--- a/lib/importlib_resources/tests/data02/one/resource1.txt
+++ /dev/null
@@ -1 +0,0 @@
-one resource
diff --git a/lib/importlib_resources/tests/data02/subdirectory/subsubdir/resource.txt b/lib/importlib_resources/tests/data02/subdirectory/subsubdir/resource.txt
deleted file mode 100644
index 48f587a2..00000000
--- a/lib/importlib_resources/tests/data02/subdirectory/subsubdir/resource.txt
+++ /dev/null
@@ -1 +0,0 @@
-a resource
\ No newline at end of file
diff --git a/lib/importlib_resources/tests/data02/two/__init__.py b/lib/importlib_resources/tests/data02/two/__init__.py
deleted file mode 100644
index e69de29b..00000000
diff --git a/lib/importlib_resources/tests/data02/two/resource2.txt b/lib/importlib_resources/tests/data02/two/resource2.txt
deleted file mode 100644
index a80ce46e..00000000
--- a/lib/importlib_resources/tests/data02/two/resource2.txt
+++ /dev/null
@@ -1 +0,0 @@
-two resource
diff --git a/lib/importlib_resources/tests/namespacedata01/binary.file b/lib/importlib_resources/tests/namespacedata01/binary.file
deleted file mode 100644
index eaf36c1daccfdf325514461cd1a2ffbc139b5464..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 4
LcmZQzWMT#Y01f~L

diff --git a/lib/importlib_resources/tests/namespacedata01/utf-16.file b/lib/importlib_resources/tests/namespacedata01/utf-16.file
deleted file mode 100644
index 2cb772295ef4b480a8d83725bd5006a0236d8f68..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 44
ucmezW&x0YAAqNQa8FUyF7(y9B7~B|i84MZBfV^^`Xc15@g+Y;liva-T)Ce>H

diff --git a/lib/importlib_resources/tests/namespacedata01/utf-8.file b/lib/importlib_resources/tests/namespacedata01/utf-8.file
deleted file mode 100644
index 1c0132ad..00000000
--- a/lib/importlib_resources/tests/namespacedata01/utf-8.file
+++ /dev/null
@@ -1 +0,0 @@
-Hello, UTF-8 world!
diff --git a/lib/importlib_resources/tests/test_compatibilty_files.py b/lib/importlib_resources/tests/test_compatibilty_files.py
deleted file mode 100644
index 13ad0dfb..00000000
--- a/lib/importlib_resources/tests/test_compatibilty_files.py
+++ /dev/null
@@ -1,104 +0,0 @@
-import io
-import unittest
-
-import importlib_resources as resources
-
-from importlib_resources._adapters import (
-    CompatibilityFiles,
-    wrap_spec,
-)
-
-from . import util
-
-
-class CompatibilityFilesTests(unittest.TestCase):
-    @property
-    def package(self):
-        bytes_data = io.BytesIO(b'Hello, world!')
-        return util.create_package(
-            file=bytes_data,
-            path='some_path',
-            contents=('a', 'b', 'c'),
-        )
-
-    @property
-    def files(self):
-        return resources.files(self.package)
-
-    def test_spec_path_iter(self):
-        self.assertEqual(
-            sorted(path.name for path in self.files.iterdir()),
-            ['a', 'b', 'c'],
-        )
-
-    def test_child_path_iter(self):
-        self.assertEqual(list((self.files / 'a').iterdir()), [])
-
-    def test_orphan_path_iter(self):
-        self.assertEqual(list((self.files / 'a' / 'a').iterdir()), [])
-        self.assertEqual(list((self.files / 'a' / 'a' / 'a').iterdir()), [])
-
-    def test_spec_path_is(self):
-        self.assertFalse(self.files.is_file())
-        self.assertFalse(self.files.is_dir())
-
-    def test_child_path_is(self):
-        self.assertTrue((self.files / 'a').is_file())
-        self.assertFalse((self.files / 'a').is_dir())
-
-    def test_orphan_path_is(self):
-        self.assertFalse((self.files / 'a' / 'a').is_file())
-        self.assertFalse((self.files / 'a' / 'a').is_dir())
-        self.assertFalse((self.files / 'a' / 'a' / 'a').is_file())
-        self.assertFalse((self.files / 'a' / 'a' / 'a').is_dir())
-
-    def test_spec_path_name(self):
-        self.assertEqual(self.files.name, 'testingpackage')
-
-    def test_child_path_name(self):
-        self.assertEqual((self.files / 'a').name, 'a')
-
-    def test_orphan_path_name(self):
-        self.assertEqual((self.files / 'a' / 'b').name, 'b')
-        self.assertEqual((self.files / 'a' / 'b' / 'c').name, 'c')
-
-    def test_spec_path_open(self):
-        self.assertEqual(self.files.read_bytes(), b'Hello, world!')
-        self.assertEqual(self.files.read_text(encoding='utf-8'), 'Hello, world!')
-
-    def test_child_path_open(self):
-        self.assertEqual((self.files / 'a').read_bytes(), b'Hello, world!')
-        self.assertEqual(
-            (self.files / 'a').read_text(encoding='utf-8'), 'Hello, world!'
-        )
-
-    def test_orphan_path_open(self):
-        with self.assertRaises(FileNotFoundError):
-            (self.files / 'a' / 'b').read_bytes()
-        with self.assertRaises(FileNotFoundError):
-            (self.files / 'a' / 'b' / 'c').read_bytes()
-
-    def test_open_invalid_mode(self):
-        with self.assertRaises(ValueError):
-            self.files.open('0')
-
-    def test_orphan_path_invalid(self):
-        with self.assertRaises(ValueError):
-            CompatibilityFiles.OrphanPath()
-
-    def test_wrap_spec(self):
-        spec = wrap_spec(self.package)
-        self.assertIsInstance(spec.loader.get_resource_reader(None), CompatibilityFiles)
-
-
-class CompatibilityFilesNoReaderTests(unittest.TestCase):
-    @property
-    def package(self):
-        return util.create_package_from_loader(None)
-
-    @property
-    def files(self):
-        return resources.files(self.package)
-
-    def test_spec_path_joinpath(self):
-        self.assertIsInstance(self.files / 'a', CompatibilityFiles.OrphanPath)
diff --git a/lib/importlib_resources/tests/test_contents.py b/lib/importlib_resources/tests/test_contents.py
deleted file mode 100644
index 525568e8..00000000
--- a/lib/importlib_resources/tests/test_contents.py
+++ /dev/null
@@ -1,43 +0,0 @@
-import unittest
-import importlib_resources as resources
-
-from . import data01
-from . import util
-
-
-class ContentsTests:
-    expected = {
-        '__init__.py',
-        'binary.file',
-        'subdirectory',
-        'utf-16.file',
-        'utf-8.file',
-    }
-
-    def test_contents(self):
-        contents = {path.name for path in resources.files(self.data).iterdir()}
-        assert self.expected <= contents
-
-
-class ContentsDiskTests(ContentsTests, unittest.TestCase):
-    def setUp(self):
-        self.data = data01
-
-
-class ContentsZipTests(ContentsTests, util.ZipSetup, unittest.TestCase):
-    pass
-
-
-class ContentsNamespaceTests(ContentsTests, unittest.TestCase):
-    expected = {
-        # no __init__ because of namespace design
-        # no subdirectory as incidental difference in fixture
-        'binary.file',
-        'utf-16.file',
-        'utf-8.file',
-    }
-
-    def setUp(self):
-        from . import namespacedata01
-
-        self.data = namespacedata01
diff --git a/lib/importlib_resources/tests/test_custom.py b/lib/importlib_resources/tests/test_custom.py
deleted file mode 100644
index e85ddd65..00000000
--- a/lib/importlib_resources/tests/test_custom.py
+++ /dev/null
@@ -1,45 +0,0 @@
-import unittest
-import contextlib
-import pathlib
-
-import importlib_resources as resources
-from ..abc import TraversableResources, ResourceReader
-from . import util
-from ._compat import os_helper
-
-
-class SimpleLoader:
-    """
-    A simple loader that only implements a resource reader.
-    """
-
-    def __init__(self, reader: ResourceReader):
-        self.reader = reader
-
-    def get_resource_reader(self, package):
-        return self.reader
-
-
-class MagicResources(TraversableResources):
-    """
-    Magically returns the resources at path.
-    """
-
-    def __init__(self, path: pathlib.Path):
-        self.path = path
-
-    def files(self):
-        return self.path
-
-
-class CustomTraversableResourcesTests(unittest.TestCase):
-    def setUp(self):
-        self.fixtures = contextlib.ExitStack()
-        self.addCleanup(self.fixtures.close)
-
-    def test_custom_loader(self):
-        temp_dir = self.fixtures.enter_context(os_helper.temp_dir())
-        loader = SimpleLoader(MagicResources(temp_dir))
-        pkg = util.create_package_from_loader(loader)
-        files = resources.files(pkg)
-        assert files is temp_dir
diff --git a/lib/importlib_resources/tests/test_files.py b/lib/importlib_resources/tests/test_files.py
deleted file mode 100644
index 197a063b..00000000
--- a/lib/importlib_resources/tests/test_files.py
+++ /dev/null
@@ -1,112 +0,0 @@
-import typing
-import textwrap
-import unittest
-import warnings
-import importlib
-import contextlib
-
-import importlib_resources as resources
-from ..abc import Traversable
-from . import data01
-from . import util
-from . import _path
-from ._compat import os_helper, import_helper
-
-
-@contextlib.contextmanager
-def suppress_known_deprecation():
-    with warnings.catch_warnings(record=True) as ctx:
-        warnings.simplefilter('default', category=DeprecationWarning)
-        yield ctx
-
-
-class FilesTests:
-    def test_read_bytes(self):
-        files = resources.files(self.data)
-        actual = files.joinpath('utf-8.file').read_bytes()
-        assert actual == b'Hello, UTF-8 world!\n'
-
-    def test_read_text(self):
-        files = resources.files(self.data)
-        actual = files.joinpath('utf-8.file').read_text(encoding='utf-8')
-        assert actual == 'Hello, UTF-8 world!\n'
-
-    @unittest.skipUnless(
-        hasattr(typing, 'runtime_checkable'),
-        "Only suitable when typing supports runtime_checkable",
-    )
-    def test_traversable(self):
-        assert isinstance(resources.files(self.data), Traversable)
-
-    def test_old_parameter(self):
-        """
-        Files used to take a 'package' parameter. Make sure anyone
-        passing by name is still supported.
-        """
-        with suppress_known_deprecation():
-            resources.files(package=self.data)
-
-
-class OpenDiskTests(FilesTests, unittest.TestCase):
-    def setUp(self):
-        self.data = data01
-
-
-class OpenZipTests(FilesTests, util.ZipSetup, unittest.TestCase):
-    pass
-
-
-class OpenNamespaceTests(FilesTests, unittest.TestCase):
-    def setUp(self):
-        from . import namespacedata01
-
-        self.data = namespacedata01
-
-
-class SiteDir:
-    def setUp(self):
-        self.fixtures = contextlib.ExitStack()
-        self.addCleanup(self.fixtures.close)
-        self.site_dir = self.fixtures.enter_context(os_helper.temp_dir())
-        self.fixtures.enter_context(import_helper.DirsOnSysPath(self.site_dir))
-        self.fixtures.enter_context(import_helper.CleanImport())
-
-
-class ModulesFilesTests(SiteDir, unittest.TestCase):
-    def test_module_resources(self):
-        """
-        A module can have resources found adjacent to the module.
-        """
-        spec = {
-            'mod.py': '',
-            'res.txt': 'resources are the best',
-        }
-        _path.build(spec, self.site_dir)
-        import mod
-
-        actual = resources.files(mod).joinpath('res.txt').read_text(encoding='utf-8')
-        assert actual == spec['res.txt']
-
-
-class ImplicitContextFilesTests(SiteDir, unittest.TestCase):
-    def test_implicit_files(self):
-        """
-        Without any parameter, files() will infer the location as the caller.
-        """
-        spec = {
-            'somepkg': {
-                '__init__.py': textwrap.dedent(
-                    """
-                    import importlib_resources as res
-                    val = res.files().joinpath('res.txt').read_text(encoding='utf-8')
-                    """
-                ),
-                'res.txt': 'resources are the best',
-            },
-        }
-        _path.build(spec, self.site_dir)
-        assert importlib.import_module('somepkg').val == 'resources are the best'
-
-
-if __name__ == '__main__':
-    unittest.main()
diff --git a/lib/importlib_resources/tests/test_open.py b/lib/importlib_resources/tests/test_open.py
deleted file mode 100644
index 83b737dc..00000000
--- a/lib/importlib_resources/tests/test_open.py
+++ /dev/null
@@ -1,85 +0,0 @@
-import unittest
-
-import importlib_resources as resources
-from . import data01
-from . import util
-
-
-class CommonBinaryTests(util.CommonTests, unittest.TestCase):
-    def execute(self, package, path):
-        target = resources.files(package).joinpath(path)
-        with target.open('rb'):
-            pass
-
-
-class CommonTextTests(util.CommonTests, unittest.TestCase):
-    def execute(self, package, path):
-        target = resources.files(package).joinpath(path)
-        with target.open(encoding='utf-8'):
-            pass
-
-
-class OpenTests:
-    def test_open_binary(self):
-        target = resources.files(self.data) / 'binary.file'
-        with target.open('rb') as fp:
-            result = fp.read()
-            self.assertEqual(result, b'\x00\x01\x02\x03')
-
-    def test_open_text_default_encoding(self):
-        target = resources.files(self.data) / 'utf-8.file'
-        with target.open(encoding='utf-8') as fp:
-            result = fp.read()
-            self.assertEqual(result, 'Hello, UTF-8 world!\n')
-
-    def test_open_text_given_encoding(self):
-        target = resources.files(self.data) / 'utf-16.file'
-        with target.open(encoding='utf-16', errors='strict') as fp:
-            result = fp.read()
-        self.assertEqual(result, 'Hello, UTF-16 world!\n')
-
-    def test_open_text_with_errors(self):
-        """
-        Raises UnicodeError without the 'errors' argument.
-        """
-        target = resources.files(self.data) / 'utf-16.file'
-        with target.open(encoding='utf-8', errors='strict') as fp:
-            self.assertRaises(UnicodeError, fp.read)
-        with target.open(encoding='utf-8', errors='ignore') as fp:
-            result = fp.read()
-        self.assertEqual(
-            result,
-            'H\x00e\x00l\x00l\x00o\x00,\x00 '
-            '\x00U\x00T\x00F\x00-\x001\x006\x00 '
-            '\x00w\x00o\x00r\x00l\x00d\x00!\x00\n\x00',
-        )
-
-    def test_open_binary_FileNotFoundError(self):
-        target = resources.files(self.data) / 'does-not-exist'
-        with self.assertRaises(FileNotFoundError):
-            target.open('rb')
-
-    def test_open_text_FileNotFoundError(self):
-        target = resources.files(self.data) / 'does-not-exist'
-        with self.assertRaises(FileNotFoundError):
-            target.open(encoding='utf-8')
-
-
-class OpenDiskTests(OpenTests, unittest.TestCase):
-    def setUp(self):
-        self.data = data01
-
-
-class OpenDiskNamespaceTests(OpenTests, unittest.TestCase):
-    def setUp(self):
-        from . import namespacedata01
-
-        self.data = namespacedata01
-
-
-class OpenZipTests(OpenTests, util.ZipSetup, unittest.TestCase):
-    pass
-
-
-if __name__ == '__main__':
-    unittest.main()
diff --git a/lib/importlib_resources/tests/test_path.py b/lib/importlib_resources/tests/test_path.py
deleted file mode 100644
index 7cb20003..00000000
--- a/lib/importlib_resources/tests/test_path.py
+++ /dev/null
@@ -1,69 +0,0 @@
-import io
-import unittest
-
-import importlib_resources as resources
-from . import data01
-from . import util
-
-
-class CommonTests(util.CommonTests, unittest.TestCase):
-    def execute(self, package, path):
-        with resources.as_file(resources.files(package).joinpath(path)):
-            pass
-
-
-class PathTests:
-    def test_reading(self):
-        """
-        Path should be readable.
-
-        Test also implicitly verifies the returned object is a pathlib.Path
-        instance.
-        """
-        target = resources.files(self.data) / 'utf-8.file'
-        with resources.as_file(target) as path:
-            self.assertTrue(path.name.endswith("utf-8.file"), repr(path))
-            # pathlib.Path.read_text() was introduced in Python 3.5.
-            with path.open('r', encoding='utf-8') as file:
-                text = file.read()
-            self.assertEqual('Hello, UTF-8 world!\n', text)
-
-
-class PathDiskTests(PathTests, unittest.TestCase):
-    data = data01
-
-    def test_natural_path(self):
-        """
-        Guarantee the internal implementation detail that
-        file-system-backed resources do not get the tempdir
-        treatment.
-        """
-        target = resources.files(self.data) / 'utf-8.file'
-        with resources.as_file(target) as path:
-            assert 'data' in str(path)
-
-
-class PathMemoryTests(PathTests, unittest.TestCase):
-    def setUp(self):
-        file = io.BytesIO(b'Hello, UTF-8 world!\n')
-        self.addCleanup(file.close)
-        self.data = util.create_package(
-            file=file, path=FileNotFoundError("package exists only in memory")
-        )
-        self.data.__spec__.origin = None
-        self.data.__spec__.has_location = False
-
-
-class PathZipTests(PathTests, util.ZipSetup, unittest.TestCase):
-    def test_remove_in_context_manager(self):
-        """
-        It is not an error if the file that was temporarily stashed on the
-        file system is removed inside the `with` stanza.
-        """
-        target = resources.files(self.data) / 'utf-8.file'
-        with resources.as_file(target) as path:
-            path.unlink()
-
-
-if __name__ == '__main__':
-    unittest.main()
diff --git a/lib/importlib_resources/tests/test_read.py b/lib/importlib_resources/tests/test_read.py
deleted file mode 100644
index b5aaec45..00000000
--- a/lib/importlib_resources/tests/test_read.py
+++ /dev/null
@@ -1,82 +0,0 @@
-import unittest
-import importlib_resources as resources
-
-from . import data01
-from . import util
-from importlib import import_module
-
-
-class CommonBinaryTests(util.CommonTests, unittest.TestCase):
-    def execute(self, package, path):
-        resources.files(package).joinpath(path).read_bytes()
-
-
-class CommonTextTests(util.CommonTests, unittest.TestCase):
-    def execute(self, package, path):
-        resources.files(package).joinpath(path).read_text(encoding='utf-8')
-
-
-class ReadTests:
-    def test_read_bytes(self):
-        result = resources.files(self.data).joinpath('binary.file').read_bytes()
-        self.assertEqual(result, b'\0\1\2\3')
-
-    def test_read_text_default_encoding(self):
-        result = (
-            resources.files(self.data)
-            .joinpath('utf-8.file')
-            .read_text(encoding='utf-8')
-        )
-        self.assertEqual(result, 'Hello, UTF-8 world!\n')
-
-    def test_read_text_given_encoding(self):
-        result = (
-            resources.files(self.data)
-            .joinpath('utf-16.file')
-            .read_text(encoding='utf-16')
-        )
-        self.assertEqual(result, 'Hello, UTF-16 world!\n')
-
-    def test_read_text_with_errors(self):
-        """
-        Raises UnicodeError without the 'errors' argument.
-        """
-        target = resources.files(self.data) / 'utf-16.file'
-        self.assertRaises(UnicodeError, target.read_text, encoding='utf-8')
-        result = target.read_text(encoding='utf-8', errors='ignore')
-        self.assertEqual(
-            result,
-            'H\x00e\x00l\x00l\x00o\x00,\x00 '
-            '\x00U\x00T\x00F\x00-\x001\x006\x00 '
-            '\x00w\x00o\x00r\x00l\x00d\x00!\x00\n\x00',
-        )
-
-
-class ReadDiskTests(ReadTests, unittest.TestCase):
-    data = data01
-
-
-class ReadZipTests(ReadTests, util.ZipSetup, unittest.TestCase):
-    def test_read_submodule_resource(self):
-        submodule = import_module('ziptestdata.subdirectory')
-        result = resources.files(submodule).joinpath('binary.file').read_bytes()
-        self.assertEqual(result, b'\0\1\2\3')
-
-    def test_read_submodule_resource_by_name(self):
-        result = (
-            resources.files('ziptestdata.subdirectory')
-            .joinpath('binary.file')
-            .read_bytes()
-        )
-        self.assertEqual(result, b'\0\1\2\3')
-
-
-class ReadNamespaceTests(ReadTests, unittest.TestCase):
-    def setUp(self):
-        from . import namespacedata01
-
-        self.data = namespacedata01
-
-
-if __name__ == '__main__':
-    unittest.main()
diff --git a/lib/importlib_resources/tests/test_reader.py b/lib/importlib_resources/tests/test_reader.py
deleted file mode 100644
index e2bdf19c..00000000
--- a/lib/importlib_resources/tests/test_reader.py
+++ /dev/null
@@ -1,144 +0,0 @@
-import os.path
-import sys
-import pathlib
-import unittest
-
-from importlib import import_module
-from importlib_resources.readers import MultiplexedPath, NamespaceReader
-
-
-class MultiplexedPathTest(unittest.TestCase):
-    @classmethod
-    def setUpClass(cls):
-        path = pathlib.Path(__file__).parent / 'namespacedata01'
-        cls.folder = str(path)
-
-    def test_init_no_paths(self):
-        with self.assertRaises(FileNotFoundError):
-            MultiplexedPath()
-
-    def test_init_file(self):
-        with self.assertRaises(NotADirectoryError):
-            MultiplexedPath(os.path.join(self.folder, 'binary.file'))
-
-    def test_iterdir(self):
-        contents = {path.name for path in MultiplexedPath(self.folder).iterdir()}
-        try:
-            contents.remove('__pycache__')
-        except (KeyError, ValueError):
-            pass
-        self.assertEqual(contents, {'binary.file', 'utf-16.file', 'utf-8.file'})
-
-    def test_iterdir_duplicate(self):
-        data01 = os.path.abspath(os.path.join(__file__, '..', 'data01'))
-        contents = {
-            path.name for path in MultiplexedPath(self.folder, data01).iterdir()
-        }
-        for remove in ('__pycache__', '__init__.pyc'):
-            try:
-                contents.remove(remove)
-            except (KeyError, ValueError):
-                pass
-        self.assertEqual(
-            contents,
-            {'__init__.py', 'binary.file', 'subdirectory', 'utf-16.file', 'utf-8.file'},
-        )
-
-    def test_is_dir(self):
-        self.assertEqual(MultiplexedPath(self.folder).is_dir(), True)
-
-    def test_is_file(self):
-        self.assertEqual(MultiplexedPath(self.folder).is_file(), False)
-
-    def test_open_file(self):
-        path = MultiplexedPath(self.folder)
-        with self.assertRaises(FileNotFoundError):
-            path.read_bytes()
-        with self.assertRaises(FileNotFoundError):
-            path.read_text()
-        with self.assertRaises(FileNotFoundError):
-            path.open()
-
-    def test_join_path(self):
-        prefix = os.path.abspath(os.path.join(__file__, '..'))
-        data01 = os.path.join(prefix, 'data01')
-        path = MultiplexedPath(self.folder, data01)
-        self.assertEqual(
-            str(path.joinpath('binary.file'))[len(prefix) + 1 :],
-            os.path.join('namespacedata01', 'binary.file'),
-        )
-        self.assertEqual(
-            str(path.joinpath('subdirectory'))[len(prefix) + 1 :],
-            os.path.join('data01', 'subdirectory'),
-        )
-        self.assertEqual(
-            str(path.joinpath('imaginary'))[len(prefix) + 1 :],
-            os.path.join('namespacedata01', 'imaginary'),
-        )
-        self.assertEqual(path.joinpath(), path)
-
-    def test_join_path_compound(self):
-        path = MultiplexedPath(self.folder)
-        assert not path.joinpath('imaginary/foo.py').exists()
-
-    def test_join_path_common_subdir(self):
-        prefix = os.path.abspath(os.path.join(__file__, '..'))
-        data01 = os.path.join(prefix, 'data01')
-        data02 = os.path.join(prefix, 'data02')
-        path = MultiplexedPath(data01, data02)
-        self.assertIsInstance(path.joinpath('subdirectory'), MultiplexedPath)
-        self.assertEqual(
-            str(path.joinpath('subdirectory', 'subsubdir'))[len(prefix) + 1 :],
-            os.path.join('data02', 'subdirectory', 'subsubdir'),
-        )
-
-    def test_repr(self):
-        self.assertEqual(
-            repr(MultiplexedPath(self.folder)),
-            f"MultiplexedPath('{self.folder}')",
-        )
-
-    def test_name(self):
-        self.assertEqual(
-            MultiplexedPath(self.folder).name,
-            os.path.basename(self.folder),
-        )
-
-
-class NamespaceReaderTest(unittest.TestCase):
-    site_dir = str(pathlib.Path(__file__).parent)
-
-    @classmethod
-    def setUpClass(cls):
-        sys.path.append(cls.site_dir)
-
-    @classmethod
-    def tearDownClass(cls):
-        sys.path.remove(cls.site_dir)
-
-    def test_init_error(self):
-        with self.assertRaises(ValueError):
-            NamespaceReader(['path1', 'path2'])
-
-    def test_resource_path(self):
-        namespacedata01 = import_module('namespacedata01')
-        reader = NamespaceReader(namespacedata01.__spec__.submodule_search_locations)
-
-        root = os.path.abspath(os.path.join(__file__, '..', 'namespacedata01'))
-        self.assertEqual(
-            reader.resource_path('binary.file'), os.path.join(root, 'binary.file')
-        )
-        self.assertEqual(
-            reader.resource_path('imaginary'), os.path.join(root, 'imaginary')
-        )
-
-    def test_files(self):
-        namespacedata01 = import_module('namespacedata01')
-        reader = NamespaceReader(namespacedata01.__spec__.submodule_search_locations)
-        root = os.path.abspath(os.path.join(__file__, '..', 'namespacedata01'))
-        self.assertIsInstance(reader.files(), MultiplexedPath)
-        self.assertEqual(repr(reader.files()), f"MultiplexedPath('{root}')")
-
-
-if __name__ == '__main__':
-    unittest.main()
diff --git a/lib/importlib_resources/tests/test_resource.py b/lib/importlib_resources/tests/test_resource.py
deleted file mode 100644
index 677110cd..00000000
--- a/lib/importlib_resources/tests/test_resource.py
+++ /dev/null
@@ -1,252 +0,0 @@
-import contextlib
-import sys
-import unittest
-import importlib_resources as resources
-import uuid
-import pathlib
-
-from . import data01
-from . import zipdata01, zipdata02
-from . import util
-from importlib import import_module
-from ._compat import import_helper, os_helper, unlink
-
-
-class ResourceTests:
-    # Subclasses are expected to set the `data` attribute.
-
-    def test_is_file_exists(self):
-        target = resources.files(self.data) / 'binary.file'
-        self.assertTrue(target.is_file())
-
-    def test_is_file_missing(self):
-        target = resources.files(self.data) / 'not-a-file'
-        self.assertFalse(target.is_file())
-
-    def test_is_dir(self):
-        target = resources.files(self.data) / 'subdirectory'
-        self.assertFalse(target.is_file())
-        self.assertTrue(target.is_dir())
-
-
-class ResourceDiskTests(ResourceTests, unittest.TestCase):
-    def setUp(self):
-        self.data = data01
-
-
-class ResourceZipTests(ResourceTests, util.ZipSetup, unittest.TestCase):
-    pass
-
-
-def names(traversable):
-    return {item.name for item in traversable.iterdir()}
-
-
-class ResourceLoaderTests(unittest.TestCase):
-    def test_resource_contents(self):
-        package = util.create_package(
-            file=data01, path=data01.__file__, contents=['A', 'B', 'C']
-        )
-        self.assertEqual(names(resources.files(package)), {'A', 'B', 'C'})
-
-    def test_is_file(self):
-        package = util.create_package(
-            file=data01, path=data01.__file__, contents=['A', 'B', 'C', 'D/E', 'D/F']
-        )
-        self.assertTrue(resources.files(package).joinpath('B').is_file())
-
-    def test_is_dir(self):
-        package = util.create_package(
-            file=data01, path=data01.__file__, contents=['A', 'B', 'C', 'D/E', 'D/F']
-        )
-        self.assertTrue(resources.files(package).joinpath('D').is_dir())
-
-    def test_resource_missing(self):
-        package = util.create_package(
-            file=data01, path=data01.__file__, contents=['A', 'B', 'C', 'D/E', 'D/F']
-        )
-        self.assertFalse(resources.files(package).joinpath('Z').is_file())
-
-
-class ResourceCornerCaseTests(unittest.TestCase):
-    def test_package_has_no_reader_fallback(self):
-        """
-        Test odd ball packages which:
-        # 1. Do not have a ResourceReader as a loader
-        # 2. Are not on the file system
-        # 3. Are not in a zip file
-        """
-        module = util.create_package(
-            file=data01, path=data01.__file__, contents=['A', 'B', 'C']
-        )
-        # Give the module a dummy loader.
-        module.__loader__ = object()
-        # Give the module a dummy origin.
-        module.__file__ = '/path/which/shall/not/be/named'
-        module.__spec__.loader = module.__loader__
-        module.__spec__.origin = module.__file__
-        self.assertFalse(resources.files(module).joinpath('A').is_file())
-
-
-class ResourceFromZipsTest01(util.ZipSetupBase, unittest.TestCase):
-    ZIP_MODULE = zipdata01  # type: ignore
-
-    def test_is_submodule_resource(self):
-        submodule = import_module('ziptestdata.subdirectory')
-        self.assertTrue(resources.files(submodule).joinpath('binary.file').is_file())
-
-    def test_read_submodule_resource_by_name(self):
-        self.assertTrue(
-            resources.files('ziptestdata.subdirectory')
-            .joinpath('binary.file')
-            .is_file()
-        )
-
-    def test_submodule_contents(self):
-        submodule = import_module('ziptestdata.subdirectory')
-        self.assertEqual(
-            names(resources.files(submodule)), {'__init__.py', 'binary.file'}
-        )
-
-    def test_submodule_contents_by_name(self):
-        self.assertEqual(
-            names(resources.files('ziptestdata.subdirectory')),
-            {'__init__.py', 'binary.file'},
-        )
-
-    def test_as_file_directory(self):
-        with resources.as_file(resources.files('ziptestdata')) as data:
-            assert data.name == 'ziptestdata'
-            assert data.is_dir()
-            assert data.joinpath('subdirectory').is_dir()
-            assert len(list(data.iterdir()))
-        assert not data.parent.exists()
-
-
-class ResourceFromZipsTest02(util.ZipSetupBase, unittest.TestCase):
-    ZIP_MODULE = zipdata02  # type: ignore
-
-    def test_unrelated_contents(self):
-        """
-        Test thata zip with two unrelated subpackages return
-        distinct resources. Ref python/importlib_resources#44.
-        """
-        self.assertEqual(
-            names(resources.files('ziptestdata.one')),
-            {'__init__.py', 'resource1.txt'},
-        )
-        self.assertEqual(
-            names(resources.files('ziptestdata.two')),
-            {'__init__.py', 'resource2.txt'},
-        )
-
-
-@contextlib.contextmanager
-def zip_on_path(dir):
-    data_path = pathlib.Path(zipdata01.__file__)
-    source_zip_path = data_path.parent.joinpath('ziptestdata.zip')
-    zip_path = pathlib.Path(dir) / f'{uuid.uuid4()}.zip'
-    zip_path.write_bytes(source_zip_path.read_bytes())
-    sys.path.append(str(zip_path))
-    import_module('ziptestdata')
-
-    try:
-        yield
-    finally:
-        with contextlib.suppress(ValueError):
-            sys.path.remove(str(zip_path))
-
-        with contextlib.suppress(KeyError):
-            del sys.path_importer_cache[str(zip_path)]
-            del sys.modules['ziptestdata']
-
-        with contextlib.suppress(OSError):
-            unlink(zip_path)
-
-
-class DeletingZipsTest(unittest.TestCase):
-    """Having accessed resources in a zip file should not keep an open
-    reference to the zip.
-    """
-
-    def setUp(self):
-        self.fixtures = contextlib.ExitStack()
-        self.addCleanup(self.fixtures.close)
-
-        modules = import_helper.modules_setup()
-        self.addCleanup(import_helper.modules_cleanup, *modules)
-
-        temp_dir = self.fixtures.enter_context(os_helper.temp_dir())
-        self.fixtures.enter_context(zip_on_path(temp_dir))
-
-    def test_iterdir_does_not_keep_open(self):
-        [item.name for item in resources.files('ziptestdata').iterdir()]
-
-    def test_is_file_does_not_keep_open(self):
-        resources.files('ziptestdata').joinpath('binary.file').is_file()
-
-    def test_is_file_failure_does_not_keep_open(self):
-        resources.files('ziptestdata').joinpath('not-present').is_file()
-
-    @unittest.skip("Desired but not supported.")
-    def test_as_file_does_not_keep_open(self):  # pragma: no cover
-        resources.as_file(resources.files('ziptestdata') / 'binary.file')
-
-    def test_entered_path_does_not_keep_open(self):
-        """
-        Mimic what certifi does on import to make its bundle
-        available for the process duration.
-        """
-        resources.as_file(resources.files('ziptestdata') / 'binary.file').__enter__()
-
-    def test_read_binary_does_not_keep_open(self):
-        resources.files('ziptestdata').joinpath('binary.file').read_bytes()
-
-    def test_read_text_does_not_keep_open(self):
-        resources.files('ziptestdata').joinpath('utf-8.file').read_text(
-            encoding='utf-8'
-        )
-
-
-class ResourceFromNamespaceTest01(unittest.TestCase):
-    site_dir = str(pathlib.Path(__file__).parent)
-
-    @classmethod
-    def setUpClass(cls):
-        sys.path.append(cls.site_dir)
-
-    @classmethod
-    def tearDownClass(cls):
-        sys.path.remove(cls.site_dir)
-
-    def test_is_submodule_resource(self):
-        self.assertTrue(
-            resources.files(import_module('namespacedata01'))
-            .joinpath('binary.file')
-            .is_file()
-        )
-
-    def test_read_submodule_resource_by_name(self):
-        self.assertTrue(
-            resources.files('namespacedata01').joinpath('binary.file').is_file()
-        )
-
-    def test_submodule_contents(self):
-        contents = names(resources.files(import_module('namespacedata01')))
-        try:
-            contents.remove('__pycache__')
-        except KeyError:
-            pass
-        self.assertEqual(contents, {'binary.file', 'utf-8.file', 'utf-16.file'})
-
-    def test_submodule_contents_by_name(self):
-        contents = names(resources.files('namespacedata01'))
-        try:
-            contents.remove('__pycache__')
-        except KeyError:
-            pass
-        self.assertEqual(contents, {'binary.file', 'utf-8.file', 'utf-16.file'})
-
-
-if __name__ == '__main__':
-    unittest.main()
diff --git a/lib/importlib_resources/tests/update-zips.py b/lib/importlib_resources/tests/update-zips.py
deleted file mode 100644
index 231334aa..00000000
--- a/lib/importlib_resources/tests/update-zips.py
+++ /dev/null
@@ -1,53 +0,0 @@
-"""
-Generate the zip test data files.
-
-Run to build the tests/zipdataNN/ziptestdata.zip files from
-files in tests/dataNN.
-
-Replaces the file with the working copy, but does commit anything
-to the source repo.
-"""
-
-import contextlib
-import os
-import pathlib
-import zipfile
-
-
-def main():
-    """
-    >>> from unittest import mock
-    >>> monkeypatch = getfixture('monkeypatch')
-    >>> monkeypatch.setattr(zipfile, 'ZipFile', mock.MagicMock())
-    >>> print(); main()  # print workaround for bpo-32509
-    <BLANKLINE>
-    ...data01... -> ziptestdata/...
-    ...
-    ...data02... -> ziptestdata/...
-    ...
-    """
-    suffixes = '01', '02'
-    tuple(map(generate, suffixes))
-
-
-def generate(suffix):
-    root = pathlib.Path(__file__).parent.relative_to(os.getcwd())
-    zfpath = root / f'zipdata{suffix}/ziptestdata.zip'
-    with zipfile.ZipFile(zfpath, 'w') as zf:
-        for src, rel in walk(root / f'data{suffix}'):
-            dst = 'ziptestdata' / pathlib.PurePosixPath(rel.as_posix())
-            print(src, '->', dst)
-            zf.write(src, dst)
-
-
-def walk(datapath):
-    for dirpath, dirnames, filenames in os.walk(datapath):
-        with contextlib.suppress(ValueError):
-            dirnames.remove('__pycache__')
-        for filename in filenames:
-            res = pathlib.Path(dirpath) / filename
-            rel = res.relative_to(datapath)
-            yield res, rel
-
-
-__name__ == '__main__' and main()
diff --git a/lib/importlib_resources/tests/util.py b/lib/importlib_resources/tests/util.py
deleted file mode 100644
index ce0e6fad..00000000
--- a/lib/importlib_resources/tests/util.py
+++ /dev/null
@@ -1,179 +0,0 @@
-import abc
-import importlib
-import io
-import sys
-import types
-import pathlib
-
-from . import data01
-from . import zipdata01
-from ..abc import ResourceReader
-from ._compat import import_helper
-
-
-from importlib.machinery import ModuleSpec
-
-
-class Reader(ResourceReader):
-    def __init__(self, **kwargs):
-        vars(self).update(kwargs)
-
-    def get_resource_reader(self, package):
-        return self
-
-    def open_resource(self, path):
-        self._path = path
-        if isinstance(self.file, Exception):
-            raise self.file
-        return self.file
-
-    def resource_path(self, path_):
-        self._path = path_
-        if isinstance(self.path, Exception):
-            raise self.path
-        return self.path
-
-    def is_resource(self, path_):
-        self._path = path_
-        if isinstance(self.path, Exception):
-            raise self.path
-
-        def part(entry):
-            return entry.split('/')
-
-        return any(
-            len(parts) == 1 and parts[0] == path_ for parts in map(part, self._contents)
-        )
-
-    def contents(self):
-        if isinstance(self.path, Exception):
-            raise self.path
-        yield from self._contents
-
-
-def create_package_from_loader(loader, is_package=True):
-    name = 'testingpackage'
-    module = types.ModuleType(name)
-    spec = ModuleSpec(name, loader, origin='does-not-exist', is_package=is_package)
-    module.__spec__ = spec
-    module.__loader__ = loader
-    return module
-
-
-def create_package(file=None, path=None, is_package=True, contents=()):
-    return create_package_from_loader(
-        Reader(file=file, path=path, _contents=contents),
-        is_package,
-    )
-
-
-class CommonTests(metaclass=abc.ABCMeta):
-    """
-    Tests shared by test_open, test_path, and test_read.
-    """
-
-    @abc.abstractmethod
-    def execute(self, package, path):
-        """
-        Call the pertinent legacy API function (e.g. open_text, path)
-        on package and path.
-        """
-
-    def test_package_name(self):
-        """
-        Passing in the package name should succeed.
-        """
-        self.execute(data01.__name__, 'utf-8.file')
-
-    def test_package_object(self):
-        """
-        Passing in the package itself should succeed.
-        """
-        self.execute(data01, 'utf-8.file')
-
-    def test_string_path(self):
-        """
-        Passing in a string for the path should succeed.
-        """
-        path = 'utf-8.file'
-        self.execute(data01, path)
-
-    def test_pathlib_path(self):
-        """
-        Passing in a pathlib.PurePath object for the path should succeed.
-        """
-        path = pathlib.PurePath('utf-8.file')
-        self.execute(data01, path)
-
-    def test_importing_module_as_side_effect(self):
-        """
-        The anchor package can already be imported.
-        """
-        del sys.modules[data01.__name__]
-        self.execute(data01.__name__, 'utf-8.file')
-
-    def test_missing_path(self):
-        """
-        Attempting to open or read or request the path for a
-        non-existent path should succeed if open_resource
-        can return a viable data stream.
-        """
-        bytes_data = io.BytesIO(b'Hello, world!')
-        package = create_package(file=bytes_data, path=FileNotFoundError())
-        self.execute(package, 'utf-8.file')
-        self.assertEqual(package.__loader__._path, 'utf-8.file')
-
-    def test_extant_path(self):
-        # Attempting to open or read or request the path when the
-        # path does exist should still succeed. Does not assert
-        # anything about the result.
-        bytes_data = io.BytesIO(b'Hello, world!')
-        # any path that exists
-        path = __file__
-        package = create_package(file=bytes_data, path=path)
-        self.execute(package, 'utf-8.file')
-        self.assertEqual(package.__loader__._path, 'utf-8.file')
-
-    def test_useless_loader(self):
-        package = create_package(file=FileNotFoundError(), path=FileNotFoundError())
-        with self.assertRaises(FileNotFoundError):
-            self.execute(package, 'utf-8.file')
-
-
-class ZipSetupBase:
-    ZIP_MODULE = None
-
-    @classmethod
-    def setUpClass(cls):
-        data_path = pathlib.Path(cls.ZIP_MODULE.__file__)
-        data_dir = data_path.parent
-        cls._zip_path = str(data_dir / 'ziptestdata.zip')
-        sys.path.append(cls._zip_path)
-        cls.data = importlib.import_module('ziptestdata')
-
-    @classmethod
-    def tearDownClass(cls):
-        try:
-            sys.path.remove(cls._zip_path)
-        except ValueError:
-            pass
-
-        try:
-            del sys.path_importer_cache[cls._zip_path]
-            del sys.modules[cls.data.__name__]
-        except KeyError:
-            pass
-
-        try:
-            del cls.data
-            del cls._zip_path
-        except AttributeError:
-            pass
-
-    def setUp(self):
-        modules = import_helper.modules_setup()
-        self.addCleanup(import_helper.modules_cleanup, *modules)
-
-
-class ZipSetup(ZipSetupBase):
-    ZIP_MODULE = zipdata01  # type: ignore
diff --git a/lib/importlib_resources/tests/zipdata01/__init__.py b/lib/importlib_resources/tests/zipdata01/__init__.py
deleted file mode 100644
index e69de29b..00000000
diff --git a/lib/importlib_resources/tests/zipdata01/ziptestdata.zip b/lib/importlib_resources/tests/zipdata01/ziptestdata.zip
deleted file mode 100644
index 9a3bb0739f87e97c1084b94d7d153680f6727738..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 876
zcmWIWW@Zs#00HOCX@Q%&m27l?Y!DU);;PJolGNgol*E!m{nC;&T|+ayw9K5;|NlG~
zQW<i9FdwK?fgzM3gu#tLm%)(149F`7iWULoQWz8&xEKOZEI9q+&@7O3AS{N(0t>MD
z9;rDw`8o=rA#S=B3g!7lIVp-<sOA8*!U4KN<Kr{)GE3s)^$IFcH3_%v>}COK17UPc
zNtt<xMU`ON85o(EQ8mJ?0y0#97&%yqOOsMEi&B$I@{20<iLx562^j8RWD;S<9YHXc
zEolU?kllq8T>;*xhM-3R!jMEPhCreO-3*u>5Df}T7+BJ{639e$2uhfsIs`pJ5Qf}C
xGXyDE@VNvOv@o!wQJfLgCAgysx3f@9jKpUmiW^zkK<;1z!tFpk^MROw0RS~O%0&PG

diff --git a/lib/importlib_resources/tests/zipdata02/__init__.py b/lib/importlib_resources/tests/zipdata02/__init__.py
deleted file mode 100644
index e69de29b..00000000
diff --git a/lib/importlib_resources/tests/zipdata02/ziptestdata.zip b/lib/importlib_resources/tests/zipdata02/ziptestdata.zip
deleted file mode 100644
index d63ff512d2807ef2fd259455283b81b02e0e45fb..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 698
zcmWIWW@Zs#00HOCX@Ot{ln@8fRhb1Psl_EJi6x2p@$s2?nI-Y@dIgmMI5kP5Y0A$_
z#jWw|&p#`9ff_(q7K_HB)Z+ZoqU2OVy^@L&ph*fa0WRVlP*R?c+X1opI-R&20MZDv
z&j{oIpa8N17@0(vaR(gGH(;=&5k%n(M%;#g0ulz6G@1gL$cA79E2=^00gEsw4~s!C
zUxI@<z#G*lm{t&t>ZWaIMqz|BszK;s4KsL2<9jRy!Q2E6`2cTLHjr{wAk1ZCU@!+_
G1_l6Bc%f?m

diff --git a/requirements.txt b/requirements.txt
index 3fc87314..e71070e6 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -19,8 +19,6 @@ gntp==1.0.3
 html5lib==1.1
 httpagentparser==1.9.5
 idna==3.4
-importlib-metadata==6.8.0
-importlib-resources==6.0.1
 git+https://github.com/Tautulli/ipwhois.git@master#egg=ipwhois
 IPy==1.01
 Mako==1.2.4

From 47b2f55c973c701f89fd2ada79d8afd53759396e Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 24 Aug 2023 14:18:46 -0700
Subject: [PATCH 452/743] Remove importlib-metadata and importlib-resources

---
 package/requirements-package.txt | 2 --
 1 file changed, 2 deletions(-)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index 1027cf23..db171e7a 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -1,6 +1,4 @@
 apscheduler==3.10.4
-importlib-metadata==6.8.0
-importlib-resources==6.0.1
 pyinstaller==5.13.0
 pyopenssl==23.2.0
 pycryptodomex==3.18.0

From 289a8a23344931a295f88a21e56ae8feadaf525d Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 25 Aug 2023 09:11:08 -0700
Subject: [PATCH 453/743] v2.13.0

---
 CHANGELOG.md      | 12 ++++++++++++
 plexpy/version.py |  2 +-
 2 files changed, 13 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 974e69ce..a7655ed1 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,17 @@
 # Changelog
 
+## v2.13.0 (2023-08-25)
+
+* Notes:
+  * Support for Python 3.7 has been dropped. The minimum Python version is now 3.8.
+* Notifications:
+  * Fix: Improved watched notification trigger description. (#2104)
+  * New: Added notification image option for iOS Tautulli Remote app.
+* Exporter:
+  * New: Added track chapter export fields.
+  * New: Added on-demand subtitle export fields.
+
+
 ## v2.12.5 (2023-07-13)
 
 * Activity:
diff --git a/plexpy/version.py b/plexpy/version.py
index 116f4687..398d8ecb 100644
--- a/plexpy/version.py
+++ b/plexpy/version.py
@@ -18,4 +18,4 @@
 from __future__ import unicode_literals
 
 PLEXPY_BRANCH = "master"
-PLEXPY_RELEASE_VERSION = "v2.12.5"
\ No newline at end of file
+PLEXPY_RELEASE_VERSION = "v2.13.0"
\ No newline at end of file

From fa510792f128bee0526884e131508b37c58c4e12 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 24 Aug 2023 14:18:46 -0700
Subject: [PATCH 454/743] Revert "Remove importlib-metadata and
 importlib-resources"

This reverts commit 47b2f55c973c701f89fd2ada79d8afd53759396e.
---
 package/requirements-package.txt | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index db171e7a..1027cf23 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -1,4 +1,6 @@
 apscheduler==3.10.4
+importlib-metadata==6.8.0
+importlib-resources==6.0.1
 pyinstaller==5.13.0
 pyopenssl==23.2.0
 pycryptodomex==3.18.0

From 1b26775ec6eddd8769c492bb8f96c8aca3d86a8d Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 24 Aug 2023 13:49:16 -0700
Subject: [PATCH 455/743] Revert "Remove importlib-metadata and
 importlib-resources"

This reverts commit 38435ae81c5b029e54f87aa460d6f9394e6c3180.
---
 lib/importlib_metadata/__init__.py            | 904 ++++++++++++++++++
 lib/importlib_metadata/_adapters.py           |  90 ++
 lib/importlib_metadata/_collections.py        |  30 +
 lib/importlib_metadata/_compat.py             |  72 ++
 lib/importlib_metadata/_functools.py          | 104 ++
 lib/importlib_metadata/_itertools.py          |  73 ++
 lib/importlib_metadata/_meta.py               |  49 +
 lib/importlib_metadata/_py39compat.py         |  35 +
 lib/importlib_metadata/_text.py               |  99 ++
 lib/importlib_metadata/py.typed               |   0
 lib/importlib_resources/__init__.py           |  17 +
 lib/importlib_resources/_adapters.py          | 168 ++++
 lib/importlib_resources/_common.py            | 207 ++++
 lib/importlib_resources/_compat.py            | 109 +++
 lib/importlib_resources/_itertools.py         |  38 +
 lib/importlib_resources/abc.py                | 170 ++++
 lib/importlib_resources/py.typed              |   0
 lib/importlib_resources/readers.py            | 144 +++
 lib/importlib_resources/simple.py             | 106 ++
 lib/importlib_resources/tests/__init__.py     |   0
 lib/importlib_resources/tests/_compat.py      |  32 +
 lib/importlib_resources/tests/_path.py        |  56 ++
 .../tests/data01/__init__.py                  |   0
 .../tests/data01/binary.file                  | Bin 0 -> 4 bytes
 .../tests/data01/subdirectory/__init__.py     |   0
 .../tests/data01/subdirectory/binary.file     | Bin 0 -> 4 bytes
 .../tests/data01/utf-16.file                  | Bin 0 -> 44 bytes
 .../tests/data01/utf-8.file                   |   1 +
 .../tests/data02/__init__.py                  |   0
 .../tests/data02/one/__init__.py              |   0
 .../tests/data02/one/resource1.txt            |   1 +
 .../subdirectory/subsubdir/resource.txt       |   1 +
 .../tests/data02/two/__init__.py              |   0
 .../tests/data02/two/resource2.txt            |   1 +
 .../tests/namespacedata01/binary.file         | Bin 0 -> 4 bytes
 .../tests/namespacedata01/utf-16.file         | Bin 0 -> 44 bytes
 .../tests/namespacedata01/utf-8.file          |   1 +
 .../tests/test_compatibilty_files.py          | 104 ++
 .../tests/test_contents.py                    |  43 +
 lib/importlib_resources/tests/test_custom.py  |  45 +
 lib/importlib_resources/tests/test_files.py   | 112 +++
 lib/importlib_resources/tests/test_open.py    |  85 ++
 lib/importlib_resources/tests/test_path.py    |  69 ++
 lib/importlib_resources/tests/test_read.py    |  82 ++
 lib/importlib_resources/tests/test_reader.py  | 144 +++
 .../tests/test_resource.py                    | 252 +++++
 lib/importlib_resources/tests/update-zips.py  |  53 +
 lib/importlib_resources/tests/util.py         | 179 ++++
 .../tests/zipdata01/__init__.py               |   0
 .../tests/zipdata01/ziptestdata.zip           | Bin 0 -> 876 bytes
 .../tests/zipdata02/__init__.py               |   0
 .../tests/zipdata02/ziptestdata.zip           | Bin 0 -> 698 bytes
 requirements.txt                              |   2 +
 53 files changed, 3678 insertions(+)
 create mode 100644 lib/importlib_metadata/__init__.py
 create mode 100644 lib/importlib_metadata/_adapters.py
 create mode 100644 lib/importlib_metadata/_collections.py
 create mode 100644 lib/importlib_metadata/_compat.py
 create mode 100644 lib/importlib_metadata/_functools.py
 create mode 100644 lib/importlib_metadata/_itertools.py
 create mode 100644 lib/importlib_metadata/_meta.py
 create mode 100644 lib/importlib_metadata/_py39compat.py
 create mode 100644 lib/importlib_metadata/_text.py
 create mode 100644 lib/importlib_metadata/py.typed
 create mode 100644 lib/importlib_resources/__init__.py
 create mode 100644 lib/importlib_resources/_adapters.py
 create mode 100644 lib/importlib_resources/_common.py
 create mode 100644 lib/importlib_resources/_compat.py
 create mode 100644 lib/importlib_resources/_itertools.py
 create mode 100644 lib/importlib_resources/abc.py
 create mode 100644 lib/importlib_resources/py.typed
 create mode 100644 lib/importlib_resources/readers.py
 create mode 100644 lib/importlib_resources/simple.py
 create mode 100644 lib/importlib_resources/tests/__init__.py
 create mode 100644 lib/importlib_resources/tests/_compat.py
 create mode 100644 lib/importlib_resources/tests/_path.py
 create mode 100644 lib/importlib_resources/tests/data01/__init__.py
 create mode 100644 lib/importlib_resources/tests/data01/binary.file
 create mode 100644 lib/importlib_resources/tests/data01/subdirectory/__init__.py
 create mode 100644 lib/importlib_resources/tests/data01/subdirectory/binary.file
 create mode 100644 lib/importlib_resources/tests/data01/utf-16.file
 create mode 100644 lib/importlib_resources/tests/data01/utf-8.file
 create mode 100644 lib/importlib_resources/tests/data02/__init__.py
 create mode 100644 lib/importlib_resources/tests/data02/one/__init__.py
 create mode 100644 lib/importlib_resources/tests/data02/one/resource1.txt
 create mode 100644 lib/importlib_resources/tests/data02/subdirectory/subsubdir/resource.txt
 create mode 100644 lib/importlib_resources/tests/data02/two/__init__.py
 create mode 100644 lib/importlib_resources/tests/data02/two/resource2.txt
 create mode 100644 lib/importlib_resources/tests/namespacedata01/binary.file
 create mode 100644 lib/importlib_resources/tests/namespacedata01/utf-16.file
 create mode 100644 lib/importlib_resources/tests/namespacedata01/utf-8.file
 create mode 100644 lib/importlib_resources/tests/test_compatibilty_files.py
 create mode 100644 lib/importlib_resources/tests/test_contents.py
 create mode 100644 lib/importlib_resources/tests/test_custom.py
 create mode 100644 lib/importlib_resources/tests/test_files.py
 create mode 100644 lib/importlib_resources/tests/test_open.py
 create mode 100644 lib/importlib_resources/tests/test_path.py
 create mode 100644 lib/importlib_resources/tests/test_read.py
 create mode 100644 lib/importlib_resources/tests/test_reader.py
 create mode 100644 lib/importlib_resources/tests/test_resource.py
 create mode 100644 lib/importlib_resources/tests/update-zips.py
 create mode 100644 lib/importlib_resources/tests/util.py
 create mode 100644 lib/importlib_resources/tests/zipdata01/__init__.py
 create mode 100644 lib/importlib_resources/tests/zipdata01/ziptestdata.zip
 create mode 100644 lib/importlib_resources/tests/zipdata02/__init__.py
 create mode 100644 lib/importlib_resources/tests/zipdata02/ziptestdata.zip

diff --git a/lib/importlib_metadata/__init__.py b/lib/importlib_metadata/__init__.py
new file mode 100644
index 00000000..9a36a8e6
--- /dev/null
+++ b/lib/importlib_metadata/__init__.py
@@ -0,0 +1,904 @@
+import os
+import re
+import abc
+import csv
+import sys
+import zipp
+import email
+import pathlib
+import operator
+import textwrap
+import warnings
+import functools
+import itertools
+import posixpath
+import collections
+
+from . import _adapters, _meta, _py39compat
+from ._collections import FreezableDefaultDict, Pair
+from ._compat import (
+    NullFinder,
+    install,
+    pypy_partial,
+)
+from ._functools import method_cache, pass_none
+from ._itertools import always_iterable, unique_everseen
+from ._meta import PackageMetadata, SimplePath
+
+from contextlib import suppress
+from importlib import import_module
+from importlib.abc import MetaPathFinder
+from itertools import starmap
+from typing import List, Mapping, Optional
+
+
+__all__ = [
+    'Distribution',
+    'DistributionFinder',
+    'PackageMetadata',
+    'PackageNotFoundError',
+    'distribution',
+    'distributions',
+    'entry_points',
+    'files',
+    'metadata',
+    'packages_distributions',
+    'requires',
+    'version',
+]
+
+
+class PackageNotFoundError(ModuleNotFoundError):
+    """The package was not found."""
+
+    def __str__(self):
+        return f"No package metadata was found for {self.name}"
+
+    @property
+    def name(self):
+        (name,) = self.args
+        return name
+
+
+class Sectioned:
+    """
+    A simple entry point config parser for performance
+
+    >>> for item in Sectioned.read(Sectioned._sample):
+    ...     print(item)
+    Pair(name='sec1', value='# comments ignored')
+    Pair(name='sec1', value='a = 1')
+    Pair(name='sec1', value='b = 2')
+    Pair(name='sec2', value='a = 2')
+
+    >>> res = Sectioned.section_pairs(Sectioned._sample)
+    >>> item = next(res)
+    >>> item.name
+    'sec1'
+    >>> item.value
+    Pair(name='a', value='1')
+    >>> item = next(res)
+    >>> item.value
+    Pair(name='b', value='2')
+    >>> item = next(res)
+    >>> item.name
+    'sec2'
+    >>> item.value
+    Pair(name='a', value='2')
+    >>> list(res)
+    []
+    """
+
+    _sample = textwrap.dedent(
+        """
+        [sec1]
+        # comments ignored
+        a = 1
+        b = 2
+
+        [sec2]
+        a = 2
+        """
+    ).lstrip()
+
+    @classmethod
+    def section_pairs(cls, text):
+        return (
+            section._replace(value=Pair.parse(section.value))
+            for section in cls.read(text, filter_=cls.valid)
+            if section.name is not None
+        )
+
+    @staticmethod
+    def read(text, filter_=None):
+        lines = filter(filter_, map(str.strip, text.splitlines()))
+        name = None
+        for value in lines:
+            section_match = value.startswith('[') and value.endswith(']')
+            if section_match:
+                name = value.strip('[]')
+                continue
+            yield Pair(name, value)
+
+    @staticmethod
+    def valid(line):
+        return line and not line.startswith('#')
+
+
+class DeprecatedTuple:
+    """
+    Provide subscript item access for backward compatibility.
+
+    >>> recwarn = getfixture('recwarn')
+    >>> ep = EntryPoint(name='name', value='value', group='group')
+    >>> ep[:]
+    ('name', 'value', 'group')
+    >>> ep[0]
+    'name'
+    >>> len(recwarn)
+    1
+    """
+
+    # Do not remove prior to 2023-05-01 or Python 3.13
+    _warn = functools.partial(
+        warnings.warn,
+        "EntryPoint tuple interface is deprecated. Access members by name.",
+        DeprecationWarning,
+        stacklevel=pypy_partial(2),
+    )
+
+    def __getitem__(self, item):
+        self._warn()
+        return self._key()[item]
+
+
+class EntryPoint(DeprecatedTuple):
+    """An entry point as defined by Python packaging conventions.
+
+    See `the packaging docs on entry points
+    <https://packaging.python.org/specifications/entry-points/>`_
+    for more information.
+
+    >>> ep = EntryPoint(
+    ...     name=None, group=None, value='package.module:attr [extra1, extra2]')
+    >>> ep.module
+    'package.module'
+    >>> ep.attr
+    'attr'
+    >>> ep.extras
+    ['extra1', 'extra2']
+    """
+
+    pattern = re.compile(
+        r'(?P<module>[\w.]+)\s*'
+        r'(:\s*(?P<attr>[\w.]+)\s*)?'
+        r'((?P<extras>\[.*\])\s*)?$'
+    )
+    """
+    A regular expression describing the syntax for an entry point,
+    which might look like:
+
+        - module
+        - package.module
+        - package.module:attribute
+        - package.module:object.attribute
+        - package.module:attr [extra1, extra2]
+
+    Other combinations are possible as well.
+
+    The expression is lenient about whitespace around the ':',
+    following the attr, and following any extras.
+    """
+
+    name: str
+    value: str
+    group: str
+
+    dist: Optional['Distribution'] = None
+
+    def __init__(self, name, value, group):
+        vars(self).update(name=name, value=value, group=group)
+
+    def load(self):
+        """Load the entry point from its definition. If only a module
+        is indicated by the value, return that module. Otherwise,
+        return the named object.
+        """
+        match = self.pattern.match(self.value)
+        module = import_module(match.group('module'))
+        attrs = filter(None, (match.group('attr') or '').split('.'))
+        return functools.reduce(getattr, attrs, module)
+
+    @property
+    def module(self):
+        match = self.pattern.match(self.value)
+        return match.group('module')
+
+    @property
+    def attr(self):
+        match = self.pattern.match(self.value)
+        return match.group('attr')
+
+    @property
+    def extras(self):
+        match = self.pattern.match(self.value)
+        return re.findall(r'\w+', match.group('extras') or '')
+
+    def _for(self, dist):
+        vars(self).update(dist=dist)
+        return self
+
+    def matches(self, **params):
+        """
+        EntryPoint matches the given parameters.
+
+        >>> ep = EntryPoint(group='foo', name='bar', value='bing:bong [extra1, extra2]')
+        >>> ep.matches(group='foo')
+        True
+        >>> ep.matches(name='bar', value='bing:bong [extra1, extra2]')
+        True
+        >>> ep.matches(group='foo', name='other')
+        False
+        >>> ep.matches()
+        True
+        >>> ep.matches(extras=['extra1', 'extra2'])
+        True
+        >>> ep.matches(module='bing')
+        True
+        >>> ep.matches(attr='bong')
+        True
+        """
+        attrs = (getattr(self, param) for param in params)
+        return all(map(operator.eq, params.values(), attrs))
+
+    def _key(self):
+        return self.name, self.value, self.group
+
+    def __lt__(self, other):
+        return self._key() < other._key()
+
+    def __eq__(self, other):
+        return self._key() == other._key()
+
+    def __setattr__(self, name, value):
+        raise AttributeError("EntryPoint objects are immutable.")
+
+    def __repr__(self):
+        return (
+            f'EntryPoint(name={self.name!r}, value={self.value!r}, '
+            f'group={self.group!r})'
+        )
+
+    def __hash__(self):
+        return hash(self._key())
+
+
+class EntryPoints(tuple):
+    """
+    An immutable collection of selectable EntryPoint objects.
+    """
+
+    __slots__ = ()
+
+    def __getitem__(self, name):  # -> EntryPoint:
+        """
+        Get the EntryPoint in self matching name.
+        """
+        try:
+            return next(iter(self.select(name=name)))
+        except StopIteration:
+            raise KeyError(name)
+
+    def select(self, **params):
+        """
+        Select entry points from self that match the
+        given parameters (typically group and/or name).
+        """
+        return EntryPoints(ep for ep in self if _py39compat.ep_matches(ep, **params))
+
+    @property
+    def names(self):
+        """
+        Return the set of all names of all entry points.
+        """
+        return {ep.name for ep in self}
+
+    @property
+    def groups(self):
+        """
+        Return the set of all groups of all entry points.
+        """
+        return {ep.group for ep in self}
+
+    @classmethod
+    def _from_text_for(cls, text, dist):
+        return cls(ep._for(dist) for ep in cls._from_text(text))
+
+    @staticmethod
+    def _from_text(text):
+        return (
+            EntryPoint(name=item.value.name, value=item.value.value, group=item.name)
+            for item in Sectioned.section_pairs(text or '')
+        )
+
+
+class PackagePath(pathlib.PurePosixPath):
+    """A reference to a path in a package"""
+
+    def read_text(self, encoding='utf-8'):
+        with self.locate().open(encoding=encoding) as stream:
+            return stream.read()
+
+    def read_binary(self):
+        with self.locate().open('rb') as stream:
+            return stream.read()
+
+    def locate(self):
+        """Return a path-like object for this path"""
+        return self.dist.locate_file(self)
+
+
+class FileHash:
+    def __init__(self, spec):
+        self.mode, _, self.value = spec.partition('=')
+
+    def __repr__(self):
+        return f'<FileHash mode: {self.mode} value: {self.value}>'
+
+
+class Distribution(metaclass=abc.ABCMeta):
+    """A Python distribution package."""
+
+    @abc.abstractmethod
+    def read_text(self, filename):
+        """Attempt to load metadata file given by the name.
+
+        :param filename: The name of the file in the distribution info.
+        :return: The text if found, otherwise None.
+        """
+
+    @abc.abstractmethod
+    def locate_file(self, path):
+        """
+        Given a path to a file in this distribution, return a path
+        to it.
+        """
+
+    @classmethod
+    def from_name(cls, name: str):
+        """Return the Distribution for the given package name.
+
+        :param name: The name of the distribution package to search for.
+        :return: The Distribution instance (or subclass thereof) for the named
+            package, if found.
+        :raises PackageNotFoundError: When the named package's distribution
+            metadata cannot be found.
+        :raises ValueError: When an invalid value is supplied for name.
+        """
+        if not name:
+            raise ValueError("A distribution name is required.")
+        try:
+            return next(cls.discover(name=name))
+        except StopIteration:
+            raise PackageNotFoundError(name)
+
+    @classmethod
+    def discover(cls, **kwargs):
+        """Return an iterable of Distribution objects for all packages.
+
+        Pass a ``context`` or pass keyword arguments for constructing
+        a context.
+
+        :context: A ``DistributionFinder.Context`` object.
+        :return: Iterable of Distribution objects for all packages.
+        """
+        context = kwargs.pop('context', None)
+        if context and kwargs:
+            raise ValueError("cannot accept context and kwargs")
+        context = context or DistributionFinder.Context(**kwargs)
+        return itertools.chain.from_iterable(
+            resolver(context) for resolver in cls._discover_resolvers()
+        )
+
+    @staticmethod
+    def at(path):
+        """Return a Distribution for the indicated metadata path
+
+        :param path: a string or path-like object
+        :return: a concrete Distribution instance for the path
+        """
+        return PathDistribution(pathlib.Path(path))
+
+    @staticmethod
+    def _discover_resolvers():
+        """Search the meta_path for resolvers."""
+        declared = (
+            getattr(finder, 'find_distributions', None) for finder in sys.meta_path
+        )
+        return filter(None, declared)
+
+    @property
+    def metadata(self) -> _meta.PackageMetadata:
+        """Return the parsed metadata for this Distribution.
+
+        The returned object will have keys that name the various bits of
+        metadata.  See PEP 566 for details.
+        """
+        text = (
+            self.read_text('METADATA')
+            or self.read_text('PKG-INFO')
+            # This last clause is here to support old egg-info files.  Its
+            # effect is to just end up using the PathDistribution's self._path
+            # (which points to the egg-info file) attribute unchanged.
+            or self.read_text('')
+        )
+        return _adapters.Message(email.message_from_string(text))
+
+    @property
+    def name(self):
+        """Return the 'Name' metadata for the distribution package."""
+        return self.metadata['Name']
+
+    @property
+    def _normalized_name(self):
+        """Return a normalized version of the name."""
+        return Prepared.normalize(self.name)
+
+    @property
+    def version(self):
+        """Return the 'Version' metadata for the distribution package."""
+        return self.metadata['Version']
+
+    @property
+    def entry_points(self):
+        return EntryPoints._from_text_for(self.read_text('entry_points.txt'), self)
+
+    @property
+    def files(self):
+        """Files in this distribution.
+
+        :return: List of PackagePath for this distribution or None
+
+        Result is `None` if the metadata file that enumerates files
+        (i.e. RECORD for dist-info or SOURCES.txt for egg-info) is
+        missing.
+        Result may be empty if the metadata exists but is empty.
+        """
+
+        def make_file(name, hash=None, size_str=None):
+            result = PackagePath(name)
+            result.hash = FileHash(hash) if hash else None
+            result.size = int(size_str) if size_str else None
+            result.dist = self
+            return result
+
+        @pass_none
+        def make_files(lines):
+            return list(starmap(make_file, csv.reader(lines)))
+
+        return make_files(self._read_files_distinfo() or self._read_files_egginfo())
+
+    def _read_files_distinfo(self):
+        """
+        Read the lines of RECORD
+        """
+        text = self.read_text('RECORD')
+        return text and text.splitlines()
+
+    def _read_files_egginfo(self):
+        """
+        SOURCES.txt might contain literal commas, so wrap each line
+        in quotes.
+        """
+        text = self.read_text('SOURCES.txt')
+        return text and map('"{}"'.format, text.splitlines())
+
+    @property
+    def requires(self):
+        """Generated requirements specified for this Distribution"""
+        reqs = self._read_dist_info_reqs() or self._read_egg_info_reqs()
+        return reqs and list(reqs)
+
+    def _read_dist_info_reqs(self):
+        return self.metadata.get_all('Requires-Dist')
+
+    def _read_egg_info_reqs(self):
+        source = self.read_text('requires.txt')
+        return pass_none(self._deps_from_requires_text)(source)
+
+    @classmethod
+    def _deps_from_requires_text(cls, source):
+        return cls._convert_egg_info_reqs_to_simple_reqs(Sectioned.read(source))
+
+    @staticmethod
+    def _convert_egg_info_reqs_to_simple_reqs(sections):
+        """
+        Historically, setuptools would solicit and store 'extra'
+        requirements, including those with environment markers,
+        in separate sections. More modern tools expect each
+        dependency to be defined separately, with any relevant
+        extras and environment markers attached directly to that
+        requirement. This method converts the former to the
+        latter. See _test_deps_from_requires_text for an example.
+        """
+
+        def make_condition(name):
+            return name and f'extra == "{name}"'
+
+        def quoted_marker(section):
+            section = section or ''
+            extra, sep, markers = section.partition(':')
+            if extra and markers:
+                markers = f'({markers})'
+            conditions = list(filter(None, [markers, make_condition(extra)]))
+            return '; ' + ' and '.join(conditions) if conditions else ''
+
+        def url_req_space(req):
+            """
+            PEP 508 requires a space between the url_spec and the quoted_marker.
+            Ref python/importlib_metadata#357.
+            """
+            # '@' is uniquely indicative of a url_req.
+            return ' ' * ('@' in req)
+
+        for section in sections:
+            space = url_req_space(section.value)
+            yield section.value + space + quoted_marker(section.name)
+
+
+class DistributionFinder(MetaPathFinder):
+    """
+    A MetaPathFinder capable of discovering installed distributions.
+    """
+
+    class Context:
+        """
+        Keyword arguments presented by the caller to
+        ``distributions()`` or ``Distribution.discover()``
+        to narrow the scope of a search for distributions
+        in all DistributionFinders.
+
+        Each DistributionFinder may expect any parameters
+        and should attempt to honor the canonical
+        parameters defined below when appropriate.
+        """
+
+        name = None
+        """
+        Specific name for which a distribution finder should match.
+        A name of ``None`` matches all distributions.
+        """
+
+        def __init__(self, **kwargs):
+            vars(self).update(kwargs)
+
+        @property
+        def path(self):
+            """
+            The sequence of directory path that a distribution finder
+            should search.
+
+            Typically refers to Python installed package paths such as
+            "site-packages" directories and defaults to ``sys.path``.
+            """
+            return vars(self).get('path', sys.path)
+
+    @abc.abstractmethod
+    def find_distributions(self, context=Context()):
+        """
+        Find distributions.
+
+        Return an iterable of all Distribution instances capable of
+        loading the metadata for packages matching the ``context``,
+        a DistributionFinder.Context instance.
+        """
+
+
+class FastPath:
+    """
+    Micro-optimized class for searching a path for
+    children.
+
+    >>> FastPath('').children()
+    ['...']
+    """
+
+    @functools.lru_cache()  # type: ignore
+    def __new__(cls, root):
+        return super().__new__(cls)
+
+    def __init__(self, root):
+        self.root = root
+
+    def joinpath(self, child):
+        return pathlib.Path(self.root, child)
+
+    def children(self):
+        with suppress(Exception):
+            return os.listdir(self.root or '.')
+        with suppress(Exception):
+            return self.zip_children()
+        return []
+
+    def zip_children(self):
+        zip_path = zipp.Path(self.root)
+        names = zip_path.root.namelist()
+        self.joinpath = zip_path.joinpath
+
+        return dict.fromkeys(child.split(posixpath.sep, 1)[0] for child in names)
+
+    def search(self, name):
+        return self.lookup(self.mtime).search(name)
+
+    @property
+    def mtime(self):
+        with suppress(OSError):
+            return os.stat(self.root).st_mtime
+        self.lookup.cache_clear()
+
+    @method_cache
+    def lookup(self, mtime):
+        return Lookup(self)
+
+
+class Lookup:
+    def __init__(self, path: FastPath):
+        base = os.path.basename(path.root).lower()
+        base_is_egg = base.endswith(".egg")
+        self.infos = FreezableDefaultDict(list)
+        self.eggs = FreezableDefaultDict(list)
+
+        for child in path.children():
+            low = child.lower()
+            if low.endswith((".dist-info", ".egg-info")):
+                # rpartition is faster than splitext and suitable for this purpose.
+                name = low.rpartition(".")[0].partition("-")[0]
+                normalized = Prepared.normalize(name)
+                self.infos[normalized].append(path.joinpath(child))
+            elif base_is_egg and low == "egg-info":
+                name = base.rpartition(".")[0].partition("-")[0]
+                legacy_normalized = Prepared.legacy_normalize(name)
+                self.eggs[legacy_normalized].append(path.joinpath(child))
+
+        self.infos.freeze()
+        self.eggs.freeze()
+
+    def search(self, prepared):
+        infos = (
+            self.infos[prepared.normalized]
+            if prepared
+            else itertools.chain.from_iterable(self.infos.values())
+        )
+        eggs = (
+            self.eggs[prepared.legacy_normalized]
+            if prepared
+            else itertools.chain.from_iterable(self.eggs.values())
+        )
+        return itertools.chain(infos, eggs)
+
+
+class Prepared:
+    """
+    A prepared search for metadata on a possibly-named package.
+    """
+
+    normalized = None
+    legacy_normalized = None
+
+    def __init__(self, name):
+        self.name = name
+        if name is None:
+            return
+        self.normalized = self.normalize(name)
+        self.legacy_normalized = self.legacy_normalize(name)
+
+    @staticmethod
+    def normalize(name):
+        """
+        PEP 503 normalization plus dashes as underscores.
+        """
+        return re.sub(r"[-_.]+", "-", name).lower().replace('-', '_')
+
+    @staticmethod
+    def legacy_normalize(name):
+        """
+        Normalize the package name as found in the convention in
+        older packaging tools versions and specs.
+        """
+        return name.lower().replace('-', '_')
+
+    def __bool__(self):
+        return bool(self.name)
+
+
+@install
+class MetadataPathFinder(NullFinder, DistributionFinder):
+    """A degenerate finder for distribution packages on the file system.
+
+    This finder supplies only a find_distributions() method for versions
+    of Python that do not have a PathFinder find_distributions().
+    """
+
+    def find_distributions(self, context=DistributionFinder.Context()):
+        """
+        Find distributions.
+
+        Return an iterable of all Distribution instances capable of
+        loading the metadata for packages matching ``context.name``
+        (or all names if ``None`` indicated) along the paths in the list
+        of directories ``context.path``.
+        """
+        found = self._search_paths(context.name, context.path)
+        return map(PathDistribution, found)
+
+    @classmethod
+    def _search_paths(cls, name, paths):
+        """Find metadata directories in paths heuristically."""
+        prepared = Prepared(name)
+        return itertools.chain.from_iterable(
+            path.search(prepared) for path in map(FastPath, paths)
+        )
+
+    def invalidate_caches(cls):
+        FastPath.__new__.cache_clear()
+
+
+class PathDistribution(Distribution):
+    def __init__(self, path: SimplePath):
+        """Construct a distribution.
+
+        :param path: SimplePath indicating the metadata directory.
+        """
+        self._path = path
+
+    def read_text(self, filename):
+        with suppress(
+            FileNotFoundError,
+            IsADirectoryError,
+            KeyError,
+            NotADirectoryError,
+            PermissionError,
+        ):
+            return self._path.joinpath(filename).read_text(encoding='utf-8')
+
+    read_text.__doc__ = Distribution.read_text.__doc__
+
+    def locate_file(self, path):
+        return self._path.parent / path
+
+    @property
+    def _normalized_name(self):
+        """
+        Performance optimization: where possible, resolve the
+        normalized name from the file system path.
+        """
+        stem = os.path.basename(str(self._path))
+        return (
+            pass_none(Prepared.normalize)(self._name_from_stem(stem))
+            or super()._normalized_name
+        )
+
+    @staticmethod
+    def _name_from_stem(stem):
+        """
+        >>> PathDistribution._name_from_stem('foo-3.0.egg-info')
+        'foo'
+        >>> PathDistribution._name_from_stem('CherryPy-3.0.dist-info')
+        'CherryPy'
+        >>> PathDistribution._name_from_stem('face.egg-info')
+        'face'
+        >>> PathDistribution._name_from_stem('foo.bar')
+        """
+        filename, ext = os.path.splitext(stem)
+        if ext not in ('.dist-info', '.egg-info'):
+            return
+        name, sep, rest = filename.partition('-')
+        return name
+
+
+def distribution(distribution_name):
+    """Get the ``Distribution`` instance for the named package.
+
+    :param distribution_name: The name of the distribution package as a string.
+    :return: A ``Distribution`` instance (or subclass thereof).
+    """
+    return Distribution.from_name(distribution_name)
+
+
+def distributions(**kwargs):
+    """Get all ``Distribution`` instances in the current environment.
+
+    :return: An iterable of ``Distribution`` instances.
+    """
+    return Distribution.discover(**kwargs)
+
+
+def metadata(distribution_name) -> _meta.PackageMetadata:
+    """Get the metadata for the named package.
+
+    :param distribution_name: The name of the distribution package to query.
+    :return: A PackageMetadata containing the parsed metadata.
+    """
+    return Distribution.from_name(distribution_name).metadata
+
+
+def version(distribution_name):
+    """Get the version string for the named package.
+
+    :param distribution_name: The name of the distribution package to query.
+    :return: The version string for the package as defined in the package's
+        "Version" metadata key.
+    """
+    return distribution(distribution_name).version
+
+
+_unique = functools.partial(
+    unique_everseen,
+    key=_py39compat.normalized_name,
+)
+"""
+Wrapper for ``distributions`` to return unique distributions by name.
+"""
+
+
+def entry_points(**params) -> EntryPoints:
+    """Return EntryPoint objects for all installed packages.
+
+    Pass selection parameters (group or name) to filter the
+    result to entry points matching those properties (see
+    EntryPoints.select()).
+
+    :return: EntryPoints for all installed packages.
+    """
+    eps = itertools.chain.from_iterable(
+        dist.entry_points for dist in _unique(distributions())
+    )
+    return EntryPoints(eps).select(**params)
+
+
+def files(distribution_name):
+    """Return a list of files for the named package.
+
+    :param distribution_name: The name of the distribution package to query.
+    :return: List of files composing the distribution.
+    """
+    return distribution(distribution_name).files
+
+
+def requires(distribution_name):
+    """
+    Return a list of requirements for the named package.
+
+    :return: An iterator of requirements, suitable for
+        packaging.requirement.Requirement.
+    """
+    return distribution(distribution_name).requires
+
+
+def packages_distributions() -> Mapping[str, List[str]]:
+    """
+    Return a mapping of top-level packages to their
+    distributions.
+
+    >>> import collections.abc
+    >>> pkgs = packages_distributions()
+    >>> all(isinstance(dist, collections.abc.Sequence) for dist in pkgs.values())
+    True
+    """
+    pkg_to_dist = collections.defaultdict(list)
+    for dist in distributions():
+        for pkg in _top_level_declared(dist) or _top_level_inferred(dist):
+            pkg_to_dist[pkg].append(dist.metadata['Name'])
+    return dict(pkg_to_dist)
+
+
+def _top_level_declared(dist):
+    return (dist.read_text('top_level.txt') or '').split()
+
+
+def _top_level_inferred(dist):
+    return {
+        f.parts[0] if len(f.parts) > 1 else f.with_suffix('').name
+        for f in always_iterable(dist.files)
+        if f.suffix == ".py"
+    }
diff --git a/lib/importlib_metadata/_adapters.py b/lib/importlib_metadata/_adapters.py
new file mode 100644
index 00000000..e33cba5e
--- /dev/null
+++ b/lib/importlib_metadata/_adapters.py
@@ -0,0 +1,90 @@
+import functools
+import warnings
+import re
+import textwrap
+import email.message
+
+from ._text import FoldedCase
+from ._compat import pypy_partial
+
+
+# Do not remove prior to 2024-01-01 or Python 3.14
+_warn = functools.partial(
+    warnings.warn,
+    "Implicit None on return values is deprecated and will raise KeyErrors.",
+    DeprecationWarning,
+    stacklevel=pypy_partial(2),
+)
+
+
+class Message(email.message.Message):
+    multiple_use_keys = set(
+        map(
+            FoldedCase,
+            [
+                'Classifier',
+                'Obsoletes-Dist',
+                'Platform',
+                'Project-URL',
+                'Provides-Dist',
+                'Provides-Extra',
+                'Requires-Dist',
+                'Requires-External',
+                'Supported-Platform',
+                'Dynamic',
+            ],
+        )
+    )
+    """
+    Keys that may be indicated multiple times per PEP 566.
+    """
+
+    def __new__(cls, orig: email.message.Message):
+        res = super().__new__(cls)
+        vars(res).update(vars(orig))
+        return res
+
+    def __init__(self, *args, **kwargs):
+        self._headers = self._repair_headers()
+
+    # suppress spurious error from mypy
+    def __iter__(self):
+        return super().__iter__()
+
+    def __getitem__(self, item):
+        """
+        Warn users that a ``KeyError`` can be expected when a
+        mising key is supplied. Ref python/importlib_metadata#371.
+        """
+        res = super().__getitem__(item)
+        if res is None:
+            _warn()
+        return res
+
+    def _repair_headers(self):
+        def redent(value):
+            "Correct for RFC822 indentation"
+            if not value or '\n' not in value:
+                return value
+            return textwrap.dedent(' ' * 8 + value)
+
+        headers = [(key, redent(value)) for key, value in vars(self)['_headers']]
+        if self._payload:
+            headers.append(('Description', self.get_payload()))
+        return headers
+
+    @property
+    def json(self):
+        """
+        Convert PackageMetadata to a JSON-compatible format
+        per PEP 0566.
+        """
+
+        def transform(key):
+            value = self.get_all(key) if key in self.multiple_use_keys else self[key]
+            if key == 'Keywords':
+                value = re.split(r'\s+', value)
+            tk = key.lower().replace('-', '_')
+            return tk, value
+
+        return dict(map(transform, map(FoldedCase, self)))
diff --git a/lib/importlib_metadata/_collections.py b/lib/importlib_metadata/_collections.py
new file mode 100644
index 00000000..cf0954e1
--- /dev/null
+++ b/lib/importlib_metadata/_collections.py
@@ -0,0 +1,30 @@
+import collections
+
+
+# from jaraco.collections 3.3
+class FreezableDefaultDict(collections.defaultdict):
+    """
+    Often it is desirable to prevent the mutation of
+    a default dict after its initial construction, such
+    as to prevent mutation during iteration.
+
+    >>> dd = FreezableDefaultDict(list)
+    >>> dd[0].append('1')
+    >>> dd.freeze()
+    >>> dd[1]
+    []
+    >>> len(dd)
+    1
+    """
+
+    def __missing__(self, key):
+        return getattr(self, '_frozen', super().__missing__)(key)
+
+    def freeze(self):
+        self._frozen = lambda key: self.default_factory()
+
+
+class Pair(collections.namedtuple('Pair', 'name value')):
+    @classmethod
+    def parse(cls, text):
+        return cls(*map(str.strip, text.split("=", 1)))
diff --git a/lib/importlib_metadata/_compat.py b/lib/importlib_metadata/_compat.py
new file mode 100644
index 00000000..3d78566e
--- /dev/null
+++ b/lib/importlib_metadata/_compat.py
@@ -0,0 +1,72 @@
+import sys
+import platform
+
+
+__all__ = ['install', 'NullFinder', 'Protocol']
+
+
+try:
+    from typing import Protocol
+except ImportError:  # pragma: no cover
+    # Python 3.7 compatibility
+    from typing_extensions import Protocol  # type: ignore
+
+
+def install(cls):
+    """
+    Class decorator for installation on sys.meta_path.
+
+    Adds the backport DistributionFinder to sys.meta_path and
+    attempts to disable the finder functionality of the stdlib
+    DistributionFinder.
+    """
+    sys.meta_path.append(cls())
+    disable_stdlib_finder()
+    return cls
+
+
+def disable_stdlib_finder():
+    """
+    Give the backport primacy for discovering path-based distributions
+    by monkey-patching the stdlib O_O.
+
+    See #91 for more background for rationale on this sketchy
+    behavior.
+    """
+
+    def matches(finder):
+        return getattr(
+            finder, '__module__', None
+        ) == '_frozen_importlib_external' and hasattr(finder, 'find_distributions')
+
+    for finder in filter(matches, sys.meta_path):  # pragma: nocover
+        del finder.find_distributions
+
+
+class NullFinder:
+    """
+    A "Finder" (aka "MetaClassFinder") that never finds any modules,
+    but may find distributions.
+    """
+
+    @staticmethod
+    def find_spec(*args, **kwargs):
+        return None
+
+    # In Python 2, the import system requires finders
+    # to have a find_module() method, but this usage
+    # is deprecated in Python 3 in favor of find_spec().
+    # For the purposes of this finder (i.e. being present
+    # on sys.meta_path but having no other import
+    # system functionality), the two methods are identical.
+    find_module = find_spec
+
+
+def pypy_partial(val):
+    """
+    Adjust for variable stacklevel on partial under PyPy.
+
+    Workaround for #327.
+    """
+    is_pypy = platform.python_implementation() == 'PyPy'
+    return val + is_pypy
diff --git a/lib/importlib_metadata/_functools.py b/lib/importlib_metadata/_functools.py
new file mode 100644
index 00000000..71f66bd0
--- /dev/null
+++ b/lib/importlib_metadata/_functools.py
@@ -0,0 +1,104 @@
+import types
+import functools
+
+
+# from jaraco.functools 3.3
+def method_cache(method, cache_wrapper=None):
+    """
+    Wrap lru_cache to support storing the cache data in the object instances.
+
+    Abstracts the common paradigm where the method explicitly saves an
+    underscore-prefixed protected property on first call and returns that
+    subsequently.
+
+    >>> class MyClass:
+    ...     calls = 0
+    ...
+    ...     @method_cache
+    ...     def method(self, value):
+    ...         self.calls += 1
+    ...         return value
+
+    >>> a = MyClass()
+    >>> a.method(3)
+    3
+    >>> for x in range(75):
+    ...     res = a.method(x)
+    >>> a.calls
+    75
+
+    Note that the apparent behavior will be exactly like that of lru_cache
+    except that the cache is stored on each instance, so values in one
+    instance will not flush values from another, and when an instance is
+    deleted, so are the cached values for that instance.
+
+    >>> b = MyClass()
+    >>> for x in range(35):
+    ...     res = b.method(x)
+    >>> b.calls
+    35
+    >>> a.method(0)
+    0
+    >>> a.calls
+    75
+
+    Note that if method had been decorated with ``functools.lru_cache()``,
+    a.calls would have been 76 (due to the cached value of 0 having been
+    flushed by the 'b' instance).
+
+    Clear the cache with ``.cache_clear()``
+
+    >>> a.method.cache_clear()
+
+    Same for a method that hasn't yet been called.
+
+    >>> c = MyClass()
+    >>> c.method.cache_clear()
+
+    Another cache wrapper may be supplied:
+
+    >>> cache = functools.lru_cache(maxsize=2)
+    >>> MyClass.method2 = method_cache(lambda self: 3, cache_wrapper=cache)
+    >>> a = MyClass()
+    >>> a.method2()
+    3
+
+    Caution - do not subsequently wrap the method with another decorator, such
+    as ``@property``, which changes the semantics of the function.
+
+    See also
+    http://code.activestate.com/recipes/577452-a-memoize-decorator-for-instance-methods/
+    for another implementation and additional justification.
+    """
+    cache_wrapper = cache_wrapper or functools.lru_cache()
+
+    def wrapper(self, *args, **kwargs):
+        # it's the first call, replace the method with a cached, bound method
+        bound_method = types.MethodType(method, self)
+        cached_method = cache_wrapper(bound_method)
+        setattr(self, method.__name__, cached_method)
+        return cached_method(*args, **kwargs)
+
+    # Support cache clear even before cache has been created.
+    wrapper.cache_clear = lambda: None
+
+    return wrapper
+
+
+# From jaraco.functools 3.3
+def pass_none(func):
+    """
+    Wrap func so it's not called if its first param is None
+
+    >>> print_text = pass_none(print)
+    >>> print_text('text')
+    text
+    >>> print_text(None)
+    """
+
+    @functools.wraps(func)
+    def wrapper(param, *args, **kwargs):
+        if param is not None:
+            return func(param, *args, **kwargs)
+
+    return wrapper
diff --git a/lib/importlib_metadata/_itertools.py b/lib/importlib_metadata/_itertools.py
new file mode 100644
index 00000000..d4ca9b91
--- /dev/null
+++ b/lib/importlib_metadata/_itertools.py
@@ -0,0 +1,73 @@
+from itertools import filterfalse
+
+
+def unique_everseen(iterable, key=None):
+    "List unique elements, preserving order. Remember all elements ever seen."
+    # unique_everseen('AAAABBBCCDAABBB') --> A B C D
+    # unique_everseen('ABBCcAD', str.lower) --> A B C D
+    seen = set()
+    seen_add = seen.add
+    if key is None:
+        for element in filterfalse(seen.__contains__, iterable):
+            seen_add(element)
+            yield element
+    else:
+        for element in iterable:
+            k = key(element)
+            if k not in seen:
+                seen_add(k)
+                yield element
+
+
+# copied from more_itertools 8.8
+def always_iterable(obj, base_type=(str, bytes)):
+    """If *obj* is iterable, return an iterator over its items::
+
+        >>> obj = (1, 2, 3)
+        >>> list(always_iterable(obj))
+        [1, 2, 3]
+
+    If *obj* is not iterable, return a one-item iterable containing *obj*::
+
+        >>> obj = 1
+        >>> list(always_iterable(obj))
+        [1]
+
+    If *obj* is ``None``, return an empty iterable:
+
+        >>> obj = None
+        >>> list(always_iterable(None))
+        []
+
+    By default, binary and text strings are not considered iterable::
+
+        >>> obj = 'foo'
+        >>> list(always_iterable(obj))
+        ['foo']
+
+    If *base_type* is set, objects for which ``isinstance(obj, base_type)``
+    returns ``True`` won't be considered iterable.
+
+        >>> obj = {'a': 1}
+        >>> list(always_iterable(obj))  # Iterate over the dict's keys
+        ['a']
+        >>> list(always_iterable(obj, base_type=dict))  # Treat dicts as a unit
+        [{'a': 1}]
+
+    Set *base_type* to ``None`` to avoid any special handling and treat objects
+    Python considers iterable as iterable:
+
+        >>> obj = 'foo'
+        >>> list(always_iterable(obj, base_type=None))
+        ['f', 'o', 'o']
+    """
+    if obj is None:
+        return iter(())
+
+    if (base_type is not None) and isinstance(obj, base_type):
+        return iter((obj,))
+
+    try:
+        return iter(obj)
+    except TypeError:
+        return iter((obj,))
diff --git a/lib/importlib_metadata/_meta.py b/lib/importlib_metadata/_meta.py
new file mode 100644
index 00000000..259b15ba
--- /dev/null
+++ b/lib/importlib_metadata/_meta.py
@@ -0,0 +1,49 @@
+from ._compat import Protocol
+from typing import Any, Dict, Iterator, List, TypeVar, Union
+
+
+_T = TypeVar("_T")
+
+
+class PackageMetadata(Protocol):
+    def __len__(self) -> int:
+        ...  # pragma: no cover
+
+    def __contains__(self, item: str) -> bool:
+        ...  # pragma: no cover
+
+    def __getitem__(self, key: str) -> str:
+        ...  # pragma: no cover
+
+    def __iter__(self) -> Iterator[str]:
+        ...  # pragma: no cover
+
+    def get_all(self, name: str, failobj: _T = ...) -> Union[List[Any], _T]:
+        """
+        Return all values associated with a possibly multi-valued key.
+        """
+
+    @property
+    def json(self) -> Dict[str, Union[str, List[str]]]:
+        """
+        A JSON-compatible form of the metadata.
+        """
+
+
+class SimplePath(Protocol[_T]):
+    """
+    A minimal subset of pathlib.Path required by PathDistribution.
+    """
+
+    def joinpath(self) -> _T:
+        ...  # pragma: no cover
+
+    def __truediv__(self, other: Union[str, _T]) -> _T:
+        ...  # pragma: no cover
+
+    @property
+    def parent(self) -> _T:
+        ...  # pragma: no cover
+
+    def read_text(self) -> str:
+        ...  # pragma: no cover
diff --git a/lib/importlib_metadata/_py39compat.py b/lib/importlib_metadata/_py39compat.py
new file mode 100644
index 00000000..cde4558f
--- /dev/null
+++ b/lib/importlib_metadata/_py39compat.py
@@ -0,0 +1,35 @@
+"""
+Compatibility layer with Python 3.8/3.9
+"""
+from typing import TYPE_CHECKING, Any, Optional
+
+if TYPE_CHECKING:  # pragma: no cover
+    # Prevent circular imports on runtime.
+    from . import Distribution, EntryPoint
+else:
+    Distribution = EntryPoint = Any
+
+
+def normalized_name(dist: Distribution) -> Optional[str]:
+    """
+    Honor name normalization for distributions that don't provide ``_normalized_name``.
+    """
+    try:
+        return dist._normalized_name
+    except AttributeError:
+        from . import Prepared  # -> delay to prevent circular imports.
+
+        return Prepared.normalize(getattr(dist, "name", None) or dist.metadata['Name'])
+
+
+def ep_matches(ep: EntryPoint, **params) -> bool:
+    """
+    Workaround for ``EntryPoint`` objects without the ``matches`` method.
+    """
+    try:
+        return ep.matches(**params)
+    except AttributeError:
+        from . import EntryPoint  # -> delay to prevent circular imports.
+
+        # Reconstruct the EntryPoint object to make sure it is compatible.
+        return EntryPoint(ep.name, ep.value, ep.group).matches(**params)
diff --git a/lib/importlib_metadata/_text.py b/lib/importlib_metadata/_text.py
new file mode 100644
index 00000000..c88cfbb2
--- /dev/null
+++ b/lib/importlib_metadata/_text.py
@@ -0,0 +1,99 @@
+import re
+
+from ._functools import method_cache
+
+
+# from jaraco.text 3.5
+class FoldedCase(str):
+    """
+    A case insensitive string class; behaves just like str
+    except compares equal when the only variation is case.
+
+    >>> s = FoldedCase('hello world')
+
+    >>> s == 'Hello World'
+    True
+
+    >>> 'Hello World' == s
+    True
+
+    >>> s != 'Hello World'
+    False
+
+    >>> s.index('O')
+    4
+
+    >>> s.split('O')
+    ['hell', ' w', 'rld']
+
+    >>> sorted(map(FoldedCase, ['GAMMA', 'alpha', 'Beta']))
+    ['alpha', 'Beta', 'GAMMA']
+
+    Sequence membership is straightforward.
+
+    >>> "Hello World" in [s]
+    True
+    >>> s in ["Hello World"]
+    True
+
+    You may test for set inclusion, but candidate and elements
+    must both be folded.
+
+    >>> FoldedCase("Hello World") in {s}
+    True
+    >>> s in {FoldedCase("Hello World")}
+    True
+
+    String inclusion works as long as the FoldedCase object
+    is on the right.
+
+    >>> "hello" in FoldedCase("Hello World")
+    True
+
+    But not if the FoldedCase object is on the left:
+
+    >>> FoldedCase('hello') in 'Hello World'
+    False
+
+    In that case, use in_:
+
+    >>> FoldedCase('hello').in_('Hello World')
+    True
+
+    >>> FoldedCase('hello') > FoldedCase('Hello')
+    False
+    """
+
+    def __lt__(self, other):
+        return self.lower() < other.lower()
+
+    def __gt__(self, other):
+        return self.lower() > other.lower()
+
+    def __eq__(self, other):
+        return self.lower() == other.lower()
+
+    def __ne__(self, other):
+        return self.lower() != other.lower()
+
+    def __hash__(self):
+        return hash(self.lower())
+
+    def __contains__(self, other):
+        return super().lower().__contains__(other.lower())
+
+    def in_(self, other):
+        "Does self appear in other?"
+        return self in FoldedCase(other)
+
+    # cache lower since it's likely to be called frequently.
+    @method_cache
+    def lower(self):
+        return super().lower()
+
+    def index(self, sub):
+        return self.lower().index(sub.lower())
+
+    def split(self, splitter=' ', maxsplit=0):
+        pattern = re.compile(re.escape(splitter), re.I)
+        return pattern.split(self, maxsplit)
diff --git a/lib/importlib_metadata/py.typed b/lib/importlib_metadata/py.typed
new file mode 100644
index 00000000..e69de29b
diff --git a/lib/importlib_resources/__init__.py b/lib/importlib_resources/__init__.py
new file mode 100644
index 00000000..e6b60c18
--- /dev/null
+++ b/lib/importlib_resources/__init__.py
@@ -0,0 +1,17 @@
+"""Read resources contained within a package."""
+
+from ._common import (
+    as_file,
+    files,
+    Package,
+)
+
+from .abc import ResourceReader
+
+
+__all__ = [
+    'Package',
+    'ResourceReader',
+    'as_file',
+    'files',
+]
diff --git a/lib/importlib_resources/_adapters.py b/lib/importlib_resources/_adapters.py
new file mode 100644
index 00000000..50688fbb
--- /dev/null
+++ b/lib/importlib_resources/_adapters.py
@@ -0,0 +1,168 @@
+from contextlib import suppress
+from io import TextIOWrapper
+
+from . import abc
+
+
+class SpecLoaderAdapter:
+    """
+    Adapt a package spec to adapt the underlying loader.
+    """
+
+    def __init__(self, spec, adapter=lambda spec: spec.loader):
+        self.spec = spec
+        self.loader = adapter(spec)
+
+    def __getattr__(self, name):
+        return getattr(self.spec, name)
+
+
+class TraversableResourcesLoader:
+    """
+    Adapt a loader to provide TraversableResources.
+    """
+
+    def __init__(self, spec):
+        self.spec = spec
+
+    def get_resource_reader(self, name):
+        return CompatibilityFiles(self.spec)._native()
+
+
+def _io_wrapper(file, mode='r', *args, **kwargs):
+    if mode == 'r':
+        return TextIOWrapper(file, *args, **kwargs)
+    elif mode == 'rb':
+        return file
+    raise ValueError(f"Invalid mode value '{mode}', only 'r' and 'rb' are supported")
+
+
+class CompatibilityFiles:
+    """
+    Adapter for an existing or non-existent resource reader
+    to provide a compatibility .files().
+    """
+
+    class SpecPath(abc.Traversable):
+        """
+        Path tied to a module spec.
+        Can be read and exposes the resource reader children.
+        """
+
+        def __init__(self, spec, reader):
+            self._spec = spec
+            self._reader = reader
+
+        def iterdir(self):
+            if not self._reader:
+                return iter(())
+            return iter(
+                CompatibilityFiles.ChildPath(self._reader, path)
+                for path in self._reader.contents()
+            )
+
+        def is_file(self):
+            return False
+
+        is_dir = is_file
+
+        def joinpath(self, other):
+            if not self._reader:
+                return CompatibilityFiles.OrphanPath(other)
+            return CompatibilityFiles.ChildPath(self._reader, other)
+
+        @property
+        def name(self):
+            return self._spec.name
+
+        def open(self, mode='r', *args, **kwargs):
+            return _io_wrapper(self._reader.open_resource(None), mode, *args, **kwargs)
+
+    class ChildPath(abc.Traversable):
+        """
+        Path tied to a resource reader child.
+        Can be read but doesn't expose any meaningful children.
+        """
+
+        def __init__(self, reader, name):
+            self._reader = reader
+            self._name = name
+
+        def iterdir(self):
+            return iter(())
+
+        def is_file(self):
+            return self._reader.is_resource(self.name)
+
+        def is_dir(self):
+            return not self.is_file()
+
+        def joinpath(self, other):
+            return CompatibilityFiles.OrphanPath(self.name, other)
+
+        @property
+        def name(self):
+            return self._name
+
+        def open(self, mode='r', *args, **kwargs):
+            return _io_wrapper(
+                self._reader.open_resource(self.name), mode, *args, **kwargs
+            )
+
+    class OrphanPath(abc.Traversable):
+        """
+        Orphan path, not tied to a module spec or resource reader.
+        Can't be read and doesn't expose any meaningful children.
+        """
+
+        def __init__(self, *path_parts):
+            if len(path_parts) < 1:
+                raise ValueError('Need at least one path part to construct a path')
+            self._path = path_parts
+
+        def iterdir(self):
+            return iter(())
+
+        def is_file(self):
+            return False
+
+        is_dir = is_file
+
+        def joinpath(self, other):
+            return CompatibilityFiles.OrphanPath(*self._path, other)
+
+        @property
+        def name(self):
+            return self._path[-1]
+
+        def open(self, mode='r', *args, **kwargs):
+            raise FileNotFoundError("Can't open orphan path")
+
+    def __init__(self, spec):
+        self.spec = spec
+
+    @property
+    def _reader(self):
+        with suppress(AttributeError):
+            return self.spec.loader.get_resource_reader(self.spec.name)
+
+    def _native(self):
+        """
+        Return the native reader if it supports files().
+        """
+        reader = self._reader
+        return reader if hasattr(reader, 'files') else self
+
+    def __getattr__(self, attr):
+        return getattr(self._reader, attr)
+
+    def files(self):
+        return CompatibilityFiles.SpecPath(self.spec, self._reader)
+
+
+def wrap_spec(package):
+    """
+    Construct a package spec with traversable compatibility
+    on the spec/loader/reader.
+    """
+    return SpecLoaderAdapter(package.__spec__, TraversableResourcesLoader)
diff --git a/lib/importlib_resources/_common.py b/lib/importlib_resources/_common.py
new file mode 100644
index 00000000..3c6de1cf
--- /dev/null
+++ b/lib/importlib_resources/_common.py
@@ -0,0 +1,207 @@
+import os
+import pathlib
+import tempfile
+import functools
+import contextlib
+import types
+import importlib
+import inspect
+import warnings
+import itertools
+
+from typing import Union, Optional, cast
+from .abc import ResourceReader, Traversable
+
+from ._compat import wrap_spec
+
+Package = Union[types.ModuleType, str]
+Anchor = Package
+
+
+def package_to_anchor(func):
+    """
+    Replace 'package' parameter as 'anchor' and warn about the change.
+
+    Other errors should fall through.
+
+    >>> files('a', 'b')
+    Traceback (most recent call last):
+    TypeError: files() takes from 0 to 1 positional arguments but 2 were given
+    """
+    undefined = object()
+
+    @functools.wraps(func)
+    def wrapper(anchor=undefined, package=undefined):
+        if package is not undefined:
+            if anchor is not undefined:
+                return func(anchor, package)
+            warnings.warn(
+                "First parameter to files is renamed to 'anchor'",
+                DeprecationWarning,
+                stacklevel=2,
+            )
+            return func(package)
+        elif anchor is undefined:
+            return func()
+        return func(anchor)
+
+    return wrapper
+
+
+@package_to_anchor
+def files(anchor: Optional[Anchor] = None) -> Traversable:
+    """
+    Get a Traversable resource for an anchor.
+    """
+    return from_package(resolve(anchor))
+
+
+def get_resource_reader(package: types.ModuleType) -> Optional[ResourceReader]:
+    """
+    Return the package's loader if it's a ResourceReader.
+    """
+    # We can't use
+    # a issubclass() check here because apparently abc.'s __subclasscheck__()
+    # hook wants to create a weak reference to the object, but
+    # zipimport.zipimporter does not support weak references, resulting in a
+    # TypeError.  That seems terrible.
+    spec = package.__spec__
+    reader = getattr(spec.loader, 'get_resource_reader', None)  # type: ignore
+    if reader is None:
+        return None
+    return reader(spec.name)  # type: ignore
+
+
+@functools.singledispatch
+def resolve(cand: Optional[Anchor]) -> types.ModuleType:
+    return cast(types.ModuleType, cand)
+
+
+@resolve.register
+def _(cand: str) -> types.ModuleType:
+    return importlib.import_module(cand)
+
+
+@resolve.register
+def _(cand: None) -> types.ModuleType:
+    return resolve(_infer_caller().f_globals['__name__'])
+
+
+def _infer_caller():
+    """
+    Walk the stack and find the frame of the first caller not in this module.
+    """
+
+    def is_this_file(frame_info):
+        return frame_info.filename == __file__
+
+    def is_wrapper(frame_info):
+        return frame_info.function == 'wrapper'
+
+    not_this_file = itertools.filterfalse(is_this_file, inspect.stack())
+    # also exclude 'wrapper' due to singledispatch in the call stack
+    callers = itertools.filterfalse(is_wrapper, not_this_file)
+    return next(callers).frame
+
+
+def from_package(package: types.ModuleType):
+    """
+    Return a Traversable object for the given package.
+
+    """
+    spec = wrap_spec(package)
+    reader = spec.loader.get_resource_reader(spec.name)
+    return reader.files()
+
+
+@contextlib.contextmanager
+def _tempfile(
+    reader,
+    suffix='',
+    # gh-93353: Keep a reference to call os.remove() in late Python
+    # finalization.
+    *,
+    _os_remove=os.remove,
+):
+    # Not using tempfile.NamedTemporaryFile as it leads to deeper 'try'
+    # blocks due to the need to close the temporary file to work on Windows
+    # properly.
+    fd, raw_path = tempfile.mkstemp(suffix=suffix)
+    try:
+        try:
+            os.write(fd, reader())
+        finally:
+            os.close(fd)
+        del reader
+        yield pathlib.Path(raw_path)
+    finally:
+        try:
+            _os_remove(raw_path)
+        except FileNotFoundError:
+            pass
+
+
+def _temp_file(path):
+    return _tempfile(path.read_bytes, suffix=path.name)
+
+
+def _is_present_dir(path: Traversable) -> bool:
+    """
+    Some Traversables implement ``is_dir()`` to raise an
+    exception (i.e. ``FileNotFoundError``) when the
+    directory doesn't exist. This function wraps that call
+    to always return a boolean and only return True
+    if there's a dir and it exists.
+    """
+    with contextlib.suppress(FileNotFoundError):
+        return path.is_dir()
+    return False
+
+
+@functools.singledispatch
+def as_file(path):
+    """
+    Given a Traversable object, return that object as a
+    path on the local file system in a context manager.
+    """
+    return _temp_dir(path) if _is_present_dir(path) else _temp_file(path)
+
+
+@as_file.register(pathlib.Path)
+@contextlib.contextmanager
+def _(path):
+    """
+    Degenerate behavior for pathlib.Path objects.
+    """
+    yield path
+
+
+@contextlib.contextmanager
+def _temp_path(dir: tempfile.TemporaryDirectory):
+    """
+    Wrap tempfile.TemporyDirectory to return a pathlib object.
+    """
+    with dir as result:
+        yield pathlib.Path(result)
+
+
+@contextlib.contextmanager
+def _temp_dir(path):
+    """
+    Given a traversable dir, recursively replicate the whole tree
+    to the file system in a context manager.
+    """
+    assert path.is_dir()
+    with _temp_path(tempfile.TemporaryDirectory()) as temp_dir:
+        yield _write_contents(temp_dir, path)
+
+
+def _write_contents(target, source):
+    child = target.joinpath(source.name)
+    if source.is_dir():
+        child.mkdir()
+        for item in source.iterdir():
+            _write_contents(child, item)
+    else:
+        child.write_bytes(source.read_bytes())
+    return child
diff --git a/lib/importlib_resources/_compat.py b/lib/importlib_resources/_compat.py
new file mode 100644
index 00000000..a93a8826
--- /dev/null
+++ b/lib/importlib_resources/_compat.py
@@ -0,0 +1,109 @@
+# flake8: noqa
+
+import abc
+import os
+import sys
+import pathlib
+from contextlib import suppress
+from typing import Union
+
+
+if sys.version_info >= (3, 10):
+    from zipfile import Path as ZipPath  # type: ignore
+else:
+    from zipp import Path as ZipPath  # type: ignore
+
+
+try:
+    from typing import runtime_checkable  # type: ignore
+except ImportError:
+
+    def runtime_checkable(cls):  # type: ignore
+        return cls
+
+
+try:
+    from typing import Protocol  # type: ignore
+except ImportError:
+    Protocol = abc.ABC  # type: ignore
+
+
+class TraversableResourcesLoader:
+    """
+    Adapt loaders to provide TraversableResources and other
+    compatibility.
+
+    Used primarily for Python 3.9 and earlier where the native
+    loaders do not yet implement TraversableResources.
+    """
+
+    def __init__(self, spec):
+        self.spec = spec
+
+    @property
+    def path(self):
+        return self.spec.origin
+
+    def get_resource_reader(self, name):
+        from . import readers, _adapters
+
+        def _zip_reader(spec):
+            with suppress(AttributeError):
+                return readers.ZipReader(spec.loader, spec.name)
+
+        def _namespace_reader(spec):
+            with suppress(AttributeError, ValueError):
+                return readers.NamespaceReader(spec.submodule_search_locations)
+
+        def _available_reader(spec):
+            with suppress(AttributeError):
+                return spec.loader.get_resource_reader(spec.name)
+
+        def _native_reader(spec):
+            reader = _available_reader(spec)
+            return reader if hasattr(reader, 'files') else None
+
+        def _file_reader(spec):
+            try:
+                path = pathlib.Path(self.path)
+            except TypeError:
+                return None
+            if path.exists():
+                return readers.FileReader(self)
+
+        return (
+            # local ZipReader if a zip module
+            _zip_reader(self.spec)
+            or
+            # local NamespaceReader if a namespace module
+            _namespace_reader(self.spec)
+            or
+            # local FileReader
+            _file_reader(self.spec)
+            or
+            # native reader if it supplies 'files'
+            _native_reader(self.spec)
+            or
+            # fallback - adapt the spec ResourceReader to TraversableReader
+            _adapters.CompatibilityFiles(self.spec)
+        )
+
+
+def wrap_spec(package):
+    """
+    Construct a package spec with traversable compatibility
+    on the spec/loader/reader.
+
+    Supersedes _adapters.wrap_spec to use TraversableResourcesLoader
+    from above for older Python compatibility (<3.10).
+    """
+    from . import _adapters
+
+    return _adapters.SpecLoaderAdapter(package.__spec__, TraversableResourcesLoader)
+
+
+if sys.version_info >= (3, 9):
+    StrPath = Union[str, os.PathLike[str]]
+else:
+    # PathLike is only subscriptable at runtime in 3.9+
+    StrPath = Union[str, "os.PathLike[str]"]
diff --git a/lib/importlib_resources/_itertools.py b/lib/importlib_resources/_itertools.py
new file mode 100644
index 00000000..7b775ef5
--- /dev/null
+++ b/lib/importlib_resources/_itertools.py
@@ -0,0 +1,38 @@
+# from more_itertools 9.0
+def only(iterable, default=None, too_long=None):
+    """If *iterable* has only one item, return it.
+    If it has zero items, return *default*.
+    If it has more than one item, raise the exception given by *too_long*,
+    which is ``ValueError`` by default.
+    >>> only([], default='missing')
+    'missing'
+    >>> only([1])
+    1
+    >>> only([1, 2])  # doctest: +IGNORE_EXCEPTION_DETAIL
+    Traceback (most recent call last):
+    ...
+    ValueError: Expected exactly one item in iterable, but got 1, 2,
+     and perhaps more.'
+    >>> only([1, 2], too_long=TypeError)  # doctest: +IGNORE_EXCEPTION_DETAIL
+    Traceback (most recent call last):
+    ...
+    TypeError
+    Note that :func:`only` attempts to advance *iterable* twice to ensure there
+    is only one item.  See :func:`spy` or :func:`peekable` to check
+    iterable contents less destructively.
+    """
+    it = iter(iterable)
+    first_value = next(it, default)
+
+    try:
+        second_value = next(it)
+    except StopIteration:
+        pass
+    else:
+        msg = (
+            'Expected exactly one item in iterable, but got {!r}, {!r}, '
+            'and perhaps more.'.format(first_value, second_value)
+        )
+        raise too_long or ValueError(msg)
+
+    return first_value
diff --git a/lib/importlib_resources/abc.py b/lib/importlib_resources/abc.py
new file mode 100644
index 00000000..23b6aeaf
--- /dev/null
+++ b/lib/importlib_resources/abc.py
@@ -0,0 +1,170 @@
+import abc
+import io
+import itertools
+import pathlib
+from typing import Any, BinaryIO, Iterable, Iterator, NoReturn, Text, Optional
+
+from ._compat import runtime_checkable, Protocol, StrPath
+
+
+__all__ = ["ResourceReader", "Traversable", "TraversableResources"]
+
+
+class ResourceReader(metaclass=abc.ABCMeta):
+    """Abstract base class for loaders to provide resource reading support."""
+
+    @abc.abstractmethod
+    def open_resource(self, resource: Text) -> BinaryIO:
+        """Return an opened, file-like object for binary reading.
+
+        The 'resource' argument is expected to represent only a file name.
+        If the resource cannot be found, FileNotFoundError is raised.
+        """
+        # This deliberately raises FileNotFoundError instead of
+        # NotImplementedError so that if this method is accidentally called,
+        # it'll still do the right thing.
+        raise FileNotFoundError
+
+    @abc.abstractmethod
+    def resource_path(self, resource: Text) -> Text:
+        """Return the file system path to the specified resource.
+
+        The 'resource' argument is expected to represent only a file name.
+        If the resource does not exist on the file system, raise
+        FileNotFoundError.
+        """
+        # This deliberately raises FileNotFoundError instead of
+        # NotImplementedError so that if this method is accidentally called,
+        # it'll still do the right thing.
+        raise FileNotFoundError
+
+    @abc.abstractmethod
+    def is_resource(self, path: Text) -> bool:
+        """Return True if the named 'path' is a resource.
+
+        Files are resources, directories are not.
+        """
+        raise FileNotFoundError
+
+    @abc.abstractmethod
+    def contents(self) -> Iterable[str]:
+        """Return an iterable of entries in `package`."""
+        raise FileNotFoundError
+
+
+class TraversalError(Exception):
+    pass
+
+
+@runtime_checkable
+class Traversable(Protocol):
+    """
+    An object with a subset of pathlib.Path methods suitable for
+    traversing directories and opening files.
+
+    Any exceptions that occur when accessing the backing resource
+    may propagate unaltered.
+    """
+
+    @abc.abstractmethod
+    def iterdir(self) -> Iterator["Traversable"]:
+        """
+        Yield Traversable objects in self
+        """
+
+    def read_bytes(self) -> bytes:
+        """
+        Read contents of self as bytes
+        """
+        with self.open('rb') as strm:
+            return strm.read()
+
+    def read_text(self, encoding: Optional[str] = None) -> str:
+        """
+        Read contents of self as text
+        """
+        with self.open(encoding=encoding) as strm:
+            return strm.read()
+
+    @abc.abstractmethod
+    def is_dir(self) -> bool:
+        """
+        Return True if self is a directory
+        """
+
+    @abc.abstractmethod
+    def is_file(self) -> bool:
+        """
+        Return True if self is a file
+        """
+
+    def joinpath(self, *descendants: StrPath) -> "Traversable":
+        """
+        Return Traversable resolved with any descendants applied.
+
+        Each descendant should be a path segment relative to self
+        and each may contain multiple levels separated by
+        ``posixpath.sep`` (``/``).
+        """
+        if not descendants:
+            return self
+        names = itertools.chain.from_iterable(
+            path.parts for path in map(pathlib.PurePosixPath, descendants)
+        )
+        target = next(names)
+        matches = (
+            traversable for traversable in self.iterdir() if traversable.name == target
+        )
+        try:
+            match = next(matches)
+        except StopIteration:
+            raise TraversalError(
+                "Target not found during traversal.", target, list(names)
+            )
+        return match.joinpath(*names)
+
+    def __truediv__(self, child: StrPath) -> "Traversable":
+        """
+        Return Traversable child in self
+        """
+        return self.joinpath(child)
+
+    @abc.abstractmethod
+    def open(self, mode='r', *args, **kwargs):
+        """
+        mode may be 'r' or 'rb' to open as text or binary. Return a handle
+        suitable for reading (same as pathlib.Path.open).
+
+        When opening as text, accepts encoding parameters such as those
+        accepted by io.TextIOWrapper.
+        """
+
+    @property
+    @abc.abstractmethod
+    def name(self) -> str:
+        """
+        The base name of this object without any parent references.
+        """
+
+
+class TraversableResources(ResourceReader):
+    """
+    The required interface for providing traversable
+    resources.
+    """
+
+    @abc.abstractmethod
+    def files(self) -> "Traversable":
+        """Return a Traversable object for the loaded package."""
+
+    def open_resource(self, resource: StrPath) -> io.BufferedReader:
+        return self.files().joinpath(resource).open('rb')
+
+    def resource_path(self, resource: Any) -> NoReturn:
+        raise FileNotFoundError(resource)
+
+    def is_resource(self, path: StrPath) -> bool:
+        return self.files().joinpath(path).is_file()
+
+    def contents(self) -> Iterator[str]:
+        return (item.name for item in self.files().iterdir())
diff --git a/lib/importlib_resources/py.typed b/lib/importlib_resources/py.typed
new file mode 100644
index 00000000..e69de29b
diff --git a/lib/importlib_resources/readers.py b/lib/importlib_resources/readers.py
new file mode 100644
index 00000000..51d030a6
--- /dev/null
+++ b/lib/importlib_resources/readers.py
@@ -0,0 +1,144 @@
+import collections
+import itertools
+import pathlib
+import operator
+
+from . import abc
+
+from ._itertools import only
+from ._compat import ZipPath
+
+
+def remove_duplicates(items):
+    return iter(collections.OrderedDict.fromkeys(items))
+
+
+class FileReader(abc.TraversableResources):
+    def __init__(self, loader):
+        self.path = pathlib.Path(loader.path).parent
+
+    def resource_path(self, resource):
+        """
+        Return the file system path to prevent
+        `resources.path()` from creating a temporary
+        copy.
+        """
+        return str(self.path.joinpath(resource))
+
+    def files(self):
+        return self.path
+
+
+class ZipReader(abc.TraversableResources):
+    def __init__(self, loader, module):
+        _, _, name = module.rpartition('.')
+        self.prefix = loader.prefix.replace('\\', '/') + name + '/'
+        self.archive = loader.archive
+
+    def open_resource(self, resource):
+        try:
+            return super().open_resource(resource)
+        except KeyError as exc:
+            raise FileNotFoundError(exc.args[0])
+
+    def is_resource(self, path):
+        """
+        Workaround for `zipfile.Path.is_file` returning true
+        for non-existent paths.
+        """
+        target = self.files().joinpath(path)
+        return target.is_file() and target.exists()
+
+    def files(self):
+        return ZipPath(self.archive, self.prefix)
+
+
+class MultiplexedPath(abc.Traversable):
+    """
+    Given a series of Traversable objects, implement a merged
+    version of the interface across all objects. Useful for
+    namespace packages which may be multihomed at a single
+    name.
+    """
+
+    def __init__(self, *paths):
+        self._paths = list(map(pathlib.Path, remove_duplicates(paths)))
+        if not self._paths:
+            message = 'MultiplexedPath must contain at least one path'
+            raise FileNotFoundError(message)
+        if not all(path.is_dir() for path in self._paths):
+            raise NotADirectoryError('MultiplexedPath only supports directories')
+
+    def iterdir(self):
+        children = (child for path in self._paths for child in path.iterdir())
+        by_name = operator.attrgetter('name')
+        groups = itertools.groupby(sorted(children, key=by_name), key=by_name)
+        return map(self._follow, (locs for name, locs in groups))
+
+    def read_bytes(self):
+        raise FileNotFoundError(f'{self} is not a file')
+
+    def read_text(self, *args, **kwargs):
+        raise FileNotFoundError(f'{self} is not a file')
+
+    def is_dir(self):
+        return True
+
+    def is_file(self):
+        return False
+
+    def joinpath(self, *descendants):
+        try:
+            return super().joinpath(*descendants)
+        except abc.TraversalError:
+            # One of the paths did not resolve (a directory does not exist).
+            # Just return something that will not exist.
+            return self._paths[0].joinpath(*descendants)
+
+    @classmethod
+    def _follow(cls, children):
+        """
+        Construct a MultiplexedPath if needed.
+
+        If children contains a sole element, return it.
+        Otherwise, return a MultiplexedPath of the items.
+        Unless one of the items is not a Directory, then return the first.
+        """
+        subdirs, one_dir, one_file = itertools.tee(children, 3)
+
+        try:
+            return only(one_dir)
+        except ValueError:
+            try:
+                return cls(*subdirs)
+            except NotADirectoryError:
+                return next(one_file)
+
+    def open(self, *args, **kwargs):
+        raise FileNotFoundError(f'{self} is not a file')
+
+    @property
+    def name(self):
+        return self._paths[0].name
+
+    def __repr__(self):
+        paths = ', '.join(f"'{path}'" for path in self._paths)
+        return f'MultiplexedPath({paths})'
+
+
+class NamespaceReader(abc.TraversableResources):
+    def __init__(self, namespace_path):
+        if 'NamespacePath' not in str(namespace_path):
+            raise ValueError('Invalid path')
+        self.path = MultiplexedPath(*list(namespace_path))
+
+    def resource_path(self, resource):
+        """
+        Return the file system path to prevent
+        `resources.path()` from creating a temporary
+        copy.
+        """
+        return str(self.path.joinpath(resource))
+
+    def files(self):
+        return self.path
diff --git a/lib/importlib_resources/simple.py b/lib/importlib_resources/simple.py
new file mode 100644
index 00000000..7770c922
--- /dev/null
+++ b/lib/importlib_resources/simple.py
@@ -0,0 +1,106 @@
+"""
+Interface adapters for low-level readers.
+"""
+
+import abc
+import io
+import itertools
+from typing import BinaryIO, List
+
+from .abc import Traversable, TraversableResources
+
+
+class SimpleReader(abc.ABC):
+    """
+    The minimum, low-level interface required from a resource
+    provider.
+    """
+
+    @property
+    @abc.abstractmethod
+    def package(self) -> str:
+        """
+        The name of the package for which this reader loads resources.
+        """
+
+    @abc.abstractmethod
+    def children(self) -> List['SimpleReader']:
+        """
+        Obtain an iterable of SimpleReader for available
+        child containers (e.g. directories).
+        """
+
+    @abc.abstractmethod
+    def resources(self) -> List[str]:
+        """
+        Obtain available named resources for this virtual package.
+        """
+
+    @abc.abstractmethod
+    def open_binary(self, resource: str) -> BinaryIO:
+        """
+        Obtain a File-like for a named resource.
+        """
+
+    @property
+    def name(self):
+        return self.package.split('.')[-1]
+
+
+class ResourceContainer(Traversable):
+    """
+    Traversable container for a package's resources via its reader.
+    """
+
+    def __init__(self, reader: SimpleReader):
+        self.reader = reader
+
+    def is_dir(self):
+        return True
+
+    def is_file(self):
+        return False
+
+    def iterdir(self):
+        files = (ResourceHandle(self, name) for name in self.reader.resources)
+        dirs = map(ResourceContainer, self.reader.children())
+        return itertools.chain(files, dirs)
+
+    def open(self, *args, **kwargs):
+        raise IsADirectoryError()
+
+
+class ResourceHandle(Traversable):
+    """
+    Handle to a named resource in a ResourceReader.
+    """
+
+    def __init__(self, parent: ResourceContainer, name: str):
+        self.parent = parent
+        self.name = name  # type: ignore
+
+    def is_file(self):
+        return True
+
+    def is_dir(self):
+        return False
+
+    def open(self, mode='r', *args, **kwargs):
+        stream = self.parent.reader.open_binary(self.name)
+        if 'b' not in mode:
+            stream = io.TextIOWrapper(*args, **kwargs)
+        return stream
+
+    def joinpath(self, name):
+        raise RuntimeError("Cannot traverse into a resource")
+
+
+class TraversableReader(TraversableResources, SimpleReader):
+    """
+    A TraversableResources based on SimpleReader. Resource providers
+    may derive from this class to provide the TraversableResources
+    interface by supplying the SimpleReader interface.
+    """
+
+    def files(self):
+        return ResourceContainer(self)
diff --git a/lib/importlib_resources/tests/__init__.py b/lib/importlib_resources/tests/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/lib/importlib_resources/tests/_compat.py b/lib/importlib_resources/tests/_compat.py
new file mode 100644
index 00000000..e7bf06dd
--- /dev/null
+++ b/lib/importlib_resources/tests/_compat.py
@@ -0,0 +1,32 @@
+import os
+
+
+try:
+    from test.support import import_helper  # type: ignore
+except ImportError:
+    # Python 3.9 and earlier
+    class import_helper:  # type: ignore
+        from test.support import (
+            modules_setup,
+            modules_cleanup,
+            DirsOnSysPath,
+            CleanImport,
+        )
+
+
+try:
+    from test.support import os_helper  # type: ignore
+except ImportError:
+    # Python 3.9 compat
+    class os_helper:  # type:ignore
+        from test.support import temp_dir
+
+
+try:
+    # Python 3.10
+    from test.support.os_helper import unlink
+except ImportError:
+    from test.support import unlink as _unlink
+
+    def unlink(target):
+        return _unlink(os.fspath(target))
diff --git a/lib/importlib_resources/tests/_path.py b/lib/importlib_resources/tests/_path.py
new file mode 100644
index 00000000..1f97c961
--- /dev/null
+++ b/lib/importlib_resources/tests/_path.py
@@ -0,0 +1,56 @@
+import pathlib
+import functools
+
+from typing import Dict, Union
+
+
+####
+# from jaraco.path 3.4.1
+
+FilesSpec = Dict[str, Union[str, bytes, 'FilesSpec']]  # type: ignore
+
+
+def build(spec: FilesSpec, prefix=pathlib.Path()):
+    """
+    Build a set of files/directories, as described by the spec.
+
+    Each key represents a pathname, and the value represents
+    the content. Content may be a nested directory.
+
+    >>> spec = {
+    ...     'README.txt': "A README file",
+    ...     "foo": {
+    ...         "__init__.py": "",
+    ...         "bar": {
+    ...             "__init__.py": "",
+    ...         },
+    ...         "baz.py": "# Some code",
+    ...     }
+    ... }
+    >>> target = getfixture('tmp_path')
+    >>> build(spec, target)
+    >>> target.joinpath('foo/baz.py').read_text(encoding='utf-8')
+    '# Some code'
+    """
+    for name, contents in spec.items():
+        create(contents, pathlib.Path(prefix) / name)
+
+
+@functools.singledispatch
+def create(content: Union[str, bytes, FilesSpec], path):
+    path.mkdir(exist_ok=True)
+    build(content, prefix=path)  # type: ignore
+
+
+@create.register
+def _(content: bytes, path):
+    path.write_bytes(content)
+
+
+@create.register
+def _(content: str, path):
+    path.write_text(content, encoding='utf-8')
+
+
+# end from jaraco.path
+####
diff --git a/lib/importlib_resources/tests/data01/__init__.py b/lib/importlib_resources/tests/data01/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/lib/importlib_resources/tests/data01/binary.file b/lib/importlib_resources/tests/data01/binary.file
new file mode 100644
index 0000000000000000000000000000000000000000..eaf36c1daccfdf325514461cd1a2ffbc139b5464
GIT binary patch
literal 4
LcmZQzWMT#Y01f~L

literal 0
HcmV?d00001

diff --git a/lib/importlib_resources/tests/data01/subdirectory/__init__.py b/lib/importlib_resources/tests/data01/subdirectory/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/lib/importlib_resources/tests/data01/subdirectory/binary.file b/lib/importlib_resources/tests/data01/subdirectory/binary.file
new file mode 100644
index 0000000000000000000000000000000000000000..eaf36c1daccfdf325514461cd1a2ffbc139b5464
GIT binary patch
literal 4
LcmZQzWMT#Y01f~L

literal 0
HcmV?d00001

diff --git a/lib/importlib_resources/tests/data01/utf-16.file b/lib/importlib_resources/tests/data01/utf-16.file
new file mode 100644
index 0000000000000000000000000000000000000000..2cb772295ef4b480a8d83725bd5006a0236d8f68
GIT binary patch
literal 44
ucmezW&x0YAAqNQa8FUyF7(y9B7~B|i84MZBfV^^`Xc15@g+Y;liva-T)Ce>H

literal 0
HcmV?d00001

diff --git a/lib/importlib_resources/tests/data01/utf-8.file b/lib/importlib_resources/tests/data01/utf-8.file
new file mode 100644
index 00000000..1c0132ad
--- /dev/null
+++ b/lib/importlib_resources/tests/data01/utf-8.file
@@ -0,0 +1 @@
+Hello, UTF-8 world!
diff --git a/lib/importlib_resources/tests/data02/__init__.py b/lib/importlib_resources/tests/data02/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/lib/importlib_resources/tests/data02/one/__init__.py b/lib/importlib_resources/tests/data02/one/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/lib/importlib_resources/tests/data02/one/resource1.txt b/lib/importlib_resources/tests/data02/one/resource1.txt
new file mode 100644
index 00000000..61a813e4
--- /dev/null
+++ b/lib/importlib_resources/tests/data02/one/resource1.txt
@@ -0,0 +1 @@
+one resource
diff --git a/lib/importlib_resources/tests/data02/subdirectory/subsubdir/resource.txt b/lib/importlib_resources/tests/data02/subdirectory/subsubdir/resource.txt
new file mode 100644
index 00000000..48f587a2
--- /dev/null
+++ b/lib/importlib_resources/tests/data02/subdirectory/subsubdir/resource.txt
@@ -0,0 +1 @@
+a resource
\ No newline at end of file
diff --git a/lib/importlib_resources/tests/data02/two/__init__.py b/lib/importlib_resources/tests/data02/two/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/lib/importlib_resources/tests/data02/two/resource2.txt b/lib/importlib_resources/tests/data02/two/resource2.txt
new file mode 100644
index 00000000..a80ce46e
--- /dev/null
+++ b/lib/importlib_resources/tests/data02/two/resource2.txt
@@ -0,0 +1 @@
+two resource
diff --git a/lib/importlib_resources/tests/namespacedata01/binary.file b/lib/importlib_resources/tests/namespacedata01/binary.file
new file mode 100644
index 0000000000000000000000000000000000000000..eaf36c1daccfdf325514461cd1a2ffbc139b5464
GIT binary patch
literal 4
LcmZQzWMT#Y01f~L

literal 0
HcmV?d00001

diff --git a/lib/importlib_resources/tests/namespacedata01/utf-16.file b/lib/importlib_resources/tests/namespacedata01/utf-16.file
new file mode 100644
index 0000000000000000000000000000000000000000..2cb772295ef4b480a8d83725bd5006a0236d8f68
GIT binary patch
literal 44
ucmezW&x0YAAqNQa8FUyF7(y9B7~B|i84MZBfV^^`Xc15@g+Y;liva-T)Ce>H

literal 0
HcmV?d00001

diff --git a/lib/importlib_resources/tests/namespacedata01/utf-8.file b/lib/importlib_resources/tests/namespacedata01/utf-8.file
new file mode 100644
index 00000000..1c0132ad
--- /dev/null
+++ b/lib/importlib_resources/tests/namespacedata01/utf-8.file
@@ -0,0 +1 @@
+Hello, UTF-8 world!
diff --git a/lib/importlib_resources/tests/test_compatibilty_files.py b/lib/importlib_resources/tests/test_compatibilty_files.py
new file mode 100644
index 00000000..13ad0dfb
--- /dev/null
+++ b/lib/importlib_resources/tests/test_compatibilty_files.py
@@ -0,0 +1,104 @@
+import io
+import unittest
+
+import importlib_resources as resources
+
+from importlib_resources._adapters import (
+    CompatibilityFiles,
+    wrap_spec,
+)
+
+from . import util
+
+
+class CompatibilityFilesTests(unittest.TestCase):
+    @property
+    def package(self):
+        bytes_data = io.BytesIO(b'Hello, world!')
+        return util.create_package(
+            file=bytes_data,
+            path='some_path',
+            contents=('a', 'b', 'c'),
+        )
+
+    @property
+    def files(self):
+        return resources.files(self.package)
+
+    def test_spec_path_iter(self):
+        self.assertEqual(
+            sorted(path.name for path in self.files.iterdir()),
+            ['a', 'b', 'c'],
+        )
+
+    def test_child_path_iter(self):
+        self.assertEqual(list((self.files / 'a').iterdir()), [])
+
+    def test_orphan_path_iter(self):
+        self.assertEqual(list((self.files / 'a' / 'a').iterdir()), [])
+        self.assertEqual(list((self.files / 'a' / 'a' / 'a').iterdir()), [])
+
+    def test_spec_path_is(self):
+        self.assertFalse(self.files.is_file())
+        self.assertFalse(self.files.is_dir())
+
+    def test_child_path_is(self):
+        self.assertTrue((self.files / 'a').is_file())
+        self.assertFalse((self.files / 'a').is_dir())
+
+    def test_orphan_path_is(self):
+        self.assertFalse((self.files / 'a' / 'a').is_file())
+        self.assertFalse((self.files / 'a' / 'a').is_dir())
+        self.assertFalse((self.files / 'a' / 'a' / 'a').is_file())
+        self.assertFalse((self.files / 'a' / 'a' / 'a').is_dir())
+
+    def test_spec_path_name(self):
+        self.assertEqual(self.files.name, 'testingpackage')
+
+    def test_child_path_name(self):
+        self.assertEqual((self.files / 'a').name, 'a')
+
+    def test_orphan_path_name(self):
+        self.assertEqual((self.files / 'a' / 'b').name, 'b')
+        self.assertEqual((self.files / 'a' / 'b' / 'c').name, 'c')
+
+    def test_spec_path_open(self):
+        self.assertEqual(self.files.read_bytes(), b'Hello, world!')
+        self.assertEqual(self.files.read_text(encoding='utf-8'), 'Hello, world!')
+
+    def test_child_path_open(self):
+        self.assertEqual((self.files / 'a').read_bytes(), b'Hello, world!')
+        self.assertEqual(
+            (self.files / 'a').read_text(encoding='utf-8'), 'Hello, world!'
+        )
+
+    def test_orphan_path_open(self):
+        with self.assertRaises(FileNotFoundError):
+            (self.files / 'a' / 'b').read_bytes()
+        with self.assertRaises(FileNotFoundError):
+            (self.files / 'a' / 'b' / 'c').read_bytes()
+
+    def test_open_invalid_mode(self):
+        with self.assertRaises(ValueError):
+            self.files.open('0')
+
+    def test_orphan_path_invalid(self):
+        with self.assertRaises(ValueError):
+            CompatibilityFiles.OrphanPath()
+
+    def test_wrap_spec(self):
+        spec = wrap_spec(self.package)
+        self.assertIsInstance(spec.loader.get_resource_reader(None), CompatibilityFiles)
+
+
+class CompatibilityFilesNoReaderTests(unittest.TestCase):
+    @property
+    def package(self):
+        return util.create_package_from_loader(None)
+
+    @property
+    def files(self):
+        return resources.files(self.package)
+
+    def test_spec_path_joinpath(self):
+        self.assertIsInstance(self.files / 'a', CompatibilityFiles.OrphanPath)
diff --git a/lib/importlib_resources/tests/test_contents.py b/lib/importlib_resources/tests/test_contents.py
new file mode 100644
index 00000000..525568e8
--- /dev/null
+++ b/lib/importlib_resources/tests/test_contents.py
@@ -0,0 +1,43 @@
+import unittest
+import importlib_resources as resources
+
+from . import data01
+from . import util
+
+
+class ContentsTests:
+    expected = {
+        '__init__.py',
+        'binary.file',
+        'subdirectory',
+        'utf-16.file',
+        'utf-8.file',
+    }
+
+    def test_contents(self):
+        contents = {path.name for path in resources.files(self.data).iterdir()}
+        assert self.expected <= contents
+
+
+class ContentsDiskTests(ContentsTests, unittest.TestCase):
+    def setUp(self):
+        self.data = data01
+
+
+class ContentsZipTests(ContentsTests, util.ZipSetup, unittest.TestCase):
+    pass
+
+
+class ContentsNamespaceTests(ContentsTests, unittest.TestCase):
+    expected = {
+        # no __init__ because of namespace design
+        # no subdirectory as incidental difference in fixture
+        'binary.file',
+        'utf-16.file',
+        'utf-8.file',
+    }
+
+    def setUp(self):
+        from . import namespacedata01
+
+        self.data = namespacedata01
diff --git a/lib/importlib_resources/tests/test_custom.py b/lib/importlib_resources/tests/test_custom.py
new file mode 100644
index 00000000..e85ddd65
--- /dev/null
+++ b/lib/importlib_resources/tests/test_custom.py
@@ -0,0 +1,45 @@
+import unittest
+import contextlib
+import pathlib
+
+import importlib_resources as resources
+from ..abc import TraversableResources, ResourceReader
+from . import util
+from ._compat import os_helper
+
+
+class SimpleLoader:
+    """
+    A simple loader that only implements a resource reader.
+    """
+
+    def __init__(self, reader: ResourceReader):
+        self.reader = reader
+
+    def get_resource_reader(self, package):
+        return self.reader
+
+
+class MagicResources(TraversableResources):
+    """
+    Magically returns the resources at path.
+    """
+
+    def __init__(self, path: pathlib.Path):
+        self.path = path
+
+    def files(self):
+        return self.path
+
+
+class CustomTraversableResourcesTests(unittest.TestCase):
+    def setUp(self):
+        self.fixtures = contextlib.ExitStack()
+        self.addCleanup(self.fixtures.close)
+
+    def test_custom_loader(self):
+        temp_dir = self.fixtures.enter_context(os_helper.temp_dir())
+        loader = SimpleLoader(MagicResources(temp_dir))
+        pkg = util.create_package_from_loader(loader)
+        files = resources.files(pkg)
+        assert files is temp_dir
diff --git a/lib/importlib_resources/tests/test_files.py b/lib/importlib_resources/tests/test_files.py
new file mode 100644
index 00000000..197a063b
--- /dev/null
+++ b/lib/importlib_resources/tests/test_files.py
@@ -0,0 +1,112 @@
+import typing
+import textwrap
+import unittest
+import warnings
+import importlib
+import contextlib
+
+import importlib_resources as resources
+from ..abc import Traversable
+from . import data01
+from . import util
+from . import _path
+from ._compat import os_helper, import_helper
+
+
+@contextlib.contextmanager
+def suppress_known_deprecation():
+    with warnings.catch_warnings(record=True) as ctx:
+        warnings.simplefilter('default', category=DeprecationWarning)
+        yield ctx
+
+
+class FilesTests:
+    def test_read_bytes(self):
+        files = resources.files(self.data)
+        actual = files.joinpath('utf-8.file').read_bytes()
+        assert actual == b'Hello, UTF-8 world!\n'
+
+    def test_read_text(self):
+        files = resources.files(self.data)
+        actual = files.joinpath('utf-8.file').read_text(encoding='utf-8')
+        assert actual == 'Hello, UTF-8 world!\n'
+
+    @unittest.skipUnless(
+        hasattr(typing, 'runtime_checkable'),
+        "Only suitable when typing supports runtime_checkable",
+    )
+    def test_traversable(self):
+        assert isinstance(resources.files(self.data), Traversable)
+
+    def test_old_parameter(self):
+        """
+        Files used to take a 'package' parameter. Make sure anyone
+        passing by name is still supported.
+        """
+        with suppress_known_deprecation():
+            resources.files(package=self.data)
+
+
+class OpenDiskTests(FilesTests, unittest.TestCase):
+    def setUp(self):
+        self.data = data01
+
+
+class OpenZipTests(FilesTests, util.ZipSetup, unittest.TestCase):
+    pass
+
+
+class OpenNamespaceTests(FilesTests, unittest.TestCase):
+    def setUp(self):
+        from . import namespacedata01
+
+        self.data = namespacedata01
+
+
+class SiteDir:
+    def setUp(self):
+        self.fixtures = contextlib.ExitStack()
+        self.addCleanup(self.fixtures.close)
+        self.site_dir = self.fixtures.enter_context(os_helper.temp_dir())
+        self.fixtures.enter_context(import_helper.DirsOnSysPath(self.site_dir))
+        self.fixtures.enter_context(import_helper.CleanImport())
+
+
+class ModulesFilesTests(SiteDir, unittest.TestCase):
+    def test_module_resources(self):
+        """
+        A module can have resources found adjacent to the module.
+        """
+        spec = {
+            'mod.py': '',
+            'res.txt': 'resources are the best',
+        }
+        _path.build(spec, self.site_dir)
+        import mod
+
+        actual = resources.files(mod).joinpath('res.txt').read_text(encoding='utf-8')
+        assert actual == spec['res.txt']
+
+
+class ImplicitContextFilesTests(SiteDir, unittest.TestCase):
+    def test_implicit_files(self):
+        """
+        Without any parameter, files() will infer the location as the caller.
+        """
+        spec = {
+            'somepkg': {
+                '__init__.py': textwrap.dedent(
+                    """
+                    import importlib_resources as res
+                    val = res.files().joinpath('res.txt').read_text(encoding='utf-8')
+                    """
+                ),
+                'res.txt': 'resources are the best',
+            },
+        }
+        _path.build(spec, self.site_dir)
+        assert importlib.import_module('somepkg').val == 'resources are the best'
+
+
+if __name__ == '__main__':
+    unittest.main()
diff --git a/lib/importlib_resources/tests/test_open.py b/lib/importlib_resources/tests/test_open.py
new file mode 100644
index 00000000..83b737dc
--- /dev/null
+++ b/lib/importlib_resources/tests/test_open.py
@@ -0,0 +1,85 @@
+import unittest
+
+import importlib_resources as resources
+from . import data01
+from . import util
+
+
+class CommonBinaryTests(util.CommonTests, unittest.TestCase):
+    def execute(self, package, path):
+        target = resources.files(package).joinpath(path)
+        with target.open('rb'):
+            pass
+
+
+class CommonTextTests(util.CommonTests, unittest.TestCase):
+    def execute(self, package, path):
+        target = resources.files(package).joinpath(path)
+        with target.open(encoding='utf-8'):
+            pass
+
+
+class OpenTests:
+    def test_open_binary(self):
+        target = resources.files(self.data) / 'binary.file'
+        with target.open('rb') as fp:
+            result = fp.read()
+            self.assertEqual(result, b'\x00\x01\x02\x03')
+
+    def test_open_text_default_encoding(self):
+        target = resources.files(self.data) / 'utf-8.file'
+        with target.open(encoding='utf-8') as fp:
+            result = fp.read()
+            self.assertEqual(result, 'Hello, UTF-8 world!\n')
+
+    def test_open_text_given_encoding(self):
+        target = resources.files(self.data) / 'utf-16.file'
+        with target.open(encoding='utf-16', errors='strict') as fp:
+            result = fp.read()
+        self.assertEqual(result, 'Hello, UTF-16 world!\n')
+
+    def test_open_text_with_errors(self):
+        """
+        Raises UnicodeError without the 'errors' argument.
+        """
+        target = resources.files(self.data) / 'utf-16.file'
+        with target.open(encoding='utf-8', errors='strict') as fp:
+            self.assertRaises(UnicodeError, fp.read)
+        with target.open(encoding='utf-8', errors='ignore') as fp:
+            result = fp.read()
+        self.assertEqual(
+            result,
+            'H\x00e\x00l\x00l\x00o\x00,\x00 '
+            '\x00U\x00T\x00F\x00-\x001\x006\x00 '
+            '\x00w\x00o\x00r\x00l\x00d\x00!\x00\n\x00',
+        )
+
+    def test_open_binary_FileNotFoundError(self):
+        target = resources.files(self.data) / 'does-not-exist'
+        with self.assertRaises(FileNotFoundError):
+            target.open('rb')
+
+    def test_open_text_FileNotFoundError(self):
+        target = resources.files(self.data) / 'does-not-exist'
+        with self.assertRaises(FileNotFoundError):
+            target.open(encoding='utf-8')
+
+
+class OpenDiskTests(OpenTests, unittest.TestCase):
+    def setUp(self):
+        self.data = data01
+
+
+class OpenDiskNamespaceTests(OpenTests, unittest.TestCase):
+    def setUp(self):
+        from . import namespacedata01
+
+        self.data = namespacedata01
+
+
+class OpenZipTests(OpenTests, util.ZipSetup, unittest.TestCase):
+    pass
+
+
+if __name__ == '__main__':
+    unittest.main()
diff --git a/lib/importlib_resources/tests/test_path.py b/lib/importlib_resources/tests/test_path.py
new file mode 100644
index 00000000..7cb20003
--- /dev/null
+++ b/lib/importlib_resources/tests/test_path.py
@@ -0,0 +1,69 @@
+import io
+import unittest
+
+import importlib_resources as resources
+from . import data01
+from . import util
+
+
+class CommonTests(util.CommonTests, unittest.TestCase):
+    def execute(self, package, path):
+        with resources.as_file(resources.files(package).joinpath(path)):
+            pass
+
+
+class PathTests:
+    def test_reading(self):
+        """
+        Path should be readable.
+
+        Test also implicitly verifies the returned object is a pathlib.Path
+        instance.
+        """
+        target = resources.files(self.data) / 'utf-8.file'
+        with resources.as_file(target) as path:
+            self.assertTrue(path.name.endswith("utf-8.file"), repr(path))
+            # pathlib.Path.read_text() was introduced in Python 3.5.
+            with path.open('r', encoding='utf-8') as file:
+                text = file.read()
+            self.assertEqual('Hello, UTF-8 world!\n', text)
+
+
+class PathDiskTests(PathTests, unittest.TestCase):
+    data = data01
+
+    def test_natural_path(self):
+        """
+        Guarantee the internal implementation detail that
+        file-system-backed resources do not get the tempdir
+        treatment.
+        """
+        target = resources.files(self.data) / 'utf-8.file'
+        with resources.as_file(target) as path:
+            assert 'data' in str(path)
+
+
+class PathMemoryTests(PathTests, unittest.TestCase):
+    def setUp(self):
+        file = io.BytesIO(b'Hello, UTF-8 world!\n')
+        self.addCleanup(file.close)
+        self.data = util.create_package(
+            file=file, path=FileNotFoundError("package exists only in memory")
+        )
+        self.data.__spec__.origin = None
+        self.data.__spec__.has_location = False
+
+
+class PathZipTests(PathTests, util.ZipSetup, unittest.TestCase):
+    def test_remove_in_context_manager(self):
+        """
+        It is not an error if the file that was temporarily stashed on the
+        file system is removed inside the `with` stanza.
+        """
+        target = resources.files(self.data) / 'utf-8.file'
+        with resources.as_file(target) as path:
+            path.unlink()
+
+
+if __name__ == '__main__':
+    unittest.main()
diff --git a/lib/importlib_resources/tests/test_read.py b/lib/importlib_resources/tests/test_read.py
new file mode 100644
index 00000000..b5aaec45
--- /dev/null
+++ b/lib/importlib_resources/tests/test_read.py
@@ -0,0 +1,82 @@
+import unittest
+import importlib_resources as resources
+
+from . import data01
+from . import util
+from importlib import import_module
+
+
+class CommonBinaryTests(util.CommonTests, unittest.TestCase):
+    def execute(self, package, path):
+        resources.files(package).joinpath(path).read_bytes()
+
+
+class CommonTextTests(util.CommonTests, unittest.TestCase):
+    def execute(self, package, path):
+        resources.files(package).joinpath(path).read_text(encoding='utf-8')
+
+
+class ReadTests:
+    def test_read_bytes(self):
+        result = resources.files(self.data).joinpath('binary.file').read_bytes()
+        self.assertEqual(result, b'\0\1\2\3')
+
+    def test_read_text_default_encoding(self):
+        result = (
+            resources.files(self.data)
+            .joinpath('utf-8.file')
+            .read_text(encoding='utf-8')
+        )
+        self.assertEqual(result, 'Hello, UTF-8 world!\n')
+
+    def test_read_text_given_encoding(self):
+        result = (
+            resources.files(self.data)
+            .joinpath('utf-16.file')
+            .read_text(encoding='utf-16')
+        )
+        self.assertEqual(result, 'Hello, UTF-16 world!\n')
+
+    def test_read_text_with_errors(self):
+        """
+        Raises UnicodeError without the 'errors' argument.
+        """
+        target = resources.files(self.data) / 'utf-16.file'
+        self.assertRaises(UnicodeError, target.read_text, encoding='utf-8')
+        result = target.read_text(encoding='utf-8', errors='ignore')
+        self.assertEqual(
+            result,
+            'H\x00e\x00l\x00l\x00o\x00,\x00 '
+            '\x00U\x00T\x00F\x00-\x001\x006\x00 '
+            '\x00w\x00o\x00r\x00l\x00d\x00!\x00\n\x00',
+        )
+
+
+class ReadDiskTests(ReadTests, unittest.TestCase):
+    data = data01
+
+
+class ReadZipTests(ReadTests, util.ZipSetup, unittest.TestCase):
+    def test_read_submodule_resource(self):
+        submodule = import_module('ziptestdata.subdirectory')
+        result = resources.files(submodule).joinpath('binary.file').read_bytes()
+        self.assertEqual(result, b'\0\1\2\3')
+
+    def test_read_submodule_resource_by_name(self):
+        result = (
+            resources.files('ziptestdata.subdirectory')
+            .joinpath('binary.file')
+            .read_bytes()
+        )
+        self.assertEqual(result, b'\0\1\2\3')
+
+
+class ReadNamespaceTests(ReadTests, unittest.TestCase):
+    def setUp(self):
+        from . import namespacedata01
+
+        self.data = namespacedata01
+
+
+if __name__ == '__main__':
+    unittest.main()
diff --git a/lib/importlib_resources/tests/test_reader.py b/lib/importlib_resources/tests/test_reader.py
new file mode 100644
index 00000000..e2bdf19c
--- /dev/null
+++ b/lib/importlib_resources/tests/test_reader.py
@@ -0,0 +1,144 @@
+import os.path
+import sys
+import pathlib
+import unittest
+
+from importlib import import_module
+from importlib_resources.readers import MultiplexedPath, NamespaceReader
+
+
+class MultiplexedPathTest(unittest.TestCase):
+    @classmethod
+    def setUpClass(cls):
+        path = pathlib.Path(__file__).parent / 'namespacedata01'
+        cls.folder = str(path)
+
+    def test_init_no_paths(self):
+        with self.assertRaises(FileNotFoundError):
+            MultiplexedPath()
+
+    def test_init_file(self):
+        with self.assertRaises(NotADirectoryError):
+            MultiplexedPath(os.path.join(self.folder, 'binary.file'))
+
+    def test_iterdir(self):
+        contents = {path.name for path in MultiplexedPath(self.folder).iterdir()}
+        try:
+            contents.remove('__pycache__')
+        except (KeyError, ValueError):
+            pass
+        self.assertEqual(contents, {'binary.file', 'utf-16.file', 'utf-8.file'})
+
+    def test_iterdir_duplicate(self):
+        data01 = os.path.abspath(os.path.join(__file__, '..', 'data01'))
+        contents = {
+            path.name for path in MultiplexedPath(self.folder, data01).iterdir()
+        }
+        for remove in ('__pycache__', '__init__.pyc'):
+            try:
+                contents.remove(remove)
+            except (KeyError, ValueError):
+                pass
+        self.assertEqual(
+            contents,
+            {'__init__.py', 'binary.file', 'subdirectory', 'utf-16.file', 'utf-8.file'},
+        )
+
+    def test_is_dir(self):
+        self.assertEqual(MultiplexedPath(self.folder).is_dir(), True)
+
+    def test_is_file(self):
+        self.assertEqual(MultiplexedPath(self.folder).is_file(), False)
+
+    def test_open_file(self):
+        path = MultiplexedPath(self.folder)
+        with self.assertRaises(FileNotFoundError):
+            path.read_bytes()
+        with self.assertRaises(FileNotFoundError):
+            path.read_text()
+        with self.assertRaises(FileNotFoundError):
+            path.open()
+
+    def test_join_path(self):
+        prefix = os.path.abspath(os.path.join(__file__, '..'))
+        data01 = os.path.join(prefix, 'data01')
+        path = MultiplexedPath(self.folder, data01)
+        self.assertEqual(
+            str(path.joinpath('binary.file'))[len(prefix) + 1 :],
+            os.path.join('namespacedata01', 'binary.file'),
+        )
+        self.assertEqual(
+            str(path.joinpath('subdirectory'))[len(prefix) + 1 :],
+            os.path.join('data01', 'subdirectory'),
+        )
+        self.assertEqual(
+            str(path.joinpath('imaginary'))[len(prefix) + 1 :],
+            os.path.join('namespacedata01', 'imaginary'),
+        )
+        self.assertEqual(path.joinpath(), path)
+
+    def test_join_path_compound(self):
+        path = MultiplexedPath(self.folder)
+        assert not path.joinpath('imaginary/foo.py').exists()
+
+    def test_join_path_common_subdir(self):
+        prefix = os.path.abspath(os.path.join(__file__, '..'))
+        data01 = os.path.join(prefix, 'data01')
+        data02 = os.path.join(prefix, 'data02')
+        path = MultiplexedPath(data01, data02)
+        self.assertIsInstance(path.joinpath('subdirectory'), MultiplexedPath)
+        self.assertEqual(
+            str(path.joinpath('subdirectory', 'subsubdir'))[len(prefix) + 1 :],
+            os.path.join('data02', 'subdirectory', 'subsubdir'),
+        )
+
+    def test_repr(self):
+        self.assertEqual(
+            repr(MultiplexedPath(self.folder)),
+            f"MultiplexedPath('{self.folder}')",
+        )
+
+    def test_name(self):
+        self.assertEqual(
+            MultiplexedPath(self.folder).name,
+            os.path.basename(self.folder),
+        )
+
+
+class NamespaceReaderTest(unittest.TestCase):
+    site_dir = str(pathlib.Path(__file__).parent)
+
+    @classmethod
+    def setUpClass(cls):
+        sys.path.append(cls.site_dir)
+
+    @classmethod
+    def tearDownClass(cls):
+        sys.path.remove(cls.site_dir)
+
+    def test_init_error(self):
+        with self.assertRaises(ValueError):
+            NamespaceReader(['path1', 'path2'])
+
+    def test_resource_path(self):
+        namespacedata01 = import_module('namespacedata01')
+        reader = NamespaceReader(namespacedata01.__spec__.submodule_search_locations)
+
+        root = os.path.abspath(os.path.join(__file__, '..', 'namespacedata01'))
+        self.assertEqual(
+            reader.resource_path('binary.file'), os.path.join(root, 'binary.file')
+        )
+        self.assertEqual(
+            reader.resource_path('imaginary'), os.path.join(root, 'imaginary')
+        )
+
+    def test_files(self):
+        namespacedata01 = import_module('namespacedata01')
+        reader = NamespaceReader(namespacedata01.__spec__.submodule_search_locations)
+        root = os.path.abspath(os.path.join(__file__, '..', 'namespacedata01'))
+        self.assertIsInstance(reader.files(), MultiplexedPath)
+        self.assertEqual(repr(reader.files()), f"MultiplexedPath('{root}')")
+
+
+if __name__ == '__main__':
+    unittest.main()
diff --git a/lib/importlib_resources/tests/test_resource.py b/lib/importlib_resources/tests/test_resource.py
new file mode 100644
index 00000000..677110cd
--- /dev/null
+++ b/lib/importlib_resources/tests/test_resource.py
@@ -0,0 +1,252 @@
+import contextlib
+import sys
+import unittest
+import importlib_resources as resources
+import uuid
+import pathlib
+
+from . import data01
+from . import zipdata01, zipdata02
+from . import util
+from importlib import import_module
+from ._compat import import_helper, os_helper, unlink
+
+
+class ResourceTests:
+    # Subclasses are expected to set the `data` attribute.
+
+    def test_is_file_exists(self):
+        target = resources.files(self.data) / 'binary.file'
+        self.assertTrue(target.is_file())
+
+    def test_is_file_missing(self):
+        target = resources.files(self.data) / 'not-a-file'
+        self.assertFalse(target.is_file())
+
+    def test_is_dir(self):
+        target = resources.files(self.data) / 'subdirectory'
+        self.assertFalse(target.is_file())
+        self.assertTrue(target.is_dir())
+
+
+class ResourceDiskTests(ResourceTests, unittest.TestCase):
+    def setUp(self):
+        self.data = data01
+
+
+class ResourceZipTests(ResourceTests, util.ZipSetup, unittest.TestCase):
+    pass
+
+
+def names(traversable):
+    return {item.name for item in traversable.iterdir()}
+
+
+class ResourceLoaderTests(unittest.TestCase):
+    def test_resource_contents(self):
+        package = util.create_package(
+            file=data01, path=data01.__file__, contents=['A', 'B', 'C']
+        )
+        self.assertEqual(names(resources.files(package)), {'A', 'B', 'C'})
+
+    def test_is_file(self):
+        package = util.create_package(
+            file=data01, path=data01.__file__, contents=['A', 'B', 'C', 'D/E', 'D/F']
+        )
+        self.assertTrue(resources.files(package).joinpath('B').is_file())
+
+    def test_is_dir(self):
+        package = util.create_package(
+            file=data01, path=data01.__file__, contents=['A', 'B', 'C', 'D/E', 'D/F']
+        )
+        self.assertTrue(resources.files(package).joinpath('D').is_dir())
+
+    def test_resource_missing(self):
+        package = util.create_package(
+            file=data01, path=data01.__file__, contents=['A', 'B', 'C', 'D/E', 'D/F']
+        )
+        self.assertFalse(resources.files(package).joinpath('Z').is_file())
+
+
+class ResourceCornerCaseTests(unittest.TestCase):
+    def test_package_has_no_reader_fallback(self):
+        """
+        Test odd ball packages which:
+        # 1. Do not have a ResourceReader as a loader
+        # 2. Are not on the file system
+        # 3. Are not in a zip file
+        """
+        module = util.create_package(
+            file=data01, path=data01.__file__, contents=['A', 'B', 'C']
+        )
+        # Give the module a dummy loader.
+        module.__loader__ = object()
+        # Give the module a dummy origin.
+        module.__file__ = '/path/which/shall/not/be/named'
+        module.__spec__.loader = module.__loader__
+        module.__spec__.origin = module.__file__
+        self.assertFalse(resources.files(module).joinpath('A').is_file())
+
+
+class ResourceFromZipsTest01(util.ZipSetupBase, unittest.TestCase):
+    ZIP_MODULE = zipdata01  # type: ignore
+
+    def test_is_submodule_resource(self):
+        submodule = import_module('ziptestdata.subdirectory')
+        self.assertTrue(resources.files(submodule).joinpath('binary.file').is_file())
+
+    def test_read_submodule_resource_by_name(self):
+        self.assertTrue(
+            resources.files('ziptestdata.subdirectory')
+            .joinpath('binary.file')
+            .is_file()
+        )
+
+    def test_submodule_contents(self):
+        submodule = import_module('ziptestdata.subdirectory')
+        self.assertEqual(
+            names(resources.files(submodule)), {'__init__.py', 'binary.file'}
+        )
+
+    def test_submodule_contents_by_name(self):
+        self.assertEqual(
+            names(resources.files('ziptestdata.subdirectory')),
+            {'__init__.py', 'binary.file'},
+        )
+
+    def test_as_file_directory(self):
+        with resources.as_file(resources.files('ziptestdata')) as data:
+            assert data.name == 'ziptestdata'
+            assert data.is_dir()
+            assert data.joinpath('subdirectory').is_dir()
+            assert len(list(data.iterdir()))
+        assert not data.parent.exists()
+
+
+class ResourceFromZipsTest02(util.ZipSetupBase, unittest.TestCase):
+    ZIP_MODULE = zipdata02  # type: ignore
+
+    def test_unrelated_contents(self):
+        """
+        Test thata zip with two unrelated subpackages return
+        distinct resources. Ref python/importlib_resources#44.
+        """
+        self.assertEqual(
+            names(resources.files('ziptestdata.one')),
+            {'__init__.py', 'resource1.txt'},
+        )
+        self.assertEqual(
+            names(resources.files('ziptestdata.two')),
+            {'__init__.py', 'resource2.txt'},
+        )
+
+
+@contextlib.contextmanager
+def zip_on_path(dir):
+    data_path = pathlib.Path(zipdata01.__file__)
+    source_zip_path = data_path.parent.joinpath('ziptestdata.zip')
+    zip_path = pathlib.Path(dir) / f'{uuid.uuid4()}.zip'
+    zip_path.write_bytes(source_zip_path.read_bytes())
+    sys.path.append(str(zip_path))
+    import_module('ziptestdata')
+
+    try:
+        yield
+    finally:
+        with contextlib.suppress(ValueError):
+            sys.path.remove(str(zip_path))
+
+        with contextlib.suppress(KeyError):
+            del sys.path_importer_cache[str(zip_path)]
+            del sys.modules['ziptestdata']
+
+        with contextlib.suppress(OSError):
+            unlink(zip_path)
+
+
+class DeletingZipsTest(unittest.TestCase):
+    """Having accessed resources in a zip file should not keep an open
+    reference to the zip.
+    """
+
+    def setUp(self):
+        self.fixtures = contextlib.ExitStack()
+        self.addCleanup(self.fixtures.close)
+
+        modules = import_helper.modules_setup()
+        self.addCleanup(import_helper.modules_cleanup, *modules)
+
+        temp_dir = self.fixtures.enter_context(os_helper.temp_dir())
+        self.fixtures.enter_context(zip_on_path(temp_dir))
+
+    def test_iterdir_does_not_keep_open(self):
+        [item.name for item in resources.files('ziptestdata').iterdir()]
+
+    def test_is_file_does_not_keep_open(self):
+        resources.files('ziptestdata').joinpath('binary.file').is_file()
+
+    def test_is_file_failure_does_not_keep_open(self):
+        resources.files('ziptestdata').joinpath('not-present').is_file()
+
+    @unittest.skip("Desired but not supported.")
+    def test_as_file_does_not_keep_open(self):  # pragma: no cover
+        resources.as_file(resources.files('ziptestdata') / 'binary.file')
+
+    def test_entered_path_does_not_keep_open(self):
+        """
+        Mimic what certifi does on import to make its bundle
+        available for the process duration.
+        """
+        resources.as_file(resources.files('ziptestdata') / 'binary.file').__enter__()
+
+    def test_read_binary_does_not_keep_open(self):
+        resources.files('ziptestdata').joinpath('binary.file').read_bytes()
+
+    def test_read_text_does_not_keep_open(self):
+        resources.files('ziptestdata').joinpath('utf-8.file').read_text(
+            encoding='utf-8'
+        )
+
+
+class ResourceFromNamespaceTest01(unittest.TestCase):
+    site_dir = str(pathlib.Path(__file__).parent)
+
+    @classmethod
+    def setUpClass(cls):
+        sys.path.append(cls.site_dir)
+
+    @classmethod
+    def tearDownClass(cls):
+        sys.path.remove(cls.site_dir)
+
+    def test_is_submodule_resource(self):
+        self.assertTrue(
+            resources.files(import_module('namespacedata01'))
+            .joinpath('binary.file')
+            .is_file()
+        )
+
+    def test_read_submodule_resource_by_name(self):
+        self.assertTrue(
+            resources.files('namespacedata01').joinpath('binary.file').is_file()
+        )
+
+    def test_submodule_contents(self):
+        contents = names(resources.files(import_module('namespacedata01')))
+        try:
+            contents.remove('__pycache__')
+        except KeyError:
+            pass
+        self.assertEqual(contents, {'binary.file', 'utf-8.file', 'utf-16.file'})
+
+    def test_submodule_contents_by_name(self):
+        contents = names(resources.files('namespacedata01'))
+        try:
+            contents.remove('__pycache__')
+        except KeyError:
+            pass
+        self.assertEqual(contents, {'binary.file', 'utf-8.file', 'utf-16.file'})
+
+
+if __name__ == '__main__':
+    unittest.main()
diff --git a/lib/importlib_resources/tests/update-zips.py b/lib/importlib_resources/tests/update-zips.py
new file mode 100644
index 00000000..231334aa
--- /dev/null
+++ b/lib/importlib_resources/tests/update-zips.py
@@ -0,0 +1,53 @@
+"""
+Generate the zip test data files.
+
+Run to build the tests/zipdataNN/ziptestdata.zip files from
+files in tests/dataNN.
+
+Replaces the file with the working copy, but does commit anything
+to the source repo.
+"""
+
+import contextlib
+import os
+import pathlib
+import zipfile
+
+
+def main():
+    """
+    >>> from unittest import mock
+    >>> monkeypatch = getfixture('monkeypatch')
+    >>> monkeypatch.setattr(zipfile, 'ZipFile', mock.MagicMock())
+    >>> print(); main()  # print workaround for bpo-32509
+    <BLANKLINE>
+    ...data01... -> ziptestdata/...
+    ...
+    ...data02... -> ziptestdata/...
+    ...
+    """
+    suffixes = '01', '02'
+    tuple(map(generate, suffixes))
+
+
+def generate(suffix):
+    root = pathlib.Path(__file__).parent.relative_to(os.getcwd())
+    zfpath = root / f'zipdata{suffix}/ziptestdata.zip'
+    with zipfile.ZipFile(zfpath, 'w') as zf:
+        for src, rel in walk(root / f'data{suffix}'):
+            dst = 'ziptestdata' / pathlib.PurePosixPath(rel.as_posix())
+            print(src, '->', dst)
+            zf.write(src, dst)
+
+
+def walk(datapath):
+    for dirpath, dirnames, filenames in os.walk(datapath):
+        with contextlib.suppress(ValueError):
+            dirnames.remove('__pycache__')
+        for filename in filenames:
+            res = pathlib.Path(dirpath) / filename
+            rel = res.relative_to(datapath)
+            yield res, rel
+
+
+__name__ == '__main__' and main()
diff --git a/lib/importlib_resources/tests/util.py b/lib/importlib_resources/tests/util.py
new file mode 100644
index 00000000..ce0e6fad
--- /dev/null
+++ b/lib/importlib_resources/tests/util.py
@@ -0,0 +1,179 @@
+import abc
+import importlib
+import io
+import sys
+import types
+import pathlib
+
+from . import data01
+from . import zipdata01
+from ..abc import ResourceReader
+from ._compat import import_helper
+
+
+from importlib.machinery import ModuleSpec
+
+
+class Reader(ResourceReader):
+    def __init__(self, **kwargs):
+        vars(self).update(kwargs)
+
+    def get_resource_reader(self, package):
+        return self
+
+    def open_resource(self, path):
+        self._path = path
+        if isinstance(self.file, Exception):
+            raise self.file
+        return self.file
+
+    def resource_path(self, path_):
+        self._path = path_
+        if isinstance(self.path, Exception):
+            raise self.path
+        return self.path
+
+    def is_resource(self, path_):
+        self._path = path_
+        if isinstance(self.path, Exception):
+            raise self.path
+
+        def part(entry):
+            return entry.split('/')
+
+        return any(
+            len(parts) == 1 and parts[0] == path_ for parts in map(part, self._contents)
+        )
+
+    def contents(self):
+        if isinstance(self.path, Exception):
+            raise self.path
+        yield from self._contents
+
+
+def create_package_from_loader(loader, is_package=True):
+    name = 'testingpackage'
+    module = types.ModuleType(name)
+    spec = ModuleSpec(name, loader, origin='does-not-exist', is_package=is_package)
+    module.__spec__ = spec
+    module.__loader__ = loader
+    return module
+
+
+def create_package(file=None, path=None, is_package=True, contents=()):
+    return create_package_from_loader(
+        Reader(file=file, path=path, _contents=contents),
+        is_package,
+    )
+
+
+class CommonTests(metaclass=abc.ABCMeta):
+    """
+    Tests shared by test_open, test_path, and test_read.
+    """
+
+    @abc.abstractmethod
+    def execute(self, package, path):
+        """
+        Call the pertinent legacy API function (e.g. open_text, path)
+        on package and path.
+        """
+
+    def test_package_name(self):
+        """
+        Passing in the package name should succeed.
+        """
+        self.execute(data01.__name__, 'utf-8.file')
+
+    def test_package_object(self):
+        """
+        Passing in the package itself should succeed.
+        """
+        self.execute(data01, 'utf-8.file')
+
+    def test_string_path(self):
+        """
+        Passing in a string for the path should succeed.
+        """
+        path = 'utf-8.file'
+        self.execute(data01, path)
+
+    def test_pathlib_path(self):
+        """
+        Passing in a pathlib.PurePath object for the path should succeed.
+        """
+        path = pathlib.PurePath('utf-8.file')
+        self.execute(data01, path)
+
+    def test_importing_module_as_side_effect(self):
+        """
+        The anchor package can already be imported.
+        """
+        del sys.modules[data01.__name__]
+        self.execute(data01.__name__, 'utf-8.file')
+
+    def test_missing_path(self):
+        """
+        Attempting to open or read or request the path for a
+        non-existent path should succeed if open_resource
+        can return a viable data stream.
+        """
+        bytes_data = io.BytesIO(b'Hello, world!')
+        package = create_package(file=bytes_data, path=FileNotFoundError())
+        self.execute(package, 'utf-8.file')
+        self.assertEqual(package.__loader__._path, 'utf-8.file')
+
+    def test_extant_path(self):
+        # Attempting to open or read or request the path when the
+        # path does exist should still succeed. Does not assert
+        # anything about the result.
+        bytes_data = io.BytesIO(b'Hello, world!')
+        # any path that exists
+        path = __file__
+        package = create_package(file=bytes_data, path=path)
+        self.execute(package, 'utf-8.file')
+        self.assertEqual(package.__loader__._path, 'utf-8.file')
+
+    def test_useless_loader(self):
+        package = create_package(file=FileNotFoundError(), path=FileNotFoundError())
+        with self.assertRaises(FileNotFoundError):
+            self.execute(package, 'utf-8.file')
+
+
+class ZipSetupBase:
+    ZIP_MODULE = None
+
+    @classmethod
+    def setUpClass(cls):
+        data_path = pathlib.Path(cls.ZIP_MODULE.__file__)
+        data_dir = data_path.parent
+        cls._zip_path = str(data_dir / 'ziptestdata.zip')
+        sys.path.append(cls._zip_path)
+        cls.data = importlib.import_module('ziptestdata')
+
+    @classmethod
+    def tearDownClass(cls):
+        try:
+            sys.path.remove(cls._zip_path)
+        except ValueError:
+            pass
+
+        try:
+            del sys.path_importer_cache[cls._zip_path]
+            del sys.modules[cls.data.__name__]
+        except KeyError:
+            pass
+
+        try:
+            del cls.data
+            del cls._zip_path
+        except AttributeError:
+            pass
+
+    def setUp(self):
+        modules = import_helper.modules_setup()
+        self.addCleanup(import_helper.modules_cleanup, *modules)
+
+
+class ZipSetup(ZipSetupBase):
+    ZIP_MODULE = zipdata01  # type: ignore
diff --git a/lib/importlib_resources/tests/zipdata01/__init__.py b/lib/importlib_resources/tests/zipdata01/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/lib/importlib_resources/tests/zipdata01/ziptestdata.zip b/lib/importlib_resources/tests/zipdata01/ziptestdata.zip
new file mode 100644
index 0000000000000000000000000000000000000000..9a3bb0739f87e97c1084b94d7d153680f6727738
GIT binary patch
literal 876
zcmWIWW@Zs#00HOCX@Q%&m27l?Y!DU);;PJolGNgol*E!m{nC;&T|+ayw9K5;|NlG~
zQW<i9FdwK?fgzM3gu#tLm%)(149F`7iWULoQWz8&xEKOZEI9q+&@7O3AS{N(0t>MD
z9;rDw`8o=rA#S=B3g!7lIVp-<sOA8*!U4KN<Kr{)GE3s)^$IFcH3_%v>}COK17UPc
zNtt<xMU`ON85o(EQ8mJ?0y0#97&%yqOOsMEi&B$I@{20<iLx562^j8RWD;S<9YHXc
zEolU?kllq8T>;*xhM-3R!jMEPhCreO-3*u>5Df}T7+BJ{639e$2uhfsIs`pJ5Qf}C
xGXyDE@VNvOv@o!wQJfLgCAgysx3f@9jKpUmiW^zkK<;1z!tFpk^MROw0RS~O%0&PG

literal 0
HcmV?d00001

diff --git a/lib/importlib_resources/tests/zipdata02/__init__.py b/lib/importlib_resources/tests/zipdata02/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/lib/importlib_resources/tests/zipdata02/ziptestdata.zip b/lib/importlib_resources/tests/zipdata02/ziptestdata.zip
new file mode 100644
index 0000000000000000000000000000000000000000..d63ff512d2807ef2fd259455283b81b02e0e45fb
GIT binary patch
literal 698
zcmWIWW@Zs#00HOCX@Ot{ln@8fRhb1Psl_EJi6x2p@$s2?nI-Y@dIgmMI5kP5Y0A$_
z#jWw|&p#`9ff_(q7K_HB)Z+ZoqU2OVy^@L&ph*fa0WRVlP*R?c+X1opI-R&20MZDv
z&j{oIpa8N17@0(vaR(gGH(;=&5k%n(M%;#g0ulz6G@1gL$cA79E2=^00gEsw4~s!C
zUxI@<z#G*lm{t&t>ZWaIMqz|BszK;s4KsL2<9jRy!Q2E6`2cTLHjr{wAk1ZCU@!+_
G1_l6Bc%f?m

literal 0
HcmV?d00001

diff --git a/requirements.txt b/requirements.txt
index e71070e6..3fc87314 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -19,6 +19,8 @@ gntp==1.0.3
 html5lib==1.1
 httpagentparser==1.9.5
 idna==3.4
+importlib-metadata==6.8.0
+importlib-resources==6.0.1
 git+https://github.com/Tautulli/ipwhois.git@master#egg=ipwhois
 IPy==1.01
 Mako==1.2.4

From 80e6131a0daf7b2feaa996630aaeb5940169420e Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 24 Aug 2023 12:10:08 -0700
Subject: [PATCH 456/743] Revert "Bump apscheduler from 3.10.1 to 3.10.4
 (#2133)"

This reverts commit 2c421507997f23ac904259f019e9fc3c7eefea65.
---
 lib/apscheduler/__init__.py        |   13 +-
 lib/apscheduler/schedulers/base.py |   19 +-
 lib/apscheduler/schedulers/qt.py   |   28 +-
 lib/apscheduler/util.py            |   39 +-
 lib/tzlocal/__init__.py            |    9 +-
 lib/tzlocal/unix.py                |   63 +-
 lib/tzlocal/utils.py               |   68 +-
 lib/tzlocal/win32.py               |   32 +-
 lib/tzlocal/windows_tz.py          | 1405 ++++++++++++++--------------
 package/requirements-package.txt   |    2 +-
 requirements.txt                   |    2 +-
 11 files changed, 825 insertions(+), 855 deletions(-)

diff --git a/lib/apscheduler/__init__.py b/lib/apscheduler/__init__.py
index 651aba49..968169a9 100644
--- a/lib/apscheduler/__init__.py
+++ b/lib/apscheduler/__init__.py
@@ -1,15 +1,10 @@
-import sys
-if sys.version_info >= (3, 8):
-    import importlib.metadata as importlib_metadata
-else:
-    import importlib_metadata
-
+from pkg_resources import get_distribution, DistributionNotFound
 
 try:
-    release = importlib_metadata.version('APScheduler').split('-')[0]
-except importlib_metadata.PackageNotFoundError:
+    release = get_distribution('APScheduler').version.split('-')[0]
+except DistributionNotFound:
     release = '3.5.0'
 
 version_info = tuple(int(x) if x.isdigit() else x for x in release.split('.'))
 version = __version__ = '.'.join(str(x) for x in version_info[:3])
-del sys, importlib_metadata
+del get_distribution, DistributionNotFound
diff --git a/lib/apscheduler/schedulers/base.py b/lib/apscheduler/schedulers/base.py
index f751c955..444de8ef 100644
--- a/lib/apscheduler/schedulers/base.py
+++ b/lib/apscheduler/schedulers/base.py
@@ -7,6 +7,7 @@ from logging import getLogger
 import warnings
 import sys
 
+from pkg_resources import iter_entry_points
 from tzlocal import get_localzone
 import six
 
@@ -30,11 +31,6 @@ try:
 except ImportError:
     from collections import MutableMapping
 
-try:
-    from importlib.metadata import entry_points
-except ModuleNotFoundError:
-    from importlib_metadata import entry_points
-
 #: constant indicating a scheduler's stopped state
 STATE_STOPPED = 0
 #: constant indicating a scheduler's running state (started and processing jobs)
@@ -66,18 +62,12 @@ class BaseScheduler(six.with_metaclass(ABCMeta)):
 
     .. seealso:: :ref:`scheduler-config`
     """
-    # The `group=...` API is only available in the backport, used in <=3.7, and in std>=3.10.
-    if (3, 8) <= sys.version_info < (3, 10):
-        _trigger_plugins = {ep.name: ep for ep in entry_points()['apscheduler.triggers']}
-        _executor_plugins = {ep.name: ep for ep in entry_points()['apscheduler.executors']}
-        _jobstore_plugins = {ep.name: ep for ep in entry_points()['apscheduler.jobstores']}
-    else:
-        _trigger_plugins = {ep.name: ep for ep in entry_points(group='apscheduler.triggers')}
-        _executor_plugins = {ep.name: ep for ep in entry_points(group='apscheduler.executors')}
-        _jobstore_plugins = {ep.name: ep for ep in entry_points(group='apscheduler.jobstores')}
 
+    _trigger_plugins = dict((ep.name, ep) for ep in iter_entry_points('apscheduler.triggers'))
     _trigger_classes = {}
+    _executor_plugins = dict((ep.name, ep) for ep in iter_entry_points('apscheduler.executors'))
     _executor_classes = {}
+    _jobstore_plugins = dict((ep.name, ep) for ep in iter_entry_points('apscheduler.jobstores'))
     _jobstore_classes = {}
 
     #
@@ -1029,7 +1019,6 @@ class BaseScheduler(six.with_metaclass(ABCMeta)):
             wait_seconds = None
             self._logger.debug('No jobs; waiting until a job is added')
         else:
-            now = datetime.now(self.timezone)
             wait_seconds = min(max(timedelta_seconds(next_wakeup_time - now), 0), TIMEOUT_MAX)
             self._logger.debug('Next wakeup is due at %s (in %f seconds)', next_wakeup_time,
                                wait_seconds)
diff --git a/lib/apscheduler/schedulers/qt.py b/lib/apscheduler/schedulers/qt.py
index 6762c5c3..890a44a8 100644
--- a/lib/apscheduler/schedulers/qt.py
+++ b/lib/apscheduler/schedulers/qt.py
@@ -1,22 +1,24 @@
 from __future__ import absolute_import
 
-from importlib import import_module
-from itertools import product
-
 from apscheduler.schedulers.base import BaseScheduler
 
-for version, pkgname in product(range(6, 1, -1), ("PySide", "PyQt")):
+try:
+    from PyQt5.QtCore import QObject, QTimer
+except (ImportError, RuntimeError):  # pragma: nocover
     try:
-        qtcore = import_module(pkgname + str(version) + ".QtCore")
+        from PyQt4.QtCore import QObject, QTimer
     except ImportError:
-        pass
-    else:
-        QTimer = qtcore.QTimer
-        break
-else:
-    raise ImportError(
-        "QtScheduler requires either PySide/PyQt (v6 to v2) installed"
-    )
+        try:
+            from PySide6.QtCore import QObject, QTimer  # noqa
+        except ImportError:
+            try:
+                from PySide2.QtCore import QObject, QTimer  # noqa
+            except ImportError:
+                try:
+                    from PySide.QtCore import QObject, QTimer  # noqa
+                except ImportError:
+                    raise ImportError('QtScheduler requires either PyQt5, PyQt4, PySide6, PySide2 '
+                                      'or PySide installed')
 
 
 class QtScheduler(BaseScheduler):
diff --git a/lib/apscheduler/util.py b/lib/apscheduler/util.py
index 003b30f5..64b27d7b 100644
--- a/lib/apscheduler/util.py
+++ b/lib/apscheduler/util.py
@@ -6,7 +6,7 @@ from asyncio import iscoroutinefunction
 from datetime import date, datetime, time, timedelta, tzinfo
 from calendar import timegm
 from functools import partial
-from inspect import isbuiltin, isclass, isfunction, ismethod
+from inspect import isclass, ismethod
 import re
 import sys
 
@@ -214,15 +214,28 @@ def get_callable_name(func):
     :rtype: str
 
     """
-    if ismethod(func):
-        self = func.__self__
-        cls = self if isclass(self) else type(self)
-        return f"{cls.__qualname__}.{func.__name__}"
-    elif isclass(func) or isfunction(func) or isbuiltin(func):
+    # the easy case (on Python 3.3+)
+    if hasattr(func, '__qualname__'):
         return func.__qualname__
-    elif hasattr(func, '__call__') and callable(func.__call__):
+
+    # class methods, bound and unbound methods
+    f_self = getattr(func, '__self__', None) or getattr(func, 'im_self', None)
+    if f_self and hasattr(func, '__name__'):
+        f_class = f_self if isclass(f_self) else f_self.__class__
+    else:
+        f_class = getattr(func, 'im_class', None)
+
+    if f_class and hasattr(func, '__name__'):
+        return '%s.%s' % (f_class.__name__, func.__name__)
+
+    # class or class instance
+    if hasattr(func, '__call__'):
+        # class
+        if hasattr(func, '__name__'):
+            return func.__name__
+
         # instance of a class with a __call__ method
-        return type(func).__qualname__
+        return func.__class__.__name__
 
     raise TypeError('Unable to determine a name for %r -- maybe it is not a callable?' % func)
 
@@ -247,10 +260,16 @@ def obj_to_ref(obj):
         raise ValueError('Cannot create a reference to a nested function')
 
     if ismethod(obj):
-        module = obj.__self__.__module__
+        if hasattr(obj, 'im_self') and obj.im_self:
+            # bound method
+            module = obj.im_self.__module__
+        elif hasattr(obj, 'im_class') and obj.im_class:
+            # unbound method
+            module = obj.im_class.__module__
+        else:
+            module = obj.__module__
     else:
         module = obj.__module__
-
     return '%s:%s' % (module, name)
 
 
diff --git a/lib/tzlocal/__init__.py b/lib/tzlocal/__init__.py
index 50abb093..98ed04fd 100644
--- a/lib/tzlocal/__init__.py
+++ b/lib/tzlocal/__init__.py
@@ -9,12 +9,5 @@ if sys.platform == "win32":
 else:
     from tzlocal.unix import get_localzone, get_localzone_name, reload_localzone
 
-from tzlocal.utils import assert_tz_offset
 
-
-__all__ = [
-    "get_localzone",
-    "get_localzone_name",
-    "reload_localzone",
-    "assert_tz_offset",
-]
+__all__ = ["get_localzone", "get_localzone_name", "reload_localzone"]
diff --git a/lib/tzlocal/unix.py b/lib/tzlocal/unix.py
index f510c12c..eaf96d92 100644
--- a/lib/tzlocal/unix.py
+++ b/lib/tzlocal/unix.py
@@ -1,21 +1,20 @@
-import logging
 import os
 import re
 import sys
 import warnings
 from datetime import timezone
+import pytz_deprecation_shim as pds
 
 from tzlocal import utils
 
 if sys.version_info >= (3, 9):
-    import zoneinfo  # pragma: no cover
+    from zoneinfo import ZoneInfo  # pragma: no cover
 else:
-    from backports import zoneinfo  # pragma: no cover
+    from backports.zoneinfo import ZoneInfo  # pragma: no cover
 
 _cache_tz = None
 _cache_tz_name = None
 
-log = logging.getLogger("tzlocal")
 
 def _get_localzone_name(_root="/"):
     """Tries to find the local timezone configuration.
@@ -33,21 +32,14 @@ def _get_localzone_name(_root="/"):
 
     # Are we under Termux on Android?
     if os.path.exists(os.path.join(_root, "system/bin/getprop")):
-        log.debug("This looks like Termux")
-
         import subprocess
 
-        try:
-            androidtz = (
-                subprocess.check_output(["getprop", "persist.sys.timezone"])
-                .strip()
-                .decode()
-            )
-            return androidtz
-        except (OSError, subprocess.CalledProcessError):
-            # proot environment or failed to getprop
-            log.debug("It's not termux?")
-            pass
+        androidtz = (
+            subprocess.check_output(["getprop", "persist.sys.timezone"])
+            .strip()
+            .decode()
+        )
+        return androidtz
 
     # Now look for distribution specific configuration files
     # that contain the timezone name.
@@ -58,11 +50,10 @@ def _get_localzone_name(_root="/"):
     for configfile in ("etc/timezone", "var/db/zoneinfo"):
         tzpath = os.path.join(_root, configfile)
         try:
-            with open(tzpath) as tzfile:
+            with open(tzpath, "rt") as tzfile:
                 data = tzfile.read()
-                log.debug(f"{tzpath} found, contents:\n {data}")
 
-                etctz = data.strip("/ \t\r\n")
+                etctz = data.strip('/ \t\r\n')
                 if not etctz:
                     # Empty file, skip
                     continue
@@ -77,7 +68,7 @@ def _get_localzone_name(_root="/"):
 
                     found_configs[tzpath] = etctz.replace(" ", "_")
 
-        except (OSError, UnicodeDecodeError):
+        except (IOError, UnicodeDecodeError):
             # File doesn't exist or is a directory, or it's a binary file.
             continue
 
@@ -95,7 +86,6 @@ def _get_localzone_name(_root="/"):
         try:
             with open(tzpath, "rt") as tzfile:
                 data = tzfile.readlines()
-                log.debug(f"{tzpath} found, contents:\n {data}")
 
             for line in data:
                 # Look for the ZONE= setting.
@@ -105,13 +95,13 @@ def _get_localzone_name(_root="/"):
                     match = timezone_re.match(line)
                 if match is not None:
                     # Some setting existed
-                    line = line[match.end() :]
+                    line = line[match.end():]
                     etctz = line[: end_re.search(line).start()]
 
                     # We found a timezone
                     found_configs[tzpath] = etctz.replace(" ", "_")
 
-        except (OSError, UnicodeDecodeError):
+        except (IOError, UnicodeDecodeError):
             # UnicodeDecode handles when clock is symlink to /etc/localtime
             continue
 
@@ -119,34 +109,30 @@ def _get_localzone_name(_root="/"):
     # see manpage of localtime(5) and timedatectl(1)
     tzpath = os.path.join(_root, "etc/localtime")
     if os.path.exists(tzpath) and os.path.islink(tzpath):
-        log.debug(f"{tzpath} found")
-        etctz = os.path.realpath(tzpath)
+        etctz = realtzpath = os.path.realpath(tzpath)
         start = etctz.find("/") + 1
         while start != 0:
             etctz = etctz[start:]
             try:
-                zoneinfo.ZoneInfo(etctz)
+                pds.timezone(etctz)
                 tzinfo = f"{tzpath} is a symlink to"
                 found_configs[tzinfo] = etctz.replace(" ", "_")
-                # Only need first valid relative path in simlink.
-                break
-            except zoneinfo.ZoneInfoNotFoundError:
+            except pds.UnknownTimeZoneError:
                 pass
             start = etctz.find("/") + 1
 
     if len(found_configs) > 0:
-        log.debug(f"{len(found_configs)} found:\n {found_configs}")
         # We found some explicit config of some sort!
         if len(found_configs) > 1:
             # Uh-oh, multiple configs. See if they match:
             unique_tzs = set()
-            zoneinfopath = os.path.join(_root, "usr", "share", "zoneinfo")
-            directory_depth = len(zoneinfopath.split(os.path.sep))
+            zoneinfo = os.path.join(_root, "usr", "share", "zoneinfo")
+            directory_depth = len(zoneinfo.split(os.path.sep))
 
             for tzname in found_configs.values():
                 # Look them up in /usr/share/zoneinfo, and find what they
                 # really point to:
-                path = os.path.realpath(os.path.join(zoneinfopath, *tzname.split("/")))
+                path = os.path.realpath(os.path.join(zoneinfo, *tzname.split("/")))
                 real_zone_name = "/".join(path.split(os.path.sep)[directory_depth:])
                 unique_tzs.add(real_zone_name)
 
@@ -155,7 +141,7 @@ def _get_localzone_name(_root="/"):
                 for key, value in found_configs.items():
                     message += f"{key}: {value}\n"
                 message += "Fix the configuration, or set the time zone in a TZ environment variable.\n"
-                raise zoneinfo.ZoneInfoNotFoundError(message)
+                raise utils.ZoneInfoNotFoundError(message)
 
         # We found exactly one config! Use it.
         return list(found_configs.values())[0]
@@ -179,25 +165,24 @@ def _get_localzone(_root="/"):
     tzname = _get_localzone_name(_root)
     if tzname is None:
         # No explicit setting existed. Use localtime
-        log.debug("No explicit setting existed. Use localtime")
         for filename in ("etc/localtime", "usr/local/etc/localtime"):
             tzpath = os.path.join(_root, filename)
 
             if not os.path.exists(tzpath):
                 continue
             with open(tzpath, "rb") as tzfile:
-                tz = zoneinfo.ZoneInfo.from_file(tzfile, key="local")
+                tz = pds.wrap_zone(ZoneInfo.from_file(tzfile, key="local"))
                 break
         else:
             warnings.warn("Can not find any timezone configuration, defaulting to UTC.")
             tz = timezone.utc
     else:
-        tz = zoneinfo.ZoneInfo(tzname)
+        tz = pds.timezone(tzname)
 
     if _root == "/":
         # We are using a file in etc to name the timezone.
         # Verify that the timezone specified there is actually used:
-        utils.assert_tz_offset(tz, error=False)
+        utils.assert_tz_offset(tz)
     return tz
 
 
diff --git a/lib/tzlocal/utils.py b/lib/tzlocal/utils.py
index 4ba82d3d..d1026b32 100644
--- a/lib/tzlocal/utils.py
+++ b/lib/tzlocal/utils.py
@@ -1,9 +1,9 @@
-import logging
+# -*- coding: utf-8 -*-
 import os
 import time
 import datetime
 import calendar
-import warnings
+import pytz_deprecation_shim as pds
 
 try:
     import zoneinfo  # pragma: no cover
@@ -12,7 +12,35 @@ except ImportError:
 
 from tzlocal import windows_tz
 
-log = logging.getLogger("tzlocal")
+
+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():
+    """Get system's timezone offset using built-in library time.
+
+    For the Timezone constants (altzone, daylight, timezone, and tzname), the
+    value is determined by the timezone rules in effect at module load time or
+    the last time tzset() is called and may be incorrect for times in the past.
+
+    To keep compatibility with Windows, we're always importing time module here.
+    """
+
+    localtime = calendar.timegm(time.localtime())
+    gmtime = calendar.timegm(time.gmtime())
+    offset = gmtime - localtime
+    # We could get the localtime and gmtime on either side of a second switch
+    # 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  # pragma: no cover
+    else:
+        return -time.timezone  # pragma: no cover
 
 
 def get_tz_offset(tz):
@@ -20,27 +48,19 @@ def get_tz_offset(tz):
     return int(datetime.datetime.now(tz).utcoffset().total_seconds())
 
 
-def assert_tz_offset(tz, error=True):
+def assert_tz_offset(tz):
     """Assert that system's timezone offset equals to the timezone offset found.
 
     If they don't match, we probably have a misconfiguration, for example, an
-    incorrect timezone set in /etc/timezone file in systemd distributions.
-
-    If error is True, this method will raise a ValueError, otherwise it will
-    emit a warning.
-    """
-
+    incorrect timezone set in /etc/timezone file in systemd distributions."""
     tz_offset = get_tz_offset(tz)
-    system_offset = calendar.timegm(time.localtime()) - calendar.timegm(time.gmtime())
-    # No one has timezone offsets less than a minute, so this should be close enough:
-    if abs(tz_offset - system_offset) > 60:
+    system_offset = get_system_offset()
+    if tz_offset != system_offset:
         msg = (
             "Timezone offset does not match system offset: {} != {}. "
             "Please, check your config files."
         ).format(tz_offset, system_offset)
-        if error:
-            raise ValueError(msg)
-        warnings.warn(msg)
+        raise ValueError(msg)
 
 
 def _tz_name_from_env(tzenv=None):
@@ -50,8 +70,6 @@ def _tz_name_from_env(tzenv=None):
     if not tzenv:
         return None
 
-    log.debug(f"Found a TZ environment: {tzenv}")
-
     if tzenv[0] == ":":
         tzenv = tzenv[1:]
 
@@ -74,9 +92,6 @@ def _tz_name_from_env(tzenv=None):
             # Indeed
             return parts[-1]
 
-    log.debug("TZ does not contain a time zone name")
-    return None
-
 
 def _tz_from_env(tzenv=None):
     if tzenv is None:
@@ -97,16 +112,17 @@ def _tz_from_env(tzenv=None):
             # Nope, not a standard timezone name, just take the filename
             tzname = tzenv.split(os.sep)[-1]
         with open(tzenv, "rb") as tzfile:
-            return zoneinfo.ZoneInfo.from_file(tzfile, key=tzname)
+            zone = zoneinfo.ZoneInfo.from_file(tzfile, key=tzname)
+            return pds.wrap_zone(zone)
 
     # TZ must specify a zoneinfo zone.
     try:
-        tz = zoneinfo.ZoneInfo(tzenv)
+        tz = pds.timezone(tzenv)
         # That worked, so we return this:
         return tz
-    except zoneinfo.ZoneInfoNotFoundError:
+    except pds.UnknownTimeZoneError:
         # Nope, it's something like "PST4DST" etc, we can't handle that.
-        raise zoneinfo.ZoneInfoNotFoundError(
+        raise ZoneInfoNotFoundError(
             "tzlocal() does not support non-zoneinfo timezones like %s. \n"
-            "Please use a timezone in the form of Continent/City" % tzenv
+            "Please use a timezone in the form of Continent/City"
         ) from None
diff --git a/lib/tzlocal/win32.py b/lib/tzlocal/win32.py
index 9e8dc735..720ab2b7 100644
--- a/lib/tzlocal/win32.py
+++ b/lib/tzlocal/win32.py
@@ -1,24 +1,17 @@
-import logging
 from datetime import datetime
+import pytz_deprecation_shim as pds
 
 try:
     import _winreg as winreg
 except ImportError:
     import winreg
 
-try:
-    import zoneinfo  # pragma: no cover
-except ImportError:
-    from backports import zoneinfo  # pragma: no cover
-
 from tzlocal.windows_tz import win_tz
 from tzlocal import utils
 
 _cache_tz = None
 _cache_tz_name = None
 
-log = logging.getLogger("tzlocal")
-
 
 def valuestodict(key):
     """Convert a registry key's values to a dictionary."""
@@ -55,7 +48,6 @@ def _get_localzone_name():
     if tzenv:
         return tzenv
 
-    log.debug("Looking up time zone info from registry")
     handle = winreg.ConnectRegistry(None, winreg.HKEY_LOCAL_MACHINE)
 
     TZLOCALKEYNAME = r"SYSTEM\CurrentControlSet\Control\TimeZoneInformation"
@@ -82,13 +74,13 @@ def _get_localzone_name():
 
     # Return what we have.
     if timezone is None:
-        raise zoneinfo.ZoneInfoNotFoundError(tzkeyname)
+        raise utils.ZoneInfoNotFoundError(tzkeyname)
 
     if keyvalues.get("DynamicDaylightTimeDisabled", 0) == 1:
         # DST is disabled, so don't return the timezone name,
         # instead return Etc/GMT+offset
 
-        tz = zoneinfo.ZoneInfo(timezone)
+        tz = pds.timezone(timezone)
         has_dst, std_offset, dst_offset = _get_dst_info(tz)
         if not has_dst:
             # The DST is turned off in the windows configuration,
@@ -96,15 +88,13 @@ def _get_localzone_name():
             return timezone
 
         if std_offset is None:
-            raise zoneinfo.ZoneInfoNotFoundError(
-                f"{tzkeyname} claims to not have a non-DST time!?"
-            )
+            raise utils.ZoneInfoNotFoundError(
+                f"{tzkeyname} claims to not have a non-DST time!?")
 
         if std_offset % 3600:
             # I can't convert this to an hourly offset
-            raise zoneinfo.ZoneInfoNotFoundError(
-                f"tzlocal can't support disabling DST in the {timezone} zone."
-            )
+            raise utils.ZoneInfoNotFoundError(
+                f"tzlocal can't support disabling DST in the {timezone} zone.")
 
         # This has whole hours as offset, return it as Etc/GMT
         return f"Etc/GMT{-std_offset//3600:+.0f}"
@@ -126,13 +116,13 @@ def get_localzone():
 
     global _cache_tz
     if _cache_tz is None:
-        _cache_tz = zoneinfo.ZoneInfo(get_localzone_name())
+        _cache_tz = pds.timezone(get_localzone_name())
 
     if not utils._tz_name_from_env():
         # If the timezone does NOT come from a TZ environment variable,
         # verify that it's correct. If it's from the environment,
         # we accept it, this is so you can run tests with different timezones.
-        utils.assert_tz_offset(_cache_tz, error=False)
+        utils.assert_tz_offset(_cache_tz)
 
     return _cache_tz
 
@@ -142,6 +132,6 @@ def reload_localzone():
     global _cache_tz
     global _cache_tz_name
     _cache_tz_name = _get_localzone_name()
-    _cache_tz = zoneinfo.ZoneInfo(_cache_tz_name)
-    utils.assert_tz_offset(_cache_tz, error=False)
+    _cache_tz = pds.timezone(_cache_tz_name)
+    utils.assert_tz_offset(_cache_tz)
     return _cache_tz
diff --git a/lib/tzlocal/windows_tz.py b/lib/tzlocal/windows_tz.py
index ed49c4ac..0d285037 100644
--- a/lib/tzlocal/windows_tz.py
+++ b/lib/tzlocal/windows_tz.py
@@ -1,718 +1,699 @@
 # This file is autogenerated by the update_windows_mapping.py script
 # Do not edit.
-win_tz = {
-    "AUS Central Standard Time": "Australia/Darwin",
-    "AUS Eastern Standard Time": "Australia/Sydney",
-    "Afghanistan Standard Time": "Asia/Kabul",
-    "Alaskan Standard Time": "America/Anchorage",
-    "Aleutian Standard Time": "America/Adak",
-    "Altai Standard Time": "Asia/Barnaul",
-    "Arab Standard Time": "Asia/Riyadh",
-    "Arabian Standard Time": "Asia/Dubai",
-    "Arabic Standard Time": "Asia/Baghdad",
-    "Argentina Standard Time": "America/Buenos_Aires",
-    "Astrakhan Standard Time": "Europe/Astrakhan",
-    "Atlantic Standard Time": "America/Halifax",
-    "Aus Central W. Standard Time": "Australia/Eucla",
-    "Azerbaijan Standard Time": "Asia/Baku",
-    "Azores Standard Time": "Atlantic/Azores",
-    "Bahia Standard Time": "America/Bahia",
-    "Bangladesh Standard Time": "Asia/Dhaka",
-    "Belarus Standard Time": "Europe/Minsk",
-    "Bougainville Standard Time": "Pacific/Bougainville",
-    "Canada Central Standard Time": "America/Regina",
-    "Cape Verde Standard Time": "Atlantic/Cape_Verde",
-    "Caucasus Standard Time": "Asia/Yerevan",
-    "Cen. Australia Standard Time": "Australia/Adelaide",
-    "Central America Standard Time": "America/Guatemala",
-    "Central Asia Standard Time": "Asia/Almaty",
-    "Central Brazilian Standard Time": "America/Cuiaba",
-    "Central Europe Standard Time": "Europe/Budapest",
-    "Central European Standard Time": "Europe/Warsaw",
-    "Central Pacific Standard Time": "Pacific/Guadalcanal",
-    "Central Standard Time": "America/Chicago",
-    "Central Standard Time (Mexico)": "America/Mexico_City",
-    "Chatham Islands Standard Time": "Pacific/Chatham",
-    "China Standard Time": "Asia/Shanghai",
-    "Cuba Standard Time": "America/Havana",
-    "Dateline Standard Time": "Etc/GMT+12",
-    "E. Africa Standard Time": "Africa/Nairobi",
-    "E. Australia Standard Time": "Australia/Brisbane",
-    "E. Europe Standard Time": "Europe/Chisinau",
-    "E. South America Standard Time": "America/Sao_Paulo",
-    "Easter Island Standard Time": "Pacific/Easter",
-    "Eastern Standard Time": "America/New_York",
-    "Eastern Standard Time (Mexico)": "America/Cancun",
-    "Egypt Standard Time": "Africa/Cairo",
-    "Ekaterinburg Standard Time": "Asia/Yekaterinburg",
-    "FLE Standard Time": "Europe/Kiev",
-    "Fiji Standard Time": "Pacific/Fiji",
-    "GMT Standard Time": "Europe/London",
-    "GTB Standard Time": "Europe/Bucharest",
-    "Georgian Standard Time": "Asia/Tbilisi",
-    "Greenland Standard Time": "America/Godthab",
-    "Greenwich Standard Time": "Atlantic/Reykjavik",
-    "Haiti Standard Time": "America/Port-au-Prince",
-    "Hawaiian Standard Time": "Pacific/Honolulu",
-    "India Standard Time": "Asia/Calcutta",
-    "Iran Standard Time": "Asia/Tehran",
-    "Israel Standard Time": "Asia/Jerusalem",
-    "Jordan Standard Time": "Asia/Amman",
-    "Kaliningrad Standard Time": "Europe/Kaliningrad",
-    "Korea Standard Time": "Asia/Seoul",
-    "Libya Standard Time": "Africa/Tripoli",
-    "Line Islands Standard Time": "Pacific/Kiritimati",
-    "Lord Howe Standard Time": "Australia/Lord_Howe",
-    "Magadan Standard Time": "Asia/Magadan",
-    "Magallanes Standard Time": "America/Punta_Arenas",
-    "Marquesas Standard Time": "Pacific/Marquesas",
-    "Mauritius Standard Time": "Indian/Mauritius",
-    "Middle East Standard Time": "Asia/Beirut",
-    "Montevideo Standard Time": "America/Montevideo",
-    "Morocco Standard Time": "Africa/Casablanca",
-    "Mountain Standard Time": "America/Denver",
-    "Mountain Standard Time (Mexico)": "America/Mazatlan",
-    "Myanmar Standard Time": "Asia/Rangoon",
-    "N. Central Asia Standard Time": "Asia/Novosibirsk",
-    "Namibia Standard Time": "Africa/Windhoek",
-    "Nepal Standard Time": "Asia/Katmandu",
-    "New Zealand Standard Time": "Pacific/Auckland",
-    "Newfoundland Standard Time": "America/St_Johns",
-    "Norfolk Standard Time": "Pacific/Norfolk",
-    "North Asia East Standard Time": "Asia/Irkutsk",
-    "North Asia Standard Time": "Asia/Krasnoyarsk",
-    "North Korea Standard Time": "Asia/Pyongyang",
-    "Omsk Standard Time": "Asia/Omsk",
-    "Pacific SA Standard Time": "America/Santiago",
-    "Pacific Standard Time": "America/Los_Angeles",
-    "Pacific Standard Time (Mexico)": "America/Tijuana",
-    "Pakistan Standard Time": "Asia/Karachi",
-    "Paraguay Standard Time": "America/Asuncion",
-    "Qyzylorda Standard Time": "Asia/Qyzylorda",
-    "Romance Standard Time": "Europe/Paris",
-    "Russia Time Zone 10": "Asia/Srednekolymsk",
-    "Russia Time Zone 11": "Asia/Kamchatka",
-    "Russia Time Zone 3": "Europe/Samara",
-    "Russian Standard Time": "Europe/Moscow",
-    "SA Eastern Standard Time": "America/Cayenne",
-    "SA Pacific Standard Time": "America/Bogota",
-    "SA Western Standard Time": "America/La_Paz",
-    "SE Asia Standard Time": "Asia/Bangkok",
-    "Saint Pierre Standard Time": "America/Miquelon",
-    "Sakhalin Standard Time": "Asia/Sakhalin",
-    "Samoa Standard Time": "Pacific/Apia",
-    "Sao Tome Standard Time": "Africa/Sao_Tome",
-    "Saratov Standard Time": "Europe/Saratov",
-    "Singapore Standard Time": "Asia/Singapore",
-    "South Africa Standard Time": "Africa/Johannesburg",
-    "South Sudan Standard Time": "Africa/Juba",
-    "Sri Lanka Standard Time": "Asia/Colombo",
-    "Sudan Standard Time": "Africa/Khartoum",
-    "Syria Standard Time": "Asia/Damascus",
-    "Taipei Standard Time": "Asia/Taipei",
-    "Tasmania Standard Time": "Australia/Hobart",
-    "Tocantins Standard Time": "America/Araguaina",
-    "Tokyo Standard Time": "Asia/Tokyo",
-    "Tomsk Standard Time": "Asia/Tomsk",
-    "Tonga Standard Time": "Pacific/Tongatapu",
-    "Transbaikal Standard Time": "Asia/Chita",
-    "Turkey Standard Time": "Europe/Istanbul",
-    "Turks And Caicos Standard Time": "America/Grand_Turk",
-    "US Eastern Standard Time": "America/Indianapolis",
-    "US Mountain Standard Time": "America/Phoenix",
-    "UTC": "Etc/UTC",
-    "UTC+12": "Etc/GMT-12",
-    "UTC+13": "Etc/GMT-13",
-    "UTC-02": "Etc/GMT+2",
-    "UTC-08": "Etc/GMT+8",
-    "UTC-09": "Etc/GMT+9",
-    "UTC-11": "Etc/GMT+11",
-    "Ulaanbaatar Standard Time": "Asia/Ulaanbaatar",
-    "Venezuela Standard Time": "America/Caracas",
-    "Vladivostok Standard Time": "Asia/Vladivostok",
-    "Volgograd Standard Time": "Europe/Volgograd",
-    "W. Australia Standard Time": "Australia/Perth",
-    "W. Central Africa Standard Time": "Africa/Lagos",
-    "W. Europe Standard Time": "Europe/Berlin",
-    "W. Mongolia Standard Time": "Asia/Hovd",
-    "West Asia Standard Time": "Asia/Tashkent",
-    "West Bank Standard Time": "Asia/Hebron",
-    "West Pacific Standard Time": "Pacific/Port_Moresby",
-    "Yakutsk Standard Time": "Asia/Yakutsk",
-    "Yukon Standard Time": "America/Whitehorse",
-}
+win_tz = {'AUS Central Standard Time': 'Australia/Darwin',
+ 'AUS Eastern Standard Time': 'Australia/Sydney',
+ 'Afghanistan Standard Time': 'Asia/Kabul',
+ 'Alaskan Standard Time': 'America/Anchorage',
+ 'Aleutian Standard Time': 'America/Adak',
+ 'Altai Standard Time': 'Asia/Barnaul',
+ 'Arab Standard Time': 'Asia/Riyadh',
+ 'Arabian Standard Time': 'Asia/Dubai',
+ 'Arabic Standard Time': 'Asia/Baghdad',
+ 'Argentina Standard Time': 'America/Buenos_Aires',
+ 'Astrakhan Standard Time': 'Europe/Astrakhan',
+ 'Atlantic Standard Time': 'America/Halifax',
+ 'Aus Central W. Standard Time': 'Australia/Eucla',
+ 'Azerbaijan Standard Time': 'Asia/Baku',
+ 'Azores Standard Time': 'Atlantic/Azores',
+ 'Bahia Standard Time': 'America/Bahia',
+ 'Bangladesh Standard Time': 'Asia/Dhaka',
+ 'Belarus Standard Time': 'Europe/Minsk',
+ 'Bougainville Standard Time': 'Pacific/Bougainville',
+ 'Canada Central Standard Time': 'America/Regina',
+ 'Cape Verde Standard Time': 'Atlantic/Cape_Verde',
+ 'Caucasus Standard Time': 'Asia/Yerevan',
+ 'Cen. Australia Standard Time': 'Australia/Adelaide',
+ 'Central America Standard Time': 'America/Guatemala',
+ 'Central Asia Standard Time': 'Asia/Almaty',
+ 'Central Brazilian Standard Time': 'America/Cuiaba',
+ 'Central Europe Standard Time': 'Europe/Budapest',
+ 'Central European Standard Time': 'Europe/Warsaw',
+ 'Central Pacific Standard Time': 'Pacific/Guadalcanal',
+ 'Central Standard Time': 'America/Chicago',
+ 'Central Standard Time (Mexico)': 'America/Mexico_City',
+ 'Chatham Islands Standard Time': 'Pacific/Chatham',
+ 'China Standard Time': 'Asia/Shanghai',
+ 'Cuba Standard Time': 'America/Havana',
+ 'Dateline Standard Time': 'Etc/GMT+12',
+ 'E. Africa Standard Time': 'Africa/Nairobi',
+ 'E. Australia Standard Time': 'Australia/Brisbane',
+ 'E. Europe Standard Time': 'Europe/Chisinau',
+ 'E. South America Standard Time': 'America/Sao_Paulo',
+ 'Easter Island Standard Time': 'Pacific/Easter',
+ 'Eastern Standard Time': 'America/New_York',
+ 'Eastern Standard Time (Mexico)': 'America/Cancun',
+ 'Egypt Standard Time': 'Africa/Cairo',
+ 'Ekaterinburg Standard Time': 'Asia/Yekaterinburg',
+ 'FLE Standard Time': 'Europe/Kiev',
+ 'Fiji Standard Time': 'Pacific/Fiji',
+ 'GMT Standard Time': 'Europe/London',
+ 'GTB Standard Time': 'Europe/Bucharest',
+ 'Georgian Standard Time': 'Asia/Tbilisi',
+ 'Greenland Standard Time': 'America/Godthab',
+ 'Greenwich Standard Time': 'Atlantic/Reykjavik',
+ 'Haiti Standard Time': 'America/Port-au-Prince',
+ 'Hawaiian Standard Time': 'Pacific/Honolulu',
+ 'India Standard Time': 'Asia/Calcutta',
+ 'Iran Standard Time': 'Asia/Tehran',
+ 'Israel Standard Time': 'Asia/Jerusalem',
+ 'Jordan Standard Time': 'Asia/Amman',
+ 'Kaliningrad Standard Time': 'Europe/Kaliningrad',
+ 'Korea Standard Time': 'Asia/Seoul',
+ 'Libya Standard Time': 'Africa/Tripoli',
+ 'Line Islands Standard Time': 'Pacific/Kiritimati',
+ 'Lord Howe Standard Time': 'Australia/Lord_Howe',
+ 'Magadan Standard Time': 'Asia/Magadan',
+ 'Magallanes Standard Time': 'America/Punta_Arenas',
+ 'Marquesas Standard Time': 'Pacific/Marquesas',
+ 'Mauritius Standard Time': 'Indian/Mauritius',
+ 'Middle East Standard Time': 'Asia/Beirut',
+ 'Montevideo Standard Time': 'America/Montevideo',
+ 'Morocco Standard Time': 'Africa/Casablanca',
+ 'Mountain Standard Time': 'America/Denver',
+ 'Mountain Standard Time (Mexico)': 'America/Chihuahua',
+ 'Myanmar Standard Time': 'Asia/Rangoon',
+ 'N. Central Asia Standard Time': 'Asia/Novosibirsk',
+ 'Namibia Standard Time': 'Africa/Windhoek',
+ 'Nepal Standard Time': 'Asia/Katmandu',
+ 'New Zealand Standard Time': 'Pacific/Auckland',
+ 'Newfoundland Standard Time': 'America/St_Johns',
+ 'Norfolk Standard Time': 'Pacific/Norfolk',
+ 'North Asia East Standard Time': 'Asia/Irkutsk',
+ 'North Asia Standard Time': 'Asia/Krasnoyarsk',
+ 'North Korea Standard Time': 'Asia/Pyongyang',
+ 'Omsk Standard Time': 'Asia/Omsk',
+ 'Pacific SA Standard Time': 'America/Santiago',
+ 'Pacific Standard Time': 'America/Los_Angeles',
+ 'Pacific Standard Time (Mexico)': 'America/Tijuana',
+ 'Pakistan Standard Time': 'Asia/Karachi',
+ 'Paraguay Standard Time': 'America/Asuncion',
+ 'Qyzylorda Standard Time': 'Asia/Qyzylorda',
+ 'Romance Standard Time': 'Europe/Paris',
+ 'Russia Time Zone 10': 'Asia/Srednekolymsk',
+ 'Russia Time Zone 11': 'Asia/Kamchatka',
+ 'Russia Time Zone 3': 'Europe/Samara',
+ 'Russian Standard Time': 'Europe/Moscow',
+ 'SA Eastern Standard Time': 'America/Cayenne',
+ 'SA Pacific Standard Time': 'America/Bogota',
+ 'SA Western Standard Time': 'America/La_Paz',
+ 'SE Asia Standard Time': 'Asia/Bangkok',
+ 'Saint Pierre Standard Time': 'America/Miquelon',
+ 'Sakhalin Standard Time': 'Asia/Sakhalin',
+ 'Samoa Standard Time': 'Pacific/Apia',
+ 'Sao Tome Standard Time': 'Africa/Sao_Tome',
+ 'Saratov Standard Time': 'Europe/Saratov',
+ 'Singapore Standard Time': 'Asia/Singapore',
+ 'South Africa Standard Time': 'Africa/Johannesburg',
+ 'South Sudan Standard Time': 'Africa/Juba',
+ 'Sri Lanka Standard Time': 'Asia/Colombo',
+ 'Sudan Standard Time': 'Africa/Khartoum',
+ 'Syria Standard Time': 'Asia/Damascus',
+ 'Taipei Standard Time': 'Asia/Taipei',
+ 'Tasmania Standard Time': 'Australia/Hobart',
+ 'Tocantins Standard Time': 'America/Araguaina',
+ 'Tokyo Standard Time': 'Asia/Tokyo',
+ 'Tomsk Standard Time': 'Asia/Tomsk',
+ 'Tonga Standard Time': 'Pacific/Tongatapu',
+ 'Transbaikal Standard Time': 'Asia/Chita',
+ 'Turkey Standard Time': 'Europe/Istanbul',
+ 'Turks And Caicos Standard Time': 'America/Grand_Turk',
+ 'US Eastern Standard Time': 'America/Indianapolis',
+ 'US Mountain Standard Time': 'America/Phoenix',
+ 'UTC': 'Etc/UTC',
+ 'UTC+12': 'Etc/GMT-12',
+ 'UTC+13': 'Etc/GMT-13',
+ 'UTC-02': 'Etc/GMT+2',
+ 'UTC-08': 'Etc/GMT+8',
+ 'UTC-09': 'Etc/GMT+9',
+ 'UTC-11': 'Etc/GMT+11',
+ 'Ulaanbaatar Standard Time': 'Asia/Ulaanbaatar',
+ 'Venezuela Standard Time': 'America/Caracas',
+ 'Vladivostok Standard Time': 'Asia/Vladivostok',
+ 'Volgograd Standard Time': 'Europe/Volgograd',
+ 'W. Australia Standard Time': 'Australia/Perth',
+ 'W. Central Africa Standard Time': 'Africa/Lagos',
+ 'W. Europe Standard Time': 'Europe/Berlin',
+ 'W. Mongolia Standard Time': 'Asia/Hovd',
+ 'West Asia Standard Time': 'Asia/Tashkent',
+ 'West Bank Standard Time': 'Asia/Hebron',
+ 'West Pacific Standard Time': 'Pacific/Port_Moresby',
+ 'Yakutsk Standard Time': 'Asia/Yakutsk',
+ 'Yukon Standard Time': 'America/Whitehorse'}
 
 # Old name for the win_tz variable:
 tz_names = win_tz
 
-tz_win = {
-    "": "Central Standard Time (Mexico)",
-    "Africa/Abidjan": "Greenwich Standard Time",
-    "Africa/Accra": "Greenwich Standard Time",
-    "Africa/Addis_Ababa": "E. Africa Standard Time",
-    "Africa/Algiers": "W. Central Africa Standard Time",
-    "Africa/Asmara": "E. Africa Standard Time",
-    "Africa/Asmera": "E. Africa Standard Time",
-    "Africa/Bamako": "Greenwich Standard Time",
-    "Africa/Bangui": "W. Central Africa Standard Time",
-    "Africa/Banjul": "Greenwich Standard Time",
-    "Africa/Bissau": "Greenwich Standard Time",
-    "Africa/Blantyre": "South Africa Standard Time",
-    "Africa/Brazzaville": "W. Central Africa Standard Time",
-    "Africa/Bujumbura": "South Africa Standard Time",
-    "Africa/Cairo": "Egypt Standard Time",
-    "Africa/Casablanca": "Morocco Standard Time",
-    "Africa/Ceuta": "Romance Standard Time",
-    "Africa/Conakry": "Greenwich Standard Time",
-    "Africa/Dakar": "Greenwich Standard Time",
-    "Africa/Dar_es_Salaam": "E. Africa Standard Time",
-    "Africa/Djibouti": "E. Africa Standard Time",
-    "Africa/Douala": "W. Central Africa Standard Time",
-    "Africa/El_Aaiun": "Morocco Standard Time",
-    "Africa/Freetown": "Greenwich Standard Time",
-    "Africa/Gaborone": "South Africa Standard Time",
-    "Africa/Harare": "South Africa Standard Time",
-    "Africa/Johannesburg": "South Africa Standard Time",
-    "Africa/Juba": "South Sudan Standard Time",
-    "Africa/Kampala": "E. Africa Standard Time",
-    "Africa/Khartoum": "Sudan Standard Time",
-    "Africa/Kigali": "South Africa Standard Time",
-    "Africa/Kinshasa": "W. Central Africa Standard Time",
-    "Africa/Lagos": "W. Central Africa Standard Time",
-    "Africa/Libreville": "W. Central Africa Standard Time",
-    "Africa/Lome": "Greenwich Standard Time",
-    "Africa/Luanda": "W. Central Africa Standard Time",
-    "Africa/Lubumbashi": "South Africa Standard Time",
-    "Africa/Lusaka": "South Africa Standard Time",
-    "Africa/Malabo": "W. Central Africa Standard Time",
-    "Africa/Maputo": "South Africa Standard Time",
-    "Africa/Maseru": "South Africa Standard Time",
-    "Africa/Mbabane": "South Africa Standard Time",
-    "Africa/Mogadishu": "E. Africa Standard Time",
-    "Africa/Monrovia": "Greenwich Standard Time",
-    "Africa/Nairobi": "E. Africa Standard Time",
-    "Africa/Ndjamena": "W. Central Africa Standard Time",
-    "Africa/Niamey": "W. Central Africa Standard Time",
-    "Africa/Nouakchott": "Greenwich Standard Time",
-    "Africa/Ouagadougou": "Greenwich Standard Time",
-    "Africa/Porto-Novo": "W. Central Africa Standard Time",
-    "Africa/Sao_Tome": "Sao Tome Standard Time",
-    "Africa/Timbuktu": "Greenwich Standard Time",
-    "Africa/Tripoli": "Libya Standard Time",
-    "Africa/Tunis": "W. Central Africa Standard Time",
-    "Africa/Windhoek": "Namibia Standard Time",
-    "America/Adak": "Aleutian Standard Time",
-    "America/Anchorage": "Alaskan Standard Time",
-    "America/Anguilla": "SA Western Standard Time",
-    "America/Antigua": "SA Western Standard Time",
-    "America/Araguaina": "Tocantins Standard Time",
-    "America/Argentina/La_Rioja": "Argentina Standard Time",
-    "America/Argentina/Rio_Gallegos": "Argentina Standard Time",
-    "America/Argentina/Salta": "Argentina Standard Time",
-    "America/Argentina/San_Juan": "Argentina Standard Time",
-    "America/Argentina/San_Luis": "Argentina Standard Time",
-    "America/Argentina/Tucuman": "Argentina Standard Time",
-    "America/Argentina/Ushuaia": "Argentina Standard Time",
-    "America/Aruba": "SA Western Standard Time",
-    "America/Asuncion": "Paraguay Standard Time",
-    "America/Atikokan": "SA Pacific Standard Time",
-    "America/Atka": "Aleutian Standard Time",
-    "America/Bahia": "Bahia Standard Time",
-    "America/Bahia_Banderas": "Central Standard Time (Mexico)",
-    "America/Barbados": "SA Western Standard Time",
-    "America/Belem": "SA Eastern Standard Time",
-    "America/Belize": "Central America Standard Time",
-    "America/Blanc-Sablon": "SA Western Standard Time",
-    "America/Boa_Vista": "SA Western Standard Time",
-    "America/Bogota": "SA Pacific Standard Time",
-    "America/Boise": "Mountain Standard Time",
-    "America/Buenos_Aires": "Argentina Standard Time",
-    "America/Cambridge_Bay": "Mountain Standard Time",
-    "America/Campo_Grande": "Central Brazilian Standard Time",
-    "America/Cancun": "Eastern Standard Time (Mexico)",
-    "America/Caracas": "Venezuela Standard Time",
-    "America/Catamarca": "Argentina Standard Time",
-    "America/Cayenne": "SA Eastern Standard Time",
-    "America/Cayman": "SA Pacific Standard Time",
-    "America/Chicago": "Central Standard Time",
-    "America/Chihuahua": "Central Standard Time (Mexico)",
-    "America/Ciudad_Juarez": "Mountain Standard Time",
-    "America/Coral_Harbour": "SA Pacific Standard Time",
-    "America/Cordoba": "Argentina Standard Time",
-    "America/Costa_Rica": "Central America Standard Time",
-    "America/Creston": "US Mountain Standard Time",
-    "America/Cuiaba": "Central Brazilian Standard Time",
-    "America/Curacao": "SA Western Standard Time",
-    "America/Danmarkshavn": "Greenwich Standard Time",
-    "America/Dawson": "Yukon Standard Time",
-    "America/Dawson_Creek": "US Mountain Standard Time",
-    "America/Denver": "Mountain Standard Time",
-    "America/Detroit": "Eastern Standard Time",
-    "America/Dominica": "SA Western Standard Time",
-    "America/Edmonton": "Mountain Standard Time",
-    "America/Eirunepe": "SA Pacific Standard Time",
-    "America/El_Salvador": "Central America Standard Time",
-    "America/Ensenada": "Pacific Standard Time (Mexico)",
-    "America/Fort_Nelson": "US Mountain Standard Time",
-    "America/Fortaleza": "SA Eastern Standard Time",
-    "America/Glace_Bay": "Atlantic Standard Time",
-    "America/Godthab": "Greenland Standard Time",
-    "America/Goose_Bay": "Atlantic Standard Time",
-    "America/Grand_Turk": "Turks And Caicos Standard Time",
-    "America/Grenada": "SA Western Standard Time",
-    "America/Guadeloupe": "SA Western Standard Time",
-    "America/Guatemala": "Central America Standard Time",
-    "America/Guayaquil": "SA Pacific Standard Time",
-    "America/Guyana": "SA Western Standard Time",
-    "America/Halifax": "Atlantic Standard Time",
-    "America/Havana": "Cuba Standard Time",
-    "America/Hermosillo": "US Mountain Standard Time",
-    "America/Indiana/Knox": "Central Standard Time",
-    "America/Indiana/Marengo": "US Eastern Standard Time",
-    "America/Indiana/Petersburg": "Eastern Standard Time",
-    "America/Indiana/Tell_City": "Central Standard Time",
-    "America/Indiana/Vevay": "US Eastern Standard Time",
-    "America/Indiana/Vincennes": "Eastern Standard Time",
-    "America/Indiana/Winamac": "Eastern Standard Time",
-    "America/Indianapolis": "US Eastern Standard Time",
-    "America/Inuvik": "Mountain Standard Time",
-    "America/Iqaluit": "Eastern Standard Time",
-    "America/Jamaica": "SA Pacific Standard Time",
-    "America/Jujuy": "Argentina Standard Time",
-    "America/Juneau": "Alaskan Standard Time",
-    "America/Kentucky/Monticello": "Eastern Standard Time",
-    "America/Knox_IN": "Central Standard Time",
-    "America/Kralendijk": "SA Western Standard Time",
-    "America/La_Paz": "SA Western Standard Time",
-    "America/Lima": "SA Pacific Standard Time",
-    "America/Los_Angeles": "Pacific Standard Time",
-    "America/Louisville": "Eastern Standard Time",
-    "America/Lower_Princes": "SA Western Standard Time",
-    "America/Maceio": "SA Eastern Standard Time",
-    "America/Managua": "Central America Standard Time",
-    "America/Manaus": "SA Western Standard Time",
-    "America/Marigot": "SA Western Standard Time",
-    "America/Martinique": "SA Western Standard Time",
-    "America/Matamoros": "Central Standard Time",
-    "America/Mazatlan": "Mountain Standard Time (Mexico)",
-    "America/Mendoza": "Argentina Standard Time",
-    "America/Menominee": "Central Standard Time",
-    "America/Merida": "Central Standard Time (Mexico)",
-    "America/Metlakatla": "Alaskan Standard Time",
-    "America/Mexico_City": "Central Standard Time (Mexico)",
-    "America/Miquelon": "Saint Pierre Standard Time",
-    "America/Moncton": "Atlantic Standard Time",
-    "America/Monterrey": "Central Standard Time (Mexico)",
-    "America/Montevideo": "Montevideo Standard Time",
-    "America/Montreal": "Eastern Standard Time",
-    "America/Montserrat": "SA Western Standard Time",
-    "America/Nassau": "Eastern Standard Time",
-    "America/New_York": "Eastern Standard Time",
-    "America/Nipigon": "Eastern Standard Time",
-    "America/Nome": "Alaskan Standard Time",
-    "America/Noronha": "UTC-02",
-    "America/North_Dakota/Beulah": "Central Standard Time",
-    "America/North_Dakota/Center": "Central Standard Time",
-    "America/North_Dakota/New_Salem": "Central Standard Time",
-    "America/Ojinaga": "Central Standard Time",
-    "America/Panama": "SA Pacific Standard Time",
-    "America/Pangnirtung": "Eastern Standard Time",
-    "America/Paramaribo": "SA Eastern Standard Time",
-    "America/Phoenix": "US Mountain Standard Time",
-    "America/Port-au-Prince": "Haiti Standard Time",
-    "America/Port_of_Spain": "SA Western Standard Time",
-    "America/Porto_Acre": "SA Pacific Standard Time",
-    "America/Porto_Velho": "SA Western Standard Time",
-    "America/Puerto_Rico": "SA Western Standard Time",
-    "America/Punta_Arenas": "Magallanes Standard Time",
-    "America/Rainy_River": "Central Standard Time",
-    "America/Rankin_Inlet": "Central Standard Time",
-    "America/Recife": "SA Eastern Standard Time",
-    "America/Regina": "Canada Central Standard Time",
-    "America/Resolute": "Central Standard Time",
-    "America/Rio_Branco": "SA Pacific Standard Time",
-    "America/Santa_Isabel": "Pacific Standard Time (Mexico)",
-    "America/Santarem": "SA Eastern Standard Time",
-    "America/Santiago": "Pacific SA Standard Time",
-    "America/Santo_Domingo": "SA Western Standard Time",
-    "America/Sao_Paulo": "E. South America Standard Time",
-    "America/Scoresbysund": "Azores Standard Time",
-    "America/Shiprock": "Mountain Standard Time",
-    "America/Sitka": "Alaskan Standard Time",
-    "America/St_Barthelemy": "SA Western Standard Time",
-    "America/St_Johns": "Newfoundland Standard Time",
-    "America/St_Kitts": "SA Western Standard Time",
-    "America/St_Lucia": "SA Western Standard Time",
-    "America/St_Thomas": "SA Western Standard Time",
-    "America/St_Vincent": "SA Western Standard Time",
-    "America/Swift_Current": "Canada Central Standard Time",
-    "America/Tegucigalpa": "Central America Standard Time",
-    "America/Thule": "Atlantic Standard Time",
-    "America/Thunder_Bay": "Eastern Standard Time",
-    "America/Tijuana": "Pacific Standard Time (Mexico)",
-    "America/Toronto": "Eastern Standard Time",
-    "America/Tortola": "SA Western Standard Time",
-    "America/Vancouver": "Pacific Standard Time",
-    "America/Virgin": "SA Western Standard Time",
-    "America/Whitehorse": "Yukon Standard Time",
-    "America/Winnipeg": "Central Standard Time",
-    "America/Yakutat": "Alaskan Standard Time",
-    "America/Yellowknife": "Mountain Standard Time",
-    "Antarctica/Casey": "Central Pacific Standard Time",
-    "Antarctica/Davis": "SE Asia Standard Time",
-    "Antarctica/DumontDUrville": "West Pacific Standard Time",
-    "Antarctica/Macquarie": "Tasmania Standard Time",
-    "Antarctica/Mawson": "West Asia Standard Time",
-    "Antarctica/McMurdo": "New Zealand Standard Time",
-    "Antarctica/Palmer": "SA Eastern Standard Time",
-    "Antarctica/Rothera": "SA Eastern Standard Time",
-    "Antarctica/South_Pole": "New Zealand Standard Time",
-    "Antarctica/Syowa": "Arab Standard Time",
-    "Antarctica/Vostok": "Central Asia Standard Time",
-    "Arctic/Longyearbyen": "W. Europe Standard Time",
-    "Asia/Aden": "Arab Standard Time",
-    "Asia/Almaty": "Central Asia Standard Time",
-    "Asia/Amman": "Jordan Standard Time",
-    "Asia/Anadyr": "Russia Time Zone 11",
-    "Asia/Aqtau": "West Asia Standard Time",
-    "Asia/Aqtobe": "West Asia Standard Time",
-    "Asia/Ashgabat": "West Asia Standard Time",
-    "Asia/Ashkhabad": "West Asia Standard Time",
-    "Asia/Atyrau": "West Asia Standard Time",
-    "Asia/Baghdad": "Arabic Standard Time",
-    "Asia/Bahrain": "Arab Standard Time",
-    "Asia/Baku": "Azerbaijan Standard Time",
-    "Asia/Bangkok": "SE Asia Standard Time",
-    "Asia/Barnaul": "Altai Standard Time",
-    "Asia/Beirut": "Middle East Standard Time",
-    "Asia/Bishkek": "Central Asia Standard Time",
-    "Asia/Brunei": "Singapore Standard Time",
-    "Asia/Calcutta": "India Standard Time",
-    "Asia/Chita": "Transbaikal Standard Time",
-    "Asia/Choibalsan": "Ulaanbaatar Standard Time",
-    "Asia/Chongqing": "China Standard Time",
-    "Asia/Chungking": "China Standard Time",
-    "Asia/Colombo": "Sri Lanka Standard Time",
-    "Asia/Dacca": "Bangladesh Standard Time",
-    "Asia/Damascus": "Syria Standard Time",
-    "Asia/Dhaka": "Bangladesh Standard Time",
-    "Asia/Dili": "Tokyo Standard Time",
-    "Asia/Dubai": "Arabian Standard Time",
-    "Asia/Dushanbe": "West Asia Standard Time",
-    "Asia/Famagusta": "GTB Standard Time",
-    "Asia/Gaza": "West Bank Standard Time",
-    "Asia/Harbin": "China Standard Time",
-    "Asia/Hebron": "West Bank Standard Time",
-    "Asia/Hong_Kong": "China Standard Time",
-    "Asia/Hovd": "W. Mongolia Standard Time",
-    "Asia/Irkutsk": "North Asia East Standard Time",
-    "Asia/Istanbul": "Turkey Standard Time",
-    "Asia/Jakarta": "SE Asia Standard Time",
-    "Asia/Jayapura": "Tokyo Standard Time",
-    "Asia/Jerusalem": "Israel Standard Time",
-    "Asia/Kabul": "Afghanistan Standard Time",
-    "Asia/Kamchatka": "Russia Time Zone 11",
-    "Asia/Karachi": "Pakistan Standard Time",
-    "Asia/Kashgar": "Central Asia Standard Time",
-    "Asia/Katmandu": "Nepal Standard Time",
-    "Asia/Khandyga": "Yakutsk Standard Time",
-    "Asia/Krasnoyarsk": "North Asia Standard Time",
-    "Asia/Kuala_Lumpur": "Singapore Standard Time",
-    "Asia/Kuching": "Singapore Standard Time",
-    "Asia/Kuwait": "Arab Standard Time",
-    "Asia/Macao": "China Standard Time",
-    "Asia/Macau": "China Standard Time",
-    "Asia/Magadan": "Magadan Standard Time",
-    "Asia/Makassar": "Singapore Standard Time",
-    "Asia/Manila": "Singapore Standard Time",
-    "Asia/Muscat": "Arabian Standard Time",
-    "Asia/Nicosia": "GTB Standard Time",
-    "Asia/Novokuznetsk": "North Asia Standard Time",
-    "Asia/Novosibirsk": "N. Central Asia Standard Time",
-    "Asia/Omsk": "Omsk Standard Time",
-    "Asia/Oral": "West Asia Standard Time",
-    "Asia/Phnom_Penh": "SE Asia Standard Time",
-    "Asia/Pontianak": "SE Asia Standard Time",
-    "Asia/Pyongyang": "North Korea Standard Time",
-    "Asia/Qatar": "Arab Standard Time",
-    "Asia/Qostanay": "Central Asia Standard Time",
-    "Asia/Qyzylorda": "Qyzylorda Standard Time",
-    "Asia/Rangoon": "Myanmar Standard Time",
-    "Asia/Riyadh": "Arab Standard Time",
-    "Asia/Saigon": "SE Asia Standard Time",
-    "Asia/Sakhalin": "Sakhalin Standard Time",
-    "Asia/Samarkand": "West Asia Standard Time",
-    "Asia/Seoul": "Korea Standard Time",
-    "Asia/Shanghai": "China Standard Time",
-    "Asia/Singapore": "Singapore Standard Time",
-    "Asia/Srednekolymsk": "Russia Time Zone 10",
-    "Asia/Taipei": "Taipei Standard Time",
-    "Asia/Tashkent": "West Asia Standard Time",
-    "Asia/Tbilisi": "Georgian Standard Time",
-    "Asia/Tehran": "Iran Standard Time",
-    "Asia/Tel_Aviv": "Israel Standard Time",
-    "Asia/Thimbu": "Bangladesh Standard Time",
-    "Asia/Thimphu": "Bangladesh Standard Time",
-    "Asia/Tokyo": "Tokyo Standard Time",
-    "Asia/Tomsk": "Tomsk Standard Time",
-    "Asia/Ujung_Pandang": "Singapore Standard Time",
-    "Asia/Ulaanbaatar": "Ulaanbaatar Standard Time",
-    "Asia/Ulan_Bator": "Ulaanbaatar Standard Time",
-    "Asia/Urumqi": "Central Asia Standard Time",
-    "Asia/Ust-Nera": "Vladivostok Standard Time",
-    "Asia/Vientiane": "SE Asia Standard Time",
-    "Asia/Vladivostok": "Vladivostok Standard Time",
-    "Asia/Yakutsk": "Yakutsk Standard Time",
-    "Asia/Yekaterinburg": "Ekaterinburg Standard Time",
-    "Asia/Yerevan": "Caucasus Standard Time",
-    "Atlantic/Azores": "Azores Standard Time",
-    "Atlantic/Bermuda": "Atlantic Standard Time",
-    "Atlantic/Canary": "GMT Standard Time",
-    "Atlantic/Cape_Verde": "Cape Verde Standard Time",
-    "Atlantic/Faeroe": "GMT Standard Time",
-    "Atlantic/Jan_Mayen": "W. Europe Standard Time",
-    "Atlantic/Madeira": "GMT Standard Time",
-    "Atlantic/Reykjavik": "Greenwich Standard Time",
-    "Atlantic/South_Georgia": "UTC-02",
-    "Atlantic/St_Helena": "Greenwich Standard Time",
-    "Atlantic/Stanley": "SA Eastern Standard Time",
-    "Australia/ACT": "AUS Eastern Standard Time",
-    "Australia/Adelaide": "Cen. Australia Standard Time",
-    "Australia/Brisbane": "E. Australia Standard Time",
-    "Australia/Broken_Hill": "Cen. Australia Standard Time",
-    "Australia/Canberra": "AUS Eastern Standard Time",
-    "Australia/Currie": "Tasmania Standard Time",
-    "Australia/Darwin": "AUS Central Standard Time",
-    "Australia/Eucla": "Aus Central W. Standard Time",
-    "Australia/Hobart": "Tasmania Standard Time",
-    "Australia/LHI": "Lord Howe Standard Time",
-    "Australia/Lindeman": "E. Australia Standard Time",
-    "Australia/Lord_Howe": "Lord Howe Standard Time",
-    "Australia/Melbourne": "AUS Eastern Standard Time",
-    "Australia/NSW": "AUS Eastern Standard Time",
-    "Australia/North": "AUS Central Standard Time",
-    "Australia/Perth": "W. Australia Standard Time",
-    "Australia/Queensland": "E. Australia Standard Time",
-    "Australia/South": "Cen. Australia Standard Time",
-    "Australia/Sydney": "AUS Eastern Standard Time",
-    "Australia/Tasmania": "Tasmania Standard Time",
-    "Australia/Victoria": "AUS Eastern Standard Time",
-    "Australia/West": "W. Australia Standard Time",
-    "Australia/Yancowinna": "Cen. Australia Standard Time",
-    "Brazil/Acre": "SA Pacific Standard Time",
-    "Brazil/DeNoronha": "UTC-02",
-    "Brazil/East": "E. South America Standard Time",
-    "Brazil/West": "SA Western Standard Time",
-    "CST6CDT": "Central Standard Time",
-    "Canada/Atlantic": "Atlantic Standard Time",
-    "Canada/Central": "Central Standard Time",
-    "Canada/Eastern": "Eastern Standard Time",
-    "Canada/Mountain": "Mountain Standard Time",
-    "Canada/Newfoundland": "Newfoundland Standard Time",
-    "Canada/Pacific": "Pacific Standard Time",
-    "Canada/Saskatchewan": "Canada Central Standard Time",
-    "Canada/Yukon": "Yukon Standard Time",
-    "Chile/Continental": "Pacific SA Standard Time",
-    "Chile/EasterIsland": "Easter Island Standard Time",
-    "Cuba": "Cuba Standard Time",
-    "EST5EDT": "Eastern Standard Time",
-    "Egypt": "Egypt Standard Time",
-    "Eire": "GMT Standard Time",
-    "Etc/GMT": "UTC",
-    "Etc/GMT+0": "UTC",
-    "Etc/GMT+1": "Cape Verde Standard Time",
-    "Etc/GMT+10": "Hawaiian Standard Time",
-    "Etc/GMT+11": "UTC-11",
-    "Etc/GMT+12": "Dateline Standard Time",
-    "Etc/GMT+2": "UTC-02",
-    "Etc/GMT+3": "SA Eastern Standard Time",
-    "Etc/GMT+4": "SA Western Standard Time",
-    "Etc/GMT+5": "SA Pacific Standard Time",
-    "Etc/GMT+6": "Central America Standard Time",
-    "Etc/GMT+7": "US Mountain Standard Time",
-    "Etc/GMT+8": "UTC-08",
-    "Etc/GMT+9": "UTC-09",
-    "Etc/GMT-0": "UTC",
-    "Etc/GMT-1": "W. Central Africa Standard Time",
-    "Etc/GMT-10": "West Pacific Standard Time",
-    "Etc/GMT-11": "Central Pacific Standard Time",
-    "Etc/GMT-12": "UTC+12",
-    "Etc/GMT-13": "UTC+13",
-    "Etc/GMT-14": "Line Islands Standard Time",
-    "Etc/GMT-2": "South Africa Standard Time",
-    "Etc/GMT-3": "E. Africa Standard Time",
-    "Etc/GMT-4": "Arabian Standard Time",
-    "Etc/GMT-5": "West Asia Standard Time",
-    "Etc/GMT-6": "Central Asia Standard Time",
-    "Etc/GMT-7": "SE Asia Standard Time",
-    "Etc/GMT-8": "Singapore Standard Time",
-    "Etc/GMT-9": "Tokyo Standard Time",
-    "Etc/GMT0": "UTC",
-    "Etc/Greenwich": "UTC",
-    "Etc/UCT": "UTC",
-    "Etc/UTC": "UTC",
-    "Etc/Universal": "UTC",
-    "Etc/Zulu": "UTC",
-    "Europe/Amsterdam": "Romance Standard Time",
-    "Europe/Andorra": "W. Europe Standard Time",
-    "Europe/Astrakhan": "Astrakhan Standard Time",
-    "Europe/Athens": "GTB Standard Time",
-    "Europe/Belfast": "GMT Standard Time",
-    "Europe/Belgrade": "Central Europe Standard Time",
-    "Europe/Berlin": "W. Europe Standard Time",
-    "Europe/Bratislava": "Central Europe Standard Time",
-    "Europe/Brussels": "Romance Standard Time",
-    "Europe/Bucharest": "GTB Standard Time",
-    "Europe/Budapest": "Central Europe Standard Time",
-    "Europe/Busingen": "W. Europe Standard Time",
-    "Europe/Chisinau": "E. Europe Standard Time",
-    "Europe/Copenhagen": "W. Europe Standard Time",
-    "Europe/Dublin": "GMT Standard Time",
-    "Europe/Gibraltar": "W. Europe Standard Time",
-    "Europe/Guernsey": "GMT Standard Time",
-    "Europe/Helsinki": "FLE Standard Time",
-    "Europe/Isle_of_Man": "GMT Standard Time",
-    "Europe/Istanbul": "Turkey Standard Time",
-    "Europe/Jersey": "GMT Standard Time",
-    "Europe/Kaliningrad": "Kaliningrad Standard Time",
-    "Europe/Kiev": "FLE Standard Time",
-    "Europe/Kirov": "Russian Standard Time",
-    "Europe/Lisbon": "GMT Standard Time",
-    "Europe/Ljubljana": "Central Europe Standard Time",
-    "Europe/London": "GMT Standard Time",
-    "Europe/Luxembourg": "Romance Standard Time",
-    "Europe/Madrid": "Romance Standard Time",
-    "Europe/Malta": "W. Europe Standard Time",
-    "Europe/Mariehamn": "FLE Standard Time",
-    "Europe/Minsk": "Belarus Standard Time",
-    "Europe/Monaco": "Romance Standard Time",
-    "Europe/Moscow": "Russian Standard Time",
-    "Europe/Nicosia": "GTB Standard Time",
-    "Europe/Oslo": "W. Europe Standard Time",
-    "Europe/Paris": "Romance Standard Time",
-    "Europe/Podgorica": "Central Europe Standard Time",
-    "Europe/Prague": "Central Europe Standard Time",
-    "Europe/Riga": "FLE Standard Time",
-    "Europe/Rome": "W. Europe Standard Time",
-    "Europe/Samara": "Russia Time Zone 3",
-    "Europe/San_Marino": "W. Europe Standard Time",
-    "Europe/Sarajevo": "Central Europe Standard Time",
-    "Europe/Saratov": "Saratov Standard Time",
-    "Europe/Simferopol": "Russian Standard Time",
-    "Europe/Skopje": "Central Europe Standard Time",
-    "Europe/Sofia": "FLE Standard Time",
-    "Europe/Stockholm": "W. Europe Standard Time",
-    "Europe/Tallinn": "FLE Standard Time",
-    "Europe/Tirane": "Central Europe Standard Time",
-    "Europe/Tiraspol": "E. Europe Standard Time",
-    "Europe/Ulyanovsk": "Astrakhan Standard Time",
-    "Europe/Uzhgorod": "FLE Standard Time",
-    "Europe/Vaduz": "W. Europe Standard Time",
-    "Europe/Vatican": "W. Europe Standard Time",
-    "Europe/Vienna": "W. Europe Standard Time",
-    "Europe/Vilnius": "FLE Standard Time",
-    "Europe/Volgograd": "Volgograd Standard Time",
-    "Europe/Warsaw": "Central European Standard Time",
-    "Europe/Zagreb": "Central Europe Standard Time",
-    "Europe/Zaporozhye": "FLE Standard Time",
-    "Europe/Zurich": "W. Europe Standard Time",
-    "GB": "GMT Standard Time",
-    "GB-Eire": "GMT Standard Time",
-    "GMT+0": "UTC",
-    "GMT-0": "UTC",
-    "GMT0": "UTC",
-    "Greenwich": "UTC",
-    "Hongkong": "China Standard Time",
-    "Iceland": "Greenwich Standard Time",
-    "Indian/Antananarivo": "E. Africa Standard Time",
-    "Indian/Chagos": "Central Asia Standard Time",
-    "Indian/Christmas": "SE Asia Standard Time",
-    "Indian/Cocos": "Myanmar Standard Time",
-    "Indian/Comoro": "E. Africa Standard Time",
-    "Indian/Kerguelen": "West Asia Standard Time",
-    "Indian/Mahe": "Arabian Standard Time",
-    "Indian/Maldives": "West Asia Standard Time",
-    "Indian/Mauritius": "Mauritius Standard Time",
-    "Indian/Mayotte": "E. Africa Standard Time",
-    "Indian/Reunion": "Arabian Standard Time",
-    "Iran": "Iran Standard Time",
-    "Israel": "Israel Standard Time",
-    "Jamaica": "SA Pacific Standard Time",
-    "Japan": "Tokyo Standard Time",
-    "Kwajalein": "UTC+12",
-    "Libya": "Libya Standard Time",
-    "MST7MDT": "Mountain Standard Time",
-    "Mexico/BajaNorte": "Pacific Standard Time (Mexico)",
-    "Mexico/BajaSur": "Mountain Standard Time (Mexico)",
-    "Mexico/General": "Central Standard Time (Mexico)",
-    "NZ": "New Zealand Standard Time",
-    "NZ-CHAT": "Chatham Islands Standard Time",
-    "Navajo": "Mountain Standard Time",
-    "PRC": "China Standard Time",
-    "PST8PDT": "Pacific Standard Time",
-    "Pacific/Apia": "Samoa Standard Time",
-    "Pacific/Auckland": "New Zealand Standard Time",
-    "Pacific/Bougainville": "Bougainville Standard Time",
-    "Pacific/Chatham": "Chatham Islands Standard Time",
-    "Pacific/Chuuk": "West Pacific Standard Time",
-    "Pacific/Easter": "Easter Island Standard Time",
-    "Pacific/Efate": "Central Pacific Standard Time",
-    "Pacific/Enderbury": "UTC+13",
-    "Pacific/Fakaofo": "UTC+13",
-    "Pacific/Fiji": "Fiji Standard Time",
-    "Pacific/Funafuti": "UTC+12",
-    "Pacific/Galapagos": "Central America Standard Time",
-    "Pacific/Gambier": "UTC-09",
-    "Pacific/Guadalcanal": "Central Pacific Standard Time",
-    "Pacific/Guam": "West Pacific Standard Time",
-    "Pacific/Honolulu": "Hawaiian Standard Time",
-    "Pacific/Johnston": "Hawaiian Standard Time",
-    "Pacific/Kiritimati": "Line Islands Standard Time",
-    "Pacific/Kosrae": "Central Pacific Standard Time",
-    "Pacific/Kwajalein": "UTC+12",
-    "Pacific/Majuro": "UTC+12",
-    "Pacific/Marquesas": "Marquesas Standard Time",
-    "Pacific/Midway": "UTC-11",
-    "Pacific/Nauru": "UTC+12",
-    "Pacific/Niue": "UTC-11",
-    "Pacific/Norfolk": "Norfolk Standard Time",
-    "Pacific/Noumea": "Central Pacific Standard Time",
-    "Pacific/Pago_Pago": "UTC-11",
-    "Pacific/Palau": "Tokyo Standard Time",
-    "Pacific/Pitcairn": "UTC-08",
-    "Pacific/Pohnpei": "Central Pacific Standard Time",
-    "Pacific/Ponape": "Central Pacific Standard Time",
-    "Pacific/Port_Moresby": "West Pacific Standard Time",
-    "Pacific/Rarotonga": "Hawaiian Standard Time",
-    "Pacific/Saipan": "West Pacific Standard Time",
-    "Pacific/Samoa": "UTC-11",
-    "Pacific/Tahiti": "Hawaiian Standard Time",
-    "Pacific/Tarawa": "UTC+12",
-    "Pacific/Tongatapu": "Tonga Standard Time",
-    "Pacific/Truk": "West Pacific Standard Time",
-    "Pacific/Wake": "UTC+12",
-    "Pacific/Wallis": "UTC+12",
-    "Pacific/Yap": "West Pacific Standard Time",
-    "Poland": "Central European Standard Time",
-    "Portugal": "GMT Standard Time",
-    "ROC": "Taipei Standard Time",
-    "ROK": "Korea Standard Time",
-    "Singapore": "Singapore Standard Time",
-    "Turkey": "Turkey Standard Time",
-    "UCT": "UTC",
-    "US/Alaska": "Alaskan Standard Time",
-    "US/Aleutian": "Aleutian Standard Time",
-    "US/Arizona": "US Mountain Standard Time",
-    "US/Central": "Central Standard Time",
-    "US/Eastern": "Eastern Standard Time",
-    "US/Hawaii": "Hawaiian Standard Time",
-    "US/Indiana-Starke": "Central Standard Time",
-    "US/Michigan": "Eastern Standard Time",
-    "US/Mountain": "Mountain Standard Time",
-    "US/Pacific": "Pacific Standard Time",
-    "US/Samoa": "UTC-11",
-    "UTC": "UTC",
-    "Universal": "UTC",
-    "W-SU": "Russian Standard Time",
-    "Zulu": "UTC",
-}
+tz_win = {'Africa/Abidjan': 'Greenwich Standard Time',
+ 'Africa/Accra': 'Greenwich Standard Time',
+ 'Africa/Addis_Ababa': 'E. Africa Standard Time',
+ 'Africa/Algiers': 'W. Central Africa Standard Time',
+ 'Africa/Asmera': 'E. Africa Standard Time',
+ 'Africa/Bamako': 'Greenwich Standard Time',
+ 'Africa/Bangui': 'W. Central Africa Standard Time',
+ 'Africa/Banjul': 'Greenwich Standard Time',
+ 'Africa/Bissau': 'Greenwich Standard Time',
+ 'Africa/Blantyre': 'South Africa Standard Time',
+ 'Africa/Brazzaville': 'W. Central Africa Standard Time',
+ 'Africa/Bujumbura': 'South Africa Standard Time',
+ 'Africa/Cairo': 'Egypt Standard Time',
+ 'Africa/Casablanca': 'Morocco Standard Time',
+ 'Africa/Ceuta': 'Romance Standard Time',
+ 'Africa/Conakry': 'Greenwich Standard Time',
+ 'Africa/Dakar': 'Greenwich Standard Time',
+ 'Africa/Dar_es_Salaam': 'E. Africa Standard Time',
+ 'Africa/Djibouti': 'E. Africa Standard Time',
+ 'Africa/Douala': 'W. Central Africa Standard Time',
+ 'Africa/El_Aaiun': 'Morocco Standard Time',
+ 'Africa/Freetown': 'Greenwich Standard Time',
+ 'Africa/Gaborone': 'South Africa Standard Time',
+ 'Africa/Harare': 'South Africa Standard Time',
+ 'Africa/Johannesburg': 'South Africa Standard Time',
+ 'Africa/Juba': 'South Sudan Standard Time',
+ 'Africa/Kampala': 'E. Africa Standard Time',
+ 'Africa/Khartoum': 'Sudan Standard Time',
+ 'Africa/Kigali': 'South Africa Standard Time',
+ 'Africa/Kinshasa': 'W. Central Africa Standard Time',
+ 'Africa/Lagos': 'W. Central Africa Standard Time',
+ 'Africa/Libreville': 'W. Central Africa Standard Time',
+ 'Africa/Lome': 'Greenwich Standard Time',
+ 'Africa/Luanda': 'W. Central Africa Standard Time',
+ 'Africa/Lubumbashi': 'South Africa Standard Time',
+ 'Africa/Lusaka': 'South Africa Standard Time',
+ 'Africa/Malabo': 'W. Central Africa Standard Time',
+ 'Africa/Maputo': 'South Africa Standard Time',
+ 'Africa/Maseru': 'South Africa Standard Time',
+ 'Africa/Mbabane': 'South Africa Standard Time',
+ 'Africa/Mogadishu': 'E. Africa Standard Time',
+ 'Africa/Monrovia': 'Greenwich Standard Time',
+ 'Africa/Nairobi': 'E. Africa Standard Time',
+ 'Africa/Ndjamena': 'W. Central Africa Standard Time',
+ 'Africa/Niamey': 'W. Central Africa Standard Time',
+ 'Africa/Nouakchott': 'Greenwich Standard Time',
+ 'Africa/Ouagadougou': 'Greenwich Standard Time',
+ 'Africa/Porto-Novo': 'W. Central Africa Standard Time',
+ 'Africa/Sao_Tome': 'Sao Tome Standard Time',
+ 'Africa/Timbuktu': 'Greenwich Standard Time',
+ 'Africa/Tripoli': 'Libya Standard Time',
+ 'Africa/Tunis': 'W. Central Africa Standard Time',
+ 'Africa/Windhoek': 'Namibia Standard Time',
+ 'America/Adak': 'Aleutian Standard Time',
+ 'America/Anchorage': 'Alaskan Standard Time',
+ 'America/Anguilla': 'SA Western Standard Time',
+ 'America/Antigua': 'SA Western Standard Time',
+ 'America/Araguaina': 'Tocantins Standard Time',
+ 'America/Argentina/La_Rioja': 'Argentina Standard Time',
+ 'America/Argentina/Rio_Gallegos': 'Argentina Standard Time',
+ 'America/Argentina/Salta': 'Argentina Standard Time',
+ 'America/Argentina/San_Juan': 'Argentina Standard Time',
+ 'America/Argentina/San_Luis': 'Argentina Standard Time',
+ 'America/Argentina/Tucuman': 'Argentina Standard Time',
+ 'America/Argentina/Ushuaia': 'Argentina Standard Time',
+ 'America/Aruba': 'SA Western Standard Time',
+ 'America/Asuncion': 'Paraguay Standard Time',
+ 'America/Atka': 'Aleutian Standard Time',
+ 'America/Bahia': 'Bahia Standard Time',
+ 'America/Bahia_Banderas': 'Central Standard Time (Mexico)',
+ 'America/Barbados': 'SA Western Standard Time',
+ 'America/Belem': 'SA Eastern Standard Time',
+ 'America/Belize': 'Central America Standard Time',
+ 'America/Blanc-Sablon': 'SA Western Standard Time',
+ 'America/Boa_Vista': 'SA Western Standard Time',
+ 'America/Bogota': 'SA Pacific Standard Time',
+ 'America/Boise': 'Mountain Standard Time',
+ 'America/Buenos_Aires': 'Argentina Standard Time',
+ 'America/Cambridge_Bay': 'Mountain Standard Time',
+ 'America/Campo_Grande': 'Central Brazilian Standard Time',
+ 'America/Cancun': 'Eastern Standard Time (Mexico)',
+ 'America/Caracas': 'Venezuela Standard Time',
+ 'America/Catamarca': 'Argentina Standard Time',
+ 'America/Cayenne': 'SA Eastern Standard Time',
+ 'America/Cayman': 'SA Pacific Standard Time',
+ 'America/Chicago': 'Central Standard Time',
+ 'America/Chihuahua': 'Mountain Standard Time (Mexico)',
+ 'America/Coral_Harbour': 'SA Pacific Standard Time',
+ 'America/Cordoba': 'Argentina Standard Time',
+ 'America/Costa_Rica': 'Central America Standard Time',
+ 'America/Creston': 'US Mountain Standard Time',
+ 'America/Cuiaba': 'Central Brazilian Standard Time',
+ 'America/Curacao': 'SA Western Standard Time',
+ 'America/Danmarkshavn': 'Greenwich Standard Time',
+ 'America/Dawson': 'Yukon Standard Time',
+ 'America/Dawson_Creek': 'US Mountain Standard Time',
+ 'America/Denver': 'Mountain Standard Time',
+ 'America/Detroit': 'Eastern Standard Time',
+ 'America/Dominica': 'SA Western Standard Time',
+ 'America/Edmonton': 'Mountain Standard Time',
+ 'America/Eirunepe': 'SA Pacific Standard Time',
+ 'America/El_Salvador': 'Central America Standard Time',
+ 'America/Ensenada': 'Pacific Standard Time (Mexico)',
+ 'America/Fort_Nelson': 'US Mountain Standard Time',
+ 'America/Fortaleza': 'SA Eastern Standard Time',
+ 'America/Glace_Bay': 'Atlantic Standard Time',
+ 'America/Godthab': 'Greenland Standard Time',
+ 'America/Goose_Bay': 'Atlantic Standard Time',
+ 'America/Grand_Turk': 'Turks And Caicos Standard Time',
+ 'America/Grenada': 'SA Western Standard Time',
+ 'America/Guadeloupe': 'SA Western Standard Time',
+ 'America/Guatemala': 'Central America Standard Time',
+ 'America/Guayaquil': 'SA Pacific Standard Time',
+ 'America/Guyana': 'SA Western Standard Time',
+ 'America/Halifax': 'Atlantic Standard Time',
+ 'America/Havana': 'Cuba Standard Time',
+ 'America/Hermosillo': 'US Mountain Standard Time',
+ 'America/Indiana/Knox': 'Central Standard Time',
+ 'America/Indiana/Marengo': 'US Eastern Standard Time',
+ 'America/Indiana/Petersburg': 'Eastern Standard Time',
+ 'America/Indiana/Tell_City': 'Central Standard Time',
+ 'America/Indiana/Vevay': 'US Eastern Standard Time',
+ 'America/Indiana/Vincennes': 'Eastern Standard Time',
+ 'America/Indiana/Winamac': 'Eastern Standard Time',
+ 'America/Indianapolis': 'US Eastern Standard Time',
+ 'America/Inuvik': 'Mountain Standard Time',
+ 'America/Iqaluit': 'Eastern Standard Time',
+ 'America/Jamaica': 'SA Pacific Standard Time',
+ 'America/Jujuy': 'Argentina Standard Time',
+ 'America/Juneau': 'Alaskan Standard Time',
+ 'America/Kentucky/Monticello': 'Eastern Standard Time',
+ 'America/Knox_IN': 'Central Standard Time',
+ 'America/Kralendijk': 'SA Western Standard Time',
+ 'America/La_Paz': 'SA Western Standard Time',
+ 'America/Lima': 'SA Pacific Standard Time',
+ 'America/Los_Angeles': 'Pacific Standard Time',
+ 'America/Louisville': 'Eastern Standard Time',
+ 'America/Lower_Princes': 'SA Western Standard Time',
+ 'America/Maceio': 'SA Eastern Standard Time',
+ 'America/Managua': 'Central America Standard Time',
+ 'America/Manaus': 'SA Western Standard Time',
+ 'America/Marigot': 'SA Western Standard Time',
+ 'America/Martinique': 'SA Western Standard Time',
+ 'America/Matamoros': 'Central Standard Time',
+ 'America/Mazatlan': 'Mountain Standard Time (Mexico)',
+ 'America/Mendoza': 'Argentina Standard Time',
+ 'America/Menominee': 'Central Standard Time',
+ 'America/Merida': 'Central Standard Time (Mexico)',
+ 'America/Metlakatla': 'Alaskan Standard Time',
+ 'America/Mexico_City': 'Central Standard Time (Mexico)',
+ 'America/Miquelon': 'Saint Pierre Standard Time',
+ 'America/Moncton': 'Atlantic Standard Time',
+ 'America/Monterrey': 'Central Standard Time (Mexico)',
+ 'America/Montevideo': 'Montevideo Standard Time',
+ 'America/Montreal': 'Eastern Standard Time',
+ 'America/Montserrat': 'SA Western Standard Time',
+ 'America/Nassau': 'Eastern Standard Time',
+ 'America/New_York': 'Eastern Standard Time',
+ 'America/Nipigon': 'Eastern Standard Time',
+ 'America/Nome': 'Alaskan Standard Time',
+ 'America/Noronha': 'UTC-02',
+ 'America/North_Dakota/Beulah': 'Central Standard Time',
+ 'America/North_Dakota/Center': 'Central Standard Time',
+ 'America/North_Dakota/New_Salem': 'Central Standard Time',
+ 'America/Ojinaga': 'Mountain Standard Time',
+ 'America/Panama': 'SA Pacific Standard Time',
+ 'America/Pangnirtung': 'Eastern Standard Time',
+ 'America/Paramaribo': 'SA Eastern Standard Time',
+ 'America/Phoenix': 'US Mountain Standard Time',
+ 'America/Port-au-Prince': 'Haiti Standard Time',
+ 'America/Port_of_Spain': 'SA Western Standard Time',
+ 'America/Porto_Acre': 'SA Pacific Standard Time',
+ 'America/Porto_Velho': 'SA Western Standard Time',
+ 'America/Puerto_Rico': 'SA Western Standard Time',
+ 'America/Punta_Arenas': 'Magallanes Standard Time',
+ 'America/Rainy_River': 'Central Standard Time',
+ 'America/Rankin_Inlet': 'Central Standard Time',
+ 'America/Recife': 'SA Eastern Standard Time',
+ 'America/Regina': 'Canada Central Standard Time',
+ 'America/Resolute': 'Central Standard Time',
+ 'America/Rio_Branco': 'SA Pacific Standard Time',
+ 'America/Santa_Isabel': 'Pacific Standard Time (Mexico)',
+ 'America/Santarem': 'SA Eastern Standard Time',
+ 'America/Santiago': 'Pacific SA Standard Time',
+ 'America/Santo_Domingo': 'SA Western Standard Time',
+ 'America/Sao_Paulo': 'E. South America Standard Time',
+ 'America/Scoresbysund': 'Azores Standard Time',
+ 'America/Shiprock': 'Mountain Standard Time',
+ 'America/Sitka': 'Alaskan Standard Time',
+ 'America/St_Barthelemy': 'SA Western Standard Time',
+ 'America/St_Johns': 'Newfoundland Standard Time',
+ 'America/St_Kitts': 'SA Western Standard Time',
+ 'America/St_Lucia': 'SA Western Standard Time',
+ 'America/St_Thomas': 'SA Western Standard Time',
+ 'America/St_Vincent': 'SA Western Standard Time',
+ 'America/Swift_Current': 'Canada Central Standard Time',
+ 'America/Tegucigalpa': 'Central America Standard Time',
+ 'America/Thule': 'Atlantic Standard Time',
+ 'America/Thunder_Bay': 'Eastern Standard Time',
+ 'America/Tijuana': 'Pacific Standard Time (Mexico)',
+ 'America/Toronto': 'Eastern Standard Time',
+ 'America/Tortola': 'SA Western Standard Time',
+ 'America/Vancouver': 'Pacific Standard Time',
+ 'America/Virgin': 'SA Western Standard Time',
+ 'America/Whitehorse': 'Yukon Standard Time',
+ 'America/Winnipeg': 'Central Standard Time',
+ 'America/Yakutat': 'Alaskan Standard Time',
+ 'America/Yellowknife': 'Mountain Standard Time',
+ 'Antarctica/Casey': 'Central Pacific Standard Time',
+ 'Antarctica/Davis': 'SE Asia Standard Time',
+ 'Antarctica/DumontDUrville': 'West Pacific Standard Time',
+ 'Antarctica/Macquarie': 'Tasmania Standard Time',
+ 'Antarctica/Mawson': 'West Asia Standard Time',
+ 'Antarctica/McMurdo': 'New Zealand Standard Time',
+ 'Antarctica/Palmer': 'SA Eastern Standard Time',
+ 'Antarctica/Rothera': 'SA Eastern Standard Time',
+ 'Antarctica/South_Pole': 'New Zealand Standard Time',
+ 'Antarctica/Syowa': 'E. Africa Standard Time',
+ 'Antarctica/Vostok': 'Central Asia Standard Time',
+ 'Arctic/Longyearbyen': 'W. Europe Standard Time',
+ 'Asia/Aden': 'Arab Standard Time',
+ 'Asia/Almaty': 'Central Asia Standard Time',
+ 'Asia/Amman': 'Jordan Standard Time',
+ 'Asia/Anadyr': 'Russia Time Zone 11',
+ 'Asia/Aqtau': 'West Asia Standard Time',
+ 'Asia/Aqtobe': 'West Asia Standard Time',
+ 'Asia/Ashgabat': 'West Asia Standard Time',
+ 'Asia/Ashkhabad': 'West Asia Standard Time',
+ 'Asia/Atyrau': 'West Asia Standard Time',
+ 'Asia/Baghdad': 'Arabic Standard Time',
+ 'Asia/Bahrain': 'Arab Standard Time',
+ 'Asia/Baku': 'Azerbaijan Standard Time',
+ 'Asia/Bangkok': 'SE Asia Standard Time',
+ 'Asia/Barnaul': 'Altai Standard Time',
+ 'Asia/Beirut': 'Middle East Standard Time',
+ 'Asia/Bishkek': 'Central Asia Standard Time',
+ 'Asia/Brunei': 'Singapore Standard Time',
+ 'Asia/Calcutta': 'India Standard Time',
+ 'Asia/Chita': 'Transbaikal Standard Time',
+ 'Asia/Choibalsan': 'Ulaanbaatar Standard Time',
+ 'Asia/Chongqing': 'China Standard Time',
+ 'Asia/Chungking': 'China Standard Time',
+ 'Asia/Colombo': 'Sri Lanka Standard Time',
+ 'Asia/Dacca': 'Bangladesh Standard Time',
+ 'Asia/Damascus': 'Syria Standard Time',
+ 'Asia/Dhaka': 'Bangladesh Standard Time',
+ 'Asia/Dili': 'Tokyo Standard Time',
+ 'Asia/Dubai': 'Arabian Standard Time',
+ 'Asia/Dushanbe': 'West Asia Standard Time',
+ 'Asia/Famagusta': 'GTB Standard Time',
+ 'Asia/Gaza': 'West Bank Standard Time',
+ 'Asia/Harbin': 'China Standard Time',
+ 'Asia/Hebron': 'West Bank Standard Time',
+ 'Asia/Hong_Kong': 'China Standard Time',
+ 'Asia/Hovd': 'W. Mongolia Standard Time',
+ 'Asia/Irkutsk': 'North Asia East Standard Time',
+ 'Asia/Jakarta': 'SE Asia Standard Time',
+ 'Asia/Jayapura': 'Tokyo Standard Time',
+ 'Asia/Jerusalem': 'Israel Standard Time',
+ 'Asia/Kabul': 'Afghanistan Standard Time',
+ 'Asia/Kamchatka': 'Russia Time Zone 11',
+ 'Asia/Karachi': 'Pakistan Standard Time',
+ 'Asia/Kashgar': 'Central Asia Standard Time',
+ 'Asia/Katmandu': 'Nepal Standard Time',
+ 'Asia/Khandyga': 'Yakutsk Standard Time',
+ 'Asia/Krasnoyarsk': 'North Asia Standard Time',
+ 'Asia/Kuala_Lumpur': 'Singapore Standard Time',
+ 'Asia/Kuching': 'Singapore Standard Time',
+ 'Asia/Kuwait': 'Arab Standard Time',
+ 'Asia/Macao': 'China Standard Time',
+ 'Asia/Macau': 'China Standard Time',
+ 'Asia/Magadan': 'Magadan Standard Time',
+ 'Asia/Makassar': 'Singapore Standard Time',
+ 'Asia/Manila': 'Singapore Standard Time',
+ 'Asia/Muscat': 'Arabian Standard Time',
+ 'Asia/Nicosia': 'GTB Standard Time',
+ 'Asia/Novokuznetsk': 'North Asia Standard Time',
+ 'Asia/Novosibirsk': 'N. Central Asia Standard Time',
+ 'Asia/Omsk': 'Omsk Standard Time',
+ 'Asia/Oral': 'West Asia Standard Time',
+ 'Asia/Phnom_Penh': 'SE Asia Standard Time',
+ 'Asia/Pontianak': 'SE Asia Standard Time',
+ 'Asia/Pyongyang': 'North Korea Standard Time',
+ 'Asia/Qatar': 'Arab Standard Time',
+ 'Asia/Qostanay': 'Central Asia Standard Time',
+ 'Asia/Qyzylorda': 'Qyzylorda Standard Time',
+ 'Asia/Rangoon': 'Myanmar Standard Time',
+ 'Asia/Riyadh': 'Arab Standard Time',
+ 'Asia/Saigon': 'SE Asia Standard Time',
+ 'Asia/Sakhalin': 'Sakhalin Standard Time',
+ 'Asia/Samarkand': 'West Asia Standard Time',
+ 'Asia/Seoul': 'Korea Standard Time',
+ 'Asia/Shanghai': 'China Standard Time',
+ 'Asia/Singapore': 'Singapore Standard Time',
+ 'Asia/Srednekolymsk': 'Russia Time Zone 10',
+ 'Asia/Taipei': 'Taipei Standard Time',
+ 'Asia/Tashkent': 'West Asia Standard Time',
+ 'Asia/Tbilisi': 'Georgian Standard Time',
+ 'Asia/Tehran': 'Iran Standard Time',
+ 'Asia/Tel_Aviv': 'Israel Standard Time',
+ 'Asia/Thimbu': 'Bangladesh Standard Time',
+ 'Asia/Thimphu': 'Bangladesh Standard Time',
+ 'Asia/Tokyo': 'Tokyo Standard Time',
+ 'Asia/Tomsk': 'Tomsk Standard Time',
+ 'Asia/Ujung_Pandang': 'Singapore Standard Time',
+ 'Asia/Ulaanbaatar': 'Ulaanbaatar Standard Time',
+ 'Asia/Ulan_Bator': 'Ulaanbaatar Standard Time',
+ 'Asia/Urumqi': 'Central Asia Standard Time',
+ 'Asia/Ust-Nera': 'Vladivostok Standard Time',
+ 'Asia/Vientiane': 'SE Asia Standard Time',
+ 'Asia/Vladivostok': 'Vladivostok Standard Time',
+ 'Asia/Yakutsk': 'Yakutsk Standard Time',
+ 'Asia/Yekaterinburg': 'Ekaterinburg Standard Time',
+ 'Asia/Yerevan': 'Caucasus Standard Time',
+ 'Atlantic/Azores': 'Azores Standard Time',
+ 'Atlantic/Bermuda': 'Atlantic Standard Time',
+ 'Atlantic/Canary': 'GMT Standard Time',
+ 'Atlantic/Cape_Verde': 'Cape Verde Standard Time',
+ 'Atlantic/Faeroe': 'GMT Standard Time',
+ 'Atlantic/Jan_Mayen': 'W. Europe Standard Time',
+ 'Atlantic/Madeira': 'GMT Standard Time',
+ 'Atlantic/Reykjavik': 'Greenwich Standard Time',
+ 'Atlantic/South_Georgia': 'UTC-02',
+ 'Atlantic/St_Helena': 'Greenwich Standard Time',
+ 'Atlantic/Stanley': 'SA Eastern Standard Time',
+ 'Australia/ACT': 'AUS Eastern Standard Time',
+ 'Australia/Adelaide': 'Cen. Australia Standard Time',
+ 'Australia/Brisbane': 'E. Australia Standard Time',
+ 'Australia/Broken_Hill': 'Cen. Australia Standard Time',
+ 'Australia/Canberra': 'AUS Eastern Standard Time',
+ 'Australia/Currie': 'Tasmania Standard Time',
+ 'Australia/Darwin': 'AUS Central Standard Time',
+ 'Australia/Eucla': 'Aus Central W. Standard Time',
+ 'Australia/Hobart': 'Tasmania Standard Time',
+ 'Australia/LHI': 'Lord Howe Standard Time',
+ 'Australia/Lindeman': 'E. Australia Standard Time',
+ 'Australia/Lord_Howe': 'Lord Howe Standard Time',
+ 'Australia/Melbourne': 'AUS Eastern Standard Time',
+ 'Australia/NSW': 'AUS Eastern Standard Time',
+ 'Australia/North': 'AUS Central Standard Time',
+ 'Australia/Perth': 'W. Australia Standard Time',
+ 'Australia/Queensland': 'E. Australia Standard Time',
+ 'Australia/South': 'Cen. Australia Standard Time',
+ 'Australia/Sydney': 'AUS Eastern Standard Time',
+ 'Australia/Tasmania': 'Tasmania Standard Time',
+ 'Australia/Victoria': 'AUS Eastern Standard Time',
+ 'Australia/West': 'W. Australia Standard Time',
+ 'Australia/Yancowinna': 'Cen. Australia Standard Time',
+ 'Brazil/Acre': 'SA Pacific Standard Time',
+ 'Brazil/DeNoronha': 'UTC-02',
+ 'Brazil/East': 'E. South America Standard Time',
+ 'Brazil/West': 'SA Western Standard Time',
+ 'CST6CDT': 'Central Standard Time',
+ 'Canada/Atlantic': 'Atlantic Standard Time',
+ 'Canada/Central': 'Central Standard Time',
+ 'Canada/Eastern': 'Eastern Standard Time',
+ 'Canada/Mountain': 'Mountain Standard Time',
+ 'Canada/Newfoundland': 'Newfoundland Standard Time',
+ 'Canada/Pacific': 'Pacific Standard Time',
+ 'Canada/Saskatchewan': 'Canada Central Standard Time',
+ 'Canada/Yukon': 'Yukon Standard Time',
+ 'Chile/Continental': 'Pacific SA Standard Time',
+ 'Chile/EasterIsland': 'Easter Island Standard Time',
+ 'Cuba': 'Cuba Standard Time',
+ 'EST5EDT': 'Eastern Standard Time',
+ 'Egypt': 'Egypt Standard Time',
+ 'Eire': 'GMT Standard Time',
+ 'Etc/GMT': 'UTC',
+ 'Etc/GMT+1': 'Cape Verde Standard Time',
+ 'Etc/GMT+10': 'Hawaiian Standard Time',
+ 'Etc/GMT+11': 'UTC-11',
+ 'Etc/GMT+12': 'Dateline Standard Time',
+ 'Etc/GMT+2': 'UTC-02',
+ 'Etc/GMT+3': 'SA Eastern Standard Time',
+ 'Etc/GMT+4': 'SA Western Standard Time',
+ 'Etc/GMT+5': 'SA Pacific Standard Time',
+ 'Etc/GMT+6': 'Central America Standard Time',
+ 'Etc/GMT+7': 'US Mountain Standard Time',
+ 'Etc/GMT+8': 'UTC-08',
+ 'Etc/GMT+9': 'UTC-09',
+ 'Etc/GMT-1': 'W. Central Africa Standard Time',
+ 'Etc/GMT-10': 'West Pacific Standard Time',
+ 'Etc/GMT-11': 'Central Pacific Standard Time',
+ 'Etc/GMT-12': 'UTC+12',
+ 'Etc/GMT-13': 'UTC+13',
+ 'Etc/GMT-14': 'Line Islands Standard Time',
+ 'Etc/GMT-2': 'South Africa Standard Time',
+ 'Etc/GMT-3': 'E. Africa Standard Time',
+ 'Etc/GMT-4': 'Arabian Standard Time',
+ 'Etc/GMT-5': 'West Asia Standard Time',
+ 'Etc/GMT-6': 'Central Asia Standard Time',
+ 'Etc/GMT-7': 'SE Asia Standard Time',
+ 'Etc/GMT-8': 'Singapore Standard Time',
+ 'Etc/GMT-9': 'Tokyo Standard Time',
+ 'Etc/UCT': 'UTC',
+ 'Etc/UTC': 'UTC',
+ 'Europe/Amsterdam': 'W. Europe Standard Time',
+ 'Europe/Andorra': 'W. Europe Standard Time',
+ 'Europe/Astrakhan': 'Astrakhan Standard Time',
+ 'Europe/Athens': 'GTB Standard Time',
+ 'Europe/Belfast': 'GMT Standard Time',
+ 'Europe/Belgrade': 'Central Europe Standard Time',
+ 'Europe/Berlin': 'W. Europe Standard Time',
+ 'Europe/Bratislava': 'Central Europe Standard Time',
+ 'Europe/Brussels': 'Romance Standard Time',
+ 'Europe/Bucharest': 'GTB Standard Time',
+ 'Europe/Budapest': 'Central Europe Standard Time',
+ 'Europe/Busingen': 'W. Europe Standard Time',
+ 'Europe/Chisinau': 'E. Europe Standard Time',
+ 'Europe/Copenhagen': 'Romance Standard Time',
+ 'Europe/Dublin': 'GMT Standard Time',
+ 'Europe/Gibraltar': 'W. Europe Standard Time',
+ 'Europe/Guernsey': 'GMT Standard Time',
+ 'Europe/Helsinki': 'FLE Standard Time',
+ 'Europe/Isle_of_Man': 'GMT Standard Time',
+ 'Europe/Istanbul': 'Turkey Standard Time',
+ 'Europe/Jersey': 'GMT Standard Time',
+ 'Europe/Kaliningrad': 'Kaliningrad Standard Time',
+ 'Europe/Kiev': 'FLE Standard Time',
+ 'Europe/Kirov': 'Russian Standard Time',
+ 'Europe/Lisbon': 'GMT Standard Time',
+ 'Europe/Ljubljana': 'Central Europe Standard Time',
+ 'Europe/London': 'GMT Standard Time',
+ 'Europe/Luxembourg': 'W. Europe Standard Time',
+ 'Europe/Madrid': 'Romance Standard Time',
+ 'Europe/Malta': 'W. Europe Standard Time',
+ 'Europe/Mariehamn': 'FLE Standard Time',
+ 'Europe/Minsk': 'Belarus Standard Time',
+ 'Europe/Monaco': 'W. Europe Standard Time',
+ 'Europe/Moscow': 'Russian Standard Time',
+ 'Europe/Oslo': 'W. Europe Standard Time',
+ 'Europe/Paris': 'Romance Standard Time',
+ 'Europe/Podgorica': 'Central Europe Standard Time',
+ 'Europe/Prague': 'Central Europe Standard Time',
+ 'Europe/Riga': 'FLE Standard Time',
+ 'Europe/Rome': 'W. Europe Standard Time',
+ 'Europe/Samara': 'Russia Time Zone 3',
+ 'Europe/San_Marino': 'W. Europe Standard Time',
+ 'Europe/Sarajevo': 'Central European Standard Time',
+ 'Europe/Saratov': 'Saratov Standard Time',
+ 'Europe/Simferopol': 'Russian Standard Time',
+ 'Europe/Skopje': 'Central European Standard Time',
+ 'Europe/Sofia': 'FLE Standard Time',
+ 'Europe/Stockholm': 'W. Europe Standard Time',
+ 'Europe/Tallinn': 'FLE Standard Time',
+ 'Europe/Tirane': 'Central Europe Standard Time',
+ 'Europe/Tiraspol': 'E. Europe Standard Time',
+ 'Europe/Ulyanovsk': 'Astrakhan Standard Time',
+ 'Europe/Uzhgorod': 'FLE Standard Time',
+ 'Europe/Vaduz': 'W. Europe Standard Time',
+ 'Europe/Vatican': 'W. Europe Standard Time',
+ 'Europe/Vienna': 'W. Europe Standard Time',
+ 'Europe/Vilnius': 'FLE Standard Time',
+ 'Europe/Volgograd': 'Volgograd Standard Time',
+ 'Europe/Warsaw': 'Central European Standard Time',
+ 'Europe/Zagreb': 'Central European Standard Time',
+ 'Europe/Zaporozhye': 'FLE Standard Time',
+ 'Europe/Zurich': 'W. Europe Standard Time',
+ 'GB': 'GMT Standard Time',
+ 'GB-Eire': 'GMT Standard Time',
+ 'GMT+0': 'UTC',
+ 'GMT-0': 'UTC',
+ 'GMT0': 'UTC',
+ 'Greenwich': 'UTC',
+ 'Hongkong': 'China Standard Time',
+ 'Iceland': 'Greenwich Standard Time',
+ 'Indian/Antananarivo': 'E. Africa Standard Time',
+ 'Indian/Chagos': 'Central Asia Standard Time',
+ 'Indian/Christmas': 'SE Asia Standard Time',
+ 'Indian/Cocos': 'Myanmar Standard Time',
+ 'Indian/Comoro': 'E. Africa Standard Time',
+ 'Indian/Kerguelen': 'West Asia Standard Time',
+ 'Indian/Mahe': 'Mauritius Standard Time',
+ 'Indian/Maldives': 'West Asia Standard Time',
+ 'Indian/Mauritius': 'Mauritius Standard Time',
+ 'Indian/Mayotte': 'E. Africa Standard Time',
+ 'Indian/Reunion': 'Mauritius Standard Time',
+ 'Iran': 'Iran Standard Time',
+ 'Israel': 'Israel Standard Time',
+ 'Jamaica': 'SA Pacific Standard Time',
+ 'Japan': 'Tokyo Standard Time',
+ 'Kwajalein': 'UTC+12',
+ 'Libya': 'Libya Standard Time',
+ 'MST7MDT': 'Mountain Standard Time',
+ 'Mexico/BajaNorte': 'Pacific Standard Time (Mexico)',
+ 'Mexico/BajaSur': 'Mountain Standard Time (Mexico)',
+ 'Mexico/General': 'Central Standard Time (Mexico)',
+ 'NZ': 'New Zealand Standard Time',
+ 'NZ-CHAT': 'Chatham Islands Standard Time',
+ 'Navajo': 'Mountain Standard Time',
+ 'PRC': 'China Standard Time',
+ 'PST8PDT': 'Pacific Standard Time',
+ 'Pacific/Apia': 'Samoa Standard Time',
+ 'Pacific/Auckland': 'New Zealand Standard Time',
+ 'Pacific/Bougainville': 'Bougainville Standard Time',
+ 'Pacific/Chatham': 'Chatham Islands Standard Time',
+ 'Pacific/Easter': 'Easter Island Standard Time',
+ 'Pacific/Efate': 'Central Pacific Standard Time',
+ 'Pacific/Enderbury': 'UTC+13',
+ 'Pacific/Fakaofo': 'UTC+13',
+ 'Pacific/Fiji': 'Fiji Standard Time',
+ 'Pacific/Funafuti': 'UTC+12',
+ 'Pacific/Galapagos': 'Central America Standard Time',
+ 'Pacific/Gambier': 'UTC-09',
+ 'Pacific/Guadalcanal': 'Central Pacific Standard Time',
+ 'Pacific/Guam': 'West Pacific Standard Time',
+ 'Pacific/Honolulu': 'Hawaiian Standard Time',
+ 'Pacific/Johnston': 'Hawaiian Standard Time',
+ 'Pacific/Kiritimati': 'Line Islands Standard Time',
+ 'Pacific/Kosrae': 'Central Pacific Standard Time',
+ 'Pacific/Kwajalein': 'UTC+12',
+ 'Pacific/Majuro': 'UTC+12',
+ 'Pacific/Marquesas': 'Marquesas Standard Time',
+ 'Pacific/Midway': 'UTC-11',
+ 'Pacific/Nauru': 'UTC+12',
+ 'Pacific/Niue': 'UTC-11',
+ 'Pacific/Norfolk': 'Norfolk Standard Time',
+ 'Pacific/Noumea': 'Central Pacific Standard Time',
+ 'Pacific/Pago_Pago': 'UTC-11',
+ 'Pacific/Palau': 'Tokyo Standard Time',
+ 'Pacific/Pitcairn': 'UTC-08',
+ 'Pacific/Ponape': 'Central Pacific Standard Time',
+ 'Pacific/Port_Moresby': 'West Pacific Standard Time',
+ 'Pacific/Rarotonga': 'Hawaiian Standard Time',
+ 'Pacific/Saipan': 'West Pacific Standard Time',
+ 'Pacific/Samoa': 'UTC-11',
+ 'Pacific/Tahiti': 'Hawaiian Standard Time',
+ 'Pacific/Tarawa': 'UTC+12',
+ 'Pacific/Tongatapu': 'Tonga Standard Time',
+ 'Pacific/Truk': 'West Pacific Standard Time',
+ 'Pacific/Wake': 'UTC+12',
+ 'Pacific/Wallis': 'UTC+12',
+ 'Poland': 'Central European Standard Time',
+ 'Portugal': 'GMT Standard Time',
+ 'ROC': 'Taipei Standard Time',
+ 'ROK': 'Korea Standard Time',
+ 'Singapore': 'Singapore Standard Time',
+ 'Turkey': 'Turkey Standard Time',
+ 'UCT': 'UTC',
+ 'US/Alaska': 'Alaskan Standard Time',
+ 'US/Aleutian': 'Aleutian Standard Time',
+ 'US/Arizona': 'US Mountain Standard Time',
+ 'US/Central': 'Central Standard Time',
+ 'US/Eastern': 'Eastern Standard Time',
+ 'US/Hawaii': 'Hawaiian Standard Time',
+ 'US/Indiana-Starke': 'Central Standard Time',
+ 'US/Michigan': 'Eastern Standard Time',
+ 'US/Mountain': 'Mountain Standard Time',
+ 'US/Pacific': 'Pacific Standard Time',
+ 'US/Samoa': 'UTC-11',
+ 'UTC': 'UTC',
+ 'Universal': 'UTC',
+ 'W-SU': 'Russian Standard Time',
+ 'Zulu': 'UTC'}
diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index 1027cf23..e0bd159b 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -1,4 +1,4 @@
-apscheduler==3.10.4
+apscheduler==3.10.1
 importlib-metadata==6.8.0
 importlib-resources==6.0.1
 pyinstaller==5.13.0
diff --git a/requirements.txt b/requirements.txt
index 3fc87314..56927154 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,5 +1,5 @@
 appdirs==1.4.4
-apscheduler==3.10.4
+apscheduler==3.10.1
 arrow==1.2.3
 backports.csv==1.0.7
 backports.functools-lru-cache==1.6.6

From 85bc9c39ae82a38bd94bef21f5e7011e94b47c6c Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 25 Aug 2023 11:33:56 -0700
Subject: [PATCH 457/743] Update tzlocal==5.0.1

---
 lib/tzlocal/__init__.py   |    9 +-
 lib/tzlocal/unix.py       |   63 +-
 lib/tzlocal/utils.py      |   68 +-
 lib/tzlocal/win32.py      |   32 +-
 lib/tzlocal/windows_tz.py | 1405 +++++++++++++++++++------------------
 requirements.txt          |    2 +-
 6 files changed, 807 insertions(+), 772 deletions(-)

diff --git a/lib/tzlocal/__init__.py b/lib/tzlocal/__init__.py
index 98ed04fd..50abb093 100644
--- a/lib/tzlocal/__init__.py
+++ b/lib/tzlocal/__init__.py
@@ -9,5 +9,12 @@ if sys.platform == "win32":
 else:
     from tzlocal.unix import get_localzone, get_localzone_name, reload_localzone
 
+from tzlocal.utils import assert_tz_offset
 
-__all__ = ["get_localzone", "get_localzone_name", "reload_localzone"]
+
+__all__ = [
+    "get_localzone",
+    "get_localzone_name",
+    "reload_localzone",
+    "assert_tz_offset",
+]
diff --git a/lib/tzlocal/unix.py b/lib/tzlocal/unix.py
index eaf96d92..f510c12c 100644
--- a/lib/tzlocal/unix.py
+++ b/lib/tzlocal/unix.py
@@ -1,20 +1,21 @@
+import logging
 import os
 import re
 import sys
 import warnings
 from datetime import timezone
-import pytz_deprecation_shim as pds
 
 from tzlocal import utils
 
 if sys.version_info >= (3, 9):
-    from zoneinfo import ZoneInfo  # pragma: no cover
+    import zoneinfo  # pragma: no cover
 else:
-    from backports.zoneinfo import ZoneInfo  # pragma: no cover
+    from backports import zoneinfo  # pragma: no cover
 
 _cache_tz = None
 _cache_tz_name = None
 
+log = logging.getLogger("tzlocal")
 
 def _get_localzone_name(_root="/"):
     """Tries to find the local timezone configuration.
@@ -32,14 +33,21 @@ def _get_localzone_name(_root="/"):
 
     # Are we under Termux on Android?
     if os.path.exists(os.path.join(_root, "system/bin/getprop")):
+        log.debug("This looks like Termux")
+
         import subprocess
 
-        androidtz = (
-            subprocess.check_output(["getprop", "persist.sys.timezone"])
-            .strip()
-            .decode()
-        )
-        return androidtz
+        try:
+            androidtz = (
+                subprocess.check_output(["getprop", "persist.sys.timezone"])
+                .strip()
+                .decode()
+            )
+            return androidtz
+        except (OSError, subprocess.CalledProcessError):
+            # proot environment or failed to getprop
+            log.debug("It's not termux?")
+            pass
 
     # Now look for distribution specific configuration files
     # that contain the timezone name.
@@ -50,10 +58,11 @@ def _get_localzone_name(_root="/"):
     for configfile in ("etc/timezone", "var/db/zoneinfo"):
         tzpath = os.path.join(_root, configfile)
         try:
-            with open(tzpath, "rt") as tzfile:
+            with open(tzpath) as tzfile:
                 data = tzfile.read()
+                log.debug(f"{tzpath} found, contents:\n {data}")
 
-                etctz = data.strip('/ \t\r\n')
+                etctz = data.strip("/ \t\r\n")
                 if not etctz:
                     # Empty file, skip
                     continue
@@ -68,7 +77,7 @@ def _get_localzone_name(_root="/"):
 
                     found_configs[tzpath] = etctz.replace(" ", "_")
 
-        except (IOError, UnicodeDecodeError):
+        except (OSError, UnicodeDecodeError):
             # File doesn't exist or is a directory, or it's a binary file.
             continue
 
@@ -86,6 +95,7 @@ def _get_localzone_name(_root="/"):
         try:
             with open(tzpath, "rt") as tzfile:
                 data = tzfile.readlines()
+                log.debug(f"{tzpath} found, contents:\n {data}")
 
             for line in data:
                 # Look for the ZONE= setting.
@@ -95,13 +105,13 @@ def _get_localzone_name(_root="/"):
                     match = timezone_re.match(line)
                 if match is not None:
                     # Some setting existed
-                    line = line[match.end():]
+                    line = line[match.end() :]
                     etctz = line[: end_re.search(line).start()]
 
                     # We found a timezone
                     found_configs[tzpath] = etctz.replace(" ", "_")
 
-        except (IOError, UnicodeDecodeError):
+        except (OSError, UnicodeDecodeError):
             # UnicodeDecode handles when clock is symlink to /etc/localtime
             continue
 
@@ -109,30 +119,34 @@ def _get_localzone_name(_root="/"):
     # see manpage of localtime(5) and timedatectl(1)
     tzpath = os.path.join(_root, "etc/localtime")
     if os.path.exists(tzpath) and os.path.islink(tzpath):
-        etctz = realtzpath = os.path.realpath(tzpath)
+        log.debug(f"{tzpath} found")
+        etctz = os.path.realpath(tzpath)
         start = etctz.find("/") + 1
         while start != 0:
             etctz = etctz[start:]
             try:
-                pds.timezone(etctz)
+                zoneinfo.ZoneInfo(etctz)
                 tzinfo = f"{tzpath} is a symlink to"
                 found_configs[tzinfo] = etctz.replace(" ", "_")
-            except pds.UnknownTimeZoneError:
+                # Only need first valid relative path in simlink.
+                break
+            except zoneinfo.ZoneInfoNotFoundError:
                 pass
             start = etctz.find("/") + 1
 
     if len(found_configs) > 0:
+        log.debug(f"{len(found_configs)} found:\n {found_configs}")
         # We found some explicit config of some sort!
         if len(found_configs) > 1:
             # Uh-oh, multiple configs. See if they match:
             unique_tzs = set()
-            zoneinfo = os.path.join(_root, "usr", "share", "zoneinfo")
-            directory_depth = len(zoneinfo.split(os.path.sep))
+            zoneinfopath = os.path.join(_root, "usr", "share", "zoneinfo")
+            directory_depth = len(zoneinfopath.split(os.path.sep))
 
             for tzname in found_configs.values():
                 # Look them up in /usr/share/zoneinfo, and find what they
                 # really point to:
-                path = os.path.realpath(os.path.join(zoneinfo, *tzname.split("/")))
+                path = os.path.realpath(os.path.join(zoneinfopath, *tzname.split("/")))
                 real_zone_name = "/".join(path.split(os.path.sep)[directory_depth:])
                 unique_tzs.add(real_zone_name)
 
@@ -141,7 +155,7 @@ def _get_localzone_name(_root="/"):
                 for key, value in found_configs.items():
                     message += f"{key}: {value}\n"
                 message += "Fix the configuration, or set the time zone in a TZ environment variable.\n"
-                raise utils.ZoneInfoNotFoundError(message)
+                raise zoneinfo.ZoneInfoNotFoundError(message)
 
         # We found exactly one config! Use it.
         return list(found_configs.values())[0]
@@ -165,24 +179,25 @@ def _get_localzone(_root="/"):
     tzname = _get_localzone_name(_root)
     if tzname is None:
         # No explicit setting existed. Use localtime
+        log.debug("No explicit setting existed. Use localtime")
         for filename in ("etc/localtime", "usr/local/etc/localtime"):
             tzpath = os.path.join(_root, filename)
 
             if not os.path.exists(tzpath):
                 continue
             with open(tzpath, "rb") as tzfile:
-                tz = pds.wrap_zone(ZoneInfo.from_file(tzfile, key="local"))
+                tz = zoneinfo.ZoneInfo.from_file(tzfile, key="local")
                 break
         else:
             warnings.warn("Can not find any timezone configuration, defaulting to UTC.")
             tz = timezone.utc
     else:
-        tz = pds.timezone(tzname)
+        tz = zoneinfo.ZoneInfo(tzname)
 
     if _root == "/":
         # We are using a file in etc to name the timezone.
         # Verify that the timezone specified there is actually used:
-        utils.assert_tz_offset(tz)
+        utils.assert_tz_offset(tz, error=False)
     return tz
 
 
diff --git a/lib/tzlocal/utils.py b/lib/tzlocal/utils.py
index d1026b32..4ba82d3d 100644
--- a/lib/tzlocal/utils.py
+++ b/lib/tzlocal/utils.py
@@ -1,9 +1,9 @@
-# -*- coding: utf-8 -*-
+import logging
 import os
 import time
 import datetime
 import calendar
-import pytz_deprecation_shim as pds
+import warnings
 
 try:
     import zoneinfo  # pragma: no cover
@@ -12,35 +12,7 @@ except ImportError:
 
 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():
-    """Get system's timezone offset using built-in library time.
-
-    For the Timezone constants (altzone, daylight, timezone, and tzname), the
-    value is determined by the timezone rules in effect at module load time or
-    the last time tzset() is called and may be incorrect for times in the past.
-
-    To keep compatibility with Windows, we're always importing time module here.
-    """
-
-    localtime = calendar.timegm(time.localtime())
-    gmtime = calendar.timegm(time.gmtime())
-    offset = gmtime - localtime
-    # We could get the localtime and gmtime on either side of a second switch
-    # 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  # pragma: no cover
-    else:
-        return -time.timezone  # pragma: no cover
+log = logging.getLogger("tzlocal")
 
 
 def get_tz_offset(tz):
@@ -48,19 +20,27 @@ def get_tz_offset(tz):
     return int(datetime.datetime.now(tz).utcoffset().total_seconds())
 
 
-def assert_tz_offset(tz):
+def assert_tz_offset(tz, error=True):
     """Assert that system's timezone offset equals to the timezone offset found.
 
     If they don't match, we probably have a misconfiguration, for example, an
-    incorrect timezone set in /etc/timezone file in systemd distributions."""
+    incorrect timezone set in /etc/timezone file in systemd distributions.
+
+    If error is True, this method will raise a ValueError, otherwise it will
+    emit a warning.
+    """
+
     tz_offset = get_tz_offset(tz)
-    system_offset = get_system_offset()
-    if tz_offset != system_offset:
+    system_offset = calendar.timegm(time.localtime()) - calendar.timegm(time.gmtime())
+    # No one has timezone offsets less than a minute, so this should be close enough:
+    if abs(tz_offset - system_offset) > 60:
         msg = (
             "Timezone offset does not match system offset: {} != {}. "
             "Please, check your config files."
         ).format(tz_offset, system_offset)
-        raise ValueError(msg)
+        if error:
+            raise ValueError(msg)
+        warnings.warn(msg)
 
 
 def _tz_name_from_env(tzenv=None):
@@ -70,6 +50,8 @@ def _tz_name_from_env(tzenv=None):
     if not tzenv:
         return None
 
+    log.debug(f"Found a TZ environment: {tzenv}")
+
     if tzenv[0] == ":":
         tzenv = tzenv[1:]
 
@@ -92,6 +74,9 @@ def _tz_name_from_env(tzenv=None):
             # Indeed
             return parts[-1]
 
+    log.debug("TZ does not contain a time zone name")
+    return None
+
 
 def _tz_from_env(tzenv=None):
     if tzenv is None:
@@ -112,17 +97,16 @@ def _tz_from_env(tzenv=None):
             # 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)
+            return zoneinfo.ZoneInfo.from_file(tzfile, key=tzname)
 
     # TZ must specify a zoneinfo zone.
     try:
-        tz = pds.timezone(tzenv)
+        tz = zoneinfo.ZoneInfo(tzenv)
         # That worked, so we return this:
         return tz
-    except pds.UnknownTimeZoneError:
+    except zoneinfo.ZoneInfoNotFoundError:
         # Nope, it's something like "PST4DST" etc, we can't handle that.
-        raise ZoneInfoNotFoundError(
+        raise zoneinfo.ZoneInfoNotFoundError(
             "tzlocal() does not support non-zoneinfo timezones like %s. \n"
-            "Please use a timezone in the form of Continent/City"
+            "Please use a timezone in the form of Continent/City" % tzenv
         ) from None
diff --git a/lib/tzlocal/win32.py b/lib/tzlocal/win32.py
index 720ab2b7..9e8dc735 100644
--- a/lib/tzlocal/win32.py
+++ b/lib/tzlocal/win32.py
@@ -1,17 +1,24 @@
+import logging
 from datetime import datetime
-import pytz_deprecation_shim as pds
 
 try:
     import _winreg as winreg
 except ImportError:
     import winreg
 
+try:
+    import zoneinfo  # pragma: no cover
+except ImportError:
+    from backports import zoneinfo  # pragma: no cover
+
 from tzlocal.windows_tz import win_tz
 from tzlocal import utils
 
 _cache_tz = None
 _cache_tz_name = None
 
+log = logging.getLogger("tzlocal")
+
 
 def valuestodict(key):
     """Convert a registry key's values to a dictionary."""
@@ -48,6 +55,7 @@ def _get_localzone_name():
     if tzenv:
         return tzenv
 
+    log.debug("Looking up time zone info from registry")
     handle = winreg.ConnectRegistry(None, winreg.HKEY_LOCAL_MACHINE)
 
     TZLOCALKEYNAME = r"SYSTEM\CurrentControlSet\Control\TimeZoneInformation"
@@ -74,13 +82,13 @@ def _get_localzone_name():
 
     # Return what we have.
     if timezone is None:
-        raise utils.ZoneInfoNotFoundError(tzkeyname)
+        raise zoneinfo.ZoneInfoNotFoundError(tzkeyname)
 
     if keyvalues.get("DynamicDaylightTimeDisabled", 0) == 1:
         # DST is disabled, so don't return the timezone name,
         # instead return Etc/GMT+offset
 
-        tz = pds.timezone(timezone)
+        tz = zoneinfo.ZoneInfo(timezone)
         has_dst, std_offset, dst_offset = _get_dst_info(tz)
         if not has_dst:
             # The DST is turned off in the windows configuration,
@@ -88,13 +96,15 @@ def _get_localzone_name():
             return timezone
 
         if std_offset is None:
-            raise utils.ZoneInfoNotFoundError(
-                f"{tzkeyname} claims to not have a non-DST time!?")
+            raise zoneinfo.ZoneInfoNotFoundError(
+                f"{tzkeyname} claims to not have a non-DST time!?"
+            )
 
         if std_offset % 3600:
             # I can't convert this to an hourly offset
-            raise utils.ZoneInfoNotFoundError(
-                f"tzlocal can't support disabling DST in the {timezone} zone.")
+            raise zoneinfo.ZoneInfoNotFoundError(
+                f"tzlocal can't support disabling DST in the {timezone} zone."
+            )
 
         # This has whole hours as offset, return it as Etc/GMT
         return f"Etc/GMT{-std_offset//3600:+.0f}"
@@ -116,13 +126,13 @@ def get_localzone():
 
     global _cache_tz
     if _cache_tz is None:
-        _cache_tz = pds.timezone(get_localzone_name())
+        _cache_tz = zoneinfo.ZoneInfo(get_localzone_name())
 
     if not utils._tz_name_from_env():
         # If the timezone does NOT come from a TZ environment variable,
         # verify that it's correct. If it's from the environment,
         # we accept it, this is so you can run tests with different timezones.
-        utils.assert_tz_offset(_cache_tz)
+        utils.assert_tz_offset(_cache_tz, error=False)
 
     return _cache_tz
 
@@ -132,6 +142,6 @@ def reload_localzone():
     global _cache_tz
     global _cache_tz_name
     _cache_tz_name = _get_localzone_name()
-    _cache_tz = pds.timezone(_cache_tz_name)
-    utils.assert_tz_offset(_cache_tz)
+    _cache_tz = zoneinfo.ZoneInfo(_cache_tz_name)
+    utils.assert_tz_offset(_cache_tz, error=False)
     return _cache_tz
diff --git a/lib/tzlocal/windows_tz.py b/lib/tzlocal/windows_tz.py
index 0d285037..ed49c4ac 100644
--- a/lib/tzlocal/windows_tz.py
+++ b/lib/tzlocal/windows_tz.py
@@ -1,699 +1,718 @@
 # This file is autogenerated by the update_windows_mapping.py script
 # Do not edit.
-win_tz = {'AUS Central Standard Time': 'Australia/Darwin',
- 'AUS Eastern Standard Time': 'Australia/Sydney',
- 'Afghanistan Standard Time': 'Asia/Kabul',
- 'Alaskan Standard Time': 'America/Anchorage',
- 'Aleutian Standard Time': 'America/Adak',
- 'Altai Standard Time': 'Asia/Barnaul',
- 'Arab Standard Time': 'Asia/Riyadh',
- 'Arabian Standard Time': 'Asia/Dubai',
- 'Arabic Standard Time': 'Asia/Baghdad',
- 'Argentina Standard Time': 'America/Buenos_Aires',
- 'Astrakhan Standard Time': 'Europe/Astrakhan',
- 'Atlantic Standard Time': 'America/Halifax',
- 'Aus Central W. Standard Time': 'Australia/Eucla',
- 'Azerbaijan Standard Time': 'Asia/Baku',
- 'Azores Standard Time': 'Atlantic/Azores',
- 'Bahia Standard Time': 'America/Bahia',
- 'Bangladesh Standard Time': 'Asia/Dhaka',
- 'Belarus Standard Time': 'Europe/Minsk',
- 'Bougainville Standard Time': 'Pacific/Bougainville',
- 'Canada Central Standard Time': 'America/Regina',
- 'Cape Verde Standard Time': 'Atlantic/Cape_Verde',
- 'Caucasus Standard Time': 'Asia/Yerevan',
- 'Cen. Australia Standard Time': 'Australia/Adelaide',
- 'Central America Standard Time': 'America/Guatemala',
- 'Central Asia Standard Time': 'Asia/Almaty',
- 'Central Brazilian Standard Time': 'America/Cuiaba',
- 'Central Europe Standard Time': 'Europe/Budapest',
- 'Central European Standard Time': 'Europe/Warsaw',
- 'Central Pacific Standard Time': 'Pacific/Guadalcanal',
- 'Central Standard Time': 'America/Chicago',
- 'Central Standard Time (Mexico)': 'America/Mexico_City',
- 'Chatham Islands Standard Time': 'Pacific/Chatham',
- 'China Standard Time': 'Asia/Shanghai',
- 'Cuba Standard Time': 'America/Havana',
- 'Dateline Standard Time': 'Etc/GMT+12',
- 'E. Africa Standard Time': 'Africa/Nairobi',
- 'E. Australia Standard Time': 'Australia/Brisbane',
- 'E. Europe Standard Time': 'Europe/Chisinau',
- 'E. South America Standard Time': 'America/Sao_Paulo',
- 'Easter Island Standard Time': 'Pacific/Easter',
- 'Eastern Standard Time': 'America/New_York',
- 'Eastern Standard Time (Mexico)': 'America/Cancun',
- 'Egypt Standard Time': 'Africa/Cairo',
- 'Ekaterinburg Standard Time': 'Asia/Yekaterinburg',
- 'FLE Standard Time': 'Europe/Kiev',
- 'Fiji Standard Time': 'Pacific/Fiji',
- 'GMT Standard Time': 'Europe/London',
- 'GTB Standard Time': 'Europe/Bucharest',
- 'Georgian Standard Time': 'Asia/Tbilisi',
- 'Greenland Standard Time': 'America/Godthab',
- 'Greenwich Standard Time': 'Atlantic/Reykjavik',
- 'Haiti Standard Time': 'America/Port-au-Prince',
- 'Hawaiian Standard Time': 'Pacific/Honolulu',
- 'India Standard Time': 'Asia/Calcutta',
- 'Iran Standard Time': 'Asia/Tehran',
- 'Israel Standard Time': 'Asia/Jerusalem',
- 'Jordan Standard Time': 'Asia/Amman',
- 'Kaliningrad Standard Time': 'Europe/Kaliningrad',
- 'Korea Standard Time': 'Asia/Seoul',
- 'Libya Standard Time': 'Africa/Tripoli',
- 'Line Islands Standard Time': 'Pacific/Kiritimati',
- 'Lord Howe Standard Time': 'Australia/Lord_Howe',
- 'Magadan Standard Time': 'Asia/Magadan',
- 'Magallanes Standard Time': 'America/Punta_Arenas',
- 'Marquesas Standard Time': 'Pacific/Marquesas',
- 'Mauritius Standard Time': 'Indian/Mauritius',
- 'Middle East Standard Time': 'Asia/Beirut',
- 'Montevideo Standard Time': 'America/Montevideo',
- 'Morocco Standard Time': 'Africa/Casablanca',
- 'Mountain Standard Time': 'America/Denver',
- 'Mountain Standard Time (Mexico)': 'America/Chihuahua',
- 'Myanmar Standard Time': 'Asia/Rangoon',
- 'N. Central Asia Standard Time': 'Asia/Novosibirsk',
- 'Namibia Standard Time': 'Africa/Windhoek',
- 'Nepal Standard Time': 'Asia/Katmandu',
- 'New Zealand Standard Time': 'Pacific/Auckland',
- 'Newfoundland Standard Time': 'America/St_Johns',
- 'Norfolk Standard Time': 'Pacific/Norfolk',
- 'North Asia East Standard Time': 'Asia/Irkutsk',
- 'North Asia Standard Time': 'Asia/Krasnoyarsk',
- 'North Korea Standard Time': 'Asia/Pyongyang',
- 'Omsk Standard Time': 'Asia/Omsk',
- 'Pacific SA Standard Time': 'America/Santiago',
- 'Pacific Standard Time': 'America/Los_Angeles',
- 'Pacific Standard Time (Mexico)': 'America/Tijuana',
- 'Pakistan Standard Time': 'Asia/Karachi',
- 'Paraguay Standard Time': 'America/Asuncion',
- 'Qyzylorda Standard Time': 'Asia/Qyzylorda',
- 'Romance Standard Time': 'Europe/Paris',
- 'Russia Time Zone 10': 'Asia/Srednekolymsk',
- 'Russia Time Zone 11': 'Asia/Kamchatka',
- 'Russia Time Zone 3': 'Europe/Samara',
- 'Russian Standard Time': 'Europe/Moscow',
- 'SA Eastern Standard Time': 'America/Cayenne',
- 'SA Pacific Standard Time': 'America/Bogota',
- 'SA Western Standard Time': 'America/La_Paz',
- 'SE Asia Standard Time': 'Asia/Bangkok',
- 'Saint Pierre Standard Time': 'America/Miquelon',
- 'Sakhalin Standard Time': 'Asia/Sakhalin',
- 'Samoa Standard Time': 'Pacific/Apia',
- 'Sao Tome Standard Time': 'Africa/Sao_Tome',
- 'Saratov Standard Time': 'Europe/Saratov',
- 'Singapore Standard Time': 'Asia/Singapore',
- 'South Africa Standard Time': 'Africa/Johannesburg',
- 'South Sudan Standard Time': 'Africa/Juba',
- 'Sri Lanka Standard Time': 'Asia/Colombo',
- 'Sudan Standard Time': 'Africa/Khartoum',
- 'Syria Standard Time': 'Asia/Damascus',
- 'Taipei Standard Time': 'Asia/Taipei',
- 'Tasmania Standard Time': 'Australia/Hobart',
- 'Tocantins Standard Time': 'America/Araguaina',
- 'Tokyo Standard Time': 'Asia/Tokyo',
- 'Tomsk Standard Time': 'Asia/Tomsk',
- 'Tonga Standard Time': 'Pacific/Tongatapu',
- 'Transbaikal Standard Time': 'Asia/Chita',
- 'Turkey Standard Time': 'Europe/Istanbul',
- 'Turks And Caicos Standard Time': 'America/Grand_Turk',
- 'US Eastern Standard Time': 'America/Indianapolis',
- 'US Mountain Standard Time': 'America/Phoenix',
- 'UTC': 'Etc/UTC',
- 'UTC+12': 'Etc/GMT-12',
- 'UTC+13': 'Etc/GMT-13',
- 'UTC-02': 'Etc/GMT+2',
- 'UTC-08': 'Etc/GMT+8',
- 'UTC-09': 'Etc/GMT+9',
- 'UTC-11': 'Etc/GMT+11',
- 'Ulaanbaatar Standard Time': 'Asia/Ulaanbaatar',
- 'Venezuela Standard Time': 'America/Caracas',
- 'Vladivostok Standard Time': 'Asia/Vladivostok',
- 'Volgograd Standard Time': 'Europe/Volgograd',
- 'W. Australia Standard Time': 'Australia/Perth',
- 'W. Central Africa Standard Time': 'Africa/Lagos',
- 'W. Europe Standard Time': 'Europe/Berlin',
- 'W. Mongolia Standard Time': 'Asia/Hovd',
- 'West Asia Standard Time': 'Asia/Tashkent',
- 'West Bank Standard Time': 'Asia/Hebron',
- 'West Pacific Standard Time': 'Pacific/Port_Moresby',
- 'Yakutsk Standard Time': 'Asia/Yakutsk',
- 'Yukon Standard Time': 'America/Whitehorse'}
+win_tz = {
+    "AUS Central Standard Time": "Australia/Darwin",
+    "AUS Eastern Standard Time": "Australia/Sydney",
+    "Afghanistan Standard Time": "Asia/Kabul",
+    "Alaskan Standard Time": "America/Anchorage",
+    "Aleutian Standard Time": "America/Adak",
+    "Altai Standard Time": "Asia/Barnaul",
+    "Arab Standard Time": "Asia/Riyadh",
+    "Arabian Standard Time": "Asia/Dubai",
+    "Arabic Standard Time": "Asia/Baghdad",
+    "Argentina Standard Time": "America/Buenos_Aires",
+    "Astrakhan Standard Time": "Europe/Astrakhan",
+    "Atlantic Standard Time": "America/Halifax",
+    "Aus Central W. Standard Time": "Australia/Eucla",
+    "Azerbaijan Standard Time": "Asia/Baku",
+    "Azores Standard Time": "Atlantic/Azores",
+    "Bahia Standard Time": "America/Bahia",
+    "Bangladesh Standard Time": "Asia/Dhaka",
+    "Belarus Standard Time": "Europe/Minsk",
+    "Bougainville Standard Time": "Pacific/Bougainville",
+    "Canada Central Standard Time": "America/Regina",
+    "Cape Verde Standard Time": "Atlantic/Cape_Verde",
+    "Caucasus Standard Time": "Asia/Yerevan",
+    "Cen. Australia Standard Time": "Australia/Adelaide",
+    "Central America Standard Time": "America/Guatemala",
+    "Central Asia Standard Time": "Asia/Almaty",
+    "Central Brazilian Standard Time": "America/Cuiaba",
+    "Central Europe Standard Time": "Europe/Budapest",
+    "Central European Standard Time": "Europe/Warsaw",
+    "Central Pacific Standard Time": "Pacific/Guadalcanal",
+    "Central Standard Time": "America/Chicago",
+    "Central Standard Time (Mexico)": "America/Mexico_City",
+    "Chatham Islands Standard Time": "Pacific/Chatham",
+    "China Standard Time": "Asia/Shanghai",
+    "Cuba Standard Time": "America/Havana",
+    "Dateline Standard Time": "Etc/GMT+12",
+    "E. Africa Standard Time": "Africa/Nairobi",
+    "E. Australia Standard Time": "Australia/Brisbane",
+    "E. Europe Standard Time": "Europe/Chisinau",
+    "E. South America Standard Time": "America/Sao_Paulo",
+    "Easter Island Standard Time": "Pacific/Easter",
+    "Eastern Standard Time": "America/New_York",
+    "Eastern Standard Time (Mexico)": "America/Cancun",
+    "Egypt Standard Time": "Africa/Cairo",
+    "Ekaterinburg Standard Time": "Asia/Yekaterinburg",
+    "FLE Standard Time": "Europe/Kiev",
+    "Fiji Standard Time": "Pacific/Fiji",
+    "GMT Standard Time": "Europe/London",
+    "GTB Standard Time": "Europe/Bucharest",
+    "Georgian Standard Time": "Asia/Tbilisi",
+    "Greenland Standard Time": "America/Godthab",
+    "Greenwich Standard Time": "Atlantic/Reykjavik",
+    "Haiti Standard Time": "America/Port-au-Prince",
+    "Hawaiian Standard Time": "Pacific/Honolulu",
+    "India Standard Time": "Asia/Calcutta",
+    "Iran Standard Time": "Asia/Tehran",
+    "Israel Standard Time": "Asia/Jerusalem",
+    "Jordan Standard Time": "Asia/Amman",
+    "Kaliningrad Standard Time": "Europe/Kaliningrad",
+    "Korea Standard Time": "Asia/Seoul",
+    "Libya Standard Time": "Africa/Tripoli",
+    "Line Islands Standard Time": "Pacific/Kiritimati",
+    "Lord Howe Standard Time": "Australia/Lord_Howe",
+    "Magadan Standard Time": "Asia/Magadan",
+    "Magallanes Standard Time": "America/Punta_Arenas",
+    "Marquesas Standard Time": "Pacific/Marquesas",
+    "Mauritius Standard Time": "Indian/Mauritius",
+    "Middle East Standard Time": "Asia/Beirut",
+    "Montevideo Standard Time": "America/Montevideo",
+    "Morocco Standard Time": "Africa/Casablanca",
+    "Mountain Standard Time": "America/Denver",
+    "Mountain Standard Time (Mexico)": "America/Mazatlan",
+    "Myanmar Standard Time": "Asia/Rangoon",
+    "N. Central Asia Standard Time": "Asia/Novosibirsk",
+    "Namibia Standard Time": "Africa/Windhoek",
+    "Nepal Standard Time": "Asia/Katmandu",
+    "New Zealand Standard Time": "Pacific/Auckland",
+    "Newfoundland Standard Time": "America/St_Johns",
+    "Norfolk Standard Time": "Pacific/Norfolk",
+    "North Asia East Standard Time": "Asia/Irkutsk",
+    "North Asia Standard Time": "Asia/Krasnoyarsk",
+    "North Korea Standard Time": "Asia/Pyongyang",
+    "Omsk Standard Time": "Asia/Omsk",
+    "Pacific SA Standard Time": "America/Santiago",
+    "Pacific Standard Time": "America/Los_Angeles",
+    "Pacific Standard Time (Mexico)": "America/Tijuana",
+    "Pakistan Standard Time": "Asia/Karachi",
+    "Paraguay Standard Time": "America/Asuncion",
+    "Qyzylorda Standard Time": "Asia/Qyzylorda",
+    "Romance Standard Time": "Europe/Paris",
+    "Russia Time Zone 10": "Asia/Srednekolymsk",
+    "Russia Time Zone 11": "Asia/Kamchatka",
+    "Russia Time Zone 3": "Europe/Samara",
+    "Russian Standard Time": "Europe/Moscow",
+    "SA Eastern Standard Time": "America/Cayenne",
+    "SA Pacific Standard Time": "America/Bogota",
+    "SA Western Standard Time": "America/La_Paz",
+    "SE Asia Standard Time": "Asia/Bangkok",
+    "Saint Pierre Standard Time": "America/Miquelon",
+    "Sakhalin Standard Time": "Asia/Sakhalin",
+    "Samoa Standard Time": "Pacific/Apia",
+    "Sao Tome Standard Time": "Africa/Sao_Tome",
+    "Saratov Standard Time": "Europe/Saratov",
+    "Singapore Standard Time": "Asia/Singapore",
+    "South Africa Standard Time": "Africa/Johannesburg",
+    "South Sudan Standard Time": "Africa/Juba",
+    "Sri Lanka Standard Time": "Asia/Colombo",
+    "Sudan Standard Time": "Africa/Khartoum",
+    "Syria Standard Time": "Asia/Damascus",
+    "Taipei Standard Time": "Asia/Taipei",
+    "Tasmania Standard Time": "Australia/Hobart",
+    "Tocantins Standard Time": "America/Araguaina",
+    "Tokyo Standard Time": "Asia/Tokyo",
+    "Tomsk Standard Time": "Asia/Tomsk",
+    "Tonga Standard Time": "Pacific/Tongatapu",
+    "Transbaikal Standard Time": "Asia/Chita",
+    "Turkey Standard Time": "Europe/Istanbul",
+    "Turks And Caicos Standard Time": "America/Grand_Turk",
+    "US Eastern Standard Time": "America/Indianapolis",
+    "US Mountain Standard Time": "America/Phoenix",
+    "UTC": "Etc/UTC",
+    "UTC+12": "Etc/GMT-12",
+    "UTC+13": "Etc/GMT-13",
+    "UTC-02": "Etc/GMT+2",
+    "UTC-08": "Etc/GMT+8",
+    "UTC-09": "Etc/GMT+9",
+    "UTC-11": "Etc/GMT+11",
+    "Ulaanbaatar Standard Time": "Asia/Ulaanbaatar",
+    "Venezuela Standard Time": "America/Caracas",
+    "Vladivostok Standard Time": "Asia/Vladivostok",
+    "Volgograd Standard Time": "Europe/Volgograd",
+    "W. Australia Standard Time": "Australia/Perth",
+    "W. Central Africa Standard Time": "Africa/Lagos",
+    "W. Europe Standard Time": "Europe/Berlin",
+    "W. Mongolia Standard Time": "Asia/Hovd",
+    "West Asia Standard Time": "Asia/Tashkent",
+    "West Bank Standard Time": "Asia/Hebron",
+    "West Pacific Standard Time": "Pacific/Port_Moresby",
+    "Yakutsk Standard Time": "Asia/Yakutsk",
+    "Yukon Standard Time": "America/Whitehorse",
+}
 
 # Old name for the win_tz variable:
 tz_names = win_tz
 
-tz_win = {'Africa/Abidjan': 'Greenwich Standard Time',
- 'Africa/Accra': 'Greenwich Standard Time',
- 'Africa/Addis_Ababa': 'E. Africa Standard Time',
- 'Africa/Algiers': 'W. Central Africa Standard Time',
- 'Africa/Asmera': 'E. Africa Standard Time',
- 'Africa/Bamako': 'Greenwich Standard Time',
- 'Africa/Bangui': 'W. Central Africa Standard Time',
- 'Africa/Banjul': 'Greenwich Standard Time',
- 'Africa/Bissau': 'Greenwich Standard Time',
- 'Africa/Blantyre': 'South Africa Standard Time',
- 'Africa/Brazzaville': 'W. Central Africa Standard Time',
- 'Africa/Bujumbura': 'South Africa Standard Time',
- 'Africa/Cairo': 'Egypt Standard Time',
- 'Africa/Casablanca': 'Morocco Standard Time',
- 'Africa/Ceuta': 'Romance Standard Time',
- 'Africa/Conakry': 'Greenwich Standard Time',
- 'Africa/Dakar': 'Greenwich Standard Time',
- 'Africa/Dar_es_Salaam': 'E. Africa Standard Time',
- 'Africa/Djibouti': 'E. Africa Standard Time',
- 'Africa/Douala': 'W. Central Africa Standard Time',
- 'Africa/El_Aaiun': 'Morocco Standard Time',
- 'Africa/Freetown': 'Greenwich Standard Time',
- 'Africa/Gaborone': 'South Africa Standard Time',
- 'Africa/Harare': 'South Africa Standard Time',
- 'Africa/Johannesburg': 'South Africa Standard Time',
- 'Africa/Juba': 'South Sudan Standard Time',
- 'Africa/Kampala': 'E. Africa Standard Time',
- 'Africa/Khartoum': 'Sudan Standard Time',
- 'Africa/Kigali': 'South Africa Standard Time',
- 'Africa/Kinshasa': 'W. Central Africa Standard Time',
- 'Africa/Lagos': 'W. Central Africa Standard Time',
- 'Africa/Libreville': 'W. Central Africa Standard Time',
- 'Africa/Lome': 'Greenwich Standard Time',
- 'Africa/Luanda': 'W. Central Africa Standard Time',
- 'Africa/Lubumbashi': 'South Africa Standard Time',
- 'Africa/Lusaka': 'South Africa Standard Time',
- 'Africa/Malabo': 'W. Central Africa Standard Time',
- 'Africa/Maputo': 'South Africa Standard Time',
- 'Africa/Maseru': 'South Africa Standard Time',
- 'Africa/Mbabane': 'South Africa Standard Time',
- 'Africa/Mogadishu': 'E. Africa Standard Time',
- 'Africa/Monrovia': 'Greenwich Standard Time',
- 'Africa/Nairobi': 'E. Africa Standard Time',
- 'Africa/Ndjamena': 'W. Central Africa Standard Time',
- 'Africa/Niamey': 'W. Central Africa Standard Time',
- 'Africa/Nouakchott': 'Greenwich Standard Time',
- 'Africa/Ouagadougou': 'Greenwich Standard Time',
- 'Africa/Porto-Novo': 'W. Central Africa Standard Time',
- 'Africa/Sao_Tome': 'Sao Tome Standard Time',
- 'Africa/Timbuktu': 'Greenwich Standard Time',
- 'Africa/Tripoli': 'Libya Standard Time',
- 'Africa/Tunis': 'W. Central Africa Standard Time',
- 'Africa/Windhoek': 'Namibia Standard Time',
- 'America/Adak': 'Aleutian Standard Time',
- 'America/Anchorage': 'Alaskan Standard Time',
- 'America/Anguilla': 'SA Western Standard Time',
- 'America/Antigua': 'SA Western Standard Time',
- 'America/Araguaina': 'Tocantins Standard Time',
- 'America/Argentina/La_Rioja': 'Argentina Standard Time',
- 'America/Argentina/Rio_Gallegos': 'Argentina Standard Time',
- 'America/Argentina/Salta': 'Argentina Standard Time',
- 'America/Argentina/San_Juan': 'Argentina Standard Time',
- 'America/Argentina/San_Luis': 'Argentina Standard Time',
- 'America/Argentina/Tucuman': 'Argentina Standard Time',
- 'America/Argentina/Ushuaia': 'Argentina Standard Time',
- 'America/Aruba': 'SA Western Standard Time',
- 'America/Asuncion': 'Paraguay Standard Time',
- 'America/Atka': 'Aleutian Standard Time',
- 'America/Bahia': 'Bahia Standard Time',
- 'America/Bahia_Banderas': 'Central Standard Time (Mexico)',
- 'America/Barbados': 'SA Western Standard Time',
- 'America/Belem': 'SA Eastern Standard Time',
- 'America/Belize': 'Central America Standard Time',
- 'America/Blanc-Sablon': 'SA Western Standard Time',
- 'America/Boa_Vista': 'SA Western Standard Time',
- 'America/Bogota': 'SA Pacific Standard Time',
- 'America/Boise': 'Mountain Standard Time',
- 'America/Buenos_Aires': 'Argentina Standard Time',
- 'America/Cambridge_Bay': 'Mountain Standard Time',
- 'America/Campo_Grande': 'Central Brazilian Standard Time',
- 'America/Cancun': 'Eastern Standard Time (Mexico)',
- 'America/Caracas': 'Venezuela Standard Time',
- 'America/Catamarca': 'Argentina Standard Time',
- 'America/Cayenne': 'SA Eastern Standard Time',
- 'America/Cayman': 'SA Pacific Standard Time',
- 'America/Chicago': 'Central Standard Time',
- 'America/Chihuahua': 'Mountain Standard Time (Mexico)',
- 'America/Coral_Harbour': 'SA Pacific Standard Time',
- 'America/Cordoba': 'Argentina Standard Time',
- 'America/Costa_Rica': 'Central America Standard Time',
- 'America/Creston': 'US Mountain Standard Time',
- 'America/Cuiaba': 'Central Brazilian Standard Time',
- 'America/Curacao': 'SA Western Standard Time',
- 'America/Danmarkshavn': 'Greenwich Standard Time',
- 'America/Dawson': 'Yukon Standard Time',
- 'America/Dawson_Creek': 'US Mountain Standard Time',
- 'America/Denver': 'Mountain Standard Time',
- 'America/Detroit': 'Eastern Standard Time',
- 'America/Dominica': 'SA Western Standard Time',
- 'America/Edmonton': 'Mountain Standard Time',
- 'America/Eirunepe': 'SA Pacific Standard Time',
- 'America/El_Salvador': 'Central America Standard Time',
- 'America/Ensenada': 'Pacific Standard Time (Mexico)',
- 'America/Fort_Nelson': 'US Mountain Standard Time',
- 'America/Fortaleza': 'SA Eastern Standard Time',
- 'America/Glace_Bay': 'Atlantic Standard Time',
- 'America/Godthab': 'Greenland Standard Time',
- 'America/Goose_Bay': 'Atlantic Standard Time',
- 'America/Grand_Turk': 'Turks And Caicos Standard Time',
- 'America/Grenada': 'SA Western Standard Time',
- 'America/Guadeloupe': 'SA Western Standard Time',
- 'America/Guatemala': 'Central America Standard Time',
- 'America/Guayaquil': 'SA Pacific Standard Time',
- 'America/Guyana': 'SA Western Standard Time',
- 'America/Halifax': 'Atlantic Standard Time',
- 'America/Havana': 'Cuba Standard Time',
- 'America/Hermosillo': 'US Mountain Standard Time',
- 'America/Indiana/Knox': 'Central Standard Time',
- 'America/Indiana/Marengo': 'US Eastern Standard Time',
- 'America/Indiana/Petersburg': 'Eastern Standard Time',
- 'America/Indiana/Tell_City': 'Central Standard Time',
- 'America/Indiana/Vevay': 'US Eastern Standard Time',
- 'America/Indiana/Vincennes': 'Eastern Standard Time',
- 'America/Indiana/Winamac': 'Eastern Standard Time',
- 'America/Indianapolis': 'US Eastern Standard Time',
- 'America/Inuvik': 'Mountain Standard Time',
- 'America/Iqaluit': 'Eastern Standard Time',
- 'America/Jamaica': 'SA Pacific Standard Time',
- 'America/Jujuy': 'Argentina Standard Time',
- 'America/Juneau': 'Alaskan Standard Time',
- 'America/Kentucky/Monticello': 'Eastern Standard Time',
- 'America/Knox_IN': 'Central Standard Time',
- 'America/Kralendijk': 'SA Western Standard Time',
- 'America/La_Paz': 'SA Western Standard Time',
- 'America/Lima': 'SA Pacific Standard Time',
- 'America/Los_Angeles': 'Pacific Standard Time',
- 'America/Louisville': 'Eastern Standard Time',
- 'America/Lower_Princes': 'SA Western Standard Time',
- 'America/Maceio': 'SA Eastern Standard Time',
- 'America/Managua': 'Central America Standard Time',
- 'America/Manaus': 'SA Western Standard Time',
- 'America/Marigot': 'SA Western Standard Time',
- 'America/Martinique': 'SA Western Standard Time',
- 'America/Matamoros': 'Central Standard Time',
- 'America/Mazatlan': 'Mountain Standard Time (Mexico)',
- 'America/Mendoza': 'Argentina Standard Time',
- 'America/Menominee': 'Central Standard Time',
- 'America/Merida': 'Central Standard Time (Mexico)',
- 'America/Metlakatla': 'Alaskan Standard Time',
- 'America/Mexico_City': 'Central Standard Time (Mexico)',
- 'America/Miquelon': 'Saint Pierre Standard Time',
- 'America/Moncton': 'Atlantic Standard Time',
- 'America/Monterrey': 'Central Standard Time (Mexico)',
- 'America/Montevideo': 'Montevideo Standard Time',
- 'America/Montreal': 'Eastern Standard Time',
- 'America/Montserrat': 'SA Western Standard Time',
- 'America/Nassau': 'Eastern Standard Time',
- 'America/New_York': 'Eastern Standard Time',
- 'America/Nipigon': 'Eastern Standard Time',
- 'America/Nome': 'Alaskan Standard Time',
- 'America/Noronha': 'UTC-02',
- 'America/North_Dakota/Beulah': 'Central Standard Time',
- 'America/North_Dakota/Center': 'Central Standard Time',
- 'America/North_Dakota/New_Salem': 'Central Standard Time',
- 'America/Ojinaga': 'Mountain Standard Time',
- 'America/Panama': 'SA Pacific Standard Time',
- 'America/Pangnirtung': 'Eastern Standard Time',
- 'America/Paramaribo': 'SA Eastern Standard Time',
- 'America/Phoenix': 'US Mountain Standard Time',
- 'America/Port-au-Prince': 'Haiti Standard Time',
- 'America/Port_of_Spain': 'SA Western Standard Time',
- 'America/Porto_Acre': 'SA Pacific Standard Time',
- 'America/Porto_Velho': 'SA Western Standard Time',
- 'America/Puerto_Rico': 'SA Western Standard Time',
- 'America/Punta_Arenas': 'Magallanes Standard Time',
- 'America/Rainy_River': 'Central Standard Time',
- 'America/Rankin_Inlet': 'Central Standard Time',
- 'America/Recife': 'SA Eastern Standard Time',
- 'America/Regina': 'Canada Central Standard Time',
- 'America/Resolute': 'Central Standard Time',
- 'America/Rio_Branco': 'SA Pacific Standard Time',
- 'America/Santa_Isabel': 'Pacific Standard Time (Mexico)',
- 'America/Santarem': 'SA Eastern Standard Time',
- 'America/Santiago': 'Pacific SA Standard Time',
- 'America/Santo_Domingo': 'SA Western Standard Time',
- 'America/Sao_Paulo': 'E. South America Standard Time',
- 'America/Scoresbysund': 'Azores Standard Time',
- 'America/Shiprock': 'Mountain Standard Time',
- 'America/Sitka': 'Alaskan Standard Time',
- 'America/St_Barthelemy': 'SA Western Standard Time',
- 'America/St_Johns': 'Newfoundland Standard Time',
- 'America/St_Kitts': 'SA Western Standard Time',
- 'America/St_Lucia': 'SA Western Standard Time',
- 'America/St_Thomas': 'SA Western Standard Time',
- 'America/St_Vincent': 'SA Western Standard Time',
- 'America/Swift_Current': 'Canada Central Standard Time',
- 'America/Tegucigalpa': 'Central America Standard Time',
- 'America/Thule': 'Atlantic Standard Time',
- 'America/Thunder_Bay': 'Eastern Standard Time',
- 'America/Tijuana': 'Pacific Standard Time (Mexico)',
- 'America/Toronto': 'Eastern Standard Time',
- 'America/Tortola': 'SA Western Standard Time',
- 'America/Vancouver': 'Pacific Standard Time',
- 'America/Virgin': 'SA Western Standard Time',
- 'America/Whitehorse': 'Yukon Standard Time',
- 'America/Winnipeg': 'Central Standard Time',
- 'America/Yakutat': 'Alaskan Standard Time',
- 'America/Yellowknife': 'Mountain Standard Time',
- 'Antarctica/Casey': 'Central Pacific Standard Time',
- 'Antarctica/Davis': 'SE Asia Standard Time',
- 'Antarctica/DumontDUrville': 'West Pacific Standard Time',
- 'Antarctica/Macquarie': 'Tasmania Standard Time',
- 'Antarctica/Mawson': 'West Asia Standard Time',
- 'Antarctica/McMurdo': 'New Zealand Standard Time',
- 'Antarctica/Palmer': 'SA Eastern Standard Time',
- 'Antarctica/Rothera': 'SA Eastern Standard Time',
- 'Antarctica/South_Pole': 'New Zealand Standard Time',
- 'Antarctica/Syowa': 'E. Africa Standard Time',
- 'Antarctica/Vostok': 'Central Asia Standard Time',
- 'Arctic/Longyearbyen': 'W. Europe Standard Time',
- 'Asia/Aden': 'Arab Standard Time',
- 'Asia/Almaty': 'Central Asia Standard Time',
- 'Asia/Amman': 'Jordan Standard Time',
- 'Asia/Anadyr': 'Russia Time Zone 11',
- 'Asia/Aqtau': 'West Asia Standard Time',
- 'Asia/Aqtobe': 'West Asia Standard Time',
- 'Asia/Ashgabat': 'West Asia Standard Time',
- 'Asia/Ashkhabad': 'West Asia Standard Time',
- 'Asia/Atyrau': 'West Asia Standard Time',
- 'Asia/Baghdad': 'Arabic Standard Time',
- 'Asia/Bahrain': 'Arab Standard Time',
- 'Asia/Baku': 'Azerbaijan Standard Time',
- 'Asia/Bangkok': 'SE Asia Standard Time',
- 'Asia/Barnaul': 'Altai Standard Time',
- 'Asia/Beirut': 'Middle East Standard Time',
- 'Asia/Bishkek': 'Central Asia Standard Time',
- 'Asia/Brunei': 'Singapore Standard Time',
- 'Asia/Calcutta': 'India Standard Time',
- 'Asia/Chita': 'Transbaikal Standard Time',
- 'Asia/Choibalsan': 'Ulaanbaatar Standard Time',
- 'Asia/Chongqing': 'China Standard Time',
- 'Asia/Chungking': 'China Standard Time',
- 'Asia/Colombo': 'Sri Lanka Standard Time',
- 'Asia/Dacca': 'Bangladesh Standard Time',
- 'Asia/Damascus': 'Syria Standard Time',
- 'Asia/Dhaka': 'Bangladesh Standard Time',
- 'Asia/Dili': 'Tokyo Standard Time',
- 'Asia/Dubai': 'Arabian Standard Time',
- 'Asia/Dushanbe': 'West Asia Standard Time',
- 'Asia/Famagusta': 'GTB Standard Time',
- 'Asia/Gaza': 'West Bank Standard Time',
- 'Asia/Harbin': 'China Standard Time',
- 'Asia/Hebron': 'West Bank Standard Time',
- 'Asia/Hong_Kong': 'China Standard Time',
- 'Asia/Hovd': 'W. Mongolia Standard Time',
- 'Asia/Irkutsk': 'North Asia East Standard Time',
- 'Asia/Jakarta': 'SE Asia Standard Time',
- 'Asia/Jayapura': 'Tokyo Standard Time',
- 'Asia/Jerusalem': 'Israel Standard Time',
- 'Asia/Kabul': 'Afghanistan Standard Time',
- 'Asia/Kamchatka': 'Russia Time Zone 11',
- 'Asia/Karachi': 'Pakistan Standard Time',
- 'Asia/Kashgar': 'Central Asia Standard Time',
- 'Asia/Katmandu': 'Nepal Standard Time',
- 'Asia/Khandyga': 'Yakutsk Standard Time',
- 'Asia/Krasnoyarsk': 'North Asia Standard Time',
- 'Asia/Kuala_Lumpur': 'Singapore Standard Time',
- 'Asia/Kuching': 'Singapore Standard Time',
- 'Asia/Kuwait': 'Arab Standard Time',
- 'Asia/Macao': 'China Standard Time',
- 'Asia/Macau': 'China Standard Time',
- 'Asia/Magadan': 'Magadan Standard Time',
- 'Asia/Makassar': 'Singapore Standard Time',
- 'Asia/Manila': 'Singapore Standard Time',
- 'Asia/Muscat': 'Arabian Standard Time',
- 'Asia/Nicosia': 'GTB Standard Time',
- 'Asia/Novokuznetsk': 'North Asia Standard Time',
- 'Asia/Novosibirsk': 'N. Central Asia Standard Time',
- 'Asia/Omsk': 'Omsk Standard Time',
- 'Asia/Oral': 'West Asia Standard Time',
- 'Asia/Phnom_Penh': 'SE Asia Standard Time',
- 'Asia/Pontianak': 'SE Asia Standard Time',
- 'Asia/Pyongyang': 'North Korea Standard Time',
- 'Asia/Qatar': 'Arab Standard Time',
- 'Asia/Qostanay': 'Central Asia Standard Time',
- 'Asia/Qyzylorda': 'Qyzylorda Standard Time',
- 'Asia/Rangoon': 'Myanmar Standard Time',
- 'Asia/Riyadh': 'Arab Standard Time',
- 'Asia/Saigon': 'SE Asia Standard Time',
- 'Asia/Sakhalin': 'Sakhalin Standard Time',
- 'Asia/Samarkand': 'West Asia Standard Time',
- 'Asia/Seoul': 'Korea Standard Time',
- 'Asia/Shanghai': 'China Standard Time',
- 'Asia/Singapore': 'Singapore Standard Time',
- 'Asia/Srednekolymsk': 'Russia Time Zone 10',
- 'Asia/Taipei': 'Taipei Standard Time',
- 'Asia/Tashkent': 'West Asia Standard Time',
- 'Asia/Tbilisi': 'Georgian Standard Time',
- 'Asia/Tehran': 'Iran Standard Time',
- 'Asia/Tel_Aviv': 'Israel Standard Time',
- 'Asia/Thimbu': 'Bangladesh Standard Time',
- 'Asia/Thimphu': 'Bangladesh Standard Time',
- 'Asia/Tokyo': 'Tokyo Standard Time',
- 'Asia/Tomsk': 'Tomsk Standard Time',
- 'Asia/Ujung_Pandang': 'Singapore Standard Time',
- 'Asia/Ulaanbaatar': 'Ulaanbaatar Standard Time',
- 'Asia/Ulan_Bator': 'Ulaanbaatar Standard Time',
- 'Asia/Urumqi': 'Central Asia Standard Time',
- 'Asia/Ust-Nera': 'Vladivostok Standard Time',
- 'Asia/Vientiane': 'SE Asia Standard Time',
- 'Asia/Vladivostok': 'Vladivostok Standard Time',
- 'Asia/Yakutsk': 'Yakutsk Standard Time',
- 'Asia/Yekaterinburg': 'Ekaterinburg Standard Time',
- 'Asia/Yerevan': 'Caucasus Standard Time',
- 'Atlantic/Azores': 'Azores Standard Time',
- 'Atlantic/Bermuda': 'Atlantic Standard Time',
- 'Atlantic/Canary': 'GMT Standard Time',
- 'Atlantic/Cape_Verde': 'Cape Verde Standard Time',
- 'Atlantic/Faeroe': 'GMT Standard Time',
- 'Atlantic/Jan_Mayen': 'W. Europe Standard Time',
- 'Atlantic/Madeira': 'GMT Standard Time',
- 'Atlantic/Reykjavik': 'Greenwich Standard Time',
- 'Atlantic/South_Georgia': 'UTC-02',
- 'Atlantic/St_Helena': 'Greenwich Standard Time',
- 'Atlantic/Stanley': 'SA Eastern Standard Time',
- 'Australia/ACT': 'AUS Eastern Standard Time',
- 'Australia/Adelaide': 'Cen. Australia Standard Time',
- 'Australia/Brisbane': 'E. Australia Standard Time',
- 'Australia/Broken_Hill': 'Cen. Australia Standard Time',
- 'Australia/Canberra': 'AUS Eastern Standard Time',
- 'Australia/Currie': 'Tasmania Standard Time',
- 'Australia/Darwin': 'AUS Central Standard Time',
- 'Australia/Eucla': 'Aus Central W. Standard Time',
- 'Australia/Hobart': 'Tasmania Standard Time',
- 'Australia/LHI': 'Lord Howe Standard Time',
- 'Australia/Lindeman': 'E. Australia Standard Time',
- 'Australia/Lord_Howe': 'Lord Howe Standard Time',
- 'Australia/Melbourne': 'AUS Eastern Standard Time',
- 'Australia/NSW': 'AUS Eastern Standard Time',
- 'Australia/North': 'AUS Central Standard Time',
- 'Australia/Perth': 'W. Australia Standard Time',
- 'Australia/Queensland': 'E. Australia Standard Time',
- 'Australia/South': 'Cen. Australia Standard Time',
- 'Australia/Sydney': 'AUS Eastern Standard Time',
- 'Australia/Tasmania': 'Tasmania Standard Time',
- 'Australia/Victoria': 'AUS Eastern Standard Time',
- 'Australia/West': 'W. Australia Standard Time',
- 'Australia/Yancowinna': 'Cen. Australia Standard Time',
- 'Brazil/Acre': 'SA Pacific Standard Time',
- 'Brazil/DeNoronha': 'UTC-02',
- 'Brazil/East': 'E. South America Standard Time',
- 'Brazil/West': 'SA Western Standard Time',
- 'CST6CDT': 'Central Standard Time',
- 'Canada/Atlantic': 'Atlantic Standard Time',
- 'Canada/Central': 'Central Standard Time',
- 'Canada/Eastern': 'Eastern Standard Time',
- 'Canada/Mountain': 'Mountain Standard Time',
- 'Canada/Newfoundland': 'Newfoundland Standard Time',
- 'Canada/Pacific': 'Pacific Standard Time',
- 'Canada/Saskatchewan': 'Canada Central Standard Time',
- 'Canada/Yukon': 'Yukon Standard Time',
- 'Chile/Continental': 'Pacific SA Standard Time',
- 'Chile/EasterIsland': 'Easter Island Standard Time',
- 'Cuba': 'Cuba Standard Time',
- 'EST5EDT': 'Eastern Standard Time',
- 'Egypt': 'Egypt Standard Time',
- 'Eire': 'GMT Standard Time',
- 'Etc/GMT': 'UTC',
- 'Etc/GMT+1': 'Cape Verde Standard Time',
- 'Etc/GMT+10': 'Hawaiian Standard Time',
- 'Etc/GMT+11': 'UTC-11',
- 'Etc/GMT+12': 'Dateline Standard Time',
- 'Etc/GMT+2': 'UTC-02',
- 'Etc/GMT+3': 'SA Eastern Standard Time',
- 'Etc/GMT+4': 'SA Western Standard Time',
- 'Etc/GMT+5': 'SA Pacific Standard Time',
- 'Etc/GMT+6': 'Central America Standard Time',
- 'Etc/GMT+7': 'US Mountain Standard Time',
- 'Etc/GMT+8': 'UTC-08',
- 'Etc/GMT+9': 'UTC-09',
- 'Etc/GMT-1': 'W. Central Africa Standard Time',
- 'Etc/GMT-10': 'West Pacific Standard Time',
- 'Etc/GMT-11': 'Central Pacific Standard Time',
- 'Etc/GMT-12': 'UTC+12',
- 'Etc/GMT-13': 'UTC+13',
- 'Etc/GMT-14': 'Line Islands Standard Time',
- 'Etc/GMT-2': 'South Africa Standard Time',
- 'Etc/GMT-3': 'E. Africa Standard Time',
- 'Etc/GMT-4': 'Arabian Standard Time',
- 'Etc/GMT-5': 'West Asia Standard Time',
- 'Etc/GMT-6': 'Central Asia Standard Time',
- 'Etc/GMT-7': 'SE Asia Standard Time',
- 'Etc/GMT-8': 'Singapore Standard Time',
- 'Etc/GMT-9': 'Tokyo Standard Time',
- 'Etc/UCT': 'UTC',
- 'Etc/UTC': 'UTC',
- 'Europe/Amsterdam': 'W. Europe Standard Time',
- 'Europe/Andorra': 'W. Europe Standard Time',
- 'Europe/Astrakhan': 'Astrakhan Standard Time',
- 'Europe/Athens': 'GTB Standard Time',
- 'Europe/Belfast': 'GMT Standard Time',
- 'Europe/Belgrade': 'Central Europe Standard Time',
- 'Europe/Berlin': 'W. Europe Standard Time',
- 'Europe/Bratislava': 'Central Europe Standard Time',
- 'Europe/Brussels': 'Romance Standard Time',
- 'Europe/Bucharest': 'GTB Standard Time',
- 'Europe/Budapest': 'Central Europe Standard Time',
- 'Europe/Busingen': 'W. Europe Standard Time',
- 'Europe/Chisinau': 'E. Europe Standard Time',
- 'Europe/Copenhagen': 'Romance Standard Time',
- 'Europe/Dublin': 'GMT Standard Time',
- 'Europe/Gibraltar': 'W. Europe Standard Time',
- 'Europe/Guernsey': 'GMT Standard Time',
- 'Europe/Helsinki': 'FLE Standard Time',
- 'Europe/Isle_of_Man': 'GMT Standard Time',
- 'Europe/Istanbul': 'Turkey Standard Time',
- 'Europe/Jersey': 'GMT Standard Time',
- 'Europe/Kaliningrad': 'Kaliningrad Standard Time',
- 'Europe/Kiev': 'FLE Standard Time',
- 'Europe/Kirov': 'Russian Standard Time',
- 'Europe/Lisbon': 'GMT Standard Time',
- 'Europe/Ljubljana': 'Central Europe Standard Time',
- 'Europe/London': 'GMT Standard Time',
- 'Europe/Luxembourg': 'W. Europe Standard Time',
- 'Europe/Madrid': 'Romance Standard Time',
- 'Europe/Malta': 'W. Europe Standard Time',
- 'Europe/Mariehamn': 'FLE Standard Time',
- 'Europe/Minsk': 'Belarus Standard Time',
- 'Europe/Monaco': 'W. Europe Standard Time',
- 'Europe/Moscow': 'Russian Standard Time',
- 'Europe/Oslo': 'W. Europe Standard Time',
- 'Europe/Paris': 'Romance Standard Time',
- 'Europe/Podgorica': 'Central Europe Standard Time',
- 'Europe/Prague': 'Central Europe Standard Time',
- 'Europe/Riga': 'FLE Standard Time',
- 'Europe/Rome': 'W. Europe Standard Time',
- 'Europe/Samara': 'Russia Time Zone 3',
- 'Europe/San_Marino': 'W. Europe Standard Time',
- 'Europe/Sarajevo': 'Central European Standard Time',
- 'Europe/Saratov': 'Saratov Standard Time',
- 'Europe/Simferopol': 'Russian Standard Time',
- 'Europe/Skopje': 'Central European Standard Time',
- 'Europe/Sofia': 'FLE Standard Time',
- 'Europe/Stockholm': 'W. Europe Standard Time',
- 'Europe/Tallinn': 'FLE Standard Time',
- 'Europe/Tirane': 'Central Europe Standard Time',
- 'Europe/Tiraspol': 'E. Europe Standard Time',
- 'Europe/Ulyanovsk': 'Astrakhan Standard Time',
- 'Europe/Uzhgorod': 'FLE Standard Time',
- 'Europe/Vaduz': 'W. Europe Standard Time',
- 'Europe/Vatican': 'W. Europe Standard Time',
- 'Europe/Vienna': 'W. Europe Standard Time',
- 'Europe/Vilnius': 'FLE Standard Time',
- 'Europe/Volgograd': 'Volgograd Standard Time',
- 'Europe/Warsaw': 'Central European Standard Time',
- 'Europe/Zagreb': 'Central European Standard Time',
- 'Europe/Zaporozhye': 'FLE Standard Time',
- 'Europe/Zurich': 'W. Europe Standard Time',
- 'GB': 'GMT Standard Time',
- 'GB-Eire': 'GMT Standard Time',
- 'GMT+0': 'UTC',
- 'GMT-0': 'UTC',
- 'GMT0': 'UTC',
- 'Greenwich': 'UTC',
- 'Hongkong': 'China Standard Time',
- 'Iceland': 'Greenwich Standard Time',
- 'Indian/Antananarivo': 'E. Africa Standard Time',
- 'Indian/Chagos': 'Central Asia Standard Time',
- 'Indian/Christmas': 'SE Asia Standard Time',
- 'Indian/Cocos': 'Myanmar Standard Time',
- 'Indian/Comoro': 'E. Africa Standard Time',
- 'Indian/Kerguelen': 'West Asia Standard Time',
- 'Indian/Mahe': 'Mauritius Standard Time',
- 'Indian/Maldives': 'West Asia Standard Time',
- 'Indian/Mauritius': 'Mauritius Standard Time',
- 'Indian/Mayotte': 'E. Africa Standard Time',
- 'Indian/Reunion': 'Mauritius Standard Time',
- 'Iran': 'Iran Standard Time',
- 'Israel': 'Israel Standard Time',
- 'Jamaica': 'SA Pacific Standard Time',
- 'Japan': 'Tokyo Standard Time',
- 'Kwajalein': 'UTC+12',
- 'Libya': 'Libya Standard Time',
- 'MST7MDT': 'Mountain Standard Time',
- 'Mexico/BajaNorte': 'Pacific Standard Time (Mexico)',
- 'Mexico/BajaSur': 'Mountain Standard Time (Mexico)',
- 'Mexico/General': 'Central Standard Time (Mexico)',
- 'NZ': 'New Zealand Standard Time',
- 'NZ-CHAT': 'Chatham Islands Standard Time',
- 'Navajo': 'Mountain Standard Time',
- 'PRC': 'China Standard Time',
- 'PST8PDT': 'Pacific Standard Time',
- 'Pacific/Apia': 'Samoa Standard Time',
- 'Pacific/Auckland': 'New Zealand Standard Time',
- 'Pacific/Bougainville': 'Bougainville Standard Time',
- 'Pacific/Chatham': 'Chatham Islands Standard Time',
- 'Pacific/Easter': 'Easter Island Standard Time',
- 'Pacific/Efate': 'Central Pacific Standard Time',
- 'Pacific/Enderbury': 'UTC+13',
- 'Pacific/Fakaofo': 'UTC+13',
- 'Pacific/Fiji': 'Fiji Standard Time',
- 'Pacific/Funafuti': 'UTC+12',
- 'Pacific/Galapagos': 'Central America Standard Time',
- 'Pacific/Gambier': 'UTC-09',
- 'Pacific/Guadalcanal': 'Central Pacific Standard Time',
- 'Pacific/Guam': 'West Pacific Standard Time',
- 'Pacific/Honolulu': 'Hawaiian Standard Time',
- 'Pacific/Johnston': 'Hawaiian Standard Time',
- 'Pacific/Kiritimati': 'Line Islands Standard Time',
- 'Pacific/Kosrae': 'Central Pacific Standard Time',
- 'Pacific/Kwajalein': 'UTC+12',
- 'Pacific/Majuro': 'UTC+12',
- 'Pacific/Marquesas': 'Marquesas Standard Time',
- 'Pacific/Midway': 'UTC-11',
- 'Pacific/Nauru': 'UTC+12',
- 'Pacific/Niue': 'UTC-11',
- 'Pacific/Norfolk': 'Norfolk Standard Time',
- 'Pacific/Noumea': 'Central Pacific Standard Time',
- 'Pacific/Pago_Pago': 'UTC-11',
- 'Pacific/Palau': 'Tokyo Standard Time',
- 'Pacific/Pitcairn': 'UTC-08',
- 'Pacific/Ponape': 'Central Pacific Standard Time',
- 'Pacific/Port_Moresby': 'West Pacific Standard Time',
- 'Pacific/Rarotonga': 'Hawaiian Standard Time',
- 'Pacific/Saipan': 'West Pacific Standard Time',
- 'Pacific/Samoa': 'UTC-11',
- 'Pacific/Tahiti': 'Hawaiian Standard Time',
- 'Pacific/Tarawa': 'UTC+12',
- 'Pacific/Tongatapu': 'Tonga Standard Time',
- 'Pacific/Truk': 'West Pacific Standard Time',
- 'Pacific/Wake': 'UTC+12',
- 'Pacific/Wallis': 'UTC+12',
- 'Poland': 'Central European Standard Time',
- 'Portugal': 'GMT Standard Time',
- 'ROC': 'Taipei Standard Time',
- 'ROK': 'Korea Standard Time',
- 'Singapore': 'Singapore Standard Time',
- 'Turkey': 'Turkey Standard Time',
- 'UCT': 'UTC',
- 'US/Alaska': 'Alaskan Standard Time',
- 'US/Aleutian': 'Aleutian Standard Time',
- 'US/Arizona': 'US Mountain Standard Time',
- 'US/Central': 'Central Standard Time',
- 'US/Eastern': 'Eastern Standard Time',
- 'US/Hawaii': 'Hawaiian Standard Time',
- 'US/Indiana-Starke': 'Central Standard Time',
- 'US/Michigan': 'Eastern Standard Time',
- 'US/Mountain': 'Mountain Standard Time',
- 'US/Pacific': 'Pacific Standard Time',
- 'US/Samoa': 'UTC-11',
- 'UTC': 'UTC',
- 'Universal': 'UTC',
- 'W-SU': 'Russian Standard Time',
- 'Zulu': 'UTC'}
+tz_win = {
+    "": "Central Standard Time (Mexico)",
+    "Africa/Abidjan": "Greenwich Standard Time",
+    "Africa/Accra": "Greenwich Standard Time",
+    "Africa/Addis_Ababa": "E. Africa Standard Time",
+    "Africa/Algiers": "W. Central Africa Standard Time",
+    "Africa/Asmara": "E. Africa Standard Time",
+    "Africa/Asmera": "E. Africa Standard Time",
+    "Africa/Bamako": "Greenwich Standard Time",
+    "Africa/Bangui": "W. Central Africa Standard Time",
+    "Africa/Banjul": "Greenwich Standard Time",
+    "Africa/Bissau": "Greenwich Standard Time",
+    "Africa/Blantyre": "South Africa Standard Time",
+    "Africa/Brazzaville": "W. Central Africa Standard Time",
+    "Africa/Bujumbura": "South Africa Standard Time",
+    "Africa/Cairo": "Egypt Standard Time",
+    "Africa/Casablanca": "Morocco Standard Time",
+    "Africa/Ceuta": "Romance Standard Time",
+    "Africa/Conakry": "Greenwich Standard Time",
+    "Africa/Dakar": "Greenwich Standard Time",
+    "Africa/Dar_es_Salaam": "E. Africa Standard Time",
+    "Africa/Djibouti": "E. Africa Standard Time",
+    "Africa/Douala": "W. Central Africa Standard Time",
+    "Africa/El_Aaiun": "Morocco Standard Time",
+    "Africa/Freetown": "Greenwich Standard Time",
+    "Africa/Gaborone": "South Africa Standard Time",
+    "Africa/Harare": "South Africa Standard Time",
+    "Africa/Johannesburg": "South Africa Standard Time",
+    "Africa/Juba": "South Sudan Standard Time",
+    "Africa/Kampala": "E. Africa Standard Time",
+    "Africa/Khartoum": "Sudan Standard Time",
+    "Africa/Kigali": "South Africa Standard Time",
+    "Africa/Kinshasa": "W. Central Africa Standard Time",
+    "Africa/Lagos": "W. Central Africa Standard Time",
+    "Africa/Libreville": "W. Central Africa Standard Time",
+    "Africa/Lome": "Greenwich Standard Time",
+    "Africa/Luanda": "W. Central Africa Standard Time",
+    "Africa/Lubumbashi": "South Africa Standard Time",
+    "Africa/Lusaka": "South Africa Standard Time",
+    "Africa/Malabo": "W. Central Africa Standard Time",
+    "Africa/Maputo": "South Africa Standard Time",
+    "Africa/Maseru": "South Africa Standard Time",
+    "Africa/Mbabane": "South Africa Standard Time",
+    "Africa/Mogadishu": "E. Africa Standard Time",
+    "Africa/Monrovia": "Greenwich Standard Time",
+    "Africa/Nairobi": "E. Africa Standard Time",
+    "Africa/Ndjamena": "W. Central Africa Standard Time",
+    "Africa/Niamey": "W. Central Africa Standard Time",
+    "Africa/Nouakchott": "Greenwich Standard Time",
+    "Africa/Ouagadougou": "Greenwich Standard Time",
+    "Africa/Porto-Novo": "W. Central Africa Standard Time",
+    "Africa/Sao_Tome": "Sao Tome Standard Time",
+    "Africa/Timbuktu": "Greenwich Standard Time",
+    "Africa/Tripoli": "Libya Standard Time",
+    "Africa/Tunis": "W. Central Africa Standard Time",
+    "Africa/Windhoek": "Namibia Standard Time",
+    "America/Adak": "Aleutian Standard Time",
+    "America/Anchorage": "Alaskan Standard Time",
+    "America/Anguilla": "SA Western Standard Time",
+    "America/Antigua": "SA Western Standard Time",
+    "America/Araguaina": "Tocantins Standard Time",
+    "America/Argentina/La_Rioja": "Argentina Standard Time",
+    "America/Argentina/Rio_Gallegos": "Argentina Standard Time",
+    "America/Argentina/Salta": "Argentina Standard Time",
+    "America/Argentina/San_Juan": "Argentina Standard Time",
+    "America/Argentina/San_Luis": "Argentina Standard Time",
+    "America/Argentina/Tucuman": "Argentina Standard Time",
+    "America/Argentina/Ushuaia": "Argentina Standard Time",
+    "America/Aruba": "SA Western Standard Time",
+    "America/Asuncion": "Paraguay Standard Time",
+    "America/Atikokan": "SA Pacific Standard Time",
+    "America/Atka": "Aleutian Standard Time",
+    "America/Bahia": "Bahia Standard Time",
+    "America/Bahia_Banderas": "Central Standard Time (Mexico)",
+    "America/Barbados": "SA Western Standard Time",
+    "America/Belem": "SA Eastern Standard Time",
+    "America/Belize": "Central America Standard Time",
+    "America/Blanc-Sablon": "SA Western Standard Time",
+    "America/Boa_Vista": "SA Western Standard Time",
+    "America/Bogota": "SA Pacific Standard Time",
+    "America/Boise": "Mountain Standard Time",
+    "America/Buenos_Aires": "Argentina Standard Time",
+    "America/Cambridge_Bay": "Mountain Standard Time",
+    "America/Campo_Grande": "Central Brazilian Standard Time",
+    "America/Cancun": "Eastern Standard Time (Mexico)",
+    "America/Caracas": "Venezuela Standard Time",
+    "America/Catamarca": "Argentina Standard Time",
+    "America/Cayenne": "SA Eastern Standard Time",
+    "America/Cayman": "SA Pacific Standard Time",
+    "America/Chicago": "Central Standard Time",
+    "America/Chihuahua": "Central Standard Time (Mexico)",
+    "America/Ciudad_Juarez": "Mountain Standard Time",
+    "America/Coral_Harbour": "SA Pacific Standard Time",
+    "America/Cordoba": "Argentina Standard Time",
+    "America/Costa_Rica": "Central America Standard Time",
+    "America/Creston": "US Mountain Standard Time",
+    "America/Cuiaba": "Central Brazilian Standard Time",
+    "America/Curacao": "SA Western Standard Time",
+    "America/Danmarkshavn": "Greenwich Standard Time",
+    "America/Dawson": "Yukon Standard Time",
+    "America/Dawson_Creek": "US Mountain Standard Time",
+    "America/Denver": "Mountain Standard Time",
+    "America/Detroit": "Eastern Standard Time",
+    "America/Dominica": "SA Western Standard Time",
+    "America/Edmonton": "Mountain Standard Time",
+    "America/Eirunepe": "SA Pacific Standard Time",
+    "America/El_Salvador": "Central America Standard Time",
+    "America/Ensenada": "Pacific Standard Time (Mexico)",
+    "America/Fort_Nelson": "US Mountain Standard Time",
+    "America/Fortaleza": "SA Eastern Standard Time",
+    "America/Glace_Bay": "Atlantic Standard Time",
+    "America/Godthab": "Greenland Standard Time",
+    "America/Goose_Bay": "Atlantic Standard Time",
+    "America/Grand_Turk": "Turks And Caicos Standard Time",
+    "America/Grenada": "SA Western Standard Time",
+    "America/Guadeloupe": "SA Western Standard Time",
+    "America/Guatemala": "Central America Standard Time",
+    "America/Guayaquil": "SA Pacific Standard Time",
+    "America/Guyana": "SA Western Standard Time",
+    "America/Halifax": "Atlantic Standard Time",
+    "America/Havana": "Cuba Standard Time",
+    "America/Hermosillo": "US Mountain Standard Time",
+    "America/Indiana/Knox": "Central Standard Time",
+    "America/Indiana/Marengo": "US Eastern Standard Time",
+    "America/Indiana/Petersburg": "Eastern Standard Time",
+    "America/Indiana/Tell_City": "Central Standard Time",
+    "America/Indiana/Vevay": "US Eastern Standard Time",
+    "America/Indiana/Vincennes": "Eastern Standard Time",
+    "America/Indiana/Winamac": "Eastern Standard Time",
+    "America/Indianapolis": "US Eastern Standard Time",
+    "America/Inuvik": "Mountain Standard Time",
+    "America/Iqaluit": "Eastern Standard Time",
+    "America/Jamaica": "SA Pacific Standard Time",
+    "America/Jujuy": "Argentina Standard Time",
+    "America/Juneau": "Alaskan Standard Time",
+    "America/Kentucky/Monticello": "Eastern Standard Time",
+    "America/Knox_IN": "Central Standard Time",
+    "America/Kralendijk": "SA Western Standard Time",
+    "America/La_Paz": "SA Western Standard Time",
+    "America/Lima": "SA Pacific Standard Time",
+    "America/Los_Angeles": "Pacific Standard Time",
+    "America/Louisville": "Eastern Standard Time",
+    "America/Lower_Princes": "SA Western Standard Time",
+    "America/Maceio": "SA Eastern Standard Time",
+    "America/Managua": "Central America Standard Time",
+    "America/Manaus": "SA Western Standard Time",
+    "America/Marigot": "SA Western Standard Time",
+    "America/Martinique": "SA Western Standard Time",
+    "America/Matamoros": "Central Standard Time",
+    "America/Mazatlan": "Mountain Standard Time (Mexico)",
+    "America/Mendoza": "Argentina Standard Time",
+    "America/Menominee": "Central Standard Time",
+    "America/Merida": "Central Standard Time (Mexico)",
+    "America/Metlakatla": "Alaskan Standard Time",
+    "America/Mexico_City": "Central Standard Time (Mexico)",
+    "America/Miquelon": "Saint Pierre Standard Time",
+    "America/Moncton": "Atlantic Standard Time",
+    "America/Monterrey": "Central Standard Time (Mexico)",
+    "America/Montevideo": "Montevideo Standard Time",
+    "America/Montreal": "Eastern Standard Time",
+    "America/Montserrat": "SA Western Standard Time",
+    "America/Nassau": "Eastern Standard Time",
+    "America/New_York": "Eastern Standard Time",
+    "America/Nipigon": "Eastern Standard Time",
+    "America/Nome": "Alaskan Standard Time",
+    "America/Noronha": "UTC-02",
+    "America/North_Dakota/Beulah": "Central Standard Time",
+    "America/North_Dakota/Center": "Central Standard Time",
+    "America/North_Dakota/New_Salem": "Central Standard Time",
+    "America/Ojinaga": "Central Standard Time",
+    "America/Panama": "SA Pacific Standard Time",
+    "America/Pangnirtung": "Eastern Standard Time",
+    "America/Paramaribo": "SA Eastern Standard Time",
+    "America/Phoenix": "US Mountain Standard Time",
+    "America/Port-au-Prince": "Haiti Standard Time",
+    "America/Port_of_Spain": "SA Western Standard Time",
+    "America/Porto_Acre": "SA Pacific Standard Time",
+    "America/Porto_Velho": "SA Western Standard Time",
+    "America/Puerto_Rico": "SA Western Standard Time",
+    "America/Punta_Arenas": "Magallanes Standard Time",
+    "America/Rainy_River": "Central Standard Time",
+    "America/Rankin_Inlet": "Central Standard Time",
+    "America/Recife": "SA Eastern Standard Time",
+    "America/Regina": "Canada Central Standard Time",
+    "America/Resolute": "Central Standard Time",
+    "America/Rio_Branco": "SA Pacific Standard Time",
+    "America/Santa_Isabel": "Pacific Standard Time (Mexico)",
+    "America/Santarem": "SA Eastern Standard Time",
+    "America/Santiago": "Pacific SA Standard Time",
+    "America/Santo_Domingo": "SA Western Standard Time",
+    "America/Sao_Paulo": "E. South America Standard Time",
+    "America/Scoresbysund": "Azores Standard Time",
+    "America/Shiprock": "Mountain Standard Time",
+    "America/Sitka": "Alaskan Standard Time",
+    "America/St_Barthelemy": "SA Western Standard Time",
+    "America/St_Johns": "Newfoundland Standard Time",
+    "America/St_Kitts": "SA Western Standard Time",
+    "America/St_Lucia": "SA Western Standard Time",
+    "America/St_Thomas": "SA Western Standard Time",
+    "America/St_Vincent": "SA Western Standard Time",
+    "America/Swift_Current": "Canada Central Standard Time",
+    "America/Tegucigalpa": "Central America Standard Time",
+    "America/Thule": "Atlantic Standard Time",
+    "America/Thunder_Bay": "Eastern Standard Time",
+    "America/Tijuana": "Pacific Standard Time (Mexico)",
+    "America/Toronto": "Eastern Standard Time",
+    "America/Tortola": "SA Western Standard Time",
+    "America/Vancouver": "Pacific Standard Time",
+    "America/Virgin": "SA Western Standard Time",
+    "America/Whitehorse": "Yukon Standard Time",
+    "America/Winnipeg": "Central Standard Time",
+    "America/Yakutat": "Alaskan Standard Time",
+    "America/Yellowknife": "Mountain Standard Time",
+    "Antarctica/Casey": "Central Pacific Standard Time",
+    "Antarctica/Davis": "SE Asia Standard Time",
+    "Antarctica/DumontDUrville": "West Pacific Standard Time",
+    "Antarctica/Macquarie": "Tasmania Standard Time",
+    "Antarctica/Mawson": "West Asia Standard Time",
+    "Antarctica/McMurdo": "New Zealand Standard Time",
+    "Antarctica/Palmer": "SA Eastern Standard Time",
+    "Antarctica/Rothera": "SA Eastern Standard Time",
+    "Antarctica/South_Pole": "New Zealand Standard Time",
+    "Antarctica/Syowa": "Arab Standard Time",
+    "Antarctica/Vostok": "Central Asia Standard Time",
+    "Arctic/Longyearbyen": "W. Europe Standard Time",
+    "Asia/Aden": "Arab Standard Time",
+    "Asia/Almaty": "Central Asia Standard Time",
+    "Asia/Amman": "Jordan Standard Time",
+    "Asia/Anadyr": "Russia Time Zone 11",
+    "Asia/Aqtau": "West Asia Standard Time",
+    "Asia/Aqtobe": "West Asia Standard Time",
+    "Asia/Ashgabat": "West Asia Standard Time",
+    "Asia/Ashkhabad": "West Asia Standard Time",
+    "Asia/Atyrau": "West Asia Standard Time",
+    "Asia/Baghdad": "Arabic Standard Time",
+    "Asia/Bahrain": "Arab Standard Time",
+    "Asia/Baku": "Azerbaijan Standard Time",
+    "Asia/Bangkok": "SE Asia Standard Time",
+    "Asia/Barnaul": "Altai Standard Time",
+    "Asia/Beirut": "Middle East Standard Time",
+    "Asia/Bishkek": "Central Asia Standard Time",
+    "Asia/Brunei": "Singapore Standard Time",
+    "Asia/Calcutta": "India Standard Time",
+    "Asia/Chita": "Transbaikal Standard Time",
+    "Asia/Choibalsan": "Ulaanbaatar Standard Time",
+    "Asia/Chongqing": "China Standard Time",
+    "Asia/Chungking": "China Standard Time",
+    "Asia/Colombo": "Sri Lanka Standard Time",
+    "Asia/Dacca": "Bangladesh Standard Time",
+    "Asia/Damascus": "Syria Standard Time",
+    "Asia/Dhaka": "Bangladesh Standard Time",
+    "Asia/Dili": "Tokyo Standard Time",
+    "Asia/Dubai": "Arabian Standard Time",
+    "Asia/Dushanbe": "West Asia Standard Time",
+    "Asia/Famagusta": "GTB Standard Time",
+    "Asia/Gaza": "West Bank Standard Time",
+    "Asia/Harbin": "China Standard Time",
+    "Asia/Hebron": "West Bank Standard Time",
+    "Asia/Hong_Kong": "China Standard Time",
+    "Asia/Hovd": "W. Mongolia Standard Time",
+    "Asia/Irkutsk": "North Asia East Standard Time",
+    "Asia/Istanbul": "Turkey Standard Time",
+    "Asia/Jakarta": "SE Asia Standard Time",
+    "Asia/Jayapura": "Tokyo Standard Time",
+    "Asia/Jerusalem": "Israel Standard Time",
+    "Asia/Kabul": "Afghanistan Standard Time",
+    "Asia/Kamchatka": "Russia Time Zone 11",
+    "Asia/Karachi": "Pakistan Standard Time",
+    "Asia/Kashgar": "Central Asia Standard Time",
+    "Asia/Katmandu": "Nepal Standard Time",
+    "Asia/Khandyga": "Yakutsk Standard Time",
+    "Asia/Krasnoyarsk": "North Asia Standard Time",
+    "Asia/Kuala_Lumpur": "Singapore Standard Time",
+    "Asia/Kuching": "Singapore Standard Time",
+    "Asia/Kuwait": "Arab Standard Time",
+    "Asia/Macao": "China Standard Time",
+    "Asia/Macau": "China Standard Time",
+    "Asia/Magadan": "Magadan Standard Time",
+    "Asia/Makassar": "Singapore Standard Time",
+    "Asia/Manila": "Singapore Standard Time",
+    "Asia/Muscat": "Arabian Standard Time",
+    "Asia/Nicosia": "GTB Standard Time",
+    "Asia/Novokuznetsk": "North Asia Standard Time",
+    "Asia/Novosibirsk": "N. Central Asia Standard Time",
+    "Asia/Omsk": "Omsk Standard Time",
+    "Asia/Oral": "West Asia Standard Time",
+    "Asia/Phnom_Penh": "SE Asia Standard Time",
+    "Asia/Pontianak": "SE Asia Standard Time",
+    "Asia/Pyongyang": "North Korea Standard Time",
+    "Asia/Qatar": "Arab Standard Time",
+    "Asia/Qostanay": "Central Asia Standard Time",
+    "Asia/Qyzylorda": "Qyzylorda Standard Time",
+    "Asia/Rangoon": "Myanmar Standard Time",
+    "Asia/Riyadh": "Arab Standard Time",
+    "Asia/Saigon": "SE Asia Standard Time",
+    "Asia/Sakhalin": "Sakhalin Standard Time",
+    "Asia/Samarkand": "West Asia Standard Time",
+    "Asia/Seoul": "Korea Standard Time",
+    "Asia/Shanghai": "China Standard Time",
+    "Asia/Singapore": "Singapore Standard Time",
+    "Asia/Srednekolymsk": "Russia Time Zone 10",
+    "Asia/Taipei": "Taipei Standard Time",
+    "Asia/Tashkent": "West Asia Standard Time",
+    "Asia/Tbilisi": "Georgian Standard Time",
+    "Asia/Tehran": "Iran Standard Time",
+    "Asia/Tel_Aviv": "Israel Standard Time",
+    "Asia/Thimbu": "Bangladesh Standard Time",
+    "Asia/Thimphu": "Bangladesh Standard Time",
+    "Asia/Tokyo": "Tokyo Standard Time",
+    "Asia/Tomsk": "Tomsk Standard Time",
+    "Asia/Ujung_Pandang": "Singapore Standard Time",
+    "Asia/Ulaanbaatar": "Ulaanbaatar Standard Time",
+    "Asia/Ulan_Bator": "Ulaanbaatar Standard Time",
+    "Asia/Urumqi": "Central Asia Standard Time",
+    "Asia/Ust-Nera": "Vladivostok Standard Time",
+    "Asia/Vientiane": "SE Asia Standard Time",
+    "Asia/Vladivostok": "Vladivostok Standard Time",
+    "Asia/Yakutsk": "Yakutsk Standard Time",
+    "Asia/Yekaterinburg": "Ekaterinburg Standard Time",
+    "Asia/Yerevan": "Caucasus Standard Time",
+    "Atlantic/Azores": "Azores Standard Time",
+    "Atlantic/Bermuda": "Atlantic Standard Time",
+    "Atlantic/Canary": "GMT Standard Time",
+    "Atlantic/Cape_Verde": "Cape Verde Standard Time",
+    "Atlantic/Faeroe": "GMT Standard Time",
+    "Atlantic/Jan_Mayen": "W. Europe Standard Time",
+    "Atlantic/Madeira": "GMT Standard Time",
+    "Atlantic/Reykjavik": "Greenwich Standard Time",
+    "Atlantic/South_Georgia": "UTC-02",
+    "Atlantic/St_Helena": "Greenwich Standard Time",
+    "Atlantic/Stanley": "SA Eastern Standard Time",
+    "Australia/ACT": "AUS Eastern Standard Time",
+    "Australia/Adelaide": "Cen. Australia Standard Time",
+    "Australia/Brisbane": "E. Australia Standard Time",
+    "Australia/Broken_Hill": "Cen. Australia Standard Time",
+    "Australia/Canberra": "AUS Eastern Standard Time",
+    "Australia/Currie": "Tasmania Standard Time",
+    "Australia/Darwin": "AUS Central Standard Time",
+    "Australia/Eucla": "Aus Central W. Standard Time",
+    "Australia/Hobart": "Tasmania Standard Time",
+    "Australia/LHI": "Lord Howe Standard Time",
+    "Australia/Lindeman": "E. Australia Standard Time",
+    "Australia/Lord_Howe": "Lord Howe Standard Time",
+    "Australia/Melbourne": "AUS Eastern Standard Time",
+    "Australia/NSW": "AUS Eastern Standard Time",
+    "Australia/North": "AUS Central Standard Time",
+    "Australia/Perth": "W. Australia Standard Time",
+    "Australia/Queensland": "E. Australia Standard Time",
+    "Australia/South": "Cen. Australia Standard Time",
+    "Australia/Sydney": "AUS Eastern Standard Time",
+    "Australia/Tasmania": "Tasmania Standard Time",
+    "Australia/Victoria": "AUS Eastern Standard Time",
+    "Australia/West": "W. Australia Standard Time",
+    "Australia/Yancowinna": "Cen. Australia Standard Time",
+    "Brazil/Acre": "SA Pacific Standard Time",
+    "Brazil/DeNoronha": "UTC-02",
+    "Brazil/East": "E. South America Standard Time",
+    "Brazil/West": "SA Western Standard Time",
+    "CST6CDT": "Central Standard Time",
+    "Canada/Atlantic": "Atlantic Standard Time",
+    "Canada/Central": "Central Standard Time",
+    "Canada/Eastern": "Eastern Standard Time",
+    "Canada/Mountain": "Mountain Standard Time",
+    "Canada/Newfoundland": "Newfoundland Standard Time",
+    "Canada/Pacific": "Pacific Standard Time",
+    "Canada/Saskatchewan": "Canada Central Standard Time",
+    "Canada/Yukon": "Yukon Standard Time",
+    "Chile/Continental": "Pacific SA Standard Time",
+    "Chile/EasterIsland": "Easter Island Standard Time",
+    "Cuba": "Cuba Standard Time",
+    "EST5EDT": "Eastern Standard Time",
+    "Egypt": "Egypt Standard Time",
+    "Eire": "GMT Standard Time",
+    "Etc/GMT": "UTC",
+    "Etc/GMT+0": "UTC",
+    "Etc/GMT+1": "Cape Verde Standard Time",
+    "Etc/GMT+10": "Hawaiian Standard Time",
+    "Etc/GMT+11": "UTC-11",
+    "Etc/GMT+12": "Dateline Standard Time",
+    "Etc/GMT+2": "UTC-02",
+    "Etc/GMT+3": "SA Eastern Standard Time",
+    "Etc/GMT+4": "SA Western Standard Time",
+    "Etc/GMT+5": "SA Pacific Standard Time",
+    "Etc/GMT+6": "Central America Standard Time",
+    "Etc/GMT+7": "US Mountain Standard Time",
+    "Etc/GMT+8": "UTC-08",
+    "Etc/GMT+9": "UTC-09",
+    "Etc/GMT-0": "UTC",
+    "Etc/GMT-1": "W. Central Africa Standard Time",
+    "Etc/GMT-10": "West Pacific Standard Time",
+    "Etc/GMT-11": "Central Pacific Standard Time",
+    "Etc/GMT-12": "UTC+12",
+    "Etc/GMT-13": "UTC+13",
+    "Etc/GMT-14": "Line Islands Standard Time",
+    "Etc/GMT-2": "South Africa Standard Time",
+    "Etc/GMT-3": "E. Africa Standard Time",
+    "Etc/GMT-4": "Arabian Standard Time",
+    "Etc/GMT-5": "West Asia Standard Time",
+    "Etc/GMT-6": "Central Asia Standard Time",
+    "Etc/GMT-7": "SE Asia Standard Time",
+    "Etc/GMT-8": "Singapore Standard Time",
+    "Etc/GMT-9": "Tokyo Standard Time",
+    "Etc/GMT0": "UTC",
+    "Etc/Greenwich": "UTC",
+    "Etc/UCT": "UTC",
+    "Etc/UTC": "UTC",
+    "Etc/Universal": "UTC",
+    "Etc/Zulu": "UTC",
+    "Europe/Amsterdam": "Romance Standard Time",
+    "Europe/Andorra": "W. Europe Standard Time",
+    "Europe/Astrakhan": "Astrakhan Standard Time",
+    "Europe/Athens": "GTB Standard Time",
+    "Europe/Belfast": "GMT Standard Time",
+    "Europe/Belgrade": "Central Europe Standard Time",
+    "Europe/Berlin": "W. Europe Standard Time",
+    "Europe/Bratislava": "Central Europe Standard Time",
+    "Europe/Brussels": "Romance Standard Time",
+    "Europe/Bucharest": "GTB Standard Time",
+    "Europe/Budapest": "Central Europe Standard Time",
+    "Europe/Busingen": "W. Europe Standard Time",
+    "Europe/Chisinau": "E. Europe Standard Time",
+    "Europe/Copenhagen": "W. Europe Standard Time",
+    "Europe/Dublin": "GMT Standard Time",
+    "Europe/Gibraltar": "W. Europe Standard Time",
+    "Europe/Guernsey": "GMT Standard Time",
+    "Europe/Helsinki": "FLE Standard Time",
+    "Europe/Isle_of_Man": "GMT Standard Time",
+    "Europe/Istanbul": "Turkey Standard Time",
+    "Europe/Jersey": "GMT Standard Time",
+    "Europe/Kaliningrad": "Kaliningrad Standard Time",
+    "Europe/Kiev": "FLE Standard Time",
+    "Europe/Kirov": "Russian Standard Time",
+    "Europe/Lisbon": "GMT Standard Time",
+    "Europe/Ljubljana": "Central Europe Standard Time",
+    "Europe/London": "GMT Standard Time",
+    "Europe/Luxembourg": "Romance Standard Time",
+    "Europe/Madrid": "Romance Standard Time",
+    "Europe/Malta": "W. Europe Standard Time",
+    "Europe/Mariehamn": "FLE Standard Time",
+    "Europe/Minsk": "Belarus Standard Time",
+    "Europe/Monaco": "Romance Standard Time",
+    "Europe/Moscow": "Russian Standard Time",
+    "Europe/Nicosia": "GTB Standard Time",
+    "Europe/Oslo": "W. Europe Standard Time",
+    "Europe/Paris": "Romance Standard Time",
+    "Europe/Podgorica": "Central Europe Standard Time",
+    "Europe/Prague": "Central Europe Standard Time",
+    "Europe/Riga": "FLE Standard Time",
+    "Europe/Rome": "W. Europe Standard Time",
+    "Europe/Samara": "Russia Time Zone 3",
+    "Europe/San_Marino": "W. Europe Standard Time",
+    "Europe/Sarajevo": "Central Europe Standard Time",
+    "Europe/Saratov": "Saratov Standard Time",
+    "Europe/Simferopol": "Russian Standard Time",
+    "Europe/Skopje": "Central Europe Standard Time",
+    "Europe/Sofia": "FLE Standard Time",
+    "Europe/Stockholm": "W. Europe Standard Time",
+    "Europe/Tallinn": "FLE Standard Time",
+    "Europe/Tirane": "Central Europe Standard Time",
+    "Europe/Tiraspol": "E. Europe Standard Time",
+    "Europe/Ulyanovsk": "Astrakhan Standard Time",
+    "Europe/Uzhgorod": "FLE Standard Time",
+    "Europe/Vaduz": "W. Europe Standard Time",
+    "Europe/Vatican": "W. Europe Standard Time",
+    "Europe/Vienna": "W. Europe Standard Time",
+    "Europe/Vilnius": "FLE Standard Time",
+    "Europe/Volgograd": "Volgograd Standard Time",
+    "Europe/Warsaw": "Central European Standard Time",
+    "Europe/Zagreb": "Central Europe Standard Time",
+    "Europe/Zaporozhye": "FLE Standard Time",
+    "Europe/Zurich": "W. Europe Standard Time",
+    "GB": "GMT Standard Time",
+    "GB-Eire": "GMT Standard Time",
+    "GMT+0": "UTC",
+    "GMT-0": "UTC",
+    "GMT0": "UTC",
+    "Greenwich": "UTC",
+    "Hongkong": "China Standard Time",
+    "Iceland": "Greenwich Standard Time",
+    "Indian/Antananarivo": "E. Africa Standard Time",
+    "Indian/Chagos": "Central Asia Standard Time",
+    "Indian/Christmas": "SE Asia Standard Time",
+    "Indian/Cocos": "Myanmar Standard Time",
+    "Indian/Comoro": "E. Africa Standard Time",
+    "Indian/Kerguelen": "West Asia Standard Time",
+    "Indian/Mahe": "Arabian Standard Time",
+    "Indian/Maldives": "West Asia Standard Time",
+    "Indian/Mauritius": "Mauritius Standard Time",
+    "Indian/Mayotte": "E. Africa Standard Time",
+    "Indian/Reunion": "Arabian Standard Time",
+    "Iran": "Iran Standard Time",
+    "Israel": "Israel Standard Time",
+    "Jamaica": "SA Pacific Standard Time",
+    "Japan": "Tokyo Standard Time",
+    "Kwajalein": "UTC+12",
+    "Libya": "Libya Standard Time",
+    "MST7MDT": "Mountain Standard Time",
+    "Mexico/BajaNorte": "Pacific Standard Time (Mexico)",
+    "Mexico/BajaSur": "Mountain Standard Time (Mexico)",
+    "Mexico/General": "Central Standard Time (Mexico)",
+    "NZ": "New Zealand Standard Time",
+    "NZ-CHAT": "Chatham Islands Standard Time",
+    "Navajo": "Mountain Standard Time",
+    "PRC": "China Standard Time",
+    "PST8PDT": "Pacific Standard Time",
+    "Pacific/Apia": "Samoa Standard Time",
+    "Pacific/Auckland": "New Zealand Standard Time",
+    "Pacific/Bougainville": "Bougainville Standard Time",
+    "Pacific/Chatham": "Chatham Islands Standard Time",
+    "Pacific/Chuuk": "West Pacific Standard Time",
+    "Pacific/Easter": "Easter Island Standard Time",
+    "Pacific/Efate": "Central Pacific Standard Time",
+    "Pacific/Enderbury": "UTC+13",
+    "Pacific/Fakaofo": "UTC+13",
+    "Pacific/Fiji": "Fiji Standard Time",
+    "Pacific/Funafuti": "UTC+12",
+    "Pacific/Galapagos": "Central America Standard Time",
+    "Pacific/Gambier": "UTC-09",
+    "Pacific/Guadalcanal": "Central Pacific Standard Time",
+    "Pacific/Guam": "West Pacific Standard Time",
+    "Pacific/Honolulu": "Hawaiian Standard Time",
+    "Pacific/Johnston": "Hawaiian Standard Time",
+    "Pacific/Kiritimati": "Line Islands Standard Time",
+    "Pacific/Kosrae": "Central Pacific Standard Time",
+    "Pacific/Kwajalein": "UTC+12",
+    "Pacific/Majuro": "UTC+12",
+    "Pacific/Marquesas": "Marquesas Standard Time",
+    "Pacific/Midway": "UTC-11",
+    "Pacific/Nauru": "UTC+12",
+    "Pacific/Niue": "UTC-11",
+    "Pacific/Norfolk": "Norfolk Standard Time",
+    "Pacific/Noumea": "Central Pacific Standard Time",
+    "Pacific/Pago_Pago": "UTC-11",
+    "Pacific/Palau": "Tokyo Standard Time",
+    "Pacific/Pitcairn": "UTC-08",
+    "Pacific/Pohnpei": "Central Pacific Standard Time",
+    "Pacific/Ponape": "Central Pacific Standard Time",
+    "Pacific/Port_Moresby": "West Pacific Standard Time",
+    "Pacific/Rarotonga": "Hawaiian Standard Time",
+    "Pacific/Saipan": "West Pacific Standard Time",
+    "Pacific/Samoa": "UTC-11",
+    "Pacific/Tahiti": "Hawaiian Standard Time",
+    "Pacific/Tarawa": "UTC+12",
+    "Pacific/Tongatapu": "Tonga Standard Time",
+    "Pacific/Truk": "West Pacific Standard Time",
+    "Pacific/Wake": "UTC+12",
+    "Pacific/Wallis": "UTC+12",
+    "Pacific/Yap": "West Pacific Standard Time",
+    "Poland": "Central European Standard Time",
+    "Portugal": "GMT Standard Time",
+    "ROC": "Taipei Standard Time",
+    "ROK": "Korea Standard Time",
+    "Singapore": "Singapore Standard Time",
+    "Turkey": "Turkey Standard Time",
+    "UCT": "UTC",
+    "US/Alaska": "Alaskan Standard Time",
+    "US/Aleutian": "Aleutian Standard Time",
+    "US/Arizona": "US Mountain Standard Time",
+    "US/Central": "Central Standard Time",
+    "US/Eastern": "Eastern Standard Time",
+    "US/Hawaii": "Hawaiian Standard Time",
+    "US/Indiana-Starke": "Central Standard Time",
+    "US/Michigan": "Eastern Standard Time",
+    "US/Mountain": "Mountain Standard Time",
+    "US/Pacific": "Pacific Standard Time",
+    "US/Samoa": "UTC-11",
+    "UTC": "UTC",
+    "Universal": "UTC",
+    "W-SU": "Russian Standard Time",
+    "Zulu": "UTC",
+}
diff --git a/requirements.txt b/requirements.txt
index 56927154..8ca67fe6 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -44,7 +44,7 @@ six==1.16.0
 tempora==5.5.0
 tokenize-rt==5.2.0
 tzdata==2023.3
-tzlocal==4.2
+tzlocal==5.0.1
 urllib3<2
 webencodings==0.5.1
 websocket-client==1.6.2

From 6d858367a4367e204f1cc02467c99546a5d8bc23 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 25 Aug 2023 11:49:55 -0700
Subject: [PATCH 458/743] v2.13.1

---
 CHANGELOG.md      | 7 +++++++
 plexpy/version.py | 2 +-
 2 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index a7655ed1..1266e43f 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,12 @@
 # Changelog
 
+## v2.13.1 (2023-08-25)
+* Notes:
+  * Support for Python 3.7 has been dropped. The minimum Python version is now 3.8.
+* Other:
+  * Fix: Tautulli failing to start on some systems.
+
+
 ## v2.13.0 (2023-08-25)
 
 * Notes:
diff --git a/plexpy/version.py b/plexpy/version.py
index 398d8ecb..c5ee1521 100644
--- a/plexpy/version.py
+++ b/plexpy/version.py
@@ -18,4 +18,4 @@
 from __future__ import unicode_literals
 
 PLEXPY_BRANCH = "master"
-PLEXPY_RELEASE_VERSION = "v2.13.0"
\ No newline at end of file
+PLEXPY_RELEASE_VERSION = "v2.13.1"
\ No newline at end of file

From aaea924aaaf9501e70b2277dd0b073cc2cc75e41 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 18 Sep 2023 12:57:18 -0700
Subject: [PATCH 459/743] Bump actions/checkout from 3 to 4 (#2145)

Bumps [actions/checkout](https://github.com/actions/checkout) from 3 to 4.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v3...v4)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 .github/workflows/codeql.yml             | 2 +-
 .github/workflows/publish-docker.yml     | 2 +-
 .github/workflows/publish-installers.yml | 4 ++--
 .github/workflows/publish-snap.yml       | 2 +-
 .github/workflows/pull-requests.yml      | 2 +-
 5 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/.github/workflows/codeql.yml b/.github/workflows/codeql.yml
index e914485d..f9593d5a 100644
--- a/.github/workflows/codeql.yml
+++ b/.github/workflows/codeql.yml
@@ -24,7 +24,7 @@ jobs:
 
     steps:
     - name: Checkout Code
-      uses: actions/checkout@v3
+      uses: actions/checkout@v4
 
     - name: Initialize CodeQL
       uses: github/codeql-action/init@v2
diff --git a/.github/workflows/publish-docker.yml b/.github/workflows/publish-docker.yml
index 6d91bbf6..80dad13c 100644
--- a/.github/workflows/publish-docker.yml
+++ b/.github/workflows/publish-docker.yml
@@ -13,7 +13,7 @@ jobs:
     if: ${{ !contains(github.event.head_commit.message, '[skip ci]') }}
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
 
       - name: Prepare
         id: prepare
diff --git a/.github/workflows/publish-installers.yml b/.github/workflows/publish-installers.yml
index 0b6eec36..0e0b1082 100644
--- a/.github/workflows/publish-installers.yml
+++ b/.github/workflows/publish-installers.yml
@@ -24,7 +24,7 @@ jobs:
 
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
 
       - name: Set Release Version
         id: get_version
@@ -103,7 +103,7 @@ jobs:
         uses: technote-space/workflow-conclusion-action@v3
 
       - name: Checkout Code
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
 
       - name: Set Release Version
         id: get_version
diff --git a/.github/workflows/publish-snap.yml b/.github/workflows/publish-snap.yml
index dd74c3a3..30ee799b 100644
--- a/.github/workflows/publish-snap.yml
+++ b/.github/workflows/publish-snap.yml
@@ -20,7 +20,7 @@ jobs:
           - armhf
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
 
       - name: Prepare
         id: prepare
diff --git a/.github/workflows/pull-requests.yml b/.github/workflows/pull-requests.yml
index 1a24cf24..ac550fe2 100644
--- a/.github/workflows/pull-requests.yml
+++ b/.github/workflows/pull-requests.yml
@@ -10,7 +10,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
 
       - name: Comment on Pull Request
         uses: mshick/add-pr-comment@v2

From 26419f4610e0633498efe0a8229eab061e5eadf5 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 18 Sep 2023 12:57:32 -0700
Subject: [PATCH 460/743] Bump docker/login-action from 2 to 3 (#2149)

Bumps [docker/login-action](https://github.com/docker/login-action) from 2 to 3.
- [Release notes](https://github.com/docker/login-action/releases)
- [Commits](https://github.com/docker/login-action/compare/v2...v3)

---
updated-dependencies:
- dependency-name: docker/login-action
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 .github/workflows/publish-docker.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/publish-docker.yml b/.github/workflows/publish-docker.yml
index 80dad13c..789c65f6 100644
--- a/.github/workflows/publish-docker.yml
+++ b/.github/workflows/publish-docker.yml
@@ -55,14 +55,14 @@ jobs:
             ${{ runner.os }}-buildx-
 
       - name: Login to DockerHub
-        uses: docker/login-action@v2
+        uses: docker/login-action@v3
         if: success()
         with:
           username: ${{ secrets.DOCKER_USERNAME }}
           password: ${{ secrets.DOCKER_PASSWORD }}
 
       - name: Login to GitHub Container Registry
-        uses: docker/login-action@v2
+        uses: docker/login-action@v3
         if: success()
         with:
           registry: ghcr.io

From 5e75d0ce73b64076a0f65d5cfb5411c759a5bdad Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 18 Sep 2023 12:57:43 -0700
Subject: [PATCH 461/743] Bump docker/setup-qemu-action from 2 to 3 (#2150)

Bumps [docker/setup-qemu-action](https://github.com/docker/setup-qemu-action) from 2 to 3.
- [Release notes](https://github.com/docker/setup-qemu-action/releases)
- [Commits](https://github.com/docker/setup-qemu-action/compare/v2...v3)

---
updated-dependencies:
- dependency-name: docker/setup-qemu-action
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 .github/workflows/publish-docker.yml | 2 +-
 .github/workflows/publish-snap.yml   | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/publish-docker.yml b/.github/workflows/publish-docker.yml
index 789c65f6..f396bbac 100644
--- a/.github/workflows/publish-docker.yml
+++ b/.github/workflows/publish-docker.yml
@@ -38,7 +38,7 @@ jobs:
           echo "docker_image=${{ secrets.DOCKER_REPO }}/tautulli" >> $GITHUB_OUTPUT
 
       - name: Set Up QEMU
-        uses: docker/setup-qemu-action@v2
+        uses: docker/setup-qemu-action@v3
 
       - name: Set up Docker Buildx
         uses: docker/setup-buildx-action@v2
diff --git a/.github/workflows/publish-snap.yml b/.github/workflows/publish-snap.yml
index 30ee799b..e8a6be7d 100644
--- a/.github/workflows/publish-snap.yml
+++ b/.github/workflows/publish-snap.yml
@@ -35,7 +35,7 @@ jobs:
           fi
 
       - name: Set Up QEMU
-        uses: docker/setup-qemu-action@v2
+        uses: docker/setup-qemu-action@v3
 
       - name: Build Snap Package
         uses: diddlesnaps/snapcraft-multiarch-action@v1

From 76f1335a559d5dbc6e5edd505032b899dc9bb04b Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 18 Sep 2023 12:57:59 -0700
Subject: [PATCH 462/743] Bump docker/build-push-action from 4 to 5 (#2151)

Bumps [docker/build-push-action](https://github.com/docker/build-push-action) from 4 to 5.
- [Release notes](https://github.com/docker/build-push-action/releases)
- [Commits](https://github.com/docker/build-push-action/compare/v4...v5)

---
updated-dependencies:
- dependency-name: docker/build-push-action
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 .github/workflows/publish-docker.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/publish-docker.yml b/.github/workflows/publish-docker.yml
index f396bbac..feb56b68 100644
--- a/.github/workflows/publish-docker.yml
+++ b/.github/workflows/publish-docker.yml
@@ -70,7 +70,7 @@ jobs:
           password: ${{ secrets.GHCR_TOKEN }}
 
       - name: Docker Build and Push
-        uses: docker/build-push-action@v4
+        uses: docker/build-push-action@v5
         if: success()
         with:
           context: .

From 4938954c6117a00091d8f78db32d61e27a7e74a0 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 18 Sep 2023 12:59:23 -0700
Subject: [PATCH 463/743] Bump docker/setup-buildx-action from 2 to 3 (#2152)

Bumps [docker/setup-buildx-action](https://github.com/docker/setup-buildx-action) from 2 to 3.
- [Release notes](https://github.com/docker/setup-buildx-action/releases)
- [Commits](https://github.com/docker/setup-buildx-action/compare/v2...v3)

---
updated-dependencies:
- dependency-name: docker/setup-buildx-action
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 .github/workflows/publish-docker.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/publish-docker.yml b/.github/workflows/publish-docker.yml
index feb56b68..2eccdf5d 100644
--- a/.github/workflows/publish-docker.yml
+++ b/.github/workflows/publish-docker.yml
@@ -41,7 +41,7 @@ jobs:
         uses: docker/setup-qemu-action@v3
 
       - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@v2
+        uses: docker/setup-buildx-action@v3
         id: buildx
         with:
           version: latest

From 59fe34982efc0bcb6fc160fc027231ad6dc81e21 Mon Sep 17 00:00:00 2001
From: herby2212 <12448284+herby2212@users.noreply.github.com>
Date: Sat, 7 Oct 2023 22:45:11 +0200
Subject: [PATCH 464/743] Concurrent Streams per Day Graph (#2046)

* initial commit

* fix grouping in webserve

* remove event handler and adapt cursor

* optimize most concurrent calculation

* update branch from nightly and user filter

* max concurrent streams in graph

* made several changes mentioned in review
---
 data/interfaces/default/graphs.html           |  46 +++++++-
 .../concurrent_streams_by_stream_type.js      |  76 +++++++++++++
 plexpy/graphs.py                              | 104 +++++++++++++++++-
 plexpy/helpers.py                             |   6 +
 plexpy/webserve.py                            |  38 +++++++
 5 files changed, 265 insertions(+), 5 deletions(-)
 create mode 100644 data/interfaces/default/js/graphs/concurrent_streams_by_stream_type.js

diff --git a/data/interfaces/default/graphs.html b/data/interfaces/default/graphs.html
index 8435df20..8f16f59a 100644
--- a/data/interfaces/default/graphs.html
+++ b/data/interfaces/default/graphs.html
@@ -137,6 +137,20 @@
                         </div>
                     </div>
                 </div>
+                <div class="row">
+                    <div class="col-md-12">
+                        <h4><i class="fa fa-video-camera"></i> Daily concurrent stream count</span> by stream type <small>Last <span class="days">30</span> days</small></h4>
+                        <p class="help-block">
+                            The total count of concurrent streams of tv, movies, and music by the transcode decision.
+                        </p>
+                        <div class="graphs-instance">
+                            <div class="watch-chart" id="graph_concurrent_streams_by_stream_type">
+                                <div class="graphs-load"><i class="fa fa-refresh fa-spin"></i> Loading chart...</div>
+                                <br>
+                            </div>
+                        </div>
+                    </div>
+                </div>
                 <div class="row">
                     <div class="col-md-6">
                         <h4><i class="fa fa-expand-arrows-alt"></i> <span class="yaxis-text">Play count</span> by source resolution <small>Last <span class="days">30</span> days</small></h4>
@@ -312,7 +326,8 @@
             'Live TV': '#19A0D7',
             'Direct Play': '#E5A00D',
             'Direct Stream': '#FFFFFF',
-            'Transcode': '#F06464'
+            'Transcode': '#F06464',
+            'Max. Concurrent Streams': '#1014FC'
         };
         var series_colors = [];
         $.each(data_series, function(index, series) {
@@ -327,6 +342,7 @@
 <script src="${http_root}js/graphs/plays_by_platform.js${cache_param}"></script>
 <script src="${http_root}js/graphs/plays_by_user.js${cache_param}"></script>
 <script src="${http_root}js/graphs/plays_by_stream_type.js${cache_param}"></script>
+<script src="${http_root}js/graphs/concurrent_streams_by_stream_type.js${cache_param}"></script>
 <script src="${http_root}js/graphs/plays_by_source_resolution.js${cache_param}"></script>
 <script src="${http_root}js/graphs/plays_by_stream_resolution.js${cache_param}"></script>
 <script src="${http_root}js/graphs/plays_by_platform_by_stream_type.js${cache_param}"></script>
@@ -540,6 +556,33 @@
                 }
             });
 
+            $.ajax({
+                url: "get_concurrent_streams_by_stream_type",
+                type: 'get',
+                data: { time_range: time_range, user_id: selected_user_id },
+                dataType: "json",
+                success: function(data) {
+                    var dateArray = [];
+                    $.each(data.categories, function (i, day) {
+                        dateArray.push(moment(day, 'YYYY-MM-DD').valueOf());
+                        // Highlight the weekend
+                        if ((moment(day, 'YYYY-MM-DD').format('ddd') == 'Sat') ||
+                            (moment(day, 'YYYY-MM-DD').format('ddd') == 'Sun')) {
+                            hc_plays_by_day_options.xAxis.plotBands.push({
+                                from: i-0.5,
+                                to: i+0.5,
+                                color: 'rgba(80,80,80,0.3)'
+                            });
+                        }
+                    });
+                    hc_concurrent_streams_by_stream_type_options.yAxis.min = 0;
+                    hc_concurrent_streams_by_stream_type_options.xAxis.categories = dateArray;
+                    hc_concurrent_streams_by_stream_type_options.series = getGraphVisibility(hc_concurrent_streams_by_stream_type_options.chart.renderTo, data.series);
+                    hc_concurrent_streams_by_stream_type_options.colors = getGraphColors(data.series);
+                    var hc_plays_by_stream_type = new Highcharts.Chart(hc_concurrent_streams_by_stream_type_options);
+                }
+            });
+
             $.ajax({
                 url: "get_plays_by_source_resolution",
                 type: 'get',
@@ -754,6 +797,7 @@
 
             hc_plays_by_day_options.xAxis.plotBands = [];
             hc_plays_by_stream_type_options.xAxis.plotBands = [];
+            hc_concurrent_streams_by_stream_type_options.xAxis.plotBands = [];
 
             hc_plays_by_day_options.yAxis.labels.formatter = yaxis_format;
             hc_plays_by_dayofweek_options.yAxis.labels.formatter = yaxis_format;
diff --git a/data/interfaces/default/js/graphs/concurrent_streams_by_stream_type.js b/data/interfaces/default/js/graphs/concurrent_streams_by_stream_type.js
new file mode 100644
index 00000000..623e4735
--- /dev/null
+++ b/data/interfaces/default/js/graphs/concurrent_streams_by_stream_type.js
@@ -0,0 +1,76 @@
+var formatter_function = function() {
+    if (moment(this.x, 'X').isValid() && (this.x > 946684800)) {
+        var s = '<b>'+ moment(this.x).format('ddd MMM D') +'</b>';
+    } else {
+        var s = '<b>'+ this.x +'</b>';
+    }
+    $.each(this.points, function(i, point) {
+        s += '<br/>'+point.series.name+': '+point.y;
+    });
+    return s;
+};
+
+var hc_concurrent_streams_by_stream_type_options = {
+    chart: {
+        type: 'line',
+        backgroundColor: 'rgba(0,0,0,0)',
+        renderTo: 'graph_concurrent_streams_by_stream_type'
+    },
+    title: {
+        text: ''
+    },
+    legend: {
+        enabled: true,
+        itemStyle: {
+            font: '9pt "Open Sans", sans-serif',
+            color: '#A0A0A0'
+        },
+        itemHoverStyle: {
+            color: '#FFF'
+        },
+        itemHiddenStyle: {
+            color: '#444'
+        }
+    },
+    credits: {
+        enabled: false
+    },
+    plotOptions: {
+        series: {
+            events: {
+                legendItemClick: function() {
+                    setGraphVisibility(this.chart.renderTo.id, this.chart.series, this.name);
+                }
+            }
+        }
+    },
+    xAxis: {
+            type: 'datetime',
+            labels: {
+                formatter: function() {
+                    return moment(this.value).format("MMM D");
+                },
+                style: {
+                    color: '#aaa'
+                }
+            },
+            categories: [{}],
+            plotBands: []
+    },
+    yAxis: {
+            title: {
+                text: null
+            },
+            labels: {
+                style: {
+                    color: '#aaa'
+                }
+            }
+    },
+    tooltip: {
+        shared: true,
+        crosshairs: true,
+        formatter: formatter_function
+    },
+    series: [{}]
+};
\ No newline at end of file
diff --git a/plexpy/graphs.py b/plexpy/graphs.py
index 58a199c0..82db9d82 100644
--- a/plexpy/graphs.py
+++ b/plexpy/graphs.py
@@ -22,7 +22,6 @@ from future.builtins import object
 
 import arrow
 import datetime
-
 import plexpy
 if plexpy.PYTHON2:
     import common
@@ -826,6 +825,102 @@ class Graphs(object):
                   'series': [series_1_output, series_2_output, series_3_output]}
         return output
 
+    def get_total_concurrent_streams_per_stream_type(self, time_range='30', user_id=None):
+        monitor_db = database.MonitorDatabase()
+
+        time_range = helpers.cast_to_int(time_range) or 30
+        timestamp = helpers.timestamp() - time_range * 24 * 60 * 60
+
+        user_cond = self._make_user_cond(user_id, 'WHERE')
+        
+        def calc_most_concurrent(result):
+            times = []
+            for item in result:
+                times.append({'time': str(item['started']) + 'B', 'count': 1})
+                times.append({'time': str(item['stopped']) + 'A', 'count': -1})
+            times = sorted(times, key=lambda k: k['time'])
+
+            count = 0
+            final_count = 0
+            last_count = 0
+
+            for d in times:
+                if d['count'] == 1:
+                    count += d['count']
+                else:
+                    if count >= last_count:
+                        last_count = count
+                        final_count = count
+                    count += d['count']
+
+            return final_count
+
+        try:
+            query = 'SELECT sh.date_played, sh.started, sh.stopped, shmi.transcode_decision ' \
+                    'FROM (SELECT *, ' \
+                        'date(started, "unixepoch", "localtime") AS date_played ' \
+                        'FROM session_history %s) AS sh ' \
+                    'JOIN session_history_media_info AS shmi ON sh.id = shmi.id ' \
+                    'WHERE sh.stopped >= %s ' \
+                    'ORDER BY sh.date_played' % (user_cond, timestamp)
+
+            result = monitor_db.select(query)
+        except Exception as e:
+            logger.warn("Tautulli Graphs :: Unable to execute database query for get_total_plays_per_stream_type: %s." % e)
+            return None
+
+        # create our date range as some days may not have any data
+        # but we still want to display them
+        base = datetime.date.today()
+        date_list = [base - datetime.timedelta(days=x) for x in range(0, int(time_range))]
+
+        categories = []
+        series_1 = []
+        series_2 = []
+        series_3 = []
+        series_4 = []
+
+        grouped_result_by_stream_type = helpers.group_by_keys(result, ('date_played','transcode_decision'))
+        grouped_result_by_day = helpers.group_by_keys(result, ['date_played'])
+
+        for date_item in sorted(date_list):
+            date_string = date_item.strftime('%Y-%m-%d')
+            categories.append(date_string)
+            series_1_value = 0
+            series_2_value = 0
+            series_3_value = 0
+            series_4_value = 0
+
+            for item in grouped_result_by_stream_type:
+                if item['key'] == (date_string,'direct play'):
+                    series_1_value = calc_most_concurrent(item['value'])
+                elif item['key'] == (date_string,'copy'):
+                    series_2_value = calc_most_concurrent(item['value'])
+                elif item['key'] == (date_string,'transcode'):
+                    series_3_value = calc_most_concurrent(item['value'])
+
+            for item in grouped_result_by_day:
+                if item['key'] == date_string:
+                    series_4_value = calc_most_concurrent(item['value'])
+            
+            series_1.append(series_1_value)
+            series_2.append(series_2_value)
+            series_3.append(series_3_value)
+            series_4.append(series_4_value)
+
+        series_1_output = {'name': 'Direct Play',
+                           'data': series_1}
+        series_2_output = {'name': 'Direct Stream',
+                           'data': series_2}
+        series_3_output = {'name': 'Transcode',
+                           'data': series_3}
+        series_4_output = {'name': 'Max. Concurrent Streams',
+                           'data': series_4}
+
+        output = {'categories': categories,
+                  'series': [series_1_output, series_2_output, series_3_output, series_4_output]}
+        return output
+
     def get_total_plays_by_source_resolution(self, time_range='30', y_axis='plays', user_id=None, grouping=None):
         monitor_db = database.MonitorDatabase()
 
@@ -1169,15 +1264,16 @@ class Graphs(object):
 
         return output
 
-    def _make_user_cond(self, user_id):
+    def _make_user_cond(self, user_id, cond_prefix='AND'):
         """
         Expects user_id to be a comma-separated list of ints.
         """
         user_cond = ''
+
         if session.get_session_user_id() and user_id and user_id != str(session.get_session_user_id()):
-            user_cond = 'AND session_history.user_id = %s ' % session.get_session_user_id()
+            user_cond = cond_prefix + ' session_history.user_id = %s ' % session.get_session_user_id()
         elif user_id:
             user_ids = helpers.split_strip(user_id)
             if all(id.isdigit() for id in user_ids):
-                user_cond = 'AND session_history.user_id IN (%s) ' % ','.join(user_ids)
+                user_cond =cond_prefix + ' session_history.user_id IN (%s) ' % ','.join(user_ids)
         return user_cond
diff --git a/plexpy/helpers.py b/plexpy/helpers.py
index 085dfc12..4512f0b6 100644
--- a/plexpy/helpers.py
+++ b/plexpy/helpers.py
@@ -32,6 +32,7 @@ import datetime
 from functools import reduce, wraps
 import hashlib
 import imghdr
+from itertools import groupby
 from future.moves.itertools import islice, zip_longest
 from ipaddress import ip_address, ip_network, IPv4Address
 import ipwhois
@@ -1241,6 +1242,11 @@ def grouper(iterable, n, fillvalue=None):
     args = [iter(iterable)] * n
     return zip_longest(fillvalue=fillvalue, *args)
 
+def group_by_keys(iterable, keys):
+    key_function = operator.itemgetter(*keys)
+
+    sorted_iterable = sorted(iterable, key=key_function)
+    return[{'key': key, 'value': list(group)} for key, group in groupby(sorted_iterable, key_function)]
 
 def chunk(it, size):
     it = iter(it)
diff --git a/plexpy/webserve.py b/plexpy/webserve.py
index b643f84b..196bbe5b 100644
--- a/plexpy/webserve.py
+++ b/plexpy/webserve.py
@@ -2549,6 +2549,44 @@ class WebInterface(object):
             logger.warn("Unable to retrieve data for get_plays_by_stream_type.")
             return result
 
+    @cherrypy.expose
+    @cherrypy.tools.json_out()
+    @requireAuth()
+    @addtoapi()
+    def get_concurrent_streams_by_stream_type(self, time_range='30', user_id=None, **kwargs):
+        """ Get graph data for concurrent streams by stream type by date.
+
+            ```
+            Required parameters:
+                None
+
+            Optional parameters:
+                time_range (str):       The number of days of data to return
+                user_id (str):          Comma separated list of user id to filter the data
+
+            Returns:
+                json:
+                    {"categories":
+                        ["YYYY-MM-DD", "YYYY-MM-DD", ...]
+                     "series":
+                        [{"name": "Direct Play", "data": [...]}
+                         {"name": "Direct Stream", "data": [...]},
+                         {"name": "Transcode", "data": [...]},
+                         {"name": "Max. Concurrent Streams", "data":  [...]}
+                         ]
+                     }
+            ```
+        """
+
+        graph = graphs.Graphs()
+        result = graph.get_total_concurrent_streams_per_stream_type(time_range=time_range, user_id=user_id)
+
+        if result:
+            return result
+        else:
+            logger.warn("Unable to retrieve data for get_concurrent_streams_by_stream_type.")
+            return result
+
     @cherrypy.expose
     @cherrypy.tools.json_out()
     @requireAuth()

From a668932ea87b73967c716cf0b88a7a39c37f48b0 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 8 Sep 2023 15:27:50 -0700
Subject: [PATCH 465/743] Remove banners from exports

---
 plexpy/exporter.py | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/plexpy/exporter.py b/plexpy/exporter.py
index f1c730a4..e1dc989d 100644
--- a/plexpy/exporter.py
+++ b/plexpy/exporter.py
@@ -420,8 +420,6 @@ class Export(object):
                 'audioLanguage': None,
                 'autoDeletionItemPolicyUnwatchedLibrary': None,
                 'autoDeletionItemPolicyWatchedLibrary': None,
-                'banner': None,
-                'bannerFile': lambda o: self.get_image(o, 'banner'),
                 'childCount': None,
                 'collections': {
                     'id': None,
@@ -1382,7 +1380,7 @@ class Export(object):
                     'fields.name', 'fields.locked', 'guids.id'
                 ],
                 3: [
-                    'art', 'thumb', 'banner', 'theme', 'key',
+                    'art', 'thumb', 'theme', 'key',
                     'updatedAt', 'lastViewedAt', 'viewCount', 'lastRatedAt'
                 ],
                 9: self._get_all_metadata_attrs(_media_type)
@@ -2258,8 +2256,6 @@ class Export(object):
             image_url = item.thumbUrl
         elif image == 'art':
             image_url = item.artUrl
-        elif image == 'banner':
-            image_url = item.bannerUrl
 
         if not image_url:
             return

From b18c31f431571bb3246fdca1380edde26cd7dcba Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 15 Sep 2023 17:15:54 -0700
Subject: [PATCH 466/743] Update table right flow overflow

---
 data/interfaces/default/css/tautulli.css | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/data/interfaces/default/css/tautulli.css b/data/interfaces/default/css/tautulli.css
index e256d2d7..8cad039f 100644
--- a/data/interfaces/default/css/tautulli.css
+++ b/data/interfaces/default/css/tautulli.css
@@ -2984,7 +2984,8 @@ a .home-platforms-list-cover-face:hover
     max-width: 900px;
 }
 .stacked-configs > li > span {
-    display: block;
+    display: inline-block;
+    width: inherit;
     padding: 8px 20px 8px 15px;
     color: #eee;
     border-left: 2px solid #444;

From 0fa7553d97cbadabe4fd5f9cc7c21fd87659fb6c Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 15 Sep 2023 17:16:16 -0700
Subject: [PATCH 467/743] Fix right float cog icon on mobile devices table

---
 data/interfaces/default/mobile_devices_table.html | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/data/interfaces/default/mobile_devices_table.html b/data/interfaces/default/mobile_devices_table.html
index e5363885..852fb2dd 100644
--- a/data/interfaces/default/mobile_devices_table.html
+++ b/data/interfaces/default/mobile_devices_table.html
@@ -28,15 +28,17 @@ DOCUMENTATION :: END
                 <span class="toggle-left official-tooltip" data-toggle="tooltip" data-placement="top" title="Unofficial or Unknown App"><i class="fa fa-lg fa-fw fa-exclamation-triangle"></i></span>
             % endif
             ${device['friendly_name'] or device['device_name']} &nbsp;<span class="friendly_name">(${device['id']})</span>
-            <span class="toggle-right"><i class="fa fa-lg fa-fw fa-cog"></i></span>
-            <span class="toggle-right friendly_name" id="device-last_seen-${device['id']}">
+            <span class="toggle-right friendly_name">
                 % if device['last_seen']:
-                <script>
-                    $("#device-last_seen-${device['id']}").text(moment("${device['last_seen']}", "X").fromNow())
-                </script>
+                <span id="device-last_seen-${device['id']}">
+                    <script>
+                        $("#device-last_seen-${device['id']}").text(moment("${device['last_seen']}", "X").fromNow())
+                    </script>
+                </span>
                 % else:
                 never
                 % endif
+                <i class="fa fa-lg fa-fw fa-cog"></i></span>
             </span>
         </span>
     </li>

From 982c893c4989e2733d7e38562c36c128556f908f Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 21 Sep 2023 12:16:01 -0700
Subject: [PATCH 468/743] Use helper function to cast play duration to int

---
 plexpy/datafactory.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/plexpy/datafactory.py b/plexpy/datafactory.py
index 3db32a51..bd5a7c31 100644
--- a/plexpy/datafactory.py
+++ b/plexpy/datafactory.py
@@ -270,7 +270,7 @@ class DataFactory(object):
 
                 item['user_thumb'] = users_lookup.get(item['user_id'])
 
-            filter_duration += int(item['play_duration'])
+            filter_duration += helpers.cast_to_int(item['play_duration'])
 
             if item['media_type'] == 'episode' and item['parent_thumb']:
                 thumb = item['parent_thumb']

From 62be48df9c79d6b3de47d16578471290d2ef9206 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 9 Oct 2023 11:33:40 -0700
Subject: [PATCH 469/743] Change colour of max. concurrent stream series

---
 data/interfaces/default/graphs.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/data/interfaces/default/graphs.html b/data/interfaces/default/graphs.html
index 8f16f59a..7cd0c98b 100644
--- a/data/interfaces/default/graphs.html
+++ b/data/interfaces/default/graphs.html
@@ -327,7 +327,7 @@
             'Direct Play': '#E5A00D',
             'Direct Stream': '#FFFFFF',
             'Transcode': '#F06464',
-            'Max. Concurrent Streams': '#1014FC'
+            'Max. Concurrent Streams': '#96C83C'
         };
         var series_colors = [];
         $.each(data_series, function(index, series) {

From fdc1dd3525ce752b05bb74147130a9f2cba2765a Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 9 Oct 2023 11:37:56 -0700
Subject: [PATCH 470/743] Add trigger time to notification and newsletter
 tables

---
 .../interfaces/default/newsletters_table.html | 25 +++++++++++++++----
 data/interfaces/default/notifiers_table.html  | 15 ++++++++++-
 data/interfaces/default/settings.html         |  6 ++---
 plexpy/newsletters.py                         | 15 ++++++++---
 plexpy/notifiers.py                           | 14 ++++++++---
 5 files changed, 60 insertions(+), 15 deletions(-)

diff --git a/data/interfaces/default/newsletters_table.html b/data/interfaces/default/newsletters_table.html
index 5ceaf0a0..b2c4cb04 100644
--- a/data/interfaces/default/newsletters_table.html
+++ b/data/interfaces/default/newsletters_table.html
@@ -20,13 +20,28 @@ DOCUMENTATION :: END
             % else:
             ${newsletter['agent_label']} &nbsp;<span class="friendly_name">(${newsletter['id']})</span>
             % endif
-            <span class="toggle-right"><i class="fa fa-lg fa-fw fa-cog"></i></span>
-            <span class="toggle-right friendly_name" id="newsletter-next_run-${newsletter['id']}">
+            <span class="toggle-right friendly_name">
                 % if newsletter_handler.NEWSLETTER_SCHED.get_job('newsletter-{}'.format(newsletter['id'])):
                 <% job = newsletter_handler.NEWSLETTER_SCHED.get_job('newsletter-{}'.format(newsletter['id'])) %>
-                <script>
-                    $("#newsletter-next_run-${newsletter['id']}").text(moment("${job.next_run_time}", "YYYY-MM-DD HH:mm:ssZ").fromNow())
-                </script>
+                <span id="newsletter-next_run-${newsletter['id']}">
+                    <script>
+                        $("#newsletter-next_run-${newsletter['id']}").text(
+                            "Next: " + moment("${job.next_run_time}", "YYYY-MM-DD HH:mm:ssZ").fromNow() + " | ")
+                    </script>
+                </span>
+                % endif
+                % if newsletter['last_triggered']:
+                <% icon, icon_tooltip = ('fa-check', 'Success') if newsletter['last_success'] else ('fa-times', 'Failed') %>
+                <span id="newsletter-last_triggered-${newsletter['id']}">
+                    <script>
+                        $("#newsletter-last_triggered-${newsletter['id']}").html(
+                            "Last: " + moment("${newsletter['last_triggered']}", "X").fromNow() + ' <i class="fa fa-lg fa-fw ${icon}" data-toggle="tooltip" data-placement="top" title="${icon_tooltip}"></i>'
+                        )
+                    </script>
+                </span>
+                % else:
+                Last: never
+                <i class="fa fa-lg fa-fw fa-minus"></i>
                 % endif
             </span>
         </span>
diff --git a/data/interfaces/default/notifiers_table.html b/data/interfaces/default/notifiers_table.html
index d2bfa55e..1017f7f4 100644
--- a/data/interfaces/default/notifiers_table.html
+++ b/data/interfaces/default/notifiers_table.html
@@ -19,7 +19,20 @@ DOCUMENTATION :: END
             % else:
             ${notifier['agent_label']} &nbsp;<span class="friendly_name">(${notifier['id']})</span>
             % endif
-            <span class="toggle-right"><i class="fa fa-lg fa-fw fa-cog"></i></span>
+            <span class="toggle-right friendly_name">
+                % if notifier['last_triggered']:
+                <% icon, icon_tooltip = ('fa-check', 'Success') if notifier['last_success'] else ('fa-times', 'Failed') %>
+                <span id="notifier-last_triggered-${notifier['id']}">
+                    <script>
+                        $("#notifier-last_triggered-${notifier['id']}").html(
+                            moment("${notifier['last_triggered']}", "X").fromNow() + ' <i class="fa fa-lg fa-fw ${icon}" data-toggle="tooltip" data-placement="top" title="${icon_tooltip}"></i>'
+                        )
+                    </script>
+                </span>
+            % else:
+            never
+            <i class="fa fa-lg fa-fw fa-minus"></i>
+            % endif
         </span>
     </li>
     % endfor
diff --git a/data/interfaces/default/settings.html b/data/interfaces/default/settings.html
index c5d8fe37..6710ff79 100644
--- a/data/interfaces/default/settings.html
+++ b/data/interfaces/default/settings.html
@@ -1278,7 +1278,7 @@
                         </div>
 
                         <p class="help-block">
-                            Add a new notification agent, or configure an existing notification agent by clicking the settings icon on the right.
+                            Add a new notification agent, or configure an existing notification agent by clicking on the item below.
                         </p>
                         <p class="help-block">
                             Please see the <a href="${anon_url('https://github.com/%s/%s/wiki/Notification-Agents-Guide' % (plexpy.CONFIG.GIT_USER, plexpy.CONFIG.GIT_REPO))}" target="_blank" rel="noreferrer">Notification Agents Guide</a> for instructions on setting up each notification agent.
@@ -1298,7 +1298,7 @@
                         </div>
 
                         <p class="help-block">
-                            Add a new newsletter agent, or configure an existing newsletter agent by clicking the settings icon on the right.
+                            Add a new newsletter agent, or configure an existing newsletter agent by clicking on the item below.
                         </p>
                         <p class="help-block settings-warning" id="newsletter_upload_warning">
                             Warning: The <a data-tab-destination="3rd_party_apis" data-target="notify_upload_posters">Image Hosting</a> setting must be enabled for images to display on the newsletter.</span>
@@ -1630,7 +1630,7 @@
                         </div>
                         <div class="form-group">
                             <label>Registered Devices</label>
-                            <p class="help-block">Register a new device using a QR code, or configure an existing device by clicking the settings icon on the right.</p>
+                            <p class="help-block">Register a new device using a QR code, or configure an existing device by clicking on the item below.</p>
                             <p id="app_api_msg" style="color: #eb8600;">Warning: The API must be enabled under <a data-tab-destination="web_interface" data-target="api_enabled">Web Interface</a> to use the app.</p>
                             <br />
                             <div class="row">
diff --git a/plexpy/newsletters.py b/plexpy/newsletters.py
index 661a2b42..5fe8448c 100644
--- a/plexpy/newsletters.py
+++ b/plexpy/newsletters.py
@@ -119,13 +119,22 @@ def get_newsletters(newsletter_id=None):
     if newsletter_id:
         where = "WHERE "
         if newsletter_id:
-            where_id += "id = ?"
+            where_id += "newsletters.id = ?"
             args.append(newsletter_id)
         where += " AND ".join([w for w in [where_id] if w])
 
     db = database.MonitorDatabase()
-    result = db.select("SELECT id, agent_id, agent_name, agent_label, "
-                       "friendly_name, cron, active FROM newsletters %s" % where, args=args)
+    result = db.select(
+        (
+            "SELECT newsletters.id, newsletters.agent_id, newsletters.agent_name, newsletters.agent_label, "
+            "newsletters.friendly_name, newsletters.cron, newsletters.active, "
+            "MAX(newsletter_log.timestamp) AS last_triggered, newsletter_log.success AS last_success "
+            "FROM newsletters "
+            "LEFT OUTER JOIN newsletter_log ON newsletters.id = newsletter_log.newsletter_id "
+            "%s "
+            "GROUP BY newsletters.id"
+        ) % where, args=args
+    )
 
     return result
 
diff --git a/plexpy/notifiers.py b/plexpy/notifiers.py
index ec8ad5b9..1e18644e 100644
--- a/plexpy/notifiers.py
+++ b/plexpy/notifiers.py
@@ -499,7 +499,7 @@ def get_notifiers(notifier_id=None, notify_action=None):
     if notifier_id or notify_action:
         where = 'WHERE '
         if notifier_id:
-            where_id += 'id = ?'
+            where_id += 'notifiers.id = ?'
             args.append(notifier_id)
         if notify_action and notify_action in notify_actions:
             where_action = '%s = ?' % notify_action
@@ -507,8 +507,16 @@ def get_notifiers(notifier_id=None, notify_action=None):
         where += ' AND '.join([w for w in [where_id, where_action] if w])
 
     db = database.MonitorDatabase()
-    result = db.select("SELECT id, agent_id, agent_name, agent_label, friendly_name, %s FROM notifiers %s"
-                       % (', '.join(notify_actions), where), args=args)
+    result = db.select(
+        (
+            "SELECT notifiers.id, notifiers.agent_id, notifiers.agent_name, notifiers.agent_label, notifiers.friendly_name, %s, "
+            "MAX(notify_log.timestamp) AS last_triggered, notify_log.success AS last_success "
+            "FROM notifiers "
+            "LEFT OUTER JOIN notify_log ON notifiers.id = notify_log.notifier_id "
+            "%s "
+            "GROUP BY notifiers.id"
+        ) % (', '.join(notify_actions), where), args=args
+    )
 
     for item in result:
         item['active'] = int(any([item.pop(k) for k in list(item.keys()) if k in notify_actions]))

From aa4d98ee3406a330d8f30972c24635e4f539b8aa Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 10 Oct 2023 14:22:10 -0700
Subject: [PATCH 471/743] Bump plexapi from 4.15.0 to 4.15.4 (#2175)

* Bump plexapi from 4.15.0 to 4.15.4

Bumps [plexapi](https://github.com/pkkid/python-plexapi) from 4.15.0 to 4.15.4.
- [Release notes](https://github.com/pkkid/python-plexapi/releases)
- [Commits](https://github.com/pkkid/python-plexapi/compare/4.15.0...4.15.4)

---
updated-dependencies:
- dependency-name: plexapi
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

* Update plexapi==4.15.4

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/plexapi/__init__.py   |   1 +
 lib/plexapi/alert.py      |  19 +++----
 lib/plexapi/audio.py      |  19 +++++++
 lib/plexapi/base.py       |  11 +++--
 lib/plexapi/client.py     |   5 +-
 lib/plexapi/collection.py |   9 +++-
 lib/plexapi/config.py     |   1 +
 lib/plexapi/const.py      |   2 +-
 lib/plexapi/library.py    |  33 +++++++------
 lib/plexapi/media.py      |  90 +++++++++++++++++++++++++--------
 lib/plexapi/mixins.py     |  22 ++++-----
 lib/plexapi/myplex.py     |  80 ++++++++++++++++++++++++++----
 lib/plexapi/photo.py      |  15 +++++-
 lib/plexapi/playlist.py   |  13 +++--
 lib/plexapi/server.py     |  54 +++++++++++++++-----
 lib/plexapi/sync.py       |   1 -
 lib/plexapi/utils.py      |  49 ++++++++++++------
 lib/plexapi/video.py      | 101 ++++++++++++++++++++++++++++++--------
 requirements.txt          |   2 +-
 19 files changed, 399 insertions(+), 128 deletions(-)

diff --git a/lib/plexapi/__init__.py b/lib/plexapi/__init__.py
index eefc181d..1d4fb471 100644
--- a/lib/plexapi/__init__.py
+++ b/lib/plexapi/__init__.py
@@ -30,6 +30,7 @@ X_PLEX_VERSION = CONFIG.get('header.version', VERSION)
 X_PLEX_DEVICE = CONFIG.get('header.device', X_PLEX_PLATFORM)
 X_PLEX_DEVICE_NAME = CONFIG.get('header.device_name', uname()[1])
 X_PLEX_IDENTIFIER = CONFIG.get('header.identifier', str(hex(getnode())))
+X_PLEX_LANGUAGE = CONFIG.get('header.language', 'en')
 BASE_HEADERS = reset_base_headers()
 
 # Logging Configuration
diff --git a/lib/plexapi/alert.py b/lib/plexapi/alert.py
index 79ecc445..2d6a18e8 100644
--- a/lib/plexapi/alert.py
+++ b/lib/plexapi/alert.py
@@ -1,5 +1,7 @@
 # -*- coding: utf-8 -*-
 import json
+import socket
+from typing import Callable
 import threading
 
 from plexapi import log
@@ -32,15 +34,17 @@ class AlertListener(threading.Thread):
             callbackError (func): Callback function to call on errors. The callback function
                 will be sent a single argument 'error' which will contain the Error object.
                 :samp:`def my_callback(error): ...`
+            ws_socket (socket): Socket to use for the connection. If not specified, a new socket will be created.
     """
     key = '/:/websockets/notifications'
 
-    def __init__(self, server, callback=None, callbackError=None):
+    def __init__(self, server, callback: Callable = None, callbackError: Callable = None, ws_socket: socket = None):
         super(AlertListener, self).__init__()
         self.daemon = True
         self._server = server
         self._callback = callback
         self._callbackError = callbackError
+        self._socket = ws_socket
         self._ws = None
 
     def run(self):
@@ -52,8 +56,9 @@ class AlertListener(threading.Thread):
         # create the websocket connection
         url = self._server.url(self.key, includeToken=True).replace('http', 'ws')
         log.info('Starting AlertListener: %s', url)
-        self._ws = websocket.WebSocketApp(url, on_message=self._onMessage,
-                                          on_error=self._onError)
+
+        self._ws = websocket.WebSocketApp(url, on_message=self._onMessage, on_error=self._onError, socket=self._socket)
+
         self._ws.run_forever()
 
     def stop(self):
@@ -66,10 +71,8 @@ class AlertListener(threading.Thread):
 
     def _onMessage(self, *args):
         """ Called when websocket message is received.
-            In earlier releases, websocket-client returned a tuple of two parameters: a websocket.app.WebSocketApp
-            object and the message as a STR. Current releases appear to only return the message.
+
             We are assuming the last argument in the tuple is the message.
-            This is to support compatibility with current and previous releases of websocket-client.
         """
         message = args[-1]
         try:
@@ -82,10 +85,8 @@ class AlertListener(threading.Thread):
 
     def _onError(self, *args):  # pragma: no cover
         """ Called when websocket error is received.
-            In earlier releases, websocket-client returned a tuple of two parameters: a websocket.app.WebSocketApp
-            object and the error. Current releases appear to only return the error.
+
             We are assuming the last argument in the tuple is the message.
-            This is to support compatibility with current and previous releases of websocket-client.
         """
         err = args[-1]
         try:
diff --git a/lib/plexapi/audio.py b/lib/plexapi/audio.py
index e1382760..2a169877 100644
--- a/lib/plexapi/audio.py
+++ b/lib/plexapi/audio.py
@@ -1,5 +1,6 @@
 # -*- coding: utf-8 -*-
 import os
+from pathlib import Path
 from urllib.parse import quote_plus
 
 from plexapi import media, utils
@@ -240,6 +241,12 @@ class Artist(
         key = f'{self.key}?includeStations=1'
         return next(iter(self.fetchItems(key, cls=Playlist, rtag="Stations")), None)
 
+    @property
+    def metadataDirectory(self):
+        """ Returns the Plex Media Server data directory where the metadata is stored. """
+        guid_hash = utils.sha1hash(self.guid)
+        return str(Path('Metadata') / 'Artists' / guid_hash[0] / f'{guid_hash[1:]}.bundle')
+
 
 @utils.registerPlexObject
 class Album(
@@ -359,6 +366,12 @@ class Album(
         """ Returns str, default title for a new syncItem. """
         return f'{self.parentTitle} - {self.title}'
 
+    @property
+    def metadataDirectory(self):
+        """ Returns the Plex Media Server data directory where the metadata is stored. """
+        guid_hash = utils.sha1hash(self.guid)
+        return str(Path('Metadata') / 'Albums' / guid_hash[0] / f'{guid_hash[1:]}.bundle')
+
 
 @utils.registerPlexObject
 class Track(
@@ -470,6 +483,12 @@ class Track(
         """ Get the Plex Web URL with the correct parameters. """
         return self._server._buildWebURL(base=base, endpoint='details', key=self.parentKey)
 
+    @property
+    def metadataDirectory(self):
+        """ Returns the Plex Media Server data directory where the metadata is stored. """
+        guid_hash = utils.sha1hash(self.parentGuid)
+        return str(Path('Metadata') / 'Albums' / guid_hash[0] / f'{guid_hash[1:]}.bundle')
+
 
 @utils.registerPlexObject
 class TrackSession(PlexSession, Track):
diff --git a/lib/plexapi/base.py b/lib/plexapi/base.py
index 88a31bbe..822e40ea 100644
--- a/lib/plexapi/base.py
+++ b/lib/plexapi/base.py
@@ -227,7 +227,7 @@ class PlexObject:
 
                     fetchItem(ekey, viewCount__gte=0)
                     fetchItem(ekey, Media__container__in=["mp4", "mkv"])
-                    fetchItem(ekey, guid__iregex=r"(imdb:\/\/|themoviedb:\/\/)")
+                    fetchItem(ekey, guid__iregex=r"(imdb://|themoviedb://)")
                     fetchItem(ekey, Media__Part__file__startswith="D:\\Movies")
 
         """
@@ -502,7 +502,7 @@ class PlexPartialObject(PlexObject):
 
     def __eq__(self, other):
         if isinstance(other, PlexPartialObject):
-            return other not in [None, []] and self.key == other.key
+            return self.key == other.key
         return NotImplemented
 
     def __hash__(self):
@@ -626,7 +626,8 @@ class PlexPartialObject(PlexObject):
         return self
 
     def saveEdits(self):
-        """ Save all the batch edits and automatically reload the object.
+        """ Save all the batch edits. The object needs to be reloaded manually,
+            if required.
             See :func:`~plexapi.base.PlexPartialObject.batchEdits` for details.
         """
         if not isinstance(self._edits, dict):
@@ -635,7 +636,7 @@ class PlexPartialObject(PlexObject):
         edits = self._edits
         self._edits = None
         self._edit(**edits)
-        return self.reload()
+        return self
 
     def refresh(self):
         """ Refreshing a Library or individual item causes the metadata for the item to be
@@ -919,7 +920,7 @@ class PlexSession(object):
 
     def stop(self, reason=''):
         """ Stop playback for the session.
-        
+
             Parameters:
                 reason (str): Message displayed to the user for stopping playback.
         """
diff --git a/lib/plexapi/client.py b/lib/plexapi/client.py
index 2b4283c7..279b4974 100644
--- a/lib/plexapi/client.py
+++ b/lib/plexapi/client.py
@@ -70,6 +70,7 @@ class PlexClient(PlexObject):
         self._showSecrets = CONFIG.get('log.show_secrets', '').lower() == 'true'
         server_session = server._session if server else None
         self._session = session or server_session or requests.Session()
+        self._timeout = timeout or TIMEOUT
         self._proxyThroughServer = False
         self._commandId = 0
         self._last_call = 0
@@ -94,7 +95,7 @@ class PlexClient(PlexObject):
             raise Unsupported('Cannot reload an object not built from a URL.')
         self._initpath = self.key
         data = self.query(self.key, timeout=timeout)
-        if not data:
+        if data is None:
             raise NotFound(f"Client not found at {self._baseurl}")
         if self._clientIdentifier:
             client = next(
@@ -179,7 +180,7 @@ class PlexClient(PlexObject):
         """
         url = self.url(path)
         method = method or self._session.get
-        timeout = timeout or TIMEOUT
+        timeout = timeout or self._timeout
         log.debug('%s %s', method.__name__.upper(), url)
         headers = self._headers(**headers or {})
         response = method(url, headers=headers, timeout=timeout, **kwargs)
diff --git a/lib/plexapi/collection.py b/lib/plexapi/collection.py
index d4820fe2..8bc5f286 100644
--- a/lib/plexapi/collection.py
+++ b/lib/plexapi/collection.py
@@ -1,4 +1,5 @@
 # -*- coding: utf-8 -*-
+from pathlib import Path
 from urllib.parse import quote_plus
 
 from plexapi import media, utils
@@ -399,7 +400,7 @@ class Collection(
     @deprecated('use editTitle, editSortTitle, editContentRating, and editSummary instead')
     def edit(self, title=None, titleSort=None, contentRating=None, summary=None, **kwargs):
         """ Edit the collection.
-        
+
             Parameters:
                 title (str, optional): The title of the collection.
                 titleSort (str, optional): The sort title of the collection.
@@ -560,3 +561,9 @@ class Collection(
             raise Unsupported('Unsupported collection content')
 
         return myplex.sync(sync_item, client=client, clientId=clientId)
+
+    @property
+    def metadataDirectory(self):
+        """ Returns the Plex Media Server data directory where the metadata is stored. """
+        guid_hash = utils.sha1hash(self.guid)
+        return str(Path('Metadata') / 'Collections' / guid_hash[0] / f'{guid_hash[1:]}.bundle')
diff --git a/lib/plexapi/config.py b/lib/plexapi/config.py
index 8bbf1f31..5cfa74c8 100644
--- a/lib/plexapi/config.py
+++ b/lib/plexapi/config.py
@@ -63,6 +63,7 @@ def reset_base_headers():
         'X-Plex-Device': plexapi.X_PLEX_DEVICE,
         'X-Plex-Device-Name': plexapi.X_PLEX_DEVICE_NAME,
         'X-Plex-Client-Identifier': plexapi.X_PLEX_IDENTIFIER,
+        'X-Plex-Language': plexapi.X_PLEX_LANGUAGE,
         'X-Plex-Sync-Version': '2',
         'X-Plex-Features': 'external-media',
     }
diff --git a/lib/plexapi/const.py b/lib/plexapi/const.py
index df86ff5d..8a172e98 100644
--- a/lib/plexapi/const.py
+++ b/lib/plexapi/const.py
@@ -4,6 +4,6 @@
 # Library version
 MAJOR_VERSION = 4
 MINOR_VERSION = 15
-PATCH_VERSION = 0
+PATCH_VERSION = 4
 __short_version__ = f"{MAJOR_VERSION}.{MINOR_VERSION}"
 __version__ = f"{__short_version__}.{PATCH_VERSION}"
diff --git a/lib/plexapi/library.py b/lib/plexapi/library.py
index cbca4246..87d59eac 100644
--- a/lib/plexapi/library.py
+++ b/lib/plexapi/library.py
@@ -542,7 +542,7 @@ class LibrarySection(PlexObject):
 
     def addLocations(self, location):
         """ Add a location to a library.
-        
+
             Parameters:
                 location (str or list): A single folder path, list of paths.
 
@@ -565,7 +565,7 @@ class LibrarySection(PlexObject):
 
     def removeLocations(self, location):
         """ Remove a location from a library.
-        
+
             Parameters:
                 location (str or list): A single folder path, list of paths.
 
@@ -744,7 +744,7 @@ class LibrarySection(PlexObject):
 
     def lockAllField(self, field, libtype=None):
         """ Lock a field for all items in the library.
-        
+
             Parameters:
                 field (str): The field to lock (e.g. thumb, rating, collection).
                 libtype (str, optional): The library type to lock (movie, show, season, episode,
@@ -754,7 +754,7 @@ class LibrarySection(PlexObject):
 
     def unlockAllField(self, field, libtype=None):
         """ Unlock a field for all items in the library.
-        
+
             Parameters:
                 field (str): The field to unlock (e.g. thumb, rating, collection).
                 libtype (str, optional): The library type to lock (movie, show, season, episode,
@@ -847,7 +847,7 @@ class LibrarySection(PlexObject):
         """
         _key = ('/library/sections/{key}/{filter}?includeMeta=1&includeAdvanced=1'
                 '&X-Plex-Container-Start=0&X-Plex-Container-Size=0')
-               
+
         key = _key.format(key=self.key, filter='all')
         data = self._server.query(key)
         self._filterTypes = self.findItems(data, FilteringType, rtag='Meta')
@@ -894,7 +894,7 @@ class LibrarySection(PlexObject):
 
     def getFieldType(self, fieldType):
         """ Returns a :class:`~plexapi.library.FilteringFieldType` for a specified fieldType.
-        
+
             Parameters:
                 fieldType (str): The data type for the field (tag, integer, string, boolean, date,
                     subtitleLanguage, audioLanguage, resolution).
@@ -927,7 +927,7 @@ class LibrarySection(PlexObject):
 
         """
         return self.getFilterType(libtype).filters
-        
+
     def listSorts(self, libtype=None):
         """ Returns a list of available :class:`~plexapi.library.FilteringSort` for a specified libtype.
             This is the list of options in the sorting dropdown menu
@@ -970,7 +970,7 @@ class LibrarySection(PlexObject):
         """ Returns a list of available :class:`~plexapi.library.FilteringOperator` for a specified fieldType.
             This is the list of options in the custom filter operator dropdown menu
             (`screenshot <../_static/images/LibrarySection.search.png>`__).
-        
+
             Parameters:
                 fieldType (str): The data type for the field (tag, integer, string, boolean, date,
                     subtitleLanguage, audioLanguage, resolution).
@@ -992,7 +992,7 @@ class LibrarySection(PlexObject):
             :class:`~plexapi.library.FilteringFilter` or filter field.
             This is the list of available values for a custom filter
             (`screenshot <../_static/images/LibrarySection.search.png>`__).
-            
+
             Parameters:
                 field (str): :class:`~plexapi.library.FilteringFilter` object,
                     or the name of the field (genre, year, contentRating, etc.).
@@ -1024,7 +1024,7 @@ class LibrarySection(PlexObject):
                 availableFilters = [f.filter for f in self.listFilters(libtype)]
                 raise NotFound(f'Unknown filter field "{field}" for libtype "{libtype}". '
                                f'Available filters: {availableFilters}') from None
-                
+
         data = self._server.query(field.key)
         return self.findItems(data, FilterChoice)
 
@@ -1111,7 +1111,7 @@ class LibrarySection(PlexObject):
         except (ValueError, AttributeError):
             raise BadRequest(f'Invalid value "{value}" for filter field "{filterField.key}", '
                              f'value should be type {fieldType.type}') from None
-    
+
         return results
 
     def _validateFieldValueDate(self, value):
@@ -1345,7 +1345,7 @@ class LibrarySection(PlexObject):
             Tag type filter values can be a :class:`~plexapi.library.FilterChoice` object,
             :class:`~plexapi.media.MediaTag` object, the exact name :attr:`MediaTag.tag` (*str*),
             or the exact id :attr:`MediaTag.id` (*int*).
-            
+
             Date type filter values can be a ``datetime`` object, a relative date using a one of the
             available date suffixes (e.g. ``30d``) (*str*), or a date in ``YYYY-MM-DD`` (*str*) format.
 
@@ -1358,7 +1358,7 @@ class LibrarySection(PlexObject):
             * ``w``: ``weeks``
             * ``mon``: ``months``
             * ``y``: ``years``
-            
+
             Multiple values can be ``OR`` together by providing a list of values.
 
             Examples:
@@ -1684,12 +1684,12 @@ class LibrarySection(PlexObject):
 
     def _validateItems(self, items):
         """ Validates the specified items are from this library and of the same type. """
-        if not items:
+        if items is None or items == []:
             raise BadRequest('No items specified.')
-        
+
         if not isinstance(items, list):
             items = [items]
-        
+
         itemType = items[0].type
         for item in items:
             if item.librarySectionID != self.key:
@@ -3102,6 +3102,7 @@ class FirstCharacter(PlexObject):
             size (str): Total amount of library items starting with this character.
             title (str): Character (#, !, A, B, C, ...).
     """
+
     def _loadData(self, data):
         """ Load attribute values from Plex XML response. """
         self._data = data
diff --git a/lib/plexapi/media.py b/lib/plexapi/media.py
index 8793463f..369bb759 100644
--- a/lib/plexapi/media.py
+++ b/lib/plexapi/media.py
@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
-
 import xml
+from pathlib import Path
 from urllib.parse import quote_plus
 
 from plexapi import log, settings, utils
@@ -121,6 +121,7 @@ class MediaPart(PlexObject):
             optimizedForStreaming (bool): True if the file is optimized for streaming.
             packetLength (int): The packet length of the file.
             requiredBandwidths (str): The required bandwidths to stream the file.
+            selected (bool): True if this media part is selected.
             size (int): The size of the file in bytes (ex: 733884416).
             streams (List<:class:`~plexapi.media.MediaPartStream`>): List of stream objects.
             syncItemId (int): The unique ID for this media part if it is synced.
@@ -184,38 +185,60 @@ class MediaPart(PlexObject):
         """ Returns a list of :class:`~plexapi.media.LyricStream` objects in this MediaPart. """
         return [stream for stream in self.streams if isinstance(stream, LyricStream)]
 
-    def setDefaultAudioStream(self, stream):
-        """ Set the default :class:`~plexapi.media.AudioStream` for this MediaPart.
+    def setSelectedAudioStream(self, stream):
+        """ Set the selected :class:`~plexapi.media.AudioStream` for this MediaPart.
 
             Parameters:
-                stream (:class:`~plexapi.media.AudioStream`): AudioStream to set as default
+                stream (:class:`~plexapi.media.AudioStream`): Audio stream to set as selected
         """
+        key = f'/library/parts/{self.id}'
+        params = {'allParts': 1}
+
         if isinstance(stream, AudioStream):
-            key = f"/library/parts/{self.id}?audioStreamID={stream.id}&allParts=1"
+            params['audioStreamID'] = stream.id
         else:
-            key = f"/library/parts/{self.id}?audioStreamID={stream}&allParts=1"
-        self._server.query(key, method=self._server._session.put)
+            params['audioStreamID'] = stream
+
+        self._server.query(key, method=self._server._session.put, params=params)
         return self
 
-    def setDefaultSubtitleStream(self, stream):
-        """ Set the default :class:`~plexapi.media.SubtitleStream` for this MediaPart.
+    def setSelectedSubtitleStream(self, stream):
+        """ Set the selected :class:`~plexapi.media.SubtitleStream` for this MediaPart.
 
             Parameters:
-                stream (:class:`~plexapi.media.SubtitleStream`): SubtitleStream to set as default.
+                stream (:class:`~plexapi.media.SubtitleStream`): Subtitle stream to set as selected.
         """
+        key = f'/library/parts/{self.id}'
+        params = {'allParts': 1}
+
         if isinstance(stream, SubtitleStream):
-            key = f"/library/parts/{self.id}?subtitleStreamID={stream.id}&allParts=1"
+            params['subtitleStreamID'] = stream.id
         else:
-            key = f"/library/parts/{self.id}?subtitleStreamID={stream}&allParts=1"
+            params['subtitleStreamID'] = stream
+
         self._server.query(key, method=self._server._session.put)
         return self
 
-    def resetDefaultSubtitleStream(self):
-        """ Set default subtitle of this MediaPart to 'none'. """
-        key = f"/library/parts/{self.id}?subtitleStreamID=0&allParts=1"
-        self._server.query(key, method=self._server._session.put)
+    def resetSelectedSubtitleStream(self):
+        """ Set the selected subtitle of this MediaPart to 'None'. """
+        key = f'/library/parts/{self.id}'
+        params = {'subtitleStreamID': 0, 'allParts': 1}
+
+        self._server.query(key, method=self._server._session.put, params=params)
         return self
 
+    @deprecated('Use "setSelectedAudioStream" instead.')
+    def setDefaultAudioStream(self, stream):
+        return self.setSelectedAudioStream(stream)
+
+    @deprecated('Use "setSelectedSubtitleStream" instead.')
+    def setDefaultSubtitleStream(self, stream):
+        return self.setSelectedSubtitleStream(stream)
+
+    @deprecated('Use "resetSelectedSubtitleStream" instead.')
+    def resetDefaultSubtitleStream(self):
+        return self.resetSelectedSubtitleStream()
+
 
 class MediaPartStream(PlexObject):
     """ Base class for media streams. These consist of video, audio, subtitles, and lyrics.
@@ -399,9 +422,15 @@ class AudioStream(MediaPartStream):
             self.peak = utils.cast(float, data.attrib.get('peak'))
             self.startRamp = data.attrib.get('startRamp')
 
+    def setSelected(self):
+        """ Sets this audio stream as the selected audio stream.
+            Alias for :func:`~plexapi.media.MediaPart.setSelectedAudioStream`.
+        """
+        return self._parent().setSelectedAudioStream(self)
+
+    @deprecated('Use "setSelected" instead.')
     def setDefault(self):
-        """ Sets this audio stream as the default audio stream. """
-        return self._parent().setDefaultAudioStream(self)
+        return self.setSelected()
 
 
 @utils.registerPlexObject
@@ -437,9 +466,15 @@ class SubtitleStream(MediaPartStream):
         self.transient = data.attrib.get('transient')
         self.userID = utils.cast(int, data.attrib.get('userID'))
 
+    def setSelected(self):
+        """ Sets this subtitle stream as the selected subtitle stream.
+            Alias for :func:`~plexapi.media.MediaPart.setSelectedSubtitleStream`.
+        """
+        return self._parent().setSelectedSubtitleStream(self)
+
+    @deprecated('Use "setSelected" instead.')
     def setDefault(self):
-        """ Sets this subtitle stream as the default subtitle stream. """
-        return self._parent().setDefaultSubtitleStream(self)
+        return self.setSelected()
 
 
 class LyricStream(MediaPartStream):
@@ -973,6 +1008,7 @@ class BaseResource(PlexObject):
             selected (bool): True if the resource is currently selected.
             thumb (str): The URL to retrieve the resource thumbnail.
     """
+
     def _loadData(self, data):
         self._data = data
         self.key = data.attrib.get('key')
@@ -989,6 +1025,20 @@ class BaseResource(PlexObject):
         except xml.etree.ElementTree.ParseError:
             pass
 
+    @property
+    def resourceFilepath(self):
+        """ Returns the file path to the resource in the Plex Media Server data directory.
+            Note: Returns the URL if the resource is not stored locally.
+        """
+        if self.ratingKey.startswith('media://'):
+            return str(Path('Media') / 'localhost' / self.ratingKey.split('://')[-1])
+        elif self.ratingKey.startswith('metadata://'):
+            return str(Path(self._parent().metadataDirectory) / 'Contents' / '_combined' / self.ratingKey.split('://')[-1])
+        elif self.ratingKey.startswith('upload://'):
+            return str(Path(self._parent().metadataDirectory) / 'Uploads' / self.ratingKey.split('://')[-1])
+        else:
+            return self.ratingKey
+
 
 class Art(BaseResource):
     """ Represents a single Art object. """
diff --git a/lib/plexapi/mixins.py b/lib/plexapi/mixins.py
index f0c21cfe..e1cce54b 100644
--- a/lib/plexapi/mixins.py
+++ b/lib/plexapi/mixins.py
@@ -39,7 +39,7 @@ class AdvancedSettingsMixin:
                 pref = preferences[settingID]
             except KeyError:
                 raise NotFound(f'{value} not found in {list(preferences.keys())}')
-            
+
             enumValues = pref.enumValues
             if enumValues.get(value, enumValues.get(str(value))):
                 data[settingID] = value
@@ -69,7 +69,7 @@ class SmartFilterMixin:
         filters = {}
         filterOp = 'and'
         filterGroups = [[]]
-        
+
         for key, value in parse_qsl(content.query):
             # Move = sign to key when operator is ==
             if value.startswith('='):
@@ -96,11 +96,11 @@ class SmartFilterMixin:
                 filterGroups.pop()
             else:
                 filterGroups[-1].append({key: value})
-        
+
         if filterGroups:
             filters['filters'] = self._formatFilterGroups(filterGroups.pop())
         return filters
-    
+
     def _formatFilterGroups(self, groups):
         """ Formats the filter groups into the advanced search rules. """
         if len(groups) == 1 and isinstance(groups[0], list):
@@ -131,7 +131,7 @@ class SplitMergeMixin:
 
     def merge(self, ratingKeys):
         """ Merge other Plex objects into the current object.
-        
+
             Parameters:
                 ratingKeys (list): A list of rating keys to merge.
         """
@@ -320,7 +320,7 @@ class RatingMixin:
 
 class ArtUrlMixin:
     """ Mixin for Plex objects that can have a background artwork url. """
-    
+
     @property
     def artUrl(self):
         """ Return the art url for the Plex object. """
@@ -349,7 +349,7 @@ class ArtMixin(ArtUrlMixin, ArtLockMixin):
 
     def uploadArt(self, url=None, filepath=None):
         """ Upload a background artwork from a url or filepath.
-        
+
             Parameters:
                 url (str): The full URL to the image to upload.
                 filepath (str): The full file path the the image to upload or file-like object.
@@ -365,7 +365,7 @@ class ArtMixin(ArtUrlMixin, ArtLockMixin):
 
     def setArt(self, art):
         """ Set the background artwork for a Plex object.
-        
+
             Parameters:
                 art (:class:`~plexapi.media.Art`): The art object to select.
         """
@@ -425,7 +425,7 @@ class PosterMixin(PosterUrlMixin, PosterLockMixin):
 
     def setPoster(self, poster):
         """ Set the poster for a Plex object.
-        
+
             Parameters:
                 poster (:class:`~plexapi.media.Poster`): The poster object to select.
         """
@@ -491,11 +491,11 @@ class ThemeMixin(ThemeUrlMixin, ThemeLockMixin):
 
 class EditFieldMixin:
     """ Mixin for editing Plex object fields. """
-    
+
     def editField(self, field, value, locked=True, **kwargs):
         """ Edit the field of a Plex object. All field editing methods can be chained together.
             Also see :func:`~plexapi.base.PlexPartialObject.batchEdits` for batch editing fields.
-        
+
             Parameters:
                 field (str): The name of the field to edit.
                 value (str): The value to edit the field to.
diff --git a/lib/plexapi/myplex.py b/lib/plexapi/myplex.py
index c90b5d33..ede2276d 100644
--- a/lib/plexapi/myplex.py
+++ b/lib/plexapi/myplex.py
@@ -111,12 +111,14 @@ class MyPlexAccount(PlexObject):
     # Hub sections
     VOD = 'https://vod.provider.plex.tv'                                                        # get
     MUSIC = 'https://music.provider.plex.tv'                                                    # get
+    DISCOVER = 'https://discover.provider.plex.tv'
     METADATA = 'https://metadata.provider.plex.tv'
     key = 'https://plex.tv/api/v2/user'
 
     def __init__(self, username=None, password=None, token=None, session=None, timeout=None, code=None, remember=True):
         self._token = logfilter.add_secret(token or CONFIG.get('auth.server_token'))
         self._session = session or requests.Session()
+        self._timeout = timeout or TIMEOUT
         self._sonos_cache = []
         self._sonos_cache_timestamp = 0
         data, initpath = self._signin(username, password, code, remember, timeout)
@@ -186,7 +188,9 @@ class MyPlexAccount(PlexObject):
         self.subscriptionPaymentService = subscription.attrib.get('paymentService')
         self.subscriptionPlan = subscription.attrib.get('plan')
         self.subscriptionStatus = subscription.attrib.get('status')
-        self.subscriptionSubscribedAt = utils.toDatetime(subscription.attrib.get('subscribedAt'), '%Y-%m-%d %H:%M:%S %Z')
+        self.subscriptionSubscribedAt = utils.toDatetime(
+            subscription.attrib.get('subscribedAt') or None, '%Y-%m-%d %H:%M:%S %Z'
+        )
 
         profile = data.find('profile')
         self.profileAutoSelectAudio = utils.cast(bool, profile.attrib.get('autoSelectAudio'))
@@ -223,7 +227,7 @@ class MyPlexAccount(PlexObject):
 
     def query(self, url, method=None, headers=None, timeout=None, **kwargs):
         method = method or self._session.get
-        timeout = timeout or TIMEOUT
+        timeout = timeout or self._timeout
         log.debug('%s %s %s', method.__name__.upper(), url, kwargs.get('json', ''))
         headers = self._headers(**headers or {})
         response = method(url, headers=headers, timeout=timeout, **kwargs)
@@ -239,8 +243,10 @@ class MyPlexAccount(PlexObject):
                 raise Unauthorized(message)
             else:
                 raise BadRequest(message)
-        if headers.get('Accept') == 'application/json':
+        if 'application/json' in response.headers.get('Content-Type', ''):
             return response.json()
+        elif 'text/plain' in response.headers.get('Content-Type', ''):
+            return response.text.strip()
         data = response.text.encode('utf8')
         return ElementTree.fromstring(data) if data.strip() else None
 
@@ -672,7 +678,7 @@ class MyPlexAccount(PlexObject):
             if (invite.username and invite.email and invite.id and username.lower() in
                     (invite.username.lower(), invite.email.lower(), str(invite.id))):
                 return invite
-        
+
         raise NotFound(f'Unable to find invite {username}')
 
     def pendingInvites(self, includeSent=True, includeReceived=True):
@@ -950,7 +956,7 @@ class MyPlexAccount(PlexObject):
         """
         if not isinstance(items, list):
             items = [items]
-        
+
         for item in items:
             if self.onWatchlist(item):
                 raise BadRequest(f'"{item.title}" is already on the watchlist')
@@ -971,7 +977,7 @@ class MyPlexAccount(PlexObject):
         """
         if not isinstance(items, list):
             items = [items]
-        
+
         for item in items:
             if not self.onWatchlist(item):
                 raise BadRequest(f'"{item.title}" is not on the watchlist')
@@ -1053,7 +1059,7 @@ class MyPlexAccount(PlexObject):
             'includeMetadata': 1
         }
 
-        data = self.query(f'{self.METADATA}/library/search', headers=headers, params=params)
+        data = self.query(f'{self.DISCOVER}/library/search', headers=headers, params=params)
         searchResults = data['MediaContainer'].get('SearchResults', [])
         searchResult = next((s.get('SearchResult', []) for s in searchResults if s.get('id') == 'external'), [])
 
@@ -1135,6 +1141,21 @@ class MyPlexAccount(PlexObject):
 
         return objs
 
+    def publicIP(self):
+        """ Returns your public IP address. """
+        return self.query('https://plex.tv/:/ip')
+
+    def geoip(self, ip_address):
+        """ Returns a :class:`~plexapi.myplex.GeoLocation` object with geolocation information
+            for an IP address using Plex's GeoIP database.
+
+            Parameters:
+                ip_address (str): IP address to lookup.
+        """
+        params = {'ip_address': ip_address}
+        data = self.query('https://plex.tv/api/v2/geoip', params=params)
+        return GeoLocation(self, data)
+
 
 class MyPlexUser(PlexObject):
     """ This object represents non-signed in users such as friends and linked
@@ -1773,7 +1794,7 @@ class MyPlexPinLogin:
             params = None
 
         response = self._query(url, self._session.post, params=params)
-        if not response:
+        if response is None:
             return None
 
         self._id = response.attrib.get('id')
@@ -1790,7 +1811,7 @@ class MyPlexPinLogin:
 
         url = self.CHECKPINS.format(pinid=self._id)
         response = self._query(url)
-        if not response:
+        if response is None:
             return False
 
         token = response.attrib.get('authToken')
@@ -1927,7 +1948,7 @@ class AccountOptOut(PlexObject):
 
     def optOutManaged(self):
         """ Sets the Online Media Source to "Disabled for Managed Users".
-        
+
             Raises:
                 :exc:`~plexapi.exceptions.BadRequest`: When trying to opt out music.
         """
@@ -1964,3 +1985,42 @@ class UserState(PlexObject):
         self.viewOffset = utils.cast(int, data.attrib.get('viewOffset', 0))
         self.viewState = data.attrib.get('viewState') == 'complete'
         self.watchlistedAt = utils.toDatetime(data.attrib.get('watchlistedAt'))
+
+
+class GeoLocation(PlexObject):
+    """ Represents a signle IP address geolocation
+
+        Attributes:
+            TAG (str): location
+            city (str): City name
+            code (str): Country code
+            continentCode (str): Continent code
+            coordinates (Tuple<float>): Latitude and longitude
+            country (str): Country name
+            europeanUnionMember (bool): True if the country is a member of the European Union
+            inPrivacyRestrictedCountry (bool): True if the country is privacy restricted
+            postalCode (str): Postal code
+            subdivisions (str): Subdivision name
+            timezone (str): Timezone
+    """
+    TAG = 'location'
+
+    def _loadData(self, data):
+        self._data = data
+        self.city = data.attrib.get('city')
+        self.code = data.attrib.get('code')
+        self.continentCode = data.attrib.get('continent_code')
+        self.coordinates = tuple(
+            utils.cast(float, coord) for coord in (data.attrib.get('coordinates') or ',').split(','))
+        self.country = data.attrib.get('country')
+        self.postalCode = data.attrib.get('postal_code')
+        self.subdivisions = data.attrib.get('subdivisions')
+        self.timezone = data.attrib.get('time_zone')
+
+        europeanUnionMember = data.attrib.get('european_union_member')
+        self.europeanUnionMember = (
+            False if europeanUnionMember == 'Unknown' else utils.cast(bool, europeanUnionMember))
+
+        inPrivacyRestrictedCountry = data.attrib.get('in_privacy_restricted_country')
+        self.inPrivacyRestrictedCountry = (
+            False if inPrivacyRestrictedCountry == 'Unknown' else utils.cast(bool, inPrivacyRestrictedCountry))
diff --git a/lib/plexapi/photo.py b/lib/plexapi/photo.py
index 039ac80c..8737d814 100644
--- a/lib/plexapi/photo.py
+++ b/lib/plexapi/photo.py
@@ -1,5 +1,6 @@
 # -*- coding: utf-8 -*-
 import os
+from pathlib import Path
 from urllib.parse import quote_plus
 
 from plexapi import media, utils, video
@@ -139,6 +140,12 @@ class Photoalbum(
         """ Get the Plex Web URL with the correct parameters. """
         return self._server._buildWebURL(base=base, endpoint='details', key=self.key, legacy=1)
 
+    @property
+    def metadataDirectory(self):
+        """ Returns the Plex Media Server data directory where the metadata is stored. """
+        guid_hash = utils.sha1hash(self.guid)
+        return str(Path('Metadata') / 'Photos' / guid_hash[0] / f'{guid_hash[1:]}.bundle')
+
 
 @utils.registerPlexObject
 class Photo(
@@ -249,7 +256,7 @@ class Photo(
                 List<str> of file paths where the photo is found on disk.
         """
         return [part.file for item in self.media for part in item.parts if part]
-        
+
     def sync(self, resolution, client=None, clientId=None, limit=None, title=None):
         """ Add current photo as sync item for specified device.
             See :func:`~plexapi.myplex.MyPlexAccount.sync` for possible exceptions.
@@ -290,6 +297,12 @@ class Photo(
         """ Get the Plex Web URL with the correct parameters. """
         return self._server._buildWebURL(base=base, endpoint='details', key=self.parentKey, legacy=1)
 
+    @property
+    def metadataDirectory(self):
+        """ Returns the Plex Media Server data directory where the metadata is stored. """
+        guid_hash = utils.sha1hash(self.parentGuid)
+        return str(Path('Metadata') / 'Photos' / guid_hash[0] / f'{guid_hash[1:]}.bundle')
+
 
 @utils.registerPlexObject
 class PhotoSession(PlexSession, Photo):
diff --git a/lib/plexapi/playlist.py b/lib/plexapi/playlist.py
index c435613a..44073ee7 100644
--- a/lib/plexapi/playlist.py
+++ b/lib/plexapi/playlist.py
@@ -1,5 +1,6 @@
 # -*- coding: utf-8 -*-
 import re
+from pathlib import Path
 from urllib.parse import quote_plus, unquote
 
 from plexapi import media, utils
@@ -154,7 +155,7 @@ class Playlist(
                 sectionKey = int(match.group(1))
                 self._section = self._server.library.sectionByID(sectionKey)
                 return self._section
-        
+
             # Try to get the library section from the first item in the playlist
             if self.items():
                 self._section = self.items()[0].section()
@@ -313,7 +314,7 @@ class Playlist(
 
     def edit(self, title=None, summary=None):
         """ Edit the playlist.
-        
+
             Parameters:
                 title (str, optional): The title of the playlist.
                 summary (str, optional): The summary of the playlist.
@@ -431,7 +432,7 @@ class Playlist(
 
     def copyToUser(self, user):
         """ Copy playlist to another user account.
-        
+
             Parameters:
                 user (:class:`~plexapi.myplex.MyPlexUser` or str): `MyPlexUser` object, username,
                     email, or user id of the user to copy the playlist to.
@@ -496,3 +497,9 @@ class Playlist(
     def _getWebURL(self, base=None):
         """ Get the Plex Web URL with the correct parameters. """
         return self._server._buildWebURL(base=base, endpoint='playlist', key=self.key)
+
+    @property
+    def metadataDirectory(self):
+        """ Returns the Plex Media Server data directory where the metadata is stored. """
+        guid_hash = utils.sha1hash(self.guid)
+        return str(Path('Metadata') / 'Playlists' / guid_hash[0] / f'{guid_hash[1:]}.bundle')
diff --git a/lib/plexapi/server.py b/lib/plexapi/server.py
index 69d5f89a..52a203a8 100644
--- a/lib/plexapi/server.py
+++ b/lib/plexapi/server.py
@@ -109,7 +109,7 @@ class PlexServer(PlexObject):
         self._token = logfilter.add_secret(token or CONFIG.get('auth.server_token'))
         self._showSecrets = CONFIG.get('log.show_secrets', '').lower() == 'true'
         self._session = session or requests.Session()
-        self._timeout = timeout
+        self._timeout = timeout or TIMEOUT
         self._myPlexAccount = None   # cached myPlexAccount
         self._systemAccounts = None   # cached list of SystemAccount
         self._systemDevices = None   # cached list of SystemDevice
@@ -189,6 +189,11 @@ class PlexServer(PlexObject):
         data = self.query(Settings.key)
         return Settings(self, data)
 
+    def identity(self):
+        """ Returns the Plex server identity. """
+        data = self.query('/identity')
+        return Identity(self, data)
+
     def account(self):
         """ Returns the :class:`~plexapi.server.Account` object this server belongs to. """
         data = self.query(Account.key)
@@ -197,7 +202,7 @@ class PlexServer(PlexObject):
     def claim(self, account):
         """ Claim the Plex server using a :class:`~plexapi.myplex.MyPlexAccount`.
             This will only work with an unclaimed server on localhost or the same subnet.
-        
+
             Parameters:
                 account (:class:`~plexapi.myplex.MyPlexAccount`): The account used to
                     claim the server.
@@ -240,7 +245,7 @@ class PlexServer(PlexObject):
     def switchUser(self, user, session=None, timeout=None):
         """ Returns a new :class:`~plexapi.server.PlexServer` object logged in as the given username.
             Note: Only the admin account can switch to other users.
-        
+
             Parameters:
                 user (:class:`~plexapi.myplex.MyPlexUser` or str): `MyPlexUser` object, username,
                     email, or user id of the user to log in to the server.
@@ -585,7 +590,7 @@ class PlexServer(PlexObject):
     def runButlerTask(self, task):
         """ Manually run a butler task immediately instead of waiting for the scheduled task to run.
             Note: The butler task is run asynchronously. Check Plex Web to monitor activity.
-        
+
             Parameters:
                 task (str): The name of the task to run. (e.g. 'BackupDatabase')
 
@@ -597,7 +602,7 @@ class PlexServer(PlexObject):
                     print("Available butler tasks:", availableTasks)
 
         """
-        validTasks = [task.name for task in self.butlerTasks()]
+        validTasks = [_task.name for _task in self.butlerTasks()]
         if task not in validTasks:
             raise BadRequest(
                 f'Invalid butler task: {task}. Available tasks are: {validTasks}'
@@ -610,7 +615,8 @@ class PlexServer(PlexObject):
         return self.checkForUpdate(force=force, download=download)
 
     def checkForUpdate(self, force=True, download=False):
-        """ Returns a :class:`~plexapi.base.Release` object containing release info.
+        """ Returns a :class:`~plexapi.server.Release` object containing release info
+            if an update is available or None if no update is available.
 
             Parameters:
                 force (bool): Force server to check for new releases
@@ -624,12 +630,19 @@ class PlexServer(PlexObject):
             return releases[0]
 
     def isLatest(self):
-        """ Check if the installed version of PMS is the latest. """
+        """ Returns True if the installed version of Plex Media Server is the latest. """
         release = self.checkForUpdate(force=True)
         return release is None
 
+    def canInstallUpdate(self):
+        """ Returns True if the newest version of Plex Media Server can be installed automatically.
+            (e.g. Windows and Mac can install updates automatically, but Docker and NAS devices cannot.)
+        """
+        release = self.query('/updater/status')
+        return utils.cast(bool, release.get('canInstall'))
+
     def installUpdate(self):
-        """ Install the newest version of Plex Media Server. """
+        """ Automatically install the newest version of Plex Media Server. """
         # We can add this but dunno how useful this is since it sometimes
         # requires user action using a gui.
         part = '/updater/apply'
@@ -661,7 +674,7 @@ class PlexServer(PlexObject):
             args['librarySectionID'] = librarySectionID
         if mindate:
             args['viewedAt>'] = int(mindate.timestamp())
-        
+
         key = f'/status/sessions/history/all{utils.joinArgs(args)}'
         return self.fetchItems(key, maxresults=maxresults)
 
@@ -741,7 +754,7 @@ class PlexServer(PlexObject):
         """
         url = self.url(key)
         method = method or self._session.get
-        timeout = timeout or TIMEOUT
+        timeout = timeout or self._timeout
         log.debug('%s %s', method.__name__.upper(), url)
         headers = self._headers(**headers or {})
         response = method(url, headers=headers, timeout=timeout, **kwargs)
@@ -1253,7 +1266,7 @@ class StatisticsResources(PlexObject):
 @utils.registerPlexObject
 class ButlerTask(PlexObject):
     """ Represents a single scheduled butler task.
-    
+
         Attributes:
             TAG (str): 'ButlerTask'
             description (str): The description of the task.
@@ -1273,3 +1286,22 @@ class ButlerTask(PlexObject):
         self.name = data.attrib.get('name')
         self.scheduleRandomized = utils.cast(bool, data.attrib.get('scheduleRandomized'))
         self.title = data.attrib.get('title')
+
+
+class Identity(PlexObject):
+    """ Represents a server identity.
+
+        Attributes:
+            claimed (bool): True or False if the server is claimed.
+            machineIdentifier (str): The Plex server machine identifier.
+            version (str): The Plex server version.
+    """
+
+    def __repr__(self):
+        return f"<{self.__class__.__name__}:{self.machineIdentifier}>"
+
+    def _loadData(self, data):
+        self._data = data
+        self.claimed = utils.cast(bool, data.attrib.get('claimed'))
+        self.machineIdentifier = data.attrib.get('machineIdentifier')
+        self.version = data.attrib.get('version')
diff --git a/lib/plexapi/sync.py b/lib/plexapi/sync.py
index 66468c30..f57e89d9 100644
--- a/lib/plexapi/sync.py
+++ b/lib/plexapi/sync.py
@@ -23,7 +23,6 @@ you can set items to be synced to your app) you need to init some variables.
 You have to fake platform/device/model because transcoding profiles are hardcoded in Plex, and you obviously have
 to explicitly specify that your app supports `sync-target`.
 """
-
 import requests
 
 import plexapi
diff --git a/lib/plexapi/utils.py b/lib/plexapi/utils.py
index d1882fbb..8478f2d4 100644
--- a/lib/plexapi/utils.py
+++ b/lib/plexapi/utils.py
@@ -11,13 +11,14 @@ import unicodedata
 import warnings
 import zipfile
 from collections import deque
-from datetime import datetime
+from datetime import datetime, timedelta
 from getpass import getpass
+from hashlib import sha1
 from threading import Event, Thread
 from urllib.parse import quote
-from requests.status_codes import _codes as codes
 
 import requests
+from requests.status_codes import _codes as codes
 
 from plexapi.exceptions import BadRequest, NotFound, Unauthorized
 
@@ -313,33 +314,44 @@ def toDatetime(value, format=None):
             value (str): value to return as a datetime
             format (str): Format to pass strftime (optional; if value is a str).
     """
-    if value and value is not None:
+    if value is not None:
         if format:
             try:
-                value = datetime.strptime(value, format)
+                return datetime.strptime(value, format)
             except ValueError:
-                log.info('Failed to parse %s to datetime, defaulting to None', value)
+                log.info('Failed to parse "%s" to datetime as format "%s", defaulting to None', value, format)
                 return None
         else:
-            # https://bugs.python.org/issue30684
-            # And platform support for before epoch seems to be flaky.
-            # Also limit to max 32-bit integer
-            value = min(max(int(value), 86400), 2**31 - 1)
-            value = datetime.fromtimestamp(int(value))
+            try:
+                value = int(value)
+            except ValueError:
+                log.info('Failed to parse "%s" to datetime as timestamp, defaulting to None', value)
+                return None
+            try:
+                return datetime.fromtimestamp(value)
+            except (OSError, OverflowError):
+                try:
+                    return datetime.fromtimestamp(0) + timedelta(seconds=value)
+                except OverflowError:
+                    log.info('Failed to parse "%s" to datetime as timestamp (out-of-bounds), defaulting to None', value)
+                    return None
     return value
 
 
 def millisecondToHumanstr(milliseconds):
-    """ Returns human readable time duration from milliseconds.
-        HH:MM:SS:MMMM
+    """ Returns human readable time duration [D day[s], ]HH:MM:SS.UUU from milliseconds.
 
         Parameters:
-            milliseconds (str,int): time duration in milliseconds.
+            milliseconds (str, int): time duration in milliseconds.
     """
     milliseconds = int(milliseconds)
-    r = datetime.utcfromtimestamp(milliseconds / 1000)
-    f = r.strftime("%H:%M:%S.%f")
-    return f[:-2]
+    if milliseconds < 0:
+        return '-' + millisecondToHumanstr(abs(milliseconds))
+    secs, ms = divmod(milliseconds, 1000)
+    mins, secs = divmod(secs, 60)
+    hours, mins = divmod(mins, 60)
+    days, hours = divmod(hours, 24)
+    return ('' if days == 0 else f'{days} day{"s" if days > 1 else ""}, ') + f'{hours:02d}:{mins:02d}:{secs:02d}.{ms:03d}'
 
 
 def toList(value, itemcast=None, delim=','):
@@ -644,3 +656,8 @@ def openOrRead(file):
         return file.read()
     with open(file, 'rb') as f:
         return f.read()
+
+
+def sha1hash(guid):
+    """ Return the SHA1 hash of a guid. """
+    return sha1(guid.encode('utf-8')).hexdigest()
diff --git a/lib/plexapi/video.py b/lib/plexapi/video.py
index 486bb5ca..e95b12ff 100644
--- a/lib/plexapi/video.py
+++ b/lib/plexapi/video.py
@@ -1,5 +1,7 @@
 # -*- coding: utf-8 -*-
 import os
+from functools import cached_property
+from pathlib import Path
 from urllib.parse import quote_plus
 
 from plexapi import media, utils
@@ -445,6 +447,12 @@ class Movie(
         self._server.query(key, params=params, method=self._server._session.put)
         return self
 
+    @property
+    def metadataDirectory(self):
+        """ Returns the Plex Media Server data directory where the metadata is stored. """
+        guid_hash = utils.sha1hash(self.guid)
+        return str(Path('Metadata') / 'Movies' / guid_hash[0] / f'{guid_hash[1:]}.bundle')
+
 
 @utils.registerPlexObject
 class Show(
@@ -655,6 +663,12 @@ class Show(
             filepaths += episode.download(_savepath, keep_original_name, **kwargs)
         return filepaths
 
+    @property
+    def metadataDirectory(self):
+        """ Returns the Plex Media Server data directory where the metadata is stored. """
+        guid_hash = utils.sha1hash(self.guid)
+        return str(Path('Metadata') / 'TV Shows' / guid_hash[0] / f'{guid_hash[1:]}.bundle')
+
 
 @utils.registerPlexObject
 class Season(
@@ -663,7 +677,7 @@ class Season(
     ArtMixin, PosterMixin, ThemeUrlMixin,
     SeasonEditMixins
 ):
-    """ Represents a single Show Season (including all episodes).
+    """ Represents a single Season.
 
         Attributes:
             TAG (str): 'Directory'
@@ -808,6 +822,12 @@ class Season(
         """ Returns str, default title for a new syncItem. """
         return f'{self.parentTitle} - {self.title}'
 
+    @property
+    def metadataDirectory(self):
+        """ Returns the Plex Media Server data directory where the metadata is stored. """
+        guid_hash = utils.sha1hash(self.parentGuid)
+        return str(Path('Metadata') / 'TV Shows' / guid_hash[0] / f'{guid_hash[1:]}.bundle')
+
 
 @utils.registerPlexObject
 class Episode(
@@ -816,7 +836,7 @@ class Episode(
     ArtMixin, PosterMixin, ThemeUrlMixin,
     EpisodeEditMixins
 ):
-    """ Represents a single Shows Episode.
+    """ Represents a single Episode.
 
         Attributes:
             TAG (str): 'Video'
@@ -845,7 +865,7 @@ class Episode(
             parentGuid (str): Plex GUID for the season (plex://season/5d9c09e42df347001e3c2a72).
             parentIndex (int): Season number of episode.
             parentKey (str): API URL of the season (/library/metadata/<parentRatingKey>).
-            parentRatingKey (int): Unique key  identifying the season.
+            parentRatingKey (int): Unique key identifying the season.
             parentThumb (str): URL to season thumbnail image (/library/metadata/<parentRatingKey>/thumb/<thumbid>).
             parentTitle (str): Name of the season for the episode.
             parentYear (int): Year the season was released.
@@ -866,7 +886,6 @@ class Episode(
         """ Load attribute values from Plex XML response. """
         Video._loadData(self, data)
         Playable._loadData(self, data)
-        self._seasonNumber = None  # cached season number
         self.audienceRating = utils.cast(float, data.attrib.get('audienceRating'))
         self.audienceRatingImage = data.attrib.get('audienceRatingImage')
         self.chapters = self.findItems(data, media.Chapter)
@@ -890,9 +909,6 @@ class Episode(
         self.originallyAvailableAt = utils.toDatetime(data.attrib.get('originallyAvailableAt'), '%Y-%m-%d')
         self.parentGuid = data.attrib.get('parentGuid')
         self.parentIndex = utils.cast(int, data.attrib.get('parentIndex'))
-        self.parentKey = data.attrib.get('parentKey')
-        self.parentRatingKey = utils.cast(int, data.attrib.get('parentRatingKey'))
-        self.parentThumb = data.attrib.get('parentThumb')
         self.parentTitle = data.attrib.get('parentTitle')
         self.parentYear = utils.cast(int, data.attrib.get('parentYear'))
         self.producers = self.findItems(data, media.Producer)
@@ -906,15 +922,50 @@ class Episode(
 
         # If seasons are hidden, parentKey and parentRatingKey are missing from the XML response.
         # https://forums.plex.tv/t/parentratingkey-not-in-episode-xml-when-seasons-are-hidden/300553
-        if self.skipParent and data.attrib.get('parentRatingKey') is None:
-            # Parse the parentRatingKey from the parentThumb
-            if self.parentThumb and self.parentThumb.startswith('/library/metadata/'):
-                self.parentRatingKey = utils.cast(int, self.parentThumb.split('/')[3])
-            # Get the parentRatingKey from the season's ratingKey
-            if not self.parentRatingKey and self.grandparentRatingKey:
-                self.parentRatingKey = self.show().season(season=self.parentIndex).ratingKey
-            if self.parentRatingKey:
-                self.parentKey = f'/library/metadata/{self.parentRatingKey}'
+        # Use cached properties below to return the correct values if they are missing to avoid auto-reloading.
+        self._parentKey = data.attrib.get('parentKey')
+        self._parentRatingKey = utils.cast(int, data.attrib.get('parentRatingKey'))
+        self._parentThumb = data.attrib.get('parentThumb')
+
+    @cached_property
+    def parentKey(self):
+        """ Returns the parentKey. Refer to the Episode attributes. """
+        if self._parentKey:
+            return self._parentKey
+        if self.parentRatingKey:
+            return f'/library/metadata/{self.parentRatingKey}'
+        return None
+
+    @cached_property
+    def parentRatingKey(self):
+        """ Returns the parentRatingKey. Refer to the Episode attributes. """
+        if self._parentRatingKey is not None:
+            return self._parentRatingKey
+        # Parse the parentRatingKey from the parentThumb
+        if self._parentThumb and self._parentThumb.startswith('/library/metadata/'):
+            return utils.cast(int, self._parentThumb.split('/')[3])
+        # Get the parentRatingKey from the season's ratingKey if available
+        if self._season:
+            return self._season.ratingKey
+        return None
+
+    @cached_property
+    def parentThumb(self):
+        """ Returns the parentThumb. Refer to the Episode attributes. """
+        if self._parentThumb:
+            return self._parentThumb
+        if self._season:
+            return self._season.thumb
+        return None
+
+    @cached_property
+    def _season(self):
+        """ Returns the :class:`~plexapi.video.Season` object by querying for the show's children. """
+        if not self.grandparentKey:
+            return None
+        return self.fetchItem(
+            f'{self.grandparentKey}/children?excludeAllLeaves=1&index={self.parentIndex}'
+        )
 
     def __repr__(self):
         return '<{}>'.format(
@@ -949,12 +1000,10 @@ class Episode(
         """ Returns the episode number. """
         return self.index
 
-    @property
+    @cached_property
     def seasonNumber(self):
         """ Returns the episode's season number. """
-        if self._seasonNumber is None:
-            self._seasonNumber = self.parentIndex if isinstance(self.parentIndex, int) else self.season().seasonNumber
-        return utils.cast(int, self._seasonNumber)
+        return self.parentIndex if isinstance(self.parentIndex, int) else self._season.seasonNumber
 
     @property
     def seasonEpisode(self):
@@ -1000,6 +1049,12 @@ class Episode(
         self._server.query(key, params=params, method=self._server._session.put)
         return self
 
+    @property
+    def metadataDirectory(self):
+        """ Returns the Plex Media Server data directory where the metadata is stored. """
+        guid_hash = utils.sha1hash(self.grandparentGuid)
+        return str(Path('Metadata') / 'TV Shows' / guid_hash[0] / f'{guid_hash[1:]}.bundle')
+
 
 @utils.registerPlexObject
 class Clip(
@@ -1058,6 +1113,12 @@ class Clip(
         """ Returns a filename for use in download. """
         return self.title
 
+    @property
+    def metadataDirectory(self):
+        """ Returns the Plex Media Server data directory where the metadata is stored. """
+        guid_hash = utils.sha1hash(self.guid)
+        return str(Path('Metadata') / 'Movies' / guid_hash[0] / f'{guid_hash[1:]}.bundle')
+
 
 class Extra(Clip):
     """ Represents a single Extra (trailer, behindTheScenes, etc). """
diff --git a/requirements.txt b/requirements.txt
index 8ca67fe6..04578ef9 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -28,7 +28,7 @@ MarkupSafe==2.1.3
 musicbrainzngs==0.7.1
 packaging==23.1
 paho-mqtt==1.6.1
-plexapi==4.15.0
+plexapi==4.15.4
 portend==3.2.0
 profilehooks==1.12.0
 PyJWT==2.8.0

From a59e07c07d00fc12caf466b5bb71c1412d8eafa7 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 10 Oct 2023 14:23:26 -0700
Subject: [PATCH 472/743] Add metadataDirectory to exporter fields

---
 plexpy/exporter.py | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/plexpy/exporter.py b/plexpy/exporter.py
index e1dc989d..1232481c 100644
--- a/plexpy/exporter.py
+++ b/plexpy/exporter.py
@@ -371,6 +371,7 @@ class Export(object):
                         }
                     }
                 },
+                'metadataDirectory': None,
                 'originallyAvailableAt': partial(helpers.datetime_to_iso, to_date=True),
                 'originalTitle': None,
                 'producers': {
@@ -457,6 +458,7 @@ class Export(object):
                 'librarySectionKey': None,
                 'librarySectionTitle': None,
                 'locations': None,
+                'metadataDirectory': None,
                 'network': None,
                 'originallyAvailableAt': partial(helpers.datetime_to_iso, to_date=True),
                 'originalTitle': None,
@@ -523,6 +525,7 @@ class Export(object):
                 'librarySectionID': None,
                 'librarySectionKey': None,
                 'librarySectionTitle': None,
+                'metadataDirectory': None,
                 'parentGuid': None,
                 'parentIndex': None,
                 'parentKey': None,
@@ -769,6 +772,7 @@ class Export(object):
                         }
                     }
                 },
+                'metadataDirectory': None,
                 'originallyAvailableAt': partial(helpers.datetime_to_iso, to_date=True),
                 'parentGuid': None,
                 'parentIndex': None,
@@ -849,6 +853,7 @@ class Export(object):
                 'librarySectionKey': None,
                 'librarySectionTitle': None,
                 'locations': None,
+                'metadataDirectory': None,
                 'moods': {
                     'id': None,
                     'tag': None
@@ -918,6 +923,7 @@ class Export(object):
                 'librarySectionKey': None,
                 'librarySectionTitle': None,
                 'loudnessAnalysisVersion': None,
+                'metadataDirectory': None,
                 'moods': {
                     'id': None,
                     'tag': None
@@ -1087,6 +1093,7 @@ class Export(object):
                         }
                     }
                 },
+                'metadataDirectory': None,
                 'moods': {
                     'id': None,
                     'tag': None
@@ -1133,6 +1140,7 @@ class Export(object):
                 'librarySectionID': None,
                 'librarySectionKey': None,
                 'librarySectionTitle': None,
+                'metadataDirectory': None,
                 'ratingKey': None,
                 'summary': None,
                 'thumb': None,
@@ -1164,6 +1172,7 @@ class Export(object):
                 'librarySectionKey': None,
                 'librarySectionTitle': None,
                 'locations': None,
+                'metadataDirectory': None,
                 'originallyAvailableAt': partial(helpers.datetime_to_iso, to_date=True),
                 'parentGuid': None,
                 'parentIndex': None,
@@ -1238,6 +1247,7 @@ class Export(object):
                 'librarySectionKey': None,
                 'librarySectionTitle': None,
                 'maxYear': None,
+                'metadataDirectory': None,
                 'minYear': None,
                 'ratingKey': None,
                 'subtype': None,
@@ -1266,6 +1276,7 @@ class Export(object):
                 'icon': None,
                 'key': None,
                 'leafCount': None,
+                'metadataDirectory': None,
                 'playlistType': None,
                 'ratingKey': None,
                 'smart': None,

From b32183b7b6284508a60acd1a17f76a81c1b05738 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 10 Oct 2023 19:18:18 -0700
Subject: [PATCH 473/743] Speed up graphs data lookup

---
 plexpy/graphs.py  | 162 +++++++++++++++++++---------------------------
 plexpy/helpers.py |   4 +-
 2 files changed, 69 insertions(+), 97 deletions(-)

diff --git a/plexpy/graphs.py b/plexpy/graphs.py
index 82db9d82..7596e124 100644
--- a/plexpy/graphs.py
+++ b/plexpy/graphs.py
@@ -101,6 +101,8 @@ class Graphs(object):
             logger.warn("Tautulli Graphs :: Unable to execute database query for get_total_plays_per_day: %s." % e)
             return None
 
+        result_by_date_played = {item['date_played']: item for item in result}
+
         # create our date range as some days may not have any data
         # but we still want to display them
         base = datetime.date.today()
@@ -115,22 +117,13 @@ class Graphs(object):
         for date_item in sorted(date_list):
             date_string = date_item.strftime('%Y-%m-%d')
             categories.append(date_string)
-            series_1_value = 0
-            series_2_value = 0
-            series_3_value = 0
-            series_4_value = 0
-            for item in result:
-                if date_string == item['date_played']:
-                    series_1_value = item['tv_count']
-                    series_2_value = item['movie_count']
-                    series_3_value = item['music_count']
-                    series_4_value = item['live_count']
-                    break
-                else:
-                    series_1_value = 0
-                    series_2_value = 0
-                    series_3_value = 0
-                    series_4_value = 0
+
+            result_date = result_by_date_played.get(date_string, {})
+
+            series_1_value = result_date.get('tv_count', 0)
+            series_2_value = result_date.get('movie_count', 0)
+            series_3_value = result_date.get('music_count', 0)
+            series_4_value = result_date.get('live_count', 0)
 
             series_1.append(series_1_value)
             series_2.append(series_2_value)
@@ -233,6 +226,8 @@ class Graphs(object):
             logger.warn("Tautulli Graphs :: Unable to execute database query for get_total_plays_per_dayofweek: %s." % e)
             return None
 
+        result_by_dayofweek = {item['dayofweek']: item for item in result}
+
         if plexpy.CONFIG.WEEK_START_MONDAY:
             days_list = ['Monday', 'Tuesday', 'Wednesday',
                          'Thursday', 'Friday', 'Saturday', 'Sunday']
@@ -248,22 +243,13 @@ class Graphs(object):
 
         for day_item in days_list:
             categories.append(day_item)
-            series_1_value = 0
-            series_2_value = 0
-            series_3_value = 0
-            series_4_value = 0
-            for item in result:
-                if day_item == item['dayofweek']:
-                    series_1_value = item['tv_count']
-                    series_2_value = item['movie_count']
-                    series_3_value = item['music_count']
-                    series_4_value = item['live_count']
-                    break
-                else:
-                    series_1_value = 0
-                    series_2_value = 0
-                    series_3_value = 0
-                    series_4_value = 0
+
+            result_day = result_by_dayofweek.get(day_item, {})
+
+            series_1_value = result_day.get('tv_count', 0)
+            series_2_value = result_day.get('movie_count', 0)
+            series_3_value = result_day.get('music_count', 0)
+            series_4_value = result_day.get('live_count', 0)
 
             series_1.append(series_1_value)
             series_2.append(series_2_value)
@@ -350,6 +336,8 @@ class Graphs(object):
             logger.warn("Tautulli Graphs :: Unable to execute database query for get_total_plays_per_hourofday: %s." % e)
             return None
 
+        result_by_hourofday = {item['hourofday']: item for item in result}
+
         hours_list = ['00', '01', '02', '03', '04', '05',
                       '06', '07', '08', '09', '10', '11',
                       '12', '13', '14', '15', '16', '17',
@@ -363,22 +351,13 @@ class Graphs(object):
 
         for hour_item in hours_list:
             categories.append(hour_item)
-            series_1_value = 0
-            series_2_value = 0
-            series_3_value = 0
-            series_4_value = 0
-            for item in result:
-                if hour_item == item['hourofday']:
-                    series_1_value = item['tv_count']
-                    series_2_value = item['movie_count']
-                    series_3_value = item['music_count']
-                    series_4_value = item['live_count']
-                    break
-                else:
-                    series_1_value = 0
-                    series_2_value = 0
-                    series_3_value = 0
-                    series_4_value = 0
+
+            result_hour = result_by_hourofday.get(hour_item, {})
+
+            series_1_value = result_hour.get('tv_count', 0)
+            series_2_value = result_hour.get('movie_count', 0)
+            series_3_value = result_hour.get('music_count', 0)
+            series_4_value = result_hour.get('live_count', 0)
 
             series_1.append(series_1_value)
             series_2.append(series_2_value)
@@ -465,6 +444,8 @@ class Graphs(object):
             logger.warn("Tautulli Graphs :: Unable to execute database query for get_total_plays_per_month: %s." % e)
             return None
 
+        result_by_datestring = {item['datestring']: item for item in result}
+
         # create our date range as some months may not have any data
         # but we still want to display them
         dt_today = datetime.date.today()
@@ -486,22 +467,13 @@ class Graphs(object):
         for dt in sorted(month_range):
             date_string = dt.strftime('%Y-%m')
             categories.append(dt.strftime('%b %Y'))
-            series_1_value = 0
-            series_2_value = 0
-            series_3_value = 0
-            series_4_value = 0
-            for item in result:
-                if date_string == item['datestring']:
-                    series_1_value = item['tv_count']
-                    series_2_value = item['movie_count']
-                    series_3_value = item['music_count']
-                    series_4_value = item['live_count']
-                    break
-                else:
-                    series_1_value = 0
-                    series_2_value = 0
-                    series_3_value = 0
-                    series_4_value = 0
+
+            result_date = result_by_datestring.get(date_string, {})
+
+            series_1_value = result_date.get('tv_count', 0)
+            series_2_value = result_date.get('movie_count', 0)
+            series_3_value = result_date.get('music_count', 0)
+            series_4_value = result_date.get('live_count', 0)
 
             series_1.append(series_1_value)
             series_2.append(series_2_value)
@@ -598,6 +570,7 @@ class Graphs(object):
 
         for item in result:
             categories.append(common.PLATFORM_NAME_OVERRIDES.get(item['platform'], item['platform']))
+
             series_1.append(item['tv_count'])
             series_2.append(item['movie_count'])
             series_3.append(item['music_count'])
@@ -704,6 +677,7 @@ class Graphs(object):
                 categories.append(item['username'] if str(item['user_id']) == session_user_id else 'Plex User')
             else:
                 categories.append(item['friendly_name'])
+
             series_1.append(item['tv_count'])
             series_2.append(item['movie_count'])
             series_3.append(item['music_count'])
@@ -783,6 +757,8 @@ class Graphs(object):
             logger.warn("Tautulli Graphs :: Unable to execute database query for get_total_plays_per_stream_type: %s." % e)
             return None
 
+        result_by_date_played = {item['date_played']: item for item in result}
+
         # create our date range as some days may not have any data
         # but we still want to display them
         base = datetime.date.today()
@@ -796,19 +772,12 @@ class Graphs(object):
         for date_item in sorted(date_list):
             date_string = date_item.strftime('%Y-%m-%d')
             categories.append(date_string)
-            series_1_value = 0
-            series_2_value = 0
-            series_3_value = 0
-            for item in result:
-                if date_string == item['date_played']:
-                    series_1_value = item['dp_count']
-                    series_2_value = item['ds_count']
-                    series_3_value = item['tc_count']
-                    break
-                else:
-                    series_1_value = 0
-                    series_2_value = 0
-                    series_3_value = 0
+
+            result_date = result_by_date_played.get(date_string, {})
+
+            series_1_value = result_date.get('dp_count', 0)
+            series_2_value = result_date.get('ds_count', 0)
+            series_3_value = result_date.get('tc_count', 0)
 
             series_1.append(series_1_value)
             series_2.append(series_2_value)
@@ -869,6 +838,9 @@ class Graphs(object):
             logger.warn("Tautulli Graphs :: Unable to execute database query for get_total_plays_per_stream_type: %s." % e)
             return None
 
+        result_by_date_and_decision = helpers.group_by_keys(result, ('date_played', 'transcode_decision'))
+        result_by_date = helpers.group_by_keys(result, 'date_played')
+
         # create our date range as some days may not have any data
         # but we still want to display them
         base = datetime.date.today()
@@ -880,29 +852,23 @@ class Graphs(object):
         series_3 = []
         series_4 = []
 
-        grouped_result_by_stream_type = helpers.group_by_keys(result, ('date_played','transcode_decision'))
-        grouped_result_by_day = helpers.group_by_keys(result, ['date_played'])
-
         for date_item in sorted(date_list):
             date_string = date_item.strftime('%Y-%m-%d')
             categories.append(date_string)
-            series_1_value = 0
-            series_2_value = 0
-            series_3_value = 0
-            series_4_value = 0
 
-            for item in grouped_result_by_stream_type:
-                if item['key'] == (date_string,'direct play'):
-                    series_1_value = calc_most_concurrent(item['value'])
-                elif item['key'] == (date_string,'copy'):
-                    series_2_value = calc_most_concurrent(item['value'])
-                elif item['key'] == (date_string,'transcode'):
-                    series_3_value = calc_most_concurrent(item['value'])
+            series_1_value = calc_most_concurrent(
+                result_by_date_and_decision.get((date_string, 'direct play'), [])
+            )
+            series_2_value = calc_most_concurrent(
+                result_by_date_and_decision.get((date_string, 'copy'), [])
+            )
+            series_3_value = calc_most_concurrent(
+                result_by_date_and_decision.get((date_string, 'transcode'), [])
+            )
+            series_4_value = calc_most_concurrent(
+                result_by_date.get(date_string, [])
+            )
 
-            for item in grouped_result_by_day:
-                if item['key'] == date_string:
-                    series_4_value = calc_most_concurrent(item['value'])
-            
             series_1.append(series_1_value)
             series_2.append(series_2_value)
             series_3.append(series_3_value)
@@ -983,6 +949,7 @@ class Graphs(object):
 
         for item in result:
             categories.append(item['resolution'])
+
             series_1.append(item['dp_count'])
             series_2.append(item['ds_count'])
             series_3.append(item['tc_count'])
@@ -1086,6 +1053,7 @@ class Graphs(object):
 
         for item in result:
             categories.append(item['resolution'])
+
             series_1.append(item['dp_count'])
             series_2.append(item['ds_count'])
             series_3.append(item['tc_count'])
@@ -1161,6 +1129,7 @@ class Graphs(object):
 
         for item in result:
             categories.append(common.PLATFORM_NAME_OVERRIDES.get(item['platform'], item['platform']))
+
             series_1.append(item['dp_count'])
             series_2.append(item['ds_count'])
             series_3.append(item['tc_count'])
@@ -1248,6 +1217,7 @@ class Graphs(object):
                 categories.append(item['username'] if str(item['user_id']) == session_user_id else 'Plex User')
             else:
                 categories.append(item['friendly_name'])
+
             series_1.append(item['dp_count'])
             series_2.append(item['ds_count'])
             series_3.append(item['tc_count'])
@@ -1275,5 +1245,5 @@ class Graphs(object):
         elif user_id:
             user_ids = helpers.split_strip(user_id)
             if all(id.isdigit() for id in user_ids):
-                user_cond =cond_prefix + ' session_history.user_id IN (%s) ' % ','.join(user_ids)
+                user_cond = cond_prefix + ' session_history.user_id IN (%s) ' % ','.join(user_ids)
         return user_cond
diff --git a/plexpy/helpers.py b/plexpy/helpers.py
index 4512f0b6..e8056eb4 100644
--- a/plexpy/helpers.py
+++ b/plexpy/helpers.py
@@ -1242,11 +1242,13 @@ def grouper(iterable, n, fillvalue=None):
     args = [iter(iterable)] * n
     return zip_longest(fillvalue=fillvalue, *args)
 
+
 def group_by_keys(iterable, keys):
     key_function = operator.itemgetter(*keys)
 
     sorted_iterable = sorted(iterable, key=key_function)
-    return[{'key': key, 'value': list(group)} for key, group in groupby(sorted_iterable, key_function)]
+    return {key: list(group) for key, group in groupby(sorted_iterable, key_function)}
+
 
 def chunk(it, size):
     it = iter(it)

From d8d1f75605fdc1679890837395af4a80d16beee1 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 10 Oct 2023 19:32:30 -0700
Subject: [PATCH 474/743] Use group_by_keys helper for library stats

---
 plexpy/datafactory.py | 3 +--
 plexpy/helpers.py     | 4 +++-
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/plexpy/datafactory.py b/plexpy/datafactory.py
index bd5a7c31..0937480d 100644
--- a/plexpy/datafactory.py
+++ b/plexpy/datafactory.py
@@ -22,7 +22,6 @@ from future.builtins import str
 from future.builtins import object
 
 import json
-from itertools import groupby
 
 import plexpy
 if plexpy.PYTHON2:
@@ -1187,7 +1186,7 @@ class DataFactory(object):
             library_stats.append(library)
 
         library_stats = session.mask_session_info(library_stats)
-        library_stats = {k: list(v) for k, v in groupby(library_stats, key=lambda x: x['section_type'])}
+        library_stats = helpers.group_by_keys(library_stats, 'section_type')
 
         return library_stats
 
diff --git a/plexpy/helpers.py b/plexpy/helpers.py
index e8056eb4..25850a16 100644
--- a/plexpy/helpers.py
+++ b/plexpy/helpers.py
@@ -1244,8 +1244,10 @@ def grouper(iterable, n, fillvalue=None):
 
 
 def group_by_keys(iterable, keys):
-    key_function = operator.itemgetter(*keys)
+    if not isinstance(keys, (list, tuple)):
+        keys = [keys]
 
+    key_function = operator.itemgetter(*keys)
     sorted_iterable = sorted(iterable, key=key_function)
     return {key: list(group) for key, group in groupby(sorted_iterable, key_function)}
 

From 7245e97726ea6b8ff0427a7b794d32e595c305d8 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 10 Oct 2023 21:27:13 -0700
Subject: [PATCH 475/743] Fix concurrent streams graph query

---
 plexpy/graphs.py | 15 ++++++++-------
 1 file changed, 8 insertions(+), 7 deletions(-)

diff --git a/plexpy/graphs.py b/plexpy/graphs.py
index 7596e124..8758f71f 100644
--- a/plexpy/graphs.py
+++ b/plexpy/graphs.py
@@ -825,13 +825,14 @@ class Graphs(object):
             return final_count
 
         try:
-            query = 'SELECT sh.date_played, sh.started, sh.stopped, shmi.transcode_decision ' \
-                    'FROM (SELECT *, ' \
-                        'date(started, "unixepoch", "localtime") AS date_played ' \
-                        'FROM session_history %s) AS sh ' \
-                    'JOIN session_history_media_info AS shmi ON sh.id = shmi.id ' \
-                    'WHERE sh.stopped >= %s ' \
-                    'ORDER BY sh.date_played' % (user_cond, timestamp)
+            query = "SELECT sh.date_played, sh.started, sh.stopped, shmi.transcode_decision " \
+                    "FROM (SELECT *, " \
+                        "date(started, 'unixepoch', 'localtime') AS date_played " \
+                        "FROM session_history %s " \
+                        "GROUP BY id) AS sh " \
+                    "JOIN session_history_media_info AS shmi ON sh.id = shmi.id " \
+                    "WHERE sh.stopped >= %s " \
+                    "ORDER BY sh.started" % (user_cond, timestamp)
 
             result = monitor_db.select(query)
         except Exception as e:

From efdd4156d89b14a7418ae40c104631b0e7de8d09 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 16 Oct 2023 15:04:19 -0700
Subject: [PATCH 476/743] Update IP helper function

---
 plexpy/helpers.py | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/plexpy/helpers.py b/plexpy/helpers.py
index 25850a16..486be759 100644
--- a/plexpy/helpers.py
+++ b/plexpy/helpers.py
@@ -1194,18 +1194,20 @@ def get_plexpy_url(hostname=None):
         scheme = 'http'
 
     if hostname is None and plexpy.CONFIG.HTTP_HOST in ('0.0.0.0', '::'):
-        import socket
+        # Only returns IPv4 address
+        s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
+        s.setsockopt(socket.SOL_SOCKET, socket.SO_BROADCAST, 1)
+        s.settimeout(0)
         try:
-            # Only returns IPv4 address
-            s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
-            s.setsockopt(socket.SOL_SOCKET, socket.SO_BROADCAST, 1)
-            s.connect(('<broadcast>', 0))
+            s.connect(('<broadcast>', 1))
             hostname = s.getsockname()[0]
         except socket.error:
             try:
                 hostname = socket.gethostbyname(socket.gethostname())
             except socket.gaierror:
                 pass
+        finally:
+            s.close()
 
         if not hostname:
             hostname = 'localhost'

From 1e4fc05ecfddb6e710afe05e5e55cca6b78799c4 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 17 Oct 2023 11:23:04 -0700
Subject: [PATCH 477/743] Add ping method to refresh token

---
 plexpy/plextv.py | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/plexpy/plextv.py b/plexpy/plextv.py
index 8bab1d51..d3afb26a 100644
--- a/plexpy/plextv.py
+++ b/plexpy/plextv.py
@@ -80,6 +80,7 @@ def get_server_resources(return_presence=False, return_server=False, return_info
                                                          port=server['pms_port'])
 
     plex_tv = PlexTV()
+    plex_tv.ping()
     result = plex_tv.get_server_connections(pms_identifier=server['pms_identifier'],
                                             pms_ip=server['pms_ip'],
                                             pms_port=server['pms_port'],
@@ -347,6 +348,13 @@ class PlexTV(object):
 
         return request
 
+    def ping_plextv(self, output_format=''):
+        uri = '/api/v2/ping'
+        request = self.request_handler.make_request(uri=uri,
+                                                    request_type='GET',
+                                                    output_format=output_format)
+        return request
+
     def get_full_users_list(self):
         own_account = self.get_plextv_user_details(output_format='xml')
         friends_list = self.get_plextv_friends(output_format='xml')
@@ -950,3 +958,18 @@ class PlexTV(object):
                         }
 
             return geo_info
+
+    def ping(self):
+        logger.info(u"Tautulli PlexTV :: Pinging Plex.tv to refresh token.")
+
+        pong = self.ping_plextv(output_format='xml')
+
+        try:
+            xml_head = pong.getElementsByTagName('pong')
+        except Exception as e:
+            logger.warn(u"Tautulli PlexTV :: Unable to parse XML for ping: %s." % e)
+            return None
+        
+        if xml_head:
+            return helpers.bool_true(xml_head[0].firstChild.nodeValue)
+        return False

From a31dcb5508cde585a096c0df4a27611bc39f5856 Mon Sep 17 00:00:00 2001
From: herby2212 <12448284+herby2212@users.noreply.github.com>
Date: Tue, 24 Oct 2023 00:51:35 +0200
Subject: [PATCH 478/743] Quater values for History Watch Status (#2179)

* initial release

* change fillup orientation to clockwise

* fix indentation for css

* fix 50 percent circle orientation

* optimize colors and padding
---
 data/interfaces/default/css/tautulli.css      | 128 +++++++++++-------
 .../default/js/tables/history_table.js        |  12 +-
 plexpy/datafactory.py                         |  10 +-
 3 files changed, 92 insertions(+), 58 deletions(-)

diff --git a/data/interfaces/default/css/tautulli.css b/data/interfaces/default/css/tautulli.css
index 8cad039f..0c81f0e5 100644
--- a/data/interfaces/default/css/tautulli.css
+++ b/data/interfaces/default/css/tautulli.css
@@ -338,20 +338,20 @@ object {
 }
 .btn-dark:focus,
 .btn-dark.focus {
-  color: #d7d7d7;
-  background-color: #3B3B3B;
+    color: #d7d7d7;
+    background-color: #3B3B3B;
 }
 .btn-dark:hover {
-  color: #eee;
-  background-color: #333;
-  border-color: #444;
+    color: #eee;
+    background-color: #333;
+    border-color: #444;
 }
 .btn-dark:active,
 .btn-dark.active,
 .open > .dropdown-toggle.btn-dark {
-  color: #eee;
-  background-color: #333;
-  border-color: #444;
+    color: #eee;
+    background-color: #333;
+    border-color: #444;
 }
 .btn-dark:active:hover,
 .btn-dark.active:hover,
@@ -362,13 +362,13 @@ object {
 .btn-dark:active.focus,
 .btn-dark.active.focus,
 .open > .dropdown-toggle.btn-dark.focus {
-  color: #eee;
-  background-color: #333;
+    color: #eee;
+    background-color: #333;
 }
 .btn-dark:active,
 .btn-dark.active,
 .open > .dropdown-toggle.btn-dark {
-  background-image: none;
+    background-image: none;
 }
 .btn-dark.disabled,
 .btn-dark[disabled],
@@ -388,8 +388,8 @@ fieldset[disabled] .btn-dark:active,
 .btn-dark.disabled.active,
 .btn-dark[disabled].active,
 fieldset[disabled] .btn-dark.active {
-  background-color: #333;
-  color: #aaa;
+    background-color: #333;
+    color: #aaa;
 }
 .btn-dark.inactive:hover {
     color: #d7d7d7;
@@ -398,30 +398,30 @@ fieldset[disabled] .btn-dark.active {
     cursor: default;
 }
 .btn-dark .badge {
-  color: #e5e5e5;
-  background-color: #3B3B3B;
+    color: #e5e5e5;
+    background-color: #3B3B3B;
 }
 .btn-bright {
-  color: #eee;
-  background-color: #cc7b19;
-  box-shadow: inset 0 1px 0 #e7993b;
+    color: #eee;
+    background-color: #cc7b19;
+    box-shadow: inset 0 1px 0 #e7993b;
 }
 .btn-bright:focus,
 .btn-bright.focus {
-  color: #eee;
-  background-color: #eb8600;
+    color: #eee;
+    background-color: #eb8600;
 }
 .btn-bright:hover {
-  color: #eee;
-  background-color: #e59029;
-  box-shadow: inset 0 1px 0 #ebac60;
+    color: #eee;
+    background-color: #e59029;
+    box-shadow: inset 0 1px 0 #ebac60;
 }
 .btn-bright:active,
 .btn-bright.active,
 .open > .dropdown-toggle.btn-bright {
-  color: #eee;
-  background-color: #cc7b19;
-  box-shadow: inset 0 1px 0 #e7993b;
+    color: #eee;
+    background-color: #cc7b19;
+    box-shadow: inset 0 1px 0 #e7993b;
 }
 .btn-bright:active:hover,
 .btn-bright.active:hover,
@@ -432,14 +432,14 @@ fieldset[disabled] .btn-dark.active {
 .btn-bright:active.focus,
 .btn-bright.active.focus,
 .open > .dropdown-toggle.btn-bright.focus {
-  color: #eee;
-  background-color: #cc7b19;
-  box-shadow: inset 0 1px 0 #e7993b;
+    color: #eee;
+    background-color: #cc7b19;
+    box-shadow: inset 0 1px 0 #e7993b;
 }
 .btn-bright:active,
 .btn-bright.active,
 .open > .dropdown-toggle.btn-bright {
-  background-image: none;
+    background-image: none;
 }
 .btn-bright.disabled,
 .btn-bright[disabled],
@@ -459,13 +459,13 @@ fieldset[disabled] .btn-bright:active,
 .btn-bright.disabled.active,
 .btn-bright[disabled].active,
 fieldset[disabled] .btn-bright.active {
-  background-color: #cc7b19;
-  border-color: #b56d16;
+    background-color: #cc7b19;
+    border-color: #b56d16;
 }
 .btn-bright .badge {
-  color: #eee;
-  background-color: #cc7b19;
-  box-shadow: inset 0 1px 0 #e7993b;
+    color: #eee;
+    background-color: #cc7b19;
+    box-shadow: inset 0 1px 0 #e7993b;
 }
 .btn-danger.btn-edit {
     color: #d7d7d7;
@@ -479,14 +479,14 @@ fieldset[disabled] .btn-bright.active {
     border-color: #ac2925;
 }
 .btn-danger.btn-edit.active {
-  color: #eee;
-  background-color: #c9302c;
-  border-color: #ac2925;
+    color: #eee;
+    background-color: #c9302c;
+    border-color: #ac2925;
 }
 .btn-danger.btn-edit.active:hover {
-  color: #eee;
-  background-color: #ac2925;
-  border-color: #761c19;
+    color: #eee;
+    background-color: #ac2925;
+    border-color: #761c19;
 }
 .btn-group select {
     margin-top: 0;
@@ -667,12 +667,12 @@ textarea.form-control:focus {
     white-space: nowrap;
     vertical-align: middle;
     -ms-touch-action: manipulation;
-      touch-action: manipulation;
+    touch-action: manipulation;
     cursor: pointer;
     -webkit-user-select: none;
-     -moz-user-select: none;
-      -ms-user-select: none;
-          user-select: none;
+    -moz-user-select: none;
+    -ms-user-select: none;
+    user-select: none;
     background-image: none;
     background-color: #3B3B3B;
     color: #e5e5e5;
@@ -690,10 +690,10 @@ textarea.form-control:focus {
 }
 .btn-filter.active,
 .btn-filter.active.focus {
-  background-color: #b7800a !important;
+    background-color: #b7800a !important;
 }
 .btn-filter.active:hover {
-  background-color: #896007 !important;
+    background-color: #896007 !important;
 }
 .form-control-feedback {
     color: #E5A00D;
@@ -1281,7 +1281,7 @@ a .dashboard-activity-metadata-user-thumb:hover {
     -webkit-backface-visibility: hidden;
     backface-visibility: hidden;
     z-index: 1;
-   -webkit-border-radius: 50%;
+    -webkit-border-radius: 50%;
     -moz-border-radius: 50%;
     border-radius: 350%;
     overflow: hidden;
@@ -2203,8 +2203,8 @@ span.settings-warning {
     padding-left: 10px;
 }
 #menu_link_show_advanced_settings.active {
-  color: #eee;
-  background-color: #cc7b19;
+    color: #eee;
+    background-color: #cc7b19;
 }
 #configUpdate .form-group,
 #configUpdate .checkbox{
@@ -2854,6 +2854,30 @@ a .home-platforms-list-cover-face:hover
     overflow: hidden;
     max-width: 350px;
 }
+.circle {
+    width: 1.55rem;
+    height: 1.55rem;
+    border-radius: 50%;
+    border: 0.2rem solid #eeeeee;
+}
+.circle-quarter {
+    background-image:
+    linear-gradient(00deg, #2b2b2b 50%, transparent 50%),
+    linear-gradient(270deg, #eeeeee 50%, transparent 50%);
+}
+.circle-half {
+    background-image:
+    linear-gradient(90deg, #2b2b2b 50%, transparent 50%),
+    linear-gradient(-90deg, #eeeeee 50%, transparent 50%);
+    }
+.circle-three-quarter {
+    background-image:
+    linear-gradient(180deg, transparent 50%, #eeeeee 50%),
+    linear-gradient(-90deg, #eeeeee 50%, transparent 50%);
+}
+.circle-full {
+    background: #eeeeee;
+}
 #graph-tabs {
     padding-bottom: 10px;
     float: none;
@@ -2991,8 +3015,8 @@ a .home-platforms-list-cover-face:hover
     border-left: 2px solid #444;
     border-top: 1px solid #2d2d2d;
     -webkit-transition: all 0.3s ease;
-      -o-transition: all 0.3s ease;
-      transition: all 0.3s ease;
+    -o-transition: all 0.3s ease;
+    transition: all 0.3s ease;
 }
 .stacked-configs > li > span:hover,
 .stacked-configs > li > span:focus {
diff --git a/data/interfaces/default/js/tables/history_table.js b/data/interfaces/default/js/tables/history_table.js
index d209f90e..7f9d578f 100644
--- a/data/interfaces/default/js/tables/history_table.js
+++ b/data/interfaces/default/js/tables/history_table.js
@@ -263,13 +263,17 @@ history_table_options = {
             "targets": [12],
             "data": "watched_status",
             "createdCell": function (td, cellData, rowData, row, col) {
+                var circleValue = "";
                 if (cellData == 1) {
-                    $(td).html('<span class="watched-tooltip" data-toggle="tooltip" title="' + rowData['percent_complete'] + '%"><i class="fa fa-lg fa-circle"></i></span>');
+                    circleValue = " circle-full";
+                } else if (cellData == 0.75) {
+                    circleValue = " circle-three-quarter";
                 } else if (cellData == 0.5) {
-                    $(td).html('<span class="watched-tooltip" data-toggle="tooltip" title="' + rowData['percent_complete'] + '%"><i class="fa fa-lg fa-adjust fa-rotate-180"></i></span>');
-                } else {
-                    $(td).html('<span class="watched-tooltip" data-toggle="tooltip" title="' + rowData['percent_complete'] + '%"><i class="fa fa-lg fa-circle-o"></i></span>');
+                    circleValue = " circle-half";
+                } else if (cellData == 0.25) {
+                    circleValue = " circle-quarter";
                 }
+                $(td).html('<span class="watched-tooltip" data-toggle="tooltip" title="' + rowData['percent_complete'] + '%"><div class="circle' + circleValue + '" /></span>');
             },
             "searchable": false,
             "orderable": false,
diff --git a/plexpy/datafactory.py b/plexpy/datafactory.py
index 0937480d..de3ed030 100644
--- a/plexpy/datafactory.py
+++ b/plexpy/datafactory.py
@@ -281,13 +281,19 @@ class DataFactory(object):
             if item['live']:
                 item['percent_complete'] = 100
 
+            base_watched_value = watched_percent[item['media_type']] / 4.0
+
             if helpers.check_watched(
                 item['media_type'], item['view_offset'], item['duration'],
                 item['marker_credits_first'], item['marker_credits_final']
             ):
                 watched_status = 1
-            elif item['percent_complete'] >= watched_percent[item['media_type']] / 2.0:
-                watched_status = 0.5
+            elif item['percent_complete'] >= base_watched_value * 3.0:
+                watched_status = 0.75
+            elif item['percent_complete'] >= base_watched_value * 2.0:
+                watched_status = 0.50
+            elif item['percent_complete'] >= base_watched_value:
+                watched_status = 0.25
             else:
                 watched_status = 0
 

From ab16adcffc77a2629663674cf83ec056f9832d42 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 23 Oct 2023 16:04:29 -0700
Subject: [PATCH 479/743] Add link from concurrent stream stats card to graphs
 page

---
 data/interfaces/default/graphs.html     | 8 ++++++--
 data/interfaces/default/home_stats.html | 4 +++-
 2 files changed, 9 insertions(+), 3 deletions(-)

diff --git a/data/interfaces/default/graphs.html b/data/interfaces/default/graphs.html
index 7cd0c98b..15a96a69 100644
--- a/data/interfaces/default/graphs.html
+++ b/data/interfaces/default/graphs.html
@@ -137,7 +137,7 @@
                         </div>
                     </div>
                 </div>
-                <div class="row">
+                <div class="row" id="concurrent-graph">
                     <div class="col-md-12">
                         <h4><i class="fa fa-video-camera"></i> Daily concurrent stream count</span> by stream type <small>Last <span class="days">30</span> days</small></h4>
                         <p class="help-block">
@@ -372,6 +372,10 @@
                 break
         }
 
+        if (window.location.hash === '#concurrent-graph') {
+            current_tab = '#tabs-stream';
+        }
+
         $('#yaxis-' + yaxis).prop('checked', true);
         $('#yaxis-' + yaxis).closest('label').addClass('active');
         $('#graph-days').val(current_day_range);
@@ -639,7 +643,7 @@
                 }
             });
 
-            $('#nav-tabs-2').tab('show');
+            $('#nav-tabs-stream').tab('show');
         }
 
         function loadGraphsTab3(time_range, yaxis) {
diff --git a/data/interfaces/default/home_stats.html b/data/interfaces/default/home_stats.html
index d66dd1d4..3e1e118c 100644
--- a/data/interfaces/default/home_stats.html
+++ b/data/interfaces/default/home_stats.html
@@ -177,7 +177,9 @@ DOCUMENTATION :: END
                                     % elif stat_id == 'top_platforms':
                                     ${row['platform']}
                                     % elif stat_id == 'most_concurrent':
-                                    ${row['title']}
+                                    <a href="graphs#concurrent-graph" title="${row['title']}">
+                                        ${row['title']}
+                                    </a>
                                     % endif
                                 </div>
                                 <div class="sub-count">

From 98583d139ac4207604fd728f3d591c2a79cb4636 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 26 Oct 2023 09:05:47 -0700
Subject: [PATCH 480/743] Add config override for PMS_LANGUAGE

---
 plexpy/config.py       | 1 +
 plexpy/http_handler.py | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/plexpy/config.py b/plexpy/config.py
index 6f2926d9..dbcd294d 100644
--- a/plexpy/config.py
+++ b/plexpy/config.py
@@ -55,6 +55,7 @@ _CONFIG_DEFINITIONS = {
     'PMS_IP': (str, 'PMS', '127.0.0.1'),
     'PMS_IS_CLOUD': (int, 'PMS', 0),
     'PMS_IS_REMOTE': (int, 'PMS', 0),
+    'PMS_LANGUAGE': (str, 'PMS', ''),
     'PMS_LOGS_FOLDER': (str, 'PMS', ''),
     'PMS_LOGS_LINE_CAP': (int, 'PMS', 1000),
     'PMS_NAME': (str, 'PMS', ''),
diff --git a/plexpy/http_handler.py b/plexpy/http_handler.py
index 87c4cff5..79bb3562 100644
--- a/plexpy/http_handler.py
+++ b/plexpy/http_handler.py
@@ -62,7 +62,7 @@ class HTTPHandler(object):
                                                 plexpy.common.PLATFORM_RELEASE),
                 'X-Plex-Device-Name': '{} ({})'.format(plexpy.common.PLATFORM_DEVICE_NAME,
                                                        plexpy.common.PRODUCT),
-                'Accept-Language': plexpy.SYS_LANGUAGE
+                'X-Plex-Language': plexpy.CONFIG.PMS_LANGUAGE or plexpy.SYS_LANGUAGE
             }
 
         self.token = token

From d63c0cb469375537ddb713368a1e89dde41072ad Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 26 Oct 2023 09:24:48 -0700
Subject: [PATCH 481/743] Guard against None transcode_key

---
 plexpy/activity_handler.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/plexpy/activity_handler.py b/plexpy/activity_handler.py
index 7bfbe8fb..32f835c3 100644
--- a/plexpy/activity_handler.py
+++ b/plexpy/activity_handler.py
@@ -310,7 +310,9 @@ class ActivityHandler(object):
         last_state = self.db_session['state']
         last_rating_key = str(self.db_session['rating_key'])
         last_live_uuid = self.db_session['live_uuid']
-        last_transcode_key = self.db_session['transcode_key'].split('/')[-1]
+        last_transcode_key = self.db_session['transcode_key']
+        if isinstance(last_transcode_key, str):
+            last_transcode_key = last_transcode_key.split('/')[-1]
         last_paused = self.db_session['last_paused']
         last_rating_key_websocket = self.db_session['rating_key_websocket']
         last_guid = self.db_session['guid']

From c215afbf84baafb1a2020c2dc6e36944a6de1504 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 26 Oct 2023 09:27:31 -0700
Subject: [PATCH 482/743] v2.13.2

---
 CHANGELOG.md      | 14 ++++++++++++++
 plexpy/version.py |  2 +-
 2 files changed, 15 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 1266e43f..d5eb4c5a 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,19 @@
 # Changelog
 
+## v2.13.2 (2023-10-26)
+* History:
+  * New: Added quarter values icons for history watch status. (#2179, #2156) (Thanks @herby2212)
+* Graphs:
+  * New: Added concurrent streams per day graph. (#2046) (Thanks @herby2212)
+* Exporter:
+  * New: Added metadata directory to exporter fields.
+  * Removed: Banner exporter fields for tv shows.
+* UI:
+  * New: Added last triggered time to notification agents and newsletter agent lists.
+* Other:
+  * New: Added X-Plex-Language header override to config file.
+
+
 ## v2.13.1 (2023-08-25)
 * Notes:
   * Support for Python 3.7 has been dropped. The minimum Python version is now 3.8.
diff --git a/plexpy/version.py b/plexpy/version.py
index c5ee1521..5ca70297 100644
--- a/plexpy/version.py
+++ b/plexpy/version.py
@@ -18,4 +18,4 @@
 from __future__ import unicode_literals
 
 PLEXPY_BRANCH = "master"
-PLEXPY_RELEASE_VERSION = "v2.13.1"
\ No newline at end of file
+PLEXPY_RELEASE_VERSION = "v2.13.2"
\ No newline at end of file

From dd380b583f67ad112f99057da4518a3df9c7ff74 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 26 Oct 2023 11:05:34 -0700
Subject: [PATCH 483/743] Add system language to startup logs

---
 plexpy/__init__.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/plexpy/__init__.py b/plexpy/__init__.py
index eb1f73c2..2590c867 100644
--- a/plexpy/__init__.py
+++ b/plexpy/__init__.py
@@ -239,6 +239,9 @@ def initialize(config_file):
         logger.info("{} (UTC{})".format(
             str(SYS_TIMEZONE), SYS_UTC_OFFSET
         ))
+        logger.info("Language {}{} / Encoding {}".format(
+            SYS_LANGUAGE, f' (override {CONFIG.PMS_LANGUAGE})' if CONFIG.PMS_LANGUAGE else '', SYS_ENCODING
+        ))
         logger.info("Python {}".format(
             sys.version.replace('\n', '')
         ))

From 32cf26884b4dcc7fa1aa26260d99689b922deedd Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 26 Oct 2023 11:05:51 -0700
Subject: [PATCH 484/743] Add system language and sqlite version to
 configuration table

---
 data/interfaces/default/configuration_table.html | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/data/interfaces/default/configuration_table.html b/data/interfaces/default/configuration_table.html
index 676876d6..66d8ef40 100644
--- a/data/interfaces/default/configuration_table.html
+++ b/data/interfaces/default/configuration_table.html
@@ -11,6 +11,7 @@ DOCUMENTATION :: END
 
 <%!
     import os
+    import sqlite3
     import sys
     import plexpy
     from plexpy import common, logger
@@ -71,10 +72,18 @@ DOCUMENTATION :: END
             <td>System Timezone:</td>
             <td>${str(plexpy.SYS_TIMEZONE)} (${'UTC{}'.format(plexpy.SYS_UTC_OFFSET)})
         </tr>
+        <tr>
+            <td>System Language:</td>
+            <td>${plexpy.SYS_LANGUAGE + (' (override {})'.format(plexpy.CONFIG.PMS_LANGUAGE) if plexpy.CONFIG.PMS_LANGUAGE else '')}</td>
+        </tr>
         <tr>
             <td>Python Version:</td>
             <td>${sys.version}</td>
         </tr>
+        <tr>
+            <td>SQLite Version:</td>
+            <td>${sqlite3.sqlite_version}</td>
+        </tr>
         <tr>
             <td class="top-line">Resources:</td>
             <td class="top-line">

From f1c12c0bbe0a8364bd1c3a3822291dc52f806bfb Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 4 Nov 2023 13:29:40 -0700
Subject: [PATCH 485/743] Switch appdirs to platformdirs

---
 Tautulli.py                  |   4 +-
 lib/appdirs.py               | 608 ---------------------------------
 lib/platformdirs/__init__.py | 628 +++++++++++++++++++++++++++++++++++
 lib/platformdirs/__main__.py |  54 +++
 lib/platformdirs/android.py  | 220 ++++++++++++
 lib/platformdirs/api.py      | 243 ++++++++++++++
 lib/platformdirs/macos.py    | 126 +++++++
 lib/platformdirs/py.typed    |   0
 lib/platformdirs/unix.py     | 251 ++++++++++++++
 lib/platformdirs/version.py  |  16 +
 lib/platformdirs/windows.py  | 266 +++++++++++++++
 requirements.txt             |   2 +-
 12 files changed, 1807 insertions(+), 611 deletions(-)
 delete mode 100644 lib/appdirs.py
 create mode 100644 lib/platformdirs/__init__.py
 create mode 100644 lib/platformdirs/__main__.py
 create mode 100644 lib/platformdirs/android.py
 create mode 100644 lib/platformdirs/api.py
 create mode 100644 lib/platformdirs/macos.py
 create mode 100644 lib/platformdirs/py.typed
 create mode 100644 lib/platformdirs/unix.py
 create mode 100644 lib/platformdirs/version.py
 create mode 100644 lib/platformdirs/windows.py

diff --git a/Tautulli.py b/Tautulli.py
index eebfa55a..04a6778e 100755
--- a/Tautulli.py
+++ b/Tautulli.py
@@ -25,10 +25,10 @@ sys.path.insert(0, os.path.join(os.path.dirname(os.path.abspath(__file__)), 'lib
 
 from future.builtins import str
 
-import appdirs
 import argparse
 import datetime
 import locale
+import platformdirs
 import pytz
 import signal
 import shutil
@@ -186,7 +186,7 @@ def main():
     if args.datadir:
         plexpy.DATA_DIR = args.datadir
     elif plexpy.FROZEN:
-        plexpy.DATA_DIR = appdirs.user_data_dir("Tautulli", False)
+        plexpy.DATA_DIR = platformdirs.user_data_dir("Tautulli", False)
     else:
         plexpy.DATA_DIR = plexpy.PROG_DIR
 
diff --git a/lib/appdirs.py b/lib/appdirs.py
deleted file mode 100644
index 2acd1deb..00000000
--- a/lib/appdirs.py
+++ /dev/null
@@ -1,608 +0,0 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
-# Copyright (c) 2005-2010 ActiveState Software Inc.
-# Copyright (c) 2013 Eddy Petrișor
-
-"""Utilities for determining application-specific dirs.
-
-See <http://github.com/ActiveState/appdirs> for details and usage.
-"""
-# Dev Notes:
-# - MSDN on where to store app data files:
-#   http://support.microsoft.com/default.aspx?scid=kb;en-us;310294#XSLTH3194121123120121120120
-# - Mac OS X: http://developer.apple.com/documentation/MacOSX/Conceptual/BPFileSystem/index.html
-# - XDG spec for Un*x: http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html
-
-__version__ = "1.4.4"
-__version_info__ = tuple(int(segment) for segment in __version__.split("."))
-
-
-import sys
-import os
-
-PY3 = sys.version_info[0] == 3
-
-if PY3:
-    unicode = str
-
-if sys.platform.startswith('java'):
-    import platform
-    os_name = platform.java_ver()[3][0]
-    if os_name.startswith('Windows'): # "Windows XP", "Windows 7", etc.
-        system = 'win32'
-    elif os_name.startswith('Mac'): # "Mac OS X", etc.
-        system = 'darwin'
-    else: # "Linux", "SunOS", "FreeBSD", etc.
-        # Setting this to "linux2" is not ideal, but only Windows or Mac
-        # are actually checked for and the rest of the module expects
-        # *sys.platform* style strings.
-        system = 'linux2'
-else:
-    system = sys.platform
-
-
-
-def user_data_dir(appname=None, appauthor=None, version=None, roaming=False):
-    r"""Return full path to the user-specific data dir for this application.
-
-        "appname" is the name of application.
-            If None, just the system directory is returned.
-        "appauthor" (only used on Windows) is the name of the
-            appauthor or distributing body for this application. Typically
-            it is the owning company name. This falls back to appname. You may
-            pass False to disable it.
-        "version" is an optional version path element to append to the
-            path. You might want to use this if you want multiple versions
-            of your app to be able to run independently. If used, this
-            would typically be "<major>.<minor>".
-            Only applied when appname is present.
-        "roaming" (boolean, default False) can be set True to use the Windows
-            roaming appdata directory. That means that for users on a Windows
-            network setup for roaming profiles, this user data will be
-            sync'd on login. See
-            <http://technet.microsoft.com/en-us/library/cc766489(WS.10).aspx>
-            for a discussion of issues.
-
-    Typical user data directories are:
-        Mac OS X:               ~/Library/Application Support/<AppName>
-        Unix:                   ~/.local/share/<AppName>    # or in $XDG_DATA_HOME, if defined
-        Win XP (not roaming):   C:\Documents and Settings\<username>\Application Data\<AppAuthor>\<AppName>
-        Win XP (roaming):       C:\Documents and Settings\<username>\Local Settings\Application Data\<AppAuthor>\<AppName>
-        Win 7  (not roaming):   C:\Users\<username>\AppData\Local\<AppAuthor>\<AppName>
-        Win 7  (roaming):       C:\Users\<username>\AppData\Roaming\<AppAuthor>\<AppName>
-
-    For Unix, we follow the XDG spec and support $XDG_DATA_HOME.
-    That means, by default "~/.local/share/<AppName>".
-    """
-    if system == "win32":
-        if appauthor is None:
-            appauthor = appname
-        const = roaming and "CSIDL_APPDATA" or "CSIDL_LOCAL_APPDATA"
-        path = os.path.normpath(_get_win_folder(const))
-        if appname:
-            if appauthor is not False:
-                path = os.path.join(path, appauthor, appname)
-            else:
-                path = os.path.join(path, appname)
-    elif system == 'darwin':
-        path = os.path.expanduser('~/Library/Application Support/')
-        if appname:
-            path = os.path.join(path, appname)
-    else:
-        path = os.getenv('XDG_DATA_HOME', os.path.expanduser("~/.local/share"))
-        if appname:
-            path = os.path.join(path, appname)
-    if appname and version:
-        path = os.path.join(path, version)
-    return path
-
-
-def site_data_dir(appname=None, appauthor=None, version=None, multipath=False):
-    r"""Return full path to the user-shared data dir for this application.
-
-        "appname" is the name of application.
-            If None, just the system directory is returned.
-        "appauthor" (only used on Windows) is the name of the
-            appauthor or distributing body for this application. Typically
-            it is the owning company name. This falls back to appname. You may
-            pass False to disable it.
-        "version" is an optional version path element to append to the
-            path. You might want to use this if you want multiple versions
-            of your app to be able to run independently. If used, this
-            would typically be "<major>.<minor>".
-            Only applied when appname is present.
-        "multipath" is an optional parameter only applicable to *nix
-            which indicates that the entire list of data dirs should be
-            returned. By default, the first item from XDG_DATA_DIRS is
-            returned, or '/usr/local/share/<AppName>',
-            if XDG_DATA_DIRS is not set
-
-    Typical site data directories are:
-        Mac OS X:   /Library/Application Support/<AppName>
-        Unix:       /usr/local/share/<AppName> or /usr/share/<AppName>
-        Win XP:     C:\Documents and Settings\All Users\Application Data\<AppAuthor>\<AppName>
-        Vista:      (Fail! "C:\ProgramData" is a hidden *system* directory on Vista.)
-        Win 7:      C:\ProgramData\<AppAuthor>\<AppName>   # Hidden, but writeable on Win 7.
-
-    For Unix, this is using the $XDG_DATA_DIRS[0] default.
-
-    WARNING: Do not use this on Windows. See the Vista-Fail note above for why.
-    """
-    if system == "win32":
-        if appauthor is None:
-            appauthor = appname
-        path = os.path.normpath(_get_win_folder("CSIDL_COMMON_APPDATA"))
-        if appname:
-            if appauthor is not False:
-                path = os.path.join(path, appauthor, appname)
-            else:
-                path = os.path.join(path, appname)
-    elif system == 'darwin':
-        path = os.path.expanduser('/Library/Application Support')
-        if appname:
-            path = os.path.join(path, appname)
-    else:
-        # XDG default for $XDG_DATA_DIRS
-        # only first, if multipath is False
-        path = os.getenv('XDG_DATA_DIRS',
-                         os.pathsep.join(['/usr/local/share', '/usr/share']))
-        pathlist = [os.path.expanduser(x.rstrip(os.sep)) for x in path.split(os.pathsep)]
-        if appname:
-            if version:
-                appname = os.path.join(appname, version)
-            pathlist = [os.sep.join([x, appname]) for x in pathlist]
-
-        if multipath:
-            path = os.pathsep.join(pathlist)
-        else:
-            path = pathlist[0]
-        return path
-
-    if appname and version:
-        path = os.path.join(path, version)
-    return path
-
-
-def user_config_dir(appname=None, appauthor=None, version=None, roaming=False):
-    r"""Return full path to the user-specific config dir for this application.
-
-        "appname" is the name of application.
-            If None, just the system directory is returned.
-        "appauthor" (only used on Windows) is the name of the
-            appauthor or distributing body for this application. Typically
-            it is the owning company name. This falls back to appname. You may
-            pass False to disable it.
-        "version" is an optional version path element to append to the
-            path. You might want to use this if you want multiple versions
-            of your app to be able to run independently. If used, this
-            would typically be "<major>.<minor>".
-            Only applied when appname is present.
-        "roaming" (boolean, default False) can be set True to use the Windows
-            roaming appdata directory. That means that for users on a Windows
-            network setup for roaming profiles, this user data will be
-            sync'd on login. See
-            <http://technet.microsoft.com/en-us/library/cc766489(WS.10).aspx>
-            for a discussion of issues.
-
-    Typical user config directories are:
-        Mac OS X:               same as user_data_dir
-        Unix:                   ~/.config/<AppName>     # or in $XDG_CONFIG_HOME, if defined
-        Win *:                  same as user_data_dir
-
-    For Unix, we follow the XDG spec and support $XDG_CONFIG_HOME.
-    That means, by default "~/.config/<AppName>".
-    """
-    if system in ["win32", "darwin"]:
-        path = user_data_dir(appname, appauthor, None, roaming)
-    else:
-        path = os.getenv('XDG_CONFIG_HOME', os.path.expanduser("~/.config"))
-        if appname:
-            path = os.path.join(path, appname)
-    if appname and version:
-        path = os.path.join(path, version)
-    return path
-
-
-def site_config_dir(appname=None, appauthor=None, version=None, multipath=False):
-    r"""Return full path to the user-shared data dir for this application.
-
-        "appname" is the name of application.
-            If None, just the system directory is returned.
-        "appauthor" (only used on Windows) is the name of the
-            appauthor or distributing body for this application. Typically
-            it is the owning company name. This falls back to appname. You may
-            pass False to disable it.
-        "version" is an optional version path element to append to the
-            path. You might want to use this if you want multiple versions
-            of your app to be able to run independently. If used, this
-            would typically be "<major>.<minor>".
-            Only applied when appname is present.
-        "multipath" is an optional parameter only applicable to *nix
-            which indicates that the entire list of config dirs should be
-            returned. By default, the first item from XDG_CONFIG_DIRS is
-            returned, or '/etc/xdg/<AppName>', if XDG_CONFIG_DIRS is not set
-
-    Typical site config directories are:
-        Mac OS X:   same as site_data_dir
-        Unix:       /etc/xdg/<AppName> or $XDG_CONFIG_DIRS[i]/<AppName> for each value in
-                    $XDG_CONFIG_DIRS
-        Win *:      same as site_data_dir
-        Vista:      (Fail! "C:\ProgramData" is a hidden *system* directory on Vista.)
-
-    For Unix, this is using the $XDG_CONFIG_DIRS[0] default, if multipath=False
-
-    WARNING: Do not use this on Windows. See the Vista-Fail note above for why.
-    """
-    if system in ["win32", "darwin"]:
-        path = site_data_dir(appname, appauthor)
-        if appname and version:
-            path = os.path.join(path, version)
-    else:
-        # XDG default for $XDG_CONFIG_DIRS
-        # only first, if multipath is False
-        path = os.getenv('XDG_CONFIG_DIRS', '/etc/xdg')
-        pathlist = [os.path.expanduser(x.rstrip(os.sep)) for x in path.split(os.pathsep)]
-        if appname:
-            if version:
-                appname = os.path.join(appname, version)
-            pathlist = [os.sep.join([x, appname]) for x in pathlist]
-
-        if multipath:
-            path = os.pathsep.join(pathlist)
-        else:
-            path = pathlist[0]
-    return path
-
-
-def user_cache_dir(appname=None, appauthor=None, version=None, opinion=True):
-    r"""Return full path to the user-specific cache dir for this application.
-
-        "appname" is the name of application.
-            If None, just the system directory is returned.
-        "appauthor" (only used on Windows) is the name of the
-            appauthor or distributing body for this application. Typically
-            it is the owning company name. This falls back to appname. You may
-            pass False to disable it.
-        "version" is an optional version path element to append to the
-            path. You might want to use this if you want multiple versions
-            of your app to be able to run independently. If used, this
-            would typically be "<major>.<minor>".
-            Only applied when appname is present.
-        "opinion" (boolean) can be False to disable the appending of
-            "Cache" to the base app data dir for Windows. See
-            discussion below.
-
-    Typical user cache directories are:
-        Mac OS X:   ~/Library/Caches/<AppName>
-        Unix:       ~/.cache/<AppName> (XDG default)
-        Win XP:     C:\Documents and Settings\<username>\Local Settings\Application Data\<AppAuthor>\<AppName>\Cache
-        Vista:      C:\Users\<username>\AppData\Local\<AppAuthor>\<AppName>\Cache
-
-    On Windows the only suggestion in the MSDN docs is that local settings go in
-    the `CSIDL_LOCAL_APPDATA` directory. This is identical to the non-roaming
-    app data dir (the default returned by `user_data_dir` above). Apps typically
-    put cache data somewhere *under* the given dir here. Some examples:
-        ...\Mozilla\Firefox\Profiles\<ProfileName>\Cache
-        ...\Acme\SuperApp\Cache\1.0
-    OPINION: This function appends "Cache" to the `CSIDL_LOCAL_APPDATA` value.
-    This can be disabled with the `opinion=False` option.
-    """
-    if system == "win32":
-        if appauthor is None:
-            appauthor = appname
-        path = os.path.normpath(_get_win_folder("CSIDL_LOCAL_APPDATA"))
-        if appname:
-            if appauthor is not False:
-                path = os.path.join(path, appauthor, appname)
-            else:
-                path = os.path.join(path, appname)
-            if opinion:
-                path = os.path.join(path, "Cache")
-    elif system == 'darwin':
-        path = os.path.expanduser('~/Library/Caches')
-        if appname:
-            path = os.path.join(path, appname)
-    else:
-        path = os.getenv('XDG_CACHE_HOME', os.path.expanduser('~/.cache'))
-        if appname:
-            path = os.path.join(path, appname)
-    if appname and version:
-        path = os.path.join(path, version)
-    return path
-
-
-def user_state_dir(appname=None, appauthor=None, version=None, roaming=False):
-    r"""Return full path to the user-specific state dir for this application.
-
-        "appname" is the name of application.
-            If None, just the system directory is returned.
-        "appauthor" (only used on Windows) is the name of the
-            appauthor or distributing body for this application. Typically
-            it is the owning company name. This falls back to appname. You may
-            pass False to disable it.
-        "version" is an optional version path element to append to the
-            path. You might want to use this if you want multiple versions
-            of your app to be able to run independently. If used, this
-            would typically be "<major>.<minor>".
-            Only applied when appname is present.
-        "roaming" (boolean, default False) can be set True to use the Windows
-            roaming appdata directory. That means that for users on a Windows
-            network setup for roaming profiles, this user data will be
-            sync'd on login. See
-            <http://technet.microsoft.com/en-us/library/cc766489(WS.10).aspx>
-            for a discussion of issues.
-
-    Typical user state directories are:
-        Mac OS X:  same as user_data_dir
-        Unix:      ~/.local/state/<AppName>   # or in $XDG_STATE_HOME, if defined
-        Win *:     same as user_data_dir
-
-    For Unix, we follow this Debian proposal <https://wiki.debian.org/XDGBaseDirectorySpecification#state>
-    to extend the XDG spec and support $XDG_STATE_HOME.
-
-    That means, by default "~/.local/state/<AppName>".
-    """
-    if system in ["win32", "darwin"]:
-        path = user_data_dir(appname, appauthor, None, roaming)
-    else:
-        path = os.getenv('XDG_STATE_HOME', os.path.expanduser("~/.local/state"))
-        if appname:
-            path = os.path.join(path, appname)
-    if appname and version:
-        path = os.path.join(path, version)
-    return path
-
-
-def user_log_dir(appname=None, appauthor=None, version=None, opinion=True):
-    r"""Return full path to the user-specific log dir for this application.
-
-        "appname" is the name of application.
-            If None, just the system directory is returned.
-        "appauthor" (only used on Windows) is the name of the
-            appauthor or distributing body for this application. Typically
-            it is the owning company name. This falls back to appname. You may
-            pass False to disable it.
-        "version" is an optional version path element to append to the
-            path. You might want to use this if you want multiple versions
-            of your app to be able to run independently. If used, this
-            would typically be "<major>.<minor>".
-            Only applied when appname is present.
-        "opinion" (boolean) can be False to disable the appending of
-            "Logs" to the base app data dir for Windows, and "log" to the
-            base cache dir for Unix. See discussion below.
-
-    Typical user log directories are:
-        Mac OS X:   ~/Library/Logs/<AppName>
-        Unix:       ~/.cache/<AppName>/log  # or under $XDG_CACHE_HOME if defined
-        Win XP:     C:\Documents and Settings\<username>\Local Settings\Application Data\<AppAuthor>\<AppName>\Logs
-        Vista:      C:\Users\<username>\AppData\Local\<AppAuthor>\<AppName>\Logs
-
-    On Windows the only suggestion in the MSDN docs is that local settings
-    go in the `CSIDL_LOCAL_APPDATA` directory. (Note: I'm interested in
-    examples of what some windows apps use for a logs dir.)
-
-    OPINION: This function appends "Logs" to the `CSIDL_LOCAL_APPDATA`
-    value for Windows and appends "log" to the user cache dir for Unix.
-    This can be disabled with the `opinion=False` option.
-    """
-    if system == "darwin":
-        path = os.path.join(
-            os.path.expanduser('~/Library/Logs'),
-            appname)
-    elif system == "win32":
-        path = user_data_dir(appname, appauthor, version)
-        version = False
-        if opinion:
-            path = os.path.join(path, "Logs")
-    else:
-        path = user_cache_dir(appname, appauthor, version)
-        version = False
-        if opinion:
-            path = os.path.join(path, "log")
-    if appname and version:
-        path = os.path.join(path, version)
-    return path
-
-
-class AppDirs(object):
-    """Convenience wrapper for getting application dirs."""
-    def __init__(self, appname=None, appauthor=None, version=None,
-            roaming=False, multipath=False):
-        self.appname = appname
-        self.appauthor = appauthor
-        self.version = version
-        self.roaming = roaming
-        self.multipath = multipath
-
-    @property
-    def user_data_dir(self):
-        return user_data_dir(self.appname, self.appauthor,
-                             version=self.version, roaming=self.roaming)
-
-    @property
-    def site_data_dir(self):
-        return site_data_dir(self.appname, self.appauthor,
-                             version=self.version, multipath=self.multipath)
-
-    @property
-    def user_config_dir(self):
-        return user_config_dir(self.appname, self.appauthor,
-                               version=self.version, roaming=self.roaming)
-
-    @property
-    def site_config_dir(self):
-        return site_config_dir(self.appname, self.appauthor,
-                             version=self.version, multipath=self.multipath)
-
-    @property
-    def user_cache_dir(self):
-        return user_cache_dir(self.appname, self.appauthor,
-                              version=self.version)
-
-    @property
-    def user_state_dir(self):
-        return user_state_dir(self.appname, self.appauthor,
-                              version=self.version)
-
-    @property
-    def user_log_dir(self):
-        return user_log_dir(self.appname, self.appauthor,
-                            version=self.version)
-
-
-#---- internal support stuff
-
-def _get_win_folder_from_registry(csidl_name):
-    """This is a fallback technique at best. I'm not sure if using the
-    registry for this guarantees us the correct answer for all CSIDL_*
-    names.
-    """
-    if PY3:
-      import winreg as _winreg
-    else:
-      import _winreg
-
-    shell_folder_name = {
-        "CSIDL_APPDATA": "AppData",
-        "CSIDL_COMMON_APPDATA": "Common AppData",
-        "CSIDL_LOCAL_APPDATA": "Local AppData",
-    }[csidl_name]
-
-    key = _winreg.OpenKey(
-        _winreg.HKEY_CURRENT_USER,
-        r"Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders"
-    )
-    dir, type = _winreg.QueryValueEx(key, shell_folder_name)
-    return dir
-
-
-def _get_win_folder_with_pywin32(csidl_name):
-    from win32com.shell import shellcon, shell
-    dir = shell.SHGetFolderPath(0, getattr(shellcon, csidl_name), 0, 0)
-    # Try to make this a unicode path because SHGetFolderPath does
-    # not return unicode strings when there is unicode data in the
-    # path.
-    try:
-        dir = unicode(dir)
-
-        # Downgrade to short path name if have highbit chars. See
-        # <http://bugs.activestate.com/show_bug.cgi?id=85099>.
-        has_high_char = False
-        for c in dir:
-            if ord(c) > 255:
-                has_high_char = True
-                break
-        if has_high_char:
-            try:
-                import win32api
-                dir = win32api.GetShortPathName(dir)
-            except ImportError:
-                pass
-    except UnicodeError:
-        pass
-    return dir
-
-
-def _get_win_folder_with_ctypes(csidl_name):
-    import ctypes
-
-    csidl_const = {
-        "CSIDL_APPDATA": 26,
-        "CSIDL_COMMON_APPDATA": 35,
-        "CSIDL_LOCAL_APPDATA": 28,
-    }[csidl_name]
-
-    buf = ctypes.create_unicode_buffer(1024)
-    ctypes.windll.shell32.SHGetFolderPathW(None, csidl_const, None, 0, buf)
-
-    # Downgrade to short path name if have highbit chars. See
-    # <http://bugs.activestate.com/show_bug.cgi?id=85099>.
-    has_high_char = False
-    for c in buf:
-        if ord(c) > 255:
-            has_high_char = True
-            break
-    if has_high_char:
-        buf2 = ctypes.create_unicode_buffer(1024)
-        if ctypes.windll.kernel32.GetShortPathNameW(buf.value, buf2, 1024):
-            buf = buf2
-
-    return buf.value
-
-def _get_win_folder_with_jna(csidl_name):
-    import array
-    from com.sun import jna
-    from com.sun.jna.platform import win32
-
-    buf_size = win32.WinDef.MAX_PATH * 2
-    buf = array.zeros('c', buf_size)
-    shell = win32.Shell32.INSTANCE
-    shell.SHGetFolderPath(None, getattr(win32.ShlObj, csidl_name), None, win32.ShlObj.SHGFP_TYPE_CURRENT, buf)
-    dir = jna.Native.toString(buf.tostring()).rstrip("\0")
-
-    # Downgrade to short path name if have highbit chars. See
-    # <http://bugs.activestate.com/show_bug.cgi?id=85099>.
-    has_high_char = False
-    for c in dir:
-        if ord(c) > 255:
-            has_high_char = True
-            break
-    if has_high_char:
-        buf = array.zeros('c', buf_size)
-        kernel = win32.Kernel32.INSTANCE
-        if kernel.GetShortPathName(dir, buf, buf_size):
-            dir = jna.Native.toString(buf.tostring()).rstrip("\0")
-
-    return dir
-
-if system == "win32":
-    try:
-        import win32com.shell
-        _get_win_folder = _get_win_folder_with_pywin32
-    except ImportError:
-        try:
-            from ctypes import windll
-            _get_win_folder = _get_win_folder_with_ctypes
-        except ImportError:
-            try:
-                import com.sun.jna
-                _get_win_folder = _get_win_folder_with_jna
-            except ImportError:
-                _get_win_folder = _get_win_folder_from_registry
-
-
-#---- self test code
-
-if __name__ == "__main__":
-    appname = "MyApp"
-    appauthor = "MyCompany"
-
-    props = ("user_data_dir",
-             "user_config_dir",
-             "user_cache_dir",
-             "user_state_dir",
-             "user_log_dir",
-             "site_data_dir",
-             "site_config_dir")
-
-    print("-- app dirs %s --" % __version__)
-
-    print("-- app dirs (with optional 'version')")
-    dirs = AppDirs(appname, appauthor, version="1.0")
-    for prop in props:
-        print("%s: %s" % (prop, getattr(dirs, prop)))
-
-    print("\n-- app dirs (without optional 'version')")
-    dirs = AppDirs(appname, appauthor)
-    for prop in props:
-        print("%s: %s" % (prop, getattr(dirs, prop)))
-
-    print("\n-- app dirs (without optional 'appauthor')")
-    dirs = AppDirs(appname)
-    for prop in props:
-        print("%s: %s" % (prop, getattr(dirs, prop)))
-
-    print("\n-- app dirs (with disabled 'appauthor')")
-    dirs = AppDirs(appname, appauthor=False)
-    for prop in props:
-        print("%s: %s" % (prop, getattr(dirs, prop)))
diff --git a/lib/platformdirs/__init__.py b/lib/platformdirs/__init__.py
new file mode 100644
index 00000000..3d5a5bda
--- /dev/null
+++ b/lib/platformdirs/__init__.py
@@ -0,0 +1,628 @@
+"""
+Utilities for determining application-specific dirs. See <https://github.com/platformdirs/platformdirs> for details and
+usage.
+"""
+from __future__ import annotations
+
+import os
+import sys
+from typing import TYPE_CHECKING
+
+from .api import PlatformDirsABC
+from .version import __version__
+from .version import __version_tuple__ as __version_info__
+
+if TYPE_CHECKING:
+    from pathlib import Path
+
+    if sys.version_info >= (3, 8):  # pragma: no cover (py38+)
+        from typing import Literal
+    else:  # pragma: no cover (py38+)
+        from typing_extensions import Literal
+
+
+def _set_platform_dir_class() -> type[PlatformDirsABC]:
+    if sys.platform == "win32":
+        from platformdirs.windows import Windows as Result
+    elif sys.platform == "darwin":
+        from platformdirs.macos import MacOS as Result
+    else:
+        from platformdirs.unix import Unix as Result
+
+    if os.getenv("ANDROID_DATA") == "/data" and os.getenv("ANDROID_ROOT") == "/system":
+        if os.getenv("SHELL") or os.getenv("PREFIX"):
+            return Result
+
+        from platformdirs.android import _android_folder
+
+        if _android_folder() is not None:
+            from platformdirs.android import Android
+
+            return Android  # return to avoid redefinition of result
+
+    return Result
+
+
+PlatformDirs = _set_platform_dir_class()  #: Currently active platform
+AppDirs = PlatformDirs  #: Backwards compatibility with appdirs
+
+
+def user_data_dir(
+    appname: str | None = None,
+    appauthor: str | None | Literal[False] = None,
+    version: str | None = None,
+    roaming: bool = False,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> str:
+    """
+    :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
+    :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
+    :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
+    :param roaming: See `roaming <platformdirs.api.PlatformDirsABC.roaming>`.
+    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
+    :returns: data directory tied to the user
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        roaming=roaming,
+        ensure_exists=ensure_exists,
+    ).user_data_dir
+
+
+def site_data_dir(
+    appname: str | None = None,
+    appauthor: str | None | Literal[False] = None,
+    version: str | None = None,
+    multipath: bool = False,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> str:
+    """
+    :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
+    :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
+    :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
+    :param multipath: See `roaming <platformdirs.api.PlatformDirsABC.multipath>`.
+    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
+    :returns: data directory shared by users
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        multipath=multipath,
+        ensure_exists=ensure_exists,
+    ).site_data_dir
+
+
+def user_config_dir(
+    appname: str | None = None,
+    appauthor: str | None | Literal[False] = None,
+    version: str | None = None,
+    roaming: bool = False,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> str:
+    """
+    :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
+    :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
+    :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
+    :param roaming: See `roaming <platformdirs.api.PlatformDirsABC.roaming>`.
+    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
+    :returns: config directory tied to the user
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        roaming=roaming,
+        ensure_exists=ensure_exists,
+    ).user_config_dir
+
+
+def site_config_dir(
+    appname: str | None = None,
+    appauthor: str | None | Literal[False] = None,
+    version: str | None = None,
+    multipath: bool = False,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> str:
+    """
+    :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
+    :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
+    :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
+    :param multipath: See `roaming <platformdirs.api.PlatformDirsABC.multipath>`.
+    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
+    :returns: config directory shared by the users
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        multipath=multipath,
+        ensure_exists=ensure_exists,
+    ).site_config_dir
+
+
+def user_cache_dir(
+    appname: str | None = None,
+    appauthor: str | None | Literal[False] = None,
+    version: str | None = None,
+    opinion: bool = True,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> str:
+    """
+    :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
+    :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
+    :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
+    :param opinion: See `roaming <platformdirs.api.PlatformDirsABC.opinion>`.
+    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
+    :returns: cache directory tied to the user
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        opinion=opinion,
+        ensure_exists=ensure_exists,
+    ).user_cache_dir
+
+
+def site_cache_dir(
+    appname: str | None = None,
+    appauthor: str | None | Literal[False] = None,
+    version: str | None = None,
+    opinion: bool = True,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> str:
+    """
+    :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
+    :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
+    :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
+    :param opinion: See `opinion <platformdirs.api.PlatformDirsABC.opinion>`.
+    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
+    :returns: cache directory tied to the user
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        opinion=opinion,
+        ensure_exists=ensure_exists,
+    ).site_cache_dir
+
+
+def user_state_dir(
+    appname: str | None = None,
+    appauthor: str | None | Literal[False] = None,
+    version: str | None = None,
+    roaming: bool = False,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> str:
+    """
+    :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
+    :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
+    :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
+    :param roaming: See `roaming <platformdirs.api.PlatformDirsABC.roaming>`.
+    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
+    :returns: state directory tied to the user
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        roaming=roaming,
+        ensure_exists=ensure_exists,
+    ).user_state_dir
+
+
+def user_log_dir(
+    appname: str | None = None,
+    appauthor: str | None | Literal[False] = None,
+    version: str | None = None,
+    opinion: bool = True,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> str:
+    """
+    :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
+    :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
+    :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
+    :param opinion: See `roaming <platformdirs.api.PlatformDirsABC.opinion>`.
+    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
+    :returns: log directory tied to the user
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        opinion=opinion,
+        ensure_exists=ensure_exists,
+    ).user_log_dir
+
+
+def user_documents_dir() -> str:
+    """:returns: documents directory tied to the user"""
+    return PlatformDirs().user_documents_dir
+
+
+def user_downloads_dir() -> str:
+    """:returns: downloads directory tied to the user"""
+    return PlatformDirs().user_downloads_dir
+
+
+def user_pictures_dir() -> str:
+    """:returns: pictures directory tied to the user"""
+    return PlatformDirs().user_pictures_dir
+
+
+def user_videos_dir() -> str:
+    """:returns: videos directory tied to the user"""
+    return PlatformDirs().user_videos_dir
+
+
+def user_music_dir() -> str:
+    """:returns: music directory tied to the user"""
+    return PlatformDirs().user_music_dir
+
+
+def user_desktop_dir() -> str:
+    """:returns: desktop directory tied to the user"""
+    return PlatformDirs().user_desktop_dir
+
+
+def user_runtime_dir(
+    appname: str | None = None,
+    appauthor: str | None | Literal[False] = None,
+    version: str | None = None,
+    opinion: bool = True,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> str:
+    """
+    :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
+    :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
+    :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
+    :param opinion: See `opinion <platformdirs.api.PlatformDirsABC.opinion>`.
+    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
+    :returns: runtime directory tied to the user
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        opinion=opinion,
+        ensure_exists=ensure_exists,
+    ).user_runtime_dir
+
+
+def site_runtime_dir(
+    appname: str | None = None,
+    appauthor: str | None | Literal[False] = None,
+    version: str | None = None,
+    opinion: bool = True,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> str:
+    """
+    :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
+    :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
+    :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
+    :param opinion: See `opinion <platformdirs.api.PlatformDirsABC.opinion>`.
+    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
+    :returns: runtime directory shared by users
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        opinion=opinion,
+        ensure_exists=ensure_exists,
+    ).site_runtime_dir
+
+
+def user_data_path(
+    appname: str | None = None,
+    appauthor: str | None | Literal[False] = None,
+    version: str | None = None,
+    roaming: bool = False,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> Path:
+    """
+    :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
+    :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
+    :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
+    :param roaming: See `roaming <platformdirs.api.PlatformDirsABC.roaming>`.
+    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
+    :returns: data path tied to the user
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        roaming=roaming,
+        ensure_exists=ensure_exists,
+    ).user_data_path
+
+
+def site_data_path(
+    appname: str | None = None,
+    appauthor: str | None | Literal[False] = None,
+    version: str | None = None,
+    multipath: bool = False,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> Path:
+    """
+    :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
+    :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
+    :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
+    :param multipath: See `multipath <platformdirs.api.PlatformDirsABC.multipath>`.
+    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
+    :returns: data path shared by users
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        multipath=multipath,
+        ensure_exists=ensure_exists,
+    ).site_data_path
+
+
+def user_config_path(
+    appname: str | None = None,
+    appauthor: str | None | Literal[False] = None,
+    version: str | None = None,
+    roaming: bool = False,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> Path:
+    """
+    :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
+    :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
+    :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
+    :param roaming: See `roaming <platformdirs.api.PlatformDirsABC.roaming>`.
+    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
+    :returns: config path tied to the user
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        roaming=roaming,
+        ensure_exists=ensure_exists,
+    ).user_config_path
+
+
+def site_config_path(
+    appname: str | None = None,
+    appauthor: str | None | Literal[False] = None,
+    version: str | None = None,
+    multipath: bool = False,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> Path:
+    """
+    :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
+    :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
+    :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
+    :param multipath: See `roaming <platformdirs.api.PlatformDirsABC.multipath>`.
+    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
+    :returns: config path shared by the users
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        multipath=multipath,
+        ensure_exists=ensure_exists,
+    ).site_config_path
+
+
+def site_cache_path(
+    appname: str | None = None,
+    appauthor: str | None | Literal[False] = None,
+    version: str | None = None,
+    opinion: bool = True,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> Path:
+    """
+    :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
+    :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
+    :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
+    :param opinion: See `opinion <platformdirs.api.PlatformDirsABC.opinion>`.
+    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
+    :returns: cache directory tied to the user
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        opinion=opinion,
+        ensure_exists=ensure_exists,
+    ).site_cache_path
+
+
+def user_cache_path(
+    appname: str | None = None,
+    appauthor: str | None | Literal[False] = None,
+    version: str | None = None,
+    opinion: bool = True,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> Path:
+    """
+    :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
+    :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
+    :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
+    :param opinion: See `roaming <platformdirs.api.PlatformDirsABC.opinion>`.
+    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
+    :returns: cache path tied to the user
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        opinion=opinion,
+        ensure_exists=ensure_exists,
+    ).user_cache_path
+
+
+def user_state_path(
+    appname: str | None = None,
+    appauthor: str | None | Literal[False] = None,
+    version: str | None = None,
+    roaming: bool = False,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> Path:
+    """
+    :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
+    :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
+    :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
+    :param roaming: See `roaming <platformdirs.api.PlatformDirsABC.roaming>`.
+    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
+    :returns: state path tied to the user
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        roaming=roaming,
+        ensure_exists=ensure_exists,
+    ).user_state_path
+
+
+def user_log_path(
+    appname: str | None = None,
+    appauthor: str | None | Literal[False] = None,
+    version: str | None = None,
+    opinion: bool = True,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> Path:
+    """
+    :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
+    :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
+    :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
+    :param opinion: See `roaming <platformdirs.api.PlatformDirsABC.opinion>`.
+    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
+    :returns: log path tied to the user
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        opinion=opinion,
+        ensure_exists=ensure_exists,
+    ).user_log_path
+
+
+def user_documents_path() -> Path:
+    """:returns: documents path tied to the user"""
+    return PlatformDirs().user_documents_path
+
+
+def user_downloads_path() -> Path:
+    """:returns: downloads path tied to the user"""
+    return PlatformDirs().user_downloads_path
+
+
+def user_pictures_path() -> Path:
+    """:returns: pictures path tied to the user"""
+    return PlatformDirs().user_pictures_path
+
+
+def user_videos_path() -> Path:
+    """:returns: videos path tied to the user"""
+    return PlatformDirs().user_videos_path
+
+
+def user_music_path() -> Path:
+    """:returns: music path tied to the user"""
+    return PlatformDirs().user_music_path
+
+
+def user_desktop_path() -> Path:
+    """:returns: desktop path tied to the user"""
+    return PlatformDirs().user_desktop_path
+
+
+def user_runtime_path(
+    appname: str | None = None,
+    appauthor: str | None | Literal[False] = None,
+    version: str | None = None,
+    opinion: bool = True,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> Path:
+    """
+    :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
+    :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
+    :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
+    :param opinion: See `opinion <platformdirs.api.PlatformDirsABC.opinion>`.
+    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
+    :returns: runtime path tied to the user
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        opinion=opinion,
+        ensure_exists=ensure_exists,
+    ).user_runtime_path
+
+
+def site_runtime_path(
+    appname: str | None = None,
+    appauthor: str | None | Literal[False] = None,
+    version: str | None = None,
+    opinion: bool = True,  # noqa: FBT001, FBT002
+    ensure_exists: bool = False,  # noqa: FBT001, FBT002
+) -> Path:
+    """
+    :param appname: See `appname <platformdirs.api.PlatformDirsABC.appname>`.
+    :param appauthor: See `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`.
+    :param version: See `version <platformdirs.api.PlatformDirsABC.version>`.
+    :param opinion: See `opinion <platformdirs.api.PlatformDirsABC.opinion>`.
+    :param ensure_exists: See `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
+    :returns: runtime path shared by users
+    """
+    return PlatformDirs(
+        appname=appname,
+        appauthor=appauthor,
+        version=version,
+        opinion=opinion,
+        ensure_exists=ensure_exists,
+    ).site_runtime_path
+
+
+__all__ = [
+    "__version__",
+    "__version_info__",
+    "PlatformDirs",
+    "AppDirs",
+    "PlatformDirsABC",
+    "user_data_dir",
+    "user_config_dir",
+    "user_cache_dir",
+    "user_state_dir",
+    "user_log_dir",
+    "user_documents_dir",
+    "user_downloads_dir",
+    "user_pictures_dir",
+    "user_videos_dir",
+    "user_music_dir",
+    "user_desktop_dir",
+    "user_runtime_dir",
+    "site_data_dir",
+    "site_config_dir",
+    "site_cache_dir",
+    "site_runtime_dir",
+    "user_data_path",
+    "user_config_path",
+    "user_cache_path",
+    "user_state_path",
+    "user_log_path",
+    "user_documents_path",
+    "user_downloads_path",
+    "user_pictures_path",
+    "user_videos_path",
+    "user_music_path",
+    "user_desktop_path",
+    "user_runtime_path",
+    "site_data_path",
+    "site_config_path",
+    "site_cache_path",
+    "site_runtime_path",
+]
diff --git a/lib/platformdirs/__main__.py b/lib/platformdirs/__main__.py
new file mode 100644
index 00000000..3cefedbd
--- /dev/null
+++ b/lib/platformdirs/__main__.py
@@ -0,0 +1,54 @@
+"""Main entry point."""
+from __future__ import annotations
+
+from platformdirs import PlatformDirs, __version__
+
+PROPS = (
+    "user_data_dir",
+    "user_config_dir",
+    "user_cache_dir",
+    "user_state_dir",
+    "user_log_dir",
+    "user_documents_dir",
+    "user_downloads_dir",
+    "user_pictures_dir",
+    "user_videos_dir",
+    "user_music_dir",
+    "user_runtime_dir",
+    "site_data_dir",
+    "site_config_dir",
+    "site_cache_dir",
+    "site_runtime_dir",
+)
+
+
+def main() -> None:
+    """Run main entry point."""
+    app_name = "MyApp"
+    app_author = "MyCompany"
+
+    print(f"-- platformdirs {__version__} --")  # noqa: T201
+
+    print("-- app dirs (with optional 'version')")  # noqa: T201
+    dirs = PlatformDirs(app_name, app_author, version="1.0")
+    for prop in PROPS:
+        print(f"{prop}: {getattr(dirs, prop)}")  # noqa: T201
+
+    print("\n-- app dirs (without optional 'version')")  # noqa: T201
+    dirs = PlatformDirs(app_name, app_author)
+    for prop in PROPS:
+        print(f"{prop}: {getattr(dirs, prop)}")  # noqa: T201
+
+    print("\n-- app dirs (without optional 'appauthor')")  # noqa: T201
+    dirs = PlatformDirs(app_name)
+    for prop in PROPS:
+        print(f"{prop}: {getattr(dirs, prop)}")  # noqa: T201
+
+    print("\n-- app dirs (with disabled 'appauthor')")  # noqa: T201
+    dirs = PlatformDirs(app_name, appauthor=False)
+    for prop in PROPS:
+        print(f"{prop}: {getattr(dirs, prop)}")  # noqa: T201
+
+
+if __name__ == "__main__":
+    main()
diff --git a/lib/platformdirs/android.py b/lib/platformdirs/android.py
new file mode 100644
index 00000000..572559f8
--- /dev/null
+++ b/lib/platformdirs/android.py
@@ -0,0 +1,220 @@
+"""Android."""
+from __future__ import annotations
+
+import os
+import re
+import sys
+from functools import lru_cache
+from typing import cast
+
+from .api import PlatformDirsABC
+
+
+class Android(PlatformDirsABC):
+    """
+    Follows the guidance `from here <https://android.stackexchange.com/a/216132>`_. Makes use of the
+    `appname <platformdirs.api.PlatformDirsABC.appname>`,
+    `version <platformdirs.api.PlatformDirsABC.version>`,
+    `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
+    """
+
+    @property
+    def user_data_dir(self) -> str:
+        """:return: data directory tied to the user, e.g. ``/data/user/<userid>/<packagename>/files/<AppName>``"""
+        return self._append_app_name_and_version(cast(str, _android_folder()), "files")
+
+    @property
+    def site_data_dir(self) -> str:
+        """:return: data directory shared by users, same as `user_data_dir`"""
+        return self.user_data_dir
+
+    @property
+    def user_config_dir(self) -> str:
+        """
+        :return: config directory tied to the user, e.g. \
+        ``/data/user/<userid>/<packagename>/shared_prefs/<AppName>``
+        """
+        return self._append_app_name_and_version(cast(str, _android_folder()), "shared_prefs")
+
+    @property
+    def site_config_dir(self) -> str:
+        """:return: config directory shared by the users, same as `user_config_dir`"""
+        return self.user_config_dir
+
+    @property
+    def user_cache_dir(self) -> str:
+        """:return: cache directory tied to the user, e.g. e.g. ``/data/user/<userid>/<packagename>/cache/<AppName>``"""
+        return self._append_app_name_and_version(cast(str, _android_folder()), "cache")
+
+    @property
+    def site_cache_dir(self) -> str:
+        """:return: cache directory shared by users, same as `user_cache_dir`"""
+        return self.user_cache_dir
+
+    @property
+    def user_state_dir(self) -> str:
+        """:return: state directory tied to the user, same as `user_data_dir`"""
+        return self.user_data_dir
+
+    @property
+    def user_log_dir(self) -> str:
+        """
+        :return: log directory tied to the user, same as `user_cache_dir` if not opinionated else ``log`` in it,
+          e.g. ``/data/user/<userid>/<packagename>/cache/<AppName>/log``
+        """
+        path = self.user_cache_dir
+        if self.opinion:
+            path = os.path.join(path, "log")  # noqa: PTH118
+        return path
+
+    @property
+    def user_documents_dir(self) -> str:
+        """:return: documents directory tied to the user e.g. ``/storage/emulated/0/Documents``"""
+        return _android_documents_folder()
+
+    @property
+    def user_downloads_dir(self) -> str:
+        """:return: downloads directory tied to the user e.g. ``/storage/emulated/0/Downloads``"""
+        return _android_downloads_folder()
+
+    @property
+    def user_pictures_dir(self) -> str:
+        """:return: pictures directory tied to the user e.g. ``/storage/emulated/0/Pictures``"""
+        return _android_pictures_folder()
+
+    @property
+    def user_videos_dir(self) -> str:
+        """:return: videos directory tied to the user e.g. ``/storage/emulated/0/DCIM/Camera``"""
+        return _android_videos_folder()
+
+    @property
+    def user_music_dir(self) -> str:
+        """:return: music directory tied to the user e.g. ``/storage/emulated/0/Music``"""
+        return _android_music_folder()
+
+    @property
+    def user_desktop_dir(self) -> str:
+        """:return: desktop directory tied to the user e.g. ``/storage/emulated/0/Desktop``"""
+        return "/storage/emulated/0/Desktop"
+
+    @property
+    def user_runtime_dir(self) -> str:
+        """
+        :return: runtime directory tied to the user, same as `user_cache_dir` if not opinionated else ``tmp`` in it,
+          e.g. ``/data/user/<userid>/<packagename>/cache/<AppName>/tmp``
+        """
+        path = self.user_cache_dir
+        if self.opinion:
+            path = os.path.join(path, "tmp")  # noqa: PTH118
+        return path
+
+    @property
+    def site_runtime_dir(self) -> str:
+        """:return: runtime directory shared by users, same as `user_runtime_dir`"""
+        return self.user_runtime_dir
+
+
+@lru_cache(maxsize=1)
+def _android_folder() -> str | None:
+    """:return: base folder for the Android OS or None if it cannot be found"""
+    try:
+        # First try to get path to android app via pyjnius
+        from jnius import autoclass
+
+        context = autoclass("android.content.Context")
+        result: str | None = context.getFilesDir().getParentFile().getAbsolutePath()
+    except Exception:  # noqa: BLE001
+        # if fails find an android folder looking path on the sys.path
+        pattern = re.compile(r"/data/(data|user/\d+)/(.+)/files")
+        for path in sys.path:
+            if pattern.match(path):
+                result = path.split("/files")[0]
+                break
+        else:
+            result = None
+    return result
+
+
+@lru_cache(maxsize=1)
+def _android_documents_folder() -> str:
+    """:return: documents folder for the Android OS"""
+    # Get directories with pyjnius
+    try:
+        from jnius import autoclass
+
+        context = autoclass("android.content.Context")
+        environment = autoclass("android.os.Environment")
+        documents_dir: str = context.getExternalFilesDir(environment.DIRECTORY_DOCUMENTS).getAbsolutePath()
+    except Exception:  # noqa: BLE001
+        documents_dir = "/storage/emulated/0/Documents"
+
+    return documents_dir
+
+
+@lru_cache(maxsize=1)
+def _android_downloads_folder() -> str:
+    """:return: downloads folder for the Android OS"""
+    # Get directories with pyjnius
+    try:
+        from jnius import autoclass
+
+        context = autoclass("android.content.Context")
+        environment = autoclass("android.os.Environment")
+        downloads_dir: str = context.getExternalFilesDir(environment.DIRECTORY_DOWNLOADS).getAbsolutePath()
+    except Exception:  # noqa: BLE001
+        downloads_dir = "/storage/emulated/0/Downloads"
+
+    return downloads_dir
+
+
+@lru_cache(maxsize=1)
+def _android_pictures_folder() -> str:
+    """:return: pictures folder for the Android OS"""
+    # Get directories with pyjnius
+    try:
+        from jnius import autoclass
+
+        context = autoclass("android.content.Context")
+        environment = autoclass("android.os.Environment")
+        pictures_dir: str = context.getExternalFilesDir(environment.DIRECTORY_PICTURES).getAbsolutePath()
+    except Exception:  # noqa: BLE001
+        pictures_dir = "/storage/emulated/0/Pictures"
+
+    return pictures_dir
+
+
+@lru_cache(maxsize=1)
+def _android_videos_folder() -> str:
+    """:return: videos folder for the Android OS"""
+    # Get directories with pyjnius
+    try:
+        from jnius import autoclass
+
+        context = autoclass("android.content.Context")
+        environment = autoclass("android.os.Environment")
+        videos_dir: str = context.getExternalFilesDir(environment.DIRECTORY_DCIM).getAbsolutePath()
+    except Exception:  # noqa: BLE001
+        videos_dir = "/storage/emulated/0/DCIM/Camera"
+
+    return videos_dir
+
+
+@lru_cache(maxsize=1)
+def _android_music_folder() -> str:
+    """:return: music folder for the Android OS"""
+    # Get directories with pyjnius
+    try:
+        from jnius import autoclass
+
+        context = autoclass("android.content.Context")
+        environment = autoclass("android.os.Environment")
+        music_dir: str = context.getExternalFilesDir(environment.DIRECTORY_MUSIC).getAbsolutePath()
+    except Exception:  # noqa: BLE001
+        music_dir = "/storage/emulated/0/Music"
+
+    return music_dir
+
+
+__all__ = [
+    "Android",
+]
diff --git a/lib/platformdirs/api.py b/lib/platformdirs/api.py
new file mode 100644
index 00000000..aa9ce7b9
--- /dev/null
+++ b/lib/platformdirs/api.py
@@ -0,0 +1,243 @@
+"""Base API."""
+from __future__ import annotations
+
+import os
+from abc import ABC, abstractmethod
+from pathlib import Path
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    import sys
+
+    if sys.version_info >= (3, 8):  # pragma: no cover (py38+)
+        from typing import Literal
+    else:  # pragma: no cover (py38+)
+        from typing_extensions import Literal
+
+
+class PlatformDirsABC(ABC):
+    """Abstract base class for platform directories."""
+
+    def __init__(  # noqa: PLR0913
+        self,
+        appname: str | None = None,
+        appauthor: str | None | Literal[False] = None,
+        version: str | None = None,
+        roaming: bool = False,  # noqa: FBT001, FBT002
+        multipath: bool = False,  # noqa: FBT001, FBT002
+        opinion: bool = True,  # noqa: FBT001, FBT002
+        ensure_exists: bool = False,  # noqa: FBT001, FBT002
+    ) -> None:
+        """
+        Create a new platform directory.
+
+        :param appname: See `appname`.
+        :param appauthor: See `appauthor`.
+        :param version: See `version`.
+        :param roaming: See `roaming`.
+        :param multipath: See `multipath`.
+        :param opinion: See `opinion`.
+        :param ensure_exists: See `ensure_exists`.
+        """
+        self.appname = appname  #: The name of application.
+        self.appauthor = appauthor
+        """
+        The name of the app author or distributing body for this application. Typically, it is the owning company name.
+        Defaults to `appname`. You may pass ``False`` to disable it.
+        """
+        self.version = version
+        """
+        An optional version path element to append to the path. You might want to use this if you want multiple versions
+        of your app to be able to run independently. If used, this would typically be ``<major>.<minor>``.
+        """
+        self.roaming = roaming
+        """
+        Whether to use the roaming appdata directory on Windows. That means that for users on a Windows network setup
+        for roaming profiles, this user data will be synced on login (see
+        `here <http://technet.microsoft.com/en-us/library/cc766489(WS.10).aspx>`_).
+        """
+        self.multipath = multipath
+        """
+        An optional parameter which indicates that the entire list of data dirs should be returned.
+        By default, the first item would only be returned.
+        """
+        self.opinion = opinion  #: A flag to indicating to use opinionated values.
+        self.ensure_exists = ensure_exists
+        """
+        Optionally create the directory (and any missing parents) upon access if it does not exist.
+        By default, no directories are created.
+        """
+
+    def _append_app_name_and_version(self, *base: str) -> str:
+        params = list(base[1:])
+        if self.appname:
+            params.append(self.appname)
+            if self.version:
+                params.append(self.version)
+        path = os.path.join(base[0], *params)  # noqa: PTH118
+        self._optionally_create_directory(path)
+        return path
+
+    def _optionally_create_directory(self, path: str) -> None:
+        if self.ensure_exists:
+            Path(path).mkdir(parents=True, exist_ok=True)
+
+    @property
+    @abstractmethod
+    def user_data_dir(self) -> str:
+        """:return: data directory tied to the user"""
+
+    @property
+    @abstractmethod
+    def site_data_dir(self) -> str:
+        """:return: data directory shared by users"""
+
+    @property
+    @abstractmethod
+    def user_config_dir(self) -> str:
+        """:return: config directory tied to the user"""
+
+    @property
+    @abstractmethod
+    def site_config_dir(self) -> str:
+        """:return: config directory shared by the users"""
+
+    @property
+    @abstractmethod
+    def user_cache_dir(self) -> str:
+        """:return: cache directory tied to the user"""
+
+    @property
+    @abstractmethod
+    def site_cache_dir(self) -> str:
+        """:return: cache directory shared by users"""
+
+    @property
+    @abstractmethod
+    def user_state_dir(self) -> str:
+        """:return: state directory tied to the user"""
+
+    @property
+    @abstractmethod
+    def user_log_dir(self) -> str:
+        """:return: log directory tied to the user"""
+
+    @property
+    @abstractmethod
+    def user_documents_dir(self) -> str:
+        """:return: documents directory tied to the user"""
+
+    @property
+    @abstractmethod
+    def user_downloads_dir(self) -> str:
+        """:return: downloads directory tied to the user"""
+
+    @property
+    @abstractmethod
+    def user_pictures_dir(self) -> str:
+        """:return: pictures directory tied to the user"""
+
+    @property
+    @abstractmethod
+    def user_videos_dir(self) -> str:
+        """:return: videos directory tied to the user"""
+
+    @property
+    @abstractmethod
+    def user_music_dir(self) -> str:
+        """:return: music directory tied to the user"""
+
+    @property
+    @abstractmethod
+    def user_desktop_dir(self) -> str:
+        """:return: desktop directory tied to the user"""
+
+    @property
+    @abstractmethod
+    def user_runtime_dir(self) -> str:
+        """:return: runtime directory tied to the user"""
+
+    @property
+    @abstractmethod
+    def site_runtime_dir(self) -> str:
+        """:return: runtime directory shared by users"""
+
+    @property
+    def user_data_path(self) -> Path:
+        """:return: data path tied to the user"""
+        return Path(self.user_data_dir)
+
+    @property
+    def site_data_path(self) -> Path:
+        """:return: data path shared by users"""
+        return Path(self.site_data_dir)
+
+    @property
+    def user_config_path(self) -> Path:
+        """:return: config path tied to the user"""
+        return Path(self.user_config_dir)
+
+    @property
+    def site_config_path(self) -> Path:
+        """:return: config path shared by the users"""
+        return Path(self.site_config_dir)
+
+    @property
+    def user_cache_path(self) -> Path:
+        """:return: cache path tied to the user"""
+        return Path(self.user_cache_dir)
+
+    @property
+    def site_cache_path(self) -> Path:
+        """:return: cache path shared by users"""
+        return Path(self.site_cache_dir)
+
+    @property
+    def user_state_path(self) -> Path:
+        """:return: state path tied to the user"""
+        return Path(self.user_state_dir)
+
+    @property
+    def user_log_path(self) -> Path:
+        """:return: log path tied to the user"""
+        return Path(self.user_log_dir)
+
+    @property
+    def user_documents_path(self) -> Path:
+        """:return: documents path tied to the user"""
+        return Path(self.user_documents_dir)
+
+    @property
+    def user_downloads_path(self) -> Path:
+        """:return: downloads path tied to the user"""
+        return Path(self.user_downloads_dir)
+
+    @property
+    def user_pictures_path(self) -> Path:
+        """:return: pictures path tied to the user"""
+        return Path(self.user_pictures_dir)
+
+    @property
+    def user_videos_path(self) -> Path:
+        """:return: videos path tied to the user"""
+        return Path(self.user_videos_dir)
+
+    @property
+    def user_music_path(self) -> Path:
+        """:return: music path tied to the user"""
+        return Path(self.user_music_dir)
+
+    @property
+    def user_desktop_path(self) -> Path:
+        """:return: desktop path tied to the user"""
+        return Path(self.user_desktop_dir)
+
+    @property
+    def user_runtime_path(self) -> Path:
+        """:return: runtime path tied to the user"""
+        return Path(self.user_runtime_dir)
+
+    @property
+    def site_runtime_path(self) -> Path:
+        """:return: runtime path shared by users"""
+        return Path(self.site_runtime_dir)
diff --git a/lib/platformdirs/macos.py b/lib/platformdirs/macos.py
new file mode 100644
index 00000000..c01ce163
--- /dev/null
+++ b/lib/platformdirs/macos.py
@@ -0,0 +1,126 @@
+"""macOS."""
+from __future__ import annotations
+
+import os.path
+import sys
+
+from .api import PlatformDirsABC
+
+
+class MacOS(PlatformDirsABC):
+    """
+    Platform directories for the macOS operating system. Follows the guidance from `Apple documentation
+    <https://developer.apple.com/library/archive/documentation/FileManagement/Conceptual/FileSystemProgrammingGuide/MacOSXDirectories/MacOSXDirectories.html>`_.
+    Makes use of the `appname <platformdirs.api.PlatformDirsABC.appname>`,
+    `version <platformdirs.api.PlatformDirsABC.version>`,
+    `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
+    """
+
+    @property
+    def user_data_dir(self) -> str:
+        """:return: data directory tied to the user, e.g. ``~/Library/Application Support/$appname/$version``"""
+        return self._append_app_name_and_version(os.path.expanduser("~/Library/Application Support"))  # noqa: PTH111
+
+    @property
+    def site_data_dir(self) -> str:
+        """
+        :return: data directory shared by users, e.g. ``/Library/Application Support/$appname/$version``.
+          If we're using a Python binary managed by `Homebrew <https://brew.sh>`_, the directory
+          will be under the Homebrew prefix, e.g. ``/opt/homebrew/share/$appname/$version``.
+          If `multipath <platformdirs.api.PlatformDirsABC.multipath>` is enabled and we're in Homebrew,
+          the response is a multi-path string separated by ":", e.g.
+          ``/opt/homebrew/share/$appname/$version:/Library/Application Support/$appname/$version``
+        """
+        is_homebrew = sys.prefix.startswith("/opt/homebrew")
+        path_list = [self._append_app_name_and_version("/opt/homebrew/share")] if is_homebrew else []
+        path_list.append(self._append_app_name_and_version("/Library/Application Support"))
+        if self.multipath:
+            return os.pathsep.join(path_list)
+        return path_list[0]
+
+    @property
+    def user_config_dir(self) -> str:
+        """:return: config directory tied to the user, same as `user_data_dir`"""
+        return self.user_data_dir
+
+    @property
+    def site_config_dir(self) -> str:
+        """:return: config directory shared by the users, same as `site_data_dir`"""
+        return self.site_data_dir
+
+    @property
+    def user_cache_dir(self) -> str:
+        """:return: cache directory tied to the user, e.g. ``~/Library/Caches/$appname/$version``"""
+        return self._append_app_name_and_version(os.path.expanduser("~/Library/Caches"))  # noqa: PTH111
+
+    @property
+    def site_cache_dir(self) -> str:
+        """
+        :return: cache directory shared by users, e.g. ``/Library/Caches/$appname/$version``.
+          If we're using a Python binary managed by `Homebrew <https://brew.sh>`_, the directory
+          will be under the Homebrew prefix, e.g. ``/opt/homebrew/var/cache/$appname/$version``.
+          If `multipath <platformdirs.api.PlatformDirsABC.multipath>` is enabled and we're in Homebrew,
+          the response is a multi-path string separated by ":", e.g.
+          ``/opt/homebrew/var/cache/$appname/$version:/Library/Caches/$appname/$version``
+        """
+        is_homebrew = sys.prefix.startswith("/opt/homebrew")
+        path_list = [self._append_app_name_and_version("/opt/homebrew/var/cache")] if is_homebrew else []
+        path_list.append(self._append_app_name_and_version("/Library/Caches"))
+        if self.multipath:
+            return os.pathsep.join(path_list)
+        return path_list[0]
+
+    @property
+    def user_state_dir(self) -> str:
+        """:return: state directory tied to the user, same as `user_data_dir`"""
+        return self.user_data_dir
+
+    @property
+    def user_log_dir(self) -> str:
+        """:return: log directory tied to the user, e.g. ``~/Library/Logs/$appname/$version``"""
+        return self._append_app_name_and_version(os.path.expanduser("~/Library/Logs"))  # noqa: PTH111
+
+    @property
+    def user_documents_dir(self) -> str:
+        """:return: documents directory tied to the user, e.g. ``~/Documents``"""
+        return os.path.expanduser("~/Documents")  # noqa: PTH111
+
+    @property
+    def user_downloads_dir(self) -> str:
+        """:return: downloads directory tied to the user, e.g. ``~/Downloads``"""
+        return os.path.expanduser("~/Downloads")  # noqa: PTH111
+
+    @property
+    def user_pictures_dir(self) -> str:
+        """:return: pictures directory tied to the user, e.g. ``~/Pictures``"""
+        return os.path.expanduser("~/Pictures")  # noqa: PTH111
+
+    @property
+    def user_videos_dir(self) -> str:
+        """:return: videos directory tied to the user, e.g. ``~/Movies``"""
+        return os.path.expanduser("~/Movies")  # noqa: PTH111
+
+    @property
+    def user_music_dir(self) -> str:
+        """:return: music directory tied to the user, e.g. ``~/Music``"""
+        return os.path.expanduser("~/Music")  # noqa: PTH111
+
+    @property
+    def user_desktop_dir(self) -> str:
+        """:return: desktop directory tied to the user, e.g. ``~/Desktop``"""
+        return os.path.expanduser("~/Desktop")  # noqa: PTH111
+
+    @property
+    def user_runtime_dir(self) -> str:
+        """:return: runtime directory tied to the user, e.g. ``~/Library/Caches/TemporaryItems/$appname/$version``"""
+        return self._append_app_name_and_version(os.path.expanduser("~/Library/Caches/TemporaryItems"))  # noqa: PTH111
+
+    @property
+    def site_runtime_dir(self) -> str:
+        """:return: runtime directory shared by users, same as `user_runtime_dir`"""
+        return self.user_runtime_dir
+
+
+__all__ = [
+    "MacOS",
+]
diff --git a/lib/platformdirs/py.typed b/lib/platformdirs/py.typed
new file mode 100644
index 00000000..e69de29b
diff --git a/lib/platformdirs/unix.py b/lib/platformdirs/unix.py
new file mode 100644
index 00000000..1d0174f2
--- /dev/null
+++ b/lib/platformdirs/unix.py
@@ -0,0 +1,251 @@
+"""Unix."""
+from __future__ import annotations
+
+import os
+import sys
+from configparser import ConfigParser
+from pathlib import Path
+
+from .api import PlatformDirsABC
+
+if sys.platform == "win32":
+
+    def getuid() -> int:
+        msg = "should only be used on Unix"
+        raise RuntimeError(msg)
+
+else:
+    from os import getuid
+
+
+class Unix(PlatformDirsABC):
+    """
+    On Unix/Linux, we follow the
+    `XDG Basedir Spec <https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html>`_. The spec allows
+    overriding directories with environment variables. The examples show are the default values, alongside the name of
+    the environment variable that overrides them. Makes use of the
+    `appname <platformdirs.api.PlatformDirsABC.appname>`,
+    `version <platformdirs.api.PlatformDirsABC.version>`,
+    `multipath <platformdirs.api.PlatformDirsABC.multipath>`,
+    `opinion <platformdirs.api.PlatformDirsABC.opinion>`,
+    `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
+    """
+
+    @property
+    def user_data_dir(self) -> str:
+        """
+        :return: data directory tied to the user, e.g. ``~/.local/share/$appname/$version`` or
+         ``$XDG_DATA_HOME/$appname/$version``
+        """
+        path = os.environ.get("XDG_DATA_HOME", "")
+        if not path.strip():
+            path = os.path.expanduser("~/.local/share")  # noqa: PTH111
+        return self._append_app_name_and_version(path)
+
+    @property
+    def site_data_dir(self) -> str:
+        """
+        :return: data directories shared by users (if `multipath <platformdirs.api.PlatformDirsABC.multipath>` is
+         enabled and ``XDG_DATA_DIR`` is set and a multi path the response is also a multi path separated by the OS
+         path separator), e.g. ``/usr/local/share/$appname/$version`` or ``/usr/share/$appname/$version``
+        """
+        # XDG default for $XDG_DATA_DIRS; only first, if multipath is False
+        path = os.environ.get("XDG_DATA_DIRS", "")
+        if not path.strip():
+            path = f"/usr/local/share{os.pathsep}/usr/share"
+        return self._with_multi_path(path)
+
+    def _with_multi_path(self, path: str) -> str:
+        path_list = path.split(os.pathsep)
+        if not self.multipath:
+            path_list = path_list[0:1]
+        path_list = [self._append_app_name_and_version(os.path.expanduser(p)) for p in path_list]  # noqa: PTH111
+        return os.pathsep.join(path_list)
+
+    @property
+    def user_config_dir(self) -> str:
+        """
+        :return: config directory tied to the user, e.g. ``~/.config/$appname/$version`` or
+         ``$XDG_CONFIG_HOME/$appname/$version``
+        """
+        path = os.environ.get("XDG_CONFIG_HOME", "")
+        if not path.strip():
+            path = os.path.expanduser("~/.config")  # noqa: PTH111
+        return self._append_app_name_and_version(path)
+
+    @property
+    def site_config_dir(self) -> str:
+        """
+        :return: config directories shared by users (if `multipath <platformdirs.api.PlatformDirsABC.multipath>`
+         is enabled and ``XDG_DATA_DIR`` is set and a multi path the response is also a multi path separated by the OS
+         path separator), e.g. ``/etc/xdg/$appname/$version``
+        """
+        # XDG default for $XDG_CONFIG_DIRS only first, if multipath is False
+        path = os.environ.get("XDG_CONFIG_DIRS", "")
+        if not path.strip():
+            path = "/etc/xdg"
+        return self._with_multi_path(path)
+
+    @property
+    def user_cache_dir(self) -> str:
+        """
+        :return: cache directory tied to the user, e.g. ``~/.cache/$appname/$version`` or
+         ``~/$XDG_CACHE_HOME/$appname/$version``
+        """
+        path = os.environ.get("XDG_CACHE_HOME", "")
+        if not path.strip():
+            path = os.path.expanduser("~/.cache")  # noqa: PTH111
+        return self._append_app_name_and_version(path)
+
+    @property
+    def site_cache_dir(self) -> str:
+        """:return: cache directory shared by users, e.g. ``/var/tmp/$appname/$version``"""
+        return self._append_app_name_and_version("/var/tmp")  # noqa: S108
+
+    @property
+    def user_state_dir(self) -> str:
+        """
+        :return: state directory tied to the user, e.g. ``~/.local/state/$appname/$version`` or
+         ``$XDG_STATE_HOME/$appname/$version``
+        """
+        path = os.environ.get("XDG_STATE_HOME", "")
+        if not path.strip():
+            path = os.path.expanduser("~/.local/state")  # noqa: PTH111
+        return self._append_app_name_and_version(path)
+
+    @property
+    def user_log_dir(self) -> str:
+        """:return: log directory tied to the user, same as `user_state_dir` if not opinionated else ``log`` in it"""
+        path = self.user_state_dir
+        if self.opinion:
+            path = os.path.join(path, "log")  # noqa: PTH118
+            self._optionally_create_directory(path)
+        return path
+
+    @property
+    def user_documents_dir(self) -> str:
+        """:return: documents directory tied to the user, e.g. ``~/Documents``"""
+        return _get_user_media_dir("XDG_DOCUMENTS_DIR", "~/Documents")
+
+    @property
+    def user_downloads_dir(self) -> str:
+        """:return: downloads directory tied to the user, e.g. ``~/Downloads``"""
+        return _get_user_media_dir("XDG_DOWNLOAD_DIR", "~/Downloads")
+
+    @property
+    def user_pictures_dir(self) -> str:
+        """:return: pictures directory tied to the user, e.g. ``~/Pictures``"""
+        return _get_user_media_dir("XDG_PICTURES_DIR", "~/Pictures")
+
+    @property
+    def user_videos_dir(self) -> str:
+        """:return: videos directory tied to the user, e.g. ``~/Videos``"""
+        return _get_user_media_dir("XDG_VIDEOS_DIR", "~/Videos")
+
+    @property
+    def user_music_dir(self) -> str:
+        """:return: music directory tied to the user, e.g. ``~/Music``"""
+        return _get_user_media_dir("XDG_MUSIC_DIR", "~/Music")
+
+    @property
+    def user_desktop_dir(self) -> str:
+        """:return: desktop directory tied to the user, e.g. ``~/Desktop``"""
+        return _get_user_media_dir("XDG_DESKTOP_DIR", "~/Desktop")
+
+    @property
+    def user_runtime_dir(self) -> str:
+        """
+        :return: runtime directory tied to the user, e.g. ``/run/user/$(id -u)/$appname/$version`` or
+         ``$XDG_RUNTIME_DIR/$appname/$version``.
+
+         For FreeBSD/OpenBSD/NetBSD, it would return ``/var/run/user/$(id -u)/$appname/$version`` if
+         exists, otherwise ``/tmp/runtime-$(id -u)/$appname/$version``, if``$XDG_RUNTIME_DIR``
+         is not set.
+        """
+        path = os.environ.get("XDG_RUNTIME_DIR", "")
+        if not path.strip():
+            if sys.platform.startswith(("freebsd", "openbsd", "netbsd")):
+                path = f"/var/run/user/{getuid()}"
+                if not Path(path).exists():
+                    path = f"/tmp/runtime-{getuid()}"  # noqa: S108
+            else:
+                path = f"/run/user/{getuid()}"
+        return self._append_app_name_and_version(path)
+
+    @property
+    def site_runtime_dir(self) -> str:
+        """
+        :return: runtime directory shared by users, e.g. ``/run/$appname/$version`` or \
+        ``$XDG_RUNTIME_DIR/$appname/$version``.
+
+        Note that this behaves almost exactly like `user_runtime_dir` if ``$XDG_RUNTIME_DIR`` is set, but will
+        fall back to paths associated to the root user instead of a regular logged-in user if it's not set.
+
+        If you wish to ensure that a logged-in root user path is returned e.g. ``/run/user/0``, use `user_runtime_dir`
+        instead.
+
+        For FreeBSD/OpenBSD/NetBSD, it would return ``/var/run/$appname/$version`` if ``$XDG_RUNTIME_DIR`` is not set.
+        """
+        path = os.environ.get("XDG_RUNTIME_DIR", "")
+        if not path.strip():
+            if sys.platform.startswith(("freebsd", "openbsd", "netbsd")):
+                path = "/var/run"
+            else:
+                path = "/run"
+        return self._append_app_name_and_version(path)
+
+    @property
+    def site_data_path(self) -> Path:
+        """:return: data path shared by users. Only return first item, even if ``multipath`` is set to ``True``"""
+        return self._first_item_as_path_if_multipath(self.site_data_dir)
+
+    @property
+    def site_config_path(self) -> Path:
+        """:return: config path shared by the users. Only return first item, even if ``multipath`` is set to ``True``"""
+        return self._first_item_as_path_if_multipath(self.site_config_dir)
+
+    @property
+    def site_cache_path(self) -> Path:
+        """:return: cache path shared by users. Only return first item, even if ``multipath`` is set to ``True``"""
+        return self._first_item_as_path_if_multipath(self.site_cache_dir)
+
+    def _first_item_as_path_if_multipath(self, directory: str) -> Path:
+        if self.multipath:
+            # If multipath is True, the first path is returned.
+            directory = directory.split(os.pathsep)[0]
+        return Path(directory)
+
+
+def _get_user_media_dir(env_var: str, fallback_tilde_path: str) -> str:
+    media_dir = _get_user_dirs_folder(env_var)
+    if media_dir is None:
+        media_dir = os.environ.get(env_var, "").strip()
+        if not media_dir:
+            media_dir = os.path.expanduser(fallback_tilde_path)  # noqa: PTH111
+
+    return media_dir
+
+
+def _get_user_dirs_folder(key: str) -> str | None:
+    """Return directory from user-dirs.dirs config file. See https://freedesktop.org/wiki/Software/xdg-user-dirs/."""
+    user_dirs_config_path = Path(Unix().user_config_dir) / "user-dirs.dirs"
+    if user_dirs_config_path.exists():
+        parser = ConfigParser()
+
+        with user_dirs_config_path.open() as stream:
+            # Add fake section header, so ConfigParser doesn't complain
+            parser.read_string(f"[top]\n{stream.read()}")
+
+        if key not in parser["top"]:
+            return None
+
+        path = parser["top"][key].strip('"')
+        # Handle relative home paths
+        return path.replace("$HOME", os.path.expanduser("~"))  # noqa: PTH111
+
+    return None
+
+
+__all__ = [
+    "Unix",
+]
diff --git a/lib/platformdirs/version.py b/lib/platformdirs/version.py
new file mode 100644
index 00000000..c2ef2084
--- /dev/null
+++ b/lib/platformdirs/version.py
@@ -0,0 +1,16 @@
+# file generated by setuptools_scm
+# don't change, don't track in version control
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from typing import Tuple, Union
+    VERSION_TUPLE = Tuple[Union[int, str], ...]
+else:
+    VERSION_TUPLE = object
+
+version: str
+__version__: str
+__version_tuple__: VERSION_TUPLE
+version_tuple: VERSION_TUPLE
+
+__version__ = version = '3.11.0'
+__version_tuple__ = version_tuple = (3, 11, 0)
diff --git a/lib/platformdirs/windows.py b/lib/platformdirs/windows.py
new file mode 100644
index 00000000..751143ad
--- /dev/null
+++ b/lib/platformdirs/windows.py
@@ -0,0 +1,266 @@
+"""Windows."""
+from __future__ import annotations
+
+import ctypes
+import os
+import sys
+from functools import lru_cache
+from typing import TYPE_CHECKING
+
+from .api import PlatformDirsABC
+
+if TYPE_CHECKING:
+    from collections.abc import Callable
+
+
+class Windows(PlatformDirsABC):
+    """
+    `MSDN on where to store app data files
+    <http://support.microsoft.com/default.aspx?scid=kb;en-us;310294#XSLTH3194121123120121120120>`_.
+    Makes use of the
+    `appname <platformdirs.api.PlatformDirsABC.appname>`,
+    `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`,
+    `version <platformdirs.api.PlatformDirsABC.version>`,
+    `roaming <platformdirs.api.PlatformDirsABC.roaming>`,
+    `opinion <platformdirs.api.PlatformDirsABC.opinion>`,
+    `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
+    """
+
+    @property
+    def user_data_dir(self) -> str:
+        """
+        :return: data directory tied to the user, e.g.
+         ``%USERPROFILE%\\AppData\\Local\\$appauthor\\$appname`` (not roaming) or
+         ``%USERPROFILE%\\AppData\\Roaming\\$appauthor\\$appname`` (roaming)
+        """
+        const = "CSIDL_APPDATA" if self.roaming else "CSIDL_LOCAL_APPDATA"
+        path = os.path.normpath(get_win_folder(const))
+        return self._append_parts(path)
+
+    def _append_parts(self, path: str, *, opinion_value: str | None = None) -> str:
+        params = []
+        if self.appname:
+            if self.appauthor is not False:
+                author = self.appauthor or self.appname
+                params.append(author)
+            params.append(self.appname)
+            if opinion_value is not None and self.opinion:
+                params.append(opinion_value)
+            if self.version:
+                params.append(self.version)
+        path = os.path.join(path, *params)  # noqa: PTH118
+        self._optionally_create_directory(path)
+        return path
+
+    @property
+    def site_data_dir(self) -> str:
+        """:return: data directory shared by users, e.g. ``C:\\ProgramData\\$appauthor\\$appname``"""
+        path = os.path.normpath(get_win_folder("CSIDL_COMMON_APPDATA"))
+        return self._append_parts(path)
+
+    @property
+    def user_config_dir(self) -> str:
+        """:return: config directory tied to the user, same as `user_data_dir`"""
+        return self.user_data_dir
+
+    @property
+    def site_config_dir(self) -> str:
+        """:return: config directory shared by the users, same as `site_data_dir`"""
+        return self.site_data_dir
+
+    @property
+    def user_cache_dir(self) -> str:
+        """
+        :return: cache directory tied to the user (if opinionated with ``Cache`` folder within ``$appname``) e.g.
+         ``%USERPROFILE%\\AppData\\Local\\$appauthor\\$appname\\Cache\\$version``
+        """
+        path = os.path.normpath(get_win_folder("CSIDL_LOCAL_APPDATA"))
+        return self._append_parts(path, opinion_value="Cache")
+
+    @property
+    def site_cache_dir(self) -> str:
+        """:return: cache directory shared by users, e.g. ``C:\\ProgramData\\$appauthor\\$appname\\Cache\\$version``"""
+        path = os.path.normpath(get_win_folder("CSIDL_COMMON_APPDATA"))
+        return self._append_parts(path, opinion_value="Cache")
+
+    @property
+    def user_state_dir(self) -> str:
+        """:return: state directory tied to the user, same as `user_data_dir`"""
+        return self.user_data_dir
+
+    @property
+    def user_log_dir(self) -> str:
+        """:return: log directory tied to the user, same as `user_data_dir` if not opinionated else ``Logs`` in it"""
+        path = self.user_data_dir
+        if self.opinion:
+            path = os.path.join(path, "Logs")  # noqa: PTH118
+            self._optionally_create_directory(path)
+        return path
+
+    @property
+    def user_documents_dir(self) -> str:
+        """:return: documents directory tied to the user e.g. ``%USERPROFILE%\\Documents``"""
+        return os.path.normpath(get_win_folder("CSIDL_PERSONAL"))
+
+    @property
+    def user_downloads_dir(self) -> str:
+        """:return: downloads directory tied to the user e.g. ``%USERPROFILE%\\Downloads``"""
+        return os.path.normpath(get_win_folder("CSIDL_DOWNLOADS"))
+
+    @property
+    def user_pictures_dir(self) -> str:
+        """:return: pictures directory tied to the user e.g. ``%USERPROFILE%\\Pictures``"""
+        return os.path.normpath(get_win_folder("CSIDL_MYPICTURES"))
+
+    @property
+    def user_videos_dir(self) -> str:
+        """:return: videos directory tied to the user e.g. ``%USERPROFILE%\\Videos``"""
+        return os.path.normpath(get_win_folder("CSIDL_MYVIDEO"))
+
+    @property
+    def user_music_dir(self) -> str:
+        """:return: music directory tied to the user e.g. ``%USERPROFILE%\\Music``"""
+        return os.path.normpath(get_win_folder("CSIDL_MYMUSIC"))
+
+    @property
+    def user_desktop_dir(self) -> str:
+        """:return: desktop directory tied to the user, e.g. ``%USERPROFILE%\\Desktop``"""
+        return os.path.normpath(get_win_folder("CSIDL_DESKTOPDIRECTORY"))
+
+    @property
+    def user_runtime_dir(self) -> str:
+        """
+        :return: runtime directory tied to the user, e.g.
+         ``%USERPROFILE%\\AppData\\Local\\Temp\\$appauthor\\$appname``
+        """
+        path = os.path.normpath(os.path.join(get_win_folder("CSIDL_LOCAL_APPDATA"), "Temp"))  # noqa: PTH118
+        return self._append_parts(path)
+
+    @property
+    def site_runtime_dir(self) -> str:
+        """:return: runtime directory shared by users, same as `user_runtime_dir`"""
+        return self.user_runtime_dir
+
+
+def get_win_folder_from_env_vars(csidl_name: str) -> str:
+    """Get folder from environment variables."""
+    result = get_win_folder_if_csidl_name_not_env_var(csidl_name)
+    if result is not None:
+        return result
+
+    env_var_name = {
+        "CSIDL_APPDATA": "APPDATA",
+        "CSIDL_COMMON_APPDATA": "ALLUSERSPROFILE",
+        "CSIDL_LOCAL_APPDATA": "LOCALAPPDATA",
+    }.get(csidl_name)
+    if env_var_name is None:
+        msg = f"Unknown CSIDL name: {csidl_name}"
+        raise ValueError(msg)
+    result = os.environ.get(env_var_name)
+    if result is None:
+        msg = f"Unset environment variable: {env_var_name}"
+        raise ValueError(msg)
+    return result
+
+
+def get_win_folder_if_csidl_name_not_env_var(csidl_name: str) -> str | None:
+    """Get folder for a CSIDL name that does not exist as an environment variable."""
+    if csidl_name == "CSIDL_PERSONAL":
+        return os.path.join(os.path.normpath(os.environ["USERPROFILE"]), "Documents")  # noqa: PTH118
+
+    if csidl_name == "CSIDL_DOWNLOADS":
+        return os.path.join(os.path.normpath(os.environ["USERPROFILE"]), "Downloads")  # noqa: PTH118
+
+    if csidl_name == "CSIDL_MYPICTURES":
+        return os.path.join(os.path.normpath(os.environ["USERPROFILE"]), "Pictures")  # noqa: PTH118
+
+    if csidl_name == "CSIDL_MYVIDEO":
+        return os.path.join(os.path.normpath(os.environ["USERPROFILE"]), "Videos")  # noqa: PTH118
+
+    if csidl_name == "CSIDL_MYMUSIC":
+        return os.path.join(os.path.normpath(os.environ["USERPROFILE"]), "Music")  # noqa: PTH118
+    return None
+
+
+def get_win_folder_from_registry(csidl_name: str) -> str:
+    """
+    Get folder from the registry.
+
+    This is a fallback technique at best. I'm not sure if using the registry for these guarantees us the correct answer
+    for all CSIDL_* names.
+    """
+    shell_folder_name = {
+        "CSIDL_APPDATA": "AppData",
+        "CSIDL_COMMON_APPDATA": "Common AppData",
+        "CSIDL_LOCAL_APPDATA": "Local AppData",
+        "CSIDL_PERSONAL": "Personal",
+        "CSIDL_DOWNLOADS": "{374DE290-123F-4565-9164-39C4925E467B}",
+        "CSIDL_MYPICTURES": "My Pictures",
+        "CSIDL_MYVIDEO": "My Video",
+        "CSIDL_MYMUSIC": "My Music",
+    }.get(csidl_name)
+    if shell_folder_name is None:
+        msg = f"Unknown CSIDL name: {csidl_name}"
+        raise ValueError(msg)
+    if sys.platform != "win32":  # only needed for mypy type checker to know that this code runs only on Windows
+        raise NotImplementedError
+    import winreg
+
+    key = winreg.OpenKey(winreg.HKEY_CURRENT_USER, r"Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders")
+    directory, _ = winreg.QueryValueEx(key, shell_folder_name)
+    return str(directory)
+
+
+def get_win_folder_via_ctypes(csidl_name: str) -> str:
+    """Get folder with ctypes."""
+    # There is no 'CSIDL_DOWNLOADS'.
+    # Use 'CSIDL_PROFILE' (40) and append the default folder 'Downloads' instead.
+    # https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid
+
+    csidl_const = {
+        "CSIDL_APPDATA": 26,
+        "CSIDL_COMMON_APPDATA": 35,
+        "CSIDL_LOCAL_APPDATA": 28,
+        "CSIDL_PERSONAL": 5,
+        "CSIDL_MYPICTURES": 39,
+        "CSIDL_MYVIDEO": 14,
+        "CSIDL_MYMUSIC": 13,
+        "CSIDL_DOWNLOADS": 40,
+        "CSIDL_DESKTOPDIRECTORY": 16,
+    }.get(csidl_name)
+    if csidl_const is None:
+        msg = f"Unknown CSIDL name: {csidl_name}"
+        raise ValueError(msg)
+
+    buf = ctypes.create_unicode_buffer(1024)
+    windll = getattr(ctypes, "windll")  # noqa: B009 # using getattr to avoid false positive with mypy type checker
+    windll.shell32.SHGetFolderPathW(None, csidl_const, None, 0, buf)
+
+    # Downgrade to short path name if it has high-bit chars.
+    if any(ord(c) > 255 for c in buf):  # noqa: PLR2004
+        buf2 = ctypes.create_unicode_buffer(1024)
+        if windll.kernel32.GetShortPathNameW(buf.value, buf2, 1024):
+            buf = buf2
+
+    if csidl_name == "CSIDL_DOWNLOADS":
+        return os.path.join(buf.value, "Downloads")  # noqa: PTH118
+
+    return buf.value
+
+
+def _pick_get_win_folder() -> Callable[[str], str]:
+    if hasattr(ctypes, "windll"):
+        return get_win_folder_via_ctypes
+    try:
+        import winreg  # noqa: F401
+    except ImportError:
+        return get_win_folder_from_env_vars
+    else:
+        return get_win_folder_from_registry
+
+
+get_win_folder = lru_cache(maxsize=None)(_pick_get_win_folder())
+
+__all__ = [
+    "Windows",
+]
diff --git a/requirements.txt b/requirements.txt
index 04578ef9..bc0a4bd6 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,4 +1,3 @@
-appdirs==1.4.4
 apscheduler==3.10.1
 arrow==1.2.3
 backports.csv==1.0.7
@@ -28,6 +27,7 @@ MarkupSafe==2.1.3
 musicbrainzngs==0.7.1
 packaging==23.1
 paho-mqtt==1.6.1
+platformdirs==3.11.0
 plexapi==4.15.4
 portend==3.2.0
 profilehooks==1.12.0

From ae17d2dde036e216cf8c626596ad8cb6952ccb94 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 4 Nov 2023 13:44:49 -0700
Subject: [PATCH 486/743] Switch actions/create-release to
 softprops/action-gh-release

* actions/create-release deprecated
---
 .github/workflows/publish-installers.yml | 30 ++++--------------------
 1 file changed, 5 insertions(+), 25 deletions(-)

diff --git a/.github/workflows/publish-installers.yml b/.github/workflows/publish-installers.yml
index 0e0b1082..a9f6cda3 100644
--- a/.github/workflows/publish-installers.yml
+++ b/.github/workflows/publish-installers.yml
@@ -125,41 +125,21 @@ jobs:
           echo "$EOF" >> $GITHUB_OUTPUT
 
       - name: Create Release
-        uses: actions/create-release@v1
+        uses: softprops/action-gh-release@v1
         id: create_release
         env:
           GITHUB_TOKEN: ${{ secrets.GHACTIONS_TOKEN }}
         with:
           tag_name: ${{ steps.get_version.outputs.RELEASE_VERSION }}
-          release_name: Tautulli ${{ steps.get_version.outputs.RELEASE_VERSION }}
+          name: Tautulli ${{ steps.get_version.outputs.RELEASE_VERSION }}
           body: |
             ## Changelog
             
             ##${{ steps.get_changelog.outputs.CHANGELOG }}
-          draft: false
           prerelease: ${{ endsWith(steps.get_version.outputs.RELEASE_VERSION, '-beta') }}
-
-      - name: Upload Windows Installer
-        uses: actions/upload-release-asset@v1
-        if: env.WORKFLOW_CONCLUSION == 'success'
-        env:
-          GITHUB_TOKEN: ${{ secrets.GHACTIONS_TOKEN }}
-        with:
-          upload_url: ${{ steps.create_release.outputs.upload_url }}
-          asset_path: Tautulli-windows-installer/Tautulli-windows-${{ steps.get_version.outputs.RELEASE_VERSION }}-x64.exe
-          asset_name: Tautulli-windows-${{ steps.get_version.outputs.RELEASE_VERSION }}-x64.exe
-          asset_content_type: application/vnd.microsoft.portable-executable
-
-      - name: Upload MacOS Installer
-        uses: actions/upload-release-asset@v1
-        if: env.WORKFLOW_CONCLUSION == 'success'
-        env:
-          GITHUB_TOKEN: ${{ secrets.GHACTIONS_TOKEN }}
-        with:
-          upload_url: ${{ steps.create_release.outputs.upload_url }}
-          asset_path: Tautulli-macos-installer/Tautulli-macos-${{ steps.get_version.outputs.RELEASE_VERSION }}-x64.pkg
-          asset_name: Tautulli-macos-${{ steps.get_version.outputs.RELEASE_VERSION }}-x64.pkg
-          asset_content_type: application/vnd.apple.installer+xml
+          files: |
+            Tautulli-windows-installer/Tautulli-windows-${{ steps.get_version.outputs.RELEASE_VERSION }}-x64.exe
+            Tautulli-macos-installer/Tautulli-macos-${{ steps.get_version.outputs.RELEASE_VERSION }}-x64.pkg
 
   discord:
     name: Discord Notification

From ab5836a65b7846be835e148d89bd6de6ec781a4f Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 7 Nov 2023 17:12:19 -0800
Subject: [PATCH 487/743] Add duration_time notification parameter

---
 plexpy/common.py               | 1 +
 plexpy/notification_handler.py | 1 +
 2 files changed, 2 insertions(+)

diff --git a/plexpy/common.py b/plexpy/common.py
index 889d3f73..c692840b 100644
--- a/plexpy/common.py
+++ b/plexpy/common.py
@@ -547,6 +547,7 @@ NOTIFICATION_PARAMETERS = [
              {'name': 'Duration', 'type': 'int', 'value': 'duration', 'description': 'The duration (in minutes) for the item.'},
              {'name': 'Duration (sec)', 'type': 'int', 'value': 'duration_sec', 'description': 'The duration (in seconds) for the item.'},
              {'name': 'Duration (ms)', 'type': 'int', 'value': 'duration_ms', 'description': 'The duration (in milliseconds) for the item.'},
+             {'name': 'Duration Time', 'type': 'str', 'value': 'duration_time', 'description': 'The duration (in time format) for the item.'},
              {'name': 'Poster URL', 'type': 'str', 'value': 'poster_url', 'description': 'A URL for the movie, TV show, or album poster.'},
              {'name': 'Plex ID', 'type': 'str', 'value': 'plex_id', 'description': 'The Plex ID for the item.', 'example': 'e.g. 5d7769a9594b2b001e6a6b7e'},
              {'name': 'Plex URL', 'type': 'str', 'value': 'plex_url', 'description': 'The Plex URL to your server for the item.'},
diff --git a/plexpy/notification_handler.py b/plexpy/notification_handler.py
index 8b4b8583..b6972268 100644
--- a/plexpy/notification_handler.py
+++ b/plexpy/notification_handler.py
@@ -1155,6 +1155,7 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
         'duration': duration,
         'duration_sec': duration_sec,
         'duration_ms': notify_params['duration'],
+        'druation_time': arrow.get(duration_sec).format(duration_format),
         'poster_title': notify_params['poster_title'],
         'poster_url': notify_params['poster_url'],
         'plex_id': notify_params['plex_id'],

From 2da3714dd11c915706aa111993c7e946aff278ca Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 7 Nov 2023 17:18:48 -0800
Subject: [PATCH 488/743] Add CustomArrow date/time formatter

---
 plexpy/notification_handler.py | 47 ++++++++++++++++++++++++----------
 1 file changed, 33 insertions(+), 14 deletions(-)

diff --git a/plexpy/notification_handler.py b/plexpy/notification_handler.py
index b6972268..a7336a30 100644
--- a/plexpy/notification_handler.py
+++ b/plexpy/notification_handler.py
@@ -18,6 +18,7 @@
 
 from __future__ import division
 from __future__ import unicode_literals
+from typing import Optional
 from future.builtins import next
 from future.builtins import map
 from future.builtins import str
@@ -1006,21 +1007,21 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
         'product': notify_params['product'],
         'player': notify_params['player'],
         'ip_address': notify_params.get('ip_address', 'N/A'),
-        'started_datestamp': arrow.get(notify_params['started']).format(date_format) if notify_params['started'] else '',
-        'started_timestamp': arrow.get(notify_params['started']).format(time_format) if notify_params['started'] else '',
+        'started_datestamp': CustomArrow(arrow.get(notify_params['started']), date_format) if notify_params['started'] else '',
+        'started_timestamp': CustomArrow(arrow.get(notify_params['started']), time_format) if notify_params['started'] else '',
         'started_unixtime': notify_params['started'],
-        'stopped_datestamp': arrow.get(notify_params['stopped']).format(date_format) if notify_params['stopped'] else '',
-        'stopped_timestamp': arrow.get(notify_params['stopped']).format(time_format) if notify_params['stopped'] else '',
+        'stopped_datestamp': CustomArrow(arrow.get(notify_params['stopped']), date_format) if notify_params['stopped'] else '',
+        'stopped_timestamp': CustomArrow(arrow.get(notify_params['stopped']), time_format) if notify_params['stopped'] else '',
         'stopped_unixtime': notify_params['stopped'],
         'stream_duration': stream_duration,
         'stream_duration_sec': stream_duration_sec,
-        'stream_time': arrow.get(stream_duration_sec).format(duration_format),
+        'stream_time': CustomArrow(arrow.get(stream_duration_sec), duration_format),
         'remaining_duration': remaining_duration,
         'remaining_duration_sec': remaining_duration_sec,
-        'remaining_time': arrow.get(remaining_duration_sec).format(duration_format),
+        'remaining_time': CustomArrow(arrow.get(remaining_duration_sec), duration_format),
         'progress_duration': progress_duration,
         'progress_duration_sec': progress_duration_sec,
-        'progress_time': arrow.get(progress_duration_sec).format(duration_format),
+        'progress_time': CustomArrow(arrow.get(progress_duration_sec), duration_format),
         'progress_percent': helpers.get_percent(progress_duration_sec, duration_sec),
         'view_offset': session.get('view_offset', 0),
         'initial_stream': notify_params['initial_stream'],
@@ -1128,15 +1129,15 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
         'track_count': grandchild_count,
         'year': notify_params['year'],
         'show_year': show_year,
-        'release_date': arrow.get(notify_params['originally_available_at']).format(date_format)
+        'release_date': CustomArrow(arrow.get(notify_params['originally_available_at']), date_format)
             if notify_params['originally_available_at'] else '',
-        'air_date': arrow.get(notify_params['originally_available_at']).format(date_format)
+        'air_date': CustomArrow(arrow.get(notify_params['originally_available_at']), date_format)
             if notify_params['originally_available_at'] else '',
-        'added_date': arrow.get(int(notify_params['added_at'])).format(date_format)
+        'added_date': CustomArrow(arrow.get(int(notify_params['added_at'])), date_format)
             if notify_params['added_at'] else '',
-        'updated_date': arrow.get(int(notify_params['updated_at'])).format(date_format)
+        'updated_date': CustomArrow(arrow.get(int(notify_params['updated_at'])), date_format)
             if notify_params['updated_at'] else '',
-        'last_viewed_date': arrow.get(int(notify_params['last_viewed_at'])).format(date_format)
+        'last_viewed_date': CustomArrow(arrow.get(int(notify_params['last_viewed_at'])), date_format)
             if notify_params['last_viewed_at'] else '',
         'studio': notify_params['studio'],
         'content_rating': notify_params['content_rating'],
@@ -1155,7 +1156,7 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
         'duration': duration,
         'duration_sec': duration_sec,
         'duration_ms': notify_params['duration'],
-        'druation_time': arrow.get(duration_sec).format(duration_format),
+        'druation_time': CustomArrow(arrow.get(duration_sec), duration_format),
         'poster_title': notify_params['poster_title'],
         'poster_url': notify_params['poster_url'],
         'plex_id': notify_params['plex_id'],
@@ -1292,7 +1293,7 @@ def build_server_notify_params(notify_action=None, **kwargs):
         # Plex Media Server update parameters
         'update_version': pms_download_info['version'],
         'update_url': pms_download_info['download_url'],
-        'update_release_date': arrow.get(pms_download_info['release_date']).format(date_format)
+        'update_release_date': CustomArrow(arrow.get(pms_download_info['release_date']), date_format)
             if pms_download_info['release_date'] else '',
         'update_channel': 'Beta' if update_channel == 'beta' else 'Public',
         'update_platform': pms_download_info['platform'],
@@ -2095,3 +2096,21 @@ class CustomFormatter(Formatter):
             return ''.join(result)
         else:
             return ''.join(result), auto_arg_index
+
+
+class CustomArrow:
+    def __init__(self, arrow_value: arrow.arrow.Arrow, default_format: Optional[str] = None):
+        self.arrow_value = arrow_value
+        self.default_format = default_format
+
+    def __format__(self, formatstr: str) -> str:
+        if len(formatstr) > 0:
+            return self.arrow_value.format(formatstr)
+
+        if self.default_format is not None:
+            return self.__format__(self.default_format)
+    
+        return str(self.arrow_value)
+
+    def __str__(self) -> str:
+        return self.__format__('')

From 89aad6952b965c71a2c7bae2e698a8d727f91d53 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 9 Nov 2023 16:43:41 -0800
Subject: [PATCH 489/743] Fix activity card overflow due to screen scaling

* Fixes #2033
---
 data/interfaces/default/css/tautulli.css | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/data/interfaces/default/css/tautulli.css b/data/interfaces/default/css/tautulli.css
index 0c81f0e5..f8b15890 100644
--- a/data/interfaces/default/css/tautulli.css
+++ b/data/interfaces/default/css/tautulli.css
@@ -965,7 +965,7 @@ a .users-poster-face:hover {
     font-size: 10px;
     text-align: right;
     text-transform: uppercase;
-    line-height: 14px;
+    line-height: 10px;
     -webkit-flex-shrink: 0;
     flex-shrink: 0;
 }

From 8fd62e30b3afb88950274ee9a9cfaadc7b0572ec Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 9 Nov 2023 17:17:24 -0800
Subject: [PATCH 490/743] Fix duration_time typo

---
 plexpy/notification_handler.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/plexpy/notification_handler.py b/plexpy/notification_handler.py
index a7336a30..8f1d6263 100644
--- a/plexpy/notification_handler.py
+++ b/plexpy/notification_handler.py
@@ -1156,7 +1156,7 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
         'duration': duration,
         'duration_sec': duration_sec,
         'duration_ms': notify_params['duration'],
-        'druation_time': CustomArrow(arrow.get(duration_sec), duration_format),
+        'duration_time': CustomArrow(arrow.get(duration_sec), duration_format),
         'poster_title': notify_params['poster_title'],
         'poster_url': notify_params['poster_url'],
         'plex_id': notify_params['plex_id'],

From 5abdfd7377a6da718a67b4956b8268485e192de8 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 13 Nov 2023 11:25:39 -0800
Subject: [PATCH 491/743] Make datestamp and timestamp formattable

---
 plexpy/notification_handler.py | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/plexpy/notification_handler.py b/plexpy/notification_handler.py
index 8f1d6263..4ed08bf6 100644
--- a/plexpy/notification_handler.py
+++ b/plexpy/notification_handler.py
@@ -982,8 +982,8 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
         'current_weekday': now_iso[2],
         'current_week': now_iso[1],
         'week_number': now_iso[1],  # Keep for backwards compatibility
-        'datestamp': now.format(date_format),
-        'timestamp': now.format(time_format),
+        'datestamp': CustomArrow(now, date_format),
+        'timestamp': CustomArrow(now, time_format),
         'unixtime': helpers.timestamp(),
         'utctime': helpers.utc_now_iso(),
         # Stream parameters
@@ -1278,8 +1278,8 @@ def build_server_notify_params(notify_action=None, **kwargs):
         'current_weekday': now_iso[2],
         'current_week': now_iso[1],
         'week_number': now_iso[1],  # Keep for backwards compatibility
-        'datestamp': now.format(date_format),
-        'timestamp': now.format(time_format),
+        'datestamp': CustomArrow(now, date_format),
+        'timestamp': CustomArrow(now, time_format),
         'unixtime': helpers.timestamp(),
         'utctime': helpers.utc_now_iso(),
         # Plex remote access parameters

From 98c363f559365e927b41bde3549bce6b37021df1 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 13 Nov 2023 11:28:53 -0800
Subject: [PATCH 492/743] Update Notification Text Modifiers modal with Time
 Formats

---
 data/interfaces/default/settings.html | 15 +++++++++++++++
 plexpy/common.py                      |  2 +-
 2 files changed, 16 insertions(+), 1 deletion(-)

diff --git a/data/interfaces/default/settings.html b/data/interfaces/default/settings.html
index 6710ff79..e5b0b321 100644
--- a/data/interfaces/default/settings.html
+++ b/data/interfaces/default/settings.html
@@ -1923,6 +1923,21 @@
                         <p><strong style="color: #fff;">Example:</strong></p>
                         <pre>{media_type}   --> movie
 {media_type!c} --> Movie</pre>
+                    </div>
+                    <div>
+                        <h4>Time Formats</h4>
+                    </div>
+                    <div style="padding-bottom: 10px;">
+                        <p class="help-block">
+                            Notification parameters which are "in date format" or "in time format" can be formatted using the
+                            <a href="javascript:void(0)" data-target="#dateTimeOptionsModal" data-toggle="modal">Date & Time Format Options</a>
+                            by adding a <span class="inline-pre">:format</span> specifier.
+                            If no format is specified, the default Date Format and Time Format under Settings > General will be used.
+                        </p>
+                        <p><strong style="color: #fff;">Example:</strong></p>
+                        <pre>{started_datestamp:ddd, MMMM DD, YYYY}   --> Mon, December 25, 2023
+{stopped_timestamp:h:mm a}               --> 9:56 pm
+{duration_time:HH:mm:ss}                 --> 01:42:20</pre>
                     </div>
                     <div>
                         <h4>List Slicing</h4>
diff --git a/plexpy/common.py b/plexpy/common.py
index c692840b..79b76b5c 100644
--- a/plexpy/common.py
+++ b/plexpy/common.py
@@ -636,7 +636,7 @@ NOTIFICATION_PARAMETERS = [
         'parameters': [
              {'name': 'Update Version', 'type': 'str', 'value': 'update_version', 'description': 'The available update version for your Plex Server.'},
              {'name': 'Update Url', 'type': 'str', 'value': 'update_url', 'description': 'The download URL for the available update.'},
-             {'name': 'Update Release Date', 'type': 'str', 'value': 'update_release_date', 'description': 'The release date of the available update.'},
+             {'name': 'Update Release Date', 'type': 'str', 'value': 'update_release_date', 'description': 'The release date (in date format) of the available update.'},
              {'name': 'Update Channel', 'type': 'str', 'value': 'update_channel', 'description': 'The update channel.', 'example': 'Public or Plex Pass'},
              {'name': 'Update Platform', 'type': 'str', 'value': 'update_platform', 'description': 'The platform of your Plex Server.'},
              {'name': 'Update Distro', 'type': 'str', 'value': 'update_distro', 'description': 'The distro of your Plex Server.'},

From 380cbd232c90290971f2d43e9c8fbbff1777ffa6 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 19 Nov 2023 13:05:16 -0800
Subject: [PATCH 493/743] Add file_size_bytes notification parameter

* Change type of file_size parameter and update description to indicate it is in human readable format.
---
 plexpy/common.py               | 3 ++-
 plexpy/notification_handler.py | 1 +
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/plexpy/common.py b/plexpy/common.py
index 79b76b5c..b0e22147 100644
--- a/plexpy/common.py
+++ b/plexpy/common.py
@@ -604,7 +604,8 @@ NOTIFICATION_PARAMETERS = [
              {'name': 'Subtitle Language Code', 'type': 'str', 'value': 'subtitle_language_code', 'description': 'The subtitle language code of the original media.'},
              {'name': 'File', 'type': 'str', 'value': 'file', 'description': 'The file path to the item.'},
              {'name': 'Filename', 'type': 'str', 'value': 'filename', 'description': 'The file name of the item.'},
-             {'name': 'File Size', 'type': 'int', 'value': 'file_size', 'description': 'The file size of the item.'},
+             {'name': 'File Size', 'type': 'str', 'value': 'file_size', 'description': 'The file size of the item in human readable format.', 'example': '1.2 GB'},
+             {'name': 'File Size Bytes', 'type': 'int', 'value': 'file_size_bytes', 'description': 'The file size of the item in bytes.'},
              {'name': 'Guid', 'type': 'str', 'value': 'guid', 'description': 'The full guid for the item.'},
              {'name': 'Section ID', 'type': 'int', 'value': 'section_id', 'description': 'The unique identifier for the library.'},
              {'name': 'Rating Key', 'type': 'int', 'value': 'rating_key', 'description': 'The unique identifier for the movie, episode, or track.'},
diff --git a/plexpy/notification_handler.py b/plexpy/notification_handler.py
index 4ed08bf6..14e20750 100644
--- a/plexpy/notification_handler.py
+++ b/plexpy/notification_handler.py
@@ -1215,6 +1215,7 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
         'file': notify_params['file'],
         'filename': os.path.basename(notify_params['file'].replace('\\', os.sep)),
         'file_size': helpers.human_file_size(notify_params['file_size']),
+        'file_size_bytes': notify_params['file_size'],
         'indexes': notify_params['indexes'],
         'guid': notify_params['guid'],
         'section_id': notify_params['section_id'],

From d0c1e467bd42bf3c38733b3bf324a7e6e81bcc39 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 19 Nov 2023 13:46:57 -0800
Subject: [PATCH 494/743] Add support for thetvdb_url for movies

---
 plexpy/common.py               | 8 ++++----
 plexpy/notification_handler.py | 7 ++++---
 plexpy/notifiers.py            | 1 +
 3 files changed, 9 insertions(+), 7 deletions(-)

diff --git a/plexpy/common.py b/plexpy/common.py
index b0e22147..9496913f 100644
--- a/plexpy/common.py
+++ b/plexpy/common.py
@@ -551,10 +551,10 @@ NOTIFICATION_PARAMETERS = [
              {'name': 'Poster URL', 'type': 'str', 'value': 'poster_url', 'description': 'A URL for the movie, TV show, or album poster.'},
              {'name': 'Plex ID', 'type': 'str', 'value': 'plex_id', 'description': 'The Plex ID for the item.', 'example': 'e.g. 5d7769a9594b2b001e6a6b7e'},
              {'name': 'Plex URL', 'type': 'str', 'value': 'plex_url', 'description': 'The Plex URL to your server for the item.'},
-             {'name': 'IMDB ID', 'type': 'str', 'value': 'imdb_id', 'description': 'The IMDB ID for the movie.', 'example': 'e.g. tt2488496'},
-             {'name': 'IMDB URL', 'type': 'str', 'value': 'imdb_url', 'description': 'The IMDB URL for the movie.'},
-             {'name': 'TVDB ID', 'type': 'int', 'value': 'thetvdb_id', 'description': 'The TVDB ID for the TV show.', 'example': 'e.g. 121361'},
-             {'name': 'TVDB URL', 'type': 'str', 'value': 'thetvdb_url', 'description': 'The TVDB URL for the TV show.'},
+             {'name': 'IMDB ID', 'type': 'str', 'value': 'imdb_id', 'description': 'The IMDB ID for the movie or TV show.', 'example': 'e.g. tt2488496'},
+             {'name': 'IMDB URL', 'type': 'str', 'value': 'imdb_url', 'description': 'The IMDB URL for the movie or TV show.'},
+             {'name': 'TVDB ID', 'type': 'int', 'value': 'thetvdb_id', 'description': 'The TVDB ID for the movie or TV show.', 'example': 'e.g. 121361'},
+             {'name': 'TVDB URL', 'type': 'str', 'value': 'thetvdb_url', 'description': 'The TVDB URL for the movie or TV show.'},
              {'name': 'TMDB ID', 'type': 'int', 'value': 'themoviedb_id', 'description': 'The TMDb ID for the movie or TV show.', 'example': 'e.g. 15260'},
              {'name': 'TMDB URL', 'type': 'str', 'value': 'themoviedb_url', 'description': 'The TMDb URL for the movie or TV show.'},
              {'name': 'TVmaze ID', 'type': 'int', 'value': 'tvmaze_id', 'description': 'The TVmaze ID for the TV show.', 'example': 'e.g. 290'},
diff --git a/plexpy/notification_handler.py b/plexpy/notification_handler.py
index 14e20750..34a60cd6 100644
--- a/plexpy/notification_handler.py
+++ b/plexpy/notification_handler.py
@@ -699,13 +699,14 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
         notify_params['trakt_url'] = 'https://trakt.tv/search/imdb/' + notify_params['imdb_id']
 
     if 'thetvdb://' in notify_params['guid'] or notify_params['thetvdb_id']:
+        thetvdb_media_type = 'movie' if notify_params['media_type'] == 'movie' else 'series'
         notify_params['thetvdb_id'] = notify_params['thetvdb_id'] or notify_params['guid'].split('thetvdb://')[1].split('/')[0].split('?')[0]
-        notify_params['thetvdb_url'] = 'https://thetvdb.com/?tab=series&id=' + notify_params['thetvdb_id']
+        notify_params['thetvdb_url'] = f'https://thetvdb.com/dereferrer/{thetvdb_media_type}/{notify_params["thetvdb_id"]}'
         notify_params['trakt_url'] = 'https://trakt.tv/search/tvdb/' + notify_params['thetvdb_id'] + '?type=show'
 
     elif 'thetvdbdvdorder://' in notify_params['guid']:
         notify_params['thetvdb_id'] = notify_params['guid'].split('thetvdbdvdorder://')[1].split('/')[0].split('?')[0]
-        notify_params['thetvdb_url'] = 'https://thetvdb.com/?tab=series&id=' + notify_params['thetvdb_id']
+        notify_params['thetvdb_url'] = f'https://thetvdb.com/dereferrer/series/{notify_params["thetvdb_id"]}'
         notify_params['trakt_url'] = 'https://trakt.tv/search/tvdb/' + notify_params['thetvdb_id'] + '?type=show'
 
     if 'themoviedb://' in notify_params['guid'] or notify_params['themoviedb_id']:
@@ -806,7 +807,7 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
             notify_params.update(tvmaze_info)
 
             if tvmaze_info.get('thetvdb_id'):
-                notify_params['thetvdb_url'] = 'https://thetvdb.com/?tab=series&id=' + str(tvmaze_info['thetvdb_id'])
+                notify_params['thetvdb_url'] = f'https://thetvdb.com/dereferrer/series/{tvmaze_info["thetvdb_id"]}'
                 notify_params['trakt_url'] = 'https://trakt.tv/search/tvdb/{}' + str(notify_params['thetvdb_id']) + '?type=show'
             if tvmaze_info.get('imdb_id'):
                 notify_params['imdb_url'] = 'https://www.imdb.com/title/' + tvmaze_info['imdb_id']
diff --git a/plexpy/notifiers.py b/plexpy/notifiers.py
index 1e18644e..1e890806 100644
--- a/plexpy/notifiers.py
+++ b/plexpy/notifiers.py
@@ -807,6 +807,7 @@ class PrettyMetadata(object):
                 'plexweb': 'Plex Web',
                 'imdb': 'IMDB',
                 'themoviedb': 'The Movie Database',
+                'thetvdb': 'TheTVDB',
                 'trakt': 'Trakt.tv'
                 }
 

From ddc8a08fc7cea4c31a36a42e283a60e78495c4f6 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 21 Nov 2023 11:35:54 -0800
Subject: [PATCH 495/743] Replace usage of utcnow()

`datetime.utcnow()` deprecated in Python 3.12
---
 plexpy/helpers.py | 12 ++++++------
 plexpy/webauth.py |  2 +-
 2 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/plexpy/helpers.py b/plexpy/helpers.py
index 486be759..a3257403 100644
--- a/plexpy/helpers.py
+++ b/plexpy/helpers.py
@@ -28,7 +28,7 @@ from cloudinary.api import delete_resources_by_tag
 from cloudinary.uploader import upload
 from cloudinary.utils import cloudinary_url
 from collections import OrderedDict
-import datetime
+from datetime import date, datetime, timezone
 from functools import reduce, wraps
 import hashlib
 import imghdr
@@ -222,14 +222,14 @@ def timestamp():
 
 
 def today():
-    today = datetime.date.today()
-    yyyymmdd = datetime.date.isoformat(today)
+    today = date.today()
+    yyyymmdd = date.isoformat(today)
 
     return yyyymmdd
 
 
 def utc_now_iso():
-    utcnow = datetime.datetime.utcnow()
+    utcnow = datetime.now(tz=timezone.utc).replace(tzinfo=None)
 
     return utcnow.isoformat()
 
@@ -246,7 +246,7 @@ def timestamp_to_YMDHMS(ts, sep=False):
 
 
 def timestamp_to_datetime(ts):
-    return datetime.datetime.fromtimestamp(ts)
+    return datetime.fromtimestamp(ts)
 
 
 def iso_to_YMD(iso):
@@ -258,7 +258,7 @@ def iso_to_datetime(iso):
 
 
 def datetime_to_iso(dt, to_date=False):
-    if isinstance(dt, datetime.datetime):
+    if isinstance(dt, datetime):
         if to_date:
             dt = dt.date()
         return dt.isoformat()
diff --git a/plexpy/webauth.py b/plexpy/webauth.py
index 5487f2ea..c3c3f7e2 100644
--- a/plexpy/webauth.py
+++ b/plexpy/webauth.py
@@ -378,7 +378,7 @@ class AuthController(object):
 
         if valid_login:
             time_delta = timedelta(days=30) if remember_me == '1' else timedelta(minutes=60)
-            expiry = datetime.utcnow() + time_delta
+            expiry = datetime.now() + time_delta
 
             payload = {
                 'user_id': user_details['user_id'],

From 325271a88eb884f58a646416b6a1a2841371ef8a Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 3 Dec 2023 13:33:37 -0800
Subject: [PATCH 496/743] Update the stream duration on activity cards

* Fixes #2206

Some clients like Plexamp use the same sessionKey when the track changes.
---
 data/interfaces/default/index.html | 1 +
 1 file changed, 1 insertion(+)

diff --git a/data/interfaces/default/index.html b/data/interfaces/default/index.html
index 57236e69..4a74b2e4 100644
--- a/data/interfaces/default/index.html
+++ b/data/interfaces/default/index.html
@@ -584,6 +584,7 @@
 
                         // Update the stream progress times
                         $('#stream-eta-' + key).html(moment().add(parseInt(s.duration) - parseInt(s.view_offset), 'milliseconds').format(time_format));
+                        $('#stream-duration-' + key).html(millisecondsToMinutes(parseInt(s.stream_duration), false));
                         var stream_view_offset = $('#stream-view-offset-' + key);
                         stream_view_offset.data('state', s.state);
                         if (stream_view_offset.data('last_view_offset') !== s.view_offset) {

From 98ceb0a81d45f177dbc8cb8cfca86f1d2e585624 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 3 Dec 2023 13:45:13 -0800
Subject: [PATCH 497/743] Add time formats to order of notification text
 modifiers

---
 data/interfaces/default/settings.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/data/interfaces/default/settings.html b/data/interfaces/default/settings.html
index e5b0b321..883d4d3d 100644
--- a/data/interfaces/default/settings.html
+++ b/data/interfaces/default/settings.html
@@ -2009,7 +2009,7 @@ Rating: {rating}/10   --> Rating: /10
                             <li>Evaluation</li>
                             <li>Parameter</li>
                             <li>Case Modifier</li>
-                            <li>List Slicing</li>
+                            <li>Time Formats / List Slicing</li>
                             <li>Suffix</li>
                         </ol>
                         <p><strong style="color: #fff;">Example:</strong></p>

From 8cb74f74806863abbc47419d85b002abb600ea00 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 3 Dec 2023 13:49:55 -0800
Subject: [PATCH 498/743] v2.13.3

---
 CHANGELOG.md      | 14 ++++++++++++++
 plexpy/version.py |  2 +-
 2 files changed, 15 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index d5eb4c5a..ff82a7a0 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,6 +1,19 @@
 # Changelog
 
+## v2.13.3 (2023-12-03)
+
+* Notifications:
+  * New: Added duration_time notification parameter.
+  * New: Added file_size_bytes notification parameter.
+  * New: Added time formats notification text modifiers.
+  * New: Added support for thetvdb_url for movies.
+* UI:
+  * Fix: Activity card overflowing due to screen scaling. (#2033)
+  * Fix: Stream duration on activity card not being updated on track changes in some cases. (@2206)
+
+
 ## v2.13.2 (2023-10-26)
+
 * History:
   * New: Added quarter values icons for history watch status. (#2179, #2156) (Thanks @herby2212)
 * Graphs:
@@ -15,6 +28,7 @@
 
 
 ## v2.13.1 (2023-08-25)
+
 * Notes:
   * Support for Python 3.7 has been dropped. The minimum Python version is now 3.8.
 * Other:
diff --git a/plexpy/version.py b/plexpy/version.py
index 5ca70297..c52bd955 100644
--- a/plexpy/version.py
+++ b/plexpy/version.py
@@ -18,4 +18,4 @@
 from __future__ import unicode_literals
 
 PLEXPY_BRANCH = "master"
-PLEXPY_RELEASE_VERSION = "v2.13.2"
\ No newline at end of file
+PLEXPY_RELEASE_VERSION = "v2.13.3"
\ No newline at end of file

From 5525b9851cd15508da3a4ecce87916445b1bc66e Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 3 Dec 2023 14:02:51 -0800
Subject: [PATCH 499/743] Fix issue number in changelog

---
 CHANGELOG.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index ff82a7a0..2ee3bb33 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -9,7 +9,7 @@
   * New: Added support for thetvdb_url for movies.
 * UI:
   * Fix: Activity card overflowing due to screen scaling. (#2033)
-  * Fix: Stream duration on activity card not being updated on track changes in some cases. (@2206)
+  * Fix: Stream duration on activity card not being updated on track changes in some cases. (#2206)
 
 
 ## v2.13.2 (2023-10-26)

From e3113ebd309739a755c95ec1b8b6d94709d2d016 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Wed, 6 Dec 2023 13:20:33 -0800
Subject: [PATCH 500/743] Fix configuration table None system language

---
 data/interfaces/default/configuration_table.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/data/interfaces/default/configuration_table.html b/data/interfaces/default/configuration_table.html
index 66d8ef40..e0f3155d 100644
--- a/data/interfaces/default/configuration_table.html
+++ b/data/interfaces/default/configuration_table.html
@@ -74,7 +74,7 @@ DOCUMENTATION :: END
         </tr>
         <tr>
             <td>System Language:</td>
-            <td>${plexpy.SYS_LANGUAGE + (' (override {})'.format(plexpy.CONFIG.PMS_LANGUAGE) if plexpy.CONFIG.PMS_LANGUAGE else '')}</td>
+            <td>${plexpy.SYS_LANGUAGE}${' (override {})'.format(plexpy.CONFIG.PMS_LANGUAGE) if plexpy.CONFIG.PMS_LANGUAGE else ''}</td>
         </tr>
         <tr>
             <td>Python Version:</td>

From fe7a59c7f94804df2051018c63ed5fa2d3c2d23f Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Wed, 6 Dec 2023 23:09:32 -0800
Subject: [PATCH 501/743] Fix use UTC for JWT expiry and max-age for cookie

---
 plexpy/webauth.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/plexpy/webauth.py b/plexpy/webauth.py
index c3c3f7e2..cc6c6579 100644
--- a/plexpy/webauth.py
+++ b/plexpy/webauth.py
@@ -22,7 +22,7 @@
 
 from future.builtins import object
 
-from datetime import datetime, timedelta
+from datetime import datetime, timedelta, timezone
 from future.moves.urllib.parse import quote, unquote
 
 import cherrypy
@@ -378,7 +378,7 @@ class AuthController(object):
 
         if valid_login:
             time_delta = timedelta(days=30) if remember_me == '1' else timedelta(minutes=60)
-            expiry = datetime.now() + time_delta
+            expiry = datetime.now(tz=timezone.utc) + time_delta
 
             payload = {
                 'user_id': user_details['user_id'],
@@ -399,7 +399,7 @@ class AuthController(object):
 
             jwt_cookie = str(JWT_COOKIE_NAME + plexpy.CONFIG.PMS_UUID)
             cherrypy.response.cookie[jwt_cookie] = jwt_token
-            cherrypy.response.cookie[jwt_cookie]['expires'] = int(time_delta.total_seconds())
+            cherrypy.response.cookie[jwt_cookie]['max-age'] = int(time_delta.total_seconds())
             cherrypy.response.cookie[jwt_cookie]['path'] = plexpy.HTTP_ROOT.rstrip('/') or '/'
             cherrypy.response.cookie[jwt_cookie]['httponly'] = True
             cherrypy.response.cookie[jwt_cookie]['samesite'] = 'lax'

From d019efcf911b4806618761c2da48bab7d04031ec Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Wed, 6 Dec 2023 23:18:16 -0800
Subject: [PATCH 502/743] v2.13.4

---
 CHANGELOG.md      | 7 +++++++
 plexpy/version.py | 2 +-
 2 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 2ee3bb33..26dc180c 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,12 @@
 # Changelog
 
+## v2.13.4 (2023-12-07)
+
+* UI:
+  * Fix: Tautulli configuration settings page not loading when system language is None.
+  * Fix: Login cookie expiring too quickly.
+
+
 ## v2.13.3 (2023-12-03)
 
 * Notifications:
diff --git a/plexpy/version.py b/plexpy/version.py
index c52bd955..433710bc 100644
--- a/plexpy/version.py
+++ b/plexpy/version.py
@@ -18,4 +18,4 @@
 from __future__ import unicode_literals
 
 PLEXPY_BRANCH = "master"
-PLEXPY_RELEASE_VERSION = "v2.13.3"
\ No newline at end of file
+PLEXPY_RELEASE_VERSION = "v2.13.4"
\ No newline at end of file

From d0c07326ab617731f74ae5d2dde4c014132796b3 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 7 Dec 2023 23:05:34 -0800
Subject: [PATCH 503/743] Change cookie expires to max-age

---
 plexpy/webauth.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/plexpy/webauth.py b/plexpy/webauth.py
index cc6c6579..768b2d64 100644
--- a/plexpy/webauth.py
+++ b/plexpy/webauth.py
@@ -337,12 +337,12 @@ class AuthController(object):
 
         jwt_cookie = str(JWT_COOKIE_NAME + plexpy.CONFIG.PMS_UUID)
         cherrypy.response.cookie[jwt_cookie] = ''
-        cherrypy.response.cookie[jwt_cookie]['expires'] = 0
+        cherrypy.response.cookie[jwt_cookie]['max-age'] = 0
         cherrypy.response.cookie[jwt_cookie]['path'] = plexpy.HTTP_ROOT.rstrip('/') or '/'
 
         if plexpy.HTTP_ROOT != '/':
             # Also expire the JWT on the root path
-            cherrypy.response.headers['Set-Cookie'] = jwt_cookie + '=""; expires=Thu, 01 Jan 1970 12:00:00 GMT; path=/'
+            cherrypy.response.headers['Set-Cookie'] = jwt_cookie + '=""; max-age=0; path=/'
 
         cherrypy.request.login = None
 

From c172965ec8098bbb45abff9072b8f691d96aac19 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 17 Feb 2024 23:18:13 +0000
Subject: [PATCH 504/743] Don't need to refresh Pushover config after entering
 token

---
 plexpy/notifiers.py | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/plexpy/notifiers.py b/plexpy/notifiers.py
index 1e890806..bf033a9f 100644
--- a/plexpy/notifiers.py
+++ b/plexpy/notifiers.py
@@ -3284,8 +3284,7 @@ class PUSHOVER(Notifier):
                           'value': self.config['api_token'],
                           'name': 'pushover_api_token',
                           'description': 'Your Pushover API token.',
-                          'input_type': 'token',
-                          'refresh': True
+                          'input_type': 'token'
                           },
                          {'label': 'Pushover User or Group Key',
                           'value': self.config['key'],

From 040972bcbab905d17f011a515b00bd86f145f63d Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 19 Feb 2024 17:31:28 -0800
Subject: [PATCH 505/743] Increase PBKDF2 iterations to 600,000

OWASP Cheat Sheet recommends 600,000 iterations.

https://cheatsheetseries.owasp.org/cheatsheets/Password_Storage_Cheat_Sheet.html#pbkdf2
---
 lib/hashing_passwords.py | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/lib/hashing_passwords.py b/lib/hashing_passwords.py
index 4540db75..beea1e85 100644
--- a/lib/hashing_passwords.py
+++ b/lib/hashing_passwords.py
@@ -16,7 +16,6 @@
 
 """
 
-import hashlib
 from os import urandom
 from base64 import b64encode, b64decode
 from hashlib import pbkdf2_hmac
@@ -30,7 +29,7 @@ HASH_FUNCTION = 'sha256'  # Must be in hashlib.
 # Linear to the hashing time. Adjust to be high but take a reasonable
 # amount of time on your server. Measure with:
 # python -m timeit -s 'import passwords as p' 'p.make_hash("something")'
-COST_FACTOR = 10000
+COST_FACTOR = 600000
 
 
 def make_hash(password):

From b1c0972077f935d268bb94944d3cbeeae1c9d22e Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 2 Mar 2024 13:52:45 -0800
Subject: [PATCH 506/743] Bump plexapi from 4.15.4 to 4.15.10 (#2251)

* Bump plexapi from 4.15.4 to 4.15.10

Bumps [plexapi](https://github.com/pkkid/python-plexapi) from 4.15.4 to 4.15.10.
- [Release notes](https://github.com/pkkid/python-plexapi/releases)
- [Commits](https://github.com/pkkid/python-plexapi/compare/4.15.4...4.15.10)

---
updated-dependencies:
- dependency-name: plexapi
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

* Update plexapi==4.15.10

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/plexapi/audio.py      |  47 +++++++++++-
 lib/plexapi/base.py       |  53 ++++++++++---
 lib/plexapi/client.py     |   5 +-
 lib/plexapi/collection.py |   2 +-
 lib/plexapi/const.py      |   2 +-
 lib/plexapi/exceptions.py |   5 ++
 lib/plexapi/library.py    |  51 ++++++++++---
 lib/plexapi/media.py      |  56 +++++++-------
 lib/plexapi/mixins.py     | 152 ++++++++++++++++++++++++--------------
 lib/plexapi/myplex.py     |  20 ++++-
 lib/plexapi/photo.py      |   3 +
 lib/plexapi/playlist.py   |  16 +++-
 lib/plexapi/server.py     |   3 +-
 lib/plexapi/utils.py      |  33 ++++-----
 lib/plexapi/video.py      | 152 ++++++++++++++++++++++++--------------
 requirements.txt          |   2 +-
 16 files changed, 413 insertions(+), 189 deletions(-)

diff --git a/lib/plexapi/audio.py b/lib/plexapi/audio.py
index 2a169877..370fe0dc 100644
--- a/lib/plexapi/audio.py
+++ b/lib/plexapi/audio.py
@@ -3,6 +3,8 @@ import os
 from pathlib import Path
 from urllib.parse import quote_plus
 
+from typing import Any, Dict, List, Optional, TypeVar
+
 from plexapi import media, utils
 from plexapi.base import Playable, PlexPartialObject, PlexHistory, PlexSession
 from plexapi.exceptions import BadRequest
@@ -14,6 +16,9 @@ from plexapi.mixins import (
 from plexapi.playlist import Playlist
 
 
+TAudio = TypeVar("TAudio", bound="Audio")
+
+
 class Audio(PlexPartialObject, PlayedUnplayedMixin):
     """ Base class for all audio objects including :class:`~plexapi.audio.Artist`,
         :class:`~plexapi.audio.Album`, and :class:`~plexapi.audio.Track`.
@@ -22,6 +27,7 @@ class Audio(PlexPartialObject, PlayedUnplayedMixin):
             addedAt (datetime): Datetime the item was added to the library.
             art (str): URL to artwork image (/library/metadata/<ratingKey>/art/<artid>).
             artBlurHash (str): BlurHash string for artwork image.
+            distance (float): Sonic Distance of the item from the seed item.
             fields (List<:class:`~plexapi.media.Field`>): List of field objects.
             guid (str): Plex GUID for the artist, album, or track (plex://artist/5d07bcb0403c64029053ac4c).
             index (int): Plex index number (often the track number).
@@ -53,6 +59,7 @@ class Audio(PlexPartialObject, PlayedUnplayedMixin):
         self.addedAt = utils.toDatetime(data.attrib.get('addedAt'))
         self.art = data.attrib.get('art')
         self.artBlurHash = data.attrib.get('artBlurHash')
+        self.distance = utils.cast(float, data.attrib.get('distance'))
         self.fields = self.findItems(data, media.Field)
         self.guid = data.attrib.get('guid')
         self.index = utils.cast(int, data.attrib.get('index'))
@@ -125,6 +132,37 @@ class Audio(PlexPartialObject, PlayedUnplayedMixin):
 
         return myplex.sync(sync_item, client=client, clientId=clientId)
 
+    def sonicallySimilar(
+        self: TAudio,
+        limit: Optional[int] = None,
+        maxDistance: Optional[float] = None,
+        **kwargs,
+    ) -> List[TAudio]:
+        """Returns a list of sonically similar audio items.
+
+        Parameters:
+            limit (int): Maximum count of items to return. Default 50 (server default)
+            maxDistance (float): Maximum distance between tracks, 0.0 - 1.0. Default 0.25 (server default).
+            **kwargs: Additional options passed into :func:`~plexapi.base.PlexObject.fetchItems`.
+
+        Returns:
+            List[:class:`~plexapi.audio.Audio`]: list of sonically similar audio items.
+        """
+
+        key = f"{self.key}/nearest"
+        params: Dict[str, Any] = {}
+        if limit is not None:
+            params['limit'] = limit
+        if maxDistance is not None:
+            params['maxDistance'] = maxDistance
+        key += utils.joinArgs(params)
+
+        return self.fetchItems(
+            key,
+            cls=type(self),
+            **kwargs,
+        )
+
 
 @utils.registerPlexObject
 class Artist(
@@ -189,7 +227,7 @@ class Artist(
         """ Returns a list of :class:`~plexapi.audio.Album` objects by the artist. """
         return self.section().search(
             libtype='album',
-            filters={'artist.id': self.ratingKey},
+            filters={**kwargs.pop('filters', {}), 'artist.id': self.ratingKey},
             **kwargs
         )
 
@@ -251,7 +289,7 @@ class Artist(
 @utils.registerPlexObject
 class Album(
     Audio,
-    UnmatchMatchMixin, RatingMixin,
+    SplitMergeMixin, UnmatchMatchMixin, RatingMixin,
     ArtMixin, PosterMixin, ThemeUrlMixin,
     AlbumEditMixins
 ):
@@ -389,6 +427,7 @@ class Track(
             chapterSource (str): Unknown
             collections (List<:class:`~plexapi.media.Collection`>): List of collection objects.
             duration (int): Length of the track in milliseconds.
+            genres (List<:class:`~plexapi.media.Genre`>): List of genre objects.
             grandparentArt (str): URL to album artist artwork (/library/metadata/<grandparentRatingKey>/art/<artid>).
             grandparentGuid (str): Plex GUID for the album artist (plex://artist/5d07bcb0403c64029053ac4c).
             grandparentKey (str): API URL of the album artist (/library/metadata/<grandparentRatingKey>).
@@ -411,6 +450,8 @@ class Track(
             primaryExtraKey (str) API URL for the primary extra for the track.
             ratingCount (int): Number of listeners who have scrobbled this track, as reported by Last.fm.
             skipCount (int): Number of times the track has been skipped.
+            sourceURI (str): Remote server URI (server://<machineIdentifier>/com.plexapp.plugins.library)
+                (remote playlist item only).
             viewOffset (int): View offset in milliseconds.
             year (int): Year the track was released.
     """
@@ -425,6 +466,7 @@ class Track(
         self.chapterSource = data.attrib.get('chapterSource')
         self.collections = self.findItems(data, media.Collection)
         self.duration = utils.cast(int, data.attrib.get('duration'))
+        self.genres = self.findItems(data, media.Genre)
         self.grandparentArt = data.attrib.get('grandparentArt')
         self.grandparentGuid = data.attrib.get('grandparentGuid')
         self.grandparentKey = data.attrib.get('grandparentKey')
@@ -445,6 +487,7 @@ class Track(
         self.primaryExtraKey = data.attrib.get('primaryExtraKey')
         self.ratingCount = utils.cast(int, data.attrib.get('ratingCount'))
         self.skipCount = utils.cast(int, data.attrib.get('skipCount'))
+        self.sourceURI = data.attrib.get('source')  # remote playlist item
         self.viewOffset = utils.cast(int, data.attrib.get('viewOffset', 0))
         self.year = utils.cast(int, data.attrib.get('year'))
 
diff --git a/lib/plexapi/base.py b/lib/plexapi/base.py
index 822e40ea..52063c00 100644
--- a/lib/plexapi/base.py
+++ b/lib/plexapi/base.py
@@ -22,12 +22,12 @@ OPERATORS = {
     'lt': lambda v, q: v < q,
     'lte': lambda v, q: v <= q,
     'startswith': lambda v, q: v.startswith(q),
-    'istartswith': lambda v, q: v.lower().startswith(q),
+    'istartswith': lambda v, q: v.lower().startswith(q.lower()),
     'endswith': lambda v, q: v.endswith(q),
-    'iendswith': lambda v, q: v.lower().endswith(q),
+    'iendswith': lambda v, q: v.lower().endswith(q.lower()),
     'exists': lambda v, q: v is not None if q else v is None,
-    'regex': lambda v, q: re.match(q, v),
-    'iregex': lambda v, q: re.match(q, v, flags=re.IGNORECASE),
+    'regex': lambda v, q: bool(re.search(q, v)),
+    'iregex': lambda v, q: bool(re.search(q, v, flags=re.IGNORECASE)),
 }
 
 
@@ -98,7 +98,7 @@ class PlexObject:
         ecls = utils.PLEXOBJECTS.get(ehash, utils.PLEXOBJECTS.get(elem.tag))
         # log.debug('Building %s as %s', elem.tag, ecls.__name__)
         if ecls is not None:
-            return ecls(self._server, elem, initpath)
+            return ecls(self._server, elem, initpath, parent=self)
         raise UnknownType(f"Unknown library type <{elem.tag} type='{etype}'../>")
 
     def _buildItemOrNone(self, elem, cls=None, initpath=None):
@@ -227,7 +227,8 @@ class PlexObject:
 
                     fetchItem(ekey, viewCount__gte=0)
                     fetchItem(ekey, Media__container__in=["mp4", "mkv"])
-                    fetchItem(ekey, guid__iregex=r"(imdb://|themoviedb://)")
+                    fetchItem(ekey, guid__regex=r"com\.plexapp\.agents\.(imdb|themoviedb)://|tt\d+")
+                    fetchItem(ekey, guid__id__regex=r"(imdb|tmdb|tvdb)://")
                     fetchItem(ekey, Media__Part__file__startswith="D:\\Movies")
 
         """
@@ -439,7 +440,7 @@ class PlexObject:
         attrstr = parts[1] if len(parts) == 2 else None
         if attrstr:
             results = [] if results is None else results
-            for child in [c for c in elem if c.tag.lower() == attr.lower()]:
+            for child in (c for c in elem if c.tag.lower() == attr.lower()):
                 results += self._getAttrValue(child, attrstr, results)
             return [r for r in results if r is not None]
         # check were looking for the tag
@@ -565,6 +566,14 @@ class PlexPartialObject(PlexObject):
         """ Returns True if this is not a full object. """
         return not self.isFullObject()
 
+    def isLocked(self, field: str):
+        """ Returns True if the specified field is locked, otherwise False.
+
+            Parameters:
+                field (str): The name of the field.
+        """
+        return next((f.locked for f in self.fields if f.name == field), False)
+
     def _edit(self, **kwargs):
         """ Actually edit an object. """
         if isinstance(self._edits, dict):
@@ -763,6 +772,30 @@ class Playable:
             for part in item.parts:
                 yield part
 
+    def videoStreams(self):
+        """ Returns a list of :class:`~plexapi.media.videoStream` objects for all MediaParts. """
+        if self.isPartialObject():
+            self.reload()
+        return sum((part.videoStreams() for part in self.iterParts()), [])
+
+    def audioStreams(self):
+        """ Returns a list of :class:`~plexapi.media.AudioStream` objects for all MediaParts. """
+        if self.isPartialObject():
+            self.reload()
+        return sum((part.audioStreams() for part in self.iterParts()), [])
+
+    def subtitleStreams(self):
+        """ Returns a list of :class:`~plexapi.media.SubtitleStream` objects for all MediaParts. """
+        if self.isPartialObject():
+            self.reload()
+        return sum((part.subtitleStreams() for part in self.iterParts()), [])
+
+    def lyricStreams(self):
+        """ Returns a list of :class:`~plexapi.media.LyricStream` objects for all MediaParts. """
+        if self.isPartialObject():
+            self.reload()
+        return sum((part.lyricStreams() for part in self.iterParts()), [])
+
     def play(self, client):
         """ Start playback on the specified client.
 
@@ -953,8 +986,10 @@ class PlexHistory(object):
         raise NotImplementedError('History objects cannot be reloaded. Use source() to get the source media item.')
 
     def source(self):
-        """ Return the source media object for the history entry. """
-        return self.fetchItem(self._details_key)
+        """ Return the source media object for the history entry
+            or None if the media no longer exists on the server.
+        """
+        return self.fetchItem(self._details_key) if self._details_key else None
 
     def delete(self):
         """ Delete the history entry. """
diff --git a/lib/plexapi/client.py b/lib/plexapi/client.py
index 279b4974..76513e79 100644
--- a/lib/plexapi/client.py
+++ b/lib/plexapi/client.py
@@ -1,5 +1,6 @@
 # -*- coding: utf-8 -*-
 import time
+import weakref
 from xml.etree import ElementTree
 
 import requests
@@ -62,7 +63,8 @@ class PlexClient(PlexObject):
     key = '/resources'
 
     def __init__(self, server=None, data=None, initpath=None, baseurl=None,
-          identifier=None, token=None, connect=True, session=None, timeout=None):
+          identifier=None, token=None, connect=True, session=None, timeout=None,
+          parent=None):
         super(PlexClient, self).__init__(server, data, initpath)
         self._baseurl = baseurl.strip('/') if baseurl else None
         self._clientIdentifier = identifier
@@ -76,6 +78,7 @@ class PlexClient(PlexObject):
         self._last_call = 0
         self._timeline_cache = []
         self._timeline_cache_timestamp = 0
+        self._parent = weakref.ref(parent) if parent is not None else None
         if not any([data is not None, initpath, baseurl, token]):
             self._baseurl = CONFIG.get('auth.client_baseurl', 'http://localhost:32433')
             self._token = logfilter.add_secret(CONFIG.get('auth.client_token'))
diff --git a/lib/plexapi/collection.py b/lib/plexapi/collection.py
index 8bc5f286..809455ea 100644
--- a/lib/plexapi/collection.py
+++ b/lib/plexapi/collection.py
@@ -276,7 +276,7 @@ class Collection(
 
                 .. code-block:: python
 
-                    collection.updateSort(mode="alpha")
+                    collection.sortUpdate(sort="alpha")
 
         """
         if self.smart:
diff --git a/lib/plexapi/const.py b/lib/plexapi/const.py
index 8a172e98..c427177f 100644
--- a/lib/plexapi/const.py
+++ b/lib/plexapi/const.py
@@ -4,6 +4,6 @@
 # Library version
 MAJOR_VERSION = 4
 MINOR_VERSION = 15
-PATCH_VERSION = 4
+PATCH_VERSION = 10
 __short_version__ = f"{MAJOR_VERSION}.{MINOR_VERSION}"
 __version__ = f"{__short_version__}.{PATCH_VERSION}"
diff --git a/lib/plexapi/exceptions.py b/lib/plexapi/exceptions.py
index c269c38e..182feb13 100644
--- a/lib/plexapi/exceptions.py
+++ b/lib/plexapi/exceptions.py
@@ -29,3 +29,8 @@ class Unsupported(PlexApiException):
 class Unauthorized(BadRequest):
     """ Invalid username/password or token. """
     pass
+
+
+class TwoFactorRequired(Unauthorized):
+    """ Two factor authentication required. """
+    pass
diff --git a/lib/plexapi/library.py b/lib/plexapi/library.py
index 87d59eac..5b06f009 100644
--- a/lib/plexapi/library.py
+++ b/lib/plexapi/library.py
@@ -1,5 +1,7 @@
 # -*- coding: utf-8 -*-
 import re
+import warnings
+from collections import defaultdict
 from datetime import datetime
 from functools import cached_property
 from urllib.parse import parse_qs, quote_plus, urlencode, urlparse
@@ -41,14 +43,22 @@ class Library(PlexObject):
     def _loadSections(self):
         """ Loads and caches all the library sections. """
         key = '/library/sections'
-        self._sectionsByID = {}
-        self._sectionsByTitle = {}
+        sectionsByID = {}
+        sectionsByTitle = defaultdict(list)
+        libcls = {
+            'movie': MovieSection,
+            'show': ShowSection,
+            'artist': MusicSection,
+            'photo': PhotoSection,
+        }
+
         for elem in self._server.query(key):
-            for cls in (MovieSection, ShowSection, MusicSection, PhotoSection):
-                if elem.attrib.get('type') == cls.TYPE:
-                    section = cls(self._server, elem, key)
-                    self._sectionsByID[section.key] = section
-                    self._sectionsByTitle[section.title.lower().strip()] = section
+            section = libcls.get(elem.attrib.get('type'), LibrarySection)(self._server, elem, initpath=key)
+            sectionsByID[section.key] = section
+            sectionsByTitle[section.title.lower().strip()].append(section)
+
+        self._sectionsByID = sectionsByID
+        self._sectionsByTitle = dict(sectionsByTitle)
 
     def sections(self):
         """ Returns a list of all media sections in this library. Library sections may be any of
@@ -60,18 +70,30 @@ class Library(PlexObject):
 
     def section(self, title):
         """ Returns the :class:`~plexapi.library.LibrarySection` that matches the specified title.
+            Note: Multiple library sections with the same title is ambiguous.
+            Use :func:`~plexapi.library.Library.sectionByID` instead for an exact match.
 
             Parameters:
                 title (str): Title of the section to return.
+
+            Raises:
+                :exc:`~plexapi.exceptions.NotFound`: The library section title is not found on the server.
         """
         normalized_title = title.lower().strip()
         if not self._sectionsByTitle or normalized_title not in self._sectionsByTitle:
             self._loadSections()
         try:
-            return self._sectionsByTitle[normalized_title]
+            sections = self._sectionsByTitle[normalized_title]
         except KeyError:
             raise NotFound(f'Invalid library section: {title}') from None
 
+        if len(sections) > 1:
+            warnings.warn(
+                'Multiple library sections with the same title found, use "sectionByID" instead. '
+                'Returning the last section.'
+            )
+        return sections[-1]
+
     def sectionByID(self, sectionID):
         """ Returns the :class:`~plexapi.library.LibrarySection` that matches the specified sectionID.
 
@@ -2727,7 +2749,9 @@ class FilteringType(PlexObject):
             ('id', 'integer', 'Rating Key'),
             ('index', 'integer', f'{self.type.capitalize()} Number'),
             ('lastRatedAt', 'date', f'{self.type.capitalize()} Last Rated'),
-            ('updatedAt', 'date', 'Date Updated')
+            ('updatedAt', 'date', 'Date Updated'),
+            ('group', 'string', 'SQL Group By Statement'),
+            ('having', 'string', 'SQL Having Clause')
         ]
 
         if self.type == 'movie':
@@ -2778,11 +2802,14 @@ class FilteringType(PlexObject):
 
         manualFields = []
         for field, fieldType, fieldTitle in additionalFields:
+            if field not in {'group', 'having'}:
+                field = f"{prefix}{field}"
             fieldXML = (
-                f'<Field key="{prefix}{field}" '
+                f'<Field key="{field}" '
                 f'title="{fieldTitle}" '
                 f'type="{fieldType}"/>'
             )
+
             manualFields.append(self._manuallyLoadXML(fieldXML, FilteringField))
 
         return manualFields
@@ -2922,6 +2949,10 @@ class FilterChoice(PlexObject):
         self.title = data.attrib.get('title')
         self.type = data.attrib.get('type')
 
+    def items(self):
+        """ Returns a list of items for this filter choice. """
+        return self.fetchItems(self.fastKey)
+
 
 class ManagedHub(PlexObject):
     """ Represents a Managed Hub (recommendation) inside a library.
diff --git a/lib/plexapi/media.py b/lib/plexapi/media.py
index 369bb759..43c5636d 100644
--- a/lib/plexapi/media.py
+++ b/lib/plexapi/media.py
@@ -37,7 +37,7 @@ class Media(PlexObject):
             videoResolution (str): The video resolution of the media (ex: sd).
             width (int): The width of the video in pixels (ex: 608).
 
-            <Photo_only_attributes>: The following attributes are only available for photos.
+            Photo_only_attributes: The following attributes are only available for photos.
 
                 * aperture (str): The aperture used to take the photo.
                 * exposure (str): The exposure used to take the photo.
@@ -74,13 +74,13 @@ class Media(PlexObject):
         self.width = utils.cast(int, data.attrib.get('width'))
         self.uuid = data.attrib.get('uuid')
 
-        if self._isChildOf(etag='Photo'):
-            self.aperture = data.attrib.get('aperture')
-            self.exposure = data.attrib.get('exposure')
-            self.iso = utils.cast(int, data.attrib.get('iso'))
-            self.lens = data.attrib.get('lens')
-            self.make = data.attrib.get('make')
-            self.model = data.attrib.get('model')
+        # Photo only attributes
+        self.aperture = data.attrib.get('aperture')
+        self.exposure = data.attrib.get('exposure')
+        self.iso = utils.cast(int, data.attrib.get('iso'))
+        self.lens = data.attrib.get('lens')
+        self.make = data.attrib.get('make')
+        self.model = data.attrib.get('model')
 
         parent = self._parent()
         self._parentKey = parent.key
@@ -158,11 +158,8 @@ class MediaPart(PlexObject):
         self.videoProfile = data.attrib.get('videoProfile')
 
     def _buildStreams(self, data):
-        streams = []
-        for cls in (VideoStream, AudioStream, SubtitleStream, LyricStream):
-            items = self.findItems(data, cls, streamType=cls.STREAMTYPE)
-            streams.extend(items)
-        return streams
+        """ Returns a list of :class:`~plexapi.media.MediaPartStream` objects in this MediaPart. """
+        return self.findItems(data)
 
     @property
     def hasPreviewThumbnails(self):
@@ -216,7 +213,7 @@ class MediaPart(PlexObject):
         else:
             params['subtitleStreamID'] = stream
 
-        self._server.query(key, method=self._server._session.put)
+        self._server.query(key, method=self._server._session.put, params=params)
         return self
 
     def resetSelectedSubtitleStream(self):
@@ -384,7 +381,7 @@ class AudioStream(MediaPartStream):
             samplingRate (int): The sampling rate of the audio stream (ex: xxx)
             streamIdentifier (int): The stream identifier of the audio stream.
 
-            <Track_only_attributes>: The following attributes are only available for tracks.
+            Track_only_attributes: The following attributes are only available for tracks.
 
                 * albumGain (float): The gain for the album.
                 * albumPeak (float): The peak for the album.
@@ -411,16 +408,16 @@ class AudioStream(MediaPartStream):
         self.samplingRate = utils.cast(int, data.attrib.get('samplingRate'))
         self.streamIdentifier = utils.cast(int, data.attrib.get('streamIdentifier'))
 
-        if self._isChildOf(etag='Track'):
-            self.albumGain = utils.cast(float, data.attrib.get('albumGain'))
-            self.albumPeak = utils.cast(float, data.attrib.get('albumPeak'))
-            self.albumRange = utils.cast(float, data.attrib.get('albumRange'))
-            self.endRamp = data.attrib.get('endRamp')
-            self.gain = utils.cast(float, data.attrib.get('gain'))
-            self.loudness = utils.cast(float, data.attrib.get('loudness'))
-            self.lra = utils.cast(float, data.attrib.get('lra'))
-            self.peak = utils.cast(float, data.attrib.get('peak'))
-            self.startRamp = data.attrib.get('startRamp')
+        # Track only attributes
+        self.albumGain = utils.cast(float, data.attrib.get('albumGain'))
+        self.albumPeak = utils.cast(float, data.attrib.get('albumPeak'))
+        self.albumRange = utils.cast(float, data.attrib.get('albumRange'))
+        self.endRamp = data.attrib.get('endRamp')
+        self.gain = utils.cast(float, data.attrib.get('gain'))
+        self.loudness = utils.cast(float, data.attrib.get('loudness'))
+        self.lra = utils.cast(float, data.attrib.get('lra'))
+        self.peak = utils.cast(float, data.attrib.get('peak'))
+        self.startRamp = data.attrib.get('startRamp')
 
     def setSelected(self):
         """ Sets this audio stream as the selected audio stream.
@@ -444,8 +441,10 @@ class SubtitleStream(MediaPartStream):
             forced (bool): True if this is a forced subtitle.
             format (str): The format of the subtitle stream (ex: srt).
             headerCompression (str): The header compression of the subtitle stream.
+            hearingImpaired (bool): True if this is a hearing impaired (SDH) subtitle.
+            perfectMatch (bool): True if the on-demand subtitle is a perfect match.
             providerTitle (str): The provider title where the on-demand subtitle is downloaded from.
-            score (int): The match score of the on-demand subtitle.
+            score (int): The match score (download count) of the on-demand subtitle.
             sourceKey (str): The source key of the on-demand subtitle.
             transient (str): Unknown.
             userID (int): The user id of the user that downloaded the on-demand subtitle.
@@ -460,6 +459,8 @@ class SubtitleStream(MediaPartStream):
         self.forced = utils.cast(bool, data.attrib.get('forced', '0'))
         self.format = data.attrib.get('format')
         self.headerCompression = data.attrib.get('headerCompression')
+        self.hearingImpaired = utils.cast(bool, data.attrib.get('hearingImpaired', '0'))
+        self.perfectMatch = utils.cast(bool, data.attrib.get('perfectMatch'))
         self.providerTitle = data.attrib.get('providerTitle')
         self.score = utils.cast(int, data.attrib.get('score'))
         self.sourceKey = data.attrib.get('sourceKey')
@@ -1003,7 +1004,8 @@ class BaseResource(PlexObject):
         Attributes:
             TAG (str): 'Photo' or 'Track'
             key (str): API URL (/library/metadata/<ratingkey>).
-            provider (str): The source of the art or poster, None for Theme objects.
+            provider (str): The source of the resource. 'local' for local files (e.g. theme.mp3),
+                None if uploaded or agent-/plugin-supplied.
             ratingKey (str): Unique key identifying the resource.
             selected (bool): True if the resource is currently selected.
             thumb (str): The URL to retrieve the resource thumbnail.
diff --git a/lib/plexapi/mixins.py b/lib/plexapi/mixins.py
index e1cce54b..60c24e26 100644
--- a/lib/plexapi/mixins.py
+++ b/lib/plexapi/mixins.py
@@ -1,5 +1,7 @@
 # -*- coding: utf-8 -*-
+from collections import deque
 from datetime import datetime
+from typing import Deque, Set, Tuple, Union
 from urllib.parse import parse_qsl, quote, quote_plus, unquote, urlencode, urlsplit
 
 from plexapi import media, settings, utils
@@ -61,63 +63,96 @@ class AdvancedSettingsMixin:
 
 
 class SmartFilterMixin:
-    """ Mixing for Plex objects that can have smart filters. """
+    """ Mixin for Plex objects that can have smart filters. """
+
+    def _parseFilterGroups(self, feed: Deque[Tuple[str, str]], returnOn: Union[Set[str], None] = None) -> dict:
+        """ Parse filter groups from input lines between push and pop. """
+        currentFiltersStack: list[dict] = []
+        operatorForStack = None
+        if returnOn is None:
+            returnOn = set("pop")
+        else:
+            returnOn.add("pop")
+        allowedLogicalOperators = ["and", "or"]  # first is the default
+
+        while feed:
+            key, value = feed.popleft()  # consume the first item
+            if key == "push":
+                # recurse and add the result to the current stack
+                currentFiltersStack.append(
+                    self._parseFilterGroups(feed, returnOn)
+                )
+            elif key in returnOn:
+                # stop iterating and return the current stack
+                if not key == "pop":
+                    feed.appendleft((key, value))  # put the item back
+                break
+
+            elif key in allowedLogicalOperators:
+                # set the operator
+                if operatorForStack and not operatorForStack == key:
+                    raise ValueError(
+                        "cannot have different logical operators for the same"
+                        " filter group"
+                    )
+                operatorForStack = key
+
+            else:
+                # add the key value pair to the current filter
+                currentFiltersStack.append({key: value})
+
+        if not operatorForStack and len(currentFiltersStack) > 1:
+            # consider 'and' as the default operator
+            operatorForStack = allowedLogicalOperators[0]
+
+        if operatorForStack:
+            return {operatorForStack: currentFiltersStack}
+        return currentFiltersStack.pop()
+
+    def _parseQueryFeed(self, feed: "deque[Tuple[str, str]]") -> dict:
+        """ Parse the query string into a dict. """
+        filtersDict = {}
+        special_keys = {"type", "sort"}
+        integer_keys = {"includeGuids", "limit"}
+        as_is_keys = {"group", "having"}
+        reserved_keys = special_keys | integer_keys | as_is_keys
+        while feed:
+            key, value = feed.popleft()
+            if key in integer_keys:
+                filtersDict[key] = int(value)
+            elif key in as_is_keys:
+                filtersDict[key] = value
+            elif key == "type":
+                filtersDict["libtype"] = utils.reverseSearchType(value)
+            elif key == "sort":
+                filtersDict["sort"] = value.split(",")
+            else:
+                feed.appendleft((key, value))  # put the item back
+                filter_group = self._parseFilterGroups(
+                    feed, returnOn=reserved_keys
+                )
+                if "filters" in filtersDict:
+                    filtersDict["filters"] = {
+                        "and": [filtersDict["filters"], filter_group]
+                    }
+                else:
+                    filtersDict["filters"] = filter_group
+
+        return filtersDict
 
     def _parseFilters(self, content):
         """ Parse the content string and returns the filter dict. """
         content = urlsplit(unquote(content))
-        filters = {}
-        filterOp = 'and'
-        filterGroups = [[]]
+        feed = deque()
 
         for key, value in parse_qsl(content.query):
             # Move = sign to key when operator is ==
-            if value.startswith('='):
-                key += '='
-                value = value[1:]
+            if value.startswith("="):
+                key, value = f"{key}=", value[1:]
 
-            if key == 'includeGuids':
-                filters['includeGuids'] = int(value)
-            elif key == 'type':
-                filters['libtype'] = utils.reverseSearchType(value)
-            elif key == 'sort':
-                filters['sort'] = value.split(',')
-            elif key == 'limit':
-                filters['limit'] = int(value)
-            elif key == 'push':
-                filterGroups[-1].append([])
-                filterGroups.append(filterGroups[-1][-1])
-            elif key == 'and':
-                filterOp = 'and'
-            elif key == 'or':
-                filterOp = 'or'
-            elif key == 'pop':
-                filterGroups[-1].insert(0, filterOp)
-                filterGroups.pop()
-            else:
-                filterGroups[-1].append({key: value})
+            feed.append((key, value))
 
-        if filterGroups:
-            filters['filters'] = self._formatFilterGroups(filterGroups.pop())
-        return filters
-
-    def _formatFilterGroups(self, groups):
-        """ Formats the filter groups into the advanced search rules. """
-        if len(groups) == 1 and isinstance(groups[0], list):
-            groups = groups.pop()
-
-        filterOp = 'and'
-        rules = []
-
-        for g in groups:
-            if isinstance(g, list):
-                rules.append(self._formatFilterGroups(g))
-            elif isinstance(g, dict):
-                rules.append(g)
-            elif g in {'and', 'or'}:
-                filterOp = g
-
-        return {filterOp: rules}
+        return self._parseQueryFeed(feed)
 
 
 class SplitMergeMixin:
@@ -281,19 +316,16 @@ class PlayedUnplayedMixin:
         return self
 
     @property
-    @deprecated('use "isPlayed" instead', stacklevel=3)
     def isWatched(self):
-        """ Returns True if the show is watched. """
+        """ Alias to self.isPlayed. """
         return self.isPlayed
 
-    @deprecated('use "markPlayed" instead')
     def markWatched(self):
-        """ Mark the video as played. """
+        """ Alias to :func:`~plexapi.mixins.PlayedUnplayedMixin.markPlayed`. """
         self.markPlayed()
 
-    @deprecated('use "markUnplayed" instead')
     def markUnwatched(self):
-        """ Mark the video as unplayed. """
+        """ Alias to :func:`~plexapi.mixins.PlayedUnplayedMixin.markUnplayed`. """
         self.markUnplayed()
 
 
@@ -755,7 +787,8 @@ class EditTagsMixin:
 
         if not remove:
             tags = getattr(self, self._tagPlural(tag), [])
-            items = tags + items
+            if isinstance(tags, list):
+                items = tags + items
 
         edits = self._tagHelper(self._tagSingular(tag), items, locked, remove)
         edits.update(kwargs)
@@ -1163,7 +1196,7 @@ class AlbumEditMixins(
 class TrackEditMixins(
     ArtLockMixin, PosterLockMixin, ThemeLockMixin,
     AddedAtMixin, TitleMixin, TrackArtistMixin, TrackNumberMixin, TrackDiscNumberMixin, UserRatingMixin,
-    CollectionMixin, LabelMixin, MoodMixin
+    CollectionMixin, GenreMixin, LabelMixin, MoodMixin
 ):
     pass
 
@@ -1189,3 +1222,10 @@ class CollectionEditMixins(
     LabelMixin
 ):
     pass
+
+
+class PlaylistEditMixins(
+    ArtLockMixin, PosterLockMixin,
+    SortTitleMixin, SummaryMixin, TitleMixin
+):
+    pass
diff --git a/lib/plexapi/myplex.py b/lib/plexapi/myplex.py
index ede2276d..8d697924 100644
--- a/lib/plexapi/myplex.py
+++ b/lib/plexapi/myplex.py
@@ -12,7 +12,7 @@ from plexapi import (BASE_HEADERS, CONFIG, TIMEOUT, X_PLEX_ENABLE_FAST_CONNECT,
                      log, logfilter, utils)
 from plexapi.base import PlexObject
 from plexapi.client import PlexClient
-from plexapi.exceptions import BadRequest, NotFound, Unauthorized
+from plexapi.exceptions import BadRequest, NotFound, Unauthorized, TwoFactorRequired
 from plexapi.library import LibrarySection
 from plexapi.server import PlexServer
 from plexapi.sonos import PlexSonosClient
@@ -108,6 +108,7 @@ class MyPlexAccount(PlexObject):
     OPTOUTS = 'https://plex.tv/api/v2/user/{userUUID}/settings/opt_outs'                        # get
     LINK = 'https://plex.tv/api/v2/pins/link'                                                   # put
     VIEWSTATESYNC = 'https://plex.tv/api/v2/user/view_state_sync'                               # put
+    PING = 'https://plex.tv/api/v2/ping'
     # Hub sections
     VOD = 'https://vod.provider.plex.tv'                                                        # get
     MUSIC = 'https://music.provider.plex.tv'                                                    # get
@@ -236,6 +237,8 @@ class MyPlexAccount(PlexObject):
             errtext = response.text.replace('\n', ' ')
             message = f'({response.status_code}) {codename}; {response.url} {errtext}'
             if response.status_code == 401:
+                if "verification code" in response.text:
+                    raise TwoFactorRequired(message)
                 raise Unauthorized(message)
             elif response.status_code == 404:
                 raise NotFound(message)
@@ -250,6 +253,15 @@ class MyPlexAccount(PlexObject):
         data = response.text.encode('utf8')
         return ElementTree.fromstring(data) if data.strip() else None
 
+    def ping(self):
+        """ Ping the Plex.tv API.
+            This will refresh the authentication token to prevent it from expiring.
+        """
+        pong = self.query(self.PING)
+        if pong is not None:
+            return utils.cast(bool, pong.text)
+        return False
+
     def device(self, name=None, clientId=None):
         """ Returns the :class:`~plexapi.myplex.MyPlexDevice` that matches the name specified.
 
@@ -1694,7 +1706,9 @@ class MyPlexPinLogin:
 
     @property
     def pin(self):
-        """ Return the 4 character PIN used for linking a device at https://plex.tv/link. """
+        """ Return the 4 character PIN used for linking a device at
+            https://plex.tv/link.
+        """
         if self._oauth:
             raise BadRequest('Cannot use PIN for Plex OAuth login')
         return self._code
@@ -1726,6 +1740,7 @@ class MyPlexPinLogin:
 
     def run(self, callback=None, timeout=None):
         """ Starts the thread which monitors the PIN login state.
+
             Parameters:
                 callback (Callable[str]): Callback called with the received authentication token (optional).
                 timeout (int): Timeout in seconds waiting for the PIN login to succeed (optional).
@@ -1748,6 +1763,7 @@ class MyPlexPinLogin:
 
     def waitForLogin(self):
         """ Waits for the PIN login to succeed or expire.
+
             Parameters:
                 callback (Callable[str]): Callback called with the received authentication token (optional).
                 timeout (int): Timeout in seconds waiting for the PIN login to succeed (optional).
diff --git a/lib/plexapi/photo.py b/lib/plexapi/photo.py
index 8737d814..c68b3613 100644
--- a/lib/plexapi/photo.py
+++ b/lib/plexapi/photo.py
@@ -180,6 +180,8 @@ class Photo(
             parentThumb (str): URL to photo album thumbnail image (/library/metadata/<parentRatingKey>/thumb/<thumbid>).
             parentTitle (str): Name of the photo album for the photo.
             ratingKey (int): Unique key identifying the photo.
+            sourceURI (str): Remote server URI (server://<machineIdentifier>/com.plexapp.plugins.library)
+                (remote playlist item only).
             summary (str): Summary of the photo.
             tags (List<:class:`~plexapi.media.Tag`>): List of tag objects.
             thumb (str): URL to thumbnail image (/library/metadata/<ratingKey>/thumb/<thumbid>).
@@ -218,6 +220,7 @@ class Photo(
         self.parentThumb = data.attrib.get('parentThumb')
         self.parentTitle = data.attrib.get('parentTitle')
         self.ratingKey = utils.cast(int, data.attrib.get('ratingKey'))
+        self.sourceURI = data.attrib.get('source')  # remote playlist item
         self.summary = data.attrib.get('summary')
         self.tags = self.findItems(data, media.Tag)
         self.thumb = data.attrib.get('thumb')
diff --git a/lib/plexapi/playlist.py b/lib/plexapi/playlist.py
index 44073ee7..14ef88ed 100644
--- a/lib/plexapi/playlist.py
+++ b/lib/plexapi/playlist.py
@@ -7,7 +7,7 @@ from plexapi import media, utils
 from plexapi.base import Playable, PlexPartialObject
 from plexapi.exceptions import BadRequest, NotFound, Unsupported
 from plexapi.library import LibrarySection, MusicSection
-from plexapi.mixins import SmartFilterMixin, ArtMixin, PosterMixin
+from plexapi.mixins import SmartFilterMixin, ArtMixin, PosterMixin, PlaylistEditMixins
 from plexapi.utils import deprecated
 
 
@@ -15,7 +15,8 @@ from plexapi.utils import deprecated
 class Playlist(
     PlexPartialObject, Playable,
     SmartFilterMixin,
-    ArtMixin, PosterMixin
+    ArtMixin, PosterMixin,
+    PlaylistEditMixins
 ):
     """ Represents a single Playlist.
 
@@ -42,6 +43,7 @@ class Playlist(
             smart (bool): True if the playlist is a smart playlist.
             summary (str): Summary of the playlist.
             title (str): Name of the playlist.
+            titleSort (str): Title to use when sorting (defaults to title).
             type (str): 'playlist'
             updatedAt (datetime): Datetime the playlist was updated.
     """
@@ -71,6 +73,7 @@ class Playlist(
         self.smart = utils.cast(bool, data.attrib.get('smart'))
         self.summary = data.attrib.get('summary')
         self.title = data.attrib.get('title')
+        self.titleSort = data.attrib.get('titleSort', self.title)
         self.type = data.attrib.get('type')
         self.updatedAt = utils.toDatetime(data.attrib.get('updatedAt'))
         self._items = None  # cache for self.items
@@ -224,7 +227,7 @@ class Playlist(
         self._server.query(key, method=self._server._session.put)
         return self
 
-    @deprecated('use "removeItems" instead', stacklevel=3)
+    @deprecated('use "removeItems" instead')
     def removeItem(self, item):
         self.removeItems(item)
 
@@ -308,10 +311,15 @@ class Playlist(
 
     def _edit(self, **kwargs):
         """ Actually edit the playlist. """
+        if isinstance(self._edits, dict):
+            self._edits.update(kwargs)
+            return self
+
         key = f'{self.key}{utils.joinArgs(kwargs)}'
         self._server.query(key, method=self._server._session.put)
         return self
 
+    @deprecated('use "editTitle" and "editSummary" instead')
     def edit(self, title=None, summary=None):
         """ Edit the playlist.
 
@@ -384,7 +392,7 @@ class Playlist(
         key = f"/playlists/upload{utils.joinArgs(args)}"
         server.query(key, method=server._session.post)
         try:
-            return server.playlists(sectionId=section.key, guid__endswith=m3ufilepath)[0].edit(title=title).reload()
+            return server.playlists(sectionId=section.key, guid__endswith=m3ufilepath)[0].editTitle(title).reload()
         except IndexError:
             raise BadRequest('Failed to create playlist from m3u file.') from None
 
diff --git a/lib/plexapi/server.py b/lib/plexapi/server.py
index 52a203a8..bdd330f7 100644
--- a/lib/plexapi/server.py
+++ b/lib/plexapi/server.py
@@ -355,8 +355,7 @@ class PlexServer(PlexObject):
             key = f'/services/browse/{base64path}'
         else:
             key = '/services/browse'
-        if includeFiles:
-            key += '?includeFiles=1'
+        key += f'?includeFiles={int(includeFiles)}'  # starting with PMS v1.32.7.7621 this must set explicitly
         return self.fetchItems(key)
 
     def walk(self, path=None):
diff --git a/lib/plexapi/utils.py b/lib/plexapi/utils.py
index 8478f2d4..467ccf05 100644
--- a/lib/plexapi/utils.py
+++ b/lib/plexapi/utils.py
@@ -144,22 +144,21 @@ def cast(func, value):
             func (func): Callback function to used cast to type (int, bool, float).
             value (any): value to be cast and returned.
     """
-    if value is not None:
-        if func == bool:
-            if value in (1, True, "1", "true"):
-                return True
-            elif value in (0, False, "0", "false"):
-                return False
-            else:
-                raise ValueError(value)
+    if value is None:
+        return value
+    if func == bool:
+        if value in (1, True, "1", "true"):
+            return True
+        if value in (0, False, "0", "false"):
+            return False
+        raise ValueError(value)
 
-        elif func in (int, float):
-            try:
-                return func(value)
-            except ValueError:
-                return float('nan')
-        return func(value)
-    return value
+    if func in (int, float):
+        try:
+            return func(value)
+        except ValueError:
+            return float('nan')
+    return func(value)
 
 
 def joinArgs(args):
@@ -329,7 +328,7 @@ def toDatetime(value, format=None):
                 return None
             try:
                 return datetime.fromtimestamp(value)
-            except (OSError, OverflowError):
+            except (OSError, OverflowError, ValueError):
                 try:
                     return datetime.fromtimestamp(0) + timedelta(seconds=value)
                 except OverflowError:
@@ -407,7 +406,7 @@ def downloadSessionImages(server, filename=None, height=150, width=150,
     return info
 
 
-def download(url, token, filename=None, savepath=None, session=None, chunksize=4024,   # noqa: C901
+def download(url, token, filename=None, savepath=None, session=None, chunksize=4096,   # noqa: C901
              unpack=False, mocked=False, showstatus=False):
     """ Helper to download a thumb, videofile or other media item. Returns the local
         path to the downloaded file.
diff --git a/lib/plexapi/video.py b/lib/plexapi/video.py
index e95b12ff..727ba0f8 100644
--- a/lib/plexapi/video.py
+++ b/lib/plexapi/video.py
@@ -97,64 +97,88 @@ class Video(PlexPartialObject, PlayedUnplayedMixin):
         """ Returns str, default title for a new syncItem. """
         return self.title
 
-    def videoStreams(self):
-        """ Returns a list of :class:`~plexapi.media.videoStream` objects for all MediaParts. """
-        streams = []
-
-        if self.isPartialObject():
-            self.reload()
-
-        parts = self.iterParts()
-        for part in parts:
-            streams += part.videoStreams()
-        return streams
-
-    def audioStreams(self):
-        """ Returns a list of :class:`~plexapi.media.AudioStream` objects for all MediaParts. """
-        streams = []
-
-        if self.isPartialObject():
-            self.reload()
-
-        parts = self.iterParts()
-        for part in parts:
-            streams += part.audioStreams()
-        return streams
-
-    def subtitleStreams(self):
-        """ Returns a list of :class:`~plexapi.media.SubtitleStream` objects for all MediaParts. """
-        streams = []
-
-        if self.isPartialObject():
-            self.reload()
-
-        parts = self.iterParts()
-        for part in parts:
-            streams += part.subtitleStreams()
-        return streams
-
     def uploadSubtitles(self, filepath):
-        """ Upload Subtitle file for video. """
+        """ Upload a subtitle file for the video.
+
+            Parameters:
+                filepath (str): Path to subtitle file.
+        """
         url = f'{self.key}/subtitles'
         filename = os.path.basename(filepath)
         subFormat = os.path.splitext(filepath)[1][1:]
+        params = {
+            'title': filename,
+            'format': subFormat,
+        }
+        headers = {'Accept': 'text/plain, */*'}
         with open(filepath, 'rb') as subfile:
-            params = {'title': filename,
-                      'format': subFormat
-                      }
-            headers = {'Accept': 'text/plain, */*'}
             self._server.query(url, self._server._session.post, data=subfile, params=params, headers=headers)
         return self
 
-    def removeSubtitles(self, streamID=None, streamTitle=None):
-        """ Remove Subtitle from movie's subtitles listing.
+    def searchSubtitles(self, language='en', hearingImpaired=0, forced=0):
+        """ Search for on-demand subtitles for the video.
+            See https://support.plex.tv/articles/subtitle-search/.
 
-            Note: If subtitle file is located inside video directory it will bbe deleted.
-            Files outside of video directory are not effected.
+            Parameters:
+                language (str, optional): Language code (ISO 639-1) of the subtitles to search for.
+                    Default 'en'.
+                hearingImpaired (int, optional): Search option for SDH subtitles.
+                    Default 0.
+                    (0 = Prefer non-SDH subtitles, 1 = Prefer SDH subtitles,
+                    2 = Only show SDH subtitles, 3 = Only show non-SDH subtitles)
+                forced (int, optional): Search option for forced subtitles.
+                    Default 0.
+                    (0 = Prefer non-forced subtitles, 1 = Prefer forced subtitles,
+                    2 = Only show forced subtitles, 3 = Only show non-forced subtitles)
+
+            Returns:
+                List<:class:`~plexapi.media.SubtitleStream`>: List of SubtitleStream objects.
         """
-        for stream in self.subtitleStreams():
-            if streamID == stream.id or streamTitle == stream.title:
-                self._server.query(stream.key, self._server._session.delete)
+        params = {
+            'language': language,
+            'hearingImpaired': hearingImpaired,
+            'forced': forced,
+        }
+        key = f'{self.key}/subtitles{utils.joinArgs(params)}'
+        return self.fetchItems(key)
+
+    def downloadSubtitles(self, subtitleStream):
+        """ Download on-demand subtitles for the video.
+            See https://support.plex.tv/articles/subtitle-search/.
+
+            Note: This method is asynchronous and returns immediately before subtitles are fully downloaded.
+
+            Parameters:
+                subtitleStream (:class:`~plexapi.media.SubtitleStream`):
+                    Subtitle object returned from :func:`~plexapi.video.Video.searchSubtitles`.
+        """
+        key = f'{self.key}/subtitles'
+        params = {'key': subtitleStream.key}
+        self._server.query(key, self._server._session.put, params=params)
+        return self
+
+    def removeSubtitles(self, subtitleStream=None, streamID=None, streamTitle=None):
+        """ Remove an upload or downloaded subtitle from the video.
+
+            Note: If the subtitle file is located inside video directory it will be deleted.
+            Files outside of video directory are not affected.
+            Embedded subtitles cannot be removed.
+
+            Parameters:
+                subtitleStream (:class:`~plexapi.media.SubtitleStream`, optional): Subtitle object to remove.
+                streamID (int, optional): ID of the subtitle stream to remove.
+                streamTitle (str, optional): Title of the subtitle stream to remove.
+        """
+        if subtitleStream is None:
+            try:
+                subtitleStream = next(
+                    stream for stream in self.subtitleStreams()
+                    if streamID == stream.id or streamTitle == stream.title
+                )
+            except StopIteration:
+                raise BadRequest(f"Subtitle stream with ID '{streamID}' or title '{streamTitle}' not found.") from None
+
+        self._server.query(subtitleStream.key, self._server._session.delete)
         return self
 
     def optimize(self, title='', target='', deviceProfile='', videoQuality=None,
@@ -344,7 +368,10 @@ class Movie(
             ratingImage (str): Key to critic rating image (rottentomatoes://image.rating.rotten).
             ratings (List<:class:`~plexapi.media.Rating`>): List of rating objects.
             roles (List<:class:`~plexapi.media.Role`>): List of role objects.
+            slug (str): The clean watch.plex.tv URL identifier for the movie.
             similar (List<:class:`~plexapi.media.Similar`>): List of Similar objects.
+            sourceURI (str): Remote server URI (server://<machineIdentifier>/com.plexapp.plugins.library)
+                (remote playlist item only).
             studio (str): Studio that created movie (Di Bonaventura Pictures; 21 Laps Entertainment).
             tagline (str): Movie tag line (Back 2 Work; Who says men can't change?).
             theme (str): URL to theme resource (/library/metadata/<ratingkey>/theme/<themeid>).
@@ -387,7 +414,9 @@ class Movie(
         self.ratingImage = data.attrib.get('ratingImage')
         self.ratings = self.findItems(data, media.Rating)
         self.roles = self.findItems(data, media.Role)
+        self.slug = data.attrib.get('slug')
         self.similar = self.findItems(data, media.Similar)
+        self.sourceURI = data.attrib.get('source')  # remote playlist item
         self.studio = data.attrib.get('studio')
         self.tagline = data.attrib.get('tagline')
         self.theme = data.attrib.get('theme')
@@ -507,6 +536,7 @@ class Show(
                 (None = Library default, tmdbAiring = The Movie Database (Aired),
                 aired = TheTVDB (Aired), dvd = TheTVDB (DVD), absolute = TheTVDB (Absolute)).
             similar (List<:class:`~plexapi.media.Similar`>): List of Similar objects.
+            slug (str): The clean watch.plex.tv URL identifier for the show.
             studio (str): Studio that created show (Di Bonaventura Pictures; 21 Laps Entertainment).
             subtitleLanguage (str): Setting that indicates the preferred subtitle language.
             subtitleMode (int): Setting that indicates the auto-select subtitle mode.
@@ -556,8 +586,9 @@ class Show(
         self.seasonCount = utils.cast(int, data.attrib.get('seasonCount', self.childCount))
         self.showOrdering = data.attrib.get('showOrdering')
         self.similar = self.findItems(data, media.Similar)
+        self.slug = data.attrib.get('slug')
         self.studio = data.attrib.get('studio')
-        self.subtitleLanguage = data.attrib.get('audioLanguage', '')
+        self.subtitleLanguage = data.attrib.get('subtitleLanguage', '')
         self.subtitleMode = utils.cast(int, data.attrib.get('subtitleMode', '-1'))
         self.tagline = data.attrib.get('tagline')
         self.theme = data.attrib.get('theme')
@@ -693,6 +724,7 @@ class Season(
             parentIndex (int): Plex index number for the show.
             parentKey (str): API URL of the show (/library/metadata/<parentRatingKey>).
             parentRatingKey (int): Unique key identifying the show.
+            parentSlug (str): The clean watch.plex.tv URL identifier for the show.
             parentStudio (str): Studio that created show.
             parentTheme (str): URL to show theme resource (/library/metadata/<parentRatingkey>/theme/<themeid>).
             parentThumb (str): URL to show thumbnail image (/library/metadata/<parentRatingKey>/thumb/<thumbid>).
@@ -722,12 +754,13 @@ class Season(
         self.parentIndex = utils.cast(int, data.attrib.get('parentIndex'))
         self.parentKey = data.attrib.get('parentKey')
         self.parentRatingKey = utils.cast(int, data.attrib.get('parentRatingKey'))
+        self.parentSlug = data.attrib.get('parentSlug')
         self.parentStudio = data.attrib.get('parentStudio')
         self.parentTheme = data.attrib.get('parentTheme')
         self.parentThumb = data.attrib.get('parentThumb')
         self.parentTitle = data.attrib.get('parentTitle')
         self.ratings = self.findItems(data, media.Rating)
-        self.subtitleLanguage = data.attrib.get('audioLanguage', '')
+        self.subtitleLanguage = data.attrib.get('subtitleLanguage', '')
         self.subtitleMode = utils.cast(int, data.attrib.get('subtitleMode', '-1'))
         self.viewedLeafCount = utils.cast(int, data.attrib.get('viewedLeafCount'))
         self.year = utils.cast(int, data.attrib.get('year'))
@@ -853,6 +886,7 @@ class Episode(
             grandparentGuid (str): Plex GUID for the show (plex://show/5d9c086fe9d5a1001f4d9fe6).
             grandparentKey (str): API URL of the show (/library/metadata/<grandparentRatingKey>).
             grandparentRatingKey (int): Unique key identifying the show.
+            grandparentSlug (str): The clean watch.plex.tv URL identifier for the show.
             grandparentTheme (str): URL to show theme resource (/library/metadata/<grandparentRatingkey>/theme/<themeid>).
             grandparentThumb (str): URL to show thumbnail image (/library/metadata/<grandparentRatingKey>/thumb/<thumbid>).
             grandparentTitle (str): Name of the show for the episode.
@@ -874,6 +908,8 @@ class Episode(
             ratings (List<:class:`~plexapi.media.Rating`>): List of rating objects.
             roles (List<:class:`~plexapi.media.Role`>): List of role objects.
             skipParent (bool): True if the show's seasons are set to hidden.
+            sourceURI (str): Remote server URI (server://<machineIdentifier>/com.plexapp.plugins.library)
+                (remote playlist item only).
             viewOffset (int): View offset in milliseconds.
             writers (List<:class:`~plexapi.media.Writer`>): List of writers objects.
             year (int): Year the episode was released.
@@ -898,6 +934,7 @@ class Episode(
         self.grandparentGuid = data.attrib.get('grandparentGuid')
         self.grandparentKey = data.attrib.get('grandparentKey')
         self.grandparentRatingKey = utils.cast(int, data.attrib.get('grandparentRatingKey'))
+        self.grandparentSlug = data.attrib.get('grandparentSlug')
         self.grandparentTheme = data.attrib.get('grandparentTheme')
         self.grandparentThumb = data.attrib.get('grandparentThumb')
         self.grandparentTitle = data.attrib.get('grandparentTitle')
@@ -916,6 +953,7 @@ class Episode(
         self.ratings = self.findItems(data, media.Rating)
         self.roles = self.findItems(data, media.Role)
         self.skipParent = utils.cast(bool, data.attrib.get('skipParent', '0'))
+        self.sourceURI = data.attrib.get('source')  # remote playlist item
         self.viewOffset = utils.cast(int, data.attrib.get('viewOffset', 0))
         self.writers = self.findItems(data, media.Writer)
         self.year = utils.cast(int, data.attrib.get('year'))
@@ -961,11 +999,9 @@ class Episode(
     @cached_property
     def _season(self):
         """ Returns the :class:`~plexapi.video.Season` object by querying for the show's children. """
-        if not self.grandparentKey:
-            return None
-        return self.fetchItem(
-            f'{self.grandparentKey}/children?excludeAllLeaves=1&index={self.parentIndex}'
-        )
+        if self.grandparentKey and self.parentIndex is not None:
+            return self.fetchItem(f'{self.grandparentKey}/children?excludeAllLeaves=1&index={self.parentIndex}')
+        return None
 
     def __repr__(self):
         return '<{}>'.format(
@@ -1003,7 +1039,11 @@ class Episode(
     @cached_property
     def seasonNumber(self):
         """ Returns the episode's season number. """
-        return self.parentIndex if isinstance(self.parentIndex, int) else self._season.seasonNumber
+        if isinstance(self.parentIndex, int):
+            return self.parentIndex
+        elif self._season:
+            return self._season.index
+        return None
 
     @property
     def seasonEpisode(self):
diff --git a/requirements.txt b/requirements.txt
index bc0a4bd6..73b6e088 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -28,7 +28,7 @@ musicbrainzngs==0.7.1
 packaging==23.1
 paho-mqtt==1.6.1
 platformdirs==3.11.0
-plexapi==4.15.4
+plexapi==4.15.10
 portend==3.2.0
 profilehooks==1.12.0
 PyJWT==2.8.0

From 60f29b0fa48d750f431c5727aa6226304bb23319 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 2 Mar 2024 14:02:24 -0800
Subject: [PATCH 507/743] Bump pycryptodomex from 3.18.0 to 3.20.0 (#2237)

Bumps [pycryptodomex](https://github.com/Legrandin/pycryptodome) from 3.18.0 to 3.20.0.
- [Release notes](https://github.com/Legrandin/pycryptodome/releases)
- [Changelog](https://github.com/Legrandin/pycryptodome/blob/master/Changelog.rst)
- [Commits](https://github.com/Legrandin/pycryptodome/compare/v3.18.0...v3.20.0)

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

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 package/requirements-package.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index e0bd159b..ee2ccf44 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -3,7 +3,7 @@ importlib-metadata==6.8.0
 importlib-resources==6.0.1
 pyinstaller==5.13.0
 pyopenssl==23.2.0
-pycryptodomex==3.18.0
+pycryptodomex==3.20.0
 
 pyobjc-core==9.2; platform_system == "Darwin"
 pyobjc-framework-Cocoa==9.2; platform_system == "Darwin"

From 23591a0435c1627f995b37e25e10c411a87060ac Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 2 Mar 2024 14:07:39 -0800
Subject: [PATCH 508/743] Bump pyopenssl from 23.2.0 to 24.0.0 (#2252)

Bumps [pyopenssl](https://github.com/pyca/pyopenssl) from 23.2.0 to 24.0.0.
- [Changelog](https://github.com/pyca/pyopenssl/blob/main/CHANGELOG.rst)
- [Commits](https://github.com/pyca/pyopenssl/compare/23.2.0...24.0.0)

---
updated-dependencies:
- dependency-name: pyopenssl
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 package/requirements-package.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index ee2ccf44..4062609c 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -2,7 +2,7 @@ apscheduler==3.10.1
 importlib-metadata==6.8.0
 importlib-resources==6.0.1
 pyinstaller==5.13.0
-pyopenssl==23.2.0
+pyopenssl==24.0.0
 pycryptodomex==3.20.0
 
 pyobjc-core==9.2; platform_system == "Darwin"

From 50dba6bf19164e141dbabd25a4d68b95991cb7ee Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 2 Mar 2024 14:08:25 -0800
Subject: [PATCH 509/743] Bump pyobjc-core from 9.2 to 10.1 (#2219)

Bumps [pyobjc-core](https://github.com/ronaldoussoren/pyobjc) from 9.2 to 10.1.
- [Release notes](https://github.com/ronaldoussoren/pyobjc/releases)
- [Changelog](https://github.com/ronaldoussoren/pyobjc/blob/master/docs/changelog.rst)
- [Commits](https://github.com/ronaldoussoren/pyobjc/compare/v9.2...v10.1)

---
updated-dependencies:
- dependency-name: pyobjc-core
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 package/requirements-package.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index 4062609c..75c9e4d2 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -5,7 +5,7 @@ pyinstaller==5.13.0
 pyopenssl==24.0.0
 pycryptodomex==3.20.0
 
-pyobjc-core==9.2; platform_system == "Darwin"
+pyobjc-core==10.1; platform_system == "Darwin"
 pyobjc-framework-Cocoa==9.2; platform_system == "Darwin"
 
 pywin32==306; platform_system == "Windows"

From f403fdcc5b41a25392b979b6a98625dce2885396 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 2 Mar 2024 14:10:07 -0800
Subject: [PATCH 510/743] Bump pyobjc-framework-cocoa from 9.2 to 10.1 (#2218)

Bumps [pyobjc-framework-cocoa](https://github.com/ronaldoussoren/pyobjc) from 9.2 to 10.1.
- [Release notes](https://github.com/ronaldoussoren/pyobjc/releases)
- [Changelog](https://github.com/ronaldoussoren/pyobjc/blob/master/docs/changelog.rst)
- [Commits](https://github.com/ronaldoussoren/pyobjc/compare/v9.2...v10.1)

---
updated-dependencies:
- dependency-name: pyobjc-framework-cocoa
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 package/requirements-package.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index 75c9e4d2..7238285d 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -6,6 +6,6 @@ pyopenssl==24.0.0
 pycryptodomex==3.20.0
 
 pyobjc-core==10.1; platform_system == "Darwin"
-pyobjc-framework-Cocoa==9.2; platform_system == "Darwin"
+pyobjc-framework-Cocoa==10.1; platform_system == "Darwin"
 
 pywin32==306; platform_system == "Windows"

From 78a7a48587bda6149eac67bdbe181bb5c1c94b29 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 2 Mar 2024 14:10:17 -0800
Subject: [PATCH 511/743] Bump pyinstaller from 5.13.0 to 6.4.0 (#2253)

Bumps [pyinstaller](https://github.com/pyinstaller/pyinstaller) from 5.13.0 to 6.4.0.
- [Release notes](https://github.com/pyinstaller/pyinstaller/releases)
- [Changelog](https://github.com/pyinstaller/pyinstaller/blob/develop/doc/CHANGES.rst)
- [Commits](https://github.com/pyinstaller/pyinstaller/compare/v5.13.0...v6.4.0)

---
updated-dependencies:
- dependency-name: pyinstaller
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 package/requirements-package.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index 7238285d..f1ad724e 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -1,7 +1,7 @@
 apscheduler==3.10.1
 importlib-metadata==6.8.0
 importlib-resources==6.0.1
-pyinstaller==5.13.0
+pyinstaller==6.4.0
 pyopenssl==24.0.0
 pycryptodomex==3.20.0
 

From cc070cfc6bdaa977452d9efb6274cdc97d7d84f7 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 2 Mar 2024 13:57:57 -0800
Subject: [PATCH 512/743] Add slug attribute to exporter

---
 plexpy/exporter.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/plexpy/exporter.py b/plexpy/exporter.py
index 1232481c..6c136f0e 100644
--- a/plexpy/exporter.py
+++ b/plexpy/exporter.py
@@ -387,6 +387,7 @@ class Export(object):
                     'role': None,
                     'thumb': None
                 },
+                'slug': None,
                 'studio': None,
                 'summary': None,
                 'tagline': None,
@@ -472,6 +473,7 @@ class Export(object):
                 },
                 'seasonCount': None,
                 'showOrdering': None,
+                'slug': None,
                 'studio': None,
                 'subtitleLanguage': None,
                 'subtitleMode': None,
@@ -536,6 +538,7 @@ class Export(object):
                 'parentTitle': None,
                 'ratingKey': None,
                 'seasonNumber': None,
+                'slug': None,
                 'subtitleLanguage': None,
                 'subtitleMode': None,
                 'summary': None,
@@ -795,6 +798,7 @@ class Export(object):
                 },
                 'seasonEpisode': None,
                 'seasonNumber': None,
+                'slug': None,
                 'summary': None,
                 'thumb': None,
                 'thumbBlurHash': None,

From 82089fdb7b7f443b4effd44f8e6d980988cea304 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 2 Mar 2024 13:58:12 -0800
Subject: [PATCH 513/743] Add track genres to exporter

---
 plexpy/exporter.py | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/plexpy/exporter.py b/plexpy/exporter.py
index 6c136f0e..a0b52083 100644
--- a/plexpy/exporter.py
+++ b/plexpy/exporter.py
@@ -991,6 +991,10 @@ class Export(object):
                     'name': None,
                     'locked': None
                 },
+                'genres': {
+                    'id': None,
+                    'tag': None
+                },
                 'grandparentArt': None,
                 'grandparentGuid': None,
                 'grandparentKey': None,
@@ -1555,7 +1559,7 @@ class Export(object):
                     'hasSonicAnalysis'
                 ],
                 2: [
-                    'collections.tag', 'moods.tag',
+                    'collections.tag', 'genres.tag', 'moods.tag',
                     'fields.name', 'fields.locked', 'guids.id'
                 ],
                 3: [

From 7ee2c590754899815ac7538d2d8f34b7fcb7d199 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 2 Mar 2024 13:58:30 -0800
Subject: [PATCH 514/743] Add playlist sourceURI to exporter

---
 plexpy/exporter.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/plexpy/exporter.py b/plexpy/exporter.py
index a0b52083..efb1abf3 100644
--- a/plexpy/exporter.py
+++ b/plexpy/exporter.py
@@ -1288,6 +1288,7 @@ class Export(object):
                 'playlistType': None,
                 'ratingKey': None,
                 'smart': None,
+                'sourceURI': None,
                 'summary': None,
                 'title': None,
                 'type': None,

From 36ed4bfa3c07feb6772ea89aa74674204a089e7d Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 2 Mar 2024 14:31:44 -0800
Subject: [PATCH 515/743] Set pyinstaller --contents-directory

Revert back to old one-dir behaviour

Ref.: pyinstaller/pyinstaller#7713
---
 package/Tautulli-macos.spec   | 3 ++-
 package/Tautulli-windows.spec | 3 ++-
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/package/Tautulli-macos.spec b/package/Tautulli-macos.spec
index caa126d7..bd61f1f2 100644
--- a/package/Tautulli-macos.spec
+++ b/package/Tautulli-macos.spec
@@ -34,7 +34,8 @@ exe = EXE(
     exclude_binaries=True,
     name='Tautulli',
     console=False,
-    icon='../data/interfaces/default/images/logo-circle.icns'
+    icon='../data/interfaces/default/images/logo-circle.icns',
+    contents_directory='.'
 )
 coll = COLLECT(
     exe,
diff --git a/package/Tautulli-windows.spec b/package/Tautulli-windows.spec
index cded3cf8..18f4219f 100644
--- a/package/Tautulli-windows.spec
+++ b/package/Tautulli-windows.spec
@@ -31,7 +31,8 @@ exe = EXE(
     exclude_binaries=True,
     name='Tautulli',
     console=False,
-    icon='..\\data\\interfaces\\default\\images\\logo-circle.ico'
+    icon='..\\data\\interfaces\\default\\images\\logo-circle.ico',
+    contents_directory='.'
 )
 coll = COLLECT(
     exe,

From 7e4f7c0c5616b50c23b205662ebd1d232a3cb7fb Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 2 Mar 2024 14:33:52 -0800
Subject: [PATCH 516/743] Bump dessant/label-actions from 3 to 4 (#2195)

Bumps [dessant/label-actions](https://github.com/dessant/label-actions) from 3 to 4.
- [Release notes](https://github.com/dessant/label-actions/releases)
- [Changelog](https://github.com/dessant/label-actions/blob/main/CHANGELOG.md)
- [Commits](https://github.com/dessant/label-actions/compare/v3...v4)

---
updated-dependencies:
- dependency-name: dessant/label-actions
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 .github/workflows/issues.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/issues.yml b/.github/workflows/issues.yml
index 34ceb357..a60987f5 100644
--- a/.github/workflows/issues.yml
+++ b/.github/workflows/issues.yml
@@ -10,6 +10,6 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Label Issues
-        uses: dessant/label-actions@v3
+        uses: dessant/label-actions@v4
         with:
           github-token: ${{ github.token }}

From 71e6ea00c9b9df0f8ee547881dbc943c7a05eea7 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 2 Mar 2024 14:34:18 -0800
Subject: [PATCH 517/743] Bump actions/setup-python from 4 to 5 (#2211)

Bumps [actions/setup-python](https://github.com/actions/setup-python) from 4 to 5.
- [Release notes](https://github.com/actions/setup-python/releases)
- [Commits](https://github.com/actions/setup-python/compare/v4...v5)

---
updated-dependencies:
- dependency-name: actions/setup-python
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 .github/workflows/publish-installers.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/publish-installers.yml b/.github/workflows/publish-installers.yml
index a9f6cda3..ef46671d 100644
--- a/.github/workflows/publish-installers.yml
+++ b/.github/workflows/publish-installers.yml
@@ -52,7 +52,7 @@ jobs:
           echo $GITHUB_SHA > version.txt
 
       - name: Set Up Python
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v5
         with:
           python-version: '3.9'
           cache: pip

From 6a19beb476ee7fb63e483b76ec4675b0e638a782 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 2 Mar 2024 14:34:58 -0800
Subject: [PATCH 518/743] Bump actions/stale from 8 to 9 (#2214)

Bumps [actions/stale](https://github.com/actions/stale) from 8 to 9.
- [Release notes](https://github.com/actions/stale/releases)
- [Changelog](https://github.com/actions/stale/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/stale/compare/v8...v9)

---
updated-dependencies:
- dependency-name: actions/stale
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 .github/workflows/issues-stale.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/issues-stale.yml b/.github/workflows/issues-stale.yml
index 26b8aa5f..b805e266 100644
--- a/.github/workflows/issues-stale.yml
+++ b/.github/workflows/issues-stale.yml
@@ -10,7 +10,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Stale
-        uses: actions/stale@v8
+        uses: actions/stale@v9
         with:
           stale-issue-message: >
             This issue is stale because it has been open for 30 days with no activity.
@@ -30,7 +30,7 @@ jobs:
           days-before-close: 5
 
       - name: Invalid Template
-        uses: actions/stale@v8
+        uses: actions/stale@v9
         with:
           stale-issue-message: >
             Invalid issues template.

From a397b90c23699bd6a493944aaca0ccbf4fa9f1e0 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 2 Mar 2024 14:35:11 -0800
Subject: [PATCH 519/743] Bump github/codeql-action from 2 to 3 (#2222)

Bumps [github/codeql-action](https://github.com/github/codeql-action) from 2 to 3.
- [Release notes](https://github.com/github/codeql-action/releases)
- [Changelog](https://github.com/github/codeql-action/blob/main/CHANGELOG.md)
- [Commits](https://github.com/github/codeql-action/compare/v2...v3)

---
updated-dependencies:
- dependency-name: github/codeql-action
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 .github/workflows/codeql.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/codeql.yml b/.github/workflows/codeql.yml
index f9593d5a..e9c8e05d 100644
--- a/.github/workflows/codeql.yml
+++ b/.github/workflows/codeql.yml
@@ -27,12 +27,12 @@ jobs:
       uses: actions/checkout@v4
 
     - name: Initialize CodeQL
-      uses: github/codeql-action/init@v2
+      uses: github/codeql-action/init@v3
       with:
         config-file: ./.github/codeql-config.yml
         languages: ${{ matrix.language }}
 
     - name: Perform CodeQL Analysis
-      uses: github/codeql-action/analyze@v2
+      uses: github/codeql-action/analyze@v3
       with:
         category: "/language:${{matrix.language}}"

From 355be9951201c82a30e06684473e7f9cb4147866 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 2 Mar 2024 14:35:43 -0800
Subject: [PATCH 520/743] Bump actions/upload-artifact from 3 to 4 (#2224)

Bumps [actions/upload-artifact](https://github.com/actions/upload-artifact) from 3 to 4.
- [Release notes](https://github.com/actions/upload-artifact/releases)
- [Commits](https://github.com/actions/upload-artifact/compare/v3...v4)

---
updated-dependencies:
- dependency-name: actions/upload-artifact
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 .github/workflows/publish-installers.yml | 2 +-
 .github/workflows/publish-snap.yml       | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/publish-installers.yml b/.github/workflows/publish-installers.yml
index ef46671d..f0483ec9 100644
--- a/.github/workflows/publish-installers.yml
+++ b/.github/workflows/publish-installers.yml
@@ -88,7 +88,7 @@ jobs:
             Tautulli-macos-${{ steps.get_version.outputs.RELEASE_VERSION }}-x64.pkg
 
       - name: Upload Installer
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         with:
           name: Tautulli-${{ matrix.os }}-installer
           path: Tautulli-${{ matrix.os }}-${{ steps.get_version.outputs.RELEASE_VERSION }}-x64.${{ matrix.ext }}
diff --git a/.github/workflows/publish-snap.yml b/.github/workflows/publish-snap.yml
index e8a6be7d..65442eca 100644
--- a/.github/workflows/publish-snap.yml
+++ b/.github/workflows/publish-snap.yml
@@ -44,7 +44,7 @@ jobs:
           architecture: ${{ matrix.architecture }}
 
       - name: Upload Snap Package
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         with:
           name: Tautulli-snap-package-${{ matrix.architecture }}
           path: ${{ steps.build.outputs.snap }}

From 36fbff550349b758ccba3bc76837790cd8f24f11 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 2 Mar 2024 14:35:56 -0800
Subject: [PATCH 521/743] Bump actions/download-artifact from 3 to 4 (#2223)

Bumps [actions/download-artifact](https://github.com/actions/download-artifact) from 3 to 4.
- [Release notes](https://github.com/actions/download-artifact/releases)
- [Commits](https://github.com/actions/download-artifact/compare/v3...v4)

---
updated-dependencies:
- dependency-name: actions/download-artifact
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 .github/workflows/publish-installers.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/publish-installers.yml b/.github/workflows/publish-installers.yml
index f0483ec9..0842f6c1 100644
--- a/.github/workflows/publish-installers.yml
+++ b/.github/workflows/publish-installers.yml
@@ -112,7 +112,7 @@ jobs:
 
       - name: Download Installers
         if: env.WORKFLOW_CONCLUSION == 'success'
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
 
       - name: Get Changelog
         id: get_changelog

From b48e9f40745d05ca22bf170dc69dbf63935bc500 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 2 Mar 2024 16:28:12 -0800
Subject: [PATCH 522/743] Update installer workflow for universal macOS binary

Bump python to 3.11
---
 .github/workflows/publish-installers.yml | 19 +++++++++++++------
 package/Tautulli-macos.spec              |  3 ++-
 2 files changed, 15 insertions(+), 7 deletions(-)

diff --git a/.github/workflows/publish-installers.yml b/.github/workflows/publish-installers.yml
index 0842f6c1..87ebc15c 100644
--- a/.github/workflows/publish-installers.yml
+++ b/.github/workflows/publish-installers.yml
@@ -6,10 +6,13 @@ on:
     branches: [master, beta, nightly]
     tags: [v*]
 
+env:
+  PYTHON_VERSION: '3.11'
+
 jobs:
   build-installer:
     name: Build ${{ matrix.os_upper }} Installer
-    runs-on: ${{ matrix.os }}-latest
+    runs-on: ${{ matrix.os }}-${{ matrix.os_version }}
     if: ${{ !contains(github.event.head_commit.message, '[skip ci]') }}
     strategy:
       fail-fast: false
@@ -17,9 +20,13 @@ jobs:
         include:
           - os: 'windows'
             os_upper: 'Windows'
+            os_version: 'latest'
+            arch: 'x64'
             ext: 'exe'
           - os: 'macos'
             os_upper: 'MacOS'
+            os_version: '14'
+            arch: 'universal'
             ext: 'pkg'
 
     steps:
@@ -54,14 +61,14 @@ jobs:
       - name: Set Up Python
         uses: actions/setup-python@v5
         with:
-          python-version: '3.9'
+          python-version: ${{ env.PYTHON_VERSION }}
           cache: pip
           cache-dependency-path: '**/requirements*.txt'
 
       - name: Install Dependencies
         run: |
           python -m pip install --upgrade pip
-          pip install -r package/requirements-package.txt
+          pip install -r package/requirements-package.txt --no-binary cffi
 
       - name: Build Package
         run: |
@@ -74,7 +81,7 @@ jobs:
           script-file: ./package/Tautulli.nsi
           arguments: >
             /DVERSION=${{ steps.get_version.outputs.VERSION_NSIS }}
-            /DINSTALLER_NAME=..\Tautulli-windows-${{ steps.get_version.outputs.RELEASE_VERSION }}-x64.exe
+            /DINSTALLER_NAME=..\Tautulli-${{ matrix.os }}-${{ steps.get_version.outputs.RELEASE_VERSION }}-${{ matrix.arch }}.${{ matrix.ext }}
           additional-plugin-paths: package/nsis-plugins
 
       - name: Create MacOS Installer
@@ -85,13 +92,13 @@ jobs:
             --version ${{ steps.get_version.outputs.VERSION }} \
             --component ./dist/Tautulli.app \
             --scripts ./package/macos-scripts \
-            Tautulli-macos-${{ steps.get_version.outputs.RELEASE_VERSION }}-x64.pkg
+            Tautulli-${{ matrix.os }}-${{ steps.get_version.outputs.RELEASE_VERSION }}-${{ matrix.arch }}.${{ matrix.ext }}
 
       - name: Upload Installer
         uses: actions/upload-artifact@v4
         with:
           name: Tautulli-${{ matrix.os }}-installer
-          path: Tautulli-${{ matrix.os }}-${{ steps.get_version.outputs.RELEASE_VERSION }}-x64.${{ matrix.ext }}
+          path: Tautulli-${{ matrix.os }}-${{ steps.get_version.outputs.RELEASE_VERSION }}-${{ matrix.arch }}.${{ matrix.ext }}
 
   release:
     name: Release Installers
diff --git a/package/Tautulli-macos.spec b/package/Tautulli-macos.spec
index bd61f1f2..8ffe6ba5 100644
--- a/package/Tautulli-macos.spec
+++ b/package/Tautulli-macos.spec
@@ -35,7 +35,8 @@ exe = EXE(
     name='Tautulli',
     console=False,
     icon='../data/interfaces/default/images/logo-circle.icns',
-    contents_directory='.'
+    contents_directory='.',
+    target_arch='universal2'
 )
 coll = COLLECT(
     exe,

From b73a2e9accf6b9b7f1393f9527aeb7b84151955e Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 2 Mar 2024 16:28:27 -0800
Subject: [PATCH 523/743] Update workflow statuses

---
 .github/workflows/publish-docker.yml     | 15 +--------------
 .github/workflows/publish-installers.yml | 20 ++------------------
 .github/workflows/publish-snap.yml       | 15 +--------------
 3 files changed, 4 insertions(+), 46 deletions(-)

diff --git a/.github/workflows/publish-docker.yml b/.github/workflows/publish-docker.yml
index 2eccdf5d..f0947104 100644
--- a/.github/workflows/publish-docker.yml
+++ b/.github/workflows/publish-docker.yml
@@ -94,23 +94,10 @@ jobs:
     if: always() && !contains(github.event.head_commit.message, '[skip ci]')
     runs-on: ubuntu-latest
     steps:
-      - name: Get Build Job Status
-        uses: technote-space/workflow-conclusion-action@v3
-
-      - name: Combine Job Status
-        id: status
-        run: |
-          failures=(neutral, skipped, timed_out, action_required)
-          if [[ ${array[@]} =~ $WORKFLOW_CONCLUSION ]]; then
-            echo "status=failure" >> $GITHUB_OUTPUT
-          else
-            echo "status=$WORKFLOW_CONCLUSION" >> $GITHUB_OUTPUT
-          fi
-
       - name: Post Status to Discord
         uses: sarisia/actions-status-discord@v1
         with:
           webhook: ${{ secrets.DISCORD_WEBHOOK }}
-          status: ${{ steps.status.outputs.status }}
+          status: ${{ needs.build-docker.result == 'success' && 'success' || contains(needs.*.result, 'failure') && 'failure' || 'cancelled' }}
           title: ${{ github.workflow }}
           nofail: true
diff --git a/.github/workflows/publish-installers.yml b/.github/workflows/publish-installers.yml
index 87ebc15c..45610edf 100644
--- a/.github/workflows/publish-installers.yml
+++ b/.github/workflows/publish-installers.yml
@@ -106,9 +106,6 @@ jobs:
     if: always() && startsWith(github.ref, 'refs/tags/') && !contains(github.event.head_commit.message, '[skip ci]')
     runs-on: ubuntu-latest
     steps:
-      - name: Get Build Job Status
-        uses: technote-space/workflow-conclusion-action@v3
-
       - name: Checkout Code
         uses: actions/checkout@v4
 
@@ -118,7 +115,7 @@ jobs:
           echo "RELEASE_VERSION=${GITHUB_REF#refs/tags/}" >> $GITHUB_OUTPUT
 
       - name: Download Installers
-        if: env.WORKFLOW_CONCLUSION == 'success'
+        if: needs.build-installer.result == 'success'
         uses: actions/download-artifact@v4
 
       - name: Get Changelog
@@ -154,23 +151,10 @@ jobs:
     if: always() && !contains(github.event.head_commit.message, '[skip ci]')
     runs-on: ubuntu-latest
     steps:
-      - name: Get Build Job Status
-        uses: technote-space/workflow-conclusion-action@v3
-
-      - name: Combine Job Status
-        id: status
-        run: |
-          failures=(neutral, skipped, timed_out, action_required)
-          if [[ ${array[@]} =~ $WORKFLOW_CONCLUSION ]]; then
-            echo "status=failure" >> $GITHUB_OUTPUT
-          else
-            echo "status=$WORKFLOW_CONCLUSION" >> $GITHUB_OUTPUT
-          fi
-
       - name: Post Status to Discord
         uses: sarisia/actions-status-discord@v1
         with:
           webhook: ${{ secrets.DISCORD_WEBHOOK }}
-          status: ${{ steps.status.outputs.status }}
+          status: ${{ needs.build-installer.result == 'success' && 'success' || contains(needs.*.result, 'failure') && 'failure' || 'cancelled' }}
           title: ${{ github.workflow }}
           nofail: true
diff --git a/.github/workflows/publish-snap.yml b/.github/workflows/publish-snap.yml
index 65442eca..539282e1 100644
--- a/.github/workflows/publish-snap.yml
+++ b/.github/workflows/publish-snap.yml
@@ -69,23 +69,10 @@ jobs:
     if: always() && !contains(github.event.head_commit.message, '[skip ci]')
     runs-on: ubuntu-latest
     steps:
-      - name: Get Build Job Status
-        uses: technote-space/workflow-conclusion-action@v3
-
-      - name: Combine Job Status
-        id: status
-        run: |
-          failures=(neutral, skipped, timed_out, action_required)
-          if [[ ${array[@]} =~ $WORKFLOW_CONCLUSION ]]; then
-            echo "status=failure" >> $GITHUB_OUTPUT
-          else
-            echo "status=$WORKFLOW_CONCLUSION" >> $GITHUB_OUTPUT
-          fi
-
       - name: Post Status to Discord
         uses: sarisia/actions-status-discord@v1
         with:
           webhook: ${{ secrets.DISCORD_WEBHOOK }}
-          status: ${{ steps.status.outputs.status }}
+          status: ${{ needs.build-snap.result == 'success' && 'success' || contains(needs.*.result, 'failure') && 'failure' || 'cancelled' }}
           title: ${{ github.workflow }}
           nofail: true

From 149c7fa7a0e9fa76060e95e5d69fc09d0ccb8267 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 2 Mar 2024 16:45:02 -0800
Subject: [PATCH 524/743] Bump snap to core22

---
 snap/snapcraft.yaml | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/snap/snapcraft.yaml b/snap/snapcraft.yaml
index 030e72a9..612b189d 100644
--- a/snap/snapcraft.yaml
+++ b/snap/snapcraft.yaml
@@ -7,7 +7,7 @@ description: >
   The only thing missing is "why they watched it", but who am I to question your 42 plays of Frozen. 
   All statistics are presented in a nice and clean interface with many tables and graphs, which makes it easy to brag about your server to everyone else.
 
-base: core20
+base: core22
 confinement: strict
 
 architectures:
@@ -37,8 +37,8 @@ parts:
       - python3-setuptools
       - python3-pkg-resources
     override-pull: |
-      snapcraftctl pull
-      git config --global --add safe.directory /data/parts/tautulli/src
+      craftctl default
+      git config --global --add safe.directory /root/parts/tautulli/src
       TAG_FULL=$(git describe --tag)
       TAG=$(echo $TAG_FULL | grep -oP '(v\d+\.\d+\.\d+(?>-beta)?)')
       BRANCH=$(git rev-parse --abbrev-ref HEAD)
@@ -60,10 +60,10 @@ parts:
       fi
       echo $BRANCH > branch.txt
       echo $COMMIT > version.txt
-      snapcraftctl set-version "$VERSION"
-      snapcraftctl set-grade "$GRADE"
+      craftctl set version="$VERSION"
+      craftctl set grade="$GRADE"
     override-prime: |
-      snapcraftctl prime
+      craftctl default
       mkdir -p usr/bin
       ln -s /usr/bin/python3 usr/bin/python3
 

From 901c484f89cc4e6e91a389063b065c9f4c04ca89 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 14 Mar 2024 12:15:02 -0700
Subject: [PATCH 525/743] Include deleted usernames in log filter

---
 plexpy/logger.py | 2 +-
 plexpy/users.py  | 6 ++++--
 2 files changed, 5 insertions(+), 3 deletions(-)

diff --git a/plexpy/logger.py b/plexpy/logger.py
index 9f44df95..7227ab10 100644
--- a/plexpy/logger.py
+++ b/plexpy/logger.py
@@ -76,7 +76,7 @@ def filter_usernames(new_users=None):
     global _FILTER_USERNAMES
 
     if new_users is None:
-        new_users = [user['username'] for user in users.Users().get_users()]
+        new_users = [user['username'] for user in users.Users().get_users(include_deleted=True)]
 
     for username in new_users:
         if username.lower() not in ('local', 'guest') and len(username) > 3 and username not in _FILTER_USERNAMES:
diff --git a/plexpy/users.py b/plexpy/users.py
index 0e201791..974d30cd 100644
--- a/plexpy/users.py
+++ b/plexpy/users.py
@@ -679,15 +679,17 @@ class Users(object):
 
         return recently_watched
 
-    def get_users(self):
+    def get_users(self, include_deleted=False):
         monitor_db = database.MonitorDatabase()
 
+        where = '' if include_deleted else 'WHERE deleted_user = 0'
+
         try:
             query = "SELECT id AS row_id, user_id, username, friendly_name, thumb, custom_avatar_url, email, " \
                     "is_active, is_admin, is_home_user, is_allow_sync, is_restricted, " \
                     "do_notify, keep_history, allow_guest, shared_libraries, " \
                     "filter_all, filter_movies, filter_tv, filter_music, filter_photos " \
-                    "FROM users WHERE deleted_user = 0"
+                    "FROM users %s" % where
             result = monitor_db.select(query=query)
         except Exception as e:
             logger.warn("Tautulli Users :: Unable to execute database query for get_users: %s." % e)

From 344f19c9d6581cddf92ff89dafadf358b1b0e784 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sun, 24 Mar 2024 14:53:10 -0700
Subject: [PATCH 526/743] Bump actions/cache from 3 to 4 (#2261)

Bumps [actions/cache](https://github.com/actions/cache) from 3 to 4.
- [Release notes](https://github.com/actions/cache/releases)
- [Changelog](https://github.com/actions/cache/blob/main/RELEASES.md)
- [Commits](https://github.com/actions/cache/compare/v3...v4)

---
updated-dependencies:
- dependency-name: actions/cache
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 .github/workflows/publish-docker.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/publish-docker.yml b/.github/workflows/publish-docker.yml
index f0947104..1185e5eb 100644
--- a/.github/workflows/publish-docker.yml
+++ b/.github/workflows/publish-docker.yml
@@ -47,7 +47,7 @@ jobs:
           version: latest
 
       - name: Cache Docker Layers
-        uses: actions/cache@v3
+        uses: actions/cache@v4
         with:
           path: /tmp/.buildx-cache
           key: ${{ runner.os }}-buildx-${{ github.sha }}

From d3504e8a3c192f28c12397494857c7b2dcc6e31a Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sun, 24 Mar 2024 14:53:44 -0700
Subject: [PATCH 527/743] Bump softprops/action-gh-release from 1 to 2 (#2273)

Bumps [softprops/action-gh-release](https://github.com/softprops/action-gh-release) from 1 to 2.
- [Release notes](https://github.com/softprops/action-gh-release/releases)
- [Changelog](https://github.com/softprops/action-gh-release/blob/master/CHANGELOG.md)
- [Commits](https://github.com/softprops/action-gh-release/compare/v1...v2)

---
updated-dependencies:
- dependency-name: softprops/action-gh-release
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 .github/workflows/publish-installers.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/publish-installers.yml b/.github/workflows/publish-installers.yml
index 45610edf..7b79eea6 100644
--- a/.github/workflows/publish-installers.yml
+++ b/.github/workflows/publish-installers.yml
@@ -129,7 +129,7 @@ jobs:
           echo "$EOF" >> $GITHUB_OUTPUT
 
       - name: Create Release
-        uses: softprops/action-gh-release@v1
+        uses: softprops/action-gh-release@v2
         id: create_release
         env:
           GITHUB_TOKEN: ${{ secrets.GHACTIONS_TOKEN }}

From c1b8be0227d2aa47e4092e86a5e4e1e617ff0b13 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sun, 24 Mar 2024 15:20:52 -0700
Subject: [PATCH 528/743] Bump arrow from 1.2.3 to 1.3.0 (#2172)

* Bump arrow from 1.2.3 to 1.3.0

Bumps [arrow](https://github.com/arrow-py/arrow) from 1.2.3 to 1.3.0.
- [Release notes](https://github.com/arrow-py/arrow/releases)
- [Changelog](https://github.com/arrow-py/arrow/blob/master/CHANGELOG.rst)
- [Commits](https://github.com/arrow-py/arrow/compare/1.2.3...1.3.0)

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

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

* Update arrow==1.3.0

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/arrow/_version.py                         |   2 +-
 lib/arrow/arrow.py                            |  31 ++---
 lib/arrow/factory.py                          |   3 -
 lib/arrow/formatter.py                        |   4 -
 lib/arrow/locales.py                          |  34 ++++--
 lib/arrow/parser.py                           |  20 +--
 lib/dateutil-stubs/METADATA.toml              |   6 +
 lib/dateutil-stubs/__init__.pyi               |   0
 lib/dateutil-stubs/_common.pyi                |   9 ++
 lib/dateutil-stubs/easter.pyi                 |   8 ++
 lib/dateutil-stubs/parser/__init__.pyi        |  67 ++++++++++
 lib/dateutil-stubs/parser/isoparser.pyi       |  15 +++
 lib/dateutil-stubs/py.typed                   |   1 +
 lib/dateutil-stubs/relativedelta.pyi          |  97 +++++++++++++++
 lib/dateutil-stubs/rrule.pyi                  | 111 +++++++++++++++++
 lib/dateutil-stubs/tz/__init__.pyi            |  15 +++
 lib/dateutil-stubs/tz/_common.pyi             |  28 +++++
 lib/dateutil-stubs/tz/tz.pyi                  | 115 ++++++++++++++++++
 lib/dateutil-stubs/utils.pyi                  |   5 +
 lib/dateutil-stubs/zoneinfo/__init__.pyi      |  17 +++
 lib/dateutil-stubs/zoneinfo/rebuild.pyi       |  11 ++
 lib/dateutil/__init__.py                      |  16 +++
 lib/dateutil/_version.py                      |   5 +-
 lib/dateutil/parser/isoparser.py              |   2 +-
 lib/dateutil/relativedelta.py                 |   2 +-
 lib/dateutil/rrule.py                         |   2 +-
 lib/dateutil/tz/tz.py                         |   2 +-
 .../zoneinfo/dateutil-zoneinfo.tar.gz         | Bin 174394 -> 156400 bytes
 requirements.txt                              |   2 +-
 29 files changed, 564 insertions(+), 66 deletions(-)
 create mode 100644 lib/dateutil-stubs/METADATA.toml
 create mode 100644 lib/dateutil-stubs/__init__.pyi
 create mode 100644 lib/dateutil-stubs/_common.pyi
 create mode 100644 lib/dateutil-stubs/easter.pyi
 create mode 100644 lib/dateutil-stubs/parser/__init__.pyi
 create mode 100644 lib/dateutil-stubs/parser/isoparser.pyi
 create mode 100644 lib/dateutil-stubs/py.typed
 create mode 100644 lib/dateutil-stubs/relativedelta.pyi
 create mode 100644 lib/dateutil-stubs/rrule.pyi
 create mode 100644 lib/dateutil-stubs/tz/__init__.pyi
 create mode 100644 lib/dateutil-stubs/tz/_common.pyi
 create mode 100644 lib/dateutil-stubs/tz/tz.pyi
 create mode 100644 lib/dateutil-stubs/utils.pyi
 create mode 100644 lib/dateutil-stubs/zoneinfo/__init__.pyi
 create mode 100644 lib/dateutil-stubs/zoneinfo/rebuild.pyi

diff --git a/lib/arrow/_version.py b/lib/arrow/_version.py
index 10aa336c..67bc602a 100644
--- a/lib/arrow/_version.py
+++ b/lib/arrow/_version.py
@@ -1 +1 @@
-__version__ = "1.2.3"
+__version__ = "1.3.0"
diff --git a/lib/arrow/arrow.py b/lib/arrow/arrow.py
index 1ede107f..8d329efd 100644
--- a/lib/arrow/arrow.py
+++ b/lib/arrow/arrow.py
@@ -168,9 +168,9 @@ class Arrow:
             isinstance(tzinfo, dt_tzinfo)
             and hasattr(tzinfo, "localize")
             and hasattr(tzinfo, "zone")
-            and tzinfo.zone  # type: ignore[attr-defined]
+            and tzinfo.zone
         ):
-            tzinfo = parser.TzinfoParser.parse(tzinfo.zone)  # type: ignore[attr-defined]
+            tzinfo = parser.TzinfoParser.parse(tzinfo.zone)
         elif isinstance(tzinfo, str):
             tzinfo = parser.TzinfoParser.parse(tzinfo)
 
@@ -495,7 +495,7 @@ class Arrow:
             yield current
 
             values = [getattr(current, f) for f in cls._ATTRS]
-            current = cls(*values, tzinfo=tzinfo).shift(  # type: ignore
+            current = cls(*values, tzinfo=tzinfo).shift(  # type: ignore[misc]
                 **{frame_relative: relative_steps}
             )
 
@@ -578,7 +578,7 @@ class Arrow:
             for _ in range(3 - len(values)):
                 values.append(1)
 
-            floor = self.__class__(*values, tzinfo=self.tzinfo)  # type: ignore
+            floor = self.__class__(*values, tzinfo=self.tzinfo)  # type: ignore[misc]
 
             if frame_absolute == "week":
                 # if week_start is greater than self.isoweekday() go back one week by setting delta = 7
@@ -792,7 +792,6 @@ class Arrow:
         return self._datetime.isoformat()
 
     def __format__(self, formatstr: str) -> str:
-
         if len(formatstr) > 0:
             return self.format(formatstr)
 
@@ -804,7 +803,6 @@ class Arrow:
     # attributes and properties
 
     def __getattr__(self, name: str) -> int:
-
         if name == "week":
             return self.isocalendar()[1]
 
@@ -965,7 +963,6 @@ class Arrow:
         absolute_kwargs = {}
 
         for key, value in kwargs.items():
-
             if key in self._ATTRS:
                 absolute_kwargs[key] = value
             elif key in ["week", "quarter"]:
@@ -1022,7 +1019,6 @@ class Arrow:
         additional_attrs = ["weeks", "quarters", "weekday"]
 
         for key, value in kwargs.items():
-
             if key in self._ATTRS_PLURAL or key in additional_attrs:
                 relative_kwargs[key] = value
             else:
@@ -1259,11 +1255,10 @@ class Arrow:
                     )
 
                 if trunc(abs(delta)) != 1:
-                    granularity += "s"  # type: ignore
+                    granularity += "s"  # type: ignore[assignment]
                 return locale.describe(granularity, delta, only_distance=only_distance)
 
             else:
-
                 if not granularity:
                     raise ValueError(
                         "Empty granularity list provided. "
@@ -1314,7 +1309,7 @@ class Arrow:
 
     def dehumanize(self, input_string: str, locale: str = "en_us") -> "Arrow":
         """Returns a new :class:`Arrow <arrow.arrow.Arrow>` object, that represents
-        the time difference relative to the attrbiutes of the
+        the time difference relative to the attributes of the
         :class:`Arrow <arrow.arrow.Arrow>` object.
 
         :param timestring: a ``str`` representing a humanized relative time.
@@ -1367,7 +1362,6 @@ class Arrow:
 
         # Search input string for each time unit within locale
         for unit, unit_object in locale_obj.timeframes.items():
-
             # Need to check the type of unit_object to create the correct dictionary
             if isinstance(unit_object, Mapping):
                 strings_to_search = unit_object
@@ -1378,7 +1372,6 @@ class Arrow:
             # Needs to cycle all through strings as some locales have strings that
             # could overlap in a regex match, since input validation isn't being performed.
             for time_delta, time_string in strings_to_search.items():
-
                 # Replace {0} with regex \d representing digits
                 search_string = str(time_string)
                 search_string = search_string.format(r"\d+")
@@ -1419,7 +1412,7 @@ class Arrow:
         # Assert error if string does not modify any units
         if not any([True for k, v in unit_visited.items() if v]):
             raise ValueError(
-                "Input string not valid. Note: Some locales do not support the week granulairty in Arrow. "
+                "Input string not valid. Note: Some locales do not support the week granularity in Arrow. "
                 "If you are attempting to use the week granularity on an unsupported locale, this could be the cause of this error."
             )
 
@@ -1718,7 +1711,6 @@ class Arrow:
     # math
 
     def __add__(self, other: Any) -> "Arrow":
-
         if isinstance(other, (timedelta, relativedelta)):
             return self.fromdatetime(self._datetime + other, self._datetime.tzinfo)
 
@@ -1736,7 +1728,6 @@ class Arrow:
         pass  # pragma: no cover
 
     def __sub__(self, other: Any) -> Union[timedelta, "Arrow"]:
-
         if isinstance(other, (timedelta, relativedelta)):
             return self.fromdatetime(self._datetime - other, self._datetime.tzinfo)
 
@@ -1749,7 +1740,6 @@ class Arrow:
         return NotImplemented
 
     def __rsub__(self, other: Any) -> timedelta:
-
         if isinstance(other, dt_datetime):
             return other - self._datetime
 
@@ -1758,42 +1748,36 @@ class Arrow:
     # comparisons
 
     def __eq__(self, other: Any) -> bool:
-
         if not isinstance(other, (Arrow, dt_datetime)):
             return False
 
         return self._datetime == self._get_datetime(other)
 
     def __ne__(self, other: Any) -> bool:
-
         if not isinstance(other, (Arrow, dt_datetime)):
             return True
 
         return not self.__eq__(other)
 
     def __gt__(self, other: Any) -> bool:
-
         if not isinstance(other, (Arrow, dt_datetime)):
             return NotImplemented
 
         return self._datetime > self._get_datetime(other)
 
     def __ge__(self, other: Any) -> bool:
-
         if not isinstance(other, (Arrow, dt_datetime)):
             return NotImplemented
 
         return self._datetime >= self._get_datetime(other)
 
     def __lt__(self, other: Any) -> bool:
-
         if not isinstance(other, (Arrow, dt_datetime)):
             return NotImplemented
 
         return self._datetime < self._get_datetime(other)
 
     def __le__(self, other: Any) -> bool:
-
         if not isinstance(other, (Arrow, dt_datetime)):
             return NotImplemented
 
@@ -1865,7 +1849,6 @@ class Arrow:
     def _get_iteration_params(cls, end: Any, limit: Optional[int]) -> Tuple[Any, int]:
         """Sets default end and limit values for range method."""
         if end is None:
-
             if limit is None:
                 raise ValueError("One of 'end' or 'limit' is required.")
 
diff --git a/lib/arrow/factory.py b/lib/arrow/factory.py
index aad4af8b..f35085f1 100644
--- a/lib/arrow/factory.py
+++ b/lib/arrow/factory.py
@@ -267,11 +267,9 @@ class ArrowFactory:
                 raise TypeError(f"Cannot parse single argument of type {type(arg)!r}.")
 
         elif arg_count == 2:
-
             arg_1, arg_2 = args[0], args[1]
 
             if isinstance(arg_1, datetime):
-
                 # (datetime, tzinfo/str) -> fromdatetime @ tzinfo
                 if isinstance(arg_2, (dt_tzinfo, str)):
                     return self.type.fromdatetime(arg_1, tzinfo=arg_2)
@@ -281,7 +279,6 @@ class ArrowFactory:
                     )
 
             elif isinstance(arg_1, date):
-
                 # (date, tzinfo/str) -> fromdate @ tzinfo
                 if isinstance(arg_2, (dt_tzinfo, str)):
                     return self.type.fromdate(arg_1, tzinfo=arg_2)
diff --git a/lib/arrow/formatter.py b/lib/arrow/formatter.py
index 728bea1a..d45f7153 100644
--- a/lib/arrow/formatter.py
+++ b/lib/arrow/formatter.py
@@ -29,7 +29,6 @@ FORMAT_W3C: Final[str] = "YYYY-MM-DD HH:mm:ssZZ"
 
 
 class DateTimeFormatter:
-
     # This pattern matches characters enclosed in square brackets are matched as
     # an atomic group. For more info on atomic groups and how to they are
     # emulated in Python's re library, see https://stackoverflow.com/a/13577411/2701578
@@ -41,18 +40,15 @@ class DateTimeFormatter:
     locale: locales.Locale
 
     def __init__(self, locale: str = DEFAULT_LOCALE) -> None:
-
         self.locale = locales.get_locale(locale)
 
     def format(cls, dt: datetime, fmt: str) -> str:
-
         # FIXME: _format_token() is nullable
         return cls._FORMAT_RE.sub(
             lambda m: cast(str, cls._format_token(dt, m.group(0))), fmt
         )
 
     def _format_token(self, dt: datetime, token: Optional[str]) -> Optional[str]:
-
         if token and token.startswith("[") and token.endswith("]"):
             return token[1:-1]
 
diff --git a/lib/arrow/locales.py b/lib/arrow/locales.py
index 3627497f..34b2a098 100644
--- a/lib/arrow/locales.py
+++ b/lib/arrow/locales.py
@@ -129,7 +129,6 @@ class Locale:
             _locale_map[locale_name.lower().replace("_", "-")] = cls
 
     def __init__(self) -> None:
-
         self._month_name_to_ordinal = None
 
     def describe(
@@ -174,7 +173,7 @@ class Locale:
             # Needed to determine the correct relative string to use
             timeframe_value = 0
 
-            for _unit_name, unit_value in timeframes:
+            for _, unit_value in timeframes:
                 if trunc(unit_value) != 0:
                     timeframe_value = trunc(unit_value)
                     break
@@ -285,7 +284,6 @@ class Locale:
         timeframe: TimeFrameLiteral,
         delta: Union[float, int],
     ) -> str:
-
         if timeframe == "now":
             return humanized
 
@@ -425,7 +423,7 @@ class ItalianLocale(Locale):
         "hours": "{0} ore",
         "day": "un giorno",
         "days": "{0} giorni",
-        "week": "una settimana,",
+        "week": "una settimana",
         "weeks": "{0} settimane",
         "month": "un mese",
         "months": "{0} mesi",
@@ -867,14 +865,16 @@ class FinnishLocale(Locale):
 
     timeframes: ClassVar[Mapping[TimeFrameLiteral, Union[str, Mapping[str, str]]]] = {
         "now": "juuri nyt",
-        "second": "sekunti",
-        "seconds": {"past": "{0} muutama sekunti", "future": "{0} muutaman sekunnin"},
+        "second": {"past": "sekunti", "future": "sekunnin"},
+        "seconds": {"past": "{0} sekuntia", "future": "{0} sekunnin"},
         "minute": {"past": "minuutti", "future": "minuutin"},
         "minutes": {"past": "{0} minuuttia", "future": "{0} minuutin"},
         "hour": {"past": "tunti", "future": "tunnin"},
         "hours": {"past": "{0} tuntia", "future": "{0} tunnin"},
-        "day": "päivä",
+        "day": {"past": "päivä", "future": "päivän"},
         "days": {"past": "{0} päivää", "future": "{0} päivän"},
+        "week": {"past": "viikko", "future": "viikon"},
+        "weeks": {"past": "{0} viikkoa", "future": "{0} viikon"},
         "month": {"past": "kuukausi", "future": "kuukauden"},
         "months": {"past": "{0} kuukautta", "future": "{0} kuukauden"},
         "year": {"past": "vuosi", "future": "vuoden"},
@@ -1887,7 +1887,7 @@ class GermanBaseLocale(Locale):
     future = "in {0}"
     and_word = "und"
 
-    timeframes = {
+    timeframes: ClassVar[Dict[TimeFrameLiteral, str]] = {
         "now": "gerade eben",
         "second": "einer Sekunde",
         "seconds": "{0} Sekunden",
@@ -1982,7 +1982,9 @@ class GermanBaseLocale(Locale):
             return super().describe(timeframe, delta, only_distance)
 
         # German uses a different case without 'in' or 'ago'
-        humanized = self.timeframes_only_distance[timeframe].format(trunc(abs(delta)))
+        humanized: str = self.timeframes_only_distance[timeframe].format(
+            trunc(abs(delta))
+        )
 
         return humanized
 
@@ -2547,6 +2549,8 @@ class ArabicLocale(Locale):
         "hours": {"2": "ساعتين", "ten": "{0} ساعات", "higher": "{0} ساعة"},
         "day": "يوم",
         "days": {"2": "يومين", "ten": "{0} أيام", "higher": "{0} يوم"},
+        "week": "اسبوع",
+        "weeks": {"2": "اسبوعين", "ten": "{0} أسابيع", "higher": "{0} اسبوع"},
         "month": "شهر",
         "months": {"2": "شهرين", "ten": "{0} أشهر", "higher": "{0} شهر"},
         "year": "سنة",
@@ -3709,6 +3713,8 @@ class HungarianLocale(Locale):
         "hours": {"past": "{0} órával", "future": "{0} óra"},
         "day": {"past": "egy nappal", "future": "egy nap"},
         "days": {"past": "{0} nappal", "future": "{0} nap"},
+        "week": {"past": "egy héttel", "future": "egy hét"},
+        "weeks": {"past": "{0} héttel", "future": "{0} hét"},
         "month": {"past": "egy hónappal", "future": "egy hónap"},
         "months": {"past": "{0} hónappal", "future": "{0} hónap"},
         "year": {"past": "egy évvel", "future": "egy év"},
@@ -3934,7 +3940,6 @@ class ThaiLocale(Locale):
 
 
 class LaotianLocale(Locale):
-
     names = ["lo", "lo-la"]
 
     past = "{0} ກ່ອນຫນ້ານີ້"
@@ -4119,6 +4124,7 @@ class BengaliLocale(Locale):
             return f"{n}র্থ"
         if n == 6:
             return f"{n}ষ্ঠ"
+        return ""
 
 
 class RomanshLocale(Locale):
@@ -4137,6 +4143,8 @@ class RomanshLocale(Locale):
         "hours": "{0} ura",
         "day": "in di",
         "days": "{0} dis",
+        "week": "in'emna",
+        "weeks": "{0} emnas",
         "month": "in mais",
         "months": "{0} mais",
         "year": "in onn",
@@ -5399,7 +5407,7 @@ class LuxembourgishLocale(Locale):
     future = "an {0}"
     and_word = "an"
 
-    timeframes = {
+    timeframes: ClassVar[Dict[TimeFrameLiteral, str]] = {
         "now": "just elo",
         "second": "enger Sekonn",
         "seconds": "{0} Sekonnen",
@@ -5487,7 +5495,9 @@ class LuxembourgishLocale(Locale):
             return super().describe(timeframe, delta, only_distance)
 
         # Luxembourgish uses a different case without 'in' or 'ago'
-        humanized = self.timeframes_only_distance[timeframe].format(trunc(abs(delta)))
+        humanized: str = self.timeframes_only_distance[timeframe].format(
+            trunc(abs(delta))
+        )
 
         return humanized
 
diff --git a/lib/arrow/parser.py b/lib/arrow/parser.py
index e95d78b0..645e3da7 100644
--- a/lib/arrow/parser.py
+++ b/lib/arrow/parser.py
@@ -159,7 +159,6 @@ class DateTimeParser:
     _input_re_map: Dict[_FORMAT_TYPE, Pattern[str]]
 
     def __init__(self, locale: str = DEFAULT_LOCALE, cache_size: int = 0) -> None:
-
         self.locale = locales.get_locale(locale)
         self._input_re_map = self._BASE_INPUT_RE_MAP.copy()
         self._input_re_map.update(
@@ -196,7 +195,6 @@ class DateTimeParser:
     def parse_iso(
         self, datetime_string: str, normalize_whitespace: bool = False
     ) -> datetime:
-
         if normalize_whitespace:
             datetime_string = re.sub(r"\s+", " ", datetime_string.strip())
 
@@ -236,13 +234,14 @@ class DateTimeParser:
         ]
 
         if has_time:
-
             if has_space_divider:
                 date_string, time_string = datetime_string.split(" ", 1)
             else:
                 date_string, time_string = datetime_string.split("T", 1)
 
-            time_parts = re.split(r"[\+\-Z]", time_string, 1, re.IGNORECASE)
+            time_parts = re.split(
+                r"[\+\-Z]", time_string, maxsplit=1, flags=re.IGNORECASE
+            )
 
             time_components: Optional[Match[str]] = self._TIME_RE.match(time_parts[0])
 
@@ -303,7 +302,6 @@ class DateTimeParser:
         fmt: Union[List[str], str],
         normalize_whitespace: bool = False,
     ) -> datetime:
-
         if normalize_whitespace:
             datetime_string = re.sub(r"\s+", " ", datetime_string)
 
@@ -341,12 +339,11 @@ class DateTimeParser:
                     f"Unable to find a match group for the specified token {token!r}."
                 )
 
-            self._parse_token(token, value, parts)  # type: ignore
+            self._parse_token(token, value, parts)  # type: ignore[arg-type]
 
         return self._build_datetime(parts)
 
     def _generate_pattern_re(self, fmt: str) -> Tuple[List[_FORMAT_TYPE], Pattern[str]]:
-
         # fmt is a string of tokens like 'YYYY-MM-DD'
         # we construct a new string by replacing each
         # token by its pattern:
@@ -498,7 +495,6 @@ class DateTimeParser:
         value: Any,
         parts: _Parts,
     ) -> None:
-
         if token == "YYYY":
             parts["year"] = int(value)
 
@@ -508,7 +504,7 @@ class DateTimeParser:
 
         elif token in ["MMMM", "MMM"]:
             # FIXME: month_number() is nullable
-            parts["month"] = self.locale.month_number(value.lower())  # type: ignore
+            parts["month"] = self.locale.month_number(value.lower())  # type: ignore[typeddict-item]
 
         elif token in ["MM", "M"]:
             parts["month"] = int(value)
@@ -588,7 +584,6 @@ class DateTimeParser:
         weekdate = parts.get("weekdate")
 
         if weekdate is not None:
-
             year, week = int(weekdate[0]), int(weekdate[1])
 
             if weekdate[2] is not None:
@@ -712,7 +707,6 @@ class DateTimeParser:
         )
 
     def _parse_multiformat(self, string: str, formats: Iterable[str]) -> datetime:
-
         _datetime: Optional[datetime] = None
 
         for fmt in formats:
@@ -740,12 +734,11 @@ class DateTimeParser:
 
 class TzinfoParser:
     _TZINFO_RE: ClassVar[Pattern[str]] = re.compile(
-        r"^([\+\-])?(\d{2})(?:\:?(\d{2}))?$"
+        r"^(?:\(UTC)*([\+\-])?(\d{2})(?:\:?(\d{2}))?"
     )
 
     @classmethod
     def parse(cls, tzinfo_string: str) -> dt_tzinfo:
-
         tzinfo: Optional[dt_tzinfo] = None
 
         if tzinfo_string == "local":
@@ -755,7 +748,6 @@ class TzinfoParser:
             tzinfo = tz.tzutc()
 
         else:
-
             iso_match = cls._TZINFO_RE.match(tzinfo_string)
 
             if iso_match:
diff --git a/lib/dateutil-stubs/METADATA.toml b/lib/dateutil-stubs/METADATA.toml
new file mode 100644
index 00000000..5f2be1e4
--- /dev/null
+++ b/lib/dateutil-stubs/METADATA.toml
@@ -0,0 +1,6 @@
+version = "2.9.*"
+upstream_repository = "https://github.com/dateutil/dateutil"
+partial_stub = true
+
+[tool.stubtest]
+ignore_missing_stub = true
diff --git a/lib/dateutil-stubs/__init__.pyi b/lib/dateutil-stubs/__init__.pyi
new file mode 100644
index 00000000..e69de29b
diff --git a/lib/dateutil-stubs/_common.pyi b/lib/dateutil-stubs/_common.pyi
new file mode 100644
index 00000000..75bf74c5
--- /dev/null
+++ b/lib/dateutil-stubs/_common.pyi
@@ -0,0 +1,9 @@
+from typing_extensions import Self
+
+class weekday:
+    def __init__(self, weekday: int, n: int | None = None) -> None: ...
+    def __call__(self, n: int) -> Self: ...
+    def __eq__(self, other: object) -> bool: ...
+    def __hash__(self) -> int: ...
+    weekday: int
+    n: int
diff --git a/lib/dateutil-stubs/easter.pyi b/lib/dateutil-stubs/easter.pyi
new file mode 100644
index 00000000..952d1191
--- /dev/null
+++ b/lib/dateutil-stubs/easter.pyi
@@ -0,0 +1,8 @@
+from datetime import date
+from typing import Literal
+
+EASTER_JULIAN: Literal[1]
+EASTER_ORTHODOX: Literal[2]
+EASTER_WESTERN: Literal[3]
+
+def easter(year: int, method: Literal[1, 2, 3] = 3) -> date: ...
diff --git a/lib/dateutil-stubs/parser/__init__.pyi b/lib/dateutil-stubs/parser/__init__.pyi
new file mode 100644
index 00000000..c375ff15
--- /dev/null
+++ b/lib/dateutil-stubs/parser/__init__.pyi
@@ -0,0 +1,67 @@
+from collections.abc import Callable, Mapping
+from datetime import datetime, tzinfo
+from typing import IO, Any
+from typing_extensions import TypeAlias
+
+from .isoparser import isoparse as isoparse, isoparser as isoparser
+
+_FileOrStr: TypeAlias = bytes | str | IO[str] | IO[Any]
+_TzData: TypeAlias = tzinfo | int | str | None
+_TzInfo: TypeAlias = Mapping[str, _TzData] | Callable[[str, int], _TzData]
+
+class parserinfo:
+    JUMP: list[str]
+    WEEKDAYS: list[tuple[str, ...]]
+    MONTHS: list[tuple[str, ...]]
+    HMS: list[tuple[str, str, str]]
+    AMPM: list[tuple[str, str]]
+    UTCZONE: list[str]
+    PERTAIN: list[str]
+    TZOFFSET: dict[str, int]
+    def __init__(self, dayfirst: bool = False, yearfirst: bool = False) -> None: ...
+    def jump(self, name: str) -> bool: ...
+    def weekday(self, name: str) -> int | None: ...
+    def month(self, name: str) -> int | None: ...
+    def hms(self, name: str) -> int | None: ...
+    def ampm(self, name: str) -> int | None: ...
+    def pertain(self, name: str) -> bool: ...
+    def utczone(self, name: str) -> bool: ...
+    def tzoffset(self, name: str) -> int | None: ...
+    def convertyear(self, year: int) -> int: ...
+    def validate(self, res: datetime) -> bool: ...
+
+class parser:
+    def __init__(self, info: parserinfo | None = None) -> None: ...
+    def parse(
+        self,
+        timestr: _FileOrStr,
+        default: datetime | None = None,
+        ignoretz: bool = False,
+        tzinfos: _TzInfo | None = None,
+        *,
+        dayfirst: bool | None = ...,
+        yearfirst: bool | None = ...,
+        fuzzy: bool = ...,
+        fuzzy_with_tokens: bool = ...,
+    ) -> datetime: ...
+
+DEFAULTPARSER: parser
+
+def parse(
+    timestr: _FileOrStr,
+    parserinfo: parserinfo | None = None,
+    *,
+    dayfirst: bool | None = ...,
+    yearfirst: bool | None = ...,
+    ignoretz: bool = ...,
+    fuzzy: bool = ...,
+    fuzzy_with_tokens: bool = ...,
+    default: datetime | None = ...,
+    tzinfos: _TzInfo | None = ...,
+) -> datetime: ...
+
+class _tzparser: ...
+
+DEFAULTTZPARSER: _tzparser
+
+class ParserError(ValueError): ...
diff --git a/lib/dateutil-stubs/parser/isoparser.pyi b/lib/dateutil-stubs/parser/isoparser.pyi
new file mode 100644
index 00000000..fc5e46d9
--- /dev/null
+++ b/lib/dateutil-stubs/parser/isoparser.pyi
@@ -0,0 +1,15 @@
+from _typeshed import SupportsRead
+from datetime import date, datetime, time, tzinfo
+from typing_extensions import TypeAlias
+
+_Readable: TypeAlias = SupportsRead[str | bytes]
+_TakesAscii: TypeAlias = str | bytes | _Readable
+
+class isoparser:
+    def __init__(self, sep: str | bytes | None = None): ...
+    def isoparse(self, dt_str: _TakesAscii) -> datetime: ...
+    def parse_isodate(self, datestr: _TakesAscii) -> date: ...
+    def parse_isotime(self, timestr: _TakesAscii) -> time: ...
+    def parse_tzstr(self, tzstr: _TakesAscii, zero_as_utc: bool = True) -> tzinfo: ...
+
+def isoparse(dt_str: _TakesAscii) -> datetime: ...
diff --git a/lib/dateutil-stubs/py.typed b/lib/dateutil-stubs/py.typed
new file mode 100644
index 00000000..b648ac92
--- /dev/null
+++ b/lib/dateutil-stubs/py.typed
@@ -0,0 +1 @@
+partial
diff --git a/lib/dateutil-stubs/relativedelta.pyi b/lib/dateutil-stubs/relativedelta.pyi
new file mode 100644
index 00000000..394713db
--- /dev/null
+++ b/lib/dateutil-stubs/relativedelta.pyi
@@ -0,0 +1,97 @@
+from datetime import date, timedelta
+from typing import SupportsFloat, TypeVar, overload
+from typing_extensions import Self, TypeAlias
+
+# See #9817 for why we reexport this here
+from ._common import weekday as weekday
+
+_DateT = TypeVar("_DateT", bound=date)
+# Work around attribute and type having the same name.
+_Weekday: TypeAlias = weekday
+
+MO: weekday
+TU: weekday
+WE: weekday
+TH: weekday
+FR: weekday
+SA: weekday
+SU: weekday
+
+class relativedelta:
+    years: int
+    months: int
+    days: int
+    leapdays: int
+    hours: int
+    minutes: int
+    seconds: int
+    microseconds: int
+    year: int | None
+    month: int | None
+    weekday: _Weekday | None
+    day: int | None
+    hour: int | None
+    minute: int | None
+    second: int | None
+    microsecond: int | None
+    def __init__(
+        self,
+        dt1: date | None = None,
+        dt2: date | None = None,
+        years: int | None = 0,
+        months: int | None = 0,
+        days: int | None = 0,
+        leapdays: int | None = 0,
+        weeks: int | None = 0,
+        hours: int | None = 0,
+        minutes: int | None = 0,
+        seconds: int | None = 0,
+        microseconds: int | None = 0,
+        year: int | None = None,
+        month: int | None = None,
+        day: int | None = None,
+        weekday: int | _Weekday | None = None,
+        yearday: int | None = None,
+        nlyearday: int | None = None,
+        hour: int | None = None,
+        minute: int | None = None,
+        second: int | None = None,
+        microsecond: int | None = None,
+    ) -> None: ...
+    @property
+    def weeks(self) -> int: ...
+    @weeks.setter
+    def weeks(self, value: int) -> None: ...
+    def normalized(self) -> Self: ...
+    # TODO: use Union when mypy will handle it properly in overloaded operator
+    # methods (#2129, #1442, #1264 in mypy)
+    @overload
+    def __add__(self, other: relativedelta) -> Self: ...
+    @overload
+    def __add__(self, other: timedelta) -> Self: ...
+    @overload
+    def __add__(self, other: _DateT) -> _DateT: ...
+    @overload
+    def __radd__(self, other: relativedelta) -> Self: ...
+    @overload
+    def __radd__(self, other: timedelta) -> Self: ...
+    @overload
+    def __radd__(self, other: _DateT) -> _DateT: ...
+    @overload
+    def __rsub__(self, other: relativedelta) -> Self: ...
+    @overload
+    def __rsub__(self, other: timedelta) -> Self: ...
+    @overload
+    def __rsub__(self, other: _DateT) -> _DateT: ...
+    def __sub__(self, other: relativedelta) -> Self: ...
+    def __neg__(self) -> Self: ...
+    def __bool__(self) -> bool: ...
+    def __nonzero__(self) -> bool: ...
+    def __mul__(self, other: SupportsFloat) -> Self: ...
+    def __rmul__(self, other: SupportsFloat) -> Self: ...
+    def __eq__(self, other: object) -> bool: ...
+    def __ne__(self, other: object) -> bool: ...
+    def __div__(self, other: SupportsFloat) -> Self: ...
+    def __truediv__(self, other: SupportsFloat) -> Self: ...
+    def __abs__(self) -> Self: ...
+    def __hash__(self) -> int: ...
diff --git a/lib/dateutil-stubs/rrule.pyi b/lib/dateutil-stubs/rrule.pyi
new file mode 100644
index 00000000..f091cfbd
--- /dev/null
+++ b/lib/dateutil-stubs/rrule.pyi
@@ -0,0 +1,111 @@
+import datetime
+from _typeshed import Incomplete
+from collections.abc import Iterable, Iterator, Sequence
+from typing_extensions import TypeAlias
+
+from ._common import weekday as weekdaybase
+
+YEARLY: int
+MONTHLY: int
+WEEKLY: int
+DAILY: int
+HOURLY: int
+MINUTELY: int
+SECONDLY: int
+
+class weekday(weekdaybase): ...
+
+weekdays: tuple[weekday, weekday, weekday, weekday, weekday, weekday, weekday]
+MO: weekday
+TU: weekday
+WE: weekday
+TH: weekday
+FR: weekday
+SA: weekday
+SU: weekday
+
+class rrulebase:
+    def __init__(self, cache: bool = False) -> None: ...
+    def __iter__(self) -> Iterator[datetime.datetime]: ...
+    def __getitem__(self, item): ...
+    def __contains__(self, item): ...
+    def count(self): ...
+    def before(self, dt, inc: bool = False): ...
+    def after(self, dt, inc: bool = False): ...
+    def xafter(self, dt, count: Incomplete | None = None, inc: bool = False): ...
+    def between(self, after, before, inc: bool = False, count: int = 1): ...
+
+class rrule(rrulebase):
+    def __init__(
+        self,
+        freq,
+        dtstart: datetime.date | None = None,
+        interval: int = 1,
+        wkst: weekday | int | None = None,
+        count: int | None = None,
+        until: datetime.date | int | None = None,
+        bysetpos: int | Iterable[int] | None = None,
+        bymonth: int | Iterable[int] | None = None,
+        bymonthday: int | Iterable[int] | None = None,
+        byyearday: int | Iterable[int] | None = None,
+        byeaster: int | Iterable[int] | None = None,
+        byweekno: int | Iterable[int] | None = None,
+        byweekday: int | weekday | Iterable[int] | Iterable[weekday] | None = None,
+        byhour: int | Iterable[int] | None = None,
+        byminute: int | Iterable[int] | None = None,
+        bysecond: int | Iterable[int] | None = None,
+        cache: bool = False,
+    ) -> None: ...
+    def replace(self, **kwargs): ...
+
+_RRule: TypeAlias = rrule
+
+class _iterinfo:
+    rrule: _RRule
+    def __init__(self, rrule: _RRule) -> None: ...
+    yearlen: int | None
+    nextyearlen: int | None
+    yearordinal: int | None
+    yearweekday: int | None
+    mmask: Sequence[int] | None
+    mdaymask: Sequence[int] | None
+    nmdaymask: Sequence[int] | None
+    wdaymask: Sequence[int] | None
+    mrange: Sequence[int] | None
+    wnomask: Sequence[int] | None
+    nwdaymask: Sequence[int] | None
+    eastermask: Sequence[int] | None
+    lastyear: int | None
+    lastmonth: int | None
+    def rebuild(self, year, month): ...
+    def ydayset(self, year, month, day): ...
+    def mdayset(self, year, month, day): ...
+    def wdayset(self, year, month, day): ...
+    def ddayset(self, year, month, day): ...
+    def htimeset(self, hour, minute, second): ...
+    def mtimeset(self, hour, minute, second): ...
+    def stimeset(self, hour, minute, second): ...
+
+class rruleset(rrulebase):
+    class _genitem:
+        dt: Incomplete
+        genlist: list[Incomplete]
+        gen: Incomplete
+        def __init__(self, genlist, gen) -> None: ...
+        def __next__(self) -> None: ...
+        next = __next__
+        def __lt__(self, other) -> bool: ...
+        def __gt__(self, other) -> bool: ...
+        def __eq__(self, other) -> bool: ...
+        def __ne__(self, other) -> bool: ...
+
+    def __init__(self, cache: bool = False) -> None: ...
+    def rrule(self, rrule: _RRule): ...
+    def rdate(self, rdate): ...
+    def exrule(self, exrule): ...
+    def exdate(self, exdate): ...
+
+class _rrulestr:
+    def __call__(self, s, **kwargs) -> rrule | rruleset: ...
+
+rrulestr: _rrulestr
diff --git a/lib/dateutil-stubs/tz/__init__.pyi b/lib/dateutil-stubs/tz/__init__.pyi
new file mode 100644
index 00000000..334ca482
--- /dev/null
+++ b/lib/dateutil-stubs/tz/__init__.pyi
@@ -0,0 +1,15 @@
+from .tz import (
+    datetime_ambiguous as datetime_ambiguous,
+    datetime_exists as datetime_exists,
+    gettz as gettz,
+    resolve_imaginary as resolve_imaginary,
+    tzfile as tzfile,
+    tzical as tzical,
+    tzlocal as tzlocal,
+    tzoffset as tzoffset,
+    tzrange as tzrange,
+    tzstr as tzstr,
+    tzutc as tzutc,
+)
+
+UTC: tzutc
diff --git a/lib/dateutil-stubs/tz/_common.pyi b/lib/dateutil-stubs/tz/_common.pyi
new file mode 100644
index 00000000..4e64822f
--- /dev/null
+++ b/lib/dateutil-stubs/tz/_common.pyi
@@ -0,0 +1,28 @@
+import abc
+from datetime import datetime, timedelta, tzinfo
+from typing import ClassVar
+
+def tzname_in_python2(namefunc): ...
+def enfold(dt: datetime, fold: int = 1): ...
+
+class _DatetimeWithFold(datetime):
+    @property
+    def fold(self): ...
+
+# Doesn't actually have ABCMeta as the metaclass at runtime,
+# but mypy complains if we don't have it in the stub.
+# See discussion in #8908
+class _tzinfo(tzinfo, metaclass=abc.ABCMeta):
+    def is_ambiguous(self, dt: datetime) -> bool: ...
+    def fromutc(self, dt: datetime) -> datetime: ...
+
+class tzrangebase(_tzinfo):
+    def __init__(self) -> None: ...
+    def utcoffset(self, dt: datetime | None) -> timedelta | None: ...
+    def dst(self, dt: datetime | None) -> timedelta | None: ...
+    def tzname(self, dt: datetime | None) -> str: ...
+    def fromutc(self, dt: datetime) -> datetime: ...
+    def is_ambiguous(self, dt: datetime) -> bool: ...
+    __hash__: ClassVar[None]  # type: ignore[assignment]
+    def __ne__(self, other): ...
+    __reduce__ = object.__reduce__
diff --git a/lib/dateutil-stubs/tz/tz.pyi b/lib/dateutil-stubs/tz/tz.pyi
new file mode 100644
index 00000000..6addba65
--- /dev/null
+++ b/lib/dateutil-stubs/tz/tz.pyi
@@ -0,0 +1,115 @@
+import datetime
+from _typeshed import Incomplete
+from typing import ClassVar, Literal, Protocol, TypeVar
+
+from ..relativedelta import relativedelta
+from ._common import _tzinfo as _tzinfo, enfold as enfold, tzname_in_python2 as tzname_in_python2, tzrangebase as tzrangebase
+
+_DT = TypeVar("_DT", bound=datetime.datetime)
+
+ZERO: datetime.timedelta
+EPOCH: datetime.datetime
+EPOCHORDINAL: int
+
+class tzutc(datetime.tzinfo):
+    def utcoffset(self, dt: datetime.datetime | None) -> datetime.timedelta | None: ...
+    def dst(self, dt: datetime.datetime | None) -> datetime.timedelta | None: ...
+    def tzname(self, dt: datetime.datetime | None) -> str: ...
+    def is_ambiguous(self, dt: datetime.datetime | None) -> bool: ...
+    def fromutc(self, dt: _DT) -> _DT: ...
+    def __eq__(self, other): ...
+    __hash__: ClassVar[None]  # type: ignore[assignment]
+    def __ne__(self, other): ...
+    __reduce__ = object.__reduce__
+
+class tzoffset(datetime.tzinfo):
+    def __init__(self, name, offset) -> None: ...
+    def utcoffset(self, dt: datetime.datetime | None) -> datetime.timedelta | None: ...
+    def dst(self, dt: datetime.datetime | None) -> datetime.timedelta | None: ...
+    def is_ambiguous(self, dt: datetime.datetime | None) -> bool: ...
+    def tzname(self, dt: datetime.datetime | None) -> str: ...
+    def fromutc(self, dt: _DT) -> _DT: ...
+    def __eq__(self, other): ...
+    __hash__: ClassVar[None]  # type: ignore[assignment]
+    def __ne__(self, other): ...
+    __reduce__ = object.__reduce__
+    @classmethod
+    def instance(cls, name, offset) -> tzoffset: ...
+
+class tzlocal(_tzinfo):
+    def __init__(self) -> None: ...
+    def utcoffset(self, dt: datetime.datetime | None) -> datetime.timedelta | None: ...
+    def dst(self, dt: datetime.datetime | None) -> datetime.timedelta | None: ...
+    def tzname(self, dt: datetime.datetime | None) -> str: ...
+    def is_ambiguous(self, dt: datetime.datetime | None) -> bool: ...
+    def __eq__(self, other): ...
+    __hash__: ClassVar[None]  # type: ignore[assignment]
+    def __ne__(self, other): ...
+    __reduce__ = object.__reduce__
+
+class _ttinfo:
+    def __init__(self) -> None: ...
+    def __eq__(self, other): ...
+    __hash__: ClassVar[None]  # type: ignore[assignment]
+    def __ne__(self, other): ...
+
+class _TZFileReader(Protocol):
+    # optional attribute:
+    # name: str
+    def read(self, size: int, /) -> bytes: ...
+    def seek(self, target: int, whence: Literal[1], /) -> object: ...
+
+class tzfile(_tzinfo):
+    def __init__(self, fileobj: str | _TZFileReader, filename: str | None = None) -> None: ...
+    def is_ambiguous(self, dt: datetime.datetime | None, idx: int | None = None) -> bool: ...
+    def utcoffset(self, dt: datetime.datetime | None) -> datetime.timedelta | None: ...
+    def dst(self, dt: datetime.datetime | None) -> datetime.timedelta | None: ...
+    def tzname(self, dt: datetime.datetime | None) -> str: ...
+    def __eq__(self, other): ...
+    __hash__: ClassVar[None]  # type: ignore[assignment]
+    def __ne__(self, other): ...
+    def __reduce__(self): ...
+    def __reduce_ex__(self, protocol): ...
+
+class tzrange(tzrangebase):
+    hasdst: bool
+    def __init__(
+        self,
+        stdabbr: str,
+        stdoffset: int | datetime.timedelta | None = None,
+        dstabbr: str | None = None,
+        dstoffset: int | datetime.timedelta | None = None,
+        start: relativedelta | None = None,
+        end: relativedelta | None = None,
+    ) -> None: ...
+    def transitions(self, year: int) -> tuple[datetime.datetime, datetime.datetime]: ...
+    def __eq__(self, other): ...
+
+class tzstr(tzrange):
+    hasdst: bool
+    def __init__(self, s: str, posix_offset: bool = False) -> None: ...
+    @classmethod
+    def instance(cls, name, offset) -> tzoffset: ...
+
+class _ICalReader(Protocol):
+    # optional attribute:
+    # name: str
+    def read(self) -> str: ...
+
+class tzical:
+    def __init__(self, fileobj: str | _ICalReader) -> None: ...
+    def keys(self): ...
+    def get(self, tzid: Incomplete | None = None): ...
+
+TZFILES: list[str]
+TZPATHS: list[str]
+
+def datetime_exists(dt: datetime.datetime, tz: datetime.tzinfo | None = None) -> bool: ...
+def datetime_ambiguous(dt: datetime.datetime, tz: datetime.tzinfo | None = None) -> bool: ...
+def resolve_imaginary(dt: datetime.datetime) -> datetime.datetime: ...
+
+class _GetTZ:
+    def __call__(self, name: str | None = ...) -> datetime.tzinfo | None: ...
+    def nocache(self, name: str | None) -> datetime.tzinfo | None: ...
+
+gettz: _GetTZ
diff --git a/lib/dateutil-stubs/utils.pyi b/lib/dateutil-stubs/utils.pyi
new file mode 100644
index 00000000..8c9f5e44
--- /dev/null
+++ b/lib/dateutil-stubs/utils.pyi
@@ -0,0 +1,5 @@
+from datetime import datetime, timedelta, tzinfo
+
+def default_tzinfo(dt: datetime, tzinfo: tzinfo) -> datetime: ...
+def today(tzinfo: tzinfo | None = None) -> datetime: ...
+def within_delta(dt1: datetime, dt2: datetime, delta: timedelta) -> bool: ...
diff --git a/lib/dateutil-stubs/zoneinfo/__init__.pyi b/lib/dateutil-stubs/zoneinfo/__init__.pyi
new file mode 100644
index 00000000..7bd2845a
--- /dev/null
+++ b/lib/dateutil-stubs/zoneinfo/__init__.pyi
@@ -0,0 +1,17 @@
+from _typeshed import Incomplete
+from typing import IO
+from typing_extensions import TypeAlias
+
+__all__ = ["get_zonefile_instance", "gettz", "gettz_db_metadata"]
+
+_MetadataType: TypeAlias = dict[str, Incomplete]
+
+class ZoneInfoFile:
+    zones: dict[Incomplete, Incomplete]
+    metadata: _MetadataType | None
+    def __init__(self, zonefile_stream: IO[bytes] | None = None) -> None: ...
+    def get(self, name, default: Incomplete | None = None): ...
+
+def get_zonefile_instance(new_instance: bool = False) -> ZoneInfoFile: ...
+def gettz(name): ...
+def gettz_db_metadata() -> _MetadataType: ...
diff --git a/lib/dateutil-stubs/zoneinfo/rebuild.pyi b/lib/dateutil-stubs/zoneinfo/rebuild.pyi
new file mode 100644
index 00000000..e3845926
--- /dev/null
+++ b/lib/dateutil-stubs/zoneinfo/rebuild.pyi
@@ -0,0 +1,11 @@
+from _typeshed import Incomplete, StrOrBytesPath
+from collections.abc import Sequence
+from tarfile import TarInfo
+
+def rebuild(
+    filename: StrOrBytesPath,
+    tag: Incomplete | None = None,
+    format: str = "gz",
+    zonegroups: Sequence[str | TarInfo] = [],
+    metadata: Incomplete | None = None,
+) -> None: ...
diff --git a/lib/dateutil/__init__.py b/lib/dateutil/__init__.py
index 0defb82e..a2c19c06 100644
--- a/lib/dateutil/__init__.py
+++ b/lib/dateutil/__init__.py
@@ -1,4 +1,6 @@
 # -*- coding: utf-8 -*-
+import sys
+
 try:
     from ._version import version as __version__
 except ImportError:
@@ -6,3 +8,17 @@ except ImportError:
 
 __all__ = ['easter', 'parser', 'relativedelta', 'rrule', 'tz',
            'utils', 'zoneinfo']
+
+def __getattr__(name):
+    import importlib
+
+    if name in __all__:
+        return importlib.import_module("." + name, __name__)
+    raise AttributeError(
+        "module {!r} has not attribute {!r}".format(__name__, name)
+    )
+
+
+def __dir__():
+    # __dir__ should include all the lazy-importable modules as well.
+    return [x for x in globals() if x not in sys.modules] + __all__
diff --git a/lib/dateutil/_version.py b/lib/dateutil/_version.py
index b723056a..ddda9809 100644
--- a/lib/dateutil/_version.py
+++ b/lib/dateutil/_version.py
@@ -1,5 +1,4 @@
-# coding: utf-8
 # file generated by setuptools_scm
 # don't change, don't track in version control
-version = '2.8.2'
-version_tuple = (2, 8, 2)
+__version__ = version = '2.9.0.post0'
+__version_tuple__ = version_tuple = (2, 9, 0)
diff --git a/lib/dateutil/parser/isoparser.py b/lib/dateutil/parser/isoparser.py
index 5d7bee38..7060087d 100644
--- a/lib/dateutil/parser/isoparser.py
+++ b/lib/dateutil/parser/isoparser.py
@@ -72,7 +72,7 @@ class isoparser(object):
         Common:
 
         - ``YYYY``
-        - ``YYYY-MM`` or ``YYYYMM``
+        - ``YYYY-MM``
         - ``YYYY-MM-DD`` or ``YYYYMMDD``
 
         Uncommon:
diff --git a/lib/dateutil/relativedelta.py b/lib/dateutil/relativedelta.py
index a9e85f7e..cd323a54 100644
--- a/lib/dateutil/relativedelta.py
+++ b/lib/dateutil/relativedelta.py
@@ -48,7 +48,7 @@ class relativedelta(object):
             the corresponding arithmetic operation on the original datetime value
             with the information in the relativedelta.
 
-        weekday: 
+        weekday:
             One of the weekday instances (MO, TU, etc) available in the
             relativedelta module. These instances may receive a parameter N,
             specifying the Nth weekday, which could be positive or negative
diff --git a/lib/dateutil/rrule.py b/lib/dateutil/rrule.py
index b3203393..571a0d2b 100644
--- a/lib/dateutil/rrule.py
+++ b/lib/dateutil/rrule.py
@@ -182,7 +182,7 @@ class rrulebase(object):
     # __len__() introduces a large performance penalty.
     def count(self):
         """ Returns the number of recurrences in this set. It will have go
-            trough the whole recurrence, if this hasn't been done before. """
+            through the whole recurrence, if this hasn't been done before. """
         if self._len is None:
             for x in self:
                 pass
diff --git a/lib/dateutil/tz/tz.py b/lib/dateutil/tz/tz.py
index c67f56d4..61759144 100644
--- a/lib/dateutil/tz/tz.py
+++ b/lib/dateutil/tz/tz.py
@@ -34,7 +34,7 @@ except ImportError:
 from warnings import warn
 
 ZERO = datetime.timedelta(0)
-EPOCH = datetime.datetime.utcfromtimestamp(0)
+EPOCH = datetime.datetime(1970, 1, 1, 0, 0)
 EPOCHORDINAL = EPOCH.toordinal()
 
 
diff --git a/lib/dateutil/zoneinfo/dateutil-zoneinfo.tar.gz b/lib/dateutil/zoneinfo/dateutil-zoneinfo.tar.gz
index 524c48e12db7dfe159f282e4664f71ce249e1970..1461f8c862df8c3eae75e0ea376788b5b2602269 100644
GIT binary patch
literal 156400
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

literal 174394
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

diff --git a/requirements.txt b/requirements.txt
index 73b6e088..84451150 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,5 +1,5 @@
 apscheduler==3.10.1
-arrow==1.2.3
+arrow==1.3.0
 backports.csv==1.0.7
 backports.functools-lru-cache==1.6.6
 backports.zoneinfo==0.2.1;python_version<"3.9"

From e30779647593bc07ffa0ba5d74e09e29ebb8a822 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sun, 24 Mar 2024 15:21:17 -0700
Subject: [PATCH 529/743] Bump simplejson from 3.19.1 to 3.19.2 (#2176)

* Bump simplejson from 3.19.1 to 3.19.2

Bumps [simplejson](https://github.com/simplejson/simplejson) from 3.19.1 to 3.19.2.
- [Release notes](https://github.com/simplejson/simplejson/releases)
- [Changelog](https://github.com/simplejson/simplejson/blob/master/CHANGES.txt)
- [Commits](https://github.com/simplejson/simplejson/compare/v3.19.1...v3.19.2)

---
updated-dependencies:
- dependency-name: simplejson
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

* Update simplejson==3.19.2

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/simplejson/__init__.py | 2 +-
 requirements.txt           | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/lib/simplejson/__init__.py b/lib/simplejson/__init__.py
index 7e533a24..2d1900d8 100644
--- a/lib/simplejson/__init__.py
+++ b/lib/simplejson/__init__.py
@@ -118,7 +118,7 @@ Serializing multiple objects to JSON lines (newline-delimited JSON)::
 
 """
 from __future__ import absolute_import
-__version__ = '3.19.1'
+__version__ = '3.19.2'
 __all__ = [
     'dump', 'dumps', 'load', 'loads',
     'JSONDecoder', 'JSONDecodeError', 'JSONEncoder',
diff --git a/requirements.txt b/requirements.txt
index 84451150..7b0b98a8 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -39,7 +39,7 @@ pytz==2023.3
 requests==2.31.0
 requests-oauthlib==1.3.1
 rumps==0.4.0; platform_system == "Darwin"
-simplejson==3.19.1
+simplejson==3.19.2
 six==1.16.0
 tempora==5.5.0
 tokenize-rt==5.2.0

From dbffb519f53fbd5565a55566a54e29a280608669 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sun, 24 Mar 2024 15:21:33 -0700
Subject: [PATCH 530/743] Bump bleach from 6.0.0 to 6.1.0 (#2177)

* Bump bleach from 6.0.0 to 6.1.0

Bumps [bleach](https://github.com/mozilla/bleach) from 6.0.0 to 6.1.0.
- [Changelog](https://github.com/mozilla/bleach/blob/main/CHANGES)
- [Commits](https://github.com/mozilla/bleach/compare/v6.0.0...v6.1.0)

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

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

* Update bleach==6.1.0

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/bleach/__init__.py      |  4 ++--
 lib/bleach/html5lib_shim.py | 15 +++++++++++----
 lib/bleach/linkifier.py     |  6 +++---
 requirements.txt            |  2 +-
 4 files changed, 17 insertions(+), 10 deletions(-)

diff --git a/lib/bleach/__init__.py b/lib/bleach/__init__.py
index 4e87eb80..12e93b4d 100644
--- a/lib/bleach/__init__.py
+++ b/lib/bleach/__init__.py
@@ -11,9 +11,9 @@ from bleach.sanitizer import (
 
 
 # yyyymmdd
-__releasedate__ = "20230123"
+__releasedate__ = "20231006"
 # x.y.z or x.y.z.dev0 -- semver
-__version__ = "6.0.0"
+__version__ = "6.1.0"
 
 
 __all__ = ["clean", "linkify"]
diff --git a/lib/bleach/html5lib_shim.py b/lib/bleach/html5lib_shim.py
index aa5189b1..ca1cc8c8 100644
--- a/lib/bleach/html5lib_shim.py
+++ b/lib/bleach/html5lib_shim.py
@@ -395,10 +395,17 @@ class BleachHTMLTokenizer(HTMLTokenizer):
                 # followed by a series of characters. It's treated as a tag
                 # name that abruptly ends, but we should treat that like
                 # character data
-                yield {
-                    "type": TAG_TOKEN_TYPE_CHARACTERS,
-                    "data": "<" + self.currentToken["name"],
-                }
+                yield {"type": TAG_TOKEN_TYPE_CHARACTERS, "data": self.stream.get_tag()}
+            elif last_error_token["data"] in (
+                "eof-in-attribute-name",
+                "eof-in-attribute-value-no-quotes",
+            ):
+                # Handle the case where the text being parsed ends with <
+                # followed by a series of characters and then space and then
+                # more characters. It's treated as a tag name followed by an
+                # attribute that abruptly ends, but we should treat that like
+                # character data.
+                yield {"type": TAG_TOKEN_TYPE_CHARACTERS, "data": self.stream.get_tag()}
             else:
                 yield last_error_token
 
diff --git a/lib/bleach/linkifier.py b/lib/bleach/linkifier.py
index 679d7ead..8fcefb2c 100644
--- a/lib/bleach/linkifier.py
+++ b/lib/bleach/linkifier.py
@@ -45,8 +45,8 @@ def build_url_re(tlds=TLDS, protocols=html5lib_shim.allowed_protocols):
         r"""\(*  # Match any opening parentheses.
         \b(?<![@.])(?:(?:{0}):/{{0,3}}(?:(?:\w+:)?\w+@)?)?  # http://
         ([\w-]+\.)+(?:{1})(?:\:[0-9]+)?(?!\.\w)\b   # xx.yy.tld(:##)?
-        (?:[/?][^\s\{{\}}\|\\\^\[\]`<>"]*)?
-            # /path/zz (excluding "unsafe" chars from RFC 1738,
+        (?:[/?][^\s\{{\}}\|\\\^`<>"]*)?
+            # /path/zz (excluding "unsafe" chars from RFC 3986,
             # except for # and ~, which happen in practice)
         """.format(
             "|".join(sorted(protocols)), "|".join(sorted(tlds))
@@ -591,7 +591,7 @@ class LinkifyFilter(html5lib_shim.Filter):
                     in_a = False
                     token_buffer = []
                 else:
-                    token_buffer.append(token)
+                    token_buffer.extend(list(self.extract_entities(token)))
                 continue
 
             if token["type"] in ["StartTag", "EmptyTag"]:
diff --git a/requirements.txt b/requirements.txt
index 7b0b98a8..8c8e91f3 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -4,7 +4,7 @@ backports.csv==1.0.7
 backports.functools-lru-cache==1.6.6
 backports.zoneinfo==0.2.1;python_version<"3.9"
 beautifulsoup4==4.12.2
-bleach==6.0.0
+bleach==6.1.0
 certifi==2023.7.22
 cheroot==10.0.0
 cherrypy==18.8.0

From 24b6d37bbe02c37416c838b4d3e529fefe444811 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sun, 24 Mar 2024 15:21:51 -0700
Subject: [PATCH 531/743] Bump websocket-client from 1.6.2 to 1.7.0 (#2207)

* Bump websocket-client from 1.6.2 to 1.7.0

Bumps [websocket-client](https://github.com/websocket-client/websocket-client) from 1.6.2 to 1.7.0.
- [Release notes](https://github.com/websocket-client/websocket-client/releases)
- [Changelog](https://github.com/websocket-client/websocket-client/blob/master/ChangeLog)
- [Commits](https://github.com/websocket-client/websocket-client/compare/v1.6.2...v1.7.0)

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

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

* Update websocket-client==1.7.0

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/websocket/__init__.py             |   2 +-
 lib/websocket/_abnf.py                | 183 +++++++-----
 lib/websocket/_app.py                 | 283 ++++++++++++------
 lib/websocket/_cookiejar.py           |  37 ++-
 lib/websocket/_core.py                | 182 +++++++-----
 lib/websocket/_exceptions.py          |  16 +-
 lib/websocket/_handshake.py           | 109 +++----
 lib/websocket/_http.py                | 203 +++++++------
 lib/websocket/_logging.py             |  27 +-
 lib/websocket/_socket.py              |  34 ++-
 lib/websocket/_ssl_compat.py          |   5 +-
 lib/websocket/_url.py                 |  49 +++-
 lib/websocket/_utils.py               | 405 ++++++++++++++++++++++++--
 lib/websocket/_wsdump.py              |  87 +++---
 lib/websocket/py.typed                |   0
 lib/websocket/tests/echo-server.py    |   6 +-
 lib/websocket/tests/test_abnf.py      |  98 +++++--
 lib/websocket/tests/test_app.py       | 180 +++++++-----
 lib/websocket/tests/test_cookiejar.py |  13 +-
 lib/websocket/tests/test_http.py      | 281 +++++++++++++++---
 lib/websocket/tests/test_url.py       | 278 +++++++++++++-----
 lib/websocket/tests/test_websocket.py | 230 +++++++++------
 requirements.txt                      |   2 +-
 23 files changed, 1909 insertions(+), 801 deletions(-)
 create mode 100644 lib/websocket/py.typed

diff --git a/lib/websocket/__init__.py b/lib/websocket/__init__.py
index bfa71981..2ff75879 100644
--- a/lib/websocket/__init__.py
+++ b/lib/websocket/__init__.py
@@ -23,4 +23,4 @@ from ._exceptions import *
 from ._logging import *
 from ._socket import *
 
-__version__ = "1.6.2"
+__version__ = "1.7.0"
diff --git a/lib/websocket/_abnf.py b/lib/websocket/_abnf.py
index 6c2466ad..416ebc8f 100644
--- a/lib/websocket/_abnf.py
+++ b/lib/websocket/_abnf.py
@@ -2,10 +2,11 @@ import array
 import os
 import struct
 import sys
+from threading import Lock
+from typing import Callable, Optional, Union
 
 from ._exceptions import *
 from ._utils import validate_utf8
-from threading import Lock
 
 """
 _abnf.py
@@ -33,8 +34,9 @@ try:
     # Note that wsaccel is unmaintained.
     from wsaccel.xormask import XorMaskerSimple
 
-    def _mask(_m, _d) -> bytes:
-        return XorMaskerSimple(_m).process(_d)
+    def _mask(mask_value: array.array, data_value: array.array) -> bytes:
+        mask_result: bytes = XorMaskerSimple(mask_value).process(data_value)
+        return mask_result
 
 except ImportError:
     # wsaccel is not available, use websocket-client _mask()
@@ -42,26 +44,30 @@ except ImportError:
 
     def _mask(mask_value: array.array, data_value: array.array) -> bytes:
         datalen = len(data_value)
-        data_value = int.from_bytes(data_value, native_byteorder)
-        mask_value = int.from_bytes(mask_value * (datalen // 4) + mask_value[: datalen % 4], native_byteorder)
-        return (data_value ^ mask_value).to_bytes(datalen, native_byteorder)
+        int_data_value = int.from_bytes(data_value, native_byteorder)
+        int_mask_value = int.from_bytes(
+            mask_value * (datalen // 4) + mask_value[: datalen % 4], native_byteorder
+        )
+        return (int_data_value ^ int_mask_value).to_bytes(datalen, native_byteorder)
 
 
 __all__ = [
-    'ABNF', 'continuous_frame', 'frame_buffer',
-    'STATUS_NORMAL',
-    'STATUS_GOING_AWAY',
-    'STATUS_PROTOCOL_ERROR',
-    'STATUS_UNSUPPORTED_DATA_TYPE',
-    'STATUS_STATUS_NOT_AVAILABLE',
-    'STATUS_ABNORMAL_CLOSED',
-    'STATUS_INVALID_PAYLOAD',
-    'STATUS_POLICY_VIOLATION',
-    'STATUS_MESSAGE_TOO_BIG',
-    'STATUS_INVALID_EXTENSION',
-    'STATUS_UNEXPECTED_CONDITION',
-    'STATUS_BAD_GATEWAY',
-    'STATUS_TLS_HANDSHAKE_ERROR',
+    "ABNF",
+    "continuous_frame",
+    "frame_buffer",
+    "STATUS_NORMAL",
+    "STATUS_GOING_AWAY",
+    "STATUS_PROTOCOL_ERROR",
+    "STATUS_UNSUPPORTED_DATA_TYPE",
+    "STATUS_STATUS_NOT_AVAILABLE",
+    "STATUS_ABNORMAL_CLOSED",
+    "STATUS_INVALID_PAYLOAD",
+    "STATUS_POLICY_VIOLATION",
+    "STATUS_MESSAGE_TOO_BIG",
+    "STATUS_INVALID_EXTENSION",
+    "STATUS_UNEXPECTED_CONDITION",
+    "STATUS_BAD_GATEWAY",
+    "STATUS_TLS_HANDSHAKE_ERROR",
 ]
 
 # closing frame status codes.
@@ -110,11 +116,17 @@ class ABNF:
     OPCODE_BINARY = 0x2
     OPCODE_CLOSE = 0x8
     OPCODE_PING = 0x9
-    OPCODE_PONG = 0xa
+    OPCODE_PONG = 0xA
 
     # available operation code value tuple
-    OPCODES = (OPCODE_CONT, OPCODE_TEXT, OPCODE_BINARY, OPCODE_CLOSE,
-               OPCODE_PING, OPCODE_PONG)
+    OPCODES = (
+        OPCODE_CONT,
+        OPCODE_TEXT,
+        OPCODE_BINARY,
+        OPCODE_CLOSE,
+        OPCODE_PING,
+        OPCODE_PONG,
+    )
 
     # opcode human readable string
     OPCODE_MAP = {
@@ -123,16 +135,24 @@ class ABNF:
         OPCODE_BINARY: "binary",
         OPCODE_CLOSE: "close",
         OPCODE_PING: "ping",
-        OPCODE_PONG: "pong"
+        OPCODE_PONG: "pong",
     }
 
     # data length threshold.
-    LENGTH_7 = 0x7e
+    LENGTH_7 = 0x7E
     LENGTH_16 = 1 << 16
     LENGTH_63 = 1 << 63
 
-    def __init__(self, fin: int = 0, rsv1: int = 0, rsv2: int = 0, rsv3: int = 0,
-                 opcode: int = OPCODE_TEXT, mask: int = 1, data: str or bytes = "") -> None:
+    def __init__(
+        self,
+        fin: int = 0,
+        rsv1: int = 0,
+        rsv2: int = 0,
+        rsv3: int = 0,
+        opcode: int = OPCODE_TEXT,
+        mask_value: int = 1,
+        data: Union[str, bytes, None] = "",
+    ) -> None:
         """
         Constructor for ABNF. Please check RFC for arguments.
         """
@@ -141,7 +161,7 @@ class ABNF:
         self.rsv2 = rsv2
         self.rsv3 = rsv3
         self.opcode = opcode
-        self.mask = mask
+        self.mask_value = mask_value
         if data is None:
             data = ""
         self.data = data
@@ -173,7 +193,7 @@ class ABNF:
             if l > 2 and not skip_utf8_validation and not validate_utf8(self.data[2:]):
                 raise WebSocketProtocolException("Invalid close frame.")
 
-            code = 256 * self.data[0] + self.data[1]
+            code = 256 * int(self.data[0]) + int(self.data[1])
             if not self._is_valid_close_status(code):
                 raise WebSocketProtocolException("Invalid close opcode %r", code)
 
@@ -182,12 +202,10 @@ class ABNF:
         return code in VALID_CLOSE_STATUS or (3000 <= code < 5000)
 
     def __str__(self) -> str:
-        return "fin=" + str(self.fin) \
-            + " opcode=" + str(self.opcode) \
-            + " data=" + str(self.data)
+        return f"fin={self.fin} opcode={self.opcode} data={self.data}"
 
     @staticmethod
-    def create_frame(data: str, opcode: int, fin: int = 1) -> 'ABNF':
+    def create_frame(data: Union[bytes, str], opcode: int, fin: int = 1) -> "ABNF":
         """
         Create frame to send text, binary and other data.
 
@@ -219,34 +237,39 @@ class ABNF:
         if length >= ABNF.LENGTH_63:
             raise ValueError("data is too long")
 
-        frame_header = chr(self.fin << 7 |
-                           self.rsv1 << 6 | self.rsv2 << 5 | self.rsv3 << 4 |
-                           self.opcode).encode('latin-1')
+        frame_header = chr(
+            self.fin << 7
+            | self.rsv1 << 6
+            | self.rsv2 << 5
+            | self.rsv3 << 4
+            | self.opcode
+        ).encode("latin-1")
         if length < ABNF.LENGTH_7:
-            frame_header += chr(self.mask << 7 | length).encode('latin-1')
+            frame_header += chr(self.mask_value << 7 | length).encode("latin-1")
         elif length < ABNF.LENGTH_16:
-            frame_header += chr(self.mask << 7 | 0x7e).encode('latin-1')
+            frame_header += chr(self.mask_value << 7 | 0x7E).encode("latin-1")
             frame_header += struct.pack("!H", length)
         else:
-            frame_header += chr(self.mask << 7 | 0x7f).encode('latin-1')
+            frame_header += chr(self.mask_value << 7 | 0x7F).encode("latin-1")
             frame_header += struct.pack("!Q", length)
 
-        if not self.mask:
+        if not self.mask_value:
+            if isinstance(self.data, str):
+                self.data = self.data.encode("utf-8")
             return frame_header + self.data
-        else:
-            mask_key = self.get_mask_key(4)
-            return frame_header + self._get_masked(mask_key)
+        mask_key = self.get_mask_key(4)
+        return frame_header + self._get_masked(mask_key)
 
-    def _get_masked(self, mask_key: str or bytes) -> bytes:
+    def _get_masked(self, mask_key: Union[str, bytes]) -> bytes:
         s = ABNF.mask(mask_key, self.data)
 
         if isinstance(mask_key, str):
-            mask_key = mask_key.encode('utf-8')
+            mask_key = mask_key.encode("utf-8")
 
         return mask_key + s
 
     @staticmethod
-    def mask(mask_key: str or bytes, data: str or bytes) -> bytes:
+    def mask(mask_key: Union[str, bytes], data: Union[str, bytes]) -> bytes:
         """
         Mask or unmask data. Just do xor for each byte
 
@@ -261,10 +284,10 @@ class ABNF:
             data = ""
 
         if isinstance(mask_key, str):
-            mask_key = mask_key.encode('latin-1')
+            mask_key = mask_key.encode("latin-1")
 
         if isinstance(data, str):
-            data = data.encode('latin-1')
+            data = data.encode("latin-1")
 
         return _mask(array.array("B", mask_key), array.array("B", data))
 
@@ -273,19 +296,21 @@ class frame_buffer:
     _HEADER_MASK_INDEX = 5
     _HEADER_LENGTH_INDEX = 6
 
-    def __init__(self, recv_fn: int, skip_utf8_validation: bool) -> None:
+    def __init__(
+        self, recv_fn: Callable[[int], int], skip_utf8_validation: bool
+    ) -> None:
         self.recv = recv_fn
         self.skip_utf8_validation = skip_utf8_validation
         # Buffers over the packets from the layer beneath until desired amount
         # bytes of bytes are received.
-        self.recv_buffer = []
+        self.recv_buffer: list = []
         self.clear()
         self.lock = Lock()
 
     def clear(self) -> None:
-        self.header = None
-        self.length = None
-        self.mask = None
+        self.header: Optional[tuple] = None
+        self.length: Optional[int] = None
+        self.mask_value: Union[bytes, str, None] = None
 
     def has_received_header(self) -> bool:
         return self.header is None
@@ -297,41 +322,41 @@ class frame_buffer:
         rsv1 = b1 >> 6 & 1
         rsv2 = b1 >> 5 & 1
         rsv3 = b1 >> 4 & 1
-        opcode = b1 & 0xf
+        opcode = b1 & 0xF
         b2 = header[1]
         has_mask = b2 >> 7 & 1
-        length_bits = b2 & 0x7f
+        length_bits = b2 & 0x7F
 
         self.header = (fin, rsv1, rsv2, rsv3, opcode, has_mask, length_bits)
 
-    def has_mask(self) -> bool or int:
+    def has_mask(self) -> Union[bool, int]:
         if not self.header:
             return False
-        return self.header[frame_buffer._HEADER_MASK_INDEX]
+        header_val: int = self.header[frame_buffer._HEADER_MASK_INDEX]
+        return header_val
 
     def has_received_length(self) -> bool:
         return self.length is None
 
     def recv_length(self) -> None:
         bits = self.header[frame_buffer._HEADER_LENGTH_INDEX]
-        length_bits = bits & 0x7f
-        if length_bits == 0x7e:
+        length_bits = bits & 0x7F
+        if length_bits == 0x7E:
             v = self.recv_strict(2)
             self.length = struct.unpack("!H", v)[0]
-        elif length_bits == 0x7f:
+        elif length_bits == 0x7F:
             v = self.recv_strict(8)
             self.length = struct.unpack("!Q", v)[0]
         else:
             self.length = length_bits
 
     def has_received_mask(self) -> bool:
-        return self.mask is None
+        return self.mask_value is None
 
     def recv_mask(self) -> None:
-        self.mask = self.recv_strict(4) if self.has_mask() else ""
+        self.mask_value = self.recv_strict(4) if self.has_mask() else ""
 
     def recv_frame(self) -> ABNF:
-
         with self.lock:
             # Header
             if self.has_received_header():
@@ -346,12 +371,12 @@ class frame_buffer:
             # Mask
             if self.has_received_mask():
                 self.recv_mask()
-            mask = self.mask
+            mask_value = self.mask_value
 
             # Payload
             payload = self.recv_strict(length)
             if has_mask:
-                payload = ABNF.mask(mask, payload)
+                payload = ABNF.mask(mask_value, payload)
 
             # Reset for next frame
             self.clear()
@@ -385,18 +410,19 @@ class frame_buffer:
 
 
 class continuous_frame:
-
     def __init__(self, fire_cont_frame: bool, skip_utf8_validation: bool) -> None:
         self.fire_cont_frame = fire_cont_frame
         self.skip_utf8_validation = skip_utf8_validation
-        self.cont_data = None
-        self.recving_frames = None
+        self.cont_data: Optional[list] = None
+        self.recving_frames: Optional[int] = None
 
     def validate(self, frame: ABNF) -> None:
         if not self.recving_frames and frame.opcode == ABNF.OPCODE_CONT:
             raise WebSocketProtocolException("Illegal frame")
-        if self.recving_frames and \
-                frame.opcode in (ABNF.OPCODE_TEXT, ABNF.OPCODE_BINARY):
+        if self.recving_frames and frame.opcode in (
+            ABNF.OPCODE_TEXT,
+            ABNF.OPCODE_BINARY,
+        ):
             raise WebSocketProtocolException("Illegal frame")
 
     def add(self, frame: ABNF) -> None:
@@ -410,15 +436,18 @@ class continuous_frame:
         if frame.fin:
             self.recving_frames = None
 
-    def is_fire(self, frame: ABNF) -> bool or int:
+    def is_fire(self, frame: ABNF) -> Union[bool, int]:
         return frame.fin or self.fire_cont_frame
 
-    def extract(self, frame: ABNF) -> list:
+    def extract(self, frame: ABNF) -> tuple:
         data = self.cont_data
         self.cont_data = None
         frame.data = data[1]
-        if not self.fire_cont_frame and data[0] == ABNF.OPCODE_TEXT and not self.skip_utf8_validation and not validate_utf8(frame.data):
-            raise WebSocketPayloadException(
-                "cannot decode: " + repr(frame.data))
-
-        return [data[0], frame]
+        if (
+            not self.fire_cont_frame
+            and data[0] == ABNF.OPCODE_TEXT
+            and not self.skip_utf8_validation
+            and not validate_utf8(frame.data)
+        ):
+            raise WebSocketPayloadException(f"cannot decode: {repr(frame.data)}")
+        return data[0], frame
diff --git a/lib/websocket/_app.py b/lib/websocket/_app.py
index 2577f1ba..4d8af3b5 100644
--- a/lib/websocket/_app.py
+++ b/lib/websocket/_app.py
@@ -1,18 +1,19 @@
 import inspect
 import selectors
-import sys
+import socket
 import threading
 import time
-import traceback
-import socket
-
-from typing import Callable, Any
+from typing import Any, Callable, Optional, Union
 
 from . import _logging
 from ._abnf import ABNF
-from ._url import parse_url
 from ._core import WebSocket, getdefaulttimeout
-from ._exceptions import *
+from ._exceptions import (
+    WebSocketConnectionClosedException,
+    WebSocketException,
+    WebSocketTimeoutException,
+)
+from ._url import parse_url
 
 """
 _app.py
@@ -47,22 +48,24 @@ class DispatcherBase:
     """
     DispatcherBase
     """
-    def __init__(self, app: Any, ping_timeout: float) -> None:
+
+    def __init__(self, app: Any, ping_timeout: Union[float, int, None]) -> None:
         self.app = app
         self.ping_timeout = ping_timeout
 
-    def timeout(self, seconds: int, callback: Callable) -> None:
+    def timeout(self, seconds: Union[float, int, None], callback: Callable) -> None:
         time.sleep(seconds)
         callback()
 
     def reconnect(self, seconds: int, reconnector: Callable) -> None:
         try:
-            _logging.info("reconnect() - retrying in {seconds_count} seconds [{frame_count} frames in stack]".format(
-                seconds_count=seconds, frame_count=len(inspect.stack())))
+            _logging.info(
+                f"reconnect() - retrying in {seconds} seconds [{len(inspect.stack())} frames in stack]"
+            )
             time.sleep(seconds)
             reconnector(reconnecting=True)
         except KeyboardInterrupt as e:
-            _logging.info("User exited {err}".format(err=e))
+            _logging.info(f"User exited {e}")
             raise e
 
 
@@ -70,13 +73,18 @@ class Dispatcher(DispatcherBase):
     """
     Dispatcher
     """
-    def read(self, sock: socket.socket, read_callback: Callable, check_callback: Callable) -> None:
+
+    def read(
+        self,
+        sock: socket.socket,
+        read_callback: Callable,
+        check_callback: Callable,
+    ) -> None:
         sel = selectors.DefaultSelector()
         sel.register(self.app.sock.sock, selectors.EVENT_READ)
         try:
             while self.app.keep_running:
-                r = sel.select(self.ping_timeout)
-                if r:
+                if sel.select(self.ping_timeout):
                     if not read_callback():
                         break
                 check_callback()
@@ -88,24 +96,31 @@ class SSLDispatcher(DispatcherBase):
     """
     SSLDispatcher
     """
-    def read(self, sock: socket.socket, read_callback: Callable, check_callback: Callable) -> None:
+
+    def read(
+        self,
+        sock: socket.socket,
+        read_callback: Callable,
+        check_callback: Callable,
+    ) -> None:
         sock = self.app.sock.sock
         sel = selectors.DefaultSelector()
         sel.register(sock, selectors.EVENT_READ)
         try:
             while self.app.keep_running:
-                r = self.select(sock, sel)
-                if r:
+                if self.select(sock, sel):
                     if not read_callback():
                         break
                 check_callback()
         finally:
             sel.close()
 
-    def select(self, sock, sel:selectors.DefaultSelector):
+    def select(self, sock, sel: selectors.DefaultSelector):
         sock = self.app.sock.sock
         if sock.pending():
-            return [sock,]
+            return [
+                sock,
+            ]
 
         r = sel.select(self.ping_timeout)
 
@@ -117,17 +132,23 @@ class WrappedDispatcher:
     """
     WrappedDispatcher
     """
-    def __init__(self, app, ping_timeout: float, dispatcher: Dispatcher) -> None:
+
+    def __init__(self, app, ping_timeout: Union[float, int, None], dispatcher) -> None:
         self.app = app
         self.ping_timeout = ping_timeout
         self.dispatcher = dispatcher
         dispatcher.signal(2, dispatcher.abort)  # keyboard interrupt
 
-    def read(self, sock: socket.socket, read_callback: Callable, check_callback: Callable) -> None:
+    def read(
+        self,
+        sock: socket.socket,
+        read_callback: Callable,
+        check_callback: Callable,
+    ) -> None:
         self.dispatcher.read(sock, read_callback)
         self.ping_timeout and self.timeout(self.ping_timeout, check_callback)
 
-    def timeout(self, seconds: int, callback: Callable) -> None:
+    def timeout(self, seconds: float, callback: Callable) -> None:
         self.dispatcher.timeout(seconds, callback)
 
     def reconnect(self, seconds: int, reconnector: Callable) -> None:
@@ -139,14 +160,24 @@ class WebSocketApp:
     Higher level of APIs are provided. The interface is like JavaScript WebSocket object.
     """
 
-    def __init__(self, url: str, header: list or dict or Callable = None,
-                 on_open: Callable = None, on_message: Callable = None, on_error: Callable = None,
-                 on_close: Callable = None, on_ping: Callable = None, on_pong: Callable = None,
-                 on_cont_message: Callable = None,
-                 keep_running: bool = True, get_mask_key: Callable = None, cookie: str = None,
-                 subprotocols: list = None,
-                 on_data: Callable = None,
-                 socket: socket.socket = None) -> None:
+    def __init__(
+        self,
+        url: str,
+        header: Union[list, dict, Callable, None] = None,
+        on_open: Optional[Callable[[WebSocket], None]] = None,
+        on_message: Optional[Callable[[WebSocket, Any], None]] = None,
+        on_error: Optional[Callable[[WebSocket, Any], None]] = None,
+        on_close: Optional[Callable[[WebSocket, Any, Any], None]] = None,
+        on_ping: Optional[Callable] = None,
+        on_pong: Optional[Callable] = None,
+        on_cont_message: Optional[Callable] = None,
+        keep_running: bool = True,
+        get_mask_key: Optional[Callable] = None,
+        cookie: Optional[str] = None,
+        subprotocols: Optional[list] = None,
+        on_data: Optional[Callable] = None,
+        socket: Optional[socket.socket] = None,
+    ) -> None:
         """
         WebSocketApp initialization
 
@@ -222,13 +253,13 @@ class WebSocketApp:
         self.on_cont_message = on_cont_message
         self.keep_running = False
         self.get_mask_key = get_mask_key
-        self.sock = None
-        self.last_ping_tm = 0
-        self.last_pong_tm = 0
-        self.ping_thread = None
-        self.stop_ping = None
-        self.ping_interval = 0
-        self.ping_timeout = None
+        self.sock: Optional[WebSocket] = None
+        self.last_ping_tm = float(0)
+        self.last_pong_tm = float(0)
+        self.ping_thread: Optional[threading.Thread] = None
+        self.stop_ping: Optional[threading.Event] = None
+        self.ping_interval = float(0)
+        self.ping_timeout: Union[float, int, None] = None
         self.ping_payload = ""
         self.subprotocols = subprotocols
         self.prepared_socket = socket
@@ -236,7 +267,7 @@ class WebSocketApp:
         self.has_done_teardown = False
         self.has_done_teardown_lock = threading.Lock()
 
-    def send(self, data: str, opcode: int = ABNF.OPCODE_TEXT) -> None:
+    def send(self, data: Union[bytes, str], opcode: int = ABNF.OPCODE_TEXT) -> None:
         """
         send message
 
@@ -250,8 +281,21 @@ class WebSocketApp:
         """
 
         if not self.sock or self.sock.send(data, opcode) == 0:
-            raise WebSocketConnectionClosedException(
-                "Connection is already closed.")
+            raise WebSocketConnectionClosedException("Connection is already closed.")
+
+    def send_text(self, text_data: str) -> None:
+        """
+        Sends UTF-8 encoded text.
+        """
+        if not self.sock or self.sock.send(text_data, ABNF.OPCODE_TEXT) == 0:
+            raise WebSocketConnectionClosedException("Connection is already closed.")
+
+    def send_bytes(self, data: Union[bytes, bytearray]) -> None:
+        """
+        Sends a sequence of bytes.
+        """
+        if not self.sock or self.sock.send(data, ABNF.OPCODE_BINARY) == 0:
+            raise WebSocketConnectionClosedException("Connection is already closed.")
 
     def close(self, **kwargs) -> None:
         """
@@ -263,7 +307,7 @@ class WebSocketApp:
             self.sock = None
 
     def _start_ping_thread(self) -> None:
-        self.last_ping_tm = self.last_pong_tm = 0
+        self.last_ping_tm = self.last_pong_tm = float(0)
         self.stop_ping = threading.Event()
         self.ping_thread = threading.Thread(target=self._send_ping)
         self.ping_thread.daemon = True
@@ -274,7 +318,7 @@ class WebSocketApp:
             self.stop_ping.set()
         if self.ping_thread and self.ping_thread.is_alive():
             self.ping_thread.join(3)
-        self.last_ping_tm = self.last_pong_tm = 0
+        self.last_ping_tm = self.last_pong_tm = float(0)
 
     def _send_ping(self) -> None:
         if self.stop_ping.wait(self.ping_interval) or self.keep_running is False:
@@ -286,17 +330,28 @@ class WebSocketApp:
                     _logging.debug("Sending ping")
                     self.sock.ping(self.ping_payload)
                 except Exception as e:
-                    _logging.debug("Failed to send ping: {err}".format(err=e))
+                    _logging.debug(f"Failed to send ping: {e}")
 
-    def run_forever(self, sockopt: tuple = None, sslopt: dict = None,
-                    ping_interval: float = 0, ping_timeout: float or None = None,
-                    ping_payload: str = "",
-                    http_proxy_host: str = None, http_proxy_port: int or str = None,
-                    http_no_proxy: list = None, http_proxy_auth: tuple = None,
-                    http_proxy_timeout: float = None,
-                    skip_utf8_validation: bool = False,
-                    host: str = None, origin: str = None, dispatcher: Dispatcher = None,
-                    suppress_origin: bool = False, proxy_type: str = None, reconnect: int = None) -> bool:
+    def run_forever(
+        self,
+        sockopt: tuple = None,
+        sslopt: dict = None,
+        ping_interval: Union[float, int] = 0,
+        ping_timeout: Union[float, int, None] = None,
+        ping_payload: str = "",
+        http_proxy_host: str = None,
+        http_proxy_port: Union[int, str] = None,
+        http_no_proxy: list = None,
+        http_proxy_auth: tuple = None,
+        http_proxy_timeout: Optional[float] = None,
+        skip_utf8_validation: bool = False,
+        host: str = None,
+        origin: str = None,
+        dispatcher=None,
+        suppress_origin: bool = False,
+        proxy_type: str = None,
+        reconnect: int = None,
+    ) -> bool:
         """
         Run event loop for WebSocket framework.
 
@@ -360,7 +415,7 @@ class WebSocketApp:
         if ping_timeout and ping_interval and ping_interval <= ping_timeout:
             raise WebSocketException("Ensure ping_interval > ping_timeout")
         if not sockopt:
-            sockopt = []
+            sockopt = ()
         if not sslopt:
             sslopt = {}
         if self.sock:
@@ -394,7 +449,8 @@ class WebSocketApp:
             if self.sock:
                 self.sock.close()
             close_status_code, close_reason = self._get_close_args(
-                close_frame if close_frame else None)
+                close_frame if close_frame else None
+            )
             self.sock = None
 
             # Finally call the callback AFTER all teardown is complete
@@ -405,24 +461,34 @@ class WebSocketApp:
                 self.sock.shutdown()
 
             self.sock = WebSocket(
-                self.get_mask_key, sockopt=sockopt, sslopt=sslopt,
+                self.get_mask_key,
+                sockopt=sockopt,
+                sslopt=sslopt,
                 fire_cont_frame=self.on_cont_message is not None,
                 skip_utf8_validation=skip_utf8_validation,
-                enable_multithread=True)
+                enable_multithread=True,
+            )
 
             self.sock.settimeout(getdefaulttimeout())
             try:
-
                 header = self.header() if callable(self.header) else self.header
 
                 self.sock.connect(
-                    self.url, header=header, cookie=self.cookie,
+                    self.url,
+                    header=header,
+                    cookie=self.cookie,
                     http_proxy_host=http_proxy_host,
-                    http_proxy_port=http_proxy_port, http_no_proxy=http_no_proxy,
-                    http_proxy_auth=http_proxy_auth, http_proxy_timeout=http_proxy_timeout,
+                    http_proxy_port=http_proxy_port,
+                    http_no_proxy=http_no_proxy,
+                    http_proxy_auth=http_proxy_auth,
+                    http_proxy_timeout=http_proxy_timeout,
                     subprotocols=self.subprotocols,
-                    host=host, origin=origin, suppress_origin=suppress_origin,
-                    proxy_type=proxy_type, socket=self.prepared_socket)
+                    host=host,
+                    origin=origin,
+                    suppress_origin=suppress_origin,
+                    proxy_type=proxy_type,
+                    socket=self.prepared_socket,
+                )
 
                 _logging.info("Websocket connected")
 
@@ -432,7 +498,13 @@ class WebSocketApp:
                 self._callback(self.on_open)
 
                 dispatcher.read(self.sock.sock, read, check)
-            except (WebSocketConnectionClosedException, ConnectionRefusedError, KeyboardInterrupt, SystemExit, Exception) as e:
+            except (
+                WebSocketConnectionClosedException,
+                ConnectionRefusedError,
+                KeyboardInterrupt,
+                SystemExit,
+                Exception,
+            ) as e:
                 handleDisconnect(e, reconnecting)
 
         def read() -> bool:
@@ -441,7 +513,10 @@ class WebSocketApp:
 
             try:
                 op_code, frame = self.sock.recv_data_frame(True)
-            except (WebSocketConnectionClosedException, KeyboardInterrupt) as e:
+            except (
+                WebSocketConnectionClosedException,
+                KeyboardInterrupt,
+            ) as e:
                 if custom_dispatcher:
                     return handleDisconnect(e)
                 else:
@@ -455,10 +530,8 @@ class WebSocketApp:
                 self.last_pong_tm = time.time()
                 self._callback(self.on_pong, frame.data)
             elif op_code == ABNF.OPCODE_CONT and self.on_cont_message:
-                self._callback(self.on_data, frame.data,
-                               frame.opcode, frame.fin)
-                self._callback(self.on_cont_message,
-                               frame.data, frame.fin)
+                self._callback(self.on_data, frame.data, frame.opcode, frame.fin)
+                self._callback(self.on_cont_message, frame.data, frame.fin)
             else:
                 data = frame.data
                 if op_code == ABNF.OPCODE_TEXT and not skip_utf8_validation:
@@ -469,18 +542,38 @@ class WebSocketApp:
             return True
 
         def check() -> bool:
-            if (self.ping_timeout):
-                has_timeout_expired = time.time() - self.last_ping_tm > self.ping_timeout
-                has_pong_not_arrived_after_last_ping = self.last_pong_tm - self.last_ping_tm < 0
-                has_pong_arrived_too_late = self.last_pong_tm - self.last_ping_tm > self.ping_timeout
+            if self.ping_timeout:
+                has_timeout_expired = (
+                    time.time() - self.last_ping_tm > self.ping_timeout
+                )
+                has_pong_not_arrived_after_last_ping = (
+                    self.last_pong_tm - self.last_ping_tm < 0
+                )
+                has_pong_arrived_too_late = (
+                    self.last_pong_tm - self.last_ping_tm > self.ping_timeout
+                )
 
-                if (self.last_ping_tm and
-                        has_timeout_expired and
-                        (has_pong_not_arrived_after_last_ping or has_pong_arrived_too_late)):
+                if (
+                    self.last_ping_tm
+                    and has_timeout_expired
+                    and (
+                        has_pong_not_arrived_after_last_ping
+                        or has_pong_arrived_too_late
+                    )
+                ):
                     raise WebSocketTimeoutException("ping/pong timed out")
             return True
 
-        def handleDisconnect(e: Exception, reconnecting: bool = False) -> bool:
+        def handleDisconnect(
+            e: Union[
+                WebSocketConnectionClosedException,
+                ConnectionRefusedError,
+                KeyboardInterrupt,
+                SystemExit,
+                Exception,
+            ],
+            reconnecting: bool = False,
+        ) -> bool:
             self.has_errored = True
             self._stop_ping_thread()
             if not reconnecting:
@@ -492,25 +585,31 @@ class WebSocketApp:
                 raise
 
             if reconnect:
-                _logging.info("{err} - reconnect".format(err=e))
+                _logging.info(f"{e} - reconnect")
                 if custom_dispatcher:
-                    _logging.debug("Calling custom dispatcher reconnect [{frame_count} frames in stack]".format(frame_count=len(inspect.stack())))
+                    _logging.debug(
+                        f"Calling custom dispatcher reconnect [{len(inspect.stack())} frames in stack]"
+                    )
                     dispatcher.reconnect(reconnect, setSock)
             else:
-                _logging.error("{err} - goodbye".format(err=e))
+                _logging.error(f"{e} - goodbye")
                 teardown()
 
         custom_dispatcher = bool(dispatcher)
-        dispatcher = self.create_dispatcher(ping_timeout, dispatcher, parse_url(self.url)[3])
+        dispatcher = self.create_dispatcher(
+            ping_timeout, dispatcher, parse_url(self.url)[3]
+        )
 
         try:
             setSock()
             if not custom_dispatcher and reconnect:
                 while self.keep_running:
-                    _logging.debug("Calling dispatcher reconnect [{frame_count} frames in stack]".format(frame_count=len(inspect.stack())))
+                    _logging.debug(
+                        f"Calling dispatcher reconnect [{len(inspect.stack())} frames in stack]"
+                    )
                     dispatcher.reconnect(reconnect, setSock)
         except (KeyboardInterrupt, Exception) as e:
-            _logging.info("tearing down on exception {err}".format(err=e))
+            _logging.info(f"tearing down on exception {e}")
             teardown()
         finally:
             if not custom_dispatcher:
@@ -519,13 +618,17 @@ class WebSocketApp:
 
         return self.has_errored
 
-    def create_dispatcher(self, ping_timeout: int, dispatcher: Dispatcher = None, is_ssl: bool = False) -> DispatcherBase:
+    def create_dispatcher(
+        self,
+        ping_timeout: Union[float, int, None],
+        dispatcher: Optional[DispatcherBase] = None,
+        is_ssl: bool = False,
+    ) -> Union[Dispatcher, SSLDispatcher, WrappedDispatcher]:
         if dispatcher:  # If custom dispatcher is set, use WrappedDispatcher
             return WrappedDispatcher(self, ping_timeout, dispatcher)
         timeout = ping_timeout or 10
         if is_ssl:
             return SSLDispatcher(self, timeout)
-
         return Dispatcher(self, timeout)
 
     def _get_close_args(self, close_frame: ABNF) -> list:
@@ -540,8 +643,12 @@ class WebSocketApp:
 
         # Extract close frame status code
         if close_frame.data and len(close_frame.data) >= 2:
-            close_status_code = 256 * close_frame.data[0] + close_frame.data[1]
-            reason = close_frame.data[2:].decode('utf-8')
+            close_status_code = 256 * int(close_frame.data[0]) + int(
+                close_frame.data[1]
+            )
+            reason = close_frame.data[2:]
+            if isinstance(reason, bytes):
+                reason = reason.decode("utf-8")
             return [close_status_code, reason]
         else:
             # Most likely reached this because len(close_frame_data.data) < 2
@@ -553,6 +660,6 @@ class WebSocketApp:
                 callback(self, *args)
 
             except Exception as e:
-                _logging.error("error from callback {callback}: {err}".format(callback=callback, err=e))
+                _logging.error(f"error from callback {callback}: {e}")
                 if self.on_error:
                     self.on_error(self, e)
diff --git a/lib/websocket/_cookiejar.py b/lib/websocket/_cookiejar.py
index 2047eddd..61079402 100644
--- a/lib/websocket/_cookiejar.py
+++ b/lib/websocket/_cookiejar.py
@@ -1,4 +1,5 @@
 import http.cookies
+from typing import Optional
 
 """
 _cookiejar.py
@@ -22,18 +23,21 @@ limitations under the License.
 
 class SimpleCookieJar:
     def __init__(self) -> None:
-        self.jar = dict()
+        self.jar: dict = dict()
 
-    def add(self, set_cookie: str) -> None:
+    def add(self, set_cookie: Optional[str]) -> None:
         if set_cookie:
             simpleCookie = http.cookies.SimpleCookie(set_cookie)
 
             for k, v in simpleCookie.items():
-                domain = v.get("domain")
-                if domain:
+                if domain := v.get("domain"):
                     if not domain.startswith("."):
-                        domain = "." + domain
-                    cookie = self.jar.get(domain) if self.jar.get(domain) else http.cookies.SimpleCookie()
+                        domain = f".{domain}"
+                    cookie = (
+                        self.jar.get(domain)
+                        if self.jar.get(domain)
+                        else http.cookies.SimpleCookie()
+                    )
                     cookie.update(simpleCookie)
                     self.jar[domain.lower()] = cookie
 
@@ -42,10 +46,9 @@ class SimpleCookieJar:
             simpleCookie = http.cookies.SimpleCookie(set_cookie)
 
             for k, v in simpleCookie.items():
-                domain = v.get("domain")
-                if domain:
+                if domain := v.get("domain"):
                     if not domain.startswith("."):
-                        domain = "." + domain
+                        domain = f".{domain}"
                     self.jar[domain.lower()] = simpleCookie
 
     def get(self, host: str) -> str:
@@ -58,7 +61,15 @@ class SimpleCookieJar:
             if host.endswith(domain) or host == domain[1:]:
                 cookies.append(self.jar.get(domain))
 
-        return "; ".join(filter(
-            None, sorted(
-                ["%s=%s" % (k, v.value) for cookie in filter(None, cookies) for k, v in cookie.items()]
-            )))
+        return "; ".join(
+            filter(
+                None,
+                sorted(
+                    [
+                        "%s=%s" % (k, v.value)
+                        for cookie in filter(None, cookies)
+                        for k, v in cookie.items()
+                    ]
+                ),
+            )
+        )
diff --git a/lib/websocket/_core.py b/lib/websocket/_core.py
index e81066ad..f28ca4b9 100644
--- a/lib/websocket/_core.py
+++ b/lib/websocket/_core.py
@@ -2,6 +2,7 @@ import socket
 import struct
 import threading
 import time
+from typing import Optional, Union
 
 # websocket modules
 from ._abnf import *
@@ -32,7 +33,7 @@ See the License for the specific language governing permissions and
 limitations under the License.
 """
 
-__all__ = ['WebSocket', 'create_connection']
+__all__ = ["WebSocket", "create_connection"]
 
 
 class WebSocket:
@@ -73,9 +74,16 @@ class WebSocket:
         Skip utf8 validation.
     """
 
-    def __init__(self, get_mask_key=None, sockopt=None, sslopt=None,
-                 fire_cont_frame: bool = False, enable_multithread: bool = True,
-                 skip_utf8_validation: bool = False, **_):
+    def __init__(
+        self,
+        get_mask_key=None,
+        sockopt=None,
+        sslopt=None,
+        fire_cont_frame: bool = False,
+        enable_multithread: bool = True,
+        skip_utf8_validation: bool = False,
+        **_,
+    ):
         """
         Initialize WebSocket object.
 
@@ -86,14 +94,13 @@ class WebSocket:
         """
         self.sock_opt = sock_opt(sockopt, sslopt)
         self.handshake_response = None
-        self.sock = None
+        self.sock: Optional[socket.socket] = None
 
         self.connected = False
         self.get_mask_key = get_mask_key
         # These buffer over the build-up of a single frame.
         self.frame_buffer = frame_buffer(self._recv, skip_utf8_validation)
-        self.cont_frame = continuous_frame(
-            fire_cont_frame, skip_utf8_validation)
+        self.cont_frame = continuous_frame(fire_cont_frame, skip_utf8_validation)
 
         if enable_multithread:
             self.lock = threading.Lock()
@@ -133,7 +140,7 @@ class WebSocket:
         """
         self.get_mask_key = func
 
-    def gettimeout(self) -> float:
+    def gettimeout(self) -> Union[float, int, None]:
         """
         Get the websocket timeout (in seconds) as an int or float
 
@@ -144,7 +151,7 @@ class WebSocket:
         """
         return self.sock_opt.timeout
 
-    def settimeout(self, timeout: float):
+    def settimeout(self, timeout: Union[float, int, None]):
         """
         Set the timeout to the websocket.
 
@@ -245,19 +252,26 @@ class WebSocket:
         socket: socket
             Pre-initialized stream socket.
         """
-        self.sock_opt.timeout = options.get('timeout', self.sock_opt.timeout)
-        self.sock, addrs = connect(url, self.sock_opt, proxy_info(**options),
-                                   options.pop('socket', None))
+        self.sock_opt.timeout = options.get("timeout", self.sock_opt.timeout)
+        self.sock, addrs = connect(
+            url, self.sock_opt, proxy_info(**options), options.pop("socket", None)
+        )
 
         try:
             self.handshake_response = handshake(self.sock, url, *addrs, **options)
-            for attempt in range(options.pop('redirect_limit', 3)):
+            for attempt in range(options.pop("redirect_limit", 3)):
                 if self.handshake_response.status in SUPPORTED_REDIRECT_STATUSES:
-                    url = self.handshake_response.headers['location']
+                    url = self.handshake_response.headers["location"]
                     self.sock.close()
-                    self.sock, addrs = connect(url, self.sock_opt, proxy_info(**options),
-                                               options.pop('socket', None))
-                    self.handshake_response = handshake(self.sock, url, *addrs, **options)
+                    self.sock, addrs = connect(
+                        url,
+                        self.sock_opt,
+                        proxy_info(**options),
+                        options.pop("socket", None),
+                    )
+                    self.handshake_response = handshake(
+                        self.sock, url, *addrs, **options
+                    )
             self.connected = True
         except:
             if self.sock:
@@ -265,7 +279,7 @@ class WebSocket:
                 self.sock = None
             raise
 
-    def send(self, payload: bytes or str, opcode: int = ABNF.OPCODE_TEXT) -> int:
+    def send(self, payload: Union[bytes, str], opcode: int = ABNF.OPCODE_TEXT) -> int:
         """
         Send the data as string.
 
@@ -282,6 +296,18 @@ class WebSocket:
         frame = ABNF.create_frame(payload, opcode)
         return self.send_frame(frame)
 
+    def send_text(self, text_data: str) -> int:
+        """
+        Sends UTF-8 encoded text.
+        """
+        return self.send(text_data, ABNF.OPCODE_TEXT)
+
+    def send_bytes(self, data: Union[bytes, bytearray]) -> int:
+        """
+        Sends a sequence of bytes.
+        """
+        return self.send(data, ABNF.OPCODE_BINARY)
+
     def send_frame(self, frame) -> int:
         """
         Send the data frame.
@@ -303,9 +329,9 @@ class WebSocket:
             frame.get_mask_key = self.get_mask_key
         data = frame.format()
         length = len(data)
-        if (isEnabledForTrace()):
-            trace("++Sent raw: " + repr(data))
-            trace("++Sent decoded: " + frame.__str__())
+        if isEnabledForTrace():
+            trace(f"++Sent raw: {repr(data)}")
+            trace(f"++Sent decoded: {frame.__str__()}")
         with self.lock:
             while data:
                 l = self._send(data)
@@ -324,7 +350,7 @@ class WebSocket:
         """
         return self.send(payload, ABNF.OPCODE_BINARY)
 
-    def ping(self, payload: str or bytes = ""):
+    def ping(self, payload: Union[str, bytes] = ""):
         """
         Send ping data.
 
@@ -337,7 +363,7 @@ class WebSocket:
             payload = payload.encode("utf-8")
         self.send(payload, ABNF.OPCODE_PING)
 
-    def pong(self, payload: str or bytes = ""):
+    def pong(self, payload: Union[str, bytes] = ""):
         """
         Send pong data.
 
@@ -350,7 +376,7 @@ class WebSocket:
             payload = payload.encode("utf-8")
         self.send(payload, ABNF.OPCODE_PONG)
 
-    def recv(self) -> str or bytes:
+    def recv(self) -> Union[str, bytes]:
         """
         Receive string data(byte array) from the server.
 
@@ -361,11 +387,16 @@ class WebSocket:
         with self.readlock:
             opcode, data = self.recv_data()
         if opcode == ABNF.OPCODE_TEXT:
-            return data.decode("utf-8")
-        elif opcode == ABNF.OPCODE_TEXT or opcode == ABNF.OPCODE_BINARY:
-            return data
+            data_received: Union[bytes, str] = data
+            if isinstance(data_received, bytes):
+                return data_received.decode("utf-8")
+            elif isinstance(data_received, str):
+                return data_received
+        elif opcode == ABNF.OPCODE_BINARY:
+            data_binary: bytes = data
+            return data_binary
         else:
-            return ''
+            return ""
 
     def recv_data(self, control_frame: bool = False) -> tuple:
         """
@@ -385,7 +416,7 @@ class WebSocket:
         opcode, frame = self.recv_data_frame(control_frame)
         return opcode, frame.data
 
-    def recv_data_frame(self, control_frame: bool = False):
+    def recv_data_frame(self, control_frame: bool = False) -> tuple:
         """
         Receive data with operation code.
 
@@ -404,15 +435,18 @@ class WebSocket:
         """
         while True:
             frame = self.recv_frame()
-            if (isEnabledForTrace()):
-                trace("++Rcv raw: " + repr(frame.format()))
-                trace("++Rcv decoded: " + frame.__str__())
+            if isEnabledForTrace():
+                trace(f"++Rcv raw: {repr(frame.format())}")
+                trace(f"++Rcv decoded: {frame.__str__()}")
             if not frame:
                 # handle error:
                 # 'NoneType' object has no attribute 'opcode'
-                raise WebSocketProtocolException(
-                    "Not a valid frame {frame}".format(frame=frame))
-            elif frame.opcode in (ABNF.OPCODE_TEXT, ABNF.OPCODE_BINARY, ABNF.OPCODE_CONT):
+                raise WebSocketProtocolException(f"Not a valid frame {frame}")
+            elif frame.opcode in (
+                ABNF.OPCODE_TEXT,
+                ABNF.OPCODE_BINARY,
+                ABNF.OPCODE_CONT,
+            ):
                 self.cont_frame.validate(frame)
                 self.cont_frame.add(frame)
 
@@ -426,8 +460,7 @@ class WebSocket:
                 if len(frame.data) < 126:
                     self.pong(frame.data)
                 else:
-                    raise WebSocketProtocolException(
-                        "Ping message is too long")
+                    raise WebSocketProtocolException("Ping message is too long")
                 if control_frame:
                     return frame.opcode, frame
             elif frame.opcode == ABNF.OPCODE_PONG:
@@ -458,9 +491,9 @@ class WebSocket:
         if status < 0 or status >= ABNF.LENGTH_16:
             raise ValueError("code is invalid range")
         self.connected = False
-        self.send(struct.pack('!H', status) + reason, ABNF.OPCODE_CLOSE)
+        self.send(struct.pack("!H", status) + reason, ABNF.OPCODE_CLOSE)
 
-    def close(self, status: int = STATUS_NORMAL, reason: bytes = b"", timeout: float = 3):
+    def close(self, status: int = STATUS_NORMAL, reason: bytes = b"", timeout: int = 3):
         """
         Close Websocket object
 
@@ -474,36 +507,37 @@ class WebSocket:
             Timeout until receive a close frame.
             If None, it will wait forever until receive a close frame.
         """
-        if self.connected:
-            if status < 0 or status >= ABNF.LENGTH_16:
-                raise ValueError("code is invalid range")
+        if not self.connected:
+            return
+        if status < 0 or status >= ABNF.LENGTH_16:
+            raise ValueError("code is invalid range")
 
-            try:
-                self.connected = False
-                self.send(struct.pack('!H', status) + reason, ABNF.OPCODE_CLOSE)
-                sock_timeout = self.sock.gettimeout()
-                self.sock.settimeout(timeout)
-                start_time = time.time()
-                while timeout is None or time.time() - start_time < timeout:
-                    try:
-                        frame = self.recv_frame()
-                        if frame.opcode != ABNF.OPCODE_CLOSE:
-                            continue
-                        if isEnabledForError():
-                            recv_status = struct.unpack("!H", frame.data[0:2])[0]
-                            if recv_status >= 3000 and recv_status <= 4999:
-                                debug("close status: " + repr(recv_status))
-                            elif recv_status != STATUS_NORMAL:
-                                error("close status: " + repr(recv_status))
-                        break
-                    except:
-                        break
-                self.sock.settimeout(sock_timeout)
-                self.sock.shutdown(socket.SHUT_RDWR)
-            except:
-                pass
+        try:
+            self.connected = False
+            self.send(struct.pack("!H", status) + reason, ABNF.OPCODE_CLOSE)
+            sock_timeout = self.sock.gettimeout()
+            self.sock.settimeout(timeout)
+            start_time = time.time()
+            while timeout is None or time.time() - start_time < timeout:
+                try:
+                    frame = self.recv_frame()
+                    if frame.opcode != ABNF.OPCODE_CLOSE:
+                        continue
+                    if isEnabledForError():
+                        recv_status = struct.unpack("!H", frame.data[0:2])[0]
+                        if recv_status >= 3000 and recv_status <= 4999:
+                            debug(f"close status: {repr(recv_status)}")
+                        elif recv_status != STATUS_NORMAL:
+                            error(f"close status: {repr(recv_status)}")
+                    break
+                except:
+                    break
+            self.sock.settimeout(sock_timeout)
+            self.sock.shutdown(socket.SHUT_RDWR)
+        except:
+            pass
 
-            self.shutdown()
+        self.shutdown()
 
     def abort(self):
         """
@@ -521,7 +555,7 @@ class WebSocket:
             self.sock = None
             self.connected = False
 
-    def _send(self, data: str or bytes):
+    def _send(self, data: Union[str, bytes]):
         return send(self.sock, data)
 
     def _recv(self, bufsize):
@@ -600,10 +634,14 @@ def create_connection(url: str, timeout=None, class_=WebSocket, **options):
     fire_cont_frame = options.pop("fire_cont_frame", False)
     enable_multithread = options.pop("enable_multithread", True)
     skip_utf8_validation = options.pop("skip_utf8_validation", False)
-    websock = class_(sockopt=sockopt, sslopt=sslopt,
-                     fire_cont_frame=fire_cont_frame,
-                     enable_multithread=enable_multithread,
-                     skip_utf8_validation=skip_utf8_validation, **options)
+    websock = class_(
+        sockopt=sockopt,
+        sslopt=sslopt,
+        fire_cont_frame=fire_cont_frame,
+        enable_multithread=enable_multithread,
+        skip_utf8_validation=skip_utf8_validation,
+        **options,
+    )
     websock.settimeout(timeout if timeout is not None else getdefaulttimeout())
     websock.connect(url, **options)
     return websock
diff --git a/lib/websocket/_exceptions.py b/lib/websocket/_exceptions.py
index 48f40a07..c146fa5d 100644
--- a/lib/websocket/_exceptions.py
+++ b/lib/websocket/_exceptions.py
@@ -22,6 +22,7 @@ class WebSocketException(Exception):
     """
     WebSocket exception class.
     """
+
     pass
 
 
@@ -29,6 +30,7 @@ class WebSocketProtocolException(WebSocketException):
     """
     If the WebSocket protocol is invalid, this exception will be raised.
     """
+
     pass
 
 
@@ -36,6 +38,7 @@ class WebSocketPayloadException(WebSocketException):
     """
     If the WebSocket payload is invalid, this exception will be raised.
     """
+
     pass
 
 
@@ -44,6 +47,7 @@ class WebSocketConnectionClosedException(WebSocketException):
     If remote host closed the connection or some network error happened,
     this exception will be raised.
     """
+
     pass
 
 
@@ -51,6 +55,7 @@ class WebSocketTimeoutException(WebSocketException):
     """
     WebSocketTimeoutException will be raised at socket timeout during read/write data.
     """
+
     pass
 
 
@@ -58,6 +63,7 @@ class WebSocketProxyException(WebSocketException):
     """
     WebSocketProxyException will be raised when proxy error occurred.
     """
+
     pass
 
 
@@ -66,7 +72,14 @@ class WebSocketBadStatusException(WebSocketException):
     WebSocketBadStatusException will be raised when we get bad handshake status code.
     """
 
-    def __init__(self, message: str, status_code: int, status_message=None, resp_headers=None, resp_body=None):
+    def __init__(
+        self,
+        message: str,
+        status_code: int,
+        status_message=None,
+        resp_headers=None,
+        resp_body=None,
+    ):
         super().__init__(message)
         self.status_code = status_code
         self.resp_headers = resp_headers
@@ -77,4 +90,5 @@ class WebSocketAddressException(WebSocketException):
     """
     If the websocket address info cannot be found, this exception will be raised.
     """
+
     pass
diff --git a/lib/websocket/_handshake.py b/lib/websocket/_handshake.py
index d28aefd7..e63dc979 100644
--- a/lib/websocket/_handshake.py
+++ b/lib/websocket/_handshake.py
@@ -20,7 +20,8 @@ import hashlib
 import hmac
 import os
 from base64 import encodebytes as base64encode
-from http import client as HTTPStatus
+from http import HTTPStatus
+
 from ._cookiejar import SimpleCookieJar
 from ._exceptions import *
 from ._http import *
@@ -32,14 +33,19 @@ __all__ = ["handshake_response", "handshake", "SUPPORTED_REDIRECT_STATUSES"]
 # websocket supported version.
 VERSION = 13
 
-SUPPORTED_REDIRECT_STATUSES = (HTTPStatus.MOVED_PERMANENTLY, HTTPStatus.FOUND, HTTPStatus.SEE_OTHER,)
+SUPPORTED_REDIRECT_STATUSES = (
+    HTTPStatus.MOVED_PERMANENTLY,
+    HTTPStatus.FOUND,
+    HTTPStatus.SEE_OTHER,
+    HTTPStatus.TEMPORARY_REDIRECT,
+    HTTPStatus.PERMANENT_REDIRECT,
+)
 SUCCESS_STATUSES = SUPPORTED_REDIRECT_STATUSES + (HTTPStatus.SWITCHING_PROTOCOLS,)
 
 CookieJar = SimpleCookieJar()
 
 
 class handshake_response:
-
     def __init__(self, status: int, headers: dict, subprotocol):
         self.status = status
         self.headers = headers
@@ -47,7 +53,9 @@ class handshake_response:
         CookieJar.add(headers.get("set-cookie"))
 
 
-def handshake(sock, url: str, hostname: str, port: int, resource: str, **options):
+def handshake(
+    sock, url: str, hostname: str, port: int, resource: str, **options
+) -> handshake_response:
     headers, key = _get_handshake_headers(resource, url, hostname, port, options)
 
     header_str = "\r\n".join(headers)
@@ -66,74 +74,64 @@ def handshake(sock, url: str, hostname: str, port: int, resource: str, **options
 
 def _pack_hostname(hostname: str) -> str:
     # IPv6 address
-    if ':' in hostname:
-        return '[' + hostname + ']'
-
+    if ":" in hostname:
+        return f"[{hostname}]"
     return hostname
 
 
-def _get_handshake_headers(resource: str, url: str, host: str, port: int, options: dict):
-    headers = [
-        "GET {resource} HTTP/1.1".format(resource=resource),
-        "Upgrade: websocket"
-    ]
-    if port == 80 or port == 443:
+def _get_handshake_headers(
+    resource: str, url: str, host: str, port: int, options: dict
+) -> tuple:
+    headers = [f"GET {resource} HTTP/1.1", "Upgrade: websocket"]
+    if port in [80, 443]:
         hostport = _pack_hostname(host)
     else:
-        hostport = "{h}:{p}".format(h=_pack_hostname(host), p=port)
+        hostport = f"{_pack_hostname(host)}:{port}"
     if options.get("host"):
-        headers.append("Host: {h}".format(h=options["host"]))
+        headers.append(f'Host: {options["host"]}')
     else:
-        headers.append("Host: {hp}".format(hp=hostport))
+        headers.append(f"Host: {hostport}")
 
     # scheme indicates whether http or https is used in Origin
     # The same approach is used in parse_url of _url.py to set default port
     scheme, url = url.split(":", 1)
     if not options.get("suppress_origin"):
         if "origin" in options and options["origin"] is not None:
-            headers.append("Origin: {origin}".format(origin=options["origin"]))
+            headers.append(f'Origin: {options["origin"]}')
         elif scheme == "wss":
-            headers.append("Origin: https://{hp}".format(hp=hostport))
+            headers.append(f"Origin: https://{hostport}")
         else:
-            headers.append("Origin: http://{hp}".format(hp=hostport))
+            headers.append(f"Origin: http://{hostport}")
 
     key = _create_sec_websocket_key()
 
     # Append Sec-WebSocket-Key & Sec-WebSocket-Version if not manually specified
-    if not options.get('header') or 'Sec-WebSocket-Key' not in options['header']:
-        headers.append("Sec-WebSocket-Key: {key}".format(key=key))
+    if not options.get("header") or "Sec-WebSocket-Key" not in options["header"]:
+        headers.append(f"Sec-WebSocket-Key: {key}")
     else:
-        key = options['header']['Sec-WebSocket-Key']
+        key = options["header"]["Sec-WebSocket-Key"]
 
-    if not options.get('header') or 'Sec-WebSocket-Version' not in options['header']:
-        headers.append("Sec-WebSocket-Version: {version}".format(version=VERSION))
+    if not options.get("header") or "Sec-WebSocket-Version" not in options["header"]:
+        headers.append(f"Sec-WebSocket-Version: {VERSION}")
 
-    if not options.get('connection'):
-        headers.append('Connection: Upgrade')
+    if not options.get("connection"):
+        headers.append("Connection: Upgrade")
     else:
-        headers.append(options['connection'])
+        headers.append(options["connection"])
 
-    subprotocols = options.get("subprotocols")
-    if subprotocols:
-        headers.append("Sec-WebSocket-Protocol: {protocols}".format(protocols=",".join(subprotocols)))
+    if subprotocols := options.get("subprotocols"):
+        headers.append(f'Sec-WebSocket-Protocol: {",".join(subprotocols)}')
 
-    header = options.get("header")
-    if header:
+    if header := options.get("header"):
         if isinstance(header, dict):
-            header = [
-                ": ".join([k, v])
-                for k, v in header.items()
-                if v is not None
-            ]
+            header = [": ".join([k, v]) for k, v in header.items() if v is not None]
         headers.extend(header)
 
     server_cookie = CookieJar.get(host)
     client_cookie = options.get("cookie", None)
 
-    cookie = "; ".join(filter(None, [server_cookie, client_cookie]))
-
-    if cookie:
-        headers.append("Cookie: {cookie}".format(cookie=cookie))
+    if cookie := "; ".join(filter(None, [server_cookie, client_cookie])):
+        headers.append(f"Cookie: {cookie}")
 
     headers.extend(("", ""))
     return headers, key
@@ -142,12 +140,20 @@ def _get_handshake_headers(resource: str, url: str, host: str, port: int, option
 def _get_resp_headers(sock, success_statuses: tuple = SUCCESS_STATUSES) -> tuple:
     status, resp_headers, status_message = read_headers(sock)
     if status not in success_statuses:
-        content_len = resp_headers.get('content-length')
+        content_len = resp_headers.get("content-length")
         if content_len:
-            response_body = sock.recv(int(content_len))  # read the body of the HTTP error message response and include it in the exception
+            response_body = sock.recv(
+                int(content_len)
+            )  # read the body of the HTTP error message response and include it in the exception
         else:
             response_body = None
-        raise WebSocketBadStatusException("Handshake status {status} {message} -+-+- {headers} -+-+- {body}".format(status=status, message=status_message, headers=resp_headers, body=response_body), status, status_message, resp_headers, response_body)
+        raise WebSocketBadStatusException(
+            f"Handshake status {status} {status_message} -+-+- {resp_headers} -+-+- {response_body}",
+            status,
+            status_message,
+            resp_headers,
+            response_body,
+        )
     return status, resp_headers
 
 
@@ -157,20 +163,20 @@ _HEADERS_TO_CHECK = {
 }
 
 
-def _validate(headers, key: str, subprotocols):
+def _validate(headers, key: str, subprotocols) -> tuple:
     subproto = None
     for k, v in _HEADERS_TO_CHECK.items():
         r = headers.get(k, None)
         if not r:
             return False, None
-        r = [x.strip().lower() for x in r.split(',')]
+        r = [x.strip().lower() for x in r.split(",")]
         if v not in r:
             return False, None
 
     if subprotocols:
         subproto = headers.get("sec-websocket-protocol", None)
         if not subproto or subproto.lower() not in [s.lower() for s in subprotocols]:
-            error("Invalid subprotocol: " + str(subprotocols))
+            error(f"Invalid subprotocol: {subprotocols}")
             return False, None
         subproto = subproto.lower()
 
@@ -180,13 +186,12 @@ def _validate(headers, key: str, subprotocols):
     result = result.lower()
 
     if isinstance(result, str):
-        result = result.encode('utf-8')
+        result = result.encode("utf-8")
 
-    value = (key + "258EAFA5-E914-47DA-95CA-C5AB0DC85B11").encode('utf-8')
+    value = f"{key}258EAFA5-E914-47DA-95CA-C5AB0DC85B11".encode("utf-8")
     hashed = base64encode(hashlib.sha1(value).digest()).strip().lower()
-    success = hmac.compare_digest(hashed, result)
 
-    if success:
+    if hmac.compare_digest(hashed, result):
         return True, subproto
     else:
         return False, None
@@ -194,4 +199,4 @@ def _validate(headers, key: str, subprotocols):
 
 def _create_sec_websocket_key() -> str:
     randomness = os.urandom(16)
-    return base64encode(randomness).decode('utf-8').strip()
+    return base64encode(randomness).decode("utf-8").strip()
diff --git a/lib/websocket/_http.py b/lib/websocket/_http.py
index 13183b20..977a30f1 100644
--- a/lib/websocket/_http.py
+++ b/lib/websocket/_http.py
@@ -19,6 +19,7 @@ limitations under the License.
 import errno
 import os
 import socket
+from base64 import encodebytes as base64encode
 
 from ._exceptions import *
 from ._logging import *
@@ -26,14 +27,13 @@ from ._socket import *
 from ._ssl_compat import *
 from ._url import *
 
-from base64 import encodebytes as base64encode
-
 __all__ = ["proxy_info", "connect", "read_headers"]
 
 try:
-    from python_socks.sync import Proxy
     from python_socks._errors import *
     from python_socks._types import ProxyType
+    from python_socks.sync import Proxy
+
     HAVE_PYTHON_SOCKS = True
 except:
     HAVE_PYTHON_SOCKS = False
@@ -49,7 +49,6 @@ except:
 
 
 class proxy_info:
-
     def __init__(self, **options):
         self.proxy_host = options.get("http_proxy_host", None)
         if self.proxy_host:
@@ -59,8 +58,16 @@ class proxy_info:
             self.proxy_protocol = options.get("proxy_type", "http")
             # Note: If timeout not specified, default python-socks timeout is 60 seconds
             self.proxy_timeout = options.get("http_proxy_timeout", None)
-            if self.proxy_protocol not in ['http', 'socks4', 'socks4a', 'socks5', 'socks5h']:
-                raise ProxyError("Only http, socks4, socks5 proxy protocols are supported")
+            if self.proxy_protocol not in [
+                "http",
+                "socks4",
+                "socks4a",
+                "socks5",
+                "socks5h",
+            ]:
+                raise ProxyError(
+                    "Only http, socks4, socks5 proxy protocols are supported"
+                )
         else:
             self.proxy_port = 0
             self.auth = None
@@ -68,25 +75,28 @@ class proxy_info:
             self.proxy_protocol = "http"
 
 
-def _start_proxied_socket(url: str, options, proxy):
+def _start_proxied_socket(url: str, options, proxy) -> tuple:
     if not HAVE_PYTHON_SOCKS:
-        raise WebSocketException("Python Socks is needed for SOCKS proxying but is not available")
+        raise WebSocketException(
+            "Python Socks is needed for SOCKS proxying but is not available"
+        )
 
     hostname, port, resource, is_secure = parse_url(url)
 
-    if proxy.proxy_protocol == "socks5":
-        rdns = False
-        proxy_type = ProxyType.SOCKS5
     if proxy.proxy_protocol == "socks4":
         rdns = False
         proxy_type = ProxyType.SOCKS4
-    # socks5h and socks4a send DNS through proxy
-    if proxy.proxy_protocol == "socks5h":
-        rdns = True
-        proxy_type = ProxyType.SOCKS5
-    if proxy.proxy_protocol == "socks4a":
+    # socks4a sends DNS through proxy
+    elif proxy.proxy_protocol == "socks4a":
         rdns = True
         proxy_type = ProxyType.SOCKS4
+    elif proxy.proxy_protocol == "socks5":
+        rdns = False
+        proxy_type = ProxyType.SOCKS5
+    # socks5h sends DNS through proxy
+    elif proxy.proxy_protocol == "socks5h":
+        rdns = True
+        proxy_type = ProxyType.SOCKS5
 
     ws_proxy = Proxy.create(
         proxy_type=proxy_type,
@@ -94,14 +104,16 @@ def _start_proxied_socket(url: str, options, proxy):
         port=int(proxy.proxy_port),
         username=proxy.auth[0] if proxy.auth else None,
         password=proxy.auth[1] if proxy.auth else None,
-        rdns=rdns)
+        rdns=rdns,
+    )
 
     sock = ws_proxy.connect(hostname, port, timeout=proxy.proxy_timeout)
 
-    if is_secure and HAVE_SSL:
-        sock = _ssl_socket(sock, options.sslopt, hostname)
-    elif is_secure:
-        raise WebSocketException("SSL not available.")
+    if is_secure:
+        if HAVE_SSL:
+            sock = _ssl_socket(sock, options.sslopt, hostname)
+        else:
+            raise WebSocketException("SSL not available.")
 
     return sock, (hostname, port, resource)
 
@@ -110,7 +122,7 @@ def connect(url: str, options, proxy, socket):
     # Use _start_proxied_socket() only for socks4 or socks5 proxy
     # Use _tunnel() for http proxy
     # TODO: Use python-socks for http protocol also, to standardize flow
-    if proxy.proxy_host and not socket and not (proxy.proxy_protocol == "http"):
+    if proxy.proxy_host and not socket and proxy.proxy_protocol != "http":
         return _start_proxied_socket(url, options, proxy)
 
     hostname, port_from_url, resource, is_secure = parse_url(url)
@@ -119,10 +131,10 @@ def connect(url: str, options, proxy, socket):
         return socket, (hostname, port_from_url, resource)
 
     addrinfo_list, need_tunnel, auth = _get_addrinfo_list(
-        hostname, port_from_url, is_secure, proxy)
+        hostname, port_from_url, is_secure, proxy
+    )
     if not addrinfo_list:
-        raise WebSocketException(
-            "Host not found.: " + hostname + ":" + str(port_from_url))
+        raise WebSocketException(f"Host not found.: {hostname}:{port_from_url}")
 
     sock = None
     try:
@@ -143,16 +155,23 @@ def connect(url: str, options, proxy, socket):
         raise
 
 
-def _get_addrinfo_list(hostname, port, is_secure, proxy):
+def _get_addrinfo_list(hostname, port: int, is_secure: bool, proxy) -> tuple:
     phost, pport, pauth = get_proxy_info(
-        hostname, is_secure, proxy.proxy_host, proxy.proxy_port, proxy.auth, proxy.no_proxy)
+        hostname,
+        is_secure,
+        proxy.proxy_host,
+        proxy.proxy_port,
+        proxy.auth,
+        proxy.no_proxy,
+    )
     try:
         # when running on windows 10, getaddrinfo without socktype returns a socktype 0.
         # This generates an error exception: `_on_error: exception Socket type must be stream or datagram, not 0`
         # or `OSError: [Errno 22] Invalid argument` when creating socket. Force the socket type to SOCK_STREAM.
         if not phost:
             addrinfo_list = socket.getaddrinfo(
-                hostname, port, 0, socket.SOCK_STREAM, socket.SOL_TCP)
+                hostname, port, 0, socket.SOCK_STREAM, socket.SOL_TCP
+            )
             return addrinfo_list, False, None
         else:
             pport = pport and pport or 80
@@ -160,7 +179,9 @@ def _get_addrinfo_list(hostname, port, is_secure, proxy):
             # returns a socktype 0. This generates an error exception:
             # _on_error: exception Socket type must be stream or datagram, not 0
             # Force the socket type to SOCK_STREAM
-            addrinfo_list = socket.getaddrinfo(phost, pport, 0, socket.SOCK_STREAM, socket.SOL_TCP)
+            addrinfo_list = socket.getaddrinfo(
+                phost, pport, 0, socket.SOCK_STREAM, socket.SOL_TCP
+            )
             return addrinfo_list, True, pauth
     except socket.gaierror as e:
         raise WebSocketAddressException(e)
@@ -186,14 +207,17 @@ def _open_socket(addrinfo_list, sockopt, timeout):
                 sock.close()
                 error.remote_ip = str(address[0])
                 try:
-                    eConnRefused = (errno.ECONNREFUSED, errno.WSAECONNREFUSED, errno.ENETUNREACH)
+                    eConnRefused = (
+                        errno.ECONNREFUSED,
+                        errno.WSAECONNREFUSED,
+                        errno.ENETUNREACH,
+                    )
                 except AttributeError:
                     eConnRefused = (errno.ECONNREFUSED, errno.ENETUNREACH)
-                if error.errno in eConnRefused:
-                    err = error
-                    continue
-                else:
+                if error.errno not in eConnRefused:
                     raise error
+                err = error
+                continue
             else:
                 break
         else:
@@ -206,89 +230,97 @@ def _open_socket(addrinfo_list, sockopt, timeout):
     return sock
 
 
-def _wrap_sni_socket(sock, sslopt, hostname, check_hostname):
-    context = sslopt.get('context', None)
+def _wrap_sni_socket(sock: socket.socket, sslopt: dict, hostname, check_hostname):
+    context = sslopt.get("context", None)
     if not context:
-        context = ssl.SSLContext(sslopt.get('ssl_version', ssl.PROTOCOL_TLS_CLIENT))
+        context = ssl.SSLContext(sslopt.get("ssl_version", ssl.PROTOCOL_TLS_CLIENT))
         # Non default context need to manually enable SSLKEYLOGFILE support by setting the keylog_filename attribute.
         # For more details see also:
         # * https://docs.python.org/3.8/library/ssl.html?highlight=sslkeylogfile#context-creation
         # * https://docs.python.org/3.8/library/ssl.html?highlight=sslkeylogfile#ssl.SSLContext.keylog_filename
         context.keylog_filename = os.environ.get("SSLKEYLOGFILE", None)
 
-        if sslopt.get('cert_reqs', ssl.CERT_NONE) != ssl.CERT_NONE:
-            cafile = sslopt.get('ca_certs', None)
-            capath = sslopt.get('ca_cert_path', None)
+        if sslopt.get("cert_reqs", ssl.CERT_NONE) != ssl.CERT_NONE:
+            cafile = sslopt.get("ca_certs", None)
+            capath = sslopt.get("ca_cert_path", None)
             if cafile or capath:
                 context.load_verify_locations(cafile=cafile, capath=capath)
-            elif hasattr(context, 'load_default_certs'):
+            elif hasattr(context, "load_default_certs"):
                 context.load_default_certs(ssl.Purpose.SERVER_AUTH)
-        if sslopt.get('certfile', None):
+        if sslopt.get("certfile", None):
             context.load_cert_chain(
-                sslopt['certfile'],
-                sslopt.get('keyfile', None),
-                sslopt.get('password', None),
+                sslopt["certfile"],
+                sslopt.get("keyfile", None),
+                sslopt.get("password", None),
             )
 
         # Python 3.10 switch to PROTOCOL_TLS_CLIENT defaults to "cert_reqs = ssl.CERT_REQUIRED" and "check_hostname = True"
         # If both disabled, set check_hostname before verify_mode
         # see https://github.com/liris/websocket-client/commit/b96a2e8fa765753e82eea531adb19716b52ca3ca#commitcomment-10803153
-        if sslopt.get('cert_reqs', ssl.CERT_NONE) == ssl.CERT_NONE and not sslopt.get('check_hostname', False):
+        if sslopt.get("cert_reqs", ssl.CERT_NONE) == ssl.CERT_NONE and not sslopt.get(
+            "check_hostname", False
+        ):
             context.check_hostname = False
             context.verify_mode = ssl.CERT_NONE
         else:
-            context.check_hostname = sslopt.get('check_hostname', True)
-            context.verify_mode = sslopt.get('cert_reqs', ssl.CERT_REQUIRED)
+            context.check_hostname = sslopt.get("check_hostname", True)
+            context.verify_mode = sslopt.get("cert_reqs", ssl.CERT_REQUIRED)
 
-        if 'ciphers' in sslopt:
-            context.set_ciphers(sslopt['ciphers'])
-        if 'cert_chain' in sslopt:
-            certfile, keyfile, password = sslopt['cert_chain']
+        if "ciphers" in sslopt:
+            context.set_ciphers(sslopt["ciphers"])
+        if "cert_chain" in sslopt:
+            certfile, keyfile, password = sslopt["cert_chain"]
             context.load_cert_chain(certfile, keyfile, password)
-        if 'ecdh_curve' in sslopt:
-            context.set_ecdh_curve(sslopt['ecdh_curve'])
+        if "ecdh_curve" in sslopt:
+            context.set_ecdh_curve(sslopt["ecdh_curve"])
 
     return context.wrap_socket(
         sock,
-        do_handshake_on_connect=sslopt.get('do_handshake_on_connect', True),
-        suppress_ragged_eofs=sslopt.get('suppress_ragged_eofs', True),
+        do_handshake_on_connect=sslopt.get("do_handshake_on_connect", True),
+        suppress_ragged_eofs=sslopt.get("suppress_ragged_eofs", True),
         server_hostname=hostname,
     )
 
 
-def _ssl_socket(sock, user_sslopt, hostname):
-    sslopt = dict(cert_reqs=ssl.CERT_REQUIRED)
+def _ssl_socket(sock: socket.socket, user_sslopt: dict, hostname):
+    sslopt: dict = dict(cert_reqs=ssl.CERT_REQUIRED)
     sslopt.update(user_sslopt)
 
-    certPath = os.environ.get('WEBSOCKET_CLIENT_CA_BUNDLE')
-    if certPath and os.path.isfile(certPath) \
-            and user_sslopt.get('ca_certs', None) is None:
-        sslopt['ca_certs'] = certPath
-    elif certPath and os.path.isdir(certPath) \
-            and user_sslopt.get('ca_cert_path', None) is None:
-        sslopt['ca_cert_path'] = certPath
+    certPath = os.environ.get("WEBSOCKET_CLIENT_CA_BUNDLE")
+    if (
+        certPath
+        and os.path.isfile(certPath)
+        and user_sslopt.get("ca_certs", None) is None
+    ):
+        sslopt["ca_certs"] = certPath
+    elif (
+        certPath
+        and os.path.isdir(certPath)
+        and user_sslopt.get("ca_cert_path", None) is None
+    ):
+        sslopt["ca_cert_path"] = certPath
 
-    if sslopt.get('server_hostname', None):
-        hostname = sslopt['server_hostname']
+    if sslopt.get("server_hostname", None):
+        hostname = sslopt["server_hostname"]
 
-    check_hostname = sslopt.get('check_hostname', True)
+    check_hostname = sslopt.get("check_hostname", True)
     sock = _wrap_sni_socket(sock, sslopt, hostname, check_hostname)
 
     return sock
 
 
-def _tunnel(sock, host, port, auth):
+def _tunnel(sock: socket.socket, host, port: int, auth) -> socket.socket:
     debug("Connecting proxy...")
-    connect_header = "CONNECT {h}:{p} HTTP/1.1\r\n".format(h=host, p=port)
-    connect_header += "Host: {h}:{p}\r\n".format(h=host, p=port)
+    connect_header = f"CONNECT {host}:{port} HTTP/1.1\r\n"
+    connect_header += f"Host: {host}:{port}\r\n"
 
     # TODO: support digest auth.
     if auth and auth[0]:
         auth_str = auth[0]
         if auth[1]:
-            auth_str += ":" + auth[1]
-        encoded_str = base64encode(auth_str.encode()).strip().decode().replace('\n', '')
-        connect_header += "Proxy-Authorization: Basic {str}\r\n".format(str=encoded_str)
+            auth_str += f":{auth[1]}"
+        encoded_str = base64encode(auth_str.encode()).strip().decode().replace("\n", "")
+        connect_header += f"Proxy-Authorization: Basic {encoded_str}\r\n"
     connect_header += "\r\n"
     dump("request header", connect_header)
 
@@ -300,40 +332,37 @@ def _tunnel(sock, host, port, auth):
         raise WebSocketProxyException(str(e))
 
     if status != 200:
-        raise WebSocketProxyException(
-            "failed CONNECT via proxy status: {status}".format(status=status))
+        raise WebSocketProxyException(f"failed CONNECT via proxy status: {status}")
 
     return sock
 
 
-def read_headers(sock):
+def read_headers(sock: socket.socket) -> tuple:
     status = None
     status_message = None
-    headers = {}
+    headers: dict = {}
     trace("--- response header ---")
 
     while True:
         line = recv_line(sock)
-        line = line.decode('utf-8').strip()
+        line = line.decode("utf-8").strip()
         if not line:
             break
         trace(line)
         if not status:
-
             status_info = line.split(" ", 2)
             status = int(status_info[1])
             if len(status_info) > 2:
                 status_message = status_info[2]
         else:
             kv = line.split(":", 1)
-            if len(kv) == 2:
-                key, value = kv
-                if key.lower() == "set-cookie" and headers.get("set-cookie"):
-                    headers["set-cookie"] = headers.get("set-cookie") + "; " + value.strip()
-                else:
-                    headers[key.lower()] = value.strip()
-            else:
+            if len(kv) != 2:
                 raise WebSocketException("Invalid header")
+            key, value = kv
+            if key.lower() == "set-cookie" and headers.get("set-cookie"):
+                headers["set-cookie"] = headers.get("set-cookie") + "; " + value.strip()
+            else:
+                headers[key.lower()] = value.strip()
 
     trace("-----------------------")
 
diff --git a/lib/websocket/_logging.py b/lib/websocket/_logging.py
index 806de4d4..b88cda37 100644
--- a/lib/websocket/_logging.py
+++ b/lib/websocket/_logging.py
@@ -19,25 +19,38 @@ See the License for the specific language governing permissions and
 limitations under the License.
 """
 
-_logger = logging.getLogger('websocket')
+_logger = logging.getLogger("websocket")
 try:
     from logging import NullHandler
 except ImportError:
+
     class NullHandler(logging.Handler):
         def emit(self, record) -> None:
             pass
 
+
 _logger.addHandler(NullHandler())
 
 _traceEnabled = False
 
-__all__ = ["enableTrace", "dump", "error", "warning", "debug", "trace",
-           "isEnabledForError", "isEnabledForDebug", "isEnabledForTrace"]
+__all__ = [
+    "enableTrace",
+    "dump",
+    "error",
+    "warning",
+    "debug",
+    "trace",
+    "isEnabledForError",
+    "isEnabledForDebug",
+    "isEnabledForTrace",
+]
 
 
-def enableTrace(traceable: bool,
-                handler: logging.StreamHandler = logging.StreamHandler(),
-                level: str = "DEBUG") -> None:
+def enableTrace(
+    traceable: bool,
+    handler: logging.StreamHandler = logging.StreamHandler(),
+    level: str = "DEBUG",
+) -> None:
     """
     Turn on/off the traceability.
 
@@ -55,7 +68,7 @@ def enableTrace(traceable: bool,
 
 def dump(title: str, message: str) -> None:
     if _traceEnabled:
-        _logger.debug("--- " + title + " ---")
+        _logger.debug(f"--- {title} ---")
         _logger.debug(message)
         _logger.debug("-----------------------")
 
diff --git a/lib/websocket/_socket.py b/lib/websocket/_socket.py
index e8858fc8..f0ad27a5 100644
--- a/lib/websocket/_socket.py
+++ b/lib/websocket/_socket.py
@@ -1,6 +1,7 @@
 import errno
 import selectors
 import socket
+from typing import Union
 
 from ._exceptions import *
 from ._ssl_compat import *
@@ -37,12 +38,18 @@ if hasattr(socket, "TCP_KEEPCNT"):
 
 _default_timeout = None
 
-__all__ = ["DEFAULT_SOCKET_OPTION", "sock_opt", "setdefaulttimeout", "getdefaulttimeout",
-           "recv", "recv_line", "send"]
+__all__ = [
+    "DEFAULT_SOCKET_OPTION",
+    "sock_opt",
+    "setdefaulttimeout",
+    "getdefaulttimeout",
+    "recv",
+    "recv_line",
+    "send",
+]
 
 
 class sock_opt:
-
     def __init__(self, sockopt: list, sslopt: dict) -> None:
         if sockopt is None:
             sockopt = []
@@ -53,7 +60,7 @@ class sock_opt:
         self.timeout = None
 
 
-def setdefaulttimeout(timeout: int or float) -> None:
+def setdefaulttimeout(timeout: Union[int, float, None]) -> None:
     """
     Set the global timeout setting to connect.
 
@@ -66,7 +73,7 @@ def setdefaulttimeout(timeout: int or float) -> None:
     _default_timeout = timeout
 
 
-def getdefaulttimeout() -> int or float:
+def getdefaulttimeout() -> Union[int, float, None]:
     """
     Get default timeout
 
@@ -89,7 +96,7 @@ def recv(sock: socket.socket, bufsize: int) -> bytes:
             pass
         except socket.error as exc:
             error_code = extract_error_code(exc)
-            if error_code != errno.EAGAIN and error_code != errno.EWOULDBLOCK:
+            if error_code not in [errno.EAGAIN, errno.EWOULDBLOCK]:
                 raise
 
         sel = selectors.DefaultSelector()
@@ -113,14 +120,13 @@ def recv(sock: socket.socket, bufsize: int) -> bytes:
         raise WebSocketTimeoutException(message)
     except SSLError as e:
         message = extract_err_message(e)
-        if isinstance(message, str) and 'timed out' in message:
+        if isinstance(message, str) and "timed out" in message:
             raise WebSocketTimeoutException(message)
         else:
             raise
 
     if not bytes_:
-        raise WebSocketConnectionClosedException(
-            "Connection to remote host was lost.")
+        raise WebSocketConnectionClosedException("Connection to remote host was lost.")
 
     return bytes_
 
@@ -130,14 +136,14 @@ def recv_line(sock: socket.socket) -> bytes:
     while True:
         c = recv(sock, 1)
         line.append(c)
-        if c == b'\n':
+        if c == b"\n":
             break
-    return b''.join(line)
+    return b"".join(line)
 
 
-def send(sock: socket.socket, data: bytes) -> int:
+def send(sock: socket.socket, data: Union[bytes, str]) -> int:
     if isinstance(data, str):
-        data = data.encode('utf-8')
+        data = data.encode("utf-8")
 
     if not sock:
         raise WebSocketConnectionClosedException("socket is already closed.")
@@ -151,7 +157,7 @@ def send(sock: socket.socket, data: bytes) -> int:
             error_code = extract_error_code(exc)
             if error_code is None:
                 raise
-            if error_code != errno.EAGAIN and error_code != errno.EWOULDBLOCK:
+            if error_code not in [errno.EAGAIN, errno.EWOULDBLOCK]:
                 raise
 
         sel = selectors.DefaultSelector()
diff --git a/lib/websocket/_ssl_compat.py b/lib/websocket/_ssl_compat.py
index b2eba387..029a5c6e 100644
--- a/lib/websocket/_ssl_compat.py
+++ b/lib/websocket/_ssl_compat.py
@@ -20,9 +20,8 @@ __all__ = ["HAVE_SSL", "ssl", "SSLError", "SSLWantReadError", "SSLWantWriteError
 
 try:
     import ssl
-    from ssl import SSLError
-    from ssl import SSLWantReadError
-    from ssl import SSLWantWriteError
+    from ssl import SSLError, SSLWantReadError, SSLWantWriteError
+
     HAVE_SSL = True
 except ImportError:
     # dummy class of SSLError for environment without ssl support
diff --git a/lib/websocket/_url.py b/lib/websocket/_url.py
index 2141b021..7d53830e 100644
--- a/lib/websocket/_url.py
+++ b/lib/websocket/_url.py
@@ -1,7 +1,7 @@
 import os
 import socket
 import struct
-
+from typing import Optional
 from urllib.parse import unquote, urlparse
 
 """
@@ -67,7 +67,7 @@ def parse_url(url: str) -> tuple:
         resource = "/"
 
     if parsed.query:
-        resource += "?" + parsed.query
+        resource += f"?{parsed.query}"
 
     return hostname, port, resource, is_secure
 
@@ -93,37 +93,50 @@ def _is_subnet_address(hostname: str) -> bool:
 
 
 def _is_address_in_network(ip: str, net: str) -> bool:
-    ipaddr = struct.unpack('!I', socket.inet_aton(ip))[0]
-    netaddr, netmask = net.split('/')
-    netaddr = struct.unpack('!I', socket.inet_aton(netaddr))[0]
+    ipaddr: int = struct.unpack("!I", socket.inet_aton(ip))[0]
+    netaddr, netmask = net.split("/")
+    netaddr: int = struct.unpack("!I", socket.inet_aton(netaddr))[0]
 
     netmask = (0xFFFFFFFF << (32 - int(netmask))) & 0xFFFFFFFF
     return ipaddr & netmask == netaddr
 
 
-def _is_no_proxy_host(hostname: str, no_proxy: list) -> bool:
+def _is_no_proxy_host(hostname: str, no_proxy: Optional[list]) -> bool:
     if not no_proxy:
-        v = os.environ.get("no_proxy", os.environ.get("NO_PROXY", "")).replace(" ", "")
-        if v:
+        if v := os.environ.get("no_proxy", os.environ.get("NO_PROXY", "")).replace(
+            " ", ""
+        ):
             no_proxy = v.split(",")
     if not no_proxy:
         no_proxy = DEFAULT_NO_PROXY_HOST
 
-    if '*' in no_proxy:
+    if "*" in no_proxy:
         return True
     if hostname in no_proxy:
         return True
     if _is_ip_address(hostname):
-        return any([_is_address_in_network(hostname, subnet) for subnet in no_proxy if _is_subnet_address(subnet)])
-    for domain in [domain for domain in no_proxy if domain.startswith('.')]:
+        return any(
+            [
+                _is_address_in_network(hostname, subnet)
+                for subnet in no_proxy
+                if _is_subnet_address(subnet)
+            ]
+        )
+    for domain in [domain for domain in no_proxy if domain.startswith(".")]:
         if hostname.endswith(domain):
             return True
     return False
 
 
 def get_proxy_info(
-        hostname: str, is_secure: bool, proxy_host: str = None, proxy_port: int = 0, proxy_auth: tuple = None,
-        no_proxy: list = None, proxy_type: str = 'http') -> tuple:
+    hostname: str,
+    is_secure: bool,
+    proxy_host: Optional[str] = None,
+    proxy_port: int = 0,
+    proxy_auth: Optional[tuple] = None,
+    no_proxy: Optional[list] = None,
+    proxy_type: str = "http",
+) -> tuple:
     """
     Try to retrieve proxy host and port from environment
     if not provided in options.
@@ -159,10 +172,16 @@ def get_proxy_info(
         return proxy_host, port, auth
 
     env_key = "https_proxy" if is_secure else "http_proxy"
-    value = os.environ.get(env_key, os.environ.get(env_key.upper(), "")).replace(" ", "")
+    value = os.environ.get(env_key, os.environ.get(env_key.upper(), "")).replace(
+        " ", ""
+    )
     if value:
         proxy = urlparse(value)
-        auth = (unquote(proxy.username), unquote(proxy.password)) if proxy.username else None
+        auth = (
+            (unquote(proxy.username), unquote(proxy.password))
+            if proxy.username
+            else None
+        )
         return proxy.hostname, proxy.port, auth
 
     return None, 0, None
diff --git a/lib/websocket/_utils.py b/lib/websocket/_utils.py
index 3db2d83b..c63adfa5 100644
--- a/lib/websocket/_utils.py
+++ b/lib/websocket/_utils.py
@@ -1,3 +1,5 @@
+from typing import Union
+
 """
 _url.py
 websocket - WebSocket client library for Python
@@ -20,7 +22,6 @@ __all__ = ["NoLock", "validate_utf8", "extract_err_message", "extract_error_code
 
 
 class NoLock:
-
     def __enter__(self) -> None:
         pass
 
@@ -33,8 +34,9 @@ try:
     # strings.
     from wsaccel.utf8validator import Utf8Validator
 
-    def _validate_utf8(utfbytes: bytes) -> bool:
-        return Utf8Validator().validate(utfbytes)[0]
+    def _validate_utf8(utfbytes: Union[str, bytes]) -> bool:
+        result: bool = Utf8Validator().validate(utfbytes)[0]
+        return result
 
 except ImportError:
     # UTF-8 validator
@@ -46,44 +48,396 @@ except ImportError:
     _UTF8D = [
         # The first part of the table maps bytes to character classes that
         # to reduce the size of the transition table and create bitmasks.
-        0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,  0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
-        0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,  0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
-        0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,  0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
-        0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,  0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
-        1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,  9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,9,
-        7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,  7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,7,
-        8,8,2,2,2,2,2,2,2,2,2,2,2,2,2,2,  2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,
-        10,3,3,3,3,3,3,3,3,3,3,3,3,4,3,3, 11,6,6,6,5,8,8,8,8,8,8,8,8,8,8,8,
-
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        0,
+        1,
+        1,
+        1,
+        1,
+        1,
+        1,
+        1,
+        1,
+        1,
+        1,
+        1,
+        1,
+        1,
+        1,
+        1,
+        1,
+        9,
+        9,
+        9,
+        9,
+        9,
+        9,
+        9,
+        9,
+        9,
+        9,
+        9,
+        9,
+        9,
+        9,
+        9,
+        9,
+        7,
+        7,
+        7,
+        7,
+        7,
+        7,
+        7,
+        7,
+        7,
+        7,
+        7,
+        7,
+        7,
+        7,
+        7,
+        7,
+        7,
+        7,
+        7,
+        7,
+        7,
+        7,
+        7,
+        7,
+        7,
+        7,
+        7,
+        7,
+        7,
+        7,
+        7,
+        7,
+        8,
+        8,
+        2,
+        2,
+        2,
+        2,
+        2,
+        2,
+        2,
+        2,
+        2,
+        2,
+        2,
+        2,
+        2,
+        2,
+        2,
+        2,
+        2,
+        2,
+        2,
+        2,
+        2,
+        2,
+        2,
+        2,
+        2,
+        2,
+        2,
+        2,
+        2,
+        2,
+        10,
+        3,
+        3,
+        3,
+        3,
+        3,
+        3,
+        3,
+        3,
+        3,
+        3,
+        3,
+        3,
+        4,
+        3,
+        3,
+        11,
+        6,
+        6,
+        6,
+        5,
+        8,
+        8,
+        8,
+        8,
+        8,
+        8,
+        8,
+        8,
+        8,
+        8,
+        8,
         # The second part is a transition table that maps a combination
         # of a state of the automaton and a character class to a state.
-        0,12,24,36,60,96,84,12,12,12,48,72, 12,12,12,12,12,12,12,12,12,12,12,12,
-        12, 0,12,12,12,12,12, 0,12, 0,12,12, 12,24,12,12,12,12,12,24,12,24,12,12,
-        12,12,12,12,12,12,12,24,12,12,12,12, 12,24,12,12,12,12,12,12,12,24,12,12,
-        12,12,12,12,12,12,12,36,12,36,12,12, 12,36,12,12,12,12,12,36,12,36,12,12,
-        12,36,12,12,12,12,12,12,12,12,12,12, ]
+        0,
+        12,
+        24,
+        36,
+        60,
+        96,
+        84,
+        12,
+        12,
+        12,
+        48,
+        72,
+        12,
+        12,
+        12,
+        12,
+        12,
+        12,
+        12,
+        12,
+        12,
+        12,
+        12,
+        12,
+        12,
+        0,
+        12,
+        12,
+        12,
+        12,
+        12,
+        0,
+        12,
+        0,
+        12,
+        12,
+        12,
+        24,
+        12,
+        12,
+        12,
+        12,
+        12,
+        24,
+        12,
+        24,
+        12,
+        12,
+        12,
+        12,
+        12,
+        12,
+        12,
+        12,
+        12,
+        24,
+        12,
+        12,
+        12,
+        12,
+        12,
+        24,
+        12,
+        12,
+        12,
+        12,
+        12,
+        12,
+        12,
+        24,
+        12,
+        12,
+        12,
+        12,
+        12,
+        12,
+        12,
+        12,
+        12,
+        36,
+        12,
+        36,
+        12,
+        12,
+        12,
+        36,
+        12,
+        12,
+        12,
+        12,
+        12,
+        36,
+        12,
+        36,
+        12,
+        12,
+        12,
+        36,
+        12,
+        12,
+        12,
+        12,
+        12,
+        12,
+        12,
+        12,
+        12,
+        12,
+    ]
 
     def _decode(state: int, codep: int, ch: int) -> tuple:
         tp = _UTF8D[ch]
 
-        codep = (ch & 0x3f) | (codep << 6) if (
-            state != _UTF8_ACCEPT) else (0xff >> tp) & ch
+        codep = (
+            (ch & 0x3F) | (codep << 6) if (state != _UTF8_ACCEPT) else (0xFF >> tp) & ch
+        )
         state = _UTF8D[256 + state + tp]
 
         return state, codep
 
-    def _validate_utf8(utfbytes: str or bytes) -> bool:
+    def _validate_utf8(utfbytes: Union[str, bytes]) -> bool:
         state = _UTF8_ACCEPT
         codep = 0
         for i in utfbytes:
-            state, codep = _decode(state, codep, i)
+            state, codep = _decode(state, codep, int(i))
             if state == _UTF8_REJECT:
                 return False
 
         return True
 
 
-def validate_utf8(utfbytes: str or bytes) -> bool:
+def validate_utf8(utfbytes: Union[str, bytes]) -> bool:
     """
     validate utf8 byte string.
     utfbytes: utf byte string to check.
@@ -92,13 +446,14 @@ def validate_utf8(utfbytes: str or bytes) -> bool:
     return _validate_utf8(utfbytes)
 
 
-def extract_err_message(exception: Exception) -> str or None:
+def extract_err_message(exception: Exception) -> Union[str, None]:
     if exception.args:
-        return exception.args[0]
+        exception_message: str = exception.args[0]
+        return exception_message
     else:
         return None
 
 
-def extract_error_code(exception: Exception) -> int or None:
+def extract_error_code(exception: Exception) -> Union[int, None]:
     if exception.args and len(exception.args) > 1:
         return exception.args[0] if isinstance(exception.args[0], int) else None
diff --git a/lib/websocket/_wsdump.py b/lib/websocket/_wsdump.py
index d637ce2b..34c3d127 100644
--- a/lib/websocket/_wsdump.py
+++ b/lib/websocket/_wsdump.py
@@ -21,11 +21,11 @@ limitations under the License.
 
 import argparse
 import code
+import gzip
+import ssl
 import sys
 import threading
 import time
-import ssl
-import gzip
 import zlib
 from urllib.parse import urlparse
 
@@ -50,8 +50,13 @@ ENCODING = get_encoding()
 
 
 class VAction(argparse.Action):
-
-    def __call__(self, parser: argparse.Namespace, args: tuple, values: str, option_string: str = None) -> None:
+    def __call__(
+        self,
+        parser: argparse.Namespace,
+        args: tuple,
+        values: str,
+        option_string: str = None,
+    ) -> None:
         if values is None:
             values = "1"
         try:
@@ -63,36 +68,42 @@ class VAction(argparse.Action):
 
 def parse_args() -> argparse.Namespace:
     parser = argparse.ArgumentParser(description="WebSocket Simple Dump Tool")
-    parser.add_argument("url", metavar="ws_url",
-                        help="websocket url. ex. ws://echo.websocket.events/")
-    parser.add_argument("-p", "--proxy",
-                        help="proxy url. ex. http://127.0.0.1:8080")
-    parser.add_argument("-v", "--verbose", default=0, nargs='?', action=VAction,
-                        dest="verbose",
-                        help="set verbose mode. If set to 1, show opcode. "
-                        "If set to 2, enable to trace  websocket module")
-    parser.add_argument("-n", "--nocert", action='store_true',
-                        help="Ignore invalid SSL cert")
-    parser.add_argument("-r", "--raw", action="store_true",
-                        help="raw output")
-    parser.add_argument("-s", "--subprotocols", nargs='*',
-                        help="Set subprotocols")
-    parser.add_argument("-o", "--origin",
-                        help="Set origin")
-    parser.add_argument("--eof-wait", default=0, type=int,
-                        help="wait time(second) after 'EOF' received.")
-    parser.add_argument("-t", "--text",
-                        help="Send initial text")
-    parser.add_argument("--timings", action="store_true",
-                        help="Print timings in seconds")
-    parser.add_argument("--headers",
-                        help="Set custom headers. Use ',' as separator")
+    parser.add_argument(
+        "url", metavar="ws_url", help="websocket url. ex. ws://echo.websocket.events/"
+    )
+    parser.add_argument("-p", "--proxy", help="proxy url. ex. http://127.0.0.1:8080")
+    parser.add_argument(
+        "-v",
+        "--verbose",
+        default=0,
+        nargs="?",
+        action=VAction,
+        dest="verbose",
+        help="set verbose mode. If set to 1, show opcode. "
+        "If set to 2, enable to trace  websocket module",
+    )
+    parser.add_argument(
+        "-n", "--nocert", action="store_true", help="Ignore invalid SSL cert"
+    )
+    parser.add_argument("-r", "--raw", action="store_true", help="raw output")
+    parser.add_argument("-s", "--subprotocols", nargs="*", help="Set subprotocols")
+    parser.add_argument("-o", "--origin", help="Set origin")
+    parser.add_argument(
+        "--eof-wait",
+        default=0,
+        type=int,
+        help="wait time(second) after 'EOF' received.",
+    )
+    parser.add_argument("-t", "--text", help="Send initial text")
+    parser.add_argument(
+        "--timings", action="store_true", help="Print timings in seconds"
+    )
+    parser.add_argument("--headers", help="Set custom headers. Use ',' as separator")
 
     return parser.parse_args()
 
 
 class RawInput:
-
     def raw_input(self, prompt: str = "") -> str:
         line = input(prompt)
 
@@ -105,7 +116,6 @@ class RawInput:
 
 
 class InteractiveConsole(RawInput, code.InteractiveConsole):
-
     def write(self, data: str) -> None:
         sys.stdout.write("\033[2K\033[E")
         # sys.stdout.write("\n")
@@ -118,7 +128,6 @@ class InteractiveConsole(RawInput, code.InteractiveConsole):
 
 
 class NonInteractive(RawInput):
-
     def write(self, data: str) -> None:
         sys.stdout.write(data)
         sys.stdout.write("\n")
@@ -146,7 +155,7 @@ def main() -> None:
     if args.nocert:
         opts = {"cert_reqs": ssl.CERT_NONE, "check_hostname": False}
     if args.headers:
-        options['header'] = list(map(str.strip, args.headers.split(',')))
+        options["header"] = list(map(str.strip, args.headers.split(",")))
     ws = websocket.create_connection(args.url, sslopt=opts, **options)
     if args.raw:
         console = NonInteractive()
@@ -160,7 +169,7 @@ def main() -> None:
         except websocket.WebSocketException:
             return websocket.ABNF.OPCODE_CLOSE, ""
         if not frame:
-            raise websocket.WebSocketException("Not a valid frame {frame}".format(frame=frame))
+            raise websocket.WebSocketException(f"Not a valid frame {frame}")
         elif frame.opcode in OPCODE_DATA:
             return frame.opcode, frame.data
         elif frame.opcode == websocket.ABNF.OPCODE_CLOSE:
@@ -178,14 +187,18 @@ def main() -> None:
             msg = None
             if opcode == websocket.ABNF.OPCODE_TEXT and isinstance(data, bytes):
                 data = str(data, "utf-8")
-            if isinstance(data, bytes) and len(data) > 2 and data[:2] == b'\037\213':  # gzip magick
+            if (
+                isinstance(data, bytes) and len(data) > 2 and data[:2] == b"\037\213"
+            ):  # gzip magick
                 try:
                     data = "[gzip] " + str(gzip.decompress(data), "utf-8")
                 except:
                     pass
             elif isinstance(data, bytes):
                 try:
-                    data = "[zlib] " + str(zlib.decompress(data, -zlib.MAX_WBITS), "utf-8")
+                    data = "[zlib] " + str(
+                        zlib.decompress(data, -zlib.MAX_WBITS), "utf-8"
+                    )
                 except:
                     pass
 
@@ -193,13 +206,13 @@ def main() -> None:
                 data = repr(data)
 
             if args.verbose:
-                msg = "{opcode}: {data}".format(opcode=websocket.ABNF.OPCODE_MAP.get(opcode), data=data)
+                msg = f"{websocket.ABNF.OPCODE_MAP.get(opcode)}: {data}"
             else:
                 msg = data
 
             if msg is not None:
                 if args.timings:
-                    console.write(str(time.time() - start_time) + ": " + msg)
+                    console.write(f"{time.time() - start_time}: {msg}")
                 else:
                     console.write(msg)
 
diff --git a/lib/websocket/py.typed b/lib/websocket/py.typed
new file mode 100644
index 00000000..e69de29b
diff --git a/lib/websocket/tests/echo-server.py b/lib/websocket/tests/echo-server.py
index 42dd9e43..a32c6503 100644
--- a/lib/websocket/tests/echo-server.py
+++ b/lib/websocket/tests/echo-server.py
@@ -3,10 +3,11 @@
 # From https://github.com/aaugustin/websockets/blob/main/example/echo.py
 
 import asyncio
-import websockets
 import os
 
-LOCAL_WS_SERVER_PORT = int(os.environ.get('LOCAL_WS_SERVER_PORT', '8765'))
+import websockets
+
+LOCAL_WS_SERVER_PORT = int(os.environ.get("LOCAL_WS_SERVER_PORT", "8765"))
 
 
 async def echo(websocket, path):
@@ -18,4 +19,5 @@ async def main():
     async with websockets.serve(echo, "localhost", LOCAL_WS_SERVER_PORT):
         await asyncio.Future()  # run forever
 
+
 asyncio.run(main())
diff --git a/lib/websocket/tests/test_abnf.py b/lib/websocket/tests/test_abnf.py
index dbf9b636..df5bc6bd 100644
--- a/lib/websocket/tests/test_abnf.py
+++ b/lib/websocket/tests/test_abnf.py
@@ -1,8 +1,9 @@
 # -*- coding: utf-8 -*-
 #
+import unittest
+
 import websocket as ws
 from websocket._abnf import *
-import unittest
 
 """
 test_abnf.py
@@ -25,54 +26,89 @@ limitations under the License.
 
 
 class ABNFTest(unittest.TestCase):
-
     def testInit(self):
-        a = ABNF(0,0,0,0, opcode=ABNF.OPCODE_PING)
+        a = ABNF(0, 0, 0, 0, opcode=ABNF.OPCODE_PING)
         self.assertEqual(a.fin, 0)
         self.assertEqual(a.rsv1, 0)
         self.assertEqual(a.rsv2, 0)
         self.assertEqual(a.rsv3, 0)
         self.assertEqual(a.opcode, 9)
-        self.assertEqual(a.data, '')
-        a_bad = ABNF(0,1,0,0, opcode=77)
+        self.assertEqual(a.data, "")
+        a_bad = ABNF(0, 1, 0, 0, opcode=77)
         self.assertEqual(a_bad.rsv1, 1)
         self.assertEqual(a_bad.opcode, 77)
 
     def testValidate(self):
-        a_invalid_ping = ABNF(0,0,0,0, opcode=ABNF.OPCODE_PING)
-        self.assertRaises(ws._exceptions.WebSocketProtocolException, a_invalid_ping.validate, skip_utf8_validation=False)
-        a_bad_rsv_value = ABNF(0,1,0,0, opcode=ABNF.OPCODE_TEXT)
-        self.assertRaises(ws._exceptions.WebSocketProtocolException, a_bad_rsv_value.validate, skip_utf8_validation=False)
-        a_bad_opcode = ABNF(0,0,0,0, opcode=77)
-        self.assertRaises(ws._exceptions.WebSocketProtocolException, a_bad_opcode.validate, skip_utf8_validation=False)
-        a_bad_close_frame = ABNF(0,0,0,0, opcode=ABNF.OPCODE_CLOSE, data=b'\x01')
-        self.assertRaises(ws._exceptions.WebSocketProtocolException, a_bad_close_frame.validate, skip_utf8_validation=False)
-        a_bad_close_frame_2 = ABNF(0,0,0,0, opcode=ABNF.OPCODE_CLOSE, data=b'\x01\x8a\xaa\xff\xdd')
-        self.assertRaises(ws._exceptions.WebSocketProtocolException, a_bad_close_frame_2.validate, skip_utf8_validation=False)
-        a_bad_close_frame_3 = ABNF(0,0,0,0, opcode=ABNF.OPCODE_CLOSE, data=b'\x03\xe7')
-        self.assertRaises(ws._exceptions.WebSocketProtocolException, a_bad_close_frame_3.validate, skip_utf8_validation=True)
+        a_invalid_ping = ABNF(0, 0, 0, 0, opcode=ABNF.OPCODE_PING)
+        self.assertRaises(
+            ws._exceptions.WebSocketProtocolException,
+            a_invalid_ping.validate,
+            skip_utf8_validation=False,
+        )
+        a_bad_rsv_value = ABNF(0, 1, 0, 0, opcode=ABNF.OPCODE_TEXT)
+        self.assertRaises(
+            ws._exceptions.WebSocketProtocolException,
+            a_bad_rsv_value.validate,
+            skip_utf8_validation=False,
+        )
+        a_bad_opcode = ABNF(0, 0, 0, 0, opcode=77)
+        self.assertRaises(
+            ws._exceptions.WebSocketProtocolException,
+            a_bad_opcode.validate,
+            skip_utf8_validation=False,
+        )
+        a_bad_close_frame = ABNF(0, 0, 0, 0, opcode=ABNF.OPCODE_CLOSE, data=b"\x01")
+        self.assertRaises(
+            ws._exceptions.WebSocketProtocolException,
+            a_bad_close_frame.validate,
+            skip_utf8_validation=False,
+        )
+        a_bad_close_frame_2 = ABNF(
+            0, 0, 0, 0, opcode=ABNF.OPCODE_CLOSE, data=b"\x01\x8a\xaa\xff\xdd"
+        )
+        self.assertRaises(
+            ws._exceptions.WebSocketProtocolException,
+            a_bad_close_frame_2.validate,
+            skip_utf8_validation=False,
+        )
+        a_bad_close_frame_3 = ABNF(
+            0, 0, 0, 0, opcode=ABNF.OPCODE_CLOSE, data=b"\x03\xe7"
+        )
+        self.assertRaises(
+            ws._exceptions.WebSocketProtocolException,
+            a_bad_close_frame_3.validate,
+            skip_utf8_validation=True,
+        )
 
     def testMask(self):
-        abnf_none_data = ABNF(0,0,0,0, opcode=ABNF.OPCODE_PING, mask=1, data=None)
+        abnf_none_data = ABNF(
+            0, 0, 0, 0, opcode=ABNF.OPCODE_PING, mask_value=1, data=None
+        )
         bytes_val = b"aaaa"
         self.assertEqual(abnf_none_data._get_masked(bytes_val), bytes_val)
-        abnf_str_data = ABNF(0,0,0,0, opcode=ABNF.OPCODE_PING, mask=1, data="a")
-        self.assertEqual(abnf_str_data._get_masked(bytes_val), b'aaaa\x00')
+        abnf_str_data = ABNF(
+            0, 0, 0, 0, opcode=ABNF.OPCODE_PING, mask_value=1, data="a"
+        )
+        self.assertEqual(abnf_str_data._get_masked(bytes_val), b"aaaa\x00")
 
     def testFormat(self):
-        abnf_bad_rsv_bits = ABNF(2,0,0,0, opcode=ABNF.OPCODE_TEXT)
+        abnf_bad_rsv_bits = ABNF(2, 0, 0, 0, opcode=ABNF.OPCODE_TEXT)
         self.assertRaises(ValueError, abnf_bad_rsv_bits.format)
-        abnf_bad_opcode = ABNF(0,0,0,0, opcode=5)
+        abnf_bad_opcode = ABNF(0, 0, 0, 0, opcode=5)
         self.assertRaises(ValueError, abnf_bad_opcode.format)
-        abnf_length_10 = ABNF(0,0,0,0, opcode=ABNF.OPCODE_TEXT, data="abcdefghij")
-        self.assertEqual(b'\x01', abnf_length_10.format()[0].to_bytes(1, 'big'))
-        self.assertEqual(b'\x8a', abnf_length_10.format()[1].to_bytes(1, 'big'))
+        abnf_length_10 = ABNF(0, 0, 0, 0, opcode=ABNF.OPCODE_TEXT, data="abcdefghij")
+        self.assertEqual(b"\x01", abnf_length_10.format()[0].to_bytes(1, "big"))
+        self.assertEqual(b"\x8a", abnf_length_10.format()[1].to_bytes(1, "big"))
         self.assertEqual("fin=0 opcode=1 data=abcdefghij", abnf_length_10.__str__())
-        abnf_length_20 = ABNF(0,0,0,0, opcode=ABNF.OPCODE_BINARY, data="abcdefghijabcdefghij")
-        self.assertEqual(b'\x02', abnf_length_20.format()[0].to_bytes(1, 'big'))
-        self.assertEqual(b'\x94', abnf_length_20.format()[1].to_bytes(1, 'big'))
-        abnf_no_mask = ABNF(0,0,0,0, opcode=ABNF.OPCODE_TEXT, mask=0, data=b'\x01\x8a\xcc')
-        self.assertEqual(b'\x01\x03\x01\x8a\xcc', abnf_no_mask.format())
+        abnf_length_20 = ABNF(
+            0, 0, 0, 0, opcode=ABNF.OPCODE_BINARY, data="abcdefghijabcdefghij"
+        )
+        self.assertEqual(b"\x02", abnf_length_20.format()[0].to_bytes(1, "big"))
+        self.assertEqual(b"\x94", abnf_length_20.format()[1].to_bytes(1, "big"))
+        abnf_no_mask = ABNF(
+            0, 0, 0, 0, opcode=ABNF.OPCODE_TEXT, mask_value=0, data=b"\x01\x8a\xcc"
+        )
+        self.assertEqual(b"\x01\x03\x01\x8a\xcc", abnf_no_mask.format())
 
     def testFrameBuffer(self):
         fb = frame_buffer(0, True)
@@ -81,7 +117,7 @@ class ABNFTest(unittest.TestCase):
         fb.clear
         self.assertEqual(fb.header, None)
         self.assertEqual(fb.length, None)
-        self.assertEqual(fb.mask, None)
+        self.assertEqual(fb.mask_value, None)
         self.assertEqual(fb.has_mask(), False)
 
 
diff --git a/lib/websocket/tests/test_app.py b/lib/websocket/tests/test_app.py
index ff90a0aa..5ed9a22e 100644
--- a/lib/websocket/tests/test_app.py
+++ b/lib/websocket/tests/test_app.py
@@ -2,11 +2,12 @@
 #
 import os
 import os.path
-import threading
-import websocket as ws
 import ssl
+import threading
 import unittest
 
+import websocket as ws
+
 """
 test_app.py
 websocket - WebSocket client library for Python
@@ -27,18 +28,16 @@ limitations under the License.
 """
 
 # Skip test to access the internet unless TEST_WITH_INTERNET == 1
-TEST_WITH_INTERNET = os.environ.get('TEST_WITH_INTERNET', '0') == '1'
+TEST_WITH_INTERNET = os.environ.get("TEST_WITH_INTERNET", "0") == "1"
 # Skip tests relying on local websockets server unless LOCAL_WS_SERVER_PORT != -1
-LOCAL_WS_SERVER_PORT = os.environ.get('LOCAL_WS_SERVER_PORT', '-1')
-TEST_WITH_LOCAL_SERVER = LOCAL_WS_SERVER_PORT != '-1'
+LOCAL_WS_SERVER_PORT = os.environ.get("LOCAL_WS_SERVER_PORT", "-1")
+TEST_WITH_LOCAL_SERVER = LOCAL_WS_SERVER_PORT != "-1"
 TRACEABLE = True
 
 
 class WebSocketAppTest(unittest.TestCase):
-
     class NotSetYet:
-        """ A marker class for signalling that a value hasn't been set yet.
-        """
+        """A marker class for signalling that a value hasn't been set yet."""
 
     def setUp(self):
         ws.enableTrace(TRACEABLE)
@@ -54,14 +53,16 @@ class WebSocketAppTest(unittest.TestCase):
         WebSocketAppTest.get_mask_key_id = WebSocketAppTest.NotSetYet()
         WebSocketAppTest.on_error_data = WebSocketAppTest.NotSetYet()
 
-    @unittest.skipUnless(TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled")
+    @unittest.skipUnless(
+        TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled"
+    )
     def testKeepRunning(self):
-        """ A WebSocketApp should keep running as long as its self.keep_running
+        """A WebSocketApp should keep running as long as its self.keep_running
         is not False (in the boolean context).
         """
 
         def on_open(self, *args, **kwargs):
-            """ Set the keep_running flag for later inspection and immediately
+            """Set the keep_running flag for later inspection and immediately
             close the connection.
             """
             self.send("hello!")
@@ -73,23 +74,26 @@ class WebSocketAppTest(unittest.TestCase):
             self.close()
 
         def on_close(self, *args, **kwargs):
-            """ Set the keep_running flag for the test to use.
-            """
+            """Set the keep_running flag for the test to use."""
             WebSocketAppTest.keep_running_close = self.keep_running
 
-        app = ws.WebSocketApp('ws://127.0.0.1:' + LOCAL_WS_SERVER_PORT, on_open=on_open, on_close=on_close, on_message=on_message)
+        app = ws.WebSocketApp(
+            f"ws://127.0.0.1:{LOCAL_WS_SERVER_PORT}",
+            on_open=on_open,
+            on_close=on_close,
+            on_message=on_message,
+        )
         app.run_forever()
 
-#    @unittest.skipUnless(TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled")
+    #    @unittest.skipUnless(TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled")
     @unittest.skipUnless(False, "Test disabled for now (requires rel)")
     def testRunForeverDispatcher(self):
-        """ A WebSocketApp should keep running as long as its self.keep_running
+        """A WebSocketApp should keep running as long as its self.keep_running
         is not False (in the boolean context).
         """
 
         def on_open(self, *args, **kwargs):
-            """ Send a message, receive, and send one more
-            """
+            """Send a message, receive, and send one more"""
             self.send("hello!")
             self.recv()
             self.send("goodbye!")
@@ -98,30 +102,38 @@ class WebSocketAppTest(unittest.TestCase):
             print(message)
             self.close()
 
-        app = ws.WebSocketApp('ws://127.0.0.1:' + LOCAL_WS_SERVER_PORT, on_open=on_open, on_message=on_message)
+        app = ws.WebSocketApp(
+            f"ws://127.0.0.1:{LOCAL_WS_SERVER_PORT}",
+            on_open=on_open,
+            on_message=on_message,
+        )
         app.run_forever(dispatcher="Dispatcher")  # doesn't work
-#        app.run_forever(dispatcher=rel)          # would work
-#        rel.dispatch()
 
-    @unittest.skipUnless(TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled")
+    #        app.run_forever(dispatcher=rel)          # would work
+    #        rel.dispatch()
+
+    @unittest.skipUnless(
+        TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled"
+    )
     def testRunForeverTeardownCleanExit(self):
-        """ The WebSocketApp.run_forever() method should return `False` when the application ends gracefully.
-        """
-        app = ws.WebSocketApp('ws://127.0.0.1:' + LOCAL_WS_SERVER_PORT)
+        """The WebSocketApp.run_forever() method should return `False` when the application ends gracefully."""
+        app = ws.WebSocketApp(f"ws://127.0.0.1:{LOCAL_WS_SERVER_PORT}")
         threading.Timer(interval=0.2, function=app.close).start()
         teardown = app.run_forever()
         self.assertEqual(teardown, False)
 
     @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled")
     def testSockMaskKey(self):
-        """ A WebSocketApp should forward the received mask_key function down
+        """A WebSocketApp should forward the received mask_key function down
         to the actual socket.
         """
 
         def my_mask_key_func():
             return "\x00\x00\x00\x00"
 
-        app = ws.WebSocketApp('wss://api-pub.bitfinex.com/ws/1', get_mask_key=my_mask_key_func)
+        app = ws.WebSocketApp(
+            "wss://api-pub.bitfinex.com/ws/1", get_mask_key=my_mask_key_func
+        )
 
         # if numpy is installed, this assertion fail
         # Note: We can't use 'is' for comparing the functions directly, need to use 'id'.
@@ -129,8 +141,7 @@ class WebSocketAppTest(unittest.TestCase):
 
     @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled")
     def testInvalidPingIntervalPingTimeout(self):
-        """ Test exception handling if ping_interval < ping_timeout
-        """
+        """Test exception handling if ping_interval < ping_timeout"""
 
         def on_ping(app, msg):
             print("Got a ping!")
@@ -140,13 +151,20 @@ class WebSocketAppTest(unittest.TestCase):
             print("Got a pong! No need to respond")
             app.close()
 
-        app = ws.WebSocketApp('wss://api-pub.bitfinex.com/ws/1', on_ping=on_ping, on_pong=on_pong)
-        self.assertRaises(ws.WebSocketException, app.run_forever, ping_interval=1, ping_timeout=2, sslopt={"cert_reqs": ssl.CERT_NONE})
+        app = ws.WebSocketApp(
+            "wss://api-pub.bitfinex.com/ws/1", on_ping=on_ping, on_pong=on_pong
+        )
+        self.assertRaises(
+            ws.WebSocketException,
+            app.run_forever,
+            ping_interval=1,
+            ping_timeout=2,
+            sslopt={"cert_reqs": ssl.CERT_NONE},
+        )
 
     @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled")
     def testPingInterval(self):
-        """ Test WebSocketApp proper ping functionality
-        """
+        """Test WebSocketApp proper ping functionality"""
 
         def on_ping(app, msg):
             print("Got a ping!")
@@ -156,15 +174,18 @@ class WebSocketAppTest(unittest.TestCase):
             print("Got a pong! No need to respond")
             app.close()
 
-        app = ws.WebSocketApp('wss://api-pub.bitfinex.com/ws/1', on_ping=on_ping, on_pong=on_pong)
-        app.run_forever(ping_interval=2, ping_timeout=1, sslopt={"cert_reqs": ssl.CERT_NONE})
+        app = ws.WebSocketApp(
+            "wss://api-pub.bitfinex.com/ws/1", on_ping=on_ping, on_pong=on_pong
+        )
+        app.run_forever(
+            ping_interval=2, ping_timeout=1, sslopt={"cert_reqs": ssl.CERT_NONE}
+        )
 
     @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled")
     def testOpcodeClose(self):
-        """ Test WebSocketApp close opcode
-        """
+        """Test WebSocketApp close opcode"""
 
-        app = ws.WebSocketApp('wss://tsock.us1.twilio.com/v3/wsconnect')
+        app = ws.WebSocketApp("wss://tsock.us1.twilio.com/v3/wsconnect")
         app.run_forever(ping_interval=2, ping_timeout=1, ping_payload="Ping payload")
 
     # This is commented out because the URL no longer responds in the expected way
@@ -177,41 +198,59 @@ class WebSocketAppTest(unittest.TestCase):
 
     @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled")
     def testBadPingInterval(self):
-        """ A WebSocketApp handling of negative ping_interval
-        """
-        app = ws.WebSocketApp('wss://api-pub.bitfinex.com/ws/1')
-        self.assertRaises(ws.WebSocketException, app.run_forever, ping_interval=-5, sslopt={"cert_reqs": ssl.CERT_NONE})
+        """A WebSocketApp handling of negative ping_interval"""
+        app = ws.WebSocketApp("wss://api-pub.bitfinex.com/ws/1")
+        self.assertRaises(
+            ws.WebSocketException,
+            app.run_forever,
+            ping_interval=-5,
+            sslopt={"cert_reqs": ssl.CERT_NONE},
+        )
 
     @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled")
     def testBadPingTimeout(self):
-        """ A WebSocketApp handling of negative ping_timeout
-        """
-        app = ws.WebSocketApp('wss://api-pub.bitfinex.com/ws/1')
-        self.assertRaises(ws.WebSocketException, app.run_forever, ping_timeout=-3, sslopt={"cert_reqs": ssl.CERT_NONE})
+        """A WebSocketApp handling of negative ping_timeout"""
+        app = ws.WebSocketApp("wss://api-pub.bitfinex.com/ws/1")
+        self.assertRaises(
+            ws.WebSocketException,
+            app.run_forever,
+            ping_timeout=-3,
+            sslopt={"cert_reqs": ssl.CERT_NONE},
+        )
 
     @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled")
     def testCloseStatusCode(self):
-        """ Test extraction of close frame status code and close reason in WebSocketApp
-        """
+        """Test extraction of close frame status code and close reason in WebSocketApp"""
+
         def on_close(wsapp, close_status_code, close_msg):
             print("on_close reached")
 
-        app = ws.WebSocketApp('wss://tsock.us1.twilio.com/v3/wsconnect', on_close=on_close)
-        closeframe = ws.ABNF(opcode=ws.ABNF.OPCODE_CLOSE, data=b'\x03\xe8no-init-from-client')
-        self.assertEqual([1000, 'no-init-from-client'], app._get_close_args(closeframe))
+        app = ws.WebSocketApp(
+            "wss://tsock.us1.twilio.com/v3/wsconnect", on_close=on_close
+        )
+        closeframe = ws.ABNF(
+            opcode=ws.ABNF.OPCODE_CLOSE, data=b"\x03\xe8no-init-from-client"
+        )
+        self.assertEqual([1000, "no-init-from-client"], app._get_close_args(closeframe))
 
-        closeframe = ws.ABNF(opcode=ws.ABNF.OPCODE_CLOSE, data=b'')
+        closeframe = ws.ABNF(opcode=ws.ABNF.OPCODE_CLOSE, data=b"")
         self.assertEqual([None, None], app._get_close_args(closeframe))
 
-        app2 = ws.WebSocketApp('wss://tsock.us1.twilio.com/v3/wsconnect')
-        closeframe = ws.ABNF(opcode=ws.ABNF.OPCODE_CLOSE, data=b'')
+        app2 = ws.WebSocketApp("wss://tsock.us1.twilio.com/v3/wsconnect")
+        closeframe = ws.ABNF(opcode=ws.ABNF.OPCODE_CLOSE, data=b"")
         self.assertEqual([None, None], app2._get_close_args(closeframe))
 
-        self.assertRaises(ws.WebSocketConnectionClosedException, app.send, data="test if connection is closed")
+        self.assertRaises(
+            ws.WebSocketConnectionClosedException,
+            app.send,
+            data="test if connection is closed",
+        )
 
-    @unittest.skipUnless(TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled")
+    @unittest.skipUnless(
+        TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled"
+    )
     def testCallbackFunctionException(self):
-        """ Test callback function exception handling """
+        """Test callback function exception handling"""
 
         exc = None
         passed_app = None
@@ -228,26 +267,33 @@ class WebSocketAppTest(unittest.TestCase):
         def on_pong(app, msg):
             app.close()
 
-        app = ws.WebSocketApp('ws://127.0.0.1:' + LOCAL_WS_SERVER_PORT, on_open=on_open, on_error=on_error, on_pong=on_pong)
+        app = ws.WebSocketApp(
+            f"ws://127.0.0.1:{LOCAL_WS_SERVER_PORT}",
+            on_open=on_open,
+            on_error=on_error,
+            on_pong=on_pong,
+        )
         app.run_forever(ping_interval=2, ping_timeout=1)
 
         self.assertEqual(passed_app, app)
         self.assertIsInstance(exc, RuntimeError)
         self.assertEqual(str(exc), "Callback failed")
 
-    @unittest.skipUnless(TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled")
+    @unittest.skipUnless(
+        TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled"
+    )
     def testCallbackMethodException(self):
-        """ Test callback method exception handling """
+        """Test callback method exception handling"""
 
         class Callbacks:
             def __init__(self):
                 self.exc = None
                 self.passed_app = None
                 self.app = ws.WebSocketApp(
-                    'ws://127.0.0.1:' + LOCAL_WS_SERVER_PORT,
+                    f"ws://127.0.0.1:{LOCAL_WS_SERVER_PORT}",
                     on_open=self.on_open,
                     on_error=self.on_error,
-                    on_pong=self.on_pong
+                    on_pong=self.on_pong,
                 )
                 self.app.run_forever(ping_interval=2, ping_timeout=1)
 
@@ -267,9 +313,11 @@ class WebSocketAppTest(unittest.TestCase):
         self.assertIsInstance(callbacks.exc, RuntimeError)
         self.assertEqual(str(callbacks.exc), "Callback failed")
 
-    @unittest.skipUnless(TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled")
+    @unittest.skipUnless(
+        TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled"
+    )
     def testReconnect(self):
-        """ Test reconnect """
+        """Test reconnect"""
         pong_count = 0
         exc = None
 
@@ -287,7 +335,9 @@ class WebSocketAppTest(unittest.TestCase):
                 # Got second pong after reconnect
                 app.close()
 
-        app = ws.WebSocketApp('ws://127.0.0.1:' + LOCAL_WS_SERVER_PORT, on_pong=on_pong, on_error=on_error)
+        app = ws.WebSocketApp(
+            f"ws://127.0.0.1:{LOCAL_WS_SERVER_PORT}", on_pong=on_pong, on_error=on_error
+        )
         app.run_forever(ping_interval=2, ping_timeout=1, reconnect=3)
 
         self.assertEqual(pong_count, 2)
diff --git a/lib/websocket/tests/test_cookiejar.py b/lib/websocket/tests/test_cookiejar.py
index 8f835e9e..0de87517 100644
--- a/lib/websocket/tests/test_cookiejar.py
+++ b/lib/websocket/tests/test_cookiejar.py
@@ -1,4 +1,5 @@
 import unittest
+
 from websocket._cookiejar import SimpleCookieJar
 
 """
@@ -25,11 +26,15 @@ class CookieJarTest(unittest.TestCase):
     def testAdd(self):
         cookie_jar = SimpleCookieJar()
         cookie_jar.add("")
-        self.assertFalse(cookie_jar.jar, "Cookie with no domain should not be added to the jar")
+        self.assertFalse(
+            cookie_jar.jar, "Cookie with no domain should not be added to the jar"
+        )
 
         cookie_jar = SimpleCookieJar()
         cookie_jar.add("a=b")
-        self.assertFalse(cookie_jar.jar, "Cookie with no domain should not be added to the jar")
+        self.assertFalse(
+            cookie_jar.jar, "Cookie with no domain should not be added to the jar"
+        )
 
         cookie_jar = SimpleCookieJar()
         cookie_jar.add("a=b; domain=.abc")
@@ -65,7 +70,9 @@ class CookieJarTest(unittest.TestCase):
     def testSet(self):
         cookie_jar = SimpleCookieJar()
         cookie_jar.set("a=b")
-        self.assertFalse(cookie_jar.jar, "Cookie with no domain should not be added to the jar")
+        self.assertFalse(
+            cookie_jar.jar, "Cookie with no domain should not be added to the jar"
+        )
 
         cookie_jar = SimpleCookieJar()
         cookie_jar.set("a=b; domain=.abc")
diff --git a/lib/websocket/tests/test_http.py b/lib/websocket/tests/test_http.py
index d7de29d3..0d6031a3 100644
--- a/lib/websocket/tests/test_http.py
+++ b/lib/websocket/tests/test_http.py
@@ -2,12 +2,20 @@
 #
 import os
 import os.path
-import websocket as ws
-from websocket._http import proxy_info, read_headers, _start_proxied_socket, _tunnel, _get_addrinfo_list, connect
-import unittest
-import ssl
-import websocket
 import socket
+import ssl
+import unittest
+
+import websocket
+import websocket as ws
+from websocket._http import (
+    _get_addrinfo_list,
+    _start_proxied_socket,
+    _tunnel,
+    connect,
+    proxy_info,
+    read_headers,
+)
 
 """
 test_http.py
@@ -29,16 +37,16 @@ limitations under the License.
 """
 
 try:
-    from python_socks._errors import ProxyError, ProxyTimeoutError, ProxyConnectionError
+    from python_socks._errors import ProxyConnectionError, ProxyError, ProxyTimeoutError
 except:
-    from websocket._http import ProxyError, ProxyTimeoutError, ProxyConnectionError
+    from websocket._http import ProxyConnectionError, ProxyError, ProxyTimeoutError
 
 # Skip test to access the internet unless TEST_WITH_INTERNET == 1
-TEST_WITH_INTERNET = os.environ.get('TEST_WITH_INTERNET', '0') == '1'
-TEST_WITH_PROXY = os.environ.get('TEST_WITH_PROXY', '0') == '1'
+TEST_WITH_INTERNET = os.environ.get("TEST_WITH_INTERNET", "0") == "1"
+TEST_WITH_PROXY = os.environ.get("TEST_WITH_PROXY", "0") == "1"
 # Skip tests relying on local websockets server unless LOCAL_WS_SERVER_PORT != -1
-LOCAL_WS_SERVER_PORT = os.environ.get('LOCAL_WS_SERVER_PORT', '-1')
-TEST_WITH_LOCAL_SERVER = LOCAL_WS_SERVER_PORT != '-1'
+LOCAL_WS_SERVER_PORT = os.environ.get("LOCAL_WS_SERVER_PORT", "-1")
+TEST_WITH_LOCAL_SERVER = LOCAL_WS_SERVER_PORT != "-1"
 
 
 class SockMock:
@@ -70,7 +78,6 @@ class SockMock:
 
 
 class HeaderSockMock(SockMock):
-
     def __init__(self, fname):
         SockMock.__init__(self)
         path = os.path.join(os.path.dirname(__file__), fname)
@@ -78,8 +85,7 @@ class HeaderSockMock(SockMock):
             self.add_packet(f.read())
 
 
-class OptsList():
-
+class OptsList:
     def __init__(self):
         self.timeout = 1
         self.sockopt = []
@@ -87,17 +93,34 @@ class OptsList():
 
 
 class HttpTest(unittest.TestCase):
-
     def testReadHeader(self):
-        status, header, status_message = read_headers(HeaderSockMock("data/header01.txt"))
+        status, header, status_message = read_headers(
+            HeaderSockMock("data/header01.txt")
+        )
         self.assertEqual(status, 101)
         self.assertEqual(header["connection"], "Upgrade")
         # header02.txt is intentionally malformed
-        self.assertRaises(ws.WebSocketException, read_headers, HeaderSockMock("data/header02.txt"))
+        self.assertRaises(
+            ws.WebSocketException, read_headers, HeaderSockMock("data/header02.txt")
+        )
 
     def testTunnel(self):
-        self.assertRaises(ws.WebSocketProxyException, _tunnel, HeaderSockMock("data/header01.txt"), "example.com", 80, ("username", "password"))
-        self.assertRaises(ws.WebSocketProxyException, _tunnel, HeaderSockMock("data/header02.txt"), "example.com", 80, ("username", "password"))
+        self.assertRaises(
+            ws.WebSocketProxyException,
+            _tunnel,
+            HeaderSockMock("data/header01.txt"),
+            "example.com",
+            80,
+            ("username", "password"),
+        )
+        self.assertRaises(
+            ws.WebSocketProxyException,
+            _tunnel,
+            HeaderSockMock("data/header02.txt"),
+            "example.com",
+            80,
+            ("username", "password"),
+        )
 
     @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled")
     def testConnect(self):
@@ -105,34 +128,164 @@ class HttpTest(unittest.TestCase):
         if ws._http.HAVE_PYTHON_SOCKS:
             # Need this check, otherwise case where python_socks is not installed triggers
             # websocket._exceptions.WebSocketException: Python Socks is needed for SOCKS proxying but is not available
-            self.assertRaises((ProxyTimeoutError, OSError), _start_proxied_socket, "wss://example.com", OptsList(), proxy_info(http_proxy_host="example.com", http_proxy_port="8080", proxy_type="socks4", http_proxy_timeout=1))
-            self.assertRaises((ProxyTimeoutError, OSError), _start_proxied_socket, "wss://example.com", OptsList(), proxy_info(http_proxy_host="example.com", http_proxy_port="8080", proxy_type="socks4a", http_proxy_timeout=1))
-            self.assertRaises((ProxyTimeoutError, OSError), _start_proxied_socket, "wss://example.com", OptsList(), proxy_info(http_proxy_host="example.com", http_proxy_port="8080", proxy_type="socks5", http_proxy_timeout=1))
-            self.assertRaises((ProxyTimeoutError, OSError), _start_proxied_socket, "wss://example.com", OptsList(), proxy_info(http_proxy_host="example.com", http_proxy_port="8080", proxy_type="socks5h", http_proxy_timeout=1))
-            self.assertRaises(ProxyConnectionError, connect, "wss://example.com", OptsList(), proxy_info(http_proxy_host="127.0.0.1", http_proxy_port=9999, proxy_type="socks4", http_proxy_timeout=1), None)
+            self.assertRaises(
+                (ProxyTimeoutError, OSError),
+                _start_proxied_socket,
+                "wss://example.com",
+                OptsList(),
+                proxy_info(
+                    http_proxy_host="example.com",
+                    http_proxy_port="8080",
+                    proxy_type="socks4",
+                    http_proxy_timeout=1,
+                ),
+            )
+            self.assertRaises(
+                (ProxyTimeoutError, OSError),
+                _start_proxied_socket,
+                "wss://example.com",
+                OptsList(),
+                proxy_info(
+                    http_proxy_host="example.com",
+                    http_proxy_port="8080",
+                    proxy_type="socks4a",
+                    http_proxy_timeout=1,
+                ),
+            )
+            self.assertRaises(
+                (ProxyTimeoutError, OSError),
+                _start_proxied_socket,
+                "wss://example.com",
+                OptsList(),
+                proxy_info(
+                    http_proxy_host="example.com",
+                    http_proxy_port="8080",
+                    proxy_type="socks5",
+                    http_proxy_timeout=1,
+                ),
+            )
+            self.assertRaises(
+                (ProxyTimeoutError, OSError),
+                _start_proxied_socket,
+                "wss://example.com",
+                OptsList(),
+                proxy_info(
+                    http_proxy_host="example.com",
+                    http_proxy_port="8080",
+                    proxy_type="socks5h",
+                    http_proxy_timeout=1,
+                ),
+            )
+            self.assertRaises(
+                ProxyConnectionError,
+                connect,
+                "wss://example.com",
+                OptsList(),
+                proxy_info(
+                    http_proxy_host="127.0.0.1",
+                    http_proxy_port=9999,
+                    proxy_type="socks4",
+                    http_proxy_timeout=1,
+                ),
+                None,
+            )
 
-        self.assertRaises(TypeError, _get_addrinfo_list, None, 80, True, proxy_info(http_proxy_host="127.0.0.1", http_proxy_port="9999", proxy_type="http"))
-        self.assertRaises(TypeError, _get_addrinfo_list, None, 80, True, proxy_info(http_proxy_host="127.0.0.1", http_proxy_port="9999", proxy_type="http"))
-        self.assertRaises(socket.timeout, connect, "wss://google.com", OptsList(), proxy_info(http_proxy_host="8.8.8.8", http_proxy_port=9999, proxy_type="http", http_proxy_timeout=1), None)
+        self.assertRaises(
+            TypeError,
+            _get_addrinfo_list,
+            None,
+            80,
+            True,
+            proxy_info(
+                http_proxy_host="127.0.0.1", http_proxy_port="9999", proxy_type="http"
+            ),
+        )
+        self.assertRaises(
+            TypeError,
+            _get_addrinfo_list,
+            None,
+            80,
+            True,
+            proxy_info(
+                http_proxy_host="127.0.0.1", http_proxy_port="9999", proxy_type="http"
+            ),
+        )
+        self.assertRaises(
+            socket.timeout,
+            connect,
+            "wss://google.com",
+            OptsList(),
+            proxy_info(
+                http_proxy_host="8.8.8.8",
+                http_proxy_port=9999,
+                proxy_type="http",
+                http_proxy_timeout=1,
+            ),
+            None,
+        )
         self.assertEqual(
-            connect("wss://google.com", OptsList(), proxy_info(http_proxy_host="8.8.8.8", http_proxy_port=8080, proxy_type="http"), True),
-            (True, ("google.com", 443, "/")))
+            connect(
+                "wss://google.com",
+                OptsList(),
+                proxy_info(
+                    http_proxy_host="8.8.8.8", http_proxy_port=8080, proxy_type="http"
+                ),
+                True,
+            ),
+            (True, ("google.com", 443, "/")),
+        )
         # The following test fails on Mac OS with a gaierror, not an OverflowError
         # self.assertRaises(OverflowError, connect, "wss://example.com", OptsList(), proxy_info(http_proxy_host="127.0.0.1", http_proxy_port=99999, proxy_type="socks4", timeout=2), False)
 
     @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled")
-    @unittest.skipUnless(TEST_WITH_PROXY, "This test requires a HTTP proxy to be running on port 8899")
-    @unittest.skipUnless(TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled")
+    @unittest.skipUnless(
+        TEST_WITH_PROXY, "This test requires a HTTP proxy to be running on port 8899"
+    )
+    @unittest.skipUnless(
+        TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled"
+    )
     def testProxyConnect(self):
         ws = websocket.WebSocket()
-        ws.connect("ws://127.0.0.1:" + LOCAL_WS_SERVER_PORT, http_proxy_host="127.0.0.1", http_proxy_port="8899", proxy_type="http")
+        ws.connect(
+            f"ws://127.0.0.1:{LOCAL_WS_SERVER_PORT}",
+            http_proxy_host="127.0.0.1",
+            http_proxy_port="8899",
+            proxy_type="http",
+        )
         ws.send("Hello, Server")
         server_response = ws.recv()
         self.assertEqual(server_response, "Hello, Server")
         # self.assertEqual(_start_proxied_socket("wss://api.bitfinex.com/ws/2", OptsList(), proxy_info(http_proxy_host="127.0.0.1", http_proxy_port="8899", proxy_type="http"))[1], ("api.bitfinex.com", 443, '/ws/2'))
-        self.assertEqual(_get_addrinfo_list("api.bitfinex.com", 443, True, proxy_info(http_proxy_host="127.0.0.1", http_proxy_port="8899", proxy_type="http")),
-                         (socket.getaddrinfo("127.0.0.1", 8899, 0, socket.SOCK_STREAM, socket.SOL_TCP), True, None))
-        self.assertEqual(connect("wss://api.bitfinex.com/ws/2", OptsList(), proxy_info(http_proxy_host="127.0.0.1", http_proxy_port=8899, proxy_type="http"), None)[1], ("api.bitfinex.com", 443, '/ws/2'))
+        self.assertEqual(
+            _get_addrinfo_list(
+                "api.bitfinex.com",
+                443,
+                True,
+                proxy_info(
+                    http_proxy_host="127.0.0.1",
+                    http_proxy_port="8899",
+                    proxy_type="http",
+                ),
+            ),
+            (
+                socket.getaddrinfo(
+                    "127.0.0.1", 8899, 0, socket.SOCK_STREAM, socket.SOL_TCP
+                ),
+                True,
+                None,
+            ),
+        )
+        self.assertEqual(
+            connect(
+                "wss://api.bitfinex.com/ws/2",
+                OptsList(),
+                proxy_info(
+                    http_proxy_host="127.0.0.1", http_proxy_port=8899, proxy_type="http"
+                ),
+                None,
+            )[1],
+            ("api.bitfinex.com", 443, "/ws/2"),
+        )
         # TODO: Test SOCKS4 and SOCK5 proxies with unit tests
 
     @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled")
@@ -151,7 +304,7 @@ class HttpTest(unittest.TestCase):
                         DHE-RSA-AES256-SHA256:ECDHE-ECDSA-AES128-SHA256:\
                         ECDHE-RSA-AES128-SHA256:DHE-RSA-AES128-SHA256:\
                         ECDHE-ECDSA-AES256-SHA:ECDHE-RSA-AES256-SHA",
-            "ecdh_curve": "prime256v1"
+            "ecdh_curve": "prime256v1",
         }
         ws_ssl1 = websocket.WebSocket(sslopt=ssloptions)
         ws_ssl1.connect("wss://api.bitfinex.com/ws/2")
@@ -163,13 +316,55 @@ class HttpTest(unittest.TestCase):
         ws_ssl2.close
 
     def testProxyInfo(self):
-        self.assertEqual(proxy_info(http_proxy_host="127.0.0.1", http_proxy_port="8080", proxy_type="http").proxy_protocol, "http")
-        self.assertRaises(ProxyError, proxy_info, http_proxy_host="127.0.0.1", http_proxy_port="8080", proxy_type="badval")
-        self.assertEqual(proxy_info(http_proxy_host="example.com", http_proxy_port="8080", proxy_type="http").proxy_host, "example.com")
-        self.assertEqual(proxy_info(http_proxy_host="127.0.0.1", http_proxy_port="8080", proxy_type="http").proxy_port, "8080")
-        self.assertEqual(proxy_info(http_proxy_host="127.0.0.1", http_proxy_port="8080", proxy_type="http").auth, None)
-        self.assertEqual(proxy_info(http_proxy_host="127.0.0.1", http_proxy_port="8080", proxy_type="http", http_proxy_auth=("my_username123", "my_pass321")).auth[0], "my_username123")
-        self.assertEqual(proxy_info(http_proxy_host="127.0.0.1", http_proxy_port="8080", proxy_type="http", http_proxy_auth=("my_username123", "my_pass321")).auth[1], "my_pass321")
+        self.assertEqual(
+            proxy_info(
+                http_proxy_host="127.0.0.1", http_proxy_port="8080", proxy_type="http"
+            ).proxy_protocol,
+            "http",
+        )
+        self.assertRaises(
+            ProxyError,
+            proxy_info,
+            http_proxy_host="127.0.0.1",
+            http_proxy_port="8080",
+            proxy_type="badval",
+        )
+        self.assertEqual(
+            proxy_info(
+                http_proxy_host="example.com", http_proxy_port="8080", proxy_type="http"
+            ).proxy_host,
+            "example.com",
+        )
+        self.assertEqual(
+            proxy_info(
+                http_proxy_host="127.0.0.1", http_proxy_port="8080", proxy_type="http"
+            ).proxy_port,
+            "8080",
+        )
+        self.assertEqual(
+            proxy_info(
+                http_proxy_host="127.0.0.1", http_proxy_port="8080", proxy_type="http"
+            ).auth,
+            None,
+        )
+        self.assertEqual(
+            proxy_info(
+                http_proxy_host="127.0.0.1",
+                http_proxy_port="8080",
+                proxy_type="http",
+                http_proxy_auth=("my_username123", "my_pass321"),
+            ).auth[0],
+            "my_username123",
+        )
+        self.assertEqual(
+            proxy_info(
+                http_proxy_host="127.0.0.1",
+                http_proxy_port="8080",
+                proxy_type="http",
+                http_proxy_auth=("my_username123", "my_pass321"),
+            ).auth[1],
+            "my_pass321",
+        )
 
 
 if __name__ == "__main__":
diff --git a/lib/websocket/tests/test_url.py b/lib/websocket/tests/test_url.py
index a74dd766..792399eb 100644
--- a/lib/websocket/tests/test_url.py
+++ b/lib/websocket/tests/test_url.py
@@ -2,7 +2,13 @@
 #
 import os
 import unittest
-from websocket._url import get_proxy_info, parse_url, _is_address_in_network, _is_no_proxy_host
+
+from websocket._url import (
+    _is_address_in_network,
+    _is_no_proxy_host,
+    get_proxy_info,
+    parse_url,
+)
 
 """
 test_url.py
@@ -25,11 +31,10 @@ limitations under the License.
 
 
 class UrlTest(unittest.TestCase):
-
     def test_address_in_network(self):
-        self.assertTrue(_is_address_in_network('127.0.0.1', '127.0.0.0/8'))
-        self.assertTrue(_is_address_in_network('127.1.0.1', '127.0.0.0/8'))
-        self.assertFalse(_is_address_in_network('127.1.0.1', '127.0.0.0/24'))
+        self.assertTrue(_is_address_in_network("127.0.0.1", "127.0.0.0/8"))
+        self.assertTrue(_is_address_in_network("127.1.0.1", "127.0.0.0/8"))
+        self.assertFalse(_is_address_in_network("127.1.0.1", "127.0.0.0/24"))
 
     def testParseUrl(self):
         p = parse_url("ws://www.example.com/r")
@@ -126,57 +131,71 @@ class IsNoProxyHostTest(unittest.TestCase):
             del os.environ["no_proxy"]
 
     def testMatchAll(self):
-        self.assertTrue(_is_no_proxy_host("any.websocket.org", ['*']))
-        self.assertTrue(_is_no_proxy_host("192.168.0.1", ['*']))
-        self.assertTrue(_is_no_proxy_host("any.websocket.org", ['other.websocket.org', '*']))
-        os.environ['no_proxy'] = '*'
+        self.assertTrue(_is_no_proxy_host("any.websocket.org", ["*"]))
+        self.assertTrue(_is_no_proxy_host("192.168.0.1", ["*"]))
+        self.assertTrue(
+            _is_no_proxy_host("any.websocket.org", ["other.websocket.org", "*"])
+        )
+        os.environ["no_proxy"] = "*"
         self.assertTrue(_is_no_proxy_host("any.websocket.org", None))
         self.assertTrue(_is_no_proxy_host("192.168.0.1", None))
-        os.environ['no_proxy'] = 'other.websocket.org, *'
+        os.environ["no_proxy"] = "other.websocket.org, *"
         self.assertTrue(_is_no_proxy_host("any.websocket.org", None))
 
     def testIpAddress(self):
-        self.assertTrue(_is_no_proxy_host("127.0.0.1", ['127.0.0.1']))
-        self.assertFalse(_is_no_proxy_host("127.0.0.2", ['127.0.0.1']))
-        self.assertTrue(_is_no_proxy_host("127.0.0.1", ['other.websocket.org', '127.0.0.1']))
-        self.assertFalse(_is_no_proxy_host("127.0.0.2", ['other.websocket.org', '127.0.0.1']))
-        os.environ['no_proxy'] = '127.0.0.1'
+        self.assertTrue(_is_no_proxy_host("127.0.0.1", ["127.0.0.1"]))
+        self.assertFalse(_is_no_proxy_host("127.0.0.2", ["127.0.0.1"]))
+        self.assertTrue(
+            _is_no_proxy_host("127.0.0.1", ["other.websocket.org", "127.0.0.1"])
+        )
+        self.assertFalse(
+            _is_no_proxy_host("127.0.0.2", ["other.websocket.org", "127.0.0.1"])
+        )
+        os.environ["no_proxy"] = "127.0.0.1"
         self.assertTrue(_is_no_proxy_host("127.0.0.1", None))
         self.assertFalse(_is_no_proxy_host("127.0.0.2", None))
-        os.environ['no_proxy'] = 'other.websocket.org, 127.0.0.1'
+        os.environ["no_proxy"] = "other.websocket.org, 127.0.0.1"
         self.assertTrue(_is_no_proxy_host("127.0.0.1", None))
         self.assertFalse(_is_no_proxy_host("127.0.0.2", None))
 
     def testIpAddressInRange(self):
-        self.assertTrue(_is_no_proxy_host("127.0.0.1", ['127.0.0.0/8']))
-        self.assertTrue(_is_no_proxy_host("127.0.0.2", ['127.0.0.0/8']))
-        self.assertFalse(_is_no_proxy_host("127.1.0.1", ['127.0.0.0/24']))
-        os.environ['no_proxy'] = '127.0.0.0/8'
+        self.assertTrue(_is_no_proxy_host("127.0.0.1", ["127.0.0.0/8"]))
+        self.assertTrue(_is_no_proxy_host("127.0.0.2", ["127.0.0.0/8"]))
+        self.assertFalse(_is_no_proxy_host("127.1.0.1", ["127.0.0.0/24"]))
+        os.environ["no_proxy"] = "127.0.0.0/8"
         self.assertTrue(_is_no_proxy_host("127.0.0.1", None))
         self.assertTrue(_is_no_proxy_host("127.0.0.2", None))
-        os.environ['no_proxy'] = '127.0.0.0/24'
+        os.environ["no_proxy"] = "127.0.0.0/24"
         self.assertFalse(_is_no_proxy_host("127.1.0.1", None))
 
     def testHostnameMatch(self):
-        self.assertTrue(_is_no_proxy_host("my.websocket.org", ['my.websocket.org']))
-        self.assertTrue(_is_no_proxy_host("my.websocket.org", ['other.websocket.org', 'my.websocket.org']))
-        self.assertFalse(_is_no_proxy_host("my.websocket.org", ['other.websocket.org']))
-        os.environ['no_proxy'] = 'my.websocket.org'
+        self.assertTrue(_is_no_proxy_host("my.websocket.org", ["my.websocket.org"]))
+        self.assertTrue(
+            _is_no_proxy_host(
+                "my.websocket.org", ["other.websocket.org", "my.websocket.org"]
+            )
+        )
+        self.assertFalse(_is_no_proxy_host("my.websocket.org", ["other.websocket.org"]))
+        os.environ["no_proxy"] = "my.websocket.org"
         self.assertTrue(_is_no_proxy_host("my.websocket.org", None))
         self.assertFalse(_is_no_proxy_host("other.websocket.org", None))
-        os.environ['no_proxy'] = 'other.websocket.org, my.websocket.org'
+        os.environ["no_proxy"] = "other.websocket.org, my.websocket.org"
         self.assertTrue(_is_no_proxy_host("my.websocket.org", None))
 
     def testHostnameMatchDomain(self):
-        self.assertTrue(_is_no_proxy_host("any.websocket.org", ['.websocket.org']))
-        self.assertTrue(_is_no_proxy_host("my.other.websocket.org", ['.websocket.org']))
-        self.assertTrue(_is_no_proxy_host("any.websocket.org", ['my.websocket.org', '.websocket.org']))
-        self.assertFalse(_is_no_proxy_host("any.websocket.com", ['.websocket.org']))
-        os.environ['no_proxy'] = '.websocket.org'
+        self.assertTrue(_is_no_proxy_host("any.websocket.org", [".websocket.org"]))
+        self.assertTrue(_is_no_proxy_host("my.other.websocket.org", [".websocket.org"]))
+        self.assertTrue(
+            _is_no_proxy_host(
+                "any.websocket.org", ["my.websocket.org", ".websocket.org"]
+            )
+        )
+        self.assertFalse(_is_no_proxy_host("any.websocket.com", [".websocket.org"]))
+        os.environ["no_proxy"] = ".websocket.org"
         self.assertTrue(_is_no_proxy_host("any.websocket.org", None))
         self.assertTrue(_is_no_proxy_host("my.other.websocket.org", None))
         self.assertFalse(_is_no_proxy_host("any.websocket.com", None))
-        os.environ['no_proxy'] = 'my.websocket.org, .websocket.org'
+        os.environ["no_proxy"] = "my.websocket.org, .websocket.org"
         self.assertTrue(_is_no_proxy_host("any.websocket.org", None))
 
 
@@ -209,96 +228,205 @@ class ProxyInfoTest(unittest.TestCase):
             del os.environ["no_proxy"]
 
     def testProxyFromArgs(self):
-        self.assertEqual(get_proxy_info("echo.websocket.events", False, proxy_host="localhost"), ("localhost", 0, None))
-        self.assertEqual(get_proxy_info("echo.websocket.events", False, proxy_host="localhost", proxy_port=3128),
-                         ("localhost", 3128, None))
-        self.assertEqual(get_proxy_info("echo.websocket.events", True, proxy_host="localhost"), ("localhost", 0, None))
-        self.assertEqual(get_proxy_info("echo.websocket.events", True, proxy_host="localhost", proxy_port=3128),
-                         ("localhost", 3128, None))
-
-        self.assertEqual(get_proxy_info("echo.websocket.events", False, proxy_host="localhost", proxy_auth=("a", "b")),
-                         ("localhost", 0, ("a", "b")))
         self.assertEqual(
-            get_proxy_info("echo.websocket.events", False, proxy_host="localhost", proxy_port=3128, proxy_auth=("a", "b")),
-            ("localhost", 3128, ("a", "b")))
-        self.assertEqual(get_proxy_info("echo.websocket.events", True, proxy_host="localhost", proxy_auth=("a", "b")),
-                         ("localhost", 0, ("a", "b")))
+            get_proxy_info("echo.websocket.events", False, proxy_host="localhost"),
+            ("localhost", 0, None),
+        )
         self.assertEqual(
-            get_proxy_info("echo.websocket.events", True, proxy_host="localhost", proxy_port=3128, proxy_auth=("a", "b")),
-            ("localhost", 3128, ("a", "b")))
+            get_proxy_info(
+                "echo.websocket.events", False, proxy_host="localhost", proxy_port=3128
+            ),
+            ("localhost", 3128, None),
+        )
+        self.assertEqual(
+            get_proxy_info("echo.websocket.events", True, proxy_host="localhost"),
+            ("localhost", 0, None),
+        )
+        self.assertEqual(
+            get_proxy_info(
+                "echo.websocket.events", True, proxy_host="localhost", proxy_port=3128
+            ),
+            ("localhost", 3128, None),
+        )
 
-        self.assertEqual(get_proxy_info("echo.websocket.events", True, proxy_host="localhost", proxy_port=3128,
-                                        no_proxy=["example.com"], proxy_auth=("a", "b")),
-                         ("localhost", 3128, ("a", "b")))
-        self.assertEqual(get_proxy_info("echo.websocket.events", True, proxy_host="localhost", proxy_port=3128,
-                                        no_proxy=["echo.websocket.events"], proxy_auth=("a", "b")),
-                         (None, 0, None))
+        self.assertEqual(
+            get_proxy_info(
+                "echo.websocket.events",
+                False,
+                proxy_host="localhost",
+                proxy_auth=("a", "b"),
+            ),
+            ("localhost", 0, ("a", "b")),
+        )
+        self.assertEqual(
+            get_proxy_info(
+                "echo.websocket.events",
+                False,
+                proxy_host="localhost",
+                proxy_port=3128,
+                proxy_auth=("a", "b"),
+            ),
+            ("localhost", 3128, ("a", "b")),
+        )
+        self.assertEqual(
+            get_proxy_info(
+                "echo.websocket.events",
+                True,
+                proxy_host="localhost",
+                proxy_auth=("a", "b"),
+            ),
+            ("localhost", 0, ("a", "b")),
+        )
+        self.assertEqual(
+            get_proxy_info(
+                "echo.websocket.events",
+                True,
+                proxy_host="localhost",
+                proxy_port=3128,
+                proxy_auth=("a", "b"),
+            ),
+            ("localhost", 3128, ("a", "b")),
+        )
+
+        self.assertEqual(
+            get_proxy_info(
+                "echo.websocket.events",
+                True,
+                proxy_host="localhost",
+                proxy_port=3128,
+                no_proxy=["example.com"],
+                proxy_auth=("a", "b"),
+            ),
+            ("localhost", 3128, ("a", "b")),
+        )
+        self.assertEqual(
+            get_proxy_info(
+                "echo.websocket.events",
+                True,
+                proxy_host="localhost",
+                proxy_port=3128,
+                no_proxy=["echo.websocket.events"],
+                proxy_auth=("a", "b"),
+            ),
+            (None, 0, None),
+        )
 
     def testProxyFromEnv(self):
         os.environ["http_proxy"] = "http://localhost/"
-        self.assertEqual(get_proxy_info("echo.websocket.events", False), ("localhost", None, None))
+        self.assertEqual(
+            get_proxy_info("echo.websocket.events", False), ("localhost", None, None)
+        )
         os.environ["http_proxy"] = "http://localhost:3128/"
-        self.assertEqual(get_proxy_info("echo.websocket.events", False), ("localhost", 3128, None))
+        self.assertEqual(
+            get_proxy_info("echo.websocket.events", False), ("localhost", 3128, None)
+        )
 
         os.environ["http_proxy"] = "http://localhost/"
         os.environ["https_proxy"] = "http://localhost2/"
-        self.assertEqual(get_proxy_info("echo.websocket.events", False), ("localhost", None, None))
+        self.assertEqual(
+            get_proxy_info("echo.websocket.events", False), ("localhost", None, None)
+        )
         os.environ["http_proxy"] = "http://localhost:3128/"
         os.environ["https_proxy"] = "http://localhost2:3128/"
-        self.assertEqual(get_proxy_info("echo.websocket.events", False), ("localhost", 3128, None))
+        self.assertEqual(
+            get_proxy_info("echo.websocket.events", False), ("localhost", 3128, None)
+        )
 
         os.environ["http_proxy"] = "http://localhost/"
         os.environ["https_proxy"] = "http://localhost2/"
-        self.assertEqual(get_proxy_info("echo.websocket.events", True), ("localhost2", None, None))
+        self.assertEqual(
+            get_proxy_info("echo.websocket.events", True), ("localhost2", None, None)
+        )
         os.environ["http_proxy"] = "http://localhost:3128/"
         os.environ["https_proxy"] = "http://localhost2:3128/"
-        self.assertEqual(get_proxy_info("echo.websocket.events", True), ("localhost2", 3128, None))
+        self.assertEqual(
+            get_proxy_info("echo.websocket.events", True), ("localhost2", 3128, None)
+        )
 
         os.environ["http_proxy"] = ""
         os.environ["https_proxy"] = "http://localhost2/"
-        self.assertEqual(get_proxy_info("echo.websocket.events", True), ("localhost2", None, None))
-        self.assertEqual(get_proxy_info("echo.websocket.events", False), (None, 0, None))
+        self.assertEqual(
+            get_proxy_info("echo.websocket.events", True), ("localhost2", None, None)
+        )
+        self.assertEqual(
+            get_proxy_info("echo.websocket.events", False), (None, 0, None)
+        )
         os.environ["http_proxy"] = ""
         os.environ["https_proxy"] = "http://localhost2:3128/"
-        self.assertEqual(get_proxy_info("echo.websocket.events", True), ("localhost2", 3128, None))
-        self.assertEqual(get_proxy_info("echo.websocket.events", False), (None, 0, None))
+        self.assertEqual(
+            get_proxy_info("echo.websocket.events", True), ("localhost2", 3128, None)
+        )
+        self.assertEqual(
+            get_proxy_info("echo.websocket.events", False), (None, 0, None)
+        )
 
         os.environ["http_proxy"] = "http://localhost/"
         os.environ["https_proxy"] = ""
         self.assertEqual(get_proxy_info("echo.websocket.events", True), (None, 0, None))
-        self.assertEqual(get_proxy_info("echo.websocket.events", False), ("localhost", None, None))
+        self.assertEqual(
+            get_proxy_info("echo.websocket.events", False), ("localhost", None, None)
+        )
         os.environ["http_proxy"] = "http://localhost:3128/"
         os.environ["https_proxy"] = ""
         self.assertEqual(get_proxy_info("echo.websocket.events", True), (None, 0, None))
-        self.assertEqual(get_proxy_info("echo.websocket.events", False), ("localhost", 3128, None))
+        self.assertEqual(
+            get_proxy_info("echo.websocket.events", False), ("localhost", 3128, None)
+        )
 
         os.environ["http_proxy"] = "http://a:b@localhost/"
-        self.assertEqual(get_proxy_info("echo.websocket.events", False), ("localhost", None, ("a", "b")))
+        self.assertEqual(
+            get_proxy_info("echo.websocket.events", False),
+            ("localhost", None, ("a", "b")),
+        )
         os.environ["http_proxy"] = "http://a:b@localhost:3128/"
-        self.assertEqual(get_proxy_info("echo.websocket.events", False), ("localhost", 3128, ("a", "b")))
+        self.assertEqual(
+            get_proxy_info("echo.websocket.events", False),
+            ("localhost", 3128, ("a", "b")),
+        )
 
         os.environ["http_proxy"] = "http://a:b@localhost/"
         os.environ["https_proxy"] = "http://a:b@localhost2/"
-        self.assertEqual(get_proxy_info("echo.websocket.events", False), ("localhost", None, ("a", "b")))
+        self.assertEqual(
+            get_proxy_info("echo.websocket.events", False),
+            ("localhost", None, ("a", "b")),
+        )
         os.environ["http_proxy"] = "http://a:b@localhost:3128/"
         os.environ["https_proxy"] = "http://a:b@localhost2:3128/"
-        self.assertEqual(get_proxy_info("echo.websocket.events", False), ("localhost", 3128, ("a", "b")))
+        self.assertEqual(
+            get_proxy_info("echo.websocket.events", False),
+            ("localhost", 3128, ("a", "b")),
+        )
 
         os.environ["http_proxy"] = "http://a:b@localhost/"
         os.environ["https_proxy"] = "http://a:b@localhost2/"
-        self.assertEqual(get_proxy_info("echo.websocket.events", True), ("localhost2", None, ("a", "b")))
+        self.assertEqual(
+            get_proxy_info("echo.websocket.events", True),
+            ("localhost2", None, ("a", "b")),
+        )
         os.environ["http_proxy"] = "http://a:b@localhost:3128/"
         os.environ["https_proxy"] = "http://a:b@localhost2:3128/"
-        self.assertEqual(get_proxy_info("echo.websocket.events", True), ("localhost2", 3128, ("a", "b")))
+        self.assertEqual(
+            get_proxy_info("echo.websocket.events", True),
+            ("localhost2", 3128, ("a", "b")),
+        )
 
-        os.environ["http_proxy"] = "http://john%40example.com:P%40SSWORD@localhost:3128/"
-        os.environ["https_proxy"] = "http://john%40example.com:P%40SSWORD@localhost2:3128/"
-        self.assertEqual(get_proxy_info("echo.websocket.events", True), ("localhost2", 3128, ("john@example.com", "P@SSWORD")))
+        os.environ[
+            "http_proxy"
+        ] = "http://john%40example.com:P%40SSWORD@localhost:3128/"
+        os.environ[
+            "https_proxy"
+        ] = "http://john%40example.com:P%40SSWORD@localhost2:3128/"
+        self.assertEqual(
+            get_proxy_info("echo.websocket.events", True),
+            ("localhost2", 3128, ("john@example.com", "P@SSWORD")),
+        )
 
         os.environ["http_proxy"] = "http://a:b@localhost/"
         os.environ["https_proxy"] = "http://a:b@localhost2/"
         os.environ["no_proxy"] = "example1.com,example2.com"
-        self.assertEqual(get_proxy_info("example.1.com", True), ("localhost2", None, ("a", "b")))
+        self.assertEqual(
+            get_proxy_info("example.1.com", True), ("localhost2", None, ("a", "b"))
+        )
         os.environ["http_proxy"] = "http://a:b@localhost:3128/"
         os.environ["https_proxy"] = "http://a:b@localhost2:3128/"
         os.environ["no_proxy"] = "example1.com,example2.com, echo.websocket.events"
diff --git a/lib/websocket/tests/test_websocket.py b/lib/websocket/tests/test_websocket.py
index a140066e..498def57 100644
--- a/lib/websocket/tests/test_websocket.py
+++ b/lib/websocket/tests/test_websocket.py
@@ -3,13 +3,14 @@
 import os
 import os.path
 import socket
-import websocket as ws
 import unittest
-from websocket._handshake import _create_sec_websocket_key, \
-    _validate as _validate_header
+from base64 import decodebytes as base64decode
+
+import websocket as ws
+from websocket._handshake import _create_sec_websocket_key
+from websocket._handshake import _validate as _validate_header
 from websocket._http import read_headers
 from websocket._utils import validate_utf8
-from base64 import decodebytes as base64decode
 
 """
 test_websocket.py
@@ -38,11 +39,12 @@ except ImportError:
     class SSLError(Exception):
         pass
 
+
 # Skip test to access the internet unless TEST_WITH_INTERNET == 1
-TEST_WITH_INTERNET = os.environ.get('TEST_WITH_INTERNET', '0') == '1'
+TEST_WITH_INTERNET = os.environ.get("TEST_WITH_INTERNET", "0") == "1"
 # Skip tests relying on local websockets server unless LOCAL_WS_SERVER_PORT != -1
-LOCAL_WS_SERVER_PORT = os.environ.get('LOCAL_WS_SERVER_PORT', '-1')
-TEST_WITH_LOCAL_SERVER = LOCAL_WS_SERVER_PORT != '-1'
+LOCAL_WS_SERVER_PORT = os.environ.get("LOCAL_WS_SERVER_PORT", "-1")
+TEST_WITH_LOCAL_SERVER = LOCAL_WS_SERVER_PORT != "-1"
 TRACEABLE = True
 
 
@@ -79,7 +81,6 @@ class SockMock:
 
 
 class HeaderSockMock(SockMock):
-
     def __init__(self, fname):
         SockMock.__init__(self)
         path = os.path.join(os.path.dirname(__file__), fname)
@@ -103,11 +104,10 @@ class WebSocketTest(unittest.TestCase):
     def testWSKey(self):
         key = _create_sec_websocket_key()
         self.assertTrue(key != 24)
-        self.assertTrue(str("¥n") not in key)
+        self.assertTrue("¥n" not in key)
 
     def testNonce(self):
-        """ WebSocket key should be a random 16-byte nonce.
-        """
+        """WebSocket key should be a random 16-byte nonce."""
         key = _create_sec_websocket_key()
         nonce = base64decode(key.encode("utf-8"))
         self.assertEqual(16, len(nonce))
@@ -117,7 +117,8 @@ class WebSocketTest(unittest.TestCase):
         required_header = {
             "upgrade": "websocket",
             "connection": "upgrade",
-            "sec-websocket-accept": "Kxep+hNu9n51529fGidYu7a3wO0="}
+            "sec-websocket-accept": "Kxep+hNu9n51529fGidYu7a3wO0=",
+        }
         self.assertEqual(_validate_header(required_header, key, None), (True, None))
 
         header = required_header.copy()
@@ -140,29 +141,39 @@ class WebSocketTest(unittest.TestCase):
 
         header = required_header.copy()
         header["sec-websocket-protocol"] = "sub1"
-        self.assertEqual(_validate_header(header, key, ["sub1", "sub2"]), (True, "sub1"))
+        self.assertEqual(
+            _validate_header(header, key, ["sub1", "sub2"]), (True, "sub1")
+        )
         # This case will print out a logging error using the error() function, but that is expected
         self.assertEqual(_validate_header(header, key, ["sub2", "sub3"]), (False, None))
 
         header = required_header.copy()
         header["sec-websocket-protocol"] = "sUb1"
-        self.assertEqual(_validate_header(header, key, ["Sub1", "suB2"]), (True, "sub1"))
+        self.assertEqual(
+            _validate_header(header, key, ["Sub1", "suB2"]), (True, "sub1")
+        )
 
         header = required_header.copy()
         # This case will print out a logging error using the error() function, but that is expected
         self.assertEqual(_validate_header(header, key, ["Sub1", "suB2"]), (False, None))
 
     def testReadHeader(self):
-        status, header, status_message = read_headers(HeaderSockMock("data/header01.txt"))
+        status, header, status_message = read_headers(
+            HeaderSockMock("data/header01.txt")
+        )
         self.assertEqual(status, 101)
         self.assertEqual(header["connection"], "Upgrade")
 
-        status, header, status_message = read_headers(HeaderSockMock("data/header03.txt"))
+        status, header, status_message = read_headers(
+            HeaderSockMock("data/header03.txt")
+        )
         self.assertEqual(status, 101)
         self.assertEqual(header["connection"], "Upgrade, Keep-Alive")
 
         HeaderSockMock("data/header02.txt")
-        self.assertRaises(ws.WebSocketException, read_headers, HeaderSockMock("data/header02.txt"))
+        self.assertRaises(
+            ws.WebSocketException, read_headers, HeaderSockMock("data/header02.txt")
+        )
 
     def testSend(self):
         # TODO: add longer frame data
@@ -170,33 +181,38 @@ class WebSocketTest(unittest.TestCase):
         sock.set_mask_key(create_mask_key)
         s = sock.sock = HeaderSockMock("data/header01.txt")
         sock.send("Hello")
-        self.assertEqual(s.sent[0], b'\x81\x85abcd)\x07\x0f\x08\x0e')
+        self.assertEqual(s.sent[0], b"\x81\x85abcd)\x07\x0f\x08\x0e")
 
         sock.send("こんにちは")
-        self.assertEqual(s.sent[1], b'\x81\x8fabcd\x82\xe3\xf0\x87\xe3\xf1\x80\xe5\xca\x81\xe2\xc5\x82\xe3\xcc')
+        self.assertEqual(
+            s.sent[1],
+            b"\x81\x8fabcd\x82\xe3\xf0\x87\xe3\xf1\x80\xe5\xca\x81\xe2\xc5\x82\xe3\xcc",
+        )
 
-#        sock.send("x" * 5000)
-#        self.assertEqual(s.sent[1], b'\x81\x8fabcd\x82\xe3\xf0\x87\xe3\xf1\x80\xe5\xca\x81\xe2\xc5\x82\xe3\xcc")
+        #        sock.send("x" * 5000)
+        #        self.assertEqual(s.sent[1], b'\x81\x8fabcd\x82\xe3\xf0\x87\xe3\xf1\x80\xe5\xca\x81\xe2\xc5\x82\xe3\xcc")
 
-        self.assertEqual(sock.send_binary(b'1111111111101'), 19)
+        self.assertEqual(sock.send_binary(b"1111111111101"), 19)
 
     def testRecv(self):
         # TODO: add longer frame data
         sock = ws.WebSocket()
         s = sock.sock = SockMock()
-        something = b'\x81\x8fabcd\x82\xe3\xf0\x87\xe3\xf1\x80\xe5\xca\x81\xe2\xc5\x82\xe3\xcc'
+        something = (
+            b"\x81\x8fabcd\x82\xe3\xf0\x87\xe3\xf1\x80\xe5\xca\x81\xe2\xc5\x82\xe3\xcc"
+        )
         s.add_packet(something)
         data = sock.recv()
         self.assertEqual(data, "こんにちは")
 
-        s.add_packet(b'\x81\x85abcd)\x07\x0f\x08\x0e')
+        s.add_packet(b"\x81\x85abcd)\x07\x0f\x08\x0e")
         data = sock.recv()
         self.assertEqual(data, "Hello")
 
     @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled")
     def testIter(self):
         count = 2
-        s = ws.create_connection('wss://api.bitfinex.com/ws/2')
+        s = ws.create_connection("wss://api.bitfinex.com/ws/2")
         s.send('{"event": "subscribe", "channel": "ticker"}')
         for _ in s:
             count -= 1
@@ -205,34 +221,34 @@ class WebSocketTest(unittest.TestCase):
 
     @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled")
     def testNext(self):
-        sock = ws.create_connection('wss://api.bitfinex.com/ws/2')
+        sock = ws.create_connection("wss://api.bitfinex.com/ws/2")
         self.assertEqual(str, type(next(sock)))
 
     def testInternalRecvStrict(self):
         sock = ws.WebSocket()
         s = sock.sock = SockMock()
-        s.add_packet(b'foo')
+        s.add_packet(b"foo")
         s.add_packet(socket.timeout())
-        s.add_packet(b'bar')
+        s.add_packet(b"bar")
         # s.add_packet(SSLError("The read operation timed out"))
-        s.add_packet(b'baz')
+        s.add_packet(b"baz")
         with self.assertRaises(ws.WebSocketTimeoutException):
             sock.frame_buffer.recv_strict(9)
         #     with self.assertRaises(SSLError):
         #         data = sock._recv_strict(9)
         data = sock.frame_buffer.recv_strict(9)
-        self.assertEqual(data, b'foobarbaz')
+        self.assertEqual(data, b"foobarbaz")
         with self.assertRaises(ws.WebSocketConnectionClosedException):
             sock.frame_buffer.recv_strict(1)
 
     def testRecvTimeout(self):
         sock = ws.WebSocket()
         s = sock.sock = SockMock()
-        s.add_packet(b'\x81')
+        s.add_packet(b"\x81")
         s.add_packet(socket.timeout())
-        s.add_packet(b'\x8dabcd\x29\x07\x0f\x08\x0e')
+        s.add_packet(b"\x8dabcd\x29\x07\x0f\x08\x0e")
         s.add_packet(socket.timeout())
-        s.add_packet(b'\x4e\x43\x33\x0e\x10\x0f\x00\x40')
+        s.add_packet(b"\x4e\x43\x33\x0e\x10\x0f\x00\x40")
         with self.assertRaises(ws.WebSocketTimeoutException):
             sock.recv()
         with self.assertRaises(ws.WebSocketTimeoutException):
@@ -246,9 +262,9 @@ class WebSocketTest(unittest.TestCase):
         sock = ws.WebSocket()
         s = sock.sock = SockMock()
         # OPCODE=TEXT, FIN=0, MSG="Brevity is "
-        s.add_packet(b'\x01\x8babcd#\x10\x06\x12\x08\x16\x1aD\x08\x11C')
+        s.add_packet(b"\x01\x8babcd#\x10\x06\x12\x08\x16\x1aD\x08\x11C")
         # OPCODE=CONT, FIN=1, MSG="the soul of wit"
-        s.add_packet(b'\x80\x8fabcd\x15\n\x06D\x12\r\x16\x08A\r\x05D\x16\x0b\x17')
+        s.add_packet(b"\x80\x8fabcd\x15\n\x06D\x12\r\x16\x08A\r\x05D\x16\x0b\x17")
         data = sock.recv()
         self.assertEqual(data, "Brevity is the soul of wit")
         with self.assertRaises(ws.WebSocketConnectionClosedException):
@@ -258,21 +274,21 @@ class WebSocketTest(unittest.TestCase):
         sock = ws.WebSocket(fire_cont_frame=True)
         s = sock.sock = SockMock()
         # OPCODE=TEXT, FIN=0, MSG="Brevity is "
-        s.add_packet(b'\x01\x8babcd#\x10\x06\x12\x08\x16\x1aD\x08\x11C')
+        s.add_packet(b"\x01\x8babcd#\x10\x06\x12\x08\x16\x1aD\x08\x11C")
         # OPCODE=CONT, FIN=0, MSG="Brevity is "
-        s.add_packet(b'\x00\x8babcd#\x10\x06\x12\x08\x16\x1aD\x08\x11C')
+        s.add_packet(b"\x00\x8babcd#\x10\x06\x12\x08\x16\x1aD\x08\x11C")
         # OPCODE=CONT, FIN=1, MSG="the soul of wit"
-        s.add_packet(b'\x80\x8fabcd\x15\n\x06D\x12\r\x16\x08A\r\x05D\x16\x0b\x17')
+        s.add_packet(b"\x80\x8fabcd\x15\n\x06D\x12\r\x16\x08A\r\x05D\x16\x0b\x17")
 
         _, data = sock.recv_data()
-        self.assertEqual(data, b'Brevity is ')
+        self.assertEqual(data, b"Brevity is ")
         _, data = sock.recv_data()
-        self.assertEqual(data, b'Brevity is ')
+        self.assertEqual(data, b"Brevity is ")
         _, data = sock.recv_data()
-        self.assertEqual(data, b'the soul of wit')
+        self.assertEqual(data, b"the soul of wit")
 
         # OPCODE=CONT, FIN=0, MSG="Brevity is "
-        s.add_packet(b'\x80\x8babcd#\x10\x06\x12\x08\x16\x1aD\x08\x11C')
+        s.add_packet(b"\x80\x8babcd#\x10\x06\x12\x08\x16\x1aD\x08\x11C")
 
         with self.assertRaises(ws.WebSocketException):
             sock.recv_data()
@@ -288,7 +304,7 @@ class WebSocketTest(unittest.TestCase):
         sock = ws.WebSocket()
         s = sock.sock = SockMock()
         sock.connected = True
-        s.add_packet(b'\x88\x80\x17\x98p\x84')
+        s.add_packet(b"\x88\x80\x17\x98p\x84")
         sock.recv()
         self.assertEqual(sock.connected, False)
 
@@ -296,22 +312,22 @@ class WebSocketTest(unittest.TestCase):
         sock = ws.WebSocket()
         s = sock.sock = SockMock()
         # OPCODE=CONT, FIN=1, MSG="the soul of wit"
-        s.add_packet(b'\x80\x8fabcd\x15\n\x06D\x12\r\x16\x08A\r\x05D\x16\x0b\x17')
+        s.add_packet(b"\x80\x8fabcd\x15\n\x06D\x12\r\x16\x08A\r\x05D\x16\x0b\x17")
         self.assertRaises(ws.WebSocketException, sock.recv)
 
     def testRecvWithProlongedFragmentation(self):
         sock = ws.WebSocket()
         s = sock.sock = SockMock()
         # OPCODE=TEXT, FIN=0, MSG="Once more unto the breach, "
-        s.add_packet(b'\x01\x9babcd.\x0c\x00\x01A\x0f\x0c\x16\x04B\x16\n\x15\rC\x10\t\x07C\x06\x13\x07\x02\x07\tNC')
+        s.add_packet(
+            b"\x01\x9babcd.\x0c\x00\x01A\x0f\x0c\x16\x04B\x16\n\x15\rC\x10\t\x07C\x06\x13\x07\x02\x07\tNC"
+        )
         # OPCODE=CONT, FIN=0, MSG="dear friends, "
-        s.add_packet(b'\x00\x8eabcd\x05\x07\x02\x16A\x04\x11\r\x04\x0c\x07\x17MB')
+        s.add_packet(b"\x00\x8eabcd\x05\x07\x02\x16A\x04\x11\r\x04\x0c\x07\x17MB")
         # OPCODE=CONT, FIN=1, MSG="once more"
-        s.add_packet(b'\x80\x89abcd\x0e\x0c\x00\x01A\x0f\x0c\x16\x04')
+        s.add_packet(b"\x80\x89abcd\x0e\x0c\x00\x01A\x0f\x0c\x16\x04")
         data = sock.recv()
-        self.assertEqual(
-            data,
-            "Once more unto the breach, dear friends, once more")
+        self.assertEqual(data, "Once more unto the breach, dear friends, once more")
         with self.assertRaises(ws.WebSocketConnectionClosedException):
             sock.recv()
 
@@ -320,22 +336,24 @@ class WebSocketTest(unittest.TestCase):
         sock.set_mask_key(create_mask_key)
         s = sock.sock = SockMock()
         # OPCODE=TEXT, FIN=0, MSG="Too much "
-        s.add_packet(b'\x01\x89abcd5\r\x0cD\x0c\x17\x00\x0cA')
+        s.add_packet(b"\x01\x89abcd5\r\x0cD\x0c\x17\x00\x0cA")
         # OPCODE=PING, FIN=1, MSG="Please PONG this"
-        s.add_packet(b'\x89\x90abcd1\x0e\x06\x05\x12\x07C4.,$D\x15\n\n\x17')
+        s.add_packet(b"\x89\x90abcd1\x0e\x06\x05\x12\x07C4.,$D\x15\n\n\x17")
         # OPCODE=CONT, FIN=1, MSG="of a good thing"
-        s.add_packet(b'\x80\x8fabcd\x0e\x04C\x05A\x05\x0c\x0b\x05B\x17\x0c\x08\x0c\x04')
+        s.add_packet(b"\x80\x8fabcd\x0e\x04C\x05A\x05\x0c\x0b\x05B\x17\x0c\x08\x0c\x04")
         data = sock.recv()
         self.assertEqual(data, "Too much of a good thing")
         with self.assertRaises(ws.WebSocketConnectionClosedException):
             sock.recv()
         self.assertEqual(
-            s.sent[0],
-            b'\x8a\x90abcd1\x0e\x06\x05\x12\x07C4.,$D\x15\n\n\x17')
+            s.sent[0], b"\x8a\x90abcd1\x0e\x06\x05\x12\x07C4.,$D\x15\n\n\x17"
+        )
 
-    @unittest.skipUnless(TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled")
+    @unittest.skipUnless(
+        TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled"
+    )
     def testWebSocket(self):
-        s = ws.create_connection("ws://127.0.0.1:" + LOCAL_WS_SERVER_PORT)
+        s = ws.create_connection(f"ws://127.0.0.1:{LOCAL_WS_SERVER_PORT}")
         self.assertNotEqual(s, None)
         s.send("Hello, World")
         result = s.next()
@@ -348,9 +366,11 @@ class WebSocketTest(unittest.TestCase):
         self.assertRaises(ValueError, s.send_close, -1, "")
         s.close()
 
-    @unittest.skipUnless(TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled")
+    @unittest.skipUnless(
+        TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled"
+    )
     def testPingPong(self):
-        s = ws.create_connection("ws://127.0.0.1:" + LOCAL_WS_SERVER_PORT)
+        s = ws.create_connection(f"ws://127.0.0.1:{LOCAL_WS_SERVER_PORT}")
         self.assertNotEqual(s, None)
         s.ping("Hello")
         s.pong("Hi")
@@ -359,12 +379,15 @@ class WebSocketTest(unittest.TestCase):
     @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled")
     def testSupportRedirect(self):
         s = ws.WebSocket()
-        self.assertRaises(ws._exceptions.WebSocketBadStatusException, s.connect, "ws://google.com/")
+        self.assertRaises(
+            ws._exceptions.WebSocketBadStatusException, s.connect, "ws://google.com/"
+        )
         # Need to find a URL that has a redirect code leading to a websocket
 
     @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled")
     def testSecureWebSocket(self):
         import ssl
+
         s = ws.create_connection("wss://api.bitfinex.com/ws/2")
         self.assertNotEqual(s, None)
         self.assertTrue(isinstance(s.sock, ssl.SSLSocket))
@@ -375,10 +398,14 @@ class WebSocketTest(unittest.TestCase):
         self.assertEqual(s.getsubprotocol(), None)
         s.abort()
 
-    @unittest.skipUnless(TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled")
+    @unittest.skipUnless(
+        TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled"
+    )
     def testWebSocketWithCustomHeader(self):
-        s = ws.create_connection("ws://127.0.0.1:" + LOCAL_WS_SERVER_PORT,
-                                 headers={"User-Agent": "PythonWebsocketClient"})
+        s = ws.create_connection(
+            f"ws://127.0.0.1:{LOCAL_WS_SERVER_PORT}",
+            headers={"User-Agent": "PythonWebsocketClient"},
+        )
         self.assertNotEqual(s, None)
         self.assertEqual(s.getsubprotocol(), None)
         s.send("Hello, World")
@@ -387,9 +414,11 @@ class WebSocketTest(unittest.TestCase):
         self.assertRaises(ValueError, s.close, -1, "")
         s.close()
 
-    @unittest.skipUnless(TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled")
+    @unittest.skipUnless(
+        TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled"
+    )
     def testAfterClose(self):
-        s = ws.create_connection("ws://127.0.0.1:" + LOCAL_WS_SERVER_PORT)
+        s = ws.create_connection(f"ws://127.0.0.1:{LOCAL_WS_SERVER_PORT}")
         self.assertNotEqual(s, None)
         s.close()
         self.assertRaises(ws.WebSocketConnectionClosedException, s.send, "Hello")
@@ -397,48 +426,69 @@ class WebSocketTest(unittest.TestCase):
 
 
 class SockOptTest(unittest.TestCase):
-    @unittest.skipUnless(TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled")
+    @unittest.skipUnless(
+        TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled"
+    )
     def testSockOpt(self):
         sockopt = ((socket.IPPROTO_TCP, socket.TCP_NODELAY, 1),)
-        s = ws.create_connection("ws://127.0.0.1:" + LOCAL_WS_SERVER_PORT, sockopt=sockopt)
-        self.assertNotEqual(s.sock.getsockopt(socket.IPPROTO_TCP, socket.TCP_NODELAY), 0)
+        s = ws.create_connection(
+            f"ws://127.0.0.1:{LOCAL_WS_SERVER_PORT}", sockopt=sockopt
+        )
+        self.assertNotEqual(
+            s.sock.getsockopt(socket.IPPROTO_TCP, socket.TCP_NODELAY), 0
+        )
         s.close()
 
 
 class UtilsTest(unittest.TestCase):
     def testUtf8Validator(self):
-        state = validate_utf8(b'\xf0\x90\x80\x80')
+        state = validate_utf8(b"\xf0\x90\x80\x80")
         self.assertEqual(state, True)
-        state = validate_utf8(b'\xce\xba\xe1\xbd\xb9\xcf\x83\xce\xbc\xce\xb5\xed\xa0\x80edited')
+        state = validate_utf8(
+            b"\xce\xba\xe1\xbd\xb9\xcf\x83\xce\xbc\xce\xb5\xed\xa0\x80edited"
+        )
         self.assertEqual(state, False)
-        state = validate_utf8(b'')
+        state = validate_utf8(b"")
         self.assertEqual(state, True)
 
 
 class HandshakeTest(unittest.TestCase):
     @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled")
     def test_http_SSL(self):
-        websock1 = ws.WebSocket(sslopt={"cert_chain": ssl.get_default_verify_paths().capath}, enable_multithread=False)
-        self.assertRaises(ValueError,
-                          websock1.connect, "wss://api.bitfinex.com/ws/2")
+        websock1 = ws.WebSocket(
+            sslopt={"cert_chain": ssl.get_default_verify_paths().capath},
+            enable_multithread=False,
+        )
+        self.assertRaises(ValueError, websock1.connect, "wss://api.bitfinex.com/ws/2")
         websock2 = ws.WebSocket(sslopt={"certfile": "myNonexistentCertFile"})
-        self.assertRaises(FileNotFoundError,
-                          websock2.connect, "wss://api.bitfinex.com/ws/2")
+        self.assertRaises(
+            FileNotFoundError, websock2.connect, "wss://api.bitfinex.com/ws/2"
+        )
 
     @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled")
     def testManualHeaders(self):
-        websock3 = ws.WebSocket(sslopt={"ca_certs": ssl.get_default_verify_paths().cafile,
-                                        "ca_cert_path": ssl.get_default_verify_paths().capath})
-        self.assertRaises(ws._exceptions.WebSocketBadStatusException,
-                          websock3.connect, "wss://api.bitfinex.com/ws/2", cookie="chocolate",
-                          origin="testing_websockets.com",
-                          host="echo.websocket.events/websocket-client-test",
-                          subprotocols=["testproto"],
-                          connection="Upgrade",
-                          header={"CustomHeader1":"123",
-                                  "Cookie":"TestValue",
-                                  "Sec-WebSocket-Key":"k9kFAUWNAMmf5OEMfTlOEA==",
-                                  "Sec-WebSocket-Protocol":"newprotocol"})
+        websock3 = ws.WebSocket(
+            sslopt={
+                "ca_certs": ssl.get_default_verify_paths().cafile,
+                "ca_cert_path": ssl.get_default_verify_paths().capath,
+            }
+        )
+        self.assertRaises(
+            ws._exceptions.WebSocketBadStatusException,
+            websock3.connect,
+            "wss://api.bitfinex.com/ws/2",
+            cookie="chocolate",
+            origin="testing_websockets.com",
+            host="echo.websocket.events/websocket-client-test",
+            subprotocols=["testproto"],
+            connection="Upgrade",
+            header={
+                "CustomHeader1": "123",
+                "Cookie": "TestValue",
+                "Sec-WebSocket-Key": "k9kFAUWNAMmf5OEMfTlOEA==",
+                "Sec-WebSocket-Protocol": "newprotocol",
+            },
+        )
 
     def testIPv6(self):
         websock2 = ws.WebSocket()
@@ -447,7 +497,9 @@ class HandshakeTest(unittest.TestCase):
     def testBadURLs(self):
         websock3 = ws.WebSocket()
         self.assertRaises(ValueError, websock3.connect, "ws//example.com")
-        self.assertRaises(ws.WebSocketAddressException, websock3.connect, "ws://example")
+        self.assertRaises(
+            ws.WebSocketAddressException, websock3.connect, "ws://example"
+        )
         self.assertRaises(ValueError, websock3.connect, "example.com")
 
 
diff --git a/requirements.txt b/requirements.txt
index 8c8e91f3..bdf83410 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -47,7 +47,7 @@ tzdata==2023.3
 tzlocal==5.0.1
 urllib3<2
 webencodings==0.5.1
-websocket-client==1.6.2
+websocket-client==1.7.0
 xmltodict==0.13.0
 zipp==3.16.2
 

From 52819f7da6ca8434ecc632f9b1a155bd690d9b81 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sun, 24 Mar 2024 15:22:05 -0700
Subject: [PATCH 532/743] Bump pytz from 2023.3 to 2024.1 (#2254)

* Bump pytz from 2023.3 to 2024.1

Bumps [pytz](https://github.com/stub42/pytz) from 2023.3 to 2024.1.
- [Release notes](https://github.com/stub42/pytz/releases)
- [Commits](https://github.com/stub42/pytz/compare/release_2023.3...release_2024.1)

---
updated-dependencies:
- dependency-name: pytz
  dependency-type: direct:production
  update-type: version-update:semver-major
...

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

* Update pytz==2024.1

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/pytz/__init__.py                   |    4 +-
 lib/pytz/tzinfo.py                     |   11 +-
 lib/pytz/zoneinfo/America/Godthab      |  Bin 1903 -> 1889 bytes
 lib/pytz/zoneinfo/America/Miquelon     |  Bin 1652 -> 1652 bytes
 lib/pytz/zoneinfo/America/Montreal     |  Bin 3494 -> 3494 bytes
 lib/pytz/zoneinfo/America/Nassau       |  Bin 3494 -> 3494 bytes
 lib/pytz/zoneinfo/America/Nipigon      |  Bin 3494 -> 3494 bytes
 lib/pytz/zoneinfo/America/Nuuk         |  Bin 1903 -> 1889 bytes
 lib/pytz/zoneinfo/America/Scoresbysund |  Bin 1902 -> 1935 bytes
 lib/pytz/zoneinfo/America/Thunder_Bay  |  Bin 3494 -> 3494 bytes
 lib/pytz/zoneinfo/America/Toronto      |  Bin 3494 -> 3494 bytes
 lib/pytz/zoneinfo/Antarctica/Casey     |  Bin 370 -> 423 bytes
 lib/pytz/zoneinfo/Antarctica/Vostok    |  Bin 151 -> 213 bytes
 lib/pytz/zoneinfo/Asia/Almaty          |  Bin 983 -> 983 bytes
 lib/pytz/zoneinfo/Asia/Gaza            |  Bin 3808 -> 3844 bytes
 lib/pytz/zoneinfo/Asia/Hebron          |  Bin 3836 -> 3872 bytes
 lib/pytz/zoneinfo/Asia/Ho_Chi_Minh     |  Bin 337 -> 337 bytes
 lib/pytz/zoneinfo/Asia/Qostanay        |  Bin 997 -> 1025 bytes
 lib/pytz/zoneinfo/Asia/Saigon          |  Bin 337 -> 337 bytes
 lib/pytz/zoneinfo/Canada/Eastern       |  Bin 3494 -> 3494 bytes
 lib/pytz/zoneinfo/iso3166.tab          |   17 +-
 lib/pytz/zoneinfo/leapseconds          |   19 +-
 lib/pytz/zoneinfo/tzdata.zi            | 3961 ++++++++++++------------
 lib/pytz/zoneinfo/zone.tab             |   24 +-
 lib/pytz/zoneinfo/zone1970.tab         |   29 +-
 lib/pytz/zoneinfo/zonenow.tab          |  303 ++
 requirements.txt                       |    2 +-
 27 files changed, 2344 insertions(+), 2026 deletions(-)
 create mode 100644 lib/pytz/zoneinfo/zonenow.tab

diff --git a/lib/pytz/__init__.py b/lib/pytz/__init__.py
index 98b66553..2355f8b4 100644
--- a/lib/pytz/__init__.py
+++ b/lib/pytz/__init__.py
@@ -22,8 +22,8 @@ from pytz.tzfile import build_tzinfo
 
 
 # The IANA (nee Olson) database is updated several times a year.
-OLSON_VERSION = '2023c'
-VERSION = '2023.3'  # pip compatible version number.
+OLSON_VERSION = '2024a'
+VERSION = '2024.1'  # pip compatible version number.
 __version__ = VERSION
 
 OLSEN_VERSION = OLSON_VERSION  # Old releases had this misspelling
diff --git a/lib/pytz/tzinfo.py b/lib/pytz/tzinfo.py
index 725978d5..49b5c3fe 100644
--- a/lib/pytz/tzinfo.py
+++ b/lib/pytz/tzinfo.py
@@ -24,7 +24,8 @@ def memorized_timedelta(seconds):
         _timedelta_cache[seconds] = delta
         return delta
 
-_epoch = datetime.utcfromtimestamp(0)
+
+_epoch = datetime(1970, 1, 1, 0, 0) # datetime.utcfromtimestamp(0)
 _datetime_cache = {0: _epoch}
 
 
@@ -33,12 +34,13 @@ def memorized_datetime(seconds):
     try:
         return _datetime_cache[seconds]
     except KeyError:
-        # NB. We can't just do datetime.utcfromtimestamp(seconds) as this
-        # fails with negative values under Windows (Bug #90096)
+        # NB. We can't just do datetime.fromtimestamp(seconds, tz=timezone.utc).replace(tzinfo=None)
+        # as this fails with negative values under Windows (Bug #90096)
         dt = _epoch + timedelta(seconds=seconds)
         _datetime_cache[seconds] = dt
         return dt
 
+
 _ttinfo_cache = {}
 
 
@@ -55,6 +57,7 @@ def memorized_ttinfo(*args):
         _ttinfo_cache[args] = ttinfo
         return ttinfo
 
+
 _notime = memorized_timedelta(0)
 
 
@@ -355,7 +358,7 @@ class DstTzInfo(BaseTzInfo):
                     is_dst=False) + timedelta(hours=6)
 
         # If we get this far, we have multiple possible timezones - this
-        # is an ambiguous case occuring during the end-of-DST transition.
+        # is an ambiguous case occurring during the end-of-DST transition.
 
         # If told to be strict, raise an exception since we have an
         # ambiguous case
diff --git a/lib/pytz/zoneinfo/America/Godthab b/lib/pytz/zoneinfo/America/Godthab
index adb7934aadf5f45928ce67e82efa92ca92391703..29958cf12a9df7cf775e3337b4894e4cf4b82f58 100644
GIT binary patch
delta 54
zcmaFQ_mFRbGGoa`l?=wo6Bv(A{>UaeiJfgS3%l3ky-Yxf%@3K*Fm2w-YRrg`$_4-+
CSrVE6

delta 70
zcmaFJ_nvQpGGpmRl?+CfRNHkECigHNXJnrIkWGB@2R63J1x(qDrJL_ConZpYZeGG_
N&WIxIG1-A#5de#87;FFl

diff --git a/lib/pytz/zoneinfo/America/Miquelon b/lib/pytz/zoneinfo/America/Miquelon
index 5eccd861071d4eccb76fe0d8f5195bd1a7f646b7..f780ea990ff22675b5cc4e4dbe2c8690ae4e41b4 100644
GIT binary patch
delta 23
ccmeyu^Mz-EF7thHjg1DeOdxvm1g0m<0BZ>dYybcN

delta 23
ccmeyu^Mz-EF7q~v6&np=nLzaB2~1Cz0dxlmTmS$7

diff --git a/lib/pytz/zoneinfo/America/Montreal b/lib/pytz/zoneinfo/America/Montreal
index 6752c5b05285678b86aea170f0921fc5f5e57738..170137333f9f6dba10ac3ad7f32876aaf518c4fd 100644
GIT binary patch
delta 82
zcmZ1`y-a$-FR^1Et|{z)aNTsphZ_tFAKVn}`f$s5Qo?2d#`UaP$3FZA0+2k22B`tj
SAax)bq!vVj)xTuh%LV{v;5Kvs

delta 82
zcmZ1`y-a$-FR@h@t|=@&aNV@$!VQMj12;wUF5EIMbJ#4vxSmyO)rJ2+0FnpMAT=Nw
Rqz*)b)PiWR`j>2b*#PJ9Go%0j

diff --git a/lib/pytz/zoneinfo/America/Nassau b/lib/pytz/zoneinfo/America/Nassau
index 6752c5b05285678b86aea170f0921fc5f5e57738..170137333f9f6dba10ac3ad7f32876aaf518c4fd 100644
GIT binary patch
delta 82
zcmZ1`y-a$-FR^1Et|{z)aNTsphZ_tFAKVn}`f$s5Qo?2d#`UaP$3FZA0+2k22B`tj
SAax)bq!vVj)xTuh%LV{v;5Kvs

delta 82
zcmZ1`y-a$-FR@h@t|=@&aNV@$!VQMj12;wUF5EIMbJ#4vxSmyO)rJ2+0FnpMAT=Nw
Rqz*)b)PiWR`j>2b*#PJ9Go%0j

diff --git a/lib/pytz/zoneinfo/America/Nipigon b/lib/pytz/zoneinfo/America/Nipigon
index 6752c5b05285678b86aea170f0921fc5f5e57738..170137333f9f6dba10ac3ad7f32876aaf518c4fd 100644
GIT binary patch
delta 82
zcmZ1`y-a$-FR^1Et|{z)aNTsphZ_tFAKVn}`f$s5Qo?2d#`UaP$3FZA0+2k22B`tj
SAax)bq!vVj)xTuh%LV{v;5Kvs

delta 82
zcmZ1`y-a$-FR@h@t|=@&aNV@$!VQMj12;wUF5EIMbJ#4vxSmyO)rJ2+0FnpMAT=Nw
Rqz*)b)PiWR`j>2b*#PJ9Go%0j

diff --git a/lib/pytz/zoneinfo/America/Nuuk b/lib/pytz/zoneinfo/America/Nuuk
index adb7934aadf5f45928ce67e82efa92ca92391703..29958cf12a9df7cf775e3337b4894e4cf4b82f58 100644
GIT binary patch
delta 54
zcmaFQ_mFRbGGoa`l?=wo6Bv(A{>UaeiJfgS3%l3ky-Yxf%@3K*Fm2w-YRrg`$_4-+
CSrVE6

delta 70
zcmaFJ_nvQpGGpmRl?+CfRNHkECigHNXJnrIkWGB@2R63J1x(qDrJL_ConZpYZeGG_
N&WIxIG1-A#5de#87;FFl

diff --git a/lib/pytz/zoneinfo/America/Scoresbysund b/lib/pytz/zoneinfo/America/Scoresbysund
index 286d13216eb3b14bf9fec1fceebf2fe731472d39..9bf411ef5ad5f81f3863223ea75117404d5d1421 100644
GIT binary patch
delta 251
zcmaFI*UzsJ5|x=|%zyznfg&Ib0;NFAxlzNANrs&RH=NAIuEq2J|HluE9RL46e!##o
z*??W#n2`}=0+3{6B-W<QPnlR*NViG{$to@zT>~RKBOqyLr{im^XR2qQuWP8|YiIyw
H8gKys5jrGH

delta 204
zcmeC@f5)d05|x=|#DD?Vfg&Ib0;NFAzEQ)FY4QO!naN`8T5dkRAq=_(MnG)Hplx6P
zlxGA2kXj&vfmkCqe`R82fthKC-%KtWpj~!`HbC3#bbO8VO!W-(4Rm}B4ZtizE&#Rx
B8D#(f

diff --git a/lib/pytz/zoneinfo/America/Thunder_Bay b/lib/pytz/zoneinfo/America/Thunder_Bay
index 6752c5b05285678b86aea170f0921fc5f5e57738..170137333f9f6dba10ac3ad7f32876aaf518c4fd 100644
GIT binary patch
delta 82
zcmZ1`y-a$-FR^1Et|{z)aNTsphZ_tFAKVn}`f$s5Qo?2d#`UaP$3FZA0+2k22B`tj
SAax)bq!vVj)xTuh%LV{v;5Kvs

delta 82
zcmZ1`y-a$-FR@h@t|=@&aNV@$!VQMj12;wUF5EIMbJ#4vxSmyO)rJ2+0FnpMAT=Nw
Rqz*)b)PiWR`j>2b*#PJ9Go%0j

diff --git a/lib/pytz/zoneinfo/America/Toronto b/lib/pytz/zoneinfo/America/Toronto
index 6752c5b05285678b86aea170f0921fc5f5e57738..170137333f9f6dba10ac3ad7f32876aaf518c4fd 100644
GIT binary patch
delta 82
zcmZ1`y-a$-FR^1Et|{z)aNTsphZ_tFAKVn}`f$s5Qo?2d#`UaP$3FZA0+2k22B`tj
SAax)bq!vVj)xTuh%LV{v;5Kvs

delta 82
zcmZ1`y-a$-FR@h@t|=@&aNV@$!VQMj12;wUF5EIMbJ#4vxSmyO)rJ2+0FnpMAT=Nw
Rqz*)b)PiWR`j>2b*#PJ9Go%0j

diff --git a/lib/pytz/zoneinfo/Antarctica/Casey b/lib/pytz/zoneinfo/Antarctica/Casey
index 4b98133d7af497a840e2630bc72a02439c4d774f..586a7653ef20d04440bfcb6645454ef215a1bba4 100644
GIT binary patch
literal 423
zcmWHE%1kq2zyK^j5fBCeK_CXPdH%_rY4Ezmrr_Ow>Vx0PIST&HXD38(SvN#2;TMSB
zDdG^*E87q|&D9_-`6xqt#R8iIpX~vO5luEpIx_>3EmCY!I5sjcGBGkS12G(eYyg3R
z29PDQHZX8N*t!M=4B7@34BCc<AZbPr4k5v@|A7GHV31~zqd_#t;UF61cn}Tp0Eh;8
z0z`v60-`~l0ns22foPDYKs3l>AOP|lhz5BOM1wpDqCp-7(IC%)Xo@||WdjTXJ6#Jd
E02EY6j{pDw

delta 150
zcmZ3^{E2CTxF9P70|N+y01ptePSh~rVPs-tVg_OmoY*KK!@w|W0|SSyfdPZIfdzxM
ep&>{$BZR<e#?=&bGt}^z!DRz9(@xjWkP86iFc5wK

diff --git a/lib/pytz/zoneinfo/Antarctica/Vostok b/lib/pytz/zoneinfo/Antarctica/Vostok
index 62bdcac14db3f464ff561e32db2c6b55c0cb1866..016e06b1bbc8d2e73d07265ef12e2be0c77982f4 100644
GIT binary patch
literal 213
zcmWHE%1kq2zzbM_vdlot^D?5dLD$z(KyPa+Lu$RN0V4w=6HI4P0RvE-TL1%xu7LrA
nwt+bin=*uuVETU`0NDUC5o8O92H6Ax#M#DW1GLjl*OUtYQs^4%

literal 151
zcmWHE%1kq2zzZ0GvP?kCvEkpY6d)%^2BbVBfq})xH-tgkz>Fb;1VjD<0ZxOsY=Fku
I>6&o?0LBIr)c^nh

diff --git a/lib/pytz/zoneinfo/Asia/Almaty b/lib/pytz/zoneinfo/Asia/Almaty
index 91c916a3a5d7949cc304532fe3fb2eac117ab2ef..855abbd6e3ee338c3d46bee7b592f3d645d2c273 100644
GIT binary patch
delta 134
zcmcc4ew}@SG%qIu1egFR&WRcqSW+JxQ<(U}n2~X^Hlvw{k8cQrwt*=Sn**^KSncE*
hMg>%Tn^!W<VdMZwqUct_rkfE2xNLxi+Uc5d0RR-{7=!=-

delta 133
zcmcc4ew}@SG%pte1Q-J;u8A5KCjK#=Y`|!yz`ziaz`*0<8^WM%U<$<MKx_t9$_NJN
YS~o9eoWls!tVu{SmkrP`J6$s_02}%hM*si-

diff --git a/lib/pytz/zoneinfo/Asia/Gaza b/lib/pytz/zoneinfo/Asia/Gaza
index c9b2ff90823a5809d877fb68c10494a38ab183b1..dd5781e8ae26ed66aa2650c580c561fae50df4b5 100644
GIT binary patch
delta 1064
zcmXBSTS${(7zgloT8O6=q*<Zj;UYvUGQ}VjyD3B|lDz2bO^Q;up%;bF-ejAHOr4*b
zo7%Ld28B@04v-z3I_LQ`4^2hAh!72@9Y7K6d;Z^U{_pSkKkvJXZ8=08`X<oBH*!DE
z365~*Y_~IOm`AZp7H741E_xmk=S=)ihZK83@LE@?gVxAQy&kHd)Wp~+m?nM;*2=s%
zS!?UVMeWWRA}a}WqAyuq<>XS+eYkYoCHe1rxa`{yT%PTM%U>4LIxC+xl2z<Ub33O&
zMbcw8vT%cfReb4$pYkeBt_+C61C?n8$z}uksw^d3wPHYD9g$4ytoqRd^t#kaSobkW
z^2Tep=Js{bD#irqT_$K=VL`BGaN4L%PK5Q|8MvUonW3PAUiiu>4acv+hSfMCtBc*n
zeqCM;Z1g&Z-Z*d=HnD8<rt@-61JlnC1${rO?}){qepZeP4e}zm!M+DK)&#(fEk%-l
zM2fc<d)BrBo0b32n~S91*8FJ@ZqoLkZ!SxKpXV>R#cS-voh1rpx!mnOLWh<U=@hK>
zlm!cIp1-+Z@%g37x{G;tt_}~`qVK`By(YLP!H?6RC$#|X^}U3?cf=3w^Y4WFqB14_
z$>TJzTdZ#6d^iQ`_fA0H?@Z@phcXPk%JJ4A4OWk0VW9IQJb2Lo50)a>;AA{54AmY)
zKOCA54`(il&oMUK5d@DEY@r`nTYyJn)bOZI`sv1Q9T2w}8?&huVyM{I_9mynxN;sB
zCK5M^Y{C>RdE5j~Uil191y8|K*+$7PQ#cKrr<-8s?mP6;Nhu0COczRj{+VN4@XSIT
z`dOcL(H9t-P0N%9J7z4*bv=aVR<63~@I8E&BV8Q5t5pxXKI}@~$mP~Z|Fbe-*<+t@
HL$3J`1v@2F

delta 1028
zcmXBST}V@57zgloT8UO>r1^mk$)N8nNet2`yO2VNB#gqOZuCOJEpHN`bINU++Wa_f
zZfZw!8W9NLEDJPhrkkHjH=Rx+g|I|}lTefxcAoz^H}CU%{{Q#v;!LMrh<h0kuswQ&
z<;U)m@};}HJwD)}N_E0+3;Z0oN8Zyz8BRGDgrHTfH1jKh((Et|4Z6q`ShuQ%^$C?c
zE%eE2ut60B8yo|8kwN+cmqmDymn|&A<<>iJxwDngQ~v8U{OJ7%Pp-)GlQ~u)W+;m(
z3ksF3op4p!14%Bhs)BCC@4Df~d^KzgKZL$9J%?({D4LO1-_jzlUNj@Gi4KHo?%zXR
zd(lXBR{JJRHYX2D8WiesZ=fJ3?`4Aih2p*_T&O>r3Y&tnU{g+(h6YoG9yTAi4x5)x
z!3{}&(QmkYl&6Iy=nQhp&|c(LmM78gGi!=hS$vB_p|LB8r$wVL6mHsj9(mK?Cfr;X
zj=Z_OMDg5r_{p<HSk(T8#S-OPi(NIi-(u)T-pc)hpB8?R4${<?-Okf#yZk|-vwi<=
zp3aU$8{Dz}mI*@05ANDw>>Zmecv1hcNvg4rV>{r1Eyc(OZFbxnoLGXL!70d{-b~n~
zjYsZ!u6zpDay0Ux?&HXZGhFa6m#la)8GUY~J`9Udbs-j`nQe-@BH^*3HF#`g9v)A)
z#ON8XRX&CL<}TRn&}nFJOFi%>?Hu|OsXyTf>k-AyT%Hz_SNg~t^Tc|{%#&w9!6R;i
zy(e2>@5U>5D(#$xhN*%gcsiyRo}O=jeIcE&FFl5*g>PMiXL^f~&n#Y*Xqb(1z_Wf{
e&gK7&zr)1S#^1An3;v}<X1}oWv`XMY_5T6&(HjE*

diff --git a/lib/pytz/zoneinfo/Asia/Hebron b/lib/pytz/zoneinfo/Asia/Hebron
index 64194fd85c676a5407878a197f6f9a011f2ff067..a64fc9e7b2599e8f60d228ef3cf1743b5296cd4f 100644
GIT binary patch
delta 457
zcmXAlKS)AR6o;?AqVnHT(9#vurO0Rq5(1-W3Zo!!l!6FRf`o*I5H9hI8sk9F5L#9a
zAr!AIB>YPRfpZ~FO(`0+7)t%#?JXbQIq=Tq>+q!gmK)8kUJ)E|wu0>p(?*S|!7#05
zl!h{hIm4&#B(bMVUwud&{?MJNb$di-++Ajr?dQtR6r(Cwc@@+J)BBA009T?-Mqbc&
zA}9blXBox7<_)7Wu)HcL3(}*YDi{tj>Voq&LEOX@+nyjV`0ip9F!6<lXQAIs92DgJ
z<dH}E`F2e{^kS{1uUTp(C;f6_N&3}fO8T|(g?pyP#`>n5=R(KwKl$-3>G|J;^n%AC
z^g&^9M|#n`EceA1i}aH9UV3TF|L@;np%2O_ttI*9Ko2ul?w-&CJdB`+g)9CldVp>f
tJ;3&-pcq&=MGr7NhxdWe40?b*KYD<U4tiM8EhIFrb;dv~V-M}x;(rGmik$!e

delta 421
zcmW;FJxD@P6bJC5w@>v&(U3;hAsr%m2t@>eLpB7VwAqqDlY>N3Q$u(`Z77Q1jFFlj
z&>}=Hhz5tWbO?u{EutkP$OmtXNb0<Mm*4%LbI(0F_b<QXR=evFqGRJm)Yul<gf(Tc
zOlxJPvtg>6$LvX|kLBLBHyQkpjbwN*ZeCI&UoxlKZkf}bLweZ9nei>KNj7qTI+<A#
zsPuCdyB4UDfi=Jo>0$ym$yQw85m|8pmdS%OV3XXK5~!1NFMx`Tv+e~zm3;ja7_#xj
zs}s3DyI+(0bBT`3=UeZFdC7;1!nCk*Cv(v|By-7Ekh%18OZ#m4%<819SO2o|pPKq?
zj=_D?A@f7muI$$fnw+aYwFGwToLw9PatCLLS%H2sm=_o!J<EW5q;UgyMmE+3R>({b
f;2Rm+0ql^0QGs0H%vlBWlPw=;5oO+jrvvGK>WF^6

diff --git a/lib/pytz/zoneinfo/Asia/Ho_Chi_Minh b/lib/pytz/zoneinfo/Asia/Ho_Chi_Minh
index a213d290e1a920271e924506a57191f1f4bfc4c0..9c45ed991a230919d129c63c660aa8d1ad74d0ea 100644
GIT binary patch
delta 25
hcmcb}bdhO-8|$YDZ}n$PW@L1qI4Ozg(}aoNq5+R=3x5Cr

delta 25
hcmcb}bdhO-8|#yXxB4?CGcvkQoRq}$q+#N>XaJ1b3qt?^

diff --git a/lib/pytz/zoneinfo/Asia/Qostanay b/lib/pytz/zoneinfo/Asia/Qostanay
index f8baf676496adea298f078d6d5931ba7aa64e902..2ee9ef7e9859bc95da2450e3b282fd4275cbbb39 100644
GIT binary patch
delta 113
zcmaFL-pDaQnwN(G0!)Au&qR$2EU6EUDNOcZHfCg+T+i&p#=zhfz`!y2AhR?h1G@6f
Z8yM#>a)9*X)WpTWWut9iYNu<;1pxiI75@ML

delta 78
zcmZqVc*;IOnwOga0*rwa_e6~glM|SYCmS$2O}@h{jV`@;591t0WCfgDHrfVecDiO<
E0Bdg$5dZ)H

diff --git a/lib/pytz/zoneinfo/Asia/Saigon b/lib/pytz/zoneinfo/Asia/Saigon
index a213d290e1a920271e924506a57191f1f4bfc4c0..9c45ed991a230919d129c63c660aa8d1ad74d0ea 100644
GIT binary patch
delta 25
hcmcb}bdhO-8|$YDZ}n$PW@L1qI4Ozg(}aoNq5+R=3x5Cr

delta 25
hcmcb}bdhO-8|#yXxB4?CGcvkQoRq}$q+#N>XaJ1b3qt?^

diff --git a/lib/pytz/zoneinfo/Canada/Eastern b/lib/pytz/zoneinfo/Canada/Eastern
index 6752c5b05285678b86aea170f0921fc5f5e57738..170137333f9f6dba10ac3ad7f32876aaf518c4fd 100644
GIT binary patch
delta 82
zcmZ1`y-a$-FR^1Et|{z)aNTsphZ_tFAKVn}`f$s5Qo?2d#`UaP$3FZA0+2k22B`tj
SAax)bq!vVj)xTuh%LV{v;5Kvs

delta 82
zcmZ1`y-a$-FR@h@t|=@&aNV@$!VQMj12;wUF5EIMbJ#4vxSmyO)rJ2+0FnpMAT=Nw
Rqz*)b)PiWR`j>2b*#PJ9Go%0j

diff --git a/lib/pytz/zoneinfo/iso3166.tab b/lib/pytz/zoneinfo/iso3166.tab
index be3348d1..402c015e 100644
--- a/lib/pytz/zoneinfo/iso3166.tab
+++ b/lib/pytz/zoneinfo/iso3166.tab
@@ -3,17 +3,22 @@
 # This file is in the public domain, so clarified as of
 # 2009-05-17 by Arthur David Olson.
 #
-# From Paul Eggert (2022-11-18):
+# From Paul Eggert (2023-09-06):
 # This file contains a table of two-letter country codes.  Columns are
 # separated by a single tab.  Lines beginning with '#' are comments.
 # All text uses UTF-8 encoding.  The columns of the table are as follows:
 #
 # 1.  ISO 3166-1 alpha-2 country code, current as of
-#     ISO 3166-1 N1087 (2022-09-02).  See: Updates on ISO 3166-1
-#     https://isotc.iso.org/livelink/livelink/Open/16944257
-# 2.  The usual English name for the coded region,
-#     chosen so that alphabetic sorting of subsets produces helpful lists.
-#     This is not the same as the English name in the ISO 3166 tables.
+#     ISO/TC 46 N1108 (2023-04-05).  See: ISO/TC 46 Documents
+#     https://www.iso.org/committee/48750.html?view=documents
+# 2.  The usual English name for the coded region.  This sometimes
+#     departs from ISO-listed names, sometimes so that sorted subsets
+#     of names are useful (e.g., "Samoa (American)" and "Samoa
+#     (western)" rather than "American Samoa" and "Samoa"),
+#     sometimes to avoid confusion among non-experts (e.g.,
+#     "Czech Republic" and "Turkey" rather than "Czechia" and "Türkiye"),
+#     and sometimes to omit needless detail or churn (e.g., "Netherlands"
+#     rather than "Netherlands (the)" or "Netherlands (Kingdom of the)").
 #
 # The table is sorted by country code.
 #
diff --git a/lib/pytz/zoneinfo/leapseconds b/lib/pytz/zoneinfo/leapseconds
index a6a170aa..ce150bfe 100644
--- a/lib/pytz/zoneinfo/leapseconds
+++ b/lib/pytz/zoneinfo/leapseconds
@@ -3,13 +3,10 @@
 # This file is in the public domain.
 
 # This file is generated automatically from the data in the public-domain
-# NIST format leap-seconds.list file, which can be copied from
-# <ftp://ftp.nist.gov/pub/time/leap-seconds.list>
-# or <ftp://ftp.boulder.nist.gov/pub/time/leap-seconds.list>.
-# The NIST file is used instead of its IERS upstream counterpart
+# NIST/IERS format leap-seconds.list file, which can be copied from
 # <https://hpiers.obspm.fr/iers/bul/bulc/ntp/leap-seconds.list>
-# because under US law the NIST file is public domain
-# whereas the IERS file's copyright and license status is unclear.
+# or, in a variant with different comments, from
+# <ftp://ftp.boulder.nist.gov/pub/time/leap-seconds.list>.
 # For more about leap-seconds.list, please see
 # The NTP Timescale and Leap Seconds
 # <https://www.eecis.udel.edu/~mills/leap.html>.
@@ -72,11 +69,11 @@ Leap	2016	Dec	31	23:59:60	+	S
 # Any additional leap seconds will come after this.
 # This Expires line is commented out for now,
 # so that pre-2020a zic implementations do not reject this file.
-#Expires 2023	Dec	28	00:00:00
+#Expires 2024	Dec	28	00:00:00
 
 # POSIX timestamps for the data in this file:
-#updated 1467936000 (2016-07-08 00:00:00 UTC)
-#expires 1703721600 (2023-12-28 00:00:00 UTC)
+#updated 1704708379 (2024-01-08 10:06:19 UTC)
+#expires 1735344000 (2024-12-28 00:00:00 UTC)
 
-#	Updated through IERS Bulletin C65
-#	File expires on:  28 December 2023
+#	Updated through IERS Bulletin C (https://hpiers.obspm.fr/iers/bul/bulc/bulletinc.dat)
+#	File expires on 28 December 2024
diff --git a/lib/pytz/zoneinfo/tzdata.zi b/lib/pytz/zoneinfo/tzdata.zi
index 23d99be4..b5a03be7 100644
--- a/lib/pytz/zoneinfo/tzdata.zi
+++ b/lib/pytz/zoneinfo/tzdata.zi
@@ -1,4 +1,4 @@
-# version unknown-dirty
+# version unknown
 # This zic input file is in the public domain.
 R d 1916 o - Jun 14 23s 1 S
 R d 1916 1919 - O Su>=1 23s 0 -
@@ -22,27 +22,6 @@ R d 1978 o - Mar 24 1 1 S
 R d 1978 o - S 22 3 0 -
 R d 1980 o - Ap 25 0 1 S
 R d 1980 o - O 31 2 0 -
-Z Africa/Algiers 0:12:12 - LMT 1891 Mar 16
-0:9:21 - PMT 1911 Mar 11
-0 d WE%sT 1940 F 25 2
-1 d CE%sT 1946 O 7
-0 - WET 1956 Ja 29
-1 - CET 1963 Ap 14
-0 d WE%sT 1977 O 21
-1 d CE%sT 1979 O 26
-0 d WE%sT 1981 May
-1 - CET
-Z Atlantic/Cape_Verde -1:34:4 - LMT 1912 Ja 1 2u
--2 - -02 1942 S
--2 1 -01 1945 O 15
--2 - -02 1975 N 25 2
--1 - -01
-Z Africa/Ndjamena 1:0:12 - LMT 1912
-1 - WAT 1979 O 14
-1 1 WAST 1980 Mar 8
-1 - WAT
-Z Africa/Abidjan -0:16:8 - LMT 1912
-0 - GMT
 R K 1940 o - Jul 15 0 1 S
 R K 1940 o - O 1 0 0 -
 R K 1941 o - Ap 15 0 1 S
@@ -77,21 +56,6 @@ R K 2014 o - Jul 31 24 1 S
 R K 2014 o - S lastTh 24 0 -
 R K 2023 ma - Ap lastF 0 1 S
 R K 2023 ma - O lastTh 24 0 -
-Z Africa/Cairo 2:5:9 - LMT 1900 O
-2 K EE%sT
-Z Africa/Bissau -1:2:20 - LMT 1912 Ja 1 1u
--1 - -01 1975
-0 - GMT
-Z Africa/Nairobi 2:27:16 - LMT 1908 May
-2:30 - +0230 1928 Jun 30 24
-3 - EAT 1930 Ja 4 24
-2:30 - +0230 1936 D 31 24
-2:45 - +0245 1942 Jul 31 24
-3 - EAT
-Z Africa/Monrovia -0:43:8 - LMT 1882
--0:43:8 - MMT 1919 Mar
--0:44:30 - MMT 1972 Ja 7
-0 - GMT
 R L 1951 o - O 14 2 1 S
 R L 1952 o - Ja 1 0 0 -
 R L 1953 o - O 9 2 1 S
@@ -109,21 +73,10 @@ R L 1997 o - Ap 4 0 1 S
 R L 1997 o - O 4 0 0 -
 R L 2013 o - Mar lastF 1 1 S
 R L 2013 o - O lastF 2 0 -
-Z Africa/Tripoli 0:52:44 - LMT 1920
-1 L CE%sT 1959
-2 - EET 1982
-1 L CE%sT 1990 May 4
-2 - EET 1996 S 30
-1 L CE%sT 1997 O 4
-2 - EET 2012 N 10 2
-1 L CE%sT 2013 O 25 2
-2 - EET
 R MU 1982 o - O 10 0 1 -
 R MU 1983 o - Mar 21 0 0 -
 R MU 2008 o - O lastSu 2 1 -
 R MU 2009 o - Mar lastSu 2 0 -
-Z Indian/Mauritius 3:50 - LMT 1907
-4 MU +04/+05
 R M 1939 o - S 12 0 1 -
 R M 1939 o - N 19 0 0 -
 R M 1940 o - F 25 0 1 -
@@ -307,53 +260,15 @@ R M 2086 o - Ap 14 3 -1 -
 R M 2086 o - May 19 2 0 -
 R M 2087 o - Mar 30 3 -1 -
 R M 2087 o - May 11 2 0 -
-Z Africa/Casablanca -0:30:20 - LMT 1913 O 26
-0 M +00/+01 1984 Mar 16
-1 - +01 1986
-0 M +00/+01 2018 O 28 3
-1 M +01/+00
-Z Africa/El_Aaiun -0:52:48 - LMT 1934
--1 - -01 1976 Ap 14
-0 M +00/+01 2018 O 28 3
-1 M +01/+00
-Z Africa/Maputo 2:10:20 - LMT 1903 Mar
-2 - CAT
 R NA 1994 o - Mar 21 0 -1 WAT
 R NA 1994 2017 - S Su>=1 2 0 CAT
 R NA 1995 2017 - Ap Su>=1 2 -1 WAT
-Z Africa/Windhoek 1:8:24 - LMT 1892 F 8
-1:30 - +0130 1903 Mar
-2 - SAST 1942 S 20 2
-2 1 SAST 1943 Mar 21 2
-2 - SAST 1990 Mar 21
-2 NA %s
-Z Africa/Lagos 0:13:35 - LMT 1905 Jul
-0 - GMT 1908 Jul
-0:13:35 - LMT 1914
-0:30 - +0030 1919 S
-1 - WAT
-Z Africa/Sao_Tome 0:26:56 - LMT 1884
--0:36:45 - LMT 1912 Ja 1 0u
-0 - GMT 2018 Ja 1 1
-1 - WAT 2019 Ja 1 2
-0 - GMT
 R SA 1942 1943 - S Su>=15 2 1 -
 R SA 1943 1944 - Mar Su>=15 2 0 -
-Z Africa/Johannesburg 1:52 - LMT 1892 F 8
-1:30 - SAST 1903 Mar
-2 SA SAST
 R SD 1970 o - May 1 0 1 S
 R SD 1970 1985 - O 15 0 0 -
 R SD 1971 o - Ap 30 0 1 S
 R SD 1972 1985 - Ap lastSu 0 1 S
-Z Africa/Khartoum 2:10:8 - LMT 1931
-2 SD CA%sT 2000 Ja 15 12
-3 - EAT 2017 N
-2 - CAT
-Z Africa/Juba 2:6:28 - LMT 1931
-2 SD CA%sT 2000 Ja 15 12
-3 - EAT 2021 F
-2 - CAT
 R n 1939 o - Ap 15 23s 1 S
 R n 1939 o - N 18 23s 0 -
 R n 1940 o - F 25 23s 1 S
@@ -379,80 +294,14 @@ R n 2005 o - May 1 0s 1 S
 R n 2005 o - S 30 1s 0 -
 R n 2006 2008 - Mar lastSu 2s 1 S
 R n 2006 2008 - O lastSu 2s 0 -
-Z Africa/Tunis 0:40:44 - LMT 1881 May 12
-0:9:21 - PMT 1911 Mar 11
-1 n CE%sT
-Z Antarctica/Casey 0 - -00 1969
-8 - +08 2009 O 18 2
-11 - +11 2010 Mar 5 2
-8 - +08 2011 O 28 2
-11 - +11 2012 F 21 17u
-8 - +08 2016 O 22
-11 - +11 2018 Mar 11 4
-8 - +08 2018 O 7 4
-11 - +11 2019 Mar 17 3
-8 - +08 2019 O 4 3
-11 - +11 2020 Mar 8 3
-8 - +08 2020 O 4 0:1
-11 - +11
-Z Antarctica/Davis 0 - -00 1957 Ja 13
-7 - +07 1964 N
-0 - -00 1969 F
-7 - +07 2009 O 18 2
-5 - +05 2010 Mar 10 20u
-7 - +07 2011 O 28 2
-5 - +05 2012 F 21 20u
-7 - +07
-Z Antarctica/Mawson 0 - -00 1954 F 13
-6 - +06 2009 O 18 2
-5 - +05
 R Tr 2005 ma - Mar lastSu 1u 2 +02
 R Tr 2004 ma - O lastSu 1u 0 +00
-Z Antarctica/Troll 0 - -00 2005 F 12
-0 Tr %s
-Z Antarctica/Rothera 0 - -00 1976 D
--3 - -03
-Z Asia/Kabul 4:36:48 - LMT 1890
-4 - +04 1945
-4:30 - +0430
 R AM 2011 o - Mar lastSu 2s 1 -
 R AM 2011 o - O lastSu 2s 0 -
-Z Asia/Yerevan 2:58 - LMT 1924 May 2
-3 - +03 1957 Mar
-4 R +04/+05 1991 Mar 31 2s
-3 R +03/+04 1995 S 24 2s
-4 - +04 1997
-4 R +04/+05 2011
-4 AM +04/+05
 R AZ 1997 2015 - Mar lastSu 4 1 -
 R AZ 1997 2015 - O lastSu 5 0 -
-Z Asia/Baku 3:19:24 - LMT 1924 May 2
-3 - +03 1957 Mar
-4 R +04/+05 1991 Mar 31 2s
-3 R +03/+04 1992 S lastSu 2s
-4 - +04 1996
-4 E +04/+05 1997
-4 AZ +04/+05
 R BD 2009 o - Jun 19 23 1 -
 R BD 2009 o - D 31 24 0 -
-Z Asia/Dhaka 6:1:40 - LMT 1890
-5:53:20 - HMT 1941 O
-6:30 - +0630 1942 May 15
-5:30 - +0530 1942 S
-6:30 - +0630 1951 S 30
-6 - +06 2009
-6 BD +06/+07
-Z Asia/Thimphu 5:58:36 - LMT 1947 Au 15
-5:30 - +0530 1987 O
-6 - +06
-Z Indian/Chagos 4:49:40 - LMT 1907
-5 - +05 1996
-6 - +06
-Z Asia/Yangon 6:24:47 - LMT 1880
-6:24:47 - RMT 1920
-6:30 - +0630 1942 May
-9 - +09 1945 May 3
-6:30 - +0630
 R Sh 1919 o - Ap 12 24 1 D
 R Sh 1919 o - S 30 24 0 S
 R Sh 1940 o - Jun 1 0 1 D
@@ -470,11 +319,6 @@ R Sh 1948 1949 - S 30 24 0 S
 R CN 1986 o - May 4 2 1 D
 R CN 1986 1991 - S Su>=11 2 0 S
 R CN 1987 1991 - Ap Su>=11 2 1 D
-Z Asia/Shanghai 8:5:43 - LMT 1901
-8 Sh C%sT 1949 May 28
-8 CN C%sT
-Z Asia/Urumqi 5:50:20 - LMT 1928
-6 - +06
 R HK 1946 o - Ap 21 0 1 S
 R HK 1946 o - D 1 3:30s 0 -
 R HK 1947 o - Ap 13 3:30s 1 S
@@ -489,12 +333,6 @@ R HK 1965 1976 - O Su>=16 3:30 0 -
 R HK 1973 o - D 30 3:30 1 S
 R HK 1979 o - May 13 3:30 1 S
 R HK 1979 o - O 21 3:30 0 -
-Z Asia/Hong_Kong 7:36:42 - LMT 1904 O 29 17u
-8 - HKT 1941 Jun 15 3
-8 1 HKST 1941 O 1 4
-8 0:30 HKWT 1941 D 25
-9 - JST 1945 N 18 2
-8 HK HK%sT
 R f 1946 o - May 15 0 1 D
 R f 1946 o - O 1 0 0 S
 R f 1947 o - Ap 15 0 1 D
@@ -510,10 +348,6 @@ R f 1974 1975 - Ap 1 0 1 D
 R f 1974 1975 - O 1 0 0 S
 R f 1979 o - Jul 1 0 1 D
 R f 1979 o - O 1 0 0 S
-Z Asia/Taipei 8:6 - LMT 1896
-8 - CST 1937 O
-9 - JST 1945 S 21 1
-8 f C%sT
 R _ 1942 1943 - Ap 30 23 1 -
 R _ 1942 o - N 17 23 0 -
 R _ 1943 o - S 30 23 0 S
@@ -541,10 +375,6 @@ R _ 1973 o - D 30 3:30 1 D
 R _ 1975 1976 - Ap Su>=16 3:30 1 D
 R _ 1979 o - May 13 3:30 1 D
 R _ 1979 o - O Su>=16 3:30 0 S
-Z Asia/Macau 7:34:10 - LMT 1904 O 30
-8 - CST 1941 D 21 23
-9 _ +09/+10 1945 S 30 24
-8 _ C%sT
 R CY 1975 o - Ap 13 0 1 S
 R CY 1975 o - O 12 0 0 -
 R CY 1976 o - May 15 0 1 S
@@ -554,65 +384,6 @@ R CY 1977 o - S 25 0 0 -
 R CY 1978 o - O 2 0 0 -
 R CY 1979 1997 - S lastSu 0 0 -
 R CY 1981 1998 - Mar lastSu 0 1 S
-Z Asia/Nicosia 2:13:28 - LMT 1921 N 14
-2 CY EE%sT 1998 S
-2 E EE%sT
-Z Asia/Famagusta 2:15:48 - LMT 1921 N 14
-2 CY EE%sT 1998 S
-2 E EE%sT 2016 S 8
-3 - +03 2017 O 29 1u
-2 E EE%sT
-Z Asia/Tbilisi 2:59:11 - LMT 1880
-2:59:11 - TBMT 1924 May 2
-3 - +03 1957 Mar
-4 R +04/+05 1991 Mar 31 2s
-3 R +03/+04 1992
-3 e +03/+04 1994 S lastSu
-4 e +04/+05 1996 O lastSu
-4 1 +05 1997 Mar lastSu
-4 e +04/+05 2004 Jun 27
-3 R +03/+04 2005 Mar lastSu 2
-4 - +04
-Z Asia/Dili 8:22:20 - LMT 1912
-8 - +08 1942 F 21 23
-9 - +09 1976 May 3
-8 - +08 2000 S 17
-9 - +09
-Z Asia/Kolkata 5:53:28 - LMT 1854 Jun 28
-5:53:20 - HMT 1870
-5:21:10 - MMT 1906
-5:30 - IST 1941 O
-5:30 1 +0630 1942 May 15
-5:30 - IST 1942 S
-5:30 1 +0630 1945 O 15
-5:30 - IST
-Z Asia/Jakarta 7:7:12 - LMT 1867 Au 10
-7:7:12 - BMT 1923 D 31 16:40u
-7:20 - +0720 1932 N
-7:30 - +0730 1942 Mar 23
-9 - +09 1945 S 23
-7:30 - +0730 1948 May
-8 - +08 1950 May
-7:30 - +0730 1964
-7 - WIB
-Z Asia/Pontianak 7:17:20 - LMT 1908 May
-7:17:20 - PMT 1932 N
-7:30 - +0730 1942 Ja 29
-9 - +09 1945 S 23
-7:30 - +0730 1948 May
-8 - +08 1950 May
-7:30 - +0730 1964
-8 - WITA 1988
-7 - WIB
-Z Asia/Makassar 7:57:36 - LMT 1920
-7:57:36 - MMT 1932 N
-8 - +08 1942 F 9
-9 - +09 1945 S 23
-8 - WITA
-Z Asia/Jayapura 9:22:48 - LMT 1932 N
-9 - +09 1944 S
-9:30 - +0930 1964
-9 - WIT
 R i 1910 o - Ja 1 0 0 -
 R i 1977 o - Mar 21 23 1 -
 R i 1977 o - O 20 24 0 -
@@ -653,11 +424,6 @@ R i 2020 o - Mar 20 24 1 -
 R i 2020 o - S 20 24 0 -
 R i 2021 2022 - Mar 21 24 1 -
 R i 2021 2022 - S 21 24 0 -
-Z Asia/Tehran 3:25:44 - LMT 1916
-3:25:44 - TMT 1935 Jun 13
-3:30 i +0330/+0430 1977 O 20 24
-4 i +04/+05 1979
-3:30 i +0330/+0430
 R IQ 1982 o - May 1 0 1 -
 R IQ 1982 1984 - O 1 0 0 -
 R IQ 1983 o - Mar 31 0 1 -
@@ -666,10 +432,6 @@ R IQ 1985 1990 - S lastSu 1s 0 -
 R IQ 1986 1990 - Mar lastSu 1s 1 -
 R IQ 1991 2007 - Ap 1 3s 1 -
 R IQ 1991 2007 - O 1 3s 0 -
-Z Asia/Baghdad 2:57:40 - LMT 1890
-2:57:36 - BMT 1918
-3 - +03 1982 May
-3 IQ +03/+04
 R Z 1940 o - May 31 24u 1 D
 R Z 1940 o - S 30 24u 0 S
 R Z 1940 o - N 16 24u 1 D
@@ -755,15 +517,10 @@ R Z 2011 o - O 2 2 0 S
 R Z 2012 o - S 23 2 0 S
 R Z 2013 ma - Mar F>=23 2 1 D
 R Z 2013 ma - O lastSu 2 0 S
-Z Asia/Jerusalem 2:20:54 - LMT 1880
-2:20:40 - JMT 1918
-2 Z I%sT
 R JP 1948 o - May Sa>=1 24 1 D
 R JP 1948 1951 - S Sa>=8 25 0 S
 R JP 1949 o - Ap Sa>=1 24 1 D
 R JP 1950 1951 - May Sa>=1 24 1 D
-Z Asia/Tokyo 9:18:59 - LMT 1887 D 31 15u
-9 JP J%sT
 R J 1973 o - Jun 6 0 1 S
 R J 1973 1975 - O 1 0 0 -
 R J 1974 1977 - May 1 0 1 S
@@ -796,83 +553,10 @@ R J 2013 o - D 20 0 0 -
 R J 2014 2021 - Mar lastTh 24 1 S
 R J 2014 2022 - O lastF 0s 0 -
 R J 2022 o - F lastTh 24 1 S
-Z Asia/Amman 2:23:44 - LMT 1931
-2 J EE%sT 2022 O 28 0s
-3 - +03
-Z Asia/Almaty 5:7:48 - LMT 1924 May 2
-5 - +05 1930 Jun 21
-6 R +06/+07 1991 Mar 31 2s
-5 R +05/+06 1992 Ja 19 2s
-6 R +06/+07 2004 O 31 2s
-6 - +06
-Z Asia/Qyzylorda 4:21:52 - LMT 1924 May 2
-4 - +04 1930 Jun 21
-5 - +05 1981 Ap
-5 1 +06 1981 O
-6 - +06 1982 Ap
-5 R +05/+06 1991 Mar 31 2s
-4 R +04/+05 1991 S 29 2s
-5 R +05/+06 1992 Ja 19 2s
-6 R +06/+07 1992 Mar 29 2s
-5 R +05/+06 2004 O 31 2s
-6 - +06 2018 D 21
-5 - +05
-Z Asia/Qostanay 4:14:28 - LMT 1924 May 2
-4 - +04 1930 Jun 21
-5 - +05 1981 Ap
-5 1 +06 1981 O
-6 - +06 1982 Ap
-5 R +05/+06 1991 Mar 31 2s
-4 R +04/+05 1992 Ja 19 2s
-5 R +05/+06 2004 O 31 2s
-6 - +06
-Z Asia/Aqtobe 3:48:40 - LMT 1924 May 2
-4 - +04 1930 Jun 21
-5 - +05 1981 Ap
-5 1 +06 1981 O
-6 - +06 1982 Ap
-5 R +05/+06 1991 Mar 31 2s
-4 R +04/+05 1992 Ja 19 2s
-5 R +05/+06 2004 O 31 2s
-5 - +05
-Z Asia/Aqtau 3:21:4 - LMT 1924 May 2
-4 - +04 1930 Jun 21
-5 - +05 1981 O
-6 - +06 1982 Ap
-5 R +05/+06 1991 Mar 31 2s
-4 R +04/+05 1992 Ja 19 2s
-5 R +05/+06 1994 S 25 2s
-4 R +04/+05 2004 O 31 2s
-5 - +05
-Z Asia/Atyrau 3:27:44 - LMT 1924 May 2
-3 - +03 1930 Jun 21
-5 - +05 1981 O
-6 - +06 1982 Ap
-5 R +05/+06 1991 Mar 31 2s
-4 R +04/+05 1992 Ja 19 2s
-5 R +05/+06 1999 Mar 28 2s
-4 R +04/+05 2004 O 31 2s
-5 - +05
-Z Asia/Oral 3:25:24 - LMT 1924 May 2
-3 - +03 1930 Jun 21
-5 - +05 1981 Ap
-5 1 +06 1981 O
-6 - +06 1982 Ap
-5 R +05/+06 1989 Mar 26 2s
-4 R +04/+05 1992 Ja 19 2s
-5 R +05/+06 1992 Mar 29 2s
-4 R +04/+05 2004 O 31 2s
-5 - +05
 R KG 1992 1996 - Ap Su>=7 0s 1 -
 R KG 1992 1996 - S lastSu 0 0 -
 R KG 1997 2005 - Mar lastSu 2:30 1 -
 R KG 1997 2004 - O lastSu 2:30 0 -
-Z Asia/Bishkek 4:58:24 - LMT 1924 May 2
-5 - +05 1930 Jun 21
-6 R +06/+07 1991 Mar 31 2s
-5 R +05/+06 1991 Au 31 2
-5 KG +05/+06 2005 Au 12
-6 - +06
 R KR 1948 o - Jun 1 0 1 D
 R KR 1948 o - S 12 24 0 S
 R KR 1949 o - Ap 3 0 1 D
@@ -887,18 +571,6 @@ R KR 1957 1960 - May Su>=1 0 1 D
 R KR 1957 1960 - S Sa>=17 24 0 S
 R KR 1987 1988 - May Su>=8 2 1 D
 R KR 1987 1988 - O Su>=8 3 0 S
-Z Asia/Seoul 8:27:52 - LMT 1908 Ap
-8:30 - KST 1912
-9 - JST 1945 S 8
-9 KR K%sT 1954 Mar 21
-8:30 KR K%sT 1961 Au 10
-9 KR K%sT
-Z Asia/Pyongyang 8:23 - LMT 1908 Ap
-8:30 - KST 1912
-9 - JST 1945 Au 24
-9 - KST 2015 Au 15
-8:30 - KST 2018 May 4 23:30
-9 - KST
 R l 1920 o - Mar 28 0 1 S
 R l 1920 o - O 25 0 0 -
 R l 1921 o - Ap 3 0 1 S
@@ -923,18 +595,8 @@ R l 1992 o - O 4 0 0 -
 R l 1993 ma - Mar lastSu 0 1 S
 R l 1993 1998 - S lastSu 0 0 -
 R l 1999 ma - O lastSu 0 0 -
-Z Asia/Beirut 2:22 - LMT 1880
-2 l EE%sT
 R NB 1935 1941 - S 14 0 0:20 -
 R NB 1935 1941 - D 14 0 0 -
-Z Asia/Kuching 7:21:20 - LMT 1926 Mar
-7:30 - +0730 1933
-8 NB +08/+0820 1942 F 16
-9 - +09 1945 S 12
-8 - +08
-Z Indian/Maldives 4:54 - LMT 1880
-4:54 - MMT 1960
-5 - +05
 R X 1983 1984 - Ap 1 0 1 -
 R X 1983 o - O 1 0 0 -
 R X 1985 1998 - Mar lastSu 0 1 -
@@ -944,31 +606,11 @@ R X 2001 2006 - S lastSa 2 0 -
 R X 2002 2006 - Mar lastSa 2 1 -
 R X 2015 2016 - Mar lastSa 2 1 -
 R X 2015 2016 - S lastSa 0 0 -
-Z Asia/Hovd 6:6:36 - LMT 1905 Au
-6 - +06 1978
-7 X +07/+08
-Z Asia/Ulaanbaatar 7:7:32 - LMT 1905 Au
-7 - +07 1978
-8 X +08/+09
-Z Asia/Choibalsan 7:38 - LMT 1905 Au
-7 - +07 1978
-8 - +08 1983 Ap
-9 X +09/+10 2008 Mar 31
-8 X +08/+09
-Z Asia/Kathmandu 5:41:16 - LMT 1920
-5:30 - +0530 1986
-5:45 - +0545
 R PK 2002 o - Ap Su>=2 0 1 S
 R PK 2002 o - O Su>=2 0 0 -
 R PK 2008 o - Jun 1 0 1 S
 R PK 2008 2009 - N 1 0 0 -
 R PK 2009 o - Ap 15 0 1 S
-Z Asia/Karachi 4:28:12 - LMT 1907
-5:30 - +0530 1942 S
-5:30 1 +0630 1945 O 15
-5:30 - +0530 1951 S 30
-5 - +05 1971 Mar 26
-5 PK PK%sT
 R P 1999 2005 - Ap F>=15 0 1 S
 R P 1999 2003 - O F>=15 0 0 -
 R P 2004 o - O 1 1 0 -
@@ -1001,136 +643,90 @@ R P 2021 o - O 29 1 0 -
 R P 2022 o - Mar 27 0 1 S
 R P 2022 2035 - O Sa<=30 2 0 -
 R P 2023 o - Ap 29 2 1 S
-R P 2024 o - Ap 13 2 1 S
-R P 2025 o - Ap 5 2 1 S
+R P 2024 o - Ap 20 2 1 S
+R P 2025 o - Ap 12 2 1 S
 R P 2026 2054 - Mar Sa<=30 2 1 S
 R P 2036 o - O 18 2 0 -
 R P 2037 o - O 10 2 0 -
 R P 2038 o - S 25 2 0 -
 R P 2039 o - S 17 2 0 -
-R P 2039 o - O 22 2 1 S
-R P 2039 2067 - O Sa<=30 2 0 -
 R P 2040 o - S 1 2 0 -
-R P 2040 o - O 13 2 1 S
+R P 2040 o - O 20 2 1 S
+R P 2040 2067 - O Sa<=30 2 0 -
 R P 2041 o - Au 24 2 0 -
-R P 2041 o - S 28 2 1 S
+R P 2041 o - O 5 2 1 S
 R P 2042 o - Au 16 2 0 -
-R P 2042 o - S 20 2 1 S
+R P 2042 o - S 27 2 1 S
 R P 2043 o - Au 1 2 0 -
-R P 2043 o - S 12 2 1 S
+R P 2043 o - S 19 2 1 S
 R P 2044 o - Jul 23 2 0 -
-R P 2044 o - Au 27 2 1 S
+R P 2044 o - S 3 2 1 S
 R P 2045 o - Jul 15 2 0 -
-R P 2045 o - Au 19 2 1 S
+R P 2045 o - Au 26 2 1 S
 R P 2046 o - Jun 30 2 0 -
-R P 2046 o - Au 11 2 1 S
+R P 2046 o - Au 18 2 1 S
 R P 2047 o - Jun 22 2 0 -
-R P 2047 o - Jul 27 2 1 S
+R P 2047 o - Au 3 2 1 S
 R P 2048 o - Jun 6 2 0 -
-R P 2048 o - Jul 18 2 1 S
+R P 2048 o - Jul 25 2 1 S
 R P 2049 o - May 29 2 0 -
-R P 2049 o - Jul 3 2 1 S
+R P 2049 o - Jul 10 2 1 S
 R P 2050 o - May 21 2 0 -
-R P 2050 o - Jun 25 2 1 S
+R P 2050 o - Jul 2 2 1 S
 R P 2051 o - May 6 2 0 -
-R P 2051 o - Jun 17 2 1 S
+R P 2051 o - Jun 24 2 1 S
 R P 2052 o - Ap 27 2 0 -
-R P 2052 o - Jun 1 2 1 S
+R P 2052 o - Jun 8 2 1 S
 R P 2053 o - Ap 12 2 0 -
-R P 2053 o - May 24 2 1 S
+R P 2053 o - May 31 2 1 S
 R P 2054 o - Ap 4 2 0 -
-R P 2054 o - May 16 2 1 S
-R P 2055 o - May 1 2 1 S
-R P 2056 o - Ap 22 2 1 S
-R P 2057 o - Ap 7 2 1 S
-R P 2058 ma - Mar Sa<=30 2 1 S
+R P 2054 o - May 23 2 1 S
+R P 2055 o - May 8 2 1 S
+R P 2056 o - Ap 29 2 1 S
+R P 2057 o - Ap 14 2 1 S
+R P 2058 o - Ap 6 2 1 S
+R P 2059 ma - Mar Sa<=30 2 1 S
 R P 2068 o - O 20 2 0 -
 R P 2069 o - O 12 2 0 -
 R P 2070 o - O 4 2 0 -
 R P 2071 o - S 19 2 0 -
 R P 2072 o - S 10 2 0 -
-R P 2072 o - O 15 2 1 S
+R P 2072 o - O 22 2 1 S
+R P 2072 ma - O Sa<=30 2 0 -
 R P 2073 o - S 2 2 0 -
-R P 2073 o - O 7 2 1 S
+R P 2073 o - O 14 2 1 S
 R P 2074 o - Au 18 2 0 -
-R P 2074 o - S 29 2 1 S
+R P 2074 o - O 6 2 1 S
 R P 2075 o - Au 10 2 0 -
-R P 2075 o - S 14 2 1 S
-R P 2075 ma - O Sa<=30 2 0 -
+R P 2075 o - S 21 2 1 S
 R P 2076 o - Jul 25 2 0 -
-R P 2076 o - S 5 2 1 S
+R P 2076 o - S 12 2 1 S
 R P 2077 o - Jul 17 2 0 -
-R P 2077 o - Au 28 2 1 S
+R P 2077 o - S 4 2 1 S
 R P 2078 o - Jul 9 2 0 -
-R P 2078 o - Au 13 2 1 S
+R P 2078 o - Au 20 2 1 S
 R P 2079 o - Jun 24 2 0 -
-R P 2079 o - Au 5 2 1 S
+R P 2079 o - Au 12 2 1 S
 R P 2080 o - Jun 15 2 0 -
-R P 2080 o - Jul 20 2 1 S
+R P 2080 o - Jul 27 2 1 S
 R P 2081 o - Jun 7 2 0 -
-R P 2081 o - Jul 12 2 1 S
+R P 2081 o - Jul 19 2 1 S
 R P 2082 o - May 23 2 0 -
-R P 2082 o - Jul 4 2 1 S
+R P 2082 o - Jul 11 2 1 S
 R P 2083 o - May 15 2 0 -
-R P 2083 o - Jun 19 2 1 S
+R P 2083 o - Jun 26 2 1 S
 R P 2084 o - Ap 29 2 0 -
-R P 2084 o - Jun 10 2 1 S
+R P 2084 o - Jun 17 2 1 S
 R P 2085 o - Ap 21 2 0 -
-R P 2085 o - Jun 2 2 1 S
+R P 2085 o - Jun 9 2 1 S
 R P 2086 o - Ap 13 2 0 -
-R P 2086 o - May 18 2 1 S
-Z Asia/Gaza 2:17:52 - LMT 1900 O
-2 Z EET/EEST 1948 May 15
-2 K EE%sT 1967 Jun 5
-2 Z I%sT 1996
-2 J EE%sT 1999
-2 P EE%sT 2008 Au 29
-2 - EET 2008 S
-2 P EE%sT 2010
-2 - EET 2010 Mar 27 0:1
-2 P EE%sT 2011 Au
-2 - EET 2012
-2 P EE%sT
-Z Asia/Hebron 2:20:23 - LMT 1900 O
-2 Z EET/EEST 1948 May 15
-2 K EE%sT 1967 Jun 5
-2 Z I%sT 1996
-2 J EE%sT 1999
-2 P EE%sT
+R P 2086 o - May 25 2 1 S
 R PH 1936 o - N 1 0 1 D
 R PH 1937 o - F 1 0 0 S
 R PH 1954 o - Ap 12 0 1 D
 R PH 1954 o - Jul 1 0 0 S
 R PH 1978 o - Mar 22 0 1 D
 R PH 1978 o - S 21 0 0 S
-Z Asia/Manila -15:56 - LMT 1844 D 31
-8:4 - LMT 1899 May 11
-8 PH P%sT 1942 May
-9 - JST 1944 N
-8 PH P%sT
-Z Asia/Qatar 3:26:8 - LMT 1920
-4 - +04 1972 Jun
-3 - +03
-Z Asia/Riyadh 3:6:52 - LMT 1947 Mar 14
-3 - +03
-Z Asia/Singapore 6:55:25 - LMT 1901
-6:55:25 - SMT 1905 Jun
-7 - +07 1933
-7 0:20 +0720 1936
-7:20 - +0720 1941 S
-7:30 - +0730 1942 F 16
-9 - +09 1945 S 12
-7:30 - +0730 1981 D 31 16u
-8 - +08
-Z Asia/Colombo 5:19:24 - LMT 1880
-5:19:32 - MMT 1906
-5:30 - +0530 1942 Ja 5
-5:30 0:30 +06 1942 S
-5:30 1 +0630 1945 O 16 2
-5:30 - +0530 1996 May 25
-6:30 - +0630 1996 O 26 0:30
-6 - +06 2006 Ap 15 0:30
-5:30 - +0530
 R S 1920 1923 - Ap Su>=15 2 1 S
 R S 1920 1923 - O Su>=1 2 0 -
 R S 1962 o - Ap 29 2 1 S
@@ -1172,46 +768,6 @@ R S 2009 o - Mar lastF 0 1 S
 R S 2010 2011 - Ap F>=1 0 1 S
 R S 2012 2022 - Mar lastF 0 1 S
 R S 2009 2022 - O lastF 0 0 -
-Z Asia/Damascus 2:25:12 - LMT 1920
-2 S EE%sT 2022 O 28
-3 - +03
-Z Asia/Dushanbe 4:35:12 - LMT 1924 May 2
-5 - +05 1930 Jun 21
-6 R +06/+07 1991 Mar 31 2s
-5 1 +06 1991 S 9 2s
-5 - +05
-Z Asia/Bangkok 6:42:4 - LMT 1880
-6:42:4 - BMT 1920 Ap
-7 - +07
-Z Asia/Ashgabat 3:53:32 - LMT 1924 May 2
-4 - +04 1930 Jun 21
-5 R +05/+06 1991 Mar 31 2
-4 R +04/+05 1992 Ja 19 2
-5 - +05
-Z Asia/Dubai 3:41:12 - LMT 1920
-4 - +04
-Z Asia/Samarkand 4:27:53 - LMT 1924 May 2
-4 - +04 1930 Jun 21
-5 - +05 1981 Ap
-5 1 +06 1981 O
-6 - +06 1982 Ap
-5 R +05/+06 1992
-5 - +05
-Z Asia/Tashkent 4:37:11 - LMT 1924 May 2
-5 - +05 1930 Jun 21
-6 R +06/+07 1991 Mar 31 2
-5 R +05/+06 1992
-5 - +05
-Z Asia/Ho_Chi_Minh 7:6:30 - LMT 1906 Jul
-7:6:30 - PLMT 1911 May
-7 - +07 1942 D 31 23
-8 - +08 1945 Mar 14 23
-9 - +09 1945 S 2
-7 - +07 1947 Ap
-8 - +08 1955 Jul
-7 - +07 1959 D 31 23
-8 - +08 1975 Jun 13
-7 - +07
 R AU 1917 o - Ja 1 2s 1 D
 R AU 1917 o - Mar lastSu 2s 0 S
 R AU 1942 o - Ja 1 2s 1 D
@@ -1219,9 +775,6 @@ R AU 1942 o - Mar lastSu 2s 0 S
 R AU 1942 o - S 27 2s 1 D
 R AU 1943 1944 - Mar lastSu 2s 0 S
 R AU 1943 o - O 3 2s 1 D
-Z Australia/Darwin 8:43:20 - LMT 1895 F
-9 - ACST 1899 May
-9:30 AU AC%sT
 R AW 1974 o - O lastSu 2s 1 D
 R AW 1975 o - Mar Su>=1 2s 0 S
 R AW 1983 o - O lastSu 2s 1 D
@@ -1231,25 +784,12 @@ R AW 1992 o - Mar Su>=1 2s 0 S
 R AW 2006 o - D 3 2s 1 D
 R AW 2007 2009 - Mar lastSu 2s 0 S
 R AW 2007 2008 - O lastSu 2s 1 D
-Z Australia/Perth 7:43:24 - LMT 1895 D
-8 AU AW%sT 1943 Jul
-8 AW AW%sT
-Z Australia/Eucla 8:35:28 - LMT 1895 D
-8:45 AU +0845/+0945 1943 Jul
-8:45 AW +0845/+0945
 R AQ 1971 o - O lastSu 2s 1 D
 R AQ 1972 o - F lastSu 2s 0 S
 R AQ 1989 1991 - O lastSu 2s 1 D
 R AQ 1990 1992 - Mar Su>=1 2s 0 S
 R Ho 1992 1993 - O lastSu 2s 1 D
 R Ho 1993 1994 - Mar Su>=1 2s 0 S
-Z Australia/Brisbane 10:12:8 - LMT 1895
-10 AU AE%sT 1971
-10 AQ AE%sT
-Z Australia/Lindeman 9:55:56 - LMT 1895
-10 AU AE%sT 1971
-10 AQ AE%sT 1992 Jul
-10 Ho AE%sT
 R AS 1971 1985 - O lastSu 2s 1 D
 R AS 1986 o - O 19 2s 1 D
 R AS 1987 2007 - O lastSu 2s 1 D
@@ -1265,10 +805,6 @@ R AS 2006 o - Ap 2 2s 0 S
 R AS 2007 o - Mar lastSu 2s 0 S
 R AS 2008 ma - Ap Su>=1 2s 0 S
 R AS 2008 ma - O Su>=1 2s 1 D
-Z Australia/Adelaide 9:14:20 - LMT 1895 F
-9 - ACST 1899 May
-9:30 AU AC%sT 1971
-9:30 AS AC%sT
 R AT 1916 o - O Su>=1 2s 1 D
 R AT 1917 o - Mar lastSu 2s 0 S
 R AT 1917 1918 - O Su>=22 2s 1 D
@@ -1292,10 +828,6 @@ R AT 2001 ma - O Su>=1 2s 1 D
 R AT 2006 o - Ap Su>=1 2s 0 S
 R AT 2007 o - Mar lastSu 2s 0 S
 R AT 2008 ma - Ap Su>=1 2s 0 S
-Z Australia/Hobart 9:49:16 - LMT 1895 S
-10 AT AE%sT 1919 O 24
-10 AU AE%sT 1967
-10 AT AE%sT
 R AV 1971 1985 - O lastSu 2s 1 D
 R AV 1972 o - F lastSu 2s 0 S
 R AV 1973 1985 - Mar Su>=1 2s 0 S
@@ -1310,9 +842,6 @@ R AV 2006 o - Ap Su>=1 2s 0 S
 R AV 2007 o - Mar lastSu 2s 0 S
 R AV 2008 ma - Ap Su>=1 2s 0 S
 R AV 2008 ma - O Su>=1 2s 1 D
-Z Australia/Melbourne 9:39:52 - LMT 1895 F
-10 AU AE%sT 1971
-10 AV AE%sT
 R AN 1971 1985 - O lastSu 2s 1 D
 R AN 1972 o - F 27 2s 0 S
 R AN 1973 1981 - Mar Su>=1 2s 0 S
@@ -1329,15 +858,6 @@ R AN 2006 o - Ap Su>=1 2s 0 S
 R AN 2007 o - Mar lastSu 2s 0 S
 R AN 2008 ma - Ap Su>=1 2s 0 S
 R AN 2008 ma - O Su>=1 2s 1 D
-Z Australia/Sydney 10:4:52 - LMT 1895 F
-10 AU AE%sT 1971
-10 AN AE%sT
-Z Australia/Broken_Hill 9:25:48 - LMT 1895 F
-10 - AEST 1896 Au 23
-9 - ACST 1899 May
-9:30 AU AC%sT 1971
-9:30 AN AC%sT 2000
-9:30 AS AC%sT
 R LH 1981 1984 - O lastSu 2 1 -
 R LH 1982 1985 - Mar Su>=1 2 0 -
 R LH 1985 o - O lastSu 2 0:30 -
@@ -1352,19 +872,6 @@ R LH 2006 o - Ap Su>=1 2 0 -
 R LH 2007 o - Mar lastSu 2 0 -
 R LH 2008 ma - Ap Su>=1 2 0 -
 R LH 2008 ma - O Su>=1 2 0:30 -
-Z Australia/Lord_Howe 10:36:20 - LMT 1895 F
-10 - AEST 1981 Mar
-10:30 LH +1030/+1130 1985 Jul
-10:30 LH +1030/+11
-Z Antarctica/Macquarie 0 - -00 1899 N
-10 - AEST 1916 O 1 2
-10 1 AEDT 1917 F
-10 AU AE%sT 1919 Ap 1 0s
-0 - -00 1948 Mar 25
-10 AU AE%sT 1967
-10 AT AE%sT 2010
-10 1 AEDT 2011
-10 AT AE%sT
 R FJ 1998 1999 - N Su>=1 2 1 -
 R FJ 1999 2000 - F lastSu 3 0 -
 R FJ 2009 o - N 29 2 1 -
@@ -1377,14 +884,6 @@ R FJ 2014 2018 - N Su>=1 2 1 -
 R FJ 2015 2021 - Ja Su>=12 3 0 -
 R FJ 2019 o - N Su>=8 2 1 -
 R FJ 2020 o - D 20 2 1 -
-Z Pacific/Fiji 11:55:44 - LMT 1915 O 26
-12 FJ +12/+13
-Z Pacific/Gambier -8:59:48 - LMT 1912 O
--9 - -09
-Z Pacific/Marquesas -9:18 - LMT 1912 O
--9:30 - -0930
-Z Pacific/Tahiti -9:58:16 - LMT 1912 O
--10 - -10
 R Gu 1959 o - Jun 27 2 1 D
 R Gu 1961 o - Ja 29 2 0 S
 R Gu 1967 o - S 1 2 1 D
@@ -1399,50 +898,10 @@ R Gu 1976 o - May 26 2 1 D
 R Gu 1976 o - Au 22 2:1 0 S
 R Gu 1977 o - Ap 24 2 1 D
 R Gu 1977 o - Au 28 2 0 S
-Z Pacific/Guam -14:21 - LMT 1844 D 31
-9:39 - LMT 1901
-10 - GST 1941 D 10
-9 - +09 1944 Jul 31
-10 Gu G%sT 2000 D 23
-10 - ChST
-Z Pacific/Tarawa 11:32:4 - LMT 1901
-12 - +12
-Z Pacific/Kanton 0 - -00 1937 Au 31
--12 - -12 1979 O
--11 - -11 1994 D 31
-13 - +13
-Z Pacific/Kiritimati -10:29:20 - LMT 1901
--10:40 - -1040 1979 O
--10 - -10 1994 D 31
-14 - +14
-Z Pacific/Kwajalein 11:9:20 - LMT 1901
-11 - +11 1937
-10 - +10 1941 Ap
-9 - +09 1944 F 6
-11 - +11 1969 O
--12 - -12 1993 Au 20 24
-12 - +12
-Z Pacific/Kosrae -13:8:4 - LMT 1844 D 31
-10:51:56 - LMT 1901
-11 - +11 1914 O
-9 - +09 1919 F
-11 - +11 1937
-10 - +10 1941 Ap
-9 - +09 1945 Au
-11 - +11 1969 O
-12 - +12 1999
-11 - +11
-Z Pacific/Nauru 11:7:40 - LMT 1921 Ja 15
-11:30 - +1130 1942 Au 29
-9 - +09 1945 S 8
-11:30 - +1130 1979 F 10 2
-12 - +12
 R NC 1977 1978 - D Su>=1 0 1 -
 R NC 1978 1979 - F 27 0 0 -
 R NC 1996 o - D 1 2s 1 -
 R NC 1997 o - Mar 2 2s 0 -
-Z Pacific/Noumea 11:5:48 - LMT 1912 Ja 13
-11 NC +11/+12
 R NZ 1927 o - N 6 2 1 S
 R NZ 1928 o - Mar 4 2 0 M
 R NZ 1928 1933 - O Su>=8 2 0:30 S
@@ -1468,80 +927,26 @@ R NZ 2007 ma - S lastSu 2s 1 D
 R k 2007 ma - S lastSu 2:45s 1 -
 R NZ 2008 ma - Ap Su>=1 2s 0 S
 R k 2008 ma - Ap Su>=1 2:45s 0 -
-Z Pacific/Auckland 11:39:4 - LMT 1868 N 2
-11:30 NZ NZ%sT 1946
-12 NZ NZ%sT
-Z Pacific/Chatham 12:13:48 - LMT 1868 N 2
-12:15 - +1215 1946
-12:45 k +1245/+1345
 R CK 1978 o - N 12 0 0:30 -
 R CK 1979 1991 - Mar Su>=1 0 0 -
 R CK 1979 1990 - O lastSu 0 0:30 -
-Z Pacific/Rarotonga 13:20:56 - LMT 1899 D 26
--10:39:4 - LMT 1952 O 16
--10:30 - -1030 1978 N 12
--10 CK -10/-0930
-Z Pacific/Niue -11:19:40 - LMT 1952 O 16
--11:20 - -1120 1964 Jul
--11 - -11
-Z Pacific/Norfolk 11:11:52 - LMT 1901
-11:12 - +1112 1951
-11:30 - +1130 1974 O 27 2s
-11:30 1 +1230 1975 Mar 2 2s
-11:30 - +1130 2015 O 4 2s
-11 - +11 2019 Jul
-11 AN +11/+12
-Z Pacific/Palau -15:2:4 - LMT 1844 D 31
-8:57:56 - LMT 1901
-9 - +09
-Z Pacific/Port_Moresby 9:48:40 - LMT 1880
-9:48:32 - PMMT 1895
-10 - +10
-Z Pacific/Bougainville 10:22:16 - LMT 1880
-9:48:32 - PMMT 1895
-10 - +10 1942 Jul
-9 - +09 1945 Au 21
-10 - +10 2014 D 28 2
-11 - +11
-Z Pacific/Pitcairn -8:40:20 - LMT 1901
--8:30 - -0830 1998 Ap 27
--8 - -08
-Z Pacific/Pago_Pago 12:37:12 - LMT 1892 Jul 5
--11:22:48 - LMT 1911
--11 - SST
 R WS 2010 o - S lastSu 0 1 -
 R WS 2011 o - Ap Sa>=1 4 0 -
 R WS 2011 o - S lastSa 3 1 -
 R WS 2012 2021 - Ap Su>=1 4 0 -
 R WS 2012 2020 - S lastSu 3 1 -
-Z Pacific/Apia 12:33:4 - LMT 1892 Jul 5
--11:26:56 - LMT 1911
--11:30 - -1130 1950
--11 WS -11/-10 2011 D 29 24
-13 WS +13/+14
-Z Pacific/Guadalcanal 10:39:48 - LMT 1912 O
-11 - +11
-Z Pacific/Fakaofo -11:24:56 - LMT 1901
--11 - -11 2011 D 30
-13 - +13
 R TO 1999 o - O 7 2s 1 -
 R TO 2000 o - Mar 19 2s 0 -
 R TO 2000 2001 - N Su>=1 2 1 -
 R TO 2001 2002 - Ja lastSu 2 0 -
 R TO 2016 o - N Su>=1 2 1 -
 R TO 2017 o - Ja Su>=15 3 0 -
-Z Pacific/Tongatapu 12:19:12 - LMT 1945 S 10
-12:20 - +1220 1961
-13 - +13 1999
-13 TO +13/+14
 R VU 1973 o - D 22 12u 1 -
 R VU 1974 o - Mar 30 12u 0 -
 R VU 1983 1991 - S Sa>=22 24 1 -
 R VU 1984 1991 - Mar Sa>=22 24 0 -
 R VU 1992 1993 - Ja Sa>=22 24 0 -
 R VU 1992 o - O Sa>=22 24 1 -
-Z Pacific/Efate 11:13:16 - LMT 1912 Ja 13
-11 VU +11/+12
 R G 1916 o - May 21 2s 1 BST
 R G 1916 o - O 1 2s 0 GMT
 R G 1917 o - Ap 8 2s 1 BST
@@ -1607,11 +1012,6 @@ R G 1972 1980 - O Su>=23 2s 0 GMT
 R G 1981 1995 - Mar lastSu 1u 1 BST
 R G 1981 1989 - O Su>=23 1u 0 GMT
 R G 1990 1995 - O Su>=22 1u 0 GMT
-Z Europe/London -0:1:15 - LMT 1847 D
-0 G %s 1968 O 27
-1 - BST 1971 O 31 2u
-0 G %s 1996
-0 E GMT/BST
 R IE 1971 o - O 31 2u -1 -
 R IE 1972 1980 - Mar Su>=16 2u 0 -
 R IE 1972 1980 - O Su>=23 2u -1 -
@@ -1619,17 +1019,6 @@ R IE 1981 ma - Mar lastSu 1u 0 -
 R IE 1981 1989 - O Su>=23 1u -1 -
 R IE 1990 1995 - O Su>=22 1u -1 -
 R IE 1996 ma - O lastSu 1u -1 -
-Z Europe/Dublin -0:25:21 - LMT 1880 Au 2
--0:25:21 - DMT 1916 May 21 2s
--0:25:21 1 IST 1916 O 1 2s
-0 G %s 1921 D 6
-0 G GMT/IST 1940 F 25 2s
-0 1 IST 1946 O 6 2s
-0 - GMT 1947 Mar 16 2s
-0 1 IST 1947 N 2 2s
-0 - GMT 1948 Ap 18 2s
-0 G GMT/IST 1968 O 27
-1 IE IST/GMT
 R E 1977 1980 - Ap Su>=1 1u 1 S
 R E 1977 o - S lastSu 1u 0 -
 R E 1978 o - O 1 1u 0 -
@@ -1681,10 +1070,6 @@ R R 1981 1983 - O 1 0 0 -
 R R 1984 1995 - S lastSu 2s 0 -
 R R 1985 2010 - Mar lastSu 2s 1 S
 R R 1996 2010 - O lastSu 2s 0 -
-Z WET 0 E WE%sT
-Z CET 1 c CE%sT
-Z MET 1 c ME%sT
-Z EET 2 E EE%sT
 R q 1940 o - Jun 16 0 1 S
 R q 1942 o - N 2 3 0 -
 R q 1943 o - Mar 29 2 1 S
@@ -1710,14 +1095,6 @@ R q 1982 o - O 3 0 0 -
 R q 1983 o - Ap 18 0 1 S
 R q 1983 o - O 1 0 0 -
 R q 1984 o - Ap 1 0 1 S
-Z Europe/Tirane 1:19:20 - LMT 1914
-1 - CET 1940 Jun 16
-1 q CE%sT 1984 Jul
-1 E CE%sT
-Z Europe/Andorra 0:6:4 - LMT 1901
-0 - WET 1946 S 30
-1 - CET 1985 Mar 31 2
-1 E CE%sT
 R a 1920 o - Ap 5 2s 1 S
 R a 1920 o - S 13 2s 0 -
 R a 1946 o - Ap 14 2s 1 S
@@ -1727,23 +1104,6 @@ R a 1947 o - Ap 6 2s 1 S
 R a 1948 o - Ap 18 2s 1 S
 R a 1980 o - Ap 6 0 1 S
 R a 1980 o - S 28 0 0 -
-Z Europe/Vienna 1:5:21 - LMT 1893 Ap
-1 c CE%sT 1920
-1 a CE%sT 1940 Ap 1 2s
-1 c CE%sT 1945 Ap 2 2s
-1 1 CEST 1945 Ap 12 2s
-1 - CET 1946
-1 a CE%sT 1981
-1 E CE%sT
-Z Europe/Minsk 1:50:16 - LMT 1880
-1:50 - MMT 1924 May 2
-2 - EET 1930 Jun 21
-3 - MSK 1941 Jun 28
-1 c CE%sT 1944 Jul 3
-3 R MSK/MSD 1990
-3 - MSK 1991 Mar 31 2s
-2 R EE%sT 2011 Mar 27 2s
-3 - +03
 R b 1918 o - Mar 9 0s 1 S
 R b 1918 1919 - O Sa>=1 23s 0 -
 R b 1919 o - Mar 1 23s 1 S
@@ -1778,87 +1138,27 @@ R b 1945 o - Ap 2 2s 1 S
 R b 1945 o - S 16 2s 0 -
 R b 1946 o - May 19 2s 1 S
 R b 1946 o - O 7 2s 0 -
-Z Europe/Brussels 0:17:30 - LMT 1880
-0:17:30 - BMT 1892 May 1 0:17:30
-0 - WET 1914 N 8
-1 - CET 1916 May
-1 c CE%sT 1918 N 11 11u
-0 b WE%sT 1940 May 20 2s
-1 c CE%sT 1944 S 3
-1 b CE%sT 1977
-1 E CE%sT
 R BG 1979 o - Mar 31 23 1 S
 R BG 1979 o - O 1 1 0 -
 R BG 1980 1982 - Ap Sa>=1 23 1 S
 R BG 1980 o - S 29 1 0 -
 R BG 1981 o - S 27 2 0 -
-Z Europe/Sofia 1:33:16 - LMT 1880
-1:56:56 - IMT 1894 N 30
-2 - EET 1942 N 2 3
-1 c CE%sT 1945
-1 - CET 1945 Ap 2 3
-2 - EET 1979 Mar 31 23
-2 BG EE%sT 1982 S 26 3
-2 c EE%sT 1991
-2 e EE%sT 1997
-2 E EE%sT
 R CZ 1945 o - Ap M>=1 2s 1 S
 R CZ 1945 o - O 1 2s 0 -
 R CZ 1946 o - May 6 2s 1 S
 R CZ 1946 1949 - O Su>=1 2s 0 -
 R CZ 1947 1948 - Ap Su>=15 2s 1 S
 R CZ 1949 o - Ap 9 2s 1 S
-Z Europe/Prague 0:57:44 - LMT 1850
-0:57:44 - PMT 1891 O
-1 c CE%sT 1945 May 9
-1 CZ CE%sT 1946 D 1 3
-1 -1 GMT 1947 F 23 2
-1 CZ CE%sT 1979
-1 E CE%sT
-Z Atlantic/Faroe -0:27:4 - LMT 1908 Ja 11
-0 - WET 1981
-0 E WE%sT
 R Th 1991 1992 - Mar lastSu 2 1 D
 R Th 1991 1992 - S lastSu 2 0 S
 R Th 1993 2006 - Ap Su>=1 2 1 D
 R Th 1993 2006 - O lastSu 2 0 S
 R Th 2007 ma - Mar Su>=8 2 1 D
 R Th 2007 ma - N Su>=1 2 0 S
-Z America/Danmarkshavn -1:14:40 - LMT 1916 Jul 28
--3 - -03 1980 Ap 6 2
--3 E -03/-02 1996
-0 - GMT
-Z America/Scoresbysund -1:27:52 - LMT 1916 Jul 28
--2 - -02 1980 Ap 6 2
--2 c -02/-01 1981 Mar 29
--1 E -01/+00
-Z America/Nuuk -3:26:56 - LMT 1916 Jul 28
--3 - -03 1980 Ap 6 2
--3 E -03/-02 2023 O 29 1u
--2 E -02/-01
-Z America/Thule -4:35:8 - LMT 1916 Jul 28
--4 Th A%sT
-Z Europe/Tallinn 1:39 - LMT 1880
-1:39 - TMT 1918 F
-1 c CE%sT 1919 Jul
-1:39 - TMT 1921 May
-2 - EET 1940 Au 6
-3 - MSK 1941 S 15
-1 c CE%sT 1944 S 22
-3 R MSK/MSD 1989 Mar 26 2s
-2 1 EEST 1989 S 24 2s
-2 c EE%sT 1998 S 22
-2 E EE%sT 1999 O 31 4
-2 - EET 2002 F 21
-2 E EE%sT
 R FI 1942 o - Ap 2 24 1 S
 R FI 1942 o - O 4 1 0 -
 R FI 1981 1982 - Mar lastSu 2 1 S
 R FI 1981 1982 - S lastSu 3 0 -
-Z Europe/Helsinki 1:39:49 - LMT 1878 May 31
-1:39:49 - HMT 1921 May
-2 FI EE%sT 1983
-2 E EE%sT
 R F 1916 o - Jun 14 23s 1 S
 R F 1916 1919 - O Su>=1 23s 0 -
 R F 1917 o - Mar 24 23s 1 S
@@ -1901,13 +1201,6 @@ R F 1945 o - Ap 2 2 2 M
 R F 1945 o - S 16 3 0 -
 R F 1976 o - Mar 28 1 1 S
 R F 1976 o - S 26 1 0 -
-Z Europe/Paris 0:9:21 - LMT 1891 Mar 16
-0:9:21 - PMT 1911 Mar 11
-0 F WE%sT 1940 Jun 14 23
-1 c CE%sT 1944 Au 25
-0 F WE%sT 1945 S 16 3
-1 F CE%sT 1977
-1 E CE%sT
 R DE 1946 o - Ap 14 2s 1 S
 R DE 1946 o - O 7 2s 0 -
 R DE 1947 1949 - O Su>=1 2s 0 -
@@ -1919,15 +1212,6 @@ R DE 1949 o - Ap 10 2s 1 S
 R So 1945 o - May 24 2 2 M
 R So 1945 o - S 24 3 1 S
 R So 1945 o - N 18 2s 0 -
-Z Europe/Berlin 0:53:28 - LMT 1893 Ap
-1 c CE%sT 1945 May 24 2
-1 So CE%sT 1946
-1 DE CE%sT 1980
-1 E CE%sT
-Z Europe/Gibraltar -0:21:24 - LMT 1880 Au 2
-0 G %s 1957 Ap 14 2
-1 - CET 1982
-1 E CE%sT
 R g 1932 o - Jul 7 0 1 S
 R g 1932 o - S 1 0 0 -
 R g 1941 o - Ap 7 0 1 S
@@ -1947,12 +1231,6 @@ R g 1979 o - Ap 1 9 1 S
 R g 1979 o - S 29 2 0 -
 R g 1980 o - Ap 1 0 1 S
 R g 1980 o - S 28 0 0 -
-Z Europe/Athens 1:34:52 - LMT 1895 S 14
-1:34:52 - AMT 1916 Jul 28 0:1
-2 g EE%sT 1941 Ap 30
-1 g CE%sT 1944 Ap 4
-2 g EE%sT 1981
-2 E EE%sT
 R h 1918 1919 - Ap 15 2 1 S
 R h 1918 1920 - S M>=15 3 0 -
 R h 1920 o - Ap 5 2 1 S
@@ -1972,12 +1250,6 @@ R h 1980 o - Ap 6 0 1 S
 R h 1980 o - S 28 1 0 -
 R h 1981 1983 - Mar lastSu 0 1 S
 R h 1981 1983 - S lastSu 1 0 -
-Z Europe/Budapest 1:16:20 - LMT 1890 N
-1 c CE%sT 1918
-1 h CE%sT 1941 Ap 7 23
-1 c CE%sT 1945
-1 h CE%sT 1984
-1 E CE%sT
 R I 1916 o - Jun 3 24 1 S
 R I 1916 1917 - S 30 24 0 -
 R I 1917 o - Mar 31 24 1 S
@@ -2019,44 +1291,8 @@ R I 1976 o - May 30 0s 1 S
 R I 1977 1979 - May Su>=22 0s 1 S
 R I 1978 o - O 1 0s 0 -
 R I 1979 o - S 30 0s 0 -
-Z Europe/Rome 0:49:56 - LMT 1866 D 12
-0:49:56 - RMT 1893 O 31 23u
-1 I CE%sT 1943 S 10
-1 c CE%sT 1944 Jun 4
-1 I CE%sT 1980
-1 E CE%sT
 R LV 1989 1996 - Mar lastSu 2s 1 S
 R LV 1989 1996 - S lastSu 2s 0 -
-Z Europe/Riga 1:36:34 - LMT 1880
-1:36:34 - RMT 1918 Ap 15 2
-1:36:34 1 LST 1918 S 16 3
-1:36:34 - RMT 1919 Ap 1 2
-1:36:34 1 LST 1919 May 22 3
-1:36:34 - RMT 1926 May 11
-2 - EET 1940 Au 5
-3 - MSK 1941 Jul
-1 c CE%sT 1944 O 13
-3 R MSK/MSD 1989 Mar lastSu 2s
-2 1 EEST 1989 S lastSu 2s
-2 LV EE%sT 1997 Ja 21
-2 E EE%sT 2000 F 29
-2 - EET 2001 Ja 2
-2 E EE%sT
-Z Europe/Vilnius 1:41:16 - LMT 1880
-1:24 - WMT 1917
-1:35:36 - KMT 1919 O 10
-1 - CET 1920 Jul 12
-2 - EET 1920 O 9
-1 - CET 1940 Au 3
-3 - MSK 1941 Jun 24
-1 c CE%sT 1944 Au
-3 R MSK/MSD 1989 Mar 26 2s
-2 R EE%sT 1991 S 29 2s
-2 c EE%sT 1998
-2 - EET 1998 Mar 29 1u
-1 E CE%sT 1999 O 31 1u
-2 - EET 2003
-2 E EE%sT
 R MT 1973 o - Mar 31 0s 1 S
 R MT 1973 o - S 29 0s 0 -
 R MT 1974 o - Ap 21 0s 1 S
@@ -2064,22 +1300,8 @@ R MT 1974 o - S 16 0s 0 -
 R MT 1975 1979 - Ap Su>=15 2 1 S
 R MT 1975 1980 - S Su>=15 2 0 -
 R MT 1980 o - Mar 31 2 1 S
-Z Europe/Malta 0:58:4 - LMT 1893 N 2
-1 I CE%sT 1973 Mar 31
-1 MT CE%sT 1981
-1 E CE%sT
 R MD 1997 ma - Mar lastSu 2 1 S
 R MD 1997 ma - O lastSu 3 0 -
-Z Europe/Chisinau 1:55:20 - LMT 1880
-1:55 - CMT 1918 F 15
-1:44:24 - BMT 1931 Jul 24
-2 z EE%sT 1940 Au 15
-2 1 EEST 1941 Jul 17
-1 c CE%sT 1944 Au 24
-3 R MSK/MSD 1990 May 6 2
-2 R EE%sT 1992
-2 e EE%sT 1997
-2 MD EE%sT
 R O 1918 1919 - S 16 2s 0 -
 R O 1919 o - Ap 15 2s 1 S
 R O 1944 o - Ap 3 2s 1 S
@@ -2100,15 +1322,6 @@ R O 1959 1961 - O Su>=1 1s 0 -
 R O 1960 o - Ap 3 1s 1 S
 R O 1961 1964 - May lastSu 1s 1 S
 R O 1962 1964 - S lastSu 1s 0 -
-Z Europe/Warsaw 1:24 - LMT 1880
-1:24 - WMT 1915 Au 5
-1 c CE%sT 1918 S 16 3
-2 O EE%sT 1922 Jun
-1 O CE%sT 1940 Jun 23 2
-1 c CE%sT 1944 O
-1 O CE%sT 1977
-1 W- CE%sT 1988
-1 E CE%sT
 R p 1916 o - Jun 17 23 1 S
 R p 1916 o - N 1 1 0 -
 R p 1917 o - F 28 23s 1 S
@@ -2157,42 +1370,6 @@ R p 1979 1982 - S lastSu 1s 0 -
 R p 1980 o - Mar lastSu 0s 1 S
 R p 1981 1982 - Mar lastSu 1s 1 S
 R p 1983 o - Mar lastSu 2s 1 S
-Z Europe/Lisbon -0:36:45 - LMT 1884
--0:36:45 - LMT 1912 Ja 1 0u
-0 p WE%sT 1966 Ap 3 2
-1 - CET 1976 S 26 1
-0 p WE%sT 1983 S 25 1s
-0 W- WE%sT 1992 S 27 1s
-1 E CE%sT 1996 Mar 31 1u
-0 E WE%sT
-Z Atlantic/Azores -1:42:40 - LMT 1884
--1:54:32 - HMT 1912 Ja 1 2u
--2 p -02/-01 1942 Ap 25 22s
--2 p +00 1942 Au 15 22s
--2 p -02/-01 1943 Ap 17 22s
--2 p +00 1943 Au 28 22s
--2 p -02/-01 1944 Ap 22 22s
--2 p +00 1944 Au 26 22s
--2 p -02/-01 1945 Ap 21 22s
--2 p +00 1945 Au 25 22s
--2 p -02/-01 1966 Ap 3 2
--1 p -01/+00 1983 S 25 1s
--1 W- -01/+00 1992 S 27 1s
-0 E WE%sT 1993 Mar 28 1u
--1 E -01/+00
-Z Atlantic/Madeira -1:7:36 - LMT 1884
--1:7:36 - FMT 1912 Ja 1 1u
--1 p -01/+00 1942 Ap 25 22s
--1 p +01 1942 Au 15 22s
--1 p -01/+00 1943 Ap 17 22s
--1 p +01 1943 Au 28 22s
--1 p -01/+00 1944 Ap 22 22s
--1 p +01 1944 Au 26 22s
--1 p -01/+00 1945 Ap 21 22s
--1 p +01 1945 Au 25 22s
--1 p -01/+00 1966 Ap 3 2
-0 p WE%sT 1983 S 25 1s
-0 E WE%sT
 R z 1932 o - May 21 0s 1 S
 R z 1932 1939 - O Su>=1 0s 0 -
 R z 1933 1939 - Ap Su>=2 0s 1 S
@@ -2202,252 +1379,6 @@ R z 1980 o - Ap 5 23 1 S
 R z 1980 o - S lastSu 1 0 -
 R z 1991 1993 - Mar lastSu 0s 1 S
 R z 1991 1993 - S lastSu 0s 0 -
-Z Europe/Bucharest 1:44:24 - LMT 1891 O
-1:44:24 - BMT 1931 Jul 24
-2 z EE%sT 1981 Mar 29 2s
-2 c EE%sT 1991
-2 z EE%sT 1994
-2 e EE%sT 1997
-2 E EE%sT
-Z Europe/Kaliningrad 1:22 - LMT 1893 Ap
-1 c CE%sT 1945 Ap 10
-2 O EE%sT 1946 Ap 7
-3 R MSK/MSD 1989 Mar 26 2s
-2 R EE%sT 2011 Mar 27 2s
-3 - +03 2014 O 26 2s
-2 - EET
-Z Europe/Moscow 2:30:17 - LMT 1880
-2:30:17 - MMT 1916 Jul 3
-2:31:19 R %s 1919 Jul 1 0u
-3 R %s 1921 O
-3 R MSK/MSD 1922 O
-2 - EET 1930 Jun 21
-3 R MSK/MSD 1991 Mar 31 2s
-2 R EE%sT 1992 Ja 19 2s
-3 R MSK/MSD 2011 Mar 27 2s
-4 - MSK 2014 O 26 2s
-3 - MSK
-Z Europe/Simferopol 2:16:24 - LMT 1880
-2:16 - SMT 1924 May 2
-2 - EET 1930 Jun 21
-3 - MSK 1941 N
-1 c CE%sT 1944 Ap 13
-3 R MSK/MSD 1990
-3 - MSK 1990 Jul 1 2
-2 - EET 1992 Mar 20
-2 c EE%sT 1994 May
-3 c MSK/MSD 1996 Mar 31 0s
-3 1 MSD 1996 O 27 3s
-3 - MSK 1997 Mar lastSu 1u
-2 E EE%sT 2014 Mar 30 2
-4 - MSK 2014 O 26 2s
-3 - MSK
-Z Europe/Astrakhan 3:12:12 - LMT 1924 May
-3 - +03 1930 Jun 21
-4 R +04/+05 1989 Mar 26 2s
-3 R +03/+04 1991 Mar 31 2s
-4 - +04 1992 Mar 29 2s
-3 R +03/+04 2011 Mar 27 2s
-4 - +04 2014 O 26 2s
-3 - +03 2016 Mar 27 2s
-4 - +04
-Z Europe/Volgograd 2:57:40 - LMT 1920 Ja 3
-3 - +03 1930 Jun 21
-4 - +04 1961 N 11
-4 R +04/+05 1988 Mar 27 2s
-3 R MSK/MSD 1991 Mar 31 2s
-4 - +04 1992 Mar 29 2s
-3 R MSK/MSD 2011 Mar 27 2s
-4 - MSK 2014 O 26 2s
-3 - MSK 2018 O 28 2s
-4 - +04 2020 D 27 2s
-3 - MSK
-Z Europe/Saratov 3:4:18 - LMT 1919 Jul 1 0u
-3 - +03 1930 Jun 21
-4 R +04/+05 1988 Mar 27 2s
-3 R +03/+04 1991 Mar 31 2s
-4 - +04 1992 Mar 29 2s
-3 R +03/+04 2011 Mar 27 2s
-4 - +04 2014 O 26 2s
-3 - +03 2016 D 4 2s
-4 - +04
-Z Europe/Kirov 3:18:48 - LMT 1919 Jul 1 0u
-3 - +03 1930 Jun 21
-4 R +04/+05 1989 Mar 26 2s
-3 R MSK/MSD 1991 Mar 31 2s
-4 - +04 1992 Mar 29 2s
-3 R MSK/MSD 2011 Mar 27 2s
-4 - MSK 2014 O 26 2s
-3 - MSK
-Z Europe/Samara 3:20:20 - LMT 1919 Jul 1 0u
-3 - +03 1930 Jun 21
-4 - +04 1935 Ja 27
-4 R +04/+05 1989 Mar 26 2s
-3 R +03/+04 1991 Mar 31 2s
-2 R +02/+03 1991 S 29 2s
-3 - +03 1991 O 20 3
-4 R +04/+05 2010 Mar 28 2s
-3 R +03/+04 2011 Mar 27 2s
-4 - +04
-Z Europe/Ulyanovsk 3:13:36 - LMT 1919 Jul 1 0u
-3 - +03 1930 Jun 21
-4 R +04/+05 1989 Mar 26 2s
-3 R +03/+04 1991 Mar 31 2s
-2 R +02/+03 1992 Ja 19 2s
-3 R +03/+04 2011 Mar 27 2s
-4 - +04 2014 O 26 2s
-3 - +03 2016 Mar 27 2s
-4 - +04
-Z Asia/Yekaterinburg 4:2:33 - LMT 1916 Jul 3
-3:45:5 - PMT 1919 Jul 15 4
-4 - +04 1930 Jun 21
-5 R +05/+06 1991 Mar 31 2s
-4 R +04/+05 1992 Ja 19 2s
-5 R +05/+06 2011 Mar 27 2s
-6 - +06 2014 O 26 2s
-5 - +05
-Z Asia/Omsk 4:53:30 - LMT 1919 N 14
-5 - +05 1930 Jun 21
-6 R +06/+07 1991 Mar 31 2s
-5 R +05/+06 1992 Ja 19 2s
-6 R +06/+07 2011 Mar 27 2s
-7 - +07 2014 O 26 2s
-6 - +06
-Z Asia/Barnaul 5:35 - LMT 1919 D 10
-6 - +06 1930 Jun 21
-7 R +07/+08 1991 Mar 31 2s
-6 R +06/+07 1992 Ja 19 2s
-7 R +07/+08 1995 May 28
-6 R +06/+07 2011 Mar 27 2s
-7 - +07 2014 O 26 2s
-6 - +06 2016 Mar 27 2s
-7 - +07
-Z Asia/Novosibirsk 5:31:40 - LMT 1919 D 14 6
-6 - +06 1930 Jun 21
-7 R +07/+08 1991 Mar 31 2s
-6 R +06/+07 1992 Ja 19 2s
-7 R +07/+08 1993 May 23
-6 R +06/+07 2011 Mar 27 2s
-7 - +07 2014 O 26 2s
-6 - +06 2016 Jul 24 2s
-7 - +07
-Z Asia/Tomsk 5:39:51 - LMT 1919 D 22
-6 - +06 1930 Jun 21
-7 R +07/+08 1991 Mar 31 2s
-6 R +06/+07 1992 Ja 19 2s
-7 R +07/+08 2002 May 1 3
-6 R +06/+07 2011 Mar 27 2s
-7 - +07 2014 O 26 2s
-6 - +06 2016 May 29 2s
-7 - +07
-Z Asia/Novokuznetsk 5:48:48 - LMT 1924 May
-6 - +06 1930 Jun 21
-7 R +07/+08 1991 Mar 31 2s
-6 R +06/+07 1992 Ja 19 2s
-7 R +07/+08 2010 Mar 28 2s
-6 R +06/+07 2011 Mar 27 2s
-7 - +07
-Z Asia/Krasnoyarsk 6:11:26 - LMT 1920 Ja 6
-6 - +06 1930 Jun 21
-7 R +07/+08 1991 Mar 31 2s
-6 R +06/+07 1992 Ja 19 2s
-7 R +07/+08 2011 Mar 27 2s
-8 - +08 2014 O 26 2s
-7 - +07
-Z Asia/Irkutsk 6:57:5 - LMT 1880
-6:57:5 - IMT 1920 Ja 25
-7 - +07 1930 Jun 21
-8 R +08/+09 1991 Mar 31 2s
-7 R +07/+08 1992 Ja 19 2s
-8 R +08/+09 2011 Mar 27 2s
-9 - +09 2014 O 26 2s
-8 - +08
-Z Asia/Chita 7:33:52 - LMT 1919 D 15
-8 - +08 1930 Jun 21
-9 R +09/+10 1991 Mar 31 2s
-8 R +08/+09 1992 Ja 19 2s
-9 R +09/+10 2011 Mar 27 2s
-10 - +10 2014 O 26 2s
-8 - +08 2016 Mar 27 2
-9 - +09
-Z Asia/Yakutsk 8:38:58 - LMT 1919 D 15
-8 - +08 1930 Jun 21
-9 R +09/+10 1991 Mar 31 2s
-8 R +08/+09 1992 Ja 19 2s
-9 R +09/+10 2011 Mar 27 2s
-10 - +10 2014 O 26 2s
-9 - +09
-Z Asia/Vladivostok 8:47:31 - LMT 1922 N 15
-9 - +09 1930 Jun 21
-10 R +10/+11 1991 Mar 31 2s
-9 R +09/+10 1992 Ja 19 2s
-10 R +10/+11 2011 Mar 27 2s
-11 - +11 2014 O 26 2s
-10 - +10
-Z Asia/Khandyga 9:2:13 - LMT 1919 D 15
-8 - +08 1930 Jun 21
-9 R +09/+10 1991 Mar 31 2s
-8 R +08/+09 1992 Ja 19 2s
-9 R +09/+10 2004
-10 R +10/+11 2011 Mar 27 2s
-11 - +11 2011 S 13 0s
-10 - +10 2014 O 26 2s
-9 - +09
-Z Asia/Sakhalin 9:30:48 - LMT 1905 Au 23
-9 - +09 1945 Au 25
-11 R +11/+12 1991 Mar 31 2s
-10 R +10/+11 1992 Ja 19 2s
-11 R +11/+12 1997 Mar lastSu 2s
-10 R +10/+11 2011 Mar 27 2s
-11 - +11 2014 O 26 2s
-10 - +10 2016 Mar 27 2s
-11 - +11
-Z Asia/Magadan 10:3:12 - LMT 1924 May 2
-10 - +10 1930 Jun 21
-11 R +11/+12 1991 Mar 31 2s
-10 R +10/+11 1992 Ja 19 2s
-11 R +11/+12 2011 Mar 27 2s
-12 - +12 2014 O 26 2s
-10 - +10 2016 Ap 24 2s
-11 - +11
-Z Asia/Srednekolymsk 10:14:52 - LMT 1924 May 2
-10 - +10 1930 Jun 21
-11 R +11/+12 1991 Mar 31 2s
-10 R +10/+11 1992 Ja 19 2s
-11 R +11/+12 2011 Mar 27 2s
-12 - +12 2014 O 26 2s
-11 - +11
-Z Asia/Ust-Nera 9:32:54 - LMT 1919 D 15
-8 - +08 1930 Jun 21
-9 R +09/+10 1981 Ap
-11 R +11/+12 1991 Mar 31 2s
-10 R +10/+11 1992 Ja 19 2s
-11 R +11/+12 2011 Mar 27 2s
-12 - +12 2011 S 13 0s
-11 - +11 2014 O 26 2s
-10 - +10
-Z Asia/Kamchatka 10:34:36 - LMT 1922 N 10
-11 - +11 1930 Jun 21
-12 R +12/+13 1991 Mar 31 2s
-11 R +11/+12 1992 Ja 19 2s
-12 R +12/+13 2010 Mar 28 2s
-11 R +11/+12 2011 Mar 27 2s
-12 - +12
-Z Asia/Anadyr 11:49:56 - LMT 1924 May 2
-12 - +12 1930 Jun 21
-13 R +13/+14 1982 Ap 1 0s
-12 R +12/+13 1991 Mar 31 2s
-11 R +11/+12 1992 Ja 19 2s
-12 R +12/+13 2010 Mar 28 2s
-11 R +11/+12 2011 Mar 27 2s
-12 - +12
-Z Europe/Belgrade 1:22 - LMT 1884
-1 - CET 1941 Ap 18 23
-1 c CE%sT 1945
-1 - CET 1945 May 8 2s
-1 1 CEST 1945 S 16 2s
-1 - CET 1982 N 27
-1 E CE%sT
 R s 1918 o - Ap 15 23 1 S
 R s 1918 1919 - O 6 24s 0 -
 R s 1919 o - Ap 6 23 1 S
@@ -2487,30 +1418,8 @@ R Sp 1976 o - Au 1 0 0 -
 R Sp 1977 o - S 28 0 0 -
 R Sp 1978 o - Jun 1 0 1 S
 R Sp 1978 o - Au 4 0 0 -
-Z Europe/Madrid -0:14:44 - LMT 1901 Ja 1 0u
-0 s WE%sT 1940 Mar 16 23
-1 s CE%sT 1979
-1 E CE%sT
-Z Africa/Ceuta -0:21:16 - LMT 1901 Ja 1 0u
-0 - WET 1918 May 6 23
-0 1 WEST 1918 O 7 23
-0 - WET 1924
-0 s WE%sT 1929
-0 - WET 1967
-0 Sp WE%sT 1984 Mar 16
-1 - CET 1986
-1 E CE%sT
-Z Atlantic/Canary -1:1:36 - LMT 1922 Mar
--1 - -01 1946 S 30 1
-0 - WET 1980 Ap 6 0s
-0 1 WEST 1980 S 28 1u
-0 E WE%sT
 R CH 1941 1942 - May M>=1 1 1 S
 R CH 1941 1942 - O M>=1 2 0 -
-Z Europe/Zurich 0:34:8 - LMT 1853 Jul 16
-0:29:46 - BMT 1894 Jun
-1 CH CE%sT 1981
-1 E CE%sT
 R T 1916 o - May 1 0 1 S
 R T 1916 o - O 1 0 0 -
 R T 1920 o - Mar 28 0 1 S
@@ -2556,28 +1465,6 @@ R T 1986 1995 - S lastSu 1s 0 -
 R T 1994 o - Mar 20 1s 1 S
 R T 1995 2006 - Mar lastSu 1s 1 S
 R T 1996 2006 - O lastSu 1s 0 -
-Z Europe/Istanbul 1:55:52 - LMT 1880
-1:56:56 - IMT 1910 O
-2 T EE%sT 1978 Jun 29
-3 T +03/+04 1984 N 1 2
-2 T EE%sT 2007
-2 E EE%sT 2011 Mar 27 1u
-2 - EET 2011 Mar 28 1u
-2 E EE%sT 2014 Mar 30 1u
-2 - EET 2014 Mar 31 1u
-2 E EE%sT 2015 O 25 1u
-2 1 EEST 2015 N 8 1u
-2 E EE%sT 2016 S 7
-3 - +03
-Z Europe/Kyiv 2:2:4 - LMT 1880
-2:2:4 - KMT 1924 May 2
-2 - EET 1930 Jun 21
-3 - MSK 1941 S 20
-1 c CE%sT 1943 N 6
-3 R MSK/MSD 1990 Jul 1 2
-2 1 EEST 1991 S 29 3
-2 c EE%sT 1996 May 13
-2 E EE%sT
 R u 1918 1919 - Mar lastSu 2 1 D
 R u 1918 1919 - O lastSu 2 0 S
 R u 1942 o - F 9 2 1 W
@@ -2591,172 +1478,34 @@ R u 1976 1986 - Ap lastSu 2 1 D
 R u 1987 2006 - Ap Su>=1 2 1 D
 R u 2007 ma - Mar Su>=8 2 1 D
 R u 2007 ma - N Su>=1 2 0 S
-Z EST -5 - EST
-Z MST -7 - MST
-Z HST -10 - HST
-Z EST5EDT -5 u E%sT
-Z CST6CDT -6 u C%sT
-Z MST7MDT -7 u M%sT
-Z PST8PDT -8 u P%sT
 R NY 1920 o - Mar lastSu 2 1 D
 R NY 1920 o - O lastSu 2 0 S
 R NY 1921 1966 - Ap lastSu 2 1 D
 R NY 1921 1954 - S lastSu 2 0 S
 R NY 1955 1966 - O lastSu 2 0 S
-Z America/New_York -4:56:2 - LMT 1883 N 18 17u
--5 u E%sT 1920
--5 NY E%sT 1942
--5 u E%sT 1946
--5 NY E%sT 1967
--5 u E%sT
 R Ch 1920 o - Jun 13 2 1 D
 R Ch 1920 1921 - O lastSu 2 0 S
 R Ch 1921 o - Mar lastSu 2 1 D
 R Ch 1922 1966 - Ap lastSu 2 1 D
 R Ch 1922 1954 - S lastSu 2 0 S
 R Ch 1955 1966 - O lastSu 2 0 S
-Z America/Chicago -5:50:36 - LMT 1883 N 18 18u
--6 u C%sT 1920
--6 Ch C%sT 1936 Mar 1 2
--5 - EST 1936 N 15 2
--6 Ch C%sT 1942
--6 u C%sT 1946
--6 Ch C%sT 1967
--6 u C%sT
-Z America/North_Dakota/Center -6:45:12 - LMT 1883 N 18 19u
--7 u M%sT 1992 O 25 2
--6 u C%sT
-Z America/North_Dakota/New_Salem -6:45:39 - LMT 1883 N 18 19u
--7 u M%sT 2003 O 26 2
--6 u C%sT
-Z America/North_Dakota/Beulah -6:47:7 - LMT 1883 N 18 19u
--7 u M%sT 2010 N 7 2
--6 u C%sT
 R De 1920 1921 - Mar lastSu 2 1 D
 R De 1920 o - O lastSu 2 0 S
 R De 1921 o - May 22 2 0 S
 R De 1965 1966 - Ap lastSu 2 1 D
 R De 1965 1966 - O lastSu 2 0 S
-Z America/Denver -6:59:56 - LMT 1883 N 18 19u
--7 u M%sT 1920
--7 De M%sT 1942
--7 u M%sT 1946
--7 De M%sT 1967
--7 u M%sT
 R CA 1948 o - Mar 14 2:1 1 D
 R CA 1949 o - Ja 1 2 0 S
 R CA 1950 1966 - Ap lastSu 1 1 D
 R CA 1950 1961 - S lastSu 2 0 S
 R CA 1962 1966 - O lastSu 2 0 S
-Z America/Los_Angeles -7:52:58 - LMT 1883 N 18 20u
--8 u P%sT 1946
--8 CA P%sT 1967
--8 u P%sT
-Z America/Juneau 15:2:19 - LMT 1867 O 19 15:33:32
--8:57:41 - LMT 1900 Au 20 12
--8 - PST 1942
--8 u P%sT 1946
--8 - PST 1969
--8 u P%sT 1980 Ap 27 2
--9 u Y%sT 1980 O 26 2
--8 u P%sT 1983 O 30 2
--9 u Y%sT 1983 N 30
--9 u AK%sT
-Z America/Sitka 14:58:47 - LMT 1867 O 19 15:30
--9:1:13 - LMT 1900 Au 20 12
--8 - PST 1942
--8 u P%sT 1946
--8 - PST 1969
--8 u P%sT 1983 O 30 2
--9 u Y%sT 1983 N 30
--9 u AK%sT
-Z America/Metlakatla 15:13:42 - LMT 1867 O 19 15:44:55
--8:46:18 - LMT 1900 Au 20 12
--8 - PST 1942
--8 u P%sT 1946
--8 - PST 1969
--8 u P%sT 1983 O 30 2
--8 - PST 2015 N 1 2
--9 u AK%sT 2018 N 4 2
--8 - PST 2019 Ja 20 2
--9 u AK%sT
-Z America/Yakutat 14:41:5 - LMT 1867 O 19 15:12:18
--9:18:55 - LMT 1900 Au 20 12
--9 - YST 1942
--9 u Y%sT 1946
--9 - YST 1969
--9 u Y%sT 1983 N 30
--9 u AK%sT
-Z America/Anchorage 14:0:24 - LMT 1867 O 19 14:31:37
--9:59:36 - LMT 1900 Au 20 12
--10 - AST 1942
--10 u A%sT 1967 Ap
--10 - AHST 1969
--10 u AH%sT 1983 O 30 2
--9 u Y%sT 1983 N 30
--9 u AK%sT
-Z America/Nome 12:58:22 - LMT 1867 O 19 13:29:35
--11:1:38 - LMT 1900 Au 20 12
--11 - NST 1942
--11 u N%sT 1946
--11 - NST 1967 Ap
--11 - BST 1969
--11 u B%sT 1983 O 30 2
--9 u Y%sT 1983 N 30
--9 u AK%sT
-Z America/Adak 12:13:22 - LMT 1867 O 19 12:44:35
--11:46:38 - LMT 1900 Au 20 12
--11 - NST 1942
--11 u N%sT 1946
--11 - NST 1967 Ap
--11 - BST 1969
--11 u B%sT 1983 O 30 2
--10 u AH%sT 1983 N 30
--10 u H%sT
-Z Pacific/Honolulu -10:31:26 - LMT 1896 Ja 13 12
--10:30 - HST 1933 Ap 30 2
--10:30 1 HDT 1933 May 21 12
--10:30 u H%sT 1947 Jun 8 2
--10 - HST
-Z America/Phoenix -7:28:18 - LMT 1883 N 18 19u
--7 u M%sT 1944 Ja 1 0:1
--7 - MST 1944 Ap 1 0:1
--7 u M%sT 1944 O 1 0:1
--7 - MST 1967
--7 u M%sT 1968 Mar 21
--7 - MST
-Z America/Boise -7:44:49 - LMT 1883 N 18 20u
--8 u P%sT 1923 May 13 2
--7 u M%sT 1974
--7 - MST 1974 F 3 2
--7 u M%sT
 R In 1941 o - Jun 22 2 1 D
 R In 1941 1954 - S lastSu 2 0 S
 R In 1946 1954 - Ap lastSu 2 1 D
-Z America/Indiana/Indianapolis -5:44:38 - LMT 1883 N 18 18u
--6 u C%sT 1920
--6 In C%sT 1942
--6 u C%sT 1946
--6 In C%sT 1955 Ap 24 2
--5 - EST 1957 S 29 2
--6 - CST 1958 Ap 27 2
--5 - EST 1969
--5 u E%sT 1971
--5 - EST 2006
--5 u E%sT
 R Ma 1951 o - Ap lastSu 2 1 D
 R Ma 1951 o - S lastSu 2 0 S
 R Ma 1954 1960 - Ap lastSu 2 1 D
 R Ma 1954 1960 - S lastSu 2 0 S
-Z America/Indiana/Marengo -5:45:23 - LMT 1883 N 18 18u
--6 u C%sT 1951
--6 Ma C%sT 1961 Ap 30 2
--5 - EST 1969
--5 u E%sT 1974 Ja 6 2
--6 1 CDT 1974 O 27 2
--5 u E%sT 1976
--5 - EST 2006
--5 u E%sT
 R V 1946 o - Ap lastSu 2 1 D
 R V 1946 o - S lastSu 2 0 S
 R V 1953 1954 - Ap lastSu 2 1 D
@@ -2766,68 +1515,23 @@ R V 1956 1963 - Ap lastSu 2 1 D
 R V 1960 o - O lastSu 2 0 S
 R V 1961 o - S lastSu 2 0 S
 R V 1962 1963 - O lastSu 2 0 S
-Z America/Indiana/Vincennes -5:50:7 - LMT 1883 N 18 18u
--6 u C%sT 1946
--6 V C%sT 1964 Ap 26 2
--5 - EST 1969
--5 u E%sT 1971
--5 - EST 2006 Ap 2 2
--6 u C%sT 2007 N 4 2
--5 u E%sT
 R Pe 1955 o - May 1 0 1 D
 R Pe 1955 1960 - S lastSu 2 0 S
 R Pe 1956 1963 - Ap lastSu 2 1 D
 R Pe 1961 1963 - O lastSu 2 0 S
-Z America/Indiana/Tell_City -5:47:3 - LMT 1883 N 18 18u
--6 u C%sT 1946
--6 Pe C%sT 1964 Ap 26 2
--5 - EST 1967 O 29 2
--6 u C%sT 1969 Ap 27 2
--5 u E%sT 1971
--5 - EST 2006 Ap 2 2
--6 u C%sT
 R Pi 1955 o - May 1 0 1 D
 R Pi 1955 1960 - S lastSu 2 0 S
 R Pi 1956 1964 - Ap lastSu 2 1 D
 R Pi 1961 1964 - O lastSu 2 0 S
-Z America/Indiana/Petersburg -5:49:7 - LMT 1883 N 18 18u
--6 u C%sT 1955
--6 Pi C%sT 1965 Ap 25 2
--5 - EST 1966 O 30 2
--6 u C%sT 1977 O 30 2
--5 - EST 2006 Ap 2 2
--6 u C%sT 2007 N 4 2
--5 u E%sT
 R St 1947 1961 - Ap lastSu 2 1 D
 R St 1947 1954 - S lastSu 2 0 S
 R St 1955 1956 - O lastSu 2 0 S
 R St 1957 1958 - S lastSu 2 0 S
 R St 1959 1961 - O lastSu 2 0 S
-Z America/Indiana/Knox -5:46:30 - LMT 1883 N 18 18u
--6 u C%sT 1947
--6 St C%sT 1962 Ap 29 2
--5 - EST 1963 O 27 2
--6 u C%sT 1991 O 27 2
--5 - EST 2006 Ap 2 2
--6 u C%sT
 R Pu 1946 1960 - Ap lastSu 2 1 D
 R Pu 1946 1954 - S lastSu 2 0 S
 R Pu 1955 1956 - O lastSu 2 0 S
 R Pu 1957 1960 - S lastSu 2 0 S
-Z America/Indiana/Winamac -5:46:25 - LMT 1883 N 18 18u
--6 u C%sT 1946
--6 Pu C%sT 1961 Ap 30 2
--5 - EST 1969
--5 u E%sT 1971
--5 - EST 2006 Ap 2 2
--6 u C%sT 2007 Mar 11 2
--5 u E%sT
-Z America/Indiana/Vevay -5:40:16 - LMT 1883 N 18 18u
--6 u C%sT 1954 Ap 25 2
--5 - EST 1969
--5 u E%sT 1973
--5 - EST 2006
--5 u E%sT
 R v 1921 o - May 1 2 1 D
 R v 1921 o - S 1 2 0 S
 R v 1941 o - Ap lastSu 2 1 D
@@ -2837,41 +1541,12 @@ R v 1946 o - Jun 2 2 0 S
 R v 1950 1961 - Ap lastSu 2 1 D
 R v 1950 1955 - S lastSu 2 0 S
 R v 1956 1961 - O lastSu 2 0 S
-Z America/Kentucky/Louisville -5:43:2 - LMT 1883 N 18 18u
--6 u C%sT 1921
--6 v C%sT 1942
--6 u C%sT 1946
--6 v C%sT 1961 Jul 23 2
--5 - EST 1968
--5 u E%sT 1974 Ja 6 2
--6 1 CDT 1974 O 27 2
--5 u E%sT
-Z America/Kentucky/Monticello -5:39:24 - LMT 1883 N 18 18u
--6 u C%sT 1946
--6 - CST 1968
--6 u C%sT 2000 O 29 2
--5 u E%sT
 R Dt 1948 o - Ap lastSu 2 1 D
 R Dt 1948 o - S lastSu 2 0 S
-Z America/Detroit -5:32:11 - LMT 1905
--6 - CST 1915 May 15 2
--5 - EST 1942
--5 u E%sT 1946
--5 Dt E%sT 1967 Jun 14 0:1
--5 u E%sT 1969
--5 - EST 1973
--5 u E%sT 1975
--5 - EST 1975 Ap 27 2
--5 u E%sT
 R Me 1946 o - Ap lastSu 2 1 D
 R Me 1946 o - S lastSu 2 0 S
 R Me 1966 o - Ap lastSu 2 1 D
 R Me 1966 o - O lastSu 2 0 S
-Z America/Menominee -5:50:27 - LMT 1885 S 18 12
--6 u C%sT 1946
--6 Me C%sT 1969 Ap 27 2
--5 - EST 1973 Ap 29 2
--6 u C%sT
 R C 1918 o - Ap 14 2 1 D
 R C 1918 o - O 27 2 0 S
 R C 1942 o - F 9 2 1 W
@@ -2901,24 +1576,6 @@ R j 1988 o - Ap Su>=1 0:1 2 DD
 R j 1989 2006 - Ap Su>=1 0:1 1 D
 R j 2007 2011 - Mar Su>=8 0:1 1 D
 R j 2007 2010 - N Su>=1 0:1 0 S
-Z America/St_Johns -3:30:52 - LMT 1884
--3:30:52 j N%sT 1918
--3:30:52 C N%sT 1919
--3:30:52 j N%sT 1935 Mar 30
--3:30 j N%sT 1942 May 11
--3:30 C N%sT 1946
--3:30 j N%sT 2011 N
--3:30 C N%sT
-Z America/Goose_Bay -4:1:40 - LMT 1884
--3:30:52 - NST 1918
--3:30:52 C N%sT 1919
--3:30:52 - NST 1935 Mar 30
--3:30 - NST 1936
--3:30 j N%sT 1942 May 11
--3:30 C N%sT 1946
--3:30 j N%sT 1966 Mar 15 2
--4 j A%sT 2011 N
--4 C A%sT
 R H 1916 o - Ap 1 0 1 D
 R H 1916 o - O 1 0 0 S
 R H 1920 o - May 9 0 1 D
@@ -2960,19 +1617,6 @@ R H 1956 1959 - Ap lastSu 2 1 D
 R H 1956 1959 - S lastSu 2 0 S
 R H 1962 1973 - Ap lastSu 2 1 D
 R H 1962 1973 - O lastSu 2 0 S
-Z America/Halifax -4:14:24 - LMT 1902 Jun 15
--4 H A%sT 1918
--4 C A%sT 1919
--4 H A%sT 1942 F 9 2s
--4 C A%sT 1946
--4 H A%sT 1974
--4 C A%sT
-Z America/Glace_Bay -3:59:48 - LMT 1902 Jun 15
--4 C A%sT 1953
--4 H A%sT 1954
--4 - AST 1972
--4 H A%sT 1974
--4 C A%sT
 R o 1933 1935 - Jun Su>=8 1 1 D
 R o 1933 1935 - S Su>=8 1 0 S
 R o 1936 1938 - Jun Su>=1 1 1 D
@@ -2986,15 +1630,6 @@ R o 1946 1956 - S lastSu 2 0 S
 R o 1957 1972 - O lastSu 2 0 S
 R o 1993 2006 - Ap Su>=1 0:1 1 D
 R o 1993 2006 - O lastSu 0:1 0 S
-Z America/Moncton -4:19:8 - LMT 1883 D 9
--5 - EST 1902 Jun 15
--4 C A%sT 1933
--4 o A%sT 1942
--4 C A%sT 1946
--4 o A%sT 1973
--4 C A%sT 1993
--4 o A%sT 2007
--4 C A%sT
 R t 1919 o - Mar 30 23:30 1 D
 R t 1919 o - O 26 0 0 S
 R t 1920 o - May 2 2 1 D
@@ -3008,21 +1643,11 @@ R t 1927 1937 - S Su>=25 2 0 S
 R t 1928 1937 - Ap Su>=25 2 1 D
 R t 1938 1940 - Ap lastSu 2 1 D
 R t 1938 1939 - S lastSu 2 0 S
-R t 1945 1946 - S lastSu 2 0 S
-R t 1946 o - Ap lastSu 2 1 D
-R t 1947 1949 - Ap lastSu 0 1 D
-R t 1947 1948 - S lastSu 0 0 S
-R t 1949 o - N lastSu 0 0 S
-R t 1950 1973 - Ap lastSu 2 1 D
-R t 1950 o - N lastSu 2 0 S
+R t 1945 1948 - S lastSu 2 0 S
+R t 1946 1973 - Ap lastSu 2 1 D
+R t 1949 1950 - N lastSu 2 0 S
 R t 1951 1956 - S lastSu 2 0 S
 R t 1957 1973 - O lastSu 2 0 S
-Z America/Toronto -5:17:32 - LMT 1895
--5 C E%sT 1919
--5 t E%sT 1942 F 9 2s
--5 C E%sT 1946
--5 t E%sT 1974
--5 C E%sT
 R W 1916 o - Ap 23 0 1 D
 R W 1916 o - S 17 0 0 S
 R W 1918 o - Ap 14 2 1 D
@@ -3047,9 +1672,6 @@ R W 1963 o - S 22 2 0 S
 R W 1966 1986 - Ap lastSu 2s 1 D
 R W 1966 2005 - O lastSu 2s 0 S
 R W 1987 2005 - Ap Su>=1 2s 1 D
-Z America/Winnipeg -6:28:36 - LMT 1887 Jul 16
--6 W C%sT 2006
--6 C C%sT
 R r 1918 o - Ap 14 2 1 D
 R r 1918 o - O 27 2 0 S
 R r 1930 1934 - May Su>=1 0 1 D
@@ -3072,14 +1694,6 @@ R Sw 1957 o - O lastSu 2 0 S
 R Sw 1959 1961 - Ap lastSu 2 1 D
 R Sw 1959 o - O lastSu 2 0 S
 R Sw 1960 1961 - S lastSu 2 0 S
-Z America/Regina -6:58:36 - LMT 1905 S
--7 r M%sT 1960 Ap lastSu 2
--6 - CST
-Z America/Swift_Current -7:11:20 - LMT 1905 S
--7 C M%sT 1946 Ap lastSu 2
--7 r M%sT 1950
--7 Sw M%sT 1972 Ap lastSu 2
--6 - CST
 R Ed 1918 1919 - Ap Su>=8 2 1 D
 R Ed 1918 o - O 27 2 0 S
 R Ed 1919 o - May 27 2 0 S
@@ -3093,9 +1707,6 @@ R Ed 1947 o - Ap lastSu 2 1 D
 R Ed 1947 o - S lastSu 2 0 S
 R Ed 1972 1986 - Ap lastSu 2 1 D
 R Ed 1972 2006 - O lastSu 2 0 S
-Z America/Edmonton -7:33:52 - LMT 1906 S
--7 Ed M%sT 1987
--7 C M%sT
 R Va 1918 o - Ap 14 2 1 D
 R Va 1918 o - O 27 2 0 S
 R Va 1942 o - F 9 2 1 W
@@ -3105,19 +1716,6 @@ R Va 1946 1986 - Ap lastSu 2 1 D
 R Va 1946 o - S 29 2 0 S
 R Va 1947 1961 - S lastSu 2 0 S
 R Va 1962 2006 - O lastSu 2 0 S
-Z America/Vancouver -8:12:28 - LMT 1884
--8 Va P%sT 1987
--8 C P%sT
-Z America/Dawson_Creek -8:0:56 - LMT 1884
--8 C P%sT 1947
--8 Va P%sT 1972 Au 30 2
--7 - MST
-Z America/Fort_Nelson -8:10:47 - LMT 1884
--8 Va P%sT 1946
--8 - PST 1947
--8 Va P%sT 1987
--8 C P%sT 2015 Mar 8 2
--7 - MST
 R Y 1918 o - Ap 14 2 1 D
 R Y 1918 o - O 27 2 0 S
 R Y 1919 o - May 25 2 1 D
@@ -3130,42 +1728,6 @@ R Y 1972 2006 - O lastSu 2 0 S
 R Y 1987 2006 - Ap Su>=1 2 1 D
 R Yu 1965 o - Ap lastSu 0 2 DD
 R Yu 1965 o - O lastSu 2 0 S
-Z America/Iqaluit 0 - -00 1942 Au
--5 Y E%sT 1999 O 31 2
--6 C C%sT 2000 O 29 2
--5 C E%sT
-Z America/Resolute 0 - -00 1947 Au 31
--6 Y C%sT 2000 O 29 2
--5 - EST 2001 Ap 1 3
--6 C C%sT 2006 O 29 2
--5 - EST 2007 Mar 11 3
--6 C C%sT
-Z America/Rankin_Inlet 0 - -00 1957
--6 Y C%sT 2000 O 29 2
--5 - EST 2001 Ap 1 3
--6 C C%sT
-Z America/Cambridge_Bay 0 - -00 1920
--7 Y M%sT 1999 O 31 2
--6 C C%sT 2000 O 29 2
--5 - EST 2000 N 5
--6 - CST 2001 Ap 1 3
--7 C M%sT
-Z America/Inuvik 0 - -00 1953
--8 Y P%sT 1979 Ap lastSu 2
--7 Y M%sT 1980
--7 C M%sT
-Z America/Whitehorse -9:0:12 - LMT 1900 Au 20
--9 Y Y%sT 1965
--9 Yu Y%sT 1966 F 27
--8 - PST 1980
--8 C P%sT 2020 N
--7 - MST
-Z America/Dawson -9:17:40 - LMT 1900 Au 20
--9 Y Y%sT 1965
--9 Yu Y%sT 1973 O 28
--8 - PST 1980
--8 C P%sT 2020 N
--7 - MST
 R m 1931 o - May 1 23 1 D
 R m 1931 o - O 1 0 0 S
 R m 1939 o - F 5 0 1 D
@@ -3182,107 +1744,6 @@ R m 2001 o - May Su>=1 2 1 D
 R m 2001 o - S lastSu 2 0 S
 R m 2002 2022 - Ap Su>=1 2 1 D
 R m 2002 2022 - O lastSu 2 0 S
-Z America/Cancun -5:47:4 - LMT 1922 Ja 1 6u
--6 - CST 1981 D 23
--5 m E%sT 1998 Au 2 2
--6 m C%sT 2015 F 1 2
--5 - EST
-Z America/Merida -5:58:28 - LMT 1922 Ja 1 6u
--6 - CST 1981 D 23
--5 - EST 1982 D 2
--6 m C%sT
-Z America/Matamoros -6:30 - LMT 1922 Ja 1 6u
--6 - CST 1988
--6 u C%sT 1989
--6 m C%sT 2010
--6 u C%sT
-Z America/Monterrey -6:41:16 - LMT 1922 Ja 1 6u
--6 - CST 1988
--6 u C%sT 1989
--6 m C%sT
-Z America/Mexico_City -6:36:36 - LMT 1922 Ja 1 7u
--7 - MST 1927 Jun 10 23
--6 - CST 1930 N 15
--7 m M%sT 1932 Ap
--6 m C%sT 2001 S 30 2
--6 - CST 2002 F 20
--6 m C%sT
-Z America/Ciudad_Juarez -7:5:56 - LMT 1922 Ja 1 7u
--7 - MST 1927 Jun 10 23
--6 - CST 1930 N 15
--7 m M%sT 1932 Ap
--6 - CST 1996
--6 m C%sT 1998
--6 - CST 1998 Ap Su>=1 3
--7 m M%sT 2010
--7 u M%sT 2022 O 30 2
--6 - CST 2022 N 30
--7 u M%sT
-Z America/Ojinaga -6:57:40 - LMT 1922 Ja 1 7u
--7 - MST 1927 Jun 10 23
--6 - CST 1930 N 15
--7 m M%sT 1932 Ap
--6 - CST 1996
--6 m C%sT 1998
--6 - CST 1998 Ap Su>=1 3
--7 m M%sT 2010
--7 u M%sT 2022 O 30 2
--6 - CST 2022 N 30
--6 u C%sT
-Z America/Chihuahua -7:4:20 - LMT 1922 Ja 1 7u
--7 - MST 1927 Jun 10 23
--6 - CST 1930 N 15
--7 m M%sT 1932 Ap
--6 - CST 1996
--6 m C%sT 1998
--6 - CST 1998 Ap Su>=1 3
--7 m M%sT 2022 O 30 2
--6 - CST
-Z America/Hermosillo -7:23:52 - LMT 1922 Ja 1 7u
--7 - MST 1927 Jun 10 23
--6 - CST 1930 N 15
--7 m M%sT 1932 Ap
--6 - CST 1942 Ap 24
--7 - MST 1949 Ja 14
--8 - PST 1970
--7 m M%sT 1999
--7 - MST
-Z America/Mazatlan -7:5:40 - LMT 1922 Ja 1 7u
--7 - MST 1927 Jun 10 23
--6 - CST 1930 N 15
--7 m M%sT 1932 Ap
--6 - CST 1942 Ap 24
--7 - MST 1949 Ja 14
--8 - PST 1970
--7 m M%sT
-Z America/Bahia_Banderas -7:1 - LMT 1922 Ja 1 7u
--7 - MST 1927 Jun 10 23
--6 - CST 1930 N 15
--7 m M%sT 1932 Ap
--6 - CST 1942 Ap 24
--7 - MST 1949 Ja 14
--8 - PST 1970
--7 m M%sT 2010 Ap 4 2
--6 m C%sT
-Z America/Tijuana -7:48:4 - LMT 1922 Ja 1 7u
--7 - MST 1924
--8 - PST 1927 Jun 10 23
--7 - MST 1930 N 15
--8 - PST 1931 Ap
--8 1 PDT 1931 S 30
--8 - PST 1942 Ap 24
--8 1 PWT 1945 Au 14 23u
--8 1 PPT 1945 N 12
--8 - PST 1948 Ap 5
--8 1 PDT 1949 Ja 14
--8 - PST 1954
--8 CA P%sT 1961
--8 - PST 1976
--8 u P%sT 1996
--8 m P%sT 2001
--8 u P%sT 2002 F 20
--8 m P%sT 2010
--8 u P%sT
 R BB 1942 o - Ap 19 5u 1 D
 R BB 1942 o - Au 31 6u 0 S
 R BB 1943 o - May 2 5u 1 D
@@ -3294,10 +1755,6 @@ R BB 1977 1978 - O Su>=1 2 0 S
 R BB 1978 1980 - Ap Su>=15 2 1 D
 R BB 1979 o - S 30 2 0 S
 R BB 1980 o - S 25 2 0 S
-Z America/Barbados -3:58:29 - LMT 1911 Au 28
--4 BB A%sT 1944
--4 BB AST/-0330 1945
--4 BB A%sT
 R BZ 1918 1941 - O Sa>=1 24 0:30 -0530
 R BZ 1919 1942 - F Sa>=8 24 0 CST
 R BZ 1942 o - Jun 27 24 1 CWT
@@ -3309,8 +1766,6 @@ R BZ 1973 o - D 5 0 1 CDT
 R BZ 1974 o - F 9 0 0 CST
 R BZ 1982 o - D 18 0 1 CDT
 R BZ 1983 o - F 12 0 0 CST
-Z America/Belize -5:52:48 - LMT 1912 Ap
--6 BZ %s
 R Be 1917 o - Ap 5 24 1 -
 R Be 1917 o - S 30 24 0 -
 R Be 1918 o - Ap 13 24 1 -
@@ -3327,19 +1782,11 @@ R Be 1948 1952 - May Su>=22 2 1 D
 R Be 1948 1952 - S Su>=1 2 0 S
 R Be 1956 o - May Su>=22 2 1 D
 R Be 1956 o - O lastSu 2 0 S
-Z Atlantic/Bermuda -4:19:18 - LMT 1890
--4:19:18 Be BMT/BST 1930 Ja 1 2
--4 Be A%sT 1974 Ap 28 2
--4 C A%sT 1976
--4 u A%sT
 R CR 1979 1980 - F lastSu 0 1 D
 R CR 1979 1980 - Jun Su>=1 0 0 S
 R CR 1991 1992 - Ja Sa>=15 0 1 D
 R CR 1991 o - Jul 1 0 0 S
 R CR 1992 o - Mar 15 0 0 S
-Z America/Costa_Rica -5:36:13 - LMT 1890
--5:36:13 - SJMT 1921 Ja 15
--6 CR C%sT
 R Q 1928 o - Jun 10 0 1 D
 R Q 1928 o - O 10 0 0 S
 R Q 1940 1942 - Jun Su>=1 0 1 D
@@ -3379,25 +1826,14 @@ R Q 2011 o - N 13 0s 0 S
 R Q 2012 o - Ap 1 0s 1 D
 R Q 2012 ma - N Su>=1 0s 0 S
 R Q 2013 ma - Mar Su>=8 0s 1 D
-Z America/Havana -5:29:28 - LMT 1890
--5:29:36 - HMT 1925 Jul 19 12
--5 Q C%sT
 R DO 1966 o - O 30 0 1 EDT
 R DO 1967 o - F 28 0 0 EST
 R DO 1969 1973 - O lastSu 0 0:30 -0430
 R DO 1970 o - F 21 0 0 EST
 R DO 1971 o - Ja 20 0 0 EST
 R DO 1972 1974 - Ja 21 0 0 EST
-Z America/Santo_Domingo -4:39:36 - LMT 1890
--4:40 - SDMT 1933 Ap 1 12
--5 DO %s 1974 O 27
--4 - AST 2000 O 29 2
--5 u E%sT 2000 D 3 1
--4 - AST
 R SV 1987 1988 - May Su>=1 0 1 D
 R SV 1987 1988 - S lastSu 0 0 S
-Z America/El_Salvador -5:56:48 - LMT 1921
--6 SV C%sT
 R GT 1973 o - N 25 0 1 D
 R GT 1974 o - F 24 0 0 S
 R GT 1983 o - May 21 0 1 D
@@ -3406,8 +1842,6 @@ R GT 1991 o - Mar 23 0 1 D
 R GT 1991 o - S 7 0 0 S
 R GT 2006 o - Ap 30 0 1 D
 R GT 2006 o - O 1 0 0 S
-Z America/Guatemala -6:2:4 - LMT 1918 O 5
--6 GT C%sT
 R HT 1983 o - May 8 0 1 D
 R HT 1984 1987 - Ap lastSu 0 1 D
 R HT 1983 1987 - O lastSu 0 0 S
@@ -3419,57 +1853,16 @@ R HT 2012 2015 - Mar Su>=8 2 1 D
 R HT 2012 2015 - N Su>=1 2 0 S
 R HT 2017 ma - Mar Su>=8 2 1 D
 R HT 2017 ma - N Su>=1 2 0 S
-Z America/Port-au-Prince -4:49:20 - LMT 1890
--4:49 - PPMT 1917 Ja 24 12
--5 HT E%sT
 R HN 1987 1988 - May Su>=1 0 1 D
 R HN 1987 1988 - S lastSu 0 0 S
 R HN 2006 o - May Su>=1 0 1 D
 R HN 2006 o - Au M>=1 0 0 S
-Z America/Tegucigalpa -5:48:52 - LMT 1921 Ap
--6 HN C%sT
-Z America/Jamaica -5:7:10 - LMT 1890
--5:7:10 - KMT 1912 F
--5 - EST 1974
--5 u E%sT 1984
--5 - EST
-Z America/Martinique -4:4:20 - LMT 1890
--4:4:20 - FFMT 1911 May
--4 - AST 1980 Ap 6
--4 1 ADT 1980 S 28
--4 - AST
 R NI 1979 1980 - Mar Su>=16 0 1 D
 R NI 1979 1980 - Jun M>=23 0 0 S
 R NI 2005 o - Ap 10 0 1 D
 R NI 2005 o - O Su>=1 0 0 S
 R NI 2006 o - Ap 30 2 1 D
 R NI 2006 o - O Su>=1 1 0 S
-Z America/Managua -5:45:8 - LMT 1890
--5:45:12 - MMT 1934 Jun 23
--6 - CST 1973 May
--5 - EST 1975 F 16
--6 NI C%sT 1992 Ja 1 4
--5 - EST 1992 S 24
--6 - CST 1993
--5 - EST 1997
--6 NI C%sT
-Z America/Panama -5:18:8 - LMT 1890
--5:19:36 - CMT 1908 Ap 22
--5 - EST
-Z America/Puerto_Rico -4:24:25 - LMT 1899 Mar 28 12
--4 - AST 1942 May 3
--4 u A%sT 1946
--4 - AST
-Z America/Miquelon -3:44:40 - LMT 1911 May 15
--4 - AST 1980 May
--3 - -03 1987
--3 C -03/-02
-Z America/Grand_Turk -4:44:32 - LMT 1890
--5:7:10 - KMT 1912 F
--5 - EST 1979
--5 u E%sT 2015 Mar 8 2
--4 - AST 2018 Mar 11 3
--5 u E%sT
 R A 1930 o - D 1 0 1 -
 R A 1931 o - Ap 1 0 0 -
 R A 1931 o - O 15 0 1 -
@@ -3499,150 +1892,8 @@ R A 2000 o - Mar 3 0 0 -
 R A 2007 o - D 30 0 1 -
 R A 2008 2009 - Mar Su>=15 0 0 -
 R A 2008 o - O Su>=15 0 1 -
-Z America/Argentina/Buenos_Aires -3:53:48 - LMT 1894 O 31
--4:16:48 - CMT 1920 May
--4 - -04 1930 D
--4 A -04/-03 1969 O 5
--3 A -03/-02 1999 O 3
--4 A -04/-03 2000 Mar 3
--3 A -03/-02
-Z America/Argentina/Cordoba -4:16:48 - LMT 1894 O 31
--4:16:48 - CMT 1920 May
--4 - -04 1930 D
--4 A -04/-03 1969 O 5
--3 A -03/-02 1991 Mar 3
--4 - -04 1991 O 20
--3 A -03/-02 1999 O 3
--4 A -04/-03 2000 Mar 3
--3 A -03/-02
-Z America/Argentina/Salta -4:21:40 - LMT 1894 O 31
--4:16:48 - CMT 1920 May
--4 - -04 1930 D
--4 A -04/-03 1969 O 5
--3 A -03/-02 1991 Mar 3
--4 - -04 1991 O 20
--3 A -03/-02 1999 O 3
--4 A -04/-03 2000 Mar 3
--3 A -03/-02 2008 O 18
--3 - -03
-Z America/Argentina/Tucuman -4:20:52 - LMT 1894 O 31
--4:16:48 - CMT 1920 May
--4 - -04 1930 D
--4 A -04/-03 1969 O 5
--3 A -03/-02 1991 Mar 3
--4 - -04 1991 O 20
--3 A -03/-02 1999 O 3
--4 A -04/-03 2000 Mar 3
--3 - -03 2004 Jun
--4 - -04 2004 Jun 13
--3 A -03/-02
-Z America/Argentina/La_Rioja -4:27:24 - LMT 1894 O 31
--4:16:48 - CMT 1920 May
--4 - -04 1930 D
--4 A -04/-03 1969 O 5
--3 A -03/-02 1991 Mar
--4 - -04 1991 May 7
--3 A -03/-02 1999 O 3
--4 A -04/-03 2000 Mar 3
--3 - -03 2004 Jun
--4 - -04 2004 Jun 20
--3 A -03/-02 2008 O 18
--3 - -03
-Z America/Argentina/San_Juan -4:34:4 - LMT 1894 O 31
--4:16:48 - CMT 1920 May
--4 - -04 1930 D
--4 A -04/-03 1969 O 5
--3 A -03/-02 1991 Mar
--4 - -04 1991 May 7
--3 A -03/-02 1999 O 3
--4 A -04/-03 2000 Mar 3
--3 - -03 2004 May 31
--4 - -04 2004 Jul 25
--3 A -03/-02 2008 O 18
--3 - -03
-Z America/Argentina/Jujuy -4:21:12 - LMT 1894 O 31
--4:16:48 - CMT 1920 May
--4 - -04 1930 D
--4 A -04/-03 1969 O 5
--3 A -03/-02 1990 Mar 4
--4 - -04 1990 O 28
--4 1 -03 1991 Mar 17
--4 - -04 1991 O 6
--3 1 -02 1992
--3 A -03/-02 1999 O 3
--4 A -04/-03 2000 Mar 3
--3 A -03/-02 2008 O 18
--3 - -03
-Z America/Argentina/Catamarca -4:23:8 - LMT 1894 O 31
--4:16:48 - CMT 1920 May
--4 - -04 1930 D
--4 A -04/-03 1969 O 5
--3 A -03/-02 1991 Mar 3
--4 - -04 1991 O 20
--3 A -03/-02 1999 O 3
--4 A -04/-03 2000 Mar 3
--3 - -03 2004 Jun
--4 - -04 2004 Jun 20
--3 A -03/-02 2008 O 18
--3 - -03
-Z America/Argentina/Mendoza -4:35:16 - LMT 1894 O 31
--4:16:48 - CMT 1920 May
--4 - -04 1930 D
--4 A -04/-03 1969 O 5
--3 A -03/-02 1990 Mar 4
--4 - -04 1990 O 15
--4 1 -03 1991 Mar
--4 - -04 1991 O 15
--4 1 -03 1992 Mar
--4 - -04 1992 O 18
--3 A -03/-02 1999 O 3
--4 A -04/-03 2000 Mar 3
--3 - -03 2004 May 23
--4 - -04 2004 S 26
--3 A -03/-02 2008 O 18
--3 - -03
 R Sa 2008 2009 - Mar Su>=8 0 0 -
 R Sa 2007 2008 - O Su>=8 0 1 -
-Z America/Argentina/San_Luis -4:25:24 - LMT 1894 O 31
--4:16:48 - CMT 1920 May
--4 - -04 1930 D
--4 A -04/-03 1969 O 5
--3 A -03/-02 1990
--3 1 -02 1990 Mar 14
--4 - -04 1990 O 15
--4 1 -03 1991 Mar
--4 - -04 1991 Jun
--3 - -03 1999 O 3
--4 1 -03 2000 Mar 3
--3 - -03 2004 May 31
--4 - -04 2004 Jul 25
--3 A -03/-02 2008 Ja 21
--4 Sa -04/-03 2009 O 11
--3 - -03
-Z America/Argentina/Rio_Gallegos -4:36:52 - LMT 1894 O 31
--4:16:48 - CMT 1920 May
--4 - -04 1930 D
--4 A -04/-03 1969 O 5
--3 A -03/-02 1999 O 3
--4 A -04/-03 2000 Mar 3
--3 - -03 2004 Jun
--4 - -04 2004 Jun 20
--3 A -03/-02 2008 O 18
--3 - -03
-Z America/Argentina/Ushuaia -4:33:12 - LMT 1894 O 31
--4:16:48 - CMT 1920 May
--4 - -04 1930 D
--4 A -04/-03 1969 O 5
--3 A -03/-02 1999 O 3
--4 A -04/-03 2000 Mar 3
--3 - -03 2004 May 30
--4 - -04 2004 Jun 20
--3 A -03/-02 2008 O 18
--3 - -03
-Z America/La_Paz -4:32:36 - LMT 1890
--4:32:36 - CMT 1931 O 15
--4:32:36 1 BST 1932 Mar 21
--4 - -04
 R B 1931 o - O 3 11 1 -
 R B 1932 1933 - Ap 1 0 0 -
 R B 1932 o - O 3 0 1 -
@@ -3700,90 +1951,6 @@ R B 2013 2014 - F Su>=15 0 0 -
 R B 2015 o - F Su>=22 0 0 -
 R B 2016 2019 - F Su>=15 0 0 -
 R B 2018 o - N Su>=1 0 1 -
-Z America/Noronha -2:9:40 - LMT 1914
--2 B -02/-01 1990 S 17
--2 - -02 1999 S 30
--2 B -02/-01 2000 O 15
--2 - -02 2001 S 13
--2 B -02/-01 2002 O
--2 - -02
-Z America/Belem -3:13:56 - LMT 1914
--3 B -03/-02 1988 S 12
--3 - -03
-Z America/Santarem -3:38:48 - LMT 1914
--4 B -04/-03 1988 S 12
--4 - -04 2008 Jun 24
--3 - -03
-Z America/Fortaleza -2:34 - LMT 1914
--3 B -03/-02 1990 S 17
--3 - -03 1999 S 30
--3 B -03/-02 2000 O 22
--3 - -03 2001 S 13
--3 B -03/-02 2002 O
--3 - -03
-Z America/Recife -2:19:36 - LMT 1914
--3 B -03/-02 1990 S 17
--3 - -03 1999 S 30
--3 B -03/-02 2000 O 15
--3 - -03 2001 S 13
--3 B -03/-02 2002 O
--3 - -03
-Z America/Araguaina -3:12:48 - LMT 1914
--3 B -03/-02 1990 S 17
--3 - -03 1995 S 14
--3 B -03/-02 2003 S 24
--3 - -03 2012 O 21
--3 B -03/-02 2013 S
--3 - -03
-Z America/Maceio -2:22:52 - LMT 1914
--3 B -03/-02 1990 S 17
--3 - -03 1995 O 13
--3 B -03/-02 1996 S 4
--3 - -03 1999 S 30
--3 B -03/-02 2000 O 22
--3 - -03 2001 S 13
--3 B -03/-02 2002 O
--3 - -03
-Z America/Bahia -2:34:4 - LMT 1914
--3 B -03/-02 2003 S 24
--3 - -03 2011 O 16
--3 B -03/-02 2012 O 21
--3 - -03
-Z America/Sao_Paulo -3:6:28 - LMT 1914
--3 B -03/-02 1963 O 23
--3 1 -02 1964
--3 B -03/-02
-Z America/Campo_Grande -3:38:28 - LMT 1914
--4 B -04/-03
-Z America/Cuiaba -3:44:20 - LMT 1914
--4 B -04/-03 2003 S 24
--4 - -04 2004 O
--4 B -04/-03
-Z America/Porto_Velho -4:15:36 - LMT 1914
--4 B -04/-03 1988 S 12
--4 - -04
-Z America/Boa_Vista -4:2:40 - LMT 1914
--4 B -04/-03 1988 S 12
--4 - -04 1999 S 30
--4 B -04/-03 2000 O 15
--4 - -04
-Z America/Manaus -4:0:4 - LMT 1914
--4 B -04/-03 1988 S 12
--4 - -04 1993 S 28
--4 B -04/-03 1994 S 22
--4 - -04
-Z America/Eirunepe -4:39:28 - LMT 1914
--5 B -05/-04 1988 S 12
--5 - -05 1993 S 28
--5 B -05/-04 1994 S 22
--5 - -05 2008 Jun 24
--4 - -04 2013 N 10
--5 - -05
-Z America/Rio_Branco -4:31:12 - LMT 1914
--5 B -05/-04 1988 S 12
--5 - -05 2008 Jun 24
--4 - -04 2013 N 10
--5 - -05
 R x 1927 1931 - S 1 0 1 -
 R x 1928 1932 - Ap 1 0 0 -
 R x 1968 o - N 3 4u 1 -
@@ -3820,56 +1987,10 @@ R x 2019 ma - Ap Su>=2 3u 0 -
 R x 2019 2021 - S Su>=2 4u 1 -
 R x 2022 o - S Su>=9 4u 1 -
 R x 2023 ma - S Su>=2 4u 1 -
-Z America/Santiago -4:42:45 - LMT 1890
--4:42:45 - SMT 1910 Ja 10
--5 - -05 1916 Jul
--4:42:45 - SMT 1918 S 10
--4 - -04 1919 Jul
--4:42:45 - SMT 1927 S
--5 x -05/-04 1932 S
--4 - -04 1942 Jun
--5 - -05 1942 Au
--4 - -04 1946 Jul 14 24
--4 1 -03 1946 Au 28 24
--5 1 -04 1947 Mar 31 24
--5 - -05 1947 May 21 23
--4 x -04/-03
-Z America/Punta_Arenas -4:43:40 - LMT 1890
--4:42:45 - SMT 1910 Ja 10
--5 - -05 1916 Jul
--4:42:45 - SMT 1918 S 10
--4 - -04 1919 Jul
--4:42:45 - SMT 1927 S
--5 x -05/-04 1932 S
--4 - -04 1942 Jun
--5 - -05 1942 Au
--4 - -04 1946 Au 28 24
--5 1 -04 1947 Mar 31 24
--5 - -05 1947 May 21 23
--4 x -04/-03 2016 D 4
--3 - -03
-Z Pacific/Easter -7:17:28 - LMT 1890
--7:17:28 - EMT 1932 S
--7 x -07/-06 1982 Mar 14 3u
--6 x -06/-05
-Z Antarctica/Palmer 0 - -00 1965
--4 A -04/-03 1969 O 5
--3 A -03/-02 1982 May
--4 x -04/-03 2016 D 4
--3 - -03
 R CO 1992 o - May 3 0 1 -
 R CO 1993 o - F 6 24 0 -
-Z America/Bogota -4:56:16 - LMT 1884 Mar 13
--4:56:16 - BMT 1914 N 23
--5 CO -05/-04
 R EC 1992 o - N 28 0 1 -
 R EC 1993 o - F 5 0 0 -
-Z America/Guayaquil -5:19:20 - LMT 1890
--5:14 - QMT 1931
--5 EC -05/-04
-Z Pacific/Galapagos -5:58:24 - LMT 1931
--5 - -05 1986
--6 EC -06/-05
 R FK 1937 1938 - S lastSu 0 1 -
 R FK 1938 1942 - Mar Su>=19 0 0 -
 R FK 1939 o - O 1 0 1 -
@@ -3882,20 +2003,6 @@ R FK 1985 2000 - S Su>=9 0 1 -
 R FK 1986 2000 - Ap Su>=16 0 0 -
 R FK 2001 2010 - Ap Su>=15 2 0 -
 R FK 2001 2010 - S Su>=1 2 1 -
-Z Atlantic/Stanley -3:51:24 - LMT 1890
--3:51:24 - SMT 1912 Mar 12
--4 FK -04/-03 1983 May
--3 FK -03/-02 1985 S 15
--4 FK -04/-03 2010 S 5 2
--3 - -03
-Z America/Cayenne -3:29:20 - LMT 1911 Jul
--4 - -04 1967 O
--3 - -03
-Z America/Guyana -3:52:39 - LMT 1911 Au
--4 - -04 1915 Mar
--3:45 - -0345 1975 Au
--3 - -03 1992 Mar 29 1
--4 - -04
 R y 1975 1988 - O 1 0 1 -
 R y 1975 1978 - Mar 1 0 0 -
 R y 1979 1991 - Ap 1 0 0 -
@@ -3918,11 +2025,6 @@ R y 2005 2009 - Mar Su>=8 0 0 -
 R y 2010 ma - O Su>=1 0 1 -
 R y 2010 2012 - Ap Su>=8 0 0 -
 R y 2013 ma - Mar Su>=22 0 0 -
-Z America/Asuncion -3:50:40 - LMT 1890
--3:50:40 - AMT 1931 O 10
--4 - -04 1972 O
--3 - -03 1974 Ap
--4 y -04/-03
 R PE 1938 o - Ja 1 0 1 -
 R PE 1938 o - Ap 1 0 0 -
 R PE 1938 1939 - S lastSu 0 1 -
@@ -3933,16 +2035,6 @@ R PE 1990 o - Ja 1 0 1 -
 R PE 1990 o - Ap 1 0 0 -
 R PE 1994 o - Ja 1 0 1 -
 R PE 1994 o - Ap 1 0 0 -
-Z America/Lima -5:8:12 - LMT 1890
--5:8:36 - LMT 1908 Jul 28
--5 PE -05/-04
-Z Atlantic/South_Georgia -2:26:8 - LMT 1890
--2 - -02
-Z America/Paramaribo -3:40:40 - LMT 1911
--3:40:52 - PMT 1935
--3:40:36 - PMT 1945 O
--3:30 - -0330 1984 O
--3 - -03
 R U 1923 1925 - O 1 0 0:30 -
 R U 1924 1926 - Ap 1 0 0 -
 R U 1933 1938 - O lastSu 0 0:30 -
@@ -3991,6 +2083,659 @@ R U 2005 o - Mar 27 2 0 -
 R U 2005 o - O 9 2 1 -
 R U 2006 2015 - Mar Su>=8 2 0 -
 R U 2006 2014 - O Su>=1 2 1 -
+Z Africa/Abidjan -0:16:8 - LMT 1912
+0 - GMT
+Z Africa/Algiers 0:12:12 - LMT 1891 Mar 16
+0:9:21 - PMT 1911 Mar 11
+0 d WE%sT 1940 F 25 2
+1 d CE%sT 1946 O 7
+0 - WET 1956 Ja 29
+1 - CET 1963 Ap 14
+0 d WE%sT 1977 O 21
+1 d CE%sT 1979 O 26
+0 d WE%sT 1981 May
+1 - CET
+Z Africa/Bissau -1:2:20 - LMT 1912 Ja 1 1u
+-1 - -01 1975
+0 - GMT
+Z Africa/Cairo 2:5:9 - LMT 1900 O
+2 K EE%sT
+Z Africa/Casablanca -0:30:20 - LMT 1913 O 26
+0 M +00/+01 1984 Mar 16
+1 - +01 1986
+0 M +00/+01 2018 O 28 3
+1 M +01/+00
+Z Africa/Ceuta -0:21:16 - LMT 1901 Ja 1 0u
+0 - WET 1918 May 6 23
+0 1 WEST 1918 O 7 23
+0 - WET 1924
+0 s WE%sT 1929
+0 - WET 1967
+0 Sp WE%sT 1984 Mar 16
+1 - CET 1986
+1 E CE%sT
+Z Africa/El_Aaiun -0:52:48 - LMT 1934
+-1 - -01 1976 Ap 14
+0 M +00/+01 2018 O 28 3
+1 M +01/+00
+Z Africa/Johannesburg 1:52 - LMT 1892 F 8
+1:30 - SAST 1903 Mar
+2 SA SAST
+Z Africa/Juba 2:6:28 - LMT 1931
+2 SD CA%sT 2000 Ja 15 12
+3 - EAT 2021 F
+2 - CAT
+Z Africa/Khartoum 2:10:8 - LMT 1931
+2 SD CA%sT 2000 Ja 15 12
+3 - EAT 2017 N
+2 - CAT
+Z Africa/Lagos 0:13:35 - LMT 1905 Jul
+0 - GMT 1908 Jul
+0:13:35 - LMT 1914
+0:30 - +0030 1919 S
+1 - WAT
+Z Africa/Maputo 2:10:20 - LMT 1903 Mar
+2 - CAT
+Z Africa/Monrovia -0:43:8 - LMT 1882
+-0:43:8 - MMT 1919 Mar
+-0:44:30 - MMT 1972 Ja 7
+0 - GMT
+Z Africa/Nairobi 2:27:16 - LMT 1908 May
+2:30 - +0230 1928 Jun 30 24
+3 - EAT 1930 Ja 4 24
+2:30 - +0230 1936 D 31 24
+2:45 - +0245 1942 Jul 31 24
+3 - EAT
+Z Africa/Ndjamena 1:0:12 - LMT 1912
+1 - WAT 1979 O 14
+1 1 WAST 1980 Mar 8
+1 - WAT
+Z Africa/Sao_Tome 0:26:56 - LMT 1884
+-0:36:45 - LMT 1912 Ja 1 0u
+0 - GMT 2018 Ja 1 1
+1 - WAT 2019 Ja 1 2
+0 - GMT
+Z Africa/Tripoli 0:52:44 - LMT 1920
+1 L CE%sT 1959
+2 - EET 1982
+1 L CE%sT 1990 May 4
+2 - EET 1996 S 30
+1 L CE%sT 1997 O 4
+2 - EET 2012 N 10 2
+1 L CE%sT 2013 O 25 2
+2 - EET
+Z Africa/Tunis 0:40:44 - LMT 1881 May 12
+0:9:21 - PMT 1911 Mar 11
+1 n CE%sT
+Z Africa/Windhoek 1:8:24 - LMT 1892 F 8
+1:30 - +0130 1903 Mar
+2 - SAST 1942 S 20 2
+2 1 SAST 1943 Mar 21 2
+2 - SAST 1990 Mar 21
+2 NA %s
+Z America/Adak 12:13:22 - LMT 1867 O 19 12:44:35
+-11:46:38 - LMT 1900 Au 20 12
+-11 - NST 1942
+-11 u N%sT 1946
+-11 - NST 1967 Ap
+-11 - BST 1969
+-11 u B%sT 1983 O 30 2
+-10 u AH%sT 1983 N 30
+-10 u H%sT
+Z America/Anchorage 14:0:24 - LMT 1867 O 19 14:31:37
+-9:59:36 - LMT 1900 Au 20 12
+-10 - AST 1942
+-10 u A%sT 1967 Ap
+-10 - AHST 1969
+-10 u AH%sT 1983 O 30 2
+-9 u Y%sT 1983 N 30
+-9 u AK%sT
+Z America/Araguaina -3:12:48 - LMT 1914
+-3 B -03/-02 1990 S 17
+-3 - -03 1995 S 14
+-3 B -03/-02 2003 S 24
+-3 - -03 2012 O 21
+-3 B -03/-02 2013 S
+-3 - -03
+Z America/Argentina/Buenos_Aires -3:53:48 - LMT 1894 O 31
+-4:16:48 - CMT 1920 May
+-4 - -04 1930 D
+-4 A -04/-03 1969 O 5
+-3 A -03/-02 1999 O 3
+-4 A -04/-03 2000 Mar 3
+-3 A -03/-02
+Z America/Argentina/Catamarca -4:23:8 - LMT 1894 O 31
+-4:16:48 - CMT 1920 May
+-4 - -04 1930 D
+-4 A -04/-03 1969 O 5
+-3 A -03/-02 1991 Mar 3
+-4 - -04 1991 O 20
+-3 A -03/-02 1999 O 3
+-4 A -04/-03 2000 Mar 3
+-3 - -03 2004 Jun
+-4 - -04 2004 Jun 20
+-3 A -03/-02 2008 O 18
+-3 - -03
+Z America/Argentina/Cordoba -4:16:48 - LMT 1894 O 31
+-4:16:48 - CMT 1920 May
+-4 - -04 1930 D
+-4 A -04/-03 1969 O 5
+-3 A -03/-02 1991 Mar 3
+-4 - -04 1991 O 20
+-3 A -03/-02 1999 O 3
+-4 A -04/-03 2000 Mar 3
+-3 A -03/-02
+Z America/Argentina/Jujuy -4:21:12 - LMT 1894 O 31
+-4:16:48 - CMT 1920 May
+-4 - -04 1930 D
+-4 A -04/-03 1969 O 5
+-3 A -03/-02 1990 Mar 4
+-4 - -04 1990 O 28
+-4 1 -03 1991 Mar 17
+-4 - -04 1991 O 6
+-3 1 -02 1992
+-3 A -03/-02 1999 O 3
+-4 A -04/-03 2000 Mar 3
+-3 A -03/-02 2008 O 18
+-3 - -03
+Z America/Argentina/La_Rioja -4:27:24 - LMT 1894 O 31
+-4:16:48 - CMT 1920 May
+-4 - -04 1930 D
+-4 A -04/-03 1969 O 5
+-3 A -03/-02 1991 Mar
+-4 - -04 1991 May 7
+-3 A -03/-02 1999 O 3
+-4 A -04/-03 2000 Mar 3
+-3 - -03 2004 Jun
+-4 - -04 2004 Jun 20
+-3 A -03/-02 2008 O 18
+-3 - -03
+Z America/Argentina/Mendoza -4:35:16 - LMT 1894 O 31
+-4:16:48 - CMT 1920 May
+-4 - -04 1930 D
+-4 A -04/-03 1969 O 5
+-3 A -03/-02 1990 Mar 4
+-4 - -04 1990 O 15
+-4 1 -03 1991 Mar
+-4 - -04 1991 O 15
+-4 1 -03 1992 Mar
+-4 - -04 1992 O 18
+-3 A -03/-02 1999 O 3
+-4 A -04/-03 2000 Mar 3
+-3 - -03 2004 May 23
+-4 - -04 2004 S 26
+-3 A -03/-02 2008 O 18
+-3 - -03
+Z America/Argentina/Rio_Gallegos -4:36:52 - LMT 1894 O 31
+-4:16:48 - CMT 1920 May
+-4 - -04 1930 D
+-4 A -04/-03 1969 O 5
+-3 A -03/-02 1999 O 3
+-4 A -04/-03 2000 Mar 3
+-3 - -03 2004 Jun
+-4 - -04 2004 Jun 20
+-3 A -03/-02 2008 O 18
+-3 - -03
+Z America/Argentina/Salta -4:21:40 - LMT 1894 O 31
+-4:16:48 - CMT 1920 May
+-4 - -04 1930 D
+-4 A -04/-03 1969 O 5
+-3 A -03/-02 1991 Mar 3
+-4 - -04 1991 O 20
+-3 A -03/-02 1999 O 3
+-4 A -04/-03 2000 Mar 3
+-3 A -03/-02 2008 O 18
+-3 - -03
+Z America/Argentina/San_Juan -4:34:4 - LMT 1894 O 31
+-4:16:48 - CMT 1920 May
+-4 - -04 1930 D
+-4 A -04/-03 1969 O 5
+-3 A -03/-02 1991 Mar
+-4 - -04 1991 May 7
+-3 A -03/-02 1999 O 3
+-4 A -04/-03 2000 Mar 3
+-3 - -03 2004 May 31
+-4 - -04 2004 Jul 25
+-3 A -03/-02 2008 O 18
+-3 - -03
+Z America/Argentina/San_Luis -4:25:24 - LMT 1894 O 31
+-4:16:48 - CMT 1920 May
+-4 - -04 1930 D
+-4 A -04/-03 1969 O 5
+-3 A -03/-02 1990
+-3 1 -02 1990 Mar 14
+-4 - -04 1990 O 15
+-4 1 -03 1991 Mar
+-4 - -04 1991 Jun
+-3 - -03 1999 O 3
+-4 1 -03 2000 Mar 3
+-3 - -03 2004 May 31
+-4 - -04 2004 Jul 25
+-3 A -03/-02 2008 Ja 21
+-4 Sa -04/-03 2009 O 11
+-3 - -03
+Z America/Argentina/Tucuman -4:20:52 - LMT 1894 O 31
+-4:16:48 - CMT 1920 May
+-4 - -04 1930 D
+-4 A -04/-03 1969 O 5
+-3 A -03/-02 1991 Mar 3
+-4 - -04 1991 O 20
+-3 A -03/-02 1999 O 3
+-4 A -04/-03 2000 Mar 3
+-3 - -03 2004 Jun
+-4 - -04 2004 Jun 13
+-3 A -03/-02
+Z America/Argentina/Ushuaia -4:33:12 - LMT 1894 O 31
+-4:16:48 - CMT 1920 May
+-4 - -04 1930 D
+-4 A -04/-03 1969 O 5
+-3 A -03/-02 1999 O 3
+-4 A -04/-03 2000 Mar 3
+-3 - -03 2004 May 30
+-4 - -04 2004 Jun 20
+-3 A -03/-02 2008 O 18
+-3 - -03
+Z America/Asuncion -3:50:40 - LMT 1890
+-3:50:40 - AMT 1931 O 10
+-4 - -04 1972 O
+-3 - -03 1974 Ap
+-4 y -04/-03
+Z America/Bahia -2:34:4 - LMT 1914
+-3 B -03/-02 2003 S 24
+-3 - -03 2011 O 16
+-3 B -03/-02 2012 O 21
+-3 - -03
+Z America/Bahia_Banderas -7:1 - LMT 1922 Ja 1 7u
+-7 - MST 1927 Jun 10 23
+-6 - CST 1930 N 15
+-7 m M%sT 1932 Ap
+-6 - CST 1942 Ap 24
+-7 - MST 1949 Ja 14
+-8 - PST 1970
+-7 m M%sT 2010 Ap 4 2
+-6 m C%sT
+Z America/Barbados -3:58:29 - LMT 1911 Au 28
+-4 BB A%sT 1944
+-4 BB AST/-0330 1945
+-4 BB A%sT
+Z America/Belem -3:13:56 - LMT 1914
+-3 B -03/-02 1988 S 12
+-3 - -03
+Z America/Belize -5:52:48 - LMT 1912 Ap
+-6 BZ %s
+Z America/Boa_Vista -4:2:40 - LMT 1914
+-4 B -04/-03 1988 S 12
+-4 - -04 1999 S 30
+-4 B -04/-03 2000 O 15
+-4 - -04
+Z America/Bogota -4:56:16 - LMT 1884 Mar 13
+-4:56:16 - BMT 1914 N 23
+-5 CO -05/-04
+Z America/Boise -7:44:49 - LMT 1883 N 18 20u
+-8 u P%sT 1923 May 13 2
+-7 u M%sT 1974
+-7 - MST 1974 F 3 2
+-7 u M%sT
+Z America/Cambridge_Bay 0 - -00 1920
+-7 Y M%sT 1999 O 31 2
+-6 C C%sT 2000 O 29 2
+-5 - EST 2000 N 5
+-6 - CST 2001 Ap 1 3
+-7 C M%sT
+Z America/Campo_Grande -3:38:28 - LMT 1914
+-4 B -04/-03
+Z America/Cancun -5:47:4 - LMT 1922 Ja 1 6u
+-6 - CST 1981 D 23
+-5 m E%sT 1998 Au 2 2
+-6 m C%sT 2015 F 1 2
+-5 - EST
+Z America/Caracas -4:27:44 - LMT 1890
+-4:27:40 - CMT 1912 F 12
+-4:30 - -0430 1965
+-4 - -04 2007 D 9 3
+-4:30 - -0430 2016 May 1 2:30
+-4 - -04
+Z America/Cayenne -3:29:20 - LMT 1911 Jul
+-4 - -04 1967 O
+-3 - -03
+Z America/Chicago -5:50:36 - LMT 1883 N 18 18u
+-6 u C%sT 1920
+-6 Ch C%sT 1936 Mar 1 2
+-5 - EST 1936 N 15 2
+-6 Ch C%sT 1942
+-6 u C%sT 1946
+-6 Ch C%sT 1967
+-6 u C%sT
+Z America/Chihuahua -7:4:20 - LMT 1922 Ja 1 7u
+-7 - MST 1927 Jun 10 23
+-6 - CST 1930 N 15
+-7 m M%sT 1932 Ap
+-6 - CST 1996
+-6 m C%sT 1998
+-6 - CST 1998 Ap Su>=1 3
+-7 m M%sT 2022 O 30 2
+-6 - CST
+Z America/Ciudad_Juarez -7:5:56 - LMT 1922 Ja 1 7u
+-7 - MST 1927 Jun 10 23
+-6 - CST 1930 N 15
+-7 m M%sT 1932 Ap
+-6 - CST 1996
+-6 m C%sT 1998
+-6 - CST 1998 Ap Su>=1 3
+-7 m M%sT 2010
+-7 u M%sT 2022 O 30 2
+-6 - CST 2022 N 30
+-7 u M%sT
+Z America/Costa_Rica -5:36:13 - LMT 1890
+-5:36:13 - SJMT 1921 Ja 15
+-6 CR C%sT
+Z America/Cuiaba -3:44:20 - LMT 1914
+-4 B -04/-03 2003 S 24
+-4 - -04 2004 O
+-4 B -04/-03
+Z America/Danmarkshavn -1:14:40 - LMT 1916 Jul 28
+-3 - -03 1980 Ap 6 2
+-3 E -03/-02 1996
+0 - GMT
+Z America/Dawson -9:17:40 - LMT 1900 Au 20
+-9 Y Y%sT 1965
+-9 Yu Y%sT 1973 O 28
+-8 - PST 1980
+-8 C P%sT 2020 N
+-7 - MST
+Z America/Dawson_Creek -8:0:56 - LMT 1884
+-8 C P%sT 1947
+-8 Va P%sT 1972 Au 30 2
+-7 - MST
+Z America/Denver -6:59:56 - LMT 1883 N 18 19u
+-7 u M%sT 1920
+-7 De M%sT 1942
+-7 u M%sT 1946
+-7 De M%sT 1967
+-7 u M%sT
+Z America/Detroit -5:32:11 - LMT 1905
+-6 - CST 1915 May 15 2
+-5 - EST 1942
+-5 u E%sT 1946
+-5 Dt E%sT 1967 Jun 14 0:1
+-5 u E%sT 1969
+-5 - EST 1973
+-5 u E%sT 1975
+-5 - EST 1975 Ap 27 2
+-5 u E%sT
+Z America/Edmonton -7:33:52 - LMT 1906 S
+-7 Ed M%sT 1987
+-7 C M%sT
+Z America/Eirunepe -4:39:28 - LMT 1914
+-5 B -05/-04 1988 S 12
+-5 - -05 1993 S 28
+-5 B -05/-04 1994 S 22
+-5 - -05 2008 Jun 24
+-4 - -04 2013 N 10
+-5 - -05
+Z America/El_Salvador -5:56:48 - LMT 1921
+-6 SV C%sT
+Z America/Fort_Nelson -8:10:47 - LMT 1884
+-8 Va P%sT 1946
+-8 - PST 1947
+-8 Va P%sT 1987
+-8 C P%sT 2015 Mar 8 2
+-7 - MST
+Z America/Fortaleza -2:34 - LMT 1914
+-3 B -03/-02 1990 S 17
+-3 - -03 1999 S 30
+-3 B -03/-02 2000 O 22
+-3 - -03 2001 S 13
+-3 B -03/-02 2002 O
+-3 - -03
+Z America/Glace_Bay -3:59:48 - LMT 1902 Jun 15
+-4 C A%sT 1953
+-4 H A%sT 1954
+-4 - AST 1972
+-4 H A%sT 1974
+-4 C A%sT
+Z America/Goose_Bay -4:1:40 - LMT 1884
+-3:30:52 - NST 1918
+-3:30:52 C N%sT 1919
+-3:30:52 - NST 1935 Mar 30
+-3:30 - NST 1936
+-3:30 j N%sT 1942 May 11
+-3:30 C N%sT 1946
+-3:30 j N%sT 1966 Mar 15 2
+-4 j A%sT 2011 N
+-4 C A%sT
+Z America/Grand_Turk -4:44:32 - LMT 1890
+-5:7:10 - KMT 1912 F
+-5 - EST 1979
+-5 u E%sT 2015 Mar 8 2
+-4 - AST 2018 Mar 11 3
+-5 u E%sT
+Z America/Guatemala -6:2:4 - LMT 1918 O 5
+-6 GT C%sT
+Z America/Guayaquil -5:19:20 - LMT 1890
+-5:14 - QMT 1931
+-5 EC -05/-04
+Z America/Guyana -3:52:39 - LMT 1911 Au
+-4 - -04 1915 Mar
+-3:45 - -0345 1975 Au
+-3 - -03 1992 Mar 29 1
+-4 - -04
+Z America/Halifax -4:14:24 - LMT 1902 Jun 15
+-4 H A%sT 1918
+-4 C A%sT 1919
+-4 H A%sT 1942 F 9 2s
+-4 C A%sT 1946
+-4 H A%sT 1974
+-4 C A%sT
+Z America/Havana -5:29:28 - LMT 1890
+-5:29:36 - HMT 1925 Jul 19 12
+-5 Q C%sT
+Z America/Hermosillo -7:23:52 - LMT 1922 Ja 1 7u
+-7 - MST 1927 Jun 10 23
+-6 - CST 1930 N 15
+-7 m M%sT 1932 Ap
+-6 - CST 1942 Ap 24
+-7 - MST 1949 Ja 14
+-8 - PST 1970
+-7 m M%sT 1999
+-7 - MST
+Z America/Indiana/Indianapolis -5:44:38 - LMT 1883 N 18 18u
+-6 u C%sT 1920
+-6 In C%sT 1942
+-6 u C%sT 1946
+-6 In C%sT 1955 Ap 24 2
+-5 - EST 1957 S 29 2
+-6 - CST 1958 Ap 27 2
+-5 - EST 1969
+-5 u E%sT 1971
+-5 - EST 2006
+-5 u E%sT
+Z America/Indiana/Knox -5:46:30 - LMT 1883 N 18 18u
+-6 u C%sT 1947
+-6 St C%sT 1962 Ap 29 2
+-5 - EST 1963 O 27 2
+-6 u C%sT 1991 O 27 2
+-5 - EST 2006 Ap 2 2
+-6 u C%sT
+Z America/Indiana/Marengo -5:45:23 - LMT 1883 N 18 18u
+-6 u C%sT 1951
+-6 Ma C%sT 1961 Ap 30 2
+-5 - EST 1969
+-5 u E%sT 1974 Ja 6 2
+-6 1 CDT 1974 O 27 2
+-5 u E%sT 1976
+-5 - EST 2006
+-5 u E%sT
+Z America/Indiana/Petersburg -5:49:7 - LMT 1883 N 18 18u
+-6 u C%sT 1955
+-6 Pi C%sT 1965 Ap 25 2
+-5 - EST 1966 O 30 2
+-6 u C%sT 1977 O 30 2
+-5 - EST 2006 Ap 2 2
+-6 u C%sT 2007 N 4 2
+-5 u E%sT
+Z America/Indiana/Tell_City -5:47:3 - LMT 1883 N 18 18u
+-6 u C%sT 1946
+-6 Pe C%sT 1964 Ap 26 2
+-5 - EST 1967 O 29 2
+-6 u C%sT 1969 Ap 27 2
+-5 u E%sT 1971
+-5 - EST 2006 Ap 2 2
+-6 u C%sT
+Z America/Indiana/Vevay -5:40:16 - LMT 1883 N 18 18u
+-6 u C%sT 1954 Ap 25 2
+-5 - EST 1969
+-5 u E%sT 1973
+-5 - EST 2006
+-5 u E%sT
+Z America/Indiana/Vincennes -5:50:7 - LMT 1883 N 18 18u
+-6 u C%sT 1946
+-6 V C%sT 1964 Ap 26 2
+-5 - EST 1969
+-5 u E%sT 1971
+-5 - EST 2006 Ap 2 2
+-6 u C%sT 2007 N 4 2
+-5 u E%sT
+Z America/Indiana/Winamac -5:46:25 - LMT 1883 N 18 18u
+-6 u C%sT 1946
+-6 Pu C%sT 1961 Ap 30 2
+-5 - EST 1969
+-5 u E%sT 1971
+-5 - EST 2006 Ap 2 2
+-6 u C%sT 2007 Mar 11 2
+-5 u E%sT
+Z America/Inuvik 0 - -00 1953
+-8 Y P%sT 1979 Ap lastSu 2
+-7 Y M%sT 1980
+-7 C M%sT
+Z America/Iqaluit 0 - -00 1942 Au
+-5 Y E%sT 1999 O 31 2
+-6 C C%sT 2000 O 29 2
+-5 C E%sT
+Z America/Jamaica -5:7:10 - LMT 1890
+-5:7:10 - KMT 1912 F
+-5 - EST 1974
+-5 u E%sT 1984
+-5 - EST
+Z America/Juneau 15:2:19 - LMT 1867 O 19 15:33:32
+-8:57:41 - LMT 1900 Au 20 12
+-8 - PST 1942
+-8 u P%sT 1946
+-8 - PST 1969
+-8 u P%sT 1980 Ap 27 2
+-9 u Y%sT 1980 O 26 2
+-8 u P%sT 1983 O 30 2
+-9 u Y%sT 1983 N 30
+-9 u AK%sT
+Z America/Kentucky/Louisville -5:43:2 - LMT 1883 N 18 18u
+-6 u C%sT 1921
+-6 v C%sT 1942
+-6 u C%sT 1946
+-6 v C%sT 1961 Jul 23 2
+-5 - EST 1968
+-5 u E%sT 1974 Ja 6 2
+-6 1 CDT 1974 O 27 2
+-5 u E%sT
+Z America/Kentucky/Monticello -5:39:24 - LMT 1883 N 18 18u
+-6 u C%sT 1946
+-6 - CST 1968
+-6 u C%sT 2000 O 29 2
+-5 u E%sT
+Z America/La_Paz -4:32:36 - LMT 1890
+-4:32:36 - CMT 1931 O 15
+-4:32:36 1 BST 1932 Mar 21
+-4 - -04
+Z America/Lima -5:8:12 - LMT 1890
+-5:8:36 - LMT 1908 Jul 28
+-5 PE -05/-04
+Z America/Los_Angeles -7:52:58 - LMT 1883 N 18 20u
+-8 u P%sT 1946
+-8 CA P%sT 1967
+-8 u P%sT
+Z America/Maceio -2:22:52 - LMT 1914
+-3 B -03/-02 1990 S 17
+-3 - -03 1995 O 13
+-3 B -03/-02 1996 S 4
+-3 - -03 1999 S 30
+-3 B -03/-02 2000 O 22
+-3 - -03 2001 S 13
+-3 B -03/-02 2002 O
+-3 - -03
+Z America/Managua -5:45:8 - LMT 1890
+-5:45:12 - MMT 1934 Jun 23
+-6 - CST 1973 May
+-5 - EST 1975 F 16
+-6 NI C%sT 1992 Ja 1 4
+-5 - EST 1992 S 24
+-6 - CST 1993
+-5 - EST 1997
+-6 NI C%sT
+Z America/Manaus -4:0:4 - LMT 1914
+-4 B -04/-03 1988 S 12
+-4 - -04 1993 S 28
+-4 B -04/-03 1994 S 22
+-4 - -04
+Z America/Martinique -4:4:20 - LMT 1890
+-4:4:20 - FFMT 1911 May
+-4 - AST 1980 Ap 6
+-4 1 ADT 1980 S 28
+-4 - AST
+Z America/Matamoros -6:30 - LMT 1922 Ja 1 6u
+-6 - CST 1988
+-6 u C%sT 1989
+-6 m C%sT 2010
+-6 u C%sT
+Z America/Mazatlan -7:5:40 - LMT 1922 Ja 1 7u
+-7 - MST 1927 Jun 10 23
+-6 - CST 1930 N 15
+-7 m M%sT 1932 Ap
+-6 - CST 1942 Ap 24
+-7 - MST 1949 Ja 14
+-8 - PST 1970
+-7 m M%sT
+Z America/Menominee -5:50:27 - LMT 1885 S 18 12
+-6 u C%sT 1946
+-6 Me C%sT 1969 Ap 27 2
+-5 - EST 1973 Ap 29 2
+-6 u C%sT
+Z America/Merida -5:58:28 - LMT 1922 Ja 1 6u
+-6 - CST 1981 D 23
+-5 - EST 1982 D 2
+-6 m C%sT
+Z America/Metlakatla 15:13:42 - LMT 1867 O 19 15:44:55
+-8:46:18 - LMT 1900 Au 20 12
+-8 - PST 1942
+-8 u P%sT 1946
+-8 - PST 1969
+-8 u P%sT 1983 O 30 2
+-8 - PST 2015 N 1 2
+-9 u AK%sT 2018 N 4 2
+-8 - PST 2019 Ja 20 2
+-9 u AK%sT
+Z America/Mexico_City -6:36:36 - LMT 1922 Ja 1 7u
+-7 - MST 1927 Jun 10 23
+-6 - CST 1930 N 15
+-7 m M%sT 1932 Ap
+-6 m C%sT 2001 S 30 2
+-6 - CST 2002 F 20
+-6 m C%sT
+Z America/Miquelon -3:44:40 - LMT 1911 Jun 15
+-4 - AST 1980 May
+-3 - -03 1987
+-3 C -03/-02
+Z America/Moncton -4:19:8 - LMT 1883 D 9
+-5 - EST 1902 Jun 15
+-4 C A%sT 1933
+-4 o A%sT 1942
+-4 C A%sT 1946
+-4 o A%sT 1973
+-4 C A%sT 1993
+-4 o A%sT 2007
+-4 C A%sT
+Z America/Monterrey -6:41:16 - LMT 1922 Ja 1 6u
+-6 - CST 1988
+-6 u C%sT 1989
+-6 m C%sT
 Z America/Montevideo -3:44:51 - LMT 1908 Jun 10
 -3:44:51 - MMT 1920 May
 -4 - -04 1923 O
@@ -4002,30 +2747,842 @@ Z America/Montevideo -3:44:51 - LMT 1908 Jun 10
 -3 U -03/-0130 1974 Mar 10
 -3 U -03/-0230 1974 D 22
 -3 U -03/-02
-Z America/Caracas -4:27:44 - LMT 1890
--4:27:40 - CMT 1912 F 12
--4:30 - -0430 1965
--4 - -04 2007 D 9 3
--4:30 - -0430 2016 May 1 2:30
+Z America/New_York -4:56:2 - LMT 1883 N 18 17u
+-5 u E%sT 1920
+-5 NY E%sT 1942
+-5 u E%sT 1946
+-5 NY E%sT 1967
+-5 u E%sT
+Z America/Nome 12:58:22 - LMT 1867 O 19 13:29:35
+-11:1:38 - LMT 1900 Au 20 12
+-11 - NST 1942
+-11 u N%sT 1946
+-11 - NST 1967 Ap
+-11 - BST 1969
+-11 u B%sT 1983 O 30 2
+-9 u Y%sT 1983 N 30
+-9 u AK%sT
+Z America/Noronha -2:9:40 - LMT 1914
+-2 B -02/-01 1990 S 17
+-2 - -02 1999 S 30
+-2 B -02/-01 2000 O 15
+-2 - -02 2001 S 13
+-2 B -02/-01 2002 O
+-2 - -02
+Z America/North_Dakota/Beulah -6:47:7 - LMT 1883 N 18 19u
+-7 u M%sT 2010 N 7 2
+-6 u C%sT
+Z America/North_Dakota/Center -6:45:12 - LMT 1883 N 18 19u
+-7 u M%sT 1992 O 25 2
+-6 u C%sT
+Z America/North_Dakota/New_Salem -6:45:39 - LMT 1883 N 18 19u
+-7 u M%sT 2003 O 26 2
+-6 u C%sT
+Z America/Nuuk -3:26:56 - LMT 1916 Jul 28
+-3 - -03 1980 Ap 6 2
+-3 E -03/-02 2023 Mar 26 1u
+-2 - -02 2023 O 29 1u
+-2 E -02/-01
+Z America/Ojinaga -6:57:40 - LMT 1922 Ja 1 7u
+-7 - MST 1927 Jun 10 23
+-6 - CST 1930 N 15
+-7 m M%sT 1932 Ap
+-6 - CST 1996
+-6 m C%sT 1998
+-6 - CST 1998 Ap Su>=1 3
+-7 m M%sT 2010
+-7 u M%sT 2022 O 30 2
+-6 - CST 2022 N 30
+-6 u C%sT
+Z America/Panama -5:18:8 - LMT 1890
+-5:19:36 - CMT 1908 Ap 22
+-5 - EST
+Z America/Paramaribo -3:40:40 - LMT 1911
+-3:40:52 - PMT 1935
+-3:40:36 - PMT 1945 O
+-3:30 - -0330 1984 O
+-3 - -03
+Z America/Phoenix -7:28:18 - LMT 1883 N 18 19u
+-7 u M%sT 1944 Ja 1 0:1
+-7 - MST 1944 Ap 1 0:1
+-7 u M%sT 1944 O 1 0:1
+-7 - MST 1967
+-7 u M%sT 1968 Mar 21
+-7 - MST
+Z America/Port-au-Prince -4:49:20 - LMT 1890
+-4:49 - PPMT 1917 Ja 24 12
+-5 HT E%sT
+Z America/Porto_Velho -4:15:36 - LMT 1914
+-4 B -04/-03 1988 S 12
 -4 - -04
-Z Etc/UTC 0 - UTC
+Z America/Puerto_Rico -4:24:25 - LMT 1899 Mar 28 12
+-4 - AST 1942 May 3
+-4 u A%sT 1946
+-4 - AST
+Z America/Punta_Arenas -4:43:40 - LMT 1890
+-4:42:45 - SMT 1910 Ja 10
+-5 - -05 1916 Jul
+-4:42:45 - SMT 1918 S 10
+-4 - -04 1919 Jul
+-4:42:45 - SMT 1927 S
+-5 x -05/-04 1932 S
+-4 - -04 1942 Jun
+-5 - -05 1942 Au
+-4 - -04 1946 Au 28 24
+-5 1 -04 1947 Mar 31 24
+-5 - -05 1947 May 21 23
+-4 x -04/-03 2016 D 4
+-3 - -03
+Z America/Rankin_Inlet 0 - -00 1957
+-6 Y C%sT 2000 O 29 2
+-5 - EST 2001 Ap 1 3
+-6 C C%sT
+Z America/Recife -2:19:36 - LMT 1914
+-3 B -03/-02 1990 S 17
+-3 - -03 1999 S 30
+-3 B -03/-02 2000 O 15
+-3 - -03 2001 S 13
+-3 B -03/-02 2002 O
+-3 - -03
+Z America/Regina -6:58:36 - LMT 1905 S
+-7 r M%sT 1960 Ap lastSu 2
+-6 - CST
+Z America/Resolute 0 - -00 1947 Au 31
+-6 Y C%sT 2000 O 29 2
+-5 - EST 2001 Ap 1 3
+-6 C C%sT 2006 O 29 2
+-5 - EST 2007 Mar 11 3
+-6 C C%sT
+Z America/Rio_Branco -4:31:12 - LMT 1914
+-5 B -05/-04 1988 S 12
+-5 - -05 2008 Jun 24
+-4 - -04 2013 N 10
+-5 - -05
+Z America/Santarem -3:38:48 - LMT 1914
+-4 B -04/-03 1988 S 12
+-4 - -04 2008 Jun 24
+-3 - -03
+Z America/Santiago -4:42:45 - LMT 1890
+-4:42:45 - SMT 1910 Ja 10
+-5 - -05 1916 Jul
+-4:42:45 - SMT 1918 S 10
+-4 - -04 1919 Jul
+-4:42:45 - SMT 1927 S
+-5 x -05/-04 1932 S
+-4 - -04 1942 Jun
+-5 - -05 1942 Au
+-4 - -04 1946 Jul 14 24
+-4 1 -03 1946 Au 28 24
+-5 1 -04 1947 Mar 31 24
+-5 - -05 1947 May 21 23
+-4 x -04/-03
+Z America/Santo_Domingo -4:39:36 - LMT 1890
+-4:40 - SDMT 1933 Ap 1 12
+-5 DO %s 1974 O 27
+-4 - AST 2000 O 29 2
+-5 u E%sT 2000 D 3 1
+-4 - AST
+Z America/Sao_Paulo -3:6:28 - LMT 1914
+-3 B -03/-02 1963 O 23
+-3 1 -02 1964
+-3 B -03/-02
+Z America/Scoresbysund -1:27:52 - LMT 1916 Jul 28
+-2 - -02 1980 Ap 6 2
+-2 c -02/-01 1981 Mar 29
+-1 E -01/+00 2024 Mar 31
+-2 E -02/-01
+Z America/Sitka 14:58:47 - LMT 1867 O 19 15:30
+-9:1:13 - LMT 1900 Au 20 12
+-8 - PST 1942
+-8 u P%sT 1946
+-8 - PST 1969
+-8 u P%sT 1983 O 30 2
+-9 u Y%sT 1983 N 30
+-9 u AK%sT
+Z America/St_Johns -3:30:52 - LMT 1884
+-3:30:52 j N%sT 1918
+-3:30:52 C N%sT 1919
+-3:30:52 j N%sT 1935 Mar 30
+-3:30 j N%sT 1942 May 11
+-3:30 C N%sT 1946
+-3:30 j N%sT 2011 N
+-3:30 C N%sT
+Z America/Swift_Current -7:11:20 - LMT 1905 S
+-7 C M%sT 1946 Ap lastSu 2
+-7 r M%sT 1950
+-7 Sw M%sT 1972 Ap lastSu 2
+-6 - CST
+Z America/Tegucigalpa -5:48:52 - LMT 1921 Ap
+-6 HN C%sT
+Z America/Thule -4:35:8 - LMT 1916 Jul 28
+-4 Th A%sT
+Z America/Tijuana -7:48:4 - LMT 1922 Ja 1 7u
+-7 - MST 1924
+-8 - PST 1927 Jun 10 23
+-7 - MST 1930 N 15
+-8 - PST 1931 Ap
+-8 1 PDT 1931 S 30
+-8 - PST 1942 Ap 24
+-8 1 PWT 1945 Au 14 23u
+-8 1 PPT 1945 N 12
+-8 - PST 1948 Ap 5
+-8 1 PDT 1949 Ja 14
+-8 - PST 1954
+-8 CA P%sT 1961
+-8 - PST 1976
+-8 u P%sT 1996
+-8 m P%sT 2001
+-8 u P%sT 2002 F 20
+-8 m P%sT 2010
+-8 u P%sT
+Z America/Toronto -5:17:32 - LMT 1895
+-5 C E%sT 1919
+-5 t E%sT 1942 F 9 2s
+-5 C E%sT 1946
+-5 t E%sT 1974
+-5 C E%sT
+Z America/Vancouver -8:12:28 - LMT 1884
+-8 Va P%sT 1987
+-8 C P%sT
+Z America/Whitehorse -9:0:12 - LMT 1900 Au 20
+-9 Y Y%sT 1965
+-9 Yu Y%sT 1966 F 27
+-8 - PST 1980
+-8 C P%sT 2020 N
+-7 - MST
+Z America/Winnipeg -6:28:36 - LMT 1887 Jul 16
+-6 W C%sT 2006
+-6 C C%sT
+Z America/Yakutat 14:41:5 - LMT 1867 O 19 15:12:18
+-9:18:55 - LMT 1900 Au 20 12
+-9 - YST 1942
+-9 u Y%sT 1946
+-9 - YST 1969
+-9 u Y%sT 1983 N 30
+-9 u AK%sT
+Z Antarctica/Casey 0 - -00 1969
+8 - +08 2009 O 18 2
+11 - +11 2010 Mar 5 2
+8 - +08 2011 O 28 2
+11 - +11 2012 F 21 17u
+8 - +08 2016 O 22
+11 - +11 2018 Mar 11 4
+8 - +08 2018 O 7 4
+11 - +11 2019 Mar 17 3
+8 - +08 2019 O 4 3
+11 - +11 2020 Mar 8 3
+8 - +08 2020 O 4 0:1
+11 - +11 2021 Mar 14
+8 - +08 2021 O 3 0:1
+11 - +11 2022 Mar 13
+8 - +08 2022 O 2 0:1
+11 - +11 2023 Mar 9 3
+8 - +08
+Z Antarctica/Davis 0 - -00 1957 Ja 13
+7 - +07 1964 N
+0 - -00 1969 F
+7 - +07 2009 O 18 2
+5 - +05 2010 Mar 10 20u
+7 - +07 2011 O 28 2
+5 - +05 2012 F 21 20u
+7 - +07
+Z Antarctica/Macquarie 0 - -00 1899 N
+10 - AEST 1916 O 1 2
+10 1 AEDT 1917 F
+10 AU AE%sT 1919 Ap 1 0s
+0 - -00 1948 Mar 25
+10 AU AE%sT 1967
+10 AT AE%sT 2010
+10 1 AEDT 2011
+10 AT AE%sT
+Z Antarctica/Mawson 0 - -00 1954 F 13
+6 - +06 2009 O 18 2
+5 - +05
+Z Antarctica/Palmer 0 - -00 1965
+-4 A -04/-03 1969 O 5
+-3 A -03/-02 1982 May
+-4 x -04/-03 2016 D 4
+-3 - -03
+Z Antarctica/Rothera 0 - -00 1976 D
+-3 - -03
+Z Antarctica/Troll 0 - -00 2005 F 12
+0 Tr %s
+Z Antarctica/Vostok 0 - -00 1957 D 16
+7 - +07 1994 F
+0 - -00 1994 N
+7 - +07 2023 D 18 2
+5 - +05
+Z Asia/Almaty 5:7:48 - LMT 1924 May 2
+5 - +05 1930 Jun 21
+6 R +06/+07 1991 Mar 31 2s
+5 R +05/+06 1992 Ja 19 2s
+6 R +06/+07 2004 O 31 2s
+6 - +06 2024 Mar
+5 - +05
+Z Asia/Amman 2:23:44 - LMT 1931
+2 J EE%sT 2022 O 28 0s
+3 - +03
+Z Asia/Anadyr 11:49:56 - LMT 1924 May 2
+12 - +12 1930 Jun 21
+13 R +13/+14 1982 Ap 1 0s
+12 R +12/+13 1991 Mar 31 2s
+11 R +11/+12 1992 Ja 19 2s
+12 R +12/+13 2010 Mar 28 2s
+11 R +11/+12 2011 Mar 27 2s
+12 - +12
+Z Asia/Aqtau 3:21:4 - LMT 1924 May 2
+4 - +04 1930 Jun 21
+5 - +05 1981 O
+6 - +06 1982 Ap
+5 R +05/+06 1991 Mar 31 2s
+4 R +04/+05 1992 Ja 19 2s
+5 R +05/+06 1994 S 25 2s
+4 R +04/+05 2004 O 31 2s
+5 - +05
+Z Asia/Aqtobe 3:48:40 - LMT 1924 May 2
+4 - +04 1930 Jun 21
+5 - +05 1981 Ap
+5 1 +06 1981 O
+6 - +06 1982 Ap
+5 R +05/+06 1991 Mar 31 2s
+4 R +04/+05 1992 Ja 19 2s
+5 R +05/+06 2004 O 31 2s
+5 - +05
+Z Asia/Ashgabat 3:53:32 - LMT 1924 May 2
+4 - +04 1930 Jun 21
+5 R +05/+06 1991 Mar 31 2
+4 R +04/+05 1992 Ja 19 2
+5 - +05
+Z Asia/Atyrau 3:27:44 - LMT 1924 May 2
+3 - +03 1930 Jun 21
+5 - +05 1981 O
+6 - +06 1982 Ap
+5 R +05/+06 1991 Mar 31 2s
+4 R +04/+05 1992 Ja 19 2s
+5 R +05/+06 1999 Mar 28 2s
+4 R +04/+05 2004 O 31 2s
+5 - +05
+Z Asia/Baghdad 2:57:40 - LMT 1890
+2:57:36 - BMT 1918
+3 - +03 1982 May
+3 IQ +03/+04
+Z Asia/Baku 3:19:24 - LMT 1924 May 2
+3 - +03 1957 Mar
+4 R +04/+05 1991 Mar 31 2s
+3 R +03/+04 1992 S lastSu 2s
+4 - +04 1996
+4 E +04/+05 1997
+4 AZ +04/+05
+Z Asia/Bangkok 6:42:4 - LMT 1880
+6:42:4 - BMT 1920 Ap
+7 - +07
+Z Asia/Barnaul 5:35 - LMT 1919 D 10
+6 - +06 1930 Jun 21
+7 R +07/+08 1991 Mar 31 2s
+6 R +06/+07 1992 Ja 19 2s
+7 R +07/+08 1995 May 28
+6 R +06/+07 2011 Mar 27 2s
+7 - +07 2014 O 26 2s
+6 - +06 2016 Mar 27 2s
+7 - +07
+Z Asia/Beirut 2:22 - LMT 1880
+2 l EE%sT
+Z Asia/Bishkek 4:58:24 - LMT 1924 May 2
+5 - +05 1930 Jun 21
+6 R +06/+07 1991 Mar 31 2s
+5 R +05/+06 1991 Au 31 2
+5 KG +05/+06 2005 Au 12
+6 - +06
+Z Asia/Chita 7:33:52 - LMT 1919 D 15
+8 - +08 1930 Jun 21
+9 R +09/+10 1991 Mar 31 2s
+8 R +08/+09 1992 Ja 19 2s
+9 R +09/+10 2011 Mar 27 2s
+10 - +10 2014 O 26 2s
+8 - +08 2016 Mar 27 2
+9 - +09
+Z Asia/Choibalsan 7:38 - LMT 1905 Au
+7 - +07 1978
+8 - +08 1983 Ap
+9 X +09/+10 2008 Mar 31
+8 X +08/+09
+Z Asia/Colombo 5:19:24 - LMT 1880
+5:19:32 - MMT 1906
+5:30 - +0530 1942 Ja 5
+5:30 0:30 +06 1942 S
+5:30 1 +0630 1945 O 16 2
+5:30 - +0530 1996 May 25
+6:30 - +0630 1996 O 26 0:30
+6 - +06 2006 Ap 15 0:30
+5:30 - +0530
+Z Asia/Damascus 2:25:12 - LMT 1920
+2 S EE%sT 2022 O 28
+3 - +03
+Z Asia/Dhaka 6:1:40 - LMT 1890
+5:53:20 - HMT 1941 O
+6:30 - +0630 1942 May 15
+5:30 - +0530 1942 S
+6:30 - +0630 1951 S 30
+6 - +06 2009
+6 BD +06/+07
+Z Asia/Dili 8:22:20 - LMT 1912
+8 - +08 1942 F 21 23
+9 - +09 1976 May 3
+8 - +08 2000 S 17
+9 - +09
+Z Asia/Dubai 3:41:12 - LMT 1920
+4 - +04
+Z Asia/Dushanbe 4:35:12 - LMT 1924 May 2
+5 - +05 1930 Jun 21
+6 R +06/+07 1991 Mar 31 2s
+5 1 +06 1991 S 9 2s
+5 - +05
+Z Asia/Famagusta 2:15:48 - LMT 1921 N 14
+2 CY EE%sT 1998 S
+2 E EE%sT 2016 S 8
+3 - +03 2017 O 29 1u
+2 E EE%sT
+Z Asia/Gaza 2:17:52 - LMT 1900 O
+2 Z EET/EEST 1948 May 15
+2 K EE%sT 1967 Jun 5
+2 Z I%sT 1996
+2 J EE%sT 1999
+2 P EE%sT 2008 Au 29
+2 - EET 2008 S
+2 P EE%sT 2010
+2 - EET 2010 Mar 27 0:1
+2 P EE%sT 2011 Au
+2 - EET 2012
+2 P EE%sT
+Z Asia/Hebron 2:20:23 - LMT 1900 O
+2 Z EET/EEST 1948 May 15
+2 K EE%sT 1967 Jun 5
+2 Z I%sT 1996
+2 J EE%sT 1999
+2 P EE%sT
+Z Asia/Ho_Chi_Minh 7:6:30 - LMT 1906 Jul
+7:6:30 - PLMT 1911 May
+7 - +07 1942 D 31 23
+8 - +08 1945 Mar 14 23
+9 - +09 1945 S 1 24
+7 - +07 1947 Ap
+8 - +08 1955 Jul 1 1
+7 - +07 1959 D 31 23
+8 - +08 1975 Jun 13
+7 - +07
+Z Asia/Hong_Kong 7:36:42 - LMT 1904 O 29 17u
+8 - HKT 1941 Jun 15 3
+8 1 HKST 1941 O 1 4
+8 0:30 HKWT 1941 D 25
+9 - JST 1945 N 18 2
+8 HK HK%sT
+Z Asia/Hovd 6:6:36 - LMT 1905 Au
+6 - +06 1978
+7 X +07/+08
+Z Asia/Irkutsk 6:57:5 - LMT 1880
+6:57:5 - IMT 1920 Ja 25
+7 - +07 1930 Jun 21
+8 R +08/+09 1991 Mar 31 2s
+7 R +07/+08 1992 Ja 19 2s
+8 R +08/+09 2011 Mar 27 2s
+9 - +09 2014 O 26 2s
+8 - +08
+Z Asia/Jakarta 7:7:12 - LMT 1867 Au 10
+7:7:12 - BMT 1923 D 31 16:40u
+7:20 - +0720 1932 N
+7:30 - +0730 1942 Mar 23
+9 - +09 1945 S 23
+7:30 - +0730 1948 May
+8 - +08 1950 May
+7:30 - +0730 1964
+7 - WIB
+Z Asia/Jayapura 9:22:48 - LMT 1932 N
+9 - +09 1944 S
+9:30 - +0930 1964
+9 - WIT
+Z Asia/Jerusalem 2:20:54 - LMT 1880
+2:20:40 - JMT 1918
+2 Z I%sT
+Z Asia/Kabul 4:36:48 - LMT 1890
+4 - +04 1945
+4:30 - +0430
+Z Asia/Kamchatka 10:34:36 - LMT 1922 N 10
+11 - +11 1930 Jun 21
+12 R +12/+13 1991 Mar 31 2s
+11 R +11/+12 1992 Ja 19 2s
+12 R +12/+13 2010 Mar 28 2s
+11 R +11/+12 2011 Mar 27 2s
+12 - +12
+Z Asia/Karachi 4:28:12 - LMT 1907
+5:30 - +0530 1942 S
+5:30 1 +0630 1945 O 15
+5:30 - +0530 1951 S 30
+5 - +05 1971 Mar 26
+5 PK PK%sT
+Z Asia/Kathmandu 5:41:16 - LMT 1920
+5:30 - +0530 1986
+5:45 - +0545
+Z Asia/Khandyga 9:2:13 - LMT 1919 D 15
+8 - +08 1930 Jun 21
+9 R +09/+10 1991 Mar 31 2s
+8 R +08/+09 1992 Ja 19 2s
+9 R +09/+10 2004
+10 R +10/+11 2011 Mar 27 2s
+11 - +11 2011 S 13 0s
+10 - +10 2014 O 26 2s
+9 - +09
+Z Asia/Kolkata 5:53:28 - LMT 1854 Jun 28
+5:53:20 - HMT 1870
+5:21:10 - MMT 1906
+5:30 - IST 1941 O
+5:30 1 +0630 1942 May 15
+5:30 - IST 1942 S
+5:30 1 +0630 1945 O 15
+5:30 - IST
+Z Asia/Krasnoyarsk 6:11:26 - LMT 1920 Ja 6
+6 - +06 1930 Jun 21
+7 R +07/+08 1991 Mar 31 2s
+6 R +06/+07 1992 Ja 19 2s
+7 R +07/+08 2011 Mar 27 2s
+8 - +08 2014 O 26 2s
+7 - +07
+Z Asia/Kuching 7:21:20 - LMT 1926 Mar
+7:30 - +0730 1933
+8 NB +08/+0820 1942 F 16
+9 - +09 1945 S 12
+8 - +08
+Z Asia/Macau 7:34:10 - LMT 1904 O 30
+8 - CST 1941 D 21 23
+9 _ +09/+10 1945 S 30 24
+8 _ C%sT
+Z Asia/Magadan 10:3:12 - LMT 1924 May 2
+10 - +10 1930 Jun 21
+11 R +11/+12 1991 Mar 31 2s
+10 R +10/+11 1992 Ja 19 2s
+11 R +11/+12 2011 Mar 27 2s
+12 - +12 2014 O 26 2s
+10 - +10 2016 Ap 24 2s
+11 - +11
+Z Asia/Makassar 7:57:36 - LMT 1920
+7:57:36 - MMT 1932 N
+8 - +08 1942 F 9
+9 - +09 1945 S 23
+8 - WITA
+Z Asia/Manila -15:56 - LMT 1844 D 31
+8:4 - LMT 1899 May 11
+8 PH P%sT 1942 May
+9 - JST 1944 N
+8 PH P%sT
+Z Asia/Nicosia 2:13:28 - LMT 1921 N 14
+2 CY EE%sT 1998 S
+2 E EE%sT
+Z Asia/Novokuznetsk 5:48:48 - LMT 1924 May
+6 - +06 1930 Jun 21
+7 R +07/+08 1991 Mar 31 2s
+6 R +06/+07 1992 Ja 19 2s
+7 R +07/+08 2010 Mar 28 2s
+6 R +06/+07 2011 Mar 27 2s
+7 - +07
+Z Asia/Novosibirsk 5:31:40 - LMT 1919 D 14 6
+6 - +06 1930 Jun 21
+7 R +07/+08 1991 Mar 31 2s
+6 R +06/+07 1992 Ja 19 2s
+7 R +07/+08 1993 May 23
+6 R +06/+07 2011 Mar 27 2s
+7 - +07 2014 O 26 2s
+6 - +06 2016 Jul 24 2s
+7 - +07
+Z Asia/Omsk 4:53:30 - LMT 1919 N 14
+5 - +05 1930 Jun 21
+6 R +06/+07 1991 Mar 31 2s
+5 R +05/+06 1992 Ja 19 2s
+6 R +06/+07 2011 Mar 27 2s
+7 - +07 2014 O 26 2s
+6 - +06
+Z Asia/Oral 3:25:24 - LMT 1924 May 2
+3 - +03 1930 Jun 21
+5 - +05 1981 Ap
+5 1 +06 1981 O
+6 - +06 1982 Ap
+5 R +05/+06 1989 Mar 26 2s
+4 R +04/+05 1992 Ja 19 2s
+5 R +05/+06 1992 Mar 29 2s
+4 R +04/+05 2004 O 31 2s
+5 - +05
+Z Asia/Pontianak 7:17:20 - LMT 1908 May
+7:17:20 - PMT 1932 N
+7:30 - +0730 1942 Ja 29
+9 - +09 1945 S 23
+7:30 - +0730 1948 May
+8 - +08 1950 May
+7:30 - +0730 1964
+8 - WITA 1988
+7 - WIB
+Z Asia/Pyongyang 8:23 - LMT 1908 Ap
+8:30 - KST 1912
+9 - JST 1945 Au 24
+9 - KST 2015 Au 15
+8:30 - KST 2018 May 4 23:30
+9 - KST
+Z Asia/Qatar 3:26:8 - LMT 1920
+4 - +04 1972 Jun
+3 - +03
+Z Asia/Qostanay 4:14:28 - LMT 1924 May 2
+4 - +04 1930 Jun 21
+5 - +05 1981 Ap
+5 1 +06 1981 O
+6 - +06 1982 Ap
+5 R +05/+06 1991 Mar 31 2s
+4 R +04/+05 1992 Ja 19 2s
+5 R +05/+06 2004 O 31 2s
+6 - +06 2024 Mar
+5 - +05
+Z Asia/Qyzylorda 4:21:52 - LMT 1924 May 2
+4 - +04 1930 Jun 21
+5 - +05 1981 Ap
+5 1 +06 1981 O
+6 - +06 1982 Ap
+5 R +05/+06 1991 Mar 31 2s
+4 R +04/+05 1991 S 29 2s
+5 R +05/+06 1992 Ja 19 2s
+6 R +06/+07 1992 Mar 29 2s
+5 R +05/+06 2004 O 31 2s
+6 - +06 2018 D 21
+5 - +05
+Z Asia/Riyadh 3:6:52 - LMT 1947 Mar 14
+3 - +03
+Z Asia/Sakhalin 9:30:48 - LMT 1905 Au 23
+9 - +09 1945 Au 25
+11 R +11/+12 1991 Mar 31 2s
+10 R +10/+11 1992 Ja 19 2s
+11 R +11/+12 1997 Mar lastSu 2s
+10 R +10/+11 2011 Mar 27 2s
+11 - +11 2014 O 26 2s
+10 - +10 2016 Mar 27 2s
+11 - +11
+Z Asia/Samarkand 4:27:53 - LMT 1924 May 2
+4 - +04 1930 Jun 21
+5 - +05 1981 Ap
+5 1 +06 1981 O
+6 - +06 1982 Ap
+5 R +05/+06 1992
+5 - +05
+Z Asia/Seoul 8:27:52 - LMT 1908 Ap
+8:30 - KST 1912
+9 - JST 1945 S 8
+9 KR K%sT 1954 Mar 21
+8:30 KR K%sT 1961 Au 10
+9 KR K%sT
+Z Asia/Shanghai 8:5:43 - LMT 1901
+8 Sh C%sT 1949 May 28
+8 CN C%sT
+Z Asia/Singapore 6:55:25 - LMT 1901
+6:55:25 - SMT 1905 Jun
+7 - +07 1933
+7 0:20 +0720 1936
+7:20 - +0720 1941 S
+7:30 - +0730 1942 F 16
+9 - +09 1945 S 12
+7:30 - +0730 1981 D 31 16u
+8 - +08
+Z Asia/Srednekolymsk 10:14:52 - LMT 1924 May 2
+10 - +10 1930 Jun 21
+11 R +11/+12 1991 Mar 31 2s
+10 R +10/+11 1992 Ja 19 2s
+11 R +11/+12 2011 Mar 27 2s
+12 - +12 2014 O 26 2s
+11 - +11
+Z Asia/Taipei 8:6 - LMT 1896
+8 - CST 1937 O
+9 - JST 1945 S 21 1
+8 f C%sT
+Z Asia/Tashkent 4:37:11 - LMT 1924 May 2
+5 - +05 1930 Jun 21
+6 R +06/+07 1991 Mar 31 2
+5 R +05/+06 1992
+5 - +05
+Z Asia/Tbilisi 2:59:11 - LMT 1880
+2:59:11 - TBMT 1924 May 2
+3 - +03 1957 Mar
+4 R +04/+05 1991 Mar 31 2s
+3 R +03/+04 1992
+3 e +03/+04 1994 S lastSu
+4 e +04/+05 1996 O lastSu
+4 1 +05 1997 Mar lastSu
+4 e +04/+05 2004 Jun 27
+3 R +03/+04 2005 Mar lastSu 2
+4 - +04
+Z Asia/Tehran 3:25:44 - LMT 1916
+3:25:44 - TMT 1935 Jun 13
+3:30 i +0330/+0430 1977 O 20 24
+4 i +04/+05 1979
+3:30 i +0330/+0430
+Z Asia/Thimphu 5:58:36 - LMT 1947 Au 15
+5:30 - +0530 1987 O
+6 - +06
+Z Asia/Tokyo 9:18:59 - LMT 1887 D 31 15u
+9 JP J%sT
+Z Asia/Tomsk 5:39:51 - LMT 1919 D 22
+6 - +06 1930 Jun 21
+7 R +07/+08 1991 Mar 31 2s
+6 R +06/+07 1992 Ja 19 2s
+7 R +07/+08 2002 May 1 3
+6 R +06/+07 2011 Mar 27 2s
+7 - +07 2014 O 26 2s
+6 - +06 2016 May 29 2s
+7 - +07
+Z Asia/Ulaanbaatar 7:7:32 - LMT 1905 Au
+7 - +07 1978
+8 X +08/+09
+Z Asia/Urumqi 5:50:20 - LMT 1928
+6 - +06
+Z Asia/Ust-Nera 9:32:54 - LMT 1919 D 15
+8 - +08 1930 Jun 21
+9 R +09/+10 1981 Ap
+11 R +11/+12 1991 Mar 31 2s
+10 R +10/+11 1992 Ja 19 2s
+11 R +11/+12 2011 Mar 27 2s
+12 - +12 2011 S 13 0s
+11 - +11 2014 O 26 2s
+10 - +10
+Z Asia/Vladivostok 8:47:31 - LMT 1922 N 15
+9 - +09 1930 Jun 21
+10 R +10/+11 1991 Mar 31 2s
+9 R +09/+10 1992 Ja 19 2s
+10 R +10/+11 2011 Mar 27 2s
+11 - +11 2014 O 26 2s
+10 - +10
+Z Asia/Yakutsk 8:38:58 - LMT 1919 D 15
+8 - +08 1930 Jun 21
+9 R +09/+10 1991 Mar 31 2s
+8 R +08/+09 1992 Ja 19 2s
+9 R +09/+10 2011 Mar 27 2s
+10 - +10 2014 O 26 2s
+9 - +09
+Z Asia/Yangon 6:24:47 - LMT 1880
+6:24:47 - RMT 1920
+6:30 - +0630 1942 May
+9 - +09 1945 May 3
+6:30 - +0630
+Z Asia/Yekaterinburg 4:2:33 - LMT 1916 Jul 3
+3:45:5 - PMT 1919 Jul 15 4
+4 - +04 1930 Jun 21
+5 R +05/+06 1991 Mar 31 2s
+4 R +04/+05 1992 Ja 19 2s
+5 R +05/+06 2011 Mar 27 2s
+6 - +06 2014 O 26 2s
+5 - +05
+Z Asia/Yerevan 2:58 - LMT 1924 May 2
+3 - +03 1957 Mar
+4 R +04/+05 1991 Mar 31 2s
+3 R +03/+04 1995 S 24 2s
+4 - +04 1997
+4 R +04/+05 2011
+4 AM +04/+05
+Z Atlantic/Azores -1:42:40 - LMT 1884
+-1:54:32 - HMT 1912 Ja 1 2u
+-2 p -02/-01 1942 Ap 25 22s
+-2 p +00 1942 Au 15 22s
+-2 p -02/-01 1943 Ap 17 22s
+-2 p +00 1943 Au 28 22s
+-2 p -02/-01 1944 Ap 22 22s
+-2 p +00 1944 Au 26 22s
+-2 p -02/-01 1945 Ap 21 22s
+-2 p +00 1945 Au 25 22s
+-2 p -02/-01 1966 Ap 3 2
+-1 p -01/+00 1983 S 25 1s
+-1 W- -01/+00 1992 S 27 1s
+0 E WE%sT 1993 Mar 28 1u
+-1 E -01/+00
+Z Atlantic/Bermuda -4:19:18 - LMT 1890
+-4:19:18 Be BMT/BST 1930 Ja 1 2
+-4 Be A%sT 1974 Ap 28 2
+-4 C A%sT 1976
+-4 u A%sT
+Z Atlantic/Canary -1:1:36 - LMT 1922 Mar
+-1 - -01 1946 S 30 1
+0 - WET 1980 Ap 6 0s
+0 1 WEST 1980 S 28 1u
+0 E WE%sT
+Z Atlantic/Cape_Verde -1:34:4 - LMT 1912 Ja 1 2u
+-2 - -02 1942 S
+-2 1 -01 1945 O 15
+-2 - -02 1975 N 25 2
+-1 - -01
+Z Atlantic/Faroe -0:27:4 - LMT 1908 Ja 11
+0 - WET 1981
+0 E WE%sT
+Z Atlantic/Madeira -1:7:36 - LMT 1884
+-1:7:36 - FMT 1912 Ja 1 1u
+-1 p -01/+00 1942 Ap 25 22s
+-1 p +01 1942 Au 15 22s
+-1 p -01/+00 1943 Ap 17 22s
+-1 p +01 1943 Au 28 22s
+-1 p -01/+00 1944 Ap 22 22s
+-1 p +01 1944 Au 26 22s
+-1 p -01/+00 1945 Ap 21 22s
+-1 p +01 1945 Au 25 22s
+-1 p -01/+00 1966 Ap 3 2
+0 p WE%sT 1983 S 25 1s
+0 E WE%sT
+Z Atlantic/South_Georgia -2:26:8 - LMT 1890
+-2 - -02
+Z Atlantic/Stanley -3:51:24 - LMT 1890
+-3:51:24 - SMT 1912 Mar 12
+-4 FK -04/-03 1983 May
+-3 FK -03/-02 1985 S 15
+-4 FK -04/-03 2010 S 5 2
+-3 - -03
+Z Australia/Adelaide 9:14:20 - LMT 1895 F
+9 - ACST 1899 May
+9:30 AU AC%sT 1971
+9:30 AS AC%sT
+Z Australia/Brisbane 10:12:8 - LMT 1895
+10 AU AE%sT 1971
+10 AQ AE%sT
+Z Australia/Broken_Hill 9:25:48 - LMT 1895 F
+10 - AEST 1896 Au 23
+9 - ACST 1899 May
+9:30 AU AC%sT 1971
+9:30 AN AC%sT 2000
+9:30 AS AC%sT
+Z Australia/Darwin 8:43:20 - LMT 1895 F
+9 - ACST 1899 May
+9:30 AU AC%sT
+Z Australia/Eucla 8:35:28 - LMT 1895 D
+8:45 AU +0845/+0945 1943 Jul
+8:45 AW +0845/+0945
+Z Australia/Hobart 9:49:16 - LMT 1895 S
+10 AT AE%sT 1919 O 24
+10 AU AE%sT 1967
+10 AT AE%sT
+Z Australia/Lindeman 9:55:56 - LMT 1895
+10 AU AE%sT 1971
+10 AQ AE%sT 1992 Jul
+10 Ho AE%sT
+Z Australia/Lord_Howe 10:36:20 - LMT 1895 F
+10 - AEST 1981 Mar
+10:30 LH +1030/+1130 1985 Jul
+10:30 LH +1030/+11
+Z Australia/Melbourne 9:39:52 - LMT 1895 F
+10 AU AE%sT 1971
+10 AV AE%sT
+Z Australia/Perth 7:43:24 - LMT 1895 D
+8 AU AW%sT 1943 Jul
+8 AW AW%sT
+Z Australia/Sydney 10:4:52 - LMT 1895 F
+10 AU AE%sT 1971
+10 AN AE%sT
+Z CET 1 c CE%sT
+Z CST6CDT -6 u C%sT
+Z EET 2 E EE%sT
+Z EST -5 - EST
+Z EST5EDT -5 u E%sT
 Z Etc/GMT 0 - GMT
-L Etc/GMT GMT
-Z Etc/GMT-14 14 - +14
-Z Etc/GMT-13 13 - +13
-Z Etc/GMT-12 12 - +12
-Z Etc/GMT-11 11 - +11
-Z Etc/GMT-10 10 - +10
-Z Etc/GMT-9 9 - +09
-Z Etc/GMT-8 8 - +08
-Z Etc/GMT-7 7 - +07
-Z Etc/GMT-6 6 - +06
-Z Etc/GMT-5 5 - +05
-Z Etc/GMT-4 4 - +04
-Z Etc/GMT-3 3 - +03
-Z Etc/GMT-2 2 - +02
-Z Etc/GMT-1 1 - +01
 Z Etc/GMT+1 -1 - -01
+Z Etc/GMT+10 -10 - -10
+Z Etc/GMT+11 -11 - -11
+Z Etc/GMT+12 -12 - -12
 Z Etc/GMT+2 -2 - -02
 Z Etc/GMT+3 -3 - -03
 Z Etc/GMT+4 -4 - -04
@@ -4034,10 +3591,463 @@ Z Etc/GMT+6 -6 - -06
 Z Etc/GMT+7 -7 - -07
 Z Etc/GMT+8 -8 - -08
 Z Etc/GMT+9 -9 - -09
-Z Etc/GMT+10 -10 - -10
-Z Etc/GMT+11 -11 - -11
-Z Etc/GMT+12 -12 - -12
+Z Etc/GMT-1 1 - +01
+Z Etc/GMT-10 10 - +10
+Z Etc/GMT-11 11 - +11
+Z Etc/GMT-12 12 - +12
+Z Etc/GMT-13 13 - +13
+Z Etc/GMT-14 14 - +14
+Z Etc/GMT-2 2 - +02
+Z Etc/GMT-3 3 - +03
+Z Etc/GMT-4 4 - +04
+Z Etc/GMT-5 5 - +05
+Z Etc/GMT-6 6 - +06
+Z Etc/GMT-7 7 - +07
+Z Etc/GMT-8 8 - +08
+Z Etc/GMT-9 9 - +09
+Z Etc/UTC 0 - UTC
+Z Europe/Andorra 0:6:4 - LMT 1901
+0 - WET 1946 S 30
+1 - CET 1985 Mar 31 2
+1 E CE%sT
+Z Europe/Astrakhan 3:12:12 - LMT 1924 May
+3 - +03 1930 Jun 21
+4 R +04/+05 1989 Mar 26 2s
+3 R +03/+04 1991 Mar 31 2s
+4 - +04 1992 Mar 29 2s
+3 R +03/+04 2011 Mar 27 2s
+4 - +04 2014 O 26 2s
+3 - +03 2016 Mar 27 2s
+4 - +04
+Z Europe/Athens 1:34:52 - LMT 1895 S 14
+1:34:52 - AMT 1916 Jul 28 0:1
+2 g EE%sT 1941 Ap 30
+1 g CE%sT 1944 Ap 4
+2 g EE%sT 1981
+2 E EE%sT
+Z Europe/Belgrade 1:22 - LMT 1884
+1 - CET 1941 Ap 18 23
+1 c CE%sT 1945
+1 - CET 1945 May 8 2s
+1 1 CEST 1945 S 16 2s
+1 - CET 1982 N 27
+1 E CE%sT
+Z Europe/Berlin 0:53:28 - LMT 1893 Ap
+1 c CE%sT 1945 May 24 2
+1 So CE%sT 1946
+1 DE CE%sT 1980
+1 E CE%sT
+Z Europe/Brussels 0:17:30 - LMT 1880
+0:17:30 - BMT 1892 May 1 0:17:30
+0 - WET 1914 N 8
+1 - CET 1916 May
+1 c CE%sT 1918 N 11 11u
+0 b WE%sT 1940 May 20 2s
+1 c CE%sT 1944 S 3
+1 b CE%sT 1977
+1 E CE%sT
+Z Europe/Bucharest 1:44:24 - LMT 1891 O
+1:44:24 - BMT 1931 Jul 24
+2 z EE%sT 1981 Mar 29 2s
+2 c EE%sT 1991
+2 z EE%sT 1994
+2 e EE%sT 1997
+2 E EE%sT
+Z Europe/Budapest 1:16:20 - LMT 1890 N
+1 c CE%sT 1918
+1 h CE%sT 1941 Ap 7 23
+1 c CE%sT 1945
+1 h CE%sT 1984
+1 E CE%sT
+Z Europe/Chisinau 1:55:20 - LMT 1880
+1:55 - CMT 1918 F 15
+1:44:24 - BMT 1931 Jul 24
+2 z EE%sT 1940 Au 15
+2 1 EEST 1941 Jul 17
+1 c CE%sT 1944 Au 24
+3 R MSK/MSD 1990 May 6 2
+2 R EE%sT 1992
+2 e EE%sT 1997
+2 MD EE%sT
+Z Europe/Dublin -0:25:21 - LMT 1880 Au 2
+-0:25:21 - DMT 1916 May 21 2s
+-0:25:21 1 IST 1916 O 1 2s
+0 G %s 1921 D 6
+0 G GMT/IST 1940 F 25 2s
+0 1 IST 1946 O 6 2s
+0 - GMT 1947 Mar 16 2s
+0 1 IST 1947 N 2 2s
+0 - GMT 1948 Ap 18 2s
+0 G GMT/IST 1968 O 27
+1 IE IST/GMT
+Z Europe/Gibraltar -0:21:24 - LMT 1880 Au 2
+0 G %s 1957 Ap 14 2
+1 - CET 1982
+1 E CE%sT
+Z Europe/Helsinki 1:39:49 - LMT 1878 May 31
+1:39:49 - HMT 1921 May
+2 FI EE%sT 1983
+2 E EE%sT
+Z Europe/Istanbul 1:55:52 - LMT 1880
+1:56:56 - IMT 1910 O
+2 T EE%sT 1978 Jun 29
+3 T +03/+04 1984 N 1 2
+2 T EE%sT 2007
+2 E EE%sT 2011 Mar 27 1u
+2 - EET 2011 Mar 28 1u
+2 E EE%sT 2014 Mar 30 1u
+2 - EET 2014 Mar 31 1u
+2 E EE%sT 2015 O 25 1u
+2 1 EEST 2015 N 8 1u
+2 E EE%sT 2016 S 7
+3 - +03
+Z Europe/Kaliningrad 1:22 - LMT 1893 Ap
+1 c CE%sT 1945 Ap 10
+2 O EE%sT 1946 Ap 7
+3 R MSK/MSD 1989 Mar 26 2s
+2 R EE%sT 2011 Mar 27 2s
+3 - +03 2014 O 26 2s
+2 - EET
+Z Europe/Kirov 3:18:48 - LMT 1919 Jul 1 0u
+3 - +03 1930 Jun 21
+4 R +04/+05 1989 Mar 26 2s
+3 R MSK/MSD 1991 Mar 31 2s
+4 - +04 1992 Mar 29 2s
+3 R MSK/MSD 2011 Mar 27 2s
+4 - MSK 2014 O 26 2s
+3 - MSK
+Z Europe/Kyiv 2:2:4 - LMT 1880
+2:2:4 - KMT 1924 May 2
+2 - EET 1930 Jun 21
+3 - MSK 1941 S 20
+1 c CE%sT 1943 N 6
+3 R MSK/MSD 1990 Jul 1 2
+2 1 EEST 1991 S 29 3
+2 c EE%sT 1996 May 13
+2 E EE%sT
+Z Europe/Lisbon -0:36:45 - LMT 1884
+-0:36:45 - LMT 1912 Ja 1 0u
+0 p WE%sT 1966 Ap 3 2
+1 - CET 1976 S 26 1
+0 p WE%sT 1983 S 25 1s
+0 W- WE%sT 1992 S 27 1s
+1 E CE%sT 1996 Mar 31 1u
+0 E WE%sT
+Z Europe/London -0:1:15 - LMT 1847 D
+0 G %s 1968 O 27
+1 - BST 1971 O 31 2u
+0 G %s 1996
+0 E GMT/BST
+Z Europe/Madrid -0:14:44 - LMT 1901 Ja 1 0u
+0 s WE%sT 1940 Mar 16 23
+1 s CE%sT 1979
+1 E CE%sT
+Z Europe/Malta 0:58:4 - LMT 1893 N 2
+1 I CE%sT 1973 Mar 31
+1 MT CE%sT 1981
+1 E CE%sT
+Z Europe/Minsk 1:50:16 - LMT 1880
+1:50 - MMT 1924 May 2
+2 - EET 1930 Jun 21
+3 - MSK 1941 Jun 28
+1 c CE%sT 1944 Jul 3
+3 R MSK/MSD 1990
+3 - MSK 1991 Mar 31 2s
+2 R EE%sT 2011 Mar 27 2s
+3 - +03
+Z Europe/Moscow 2:30:17 - LMT 1880
+2:30:17 - MMT 1916 Jul 3
+2:31:19 R %s 1919 Jul 1 0u
+3 R %s 1921 O
+3 R MSK/MSD 1922 O
+2 - EET 1930 Jun 21
+3 R MSK/MSD 1991 Mar 31 2s
+2 R EE%sT 1992 Ja 19 2s
+3 R MSK/MSD 2011 Mar 27 2s
+4 - MSK 2014 O 26 2s
+3 - MSK
+Z Europe/Paris 0:9:21 - LMT 1891 Mar 16
+0:9:21 - PMT 1911 Mar 11
+0 F WE%sT 1940 Jun 14 23
+1 c CE%sT 1944 Au 25
+0 F WE%sT 1945 S 16 3
+1 F CE%sT 1977
+1 E CE%sT
+Z Europe/Prague 0:57:44 - LMT 1850
+0:57:44 - PMT 1891 O
+1 c CE%sT 1945 May 9
+1 CZ CE%sT 1946 D 1 3
+1 -1 GMT 1947 F 23 2
+1 CZ CE%sT 1979
+1 E CE%sT
+Z Europe/Riga 1:36:34 - LMT 1880
+1:36:34 - RMT 1918 Ap 15 2
+1:36:34 1 LST 1918 S 16 3
+1:36:34 - RMT 1919 Ap 1 2
+1:36:34 1 LST 1919 May 22 3
+1:36:34 - RMT 1926 May 11
+2 - EET 1940 Au 5
+3 - MSK 1941 Jul
+1 c CE%sT 1944 O 13
+3 R MSK/MSD 1989 Mar lastSu 2s
+2 1 EEST 1989 S lastSu 2s
+2 LV EE%sT 1997 Ja 21
+2 E EE%sT 2000 F 29
+2 - EET 2001 Ja 2
+2 E EE%sT
+Z Europe/Rome 0:49:56 - LMT 1866 D 12
+0:49:56 - RMT 1893 O 31 23u
+1 I CE%sT 1943 S 10
+1 c CE%sT 1944 Jun 4
+1 I CE%sT 1980
+1 E CE%sT
+Z Europe/Samara 3:20:20 - LMT 1919 Jul 1 0u
+3 - +03 1930 Jun 21
+4 - +04 1935 Ja 27
+4 R +04/+05 1989 Mar 26 2s
+3 R +03/+04 1991 Mar 31 2s
+2 R +02/+03 1991 S 29 2s
+3 - +03 1991 O 20 3
+4 R +04/+05 2010 Mar 28 2s
+3 R +03/+04 2011 Mar 27 2s
+4 - +04
+Z Europe/Saratov 3:4:18 - LMT 1919 Jul 1 0u
+3 - +03 1930 Jun 21
+4 R +04/+05 1988 Mar 27 2s
+3 R +03/+04 1991 Mar 31 2s
+4 - +04 1992 Mar 29 2s
+3 R +03/+04 2011 Mar 27 2s
+4 - +04 2014 O 26 2s
+3 - +03 2016 D 4 2s
+4 - +04
+Z Europe/Simferopol 2:16:24 - LMT 1880
+2:16 - SMT 1924 May 2
+2 - EET 1930 Jun 21
+3 - MSK 1941 N
+1 c CE%sT 1944 Ap 13
+3 R MSK/MSD 1990
+3 - MSK 1990 Jul 1 2
+2 - EET 1992 Mar 20
+2 c EE%sT 1994 May
+3 c MSK/MSD 1996 Mar 31 0s
+3 1 MSD 1996 O 27 3s
+3 - MSK 1997 Mar lastSu 1u
+2 E EE%sT 2014 Mar 30 2
+4 - MSK 2014 O 26 2s
+3 - MSK
+Z Europe/Sofia 1:33:16 - LMT 1880
+1:56:56 - IMT 1894 N 30
+2 - EET 1942 N 2 3
+1 c CE%sT 1945
+1 - CET 1945 Ap 2 3
+2 - EET 1979 Mar 31 23
+2 BG EE%sT 1982 S 26 3
+2 c EE%sT 1991
+2 e EE%sT 1997
+2 E EE%sT
+Z Europe/Tallinn 1:39 - LMT 1880
+1:39 - TMT 1918 F
+1 c CE%sT 1919 Jul
+1:39 - TMT 1921 May
+2 - EET 1940 Au 6
+3 - MSK 1941 S 15
+1 c CE%sT 1944 S 22
+3 R MSK/MSD 1989 Mar 26 2s
+2 1 EEST 1989 S 24 2s
+2 c EE%sT 1998 S 22
+2 E EE%sT 1999 O 31 4
+2 - EET 2002 F 21
+2 E EE%sT
+Z Europe/Tirane 1:19:20 - LMT 1914
+1 - CET 1940 Jun 16
+1 q CE%sT 1984 Jul
+1 E CE%sT
+Z Europe/Ulyanovsk 3:13:36 - LMT 1919 Jul 1 0u
+3 - +03 1930 Jun 21
+4 R +04/+05 1989 Mar 26 2s
+3 R +03/+04 1991 Mar 31 2s
+2 R +02/+03 1992 Ja 19 2s
+3 R +03/+04 2011 Mar 27 2s
+4 - +04 2014 O 26 2s
+3 - +03 2016 Mar 27 2s
+4 - +04
+Z Europe/Vienna 1:5:21 - LMT 1893 Ap
+1 c CE%sT 1920
+1 a CE%sT 1940 Ap 1 2s
+1 c CE%sT 1945 Ap 2 2s
+1 1 CEST 1945 Ap 12 2s
+1 - CET 1946
+1 a CE%sT 1981
+1 E CE%sT
+Z Europe/Vilnius 1:41:16 - LMT 1880
+1:24 - WMT 1917
+1:35:36 - KMT 1919 O 10
+1 - CET 1920 Jul 12
+2 - EET 1920 O 9
+1 - CET 1940 Au 3
+3 - MSK 1941 Jun 24
+1 c CE%sT 1944 Au
+3 R MSK/MSD 1989 Mar 26 2s
+2 R EE%sT 1991 S 29 2s
+2 c EE%sT 1998
+2 - EET 1998 Mar 29 1u
+1 E CE%sT 1999 O 31 1u
+2 - EET 2003
+2 E EE%sT
+Z Europe/Volgograd 2:57:40 - LMT 1920 Ja 3
+3 - +03 1930 Jun 21
+4 - +04 1961 N 11
+4 R +04/+05 1988 Mar 27 2s
+3 R MSK/MSD 1991 Mar 31 2s
+4 - +04 1992 Mar 29 2s
+3 R MSK/MSD 2011 Mar 27 2s
+4 - MSK 2014 O 26 2s
+3 - MSK 2018 O 28 2s
+4 - +04 2020 D 27 2s
+3 - MSK
+Z Europe/Warsaw 1:24 - LMT 1880
+1:24 - WMT 1915 Au 5
+1 c CE%sT 1918 S 16 3
+2 O EE%sT 1922 Jun
+1 O CE%sT 1940 Jun 23 2
+1 c CE%sT 1944 O
+1 O CE%sT 1977
+1 W- CE%sT 1988
+1 E CE%sT
+Z Europe/Zurich 0:34:8 - LMT 1853 Jul 16
+0:29:46 - BMT 1894 Jun
+1 CH CE%sT 1981
+1 E CE%sT
 Z Factory 0 - -00
+Z HST -10 - HST
+Z Indian/Chagos 4:49:40 - LMT 1907
+5 - +05 1996
+6 - +06
+Z Indian/Maldives 4:54 - LMT 1880
+4:54 - MMT 1960
+5 - +05
+Z Indian/Mauritius 3:50 - LMT 1907
+4 MU +04/+05
+Z MET 1 c ME%sT
+Z MST -7 - MST
+Z MST7MDT -7 u M%sT
+Z PST8PDT -8 u P%sT
+Z Pacific/Apia 12:33:4 - LMT 1892 Jul 5
+-11:26:56 - LMT 1911
+-11:30 - -1130 1950
+-11 WS -11/-10 2011 D 29 24
+13 WS +13/+14
+Z Pacific/Auckland 11:39:4 - LMT 1868 N 2
+11:30 NZ NZ%sT 1946
+12 NZ NZ%sT
+Z Pacific/Bougainville 10:22:16 - LMT 1880
+9:48:32 - PMMT 1895
+10 - +10 1942 Jul
+9 - +09 1945 Au 21
+10 - +10 2014 D 28 2
+11 - +11
+Z Pacific/Chatham 12:13:48 - LMT 1868 N 2
+12:15 - +1215 1946
+12:45 k +1245/+1345
+Z Pacific/Easter -7:17:28 - LMT 1890
+-7:17:28 - EMT 1932 S
+-7 x -07/-06 1982 Mar 14 3u
+-6 x -06/-05
+Z Pacific/Efate 11:13:16 - LMT 1912 Ja 13
+11 VU +11/+12
+Z Pacific/Fakaofo -11:24:56 - LMT 1901
+-11 - -11 2011 D 30
+13 - +13
+Z Pacific/Fiji 11:55:44 - LMT 1915 O 26
+12 FJ +12/+13
+Z Pacific/Galapagos -5:58:24 - LMT 1931
+-5 - -05 1986
+-6 EC -06/-05
+Z Pacific/Gambier -8:59:48 - LMT 1912 O
+-9 - -09
+Z Pacific/Guadalcanal 10:39:48 - LMT 1912 O
+11 - +11
+Z Pacific/Guam -14:21 - LMT 1844 D 31
+9:39 - LMT 1901
+10 - GST 1941 D 10
+9 - +09 1944 Jul 31
+10 Gu G%sT 2000 D 23
+10 - ChST
+Z Pacific/Honolulu -10:31:26 - LMT 1896 Ja 13 12
+-10:30 - HST 1933 Ap 30 2
+-10:30 1 HDT 1933 May 21 12
+-10:30 u H%sT 1947 Jun 8 2
+-10 - HST
+Z Pacific/Kanton 0 - -00 1937 Au 31
+-12 - -12 1979 O
+-11 - -11 1994 D 31
+13 - +13
+Z Pacific/Kiritimati -10:29:20 - LMT 1901
+-10:40 - -1040 1979 O
+-10 - -10 1994 D 31
+14 - +14
+Z Pacific/Kosrae -13:8:4 - LMT 1844 D 31
+10:51:56 - LMT 1901
+11 - +11 1914 O
+9 - +09 1919 F
+11 - +11 1937
+10 - +10 1941 Ap
+9 - +09 1945 Au
+11 - +11 1969 O
+12 - +12 1999
+11 - +11
+Z Pacific/Kwajalein 11:9:20 - LMT 1901
+11 - +11 1937
+10 - +10 1941 Ap
+9 - +09 1944 F 6
+11 - +11 1969 O
+-12 - -12 1993 Au 20 24
+12 - +12
+Z Pacific/Marquesas -9:18 - LMT 1912 O
+-9:30 - -0930
+Z Pacific/Nauru 11:7:40 - LMT 1921 Ja 15
+11:30 - +1130 1942 Au 29
+9 - +09 1945 S 8
+11:30 - +1130 1979 F 10 2
+12 - +12
+Z Pacific/Niue -11:19:40 - LMT 1952 O 16
+-11:20 - -1120 1964 Jul
+-11 - -11
+Z Pacific/Norfolk 11:11:52 - LMT 1901
+11:12 - +1112 1951
+11:30 - +1130 1974 O 27 2s
+11:30 1 +1230 1975 Mar 2 2s
+11:30 - +1130 2015 O 4 2s
+11 - +11 2019 Jul
+11 AN +11/+12
+Z Pacific/Noumea 11:5:48 - LMT 1912 Ja 13
+11 NC +11/+12
+Z Pacific/Pago_Pago 12:37:12 - LMT 1892 Jul 5
+-11:22:48 - LMT 1911
+-11 - SST
+Z Pacific/Palau -15:2:4 - LMT 1844 D 31
+8:57:56 - LMT 1901
+9 - +09
+Z Pacific/Pitcairn -8:40:20 - LMT 1901
+-8:30 - -0830 1998 Ap 27
+-8 - -08
+Z Pacific/Port_Moresby 9:48:40 - LMT 1880
+9:48:32 - PMMT 1895
+10 - +10
+Z Pacific/Rarotonga 13:20:56 - LMT 1899 D 26
+-10:39:4 - LMT 1952 O 16
+-10:30 - -1030 1978 N 12
+-10 CK -10/-0930
+Z Pacific/Tahiti -9:58:16 - LMT 1912 O
+-10 - -10
+Z Pacific/Tarawa 11:32:4 - LMT 1901
+12 - +12
+Z Pacific/Tongatapu 12:19:12 - LMT 1945 S 10
+12:20 - +1220 1961
+13 - +13 1999
+13 TO +13/+14
+Z WET 0 E WE%sT
+L Etc/GMT GMT
 L Australia/Sydney Australia/ACT
 L Australia/Lord_Howe Australia/LHI
 L Australia/Sydney Australia/NSW
@@ -4185,7 +4195,6 @@ L America/Puerto_Rico America/Tortola
 L Pacific/Port_Moresby Antarctica/DumontDUrville
 L Pacific/Auckland Antarctica/McMurdo
 L Asia/Riyadh Antarctica/Syowa
-L Asia/Urumqi Antarctica/Vostok
 L Europe/Berlin Arctic/Longyearbyen
 L Asia/Riyadh Asia/Aden
 L Asia/Qatar Asia/Bahrain
diff --git a/lib/pytz/zoneinfo/zone.tab b/lib/pytz/zoneinfo/zone.tab
index dbcb6179..3fa9306a 100644
--- a/lib/pytz/zoneinfo/zone.tab
+++ b/lib/pytz/zoneinfo/zone.tab
@@ -48,7 +48,7 @@ AR	-3124-06411	America/Argentina/Cordoba	Argentina (most areas: CB, CC, CN, ER,
 AR	-2447-06525	America/Argentina/Salta	Salta (SA, LP, NQ, RN)
 AR	-2411-06518	America/Argentina/Jujuy	Jujuy (JY)
 AR	-2649-06513	America/Argentina/Tucuman	Tucuman (TM)
-AR	-2828-06547	America/Argentina/Catamarca	Catamarca (CT); Chubut (CH)
+AR	-2828-06547	America/Argentina/Catamarca	Catamarca (CT), Chubut (CH)
 AR	-2926-06651	America/Argentina/La_Rioja	La Rioja (LR)
 AR	-3132-06831	America/Argentina/San_Juan	San Juan (SJ)
 AR	-3253-06849	America/Argentina/Mendoza	Mendoza (MZ)
@@ -87,7 +87,7 @@ BN	+0456+11455	Asia/Brunei
 BO	-1630-06809	America/La_Paz
 BQ	+120903-0681636	America/Kralendijk
 BR	-0351-03225	America/Noronha	Atlantic islands
-BR	-0127-04829	America/Belem	Para (east); Amapa
+BR	-0127-04829	America/Belem	Para (east), Amapa
 BR	-0343-03830	America/Fortaleza	Brazil (northeast: MA, PI, CE, RN, PB)
 BR	-0803-03454	America/Recife	Pernambuco
 BR	-0712-04812	America/Araguaina	Tocantins
@@ -107,21 +107,21 @@ BT	+2728+08939	Asia/Thimphu
 BW	-2439+02555	Africa/Gaborone
 BY	+5354+02734	Europe/Minsk
 BZ	+1730-08812	America/Belize
-CA	+4734-05243	America/St_Johns	Newfoundland; Labrador (southeast)
-CA	+4439-06336	America/Halifax	Atlantic - NS (most areas); PE
+CA	+4734-05243	America/St_Johns	Newfoundland, Labrador (SE)
+CA	+4439-06336	America/Halifax	Atlantic - NS (most areas), PE
 CA	+4612-05957	America/Glace_Bay	Atlantic - NS (Cape Breton)
 CA	+4606-06447	America/Moncton	Atlantic - New Brunswick
 CA	+5320-06025	America/Goose_Bay	Atlantic - Labrador (most areas)
 CA	+5125-05707	America/Blanc-Sablon	AST - QC (Lower North Shore)
-CA	+4339-07923	America/Toronto	Eastern - ON, QC (most areas)
+CA	+4339-07923	America/Toronto	Eastern - ON & QC (most areas)
 CA	+6344-06828	America/Iqaluit	Eastern - NU (most areas)
-CA	+484531-0913718	America/Atikokan	EST - ON (Atikokan); NU (Coral H)
-CA	+4953-09709	America/Winnipeg	Central - ON (west); Manitoba
+CA	+484531-0913718	America/Atikokan	EST - ON (Atikokan), NU (Coral H)
+CA	+4953-09709	America/Winnipeg	Central - ON (west), Manitoba
 CA	+744144-0944945	America/Resolute	Central - NU (Resolute)
 CA	+624900-0920459	America/Rankin_Inlet	Central - NU (central)
 CA	+5024-10439	America/Regina	CST - SK (most areas)
 CA	+5017-10750	America/Swift_Current	CST - SK (midwest)
-CA	+5333-11328	America/Edmonton	Mountain - AB; BC (E); NT (E); SK (W)
+CA	+5333-11328	America/Edmonton	Mountain - AB, BC(E), NT(E), SK(W)
 CA	+690650-1050310	America/Cambridge_Bay	Mountain - NU (west)
 CA	+682059-1334300	America/Inuvik	Mountain - NT (west)
 CA	+4906-11631	America/Creston	MST - BC (Creston)
@@ -207,8 +207,8 @@ HT	+1832-07220	America/Port-au-Prince
 HU	+4730+01905	Europe/Budapest
 ID	-0610+10648	Asia/Jakarta	Java, Sumatra
 ID	-0002+10920	Asia/Pontianak	Borneo (west, central)
-ID	-0507+11924	Asia/Makassar	Borneo (east, south); Sulawesi/Celebes, Bali, Nusa Tengarra; Timor (west)
-ID	-0232+14042	Asia/Jayapura	New Guinea (West Papua / Irian Jaya); Malukus/Moluccas
+ID	-0507+11924	Asia/Makassar	Borneo (east, south), Sulawesi/Celebes, Bali, Nusa Tengarra, Timor (west)
+ID	-0232+14042	Asia/Jayapura	New Guinea (West Papua / Irian Jaya), Malukus/Moluccas
 IE	+5320-00615	Europe/Dublin
 IL	+314650+0351326	Asia/Jerusalem
 IM	+5409-00428	Europe/Isle_of_Man
@@ -355,7 +355,7 @@ RU	+4310+13156	Asia/Vladivostok	MSK+07 - Amur River
 RU	+643337+1431336	Asia/Ust-Nera	MSK+07 - Oymyakonsky
 RU	+5934+15048	Asia/Magadan	MSK+08 - Magadan
 RU	+4658+14242	Asia/Sakhalin	MSK+08 - Sakhalin Island
-RU	+6728+15343	Asia/Srednekolymsk	MSK+08 - Sakha (E); N Kuril Is
+RU	+6728+15343	Asia/Srednekolymsk	MSK+08 - Sakha (E), N Kuril Is
 RU	+5301+15839	Asia/Kamchatka	MSK+09 - Kamchatka
 RU	+6445+17729	Asia/Anadyr	MSK+09 - Bering Sea
 RW	-0157+03004	Africa/Kigali
@@ -418,7 +418,7 @@ US	+470659-1011757	America/North_Dakota/Center	Central - ND (Oliver)
 US	+465042-1012439	America/North_Dakota/New_Salem	Central - ND (Morton rural)
 US	+471551-1014640	America/North_Dakota/Beulah	Central - ND (Mercer)
 US	+394421-1045903	America/Denver	Mountain (most areas)
-US	+433649-1161209	America/Boise	Mountain - ID (south); OR (east)
+US	+433649-1161209	America/Boise	Mountain - ID (south), OR (east)
 US	+332654-1120424	America/Phoenix	MST - AZ (except Navajo)
 US	+340308-1181434	America/Los_Angeles	Pacific
 US	+611305-1495401	America/Anchorage	Alaska (most areas)
diff --git a/lib/pytz/zoneinfo/zone1970.tab b/lib/pytz/zoneinfo/zone1970.tab
index 1f1cecb8..abd94897 100644
--- a/lib/pytz/zoneinfo/zone1970.tab
+++ b/lib/pytz/zoneinfo/zone1970.tab
@@ -37,7 +37,7 @@
 #country-
 #codes	coordinates	TZ	comments
 AD	+4230+00131	Europe/Andorra
-AE,OM,RE,SC,TF	+2518+05518	Asia/Dubai	Crozet, Scattered Is
+AE,OM,RE,SC,TF	+2518+05518	Asia/Dubai	Crozet
 AF	+3431+06912	Asia/Kabul
 AL	+4120+01950	Europe/Tirane
 AM	+4011+04430	Asia/Yerevan
@@ -47,12 +47,13 @@ AQ	-6736+06253	Antarctica/Mawson	Mawson
 AQ	-6448-06406	Antarctica/Palmer	Palmer
 AQ	-6734-06808	Antarctica/Rothera	Rothera
 AQ	-720041+0023206	Antarctica/Troll	Troll
+AQ	-7824+10654	Antarctica/Vostok	Vostok
 AR	-3436-05827	America/Argentina/Buenos_Aires	Buenos Aires (BA, CF)
 AR	-3124-06411	America/Argentina/Cordoba	most areas: CB, CC, CN, ER, FM, MN, SE, SF
 AR	-2447-06525	America/Argentina/Salta	Salta (SA, LP, NQ, RN)
 AR	-2411-06518	America/Argentina/Jujuy	Jujuy (JY)
 AR	-2649-06513	America/Argentina/Tucuman	Tucumán (TM)
-AR	-2828-06547	America/Argentina/Catamarca	Catamarca (CT); Chubut (CH)
+AR	-2828-06547	America/Argentina/Catamarca	Catamarca (CT), Chubut (CH)
 AR	-2926-06651	America/Argentina/La_Rioja	La Rioja (LR)
 AR	-3132-06831	America/Argentina/San_Juan	San Juan (SJ)
 AR	-3253-06849	America/Argentina/Mendoza	Mendoza (MZ)
@@ -81,7 +82,7 @@ BG	+4241+02319	Europe/Sofia
 BM	+3217-06446	Atlantic/Bermuda
 BO	-1630-06809	America/La_Paz
 BR	-0351-03225	America/Noronha	Atlantic islands
-BR	-0127-04829	America/Belem	Pará (east); Amapá
+BR	-0127-04829	America/Belem	Pará (east), Amapá
 BR	-0343-03830	America/Fortaleza	Brazil (northeast: MA, PI, CE, RN, PB)
 BR	-0803-03454	America/Recife	Pernambuco
 BR	-0712-04812	America/Araguaina	Tocantins
@@ -99,19 +100,19 @@ BR	-0958-06748	America/Rio_Branco	Acre
 BT	+2728+08939	Asia/Thimphu
 BY	+5354+02734	Europe/Minsk
 BZ	+1730-08812	America/Belize
-CA	+4734-05243	America/St_Johns	Newfoundland; Labrador (southeast)
-CA	+4439-06336	America/Halifax	Atlantic - NS (most areas); PE
+CA	+4734-05243	America/St_Johns	Newfoundland, Labrador (SE)
+CA	+4439-06336	America/Halifax	Atlantic - NS (most areas), PE
 CA	+4612-05957	America/Glace_Bay	Atlantic - NS (Cape Breton)
 CA	+4606-06447	America/Moncton	Atlantic - New Brunswick
 CA	+5320-06025	America/Goose_Bay	Atlantic - Labrador (most areas)
-CA,BS	+4339-07923	America/Toronto	Eastern - ON, QC (most areas)
+CA,BS	+4339-07923	America/Toronto	Eastern - ON & QC (most areas)
 CA	+6344-06828	America/Iqaluit	Eastern - NU (most areas)
-CA	+4953-09709	America/Winnipeg	Central - ON (west); Manitoba
+CA	+4953-09709	America/Winnipeg	Central - ON (west), Manitoba
 CA	+744144-0944945	America/Resolute	Central - NU (Resolute)
 CA	+624900-0920459	America/Rankin_Inlet	Central - NU (central)
 CA	+5024-10439	America/Regina	CST - SK (most areas)
 CA	+5017-10750	America/Swift_Current	CST - SK (midwest)
-CA	+5333-11328	America/Edmonton	Mountain - AB; BC (E); NT (E); SK (W)
+CA	+5333-11328	America/Edmonton	Mountain - AB, BC(E), NT(E), SK(W)
 CA	+690650-1050310	America/Cambridge_Bay	Mountain - NU (west)
 CA	+682059-1334300	America/Inuvik	Mountain - NT (west)
 CA	+5546-12014	America/Dawson_Creek	MST - BC (Dawson Cr, Ft St John)
@@ -126,7 +127,7 @@ CL	-3327-07040	America/Santiago	most of Chile
 CL	-5309-07055	America/Punta_Arenas	Region of Magallanes
 CL	-2709-10926	Pacific/Easter	Easter Island
 CN	+3114+12128	Asia/Shanghai	Beijing Time
-CN,AQ	+4348+08735	Asia/Urumqi	Xinjiang Time, Vostok
+CN	+4348+08735	Asia/Urumqi	Xinjiang Time
 CO	+0436-07405	America/Bogota
 CR	+0956-08405	America/Costa_Rica
 CU	+2308-08222	America/Havana
@@ -171,8 +172,8 @@ HT	+1832-07220	America/Port-au-Prince
 HU	+4730+01905	Europe/Budapest
 ID	-0610+10648	Asia/Jakarta	Java, Sumatra
 ID	-0002+10920	Asia/Pontianak	Borneo (west, central)
-ID	-0507+11924	Asia/Makassar	Borneo (east, south); Sulawesi/Celebes, Bali, Nusa Tengarra; Timor (west)
-ID	-0232+14042	Asia/Jayapura	New Guinea (West Papua / Irian Jaya); Malukus/Moluccas
+ID	-0507+11924	Asia/Makassar	Borneo (east, south), Sulawesi/Celebes, Bali, Nusa Tengarra, Timor (west)
+ID	-0232+14042	Asia/Jayapura	New Guinea (West Papua / Irian Jaya), Malukus/Moluccas
 IE	+5320-00615	Europe/Dublin
 IL	+314650+0351326	Asia/Jerusalem
 IN	+2232+08822	Asia/Kolkata
@@ -251,7 +252,7 @@ PK	+2452+06703	Asia/Karachi
 PL	+5215+02100	Europe/Warsaw
 PM	+4703-05620	America/Miquelon
 PN	-2504-13005	Pacific/Pitcairn
-PR,AG,CA,AI,AW,BL,BQ,CW,DM,GD,GP,KN,LC,MF,MS,SX,TT,VC,VG,VI	+182806-0660622	America/Puerto_Rico	AST
+PR,AG,CA,AI,AW,BL,BQ,CW,DM,GD,GP,KN,LC,MF,MS,SX,TT,VC,VG,VI	+182806-0660622	America/Puerto_Rico	AST - QC (Lower North Shore)
 PS	+3130+03428	Asia/Gaza	Gaza Strip
 PS	+313200+0350542	Asia/Hebron	West Bank
 PT	+3843-00908	Europe/Lisbon	Portugal (mainland)
@@ -287,7 +288,7 @@ RU	+4310+13156	Asia/Vladivostok	MSK+07 - Amur River
 RU	+643337+1431336	Asia/Ust-Nera	MSK+07 - Oymyakonsky
 RU	+5934+15048	Asia/Magadan	MSK+08 - Magadan
 RU	+4658+14242	Asia/Sakhalin	MSK+08 - Sakhalin Island
-RU	+6728+15343	Asia/Srednekolymsk	MSK+08 - Sakha (E); N Kuril Is
+RU	+6728+15343	Asia/Srednekolymsk	MSK+08 - Sakha (E), N Kuril Is
 RU	+5301+15839	Asia/Kamchatka	MSK+09 - Kamchatka
 RU	+6445+17729	Asia/Anadyr	MSK+09 - Bering Sea
 SA,AQ,KW,YE	+2438+04643	Asia/Riyadh	Syowa
@@ -329,7 +330,7 @@ US	+470659-1011757	America/North_Dakota/Center	Central - ND (Oliver)
 US	+465042-1012439	America/North_Dakota/New_Salem	Central - ND (Morton rural)
 US	+471551-1014640	America/North_Dakota/Beulah	Central - ND (Mercer)
 US	+394421-1045903	America/Denver	Mountain (most areas)
-US	+433649-1161209	America/Boise	Mountain - ID (south); OR (east)
+US	+433649-1161209	America/Boise	Mountain - ID (south), OR (east)
 US,CA	+332654-1120424	America/Phoenix	MST - AZ (most areas), Creston BC
 US	+340308-1181434	America/Los_Angeles	Pacific
 US	+611305-1495401	America/Anchorage	Alaska (most areas)
diff --git a/lib/pytz/zoneinfo/zonenow.tab b/lib/pytz/zoneinfo/zonenow.tab
new file mode 100644
index 00000000..b6f29109
--- /dev/null
+++ b/lib/pytz/zoneinfo/zonenow.tab
@@ -0,0 +1,303 @@
+# tzdb timezone descriptions, for users who do not care about old timestamps
+#
+# This file is in the public domain.
+#
+# From Paul Eggert (2023-12-18):
+# This file contains a table where each row stands for a timezone
+# where civil timestamps are predicted to agree from now on.
+# This file is like zone1970.tab (see zone1970.tab's coments),
+# but with the following changes:
+#
+# 1.  Each timezone corresponds to a set of clocks that are planned
+#     to agree from now on.  This is a larger set of clocks than in
+#     zone1970.tab, where each timezone's clocks must agree from 1970 on.
+# 2.  The first column is irrelevant and ignored.
+# 3.  The table is sorted in a different way:
+#     first by standard time UTC offset;
+#     then, if DST is used, by daylight saving UTC offset;
+#     then by time zone abbreviation.
+# 4.  Every timezone has a nonempty comments column, with wording
+#     distinguishing the timezone only from other timezones with the
+#     same UTC offset at some point during the year.
+#
+# The format of this table is experimental, and may change in future versions.
+#
+# This table is intended as an aid for users, to help them select timezones
+# appropriate for their practical needs.  It is not intended to take or
+# endorse any position on legal or territorial claims.
+#
+#XX	coordinates	TZ	comments
+#
+# -11 - SST
+XX	-1416-17042	Pacific/Pago_Pago	Midway; Samoa ("SST")
+#
+# -11
+XX	-1901-16955	Pacific/Niue	Niue
+#
+# -10 - HST
+XX	+211825-1575130	Pacific/Honolulu	Hawaii ("HST")
+#
+# -10
+XX	-1732-14934	Pacific/Tahiti	Tahiti; Cook Islands
+#
+# -10/-09 - HST / HDT (North America DST)
+XX	+515248-1763929	America/Adak	western Aleutians in Alaska ("HST/HDT")
+#
+# -09:30
+XX	-0900-13930	Pacific/Marquesas	Marquesas
+#
+# -09
+XX	-2308-13457	Pacific/Gambier	Gambier
+#
+# -09/-08 - AKST/AKDT (North America DST)
+XX	+611305-1495401	America/Anchorage	most of Alaska ("AKST/AKDT")
+#
+# -08
+XX	-2504-13005	Pacific/Pitcairn	Pitcairn
+#
+# -08/-07 - PST/PDT (North America DST)
+XX	+340308-1181434	America/Los_Angeles	Pacific ("PST/PDT") - US & Canada; Mexico near US border
+#
+# -07 - MST
+XX	+332654-1120424	America/Phoenix	Mountain Standard ("MST") - Arizona; western Mexico; Yukon
+#
+# -07/-06 - MST/MDT (North America DST)
+XX	+394421-1045903	America/Denver	Mountain ("MST/MDT") - US & Canada; Mexico near US border
+#
+# -06
+XX	-0054-08936	Pacific/Galapagos	Galápagos
+#
+# -06 - CST
+XX	+1924-09909	America/Mexico_City	Central Standard ("CST") - Saskatchewan; central Mexico; Central America
+#
+# -06/-05 (Chile DST)
+XX	-2709-10926	Pacific/Easter	Easter Island
+#
+# -06/-05 - CST/CDT (North America DST)
+XX	+415100-0873900	America/Chicago	Central ("CST/CDT") - US & Canada; Mexico near US border
+#
+# -05
+XX	-1203-07703	America/Lima	eastern South America
+#
+# -05 - EST
+XX	+175805-0764736	America/Jamaica	Eastern Standard ("EST") - Caymans; Jamaica; eastern Mexico; Panama
+#
+# -05/-04 - CST/CDT (Cuba DST)
+XX	+2308-08222	America/Havana	Cuba
+#
+# -05/-04 - EST/EDT (North America DST)
+XX	+404251-0740023	America/New_York	Eastern ("EST/EDT") - US & Canada
+#
+# -04
+XX	+1030-06656	America/Caracas	western South America
+#
+# -04 - AST
+XX	+1828-06954	America/Santo_Domingo	Atlantic Standard ("AST") - eastern Caribbean
+#
+# -04/-03 (Chile DST)
+XX	-3327-07040	America/Santiago	most of Chile
+#
+# -04/-03 (Paraguay DST)
+XX	-2516-05740	America/Asuncion	Paraguay
+#
+# -04/-03 - AST/ADT (North America DST)
+XX	+4439-06336	America/Halifax	Atlantic ("AST/ADT") - Canada; Bermuda
+#
+# -03:30/-02:30 - NST/NDT (North America DST)
+XX	+4734-05243	America/St_Johns	Newfoundland ("NST/NDT")
+#
+# -03
+XX	-2332-04637	America/Sao_Paulo	eastern South America
+#
+# -03/-02 (North America DST)
+XX	+4703-05620	America/Miquelon	St Pierre & Miquelon
+#
+# -02
+XX	-0351-03225	America/Noronha	Fernando de Noronha; South Georgia
+#
+# -02/-01 (EU DST)
+XX	+6411-05144	America/Nuuk	most of Greenland
+#
+# -01
+XX	+1455-02331	Atlantic/Cape_Verde	Cape Verde
+#
+# -01/+00 (EU DST)
+XX	+3744-02540	Atlantic/Azores	Azores
+# -01/+00 (EU DST) until 2024-03-31; then -02/-01 (EU DST)
+XX	+7029-02158	America/Scoresbysund	Ittoqqortoormiit
+#
+# +00 - GMT
+XX	+0519-00402	Africa/Abidjan	far western Africa; Iceland ("GMT")
+#
+# +00/+01 - GMT/BST (EU DST)
+XX	+513030-0000731	Europe/London	United Kingdom ("GMT/BST")
+#
+# +00/+01 - WET/WEST (EU DST)
+XX	+3843-00908	Europe/Lisbon	western Europe ("WET/WEST")
+#
+# +00/+02 - Troll DST
+XX	-720041+0023206	Antarctica/Troll	Troll Station in Antarctica
+#
+# +01 - CET
+XX	+3647+00303	Africa/Algiers	Algeria, Tunisia ("CET")
+#
+# +01 - WAT
+XX	+0627+00324	Africa/Lagos	western Africa ("WAT")
+#
+# +01/+00 - IST/GMT (EU DST in reverse)
+XX	+5320-00615	Europe/Dublin	Ireland ("IST/GMT")
+#
+# +01/+00 - (Morocco DST)
+XX	+3339-00735	Africa/Casablanca	Morocco
+#
+# +01/+02 - CET/CEST (EU DST)
+XX	+4852+00220	Europe/Paris	central Europe ("CET/CEST")
+#
+# +02 - CAT
+XX	-2558+03235	Africa/Maputo	central Africa ("CAT")
+#
+# +02 - EET
+XX	+3254+01311	Africa/Tripoli	Libya; Kaliningrad ("EET")
+#
+# +02 - SAST
+XX	-2615+02800	Africa/Johannesburg	southern Africa ("SAST")
+#
+# +02/+03 - EET/EEST (EU DST)
+XX	+3758+02343	Europe/Athens	eastern Europe ("EET/EEST")
+#
+# +02/+03 - EET/EEST (Egypt DST)
+XX	+3003+03115	Africa/Cairo	Egypt
+#
+# +02/+03 - EET/EEST (Lebanon DST)
+XX	+3353+03530	Asia/Beirut	Lebanon
+#
+# +02/+03 - EET/EEST (Moldova DST)
+XX	+4700+02850	Europe/Chisinau	Moldova
+#
+# +02/+03 - EET/EEST (Palestine DST)
+XX	+3130+03428	Asia/Gaza	Palestine
+#
+# +02/+03 - IST/IDT (Israel DST)
+XX	+314650+0351326	Asia/Jerusalem	Israel
+#
+# +03
+XX	+4101+02858	Europe/Istanbul	Near East; Belarus
+#
+# +03 - EAT
+XX	-0117+03649	Africa/Nairobi	eastern Africa ("EAT")
+#
+# +03 - MSK
+XX	+554521+0373704	Europe/Moscow	Moscow ("MSK")
+#
+# +03:30
+XX	+3540+05126	Asia/Tehran	Iran
+#
+# +04
+XX	+2518+05518	Asia/Dubai	Russia; Caucasus; Persian Gulf; Seychelles; Réunion
+#
+# +04:30
+XX	+3431+06912	Asia/Kabul	Afghanistan
+#
+# +05
+XX	+4120+06918	Asia/Tashkent	Russia; west Kazakhstan; Tajikistan; Turkmenistan; Uzbekistan; Maldives
+#
+# +05 - PKT
+XX	+2452+06703	Asia/Karachi	Pakistan ("PKT")
+#
+# +05:30
+XX	+0656+07951	Asia/Colombo	Sri Lanka
+#
+# +05:30 - IST
+XX	+2232+08822	Asia/Kolkata	India ("IST")
+#
+# +05:45
+XX	+2743+08519	Asia/Kathmandu	Nepal
+#
+# +06
+XX	+2343+09025	Asia/Dhaka	Russia; Kyrgyzstan; Bhutan; Bangladesh; Chagos
+# +06 until 2024-03-01; then +05
+XX	+4315+07657	Asia/Almaty	Kazakhstan (except western areas)
+#
+# +06:30
+XX	+1647+09610	Asia/Yangon	Myanmar; Cocos
+#
+# +07
+XX	+1345+10031	Asia/Bangkok	Russia; Indochina; Christmas Island
+#
+# +07 - WIB
+XX	-0610+10648	Asia/Jakarta	Indonesia ("WIB")
+#
+# +08
+XX	+0117+10351	Asia/Singapore	Russia; Brunei; Malaysia; Singapore
+#
+# +08 - AWST
+XX	-3157+11551	Australia/Perth	Western Australia ("AWST")
+#
+# +08 - CST
+XX	+3114+12128	Asia/Shanghai	China ("CST")
+#
+# +08 - HKT
+XX	+2217+11409	Asia/Hong_Kong	Hong Kong ("HKT")
+#
+# +08 - PHT
+XX	+1435+12100	Asia/Manila	Philippines ("PHT")
+#
+# +08 - WITA
+XX	-0507+11924	Asia/Makassar	Indonesia ("WITA")
+#
+# +08:45
+XX	-3143+12852	Australia/Eucla	Eucla
+#
+# +09
+XX	+5203+11328	Asia/Chita	Russia; Palau; East Timor
+#
+# +09 - JST
+XX	+353916+1394441	Asia/Tokyo	Japan ("JST")
+#
+# +09 - KST
+XX	+3733+12658	Asia/Seoul	Korea ("KST")
+#
+# +09 - WIT
+XX	-0232+14042	Asia/Jayapura	Indonesia ("WIT")
+#
+# +09:30 - ACST
+XX	-1228+13050	Australia/Darwin	Northern Territory ("ACST")
+#
+# +09:30/+10:30 - ACST/ACDT (Australia DST)
+XX	-3455+13835	Australia/Adelaide	South Australia ("ACST/ACDT")
+#
+# +10
+XX	+4310+13156	Asia/Vladivostok	Russia; Yap; Chuuk; Papua New Guinea; Dumont d'Urville
+#
+# +10 - AEST
+XX	-2728+15302	Australia/Brisbane	Queensland ("AEST")
+#
+# +10 - ChST
+XX	+1328+14445	Pacific/Guam	Mariana Islands ("ChST")
+#
+# +10/+11 - AEST/AEDT (Australia DST)
+XX	-3352+15113	Australia/Sydney	southeast Australia ("AEST/AEDT")
+#
+# +10:30/+11
+XX	-3133+15905	Australia/Lord_Howe	Lord Howe Island
+#
+# +11
+XX	-0613+15534	Pacific/Bougainville	Russia; Kosrae; Bougainville; Solomons
+#
+# +11/+12 (Australia DST)
+XX	-2903+16758	Pacific/Norfolk	Norfolk Island
+#
+# +12
+XX	+5301+15839	Asia/Kamchatka	Russia; Tuvalu; Fiji; etc.
+#
+# +12/+13 (New Zealand DST)
+XX	-3652+17446	Pacific/Auckland	New Zealand ("NZST/NZDT")
+#
+# +12:45/+13:45 (Chatham DST)
+XX	-4357-17633	Pacific/Chatham	Chatham Islands
+#
+# +13
+XX	-210800-1751200	Pacific/Tongatapu	Kanton; Tokelau; Samoa (western); Tonga
+#
+# +14
+XX	+0152-15720	Pacific/Kiritimati	Kiritimati
diff --git a/requirements.txt b/requirements.txt
index bdf83410..29f2c784 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -35,7 +35,7 @@ PyJWT==2.8.0
 pyparsing==3.1.1
 python-dateutil==2.8.2
 python-twitter==3.5
-pytz==2023.3
+pytz==2024.1
 requests==2.31.0
 requests-oauthlib==1.3.1
 rumps==0.4.0; platform_system == "Darwin"

From 4468c3e4af05b2af04ab6241891ed545e7a2890a Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sun, 24 Mar 2024 15:22:16 -0700
Subject: [PATCH 533/743] Bump mako from 1.2.4 to 1.3.2 (#2256)

* Bump mako from 1.2.4 to 1.3.2

Bumps [mako](https://github.com/sqlalchemy/mako) from 1.2.4 to 1.3.2.
- [Release notes](https://github.com/sqlalchemy/mako/releases)
- [Changelog](https://github.com/sqlalchemy/mako/blob/main/CHANGES)
- [Commits](https://github.com/sqlalchemy/mako/commits)

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

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

* Update mako==1.3.2

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/mako/__init__.py           |  4 ++--
 lib/mako/_ast_util.py          |  2 +-
 lib/mako/ast.py                |  2 +-
 lib/mako/cache.py              |  2 +-
 lib/mako/cmd.py                |  3 +--
 lib/mako/codegen.py            |  4 +---
 lib/mako/compat.py             | 10 ++------
 lib/mako/exceptions.py         |  2 +-
 lib/mako/ext/autohandler.py    |  2 +-
 lib/mako/ext/babelplugin.py    |  2 +-
 lib/mako/ext/beaker_cache.py   |  2 +-
 lib/mako/ext/extract.py        |  2 +-
 lib/mako/ext/linguaplugin.py   |  2 +-
 lib/mako/ext/preprocessors.py  |  2 +-
 lib/mako/ext/pygmentplugin.py  |  2 +-
 lib/mako/ext/turbogears.py     |  2 +-
 lib/mako/filters.py            |  2 +-
 lib/mako/lexer.py              | 20 ++++++++++++----
 lib/mako/lookup.py             |  3 +--
 lib/mako/parsetree.py          |  2 +-
 lib/mako/pygen.py              |  2 +-
 lib/mako/pyparser.py           |  5 +---
 lib/mako/runtime.py            |  2 +-
 lib/mako/template.py           |  3 +--
 lib/mako/testing/assertions.py |  1 -
 lib/mako/testing/helpers.py    |  4 ++++
 lib/mako/util.py               |  2 +-
 lib/markupsafe/__init__.py     | 44 +++++++++++++++++++++++++++-------
 requirements.txt               |  2 +-
 29 files changed, 83 insertions(+), 54 deletions(-)

diff --git a/lib/mako/__init__.py b/lib/mako/__init__.py
index d7339219..d022cf82 100644
--- a/lib/mako/__init__.py
+++ b/lib/mako/__init__.py
@@ -1,8 +1,8 @@
 # mako/__init__.py
-# Copyright 2006-2022 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2024 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
 
 
-__version__ = "1.2.4"
+__version__ = "1.3.2"
diff --git a/lib/mako/_ast_util.py b/lib/mako/_ast_util.py
index 95742835..63b8f228 100644
--- a/lib/mako/_ast_util.py
+++ b/lib/mako/_ast_util.py
@@ -1,5 +1,5 @@
 # mako/_ast_util.py
-# Copyright 2006-2022 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2024 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
diff --git a/lib/mako/ast.py b/lib/mako/ast.py
index a3f3ee3e..e59df3eb 100644
--- a/lib/mako/ast.py
+++ b/lib/mako/ast.py
@@ -1,5 +1,5 @@
 # mako/ast.py
-# Copyright 2006-2022 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2024 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
diff --git a/lib/mako/cache.py b/lib/mako/cache.py
index db21bb3e..bad25257 100644
--- a/lib/mako/cache.py
+++ b/lib/mako/cache.py
@@ -1,5 +1,5 @@
 # mako/cache.py
-# Copyright 2006-2022 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2024 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
diff --git a/lib/mako/cmd.py b/lib/mako/cmd.py
index 93a6733f..3858a127 100755
--- a/lib/mako/cmd.py
+++ b/lib/mako/cmd.py
@@ -1,5 +1,5 @@
 # mako/cmd.py
-# Copyright 2006-2022 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2024 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
@@ -25,7 +25,6 @@ def _exit():
 
 
 def cmdline(argv=None):
-
     parser = ArgumentParser()
     parser.add_argument(
         "--var",
diff --git a/lib/mako/codegen.py b/lib/mako/codegen.py
index d1d2c20a..ce6f83aa 100644
--- a/lib/mako/codegen.py
+++ b/lib/mako/codegen.py
@@ -1,5 +1,5 @@
 # mako/codegen.py
-# Copyright 2006-2022 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2024 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
@@ -816,7 +816,6 @@ class _GenerateRenderMethod:
             )
             or len(self.compiler.default_filters)
         ):
-
             s = self.create_filter_callable(
                 node.escapes_code.args, "%s" % node.text, True
             )
@@ -1181,7 +1180,6 @@ class _Identifiers:
 
     def visitBlockTag(self, node):
         if node is not self.node and not node.is_anonymous:
-
             if isinstance(self.node, parsetree.DefTag):
                 raise exceptions.CompileException(
                     "Named block '%s' not allowed inside of def '%s'"
diff --git a/lib/mako/compat.py b/lib/mako/compat.py
index 48df30d6..18322159 100644
--- a/lib/mako/compat.py
+++ b/lib/mako/compat.py
@@ -1,17 +1,17 @@
 # mako/compat.py
-# Copyright 2006-2022 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2024 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
 
 import collections
+from importlib import metadata as importlib_metadata
 from importlib import util
 import inspect
 import sys
 
 win32 = sys.platform.startswith("win")
 pypy = hasattr(sys, "pypy_version_info")
-py38 = sys.version_info >= (3, 8)
 
 ArgSpec = collections.namedtuple(
     "ArgSpec", ["args", "varargs", "keywords", "defaults"]
@@ -62,12 +62,6 @@ def exception_name(exc):
     return exc.__class__.__name__
 
 
-if py38:
-    from importlib import metadata as importlib_metadata
-else:
-    import importlib_metadata  # noqa
-
-
 def importlib_metadata_get(group):
     ep = importlib_metadata.entry_points()
     if hasattr(ep, "select"):
diff --git a/lib/mako/exceptions.py b/lib/mako/exceptions.py
index 31c695fd..ca225677 100644
--- a/lib/mako/exceptions.py
+++ b/lib/mako/exceptions.py
@@ -1,5 +1,5 @@
 # mako/exceptions.py
-# Copyright 2006-2022 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2024 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
diff --git a/lib/mako/ext/autohandler.py b/lib/mako/ext/autohandler.py
index 5bcfc285..dff9b6a8 100644
--- a/lib/mako/ext/autohandler.py
+++ b/lib/mako/ext/autohandler.py
@@ -1,5 +1,5 @@
 # ext/autohandler.py
-# Copyright 2006-2022 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2024 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
diff --git a/lib/mako/ext/babelplugin.py b/lib/mako/ext/babelplugin.py
index 907d0b80..cdb37cdf 100644
--- a/lib/mako/ext/babelplugin.py
+++ b/lib/mako/ext/babelplugin.py
@@ -1,5 +1,5 @@
 # ext/babelplugin.py
-# Copyright 2006-2022 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2024 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
diff --git a/lib/mako/ext/beaker_cache.py b/lib/mako/ext/beaker_cache.py
index 9aa35b06..590fbd01 100644
--- a/lib/mako/ext/beaker_cache.py
+++ b/lib/mako/ext/beaker_cache.py
@@ -1,5 +1,5 @@
 # ext/beaker_cache.py
-# Copyright 2006-2022 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2024 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
diff --git a/lib/mako/ext/extract.py b/lib/mako/ext/extract.py
index 9d33ee18..d03789db 100644
--- a/lib/mako/ext/extract.py
+++ b/lib/mako/ext/extract.py
@@ -1,5 +1,5 @@
 # ext/extract.py
-# Copyright 2006-2022 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2024 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
diff --git a/lib/mako/ext/linguaplugin.py b/lib/mako/ext/linguaplugin.py
index efb04c70..22077e66 100644
--- a/lib/mako/ext/linguaplugin.py
+++ b/lib/mako/ext/linguaplugin.py
@@ -1,5 +1,5 @@
 # ext/linguaplugin.py
-# Copyright 2006-2022 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2024 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
diff --git a/lib/mako/ext/preprocessors.py b/lib/mako/ext/preprocessors.py
index 80403ecd..6d1aaf5d 100644
--- a/lib/mako/ext/preprocessors.py
+++ b/lib/mako/ext/preprocessors.py
@@ -1,5 +1,5 @@
 # ext/preprocessors.py
-# Copyright 2006-2022 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2024 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
diff --git a/lib/mako/ext/pygmentplugin.py b/lib/mako/ext/pygmentplugin.py
index 9acbf4cd..f422623d 100644
--- a/lib/mako/ext/pygmentplugin.py
+++ b/lib/mako/ext/pygmentplugin.py
@@ -1,5 +1,5 @@
 # ext/pygmentplugin.py
-# Copyright 2006-2022 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2024 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
diff --git a/lib/mako/ext/turbogears.py b/lib/mako/ext/turbogears.py
index 2ebf0746..2a3ec7d7 100644
--- a/lib/mako/ext/turbogears.py
+++ b/lib/mako/ext/turbogears.py
@@ -1,5 +1,5 @@
 # ext/turbogears.py
-# Copyright 2006-2022 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2024 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
diff --git a/lib/mako/filters.py b/lib/mako/filters.py
index af202f3f..2a4b4386 100644
--- a/lib/mako/filters.py
+++ b/lib/mako/filters.py
@@ -1,5 +1,5 @@
 # mako/filters.py
-# Copyright 2006-2022 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2024 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
diff --git a/lib/mako/lexer.py b/lib/mako/lexer.py
index 75182f85..9d1f5f30 100644
--- a/lib/mako/lexer.py
+++ b/lib/mako/lexer.py
@@ -1,5 +1,5 @@
 # mako/lexer.py
-# Copyright 2006-2022 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2024 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
@@ -247,6 +247,8 @@ class Lexer:
                 continue
             if self.match_python_block():
                 continue
+            if self.match_percent():
+                continue
             if self.match_text():
                 continue
 
@@ -352,14 +354,24 @@ class Lexer:
         else:
             return True
 
+    def match_percent(self):
+        match = self.match(r"(?<=^)(\s*)%%(%*)", re.M)
+        if match:
+            self.append_node(
+                parsetree.Text, match.group(1) + "%" + match.group(2)
+            )
+            return True
+        else:
+            return False
+
     def match_text(self):
         match = self.match(
             r"""
                 (.*?)         # anything, followed by:
                 (
-                 (?<=\n)(?=[ \t]*(?=%|\#\#)) # an eval or line-based
-                                             # comment preceded by a
-                                             # consumed newline and whitespace
+                 (?<=\n)(?=[ \t]*(?=%|\#\#))  # an eval or line-based
+                                            # comment, preceded by a
+                                            # consumed newline and whitespace
                  |
                  (?=\${)      # an expression
                  |
diff --git a/lib/mako/lookup.py b/lib/mako/lookup.py
index f7410ce3..d916db77 100644
--- a/lib/mako/lookup.py
+++ b/lib/mako/lookup.py
@@ -1,5 +1,5 @@
 # mako/lookup.py
-# Copyright 2006-2022 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2024 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
@@ -178,7 +178,6 @@ class TemplateLookup(TemplateCollection):
         lexer_cls=None,
         include_error_handler=None,
     ):
-
         self.directories = [
             posixpath.normpath(d) for d in util.to_list(directories, ())
         ]
diff --git a/lib/mako/parsetree.py b/lib/mako/parsetree.py
index c5a12d1d..04686ece 100644
--- a/lib/mako/parsetree.py
+++ b/lib/mako/parsetree.py
@@ -1,5 +1,5 @@
 # mako/parsetree.py
-# Copyright 2006-2022 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2024 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
diff --git a/lib/mako/pygen.py b/lib/mako/pygen.py
index 57c69793..820e101d 100644
--- a/lib/mako/pygen.py
+++ b/lib/mako/pygen.py
@@ -1,5 +1,5 @@
 # mako/pygen.py
-# Copyright 2006-2022 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2024 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
diff --git a/lib/mako/pyparser.py b/lib/mako/pyparser.py
index d9b090c6..9b63dc33 100644
--- a/lib/mako/pyparser.py
+++ b/lib/mako/pyparser.py
@@ -1,5 +1,5 @@
 # mako/pyparser.py
-# Copyright 2006-2022 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2024 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
@@ -64,7 +64,6 @@ class FindIdentifiers(_ast_util.NodeVisitor):
         self._add_declared(node.name)
 
     def visit_Assign(self, node):
-
         # flip around the visiting of Assign so the expression gets
         # evaluated first, in the case of a clause like "x=x+5" (x
         # is undeclared)
@@ -99,7 +98,6 @@ class FindIdentifiers(_ast_util.NodeVisitor):
                 yield arg
 
     def _visit_function(self, node, islambda):
-
         # push function state onto stack.  dont log any more
         # identifiers as "declared" until outside of the function,
         # but keep logging identifiers as "undeclared". track
@@ -122,7 +120,6 @@ class FindIdentifiers(_ast_util.NodeVisitor):
         self.local_ident_stack = local_ident_stack
 
     def visit_For(self, node):
-
         # flip around visit
 
         self.visit(node.iter)
diff --git a/lib/mako/runtime.py b/lib/mako/runtime.py
index 6d7fa684..23401b70 100644
--- a/lib/mako/runtime.py
+++ b/lib/mako/runtime.py
@@ -530,7 +530,7 @@ class Namespace:
     def _populate(self, d, l):
         for ident in l:
             if ident == "*":
-                for (k, v) in self._get_star():
+                for k, v in self._get_star():
                     d[k] = v
             else:
                 d[ident] = getattr(self, ident)
diff --git a/lib/mako/template.py b/lib/mako/template.py
index 8c70731d..e2771727 100644
--- a/lib/mako/template.py
+++ b/lib/mako/template.py
@@ -1,5 +1,5 @@
 # mako/template.py
-# Copyright 2006-2022 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2024 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
@@ -26,7 +26,6 @@ from mako.lexer import Lexer
 
 
 class Template:
-
     r"""Represents a compiled template.
 
     :class:`.Template` includes a reference to the original
diff --git a/lib/mako/testing/assertions.py b/lib/mako/testing/assertions.py
index 14ea6352..22221cd2 100644
--- a/lib/mako/testing/assertions.py
+++ b/lib/mako/testing/assertions.py
@@ -103,7 +103,6 @@ def _assert_raises(
     check_context=False,
     cause_cls=None,
 ):
-
     with _expect_raises(except_cls, msg, check_context, cause_cls) as ec:
         callable_(*args, **kwargs)
     return ec.error
diff --git a/lib/mako/testing/helpers.py b/lib/mako/testing/helpers.py
index 77cca367..5ae9d38d 100644
--- a/lib/mako/testing/helpers.py
+++ b/lib/mako/testing/helpers.py
@@ -19,6 +19,10 @@ def result_lines(result):
     ]
 
 
+def result_raw_lines(result):
+    return [x for x in re.split(r"\r?\n", result) if x.strip() != ""]
+
+
 def make_path(
     filespec: Union[Path, str],
     make_absolute: bool = True,
diff --git a/lib/mako/util.py b/lib/mako/util.py
index 5fb683b4..91188cac 100644
--- a/lib/mako/util.py
+++ b/lib/mako/util.py
@@ -1,5 +1,5 @@
 # mako/util.py
-# Copyright 2006-2022 the Mako authors and contributors <see AUTHORS file>
+# Copyright 2006-2024 the Mako authors and contributors <see AUTHORS file>
 #
 # This module is part of Mako and is released under
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
diff --git a/lib/markupsafe/__init__.py b/lib/markupsafe/__init__.py
index 21d31960..b40f24c6 100644
--- a/lib/markupsafe/__init__.py
+++ b/lib/markupsafe/__init__.py
@@ -1,5 +1,4 @@
 import functools
-import re
 import string
 import sys
 import typing as t
@@ -14,10 +13,7 @@ if t.TYPE_CHECKING:
     _P = te.ParamSpec("_P")
 
 
-__version__ = "2.1.3"
-
-_strip_comments_re = re.compile(r"<!--.*?-->", re.DOTALL)
-_strip_tags_re = re.compile(r"<.*?>", re.DOTALL)
+__version__ = "2.1.5"
 
 
 def _simple_escaping_wrapper(func: "t.Callable[_P, str]") -> "t.Callable[_P, Markup]":
@@ -162,9 +158,41 @@ class Markup(str):
         >>> Markup("Main &raquo;\t<em>About</em>").striptags()
         'Main » About'
         """
-        # Use two regexes to avoid ambiguous matches.
-        value = _strip_comments_re.sub("", self)
-        value = _strip_tags_re.sub("", value)
+        value = str(self)
+
+        # Look for comments then tags separately. Otherwise, a comment that
+        # contains a tag would end early, leaving some of the comment behind.
+
+        while True:
+            # keep finding comment start marks
+            start = value.find("<!--")
+
+            if start == -1:
+                break
+
+            # find a comment end mark beyond the start, otherwise stop
+            end = value.find("-->", start)
+
+            if end == -1:
+                break
+
+            value = f"{value[:start]}{value[end + 3:]}"
+
+        # remove tags using the same method
+        while True:
+            start = value.find("<")
+
+            if start == -1:
+                break
+
+            end = value.find(">", start)
+
+            if end == -1:
+                break
+
+            value = f"{value[:start]}{value[end + 1:]}"
+
+        # collapse spaces
         value = " ".join(value.split())
         return self.__class__(value).unescape()
 
diff --git a/requirements.txt b/requirements.txt
index 29f2c784..32bd430e 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -22,7 +22,7 @@ importlib-metadata==6.8.0
 importlib-resources==6.0.1
 git+https://github.com/Tautulli/ipwhois.git@master#egg=ipwhois
 IPy==1.01
-Mako==1.2.4
+Mako==1.3.2
 MarkupSafe==2.1.3
 musicbrainzngs==0.7.1
 packaging==23.1

From a4cfc6323da91472eb70cbb32a1dde21e0373271 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sun, 24 Mar 2024 15:23:15 -0700
Subject: [PATCH 534/743] Bump certifi from 2023.7.22 to 2024.2.2 (#2257)

* Bump certifi from 2023.7.22 to 2024.2.2

Bumps [certifi](https://github.com/certifi/python-certifi) from 2023.7.22 to 2024.2.2.
- [Commits](https://github.com/certifi/python-certifi/compare/2023.07.22...2024.02.02)

---
updated-dependencies:
- dependency-name: certifi
  dependency-type: direct:production
  update-type: version-update:semver-major
...

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

* Update certifi==2024.2.2

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/certifi/__init__.py |   2 +-
 lib/certifi/cacert.pem  | 321 +++++++++++++++++++++++++++++++---------
 lib/certifi/core.py     |   6 +
 requirements.txt        |   2 +-
 4 files changed, 258 insertions(+), 73 deletions(-)

diff --git a/lib/certifi/__init__.py b/lib/certifi/__init__.py
index 8ce89cef..1c91f3ec 100644
--- a/lib/certifi/__init__.py
+++ b/lib/certifi/__init__.py
@@ -1,4 +1,4 @@
 from .core import contents, where
 
 __all__ = ["contents", "where"]
-__version__ = "2023.07.22"
+__version__ = "2024.02.02"
diff --git a/lib/certifi/cacert.pem b/lib/certifi/cacert.pem
index 02123695..fac3c319 100644
--- a/lib/certifi/cacert.pem
+++ b/lib/certifi/cacert.pem
@@ -245,34 +245,6 @@ mJlglFwjz1onl14LBQaTNx47aTbrqZ5hHY8y2o4M1nQ+ewkk2gF3R8Q7zTSMmfXK
 4SVhM7JZG+Ju1zdXtg2pEto=
 -----END CERTIFICATE-----
 
-# Issuer: O=SECOM Trust.net OU=Security Communication RootCA1
-# Subject: O=SECOM Trust.net OU=Security Communication RootCA1
-# Label: "Security Communication Root CA"
-# Serial: 0
-# MD5 Fingerprint: f1:bc:63:6a:54:e0:b5:27:f5:cd:e7:1a:e3:4d:6e:4a
-# SHA1 Fingerprint: 36:b1:2b:49:f9:81:9e:d7:4c:9e:bc:38:0f:c6:56:8f:5d:ac:b2:f7
-# SHA256 Fingerprint: e7:5e:72:ed:9f:56:0e:ec:6e:b4:80:00:73:a4:3f:c3:ad:19:19:5a:39:22:82:01:78:95:97:4a:99:02:6b:6c
------BEGIN CERTIFICATE-----
-MIIDWjCCAkKgAwIBAgIBADANBgkqhkiG9w0BAQUFADBQMQswCQYDVQQGEwJKUDEY
-MBYGA1UEChMPU0VDT00gVHJ1c3QubmV0MScwJQYDVQQLEx5TZWN1cml0eSBDb21t
-dW5pY2F0aW9uIFJvb3RDQTEwHhcNMDMwOTMwMDQyMDQ5WhcNMjMwOTMwMDQyMDQ5
-WjBQMQswCQYDVQQGEwJKUDEYMBYGA1UEChMPU0VDT00gVHJ1c3QubmV0MScwJQYD
-VQQLEx5TZWN1cml0eSBDb21tdW5pY2F0aW9uIFJvb3RDQTEwggEiMA0GCSqGSIb3
-DQEBAQUAA4IBDwAwggEKAoIBAQCzs/5/022x7xZ8V6UMbXaKL0u/ZPtM7orw8yl8
-9f/uKuDp6bpbZCKamm8sOiZpUQWZJtzVHGpxxpp9Hp3dfGzGjGdnSj74cbAZJ6kJ
-DKaVv0uMDPpVmDvY6CKhS3E4eayXkmmziX7qIWgGmBSWh9JhNrxtJ1aeV+7AwFb9
-Ms+k2Y7CI9eNqPPYJayX5HA49LY6tJ07lyZDo6G8SVlyTCMwhwFY9k6+HGhWZq/N
-QV3Is00qVUarH9oe4kA92819uZKAnDfdDJZkndwi92SL32HeFZRSFaB9UslLqCHJ
-xrHty8OVYNEP8Ktw+N/LTX7s1vqr2b1/VPKl6Xn62dZ2JChzAgMBAAGjPzA9MB0G
-A1UdDgQWBBSgc0mZaNyFW2XjmygvV5+9M7wHSDALBgNVHQ8EBAMCAQYwDwYDVR0T
-AQH/BAUwAwEB/zANBgkqhkiG9w0BAQUFAAOCAQEAaECpqLvkT115swW1F7NgE+vG
-kl3g0dNq/vu+m22/xwVtWSDEHPC32oRYAmP6SBbvT6UL90qY8j+eG61Ha2POCEfr
-Uj94nK9NrvjVT8+amCoQQTlSxN3Zmw7vkwGusi7KaEIkQmywszo+zenaSMQVy+n5
-Bw+SUEmK3TGXX8npN6o7WWWXlDLJs58+OmJYxUmtYg5xpTKqL8aJdkNAExNnPaJU
-JRDL8Try2frbSVa7pv6nQTXD4IhhyYjH3zYQIphZ6rBK+1YWc26sTfcioU+tHXot
-RSflMMFe8toTyyVCUZVHA4xsIcx0Qu1T/zOLjw9XARYvz6buyXAiFL39vmwLAw==
------END CERTIFICATE-----
-
 # Issuer: CN=XRamp Global Certification Authority O=XRamp Security Services Inc OU=www.xrampsecurity.com
 # Subject: CN=XRamp Global Certification Authority O=XRamp Security Services Inc OU=www.xrampsecurity.com
 # Label: "XRamp Global CA Root"
@@ -881,49 +853,6 @@ Mx86OyXShkDOOyyGeMlhLxS67ttVb9+E7gUJTb0o2HLO02JQZR7rkpeDMdmztcpH
 WD9f
 -----END CERTIFICATE-----
 
-# Issuer: CN=Autoridad de Certificacion Firmaprofesional CIF A62634068
-# Subject: CN=Autoridad de Certificacion Firmaprofesional CIF A62634068
-# Label: "Autoridad de Certificacion Firmaprofesional CIF A62634068"
-# Serial: 6047274297262753887
-# MD5 Fingerprint: 73:3a:74:7a:ec:bb:a3:96:a6:c2:e4:e2:c8:9b:c0:c3
-# SHA1 Fingerprint: ae:c5:fb:3f:c8:e1:bf:c4:e5:4f:03:07:5a:9a:e8:00:b7:f7:b6:fa
-# SHA256 Fingerprint: 04:04:80:28:bf:1f:28:64:d4:8f:9a:d4:d8:32:94:36:6a:82:88:56:55:3f:3b:14:30:3f:90:14:7f:5d:40:ef
------BEGIN CERTIFICATE-----
-MIIGFDCCA/ygAwIBAgIIU+w77vuySF8wDQYJKoZIhvcNAQEFBQAwUTELMAkGA1UE
-BhMCRVMxQjBABgNVBAMMOUF1dG9yaWRhZCBkZSBDZXJ0aWZpY2FjaW9uIEZpcm1h
-cHJvZmVzaW9uYWwgQ0lGIEE2MjYzNDA2ODAeFw0wOTA1MjAwODM4MTVaFw0zMDEy
-MzEwODM4MTVaMFExCzAJBgNVBAYTAkVTMUIwQAYDVQQDDDlBdXRvcmlkYWQgZGUg
-Q2VydGlmaWNhY2lvbiBGaXJtYXByb2Zlc2lvbmFsIENJRiBBNjI2MzQwNjgwggIi
-MA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDKlmuO6vj78aI14H9M2uDDUtd9
-thDIAl6zQyrET2qyyhxdKJp4ERppWVevtSBC5IsP5t9bpgOSL/UR5GLXMnE42QQM
-cas9UX4PB99jBVzpv5RvwSmCwLTaUbDBPLutN0pcyvFLNg4kq7/DhHf9qFD0sefG
-L9ItWY16Ck6WaVICqjaY7Pz6FIMMNx/Jkjd/14Et5cS54D40/mf0PmbR0/RAz15i
-NA9wBj4gGFrO93IbJWyTdBSTo3OxDqqHECNZXyAFGUftaI6SEspd/NYrspI8IM/h
-X68gvqB2f3bl7BqGYTM+53u0P6APjqK5am+5hyZvQWyIplD9amML9ZMWGxmPsu2b
-m8mQ9QEM3xk9Dz44I8kvjwzRAv4bVdZO0I08r0+k8/6vKtMFnXkIoctXMbScyJCy
-Z/QYFpM6/EfY0XiWMR+6KwxfXZmtY4laJCB22N/9q06mIqqdXuYnin1oKaPnirja
-EbsXLZmdEyRG98Xi2J+Of8ePdG1asuhy9azuJBCtLxTa/y2aRnFHvkLfuwHb9H/T
-KI8xWVvTyQKmtFLKbpf7Q8UIJm+K9Lv9nyiqDdVF8xM6HdjAeI9BZzwelGSuewvF
-6NkBiDkal4ZkQdU7hwxu+g/GvUgUvzlN1J5Bto+WHWOWk9mVBngxaJ43BjuAiUVh
-OSPHG0SjFeUc+JIwuwIDAQABo4HvMIHsMBIGA1UdEwEB/wQIMAYBAf8CAQEwDgYD
-VR0PAQH/BAQDAgEGMB0GA1UdDgQWBBRlzeurNR4APn7VdMActHNHDhpkLzCBpgYD
-VR0gBIGeMIGbMIGYBgRVHSAAMIGPMC8GCCsGAQUFBwIBFiNodHRwOi8vd3d3LmZp
-cm1hcHJvZmVzaW9uYWwuY29tL2NwczBcBggrBgEFBQcCAjBQHk4AUABhAHMAZQBv
-ACAAZABlACAAbABhACAAQgBvAG4AYQBuAG8AdgBhACAANAA3ACAAQgBhAHIAYwBl
-AGwAbwBuAGEAIAAwADgAMAAxADcwDQYJKoZIhvcNAQEFBQADggIBABd9oPm03cXF
-661LJLWhAqvdpYhKsg9VSytXjDvlMd3+xDLx51tkljYyGOylMnfX40S2wBEqgLk9
-am58m9Ot/MPWo+ZkKXzR4Tgegiv/J2Wv+xYVxC5xhOW1//qkR71kMrv2JYSiJ0L1
-ILDCExARzRAVukKQKtJE4ZYm6zFIEv0q2skGz3QeqUvVhyj5eTSSPi5E6PaPT481
-PyWzOdxjKpBrIF/EUhJOlywqrJ2X3kjyo2bbwtKDlaZmp54lD+kLM5FlClrD2VQS
-3a/DTg4fJl4N3LON7NWBcN7STyQF82xO9UxJZo3R/9ILJUFI/lGExkKvgATP0H5k
-SeTy36LssUzAKh3ntLFlosS88Zj0qnAHY7S42jtM+kAiMFsRpvAFDsYCA0irhpuF
-3dvd6qJ2gHN99ZwExEWN57kci57q13XRcrHedUTnQn3iV2t93Jm8PYMo6oCTjcVM
-ZcFwgbg4/EMxsvYDNEeyrPsiBsse3RdHHF9mudMaotoRsaS8I8nkvof/uZS2+F0g
-StRf571oe2XyFR7SOqkt6dhrJKyXWERHrVkY8SFlcN7ONGCoQPHzPKTDKCOM/icz
-Q0CgFzzr6juwcqajuUpLXhZI9LK8yIySxZ2frHI2vDSANGupi5LAuBft7HZT9SQB
-jLMi6Et8Vcad+qMUu2WFbm5PEn4KPJ2V
------END CERTIFICATE-----
-
 # Issuer: CN=Izenpe.com O=IZENPE S.A.
 # Subject: CN=Izenpe.com O=IZENPE S.A.
 # Label: "Izenpe.com"
@@ -4633,3 +4562,253 @@ o7Ey7Nmj1m+UI/87tyll5gfp77YZ6ufCOB0yiJA8EytuzO+rdwY0d4RPcuSBhPm5
 dDTedk+SKlOxJTnbPP/lPqYO5Wue/9vsL3SD3460s6neFE3/MaNFcyT6lSnMEpcE
 oji2jbDwN/zIIX8/syQbPYtuzE2wFg2WHYMfRsCbvUOZ58SWLs5fyQ==
 -----END CERTIFICATE-----
+
+# Issuer: CN=TrustAsia Global Root CA G3 O=TrustAsia Technologies, Inc.
+# Subject: CN=TrustAsia Global Root CA G3 O=TrustAsia Technologies, Inc.
+# Label: "TrustAsia Global Root CA G3"
+# Serial: 576386314500428537169965010905813481816650257167
+# MD5 Fingerprint: 30:42:1b:b7:bb:81:75:35:e4:16:4f:53:d2:94:de:04
+# SHA1 Fingerprint: 63:cf:b6:c1:27:2b:56:e4:88:8e:1c:23:9a:b6:2e:81:47:24:c3:c7
+# SHA256 Fingerprint: e0:d3:22:6a:eb:11:63:c2:e4:8f:f9:be:3b:50:b4:c6:43:1b:e7:bb:1e:ac:c5:c3:6b:5d:5e:c5:09:03:9a:08
+-----BEGIN CERTIFICATE-----
+MIIFpTCCA42gAwIBAgIUZPYOZXdhaqs7tOqFhLuxibhxkw8wDQYJKoZIhvcNAQEM
+BQAwWjELMAkGA1UEBhMCQ04xJTAjBgNVBAoMHFRydXN0QXNpYSBUZWNobm9sb2dp
+ZXMsIEluYy4xJDAiBgNVBAMMG1RydXN0QXNpYSBHbG9iYWwgUm9vdCBDQSBHMzAe
+Fw0yMTA1MjAwMjEwMTlaFw00NjA1MTkwMjEwMTlaMFoxCzAJBgNVBAYTAkNOMSUw
+IwYDVQQKDBxUcnVzdEFzaWEgVGVjaG5vbG9naWVzLCBJbmMuMSQwIgYDVQQDDBtU
+cnVzdEFzaWEgR2xvYmFsIFJvb3QgQ0EgRzMwggIiMA0GCSqGSIb3DQEBAQUAA4IC
+DwAwggIKAoICAQDAMYJhkuSUGwoqZdC+BqmHO1ES6nBBruL7dOoKjbmzTNyPtxNS
+T1QY4SxzlZHFZjtqz6xjbYdT8PfxObegQ2OwxANdV6nnRM7EoYNl9lA+sX4WuDqK
+AtCWHwDNBSHvBm3dIZwZQ0WhxeiAysKtQGIXBsaqvPPW5vxQfmZCHzyLpnl5hkA1
+nyDvP+uLRx+PjsXUjrYsyUQE49RDdT/VP68czH5GX6zfZBCK70bwkPAPLfSIC7Ep
+qq+FqklYqL9joDiR5rPmd2jE+SoZhLsO4fWvieylL1AgdB4SQXMeJNnKziyhWTXA
+yB1GJ2Faj/lN03J5Zh6fFZAhLf3ti1ZwA0pJPn9pMRJpxx5cynoTi+jm9WAPzJMs
+hH/x/Gr8m0ed262IPfN2dTPXS6TIi/n1Q1hPy8gDVI+lhXgEGvNz8teHHUGf59gX
+zhqcD0r83ERoVGjiQTz+LISGNzzNPy+i2+f3VANfWdP3kXjHi3dqFuVJhZBFcnAv
+kV34PmVACxmZySYgWmjBNb9Pp1Hx2BErW+Canig7CjoKH8GB5S7wprlppYiU5msT
+f9FkPz2ccEblooV7WIQn3MSAPmeamseaMQ4w7OYXQJXZRe0Blqq/DPNL0WP3E1jA
+uPP6Z92bfW1K/zJMtSU7/xxnD4UiWQWRkUF3gdCFTIcQcf+eQxuulXUtgQIDAQAB
+o2MwYTAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFEDk5PIj7zjKsK5Xf/Ih
+MBY027ySMB0GA1UdDgQWBBRA5OTyI+84yrCuV3/yITAWNNu8kjAOBgNVHQ8BAf8E
+BAMCAQYwDQYJKoZIhvcNAQEMBQADggIBACY7UeFNOPMyGLS0XuFlXsSUT9SnYaP4
+wM8zAQLpw6o1D/GUE3d3NZ4tVlFEbuHGLige/9rsR82XRBf34EzC4Xx8MnpmyFq2
+XFNFV1pF1AWZLy4jVe5jaN/TG3inEpQGAHUNcoTpLrxaatXeL1nHo+zSh2bbt1S1
+JKv0Q3jbSwTEb93mPmY+KfJLaHEih6D4sTNjduMNhXJEIlU/HHzp/LgV6FL6qj6j
+ITk1dImmasI5+njPtqzn59ZW/yOSLlALqbUHM/Q4X6RJpstlcHboCoWASzY9M/eV
+VHUl2qzEc4Jl6VL1XP04lQJqaTDFHApXB64ipCz5xUG3uOyfT0gA+QEEVcys+TIx
+xHWVBqB/0Y0n3bOppHKH/lmLmnp0Ft0WpWIp6zqW3IunaFnT63eROfjXy9mPX1on
+AX1daBli2MjN9LdyR75bl87yraKZk62Uy5P2EgmVtqvXO9A/EcswFi55gORngS1d
+7XB4tmBZrOFdRWOPyN9yaFvqHbgB8X7754qz41SgOAngPN5C8sLtLpvzHzW2Ntjj
+gKGLzZlkD8Kqq7HK9W+eQ42EVJmzbsASZthwEPEGNTNDqJwuuhQxzhB/HIbjj9LV
++Hfsm6vxL2PZQl/gZ4FkkfGXL/xuJvYz+NO1+MRiqzFRJQJ6+N1rZdVtTTDIZbpo
+FGWsJwt0ivKH
+-----END CERTIFICATE-----
+
+# Issuer: CN=TrustAsia Global Root CA G4 O=TrustAsia Technologies, Inc.
+# Subject: CN=TrustAsia Global Root CA G4 O=TrustAsia Technologies, Inc.
+# Label: "TrustAsia Global Root CA G4"
+# Serial: 451799571007117016466790293371524403291602933463
+# MD5 Fingerprint: 54:dd:b2:d7:5f:d8:3e:ed:7c:e0:0b:2e:cc:ed:eb:eb
+# SHA1 Fingerprint: 57:73:a5:61:5d:80:b2:e6:ac:38:82:fc:68:07:31:ac:9f:b5:92:5a
+# SHA256 Fingerprint: be:4b:56:cb:50:56:c0:13:6a:52:6d:f4:44:50:8d:aa:36:a0:b5:4f:42:e4:ac:38:f7:2a:f4:70:e4:79:65:4c
+-----BEGIN CERTIFICATE-----
+MIICVTCCAdygAwIBAgIUTyNkuI6XY57GU4HBdk7LKnQV1tcwCgYIKoZIzj0EAwMw
+WjELMAkGA1UEBhMCQ04xJTAjBgNVBAoMHFRydXN0QXNpYSBUZWNobm9sb2dpZXMs
+IEluYy4xJDAiBgNVBAMMG1RydXN0QXNpYSBHbG9iYWwgUm9vdCBDQSBHNDAeFw0y
+MTA1MjAwMjEwMjJaFw00NjA1MTkwMjEwMjJaMFoxCzAJBgNVBAYTAkNOMSUwIwYD
+VQQKDBxUcnVzdEFzaWEgVGVjaG5vbG9naWVzLCBJbmMuMSQwIgYDVQQDDBtUcnVz
+dEFzaWEgR2xvYmFsIFJvb3QgQ0EgRzQwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAATx
+s8045CVD5d4ZCbuBeaIVXxVjAd7Cq92zphtnS4CDr5nLrBfbK5bKfFJV4hrhPVbw
+LxYI+hW8m7tH5j/uqOFMjPXTNvk4XatwmkcN4oFBButJ+bAp3TPsUKV/eSm4IJij
+YzBhMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAUpbtKl86zK3+kMd6Xg1mD
+pm9xy94wHQYDVR0OBBYEFKW7SpfOsyt/pDHel4NZg6ZvccveMA4GA1UdDwEB/wQE
+AwIBBjAKBggqhkjOPQQDAwNnADBkAjBe8usGzEkxn0AAbbd+NvBNEU/zy4k6LHiR
+UKNbwMp1JvK/kF0LgoxgKJ/GcJpo5PECMFxYDlZ2z1jD1xCMuo6u47xkdUfFVZDj
+/bpV6wfEU6s3qe4hsiFbYI89MvHVI5TWWA==
+-----END CERTIFICATE-----
+
+# Issuer: CN=CommScope Public Trust ECC Root-01 O=CommScope
+# Subject: CN=CommScope Public Trust ECC Root-01 O=CommScope
+# Label: "CommScope Public Trust ECC Root-01"
+# Serial: 385011430473757362783587124273108818652468453534
+# MD5 Fingerprint: 3a:40:a7:fc:03:8c:9c:38:79:2f:3a:a2:6c:b6:0a:16
+# SHA1 Fingerprint: 07:86:c0:d8:dd:8e:c0:80:98:06:98:d0:58:7a:ef:de:a6:cc:a2:5d
+# SHA256 Fingerprint: 11:43:7c:da:7b:b4:5e:41:36:5f:45:b3:9a:38:98:6b:0d:e0:0d:ef:34:8e:0c:7b:b0:87:36:33:80:0b:c3:8b
+-----BEGIN CERTIFICATE-----
+MIICHTCCAaOgAwIBAgIUQ3CCd89NXTTxyq4yLzf39H91oJ4wCgYIKoZIzj0EAwMw
+TjELMAkGA1UEBhMCVVMxEjAQBgNVBAoMCUNvbW1TY29wZTErMCkGA1UEAwwiQ29t
+bVNjb3BlIFB1YmxpYyBUcnVzdCBFQ0MgUm9vdC0wMTAeFw0yMTA0MjgxNzM1NDNa
+Fw00NjA0MjgxNzM1NDJaME4xCzAJBgNVBAYTAlVTMRIwEAYDVQQKDAlDb21tU2Nv
+cGUxKzApBgNVBAMMIkNvbW1TY29wZSBQdWJsaWMgVHJ1c3QgRUNDIFJvb3QtMDEw
+djAQBgcqhkjOPQIBBgUrgQQAIgNiAARLNumuV16ocNfQj3Rid8NeeqrltqLxeP0C
+flfdkXmcbLlSiFS8LwS+uM32ENEp7LXQoMPwiXAZu1FlxUOcw5tjnSCDPgYLpkJE
+hRGnSjot6dZoL0hOUysHP029uax3OVejQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYD
+VR0PAQH/BAQDAgEGMB0GA1UdDgQWBBSOB2LAUN3GGQYARnQE9/OufXVNMDAKBggq
+hkjOPQQDAwNoADBlAjEAnDPfQeMjqEI2Jpc1XHvr20v4qotzVRVcrHgpD7oh2MSg
+2NED3W3ROT3Ek2DS43KyAjB8xX6I01D1HiXo+k515liWpDVfG2XqYZpwI7UNo5uS
+Um9poIyNStDuiw7LR47QjRE=
+-----END CERTIFICATE-----
+
+# Issuer: CN=CommScope Public Trust ECC Root-02 O=CommScope
+# Subject: CN=CommScope Public Trust ECC Root-02 O=CommScope
+# Label: "CommScope Public Trust ECC Root-02"
+# Serial: 234015080301808452132356021271193974922492992893
+# MD5 Fingerprint: 59:b0:44:d5:65:4d:b8:5c:55:19:92:02:b6:d1:94:b2
+# SHA1 Fingerprint: 3c:3f:ef:57:0f:fe:65:93:86:9e:a0:fe:b0:f6:ed:8e:d1:13:c7:e5
+# SHA256 Fingerprint: 2f:fb:7f:81:3b:bb:b3:c8:9a:b4:e8:16:2d:0f:16:d7:15:09:a8:30:cc:9d:73:c2:62:e5:14:08:75:d1:ad:4a
+-----BEGIN CERTIFICATE-----
+MIICHDCCAaOgAwIBAgIUKP2ZYEFHpgE6yhR7H+/5aAiDXX0wCgYIKoZIzj0EAwMw
+TjELMAkGA1UEBhMCVVMxEjAQBgNVBAoMCUNvbW1TY29wZTErMCkGA1UEAwwiQ29t
+bVNjb3BlIFB1YmxpYyBUcnVzdCBFQ0MgUm9vdC0wMjAeFw0yMTA0MjgxNzQ0NTRa
+Fw00NjA0MjgxNzQ0NTNaME4xCzAJBgNVBAYTAlVTMRIwEAYDVQQKDAlDb21tU2Nv
+cGUxKzApBgNVBAMMIkNvbW1TY29wZSBQdWJsaWMgVHJ1c3QgRUNDIFJvb3QtMDIw
+djAQBgcqhkjOPQIBBgUrgQQAIgNiAAR4MIHoYx7l63FRD/cHB8o5mXxO1Q/MMDAL
+j2aTPs+9xYa9+bG3tD60B8jzljHz7aRP+KNOjSkVWLjVb3/ubCK1sK9IRQq9qEmU
+v4RDsNuESgMjGWdqb8FuvAY5N9GIIvejQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYD
+VR0PAQH/BAQDAgEGMB0GA1UdDgQWBBTmGHX/72DehKT1RsfeSlXjMjZ59TAKBggq
+hkjOPQQDAwNnADBkAjAmc0l6tqvmSfR9Uj/UQQSugEODZXW5hYA4O9Zv5JOGq4/n
+ich/m35rChJVYaoR4HkCMHfoMXGsPHED1oQmHhS48zs73u1Z/GtMMH9ZzkXpc2AV
+mkzw5l4lIhVtwodZ0LKOag==
+-----END CERTIFICATE-----
+
+# Issuer: CN=CommScope Public Trust RSA Root-01 O=CommScope
+# Subject: CN=CommScope Public Trust RSA Root-01 O=CommScope
+# Label: "CommScope Public Trust RSA Root-01"
+# Serial: 354030733275608256394402989253558293562031411421
+# MD5 Fingerprint: 0e:b4:15:bc:87:63:5d:5d:02:73:d4:26:38:68:73:d8
+# SHA1 Fingerprint: 6d:0a:5f:f7:b4:23:06:b4:85:b3:b7:97:64:fc:ac:75:f5:33:f2:93
+# SHA256 Fingerprint: 02:bd:f9:6e:2a:45:dd:9b:f1:8f:c7:e1:db:df:21:a0:37:9b:a3:c9:c2:61:03:44:cf:d8:d6:06:fe:c1:ed:81
+-----BEGIN CERTIFICATE-----
+MIIFbDCCA1SgAwIBAgIUPgNJgXUWdDGOTKvVxZAplsU5EN0wDQYJKoZIhvcNAQEL
+BQAwTjELMAkGA1UEBhMCVVMxEjAQBgNVBAoMCUNvbW1TY29wZTErMCkGA1UEAwwi
+Q29tbVNjb3BlIFB1YmxpYyBUcnVzdCBSU0EgUm9vdC0wMTAeFw0yMTA0MjgxNjQ1
+NTRaFw00NjA0MjgxNjQ1NTNaME4xCzAJBgNVBAYTAlVTMRIwEAYDVQQKDAlDb21t
+U2NvcGUxKzApBgNVBAMMIkNvbW1TY29wZSBQdWJsaWMgVHJ1c3QgUlNBIFJvb3Qt
+MDEwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCwSGWjDR1C45FtnYSk
+YZYSwu3D2iM0GXb26v1VWvZVAVMP8syMl0+5UMuzAURWlv2bKOx7dAvnQmtVzslh
+suitQDy6uUEKBU8bJoWPQ7VAtYXR1HHcg0Hz9kXHgKKEUJdGzqAMxGBWBB0HW0al
+DrJLpA6lfO741GIDuZNqihS4cPgugkY4Iw50x2tBt9Apo52AsH53k2NC+zSDO3Oj
+WiE260f6GBfZumbCk6SP/F2krfxQapWsvCQz0b2If4b19bJzKo98rwjyGpg/qYFl
+P8GMicWWMJoKz/TUyDTtnS+8jTiGU+6Xn6myY5QXjQ/cZip8UlF1y5mO6D1cv547
+KI2DAg+pn3LiLCuz3GaXAEDQpFSOm117RTYm1nJD68/A6g3czhLmfTifBSeolz7p
+UcZsBSjBAg/pGG3svZwG1KdJ9FQFa2ww8esD1eo9anbCyxooSU1/ZOD6K9pzg4H/
+kQO9lLvkuI6cMmPNn7togbGEW682v3fuHX/3SZtS7NJ3Wn2RnU3COS3kuoL4b/JO
+Hg9O5j9ZpSPcPYeoKFgo0fEbNttPxP/hjFtyjMcmAyejOQoBqsCyMWCDIqFPEgkB
+Ea801M/XrmLTBQe0MXXgDW1XT2mH+VepuhX2yFJtocucH+X8eKg1mp9BFM6ltM6U
+CBwJrVbl2rZJmkrqYxhTnCwuwwIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MA4G
+A1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQUN12mmnQywsL5x6YVEFm45P3luG0wDQYJ
+KoZIhvcNAQELBQADggIBAK+nz97/4L1CjU3lIpbfaOp9TSp90K09FlxD533Ahuh6
+NWPxzIHIxgvoLlI1pKZJkGNRrDSsBTtXAOnTYtPZKdVUvhwQkZyybf5Z/Xn36lbQ
+nmhUQo8mUuJM3y+Xpi/SB5io82BdS5pYV4jvguX6r2yBS5KPQJqTRlnLX3gWsWc+
+QgvfKNmwrZggvkN80V4aCRckjXtdlemrwWCrWxhkgPut4AZ9HcpZuPN4KWfGVh2v
+trV0KnahP/t1MJ+UXjulYPPLXAziDslg+MkfFoom3ecnf+slpoq9uC02EJqxWE2a
+aE9gVOX2RhOOiKy8IUISrcZKiX2bwdgt6ZYD9KJ0DLwAHb/WNyVntHKLr4W96ioD
+j8z7PEQkguIBpQtZtjSNMgsSDesnwv1B10A8ckYpwIzqug/xBpMu95yo9GA+o/E4
+Xo4TwbM6l4c/ksp4qRyv0LAbJh6+cOx69TOY6lz/KwsETkPdY34Op054A5U+1C0w
+lREQKC6/oAI+/15Z0wUOlV9TRe9rh9VIzRamloPh37MG88EU26fsHItdkJANclHn
+YfkUyq+Dj7+vsQpZXdxc1+SWrVtgHdqul7I52Qb1dgAT+GhMIbA1xNxVssnBQVoc
+icCMb3SgazNNtQEo/a2tiRc7ppqEvOuM6sRxJKi6KfkIsidWNTJf6jn7MZrVGczw
+-----END CERTIFICATE-----
+
+# Issuer: CN=CommScope Public Trust RSA Root-02 O=CommScope
+# Subject: CN=CommScope Public Trust RSA Root-02 O=CommScope
+# Label: "CommScope Public Trust RSA Root-02"
+# Serial: 480062499834624527752716769107743131258796508494
+# MD5 Fingerprint: e1:29:f9:62:7b:76:e2:96:6d:f3:d4:d7:0f:ae:1f:aa
+# SHA1 Fingerprint: ea:b0:e2:52:1b:89:93:4c:11:68:f2:d8:9a:ac:22:4c:a3:8a:57:ae
+# SHA256 Fingerprint: ff:e9:43:d7:93:42:4b:4f:7c:44:0c:1c:3d:64:8d:53:63:f3:4b:82:dc:87:aa:7a:9f:11:8f:c5:de:e1:01:f1
+-----BEGIN CERTIFICATE-----
+MIIFbDCCA1SgAwIBAgIUVBa/O345lXGN0aoApYYNK496BU4wDQYJKoZIhvcNAQEL
+BQAwTjELMAkGA1UEBhMCVVMxEjAQBgNVBAoMCUNvbW1TY29wZTErMCkGA1UEAwwi
+Q29tbVNjb3BlIFB1YmxpYyBUcnVzdCBSU0EgUm9vdC0wMjAeFw0yMTA0MjgxNzE2
+NDNaFw00NjA0MjgxNzE2NDJaME4xCzAJBgNVBAYTAlVTMRIwEAYDVQQKDAlDb21t
+U2NvcGUxKzApBgNVBAMMIkNvbW1TY29wZSBQdWJsaWMgVHJ1c3QgUlNBIFJvb3Qt
+MDIwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDh+g77aAASyE3VrCLE
+NQE7xVTlWXZjpX/rwcRqmL0yjReA61260WI9JSMZNRTpf4mnG2I81lDnNJUDMrG0
+kyI9p+Kx7eZ7Ti6Hmw0zdQreqjXnfuU2mKKuJZ6VszKWpCtYHu8//mI0SFHRtI1C
+rWDaSWqVcN3SAOLMV2MCe5bdSZdbkk6V0/nLKR8YSvgBKtJjCW4k6YnS5cciTNxz
+hkcAqg2Ijq6FfUrpuzNPDlJwnZXjfG2WWy09X6GDRl224yW4fKcZgBzqZUPckXk2
+LHR88mcGyYnJ27/aaL8j7dxrrSiDeS/sOKUNNwFnJ5rpM9kzXzehxfCrPfp4sOcs
+n/Y+n2Dg70jpkEUeBVF4GiwSLFworA2iI540jwXmojPOEXcT1A6kHkIfhs1w/tku
+FT0du7jyU1fbzMZ0KZwYszZ1OC4PVKH4kh+Jlk+71O6d6Ts2QrUKOyrUZHk2EOH5
+kQMreyBUzQ0ZGshBMjTRsJnhkB4BQDa1t/qp5Xd1pCKBXbCL5CcSD1SIxtuFdOa3
+wNemKfrb3vOTlycEVS8KbzfFPROvCgCpLIscgSjX74Yxqa7ybrjKaixUR9gqiC6v
+wQcQeKwRoi9C8DfF8rhW3Q5iLc4tVn5V8qdE9isy9COoR+jUKgF4z2rDN6ieZdIs
+5fq6M8EGRPbmz6UNp2YINIos8wIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MA4G
+A1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQUR9DnsSL/nSz12Vdgs7GxcJXvYXowDQYJ
+KoZIhvcNAQELBQADggIBAIZpsU0v6Z9PIpNojuQhmaPORVMbc0RTAIFhzTHjCLqB
+KCh6krm2qMhDnscTJk3C2OVVnJJdUNjCK9v+5qiXz1I6JMNlZFxHMaNlNRPDk7n3
++VGXu6TwYofF1gbTl4MgqX67tiHCpQ2EAOHyJxCDut0DgdXdaMNmEMjRdrSzbyme
+APnCKfWxkxlSaRosTKCL4BWaMS/TiJVZbuXEs1DIFAhKm4sTg7GkcrI7djNB3Nyq
+pgdvHSQSn8h2vS/ZjvQs7rfSOBAkNlEv41xdgSGn2rtO/+YHqP65DSdsu3BaVXoT
+6fEqSWnHX4dXTEN5bTpl6TBcQe7rd6VzEojov32u5cSoHw2OHG1QAk8mGEPej1WF
+sQs3BWDJVTkSBKEqz3EWnzZRSb9wO55nnPt7eck5HHisd5FUmrh1CoFSl+NmYWvt
+PjgelmFV4ZFUjO2MJB+ByRCac5krFk5yAD9UG/iNuovnFNa2RU9g7Jauwy8CTl2d
+lklyALKrdVwPaFsdZcJfMw8eD/A7hvWwTruc9+olBdytoptLFwG+Qt81IR2tq670
+v64fG9PiO/yzcnMcmyiQiRM9HcEARwmWmjgb3bHPDcK0RPOWlc4yOo80nOAXx17O
+rg3bhzjlP1v9mxnhMUF6cKojawHhRUzNlM47ni3niAIi9G7oyOzWPPO5std3eqx7
+-----END CERTIFICATE-----
+
+# Issuer: CN=Telekom Security TLS ECC Root 2020 O=Deutsche Telekom Security GmbH
+# Subject: CN=Telekom Security TLS ECC Root 2020 O=Deutsche Telekom Security GmbH
+# Label: "Telekom Security TLS ECC Root 2020"
+# Serial: 72082518505882327255703894282316633856
+# MD5 Fingerprint: c1:ab:fe:6a:10:2c:03:8d:bc:1c:22:32:c0:85:a7:fd
+# SHA1 Fingerprint: c0:f8:96:c5:a9:3b:01:06:21:07:da:18:42:48:bc:e9:9d:88:d5:ec
+# SHA256 Fingerprint: 57:8a:f4:de:d0:85:3f:4e:59:98:db:4a:ea:f9:cb:ea:8d:94:5f:60:b6:20:a3:8d:1a:3c:13:b2:bc:7b:a8:e1
+-----BEGIN CERTIFICATE-----
+MIICQjCCAcmgAwIBAgIQNjqWjMlcsljN0AFdxeVXADAKBggqhkjOPQQDAzBjMQsw
+CQYDVQQGEwJERTEnMCUGA1UECgweRGV1dHNjaGUgVGVsZWtvbSBTZWN1cml0eSBH
+bWJIMSswKQYDVQQDDCJUZWxla29tIFNlY3VyaXR5IFRMUyBFQ0MgUm9vdCAyMDIw
+MB4XDTIwMDgyNTA3NDgyMFoXDTQ1MDgyNTIzNTk1OVowYzELMAkGA1UEBhMCREUx
+JzAlBgNVBAoMHkRldXRzY2hlIFRlbGVrb20gU2VjdXJpdHkgR21iSDErMCkGA1UE
+AwwiVGVsZWtvbSBTZWN1cml0eSBUTFMgRUNDIFJvb3QgMjAyMDB2MBAGByqGSM49
+AgEGBSuBBAAiA2IABM6//leov9Wq9xCazbzREaK9Z0LMkOsVGJDZos0MKiXrPk/O
+tdKPD/M12kOLAoC+b1EkHQ9rK8qfwm9QMuU3ILYg/4gND21Ju9sGpIeQkpT0CdDP
+f8iAC8GXs7s1J8nCG6NCMEAwHQYDVR0OBBYEFONyzG6VmUex5rNhTNHLq+O6zd6f
+MA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMAoGCCqGSM49BAMDA2cA
+MGQCMHVSi7ekEE+uShCLsoRbQuHmKjYC2qBuGT8lv9pZMo7k+5Dck2TOrbRBR2Di
+z6fLHgIwN0GMZt9Ba9aDAEH9L1r3ULRn0SyocddDypwnJJGDSA3PzfdUga/sf+Rn
+27iQ7t0l
+-----END CERTIFICATE-----
+
+# Issuer: CN=Telekom Security TLS RSA Root 2023 O=Deutsche Telekom Security GmbH
+# Subject: CN=Telekom Security TLS RSA Root 2023 O=Deutsche Telekom Security GmbH
+# Label: "Telekom Security TLS RSA Root 2023"
+# Serial: 44676229530606711399881795178081572759
+# MD5 Fingerprint: bf:5b:eb:54:40:cd:48:71:c4:20:8d:7d:de:0a:42:f2
+# SHA1 Fingerprint: 54:d3:ac:b3:bd:57:56:f6:85:9d:ce:e5:c3:21:e2:d4:ad:83:d0:93
+# SHA256 Fingerprint: ef:c6:5c:ad:bb:59:ad:b6:ef:e8:4d:a2:23:11:b3:56:24:b7:1b:3b:1e:a0:da:8b:66:55:17:4e:c8:97:86:46
+-----BEGIN CERTIFICATE-----
+MIIFszCCA5ugAwIBAgIQIZxULej27HF3+k7ow3BXlzANBgkqhkiG9w0BAQwFADBj
+MQswCQYDVQQGEwJERTEnMCUGA1UECgweRGV1dHNjaGUgVGVsZWtvbSBTZWN1cml0
+eSBHbWJIMSswKQYDVQQDDCJUZWxla29tIFNlY3VyaXR5IFRMUyBSU0EgUm9vdCAy
+MDIzMB4XDTIzMDMyODEyMTY0NVoXDTQ4MDMyNzIzNTk1OVowYzELMAkGA1UEBhMC
+REUxJzAlBgNVBAoMHkRldXRzY2hlIFRlbGVrb20gU2VjdXJpdHkgR21iSDErMCkG
+A1UEAwwiVGVsZWtvbSBTZWN1cml0eSBUTFMgUlNBIFJvb3QgMjAyMzCCAiIwDQYJ
+KoZIhvcNAQEBBQADggIPADCCAgoCggIBAO01oYGA88tKaVvC+1GDrib94W7zgRJ9
+cUD/h3VCKSHtgVIs3xLBGYSJwb3FKNXVS2xE1kzbB5ZKVXrKNoIENqil/Cf2SfHV
+cp6R+SPWcHu79ZvB7JPPGeplfohwoHP89v+1VmLhc2o0mD6CuKyVU/QBoCcHcqMA
+U6DksquDOFczJZSfvkgdmOGjup5czQRxUX11eKvzWarE4GC+j4NSuHUaQTXtvPM6
+Y+mpFEXX5lLRbtLevOP1Czvm4MS9Q2QTps70mDdsipWol8hHD/BeEIvnHRz+sTug
+BTNoBUGCwQMrAcjnj02r6LX2zWtEtefdi+zqJbQAIldNsLGyMcEWzv/9FIS3R/qy
+8XDe24tsNlikfLMR0cN3f1+2JeANxdKz+bi4d9s3cXFH42AYTyS2dTd4uaNir73J
+co4vzLuu2+QVUhkHM/tqty1LkCiCc/4YizWN26cEar7qwU02OxY2kTLvtkCJkUPg
+8qKrBC7m8kwOFjQgrIfBLX7JZkcXFBGk8/ehJImr2BrIoVyxo/eMbcgByU/J7MT8
+rFEz0ciD0cmfHdRHNCk+y7AO+oMLKFjlKdw/fKifybYKu6boRhYPluV75Gp6SG12
+mAWl3G0eQh5C2hrgUve1g8Aae3g1LDj1H/1Joy7SWWO/gLCMk3PLNaaZlSJhZQNg
++y+TS/qanIA7AgMBAAGjYzBhMA4GA1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQUtqeX
+gj10hZv3PJ+TmpV5dVKMbUcwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBS2
+p5eCPXSFm/c8n5OalXl1UoxtRzANBgkqhkiG9w0BAQwFAAOCAgEAqMxhpr51nhVQ
+pGv7qHBFfLp+sVr8WyP6Cnf4mHGCDG3gXkaqk/QeoMPhk9tLrbKmXauw1GLLXrtm
+9S3ul0A8Yute1hTWjOKWi0FpkzXmuZlrYrShF2Y0pmtjxrlO8iLpWA1WQdH6DErw
+M807u20hOq6OcrXDSvvpfeWxm4bu4uB9tPcy/SKE8YXJN3nptT+/XOR0so8RYgDd
+GGah2XsjX/GO1WfoVNpbOms2b/mBsTNHM3dA+VKq3dSDz4V4mZqTuXNnQkYRIer+
+CqkbGmVps4+uFrb2S1ayLfmlyOw7YqPta9BO1UAJpB+Y1zqlklkg5LB9zVtzaL1t
+xKITDmcZuI1CfmwMmm6gJC3VRRvcxAIU/oVbZZfKTpBQCHpCNfnqwmbU+AGuHrS+
+w6jv/naaoqYfRvaE7fzbzsQCzndILIyy7MMAo+wsVRjBfhnu4S/yrYObnqsZ38aK
+L4x35bcF7DvB7L6Gs4a8wPfc5+pbrrLMtTWGS9DiP7bY+A4A7l3j941Y/8+LN+lj
+X273CXE2whJdV/LItM3z7gLfEdxquVeEHVlNjM7IDiPCtyaaEBRx/pOyiriA8A4Q
+ntOoUAw3gi/q4Iqd4Sw5/7W0cwDk90imc6y/st53BIe0o82bNSQ3+pCTE4FCxpgm
+dTdmQRCsu/WU48IxK63nI1bMNSWSs1A=
+-----END CERTIFICATE-----
diff --git a/lib/certifi/core.py b/lib/certifi/core.py
index de028981..91f538bb 100644
--- a/lib/certifi/core.py
+++ b/lib/certifi/core.py
@@ -5,6 +5,10 @@ certifi.py
 This module returns the installation location of cacert.pem or its contents.
 """
 import sys
+import atexit
+
+def exit_cacert_ctx() -> None:
+    _CACERT_CTX.__exit__(None, None, None)  # type: ignore[union-attr]
 
 
 if sys.version_info >= (3, 11):
@@ -35,6 +39,7 @@ if sys.version_info >= (3, 11):
             # we will also store that at the global level as well.
             _CACERT_CTX = as_file(files("certifi").joinpath("cacert.pem"))
             _CACERT_PATH = str(_CACERT_CTX.__enter__())
+            atexit.register(exit_cacert_ctx)
 
         return _CACERT_PATH
 
@@ -70,6 +75,7 @@ elif sys.version_info >= (3, 7):
             # we will also store that at the global level as well.
             _CACERT_CTX = get_path("certifi", "cacert.pem")
             _CACERT_PATH = str(_CACERT_CTX.__enter__())
+            atexit.register(exit_cacert_ctx)
 
         return _CACERT_PATH
 
diff --git a/requirements.txt b/requirements.txt
index 32bd430e..53efa2e8 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -5,7 +5,7 @@ backports.functools-lru-cache==1.6.6
 backports.zoneinfo==0.2.1;python_version<"3.9"
 beautifulsoup4==4.12.2
 bleach==6.1.0
-certifi==2023.7.22
+certifi==2024.2.2
 cheroot==10.0.0
 cherrypy==18.8.0
 cloudinary==1.34.0

From 13eb0fd6dbd2fe3efc108b3363979ad3e4b2d66d Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sun, 24 Mar 2024 15:23:44 -0700
Subject: [PATCH 535/743] Bump platformdirs from 3.11.0 to 4.2.0 (#2258)

* Bump platformdirs from 3.11.0 to 4.2.0

Bumps [platformdirs](https://github.com/platformdirs/platformdirs) from 3.11.0 to 4.2.0.
- [Release notes](https://github.com/platformdirs/platformdirs/releases)
- [Changelog](https://github.com/platformdirs/platformdirs/blob/main/CHANGES.rst)
- [Commits](https://github.com/platformdirs/platformdirs/compare/3.11.0...4.2.0)

---
updated-dependencies:
- dependency-name: platformdirs
  dependency-type: direct:production
  update-type: version-update:semver-major
...

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

* Update platformdirs==4.2.0

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/platformdirs/__init__.py |  7 ++--
 lib/platformdirs/__main__.py |  1 +
 lib/platformdirs/android.py  |  1 +
 lib/platformdirs/api.py      | 48 ++++++++++++++++++++++----
 lib/platformdirs/macos.py    |  1 +
 lib/platformdirs/unix.py     | 65 +++++++++++++++++++++++-------------
 lib/platformdirs/version.py  |  4 +--
 lib/platformdirs/windows.py  |  1 +
 requirements.txt             |  2 +-
 9 files changed, 93 insertions(+), 37 deletions(-)

diff --git a/lib/platformdirs/__init__.py b/lib/platformdirs/__init__.py
index 3d5a5bda..75c8bff9 100644
--- a/lib/platformdirs/__init__.py
+++ b/lib/platformdirs/__init__.py
@@ -2,6 +2,7 @@
 Utilities for determining application-specific dirs. See <https://github.com/platformdirs/platformdirs> for details and
 usage.
 """
+
 from __future__ import annotations
 
 import os
@@ -14,11 +15,7 @@ from .version import __version_tuple__ as __version_info__
 
 if TYPE_CHECKING:
     from pathlib import Path
-
-    if sys.version_info >= (3, 8):  # pragma: no cover (py38+)
-        from typing import Literal
-    else:  # pragma: no cover (py38+)
-        from typing_extensions import Literal
+    from typing import Literal
 
 
 def _set_platform_dir_class() -> type[PlatformDirsABC]:
diff --git a/lib/platformdirs/__main__.py b/lib/platformdirs/__main__.py
index 3cefedbd..4bf27c9c 100644
--- a/lib/platformdirs/__main__.py
+++ b/lib/platformdirs/__main__.py
@@ -1,4 +1,5 @@
 """Main entry point."""
+
 from __future__ import annotations
 
 from platformdirs import PlatformDirs, __version__
diff --git a/lib/platformdirs/android.py b/lib/platformdirs/android.py
index 572559f8..4acdb638 100644
--- a/lib/platformdirs/android.py
+++ b/lib/platformdirs/android.py
@@ -1,4 +1,5 @@
 """Android."""
+
 from __future__ import annotations
 
 import os
diff --git a/lib/platformdirs/api.py b/lib/platformdirs/api.py
index aa9ce7b9..031a38a3 100644
--- a/lib/platformdirs/api.py
+++ b/lib/platformdirs/api.py
@@ -1,4 +1,5 @@
 """Base API."""
+
 from __future__ import annotations
 
 import os
@@ -7,12 +8,7 @@ from pathlib import Path
 from typing import TYPE_CHECKING
 
 if TYPE_CHECKING:
-    import sys
-
-    if sys.version_info >= (3, 8):  # pragma: no cover (py38+)
-        from typing import Literal
-    else:  # pragma: no cover (py38+)
-        from typing_extensions import Literal
+    from typing import Iterator, Literal
 
 
 class PlatformDirsABC(ABC):
@@ -241,3 +237,43 @@ class PlatformDirsABC(ABC):
     def site_runtime_path(self) -> Path:
         """:return: runtime path shared by users"""
         return Path(self.site_runtime_dir)
+
+    def iter_config_dirs(self) -> Iterator[str]:
+        """:yield: all user and site configuration directories."""
+        yield self.user_config_dir
+        yield self.site_config_dir
+
+    def iter_data_dirs(self) -> Iterator[str]:
+        """:yield: all user and site data directories."""
+        yield self.user_data_dir
+        yield self.site_data_dir
+
+    def iter_cache_dirs(self) -> Iterator[str]:
+        """:yield: all user and site cache directories."""
+        yield self.user_cache_dir
+        yield self.site_cache_dir
+
+    def iter_runtime_dirs(self) -> Iterator[str]:
+        """:yield: all user and site runtime directories."""
+        yield self.user_runtime_dir
+        yield self.site_runtime_dir
+
+    def iter_config_paths(self) -> Iterator[Path]:
+        """:yield: all user and site configuration paths."""
+        for path in self.iter_config_dirs():
+            yield Path(path)
+
+    def iter_data_paths(self) -> Iterator[Path]:
+        """:yield: all user and site data paths."""
+        for path in self.iter_data_dirs():
+            yield Path(path)
+
+    def iter_cache_paths(self) -> Iterator[Path]:
+        """:yield: all user and site cache paths."""
+        for path in self.iter_cache_dirs():
+            yield Path(path)
+
+    def iter_runtime_paths(self) -> Iterator[Path]:
+        """:yield: all user and site runtime paths."""
+        for path in self.iter_runtime_dirs():
+            yield Path(path)
diff --git a/lib/platformdirs/macos.py b/lib/platformdirs/macos.py
index c01ce163..b7b48808 100644
--- a/lib/platformdirs/macos.py
+++ b/lib/platformdirs/macos.py
@@ -1,4 +1,5 @@
 """macOS."""
+
 from __future__ import annotations
 
 import os.path
diff --git a/lib/platformdirs/unix.py b/lib/platformdirs/unix.py
index 1d0174f2..ca4728e6 100644
--- a/lib/platformdirs/unix.py
+++ b/lib/platformdirs/unix.py
@@ -1,10 +1,12 @@
 """Unix."""
+
 from __future__ import annotations
 
 import os
 import sys
 from configparser import ConfigParser
 from pathlib import Path
+from typing import Iterator
 
 from .api import PlatformDirsABC
 
@@ -43,24 +45,24 @@ class Unix(PlatformDirsABC):
         return self._append_app_name_and_version(path)
 
     @property
-    def site_data_dir(self) -> str:
-        """
-        :return: data directories shared by users (if `multipath <platformdirs.api.PlatformDirsABC.multipath>` is
-         enabled and ``XDG_DATA_DIR`` is set and a multi path the response is also a multi path separated by the OS
-         path separator), e.g. ``/usr/local/share/$appname/$version`` or ``/usr/share/$appname/$version``
-        """
-        # XDG default for $XDG_DATA_DIRS; only first, if multipath is False
+    def _site_data_dirs(self) -> list[str]:
         path = os.environ.get("XDG_DATA_DIRS", "")
         if not path.strip():
             path = f"/usr/local/share{os.pathsep}/usr/share"
-        return self._with_multi_path(path)
+        return [self._append_app_name_and_version(p) for p in path.split(os.pathsep)]
 
-    def _with_multi_path(self, path: str) -> str:
-        path_list = path.split(os.pathsep)
+    @property
+    def site_data_dir(self) -> str:
+        """
+        :return: data directories shared by users (if `multipath <platformdirs.api.PlatformDirsABC.multipath>` is
+         enabled and ``XDG_DATA_DIRS`` is set and a multi path the response is also a multi path separated by the
+         OS path separator), e.g. ``/usr/local/share/$appname/$version`` or ``/usr/share/$appname/$version``
+        """
+        # XDG default for $XDG_DATA_DIRS; only first, if multipath is False
+        dirs = self._site_data_dirs
         if not self.multipath:
-            path_list = path_list[0:1]
-        path_list = [self._append_app_name_and_version(os.path.expanduser(p)) for p in path_list]  # noqa: PTH111
-        return os.pathsep.join(path_list)
+            return dirs[0]
+        return os.pathsep.join(dirs)
 
     @property
     def user_config_dir(self) -> str:
@@ -74,17 +76,24 @@ class Unix(PlatformDirsABC):
         return self._append_app_name_and_version(path)
 
     @property
-    def site_config_dir(self) -> str:
-        """
-        :return: config directories shared by users (if `multipath <platformdirs.api.PlatformDirsABC.multipath>`
-         is enabled and ``XDG_DATA_DIR`` is set and a multi path the response is also a multi path separated by the OS
-         path separator), e.g. ``/etc/xdg/$appname/$version``
-        """
-        # XDG default for $XDG_CONFIG_DIRS only first, if multipath is False
+    def _site_config_dirs(self) -> list[str]:
         path = os.environ.get("XDG_CONFIG_DIRS", "")
         if not path.strip():
             path = "/etc/xdg"
-        return self._with_multi_path(path)
+        return [self._append_app_name_and_version(p) for p in path.split(os.pathsep)]
+
+    @property
+    def site_config_dir(self) -> str:
+        """
+        :return: config directories shared by users (if `multipath <platformdirs.api.PlatformDirsABC.multipath>`
+         is enabled and ``XDG_CONFIG_DIRS`` is set and a multi path the response is also a multi path separated by
+         the OS path separator), e.g. ``/etc/xdg/$appname/$version``
+        """
+        # XDG default for $XDG_CONFIG_DIRS only first, if multipath is False
+        dirs = self._site_config_dirs
+        if not self.multipath:
+            return dirs[0]
+        return os.pathsep.join(dirs)
 
     @property
     def user_cache_dir(self) -> str:
@@ -99,8 +108,8 @@ class Unix(PlatformDirsABC):
 
     @property
     def site_cache_dir(self) -> str:
-        """:return: cache directory shared by users, e.g. ``/var/tmp/$appname/$version``"""
-        return self._append_app_name_and_version("/var/tmp")  # noqa: S108
+        """:return: cache directory shared by users, e.g. ``/var/cache/$appname/$version``"""
+        return self._append_app_name_and_version("/var/cache")
 
     @property
     def user_state_dir(self) -> str:
@@ -215,6 +224,16 @@ class Unix(PlatformDirsABC):
             directory = directory.split(os.pathsep)[0]
         return Path(directory)
 
+    def iter_config_dirs(self) -> Iterator[str]:
+        """:yield: all user and site configuration directories."""
+        yield self.user_config_dir
+        yield from self._site_config_dirs
+
+    def iter_data_dirs(self) -> Iterator[str]:
+        """:yield: all user and site data directories."""
+        yield self.user_data_dir
+        yield from self._site_data_dirs
+
 
 def _get_user_media_dir(env_var: str, fallback_tilde_path: str) -> str:
     media_dir = _get_user_dirs_folder(env_var)
diff --git a/lib/platformdirs/version.py b/lib/platformdirs/version.py
index c2ef2084..cc1e3456 100644
--- a/lib/platformdirs/version.py
+++ b/lib/platformdirs/version.py
@@ -12,5 +12,5 @@ __version__: str
 __version_tuple__: VERSION_TUPLE
 version_tuple: VERSION_TUPLE
 
-__version__ = version = '3.11.0'
-__version_tuple__ = version_tuple = (3, 11, 0)
+__version__ = version = '4.2.0'
+__version_tuple__ = version_tuple = (4, 2, 0)
diff --git a/lib/platformdirs/windows.py b/lib/platformdirs/windows.py
index 751143ad..c62d0c8d 100644
--- a/lib/platformdirs/windows.py
+++ b/lib/platformdirs/windows.py
@@ -1,4 +1,5 @@
 """Windows."""
+
 from __future__ import annotations
 
 import ctypes
diff --git a/requirements.txt b/requirements.txt
index 53efa2e8..a1f27d23 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -27,7 +27,7 @@ MarkupSafe==2.1.3
 musicbrainzngs==0.7.1
 packaging==23.1
 paho-mqtt==1.6.1
-platformdirs==3.11.0
+platformdirs==4.2.0
 plexapi==4.15.10
 portend==3.2.0
 profilehooks==1.12.0

From b7836102a9323bb740559ba2e8ee590e543b8a7c Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sun, 24 Mar 2024 15:24:05 -0700
Subject: [PATCH 536/743] Bump backports-functools-lru-cache from 1.6.6 to
 2.0.0 (#2263)

* Bump backports-functools-lru-cache from 1.6.6 to 2.0.0

Bumps [backports-functools-lru-cache](https://github.com/jaraco/backports.functools_lru_cache) from 1.6.6 to 2.0.0.
- [Release notes](https://github.com/jaraco/backports.functools_lru_cache/releases)
- [Changelog](https://github.com/jaraco/backports.functools_lru_cache/blob/main/NEWS.rst)
- [Commits](https://github.com/jaraco/backports.functools_lru_cache/compare/v1.6.6...v2.0.0)

---
updated-dependencies:
- dependency-name: backports-functools-lru-cache
  dependency-type: direct:production
  update-type: version-update:semver-major
...

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

* Update backports-functools-lru-cache==2.0.0

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/backports/functools_lru_cache.py | 274 ++++++++++++++++-----------
 requirements.txt                     |   2 +-
 2 files changed, 162 insertions(+), 114 deletions(-)

diff --git a/lib/backports/functools_lru_cache.py b/lib/backports/functools_lru_cache.py
index 1b83fe99..e372cff3 100644
--- a/lib/backports/functools_lru_cache.py
+++ b/lib/backports/functools_lru_cache.py
@@ -26,6 +26,12 @@ def update_wrapper(
 
 
 class _HashedSeq(list):
+    """This class guarantees that hash() will be called no more than once
+    per element.  This is important because the lru_cache() will hash
+    the key multiple times on a cache miss.
+
+    """
+
     __slots__ = 'hashvalue'
 
     def __init__(self, tup, hash=hash):
@@ -41,45 +47,57 @@ def _make_key(
     kwds,
     typed,
     kwd_mark=(object(),),
-    fasttypes=set([int, str, frozenset, type(None)]),
-    sorted=sorted,
+    fasttypes={int, str},
     tuple=tuple,
     type=type,
     len=len,
 ):
-    'Make a cache key from optionally typed positional and keyword arguments'
+    """Make a cache key from optionally typed positional and keyword arguments
+
+    The key is constructed in a way that is flat as possible rather than
+    as a nested structure that would take more memory.
+
+    If there is only a single argument and its data type is known to cache
+    its hash value, then that argument is returned without a wrapper.  This
+    saves space and improves lookup speed.
+
+    """
+    # All of code below relies on kwds preserving the order input by the user.
+    # Formerly, we sorted() the kwds before looping.  The new way is *much*
+    # faster; however, it means that f(x=1, y=2) will now be treated as a
+    # distinct call from f(y=2, x=1) which will be cached separately.
     key = args
     if kwds:
-        sorted_items = sorted(kwds.items())
         key += kwd_mark
-        for item in sorted_items:
+        for item in kwds.items():
             key += item
     if typed:
         key += tuple(type(v) for v in args)
         if kwds:
-            key += tuple(type(v) for k, v in sorted_items)
+            key += tuple(type(v) for v in kwds.values())
     elif len(key) == 1 and type(key[0]) in fasttypes:
         return key[0]
     return _HashedSeq(key)
 
 
-def lru_cache(maxsize=100, typed=False):  # noqa: C901
+def lru_cache(maxsize=128, typed=False):
     """Least-recently-used cache decorator.
 
     If *maxsize* is set to None, the LRU features are disabled and the cache
     can grow without bound.
 
     If *typed* is True, arguments of different types will be cached separately.
-    For example, f(3.0) and f(3) will be treated as distinct calls with
-    distinct results.
+    For example, f(decimal.Decimal("3.0")) and f(3.0) will be treated as
+    distinct calls with distinct results. Some types such as str and int may
+    be cached separately even when typed is false.
 
     Arguments to the cached function must be hashable.
 
-    View the cache statistics named tuple (hits, misses, maxsize, currsize) with
-    f.cache_info().  Clear the cache and statistics with f.cache_clear().
+    View the cache statistics named tuple (hits, misses, maxsize, currsize)
+    with f.cache_info().  Clear the cache and statistics with f.cache_clear().
     Access the underlying function with f.__wrapped__.
 
-    See:  http://en.wikipedia.org/wiki/Cache_algorithms#Least_Recently_Used
+    See:  https://en.wikipedia.org/wiki/Cache_replacement_policies#Least_recently_used_(LRU)
 
     """
 
@@ -88,108 +106,138 @@ def lru_cache(maxsize=100, typed=False):  # noqa: C901
     # The internals of the lru_cache are encapsulated for thread safety and
     # to allow the implementation to change (including a possible C version).
 
+    if isinstance(maxsize, int):
+        # Negative maxsize is treated as 0
+        if maxsize < 0:
+            maxsize = 0
+    elif callable(maxsize) and isinstance(typed, bool):
+        # The user_function was passed in directly via the maxsize argument
+        user_function, maxsize = maxsize, 128
+        wrapper = _lru_cache_wrapper(user_function, maxsize, typed, _CacheInfo)
+        wrapper.cache_parameters = lambda: {'maxsize': maxsize, 'typed': typed}
+        return update_wrapper(wrapper, user_function)
+    elif maxsize is not None:
+        raise TypeError('Expected first argument to be an integer, a callable, or None')
+
     def decorating_function(user_function):
-        cache = dict()
-        stats = [0, 0]  # make statistics updateable non-locally
-        HITS, MISSES = 0, 1  # names for the stats fields
-        make_key = _make_key
-        cache_get = cache.get  # bound method to lookup key or return None
-        _len = len  # localize the global len() function
-        lock = RLock()  # because linkedlist updates aren't threadsafe
-        root = []  # root of the circular doubly linked list
-        root[:] = [root, root, None, None]  # initialize by pointing to self
-        nonlocal_root = [root]  # make updateable non-locally
-        PREV, NEXT, KEY, RESULT = 0, 1, 2, 3  # names for the link fields
-
-        if maxsize == 0:
-
-            def wrapper(*args, **kwds):
-                # no caching, just do a statistics update after a successful call
-                result = user_function(*args, **kwds)
-                stats[MISSES] += 1
-                return result
-
-        elif maxsize is None:
-
-            def wrapper(*args, **kwds):
-                # simple caching without ordering or size limit
-                key = make_key(args, kwds, typed)
-                result = cache_get(
-                    key, root
-                )  # root used here as a unique not-found sentinel
-                if result is not root:
-                    stats[HITS] += 1
-                    return result
-                result = user_function(*args, **kwds)
-                cache[key] = result
-                stats[MISSES] += 1
-                return result
-
-        else:
-
-            def wrapper(*args, **kwds):
-                # size limited caching that tracks accesses by recency
-                key = make_key(args, kwds, typed) if kwds or typed else args
-                with lock:
-                    link = cache_get(key)
-                    if link is not None:
-                        # record recent use of the key by moving it
-                        # to the front of the list
-                        (root,) = nonlocal_root
-                        link_prev, link_next, key, result = link
-                        link_prev[NEXT] = link_next
-                        link_next[PREV] = link_prev
-                        last = root[PREV]
-                        last[NEXT] = root[PREV] = link
-                        link[PREV] = last
-                        link[NEXT] = root
-                        stats[HITS] += 1
-                        return result
-                result = user_function(*args, **kwds)
-                with lock:
-                    (root,) = nonlocal_root
-                    if key in cache:
-                        # getting here means that this same key was added to the
-                        # cache while the lock was released.  since the link
-                        # update is already done, we need only return the
-                        # computed result and update the count of misses.
-                        pass
-                    elif _len(cache) >= maxsize:
-                        # use the old root to store the new key and result
-                        oldroot = root
-                        oldroot[KEY] = key
-                        oldroot[RESULT] = result
-                        # empty the oldest link and make it the new root
-                        root = nonlocal_root[0] = oldroot[NEXT]
-                        oldkey = root[KEY]
-                        root[KEY] = root[RESULT] = None
-                        # now update the cache dictionary for the new links
-                        del cache[oldkey]
-                        cache[key] = oldroot
-                    else:
-                        # put result in a new link at the front of the list
-                        last = root[PREV]
-                        link = [last, root, key, result]
-                        last[NEXT] = root[PREV] = cache[key] = link
-                    stats[MISSES] += 1
-                return result
-
-        def cache_info():
-            """Report cache statistics"""
-            with lock:
-                return _CacheInfo(stats[HITS], stats[MISSES], maxsize, len(cache))
-
-        def cache_clear():
-            """Clear the cache and cache statistics"""
-            with lock:
-                cache.clear()
-                root = nonlocal_root[0]
-                root[:] = [root, root, None, None]
-                stats[:] = [0, 0]
-
-        wrapper.__wrapped__ = user_function
-        wrapper.cache_info = cache_info
-        wrapper.cache_clear = cache_clear
+        wrapper = _lru_cache_wrapper(user_function, maxsize, typed, _CacheInfo)
+        wrapper.cache_parameters = lambda: {'maxsize': maxsize, 'typed': typed}
         return update_wrapper(wrapper, user_function)
 
     return decorating_function
+
+
+def _lru_cache_wrapper(user_function, maxsize, typed, _CacheInfo):
+    # Constants shared by all lru cache instances:
+    sentinel = object()  # unique object used to signal cache misses
+    make_key = _make_key  # build a key from the function arguments
+    PREV, NEXT, KEY, RESULT = 0, 1, 2, 3  # names for the link fields
+
+    cache = {}
+    hits = misses = 0
+    full = False
+    cache_get = cache.get  # bound method to lookup a key or return None
+    cache_len = cache.__len__  # get cache size without calling len()
+    lock = RLock()  # because linkedlist updates aren't threadsafe
+    root = []  # root of the circular doubly linked list
+    root[:] = [root, root, None, None]  # initialize by pointing to self
+
+    if maxsize == 0:
+
+        def wrapper(*args, **kwds):
+            # No caching -- just a statistics update
+            nonlocal misses
+            misses += 1
+            result = user_function(*args, **kwds)
+            return result
+
+    elif maxsize is None:
+
+        def wrapper(*args, **kwds):
+            # Simple caching without ordering or size limit
+            nonlocal hits, misses
+            key = make_key(args, kwds, typed)
+            result = cache_get(key, sentinel)
+            if result is not sentinel:
+                hits += 1
+                return result
+            misses += 1
+            result = user_function(*args, **kwds)
+            cache[key] = result
+            return result
+
+    else:
+
+        def wrapper(*args, **kwds):
+            # Size limited caching that tracks accesses by recency
+            nonlocal root, hits, misses, full
+            key = make_key(args, kwds, typed)
+            with lock:
+                link = cache_get(key)
+                if link is not None:
+                    # Move the link to the front of the circular queue
+                    link_prev, link_next, _key, result = link
+                    link_prev[NEXT] = link_next
+                    link_next[PREV] = link_prev
+                    last = root[PREV]
+                    last[NEXT] = root[PREV] = link
+                    link[PREV] = last
+                    link[NEXT] = root
+                    hits += 1
+                    return result
+                misses += 1
+            result = user_function(*args, **kwds)
+            with lock:
+                if key in cache:
+                    # Getting here means that this same key was added to the
+                    # cache while the lock was released.  Since the link
+                    # update is already done, we need only return the
+                    # computed result and update the count of misses.
+                    pass
+                elif full:
+                    # Use the old root to store the new key and result.
+                    oldroot = root
+                    oldroot[KEY] = key
+                    oldroot[RESULT] = result
+                    # Empty the oldest link and make it the new root.
+                    # Keep a reference to the old key and old result to
+                    # prevent their ref counts from going to zero during the
+                    # update. That will prevent potentially arbitrary object
+                    # clean-up code (i.e. __del__) from running while we're
+                    # still adjusting the links.
+                    root = oldroot[NEXT]
+                    oldkey = root[KEY]
+                    root[KEY] = root[RESULT] = None
+                    # Now update the cache dictionary.
+                    del cache[oldkey]
+                    # Save the potentially reentrant cache[key] assignment
+                    # for last, after the root and links have been put in
+                    # a consistent state.
+                    cache[key] = oldroot
+                else:
+                    # Put result in a new link at the front of the queue.
+                    last = root[PREV]
+                    link = [last, root, key, result]
+                    last[NEXT] = root[PREV] = cache[key] = link
+                    # Use the cache_len bound method instead of the len() function
+                    # which could potentially be wrapped in an lru_cache itself.
+                    full = cache_len() >= maxsize
+            return result
+
+    def cache_info():
+        """Report cache statistics"""
+        with lock:
+            return _CacheInfo(hits, misses, maxsize, cache_len())
+
+    def cache_clear():
+        """Clear the cache and cache statistics"""
+        nonlocal hits, misses, full
+        with lock:
+            cache.clear()
+            root[:] = [root, root, None, None]
+            hits = misses = 0
+            full = False
+
+    wrapper.cache_info = cache_info
+    wrapper.cache_clear = cache_clear
+    return wrapper
diff --git a/requirements.txt b/requirements.txt
index a1f27d23..a953a789 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,7 +1,7 @@
 apscheduler==3.10.1
 arrow==1.3.0
 backports.csv==1.0.7
-backports.functools-lru-cache==1.6.6
+backports.functools-lru-cache==2.0.0
 backports.zoneinfo==0.2.1;python_version<"3.9"
 beautifulsoup4==4.12.2
 bleach==6.1.0

From aca7e727157829edefaef01de96cc890916c61ab Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sun, 24 Mar 2024 15:24:31 -0700
Subject: [PATCH 537/743] Bump distro from 1.8.0 to 1.9.0 (#2262)

* Bump distro from 1.8.0 to 1.9.0

Bumps [distro](https://github.com/python-distro/distro) from 1.8.0 to 1.9.0.
- [Release notes](https://github.com/python-distro/distro/releases)
- [Changelog](https://github.com/python-distro/distro/blob/master/CHANGELOG.md)
- [Commits](https://github.com/python-distro/distro/compare/v1.8.0...v1.9.0)

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

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

* Update distro==1.9.0

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/distro/distro.py | 12 ++++++++----
 requirements.txt     |  2 +-
 2 files changed, 9 insertions(+), 5 deletions(-)

diff --git a/lib/distro/distro.py b/lib/distro/distro.py
index 89e18680..78ccdfa4 100644
--- a/lib/distro/distro.py
+++ b/lib/distro/distro.py
@@ -1,5 +1,5 @@
 #!/usr/bin/env python
-# Copyright 2015,2016,2017 Nir Cohen
+# Copyright 2015-2021 Nir Cohen
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -55,7 +55,7 @@ except ImportError:
     # Python 3.7
     TypedDict = dict
 
-__version__ = "1.8.0"
+__version__ = "1.9.0"
 
 
 class VersionDict(TypedDict):
@@ -125,6 +125,7 @@ _DISTRO_RELEASE_BASENAME_PATTERN = re.compile(r"(\w+)[-_](release|version)$")
 # Base file names to be looked up for if _UNIXCONFDIR is not readable.
 _DISTRO_RELEASE_BASENAMES = [
     "SuSE-release",
+    "altlinux-release",
     "arch-release",
     "base-release",
     "centos-release",
@@ -151,6 +152,8 @@ _DISTRO_RELEASE_IGNORE_BASENAMES = (
     "system-release",
     "plesk-release",
     "iredmail-release",
+    "board-release",
+    "ec2_version",
 )
 
 
@@ -243,6 +246,7 @@ def id() -> str:
     "rocky"         Rocky Linux
     "aix"           AIX
     "guix"          Guix System
+    "altlinux"      ALT Linux
     ==============  =========================================
 
     If you have a need to get distros for reliable IDs added into this set,
@@ -991,10 +995,10 @@ class LinuxDistribution:
 
         For details, see :func:`distro.info`.
         """
-        return dict(
+        return InfoDict(
             id=self.id(),
             version=self.version(pretty, best),
-            version_parts=dict(
+            version_parts=VersionDict(
                 major=self.major_version(best),
                 minor=self.minor_version(best),
                 build_number=self.build_number(best),
diff --git a/requirements.txt b/requirements.txt
index a953a789..fe84492e 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -9,7 +9,7 @@ certifi==2024.2.2
 cheroot==10.0.0
 cherrypy==18.8.0
 cloudinary==1.34.0
-distro==1.8.0
+distro==1.9.0
 dnspython==2.4.2
 facebook-sdk==3.1.0
 future==0.18.3

From cfefa928be5ab04dc72a20aeba9307bd887fe0ba Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sun, 24 Mar 2024 15:25:23 -0700
Subject: [PATCH 538/743] Bump dnspython from 2.4.2 to 2.6.1 (#2264)

* Bump dnspython from 2.4.2 to 2.6.1

Bumps [dnspython](https://github.com/rthalley/dnspython) from 2.4.2 to 2.6.1.
- [Release notes](https://github.com/rthalley/dnspython/releases)
- [Changelog](https://github.com/rthalley/dnspython/blob/main/doc/whatsnew.rst)
- [Commits](https://github.com/rthalley/dnspython/compare/v2.4.2...v2.6.1)

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

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

* Update dnspython==2.6.1

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/dns/_asyncio_backend.py       |  18 +--
 lib/dns/_features.py              |  92 +++++++++++++
 lib/dns/_trio_backend.py          |   8 +-
 lib/dns/asyncbackend.py           |   2 +-
 lib/dns/asyncquery.py             |  80 +++++++----
 lib/dns/dnssec.py                 |  19 +--
 lib/dns/dnssecalgs/__init__.py    |  13 +-
 lib/dns/edns.py                   |  43 +++++-
 lib/dns/immutable.py              |  14 +-
 lib/dns/inet.py                   |  17 +++
 lib/dns/ipv4.py                   |  13 ++
 lib/dns/ipv6.py                   |  13 +-
 lib/dns/message.py                | 109 +++++++++++----
 lib/dns/name.py                   | 217 ++++++++++++++++++++++++++++--
 lib/dns/nameserver.py             |  34 ++++-
 lib/dns/node.py                   |   1 -
 lib/dns/query.py                  | 195 +++++++++++++++++----------
 lib/dns/quic/__init__.py          |  14 +-
 lib/dns/quic/_asyncio.py          |  25 ++--
 lib/dns/quic/_common.py           |  52 ++++++-
 lib/dns/quic/_sync.py             |  34 +++--
 lib/dns/quic/_trio.py             |  43 ++++--
 lib/dns/rdata.py                  |  19 +--
 lib/dns/rdataset.py               |  20 +--
 lib/dns/rdtypes/ANY/AFSDB.py      |   1 -
 lib/dns/rdtypes/ANY/AMTRELAY.py   |   1 -
 lib/dns/rdtypes/ANY/AVC.py        |   1 -
 lib/dns/rdtypes/ANY/CAA.py        |   1 -
 lib/dns/rdtypes/ANY/CDNSKEY.py    |   1 -
 lib/dns/rdtypes/ANY/CDS.py        |   1 -
 lib/dns/rdtypes/ANY/CERT.py       |   1 -
 lib/dns/rdtypes/ANY/CNAME.py      |   1 -
 lib/dns/rdtypes/ANY/CSYNC.py      |   1 -
 lib/dns/rdtypes/ANY/DLV.py        |   1 -
 lib/dns/rdtypes/ANY/DNAME.py      |   1 -
 lib/dns/rdtypes/ANY/DNSKEY.py     |   1 -
 lib/dns/rdtypes/ANY/DS.py         |   1 -
 lib/dns/rdtypes/ANY/EUI48.py      |   1 -
 lib/dns/rdtypes/ANY/EUI64.py      |   1 -
 lib/dns/rdtypes/ANY/GPOS.py       |   1 -
 lib/dns/rdtypes/ANY/HINFO.py      |   1 -
 lib/dns/rdtypes/ANY/HIP.py        |   1 -
 lib/dns/rdtypes/ANY/ISDN.py       |   1 -
 lib/dns/rdtypes/ANY/L32.py        |   1 -
 lib/dns/rdtypes/ANY/L64.py        |   1 -
 lib/dns/rdtypes/ANY/LOC.py        |   1 -
 lib/dns/rdtypes/ANY/LP.py         |   1 -
 lib/dns/rdtypes/ANY/MX.py         |   1 -
 lib/dns/rdtypes/ANY/NID.py        |   1 -
 lib/dns/rdtypes/ANY/NINFO.py      |   1 -
 lib/dns/rdtypes/ANY/NS.py         |   1 -
 lib/dns/rdtypes/ANY/NSEC.py       |   1 -
 lib/dns/rdtypes/ANY/NSEC3.py      |  10 +-
 lib/dns/rdtypes/ANY/NSEC3PARAM.py |   1 -
 lib/dns/rdtypes/ANY/OPENPGPKEY.py |   1 -
 lib/dns/rdtypes/ANY/OPT.py        |   1 -
 lib/dns/rdtypes/ANY/PTR.py        |   1 -
 lib/dns/rdtypes/ANY/RP.py         |   1 -
 lib/dns/rdtypes/ANY/RRSIG.py      |   2 -
 lib/dns/rdtypes/ANY/RT.py         |   1 -
 lib/dns/rdtypes/ANY/SOA.py        |   1 -
 lib/dns/rdtypes/ANY/SPF.py        |   1 -
 lib/dns/rdtypes/ANY/SSHFP.py      |   1 -
 lib/dns/rdtypes/ANY/TKEY.py       |   1 -
 lib/dns/rdtypes/ANY/TLSA.py       |   1 -
 lib/dns/rdtypes/ANY/TSIG.py       |   1 -
 lib/dns/rdtypes/ANY/TXT.py        |   1 -
 lib/dns/rdtypes/ANY/URI.py        |   1 -
 lib/dns/rdtypes/ANY/X25.py        |   1 -
 lib/dns/rdtypes/ANY/ZONEMD.py     |   1 -
 lib/dns/rdtypes/CH/A.py           |   1 -
 lib/dns/rdtypes/IN/A.py           |   1 -
 lib/dns/rdtypes/IN/AAAA.py        |   1 -
 lib/dns/rdtypes/IN/APL.py         |   2 -
 lib/dns/rdtypes/IN/DHCID.py       |   1 -
 lib/dns/rdtypes/IN/IPSECKEY.py    |   1 -
 lib/dns/rdtypes/IN/KX.py          |   1 -
 lib/dns/rdtypes/IN/NAPTR.py       |   1 -
 lib/dns/rdtypes/IN/NSAP.py        |   1 -
 lib/dns/rdtypes/IN/NSAP_PTR.py    |   1 -
 lib/dns/rdtypes/IN/PX.py          |   1 -
 lib/dns/rdtypes/IN/SRV.py         |   1 -
 lib/dns/rdtypes/IN/WKS.py         |   1 -
 lib/dns/rdtypes/dnskeybase.py     |   1 -
 lib/dns/rdtypes/dsbase.py         |   1 -
 lib/dns/rdtypes/euibase.py        |   1 -
 lib/dns/rdtypes/mxbase.py         |   3 -
 lib/dns/rdtypes/nsbase.py         |   2 -
 lib/dns/rdtypes/svcbbase.py       |  20 +--
 lib/dns/rdtypes/tlsabase.py       |   1 -
 lib/dns/rdtypes/txtbase.py        |  11 +-
 lib/dns/renderer.py               |  64 ++++++---
 lib/dns/rrset.py                  |   7 +-
 lib/dns/set.py                    |   1 -
 lib/dns/transaction.py            |   4 +-
 lib/dns/tsig.py                   |   9 --
 lib/dns/version.py                |   4 +-
 lib/dns/win32util.py              |  11 +-
 lib/dns/zone.py                   | 203 +++++++++++++++++-----------
 lib/dns/zonefile.py               |   1 -
 requirements.txt                  |   2 +-
 101 files changed, 1052 insertions(+), 459 deletions(-)
 create mode 100644 lib/dns/_features.py

diff --git a/lib/dns/_asyncio_backend.py b/lib/dns/_asyncio_backend.py
index 2631228e..9d9ed369 100644
--- a/lib/dns/_asyncio_backend.py
+++ b/lib/dns/_asyncio_backend.py
@@ -7,7 +7,9 @@ import socket
 import sys
 
 import dns._asyncbackend
+import dns._features
 import dns.exception
+import dns.inet
 
 _is_win32 = sys.platform == "win32"
 
@@ -121,7 +123,7 @@ class StreamSocket(dns._asyncbackend.StreamSocket):
         return self.writer.get_extra_info("peercert")
 
 
-try:
+if dns._features.have("doh"):
     import anyio
     import httpcore
     import httpcore._backends.anyio
@@ -205,7 +207,7 @@ try:
                 resolver, local_port, bootstrap_address, family
             )
 
-except ImportError:
+else:
     _HTTPTransport = dns._asyncbackend.NullTransport  # type: ignore
 
 
@@ -224,14 +226,12 @@ class Backend(dns._asyncbackend.Backend):
         ssl_context=None,
         server_hostname=None,
     ):
-        if destination is None and socktype == socket.SOCK_DGRAM and _is_win32:
-            raise NotImplementedError(
-                "destinationless datagram sockets "
-                "are not supported by asyncio "
-                "on Windows"
-            )
         loop = _get_running_loop()
         if socktype == socket.SOCK_DGRAM:
+            if _is_win32 and source is None:
+                # Win32 wants explicit binding before recvfrom().  This is the
+                # proper fix for [#637].
+                source = (dns.inet.any_for_af(af), 0)
             transport, protocol = await loop.create_datagram_endpoint(
                 _DatagramProtocol,
                 source,
@@ -266,7 +266,7 @@ class Backend(dns._asyncbackend.Backend):
         await asyncio.sleep(interval)
 
     def datagram_connection_required(self):
-        return _is_win32
+        return False
 
     def get_transport_class(self):
         return _HTTPTransport
diff --git a/lib/dns/_features.py b/lib/dns/_features.py
new file mode 100644
index 00000000..03ccaa77
--- /dev/null
+++ b/lib/dns/_features.py
@@ -0,0 +1,92 @@
+# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license
+
+import importlib.metadata
+import itertools
+import string
+from typing import Dict, List, Tuple
+
+
+def _tuple_from_text(version: str) -> Tuple:
+    text_parts = version.split(".")
+    int_parts = []
+    for text_part in text_parts:
+        digit_prefix = "".join(
+            itertools.takewhile(lambda x: x in string.digits, text_part)
+        )
+        try:
+            int_parts.append(int(digit_prefix))
+        except Exception:
+            break
+    return tuple(int_parts)
+
+
+def _version_check(
+    requirement: str,
+) -> bool:
+    """Is the requirement fulfilled?
+
+    The requirement must be of the form
+
+        package>=version
+    """
+    package, minimum = requirement.split(">=")
+    try:
+        version = importlib.metadata.version(package)
+    except Exception:
+        return False
+    t_version = _tuple_from_text(version)
+    t_minimum = _tuple_from_text(minimum)
+    if t_version < t_minimum:
+        return False
+    return True
+
+
+_cache: Dict[str, bool] = {}
+
+
+def have(feature: str) -> bool:
+    """Is *feature* available?
+
+    This tests if all optional packages needed for the
+    feature are available and recent enough.
+
+    Returns ``True`` if the feature is available,
+    and ``False`` if it is not or if metadata is
+    missing.
+    """
+    value = _cache.get(feature)
+    if value is not None:
+        return value
+    requirements = _requirements.get(feature)
+    if requirements is None:
+        # we make a cache entry here for consistency not performance
+        _cache[feature] = False
+        return False
+    ok = True
+    for requirement in requirements:
+        if not _version_check(requirement):
+            ok = False
+            break
+    _cache[feature] = ok
+    return ok
+
+
+def force(feature: str, enabled: bool) -> None:
+    """Force the status of *feature* to be *enabled*.
+
+    This method is provided as a workaround for any cases
+    where importlib.metadata is ineffective, or for testing.
+    """
+    _cache[feature] = enabled
+
+
+_requirements: Dict[str, List[str]] = {
+    ### BEGIN generated requirements
+    "dnssec": ["cryptography>=41"],
+    "doh": ["httpcore>=1.0.0", "httpx>=0.26.0", "h2>=4.1.0"],
+    "doq": ["aioquic>=0.9.25"],
+    "idna": ["idna>=3.6"],
+    "trio": ["trio>=0.23"],
+    "wmi": ["wmi>=1.5.1"],
+    ### END generated requirements
+}
diff --git a/lib/dns/_trio_backend.py b/lib/dns/_trio_backend.py
index 4d9fb820..398e3276 100644
--- a/lib/dns/_trio_backend.py
+++ b/lib/dns/_trio_backend.py
@@ -8,9 +8,13 @@ import trio
 import trio.socket  # type: ignore
 
 import dns._asyncbackend
+import dns._features
 import dns.exception
 import dns.inet
 
+if not dns._features.have("trio"):
+    raise ImportError("trio not found or too old")
+
 
 def _maybe_timeout(timeout):
     if timeout is not None:
@@ -95,7 +99,7 @@ class StreamSocket(dns._asyncbackend.StreamSocket):
             raise NotImplementedError
 
 
-try:
+if dns._features.have("doh"):
     import httpcore
     import httpcore._backends.trio
     import httpx
@@ -177,7 +181,7 @@ try:
                 resolver, local_port, bootstrap_address, family
             )
 
-except ImportError:
+else:
     _HTTPTransport = dns._asyncbackend.NullTransport  # type: ignore
 
 
diff --git a/lib/dns/asyncbackend.py b/lib/dns/asyncbackend.py
index 07d50e1e..0ec58b06 100644
--- a/lib/dns/asyncbackend.py
+++ b/lib/dns/asyncbackend.py
@@ -32,7 +32,7 @@ def get_backend(name: str) -> Backend:
     *name*, a ``str``, the name of the backend.  Currently the "trio"
     and "asyncio" backends are available.
 
-    Raises NotImplementError if an unknown backend name is specified.
+    Raises NotImplementedError if an unknown backend name is specified.
     """
     # pylint: disable=import-outside-toplevel,redefined-outer-name
     backend = _backends.get(name)
diff --git a/lib/dns/asyncquery.py b/lib/dns/asyncquery.py
index ecf9c1a5..4d9ab9ae 100644
--- a/lib/dns/asyncquery.py
+++ b/lib/dns/asyncquery.py
@@ -41,7 +41,7 @@ from dns.query import (
     NoDOQ,
     UDPMode,
     _compute_times,
-    _have_http2,
+    _make_dot_ssl_context,
     _matches_destination,
     _remaining,
     have_doh,
@@ -120,6 +120,8 @@ async def receive_udp(
     request_mac: Optional[bytes] = b"",
     ignore_trailing: bool = False,
     raise_on_truncation: bool = False,
+    ignore_errors: bool = False,
+    query: Optional[dns.message.Message] = None,
 ) -> Any:
     """Read a DNS message from a UDP socket.
 
@@ -133,22 +135,40 @@ async def receive_udp(
     """
 
     wire = b""
-    while 1:
+    while True:
         (wire, from_address) = await sock.recvfrom(65535, _timeout(expiration))
-        if _matches_destination(
+        if not _matches_destination(
             sock.family, from_address, destination, ignore_unexpected
         ):
-            break
-    received_time = time.time()
-    r = dns.message.from_wire(
-        wire,
-        keyring=keyring,
-        request_mac=request_mac,
-        one_rr_per_rrset=one_rr_per_rrset,
-        ignore_trailing=ignore_trailing,
-        raise_on_truncation=raise_on_truncation,
-    )
-    return (r, received_time, from_address)
+            continue
+        received_time = time.time()
+        try:
+            r = dns.message.from_wire(
+                wire,
+                keyring=keyring,
+                request_mac=request_mac,
+                one_rr_per_rrset=one_rr_per_rrset,
+                ignore_trailing=ignore_trailing,
+                raise_on_truncation=raise_on_truncation,
+            )
+        except dns.message.Truncated as e:
+            # See the comment in query.py for details.
+            if (
+                ignore_errors
+                and query is not None
+                and not query.is_response(e.message())
+            ):
+                continue
+            else:
+                raise
+        except Exception:
+            if ignore_errors:
+                continue
+            else:
+                raise
+        if ignore_errors and query is not None and not query.is_response(r):
+            continue
+        return (r, received_time, from_address)
 
 
 async def udp(
@@ -164,6 +184,7 @@ async def udp(
     raise_on_truncation: bool = False,
     sock: Optional[dns.asyncbackend.DatagramSocket] = None,
     backend: Optional[dns.asyncbackend.Backend] = None,
+    ignore_errors: bool = False,
 ) -> dns.message.Message:
     """Return the response obtained after sending a query via UDP.
 
@@ -205,9 +226,13 @@ async def udp(
             q.mac,
             ignore_trailing,
             raise_on_truncation,
+            ignore_errors,
+            q,
         )
         r.time = received_time - begin_time
-        if not q.is_response(r):
+        # We don't need to check q.is_response() if we are in ignore_errors mode
+        # as receive_udp() will have checked it.
+        if not (ignore_errors or q.is_response(r)):
             raise BadResponse
         return r
 
@@ -225,6 +250,7 @@ async def udp_with_fallback(
     udp_sock: Optional[dns.asyncbackend.DatagramSocket] = None,
     tcp_sock: Optional[dns.asyncbackend.StreamSocket] = None,
     backend: Optional[dns.asyncbackend.Backend] = None,
+    ignore_errors: bool = False,
 ) -> Tuple[dns.message.Message, bool]:
     """Return the response to the query, trying UDP first and falling back
     to TCP if UDP results in a truncated response.
@@ -260,6 +286,7 @@ async def udp_with_fallback(
             True,
             udp_sock,
             backend,
+            ignore_errors,
         )
         return (response, False)
     except dns.message.Truncated:
@@ -292,14 +319,12 @@ async def send_tcp(
     """
 
     if isinstance(what, dns.message.Message):
-        wire = what.to_wire()
+        tcpmsg = what.to_wire(prepend_length=True)
     else:
-        wire = what
-    l = len(wire)
-    # copying the wire into tcpmsg is inefficient, but lets us
-    # avoid writev() or doing a short write that would get pushed
-    # onto the net
-    tcpmsg = struct.pack("!H", l) + wire
+        # copying the wire into tcpmsg is inefficient, but lets us
+        # avoid writev() or doing a short write that would get pushed
+        # onto the net
+        tcpmsg = len(what).to_bytes(2, "big") + what
     sent_time = time.time()
     await sock.sendall(tcpmsg, _timeout(expiration, sent_time))
     return (len(tcpmsg), sent_time)
@@ -418,6 +443,7 @@ async def tls(
     backend: Optional[dns.asyncbackend.Backend] = None,
     ssl_context: Optional[ssl.SSLContext] = None,
     server_hostname: Optional[str] = None,
+    verify: Union[bool, str] = True,
 ) -> dns.message.Message:
     """Return the response obtained after sending a query via TLS.
 
@@ -439,11 +465,7 @@ async def tls(
         cm: contextlib.AbstractAsyncContextManager = NullContext(sock)
     else:
         if ssl_context is None:
-            # See the comment about ssl.create_default_context() in query.py
-            ssl_context = ssl.create_default_context()  # lgtm[py/insecure-protocol]
-            ssl_context.minimum_version = ssl.TLSVersion.TLSv1_2
-            if server_hostname is None:
-                ssl_context.check_hostname = False
+            ssl_context = _make_dot_ssl_context(server_hostname, verify)
         af = dns.inet.af_for_address(where)
         stuple = _source_tuple(af, source, source_port)
         dtuple = (where, port)
@@ -538,7 +560,7 @@ async def https(
     transport = backend.get_transport_class()(
         local_address=local_address,
         http1=True,
-        http2=_have_http2,
+        http2=True,
         verify=verify,
         local_port=local_port,
         bootstrap_address=bootstrap_address,
@@ -550,7 +572,7 @@ async def https(
         cm: contextlib.AbstractAsyncContextManager = NullContext(client)
     else:
         cm = httpx.AsyncClient(
-            http1=True, http2=_have_http2, verify=verify, transport=transport
+            http1=True, http2=True, verify=verify, transport=transport
         )
 
     async with cm as the_client:
diff --git a/lib/dns/dnssec.py b/lib/dns/dnssec.py
index 2949f619..e49c3b79 100644
--- a/lib/dns/dnssec.py
+++ b/lib/dns/dnssec.py
@@ -27,6 +27,7 @@ import time
 from datetime import datetime
 from typing import Callable, Dict, List, Optional, Set, Tuple, Union, cast
 
+import dns._features
 import dns.exception
 import dns.name
 import dns.node
@@ -1169,7 +1170,7 @@ def _need_pyca(*args, **kwargs):
     )  # pragma: no cover
 
 
-try:
+if dns._features.have("dnssec"):
     from cryptography.exceptions import InvalidSignature
     from cryptography.hazmat.primitives.asymmetric import dsa  # pylint: disable=W0611
     from cryptography.hazmat.primitives.asymmetric import ec  # pylint: disable=W0611
@@ -1184,20 +1185,20 @@ try:
         get_algorithm_cls_from_dnskey,
     )
     from dns.dnssecalgs.base import GenericPrivateKey, GenericPublicKey
-except ImportError:  # pragma: no cover
-    validate = _need_pyca
-    validate_rrsig = _need_pyca
-    sign = _need_pyca
-    make_dnskey = _need_pyca
-    make_cdnskey = _need_pyca
-    _have_pyca = False
-else:
+
     validate = _validate  # type: ignore
     validate_rrsig = _validate_rrsig  # type: ignore
     sign = _sign
     make_dnskey = _make_dnskey
     make_cdnskey = _make_cdnskey
     _have_pyca = True
+else:  # pragma: no cover
+    validate = _need_pyca
+    validate_rrsig = _need_pyca
+    sign = _need_pyca
+    make_dnskey = _need_pyca
+    make_cdnskey = _need_pyca
+    _have_pyca = False
 
 ### BEGIN generated Algorithm constants
 
diff --git a/lib/dns/dnssecalgs/__init__.py b/lib/dns/dnssecalgs/__init__.py
index d1ffd519..3d9181a7 100644
--- a/lib/dns/dnssecalgs/__init__.py
+++ b/lib/dns/dnssecalgs/__init__.py
@@ -1,9 +1,12 @@
 from typing import Dict, Optional, Tuple, Type, Union
 
 import dns.name
+from dns.dnssecalgs.base import GenericPrivateKey
+from dns.dnssectypes import Algorithm
+from dns.exception import UnsupportedAlgorithm
+from dns.rdtypes.ANY.DNSKEY import DNSKEY
 
-try:
-    from dns.dnssecalgs.base import GenericPrivateKey
+if dns._features.have("dnssec"):
     from dns.dnssecalgs.dsa import PrivateDSA, PrivateDSANSEC3SHA1
     from dns.dnssecalgs.ecdsa import PrivateECDSAP256SHA256, PrivateECDSAP384SHA384
     from dns.dnssecalgs.eddsa import PrivateED448, PrivateED25519
@@ -16,13 +19,9 @@ try:
     )
 
     _have_cryptography = True
-except ImportError:
+else:
     _have_cryptography = False
 
-from dns.dnssectypes import Algorithm
-from dns.exception import UnsupportedAlgorithm
-from dns.rdtypes.ANY.DNSKEY import DNSKEY
-
 AlgorithmPrefix = Optional[Union[bytes, dns.name.Name]]
 
 algorithms: Dict[Tuple[Algorithm, AlgorithmPrefix], Type[GenericPrivateKey]] = {}
diff --git a/lib/dns/edns.py b/lib/dns/edns.py
index f05baac4..776e5eeb 100644
--- a/lib/dns/edns.py
+++ b/lib/dns/edns.py
@@ -17,6 +17,7 @@
 
 """EDNS Options"""
 
+import binascii
 import math
 import socket
 import struct
@@ -58,7 +59,6 @@ class OptionType(dns.enum.IntEnum):
 
 
 class Option:
-
     """Base class for all EDNS option types."""
 
     def __init__(self, otype: Union[OptionType, str]):
@@ -76,6 +76,9 @@ class Option:
         """
         raise NotImplementedError  # pragma: no cover
 
+    def to_text(self) -> str:
+        raise NotImplementedError  # pragma: no cover
+
     @classmethod
     def from_wire_parser(cls, otype: OptionType, parser: "dns.wire.Parser") -> "Option":
         """Build an EDNS option object from wire format.
@@ -141,7 +144,6 @@ class Option:
 
 
 class GenericOption(Option):  # lgtm[py/missing-equals]
-
     """Generic Option Class
 
     This class is used for EDNS option types for which we have no better
@@ -343,6 +345,8 @@ class EDECode(dns.enum.IntEnum):
 class EDEOption(Option):  # lgtm[py/missing-equals]
     """Extended DNS Error (EDE, RFC8914)"""
 
+    _preserve_case = {"DNSKEY", "DS", "DNSSEC", "RRSIGs", "NSEC", "NXDOMAIN"}
+
     def __init__(self, code: Union[EDECode, str], text: Optional[str] = None):
         """*code*, a ``dns.edns.EDECode`` or ``str``, the info code of the
         extended error.
@@ -360,6 +364,13 @@ class EDEOption(Option):  # lgtm[py/missing-equals]
 
     def to_text(self) -> str:
         output = f"EDE {self.code}"
+        if self.code in EDECode:
+            desc = EDECode.to_text(self.code)
+            desc = " ".join(
+                word if word in self._preserve_case else word.title()
+                for word in desc.split("_")
+            )
+            output += f" ({desc})"
         if self.text is not None:
             output += f": {self.text}"
         return output
@@ -392,9 +403,37 @@ class EDEOption(Option):  # lgtm[py/missing-equals]
         return cls(code, btext)
 
 
+class NSIDOption(Option):
+    def __init__(self, nsid: bytes):
+        super().__init__(OptionType.NSID)
+        self.nsid = nsid
+
+    def to_wire(self, file: Any = None) -> Optional[bytes]:
+        if file:
+            file.write(self.nsid)
+            return None
+        else:
+            return self.nsid
+
+    def to_text(self) -> str:
+        if all(c >= 0x20 and c <= 0x7E for c in self.nsid):
+            # All ASCII printable, so it's probably a string.
+            value = self.nsid.decode()
+        else:
+            value = binascii.hexlify(self.nsid).decode()
+        return f"NSID {value}"
+
+    @classmethod
+    def from_wire_parser(
+        cls, otype: Union[OptionType, str], parser: dns.wire.Parser
+    ) -> Option:
+        return cls(parser.get_remaining())
+
+
 _type_to_class: Dict[OptionType, Any] = {
     OptionType.ECS: ECSOption,
     OptionType.EDE: EDEOption,
+    OptionType.NSID: NSIDOption,
 }
 
 
diff --git a/lib/dns/immutable.py b/lib/dns/immutable.py
index cab8d6fb..36b0362c 100644
--- a/lib/dns/immutable.py
+++ b/lib/dns/immutable.py
@@ -1,24 +1,30 @@
 # Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license
 
 import collections.abc
-from typing import Any
+from typing import Any, Callable
 
 from dns._immutable_ctx import immutable
 
 
 @immutable
 class Dict(collections.abc.Mapping):  # lgtm[py/missing-equals]
-    def __init__(self, dictionary: Any, no_copy: bool = False):
+    def __init__(
+        self,
+        dictionary: Any,
+        no_copy: bool = False,
+        map_factory: Callable[[], collections.abc.MutableMapping] = dict,
+    ):
         """Make an immutable dictionary from the specified dictionary.
 
         If *no_copy* is `True`, then *dictionary* will be wrapped instead
         of copied.  Only set this if you are sure there will be no external
         references to the dictionary.
         """
-        if no_copy and isinstance(dictionary, dict):
+        if no_copy and isinstance(dictionary, collections.abc.MutableMapping):
             self._odict = dictionary
         else:
-            self._odict = dict(dictionary)
+            self._odict = map_factory()
+            self._odict.update(dictionary)
         self._hash = None
 
     def __getitem__(self, key):
diff --git a/lib/dns/inet.py b/lib/dns/inet.py
index 02e925c6..4a03f996 100644
--- a/lib/dns/inet.py
+++ b/lib/dns/inet.py
@@ -178,3 +178,20 @@ def any_for_af(af):
     elif af == socket.AF_INET6:
         return "::"
     raise NotImplementedError(f"unknown address family {af}")
+
+
+def canonicalize(text: str) -> str:
+    """Verify that *address* is a valid text form IPv4 or IPv6 address and return its
+    canonical text form.  IPv6 addresses with scopes are rejected.
+
+    *text*, a ``str``, the address in textual form.
+
+    Raises ``ValueError`` if the text is not valid.
+    """
+    try:
+        return dns.ipv6.canonicalize(text)
+    except Exception:
+        try:
+            return dns.ipv4.canonicalize(text)
+        except Exception:
+            raise ValueError
diff --git a/lib/dns/ipv4.py b/lib/dns/ipv4.py
index f549150a..65ee69c0 100644
--- a/lib/dns/ipv4.py
+++ b/lib/dns/ipv4.py
@@ -62,3 +62,16 @@ def inet_aton(text: Union[str, bytes]) -> bytes:
         return struct.pack("BBBB", *b)
     except Exception:
         raise dns.exception.SyntaxError
+
+
+def canonicalize(text: Union[str, bytes]) -> str:
+    """Verify that *address* is a valid text form IPv4 address and return its
+    canonical text form.
+
+    *text*, a ``str`` or ``bytes``, the IPv4 address in textual form.
+
+    Raises ``dns.exception.SyntaxError`` if the text is not valid.
+    """
+    # Note that inet_aton() only accepts canonial form, but we still run through
+    # inet_ntoa() to ensure the output is a str.
+    return dns.ipv4.inet_ntoa(dns.ipv4.inet_aton(text))
diff --git a/lib/dns/ipv6.py b/lib/dns/ipv6.py
index 0cc3d868..44a10639 100644
--- a/lib/dns/ipv6.py
+++ b/lib/dns/ipv6.py
@@ -104,7 +104,7 @@ _colon_colon_end = re.compile(rb".*::$")
 def inet_aton(text: Union[str, bytes], ignore_scope: bool = False) -> bytes:
     """Convert an IPv6 address in text form to binary form.
 
-    *text*, a ``str``, the IPv6 address in textual form.
+    *text*, a ``str`` or ``bytes``, the IPv6 address in textual form.
 
     *ignore_scope*, a ``bool``.  If ``True``, a scope will be ignored.
     If ``False``, the default, it is an error for a scope to be present.
@@ -206,3 +206,14 @@ def is_mapped(address: bytes) -> bool:
     """
 
     return address.startswith(_mapped_prefix)
+
+
+def canonicalize(text: Union[str, bytes]) -> str:
+    """Verify that *address* is a valid text form IPv6 address and return its
+    canonical text form.  Addresses with scopes are rejected.
+
+    *text*, a ``str`` or ``bytes``, the IPv6 address in textual form.
+
+    Raises ``dns.exception.SyntaxError`` if the text is not valid.
+    """
+    return dns.ipv6.inet_ntoa(dns.ipv6.inet_aton(text))
diff --git a/lib/dns/message.py b/lib/dns/message.py
index daae6363..44cacbd9 100644
--- a/lib/dns/message.py
+++ b/lib/dns/message.py
@@ -393,7 +393,7 @@ class Message:
             section_number = section
             section = self.section_from_number(section_number)
         elif isinstance(section, str):
-            section_number = MessageSection.from_text(section)
+            section_number = self._section_enum.from_text(section)
             section = self.section_from_number(section_number)
         else:
             section_number = self.section_number(section)
@@ -489,6 +489,34 @@ class Message:
             rrset = None
         return rrset
 
+    def section_count(self, section: SectionType) -> int:
+        """Returns the number of records in the specified section.
+
+        *section*, an ``int`` section number, a ``str`` section name, or one of
+        the section attributes of this message.  This specifies the
+        the section of the message to count.  For example::
+
+            my_message.section_count(my_message.answer)
+            my_message.section_count(dns.message.ANSWER)
+            my_message.section_count("ANSWER")
+        """
+
+        if isinstance(section, int):
+            section_number = section
+            section = self.section_from_number(section_number)
+        elif isinstance(section, str):
+            section_number = self._section_enum.from_text(section)
+            section = self.section_from_number(section_number)
+        else:
+            section_number = self.section_number(section)
+        count = sum(max(1, len(rrs)) for rrs in section)
+        if section_number == MessageSection.ADDITIONAL:
+            if self.opt is not None:
+                count += 1
+            if self.tsig is not None:
+                count += 1
+        return count
+
     def _compute_opt_reserve(self) -> int:
         """Compute the size required for the OPT RR, padding excluded"""
         if not self.opt:
@@ -527,6 +555,8 @@ class Message:
         max_size: int = 0,
         multi: bool = False,
         tsig_ctx: Optional[Any] = None,
+        prepend_length: bool = False,
+        prefer_truncation: bool = False,
         **kw: Dict[str, Any],
     ) -> bytes:
         """Return a string containing the message in DNS compressed wire
@@ -549,6 +579,15 @@ class Message:
         *tsig_ctx*, a ``dns.tsig.HMACTSig`` or ``dns.tsig.GSSTSig`` object, the
         ongoing TSIG context, used when signing zone transfers.
 
+        *prepend_length*, a ``bool``, should be set to ``True`` if the caller
+        wants the message length prepended to the message itself.  This is
+        useful for messages sent over TCP, TLS (DoT), or QUIC (DoQ).
+
+        *prefer_truncation*, a ``bool``, should be set to ``True`` if the caller
+        wants the message to be truncated if it would otherwise exceed the
+        maximum length.  If the truncation occurs before the additional section,
+        the TC bit will be set.
+
         Raises ``dns.exception.TooBig`` if *max_size* was exceeded.
 
         Returns a ``bytes``.
@@ -570,14 +609,21 @@ class Message:
         r.reserve(opt_reserve)
         tsig_reserve = self._compute_tsig_reserve()
         r.reserve(tsig_reserve)
-        for rrset in self.question:
-            r.add_question(rrset.name, rrset.rdtype, rrset.rdclass)
-        for rrset in self.answer:
-            r.add_rrset(dns.renderer.ANSWER, rrset, **kw)
-        for rrset in self.authority:
-            r.add_rrset(dns.renderer.AUTHORITY, rrset, **kw)
-        for rrset in self.additional:
-            r.add_rrset(dns.renderer.ADDITIONAL, rrset, **kw)
+        try:
+            for rrset in self.question:
+                r.add_question(rrset.name, rrset.rdtype, rrset.rdclass)
+            for rrset in self.answer:
+                r.add_rrset(dns.renderer.ANSWER, rrset, **kw)
+            for rrset in self.authority:
+                r.add_rrset(dns.renderer.AUTHORITY, rrset, **kw)
+            for rrset in self.additional:
+                r.add_rrset(dns.renderer.ADDITIONAL, rrset, **kw)
+        except dns.exception.TooBig:
+            if prefer_truncation:
+                if r.section < dns.renderer.ADDITIONAL:
+                    r.flags |= dns.flags.TC
+            else:
+                raise
         r.release_reserved()
         if self.opt is not None:
             r.add_opt(self.opt, self.pad, opt_reserve, tsig_reserve)
@@ -598,7 +644,10 @@ class Message:
             r.write_header()
             if multi:
                 self.tsig_ctx = ctx
-        return r.get_wire()
+        wire = r.get_wire()
+        if prepend_length:
+            wire = len(wire).to_bytes(2, "big") + wire
+        return wire
 
     @staticmethod
     def _make_tsig(
@@ -777,6 +826,8 @@ class Message:
             if request_payload is None:
                 request_payload = payload
             self.request_payload = request_payload
+            if pad < 0:
+                raise ValueError("pad must be non-negative")
             self.pad = pad
 
     @property
@@ -826,7 +877,7 @@ class Message:
         if wanted:
             self.ednsflags |= dns.flags.DO
         elif self.opt:
-            self.ednsflags &= ~dns.flags.DO
+            self.ednsflags &= ~int(dns.flags.DO)
 
     def rcode(self) -> dns.rcode.Rcode:
         """Return the rcode.
@@ -1035,7 +1086,6 @@ def _message_factory_from_opcode(opcode):
 
 
 class _WireReader:
-
     """Wire format reader.
 
     parser: the binary parser
@@ -1335,7 +1385,6 @@ def from_wire(
 
 
 class _TextReader:
-
     """Text format reader.
 
     tok: the tokenizer.
@@ -1768,30 +1817,34 @@ def make_response(
     our_payload: int = 8192,
     fudge: int = 300,
     tsig_error: int = 0,
+    pad: Optional[int] = None,
 ) -> Message:
     """Make a message which is a response for the specified query.
-    The message returned is really a response skeleton; it has all
-    of the infrastructure required of a response, but none of the
-    content.
+    The message returned is really a response skeleton; it has all of the infrastructure
+    required of a response, but none of the content.
 
-    The response's question section is a shallow copy of the query's
-    question section, so the query's question RRsets should not be
-    changed.
+    The response's question section is a shallow copy of the query's question section,
+    so the query's question RRsets should not be changed.
 
     *query*, a ``dns.message.Message``, the query to respond to.
 
     *recursion_available*, a ``bool``, should RA be set in the response?
 
-    *our_payload*, an ``int``, the payload size to advertise in EDNS
-    responses.
+    *our_payload*, an ``int``, the payload size to advertise in EDNS responses.
 
     *fudge*, an ``int``, the TSIG time fudge.
 
     *tsig_error*, an ``int``, the TSIG error.
 
-    Returns a ``dns.message.Message`` object whose specific class is
-    appropriate for the query.  For example, if query is a
-    ``dns.update.UpdateMessage``, response will be too.
+    *pad*, a non-negative ``int`` or ``None``.  If 0, the default, do not pad; otherwise
+    if not ``None`` add padding bytes to make the message size a multiple of *pad*.
+    Note that if padding is non-zero, an EDNS PADDING option will always be added to the
+    message.  If ``None``, add padding following RFC 8467, namely if the request is
+    padded, pad the response to 468 otherwise do not pad.
+
+    Returns a ``dns.message.Message`` object whose specific class is appropriate for the
+    query.  For example, if query is a ``dns.update.UpdateMessage``, response will be
+    too.
     """
 
     if query.flags & dns.flags.QR:
@@ -1804,7 +1857,13 @@ def make_response(
     response.set_opcode(query.opcode())
     response.question = list(query.question)
     if query.edns >= 0:
-        response.use_edns(0, 0, our_payload, query.payload)
+        if pad is None:
+            # Set response padding per RFC 8467
+            pad = 0
+            for option in query.options:
+                if option.otype == dns.edns.OptionType.PADDING:
+                    pad = 468
+        response.use_edns(0, 0, our_payload, query.payload, pad=pad)
     if query.had_tsig:
         response.use_tsig(
             query.keyring,
diff --git a/lib/dns/name.py b/lib/dns/name.py
index f452bfed..22ccb392 100644
--- a/lib/dns/name.py
+++ b/lib/dns/name.py
@@ -20,21 +20,23 @@
 
 import copy
 import encodings.idna  # type: ignore
+import functools
 import struct
-from typing import Any, Dict, Iterable, Optional, Tuple, Union
-
-try:
-    import idna  # type: ignore
-
-    have_idna_2008 = True
-except ImportError:  # pragma: no cover
-    have_idna_2008 = False
+from typing import Any, Callable, Dict, Iterable, Optional, Tuple, Union
 
+import dns._features
 import dns.enum
 import dns.exception
 import dns.immutable
 import dns.wire
 
+if dns._features.have("idna"):
+    import idna  # type: ignore
+
+    have_idna_2008 = True
+else:  # pragma: no cover
+    have_idna_2008 = False
+
 CompressType = Dict["Name", int]
 
 
@@ -128,6 +130,10 @@ class IDNAException(dns.exception.DNSException):
         super().__init__(*args, **kwargs)
 
 
+class NeedSubdomainOfOrigin(dns.exception.DNSException):
+    """An absolute name was provided that is not a subdomain of the specified origin."""
+
+
 _escaped = b'"().;\\@$'
 _escaped_text = '"().;\\@$'
 
@@ -350,7 +356,6 @@ def _maybe_convert_to_binary(label: Union[bytes, str]) -> bytes:
 
 @dns.immutable.immutable
 class Name:
-
     """A DNS name.
 
     The dns.name.Name class represents a DNS name as a tuple of
@@ -843,6 +848,42 @@ class Name:
             raise NoParent
         return Name(self.labels[1:])
 
+    def predecessor(self, origin: "Name", prefix_ok: bool = True) -> "Name":
+        """Return the maximal predecessor of *name* in the DNSSEC ordering in the zone
+        whose origin is *origin*, or return the longest name under *origin* if the
+        name is origin (i.e. wrap around to the longest name, which may still be
+        *origin* due to length considerations.
+
+        The relativity of the name is preserved, so if this name is relative
+        then the method will return a relative name, and likewise if this name
+        is absolute then the predecessor will be absolute.
+
+        *prefix_ok* indicates if prefixing labels is allowed, and
+        defaults to ``True``.  Normally it is good to allow this, but if computing
+        a maximal predecessor at a zone cut point then ``False`` must be specified.
+        """
+        return _handle_relativity_and_call(
+            _absolute_predecessor, self, origin, prefix_ok
+        )
+
+    def successor(self, origin: "Name", prefix_ok: bool = True) -> "Name":
+        """Return the minimal successor of *name* in the DNSSEC ordering in the zone
+        whose origin is *origin*, or return *origin* if the successor cannot be
+        computed due to name length limitations.
+
+        Note that *origin* is returned in the "too long" cases because wrapping
+        around to the origin is how NSEC records express "end of the zone".
+
+        The relativity of the name is preserved, so if this name is relative
+        then the method will return a relative name, and likewise if this name
+        is absolute then the successor will be absolute.
+
+        *prefix_ok* indicates if prefixing a new minimal label is allowed, and
+        defaults to ``True``.  Normally it is good to allow this, but if computing
+        a minimal successor at a zone cut point then ``False`` must be specified.
+        """
+        return _handle_relativity_and_call(_absolute_successor, self, origin, prefix_ok)
+
 
 #: The root name, '.'
 root = Name([b""])
@@ -1082,3 +1123,161 @@ def from_wire(message: bytes, current: int) -> Tuple[Name, int]:
     parser = dns.wire.Parser(message, current)
     name = from_wire_parser(parser)
     return (name, parser.current - current)
+
+
+# RFC 4471 Support
+
+_MINIMAL_OCTET = b"\x00"
+_MINIMAL_OCTET_VALUE = ord(_MINIMAL_OCTET)
+_SUCCESSOR_PREFIX = Name([_MINIMAL_OCTET])
+_MAXIMAL_OCTET = b"\xff"
+_MAXIMAL_OCTET_VALUE = ord(_MAXIMAL_OCTET)
+_AT_SIGN_VALUE = ord("@")
+_LEFT_SQUARE_BRACKET_VALUE = ord("[")
+
+
+def _wire_length(labels):
+    return functools.reduce(lambda v, x: v + len(x) + 1, labels, 0)
+
+
+def _pad_to_max_name(name):
+    needed = 255 - _wire_length(name.labels)
+    new_labels = []
+    while needed > 64:
+        new_labels.append(_MAXIMAL_OCTET * 63)
+        needed -= 64
+    if needed >= 2:
+        new_labels.append(_MAXIMAL_OCTET * (needed - 1))
+    # Note we're already maximal in the needed == 1 case as while we'd like
+    # to add one more byte as a new label, we can't, as adding a new non-empty
+    # label requires at least 2 bytes.
+    new_labels = list(reversed(new_labels))
+    new_labels.extend(name.labels)
+    return Name(new_labels)
+
+
+def _pad_to_max_label(label, suffix_labels):
+    length = len(label)
+    # We have to subtract one here to account for the length byte of label.
+    remaining = 255 - _wire_length(suffix_labels) - length - 1
+    if remaining <= 0:
+        # Shouldn't happen!
+        return label
+    needed = min(63 - length, remaining)
+    return label + _MAXIMAL_OCTET * needed
+
+
+def _absolute_predecessor(name: Name, origin: Name, prefix_ok: bool) -> Name:
+    # This is the RFC 4471 predecessor algorithm using the "absolute method" of section
+    # 3.1.1.
+    #
+    # Our caller must ensure that the name and origin are absolute, and that name is a
+    # subdomain of origin.
+    if name == origin:
+        return _pad_to_max_name(name)
+    least_significant_label = name[0]
+    if least_significant_label == _MINIMAL_OCTET:
+        return name.parent()
+    least_octet = least_significant_label[-1]
+    suffix_labels = name.labels[1:]
+    if least_octet == _MINIMAL_OCTET_VALUE:
+        new_labels = [least_significant_label[:-1]]
+    else:
+        octets = bytearray(least_significant_label)
+        octet = octets[-1]
+        if octet == _LEFT_SQUARE_BRACKET_VALUE:
+            octet = _AT_SIGN_VALUE
+        else:
+            octet -= 1
+        octets[-1] = octet
+        least_significant_label = bytes(octets)
+        new_labels = [_pad_to_max_label(least_significant_label, suffix_labels)]
+    new_labels.extend(suffix_labels)
+    name = Name(new_labels)
+    if prefix_ok:
+        return _pad_to_max_name(name)
+    else:
+        return name
+
+
+def _absolute_successor(name: Name, origin: Name, prefix_ok: bool) -> Name:
+    # This is the RFC 4471 successor algorithm using the "absolute method" of section
+    # 3.1.2.
+    #
+    # Our caller must ensure that the name and origin are absolute, and that name is a
+    # subdomain of origin.
+    if prefix_ok:
+        # Try prefixing \000 as new label
+        try:
+            return _SUCCESSOR_PREFIX.concatenate(name)
+        except NameTooLong:
+            pass
+    while name != origin:
+        # Try extending the least significant label.
+        least_significant_label = name[0]
+        if len(least_significant_label) < 63:
+            # We may be able to extend the least label with a minimal additional byte.
+            # This is only "may" because we could have a maximal length name even though
+            # the least significant label isn't maximally long.
+            new_labels = [least_significant_label + _MINIMAL_OCTET]
+            new_labels.extend(name.labels[1:])
+            try:
+                return dns.name.Name(new_labels)
+            except dns.name.NameTooLong:
+                pass
+        # We can't extend the label either, so we'll try to increment the least
+        # signficant non-maximal byte in it.
+        octets = bytearray(least_significant_label)
+        # We do this reversed iteration with an explicit indexing variable because
+        # if we find something to increment, we're going to want to truncate everything
+        # to the right of it.
+        for i in range(len(octets) - 1, -1, -1):
+            octet = octets[i]
+            if octet == _MAXIMAL_OCTET_VALUE:
+                # We can't increment this, so keep looking.
+                continue
+            # Finally, something we can increment.  We have to apply a special rule for
+            # incrementing "@", sending it to "[", because RFC 4034 6.1 says that when
+            # comparing names, uppercase letters compare as if they were their
+            # lower-case equivalents. If we increment "@" to "A", then it would compare
+            # as "a", which is after "[", "\", "]", "^", "_", and "`", so we would have
+            # skipped the most minimal successor, namely "[".
+            if octet == _AT_SIGN_VALUE:
+                octet = _LEFT_SQUARE_BRACKET_VALUE
+            else:
+                octet += 1
+            octets[i] = octet
+            # We can now truncate all of the maximal values we skipped (if any)
+            new_labels = [bytes(octets[: i + 1])]
+            new_labels.extend(name.labels[1:])
+            # We haven't changed the length of the name, so the Name constructor will
+            # always work.
+            return Name(new_labels)
+        # We couldn't increment, so chop off the least significant label and try
+        # again.
+        name = name.parent()
+
+    # We couldn't increment at all, so return the origin, as wrapping around is the
+    # DNSSEC way.
+    return origin
+
+
+def _handle_relativity_and_call(
+    function: Callable[[Name, Name, bool], Name],
+    name: Name,
+    origin: Name,
+    prefix_ok: bool,
+) -> Name:
+    # Make "name" absolute if needed, ensure that the origin is absolute,
+    # call function(), and then relativize the result if needed.
+    if not origin.is_absolute():
+        raise NeedAbsoluteNameOrOrigin
+    relative = not name.is_absolute()
+    if relative:
+        name = name.derelativize(origin)
+    elif not name.is_subdomain(origin):
+        raise NeedSubdomainOfOrigin
+    result_name = function(name, origin, prefix_ok)
+    if relative:
+        result_name = result_name.relativize(origin)
+    return result_name
diff --git a/lib/dns/nameserver.py b/lib/dns/nameserver.py
index 5910139e..5dbb4e8b 100644
--- a/lib/dns/nameserver.py
+++ b/lib/dns/nameserver.py
@@ -115,6 +115,8 @@ class Do53Nameserver(AddressAndPortNameserver):
                 raise_on_truncation=True,
                 one_rr_per_rrset=one_rr_per_rrset,
                 ignore_trailing=ignore_trailing,
+                ignore_errors=True,
+                ignore_unexpected=True,
             )
         return response
 
@@ -153,15 +155,25 @@ class Do53Nameserver(AddressAndPortNameserver):
                 backend=backend,
                 one_rr_per_rrset=one_rr_per_rrset,
                 ignore_trailing=ignore_trailing,
+                ignore_errors=True,
+                ignore_unexpected=True,
             )
         return response
 
 
 class DoHNameserver(Nameserver):
-    def __init__(self, url: str, bootstrap_address: Optional[str] = None):
+    def __init__(
+        self,
+        url: str,
+        bootstrap_address: Optional[str] = None,
+        verify: Union[bool, str] = True,
+        want_get: bool = False,
+    ):
         super().__init__()
         self.url = url
         self.bootstrap_address = bootstrap_address
+        self.verify = verify
+        self.want_get = want_get
 
     def kind(self):
         return "DoH"
@@ -195,9 +207,13 @@ class DoHNameserver(Nameserver):
             request,
             self.url,
             timeout=timeout,
+            source=source,
+            source_port=source_port,
             bootstrap_address=self.bootstrap_address,
             one_rr_per_rrset=one_rr_per_rrset,
             ignore_trailing=ignore_trailing,
+            verify=self.verify,
+            post=(not self.want_get),
         )
 
     async def async_query(
@@ -215,15 +231,27 @@ class DoHNameserver(Nameserver):
             request,
             self.url,
             timeout=timeout,
+            source=source,
+            source_port=source_port,
+            bootstrap_address=self.bootstrap_address,
             one_rr_per_rrset=one_rr_per_rrset,
             ignore_trailing=ignore_trailing,
+            verify=self.verify,
+            post=(not self.want_get),
         )
 
 
 class DoTNameserver(AddressAndPortNameserver):
-    def __init__(self, address: str, port: int = 853, hostname: Optional[str] = None):
+    def __init__(
+        self,
+        address: str,
+        port: int = 853,
+        hostname: Optional[str] = None,
+        verify: Union[bool, str] = True,
+    ):
         super().__init__(address, port)
         self.hostname = hostname
+        self.verify = verify
 
     def kind(self):
         return "DoT"
@@ -246,6 +274,7 @@ class DoTNameserver(AddressAndPortNameserver):
             one_rr_per_rrset=one_rr_per_rrset,
             ignore_trailing=ignore_trailing,
             server_hostname=self.hostname,
+            verify=self.verify,
         )
 
     async def async_query(
@@ -267,6 +296,7 @@ class DoTNameserver(AddressAndPortNameserver):
             one_rr_per_rrset=one_rr_per_rrset,
             ignore_trailing=ignore_trailing,
             server_hostname=self.hostname,
+            verify=self.verify,
         )
 
 
diff --git a/lib/dns/node.py b/lib/dns/node.py
index c670243c..de85a82d 100644
--- a/lib/dns/node.py
+++ b/lib/dns/node.py
@@ -70,7 +70,6 @@ class NodeKind(enum.Enum):
 
 
 class Node:
-
     """A Node is a set of rdatasets.
 
     A node is either a CNAME node or an "other data" node.  A CNAME
diff --git a/lib/dns/query.py b/lib/dns/query.py
index 0d711251..f0ee9161 100644
--- a/lib/dns/query.py
+++ b/lib/dns/query.py
@@ -22,12 +22,14 @@ import contextlib
 import enum
 import errno
 import os
+import os.path
 import selectors
 import socket
 import struct
 import time
 from typing import Any, Dict, Optional, Tuple, Union
 
+import dns._features
 import dns.exception
 import dns.inet
 import dns.message
@@ -57,24 +59,14 @@ def _expiration_for_this_attempt(timeout, expiration):
     return min(time.time() + timeout, expiration)
 
 
-_have_httpx = False
-_have_http2 = False
-try:
-    import httpcore
+_have_httpx = dns._features.have("doh")
+if _have_httpx:
     import httpcore._backends.sync
     import httpx
 
     _CoreNetworkBackend = httpcore.NetworkBackend
     _CoreSyncStream = httpcore._backends.sync.SyncStream
 
-    _have_httpx = True
-    try:
-        # See if http2 support is available.
-        with httpx.Client(http2=True):
-            _have_http2 = True
-    except Exception:
-        pass
-
     class _NetworkBackend(_CoreNetworkBackend):
         def __init__(self, resolver, local_port, bootstrap_address, family):
             super().__init__()
@@ -147,7 +139,7 @@ try:
                 resolver, local_port, bootstrap_address, family
             )
 
-except ImportError:  # pragma: no cover
+else:
 
     class _HTTPTransport:  # type: ignore
         def connect_tcp(self, host, port, timeout, local_address):
@@ -161,6 +153,8 @@ try:
 except ImportError:  # pragma: no cover
 
     class ssl:  # type: ignore
+        CERT_NONE = 0
+
         class WantReadException(Exception):
             pass
 
@@ -459,7 +453,7 @@ def https(
     transport = _HTTPTransport(
         local_address=local_address,
         http1=True,
-        http2=_have_http2,
+        http2=True,
         verify=verify,
         local_port=local_port,
         bootstrap_address=bootstrap_address,
@@ -470,9 +464,7 @@ def https(
     if session:
         cm: contextlib.AbstractContextManager = contextlib.nullcontext(session)
     else:
-        cm = httpx.Client(
-            http1=True, http2=_have_http2, verify=verify, transport=transport
-        )
+        cm = httpx.Client(http1=True, http2=True, verify=verify, transport=transport)
     with cm as session:
         # see https://tools.ietf.org/html/rfc8484#section-4.1.1 for DoH
         # GET and POST examples
@@ -577,6 +569,8 @@ def receive_udp(
     request_mac: Optional[bytes] = b"",
     ignore_trailing: bool = False,
     raise_on_truncation: bool = False,
+    ignore_errors: bool = False,
+    query: Optional[dns.message.Message] = None,
 ) -> Any:
     """Read a DNS message from a UDP socket.
 
@@ -617,28 +611,58 @@ def receive_udp(
     ``(dns.message.Message, float, tuple)``
     tuple of the received message, the received time, and the address where
     the message arrived from.
+
+    *ignore_errors*, a ``bool``.  If various format errors or response
+    mismatches occur, ignore them and keep listening for a valid response.
+    The default is ``False``.
+
+    *query*, a ``dns.message.Message`` or ``None``.  If not ``None`` and
+    *ignore_errors* is ``True``, check that the received message is a response
+    to this query, and if not keep listening for a valid response.
     """
 
     wire = b""
     while True:
         (wire, from_address) = _udp_recv(sock, 65535, expiration)
-        if _matches_destination(
+        if not _matches_destination(
             sock.family, from_address, destination, ignore_unexpected
         ):
-            break
-    received_time = time.time()
-    r = dns.message.from_wire(
-        wire,
-        keyring=keyring,
-        request_mac=request_mac,
-        one_rr_per_rrset=one_rr_per_rrset,
-        ignore_trailing=ignore_trailing,
-        raise_on_truncation=raise_on_truncation,
-    )
-    if destination:
-        return (r, received_time)
-    else:
-        return (r, received_time, from_address)
+            continue
+        received_time = time.time()
+        try:
+            r = dns.message.from_wire(
+                wire,
+                keyring=keyring,
+                request_mac=request_mac,
+                one_rr_per_rrset=one_rr_per_rrset,
+                ignore_trailing=ignore_trailing,
+                raise_on_truncation=raise_on_truncation,
+            )
+        except dns.message.Truncated as e:
+            # If we got Truncated and not FORMERR, we at least got the header with TC
+            # set, and very likely the question section, so we'll re-raise if the
+            # message seems to be a response as we need to know when truncation happens.
+            # We need to check that it seems to be a response as we don't want a random
+            # injected message with TC set to cause us to bail out.
+            if (
+                ignore_errors
+                and query is not None
+                and not query.is_response(e.message())
+            ):
+                continue
+            else:
+                raise
+        except Exception:
+            if ignore_errors:
+                continue
+            else:
+                raise
+        if ignore_errors and query is not None and not query.is_response(r):
+            continue
+        if destination:
+            return (r, received_time)
+        else:
+            return (r, received_time, from_address)
 
 
 def udp(
@@ -653,6 +677,7 @@ def udp(
     ignore_trailing: bool = False,
     raise_on_truncation: bool = False,
     sock: Optional[Any] = None,
+    ignore_errors: bool = False,
 ) -> dns.message.Message:
     """Return the response obtained after sending a query via UDP.
 
@@ -689,6 +714,10 @@ def udp(
     if a socket is provided, it must be a nonblocking datagram socket,
     and the *source* and *source_port* are ignored.
 
+    *ignore_errors*, a ``bool``.  If various format errors or response
+    mismatches occur, ignore them and keep listening for a valid response.
+    The default is ``False``.
+
     Returns a ``dns.message.Message``.
     """
 
@@ -713,9 +742,13 @@ def udp(
             q.mac,
             ignore_trailing,
             raise_on_truncation,
+            ignore_errors,
+            q,
         )
         r.time = received_time - begin_time
-        if not q.is_response(r):
+        # We don't need to check q.is_response() if we are in ignore_errors mode
+        # as receive_udp() will have checked it.
+        if not (ignore_errors or q.is_response(r)):
             raise BadResponse
         return r
     assert (
@@ -735,48 +768,50 @@ def udp_with_fallback(
     ignore_trailing: bool = False,
     udp_sock: Optional[Any] = None,
     tcp_sock: Optional[Any] = None,
+    ignore_errors: bool = False,
 ) -> Tuple[dns.message.Message, bool]:
     """Return the response to the query, trying UDP first and falling back
     to TCP if UDP results in a truncated response.
 
     *q*, a ``dns.message.Message``, the query to send
 
-    *where*, a ``str`` containing an IPv4 or IPv6 address,  where
-    to send the message.
+    *where*, a ``str`` containing an IPv4 or IPv6 address,  where to send the message.
 
-    *timeout*, a ``float`` or ``None``, the number of seconds to wait before the
-    query times out.  If ``None``, the default, wait forever.
+    *timeout*, a ``float`` or ``None``, the number of seconds to wait before the query
+    times out.  If ``None``, the default, wait forever.
 
     *port*, an ``int``, the port send the message to.  The default is 53.
 
-    *source*, a ``str`` containing an IPv4 or IPv6 address, specifying
-    the source address.  The default is the wildcard address.
+    *source*, a ``str`` containing an IPv4 or IPv6 address, specifying the source
+    address.  The default is the wildcard address.
 
-    *source_port*, an ``int``, the port from which to send the message.
-    The default is 0.
+    *source_port*, an ``int``, the port from which to send the message. The default is
+    0.
 
-    *ignore_unexpected*, a ``bool``.  If ``True``, ignore responses from
-    unexpected sources.
+    *ignore_unexpected*, a ``bool``.  If ``True``, ignore responses from unexpected
+    sources.
 
-    *one_rr_per_rrset*, a ``bool``.  If ``True``, put each RR into its own
-    RRset.
+    *one_rr_per_rrset*, a ``bool``.  If ``True``, put each RR into its own RRset.
 
-    *ignore_trailing*, a ``bool``.  If ``True``, ignore trailing
-    junk at end of the received message.
+    *ignore_trailing*, a ``bool``.  If ``True``, ignore trailing junk at end of the
+    received message.
 
-    *udp_sock*, a ``socket.socket``, or ``None``, the socket to use for the
-    UDP query.  If ``None``, the default, a socket is created.  Note that
-    if a socket is provided, it must be a nonblocking datagram socket,
-    and the *source* and *source_port* are ignored for the UDP query.
+    *udp_sock*, a ``socket.socket``, or ``None``, the socket to use for the UDP query.
+    If ``None``, the default, a socket is created.  Note that if a socket is provided,
+    it must be a nonblocking datagram socket, and the *source* and *source_port* are
+    ignored for the UDP query.
 
     *tcp_sock*, a ``socket.socket``, or ``None``, the connected socket to use for the
-    TCP query.  If ``None``, the default, a socket is created.  Note that
-    if a socket is provided, it must be a nonblocking connected stream
-    socket, and *where*, *source* and *source_port* are ignored for the TCP
-    query.
+    TCP query.  If ``None``, the default, a socket is created.  Note that if a socket is
+    provided, it must be a nonblocking connected stream socket, and *where*, *source*
+    and *source_port* are ignored for the TCP query.
 
-    Returns a (``dns.message.Message``, tcp) tuple where tcp is ``True``
-    if and only if TCP was used.
+    *ignore_errors*, a ``bool``.  If various format errors or response mismatches occur
+    while listening for UDP, ignore them and keep listening for a valid response. The
+    default is ``False``.
+
+    Returns a (``dns.message.Message``, tcp) tuple where tcp is ``True`` if and only if
+    TCP was used.
     """
     try:
         response = udp(
@@ -791,6 +826,7 @@ def udp_with_fallback(
             ignore_trailing,
             True,
             udp_sock,
+            ignore_errors,
         )
         return (response, False)
     except dns.message.Truncated:
@@ -864,14 +900,12 @@ def send_tcp(
     """
 
     if isinstance(what, dns.message.Message):
-        wire = what.to_wire()
+        tcpmsg = what.to_wire(prepend_length=True)
     else:
-        wire = what
-    l = len(wire)
-    # copying the wire into tcpmsg is inefficient, but lets us
-    # avoid writev() or doing a short write that would get pushed
-    # onto the net
-    tcpmsg = struct.pack("!H", l) + wire
+        # copying the wire into tcpmsg is inefficient, but lets us
+        # avoid writev() or doing a short write that would get pushed
+        # onto the net
+        tcpmsg = len(what).to_bytes(2, "big") + what
     sent_time = time.time()
     _net_write(sock, tcpmsg, expiration)
     return (len(tcpmsg), sent_time)
@@ -1014,6 +1048,28 @@ def _tls_handshake(s, expiration):
             _wait_for_writable(s, expiration)
 
 
+def _make_dot_ssl_context(
+    server_hostname: Optional[str], verify: Union[bool, str]
+) -> ssl.SSLContext:
+    cafile: Optional[str] = None
+    capath: Optional[str] = None
+    if isinstance(verify, str):
+        if os.path.isfile(verify):
+            cafile = verify
+        elif os.path.isdir(verify):
+            capath = verify
+        else:
+            raise ValueError("invalid verify string")
+    ssl_context = ssl.create_default_context(cafile=cafile, capath=capath)
+    ssl_context.minimum_version = ssl.TLSVersion.TLSv1_2
+    if server_hostname is None:
+        ssl_context.check_hostname = False
+    ssl_context.set_alpn_protocols(["dot"])
+    if verify is False:
+        ssl_context.verify_mode = ssl.CERT_NONE
+    return ssl_context
+
+
 def tls(
     q: dns.message.Message,
     where: str,
@@ -1026,6 +1082,7 @@ def tls(
     sock: Optional[ssl.SSLSocket] = None,
     ssl_context: Optional[ssl.SSLContext] = None,
     server_hostname: Optional[str] = None,
+    verify: Union[bool, str] = True,
 ) -> dns.message.Message:
     """Return the response obtained after sending a query via TLS.
 
@@ -1065,6 +1122,11 @@ def tls(
     default is ``None``, which means that no hostname is known, and if an
     SSL context is created, hostname checking will be disabled.
 
+    *verify*, a ``bool`` or ``str``.  If a ``True``, then TLS certificate verification
+    of the server is done using the default CA bundle; if ``False``, then no
+    verification is done; if a `str` then it specifies the path to a certificate file or
+    directory which will be used for verification.
+
     Returns a ``dns.message.Message``.
 
     """
@@ -1091,10 +1153,7 @@ def tls(
         where, port, source, source_port
     )
     if ssl_context is None and not sock:
-        ssl_context = ssl.create_default_context()
-        ssl_context.minimum_version = ssl.TLSVersion.TLSv1_2
-        if server_hostname is None:
-            ssl_context.check_hostname = False
+        ssl_context = _make_dot_ssl_context(server_hostname, verify)
 
     with _make_socket(
         af,
diff --git a/lib/dns/quic/__init__.py b/lib/dns/quic/__init__.py
index 69813f9f..20aff345 100644
--- a/lib/dns/quic/__init__.py
+++ b/lib/dns/quic/__init__.py
@@ -1,9 +1,11 @@
 # Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license
 
-try:
+import dns._features
+import dns.asyncbackend
+
+if dns._features.have("doq"):
     import aioquic.quic.configuration  # type: ignore
 
-    import dns.asyncbackend
     from dns._asyncbackend import NullContext
     from dns.quic._asyncio import (
         AsyncioQuicConnection,
@@ -17,7 +19,7 @@ try:
 
     def null_factory(
         *args,  # pylint: disable=unused-argument
-        **kwargs  # pylint: disable=unused-argument
+        **kwargs,  # pylint: disable=unused-argument
     ):
         return NullContext(None)
 
@@ -31,7 +33,7 @@ try:
 
     _async_factories = {"asyncio": (null_factory, _asyncio_manager_factory)}
 
-    try:
+    if dns._features.have("trio"):
         import trio
 
         from dns.quic._trio import (  # pylint: disable=ungrouped-imports
@@ -47,15 +49,13 @@ try:
             return TrioQuicManager(context, *args, **kwargs)
 
         _async_factories["trio"] = (_trio_context_factory, _trio_manager_factory)
-    except ImportError:
-        pass
 
     def factories_for_backend(backend=None):
         if backend is None:
             backend = dns.asyncbackend.get_default_backend()
         return _async_factories[backend.name()]
 
-except ImportError:
+else:  # pragma: no cover
     have_quic = False
 
     from typing import Any
diff --git a/lib/dns/quic/_asyncio.py b/lib/dns/quic/_asyncio.py
index e1c52339..0f44331f 100644
--- a/lib/dns/quic/_asyncio.py
+++ b/lib/dns/quic/_asyncio.py
@@ -101,9 +101,7 @@ class AsyncioQuicConnection(AsyncQuicConnection):
                     )
                     if address[0] != self._peer[0] or address[1] != self._peer[1]:
                         continue
-                    self._connection.receive_datagram(
-                        datagram, self._peer[0], time.time()
-                    )
+                    self._connection.receive_datagram(datagram, address, time.time())
                     # Wake up the timer in case the sender is sleeping, as there may be
                     # stuff to send now.
                     async with self._wake_timer:
@@ -125,7 +123,7 @@ class AsyncioQuicConnection(AsyncQuicConnection):
         while not self._done:
             datagrams = self._connection.datagrams_to_send(time.time())
             for datagram, address in datagrams:
-                assert address == self._peer[0]
+                assert address == self._peer
                 await self._socket.sendto(datagram, self._peer, None)
             (expiration, interval) = self._get_timer_values()
             try:
@@ -147,11 +145,14 @@ class AsyncioQuicConnection(AsyncQuicConnection):
                     await stream._add_input(event.data, event.end_stream)
             elif isinstance(event, aioquic.quic.events.HandshakeCompleted):
                 self._handshake_complete.set()
-            elif isinstance(
-                event, aioquic.quic.events.ConnectionTerminated
-            ) or isinstance(event, aioquic.quic.events.StreamReset):
+            elif isinstance(event, aioquic.quic.events.ConnectionTerminated):
                 self._done = True
                 self._receiver_task.cancel()
+            elif isinstance(event, aioquic.quic.events.StreamReset):
+                stream = self._streams.get(event.stream_id)
+                if stream:
+                    await stream._add_input(b"", True)
+
             count += 1
             if count > 10:
                 # yield
@@ -188,7 +189,6 @@ class AsyncioQuicConnection(AsyncQuicConnection):
             self._connection.close()
             # sender might be blocked on this, so set it
             self._socket_created.set()
-            await self._socket.close()
             async with self._wake_timer:
                 self._wake_timer.notify_all()
             try:
@@ -199,14 +199,19 @@ class AsyncioQuicConnection(AsyncQuicConnection):
                 await self._sender_task
             except asyncio.CancelledError:
                 pass
+            await self._socket.close()
 
 
 class AsyncioQuicManager(AsyncQuicManager):
     def __init__(self, conf=None, verify_mode=ssl.CERT_REQUIRED, server_name=None):
         super().__init__(conf, verify_mode, AsyncioQuicConnection, server_name)
 
-    def connect(self, address, port=853, source=None, source_port=0):
-        (connection, start) = self._connect(address, port, source, source_port)
+    def connect(
+        self, address, port=853, source=None, source_port=0, want_session_ticket=True
+    ):
+        (connection, start) = self._connect(
+            address, port, source, source_port, want_session_ticket
+        )
         if start:
             connection.run()
         return connection
diff --git a/lib/dns/quic/_common.py b/lib/dns/quic/_common.py
index 38ec103f..0eacc691 100644
--- a/lib/dns/quic/_common.py
+++ b/lib/dns/quic/_common.py
@@ -1,5 +1,7 @@
 # Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license
 
+import copy
+import functools
 import socket
 import struct
 import time
@@ -11,6 +13,10 @@ import aioquic.quic.connection  # type: ignore
 import dns.inet
 
 QUIC_MAX_DATAGRAM = 2048
+MAX_SESSION_TICKETS = 8
+# If we hit the max sessions limit we will delete this many of the oldest connections.
+# The value must be a integer > 0 and <= MAX_SESSION_TICKETS.
+SESSIONS_TO_DELETE = MAX_SESSION_TICKETS // 4
 
 
 class UnexpectedEOF(Exception):
@@ -79,7 +85,10 @@ class BaseQuicStream:
 
     def _common_add_input(self, data, is_end):
         self._buffer.put(data, is_end)
-        return self._expecting > 0 and self._buffer.have(self._expecting)
+        try:
+            return self._expecting > 0 and self._buffer.have(self._expecting)
+        except UnexpectedEOF:
+            return True
 
     def _close(self):
         self._connection.close_stream(self._stream_id)
@@ -142,6 +151,7 @@ class BaseQuicManager:
     def __init__(self, conf, verify_mode, connection_factory, server_name=None):
         self._connections = {}
         self._connection_factory = connection_factory
+        self._session_tickets = {}
         if conf is None:
             verify_path = None
             if isinstance(verify_mode, str):
@@ -156,12 +166,35 @@ class BaseQuicManager:
                 conf.load_verify_locations(verify_path)
         self._conf = conf
 
-    def _connect(self, address, port=853, source=None, source_port=0):
+    def _connect(
+        self, address, port=853, source=None, source_port=0, want_session_ticket=True
+    ):
         connection = self._connections.get((address, port))
         if connection is not None:
             return (connection, False)
-        qconn = aioquic.quic.connection.QuicConnection(configuration=self._conf)
-        qconn.connect(address, time.time())
+        conf = self._conf
+        if want_session_ticket:
+            try:
+                session_ticket = self._session_tickets.pop((address, port))
+                # We found a session ticket, so make a configuration that uses it.
+                conf = copy.copy(conf)
+                conf.session_ticket = session_ticket
+            except KeyError:
+                # No session ticket.
+                pass
+            # Whether or not we found a session ticket, we want a handler to save
+            # one.
+            session_ticket_handler = functools.partial(
+                self.save_session_ticket, address, port
+            )
+        else:
+            session_ticket_handler = None
+        qconn = aioquic.quic.connection.QuicConnection(
+            configuration=conf,
+            session_ticket_handler=session_ticket_handler,
+        )
+        lladdress = dns.inet.low_level_address_tuple((address, port))
+        qconn.connect(lladdress, time.time())
         connection = self._connection_factory(
             qconn, address, port, source, source_port, self
         )
@@ -174,6 +207,17 @@ class BaseQuicManager:
         except KeyError:
             pass
 
+    def save_session_ticket(self, address, port, ticket):
+        # We rely on dictionaries keys() being in insertion order here.  We
+        # can't just popitem() as that would be LIFO which is the opposite of
+        # what we want.
+        l = len(self._session_tickets)
+        if l >= MAX_SESSION_TICKETS:
+            keys_to_delete = list(self._session_tickets.keys())[0:SESSIONS_TO_DELETE]
+            for key in keys_to_delete:
+                del self._session_tickets[key]
+        self._session_tickets[(address, port)] = ticket
+
 
 class AsyncQuicManager(BaseQuicManager):
     def connect(self, address, port=853, source=None, source_port=0):
diff --git a/lib/dns/quic/_sync.py b/lib/dns/quic/_sync.py
index e944784d..120cb5f3 100644
--- a/lib/dns/quic/_sync.py
+++ b/lib/dns/quic/_sync.py
@@ -82,10 +82,6 @@ class SyncQuicConnection(BaseQuicConnection):
     def __init__(self, connection, address, port, source, source_port, manager):
         super().__init__(connection, address, port, source, source_port, manager)
         self._socket = socket.socket(self._af, socket.SOCK_DGRAM, 0)
-        self._socket.connect(self._peer)
-        (self._send_wakeup, self._receive_wakeup) = socket.socketpair()
-        self._receive_wakeup.setblocking(False)
-        self._socket.setblocking(False)
         if self._source is not None:
             try:
                 self._socket.bind(
@@ -94,6 +90,10 @@ class SyncQuicConnection(BaseQuicConnection):
             except Exception:
                 self._socket.close()
                 raise
+        self._socket.connect(self._peer)
+        (self._send_wakeup, self._receive_wakeup) = socket.socketpair()
+        self._receive_wakeup.setblocking(False)
+        self._socket.setblocking(False)
         self._handshake_complete = threading.Event()
         self._worker_thread = None
         self._lock = threading.Lock()
@@ -107,7 +107,7 @@ class SyncQuicConnection(BaseQuicConnection):
             except BlockingIOError:
                 return
             with self._lock:
-                self._connection.receive_datagram(datagram, self._peer[0], time.time())
+                self._connection.receive_datagram(datagram, self._peer, time.time())
 
     def _drain_wakeup(self):
         while True:
@@ -128,6 +128,8 @@ class SyncQuicConnection(BaseQuicConnection):
                     key.data()
                 with self._lock:
                     self._handle_timer(expiration)
+                self._handle_events()
+                with self._lock:
                     datagrams = self._connection.datagrams_to_send(time.time())
                 for datagram, _ in datagrams:
                     try:
@@ -135,7 +137,6 @@ class SyncQuicConnection(BaseQuicConnection):
                     except BlockingIOError:
                         # we let QUIC handle any lossage
                         pass
-                self._handle_events()
         finally:
             with self._lock:
                 self._done = True
@@ -155,11 +156,14 @@ class SyncQuicConnection(BaseQuicConnection):
                     stream._add_input(event.data, event.end_stream)
             elif isinstance(event, aioquic.quic.events.HandshakeCompleted):
                 self._handshake_complete.set()
-            elif isinstance(
-                event, aioquic.quic.events.ConnectionTerminated
-            ) or isinstance(event, aioquic.quic.events.StreamReset):
+            elif isinstance(event, aioquic.quic.events.ConnectionTerminated):
                 with self._lock:
                     self._done = True
+            elif isinstance(event, aioquic.quic.events.StreamReset):
+                with self._lock:
+                    stream = self._streams.get(event.stream_id)
+                if stream:
+                    stream._add_input(b"", True)
 
     def write(self, stream, data, is_end=False):
         with self._lock:
@@ -203,9 +207,13 @@ class SyncQuicManager(BaseQuicManager):
         super().__init__(conf, verify_mode, SyncQuicConnection, server_name)
         self._lock = threading.Lock()
 
-    def connect(self, address, port=853, source=None, source_port=0):
+    def connect(
+        self, address, port=853, source=None, source_port=0, want_session_ticket=True
+    ):
         with self._lock:
-            (connection, start) = self._connect(address, port, source, source_port)
+            (connection, start) = self._connect(
+                address, port, source, source_port, want_session_ticket
+            )
             if start:
                 connection.run()
             return connection
@@ -214,6 +222,10 @@ class SyncQuicManager(BaseQuicManager):
         with self._lock:
             super().closed(address, port)
 
+    def save_session_ticket(self, address, port, ticket):
+        with self._lock:
+            super().save_session_ticket(address, port, ticket)
+
     def __enter__(self):
         return self
 
diff --git a/lib/dns/quic/_trio.py b/lib/dns/quic/_trio.py
index ee07e4f6..35e36b98 100644
--- a/lib/dns/quic/_trio.py
+++ b/lib/dns/quic/_trio.py
@@ -76,30 +76,43 @@ class TrioQuicConnection(AsyncQuicConnection):
     def __init__(self, connection, address, port, source, source_port, manager=None):
         super().__init__(connection, address, port, source, source_port, manager)
         self._socket = trio.socket.socket(self._af, socket.SOCK_DGRAM, 0)
-        if self._source:
-            trio.socket.bind(dns.inet.low_level_address_tuple(self._source, self._af))
         self._handshake_complete = trio.Event()
         self._run_done = trio.Event()
         self._worker_scope = None
+        self._send_pending = False
 
     async def _worker(self):
         try:
+            if self._source:
+                await self._socket.bind(
+                    dns.inet.low_level_address_tuple(self._source, self._af)
+                )
             await self._socket.connect(self._peer)
             while not self._done:
                 (expiration, interval) = self._get_timer_values(False)
+                if self._send_pending:
+                    # Do not block forever if sends are pending.  Even though we
+                    # have a wake-up mechanism if we've already started the blocking
+                    # read, the possibility of context switching in send means that
+                    # more writes can happen while we have no wake up context, so
+                    # we need self._send_pending to avoid (effectively) a "lost wakeup"
+                    # race.
+                    interval = 0.0
                 with trio.CancelScope(
                     deadline=trio.current_time() + interval
                 ) as self._worker_scope:
                     datagram = await self._socket.recv(QUIC_MAX_DATAGRAM)
-                    self._connection.receive_datagram(
-                        datagram, self._peer[0], time.time()
-                    )
+                    self._connection.receive_datagram(datagram, self._peer, time.time())
                 self._worker_scope = None
                 self._handle_timer(expiration)
+                await self._handle_events()
+                # We clear this now, before sending anything, as sending can cause
+                # context switches that do more sends.  We want to know if that
+                # happens so we don't block a long time on the recv() above.
+                self._send_pending = False
                 datagrams = self._connection.datagrams_to_send(time.time())
                 for datagram, _ in datagrams:
                     await self._socket.send(datagram)
-                await self._handle_events()
         finally:
             self._done = True
             self._handshake_complete.set()
@@ -116,11 +129,13 @@ class TrioQuicConnection(AsyncQuicConnection):
                     await stream._add_input(event.data, event.end_stream)
             elif isinstance(event, aioquic.quic.events.HandshakeCompleted):
                 self._handshake_complete.set()
-            elif isinstance(
-                event, aioquic.quic.events.ConnectionTerminated
-            ) or isinstance(event, aioquic.quic.events.StreamReset):
+            elif isinstance(event, aioquic.quic.events.ConnectionTerminated):
                 self._done = True
                 self._socket.close()
+            elif isinstance(event, aioquic.quic.events.StreamReset):
+                stream = self._streams.get(event.stream_id)
+                if stream:
+                    await stream._add_input(b"", True)
             count += 1
             if count > 10:
                 # yield
@@ -129,6 +144,7 @@ class TrioQuicConnection(AsyncQuicConnection):
 
     async def write(self, stream, data, is_end=False):
         self._connection.send_stream_data(stream, data, is_end)
+        self._send_pending = True
         if self._worker_scope is not None:
             self._worker_scope.cancel()
 
@@ -159,6 +175,7 @@ class TrioQuicConnection(AsyncQuicConnection):
             self._manager.closed(self._peer[0], self._peer[1])
             self._closed = True
             self._connection.close()
+            self._send_pending = True
             if self._worker_scope is not None:
                 self._worker_scope.cancel()
             await self._run_done.wait()
@@ -171,8 +188,12 @@ class TrioQuicManager(AsyncQuicManager):
         super().__init__(conf, verify_mode, TrioQuicConnection, server_name)
         self._nursery = nursery
 
-    def connect(self, address, port=853, source=None, source_port=0):
-        (connection, start) = self._connect(address, port, source, source_port)
+    def connect(
+        self, address, port=853, source=None, source_port=0, want_session_ticket=True
+    ):
+        (connection, start) = self._connect(
+            address, port, source, source_port, want_session_ticket
+        )
         if start:
             self._nursery.start_soon(connection.run)
         return connection
diff --git a/lib/dns/rdata.py b/lib/dns/rdata.py
index 0d262e8d..024fd8f6 100644
--- a/lib/dns/rdata.py
+++ b/lib/dns/rdata.py
@@ -199,7 +199,7 @@ class Rdata:
         self,
         origin: Optional[dns.name.Name] = None,
         relativize: bool = True,
-        **kw: Dict[str, Any]
+        **kw: Dict[str, Any],
     ) -> str:
         """Convert an rdata to text format.
 
@@ -547,9 +547,7 @@ class Rdata:
     @classmethod
     def _as_ipv4_address(cls, value):
         if isinstance(value, str):
-            # call to check validity
-            dns.ipv4.inet_aton(value)
-            return value
+            return dns.ipv4.canonicalize(value)
         elif isinstance(value, bytes):
             return dns.ipv4.inet_ntoa(value)
         else:
@@ -558,9 +556,7 @@ class Rdata:
     @classmethod
     def _as_ipv6_address(cls, value):
         if isinstance(value, str):
-            # call to check validity
-            dns.ipv6.inet_aton(value)
-            return value
+            return dns.ipv6.canonicalize(value)
         elif isinstance(value, bytes):
             return dns.ipv6.inet_ntoa(value)
         else:
@@ -604,7 +600,6 @@ class Rdata:
 
 @dns.immutable.immutable
 class GenericRdata(Rdata):
-
     """Generic Rdata Class
 
     This class is used for rdata types for which we have no better
@@ -621,7 +616,7 @@ class GenericRdata(Rdata):
         self,
         origin: Optional[dns.name.Name] = None,
         relativize: bool = True,
-        **kw: Dict[str, Any]
+        **kw: Dict[str, Any],
     ) -> str:
         return r"\# %d " % len(self.data) + _hexify(self.data, **kw)
 
@@ -647,9 +642,9 @@ class GenericRdata(Rdata):
         return cls(rdclass, rdtype, parser.get_remaining())
 
 
-_rdata_classes: Dict[
-    Tuple[dns.rdataclass.RdataClass, dns.rdatatype.RdataType], Any
-] = {}
+_rdata_classes: Dict[Tuple[dns.rdataclass.RdataClass, dns.rdatatype.RdataType], Any] = (
+    {}
+)
 _module_prefix = "dns.rdtypes"
 
 
diff --git a/lib/dns/rdataset.py b/lib/dns/rdataset.py
index 31124afc..8bff58d7 100644
--- a/lib/dns/rdataset.py
+++ b/lib/dns/rdataset.py
@@ -28,6 +28,7 @@ import dns.name
 import dns.rdata
 import dns.rdataclass
 import dns.rdatatype
+import dns.renderer
 import dns.set
 import dns.ttl
 
@@ -45,7 +46,6 @@ class IncompatibleTypes(dns.exception.DNSException):
 
 
 class Rdataset(dns.set.Set):
-
     """A DNS rdataset."""
 
     __slots__ = ["rdclass", "rdtype", "covers", "ttl"]
@@ -316,11 +316,9 @@ class Rdataset(dns.set.Set):
             want_shuffle = False
         else:
             rdclass = self.rdclass
-        file.seek(0, io.SEEK_END)
         if len(self) == 0:
             name.to_wire(file, compress, origin)
-            stuff = struct.pack("!HHIH", self.rdtype, rdclass, 0, 0)
-            file.write(stuff)
+            file.write(struct.pack("!HHIH", self.rdtype, rdclass, 0, 0))
             return 1
         else:
             l: Union[Rdataset, List[dns.rdata.Rdata]]
@@ -331,16 +329,9 @@ class Rdataset(dns.set.Set):
                 l = self
             for rd in l:
                 name.to_wire(file, compress, origin)
-                stuff = struct.pack("!HHIH", self.rdtype, rdclass, self.ttl, 0)
-                file.write(stuff)
-                start = file.tell()
-                rd.to_wire(file, compress, origin)
-                end = file.tell()
-                assert end - start < 65536
-                file.seek(start - 2)
-                stuff = struct.pack("!H", end - start)
-                file.write(stuff)
-                file.seek(0, io.SEEK_END)
+                file.write(struct.pack("!HHI", self.rdtype, rdclass, self.ttl))
+                with dns.renderer.prefixed_length(file, 2):
+                    rd.to_wire(file, compress, origin)
             return len(self)
 
     def match(
@@ -373,7 +364,6 @@ class Rdataset(dns.set.Set):
 
 @dns.immutable.immutable
 class ImmutableRdataset(Rdataset):  # lgtm[py/missing-equals]
-
     """An immutable DNS rdataset."""
 
     _clone_class = Rdataset
diff --git a/lib/dns/rdtypes/ANY/AFSDB.py b/lib/dns/rdtypes/ANY/AFSDB.py
index 3d287f6e..06a3b970 100644
--- a/lib/dns/rdtypes/ANY/AFSDB.py
+++ b/lib/dns/rdtypes/ANY/AFSDB.py
@@ -21,7 +21,6 @@ import dns.rdtypes.mxbase
 
 @dns.immutable.immutable
 class AFSDB(dns.rdtypes.mxbase.UncompressedDowncasingMX):
-
     """AFSDB record"""
 
     # Use the property mechanism to make "subtype" an alias for the
diff --git a/lib/dns/rdtypes/ANY/AMTRELAY.py b/lib/dns/rdtypes/ANY/AMTRELAY.py
index dfe7abc3..ed2b072b 100644
--- a/lib/dns/rdtypes/ANY/AMTRELAY.py
+++ b/lib/dns/rdtypes/ANY/AMTRELAY.py
@@ -32,7 +32,6 @@ class Relay(dns.rdtypes.util.Gateway):
 
 @dns.immutable.immutable
 class AMTRELAY(dns.rdata.Rdata):
-
     """AMTRELAY record"""
 
     # see: RFC 8777
diff --git a/lib/dns/rdtypes/ANY/AVC.py b/lib/dns/rdtypes/ANY/AVC.py
index 766d5e2d..a27ae2d6 100644
--- a/lib/dns/rdtypes/ANY/AVC.py
+++ b/lib/dns/rdtypes/ANY/AVC.py
@@ -21,7 +21,6 @@ import dns.rdtypes.txtbase
 
 @dns.immutable.immutable
 class AVC(dns.rdtypes.txtbase.TXTBase):
-
     """AVC record"""
 
     # See: IANA dns parameters for AVC
diff --git a/lib/dns/rdtypes/ANY/CAA.py b/lib/dns/rdtypes/ANY/CAA.py
index 8afb538c..2e6a7e7e 100644
--- a/lib/dns/rdtypes/ANY/CAA.py
+++ b/lib/dns/rdtypes/ANY/CAA.py
@@ -25,7 +25,6 @@ import dns.tokenizer
 
 @dns.immutable.immutable
 class CAA(dns.rdata.Rdata):
-
     """CAA (Certification Authority Authorization) record"""
 
     # see: RFC 6844
diff --git a/lib/dns/rdtypes/ANY/CDNSKEY.py b/lib/dns/rdtypes/ANY/CDNSKEY.py
index 38b8a8da..b613409f 100644
--- a/lib/dns/rdtypes/ANY/CDNSKEY.py
+++ b/lib/dns/rdtypes/ANY/CDNSKEY.py
@@ -30,5 +30,4 @@ from dns.rdtypes.dnskeybase import (  # noqa: F401  lgtm[py/unused-import]
 
 @dns.immutable.immutable
 class CDNSKEY(dns.rdtypes.dnskeybase.DNSKEYBase):
-
     """CDNSKEY record"""
diff --git a/lib/dns/rdtypes/ANY/CDS.py b/lib/dns/rdtypes/ANY/CDS.py
index 2ff42d9a..8312b972 100644
--- a/lib/dns/rdtypes/ANY/CDS.py
+++ b/lib/dns/rdtypes/ANY/CDS.py
@@ -21,7 +21,6 @@ import dns.rdtypes.dsbase
 
 @dns.immutable.immutable
 class CDS(dns.rdtypes.dsbase.DSBase):
-
     """CDS record"""
 
     _digest_length_by_type = {
diff --git a/lib/dns/rdtypes/ANY/CERT.py b/lib/dns/rdtypes/ANY/CERT.py
index 30fe863f..f369cc85 100644
--- a/lib/dns/rdtypes/ANY/CERT.py
+++ b/lib/dns/rdtypes/ANY/CERT.py
@@ -67,7 +67,6 @@ def _ctype_to_text(what):
 
 @dns.immutable.immutable
 class CERT(dns.rdata.Rdata):
-
     """CERT record"""
 
     # see RFC 4398
diff --git a/lib/dns/rdtypes/ANY/CNAME.py b/lib/dns/rdtypes/ANY/CNAME.py
index 759adb90..665e407c 100644
--- a/lib/dns/rdtypes/ANY/CNAME.py
+++ b/lib/dns/rdtypes/ANY/CNAME.py
@@ -21,7 +21,6 @@ import dns.rdtypes.nsbase
 
 @dns.immutable.immutable
 class CNAME(dns.rdtypes.nsbase.NSBase):
-
     """CNAME record
 
     Note: although CNAME is officially a singleton type, dnspython allows
diff --git a/lib/dns/rdtypes/ANY/CSYNC.py b/lib/dns/rdtypes/ANY/CSYNC.py
index 315da9ff..2f972f6e 100644
--- a/lib/dns/rdtypes/ANY/CSYNC.py
+++ b/lib/dns/rdtypes/ANY/CSYNC.py
@@ -32,7 +32,6 @@ class Bitmap(dns.rdtypes.util.Bitmap):
 
 @dns.immutable.immutable
 class CSYNC(dns.rdata.Rdata):
-
     """CSYNC record"""
 
     __slots__ = ["serial", "flags", "windows"]
diff --git a/lib/dns/rdtypes/ANY/DLV.py b/lib/dns/rdtypes/ANY/DLV.py
index 632e90f8..6c134f18 100644
--- a/lib/dns/rdtypes/ANY/DLV.py
+++ b/lib/dns/rdtypes/ANY/DLV.py
@@ -21,5 +21,4 @@ import dns.rdtypes.dsbase
 
 @dns.immutable.immutable
 class DLV(dns.rdtypes.dsbase.DSBase):
-
     """DLV record"""
diff --git a/lib/dns/rdtypes/ANY/DNAME.py b/lib/dns/rdtypes/ANY/DNAME.py
index 556bff59..bbf9186c 100644
--- a/lib/dns/rdtypes/ANY/DNAME.py
+++ b/lib/dns/rdtypes/ANY/DNAME.py
@@ -21,7 +21,6 @@ import dns.rdtypes.nsbase
 
 @dns.immutable.immutable
 class DNAME(dns.rdtypes.nsbase.UncompressedNS):
-
     """DNAME record"""
 
     def _to_wire(self, file, compress=None, origin=None, canonicalize=False):
diff --git a/lib/dns/rdtypes/ANY/DNSKEY.py b/lib/dns/rdtypes/ANY/DNSKEY.py
index f1a63062..6d961a9f 100644
--- a/lib/dns/rdtypes/ANY/DNSKEY.py
+++ b/lib/dns/rdtypes/ANY/DNSKEY.py
@@ -30,5 +30,4 @@ from dns.rdtypes.dnskeybase import (  # noqa: F401  lgtm[py/unused-import]
 
 @dns.immutable.immutable
 class DNSKEY(dns.rdtypes.dnskeybase.DNSKEYBase):
-
     """DNSKEY record"""
diff --git a/lib/dns/rdtypes/ANY/DS.py b/lib/dns/rdtypes/ANY/DS.py
index 097ecfa0..58b3108d 100644
--- a/lib/dns/rdtypes/ANY/DS.py
+++ b/lib/dns/rdtypes/ANY/DS.py
@@ -21,5 +21,4 @@ import dns.rdtypes.dsbase
 
 @dns.immutable.immutable
 class DS(dns.rdtypes.dsbase.DSBase):
-
     """DS record"""
diff --git a/lib/dns/rdtypes/ANY/EUI48.py b/lib/dns/rdtypes/ANY/EUI48.py
index 7e4e1ff3..c843be50 100644
--- a/lib/dns/rdtypes/ANY/EUI48.py
+++ b/lib/dns/rdtypes/ANY/EUI48.py
@@ -22,7 +22,6 @@ import dns.rdtypes.euibase
 
 @dns.immutable.immutable
 class EUI48(dns.rdtypes.euibase.EUIBase):
-
     """EUI48 record"""
 
     # see: rfc7043.txt
diff --git a/lib/dns/rdtypes/ANY/EUI64.py b/lib/dns/rdtypes/ANY/EUI64.py
index 68b5820f..f6d7e257 100644
--- a/lib/dns/rdtypes/ANY/EUI64.py
+++ b/lib/dns/rdtypes/ANY/EUI64.py
@@ -22,7 +22,6 @@ import dns.rdtypes.euibase
 
 @dns.immutable.immutable
 class EUI64(dns.rdtypes.euibase.EUIBase):
-
     """EUI64 record"""
 
     # see: rfc7043.txt
diff --git a/lib/dns/rdtypes/ANY/GPOS.py b/lib/dns/rdtypes/ANY/GPOS.py
index 30aab321..312338f9 100644
--- a/lib/dns/rdtypes/ANY/GPOS.py
+++ b/lib/dns/rdtypes/ANY/GPOS.py
@@ -44,7 +44,6 @@ def _validate_float_string(what):
 
 @dns.immutable.immutable
 class GPOS(dns.rdata.Rdata):
-
     """GPOS record"""
 
     # see: RFC 1712
diff --git a/lib/dns/rdtypes/ANY/HINFO.py b/lib/dns/rdtypes/ANY/HINFO.py
index 513c155a..c2c45de0 100644
--- a/lib/dns/rdtypes/ANY/HINFO.py
+++ b/lib/dns/rdtypes/ANY/HINFO.py
@@ -25,7 +25,6 @@ import dns.tokenizer
 
 @dns.immutable.immutable
 class HINFO(dns.rdata.Rdata):
-
     """HINFO record"""
 
     # see: RFC 1035
diff --git a/lib/dns/rdtypes/ANY/HIP.py b/lib/dns/rdtypes/ANY/HIP.py
index a20aa1e5..91669139 100644
--- a/lib/dns/rdtypes/ANY/HIP.py
+++ b/lib/dns/rdtypes/ANY/HIP.py
@@ -27,7 +27,6 @@ import dns.rdatatype
 
 @dns.immutable.immutable
 class HIP(dns.rdata.Rdata):
-
     """HIP record"""
 
     # see: RFC 5205
diff --git a/lib/dns/rdtypes/ANY/ISDN.py b/lib/dns/rdtypes/ANY/ISDN.py
index 536a35d6..fb01eab3 100644
--- a/lib/dns/rdtypes/ANY/ISDN.py
+++ b/lib/dns/rdtypes/ANY/ISDN.py
@@ -25,7 +25,6 @@ import dns.tokenizer
 
 @dns.immutable.immutable
 class ISDN(dns.rdata.Rdata):
-
     """ISDN record"""
 
     # see: RFC 1183
diff --git a/lib/dns/rdtypes/ANY/L32.py b/lib/dns/rdtypes/ANY/L32.py
index 14be01f9..09804c2d 100644
--- a/lib/dns/rdtypes/ANY/L32.py
+++ b/lib/dns/rdtypes/ANY/L32.py
@@ -8,7 +8,6 @@ import dns.rdata
 
 @dns.immutable.immutable
 class L32(dns.rdata.Rdata):
-
     """L32 record"""
 
     # see: rfc6742.txt
diff --git a/lib/dns/rdtypes/ANY/L64.py b/lib/dns/rdtypes/ANY/L64.py
index d083d403..fb76808e 100644
--- a/lib/dns/rdtypes/ANY/L64.py
+++ b/lib/dns/rdtypes/ANY/L64.py
@@ -8,7 +8,6 @@ import dns.rdtypes.util
 
 @dns.immutable.immutable
 class L64(dns.rdata.Rdata):
-
     """L64 record"""
 
     # see: rfc6742.txt
diff --git a/lib/dns/rdtypes/ANY/LOC.py b/lib/dns/rdtypes/ANY/LOC.py
index 783d54af..a36a2c10 100644
--- a/lib/dns/rdtypes/ANY/LOC.py
+++ b/lib/dns/rdtypes/ANY/LOC.py
@@ -105,7 +105,6 @@ def _check_coordinate_list(value, low, high):
 
 @dns.immutable.immutable
 class LOC(dns.rdata.Rdata):
-
     """LOC record"""
 
     # see: RFC 1876
diff --git a/lib/dns/rdtypes/ANY/LP.py b/lib/dns/rdtypes/ANY/LP.py
index 8a7c5125..312663f1 100644
--- a/lib/dns/rdtypes/ANY/LP.py
+++ b/lib/dns/rdtypes/ANY/LP.py
@@ -8,7 +8,6 @@ import dns.rdata
 
 @dns.immutable.immutable
 class LP(dns.rdata.Rdata):
-
     """LP record"""
 
     # see: rfc6742.txt
diff --git a/lib/dns/rdtypes/ANY/MX.py b/lib/dns/rdtypes/ANY/MX.py
index 1f9df21f..0c300c5a 100644
--- a/lib/dns/rdtypes/ANY/MX.py
+++ b/lib/dns/rdtypes/ANY/MX.py
@@ -21,5 +21,4 @@ import dns.rdtypes.mxbase
 
 @dns.immutable.immutable
 class MX(dns.rdtypes.mxbase.MXBase):
-
     """MX record"""
diff --git a/lib/dns/rdtypes/ANY/NID.py b/lib/dns/rdtypes/ANY/NID.py
index ad54aca3..2f649178 100644
--- a/lib/dns/rdtypes/ANY/NID.py
+++ b/lib/dns/rdtypes/ANY/NID.py
@@ -8,7 +8,6 @@ import dns.rdtypes.util
 
 @dns.immutable.immutable
 class NID(dns.rdata.Rdata):
-
     """NID record"""
 
     # see: rfc6742.txt
diff --git a/lib/dns/rdtypes/ANY/NINFO.py b/lib/dns/rdtypes/ANY/NINFO.py
index 55bc5614..b177bddb 100644
--- a/lib/dns/rdtypes/ANY/NINFO.py
+++ b/lib/dns/rdtypes/ANY/NINFO.py
@@ -21,7 +21,6 @@ import dns.rdtypes.txtbase
 
 @dns.immutable.immutable
 class NINFO(dns.rdtypes.txtbase.TXTBase):
-
     """NINFO record"""
 
     # see: draft-reid-dnsext-zs-01
diff --git a/lib/dns/rdtypes/ANY/NS.py b/lib/dns/rdtypes/ANY/NS.py
index fe453f0d..c3f34ce9 100644
--- a/lib/dns/rdtypes/ANY/NS.py
+++ b/lib/dns/rdtypes/ANY/NS.py
@@ -21,5 +21,4 @@ import dns.rdtypes.nsbase
 
 @dns.immutable.immutable
 class NS(dns.rdtypes.nsbase.NSBase):
-
     """NS record"""
diff --git a/lib/dns/rdtypes/ANY/NSEC.py b/lib/dns/rdtypes/ANY/NSEC.py
index a2d98fa7..340525a6 100644
--- a/lib/dns/rdtypes/ANY/NSEC.py
+++ b/lib/dns/rdtypes/ANY/NSEC.py
@@ -30,7 +30,6 @@ class Bitmap(dns.rdtypes.util.Bitmap):
 
 @dns.immutable.immutable
 class NSEC(dns.rdata.Rdata):
-
     """NSEC record"""
 
     __slots__ = ["next", "windows"]
diff --git a/lib/dns/rdtypes/ANY/NSEC3.py b/lib/dns/rdtypes/ANY/NSEC3.py
index d32fe169..d71302b7 100644
--- a/lib/dns/rdtypes/ANY/NSEC3.py
+++ b/lib/dns/rdtypes/ANY/NSEC3.py
@@ -46,7 +46,6 @@ class Bitmap(dns.rdtypes.util.Bitmap):
 
 @dns.immutable.immutable
 class NSEC3(dns.rdata.Rdata):
-
     """NSEC3 record"""
 
     __slots__ = ["algorithm", "flags", "iterations", "salt", "next", "windows"]
@@ -64,9 +63,13 @@ class NSEC3(dns.rdata.Rdata):
             windows = Bitmap(windows)
         self.windows = tuple(windows.windows)
 
-    def to_text(self, origin=None, relativize=True, **kw):
+    def _next_text(self):
         next = base64.b32encode(self.next).translate(b32_normal_to_hex).lower().decode()
         next = next.rstrip("=")
+        return next
+
+    def to_text(self, origin=None, relativize=True, **kw):
+        next = self._next_text()
         if self.salt == b"":
             salt = "-"
         else:
@@ -118,3 +121,6 @@ class NSEC3(dns.rdata.Rdata):
         next = parser.get_counted_bytes()
         bitmap = Bitmap.from_wire_parser(parser)
         return cls(rdclass, rdtype, algorithm, flags, iterations, salt, next, bitmap)
+
+    def next_name(self, origin=None):
+        return dns.name.from_text(self._next_text(), origin)
diff --git a/lib/dns/rdtypes/ANY/NSEC3PARAM.py b/lib/dns/rdtypes/ANY/NSEC3PARAM.py
index 1a0c0e08..d1e62ebc 100644
--- a/lib/dns/rdtypes/ANY/NSEC3PARAM.py
+++ b/lib/dns/rdtypes/ANY/NSEC3PARAM.py
@@ -25,7 +25,6 @@ import dns.rdata
 
 @dns.immutable.immutable
 class NSEC3PARAM(dns.rdata.Rdata):
-
     """NSEC3PARAM record"""
 
     __slots__ = ["algorithm", "flags", "iterations", "salt"]
diff --git a/lib/dns/rdtypes/ANY/OPENPGPKEY.py b/lib/dns/rdtypes/ANY/OPENPGPKEY.py
index e5e25727..4d7a4b6c 100644
--- a/lib/dns/rdtypes/ANY/OPENPGPKEY.py
+++ b/lib/dns/rdtypes/ANY/OPENPGPKEY.py
@@ -25,7 +25,6 @@ import dns.tokenizer
 
 @dns.immutable.immutable
 class OPENPGPKEY(dns.rdata.Rdata):
-
     """OPENPGPKEY record"""
 
     # see: RFC 7929
diff --git a/lib/dns/rdtypes/ANY/OPT.py b/lib/dns/rdtypes/ANY/OPT.py
index d70e5373..d343dfa5 100644
--- a/lib/dns/rdtypes/ANY/OPT.py
+++ b/lib/dns/rdtypes/ANY/OPT.py
@@ -28,7 +28,6 @@ import dns.rdata
 
 @dns.immutable.immutable
 class OPT(dns.rdata.Rdata):
-
     """OPT record"""
 
     __slots__ = ["options"]
diff --git a/lib/dns/rdtypes/ANY/PTR.py b/lib/dns/rdtypes/ANY/PTR.py
index 7fd5547d..98c36167 100644
--- a/lib/dns/rdtypes/ANY/PTR.py
+++ b/lib/dns/rdtypes/ANY/PTR.py
@@ -21,5 +21,4 @@ import dns.rdtypes.nsbase
 
 @dns.immutable.immutable
 class PTR(dns.rdtypes.nsbase.NSBase):
-
     """PTR record"""
diff --git a/lib/dns/rdtypes/ANY/RP.py b/lib/dns/rdtypes/ANY/RP.py
index 9c64c6e2..9b74549d 100644
--- a/lib/dns/rdtypes/ANY/RP.py
+++ b/lib/dns/rdtypes/ANY/RP.py
@@ -23,7 +23,6 @@ import dns.rdata
 
 @dns.immutable.immutable
 class RP(dns.rdata.Rdata):
-
     """RP record"""
 
     # see: RFC 1183
diff --git a/lib/dns/rdtypes/ANY/RRSIG.py b/lib/dns/rdtypes/ANY/RRSIG.py
index 11605026..8beb4237 100644
--- a/lib/dns/rdtypes/ANY/RRSIG.py
+++ b/lib/dns/rdtypes/ANY/RRSIG.py
@@ -28,7 +28,6 @@ import dns.rdatatype
 
 
 class BadSigTime(dns.exception.DNSException):
-
     """Time in DNS SIG or RRSIG resource record cannot be parsed."""
 
 
@@ -52,7 +51,6 @@ def posixtime_to_sigtime(what):
 
 @dns.immutable.immutable
 class RRSIG(dns.rdata.Rdata):
-
     """RRSIG record"""
 
     __slots__ = [
diff --git a/lib/dns/rdtypes/ANY/RT.py b/lib/dns/rdtypes/ANY/RT.py
index 950f2a06..5a4d45cf 100644
--- a/lib/dns/rdtypes/ANY/RT.py
+++ b/lib/dns/rdtypes/ANY/RT.py
@@ -21,5 +21,4 @@ import dns.rdtypes.mxbase
 
 @dns.immutable.immutable
 class RT(dns.rdtypes.mxbase.UncompressedDowncasingMX):
-
     """RT record"""
diff --git a/lib/dns/rdtypes/ANY/SOA.py b/lib/dns/rdtypes/ANY/SOA.py
index bde55e15..09aa8321 100644
--- a/lib/dns/rdtypes/ANY/SOA.py
+++ b/lib/dns/rdtypes/ANY/SOA.py
@@ -25,7 +25,6 @@ import dns.rdata
 
 @dns.immutable.immutable
 class SOA(dns.rdata.Rdata):
-
     """SOA record"""
 
     # see: RFC 1035
diff --git a/lib/dns/rdtypes/ANY/SPF.py b/lib/dns/rdtypes/ANY/SPF.py
index c403589a..1df3b705 100644
--- a/lib/dns/rdtypes/ANY/SPF.py
+++ b/lib/dns/rdtypes/ANY/SPF.py
@@ -21,7 +21,6 @@ import dns.rdtypes.txtbase
 
 @dns.immutable.immutable
 class SPF(dns.rdtypes.txtbase.TXTBase):
-
     """SPF record"""
 
     # see: RFC 4408
diff --git a/lib/dns/rdtypes/ANY/SSHFP.py b/lib/dns/rdtypes/ANY/SSHFP.py
index 67805452..d2c4b073 100644
--- a/lib/dns/rdtypes/ANY/SSHFP.py
+++ b/lib/dns/rdtypes/ANY/SSHFP.py
@@ -25,7 +25,6 @@ import dns.rdatatype
 
 @dns.immutable.immutable
 class SSHFP(dns.rdata.Rdata):
-
     """SSHFP record"""
 
     # See RFC 4255
diff --git a/lib/dns/rdtypes/ANY/TKEY.py b/lib/dns/rdtypes/ANY/TKEY.py
index d5f5fc45..5b490b82 100644
--- a/lib/dns/rdtypes/ANY/TKEY.py
+++ b/lib/dns/rdtypes/ANY/TKEY.py
@@ -25,7 +25,6 @@ import dns.rdata
 
 @dns.immutable.immutable
 class TKEY(dns.rdata.Rdata):
-
     """TKEY Record"""
 
     __slots__ = [
diff --git a/lib/dns/rdtypes/ANY/TLSA.py b/lib/dns/rdtypes/ANY/TLSA.py
index c9ba1991..4dffc553 100644
--- a/lib/dns/rdtypes/ANY/TLSA.py
+++ b/lib/dns/rdtypes/ANY/TLSA.py
@@ -6,5 +6,4 @@ import dns.rdtypes.tlsabase
 
 @dns.immutable.immutable
 class TLSA(dns.rdtypes.tlsabase.TLSABase):
-
     """TLSA record"""
diff --git a/lib/dns/rdtypes/ANY/TSIG.py b/lib/dns/rdtypes/ANY/TSIG.py
index 1ae87ebe..79423826 100644
--- a/lib/dns/rdtypes/ANY/TSIG.py
+++ b/lib/dns/rdtypes/ANY/TSIG.py
@@ -26,7 +26,6 @@ import dns.rdata
 
 @dns.immutable.immutable
 class TSIG(dns.rdata.Rdata):
-
     """TSIG record"""
 
     __slots__ = [
diff --git a/lib/dns/rdtypes/ANY/TXT.py b/lib/dns/rdtypes/ANY/TXT.py
index f4e61930..6d4dae27 100644
--- a/lib/dns/rdtypes/ANY/TXT.py
+++ b/lib/dns/rdtypes/ANY/TXT.py
@@ -21,5 +21,4 @@ import dns.rdtypes.txtbase
 
 @dns.immutable.immutable
 class TXT(dns.rdtypes.txtbase.TXTBase):
-
     """TXT record"""
diff --git a/lib/dns/rdtypes/ANY/URI.py b/lib/dns/rdtypes/ANY/URI.py
index 7463e277..2efbb305 100644
--- a/lib/dns/rdtypes/ANY/URI.py
+++ b/lib/dns/rdtypes/ANY/URI.py
@@ -27,7 +27,6 @@ import dns.rdtypes.util
 
 @dns.immutable.immutable
 class URI(dns.rdata.Rdata):
-
     """URI record"""
 
     # see RFC 7553
diff --git a/lib/dns/rdtypes/ANY/X25.py b/lib/dns/rdtypes/ANY/X25.py
index 06c14534..8375611d 100644
--- a/lib/dns/rdtypes/ANY/X25.py
+++ b/lib/dns/rdtypes/ANY/X25.py
@@ -25,7 +25,6 @@ import dns.tokenizer
 
 @dns.immutable.immutable
 class X25(dns.rdata.Rdata):
-
     """X25 record"""
 
     # see RFC 1183
diff --git a/lib/dns/rdtypes/ANY/ZONEMD.py b/lib/dns/rdtypes/ANY/ZONEMD.py
index 3062843b..c90e3ee1 100644
--- a/lib/dns/rdtypes/ANY/ZONEMD.py
+++ b/lib/dns/rdtypes/ANY/ZONEMD.py
@@ -11,7 +11,6 @@ import dns.zonetypes
 
 @dns.immutable.immutable
 class ZONEMD(dns.rdata.Rdata):
-
     """ZONEMD record"""
 
     # See RFC 8976
diff --git a/lib/dns/rdtypes/CH/A.py b/lib/dns/rdtypes/CH/A.py
index e457f38a..583a88ac 100644
--- a/lib/dns/rdtypes/CH/A.py
+++ b/lib/dns/rdtypes/CH/A.py
@@ -23,7 +23,6 @@ import dns.rdtypes.mxbase
 
 @dns.immutable.immutable
 class A(dns.rdata.Rdata):
-
     """A record for Chaosnet"""
 
     # domain: the domain of the address
diff --git a/lib/dns/rdtypes/IN/A.py b/lib/dns/rdtypes/IN/A.py
index 713d5eea..e09d6110 100644
--- a/lib/dns/rdtypes/IN/A.py
+++ b/lib/dns/rdtypes/IN/A.py
@@ -24,7 +24,6 @@ import dns.tokenizer
 
 @dns.immutable.immutable
 class A(dns.rdata.Rdata):
-
     """A record."""
 
     __slots__ = ["address"]
diff --git a/lib/dns/rdtypes/IN/AAAA.py b/lib/dns/rdtypes/IN/AAAA.py
index f8237b44..0cd139e7 100644
--- a/lib/dns/rdtypes/IN/AAAA.py
+++ b/lib/dns/rdtypes/IN/AAAA.py
@@ -24,7 +24,6 @@ import dns.tokenizer
 
 @dns.immutable.immutable
 class AAAA(dns.rdata.Rdata):
-
     """AAAA record."""
 
     __slots__ = ["address"]
diff --git a/lib/dns/rdtypes/IN/APL.py b/lib/dns/rdtypes/IN/APL.py
index f1bb01db..44cb3fef 100644
--- a/lib/dns/rdtypes/IN/APL.py
+++ b/lib/dns/rdtypes/IN/APL.py
@@ -29,7 +29,6 @@ import dns.tokenizer
 
 @dns.immutable.immutable
 class APLItem:
-
     """An APL list item."""
 
     __slots__ = ["family", "negation", "address", "prefix"]
@@ -80,7 +79,6 @@ class APLItem:
 
 @dns.immutable.immutable
 class APL(dns.rdata.Rdata):
-
     """APL record."""
 
     # see: RFC 3123
diff --git a/lib/dns/rdtypes/IN/DHCID.py b/lib/dns/rdtypes/IN/DHCID.py
index 65f85897..723492fa 100644
--- a/lib/dns/rdtypes/IN/DHCID.py
+++ b/lib/dns/rdtypes/IN/DHCID.py
@@ -24,7 +24,6 @@ import dns.rdata
 
 @dns.immutable.immutable
 class DHCID(dns.rdata.Rdata):
-
     """DHCID record"""
 
     # see: RFC 4701
diff --git a/lib/dns/rdtypes/IN/IPSECKEY.py b/lib/dns/rdtypes/IN/IPSECKEY.py
index 8bb2bcb6..e3a66157 100644
--- a/lib/dns/rdtypes/IN/IPSECKEY.py
+++ b/lib/dns/rdtypes/IN/IPSECKEY.py
@@ -29,7 +29,6 @@ class Gateway(dns.rdtypes.util.Gateway):
 
 @dns.immutable.immutable
 class IPSECKEY(dns.rdata.Rdata):
-
     """IPSECKEY record"""
 
     # see: RFC 4025
diff --git a/lib/dns/rdtypes/IN/KX.py b/lib/dns/rdtypes/IN/KX.py
index a03d1d51..6073df47 100644
--- a/lib/dns/rdtypes/IN/KX.py
+++ b/lib/dns/rdtypes/IN/KX.py
@@ -21,5 +21,4 @@ import dns.rdtypes.mxbase
 
 @dns.immutable.immutable
 class KX(dns.rdtypes.mxbase.UncompressedDowncasingMX):
-
     """KX record"""
diff --git a/lib/dns/rdtypes/IN/NAPTR.py b/lib/dns/rdtypes/IN/NAPTR.py
index 1f1f5a12..195d1cba 100644
--- a/lib/dns/rdtypes/IN/NAPTR.py
+++ b/lib/dns/rdtypes/IN/NAPTR.py
@@ -33,7 +33,6 @@ def _write_string(file, s):
 
 @dns.immutable.immutable
 class NAPTR(dns.rdata.Rdata):
-
     """NAPTR record"""
 
     # see: RFC 3403
diff --git a/lib/dns/rdtypes/IN/NSAP.py b/lib/dns/rdtypes/IN/NSAP.py
index be8581e6..a4854b3f 100644
--- a/lib/dns/rdtypes/IN/NSAP.py
+++ b/lib/dns/rdtypes/IN/NSAP.py
@@ -25,7 +25,6 @@ import dns.tokenizer
 
 @dns.immutable.immutable
 class NSAP(dns.rdata.Rdata):
-
     """NSAP record."""
 
     # see: RFC 1706
diff --git a/lib/dns/rdtypes/IN/NSAP_PTR.py b/lib/dns/rdtypes/IN/NSAP_PTR.py
index 0a18fdce..ce1c6632 100644
--- a/lib/dns/rdtypes/IN/NSAP_PTR.py
+++ b/lib/dns/rdtypes/IN/NSAP_PTR.py
@@ -21,5 +21,4 @@ import dns.rdtypes.nsbase
 
 @dns.immutable.immutable
 class NSAP_PTR(dns.rdtypes.nsbase.UncompressedNS):
-
     """NSAP-PTR record"""
diff --git a/lib/dns/rdtypes/IN/PX.py b/lib/dns/rdtypes/IN/PX.py
index 5c0aa81e..cdca1532 100644
--- a/lib/dns/rdtypes/IN/PX.py
+++ b/lib/dns/rdtypes/IN/PX.py
@@ -26,7 +26,6 @@ import dns.rdtypes.util
 
 @dns.immutable.immutable
 class PX(dns.rdata.Rdata):
-
     """PX record."""
 
     # see: RFC 2163
diff --git a/lib/dns/rdtypes/IN/SRV.py b/lib/dns/rdtypes/IN/SRV.py
index 84c54007..5adef98f 100644
--- a/lib/dns/rdtypes/IN/SRV.py
+++ b/lib/dns/rdtypes/IN/SRV.py
@@ -26,7 +26,6 @@ import dns.rdtypes.util
 
 @dns.immutable.immutable
 class SRV(dns.rdata.Rdata):
-
     """SRV record"""
 
     # see: RFC 2782
diff --git a/lib/dns/rdtypes/IN/WKS.py b/lib/dns/rdtypes/IN/WKS.py
index 26d287a3..881a7849 100644
--- a/lib/dns/rdtypes/IN/WKS.py
+++ b/lib/dns/rdtypes/IN/WKS.py
@@ -33,7 +33,6 @@ except OSError:
 
 @dns.immutable.immutable
 class WKS(dns.rdata.Rdata):
-
     """WKS record"""
 
     # see: RFC 1035
diff --git a/lib/dns/rdtypes/dnskeybase.py b/lib/dns/rdtypes/dnskeybase.py
index 3bfcf860..db300f8b 100644
--- a/lib/dns/rdtypes/dnskeybase.py
+++ b/lib/dns/rdtypes/dnskeybase.py
@@ -36,7 +36,6 @@ class Flag(enum.IntFlag):
 
 @dns.immutable.immutable
 class DNSKEYBase(dns.rdata.Rdata):
-
     """Base class for rdata that is like a DNSKEY record"""
 
     __slots__ = ["flags", "protocol", "algorithm", "key"]
diff --git a/lib/dns/rdtypes/dsbase.py b/lib/dns/rdtypes/dsbase.py
index 1ad0b7a5..cd21f026 100644
--- a/lib/dns/rdtypes/dsbase.py
+++ b/lib/dns/rdtypes/dsbase.py
@@ -26,7 +26,6 @@ import dns.rdatatype
 
 @dns.immutable.immutable
 class DSBase(dns.rdata.Rdata):
-
     """Base class for rdata that is like a DS record"""
 
     __slots__ = ["key_tag", "algorithm", "digest_type", "digest"]
diff --git a/lib/dns/rdtypes/euibase.py b/lib/dns/rdtypes/euibase.py
index 4c4068b2..751087b4 100644
--- a/lib/dns/rdtypes/euibase.py
+++ b/lib/dns/rdtypes/euibase.py
@@ -22,7 +22,6 @@ import dns.rdata
 
 @dns.immutable.immutable
 class EUIBase(dns.rdata.Rdata):
-
     """EUIxx record"""
 
     # see: rfc7043.txt
diff --git a/lib/dns/rdtypes/mxbase.py b/lib/dns/rdtypes/mxbase.py
index a6bae078..6d5e3d87 100644
--- a/lib/dns/rdtypes/mxbase.py
+++ b/lib/dns/rdtypes/mxbase.py
@@ -28,7 +28,6 @@ import dns.rdtypes.util
 
 @dns.immutable.immutable
 class MXBase(dns.rdata.Rdata):
-
     """Base class for rdata that is like an MX record."""
 
     __slots__ = ["preference", "exchange"]
@@ -71,7 +70,6 @@ class MXBase(dns.rdata.Rdata):
 
 @dns.immutable.immutable
 class UncompressedMX(MXBase):
-
     """Base class for rdata that is like an MX record, but whose name
     is not compressed when converted to DNS wire format, and whose
     digestable form is not downcased."""
@@ -82,7 +80,6 @@ class UncompressedMX(MXBase):
 
 @dns.immutable.immutable
 class UncompressedDowncasingMX(MXBase):
-
     """Base class for rdata that is like an MX record, but whose name
     is not compressed when convert to DNS wire format."""
 
diff --git a/lib/dns/rdtypes/nsbase.py b/lib/dns/rdtypes/nsbase.py
index 56d94235..904224f0 100644
--- a/lib/dns/rdtypes/nsbase.py
+++ b/lib/dns/rdtypes/nsbase.py
@@ -25,7 +25,6 @@ import dns.rdata
 
 @dns.immutable.immutable
 class NSBase(dns.rdata.Rdata):
-
     """Base class for rdata that is like an NS record."""
 
     __slots__ = ["target"]
@@ -56,7 +55,6 @@ class NSBase(dns.rdata.Rdata):
 
 @dns.immutable.immutable
 class UncompressedNS(NSBase):
-
     """Base class for rdata that is like an NS record, but whose name
     is not compressed when convert to DNS wire format, and whose
     digestable form is not downcased."""
diff --git a/lib/dns/rdtypes/svcbbase.py b/lib/dns/rdtypes/svcbbase.py
index ba5b53d2..05652413 100644
--- a/lib/dns/rdtypes/svcbbase.py
+++ b/lib/dns/rdtypes/svcbbase.py
@@ -2,7 +2,6 @@
 
 import base64
 import enum
-import io
 import struct
 
 import dns.enum
@@ -13,6 +12,7 @@ import dns.ipv6
 import dns.name
 import dns.rdata
 import dns.rdtypes.util
+import dns.renderer
 import dns.tokenizer
 import dns.wire
 
@@ -427,7 +427,6 @@ def _validate_and_define(params, key, value):
 
 @dns.immutable.immutable
 class SVCBBase(dns.rdata.Rdata):
-
     """Base class for SVCB-like records"""
 
     # see: draft-ietf-dnsop-svcb-https-11
@@ -521,19 +520,10 @@ class SVCBBase(dns.rdata.Rdata):
         for key in sorted(self.params):
             file.write(struct.pack("!H", key))
             value = self.params[key]
-            # placeholder for length (or actual length of empty values)
-            file.write(struct.pack("!H", 0))
-            if value is None:
-                continue
-            else:
-                start = file.tell()
-                value.to_wire(file, origin)
-                end = file.tell()
-                assert end - start < 65536
-                file.seek(start - 2)
-                stuff = struct.pack("!H", end - start)
-                file.write(stuff)
-                file.seek(0, io.SEEK_END)
+            with dns.renderer.prefixed_length(file, 2):
+                # Note that we're still writing a length of zero if the value is None
+                if value is not None:
+                    value.to_wire(file, origin)
 
     @classmethod
     def from_wire_parser(cls, rdclass, rdtype, parser, origin=None):
diff --git a/lib/dns/rdtypes/tlsabase.py b/lib/dns/rdtypes/tlsabase.py
index 4cdb7ab3..a059d2c4 100644
--- a/lib/dns/rdtypes/tlsabase.py
+++ b/lib/dns/rdtypes/tlsabase.py
@@ -25,7 +25,6 @@ import dns.rdatatype
 
 @dns.immutable.immutable
 class TLSABase(dns.rdata.Rdata):
-
     """Base class for TLSA and SMIMEA records"""
 
     # see: RFC 6698
diff --git a/lib/dns/rdtypes/txtbase.py b/lib/dns/rdtypes/txtbase.py
index fdbfb646..44d6df57 100644
--- a/lib/dns/rdtypes/txtbase.py
+++ b/lib/dns/rdtypes/txtbase.py
@@ -17,18 +17,17 @@
 
 """TXT-like base class."""
 
-import struct
 from typing import Any, Dict, Iterable, Optional, Tuple, Union
 
 import dns.exception
 import dns.immutable
 import dns.rdata
+import dns.renderer
 import dns.tokenizer
 
 
 @dns.immutable.immutable
 class TXTBase(dns.rdata.Rdata):
-
     """Base class for rdata that is like a TXT record (see RFC 1035)."""
 
     __slots__ = ["strings"]
@@ -56,7 +55,7 @@ class TXTBase(dns.rdata.Rdata):
         self,
         origin: Optional[dns.name.Name] = None,
         relativize: bool = True,
-        **kw: Dict[str, Any]
+        **kw: Dict[str, Any],
     ) -> str:
         txt = ""
         prefix = ""
@@ -93,10 +92,8 @@ class TXTBase(dns.rdata.Rdata):
 
     def _to_wire(self, file, compress=None, origin=None, canonicalize=False):
         for s in self.strings:
-            l = len(s)
-            assert l < 256
-            file.write(struct.pack("!B", l))
-            file.write(s)
+            with dns.renderer.prefixed_length(file, 1):
+                file.write(s)
 
     @classmethod
     def from_wire_parser(cls, rdclass, rdtype, parser, origin=None):
diff --git a/lib/dns/renderer.py b/lib/dns/renderer.py
index 53e7c0f6..a77481f6 100644
--- a/lib/dns/renderer.py
+++ b/lib/dns/renderer.py
@@ -32,6 +32,24 @@ AUTHORITY = 2
 ADDITIONAL = 3
 
 
+@contextlib.contextmanager
+def prefixed_length(output, length_length):
+    output.write(b"\00" * length_length)
+    start = output.tell()
+    yield
+    end = output.tell()
+    length = end - start
+    if length > 0:
+        try:
+            output.seek(start - length_length)
+            try:
+                output.write(length.to_bytes(length_length, "big"))
+            except OverflowError:
+                raise dns.exception.FormError
+        finally:
+            output.seek(end)
+
+
 class Renderer:
     """Helper class for building DNS wire-format messages.
 
@@ -134,6 +152,15 @@ class Renderer:
             self._rollback(start)
             raise dns.exception.TooBig
 
+    @contextlib.contextmanager
+    def _temporarily_seek_to(self, where):
+        current = self.output.tell()
+        try:
+            self.output.seek(where)
+            yield
+        finally:
+            self.output.seek(current)
+
     def add_question(self, qname, rdtype, rdclass=dns.rdataclass.IN):
         """Add a question to the message."""
 
@@ -269,18 +296,14 @@ class Renderer:
         with self._track_size():
             keyname.to_wire(self.output, compress, self.origin)
             self.output.write(
-                struct.pack("!HHIH", dns.rdatatype.TSIG, dns.rdataclass.ANY, 0, 0)
+                struct.pack("!HHI", dns.rdatatype.TSIG, dns.rdataclass.ANY, 0)
             )
-            rdata_start = self.output.tell()
-            tsig.to_wire(self.output)
+            with prefixed_length(self.output, 2):
+                tsig.to_wire(self.output)
 
-        after = self.output.tell()
-        self.output.seek(rdata_start - 2)
-        self.output.write(struct.pack("!H", after - rdata_start))
         self.counts[ADDITIONAL] += 1
-        self.output.seek(10)
-        self.output.write(struct.pack("!H", self.counts[ADDITIONAL]))
-        self.output.seek(0, io.SEEK_END)
+        with self._temporarily_seek_to(10):
+            self.output.write(struct.pack("!H", self.counts[ADDITIONAL]))
 
     def write_header(self):
         """Write the DNS message header.
@@ -290,19 +313,18 @@ class Renderer:
         is added.
         """
 
-        self.output.seek(0)
-        self.output.write(
-            struct.pack(
-                "!HHHHHH",
-                self.id,
-                self.flags,
-                self.counts[0],
-                self.counts[1],
-                self.counts[2],
-                self.counts[3],
+        with self._temporarily_seek_to(0):
+            self.output.write(
+                struct.pack(
+                    "!HHHHHH",
+                    self.id,
+                    self.flags,
+                    self.counts[0],
+                    self.counts[1],
+                    self.counts[2],
+                    self.counts[3],
+                )
             )
-        )
-        self.output.seek(0, io.SEEK_END)
 
     def get_wire(self):
         """Return the wire format message."""
diff --git a/lib/dns/rrset.py b/lib/dns/rrset.py
index 350de13e..6f39b108 100644
--- a/lib/dns/rrset.py
+++ b/lib/dns/rrset.py
@@ -26,7 +26,6 @@ import dns.renderer
 
 
 class RRset(dns.rdataset.Rdataset):
-
     """A DNS RRset (named rdataset).
 
     RRset inherits from Rdataset, and RRsets can be treated as
@@ -132,7 +131,7 @@ class RRset(dns.rdataset.Rdataset):
         self,
         origin: Optional[dns.name.Name] = None,
         relativize: bool = True,
-        **kw: Dict[str, Any]
+        **kw: Dict[str, Any],
     ) -> str:
         """Convert the RRset into DNS zone file format.
 
@@ -159,7 +158,7 @@ class RRset(dns.rdataset.Rdataset):
         file: Any,
         compress: Optional[dns.name.CompressType] = None,  # type: ignore
         origin: Optional[dns.name.Name] = None,
-        **kw: Dict[str, Any]
+        **kw: Dict[str, Any],
     ) -> int:
         """Convert the RRset to wire format.
 
@@ -231,7 +230,7 @@ def from_text(
     ttl: int,
     rdclass: Union[dns.rdataclass.RdataClass, str],
     rdtype: Union[dns.rdatatype.RdataType, str],
-    *text_rdatas: Any
+    *text_rdatas: Any,
 ) -> RRset:
     """Create an RRset with the specified name, TTL, class, and type and with
     the specified rdatas in text format.
diff --git a/lib/dns/set.py b/lib/dns/set.py
index fa50ed97..f0fb0d50 100644
--- a/lib/dns/set.py
+++ b/lib/dns/set.py
@@ -19,7 +19,6 @@ import itertools
 
 
 class Set:
-
     """A simple set class.
 
     This class was originally used to deal with sets being missing in
diff --git a/lib/dns/transaction.py b/lib/dns/transaction.py
index 21dea775..84e54f7d 100644
--- a/lib/dns/transaction.py
+++ b/lib/dns/transaction.py
@@ -203,7 +203,7 @@ class Transaction:
 
             - name
 
-            - name, rdataclass, rdatatype, [covers]
+            - name, rdatatype, [covers]
 
             - name, rdataset...
 
@@ -222,7 +222,7 @@ class Transaction:
 
             - name
 
-            - name, rdataclass, rdatatype, [covers]
+            - name, rdatatype, [covers]
 
             - name, rdataset...
 
diff --git a/lib/dns/tsig.py b/lib/dns/tsig.py
index 58760f5f..780852e8 100644
--- a/lib/dns/tsig.py
+++ b/lib/dns/tsig.py
@@ -29,47 +29,38 @@ import dns.rdataclass
 
 
 class BadTime(dns.exception.DNSException):
-
     """The current time is not within the TSIG's validity time."""
 
 
 class BadSignature(dns.exception.DNSException):
-
     """The TSIG signature fails to verify."""
 
 
 class BadKey(dns.exception.DNSException):
-
     """The TSIG record owner name does not match the key."""
 
 
 class BadAlgorithm(dns.exception.DNSException):
-
     """The TSIG algorithm does not match the key."""
 
 
 class PeerError(dns.exception.DNSException):
-
     """Base class for all TSIG errors generated by the remote peer"""
 
 
 class PeerBadKey(PeerError):
-
     """The peer didn't know the key we used"""
 
 
 class PeerBadSignature(PeerError):
-
     """The peer didn't like the signature we sent"""
 
 
 class PeerBadTime(PeerError):
-
     """The peer didn't like the time we sent"""
 
 
 class PeerBadTruncation(PeerError):
-
     """The peer didn't like amount of truncation in the TSIG we sent"""
 
 
diff --git a/lib/dns/version.py b/lib/dns/version.py
index 1f1fbf2d..251f2583 100644
--- a/lib/dns/version.py
+++ b/lib/dns/version.py
@@ -20,9 +20,9 @@
 #: MAJOR
 MAJOR = 2
 #: MINOR
-MINOR = 4
+MINOR = 6
 #: MICRO
-MICRO = 2
+MICRO = 1
 #: RELEASELEVEL
 RELEASELEVEL = 0x0F
 #: SERIAL
diff --git a/lib/dns/win32util.py b/lib/dns/win32util.py
index b2ca61da..aaa7e93e 100644
--- a/lib/dns/win32util.py
+++ b/lib/dns/win32util.py
@@ -1,5 +1,7 @@
 import sys
 
+import dns._features
+
 if sys.platform == "win32":
     from typing import Any
 
@@ -15,14 +17,14 @@ if sys.platform == "win32":
     except KeyError:
         WindowsError = Exception
 
-    try:
+    if dns._features.have("wmi"):
         import threading
 
         import pythoncom  # pylint: disable=import-error
         import wmi  # pylint: disable=import-error
 
         _have_wmi = True
-    except Exception:
+    else:
         _have_wmi = False
 
     def _config_domain(domain):
@@ -51,9 +53,10 @@ if sys.platform == "win32":
                 try:
                     system = wmi.WMI()
                     for interface in system.Win32_NetworkAdapterConfiguration():
-                        if interface.IPEnabled and interface.DNSDomain:
-                            self.info.domain = _config_domain(interface.DNSDomain)
+                        if interface.IPEnabled and interface.DNSServerSearchOrder:
                             self.info.nameservers = list(interface.DNSServerSearchOrder)
+                            if interface.DNSDomain:
+                                self.info.domain = _config_domain(interface.DNSDomain)
                             if interface.DNSDomainSuffixSearchOrder:
                                 self.info.search = [
                                     _config_domain(x)
diff --git a/lib/dns/zone.py b/lib/dns/zone.py
index 9e763f5f..844919e4 100644
--- a/lib/dns/zone.py
+++ b/lib/dns/zone.py
@@ -21,7 +21,18 @@ import contextlib
 import io
 import os
 import struct
-from typing import Any, Dict, Iterable, Iterator, List, Optional, Set, Tuple, Union
+from typing import (
+    Any,
+    Callable,
+    Iterable,
+    Iterator,
+    List,
+    MutableMapping,
+    Optional,
+    Set,
+    Tuple,
+    Union,
+)
 
 import dns.exception
 import dns.grange
@@ -43,47 +54,70 @@ from dns.zonetypes import DigestHashAlgorithm, DigestScheme, _digest_hashers
 
 
 class BadZone(dns.exception.DNSException):
-
     """The DNS zone is malformed."""
 
 
 class NoSOA(BadZone):
-
     """The DNS zone has no SOA RR at its origin."""
 
 
 class NoNS(BadZone):
-
     """The DNS zone has no NS RRset at its origin."""
 
 
 class UnknownOrigin(BadZone):
-
     """The DNS zone's origin is unknown."""
 
 
 class UnsupportedDigestScheme(dns.exception.DNSException):
-
     """The zone digest's scheme is unsupported."""
 
 
 class UnsupportedDigestHashAlgorithm(dns.exception.DNSException):
-
     """The zone digest's origin is unsupported."""
 
 
 class NoDigest(dns.exception.DNSException):
-
     """The DNS zone has no ZONEMD RRset at its origin."""
 
 
 class DigestVerificationFailure(dns.exception.DNSException):
-
     """The ZONEMD digest failed to verify."""
 
 
-class Zone(dns.transaction.TransactionManager):
+def _validate_name(
+    name: dns.name.Name,
+    origin: Optional[dns.name.Name],
+    relativize: bool,
+) -> dns.name.Name:
+    # This name validation code is shared by Zone and Version
+    if origin is None:
+        # This should probably never happen as other code (e.g.
+        # _rr_line) will notice the lack of an origin before us, but
+        # we check just in case!
+        raise KeyError("no zone origin is defined")
+    if name.is_absolute():
+        if not name.is_subdomain(origin):
+            raise KeyError("name parameter must be a subdomain of the zone origin")
+        if relativize:
+            name = name.relativize(origin)
+    else:
+        # We have a relative name.  Make sure that the derelativized name is
+        # not too long.
+        try:
+            abs_name = name.derelativize(origin)
+        except dns.name.NameTooLong:
+            # We map dns.name.NameTooLong to KeyError to be consistent with
+            # the other exceptions above.
+            raise KeyError("relative name too long for zone")
+        if not relativize:
+            # We have a relative name in a non-relative zone, so use the
+            # derelativized name.
+            name = abs_name
+    return name
 
+
+class Zone(dns.transaction.TransactionManager):
     """A DNS zone.
 
     A ``Zone`` is a mapping from names to nodes.  The zone object may be
@@ -94,7 +128,10 @@ class Zone(dns.transaction.TransactionManager):
     the zone.
     """
 
-    node_factory = dns.node.Node
+    node_factory: Callable[[], dns.node.Node] = dns.node.Node
+    map_factory: Callable[[], MutableMapping[dns.name.Name, dns.node.Node]] = dict
+    writable_version_factory: Optional[Callable[[], "WritableVersion"]] = None
+    immutable_version_factory: Optional[Callable[[], "ImmutableVersion"]] = None
 
     __slots__ = ["rdclass", "origin", "nodes", "relativize"]
 
@@ -125,7 +162,7 @@ class Zone(dns.transaction.TransactionManager):
                 raise ValueError("origin parameter must be an absolute name")
         self.origin = origin
         self.rdclass = rdclass
-        self.nodes: Dict[dns.name.Name, dns.node.Node] = {}
+        self.nodes: MutableMapping[dns.name.Name, dns.node.Node] = self.map_factory()
         self.relativize = relativize
 
     def __eq__(self, other):
@@ -154,26 +191,13 @@ class Zone(dns.transaction.TransactionManager):
         return not self.__eq__(other)
 
     def _validate_name(self, name: Union[dns.name.Name, str]) -> dns.name.Name:
+        # Note that any changes in this method should have corresponding changes
+        # made in the Version _validate_name() method.
         if isinstance(name, str):
             name = dns.name.from_text(name, None)
         elif not isinstance(name, dns.name.Name):
             raise KeyError("name parameter must be convertible to a DNS name")
-        if name.is_absolute():
-            if self.origin is None:
-                # This should probably never happen as other code (e.g.
-                # _rr_line) will notice the lack of an origin before us, but
-                # we check just in case!
-                raise KeyError("no zone origin is defined")
-            if not name.is_subdomain(self.origin):
-                raise KeyError("name parameter must be a subdomain of the zone origin")
-            if self.relativize:
-                name = name.relativize(self.origin)
-        elif not self.relativize:
-            # We have a relative name in a non-relative zone, so derelativize.
-            if self.origin is None:
-                raise KeyError("no zone origin is defined")
-            name = name.derelativize(self.origin)
-        return name
+        return _validate_name(name, self.origin, self.relativize)
 
     def __getitem__(self, key):
         key = self._validate_name(key)
@@ -252,9 +276,6 @@ class Zone(dns.transaction.TransactionManager):
         *create*, a ``bool``.  If true, the node will be created if it does
         not exist.
 
-        Raises ``KeyError`` if the name is not known and create was
-        not specified, or if the name was not a subdomain of the origin.
-
         Returns a ``dns.node.Node`` or ``None``.
         """
 
@@ -527,9 +548,6 @@ class Zone(dns.transaction.TransactionManager):
         *create*, a ``bool``.  If true, the node will be created if it does
         not exist.
 
-        Raises ``KeyError`` if the name is not known and create was
-        not specified, or if the name was not a subdomain of the origin.
-
         Returns a ``dns.rrset.RRset`` or ``None``.
         """
 
@@ -952,7 +970,7 @@ class Version:
         self,
         zone: Zone,
         id: int,
-        nodes: Optional[Dict[dns.name.Name, dns.node.Node]] = None,
+        nodes: Optional[MutableMapping[dns.name.Name, dns.node.Node]] = None,
         origin: Optional[dns.name.Name] = None,
     ):
         self.zone = zone
@@ -960,26 +978,11 @@ class Version:
         if nodes is not None:
             self.nodes = nodes
         else:
-            self.nodes = {}
+            self.nodes = zone.map_factory()
         self.origin = origin
 
     def _validate_name(self, name: dns.name.Name) -> dns.name.Name:
-        if name.is_absolute():
-            if self.origin is None:
-                # This should probably never happen as other code (e.g.
-                # _rr_line) will notice the lack of an origin before us, but
-                # we check just in case!
-                raise KeyError("no zone origin is defined")
-            if not name.is_subdomain(self.origin):
-                raise KeyError("name is not a subdomain of the zone origin")
-            if self.zone.relativize:
-                name = name.relativize(self.origin)
-        elif not self.zone.relativize:
-            # We have a relative name in a non-relative zone, so derelativize.
-            if self.origin is None:
-                raise KeyError("no zone origin is defined")
-            name = name.derelativize(self.origin)
-        return name
+        return _validate_name(name, self.origin, self.zone.relativize)
 
     def get_node(self, name: dns.name.Name) -> Optional[dns.node.Node]:
         name = self._validate_name(name)
@@ -1085,7 +1088,9 @@ class ImmutableVersion(Version):
                 version.nodes[name] = ImmutableVersionedNode(node)
         # We're changing the type of the nodes dictionary here on purpose, so
         # we ignore the mypy error.
-        self.nodes = dns.immutable.Dict(version.nodes, True)  # type: ignore
+        self.nodes = dns.immutable.Dict(
+            version.nodes, True, self.zone.map_factory
+        )  # type: ignore
 
 
 class Transaction(dns.transaction.Transaction):
@@ -1101,7 +1106,10 @@ class Transaction(dns.transaction.Transaction):
 
     def _setup_version(self):
         assert self.version is None
-        self.version = WritableVersion(self.zone, self.replacement)
+        factory = self.manager.writable_version_factory
+        if factory is None:
+            factory = WritableVersion
+        self.version = factory(self.zone, self.replacement)
 
     def _get_rdataset(self, name, rdtype, covers):
         return self.version.get_rdataset(name, rdtype, covers)
@@ -1132,7 +1140,10 @@ class Transaction(dns.transaction.Transaction):
             self.zone._end_read(self)
         elif commit and len(self.version.changed) > 0:
             if self.make_immutable:
-                version = ImmutableVersion(self.version)
+                factory = self.manager.immutable_version_factory
+                if factory is None:
+                    factory = ImmutableVersion
+                version = factory(self.version)
             else:
                 version = self.version
             self.zone._commit_version(self, version, self.version.origin)
@@ -1168,6 +1179,48 @@ class Transaction(dns.transaction.Transaction):
         return (absolute, relativize, effective)
 
 
+def _from_text(
+    text: Any,
+    origin: Optional[Union[dns.name.Name, str]] = None,
+    rdclass: dns.rdataclass.RdataClass = dns.rdataclass.IN,
+    relativize: bool = True,
+    zone_factory: Any = Zone,
+    filename: Optional[str] = None,
+    allow_include: bool = False,
+    check_origin: bool = True,
+    idna_codec: Optional[dns.name.IDNACodec] = None,
+    allow_directives: Union[bool, Iterable[str]] = True,
+) -> Zone:
+    # See the comments for the public APIs from_text() and from_file() for
+    # details.
+
+    # 'text' can also be a file, but we don't publish that fact
+    # since it's an implementation detail.  The official file
+    # interface is from_file().
+
+    if filename is None:
+        filename = "<string>"
+    zone = zone_factory(origin, rdclass, relativize=relativize)
+    with zone.writer(True) as txn:
+        tok = dns.tokenizer.Tokenizer(text, filename, idna_codec=idna_codec)
+        reader = dns.zonefile.Reader(
+            tok,
+            rdclass,
+            txn,
+            allow_include=allow_include,
+            allow_directives=allow_directives,
+        )
+        try:
+            reader.read()
+        except dns.zonefile.UnknownOrigin:
+            # for backwards compatibility
+            raise dns.zone.UnknownOrigin
+    # Now that we're done reading, do some basic checking of the zone.
+    if check_origin:
+        zone.check_origin()
+    return zone
+
+
 def from_text(
     text: str,
     origin: Optional[Union[dns.name.Name, str]] = None,
@@ -1228,32 +1281,18 @@ def from_text(
 
     Returns a subclass of ``dns.zone.Zone``.
     """
-
-    # 'text' can also be a file, but we don't publish that fact
-    # since it's an implementation detail.  The official file
-    # interface is from_file().
-
-    if filename is None:
-        filename = "<string>"
-    zone = zone_factory(origin, rdclass, relativize=relativize)
-    with zone.writer(True) as txn:
-        tok = dns.tokenizer.Tokenizer(text, filename, idna_codec=idna_codec)
-        reader = dns.zonefile.Reader(
-            tok,
-            rdclass,
-            txn,
-            allow_include=allow_include,
-            allow_directives=allow_directives,
-        )
-        try:
-            reader.read()
-        except dns.zonefile.UnknownOrigin:
-            # for backwards compatibility
-            raise dns.zone.UnknownOrigin
-    # Now that we're done reading, do some basic checking of the zone.
-    if check_origin:
-        zone.check_origin()
-    return zone
+    return _from_text(
+        text,
+        origin,
+        rdclass,
+        relativize,
+        zone_factory,
+        filename,
+        allow_include,
+        check_origin,
+        idna_codec,
+        allow_directives,
+    )
 
 
 def from_file(
@@ -1324,7 +1363,7 @@ def from_file(
     else:
         cm = contextlib.nullcontext(f)
     with cm as f:
-        return from_text(
+        return _from_text(
             f,
             origin,
             rdclass,
diff --git a/lib/dns/zonefile.py b/lib/dns/zonefile.py
index 27f04924..af064e73 100644
--- a/lib/dns/zonefile.py
+++ b/lib/dns/zonefile.py
@@ -86,7 +86,6 @@ def _upper_dollarize(s):
 
 
 class Reader:
-
     """Read a DNS zone file into a transaction."""
 
     def __init__(
diff --git a/requirements.txt b/requirements.txt
index fe84492e..64458e26 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -10,7 +10,7 @@ cheroot==10.0.0
 cherrypy==18.8.0
 cloudinary==1.34.0
 distro==1.9.0
-dnspython==2.4.2
+dnspython==2.6.1
 facebook-sdk==3.1.0
 future==0.18.3
 ga4mp==2.0.4

From faef9a94c443c7681839725fa4d715c8a45bc125 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sun, 24 Mar 2024 15:25:44 -0700
Subject: [PATCH 539/743] Bump cherrypy from 18.8.0 to 18.9.0 (#2266)

* Bump cherrypy from 18.8.0 to 18.9.0

Bumps [cherrypy](https://github.com/cherrypy/cherrypy) from 18.8.0 to 18.9.0.
- [Changelog](https://github.com/cherrypy/cherrypy/blob/main/CHANGES.rst)
- [Commits](https://github.com/cherrypy/cherrypy/compare/v18.8.0...v18.9.0)

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

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

* Update cherrypy==18.9.0

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/PyWin32.chm                               |  Bin 0 -> 2648456 bytes
 lib/adodbapi/__init__.py                      |   74 +
 lib/adodbapi/ado_consts.py                    |  281 +
 lib/adodbapi/adodbapi.py                      | 1223 ++++
 lib/adodbapi/apibase.py                       |  794 +++
 lib/adodbapi/examples/db_print.py             |   72 +
 lib/adodbapi/examples/db_table_names.py       |   20 +
 lib/adodbapi/examples/xls_read.py             |   41 +
 lib/adodbapi/examples/xls_write.py            |   41 +
 lib/adodbapi/is64bit.py                       |   41 +
 lib/adodbapi/license.txt                      |  506 ++
 lib/adodbapi/process_connect_string.py        |  144 +
 lib/adodbapi/readme.txt                       |   92 +
 lib/adodbapi/remote.py                        |  634 ++
 lib/adodbapi/schema_table.py                  |   15 +
 lib/adodbapi/setup.py                         |   70 +
 lib/adodbapi/test/adodbapitest.py             | 1692 ++++++
 lib/adodbapi/test/adodbapitestconfig.py       |  221 +
 lib/adodbapi/test/dbapi20.py                  |  939 +++
 lib/adodbapi/test/is64bit.py                  |   41 +
 lib/adodbapi/test/setuptestframework.py       |  134 +
 lib/adodbapi/test/test_adodbapi_dbapi20.py    |  200 +
 lib/adodbapi/test/tryconnection.py            |   33 +
 lib/annotated_types/__init__.py               |  396 ++
 .../__init__.py => annotated_types/py.typed}  |    0
 lib/annotated_types/test_cases.py             |  147 +
 lib/autocommand/autoasync.py                  |    8 +-
 lib/cherrypy/_cplogging.py                    |    6 +-
 lib/cherrypy/lib/cptools.py                   |   12 +-
 lib/cherrypy/lib/profiler.py                  |    4 +-
 lib/cherrypy/lib/reprconf.py                  |    2 +-
 lib/cherrypy/lib/static.py                    |   12 +-
 lib/cherrypy/process/wspbus.py                |    2 +-
 lib/cherrypy/test/test_http.py                |   15 +
 lib/cherrypy/test/test_iterator.py            |    2 +
 lib/cherrypy/test/test_logging.py             |   28 +
 lib/inflect/__init__.py                       |  180 +-
 lib/inflect/compat/__init__.py                |    0
 lib/inflect/compat/pydantic.py                |   19 +
 lib/inflect/compat/pydantic1.py               |    8 +
 lib/isapi/README.txt                          |    7 +
 lib/isapi/__init__.py                         |   39 +
 lib/isapi/doc/isapi.html                      |   92 +
 lib/isapi/install.py                          |  815 +++
 lib/isapi/isapicon.py                         |  120 +
 lib/isapi/samples/README.txt                  |   20 +
 lib/isapi/samples/advanced.py                 |  218 +
 lib/isapi/samples/redirector.py               |  125 +
 lib/isapi/samples/redirector_asynch.py        |   85 +
 lib/isapi/samples/redirector_with_filter.py   |  161 +
 lib/isapi/samples/test.py                     |  195 +
 lib/isapi/simple.py                           |   70 +
 lib/isapi/test/README.txt                     |    3 +
 lib/isapi/test/extension_simple.py            |  119 +
 lib/isapi/threaded_extension.py               |  189 +
 .../__init__.py}                              |  152 +-
 lib/jaraco/collections/py.typed               |    0
 lib/jaraco/context.py                         |   75 +
 .../{functools.py => functools/__init__.py}   |  155 +-
 lib/jaraco/functools/__init__.pyi             |  128 +
 lib/jaraco/functools/py.typed                 |    0
 lib/jaraco/text/__init__.py                   |   18 +-
 lib/jaraco/text/show-newlines.py              |    4 +-
 lib/jaraco/text/strip-prefix.py               |   21 +
 lib/more_itertools/__init__.py                |    2 +-
 lib/more_itertools/more.py                    |  143 +-
 lib/more_itertools/more.pyi                   |   23 +-
 lib/more_itertools/recipes.py                 |  107 +-
 lib/more_itertools/recipes.pyi                |   16 +-
 lib/pydantic/__init__.py                      |  373 +-
 lib/pydantic/_internal/__init__.py            |    0
 lib/pydantic/_internal/_config.py             |  322 ++
 lib/pydantic/_internal/_core_metadata.py      |   92 +
 lib/pydantic/_internal/_core_utils.py         |  570 ++
 lib/pydantic/_internal/_dataclasses.py        |  225 +
 lib/pydantic/_internal/_decorators.py         |  791 +++
 lib/pydantic/_internal/_decorators_v1.py      |  181 +
 .../_internal/_discriminated_union.py         |  506 ++
 lib/pydantic/_internal/_fields.py             |  319 ++
 lib/pydantic/_internal/_forward_ref.py        |   23 +
 lib/pydantic/_internal/_generate_schema.py    | 2231 ++++++++
 lib/pydantic/_internal/_generics.py           |  517 ++
 lib/pydantic/_internal/_git.py                |   26 +
 lib/pydantic/_internal/_internal_dataclass.py |   10 +
 .../_internal/_known_annotated_metadata.py    |  410 ++
 lib/pydantic/_internal/_mock_val_ser.py       |  140 +
 lib/pydantic/_internal/_model_construction.py |  637 +++
 lib/pydantic/_internal/_repr.py               |  117 +
 .../_internal/_schema_generation_shared.py    |  124 +
 lib/pydantic/_internal/_signature.py          |  164 +
 lib/pydantic/_internal/_std_types_schema.py   |  714 +++
 lib/pydantic/_internal/_typing_extra.py       |  469 ++
 lib/pydantic/_internal/_utils.py              |  362 ++
 lib/pydantic/_internal/_validate_call.py      |   84 +
 lib/pydantic/_internal/_validators.py         |  278 +
 lib/pydantic/_migration.py                    |  308 +
 lib/pydantic/alias_generators.py              |   50 +
 lib/pydantic/aliases.py                       |  112 +
 lib/pydantic/annotated_handlers.py            |  120 +
 lib/pydantic/class_validators.py              |  344 +-
 lib/pydantic/color.py                         |  285 +-
 lib/pydantic/config.py                        | 1048 +++-
 lib/pydantic/dataclasses.py                   |  632 +-
 lib/pydantic/datetime_parse.py                |  250 +-
 lib/pydantic/decorator.py                     |  266 +-
 lib/pydantic/deprecated/__init__.py           |    0
 lib/pydantic/deprecated/class_validators.py   |  253 +
 lib/pydantic/deprecated/config.py             |   72 +
 lib/pydantic/deprecated/copy_internals.py     |  224 +
 lib/pydantic/deprecated/decorator.py          |  279 +
 lib/pydantic/deprecated/json.py               |  140 +
 lib/pydantic/deprecated/parse.py              |   80 +
 lib/pydantic/deprecated/tools.py              |  103 +
 lib/pydantic/env_settings.py                  |  348 +-
 lib/pydantic/error_wrappers.py                |  164 +-
 lib/pydantic/errors.py                        |  728 +--
 lib/pydantic/fields.py                        | 2201 ++++---
 lib/pydantic/functional_serializers.py        |  395 ++
 lib/pydantic/functional_validators.py         |  706 +++
 lib/pydantic/generics.py                      |  366 +-
 lib/pydantic/json.py                          |  114 +-
 lib/pydantic/json_schema.py                   | 2425 ++++++++
 lib/pydantic/main.py                          | 2273 +++++---
 lib/pydantic/mypy.py                          | 1199 ++--
 lib/pydantic/networks.py                      | 1202 ++--
 lib/pydantic/parse.py                         |   68 +-
 lib/pydantic/plugin/__init__.py               |  170 +
 lib/pydantic/plugin/_loader.py                |   50 +
 lib/pydantic/plugin/_schema_validator.py      |  138 +
 lib/pydantic/root_model.py                    |  149 +
 lib/pydantic/schema.py                        | 1155 +---
 lib/pydantic/tools.py                         |   94 +-
 lib/pydantic/type_adapter.py                  |  460 ++
 lib/pydantic/types.py                         | 3382 ++++++++---
 lib/pydantic/typing.py                        |  604 +-
 lib/pydantic/utils.py                         |  843 +--
 lib/pydantic/v1/__init__.py                   |  131 +
 lib/pydantic/{ => v1}/_hypothesis_plugin.py   |    9 +-
 lib/pydantic/{ => v1}/annotated_types.py      |    0
 lib/pydantic/v1/class_validators.py           |  361 ++
 lib/pydantic/v1/color.py                      |  494 ++
 lib/pydantic/v1/config.py                     |  191 +
 lib/pydantic/v1/dataclasses.py                |  500 ++
 lib/pydantic/v1/datetime_parse.py             |  248 +
 lib/pydantic/v1/decorator.py                  |  264 +
 lib/pydantic/v1/env_settings.py               |  350 ++
 lib/pydantic/v1/error_wrappers.py             |  161 +
 lib/pydantic/v1/errors.py                     |  646 +++
 lib/pydantic/v1/fields.py                     | 1253 ++++
 lib/pydantic/v1/generics.py                   |  400 ++
 lib/pydantic/v1/json.py                       |  112 +
 lib/pydantic/v1/main.py                       | 1107 ++++
 lib/pydantic/v1/mypy.py                       |  944 +++
 lib/pydantic/v1/networks.py                   |  747 +++
 lib/pydantic/v1/parse.py                      |   66 +
 lib/pydantic/v1/py.typed                      |    0
 lib/pydantic/v1/schema.py                     | 1163 ++++
 lib/pydantic/v1/tools.py                      |   92 +
 lib/pydantic/v1/types.py                      | 1205 ++++
 lib/pydantic/v1/typing.py                     |  603 ++
 lib/pydantic/v1/utils.py                      |  803 +++
 lib/pydantic/v1/validators.py                 |  765 +++
 lib/pydantic/v1/version.py                    |   38 +
 lib/pydantic/validate_call_decorator.py       |   67 +
 lib/pydantic/validators.py                    |  767 +--
 lib/pydantic/version.py                       |   84 +-
 lib/pydantic/warnings.py                      |   58 +
 lib/pydantic_core/__init__.py                 |  139 +
 lib/pydantic_core/_pydantic_core.pyi          |  882 +++
 lib/pydantic_core/core_schema.py              | 3980 +++++++++++++
 lib/pydantic_core/py.typed                    |    0
 lib/pythoncom.py                              |    4 +
 lib/pythonwin/license.txt                     |   30 +
 .../pywin/Demos/app/basictimerapp.py          |  258 +
 lib/pythonwin/pywin/Demos/app/customprint.py  |  186 +
 lib/pythonwin/pywin/Demos/app/demoutils.py    |   65 +
 lib/pythonwin/pywin/Demos/app/dlgappdemo.py   |   51 +
 lib/pythonwin/pywin/Demos/app/dojobapp.py     |   72 +
 lib/pythonwin/pywin/Demos/app/helloapp.py     |   53 +
 lib/pythonwin/pywin/Demos/cmdserver.py        |  116 +
 lib/pythonwin/pywin/Demos/createwin.py        |  114 +
 lib/pythonwin/pywin/Demos/demoutils.py        |   67 +
 lib/pythonwin/pywin/Demos/dibdemo.py          |   73 +
 lib/pythonwin/pywin/Demos/dlgtest.py          |  145 +
 lib/pythonwin/pywin/Demos/dyndlg.py           |  104 +
 lib/pythonwin/pywin/Demos/fontdemo.py         |   86 +
 lib/pythonwin/pywin/Demos/guidemo.py          |   86 +
 lib/pythonwin/pywin/Demos/hiertest.py         |  138 +
 lib/pythonwin/pywin/Demos/menutest.py         |   13 +
 lib/pythonwin/pywin/Demos/objdoc.py           |   57 +
 lib/pythonwin/pywin/Demos/ocx/__init__.py     |    0
 lib/pythonwin/pywin/Demos/ocx/demoutils.py    |   67 +
 lib/pythonwin/pywin/Demos/ocx/flash.py        |   95 +
 lib/pythonwin/pywin/Demos/ocx/msoffice.py     |  152 +
 .../pywin/Demos/ocx/ocxserialtest.py          |  133 +
 lib/pythonwin/pywin/Demos/ocx/ocxtest.py      |  250 +
 lib/pythonwin/pywin/Demos/ocx/webbrowser.py   |   72 +
 lib/pythonwin/pywin/Demos/openGLDemo.py       |  370 ++
 lib/pythonwin/pywin/Demos/progressbar.py      |  105 +
 lib/pythonwin/pywin/Demos/sliderdemo.py       |   76 +
 lib/pythonwin/pywin/Demos/splittst.py         |   79 +
 lib/pythonwin/pywin/Demos/threadedgui.py      |  189 +
 lib/pythonwin/pywin/Demos/toolbar.py          |  106 +
 lib/pythonwin/pywin/IDLE.cfg                  |   29 +
 lib/pythonwin/pywin/__init__.py               |   10 +
 lib/pythonwin/pywin/default.cfg               |  215 +
 lib/pythonwin/pywin/dialogs/__init__.py       |    0
 lib/pythonwin/pywin/dialogs/ideoptions.py     |  139 +
 lib/pythonwin/pywin/dialogs/list.py           |  143 +
 lib/pythonwin/pywin/dialogs/login.py          |  156 +
 lib/pythonwin/pywin/dialogs/status.py         |  242 +
 lib/pythonwin/pywin/docking/DockingBar.py     |  679 +++
 lib/pythonwin/pywin/docking/__init__.py       |    0
 lib/pythonwin/pywin/framework/__init__.py     |    0
 lib/pythonwin/pywin/framework/app.py          |  457 ++
 lib/pythonwin/pywin/framework/bitmap.py       |  164 +
 lib/pythonwin/pywin/framework/cmdline.py      |   56 +
 lib/pythonwin/pywin/framework/dbgcommands.py  |  189 +
 lib/pythonwin/pywin/framework/dlgappcore.py   |   75 +
 .../pywin/framework/editor/ModuleBrowser.py   |  235 +
 .../pywin/framework/editor/__init__.py        |  106 +
 .../pywin/framework/editor/color/__init__.py  |    0
 .../framework/editor/color/coloreditor.py     |  664 +++
 .../pywin/framework/editor/configui.py        |  308 +
 .../pywin/framework/editor/document.py        |  378 ++
 .../pywin/framework/editor/editor.py          |  516 ++
 lib/pythonwin/pywin/framework/editor/frame.py |   74 +
 .../pywin/framework/editor/template.py        |   60 +
 lib/pythonwin/pywin/framework/editor/vss.py   |  104 +
 lib/pythonwin/pywin/framework/help.py         |  173 +
 lib/pythonwin/pywin/framework/interact.py     |  985 ++++
 lib/pythonwin/pywin/framework/intpyapp.py     |  555 ++
 lib/pythonwin/pywin/framework/intpydde.py     |   60 +
 .../pywin/framework/mdi_pychecker.py          |  849 +++
 lib/pythonwin/pywin/framework/scriptutils.py  |  688 +++
 lib/pythonwin/pywin/framework/sgrepmdi.py     |  758 +++
 lib/pythonwin/pywin/framework/startup.py      |   80 +
 lib/pythonwin/pywin/framework/stdin.py        |  176 +
 lib/pythonwin/pywin/framework/toolmenu.py     |  284 +
 lib/pythonwin/pywin/framework/window.py       |   14 +
 lib/pythonwin/pywin/framework/winout.py       |  594 ++
 lib/pythonwin/pywin/idle/AutoExpand.py        |   95 +
 lib/pythonwin/pywin/idle/AutoIndent.py        |  547 ++
 lib/pythonwin/pywin/idle/CallTips.py          |  219 +
 lib/pythonwin/pywin/idle/FormatParagraph.py   |  166 +
 lib/pythonwin/pywin/idle/IdleHistory.py       |   87 +
 lib/pythonwin/pywin/idle/PyParse.py           |  591 ++
 lib/pythonwin/pywin/idle/__init__.py          |    1 +
 lib/pythonwin/pywin/mfc/__init__.py           |    0
 lib/pythonwin/pywin/mfc/activex.py            |   86 +
 lib/pythonwin/pywin/mfc/afxres.py             |  501 ++
 lib/pythonwin/pywin/mfc/dialog.py             |  278 +
 lib/pythonwin/pywin/mfc/docview.py            |  151 +
 lib/pythonwin/pywin/mfc/object.py             |   66 +
 lib/pythonwin/pywin/mfc/thread.py             |   25 +
 lib/pythonwin/pywin/mfc/window.py             |   50 +
 .../pywin/scintilla/IDLEenvironment.py        |  598 ++
 lib/pythonwin/pywin/scintilla/__init__.py     |    1 +
 lib/pythonwin/pywin/scintilla/bindings.py     |  178 +
 lib/pythonwin/pywin/scintilla/config.py       |  365 ++
 lib/pythonwin/pywin/scintilla/configui.py     |  292 +
 lib/pythonwin/pywin/scintilla/control.py      |  569 ++
 lib/pythonwin/pywin/scintilla/document.py     |  312 +
 lib/pythonwin/pywin/scintilla/find.py         |  510 ++
 lib/pythonwin/pywin/scintilla/formatter.py    |  695 +++
 lib/pythonwin/pywin/scintilla/keycodes.py     |  190 +
 lib/pythonwin/pywin/scintilla/scintillacon.py | 2001 +++++++
 lib/pythonwin/pywin/scintilla/view.py         |  832 +++
 lib/pythonwin/pywin/tools/TraceCollector.py   |   79 +
 lib/pythonwin/pywin/tools/__init__.py         |    1 +
 lib/pythonwin/pywin/tools/browseProjects.py   |  324 ++
 lib/pythonwin/pywin/tools/browser.py          |  517 ++
 lib/pythonwin/pywin/tools/hierlist.py         |  367 ++
 lib/pythonwin/pywin/tools/regedit.py          |  386 ++
 lib/pythonwin/pywin/tools/regpy.py            |   81 +
 lib/pythonwin/start_pythonwin.pyw             |   19 +
 lib/pywin32.version.txt                       |    1 +
 lib/tempora/timing.py                         |   13 +-
 lib/typing_extensions.py                      | 2142 +++++--
 lib/win32/Demos/BackupRead_BackupWrite.py     |  121 +
 lib/win32/Demos/BackupSeek_streamheaders.py   |  137 +
 lib/win32/Demos/CopyFileEx.py                 |   57 +
 .../Demos/CreateFileTransacted_MiniVersion.py |  123 +
 lib/win32/Demos/EvtFormatMessage.py           |   83 +
 lib/win32/Demos/EvtSubscribe_pull.py          |   28 +
 lib/win32/Demos/EvtSubscribe_push.py          |   25 +
 lib/win32/Demos/FileSecurityTest.py           |  137 +
 lib/win32/Demos/GetSaveFileName.py            |   43 +
 lib/win32/Demos/NetValidatePasswordPolicy.py  |  127 +
 lib/win32/Demos/OpenEncryptedFileRaw.py       |   67 +
 lib/win32/Demos/RegCreateKeyTransacted.py     |   60 +
 lib/win32/Demos/RegRestoreKey.py              |   71 +
 lib/win32/Demos/SystemParametersInfo.py       |  210 +
 lib/win32/Demos/c_extension/setup.py          |   26 +
 lib/win32/Demos/cerapi.py                     |  254 +
 lib/win32/Demos/dde/ddeclient.py              |   18 +
 lib/win32/Demos/dde/ddeserver.py              |   42 +
 lib/win32/Demos/desktopmanager.py             |  246 +
 lib/win32/Demos/eventLogDemo.py               |  142 +
 lib/win32/Demos/getfilever.py                 |   33 +
 lib/win32/Demos/images/frowny.bmp             |  Bin 0 -> 3126 bytes
 lib/win32/Demos/images/smiley.bmp             |  Bin 0 -> 3126 bytes
 lib/win32/Demos/mmapfile_demo.py              |  102 +
 lib/win32/Demos/pipes/cat.py                  |   17 +
 lib/win32/Demos/pipes/runproc.py              |  114 +
 lib/win32/Demos/print_desktop.py              |  113 +
 lib/win32/Demos/rastest.py                    |  168 +
 .../Demos/security/GetTokenInformation.py     |  110 +
 lib/win32/Demos/security/account_rights.py    |   51 +
 lib/win32/Demos/security/explicit_entries.py  |  171 +
 lib/win32/Demos/security/get_policy_info.py   |   42 +
 lib/win32/Demos/security/list_rights.py       |   37 +
 lib/win32/Demos/security/localized_names.py   |   65 +
 lib/win32/Demos/security/lsaregevent.py       |   14 +
 lib/win32/Demos/security/lsastore.py          |   12 +
 lib/win32/Demos/security/query_information.py |   25 +
 lib/win32/Demos/security/regsave_sa.py        |   61 +
 lib/win32/Demos/security/regsecurity.py       |   36 +
 lib/win32/Demos/security/sa_inherit.py        |    8 +
 lib/win32/Demos/security/security_enums.py    |  336 ++
 lib/win32/Demos/security/set_file_audit.py    |  107 +
 lib/win32/Demos/security/set_file_owner.py    |   74 +
 lib/win32/Demos/security/set_policy_info.py   |   28 +
 .../Demos/security/setkernelobjectsecurity.py |  135 +
 .../Demos/security/setnamedsecurityinfo.py    |  131 +
 lib/win32/Demos/security/setsecurityinfo.py   |  132 +
 .../Demos/security/setuserobjectsecurity.py   |  103 +
 lib/win32/Demos/security/sspi/fetch_url.py    |  160 +
 lib/win32/Demos/security/sspi/simple_auth.py  |   72 +
 .../Demos/security/sspi/socket_server.py      |  201 +
 .../Demos/security/sspi/validate_password.py  |   41 +
 .../Demos/service/nativePipeTestService.py    |   63 +
 lib/win32/Demos/service/pipeTestService.py    |  184 +
 .../Demos/service/pipeTestServiceClient.py    |  156 +
 lib/win32/Demos/service/serviceEvents.py      |   98 +
 lib/win32/Demos/timer_demo.py                 |   72 +
 lib/win32/Demos/win32clipboardDemo.py         |  145 +
 lib/win32/Demos/win32clipboard_bitmapdemo.py  |  117 +
 lib/win32/Demos/win32comport_demo.py          |  144 +
 lib/win32/Demos/win32console_demo.py          |  135 +
 lib/win32/Demos/win32cred_demo.py             |   82 +
 lib/win32/Demos/win32fileDemo.py              |   41 +
 lib/win32/Demos/win32gui_demo.py              |  177 +
 lib/win32/Demos/win32gui_devicenotify.py      |  107 +
 lib/win32/Demos/win32gui_dialog.py            |  458 ++
 lib/win32/Demos/win32gui_menu.py              |  420 ++
 lib/win32/Demos/win32gui_taskbar.py           |  141 +
 lib/win32/Demos/win32netdemo.py               |  274 +
 lib/win32/Demos/win32rcparser_demo.py         |   86 +
 lib/win32/Demos/win32servicedemo.py           |   23 +
 .../Demos/win32ts_logoff_disconnected.py      |   24 +
 lib/win32/Demos/win32wnet/testwnet.py         |  125 +
 lib/win32/Demos/win32wnet/winnetwk.py         |  100 +
 lib/win32/Demos/winprocess.py                 |  230 +
 lib/win32/include/PyWinTypes.h                |  727 +++
 lib/win32/lib/afxres.py                       |  501 ++
 lib/win32/lib/commctrl.py                     | 1551 +++++
 lib/win32/lib/dbi.py                          |   27 +
 lib/win32/lib/mmsystem.py                     |  954 ++++
 lib/win32/lib/netbios.py                      |  304 +
 lib/win32/lib/ntsecuritycon.py                |  731 +++
 lib/win32/lib/pywin32_bootstrap.py            |   29 +
 lib/win32/lib/pywin32_testutil.py             |  327 ++
 lib/win32/lib/pywintypes.py                   |  126 +
 lib/win32/lib/rasutil.py                      |   40 +
 lib/win32/lib/regcheck.py                     |  162 +
 lib/win32/lib/regutil.py                      |  397 ++
 lib/win32/lib/sspi.py                         |  412 ++
 lib/win32/lib/sspicon.py                      |  477 ++
 lib/win32/lib/win2kras.py                     |    7 +
 lib/win32/lib/win32con.py                     | 5083 +++++++++++++++++
 lib/win32/lib/win32cryptcon.py                | 1925 +++++++
 lib/win32/lib/win32evtlogutil.py              |  229 +
 lib/win32/lib/win32gui_struct.py              |  999 ++++
 lib/win32/lib/win32inetcon.py                 | 1086 ++++
 lib/win32/lib/win32netcon.py                  |  627 ++
 lib/win32/lib/win32pdhquery.py                |  571 ++
 lib/win32/lib/win32pdhutil.py                 |  210 +
 lib/win32/lib/win32rcparser.py                |  677 +++
 lib/win32/lib/win32serviceutil.py             | 1071 ++++
 lib/win32/lib/win32timezone.py                | 1023 ++++
 lib/win32/lib/win32traceutil.py               |   59 +
 lib/win32/lib/win32verstamp.py                |  236 +
 lib/win32/lib/winerror.py                     | 3039 ++++++++++
 lib/win32/lib/winioctlcon.py                  | 1079 ++++
 lib/win32/lib/winnt.py                        | 1371 +++++
 lib/win32/lib/winperf.py                      |  236 +
 lib/win32/lib/winxptheme.py                   |    7 +
 lib/win32/license.txt                         |   30 +
 lib/win32/scripts/ControlService.py           |  594 ++
 .../scripts/VersionStamp/BrandProject.py      |   98 +
 lib/win32/scripts/VersionStamp/bulkstamp.py   |  149 +
 lib/win32/scripts/VersionStamp/vssutil.py     |  204 +
 lib/win32/scripts/backupEventLog.py           |   46 +
 lib/win32/scripts/ce/pysynch.py               |  290 +
 lib/win32/scripts/killProcName.py             |   62 +
 lib/win32/scripts/rasutil.py                  |   97 +
 lib/win32/scripts/regsetup.py                 |  612 ++
 lib/win32/scripts/setup_d.py                  |  110 +
 lib/win32/test/handles.py                     |  171 +
 lib/win32/test/test_clipboard.py              |  127 +
 lib/win32/test/test_exceptions.py             |  223 +
 lib/win32/test/test_odbc.py                   |  267 +
 lib/win32/test/test_pywintypes.py             |  116 +
 lib/win32/test/test_security.py               |  166 +
 lib/win32/test/test_sspi.py                   |  231 +
 lib/win32/test/test_win32api.py               |  268 +
 lib/win32/test/test_win32crypt.py             |  129 +
 lib/win32/test/test_win32event.py             |  119 +
 lib/win32/test/test_win32file.py              | 1085 ++++
 lib/win32/test/test_win32gui.py               |   65 +
 lib/win32/test/test_win32guistruct.py         |  330 ++
 lib/win32/test/test_win32inet.py              |   93 +
 lib/win32/test/test_win32net.py               |   24 +
 lib/win32/test/test_win32pipe.py              |  153 +
 lib/win32/test/test_win32print.py             |   24 +
 lib/win32/test/test_win32profile.py           |   18 +
 lib/win32/test/test_win32rcparser.py          |   70 +
 lib/win32/test/test_win32timezone.py          |   27 +
 lib/win32/test/test_win32trace.py             |  369 ++
 lib/win32/test/test_win32wnet.py              |  175 +
 lib/win32/test/testall.py                     |  230 +
 lib/win32/test/win32rcparser/python.bmp       |  Bin 0 -> 778 bytes
 lib/win32/test/win32rcparser/python.ico       |  Bin 0 -> 766 bytes
 lib/win32/test/win32rcparser/test.h           |   46 +
 lib/win32/test/win32rcparser/test.rc          |  216 +
 lib/win32com/HTML/GeneratedSupport.html       |  104 +
 lib/win32com/HTML/PythonCOM.html              |   90 +
 lib/win32com/HTML/QuickStartClientCom.html    |   82 +
 lib/win32com/HTML/QuickStartServerCom.html    |  195 +
 lib/win32com/HTML/docindex.html               |   22 +
 lib/win32com/HTML/image/BTN_HomePage.gif      |  Bin 0 -> 211 bytes
 lib/win32com/HTML/image/BTN_ManualTop.gif     |  Bin 0 -> 215 bytes
 lib/win32com/HTML/image/BTN_NextPage.gif      |  Bin 0 -> 218 bytes
 lib/win32com/HTML/image/BTN_PrevPage.gif      |  Bin 0 -> 216 bytes
 lib/win32com/HTML/image/blank.gif             |  Bin 0 -> 864 bytes
 lib/win32com/HTML/image/pycom_blowing.gif     |  Bin 0 -> 20926 bytes
 lib/win32com/HTML/image/pythoncom.gif         |  Bin 0 -> 5767 bytes
 lib/win32com/HTML/image/www_icon.gif          |  Bin 0 -> 275 bytes
 lib/win32com/HTML/index.html                  |   31 +
 lib/win32com/HTML/misc.html                   |   18 +
 lib/win32com/HTML/package.html                |   37 +
 lib/win32com/HTML/variant.html                |  162 +
 lib/win32com/License.txt                      |   30 +
 lib/win32com/__init__.py                      |  132 +
 lib/win32com/client/CLSIDToClass.py           |   57 +
 lib/win32com/client/__init__.py               |  714 +++
 lib/win32com/client/build.py                  |  789 +++
 lib/win32com/client/combrowse.py              |  619 ++
 lib/win32com/client/connect.py                |   48 +
 lib/win32com/client/dynamic.py                |  708 +++
 lib/win32com/client/gencache.py               |  799 +++
 lib/win32com/client/genpy.py                  | 1411 +++++
 lib/win32com/client/makepy.py                 |  459 ++
 lib/win32com/client/selecttlb.py              |  183 +
 lib/win32com/client/tlbrowse.py               |  279 +
 lib/win32com/client/util.py                   |  102 +
 lib/win32com/demos/__init__.py                |    0
 lib/win32com/demos/connect.py                 |  100 +
 lib/win32com/demos/dump_clipboard.py          |   74 +
 lib/win32com/demos/eventsApartmentThreaded.py |   98 +
 lib/win32com/demos/eventsFreeThreaded.py      |   92 +
 lib/win32com/demos/excelAddin.py              |  170 +
 lib/win32com/demos/excelRTDServer.py          |  434 ++
 lib/win32com/demos/iebutton.py                |  217 +
 lib/win32com/demos/ietoolbar.py               |  376 ++
 lib/win32com/demos/outlookAddin.py            |  138 +
 lib/win32com/demos/trybag.py                  |   77 +
 lib/win32com/include/PythonCOM.h              |  766 +++
 lib/win32com/include/PythonCOMRegister.h      |   84 +
 lib/win32com/include/PythonCOMServer.h        |  176 +
 lib/win32com/makegw/__init__.py               |    1 +
 lib/win32com/makegw/makegw.py                 |  560 ++
 lib/win32com/makegw/makegwenum.py             |  331 ++
 lib/win32com/makegw/makegwparse.py            | 1008 ++++
 lib/win32com/olectl.py                        |   70 +
 lib/win32com/readme.html                      |   87 +
 lib/win32com/server/__init__.py               |    1 +
 lib/win32com/server/connect.py                |   84 +
 lib/win32com/server/dispatcher.py             |  291 +
 lib/win32com/server/exception.py              |  105 +
 lib/win32com/server/factory.py                |   26 +
 lib/win32com/server/localserver.py            |   53 +
 lib/win32com/server/policy.py                 |  829 +++
 lib/win32com/server/register.py               |  672 +++
 lib/win32com/server/util.py                   |  229 +
 lib/win32com/servers/PythonTools.py           |   47 +
 lib/win32com/servers/__init__.py              |    0
 lib/win32com/servers/dictionary.py            |  137 +
 lib/win32com/servers/interp.py                |   55 +
 lib/win32com/servers/perfmon.py               |   34 +
 lib/win32com/servers/test_pycomtest.py        |  182 +
 lib/win32com/storagecon.py                    |  142 +
 lib/win32com/test/GenTestScripts.py           |   95 +
 lib/win32com/test/Testpys.sct                 |   64 +
 lib/win32com/test/__init__.py                 |    1 +
 lib/win32com/test/daodump.py                  |   90 +
 lib/win32com/test/errorSemantics.py           |  259 +
 lib/win32com/test/pippo.idl                   |   66 +
 lib/win32com/test/pippo_server.py             |   97 +
 lib/win32com/test/policySemantics.py          |  116 +
 lib/win32com/test/readme.txt                  |   18 +
 lib/win32com/test/testADOEvents.py            |  100 +
 lib/win32com/test/testAXScript.py             |   43 +
 lib/win32com/test/testAccess.py               |  187 +
 lib/win32com/test/testArrays.py               |   99 +
 lib/win32com/test/testClipboard.py            |  170 +
 lib/win32com/test/testCollections.py          |  166 +
 lib/win32com/test/testConversionErrors.py     |   39 +
 lib/win32com/test/testDCOM.py                 |   50 +
 lib/win32com/test/testDates.py                |   74 +
 lib/win32com/test/testDictionary.py           |   99 +
 lib/win32com/test/testDictionary.vbs          |   26 +
 lib/win32com/test/testDynamic.py              |   89 +
 lib/win32com/test/testExchange.py             |  126 +
 lib/win32com/test/testExplorer.py             |  145 +
 lib/win32com/test/testGIT.py                  |  145 +
 lib/win32com/test/testGatewayAddresses.py     |  149 +
 lib/win32com/test/testInterp.vbs              |   12 +
 lib/win32com/test/testIterators.py            |  140 +
 lib/win32com/test/testMSOffice.py             |  209 +
 lib/win32com/test/testMSOfficeEvents.py       |  136 +
 lib/win32com/test/testMarshal.py              |  160 +
 lib/win32com/test/testNetscape.py             |   27 +
 lib/win32com/test/testPersist.py              |  231 +
 lib/win32com/test/testPippo.py                |   82 +
 lib/win32com/test/testPyComTest.py            |  835 +++
 lib/win32com/test/testPyScriptlet.js          |   33 +
 lib/win32com/test/testROT.py                  |   29 +
 lib/win32com/test/testServers.py              |   52 +
 lib/win32com/test/testShell.py                |  281 +
 lib/win32com/test/testStorage.py              |   88 +
 lib/win32com/test/testStreams.py              |  148 +
 lib/win32com/test/testWMI.py                  |   18 +
 lib/win32com/test/testall.py                  |  321 ++
 lib/win32com/test/testmakepy.py               |   55 +
 lib/win32com/test/testvb.py                   |  594 ++
 lib/win32com/test/testvbscript_regexp.py      |   40 +
 lib/win32com/test/testxslt.js                 |   12 +
 lib/win32com/test/testxslt.py                 |   34 +
 lib/win32com/test/testxslt.xsl                |   55 +
 lib/win32com/test/util.py                     |  265 +
 lib/win32com/universal.py                     |  226 +
 lib/win32com/util.py                          |   34 +
 lib/win32comext/adsi/__init__.py              |  122 +
 lib/win32comext/adsi/adsi.pyd                 |  Bin 0 -> 97792 bytes
 lib/win32comext/adsi/adsicon.py               |  340 ++
 lib/win32comext/adsi/demos/objectPicker.py    |   68 +
 lib/win32comext/adsi/demos/scp.py             |  565 ++
 lib/win32comext/adsi/demos/search.py          |  152 +
 lib/win32comext/adsi/demos/test.py            |  273 +
 lib/win32comext/authorization/__init__.py     |    6 +
 .../authorization/authorization.pyd           |  Bin 0 -> 29696 bytes
 .../authorization/demos/EditSecurity.py       |  255 +
 .../demos/EditServiceSecurity.py              |  242 +
 lib/win32comext/axcontrol/__init__.py         |    4 +
 lib/win32comext/axcontrol/axcontrol.pyd       |  Bin 0 -> 143872 bytes
 lib/win32comext/axdebug/__init__.py           |    4 +
 lib/win32comext/axdebug/adb.py                |  480 ++
 lib/win32comext/axdebug/axdebug.pyd           |  Bin 0 -> 285184 bytes
 lib/win32comext/axdebug/codecontainer.py      |  278 +
 lib/win32comext/axdebug/contexts.py           |   62 +
 lib/win32comext/axdebug/debugger.py           |  250 +
 lib/win32comext/axdebug/documents.py          |  140 +
 lib/win32comext/axdebug/dump.py               |   61 +
 lib/win32comext/axdebug/expressions.py        |  214 +
 lib/win32comext/axdebug/gateways.py           |  583 ++
 lib/win32comext/axdebug/stackframe.py         |  179 +
 lib/win32comext/axdebug/util.py               |  141 +
 .../Demos/client/asp/CreateObject.asp         |   19 +
 .../axscript/Demos/client/asp/caps.asp        |   52 +
 .../Demos/client/asp/interrupt/test.asp       |    4 +
 .../Demos/client/asp/interrupt/test.html      |   10 +
 .../Demos/client/asp/interrupt/test1.asp      |    6 +
 .../Demos/client/asp/interrupt/test1.html     |   11 +
 .../axscript/Demos/client/asp/tut1.asp        |   11 +
 .../axscript/Demos/client/ie/MarqueeText1.htm |   25 +
 .../axscript/Demos/client/ie/calc.htm         |  116 +
 .../axscript/Demos/client/ie/dbgtest.htm      |   16 +
 .../axscript/Demos/client/ie/demo.htm         |   26 +
 .../axscript/Demos/client/ie/demo_check.htm   |   42 +
 .../axscript/Demos/client/ie/demo_intro.htm   |   38 +
 .../axscript/Demos/client/ie/demo_menu.htm    |   16 +
 .../axscript/Demos/client/ie/docwrite.htm     |   25 +
 .../axscript/Demos/client/ie/foo2.htm         |  105 +
 .../axscript/Demos/client/ie/form.htm         |   25 +
 .../axscript/Demos/client/ie/marqueeDemo.htm  |   60 +
 .../axscript/Demos/client/ie/mousetrack.htm   |   83 +
 .../Demos/client/ie/pycom_blowing.gif         |  Bin 0 -> 20926 bytes
 .../axscript/Demos/client/wsh/blank.pys       |    0
 .../axscript/Demos/client/wsh/excel.pys       |   34 +
 .../axscript/Demos/client/wsh/registry.pys    |   45 +
 .../axscript/Demos/client/wsh/test.pys        |   15 +
 lib/win32comext/axscript/__init__.py          |    4 +
 lib/win32comext/axscript/asputil.py           |   13 +
 lib/win32comext/axscript/axscript.pyd         |  Bin 0 -> 93184 bytes
 lib/win32comext/axscript/client/__init__.py   |    1 +
 lib/win32comext/axscript/client/debug.py      |  240 +
 lib/win32comext/axscript/client/error.py      |  273 +
 lib/win32comext/axscript/client/framework.py  | 1270 ++++
 lib/win32comext/axscript/client/pydumper.py   |   77 +
 lib/win32comext/axscript/client/pyscript.py   |  443 ++
 .../axscript/client/pyscript_rexec.py         |   49 +
 .../axscript/client/scriptdispatch.py         |  115 +
 lib/win32comext/axscript/server/__init__.py   |    0
 lib/win32comext/axscript/server/axsite.py     |  145 +
 lib/win32comext/axscript/server/error.py      |   16 +
 lib/win32comext/axscript/test/debugTest.pys   |   17 +
 lib/win32comext/axscript/test/debugTest.vbs   |    7 +
 lib/win32comext/axscript/test/leakTest.py     |  188 +
 lib/win32comext/axscript/test/testHost.py     |  257 +
 lib/win32comext/axscript/test/testHost4Dbg.py |   88 +
 lib/win32comext/bits/__init__.py              |    6 +
 lib/win32comext/bits/bits.pyd                 |  Bin 0 -> 62976 bytes
 lib/win32comext/bits/test/show_all_jobs.py    |   52 +
 lib/win32comext/bits/test/test_bits.py        |  121 +
 lib/win32comext/directsound/__init__.py       |    4 +
 lib/win32comext/directsound/directsound.pyd   |  Bin 0 -> 76288 bytes
 lib/win32comext/directsound/test/__init__.py  |    1 +
 lib/win32comext/directsound/test/ds_record.py |   60 +
 lib/win32comext/directsound/test/ds_test.py   |  402 ++
 lib/win32comext/ifilter/__init__.py           |    1 +
 lib/win32comext/ifilter/demo/filterDemo.py    |  300 +
 lib/win32comext/ifilter/ifilter.pyd           |  Bin 0 -> 30720 bytes
 lib/win32comext/ifilter/ifiltercon.py         |  110 +
 lib/win32comext/internet/__init__.py          |    4 +
 lib/win32comext/internet/inetcon.py           |  261 +
 lib/win32comext/internet/internet.pyd         |  Bin 0 -> 93696 bytes
 lib/win32comext/mapi/__init__.py              |   27 +
 lib/win32comext/mapi/demos/mapisend.py        |   98 +
 lib/win32comext/mapi/emsabtags.py             |  874 +++
 lib/win32comext/mapi/exchange.pyd             |  Bin 0 -> 88064 bytes
 lib/win32comext/mapi/mapi.pyd                 |  Bin 0 -> 196608 bytes
 lib/win32comext/mapi/mapitags.py              | 1025 ++++
 lib/win32comext/mapi/mapiutil.py              |  217 +
 lib/win32comext/propsys/__init__.py           |    1 +
 lib/win32comext/propsys/propsys.pyd           |  Bin 0 -> 138752 bytes
 lib/win32comext/propsys/pscon.py              |  838 +++
 lib/win32comext/propsys/test/testpropsys.py   |    5 +
 lib/win32comext/shell/__init__.py             |    4 +
 lib/win32comext/shell/demos/IActiveDesktop.py |   83 +
 .../shell/demos/IFileOperationProgressSink.py |  181 +
 .../shell/demos/IShellLinkDataList.py         |   67 +
 .../shell/demos/ITransferAdviseSink.py        |  107 +
 .../shell/demos/IUniformResourceLocator.py    |   56 +
 .../shell/demos/browse_for_folder.py          |   45 +
 lib/win32comext/shell/demos/create_link.py    |   73 +
 lib/win32comext/shell/demos/dump_link.py      |   58 +
 .../shell/demos/explorer_browser.py           |  143 +
 .../shell/demos/servers/column_provider.py    |  126 +
 .../shell/demos/servers/context_menu.py       |  122 +
 .../shell/demos/servers/copy_hook.py          |   84 +
 .../shell/demos/servers/empty_volume_cache.py |  188 +
 .../shell/demos/servers/folder_view.py        |  862 +++
 .../shell/demos/servers/icon_handler.py       |   82 +
 .../shell/demos/servers/shell_view.py         |  972 ++++
 lib/win32comext/shell/demos/shellexecuteex.py |   19 +
 lib/win32comext/shell/demos/viewstate.py      |   68 +
 .../shell/demos/walk_shell_folders.py         |   24 +
 lib/win32comext/shell/shell.pyd               |  Bin 0 -> 528896 bytes
 lib/win32comext/shell/shellcon.py             | 1597 ++++++
 .../shell/test/testSHFileOperation.py         |   75 +
 lib/win32comext/shell/test/testShellFolder.py |   21 +
 lib/win32comext/shell/test/testShellItem.py   |   69 +
 lib/win32comext/taskscheduler/__init__.py     |    6 +
 .../taskscheduler/taskscheduler.pyd           |  Bin 0 -> 53248 bytes
 .../taskscheduler/test/test_addtask.py        |   66 +
 .../taskscheduler/test/test_addtask_1.py      |   69 +
 .../taskscheduler/test/test_addtask_2.py      |   51 +
 .../taskscheduler/test/test_localsystem.py    |    3 +
 lib/zc/lockfile/__init__.py                   |   23 +-
 lib/zc/lockfile/tests.py                      |   46 +-
 requirements.txt                              |    2 +-
 673 files changed, 159850 insertions(+), 11583 deletions(-)
 create mode 100644 lib/PyWin32.chm
 create mode 100644 lib/adodbapi/__init__.py
 create mode 100644 lib/adodbapi/ado_consts.py
 create mode 100644 lib/adodbapi/adodbapi.py
 create mode 100644 lib/adodbapi/apibase.py
 create mode 100644 lib/adodbapi/examples/db_print.py
 create mode 100644 lib/adodbapi/examples/db_table_names.py
 create mode 100644 lib/adodbapi/examples/xls_read.py
 create mode 100644 lib/adodbapi/examples/xls_write.py
 create mode 100644 lib/adodbapi/is64bit.py
 create mode 100644 lib/adodbapi/license.txt
 create mode 100644 lib/adodbapi/process_connect_string.py
 create mode 100644 lib/adodbapi/readme.txt
 create mode 100644 lib/adodbapi/remote.py
 create mode 100644 lib/adodbapi/schema_table.py
 create mode 100644 lib/adodbapi/setup.py
 create mode 100644 lib/adodbapi/test/adodbapitest.py
 create mode 100644 lib/adodbapi/test/adodbapitestconfig.py
 create mode 100644 lib/adodbapi/test/dbapi20.py
 create mode 100644 lib/adodbapi/test/is64bit.py
 create mode 100644 lib/adodbapi/test/setuptestframework.py
 create mode 100644 lib/adodbapi/test/test_adodbapi_dbapi20.py
 create mode 100644 lib/adodbapi/test/tryconnection.py
 create mode 100644 lib/annotated_types/__init__.py
 rename lib/{jaraco/classes/__init__.py => annotated_types/py.typed} (100%)
 create mode 100644 lib/annotated_types/test_cases.py
 create mode 100644 lib/inflect/compat/__init__.py
 create mode 100644 lib/inflect/compat/pydantic.py
 create mode 100644 lib/inflect/compat/pydantic1.py
 create mode 100644 lib/isapi/README.txt
 create mode 100644 lib/isapi/__init__.py
 create mode 100644 lib/isapi/doc/isapi.html
 create mode 100644 lib/isapi/install.py
 create mode 100644 lib/isapi/isapicon.py
 create mode 100644 lib/isapi/samples/README.txt
 create mode 100644 lib/isapi/samples/advanced.py
 create mode 100644 lib/isapi/samples/redirector.py
 create mode 100644 lib/isapi/samples/redirector_asynch.py
 create mode 100644 lib/isapi/samples/redirector_with_filter.py
 create mode 100644 lib/isapi/samples/test.py
 create mode 100644 lib/isapi/simple.py
 create mode 100644 lib/isapi/test/README.txt
 create mode 100644 lib/isapi/test/extension_simple.py
 create mode 100644 lib/isapi/threaded_extension.py
 rename lib/jaraco/{collections.py => collections/__init__.py} (88%)
 create mode 100644 lib/jaraco/collections/py.typed
 rename lib/jaraco/{functools.py => functools/__init__.py} (84%)
 create mode 100644 lib/jaraco/functools/__init__.pyi
 create mode 100644 lib/jaraco/functools/py.typed
 create mode 100644 lib/jaraco/text/strip-prefix.py
 create mode 100644 lib/pydantic/_internal/__init__.py
 create mode 100644 lib/pydantic/_internal/_config.py
 create mode 100644 lib/pydantic/_internal/_core_metadata.py
 create mode 100644 lib/pydantic/_internal/_core_utils.py
 create mode 100644 lib/pydantic/_internal/_dataclasses.py
 create mode 100644 lib/pydantic/_internal/_decorators.py
 create mode 100644 lib/pydantic/_internal/_decorators_v1.py
 create mode 100644 lib/pydantic/_internal/_discriminated_union.py
 create mode 100644 lib/pydantic/_internal/_fields.py
 create mode 100644 lib/pydantic/_internal/_forward_ref.py
 create mode 100644 lib/pydantic/_internal/_generate_schema.py
 create mode 100644 lib/pydantic/_internal/_generics.py
 create mode 100644 lib/pydantic/_internal/_git.py
 create mode 100644 lib/pydantic/_internal/_internal_dataclass.py
 create mode 100644 lib/pydantic/_internal/_known_annotated_metadata.py
 create mode 100644 lib/pydantic/_internal/_mock_val_ser.py
 create mode 100644 lib/pydantic/_internal/_model_construction.py
 create mode 100644 lib/pydantic/_internal/_repr.py
 create mode 100644 lib/pydantic/_internal/_schema_generation_shared.py
 create mode 100644 lib/pydantic/_internal/_signature.py
 create mode 100644 lib/pydantic/_internal/_std_types_schema.py
 create mode 100644 lib/pydantic/_internal/_typing_extra.py
 create mode 100644 lib/pydantic/_internal/_utils.py
 create mode 100644 lib/pydantic/_internal/_validate_call.py
 create mode 100644 lib/pydantic/_internal/_validators.py
 create mode 100644 lib/pydantic/_migration.py
 create mode 100644 lib/pydantic/alias_generators.py
 create mode 100644 lib/pydantic/aliases.py
 create mode 100644 lib/pydantic/annotated_handlers.py
 create mode 100644 lib/pydantic/deprecated/__init__.py
 create mode 100644 lib/pydantic/deprecated/class_validators.py
 create mode 100644 lib/pydantic/deprecated/config.py
 create mode 100644 lib/pydantic/deprecated/copy_internals.py
 create mode 100644 lib/pydantic/deprecated/decorator.py
 create mode 100644 lib/pydantic/deprecated/json.py
 create mode 100644 lib/pydantic/deprecated/parse.py
 create mode 100644 lib/pydantic/deprecated/tools.py
 create mode 100644 lib/pydantic/functional_serializers.py
 create mode 100644 lib/pydantic/functional_validators.py
 create mode 100644 lib/pydantic/json_schema.py
 create mode 100644 lib/pydantic/plugin/__init__.py
 create mode 100644 lib/pydantic/plugin/_loader.py
 create mode 100644 lib/pydantic/plugin/_schema_validator.py
 create mode 100644 lib/pydantic/root_model.py
 create mode 100644 lib/pydantic/type_adapter.py
 create mode 100644 lib/pydantic/v1/__init__.py
 rename lib/pydantic/{ => v1}/_hypothesis_plugin.py (97%)
 rename lib/pydantic/{ => v1}/annotated_types.py (100%)
 create mode 100644 lib/pydantic/v1/class_validators.py
 create mode 100644 lib/pydantic/v1/color.py
 create mode 100644 lib/pydantic/v1/config.py
 create mode 100644 lib/pydantic/v1/dataclasses.py
 create mode 100644 lib/pydantic/v1/datetime_parse.py
 create mode 100644 lib/pydantic/v1/decorator.py
 create mode 100644 lib/pydantic/v1/env_settings.py
 create mode 100644 lib/pydantic/v1/error_wrappers.py
 create mode 100644 lib/pydantic/v1/errors.py
 create mode 100644 lib/pydantic/v1/fields.py
 create mode 100644 lib/pydantic/v1/generics.py
 create mode 100644 lib/pydantic/v1/json.py
 create mode 100644 lib/pydantic/v1/main.py
 create mode 100644 lib/pydantic/v1/mypy.py
 create mode 100644 lib/pydantic/v1/networks.py
 create mode 100644 lib/pydantic/v1/parse.py
 create mode 100644 lib/pydantic/v1/py.typed
 create mode 100644 lib/pydantic/v1/schema.py
 create mode 100644 lib/pydantic/v1/tools.py
 create mode 100644 lib/pydantic/v1/types.py
 create mode 100644 lib/pydantic/v1/typing.py
 create mode 100644 lib/pydantic/v1/utils.py
 create mode 100644 lib/pydantic/v1/validators.py
 create mode 100644 lib/pydantic/v1/version.py
 create mode 100644 lib/pydantic/validate_call_decorator.py
 create mode 100644 lib/pydantic/warnings.py
 create mode 100644 lib/pydantic_core/__init__.py
 create mode 100644 lib/pydantic_core/_pydantic_core.pyi
 create mode 100644 lib/pydantic_core/core_schema.py
 create mode 100644 lib/pydantic_core/py.typed
 create mode 100644 lib/pythoncom.py
 create mode 100644 lib/pythonwin/license.txt
 create mode 100644 lib/pythonwin/pywin/Demos/app/basictimerapp.py
 create mode 100644 lib/pythonwin/pywin/Demos/app/customprint.py
 create mode 100644 lib/pythonwin/pywin/Demos/app/demoutils.py
 create mode 100644 lib/pythonwin/pywin/Demos/app/dlgappdemo.py
 create mode 100644 lib/pythonwin/pywin/Demos/app/dojobapp.py
 create mode 100644 lib/pythonwin/pywin/Demos/app/helloapp.py
 create mode 100644 lib/pythonwin/pywin/Demos/cmdserver.py
 create mode 100644 lib/pythonwin/pywin/Demos/createwin.py
 create mode 100644 lib/pythonwin/pywin/Demos/demoutils.py
 create mode 100644 lib/pythonwin/pywin/Demos/dibdemo.py
 create mode 100644 lib/pythonwin/pywin/Demos/dlgtest.py
 create mode 100644 lib/pythonwin/pywin/Demos/dyndlg.py
 create mode 100644 lib/pythonwin/pywin/Demos/fontdemo.py
 create mode 100644 lib/pythonwin/pywin/Demos/guidemo.py
 create mode 100644 lib/pythonwin/pywin/Demos/hiertest.py
 create mode 100644 lib/pythonwin/pywin/Demos/menutest.py
 create mode 100644 lib/pythonwin/pywin/Demos/objdoc.py
 create mode 100644 lib/pythonwin/pywin/Demos/ocx/__init__.py
 create mode 100644 lib/pythonwin/pywin/Demos/ocx/demoutils.py
 create mode 100644 lib/pythonwin/pywin/Demos/ocx/flash.py
 create mode 100644 lib/pythonwin/pywin/Demos/ocx/msoffice.py
 create mode 100644 lib/pythonwin/pywin/Demos/ocx/ocxserialtest.py
 create mode 100644 lib/pythonwin/pywin/Demos/ocx/ocxtest.py
 create mode 100644 lib/pythonwin/pywin/Demos/ocx/webbrowser.py
 create mode 100644 lib/pythonwin/pywin/Demos/openGLDemo.py
 create mode 100644 lib/pythonwin/pywin/Demos/progressbar.py
 create mode 100644 lib/pythonwin/pywin/Demos/sliderdemo.py
 create mode 100644 lib/pythonwin/pywin/Demos/splittst.py
 create mode 100644 lib/pythonwin/pywin/Demos/threadedgui.py
 create mode 100644 lib/pythonwin/pywin/Demos/toolbar.py
 create mode 100644 lib/pythonwin/pywin/IDLE.cfg
 create mode 100644 lib/pythonwin/pywin/__init__.py
 create mode 100644 lib/pythonwin/pywin/default.cfg
 create mode 100644 lib/pythonwin/pywin/dialogs/__init__.py
 create mode 100644 lib/pythonwin/pywin/dialogs/ideoptions.py
 create mode 100644 lib/pythonwin/pywin/dialogs/list.py
 create mode 100644 lib/pythonwin/pywin/dialogs/login.py
 create mode 100644 lib/pythonwin/pywin/dialogs/status.py
 create mode 100644 lib/pythonwin/pywin/docking/DockingBar.py
 create mode 100644 lib/pythonwin/pywin/docking/__init__.py
 create mode 100644 lib/pythonwin/pywin/framework/__init__.py
 create mode 100644 lib/pythonwin/pywin/framework/app.py
 create mode 100644 lib/pythonwin/pywin/framework/bitmap.py
 create mode 100644 lib/pythonwin/pywin/framework/cmdline.py
 create mode 100644 lib/pythonwin/pywin/framework/dbgcommands.py
 create mode 100644 lib/pythonwin/pywin/framework/dlgappcore.py
 create mode 100644 lib/pythonwin/pywin/framework/editor/ModuleBrowser.py
 create mode 100644 lib/pythonwin/pywin/framework/editor/__init__.py
 create mode 100644 lib/pythonwin/pywin/framework/editor/color/__init__.py
 create mode 100644 lib/pythonwin/pywin/framework/editor/color/coloreditor.py
 create mode 100644 lib/pythonwin/pywin/framework/editor/configui.py
 create mode 100644 lib/pythonwin/pywin/framework/editor/document.py
 create mode 100644 lib/pythonwin/pywin/framework/editor/editor.py
 create mode 100644 lib/pythonwin/pywin/framework/editor/frame.py
 create mode 100644 lib/pythonwin/pywin/framework/editor/template.py
 create mode 100644 lib/pythonwin/pywin/framework/editor/vss.py
 create mode 100644 lib/pythonwin/pywin/framework/help.py
 create mode 100644 lib/pythonwin/pywin/framework/interact.py
 create mode 100644 lib/pythonwin/pywin/framework/intpyapp.py
 create mode 100644 lib/pythonwin/pywin/framework/intpydde.py
 create mode 100644 lib/pythonwin/pywin/framework/mdi_pychecker.py
 create mode 100644 lib/pythonwin/pywin/framework/scriptutils.py
 create mode 100644 lib/pythonwin/pywin/framework/sgrepmdi.py
 create mode 100644 lib/pythonwin/pywin/framework/startup.py
 create mode 100644 lib/pythonwin/pywin/framework/stdin.py
 create mode 100644 lib/pythonwin/pywin/framework/toolmenu.py
 create mode 100644 lib/pythonwin/pywin/framework/window.py
 create mode 100644 lib/pythonwin/pywin/framework/winout.py
 create mode 100644 lib/pythonwin/pywin/idle/AutoExpand.py
 create mode 100644 lib/pythonwin/pywin/idle/AutoIndent.py
 create mode 100644 lib/pythonwin/pywin/idle/CallTips.py
 create mode 100644 lib/pythonwin/pywin/idle/FormatParagraph.py
 create mode 100644 lib/pythonwin/pywin/idle/IdleHistory.py
 create mode 100644 lib/pythonwin/pywin/idle/PyParse.py
 create mode 100644 lib/pythonwin/pywin/idle/__init__.py
 create mode 100644 lib/pythonwin/pywin/mfc/__init__.py
 create mode 100644 lib/pythonwin/pywin/mfc/activex.py
 create mode 100644 lib/pythonwin/pywin/mfc/afxres.py
 create mode 100644 lib/pythonwin/pywin/mfc/dialog.py
 create mode 100644 lib/pythonwin/pywin/mfc/docview.py
 create mode 100644 lib/pythonwin/pywin/mfc/object.py
 create mode 100644 lib/pythonwin/pywin/mfc/thread.py
 create mode 100644 lib/pythonwin/pywin/mfc/window.py
 create mode 100644 lib/pythonwin/pywin/scintilla/IDLEenvironment.py
 create mode 100644 lib/pythonwin/pywin/scintilla/__init__.py
 create mode 100644 lib/pythonwin/pywin/scintilla/bindings.py
 create mode 100644 lib/pythonwin/pywin/scintilla/config.py
 create mode 100644 lib/pythonwin/pywin/scintilla/configui.py
 create mode 100644 lib/pythonwin/pywin/scintilla/control.py
 create mode 100644 lib/pythonwin/pywin/scintilla/document.py
 create mode 100644 lib/pythonwin/pywin/scintilla/find.py
 create mode 100644 lib/pythonwin/pywin/scintilla/formatter.py
 create mode 100644 lib/pythonwin/pywin/scintilla/keycodes.py
 create mode 100644 lib/pythonwin/pywin/scintilla/scintillacon.py
 create mode 100644 lib/pythonwin/pywin/scintilla/view.py
 create mode 100644 lib/pythonwin/pywin/tools/TraceCollector.py
 create mode 100644 lib/pythonwin/pywin/tools/__init__.py
 create mode 100644 lib/pythonwin/pywin/tools/browseProjects.py
 create mode 100644 lib/pythonwin/pywin/tools/browser.py
 create mode 100644 lib/pythonwin/pywin/tools/hierlist.py
 create mode 100644 lib/pythonwin/pywin/tools/regedit.py
 create mode 100644 lib/pythonwin/pywin/tools/regpy.py
 create mode 100644 lib/pythonwin/start_pythonwin.pyw
 create mode 100644 lib/pywin32.version.txt
 create mode 100644 lib/win32/Demos/BackupRead_BackupWrite.py
 create mode 100644 lib/win32/Demos/BackupSeek_streamheaders.py
 create mode 100644 lib/win32/Demos/CopyFileEx.py
 create mode 100644 lib/win32/Demos/CreateFileTransacted_MiniVersion.py
 create mode 100644 lib/win32/Demos/EvtFormatMessage.py
 create mode 100644 lib/win32/Demos/EvtSubscribe_pull.py
 create mode 100644 lib/win32/Demos/EvtSubscribe_push.py
 create mode 100644 lib/win32/Demos/FileSecurityTest.py
 create mode 100644 lib/win32/Demos/GetSaveFileName.py
 create mode 100644 lib/win32/Demos/NetValidatePasswordPolicy.py
 create mode 100644 lib/win32/Demos/OpenEncryptedFileRaw.py
 create mode 100644 lib/win32/Demos/RegCreateKeyTransacted.py
 create mode 100644 lib/win32/Demos/RegRestoreKey.py
 create mode 100644 lib/win32/Demos/SystemParametersInfo.py
 create mode 100644 lib/win32/Demos/c_extension/setup.py
 create mode 100644 lib/win32/Demos/cerapi.py
 create mode 100644 lib/win32/Demos/dde/ddeclient.py
 create mode 100644 lib/win32/Demos/dde/ddeserver.py
 create mode 100644 lib/win32/Demos/desktopmanager.py
 create mode 100644 lib/win32/Demos/eventLogDemo.py
 create mode 100644 lib/win32/Demos/getfilever.py
 create mode 100644 lib/win32/Demos/images/frowny.bmp
 create mode 100644 lib/win32/Demos/images/smiley.bmp
 create mode 100644 lib/win32/Demos/mmapfile_demo.py
 create mode 100644 lib/win32/Demos/pipes/cat.py
 create mode 100644 lib/win32/Demos/pipes/runproc.py
 create mode 100644 lib/win32/Demos/print_desktop.py
 create mode 100644 lib/win32/Demos/rastest.py
 create mode 100644 lib/win32/Demos/security/GetTokenInformation.py
 create mode 100644 lib/win32/Demos/security/account_rights.py
 create mode 100644 lib/win32/Demos/security/explicit_entries.py
 create mode 100644 lib/win32/Demos/security/get_policy_info.py
 create mode 100644 lib/win32/Demos/security/list_rights.py
 create mode 100644 lib/win32/Demos/security/localized_names.py
 create mode 100644 lib/win32/Demos/security/lsaregevent.py
 create mode 100644 lib/win32/Demos/security/lsastore.py
 create mode 100644 lib/win32/Demos/security/query_information.py
 create mode 100644 lib/win32/Demos/security/regsave_sa.py
 create mode 100644 lib/win32/Demos/security/regsecurity.py
 create mode 100644 lib/win32/Demos/security/sa_inherit.py
 create mode 100644 lib/win32/Demos/security/security_enums.py
 create mode 100644 lib/win32/Demos/security/set_file_audit.py
 create mode 100644 lib/win32/Demos/security/set_file_owner.py
 create mode 100644 lib/win32/Demos/security/set_policy_info.py
 create mode 100644 lib/win32/Demos/security/setkernelobjectsecurity.py
 create mode 100644 lib/win32/Demos/security/setnamedsecurityinfo.py
 create mode 100644 lib/win32/Demos/security/setsecurityinfo.py
 create mode 100644 lib/win32/Demos/security/setuserobjectsecurity.py
 create mode 100644 lib/win32/Demos/security/sspi/fetch_url.py
 create mode 100644 lib/win32/Demos/security/sspi/simple_auth.py
 create mode 100644 lib/win32/Demos/security/sspi/socket_server.py
 create mode 100644 lib/win32/Demos/security/sspi/validate_password.py
 create mode 100644 lib/win32/Demos/service/nativePipeTestService.py
 create mode 100644 lib/win32/Demos/service/pipeTestService.py
 create mode 100644 lib/win32/Demos/service/pipeTestServiceClient.py
 create mode 100644 lib/win32/Demos/service/serviceEvents.py
 create mode 100644 lib/win32/Demos/timer_demo.py
 create mode 100644 lib/win32/Demos/win32clipboardDemo.py
 create mode 100644 lib/win32/Demos/win32clipboard_bitmapdemo.py
 create mode 100644 lib/win32/Demos/win32comport_demo.py
 create mode 100644 lib/win32/Demos/win32console_demo.py
 create mode 100644 lib/win32/Demos/win32cred_demo.py
 create mode 100644 lib/win32/Demos/win32fileDemo.py
 create mode 100644 lib/win32/Demos/win32gui_demo.py
 create mode 100644 lib/win32/Demos/win32gui_devicenotify.py
 create mode 100644 lib/win32/Demos/win32gui_dialog.py
 create mode 100644 lib/win32/Demos/win32gui_menu.py
 create mode 100644 lib/win32/Demos/win32gui_taskbar.py
 create mode 100644 lib/win32/Demos/win32netdemo.py
 create mode 100644 lib/win32/Demos/win32rcparser_demo.py
 create mode 100644 lib/win32/Demos/win32servicedemo.py
 create mode 100644 lib/win32/Demos/win32ts_logoff_disconnected.py
 create mode 100644 lib/win32/Demos/win32wnet/testwnet.py
 create mode 100644 lib/win32/Demos/win32wnet/winnetwk.py
 create mode 100644 lib/win32/Demos/winprocess.py
 create mode 100644 lib/win32/include/PyWinTypes.h
 create mode 100644 lib/win32/lib/afxres.py
 create mode 100644 lib/win32/lib/commctrl.py
 create mode 100644 lib/win32/lib/dbi.py
 create mode 100644 lib/win32/lib/mmsystem.py
 create mode 100644 lib/win32/lib/netbios.py
 create mode 100644 lib/win32/lib/ntsecuritycon.py
 create mode 100644 lib/win32/lib/pywin32_bootstrap.py
 create mode 100644 lib/win32/lib/pywin32_testutil.py
 create mode 100644 lib/win32/lib/pywintypes.py
 create mode 100644 lib/win32/lib/rasutil.py
 create mode 100644 lib/win32/lib/regcheck.py
 create mode 100644 lib/win32/lib/regutil.py
 create mode 100644 lib/win32/lib/sspi.py
 create mode 100644 lib/win32/lib/sspicon.py
 create mode 100644 lib/win32/lib/win2kras.py
 create mode 100644 lib/win32/lib/win32con.py
 create mode 100644 lib/win32/lib/win32cryptcon.py
 create mode 100644 lib/win32/lib/win32evtlogutil.py
 create mode 100644 lib/win32/lib/win32gui_struct.py
 create mode 100644 lib/win32/lib/win32inetcon.py
 create mode 100644 lib/win32/lib/win32netcon.py
 create mode 100644 lib/win32/lib/win32pdhquery.py
 create mode 100644 lib/win32/lib/win32pdhutil.py
 create mode 100644 lib/win32/lib/win32rcparser.py
 create mode 100644 lib/win32/lib/win32serviceutil.py
 create mode 100644 lib/win32/lib/win32timezone.py
 create mode 100644 lib/win32/lib/win32traceutil.py
 create mode 100644 lib/win32/lib/win32verstamp.py
 create mode 100644 lib/win32/lib/winerror.py
 create mode 100644 lib/win32/lib/winioctlcon.py
 create mode 100644 lib/win32/lib/winnt.py
 create mode 100644 lib/win32/lib/winperf.py
 create mode 100644 lib/win32/lib/winxptheme.py
 create mode 100644 lib/win32/license.txt
 create mode 100644 lib/win32/scripts/ControlService.py
 create mode 100644 lib/win32/scripts/VersionStamp/BrandProject.py
 create mode 100644 lib/win32/scripts/VersionStamp/bulkstamp.py
 create mode 100644 lib/win32/scripts/VersionStamp/vssutil.py
 create mode 100644 lib/win32/scripts/backupEventLog.py
 create mode 100644 lib/win32/scripts/ce/pysynch.py
 create mode 100644 lib/win32/scripts/killProcName.py
 create mode 100644 lib/win32/scripts/rasutil.py
 create mode 100644 lib/win32/scripts/regsetup.py
 create mode 100644 lib/win32/scripts/setup_d.py
 create mode 100644 lib/win32/test/handles.py
 create mode 100644 lib/win32/test/test_clipboard.py
 create mode 100644 lib/win32/test/test_exceptions.py
 create mode 100644 lib/win32/test/test_odbc.py
 create mode 100644 lib/win32/test/test_pywintypes.py
 create mode 100644 lib/win32/test/test_security.py
 create mode 100644 lib/win32/test/test_sspi.py
 create mode 100644 lib/win32/test/test_win32api.py
 create mode 100644 lib/win32/test/test_win32crypt.py
 create mode 100644 lib/win32/test/test_win32event.py
 create mode 100644 lib/win32/test/test_win32file.py
 create mode 100644 lib/win32/test/test_win32gui.py
 create mode 100644 lib/win32/test/test_win32guistruct.py
 create mode 100644 lib/win32/test/test_win32inet.py
 create mode 100644 lib/win32/test/test_win32net.py
 create mode 100644 lib/win32/test/test_win32pipe.py
 create mode 100644 lib/win32/test/test_win32print.py
 create mode 100644 lib/win32/test/test_win32profile.py
 create mode 100644 lib/win32/test/test_win32rcparser.py
 create mode 100644 lib/win32/test/test_win32timezone.py
 create mode 100644 lib/win32/test/test_win32trace.py
 create mode 100644 lib/win32/test/test_win32wnet.py
 create mode 100644 lib/win32/test/testall.py
 create mode 100644 lib/win32/test/win32rcparser/python.bmp
 create mode 100644 lib/win32/test/win32rcparser/python.ico
 create mode 100644 lib/win32/test/win32rcparser/test.h
 create mode 100644 lib/win32/test/win32rcparser/test.rc
 create mode 100644 lib/win32com/HTML/GeneratedSupport.html
 create mode 100644 lib/win32com/HTML/PythonCOM.html
 create mode 100644 lib/win32com/HTML/QuickStartClientCom.html
 create mode 100644 lib/win32com/HTML/QuickStartServerCom.html
 create mode 100644 lib/win32com/HTML/docindex.html
 create mode 100644 lib/win32com/HTML/image/BTN_HomePage.gif
 create mode 100644 lib/win32com/HTML/image/BTN_ManualTop.gif
 create mode 100644 lib/win32com/HTML/image/BTN_NextPage.gif
 create mode 100644 lib/win32com/HTML/image/BTN_PrevPage.gif
 create mode 100644 lib/win32com/HTML/image/blank.gif
 create mode 100644 lib/win32com/HTML/image/pycom_blowing.gif
 create mode 100644 lib/win32com/HTML/image/pythoncom.gif
 create mode 100644 lib/win32com/HTML/image/www_icon.gif
 create mode 100644 lib/win32com/HTML/index.html
 create mode 100644 lib/win32com/HTML/misc.html
 create mode 100644 lib/win32com/HTML/package.html
 create mode 100644 lib/win32com/HTML/variant.html
 create mode 100644 lib/win32com/License.txt
 create mode 100644 lib/win32com/__init__.py
 create mode 100644 lib/win32com/client/CLSIDToClass.py
 create mode 100644 lib/win32com/client/__init__.py
 create mode 100644 lib/win32com/client/build.py
 create mode 100644 lib/win32com/client/combrowse.py
 create mode 100644 lib/win32com/client/connect.py
 create mode 100644 lib/win32com/client/dynamic.py
 create mode 100644 lib/win32com/client/gencache.py
 create mode 100644 lib/win32com/client/genpy.py
 create mode 100644 lib/win32com/client/makepy.py
 create mode 100644 lib/win32com/client/selecttlb.py
 create mode 100644 lib/win32com/client/tlbrowse.py
 create mode 100644 lib/win32com/client/util.py
 create mode 100644 lib/win32com/demos/__init__.py
 create mode 100644 lib/win32com/demos/connect.py
 create mode 100644 lib/win32com/demos/dump_clipboard.py
 create mode 100644 lib/win32com/demos/eventsApartmentThreaded.py
 create mode 100644 lib/win32com/demos/eventsFreeThreaded.py
 create mode 100644 lib/win32com/demos/excelAddin.py
 create mode 100644 lib/win32com/demos/excelRTDServer.py
 create mode 100644 lib/win32com/demos/iebutton.py
 create mode 100644 lib/win32com/demos/ietoolbar.py
 create mode 100644 lib/win32com/demos/outlookAddin.py
 create mode 100644 lib/win32com/demos/trybag.py
 create mode 100644 lib/win32com/include/PythonCOM.h
 create mode 100644 lib/win32com/include/PythonCOMRegister.h
 create mode 100644 lib/win32com/include/PythonCOMServer.h
 create mode 100644 lib/win32com/makegw/__init__.py
 create mode 100644 lib/win32com/makegw/makegw.py
 create mode 100644 lib/win32com/makegw/makegwenum.py
 create mode 100644 lib/win32com/makegw/makegwparse.py
 create mode 100644 lib/win32com/olectl.py
 create mode 100644 lib/win32com/readme.html
 create mode 100644 lib/win32com/server/__init__.py
 create mode 100644 lib/win32com/server/connect.py
 create mode 100644 lib/win32com/server/dispatcher.py
 create mode 100644 lib/win32com/server/exception.py
 create mode 100644 lib/win32com/server/factory.py
 create mode 100644 lib/win32com/server/localserver.py
 create mode 100644 lib/win32com/server/policy.py
 create mode 100644 lib/win32com/server/register.py
 create mode 100644 lib/win32com/server/util.py
 create mode 100644 lib/win32com/servers/PythonTools.py
 create mode 100644 lib/win32com/servers/__init__.py
 create mode 100644 lib/win32com/servers/dictionary.py
 create mode 100644 lib/win32com/servers/interp.py
 create mode 100644 lib/win32com/servers/perfmon.py
 create mode 100644 lib/win32com/servers/test_pycomtest.py
 create mode 100644 lib/win32com/storagecon.py
 create mode 100644 lib/win32com/test/GenTestScripts.py
 create mode 100644 lib/win32com/test/Testpys.sct
 create mode 100644 lib/win32com/test/__init__.py
 create mode 100644 lib/win32com/test/daodump.py
 create mode 100644 lib/win32com/test/errorSemantics.py
 create mode 100644 lib/win32com/test/pippo.idl
 create mode 100644 lib/win32com/test/pippo_server.py
 create mode 100644 lib/win32com/test/policySemantics.py
 create mode 100644 lib/win32com/test/readme.txt
 create mode 100644 lib/win32com/test/testADOEvents.py
 create mode 100644 lib/win32com/test/testAXScript.py
 create mode 100644 lib/win32com/test/testAccess.py
 create mode 100644 lib/win32com/test/testArrays.py
 create mode 100644 lib/win32com/test/testClipboard.py
 create mode 100644 lib/win32com/test/testCollections.py
 create mode 100644 lib/win32com/test/testConversionErrors.py
 create mode 100644 lib/win32com/test/testDCOM.py
 create mode 100644 lib/win32com/test/testDates.py
 create mode 100644 lib/win32com/test/testDictionary.py
 create mode 100644 lib/win32com/test/testDictionary.vbs
 create mode 100644 lib/win32com/test/testDynamic.py
 create mode 100644 lib/win32com/test/testExchange.py
 create mode 100644 lib/win32com/test/testExplorer.py
 create mode 100644 lib/win32com/test/testGIT.py
 create mode 100644 lib/win32com/test/testGatewayAddresses.py
 create mode 100644 lib/win32com/test/testInterp.vbs
 create mode 100644 lib/win32com/test/testIterators.py
 create mode 100644 lib/win32com/test/testMSOffice.py
 create mode 100644 lib/win32com/test/testMSOfficeEvents.py
 create mode 100644 lib/win32com/test/testMarshal.py
 create mode 100644 lib/win32com/test/testNetscape.py
 create mode 100644 lib/win32com/test/testPersist.py
 create mode 100644 lib/win32com/test/testPippo.py
 create mode 100644 lib/win32com/test/testPyComTest.py
 create mode 100644 lib/win32com/test/testPyScriptlet.js
 create mode 100644 lib/win32com/test/testROT.py
 create mode 100644 lib/win32com/test/testServers.py
 create mode 100644 lib/win32com/test/testShell.py
 create mode 100644 lib/win32com/test/testStorage.py
 create mode 100644 lib/win32com/test/testStreams.py
 create mode 100644 lib/win32com/test/testWMI.py
 create mode 100644 lib/win32com/test/testall.py
 create mode 100644 lib/win32com/test/testmakepy.py
 create mode 100644 lib/win32com/test/testvb.py
 create mode 100644 lib/win32com/test/testvbscript_regexp.py
 create mode 100644 lib/win32com/test/testxslt.js
 create mode 100644 lib/win32com/test/testxslt.py
 create mode 100644 lib/win32com/test/testxslt.xsl
 create mode 100644 lib/win32com/test/util.py
 create mode 100644 lib/win32com/universal.py
 create mode 100644 lib/win32com/util.py
 create mode 100644 lib/win32comext/adsi/__init__.py
 create mode 100644 lib/win32comext/adsi/adsi.pyd
 create mode 100644 lib/win32comext/adsi/adsicon.py
 create mode 100644 lib/win32comext/adsi/demos/objectPicker.py
 create mode 100644 lib/win32comext/adsi/demos/scp.py
 create mode 100644 lib/win32comext/adsi/demos/search.py
 create mode 100644 lib/win32comext/adsi/demos/test.py
 create mode 100644 lib/win32comext/authorization/__init__.py
 create mode 100644 lib/win32comext/authorization/authorization.pyd
 create mode 100644 lib/win32comext/authorization/demos/EditSecurity.py
 create mode 100644 lib/win32comext/authorization/demos/EditServiceSecurity.py
 create mode 100644 lib/win32comext/axcontrol/__init__.py
 create mode 100644 lib/win32comext/axcontrol/axcontrol.pyd
 create mode 100644 lib/win32comext/axdebug/__init__.py
 create mode 100644 lib/win32comext/axdebug/adb.py
 create mode 100644 lib/win32comext/axdebug/axdebug.pyd
 create mode 100644 lib/win32comext/axdebug/codecontainer.py
 create mode 100644 lib/win32comext/axdebug/contexts.py
 create mode 100644 lib/win32comext/axdebug/debugger.py
 create mode 100644 lib/win32comext/axdebug/documents.py
 create mode 100644 lib/win32comext/axdebug/dump.py
 create mode 100644 lib/win32comext/axdebug/expressions.py
 create mode 100644 lib/win32comext/axdebug/gateways.py
 create mode 100644 lib/win32comext/axdebug/stackframe.py
 create mode 100644 lib/win32comext/axdebug/util.py
 create mode 100644 lib/win32comext/axscript/Demos/client/asp/CreateObject.asp
 create mode 100644 lib/win32comext/axscript/Demos/client/asp/caps.asp
 create mode 100644 lib/win32comext/axscript/Demos/client/asp/interrupt/test.asp
 create mode 100644 lib/win32comext/axscript/Demos/client/asp/interrupt/test.html
 create mode 100644 lib/win32comext/axscript/Demos/client/asp/interrupt/test1.asp
 create mode 100644 lib/win32comext/axscript/Demos/client/asp/interrupt/test1.html
 create mode 100644 lib/win32comext/axscript/Demos/client/asp/tut1.asp
 create mode 100644 lib/win32comext/axscript/Demos/client/ie/MarqueeText1.htm
 create mode 100644 lib/win32comext/axscript/Demos/client/ie/calc.htm
 create mode 100644 lib/win32comext/axscript/Demos/client/ie/dbgtest.htm
 create mode 100644 lib/win32comext/axscript/Demos/client/ie/demo.htm
 create mode 100644 lib/win32comext/axscript/Demos/client/ie/demo_check.htm
 create mode 100644 lib/win32comext/axscript/Demos/client/ie/demo_intro.htm
 create mode 100644 lib/win32comext/axscript/Demos/client/ie/demo_menu.htm
 create mode 100644 lib/win32comext/axscript/Demos/client/ie/docwrite.htm
 create mode 100644 lib/win32comext/axscript/Demos/client/ie/foo2.htm
 create mode 100644 lib/win32comext/axscript/Demos/client/ie/form.htm
 create mode 100644 lib/win32comext/axscript/Demos/client/ie/marqueeDemo.htm
 create mode 100644 lib/win32comext/axscript/Demos/client/ie/mousetrack.htm
 create mode 100644 lib/win32comext/axscript/Demos/client/ie/pycom_blowing.gif
 create mode 100644 lib/win32comext/axscript/Demos/client/wsh/blank.pys
 create mode 100644 lib/win32comext/axscript/Demos/client/wsh/excel.pys
 create mode 100644 lib/win32comext/axscript/Demos/client/wsh/registry.pys
 create mode 100644 lib/win32comext/axscript/Demos/client/wsh/test.pys
 create mode 100644 lib/win32comext/axscript/__init__.py
 create mode 100644 lib/win32comext/axscript/asputil.py
 create mode 100644 lib/win32comext/axscript/axscript.pyd
 create mode 100644 lib/win32comext/axscript/client/__init__.py
 create mode 100644 lib/win32comext/axscript/client/debug.py
 create mode 100644 lib/win32comext/axscript/client/error.py
 create mode 100644 lib/win32comext/axscript/client/framework.py
 create mode 100644 lib/win32comext/axscript/client/pydumper.py
 create mode 100644 lib/win32comext/axscript/client/pyscript.py
 create mode 100644 lib/win32comext/axscript/client/pyscript_rexec.py
 create mode 100644 lib/win32comext/axscript/client/scriptdispatch.py
 create mode 100644 lib/win32comext/axscript/server/__init__.py
 create mode 100644 lib/win32comext/axscript/server/axsite.py
 create mode 100644 lib/win32comext/axscript/server/error.py
 create mode 100644 lib/win32comext/axscript/test/debugTest.pys
 create mode 100644 lib/win32comext/axscript/test/debugTest.vbs
 create mode 100644 lib/win32comext/axscript/test/leakTest.py
 create mode 100644 lib/win32comext/axscript/test/testHost.py
 create mode 100644 lib/win32comext/axscript/test/testHost4Dbg.py
 create mode 100644 lib/win32comext/bits/__init__.py
 create mode 100644 lib/win32comext/bits/bits.pyd
 create mode 100644 lib/win32comext/bits/test/show_all_jobs.py
 create mode 100644 lib/win32comext/bits/test/test_bits.py
 create mode 100644 lib/win32comext/directsound/__init__.py
 create mode 100644 lib/win32comext/directsound/directsound.pyd
 create mode 100644 lib/win32comext/directsound/test/__init__.py
 create mode 100644 lib/win32comext/directsound/test/ds_record.py
 create mode 100644 lib/win32comext/directsound/test/ds_test.py
 create mode 100644 lib/win32comext/ifilter/__init__.py
 create mode 100644 lib/win32comext/ifilter/demo/filterDemo.py
 create mode 100644 lib/win32comext/ifilter/ifilter.pyd
 create mode 100644 lib/win32comext/ifilter/ifiltercon.py
 create mode 100644 lib/win32comext/internet/__init__.py
 create mode 100644 lib/win32comext/internet/inetcon.py
 create mode 100644 lib/win32comext/internet/internet.pyd
 create mode 100644 lib/win32comext/mapi/__init__.py
 create mode 100644 lib/win32comext/mapi/demos/mapisend.py
 create mode 100644 lib/win32comext/mapi/emsabtags.py
 create mode 100644 lib/win32comext/mapi/exchange.pyd
 create mode 100644 lib/win32comext/mapi/mapi.pyd
 create mode 100644 lib/win32comext/mapi/mapitags.py
 create mode 100644 lib/win32comext/mapi/mapiutil.py
 create mode 100644 lib/win32comext/propsys/__init__.py
 create mode 100644 lib/win32comext/propsys/propsys.pyd
 create mode 100644 lib/win32comext/propsys/pscon.py
 create mode 100644 lib/win32comext/propsys/test/testpropsys.py
 create mode 100644 lib/win32comext/shell/__init__.py
 create mode 100644 lib/win32comext/shell/demos/IActiveDesktop.py
 create mode 100644 lib/win32comext/shell/demos/IFileOperationProgressSink.py
 create mode 100644 lib/win32comext/shell/demos/IShellLinkDataList.py
 create mode 100644 lib/win32comext/shell/demos/ITransferAdviseSink.py
 create mode 100644 lib/win32comext/shell/demos/IUniformResourceLocator.py
 create mode 100644 lib/win32comext/shell/demos/browse_for_folder.py
 create mode 100644 lib/win32comext/shell/demos/create_link.py
 create mode 100644 lib/win32comext/shell/demos/dump_link.py
 create mode 100644 lib/win32comext/shell/demos/explorer_browser.py
 create mode 100644 lib/win32comext/shell/demos/servers/column_provider.py
 create mode 100644 lib/win32comext/shell/demos/servers/context_menu.py
 create mode 100644 lib/win32comext/shell/demos/servers/copy_hook.py
 create mode 100644 lib/win32comext/shell/demos/servers/empty_volume_cache.py
 create mode 100644 lib/win32comext/shell/demos/servers/folder_view.py
 create mode 100644 lib/win32comext/shell/demos/servers/icon_handler.py
 create mode 100644 lib/win32comext/shell/demos/servers/shell_view.py
 create mode 100644 lib/win32comext/shell/demos/shellexecuteex.py
 create mode 100644 lib/win32comext/shell/demos/viewstate.py
 create mode 100644 lib/win32comext/shell/demos/walk_shell_folders.py
 create mode 100644 lib/win32comext/shell/shell.pyd
 create mode 100644 lib/win32comext/shell/shellcon.py
 create mode 100644 lib/win32comext/shell/test/testSHFileOperation.py
 create mode 100644 lib/win32comext/shell/test/testShellFolder.py
 create mode 100644 lib/win32comext/shell/test/testShellItem.py
 create mode 100644 lib/win32comext/taskscheduler/__init__.py
 create mode 100644 lib/win32comext/taskscheduler/taskscheduler.pyd
 create mode 100644 lib/win32comext/taskscheduler/test/test_addtask.py
 create mode 100644 lib/win32comext/taskscheduler/test/test_addtask_1.py
 create mode 100644 lib/win32comext/taskscheduler/test/test_addtask_2.py
 create mode 100644 lib/win32comext/taskscheduler/test/test_localsystem.py

diff --git a/lib/PyWin32.chm b/lib/PyWin32.chm
new file mode 100644
index 0000000000000000000000000000000000000000..7606f82b16c4d3653d70e8f4903f17f015997efe
GIT binary patch
literal 2648456
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%0A>P!`ef8IA;QD
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%0D*b~X_)`<ToZg{^4AFfSZ9dZT2mB18=<JpHCLonS
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%0D@N)WJ*1(U}b%b%-@zG;jbdv4Dd34
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%0A`Zpf~D^$*T|tuIp|#}!!ohEuj=YJ{bK
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%0AR}63eXBw3e`zs8lU~}7PHW=LBUXtSCI>Vx=jqz
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
CCq4E6

literal 0
HcmV?d00001

diff --git a/lib/adodbapi/__init__.py b/lib/adodbapi/__init__.py
new file mode 100644
index 00000000..0d769e05
--- /dev/null
+++ b/lib/adodbapi/__init__.py
@@ -0,0 +1,74 @@
+"""adodbapi - A python DB API 2.0 (PEP 249) interface to Microsoft ADO
+
+Copyright (C) 2002 Henrik Ekelund, version 2.1 by Vernon Cole
+* http://sourceforge.net/projects/adodbapi
+"""
+import sys
+import time
+
+from .adodbapi import Connection, Cursor, __version__, connect, dateconverter
+from .apibase import (
+    BINARY,
+    DATETIME,
+    NUMBER,
+    ROWID,
+    STRING,
+    DatabaseError,
+    DataError,
+    Error,
+    FetchFailedError,
+    IntegrityError,
+    InterfaceError,
+    InternalError,
+    NotSupportedError,
+    OperationalError,
+    ProgrammingError,
+    Warning,
+    apilevel,
+    paramstyle,
+    threadsafety,
+)
+
+
+def Binary(aString):
+    """This function constructs an object capable of holding a binary (long) string value."""
+    return bytes(aString)
+
+
+def Date(year, month, day):
+    "This function constructs an object holding a date value."
+    return dateconverter.Date(year, month, day)
+
+
+def Time(hour, minute, second):
+    "This function constructs an object holding a time value."
+    return dateconverter.Time(hour, minute, second)
+
+
+def Timestamp(year, month, day, hour, minute, second):
+    "This function constructs an object holding a time stamp value."
+    return dateconverter.Timestamp(year, month, day, hour, minute, second)
+
+
+def DateFromTicks(ticks):
+    """This function constructs an object holding a date value from the given ticks value
+    (number of seconds since the epoch; see the documentation of the standard Python time module for details).
+    """
+    return Date(*time.gmtime(ticks)[:3])
+
+
+def TimeFromTicks(ticks):
+    """This function constructs an object holding a time value from the given ticks value
+    (number of seconds since the epoch; see the documentation of the standard Python time module for details).
+    """
+    return Time(*time.gmtime(ticks)[3:6])
+
+
+def TimestampFromTicks(ticks):
+    """This function constructs an object holding a time stamp value from the given
+    ticks value (number of seconds since the epoch;
+    see the documentation of the standard Python time module for details)."""
+    return Timestamp(*time.gmtime(ticks)[:6])
+
+
+version = "adodbapi v" + __version__
diff --git a/lib/adodbapi/ado_consts.py b/lib/adodbapi/ado_consts.py
new file mode 100644
index 00000000..ecb2147d
--- /dev/null
+++ b/lib/adodbapi/ado_consts.py
@@ -0,0 +1,281 @@
+# ADO enumerated constants documented on MSDN:
+# http://msdn.microsoft.com/en-us/library/ms678353(VS.85).aspx
+
+# IsolationLevelEnum
+adXactUnspecified = -1
+adXactBrowse = 0x100
+adXactChaos = 0x10
+adXactCursorStability = 0x1000
+adXactIsolated = 0x100000
+adXactReadCommitted = 0x1000
+adXactReadUncommitted = 0x100
+adXactRepeatableRead = 0x10000
+adXactSerializable = 0x100000
+
+# CursorLocationEnum
+adUseClient = 3
+adUseServer = 2
+
+# CursorTypeEnum
+adOpenDynamic = 2
+adOpenForwardOnly = 0
+adOpenKeyset = 1
+adOpenStatic = 3
+adOpenUnspecified = -1
+
+# CommandTypeEnum
+adCmdText = 1
+adCmdStoredProc = 4
+adSchemaTables = 20
+
+# ParameterDirectionEnum
+adParamInput = 1
+adParamInputOutput = 3
+adParamOutput = 2
+adParamReturnValue = 4
+adParamUnknown = 0
+directions = {
+    0: "Unknown",
+    1: "Input",
+    2: "Output",
+    3: "InputOutput",
+    4: "Return",
+}
+
+
+def ado_direction_name(ado_dir):
+    try:
+        return "adParam" + directions[ado_dir]
+    except:
+        return "unknown direction (" + str(ado_dir) + ")"
+
+
+# ObjectStateEnum
+adStateClosed = 0
+adStateOpen = 1
+adStateConnecting = 2
+adStateExecuting = 4
+adStateFetching = 8
+
+# FieldAttributeEnum
+adFldMayBeNull = 0x40
+
+# ConnectModeEnum
+adModeUnknown = 0
+adModeRead = 1
+adModeWrite = 2
+adModeReadWrite = 3
+adModeShareDenyRead = 4
+adModeShareDenyWrite = 8
+adModeShareExclusive = 12
+adModeShareDenyNone = 16
+adModeRecursive = 0x400000
+
+# XactAttributeEnum
+adXactCommitRetaining = 131072
+adXactAbortRetaining = 262144
+
+ado_error_TIMEOUT = -2147217871
+
+# DataTypeEnum - ADO Data types documented at:
+# http://msdn2.microsoft.com/en-us/library/ms675318.aspx
+adArray = 0x2000
+adEmpty = 0x0
+adBSTR = 0x8
+adBigInt = 0x14
+adBinary = 0x80
+adBoolean = 0xB
+adChapter = 0x88
+adChar = 0x81
+adCurrency = 0x6
+adDBDate = 0x85
+adDBTime = 0x86
+adDBTimeStamp = 0x87
+adDate = 0x7
+adDecimal = 0xE
+adDouble = 0x5
+adError = 0xA
+adFileTime = 0x40
+adGUID = 0x48
+adIDispatch = 0x9
+adIUnknown = 0xD
+adInteger = 0x3
+adLongVarBinary = 0xCD
+adLongVarChar = 0xC9
+adLongVarWChar = 0xCB
+adNumeric = 0x83
+adPropVariant = 0x8A
+adSingle = 0x4
+adSmallInt = 0x2
+adTinyInt = 0x10
+adUnsignedBigInt = 0x15
+adUnsignedInt = 0x13
+adUnsignedSmallInt = 0x12
+adUnsignedTinyInt = 0x11
+adUserDefined = 0x84
+adVarBinary = 0xCC
+adVarChar = 0xC8
+adVarNumeric = 0x8B
+adVarWChar = 0xCA
+adVariant = 0xC
+adWChar = 0x82
+# Additional constants used by introspection but not ADO itself
+AUTO_FIELD_MARKER = -1000
+
+adTypeNames = {
+    adBSTR: "adBSTR",
+    adBigInt: "adBigInt",
+    adBinary: "adBinary",
+    adBoolean: "adBoolean",
+    adChapter: "adChapter",
+    adChar: "adChar",
+    adCurrency: "adCurrency",
+    adDBDate: "adDBDate",
+    adDBTime: "adDBTime",
+    adDBTimeStamp: "adDBTimeStamp",
+    adDate: "adDate",
+    adDecimal: "adDecimal",
+    adDouble: "adDouble",
+    adEmpty: "adEmpty",
+    adError: "adError",
+    adFileTime: "adFileTime",
+    adGUID: "adGUID",
+    adIDispatch: "adIDispatch",
+    adIUnknown: "adIUnknown",
+    adInteger: "adInteger",
+    adLongVarBinary: "adLongVarBinary",
+    adLongVarChar: "adLongVarChar",
+    adLongVarWChar: "adLongVarWChar",
+    adNumeric: "adNumeric",
+    adPropVariant: "adPropVariant",
+    adSingle: "adSingle",
+    adSmallInt: "adSmallInt",
+    adTinyInt: "adTinyInt",
+    adUnsignedBigInt: "adUnsignedBigInt",
+    adUnsignedInt: "adUnsignedInt",
+    adUnsignedSmallInt: "adUnsignedSmallInt",
+    adUnsignedTinyInt: "adUnsignedTinyInt",
+    adUserDefined: "adUserDefined",
+    adVarBinary: "adVarBinary",
+    adVarChar: "adVarChar",
+    adVarNumeric: "adVarNumeric",
+    adVarWChar: "adVarWChar",
+    adVariant: "adVariant",
+    adWChar: "adWChar",
+}
+
+
+def ado_type_name(ado_type):
+    return adTypeNames.get(ado_type, "unknown type (" + str(ado_type) + ")")
+
+
+# here in decimal, sorted by value
+# adEmpty 0 Specifies no value (DBTYPE_EMPTY).
+# adSmallInt 2 Indicates a two-byte signed integer (DBTYPE_I2).
+# adInteger 3 Indicates a four-byte signed integer (DBTYPE_I4).
+# adSingle 4 Indicates a single-precision floating-point value (DBTYPE_R4).
+# adDouble 5 Indicates a double-precision floating-point value (DBTYPE_R8).
+# adCurrency 6 Indicates a currency value (DBTYPE_CY). Currency is a fixed-point number
+#   with four digits to the right of the decimal point. It is stored in an eight-byte signed integer scaled by 10,000.
+# adDate 7 Indicates a date value (DBTYPE_DATE). A date is stored as a double, the whole part of which is
+#   the number of days since December 30, 1899, and the fractional part of which is the fraction of a day.
+# adBSTR 8 Indicates a null-terminated character string (Unicode) (DBTYPE_BSTR).
+# adIDispatch 9 Indicates a pointer to an IDispatch interface on a COM object (DBTYPE_IDISPATCH).
+# adError 10 Indicates a 32-bit error code (DBTYPE_ERROR).
+# adBoolean 11 Indicates a boolean value (DBTYPE_BOOL).
+# adVariant 12 Indicates an Automation Variant (DBTYPE_VARIANT).
+# adIUnknown 13 Indicates a pointer to an IUnknown interface on a COM object (DBTYPE_IUNKNOWN).
+# adDecimal 14 Indicates an exact numeric value with a fixed precision and scale (DBTYPE_DECIMAL).
+# adTinyInt 16 Indicates a one-byte signed integer (DBTYPE_I1).
+# adUnsignedTinyInt 17 Indicates a one-byte unsigned integer (DBTYPE_UI1).
+# adUnsignedSmallInt 18 Indicates a two-byte unsigned integer (DBTYPE_UI2).
+# adUnsignedInt 19 Indicates a four-byte unsigned integer (DBTYPE_UI4).
+# adBigInt 20 Indicates an eight-byte signed integer (DBTYPE_I8).
+# adUnsignedBigInt 21 Indicates an eight-byte unsigned integer (DBTYPE_UI8).
+# adFileTime 64 Indicates a 64-bit value representing the number of 100-nanosecond intervals since
+#    January 1, 1601 (DBTYPE_FILETIME).
+# adGUID 72 Indicates a globally unique identifier (GUID) (DBTYPE_GUID).
+# adBinary 128 Indicates a binary value (DBTYPE_BYTES).
+# adChar 129 Indicates a string value (DBTYPE_STR).
+# adWChar 130 Indicates a null-terminated Unicode character string (DBTYPE_WSTR).
+# adNumeric 131 Indicates an exact numeric value with a fixed precision and scale (DBTYPE_NUMERIC).
+#   adUserDefined 132 Indicates a user-defined variable (DBTYPE_UDT).
+# adUserDefined 132 Indicates a user-defined variable (DBTYPE_UDT).
+# adDBDate 133 Indicates a date value (yyyymmdd) (DBTYPE_DBDATE).
+# adDBTime 134 Indicates a time value (hhmmss) (DBTYPE_DBTIME).
+# adDBTimeStamp 135 Indicates a date/time stamp (yyyymmddhhmmss plus a fraction in billionths) (DBTYPE_DBTIMESTAMP).
+# adChapter 136 Indicates a four-byte chapter value that identifies rows in a child rowset (DBTYPE_HCHAPTER).
+# adPropVariant 138 Indicates an Automation PROPVARIANT (DBTYPE_PROP_VARIANT).
+# adVarNumeric 139 Indicates a numeric value (Parameter object only).
+# adVarChar 200 Indicates a string value (Parameter object only).
+# adLongVarChar 201 Indicates a long string value (Parameter object only).
+# adVarWChar 202 Indicates a null-terminated Unicode character string (Parameter object only).
+# adLongVarWChar 203 Indicates a long null-terminated Unicode string value (Parameter object only).
+# adVarBinary 204 Indicates a binary value (Parameter object only).
+# adLongVarBinary 205 Indicates a long binary value (Parameter object only).
+# adArray (Does not apply to ADOX.) 0x2000 A flag value, always combined with another data type constant,
+#   that indicates an array of that other data type.
+
+# Error codes to names
+adoErrors = {
+    0xE7B: "adErrBoundToCommand",
+    0xE94: "adErrCannotComplete",
+    0xEA4: "adErrCantChangeConnection",
+    0xC94: "adErrCantChangeProvider",
+    0xE8C: "adErrCantConvertvalue",
+    0xE8D: "adErrCantCreate",
+    0xEA3: "adErrCatalogNotSet",
+    0xE8E: "adErrColumnNotOnThisRow",
+    0xD5D: "adErrDataConversion",
+    0xE89: "adErrDataOverflow",
+    0xE9A: "adErrDelResOutOfScope",
+    0xEA6: "adErrDenyNotSupported",
+    0xEA7: "adErrDenyTypeNotSupported",
+    0xCB3: "adErrFeatureNotAvailable",
+    0xEA5: "adErrFieldsUpdateFailed",
+    0xC93: "adErrIllegalOperation",
+    0xCAE: "adErrInTransaction",
+    0xE87: "adErrIntegrityViolation",
+    0xBB9: "adErrInvalidArgument",
+    0xE7D: "adErrInvalidConnection",
+    0xE7C: "adErrInvalidParamInfo",
+    0xE82: "adErrInvalidTransaction",
+    0xE91: "adErrInvalidURL",
+    0xCC1: "adErrItemNotFound",
+    0xBCD: "adErrNoCurrentRecord",
+    0xE83: "adErrNotExecuting",
+    0xE7E: "adErrNotReentrant",
+    0xE78: "adErrObjectClosed",
+    0xD27: "adErrObjectInCollection",
+    0xD5C: "adErrObjectNotSet",
+    0xE79: "adErrObjectOpen",
+    0xBBA: "adErrOpeningFile",
+    0xE80: "adErrOperationCancelled",
+    0xE96: "adErrOutOfSpace",
+    0xE88: "adErrPermissionDenied",
+    0xE9E: "adErrPropConflicting",
+    0xE9B: "adErrPropInvalidColumn",
+    0xE9C: "adErrPropInvalidOption",
+    0xE9D: "adErrPropInvalidValue",
+    0xE9F: "adErrPropNotAllSettable",
+    0xEA0: "adErrPropNotSet",
+    0xEA1: "adErrPropNotSettable",
+    0xEA2: "adErrPropNotSupported",
+    0xBB8: "adErrProviderFailed",
+    0xE7A: "adErrProviderNotFound",
+    0xBBB: "adErrReadFile",
+    0xE93: "adErrResourceExists",
+    0xE92: "adErrResourceLocked",
+    0xE97: "adErrResourceOutOfScope",
+    0xE8A: "adErrSchemaViolation",
+    0xE8B: "adErrSignMismatch",
+    0xE81: "adErrStillConnecting",
+    0xE7F: "adErrStillExecuting",
+    0xE90: "adErrTreePermissionDenied",
+    0xE8F: "adErrURLDoesNotExist",
+    0xE99: "adErrURLNamedRowDoesNotExist",
+    0xE98: "adErrUnavailable",
+    0xE84: "adErrUnsafeOperation",
+    0xE95: "adErrVolumeNotFound",
+    0xBBC: "adErrWriteFile",
+}
diff --git a/lib/adodbapi/adodbapi.py b/lib/adodbapi/adodbapi.py
new file mode 100644
index 00000000..8f7c045e
--- /dev/null
+++ b/lib/adodbapi/adodbapi.py
@@ -0,0 +1,1223 @@
+"""adodbapi - A python DB API 2.0 (PEP 249) interface to Microsoft ADO
+
+Copyright (C) 2002 Henrik Ekelund, versions 2.1 and later by Vernon Cole
+* http://sourceforge.net/projects/pywin32
+* https://github.com/mhammond/pywin32
+* http://sourceforge.net/projects/adodbapi
+
+    This library is free software; you can redistribute it and/or
+    modify it under the terms of the GNU Lesser General Public
+    License as published by the Free Software Foundation; either
+    version 2.1 of the License, or (at your option) any later version.
+
+    This library is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+    Lesser General Public License for more details.
+
+    You should have received a copy of the GNU Lesser General Public
+    License along with this library; if not, write to the Free Software
+    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+
+    django adaptations and refactoring by Adam Vandenberg
+
+DB-API 2.0 specification: http://www.python.org/dev/peps/pep-0249/
+
+This module source should run correctly in CPython versions 2.7 and later,
+or IronPython version 2.7 and later,
+or, after running through 2to3.py, CPython 3.4 or later.
+"""
+
+__version__ = "2.6.2.0"
+version = "adodbapi v" + __version__
+
+import copy
+import decimal
+import os
+import sys
+import weakref
+
+from . import ado_consts as adc, apibase as api, process_connect_string
+
+try:
+    verbose = int(os.environ["ADODBAPI_VERBOSE"])
+except:
+    verbose = False
+if verbose:
+    print(version)
+
+# --- define objects to smooth out IronPython <-> CPython differences
+onWin32 = False  # assume the worst
+if api.onIronPython:
+    from clr import Reference
+    from System import (
+        Activator,
+        Array,
+        Byte,
+        DateTime,
+        DBNull,
+        Decimal as SystemDecimal,
+        Type,
+    )
+
+    def Dispatch(dispatch):
+        type = Type.GetTypeFromProgID(dispatch)
+        return Activator.CreateInstance(type)
+
+    def getIndexedValue(obj, index):
+        return obj.Item[index]
+
+else:  # try pywin32
+    try:
+        import pythoncom
+        import pywintypes
+        import win32com.client
+
+        onWin32 = True
+
+        def Dispatch(dispatch):
+            return win32com.client.Dispatch(dispatch)
+
+    except ImportError:
+        import warnings
+
+        warnings.warn(
+            "pywin32 package (or IronPython) required for adodbapi.", ImportWarning
+        )
+
+    def getIndexedValue(obj, index):
+        return obj(index)
+
+
+from collections.abc import Mapping
+
+# --- define objects to smooth out Python3000 <-> Python 2.x differences
+unicodeType = str
+longType = int
+StringTypes = str
+maxint = sys.maxsize
+
+
+# -----------------  The .connect method -----------------
+def make_COM_connecter():
+    try:
+        if onWin32:
+            pythoncom.CoInitialize()  # v2.1 Paj
+        c = Dispatch("ADODB.Connection")  # connect _after_ CoIninialize v2.1.1 adamvan
+    except:
+        raise api.InterfaceError(
+            "Windows COM Error: Dispatch('ADODB.Connection') failed."
+        )
+    return c
+
+
+def connect(*args, **kwargs):  # --> a db-api connection object
+    """Connect to a database.
+
+    call using:
+    :connection_string -- An ADODB formatted connection string, see:
+         * http://www.connectionstrings.com
+         * http://www.asp101.com/articles/john/connstring/default.asp
+    :timeout -- A command timeout value, in seconds (default 30 seconds)
+    """
+    co = Connection()  # make an empty connection object
+
+    kwargs = process_connect_string.process(args, kwargs, True)
+
+    try:  # connect to the database, using the connection information in kwargs
+        co.connect(kwargs)
+        return co
+    except Exception as e:
+        message = 'Error opening connection to "%s"' % co.connection_string
+        raise api.OperationalError(e, message)
+
+
+# so you could use something like:
+#   myConnection.paramstyle = 'named'
+# The programmer may also change the default.
+#   For example, if I were using django, I would say:
+#     import adodbapi as Database
+#     Database.adodbapi.paramstyle = 'format'
+
+# ------- other module level defaults --------
+defaultIsolationLevel = adc.adXactReadCommitted
+#  Set defaultIsolationLevel on module level before creating the connection.
+#   For example:
+#   import adodbapi, ado_consts
+#   adodbapi.adodbapi.defaultIsolationLevel=ado_consts.adXactBrowse"
+#
+#  Set defaultCursorLocation on module level before creating the connection.
+# It may be one of the "adUse..." consts.
+defaultCursorLocation = adc.adUseClient  # changed from adUseServer as of v 2.3.0
+
+dateconverter = api.pythonDateTimeConverter()  # default
+
+
+def format_parameters(ADOparameters, show_value=False):
+    """Format a collection of ADO Command Parameters.
+
+    Used by error reporting in _execute_command.
+    """
+    try:
+        if show_value:
+            desc = [
+                'Name: %s, Dir.: %s, Type: %s, Size: %s, Value: "%s", Precision: %s, NumericScale: %s'
+                % (
+                    p.Name,
+                    adc.directions[p.Direction],
+                    adc.adTypeNames.get(p.Type, str(p.Type) + " (unknown type)"),
+                    p.Size,
+                    p.Value,
+                    p.Precision,
+                    p.NumericScale,
+                )
+                for p in ADOparameters
+            ]
+        else:
+            desc = [
+                "Name: %s, Dir.: %s, Type: %s, Size: %s, Precision: %s, NumericScale: %s"
+                % (
+                    p.Name,
+                    adc.directions[p.Direction],
+                    adc.adTypeNames.get(p.Type, str(p.Type) + " (unknown type)"),
+                    p.Size,
+                    p.Precision,
+                    p.NumericScale,
+                )
+                for p in ADOparameters
+            ]
+        return "[" + "\n".join(desc) + "]"
+    except:
+        return "[]"
+
+
+def _configure_parameter(p, value, adotype, settings_known):
+    """Configure the given ADO Parameter 'p' with the Python 'value'."""
+
+    if adotype in api.adoBinaryTypes:
+        p.Size = len(value)
+        p.AppendChunk(value)
+
+    elif isinstance(value, StringTypes):  # v2.1 Jevon
+        L = len(value)
+        if adotype in api.adoStringTypes:  # v2.2.1 Cole
+            if settings_known:
+                L = min(L, p.Size)  # v2.1 Cole limit data to defined size
+            p.Value = value[:L]  # v2.1 Jevon & v2.1 Cole
+        else:
+            p.Value = value  # dont limit if db column is numeric
+        if L > 0:  # v2.1 Cole something does not like p.Size as Zero
+            p.Size = L  # v2.1 Jevon
+
+    elif isinstance(value, decimal.Decimal):
+        if api.onIronPython:
+            s = str(value)
+            p.Value = s
+            p.Size = len(s)
+        else:
+            p.Value = value
+        exponent = value.as_tuple()[2]
+        digit_count = len(value.as_tuple()[1])
+        p.Precision = digit_count
+        if exponent == 0:
+            p.NumericScale = 0
+        elif exponent < 0:
+            p.NumericScale = -exponent
+            if p.Precision < p.NumericScale:
+                p.Precision = p.NumericScale
+        else:  # exponent > 0:
+            p.NumericScale = 0
+            p.Precision = digit_count + exponent
+
+    elif type(value) in dateconverter.types:
+        if settings_known and adotype in api.adoDateTimeTypes:
+            p.Value = dateconverter.COMDate(value)
+        else:  # probably a string
+            # provide the date as a string in the format 'YYYY-MM-dd'
+            s = dateconverter.DateObjectToIsoFormatString(value)
+            p.Value = s
+            p.Size = len(s)
+
+    elif api.onIronPython and isinstance(value, longType):  # Iron Python Long
+        s = str(value)  # feature workaround for IPy 2.0
+        p.Value = s
+
+    elif adotype == adc.adEmpty:  # ADO will not let you specify a null column
+        p.Type = (
+            adc.adInteger
+        )  # so we will fake it to be an integer (just to have something)
+        p.Value = None  # and pass in a Null *value*
+
+        # For any other type, set the value and let pythoncom do the right thing.
+    else:
+        p.Value = value
+
+
+# # # # # ----- the Class that defines a connection ----- # # # # #
+class Connection(object):
+    # include connection attributes as class attributes required by api definition.
+    Warning = api.Warning
+    Error = api.Error
+    InterfaceError = api.InterfaceError
+    DataError = api.DataError
+    DatabaseError = api.DatabaseError
+    OperationalError = api.OperationalError
+    IntegrityError = api.IntegrityError
+    InternalError = api.InternalError
+    NotSupportedError = api.NotSupportedError
+    ProgrammingError = api.ProgrammingError
+    FetchFailedError = api.FetchFailedError  # (special for django)
+    # ...class attributes... (can be overridden by instance attributes)
+    verbose = api.verbose
+
+    @property
+    def dbapi(self):  # a proposed db-api version 3 extension.
+        "Return a reference to the DBAPI module for this Connection."
+        return api
+
+    def __init__(self):  # now define the instance attributes
+        self.connector = None
+        self.paramstyle = api.paramstyle
+        self.supportsTransactions = False
+        self.connection_string = ""
+        self.cursors = weakref.WeakValueDictionary()
+        self.dbms_name = ""
+        self.dbms_version = ""
+        self.errorhandler = None  # use the standard error handler for this instance
+        self.transaction_level = 0  # 0 == Not in a transaction, at the top level
+        self._autocommit = False
+
+    def connect(self, kwargs, connection_maker=make_COM_connecter):
+        if verbose > 9:
+            print("kwargs=", repr(kwargs))
+        try:
+            self.connection_string = (
+                kwargs["connection_string"] % kwargs
+            )  # insert keyword arguments
+        except Exception as e:
+            self._raiseConnectionError(
+                KeyError, "Python string format error in connection string->"
+            )
+        self.timeout = kwargs.get("timeout", 30)
+        self.mode = kwargs.get("mode", adc.adModeUnknown)
+        self.kwargs = kwargs
+        if verbose:
+            print('%s attempting: "%s"' % (version, self.connection_string))
+        self.connector = connection_maker()
+        self.connector.ConnectionTimeout = self.timeout
+        self.connector.ConnectionString = self.connection_string
+        self.connector.Mode = self.mode
+
+        try:
+            self.connector.Open()  # Open the ADO connection
+        except api.Error:
+            self._raiseConnectionError(
+                api.DatabaseError,
+                "ADO error trying to Open=%s" % self.connection_string,
+            )
+
+        try:  # Stefan Fuchs; support WINCCOLEDBProvider
+            if getIndexedValue(self.connector.Properties, "Transaction DDL").Value != 0:
+                self.supportsTransactions = True
+        except pywintypes.com_error:
+            pass  # Stefan Fuchs
+        self.dbms_name = getIndexedValue(self.connector.Properties, "DBMS Name").Value
+        try:  # Stefan Fuchs
+            self.dbms_version = getIndexedValue(
+                self.connector.Properties, "DBMS Version"
+            ).Value
+        except pywintypes.com_error:
+            pass  # Stefan Fuchs
+        self.connector.CursorLocation = defaultCursorLocation  # v2.1 Rose
+        if self.supportsTransactions:
+            self.connector.IsolationLevel = defaultIsolationLevel
+            self._autocommit = bool(kwargs.get("autocommit", False))
+            if not self._autocommit:
+                self.transaction_level = (
+                    self.connector.BeginTrans()
+                )  # Disables autocommit & inits transaction_level
+        else:
+            self._autocommit = True
+        if "paramstyle" in kwargs:
+            self.paramstyle = kwargs["paramstyle"]  # let setattr do the error checking
+        self.messages = []
+        if verbose:
+            print("adodbapi New connection at %X" % id(self))
+
+    def _raiseConnectionError(self, errorclass, errorvalue):
+        eh = self.errorhandler
+        if eh is None:
+            eh = api.standardErrorHandler
+        eh(self, None, errorclass, errorvalue)
+
+    def _closeAdoConnection(self):  # all v2.1 Rose
+        """close the underlying ADO Connection object,
+        rolling it back first if it supports transactions."""
+        if self.connector is None:
+            return
+        if not self._autocommit:
+            if self.transaction_level:
+                try:
+                    self.connector.RollbackTrans()
+                except:
+                    pass
+        self.connector.Close()
+        if verbose:
+            print("adodbapi Closed connection at %X" % id(self))
+
+    def close(self):
+        """Close the connection now (rather than whenever __del__ is called).
+
+        The connection will be unusable from this point forward;
+        an Error (or subclass) exception will be raised if any operation is attempted with the connection.
+        The same applies to all cursor objects trying to use the connection.
+        """
+        for crsr in list(self.cursors.values())[
+            :
+        ]:  # copy the list, then close each one
+            crsr.close(dont_tell_me=True)  # close without back-link clearing
+        self.messages = []
+        try:
+            self._closeAdoConnection()  # v2.1 Rose
+        except Exception as e:
+            self._raiseConnectionError(sys.exc_info()[0], sys.exc_info()[1])
+
+        self.connector = None  # v2.4.2.2 fix subtle timeout bug
+        # per M.Hammond: "I expect the benefits of uninitializing are probably fairly small,
+        #    so never uninitializing will probably not cause any problems."
+
+    def commit(self):
+        """Commit any pending transaction to the database.
+
+        Note that if the database supports an auto-commit feature,
+        this must be initially off. An interface method may be provided to turn it back on.
+        Database modules that do not support transactions should implement this method with void functionality.
+        """
+        self.messages = []
+        if not self.supportsTransactions:
+            return
+
+        try:
+            self.transaction_level = self.connector.CommitTrans()
+            if verbose > 1:
+                print("commit done on connection at %X" % id(self))
+            if not (
+                self._autocommit
+                or (self.connector.Attributes & adc.adXactAbortRetaining)
+            ):
+                # If attributes has adXactCommitRetaining it performs retaining commits that is,
+                # calling CommitTrans automatically starts a new transaction. Not all providers support this.
+                # If not, we will have to start a new transaction by this command:
+                self.transaction_level = self.connector.BeginTrans()
+        except Exception as e:
+            self._raiseConnectionError(api.ProgrammingError, e)
+
+    def _rollback(self):
+        """In case a database does provide transactions this method causes the the database to roll back to
+        the start of any pending transaction. Closing a connection without committing the changes first will
+        cause an implicit rollback to be performed.
+
+        If the database does not support the functionality required by the method, the interface should
+        throw an exception in case the method is used.
+        The preferred approach is to not implement the method and thus have Python generate
+        an AttributeError in case the method is requested. This allows the programmer to check for database
+        capabilities using the standard hasattr() function.
+
+        For some dynamically configured interfaces it may not be appropriate to require dynamically making
+        the method available. These interfaces should then raise a NotSupportedError to indicate the
+        non-ability to perform the roll back when the method is invoked.
+        """
+        self.messages = []
+        if (
+            self.transaction_level
+        ):  # trying to roll back with no open transaction causes an error
+            try:
+                self.transaction_level = self.connector.RollbackTrans()
+                if verbose > 1:
+                    print("rollback done on connection at %X" % id(self))
+                if not self._autocommit and not (
+                    self.connector.Attributes & adc.adXactAbortRetaining
+                ):
+                    # If attributes has adXactAbortRetaining it performs retaining aborts that is,
+                    # calling RollbackTrans automatically starts a new transaction. Not all providers support this.
+                    # If not, we will have to start a new transaction by this command:
+                    if (
+                        not self.transaction_level
+                    ):  # if self.transaction_level == 0 or self.transaction_level is None:
+                        self.transaction_level = self.connector.BeginTrans()
+            except Exception as e:
+                self._raiseConnectionError(api.ProgrammingError, e)
+
+    def __setattr__(self, name, value):
+        if name == "autocommit":  # extension: allow user to turn autocommit on or off
+            if self.supportsTransactions:
+                object.__setattr__(self, "_autocommit", bool(value))
+                try:
+                    self._rollback()  # must clear any outstanding transactions
+                except:
+                    pass
+            return
+        elif name == "paramstyle":
+            if value not in api.accepted_paramstyles:
+                self._raiseConnectionError(
+                    api.NotSupportedError,
+                    'paramstyle="%s" not in:%s'
+                    % (value, repr(api.accepted_paramstyles)),
+                )
+        elif name == "variantConversions":
+            value = copy.copy(
+                value
+            )  # make a new copy -- no changes in the default, please
+        object.__setattr__(self, name, value)
+
+    def __getattr__(self, item):
+        if (
+            item == "rollback"
+        ):  # the rollback method only appears if the database supports transactions
+            if self.supportsTransactions:
+                return (
+                    self._rollback
+                )  # return the rollback method so the caller can execute it.
+            else:
+                raise AttributeError("this data provider does not support Rollback")
+        elif item == "autocommit":
+            return self._autocommit
+        else:
+            raise AttributeError(
+                'no such attribute in ADO connection object as="%s"' % item
+            )
+
+    def cursor(self):
+        "Return a new Cursor Object using the connection."
+        self.messages = []
+        c = Cursor(self)
+        return c
+
+    def _i_am_here(self, crsr):
+        "message from a new cursor proclaiming its existence"
+        oid = id(crsr)
+        self.cursors[oid] = crsr
+
+    def _i_am_closing(self, crsr):
+        "message from a cursor giving connection a chance to clean up"
+        try:
+            del self.cursors[id(crsr)]
+        except:
+            pass
+
+    def printADOerrors(self):
+        j = self.connector.Errors.Count
+        if j:
+            print("ADO Errors:(%i)" % j)
+        for e in self.connector.Errors:
+            print("Description: %s" % e.Description)
+            print("Error: %s %s " % (e.Number, adc.adoErrors.get(e.Number, "unknown")))
+            if e.Number == adc.ado_error_TIMEOUT:
+                print(
+                    "Timeout Error: Try using adodbpi.connect(constr,timeout=Nseconds)"
+                )
+            print("Source: %s" % e.Source)
+            print("NativeError: %s" % e.NativeError)
+            print("SQL State: %s" % e.SQLState)
+
+    def _suggest_error_class(self):
+        """Introspect the current ADO Errors and determine an appropriate error class.
+
+        Error.SQLState is a SQL-defined error condition, per the SQL specification:
+        http://www.contrib.andrew.cmu.edu/~shadow/sql/sql1992.txt
+
+        The 23000 class of errors are integrity errors.
+        Error 40002 is a transactional integrity error.
+        """
+        if self.connector is not None:
+            for e in self.connector.Errors:
+                state = str(e.SQLState)
+                if state.startswith("23") or state == "40002":
+                    return api.IntegrityError
+        return api.DatabaseError
+
+    def __del__(self):
+        try:
+            self._closeAdoConnection()  # v2.1 Rose
+        except:
+            pass
+        self.connector = None
+
+    def __enter__(self):  # Connections are context managers
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        if exc_type:
+            self._rollback()  # automatic rollback on errors
+        else:
+            self.commit()
+
+    def get_table_names(self):
+        schema = self.connector.OpenSchema(20)  # constant = adSchemaTables
+
+        tables = []
+        while not schema.EOF:
+            name = getIndexedValue(schema.Fields, "TABLE_NAME").Value
+            tables.append(name)
+            schema.MoveNext()
+        del schema
+        return tables
+
+
+# # # # # ----- the Class that defines a cursor ----- # # # # #
+class Cursor(object):
+    ## ** api required attributes:
+    ## description...
+    ##    This read-only attribute is a sequence of 7-item sequences.
+    ##    Each of these sequences contains information describing one result column:
+    ##        (name, type_code, display_size, internal_size, precision, scale, null_ok).
+    ##    This attribute will be None for operations that do not return rows or if the
+    ##    cursor has not had an operation invoked via the executeXXX() method yet.
+    ##    The type_code can be interpreted by comparing it to the Type Objects specified in the section below.
+    ## rowcount...
+    ##    This read-only attribute specifies the number of rows that the last executeXXX() produced
+    ##    (for DQL statements like select) or affected (for DML statements like update or insert).
+    ##    The attribute is -1 in case no executeXXX() has been performed on the cursor or
+    ##    the rowcount of the last operation is not determinable by the interface.[7]
+    ## arraysize...
+    ##    This read/write attribute specifies the number of rows to fetch at a time with fetchmany().
+    ##    It defaults to 1 meaning to fetch a single row at a time.
+    ##    Implementations must observe this value with respect to the fetchmany() method,
+    ##    but are free to interact with the database a single row at a time.
+    ##    It may also be used in the implementation of executemany().
+    ## ** extension attributes:
+    ## paramstyle...
+    ##   allows the programmer to override the connection's default paramstyle
+    ## errorhandler...
+    ##   allows the programmer to override the connection's default error handler
+
+    def __init__(self, connection):
+        self.command = None
+        self._ado_prepared = False
+        self.messages = []
+        self.connection = connection
+        self.paramstyle = connection.paramstyle  # used for overriding the paramstyle
+        self._parameter_names = []
+        self.recordset_is_remote = False
+        self.rs = None  # the ADO recordset for this cursor
+        self.converters = []  # conversion function for each column
+        self.columnNames = {}  # names of columns {lowercase name : number,...}
+        self.numberOfColumns = 0
+        self._description = None
+        self.rowcount = -1
+        self.errorhandler = connection.errorhandler
+        self.arraysize = 1
+        connection._i_am_here(self)
+        if verbose:
+            print(
+                "%s New cursor at %X on conn %X"
+                % (version, id(self), id(self.connection))
+            )
+
+    def __iter__(self):  # [2.1 Zamarev]
+        return iter(self.fetchone, None)  # [2.1 Zamarev]
+
+    def prepare(self, operation):
+        self.command = operation
+        self._description = None
+        self._ado_prepared = "setup"
+
+    def __next__(self):
+        r = self.fetchone()
+        if r:
+            return r
+        raise StopIteration
+
+    def __enter__(self):
+        "Allow database cursors to be used with context managers."
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        "Allow database cursors to be used with context managers."
+        self.close()
+
+    def _raiseCursorError(self, errorclass, errorvalue):
+        eh = self.errorhandler
+        if eh is None:
+            eh = api.standardErrorHandler
+        eh(self.connection, self, errorclass, errorvalue)
+
+    def build_column_info(self, recordset):
+        self.converters = []  # convertion function for each column
+        self.columnNames = {}  # names of columns {lowercase name : number,...}
+        self._description = None
+
+        # if EOF and BOF are true at the same time, there are no records in the recordset
+        if (recordset is None) or (recordset.State == adc.adStateClosed):
+            self.rs = None
+            self.numberOfColumns = 0
+            return
+        self.rs = recordset  # v2.1.1 bkline
+        self.recordset_format = api.RS_ARRAY if api.onIronPython else api.RS_WIN_32
+        self.numberOfColumns = recordset.Fields.Count
+        try:
+            varCon = self.connection.variantConversions
+        except AttributeError:
+            varCon = api.variantConversions
+        for i in range(self.numberOfColumns):
+            f = getIndexedValue(self.rs.Fields, i)
+            try:
+                self.converters.append(
+                    varCon[f.Type]
+                )  # conversion function for this column
+            except KeyError:
+                self._raiseCursorError(
+                    api.InternalError, "Data column of Unknown ADO type=%s" % f.Type
+                )
+            self.columnNames[f.Name.lower()] = i  # columnNames lookup
+
+    def _makeDescriptionFromRS(self):
+        # Abort if closed or no recordset.
+        if self.rs is None:
+            self._description = None
+            return
+        desc = []
+        for i in range(self.numberOfColumns):
+            f = getIndexedValue(self.rs.Fields, i)
+            if self.rs.EOF or self.rs.BOF:
+                display_size = None
+            else:
+                display_size = (
+                    f.ActualSize
+                )  # TODO: Is this the correct defintion according to the DB API 2 Spec ?
+            null_ok = bool(f.Attributes & adc.adFldMayBeNull)  # v2.1 Cole
+            desc.append(
+                (
+                    f.Name,
+                    f.Type,
+                    display_size,
+                    f.DefinedSize,
+                    f.Precision,
+                    f.NumericScale,
+                    null_ok,
+                )
+            )
+        self._description = desc
+
+    def get_description(self):
+        if not self._description:
+            self._makeDescriptionFromRS()
+        return self._description
+
+    def __getattr__(self, item):
+        if item == "description":
+            return self.get_description()
+        object.__getattribute__(
+            self, item
+        )  # may get here on Remote attribute calls for existing attributes
+
+    def format_description(self, d):
+        """Format db_api description tuple for printing."""
+        if self.description is None:
+            self._makeDescriptionFromRS()
+        if isinstance(d, int):
+            d = self.description[d]
+        desc = (
+            "Name= %s, Type= %s, DispSize= %s, IntSize= %s, Precision= %s, Scale= %s NullOK=%s"
+            % (
+                d[0],
+                adc.adTypeNames.get(d[1], str(d[1]) + " (unknown type)"),
+                d[2],
+                d[3],
+                d[4],
+                d[5],
+                d[6],
+            )
+        )
+        return desc
+
+    def close(self, dont_tell_me=False):
+        """Close the cursor now (rather than whenever __del__ is called).
+        The cursor will be unusable from this point forward; an Error (or subclass)
+        exception will be raised if any operation is attempted with the cursor.
+        """
+        if self.connection is None:
+            return
+        self.messages = []
+        if (
+            self.rs and self.rs.State != adc.adStateClosed
+        ):  # rs exists and is open      #v2.1 Rose
+            self.rs.Close()  # v2.1 Rose
+            self.rs = None  # let go of the recordset so ADO will let it be disposed #v2.1 Rose
+        if not dont_tell_me:
+            self.connection._i_am_closing(
+                self
+            )  # take me off the connection's cursors list
+        self.connection = (
+            None  # this will make all future method calls on me throw an exception
+        )
+        if verbose:
+            print("adodbapi Closed cursor at %X" % id(self))
+
+    def __del__(self):
+        try:
+            self.close()
+        except:
+            pass
+
+    def _new_command(self, command_type=adc.adCmdText):
+        self.cmd = None
+        self.messages = []
+
+        if self.connection is None:
+            self._raiseCursorError(api.InterfaceError, None)
+            return
+        try:
+            self.cmd = Dispatch("ADODB.Command")
+            self.cmd.ActiveConnection = self.connection.connector
+            self.cmd.CommandTimeout = self.connection.timeout
+            self.cmd.CommandType = command_type
+            self.cmd.CommandText = self.commandText
+            self.cmd.Prepared = bool(self._ado_prepared)
+        except:
+            self._raiseCursorError(
+                api.DatabaseError,
+                'Error creating new ADODB.Command object for "%s"'
+                % repr(self.commandText),
+            )
+
+    def _execute_command(self):
+        # Stored procedures may have an integer return value
+        self.return_value = None
+        recordset = None
+        count = -1  # default value
+        if verbose:
+            print('Executing command="%s"' % self.commandText)
+        try:
+            # ----- the actual SQL is executed here ---
+            if api.onIronPython:
+                ra = Reference[int]()
+                recordset = self.cmd.Execute(ra)
+                count = ra.Value
+            else:  # pywin32
+                recordset, count = self.cmd.Execute()
+            # ----- ------------------------------- ---
+        except Exception as e:
+            _message = ""
+            if hasattr(e, "args"):
+                _message += str(e.args) + "\n"
+            _message += "Command:\n%s\nParameters:\n%s" % (
+                self.commandText,
+                format_parameters(self.cmd.Parameters, True),
+            )
+            klass = self.connection._suggest_error_class()
+            self._raiseCursorError(klass, _message)
+        try:
+            self.rowcount = recordset.RecordCount
+        except:
+            self.rowcount = count
+        self.build_column_info(recordset)
+
+        # The ADO documentation hints that obtaining the recordcount may be timeconsuming
+        #   "If the Recordset object does not support approximate positioning, this property
+        #    may be a significant drain on resources # [ekelund]
+        # Therefore, COM will not return rowcount for server-side cursors. [Cole]
+        # Client-side cursors (the default since v2.8) will force a static
+        # cursor, and rowcount will then be set accurately [Cole]
+
+    def get_rowcount(self):
+        return self.rowcount
+
+    def get_returned_parameters(self):
+        """with some providers, returned parameters and the .return_value are not available until
+        after the last recordset has been read.  In that case, you must coll nextset() until it
+        returns None, then call this method to get your returned information."""
+
+        retLst = (
+            []
+        )  # store procedures may return altered parameters, including an added "return value" item
+        for p in tuple(self.cmd.Parameters):
+            if verbose > 2:
+                print(
+                    'Returned=Name: %s, Dir.: %s, Type: %s, Size: %s, Value: "%s",'
+                    " Precision: %s, NumericScale: %s"
+                    % (
+                        p.Name,
+                        adc.directions[p.Direction],
+                        adc.adTypeNames.get(p.Type, str(p.Type) + " (unknown type)"),
+                        p.Size,
+                        p.Value,
+                        p.Precision,
+                        p.NumericScale,
+                    )
+                )
+            pyObject = api.convert_to_python(p.Value, api.variantConversions[p.Type])
+            if p.Direction == adc.adParamReturnValue:
+                self.returnValue = (
+                    pyObject  # also load the undocumented attribute (Vernon's Error!)
+                )
+                self.return_value = pyObject
+            else:
+                retLst.append(pyObject)
+        return retLst  # return the parameter list to the caller
+
+    def callproc(self, procname, parameters=None):
+        """Call a stored database procedure with the given name.
+        The sequence of parameters must contain one entry for each
+        argument that the sproc expects. The result of the
+        call is returned as modified copy of the input
+        sequence.  Input parameters are left untouched, output and
+        input/output parameters replaced with possibly new values.
+
+        The sproc may also provide a result set as output,
+        which is available through the standard .fetch*() methods.
+        Extension: A "return_value" property may be set on the
+        cursor if the sproc defines an integer return value.
+        """
+        self._parameter_names = []
+        self.commandText = procname
+        self._new_command(command_type=adc.adCmdStoredProc)
+        self._buildADOparameterList(parameters, sproc=True)
+        if verbose > 2:
+            print(
+                "Calling Stored Proc with Params=",
+                format_parameters(self.cmd.Parameters, True),
+            )
+        self._execute_command()
+        return self.get_returned_parameters()
+
+    def _reformat_operation(self, operation, parameters):
+        if self.paramstyle in ("format", "pyformat"):  # convert %s to ?
+            operation, self._parameter_names = api.changeFormatToQmark(operation)
+        elif self.paramstyle == "named" or (
+            self.paramstyle == "dynamic" and isinstance(parameters, Mapping)
+        ):
+            operation, self._parameter_names = api.changeNamedToQmark(
+                operation
+            )  # convert :name to ?
+        return operation
+
+    def _buildADOparameterList(self, parameters, sproc=False):
+        self.parameters = parameters
+        if parameters is None:
+            parameters = []
+
+        # Note: ADO does not preserve the parameter list, even if "Prepared" is True, so we must build every time.
+        parameters_known = False
+        if sproc:  # needed only if we are calling a stored procedure
+            try:  # attempt to use ADO's parameter list
+                self.cmd.Parameters.Refresh()
+                if verbose > 2:
+                    print(
+                        "ADO detected Params=",
+                        format_parameters(self.cmd.Parameters, True),
+                    )
+                    print("Program Parameters=", repr(parameters))
+                parameters_known = True
+            except api.Error:
+                if verbose:
+                    print("ADO Parameter Refresh failed")
+                pass
+            else:
+                if len(parameters) != self.cmd.Parameters.Count - 1:
+                    raise api.ProgrammingError(
+                        "You must supply %d parameters for this stored procedure"
+                        % (self.cmd.Parameters.Count - 1)
+                    )
+        if sproc or parameters != []:
+            i = 0
+            if parameters_known:  # use ado parameter list
+                if self._parameter_names:  # named parameters
+                    for i, pm_name in enumerate(self._parameter_names):
+                        p = getIndexedValue(self.cmd.Parameters, i)
+                        try:
+                            _configure_parameter(
+                                p, parameters[pm_name], p.Type, parameters_known
+                            )
+                        except Exception as e:
+                            _message = (
+                                "Error Converting Parameter %s: %s, %s <- %s\n"
+                                % (
+                                    p.Name,
+                                    adc.ado_type_name(p.Type),
+                                    p.Value,
+                                    repr(parameters[pm_name]),
+                                )
+                            )
+                            self._raiseCursorError(
+                                api.DataError, _message + "->" + repr(e.args)
+                            )
+                else:  # regular sequence of parameters
+                    for value in parameters:
+                        p = getIndexedValue(self.cmd.Parameters, i)
+                        if (
+                            p.Direction == adc.adParamReturnValue
+                        ):  # this is an extra parameter added by ADO
+                            i += 1  # skip the extra
+                            p = getIndexedValue(self.cmd.Parameters, i)
+                        try:
+                            _configure_parameter(p, value, p.Type, parameters_known)
+                        except Exception as e:
+                            _message = (
+                                "Error Converting Parameter %s: %s, %s <- %s\n"
+                                % (
+                                    p.Name,
+                                    adc.ado_type_name(p.Type),
+                                    p.Value,
+                                    repr(value),
+                                )
+                            )
+                            self._raiseCursorError(
+                                api.DataError, _message + "->" + repr(e.args)
+                            )
+                        i += 1
+            else:  # -- build own parameter list
+                if (
+                    self._parameter_names
+                ):  # we expect a dictionary of parameters, this is the list of expected names
+                    for parm_name in self._parameter_names:
+                        elem = parameters[parm_name]
+                        adotype = api.pyTypeToADOType(elem)
+                        p = self.cmd.CreateParameter(
+                            parm_name, adotype, adc.adParamInput
+                        )
+                        _configure_parameter(p, elem, adotype, parameters_known)
+                        try:
+                            self.cmd.Parameters.Append(p)
+                        except Exception as e:
+                            _message = "Error Building Parameter %s: %s, %s <- %s\n" % (
+                                p.Name,
+                                adc.ado_type_name(p.Type),
+                                p.Value,
+                                repr(elem),
+                            )
+                            self._raiseCursorError(
+                                api.DataError, _message + "->" + repr(e.args)
+                            )
+                else:  # expecting the usual sequence of parameters
+                    if sproc:
+                        p = self.cmd.CreateParameter(
+                            "@RETURN_VALUE", adc.adInteger, adc.adParamReturnValue
+                        )
+                        self.cmd.Parameters.Append(p)
+
+                    for elem in parameters:
+                        name = "p%i" % i
+                        adotype = api.pyTypeToADOType(elem)
+                        p = self.cmd.CreateParameter(
+                            name, adotype, adc.adParamInput
+                        )  # Name, Type, Direction, Size, Value
+                        _configure_parameter(p, elem, adotype, parameters_known)
+                        try:
+                            self.cmd.Parameters.Append(p)
+                        except Exception as e:
+                            _message = "Error Building Parameter %s: %s, %s <- %s\n" % (
+                                p.Name,
+                                adc.ado_type_name(p.Type),
+                                p.Value,
+                                repr(elem),
+                            )
+                            self._raiseCursorError(
+                                api.DataError, _message + "->" + repr(e.args)
+                            )
+                        i += 1
+                if self._ado_prepared == "setup":
+                    self._ado_prepared = (
+                        True  # parameters will be "known" by ADO next loop
+                    )
+
+    def execute(self, operation, parameters=None):
+        """Prepare and execute a database operation (query or command).
+
+        Parameters may be provided as sequence or mapping and will be bound to variables in the operation.
+        Variables are specified in a database-specific notation
+        (see the module's paramstyle attribute for details). [5]
+        A reference to the operation will be retained by the cursor.
+        If the same operation object is passed in again, then the cursor
+        can optimize its behavior. This is most effective for algorithms
+        where the same operation is used, but different parameters are bound to it (many times).
+
+        For maximum efficiency when reusing an operation, it is best to use
+        the setinputsizes() method to specify the parameter types and sizes ahead of time.
+        It is legal for a parameter to not match the predefined information;
+        the implementation should compensate, possibly with a loss of efficiency.
+
+        The parameters may also be specified as list of tuples to e.g. insert multiple rows in
+        a single operation, but this kind of usage is depreciated: executemany() should be used instead.
+
+        Return value is not defined.
+
+        [5] The module will use the __getitem__ method of the parameters object to map either positions
+        (integers) or names (strings) to parameter values. This allows for both sequences and mappings
+        to be used as input.
+        The term "bound" refers to the process of binding an input value to a database execution buffer.
+        In practical terms, this means that the input value is directly used as a value in the operation.
+        The client should not be required to "escape" the value so that it can be used -- the value
+        should be equal to the actual database value."""
+        if (
+            self.command is not operation
+            or self._ado_prepared == "setup"
+            or not hasattr(self, "commandText")
+        ):
+            if self.command is not operation:
+                self._ado_prepared = False
+                self.command = operation
+            self._parameter_names = []
+            self.commandText = (
+                operation
+                if (self.paramstyle == "qmark" or not parameters)
+                else self._reformat_operation(operation, parameters)
+            )
+        self._new_command()
+        self._buildADOparameterList(parameters)
+        if verbose > 3:
+            print("Params=", format_parameters(self.cmd.Parameters, True))
+        self._execute_command()
+
+    def executemany(self, operation, seq_of_parameters):
+        """Prepare a database operation (query or command)
+        and then execute it against all parameter sequences or mappings found in the sequence seq_of_parameters.
+
+            Return values are not defined.
+        """
+        self.messages = list()
+        total_recordcount = 0
+
+        self.prepare(operation)
+        for params in seq_of_parameters:
+            self.execute(self.command, params)
+            if self.rowcount == -1:
+                total_recordcount = -1
+            if total_recordcount != -1:
+                total_recordcount += self.rowcount
+        self.rowcount = total_recordcount
+
+    def _fetch(self, limit=None):
+        """Fetch rows from the current recordset.
+
+        limit -- Number of rows to fetch, or None (default) to fetch all rows.
+        """
+        if self.connection is None or self.rs is None:
+            self._raiseCursorError(
+                api.FetchFailedError, "fetch() on closed connection or empty query set"
+            )
+            return
+
+        if self.rs.State == adc.adStateClosed or self.rs.BOF or self.rs.EOF:
+            return list()
+        if limit:  # limit number of rows retrieved
+            ado_results = self.rs.GetRows(limit)
+        else:  # get all rows
+            ado_results = self.rs.GetRows()
+        if (
+            self.recordset_format == api.RS_ARRAY
+        ):  # result of GetRows is a two-dimension array
+            length = (
+                len(ado_results) // self.numberOfColumns
+            )  # length of first dimension
+        else:  # pywin32
+            length = len(ado_results[0])  # result of GetRows is tuples in a tuple
+        fetchObject = api.SQLrows(
+            ado_results, length, self
+        )  # new object to hold the results of the fetch
+        return fetchObject
+
+    def fetchone(self):
+        """Fetch the next row of a query result set, returning a single sequence,
+        or None when no more data is available.
+
+        An Error (or subclass) exception is raised if the previous call to executeXXX()
+        did not produce any result set or no call was issued yet.
+        """
+        self.messages = []
+        result = self._fetch(1)
+        if result:  # return record (not list of records)
+            return result[0]
+        return None
+
+    def fetchmany(self, size=None):
+        """Fetch the next set of rows of a query result, returning a list of tuples. An empty sequence is returned when no more rows are available.
+
+        The number of rows to fetch per call is specified by the parameter.
+        If it is not given, the cursor's arraysize determines the number of rows to be fetched.
+        The method should try to fetch as many rows as indicated by the size parameter.
+        If this is not possible due to the specified number of rows not being available,
+        fewer rows may be returned.
+
+        An Error (or subclass) exception is raised if the previous call to executeXXX()
+        did not produce any result set or no call was issued yet.
+
+        Note there are performance considerations involved with the size parameter.
+        For optimal performance, it is usually best to use the arraysize attribute.
+        If the size parameter is used, then it is best for it to retain the same value from
+        one fetchmany() call to the next.
+        """
+        self.messages = []
+        if size is None:
+            size = self.arraysize
+        return self._fetch(size)
+
+    def fetchall(self):
+        """Fetch all (remaining) rows of a query result, returning them as a sequence of sequences (e.g. a list of tuples).
+
+        Note that the cursor's arraysize attribute
+        can affect the performance of this operation.
+        An Error (or subclass) exception is raised if the previous call to executeXXX()
+        did not produce any result set or no call was issued yet.
+        """
+        self.messages = []
+        return self._fetch()
+
+    def nextset(self):
+        """Skip to the next available recordset, discarding any remaining rows from the current recordset.
+
+        If there are no more sets, the method returns None. Otherwise, it returns a true
+        value and subsequent calls to the fetch methods will return rows from the next result set.
+
+        An Error (or subclass) exception is raised if the previous call to executeXXX()
+        did not produce any result set or no call was issued yet.
+        """
+        self.messages = []
+        if self.connection is None or self.rs is None:
+            self._raiseCursorError(
+                api.OperationalError,
+                ("nextset() on closed connection or empty query set"),
+            )
+            return None
+
+        if api.onIronPython:
+            try:
+                recordset = self.rs.NextRecordset()
+            except TypeError:
+                recordset = None
+            except api.Error as exc:
+                self._raiseCursorError(api.NotSupportedError, exc.args)
+        else:  # pywin32
+            try:  # [begin 2.1 ekelund]
+                rsTuple = self.rs.NextRecordset()  #
+            except pywintypes.com_error as exc:  # return appropriate error
+                self._raiseCursorError(
+                    api.NotSupportedError, exc.args
+                )  # [end 2.1 ekelund]
+            recordset = rsTuple[0]
+        if recordset is None:
+            return None
+        self.build_column_info(recordset)
+        return True
+
+    def setinputsizes(self, sizes):
+        pass
+
+    def setoutputsize(self, size, column=None):
+        pass
+
+    def _last_query(self):  # let the programmer see what query we actually used
+        try:
+            if self.parameters == None:
+                ret = self.commandText
+            else:
+                ret = "%s,parameters=%s" % (self.commandText, repr(self.parameters))
+        except:
+            ret = None
+        return ret
+
+    query = property(_last_query, None, None, "returns the last query executed")
+
+
+if __name__ == "__main__":
+    raise api.ProgrammingError(version + " cannot be run as a main program.")
diff --git a/lib/adodbapi/apibase.py b/lib/adodbapi/apibase.py
new file mode 100644
index 00000000..a56cd4b6
--- /dev/null
+++ b/lib/adodbapi/apibase.py
@@ -0,0 +1,794 @@
+"""adodbapi.apibase - A python DB API 2.0 (PEP 249) interface to Microsoft ADO
+
+Copyright (C) 2002 Henrik Ekelund, version 2.1 by Vernon Cole
+* http://sourceforge.net/projects/pywin32
+* http://sourceforge.net/projects/adodbapi
+"""
+
+import datetime
+import decimal
+import numbers
+import sys
+import time
+
+# noinspection PyUnresolvedReferences
+from . import ado_consts as adc
+
+verbose = False  # debugging flag
+
+onIronPython = sys.platform == "cli"
+if onIronPython:  # we need type definitions for odd data we may need to convert
+    # noinspection PyUnresolvedReferences
+    from System import DateTime, DBNull
+
+    NullTypes = (type(None), DBNull)
+else:
+    DateTime = type(NotImplemented)  # should never be seen on win32
+    NullTypes = type(None)
+
+# --- define objects to smooth out Python3 <-> Python 2.x differences
+unicodeType = str
+longType = int
+StringTypes = str
+makeByteBuffer = bytes
+memoryViewType = memoryview
+_BaseException = Exception
+
+try:  # jdhardy -- handle bytes under IronPython & Py3
+    bytes
+except NameError:
+    bytes = str  # define it for old Pythons
+
+
+# ------- Error handlers ------
+def standardErrorHandler(connection, cursor, errorclass, errorvalue):
+    err = (errorclass, errorvalue)
+    try:
+        connection.messages.append(err)
+    except:
+        pass
+    if cursor is not None:
+        try:
+            cursor.messages.append(err)
+        except:
+            pass
+    raise errorclass(errorvalue)
+
+
+# Note: _BaseException is defined differently between Python 2.x and 3.x
+class Error(_BaseException):
+    pass  # Exception that is the base class of all other error
+    # exceptions. You can use this to catch all errors with one
+    # single 'except' statement. Warnings are not considered
+    # errors and thus should not use this class as base. It must
+    # be a subclass of the Python StandardError (defined in the
+    # module exceptions).
+
+
+class Warning(_BaseException):
+    pass
+
+
+class InterfaceError(Error):
+    pass
+
+
+class DatabaseError(Error):
+    pass
+
+
+class InternalError(DatabaseError):
+    pass
+
+
+class OperationalError(DatabaseError):
+    pass
+
+
+class ProgrammingError(DatabaseError):
+    pass
+
+
+class IntegrityError(DatabaseError):
+    pass
+
+
+class DataError(DatabaseError):
+    pass
+
+
+class NotSupportedError(DatabaseError):
+    pass
+
+
+class FetchFailedError(OperationalError):
+    """
+    Error is used by RawStoredProcedureQuerySet to determine when a fetch
+    failed due to a connection being closed or there is no record set
+    returned. (Non-standard, added especially for django)
+    """
+
+    pass
+
+
+# # # # # ----- Type Objects and Constructors ----- # # # # #
+# Many databases need to have the input in a particular format for binding to an operation's input parameters.
+# For example, if an input is destined for a DATE column, then it must be bound to the database in a particular
+# string format. Similar problems exist for "Row ID" columns or large binary items (e.g. blobs or RAW columns).
+# This presents problems for Python since the parameters to the executeXXX() method are untyped.
+# When the database module sees a Python string object, it doesn't know if it should be bound as a simple CHAR
+# column, as a raw BINARY item, or as a DATE.
+#
+# To overcome this problem, a module must provide the constructors defined below to create objects that can
+# hold special values. When passed to the cursor methods, the module can then detect the proper type of
+# the input parameter and bind it accordingly.
+
+# A Cursor Object's description attribute returns information about each of the result columns of a query.
+# The type_code must compare equal to one of Type Objects defined below. Type Objects may be equal to more than
+# one type code (e.g. DATETIME could be equal to the type codes for date, time and timestamp columns;
+# see the Implementation Hints below for details).
+
+# SQL NULL values are represented by the Python None singleton on input and output.
+
+# Note: Usage of Unix ticks for database interfacing can cause troubles because of the limited date range they cover.
+
+
+# def Date(year,month,day):
+#     "This function constructs an object holding a date value. "
+#     return dateconverter.date(year,month,day)  #dateconverter.Date(year,month,day)
+#
+# def Time(hour,minute,second):
+#     "This function constructs an object holding a time value. "
+#     return dateconverter.time(hour, minute, second) # dateconverter.Time(hour,minute,second)
+#
+# def Timestamp(year,month,day,hour,minute,second):
+#     "This function constructs an object holding a time stamp value. "
+#     return dateconverter.datetime(year,month,day,hour,minute,second)
+#
+# def DateFromTicks(ticks):
+#     """This function constructs an object holding a date value from the given ticks value
+#     (number of seconds since the epoch; see the documentation of the standard Python time module for details). """
+#     return Date(*time.gmtime(ticks)[:3])
+#
+# def TimeFromTicks(ticks):
+#     """This function constructs an object holding a time value from the given ticks value
+#     (number of seconds since the epoch; see the documentation of the standard Python time module for details). """
+#     return Time(*time.gmtime(ticks)[3:6])
+#
+# def TimestampFromTicks(ticks):
+#     """This function constructs an object holding a time stamp value from the given
+#     ticks value (number of seconds since the epoch;
+#     see the documentation of the standard Python time module for details). """
+#     return Timestamp(*time.gmtime(ticks)[:6])
+#
+# def Binary(aString):
+#     """This function constructs an object capable of holding a binary (long) string value. """
+#     b = makeByteBuffer(aString)
+#     return b
+# -----     Time converters ----------------------------------------------
+class TimeConverter(object):  # this is a generic time converter skeleton
+    def __init__(self):  # the details will be filled in by instances
+        self._ordinal_1899_12_31 = datetime.date(1899, 12, 31).toordinal() - 1
+        # Use cls.types to compare if an input parameter is a datetime
+        self.types = {
+            type(self.Date(2000, 1, 1)),
+            type(self.Time(12, 1, 1)),
+            type(self.Timestamp(2000, 1, 1, 12, 1, 1)),
+            datetime.datetime,
+            datetime.time,
+            datetime.date,
+        }
+
+    def COMDate(self, obj):
+        """Returns a ComDate from a date-time"""
+        try:  # most likely a datetime
+            tt = obj.timetuple()
+
+            try:
+                ms = obj.microsecond
+            except:
+                ms = 0
+            return self.ComDateFromTuple(tt, ms)
+        except:  # might be a tuple
+            try:
+                return self.ComDateFromTuple(obj)
+            except:  # try an mxdate
+                try:
+                    return obj.COMDate()
+                except:
+                    raise ValueError('Cannot convert "%s" to COMdate.' % repr(obj))
+
+    def ComDateFromTuple(self, t, microseconds=0):
+        d = datetime.date(t[0], t[1], t[2])
+        integerPart = d.toordinal() - self._ordinal_1899_12_31
+        ms = (t[3] * 3600 + t[4] * 60 + t[5]) * 1000000 + microseconds
+        fractPart = float(ms) / 86400000000.0
+        return integerPart + fractPart
+
+    def DateObjectFromCOMDate(self, comDate):
+        "Returns an object of the wanted type from a ComDate"
+        raise NotImplementedError  # "Abstract class"
+
+    def Date(self, year, month, day):
+        "This function constructs an object holding a date value."
+        raise NotImplementedError  # "Abstract class"
+
+    def Time(self, hour, minute, second):
+        "This function constructs an object holding a time value."
+        raise NotImplementedError  # "Abstract class"
+
+    def Timestamp(self, year, month, day, hour, minute, second):
+        "This function constructs an object holding a time stamp value."
+        raise NotImplementedError  # "Abstract class"
+        # all purpose date to ISO format converter
+
+    def DateObjectToIsoFormatString(self, obj):
+        "This function should return a string in the format 'YYYY-MM-dd HH:MM:SS:ms' (ms optional)"
+        try:  # most likely, a datetime.datetime
+            s = obj.isoformat(" ")
+        except (TypeError, AttributeError):
+            if isinstance(obj, datetime.date):
+                s = obj.isoformat() + " 00:00:00"  # return exact midnight
+            else:
+                try:  # maybe it has a strftime method, like mx
+                    s = obj.strftime("%Y-%m-%d %H:%M:%S")
+                except AttributeError:
+                    try:  # but may be time.struct_time
+                        s = time.strftime("%Y-%m-%d %H:%M:%S", obj)
+                    except:
+                        raise ValueError('Cannot convert "%s" to isoformat' % repr(obj))
+        return s
+
+
+# -- Optional: if mx extensions are installed you may use mxDateTime ----
+try:
+    import mx.DateTime
+
+    mxDateTime = True
+except:
+    mxDateTime = False
+if mxDateTime:
+
+    class mxDateTimeConverter(TimeConverter):  # used optionally if installed
+        def __init__(self):
+            TimeConverter.__init__(self)
+            self.types.add(type(mx.DateTime))
+
+        def DateObjectFromCOMDate(self, comDate):
+            return mx.DateTime.DateTimeFromCOMDate(comDate)
+
+        def Date(self, year, month, day):
+            return mx.DateTime.Date(year, month, day)
+
+        def Time(self, hour, minute, second):
+            return mx.DateTime.Time(hour, minute, second)
+
+        def Timestamp(self, year, month, day, hour, minute, second):
+            return mx.DateTime.Timestamp(year, month, day, hour, minute, second)
+
+else:
+
+    class mxDateTimeConverter(TimeConverter):
+        pass  # if no mx is installed
+
+
+class pythonDateTimeConverter(TimeConverter):  # standard since Python 2.3
+    def __init__(self):
+        TimeConverter.__init__(self)
+
+    def DateObjectFromCOMDate(self, comDate):
+        if isinstance(comDate, datetime.datetime):
+            odn = comDate.toordinal()
+            tim = comDate.time()
+            new = datetime.datetime.combine(datetime.datetime.fromordinal(odn), tim)
+            return new
+            # return comDate.replace(tzinfo=None) # make non aware
+        elif isinstance(comDate, DateTime):
+            fComDate = comDate.ToOADate()  # ironPython clr Date/Time
+        else:
+            fComDate = float(comDate)  # ComDate is number of days since 1899-12-31
+        integerPart = int(fComDate)
+        floatpart = fComDate - integerPart
+        ##if floatpart == 0.0:
+        ##    return datetime.date.fromordinal(integerPart + self._ordinal_1899_12_31)
+        dte = datetime.datetime.fromordinal(
+            integerPart + self._ordinal_1899_12_31
+        ) + datetime.timedelta(milliseconds=floatpart * 86400000)
+        # millisecondsperday=86400000 # 24*60*60*1000
+        return dte
+
+    def Date(self, year, month, day):
+        return datetime.date(year, month, day)
+
+    def Time(self, hour, minute, second):
+        return datetime.time(hour, minute, second)
+
+    def Timestamp(self, year, month, day, hour, minute, second):
+        return datetime.datetime(year, month, day, hour, minute, second)
+
+
+class pythonTimeConverter(TimeConverter):  # the old, ?nix type date and time
+    def __init__(self):  # caution: this Class gets confised by timezones and DST
+        TimeConverter.__init__(self)
+        self.types.add(time.struct_time)
+
+    def DateObjectFromCOMDate(self, comDate):
+        "Returns ticks since 1970"
+        if isinstance(comDate, datetime.datetime):
+            return comDate.timetuple()
+        elif isinstance(comDate, DateTime):  # ironPython clr date/time
+            fcomDate = comDate.ToOADate()
+        else:
+            fcomDate = float(comDate)
+        secondsperday = 86400  # 24*60*60
+        # ComDate is number of days since 1899-12-31, gmtime epoch is 1970-1-1 = 25569 days
+        t = time.gmtime(secondsperday * (fcomDate - 25569.0))
+        return t  # year,month,day,hour,minute,second,weekday,julianday,daylightsaving=t
+
+    def Date(self, year, month, day):
+        return self.Timestamp(year, month, day, 0, 0, 0)
+
+    def Time(self, hour, minute, second):
+        return time.gmtime((hour * 60 + minute) * 60 + second)
+
+    def Timestamp(self, year, month, day, hour, minute, second):
+        return time.localtime(
+            time.mktime((year, month, day, hour, minute, second, 0, 0, -1))
+        )
+
+
+base_dateconverter = pythonDateTimeConverter()
+
+# ------ DB API required module attributes ---------------------
+threadsafety = 1  # TODO -- find out whether this module is actually BETTER than 1.
+
+apilevel = "2.0"  # String constant stating the supported DB API level.
+
+paramstyle = "qmark"  # the default parameter style
+
+# ------ control for an extension which may become part of DB API 3.0 ---
+accepted_paramstyles = ("qmark", "named", "format", "pyformat", "dynamic")
+
+# ------------------------------------------------------------------------------------------
+# define similar types for generic conversion routines
+adoIntegerTypes = (
+    adc.adInteger,
+    adc.adSmallInt,
+    adc.adTinyInt,
+    adc.adUnsignedInt,
+    adc.adUnsignedSmallInt,
+    adc.adUnsignedTinyInt,
+    adc.adBoolean,
+    adc.adError,
+)  # max 32 bits
+adoRowIdTypes = (adc.adChapter,)  # v2.1 Rose
+adoLongTypes = (adc.adBigInt, adc.adFileTime, adc.adUnsignedBigInt)
+adoExactNumericTypes = (
+    adc.adDecimal,
+    adc.adNumeric,
+    adc.adVarNumeric,
+    adc.adCurrency,
+)  # v2.3 Cole
+adoApproximateNumericTypes = (adc.adDouble, adc.adSingle)  # v2.1 Cole
+adoStringTypes = (
+    adc.adBSTR,
+    adc.adChar,
+    adc.adLongVarChar,
+    adc.adLongVarWChar,
+    adc.adVarChar,
+    adc.adVarWChar,
+    adc.adWChar,
+)
+adoBinaryTypes = (adc.adBinary, adc.adLongVarBinary, adc.adVarBinary)
+adoDateTimeTypes = (adc.adDBTime, adc.adDBTimeStamp, adc.adDate, adc.adDBDate)
+adoRemainingTypes = (
+    adc.adEmpty,
+    adc.adIDispatch,
+    adc.adIUnknown,
+    adc.adPropVariant,
+    adc.adArray,
+    adc.adUserDefined,
+    adc.adVariant,
+    adc.adGUID,
+)
+
+
+# this class is a trick to determine whether a type is a member of a related group of types. see PEP notes
+class DBAPITypeObject(object):
+    def __init__(self, valuesTuple):
+        self.values = frozenset(valuesTuple)
+
+    def __eq__(self, other):
+        return other in self.values
+
+    def __ne__(self, other):
+        return other not in self.values
+
+
+"""This type object is used to describe columns in a database that are string-based (e.g. CHAR). """
+STRING = DBAPITypeObject(adoStringTypes)
+
+"""This type object is used to describe (long) binary columns in a database (e.g. LONG, RAW, BLOBs). """
+BINARY = DBAPITypeObject(adoBinaryTypes)
+
+"""This type object is used to describe numeric columns in a database. """
+NUMBER = DBAPITypeObject(
+    adoIntegerTypes + adoLongTypes + adoExactNumericTypes + adoApproximateNumericTypes
+)
+
+"""This type object is used to describe date/time columns in a database. """
+
+DATETIME = DBAPITypeObject(adoDateTimeTypes)
+"""This type object is used to describe the "Row ID" column in a database. """
+ROWID = DBAPITypeObject(adoRowIdTypes)
+
+OTHER = DBAPITypeObject(adoRemainingTypes)
+
+# ------- utilities for translating python data types to ADO data types ---------------------------------
+typeMap = {
+    memoryViewType: adc.adVarBinary,
+    float: adc.adDouble,
+    type(None): adc.adEmpty,
+    str: adc.adBSTR,
+    bool: adc.adBoolean,  # v2.1 Cole
+    decimal.Decimal: adc.adDecimal,
+    int: adc.adBigInt,
+    bytes: adc.adVarBinary,
+}
+
+
+def pyTypeToADOType(d):
+    tp = type(d)
+    try:
+        return typeMap[tp]
+    except KeyError:  #   The type was not defined in the pre-computed Type table
+        from . import dateconverter
+
+        if (
+            tp in dateconverter.types
+        ):  # maybe it is one of our supported Date/Time types
+            return adc.adDate
+        #  otherwise, attempt to discern the type by probing the data object itself -- to handle duck typing
+        if isinstance(d, StringTypes):
+            return adc.adBSTR
+        if isinstance(d, numbers.Integral):
+            return adc.adBigInt
+        if isinstance(d, numbers.Real):
+            return adc.adDouble
+        raise DataError('cannot convert "%s" (type=%s) to ADO' % (repr(d), tp))
+
+
+# # # # # # # # # # # # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+# functions to convert database values to Python objects
+# ------------------------------------------------------------------------
+# variant type : function converting variant to Python value
+def variantConvertDate(v):
+    from . import dateconverter  # this function only called when adodbapi is running
+
+    return dateconverter.DateObjectFromCOMDate(v)
+
+
+def cvtString(variant):  # use to get old action of adodbapi v1 if desired
+    if onIronPython:
+        try:
+            return variant.ToString()
+        except:
+            pass
+    return str(variant)
+
+
+def cvtDecimal(variant):  # better name
+    return _convertNumberWithCulture(variant, decimal.Decimal)
+
+
+def cvtNumeric(variant):  # older name - don't break old code
+    return cvtDecimal(variant)
+
+
+def cvtFloat(variant):
+    return _convertNumberWithCulture(variant, float)
+
+
+def _convertNumberWithCulture(variant, f):
+    try:
+        return f(variant)
+    except (ValueError, TypeError, decimal.InvalidOperation):
+        try:
+            europeVsUS = str(variant).replace(",", ".")
+            return f(europeVsUS)
+        except (ValueError, TypeError, decimal.InvalidOperation):
+            pass
+
+
+def cvtInt(variant):
+    return int(variant)
+
+
+def cvtLong(variant):  # only important in old versions where long and int differ
+    return int(variant)
+
+
+def cvtBuffer(variant):
+    return bytes(variant)
+
+
+def cvtUnicode(variant):
+    return str(variant)
+
+
+def identity(x):
+    return x
+
+
+def cvtUnusual(variant):
+    if verbose > 1:
+        sys.stderr.write("Conversion called for Unusual data=%s\n" % repr(variant))
+    if isinstance(variant, DateTime):  # COMdate or System.Date
+        from .adodbapi import (  # this will only be called when adodbapi is in use, and very rarely
+            dateconverter,
+        )
+
+        return dateconverter.DateObjectFromCOMDate(variant)
+    return variant  # cannot find conversion function -- just give the data to the user
+
+
+def convert_to_python(variant, func):  # convert DB value into Python value
+    if isinstance(variant, NullTypes):  # IronPython Null or None
+        return None
+    return func(variant)  # call the appropriate conversion function
+
+
+class MultiMap(dict):  # builds a dictionary from {(sequence,of,keys) : function}
+    """A dictionary of ado.type : function -- but you can set multiple items by passing a sequence of keys"""
+
+    # useful for defining conversion functions for groups of similar data types.
+    def __init__(self, aDict):
+        for k, v in list(aDict.items()):
+            self[k] = v  # we must call __setitem__
+
+    def __setitem__(self, adoType, cvtFn):
+        "set a single item, or a whole sequence of items"
+        try:  # user passed us a sequence, set them individually
+            for type in adoType:
+                dict.__setitem__(self, type, cvtFn)
+        except TypeError:  # a single value fails attempt to iterate
+            dict.__setitem__(self, adoType, cvtFn)
+
+
+# initialize variantConversions dictionary used to convert SQL to Python
+# this is the dictionary of default conversion functions, built by the class above.
+# this becomes a class attribute for the Connection, and that attribute is used
+# to build the list of column conversion functions for the Cursor
+variantConversions = MultiMap(
+    {
+        adoDateTimeTypes: variantConvertDate,
+        adoApproximateNumericTypes: cvtFloat,
+        adoExactNumericTypes: cvtDecimal,  # use to force decimal rather than unicode
+        adoLongTypes: cvtLong,
+        adoIntegerTypes: cvtInt,
+        adoRowIdTypes: cvtInt,
+        adoStringTypes: identity,
+        adoBinaryTypes: cvtBuffer,
+        adoRemainingTypes: cvtUnusual,
+    }
+)
+
+# # # # # classes to emulate the result of cursor.fetchxxx() as a sequence of sequences # # # # #
+# "an ENUM of how my low level records are laid out"
+RS_WIN_32, RS_ARRAY, RS_REMOTE = list(range(1, 4))
+
+
+class SQLrow(object):  # a single database row
+    # class to emulate a sequence, so that a column may be retrieved by either number or name
+    def __init__(self, rows, index):  # "rows" is an _SQLrows object, index is which row
+        self.rows = rows  # parent 'fetch' container object
+        self.index = index  # my row number within parent
+
+    def __getattr__(self, name):  # used for row.columnName type of value access
+        try:
+            return self._getValue(self.rows.columnNames[name.lower()])
+        except KeyError:
+            raise AttributeError('Unknown column name "{}"'.format(name))
+
+    def _getValue(self, key):  # key must be an integer
+        if (
+            self.rows.recordset_format == RS_ARRAY
+        ):  # retrieve from two-dimensional array
+            v = self.rows.ado_results[key, self.index]
+        elif self.rows.recordset_format == RS_REMOTE:
+            v = self.rows.ado_results[self.index][key]
+        else:  # pywin32 - retrieve from tuple of tuples
+            v = self.rows.ado_results[key][self.index]
+        if self.rows.converters is NotImplemented:
+            return v
+        return convert_to_python(v, self.rows.converters[key])
+
+    def __len__(self):
+        return self.rows.numberOfColumns
+
+    def __getitem__(self, key):  # used for row[key] type of value access
+        if isinstance(key, int):  # normal row[1] designation
+            try:
+                return self._getValue(key)
+            except IndexError:
+                raise
+        if isinstance(key, slice):
+            indices = key.indices(self.rows.numberOfColumns)
+            vl = [self._getValue(i) for i in range(*indices)]
+            return tuple(vl)
+        try:
+            return self._getValue(
+                self.rows.columnNames[key.lower()]
+            )  # extension row[columnName] designation
+        except (KeyError, TypeError):
+            er, st, tr = sys.exc_info()
+            raise er(
+                'No such key as "%s" in %s' % (repr(key), self.__repr__())
+            ).with_traceback(tr)
+
+    def __iter__(self):
+        return iter(self.__next__())
+
+    def __next__(self):
+        for n in range(self.rows.numberOfColumns):
+            yield self._getValue(n)
+
+    def __repr__(self):  # create a human readable representation
+        taglist = sorted(list(self.rows.columnNames.items()), key=lambda x: x[1])
+        s = "<SQLrow={"
+        for name, i in taglist:
+            s += name + ":" + repr(self._getValue(i)) + ", "
+        return s[:-2] + "}>"
+
+    def __str__(self):  # create a pretty human readable representation
+        return str(
+            tuple(str(self._getValue(i)) for i in range(self.rows.numberOfColumns))
+        )
+
+    # TO-DO implement pickling an SQLrow directly
+    # def __getstate__(self): return self.__dict__
+    # def __setstate__(self, d): self.__dict__.update(d)
+    # which basically tell pickle to treat your class just like a normal one,
+    # taking self.__dict__ as representing the whole of the instance state,
+    #  despite the existence of the __getattr__.
+    # # # #
+
+
+class SQLrows(object):
+    # class to emulate a sequence for multiple rows using a container object
+    def __init__(self, ado_results, numberOfRows, cursor):
+        self.ado_results = ado_results  # raw result of SQL get
+        try:
+            self.recordset_format = cursor.recordset_format
+            self.numberOfColumns = cursor.numberOfColumns
+            self.converters = cursor.converters
+            self.columnNames = cursor.columnNames
+        except AttributeError:
+            self.recordset_format = RS_ARRAY
+            self.numberOfColumns = 0
+            self.converters = []
+            self.columnNames = {}
+        self.numberOfRows = numberOfRows
+
+    def __len__(self):
+        return self.numberOfRows
+
+    def __getitem__(self, item):  # used for row or row,column access
+        if not self.ado_results:
+            return []
+        if isinstance(item, slice):  # will return a list of row objects
+            indices = item.indices(self.numberOfRows)
+            return [SQLrow(self, k) for k in range(*indices)]
+        elif isinstance(item, tuple) and len(item) == 2:
+            # d = some_rowsObject[i,j] will return a datum from a two-dimension address
+            i, j = item
+            if not isinstance(j, int):
+                try:
+                    j = self.columnNames[j.lower()]  # convert named column to numeric
+                except KeyError:
+                    raise KeyError('adodbapi: no such column name as "%s"' % repr(j))
+            if self.recordset_format == RS_ARRAY:  # retrieve from two-dimensional array
+                v = self.ado_results[j, i]
+            elif self.recordset_format == RS_REMOTE:
+                v = self.ado_results[i][j]
+            else:  # pywin32 - retrieve from tuple of tuples
+                v = self.ado_results[j][i]
+            if self.converters is NotImplemented:
+                return v
+            return convert_to_python(v, self.converters[j])
+        else:
+            row = SQLrow(self, item)  # new row descriptor
+            return row
+
+    def __iter__(self):
+        return iter(self.__next__())
+
+    def __next__(self):
+        for n in range(self.numberOfRows):
+            row = SQLrow(self, n)
+            yield row
+            # # # # #
+
+    # # # # # functions to re-format SQL requests to other paramstyle requirements # # # # # # # # # #
+
+
+def changeNamedToQmark(
+    op,
+):  # convert from 'named' paramstyle to ADO required '?'mark parameters
+    outOp = ""
+    outparms = []
+    chunks = op.split(
+        "'"
+    )  # quote all literals -- odd numbered list results are literals.
+    inQuotes = False
+    for chunk in chunks:
+        if inQuotes:  # this is inside a quote
+            if chunk == "":  # double apostrophe to quote one apostrophe
+                outOp = outOp[:-1]  # so take one away
+            else:
+                outOp += "'" + chunk + "'"  # else pass the quoted string as is.
+        else:  # is SQL code -- look for a :namedParameter
+            while chunk:  # some SQL string remains
+                sp = chunk.split(":", 1)
+                outOp += sp[0]  # concat the part up to the :
+                s = ""
+                try:
+                    chunk = sp[1]
+                except IndexError:
+                    chunk = None
+                if chunk:  # there was a parameter - parse it out
+                    i = 0
+                    c = chunk[0]
+                    while c.isalnum() or c == "_":
+                        i += 1
+                        try:
+                            c = chunk[i]
+                        except IndexError:
+                            break
+                    s = chunk[:i]
+                    chunk = chunk[i:]
+                if s:
+                    outparms.append(s)  # list the parameters in order
+                    outOp += "?"  # put in the Qmark
+        inQuotes = not inQuotes
+    return outOp, outparms
+
+
+def changeFormatToQmark(
+    op,
+):  # convert from 'format' paramstyle to ADO required '?'mark parameters
+    outOp = ""
+    outparams = []
+    chunks = op.split(
+        "'"
+    )  # quote all literals -- odd numbered list results are literals.
+    inQuotes = False
+    for chunk in chunks:
+        if inQuotes:
+            if (
+                outOp != "" and chunk == ""
+            ):  # he used a double apostrophe to quote one apostrophe
+                outOp = outOp[:-1]  # so take one away
+            else:
+                outOp += "'" + chunk + "'"  # else pass the quoted string as is.
+        else:  # is SQL code -- look for a %s parameter
+            if "%(" in chunk:  # ugh! pyformat!
+                while chunk:  # some SQL string remains
+                    sp = chunk.split("%(", 1)
+                    outOp += sp[0]  # concat the part up to the %
+                    if len(sp) > 1:
+                        try:
+                            s, chunk = sp[1].split(")s", 1)  # find the ')s'
+                        except ValueError:
+                            raise ProgrammingError(
+                                'Pyformat SQL has incorrect format near "%s"' % chunk
+                            )
+                        outparams.append(s)
+                        outOp += "?"  # put in the Qmark
+                    else:
+                        chunk = None
+            else:  # proper '%s' format
+                sp = chunk.split("%s")  # make each %s
+                outOp += "?".join(sp)  # into ?
+        inQuotes = not inQuotes  # every other chunk is a quoted string
+    return outOp, outparams
diff --git a/lib/adodbapi/examples/db_print.py b/lib/adodbapi/examples/db_print.py
new file mode 100644
index 00000000..3f5f9d5b
--- /dev/null
+++ b/lib/adodbapi/examples/db_print.py
@@ -0,0 +1,72 @@
+""" db_print.py -- a simple demo for ADO database reads."""
+
+import sys
+
+import adodbapi.ado_consts as adc
+
+cmd_args = ("filename", "table_name")
+if "help" in sys.argv:
+    print("possible settings keywords are:", cmd_args)
+    sys.exit()
+
+kw_args = {}  # pick up filename and proxy address from command line (optionally)
+for arg in sys.argv:
+    s = arg.split("=")
+    if len(s) > 1:
+        if s[0] in cmd_args:
+            kw_args[s[0]] = s[1]
+
+kw_args.setdefault(
+    "filename", "test.mdb"
+)  # assumes server is running from examples folder
+kw_args.setdefault("table_name", "Products")  # the name of the demo table
+
+# the server needs to select the provider based on his Python installation
+provider_switch = ["provider", "Microsoft.ACE.OLEDB.12.0", "Microsoft.Jet.OLEDB.4.0"]
+
+# ------------------------ START HERE -------------------------------------
+# create the connection
+constr = "Provider=%(provider)s;Data Source=%(filename)s"
+import adodbapi as db
+
+con = db.connect(constr, kw_args, macro_is64bit=provider_switch)
+
+if kw_args["table_name"] == "?":
+    print("The tables in your database are:")
+    for name in con.get_table_names():
+        print(name)
+else:
+    # make a cursor on the connection
+    with con.cursor() as c:
+        # run an SQL statement on the cursor
+        sql = "select * from %s" % kw_args["table_name"]
+        print('performing query="%s"' % sql)
+        c.execute(sql)
+
+        # check the results
+        print(
+            'result rowcount shows as= %d. (Note: -1 means "not known")' % (c.rowcount,)
+        )
+        print("")
+        print("result data description is:")
+        print("            NAME Type         DispSize IntrnlSz Prec Scale Null?")
+        for d in c.description:
+            print(
+                ("%16s %-12s %8s %8d %4d %5d %s")
+                % (d[0], adc.adTypeNames[d[1]], d[2], d[3], d[4], d[5], bool(d[6]))
+            )
+        print("")
+        print("str() of first five records are...")
+
+        # get the results
+        db = c.fetchmany(5)
+
+        # print them
+        for rec in db:
+            print(rec)
+
+        print("")
+        print("repr() of next row is...")
+        print(repr(c.fetchone()))
+        print("")
+con.close()
diff --git a/lib/adodbapi/examples/db_table_names.py b/lib/adodbapi/examples/db_table_names.py
new file mode 100644
index 00000000..eb512a33
--- /dev/null
+++ b/lib/adodbapi/examples/db_table_names.py
@@ -0,0 +1,20 @@
+""" db_table_names.py -- a simple demo for ADO database table listing."""
+import sys
+
+import adodbapi
+
+try:
+    databasename = sys.argv[1]
+except IndexError:
+    databasename = "test.mdb"
+
+provider = ["prv", "Microsoft.ACE.OLEDB.12.0", "Microsoft.Jet.OLEDB.4.0"]
+constr = "Provider=%(prv)s;Data Source=%(db)s"
+
+# create the connection
+con = adodbapi.connect(constr, db=databasename, macro_is64bit=provider)
+
+print("Table names in= %s" % databasename)
+
+for table in con.get_table_names():
+    print(table)
diff --git a/lib/adodbapi/examples/xls_read.py b/lib/adodbapi/examples/xls_read.py
new file mode 100644
index 00000000..45e0d277
--- /dev/null
+++ b/lib/adodbapi/examples/xls_read.py
@@ -0,0 +1,41 @@
+import sys
+
+import adodbapi
+
+try:
+    import adodbapi.is64bit as is64bit
+
+    is64 = is64bit.Python()
+except ImportError:
+    is64 = False
+
+if is64:
+    driver = "Microsoft.ACE.OLEDB.12.0"
+else:
+    driver = "Microsoft.Jet.OLEDB.4.0"
+extended = 'Extended Properties="Excel 8.0;HDR=Yes;IMEX=1;"'
+
+try:  # first command line argument will be xls file name -- default to the one written by xls_write.py
+    filename = sys.argv[1]
+except IndexError:
+    filename = "xx.xls"
+
+constr = "Provider=%s;Data Source=%s;%s" % (driver, filename, extended)
+
+conn = adodbapi.connect(constr)
+
+try:  # second command line argument will be worksheet name -- default to first worksheet
+    sheet = sys.argv[2]
+except IndexError:
+    # use ADO feature to get the name of the first worksheet
+    sheet = conn.get_table_names()[0]
+
+print("Shreadsheet=%s  Worksheet=%s" % (filename, sheet))
+print("------------------------------------------------------------")
+crsr = conn.cursor()
+sql = "SELECT * from [%s]" % sheet
+crsr.execute(sql)
+for row in crsr.fetchmany(10):
+    print(repr(row))
+crsr.close()
+conn.close()
diff --git a/lib/adodbapi/examples/xls_write.py b/lib/adodbapi/examples/xls_write.py
new file mode 100644
index 00000000..9d1d3114
--- /dev/null
+++ b/lib/adodbapi/examples/xls_write.py
@@ -0,0 +1,41 @@
+import datetime
+
+import adodbapi
+
+try:
+    import adodbapi.is64bit as is64bit
+
+    is64 = is64bit.Python()
+except ImportError:
+    is64 = False  # in case the user has an old version of adodbapi
+if is64:
+    driver = "Microsoft.ACE.OLEDB.12.0"
+else:
+    driver = "Microsoft.Jet.OLEDB.4.0"
+filename = "xx.xls"  # file will be created if it does not exist
+extended = 'Extended Properties="Excel 8.0;Readonly=False;"'
+
+constr = "Provider=%s;Data Source=%s;%s" % (driver, filename, extended)
+
+conn = adodbapi.connect(constr)
+with conn:  # will auto commit if no errors
+    with conn.cursor() as crsr:
+        try:
+            crsr.execute("drop table SheetOne")
+        except:
+            pass  # just is case there is one already there
+
+        # create the sheet and the header row and set the types for the columns
+        crsr.execute(
+            "create table SheetOne (Name varchar, Rank varchar, SrvcNum integer, Weight float,  Birth date)"
+        )
+
+        sql = "INSERT INTO SheetOne (name, rank , srvcnum, weight, birth) values (?,?,?,?,?)"
+
+        data = ("Mike Murphy", "SSG", 123456789, 167.8, datetime.date(1922, 12, 27))
+        crsr.execute(sql, data)  # write the first row of data
+        crsr.execute(
+            sql, ["John Jones", "Pvt", 987654321, 140.0, datetime.date(1921, 7, 4)]
+        )  # another row of data
+conn.close()
+print("Created spreadsheet=%s worksheet=%s" % (filename, "SheetOne"))
diff --git a/lib/adodbapi/is64bit.py b/lib/adodbapi/is64bit.py
new file mode 100644
index 00000000..bba12b43
--- /dev/null
+++ b/lib/adodbapi/is64bit.py
@@ -0,0 +1,41 @@
+"""is64bit.Python() --> boolean value of detected Python word size. is64bit.os() --> os build version"""
+import sys
+
+
+def Python():
+    if sys.platform == "cli":  # IronPython
+        import System
+
+        return System.IntPtr.Size == 8
+    else:
+        try:
+            return sys.maxsize > 2147483647
+        except AttributeError:
+            return sys.maxint > 2147483647
+
+
+def os():
+    import platform
+
+    pm = platform.machine()
+    if pm != ".." and pm.endswith("64"):  # recent Python (not Iron)
+        return True
+    else:
+        import os
+
+        if "PROCESSOR_ARCHITEW6432" in os.environ:
+            return True  # 32 bit program running on 64 bit Windows
+        try:
+            return os.environ["PROCESSOR_ARCHITECTURE"].endswith(
+                "64"
+            )  # 64 bit Windows 64 bit program
+        except (IndexError, KeyError):
+            pass  # not Windows
+        try:
+            return "64" in platform.architecture()[0]  # this often works in Linux
+        except:
+            return False  # is an older version of Python, assume also an older os (best we can guess)
+
+
+if __name__ == "__main__":
+    print("is64bit.Python() =", Python(), "is64bit.os() =", os())
diff --git a/lib/adodbapi/license.txt b/lib/adodbapi/license.txt
new file mode 100644
index 00000000..c255f4aa
--- /dev/null
+++ b/lib/adodbapi/license.txt
@@ -0,0 +1,506 @@
+		  GNU LESSER GENERAL PUBLIC LICENSE
+		       Version 2.1, February 1999
+
+ Copyright (C) 1991, 1999 Free Software Foundation, Inc.
+     59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+[This is the first released version of the Lesser GPL.  It also counts
+ as the successor of the GNU Library Public License, version 2, hence
+ the version number 2.1.]
+
+			    Preamble
+
+  The licenses for most software are designed to take away your
+freedom to share and change it.  By contrast, the GNU General Public
+Licenses are intended to guarantee your freedom to share and change
+free software--to make sure the software is free for all its users.
+
+  This license, the Lesser General Public License, applies to some
+specially designated software packages--typically libraries--of the
+Free Software Foundation and other authors who decide to use it.  You
+can use it too, but we suggest you first think carefully about whether
+this license or the ordinary General Public License is the better
+strategy to use in any particular case, based on the explanations below.
+
+  When we speak of free software, we are referring to freedom of use,
+not price.  Our General Public Licenses are designed to make sure that
+you have the freedom to distribute copies of free software (and charge
+for this service if you wish); that you receive source code or can get
+it if you want it; that you can change the software and use pieces of
+it in new free programs; and that you are informed that you can do
+these things.
+
+  To protect your rights, we need to make restrictions that forbid
+distributors to deny you these rights or to ask you to surrender these
+rights.  These restrictions translate to certain responsibilities for
+you if you distribute copies of the library or if you modify it.
+
+  For example, if you distribute copies of the library, whether gratis
+or for a fee, you must give the recipients all the rights that we gave
+you.  You must make sure that they, too, receive or can get the source
+code.  If you link other code with the library, you must provide
+complete object files to the recipients, so that they can relink them
+with the library after making changes to the library and recompiling
+it.  And you must show them these terms so they know their rights.
+
+  We protect your rights with a two-step method: (1) we copyright the
+library, and (2) we offer you this license, which gives you legal
+permission to copy, distribute and/or modify the library.
+
+  To protect each distributor, we want to make it very clear that
+there is no warranty for the free library.  Also, if the library is
+modified by someone else and passed on, the recipients should know
+that what they have is not the original version, so that the original
+author's reputation will not be affected by problems that might be
+introduced by others.
+
+
+
+  Finally, software patents pose a constant threat to the existence of
+any free program.  We wish to make sure that a company cannot
+effectively restrict the users of a free program by obtaining a
+restrictive license from a patent holder.  Therefore, we insist that
+any patent license obtained for a version of the library must be
+consistent with the full freedom of use specified in this license.
+
+  Most GNU software, including some libraries, is covered by the
+ordinary GNU General Public License.  This license, the GNU Lesser
+General Public License, applies to certain designated libraries, and
+is quite different from the ordinary General Public License.  We use
+this license for certain libraries in order to permit linking those
+libraries into non-free programs.
+
+  When a program is linked with a library, whether statically or using
+a shared library, the combination of the two is legally speaking a
+combined work, a derivative of the original library.  The ordinary
+General Public License therefore permits such linking only if the
+entire combination fits its criteria of freedom.  The Lesser General
+Public License permits more lax criteria for linking other code with
+the library.
+
+  We call this license the "Lesser" General Public License because it
+does Less to protect the user's freedom than the ordinary General
+Public License.  It also provides other free software developers Less
+of an advantage over competing non-free programs.  These disadvantages
+are the reason we use the ordinary General Public License for many
+libraries.  However, the Lesser license provides advantages in certain
+special circumstances.
+
+  For example, on rare occasions, there may be a special need to
+encourage the widest possible use of a certain library, so that it becomes
+a de-facto standard.  To achieve this, non-free programs must be
+allowed to use the library.  A more frequent case is that a free
+library does the same job as widely used non-free libraries.  In this
+case, there is little to gain by limiting the free library to free
+software only, so we use the Lesser General Public License.
+
+  In other cases, permission to use a particular library in non-free
+programs enables a greater number of people to use a large body of
+free software.  For example, permission to use the GNU C Library in
+non-free programs enables many more people to use the whole GNU
+operating system, as well as its variant, the GNU/Linux operating
+system.
+
+  Although the Lesser General Public License is Less protective of the
+users' freedom, it does ensure that the user of a program that is
+linked with the Library has the freedom and the wherewithal to run
+that program using a modified version of the Library.
+
+  The precise terms and conditions for copying, distribution and
+modification follow.  Pay close attention to the difference between a
+"work based on the library" and a "work that uses the library".  The
+former contains code derived from the library, whereas the latter must
+be combined with the library in order to run.
+
+
+
+		  GNU LESSER GENERAL PUBLIC LICENSE
+   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+
+  0. This License Agreement applies to any software library or other
+program which contains a notice placed by the copyright holder or
+other authorized party saying it may be distributed under the terms of
+this Lesser General Public License (also called "this License").
+Each licensee is addressed as "you".
+
+  A "library" means a collection of software functions and/or data
+prepared so as to be conveniently linked with application programs
+(which use some of those functions and data) to form executables.
+
+  The "Library", below, refers to any such software library or work
+which has been distributed under these terms.  A "work based on the
+Library" means either the Library or any derivative work under
+copyright law: that is to say, a work containing the Library or a
+portion of it, either verbatim or with modifications and/or translated
+straightforwardly into another language.  (Hereinafter, translation is
+included without limitation in the term "modification".)
+
+  "Source code" for a work means the preferred form of the work for
+making modifications to it.  For a library, complete source code means
+all the source code for all modules it contains, plus any associated
+interface definition files, plus the scripts used to control compilation
+and installation of the library.
+
+  Activities other than copying, distribution and modification are not
+covered by this License; they are outside its scope.  The act of
+running a program using the Library is not restricted, and output from
+such a program is covered only if its contents constitute a work based
+on the Library (independent of the use of the Library in a tool for
+writing it).  Whether that is true depends on what the Library does
+and what the program that uses the Library does.
+  
+  1. You may copy and distribute verbatim copies of the Library's
+complete source code as you receive it, in any medium, provided that
+you conspicuously and appropriately publish on each copy an
+appropriate copyright notice and disclaimer of warranty; keep intact
+all the notices that refer to this License and to the absence of any
+warranty; and distribute a copy of this License along with the
+Library.
+  You may charge a fee for the physical act of transferring a copy,
+and you may at your option offer warranty protection in exchange for a
+fee.
+
+  2. You may modify your copy or copies of the Library or any portion
+of it, thus forming a work based on the Library, and copy and
+distribute such modifications or work under the terms of Section 1
+above, provided that you also meet all of these conditions:
+
+    a) The modified work must itself be a software library.
+
+    b) You must cause the files modified to carry prominent notices
+    stating that you changed the files and the date of any change.
+
+    c) You must cause the whole of the work to be licensed at no
+    charge to all third parties under the terms of this License.
+
+    d) If a facility in the modified Library refers to a function or a
+    table of data to be supplied by an application program that uses
+    the facility, other than as an argument passed when the facility
+    is invoked, then you must make a good faith effort to ensure that,
+    in the event an application does not supply such function or
+    table, the facility still operates, and performs whatever part of
+    its purpose remains meaningful.
+
+    (For example, a function in a library to compute square roots has
+    a purpose that is entirely well-defined independent of the
+    application.  Therefore, Subsection 2d requires that any
+    application-supplied function or table used by this function must
+    be optional: if the application does not supply it, the square
+    root function must still compute square roots.)
+
+These requirements apply to the modified work as a whole.  If
+identifiable sections of that work are not derived from the Library,
+and can be reasonably considered independent and separate works in
+themselves, then this License, and its terms, do not apply to those
+sections when you distribute them as separate works.  But when you
+distribute the same sections as part of a whole which is a work based
+on the Library, the distribution of the whole must be on the terms of
+this License, whose permissions for other licensees extend to the
+entire whole, and thus to each and every part regardless of who wrote
+it.
+
+Thus, it is not the intent of this section to claim rights or contest
+your rights to work written entirely by you; rather, the intent is to
+exercise the right to control the distribution of derivative or
+collective works based on the Library.
+
+In addition, mere aggregation of another work not based on the Library
+with the Library (or with a work based on the Library) on a volume of
+a storage or distribution medium does not bring the other work under
+the scope of this License.
+
+  3. You may opt to apply the terms of the ordinary GNU General Public
+License instead of this License to a given copy of the Library.  To do
+this, you must alter all the notices that refer to this License, so
+that they refer to the ordinary GNU General Public License, version 2,
+instead of to this License.  (If a newer version than version 2 of the
+ordinary GNU General Public License has appeared, then you can specify
+that version instead if you wish.)  Do not make any other change in
+these notices.
+
+  Once this change is made in a given copy, it is irreversible for
+that copy, so the ordinary GNU General Public License applies to all
+subsequent copies and derivative works made from that copy.
+
+  This option is useful when you wish to copy part of the code of
+the Library into a program that is not a library.
+
+  4. You may copy and distribute the Library (or a portion or
+derivative of it, under Section 2) in object code or executable form
+under the terms of Sections 1 and 2 above provided that you accompany
+it with the complete corresponding machine-readable source code, which
+must be distributed under the terms of Sections 1 and 2 above on a
+medium customarily used for software interchange.
+
+  If distribution of object code is made by offering access to copy
+from a designated place, then offering equivalent access to copy the
+source code from the same place satisfies the requirement to
+distribute the source code, even though third parties are not
+compelled to copy the source along with the object code.
+
+  5. A program that contains no derivative of any portion of the
+Library, but is designed to work with the Library by being compiled or
+linked with it, is called a "work that uses the Library".  Such a
+work, in isolation, is not a derivative work of the Library, and
+therefore falls outside the scope of this License.
+
+  However, linking a "work that uses the Library" with the Library
+creates an executable that is a derivative of the Library (because it
+contains portions of the Library), rather than a "work that uses the
+library".  The executable is therefore covered by this License.
+Section 6 states terms for distribution of such executables.
+
+  When a "work that uses the Library" uses material from a header file
+that is part of the Library, the object code for the work may be a
+derivative work of the Library even though the source code is not.
+Whether this is true is especially significant if the work can be
+linked without the Library, or if the work is itself a library.  The
+threshold for this to be true is not precisely defined by law.
+
+  If such an object file uses only numerical parameters, data
+structure layouts and accessors, and small macros and small inline
+functions (ten lines or less in length), then the use of the object
+file is unrestricted, regardless of whether it is legally a derivative
+work.  (Executables containing this object code plus portions of the
+Library will still fall under Section 6.)
+
+  Otherwise, if the work is a derivative of the Library, you may
+distribute the object code for the work under the terms of Section 6.
+Any executables containing that work also fall under Section 6,
+whether or not they are linked directly with the Library itself.
+
+  6. As an exception to the Sections above, you may also combine or
+link a "work that uses the Library" with the Library to produce a
+work containing portions of the Library, and distribute that work
+under terms of your choice, provided that the terms permit
+modification of the work for the customer's own use and reverse
+engineering for debugging such modifications.
+
+  You must give prominent notice with each copy of the work that the
+Library is used in it and that the Library and its use are covered by
+this License.  You must supply a copy of this License.  If the work
+during execution displays copyright notices, you must include the
+copyright notice for the Library among them, as well as a reference
+directing the user to the copy of this License.  Also, you must do one
+of these things:
+
+    a) Accompany the work with the complete corresponding
+    machine-readable source code for the Library including whatever
+    changes were used in the work (which must be distributed under
+    Sections 1 and 2 above); and, if the work is an executable linked
+    with the Library, with the complete machine-readable "work that
+    uses the Library", as object code and/or source code, so that the
+    user can modify the Library and then relink to produce a modified
+    executable containing the modified Library.  (It is understood
+    that the user who changes the contents of definitions files in the
+    Library will not necessarily be able to recompile the application
+    to use the modified definitions.)
+
+    b) Use a suitable shared library mechanism for linking with the
+    Library.  A suitable mechanism is one that (1) uses at run time a
+    copy of the library already present on the user's computer system,
+    rather than copying library functions into the executable, and (2)
+    will operate properly with a modified version of the library, if
+    the user installs one, as long as the modified version is
+    interface-compatible with the version that the work was made with.
+
+    c) Accompany the work with a written offer, valid for at
+    least three years, to give the same user the materials
+    specified in Subsection 6a, above, for a charge no more
+    than the cost of performing this distribution.
+
+    d) If distribution of the work is made by offering access to copy
+    from a designated place, offer equivalent access to copy the above
+    specified materials from the same place.
+
+    e) Verify that the user has already received a copy of these
+    materials or that you have already sent this user a copy.
+
+  For an executable, the required form of the "work that uses the
+Library" must include any data and utility programs needed for
+reproducing the executable from it.  However, as a special exception,
+the materials to be distributed need not include anything that is
+normally distributed (in either source or binary form) with the major
+components (compiler, kernel, and so on) of the operating system on
+which the executable runs, unless that component itself accompanies
+the executable.
+
+  It may happen that this requirement contradicts the license
+restrictions of other proprietary libraries that do not normally
+accompany the operating system.  Such a contradiction means you cannot
+use both them and the Library together in an executable that you
+distribute.
+
+  7. You may place library facilities that are a work based on the
+Library side-by-side in a single library together with other library
+facilities not covered by this License, and distribute such a combined
+library, provided that the separate distribution of the work based on
+the Library and of the other library facilities is otherwise
+permitted, and provided that you do these two things:
+
+    a) Accompany the combined library with a copy of the same work
+    based on the Library, uncombined with any other library
+    facilities.  This must be distributed under the terms of the
+    Sections above.
+
+    b) Give prominent notice with the combined library of the fact
+    that part of it is a work based on the Library, and explaining
+    where to find the accompanying uncombined form of the same work.
+
+  8. You may not copy, modify, sublicense, link with, or distribute
+the Library except as expressly provided under this License.  Any
+attempt otherwise to copy, modify, sublicense, link with, or
+distribute the Library is void, and will automatically terminate your
+rights under this License.  However, parties who have received copies,
+or rights, from you under this License will not have their licenses
+terminated so long as such parties remain in full compliance.
+
+  9. You are not required to accept this License, since you have not
+signed it.  However, nothing else grants you permission to modify or
+distribute the Library or its derivative works.  These actions are
+prohibited by law if you do not accept this License.  Therefore, by
+modifying or distributing the Library (or any work based on the
+Library), you indicate your acceptance of this License to do so, and
+all its terms and conditions for copying, distributing or modifying
+the Library or works based on it.
+
+  10. Each time you redistribute the Library (or any work based on the
+Library), the recipient automatically receives a license from the
+original licensor to copy, distribute, link with or modify the Library
+subject to these terms and conditions.  You may not impose any further
+restrictions on the recipients' exercise of the rights granted herein.
+You are not responsible for enforcing compliance by third parties with
+this License.
+
+  11. If, as a consequence of a court judgment or allegation of patent
+infringement or for any other reason (not limited to patent issues),
+conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License.  If you cannot
+distribute so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you
+may not distribute the Library at all.  For example, if a patent
+license would not permit royalty-free redistribution of the Library by
+all those who receive copies directly or indirectly through you, then
+the only way you could satisfy both it and this License would be to
+refrain entirely from distribution of the Library.
+
+If any portion of this section is held invalid or unenforceable under any
+particular circumstance, the balance of the section is intended to apply,
+and the section as a whole is intended to apply in other circumstances.
+
+It is not the purpose of this section to induce you to infringe any
+patents or other property right claims or to contest validity of any
+such claims; this section has the sole purpose of protecting the
+integrity of the free software distribution system which is
+implemented by public license practices.  Many people have made
+generous contributions to the wide range of software distributed
+through that system in reliance on consistent application of that
+system; it is up to the author/donor to decide if he or she is willing
+to distribute software through any other system and a licensee cannot
+impose that choice.
+
+This section is intended to make thoroughly clear what is believed to
+be a consequence of the rest of this License.
+
+  12. If the distribution and/or use of the Library is restricted in
+certain countries either by patents or by copyrighted interfaces, the
+original copyright holder who places the Library under this License may add
+an explicit geographical distribution limitation excluding those countries,
+so that distribution is permitted only in or among countries not thus
+excluded.  In such case, this License incorporates the limitation as if
+written in the body of this License.
+
+  13. The Free Software Foundation may publish revised and/or new
+versions of the Lesser General Public License from time to time.
+Such new versions will be similar in spirit to the present version,
+but may differ in detail to address new problems or concerns.
+
+Each version is given a distinguishing version number.  If the Library
+specifies a version number of this License which applies to it and
+"any later version", you have the option of following the terms and
+conditions either of that version or of any later version published by
+the Free Software Foundation.  If the Library does not specify a
+license version number, you may choose any version ever published by
+the Free Software Foundation.
+
+  14. If you wish to incorporate parts of the Library into other free
+programs whose distribution conditions are incompatible with these,
+write to the author to ask for permission.  For software which is
+copyrighted by the Free Software Foundation, write to the Free
+Software Foundation; we sometimes make exceptions for this.  Our
+decision will be guided by the two goals of preserving the free status
+of all derivatives of our free software and of promoting the sharing
+and reuse of software generally.
+
+			    NO WARRANTY
+
+  15. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO
+WARRANTY FOR THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW.
+EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR
+OTHER PARTIES PROVIDE THE LIBRARY "AS IS" WITHOUT WARRANTY OF ANY
+KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
+LIBRARY IS WITH YOU.  SHOULD THE LIBRARY PROVE DEFECTIVE, YOU ASSUME
+THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+
+  16. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
+WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY
+AND/OR REDISTRIBUTE THE LIBRARY AS PERMITTED ABOVE, BE LIABLE TO YOU
+FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR
+CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE
+LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING
+RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A
+FAILURE OF THE LIBRARY TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF
+SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
+DAMAGES.
+
+		     END OF TERMS AND CONDITIONS
+
+           How to Apply These Terms to Your New Libraries
+
+  If you develop a new library, and you want it to be of the greatest
+possible use to the public, we recommend making it free software that
+everyone can redistribute and change.  You can do so by permitting
+redistribution under these terms (or, alternatively, under the terms of the
+ordinary General Public License).
+
+  To apply these terms, attach the following notices to the library.  It is
+safest to attach them to the start of each source file to most effectively
+convey the exclusion of warranty; and each file should have at least the
+"copyright" line and a pointer to where the full notice is found.
+
+    <one line to give the library's name and a brief idea of what it does.>
+    Copyright (C) <year>  <name of author>
+
+    This library is free software; you can redistribute it and/or
+    modify it under the terms of the GNU Lesser General Public
+    License as published by the Free Software Foundation; either
+    version 2.1 of the License, or (at your option) any later version.
+
+    This library is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+    Lesser General Public License for more details.
+
+    You should have received a copy of the GNU Lesser General Public
+    License along with this library; if not, write to the Free Software
+    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+
+Also add information on how to contact you by electronic and paper mail.
+
+You should also get your employer (if you work as a programmer) or your
+school, if any, to sign a "copyright disclaimer" for the library, if
+necessary.  Here is a sample; alter the names:
+
+  Yoyodyne, Inc., hereby disclaims all copyright interest in the
+  library `Frob' (a library for tweaking knobs) written by James Random Hacker.
+
+  <signature of Ty Coon>, 1 April 1990
+  Ty Coon, President of Vice
+
+That's all there is to it!
+
diff --git a/lib/adodbapi/process_connect_string.py b/lib/adodbapi/process_connect_string.py
new file mode 100644
index 00000000..fa34d23a
--- /dev/null
+++ b/lib/adodbapi/process_connect_string.py
@@ -0,0 +1,144 @@
+""" a clumsy attempt at a macro language to let the programmer execute code on the server (ex: determine 64bit)"""
+from . import is64bit as is64bit
+
+
+def macro_call(macro_name, args, kwargs):
+    """allow the programmer to perform limited processing on the server by passing macro names and args
+
+    :new_key - the key name the macro will create
+    :args[0] - macro name
+    :args[1:] - any arguments
+    :code - the value of the keyword item
+    :kwargs - the connection keyword dictionary. ??key has been removed
+    --> the value to put in for kwargs['name'] = value
+    """
+    if isinstance(args, (str, str)):
+        args = [
+            args
+        ]  # the user forgot to pass a sequence, so make a string into args[0]
+    new_key = args[0]
+    try:
+        if macro_name == "is64bit":
+            if is64bit.Python():  # if on 64 bit Python
+                return new_key, args[1]  # return first argument
+            else:
+                try:
+                    return new_key, args[2]  # else return second argument (if defined)
+                except IndexError:
+                    return new_key, ""  # else return blank
+
+        elif (
+            macro_name == "getuser"
+        ):  # get the name of the user the server is logged in under
+            if not new_key in kwargs:
+                import getpass
+
+                return new_key, getpass.getuser()
+
+        elif macro_name == "getnode":  # get the name of the computer running the server
+            import platform
+
+            try:
+                return new_key, args[1] % platform.node()
+            except IndexError:
+                return new_key, platform.node()
+
+        elif macro_name == "getenv":  # expand the server's environment variable args[1]
+            try:
+                dflt = args[2]  # if not found, default from args[2]
+            except IndexError:  # or blank
+                dflt = ""
+            return new_key, os.environ.get(args[1], dflt)
+
+        elif macro_name == "auto_security":
+            if (
+                not "user" in kwargs or not kwargs["user"]
+            ):  # missing, blank, or Null username
+                return new_key, "Integrated Security=SSPI"
+            return new_key, "User ID=%(user)s; Password=%(password)s" % kwargs
+
+        elif (
+            macro_name == "find_temp_test_path"
+        ):  # helper function for testing ado operation -- undocumented
+            import os
+            import tempfile
+
+            return new_key, os.path.join(
+                tempfile.gettempdir(), "adodbapi_test", args[1]
+            )
+
+        raise ValueError("Unknown connect string macro=%s" % macro_name)
+    except:
+        raise ValueError("Error in macro processing %s %s" % (macro_name, repr(args)))
+
+
+def process(
+    args, kwargs, expand_macros=False
+):  # --> connection string with keyword arguments processed.
+    """attempts to inject arguments into a connection string using Python "%" operator for strings
+
+    co: adodbapi connection object
+    args: positional parameters from the .connect() call
+    kvargs: keyword arguments from the .connect() call
+    """
+    try:
+        dsn = args[0]
+    except IndexError:
+        dsn = None
+    if isinstance(
+        dsn, dict
+    ):  # as a convenience the first argument may be django settings
+        kwargs.update(dsn)
+    elif (
+        dsn
+    ):  # the connection string is passed to the connection as part of the keyword dictionary
+        kwargs["connection_string"] = dsn
+    try:
+        a1 = args[1]
+    except IndexError:
+        a1 = None
+    # historically, the second positional argument might be a timeout value
+    if isinstance(a1, int):
+        kwargs["timeout"] = a1
+    # if the second positional argument is a string, then it is user
+    elif isinstance(a1, str):
+        kwargs["user"] = a1
+    # if the second positional argument is a dictionary, use it as keyword arguments, too
+    elif isinstance(a1, dict):
+        kwargs.update(a1)
+    try:
+        kwargs["password"] = args[2]  # the third positional argument is password
+        kwargs["host"] = args[3]  # the fourth positional argument is host name
+        kwargs["database"] = args[4]  # the fifth positional argument is database name
+    except IndexError:
+        pass
+
+    # make sure connection string is defined somehow
+    if not "connection_string" in kwargs:
+        try:  # perhaps 'dsn' was defined
+            kwargs["connection_string"] = kwargs["dsn"]
+        except KeyError:
+            try:  # as a last effort, use the "host" keyword
+                kwargs["connection_string"] = kwargs["host"]
+            except KeyError:
+                raise TypeError("Must define 'connection_string' for ado connections")
+    if expand_macros:
+        for kwarg in list(kwargs.keys()):
+            if kwarg.startswith("macro_"):  # If a key defines a macro
+                macro_name = kwarg[6:]  # name without the "macro_"
+                macro_code = kwargs.pop(
+                    kwarg
+                )  # we remove the macro_key and get the code to execute
+                new_key, rslt = macro_call(
+                    macro_name, macro_code, kwargs
+                )  # run the code in the local context
+                kwargs[new_key] = rslt  # put the result back in the keywords dict
+    # special processing for PyRO IPv6 host address
+    try:
+        s = kwargs["proxy_host"]
+        if ":" in s:  # it is an IPv6 address
+            if s[0] != "[":  # is not surrounded by brackets
+                kwargs["proxy_host"] = s.join(("[", "]"))  # put it in brackets
+    except KeyError:
+        pass
+    return kwargs
diff --git a/lib/adodbapi/readme.txt b/lib/adodbapi/readme.txt
new file mode 100644
index 00000000..cf591905
--- /dev/null
+++ b/lib/adodbapi/readme.txt
@@ -0,0 +1,92 @@
+Project
+-------
+adodbapi
+
+A Python DB-API 2.0 (PEP-249) module that makes it easy to use Microsoft ADO 
+for connecting with databases and other data sources
+using either CPython or IronPython.
+
+Home page: <http://sourceforge.net/projects/adodbapi>
+
+Features:
+* 100% DB-API 2.0 (PEP-249) compliant (including most extensions and recommendations).
+* Includes pyunit testcases that describe how to use the module.  
+* Fully implemented in Python. -- runs in Python 2.5+ Python 3.0+ and IronPython 2.6+
+* Licensed under the LGPL license, which means that it can be used freely even in commercial programs subject to certain restrictions. 
+* The user can choose between paramstyles: 'qmark' 'named' 'format' 'pyformat' 'dynamic'
+* Supports data retrieval by column name e.g.:
+  for row in myCurser.execute("select name,age from students"):
+     print("Student", row.name, "is", row.age, "years old.")
+* Supports user-definable system-to-Python data conversion functions (selected by ADO data type, or by column)
+
+Prerequisites:
+* C Python 2.7 or 3.5 or higher
+ and pywin32 (Mark Hammond's python for windows extensions.)
+or
+ Iron Python 2.7 or higher.  (works in IPy2.0 for all data types except BUFFER)
+
+Installation:
+* (C-Python on Windows): Install pywin32 ("pip install pywin32") which includes adodbapi.
+* (IronPython on Windows): Download adodbapi from http://sf.net/projects/adodbapi.  Unpack the zip.
+     Open a command window as an administrator. CD to the folder containing the unzipped files.
+     Run "setup.py install" using the IronPython of your choice.
+
+NOTE: ...........
+If you do not like the new default operation of returning Numeric columns as decimal.Decimal,
+you can select other options by the user defined conversion feature. 
+Try:
+        adodbapi.apibase.variantConversions[adodbapi.ado_consts.adNumeric] = adodbapi.apibase.cvtString
+or:
+        adodbapi.apibase.variantConversions[adodbapi.ado_consts.adNumeric] = adodbapi.apibase.cvtFloat
+or:
+        adodbapi.apibase.variantConversions[adodbapi.ado_consts.adNumeric] = write_your_own_convertion_function
+		............
+notes for 2.6.2:
+    The definitive source has been moved to https://github.com/mhammond/pywin32/tree/master/adodbapi.
+    Remote has proven too hard to configure and test with Pyro4. I am moving it to unsupported status
+    until I can change to a different connection method.
+whats new in version 2.6
+   A cursor.prepare() method and support for prepared SQL statements.
+   Lots of refactoring, especially of the Remote and Server modules (still to be treated as Beta code).
+   The quick start document 'quick_reference.odt' will export as a nice-looking pdf.
+   Added paramstyles 'pyformat' and 'dynamic'. If your 'paramstyle' is 'named' you _must_ pass a dictionary of
+      parameters to your .execute() method. If your 'paramstyle' is 'format' 'pyformat' or 'dynamic', you _may_
+      pass a dictionary of parameters -- provided your SQL operation string is formatted correctly.
+
+whats new in version 2.5
+   Remote module: (works on Linux!) allows a Windows computer to serve ADO databases via PyRO
+   Server module: PyRO server for ADO.  Run using a command like= C:>python -m adodbapi.server
+   (server has simple connection string macros: is64bit, getuser, sql_provider, auto_security)
+   Brief documentation included.  See adodbapi/examples folder adodbapi.rtf
+   New connection method conn.get_table_names() --> list of names of tables in database
+
+   Vastly refactored. Data conversion things have been moved to the new adodbapi.apibase module.
+   Many former module-level attributes are now class attributes. (Should be more thread-safe)
+   Connection objects are now context managers for transactions and will commit or rollback.
+   Cursor objects are context managers and will automatically close themselves.
+   Autocommit can be switched on and off.
+   Keyword and positional arguments on the connect() method work as documented in PEP 249.
+   Keyword arguments from the connect call can be formatted into the connection string.
+   New keyword arguments defined, such as: autocommit, paramstyle, remote_proxy, remote_port.
+  *** Breaking change: variantConversion lookups are simplified: the following will raise KeyError:
+         oldconverter=adodbapi.variantConversions[adodbapi.adoStringTypes]
+      Refactor as: oldconverter=adodbapi.variantConversions[adodbapi.adoStringTypes[0]]
+
+License
+-------
+LGPL, see http://www.opensource.org/licenses/lgpl-license.php
+
+Documentation
+-------------
+
+Look at adodbapi/quick_reference.md
+http://www.python.org/topics/database/DatabaseAPI-2.0.html
+read the examples in adodbapi/examples
+and look at the test cases in adodbapi/test directory.
+
+Mailing lists
+-------------
+The adodbapi mailing lists have been deactivated. Submit comments to the 
+pywin32 or IronPython mailing lists.
+  -- the bug tracker on sourceforge.net/projects/adodbapi may be checked, (infrequently).
+  -- please use: https://github.com/mhammond/pywin32/issues
diff --git a/lib/adodbapi/remote.py b/lib/adodbapi/remote.py
new file mode 100644
index 00000000..ae22b5a7
--- /dev/null
+++ b/lib/adodbapi/remote.py
@@ -0,0 +1,634 @@
+"""adodbapi.remote - A python DB API 2.0 (PEP 249) interface to Microsoft ADO
+
+Copyright (C) 2002 Henrik Ekelund, version 2.1 by Vernon Cole
+* http://sourceforge.net/projects/pywin32
+* http://sourceforge.net/projects/adodbapi
+
+    This library is free software; you can redistribute it and/or
+    modify it under the terms of the GNU Lesser General Public
+    License as published by the Free Software Foundation; either
+    version 2.1 of the License, or (at your option) any later version.
+
+    This library is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+    Lesser General Public License for more details.
+
+    You should have received a copy of the GNU Lesser General Public
+    License along with this library; if not, write to the Free Software
+    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+
+    django adaptations and refactoring thanks to Adam Vandenberg
+
+DB-API 2.0 specification: http://www.python.org/dev/peps/pep-0249/
+
+This module source should run correctly in CPython versions 2.5 and later,
+or IronPython version 2.7 and later,
+or, after running through 2to3.py, CPython 3.0 or later.
+"""
+
+__version__ = "2.6.0.4"
+version = "adodbapi.remote v" + __version__
+
+import array
+import datetime
+import os
+import sys
+import time
+
+# Pyro4 is required for server and remote operation --> https://pypi.python.org/pypi/Pyro4/
+try:
+    import Pyro4
+except ImportError:
+    print('* * * Sorry, server operation requires Pyro4. Please "pip import" it.')
+    exit(11)
+
+import adodbapi
+import adodbapi.apibase as api
+import adodbapi.process_connect_string
+from adodbapi.apibase import ProgrammingError
+
+_BaseException = api._BaseException
+
+sys.excepthook = Pyro4.util.excepthook
+Pyro4.config.PREFER_IP_VERSION = 0  # allow system to prefer IPv6
+Pyro4.config.COMMTIMEOUT = 40.0  # a bit longer than the default SQL server Gtimeout
+Pyro4.config.SERIALIZER = "pickle"
+
+try:
+    verbose = int(os.environ["ADODBAPI_VERBOSE"])
+except:
+    verbose = False
+if verbose:
+    print(version)
+
+# --- define objects to smooth out Python3 <-> Python 2.x differences
+unicodeType = str  # this line will be altered by 2to3.py to '= str'
+longType = int  # this line will be altered by 2to3.py to '= int'
+StringTypes = str
+makeByteBuffer = bytes
+memoryViewType = memoryview
+
+# -----------------------------------------------------------
+# conversion functions mandated by PEP 249
+Binary = makeByteBuffer  # override the function from apibase.py
+
+
+def Date(year, month, day):
+    return datetime.date(year, month, day)  # dateconverter.Date(year,month,day)
+
+
+def Time(hour, minute, second):
+    return datetime.time(hour, minute, second)  # dateconverter.Time(hour,minute,second)
+
+
+def Timestamp(year, month, day, hour, minute, second):
+    return datetime.datetime(year, month, day, hour, minute, second)
+
+
+def DateFromTicks(ticks):
+    return Date(*time.gmtime(ticks)[:3])
+
+
+def TimeFromTicks(ticks):
+    return Time(*time.gmtime(ticks)[3:6])
+
+
+def TimestampFromTicks(ticks):
+    return Timestamp(*time.gmtime(ticks)[:6])
+
+
+def connect(*args, **kwargs):  # --> a remote db-api connection object
+    """Create and open a remote db-api database connection object"""
+    # process the argument list the programmer gave us
+    kwargs = adodbapi.process_connect_string.process(args, kwargs)
+    # the "proxy_xxx" keys tell us where to find the PyRO proxy server
+    kwargs.setdefault(
+        "pyro_connection", "PYRO:ado.connection@%(proxy_host)s:%(proxy_port)s"
+    )
+    if not "proxy_port" in kwargs:
+        try:
+            pport = os.environ["PROXY_PORT"]
+        except KeyError:
+            pport = 9099
+        kwargs["proxy_port"] = pport
+    if not "proxy_host" in kwargs or not kwargs["proxy_host"]:
+        try:
+            phost = os.environ["PROXY_HOST"]
+        except KeyError:
+            phost = "[::1]"  # '127.0.0.1'
+        kwargs["proxy_host"] = phost
+    ado_uri = kwargs["pyro_connection"] % kwargs
+    # ask PyRO make us a remote connection object
+    auto_retry = 3
+    while auto_retry:
+        try:
+            dispatcher = Pyro4.Proxy(ado_uri)
+            if "comm_timeout" in kwargs:
+                dispatcher._pyroTimeout = float(kwargs["comm_timeout"])
+            uri = dispatcher.make_connection()
+            break
+        except Pyro4.core.errors.PyroError:
+            auto_retry -= 1
+            if auto_retry:
+                time.sleep(1)
+            else:
+                raise api.DatabaseError("Cannot create connection to=%s" % ado_uri)
+
+    conn_uri = fix_uri(uri, kwargs)  # get a host connection from the proxy server
+    while auto_retry:
+        try:
+            host_conn = Pyro4.Proxy(
+                conn_uri
+            )  # bring up an exclusive Pyro connection for my ADO connection
+            break
+        except Pyro4.core.errors.PyroError:
+            auto_retry -= 1
+            if auto_retry:
+                time.sleep(1)
+            else:
+                raise api.DatabaseError(
+                    "Cannot create ADO connection object using=%s" % conn_uri
+                )
+    if "comm_timeout" in kwargs:
+        host_conn._pyroTimeout = float(kwargs["comm_timeout"])
+    # make a local clone
+    myConn = Connection()
+    while auto_retry:
+        try:
+            myConn.connect(
+                kwargs, host_conn
+            )  # call my connect method -- hand him the host connection
+            break
+        except Pyro4.core.errors.PyroError:
+            auto_retry -= 1
+            if auto_retry:
+                time.sleep(1)
+            else:
+                raise api.DatabaseError(
+                    "Pyro error creating connection to/thru=%s" % repr(kwargs)
+                )
+        except _BaseException as e:
+            raise api.DatabaseError(
+                "Error creating remote connection to=%s, e=%s, %s"
+                % (repr(kwargs), repr(e), sys.exc_info()[2])
+            )
+    return myConn
+
+
+def fix_uri(uri, kwargs):
+    """convert a generic pyro uri with '0.0.0.0' into the address we actually called"""
+    u = uri.asString()
+    s = u.split("[::0]")  # IPv6 generic address
+    if len(s) == 1:  # did not find one
+        s = u.split("0.0.0.0")  # IPv4 generic address
+    if len(s) > 1:  # found a generic
+        return kwargs["proxy_host"].join(s)  # fill in our address for the host
+    return uri
+
+
+# # # # # ----- the Class that defines a connection ----- # # # # #
+class Connection(object):
+    # include connection attributes required by api definition.
+    Warning = api.Warning
+    Error = api.Error
+    InterfaceError = api.InterfaceError
+    DataError = api.DataError
+    DatabaseError = api.DatabaseError
+    OperationalError = api.OperationalError
+    IntegrityError = api.IntegrityError
+    InternalError = api.InternalError
+    NotSupportedError = api.NotSupportedError
+    ProgrammingError = api.ProgrammingError
+    # set up some class attributes
+    paramstyle = api.paramstyle
+
+    @property
+    def dbapi(self):  # a proposed db-api version 3 extension.
+        "Return a reference to the DBAPI module for this Connection."
+        return api
+
+    def __init__(self):
+        self.proxy = None
+        self.kwargs = {}
+        self.errorhandler = None
+        self.supportsTransactions = False
+        self.paramstyle = api.paramstyle
+        self.timeout = 30
+        self.cursors = {}
+
+    def connect(self, kwargs, connection_maker):
+        self.kwargs = kwargs
+        if verbose:
+            print('%s attempting: "%s"' % (version, repr(kwargs)))
+        self.proxy = connection_maker
+        ##try:
+        ret = self.proxy.connect(kwargs)  # ask the server to hook us up
+        ##except ImportError, e:   # Pyro is trying to import pywinTypes.comerrer
+        ##    self._raiseConnectionError(api.DatabaseError, 'Proxy cannot connect using=%s' % repr(kwargs))
+        if ret is not True:
+            self._raiseConnectionError(
+                api.OperationalError, "Proxy returns error message=%s" % repr(ret)
+            )
+
+        self.supportsTransactions = self.getIndexedValue("supportsTransactions")
+        self.paramstyle = self.getIndexedValue("paramstyle")
+        self.timeout = self.getIndexedValue("timeout")
+        if verbose:
+            print("adodbapi.remote New connection at %X" % id(self))
+
+    def _raiseConnectionError(self, errorclass, errorvalue):
+        eh = self.errorhandler
+        if eh is None:
+            eh = api.standardErrorHandler
+        eh(self, None, errorclass, errorvalue)
+
+    def close(self):
+        """Close the connection now (rather than whenever __del__ is called).
+
+        The connection will be unusable from this point forward;
+        an Error (or subclass) exception will be raised if any operation is attempted with the connection.
+        The same applies to all cursor objects trying to use the connection.
+        """
+        for crsr in list(self.cursors.values())[
+            :
+        ]:  # copy the list, then close each one
+            crsr.close()
+        try:
+            """close the underlying remote Connection object"""
+            self.proxy.close()
+            if verbose:
+                print("adodbapi.remote Closed connection at %X" % id(self))
+            object.__delattr__(
+                self, "proxy"
+            )  # future attempts to use closed cursor will be caught by __getattr__
+        except Exception:
+            pass
+
+    def __del__(self):
+        try:
+            self.proxy.close()
+        except:
+            pass
+
+    def commit(self):
+        """Commit any pending transaction to the database.
+
+        Note that if the database supports an auto-commit feature,
+        this must be initially off. An interface method may be provided to turn it back on.
+        Database modules that do not support transactions should implement this method with void functionality.
+        """
+        if not self.supportsTransactions:
+            return
+        result = self.proxy.commit()
+        if result:
+            self._raiseConnectionError(
+                api.OperationalError, "Error during commit: %s" % result
+            )
+
+    def _rollback(self):
+        """In case a database does provide transactions this method causes the the database to roll back to
+        the start of any pending transaction. Closing a connection without committing the changes first will
+        cause an implicit rollback to be performed.
+        """
+        result = self.proxy.rollback()
+        if result:
+            self._raiseConnectionError(
+                api.OperationalError, "Error during rollback: %s" % result
+            )
+
+    def __setattr__(self, name, value):
+        if name in ("paramstyle", "timeout", "autocommit"):
+            if self.proxy:
+                self.proxy.send_attribute_to_host(name, value)
+        object.__setattr__(self, name, value)  # store attribute locally (too)
+
+    def __getattr__(self, item):
+        if (
+            item == "rollback"
+        ):  # the rollback method only appears if the database supports transactions
+            if self.supportsTransactions:
+                return (
+                    self._rollback
+                )  # return the rollback method so the caller can execute it.
+            else:
+                raise self.ProgrammingError(
+                    "this data provider does not support Rollback"
+                )
+        elif item in (
+            "dbms_name",
+            "dbms_version",
+            "connection_string",
+            "autocommit",
+        ):  # 'messages' ):
+            return self.getIndexedValue(item)
+        elif item == "proxy":
+            raise self.ProgrammingError("Attempting to use closed connection")
+        else:
+            raise self.ProgrammingError('No remote access for attribute="%s"' % item)
+
+    def getIndexedValue(self, index):
+        r = self.proxy.get_attribute_for_remote(index)
+        return r
+
+    def cursor(self):
+        "Return a new Cursor Object using the connection."
+        myCursor = Cursor(self)
+        return myCursor
+
+    def _i_am_here(self, crsr):
+        "message from a new cursor proclaiming its existence"
+        self.cursors[crsr.id] = crsr
+
+    def _i_am_closing(self, crsr):
+        "message from a cursor giving connection a chance to clean up"
+        try:
+            del self.cursors[crsr.id]
+        except:
+            pass
+
+    def __enter__(self):  # Connections are context managers
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        if exc_type:
+            self._rollback()  # automatic rollback on errors
+        else:
+            self.commit()
+
+    def get_table_names(self):
+        return self.proxy.get_table_names()
+
+
+def fixpickle(x):
+    """pickle barfs on buffer(x) so we pass as array.array(x) then restore to original form for .execute()"""
+    if x is None:
+        return None
+    if isinstance(x, dict):
+        # for 'named' paramstyle user will pass a mapping
+        newargs = {}
+        for arg, val in list(x.items()):
+            if isinstance(val, memoryViewType):
+                newval = array.array("B")
+                newval.fromstring(val)
+                newargs[arg] = newval
+            else:
+                newargs[arg] = val
+        return newargs
+    # if not a mapping, then a sequence
+    newargs = []
+    for arg in x:
+        if isinstance(arg, memoryViewType):
+            newarg = array.array("B")
+            newarg.fromstring(arg)
+            newargs.append(newarg)
+        else:
+            newargs.append(arg)
+    return newargs
+
+
+class Cursor(object):
+    def __init__(self, connection):
+        self.command = None
+        self.errorhandler = None  ## was: connection.errorhandler
+        self.connection = connection
+        self.proxy = self.connection.proxy
+        self.rs = None  # the fetchable data for this cursor
+        self.converters = NotImplemented
+        self.id = connection.proxy.build_cursor()
+        connection._i_am_here(self)
+        self.recordset_format = api.RS_REMOTE
+        if verbose:
+            print(
+                "%s New cursor at %X on conn %X"
+                % (version, id(self), id(self.connection))
+            )
+
+    def prepare(self, operation):
+        self.command = operation
+        try:
+            del self.description
+        except AttributeError:
+            pass
+        self.proxy.crsr_prepare(self.id, operation)
+
+    def __iter__(self):  # [2.1 Zamarev]
+        return iter(self.fetchone, None)  # [2.1 Zamarev]
+
+    def __next__(self):
+        r = self.fetchone()
+        if r:
+            return r
+        raise StopIteration
+
+    def __enter__(self):
+        "Allow database cursors to be used with context managers."
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        "Allow database cursors to be used with context managers."
+        self.close()
+
+    def __getattr__(self, key):
+        if key == "numberOfColumns":
+            try:
+                return len(self.rs[0])
+            except:
+                return 0
+        if key == "description":
+            try:
+                self.description = self.proxy.crsr_get_description(self.id)[:]
+                return self.description
+            except TypeError:
+                return None
+        if key == "columnNames":
+            try:
+                r = dict(
+                    self.proxy.crsr_get_columnNames(self.id)
+                )  # copy the remote columns
+
+            except TypeError:
+                r = {}
+            self.columnNames = r
+            return r
+
+        if key == "remote_cursor":
+            raise api.OperationalError
+        try:
+            return self.proxy.crsr_get_attribute_for_remote(self.id, key)
+        except AttributeError:
+            raise api.InternalError(
+                'Failure getting attribute "%s" from proxy cursor.' % key
+            )
+
+    def __setattr__(self, key, value):
+        if key == "arraysize":
+            self.proxy.crsr_set_arraysize(self.id, value)
+        if key == "paramstyle":
+            if value in api.accepted_paramstyles:
+                self.proxy.crsr_set_paramstyle(self.id, value)
+            else:
+                self._raiseCursorError(
+                    api.ProgrammingError, 'invalid paramstyle ="%s"' % value
+                )
+        object.__setattr__(self, key, value)
+
+    def _raiseCursorError(self, errorclass, errorvalue):
+        eh = self.errorhandler
+        if eh is None:
+            eh = api.standardErrorHandler
+        eh(self.connection, self, errorclass, errorvalue)
+
+    def execute(self, operation, parameters=None):
+        if self.connection is None:
+            self._raiseCursorError(
+                ProgrammingError, "Attempted operation on closed cursor"
+            )
+        self.command = operation
+        try:
+            del self.description
+        except AttributeError:
+            pass
+        try:
+            del self.columnNames
+        except AttributeError:
+            pass
+        fp = fixpickle(parameters)
+        if verbose > 2:
+            print(
+                (
+                    '%s executing "%s" with params=%s'
+                    % (version, operation, repr(parameters))
+                )
+            )
+        result = self.proxy.crsr_execute(self.id, operation, fp)
+        if result:  # an exception was triggered
+            self._raiseCursorError(result[0], result[1])
+
+    def executemany(self, operation, seq_of_parameters):
+        if self.connection is None:
+            self._raiseCursorError(
+                ProgrammingError, "Attempted operation on closed cursor"
+            )
+        self.command = operation
+        try:
+            del self.description
+        except AttributeError:
+            pass
+        try:
+            del self.columnNames
+        except AttributeError:
+            pass
+        sq = [fixpickle(x) for x in seq_of_parameters]
+        if verbose > 2:
+            print(
+                (
+                    '%s executemany "%s" with params=%s'
+                    % (version, operation, repr(seq_of_parameters))
+                )
+            )
+        self.proxy.crsr_executemany(self.id, operation, sq)
+
+    def nextset(self):
+        try:
+            del self.description
+        except AttributeError:
+            pass
+        try:
+            del self.columnNames
+        except AttributeError:
+            pass
+        if verbose > 2:
+            print(("%s nextset" % version))
+        return self.proxy.crsr_nextset(self.id)
+
+    def callproc(self, procname, parameters=None):
+        if self.connection is None:
+            self._raiseCursorError(
+                ProgrammingError, "Attempted operation on closed cursor"
+            )
+        self.command = procname
+        try:
+            del self.description
+        except AttributeError:
+            pass
+        try:
+            del self.columnNames
+        except AttributeError:
+            pass
+        fp = fixpickle(parameters)
+        if verbose > 2:
+            print(
+                (
+                    '%s callproc "%s" with params=%s'
+                    % (version, procname, repr(parameters))
+                )
+            )
+        return self.proxy.crsr_callproc(self.id, procname, fp)
+
+    def fetchone(self):
+        try:
+            f1 = self.proxy.crsr_fetchone(self.id)
+        except _BaseException as e:
+            self._raiseCursorError(api.DatabaseError, e)
+        else:
+            if f1 is None:
+                return None
+            self.rs = [f1]
+            return api.SQLrows(self.rs, 1, self)[
+                0
+            ]  # new object to hold the results of the fetch
+
+    def fetchmany(self, size=None):
+        try:
+            self.rs = self.proxy.crsr_fetchmany(self.id, size)
+            if not self.rs:
+                return []
+            r = api.SQLrows(self.rs, len(self.rs), self)
+            return r
+        except Exception as e:
+            self._raiseCursorError(api.DatabaseError, e)
+
+    def fetchall(self):
+        try:
+            self.rs = self.proxy.crsr_fetchall(self.id)
+            if not self.rs:
+                return []
+            return api.SQLrows(self.rs, len(self.rs), self)
+        except Exception as e:
+            self._raiseCursorError(api.DatabaseError, e)
+
+    def close(self):
+        if self.connection is None:
+            return
+        self.connection._i_am_closing(self)  # take me off the connection's cursors list
+        try:
+            self.proxy.crsr_close(self.id)
+        except:
+            pass
+        try:
+            del self.description
+        except:
+            pass
+        try:
+            del self.rs  # let go of the recordset
+        except:
+            pass
+        self.connection = (
+            None  # this will make all future method calls on me throw an exception
+        )
+        self.proxy = None
+        if verbose:
+            print("adodbapi.remote Closed cursor at %X" % id(self))
+
+    def __del__(self):
+        try:
+            self.close()
+        except:
+            pass
+
+    def setinputsizes(self, sizes):
+        pass
+
+    def setoutputsize(self, size, column=None):
+        pass
diff --git a/lib/adodbapi/schema_table.py b/lib/adodbapi/schema_table.py
new file mode 100644
index 00000000..8621830e
--- /dev/null
+++ b/lib/adodbapi/schema_table.py
@@ -0,0 +1,15 @@
+"""call using an open ADO connection --> list of table names"""
+from . import adodbapi
+
+
+def names(connection_object):
+    ado = connection_object.adoConn
+    schema = ado.OpenSchema(20)  # constant = adSchemaTables
+
+    tables = []
+    while not schema.EOF:
+        name = adodbapi.getIndexedValue(schema.Fields, "TABLE_NAME").Value
+        tables.append(name)
+        schema.MoveNext()
+    del schema
+    return tables
diff --git a/lib/adodbapi/setup.py b/lib/adodbapi/setup.py
new file mode 100644
index 00000000..d25869ad
--- /dev/null
+++ b/lib/adodbapi/setup.py
@@ -0,0 +1,70 @@
+"""adodbapi -- a pure Python PEP 249 DB-API package using Microsoft ADO
+
+Adodbapi can be run on CPython 3.5 and later.
+or IronPython version 2.6 and later (in theory, possibly no longer in practice!)
+"""
+CLASSIFIERS = """\
+Development Status :: 5 - Production/Stable
+Intended Audience :: Developers
+License :: OSI Approved :: GNU Library or Lesser General Public License (LGPL)
+Operating System :: Microsoft :: Windows
+Operating System :: POSIX :: Linux
+Programming Language :: Python
+Programming Language :: Python :: 3
+Programming Language :: SQL
+Topic :: Software Development
+Topic :: Software Development :: Libraries :: Python Modules
+Topic :: Database
+"""
+
+NAME = "adodbapi"
+MAINTAINER = "Vernon Cole"
+MAINTAINER_EMAIL = "vernondcole@gmail.com"
+DESCRIPTION = (
+    """A pure Python package implementing PEP 249 DB-API using Microsoft ADO."""
+)
+URL = "http://sourceforge.net/projects/adodbapi"
+LICENSE = "LGPL"
+CLASSIFIERS = filter(None, CLASSIFIERS.split("\n"))
+AUTHOR = "Henrik Ekelund, Vernon Cole, et.al."
+AUTHOR_EMAIL = "vernondcole@gmail.com"
+PLATFORMS = ["Windows", "Linux"]
+
+VERSION = None  # in case searching for version fails
+a = open("adodbapi.py")  # find the version string in the source code
+for line in a:
+    if "__version__" in line:
+        VERSION = line.split("'")[1]
+        print('adodbapi version="%s"' % VERSION)
+        break
+a.close()
+
+
+def setup_package():
+    from distutils.command.build_py import build_py
+    from distutils.core import setup
+
+    setup(
+        cmdclass={"build_py": build_py},
+        name=NAME,
+        maintainer=MAINTAINER,
+        maintainer_email=MAINTAINER_EMAIL,
+        description=DESCRIPTION,
+        url=URL,
+        keywords="database ado odbc dbapi db-api Microsoft SQL",
+        ##        download_url=DOWNLOAD_URL,
+        long_description=open("README.txt").read(),
+        license=LICENSE,
+        classifiers=CLASSIFIERS,
+        author=AUTHOR,
+        author_email=AUTHOR_EMAIL,
+        platforms=PLATFORMS,
+        version=VERSION,
+        package_dir={"adodbapi": ""},
+        packages=["adodbapi"],
+    )
+    return
+
+
+if __name__ == "__main__":
+    setup_package()
diff --git a/lib/adodbapi/test/adodbapitest.py b/lib/adodbapi/test/adodbapitest.py
new file mode 100644
index 00000000..e5b3dc19
--- /dev/null
+++ b/lib/adodbapi/test/adodbapitest.py
@@ -0,0 +1,1692 @@
+""" Unit tests version 2.6.1.0 for adodbapi"""
+"""
+    adodbapi - A python DB API 2.0 interface to Microsoft ADO
+
+    Copyright (C) 2002  Henrik Ekelund
+
+    This library is free software; you can redistribute it and/or
+    modify it under the terms of the GNU Lesser General Public
+    License as published by the Free Software Foundation; either
+    version 2.1 of the License, or (at your option) any later version.
+
+    This library is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+    Lesser General Public License for more details.
+
+    You should have received a copy of the GNU Lesser General Public
+    License along with this library; if not, write to the Free Software
+    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+
+    Updates by Vernon Cole
+"""
+
+import copy
+import datetime
+import decimal
+import random
+import string
+import sys
+import unittest
+
+try:
+    import win32com.client
+
+    win32 = True
+except ImportError:
+    win32 = False
+
+# run the configuration module.
+import adodbapitestconfig as config  # will set sys.path to find correct version of adodbapi
+
+# in our code below, all our switches are from config.whatever
+import tryconnection
+
+import adodbapi
+import adodbapi.apibase as api
+
+try:
+    import adodbapi.ado_consts as ado_consts
+except ImportError:  # we are doing a shortcut import as a module -- so
+    try:
+        import ado_consts
+    except ImportError:
+        from adodbapi import ado_consts
+
+
+def str2bytes(sval):
+    return sval.encode("latin1")
+
+
+long = int
+
+
+def randomstring(length):
+    return "".join([random.choice(string.ascii_letters) for n in range(32)])
+
+
+class CommonDBTests(unittest.TestCase):
+    "Self contained super-simple tests in easy syntax, should work on everything between mySQL and Oracle"
+
+    def setUp(self):
+        self.engine = "unknown"
+
+    def getEngine(self):
+        return self.engine
+
+    def getConnection(self):
+        raise NotImplementedError  # "This method must be overriden by a subclass"
+
+    def getCursor(self):
+        return self.getConnection().cursor()
+
+    def testConnection(self):
+        crsr = self.getCursor()
+        assert crsr.__class__.__name__ == "Cursor"
+
+    def testErrorHandlerInherits(self):
+        if not self.remote:
+            conn = self.getConnection()
+            mycallable = lambda connection, cursor, errorclass, errorvalue: 1
+            conn.errorhandler = mycallable
+            crsr = conn.cursor()
+            assert (
+                crsr.errorhandler == mycallable
+            ), "Error handler on crsr should be same as on connection"
+
+    def testDefaultErrorHandlerConnection(self):
+        if not self.remote:
+            conn = self.getConnection()
+            del conn.messages[:]
+            try:
+                conn.close()
+                conn.commit()  # Should not be able to use connection after it is closed
+            except:
+                assert len(conn.messages) == 1
+                assert len(conn.messages[0]) == 2
+                assert conn.messages[0][0] == api.ProgrammingError
+
+    def testOwnErrorHandlerConnection(self):
+        if self.remote:  # ToDo: use "skip"
+            return
+        mycallable = (
+            lambda connection, cursor, errorclass, errorvalue: 1
+        )  # does not raise anything
+        conn = self.getConnection()
+        conn.errorhandler = mycallable
+        conn.close()
+        conn.commit()  # Should not be able to use connection after it is closed
+        assert len(conn.messages) == 0
+
+        conn.errorhandler = None  # This should bring back the standard error handler
+        try:
+            conn.close()
+            conn.commit()  # Should not be able to use connection after it is closed
+        except:
+            pass
+        # The Standard errorhandler appends error to messages attribute
+        assert (
+            len(conn.messages) > 0
+        ), "Setting errorhandler to none  should bring back the standard error handler"
+
+    def testDefaultErrorHandlerCursor(self):
+        crsr = self.getConnection().cursor()
+        if not self.remote:
+            del crsr.messages[:]
+            try:
+                crsr.execute("SELECT abbtytddrf FROM dasdasd")
+            except:
+                assert len(crsr.messages) == 1
+                assert len(crsr.messages[0]) == 2
+                assert crsr.messages[0][0] == api.DatabaseError
+
+    def testOwnErrorHandlerCursor(self):
+        if self.remote:  # ToDo: should be a "skip"
+            return
+        mycallable = (
+            lambda connection, cursor, errorclass, errorvalue: 1
+        )  # does not raise anything
+        crsr = self.getConnection().cursor()
+        crsr.errorhandler = mycallable
+        crsr.execute("SELECT abbtytddrf FROM dasdasd")
+        assert len(crsr.messages) == 0
+
+        crsr.errorhandler = None  # This should bring back the standard error handler
+        try:
+            crsr.execute("SELECT abbtytddrf FROM dasdasd")
+        except:
+            pass
+        # The Standard errorhandler appends error to messages attribute
+        assert (
+            len(crsr.messages) > 0
+        ), "Setting errorhandler to none  should bring back the standard error handler"
+
+    def testUserDefinedConversions(self):
+        if self.remote:  ## Todo: should be a "skip"
+            return
+        try:
+            duplicatingConverter = lambda aStringField: aStringField * 2
+            assert duplicatingConverter("gabba") == "gabbagabba"
+
+            self.helpForceDropOnTblTemp()
+            conn = self.getConnection()
+            # the variantConversions attribute should not exist on a normal connection object
+            self.assertRaises(AttributeError, lambda x: conn.variantConversions[x], [2])
+            if not self.remote:
+                # create a variantConversions attribute on the connection
+                conn.variantConversions = copy.copy(api.variantConversions)
+                crsr = conn.cursor()
+                tabdef = (
+                    "CREATE TABLE xx_%s (fldData VARCHAR(100) NOT NULL, fld2 VARCHAR(20))"
+                    % config.tmp
+                )
+                crsr.execute(tabdef)
+                crsr.execute(
+                    "INSERT INTO xx_%s(fldData,fld2) VALUES('gabba','booga')"
+                    % config.tmp
+                )
+                crsr.execute(
+                    "INSERT INTO xx_%s(fldData,fld2) VALUES('hey','yo')" % config.tmp
+                )
+                # change converter for ALL adoStringTypes columns
+                conn.variantConversions[api.adoStringTypes] = duplicatingConverter
+                crsr.execute(
+                    "SELECT fldData,fld2 FROM xx_%s ORDER BY fldData" % config.tmp
+                )
+
+                rows = crsr.fetchall()
+                row = rows[0]
+                self.assertEqual(row[0], "gabbagabba")
+                row = rows[1]
+                self.assertEqual(row[0], "heyhey")
+                self.assertEqual(row[1], "yoyo")
+
+                upcaseConverter = lambda aStringField: aStringField.upper()
+                assert upcaseConverter("upThis") == "UPTHIS"
+
+                # now use a single column converter
+                rows.converters[1] = upcaseConverter  # convert second column
+                self.assertEqual(row[0], "heyhey")  # first will be unchanged
+                self.assertEqual(row[1], "YO")  # second will convert to upper case
+
+        finally:
+            try:
+                del conn.variantConversions  # Restore the default
+            except:
+                pass
+            self.helpRollbackTblTemp()
+
+    def testUserDefinedConversionForExactNumericTypes(self):
+        # variantConversions is a dictionary of conversion functions
+        # held internally in adodbapi.apibase
+        #
+        # !!! this test intentionally alters the value of what should be constant in the module
+        # !!! no new code should use this example, to is only a test to see that the
+        # !!! deprecated way of doing this still works.  (use connection.variantConversions)
+        #
+        if not self.remote and sys.version_info < (3, 0):  ### Py3 need different test
+            oldconverter = adodbapi.variantConversions[
+                ado_consts.adNumeric
+            ]  # keep old function to restore later
+            # By default decimal and "numbers" are returned as decimals.
+            # Instead, make numbers return as  floats
+            try:
+                adodbapi.variantConversions[ado_consts.adNumeric] = adodbapi.cvtFloat
+                self.helpTestDataType(
+                    "decimal(18,2)", "NUMBER", 3.45, compareAlmostEqual=1
+                )
+                self.helpTestDataType(
+                    "numeric(18,2)", "NUMBER", 3.45, compareAlmostEqual=1
+                )
+                # now return strings
+                adodbapi.variantConversions[ado_consts.adNumeric] = adodbapi.cvtString
+                self.helpTestDataType("numeric(18,2)", "NUMBER", "3.45")
+                # now a completly weird user defined convertion
+                adodbapi.variantConversions[ado_consts.adNumeric] = (
+                    lambda x: "!!This function returns a funny unicode string %s!!" % x
+                )
+                self.helpTestDataType(
+                    "numeric(18,2)",
+                    "NUMBER",
+                    "3.45",
+                    allowedReturnValues=[
+                        "!!This function returns a funny unicode string 3.45!!"
+                    ],
+                )
+            finally:
+                # now reset the converter to its original function
+                adodbapi.variantConversions[
+                    ado_consts.adNumeric
+                ] = oldconverter  # Restore the original convertion function
+
+    def helpTestDataType(
+        self,
+        sqlDataTypeString,
+        DBAPIDataTypeString,
+        pyData,
+        pyDataInputAlternatives=None,
+        compareAlmostEqual=None,
+        allowedReturnValues=None,
+    ):
+        self.helpForceDropOnTblTemp()
+        conn = self.getConnection()
+        crsr = conn.cursor()
+        tabdef = (
+            """
+            CREATE TABLE xx_%s (
+                fldId integer NOT NULL,
+                fldData """
+            % config.tmp
+            + sqlDataTypeString
+            + ")\n"
+        )
+
+        crsr.execute(tabdef)
+
+        # Test Null values mapped to None
+        crsr.execute("INSERT INTO xx_%s (fldId) VALUES (1)" % config.tmp)
+
+        crsr.execute("SELECT fldId,fldData FROM xx_%s" % config.tmp)
+        rs = crsr.fetchone()
+        self.assertEqual(rs[1], None)  # Null should be mapped to None
+        assert rs[0] == 1
+
+        # Test description related
+        descTuple = crsr.description[1]
+        assert descTuple[0] in ["fldData", "flddata"], 'was "%s" expected "%s"' % (
+            descTuple[0],
+            "fldData",
+        )
+
+        if DBAPIDataTypeString == "STRING":
+            assert descTuple[1] == api.STRING, 'was "%s" expected "%s"' % (
+                descTuple[1],
+                api.STRING.values,
+            )
+        elif DBAPIDataTypeString == "NUMBER":
+            assert descTuple[1] == api.NUMBER, 'was "%s" expected "%s"' % (
+                descTuple[1],
+                api.NUMBER.values,
+            )
+        elif DBAPIDataTypeString == "BINARY":
+            assert descTuple[1] == api.BINARY, 'was "%s" expected "%s"' % (
+                descTuple[1],
+                api.BINARY.values,
+            )
+        elif DBAPIDataTypeString == "DATETIME":
+            assert descTuple[1] == api.DATETIME, 'was "%s" expected "%s"' % (
+                descTuple[1],
+                api.DATETIME.values,
+            )
+        elif DBAPIDataTypeString == "ROWID":
+            assert descTuple[1] == api.ROWID, 'was "%s" expected "%s"' % (
+                descTuple[1],
+                api.ROWID.values,
+            )
+        elif DBAPIDataTypeString == "UUID":
+            assert descTuple[1] == api.OTHER, 'was "%s" expected "%s"' % (
+                descTuple[1],
+                api.OTHER.values,
+            )
+        else:
+            raise NotImplementedError  # "DBAPIDataTypeString not provided"
+
+        # Test data binding
+        inputs = [pyData]
+        if pyDataInputAlternatives:
+            inputs.extend(pyDataInputAlternatives)
+        inputs = set(inputs)  # removes redundant string==unicode tests
+        fldId = 1
+        for inParam in inputs:
+            fldId += 1
+            try:
+                crsr.execute(
+                    "INSERT INTO xx_%s (fldId,fldData) VALUES (?,?)" % config.tmp,
+                    (fldId, inParam),
+                )
+            except:
+                if self.remote:
+                    for message in crsr.messages:
+                        print(message)
+                else:
+                    conn.printADOerrors()
+                raise
+            crsr.execute(
+                "SELECT fldData FROM xx_%s WHERE ?=fldID" % config.tmp, [fldId]
+            )
+            rs = crsr.fetchone()
+            if allowedReturnValues:
+                allowedTypes = tuple([type(aRV) for aRV in allowedReturnValues])
+                assert isinstance(
+                    rs[0], allowedTypes
+                ), 'result type "%s" must be one of %s' % (type(rs[0]), allowedTypes)
+            else:
+                assert isinstance(
+                    rs[0], type(pyData)
+                ), 'result type "%s" must be instance of %s' % (
+                    type(rs[0]),
+                    type(pyData),
+                )
+
+            if compareAlmostEqual and DBAPIDataTypeString == "DATETIME":
+                iso1 = adodbapi.dateconverter.DateObjectToIsoFormatString(rs[0])
+                iso2 = adodbapi.dateconverter.DateObjectToIsoFormatString(pyData)
+                self.assertEqual(iso1, iso2)
+            elif compareAlmostEqual:
+                s = float(pyData)
+                v = float(rs[0])
+                assert (
+                    abs(v - s) / s < 0.00001
+                ), "Values not almost equal recvd=%s, expected=%f" % (rs[0], s)
+            else:
+                if allowedReturnValues:
+                    ok = False
+                    self.assertTrue(
+                        rs[0] in allowedReturnValues,
+                        'Value "%s" not in %s' % (repr(rs[0]), allowedReturnValues),
+                    )
+                else:
+                    self.assertEqual(
+                        rs[0],
+                        pyData,
+                        'Values are not equal recvd="%s", expected="%s"'
+                        % (rs[0], pyData),
+                    )
+
+    def testDataTypeFloat(self):
+        self.helpTestDataType("real", "NUMBER", 3.45, compareAlmostEqual=True)
+        self.helpTestDataType("float", "NUMBER", 1.79e37, compareAlmostEqual=True)
+
+    def testDataTypeDecmal(self):
+        self.helpTestDataType(
+            "decimal(18,2)",
+            "NUMBER",
+            3.45,
+            allowedReturnValues=["3.45", "3,45", decimal.Decimal("3.45")],
+        )
+        self.helpTestDataType(
+            "numeric(18,2)",
+            "NUMBER",
+            3.45,
+            allowedReturnValues=["3.45", "3,45", decimal.Decimal("3.45")],
+        )
+        self.helpTestDataType(
+            "decimal(20,2)",
+            "NUMBER",
+            444444444444444444,
+            allowedReturnValues=[
+                "444444444444444444.00",
+                "444444444444444444,00",
+                decimal.Decimal("444444444444444444"),
+            ],
+        )
+        if self.getEngine() == "MSSQL":
+            self.helpTestDataType(
+                "uniqueidentifier",
+                "UUID",
+                "{71A4F49E-39F3-42B1-A41E-48FF154996E6}",
+                allowedReturnValues=["{71A4F49E-39F3-42B1-A41E-48FF154996E6}"],
+            )
+
+    def testDataTypeMoney(self):  # v2.1 Cole -- use decimal for money
+        if self.getEngine() == "MySQL":
+            self.helpTestDataType(
+                "DECIMAL(20,4)", "NUMBER", decimal.Decimal("-922337203685477.5808")
+            )
+        elif self.getEngine() == "PostgreSQL":
+            self.helpTestDataType(
+                "money",
+                "NUMBER",
+                decimal.Decimal("-922337203685477.5808"),
+                compareAlmostEqual=True,
+                allowedReturnValues=[
+                    -922337203685477.5808,
+                    decimal.Decimal("-922337203685477.5808"),
+                ],
+            )
+        else:
+            self.helpTestDataType("smallmoney", "NUMBER", decimal.Decimal("214748.02"))
+            self.helpTestDataType(
+                "money", "NUMBER", decimal.Decimal("-922337203685477.5808")
+            )
+
+    def testDataTypeInt(self):
+        if self.getEngine() != "PostgreSQL":
+            self.helpTestDataType("tinyint", "NUMBER", 115)
+        self.helpTestDataType("smallint", "NUMBER", -32768)
+        if self.getEngine() not in ["ACCESS", "PostgreSQL"]:
+            self.helpTestDataType(
+                "bit", "NUMBER", 1
+            )  # Does not work correctly with access
+        if self.getEngine() in ["MSSQL", "PostgreSQL"]:
+            self.helpTestDataType(
+                "bigint",
+                "NUMBER",
+                3000000000,
+                allowedReturnValues=[3000000000, int(3000000000)],
+            )
+        self.helpTestDataType("int", "NUMBER", 2147483647)
+
+    def testDataTypeChar(self):
+        for sqlDataType in ("char(6)", "nchar(6)"):
+            self.helpTestDataType(
+                sqlDataType,
+                "STRING",
+                "spam  ",
+                allowedReturnValues=["spam", "spam", "spam  ", "spam  "],
+            )
+
+    def testDataTypeVarChar(self):
+        if self.getEngine() == "MySQL":
+            stringKinds = ["varchar(10)", "text"]
+        elif self.getEngine() == "PostgreSQL":
+            stringKinds = ["varchar(10)", "text", "character varying"]
+        else:
+            stringKinds = [
+                "varchar(10)",
+                "nvarchar(10)",
+                "text",
+                "ntext",
+            ]  # ,"varchar(max)"]
+
+        for sqlDataType in stringKinds:
+            self.helpTestDataType(sqlDataType, "STRING", "spam", ["spam"])
+
+    def testDataTypeDate(self):
+        if self.getEngine() == "PostgreSQL":
+            dt = "timestamp"
+        else:
+            dt = "datetime"
+        self.helpTestDataType(
+            dt, "DATETIME", adodbapi.Date(2002, 10, 28), compareAlmostEqual=True
+        )
+        if self.getEngine() not in ["MySQL", "PostgreSQL"]:
+            self.helpTestDataType(
+                "smalldatetime",
+                "DATETIME",
+                adodbapi.Date(2002, 10, 28),
+                compareAlmostEqual=True,
+            )
+        if tag != "pythontime" and self.getEngine() not in [
+            "MySQL",
+            "PostgreSQL",
+        ]:  # fails when using pythonTime
+            self.helpTestDataType(
+                dt,
+                "DATETIME",
+                adodbapi.Timestamp(2002, 10, 28, 12, 15, 1),
+                compareAlmostEqual=True,
+            )
+
+    def testDataTypeBinary(self):
+        binfld = str2bytes("\x07\x00\xE2\x40*")
+        arv = [binfld, adodbapi.Binary(binfld), bytes(binfld)]
+        if self.getEngine() == "PostgreSQL":
+            self.helpTestDataType(
+                "bytea", "BINARY", adodbapi.Binary(binfld), allowedReturnValues=arv
+            )
+        else:
+            self.helpTestDataType(
+                "binary(5)", "BINARY", adodbapi.Binary(binfld), allowedReturnValues=arv
+            )
+            self.helpTestDataType(
+                "varbinary(100)",
+                "BINARY",
+                adodbapi.Binary(binfld),
+                allowedReturnValues=arv,
+            )
+            if self.getEngine() != "MySQL":
+                self.helpTestDataType(
+                    "image", "BINARY", adodbapi.Binary(binfld), allowedReturnValues=arv
+                )
+
+    def helpRollbackTblTemp(self):
+        self.helpForceDropOnTblTemp()
+
+    def helpForceDropOnTblTemp(self):
+        conn = self.getConnection()
+        with conn.cursor() as crsr:
+            try:
+                crsr.execute("DROP TABLE xx_%s" % config.tmp)
+                if not conn.autocommit:
+                    conn.commit()
+            except:
+                pass
+
+    def helpCreateAndPopulateTableTemp(self, crsr):
+        tabdef = (
+            """
+            CREATE TABLE xx_%s (
+                fldData INTEGER
+            )
+            """
+            % config.tmp
+        )
+        try:  # EAFP
+            crsr.execute(tabdef)
+        except api.DatabaseError:  # was not dropped before
+            self.helpForceDropOnTblTemp()  # so drop it now
+            crsr.execute(tabdef)
+        for i in range(9):  # note: this poor SQL code, but a valid test
+            crsr.execute("INSERT INTO xx_%s (fldData) VALUES (%i)" % (config.tmp, i))
+            # NOTE: building the test table without using parameter substitution
+
+    def testFetchAll(self):
+        crsr = self.getCursor()
+        self.helpCreateAndPopulateTableTemp(crsr)
+        crsr.execute("SELECT fldData FROM xx_%s" % config.tmp)
+        rs = crsr.fetchall()
+        assert len(rs) == 9
+        # test slice of rows
+        i = 3
+        for row in rs[3:-2]:  # should have rowid 3..6
+            assert row[0] == i
+            i += 1
+        self.helpRollbackTblTemp()
+
+    def testPreparedStatement(self):
+        crsr = self.getCursor()
+        self.helpCreateAndPopulateTableTemp(crsr)
+        crsr.prepare("SELECT fldData FROM xx_%s" % config.tmp)
+        crsr.execute(crsr.command)  # remember the one that was prepared
+        rs = crsr.fetchall()
+        assert len(rs) == 9
+        assert rs[2][0] == 2
+        self.helpRollbackTblTemp()
+
+    def testWrongPreparedStatement(self):
+        crsr = self.getCursor()
+        self.helpCreateAndPopulateTableTemp(crsr)
+        crsr.prepare("SELECT * FROM nowhere")
+        crsr.execute(
+            "SELECT fldData FROM xx_%s" % config.tmp
+        )  # should execute this one, not the prepared one
+        rs = crsr.fetchall()
+        assert len(rs) == 9
+        assert rs[2][0] == 2
+        self.helpRollbackTblTemp()
+
+    def testIterator(self):
+        crsr = self.getCursor()
+        self.helpCreateAndPopulateTableTemp(crsr)
+        crsr.execute("SELECT fldData FROM xx_%s" % config.tmp)
+        for i, row in enumerate(
+            crsr
+        ):  # using cursor as an iterator, rather than fetchxxx
+            assert row[0] == i
+        self.helpRollbackTblTemp()
+
+    def testExecuteMany(self):
+        crsr = self.getCursor()
+        self.helpCreateAndPopulateTableTemp(crsr)
+        seq_of_values = [(111,), (222,)]
+        crsr.executemany(
+            "INSERT INTO xx_%s (fldData) VALUES (?)" % config.tmp, seq_of_values
+        )
+        if crsr.rowcount == -1:
+            print(
+                self.getEngine()
+                + " Provider does not support rowcount (on .executemany())"
+            )
+        else:
+            self.assertEqual(crsr.rowcount, 2)
+        crsr.execute("SELECT fldData FROM xx_%s" % config.tmp)
+        rs = crsr.fetchall()
+        assert len(rs) == 11
+        self.helpRollbackTblTemp()
+
+    def testRowCount(self):
+        crsr = self.getCursor()
+        self.helpCreateAndPopulateTableTemp(crsr)
+        crsr.execute("SELECT fldData FROM xx_%s" % config.tmp)
+        if crsr.rowcount == -1:
+            # print("provider does not support rowcount on select")
+            pass
+        else:
+            self.assertEqual(crsr.rowcount, 9)
+        self.helpRollbackTblTemp()
+
+    def testRowCountNoRecordset(self):
+        crsr = self.getCursor()
+        self.helpCreateAndPopulateTableTemp(crsr)
+        crsr.execute("DELETE FROM xx_%s WHERE fldData >= 5" % config.tmp)
+        if crsr.rowcount == -1:
+            print(self.getEngine() + " Provider does not support rowcount (on DELETE)")
+        else:
+            self.assertEqual(crsr.rowcount, 4)
+        self.helpRollbackTblTemp()
+
+    def testFetchMany(self):
+        crsr = self.getCursor()
+        self.helpCreateAndPopulateTableTemp(crsr)
+        crsr.execute("SELECT fldData FROM xx_%s" % config.tmp)
+        rs = crsr.fetchmany(3)
+        assert len(rs) == 3
+        rs = crsr.fetchmany(5)
+        assert len(rs) == 5
+        rs = crsr.fetchmany(5)
+        assert len(rs) == 1  # Asked for five, but there is only one left
+        self.helpRollbackTblTemp()
+
+    def testFetchManyWithArraySize(self):
+        crsr = self.getCursor()
+        self.helpCreateAndPopulateTableTemp(crsr)
+        crsr.execute("SELECT fldData FROM xx_%s" % config.tmp)
+        rs = crsr.fetchmany()
+        assert len(rs) == 1  # arraysize Defaults to one
+        crsr.arraysize = 4
+        rs = crsr.fetchmany()
+        assert len(rs) == 4
+        rs = crsr.fetchmany()
+        assert len(rs) == 4
+        rs = crsr.fetchmany()
+        assert len(rs) == 0
+        self.helpRollbackTblTemp()
+
+    def testErrorConnect(self):
+        conn = self.getConnection()
+        kw = {}
+        if "proxy_host" in conn.kwargs:
+            kw["proxy_host"] = conn.kwargs["proxy_host"]
+        conn.close()
+        self.assertRaises(api.DatabaseError, self.db, "not a valid connect string", kw)
+
+    def testRowIterator(self):
+        self.helpForceDropOnTblTemp()
+        conn = self.getConnection()
+        crsr = conn.cursor()
+        tabdef = (
+            """
+            CREATE TABLE xx_%s (
+                fldId integer NOT NULL,
+                fldTwo integer,
+                fldThree integer,
+                fldFour integer)
+                """
+            % config.tmp
+        )
+        crsr.execute(tabdef)
+
+        inputs = [(2, 3, 4), (102, 103, 104)]
+        fldId = 1
+        for inParam in inputs:
+            fldId += 1
+            try:
+                crsr.execute(
+                    "INSERT INTO xx_%s (fldId,fldTwo,fldThree,fldFour) VALUES (?,?,?,?)"
+                    % config.tmp,
+                    (fldId, inParam[0], inParam[1], inParam[2]),
+                )
+            except:
+                if self.remote:
+                    for message in crsr.messages:
+                        print(message)
+                else:
+                    conn.printADOerrors()
+                raise
+            crsr.execute(
+                "SELECT fldTwo,fldThree,fldFour FROM xx_%s WHERE ?=fldID" % config.tmp,
+                [fldId],
+            )
+            rec = crsr.fetchone()
+            # check that stepping through an emulated row works
+            for j in range(len(inParam)):
+                assert (
+                    rec[j] == inParam[j]
+                ), 'returned value:"%s" != test value:"%s"' % (rec[j], inParam[j])
+            # check that we can get a complete tuple from a row
+            assert tuple(rec) == inParam, 'returned value:"%s" != test value:"%s"' % (
+                repr(rec),
+                repr(inParam),
+            )
+            # test that slices of rows work
+            slice1 = tuple(rec[:-1])
+            slice2 = tuple(inParam[0:2])
+            assert slice1 == slice2, 'returned value:"%s" != test value:"%s"' % (
+                repr(slice1),
+                repr(slice2),
+            )
+            # now test named column retrieval
+            assert rec["fldTwo"] == inParam[0]
+            assert rec.fldThree == inParam[1]
+            assert rec.fldFour == inParam[2]
+        # test array operation
+        # note that the fields vv        vv     vv    are out of order
+        crsr.execute("select fldThree,fldFour,fldTwo from xx_%s" % config.tmp)
+        recs = crsr.fetchall()
+        assert recs[1][0] == 103
+        assert recs[0][1] == 4
+        assert recs[1]["fldFour"] == 104
+        assert recs[0, 0] == 3
+        assert recs[0, "fldTwo"] == 2
+        assert recs[1, 2] == 102
+        for i in range(1):
+            for j in range(2):
+                assert recs[i][j] == recs[i, j]
+
+    def testFormatParamstyle(self):
+        self.helpForceDropOnTblTemp()
+        conn = self.getConnection()
+        conn.paramstyle = "format"  # test nonstandard use of paramstyle
+        crsr = conn.cursor()
+        tabdef = (
+            """
+            CREATE TABLE xx_%s (
+                fldId integer NOT NULL,
+                fldData varchar(10),
+                fldConst varchar(30))
+                """
+            % config.tmp
+        )
+        crsr.execute(tabdef)
+
+        inputs = ["one", "two", "three"]
+        fldId = 2
+        for inParam in inputs:
+            fldId += 1
+            sql = (
+                "INSERT INTO xx_"
+                + config.tmp
+                + " (fldId,fldConst,fldData) VALUES (%s,'thi%s :may cause? trouble', %s)"
+            )
+            try:
+                crsr.execute(sql, (fldId, inParam))
+            except:
+                if self.remote:
+                    for message in crsr.messages:
+                        print(message)
+                else:
+                    conn.printADOerrors()
+                raise
+            crsr.execute(
+                "SELECT fldData, fldConst FROM xx_" + config.tmp + " WHERE %s=fldID",
+                [fldId],
+            )
+            rec = crsr.fetchone()
+            self.assertEqual(
+                rec[0],
+                inParam,
+                'returned value:"%s" != test value:"%s"' % (rec[0], inParam),
+            )
+            self.assertEqual(rec[1], "thi%s :may cause? trouble")
+
+        # now try an operation with a "%s" as part of a literal
+        sel = (
+            "insert into xx_" + config.tmp + " (fldId,fldData) VALUES (%s,'four%sfive')"
+        )
+        params = (20,)
+        crsr.execute(sel, params)
+
+        # test the .query implementation
+        assert "(?," in crsr.query, 'expected:"%s" in "%s"' % ("(?,", crsr.query)
+        # test the .command attribute
+        assert crsr.command == sel, 'expected:"%s" but found "%s"' % (sel, crsr.command)
+
+        # test the .parameters attribute
+        if not self.remote:  # parameter list will be altered in transit
+            self.assertEqual(crsr.parameters, params)
+        # now make sure the data made it
+        crsr.execute("SELECT fldData FROM xx_%s WHERE fldID=20" % config.tmp)
+        rec = crsr.fetchone()
+        self.assertEqual(rec[0], "four%sfive")
+
+    def testNamedParamstyle(self):
+        self.helpForceDropOnTblTemp()
+        conn = self.getConnection()
+        crsr = conn.cursor()
+        crsr.paramstyle = "named"  # test nonstandard use of paramstyle
+        tabdef = (
+            """
+            CREATE TABLE xx_%s (
+                fldId integer NOT NULL,
+                fldData varchar(10))
+                """
+            % config.tmp
+        )
+        crsr.execute(tabdef)
+
+        inputs = ["four", "five", "six"]
+        fldId = 10
+        for inParam in inputs:
+            fldId += 1
+            try:
+                crsr.execute(
+                    "INSERT INTO xx_%s (fldId,fldData) VALUES (:Id,:f_Val)"
+                    % config.tmp,
+                    {"f_Val": inParam, "Id": fldId},
+                )
+            except:
+                if self.remote:
+                    for message in crsr.messages:
+                        print(message)
+                else:
+                    conn.printADOerrors()
+                raise
+            crsr.execute(
+                "SELECT fldData FROM xx_%s WHERE fldID=:Id" % config.tmp, {"Id": fldId}
+            )
+            rec = crsr.fetchone()
+            self.assertEqual(
+                rec[0],
+                inParam,
+                'returned value:"%s" != test value:"%s"' % (rec[0], inParam),
+            )
+        # now a test with a ":" as part of a literal
+        crsr.execute(
+            "insert into xx_%s (fldId,fldData) VALUES (:xyz,'six:five')" % config.tmp,
+            {"xyz": 30},
+        )
+        crsr.execute("SELECT fldData FROM xx_%s WHERE fldID=30" % config.tmp)
+        rec = crsr.fetchone()
+        self.assertEqual(rec[0], "six:five")
+
+    def testPyformatParamstyle(self):
+        self.helpForceDropOnTblTemp()
+        conn = self.getConnection()
+        crsr = conn.cursor()
+        crsr.paramstyle = "pyformat"  # test nonstandard use of paramstyle
+        tabdef = (
+            """
+            CREATE TABLE xx_%s (
+                fldId integer NOT NULL,
+                fldData varchar(10))
+                """
+            % config.tmp
+        )
+        crsr.execute(tabdef)
+
+        inputs = ["four", "five", "six"]
+        fldId = 10
+        for inParam in inputs:
+            fldId += 1
+            try:
+                crsr.execute(
+                    "INSERT INTO xx_%s (fldId,fldData) VALUES (%%(Id)s,%%(f_Val)s)"
+                    % config.tmp,
+                    {"f_Val": inParam, "Id": fldId},
+                )
+            except:
+                if self.remote:
+                    for message in crsr.messages:
+                        print(message)
+                else:
+                    conn.printADOerrors()
+                raise
+            crsr.execute(
+                "SELECT fldData FROM xx_%s WHERE fldID=%%(Id)s" % config.tmp,
+                {"Id": fldId},
+            )
+            rec = crsr.fetchone()
+            self.assertEqual(
+                rec[0],
+                inParam,
+                'returned value:"%s" != test value:"%s"' % (rec[0], inParam),
+            )
+        # now a test with a "%" as part of a literal
+        crsr.execute(
+            "insert into xx_%s (fldId,fldData) VALUES (%%(xyz)s,'six%%five')"
+            % config.tmp,
+            {"xyz": 30},
+        )
+        crsr.execute("SELECT fldData FROM xx_%s WHERE fldID=30" % config.tmp)
+        rec = crsr.fetchone()
+        self.assertEqual(rec[0], "six%five")
+
+    def testAutomaticParamstyle(self):
+        self.helpForceDropOnTblTemp()
+        conn = self.getConnection()
+        conn.paramstyle = "dynamic"  # test nonstandard use of paramstyle
+        crsr = conn.cursor()
+        tabdef = (
+            """
+            CREATE TABLE xx_%s (
+                fldId integer NOT NULL,
+                fldData varchar(10),
+                fldConst varchar(30))
+                """
+            % config.tmp
+        )
+        crsr.execute(tabdef)
+        inputs = ["one", "two", "three"]
+        fldId = 2
+        for inParam in inputs:
+            fldId += 1
+            try:
+                crsr.execute(
+                    "INSERT INTO xx_"
+                    + config.tmp
+                    + " (fldId,fldConst,fldData) VALUES (?,'thi%s :may cause? troub:1e', ?)",
+                    (fldId, inParam),
+                )
+            except:
+                if self.remote:
+                    for message in crsr.messages:
+                        print(message)
+                else:
+                    conn.printADOerrors()
+                raise
+            trouble = "thi%s :may cause? troub:1e"
+            crsr.execute(
+                "SELECT fldData, fldConst FROM xx_" + config.tmp + " WHERE ?=fldID",
+                [fldId],
+            )
+            rec = crsr.fetchone()
+            self.assertEqual(
+                rec[0],
+                inParam,
+                'returned value:"%s" != test value:"%s"' % (rec[0], inParam),
+            )
+            self.assertEqual(rec[1], trouble)
+        #     inputs = [u'four',u'five',u'six']
+        fldId = 10
+        for inParam in inputs:
+            fldId += 1
+            try:
+                crsr.execute(
+                    "INSERT INTO xx_%s (fldId,fldData) VALUES (:Id,:f_Val)"
+                    % config.tmp,
+                    {"f_Val": inParam, "Id": fldId},
+                )
+            except:
+                if self.remote:
+                    for message in crsr.messages:
+                        print(message)
+                else:
+                    conn.printADOerrors()
+                raise
+            crsr.execute(
+                "SELECT fldData FROM xx_%s WHERE :Id=fldID" % config.tmp, {"Id": fldId}
+            )
+            rec = crsr.fetchone()
+            self.assertEqual(
+                rec[0],
+                inParam,
+                'returned value:"%s" != test value:"%s"' % (rec[0], inParam),
+            )
+        # now a test with a ":" as part of a literal -- and use a prepared query
+        ppdcmd = (
+            "insert into xx_%s (fldId,fldData) VALUES (:xyz,'six:five')" % config.tmp
+        )
+        crsr.prepare(ppdcmd)
+        crsr.execute(ppdcmd, {"xyz": 30})
+        crsr.execute("SELECT fldData FROM xx_%s WHERE fldID=30" % config.tmp)
+        rec = crsr.fetchone()
+        self.assertEqual(rec[0], "six:five")
+
+    def testRollBack(self):
+        conn = self.getConnection()
+        crsr = conn.cursor()
+        assert not crsr.connection.autocommit, "Unexpected beginning condition"
+        self.helpCreateAndPopulateTableTemp(crsr)
+        crsr.connection.commit()  # commit the first bunch
+
+        crsr.execute("INSERT INTO xx_%s (fldData) VALUES(100)" % config.tmp)
+
+        selectSql = "SELECT fldData FROM xx_%s WHERE fldData=100" % config.tmp
+        crsr.execute(selectSql)
+        rs = crsr.fetchall()
+        assert len(rs) == 1
+        self.conn.rollback()
+        crsr.execute(selectSql)
+        assert (
+            crsr.fetchone() == None
+        ), "cursor.fetchone should return None if a query retrieves no rows"
+        crsr.execute("SELECT fldData from xx_%s" % config.tmp)
+        rs = crsr.fetchall()
+        assert len(rs) == 9, "the original records should still be present"
+        self.helpRollbackTblTemp()
+
+    def testCommit(self):
+        try:
+            con2 = self.getAnotherConnection()
+        except NotImplementedError:
+            return  # should be "SKIP" for ACCESS
+        assert not con2.autocommit, "default should be manual commit"
+        crsr = con2.cursor()
+        self.helpCreateAndPopulateTableTemp(crsr)
+
+        crsr.execute("INSERT INTO xx_%s (fldData) VALUES(100)" % config.tmp)
+        con2.commit()
+
+        selectSql = "SELECT fldData FROM xx_%s WHERE fldData=100" % config.tmp
+        crsr.execute(selectSql)
+        rs = crsr.fetchall()
+        assert len(rs) == 1
+        crsr.close()
+        con2.close()
+        conn = self.getConnection()
+        crsr = self.getCursor()
+        with conn.cursor() as crsr:
+            crsr.execute(selectSql)
+            rs = crsr.fetchall()
+            assert len(rs) == 1
+            assert rs[0][0] == 100
+        self.helpRollbackTblTemp()
+
+    def testAutoRollback(self):
+        try:
+            con2 = self.getAnotherConnection()
+        except NotImplementedError:
+            return  # should be "SKIP" for ACCESS
+        assert not con2.autocommit, "unexpected beginning condition"
+        crsr = con2.cursor()
+        self.helpCreateAndPopulateTableTemp(crsr)
+        crsr.execute("INSERT INTO xx_%s (fldData) VALUES(100)" % config.tmp)
+        selectSql = "SELECT fldData FROM xx_%s WHERE fldData=100" % config.tmp
+        crsr.execute(selectSql)
+        rs = crsr.fetchall()
+        assert len(rs) == 1
+        crsr.close()
+        con2.close()
+        crsr = self.getCursor()
+        try:
+            crsr.execute(
+                selectSql
+            )  # closing the connection should have forced rollback
+            row = crsr.fetchone()
+        except api.DatabaseError:
+            row = None  # if the entire table disappeared the rollback was perfect and the test passed
+        assert row == None, (
+            "cursor.fetchone should return None if a query retrieves no rows. Got %s"
+            % repr(row)
+        )
+        self.helpRollbackTblTemp()
+
+    def testAutoCommit(self):
+        try:
+            ac_conn = self.getAnotherConnection({"autocommit": True})
+        except NotImplementedError:
+            return  # should be "SKIP" for ACCESS
+        crsr = ac_conn.cursor()
+        self.helpCreateAndPopulateTableTemp(crsr)
+        crsr.execute("INSERT INTO xx_%s (fldData) VALUES(100)" % config.tmp)
+        crsr.close()
+        with self.getCursor() as crsr:
+            selectSql = "SELECT fldData from xx_%s" % config.tmp
+            crsr.execute(
+                selectSql
+            )  # closing the connection should _not_ have forced rollback
+            rs = crsr.fetchall()
+            assert len(rs) == 10, "all records should still be present"
+        ac_conn.close()
+        self.helpRollbackTblTemp()
+
+    def testSwitchedAutoCommit(self):
+        try:
+            ac_conn = self.getAnotherConnection()
+        except NotImplementedError:
+            return  # should be "SKIP" for ACCESS
+        ac_conn.autocommit = True
+        crsr = ac_conn.cursor()
+        self.helpCreateAndPopulateTableTemp(crsr)
+        crsr.execute("INSERT INTO xx_%s (fldData) VALUES(100)" % config.tmp)
+        crsr.close()
+        conn = self.getConnection()
+        ac_conn.close()
+        with self.getCursor() as crsr:
+            selectSql = "SELECT fldData from xx_%s" % config.tmp
+            crsr.execute(
+                selectSql
+            )  # closing the connection should _not_ have forced rollback
+            rs = crsr.fetchall()
+            assert len(rs) == 10, "all records should still be present"
+        self.helpRollbackTblTemp()
+
+    def testExtendedTypeHandling(self):
+        class XtendString(str):
+            pass
+
+        class XtendInt(int):
+            pass
+
+        class XtendFloat(float):
+            pass
+
+        xs = XtendString(randomstring(30))
+        xi = XtendInt(random.randint(-100, 500))
+        xf = XtendFloat(random.random())
+        self.helpForceDropOnTblTemp()
+        conn = self.getConnection()
+        crsr = conn.cursor()
+        tabdef = (
+            """
+            CREATE TABLE xx_%s (
+                s VARCHAR(40) NOT NULL,
+                i INTEGER NOT NULL,
+                f REAL NOT NULL)"""
+            % config.tmp
+        )
+        crsr.execute(tabdef)
+        crsr.execute(
+            "INSERT INTO xx_%s (s, i, f) VALUES (?, ?, ?)" % config.tmp, (xs, xi, xf)
+        )
+        crsr.close()
+        conn = self.getConnection()
+        with self.getCursor() as crsr:
+            selectSql = "SELECT s, i, f from xx_%s" % config.tmp
+            crsr.execute(
+                selectSql
+            )  # closing the connection should _not_ have forced rollback
+            row = crsr.fetchone()
+            self.assertEqual(row.s, xs)
+            self.assertEqual(row.i, xi)
+            self.assertAlmostEqual(row.f, xf)
+        self.helpRollbackTblTemp()
+
+
+class TestADOwithSQLServer(CommonDBTests):
+    def setUp(self):
+        self.conn = config.dbSqlServerconnect(
+            *config.connStrSQLServer[0], **config.connStrSQLServer[1]
+        )
+        self.conn.timeout = 30  # turn timeout back up
+        self.engine = "MSSQL"
+        self.db = config.dbSqlServerconnect
+        self.remote = config.connStrSQLServer[2]
+
+    def tearDown(self):
+        try:
+            self.conn.rollback()
+        except:
+            pass
+        try:
+            self.conn.close()
+        except:
+            pass
+        self.conn = None
+
+    def getConnection(self):
+        return self.conn
+
+    def getAnotherConnection(self, addkeys=None):
+        keys = dict(config.connStrSQLServer[1])
+        if addkeys:
+            keys.update(addkeys)
+        return config.dbSqlServerconnect(*config.connStrSQLServer[0], **keys)
+
+    def testVariableReturningStoredProcedure(self):
+        crsr = self.conn.cursor()
+        spdef = """
+            CREATE PROCEDURE sp_DeleteMeOnlyForTesting
+                @theInput varchar(50),
+                @theOtherInput varchar(50),
+                @theOutput varchar(100) OUTPUT
+            AS
+                SET @theOutput=@theInput+@theOtherInput
+                    """
+        try:
+            crsr.execute("DROP PROCEDURE sp_DeleteMeOnlyForTesting")
+            self.conn.commit()
+        except:  # Make sure it is empty
+            pass
+        crsr.execute(spdef)
+
+        retvalues = crsr.callproc(
+            "sp_DeleteMeOnlyForTesting", ("Dodsworth", "Anne", "              ")
+        )
+        assert retvalues[0] == "Dodsworth", '%s is not "Dodsworth"' % repr(retvalues[0])
+        assert retvalues[1] == "Anne", '%s is not "Anne"' % repr(retvalues[1])
+        assert retvalues[2] == "DodsworthAnne", '%s is not "DodsworthAnne"' % repr(
+            retvalues[2]
+        )
+        self.conn.rollback()
+
+    def testMultipleSetReturn(self):
+        crsr = self.getCursor()
+        self.helpCreateAndPopulateTableTemp(crsr)
+
+        spdef = """
+            CREATE PROCEDURE sp_DeleteMe_OnlyForTesting
+            AS
+                SELECT fldData FROM xx_%s ORDER BY fldData ASC
+                SELECT fldData From xx_%s where fldData = -9999
+                SELECT fldData FROM xx_%s ORDER BY fldData DESC
+                    """ % (
+            config.tmp,
+            config.tmp,
+            config.tmp,
+        )
+        try:
+            crsr.execute("DROP PROCEDURE sp_DeleteMe_OnlyForTesting")
+            self.conn.commit()
+        except:  # Make sure it is empty
+            pass
+        crsr.execute(spdef)
+
+        retvalues = crsr.callproc("sp_DeleteMe_OnlyForTesting")
+        row = crsr.fetchone()
+        self.assertEqual(row[0], 0)
+        assert crsr.nextset() == True, "Operation should succeed"
+        assert not crsr.fetchall(), "Should be an empty second set"
+        assert crsr.nextset() == True, "third set should be present"
+        rowdesc = crsr.fetchall()
+        self.assertEqual(rowdesc[0][0], 8)
+        assert crsr.nextset() == None, "No more return sets, should return None"
+
+        self.helpRollbackTblTemp()
+
+    def testDatetimeProcedureParameter(self):
+        crsr = self.conn.cursor()
+        spdef = """
+            CREATE PROCEDURE sp_DeleteMeOnlyForTesting
+                @theInput DATETIME,
+                @theOtherInput varchar(50),
+                @theOutput varchar(100) OUTPUT
+            AS
+                SET @theOutput = CONVERT(CHARACTER(20), @theInput, 0) + @theOtherInput
+                    """
+        try:
+            crsr.execute("DROP PROCEDURE sp_DeleteMeOnlyForTesting")
+            self.conn.commit()
+        except:  # Make sure it is empty
+            pass
+        crsr.execute(spdef)
+
+        result = crsr.callproc(
+            "sp_DeleteMeOnlyForTesting",
+            [adodbapi.Timestamp(2014, 12, 25, 0, 1, 0), "Beep", " " * 30],
+        )
+
+        assert result[2] == "Dec 25 2014 12:01AM Beep", 'value was="%s"' % result[2]
+        self.conn.rollback()
+
+    def testIncorrectStoredProcedureParameter(self):
+        crsr = self.conn.cursor()
+        spdef = """
+            CREATE PROCEDURE sp_DeleteMeOnlyForTesting
+                @theInput DATETIME,
+                @theOtherInput varchar(50),
+                @theOutput varchar(100) OUTPUT
+            AS
+                SET @theOutput = CONVERT(CHARACTER(20), @theInput) + @theOtherInput
+                    """
+        try:
+            crsr.execute("DROP PROCEDURE sp_DeleteMeOnlyForTesting")
+            self.conn.commit()
+        except:  # Make sure it is empty
+            pass
+        crsr.execute(spdef)
+
+        # calling the sproc with a string for the first parameter where a DateTime is expected
+        result = tryconnection.try_operation_with_expected_exception(
+            (api.DataError, api.DatabaseError),
+            crsr.callproc,
+            ["sp_DeleteMeOnlyForTesting"],
+            {"parameters": ["this is wrong", "Anne", "not Alice"]},
+        )
+        if result[0]:  # the expected exception was raised
+            assert "@theInput" in str(result[1]) or "DatabaseError" in str(
+                result
+            ), "Identifies the wrong erroneous parameter"
+        else:
+            assert result[0], result[1]  # incorrect or no exception
+        self.conn.rollback()
+
+
+class TestADOwithAccessDB(CommonDBTests):
+    def setUp(self):
+        self.conn = config.dbAccessconnect(
+            *config.connStrAccess[0], **config.connStrAccess[1]
+        )
+        self.conn.timeout = 30  # turn timeout back up
+        self.engine = "ACCESS"
+        self.db = config.dbAccessconnect
+        self.remote = config.connStrAccess[2]
+
+    def tearDown(self):
+        try:
+            self.conn.rollback()
+        except:
+            pass
+        try:
+            self.conn.close()
+        except:
+            pass
+        self.conn = None
+
+    def getConnection(self):
+        return self.conn
+
+    def getAnotherConnection(self, addkeys=None):
+        raise NotImplementedError("Jet cannot use a second connection to the database")
+
+    def testOkConnect(self):
+        c = self.db(*config.connStrAccess[0], **config.connStrAccess[1])
+        assert c != None
+        c.close()
+
+
+class TestADOwithMySql(CommonDBTests):
+    def setUp(self):
+        self.conn = config.dbMySqlconnect(
+            *config.connStrMySql[0], **config.connStrMySql[1]
+        )
+        self.conn.timeout = 30  # turn timeout back up
+        self.engine = "MySQL"
+        self.db = config.dbMySqlconnect
+        self.remote = config.connStrMySql[2]
+
+    def tearDown(self):
+        try:
+            self.conn.rollback()
+        except:
+            pass
+        try:
+            self.conn.close()
+        except:
+            pass
+        self.conn = None
+
+    def getConnection(self):
+        return self.conn
+
+    def getAnotherConnection(self, addkeys=None):
+        keys = dict(config.connStrMySql[1])
+        if addkeys:
+            keys.update(addkeys)
+        return config.dbMySqlconnect(*config.connStrMySql[0], **keys)
+
+    def testOkConnect(self):
+        c = self.db(*config.connStrMySql[0], **config.connStrMySql[1])
+        assert c != None
+
+    # def testStoredProcedure(self):
+    #     crsr=self.conn.cursor()
+    #     try:
+    #         crsr.execute("DROP PROCEDURE DeleteMeOnlyForTesting")
+    #         self.conn.commit()
+    #     except: #Make sure it is empty
+    #         pass
+    #     spdef= """
+    #             DELIMITER $$
+    #             CREATE PROCEDURE DeleteMeOnlyForTesting (onein CHAR(10), twoin CHAR(10), OUT theout CHAR(20))
+    #             DETERMINISTIC
+    #              BEGIN
+    #                 SET theout = onein //|| twoin;
+    #                 /* (SELECT 'a small string' as result; */
+    #                 END $$
+    #             """
+    #
+    #     crsr.execute(spdef)
+    #
+    #     retvalues=crsr.callproc('DeleteMeOnlyForTesting',('Dodsworth','Anne','              '))
+    #     print 'return value (mysql)=',repr(crsr.returnValue) ###
+    #     assert retvalues[0]=='Dodsworth', '%s is not "Dodsworth"'%repr(retvalues[0])
+    #     assert retvalues[1]=='Anne','%s is not "Anne"'%repr(retvalues[1])
+    #     assert retvalues[2]=='DodsworthAnne','%s is not "DodsworthAnne"'%repr(retvalues[2])
+    #
+    #     try:
+    #         crsr.execute("DROP PROCEDURE, DeleteMeOnlyForTesting")
+    #         self.conn.commit()
+    #     except: #Make sure it is empty
+    #         pass
+
+
+class TestADOwithPostgres(CommonDBTests):
+    def setUp(self):
+        self.conn = config.dbPostgresConnect(
+            *config.connStrPostgres[0], **config.connStrPostgres[1]
+        )
+        self.conn.timeout = 30  # turn timeout back up
+        self.engine = "PostgreSQL"
+        self.db = config.dbPostgresConnect
+        self.remote = config.connStrPostgres[2]
+
+    def tearDown(self):
+        try:
+            self.conn.rollback()
+        except:
+            pass
+        try:
+            self.conn.close()
+        except:
+            pass
+        self.conn = None
+
+    def getConnection(self):
+        return self.conn
+
+    def getAnotherConnection(self, addkeys=None):
+        keys = dict(config.connStrPostgres[1])
+        if addkeys:
+            keys.update(addkeys)
+        return config.dbPostgresConnect(*config.connStrPostgres[0], **keys)
+
+    def testOkConnect(self):
+        c = self.db(*config.connStrPostgres[0], **config.connStrPostgres[1])
+        assert c != None
+
+    # def testStoredProcedure(self):
+    #     crsr=self.conn.cursor()
+    #     spdef= """
+    #         CREATE OR REPLACE FUNCTION DeleteMeOnlyForTesting (text, text)
+    #         RETURNS text AS $funk$
+    #         BEGIN
+    #           RETURN $1 || $2;
+    #         END;
+    #         $funk$
+    #         LANGUAGE SQL;
+    #         """
+    #
+    #     crsr.execute(spdef)
+    #     retvalues = crsr.callproc('DeleteMeOnlyForTesting',('Dodsworth','Anne','              '))
+    #     ### print 'return value (pg)=',repr(crsr.returnValue) ###
+    #     assert retvalues[0]=='Dodsworth', '%s is not "Dodsworth"'%repr(retvalues[0])
+    #     assert retvalues[1]=='Anne','%s is not "Anne"'%repr(retvalues[1])
+    #     assert retvalues[2]=='Dodsworth Anne','%s is not "Dodsworth Anne"'%repr(retvalues[2])
+    #     self.conn.rollback()
+    #     try:
+    #         crsr.execute("DROP PROCEDURE, DeleteMeOnlyForTesting")
+    #         self.conn.commit()
+    #     except: #Make sure it is empty
+    #         pass
+
+
+class TimeConverterInterfaceTest(unittest.TestCase):
+    def testIDate(self):
+        assert self.tc.Date(1990, 2, 2)
+
+    def testITime(self):
+        assert self.tc.Time(13, 2, 2)
+
+    def testITimestamp(self):
+        assert self.tc.Timestamp(1990, 2, 2, 13, 2, 1)
+
+    def testIDateObjectFromCOMDate(self):
+        assert self.tc.DateObjectFromCOMDate(37435.7604282)
+
+    def testICOMDate(self):
+        assert hasattr(self.tc, "COMDate")
+
+    def testExactDate(self):
+        d = self.tc.Date(1994, 11, 15)
+        comDate = self.tc.COMDate(d)
+        correct = 34653.0
+        assert comDate == correct, comDate
+
+    def testExactTimestamp(self):
+        d = self.tc.Timestamp(1994, 11, 15, 12, 0, 0)
+        comDate = self.tc.COMDate(d)
+        correct = 34653.5
+        self.assertEqual(comDate, correct)
+
+        d = self.tc.Timestamp(2003, 5, 6, 14, 15, 17)
+        comDate = self.tc.COMDate(d)
+        correct = 37747.593946759262
+        self.assertEqual(comDate, correct)
+
+    def testIsoFormat(self):
+        d = self.tc.Timestamp(1994, 11, 15, 12, 3, 10)
+        iso = self.tc.DateObjectToIsoFormatString(d)
+        self.assertEqual(str(iso[:19]), "1994-11-15 12:03:10")
+
+        dt = self.tc.Date(2003, 5, 2)
+        iso = self.tc.DateObjectToIsoFormatString(dt)
+        self.assertEqual(str(iso[:10]), "2003-05-02")
+
+
+if config.doMxDateTimeTest:
+    import mx.DateTime
+
+
+class TestMXDateTimeConverter(TimeConverterInterfaceTest):
+    def setUp(self):
+        self.tc = api.mxDateTimeConverter()
+
+    def testCOMDate(self):
+        t = mx.DateTime.DateTime(2002, 6, 28, 18, 15, 2)
+        cmd = self.tc.COMDate(t)
+        assert cmd == t.COMDate()
+
+    def testDateObjectFromCOMDate(self):
+        cmd = self.tc.DateObjectFromCOMDate(37435.7604282)
+        t = mx.DateTime.DateTime(2002, 6, 28, 18, 15, 0)
+        t2 = mx.DateTime.DateTime(2002, 6, 28, 18, 15, 2)
+        assert t2 > cmd > t
+
+    def testDate(self):
+        assert mx.DateTime.Date(1980, 11, 4) == self.tc.Date(1980, 11, 4)
+
+    def testTime(self):
+        assert mx.DateTime.Time(13, 11, 4) == self.tc.Time(13, 11, 4)
+
+    def testTimestamp(self):
+        t = mx.DateTime.DateTime(2002, 6, 28, 18, 15, 1)
+        obj = self.tc.Timestamp(2002, 6, 28, 18, 15, 1)
+        assert t == obj
+
+
+import time
+
+
+class TestPythonTimeConverter(TimeConverterInterfaceTest):
+    def setUp(self):
+        self.tc = api.pythonTimeConverter()
+
+    def testCOMDate(self):
+        mk = time.mktime((2002, 6, 28, 18, 15, 1, 4, 31 + 28 + 31 + 30 + 31 + 28, -1))
+        t = time.localtime(mk)
+        # Fri, 28 Jun 2002 18:15:01 +0000
+        cmd = self.tc.COMDate(t)
+        assert abs(cmd - 37435.7604282) < 1.0 / 24, "%f more than an hour wrong" % cmd
+
+    def testDateObjectFromCOMDate(self):
+        cmd = self.tc.DateObjectFromCOMDate(37435.7604282)
+        t1 = time.gmtime(
+            time.mktime((2002, 6, 28, 0, 14, 1, 4, 31 + 28 + 31 + 30 + 31 + 28, -1))
+        )
+        # there are errors in the implementation of gmtime which we ignore
+        t2 = time.gmtime(
+            time.mktime((2002, 6, 29, 12, 14, 2, 4, 31 + 28 + 31 + 30 + 31 + 28, -1))
+        )
+        assert t1 < cmd < t2, '"%s" should be about 2002-6-28 12:15:01' % repr(cmd)
+
+    def testDate(self):
+        t1 = time.mktime((2002, 6, 28, 18, 15, 1, 4, 31 + 28 + 31 + 30 + 31 + 30, 0))
+        t2 = time.mktime((2002, 6, 30, 18, 15, 1, 4, 31 + 28 + 31 + 30 + 31 + 28, 0))
+        obj = self.tc.Date(2002, 6, 29)
+        assert t1 < time.mktime(obj) < t2, obj
+
+    def testTime(self):
+        self.assertEqual(
+            self.tc.Time(18, 15, 2), time.gmtime(18 * 60 * 60 + 15 * 60 + 2)
+        )
+
+    def testTimestamp(self):
+        t1 = time.localtime(
+            time.mktime((2002, 6, 28, 18, 14, 1, 4, 31 + 28 + 31 + 30 + 31 + 28, -1))
+        )
+        t2 = time.localtime(
+            time.mktime((2002, 6, 28, 18, 16, 1, 4, 31 + 28 + 31 + 30 + 31 + 28, -1))
+        )
+        obj = self.tc.Timestamp(2002, 6, 28, 18, 15, 2)
+        assert t1 < obj < t2, obj
+
+
+class TestPythonDateTimeConverter(TimeConverterInterfaceTest):
+    def setUp(self):
+        self.tc = api.pythonDateTimeConverter()
+
+    def testCOMDate(self):
+        t = datetime.datetime(2002, 6, 28, 18, 15, 1)
+        # Fri, 28 Jun 2002 18:15:01 +0000
+        cmd = self.tc.COMDate(t)
+        assert abs(cmd - 37435.7604282) < 1.0 / 24, "more than an hour wrong"
+
+    def testDateObjectFromCOMDate(self):
+        cmd = self.tc.DateObjectFromCOMDate(37435.7604282)
+        t1 = datetime.datetime(2002, 6, 28, 18, 14, 1)
+        t2 = datetime.datetime(2002, 6, 28, 18, 16, 1)
+        assert t1 < cmd < t2, cmd
+
+        tx = datetime.datetime(
+            2002, 6, 28, 18, 14, 1, 900000
+        )  # testing that microseconds don't become milliseconds
+        c1 = self.tc.DateObjectFromCOMDate(self.tc.COMDate(tx))
+        assert t1 < c1 < t2, c1
+
+    def testDate(self):
+        t1 = datetime.date(2002, 6, 28)
+        t2 = datetime.date(2002, 6, 30)
+        obj = self.tc.Date(2002, 6, 29)
+        assert t1 < obj < t2, obj
+
+    def testTime(self):
+        self.assertEqual(self.tc.Time(18, 15, 2).isoformat()[:8], "18:15:02")
+
+    def testTimestamp(self):
+        t1 = datetime.datetime(2002, 6, 28, 18, 14, 1)
+        t2 = datetime.datetime(2002, 6, 28, 18, 16, 1)
+        obj = self.tc.Timestamp(2002, 6, 28, 18, 15, 2)
+        assert t1 < obj < t2, obj
+
+
+suites = []
+suites.append(unittest.makeSuite(TestPythonDateTimeConverter, "test"))
+if config.doMxDateTimeTest:
+    suites.append(unittest.makeSuite(TestMXDateTimeConverter, "test"))
+if config.doTimeTest:
+    suites.append(unittest.makeSuite(TestPythonTimeConverter, "test"))
+
+if config.doAccessTest:
+    suites.append(unittest.makeSuite(TestADOwithAccessDB, "test"))
+if config.doSqlServerTest:
+    suites.append(unittest.makeSuite(TestADOwithSQLServer, "test"))
+if config.doMySqlTest:
+    suites.append(unittest.makeSuite(TestADOwithMySql, "test"))
+if config.doPostgresTest:
+    suites.append(unittest.makeSuite(TestADOwithPostgres, "test"))
+
+
+class cleanup_manager(object):
+    def __enter__(self):
+        pass
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        config.cleanup(config.testfolder, config.mdb_name)
+
+
+suite = unittest.TestSuite(suites)
+if __name__ == "__main__":
+    mysuite = copy.deepcopy(suite)
+    with cleanup_manager():
+        defaultDateConverter = adodbapi.dateconverter
+        print(__doc__)
+        print("Default Date Converter is %s" % (defaultDateConverter,))
+        dateconverter = defaultDateConverter
+        tag = "datetime"
+        unittest.TextTestRunner().run(mysuite)
+
+        if config.iterateOverTimeTests:
+            for test, dateconverter, tag in (
+                (config.doTimeTest, api.pythonTimeConverter, "pythontime"),
+                (config.doMxDateTimeTest, api.mxDateTimeConverter, "mx"),
+            ):
+                if test:
+                    mysuite = copy.deepcopy(
+                        suite
+                    )  # work around a side effect of unittest.TextTestRunner
+                    adodbapi.adodbapi.dateconverter = dateconverter()
+                    print("Changed dateconverter to ")
+                    print(adodbapi.adodbapi.dateconverter)
+                    unittest.TextTestRunner().run(mysuite)
diff --git a/lib/adodbapi/test/adodbapitestconfig.py b/lib/adodbapi/test/adodbapitestconfig.py
new file mode 100644
index 00000000..98f25444
--- /dev/null
+++ b/lib/adodbapi/test/adodbapitestconfig.py
@@ -0,0 +1,221 @@
+# Configure this to _YOUR_ environment in order to run the testcases.
+"testADOdbapiConfig.py v 2.6.2.B00"
+
+# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
+# #
+# #  TESTERS:
+# #
+# #  You will need to make numerous modifications to this file
+# #  to adapt it to your own testing environment.
+# #
+# #  Skip down to the next "# #" line --
+# #  -- the things you need to change are below it.
+# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
+import platform
+import random
+import sys
+
+import is64bit
+import setuptestframework
+import tryconnection
+
+print("\nPython", sys.version)
+node = platform.node()
+try:
+    print(
+        "node=%s, is64bit.os()= %s, is64bit.Python()= %s"
+        % (node, is64bit.os(), is64bit.Python())
+    )
+except:
+    pass
+
+if "--help" in sys.argv:
+    print(
+        """Valid command-line switches are:
+    --package - create a temporary test package, run 2to3 if needed.
+    --all - run all possible tests
+    --time - loop over time format tests (including mxdatetime if present)
+    --nojet - do not test against an ACCESS database file
+    --mssql - test against Microsoft SQL server
+    --pg - test against PostgreSQL
+    --mysql - test against MariaDB
+    --remote= - test unsing remote server at= (experimental) 
+    """
+    )
+    exit()
+try:
+    onWindows = bool(sys.getwindowsversion())  # seems to work on all versions of Python
+except:
+    onWindows = False
+
+# create a random name for temporary table names
+_alphabet = (
+    "PYFGCRLAOEUIDHTNSQJKXBMWVZ"  # why, yes, I do happen to use a dvorak keyboard
+)
+tmp = "".join([random.choice(_alphabet) for x in range(9)])
+mdb_name = "xx_" + tmp + ".mdb"  # generate a non-colliding name for the temporary .mdb
+testfolder = setuptestframework.maketemp()
+
+if "--package" in sys.argv:
+    #  create a new adodbapi module -- running 2to3 if needed.
+    pth = setuptestframework.makeadopackage(testfolder)
+else:
+    #  use the adodbapi module in which this file appears
+    pth = setuptestframework.find_ado_path()
+if pth not in sys.path:
+    #  look here _first_ to find modules
+    sys.path.insert(1, pth)
+
+proxy_host = None
+for arg in sys.argv:
+    if arg.startswith("--remote="):
+        proxy_host = arg.split("=")[1]
+        import adodbapi.remote as remote
+
+        break
+
+
+# function to clean up the temporary folder -- calling program must run this function before exit.
+cleanup = setuptestframework.getcleanupfunction()
+try:
+    import adodbapi  # will (hopefully) be imported using the "pth" discovered above
+except SyntaxError:
+    print(
+        '\n* * * Are you trying to run Python2 code using Python3? Re-run this test using the "--package" switch.'
+    )
+    sys.exit(11)
+try:
+    print(adodbapi.version)  # show version
+except:
+    print('"adodbapi.version" not present or not working.')
+print(__doc__)
+
+verbose = False
+for a in sys.argv:
+    if a.startswith("--verbose"):
+        arg = True
+        try:
+            arg = int(a.split("=")[1])
+        except IndexError:
+            pass
+        adodbapi.adodbapi.verbose = arg
+        verbose = arg
+
+doAllTests = "--all" in sys.argv
+doAccessTest = not ("--nojet" in sys.argv)
+doSqlServerTest = "--mssql" in sys.argv or doAllTests
+doMySqlTest = "--mysql" in sys.argv or doAllTests
+doPostgresTest = "--pg" in sys.argv or doAllTests
+iterateOverTimeTests = ("--time" in sys.argv or doAllTests) and onWindows
+
+# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
+# # start your environment setup here v v v
+SQL_HOST_NODE = "testsql.2txt.us,1430"
+
+try:  # If mx extensions are installed, use mxDateTime
+    import mx.DateTime
+
+    doMxDateTimeTest = True
+except:
+    doMxDateTimeTest = False  # Requires eGenixMXExtensions
+
+doTimeTest = True  # obsolete python time format
+
+if doAccessTest:
+    if proxy_host:  # determine the (probably remote) database file folder
+        c = {"macro_find_temp_test_path": ["mdb", mdb_name], "proxy_host": proxy_host}
+    else:
+        c = {"mdb": setuptestframework.makemdb(testfolder, mdb_name)}
+
+    # macro definition for keyword "provider"  using macro "is64bit" -- see documentation
+    # is64bit will return true for 64 bit versions of Python, so the macro will select the ACE provider
+    # (If running a remote ADO service, this will test the 64-bitedness of the ADO server.)
+    c["macro_is64bit"] = [
+        "provider",
+        "Microsoft.ACE.OLEDB.12.0",  # 64 bit provider
+        "Microsoft.Jet.OLEDB.4.0",
+    ]  # 32 bit provider
+    connStrAccess = "Provider=%(provider)s;Data Source=%(mdb)s"  # ;Mode=ReadWrite;Persist Security Info=False;Jet OLEDB:Bypass UserInfo Validation=True"
+    print(
+        "    ...Testing ACCESS connection to {} file...".format(
+            c.get("mdb", "remote .mdb")
+        )
+    )
+    doAccessTest, connStrAccess, dbAccessconnect = tryconnection.try_connection(
+        verbose, connStrAccess, 10, **c
+    )
+
+if doSqlServerTest:
+    c = {
+        "host": SQL_HOST_NODE,  # name of computer with SQL Server
+        "database": "adotest",
+        "user": "adotestuser",  # None implies Windows security
+        "password": "Sq1234567",
+        # macro definition for keyword "security" using macro "auto_security"
+        "macro_auto_security": "security",
+        "provider": "MSOLEDBSQL; MARS Connection=True",
+    }
+    if proxy_host:
+        c["proxy_host"] = proxy_host
+    connStr = "Provider=%(provider)s; Initial Catalog=%(database)s; Data Source=%(host)s; %(security)s;"
+    print("    ...Testing MS-SQL login to {}...".format(c["host"]))
+    (
+        doSqlServerTest,
+        connStrSQLServer,
+        dbSqlServerconnect,
+    ) = tryconnection.try_connection(verbose, connStr, 30, **c)
+
+if doMySqlTest:
+    c = {
+        "host": "testmysql.2txt.us",
+        "database": "adodbapitest",
+        "user": "adotest",
+        "password": "12345678",
+        "port": "3330",  # note the nonstandard port for obfuscation
+        "driver": "MySQL ODBC 5.1 Driver",
+    }  # or _driver="MySQL ODBC 3.51 Driver
+    if proxy_host:
+        c["proxy_host"] = proxy_host
+    c["macro_is64bit"] = [
+        "provider",
+        "Provider=MSDASQL;",
+    ]  # turn on the 64 bit ODBC adapter only if needed
+    cs = (
+        "%(provider)sDriver={%(driver)s};Server=%(host)s;Port=3330;"
+        + "Database=%(database)s;user=%(user)s;password=%(password)s;Option=3;"
+    )
+    print("    ...Testing MySql login to {}...".format(c["host"]))
+    doMySqlTest, connStrMySql, dbMySqlconnect = tryconnection.try_connection(
+        verbose, cs, 5, **c
+    )
+
+
+if doPostgresTest:
+    _computername = "testpg.2txt.us"
+    _databasename = "adotest"
+    _username = "adotestuser"
+    _password = "12345678"
+    kws = {"timeout": 4}
+    kws["macro_is64bit"] = [
+        "prov_drv",
+        "Provider=MSDASQL;Driver={PostgreSQL Unicode(x64)}",
+        "Driver=PostgreSQL Unicode",
+    ]
+    # get driver from http://www.postgresql.org/ftp/odbc/versions/
+    # test using positional and keyword arguments (bad example for real code)
+    if proxy_host:
+        kws["proxy_host"] = proxy_host
+    print("    ...Testing PostgreSQL login to {}...".format(_computername))
+    doPostgresTest, connStrPostgres, dbPostgresConnect = tryconnection.try_connection(
+        verbose,
+        "%(prov_drv)s;Server=%(host)s;Database=%(database)s;uid=%(user)s;pwd=%(password)s;port=5430;",  # note nonstandard port
+        _username,
+        _password,
+        _computername,
+        _databasename,
+        **kws
+    )
+
+assert (
+    doAccessTest or doSqlServerTest or doMySqlTest or doPostgresTest
+), "No database engine found for testing"
diff --git a/lib/adodbapi/test/dbapi20.py b/lib/adodbapi/test/dbapi20.py
new file mode 100644
index 00000000..e378b194
--- /dev/null
+++ b/lib/adodbapi/test/dbapi20.py
@@ -0,0 +1,939 @@
+#!/usr/bin/env python
+""" Python DB API 2.0 driver compliance unit test suite. 
+    
+    This software is Public Domain and may be used without restrictions.
+
+ "Now we have booze and barflies entering the discussion, plus rumours of
+  DBAs on drugs... and I won't tell you what flashes through my mind each
+  time I read the subject line with 'Anal Compliance' in it.  All around
+  this is turning out to be a thoroughly unwholesome unit test."
+
+    -- Ian Bicking
+"""
+
+__version__ = "$Revision: 1.15.0 $"[11:-2]
+__author__ = "Stuart Bishop <stuart@stuartbishop.net>"
+
+import sys
+import time
+import unittest
+
+if sys.version[0] >= "3":  # python 3.x
+    _BaseException = Exception
+
+    def _failUnless(self, expr, msg=None):
+        self.assertTrue(expr, msg)
+
+else:  # python 2.x
+    from exceptions import Exception as _BaseException
+
+    def _failUnless(self, expr, msg=None):
+        self.failUnless(expr, msg)  ## deprecated since Python 2.6
+
+
+# set this to "True" to follow API 2.0 to the letter
+TEST_FOR_NON_IDEMPOTENT_CLOSE = False
+
+# Revision 1.15  2019/11/22 00:50:00  kf7xm
+# Make Turn off IDEMPOTENT_CLOSE a proper skipTest
+
+# Revision 1.14  2013/05/20 11:02:05  kf7xm
+# Add a literal string to the format insertion test to catch trivial re-format algorithms
+
+# Revision 1.13  2013/05/08 14:31:50  kf7xm
+# Quick switch to Turn off IDEMPOTENT_CLOSE test. Also: Silence teardown failure
+
+
+# Revision 1.12  2009/02/06 03:35:11  kf7xm
+# Tested okay with Python 3.0, includes last minute patches from Mark H.
+#
+# Revision 1.1.1.1.2.1  2008/09/20 19:54:59  rupole
+# Include latest changes from main branch
+# Updates for py3k
+#
+# Revision 1.11  2005/01/02 02:41:01  zenzen
+# Update author email address
+#
+# Revision 1.10  2003/10/09 03:14:14  zenzen
+# Add test for DB API 2.0 optional extension, where database exceptions
+# are exposed as attributes on the Connection object.
+#
+# Revision 1.9  2003/08/13 01:16:36  zenzen
+# Minor tweak from Stefan Fleiter
+#
+# Revision 1.8  2003/04/10 00:13:25  zenzen
+# Changes, as per suggestions by M.-A. Lemburg
+# - Add a table prefix, to ensure namespace collisions can always be avoided
+#
+# Revision 1.7  2003/02/26 23:33:37  zenzen
+# Break out DDL into helper functions, as per request by David Rushby
+#
+# Revision 1.6  2003/02/21 03:04:33  zenzen
+# Stuff from Henrik Ekelund:
+#     added test_None
+#     added test_nextset & hooks
+#
+# Revision 1.5  2003/02/17 22:08:43  zenzen
+# Implement suggestions and code from Henrik Eklund - test that cursor.arraysize
+# defaults to 1 & generic cursor.callproc test added
+#
+# Revision 1.4  2003/02/15 00:16:33  zenzen
+# Changes, as per suggestions and bug reports by M.-A. Lemburg,
+# Matthew T. Kromer, Federico Di Gregorio and Daniel Dittmar
+# - Class renamed
+# - Now a subclass of TestCase, to avoid requiring the driver stub
+#   to use multiple inheritance
+# - Reversed the polarity of buggy test in test_description
+# - Test exception heirarchy correctly
+# - self.populate is now self._populate(), so if a driver stub
+#   overrides self.ddl1 this change propogates
+# - VARCHAR columns now have a width, which will hopefully make the
+#   DDL even more portible (this will be reversed if it causes more problems)
+# - cursor.rowcount being checked after various execute and fetchXXX methods
+# - Check for fetchall and fetchmany returning empty lists after results
+#   are exhausted (already checking for empty lists if select retrieved
+#   nothing
+# - Fix bugs in test_setoutputsize_basic and test_setinputsizes
+#
+def str2bytes(sval):
+    if sys.version_info < (3, 0) and isinstance(sval, str):
+        sval = sval.decode("latin1")
+    return sval.encode("latin1")  # python 3 make unicode into bytes
+
+
+class DatabaseAPI20Test(unittest.TestCase):
+    """Test a database self.driver for DB API 2.0 compatibility.
+    This implementation tests Gadfly, but the TestCase
+    is structured so that other self.drivers can subclass this
+    test case to ensure compiliance with the DB-API. It is
+    expected that this TestCase may be expanded in the future
+    if ambiguities or edge conditions are discovered.
+
+    The 'Optional Extensions' are not yet being tested.
+
+    self.drivers should subclass this test, overriding setUp, tearDown,
+    self.driver, connect_args and connect_kw_args. Class specification
+    should be as follows:
+
+    import dbapi20
+    class mytest(dbapi20.DatabaseAPI20Test):
+       [...]
+
+    Don't 'import DatabaseAPI20Test from dbapi20', or you will
+    confuse the unit tester - just 'import dbapi20'.
+    """
+
+    # The self.driver module. This should be the module where the 'connect'
+    # method is to be found
+    driver = None
+    connect_args = ()  # List of arguments to pass to connect
+    connect_kw_args = {}  # Keyword arguments for connect
+    table_prefix = "dbapi20test_"  # If you need to specify a prefix for tables
+
+    ddl1 = "create table %sbooze (name varchar(20))" % table_prefix
+    ddl2 = "create table %sbarflys (name varchar(20), drink varchar(30))" % table_prefix
+    xddl1 = "drop table %sbooze" % table_prefix
+    xddl2 = "drop table %sbarflys" % table_prefix
+
+    lowerfunc = "lower"  # Name of stored procedure to convert string->lowercase
+
+    # Some drivers may need to override these helpers, for example adding
+    # a 'commit' after the execute.
+    def executeDDL1(self, cursor):
+        cursor.execute(self.ddl1)
+
+    def executeDDL2(self, cursor):
+        cursor.execute(self.ddl2)
+
+    def setUp(self):
+        """self.drivers should override this method to perform required setup
+        if any is necessary, such as creating the database.
+        """
+        pass
+
+    def tearDown(self):
+        """self.drivers should override this method to perform required cleanup
+        if any is necessary, such as deleting the test database.
+        The default drops the tables that may be created.
+        """
+        try:
+            con = self._connect()
+            try:
+                cur = con.cursor()
+                for ddl in (self.xddl1, self.xddl2):
+                    try:
+                        cur.execute(ddl)
+                        con.commit()
+                    except self.driver.Error:
+                        # Assume table didn't exist. Other tests will check if
+                        # execute is busted.
+                        pass
+            finally:
+                con.close()
+        except _BaseException:
+            pass
+
+    def _connect(self):
+        try:
+            r = self.driver.connect(*self.connect_args, **self.connect_kw_args)
+        except AttributeError:
+            self.fail("No connect method found in self.driver module")
+        return r
+
+    def test_connect(self):
+        con = self._connect()
+        con.close()
+
+    def test_apilevel(self):
+        try:
+            # Must exist
+            apilevel = self.driver.apilevel
+            # Must equal 2.0
+            self.assertEqual(apilevel, "2.0")
+        except AttributeError:
+            self.fail("Driver doesn't define apilevel")
+
+    def test_threadsafety(self):
+        try:
+            # Must exist
+            threadsafety = self.driver.threadsafety
+            # Must be a valid value
+            _failUnless(self, threadsafety in (0, 1, 2, 3))
+        except AttributeError:
+            self.fail("Driver doesn't define threadsafety")
+
+    def test_paramstyle(self):
+        try:
+            # Must exist
+            paramstyle = self.driver.paramstyle
+            # Must be a valid value
+            _failUnless(
+                self, paramstyle in ("qmark", "numeric", "named", "format", "pyformat")
+            )
+        except AttributeError:
+            self.fail("Driver doesn't define paramstyle")
+
+    def test_Exceptions(self):
+        # Make sure required exceptions exist, and are in the
+        # defined heirarchy.
+        if sys.version[0] == "3":  # under Python 3 StardardError no longer exists
+            self.assertTrue(issubclass(self.driver.Warning, Exception))
+            self.assertTrue(issubclass(self.driver.Error, Exception))
+        else:
+            self.failUnless(issubclass(self.driver.Warning, Exception))
+            self.failUnless(issubclass(self.driver.Error, Exception))
+
+        _failUnless(self, issubclass(self.driver.InterfaceError, self.driver.Error))
+        _failUnless(self, issubclass(self.driver.DatabaseError, self.driver.Error))
+        _failUnless(self, issubclass(self.driver.OperationalError, self.driver.Error))
+        _failUnless(self, issubclass(self.driver.IntegrityError, self.driver.Error))
+        _failUnless(self, issubclass(self.driver.InternalError, self.driver.Error))
+        _failUnless(self, issubclass(self.driver.ProgrammingError, self.driver.Error))
+        _failUnless(self, issubclass(self.driver.NotSupportedError, self.driver.Error))
+
+    def test_ExceptionsAsConnectionAttributes(self):
+        # OPTIONAL EXTENSION
+        # Test for the optional DB API 2.0 extension, where the exceptions
+        # are exposed as attributes on the Connection object
+        # I figure this optional extension will be implemented by any
+        # driver author who is using this test suite, so it is enabled
+        # by default.
+        con = self._connect()
+        drv = self.driver
+        _failUnless(self, con.Warning is drv.Warning)
+        _failUnless(self, con.Error is drv.Error)
+        _failUnless(self, con.InterfaceError is drv.InterfaceError)
+        _failUnless(self, con.DatabaseError is drv.DatabaseError)
+        _failUnless(self, con.OperationalError is drv.OperationalError)
+        _failUnless(self, con.IntegrityError is drv.IntegrityError)
+        _failUnless(self, con.InternalError is drv.InternalError)
+        _failUnless(self, con.ProgrammingError is drv.ProgrammingError)
+        _failUnless(self, con.NotSupportedError is drv.NotSupportedError)
+
+    def test_commit(self):
+        con = self._connect()
+        try:
+            # Commit must work, even if it doesn't do anything
+            con.commit()
+        finally:
+            con.close()
+
+    def test_rollback(self):
+        con = self._connect()
+        # If rollback is defined, it should either work or throw
+        # the documented exception
+        if hasattr(con, "rollback"):
+            try:
+                con.rollback()
+            except self.driver.NotSupportedError:
+                pass
+
+    def test_cursor(self):
+        con = self._connect()
+        try:
+            cur = con.cursor()
+        finally:
+            con.close()
+
+    def test_cursor_isolation(self):
+        con = self._connect()
+        try:
+            # Make sure cursors created from the same connection have
+            # the documented transaction isolation level
+            cur1 = con.cursor()
+            cur2 = con.cursor()
+            self.executeDDL1(cur1)
+            cur1.execute(
+                "insert into %sbooze values ('Victoria Bitter')" % (self.table_prefix)
+            )
+            cur2.execute("select name from %sbooze" % self.table_prefix)
+            booze = cur2.fetchall()
+            self.assertEqual(len(booze), 1)
+            self.assertEqual(len(booze[0]), 1)
+            self.assertEqual(booze[0][0], "Victoria Bitter")
+        finally:
+            con.close()
+
+    def test_description(self):
+        con = self._connect()
+        try:
+            cur = con.cursor()
+            self.executeDDL1(cur)
+            self.assertEqual(
+                cur.description,
+                None,
+                "cursor.description should be none after executing a "
+                "statement that can return no rows (such as DDL)",
+            )
+            cur.execute("select name from %sbooze" % self.table_prefix)
+            self.assertEqual(
+                len(cur.description), 1, "cursor.description describes too many columns"
+            )
+            self.assertEqual(
+                len(cur.description[0]),
+                7,
+                "cursor.description[x] tuples must have 7 elements",
+            )
+            self.assertEqual(
+                cur.description[0][0].lower(),
+                "name",
+                "cursor.description[x][0] must return column name",
+            )
+            self.assertEqual(
+                cur.description[0][1],
+                self.driver.STRING,
+                "cursor.description[x][1] must return column type. Got %r"
+                % cur.description[0][1],
+            )
+
+            # Make sure self.description gets reset
+            self.executeDDL2(cur)
+            self.assertEqual(
+                cur.description,
+                None,
+                "cursor.description not being set to None when executing "
+                "no-result statements (eg. DDL)",
+            )
+        finally:
+            con.close()
+
+    def test_rowcount(self):
+        con = self._connect()
+        try:
+            cur = con.cursor()
+            self.executeDDL1(cur)
+            _failUnless(
+                self,
+                cur.rowcount in (-1, 0),  # Bug #543885
+                "cursor.rowcount should be -1 or 0 after executing no-result "
+                "statements",
+            )
+            cur.execute(
+                "insert into %sbooze values ('Victoria Bitter')" % (self.table_prefix)
+            )
+            _failUnless(
+                self,
+                cur.rowcount in (-1, 1),
+                "cursor.rowcount should == number or rows inserted, or "
+                "set to -1 after executing an insert statement",
+            )
+            cur.execute("select name from %sbooze" % self.table_prefix)
+            _failUnless(
+                self,
+                cur.rowcount in (-1, 1),
+                "cursor.rowcount should == number of rows returned, or "
+                "set to -1 after executing a select statement",
+            )
+            self.executeDDL2(cur)
+            self.assertEqual(
+                cur.rowcount,
+                -1,
+                "cursor.rowcount not being reset to -1 after executing "
+                "no-result statements",
+            )
+        finally:
+            con.close()
+
+    lower_func = "lower"
+
+    def test_callproc(self):
+        con = self._connect()
+        try:
+            cur = con.cursor()
+            if self.lower_func and hasattr(cur, "callproc"):
+                r = cur.callproc(self.lower_func, ("FOO",))
+                self.assertEqual(len(r), 1)
+                self.assertEqual(r[0], "FOO")
+                r = cur.fetchall()
+                self.assertEqual(len(r), 1, "callproc produced no result set")
+                self.assertEqual(len(r[0]), 1, "callproc produced invalid result set")
+                self.assertEqual(r[0][0], "foo", "callproc produced invalid results")
+        finally:
+            con.close()
+
+    def test_close(self):
+        con = self._connect()
+        try:
+            cur = con.cursor()
+        finally:
+            con.close()
+
+        # cursor.execute should raise an Error if called after connection
+        # closed
+        self.assertRaises(self.driver.Error, self.executeDDL1, cur)
+
+        # connection.commit should raise an Error if called after connection'
+        # closed.'
+        self.assertRaises(self.driver.Error, con.commit)
+
+        # connection.close should raise an Error if called more than once
+        #!!! reasonable persons differ about the usefulness of this test and this feature !!!
+        if TEST_FOR_NON_IDEMPOTENT_CLOSE:
+            self.assertRaises(self.driver.Error, con.close)
+        else:
+            self.skipTest(
+                "Non-idempotent close is considered a bad thing by some people."
+            )
+
+    def test_execute(self):
+        con = self._connect()
+        try:
+            cur = con.cursor()
+            self._paraminsert(cur)
+        finally:
+            con.close()
+
+    def _paraminsert(self, cur):
+        self.executeDDL2(cur)
+        cur.execute(
+            "insert into %sbarflys values ('Victoria Bitter', 'thi%%s :may ca%%(u)se? troub:1e')"
+            % (self.table_prefix)
+        )
+        _failUnless(self, cur.rowcount in (-1, 1))
+
+        if self.driver.paramstyle == "qmark":
+            cur.execute(
+                "insert into %sbarflys values (?, 'thi%%s :may ca%%(u)se? troub:1e')"
+                % self.table_prefix,
+                ("Cooper's",),
+            )
+        elif self.driver.paramstyle == "numeric":
+            cur.execute(
+                "insert into %sbarflys values (:1, 'thi%%s :may ca%%(u)se? troub:1e')"
+                % self.table_prefix,
+                ("Cooper's",),
+            )
+        elif self.driver.paramstyle == "named":
+            cur.execute(
+                "insert into %sbarflys values (:beer, 'thi%%s :may ca%%(u)se? troub:1e')"
+                % self.table_prefix,
+                {"beer": "Cooper's"},
+            )
+        elif self.driver.paramstyle == "format":
+            cur.execute(
+                "insert into %sbarflys values (%%s, 'thi%%s :may ca%%(u)se? troub:1e')"
+                % self.table_prefix,
+                ("Cooper's",),
+            )
+        elif self.driver.paramstyle == "pyformat":
+            cur.execute(
+                "insert into %sbarflys values (%%(beer)s, 'thi%%s :may ca%%(u)se? troub:1e')"
+                % self.table_prefix,
+                {"beer": "Cooper's"},
+            )
+        else:
+            self.fail("Invalid paramstyle")
+        _failUnless(self, cur.rowcount in (-1, 1))
+
+        cur.execute("select name, drink from %sbarflys" % self.table_prefix)
+        res = cur.fetchall()
+        self.assertEqual(len(res), 2, "cursor.fetchall returned too few rows")
+        beers = [res[0][0], res[1][0]]
+        beers.sort()
+        self.assertEqual(
+            beers[0],
+            "Cooper's",
+            "cursor.fetchall retrieved incorrect data, or data inserted " "incorrectly",
+        )
+        self.assertEqual(
+            beers[1],
+            "Victoria Bitter",
+            "cursor.fetchall retrieved incorrect data, or data inserted " "incorrectly",
+        )
+        trouble = "thi%s :may ca%(u)se? troub:1e"
+        self.assertEqual(
+            res[0][1],
+            trouble,
+            "cursor.fetchall retrieved incorrect data, or data inserted "
+            "incorrectly. Got=%s, Expected=%s" % (repr(res[0][1]), repr(trouble)),
+        )
+        self.assertEqual(
+            res[1][1],
+            trouble,
+            "cursor.fetchall retrieved incorrect data, or data inserted "
+            "incorrectly. Got=%s, Expected=%s" % (repr(res[1][1]), repr(trouble)),
+        )
+
+    def test_executemany(self):
+        con = self._connect()
+        try:
+            cur = con.cursor()
+            self.executeDDL1(cur)
+            largs = [("Cooper's",), ("Boag's",)]
+            margs = [{"beer": "Cooper's"}, {"beer": "Boag's"}]
+            if self.driver.paramstyle == "qmark":
+                cur.executemany(
+                    "insert into %sbooze values (?)" % self.table_prefix, largs
+                )
+            elif self.driver.paramstyle == "numeric":
+                cur.executemany(
+                    "insert into %sbooze values (:1)" % self.table_prefix, largs
+                )
+            elif self.driver.paramstyle == "named":
+                cur.executemany(
+                    "insert into %sbooze values (:beer)" % self.table_prefix, margs
+                )
+            elif self.driver.paramstyle == "format":
+                cur.executemany(
+                    "insert into %sbooze values (%%s)" % self.table_prefix, largs
+                )
+            elif self.driver.paramstyle == "pyformat":
+                cur.executemany(
+                    "insert into %sbooze values (%%(beer)s)" % (self.table_prefix),
+                    margs,
+                )
+            else:
+                self.fail("Unknown paramstyle")
+            _failUnless(
+                self,
+                cur.rowcount in (-1, 2),
+                "insert using cursor.executemany set cursor.rowcount to "
+                "incorrect value %r" % cur.rowcount,
+            )
+            cur.execute("select name from %sbooze" % self.table_prefix)
+            res = cur.fetchall()
+            self.assertEqual(
+                len(res), 2, "cursor.fetchall retrieved incorrect number of rows"
+            )
+            beers = [res[0][0], res[1][0]]
+            beers.sort()
+            self.assertEqual(
+                beers[0], "Boag's", 'incorrect data "%s" retrieved' % beers[0]
+            )
+            self.assertEqual(beers[1], "Cooper's", "incorrect data retrieved")
+        finally:
+            con.close()
+
+    def test_fetchone(self):
+        con = self._connect()
+        try:
+            cur = con.cursor()
+
+            # cursor.fetchone should raise an Error if called before
+            # executing a select-type query
+            self.assertRaises(self.driver.Error, cur.fetchone)
+
+            # cursor.fetchone should raise an Error if called after
+            # executing a query that cannnot return rows
+            self.executeDDL1(cur)
+            self.assertRaises(self.driver.Error, cur.fetchone)
+
+            cur.execute("select name from %sbooze" % self.table_prefix)
+            self.assertEqual(
+                cur.fetchone(),
+                None,
+                "cursor.fetchone should return None if a query retrieves " "no rows",
+            )
+            _failUnless(self, cur.rowcount in (-1, 0))
+
+            # cursor.fetchone should raise an Error if called after
+            # executing a query that cannnot return rows
+            cur.execute(
+                "insert into %sbooze values ('Victoria Bitter')" % (self.table_prefix)
+            )
+            self.assertRaises(self.driver.Error, cur.fetchone)
+
+            cur.execute("select name from %sbooze" % self.table_prefix)
+            r = cur.fetchone()
+            self.assertEqual(
+                len(r), 1, "cursor.fetchone should have retrieved a single row"
+            )
+            self.assertEqual(
+                r[0], "Victoria Bitter", "cursor.fetchone retrieved incorrect data"
+            )
+            self.assertEqual(
+                cur.fetchone(),
+                None,
+                "cursor.fetchone should return None if no more rows available",
+            )
+            _failUnless(self, cur.rowcount in (-1, 1))
+        finally:
+            con.close()
+
+    samples = [
+        "Carlton Cold",
+        "Carlton Draft",
+        "Mountain Goat",
+        "Redback",
+        "Victoria Bitter",
+        "XXXX",
+    ]
+
+    def _populate(self):
+        """Return a list of sql commands to setup the DB for the fetch
+        tests.
+        """
+        populate = [
+            "insert into %sbooze values ('%s')" % (self.table_prefix, s)
+            for s in self.samples
+        ]
+        return populate
+
+    def test_fetchmany(self):
+        con = self._connect()
+        try:
+            cur = con.cursor()
+
+            # cursor.fetchmany should raise an Error if called without
+            # issuing a query
+            self.assertRaises(self.driver.Error, cur.fetchmany, 4)
+
+            self.executeDDL1(cur)
+            for sql in self._populate():
+                cur.execute(sql)
+
+            cur.execute("select name from %sbooze" % self.table_prefix)
+            r = cur.fetchmany()
+            self.assertEqual(
+                len(r),
+                1,
+                "cursor.fetchmany retrieved incorrect number of rows, "
+                "default of arraysize is one.",
+            )
+            cur.arraysize = 10
+            r = cur.fetchmany(3)  # Should get 3 rows
+            self.assertEqual(
+                len(r), 3, "cursor.fetchmany retrieved incorrect number of rows"
+            )
+            r = cur.fetchmany(4)  # Should get 2 more
+            self.assertEqual(
+                len(r), 2, "cursor.fetchmany retrieved incorrect number of rows"
+            )
+            r = cur.fetchmany(4)  # Should be an empty sequence
+            self.assertEqual(
+                len(r),
+                0,
+                "cursor.fetchmany should return an empty sequence after "
+                "results are exhausted",
+            )
+            _failUnless(self, cur.rowcount in (-1, 6))
+
+            # Same as above, using cursor.arraysize
+            cur.arraysize = 4
+            cur.execute("select name from %sbooze" % self.table_prefix)
+            r = cur.fetchmany()  # Should get 4 rows
+            self.assertEqual(
+                len(r), 4, "cursor.arraysize not being honoured by fetchmany"
+            )
+            r = cur.fetchmany()  # Should get 2 more
+            self.assertEqual(len(r), 2)
+            r = cur.fetchmany()  # Should be an empty sequence
+            self.assertEqual(len(r), 0)
+            _failUnless(self, cur.rowcount in (-1, 6))
+
+            cur.arraysize = 6
+            cur.execute("select name from %sbooze" % self.table_prefix)
+            rows = cur.fetchmany()  # Should get all rows
+            _failUnless(self, cur.rowcount in (-1, 6))
+            self.assertEqual(len(rows), 6)
+            self.assertEqual(len(rows), 6)
+            rows = [r[0] for r in rows]
+            rows.sort()
+
+            # Make sure we get the right data back out
+            for i in range(0, 6):
+                self.assertEqual(
+                    rows[i],
+                    self.samples[i],
+                    "incorrect data retrieved by cursor.fetchmany",
+                )
+
+            rows = cur.fetchmany()  # Should return an empty list
+            self.assertEqual(
+                len(rows),
+                0,
+                "cursor.fetchmany should return an empty sequence if "
+                "called after the whole result set has been fetched",
+            )
+            _failUnless(self, cur.rowcount in (-1, 6))
+
+            self.executeDDL2(cur)
+            cur.execute("select name from %sbarflys" % self.table_prefix)
+            r = cur.fetchmany()  # Should get empty sequence
+            self.assertEqual(
+                len(r),
+                0,
+                "cursor.fetchmany should return an empty sequence if "
+                "query retrieved no rows",
+            )
+            _failUnless(self, cur.rowcount in (-1, 0))
+
+        finally:
+            con.close()
+
+    def test_fetchall(self):
+        con = self._connect()
+        try:
+            cur = con.cursor()
+            # cursor.fetchall should raise an Error if called
+            # without executing a query that may return rows (such
+            # as a select)
+            self.assertRaises(self.driver.Error, cur.fetchall)
+
+            self.executeDDL1(cur)
+            for sql in self._populate():
+                cur.execute(sql)
+
+            # cursor.fetchall should raise an Error if called
+            # after executing a a statement that cannot return rows
+            self.assertRaises(self.driver.Error, cur.fetchall)
+
+            cur.execute("select name from %sbooze" % self.table_prefix)
+            rows = cur.fetchall()
+            _failUnless(self, cur.rowcount in (-1, len(self.samples)))
+            self.assertEqual(
+                len(rows),
+                len(self.samples),
+                "cursor.fetchall did not retrieve all rows",
+            )
+            rows = [r[0] for r in rows]
+            rows.sort()
+            for i in range(0, len(self.samples)):
+                self.assertEqual(
+                    rows[i], self.samples[i], "cursor.fetchall retrieved incorrect rows"
+                )
+            rows = cur.fetchall()
+            self.assertEqual(
+                len(rows),
+                0,
+                "cursor.fetchall should return an empty list if called "
+                "after the whole result set has been fetched",
+            )
+            _failUnless(self, cur.rowcount in (-1, len(self.samples)))
+
+            self.executeDDL2(cur)
+            cur.execute("select name from %sbarflys" % self.table_prefix)
+            rows = cur.fetchall()
+            _failUnless(self, cur.rowcount in (-1, 0))
+            self.assertEqual(
+                len(rows),
+                0,
+                "cursor.fetchall should return an empty list if "
+                "a select query returns no rows",
+            )
+
+        finally:
+            con.close()
+
+    def test_mixedfetch(self):
+        con = self._connect()
+        try:
+            cur = con.cursor()
+            self.executeDDL1(cur)
+            for sql in self._populate():
+                cur.execute(sql)
+
+            cur.execute("select name from %sbooze" % self.table_prefix)
+            rows1 = cur.fetchone()
+            rows23 = cur.fetchmany(2)
+            rows4 = cur.fetchone()
+            rows56 = cur.fetchall()
+            _failUnless(self, cur.rowcount in (-1, 6))
+            self.assertEqual(
+                len(rows23), 2, "fetchmany returned incorrect number of rows"
+            )
+            self.assertEqual(
+                len(rows56), 2, "fetchall returned incorrect number of rows"
+            )
+
+            rows = [rows1[0]]
+            rows.extend([rows23[0][0], rows23[1][0]])
+            rows.append(rows4[0])
+            rows.extend([rows56[0][0], rows56[1][0]])
+            rows.sort()
+            for i in range(0, len(self.samples)):
+                self.assertEqual(
+                    rows[i], self.samples[i], "incorrect data retrieved or inserted"
+                )
+        finally:
+            con.close()
+
+    def help_nextset_setUp(self, cur):
+        """Should create a procedure called deleteme
+        that returns two result sets, first the
+        number of rows in booze then "name from booze"
+        """
+        raise NotImplementedError("Helper not implemented")
+        # sql="""
+        #    create procedure deleteme as
+        #    begin
+        #        select count(*) from booze
+        #        select name from booze
+        #    end
+        # """
+        # cur.execute(sql)
+
+    def help_nextset_tearDown(self, cur):
+        "If cleaning up is needed after nextSetTest"
+        raise NotImplementedError("Helper not implemented")
+        # cur.execute("drop procedure deleteme")
+
+    def test_nextset(self):
+        con = self._connect()
+        try:
+            cur = con.cursor()
+            if not hasattr(cur, "nextset"):
+                return
+
+            try:
+                self.executeDDL1(cur)
+                sql = self._populate()
+                for sql in self._populate():
+                    cur.execute(sql)
+
+                self.help_nextset_setUp(cur)
+
+                cur.callproc("deleteme")
+                numberofrows = cur.fetchone()
+                assert numberofrows[0] == len(self.samples)
+                assert cur.nextset()
+                names = cur.fetchall()
+                assert len(names) == len(self.samples)
+                s = cur.nextset()
+                assert s == None, "No more return sets, should return None"
+            finally:
+                self.help_nextset_tearDown(cur)
+
+        finally:
+            con.close()
+
+    def test_nextset(self):
+        raise NotImplementedError("Drivers need to override this test")
+
+    def test_arraysize(self):
+        # Not much here - rest of the tests for this are in test_fetchmany
+        con = self._connect()
+        try:
+            cur = con.cursor()
+            _failUnless(
+                self, hasattr(cur, "arraysize"), "cursor.arraysize must be defined"
+            )
+        finally:
+            con.close()
+
+    def test_setinputsizes(self):
+        con = self._connect()
+        try:
+            cur = con.cursor()
+            cur.setinputsizes((25,))
+            self._paraminsert(cur)  # Make sure cursor still works
+        finally:
+            con.close()
+
+    def test_setoutputsize_basic(self):
+        # Basic test is to make sure setoutputsize doesn't blow up
+        con = self._connect()
+        try:
+            cur = con.cursor()
+            cur.setoutputsize(1000)
+            cur.setoutputsize(2000, 0)
+            self._paraminsert(cur)  # Make sure the cursor still works
+        finally:
+            con.close()
+
+    def test_setoutputsize(self):
+        # Real test for setoutputsize is driver dependant
+        raise NotImplementedError("Driver needed to override this test")
+
+    def test_None(self):
+        con = self._connect()
+        try:
+            cur = con.cursor()
+            self.executeDDL1(cur)
+            cur.execute("insert into %sbooze values (NULL)" % self.table_prefix)
+            cur.execute("select name from %sbooze" % self.table_prefix)
+            r = cur.fetchall()
+            self.assertEqual(len(r), 1)
+            self.assertEqual(len(r[0]), 1)
+            self.assertEqual(r[0][0], None, "NULL value not returned as None")
+        finally:
+            con.close()
+
+    def test_Date(self):
+        d1 = self.driver.Date(2002, 12, 25)
+        d2 = self.driver.DateFromTicks(time.mktime((2002, 12, 25, 0, 0, 0, 0, 0, 0)))
+        # Can we assume this? API doesn't specify, but it seems implied
+        # self.assertEqual(str(d1),str(d2))
+
+    def test_Time(self):
+        t1 = self.driver.Time(13, 45, 30)
+        t2 = self.driver.TimeFromTicks(time.mktime((2001, 1, 1, 13, 45, 30, 0, 0, 0)))
+        # Can we assume this? API doesn't specify, but it seems implied
+        # self.assertEqual(str(t1),str(t2))
+
+    def test_Timestamp(self):
+        t1 = self.driver.Timestamp(2002, 12, 25, 13, 45, 30)
+        t2 = self.driver.TimestampFromTicks(
+            time.mktime((2002, 12, 25, 13, 45, 30, 0, 0, 0))
+        )
+        # Can we assume this? API doesn't specify, but it seems implied
+        # self.assertEqual(str(t1),str(t2))
+
+    def test_Binary(self):
+        b = self.driver.Binary(str2bytes("Something"))
+        b = self.driver.Binary(str2bytes(""))
+
+    def test_STRING(self):
+        _failUnless(
+            self, hasattr(self.driver, "STRING"), "module.STRING must be defined"
+        )
+
+    def test_BINARY(self):
+        _failUnless(
+            self, hasattr(self.driver, "BINARY"), "module.BINARY must be defined."
+        )
+
+    def test_NUMBER(self):
+        _failUnless(
+            self, hasattr(self.driver, "NUMBER"), "module.NUMBER must be defined."
+        )
+
+    def test_DATETIME(self):
+        _failUnless(
+            self, hasattr(self.driver, "DATETIME"), "module.DATETIME must be defined."
+        )
+
+    def test_ROWID(self):
+        _failUnless(
+            self, hasattr(self.driver, "ROWID"), "module.ROWID must be defined."
+        )
diff --git a/lib/adodbapi/test/is64bit.py b/lib/adodbapi/test/is64bit.py
new file mode 100644
index 00000000..39834540
--- /dev/null
+++ b/lib/adodbapi/test/is64bit.py
@@ -0,0 +1,41 @@
+"""is64bit.Python() --> boolean value of detected Python word size. is64bit.os() --> os build version"""
+import sys
+
+
+def Python():
+    if sys.platform == "cli":  # IronPython
+        import System
+
+        return System.IntPtr.Size == 8
+    else:
+        try:
+            return sys.maxsize > 2147483647
+        except AttributeError:
+            return sys.maxint > 2147483647
+
+
+def os():
+    import platform
+
+    pm = platform.machine()
+    if pm != ".." and pm.endswith("64"):  # recent Python (not Iron)
+        return True
+    else:
+        import os
+
+        if "PROCESSOR_ARCHITEW6432" in os.environ:
+            return True  # 32 bit program running on 64 bit Windows
+        try:
+            return os.environ["PROCESSOR_ARCHITECTURE"].endswith(
+                "64"
+            )  # 64 bit Windows 64 bit program
+        except IndexError:
+            pass  # not Windows
+        try:
+            return "64" in platform.architecture()[0]  # this often works in Linux
+        except:
+            return False  # is an older version of Python, assume also an older os (best we can guess)
+
+
+if __name__ == "__main__":
+    print("is64bit.Python() =", Python(), "is64bit.os() =", os())
diff --git a/lib/adodbapi/test/setuptestframework.py b/lib/adodbapi/test/setuptestframework.py
new file mode 100644
index 00000000..fcaaf1ae
--- /dev/null
+++ b/lib/adodbapi/test/setuptestframework.py
@@ -0,0 +1,134 @@
+#!/usr/bin/python2
+# Configure this in order to run the testcases.
+"setuptestframework.py v 2.6.0.8"
+import os
+import shutil
+import sys
+import tempfile
+
+try:
+    OSErrors = (WindowsError, OSError)
+except NameError:  # not running on Windows
+    OSErrors = OSError
+
+
+def maketemp():
+    temphome = tempfile.gettempdir()
+    tempdir = os.path.join(temphome, "adodbapi_test")
+    try:
+        os.mkdir(tempdir)
+    except:
+        pass
+    return tempdir
+
+
+def _cleanup_function(testfolder, mdb_name):
+    try:
+        os.unlink(os.path.join(testfolder, mdb_name))
+    except:
+        pass  # mdb database not present
+    try:
+        shutil.rmtree(testfolder)
+        print("   cleaned up folder", testfolder)
+    except:
+        pass  # test package not present
+
+
+def getcleanupfunction():
+    return _cleanup_function
+
+
+def find_ado_path():
+    adoName = os.path.normpath(os.getcwd() + "/../../adodbapi.py")
+    adoPackage = os.path.dirname(adoName)
+    return adoPackage
+
+
+# make a new package directory for the test copy of ado
+def makeadopackage(testfolder):
+    adoName = os.path.normpath(os.getcwd() + "/../adodbapi.py")
+    adoPath = os.path.dirname(adoName)
+    if os.path.exists(adoName):
+        newpackage = os.path.join(testfolder, "adodbapi")
+        try:
+            os.mkdir(newpackage)
+        except OSErrors:
+            print(
+                "*Note: temporary adodbapi package already exists: may be two versions running?"
+            )
+        for f in os.listdir(adoPath):
+            if f.endswith(".py"):
+                shutil.copy(os.path.join(adoPath, f), newpackage)
+        if sys.version_info >= (3, 0):  # only when running Py3.n
+            save = sys.stdout
+            sys.stdout = None
+            from lib2to3.main import main  # use 2to3 to make test package
+
+            main("lib2to3.fixes", args=["-n", "-w", newpackage])
+            sys.stdout = save
+        return testfolder
+    else:
+        raise EnvironmentError("Connot find source of adodbapi to test.")
+
+
+def makemdb(testfolder, mdb_name):
+    # following setup code borrowed from pywin32 odbc test suite
+    # kindly contributed by Frank Millman.
+    import os
+
+    _accessdatasource = os.path.join(testfolder, mdb_name)
+    if os.path.isfile(_accessdatasource):
+        print("using JET database=", _accessdatasource)
+    else:
+        try:
+            from win32com.client import constants
+            from win32com.client.gencache import EnsureDispatch
+
+            win32 = True
+        except ImportError:  # perhaps we are running IronPython
+            win32 = False  # iron Python
+            try:
+                from System import Activator, Type
+            except:
+                pass
+
+        # Create a brand-new database - what is the story with these?
+        dbe = None
+        for suffix in (".36", ".35", ".30"):
+            try:
+                if win32:
+                    dbe = EnsureDispatch("DAO.DBEngine" + suffix)
+                else:
+                    type = Type.GetTypeFromProgID("DAO.DBEngine" + suffix)
+                    dbe = Activator.CreateInstance(type)
+                break
+            except:
+                pass
+        if dbe:
+            print("    ...Creating ACCESS db at " + _accessdatasource)
+            if win32:
+                workspace = dbe.Workspaces(0)
+                newdb = workspace.CreateDatabase(
+                    _accessdatasource, constants.dbLangGeneral, constants.dbVersion40
+                )
+            else:
+                newdb = dbe.CreateDatabase(
+                    _accessdatasource, ";LANGID=0x0409;CP=1252;COUNTRY=0"
+                )
+            newdb.Close()
+        else:
+            print("    ...copying test ACCESS db to " + _accessdatasource)
+            mdbName = os.path.abspath(
+                os.path.join(os.path.dirname(__file__), "..", "examples", "test.mdb")
+            )
+            import shutil
+
+            shutil.copy(mdbName, _accessdatasource)
+
+    return _accessdatasource
+
+
+if __name__ == "__main__":
+    print("Setting up a Jet database for server to use for remote testing...")
+    temp = maketemp()
+    makemdb(temp, "server_test.mdb")
diff --git a/lib/adodbapi/test/test_adodbapi_dbapi20.py b/lib/adodbapi/test/test_adodbapi_dbapi20.py
new file mode 100644
index 00000000..f8986484
--- /dev/null
+++ b/lib/adodbapi/test/test_adodbapi_dbapi20.py
@@ -0,0 +1,200 @@
+print("This module depends on the dbapi20 compliance tests created by Stuart Bishop")
+print("(see db-sig mailing list history for info)")
+import platform
+import sys
+import unittest
+
+import dbapi20
+import setuptestframework
+
+testfolder = setuptestframework.maketemp()
+if "--package" in sys.argv:
+    pth = setuptestframework.makeadopackage(testfolder)
+    sys.argv.remove("--package")
+else:
+    pth = setuptestframework.find_ado_path()
+if pth not in sys.path:
+    sys.path.insert(1, pth)
+# function to clean up the temporary folder -- calling program must run this function before exit.
+cleanup = setuptestframework.getcleanupfunction()
+
+import adodbapi
+import adodbapi.is64bit as is64bit
+
+db = adodbapi
+
+if "--verbose" in sys.argv:
+    db.adodbapi.verbose = 3
+
+print(adodbapi.version)
+print("Tested with dbapi20 %s" % dbapi20.__version__)
+
+try:
+    onWindows = bool(sys.getwindowsversion())  # seems to work on all versions of Python
+except:
+    onWindows = False
+
+node = platform.node()
+
+conn_kws = {}
+host = "testsql.2txt.us,1430"  # if None, will use macro to fill in node name
+instance = r"%s\SQLEXPRESS"
+conn_kws["name"] = "adotest"
+
+conn_kws["user"] = "adotestuser"  # None implies Windows security
+conn_kws["password"] = "Sq1234567"
+# macro definition for keyword "security" using macro "auto_security"
+conn_kws["macro_auto_security"] = "security"
+
+if host is None:
+    conn_kws["macro_getnode"] = ["host", instance]
+else:
+    conn_kws["host"] = host
+
+conn_kws[
+    "provider"
+] = "Provider=MSOLEDBSQL;DataTypeCompatibility=80;MARS Connection=True;"
+connStr = "%(provider)s; %(security)s; Initial Catalog=%(name)s;Data Source=%(host)s"
+
+if onWindows and node != "z-PC":
+    pass  # default should make a local SQL Server connection
+elif node == "xxx":  # try Postgres database
+    _computername = "25.223.161.222"
+    _databasename = "adotest"
+    _username = "adotestuser"
+    _password = "12345678"
+    _driver = "PostgreSQL Unicode"
+    _provider = ""
+    connStr = "%sDriver={%s};Server=%s;Database=%s;uid=%s;pwd=%s;" % (
+        _provider,
+        _driver,
+        _computername,
+        _databasename,
+        _username,
+        _password,
+    )
+elif node == "yyy":  # ACCESS data base is known to fail some tests.
+    if is64bit.Python():
+        driver = "Microsoft.ACE.OLEDB.12.0"
+    else:
+        driver = "Microsoft.Jet.OLEDB.4.0"
+    testmdb = setuptestframework.makemdb(testfolder)
+    connStr = r"Provider=%s;Data Source=%s" % (driver, testmdb)
+else:  # try a remote connection to an SQL server
+    conn_kws["proxy_host"] = "25.44.77.176"
+    import adodbapi.remote
+
+    db = adodbapi.remote
+
+print("Using Connection String like=%s" % connStr)
+print("Keywords=%s" % repr(conn_kws))
+
+
+class test_adodbapi(dbapi20.DatabaseAPI20Test):
+    driver = db
+    connect_args = (connStr,)
+    connect_kw_args = conn_kws
+
+    def __init__(self, arg):
+        dbapi20.DatabaseAPI20Test.__init__(self, arg)
+
+    def getTestMethodName(self):
+        return self.id().split(".")[-1]
+
+    def setUp(self):
+        # Call superclass setUp In case this does something in the
+        # future
+        dbapi20.DatabaseAPI20Test.setUp(self)
+        if self.getTestMethodName() == "test_callproc":
+            con = self._connect()
+            engine = con.dbms_name
+            ## print('Using database Engine=%s' % engine) ##
+            if engine != "MS Jet":
+                sql = """
+                    create procedure templower
+                        @theData varchar(50)
+                    as
+                        select lower(@theData)
+                """
+            else:  # Jet
+                sql = """
+                    create procedure templower
+                        (theData varchar(50))
+                    as
+                        select lower(theData);
+                """
+            cur = con.cursor()
+            try:
+                cur.execute(sql)
+                con.commit()
+            except:
+                pass
+            cur.close()
+            con.close()
+            self.lower_func = "templower"
+
+    def tearDown(self):
+        if self.getTestMethodName() == "test_callproc":
+            con = self._connect()
+            cur = con.cursor()
+            try:
+                cur.execute("drop procedure templower")
+            except:
+                pass
+            con.commit()
+        dbapi20.DatabaseAPI20Test.tearDown(self)
+
+    def help_nextset_setUp(self, cur):
+        "Should create a procedure called deleteme"
+        'that returns two result sets, first the number of rows in booze then "name from booze"'
+        sql = """
+            create procedure deleteme as
+            begin
+                select count(*) from %sbooze
+                select name from %sbooze
+            end
+        """ % (
+            self.table_prefix,
+            self.table_prefix,
+        )
+        cur.execute(sql)
+
+    def help_nextset_tearDown(self, cur):
+        "If cleaning up is needed after nextSetTest"
+        try:
+            cur.execute("drop procedure deleteme")
+        except:
+            pass
+
+    def test_nextset(self):
+        con = self._connect()
+        try:
+            cur = con.cursor()
+
+            stmts = [self.ddl1] + self._populate()
+            for sql in stmts:
+                cur.execute(sql)
+
+            self.help_nextset_setUp(cur)
+
+            cur.callproc("deleteme")
+            numberofrows = cur.fetchone()
+            assert numberofrows[0] == 6
+            assert cur.nextset()
+            names = cur.fetchall()
+            assert len(names) == len(self.samples)
+            s = cur.nextset()
+            assert s == None, "No more return sets, should return None"
+        finally:
+            try:
+                self.help_nextset_tearDown(cur)
+            finally:
+                con.close()
+
+    def test_setoutputsize(self):
+        pass
+
+
+if __name__ == "__main__":
+    unittest.main()
+    cleanup(testfolder, None)
diff --git a/lib/adodbapi/test/tryconnection.py b/lib/adodbapi/test/tryconnection.py
new file mode 100644
index 00000000..9d3901a8
--- /dev/null
+++ b/lib/adodbapi/test/tryconnection.py
@@ -0,0 +1,33 @@
+remote = False  # automatic testing of remote access has been removed here
+
+
+def try_connection(verbose, *args, **kwargs):
+    import adodbapi
+
+    dbconnect = adodbapi.connect
+    try:
+        s = dbconnect(*args, **kwargs)  # connect to server
+        if verbose:
+            print("Connected to:", s.connection_string)
+            print("which has tables:", s.get_table_names())
+        s.close()  # thanks, it worked, goodbye
+    except adodbapi.DatabaseError as inst:
+        print(inst.args[0])  # should be the error message
+        print("***Failed getting connection using=", repr(args), repr(kwargs))
+        return False, (args, kwargs), None
+
+    print("  (successful)")
+
+    return True, (args, kwargs, remote), dbconnect
+
+
+def try_operation_with_expected_exception(
+    expected_exception_list, some_function, *args, **kwargs
+):
+    try:
+        some_function(*args, **kwargs)
+    except expected_exception_list as e:
+        return True, e
+    except:
+        raise  # an exception other than the expected occurred
+    return False, "The expected exception did not occur"
diff --git a/lib/annotated_types/__init__.py b/lib/annotated_types/__init__.py
new file mode 100644
index 00000000..2f989504
--- /dev/null
+++ b/lib/annotated_types/__init__.py
@@ -0,0 +1,396 @@
+import math
+import sys
+from dataclasses import dataclass
+from datetime import timezone
+from typing import TYPE_CHECKING, Any, Callable, Iterator, Optional, SupportsFloat, SupportsIndex, TypeVar, Union
+
+if sys.version_info < (3, 8):
+    from typing_extensions import Protocol, runtime_checkable
+else:
+    from typing import Protocol, runtime_checkable
+
+if sys.version_info < (3, 9):
+    from typing_extensions import Annotated, Literal
+else:
+    from typing import Annotated, Literal
+
+if sys.version_info < (3, 10):
+    EllipsisType = type(Ellipsis)
+    KW_ONLY = {}
+    SLOTS = {}
+else:
+    from types import EllipsisType
+
+    KW_ONLY = {"kw_only": True}
+    SLOTS = {"slots": True}
+
+
+__all__ = (
+    'BaseMetadata',
+    'GroupedMetadata',
+    'Gt',
+    'Ge',
+    'Lt',
+    'Le',
+    'Interval',
+    'MultipleOf',
+    'MinLen',
+    'MaxLen',
+    'Len',
+    'Timezone',
+    'Predicate',
+    'LowerCase',
+    'UpperCase',
+    'IsDigits',
+    'IsFinite',
+    'IsNotFinite',
+    'IsNan',
+    'IsNotNan',
+    'IsInfinite',
+    'IsNotInfinite',
+    'doc',
+    'DocInfo',
+    '__version__',
+)
+
+__version__ = '0.6.0'
+
+
+T = TypeVar('T')
+
+
+# arguments that start with __ are considered
+# positional only
+# see https://peps.python.org/pep-0484/#positional-only-arguments
+
+
+class SupportsGt(Protocol):
+    def __gt__(self: T, __other: T) -> bool:
+        ...
+
+
+class SupportsGe(Protocol):
+    def __ge__(self: T, __other: T) -> bool:
+        ...
+
+
+class SupportsLt(Protocol):
+    def __lt__(self: T, __other: T) -> bool:
+        ...
+
+
+class SupportsLe(Protocol):
+    def __le__(self: T, __other: T) -> bool:
+        ...
+
+
+class SupportsMod(Protocol):
+    def __mod__(self: T, __other: T) -> T:
+        ...
+
+
+class SupportsDiv(Protocol):
+    def __div__(self: T, __other: T) -> T:
+        ...
+
+
+class BaseMetadata:
+    """Base class for all metadata.
+
+    This exists mainly so that implementers
+    can do `isinstance(..., BaseMetadata)` while traversing field annotations.
+    """
+
+    __slots__ = ()
+
+
+@dataclass(frozen=True, **SLOTS)
+class Gt(BaseMetadata):
+    """Gt(gt=x) implies that the value must be greater than x.
+
+    It can be used with any type that supports the ``>`` operator,
+    including numbers, dates and times, strings, sets, and so on.
+    """
+
+    gt: SupportsGt
+
+
+@dataclass(frozen=True, **SLOTS)
+class Ge(BaseMetadata):
+    """Ge(ge=x) implies that the value must be greater than or equal to x.
+
+    It can be used with any type that supports the ``>=`` operator,
+    including numbers, dates and times, strings, sets, and so on.
+    """
+
+    ge: SupportsGe
+
+
+@dataclass(frozen=True, **SLOTS)
+class Lt(BaseMetadata):
+    """Lt(lt=x) implies that the value must be less than x.
+
+    It can be used with any type that supports the ``<`` operator,
+    including numbers, dates and times, strings, sets, and so on.
+    """
+
+    lt: SupportsLt
+
+
+@dataclass(frozen=True, **SLOTS)
+class Le(BaseMetadata):
+    """Le(le=x) implies that the value must be less than or equal to x.
+
+    It can be used with any type that supports the ``<=`` operator,
+    including numbers, dates and times, strings, sets, and so on.
+    """
+
+    le: SupportsLe
+
+
+@runtime_checkable
+class GroupedMetadata(Protocol):
+    """A grouping of multiple BaseMetadata objects.
+
+    `GroupedMetadata` on its own is not metadata and has no meaning.
+    All it the the constraint and metadata should be fully expressable
+    in terms of the `BaseMetadata`'s returned by `GroupedMetadata.__iter__()`.
+
+    Concrete implementations should override `GroupedMetadata.__iter__()`
+    to add their own metadata.
+    For example:
+
+    >>> @dataclass
+    >>> class Field(GroupedMetadata):
+    >>>     gt: float | None = None
+    >>>     description: str | None = None
+    ...
+    >>>     def __iter__(self) -> Iterable[BaseMetadata]:
+    >>>         if self.gt is not None:
+    >>>             yield Gt(self.gt)
+    >>>         if self.description is not None:
+    >>>             yield Description(self.gt)
+
+    Also see the implementation of `Interval` below for an example.
+
+    Parsers should recognize this and unpack it so that it can be used
+    both with and without unpacking:
+
+    - `Annotated[int, Field(...)]` (parser must unpack Field)
+    - `Annotated[int, *Field(...)]` (PEP-646)
+    """  # noqa: trailing-whitespace
+
+    @property
+    def __is_annotated_types_grouped_metadata__(self) -> Literal[True]:
+        return True
+
+    def __iter__(self) -> Iterator[BaseMetadata]:
+        ...
+
+    if not TYPE_CHECKING:
+        __slots__ = ()  # allow subclasses to use slots
+
+        def __init_subclass__(cls, *args: Any, **kwargs: Any) -> None:
+            # Basic ABC like functionality without the complexity of an ABC
+            super().__init_subclass__(*args, **kwargs)
+            if cls.__iter__ is GroupedMetadata.__iter__:
+                raise TypeError("Can't subclass GroupedMetadata without implementing __iter__")
+
+        def __iter__(self) -> Iterator[BaseMetadata]:  # noqa: F811
+            raise NotImplementedError  # more helpful than "None has no attribute..." type errors
+
+
+@dataclass(frozen=True, **KW_ONLY, **SLOTS)
+class Interval(GroupedMetadata):
+    """Interval can express inclusive or exclusive bounds with a single object.
+
+    It accepts keyword arguments ``gt``, ``ge``, ``lt``, and/or ``le``, which
+    are interpreted the same way as the single-bound constraints.
+    """
+
+    gt: Union[SupportsGt, None] = None
+    ge: Union[SupportsGe, None] = None
+    lt: Union[SupportsLt, None] = None
+    le: Union[SupportsLe, None] = None
+
+    def __iter__(self) -> Iterator[BaseMetadata]:
+        """Unpack an Interval into zero or more single-bounds."""
+        if self.gt is not None:
+            yield Gt(self.gt)
+        if self.ge is not None:
+            yield Ge(self.ge)
+        if self.lt is not None:
+            yield Lt(self.lt)
+        if self.le is not None:
+            yield Le(self.le)
+
+
+@dataclass(frozen=True, **SLOTS)
+class MultipleOf(BaseMetadata):
+    """MultipleOf(multiple_of=x) might be interpreted in two ways:
+
+    1. Python semantics, implying ``value % multiple_of == 0``, or
+    2. JSONschema semantics, where ``int(value / multiple_of) == value / multiple_of``
+
+    We encourage users to be aware of these two common interpretations,
+    and libraries to carefully document which they implement.
+    """
+
+    multiple_of: Union[SupportsDiv, SupportsMod]
+
+
+@dataclass(frozen=True, **SLOTS)
+class MinLen(BaseMetadata):
+    """
+    MinLen() implies minimum inclusive length,
+    e.g. ``len(value) >= min_length``.
+    """
+
+    min_length: Annotated[int, Ge(0)]
+
+
+@dataclass(frozen=True, **SLOTS)
+class MaxLen(BaseMetadata):
+    """
+    MaxLen() implies maximum inclusive length,
+    e.g. ``len(value) <= max_length``.
+    """
+
+    max_length: Annotated[int, Ge(0)]
+
+
+@dataclass(frozen=True, **SLOTS)
+class Len(GroupedMetadata):
+    """
+    Len() implies that ``min_length <= len(value) <= max_length``.
+
+    Upper bound may be omitted or ``None`` to indicate no upper length bound.
+    """
+
+    min_length: Annotated[int, Ge(0)] = 0
+    max_length: Optional[Annotated[int, Ge(0)]] = None
+
+    def __iter__(self) -> Iterator[BaseMetadata]:
+        """Unpack a Len into zone or more single-bounds."""
+        if self.min_length > 0:
+            yield MinLen(self.min_length)
+        if self.max_length is not None:
+            yield MaxLen(self.max_length)
+
+
+@dataclass(frozen=True, **SLOTS)
+class Timezone(BaseMetadata):
+    """Timezone(tz=...) requires a datetime to be aware (or ``tz=None``, naive).
+
+    ``Annotated[datetime, Timezone(None)]`` must be a naive datetime.
+    ``Timezone[...]`` (the ellipsis literal) expresses that the datetime must be
+    tz-aware but any timezone is allowed.
+
+    You may also pass a specific timezone string or timezone object such as
+    ``Timezone(timezone.utc)`` or ``Timezone("Africa/Abidjan")`` to express that
+    you only allow a specific timezone, though we note that this is often
+    a symptom of poor design.
+    """
+
+    tz: Union[str, timezone, EllipsisType, None]
+
+
+@dataclass(frozen=True, **SLOTS)
+class Predicate(BaseMetadata):
+    """``Predicate(func: Callable)`` implies `func(value)` is truthy for valid values.
+
+    Users should prefer statically inspectable metadata, but if you need the full
+    power and flexibility of arbitrary runtime predicates... here it is.
+
+    We provide a few predefined predicates for common string constraints:
+    ``IsLower = Predicate(str.islower)``, ``IsUpper = Predicate(str.isupper)``, and
+    ``IsDigit = Predicate(str.isdigit)``. Users are encouraged to use methods which
+    can be given special handling, and avoid indirection like ``lambda s: s.lower()``.
+
+    Some libraries might have special logic to handle certain predicates, e.g. by
+    checking for `str.isdigit` and using its presence to both call custom logic to
+    enforce digit-only strings, and customise some generated external schema.
+
+    We do not specify what behaviour should be expected for predicates that raise
+    an exception.  For example `Annotated[int, Predicate(str.isdigit)]` might silently
+    skip invalid constraints, or statically raise an error; or it might try calling it
+    and then propogate or discard the resulting exception.
+    """
+
+    func: Callable[[Any], bool]
+
+
+@dataclass
+class Not:
+    func: Callable[[Any], bool]
+
+    def __call__(self, __v: Any) -> bool:
+        return not self.func(__v)
+
+
+_StrType = TypeVar("_StrType", bound=str)
+
+LowerCase = Annotated[_StrType, Predicate(str.islower)]
+"""
+Return True if the string is a lowercase string, False otherwise.
+
+A string is lowercase if all cased characters in the string are lowercase and there is at least one cased character in the string.
+"""  # noqa: E501
+UpperCase = Annotated[_StrType, Predicate(str.isupper)]
+"""
+Return True if the string is an uppercase string, False otherwise.
+
+A string is uppercase if all cased characters in the string are uppercase and there is at least one cased character in the string.
+"""  # noqa: E501
+IsDigits = Annotated[_StrType, Predicate(str.isdigit)]
+"""
+Return True if the string is a digit string, False otherwise.
+
+A string is a digit string if all characters in the string are digits and there is at least one character in the string.
+"""  # noqa: E501
+IsAscii = Annotated[_StrType, Predicate(str.isascii)]
+"""
+Return True if all characters in the string are ASCII, False otherwise.
+
+ASCII characters have code points in the range U+0000-U+007F. Empty string is ASCII too.
+"""
+
+_NumericType = TypeVar('_NumericType', bound=Union[SupportsFloat, SupportsIndex])
+IsFinite = Annotated[_NumericType, Predicate(math.isfinite)]
+"""Return True if x is neither an infinity nor a NaN, and False otherwise."""
+IsNotFinite = Annotated[_NumericType, Predicate(Not(math.isfinite))]
+"""Return True if x is one of infinity or NaN, and False otherwise"""
+IsNan = Annotated[_NumericType, Predicate(math.isnan)]
+"""Return True if x is a NaN (not a number), and False otherwise."""
+IsNotNan = Annotated[_NumericType, Predicate(Not(math.isnan))]
+"""Return True if x is anything but NaN (not a number), and False otherwise."""
+IsInfinite = Annotated[_NumericType, Predicate(math.isinf)]
+"""Return True if x is a positive or negative infinity, and False otherwise."""
+IsNotInfinite = Annotated[_NumericType, Predicate(Not(math.isinf))]
+"""Return True if x is neither a positive or negative infinity, and False otherwise."""
+
+try:
+    from typing_extensions import DocInfo, doc  # type: ignore [attr-defined]
+except ImportError:
+
+    @dataclass(frozen=True, **SLOTS)
+    class DocInfo:  # type: ignore [no-redef]
+        """ "
+        The return value of doc(), mainly to be used by tools that want to extract the
+        Annotated documentation at runtime.
+        """
+
+        documentation: str
+        """The documentation string passed to doc()."""
+
+    def doc(
+        documentation: str,
+    ) -> DocInfo:
+        """
+        Add documentation to a type annotation inside of Annotated.
+
+        For example:
+
+        >>> def hi(name: Annotated[int, doc("The name of the user")]) -> None: ...
+        """
+        return DocInfo(documentation)
diff --git a/lib/jaraco/classes/__init__.py b/lib/annotated_types/py.typed
similarity index 100%
rename from lib/jaraco/classes/__init__.py
rename to lib/annotated_types/py.typed
diff --git a/lib/annotated_types/test_cases.py b/lib/annotated_types/test_cases.py
new file mode 100644
index 00000000..f54df700
--- /dev/null
+++ b/lib/annotated_types/test_cases.py
@@ -0,0 +1,147 @@
+import math
+import sys
+from datetime import date, datetime, timedelta, timezone
+from decimal import Decimal
+from typing import Any, Dict, Iterable, Iterator, List, NamedTuple, Set, Tuple
+
+if sys.version_info < (3, 9):
+    from typing_extensions import Annotated
+else:
+    from typing import Annotated
+
+import annotated_types as at
+
+
+class Case(NamedTuple):
+    """
+    A test case for `annotated_types`.
+    """
+
+    annotation: Any
+    valid_cases: Iterable[Any]
+    invalid_cases: Iterable[Any]
+
+
+def cases() -> Iterable[Case]:
+    # Gt, Ge, Lt, Le
+    yield Case(Annotated[int, at.Gt(4)], (5, 6, 1000), (4, 0, -1))
+    yield Case(Annotated[float, at.Gt(0.5)], (0.6, 0.7, 0.8, 0.9), (0.5, 0.0, -0.1))
+    yield Case(
+        Annotated[datetime, at.Gt(datetime(2000, 1, 1))],
+        [datetime(2000, 1, 2), datetime(2000, 1, 3)],
+        [datetime(2000, 1, 1), datetime(1999, 12, 31)],
+    )
+    yield Case(
+        Annotated[datetime, at.Gt(date(2000, 1, 1))],
+        [date(2000, 1, 2), date(2000, 1, 3)],
+        [date(2000, 1, 1), date(1999, 12, 31)],
+    )
+    yield Case(
+        Annotated[datetime, at.Gt(Decimal('1.123'))],
+        [Decimal('1.1231'), Decimal('123')],
+        [Decimal('1.123'), Decimal('0')],
+    )
+
+    yield Case(Annotated[int, at.Ge(4)], (4, 5, 6, 1000, 4), (0, -1))
+    yield Case(Annotated[float, at.Ge(0.5)], (0.5, 0.6, 0.7, 0.8, 0.9), (0.4, 0.0, -0.1))
+    yield Case(
+        Annotated[datetime, at.Ge(datetime(2000, 1, 1))],
+        [datetime(2000, 1, 2), datetime(2000, 1, 3)],
+        [datetime(1998, 1, 1), datetime(1999, 12, 31)],
+    )
+
+    yield Case(Annotated[int, at.Lt(4)], (0, -1), (4, 5, 6, 1000, 4))
+    yield Case(Annotated[float, at.Lt(0.5)], (0.4, 0.0, -0.1), (0.5, 0.6, 0.7, 0.8, 0.9))
+    yield Case(
+        Annotated[datetime, at.Lt(datetime(2000, 1, 1))],
+        [datetime(1999, 12, 31), datetime(1999, 12, 31)],
+        [datetime(2000, 1, 2), datetime(2000, 1, 3)],
+    )
+
+    yield Case(Annotated[int, at.Le(4)], (4, 0, -1), (5, 6, 1000))
+    yield Case(Annotated[float, at.Le(0.5)], (0.5, 0.0, -0.1), (0.6, 0.7, 0.8, 0.9))
+    yield Case(
+        Annotated[datetime, at.Le(datetime(2000, 1, 1))],
+        [datetime(2000, 1, 1), datetime(1999, 12, 31)],
+        [datetime(2000, 1, 2), datetime(2000, 1, 3)],
+    )
+
+    # Interval
+    yield Case(Annotated[int, at.Interval(gt=4)], (5, 6, 1000), (4, 0, -1))
+    yield Case(Annotated[int, at.Interval(gt=4, lt=10)], (5, 6), (4, 10, 1000, 0, -1))
+    yield Case(Annotated[float, at.Interval(ge=0.5, le=1)], (0.5, 0.9, 1), (0.49, 1.1))
+    yield Case(
+        Annotated[datetime, at.Interval(gt=datetime(2000, 1, 1), le=datetime(2000, 1, 3))],
+        [datetime(2000, 1, 2), datetime(2000, 1, 3)],
+        [datetime(2000, 1, 1), datetime(2000, 1, 4)],
+    )
+
+    yield Case(Annotated[int, at.MultipleOf(multiple_of=3)], (0, 3, 9), (1, 2, 4))
+    yield Case(Annotated[float, at.MultipleOf(multiple_of=0.5)], (0, 0.5, 1, 1.5), (0.4, 1.1))
+
+    # lengths
+
+    yield Case(Annotated[str, at.MinLen(3)], ('123', '1234', 'x' * 10), ('', '1', '12'))
+    yield Case(Annotated[str, at.Len(3)], ('123', '1234', 'x' * 10), ('', '1', '12'))
+    yield Case(Annotated[List[int], at.MinLen(3)], ([1, 2, 3], [1, 2, 3, 4], [1] * 10), ([], [1], [1, 2]))
+    yield Case(Annotated[List[int], at.Len(3)], ([1, 2, 3], [1, 2, 3, 4], [1] * 10), ([], [1], [1, 2]))
+
+    yield Case(Annotated[str, at.MaxLen(4)], ('', '1234'), ('12345', 'x' * 10))
+    yield Case(Annotated[str, at.Len(0, 4)], ('', '1234'), ('12345', 'x' * 10))
+    yield Case(Annotated[List[str], at.MaxLen(4)], ([], ['a', 'bcdef'], ['a', 'b', 'c']), (['a'] * 5, ['b'] * 10))
+    yield Case(Annotated[List[str], at.Len(0, 4)], ([], ['a', 'bcdef'], ['a', 'b', 'c']), (['a'] * 5, ['b'] * 10))
+
+    yield Case(Annotated[str, at.Len(3, 5)], ('123', '12345'), ('', '1', '12', '123456', 'x' * 10))
+    yield Case(Annotated[str, at.Len(3, 3)], ('123',), ('12', '1234'))
+
+    yield Case(Annotated[Dict[int, int], at.Len(2, 3)], [{1: 1, 2: 2}], [{}, {1: 1}, {1: 1, 2: 2, 3: 3, 4: 4}])
+    yield Case(Annotated[Set[int], at.Len(2, 3)], ({1, 2}, {1, 2, 3}), (set(), {1}, {1, 2, 3, 4}))
+    yield Case(Annotated[Tuple[int, ...], at.Len(2, 3)], ((1, 2), (1, 2, 3)), ((), (1,), (1, 2, 3, 4)))
+
+    # Timezone
+
+    yield Case(
+        Annotated[datetime, at.Timezone(None)], [datetime(2000, 1, 1)], [datetime(2000, 1, 1, tzinfo=timezone.utc)]
+    )
+    yield Case(
+        Annotated[datetime, at.Timezone(...)], [datetime(2000, 1, 1, tzinfo=timezone.utc)], [datetime(2000, 1, 1)]
+    )
+    yield Case(
+        Annotated[datetime, at.Timezone(timezone.utc)],
+        [datetime(2000, 1, 1, tzinfo=timezone.utc)],
+        [datetime(2000, 1, 1), datetime(2000, 1, 1, tzinfo=timezone(timedelta(hours=6)))],
+    )
+    yield Case(
+        Annotated[datetime, at.Timezone('Europe/London')],
+        [datetime(2000, 1, 1, tzinfo=timezone(timedelta(0), name='Europe/London'))],
+        [datetime(2000, 1, 1), datetime(2000, 1, 1, tzinfo=timezone(timedelta(hours=6)))],
+    )
+
+    # predicate types
+
+    yield Case(at.LowerCase[str], ['abc', 'foobar'], ['', 'A', 'Boom'])
+    yield Case(at.UpperCase[str], ['ABC', 'DEFO'], ['', 'a', 'abc', 'AbC'])
+    yield Case(at.IsDigits[str], ['123'], ['', 'ab', 'a1b2'])
+    yield Case(at.IsAscii[str], ['123', 'foo bar'], ['£100', '😊', 'whatever 👀'])
+
+    yield Case(Annotated[int, at.Predicate(lambda x: x % 2 == 0)], [0, 2, 4], [1, 3, 5])
+
+    yield Case(at.IsFinite[float], [1.23], [math.nan, math.inf, -math.inf])
+    yield Case(at.IsNotFinite[float], [math.nan, math.inf], [1.23])
+    yield Case(at.IsNan[float], [math.nan], [1.23, math.inf])
+    yield Case(at.IsNotNan[float], [1.23, math.inf], [math.nan])
+    yield Case(at.IsInfinite[float], [math.inf], [math.nan, 1.23])
+    yield Case(at.IsNotInfinite[float], [math.nan, 1.23], [math.inf])
+
+    # check stacked predicates
+    yield Case(at.IsInfinite[Annotated[float, at.Predicate(lambda x: x > 0)]], [math.inf], [-math.inf, 1.23, math.nan])
+
+    # doc
+    yield Case(Annotated[int, at.doc("A number")], [1, 2], [])
+
+    # custom GroupedMetadata
+    class MyCustomGroupedMetadata(at.GroupedMetadata):
+        def __iter__(self) -> Iterator[at.Predicate]:
+            yield at.Predicate(lambda x: float(x).is_integer())
+
+    yield Case(Annotated[float, MyCustomGroupedMetadata()], [0, 2.0], [0.01, 1.5])
diff --git a/lib/autocommand/autoasync.py b/lib/autocommand/autoasync.py
index 3c8ebdcf..688f7e05 100644
--- a/lib/autocommand/autoasync.py
+++ b/lib/autocommand/autoasync.py
@@ -20,7 +20,7 @@ from functools import wraps
 from inspect import signature
 
 
-def _launch_forever_coro(coro, args, kwargs, loop):
+async def _run_forever_coro(coro, args, kwargs, loop):
     '''
     This helper function launches an async main function that was tagged with
     forever=True. There are two possibilities:
@@ -48,7 +48,7 @@ def _launch_forever_coro(coro, args, kwargs, loop):
     # forever=True feature from autoasync at some point in the future.
     thing = coro(*args, **kwargs)
     if iscoroutine(thing):
-        loop.create_task(thing)
+        await thing
 
 
 def autoasync(coro=None, *, loop=None, forever=False, pass_loop=False):
@@ -127,7 +127,9 @@ def autoasync(coro=None, *, loop=None, forever=False, pass_loop=False):
             args, kwargs = bound_args.args, bound_args.kwargs
 
         if forever:
-            _launch_forever_coro(coro, args, kwargs, local_loop)
+            local_loop.create_task(_run_forever_coro(
+                coro, args, kwargs, local_loop
+            ))
             local_loop.run_forever()
         else:
             return local_loop.run_until_complete(coro(*args, **kwargs))
diff --git a/lib/cherrypy/_cplogging.py b/lib/cherrypy/_cplogging.py
index 151d3b40..bce1c87b 100644
--- a/lib/cherrypy/_cplogging.py
+++ b/lib/cherrypy/_cplogging.py
@@ -452,6 +452,6 @@ class WSGIErrorHandler(logging.Handler):
 
 class LazyRfc3339UtcTime(object):
     def __str__(self):
-        """Return now() in RFC3339 UTC Format."""
-        now = datetime.datetime.now()
-        return now.isoformat('T') + 'Z'
+        """Return utcnow() in RFC3339 UTC Format."""
+        iso_formatted_now = datetime.datetime.utcnow().isoformat('T')
+        return f'{iso_formatted_now!s}Z'
diff --git a/lib/cherrypy/lib/cptools.py b/lib/cherrypy/lib/cptools.py
index 613a8995..13b4c567 100644
--- a/lib/cherrypy/lib/cptools.py
+++ b/lib/cherrypy/lib/cptools.py
@@ -622,13 +622,15 @@ def autovary(ignore=None, debug=False):
 
 
 def convert_params(exception=ValueError, error=400):
-    """Convert request params based on function annotations, with error handling.
+    """Convert request params based on function annotations.
 
-    exception
-        Exception class to catch.
+    This function also processes errors that are subclasses of ``exception``.
 
-    status
-        The HTTP error code to return to the client on failure.
+    :param BaseException exception: Exception class to catch.
+    :type exception: BaseException
+
+    :param error: The HTTP status code to return to the client on failure.
+    :type error: int
     """
     request = cherrypy.serving.request
     types = request.handler.callable.__annotations__
diff --git a/lib/cherrypy/lib/profiler.py b/lib/cherrypy/lib/profiler.py
index fccf2eb8..7182278a 100644
--- a/lib/cherrypy/lib/profiler.py
+++ b/lib/cherrypy/lib/profiler.py
@@ -47,7 +47,9 @@ try:
     import pstats
 
     def new_func_strip_path(func_name):
-        """Make profiler output more readable by adding `__init__` modules' parents
+        """Add ``__init__`` modules' parents.
+
+        This makes the profiler output more readable.
         """
         filename, line, name = func_name
         if filename.endswith('__init__.py'):
diff --git a/lib/cherrypy/lib/reprconf.py b/lib/cherrypy/lib/reprconf.py
index 76381d7b..536b9417 100644
--- a/lib/cherrypy/lib/reprconf.py
+++ b/lib/cherrypy/lib/reprconf.py
@@ -188,7 +188,7 @@ class Parser(configparser.ConfigParser):
 
     def dict_from_file(self, file):
         if hasattr(file, 'read'):
-            self.readfp(file)
+            self.read_file(file)
         else:
             self.read(file)
         return self.as_dict()
diff --git a/lib/cherrypy/lib/static.py b/lib/cherrypy/lib/static.py
index 66a5a947..c1ad95f3 100644
--- a/lib/cherrypy/lib/static.py
+++ b/lib/cherrypy/lib/static.py
@@ -1,19 +1,18 @@
 """Module with helpers for serving static files."""
 
+import mimetypes
 import os
 import platform
 import re
 import stat
-import mimetypes
-import urllib.parse
 import unicodedata
-
+import urllib.parse
 from email.generator import _make_boundary as make_boundary
 from io import UnsupportedOperation
 
 import cherrypy
 from cherrypy._cpcompat import ntob
-from cherrypy.lib import cptools, httputil, file_generator_limited
+from cherrypy.lib import cptools, file_generator_limited, httputil
 
 
 def _setup_mimetypes():
@@ -185,7 +184,10 @@ def serve_fileobj(fileobj, content_type=None, disposition=None, name=None,
 
 
 def _serve_fileobj(fileobj, content_type, content_length, debug=False):
-    """Internal. Set response.body to the given file object, perhaps ranged."""
+    """Set ``response.body`` to the given file object, perhaps ranged.
+
+    Internal helper.
+    """
     response = cherrypy.serving.response
 
     # HTTP/1.0 didn't have Range/Accept-Ranges headers, or the 206 code
diff --git a/lib/cherrypy/process/wspbus.py b/lib/cherrypy/process/wspbus.py
index 1d2789b1..a60cd51e 100644
--- a/lib/cherrypy/process/wspbus.py
+++ b/lib/cherrypy/process/wspbus.py
@@ -494,7 +494,7 @@ class Bus(object):
                     "Cannot reconstruct command from '-c'. "
                     'Ref: https://github.com/cherrypy/cherrypy/issues/1545')
         except AttributeError:
-            """It looks Py_GetArgcArgv is completely absent in some environments
+            """It looks Py_GetArgcArgv's completely absent in some environments
 
             It is known, that there's no Py_GetArgcArgv in MS Windows and
             ``ctypes`` module is completely absent in Google AppEngine
diff --git a/lib/cherrypy/test/test_http.py b/lib/cherrypy/test/test_http.py
index a955be43..9a7e9331 100644
--- a/lib/cherrypy/test/test_http.py
+++ b/lib/cherrypy/test/test_http.py
@@ -136,6 +136,9 @@ class HTTPTests(helper.CPWebCase):
         self.assertStatus(200)
         self.assertBody(b'Hello world!')
 
+        response.close()
+        c.close()
+
         # Now send a message that has no Content-Length, but does send a body.
         # Verify that CP times out the socket and responds
         # with 411 Length Required.
@@ -159,6 +162,9 @@ class HTTPTests(helper.CPWebCase):
         self.status = str(response.status)
         self.assertStatus(411)
 
+        response.close()
+        c.close()
+
     def test_post_multipart(self):
         alphabet = 'abcdefghijklmnopqrstuvwxyz'
         # generate file contents for a large post
@@ -184,6 +190,9 @@ class HTTPTests(helper.CPWebCase):
         parts = ['%s * 65536' % ch for ch in alphabet]
         self.assertBody(', '.join(parts))
 
+        response.close()
+        c.close()
+
     def test_post_filename_with_special_characters(self):
         """Testing that we can handle filenames with special characters.
 
@@ -217,6 +226,9 @@ class HTTPTests(helper.CPWebCase):
             self.assertStatus(200)
             self.assertBody(fname)
 
+            response.close()
+            c.close()
+
     def test_malformed_request_line(self):
         if getattr(cherrypy.server, 'using_apache', False):
             return self.skip('skipped due to known Apache differences...')
@@ -264,6 +276,9 @@ class HTTPTests(helper.CPWebCase):
         self.body = response.fp.read(20)
         self.assertBody('Illegal header line.')
 
+        response.close()
+        c.close()
+
     def test_http_over_https(self):
         if self.scheme != 'https':
             return self.skip('skipped (not running HTTPS)... ')
diff --git a/lib/cherrypy/test/test_iterator.py b/lib/cherrypy/test/test_iterator.py
index 6600a78d..5bad59be 100644
--- a/lib/cherrypy/test/test_iterator.py
+++ b/lib/cherrypy/test/test_iterator.py
@@ -150,6 +150,8 @@ class IteratorTest(helper.CPWebCase):
             self.assertStatus(200)
             self.assertBody('0')
 
+            itr_conn.close()
+
         # Now we do the same check with streaming - some classes will
         # be automatically closed, while others cannot.
         stream_counts = {}
diff --git a/lib/cherrypy/test/test_logging.py b/lib/cherrypy/test/test_logging.py
index 2d4aa56f..49d41d0a 100644
--- a/lib/cherrypy/test/test_logging.py
+++ b/lib/cherrypy/test/test_logging.py
@@ -1,5 +1,6 @@
 """Basic tests for the CherryPy core: request handling."""
 
+import datetime
 import logging
 
 from cheroot.test import webtest
@@ -197,6 +198,33 @@ def test_custom_log_format(log_tracker, monkeypatch, server):
     )
 
 
+def test_utc_in_timez(monkeypatch):
+    """Test that ``LazyRfc3339UtcTime`` is rendered as ``str`` using UTC timestamp."""
+    utcoffset8_local_time_in_naive_utc = (
+        datetime.datetime(
+            year=2020,
+            month=1,
+            day=1,
+            hour=1,
+            minute=23,
+            second=45,
+            tzinfo=datetime.timezone(datetime.timedelta(hours=8)),
+        )
+        .astimezone(datetime.timezone.utc)
+        .replace(tzinfo=None)
+    )
+
+    class mock_datetime:
+        @classmethod
+        def utcnow(cls):
+            return utcoffset8_local_time_in_naive_utc
+
+    monkeypatch.setattr('datetime.datetime', mock_datetime)
+    rfc3339_utc_time = str(cherrypy._cplogging.LazyRfc3339UtcTime())
+    expected_time = '2019-12-31T17:23:45Z'
+    assert rfc3339_utc_time == expected_time
+
+
 def test_timez_log_format(log_tracker, monkeypatch, server):
     """Test a customized access_log_format string, which is a
     feature of _cplogging.LogManager.access()."""
diff --git a/lib/inflect/__init__.py b/lib/inflect/__init__.py
index 78d2e33c..b638c6b8 100644
--- a/lib/inflect/__init__.py
+++ b/lib/inflect/__init__.py
@@ -3,8 +3,6 @@ inflect: english language inflection
  - correctly generate plurals, ordinals, indefinite articles
  - convert numbers to words
 
-Copyright (C) 2010 Paul Dyson
-
 Based upon the Perl module
 `Lingua::EN::Inflect <https://metacpan.org/pod/Lingua::EN::Inflect>`_.
 
@@ -70,11 +68,16 @@ from typing import (
     cast,
     Any,
 )
+from typing_extensions import Literal
 from numbers import Number
 
 
-from pydantic import Field, validate_arguments
-from pydantic.typing import Annotated
+from pydantic import Field
+from typing_extensions import Annotated
+
+
+from .compat.pydantic1 import validate_call
+from .compat.pydantic import same_method
 
 
 class UnknownClassicalModeError(Exception):
@@ -105,14 +108,6 @@ class BadGenderError(Exception):
     pass
 
 
-STDOUT_ON = False
-
-
-def print3(txt: str) -> None:
-    if STDOUT_ON:
-        print(txt)
-
-
 def enclose(s: str) -> str:
     return f"(?:{s})"
 
@@ -1727,66 +1722,44 @@ plverb_irregular_pres = {
     "is": "are",
     "was": "were",
     "were": "were",
-    "was": "were",
-    "have": "have",
     "have": "have",
     "has": "have",
     "do": "do",
-    "do": "do",
     "does": "do",
 }
 
 plverb_ambiguous_pres = {
-    "act": "act",
     "act": "act",
     "acts": "act",
     "blame": "blame",
-    "blame": "blame",
     "blames": "blame",
     "can": "can",
-    "can": "can",
-    "can": "can",
     "must": "must",
-    "must": "must",
-    "must": "must",
-    "fly": "fly",
     "fly": "fly",
     "flies": "fly",
     "copy": "copy",
-    "copy": "copy",
     "copies": "copy",
     "drink": "drink",
-    "drink": "drink",
     "drinks": "drink",
     "fight": "fight",
-    "fight": "fight",
     "fights": "fight",
     "fire": "fire",
-    "fire": "fire",
     "fires": "fire",
     "like": "like",
-    "like": "like",
     "likes": "like",
     "look": "look",
-    "look": "look",
     "looks": "look",
     "make": "make",
-    "make": "make",
     "makes": "make",
     "reach": "reach",
-    "reach": "reach",
     "reaches": "reach",
     "run": "run",
-    "run": "run",
     "runs": "run",
     "sink": "sink",
-    "sink": "sink",
     "sinks": "sink",
     "sleep": "sleep",
-    "sleep": "sleep",
     "sleeps": "sleep",
     "view": "view",
-    "view": "view",
     "views": "view",
 }
 
@@ -1854,7 +1827,7 @@ pl_adj_poss_keys = re.compile(fr"^({enclose('|'.join(pl_adj_poss))})$", re.IGNOR
 
 A_abbrev = re.compile(
     r"""
-(?! FJO | [HLMNS]Y.  | RY[EO] | SQU
+^(?! FJO | [HLMNS]Y.  | RY[EO] | SQU
   | ( F[LR]? | [HL] | MN? | N | RH? | S[CHKLMNPTVW]? | X(YL)?) [AEIOU])
 [FHLMNRSX][A-Z]
 """,
@@ -2053,15 +2026,14 @@ Falsish = Any  # ideally, falsish would only validate on bool(value) is False
 
 class engine:
     def __init__(self) -> None:
-
         self.classical_dict = def_classical.copy()
         self.persistent_count: Optional[int] = None
         self.mill_count = 0
-        self.pl_sb_user_defined: List[str] = []
-        self.pl_v_user_defined: List[str] = []
-        self.pl_adj_user_defined: List[str] = []
-        self.si_sb_user_defined: List[str] = []
-        self.A_a_user_defined: List[str] = []
+        self.pl_sb_user_defined: List[Optional[Word]] = []
+        self.pl_v_user_defined: List[Optional[Word]] = []
+        self.pl_adj_user_defined: List[Optional[Word]] = []
+        self.si_sb_user_defined: List[Optional[Word]] = []
+        self.A_a_user_defined: List[Optional[Word]] = []
         self.thegender = "neuter"
         self.__number_args: Optional[Dict[str, str]] = None
 
@@ -2073,28 +2045,8 @@ class engine:
     def _number_args(self, val):
         self.__number_args = val
 
-    deprecated_methods = dict(
-        pl="plural",
-        plnoun="plural_noun",
-        plverb="plural_verb",
-        pladj="plural_adj",
-        sinoun="single_noun",
-        prespart="present_participle",
-        numwords="number_to_words",
-        plequal="compare",
-        plnounequal="compare_nouns",
-        plverbequal="compare_verbs",
-        pladjequal="compare_adjs",
-        wordlist="join",
-    )
-
-    def __getattr__(self, meth):
-        if meth in self.deprecated_methods:
-            print3(f"{meth}() deprecated, use {self.deprecated_methods[meth]}()")
-            raise DeprecationWarning
-        raise AttributeError
-
-    def defnoun(self, singular: str, plural: str) -> int:
+    @validate_call
+    def defnoun(self, singular: Optional[Word], plural: Optional[Word]) -> int:
         """
         Set the noun plural of singular to plural.
 
@@ -2105,7 +2057,16 @@ class engine:
         self.si_sb_user_defined.extend((plural, singular))
         return 1
 
-    def defverb(self, s1: str, p1: str, s2: str, p2: str, s3: str, p3: str) -> int:
+    @validate_call
+    def defverb(
+        self,
+        s1: Optional[Word],
+        p1: Optional[Word],
+        s2: Optional[Word],
+        p2: Optional[Word],
+        s3: Optional[Word],
+        p3: Optional[Word],
+    ) -> int:
         """
         Set the verb plurals for s1, s2 and s3 to p1, p2 and p3 respectively.
 
@@ -2121,7 +2082,8 @@ class engine:
         self.pl_v_user_defined.extend((s1, p1, s2, p2, s3, p3))
         return 1
 
-    def defadj(self, singular: str, plural: str) -> int:
+    @validate_call
+    def defadj(self, singular: Optional[Word], plural: Optional[Word]) -> int:
         """
         Set the adjective plural of singular to plural.
 
@@ -2131,7 +2093,8 @@ class engine:
         self.pl_adj_user_defined.extend((singular, plural))
         return 1
 
-    def defa(self, pattern: str) -> int:
+    @validate_call
+    def defa(self, pattern: Optional[Word]) -> int:
         """
         Define the indefinite article as 'a' for words matching pattern.
 
@@ -2140,7 +2103,8 @@ class engine:
         self.A_a_user_defined.extend((pattern, "a"))
         return 1
 
-    def defan(self, pattern: str) -> int:
+    @validate_call
+    def defan(self, pattern: Optional[Word]) -> int:
         """
         Define the indefinite article as 'an' for words matching pattern.
 
@@ -2149,7 +2113,7 @@ class engine:
         self.A_a_user_defined.extend((pattern, "an"))
         return 1
 
-    def checkpat(self, pattern: Optional[str]) -> None:
+    def checkpat(self, pattern: Optional[Word]) -> None:
         """
         check for errors in a regex pattern
         """
@@ -2158,16 +2122,15 @@ class engine:
         try:
             re.match(pattern, "")
         except re.error:
-            print3(f"\nBad user-defined singular pattern:\n\t{pattern}\n")
-            raise BadUserDefinedPatternError
+            raise BadUserDefinedPatternError(pattern)
 
-    def checkpatplural(self, pattern: str) -> None:
+    def checkpatplural(self, pattern: Optional[Word]) -> None:
         """
         check for errors in a regex replace pattern
         """
         return
 
-    @validate_arguments
+    @validate_call
     def ud_match(self, word: Word, wordlist: Sequence[Optional[Word]]) -> Optional[str]:
         for i in range(len(wordlist) - 2, -2, -2):  # backwards through even elements
             mo = re.search(fr"^{wordlist[i]}$", word, re.IGNORECASE)
@@ -2307,7 +2270,7 @@ class engine:
 
     # 0. PERFORM GENERAL INFLECTIONS IN A STRING
 
-    @validate_arguments
+    @validate_call
     def inflect(self, text: Word) -> str:
         """
         Perform inflections in a string.
@@ -2384,7 +2347,7 @@ class engine:
         else:
             return "", "", ""
 
-    @validate_arguments
+    @validate_call
     def plural(self, text: Word, count: Optional[Union[str, int, Any]] = None) -> str:
         """
         Return the plural of text.
@@ -2408,7 +2371,7 @@ class engine:
         )
         return f"{pre}{plural}{post}"
 
-    @validate_arguments
+    @validate_call
     def plural_noun(
         self, text: Word, count: Optional[Union[str, int, Any]] = None
     ) -> str:
@@ -2429,7 +2392,7 @@ class engine:
         plural = self.postprocess(word, self._plnoun(word, count))
         return f"{pre}{plural}{post}"
 
-    @validate_arguments
+    @validate_call
     def plural_verb(
         self, text: Word, count: Optional[Union[str, int, Any]] = None
     ) -> str:
@@ -2453,7 +2416,7 @@ class engine:
         )
         return f"{pre}{plural}{post}"
 
-    @validate_arguments
+    @validate_call
     def plural_adj(
         self, text: Word, count: Optional[Union[str, int, Any]] = None
     ) -> str:
@@ -2474,7 +2437,7 @@ class engine:
         plural = self.postprocess(word, self._pl_special_adjective(word, count) or word)
         return f"{pre}{plural}{post}"
 
-    @validate_arguments
+    @validate_call
     def compare(self, word1: Word, word2: Word) -> Union[str, bool]:
         """
         compare word1 and word2 for equality regardless of plurality
@@ -2497,15 +2460,15 @@ class engine:
         >>> compare('egg', '')
         Traceback (most recent call last):
         ...
-        pydantic.error_wrappers.ValidationError: 1 validation error for Compare
-        word2
-          ensure this value has at least 1 characters...
+        pydantic...ValidationError: ...
+        ...
+          ...at least 1 characters...
         """
         norms = self.plural_noun, self.plural_verb, self.plural_adj
         results = (self._plequal(word1, word2, norm) for norm in norms)
         return next(filter(None, results), False)
 
-    @validate_arguments
+    @validate_call
     def compare_nouns(self, word1: Word, word2: Word) -> Union[str, bool]:
         """
         compare word1 and word2 for equality regardless of plurality
@@ -2521,7 +2484,7 @@ class engine:
         """
         return self._plequal(word1, word2, self.plural_noun)
 
-    @validate_arguments
+    @validate_call
     def compare_verbs(self, word1: Word, word2: Word) -> Union[str, bool]:
         """
         compare word1 and word2 for equality regardless of plurality
@@ -2537,7 +2500,7 @@ class engine:
         """
         return self._plequal(word1, word2, self.plural_verb)
 
-    @validate_arguments
+    @validate_call
     def compare_adjs(self, word1: Word, word2: Word) -> Union[str, bool]:
         """
         compare word1 and word2 for equality regardless of plurality
@@ -2553,13 +2516,13 @@ class engine:
         """
         return self._plequal(word1, word2, self.plural_adj)
 
-    @validate_arguments
+    @validate_call
     def singular_noun(
         self,
         text: Word,
         count: Optional[Union[int, str, Any]] = None,
         gender: Optional[str] = None,
-    ) -> Union[str, bool]:
+    ) -> Union[str, Literal[False]]:
         """
         Return the singular of text, where text is a plural noun.
 
@@ -2611,12 +2574,12 @@ class engine:
             return "s:p"
         self.classical_dict = classval.copy()
 
-        if pl == self.plural or pl == self.plural_noun:
+        if same_method(pl, self.plural) or same_method(pl, self.plural_noun):
             if self._pl_check_plurals_N(word1, word2):
                 return "p:p"
             if self._pl_check_plurals_N(word2, word1):
                 return "p:p"
-        if pl == self.plural or pl == self.plural_adj:
+        if same_method(pl, self.plural) or same_method(pl, self.plural_adj):
             if self._pl_check_plurals_adj(word1, word2):
                 return "p:p"
         return False
@@ -3266,11 +3229,11 @@ class engine:
 
         if words.last in si_sb_irregular_caps:
             llen = len(words.last)
-            return "{}{}".format(word[:-llen], si_sb_irregular_caps[words.last])
+            return f"{word[:-llen]}{si_sb_irregular_caps[words.last]}"
 
         if words.last.lower() in si_sb_irregular:
             llen = len(words.last.lower())
-            return "{}{}".format(word[:-llen], si_sb_irregular[words.last.lower()])
+            return f"{word[:-llen]}{si_sb_irregular[words.last.lower()]}"
 
         dash_split = words.lowered.split("-")
         if (" ".join(dash_split[-2:])).lower() in si_sb_irregular_compound:
@@ -3341,7 +3304,6 @@ class engine:
         # HANDLE INCOMPLETELY ASSIMILATED IMPORTS
 
         if self.classical_dict["ancient"]:
-
             if words.lowered[-6:] == "trices":
                 return word[:-3] + "x"
             if words.lowered[-4:] in ("eaux", "ieux"):
@@ -3459,7 +3421,6 @@ class engine:
         # HANDLE ...o
 
         if words.lowered[-2:] == "os":
-
             if words.last.lower() in si_sb_U_o_os_complete:
                 return word[:-1]
 
@@ -3489,7 +3450,7 @@ class engine:
 
     # ADJECTIVES
 
-    @validate_arguments
+    @validate_call
     def a(self, text: Word, count: Optional[Union[int, str, Any]] = 1) -> str:
         """
         Return the appropriate indefinite article followed by text.
@@ -3570,7 +3531,7 @@ class engine:
 
     # 2. TRANSLATE ZERO-QUANTIFIED $word TO "no plural($word)"
 
-    @validate_arguments
+    @validate_call
     def no(self, text: Word, count: Optional[Union[int, str]] = None) -> str:
         """
         If count is 0, no, zero or nil, return 'no' followed by the plural
@@ -3608,7 +3569,7 @@ class engine:
 
     # PARTICIPLES
 
-    @validate_arguments
+    @validate_call
     def present_participle(self, word: Word) -> str:
         """
         Return the present participle for word.
@@ -3627,31 +3588,31 @@ class engine:
 
     # NUMERICAL INFLECTIONS
 
-    @validate_arguments
-    def ordinal(self, num: Union[int, Word]) -> str:  # noqa: C901
+    @validate_call(config=dict(arbitrary_types_allowed=True))
+    def ordinal(self, num: Union[Number, Word]) -> str:
         """
         Return the ordinal of num.
 
-        num can be an integer or text
-
-        e.g. ordinal(1) returns '1st'
-        ordinal('one') returns 'first'
-
+        >>> ordinal = engine().ordinal
+        >>> ordinal(1)
+        '1st'
+        >>> ordinal('one')
+        'first'
         """
         if DIGIT.match(str(num)):
-            if isinstance(num, (int, float)):
+            if isinstance(num, (float, int)) and int(num) == num:
                 n = int(num)
             else:
                 if "." in str(num):
                     try:
                         # numbers after decimal,
                         # so only need last one for ordinal
-                        n = int(num[-1])
+                        n = int(str(num)[-1])
 
                     except ValueError:  # ends with '.', so need to use whole string
-                        n = int(num[:-1])
+                        n = int(str(num)[:-1])
                 else:
-                    n = int(num)
+                    n = int(num)  # type: ignore
             try:
                 post = nth[n % 100]
             except KeyError:
@@ -3660,7 +3621,7 @@ class engine:
         else:
             # Mad props to Damian Conway (?) whose ordinal()
             # algorithm is type-bendy enough to foil MyPy
-            str_num: str = num  # type:	ignore[assignment]
+            str_num: str = num  # type: ignore[assignment]
             mo = ordinal_suff.search(str_num)
             if mo:
                 post = ordinal[mo.group(1)]
@@ -3671,7 +3632,6 @@ class engine:
 
     def millfn(self, ind: int = 0) -> str:
         if ind > len(mill) - 1:
-            print3("number out of range")
             raise NumOutOfRangeError
         return mill[ind]
 
@@ -3787,7 +3747,7 @@ class engine:
             num = ONE_DIGIT_WORD.sub(self.unitsub, num, 1)
         return num
 
-    @validate_arguments(config=dict(arbitrary_types_allowed=True))  # noqa: C901
+    @validate_call(config=dict(arbitrary_types_allowed=True))  # noqa: C901
     def number_to_words(  # noqa: C901
         self,
         num: Union[Number, Word],
@@ -3939,7 +3899,7 @@ class engine:
 
     # Join words with commas and a trailing 'and' (when appropriate)...
 
-    @validate_arguments
+    @validate_call
     def join(
         self,
         words: Optional[Sequence[Word]],
diff --git a/lib/inflect/compat/__init__.py b/lib/inflect/compat/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/lib/inflect/compat/pydantic.py b/lib/inflect/compat/pydantic.py
new file mode 100644
index 00000000..d777564a
--- /dev/null
+++ b/lib/inflect/compat/pydantic.py
@@ -0,0 +1,19 @@
+class ValidateCallWrapperWrapper:
+    def __init__(self, wrapped):
+        self.orig = wrapped
+
+    def __eq__(self, other):
+        return self.raw_function == other.raw_function
+
+    @property
+    def raw_function(self):
+        return getattr(self.orig, 'raw_function') or self.orig
+
+
+def same_method(m1, m2) -> bool:
+    """
+    Return whether m1 and m2 are the same method.
+
+    Workaround for pydantic/pydantic#6390.
+    """
+    return ValidateCallWrapperWrapper(m1) == ValidateCallWrapperWrapper(m2)
diff --git a/lib/inflect/compat/pydantic1.py b/lib/inflect/compat/pydantic1.py
new file mode 100644
index 00000000..8262fdcf
--- /dev/null
+++ b/lib/inflect/compat/pydantic1.py
@@ -0,0 +1,8 @@
+try:
+    from pydantic import validate_call  # type: ignore
+except ImportError:
+    # Pydantic 1
+    from pydantic import validate_arguments as validate_call  # type: ignore
+
+
+__all__ = ['validate_call']
diff --git a/lib/isapi/README.txt b/lib/isapi/README.txt
new file mode 100644
index 00000000..dc528624
--- /dev/null
+++ b/lib/isapi/README.txt
@@ -0,0 +1,7 @@
+A Python ISAPI extension.  Contributed by Phillip Frantz, and is
+Copyright 2002-2003 by Blackdog Software Pty Ltd.
+
+See the 'samples' directory, and particularly samples\README.txt
+
+You can find documentation in the PyWin32.chm file that comes with pywin32 - 
+you can open this from Pythonwin->Help, or from the start menu.
\ No newline at end of file
diff --git a/lib/isapi/__init__.py b/lib/isapi/__init__.py
new file mode 100644
index 00000000..71823616
--- /dev/null
+++ b/lib/isapi/__init__.py
@@ -0,0 +1,39 @@
+# The Python ISAPI package.
+
+
+# Exceptions thrown by the DLL framework.
+class ISAPIError(Exception):
+    def __init__(self, errno, strerror=None, funcname=None):
+        # named attributes match IOError etc.
+        self.errno = errno
+        self.strerror = strerror
+        self.funcname = funcname
+        Exception.__init__(self, errno, strerror, funcname)
+
+    def __str__(self):
+        if self.strerror is None:
+            try:
+                import win32api
+
+                self.strerror = win32api.FormatMessage(self.errno).strip()
+            except:
+                self.strerror = "no error message is available"
+        # str() looks like a win32api error.
+        return str((self.errno, self.strerror, self.funcname))
+
+
+class FilterError(ISAPIError):
+    pass
+
+
+class ExtensionError(ISAPIError):
+    pass
+
+
+# A little development aid - a filter or extension callback function can
+# raise one of these exceptions, and the handler module will be reloaded.
+# This means you can change your code without restarting IIS.
+# After a reload, your filter/extension will have the GetFilterVersion/
+# GetExtensionVersion function called, but with None as the first arg.
+class InternalReloadException(Exception):
+    pass
diff --git a/lib/isapi/doc/isapi.html b/lib/isapi/doc/isapi.html
new file mode 100644
index 00000000..03001a1b
--- /dev/null
+++ b/lib/isapi/doc/isapi.html
@@ -0,0 +1,92 @@
+<!-- NOTE: This HTML is displayed inside the CHM file - hence some hrefs
+     will only work in that environment
+-->
+<HTML>
+<BODY>
+<TITLE>Introduction to Python ISAPI support</TITLE>
+
+<h2>Introduction to Python ISAPI support</h2>
+
+<h3>See also</h3>
+<ul>
+    <li><a href="/isapi_modules.html">The isapi related modules</a>
+    </li>
+    <li><a href="/isapi_objects.html">The isapi related objects</a>
+    </li>
+</ul>
+<p><i>Note: if you are viewing this documentation directly from disk, 
+most links in this document will fail - you can also find this document in the
+CHM file that comes with pywin32, where the links will work</i>
+
+<h3>Introduction</h3>
+This documents Python support for hosting ISAPI exensions and filters inside
+Microsoft Internet Information Server (IIS). It assumes a basic understanding 
+of the ISAPI filter and extension mechanism.
+<p>
+In summary, to implement a filter or extension, you provide a Python module
+which defines a Filter and/or Extension class.  Once your class has been
+loaded, IIS/ISAPI will, via an extension DLL, call methods on your class.
+<p>
+A filter and a class instance need only provide 3 methods - for filters they
+are called <code>GetFilterVersion</code>, <code>HttpFilterProc</code> and
+<code>TerminateFilter</code>.  For extensions they
+are named <code>GetExtensionVersion</code>, <code>HttpExtensionProc</code> and
+<code>TerminateExtension</code>.  If you are familiar with writing ISAPI 
+extensions in C/C++, these names and their purpose will be familiar.
+<p>
+Most of the work is done in the <code>HttpFilterProc</code> and 
+<code>HttpExtensionProc</code> methods.  These both take a single
+parameter - an <a href="/HTTP_FILTER_CONTEXT.html">HTTP_FILTER_CONTEXT</a> and 
+<a href="/EXTENSION_CONTROL_BLOCK.html">EXTENSION_CONTROL_BLOCK</a>
+object respectively.
+<p>
+In addition to these components, there is an 'isapi' package, containing
+support facilities (base-classes, exceptions, etc) which can be leveraged
+by the extension.
+
+<h4>Base classes</h4>
+There are a number of base classes provided to make writing extensions a little
+simpler.  Of particular note is <code>isapi.threaded_extension.ThreadPoolExtension</code>.
+This implements a thread-pool and informs IIS that the request is progressing 
+in the background.  Your sub-class need only provide a <code>Dispatch</code> 
+method, which is called on one of the worker threads rather than the thread
+that the request came in on.
+<p>
+There is base-class for a filter in <code>isapi.simple</code>, but there is no
+equivilent threaded filter - filters work under a different model, where
+background processing is not possible.
+<h4>Samples</h4>
+Please see the <code>isapi/samples</code> directory for some sample filters 
+and extensions.
+
+<H3>Implementation</H3>
+A Python ISAPI filter extension consists of 2 main components:
+<UL>
+<LI>A DLL used by ISAPI to interface with Python.</LI>
+<LI>A Python script used by that DLL to implement the filter or extension 
+functionality</LI>
+</UL>
+
+<h4>Extension DLL</h4>
+The DLL is usually managed automatically by the isapi.install module.  As the
+Python script for the extension is installed, a generic DLL provided with 
+the isapi package is installed next to the script, and IIS configured to
+use this DLL.
+<p>
+The name of the DLL always has the same base name as the Python script, but
+with a leading underscore (_), and an extension of .dll.  For example, the 
+sample "redirector.py" will, when installed, have "_redirector.dll" created
+in the same directory.
+<p/>
+The Python script may provide 2 entry points - methods named __FilterFactory__ 
+and __ExtensionFactory__, both taking no arguments and returning a filter or
+extension object.
+
+<h3>Using py2exe and the isapi package</h3>
+You can instruct py2exe to create a 'frozen' Python ISAPI filter/extension.
+In this case, py2exe will create a package with everything you need in one
+directory, and the Python source file embedded in the .zip file.
+<p>
+In general, you will want to build a seperate installation executable along 
+with the ISAPI extension.  This executable will be built from the same script.
+See the ISAPI sample in the py2exe distribution.
diff --git a/lib/isapi/install.py b/lib/isapi/install.py
new file mode 100644
index 00000000..154f82af
--- /dev/null
+++ b/lib/isapi/install.py
@@ -0,0 +1,815 @@
+"""Installation utilities for Python ISAPI filters and extensions."""
+
+# this code adapted from "Tomcat JK2 ISAPI redirector", part of Apache
+# Created July 2004, Mark Hammond.
+import imp
+import os
+import shutil
+import stat
+import sys
+import traceback
+
+import pythoncom
+import win32api
+import winerror
+from win32com.client import Dispatch, GetObject
+from win32com.client.gencache import EnsureDispatch, EnsureModule
+
+_APP_INPROC = 0
+_APP_OUTPROC = 1
+_APP_POOLED = 2
+_IIS_OBJECT = "IIS://LocalHost/W3SVC"
+_IIS_SERVER = "IIsWebServer"
+_IIS_WEBDIR = "IIsWebDirectory"
+_IIS_WEBVIRTUALDIR = "IIsWebVirtualDir"
+_IIS_FILTERS = "IIsFilters"
+_IIS_FILTER = "IIsFilter"
+
+_DEFAULT_SERVER_NAME = "Default Web Site"
+_DEFAULT_HEADERS = "X-Powered-By: Python"
+_DEFAULT_PROTECTION = _APP_POOLED
+
+# Default is for 'execute' only access - ie, only the extension
+# can be used.  This can be overridden via your install script.
+_DEFAULT_ACCESS_EXECUTE = True
+_DEFAULT_ACCESS_READ = False
+_DEFAULT_ACCESS_WRITE = False
+_DEFAULT_ACCESS_SCRIPT = False
+_DEFAULT_CONTENT_INDEXED = False
+_DEFAULT_ENABLE_DIR_BROWSING = False
+_DEFAULT_ENABLE_DEFAULT_DOC = False
+
+_extensions = [ext for ext, _, _ in imp.get_suffixes()]
+is_debug_build = "_d.pyd" in _extensions
+
+this_dir = os.path.abspath(os.path.dirname(__file__))
+
+
+class FilterParameters:
+    Name = None
+    Description = None
+    Path = None
+    Server = None
+    # Params that control if/how AddExtensionFile is called.
+    AddExtensionFile = True
+    AddExtensionFile_Enabled = True
+    AddExtensionFile_GroupID = None  # defaults to Name
+    AddExtensionFile_CanDelete = True
+    AddExtensionFile_Description = None  # defaults to Description.
+
+    def __init__(self, **kw):
+        self.__dict__.update(kw)
+
+
+class VirtualDirParameters:
+    Name = None  # Must be provided.
+    Description = None  # defaults to Name
+    AppProtection = _DEFAULT_PROTECTION
+    Headers = _DEFAULT_HEADERS
+    Path = None  # defaults to WWW root.
+    Type = _IIS_WEBVIRTUALDIR
+    AccessExecute = _DEFAULT_ACCESS_EXECUTE
+    AccessRead = _DEFAULT_ACCESS_READ
+    AccessWrite = _DEFAULT_ACCESS_WRITE
+    AccessScript = _DEFAULT_ACCESS_SCRIPT
+    ContentIndexed = _DEFAULT_CONTENT_INDEXED
+    EnableDirBrowsing = _DEFAULT_ENABLE_DIR_BROWSING
+    EnableDefaultDoc = _DEFAULT_ENABLE_DEFAULT_DOC
+    DefaultDoc = None  # Only set in IIS if not None
+    ScriptMaps = []
+    ScriptMapUpdate = "end"  # can be 'start', 'end', 'replace'
+    Server = None
+
+    def __init__(self, **kw):
+        self.__dict__.update(kw)
+
+    def is_root(self):
+        "This virtual directory is a root directory if parent and name are blank"
+        parent, name = self.split_path()
+        return not parent and not name
+
+    def split_path(self):
+        return split_path(self.Name)
+
+
+class ScriptMapParams:
+    Extension = None
+    Module = None
+    Flags = 5
+    Verbs = ""
+    # Params that control if/how AddExtensionFile is called.
+    AddExtensionFile = True
+    AddExtensionFile_Enabled = True
+    AddExtensionFile_GroupID = None  # defaults to Name
+    AddExtensionFile_CanDelete = True
+    AddExtensionFile_Description = None  # defaults to Description.
+
+    def __init__(self, **kw):
+        self.__dict__.update(kw)
+
+    def __str__(self):
+        "Format this parameter suitable for IIS"
+        items = [self.Extension, self.Module, self.Flags]
+        # IIS gets upset if there is a trailing verb comma, but no verbs
+        if self.Verbs:
+            items.append(self.Verbs)
+        items = [str(item) for item in items]
+        return ",".join(items)
+
+
+class ISAPIParameters:
+    ServerName = _DEFAULT_SERVER_NAME
+    # Description = None
+    Filters = []
+    VirtualDirs = []
+
+    def __init__(self, **kw):
+        self.__dict__.update(kw)
+
+
+verbose = 1  # The level - 0 is quiet.
+
+
+def log(level, what):
+    if verbose >= level:
+        print(what)
+
+
+# Convert an ADSI COM exception to the Win32 error code embedded in it.
+def _GetWin32ErrorCode(com_exc):
+    hr = com_exc.hresult
+    # If we have more details in the 'excepinfo' struct, use it.
+    if com_exc.excepinfo:
+        hr = com_exc.excepinfo[-1]
+    if winerror.HRESULT_FACILITY(hr) != winerror.FACILITY_WIN32:
+        raise
+    return winerror.SCODE_CODE(hr)
+
+
+class InstallationError(Exception):
+    pass
+
+
+class ItemNotFound(InstallationError):
+    pass
+
+
+class ConfigurationError(InstallationError):
+    pass
+
+
+def FindPath(options, server, name):
+    if name.lower().startswith("iis://"):
+        return name
+    else:
+        if name and name[0] != "/":
+            name = "/" + name
+        return FindWebServer(options, server) + "/ROOT" + name
+
+
+def LocateWebServerPath(description):
+    """
+    Find an IIS web server whose name or comment matches the provided
+    description (case-insensitive).
+
+    >>> LocateWebServerPath('Default Web Site') # doctest: +SKIP
+
+    or
+
+    >>> LocateWebServerPath('1') #doctest: +SKIP
+    """
+    assert len(description) >= 1, "Server name or comment is required"
+    iis = GetObject(_IIS_OBJECT)
+    description = description.lower().strip()
+    for site in iis:
+        # Name is generally a number, but no need to assume that.
+        site_attributes = [
+            getattr(site, attr, "").lower().strip()
+            for attr in ("Name", "ServerComment")
+        ]
+        if description in site_attributes:
+            return site.AdsPath
+    msg = "No web sites match the description '%s'" % description
+    raise ItemNotFound(msg)
+
+
+def GetWebServer(description=None):
+    """
+    Load the web server instance (COM object) for a given instance
+    or description.
+    If None is specified, the default website is retrieved (indicated
+    by the identifier 1.
+    """
+    description = description or "1"
+    path = LocateWebServerPath(description)
+    server = LoadWebServer(path)
+    return server
+
+
+def LoadWebServer(path):
+    try:
+        server = GetObject(path)
+    except pythoncom.com_error as details:
+        msg = details.strerror
+        if exc.excepinfo and exc.excepinfo[2]:
+            msg = exc.excepinfo[2]
+        msg = "WebServer %s: %s" % (path, msg)
+        raise ItemNotFound(msg)
+    return server
+
+
+def FindWebServer(options, server_desc):
+    """
+    Legacy function to allow options to define a .server property
+    to override the other parameter.  Use GetWebServer instead.
+    """
+    # options takes precedence
+    server_desc = options.server or server_desc
+    # make sure server_desc is unicode (could be mbcs if passed in
+    #  sys.argv).
+    if server_desc and not isinstance(server_desc, str):
+        server_desc = server_desc.decode("mbcs")
+
+    # get the server (if server_desc is None, the default site is acquired)
+    server = GetWebServer(server_desc)
+    return server.adsPath
+
+
+def split_path(path):
+    """
+    Get the parent path and basename.
+
+    >>> split_path('/')
+    ['', '']
+
+    >>> split_path('')
+    ['', '']
+
+    >>> split_path('foo')
+    ['', 'foo']
+
+    >>> split_path('/foo')
+    ['', 'foo']
+
+    >>> split_path('/foo/bar')
+    ['/foo', 'bar']
+
+    >>> split_path('foo/bar')
+    ['/foo', 'bar']
+    """
+
+    if not path.startswith("/"):
+        path = "/" + path
+    return path.rsplit("/", 1)
+
+
+def _CreateDirectory(iis_dir, name, params):
+    # We used to go to lengths to keep an existing virtual directory
+    # in place.  However, in some cases the existing directories got
+    # into a bad state, and an update failed to get them working.
+    # So we nuke it first.  If this is a problem, we could consider adding
+    # a --keep-existing option.
+    try:
+        # Also seen the Class change to a generic IISObject - so nuke
+        # *any* existing object, regardless of Class
+        assert name.strip("/"), "mustn't delete the root!"
+        iis_dir.Delete("", name)
+        log(2, "Deleted old directory '%s'" % (name,))
+    except pythoncom.com_error:
+        pass
+
+    newDir = iis_dir.Create(params.Type, name)
+    log(2, "Creating new directory '%s' in %s..." % (name, iis_dir.Name))
+
+    friendly = params.Description or params.Name
+    newDir.AppFriendlyName = friendly
+
+    # Note that the new directory won't be visible in the IIS UI
+    # unless the directory exists on the filesystem.
+    try:
+        path = params.Path or iis_dir.Path
+        newDir.Path = path
+    except AttributeError:
+        # If params.Type is IIS_WEBDIRECTORY, an exception is thrown
+        pass
+    newDir.AppCreate2(params.AppProtection)
+    # XXX - note that these Headers only work in IIS6 and earlier.  IIS7
+    # only supports them on the w3svc node - not even on individial sites,
+    # let alone individual extensions in the site!
+    if params.Headers:
+        newDir.HttpCustomHeaders = params.Headers
+
+    log(2, "Setting directory options...")
+    newDir.AccessExecute = params.AccessExecute
+    newDir.AccessRead = params.AccessRead
+    newDir.AccessWrite = params.AccessWrite
+    newDir.AccessScript = params.AccessScript
+    newDir.ContentIndexed = params.ContentIndexed
+    newDir.EnableDirBrowsing = params.EnableDirBrowsing
+    newDir.EnableDefaultDoc = params.EnableDefaultDoc
+    if params.DefaultDoc is not None:
+        newDir.DefaultDoc = params.DefaultDoc
+    newDir.SetInfo()
+    return newDir
+
+
+def CreateDirectory(params, options):
+    _CallHook(params, "PreInstall", options)
+    if not params.Name:
+        raise ConfigurationError("No Name param")
+    parent, name = params.split_path()
+    target_dir = GetObject(FindPath(options, params.Server, parent))
+
+    if not params.is_root():
+        target_dir = _CreateDirectory(target_dir, name, params)
+
+    AssignScriptMaps(params.ScriptMaps, target_dir, params.ScriptMapUpdate)
+
+    _CallHook(params, "PostInstall", options, target_dir)
+    log(1, "Configured Virtual Directory: %s" % (params.Name,))
+    return target_dir
+
+
+def AssignScriptMaps(script_maps, target, update="replace"):
+    """Updates IIS with the supplied script map information.
+
+    script_maps is a list of ScriptMapParameter objects
+
+    target is an IIS Virtual Directory to assign the script maps to
+
+    update is a string indicating how to update the maps, one of  ('start',
+    'end', or 'replace')
+    """
+    # determine which function to use to assign script maps
+    script_map_func = "_AssignScriptMaps" + update.capitalize()
+    try:
+        script_map_func = eval(script_map_func)
+    except NameError:
+        msg = "Unknown ScriptMapUpdate option '%s'" % update
+        raise ConfigurationError(msg)
+    # use the str method to format the script maps for IIS
+    script_maps = [str(s) for s in script_maps]
+    # call the correct function
+    script_map_func(target, script_maps)
+    target.SetInfo()
+
+
+def get_unique_items(sequence, reference):
+    "Return items in sequence that can't be found in reference."
+    return tuple([item for item in sequence if item not in reference])
+
+
+def _AssignScriptMapsReplace(target, script_maps):
+    target.ScriptMaps = script_maps
+
+
+def _AssignScriptMapsEnd(target, script_maps):
+    unique_new_maps = get_unique_items(script_maps, target.ScriptMaps)
+    target.ScriptMaps = target.ScriptMaps + unique_new_maps
+
+
+def _AssignScriptMapsStart(target, script_maps):
+    unique_new_maps = get_unique_items(script_maps, target.ScriptMaps)
+    target.ScriptMaps = unique_new_maps + target.ScriptMaps
+
+
+def CreateISAPIFilter(filterParams, options):
+    server = FindWebServer(options, filterParams.Server)
+    _CallHook(filterParams, "PreInstall", options)
+    try:
+        filters = GetObject(server + "/Filters")
+    except pythoncom.com_error as exc:
+        # Brand new sites don't have the '/Filters' collection - create it.
+        # Any errors other than 'not found' we shouldn't ignore.
+        if (
+            winerror.HRESULT_FACILITY(exc.hresult) != winerror.FACILITY_WIN32
+            or winerror.HRESULT_CODE(exc.hresult) != winerror.ERROR_PATH_NOT_FOUND
+        ):
+            raise
+        server_ob = GetObject(server)
+        filters = server_ob.Create(_IIS_FILTERS, "Filters")
+        filters.FilterLoadOrder = ""
+        filters.SetInfo()
+
+    # As for VirtualDir, delete an existing one.
+    assert filterParams.Name.strip("/"), "mustn't delete the root!"
+    try:
+        filters.Delete(_IIS_FILTER, filterParams.Name)
+        log(2, "Deleted old filter '%s'" % (filterParams.Name,))
+    except pythoncom.com_error:
+        pass
+    newFilter = filters.Create(_IIS_FILTER, filterParams.Name)
+    log(2, "Created new ISAPI filter...")
+    assert os.path.isfile(filterParams.Path)
+    newFilter.FilterPath = filterParams.Path
+    newFilter.FilterDescription = filterParams.Description
+    newFilter.SetInfo()
+    load_order = [b.strip() for b in filters.FilterLoadOrder.split(",") if b]
+    if filterParams.Name not in load_order:
+        load_order.append(filterParams.Name)
+        filters.FilterLoadOrder = ",".join(load_order)
+        filters.SetInfo()
+    _CallHook(filterParams, "PostInstall", options, newFilter)
+    log(1, "Configured Filter: %s" % (filterParams.Name,))
+    return newFilter
+
+
+def DeleteISAPIFilter(filterParams, options):
+    _CallHook(filterParams, "PreRemove", options)
+    server = FindWebServer(options, filterParams.Server)
+    ob_path = server + "/Filters"
+    try:
+        filters = GetObject(ob_path)
+    except pythoncom.com_error as details:
+        # failure to open the filters just means a totally clean IIS install
+        # (IIS5 at least has no 'Filters' key when freshly installed).
+        log(2, "ISAPI filter path '%s' did not exist." % (ob_path,))
+        return
+    try:
+        assert filterParams.Name.strip("/"), "mustn't delete the root!"
+        filters.Delete(_IIS_FILTER, filterParams.Name)
+        log(2, "Deleted ISAPI filter '%s'" % (filterParams.Name,))
+    except pythoncom.com_error as details:
+        rc = _GetWin32ErrorCode(details)
+        if rc != winerror.ERROR_PATH_NOT_FOUND:
+            raise
+        log(2, "ISAPI filter '%s' did not exist." % (filterParams.Name,))
+    # Remove from the load order
+    load_order = [b.strip() for b in filters.FilterLoadOrder.split(",") if b]
+    if filterParams.Name in load_order:
+        load_order.remove(filterParams.Name)
+        filters.FilterLoadOrder = ",".join(load_order)
+        filters.SetInfo()
+    _CallHook(filterParams, "PostRemove", options)
+    log(1, "Deleted Filter: %s" % (filterParams.Name,))
+
+
+def _AddExtensionFile(module, def_groupid, def_desc, params, options):
+    group_id = params.AddExtensionFile_GroupID or def_groupid
+    desc = params.AddExtensionFile_Description or def_desc
+    try:
+        ob = GetObject(_IIS_OBJECT)
+        ob.AddExtensionFile(
+            module,
+            params.AddExtensionFile_Enabled,
+            group_id,
+            params.AddExtensionFile_CanDelete,
+            desc,
+        )
+        log(2, "Added extension file '%s' (%s)" % (module, desc))
+    except (pythoncom.com_error, AttributeError) as details:
+        # IIS5 always fails.  Probably should upgrade this to
+        # complain more loudly if IIS6 fails.
+        log(2, "Failed to add extension file '%s': %s" % (module, details))
+
+
+def AddExtensionFiles(params, options):
+    """Register the modules used by the filters/extensions as a trusted
+    'extension module' - required by the default IIS6 security settings."""
+    # Add each module only once.
+    added = {}
+    for vd in params.VirtualDirs:
+        for smp in vd.ScriptMaps:
+            if smp.Module not in added and smp.AddExtensionFile:
+                _AddExtensionFile(smp.Module, vd.Name, vd.Description, smp, options)
+                added[smp.Module] = True
+
+    for fd in params.Filters:
+        if fd.Path not in added and fd.AddExtensionFile:
+            _AddExtensionFile(fd.Path, fd.Name, fd.Description, fd, options)
+            added[fd.Path] = True
+
+
+def _DeleteExtensionFileRecord(module, options):
+    try:
+        ob = GetObject(_IIS_OBJECT)
+        ob.DeleteExtensionFileRecord(module)
+        log(2, "Deleted extension file record for '%s'" % module)
+    except (pythoncom.com_error, AttributeError) as details:
+        log(2, "Failed to remove extension file '%s': %s" % (module, details))
+
+
+def DeleteExtensionFileRecords(params, options):
+    deleted = {}  # only remove each .dll once.
+    for vd in params.VirtualDirs:
+        for smp in vd.ScriptMaps:
+            if smp.Module not in deleted and smp.AddExtensionFile:
+                _DeleteExtensionFileRecord(smp.Module, options)
+                deleted[smp.Module] = True
+
+    for filter_def in params.Filters:
+        if filter_def.Path not in deleted and filter_def.AddExtensionFile:
+            _DeleteExtensionFileRecord(filter_def.Path, options)
+            deleted[filter_def.Path] = True
+
+
+def CheckLoaderModule(dll_name):
+    suffix = ""
+    if is_debug_build:
+        suffix = "_d"
+    template = os.path.join(this_dir, "PyISAPI_loader" + suffix + ".dll")
+    if not os.path.isfile(template):
+        raise ConfigurationError("Template loader '%s' does not exist" % (template,))
+    # We can't do a simple "is newer" check, as the DLL is specific to the
+    # Python version.  So we check the date-time and size are identical,
+    # and skip the copy in that case.
+    src_stat = os.stat(template)
+    try:
+        dest_stat = os.stat(dll_name)
+    except os.error:
+        same = 0
+    else:
+        same = (
+            src_stat[stat.ST_SIZE] == dest_stat[stat.ST_SIZE]
+            and src_stat[stat.ST_MTIME] == dest_stat[stat.ST_MTIME]
+        )
+    if not same:
+        log(2, "Updating %s->%s" % (template, dll_name))
+        shutil.copyfile(template, dll_name)
+        shutil.copystat(template, dll_name)
+    else:
+        log(2, "%s is up to date." % (dll_name,))
+
+
+def _CallHook(ob, hook_name, options, *extra_args):
+    func = getattr(ob, hook_name, None)
+    if func is not None:
+        args = (ob, options) + extra_args
+        func(*args)
+
+
+def Install(params, options):
+    _CallHook(params, "PreInstall", options)
+    for vd in params.VirtualDirs:
+        CreateDirectory(vd, options)
+
+    for filter_def in params.Filters:
+        CreateISAPIFilter(filter_def, options)
+
+    AddExtensionFiles(params, options)
+
+    _CallHook(params, "PostInstall", options)
+
+
+def RemoveDirectory(params, options):
+    if params.is_root():
+        return
+    try:
+        directory = GetObject(FindPath(options, params.Server, params.Name))
+    except pythoncom.com_error as details:
+        rc = _GetWin32ErrorCode(details)
+        if rc != winerror.ERROR_PATH_NOT_FOUND:
+            raise
+        log(2, "VirtualDirectory '%s' did not exist" % params.Name)
+        directory = None
+    if directory is not None:
+        # Be robust should IIS get upset about unloading.
+        try:
+            directory.AppUnLoad()
+        except:
+            exc_val = sys.exc_info()[1]
+            log(2, "AppUnLoad() for %s failed: %s" % (params.Name, exc_val))
+        # Continue trying to delete it.
+        try:
+            parent = GetObject(directory.Parent)
+            parent.Delete(directory.Class, directory.Name)
+            log(1, "Deleted Virtual Directory: %s" % (params.Name,))
+        except:
+            exc_val = sys.exc_info()[1]
+            log(1, "Failed to remove directory %s: %s" % (params.Name, exc_val))
+
+
+def RemoveScriptMaps(vd_params, options):
+    "Remove script maps from the already installed virtual directory"
+    parent, name = vd_params.split_path()
+    target_dir = GetObject(FindPath(options, vd_params.Server, parent))
+    installed_maps = list(target_dir.ScriptMaps)
+    for _map in map(str, vd_params.ScriptMaps):
+        if _map in installed_maps:
+            installed_maps.remove(_map)
+    target_dir.ScriptMaps = installed_maps
+    target_dir.SetInfo()
+
+
+def Uninstall(params, options):
+    _CallHook(params, "PreRemove", options)
+
+    DeleteExtensionFileRecords(params, options)
+
+    for vd in params.VirtualDirs:
+        _CallHook(vd, "PreRemove", options)
+
+        RemoveDirectory(vd, options)
+        if vd.is_root():
+            # if this is installed to the root virtual directory, we can't delete it
+            #  so remove the script maps.
+            RemoveScriptMaps(vd, options)
+
+        _CallHook(vd, "PostRemove", options)
+
+    for filter_def in params.Filters:
+        DeleteISAPIFilter(filter_def, options)
+    _CallHook(params, "PostRemove", options)
+
+
+# Patch up any missing module names in the params, replacing them with
+# the DLL name that hosts this extension/filter.
+def _PatchParamsModule(params, dll_name, file_must_exist=True):
+    if file_must_exist:
+        if not os.path.isfile(dll_name):
+            raise ConfigurationError("%s does not exist" % (dll_name,))
+
+    # Patch up all references to the DLL.
+    for f in params.Filters:
+        if f.Path is None:
+            f.Path = dll_name
+    for d in params.VirtualDirs:
+        for sm in d.ScriptMaps:
+            if sm.Module is None:
+                sm.Module = dll_name
+
+
+def GetLoaderModuleName(mod_name, check_module=None):
+    # find the name of the DLL hosting us.
+    # By default, this is "_{module_base_name}.dll"
+    if hasattr(sys, "frozen"):
+        # What to do?  The .dll knows its name, but this is likely to be
+        # executed via a .exe, which does not know.
+        base, ext = os.path.splitext(mod_name)
+        path, base = os.path.split(base)
+        # handle the common case of 'foo.exe'/'foow.exe'
+        if base.endswith("w"):
+            base = base[:-1]
+        # For py2exe, we have '_foo.dll' as the standard pyisapi loader - but
+        # 'foo.dll' is what we use (it just delegates).
+        # So no leading '_' on the installed name.
+        dll_name = os.path.abspath(os.path.join(path, base + ".dll"))
+    else:
+        base, ext = os.path.splitext(mod_name)
+        path, base = os.path.split(base)
+        dll_name = os.path.abspath(os.path.join(path, "_" + base + ".dll"))
+    # Check we actually have it.
+    if check_module is None:
+        check_module = not hasattr(sys, "frozen")
+    if check_module:
+        CheckLoaderModule(dll_name)
+    return dll_name
+
+
+# Note the 'log' params to these 'builtin' args - old versions of pywin32
+# didn't log at all in this function (by intent; anyone calling this was
+# responsible). So existing code that calls this function with the old
+# signature (ie, without a 'log' param) still gets the same behaviour as
+# before...
+
+
+def InstallModule(conf_module_name, params, options, log=lambda *args: None):
+    "Install the extension"
+    if not hasattr(sys, "frozen"):
+        conf_module_name = os.path.abspath(conf_module_name)
+        if not os.path.isfile(conf_module_name):
+            raise ConfigurationError("%s does not exist" % (conf_module_name,))
+
+    loader_dll = GetLoaderModuleName(conf_module_name)
+    _PatchParamsModule(params, loader_dll)
+    Install(params, options)
+    log(1, "Installation complete.")
+
+
+def UninstallModule(conf_module_name, params, options, log=lambda *args: None):
+    "Remove the extension"
+    loader_dll = GetLoaderModuleName(conf_module_name, False)
+    _PatchParamsModule(params, loader_dll, False)
+    Uninstall(params, options)
+    log(1, "Uninstallation complete.")
+
+
+standard_arguments = {
+    "install": InstallModule,
+    "remove": UninstallModule,
+}
+
+
+def build_usage(handler_map):
+    docstrings = [handler.__doc__ for handler in handler_map.values()]
+    all_args = dict(zip(iter(handler_map.keys()), docstrings))
+    arg_names = "|".join(iter(all_args.keys()))
+    usage_string = "%prog [options] [" + arg_names + "]\n"
+    usage_string += "commands:\n"
+    for arg, desc in all_args.items():
+        usage_string += " %-10s: %s" % (arg, desc) + "\n"
+    return usage_string[:-1]
+
+
+def MergeStandardOptions(options, params):
+    """
+    Take an options object generated by the command line and merge
+    the values into the IISParameters object.
+    """
+    pass
+
+
+# We support 2 ways of extending our command-line/install support.
+# * Many of the installation items allow you to specify "PreInstall",
+#   "PostInstall", "PreRemove" and "PostRemove" hooks
+#   All hooks are called with the 'params' object being operated on, and
+#   the 'optparser' options for this session (ie, the command-line options)
+#   PostInstall for VirtualDirectories and Filters both have an additional
+#   param - the ADSI object just created.
+# * You can pass your own option parser for us to use, and/or define a map
+#   with your own custom arg handlers.  It is a map of 'arg'->function.
+#   The function is called with (options, log_fn, arg).  The function's
+#   docstring is used in the usage output.
+def HandleCommandLine(
+    params,
+    argv=None,
+    conf_module_name=None,
+    default_arg="install",
+    opt_parser=None,
+    custom_arg_handlers={},
+):
+    """Perform installation or removal of an ISAPI filter or extension.
+
+    This module handles standard command-line options and configuration
+    information, and installs, removes or updates the configuration of an
+    ISAPI filter or extension.
+
+    You must pass your configuration information in params - all other
+    arguments are optional, and allow you to configure the installation
+    process.
+    """
+    global verbose
+    from optparse import OptionParser
+
+    argv = argv or sys.argv
+    if not conf_module_name:
+        conf_module_name = sys.argv[0]
+        # convert to a long name so that if we were somehow registered with
+        # the "short" version but unregistered with the "long" version we
+        # still work (that will depend on exactly how the installer was
+        # started)
+        try:
+            conf_module_name = win32api.GetLongPathName(conf_module_name)
+        except win32api.error as exc:
+            log(
+                2,
+                "Couldn't determine the long name for %r: %s" % (conf_module_name, exc),
+            )
+
+    if opt_parser is None:
+        # Build our own parser.
+        parser = OptionParser(usage="")
+    else:
+        # The caller is providing their own filter, presumably with their
+        # own options all setup.
+        parser = opt_parser
+
+    # build a usage string if we don't have one.
+    if not parser.get_usage():
+        all_handlers = standard_arguments.copy()
+        all_handlers.update(custom_arg_handlers)
+        parser.set_usage(build_usage(all_handlers))
+
+    # allow the user to use uninstall as a synonym for remove if it wasn't
+    #  defined by the custom arg handlers.
+    all_handlers.setdefault("uninstall", all_handlers["remove"])
+
+    parser.add_option(
+        "-q",
+        "--quiet",
+        action="store_false",
+        dest="verbose",
+        default=True,
+        help="don't print status messages to stdout",
+    )
+    parser.add_option(
+        "-v",
+        "--verbosity",
+        action="count",
+        dest="verbose",
+        default=1,
+        help="increase the verbosity of status messages",
+    )
+    parser.add_option(
+        "",
+        "--server",
+        action="store",
+        help="Specifies the IIS server to install/uninstall on."
+        " Default is '%s/1'" % (_IIS_OBJECT,),
+    )
+
+    (options, args) = parser.parse_args(argv[1:])
+    MergeStandardOptions(options, params)
+    verbose = options.verbose
+    if not args:
+        args = [default_arg]
+    try:
+        for arg in args:
+            handler = all_handlers[arg]
+            handler(conf_module_name, params, options, log)
+    except (ItemNotFound, InstallationError) as details:
+        if options.verbose > 1:
+            traceback.print_exc()
+        print("%s: %s" % (details.__class__.__name__, details))
+    except KeyError:
+        parser.error("Invalid arg '%s'" % arg)
diff --git a/lib/isapi/isapicon.py b/lib/isapi/isapicon.py
new file mode 100644
index 00000000..20de1a44
--- /dev/null
+++ b/lib/isapi/isapicon.py
@@ -0,0 +1,120 @@
+"""Constants needed by ISAPI filters and extensions."""
+#  ======================================================================
+#  Copyright 2002-2003 by Blackdog Software Pty Ltd.
+#
+#                          All Rights Reserved
+#
+#  Permission to use, copy, modify, and distribute this software and
+#  its documentation for any purpose and without fee is hereby
+#  granted, provided that the above copyright notice appear in all
+#  copies and that both that copyright notice and this permission
+#  notice appear in supporting documentation, and that the name of
+#  Blackdog Software not be used in advertising or publicity pertaining to
+#  distribution of the software without specific, written prior
+#  permission.
+#
+#  BLACKDOG SOFTWARE DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
+#  INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN
+#  NO EVENT SHALL BLACKDOG SOFTWARE BE LIABLE FOR ANY SPECIAL, INDIRECT OR
+#  CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS
+#  OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
+#  NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
+#  CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+#  ======================================================================
+
+# HTTP reply codes
+
+HTTP_CONTINUE = 100
+HTTP_SWITCHING_PROTOCOLS = 101
+HTTP_PROCESSING = 102
+HTTP_OK = 200
+HTTP_CREATED = 201
+HTTP_ACCEPTED = 202
+HTTP_NON_AUTHORITATIVE = 203
+HTTP_NO_CONTENT = 204
+HTTP_RESET_CONTENT = 205
+HTTP_PARTIAL_CONTENT = 206
+HTTP_MULTI_STATUS = 207
+HTTP_MULTIPLE_CHOICES = 300
+HTTP_MOVED_PERMANENTLY = 301
+HTTP_MOVED_TEMPORARILY = 302
+HTTP_SEE_OTHER = 303
+HTTP_NOT_MODIFIED = 304
+HTTP_USE_PROXY = 305
+HTTP_TEMPORARY_REDIRECT = 307
+HTTP_BAD_REQUEST = 400
+HTTP_UNAUTHORIZED = 401
+HTTP_PAYMENT_REQUIRED = 402
+HTTP_FORBIDDEN = 403
+HTTP_NOT_FOUND = 404
+HTTP_METHOD_NOT_ALLOWED = 405
+HTTP_NOT_ACCEPTABLE = 406
+HTTP_PROXY_AUTHENTICATION_REQUIRED = 407
+HTTP_REQUEST_TIME_OUT = 408
+HTTP_CONFLICT = 409
+HTTP_GONE = 410
+HTTP_LENGTH_REQUIRED = 411
+HTTP_PRECONDITION_FAILED = 412
+HTTP_REQUEST_ENTITY_TOO_LARGE = 413
+HTTP_REQUEST_URI_TOO_LARGE = 414
+HTTP_UNSUPPORTED_MEDIA_TYPE = 415
+HTTP_RANGE_NOT_SATISFIABLE = 416
+HTTP_EXPECTATION_FAILED = 417
+HTTP_UNPROCESSABLE_ENTITY = 422
+HTTP_INTERNAL_SERVER_ERROR = 500
+HTTP_NOT_IMPLEMENTED = 501
+HTTP_BAD_GATEWAY = 502
+HTTP_SERVICE_UNAVAILABLE = 503
+HTTP_GATEWAY_TIME_OUT = 504
+HTTP_VERSION_NOT_SUPPORTED = 505
+HTTP_VARIANT_ALSO_VARIES = 506
+
+HSE_STATUS_SUCCESS = 1
+HSE_STATUS_SUCCESS_AND_KEEP_CONN = 2
+HSE_STATUS_PENDING = 3
+HSE_STATUS_ERROR = 4
+
+SF_NOTIFY_SECURE_PORT = 0x00000001
+SF_NOTIFY_NONSECURE_PORT = 0x00000002
+SF_NOTIFY_READ_RAW_DATA = 0x00008000
+SF_NOTIFY_PREPROC_HEADERS = 0x00004000
+SF_NOTIFY_AUTHENTICATION = 0x00002000
+SF_NOTIFY_URL_MAP = 0x00001000
+SF_NOTIFY_ACCESS_DENIED = 0x00000800
+SF_NOTIFY_SEND_RESPONSE = 0x00000040
+SF_NOTIFY_SEND_RAW_DATA = 0x00000400
+SF_NOTIFY_LOG = 0x00000200
+SF_NOTIFY_END_OF_REQUEST = 0x00000080
+SF_NOTIFY_END_OF_NET_SESSION = 0x00000100
+
+SF_NOTIFY_ORDER_HIGH = 0x00080000
+SF_NOTIFY_ORDER_MEDIUM = 0x00040000
+SF_NOTIFY_ORDER_LOW = 0x00020000
+SF_NOTIFY_ORDER_DEFAULT = SF_NOTIFY_ORDER_LOW
+
+SF_NOTIFY_ORDER_MASK = (
+    SF_NOTIFY_ORDER_HIGH | SF_NOTIFY_ORDER_MEDIUM | SF_NOTIFY_ORDER_LOW
+)
+
+SF_STATUS_REQ_FINISHED = 134217728  # 0x8000000
+SF_STATUS_REQ_FINISHED_KEEP_CONN = 134217728 + 1
+SF_STATUS_REQ_NEXT_NOTIFICATION = 134217728 + 2
+SF_STATUS_REQ_HANDLED_NOTIFICATION = 134217728 + 3
+SF_STATUS_REQ_ERROR = 134217728 + 4
+SF_STATUS_REQ_READ_NEXT = 134217728 + 5
+
+HSE_IO_SYNC = 0x00000001  # for WriteClient
+HSE_IO_ASYNC = 0x00000002  # for WriteClient/TF/EU
+HSE_IO_DISCONNECT_AFTER_SEND = 0x00000004  # for TF
+HSE_IO_SEND_HEADERS = 0x00000008  # for TF
+HSE_IO_NODELAY = 0x00001000  # turn off nagling
+# These two are only used by VectorSend
+HSE_IO_FINAL_SEND = 0x00000010
+HSE_IO_CACHE_RESPONSE = 0x00000020
+
+HSE_EXEC_URL_NO_HEADERS = 0x02
+HSE_EXEC_URL_IGNORE_CURRENT_INTERCEPTOR = 0x04
+HSE_EXEC_URL_IGNORE_VALIDATION_AND_RANGE = 0x10
+HSE_EXEC_URL_DISABLE_CUSTOM_ERROR = 0x20
+HSE_EXEC_URL_SSI_CMD = 0x40
+HSE_EXEC_URL_HTTP_CACHE_ELIGIBLE = 0x80
diff --git a/lib/isapi/samples/README.txt b/lib/isapi/samples/README.txt
new file mode 100644
index 00000000..cff87587
--- /dev/null
+++ b/lib/isapi/samples/README.txt
@@ -0,0 +1,20 @@
+In this directory you will find examples of ISAPI filters and extensions.
+
+The filter loading mechanism works like this:
+* IIS loads the special Python "loader" DLL.  This DLL will generally have a 
+  leading underscore as part of its name.
+* This loader DLL looks for a Python module, by removing the first letter of
+  the DLL base name.
+  
+This means that an ISAPI extension module consists of 2 key files - the loader
+DLL (eg, "_MyIISModule.dll", and a Python module (which for this example
+would be "MyIISModule.py")
+
+When you install an ISAPI extension, the installation code checks to see if
+there is a loader DLL for your implementation file - if one does not exist, 
+or the standard loader is different, it is copied and renamed accordingly.
+
+We use this mechanism to provide the maximum separation between different
+Python extensions installed on the same server - otherwise filter order and
+other tricky IIS semantics would need to be replicated.  Also, each filter
+gets its own thread-pool, etc.
diff --git a/lib/isapi/samples/advanced.py b/lib/isapi/samples/advanced.py
new file mode 100644
index 00000000..c10d0c80
--- /dev/null
+++ b/lib/isapi/samples/advanced.py
@@ -0,0 +1,218 @@
+# This extension demonstrates some advanced features of the Python ISAPI
+# framework.
+# We demonstrate:
+# * Reloading your Python module without shutting down IIS (eg, when your
+#   .py implementation file changes.)
+# * Custom command-line handling - both additional options and commands.
+# * Using a query string - any part of the URL after a '?' is assumed to
+#   be "variable names" separated by '&' - we will print the values of
+#   these server variables.
+# * If the tail portion of the URL is "ReportUnhealthy", IIS will be
+#   notified we are unhealthy via a HSE_REQ_REPORT_UNHEALTHY request.
+#   Whether this is acted upon depends on if the IIS health-checking
+#   tools are installed, but you should always see the reason written
+#   to the Windows event log - see the IIS documentation for more.
+
+import os
+import stat
+import sys
+
+from isapi import isapicon
+from isapi.simple import SimpleExtension
+
+if hasattr(sys, "isapidllhandle"):
+    import win32traceutil
+
+# Notes on reloading
+# If your HttpFilterProc or HttpExtensionProc functions raises
+# 'isapi.InternalReloadException', the framework will not treat it
+# as an error but instead will terminate your extension, reload your
+# extension module, re-initialize the instance, and re-issue the request.
+# The Initialize functions are called with None as their param.  The
+# return code from the terminate function is ignored.
+#
+# This is all the framework does to help you.  It is up to your code
+# when you raise this exception.  This sample uses a Win32 "find
+# notification".  Whenever windows tells us one of the files in the
+# directory has changed, we check if the time of our source-file has
+# changed, and set a flag.  Next imcoming request, we check the flag and
+# raise the special exception if set.
+#
+# The end result is that the module is automatically reloaded whenever
+# the source-file changes - you need take no further action to see your
+# changes reflected in the running server.
+
+# The framework only reloads your module - if you have libraries you
+# depend on and also want reloaded, you must arrange for this yourself.
+# One way of doing this would be to special case the import of these
+# modules.  Eg:
+# --
+# try:
+#    my_module = reload(my_module) # module already imported - reload it
+# except NameError:
+#    import my_module # first time around - import it.
+# --
+# When your module is imported for the first time, the NameError will
+# be raised, and the module imported.  When the ISAPI framework reloads
+# your module, the existing module will avoid the NameError, and allow
+# you to reload that module.
+
+import threading
+
+import win32con
+import win32event
+import win32file
+import winerror
+
+from isapi import InternalReloadException
+
+try:
+    reload_counter += 1
+except NameError:
+    reload_counter = 0
+
+
+# A watcher thread that checks for __file__ changing.
+# When it detects it, it simply sets "change_detected" to true.
+class ReloadWatcherThread(threading.Thread):
+    def __init__(self):
+        self.change_detected = False
+        self.filename = __file__
+        if self.filename.endswith("c") or self.filename.endswith("o"):
+            self.filename = self.filename[:-1]
+        self.handle = win32file.FindFirstChangeNotification(
+            os.path.dirname(self.filename),
+            False,  # watch tree?
+            win32con.FILE_NOTIFY_CHANGE_LAST_WRITE,
+        )
+        threading.Thread.__init__(self)
+
+    def run(self):
+        last_time = os.stat(self.filename)[stat.ST_MTIME]
+        while 1:
+            try:
+                rc = win32event.WaitForSingleObject(self.handle, win32event.INFINITE)
+                win32file.FindNextChangeNotification(self.handle)
+            except win32event.error as details:
+                # handle closed - thread should terminate.
+                if details.winerror != winerror.ERROR_INVALID_HANDLE:
+                    raise
+                break
+            this_time = os.stat(self.filename)[stat.ST_MTIME]
+            if this_time != last_time:
+                print("Detected file change - flagging for reload.")
+                self.change_detected = True
+                last_time = this_time
+
+    def stop(self):
+        win32file.FindCloseChangeNotification(self.handle)
+
+
+# The ISAPI extension - handles requests in our virtual dir, and sends the
+# response to the client.
+class Extension(SimpleExtension):
+    "Python advanced sample Extension"
+
+    def __init__(self):
+        self.reload_watcher = ReloadWatcherThread()
+        self.reload_watcher.start()
+
+    def HttpExtensionProc(self, ecb):
+        # NOTE: If you use a ThreadPoolExtension, you must still perform
+        # this check in HttpExtensionProc - raising the exception from
+        # The "Dispatch" method will just cause the exception to be
+        # rendered to the browser.
+        if self.reload_watcher.change_detected:
+            print("Doing reload")
+            raise InternalReloadException
+
+        url = ecb.GetServerVariable("UNICODE_URL")
+        if url.endswith("ReportUnhealthy"):
+            ecb.ReportUnhealthy("I'm a little sick")
+
+        ecb.SendResponseHeaders("200 OK", "Content-Type: text/html\r\n\r\n", 0)
+        print("<HTML><BODY>", file=ecb)
+
+        qs = ecb.GetServerVariable("QUERY_STRING")
+        if qs:
+            queries = qs.split("&")
+            print("<PRE>", file=ecb)
+            for q in queries:
+                val = ecb.GetServerVariable(q, "&lt;no such variable&gt;")
+                print("%s=%r" % (q, val), file=ecb)
+            print("</PRE><P/>", file=ecb)
+
+        print("This module has been imported", file=ecb)
+        print("%d times" % (reload_counter,), file=ecb)
+        print("</BODY></HTML>", file=ecb)
+        ecb.close()
+        return isapicon.HSE_STATUS_SUCCESS
+
+    def TerminateExtension(self, status):
+        self.reload_watcher.stop()
+
+
+# The entry points for the ISAPI extension.
+def __ExtensionFactory__():
+    return Extension()
+
+
+# Our special command line customization.
+# Pre-install hook for our virtual directory.
+def PreInstallDirectory(params, options):
+    # If the user used our special '--description' option,
+    # then we override our default.
+    if options.description:
+        params.Description = options.description
+
+
+# Post install hook for our entire script
+def PostInstall(params, options):
+    print()
+    print("The sample has been installed.")
+    print("Point your browser to /AdvancedPythonSample")
+    print("If you modify the source file and reload the page,")
+    print("you should see the reload counter increment")
+
+
+# Handler for our custom 'status' argument.
+def status_handler(options, log, arg):
+    "Query the status of something"
+    print("Everything seems to be fine!")
+
+
+custom_arg_handlers = {"status": status_handler}
+
+if __name__ == "__main__":
+    # If run from the command-line, install ourselves.
+    from isapi.install import *
+
+    params = ISAPIParameters(PostInstall=PostInstall)
+    # Setup the virtual directories - this is a list of directories our
+    # extension uses - in this case only 1.
+    # Each extension has a "script map" - this is the mapping of ISAPI
+    # extensions.
+    sm = [ScriptMapParams(Extension="*", Flags=0)]
+    vd = VirtualDirParameters(
+        Name="AdvancedPythonSample",
+        Description=Extension.__doc__,
+        ScriptMaps=sm,
+        ScriptMapUpdate="replace",
+        # specify the pre-install hook.
+        PreInstall=PreInstallDirectory,
+    )
+    params.VirtualDirs = [vd]
+    # Setup our custom option parser.
+    from optparse import OptionParser
+
+    parser = OptionParser("")  # blank usage, so isapi sets it.
+    parser.add_option(
+        "",
+        "--description",
+        action="store",
+        help="custom description to use for the virtual directory",
+    )
+
+    HandleCommandLine(
+        params, opt_parser=parser, custom_arg_handlers=custom_arg_handlers
+    )
diff --git a/lib/isapi/samples/redirector.py b/lib/isapi/samples/redirector.py
new file mode 100644
index 00000000..40698bb2
--- /dev/null
+++ b/lib/isapi/samples/redirector.py
@@ -0,0 +1,125 @@
+# This is a sample ISAPI extension written in Python.
+#
+# Please see README.txt in this directory, and specifically the
+# information about the "loader" DLL - installing this sample will create
+# "_redirector.dll" in the current directory.  The readme explains this.
+
+# Executing this script (or any server config script) will install the extension
+# into your web server. As the server executes, the PyISAPI framework will load
+# this module and create your Extension and Filter objects.
+
+# This is the simplest possible redirector (or proxy) we can write.  The
+# extension installs with a mask of '*' in the root of the site.
+# As an added bonus though, we optionally show how, on IIS6 and later, we
+# can use HSE_ERQ_EXEC_URL to ignore certain requests - in IIS5 and earlier
+# we can only do this with an ISAPI filter - see redirector_with_filter for
+# an example.  If this sample is run on IIS5 or earlier it simply ignores
+# any excludes.
+
+import sys
+
+from isapi import isapicon, threaded_extension
+
+try:
+    from urllib.request import urlopen
+except ImportError:
+    # py3k spelling...
+    from urllib.request import urlopen
+
+import win32api
+
+# sys.isapidllhandle will exist when we are loaded by the IIS framework.
+# In this case we redirect our output to the win32traceutil collector.
+if hasattr(sys, "isapidllhandle"):
+    import win32traceutil
+
+# The site we are proxying.
+proxy = "http://www.python.org"
+
+# Urls we exclude (ie, allow IIS to handle itself) - all are lowered,
+# and these entries exist by default on Vista...
+excludes = ["/iisstart.htm", "/welcome.png"]
+
+
+# An "io completion" function, called when ecb.ExecURL completes...
+def io_callback(ecb, url, cbIO, errcode):
+    # Get the status of our ExecURL
+    httpstatus, substatus, win32 = ecb.GetExecURLStatus()
+    print(
+        "ExecURL of %r finished with http status %d.%d, win32 status %d (%s)"
+        % (url, httpstatus, substatus, win32, win32api.FormatMessage(win32).strip())
+    )
+    # nothing more to do!
+    ecb.DoneWithSession()
+
+
+# The ISAPI extension - handles all requests in the site.
+class Extension(threaded_extension.ThreadPoolExtension):
+    "Python sample Extension"
+
+    def Dispatch(self, ecb):
+        # Note that our ThreadPoolExtension base class will catch exceptions
+        # in our Dispatch method, and write the traceback to the client.
+        # That is perfect for this sample, so we don't catch our own.
+        # print 'IIS dispatching "%s"' % (ecb.GetServerVariable("URL"),)
+        url = ecb.GetServerVariable("URL").decode("ascii")
+        for exclude in excludes:
+            if url.lower().startswith(exclude):
+                print("excluding %s" % url)
+                if ecb.Version < 0x60000:
+                    print("(but this is IIS5 or earlier - can't do 'excludes')")
+                else:
+                    ecb.IOCompletion(io_callback, url)
+                    ecb.ExecURL(
+                        None,
+                        None,
+                        None,
+                        None,
+                        None,
+                        isapicon.HSE_EXEC_URL_IGNORE_CURRENT_INTERCEPTOR,
+                    )
+                    return isapicon.HSE_STATUS_PENDING
+
+        new_url = proxy + url
+        print("Opening %s" % new_url)
+        fp = urlopen(new_url)
+        headers = fp.info()
+        # subtle py3k breakage: in py3k, str(headers) has normalized \r\n
+        # back to \n and also stuck an extra \n term.  py2k leaves the
+        # \r\n from the server in tact and finishes with a single term.
+        if sys.version_info < (3, 0):
+            header_text = str(headers) + "\r\n"
+        else:
+            # take *all* trailing \n off, replace remaining with
+            # \r\n, then add the 2 trailing \r\n.
+            header_text = str(headers).rstrip("\n").replace("\n", "\r\n") + "\r\n\r\n"
+        ecb.SendResponseHeaders("200 OK", header_text, False)
+        ecb.WriteClient(fp.read())
+        ecb.DoneWithSession()
+        print("Returned data from '%s'" % (new_url,))
+        return isapicon.HSE_STATUS_SUCCESS
+
+
+# The entry points for the ISAPI extension.
+def __ExtensionFactory__():
+    return Extension()
+
+
+if __name__ == "__main__":
+    # If run from the command-line, install ourselves.
+    from isapi.install import *
+
+    params = ISAPIParameters()
+    # Setup the virtual directories - this is a list of directories our
+    # extension uses - in this case only 1.
+    # Each extension has a "script map" - this is the mapping of ISAPI
+    # extensions.
+    sm = [ScriptMapParams(Extension="*", Flags=0)]
+    vd = VirtualDirParameters(
+        Name="/",
+        Description=Extension.__doc__,
+        ScriptMaps=sm,
+        ScriptMapUpdate="replace",
+    )
+    params.VirtualDirs = [vd]
+    HandleCommandLine(params)
diff --git a/lib/isapi/samples/redirector_asynch.py b/lib/isapi/samples/redirector_asynch.py
new file mode 100644
index 00000000..3c4b5e4f
--- /dev/null
+++ b/lib/isapi/samples/redirector_asynch.py
@@ -0,0 +1,85 @@
+# This is a sample ISAPI extension written in Python.
+
+# This is like the other 'redirector' samples, but uses asnch IO when writing
+# back to the client (it does *not* use asynch io talking to the remote
+# server!)
+
+import sys
+import urllib.error
+import urllib.parse
+import urllib.request
+
+from isapi import isapicon, threaded_extension
+
+# sys.isapidllhandle will exist when we are loaded by the IIS framework.
+# In this case we redirect our output to the win32traceutil collector.
+if hasattr(sys, "isapidllhandle"):
+    import win32traceutil
+
+# The site we are proxying.
+proxy = "http://www.python.org"
+
+# We synchronously read chunks of this size then asynchronously write them.
+CHUNK_SIZE = 8192
+
+
+# The callback made when IIS completes the asynch write.
+def io_callback(ecb, fp, cbIO, errcode):
+    print("IO callback", ecb, fp, cbIO, errcode)
+    chunk = fp.read(CHUNK_SIZE)
+    if chunk:
+        ecb.WriteClient(chunk, isapicon.HSE_IO_ASYNC)
+        # and wait for the next callback to say this chunk is done.
+    else:
+        # eof - say we are complete.
+        fp.close()
+        ecb.DoneWithSession()
+
+
+# The ISAPI extension - handles all requests in the site.
+class Extension(threaded_extension.ThreadPoolExtension):
+    "Python sample proxy server - asynch version."
+
+    def Dispatch(self, ecb):
+        print('IIS dispatching "%s"' % (ecb.GetServerVariable("URL"),))
+        url = ecb.GetServerVariable("URL")
+
+        new_url = proxy + url
+        print("Opening %s" % new_url)
+        fp = urllib.request.urlopen(new_url)
+        headers = fp.info()
+        ecb.SendResponseHeaders("200 OK", str(headers) + "\r\n", False)
+        # now send the first chunk asynchronously
+        ecb.ReqIOCompletion(io_callback, fp)
+        chunk = fp.read(CHUNK_SIZE)
+        if chunk:
+            ecb.WriteClient(chunk, isapicon.HSE_IO_ASYNC)
+            return isapicon.HSE_STATUS_PENDING
+        # no data - just close things now.
+        ecb.DoneWithSession()
+        return isapicon.HSE_STATUS_SUCCESS
+
+
+# The entry points for the ISAPI extension.
+def __ExtensionFactory__():
+    return Extension()
+
+
+if __name__ == "__main__":
+    # If run from the command-line, install ourselves.
+    from isapi.install import *
+
+    params = ISAPIParameters()
+    # Setup the virtual directories - this is a list of directories our
+    # extension uses - in this case only 1.
+    # Each extension has a "script map" - this is the mapping of ISAPI
+    # extensions.
+    sm = [ScriptMapParams(Extension="*", Flags=0)]
+    vd = VirtualDirParameters(
+        Name="/",
+        Description=Extension.__doc__,
+        ScriptMaps=sm,
+        ScriptMapUpdate="replace",
+    )
+    params.VirtualDirs = [vd]
+    HandleCommandLine(params)
diff --git a/lib/isapi/samples/redirector_with_filter.py b/lib/isapi/samples/redirector_with_filter.py
new file mode 100644
index 00000000..a63b1db1
--- /dev/null
+++ b/lib/isapi/samples/redirector_with_filter.py
@@ -0,0 +1,161 @@
+# This is a sample configuration file for an ISAPI filter and extension
+# written in Python.
+#
+# Please see README.txt in this directory, and specifically the
+# information about the "loader" DLL - installing this sample will create
+# "_redirector_with_filter.dll" in the current directory.  The readme explains
+# this.
+
+# Executing this script (or any server config script) will install the extension
+# into your web server. As the server executes, the PyISAPI framework will load
+# this module and create your Extension and Filter objects.
+
+# This sample provides sample redirector:
+# It is implemented by a filter and an extension, so that some requests can
+# be ignored.  Compare with 'redirector_simple' which avoids the filter, but
+# is unable to selectively ignore certain requests.
+# The process is sample uses is:
+# * The filter is installed globally, as all filters are.
+# * A Virtual Directory named "python" is setup.  This dir has our ISAPI
+#   extension as the only application, mapped to file-extension '*'.  Thus, our
+#   extension handles *all* requests in this directory.
+# The basic process is that the filter does URL rewriting, redirecting every
+# URL to our Virtual Directory.  Our extension then handles this request,
+# forwarding the data from the proxied site.
+# For example:
+# * URL of "index.html" comes in.
+# * Filter rewrites this to "/python/index.html"
+# * Our extension sees the full "/python/index.html", removes the leading
+#   portion, and opens and forwards the remote URL.
+
+
+# This sample is very small - it avoid most error handling, etc.  It is for
+# demonstration purposes only.
+
+import sys
+import urllib.error
+import urllib.parse
+import urllib.request
+
+from isapi import isapicon, threaded_extension
+from isapi.simple import SimpleFilter
+
+# sys.isapidllhandle will exist when we are loaded by the IIS framework.
+# In this case we redirect our output to the win32traceutil collector.
+if hasattr(sys, "isapidllhandle"):
+    import win32traceutil
+
+# The site we are proxying.
+proxy = "http://www.python.org"
+# The name of the virtual directory we install in, and redirect from.
+virtualdir = "/python"
+
+# The key feature of this redirector over the simple redirector is that it
+# can choose to ignore certain responses by having the filter not rewrite them
+# to our virtual dir. For this sample, we just exclude the IIS help directory.
+
+
+# The ISAPI extension - handles requests in our virtual dir, and sends the
+# response to the client.
+class Extension(threaded_extension.ThreadPoolExtension):
+    "Python sample Extension"
+
+    def Dispatch(self, ecb):
+        # Note that our ThreadPoolExtension base class will catch exceptions
+        # in our Dispatch method, and write the traceback to the client.
+        # That is perfect for this sample, so we don't catch our own.
+        # print 'IIS dispatching "%s"' % (ecb.GetServerVariable("URL"),)
+        url = ecb.GetServerVariable("URL")
+        if url.startswith(virtualdir):
+            new_url = proxy + url[len(virtualdir) :]
+            print("Opening", new_url)
+            fp = urllib.request.urlopen(new_url)
+            headers = fp.info()
+            ecb.SendResponseHeaders("200 OK", str(headers) + "\r\n", False)
+            ecb.WriteClient(fp.read())
+            ecb.DoneWithSession()
+            print("Returned data from '%s'!" % (new_url,))
+        else:
+            # this should never happen - we should only see requests that
+            # start with our virtual directory name.
+            print("Not proxying '%s'" % (url,))
+
+
+# The ISAPI filter.
+class Filter(SimpleFilter):
+    "Sample Python Redirector"
+    filter_flags = isapicon.SF_NOTIFY_PREPROC_HEADERS | isapicon.SF_NOTIFY_ORDER_DEFAULT
+
+    def HttpFilterProc(self, fc):
+        # print "Filter Dispatch"
+        nt = fc.NotificationType
+        if nt != isapicon.SF_NOTIFY_PREPROC_HEADERS:
+            return isapicon.SF_STATUS_REQ_NEXT_NOTIFICATION
+
+        pp = fc.GetData()
+        url = pp.GetHeader("url")
+        # print "URL is '%s'" % (url,)
+        prefix = virtualdir
+        if not url.startswith(prefix):
+            new_url = prefix + url
+            print("New proxied URL is '%s'" % (new_url,))
+            pp.SetHeader("url", new_url)
+            # For the sake of demonstration, show how the FilterContext
+            # attribute is used.  It always starts out life as None, and
+            # any assignments made are automatically decref'd by the
+            # framework during a SF_NOTIFY_END_OF_NET_SESSION notification.
+            if fc.FilterContext is None:
+                fc.FilterContext = 0
+            fc.FilterContext += 1
+            print("This is request number %d on this connection" % fc.FilterContext)
+            return isapicon.SF_STATUS_REQ_HANDLED_NOTIFICATION
+        else:
+            print("Filter ignoring URL '%s'" % (url,))
+
+            # Some older code that handled SF_NOTIFY_URL_MAP.
+            # ~ print "Have URL_MAP notify"
+            # ~ urlmap = fc.GetData()
+            # ~ print "URI is", urlmap.URL
+            # ~ print "Path is", urlmap.PhysicalPath
+            # ~ if urlmap.URL.startswith("/UC/"):
+            # ~ # Find the /UC/ in the physical path, and nuke it (except
+            # ~ # as the path is physical, it is \)
+            # ~ p = urlmap.PhysicalPath
+            # ~ pos = p.index("\\UC\\")
+            # ~ p = p[:pos] + p[pos+3:]
+            # ~ p = r"E:\src\pyisapi\webroot\PyTest\formTest.htm"
+            # ~ print "New path is", p
+            # ~ urlmap.PhysicalPath = p
+
+
+# The entry points for the ISAPI extension.
+def __FilterFactory__():
+    return Filter()
+
+
+def __ExtensionFactory__():
+    return Extension()
+
+
+if __name__ == "__main__":
+    # If run from the command-line, install ourselves.
+    from isapi.install import *
+
+    params = ISAPIParameters()
+    # Setup all filters - these are global to the site.
+    params.Filters = [
+        FilterParameters(Name="PythonRedirector", Description=Filter.__doc__),
+    ]
+    # Setup the virtual directories - this is a list of directories our
+    # extension uses - in this case only 1.
+    # Each extension has a "script map" - this is the mapping of ISAPI
+    # extensions.
+    sm = [ScriptMapParams(Extension="*", Flags=0)]
+    vd = VirtualDirParameters(
+        Name=virtualdir[1:],
+        Description=Extension.__doc__,
+        ScriptMaps=sm,
+        ScriptMapUpdate="replace",
+    )
+    params.VirtualDirs = [vd]
+    HandleCommandLine(params)
diff --git a/lib/isapi/samples/test.py b/lib/isapi/samples/test.py
new file mode 100644
index 00000000..5e4d899b
--- /dev/null
+++ b/lib/isapi/samples/test.py
@@ -0,0 +1,195 @@
+# This extension is used mainly for testing purposes - it is not
+# designed to be a simple sample, but instead is a hotch-potch of things
+# that attempts to exercise the framework.
+
+import os
+import stat
+import sys
+
+from isapi import isapicon
+from isapi.simple import SimpleExtension
+
+if hasattr(sys, "isapidllhandle"):
+    import win32traceutil
+
+# We use the same reload support as 'advanced.py' demonstrates.
+import threading
+
+import win32con
+import win32event
+import win32file
+import winerror
+
+from isapi import InternalReloadException
+
+
+# A watcher thread that checks for __file__ changing.
+# When it detects it, it simply sets "change_detected" to true.
+class ReloadWatcherThread(threading.Thread):
+    def __init__(self):
+        self.change_detected = False
+        self.filename = __file__
+        if self.filename.endswith("c") or self.filename.endswith("o"):
+            self.filename = self.filename[:-1]
+        self.handle = win32file.FindFirstChangeNotification(
+            os.path.dirname(self.filename),
+            False,  # watch tree?
+            win32con.FILE_NOTIFY_CHANGE_LAST_WRITE,
+        )
+        threading.Thread.__init__(self)
+
+    def run(self):
+        last_time = os.stat(self.filename)[stat.ST_MTIME]
+        while 1:
+            try:
+                rc = win32event.WaitForSingleObject(self.handle, win32event.INFINITE)
+                win32file.FindNextChangeNotification(self.handle)
+            except win32event.error as details:
+                # handle closed - thread should terminate.
+                if details.winerror != winerror.ERROR_INVALID_HANDLE:
+                    raise
+                break
+            this_time = os.stat(self.filename)[stat.ST_MTIME]
+            if this_time != last_time:
+                print("Detected file change - flagging for reload.")
+                self.change_detected = True
+                last_time = this_time
+
+    def stop(self):
+        win32file.FindCloseChangeNotification(self.handle)
+
+
+def TransmitFileCallback(ecb, hFile, cbIO, errCode):
+    print("Transmit complete!")
+    ecb.close()
+
+
+# The ISAPI extension - handles requests in our virtual dir, and sends the
+# response to the client.
+class Extension(SimpleExtension):
+    "Python test Extension"
+
+    def __init__(self):
+        self.reload_watcher = ReloadWatcherThread()
+        self.reload_watcher.start()
+
+    def HttpExtensionProc(self, ecb):
+        # NOTE: If you use a ThreadPoolExtension, you must still perform
+        # this check in HttpExtensionProc - raising the exception from
+        # The "Dispatch" method will just cause the exception to be
+        # rendered to the browser.
+        if self.reload_watcher.change_detected:
+            print("Doing reload")
+            raise InternalReloadException
+
+        if ecb.GetServerVariable("UNICODE_URL").endswith("test.py"):
+            file_flags = (
+                win32con.FILE_FLAG_SEQUENTIAL_SCAN | win32con.FILE_FLAG_OVERLAPPED
+            )
+            hfile = win32file.CreateFile(
+                __file__,
+                win32con.GENERIC_READ,
+                0,
+                None,
+                win32con.OPEN_EXISTING,
+                file_flags,
+                None,
+            )
+            flags = (
+                isapicon.HSE_IO_ASYNC
+                | isapicon.HSE_IO_DISCONNECT_AFTER_SEND
+                | isapicon.HSE_IO_SEND_HEADERS
+            )
+            # We pass hFile to the callback simply as a way of keeping it alive
+            # for the duration of the transmission
+            try:
+                ecb.TransmitFile(
+                    TransmitFileCallback,
+                    hfile,
+                    int(hfile),
+                    "200 OK",
+                    0,
+                    0,
+                    None,
+                    None,
+                    flags,
+                )
+            except:
+                # Errors keep this source file open!
+                hfile.Close()
+                raise
+        else:
+            # default response
+            ecb.SendResponseHeaders("200 OK", "Content-Type: text/html\r\n\r\n", 0)
+            print("<HTML><BODY>", file=ecb)
+            print("The root of this site is at", ecb.MapURLToPath("/"), file=ecb)
+            print("</BODY></HTML>", file=ecb)
+            ecb.close()
+        return isapicon.HSE_STATUS_SUCCESS
+
+    def TerminateExtension(self, status):
+        self.reload_watcher.stop()
+
+
+# The entry points for the ISAPI extension.
+def __ExtensionFactory__():
+    return Extension()
+
+
+# Our special command line customization.
+# Pre-install hook for our virtual directory.
+def PreInstallDirectory(params, options):
+    # If the user used our special '--description' option,
+    # then we override our default.
+    if options.description:
+        params.Description = options.description
+
+
+# Post install hook for our entire script
+def PostInstall(params, options):
+    print()
+    print("The sample has been installed.")
+    print("Point your browser to /PyISAPITest")
+
+
+# Handler for our custom 'status' argument.
+def status_handler(options, log, arg):
+    "Query the status of something"
+    print("Everything seems to be fine!")
+
+
+custom_arg_handlers = {"status": status_handler}
+
+if __name__ == "__main__":
+    # If run from the command-line, install ourselves.
+    from isapi.install import *
+
+    params = ISAPIParameters(PostInstall=PostInstall)
+    # Setup the virtual directories - this is a list of directories our
+    # extension uses - in this case only 1.
+    # Each extension has a "script map" - this is the mapping of ISAPI
+    # extensions.
+    sm = [ScriptMapParams(Extension="*", Flags=0)]
+    vd = VirtualDirParameters(
+        Name="PyISAPITest",
+        Description=Extension.__doc__,
+        ScriptMaps=sm,
+        ScriptMapUpdate="replace",
+        # specify the pre-install hook.
+        PreInstall=PreInstallDirectory,
+    )
+    params.VirtualDirs = [vd]
+    # Setup our custom option parser.
+    from optparse import OptionParser
+
+    parser = OptionParser("")  # blank usage, so isapi sets it.
+    parser.add_option(
+        "",
+        "--description",
+        action="store",
+        help="custom description to use for the virtual directory",
+    )
+
+    HandleCommandLine(
+        params, opt_parser=parser, custom_arg_handlers=custom_arg_handlers
+    )
diff --git a/lib/isapi/simple.py b/lib/isapi/simple.py
new file mode 100644
index 00000000..b453bbae
--- /dev/null
+++ b/lib/isapi/simple.py
@@ -0,0 +1,70 @@
+"""Simple base-classes for extensions and filters.
+
+None of the filter and extension functions are considered 'optional' by the
+framework.  These base-classes provide simple implementations for the
+Initialize and Terminate functions, allowing you to omit them,
+
+It is not necessary to use these base-classes - but if you don't, you
+must ensure each of the required methods are implemented.
+"""
+
+
+class SimpleExtension:
+    "Base class for a simple ISAPI extension"
+
+    def __init__(self):
+        pass
+
+    def GetExtensionVersion(self, vi):
+        """Called by the ISAPI framework to get the extension version
+
+        The default implementation uses the classes docstring to
+        set the extension description."""
+        # nod to our reload capability - vi is None when we are reloaded.
+        if vi is not None:
+            vi.ExtensionDesc = self.__doc__
+
+    def HttpExtensionProc(self, control_block):
+        """Called by the ISAPI framework for each extension request.
+
+        sub-classes must provide an implementation for this method.
+        """
+        raise NotImplementedError("sub-classes should override HttpExtensionProc")
+
+    def TerminateExtension(self, status):
+        """Called by the ISAPI framework as the extension terminates."""
+        pass
+
+
+class SimpleFilter:
+    "Base class for a a simple ISAPI filter"
+    filter_flags = None
+
+    def __init__(self):
+        pass
+
+    def GetFilterVersion(self, fv):
+        """Called by the ISAPI framework to get the extension version
+
+        The default implementation uses the classes docstring to
+        set the extension description, and uses the classes
+        filter_flags attribute to set the ISAPI filter flags - you
+        must specify filter_flags in your class.
+        """
+        if self.filter_flags is None:
+            raise RuntimeError("You must specify the filter flags")
+        # nod to our reload capability - fv is None when we are reloaded.
+        if fv is not None:
+            fv.Flags = self.filter_flags
+            fv.FilterDesc = self.__doc__
+
+    def HttpFilterProc(self, fc):
+        """Called by the ISAPI framework for each filter request.
+
+        sub-classes must provide an implementation for this method.
+        """
+        raise NotImplementedError("sub-classes should override HttpExtensionProc")
+
+    def TerminateFilter(self, status):
+        """Called by the ISAPI framework as the filter terminates."""
+        pass
diff --git a/lib/isapi/test/README.txt b/lib/isapi/test/README.txt
new file mode 100644
index 00000000..18643dd7
--- /dev/null
+++ b/lib/isapi/test/README.txt
@@ -0,0 +1,3 @@
+This is a directory for tests of the PyISAPI framework.
+
+For demos, please see the pyisapi 'samples' directory.
\ No newline at end of file
diff --git a/lib/isapi/test/extension_simple.py b/lib/isapi/test/extension_simple.py
new file mode 100644
index 00000000..64bd71fd
--- /dev/null
+++ b/lib/isapi/test/extension_simple.py
@@ -0,0 +1,119 @@
+# This is an ISAPI extension purely for testing purposes.  It is NOT
+# a 'demo' (even though it may be useful!)
+#
+# Install this extension, then point your browser to:
+# "http://localhost/pyisapi_test/test1"
+# This will execute the method 'test1' below.  See below for the list of
+# test methods that are acceptable.
+
+import urllib.error
+import urllib.parse
+import urllib.request
+
+# If we have no console (eg, am running from inside IIS), redirect output
+# somewhere useful - in this case, the standard win32 trace collector.
+import win32api
+import winerror
+
+from isapi import ExtensionError, isapicon, threaded_extension
+from isapi.simple import SimpleFilter
+
+try:
+    win32api.GetConsoleTitle()
+except win32api.error:
+    # No console - redirect
+    import win32traceutil
+
+
+# The ISAPI extension - handles requests in our virtual dir, and sends the
+# response to the client.
+class Extension(threaded_extension.ThreadPoolExtension):
+    "Python ISAPI Tester"
+
+    def Dispatch(self, ecb):
+        print('Tester dispatching "%s"' % (ecb.GetServerVariable("URL"),))
+        url = ecb.GetServerVariable("URL")
+        test_name = url.split("/")[-1]
+        meth = getattr(self, test_name, None)
+        if meth is None:
+            raise AttributeError("No test named '%s'" % (test_name,))
+        result = meth(ecb)
+        if result is None:
+            # This means the test finalized everything
+            return
+        ecb.SendResponseHeaders("200 OK", "Content-type: text/html\r\n\r\n", False)
+        print("<HTML><BODY>Finished running test <i>", test_name, "</i>", file=ecb)
+        print("<pre>", file=ecb)
+        print(result, file=ecb)
+        print("</pre>", file=ecb)
+        print("</BODY></HTML>", file=ecb)
+        ecb.DoneWithSession()
+
+    def test1(self, ecb):
+        try:
+            ecb.GetServerVariable("foo bar")
+            raise RuntimeError("should have failed!")
+        except ExtensionError as err:
+            assert err.errno == winerror.ERROR_INVALID_INDEX, err
+        return "worked!"
+
+    def test_long_vars(self, ecb):
+        qs = ecb.GetServerVariable("QUERY_STRING")
+        # Our implementation has a default buffer size of 8k - so we test
+        # the code that handles an overflow by ensuring there are more
+        # than 8k worth of chars in the URL.
+        expected_query = "x" * 8500
+        if len(qs) == 0:
+            # Just the URL with no query part - redirect to myself, but with
+            # a huge query portion.
+            me = ecb.GetServerVariable("URL")
+            headers = "Location: " + me + "?" + expected_query + "\r\n\r\n"
+            ecb.SendResponseHeaders("301 Moved", headers)
+            ecb.DoneWithSession()
+            return None
+        if qs == expected_query:
+            return "Total length of variable is %d - test worked!" % (len(qs),)
+        else:
+            return "Unexpected query portion!  Got %d chars, expected %d" % (
+                len(qs),
+                len(expected_query),
+            )
+
+    def test_unicode_vars(self, ecb):
+        # We need to check that we are running IIS6!  This seems the only
+        # effective way from an extension.
+        ver = float(ecb.GetServerVariable("SERVER_SOFTWARE").split("/")[1])
+        if ver < 6.0:
+            return "This is IIS version %g - unicode only works in IIS6 and later" % ver
+
+        us = ecb.GetServerVariable("UNICODE_SERVER_NAME")
+        if not isinstance(us, str):
+            raise RuntimeError("unexpected type!")
+        if us != str(ecb.GetServerVariable("SERVER_NAME")):
+            raise RuntimeError("Unicode and non-unicode values were not the same")
+        return "worked!"
+
+
+# The entry points for the ISAPI extension.
+def __ExtensionFactory__():
+    return Extension()
+
+
+if __name__ == "__main__":
+    # If run from the command-line, install ourselves.
+    from isapi.install import *
+
+    params = ISAPIParameters()
+    # Setup the virtual directories - this is a list of directories our
+    # extension uses - in this case only 1.
+    # Each extension has a "script map" - this is the mapping of ISAPI
+    # extensions.
+    sm = [ScriptMapParams(Extension="*", Flags=0)]
+    vd = VirtualDirParameters(
+        Name="pyisapi_test",
+        Description=Extension.__doc__,
+        ScriptMaps=sm,
+        ScriptMapUpdate="replace",
+    )
+    params.VirtualDirs = [vd]
+    HandleCommandLine(params)
diff --git a/lib/isapi/threaded_extension.py b/lib/isapi/threaded_extension.py
new file mode 100644
index 00000000..b31c8c9e
--- /dev/null
+++ b/lib/isapi/threaded_extension.py
@@ -0,0 +1,189 @@
+"""An ISAPI extension base class implemented using a thread-pool."""
+# $Id$
+
+import sys
+import threading
+import time
+import traceback
+
+from pywintypes import OVERLAPPED
+from win32event import INFINITE
+from win32file import (
+    CloseHandle,
+    CreateIoCompletionPort,
+    GetQueuedCompletionStatus,
+    PostQueuedCompletionStatus,
+)
+from win32security import SetThreadToken
+
+import isapi.simple
+from isapi import ExtensionError, isapicon
+
+ISAPI_REQUEST = 1
+ISAPI_SHUTDOWN = 2
+
+
+class WorkerThread(threading.Thread):
+    def __init__(self, extension, io_req_port):
+        self.running = False
+        self.io_req_port = io_req_port
+        self.extension = extension
+        threading.Thread.__init__(self)
+        # We wait 15 seconds for a thread to terminate, but if it fails to,
+        # we don't want the process to hang at exit waiting for it...
+        self.setDaemon(True)
+
+    def run(self):
+        self.running = True
+        while self.running:
+            errCode, bytes, key, overlapped = GetQueuedCompletionStatus(
+                self.io_req_port, INFINITE
+            )
+            if key == ISAPI_SHUTDOWN and overlapped is None:
+                break
+
+            # Let the parent extension handle the command.
+            dispatcher = self.extension.dispatch_map.get(key)
+            if dispatcher is None:
+                raise RuntimeError("Bad request '%s'" % (key,))
+
+            dispatcher(errCode, bytes, key, overlapped)
+
+    def call_handler(self, cblock):
+        self.extension.Dispatch(cblock)
+
+
+# A generic thread-pool based extension, using IO Completion Ports.
+# Sub-classes can override one method to implement a simple extension, or
+# may leverage the CompletionPort to queue their own requests, and implement a
+# fully asynch extension.
+class ThreadPoolExtension(isapi.simple.SimpleExtension):
+    "Base class for an ISAPI extension based around a thread-pool"
+    max_workers = 20
+    worker_shutdown_wait = 15000  # 15 seconds for workers to quit...
+
+    def __init__(self):
+        self.workers = []
+        # extensible dispatch map, for sub-classes that need to post their
+        # own requests to the completion port.
+        # Each of these functions is called with the result of
+        # GetQueuedCompletionStatus for our port.
+        self.dispatch_map = {
+            ISAPI_REQUEST: self.DispatchConnection,
+        }
+
+    def GetExtensionVersion(self, vi):
+        isapi.simple.SimpleExtension.GetExtensionVersion(self, vi)
+        # As per Q192800, the CompletionPort should be created with the number
+        # of processors, even if the number of worker threads is much larger.
+        # Passing 0 means the system picks the number.
+        self.io_req_port = CreateIoCompletionPort(-1, None, 0, 0)
+        # start up the workers
+        self.workers = []
+        for i in range(self.max_workers):
+            worker = WorkerThread(self, self.io_req_port)
+            worker.start()
+            self.workers.append(worker)
+
+    def HttpExtensionProc(self, control_block):
+        overlapped = OVERLAPPED()
+        overlapped.object = control_block
+        PostQueuedCompletionStatus(self.io_req_port, 0, ISAPI_REQUEST, overlapped)
+        return isapicon.HSE_STATUS_PENDING
+
+    def TerminateExtension(self, status):
+        for worker in self.workers:
+            worker.running = False
+        for worker in self.workers:
+            PostQueuedCompletionStatus(self.io_req_port, 0, ISAPI_SHUTDOWN, None)
+        # wait for them to terminate - pity we aren't using 'native' threads
+        # as then we could do a smart wait - but now we need to poll....
+        end_time = time.time() + self.worker_shutdown_wait / 1000
+        alive = self.workers
+        while alive:
+            if time.time() > end_time:
+                # xxx - might be nice to log something here.
+                break
+            time.sleep(0.2)
+            alive = [w for w in alive if w.is_alive()]
+        self.dispatch_map = {}  # break circles
+        CloseHandle(self.io_req_port)
+
+    # This is the one operation the base class supports - a simple
+    # Connection request.  We setup the thread-token, and dispatch to the
+    # sub-class's 'Dispatch' method.
+    def DispatchConnection(self, errCode, bytes, key, overlapped):
+        control_block = overlapped.object
+        # setup the correct user for this request
+        hRequestToken = control_block.GetImpersonationToken()
+        SetThreadToken(None, hRequestToken)
+        try:
+            try:
+                self.Dispatch(control_block)
+            except:
+                self.HandleDispatchError(control_block)
+        finally:
+            # reset the security context
+            SetThreadToken(None, None)
+
+    def Dispatch(self, ecb):
+        """Overridden by the sub-class to handle connection requests.
+
+        This class creates a thread-pool using a Windows completion port,
+        and dispatches requests via this port.  Sub-classes can generally
+        implement each connection request using blocking reads and writes, and
+        the thread-pool will still provide decent response to the end user.
+
+        The sub-class can set a max_workers attribute (default is 20).  Note
+        that this generally does *not* mean 20 threads will all be concurrently
+        running, via the magic of Windows completion ports.
+
+        There is no default implementation - sub-classes must implement this.
+        """
+        raise NotImplementedError("sub-classes should override Dispatch")
+
+    def HandleDispatchError(self, ecb):
+        """Handles errors in the Dispatch method.
+
+        When a Dispatch method call fails, this method is called to handle
+        the exception.  The default implementation formats the traceback
+        in the browser.
+        """
+        ecb.HttpStatusCode = isapicon.HSE_STATUS_ERROR
+        # control_block.LogData = "we failed!"
+        exc_typ, exc_val, exc_tb = sys.exc_info()
+        limit = None
+        try:
+            try:
+                import cgi
+
+                ecb.SendResponseHeaders(
+                    "200 OK", "Content-type: text/html\r\n\r\n", False
+                )
+                print(file=ecb)
+                print("<H3>Traceback (most recent call last):</H3>", file=ecb)
+                list = traceback.format_tb(
+                    exc_tb, limit
+                ) + traceback.format_exception_only(exc_typ, exc_val)
+                print(
+                    "<PRE>%s<B>%s</B></PRE>"
+                    % (
+                        cgi.escape("".join(list[:-1])),
+                        cgi.escape(list[-1]),
+                    ),
+                    file=ecb,
+                )
+            except ExtensionError:
+                # The client disconnected without reading the error body -
+                # its probably not a real browser at the other end, ignore it.
+                pass
+            except:
+                print("FAILED to render the error message!")
+                traceback.print_exc()
+                print("ORIGINAL extension error:")
+                traceback.print_exception(exc_typ, exc_val, exc_tb)
+        finally:
+            # holding tracebacks in a local of a frame that may itself be
+            # part of a traceback used to be evil and cause leaks!
+            exc_tb = None
+            ecb.DoneWithSession()
diff --git a/lib/jaraco/collections.py b/lib/jaraco/collections/__init__.py
similarity index 88%
rename from lib/jaraco/collections.py
rename to lib/jaraco/collections/__init__.py
index db89b122..abedf002 100644
--- a/lib/jaraco/collections.py
+++ b/lib/jaraco/collections/__init__.py
@@ -5,23 +5,49 @@ import itertools
 import copy
 import functools
 import random
+from collections.abc import Container, Iterable, Mapping
+from typing import Callable, Union
 
-from jaraco.classes.properties import NonDataProperty
 import jaraco.text
 
 
+_Matchable = Union[Callable, Container, Iterable, re.Pattern]
+
+
+def _dispatch(obj: _Matchable) -> Callable:
+    # can't rely on singledispatch for Union[Container, Iterable]
+    # due to ambiguity
+    # (https://peps.python.org/pep-0443/#abstract-base-classes).
+    if isinstance(obj, re.Pattern):
+        return obj.fullmatch
+    if not isinstance(obj, Callable):  # type: ignore
+        if not isinstance(obj, Container):
+            obj = set(obj)  # type: ignore
+        obj = obj.__contains__
+    return obj  # type: ignore
+
+
 class Projection(collections.abc.Mapping):
     """
     Project a set of keys over a mapping
 
     >>> sample = {'a': 1, 'b': 2, 'c': 3}
     >>> prj = Projection(['a', 'c', 'd'], sample)
-    >>> prj == {'a': 1, 'c': 3}
+    >>> dict(prj)
+    {'a': 1, 'c': 3}
+
+    Projection also accepts an iterable or callable or pattern.
+
+    >>> iter_prj = Projection(iter('acd'), sample)
+    >>> call_prj = Projection(lambda k: ord(k) in (97, 99, 100), sample)
+    >>> pat_prj = Projection(re.compile(r'[acd]'), sample)
+    >>> prj == iter_prj == call_prj == pat_prj
     True
 
     Keys should only appear if they were specified and exist in the space.
+    Order is retained.
 
-    >>> sorted(list(prj.keys()))
+    >>> list(prj)
     ['a', 'c']
 
     Attempting to access a key not in the projection
@@ -36,119 +62,58 @@ class Projection(collections.abc.Mapping):
 
     >>> target = {'a': 2, 'b': 2}
     >>> target.update(prj)
-    >>> target == {'a': 1, 'b': 2, 'c': 3}
-    True
+    >>> target
+    {'a': 1, 'b': 2, 'c': 3}
 
-    Also note that Projection keeps a reference to the original dict, so
-    if you modify the original dict, that could modify the Projection.
+    Projection keeps a reference to the original dict, so
+    modifying the original dict may modify the Projection.
 
     >>> del sample['a']
     >>> dict(prj)
     {'c': 3}
     """
 
-    def __init__(self, keys, space):
-        self._keys = tuple(keys)
+    def __init__(self, keys: _Matchable, space: Mapping):
+        self._match = _dispatch(keys)
         self._space = space
 
     def __getitem__(self, key):
-        if key not in self._keys:
+        if not self._match(key):
             raise KeyError(key)
         return self._space[key]
 
+    def _keys_resolved(self):
+        return filter(self._match, self._space)
+
     def __iter__(self):
-        return iter(set(self._keys).intersection(self._space))
+        return self._keys_resolved()
 
     def __len__(self):
-        return len(tuple(iter(self)))
+        return len(tuple(self._keys_resolved()))
 
 
-class DictFilter(collections.abc.Mapping):
+class Mask(Projection):
     """
-    Takes a dict, and simulates a sub-dict based on the keys.
+    The inverse of a :class:`Projection`, masking out keys.
 
     >>> sample = {'a': 1, 'b': 2, 'c': 3}
-    >>> filtered = DictFilter(sample, ['a', 'c'])
-    >>> filtered == {'a': 1, 'c': 3}
-    True
-    >>> set(filtered.values()) == {1, 3}
-    True
-    >>> set(filtered.items()) == {('a', 1), ('c', 3)}
-    True
-
-    One can also filter by a regular expression pattern
-
-    >>> sample['d'] = 4
-    >>> sample['ef'] = 5
-
-    Here we filter for only single-character keys
-
-    >>> filtered = DictFilter(sample, include_pattern='.$')
-    >>> filtered == {'a': 1, 'b': 2, 'c': 3, 'd': 4}
-    True
-
-    >>> filtered['e']
-    Traceback (most recent call last):
-    ...
-    KeyError: 'e'
-
-    >>> 'e' in filtered
-    False
-
-    Pattern is useful for excluding keys with a prefix.
-
-    >>> filtered = DictFilter(sample, include_pattern=r'(?![ace])')
-    >>> dict(filtered)
-    {'b': 2, 'd': 4}
-
-    Also note that DictFilter keeps a reference to the original dict, so
-    if you modify the original dict, that could modify the filtered dict.
-
-    >>> del sample['d']
-    >>> dict(filtered)
+    >>> msk = Mask(['a', 'c', 'd'], sample)
+    >>> dict(msk)
     {'b': 2}
     """
 
-    def __init__(self, dict, include_keys=[], include_pattern=None):
-        self.dict = dict
-        self.specified_keys = set(include_keys)
-        if include_pattern is not None:
-            self.include_pattern = re.compile(include_pattern)
-        else:
-            # for performance, replace the pattern_keys property
-            self.pattern_keys = set()
-
-    def get_pattern_keys(self):
-        keys = filter(self.include_pattern.match, self.dict.keys())
-        return set(keys)
-
-    pattern_keys = NonDataProperty(get_pattern_keys)
-
-    @property
-    def include_keys(self):
-        return self.specified_keys | self.pattern_keys
-
-    def __getitem__(self, i):
-        if i not in self.include_keys:
-            raise KeyError(i)
-        return self.dict[i]
-
-    def __iter__(self):
-        return filter(self.include_keys.__contains__, self.dict.keys())
-
-    def __len__(self):
-        return len(list(self))
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        # self._match = compose(operator.not_, self._match)
+        self._match = lambda key, orig=self._match: not orig(key)
 
 
 def dict_map(function, dictionary):
     """
-    dict_map is much like the built-in function map.  It takes a dictionary
-    and applys a function to the values of that dictionary, returning a
-    new dictionary with the mapped values in the original keys.
+    Return a new dict with function applied to values of dictionary.
 
-    >>> d = dict_map(lambda x:x+1, dict(a=1, b=2))
-    >>> d == dict(a=2,b=3)
-    True
+    >>> dict_map(lambda x: x+1, dict(a=1, b=2))
+    {'a': 2, 'b': 3}
     """
     return dict((key, function(value)) for key, value in dictionary.items())
 
@@ -164,7 +129,7 @@ class RangeMap(dict):
     One may supply keyword parameters to be passed to the sort function used
     to sort keys (i.e. key, reverse) as sort_params.
 
-    Let's create a map that maps 1-3 -> 'a', 4-6 -> 'b'
+    Create a map that maps 1-3 -> 'a', 4-6 -> 'b'
 
     >>> r = RangeMap({3: 'a', 6: 'b'})  # boy, that was easy
     >>> r[1], r[2], r[3], r[4], r[5], r[6]
@@ -176,7 +141,7 @@ class RangeMap(dict):
     >>> r[4.5]
     'b'
 
-    But you'll notice that the way rangemap is defined, it must be open-ended
+    Notice that the way rangemap is defined, it must be open-ended
     on one side.
 
     >>> r[0]
@@ -279,7 +244,7 @@ class RangeMap(dict):
         return (sorted_keys[RangeMap.first_item], sorted_keys[RangeMap.last_item])
 
     # some special values for the RangeMap
-    undefined_value = type(str('RangeValueUndefined'), (), {})()
+    undefined_value = type('RangeValueUndefined', (), {})()
 
     class Item(int):
         "RangeMap Item"
@@ -294,7 +259,7 @@ def __identity(x):
 
 def sorted_items(d, key=__identity, reverse=False):
     """
-    Return the items of the dictionary sorted by the keys
+    Return the items of the dictionary sorted by the keys.
 
     >>> sample = dict(foo=20, bar=42, baz=10)
     >>> tuple(sorted_items(sample))
@@ -307,6 +272,7 @@ def sorted_items(d, key=__identity, reverse=False):
     >>> tuple(sorted_items(sample, reverse=True))
     (('foo', 20), ('baz', 10), ('bar', 42))
     """
+
     # wrap the key func so it operates on the first element of each item
     def pairkey_key(item):
         return key(item[0])
@@ -475,7 +441,7 @@ class ItemsAsAttributes:
     Mix-in class to enable a mapping object to provide items as
     attributes.
 
-    >>> C = type(str('C'), (dict, ItemsAsAttributes), dict())
+    >>> C = type('C', (dict, ItemsAsAttributes), dict())
     >>> i = C()
     >>> i['foo'] = 'bar'
     >>> i.foo
@@ -504,7 +470,7 @@ class ItemsAsAttributes:
 
     >>> missing_func = lambda self, key: 'missing item'
     >>> C = type(
-    ...     str('C'),
+    ...     'C',
     ...     (dict, ItemsAsAttributes),
     ...     dict(__missing__ = missing_func),
     ... )
diff --git a/lib/jaraco/collections/py.typed b/lib/jaraco/collections/py.typed
new file mode 100644
index 00000000..e69de29b
diff --git a/lib/jaraco/context.py b/lib/jaraco/context.py
index 87a4e3dc..b0d1ef37 100644
--- a/lib/jaraco/context.py
+++ b/lib/jaraco/context.py
@@ -5,10 +5,18 @@ import functools
 import tempfile
 import shutil
 import operator
+import warnings
 
 
 @contextlib.contextmanager
 def pushd(dir):
+    """
+    >>> tmp_path = getfixture('tmp_path')
+    >>> with pushd(tmp_path):
+    ...     assert os.getcwd() == os.fspath(tmp_path)
+    >>> assert os.getcwd() != os.fspath(tmp_path)
+    """
+
     orig = os.getcwd()
     os.chdir(dir)
     try:
@@ -29,6 +37,8 @@ def tarball_context(url, target_dir=None, runner=None, pushd=pushd):
         target_dir = os.path.basename(url).replace('.tar.gz', '').replace('.tgz', '')
     if runner is None:
         runner = functools.partial(subprocess.check_call, shell=True)
+    else:
+        warnings.warn("runner parameter is deprecated", DeprecationWarning)
     # In the tar command, use --strip-components=1 to strip the first path and
     #  then
     #  use -C to cause the files to be extracted to {target_dir}. This ensures
@@ -48,6 +58,15 @@ def tarball_context(url, target_dir=None, runner=None, pushd=pushd):
 def infer_compression(url):
     """
     Given a URL or filename, infer the compression code for tar.
+
+    >>> infer_compression('http://foo/bar.tar.gz')
+    'z'
+    >>> infer_compression('http://foo/bar.tgz')
+    'z'
+    >>> infer_compression('file.bz')
+    'j'
+    >>> infer_compression('file.xz')
+    'J'
     """
     # cheat and just assume it's the last two characters
     compression_indicator = url[-2:]
@@ -61,6 +80,12 @@ def temp_dir(remover=shutil.rmtree):
     """
     Create a temporary directory context. Pass a custom remover
     to override the removal behavior.
+
+    >>> import pathlib
+    >>> with temp_dir() as the_dir:
+    ...     assert os.path.isdir(the_dir)
+    ...     _ = pathlib.Path(the_dir).joinpath('somefile').write_text('contents')
+    >>> assert not os.path.exists(the_dir)
     """
     temp_dir = tempfile.mkdtemp()
     try:
@@ -90,6 +115,12 @@ def repo_context(url, branch=None, quiet=True, dest_ctx=temp_dir):
 
 @contextlib.contextmanager
 def null():
+    """
+    A null context suitable to stand in for a meaningful context.
+
+    >>> with null() as value:
+    ...     assert value is None
+    """
     yield
 
 
@@ -112,6 +143,10 @@ class ExceptionTrap:
     ...     raise ValueError("1 + 1 is not 3")
     >>> bool(trap)
     True
+    >>> trap.value
+    ValueError('1 + 1 is not 3')
+    >>> trap.tb
+    <traceback object at ...>
 
     >>> with ExceptionTrap(ValueError) as trap:
     ...     raise Exception()
@@ -211,3 +246,43 @@ class suppress(contextlib.suppress, contextlib.ContextDecorator):
     ...     {}['']
     >>> key_error()
     """
+
+
+class on_interrupt(contextlib.ContextDecorator):
+    """
+    Replace a KeyboardInterrupt with SystemExit(1)
+
+    >>> def do_interrupt():
+    ...     raise KeyboardInterrupt()
+    >>> on_interrupt('error')(do_interrupt)()
+    Traceback (most recent call last):
+    ...
+    SystemExit: 1
+    >>> on_interrupt('error', code=255)(do_interrupt)()
+    Traceback (most recent call last):
+    ...
+    SystemExit: 255
+    >>> on_interrupt('suppress')(do_interrupt)()
+    >>> with __import__('pytest').raises(KeyboardInterrupt):
+    ...     on_interrupt('ignore')(do_interrupt)()
+    """
+
+    def __init__(
+        self,
+        action='error',
+        # py3.7 compat
+        # /,
+        code=1,
+    ):
+        self.action = action
+        self.code = code
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, exctype, excinst, exctb):
+        if exctype is not KeyboardInterrupt or self.action == 'ignore':
+            return
+        elif self.action == 'error':
+            raise SystemExit(self.code) from excinst
+        return self.action == 'suppress'
diff --git a/lib/jaraco/functools.py b/lib/jaraco/functools/__init__.py
similarity index 84%
rename from lib/jaraco/functools.py
rename to lib/jaraco/functools/__init__.py
index 43c009f9..ca6c22fa 100644
--- a/lib/jaraco/functools.py
+++ b/lib/jaraco/functools/__init__.py
@@ -1,4 +1,4 @@
-import collections
+import collections.abc
 import functools
 import inspect
 import itertools
@@ -9,11 +9,6 @@ import warnings
 
 import more_itertools
 
-from typing import Callable, TypeVar
-
-
-CallableT = TypeVar("CallableT", bound=Callable[..., object])
-
 
 def compose(*funcs):
     """
@@ -39,24 +34,6 @@ def compose(*funcs):
     return functools.reduce(compose_two, funcs)
 
 
-def method_caller(method_name, *args, **kwargs):
-    """
-    Return a function that will call a named method on the
-    target object with optional positional and keyword
-    arguments.
-
-    >>> lower = method_caller('lower')
-    >>> lower('MyString')
-    'mystring'
-    """
-
-    def call_method(target):
-        func = getattr(target, method_name)
-        return func(*args, **kwargs)
-
-    return call_method
-
-
 def once(func):
     """
     Decorate func so it's only ever called the first time.
@@ -99,12 +76,7 @@ def once(func):
     return wrapper
 
 
-def method_cache(
-    method: CallableT,
-    cache_wrapper: Callable[
-        [CallableT], CallableT
-    ] = functools.lru_cache(),  # type: ignore[assignment]
-) -> CallableT:
+def method_cache(method, cache_wrapper=functools.lru_cache()):
     """
     Wrap lru_cache to support storing the cache data in the object instances.
 
@@ -172,22 +144,17 @@ def method_cache(
     for another implementation and additional justification.
     """
 
-    def wrapper(self: object, *args: object, **kwargs: object) -> object:
+    def wrapper(self, *args, **kwargs):
         # it's the first call, replace the method with a cached, bound method
-        bound_method: CallableT = types.MethodType(  # type: ignore[assignment]
-            method, self
-        )
+        bound_method = types.MethodType(method, self)
         cached_method = cache_wrapper(bound_method)
         setattr(self, method.__name__, cached_method)
         return cached_method(*args, **kwargs)
 
     # Support cache clear even before cache has been created.
-    wrapper.cache_clear = lambda: None  # type: ignore[attr-defined]
+    wrapper.cache_clear = lambda: None
 
-    return (
-        _special_method_cache(method, cache_wrapper)  # type: ignore[return-value]
-        or wrapper
-    )
+    return _special_method_cache(method, cache_wrapper) or wrapper
 
 
 def _special_method_cache(method, cache_wrapper):
@@ -203,12 +170,13 @@ def _special_method_cache(method, cache_wrapper):
     """
     name = method.__name__
     special_names = '__getattr__', '__getitem__'
+
     if name not in special_names:
-        return
+        return None
 
     wrapper_name = '__cached' + name
 
-    def proxy(self, *args, **kwargs):
+    def proxy(self, /, *args, **kwargs):
         if wrapper_name not in vars(self):
             bound = types.MethodType(method, self)
             cache = cache_wrapper(bound)
@@ -245,7 +213,7 @@ def result_invoke(action):
     r"""
     Decorate a function with an action function that is
     invoked on the results returned from the decorated
-    function (for its side-effect), then return the original
+    function (for its side effect), then return the original
     result.
 
     >>> @result_invoke(print)
@@ -269,7 +237,7 @@ def result_invoke(action):
     return wrap
 
 
-def invoke(f, *args, **kwargs):
+def invoke(f, /, *args, **kwargs):
     """
     Call a function for its side effect after initialization.
 
@@ -304,25 +272,15 @@ def invoke(f, *args, **kwargs):
     Use functools.partial to pass parameters to the initial call
 
     >>> @functools.partial(invoke, name='bingo')
-    ... def func(name): print("called with", name)
+    ... def func(name): print('called with', name)
     called with bingo
     """
     f(*args, **kwargs)
     return f
 
 
-def call_aside(*args, **kwargs):
-    """
-    Deprecated name for invoke.
-    """
-    warnings.warn("call_aside is deprecated, use invoke", DeprecationWarning)
-    return invoke(*args, **kwargs)
-
-
 class Throttler:
-    """
-    Rate-limit a function (or other callable)
-    """
+    """Rate-limit a function (or other callable)."""
 
     def __init__(self, func, max_rate=float('Inf')):
         if isinstance(func, Throttler):
@@ -339,20 +297,20 @@ class Throttler:
         return self.func(*args, **kwargs)
 
     def _wait(self):
-        "ensure at least 1/max_rate seconds from last call"
+        """Ensure at least 1/max_rate seconds from last call."""
         elapsed = time.time() - self.last_called
         must_wait = 1 / self.max_rate - elapsed
         time.sleep(max(0, must_wait))
         self.last_called = time.time()
 
-    def __get__(self, obj, type=None):
+    def __get__(self, obj, owner=None):
         return first_invoke(self._wait, functools.partial(self.func, obj))
 
 
 def first_invoke(func1, func2):
     """
     Return a function that when invoked will invoke func1 without
-    any parameters (for its side-effect) and then invoke func2
+    any parameters (for its side effect) and then invoke func2
     with whatever parameters were passed, returning its result.
     """
 
@@ -363,6 +321,17 @@ def first_invoke(func1, func2):
     return wrapper
 
 
+method_caller = first_invoke(
+    lambda: warnings.warn(
+        '`jaraco.functools.method_caller` is deprecated, '
+        'use `operator.methodcaller` instead',
+        DeprecationWarning,
+        stacklevel=3,
+    ),
+    operator.methodcaller,
+)
+
+
 def retry_call(func, cleanup=lambda: None, retries=0, trap=()):
     """
     Given a callable func, trap the indicated exceptions
@@ -371,7 +340,7 @@ def retry_call(func, cleanup=lambda: None, retries=0, trap=()):
     to propagate.
     """
     attempts = itertools.count() if retries == float('inf') else range(retries)
-    for attempt in attempts:
+    for _ in attempts:
         try:
             return func()
         except trap:
@@ -408,7 +377,7 @@ def retry(*r_args, **r_kwargs):
 
 def print_yielded(func):
     """
-    Convert a generator into a function that prints all yielded elements
+    Convert a generator into a function that prints all yielded elements.
 
     >>> @print_yielded
     ... def x():
@@ -424,7 +393,7 @@ def print_yielded(func):
 
 def pass_none(func):
     """
-    Wrap func so it's not called if its first param is None
+    Wrap func so it's not called if its first param is None.
 
     >>> print_text = pass_none(print)
     >>> print_text('text')
@@ -433,9 +402,10 @@ def pass_none(func):
     """
 
     @functools.wraps(func)
-    def wrapper(param, *args, **kwargs):
+    def wrapper(param, /, *args, **kwargs):
         if param is not None:
             return func(param, *args, **kwargs)
+        return None
 
     return wrapper
 
@@ -509,7 +479,7 @@ def save_method_args(method):
     args_and_kwargs = collections.namedtuple('args_and_kwargs', 'args kwargs')
 
     @functools.wraps(method)
-    def wrapper(self, *args, **kwargs):
+    def wrapper(self, /, *args, **kwargs):
         attr_name = '_saved_' + method.__name__
         attr = args_and_kwargs(args, kwargs)
         setattr(self, attr_name, attr)
@@ -559,6 +529,13 @@ def except_(*exceptions, replace=None, use=None):
 
 
 def identity(x):
+    """
+    Return the argument.
+
+    >>> o = object()
+    >>> identity(o) is o
+    True
+    """
     return x
 
 
@@ -580,7 +557,7 @@ def bypass_when(check, *, _op=identity):
 
     def decorate(func):
         @functools.wraps(func)
-        def wrapper(param):
+        def wrapper(param, /):
             return param if _op(check) else func(param)
 
         return wrapper
@@ -604,3 +581,53 @@ def bypass_unless(check):
     2
     """
     return bypass_when(check, _op=operator.not_)
+
+
+@functools.singledispatch
+def _splat_inner(args, func):
+    """Splat args to func."""
+    return func(*args)
+
+
+@_splat_inner.register
+def _(args: collections.abc.Mapping, func):
+    """Splat kargs to func as kwargs."""
+    return func(**args)
+
+
+def splat(func):
+    """
+    Wrap func to expect its parameters to be passed positionally in a tuple.
+
+    Has a similar effect to that of ``itertools.starmap`` over
+    simple ``map``.
+
+    >>> pairs = [(-1, 1), (0, 2)]
+    >>> more_itertools.consume(itertools.starmap(print, pairs))
+    -1 1
+    0 2
+    >>> more_itertools.consume(map(splat(print), pairs))
+    -1 1
+    0 2
+
+    The approach generalizes to other iterators that don't have a "star"
+    equivalent, such as a "starfilter".
+
+    >>> list(filter(splat(operator.add), pairs))
+    [(0, 2)]
+
+    Splat also accepts a mapping argument.
+
+    >>> def is_nice(msg, code):
+    ...     return "smile" in msg or code == 0
+    >>> msgs = [
+    ...     dict(msg='smile!', code=20),
+    ...     dict(msg='error :(', code=1),
+    ...     dict(msg='unknown', code=0),
+    ... ]
+    >>> for msg in filter(splat(is_nice), msgs):
+    ...     print(msg)
+    {'msg': 'smile!', 'code': 20}
+    {'msg': 'unknown', 'code': 0}
+    """
+    return functools.wraps(func)(functools.partial(_splat_inner, func=func))
diff --git a/lib/jaraco/functools/__init__.pyi b/lib/jaraco/functools/__init__.pyi
new file mode 100644
index 00000000..c2b9ab17
--- /dev/null
+++ b/lib/jaraco/functools/__init__.pyi
@@ -0,0 +1,128 @@
+from collections.abc import Callable, Hashable, Iterator
+from functools import partial
+from operator import methodcaller
+import sys
+from typing import (
+    Any,
+    Generic,
+    Protocol,
+    TypeVar,
+    overload,
+)
+
+if sys.version_info >= (3, 10):
+    from typing import Concatenate, ParamSpec
+else:
+    from typing_extensions import Concatenate, ParamSpec
+
+_P = ParamSpec('_P')
+_R = TypeVar('_R')
+_T = TypeVar('_T')
+_R1 = TypeVar('_R1')
+_R2 = TypeVar('_R2')
+_V = TypeVar('_V')
+_S = TypeVar('_S')
+_R_co = TypeVar('_R_co', covariant=True)
+
+class _OnceCallable(Protocol[_P, _R]):
+    saved_result: _R
+    reset: Callable[[], None]
+    def __call__(self, *args: _P.args, **kwargs: _P.kwargs) -> _R: ...
+
+class _ProxyMethodCacheWrapper(Protocol[_R_co]):
+    cache_clear: Callable[[], None]
+    def __call__(self, *args: Hashable, **kwargs: Hashable) -> _R_co: ...
+
+class _MethodCacheWrapper(Protocol[_R_co]):
+    def cache_clear(self) -> None: ...
+    def __call__(self, *args: Hashable, **kwargs: Hashable) -> _R_co: ...
+
+# `compose()` overloads below will cover most use cases.
+
+@overload
+def compose(
+    __func1: Callable[[_R], _T],
+    __func2: Callable[_P, _R],
+    /,
+) -> Callable[_P, _T]: ...
+@overload
+def compose(
+    __func1: Callable[[_R], _T],
+    __func2: Callable[[_R1], _R],
+    __func3: Callable[_P, _R1],
+    /,
+) -> Callable[_P, _T]: ...
+@overload
+def compose(
+    __func1: Callable[[_R], _T],
+    __func2: Callable[[_R2], _R],
+    __func3: Callable[[_R1], _R2],
+    __func4: Callable[_P, _R1],
+    /,
+) -> Callable[_P, _T]: ...
+def once(func: Callable[_P, _R]) -> _OnceCallable[_P, _R]: ...
+def method_cache(
+    method: Callable[..., _R],
+    cache_wrapper: Callable[[Callable[..., _R]], _MethodCacheWrapper[_R]] = ...,
+) -> _MethodCacheWrapper[_R] | _ProxyMethodCacheWrapper[_R]: ...
+def apply(
+    transform: Callable[[_R], _T]
+) -> Callable[[Callable[_P, _R]], Callable[_P, _T]]: ...
+def result_invoke(
+    action: Callable[[_R], Any]
+) -> Callable[[Callable[_P, _R]], Callable[_P, _R]]: ...
+def invoke(
+    f: Callable[_P, _R], /, *args: _P.args, **kwargs: _P.kwargs
+) -> Callable[_P, _R]: ...
+def call_aside(
+    f: Callable[_P, _R], *args: _P.args, **kwargs: _P.kwargs
+) -> Callable[_P, _R]: ...
+
+class Throttler(Generic[_R]):
+    last_called: float
+    func: Callable[..., _R]
+    max_rate: float
+    def __init__(
+        self, func: Callable[..., _R] | Throttler[_R], max_rate: float = ...
+    ) -> None: ...
+    def reset(self) -> None: ...
+    def __call__(self, *args: Any, **kwargs: Any) -> _R: ...
+    def __get__(self, obj: Any, owner: type[Any] | None = ...) -> Callable[..., _R]: ...
+
+def first_invoke(
+    func1: Callable[..., Any], func2: Callable[_P, _R]
+) -> Callable[_P, _R]: ...
+
+method_caller: Callable[..., methodcaller]
+
+def retry_call(
+    func: Callable[..., _R],
+    cleanup: Callable[..., None] = ...,
+    retries: int | float = ...,
+    trap: type[BaseException] | tuple[type[BaseException], ...] = ...,
+) -> _R: ...
+def retry(
+    cleanup: Callable[..., None] = ...,
+    retries: int | float = ...,
+    trap: type[BaseException] | tuple[type[BaseException], ...] = ...,
+) -> Callable[[Callable[..., _R]], Callable[..., _R]]: ...
+def print_yielded(func: Callable[_P, Iterator[Any]]) -> Callable[_P, None]: ...
+def pass_none(
+    func: Callable[Concatenate[_T, _P], _R]
+) -> Callable[Concatenate[_T, _P], _R]: ...
+def assign_params(
+    func: Callable[..., _R], namespace: dict[str, Any]
+) -> partial[_R]: ...
+def save_method_args(
+    method: Callable[Concatenate[_S, _P], _R]
+) -> Callable[Concatenate[_S, _P], _R]: ...
+def except_(
+    *exceptions: type[BaseException], replace: Any = ..., use: Any = ...
+) -> Callable[[Callable[_P, Any]], Callable[_P, Any]]: ...
+def identity(x: _T) -> _T: ...
+def bypass_when(
+    check: _V, *, _op: Callable[[_V], Any] = ...
+) -> Callable[[Callable[[_T], _R]], Callable[[_T], _T | _R]]: ...
+def bypass_unless(
+    check: Any,
+) -> Callable[[Callable[[_T], _R]], Callable[[_T], _T | _R]]: ...
diff --git a/lib/jaraco/functools/py.typed b/lib/jaraco/functools/py.typed
new file mode 100644
index 00000000..e69de29b
diff --git a/lib/jaraco/text/__init__.py b/lib/jaraco/text/__init__.py
index e51101c2..0fabd0c3 100644
--- a/lib/jaraco/text/__init__.py
+++ b/lib/jaraco/text/__init__.py
@@ -227,10 +227,12 @@ def unwrap(s):
     return '\n'.join(cleaned)
 
 
-lorem_ipsum: str = files(__name__).joinpath('Lorem ipsum.txt').read_text()
+lorem_ipsum: str = (
+    files(__name__).joinpath('Lorem ipsum.txt').read_text(encoding='utf-8')
+)
 
 
-class Splitter(object):
+class Splitter:
     """object that will split a string with the given arguments for each call
 
     >>> s = Splitter(',')
@@ -367,7 +369,7 @@ class WordSet(tuple):
         return self.trim_left(item).trim_right(item)
 
     def __getitem__(self, item):
-        result = super(WordSet, self).__getitem__(item)
+        result = super().__getitem__(item)
         if isinstance(item, slice):
             result = WordSet(result)
         return result
@@ -582,7 +584,7 @@ def join_continuation(lines):
     ['foobarbaz']
 
     Not sure why, but...
-    The character preceeding the backslash is also elided.
+    The character preceding the backslash is also elided.
 
     >>> list(join_continuation(['goo\\', 'dly']))
     ['godly']
@@ -607,16 +609,16 @@ def read_newlines(filename, limit=1024):
     r"""
     >>> tmp_path = getfixture('tmp_path')
     >>> filename = tmp_path / 'out.txt'
-    >>> _ = filename.write_text('foo\n', newline='')
+    >>> _ = filename.write_text('foo\n', newline='', encoding='utf-8')
     >>> read_newlines(filename)
     '\n'
-    >>> _ = filename.write_text('foo\r\n', newline='')
+    >>> _ = filename.write_text('foo\r\n', newline='', encoding='utf-8')
     >>> read_newlines(filename)
     '\r\n'
-    >>> _ = filename.write_text('foo\r\nbar\nbing\r', newline='')
+    >>> _ = filename.write_text('foo\r\nbar\nbing\r', newline='', encoding='utf-8')
     >>> read_newlines(filename)
     ('\r', '\n', '\r\n')
     """
-    with open(filename) as fp:
+    with open(filename, encoding='utf-8') as fp:
         fp.read(limit)
     return fp.newlines
diff --git a/lib/jaraco/text/show-newlines.py b/lib/jaraco/text/show-newlines.py
index 2ba32062..e11d1ba4 100644
--- a/lib/jaraco/text/show-newlines.py
+++ b/lib/jaraco/text/show-newlines.py
@@ -12,11 +12,11 @@ def report_newlines(filename):
 
     >>> tmp_path = getfixture('tmp_path')
     >>> filename = tmp_path / 'out.txt'
-    >>> _ = filename.write_text('foo\nbar\n', newline='')
+    >>> _ = filename.write_text('foo\nbar\n', newline='', encoding='utf-8')
     >>> report_newlines(filename)
     newline is '\n'
     >>> filename = tmp_path / 'out.txt'
-    >>> _ = filename.write_text('foo\nbar\r\n', newline='')
+    >>> _ = filename.write_text('foo\nbar\r\n', newline='', encoding='utf-8')
     >>> report_newlines(filename)
     newlines are ('\n', '\r\n')
     """
diff --git a/lib/jaraco/text/strip-prefix.py b/lib/jaraco/text/strip-prefix.py
new file mode 100644
index 00000000..761717a9
--- /dev/null
+++ b/lib/jaraco/text/strip-prefix.py
@@ -0,0 +1,21 @@
+import sys
+
+import autocommand
+
+from jaraco.text import Stripper
+
+
+def strip_prefix():
+    r"""
+    Strip any common prefix from stdin.
+
+    >>> import io, pytest
+    >>> getfixture('monkeypatch').setattr('sys.stdin', io.StringIO('abcdef\nabc123'))
+    >>> strip_prefix()
+    def
+    123
+    """
+    sys.stdout.writelines(Stripper.strip_prefix(sys.stdin).lines)
+
+
+autocommand.autocommand(__name__)(strip_prefix)
diff --git a/lib/more_itertools/__init__.py b/lib/more_itertools/__init__.py
index 28ffadcf..aff94a9a 100644
--- a/lib/more_itertools/__init__.py
+++ b/lib/more_itertools/__init__.py
@@ -3,4 +3,4 @@
 from .more import *  # noqa
 from .recipes import *  # noqa
 
-__version__ = '10.1.0'
+__version__ = '10.2.0'
diff --git a/lib/more_itertools/more.py b/lib/more_itertools/more.py
index 59c2f1a4..dd711a47 100755
--- a/lib/more_itertools/more.py
+++ b/lib/more_itertools/more.py
@@ -19,7 +19,7 @@ from itertools import (
     zip_longest,
     product,
 )
-from math import exp, factorial, floor, log
+from math import exp, factorial, floor, log, perm, comb
 from queue import Empty, Queue
 from random import random, randrange, uniform
 from operator import itemgetter, mul, sub, gt, lt, ge, le
@@ -68,8 +68,10 @@ __all__ = [
     'divide',
     'duplicates_everseen',
     'duplicates_justseen',
+    'classify_unique',
     'exactly_n',
     'filter_except',
+    'filter_map',
     'first',
     'gray_product',
     'groupby_transform',
@@ -83,6 +85,7 @@ __all__ = [
     'is_sorted',
     'islice_extended',
     'iterate',
+    'iter_suppress',
     'last',
     'locate',
     'longest_common_prefix',
@@ -198,15 +201,14 @@ def first(iterable, default=_marker):
     ``next(iter(iterable), default)``.
 
     """
-    try:
-        return next(iter(iterable))
-    except StopIteration as e:
-        if default is _marker:
-            raise ValueError(
-                'first() was called on an empty iterable, and no '
-                'default value was provided.'
-            ) from e
-        return default
+    for item in iterable:
+        return item
+    if default is _marker:
+        raise ValueError(
+            'first() was called on an empty iterable, and no '
+            'default value was provided.'
+        )
+    return default
 
 
 def last(iterable, default=_marker):
@@ -582,6 +584,9 @@ def strictly_n(iterable, n, too_short=None, too_long=None):
         >>> list(strictly_n(iterable, n))
         ['a', 'b', 'c', 'd']
 
+    Note that the returned iterable must be consumed in order for the check to
+    be made.
+
     By default, *too_short* and *too_long* are functions that raise
     ``ValueError``.
 
@@ -919,7 +924,7 @@ def substrings_indexes(seq, reverse=False):
 
 
 class bucket:
-    """Wrap *iterable* and return an object that buckets it iterable into
+    """Wrap *iterable* and return an object that buckets the iterable into
     child iterables based on a *key* function.
 
         >>> iterable = ['a1', 'b1', 'c1', 'a2', 'b2', 'c2', 'b3']
@@ -3222,6 +3227,8 @@ class time_limited:
     stops if  the time elapsed is greater than *limit_seconds*. If your time
     limit is 1 second, but it takes 2 seconds to generate the first item from
     the iterable, the function will run for 2 seconds and not yield anything.
+    As a special case, when *limit_seconds* is zero, the iterator never
+    returns anything.
 
     """
 
@@ -3237,6 +3244,9 @@ class time_limited:
         return self
 
     def __next__(self):
+        if self.limit_seconds == 0:
+            self.timed_out = True
+            raise StopIteration
         item = next(self._iterable)
         if monotonic() - self._start_time > self.limit_seconds:
             self.timed_out = True
@@ -3356,7 +3366,7 @@ def iequals(*iterables):
     >>> iequals("abc", "acb")
     False
 
-    Not to be confused with :func:`all_equals`, which checks whether all
+    Not to be confused with :func:`all_equal`, which checks whether all
     elements of iterable are equal to each other.
 
     """
@@ -3853,7 +3863,7 @@ def nth_permutation(iterable, r, index):
     elif not 0 <= r < n:
         raise ValueError
     else:
-        c = factorial(n) // factorial(n - r)
+        c = perm(n, r)
 
     if index < 0:
         index += c
@@ -3898,7 +3908,7 @@ def nth_combination_with_replacement(iterable, r, index):
     if (r < 0) or (r > n):
         raise ValueError
 
-    c = factorial(n + r - 1) // (factorial(r) * factorial(n - 1))
+    c = comb(n + r - 1, r)
 
     if index < 0:
         index += c
@@ -3911,9 +3921,7 @@ def nth_combination_with_replacement(iterable, r, index):
     while r:
         r -= 1
         while n >= 0:
-            num_combs = factorial(n + r - 1) // (
-                factorial(r) * factorial(n - 1)
-            )
+            num_combs = comb(n + r - 1, r)
             if index < num_combs:
                 break
             n -= 1
@@ -4015,9 +4023,9 @@ def combination_index(element, iterable):
     for i, j in enumerate(reversed(indexes), start=1):
         j = n - j
         if i <= j:
-            index += factorial(j) // (factorial(i) * factorial(j - i))
+            index += comb(j, i)
 
-    return factorial(n + 1) // (factorial(k + 1) * factorial(n - k)) - index
+    return comb(n + 1, k + 1) - index
 
 
 def combination_with_replacement_index(element, iterable):
@@ -4057,7 +4065,7 @@ def combination_with_replacement_index(element, iterable):
             break
     else:
         raise ValueError(
-            'element is not a combination with replacment of iterable'
+            'element is not a combination with replacement of iterable'
         )
 
     n = len(pool)
@@ -4066,11 +4074,13 @@ def combination_with_replacement_index(element, iterable):
         occupations[p] += 1
 
     index = 0
+    cumulative_sum = 0
     for k in range(1, n):
-        j = l + n - 1 - k - sum(occupations[:k])
+        cumulative_sum += occupations[k - 1]
+        j = l + n - 1 - k - cumulative_sum
         i = n - k
         if i <= j:
-            index += factorial(j) // (factorial(i) * factorial(j - i))
+            index += comb(j, i)
 
     return index
 
@@ -4296,7 +4306,7 @@ def duplicates_everseen(iterable, key=None):
     >>> list(duplicates_everseen('AaaBbbCccAaa', str.lower))
     ['a', 'a', 'b', 'b', 'c', 'c', 'A', 'a', 'a']
 
-    This function is analagous to :func:`unique_everseen` and is subject to
+    This function is analogous to :func:`unique_everseen` and is subject to
     the same performance considerations.
 
     """
@@ -4326,12 +4336,54 @@ def duplicates_justseen(iterable, key=None):
     >>> list(duplicates_justseen('AaaBbbCccAaa', str.lower))
     ['a', 'a', 'b', 'b', 'c', 'c', 'a', 'a']
 
-    This function is analagous to :func:`unique_justseen`.
+    This function is analogous to :func:`unique_justseen`.
 
     """
     return flatten(g for _, g in groupby(iterable, key) for _ in g)
 
 
+def classify_unique(iterable, key=None):
+    """Classify each element in terms of its uniqueness.
+
+    For each element in the input iterable, return a 3-tuple consisting of:
+
+    1. The element itself
+    2. ``False`` if the element is equal to the one preceding it in the input,
+       ``True`` otherwise (i.e. the equivalent of :func:`unique_justseen`)
+    3. ``False`` if this element has been seen anywhere in the input before,
+       ``True`` otherwise (i.e. the equivalent of :func:`unique_everseen`)
+
+    >>> list(classify_unique('otto'))    # doctest: +NORMALIZE_WHITESPACE
+    [('o', True,  True),
+     ('t', True,  True),
+     ('t', False, False),
+     ('o', True,  False)]
+
+    This function is analogous to :func:`unique_everseen` and is subject to
+    the same performance considerations.
+
+    """
+    seen_set = set()
+    seen_list = []
+    use_key = key is not None
+    previous = None
+
+    for i, element in enumerate(iterable):
+        k = key(element) if use_key else element
+        is_unique_justseen = not i or previous != k
+        previous = k
+        is_unique_everseen = False
+        try:
+            if k not in seen_set:
+                seen_set.add(k)
+                is_unique_everseen = True
+        except TypeError:
+            if k not in seen_list:
+                seen_list.append(k)
+                is_unique_everseen = True
+        yield element, is_unique_justseen, is_unique_everseen
+
+
 def minmax(iterable_or_value, *others, key=None, default=_marker):
     """Returns both the smallest and largest items in an iterable
     or the largest of two or more arguments.
@@ -4529,10 +4581,8 @@ def takewhile_inclusive(predicate, iterable):
     :func:`takewhile` would return ``[1, 4]``.
     """
     for x in iterable:
-        if predicate(x):
-            yield x
-        else:
-            yield x
+        yield x
+        if not predicate(x):
             break
 
 
@@ -4567,3 +4617,40 @@ def outer_product(func, xs, ys, *args, **kwargs):
         starmap(lambda x, y: func(x, y, *args, **kwargs), product(xs, ys)),
         n=len(ys),
     )
+
+
+def iter_suppress(iterable, *exceptions):
+    """Yield each of the items from *iterable*. If the iteration raises one of
+    the specified *exceptions*, that exception will be suppressed and iteration
+    will stop.
+
+    >>> from itertools import chain
+    >>> def breaks_at_five(x):
+    ...     while True:
+    ...         if x >= 5:
+    ...             raise RuntimeError
+    ...         yield x
+    ...         x += 1
+    >>> it_1 = iter_suppress(breaks_at_five(1), RuntimeError)
+    >>> it_2 = iter_suppress(breaks_at_five(2), RuntimeError)
+    >>> list(chain(it_1, it_2))
+    [1, 2, 3, 4, 2, 3, 4]
+    """
+    try:
+        yield from iterable
+    except exceptions:
+        return
+
+
+def filter_map(func, iterable):
+    """Apply *func* to every element of *iterable*, yielding only those which
+    are not ``None``.
+
+    >>> elems = ['1', 'a', '2', 'b', '3']
+    >>> list(filter_map(lambda s: int(s) if s.isnumeric() else None, elems))
+    [1, 2, 3]
+    """
+    for x in iterable:
+        y = func(x)
+        if y is not None:
+            yield y
diff --git a/lib/more_itertools/more.pyi b/lib/more_itertools/more.pyi
index 07bfc155..9a5fc911 100644
--- a/lib/more_itertools/more.pyi
+++ b/lib/more_itertools/more.pyi
@@ -29,7 +29,7 @@ _U = TypeVar('_U')
 _V = TypeVar('_V')
 _W = TypeVar('_W')
 _T_co = TypeVar('_T_co', covariant=True)
-_GenFn = TypeVar('_GenFn', bound=Callable[..., Iterator[object]])
+_GenFn = TypeVar('_GenFn', bound=Callable[..., Iterator[Any]])
 _Raisable = BaseException | Type[BaseException]
 
 @type_check_only
@@ -74,7 +74,7 @@ class peekable(Generic[_T], Iterator[_T]):
     def __getitem__(self, index: slice) -> list[_T]: ...
 
 def consumer(func: _GenFn) -> _GenFn: ...
-def ilen(iterable: Iterable[object]) -> int: ...
+def ilen(iterable: Iterable[_T]) -> int: ...
 def iterate(func: Callable[[_T], _T], start: _T) -> Iterator[_T]: ...
 def with_iter(
     context_manager: ContextManager[Iterable[_T]],
@@ -116,7 +116,7 @@ class bucket(Generic[_T, _U], Container[_U]):
         self,
         iterable: Iterable[_T],
         key: Callable[[_T], _U],
-        validator: Callable[[object], object] | None = ...,
+        validator: Callable[[_U], object] | None = ...,
     ) -> None: ...
     def __contains__(self, value: object) -> bool: ...
     def __iter__(self) -> Iterator[_U]: ...
@@ -383,7 +383,7 @@ def mark_ends(
     iterable: Iterable[_T],
 ) -> Iterable[tuple[bool, bool, _T]]: ...
 def locate(
-    iterable: Iterable[object],
+    iterable: Iterable[_T],
     pred: Callable[..., Any] = ...,
     window_size: int | None = ...,
 ) -> Iterator[int]: ...
@@ -618,6 +618,9 @@ def duplicates_everseen(
 def duplicates_justseen(
     iterable: Iterable[_T], key: Callable[[_T], _U] | None = ...
 ) -> Iterator[_T]: ...
+def classify_unique(
+    iterable: Iterable[_T], key: Callable[[_T], _U] | None = ...
+) -> Iterator[tuple[_T, bool, bool]]: ...
 
 class _SupportsLessThan(Protocol):
     def __lt__(self, __other: Any) -> bool: ...
@@ -662,9 +665,9 @@ def minmax(
 def longest_common_prefix(
     iterables: Iterable[Iterable[_T]],
 ) -> Iterator[_T]: ...
-def iequals(*iterables: Iterable[object]) -> bool: ...
+def iequals(*iterables: Iterable[Any]) -> bool: ...
 def constrained_batches(
-    iterable: Iterable[object],
+    iterable: Iterable[_T],
     max_size: int,
     max_count: int | None = ...,
     get_len: Callable[[_T], object] = ...,
@@ -682,3 +685,11 @@ def outer_product(
     *args: Any,
     **kwargs: Any,
 ) -> Iterator[tuple[_V, ...]]: ...
+def iter_suppress(
+    iterable: Iterable[_T],
+    *exceptions: Type[BaseException],
+) -> Iterator[_T]: ...
+def filter_map(
+    func: Callable[[_T], _V | None],
+    iterable: Iterable[_T],
+) -> Iterator[_V]: ...
diff --git a/lib/more_itertools/recipes.py b/lib/more_itertools/recipes.py
index a0bdbece..145e3cb5 100644
--- a/lib/more_itertools/recipes.py
+++ b/lib/more_itertools/recipes.py
@@ -28,6 +28,7 @@ from itertools import (
     zip_longest,
 )
 from random import randrange, sample, choice
+from sys import hexversion
 
 __all__ = [
     'all_equal',
@@ -56,6 +57,7 @@ __all__ = [
     'powerset',
     'prepend',
     'quantify',
+    'reshape',
     'random_combination_with_replacement',
     'random_combination',
     'random_permutation',
@@ -69,6 +71,7 @@ __all__ = [
     'tabulate',
     'tail',
     'take',
+    'totient',
     'transpose',
     'triplewise',
     'unique_everseen',
@@ -492,7 +495,7 @@ def unique_everseen(iterable, key=None):
         >>> list(unique_everseen(iterable, key=tuple))  # Faster
         [[1, 2], [2, 3]]
 
-    Similary, you may want to convert unhashable ``set`` objects with
+    Similarly, you may want to convert unhashable ``set`` objects with
     ``key=frozenset``. For ``dict`` objects,
     ``key=lambda x: frozenset(x.items())`` can be used.
 
@@ -524,6 +527,9 @@ def unique_justseen(iterable, key=None):
     ['A', 'B', 'C', 'A', 'D']
 
     """
+    if key is None:
+        return map(operator.itemgetter(0), groupby(iterable))
+
     return map(next, map(operator.itemgetter(1), groupby(iterable, key)))
 
 
@@ -817,35 +823,34 @@ def polynomial_from_roots(roots):
     return list(reduce(convolve, factors, [1]))
 
 
-def iter_index(iterable, value, start=0):
+def iter_index(iterable, value, start=0, stop=None):
     """Yield the index of each place in *iterable* that *value* occurs,
-    beginning with index *start*.
+    beginning with index *start* and ending before index *stop*.
 
     See :func:`locate` for a more general means of finding the indexes
     associated with particular values.
 
     >>> list(iter_index('AABCADEAF', 'A'))
     [0, 1, 4, 7]
+    >>> list(iter_index('AABCADEAF', 'A', 1))  # start index is inclusive
+    [1, 4, 7]
+    >>> list(iter_index('AABCADEAF', 'A', 1, 7))  # stop index is not inclusive
+    [1, 4]
     """
-    try:
-        seq_index = iterable.index
-    except AttributeError:
+    seq_index = getattr(iterable, 'index', None)
+    if seq_index is None:
         # Slow path for general iterables
-        it = islice(iterable, start, None)
-        i = start - 1
-        try:
-            while True:
-                i = i + operator.indexOf(it, value) + 1
+        it = islice(iterable, start, stop)
+        for i, element in enumerate(it, start):
+            if element is value or element == value:
                 yield i
-        except ValueError:
-            pass
     else:
         # Fast path for sequences
+        stop = len(iterable) if stop is None else stop
         i = start - 1
         try:
             while True:
-                i = seq_index(value, i + 1)
-                yield i
+                yield (i := seq_index(value, i + 1, stop))
         except ValueError:
             pass
 
@@ -856,47 +861,52 @@ def sieve(n):
     >>> list(sieve(30))
     [2, 3, 5, 7, 11, 13, 17, 19, 23, 29]
     """
+    if n > 2:
+        yield 2
+    start = 3
     data = bytearray((0, 1)) * (n // 2)
-    data[:3] = 0, 0, 0
     limit = math.isqrt(n) + 1
-    for p in compress(range(limit), data):
+    for p in iter_index(data, 1, start, limit):
+        yield from iter_index(data, 1, start, p * p)
         data[p * p : n : p + p] = bytes(len(range(p * p, n, p + p)))
-    data[2] = 1
-    return iter_index(data, 1) if n > 2 else iter([])
+        start = p * p
+    yield from iter_index(data, 1, start)
 
 
-def _batched(iterable, n):
-    """Batch data into lists of length *n*. The last batch may be shorter.
+def _batched(iterable, n, *, strict=False):
+    """Batch data into tuples of length *n*. If the number of items in
+    *iterable* is not divisible by *n*:
+    * The last batch will be shorter if *strict* is ``False``.
+    * :exc:`ValueError` will be raised if *strict* is ``True``.
 
     >>> list(batched('ABCDEFG', 3))
     [('A', 'B', 'C'), ('D', 'E', 'F'), ('G',)]
 
-    On Python 3.12 and above, this is an alias for :func:`itertools.batched`.
+    On Python 3.13 and above, this is an alias for :func:`itertools.batched`.
     """
     if n < 1:
         raise ValueError('n must be at least one')
     it = iter(iterable)
-    while True:
-        batch = tuple(islice(it, n))
-        if not batch:
-            break
+    while batch := tuple(islice(it, n)):
+        if strict and len(batch) != n:
+            raise ValueError('batched(): incomplete batch')
         yield batch
 
 
-try:
+if hexversion >= 0x30D00A2:
     from itertools import batched as itertools_batched
-except ImportError:
-    batched = _batched
-else:
 
-    def batched(iterable, n):
-        return itertools_batched(iterable, n)
+    def batched(iterable, n, *, strict=False):
+        return itertools_batched(iterable, n, strict=strict)
+
+else:
+    batched = _batched
 
     batched.__doc__ = _batched.__doc__
 
 
 def transpose(it):
-    """Swap the rows and columns of the input.
+    """Swap the rows and columns of the input matrix.
 
     >>> list(transpose([(1, 2, 3), (11, 22, 33)]))
     [(1, 11), (2, 22), (3, 33)]
@@ -907,8 +917,20 @@ def transpose(it):
     return _zip_strict(*it)
 
 
+def reshape(matrix, cols):
+    """Reshape the 2-D input *matrix* to have a column count given by *cols*.
+
+    >>> matrix = [(0, 1), (2, 3), (4, 5)]
+    >>> cols = 3
+    >>> list(reshape(matrix, cols))
+    [(0, 1, 2), (3, 4, 5)]
+    """
+    return batched(chain.from_iterable(matrix), cols)
+
+
 def matmul(m1, m2):
     """Multiply two matrices.
+
     >>> list(matmul([(7, 5), (3, 5)], [(2, 5), (7, 9)]))
     [(49, 80), (41, 60)]
 
@@ -921,13 +943,12 @@ def matmul(m1, m2):
 
 def factor(n):
     """Yield the prime factors of n.
+
     >>> list(factor(360))
     [2, 2, 2, 3, 3, 5]
     """
     for prime in sieve(math.isqrt(n) + 1):
-        while True:
-            if n % prime:
-                break
+        while not n % prime:
             yield prime
             n //= prime
             if n == 1:
@@ -975,3 +996,17 @@ def polynomial_derivative(coefficients):
     n = len(coefficients)
     powers = reversed(range(1, n))
     return list(map(operator.mul, coefficients, powers))
+
+
+def totient(n):
+    """Return the count of natural numbers up to *n* that are coprime with *n*.
+
+    >>> totient(9)
+    6
+    >>> totient(12)
+    4
+    """
+    for p in unique_justseen(factor(n)):
+        n = n // p * (p - 1)
+
+    return n
diff --git a/lib/more_itertools/recipes.pyi b/lib/more_itertools/recipes.pyi
index ef883864..ed4c19db 100644
--- a/lib/more_itertools/recipes.pyi
+++ b/lib/more_itertools/recipes.pyi
@@ -14,6 +14,8 @@ from typing import (
 
 # Type and type variable definitions
 _T = TypeVar('_T')
+_T1 = TypeVar('_T1')
+_T2 = TypeVar('_T2')
 _U = TypeVar('_U')
 
 def take(n: int, iterable: Iterable[_T]) -> list[_T]: ...
@@ -26,14 +28,14 @@ def consume(iterator: Iterable[_T], n: int | None = ...) -> None: ...
 def nth(iterable: Iterable[_T], n: int) -> _T | None: ...
 @overload
 def nth(iterable: Iterable[_T], n: int, default: _U) -> _T | _U: ...
-def all_equal(iterable: Iterable[object]) -> bool: ...
+def all_equal(iterable: Iterable[_T]) -> bool: ...
 def quantify(
     iterable: Iterable[_T], pred: Callable[[_T], bool] = ...
 ) -> int: ...
 def pad_none(iterable: Iterable[_T]) -> Iterator[_T | None]: ...
 def padnone(iterable: Iterable[_T]) -> Iterator[_T | None]: ...
 def ncycles(iterable: Iterable[_T], n: int) -> Iterator[_T]: ...
-def dotproduct(vec1: Iterable[object], vec2: Iterable[object]) -> object: ...
+def dotproduct(vec1: Iterable[_T1], vec2: Iterable[_T2]) -> Any: ...
 def flatten(listOfLists: Iterable[Iterable[_T]]) -> Iterator[_T]: ...
 def repeatfunc(
     func: Callable[..., _U], times: int | None = ..., *args: Any
@@ -103,20 +105,24 @@ def sliding_window(
 def subslices(iterable: Iterable[_T]) -> Iterator[list[_T]]: ...
 def polynomial_from_roots(roots: Sequence[_T]) -> list[_T]: ...
 def iter_index(
-    iterable: Iterable[object],
+    iterable: Iterable[_T],
     value: Any,
     start: int | None = ...,
+    stop: int | None = ...,
 ) -> Iterator[int]: ...
 def sieve(n: int) -> Iterator[int]: ...
 def batched(
-    iterable: Iterable[_T],
-    n: int,
+    iterable: Iterable[_T], n: int, *, strict: bool = False
 ) -> Iterator[tuple[_T]]: ...
 def transpose(
     it: Iterable[Iterable[_T]],
 ) -> Iterator[tuple[_T, ...]]: ...
+def reshape(
+    matrix: Iterable[Iterable[_T]], cols: int
+) -> Iterator[tuple[_T, ...]]: ...
 def matmul(m1: Sequence[_T], m2: Sequence[_T]) -> Iterator[tuple[_T]]: ...
 def factor(n: int) -> Iterator[int]: ...
 def polynomial_eval(coefficients: Sequence[_T], x: _U) -> _U: ...
 def sum_of_squares(it: Iterable[_T]) -> _T: ...
 def polynomial_derivative(coefficients: Sequence[_T]) -> list[_T]: ...
+def totient(n: int) -> int: ...
diff --git a/lib/pydantic/__init__.py b/lib/pydantic/__init__.py
index 3bf1418f..85a8c18b 100644
--- a/lib/pydantic/__init__.py
+++ b/lib/pydantic/__init__.py
@@ -1,56 +1,114 @@
-# flake8: noqa
-from . import dataclasses
-from .annotated_types import create_model_from_namedtuple, create_model_from_typeddict
-from .class_validators import root_validator, validator
-from .config import BaseConfig, ConfigDict, Extra
-from .decorator import validate_arguments
-from .env_settings import BaseSettings
-from .error_wrappers import ValidationError
-from .errors import *
-from .fields import Field, PrivateAttr, Required
-from .main import *
-from .networks import *
-from .parse import Protocol
-from .tools import *
-from .types import *
-from .version import VERSION, compiled
+import typing
+
+from ._migration import getattr_migration
+from .version import VERSION
+
+if typing.TYPE_CHECKING:
+    # import of virtually everything is supported via `__getattr__` below,
+    # but we need them here for type checking and IDE support
+    import pydantic_core
+    from pydantic_core.core_schema import (
+        FieldSerializationInfo,
+        SerializationInfo,
+        SerializerFunctionWrapHandler,
+        ValidationInfo,
+        ValidatorFunctionWrapHandler,
+    )
+
+    from . import dataclasses
+    from ._internal._generate_schema import GenerateSchema as GenerateSchema
+    from .aliases import AliasChoices, AliasGenerator, AliasPath
+    from .annotated_handlers import GetCoreSchemaHandler, GetJsonSchemaHandler
+    from .config import ConfigDict
+    from .errors import *
+    from .fields import Field, PrivateAttr, computed_field
+    from .functional_serializers import (
+        PlainSerializer,
+        SerializeAsAny,
+        WrapSerializer,
+        field_serializer,
+        model_serializer,
+    )
+    from .functional_validators import (
+        AfterValidator,
+        BeforeValidator,
+        InstanceOf,
+        PlainValidator,
+        SkipValidation,
+        WrapValidator,
+        field_validator,
+        model_validator,
+    )
+    from .json_schema import WithJsonSchema
+    from .main import *
+    from .networks import *
+    from .type_adapter import TypeAdapter
+    from .types import *
+    from .validate_call_decorator import validate_call
+    from .warnings import PydanticDeprecatedSince20, PydanticDeprecatedSince26, PydanticDeprecationWarning
+
+    # this encourages pycharm to import `ValidationError` from here, not pydantic_core
+    ValidationError = pydantic_core.ValidationError
+    from .deprecated.class_validators import root_validator, validator
+    from .deprecated.config import BaseConfig, Extra
+    from .deprecated.tools import *
+    from .root_model import RootModel
 
 __version__ = VERSION
-
-# WARNING __all__ from .errors is not included here, it will be removed as an export here in v2
-# please use "from pydantic.errors import ..." instead
-__all__ = [
-    # annotated types utils
-    'create_model_from_namedtuple',
-    'create_model_from_typeddict',
+__all__ = (
     # dataclasses
     'dataclasses',
-    # class_validators
+    # functional validators
+    'field_validator',
+    'model_validator',
+    'AfterValidator',
+    'BeforeValidator',
+    'PlainValidator',
+    'WrapValidator',
+    'SkipValidation',
+    'InstanceOf',
+    # JSON Schema
+    'WithJsonSchema',
+    # deprecated V1 functional validators, these are imported via `__getattr__` below
     'root_validator',
     'validator',
+    # functional serializers
+    'field_serializer',
+    'model_serializer',
+    'PlainSerializer',
+    'SerializeAsAny',
+    'WrapSerializer',
     # config
-    'BaseConfig',
     'ConfigDict',
+    # deprecated V1 config, these are imported via `__getattr__` below
+    'BaseConfig',
     'Extra',
-    # decorator
-    'validate_arguments',
-    # env_settings
-    'BaseSettings',
-    # error_wrappers
-    'ValidationError',
+    # validate_call
+    'validate_call',
+    # errors
+    'PydanticErrorCodes',
+    'PydanticUserError',
+    'PydanticSchemaGenerationError',
+    'PydanticImportError',
+    'PydanticUndefinedAnnotation',
+    'PydanticInvalidForJsonSchema',
     # fields
     'Field',
-    'Required',
+    'computed_field',
+    'PrivateAttr',
+    # alias
+    'AliasChoices',
+    'AliasGenerator',
+    'AliasPath',
     # main
     'BaseModel',
     'create_model',
-    'validate_model',
     # network
     'AnyUrl',
     'AnyHttpUrl',
     'FileUrl',
     'HttpUrl',
-    'stricturl',
+    'UrlConstraints',
     'EmailStr',
     'NameEmail',
     'IPvAnyAddress',
@@ -62,48 +120,38 @@ __all__ = [
     'RedisDsn',
     'MongoDsn',
     'KafkaDsn',
+    'NatsDsn',
+    'MySQLDsn',
+    'MariaDBDsn',
     'validate_email',
-    # parse
-    'Protocol',
-    # tools
-    'parse_file_as',
+    # root_model
+    'RootModel',
+    # deprecated tools, these are imported via `__getattr__` below
     'parse_obj_as',
-    'parse_raw_as',
     'schema_of',
     'schema_json_of',
     # types
-    'NoneStr',
-    'NoneBytes',
-    'StrBytes',
-    'NoneStrBytes',
+    'Strict',
     'StrictStr',
-    'ConstrainedBytes',
     'conbytes',
-    'ConstrainedList',
     'conlist',
-    'ConstrainedSet',
     'conset',
-    'ConstrainedFrozenSet',
     'confrozenset',
-    'ConstrainedStr',
     'constr',
-    'PyObject',
-    'ConstrainedInt',
+    'StringConstraints',
+    'ImportString',
     'conint',
     'PositiveInt',
     'NegativeInt',
     'NonNegativeInt',
     'NonPositiveInt',
-    'ConstrainedFloat',
     'confloat',
     'PositiveFloat',
     'NegativeFloat',
     'NonNegativeFloat',
     'NonPositiveFloat',
     'FiniteFloat',
-    'ConstrainedDecimal',
     'condecimal',
-    'ConstrainedDate',
     'condate',
     'UUID1',
     'UUID3',
@@ -111,9 +159,8 @@ __all__ = [
     'UUID5',
     'FilePath',
     'DirectoryPath',
+    'NewPath',
     'Json',
-    'JsonWrapper',
-    'SecretField',
     'SecretStr',
     'SecretBytes',
     'StrictBool',
@@ -121,11 +168,221 @@ __all__ = [
     'StrictInt',
     'StrictFloat',
     'PaymentCardNumber',
-    'PrivateAttr',
     'ByteSize',
     'PastDate',
     'FutureDate',
+    'PastDatetime',
+    'FutureDatetime',
+    'AwareDatetime',
+    'NaiveDatetime',
+    'AllowInfNan',
+    'EncoderProtocol',
+    'EncodedBytes',
+    'EncodedStr',
+    'Base64Encoder',
+    'Base64Bytes',
+    'Base64Str',
+    'Base64UrlBytes',
+    'Base64UrlStr',
+    'GetPydanticSchema',
+    'Tag',
+    'Discriminator',
+    'JsonValue',
+    # type_adapter
+    'TypeAdapter',
     # version
-    'compiled',
+    '__version__',
     'VERSION',
-]
+    # warnings
+    'PydanticDeprecatedSince20',
+    'PydanticDeprecatedSince26',
+    'PydanticDeprecationWarning',
+    # annotated handlers
+    'GetCoreSchemaHandler',
+    'GetJsonSchemaHandler',
+    # generate schema from ._internal
+    'GenerateSchema',
+    # pydantic_core
+    'ValidationError',
+    'ValidationInfo',
+    'SerializationInfo',
+    'ValidatorFunctionWrapHandler',
+    'FieldSerializationInfo',
+    'SerializerFunctionWrapHandler',
+    'OnErrorOmit',
+)
+
+# A mapping of {<member name>: (package, <module name>)} defining dynamic imports
+_dynamic_imports: 'dict[str, tuple[str, str]]' = {
+    'dataclasses': (__package__, '__module__'),
+    # functional validators
+    'field_validator': (__package__, '.functional_validators'),
+    'model_validator': (__package__, '.functional_validators'),
+    'AfterValidator': (__package__, '.functional_validators'),
+    'BeforeValidator': (__package__, '.functional_validators'),
+    'PlainValidator': (__package__, '.functional_validators'),
+    'WrapValidator': (__package__, '.functional_validators'),
+    'SkipValidation': (__package__, '.functional_validators'),
+    'InstanceOf': (__package__, '.functional_validators'),
+    # JSON Schema
+    'WithJsonSchema': (__package__, '.json_schema'),
+    # functional serializers
+    'field_serializer': (__package__, '.functional_serializers'),
+    'model_serializer': (__package__, '.functional_serializers'),
+    'PlainSerializer': (__package__, '.functional_serializers'),
+    'SerializeAsAny': (__package__, '.functional_serializers'),
+    'WrapSerializer': (__package__, '.functional_serializers'),
+    # config
+    'ConfigDict': (__package__, '.config'),
+    # validate call
+    'validate_call': (__package__, '.validate_call_decorator'),
+    # errors
+    'PydanticErrorCodes': (__package__, '.errors'),
+    'PydanticUserError': (__package__, '.errors'),
+    'PydanticSchemaGenerationError': (__package__, '.errors'),
+    'PydanticImportError': (__package__, '.errors'),
+    'PydanticUndefinedAnnotation': (__package__, '.errors'),
+    'PydanticInvalidForJsonSchema': (__package__, '.errors'),
+    # fields
+    'Field': (__package__, '.fields'),
+    'computed_field': (__package__, '.fields'),
+    'PrivateAttr': (__package__, '.fields'),
+    # alias
+    'AliasChoices': (__package__, '.aliases'),
+    'AliasGenerator': (__package__, '.aliases'),
+    'AliasPath': (__package__, '.aliases'),
+    # main
+    'BaseModel': (__package__, '.main'),
+    'create_model': (__package__, '.main'),
+    # network
+    'AnyUrl': (__package__, '.networks'),
+    'AnyHttpUrl': (__package__, '.networks'),
+    'FileUrl': (__package__, '.networks'),
+    'HttpUrl': (__package__, '.networks'),
+    'UrlConstraints': (__package__, '.networks'),
+    'EmailStr': (__package__, '.networks'),
+    'NameEmail': (__package__, '.networks'),
+    'IPvAnyAddress': (__package__, '.networks'),
+    'IPvAnyInterface': (__package__, '.networks'),
+    'IPvAnyNetwork': (__package__, '.networks'),
+    'PostgresDsn': (__package__, '.networks'),
+    'CockroachDsn': (__package__, '.networks'),
+    'AmqpDsn': (__package__, '.networks'),
+    'RedisDsn': (__package__, '.networks'),
+    'MongoDsn': (__package__, '.networks'),
+    'KafkaDsn': (__package__, '.networks'),
+    'NatsDsn': (__package__, '.networks'),
+    'MySQLDsn': (__package__, '.networks'),
+    'MariaDBDsn': (__package__, '.networks'),
+    'validate_email': (__package__, '.networks'),
+    # root_model
+    'RootModel': (__package__, '.root_model'),
+    # types
+    'Strict': (__package__, '.types'),
+    'StrictStr': (__package__, '.types'),
+    'conbytes': (__package__, '.types'),
+    'conlist': (__package__, '.types'),
+    'conset': (__package__, '.types'),
+    'confrozenset': (__package__, '.types'),
+    'constr': (__package__, '.types'),
+    'StringConstraints': (__package__, '.types'),
+    'ImportString': (__package__, '.types'),
+    'conint': (__package__, '.types'),
+    'PositiveInt': (__package__, '.types'),
+    'NegativeInt': (__package__, '.types'),
+    'NonNegativeInt': (__package__, '.types'),
+    'NonPositiveInt': (__package__, '.types'),
+    'confloat': (__package__, '.types'),
+    'PositiveFloat': (__package__, '.types'),
+    'NegativeFloat': (__package__, '.types'),
+    'NonNegativeFloat': (__package__, '.types'),
+    'NonPositiveFloat': (__package__, '.types'),
+    'FiniteFloat': (__package__, '.types'),
+    'condecimal': (__package__, '.types'),
+    'condate': (__package__, '.types'),
+    'UUID1': (__package__, '.types'),
+    'UUID3': (__package__, '.types'),
+    'UUID4': (__package__, '.types'),
+    'UUID5': (__package__, '.types'),
+    'FilePath': (__package__, '.types'),
+    'DirectoryPath': (__package__, '.types'),
+    'NewPath': (__package__, '.types'),
+    'Json': (__package__, '.types'),
+    'SecretStr': (__package__, '.types'),
+    'SecretBytes': (__package__, '.types'),
+    'StrictBool': (__package__, '.types'),
+    'StrictBytes': (__package__, '.types'),
+    'StrictInt': (__package__, '.types'),
+    'StrictFloat': (__package__, '.types'),
+    'PaymentCardNumber': (__package__, '.types'),
+    'ByteSize': (__package__, '.types'),
+    'PastDate': (__package__, '.types'),
+    'FutureDate': (__package__, '.types'),
+    'PastDatetime': (__package__, '.types'),
+    'FutureDatetime': (__package__, '.types'),
+    'AwareDatetime': (__package__, '.types'),
+    'NaiveDatetime': (__package__, '.types'),
+    'AllowInfNan': (__package__, '.types'),
+    'EncoderProtocol': (__package__, '.types'),
+    'EncodedBytes': (__package__, '.types'),
+    'EncodedStr': (__package__, '.types'),
+    'Base64Encoder': (__package__, '.types'),
+    'Base64Bytes': (__package__, '.types'),
+    'Base64Str': (__package__, '.types'),
+    'Base64UrlBytes': (__package__, '.types'),
+    'Base64UrlStr': (__package__, '.types'),
+    'GetPydanticSchema': (__package__, '.types'),
+    'Tag': (__package__, '.types'),
+    'Discriminator': (__package__, '.types'),
+    'JsonValue': (__package__, '.types'),
+    'OnErrorOmit': (__package__, '.types'),
+    # type_adapter
+    'TypeAdapter': (__package__, '.type_adapter'),
+    # warnings
+    'PydanticDeprecatedSince20': (__package__, '.warnings'),
+    'PydanticDeprecatedSince26': (__package__, '.warnings'),
+    'PydanticDeprecationWarning': (__package__, '.warnings'),
+    # annotated handlers
+    'GetCoreSchemaHandler': (__package__, '.annotated_handlers'),
+    'GetJsonSchemaHandler': (__package__, '.annotated_handlers'),
+    # generate schema from ._internal
+    'GenerateSchema': (__package__, '._internal._generate_schema'),
+    # pydantic_core stuff
+    'ValidationError': ('pydantic_core', '.'),
+    'ValidationInfo': ('pydantic_core', '.core_schema'),
+    'SerializationInfo': ('pydantic_core', '.core_schema'),
+    'ValidatorFunctionWrapHandler': ('pydantic_core', '.core_schema'),
+    'FieldSerializationInfo': ('pydantic_core', '.core_schema'),
+    'SerializerFunctionWrapHandler': ('pydantic_core', '.core_schema'),
+    # deprecated, mostly not included in __all__
+    'root_validator': (__package__, '.deprecated.class_validators'),
+    'validator': (__package__, '.deprecated.class_validators'),
+    'BaseConfig': (__package__, '.deprecated.config'),
+    'Extra': (__package__, '.deprecated.config'),
+    'parse_obj_as': (__package__, '.deprecated.tools'),
+    'schema_of': (__package__, '.deprecated.tools'),
+    'schema_json_of': (__package__, '.deprecated.tools'),
+    'FieldValidationInfo': ('pydantic_core', '.core_schema'),
+}
+
+_getattr_migration = getattr_migration(__name__)
+
+
+def __getattr__(attr_name: str) -> object:
+    dynamic_attr = _dynamic_imports.get(attr_name)
+    if dynamic_attr is None:
+        return _getattr_migration(attr_name)
+
+    package, module_name = dynamic_attr
+
+    from importlib import import_module
+
+    if module_name == '__module__':
+        return import_module(f'.{attr_name}', package=package)
+    else:
+        module = import_module(module_name, package=package)
+        return getattr(module, attr_name)
+
+
+def __dir__() -> 'list[str]':
+    return list(__all__)
diff --git a/lib/pydantic/_internal/__init__.py b/lib/pydantic/_internal/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/lib/pydantic/_internal/_config.py b/lib/pydantic/_internal/_config.py
new file mode 100644
index 00000000..52c4cc42
--- /dev/null
+++ b/lib/pydantic/_internal/_config.py
@@ -0,0 +1,322 @@
+from __future__ import annotations as _annotations
+
+import warnings
+from contextlib import contextmanager
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    cast,
+)
+
+from pydantic_core import core_schema
+from typing_extensions import (
+    Literal,
+    Self,
+)
+
+from ..aliases import AliasGenerator
+from ..config import ConfigDict, ExtraValues, JsonDict, JsonEncoder, JsonSchemaExtraCallable
+from ..errors import PydanticUserError
+from ..warnings import PydanticDeprecatedSince20
+
+if not TYPE_CHECKING:
+    # See PyCharm issues https://youtrack.jetbrains.com/issue/PY-21915
+    # and https://youtrack.jetbrains.com/issue/PY-51428
+    DeprecationWarning = PydanticDeprecatedSince20
+
+if TYPE_CHECKING:
+    from .._internal._schema_generation_shared import GenerateSchema
+
+DEPRECATION_MESSAGE = 'Support for class-based `config` is deprecated, use ConfigDict instead.'
+
+
+class ConfigWrapper:
+    """Internal wrapper for Config which exposes ConfigDict items as attributes."""
+
+    __slots__ = ('config_dict',)
+
+    config_dict: ConfigDict
+
+    # all annotations are copied directly from ConfigDict, and should be kept up to date, a test will fail if they
+    # stop matching
+    title: str | None
+    str_to_lower: bool
+    str_to_upper: bool
+    str_strip_whitespace: bool
+    str_min_length: int
+    str_max_length: int | None
+    extra: ExtraValues | None
+    frozen: bool
+    populate_by_name: bool
+    use_enum_values: bool
+    validate_assignment: bool
+    arbitrary_types_allowed: bool
+    from_attributes: bool
+    # whether to use the actual key provided in the data (e.g. alias or first alias for "field required" errors) instead of field_names
+    # to construct error `loc`s, default `True`
+    loc_by_alias: bool
+    alias_generator: Callable[[str], str] | AliasGenerator | None
+    ignored_types: tuple[type, ...]
+    allow_inf_nan: bool
+    json_schema_extra: JsonDict | JsonSchemaExtraCallable | None
+    json_encoders: dict[type[object], JsonEncoder] | None
+
+    # new in V2
+    strict: bool
+    # whether instances of models and dataclasses (including subclass instances) should re-validate, default 'never'
+    revalidate_instances: Literal['always', 'never', 'subclass-instances']
+    ser_json_timedelta: Literal['iso8601', 'float']
+    ser_json_bytes: Literal['utf8', 'base64']
+    ser_json_inf_nan: Literal['null', 'constants']
+    # whether to validate default values during validation, default False
+    validate_default: bool
+    validate_return: bool
+    protected_namespaces: tuple[str, ...]
+    hide_input_in_errors: bool
+    defer_build: bool
+    plugin_settings: dict[str, object] | None
+    schema_generator: type[GenerateSchema] | None
+    json_schema_serialization_defaults_required: bool
+    json_schema_mode_override: Literal['validation', 'serialization', None]
+    coerce_numbers_to_str: bool
+    regex_engine: Literal['rust-regex', 'python-re']
+    validation_error_cause: bool
+
+    def __init__(self, config: ConfigDict | dict[str, Any] | type[Any] | None, *, check: bool = True):
+        if check:
+            self.config_dict = prepare_config(config)
+        else:
+            self.config_dict = cast(ConfigDict, config)
+
+    @classmethod
+    def for_model(cls, bases: tuple[type[Any], ...], namespace: dict[str, Any], kwargs: dict[str, Any]) -> Self:
+        """Build a new `ConfigWrapper` instance for a `BaseModel`.
+
+        The config wrapper built based on (in descending order of priority):
+        - options from `kwargs`
+        - options from the `namespace`
+        - options from the base classes (`bases`)
+
+        Args:
+            bases: A tuple of base classes.
+            namespace: The namespace of the class being created.
+            kwargs: The kwargs passed to the class being created.
+
+        Returns:
+            A `ConfigWrapper` instance for `BaseModel`.
+        """
+        config_new = ConfigDict()
+        for base in bases:
+            config = getattr(base, 'model_config', None)
+            if config:
+                config_new.update(config.copy())
+
+        config_class_from_namespace = namespace.get('Config')
+        config_dict_from_namespace = namespace.get('model_config')
+
+        if config_class_from_namespace and config_dict_from_namespace:
+            raise PydanticUserError('"Config" and "model_config" cannot be used together', code='config-both')
+
+        config_from_namespace = config_dict_from_namespace or prepare_config(config_class_from_namespace)
+
+        config_new.update(config_from_namespace)
+
+        for k in list(kwargs.keys()):
+            if k in config_keys:
+                config_new[k] = kwargs.pop(k)
+
+        return cls(config_new)
+
+    # we don't show `__getattr__` to type checkers so missing attributes cause errors
+    if not TYPE_CHECKING:  # pragma: no branch
+
+        def __getattr__(self, name: str) -> Any:
+            try:
+                return self.config_dict[name]
+            except KeyError:
+                try:
+                    return config_defaults[name]
+                except KeyError:
+                    raise AttributeError(f'Config has no attribute {name!r}') from None
+
+    def core_config(self, obj: Any) -> core_schema.CoreConfig:
+        """Create a pydantic-core config, `obj` is just used to populate `title` if not set in config.
+
+        Pass `obj=None` if you do not want to attempt to infer the `title`.
+
+        We don't use getattr here since we don't want to populate with defaults.
+
+        Args:
+            obj: An object used to populate `title` if not set in config.
+
+        Returns:
+            A `CoreConfig` object created from config.
+        """
+
+        def dict_not_none(**kwargs: Any) -> Any:
+            return {k: v for k, v in kwargs.items() if v is not None}
+
+        core_config = core_schema.CoreConfig(
+            **dict_not_none(
+                title=self.config_dict.get('title') or (obj and obj.__name__),
+                extra_fields_behavior=self.config_dict.get('extra'),
+                allow_inf_nan=self.config_dict.get('allow_inf_nan'),
+                populate_by_name=self.config_dict.get('populate_by_name'),
+                str_strip_whitespace=self.config_dict.get('str_strip_whitespace'),
+                str_to_lower=self.config_dict.get('str_to_lower'),
+                str_to_upper=self.config_dict.get('str_to_upper'),
+                strict=self.config_dict.get('strict'),
+                ser_json_timedelta=self.config_dict.get('ser_json_timedelta'),
+                ser_json_bytes=self.config_dict.get('ser_json_bytes'),
+                ser_json_inf_nan=self.config_dict.get('ser_json_inf_nan'),
+                from_attributes=self.config_dict.get('from_attributes'),
+                loc_by_alias=self.config_dict.get('loc_by_alias'),
+                revalidate_instances=self.config_dict.get('revalidate_instances'),
+                validate_default=self.config_dict.get('validate_default'),
+                str_max_length=self.config_dict.get('str_max_length'),
+                str_min_length=self.config_dict.get('str_min_length'),
+                hide_input_in_errors=self.config_dict.get('hide_input_in_errors'),
+                coerce_numbers_to_str=self.config_dict.get('coerce_numbers_to_str'),
+                regex_engine=self.config_dict.get('regex_engine'),
+                validation_error_cause=self.config_dict.get('validation_error_cause'),
+            )
+        )
+        return core_config
+
+    def __repr__(self):
+        c = ', '.join(f'{k}={v!r}' for k, v in self.config_dict.items())
+        return f'ConfigWrapper({c})'
+
+
+class ConfigWrapperStack:
+    """A stack of `ConfigWrapper` instances."""
+
+    def __init__(self, config_wrapper: ConfigWrapper):
+        self._config_wrapper_stack: list[ConfigWrapper] = [config_wrapper]
+
+    @property
+    def tail(self) -> ConfigWrapper:
+        return self._config_wrapper_stack[-1]
+
+    @contextmanager
+    def push(self, config_wrapper: ConfigWrapper | ConfigDict | None):
+        if config_wrapper is None:
+            yield
+            return
+
+        if not isinstance(config_wrapper, ConfigWrapper):
+            config_wrapper = ConfigWrapper(config_wrapper, check=False)
+
+        self._config_wrapper_stack.append(config_wrapper)
+        try:
+            yield
+        finally:
+            self._config_wrapper_stack.pop()
+
+
+config_defaults = ConfigDict(
+    title=None,
+    str_to_lower=False,
+    str_to_upper=False,
+    str_strip_whitespace=False,
+    str_min_length=0,
+    str_max_length=None,
+    # let the model / dataclass decide how to handle it
+    extra=None,
+    frozen=False,
+    populate_by_name=False,
+    use_enum_values=False,
+    validate_assignment=False,
+    arbitrary_types_allowed=False,
+    from_attributes=False,
+    loc_by_alias=True,
+    alias_generator=None,
+    ignored_types=(),
+    allow_inf_nan=True,
+    json_schema_extra=None,
+    strict=False,
+    revalidate_instances='never',
+    ser_json_timedelta='iso8601',
+    ser_json_bytes='utf8',
+    ser_json_inf_nan='null',
+    validate_default=False,
+    validate_return=False,
+    protected_namespaces=('model_',),
+    hide_input_in_errors=False,
+    json_encoders=None,
+    defer_build=False,
+    plugin_settings=None,
+    schema_generator=None,
+    json_schema_serialization_defaults_required=False,
+    json_schema_mode_override=None,
+    coerce_numbers_to_str=False,
+    regex_engine='rust-regex',
+    validation_error_cause=False,
+)
+
+
+def prepare_config(config: ConfigDict | dict[str, Any] | type[Any] | None) -> ConfigDict:
+    """Create a `ConfigDict` instance from an existing dict, a class (e.g. old class-based config) or None.
+
+    Args:
+        config: The input config.
+
+    Returns:
+        A ConfigDict object created from config.
+    """
+    if config is None:
+        return ConfigDict()
+
+    if not isinstance(config, dict):
+        warnings.warn(DEPRECATION_MESSAGE, DeprecationWarning)
+        config = {k: getattr(config, k) for k in dir(config) if not k.startswith('__')}
+
+    config_dict = cast(ConfigDict, config)
+    check_deprecated(config_dict)
+    return config_dict
+
+
+config_keys = set(ConfigDict.__annotations__.keys())
+
+
+V2_REMOVED_KEYS = {
+    'allow_mutation',
+    'error_msg_templates',
+    'fields',
+    'getter_dict',
+    'smart_union',
+    'underscore_attrs_are_private',
+    'json_loads',
+    'json_dumps',
+    'copy_on_model_validation',
+    'post_init_call',
+}
+V2_RENAMED_KEYS = {
+    'allow_population_by_field_name': 'populate_by_name',
+    'anystr_lower': 'str_to_lower',
+    'anystr_strip_whitespace': 'str_strip_whitespace',
+    'anystr_upper': 'str_to_upper',
+    'keep_untouched': 'ignored_types',
+    'max_anystr_length': 'str_max_length',
+    'min_anystr_length': 'str_min_length',
+    'orm_mode': 'from_attributes',
+    'schema_extra': 'json_schema_extra',
+    'validate_all': 'validate_default',
+}
+
+
+def check_deprecated(config_dict: ConfigDict) -> None:
+    """Check for deprecated config keys and warn the user.
+
+    Args:
+        config_dict: The input config.
+    """
+    deprecated_removed_keys = V2_REMOVED_KEYS & config_dict.keys()
+    deprecated_renamed_keys = V2_RENAMED_KEYS.keys() & config_dict.keys()
+    if deprecated_removed_keys or deprecated_renamed_keys:
+        renamings = {k: V2_RENAMED_KEYS[k] for k in sorted(deprecated_renamed_keys)}
+        renamed_bullets = [f'* {k!r} has been renamed to {v!r}' for k, v in renamings.items()]
+        removed_bullets = [f'* {k!r} has been removed' for k in sorted(deprecated_removed_keys)]
+        message = '\n'.join(['Valid config keys have changed in V2:'] + renamed_bullets + removed_bullets)
+        warnings.warn(message, UserWarning)
diff --git a/lib/pydantic/_internal/_core_metadata.py b/lib/pydantic/_internal/_core_metadata.py
new file mode 100644
index 00000000..296d49f5
--- /dev/null
+++ b/lib/pydantic/_internal/_core_metadata.py
@@ -0,0 +1,92 @@
+from __future__ import annotations as _annotations
+
+import typing
+from typing import Any
+
+import typing_extensions
+
+if typing.TYPE_CHECKING:
+    from ._schema_generation_shared import (
+        CoreSchemaOrField as CoreSchemaOrField,
+    )
+    from ._schema_generation_shared import (
+        GetJsonSchemaFunction,
+    )
+
+
+class CoreMetadata(typing_extensions.TypedDict, total=False):
+    """A `TypedDict` for holding the metadata dict of the schema.
+
+    Attributes:
+        pydantic_js_functions: List of JSON schema functions.
+        pydantic_js_prefer_positional_arguments: Whether JSON schema generator will
+            prefer positional over keyword arguments for an 'arguments' schema.
+    """
+
+    pydantic_js_functions: list[GetJsonSchemaFunction]
+    pydantic_js_annotation_functions: list[GetJsonSchemaFunction]
+
+    # If `pydantic_js_prefer_positional_arguments` is True, the JSON schema generator will
+    # prefer positional over keyword arguments for an 'arguments' schema.
+    pydantic_js_prefer_positional_arguments: bool | None
+
+    pydantic_typed_dict_cls: type[Any] | None  # TODO: Consider moving this into the pydantic-core TypedDictSchema
+
+
+class CoreMetadataHandler:
+    """Because the metadata field in pydantic_core is of type `Any`, we can't assume much about its contents.
+
+    This class is used to interact with the metadata field on a CoreSchema object in a consistent
+    way throughout pydantic.
+    """
+
+    __slots__ = ('_schema',)
+
+    def __init__(self, schema: CoreSchemaOrField):
+        self._schema = schema
+
+        metadata = schema.get('metadata')
+        if metadata is None:
+            schema['metadata'] = CoreMetadata()
+        elif not isinstance(metadata, dict):
+            raise TypeError(f'CoreSchema metadata should be a dict; got {metadata!r}.')
+
+    @property
+    def metadata(self) -> CoreMetadata:
+        """Retrieves the metadata dict from the schema, initializing it to a dict if it is None
+        and raises an error if it is not a dict.
+        """
+        metadata = self._schema.get('metadata')
+        if metadata is None:
+            self._schema['metadata'] = metadata = CoreMetadata()
+        if not isinstance(metadata, dict):
+            raise TypeError(f'CoreSchema metadata should be a dict; got {metadata!r}.')
+        return metadata
+
+
+def build_metadata_dict(
+    *,  # force keyword arguments to make it easier to modify this signature in a backwards-compatible way
+    js_functions: list[GetJsonSchemaFunction] | None = None,
+    js_annotation_functions: list[GetJsonSchemaFunction] | None = None,
+    js_prefer_positional_arguments: bool | None = None,
+    typed_dict_cls: type[Any] | None = None,
+    initial_metadata: Any | None = None,
+) -> Any:
+    """Builds a dict to use as the metadata field of a CoreSchema object in a manner that is consistent
+    with the CoreMetadataHandler class.
+    """
+    if initial_metadata is not None and not isinstance(initial_metadata, dict):
+        raise TypeError(f'CoreSchema metadata should be a dict; got {initial_metadata!r}.')
+
+    metadata = CoreMetadata(
+        pydantic_js_functions=js_functions or [],
+        pydantic_js_annotation_functions=js_annotation_functions or [],
+        pydantic_js_prefer_positional_arguments=js_prefer_positional_arguments,
+        pydantic_typed_dict_cls=typed_dict_cls,
+    )
+    metadata = {k: v for k, v in metadata.items() if v is not None}
+
+    if initial_metadata is not None:
+        metadata = {**initial_metadata, **metadata}
+
+    return metadata
diff --git a/lib/pydantic/_internal/_core_utils.py b/lib/pydantic/_internal/_core_utils.py
new file mode 100644
index 00000000..e74c74ac
--- /dev/null
+++ b/lib/pydantic/_internal/_core_utils.py
@@ -0,0 +1,570 @@
+from __future__ import annotations
+
+import os
+from collections import defaultdict
+from typing import (
+    Any,
+    Callable,
+    Hashable,
+    TypeVar,
+    Union,
+)
+
+from pydantic_core import CoreSchema, core_schema
+from pydantic_core import validate_core_schema as _validate_core_schema
+from typing_extensions import TypeAliasType, TypeGuard, get_args, get_origin
+
+from . import _repr
+from ._typing_extra import is_generic_alias
+
+AnyFunctionSchema = Union[
+    core_schema.AfterValidatorFunctionSchema,
+    core_schema.BeforeValidatorFunctionSchema,
+    core_schema.WrapValidatorFunctionSchema,
+    core_schema.PlainValidatorFunctionSchema,
+]
+
+
+FunctionSchemaWithInnerSchema = Union[
+    core_schema.AfterValidatorFunctionSchema,
+    core_schema.BeforeValidatorFunctionSchema,
+    core_schema.WrapValidatorFunctionSchema,
+]
+
+CoreSchemaField = Union[
+    core_schema.ModelField, core_schema.DataclassField, core_schema.TypedDictField, core_schema.ComputedField
+]
+CoreSchemaOrField = Union[core_schema.CoreSchema, CoreSchemaField]
+
+_CORE_SCHEMA_FIELD_TYPES = {'typed-dict-field', 'dataclass-field', 'model-field', 'computed-field'}
+_FUNCTION_WITH_INNER_SCHEMA_TYPES = {'function-before', 'function-after', 'function-wrap'}
+_LIST_LIKE_SCHEMA_WITH_ITEMS_TYPES = {'list', 'set', 'frozenset'}
+
+_DEFINITIONS_CACHE_METADATA_KEY = 'pydantic.definitions_cache'
+
+TAGGED_UNION_TAG_KEY = 'pydantic.internal.tagged_union_tag'
+"""
+Used in a `Tag` schema to specify the tag used for a discriminated union.
+"""
+HAS_INVALID_SCHEMAS_METADATA_KEY = 'pydantic.internal.invalid'
+"""Used to mark a schema that is invalid because it refers to a definition that was not yet defined when the
+schema was first encountered.
+"""
+
+
+def is_core_schema(
+    schema: CoreSchemaOrField,
+) -> TypeGuard[CoreSchema]:
+    return schema['type'] not in _CORE_SCHEMA_FIELD_TYPES
+
+
+def is_core_schema_field(
+    schema: CoreSchemaOrField,
+) -> TypeGuard[CoreSchemaField]:
+    return schema['type'] in _CORE_SCHEMA_FIELD_TYPES
+
+
+def is_function_with_inner_schema(
+    schema: CoreSchemaOrField,
+) -> TypeGuard[FunctionSchemaWithInnerSchema]:
+    return schema['type'] in _FUNCTION_WITH_INNER_SCHEMA_TYPES
+
+
+def is_list_like_schema_with_items_schema(
+    schema: CoreSchema,
+) -> TypeGuard[core_schema.ListSchema | core_schema.SetSchema | core_schema.FrozenSetSchema]:
+    return schema['type'] in _LIST_LIKE_SCHEMA_WITH_ITEMS_TYPES
+
+
+def get_type_ref(type_: type[Any], args_override: tuple[type[Any], ...] | None = None) -> str:
+    """Produces the ref to be used for this type by pydantic_core's core schemas.
+
+    This `args_override` argument was added for the purpose of creating valid recursive references
+    when creating generic models without needing to create a concrete class.
+    """
+    origin = get_origin(type_) or type_
+
+    args = get_args(type_) if is_generic_alias(type_) else (args_override or ())
+    generic_metadata = getattr(type_, '__pydantic_generic_metadata__', None)
+    if generic_metadata:
+        origin = generic_metadata['origin'] or origin
+        args = generic_metadata['args'] or args
+
+    module_name = getattr(origin, '__module__', '<No __module__>')
+    if isinstance(origin, TypeAliasType):
+        type_ref = f'{module_name}.{origin.__name__}:{id(origin)}'
+    else:
+        try:
+            qualname = getattr(origin, '__qualname__', f'<No __qualname__: {origin}>')
+        except Exception:
+            qualname = getattr(origin, '__qualname__', '<No __qualname__>')
+        type_ref = f'{module_name}.{qualname}:{id(origin)}'
+
+    arg_refs: list[str] = []
+    for arg in args:
+        if isinstance(arg, str):
+            # Handle string literals as a special case; we may be able to remove this special handling if we
+            # wrap them in a ForwardRef at some point.
+            arg_ref = f'{arg}:str-{id(arg)}'
+        else:
+            arg_ref = f'{_repr.display_as_type(arg)}:{id(arg)}'
+        arg_refs.append(arg_ref)
+    if arg_refs:
+        type_ref = f'{type_ref}[{",".join(arg_refs)}]'
+    return type_ref
+
+
+def get_ref(s: core_schema.CoreSchema) -> None | str:
+    """Get the ref from the schema if it has one.
+    This exists just for type checking to work correctly.
+    """
+    return s.get('ref', None)
+
+
+def collect_definitions(schema: core_schema.CoreSchema) -> dict[str, core_schema.CoreSchema]:
+    defs: dict[str, CoreSchema] = {}
+
+    def _record_valid_refs(s: core_schema.CoreSchema, recurse: Recurse) -> core_schema.CoreSchema:
+        ref = get_ref(s)
+        if ref:
+            defs[ref] = s
+        return recurse(s, _record_valid_refs)
+
+    walk_core_schema(schema, _record_valid_refs)
+
+    return defs
+
+
+def define_expected_missing_refs(
+    schema: core_schema.CoreSchema, allowed_missing_refs: set[str]
+) -> core_schema.CoreSchema | None:
+    if not allowed_missing_refs:
+        # in this case, there are no missing refs to potentially substitute, so there's no need to walk the schema
+        # this is a common case (will be hit for all non-generic models), so it's worth optimizing for
+        return None
+
+    refs = collect_definitions(schema).keys()
+
+    expected_missing_refs = allowed_missing_refs.difference(refs)
+    if expected_missing_refs:
+        definitions: list[core_schema.CoreSchema] = [
+            # TODO: Replace this with a (new) CoreSchema that, if present at any level, makes validation fail
+            #   Issue: https://github.com/pydantic/pydantic-core/issues/619
+            core_schema.none_schema(ref=ref, metadata={HAS_INVALID_SCHEMAS_METADATA_KEY: True})
+            for ref in expected_missing_refs
+        ]
+        return core_schema.definitions_schema(schema, definitions)
+    return None
+
+
+def collect_invalid_schemas(schema: core_schema.CoreSchema) -> bool:
+    invalid = False
+
+    def _is_schema_valid(s: core_schema.CoreSchema, recurse: Recurse) -> core_schema.CoreSchema:
+        nonlocal invalid
+        if 'metadata' in s:
+            metadata = s['metadata']
+            if HAS_INVALID_SCHEMAS_METADATA_KEY in metadata:
+                invalid = metadata[HAS_INVALID_SCHEMAS_METADATA_KEY]
+                return s
+        return recurse(s, _is_schema_valid)
+
+    walk_core_schema(schema, _is_schema_valid)
+    return invalid
+
+
+T = TypeVar('T')
+
+
+Recurse = Callable[[core_schema.CoreSchema, 'Walk'], core_schema.CoreSchema]
+Walk = Callable[[core_schema.CoreSchema, Recurse], core_schema.CoreSchema]
+
+# TODO: Should we move _WalkCoreSchema into pydantic_core proper?
+#   Issue: https://github.com/pydantic/pydantic-core/issues/615
+
+
+class _WalkCoreSchema:
+    def __init__(self):
+        self._schema_type_to_method = self._build_schema_type_to_method()
+
+    def _build_schema_type_to_method(self) -> dict[core_schema.CoreSchemaType, Recurse]:
+        mapping: dict[core_schema.CoreSchemaType, Recurse] = {}
+        key: core_schema.CoreSchemaType
+        for key in get_args(core_schema.CoreSchemaType):
+            method_name = f"handle_{key.replace('-', '_')}_schema"
+            mapping[key] = getattr(self, method_name, self._handle_other_schemas)
+        return mapping
+
+    def walk(self, schema: core_schema.CoreSchema, f: Walk) -> core_schema.CoreSchema:
+        return f(schema, self._walk)
+
+    def _walk(self, schema: core_schema.CoreSchema, f: Walk) -> core_schema.CoreSchema:
+        schema = self._schema_type_to_method[schema['type']](schema.copy(), f)
+        ser_schema: core_schema.SerSchema | None = schema.get('serialization')  # type: ignore
+        if ser_schema:
+            schema['serialization'] = self._handle_ser_schemas(ser_schema, f)
+        return schema
+
+    def _handle_other_schemas(self, schema: core_schema.CoreSchema, f: Walk) -> core_schema.CoreSchema:
+        sub_schema = schema.get('schema', None)
+        if sub_schema is not None:
+            schema['schema'] = self.walk(sub_schema, f)  # type: ignore
+        return schema
+
+    def _handle_ser_schemas(self, ser_schema: core_schema.SerSchema, f: Walk) -> core_schema.SerSchema:
+        schema: core_schema.CoreSchema | None = ser_schema.get('schema', None)
+        if schema is not None:
+            ser_schema['schema'] = self.walk(schema, f)  # type: ignore
+        return_schema: core_schema.CoreSchema | None = ser_schema.get('return_schema', None)
+        if return_schema is not None:
+            ser_schema['return_schema'] = self.walk(return_schema, f)  # type: ignore
+        return ser_schema
+
+    def handle_definitions_schema(self, schema: core_schema.DefinitionsSchema, f: Walk) -> core_schema.CoreSchema:
+        new_definitions: list[core_schema.CoreSchema] = []
+        for definition in schema['definitions']:
+            if 'schema_ref' in definition and 'ref' in definition:
+                # This indicates a purposely indirect reference
+                # We want to keep such references around for implications related to JSON schema, etc.:
+                new_definitions.append(definition)
+                # However, we still need to walk the referenced definition:
+                self.walk(definition, f)
+                continue
+
+            updated_definition = self.walk(definition, f)
+            if 'ref' in updated_definition:
+                # If the updated definition schema doesn't have a 'ref', it shouldn't go in the definitions
+                # This is most likely to happen due to replacing something with a definition reference, in
+                # which case it should certainly not go in the definitions list
+                new_definitions.append(updated_definition)
+        new_inner_schema = self.walk(schema['schema'], f)
+
+        if not new_definitions and len(schema) == 3:
+            # This means we'd be returning a "trivial" definitions schema that just wrapped the inner schema
+            return new_inner_schema
+
+        new_schema = schema.copy()
+        new_schema['schema'] = new_inner_schema
+        new_schema['definitions'] = new_definitions
+        return new_schema
+
+    def handle_list_schema(self, schema: core_schema.ListSchema, f: Walk) -> core_schema.CoreSchema:
+        items_schema = schema.get('items_schema')
+        if items_schema is not None:
+            schema['items_schema'] = self.walk(items_schema, f)
+        return schema
+
+    def handle_set_schema(self, schema: core_schema.SetSchema, f: Walk) -> core_schema.CoreSchema:
+        items_schema = schema.get('items_schema')
+        if items_schema is not None:
+            schema['items_schema'] = self.walk(items_schema, f)
+        return schema
+
+    def handle_frozenset_schema(self, schema: core_schema.FrozenSetSchema, f: Walk) -> core_schema.CoreSchema:
+        items_schema = schema.get('items_schema')
+        if items_schema is not None:
+            schema['items_schema'] = self.walk(items_schema, f)
+        return schema
+
+    def handle_generator_schema(self, schema: core_schema.GeneratorSchema, f: Walk) -> core_schema.CoreSchema:
+        items_schema = schema.get('items_schema')
+        if items_schema is not None:
+            schema['items_schema'] = self.walk(items_schema, f)
+        return schema
+
+    def handle_tuple_schema(self, schema: core_schema.TupleSchema, f: Walk) -> core_schema.CoreSchema:
+        schema['items_schema'] = [self.walk(v, f) for v in schema['items_schema']]
+        return schema
+
+    def handle_dict_schema(self, schema: core_schema.DictSchema, f: Walk) -> core_schema.CoreSchema:
+        keys_schema = schema.get('keys_schema')
+        if keys_schema is not None:
+            schema['keys_schema'] = self.walk(keys_schema, f)
+        values_schema = schema.get('values_schema')
+        if values_schema:
+            schema['values_schema'] = self.walk(values_schema, f)
+        return schema
+
+    def handle_function_schema(self, schema: AnyFunctionSchema, f: Walk) -> core_schema.CoreSchema:
+        if not is_function_with_inner_schema(schema):
+            return schema
+        schema['schema'] = self.walk(schema['schema'], f)
+        return schema
+
+    def handle_union_schema(self, schema: core_schema.UnionSchema, f: Walk) -> core_schema.CoreSchema:
+        new_choices: list[CoreSchema | tuple[CoreSchema, str]] = []
+        for v in schema['choices']:
+            if isinstance(v, tuple):
+                new_choices.append((self.walk(v[0], f), v[1]))
+            else:
+                new_choices.append(self.walk(v, f))
+        schema['choices'] = new_choices
+        return schema
+
+    def handle_tagged_union_schema(self, schema: core_schema.TaggedUnionSchema, f: Walk) -> core_schema.CoreSchema:
+        new_choices: dict[Hashable, core_schema.CoreSchema] = {}
+        for k, v in schema['choices'].items():
+            new_choices[k] = v if isinstance(v, (str, int)) else self.walk(v, f)
+        schema['choices'] = new_choices
+        return schema
+
+    def handle_chain_schema(self, schema: core_schema.ChainSchema, f: Walk) -> core_schema.CoreSchema:
+        schema['steps'] = [self.walk(v, f) for v in schema['steps']]
+        return schema
+
+    def handle_lax_or_strict_schema(self, schema: core_schema.LaxOrStrictSchema, f: Walk) -> core_schema.CoreSchema:
+        schema['lax_schema'] = self.walk(schema['lax_schema'], f)
+        schema['strict_schema'] = self.walk(schema['strict_schema'], f)
+        return schema
+
+    def handle_json_or_python_schema(self, schema: core_schema.JsonOrPythonSchema, f: Walk) -> core_schema.CoreSchema:
+        schema['json_schema'] = self.walk(schema['json_schema'], f)
+        schema['python_schema'] = self.walk(schema['python_schema'], f)
+        return schema
+
+    def handle_model_fields_schema(self, schema: core_schema.ModelFieldsSchema, f: Walk) -> core_schema.CoreSchema:
+        extras_schema = schema.get('extras_schema')
+        if extras_schema is not None:
+            schema['extras_schema'] = self.walk(extras_schema, f)
+        replaced_fields: dict[str, core_schema.ModelField] = {}
+        replaced_computed_fields: list[core_schema.ComputedField] = []
+        for computed_field in schema.get('computed_fields', ()):
+            replaced_field = computed_field.copy()
+            replaced_field['return_schema'] = self.walk(computed_field['return_schema'], f)
+            replaced_computed_fields.append(replaced_field)
+        if replaced_computed_fields:
+            schema['computed_fields'] = replaced_computed_fields
+        for k, v in schema['fields'].items():
+            replaced_field = v.copy()
+            replaced_field['schema'] = self.walk(v['schema'], f)
+            replaced_fields[k] = replaced_field
+        schema['fields'] = replaced_fields
+        return schema
+
+    def handle_typed_dict_schema(self, schema: core_schema.TypedDictSchema, f: Walk) -> core_schema.CoreSchema:
+        extras_schema = schema.get('extras_schema')
+        if extras_schema is not None:
+            schema['extras_schema'] = self.walk(extras_schema, f)
+        replaced_computed_fields: list[core_schema.ComputedField] = []
+        for computed_field in schema.get('computed_fields', ()):
+            replaced_field = computed_field.copy()
+            replaced_field['return_schema'] = self.walk(computed_field['return_schema'], f)
+            replaced_computed_fields.append(replaced_field)
+        if replaced_computed_fields:
+            schema['computed_fields'] = replaced_computed_fields
+        replaced_fields: dict[str, core_schema.TypedDictField] = {}
+        for k, v in schema['fields'].items():
+            replaced_field = v.copy()
+            replaced_field['schema'] = self.walk(v['schema'], f)
+            replaced_fields[k] = replaced_field
+        schema['fields'] = replaced_fields
+        return schema
+
+    def handle_dataclass_args_schema(self, schema: core_schema.DataclassArgsSchema, f: Walk) -> core_schema.CoreSchema:
+        replaced_fields: list[core_schema.DataclassField] = []
+        replaced_computed_fields: list[core_schema.ComputedField] = []
+        for computed_field in schema.get('computed_fields', ()):
+            replaced_field = computed_field.copy()
+            replaced_field['return_schema'] = self.walk(computed_field['return_schema'], f)
+            replaced_computed_fields.append(replaced_field)
+        if replaced_computed_fields:
+            schema['computed_fields'] = replaced_computed_fields
+        for field in schema['fields']:
+            replaced_field = field.copy()
+            replaced_field['schema'] = self.walk(field['schema'], f)
+            replaced_fields.append(replaced_field)
+        schema['fields'] = replaced_fields
+        return schema
+
+    def handle_arguments_schema(self, schema: core_schema.ArgumentsSchema, f: Walk) -> core_schema.CoreSchema:
+        replaced_arguments_schema: list[core_schema.ArgumentsParameter] = []
+        for param in schema['arguments_schema']:
+            replaced_param = param.copy()
+            replaced_param['schema'] = self.walk(param['schema'], f)
+            replaced_arguments_schema.append(replaced_param)
+        schema['arguments_schema'] = replaced_arguments_schema
+        if 'var_args_schema' in schema:
+            schema['var_args_schema'] = self.walk(schema['var_args_schema'], f)
+        if 'var_kwargs_schema' in schema:
+            schema['var_kwargs_schema'] = self.walk(schema['var_kwargs_schema'], f)
+        return schema
+
+    def handle_call_schema(self, schema: core_schema.CallSchema, f: Walk) -> core_schema.CoreSchema:
+        schema['arguments_schema'] = self.walk(schema['arguments_schema'], f)
+        if 'return_schema' in schema:
+            schema['return_schema'] = self.walk(schema['return_schema'], f)
+        return schema
+
+
+_dispatch = _WalkCoreSchema().walk
+
+
+def walk_core_schema(schema: core_schema.CoreSchema, f: Walk) -> core_schema.CoreSchema:
+    """Recursively traverse a CoreSchema.
+
+    Args:
+        schema (core_schema.CoreSchema): The CoreSchema to process, it will not be modified.
+        f (Walk): A function to apply. This function takes two arguments:
+          1. The current CoreSchema that is being processed
+             (not the same one you passed into this function, one level down).
+          2. The "next" `f` to call. This lets you for example use `f=functools.partial(some_method, some_context)`
+             to pass data down the recursive calls without using globals or other mutable state.
+
+    Returns:
+        core_schema.CoreSchema: A processed CoreSchema.
+    """
+    return f(schema.copy(), _dispatch)
+
+
+def simplify_schema_references(schema: core_schema.CoreSchema) -> core_schema.CoreSchema:  # noqa: C901
+    definitions: dict[str, core_schema.CoreSchema] = {}
+    ref_counts: dict[str, int] = defaultdict(int)
+    involved_in_recursion: dict[str, bool] = {}
+    current_recursion_ref_count: dict[str, int] = defaultdict(int)
+
+    def collect_refs(s: core_schema.CoreSchema, recurse: Recurse) -> core_schema.CoreSchema:
+        if s['type'] == 'definitions':
+            for definition in s['definitions']:
+                ref = get_ref(definition)
+                assert ref is not None
+                if ref not in definitions:
+                    definitions[ref] = definition
+                recurse(definition, collect_refs)
+            return recurse(s['schema'], collect_refs)
+        else:
+            ref = get_ref(s)
+            if ref is not None:
+                new = recurse(s, collect_refs)
+                new_ref = get_ref(new)
+                if new_ref:
+                    definitions[new_ref] = new
+                return core_schema.definition_reference_schema(schema_ref=ref)
+            else:
+                return recurse(s, collect_refs)
+
+    schema = walk_core_schema(schema, collect_refs)
+
+    def count_refs(s: core_schema.CoreSchema, recurse: Recurse) -> core_schema.CoreSchema:
+        if s['type'] != 'definition-ref':
+            return recurse(s, count_refs)
+        ref = s['schema_ref']
+        ref_counts[ref] += 1
+
+        if ref_counts[ref] >= 2:
+            # If this model is involved in a recursion this should be detected
+            # on its second encounter, we can safely stop the walk here.
+            if current_recursion_ref_count[ref] != 0:
+                involved_in_recursion[ref] = True
+            return s
+
+        current_recursion_ref_count[ref] += 1
+        recurse(definitions[ref], count_refs)
+        current_recursion_ref_count[ref] -= 1
+        return s
+
+    schema = walk_core_schema(schema, count_refs)
+
+    assert all(c == 0 for c in current_recursion_ref_count.values()), 'this is a bug! please report it'
+
+    def can_be_inlined(s: core_schema.DefinitionReferenceSchema, ref: str) -> bool:
+        if ref_counts[ref] > 1:
+            return False
+        if involved_in_recursion.get(ref, False):
+            return False
+        if 'serialization' in s:
+            return False
+        if 'metadata' in s:
+            metadata = s['metadata']
+            for k in (
+                'pydantic_js_functions',
+                'pydantic_js_annotation_functions',
+                'pydantic.internal.union_discriminator',
+            ):
+                if k in metadata:
+                    # we need to keep this as a ref
+                    return False
+        return True
+
+    def inline_refs(s: core_schema.CoreSchema, recurse: Recurse) -> core_schema.CoreSchema:
+        if s['type'] == 'definition-ref':
+            ref = s['schema_ref']
+            # Check if the reference is only used once, not involved in recursion and does not have
+            # any extra keys (like 'serialization')
+            if can_be_inlined(s, ref):
+                # Inline the reference by replacing the reference with the actual schema
+                new = definitions.pop(ref)
+                ref_counts[ref] -= 1  # because we just replaced it!
+                # put all other keys that were on the def-ref schema into the inlined version
+                # in particular this is needed for `serialization`
+                if 'serialization' in s:
+                    new['serialization'] = s['serialization']
+                s = recurse(new, inline_refs)
+                return s
+            else:
+                return recurse(s, inline_refs)
+        else:
+            return recurse(s, inline_refs)
+
+    schema = walk_core_schema(schema, inline_refs)
+
+    def_values = [v for v in definitions.values() if ref_counts[v['ref']] > 0]  # type: ignore
+
+    if def_values:
+        schema = core_schema.definitions_schema(schema=schema, definitions=def_values)
+    return schema
+
+
+def _strip_metadata(schema: CoreSchema) -> CoreSchema:
+    def strip_metadata(s: CoreSchema, recurse: Recurse) -> CoreSchema:
+        s = s.copy()
+        s.pop('metadata', None)
+        if s['type'] == 'model-fields':
+            s = s.copy()
+            s['fields'] = {k: v.copy() for k, v in s['fields'].items()}
+            for field_name, field_schema in s['fields'].items():
+                field_schema.pop('metadata', None)
+                s['fields'][field_name] = field_schema
+            computed_fields = s.get('computed_fields', None)
+            if computed_fields:
+                s['computed_fields'] = [cf.copy() for cf in computed_fields]
+                for cf in computed_fields:
+                    cf.pop('metadata', None)
+            else:
+                s.pop('computed_fields', None)
+        elif s['type'] == 'model':
+            # remove some defaults
+            if s.get('custom_init', True) is False:
+                s.pop('custom_init')
+            if s.get('root_model', True) is False:
+                s.pop('root_model')
+            if {'title'}.issuperset(s.get('config', {}).keys()):
+                s.pop('config', None)
+
+        return recurse(s, strip_metadata)
+
+    return walk_core_schema(schema, strip_metadata)
+
+
+def pretty_print_core_schema(
+    schema: CoreSchema,
+    include_metadata: bool = False,
+) -> None:
+    """Pretty print a CoreSchema using rich.
+    This is intended for debugging purposes.
+
+    Args:
+        schema: The CoreSchema to print.
+        include_metadata: Whether to include metadata in the output. Defaults to `False`.
+    """
+    from rich import print  # type: ignore  # install it manually in your dev env
+
+    if not include_metadata:
+        schema = _strip_metadata(schema)
+
+    return print(schema)
+
+
+def validate_core_schema(schema: CoreSchema) -> CoreSchema:
+    if 'PYDANTIC_SKIP_VALIDATING_CORE_SCHEMAS' in os.environ:
+        return schema
+    return _validate_core_schema(schema)
diff --git a/lib/pydantic/_internal/_dataclasses.py b/lib/pydantic/_internal/_dataclasses.py
new file mode 100644
index 00000000..1ec23044
--- /dev/null
+++ b/lib/pydantic/_internal/_dataclasses.py
@@ -0,0 +1,225 @@
+"""Private logic for creating pydantic dataclasses."""
+from __future__ import annotations as _annotations
+
+import dataclasses
+import typing
+import warnings
+from functools import partial, wraps
+from typing import Any, Callable, ClassVar
+
+from pydantic_core import (
+    ArgsKwargs,
+    SchemaSerializer,
+    SchemaValidator,
+    core_schema,
+)
+from typing_extensions import TypeGuard
+
+from ..errors import PydanticUndefinedAnnotation
+from ..fields import FieldInfo
+from ..plugin._schema_validator import create_schema_validator
+from ..warnings import PydanticDeprecatedSince20
+from . import _config, _decorators, _typing_extra
+from ._fields import collect_dataclass_fields
+from ._generate_schema import GenerateSchema
+from ._generics import get_standard_typevars_map
+from ._mock_val_ser import set_dataclass_mocks
+from ._schema_generation_shared import CallbackGetCoreSchemaHandler
+from ._signature import generate_pydantic_signature
+
+if typing.TYPE_CHECKING:
+    from ..config import ConfigDict
+
+    class StandardDataclass(typing.Protocol):
+        __dataclass_fields__: ClassVar[dict[str, Any]]
+        __dataclass_params__: ClassVar[Any]  # in reality `dataclasses._DataclassParams`
+        __post_init__: ClassVar[Callable[..., None]]
+
+        def __init__(self, *args: object, **kwargs: object) -> None:
+            pass
+
+    class PydanticDataclass(StandardDataclass, typing.Protocol):
+        """A protocol containing attributes only available once a class has been decorated as a Pydantic dataclass.
+
+        Attributes:
+            __pydantic_config__: Pydantic-specific configuration settings for the dataclass.
+            __pydantic_complete__: Whether dataclass building is completed, or if there are still undefined fields.
+            __pydantic_core_schema__: The pydantic-core schema used to build the SchemaValidator and SchemaSerializer.
+            __pydantic_decorators__: Metadata containing the decorators defined on the dataclass.
+            __pydantic_fields__: Metadata about the fields defined on the dataclass.
+            __pydantic_serializer__: The pydantic-core SchemaSerializer used to dump instances of the dataclass.
+            __pydantic_validator__: The pydantic-core SchemaValidator used to validate instances of the dataclass.
+        """
+
+        __pydantic_config__: ClassVar[ConfigDict]
+        __pydantic_complete__: ClassVar[bool]
+        __pydantic_core_schema__: ClassVar[core_schema.CoreSchema]
+        __pydantic_decorators__: ClassVar[_decorators.DecoratorInfos]
+        __pydantic_fields__: ClassVar[dict[str, FieldInfo]]
+        __pydantic_serializer__: ClassVar[SchemaSerializer]
+        __pydantic_validator__: ClassVar[SchemaValidator]
+
+else:
+    # See PyCharm issues https://youtrack.jetbrains.com/issue/PY-21915
+    # and https://youtrack.jetbrains.com/issue/PY-51428
+    DeprecationWarning = PydanticDeprecatedSince20
+
+
+def set_dataclass_fields(cls: type[StandardDataclass], types_namespace: dict[str, Any] | None = None) -> None:
+    """Collect and set `cls.__pydantic_fields__`.
+
+    Args:
+        cls: The class.
+        types_namespace: The types namespace, defaults to `None`.
+    """
+    typevars_map = get_standard_typevars_map(cls)
+    fields = collect_dataclass_fields(cls, types_namespace, typevars_map=typevars_map)
+
+    cls.__pydantic_fields__ = fields  # type: ignore
+
+
+def complete_dataclass(
+    cls: type[Any],
+    config_wrapper: _config.ConfigWrapper,
+    *,
+    raise_errors: bool = True,
+    types_namespace: dict[str, Any] | None,
+) -> bool:
+    """Finish building a pydantic dataclass.
+
+    This logic is called on a class which has already been wrapped in `dataclasses.dataclass()`.
+
+    This is somewhat analogous to `pydantic._internal._model_construction.complete_model_class`.
+
+    Args:
+        cls: The class.
+        config_wrapper: The config wrapper instance.
+        raise_errors: Whether to raise errors, defaults to `True`.
+        types_namespace: The types namespace.
+
+    Returns:
+        `True` if building a pydantic dataclass is successfully completed, `False` otherwise.
+
+    Raises:
+        PydanticUndefinedAnnotation: If `raise_error` is `True` and there is an undefined annotations.
+    """
+    if hasattr(cls, '__post_init_post_parse__'):
+        warnings.warn(
+            'Support for `__post_init_post_parse__` has been dropped, the method will not be called', DeprecationWarning
+        )
+
+    if types_namespace is None:
+        types_namespace = _typing_extra.get_cls_types_namespace(cls)
+
+    set_dataclass_fields(cls, types_namespace)
+
+    typevars_map = get_standard_typevars_map(cls)
+    gen_schema = GenerateSchema(
+        config_wrapper,
+        types_namespace,
+        typevars_map,
+    )
+
+    # This needs to be called before we change the __init__
+    sig = generate_pydantic_signature(
+        init=cls.__init__,
+        fields=cls.__pydantic_fields__,  # type: ignore
+        config_wrapper=config_wrapper,
+        is_dataclass=True,
+    )
+
+    # dataclass.__init__ must be defined here so its `__qualname__` can be changed since functions can't be copied.
+    def __init__(__dataclass_self__: PydanticDataclass, *args: Any, **kwargs: Any) -> None:
+        __tracebackhide__ = True
+        s = __dataclass_self__
+        s.__pydantic_validator__.validate_python(ArgsKwargs(args, kwargs), self_instance=s)
+
+    __init__.__qualname__ = f'{cls.__qualname__}.__init__'
+
+    cls.__init__ = __init__  # type: ignore
+    cls.__pydantic_config__ = config_wrapper.config_dict  # type: ignore
+    cls.__signature__ = sig  # type: ignore
+    get_core_schema = getattr(cls, '__get_pydantic_core_schema__', None)
+    try:
+        if get_core_schema:
+            schema = get_core_schema(
+                cls,
+                CallbackGetCoreSchemaHandler(
+                    partial(gen_schema.generate_schema, from_dunder_get_core_schema=False),
+                    gen_schema,
+                    ref_mode='unpack',
+                ),
+            )
+        else:
+            schema = gen_schema.generate_schema(cls, from_dunder_get_core_schema=False)
+    except PydanticUndefinedAnnotation as e:
+        if raise_errors:
+            raise
+        set_dataclass_mocks(cls, cls.__name__, f'`{e.name}`')
+        return False
+
+    core_config = config_wrapper.core_config(cls)
+
+    try:
+        schema = gen_schema.clean_schema(schema)
+    except gen_schema.CollectedInvalid:
+        set_dataclass_mocks(cls, cls.__name__, 'all referenced types')
+        return False
+
+    # We are about to set all the remaining required properties expected for this cast;
+    # __pydantic_decorators__ and __pydantic_fields__ should already be set
+    cls = typing.cast('type[PydanticDataclass]', cls)
+    # debug(schema)
+
+    cls.__pydantic_core_schema__ = schema
+    cls.__pydantic_validator__ = validator = create_schema_validator(
+        schema, cls, cls.__module__, cls.__qualname__, 'dataclass', core_config, config_wrapper.plugin_settings
+    )
+    cls.__pydantic_serializer__ = SchemaSerializer(schema, core_config)
+
+    if config_wrapper.validate_assignment:
+
+        @wraps(cls.__setattr__)
+        def validated_setattr(instance: Any, __field: str, __value: str) -> None:
+            validator.validate_assignment(instance, __field, __value)
+
+        cls.__setattr__ = validated_setattr.__get__(None, cls)  # type: ignore
+
+    return True
+
+
+def is_builtin_dataclass(_cls: type[Any]) -> TypeGuard[type[StandardDataclass]]:
+    """Returns True if a class is a stdlib dataclass and *not* a pydantic dataclass.
+
+    We check that
+    - `_cls` is a dataclass
+    - `_cls` does not inherit from a processed pydantic dataclass (and thus have a `__pydantic_validator__`)
+    - `_cls` does not have any annotations that are not dataclass fields
+    e.g.
+    ```py
+    import dataclasses
+
+    import pydantic.dataclasses
+
+    @dataclasses.dataclass
+    class A:
+        x: int
+
+    @pydantic.dataclasses.dataclass
+    class B(A):
+        y: int
+    ```
+    In this case, when we first check `B`, we make an extra check and look at the annotations ('y'),
+    which won't be a superset of all the dataclass fields (only the stdlib fields i.e. 'x')
+
+    Args:
+        cls: The class.
+
+    Returns:
+        `True` if the class is a stdlib dataclass, `False` otherwise.
+    """
+    return (
+        dataclasses.is_dataclass(_cls)
+        and not hasattr(_cls, '__pydantic_validator__')
+        and set(_cls.__dataclass_fields__).issuperset(set(getattr(_cls, '__annotations__', {})))
+    )
diff --git a/lib/pydantic/_internal/_decorators.py b/lib/pydantic/_internal/_decorators.py
new file mode 100644
index 00000000..5672464c
--- /dev/null
+++ b/lib/pydantic/_internal/_decorators.py
@@ -0,0 +1,791 @@
+"""Logic related to validators applied to models etc. via the `@field_validator` and `@model_validator` decorators."""
+from __future__ import annotations as _annotations
+
+from collections import deque
+from dataclasses import dataclass, field
+from functools import cached_property, partial, partialmethod
+from inspect import Parameter, Signature, isdatadescriptor, ismethoddescriptor, signature
+from itertools import islice
+from typing import TYPE_CHECKING, Any, Callable, ClassVar, Generic, Iterable, TypeVar, Union
+
+from pydantic_core import PydanticUndefined, core_schema
+from typing_extensions import Literal, TypeAlias, is_typeddict
+
+from ..errors import PydanticUserError
+from ._core_utils import get_type_ref
+from ._internal_dataclass import slots_true
+from ._typing_extra import get_function_type_hints
+
+if TYPE_CHECKING:
+    from ..fields import ComputedFieldInfo
+    from ..functional_validators import FieldValidatorModes
+
+
+@dataclass(**slots_true)
+class ValidatorDecoratorInfo:
+    """A container for data from `@validator` so that we can access it
+    while building the pydantic-core schema.
+
+    Attributes:
+        decorator_repr: A class variable representing the decorator string, '@validator'.
+        fields: A tuple of field names the validator should be called on.
+        mode: The proposed validator mode.
+        each_item: For complex objects (sets, lists etc.) whether to validate individual
+            elements rather than the whole object.
+        always: Whether this method and other validators should be called even if the value is missing.
+        check_fields: Whether to check that the fields actually exist on the model.
+    """
+
+    decorator_repr: ClassVar[str] = '@validator'
+
+    fields: tuple[str, ...]
+    mode: Literal['before', 'after']
+    each_item: bool
+    always: bool
+    check_fields: bool | None
+
+
+@dataclass(**slots_true)
+class FieldValidatorDecoratorInfo:
+    """A container for data from `@field_validator` so that we can access it
+    while building the pydantic-core schema.
+
+    Attributes:
+        decorator_repr: A class variable representing the decorator string, '@field_validator'.
+        fields: A tuple of field names the validator should be called on.
+        mode: The proposed validator mode.
+        check_fields: Whether to check that the fields actually exist on the model.
+    """
+
+    decorator_repr: ClassVar[str] = '@field_validator'
+
+    fields: tuple[str, ...]
+    mode: FieldValidatorModes
+    check_fields: bool | None
+
+
+@dataclass(**slots_true)
+class RootValidatorDecoratorInfo:
+    """A container for data from `@root_validator` so that we can access it
+    while building the pydantic-core schema.
+
+    Attributes:
+        decorator_repr: A class variable representing the decorator string, '@root_validator'.
+        mode: The proposed validator mode.
+    """
+
+    decorator_repr: ClassVar[str] = '@root_validator'
+    mode: Literal['before', 'after']
+
+
+@dataclass(**slots_true)
+class FieldSerializerDecoratorInfo:
+    """A container for data from `@field_serializer` so that we can access it
+    while building the pydantic-core schema.
+
+    Attributes:
+        decorator_repr: A class variable representing the decorator string, '@field_serializer'.
+        fields: A tuple of field names the serializer should be called on.
+        mode: The proposed serializer mode.
+        return_type: The type of the serializer's return value.
+        when_used: The serialization condition. Accepts a string with values `'always'`, `'unless-none'`, `'json'`,
+            and `'json-unless-none'`.
+        check_fields: Whether to check that the fields actually exist on the model.
+    """
+
+    decorator_repr: ClassVar[str] = '@field_serializer'
+    fields: tuple[str, ...]
+    mode: Literal['plain', 'wrap']
+    return_type: Any
+    when_used: core_schema.WhenUsed
+    check_fields: bool | None
+
+
+@dataclass(**slots_true)
+class ModelSerializerDecoratorInfo:
+    """A container for data from `@model_serializer` so that we can access it
+    while building the pydantic-core schema.
+
+    Attributes:
+        decorator_repr: A class variable representing the decorator string, '@model_serializer'.
+        mode: The proposed serializer mode.
+        return_type: The type of the serializer's return value.
+        when_used: The serialization condition. Accepts a string with values `'always'`, `'unless-none'`, `'json'`,
+            and `'json-unless-none'`.
+    """
+
+    decorator_repr: ClassVar[str] = '@model_serializer'
+    mode: Literal['plain', 'wrap']
+    return_type: Any
+    when_used: core_schema.WhenUsed
+
+
+@dataclass(**slots_true)
+class ModelValidatorDecoratorInfo:
+    """A container for data from `@model_validator` so that we can access it
+    while building the pydantic-core schema.
+
+    Attributes:
+        decorator_repr: A class variable representing the decorator string, '@model_serializer'.
+        mode: The proposed serializer mode.
+    """
+
+    decorator_repr: ClassVar[str] = '@model_validator'
+    mode: Literal['wrap', 'before', 'after']
+
+
+DecoratorInfo: TypeAlias = """Union[
+    ValidatorDecoratorInfo,
+    FieldValidatorDecoratorInfo,
+    RootValidatorDecoratorInfo,
+    FieldSerializerDecoratorInfo,
+    ModelSerializerDecoratorInfo,
+    ModelValidatorDecoratorInfo,
+    ComputedFieldInfo,
+]"""
+
+ReturnType = TypeVar('ReturnType')
+DecoratedType: TypeAlias = (
+    'Union[classmethod[Any, Any, ReturnType], staticmethod[Any, ReturnType], Callable[..., ReturnType], property]'
+)
+
+
+@dataclass  # can't use slots here since we set attributes on `__post_init__`
+class PydanticDescriptorProxy(Generic[ReturnType]):
+    """Wrap a classmethod, staticmethod, property or unbound function
+    and act as a descriptor that allows us to detect decorated items
+    from the class' attributes.
+
+    This class' __get__ returns the wrapped item's __get__ result,
+    which makes it transparent for classmethods and staticmethods.
+
+    Attributes:
+        wrapped: The decorator that has to be wrapped.
+        decorator_info: The decorator info.
+        shim: A wrapper function to wrap V1 style function.
+    """
+
+    wrapped: DecoratedType[ReturnType]
+    decorator_info: DecoratorInfo
+    shim: Callable[[Callable[..., Any]], Callable[..., Any]] | None = None
+
+    def __post_init__(self):
+        for attr in 'setter', 'deleter':
+            if hasattr(self.wrapped, attr):
+                f = partial(self._call_wrapped_attr, name=attr)
+                setattr(self, attr, f)
+
+    def _call_wrapped_attr(self, func: Callable[[Any], None], *, name: str) -> PydanticDescriptorProxy[ReturnType]:
+        self.wrapped = getattr(self.wrapped, name)(func)
+        return self
+
+    def __get__(self, obj: object | None, obj_type: type[object] | None = None) -> PydanticDescriptorProxy[ReturnType]:
+        try:
+            return self.wrapped.__get__(obj, obj_type)
+        except AttributeError:
+            # not a descriptor, e.g. a partial object
+            return self.wrapped  # type: ignore[return-value]
+
+    def __set_name__(self, instance: Any, name: str) -> None:
+        if hasattr(self.wrapped, '__set_name__'):
+            self.wrapped.__set_name__(instance, name)  # pyright: ignore[reportFunctionMemberAccess]
+
+    def __getattr__(self, __name: str) -> Any:
+        """Forward checks for __isabstractmethod__ and such."""
+        return getattr(self.wrapped, __name)
+
+
+DecoratorInfoType = TypeVar('DecoratorInfoType', bound=DecoratorInfo)
+
+
+@dataclass(**slots_true)
+class Decorator(Generic[DecoratorInfoType]):
+    """A generic container class to join together the decorator metadata
+    (metadata from decorator itself, which we have when the
+    decorator is called but not when we are building the core-schema)
+    and the bound function (which we have after the class itself is created).
+
+    Attributes:
+        cls_ref: The class ref.
+        cls_var_name: The decorated function name.
+        func: The decorated function.
+        shim: A wrapper function to wrap V1 style function.
+        info: The decorator info.
+    """
+
+    cls_ref: str
+    cls_var_name: str
+    func: Callable[..., Any]
+    shim: Callable[[Any], Any] | None
+    info: DecoratorInfoType
+
+    @staticmethod
+    def build(
+        cls_: Any,
+        *,
+        cls_var_name: str,
+        shim: Callable[[Any], Any] | None,
+        info: DecoratorInfoType,
+    ) -> Decorator[DecoratorInfoType]:
+        """Build a new decorator.
+
+        Args:
+            cls_: The class.
+            cls_var_name: The decorated function name.
+            shim: A wrapper function to wrap V1 style function.
+            info: The decorator info.
+
+        Returns:
+            The new decorator instance.
+        """
+        func = get_attribute_from_bases(cls_, cls_var_name)
+        if shim is not None:
+            func = shim(func)
+        func = unwrap_wrapped_function(func, unwrap_partial=False)
+        if not callable(func):
+            # This branch will get hit for classmethod properties
+            attribute = get_attribute_from_base_dicts(cls_, cls_var_name)  # prevents the binding call to `__get__`
+            if isinstance(attribute, PydanticDescriptorProxy):
+                func = unwrap_wrapped_function(attribute.wrapped)
+        return Decorator(
+            cls_ref=get_type_ref(cls_),
+            cls_var_name=cls_var_name,
+            func=func,
+            shim=shim,
+            info=info,
+        )
+
+    def bind_to_cls(self, cls: Any) -> Decorator[DecoratorInfoType]:
+        """Bind the decorator to a class.
+
+        Args:
+            cls: the class.
+
+        Returns:
+            The new decorator instance.
+        """
+        return self.build(
+            cls,
+            cls_var_name=self.cls_var_name,
+            shim=self.shim,
+            info=self.info,
+        )
+
+
+def get_bases(tp: type[Any]) -> tuple[type[Any], ...]:
+    """Get the base classes of a class or typeddict.
+
+    Args:
+        tp: The type or class to get the bases.
+
+    Returns:
+        The base classes.
+    """
+    if is_typeddict(tp):
+        return tp.__orig_bases__  # type: ignore
+    try:
+        return tp.__bases__
+    except AttributeError:
+        return ()
+
+
+def mro(tp: type[Any]) -> tuple[type[Any], ...]:
+    """Calculate the Method Resolution Order of bases using the C3 algorithm.
+
+    See https://www.python.org/download/releases/2.3/mro/
+    """
+    # try to use the existing mro, for performance mainly
+    # but also because it helps verify the implementation below
+    if not is_typeddict(tp):
+        try:
+            return tp.__mro__
+        except AttributeError:
+            # GenericAlias and some other cases
+            pass
+
+    bases = get_bases(tp)
+    return (tp,) + mro_for_bases(bases)
+
+
+def mro_for_bases(bases: tuple[type[Any], ...]) -> tuple[type[Any], ...]:
+    def merge_seqs(seqs: list[deque[type[Any]]]) -> Iterable[type[Any]]:
+        while True:
+            non_empty = [seq for seq in seqs if seq]
+            if not non_empty:
+                # Nothing left to process, we're done.
+                return
+            candidate: type[Any] | None = None
+            for seq in non_empty:  # Find merge candidates among seq heads.
+                candidate = seq[0]
+                not_head = [s for s in non_empty if candidate in islice(s, 1, None)]
+                if not_head:
+                    # Reject the candidate.
+                    candidate = None
+                else:
+                    break
+            if not candidate:
+                raise TypeError('Inconsistent hierarchy, no C3 MRO is possible')
+            yield candidate
+            for seq in non_empty:
+                # Remove candidate.
+                if seq[0] == candidate:
+                    seq.popleft()
+
+    seqs = [deque(mro(base)) for base in bases] + [deque(bases)]
+    return tuple(merge_seqs(seqs))
+
+
+_sentinel = object()
+
+
+def get_attribute_from_bases(tp: type[Any] | tuple[type[Any], ...], name: str) -> Any:
+    """Get the attribute from the next class in the MRO that has it,
+    aiming to simulate calling the method on the actual class.
+
+    The reason for iterating over the mro instead of just getting
+    the attribute (which would do that for us) is to support TypedDict,
+    which lacks a real __mro__, but can have a virtual one constructed
+    from its bases (as done here).
+
+    Args:
+        tp: The type or class to search for the attribute. If a tuple, this is treated as a set of base classes.
+        name: The name of the attribute to retrieve.
+
+    Returns:
+        Any: The attribute value, if found.
+
+    Raises:
+        AttributeError: If the attribute is not found in any class in the MRO.
+    """
+    if isinstance(tp, tuple):
+        for base in mro_for_bases(tp):
+            attribute = base.__dict__.get(name, _sentinel)
+            if attribute is not _sentinel:
+                attribute_get = getattr(attribute, '__get__', None)
+                if attribute_get is not None:
+                    return attribute_get(None, tp)
+                return attribute
+        raise AttributeError(f'{name} not found in {tp}')
+    else:
+        try:
+            return getattr(tp, name)
+        except AttributeError:
+            return get_attribute_from_bases(mro(tp), name)
+
+
+def get_attribute_from_base_dicts(tp: type[Any], name: str) -> Any:
+    """Get an attribute out of the `__dict__` following the MRO.
+    This prevents the call to `__get__` on the descriptor, and allows
+    us to get the original function for classmethod properties.
+
+    Args:
+        tp: The type or class to search for the attribute.
+        name: The name of the attribute to retrieve.
+
+    Returns:
+        Any: The attribute value, if found.
+
+    Raises:
+        KeyError: If the attribute is not found in any class's `__dict__` in the MRO.
+    """
+    for base in reversed(mro(tp)):
+        if name in base.__dict__:
+            return base.__dict__[name]
+    return tp.__dict__[name]  # raise the error
+
+
+@dataclass(**slots_true)
+class DecoratorInfos:
+    """Mapping of name in the class namespace to decorator info.
+
+    note that the name in the class namespace is the function or attribute name
+    not the field name!
+    """
+
+    validators: dict[str, Decorator[ValidatorDecoratorInfo]] = field(default_factory=dict)
+    field_validators: dict[str, Decorator[FieldValidatorDecoratorInfo]] = field(default_factory=dict)
+    root_validators: dict[str, Decorator[RootValidatorDecoratorInfo]] = field(default_factory=dict)
+    field_serializers: dict[str, Decorator[FieldSerializerDecoratorInfo]] = field(default_factory=dict)
+    model_serializers: dict[str, Decorator[ModelSerializerDecoratorInfo]] = field(default_factory=dict)
+    model_validators: dict[str, Decorator[ModelValidatorDecoratorInfo]] = field(default_factory=dict)
+    computed_fields: dict[str, Decorator[ComputedFieldInfo]] = field(default_factory=dict)
+
+    @staticmethod
+    def build(model_dc: type[Any]) -> DecoratorInfos:  # noqa: C901 (ignore complexity)
+        """We want to collect all DecFunc instances that exist as
+        attributes in the namespace of the class (a BaseModel or dataclass)
+        that called us
+        But we want to collect these in the order of the bases
+        So instead of getting them all from the leaf class (the class that called us),
+        we traverse the bases from root (the oldest ancestor class) to leaf
+        and collect all of the instances as we go, taking care to replace
+        any duplicate ones with the last one we see to mimic how function overriding
+        works with inheritance.
+        If we do replace any functions we put the replacement into the position
+        the replaced function was in; that is, we maintain the order.
+        """
+        # reminder: dicts are ordered and replacement does not alter the order
+        res = DecoratorInfos()
+        for base in reversed(mro(model_dc)[1:]):
+            existing: DecoratorInfos | None = base.__dict__.get('__pydantic_decorators__')
+            if existing is None:
+                existing = DecoratorInfos.build(base)
+            res.validators.update({k: v.bind_to_cls(model_dc) for k, v in existing.validators.items()})
+            res.field_validators.update({k: v.bind_to_cls(model_dc) for k, v in existing.field_validators.items()})
+            res.root_validators.update({k: v.bind_to_cls(model_dc) for k, v in existing.root_validators.items()})
+            res.field_serializers.update({k: v.bind_to_cls(model_dc) for k, v in existing.field_serializers.items()})
+            res.model_serializers.update({k: v.bind_to_cls(model_dc) for k, v in existing.model_serializers.items()})
+            res.model_validators.update({k: v.bind_to_cls(model_dc) for k, v in existing.model_validators.items()})
+            res.computed_fields.update({k: v.bind_to_cls(model_dc) for k, v in existing.computed_fields.items()})
+
+        to_replace: list[tuple[str, Any]] = []
+
+        for var_name, var_value in vars(model_dc).items():
+            if isinstance(var_value, PydanticDescriptorProxy):
+                info = var_value.decorator_info
+                if isinstance(info, ValidatorDecoratorInfo):
+                    res.validators[var_name] = Decorator.build(
+                        model_dc, cls_var_name=var_name, shim=var_value.shim, info=info
+                    )
+                elif isinstance(info, FieldValidatorDecoratorInfo):
+                    res.field_validators[var_name] = Decorator.build(
+                        model_dc, cls_var_name=var_name, shim=var_value.shim, info=info
+                    )
+                elif isinstance(info, RootValidatorDecoratorInfo):
+                    res.root_validators[var_name] = Decorator.build(
+                        model_dc, cls_var_name=var_name, shim=var_value.shim, info=info
+                    )
+                elif isinstance(info, FieldSerializerDecoratorInfo):
+                    # check whether a serializer function is already registered for fields
+                    for field_serializer_decorator in res.field_serializers.values():
+                        # check that each field has at most one serializer function.
+                        # serializer functions for the same field in subclasses are allowed,
+                        # and are treated as overrides
+                        if field_serializer_decorator.cls_var_name == var_name:
+                            continue
+                        for f in info.fields:
+                            if f in field_serializer_decorator.info.fields:
+                                raise PydanticUserError(
+                                    'Multiple field serializer functions were defined '
+                                    f'for field {f!r}, this is not allowed.',
+                                    code='multiple-field-serializers',
+                                )
+                    res.field_serializers[var_name] = Decorator.build(
+                        model_dc, cls_var_name=var_name, shim=var_value.shim, info=info
+                    )
+                elif isinstance(info, ModelValidatorDecoratorInfo):
+                    res.model_validators[var_name] = Decorator.build(
+                        model_dc, cls_var_name=var_name, shim=var_value.shim, info=info
+                    )
+                elif isinstance(info, ModelSerializerDecoratorInfo):
+                    res.model_serializers[var_name] = Decorator.build(
+                        model_dc, cls_var_name=var_name, shim=var_value.shim, info=info
+                    )
+                else:
+                    from ..fields import ComputedFieldInfo
+
+                    isinstance(var_value, ComputedFieldInfo)
+                    res.computed_fields[var_name] = Decorator.build(
+                        model_dc, cls_var_name=var_name, shim=None, info=info
+                    )
+                to_replace.append((var_name, var_value.wrapped))
+        if to_replace:
+            # If we can save `__pydantic_decorators__` on the class we'll be able to check for it above
+            # so then we don't need to re-process the type, which means we can discard our descriptor wrappers
+            # and replace them with the thing they are wrapping (see the other setattr call below)
+            # which allows validator class methods to also function as regular class methods
+            setattr(model_dc, '__pydantic_decorators__', res)
+            for name, value in to_replace:
+                setattr(model_dc, name, value)
+        return res
+
+
+def inspect_validator(validator: Callable[..., Any], mode: FieldValidatorModes) -> bool:
+    """Look at a field or model validator function and determine whether it takes an info argument.
+
+    An error is raised if the function has an invalid signature.
+
+    Args:
+        validator: The validator function to inspect.
+        mode: The proposed validator mode.
+
+    Returns:
+        Whether the validator takes an info argument.
+    """
+    try:
+        sig = signature(validator)
+    except ValueError:
+        # builtins and some C extensions don't have signatures
+        # assume that they don't take an info argument and only take a single argument
+        # e.g. `str.strip` or `datetime.datetime`
+        return False
+    n_positional = count_positional_params(sig)
+    if mode == 'wrap':
+        if n_positional == 3:
+            return True
+        elif n_positional == 2:
+            return False
+    else:
+        assert mode in {'before', 'after', 'plain'}, f"invalid mode: {mode!r}, expected 'before', 'after' or 'plain"
+        if n_positional == 2:
+            return True
+        elif n_positional == 1:
+            return False
+
+    raise PydanticUserError(
+        f'Unrecognized field_validator function signature for {validator} with `mode={mode}`:{sig}',
+        code='validator-signature',
+    )
+
+
+def inspect_field_serializer(
+    serializer: Callable[..., Any], mode: Literal['plain', 'wrap'], computed_field: bool = False
+) -> tuple[bool, bool]:
+    """Look at a field serializer function and determine if it is a field serializer,
+    and whether it takes an info argument.
+
+    An error is raised if the function has an invalid signature.
+
+    Args:
+        serializer: The serializer function to inspect.
+        mode: The serializer mode, either 'plain' or 'wrap'.
+        computed_field: When serializer is applied on computed_field. It doesn't require
+            info signature.
+
+    Returns:
+        Tuple of (is_field_serializer, info_arg).
+    """
+    sig = signature(serializer)
+
+    first = next(iter(sig.parameters.values()), None)
+    is_field_serializer = first is not None and first.name == 'self'
+
+    n_positional = count_positional_params(sig)
+    if is_field_serializer:
+        # -1 to correct for self parameter
+        info_arg = _serializer_info_arg(mode, n_positional - 1)
+    else:
+        info_arg = _serializer_info_arg(mode, n_positional)
+
+    if info_arg is None:
+        raise PydanticUserError(
+            f'Unrecognized field_serializer function signature for {serializer} with `mode={mode}`:{sig}',
+            code='field-serializer-signature',
+        )
+    if info_arg and computed_field:
+        raise PydanticUserError(
+            'field_serializer on computed_field does not use info signature', code='field-serializer-signature'
+        )
+
+    else:
+        return is_field_serializer, info_arg
+
+
+def inspect_annotated_serializer(serializer: Callable[..., Any], mode: Literal['plain', 'wrap']) -> bool:
+    """Look at a serializer function used via `Annotated` and determine whether it takes an info argument.
+
+    An error is raised if the function has an invalid signature.
+
+    Args:
+        serializer: The serializer function to check.
+        mode: The serializer mode, either 'plain' or 'wrap'.
+
+    Returns:
+        info_arg
+    """
+    sig = signature(serializer)
+    info_arg = _serializer_info_arg(mode, count_positional_params(sig))
+    if info_arg is None:
+        raise PydanticUserError(
+            f'Unrecognized field_serializer function signature for {serializer} with `mode={mode}`:{sig}',
+            code='field-serializer-signature',
+        )
+    else:
+        return info_arg
+
+
+def inspect_model_serializer(serializer: Callable[..., Any], mode: Literal['plain', 'wrap']) -> bool:
+    """Look at a model serializer function and determine whether it takes an info argument.
+
+    An error is raised if the function has an invalid signature.
+
+    Args:
+        serializer: The serializer function to check.
+        mode: The serializer mode, either 'plain' or 'wrap'.
+
+    Returns:
+        `info_arg` - whether the function expects an info argument.
+    """
+    if isinstance(serializer, (staticmethod, classmethod)) or not is_instance_method_from_sig(serializer):
+        raise PydanticUserError(
+            '`@model_serializer` must be applied to instance methods', code='model-serializer-instance-method'
+        )
+
+    sig = signature(serializer)
+    info_arg = _serializer_info_arg(mode, count_positional_params(sig))
+    if info_arg is None:
+        raise PydanticUserError(
+            f'Unrecognized model_serializer function signature for {serializer} with `mode={mode}`:{sig}',
+            code='model-serializer-signature',
+        )
+    else:
+        return info_arg
+
+
+def _serializer_info_arg(mode: Literal['plain', 'wrap'], n_positional: int) -> bool | None:
+    if mode == 'plain':
+        if n_positional == 1:
+            # (__input_value: Any) -> Any
+            return False
+        elif n_positional == 2:
+            # (__model: Any, __input_value: Any) -> Any
+            return True
+    else:
+        assert mode == 'wrap', f"invalid mode: {mode!r}, expected 'plain' or 'wrap'"
+        if n_positional == 2:
+            # (__input_value: Any, __serializer: SerializerFunctionWrapHandler) -> Any
+            return False
+        elif n_positional == 3:
+            # (__input_value: Any, __serializer: SerializerFunctionWrapHandler, __info: SerializationInfo) -> Any
+            return True
+
+    return None
+
+
+AnyDecoratorCallable: TypeAlias = (
+    'Union[classmethod[Any, Any, Any], staticmethod[Any, Any], partialmethod[Any], Callable[..., Any]]'
+)
+
+
+def is_instance_method_from_sig(function: AnyDecoratorCallable) -> bool:
+    """Whether the function is an instance method.
+
+    It will consider a function as instance method if the first parameter of
+    function is `self`.
+
+    Args:
+        function: The function to check.
+
+    Returns:
+        `True` if the function is an instance method, `False` otherwise.
+    """
+    sig = signature(unwrap_wrapped_function(function))
+    first = next(iter(sig.parameters.values()), None)
+    if first and first.name == 'self':
+        return True
+    return False
+
+
+def ensure_classmethod_based_on_signature(function: AnyDecoratorCallable) -> Any:
+    """Apply the `@classmethod` decorator on the function.
+
+    Args:
+        function: The function to apply the decorator on.
+
+    Return:
+        The `@classmethod` decorator applied function.
+    """
+    if not isinstance(
+        unwrap_wrapped_function(function, unwrap_class_static_method=False), classmethod
+    ) and _is_classmethod_from_sig(function):
+        return classmethod(function)  # type: ignore[arg-type]
+    return function
+
+
+def _is_classmethod_from_sig(function: AnyDecoratorCallable) -> bool:
+    sig = signature(unwrap_wrapped_function(function))
+    first = next(iter(sig.parameters.values()), None)
+    if first and first.name == 'cls':
+        return True
+    return False
+
+
+def unwrap_wrapped_function(
+    func: Any,
+    *,
+    unwrap_partial: bool = True,
+    unwrap_class_static_method: bool = True,
+) -> Any:
+    """Recursively unwraps a wrapped function until the underlying function is reached.
+    This handles property, functools.partial, functools.partialmethod, staticmethod and classmethod.
+
+    Args:
+        func: The function to unwrap.
+        unwrap_partial: If True (default), unwrap partial and partialmethod decorators, otherwise don't.
+            decorators.
+        unwrap_class_static_method: If True (default), also unwrap classmethod and staticmethod
+            decorators. If False, only unwrap partial and partialmethod decorators.
+
+    Returns:
+        The underlying function of the wrapped function.
+    """
+    all: set[Any] = {property, cached_property}
+
+    if unwrap_partial:
+        all.update({partial, partialmethod})
+
+    if unwrap_class_static_method:
+        all.update({staticmethod, classmethod})
+
+    while isinstance(func, tuple(all)):
+        if unwrap_class_static_method and isinstance(func, (classmethod, staticmethod)):
+            func = func.__func__
+        elif isinstance(func, (partial, partialmethod)):
+            func = func.func
+        elif isinstance(func, property):
+            func = func.fget  # arbitrary choice, convenient for computed fields
+        else:
+            # Make coverage happy as it can only get here in the last possible case
+            assert isinstance(func, cached_property)
+            func = func.func  # type: ignore
+
+    return func
+
+
+def get_function_return_type(
+    func: Any, explicit_return_type: Any, types_namespace: dict[str, Any] | None = None
+) -> Any:
+    """Get the function return type.
+
+    It gets the return type from the type annotation if `explicit_return_type` is `None`.
+    Otherwise, it returns `explicit_return_type`.
+
+    Args:
+        func: The function to get its return type.
+        explicit_return_type: The explicit return type.
+        types_namespace: The types namespace, defaults to `None`.
+
+    Returns:
+        The function return type.
+    """
+    if explicit_return_type is PydanticUndefined:
+        # try to get it from the type annotation
+        hints = get_function_type_hints(
+            unwrap_wrapped_function(func), include_keys={'return'}, types_namespace=types_namespace
+        )
+        return hints.get('return', PydanticUndefined)
+    else:
+        return explicit_return_type
+
+
+def count_positional_params(sig: Signature) -> int:
+    return sum(1 for param in sig.parameters.values() if can_be_positional(param))
+
+
+def can_be_positional(param: Parameter) -> bool:
+    return param.kind in (Parameter.POSITIONAL_ONLY, Parameter.POSITIONAL_OR_KEYWORD)
+
+
+def ensure_property(f: Any) -> Any:
+    """Ensure that a function is a `property` or `cached_property`, or is a valid descriptor.
+
+    Args:
+        f: The function to check.
+
+    Returns:
+        The function, or a `property` or `cached_property` instance wrapping the function.
+    """
+    if ismethoddescriptor(f) or isdatadescriptor(f):
+        return f
+    else:
+        return property(f)
diff --git a/lib/pydantic/_internal/_decorators_v1.py b/lib/pydantic/_internal/_decorators_v1.py
new file mode 100644
index 00000000..4f81e6d4
--- /dev/null
+++ b/lib/pydantic/_internal/_decorators_v1.py
@@ -0,0 +1,181 @@
+"""Logic for V1 validators, e.g. `@validator` and `@root_validator`."""
+from __future__ import annotations as _annotations
+
+from inspect import Parameter, signature
+from typing import Any, Dict, Tuple, Union, cast
+
+from pydantic_core import core_schema
+from typing_extensions import Protocol
+
+from ..errors import PydanticUserError
+from ._decorators import can_be_positional
+
+
+class V1OnlyValueValidator(Protocol):
+    """A simple validator, supported for V1 validators and V2 validators."""
+
+    def __call__(self, __value: Any) -> Any:
+        ...
+
+
+class V1ValidatorWithValues(Protocol):
+    """A validator with `values` argument, supported for V1 validators and V2 validators."""
+
+    def __call__(self, __value: Any, values: dict[str, Any]) -> Any:
+        ...
+
+
+class V1ValidatorWithValuesKwOnly(Protocol):
+    """A validator with keyword only `values` argument, supported for V1 validators and V2 validators."""
+
+    def __call__(self, __value: Any, *, values: dict[str, Any]) -> Any:
+        ...
+
+
+class V1ValidatorWithKwargs(Protocol):
+    """A validator with `kwargs` argument, supported for V1 validators and V2 validators."""
+
+    def __call__(self, __value: Any, **kwargs: Any) -> Any:
+        ...
+
+
+class V1ValidatorWithValuesAndKwargs(Protocol):
+    """A validator with `values` and `kwargs` arguments, supported for V1 validators and V2 validators."""
+
+    def __call__(self, __value: Any, values: dict[str, Any], **kwargs: Any) -> Any:
+        ...
+
+
+V1Validator = Union[
+    V1ValidatorWithValues, V1ValidatorWithValuesKwOnly, V1ValidatorWithKwargs, V1ValidatorWithValuesAndKwargs
+]
+
+
+def can_be_keyword(param: Parameter) -> bool:
+    return param.kind in (Parameter.POSITIONAL_OR_KEYWORD, Parameter.KEYWORD_ONLY)
+
+
+def make_generic_v1_field_validator(validator: V1Validator) -> core_schema.WithInfoValidatorFunction:
+    """Wrap a V1 style field validator for V2 compatibility.
+
+    Args:
+        validator: The V1 style field validator.
+
+    Returns:
+        A wrapped V2 style field validator.
+
+    Raises:
+        PydanticUserError: If the signature is not supported or the parameters are
+            not available in Pydantic V2.
+    """
+    sig = signature(validator)
+
+    needs_values_kw = False
+
+    for param_num, (param_name, parameter) in enumerate(sig.parameters.items()):
+        if can_be_keyword(parameter) and param_name in ('field', 'config'):
+            raise PydanticUserError(
+                'The `field` and `config` parameters are not available in Pydantic V2, '
+                'please use the `info` parameter instead.',
+                code='validator-field-config-info',
+            )
+        if parameter.kind is Parameter.VAR_KEYWORD:
+            needs_values_kw = True
+        elif can_be_keyword(parameter) and param_name == 'values':
+            needs_values_kw = True
+        elif can_be_positional(parameter) and param_num == 0:
+            # value
+            continue
+        elif parameter.default is Parameter.empty:  # ignore params with defaults e.g. bound by functools.partial
+            raise PydanticUserError(
+                f'Unsupported signature for V1 style validator {validator}: {sig} is not supported.',
+                code='validator-v1-signature',
+            )
+
+    if needs_values_kw:
+        # (v, **kwargs), (v, values, **kwargs), (v, *, values, **kwargs) or (v, *, values)
+        val1 = cast(V1ValidatorWithValues, validator)
+
+        def wrapper1(value: Any, info: core_schema.ValidationInfo) -> Any:
+            return val1(value, values=info.data)
+
+        return wrapper1
+    else:
+        val2 = cast(V1OnlyValueValidator, validator)
+
+        def wrapper2(value: Any, _: core_schema.ValidationInfo) -> Any:
+            return val2(value)
+
+        return wrapper2
+
+
+RootValidatorValues = Dict[str, Any]
+# technically tuple[model_dict, model_extra, fields_set] | tuple[dataclass_dict, init_vars]
+RootValidatorFieldsTuple = Tuple[Any, ...]
+
+
+class V1RootValidatorFunction(Protocol):
+    """A simple root validator, supported for V1 validators and V2 validators."""
+
+    def __call__(self, __values: RootValidatorValues) -> RootValidatorValues:
+        ...
+
+
+class V2CoreBeforeRootValidator(Protocol):
+    """V2 validator with mode='before'."""
+
+    def __call__(self, __values: RootValidatorValues, __info: core_schema.ValidationInfo) -> RootValidatorValues:
+        ...
+
+
+class V2CoreAfterRootValidator(Protocol):
+    """V2 validator with mode='after'."""
+
+    def __call__(
+        self, __fields_tuple: RootValidatorFieldsTuple, __info: core_schema.ValidationInfo
+    ) -> RootValidatorFieldsTuple:
+        ...
+
+
+def make_v1_generic_root_validator(
+    validator: V1RootValidatorFunction, pre: bool
+) -> V2CoreBeforeRootValidator | V2CoreAfterRootValidator:
+    """Wrap a V1 style root validator for V2 compatibility.
+
+    Args:
+        validator: The V1 style field validator.
+        pre: Whether the validator is a pre validator.
+
+    Returns:
+        A wrapped V2 style validator.
+    """
+    if pre is True:
+        # mode='before' for pydantic-core
+        def _wrapper1(values: RootValidatorValues, _: core_schema.ValidationInfo) -> RootValidatorValues:
+            return validator(values)
+
+        return _wrapper1
+
+    # mode='after' for pydantic-core
+    def _wrapper2(fields_tuple: RootValidatorFieldsTuple, _: core_schema.ValidationInfo) -> RootValidatorFieldsTuple:
+        if len(fields_tuple) == 2:
+            # dataclass, this is easy
+            values, init_vars = fields_tuple
+            values = validator(values)
+            return values, init_vars
+        else:
+            # ugly hack: to match v1 behaviour, we merge values and model_extra, then split them up based on fields
+            # afterwards
+            model_dict, model_extra, fields_set = fields_tuple
+            if model_extra:
+                fields = set(model_dict.keys())
+                model_dict.update(model_extra)
+                model_dict_new = validator(model_dict)
+                for k in list(model_dict_new.keys()):
+                    if k not in fields:
+                        model_extra[k] = model_dict_new.pop(k)
+            else:
+                model_dict_new = validator(model_dict)
+            return model_dict_new, model_extra, fields_set
+
+    return _wrapper2
diff --git a/lib/pydantic/_internal/_discriminated_union.py b/lib/pydantic/_internal/_discriminated_union.py
new file mode 100644
index 00000000..c40117d3
--- /dev/null
+++ b/lib/pydantic/_internal/_discriminated_union.py
@@ -0,0 +1,506 @@
+from __future__ import annotations as _annotations
+
+from typing import TYPE_CHECKING, Any, Hashable, Sequence
+
+from pydantic_core import CoreSchema, core_schema
+
+from ..errors import PydanticUserError
+from . import _core_utils
+from ._core_utils import (
+    CoreSchemaField,
+    collect_definitions,
+    simplify_schema_references,
+)
+
+if TYPE_CHECKING:
+    from ..types import Discriminator
+
+CORE_SCHEMA_METADATA_DISCRIMINATOR_PLACEHOLDER_KEY = 'pydantic.internal.union_discriminator'
+
+
+class MissingDefinitionForUnionRef(Exception):
+    """Raised when applying a discriminated union discriminator to a schema
+    requires a definition that is not yet defined
+    """
+
+    def __init__(self, ref: str) -> None:
+        self.ref = ref
+        super().__init__(f'Missing definition for ref {self.ref!r}')
+
+
+def set_discriminator_in_metadata(schema: CoreSchema, discriminator: Any) -> None:
+    schema.setdefault('metadata', {})
+    metadata = schema.get('metadata')
+    assert metadata is not None
+    metadata[CORE_SCHEMA_METADATA_DISCRIMINATOR_PLACEHOLDER_KEY] = discriminator
+
+
+def apply_discriminators(schema: core_schema.CoreSchema) -> core_schema.CoreSchema:
+    definitions: dict[str, CoreSchema] | None = None
+
+    def inner(s: core_schema.CoreSchema, recurse: _core_utils.Recurse) -> core_schema.CoreSchema:
+        nonlocal definitions
+
+        s = recurse(s, inner)
+        if s['type'] == 'tagged-union':
+            return s
+
+        metadata = s.get('metadata', {})
+        discriminator = metadata.pop(CORE_SCHEMA_METADATA_DISCRIMINATOR_PLACEHOLDER_KEY, None)
+        if discriminator is not None:
+            if definitions is None:
+                definitions = collect_definitions(schema)
+            s = apply_discriminator(s, discriminator, definitions)
+        return s
+
+    return simplify_schema_references(_core_utils.walk_core_schema(schema, inner))
+
+
+def apply_discriminator(
+    schema: core_schema.CoreSchema,
+    discriminator: str | Discriminator,
+    definitions: dict[str, core_schema.CoreSchema] | None = None,
+) -> core_schema.CoreSchema:
+    """Applies the discriminator and returns a new core schema.
+
+    Args:
+        schema: The input schema.
+        discriminator: The name of the field which will serve as the discriminator.
+        definitions: A mapping of schema ref to schema.
+
+    Returns:
+        The new core schema.
+
+    Raises:
+        TypeError:
+            - If `discriminator` is used with invalid union variant.
+            - If `discriminator` is used with `Union` type with one variant.
+            - If `discriminator` value mapped to multiple choices.
+        MissingDefinitionForUnionRef:
+            If the definition for ref is missing.
+        PydanticUserError:
+            - If a model in union doesn't have a discriminator field.
+            - If discriminator field has a non-string alias.
+            - If discriminator fields have different aliases.
+            - If discriminator field not of type `Literal`.
+    """
+    from ..types import Discriminator
+
+    if isinstance(discriminator, Discriminator):
+        if isinstance(discriminator.discriminator, str):
+            discriminator = discriminator.discriminator
+        else:
+            return discriminator._convert_schema(schema)
+
+    return _ApplyInferredDiscriminator(discriminator, definitions or {}).apply(schema)
+
+
+class _ApplyInferredDiscriminator:
+    """This class is used to convert an input schema containing a union schema into one where that union is
+    replaced with a tagged-union, with all the associated debugging and performance benefits.
+
+    This is done by:
+    * Validating that the input schema is compatible with the provided discriminator
+    * Introspecting the schema to determine which discriminator values should map to which union choices
+    * Handling various edge cases such as 'definitions', 'default', 'nullable' schemas, and more
+
+    I have chosen to implement the conversion algorithm in this class, rather than a function,
+    to make it easier to maintain state while recursively walking the provided CoreSchema.
+    """
+
+    def __init__(self, discriminator: str, definitions: dict[str, core_schema.CoreSchema]):
+        # `discriminator` should be the name of the field which will serve as the discriminator.
+        # It must be the python name of the field, and *not* the field's alias. Note that as of now,
+        # all members of a discriminated union _must_ use a field with the same name as the discriminator.
+        # This may change if/when we expose a way to manually specify the TaggedUnionSchema's choices.
+        self.discriminator = discriminator
+
+        # `definitions` should contain a mapping of schema ref to schema for all schemas which might
+        # be referenced by some choice
+        self.definitions = definitions
+
+        # `_discriminator_alias` will hold the value, if present, of the alias for the discriminator
+        #
+        # Note: following the v1 implementation, we currently disallow the use of different aliases
+        # for different choices. This is not a limitation of pydantic_core, but if we try to handle
+        # this, the inference logic gets complicated very quickly, and could result in confusing
+        # debugging challenges for users making subtle mistakes.
+        #
+        # Rather than trying to do the most powerful inference possible, I think we should eventually
+        # expose a way to more-manually control the way the TaggedUnionSchema is constructed through
+        # the use of a new type which would be placed as an Annotation on the Union type. This would
+        # provide the full flexibility/power of pydantic_core's TaggedUnionSchema where necessary for
+        # more complex cases, without over-complicating the inference logic for the common cases.
+        self._discriminator_alias: str | None = None
+
+        # `_should_be_nullable` indicates whether the converted union has `None` as an allowed value.
+        # If `None` is an acceptable value of the (possibly-wrapped) union, we ignore it while
+        # constructing the TaggedUnionSchema, but set the `_should_be_nullable` attribute to True.
+        # Once we have constructed the TaggedUnionSchema, if `_should_be_nullable` is True, we ensure
+        # that the final schema gets wrapped as a NullableSchema. This has the same semantics on the
+        # python side, but resolves the issue that `None` cannot correspond to any discriminator values.
+        self._should_be_nullable = False
+
+        # `_is_nullable` is used to track if the final produced schema will definitely be nullable;
+        # we set it to True if the input schema is wrapped in a nullable schema that we know will be preserved
+        # as an indication that, even if None is discovered as one of the union choices, we will not need to wrap
+        # the final value in another nullable schema.
+        #
+        # This is more complicated than just checking for the final outermost schema having type 'nullable' thanks
+        # to the possible presence of other wrapper schemas such as DefinitionsSchema, WithDefaultSchema, etc.
+        self._is_nullable = False
+
+        # `_choices_to_handle` serves as a stack of choices to add to the tagged union. Initially, choices
+        # from the union in the wrapped schema will be appended to this list, and the recursive choice-handling
+        # algorithm may add more choices to this stack as (nested) unions are encountered.
+        self._choices_to_handle: list[core_schema.CoreSchema] = []
+
+        # `_tagged_union_choices` is built during the call to `apply`, and will hold the choices to be included
+        # in the output TaggedUnionSchema that will replace the union from the input schema
+        self._tagged_union_choices: dict[Hashable, core_schema.CoreSchema] = {}
+
+        # `_used` is changed to True after applying the discriminator to prevent accidental re-use
+        self._used = False
+
+    def apply(self, schema: core_schema.CoreSchema) -> core_schema.CoreSchema:
+        """Return a new CoreSchema based on `schema` that uses a tagged-union with the discriminator provided
+        to this class.
+
+        Args:
+            schema: The input schema.
+
+        Returns:
+            The new core schema.
+
+        Raises:
+            TypeError:
+                - If `discriminator` is used with invalid union variant.
+                - If `discriminator` is used with `Union` type with one variant.
+                - If `discriminator` value mapped to multiple choices.
+            ValueError:
+                If the definition for ref is missing.
+            PydanticUserError:
+                - If a model in union doesn't have a discriminator field.
+                - If discriminator field has a non-string alias.
+                - If discriminator fields have different aliases.
+                - If discriminator field not of type `Literal`.
+        """
+        self.definitions.update(collect_definitions(schema))
+        assert not self._used
+        schema = self._apply_to_root(schema)
+        if self._should_be_nullable and not self._is_nullable:
+            schema = core_schema.nullable_schema(schema)
+        self._used = True
+        new_defs = collect_definitions(schema)
+        missing_defs = self.definitions.keys() - new_defs.keys()
+        if missing_defs:
+            schema = core_schema.definitions_schema(schema, [self.definitions[ref] for ref in missing_defs])
+        return schema
+
+    def _apply_to_root(self, schema: core_schema.CoreSchema) -> core_schema.CoreSchema:
+        """This method handles the outer-most stage of recursion over the input schema:
+        unwrapping nullable or definitions schemas, and calling the `_handle_choice`
+        method iteratively on the choices extracted (recursively) from the possibly-wrapped union.
+        """
+        if schema['type'] == 'nullable':
+            self._is_nullable = True
+            wrapped = self._apply_to_root(schema['schema'])
+            nullable_wrapper = schema.copy()
+            nullable_wrapper['schema'] = wrapped
+            return nullable_wrapper
+
+        if schema['type'] == 'definitions':
+            wrapped = self._apply_to_root(schema['schema'])
+            definitions_wrapper = schema.copy()
+            definitions_wrapper['schema'] = wrapped
+            return definitions_wrapper
+
+        if schema['type'] != 'union':
+            # If the schema is not a union, it probably means it just had a single member and
+            # was flattened by pydantic_core.
+            # However, it still may make sense to apply the discriminator to this schema,
+            # as a way to get discriminated-union-style error messages, so we allow this here.
+            schema = core_schema.union_schema([schema])
+
+        # Reverse the choices list before extending the stack so that they get handled in the order they occur
+        choices_schemas = [v[0] if isinstance(v, tuple) else v for v in schema['choices'][::-1]]
+        self._choices_to_handle.extend(choices_schemas)
+        while self._choices_to_handle:
+            choice = self._choices_to_handle.pop()
+            self._handle_choice(choice)
+
+        if self._discriminator_alias is not None and self._discriminator_alias != self.discriminator:
+            # * We need to annotate `discriminator` as a union here to handle both branches of this conditional
+            # * We need to annotate `discriminator` as list[list[str | int]] and not list[list[str]] due to the
+            #   invariance of list, and because list[list[str | int]] is the type of the discriminator argument
+            #   to tagged_union_schema below
+            # * See the docstring of pydantic_core.core_schema.tagged_union_schema for more details about how to
+            #   interpret the value of the discriminator argument to tagged_union_schema. (The list[list[str]] here
+            #   is the appropriate way to provide a list of fallback attributes to check for a discriminator value.)
+            discriminator: str | list[list[str | int]] = [[self.discriminator], [self._discriminator_alias]]
+        else:
+            discriminator = self.discriminator
+        return core_schema.tagged_union_schema(
+            choices=self._tagged_union_choices,
+            discriminator=discriminator,
+            custom_error_type=schema.get('custom_error_type'),
+            custom_error_message=schema.get('custom_error_message'),
+            custom_error_context=schema.get('custom_error_context'),
+            strict=False,
+            from_attributes=True,
+            ref=schema.get('ref'),
+            metadata=schema.get('metadata'),
+            serialization=schema.get('serialization'),
+        )
+
+    def _handle_choice(self, choice: core_schema.CoreSchema) -> None:
+        """This method handles the "middle" stage of recursion over the input schema.
+        Specifically, it is responsible for handling each choice of the outermost union
+        (and any "coalesced" choices obtained from inner unions).
+
+        Here, "handling" entails:
+        * Coalescing nested unions and compatible tagged-unions
+        * Tracking the presence of 'none' and 'nullable' schemas occurring as choices
+        * Validating that each allowed discriminator value maps to a unique choice
+        * Updating the _tagged_union_choices mapping that will ultimately be used to build the TaggedUnionSchema.
+        """
+        if choice['type'] == 'definition-ref':
+            if choice['schema_ref'] not in self.definitions:
+                raise MissingDefinitionForUnionRef(choice['schema_ref'])
+
+        if choice['type'] == 'none':
+            self._should_be_nullable = True
+        elif choice['type'] == 'definitions':
+            self._handle_choice(choice['schema'])
+        elif choice['type'] == 'nullable':
+            self._should_be_nullable = True
+            self._handle_choice(choice['schema'])  # unwrap the nullable schema
+        elif choice['type'] == 'union':
+            # Reverse the choices list before extending the stack so that they get handled in the order they occur
+            choices_schemas = [v[0] if isinstance(v, tuple) else v for v in choice['choices'][::-1]]
+            self._choices_to_handle.extend(choices_schemas)
+        elif choice['type'] not in {
+            'model',
+            'typed-dict',
+            'tagged-union',
+            'lax-or-strict',
+            'dataclass',
+            'dataclass-args',
+            'definition-ref',
+        } and not _core_utils.is_function_with_inner_schema(choice):
+            # We should eventually handle 'definition-ref' as well
+            raise TypeError(
+                f'{choice["type"]!r} is not a valid discriminated union variant;'
+                ' should be a `BaseModel` or `dataclass`'
+            )
+        else:
+            if choice['type'] == 'tagged-union' and self._is_discriminator_shared(choice):
+                # In this case, this inner tagged-union is compatible with the outer tagged-union,
+                # and its choices can be coalesced into the outer TaggedUnionSchema.
+                subchoices = [x for x in choice['choices'].values() if not isinstance(x, (str, int))]
+                # Reverse the choices list before extending the stack so that they get handled in the order they occur
+                self._choices_to_handle.extend(subchoices[::-1])
+                return
+
+            inferred_discriminator_values = self._infer_discriminator_values_for_choice(choice, source_name=None)
+            self._set_unique_choice_for_values(choice, inferred_discriminator_values)
+
+    def _is_discriminator_shared(self, choice: core_schema.TaggedUnionSchema) -> bool:
+        """This method returns a boolean indicating whether the discriminator for the `choice`
+        is the same as that being used for the outermost tagged union. This is used to
+        determine whether this TaggedUnionSchema choice should be "coalesced" into the top level,
+        or whether it should be treated as a separate (nested) choice.
+        """
+        inner_discriminator = choice['discriminator']
+        return inner_discriminator == self.discriminator or (
+            isinstance(inner_discriminator, list)
+            and (self.discriminator in inner_discriminator or [self.discriminator] in inner_discriminator)
+        )
+
+    def _infer_discriminator_values_for_choice(  # noqa C901
+        self, choice: core_schema.CoreSchema, source_name: str | None
+    ) -> list[str | int]:
+        """This function recurses over `choice`, extracting all discriminator values that should map to this choice.
+
+        `model_name` is accepted for the purpose of producing useful error messages.
+        """
+        if choice['type'] == 'definitions':
+            return self._infer_discriminator_values_for_choice(choice['schema'], source_name=source_name)
+        elif choice['type'] == 'function-plain':
+            raise TypeError(
+                f'{choice["type"]!r} is not a valid discriminated union variant;'
+                ' should be a `BaseModel` or `dataclass`'
+            )
+        elif _core_utils.is_function_with_inner_schema(choice):
+            return self._infer_discriminator_values_for_choice(choice['schema'], source_name=source_name)
+        elif choice['type'] == 'lax-or-strict':
+            return sorted(
+                set(
+                    self._infer_discriminator_values_for_choice(choice['lax_schema'], source_name=None)
+                    + self._infer_discriminator_values_for_choice(choice['strict_schema'], source_name=None)
+                )
+            )
+
+        elif choice['type'] == 'tagged-union':
+            values: list[str | int] = []
+            # Ignore str/int "choices" since these are just references to other choices
+            subchoices = [x for x in choice['choices'].values() if not isinstance(x, (str, int))]
+            for subchoice in subchoices:
+                subchoice_values = self._infer_discriminator_values_for_choice(subchoice, source_name=None)
+                values.extend(subchoice_values)
+            return values
+
+        elif choice['type'] == 'union':
+            values = []
+            for subchoice in choice['choices']:
+                subchoice_schema = subchoice[0] if isinstance(subchoice, tuple) else subchoice
+                subchoice_values = self._infer_discriminator_values_for_choice(subchoice_schema, source_name=None)
+                values.extend(subchoice_values)
+            return values
+
+        elif choice['type'] == 'nullable':
+            self._should_be_nullable = True
+            return self._infer_discriminator_values_for_choice(choice['schema'], source_name=None)
+
+        elif choice['type'] == 'model':
+            return self._infer_discriminator_values_for_choice(choice['schema'], source_name=choice['cls'].__name__)
+
+        elif choice['type'] == 'dataclass':
+            return self._infer_discriminator_values_for_choice(choice['schema'], source_name=choice['cls'].__name__)
+
+        elif choice['type'] == 'model-fields':
+            return self._infer_discriminator_values_for_model_choice(choice, source_name=source_name)
+
+        elif choice['type'] == 'dataclass-args':
+            return self._infer_discriminator_values_for_dataclass_choice(choice, source_name=source_name)
+
+        elif choice['type'] == 'typed-dict':
+            return self._infer_discriminator_values_for_typed_dict_choice(choice, source_name=source_name)
+
+        elif choice['type'] == 'definition-ref':
+            schema_ref = choice['schema_ref']
+            if schema_ref not in self.definitions:
+                raise MissingDefinitionForUnionRef(schema_ref)
+            return self._infer_discriminator_values_for_choice(self.definitions[schema_ref], source_name=source_name)
+        else:
+            raise TypeError(
+                f'{choice["type"]!r} is not a valid discriminated union variant;'
+                ' should be a `BaseModel` or `dataclass`'
+            )
+
+    def _infer_discriminator_values_for_typed_dict_choice(
+        self, choice: core_schema.TypedDictSchema, source_name: str | None = None
+    ) -> list[str | int]:
+        """This method just extracts the _infer_discriminator_values_for_choice logic specific to TypedDictSchema
+        for the sake of readability.
+        """
+        source = 'TypedDict' if source_name is None else f'TypedDict {source_name!r}'
+        field = choice['fields'].get(self.discriminator)
+        if field is None:
+            raise PydanticUserError(
+                f'{source} needs a discriminator field for key {self.discriminator!r}', code='discriminator-no-field'
+            )
+        return self._infer_discriminator_values_for_field(field, source)
+
+    def _infer_discriminator_values_for_model_choice(
+        self, choice: core_schema.ModelFieldsSchema, source_name: str | None = None
+    ) -> list[str | int]:
+        source = 'ModelFields' if source_name is None else f'Model {source_name!r}'
+        field = choice['fields'].get(self.discriminator)
+        if field is None:
+            raise PydanticUserError(
+                f'{source} needs a discriminator field for key {self.discriminator!r}', code='discriminator-no-field'
+            )
+        return self._infer_discriminator_values_for_field(field, source)
+
+    def _infer_discriminator_values_for_dataclass_choice(
+        self, choice: core_schema.DataclassArgsSchema, source_name: str | None = None
+    ) -> list[str | int]:
+        source = 'DataclassArgs' if source_name is None else f'Dataclass {source_name!r}'
+        for field in choice['fields']:
+            if field['name'] == self.discriminator:
+                break
+        else:
+            raise PydanticUserError(
+                f'{source} needs a discriminator field for key {self.discriminator!r}', code='discriminator-no-field'
+            )
+        return self._infer_discriminator_values_for_field(field, source)
+
+    def _infer_discriminator_values_for_field(self, field: CoreSchemaField, source: str) -> list[str | int]:
+        if field['type'] == 'computed-field':
+            # This should never occur as a discriminator, as it is only relevant to serialization
+            return []
+        alias = field.get('validation_alias', self.discriminator)
+        if not isinstance(alias, str):
+            raise PydanticUserError(
+                f'Alias {alias!r} is not supported in a discriminated union', code='discriminator-alias-type'
+            )
+        if self._discriminator_alias is None:
+            self._discriminator_alias = alias
+        elif self._discriminator_alias != alias:
+            raise PydanticUserError(
+                f'Aliases for discriminator {self.discriminator!r} must be the same '
+                f'(got {alias}, {self._discriminator_alias})',
+                code='discriminator-alias',
+            )
+        return self._infer_discriminator_values_for_inner_schema(field['schema'], source)
+
+    def _infer_discriminator_values_for_inner_schema(
+        self, schema: core_schema.CoreSchema, source: str
+    ) -> list[str | int]:
+        """When inferring discriminator values for a field, we typically extract the expected values from a literal
+        schema. This function does that, but also handles nested unions and defaults.
+        """
+        if schema['type'] == 'literal':
+            return schema['expected']
+
+        elif schema['type'] == 'union':
+            # Generally when multiple values are allowed they should be placed in a single `Literal`, but
+            # we add this case to handle the situation where a field is annotated as a `Union` of `Literal`s.
+            # For example, this lets us handle `Union[Literal['key'], Union[Literal['Key'], Literal['KEY']]]`
+            values: list[Any] = []
+            for choice in schema['choices']:
+                choice_schema = choice[0] if isinstance(choice, tuple) else choice
+                choice_values = self._infer_discriminator_values_for_inner_schema(choice_schema, source)
+                values.extend(choice_values)
+            return values
+
+        elif schema['type'] == 'default':
+            # This will happen if the field has a default value; we ignore it while extracting the discriminator values
+            return self._infer_discriminator_values_for_inner_schema(schema['schema'], source)
+
+        elif schema['type'] == 'function-after':
+            # After validators don't affect the discriminator values
+            return self._infer_discriminator_values_for_inner_schema(schema['schema'], source)
+
+        elif schema['type'] in {'function-before', 'function-wrap', 'function-plain'}:
+            validator_type = repr(schema['type'].split('-')[1])
+            raise PydanticUserError(
+                f'Cannot use a mode={validator_type} validator in the'
+                f' discriminator field {self.discriminator!r} of {source}',
+                code='discriminator-validator',
+            )
+
+        else:
+            raise PydanticUserError(
+                f'{source} needs field {self.discriminator!r} to be of type `Literal`',
+                code='discriminator-needs-literal',
+            )
+
+    def _set_unique_choice_for_values(self, choice: core_schema.CoreSchema, values: Sequence[str | int]) -> None:
+        """This method updates `self.tagged_union_choices` so that all provided (discriminator) `values` map to the
+        provided `choice`, validating that none of these values already map to another (different) choice.
+        """
+        for discriminator_value in values:
+            if discriminator_value in self._tagged_union_choices:
+                # It is okay if `value` is already in tagged_union_choices as long as it maps to the same value.
+                # Because tagged_union_choices may map values to other values, we need to walk the choices dict
+                # until we get to a "real" choice, and confirm that is equal to the one assigned.
+                existing_choice = self._tagged_union_choices[discriminator_value]
+                if existing_choice != choice:
+                    raise TypeError(
+                        f'Value {discriminator_value!r} for discriminator '
+                        f'{self.discriminator!r} mapped to multiple choices'
+                    )
+            else:
+                self._tagged_union_choices[discriminator_value] = choice
diff --git a/lib/pydantic/_internal/_fields.py b/lib/pydantic/_internal/_fields.py
new file mode 100644
index 00000000..94de3062
--- /dev/null
+++ b/lib/pydantic/_internal/_fields.py
@@ -0,0 +1,319 @@
+"""Private logic related to fields (the `Field()` function and `FieldInfo` class), and arguments to `Annotated`."""
+from __future__ import annotations as _annotations
+
+import dataclasses
+import sys
+import warnings
+from copy import copy
+from functools import lru_cache
+from typing import TYPE_CHECKING, Any
+
+from pydantic_core import PydanticUndefined
+
+from pydantic.errors import PydanticUserError
+
+from . import _typing_extra
+from ._config import ConfigWrapper
+from ._repr import Representation
+from ._typing_extra import get_cls_type_hints_lenient, get_type_hints, is_classvar, is_finalvar
+
+if TYPE_CHECKING:
+    from annotated_types import BaseMetadata
+
+    from ..fields import FieldInfo
+    from ..main import BaseModel
+    from ._dataclasses import StandardDataclass
+    from ._decorators import DecoratorInfos
+
+
+def get_type_hints_infer_globalns(
+    obj: Any,
+    localns: dict[str, Any] | None = None,
+    include_extras: bool = False,
+) -> dict[str, Any]:
+    """Gets type hints for an object by inferring the global namespace.
+
+    It uses the `typing.get_type_hints`, The only thing that we do here is fetching
+    global namespace from `obj.__module__` if it is not `None`.
+
+    Args:
+        obj: The object to get its type hints.
+        localns: The local namespaces.
+        include_extras: Whether to recursively include annotation metadata.
+
+    Returns:
+        The object type hints.
+    """
+    module_name = getattr(obj, '__module__', None)
+    globalns: dict[str, Any] | None = None
+    if module_name:
+        try:
+            globalns = sys.modules[module_name].__dict__
+        except KeyError:
+            # happens occasionally, see https://github.com/pydantic/pydantic/issues/2363
+            pass
+    return get_type_hints(obj, globalns=globalns, localns=localns, include_extras=include_extras)
+
+
+class PydanticMetadata(Representation):
+    """Base class for annotation markers like `Strict`."""
+
+    __slots__ = ()
+
+
+def pydantic_general_metadata(**metadata: Any) -> BaseMetadata:
+    """Create a new `_PydanticGeneralMetadata` class with the given metadata.
+
+    Args:
+        **metadata: The metadata to add.
+
+    Returns:
+        The new `_PydanticGeneralMetadata` class.
+    """
+    return _general_metadata_cls()(metadata)  # type: ignore
+
+
+@lru_cache(maxsize=None)
+def _general_metadata_cls() -> type[BaseMetadata]:
+    """Do it this way to avoid importing `annotated_types` at import time."""
+    from annotated_types import BaseMetadata
+
+    class _PydanticGeneralMetadata(PydanticMetadata, BaseMetadata):
+        """Pydantic general metadata like `max_digits`."""
+
+        def __init__(self, metadata: Any):
+            self.__dict__ = metadata
+
+    return _PydanticGeneralMetadata  # type: ignore
+
+
+def collect_model_fields(  # noqa: C901
+    cls: type[BaseModel],
+    bases: tuple[type[Any], ...],
+    config_wrapper: ConfigWrapper,
+    types_namespace: dict[str, Any] | None,
+    *,
+    typevars_map: dict[Any, Any] | None = None,
+) -> tuple[dict[str, FieldInfo], set[str]]:
+    """Collect the fields of a nascent pydantic model.
+
+    Also collect the names of any ClassVars present in the type hints.
+
+    The returned value is a tuple of two items: the fields dict, and the set of ClassVar names.
+
+    Args:
+        cls: BaseModel or dataclass.
+        bases: Parents of the class, generally `cls.__bases__`.
+        config_wrapper: The config wrapper instance.
+        types_namespace: Optional extra namespace to look for types in.
+        typevars_map: A dictionary mapping type variables to their concrete types.
+
+    Returns:
+        A tuple contains fields and class variables.
+
+    Raises:
+        NameError:
+            - If there is a conflict between a field name and protected namespaces.
+            - If there is a field other than `root` in `RootModel`.
+            - If a field shadows an attribute in the parent model.
+    """
+    from ..fields import FieldInfo
+
+    type_hints = get_cls_type_hints_lenient(cls, types_namespace)
+
+    # https://docs.python.org/3/howto/annotations.html#accessing-the-annotations-dict-of-an-object-in-python-3-9-and-older
+    # annotations is only used for finding fields in parent classes
+    annotations = cls.__dict__.get('__annotations__', {})
+    fields: dict[str, FieldInfo] = {}
+
+    class_vars: set[str] = set()
+    for ann_name, ann_type in type_hints.items():
+        if ann_name == 'model_config':
+            # We never want to treat `model_config` as a field
+            # Note: we may need to change this logic if/when we introduce a `BareModel` class with no
+            # protected namespaces (where `model_config` might be allowed as a field name)
+            continue
+        for protected_namespace in config_wrapper.protected_namespaces:
+            if ann_name.startswith(protected_namespace):
+                for b in bases:
+                    if hasattr(b, ann_name):
+                        from ..main import BaseModel
+
+                        if not (issubclass(b, BaseModel) and ann_name in b.model_fields):
+                            raise NameError(
+                                f'Field "{ann_name}" conflicts with member {getattr(b, ann_name)}'
+                                f' of protected namespace "{protected_namespace}".'
+                            )
+                else:
+                    valid_namespaces = tuple(
+                        x for x in config_wrapper.protected_namespaces if not ann_name.startswith(x)
+                    )
+                    warnings.warn(
+                        f'Field "{ann_name}" has conflict with protected namespace "{protected_namespace}".'
+                        '\n\nYou may be able to resolve this warning by setting'
+                        f" `model_config['protected_namespaces'] = {valid_namespaces}`.",
+                        UserWarning,
+                    )
+        if is_classvar(ann_type):
+            class_vars.add(ann_name)
+            continue
+        if _is_finalvar_with_default_val(ann_type, getattr(cls, ann_name, PydanticUndefined)):
+            class_vars.add(ann_name)
+            continue
+        if not is_valid_field_name(ann_name):
+            continue
+        if cls.__pydantic_root_model__ and ann_name != 'root':
+            raise NameError(
+                f"Unexpected field with name {ann_name!r}; only 'root' is allowed as a field of a `RootModel`"
+            )
+
+        # when building a generic model with `MyModel[int]`, the generic_origin check makes sure we don't get
+        # "... shadows an attribute" errors
+        generic_origin = getattr(cls, '__pydantic_generic_metadata__', {}).get('origin')
+        for base in bases:
+            dataclass_fields = {
+                field.name for field in (dataclasses.fields(base) if dataclasses.is_dataclass(base) else ())
+            }
+            if hasattr(base, ann_name):
+                if base is generic_origin:
+                    # Don't error when "shadowing" of attributes in parametrized generics
+                    continue
+
+                if ann_name in dataclass_fields:
+                    # Don't error when inheriting stdlib dataclasses whose fields are "shadowed" by defaults being set
+                    # on the class instance.
+                    continue
+                warnings.warn(
+                    f'Field name "{ann_name}" shadows an attribute in parent "{base.__qualname__}"; ',
+                    UserWarning,
+                )
+
+        try:
+            default = getattr(cls, ann_name, PydanticUndefined)
+            if default is PydanticUndefined:
+                raise AttributeError
+        except AttributeError:
+            if ann_name in annotations:
+                field_info = FieldInfo.from_annotation(ann_type)
+            else:
+                # if field has no default value and is not in __annotations__ this means that it is
+                # defined in a base class and we can take it from there
+                model_fields_lookup: dict[str, FieldInfo] = {}
+                for x in cls.__bases__[::-1]:
+                    model_fields_lookup.update(getattr(x, 'model_fields', {}))
+                if ann_name in model_fields_lookup:
+                    # The field was present on one of the (possibly multiple) base classes
+                    # copy the field to make sure typevar substitutions don't cause issues with the base classes
+                    field_info = copy(model_fields_lookup[ann_name])
+                else:
+                    # The field was not found on any base classes; this seems to be caused by fields not getting
+                    # generated thanks to models not being fully defined while initializing recursive models.
+                    # Nothing stops us from just creating a new FieldInfo for this type hint, so we do this.
+                    field_info = FieldInfo.from_annotation(ann_type)
+        else:
+            field_info = FieldInfo.from_annotated_attribute(ann_type, default)
+            # attributes which are fields are removed from the class namespace:
+            # 1. To match the behaviour of annotation-only fields
+            # 2. To avoid false positives in the NameError check above
+            try:
+                delattr(cls, ann_name)
+            except AttributeError:
+                pass  # indicates the attribute was on a parent class
+
+        # Use cls.__dict__['__pydantic_decorators__'] instead of cls.__pydantic_decorators__
+        # to make sure the decorators have already been built for this exact class
+        decorators: DecoratorInfos = cls.__dict__['__pydantic_decorators__']
+        if ann_name in decorators.computed_fields:
+            raise ValueError("you can't override a field with a computed field")
+        fields[ann_name] = field_info
+
+    if typevars_map:
+        for field in fields.values():
+            field.apply_typevars_map(typevars_map, types_namespace)
+
+    return fields, class_vars
+
+
+def _is_finalvar_with_default_val(type_: type[Any], val: Any) -> bool:
+    from ..fields import FieldInfo
+
+    if not is_finalvar(type_):
+        return False
+    elif val is PydanticUndefined:
+        return False
+    elif isinstance(val, FieldInfo) and (val.default is PydanticUndefined and val.default_factory is None):
+        return False
+    else:
+        return True
+
+
+def collect_dataclass_fields(
+    cls: type[StandardDataclass], types_namespace: dict[str, Any] | None, *, typevars_map: dict[Any, Any] | None = None
+) -> dict[str, FieldInfo]:
+    """Collect the fields of a dataclass.
+
+    Args:
+        cls: dataclass.
+        types_namespace: Optional extra namespace to look for types in.
+        typevars_map: A dictionary mapping type variables to their concrete types.
+
+    Returns:
+        The dataclass fields.
+    """
+    from ..fields import FieldInfo
+
+    fields: dict[str, FieldInfo] = {}
+    dataclass_fields: dict[str, dataclasses.Field] = cls.__dataclass_fields__
+    cls_localns = dict(vars(cls))  # this matches get_cls_type_hints_lenient, but all tests pass with `= None` instead
+
+    source_module = sys.modules.get(cls.__module__)
+    if source_module is not None:
+        types_namespace = {**source_module.__dict__, **(types_namespace or {})}
+
+    for ann_name, dataclass_field in dataclass_fields.items():
+        ann_type = _typing_extra.eval_type_lenient(dataclass_field.type, types_namespace, cls_localns)
+        if is_classvar(ann_type):
+            continue
+
+        if (
+            not dataclass_field.init
+            and dataclass_field.default == dataclasses.MISSING
+            and dataclass_field.default_factory == dataclasses.MISSING
+        ):
+            # TODO: We should probably do something with this so that validate_assignment behaves properly
+            #   Issue: https://github.com/pydantic/pydantic/issues/5470
+            continue
+
+        if isinstance(dataclass_field.default, FieldInfo):
+            if dataclass_field.default.init_var:
+                if dataclass_field.default.init is False:
+                    raise PydanticUserError(
+                        f'Dataclass field {ann_name} has init=False and init_var=True, but these are mutually exclusive.',
+                        code='clashing-init-and-init-var',
+                    )
+
+                # TODO: same note as above re validate_assignment
+                continue
+            field_info = FieldInfo.from_annotated_attribute(ann_type, dataclass_field.default)
+        else:
+            field_info = FieldInfo.from_annotated_attribute(ann_type, dataclass_field)
+
+        fields[ann_name] = field_info
+
+        if field_info.default is not PydanticUndefined and isinstance(getattr(cls, ann_name, field_info), FieldInfo):
+            # We need this to fix the default when the "default" from __dataclass_fields__ is a pydantic.FieldInfo
+            setattr(cls, ann_name, field_info.default)
+
+    if typevars_map:
+        for field in fields.values():
+            field.apply_typevars_map(typevars_map, types_namespace)
+
+    return fields
+
+
+def is_valid_field_name(name: str) -> bool:
+    return not name.startswith('_')
+
+
+def is_valid_privateattr_name(name: str) -> bool:
+    return name.startswith('_') and not name.startswith('__')
diff --git a/lib/pydantic/_internal/_forward_ref.py b/lib/pydantic/_internal/_forward_ref.py
new file mode 100644
index 00000000..231f81d1
--- /dev/null
+++ b/lib/pydantic/_internal/_forward_ref.py
@@ -0,0 +1,23 @@
+from __future__ import annotations as _annotations
+
+from dataclasses import dataclass
+from typing import Union
+
+
+@dataclass
+class PydanticRecursiveRef:
+    type_ref: str
+
+    __name__ = 'PydanticRecursiveRef'
+    __hash__ = object.__hash__
+
+    def __call__(self) -> None:
+        """Defining __call__ is necessary for the `typing` module to let you use an instance of
+        this class as the result of resolving a standard ForwardRef.
+        """
+
+    def __or__(self, other):
+        return Union[self, other]  # type: ignore
+
+    def __ror__(self, other):
+        return Union[other, self]  # type: ignore
diff --git a/lib/pydantic/_internal/_generate_schema.py b/lib/pydantic/_internal/_generate_schema.py
new file mode 100644
index 00000000..6ab7ec19
--- /dev/null
+++ b/lib/pydantic/_internal/_generate_schema.py
@@ -0,0 +1,2231 @@
+"""Convert python types to pydantic-core schema."""
+from __future__ import annotations as _annotations
+
+import collections.abc
+import dataclasses
+import inspect
+import re
+import sys
+import typing
+import warnings
+from contextlib import contextmanager
+from copy import copy, deepcopy
+from enum import Enum
+from functools import partial
+from inspect import Parameter, _ParameterKind, signature
+from itertools import chain
+from operator import attrgetter
+from types import FunctionType, LambdaType, MethodType
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    Dict,
+    Final,
+    ForwardRef,
+    Iterable,
+    Iterator,
+    Mapping,
+    Type,
+    TypeVar,
+    Union,
+    cast,
+    overload,
+)
+from warnings import warn
+
+from pydantic_core import CoreSchema, PydanticUndefined, core_schema, to_jsonable_python
+from typing_extensions import Annotated, Literal, TypeAliasType, TypedDict, get_args, get_origin, is_typeddict
+
+from ..aliases import AliasGenerator
+from ..annotated_handlers import GetCoreSchemaHandler, GetJsonSchemaHandler
+from ..config import ConfigDict, JsonDict, JsonEncoder
+from ..errors import PydanticSchemaGenerationError, PydanticUndefinedAnnotation, PydanticUserError
+from ..json_schema import JsonSchemaValue
+from ..version import version_short
+from ..warnings import PydanticDeprecatedSince20
+from . import _core_utils, _decorators, _discriminated_union, _known_annotated_metadata, _typing_extra
+from ._config import ConfigWrapper, ConfigWrapperStack
+from ._core_metadata import CoreMetadataHandler, build_metadata_dict
+from ._core_utils import (
+    CoreSchemaOrField,
+    collect_invalid_schemas,
+    define_expected_missing_refs,
+    get_ref,
+    get_type_ref,
+    is_function_with_inner_schema,
+    is_list_like_schema_with_items_schema,
+    simplify_schema_references,
+    validate_core_schema,
+)
+from ._decorators import (
+    Decorator,
+    DecoratorInfos,
+    FieldSerializerDecoratorInfo,
+    FieldValidatorDecoratorInfo,
+    ModelSerializerDecoratorInfo,
+    ModelValidatorDecoratorInfo,
+    RootValidatorDecoratorInfo,
+    ValidatorDecoratorInfo,
+    get_attribute_from_bases,
+    inspect_field_serializer,
+    inspect_model_serializer,
+    inspect_validator,
+)
+from ._fields import collect_dataclass_fields, get_type_hints_infer_globalns
+from ._forward_ref import PydanticRecursiveRef
+from ._generics import get_standard_typevars_map, has_instance_in_type, recursively_defined_type_refs, replace_types
+from ._schema_generation_shared import (
+    CallbackGetCoreSchemaHandler,
+)
+from ._typing_extra import is_finalvar
+from ._utils import lenient_issubclass
+
+if TYPE_CHECKING:
+    from ..fields import ComputedFieldInfo, FieldInfo
+    from ..main import BaseModel
+    from ..types import Discriminator
+    from ..validators import FieldValidatorModes
+    from ._dataclasses import StandardDataclass
+    from ._schema_generation_shared import GetJsonSchemaFunction
+
+_SUPPORTS_TYPEDDICT = sys.version_info >= (3, 12)
+_AnnotatedType = type(Annotated[int, 123])
+
+FieldDecoratorInfo = Union[ValidatorDecoratorInfo, FieldValidatorDecoratorInfo, FieldSerializerDecoratorInfo]
+FieldDecoratorInfoType = TypeVar('FieldDecoratorInfoType', bound=FieldDecoratorInfo)
+AnyFieldDecorator = Union[
+    Decorator[ValidatorDecoratorInfo],
+    Decorator[FieldValidatorDecoratorInfo],
+    Decorator[FieldSerializerDecoratorInfo],
+]
+
+ModifyCoreSchemaWrapHandler = GetCoreSchemaHandler
+GetCoreSchemaFunction = Callable[[Any, ModifyCoreSchemaWrapHandler], core_schema.CoreSchema]
+
+
+TUPLE_TYPES: list[type] = [tuple, typing.Tuple]
+LIST_TYPES: list[type] = [list, typing.List, collections.abc.MutableSequence]
+SET_TYPES: list[type] = [set, typing.Set, collections.abc.MutableSet]
+FROZEN_SET_TYPES: list[type] = [frozenset, typing.FrozenSet, collections.abc.Set]
+DICT_TYPES: list[type] = [dict, typing.Dict, collections.abc.MutableMapping, collections.abc.Mapping]
+
+
+def check_validator_fields_against_field_name(
+    info: FieldDecoratorInfo,
+    field: str,
+) -> bool:
+    """Check if field name is in validator fields.
+
+    Args:
+        info: The field info.
+        field: The field name to check.
+
+    Returns:
+        `True` if field name is in validator fields, `False` otherwise.
+    """
+    if isinstance(info, (ValidatorDecoratorInfo, FieldValidatorDecoratorInfo)):
+        if '*' in info.fields:
+            return True
+    for v_field_name in info.fields:
+        if v_field_name == field:
+            return True
+    return False
+
+
+def check_decorator_fields_exist(decorators: Iterable[AnyFieldDecorator], fields: Iterable[str]) -> None:
+    """Check if the defined fields in decorators exist in `fields` param.
+
+    It ignores the check for a decorator if the decorator has `*` as field or `check_fields=False`.
+
+    Args:
+        decorators: An iterable of decorators.
+        fields: An iterable of fields name.
+
+    Raises:
+        PydanticUserError: If one of the field names does not exist in `fields` param.
+    """
+    fields = set(fields)
+    for dec in decorators:
+        if isinstance(dec.info, (ValidatorDecoratorInfo, FieldValidatorDecoratorInfo)) and '*' in dec.info.fields:
+            continue
+        if dec.info.check_fields is False:
+            continue
+        for field in dec.info.fields:
+            if field not in fields:
+                raise PydanticUserError(
+                    f'Decorators defined with incorrect fields: {dec.cls_ref}.{dec.cls_var_name}'
+                    " (use check_fields=False if you're inheriting from the model and intended this)",
+                    code='decorator-missing-field',
+                )
+
+
+def filter_field_decorator_info_by_field(
+    validator_functions: Iterable[Decorator[FieldDecoratorInfoType]], field: str
+) -> list[Decorator[FieldDecoratorInfoType]]:
+    return [dec for dec in validator_functions if check_validator_fields_against_field_name(dec.info, field)]
+
+
+def apply_each_item_validators(
+    schema: core_schema.CoreSchema,
+    each_item_validators: list[Decorator[ValidatorDecoratorInfo]],
+    field_name: str | None,
+) -> core_schema.CoreSchema:
+    # This V1 compatibility shim should eventually be removed
+
+    # push down any `each_item=True` validators
+    # note that this won't work for any Annotated types that get wrapped by a function validator
+    # but that's okay because that didn't exist in V1
+    if schema['type'] == 'nullable':
+        schema['schema'] = apply_each_item_validators(schema['schema'], each_item_validators, field_name)
+        return schema
+    elif schema['type'] == 'tuple':
+        if (variadic_item_index := schema.get('variadic_item_index')) is not None:
+            schema['items_schema'][variadic_item_index] = apply_validators(
+                schema['items_schema'][variadic_item_index], each_item_validators, field_name
+            )
+    elif is_list_like_schema_with_items_schema(schema):
+        inner_schema = schema.get('items_schema', None)
+        if inner_schema is None:
+            inner_schema = core_schema.any_schema()
+        schema['items_schema'] = apply_validators(inner_schema, each_item_validators, field_name)
+    elif schema['type'] == 'dict':
+        # push down any `each_item=True` validators onto dict _values_
+        # this is super arbitrary but it's the V1 behavior
+        inner_schema = schema.get('values_schema', None)
+        if inner_schema is None:
+            inner_schema = core_schema.any_schema()
+        schema['values_schema'] = apply_validators(inner_schema, each_item_validators, field_name)
+    elif each_item_validators:
+        raise TypeError(
+            f"`@validator(..., each_item=True)` cannot be applied to fields with a schema of {schema['type']}"
+        )
+    return schema
+
+
+def modify_model_json_schema(
+    schema_or_field: CoreSchemaOrField, handler: GetJsonSchemaHandler, *, cls: Any
+) -> JsonSchemaValue:
+    """Add title and description for model-like classes' JSON schema.
+
+    Args:
+        schema_or_field: The schema data to generate a JSON schema from.
+        handler: The `GetCoreSchemaHandler` instance.
+        cls: The model-like class.
+
+    Returns:
+        JsonSchemaValue: The updated JSON schema.
+    """
+    from ..main import BaseModel
+
+    json_schema = handler(schema_or_field)
+    original_schema = handler.resolve_ref_schema(json_schema)
+    # Preserve the fact that definitions schemas should never have sibling keys:
+    if '$ref' in original_schema:
+        ref = original_schema['$ref']
+        original_schema.clear()
+        original_schema['allOf'] = [{'$ref': ref}]
+    if 'title' not in original_schema:
+        original_schema['title'] = cls.__name__
+    # BaseModel; don't use cls.__doc__ as it will contain the verbose class signature by default
+    docstring = None if cls is BaseModel else cls.__doc__
+    if docstring and 'description' not in original_schema:
+        original_schema['description'] = inspect.cleandoc(docstring)
+    return json_schema
+
+
+JsonEncoders = Dict[Type[Any], JsonEncoder]
+
+
+def _add_custom_serialization_from_json_encoders(
+    json_encoders: JsonEncoders | None, tp: Any, schema: CoreSchema
+) -> CoreSchema:
+    """Iterate over the json_encoders and add the first matching encoder to the schema.
+
+    Args:
+        json_encoders: A dictionary of types and their encoder functions.
+        tp: The type to check for a matching encoder.
+        schema: The schema to add the encoder to.
+    """
+    if not json_encoders:
+        return schema
+    if 'serialization' in schema:
+        return schema
+    # Check the class type and its superclasses for a matching encoder
+    # Decimal.__class__.__mro__ (and probably other cases) doesn't include Decimal itself
+    # if the type is a GenericAlias (e.g. from list[int]) we need to use __class__ instead of .__mro__
+    for base in (tp, *getattr(tp, '__mro__', tp.__class__.__mro__)[:-1]):
+        encoder = json_encoders.get(base)
+        if encoder is None:
+            continue
+
+        warnings.warn(
+            f'`json_encoders` is deprecated. See https://docs.pydantic.dev/{version_short()}/concepts/serialization/#custom-serializers for alternatives',
+            PydanticDeprecatedSince20,
+        )
+
+        # TODO: in theory we should check that the schema accepts a serialization key
+        schema['serialization'] = core_schema.plain_serializer_function_ser_schema(encoder, when_used='json')
+        return schema
+
+    return schema
+
+
+TypesNamespace = Union[Dict[str, Any], None]
+
+
+class TypesNamespaceStack:
+    """A stack of types namespaces."""
+
+    def __init__(self, types_namespace: TypesNamespace):
+        self._types_namespace_stack: list[TypesNamespace] = [types_namespace]
+
+    @property
+    def tail(self) -> TypesNamespace:
+        return self._types_namespace_stack[-1]
+
+    @contextmanager
+    def push(self, for_type: type[Any]):
+        types_namespace = {**_typing_extra.get_cls_types_namespace(for_type), **(self.tail or {})}
+        self._types_namespace_stack.append(types_namespace)
+        try:
+            yield
+        finally:
+            self._types_namespace_stack.pop()
+
+
+class GenerateSchema:
+    """Generate core schema for a Pydantic model, dataclass and types like `str`, `datetime`, ... ."""
+
+    __slots__ = (
+        '_config_wrapper_stack',
+        '_types_namespace_stack',
+        '_typevars_map',
+        '_has_invalid_schema',
+        'field_name_stack',
+        'defs',
+    )
+
+    def __init__(
+        self,
+        config_wrapper: ConfigWrapper,
+        types_namespace: dict[str, Any] | None,
+        typevars_map: dict[Any, Any] | None = None,
+    ) -> None:
+        # we need a stack for recursing into child models
+        self._config_wrapper_stack = ConfigWrapperStack(config_wrapper)
+        self._types_namespace_stack = TypesNamespaceStack(types_namespace)
+        self._typevars_map = typevars_map
+        self._has_invalid_schema = False
+        self.field_name_stack = _FieldNameStack()
+        self.defs = _Definitions()
+
+    @classmethod
+    def __from_parent(
+        cls,
+        config_wrapper_stack: ConfigWrapperStack,
+        types_namespace_stack: TypesNamespaceStack,
+        typevars_map: dict[Any, Any] | None,
+        defs: _Definitions,
+    ) -> GenerateSchema:
+        obj = cls.__new__(cls)
+        obj._config_wrapper_stack = config_wrapper_stack
+        obj._types_namespace_stack = types_namespace_stack
+        obj._typevars_map = typevars_map
+        obj._has_invalid_schema = False
+        obj.field_name_stack = _FieldNameStack()
+        obj.defs = defs
+        return obj
+
+    @property
+    def _config_wrapper(self) -> ConfigWrapper:
+        return self._config_wrapper_stack.tail
+
+    @property
+    def _types_namespace(self) -> dict[str, Any] | None:
+        return self._types_namespace_stack.tail
+
+    @property
+    def _current_generate_schema(self) -> GenerateSchema:
+        cls = self._config_wrapper.schema_generator or GenerateSchema
+        return cls.__from_parent(
+            self._config_wrapper_stack,
+            self._types_namespace_stack,
+            self._typevars_map,
+            self.defs,
+        )
+
+    @property
+    def _arbitrary_types(self) -> bool:
+        return self._config_wrapper.arbitrary_types_allowed
+
+    def str_schema(self) -> CoreSchema:
+        """Generate a CoreSchema for `str`"""
+        return core_schema.str_schema()
+
+    # the following methods can be overridden but should be considered
+    # unstable / private APIs
+    def _list_schema(self, tp: Any, items_type: Any) -> CoreSchema:
+        return core_schema.list_schema(self.generate_schema(items_type))
+
+    def _dict_schema(self, tp: Any, keys_type: Any, values_type: Any) -> CoreSchema:
+        return core_schema.dict_schema(self.generate_schema(keys_type), self.generate_schema(values_type))
+
+    def _set_schema(self, tp: Any, items_type: Any) -> CoreSchema:
+        return core_schema.set_schema(self.generate_schema(items_type))
+
+    def _frozenset_schema(self, tp: Any, items_type: Any) -> CoreSchema:
+        return core_schema.frozenset_schema(self.generate_schema(items_type))
+
+    def _arbitrary_type_schema(self, tp: Any) -> CoreSchema:
+        if not isinstance(tp, type):
+            warn(
+                f'{tp!r} is not a Python type (it may be an instance of an object),'
+                ' Pydantic will allow any object with no validation since we cannot even'
+                ' enforce that the input is an instance of the given type.'
+                ' To get rid of this error wrap the type with `pydantic.SkipValidation`.',
+                UserWarning,
+            )
+            return core_schema.any_schema()
+        return core_schema.is_instance_schema(tp)
+
+    def _unknown_type_schema(self, obj: Any) -> CoreSchema:
+        raise PydanticSchemaGenerationError(
+            f'Unable to generate pydantic-core schema for {obj!r}. '
+            'Set `arbitrary_types_allowed=True` in the model_config to ignore this error'
+            ' or implement `__get_pydantic_core_schema__` on your type to fully support it.'
+            '\n\nIf you got this error by calling handler(<some type>) within'
+            ' `__get_pydantic_core_schema__` then you likely need to call'
+            ' `handler.generate_schema(<some type>)` since we do not call'
+            ' `__get_pydantic_core_schema__` on `<some type>` otherwise to avoid infinite recursion.'
+        )
+
+    def _apply_discriminator_to_union(
+        self, schema: CoreSchema, discriminator: str | Discriminator | None
+    ) -> CoreSchema:
+        if discriminator is None:
+            return schema
+        try:
+            return _discriminated_union.apply_discriminator(
+                schema,
+                discriminator,
+            )
+        except _discriminated_union.MissingDefinitionForUnionRef:
+            # defer until defs are resolved
+            _discriminated_union.set_discriminator_in_metadata(
+                schema,
+                discriminator,
+            )
+            return schema
+
+    class CollectedInvalid(Exception):
+        pass
+
+    def clean_schema(self, schema: CoreSchema) -> CoreSchema:
+        schema = self.collect_definitions(schema)
+        schema = simplify_schema_references(schema)
+        schema = _discriminated_union.apply_discriminators(schema)
+        if collect_invalid_schemas(schema):
+            raise self.CollectedInvalid()
+        schema = validate_core_schema(schema)
+        return schema
+
+    def collect_definitions(self, schema: CoreSchema) -> CoreSchema:
+        ref = cast('str | None', schema.get('ref', None))
+        if ref:
+            self.defs.definitions[ref] = schema
+        if 'ref' in schema:
+            schema = core_schema.definition_reference_schema(schema['ref'])
+        return core_schema.definitions_schema(
+            schema,
+            list(self.defs.definitions.values()),
+        )
+
+    def _add_js_function(self, metadata_schema: CoreSchema, js_function: Callable[..., Any]) -> None:
+        metadata = CoreMetadataHandler(metadata_schema).metadata
+        pydantic_js_functions = metadata.setdefault('pydantic_js_functions', [])
+        # because of how we generate core schemas for nested generic models
+        # we can end up adding `BaseModel.__get_pydantic_json_schema__` multiple times
+        # this check may fail to catch duplicates if the function is a `functools.partial`
+        # or something like that
+        # but if it does it'll fail by inserting the duplicate
+        if js_function not in pydantic_js_functions:
+            pydantic_js_functions.append(js_function)
+
+    def generate_schema(
+        self,
+        obj: Any,
+        from_dunder_get_core_schema: bool = True,
+    ) -> core_schema.CoreSchema:
+        """Generate core schema.
+
+        Args:
+            obj: The object to generate core schema for.
+            from_dunder_get_core_schema: Whether to generate schema from either the
+                `__get_pydantic_core_schema__` function or `__pydantic_core_schema__` property.
+
+        Returns:
+            The generated core schema.
+
+        Raises:
+            PydanticUndefinedAnnotation:
+                If it is not possible to evaluate forward reference.
+            PydanticSchemaGenerationError:
+                If it is not possible to generate pydantic-core schema.
+            TypeError:
+                - If `alias_generator` returns a disallowed type (must be str, AliasPath or AliasChoices).
+                - If V1 style validator with `each_item=True` applied on a wrong field.
+            PydanticUserError:
+                - If `typing.TypedDict` is used instead of `typing_extensions.TypedDict` on Python < 3.12.
+                - If `__modify_schema__` method is used instead of `__get_pydantic_json_schema__`.
+        """
+        schema: CoreSchema | None = None
+
+        if from_dunder_get_core_schema:
+            from_property = self._generate_schema_from_property(obj, obj)
+            if from_property is not None:
+                schema = from_property
+
+        if schema is None:
+            schema = self._generate_schema(obj)
+
+        metadata_js_function = _extract_get_pydantic_json_schema(obj, schema)
+        if metadata_js_function is not None:
+            metadata_schema = resolve_original_schema(schema, self.defs.definitions)
+            if metadata_schema:
+                self._add_js_function(metadata_schema, metadata_js_function)
+
+        schema = _add_custom_serialization_from_json_encoders(self._config_wrapper.json_encoders, obj, schema)
+
+        schema = self._post_process_generated_schema(schema)
+
+        return schema
+
+    def _model_schema(self, cls: type[BaseModel]) -> core_schema.CoreSchema:
+        """Generate schema for a Pydantic model."""
+        with self.defs.get_schema_or_ref(cls) as (model_ref, maybe_schema):
+            if maybe_schema is not None:
+                return maybe_schema
+
+            fields = cls.model_fields
+            decorators = cls.__pydantic_decorators__
+            computed_fields = decorators.computed_fields
+            check_decorator_fields_exist(
+                chain(
+                    decorators.field_validators.values(),
+                    decorators.field_serializers.values(),
+                    decorators.validators.values(),
+                ),
+                {*fields.keys(), *computed_fields.keys()},
+            )
+            config_wrapper = ConfigWrapper(cls.model_config, check=False)
+            core_config = config_wrapper.core_config(cls)
+            metadata = build_metadata_dict(js_functions=[partial(modify_model_json_schema, cls=cls)])
+
+            model_validators = decorators.model_validators.values()
+
+            extras_schema = None
+            if core_config.get('extra_fields_behavior') == 'allow':
+                for tp in (cls, *cls.__mro__):
+                    extras_annotation = cls.__annotations__.get('__pydantic_extra__', None)
+                    if extras_annotation is not None:
+                        tp = get_origin(extras_annotation)
+                        if tp not in (Dict, dict):
+                            raise PydanticSchemaGenerationError(
+                                'The type annotation for `__pydantic_extra__` must be `Dict[str, ...]`'
+                            )
+                        extra_items_type = self._get_args_resolving_forward_refs(
+                            cls.__annotations__['__pydantic_extra__'],
+                            required=True,
+                        )[1]
+                        if extra_items_type is not Any:
+                            extras_schema = self.generate_schema(extra_items_type)
+                            break
+
+            with self._config_wrapper_stack.push(config_wrapper), self._types_namespace_stack.push(cls):
+                self = self._current_generate_schema
+                if cls.__pydantic_root_model__:
+                    root_field = self._common_field_schema('root', fields['root'], decorators)
+                    inner_schema = root_field['schema']
+                    inner_schema = apply_model_validators(inner_schema, model_validators, 'inner')
+                    model_schema = core_schema.model_schema(
+                        cls,
+                        inner_schema,
+                        custom_init=getattr(cls, '__pydantic_custom_init__', None),
+                        root_model=True,
+                        post_init=getattr(cls, '__pydantic_post_init__', None),
+                        config=core_config,
+                        ref=model_ref,
+                        metadata=metadata,
+                    )
+                else:
+                    fields_schema: core_schema.CoreSchema = core_schema.model_fields_schema(
+                        {k: self._generate_md_field_schema(k, v, decorators) for k, v in fields.items()},
+                        computed_fields=[
+                            self._computed_field_schema(d, decorators.field_serializers)
+                            for d in computed_fields.values()
+                        ],
+                        extras_schema=extras_schema,
+                        model_name=cls.__name__,
+                    )
+                    inner_schema = apply_validators(fields_schema, decorators.root_validators.values(), None)
+                    new_inner_schema = define_expected_missing_refs(inner_schema, recursively_defined_type_refs())
+                    if new_inner_schema is not None:
+                        inner_schema = new_inner_schema
+                    inner_schema = apply_model_validators(inner_schema, model_validators, 'inner')
+
+                    model_schema = core_schema.model_schema(
+                        cls,
+                        inner_schema,
+                        custom_init=getattr(cls, '__pydantic_custom_init__', None),
+                        root_model=False,
+                        post_init=getattr(cls, '__pydantic_post_init__', None),
+                        config=core_config,
+                        ref=model_ref,
+                        metadata=metadata,
+                    )
+
+                schema = self._apply_model_serializers(model_schema, decorators.model_serializers.values())
+                schema = apply_model_validators(schema, model_validators, 'outer')
+                self.defs.definitions[model_ref] = self._post_process_generated_schema(schema)
+                return core_schema.definition_reference_schema(model_ref)
+
+    def _unpack_refs_defs(self, schema: CoreSchema) -> CoreSchema:
+        """Unpack all 'definitions' schemas into `GenerateSchema.defs.definitions`
+        and return the inner schema.
+        """
+
+        def get_ref(s: CoreSchema) -> str:
+            return s['ref']  # type: ignore
+
+        if schema['type'] == 'definitions':
+            self.defs.definitions.update({get_ref(s): s for s in schema['definitions']})
+            schema = schema['schema']
+        return schema
+
+    def _generate_schema_from_property(self, obj: Any, source: Any) -> core_schema.CoreSchema | None:
+        """Try to generate schema from either the `__get_pydantic_core_schema__` function or
+        `__pydantic_core_schema__` property.
+
+        Note: `__get_pydantic_core_schema__` takes priority so it can
+        decide whether to use a `__pydantic_core_schema__` attribute, or generate a fresh schema.
+        """
+        # avoid calling `__get_pydantic_core_schema__` if we've already visited this object
+        with self.defs.get_schema_or_ref(obj) as (_, maybe_schema):
+            if maybe_schema is not None:
+                return maybe_schema
+        if obj is source:
+            ref_mode = 'unpack'
+        else:
+            ref_mode = 'to-def'
+
+        schema: CoreSchema
+        get_schema = getattr(obj, '__get_pydantic_core_schema__', None)
+        if get_schema is None:
+            validators = getattr(obj, '__get_validators__', None)
+            if validators is None:
+                return None
+            warn(
+                '`__get_validators__` is deprecated and will be removed, use `__get_pydantic_core_schema__` instead.',
+                PydanticDeprecatedSince20,
+            )
+            schema = core_schema.chain_schema([core_schema.with_info_plain_validator_function(v) for v in validators()])
+        else:
+            if len(inspect.signature(get_schema).parameters) == 1:
+                # (source) -> CoreSchema
+                schema = get_schema(source)
+            else:
+                schema = get_schema(
+                    source, CallbackGetCoreSchemaHandler(self._generate_schema, self, ref_mode=ref_mode)
+                )
+
+        schema = self._unpack_refs_defs(schema)
+
+        if is_function_with_inner_schema(schema):
+            ref = schema['schema'].pop('ref', None)  # pyright: ignore[reportGeneralTypeIssues]
+            if ref:
+                schema['ref'] = ref
+        else:
+            ref = get_ref(schema)
+
+        if ref:
+            self.defs.definitions[ref] = self._post_process_generated_schema(schema)
+            return core_schema.definition_reference_schema(ref)
+
+        schema = self._post_process_generated_schema(schema)
+
+        return schema
+
+    def _resolve_forward_ref(self, obj: Any) -> Any:
+        # we assume that types_namespace has the target of forward references in its scope,
+        # but this could fail, for example, if calling Validator on an imported type which contains
+        # forward references to other types only defined in the module from which it was imported
+        # `Validator(SomeImportedTypeAliasWithAForwardReference)`
+        # or the equivalent for BaseModel
+        # class Model(BaseModel):
+        #   x: SomeImportedTypeAliasWithAForwardReference
+        try:
+            obj = _typing_extra.eval_type_backport(obj, globalns=self._types_namespace)
+        except NameError as e:
+            raise PydanticUndefinedAnnotation.from_name_error(e) from e
+
+        # if obj is still a ForwardRef, it means we can't evaluate it, raise PydanticUndefinedAnnotation
+        if isinstance(obj, ForwardRef):
+            raise PydanticUndefinedAnnotation(obj.__forward_arg__, f'Unable to evaluate forward reference {obj}')
+
+        if self._typevars_map:
+            obj = replace_types(obj, self._typevars_map)
+
+        return obj
+
+    @overload
+    def _get_args_resolving_forward_refs(self, obj: Any, required: Literal[True]) -> tuple[Any, ...]:
+        ...
+
+    @overload
+    def _get_args_resolving_forward_refs(self, obj: Any) -> tuple[Any, ...] | None:
+        ...
+
+    def _get_args_resolving_forward_refs(self, obj: Any, required: bool = False) -> tuple[Any, ...] | None:
+        args = get_args(obj)
+        if args:
+            args = tuple([self._resolve_forward_ref(a) if isinstance(a, ForwardRef) else a for a in args])
+        elif required:  # pragma: no cover
+            raise TypeError(f'Expected {obj} to have generic parameters but it had none')
+        return args
+
+    def _get_first_arg_or_any(self, obj: Any) -> Any:
+        args = self._get_args_resolving_forward_refs(obj)
+        if not args:
+            return Any
+        return args[0]
+
+    def _get_first_two_args_or_any(self, obj: Any) -> tuple[Any, Any]:
+        args = self._get_args_resolving_forward_refs(obj)
+        if not args:
+            return (Any, Any)
+        if len(args) < 2:
+            origin = get_origin(obj)
+            raise TypeError(f'Expected two type arguments for {origin}, got 1')
+        return args[0], args[1]
+
+    def _post_process_generated_schema(self, schema: core_schema.CoreSchema) -> core_schema.CoreSchema:
+        if 'metadata' not in schema:
+            schema['metadata'] = {}
+        return schema
+
+    def _generate_schema(self, obj: Any) -> core_schema.CoreSchema:
+        """Recursively generate a pydantic-core schema for any supported python type."""
+        has_invalid_schema = self._has_invalid_schema
+        self._has_invalid_schema = False
+        schema = self._generate_schema_inner(obj)
+        self._has_invalid_schema = self._has_invalid_schema or has_invalid_schema
+        return schema
+
+    def _generate_schema_inner(self, obj: Any) -> core_schema.CoreSchema:
+        if isinstance(obj, _AnnotatedType):
+            return self._annotated_schema(obj)
+
+        if isinstance(obj, dict):
+            # we assume this is already a valid schema
+            return obj  # type: ignore[return-value]
+
+        if isinstance(obj, str):
+            obj = ForwardRef(obj)
+
+        if isinstance(obj, ForwardRef):
+            return self.generate_schema(self._resolve_forward_ref(obj))
+
+        from ..main import BaseModel
+
+        if lenient_issubclass(obj, BaseModel):
+            return self._model_schema(obj)
+
+        if isinstance(obj, PydanticRecursiveRef):
+            return core_schema.definition_reference_schema(schema_ref=obj.type_ref)
+
+        return self.match_type(obj)
+
+    def match_type(self, obj: Any) -> core_schema.CoreSchema:  # noqa: C901
+        """Main mapping of types to schemas.
+
+        The general structure is a series of if statements starting with the simple cases
+        (non-generic primitive types) and then handling generics and other more complex cases.
+
+        Each case either generates a schema directly, calls into a public user-overridable method
+        (like `GenerateSchema.tuple_variable_schema`) or calls into a private method that handles some
+        boilerplate before calling into the user-facing method (e.g. `GenerateSchema._tuple_schema`).
+
+        The idea is that we'll evolve this into adding more and more user facing methods over time
+        as they get requested and we figure out what the right API for them is.
+        """
+        if obj is str:
+            return self.str_schema()
+        elif obj is bytes:
+            return core_schema.bytes_schema()
+        elif obj is int:
+            return core_schema.int_schema()
+        elif obj is float:
+            return core_schema.float_schema()
+        elif obj is bool:
+            return core_schema.bool_schema()
+        elif obj is Any or obj is object:
+            return core_schema.any_schema()
+        elif obj is None or obj is _typing_extra.NoneType:
+            return core_schema.none_schema()
+        elif obj in TUPLE_TYPES:
+            return self._tuple_schema(obj)
+        elif obj in LIST_TYPES:
+            return self._list_schema(obj, self._get_first_arg_or_any(obj))
+        elif obj in SET_TYPES:
+            return self._set_schema(obj, self._get_first_arg_or_any(obj))
+        elif obj in FROZEN_SET_TYPES:
+            return self._frozenset_schema(obj, self._get_first_arg_or_any(obj))
+        elif obj in DICT_TYPES:
+            return self._dict_schema(obj, *self._get_first_two_args_or_any(obj))
+        elif isinstance(obj, TypeAliasType):
+            return self._type_alias_type_schema(obj)
+        elif obj == type:
+            return self._type_schema()
+        elif _typing_extra.is_callable_type(obj):
+            return core_schema.callable_schema()
+        elif _typing_extra.is_literal_type(obj):
+            return self._literal_schema(obj)
+        elif is_typeddict(obj):
+            return self._typed_dict_schema(obj, None)
+        elif _typing_extra.is_namedtuple(obj):
+            return self._namedtuple_schema(obj, None)
+        elif _typing_extra.is_new_type(obj):
+            # NewType, can't use isinstance because it fails <3.10
+            return self.generate_schema(obj.__supertype__)
+        elif obj == re.Pattern:
+            return self._pattern_schema(obj)
+        elif obj is collections.abc.Hashable or obj is typing.Hashable:
+            return self._hashable_schema()
+        elif isinstance(obj, typing.TypeVar):
+            return self._unsubstituted_typevar_schema(obj)
+        elif is_finalvar(obj):
+            if obj is Final:
+                return core_schema.any_schema()
+            return self.generate_schema(
+                self._get_first_arg_or_any(obj),
+            )
+        elif isinstance(obj, (FunctionType, LambdaType, MethodType, partial)):
+            return self._callable_schema(obj)
+        elif inspect.isclass(obj) and issubclass(obj, Enum):
+            from ._std_types_schema import get_enum_core_schema
+
+            return get_enum_core_schema(obj, self._config_wrapper.config_dict)
+
+        if _typing_extra.is_dataclass(obj):
+            return self._dataclass_schema(obj, None)
+
+        res = self._get_prepare_pydantic_annotations_for_known_type(obj, ())
+        if res is not None:
+            source_type, annotations = res
+            return self._apply_annotations(source_type, annotations)
+
+        origin = get_origin(obj)
+        if origin is not None:
+            return self._match_generic_type(obj, origin)
+
+        if self._arbitrary_types:
+            return self._arbitrary_type_schema(obj)
+        return self._unknown_type_schema(obj)
+
+    def _match_generic_type(self, obj: Any, origin: Any) -> CoreSchema:  # noqa: C901
+        if isinstance(origin, TypeAliasType):
+            return self._type_alias_type_schema(obj)
+
+        # Need to handle generic dataclasses before looking for the schema properties because attribute accesses
+        # on _GenericAlias delegate to the origin type, so lose the information about the concrete parametrization
+        # As a result, currently, there is no way to cache the schema for generic dataclasses. This may be possible
+        # to resolve by modifying the value returned by `Generic.__class_getitem__`, but that is a dangerous game.
+        if _typing_extra.is_dataclass(origin):
+            return self._dataclass_schema(obj, origin)
+        if _typing_extra.is_namedtuple(origin):
+            return self._namedtuple_schema(obj, origin)
+
+        from_property = self._generate_schema_from_property(origin, obj)
+        if from_property is not None:
+            return from_property
+
+        if _typing_extra.origin_is_union(origin):
+            return self._union_schema(obj)
+        elif origin in TUPLE_TYPES:
+            return self._tuple_schema(obj)
+        elif origin in LIST_TYPES:
+            return self._list_schema(obj, self._get_first_arg_or_any(obj))
+        elif origin in SET_TYPES:
+            return self._set_schema(obj, self._get_first_arg_or_any(obj))
+        elif origin in FROZEN_SET_TYPES:
+            return self._frozenset_schema(obj, self._get_first_arg_or_any(obj))
+        elif origin in DICT_TYPES:
+            return self._dict_schema(obj, *self._get_first_two_args_or_any(obj))
+        elif is_typeddict(origin):
+            return self._typed_dict_schema(obj, origin)
+        elif origin in (typing.Type, type):
+            return self._subclass_schema(obj)
+        elif origin in {typing.Sequence, collections.abc.Sequence}:
+            return self._sequence_schema(obj)
+        elif origin in {typing.Iterable, collections.abc.Iterable, typing.Generator, collections.abc.Generator}:
+            return self._iterable_schema(obj)
+        elif origin in (re.Pattern, typing.Pattern):
+            return self._pattern_schema(obj)
+
+        if self._arbitrary_types:
+            return self._arbitrary_type_schema(origin)
+        return self._unknown_type_schema(obj)
+
+    def _generate_td_field_schema(
+        self,
+        name: str,
+        field_info: FieldInfo,
+        decorators: DecoratorInfos,
+        *,
+        required: bool = True,
+    ) -> core_schema.TypedDictField:
+        """Prepare a TypedDictField to represent a model or typeddict field."""
+        common_field = self._common_field_schema(name, field_info, decorators)
+        return core_schema.typed_dict_field(
+            common_field['schema'],
+            required=False if not field_info.is_required() else required,
+            serialization_exclude=common_field['serialization_exclude'],
+            validation_alias=common_field['validation_alias'],
+            serialization_alias=common_field['serialization_alias'],
+            metadata=common_field['metadata'],
+        )
+
+    def _generate_md_field_schema(
+        self,
+        name: str,
+        field_info: FieldInfo,
+        decorators: DecoratorInfos,
+    ) -> core_schema.ModelField:
+        """Prepare a ModelField to represent a model field."""
+        common_field = self._common_field_schema(name, field_info, decorators)
+        return core_schema.model_field(
+            common_field['schema'],
+            serialization_exclude=common_field['serialization_exclude'],
+            validation_alias=common_field['validation_alias'],
+            serialization_alias=common_field['serialization_alias'],
+            frozen=common_field['frozen'],
+            metadata=common_field['metadata'],
+        )
+
+    def _generate_dc_field_schema(
+        self,
+        name: str,
+        field_info: FieldInfo,
+        decorators: DecoratorInfos,
+    ) -> core_schema.DataclassField:
+        """Prepare a DataclassField to represent the parameter/field, of a dataclass."""
+        common_field = self._common_field_schema(name, field_info, decorators)
+        return core_schema.dataclass_field(
+            name,
+            common_field['schema'],
+            init=field_info.init,
+            init_only=field_info.init_var or None,
+            kw_only=None if field_info.kw_only else False,
+            serialization_exclude=common_field['serialization_exclude'],
+            validation_alias=common_field['validation_alias'],
+            serialization_alias=common_field['serialization_alias'],
+            frozen=common_field['frozen'],
+            metadata=common_field['metadata'],
+        )
+
+    @staticmethod
+    def _apply_alias_generator_to_field_info(
+        alias_generator: Callable[[str], str] | AliasGenerator, field_info: FieldInfo, field_name: str
+    ) -> None:
+        """Apply an alias_generator to aliases on a FieldInfo instance if appropriate.
+
+        Args:
+            alias_generator: A callable that takes a string and returns a string, or an AliasGenerator instance.
+            field_info: The FieldInfo instance to which the alias_generator is (maybe) applied.
+            field_name: The name of the field from which to generate the alias.
+        """
+        # Apply an alias_generator if
+        # 1. An alias is not specified
+        # 2. An alias is specified, but the priority is <= 1
+        if (
+            field_info.alias_priority is None
+            or field_info.alias_priority <= 1
+            or field_info.alias is None
+            or field_info.validation_alias is None
+            or field_info.serialization_alias is None
+        ):
+            alias, validation_alias, serialization_alias = None, None, None
+
+            if isinstance(alias_generator, AliasGenerator):
+                alias, validation_alias, serialization_alias = alias_generator.generate_aliases(field_name)
+            elif isinstance(alias_generator, Callable):
+                alias = alias_generator(field_name)
+                if not isinstance(alias, str):
+                    raise TypeError(f'alias_generator {alias_generator} must return str, not {alias.__class__}')
+
+            # if priority is not set, we set to 1
+            # which supports the case where the alias_generator from a child class is used
+            # to generate an alias for a field in a parent class
+            if field_info.alias_priority is None or field_info.alias_priority <= 1:
+                field_info.alias_priority = 1
+
+            # if the priority is 1, then we set the aliases to the generated alias
+            if field_info.alias_priority == 1:
+                field_info.serialization_alias = serialization_alias or alias
+                field_info.validation_alias = validation_alias or alias
+                field_info.alias = alias
+
+            # if any of the aliases are not set, then we set them to the corresponding generated alias
+            if field_info.alias is None:
+                field_info.alias = alias
+            if field_info.serialization_alias is None:
+                field_info.serialization_alias = serialization_alias or alias
+            if field_info.validation_alias is None:
+                field_info.validation_alias = validation_alias or alias
+
+    @staticmethod
+    def _apply_alias_generator_to_computed_field_info(
+        alias_generator: Callable[[str], str] | AliasGenerator,
+        computed_field_info: ComputedFieldInfo,
+        computed_field_name: str,
+    ):
+        """Apply an alias_generator to alias on a ComputedFieldInfo instance if appropriate.
+
+        Args:
+            alias_generator: A callable that takes a string and returns a string, or an AliasGenerator instance.
+            computed_field_info: The ComputedFieldInfo instance to which the alias_generator is (maybe) applied.
+            computed_field_name: The name of the computed field from which to generate the alias.
+        """
+        # Apply an alias_generator if
+        # 1. An alias is not specified
+        # 2. An alias is specified, but the priority is <= 1
+
+        if (
+            computed_field_info.alias_priority is None
+            or computed_field_info.alias_priority <= 1
+            or computed_field_info.alias is None
+        ):
+            alias, validation_alias, serialization_alias = None, None, None
+
+            if isinstance(alias_generator, AliasGenerator):
+                alias, validation_alias, serialization_alias = alias_generator.generate_aliases(computed_field_name)
+            elif isinstance(alias_generator, Callable):
+                alias = alias_generator(computed_field_name)
+                if not isinstance(alias, str):
+                    raise TypeError(f'alias_generator {alias_generator} must return str, not {alias.__class__}')
+
+            # if priority is not set, we set to 1
+            # which supports the case where the alias_generator from a child class is used
+            # to generate an alias for a field in a parent class
+            if computed_field_info.alias_priority is None or computed_field_info.alias_priority <= 1:
+                computed_field_info.alias_priority = 1
+
+            # if the priority is 1, then we set the aliases to the generated alias
+            # note that we use the serialization_alias with priority over alias, as computed_field
+            # aliases are used for serialization only (not validation)
+            if computed_field_info.alias_priority == 1:
+                computed_field_info.alias = serialization_alias or alias
+
+    def _common_field_schema(  # C901
+        self, name: str, field_info: FieldInfo, decorators: DecoratorInfos
+    ) -> _CommonField:
+        # Update FieldInfo annotation if appropriate:
+        from .. import AliasChoices, AliasPath
+        from ..fields import FieldInfo
+
+        if has_instance_in_type(field_info.annotation, (ForwardRef, str)):
+            types_namespace = self._types_namespace
+            if self._typevars_map:
+                types_namespace = (types_namespace or {}).copy()
+                # Ensure that typevars get mapped to their concrete types:
+                types_namespace.update({k.__name__: v for k, v in self._typevars_map.items()})
+
+            evaluated = _typing_extra.eval_type_lenient(field_info.annotation, types_namespace)
+            if evaluated is not field_info.annotation and not has_instance_in_type(evaluated, PydanticRecursiveRef):
+                new_field_info = FieldInfo.from_annotation(evaluated)
+                field_info.annotation = new_field_info.annotation
+
+                # Handle any field info attributes that may have been obtained from now-resolved annotations
+                for k, v in new_field_info._attributes_set.items():
+                    # If an attribute is already set, it means it was set by assigning to a call to Field (or just a
+                    # default value), and that should take the highest priority. So don't overwrite existing attributes.
+                    # We skip over "attributes" that are present in the metadata_lookup dict because these won't
+                    # actually end up as attributes of the `FieldInfo` instance.
+                    if k not in field_info._attributes_set and k not in field_info.metadata_lookup:
+                        setattr(field_info, k, v)
+
+                # Finally, ensure the field info also reflects all the `_attributes_set` that are actually metadata.
+                field_info.metadata = [*new_field_info.metadata, *field_info.metadata]
+
+        source_type, annotations = field_info.annotation, field_info.metadata
+
+        def set_discriminator(schema: CoreSchema) -> CoreSchema:
+            schema = self._apply_discriminator_to_union(schema, field_info.discriminator)
+            return schema
+
+        with self.field_name_stack.push(name):
+            if field_info.discriminator is not None:
+                schema = self._apply_annotations(source_type, annotations, transform_inner_schema=set_discriminator)
+            else:
+                schema = self._apply_annotations(
+                    source_type,
+                    annotations,
+                )
+
+        # This V1 compatibility shim should eventually be removed
+        # push down any `each_item=True` validators
+        # note that this won't work for any Annotated types that get wrapped by a function validator
+        # but that's okay because that didn't exist in V1
+        this_field_validators = filter_field_decorator_info_by_field(decorators.validators.values(), name)
+        if _validators_require_validate_default(this_field_validators):
+            field_info.validate_default = True
+        each_item_validators = [v for v in this_field_validators if v.info.each_item is True]
+        this_field_validators = [v for v in this_field_validators if v not in each_item_validators]
+        schema = apply_each_item_validators(schema, each_item_validators, name)
+
+        schema = apply_validators(schema, filter_field_decorator_info_by_field(this_field_validators, name), name)
+        schema = apply_validators(
+            schema, filter_field_decorator_info_by_field(decorators.field_validators.values(), name), name
+        )
+
+        # the default validator needs to go outside of any other validators
+        # so that it is the topmost validator for the field validator
+        # which uses it to check if the field has a default value or not
+        if not field_info.is_required():
+            schema = wrap_default(field_info, schema)
+
+        schema = self._apply_field_serializers(
+            schema, filter_field_decorator_info_by_field(decorators.field_serializers.values(), name)
+        )
+        json_schema_updates = {
+            'title': field_info.title,
+            'description': field_info.description,
+            'examples': to_jsonable_python(field_info.examples),
+        }
+        json_schema_updates = {k: v for k, v in json_schema_updates.items() if v is not None}
+
+        json_schema_extra = field_info.json_schema_extra
+
+        metadata = build_metadata_dict(
+            js_annotation_functions=[get_json_schema_update_func(json_schema_updates, json_schema_extra)]
+        )
+
+        alias_generator = self._config_wrapper.alias_generator
+        if alias_generator is not None:
+            self._apply_alias_generator_to_field_info(alias_generator, field_info, name)
+
+        if isinstance(field_info.validation_alias, (AliasChoices, AliasPath)):
+            validation_alias = field_info.validation_alias.convert_to_aliases()
+        else:
+            validation_alias = field_info.validation_alias
+
+        return _common_field(
+            schema,
+            serialization_exclude=True if field_info.exclude else None,
+            validation_alias=validation_alias,
+            serialization_alias=field_info.serialization_alias,
+            frozen=field_info.frozen,
+            metadata=metadata,
+        )
+
+    def _union_schema(self, union_type: Any) -> core_schema.CoreSchema:
+        """Generate schema for a Union."""
+        args = self._get_args_resolving_forward_refs(union_type, required=True)
+        choices: list[CoreSchema] = []
+        nullable = False
+        for arg in args:
+            if arg is None or arg is _typing_extra.NoneType:
+                nullable = True
+            else:
+                choices.append(self.generate_schema(arg))
+
+        if len(choices) == 1:
+            s = choices[0]
+        else:
+            choices_with_tags: list[CoreSchema | tuple[CoreSchema, str]] = []
+            for choice in choices:
+                metadata = choice.get('metadata')
+                if isinstance(metadata, dict):
+                    tag = metadata.get(_core_utils.TAGGED_UNION_TAG_KEY)
+                    if tag is not None:
+                        choices_with_tags.append((choice, tag))
+                    else:
+                        choices_with_tags.append(choice)
+            s = core_schema.union_schema(choices_with_tags)
+
+        if nullable:
+            s = core_schema.nullable_schema(s)
+        return s
+
+    def _type_alias_type_schema(
+        self,
+        obj: Any,  # TypeAliasType
+    ) -> CoreSchema:
+        with self.defs.get_schema_or_ref(obj) as (ref, maybe_schema):
+            if maybe_schema is not None:
+                return maybe_schema
+
+            origin = get_origin(obj) or obj
+
+            annotation = origin.__value__
+            typevars_map = get_standard_typevars_map(obj)
+
+            with self._types_namespace_stack.push(origin):
+                annotation = _typing_extra.eval_type_lenient(annotation, self._types_namespace)
+                annotation = replace_types(annotation, typevars_map)
+                schema = self.generate_schema(annotation)
+                assert schema['type'] != 'definitions'
+                schema['ref'] = ref  # type: ignore
+            self.defs.definitions[ref] = schema
+            return core_schema.definition_reference_schema(ref)
+
+    def _literal_schema(self, literal_type: Any) -> CoreSchema:
+        """Generate schema for a Literal."""
+        expected = _typing_extra.all_literal_values(literal_type)
+        assert expected, f'literal "expected" cannot be empty, obj={literal_type}'
+        return core_schema.literal_schema(expected)
+
+    def _typed_dict_schema(self, typed_dict_cls: Any, origin: Any) -> core_schema.CoreSchema:
+        """Generate schema for a TypedDict.
+
+        It is not possible to track required/optional keys in TypedDict without __required_keys__
+        since TypedDict.__new__ erases the base classes (it replaces them with just `dict`)
+        and thus we can track usage of total=True/False
+        __required_keys__ was added in Python 3.9
+        (https://github.com/miss-islington/cpython/blob/1e9939657dd1f8eb9f596f77c1084d2d351172fc/Doc/library/typing.rst?plain=1#L1546-L1548)
+        however it is buggy
+        (https://github.com/python/typing_extensions/blob/ac52ac5f2cb0e00e7988bae1e2a1b8257ac88d6d/src/typing_extensions.py#L657-L666).
+
+        On 3.11 but < 3.12 TypedDict does not preserve inheritance information.
+
+        Hence to avoid creating validators that do not do what users expect we only
+        support typing.TypedDict on Python >= 3.12 or typing_extension.TypedDict on all versions
+        """
+        from ..fields import FieldInfo
+
+        with self.defs.get_schema_or_ref(typed_dict_cls) as (typed_dict_ref, maybe_schema):
+            if maybe_schema is not None:
+                return maybe_schema
+
+            typevars_map = get_standard_typevars_map(typed_dict_cls)
+            if origin is not None:
+                typed_dict_cls = origin
+
+            if not _SUPPORTS_TYPEDDICT and type(typed_dict_cls).__module__ == 'typing':
+                raise PydanticUserError(
+                    'Please use `typing_extensions.TypedDict` instead of `typing.TypedDict` on Python < 3.12.',
+                    code='typed-dict-version',
+                )
+
+            try:
+                config: ConfigDict | None = get_attribute_from_bases(typed_dict_cls, '__pydantic_config__')
+            except AttributeError:
+                config = None
+
+            with self._config_wrapper_stack.push(config), self._types_namespace_stack.push(typed_dict_cls):
+                core_config = self._config_wrapper.core_config(typed_dict_cls)
+
+                self = self._current_generate_schema
+
+                required_keys: frozenset[str] = typed_dict_cls.__required_keys__
+
+                fields: dict[str, core_schema.TypedDictField] = {}
+
+                decorators = DecoratorInfos.build(typed_dict_cls)
+
+                for field_name, annotation in get_type_hints_infer_globalns(
+                    typed_dict_cls, localns=self._types_namespace, include_extras=True
+                ).items():
+                    annotation = replace_types(annotation, typevars_map)
+                    required = field_name in required_keys
+
+                    if get_origin(annotation) == _typing_extra.Required:
+                        required = True
+                        annotation = self._get_args_resolving_forward_refs(
+                            annotation,
+                            required=True,
+                        )[0]
+                    elif get_origin(annotation) == _typing_extra.NotRequired:
+                        required = False
+                        annotation = self._get_args_resolving_forward_refs(
+                            annotation,
+                            required=True,
+                        )[0]
+
+                    field_info = FieldInfo.from_annotation(annotation)
+                    fields[field_name] = self._generate_td_field_schema(
+                        field_name, field_info, decorators, required=required
+                    )
+
+                metadata = build_metadata_dict(
+                    js_functions=[partial(modify_model_json_schema, cls=typed_dict_cls)], typed_dict_cls=typed_dict_cls
+                )
+
+                td_schema = core_schema.typed_dict_schema(
+                    fields,
+                    computed_fields=[
+                        self._computed_field_schema(d, decorators.field_serializers)
+                        for d in decorators.computed_fields.values()
+                    ],
+                    ref=typed_dict_ref,
+                    metadata=metadata,
+                    config=core_config,
+                )
+
+                schema = self._apply_model_serializers(td_schema, decorators.model_serializers.values())
+                schema = apply_model_validators(schema, decorators.model_validators.values(), 'all')
+                self.defs.definitions[typed_dict_ref] = self._post_process_generated_schema(schema)
+                return core_schema.definition_reference_schema(typed_dict_ref)
+
+    def _namedtuple_schema(self, namedtuple_cls: Any, origin: Any) -> core_schema.CoreSchema:
+        """Generate schema for a NamedTuple."""
+        with self.defs.get_schema_or_ref(namedtuple_cls) as (namedtuple_ref, maybe_schema):
+            if maybe_schema is not None:
+                return maybe_schema
+            typevars_map = get_standard_typevars_map(namedtuple_cls)
+            if origin is not None:
+                namedtuple_cls = origin
+
+            annotations: dict[str, Any] = get_type_hints_infer_globalns(
+                namedtuple_cls, include_extras=True, localns=self._types_namespace
+            )
+            if not annotations:
+                # annotations is empty, happens if namedtuple_cls defined via collections.namedtuple(...)
+                annotations = {k: Any for k in namedtuple_cls._fields}
+
+            if typevars_map:
+                annotations = {
+                    field_name: replace_types(annotation, typevars_map)
+                    for field_name, annotation in annotations.items()
+                }
+
+            arguments_schema = core_schema.arguments_schema(
+                [
+                    self._generate_parameter_schema(
+                        field_name, annotation, default=namedtuple_cls._field_defaults.get(field_name, Parameter.empty)
+                    )
+                    for field_name, annotation in annotations.items()
+                ],
+                metadata=build_metadata_dict(js_prefer_positional_arguments=True),
+            )
+            return core_schema.call_schema(arguments_schema, namedtuple_cls, ref=namedtuple_ref)
+
+    def _generate_parameter_schema(
+        self,
+        name: str,
+        annotation: type[Any],
+        default: Any = Parameter.empty,
+        mode: Literal['positional_only', 'positional_or_keyword', 'keyword_only'] | None = None,
+    ) -> core_schema.ArgumentsParameter:
+        """Prepare a ArgumentsParameter to represent a field in a namedtuple or function signature."""
+        from ..fields import FieldInfo
+
+        if default is Parameter.empty:
+            field = FieldInfo.from_annotation(annotation)
+        else:
+            field = FieldInfo.from_annotated_attribute(annotation, default)
+        assert field.annotation is not None, 'field.annotation should not be None when generating a schema'
+        source_type, annotations = field.annotation, field.metadata
+        with self.field_name_stack.push(name):
+            schema = self._apply_annotations(source_type, annotations)
+
+        if not field.is_required():
+            schema = wrap_default(field, schema)
+
+        parameter_schema = core_schema.arguments_parameter(name, schema)
+        if mode is not None:
+            parameter_schema['mode'] = mode
+        if field.alias is not None:
+            parameter_schema['alias'] = field.alias
+        else:
+            alias_generator = self._config_wrapper.alias_generator
+            if isinstance(alias_generator, AliasGenerator) and alias_generator.alias is not None:
+                parameter_schema['alias'] = alias_generator.alias(name)
+            elif isinstance(alias_generator, Callable):
+                parameter_schema['alias'] = alias_generator(name)
+        return parameter_schema
+
+    def _tuple_schema(self, tuple_type: Any) -> core_schema.CoreSchema:
+        """Generate schema for a Tuple, e.g. `tuple[int, str]` or `tuple[int, ...]`."""
+        # TODO: do we really need to resolve type vars here?
+        typevars_map = get_standard_typevars_map(tuple_type)
+        params = self._get_args_resolving_forward_refs(tuple_type)
+
+        if typevars_map and params:
+            params = tuple(replace_types(param, typevars_map) for param in params)
+
+        # NOTE: subtle difference: `tuple[()]` gives `params=()`, whereas `typing.Tuple[()]` gives `params=((),)`
+        # This is only true for <3.11, on Python 3.11+ `typing.Tuple[()]` gives `params=()`
+        if not params:
+            if tuple_type in TUPLE_TYPES:
+                return core_schema.tuple_schema([core_schema.any_schema()], variadic_item_index=0)
+            else:
+                # special case for `tuple[()]` which means `tuple[]` - an empty tuple
+                return core_schema.tuple_schema([])
+        elif params[-1] is Ellipsis:
+            if len(params) == 2:
+                return core_schema.tuple_schema([self.generate_schema(params[0])], variadic_item_index=0)
+            else:
+                # TODO: something like https://github.com/pydantic/pydantic/issues/5952
+                raise ValueError('Variable tuples can only have one type')
+        elif len(params) == 1 and params[0] == ():
+            # special case for `Tuple[()]` which means `Tuple[]` - an empty tuple
+            # NOTE: This conditional can be removed when we drop support for Python 3.10.
+            return core_schema.tuple_schema([])
+        else:
+            return core_schema.tuple_schema([self.generate_schema(param) for param in params])
+
+    def _type_schema(self) -> core_schema.CoreSchema:
+        return core_schema.custom_error_schema(
+            core_schema.is_instance_schema(type),
+            custom_error_type='is_type',
+            custom_error_message='Input should be a type',
+        )
+
+    def _union_is_subclass_schema(self, union_type: Any) -> core_schema.CoreSchema:
+        """Generate schema for `Type[Union[X, ...]]`."""
+        args = self._get_args_resolving_forward_refs(union_type, required=True)
+        return core_schema.union_schema([self.generate_schema(typing.Type[args]) for args in args])
+
+    def _subclass_schema(self, type_: Any) -> core_schema.CoreSchema:
+        """Generate schema for a Type, e.g. `Type[int]`."""
+        type_param = self._get_first_arg_or_any(type_)
+        if type_param == Any:
+            return self._type_schema()
+        elif isinstance(type_param, typing.TypeVar):
+            if type_param.__bound__:
+                if _typing_extra.origin_is_union(get_origin(type_param.__bound__)):
+                    return self._union_is_subclass_schema(type_param.__bound__)
+                return core_schema.is_subclass_schema(type_param.__bound__)
+            elif type_param.__constraints__:
+                return core_schema.union_schema(
+                    [self.generate_schema(typing.Type[c]) for c in type_param.__constraints__]
+                )
+            else:
+                return self._type_schema()
+        elif _typing_extra.origin_is_union(get_origin(type_param)):
+            return self._union_is_subclass_schema(type_param)
+        else:
+            return core_schema.is_subclass_schema(type_param)
+
+    def _sequence_schema(self, sequence_type: Any) -> core_schema.CoreSchema:
+        """Generate schema for a Sequence, e.g. `Sequence[int]`."""
+        item_type = self._get_first_arg_or_any(sequence_type)
+
+        list_schema = core_schema.list_schema(self.generate_schema(item_type))
+        python_schema = core_schema.is_instance_schema(typing.Sequence, cls_repr='Sequence')
+        if item_type != Any:
+            from ._validators import sequence_validator
+
+            python_schema = core_schema.chain_schema(
+                [python_schema, core_schema.no_info_wrap_validator_function(sequence_validator, list_schema)],
+            )
+        return core_schema.json_or_python_schema(json_schema=list_schema, python_schema=python_schema)
+
+    def _iterable_schema(self, type_: Any) -> core_schema.GeneratorSchema:
+        """Generate a schema for an `Iterable`."""
+        item_type = self._get_first_arg_or_any(type_)
+
+        return core_schema.generator_schema(self.generate_schema(item_type))
+
+    def _pattern_schema(self, pattern_type: Any) -> core_schema.CoreSchema:
+        from . import _validators
+
+        metadata = build_metadata_dict(js_functions=[lambda _1, _2: {'type': 'string', 'format': 'regex'}])
+        ser = core_schema.plain_serializer_function_ser_schema(
+            attrgetter('pattern'), when_used='json', return_schema=core_schema.str_schema()
+        )
+        if pattern_type == typing.Pattern or pattern_type == re.Pattern:
+            # bare type
+            return core_schema.no_info_plain_validator_function(
+                _validators.pattern_either_validator, serialization=ser, metadata=metadata
+            )
+
+        param = self._get_args_resolving_forward_refs(
+            pattern_type,
+            required=True,
+        )[0]
+        if param == str:
+            return core_schema.no_info_plain_validator_function(
+                _validators.pattern_str_validator, serialization=ser, metadata=metadata
+            )
+        elif param == bytes:
+            return core_schema.no_info_plain_validator_function(
+                _validators.pattern_bytes_validator, serialization=ser, metadata=metadata
+            )
+        else:
+            raise PydanticSchemaGenerationError(f'Unable to generate pydantic-core schema for {pattern_type!r}.')
+
+    def _hashable_schema(self) -> core_schema.CoreSchema:
+        return core_schema.custom_error_schema(
+            core_schema.is_instance_schema(collections.abc.Hashable),
+            custom_error_type='is_hashable',
+            custom_error_message='Input should be hashable',
+        )
+
+    def _dataclass_schema(
+        self, dataclass: type[StandardDataclass], origin: type[StandardDataclass] | None
+    ) -> core_schema.CoreSchema:
+        """Generate schema for a dataclass."""
+        with self.defs.get_schema_or_ref(dataclass) as (dataclass_ref, maybe_schema):
+            if maybe_schema is not None:
+                return maybe_schema
+
+            typevars_map = get_standard_typevars_map(dataclass)
+            if origin is not None:
+                dataclass = origin
+
+            config = getattr(dataclass, '__pydantic_config__', None)
+            with self._config_wrapper_stack.push(config), self._types_namespace_stack.push(dataclass):
+                core_config = self._config_wrapper.core_config(dataclass)
+
+                self = self._current_generate_schema
+
+                from ..dataclasses import is_pydantic_dataclass
+
+                if is_pydantic_dataclass(dataclass):
+                    fields = deepcopy(dataclass.__pydantic_fields__)
+                    if typevars_map:
+                        for field in fields.values():
+                            field.apply_typevars_map(typevars_map, self._types_namespace)
+                else:
+                    fields = collect_dataclass_fields(
+                        dataclass,
+                        self._types_namespace,
+                        typevars_map=typevars_map,
+                    )
+
+                # disallow combination of init=False on a dataclass field and extra='allow' on a dataclass
+                if config and config.get('extra') == 'allow':
+                    # disallow combination of init=False on a dataclass field and extra='allow' on a dataclass
+                    for field_name, field in fields.items():
+                        if field.init is False:
+                            raise PydanticUserError(
+                                f'Field {field_name} has `init=False` and dataclass has config setting `extra="allow"`. '
+                                f'This combination is not allowed.',
+                                code='dataclass-init-false-extra-allow',
+                            )
+
+                decorators = dataclass.__dict__.get('__pydantic_decorators__') or DecoratorInfos.build(dataclass)
+                # Move kw_only=False args to the start of the list, as this is how vanilla dataclasses work.
+                # Note that when kw_only is missing or None, it is treated as equivalent to kw_only=True
+                args = sorted(
+                    (self._generate_dc_field_schema(k, v, decorators) for k, v in fields.items()),
+                    key=lambda a: a.get('kw_only') is not False,
+                )
+                has_post_init = hasattr(dataclass, '__post_init__')
+                has_slots = hasattr(dataclass, '__slots__')
+
+                args_schema = core_schema.dataclass_args_schema(
+                    dataclass.__name__,
+                    args,
+                    computed_fields=[
+                        self._computed_field_schema(d, decorators.field_serializers)
+                        for d in decorators.computed_fields.values()
+                    ],
+                    collect_init_only=has_post_init,
+                )
+
+                inner_schema = apply_validators(args_schema, decorators.root_validators.values(), None)
+
+                model_validators = decorators.model_validators.values()
+                inner_schema = apply_model_validators(inner_schema, model_validators, 'inner')
+
+                dc_schema = core_schema.dataclass_schema(
+                    dataclass,
+                    inner_schema,
+                    post_init=has_post_init,
+                    ref=dataclass_ref,
+                    fields=[field.name for field in dataclasses.fields(dataclass)],
+                    slots=has_slots,
+                    config=core_config,
+                )
+                schema = self._apply_model_serializers(dc_schema, decorators.model_serializers.values())
+                schema = apply_model_validators(schema, model_validators, 'outer')
+                self.defs.definitions[dataclass_ref] = self._post_process_generated_schema(schema)
+                return core_schema.definition_reference_schema(dataclass_ref)
+
+    def _callable_schema(self, function: Callable[..., Any]) -> core_schema.CallSchema:
+        """Generate schema for a Callable.
+
+        TODO support functional validators once we support them in Config
+        """
+        sig = signature(function)
+
+        type_hints = _typing_extra.get_function_type_hints(function)
+
+        mode_lookup: dict[_ParameterKind, Literal['positional_only', 'positional_or_keyword', 'keyword_only']] = {
+            Parameter.POSITIONAL_ONLY: 'positional_only',
+            Parameter.POSITIONAL_OR_KEYWORD: 'positional_or_keyword',
+            Parameter.KEYWORD_ONLY: 'keyword_only',
+        }
+
+        arguments_list: list[core_schema.ArgumentsParameter] = []
+        var_args_schema: core_schema.CoreSchema | None = None
+        var_kwargs_schema: core_schema.CoreSchema | None = None
+
+        for name, p in sig.parameters.items():
+            if p.annotation is sig.empty:
+                annotation = Any
+            else:
+                annotation = type_hints[name]
+
+            parameter_mode = mode_lookup.get(p.kind)
+            if parameter_mode is not None:
+                arg_schema = self._generate_parameter_schema(name, annotation, p.default, parameter_mode)
+                arguments_list.append(arg_schema)
+            elif p.kind == Parameter.VAR_POSITIONAL:
+                var_args_schema = self.generate_schema(annotation)
+            else:
+                assert p.kind == Parameter.VAR_KEYWORD, p.kind
+                var_kwargs_schema = self.generate_schema(annotation)
+
+        return_schema: core_schema.CoreSchema | None = None
+        config_wrapper = self._config_wrapper
+        if config_wrapper.validate_return:
+            return_hint = type_hints.get('return')
+            if return_hint is not None:
+                return_schema = self.generate_schema(return_hint)
+
+        return core_schema.call_schema(
+            core_schema.arguments_schema(
+                arguments_list,
+                var_args_schema=var_args_schema,
+                var_kwargs_schema=var_kwargs_schema,
+                populate_by_name=config_wrapper.populate_by_name,
+            ),
+            function,
+            return_schema=return_schema,
+        )
+
+    def _unsubstituted_typevar_schema(self, typevar: typing.TypeVar) -> core_schema.CoreSchema:
+        assert isinstance(typevar, typing.TypeVar)
+
+        bound = typevar.__bound__
+        constraints = typevar.__constraints__
+        default = getattr(typevar, '__default__', None)
+
+        if (bound is not None) + (len(constraints) != 0) + (default is not None) > 1:
+            raise NotImplementedError(
+                'Pydantic does not support mixing more than one of TypeVar bounds, constraints and defaults'
+            )
+
+        if default is not None:
+            return self.generate_schema(default)
+        elif constraints:
+            return self._union_schema(typing.Union[constraints])  # type: ignore
+        elif bound:
+            schema = self.generate_schema(bound)
+            schema['serialization'] = core_schema.wrap_serializer_function_ser_schema(
+                lambda x, h: h(x), schema=core_schema.any_schema()
+            )
+            return schema
+        else:
+            return core_schema.any_schema()
+
+    def _computed_field_schema(
+        self,
+        d: Decorator[ComputedFieldInfo],
+        field_serializers: dict[str, Decorator[FieldSerializerDecoratorInfo]],
+    ) -> core_schema.ComputedField:
+        try:
+            return_type = _decorators.get_function_return_type(d.func, d.info.return_type, self._types_namespace)
+        except NameError as e:
+            raise PydanticUndefinedAnnotation.from_name_error(e) from e
+        if return_type is PydanticUndefined:
+            raise PydanticUserError(
+                'Computed field is missing return type annotation or specifying `return_type`'
+                ' to the `@computed_field` decorator (e.g. `@computed_field(return_type=int|str)`)',
+                code='model-field-missing-annotation',
+            )
+
+        return_type = replace_types(return_type, self._typevars_map)
+        # Create a new ComputedFieldInfo so that different type parametrizations of the same
+        # generic model's computed field can have different return types.
+        d.info = dataclasses.replace(d.info, return_type=return_type)
+        return_type_schema = self.generate_schema(return_type)
+        # Apply serializers to computed field if there exist
+        return_type_schema = self._apply_field_serializers(
+            return_type_schema,
+            filter_field_decorator_info_by_field(field_serializers.values(), d.cls_var_name),
+            computed_field=True,
+        )
+
+        alias_generator = self._config_wrapper.alias_generator
+        if alias_generator is not None:
+            self._apply_alias_generator_to_computed_field_info(
+                alias_generator=alias_generator, computed_field_info=d.info, computed_field_name=d.cls_var_name
+            )
+
+        def set_computed_field_metadata(schema: CoreSchemaOrField, handler: GetJsonSchemaHandler) -> JsonSchemaValue:
+            json_schema = handler(schema)
+
+            json_schema['readOnly'] = True
+
+            title = d.info.title
+            if title is not None:
+                json_schema['title'] = title
+
+            description = d.info.description
+            if description is not None:
+                json_schema['description'] = description
+
+            examples = d.info.examples
+            if examples is not None:
+                json_schema['examples'] = to_jsonable_python(examples)
+
+            json_schema_extra = d.info.json_schema_extra
+            if json_schema_extra is not None:
+                add_json_schema_extra(json_schema, json_schema_extra)
+
+            return json_schema
+
+        metadata = build_metadata_dict(js_annotation_functions=[set_computed_field_metadata])
+        return core_schema.computed_field(
+            d.cls_var_name, return_schema=return_type_schema, alias=d.info.alias, metadata=metadata
+        )
+
+    def _annotated_schema(self, annotated_type: Any) -> core_schema.CoreSchema:
+        """Generate schema for an Annotated type, e.g. `Annotated[int, Field(...)]` or `Annotated[int, Gt(0)]`."""
+        from ..fields import FieldInfo
+
+        source_type, *annotations = self._get_args_resolving_forward_refs(
+            annotated_type,
+            required=True,
+        )
+        schema = self._apply_annotations(source_type, annotations)
+        # put the default validator last so that TypeAdapter.get_default_value() works
+        # even if there are function validators involved
+        for annotation in annotations:
+            if isinstance(annotation, FieldInfo):
+                schema = wrap_default(annotation, schema)
+        return schema
+
+    def _get_prepare_pydantic_annotations_for_known_type(
+        self, obj: Any, annotations: tuple[Any, ...]
+    ) -> tuple[Any, list[Any]] | None:
+        from ._std_types_schema import PREPARE_METHODS
+
+        # Check for hashability
+        try:
+            hash(obj)
+        except TypeError:
+            # obj is definitely not a known type if this fails
+            return None
+
+        for gen in PREPARE_METHODS:
+            res = gen(obj, annotations, self._config_wrapper.config_dict)
+            if res is not None:
+                return res
+
+        return None
+
+    def _apply_annotations(
+        self,
+        source_type: Any,
+        annotations: list[Any],
+        transform_inner_schema: Callable[[CoreSchema], CoreSchema] = lambda x: x,
+    ) -> CoreSchema:
+        """Apply arguments from `Annotated` or from `FieldInfo` to a schema.
+
+        This gets called by `GenerateSchema._annotated_schema` but differs from it in that it does
+        not expect `source_type` to be an `Annotated` object, it expects it to be  the first argument of that
+        (in other words, `GenerateSchema._annotated_schema` just unpacks `Annotated`, this process it).
+        """
+        annotations = list(_known_annotated_metadata.expand_grouped_metadata(annotations))
+        res = self._get_prepare_pydantic_annotations_for_known_type(source_type, tuple(annotations))
+        if res is not None:
+            source_type, annotations = res
+
+        pydantic_js_annotation_functions: list[GetJsonSchemaFunction] = []
+
+        def inner_handler(obj: Any) -> CoreSchema:
+            from_property = self._generate_schema_from_property(obj, obj)
+            if from_property is None:
+                schema = self._generate_schema(obj)
+            else:
+                schema = from_property
+            metadata_js_function = _extract_get_pydantic_json_schema(obj, schema)
+            if metadata_js_function is not None:
+                metadata_schema = resolve_original_schema(schema, self.defs.definitions)
+                if metadata_schema is not None:
+                    self._add_js_function(metadata_schema, metadata_js_function)
+            return transform_inner_schema(schema)
+
+        get_inner_schema = CallbackGetCoreSchemaHandler(inner_handler, self)
+
+        for annotation in annotations:
+            if annotation is None:
+                continue
+            get_inner_schema = self._get_wrapped_inner_schema(
+                get_inner_schema, annotation, pydantic_js_annotation_functions
+            )
+
+        schema = get_inner_schema(source_type)
+        if pydantic_js_annotation_functions:
+            metadata = CoreMetadataHandler(schema).metadata
+            metadata.setdefault('pydantic_js_annotation_functions', []).extend(pydantic_js_annotation_functions)
+        return _add_custom_serialization_from_json_encoders(self._config_wrapper.json_encoders, source_type, schema)
+
+    def _apply_single_annotation(self, schema: core_schema.CoreSchema, metadata: Any) -> core_schema.CoreSchema:
+        from ..fields import FieldInfo
+
+        if isinstance(metadata, FieldInfo):
+            for field_metadata in metadata.metadata:
+                schema = self._apply_single_annotation(schema, field_metadata)
+
+            if metadata.discriminator is not None:
+                schema = self._apply_discriminator_to_union(schema, metadata.discriminator)
+            return schema
+
+        if schema['type'] == 'nullable':
+            # for nullable schemas, metadata is automatically applied to the inner schema
+            inner = schema.get('schema', core_schema.any_schema())
+            inner = self._apply_single_annotation(inner, metadata)
+            if inner:
+                schema['schema'] = inner
+            return schema
+
+        original_schema = schema
+        ref = schema.get('ref', None)
+        if ref is not None:
+            schema = schema.copy()
+            new_ref = ref + f'_{repr(metadata)}'
+            if new_ref in self.defs.definitions:
+                return self.defs.definitions[new_ref]
+            schema['ref'] = new_ref  # type: ignore
+        elif schema['type'] == 'definition-ref':
+            ref = schema['schema_ref']
+            if ref in self.defs.definitions:
+                schema = self.defs.definitions[ref].copy()
+                new_ref = ref + f'_{repr(metadata)}'
+                if new_ref in self.defs.definitions:
+                    return self.defs.definitions[new_ref]
+                schema['ref'] = new_ref  # type: ignore
+
+        maybe_updated_schema = _known_annotated_metadata.apply_known_metadata(metadata, schema.copy())
+
+        if maybe_updated_schema is not None:
+            return maybe_updated_schema
+        return original_schema
+
+    def _apply_single_annotation_json_schema(
+        self, schema: core_schema.CoreSchema, metadata: Any
+    ) -> core_schema.CoreSchema:
+        from ..fields import FieldInfo
+
+        if isinstance(metadata, FieldInfo):
+            for field_metadata in metadata.metadata:
+                schema = self._apply_single_annotation_json_schema(schema, field_metadata)
+            json_schema_update: JsonSchemaValue = {}
+            if metadata.title:
+                json_schema_update['title'] = metadata.title
+            if metadata.description:
+                json_schema_update['description'] = metadata.description
+            if metadata.examples:
+                json_schema_update['examples'] = to_jsonable_python(metadata.examples)
+
+            json_schema_extra = metadata.json_schema_extra
+            if json_schema_update or json_schema_extra:
+                CoreMetadataHandler(schema).metadata.setdefault('pydantic_js_annotation_functions', []).append(
+                    get_json_schema_update_func(json_schema_update, json_schema_extra)
+                )
+        return schema
+
+    def _get_wrapped_inner_schema(
+        self,
+        get_inner_schema: GetCoreSchemaHandler,
+        annotation: Any,
+        pydantic_js_annotation_functions: list[GetJsonSchemaFunction],
+    ) -> CallbackGetCoreSchemaHandler:
+        metadata_get_schema: GetCoreSchemaFunction = getattr(annotation, '__get_pydantic_core_schema__', None) or (
+            lambda source, handler: handler(source)
+        )
+
+        def new_handler(source: Any) -> core_schema.CoreSchema:
+            schema = metadata_get_schema(source, get_inner_schema)
+            schema = self._apply_single_annotation(schema, annotation)
+            schema = self._apply_single_annotation_json_schema(schema, annotation)
+
+            metadata_js_function = _extract_get_pydantic_json_schema(annotation, schema)
+            if metadata_js_function is not None:
+                pydantic_js_annotation_functions.append(metadata_js_function)
+            return schema
+
+        return CallbackGetCoreSchemaHandler(new_handler, self)
+
+    def _apply_field_serializers(
+        self,
+        schema: core_schema.CoreSchema,
+        serializers: list[Decorator[FieldSerializerDecoratorInfo]],
+        computed_field: bool = False,
+    ) -> core_schema.CoreSchema:
+        """Apply field serializers to a schema."""
+        if serializers:
+            schema = copy(schema)
+            if schema['type'] == 'definitions':
+                inner_schema = schema['schema']
+                schema['schema'] = self._apply_field_serializers(inner_schema, serializers)
+                return schema
+            else:
+                ref = typing.cast('str|None', schema.get('ref', None))
+                if ref is not None:
+                    schema = core_schema.definition_reference_schema(ref)
+
+            # use the last serializer to make it easy to override a serializer set on a parent model
+            serializer = serializers[-1]
+            is_field_serializer, info_arg = inspect_field_serializer(
+                serializer.func, serializer.info.mode, computed_field=computed_field
+            )
+
+            try:
+                return_type = _decorators.get_function_return_type(
+                    serializer.func, serializer.info.return_type, self._types_namespace
+                )
+            except NameError as e:
+                raise PydanticUndefinedAnnotation.from_name_error(e) from e
+
+            if return_type is PydanticUndefined:
+                return_schema = None
+            else:
+                return_schema = self.generate_schema(return_type)
+
+            if serializer.info.mode == 'wrap':
+                schema['serialization'] = core_schema.wrap_serializer_function_ser_schema(
+                    serializer.func,
+                    is_field_serializer=is_field_serializer,
+                    info_arg=info_arg,
+                    return_schema=return_schema,
+                    when_used=serializer.info.when_used,
+                )
+            else:
+                assert serializer.info.mode == 'plain'
+                schema['serialization'] = core_schema.plain_serializer_function_ser_schema(
+                    serializer.func,
+                    is_field_serializer=is_field_serializer,
+                    info_arg=info_arg,
+                    return_schema=return_schema,
+                    when_used=serializer.info.when_used,
+                )
+        return schema
+
+    def _apply_model_serializers(
+        self, schema: core_schema.CoreSchema, serializers: Iterable[Decorator[ModelSerializerDecoratorInfo]]
+    ) -> core_schema.CoreSchema:
+        """Apply model serializers to a schema."""
+        ref: str | None = schema.pop('ref', None)  # type: ignore
+        if serializers:
+            serializer = list(serializers)[-1]
+            info_arg = inspect_model_serializer(serializer.func, serializer.info.mode)
+
+            try:
+                return_type = _decorators.get_function_return_type(
+                    serializer.func, serializer.info.return_type, self._types_namespace
+                )
+            except NameError as e:
+                raise PydanticUndefinedAnnotation.from_name_error(e) from e
+            if return_type is PydanticUndefined:
+                return_schema = None
+            else:
+                return_schema = self.generate_schema(return_type)
+
+            if serializer.info.mode == 'wrap':
+                ser_schema: core_schema.SerSchema = core_schema.wrap_serializer_function_ser_schema(
+                    serializer.func,
+                    info_arg=info_arg,
+                    return_schema=return_schema,
+                    when_used=serializer.info.when_used,
+                )
+            else:
+                # plain
+                ser_schema = core_schema.plain_serializer_function_ser_schema(
+                    serializer.func,
+                    info_arg=info_arg,
+                    return_schema=return_schema,
+                    when_used=serializer.info.when_used,
+                )
+            schema['serialization'] = ser_schema
+        if ref:
+            schema['ref'] = ref  # type: ignore
+        return schema
+
+
+_VALIDATOR_F_MATCH: Mapping[
+    tuple[FieldValidatorModes, Literal['no-info', 'with-info']],
+    Callable[[Callable[..., Any], core_schema.CoreSchema, str | None], core_schema.CoreSchema],
+] = {
+    ('before', 'no-info'): lambda f, schema, _: core_schema.no_info_before_validator_function(f, schema),
+    ('after', 'no-info'): lambda f, schema, _: core_schema.no_info_after_validator_function(f, schema),
+    ('plain', 'no-info'): lambda f, _1, _2: core_schema.no_info_plain_validator_function(f),
+    ('wrap', 'no-info'): lambda f, schema, _: core_schema.no_info_wrap_validator_function(f, schema),
+    ('before', 'with-info'): lambda f, schema, field_name: core_schema.with_info_before_validator_function(
+        f, schema, field_name=field_name
+    ),
+    ('after', 'with-info'): lambda f, schema, field_name: core_schema.with_info_after_validator_function(
+        f, schema, field_name=field_name
+    ),
+    ('plain', 'with-info'): lambda f, _, field_name: core_schema.with_info_plain_validator_function(
+        f, field_name=field_name
+    ),
+    ('wrap', 'with-info'): lambda f, schema, field_name: core_schema.with_info_wrap_validator_function(
+        f, schema, field_name=field_name
+    ),
+}
+
+
+def apply_validators(
+    schema: core_schema.CoreSchema,
+    validators: Iterable[Decorator[RootValidatorDecoratorInfo]]
+    | Iterable[Decorator[ValidatorDecoratorInfo]]
+    | Iterable[Decorator[FieldValidatorDecoratorInfo]],
+    field_name: str | None,
+) -> core_schema.CoreSchema:
+    """Apply validators to a schema.
+
+    Args:
+        schema: The schema to apply validators on.
+        validators: An iterable of validators.
+        field_name: The name of the field if validators are being applied to a model field.
+
+    Returns:
+        The updated schema.
+    """
+    for validator in validators:
+        info_arg = inspect_validator(validator.func, validator.info.mode)
+        val_type = 'with-info' if info_arg else 'no-info'
+
+        schema = _VALIDATOR_F_MATCH[(validator.info.mode, val_type)](validator.func, schema, field_name)
+    return schema
+
+
+def _validators_require_validate_default(validators: Iterable[Decorator[ValidatorDecoratorInfo]]) -> bool:
+    """In v1, if any of the validators for a field had `always=True`, the default value would be validated.
+
+    This serves as an auxiliary function for re-implementing that logic, by looping over a provided
+    collection of (v1-style) ValidatorDecoratorInfo's and checking if any of them have `always=True`.
+
+    We should be able to drop this function and the associated logic calling it once we drop support
+    for v1-style validator decorators. (Or we can extend it and keep it if we add something equivalent
+    to the v1-validator `always` kwarg to `field_validator`.)
+    """
+    for validator in validators:
+        if validator.info.always:
+            return True
+    return False
+
+
+def apply_model_validators(
+    schema: core_schema.CoreSchema,
+    validators: Iterable[Decorator[ModelValidatorDecoratorInfo]],
+    mode: Literal['inner', 'outer', 'all'],
+) -> core_schema.CoreSchema:
+    """Apply model validators to a schema.
+
+    If mode == 'inner', only "before" validators are applied
+    If mode == 'outer', validators other than "before" are applied
+    If mode == 'all', all validators are applied
+
+    Args:
+        schema: The schema to apply validators on.
+        validators: An iterable of validators.
+        mode: The validator mode.
+
+    Returns:
+        The updated schema.
+    """
+    ref: str | None = schema.pop('ref', None)  # type: ignore
+    for validator in validators:
+        if mode == 'inner' and validator.info.mode != 'before':
+            continue
+        if mode == 'outer' and validator.info.mode == 'before':
+            continue
+        info_arg = inspect_validator(validator.func, validator.info.mode)
+        if validator.info.mode == 'wrap':
+            if info_arg:
+                schema = core_schema.with_info_wrap_validator_function(function=validator.func, schema=schema)
+            else:
+                schema = core_schema.no_info_wrap_validator_function(function=validator.func, schema=schema)
+        elif validator.info.mode == 'before':
+            if info_arg:
+                schema = core_schema.with_info_before_validator_function(function=validator.func, schema=schema)
+            else:
+                schema = core_schema.no_info_before_validator_function(function=validator.func, schema=schema)
+        else:
+            assert validator.info.mode == 'after'
+            if info_arg:
+                schema = core_schema.with_info_after_validator_function(function=validator.func, schema=schema)
+            else:
+                schema = core_schema.no_info_after_validator_function(function=validator.func, schema=schema)
+    if ref:
+        schema['ref'] = ref  # type: ignore
+    return schema
+
+
+def wrap_default(field_info: FieldInfo, schema: core_schema.CoreSchema) -> core_schema.CoreSchema:
+    """Wrap schema with default schema if default value or `default_factory` are available.
+
+    Args:
+        field_info: The field info object.
+        schema: The schema to apply default on.
+
+    Returns:
+        Updated schema by default value or `default_factory`.
+    """
+    if field_info.default_factory:
+        return core_schema.with_default_schema(
+            schema, default_factory=field_info.default_factory, validate_default=field_info.validate_default
+        )
+    elif field_info.default is not PydanticUndefined:
+        return core_schema.with_default_schema(
+            schema, default=field_info.default, validate_default=field_info.validate_default
+        )
+    else:
+        return schema
+
+
+def _extract_get_pydantic_json_schema(tp: Any, schema: CoreSchema) -> GetJsonSchemaFunction | None:
+    """Extract `__get_pydantic_json_schema__` from a type, handling the deprecated `__modify_schema__`."""
+    js_modify_function = getattr(tp, '__get_pydantic_json_schema__', None)
+
+    if hasattr(tp, '__modify_schema__'):
+        from pydantic import BaseModel  # circular reference
+
+        has_custom_v2_modify_js_func = (
+            js_modify_function is not None
+            and BaseModel.__get_pydantic_json_schema__.__func__  # type: ignore
+            not in (js_modify_function, getattr(js_modify_function, '__func__', None))
+        )
+
+        if not has_custom_v2_modify_js_func:
+            raise PydanticUserError(
+                'The `__modify_schema__` method is not supported in Pydantic v2. '
+                'Use `__get_pydantic_json_schema__` instead.',
+                code='custom-json-schema',
+            )
+
+    # handle GenericAlias' but ignore Annotated which "lies" about its origin (in this case it would be `int`)
+    if hasattr(tp, '__origin__') and not isinstance(tp, type(Annotated[int, 'placeholder'])):
+        return _extract_get_pydantic_json_schema(tp.__origin__, schema)
+
+    if js_modify_function is None:
+        return None
+
+    return js_modify_function
+
+
+def get_json_schema_update_func(
+    json_schema_update: JsonSchemaValue, json_schema_extra: JsonDict | typing.Callable[[JsonDict], None] | None
+) -> GetJsonSchemaFunction:
+    def json_schema_update_func(
+        core_schema_or_field: CoreSchemaOrField, handler: GetJsonSchemaHandler
+    ) -> JsonSchemaValue:
+        json_schema = {**handler(core_schema_or_field), **json_schema_update}
+        add_json_schema_extra(json_schema, json_schema_extra)
+        return json_schema
+
+    return json_schema_update_func
+
+
+def add_json_schema_extra(
+    json_schema: JsonSchemaValue, json_schema_extra: JsonDict | typing.Callable[[JsonDict], None] | None
+):
+    if isinstance(json_schema_extra, dict):
+        json_schema.update(to_jsonable_python(json_schema_extra))
+    elif callable(json_schema_extra):
+        json_schema_extra(json_schema)
+
+
+class _CommonField(TypedDict):
+    schema: core_schema.CoreSchema
+    validation_alias: str | list[str | int] | list[list[str | int]] | None
+    serialization_alias: str | None
+    serialization_exclude: bool | None
+    frozen: bool | None
+    metadata: dict[str, Any]
+
+
+def _common_field(
+    schema: core_schema.CoreSchema,
+    *,
+    validation_alias: str | list[str | int] | list[list[str | int]] | None = None,
+    serialization_alias: str | None = None,
+    serialization_exclude: bool | None = None,
+    frozen: bool | None = None,
+    metadata: Any = None,
+) -> _CommonField:
+    return {
+        'schema': schema,
+        'validation_alias': validation_alias,
+        'serialization_alias': serialization_alias,
+        'serialization_exclude': serialization_exclude,
+        'frozen': frozen,
+        'metadata': metadata,
+    }
+
+
+class _Definitions:
+    """Keeps track of references and definitions."""
+
+    def __init__(self) -> None:
+        self.seen: set[str] = set()
+        self.definitions: dict[str, core_schema.CoreSchema] = {}
+
+    @contextmanager
+    def get_schema_or_ref(self, tp: Any) -> Iterator[tuple[str, None] | tuple[str, CoreSchema]]:
+        """Get a definition for `tp` if one exists.
+
+        If a definition exists, a tuple of `(ref_string, CoreSchema)` is returned.
+        If no definition exists yet, a tuple of `(ref_string, None)` is returned.
+
+        Note that the returned `CoreSchema` will always be a `DefinitionReferenceSchema`,
+        not the actual definition itself.
+
+        This should be called for any type that can be identified by reference.
+        This includes any recursive types.
+
+        At present the following types can be named/recursive:
+
+        - BaseModel
+        - Dataclasses
+        - TypedDict
+        - TypeAliasType
+        """
+        ref = get_type_ref(tp)
+        # return the reference if we're either (1) in a cycle or (2) it was already defined
+        if ref in self.seen or ref in self.definitions:
+            yield (ref, core_schema.definition_reference_schema(ref))
+        else:
+            self.seen.add(ref)
+            try:
+                yield (ref, None)
+            finally:
+                self.seen.discard(ref)
+
+
+def resolve_original_schema(schema: CoreSchema, definitions: dict[str, CoreSchema]) -> CoreSchema | None:
+    if schema['type'] == 'definition-ref':
+        return definitions.get(schema['schema_ref'], None)
+    elif schema['type'] == 'definitions':
+        return schema['schema']
+    else:
+        return schema
+
+
+class _FieldNameStack:
+    __slots__ = ('_stack',)
+
+    def __init__(self) -> None:
+        self._stack: list[str] = []
+
+    @contextmanager
+    def push(self, field_name: str) -> Iterator[None]:
+        self._stack.append(field_name)
+        yield
+        self._stack.pop()
+
+    def get(self) -> str | None:
+        if self._stack:
+            return self._stack[-1]
+        else:
+            return None
diff --git a/lib/pydantic/_internal/_generics.py b/lib/pydantic/_internal/_generics.py
new file mode 100644
index 00000000..5a66eaa9
--- /dev/null
+++ b/lib/pydantic/_internal/_generics.py
@@ -0,0 +1,517 @@
+from __future__ import annotations
+
+import sys
+import types
+import typing
+from collections import ChainMap
+from contextlib import contextmanager
+from contextvars import ContextVar
+from types import prepare_class
+from typing import TYPE_CHECKING, Any, Iterator, List, Mapping, MutableMapping, Tuple, TypeVar
+from weakref import WeakValueDictionary
+
+import typing_extensions
+
+from ._core_utils import get_type_ref
+from ._forward_ref import PydanticRecursiveRef
+from ._typing_extra import TypeVarType, typing_base
+from ._utils import all_identical, is_model_class
+
+if sys.version_info >= (3, 10):
+    from typing import _UnionGenericAlias  # type: ignore[attr-defined]
+
+if TYPE_CHECKING:
+    from ..main import BaseModel
+
+GenericTypesCacheKey = Tuple[Any, Any, Tuple[Any, ...]]
+
+# Note: We want to remove LimitedDict, but to do this, we'd need to improve the handling of generics caching.
+#   Right now, to handle recursive generics, we some types must remain cached for brief periods without references.
+#   By chaining the WeakValuesDict with a LimitedDict, we have a way to retain caching for all types with references,
+#   while also retaining a limited number of types even without references. This is generally enough to build
+#   specific recursive generic models without losing required items out of the cache.
+
+KT = TypeVar('KT')
+VT = TypeVar('VT')
+_LIMITED_DICT_SIZE = 100
+if TYPE_CHECKING:
+
+    class LimitedDict(dict, MutableMapping[KT, VT]):
+        def __init__(self, size_limit: int = _LIMITED_DICT_SIZE):
+            ...
+
+else:
+
+    class LimitedDict(dict):
+        """Limit the size/length of a dict used for caching to avoid unlimited increase in memory usage.
+
+        Since the dict is ordered, and we always remove elements from the beginning, this is effectively a FIFO cache.
+        """
+
+        def __init__(self, size_limit: int = _LIMITED_DICT_SIZE):
+            self.size_limit = size_limit
+            super().__init__()
+
+        def __setitem__(self, __key: Any, __value: Any) -> None:
+            super().__setitem__(__key, __value)
+            if len(self) > self.size_limit:
+                excess = len(self) - self.size_limit + self.size_limit // 10
+                to_remove = list(self.keys())[:excess]
+                for key in to_remove:
+                    del self[key]
+
+
+# weak dictionaries allow the dynamically created parametrized versions of generic models to get collected
+# once they are no longer referenced by the caller.
+if sys.version_info >= (3, 9):  # Typing for weak dictionaries available at 3.9
+    GenericTypesCache = WeakValueDictionary[GenericTypesCacheKey, 'type[BaseModel]']
+else:
+    GenericTypesCache = WeakValueDictionary
+
+if TYPE_CHECKING:
+
+    class DeepChainMap(ChainMap[KT, VT]):  # type: ignore
+        ...
+
+else:
+
+    class DeepChainMap(ChainMap):
+        """Variant of ChainMap that allows direct updates to inner scopes.
+
+        Taken from https://docs.python.org/3/library/collections.html#collections.ChainMap,
+        with some light modifications for this use case.
+        """
+
+        def clear(self) -> None:
+            for mapping in self.maps:
+                mapping.clear()
+
+        def __setitem__(self, key: KT, value: VT) -> None:
+            for mapping in self.maps:
+                mapping[key] = value
+
+        def __delitem__(self, key: KT) -> None:
+            hit = False
+            for mapping in self.maps:
+                if key in mapping:
+                    del mapping[key]
+                    hit = True
+            if not hit:
+                raise KeyError(key)
+
+
+# Despite the fact that LimitedDict _seems_ no longer necessary, I'm very nervous to actually remove it
+# and discover later on that we need to re-add all this infrastructure...
+# _GENERIC_TYPES_CACHE = DeepChainMap(GenericTypesCache(), LimitedDict())
+
+_GENERIC_TYPES_CACHE = GenericTypesCache()
+
+
+class PydanticGenericMetadata(typing_extensions.TypedDict):
+    origin: type[BaseModel] | None  # analogous to typing._GenericAlias.__origin__
+    args: tuple[Any, ...]  # analogous to typing._GenericAlias.__args__
+    parameters: tuple[type[Any], ...]  # analogous to typing.Generic.__parameters__
+
+
+def create_generic_submodel(
+    model_name: str, origin: type[BaseModel], args: tuple[Any, ...], params: tuple[Any, ...]
+) -> type[BaseModel]:
+    """Dynamically create a submodel of a provided (generic) BaseModel.
+
+    This is used when producing concrete parametrizations of generic models. This function
+    only *creates* the new subclass; the schema/validators/serialization must be updated to
+    reflect a concrete parametrization elsewhere.
+
+    Args:
+        model_name: The name of the newly created model.
+        origin: The base class for the new model to inherit from.
+        args: A tuple of generic metadata arguments.
+        params: A tuple of generic metadata parameters.
+
+    Returns:
+        The created submodel.
+    """
+    namespace: dict[str, Any] = {'__module__': origin.__module__}
+    bases = (origin,)
+    meta, ns, kwds = prepare_class(model_name, bases)
+    namespace.update(ns)
+    created_model = meta(
+        model_name,
+        bases,
+        namespace,
+        __pydantic_generic_metadata__={
+            'origin': origin,
+            'args': args,
+            'parameters': params,
+        },
+        __pydantic_reset_parent_namespace__=False,
+        **kwds,
+    )
+
+    model_module, called_globally = _get_caller_frame_info(depth=3)
+    if called_globally:  # create global reference and therefore allow pickling
+        object_by_reference = None
+        reference_name = model_name
+        reference_module_globals = sys.modules[created_model.__module__].__dict__
+        while object_by_reference is not created_model:
+            object_by_reference = reference_module_globals.setdefault(reference_name, created_model)
+            reference_name += '_'
+
+    return created_model
+
+
+def _get_caller_frame_info(depth: int = 2) -> tuple[str | None, bool]:
+    """Used inside a function to check whether it was called globally.
+
+    Args:
+        depth: The depth to get the frame.
+
+    Returns:
+        A tuple contains `module_name` and `called_globally`.
+
+    Raises:
+        RuntimeError: If the function is not called inside a function.
+    """
+    try:
+        previous_caller_frame = sys._getframe(depth)
+    except ValueError as e:
+        raise RuntimeError('This function must be used inside another function') from e
+    except AttributeError:  # sys module does not have _getframe function, so there's nothing we can do about it
+        return None, False
+    frame_globals = previous_caller_frame.f_globals
+    return frame_globals.get('__name__'), previous_caller_frame.f_locals is frame_globals
+
+
+DictValues: type[Any] = {}.values().__class__
+
+
+def iter_contained_typevars(v: Any) -> Iterator[TypeVarType]:
+    """Recursively iterate through all subtypes and type args of `v` and yield any typevars that are found.
+
+    This is inspired as an alternative to directly accessing the `__parameters__` attribute of a GenericAlias,
+    since __parameters__ of (nested) generic BaseModel subclasses won't show up in that list.
+    """
+    if isinstance(v, TypeVar):
+        yield v
+    elif is_model_class(v):
+        yield from v.__pydantic_generic_metadata__['parameters']
+    elif isinstance(v, (DictValues, list)):
+        for var in v:
+            yield from iter_contained_typevars(var)
+    else:
+        args = get_args(v)
+        for arg in args:
+            yield from iter_contained_typevars(arg)
+
+
+def get_args(v: Any) -> Any:
+    pydantic_generic_metadata: PydanticGenericMetadata | None = getattr(v, '__pydantic_generic_metadata__', None)
+    if pydantic_generic_metadata:
+        return pydantic_generic_metadata.get('args')
+    return typing_extensions.get_args(v)
+
+
+def get_origin(v: Any) -> Any:
+    pydantic_generic_metadata: PydanticGenericMetadata | None = getattr(v, '__pydantic_generic_metadata__', None)
+    if pydantic_generic_metadata:
+        return pydantic_generic_metadata.get('origin')
+    return typing_extensions.get_origin(v)
+
+
+def get_standard_typevars_map(cls: type[Any]) -> dict[TypeVarType, Any] | None:
+    """Package a generic type's typevars and parametrization (if present) into a dictionary compatible with the
+    `replace_types` function. Specifically, this works with standard typing generics and typing._GenericAlias.
+    """
+    origin = get_origin(cls)
+    if origin is None:
+        return None
+    if not hasattr(origin, '__parameters__'):
+        return None
+
+    # In this case, we know that cls is a _GenericAlias, and origin is the generic type
+    # So it is safe to access cls.__args__ and origin.__parameters__
+    args: tuple[Any, ...] = cls.__args__  # type: ignore
+    parameters: tuple[TypeVarType, ...] = origin.__parameters__
+    return dict(zip(parameters, args))
+
+
+def get_model_typevars_map(cls: type[BaseModel]) -> dict[TypeVarType, Any] | None:
+    """Package a generic BaseModel's typevars and concrete parametrization (if present) into a dictionary compatible
+    with the `replace_types` function.
+
+    Since BaseModel.__class_getitem__ does not produce a typing._GenericAlias, and the BaseModel generic info is
+    stored in the __pydantic_generic_metadata__ attribute, we need special handling here.
+    """
+    # TODO: This could be unified with `get_standard_typevars_map` if we stored the generic metadata
+    #   in the __origin__, __args__, and __parameters__ attributes of the model.
+    generic_metadata = cls.__pydantic_generic_metadata__
+    origin = generic_metadata['origin']
+    args = generic_metadata['args']
+    return dict(zip(iter_contained_typevars(origin), args))
+
+
+def replace_types(type_: Any, type_map: Mapping[Any, Any] | None) -> Any:
+    """Return type with all occurrences of `type_map` keys recursively replaced with their values.
+
+    Args:
+        type_: The class or generic alias.
+        type_map: Mapping from `TypeVar` instance to concrete types.
+
+    Returns:
+        A new type representing the basic structure of `type_` with all
+        `typevar_map` keys recursively replaced.
+
+    Example:
+        ```py
+        from typing import List, Tuple, Union
+
+        from pydantic._internal._generics import replace_types
+
+        replace_types(Tuple[str, Union[List[str], float]], {str: int})
+        #> Tuple[int, Union[List[int], float]]
+        ```
+    """
+    if not type_map:
+        return type_
+
+    type_args = get_args(type_)
+    origin_type = get_origin(type_)
+
+    if origin_type is typing_extensions.Annotated:
+        annotated_type, *annotations = type_args
+        annotated = replace_types(annotated_type, type_map)
+        for annotation in annotations:
+            annotated = typing_extensions.Annotated[annotated, annotation]
+        return annotated
+
+    # Having type args is a good indicator that this is a typing module
+    # class instantiation or a generic alias of some sort.
+    if type_args:
+        resolved_type_args = tuple(replace_types(arg, type_map) for arg in type_args)
+        if all_identical(type_args, resolved_type_args):
+            # If all arguments are the same, there is no need to modify the
+            # type or create a new object at all
+            return type_
+        if (
+            origin_type is not None
+            and isinstance(type_, typing_base)
+            and not isinstance(origin_type, typing_base)
+            and getattr(type_, '_name', None) is not None
+        ):
+            # In python < 3.9 generic aliases don't exist so any of these like `list`,
+            # `type` or `collections.abc.Callable` need to be translated.
+            # See: https://www.python.org/dev/peps/pep-0585
+            origin_type = getattr(typing, type_._name)
+        assert origin_type is not None
+        # PEP-604 syntax (Ex.: list | str) is represented with a types.UnionType object that does not have __getitem__.
+        # We also cannot use isinstance() since we have to compare types.
+        if sys.version_info >= (3, 10) and origin_type is types.UnionType:
+            return _UnionGenericAlias(origin_type, resolved_type_args)
+        # NotRequired[T] and Required[T] don't support tuple type resolved_type_args, hence the condition below
+        return origin_type[resolved_type_args[0] if len(resolved_type_args) == 1 else resolved_type_args]
+
+    # We handle pydantic generic models separately as they don't have the same
+    # semantics as "typing" classes or generic aliases
+
+    if not origin_type and is_model_class(type_):
+        parameters = type_.__pydantic_generic_metadata__['parameters']
+        if not parameters:
+            return type_
+        resolved_type_args = tuple(replace_types(t, type_map) for t in parameters)
+        if all_identical(parameters, resolved_type_args):
+            return type_
+        return type_[resolved_type_args]
+
+    # Handle special case for typehints that can have lists as arguments.
+    # `typing.Callable[[int, str], int]` is an example for this.
+    if isinstance(type_, (List, list)):
+        resolved_list = list(replace_types(element, type_map) for element in type_)
+        if all_identical(type_, resolved_list):
+            return type_
+        return resolved_list
+
+    # If all else fails, we try to resolve the type directly and otherwise just
+    # return the input with no modifications.
+    return type_map.get(type_, type_)
+
+
+def has_instance_in_type(type_: Any, isinstance_target: Any) -> bool:
+    """Checks if the type, or any of its arbitrary nested args, satisfy
+    `isinstance(<type>, isinstance_target)`.
+    """
+    if isinstance(type_, isinstance_target):
+        return True
+
+    type_args = get_args(type_)
+    origin_type = get_origin(type_)
+
+    if origin_type is typing_extensions.Annotated:
+        annotated_type, *annotations = type_args
+        return has_instance_in_type(annotated_type, isinstance_target)
+
+    # Having type args is a good indicator that this is a typing module
+    # class instantiation or a generic alias of some sort.
+    if any(has_instance_in_type(a, isinstance_target) for a in type_args):
+        return True
+
+    # Handle special case for typehints that can have lists as arguments.
+    # `typing.Callable[[int, str], int]` is an example for this.
+    if isinstance(type_, (List, list)) and not isinstance(type_, typing_extensions.ParamSpec):
+        if any(has_instance_in_type(element, isinstance_target) for element in type_):
+            return True
+
+    return False
+
+
+def check_parameters_count(cls: type[BaseModel], parameters: tuple[Any, ...]) -> None:
+    """Check the generic model parameters count is equal.
+
+    Args:
+        cls: The generic model.
+        parameters: A tuple of passed parameters to the generic model.
+
+    Raises:
+        TypeError: If the passed parameters count is not equal to generic model parameters count.
+    """
+    actual = len(parameters)
+    expected = len(cls.__pydantic_generic_metadata__['parameters'])
+    if actual != expected:
+        description = 'many' if actual > expected else 'few'
+        raise TypeError(f'Too {description} parameters for {cls}; actual {actual}, expected {expected}')
+
+
+_generic_recursion_cache: ContextVar[set[str] | None] = ContextVar('_generic_recursion_cache', default=None)
+
+
+@contextmanager
+def generic_recursion_self_type(
+    origin: type[BaseModel], args: tuple[Any, ...]
+) -> Iterator[PydanticRecursiveRef | None]:
+    """This contextmanager should be placed around the recursive calls used to build a generic type,
+    and accept as arguments the generic origin type and the type arguments being passed to it.
+
+    If the same origin and arguments are observed twice, it implies that a self-reference placeholder
+    can be used while building the core schema, and will produce a schema_ref that will be valid in the
+    final parent schema.
+    """
+    previously_seen_type_refs = _generic_recursion_cache.get()
+    if previously_seen_type_refs is None:
+        previously_seen_type_refs = set()
+        token = _generic_recursion_cache.set(previously_seen_type_refs)
+    else:
+        token = None
+
+    try:
+        type_ref = get_type_ref(origin, args_override=args)
+        if type_ref in previously_seen_type_refs:
+            self_type = PydanticRecursiveRef(type_ref=type_ref)
+            yield self_type
+        else:
+            previously_seen_type_refs.add(type_ref)
+            yield None
+    finally:
+        if token:
+            _generic_recursion_cache.reset(token)
+
+
+def recursively_defined_type_refs() -> set[str]:
+    visited = _generic_recursion_cache.get()
+    if not visited:
+        return set()  # not in a generic recursion, so there are no types
+
+    return visited.copy()  # don't allow modifications
+
+
+def get_cached_generic_type_early(parent: type[BaseModel], typevar_values: Any) -> type[BaseModel] | None:
+    """The use of a two-stage cache lookup approach was necessary to have the highest performance possible for
+    repeated calls to `__class_getitem__` on generic types (which may happen in tighter loops during runtime),
+    while still ensuring that certain alternative parametrizations ultimately resolve to the same type.
+
+    As a concrete example, this approach was necessary to make Model[List[T]][int] equal to Model[List[int]].
+    The approach could be modified to not use two different cache keys at different points, but the
+    _early_cache_key is optimized to be as quick to compute as possible (for repeated-access speed), and the
+    _late_cache_key is optimized to be as "correct" as possible, so that two types that will ultimately be the
+    same after resolving the type arguments will always produce cache hits.
+
+    If we wanted to move to only using a single cache key per type, we would either need to always use the
+    slower/more computationally intensive logic associated with _late_cache_key, or would need to accept
+    that Model[List[T]][int] is a different type than Model[List[T]][int]. Because we rely on subclass relationships
+    during validation, I think it is worthwhile to ensure that types that are functionally equivalent are actually
+    equal.
+    """
+    return _GENERIC_TYPES_CACHE.get(_early_cache_key(parent, typevar_values))
+
+
+def get_cached_generic_type_late(
+    parent: type[BaseModel], typevar_values: Any, origin: type[BaseModel], args: tuple[Any, ...]
+) -> type[BaseModel] | None:
+    """See the docstring of `get_cached_generic_type_early` for more information about the two-stage cache lookup."""
+    cached = _GENERIC_TYPES_CACHE.get(_late_cache_key(origin, args, typevar_values))
+    if cached is not None:
+        set_cached_generic_type(parent, typevar_values, cached, origin, args)
+    return cached
+
+
+def set_cached_generic_type(
+    parent: type[BaseModel],
+    typevar_values: tuple[Any, ...],
+    type_: type[BaseModel],
+    origin: type[BaseModel] | None = None,
+    args: tuple[Any, ...] | None = None,
+) -> None:
+    """See the docstring of `get_cached_generic_type_early` for more information about why items are cached with
+    two different keys.
+    """
+    _GENERIC_TYPES_CACHE[_early_cache_key(parent, typevar_values)] = type_
+    if len(typevar_values) == 1:
+        _GENERIC_TYPES_CACHE[_early_cache_key(parent, typevar_values[0])] = type_
+    if origin and args:
+        _GENERIC_TYPES_CACHE[_late_cache_key(origin, args, typevar_values)] = type_
+
+
+def _union_orderings_key(typevar_values: Any) -> Any:
+    """This is intended to help differentiate between Union types with the same arguments in different order.
+
+    Thanks to caching internal to the `typing` module, it is not possible to distinguish between
+    List[Union[int, float]] and List[Union[float, int]] (and similarly for other "parent" origins besides List)
+    because `typing` considers Union[int, float] to be equal to Union[float, int].
+
+    However, you _can_ distinguish between (top-level) Union[int, float] vs. Union[float, int].
+    Because we parse items as the first Union type that is successful, we get slightly more consistent behavior
+    if we make an effort to distinguish the ordering of items in a union. It would be best if we could _always_
+    get the exact-correct order of items in the union, but that would require a change to the `typing` module itself.
+    (See https://github.com/python/cpython/issues/86483 for reference.)
+    """
+    if isinstance(typevar_values, tuple):
+        args_data = []
+        for value in typevar_values:
+            args_data.append(_union_orderings_key(value))
+        return tuple(args_data)
+    elif typing_extensions.get_origin(typevar_values) is typing.Union:
+        return get_args(typevar_values)
+    else:
+        return ()
+
+
+def _early_cache_key(cls: type[BaseModel], typevar_values: Any) -> GenericTypesCacheKey:
+    """This is intended for minimal computational overhead during lookups of cached types.
+
+    Note that this is overly simplistic, and it's possible that two different cls/typevar_values
+    inputs would ultimately result in the same type being created in BaseModel.__class_getitem__.
+    To handle this, we have a fallback _late_cache_key that is checked later if the _early_cache_key
+    lookup fails, and should result in a cache hit _precisely_ when the inputs to __class_getitem__
+    would result in the same type.
+    """
+    return cls, typevar_values, _union_orderings_key(typevar_values)
+
+
+def _late_cache_key(origin: type[BaseModel], args: tuple[Any, ...], typevar_values: Any) -> GenericTypesCacheKey:
+    """This is intended for use later in the process of creating a new type, when we have more information
+    about the exact args that will be passed. If it turns out that a different set of inputs to
+    __class_getitem__ resulted in the same inputs to the generic type creation process, we can still
+    return the cached type, and update the cache with the _early_cache_key as well.
+    """
+    # The _union_orderings_key is placed at the start here to ensure there cannot be a collision with an
+    # _early_cache_key, as that function will always produce a BaseModel subclass as the first item in the key,
+    # whereas this function will always produce a tuple as the first item in the key.
+    return _union_orderings_key(typevar_values), origin, args
diff --git a/lib/pydantic/_internal/_git.py b/lib/pydantic/_internal/_git.py
new file mode 100644
index 00000000..9de7aaf9
--- /dev/null
+++ b/lib/pydantic/_internal/_git.py
@@ -0,0 +1,26 @@
+"""Git utilities, adopted from mypy's git utilities (https://github.com/python/mypy/blob/master/mypy/git.py)."""
+from __future__ import annotations
+
+import os
+import subprocess
+
+
+def is_git_repo(dir: str) -> bool:
+    """Is the given directory version-controlled with git?"""
+    return os.path.exists(os.path.join(dir, '.git'))
+
+
+def have_git() -> bool:
+    """Can we run the git executable?"""
+    try:
+        subprocess.check_output(['git', '--help'])
+        return True
+    except subprocess.CalledProcessError:
+        return False
+    except OSError:
+        return False
+
+
+def git_revision(dir: str) -> str:
+    """Get the SHA-1 of the HEAD of a git repository."""
+    return subprocess.check_output(['git', 'rev-parse', '--short', 'HEAD'], cwd=dir).decode('utf-8').strip()
diff --git a/lib/pydantic/_internal/_internal_dataclass.py b/lib/pydantic/_internal/_internal_dataclass.py
new file mode 100644
index 00000000..317a3d9c
--- /dev/null
+++ b/lib/pydantic/_internal/_internal_dataclass.py
@@ -0,0 +1,10 @@
+import sys
+from typing import Any, Dict
+
+dataclass_kwargs: Dict[str, Any]
+
+# `slots` is available on Python >= 3.10
+if sys.version_info >= (3, 10):
+    slots_true = {'slots': True}
+else:
+    slots_true = {}
diff --git a/lib/pydantic/_internal/_known_annotated_metadata.py b/lib/pydantic/_internal/_known_annotated_metadata.py
new file mode 100644
index 00000000..77caf705
--- /dev/null
+++ b/lib/pydantic/_internal/_known_annotated_metadata.py
@@ -0,0 +1,410 @@
+from __future__ import annotations
+
+from collections import defaultdict
+from copy import copy
+from functools import partial
+from typing import TYPE_CHECKING, Any, Callable, Iterable
+
+from pydantic_core import CoreSchema, PydanticCustomError, to_jsonable_python
+from pydantic_core import core_schema as cs
+
+from ._fields import PydanticMetadata
+
+if TYPE_CHECKING:
+    from ..annotated_handlers import GetJsonSchemaHandler
+
+
+STRICT = {'strict'}
+SEQUENCE_CONSTRAINTS = {'min_length', 'max_length'}
+INEQUALITY = {'le', 'ge', 'lt', 'gt'}
+NUMERIC_CONSTRAINTS = {'multiple_of', 'allow_inf_nan', *INEQUALITY}
+
+STR_CONSTRAINTS = {*SEQUENCE_CONSTRAINTS, *STRICT, 'strip_whitespace', 'to_lower', 'to_upper', 'pattern'}
+BYTES_CONSTRAINTS = {*SEQUENCE_CONSTRAINTS, *STRICT}
+
+LIST_CONSTRAINTS = {*SEQUENCE_CONSTRAINTS, *STRICT}
+TUPLE_CONSTRAINTS = {*SEQUENCE_CONSTRAINTS, *STRICT}
+SET_CONSTRAINTS = {*SEQUENCE_CONSTRAINTS, *STRICT}
+DICT_CONSTRAINTS = {*SEQUENCE_CONSTRAINTS, *STRICT}
+GENERATOR_CONSTRAINTS = {*SEQUENCE_CONSTRAINTS, *STRICT}
+
+FLOAT_CONSTRAINTS = {*NUMERIC_CONSTRAINTS, *STRICT}
+INT_CONSTRAINTS = {*NUMERIC_CONSTRAINTS, *STRICT}
+BOOL_CONSTRAINTS = STRICT
+UUID_CONSTRAINTS = STRICT
+
+DATE_TIME_CONSTRAINTS = {*NUMERIC_CONSTRAINTS, *STRICT}
+TIMEDELTA_CONSTRAINTS = {*NUMERIC_CONSTRAINTS, *STRICT}
+TIME_CONSTRAINTS = {*NUMERIC_CONSTRAINTS, *STRICT}
+LAX_OR_STRICT_CONSTRAINTS = STRICT
+
+UNION_CONSTRAINTS = {'union_mode'}
+URL_CONSTRAINTS = {
+    'max_length',
+    'allowed_schemes',
+    'host_required',
+    'default_host',
+    'default_port',
+    'default_path',
+}
+
+TEXT_SCHEMA_TYPES = ('str', 'bytes', 'url', 'multi-host-url')
+SEQUENCE_SCHEMA_TYPES = ('list', 'tuple', 'set', 'frozenset', 'generator', *TEXT_SCHEMA_TYPES)
+NUMERIC_SCHEMA_TYPES = ('float', 'int', 'date', 'time', 'timedelta', 'datetime')
+
+CONSTRAINTS_TO_ALLOWED_SCHEMAS: dict[str, set[str]] = defaultdict(set)
+for constraint in STR_CONSTRAINTS:
+    CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(TEXT_SCHEMA_TYPES)
+for constraint in BYTES_CONSTRAINTS:
+    CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('bytes',))
+for constraint in LIST_CONSTRAINTS:
+    CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('list',))
+for constraint in TUPLE_CONSTRAINTS:
+    CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('tuple',))
+for constraint in SET_CONSTRAINTS:
+    CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('set', 'frozenset'))
+for constraint in DICT_CONSTRAINTS:
+    CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('dict',))
+for constraint in GENERATOR_CONSTRAINTS:
+    CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('generator',))
+for constraint in FLOAT_CONSTRAINTS:
+    CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('float',))
+for constraint in INT_CONSTRAINTS:
+    CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('int',))
+for constraint in DATE_TIME_CONSTRAINTS:
+    CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('date', 'time', 'datetime'))
+for constraint in TIMEDELTA_CONSTRAINTS:
+    CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('timedelta',))
+for constraint in TIME_CONSTRAINTS:
+    CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('time',))
+for schema_type in (*TEXT_SCHEMA_TYPES, *SEQUENCE_SCHEMA_TYPES, *NUMERIC_SCHEMA_TYPES, 'typed-dict', 'model'):
+    CONSTRAINTS_TO_ALLOWED_SCHEMAS['strict'].add(schema_type)
+for constraint in UNION_CONSTRAINTS:
+    CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('union',))
+for constraint in URL_CONSTRAINTS:
+    CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('url', 'multi-host-url'))
+for constraint in BOOL_CONSTRAINTS:
+    CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('bool',))
+for constraint in UUID_CONSTRAINTS:
+    CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('uuid',))
+for constraint in LAX_OR_STRICT_CONSTRAINTS:
+    CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('lax-or-strict',))
+
+
+def add_js_update_schema(s: cs.CoreSchema, f: Callable[[], dict[str, Any]]) -> None:
+    def update_js_schema(s: cs.CoreSchema, handler: GetJsonSchemaHandler) -> dict[str, Any]:
+        js_schema = handler(s)
+        js_schema.update(f())
+        return js_schema
+
+    if 'metadata' in s:
+        metadata = s['metadata']
+        if 'pydantic_js_functions' in s:
+            metadata['pydantic_js_functions'].append(update_js_schema)
+        else:
+            metadata['pydantic_js_functions'] = [update_js_schema]
+    else:
+        s['metadata'] = {'pydantic_js_functions': [update_js_schema]}
+
+
+def as_jsonable_value(v: Any) -> Any:
+    if type(v) not in (int, str, float, bytes, bool, type(None)):
+        return to_jsonable_python(v)
+    return v
+
+
+def expand_grouped_metadata(annotations: Iterable[Any]) -> Iterable[Any]:
+    """Expand the annotations.
+
+    Args:
+        annotations: An iterable of annotations.
+
+    Returns:
+        An iterable of expanded annotations.
+
+    Example:
+        ```py
+        from annotated_types import Ge, Len
+
+        from pydantic._internal._known_annotated_metadata import expand_grouped_metadata
+
+        print(list(expand_grouped_metadata([Ge(4), Len(5)])))
+        #> [Ge(ge=4), MinLen(min_length=5)]
+        ```
+    """
+    import annotated_types as at
+
+    from pydantic.fields import FieldInfo  # circular import
+
+    for annotation in annotations:
+        if isinstance(annotation, at.GroupedMetadata):
+            yield from annotation
+        elif isinstance(annotation, FieldInfo):
+            yield from annotation.metadata
+            # this is a bit problematic in that it results in duplicate metadata
+            # all of our "consumers" can handle it, but it is not ideal
+            # we probably should split up FieldInfo into:
+            # - annotated types metadata
+            # - individual metadata known only to Pydantic
+            annotation = copy(annotation)
+            annotation.metadata = []
+            yield annotation
+        else:
+            yield annotation
+
+
+def apply_known_metadata(annotation: Any, schema: CoreSchema) -> CoreSchema | None:  # noqa: C901
+    """Apply `annotation` to `schema` if it is an annotation we know about (Gt, Le, etc.).
+    Otherwise return `None`.
+
+    This does not handle all known annotations. If / when it does, it can always
+    return a CoreSchema and return the unmodified schema if the annotation should be ignored.
+
+    Assumes that GroupedMetadata has already been expanded via `expand_grouped_metadata`.
+
+    Args:
+        annotation: The annotation.
+        schema: The schema.
+
+    Returns:
+        An updated schema with annotation if it is an annotation we know about, `None` otherwise.
+
+    Raises:
+        PydanticCustomError: If `Predicate` fails.
+    """
+    import annotated_types as at
+
+    from . import _validators
+
+    schema = schema.copy()
+    schema_update, other_metadata = collect_known_metadata([annotation])
+    schema_type = schema['type']
+    for constraint, value in schema_update.items():
+        if constraint not in CONSTRAINTS_TO_ALLOWED_SCHEMAS:
+            raise ValueError(f'Unknown constraint {constraint}')
+        allowed_schemas = CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint]
+
+        if schema_type in allowed_schemas:
+            if constraint == 'union_mode' and schema_type == 'union':
+                schema['mode'] = value  # type: ignore  # schema is UnionSchema
+            else:
+                schema[constraint] = value
+            continue
+
+        if constraint == 'allow_inf_nan' and value is False:
+            return cs.no_info_after_validator_function(
+                _validators.forbid_inf_nan_check,
+                schema,
+            )
+        elif constraint == 'pattern':
+            # insert a str schema to make sure the regex engine matches
+            return cs.chain_schema(
+                [
+                    schema,
+                    cs.str_schema(pattern=value),
+                ]
+            )
+        elif constraint == 'gt':
+            s = cs.no_info_after_validator_function(
+                partial(_validators.greater_than_validator, gt=value),
+                schema,
+            )
+            add_js_update_schema(s, lambda: {'gt': as_jsonable_value(value)})
+            return s
+        elif constraint == 'ge':
+            return cs.no_info_after_validator_function(
+                partial(_validators.greater_than_or_equal_validator, ge=value),
+                schema,
+            )
+        elif constraint == 'lt':
+            return cs.no_info_after_validator_function(
+                partial(_validators.less_than_validator, lt=value),
+                schema,
+            )
+        elif constraint == 'le':
+            return cs.no_info_after_validator_function(
+                partial(_validators.less_than_or_equal_validator, le=value),
+                schema,
+            )
+        elif constraint == 'multiple_of':
+            return cs.no_info_after_validator_function(
+                partial(_validators.multiple_of_validator, multiple_of=value),
+                schema,
+            )
+        elif constraint == 'min_length':
+            s = cs.no_info_after_validator_function(
+                partial(_validators.min_length_validator, min_length=value),
+                schema,
+            )
+            add_js_update_schema(s, lambda: {'minLength': (as_jsonable_value(value))})
+            return s
+        elif constraint == 'max_length':
+            s = cs.no_info_after_validator_function(
+                partial(_validators.max_length_validator, max_length=value),
+                schema,
+            )
+            add_js_update_schema(s, lambda: {'maxLength': (as_jsonable_value(value))})
+            return s
+        elif constraint == 'strip_whitespace':
+            return cs.chain_schema(
+                [
+                    schema,
+                    cs.str_schema(strip_whitespace=True),
+                ]
+            )
+        elif constraint == 'to_lower':
+            return cs.chain_schema(
+                [
+                    schema,
+                    cs.str_schema(to_lower=True),
+                ]
+            )
+        elif constraint == 'to_upper':
+            return cs.chain_schema(
+                [
+                    schema,
+                    cs.str_schema(to_upper=True),
+                ]
+            )
+        elif constraint == 'min_length':
+            return cs.no_info_after_validator_function(
+                partial(_validators.min_length_validator, min_length=annotation.min_length),
+                schema,
+            )
+        elif constraint == 'max_length':
+            return cs.no_info_after_validator_function(
+                partial(_validators.max_length_validator, max_length=annotation.max_length),
+                schema,
+            )
+        else:
+            raise RuntimeError(f'Unable to apply constraint {constraint} to schema {schema_type}')
+
+    for annotation in other_metadata:
+        if isinstance(annotation, at.Gt):
+            return cs.no_info_after_validator_function(
+                partial(_validators.greater_than_validator, gt=annotation.gt),
+                schema,
+            )
+        elif isinstance(annotation, at.Ge):
+            return cs.no_info_after_validator_function(
+                partial(_validators.greater_than_or_equal_validator, ge=annotation.ge),
+                schema,
+            )
+        elif isinstance(annotation, at.Lt):
+            return cs.no_info_after_validator_function(
+                partial(_validators.less_than_validator, lt=annotation.lt),
+                schema,
+            )
+        elif isinstance(annotation, at.Le):
+            return cs.no_info_after_validator_function(
+                partial(_validators.less_than_or_equal_validator, le=annotation.le),
+                schema,
+            )
+        elif isinstance(annotation, at.MultipleOf):
+            return cs.no_info_after_validator_function(
+                partial(_validators.multiple_of_validator, multiple_of=annotation.multiple_of),
+                schema,
+            )
+        elif isinstance(annotation, at.MinLen):
+            return cs.no_info_after_validator_function(
+                partial(_validators.min_length_validator, min_length=annotation.min_length),
+                schema,
+            )
+        elif isinstance(annotation, at.MaxLen):
+            return cs.no_info_after_validator_function(
+                partial(_validators.max_length_validator, max_length=annotation.max_length),
+                schema,
+            )
+        elif isinstance(annotation, at.Predicate):
+            predicate_name = f'{annotation.func.__qualname__} ' if hasattr(annotation.func, '__qualname__') else ''
+
+            def val_func(v: Any) -> Any:
+                # annotation.func may also raise an exception, let it pass through
+                if not annotation.func(v):
+                    raise PydanticCustomError(
+                        'predicate_failed',
+                        f'Predicate {predicate_name}failed',  # type: ignore
+                    )
+                return v
+
+            return cs.no_info_after_validator_function(val_func, schema)
+        # ignore any other unknown metadata
+        return None
+
+    return schema
+
+
+def collect_known_metadata(annotations: Iterable[Any]) -> tuple[dict[str, Any], list[Any]]:
+    """Split `annotations` into known metadata and unknown annotations.
+
+    Args:
+        annotations: An iterable of annotations.
+
+    Returns:
+        A tuple contains a dict of known metadata and a list of unknown annotations.
+
+    Example:
+        ```py
+        from annotated_types import Gt, Len
+
+        from pydantic._internal._known_annotated_metadata import collect_known_metadata
+
+        print(collect_known_metadata([Gt(1), Len(42), ...]))
+        #> ({'gt': 1, 'min_length': 42}, [Ellipsis])
+        ```
+    """
+    import annotated_types as at
+
+    annotations = expand_grouped_metadata(annotations)
+
+    res: dict[str, Any] = {}
+    remaining: list[Any] = []
+    for annotation in annotations:
+        # isinstance(annotation, PydanticMetadata) also covers ._fields:_PydanticGeneralMetadata
+        if isinstance(annotation, PydanticMetadata):
+            res.update(annotation.__dict__)
+        # we don't use dataclasses.asdict because that recursively calls asdict on the field values
+        elif isinstance(annotation, at.MinLen):
+            res.update({'min_length': annotation.min_length})
+        elif isinstance(annotation, at.MaxLen):
+            res.update({'max_length': annotation.max_length})
+        elif isinstance(annotation, at.Gt):
+            res.update({'gt': annotation.gt})
+        elif isinstance(annotation, at.Ge):
+            res.update({'ge': annotation.ge})
+        elif isinstance(annotation, at.Lt):
+            res.update({'lt': annotation.lt})
+        elif isinstance(annotation, at.Le):
+            res.update({'le': annotation.le})
+        elif isinstance(annotation, at.MultipleOf):
+            res.update({'multiple_of': annotation.multiple_of})
+        elif isinstance(annotation, type) and issubclass(annotation, PydanticMetadata):
+            # also support PydanticMetadata classes being used without initialisation,
+            # e.g. `Annotated[int, Strict]` as well as `Annotated[int, Strict()]`
+            res.update({k: v for k, v in vars(annotation).items() if not k.startswith('_')})
+        else:
+            remaining.append(annotation)
+    # Nones can sneak in but pydantic-core will reject them
+    # it'd be nice to clean things up so we don't put in None (we probably don't _need_ to, it was just easier)
+    # but this is simple enough to kick that can down the road
+    res = {k: v for k, v in res.items() if v is not None}
+    return res, remaining
+
+
+def check_metadata(metadata: dict[str, Any], allowed: Iterable[str], source_type: Any) -> None:
+    """A small utility function to validate that the given metadata can be applied to the target.
+    More than saving lines of code, this gives us a consistent error message for all of our internal implementations.
+
+    Args:
+        metadata: A dict of metadata.
+        allowed: An iterable of allowed metadata.
+        source_type: The source type.
+
+    Raises:
+        TypeError: If there is metadatas that can't be applied on source type.
+    """
+    unknown = metadata.keys() - set(allowed)
+    if unknown:
+        raise TypeError(
+            f'The following constraints cannot be applied to {source_type!r}: {", ".join([f"{k!r}" for k in unknown])}'
+        )
diff --git a/lib/pydantic/_internal/_mock_val_ser.py b/lib/pydantic/_internal/_mock_val_ser.py
new file mode 100644
index 00000000..b303fed2
--- /dev/null
+++ b/lib/pydantic/_internal/_mock_val_ser.py
@@ -0,0 +1,140 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Callable, Generic, TypeVar
+
+from pydantic_core import SchemaSerializer, SchemaValidator
+from typing_extensions import Literal
+
+from ..errors import PydanticErrorCodes, PydanticUserError
+
+if TYPE_CHECKING:
+    from ..dataclasses import PydanticDataclass
+    from ..main import BaseModel
+
+
+ValSer = TypeVar('ValSer', SchemaValidator, SchemaSerializer)
+
+
+class MockValSer(Generic[ValSer]):
+    """Mocker for `pydantic_core.SchemaValidator` or `pydantic_core.SchemaSerializer` which optionally attempts to
+    rebuild the thing it's mocking when one of its methods is accessed and raises an error if that fails.
+    """
+
+    __slots__ = '_error_message', '_code', '_val_or_ser', '_attempt_rebuild'
+
+    def __init__(
+        self,
+        error_message: str,
+        *,
+        code: PydanticErrorCodes,
+        val_or_ser: Literal['validator', 'serializer'],
+        attempt_rebuild: Callable[[], ValSer | None] | None = None,
+    ) -> None:
+        self._error_message = error_message
+        self._val_or_ser = SchemaValidator if val_or_ser == 'validator' else SchemaSerializer
+        self._code: PydanticErrorCodes = code
+        self._attempt_rebuild = attempt_rebuild
+
+    def __getattr__(self, item: str) -> None:
+        __tracebackhide__ = True
+        if self._attempt_rebuild:
+            val_ser = self._attempt_rebuild()
+            if val_ser is not None:
+                return getattr(val_ser, item)
+
+        # raise an AttributeError if `item` doesn't exist
+        getattr(self._val_or_ser, item)
+        raise PydanticUserError(self._error_message, code=self._code)
+
+    def rebuild(self) -> ValSer | None:
+        if self._attempt_rebuild:
+            val_ser = self._attempt_rebuild()
+            if val_ser is not None:
+                return val_ser
+            else:
+                raise PydanticUserError(self._error_message, code=self._code)
+        return None
+
+
+def set_model_mocks(cls: type[BaseModel], cls_name: str, undefined_name: str = 'all referenced types') -> None:
+    """Set `__pydantic_validator__` and `__pydantic_serializer__` to `MockValSer`s on a model.
+
+    Args:
+        cls: The model class to set the mocks on
+        cls_name: Name of the model class, used in error messages
+        undefined_name: Name of the undefined thing, used in error messages
+    """
+    undefined_type_error_message = (
+        f'`{cls_name}` is not fully defined; you should define {undefined_name},'
+        f' then call `{cls_name}.model_rebuild()`.'
+    )
+
+    def attempt_rebuild_validator() -> SchemaValidator | None:
+        if cls.model_rebuild(raise_errors=False, _parent_namespace_depth=5) is not False:
+            return cls.__pydantic_validator__
+        else:
+            return None
+
+    cls.__pydantic_validator__ = MockValSer(  # type: ignore[assignment]
+        undefined_type_error_message,
+        code='class-not-fully-defined',
+        val_or_ser='validator',
+        attempt_rebuild=attempt_rebuild_validator,
+    )
+
+    def attempt_rebuild_serializer() -> SchemaSerializer | None:
+        if cls.model_rebuild(raise_errors=False, _parent_namespace_depth=5) is not False:
+            return cls.__pydantic_serializer__
+        else:
+            return None
+
+    cls.__pydantic_serializer__ = MockValSer(  # type: ignore[assignment]
+        undefined_type_error_message,
+        code='class-not-fully-defined',
+        val_or_ser='serializer',
+        attempt_rebuild=attempt_rebuild_serializer,
+    )
+
+
+def set_dataclass_mocks(
+    cls: type[PydanticDataclass], cls_name: str, undefined_name: str = 'all referenced types'
+) -> None:
+    """Set `__pydantic_validator__` and `__pydantic_serializer__` to `MockValSer`s on a dataclass.
+
+    Args:
+        cls: The model class to set the mocks on
+        cls_name: Name of the model class, used in error messages
+        undefined_name: Name of the undefined thing, used in error messages
+    """
+    from ..dataclasses import rebuild_dataclass
+
+    undefined_type_error_message = (
+        f'`{cls_name}` is not fully defined; you should define {undefined_name},'
+        f' then call `pydantic.dataclasses.rebuild_dataclass({cls_name})`.'
+    )
+
+    def attempt_rebuild_validator() -> SchemaValidator | None:
+        if rebuild_dataclass(cls, raise_errors=False, _parent_namespace_depth=5) is not False:
+            return cls.__pydantic_validator__
+        else:
+            return None
+
+    cls.__pydantic_validator__ = MockValSer(  # type: ignore[assignment]
+        undefined_type_error_message,
+        code='class-not-fully-defined',
+        val_or_ser='validator',
+        attempt_rebuild=attempt_rebuild_validator,
+    )
+
+    def attempt_rebuild_serializer() -> SchemaSerializer | None:
+        if rebuild_dataclass(cls, raise_errors=False, _parent_namespace_depth=5) is not False:
+            return cls.__pydantic_serializer__
+        else:
+            return None
+
+    cls.__pydantic_serializer__ = MockValSer(  # type: ignore[assignment]
+        undefined_type_error_message,
+        code='class-not-fully-defined',
+        val_or_ser='validator',
+        attempt_rebuild=attempt_rebuild_serializer,
+    )
diff --git a/lib/pydantic/_internal/_model_construction.py b/lib/pydantic/_internal/_model_construction.py
new file mode 100644
index 00000000..543f73e9
--- /dev/null
+++ b/lib/pydantic/_internal/_model_construction.py
@@ -0,0 +1,637 @@
+"""Private logic for creating models."""
+from __future__ import annotations as _annotations
+
+import operator
+import typing
+import warnings
+import weakref
+from abc import ABCMeta
+from functools import partial
+from types import FunctionType
+from typing import Any, Callable, Generic
+
+import typing_extensions
+from pydantic_core import PydanticUndefined, SchemaSerializer
+from typing_extensions import dataclass_transform, deprecated
+
+from ..errors import PydanticUndefinedAnnotation, PydanticUserError
+from ..plugin._schema_validator import create_schema_validator
+from ..warnings import GenericBeforeBaseModelWarning, PydanticDeprecatedSince20
+from ._config import ConfigWrapper
+from ._decorators import DecoratorInfos, PydanticDescriptorProxy, get_attribute_from_bases
+from ._fields import collect_model_fields, is_valid_field_name, is_valid_privateattr_name
+from ._generate_schema import GenerateSchema
+from ._generics import PydanticGenericMetadata, get_model_typevars_map
+from ._mock_val_ser import MockValSer, set_model_mocks
+from ._schema_generation_shared import CallbackGetCoreSchemaHandler
+from ._signature import generate_pydantic_signature
+from ._typing_extra import get_cls_types_namespace, is_annotated, is_classvar, parent_frame_namespace
+from ._utils import ClassAttribute, SafeGetItemProxy
+from ._validate_call import ValidateCallWrapper
+
+if typing.TYPE_CHECKING:
+    from ..fields import Field as PydanticModelField
+    from ..fields import FieldInfo, ModelPrivateAttr
+    from ..main import BaseModel
+else:
+    # See PyCharm issues https://youtrack.jetbrains.com/issue/PY-21915
+    # and https://youtrack.jetbrains.com/issue/PY-51428
+    DeprecationWarning = PydanticDeprecatedSince20
+    PydanticModelField = object()
+
+object_setattr = object.__setattr__
+
+
+class _ModelNamespaceDict(dict):
+    """A dictionary subclass that intercepts attribute setting on model classes and
+    warns about overriding of decorators.
+    """
+
+    def __setitem__(self, k: str, v: object) -> None:
+        existing: Any = self.get(k, None)
+        if existing and v is not existing and isinstance(existing, PydanticDescriptorProxy):
+            warnings.warn(f'`{k}` overrides an existing Pydantic `{existing.decorator_info.decorator_repr}` decorator')
+
+        return super().__setitem__(k, v)
+
+
+@dataclass_transform(kw_only_default=True, field_specifiers=(PydanticModelField,))
+class ModelMetaclass(ABCMeta):
+    def __new__(
+        mcs,
+        cls_name: str,
+        bases: tuple[type[Any], ...],
+        namespace: dict[str, Any],
+        __pydantic_generic_metadata__: PydanticGenericMetadata | None = None,
+        __pydantic_reset_parent_namespace__: bool = True,
+        _create_model_module: str | None = None,
+        **kwargs: Any,
+    ) -> type:
+        """Metaclass for creating Pydantic models.
+
+        Args:
+            cls_name: The name of the class to be created.
+            bases: The base classes of the class to be created.
+            namespace: The attribute dictionary of the class to be created.
+            __pydantic_generic_metadata__: Metadata for generic models.
+            __pydantic_reset_parent_namespace__: Reset parent namespace.
+            _create_model_module: The module of the class to be created, if created by `create_model`.
+            **kwargs: Catch-all for any other keyword arguments.
+
+        Returns:
+            The new class created by the metaclass.
+        """
+        # Note `ModelMetaclass` refers to `BaseModel`, but is also used to *create* `BaseModel`, so we rely on the fact
+        # that `BaseModel` itself won't have any bases, but any subclass of it will, to determine whether the `__new__`
+        # call we're in the middle of is for the `BaseModel` class.
+        if bases:
+            base_field_names, class_vars, base_private_attributes = mcs._collect_bases_data(bases)
+
+            config_wrapper = ConfigWrapper.for_model(bases, namespace, kwargs)
+            namespace['model_config'] = config_wrapper.config_dict
+            private_attributes = inspect_namespace(
+                namespace, config_wrapper.ignored_types, class_vars, base_field_names
+            )
+            if private_attributes:
+                original_model_post_init = get_model_post_init(namespace, bases)
+                if original_model_post_init is not None:
+                    # if there are private_attributes and a model_post_init function, we handle both
+
+                    def wrapped_model_post_init(self: BaseModel, __context: Any) -> None:
+                        """We need to both initialize private attributes and call the user-defined model_post_init
+                        method.
+                        """
+                        init_private_attributes(self, __context)
+                        original_model_post_init(self, __context)
+
+                    namespace['model_post_init'] = wrapped_model_post_init
+                else:
+                    namespace['model_post_init'] = init_private_attributes
+
+            namespace['__class_vars__'] = class_vars
+            namespace['__private_attributes__'] = {**base_private_attributes, **private_attributes}
+
+            cls: type[BaseModel] = super().__new__(mcs, cls_name, bases, namespace, **kwargs)  # type: ignore
+
+            from ..main import BaseModel
+
+            mro = cls.__mro__
+            if Generic in mro and mro.index(Generic) < mro.index(BaseModel):
+                warnings.warn(
+                    GenericBeforeBaseModelWarning(
+                        'Classes should inherit from `BaseModel` before generic classes (e.g. `typing.Generic[T]`) '
+                        'for pydantic generics to work properly.'
+                    ),
+                    stacklevel=2,
+                )
+
+            cls.__pydantic_custom_init__ = not getattr(cls.__init__, '__pydantic_base_init__', False)
+            cls.__pydantic_post_init__ = None if cls.model_post_init is BaseModel.model_post_init else 'model_post_init'
+
+            cls.__pydantic_decorators__ = DecoratorInfos.build(cls)
+
+            # Use the getattr below to grab the __parameters__ from the `typing.Generic` parent class
+            if __pydantic_generic_metadata__:
+                cls.__pydantic_generic_metadata__ = __pydantic_generic_metadata__
+            else:
+                parent_parameters = getattr(cls, '__pydantic_generic_metadata__', {}).get('parameters', ())
+                parameters = getattr(cls, '__parameters__', None) or parent_parameters
+                if parameters and parent_parameters and not all(x in parameters for x in parent_parameters):
+                    combined_parameters = parent_parameters + tuple(x for x in parameters if x not in parent_parameters)
+                    parameters_str = ', '.join([str(x) for x in combined_parameters])
+                    generic_type_label = f'typing.Generic[{parameters_str}]'
+                    error_message = (
+                        f'All parameters must be present on typing.Generic;'
+                        f' you should inherit from {generic_type_label}.'
+                    )
+                    if Generic not in bases:  # pragma: no cover
+                        # We raise an error here not because it is desirable, but because some cases are mishandled.
+                        # It would be nice to remove this error and still have things behave as expected, it's just
+                        # challenging because we are using a custom `__class_getitem__` to parametrize generic models,
+                        # and not returning a typing._GenericAlias from it.
+                        bases_str = ', '.join([x.__name__ for x in bases] + [generic_type_label])
+                        error_message += (
+                            f' Note: `typing.Generic` must go last: `class {cls.__name__}({bases_str}): ...`)'
+                        )
+                    raise TypeError(error_message)
+
+                cls.__pydantic_generic_metadata__ = {
+                    'origin': None,
+                    'args': (),
+                    'parameters': parameters,
+                }
+
+            cls.__pydantic_complete__ = False  # Ensure this specific class gets completed
+
+            # preserve `__set_name__` protocol defined in https://peps.python.org/pep-0487
+            # for attributes not in `new_namespace` (e.g. private attributes)
+            for name, obj in private_attributes.items():
+                obj.__set_name__(cls, name)
+
+            if __pydantic_reset_parent_namespace__:
+                cls.__pydantic_parent_namespace__ = build_lenient_weakvaluedict(parent_frame_namespace())
+            parent_namespace = getattr(cls, '__pydantic_parent_namespace__', None)
+            if isinstance(parent_namespace, dict):
+                parent_namespace = unpack_lenient_weakvaluedict(parent_namespace)
+
+            types_namespace = get_cls_types_namespace(cls, parent_namespace)
+            set_model_fields(cls, bases, config_wrapper, types_namespace)
+
+            if config_wrapper.frozen and '__hash__' not in namespace:
+                set_default_hash_func(cls, bases)
+
+            complete_model_class(
+                cls,
+                cls_name,
+                config_wrapper,
+                raise_errors=False,
+                types_namespace=types_namespace,
+                create_model_module=_create_model_module,
+            )
+
+            # If this is placed before the complete_model_class call above,
+            # the generic computed fields return type is set to PydanticUndefined
+            cls.model_computed_fields = {k: v.info for k, v in cls.__pydantic_decorators__.computed_fields.items()}
+
+            # using super(cls, cls) on the next line ensures we only call the parent class's __pydantic_init_subclass__
+            # I believe the `type: ignore` is only necessary because mypy doesn't realize that this code branch is
+            # only hit for _proper_ subclasses of BaseModel
+            super(cls, cls).__pydantic_init_subclass__(**kwargs)  # type: ignore[misc]
+            return cls
+        else:
+            # this is the BaseModel class itself being created, no logic required
+            return super().__new__(mcs, cls_name, bases, namespace, **kwargs)
+
+    if not typing.TYPE_CHECKING:  # pragma: no branch
+        # We put `__getattr__` in a non-TYPE_CHECKING block because otherwise, mypy allows arbitrary attribute access
+
+        def __getattr__(self, item: str) -> Any:
+            """This is necessary to keep attribute access working for class attribute access."""
+            private_attributes = self.__dict__.get('__private_attributes__')
+            if private_attributes and item in private_attributes:
+                return private_attributes[item]
+            if item == '__pydantic_core_schema__':
+                # This means the class didn't get a schema generated for it, likely because there was an undefined reference
+                maybe_mock_validator = getattr(self, '__pydantic_validator__', None)
+                if isinstance(maybe_mock_validator, MockValSer):
+                    rebuilt_validator = maybe_mock_validator.rebuild()
+                    if rebuilt_validator is not None:
+                        # In this case, a validator was built, and so `__pydantic_core_schema__` should now be set
+                        return getattr(self, '__pydantic_core_schema__')
+            raise AttributeError(item)
+
+    @classmethod
+    def __prepare__(cls, *args: Any, **kwargs: Any) -> dict[str, object]:
+        return _ModelNamespaceDict()
+
+    def __instancecheck__(self, instance: Any) -> bool:
+        """Avoid calling ABC _abc_subclasscheck unless we're pretty sure.
+
+        See #3829 and python/cpython#92810
+        """
+        return hasattr(instance, '__pydantic_validator__') and super().__instancecheck__(instance)
+
+    @staticmethod
+    def _collect_bases_data(bases: tuple[type[Any], ...]) -> tuple[set[str], set[str], dict[str, ModelPrivateAttr]]:
+        from ..main import BaseModel
+
+        field_names: set[str] = set()
+        class_vars: set[str] = set()
+        private_attributes: dict[str, ModelPrivateAttr] = {}
+        for base in bases:
+            if issubclass(base, BaseModel) and base is not BaseModel:
+                # model_fields might not be defined yet in the case of generics, so we use getattr here:
+                field_names.update(getattr(base, 'model_fields', {}).keys())
+                class_vars.update(base.__class_vars__)
+                private_attributes.update(base.__private_attributes__)
+        return field_names, class_vars, private_attributes
+
+    @property
+    @deprecated('The `__fields__` attribute is deprecated, use `model_fields` instead.', category=None)
+    def __fields__(self) -> dict[str, FieldInfo]:
+        warnings.warn(
+            'The `__fields__` attribute is deprecated, use `model_fields` instead.', PydanticDeprecatedSince20
+        )
+        return self.model_fields  # type: ignore
+
+    def __dir__(self) -> list[str]:
+        attributes = list(super().__dir__())
+        if '__fields__' in attributes:
+            attributes.remove('__fields__')
+        return attributes
+
+
+def init_private_attributes(self: BaseModel, __context: Any) -> None:
+    """This function is meant to behave like a BaseModel method to initialise private attributes.
+
+    It takes context as an argument since that's what pydantic-core passes when calling it.
+
+    Args:
+        self: The BaseModel instance.
+        __context: The context.
+    """
+    if getattr(self, '__pydantic_private__', None) is None:
+        pydantic_private = {}
+        for name, private_attr in self.__private_attributes__.items():
+            default = private_attr.get_default()
+            if default is not PydanticUndefined:
+                pydantic_private[name] = default
+        object_setattr(self, '__pydantic_private__', pydantic_private)
+
+
+def get_model_post_init(namespace: dict[str, Any], bases: tuple[type[Any], ...]) -> Callable[..., Any] | None:
+    """Get the `model_post_init` method from the namespace or the class bases, or `None` if not defined."""
+    if 'model_post_init' in namespace:
+        return namespace['model_post_init']
+
+    from ..main import BaseModel
+
+    model_post_init = get_attribute_from_bases(bases, 'model_post_init')
+    if model_post_init is not BaseModel.model_post_init:
+        return model_post_init
+
+
+def inspect_namespace(  # noqa C901
+    namespace: dict[str, Any],
+    ignored_types: tuple[type[Any], ...],
+    base_class_vars: set[str],
+    base_class_fields: set[str],
+) -> dict[str, ModelPrivateAttr]:
+    """Iterate over the namespace and:
+    * gather private attributes
+    * check for items which look like fields but are not (e.g. have no annotation) and warn.
+
+    Args:
+        namespace: The attribute dictionary of the class to be created.
+        ignored_types: A tuple of ignore types.
+        base_class_vars: A set of base class class variables.
+        base_class_fields: A set of base class fields.
+
+    Returns:
+        A dict contains private attributes info.
+
+    Raises:
+        TypeError: If there is a `__root__` field in model.
+        NameError: If private attribute name is invalid.
+        PydanticUserError:
+            - If a field does not have a type annotation.
+            - If a field on base class was overridden by a non-annotated attribute.
+    """
+    from ..fields import FieldInfo, ModelPrivateAttr, PrivateAttr
+
+    all_ignored_types = ignored_types + default_ignored_types()
+
+    private_attributes: dict[str, ModelPrivateAttr] = {}
+    raw_annotations = namespace.get('__annotations__', {})
+
+    if '__root__' in raw_annotations or '__root__' in namespace:
+        raise TypeError("To define root models, use `pydantic.RootModel` rather than a field called '__root__'")
+
+    ignored_names: set[str] = set()
+    for var_name, value in list(namespace.items()):
+        if var_name == 'model_config':
+            continue
+        elif (
+            isinstance(value, type)
+            and value.__module__ == namespace['__module__']
+            and value.__qualname__.startswith(namespace['__qualname__'])
+        ):
+            # `value` is a nested type defined in this namespace; don't error
+            continue
+        elif isinstance(value, all_ignored_types) or value.__class__.__module__ == 'functools':
+            ignored_names.add(var_name)
+            continue
+        elif isinstance(value, ModelPrivateAttr):
+            if var_name.startswith('__'):
+                raise NameError(
+                    'Private attributes must not use dunder names;'
+                    f' use a single underscore prefix instead of {var_name!r}.'
+                )
+            elif is_valid_field_name(var_name):
+                raise NameError(
+                    'Private attributes must not use valid field names;'
+                    f' use sunder names, e.g. {"_" + var_name!r} instead of {var_name!r}.'
+                )
+            private_attributes[var_name] = value
+            del namespace[var_name]
+        elif isinstance(value, FieldInfo) and not is_valid_field_name(var_name):
+            suggested_name = var_name.lstrip('_') or 'my_field'  # don't suggest '' for all-underscore name
+            raise NameError(
+                f'Fields must not use names with leading underscores;'
+                f' e.g., use {suggested_name!r} instead of {var_name!r}.'
+            )
+
+        elif var_name.startswith('__'):
+            continue
+        elif is_valid_privateattr_name(var_name):
+            if var_name not in raw_annotations or not is_classvar(raw_annotations[var_name]):
+                private_attributes[var_name] = PrivateAttr(default=value)
+                del namespace[var_name]
+        elif var_name in base_class_vars:
+            continue
+        elif var_name not in raw_annotations:
+            if var_name in base_class_fields:
+                raise PydanticUserError(
+                    f'Field {var_name!r} defined on a base class was overridden by a non-annotated attribute. '
+                    f'All field definitions, including overrides, require a type annotation.',
+                    code='model-field-overridden',
+                )
+            elif isinstance(value, FieldInfo):
+                raise PydanticUserError(
+                    f'Field {var_name!r} requires a type annotation', code='model-field-missing-annotation'
+                )
+            else:
+                raise PydanticUserError(
+                    f'A non-annotated attribute was detected: `{var_name} = {value!r}`. All model fields require a '
+                    f'type annotation; if `{var_name}` is not meant to be a field, you may be able to resolve this '
+                    f"error by annotating it as a `ClassVar` or updating `model_config['ignored_types']`.",
+                    code='model-field-missing-annotation',
+                )
+
+    for ann_name, ann_type in raw_annotations.items():
+        if (
+            is_valid_privateattr_name(ann_name)
+            and ann_name not in private_attributes
+            and ann_name not in ignored_names
+            and not is_classvar(ann_type)
+            and ann_type not in all_ignored_types
+            and getattr(ann_type, '__module__', None) != 'functools'
+        ):
+            if is_annotated(ann_type):
+                _, *metadata = typing_extensions.get_args(ann_type)
+                private_attr = next((v for v in metadata if isinstance(v, ModelPrivateAttr)), None)
+                if private_attr is not None:
+                    private_attributes[ann_name] = private_attr
+                    continue
+            private_attributes[ann_name] = PrivateAttr()
+
+    return private_attributes
+
+
+def set_default_hash_func(cls: type[BaseModel], bases: tuple[type[Any], ...]) -> None:
+    base_hash_func = get_attribute_from_bases(bases, '__hash__')
+    new_hash_func = make_hash_func(cls)
+    if base_hash_func in {None, object.__hash__} or getattr(base_hash_func, '__code__', None) == new_hash_func.__code__:
+        # If `__hash__` is some default, we generate a hash function.
+        # It will be `None` if not overridden from BaseModel.
+        # It may be `object.__hash__` if there is another
+        # parent class earlier in the bases which doesn't override `__hash__` (e.g. `typing.Generic`).
+        # It may be a value set by `set_default_hash_func` if `cls` is a subclass of another frozen model.
+        # In the last case we still need a new hash function to account for new `model_fields`.
+        cls.__hash__ = new_hash_func
+
+
+def make_hash_func(cls: type[BaseModel]) -> Any:
+    getter = operator.itemgetter(*cls.model_fields.keys()) if cls.model_fields else lambda _: 0
+
+    def hash_func(self: Any) -> int:
+        try:
+            return hash(getter(self.__dict__))
+        except KeyError:
+            # In rare cases (such as when using the deprecated copy method), the __dict__ may not contain
+            # all model fields, which is how we can get here.
+            # getter(self.__dict__) is much faster than any 'safe' method that accounts for missing keys,
+            # and wrapping it in a `try` doesn't slow things down much in the common case.
+            return hash(getter(SafeGetItemProxy(self.__dict__)))
+
+    return hash_func
+
+
+def set_model_fields(
+    cls: type[BaseModel], bases: tuple[type[Any], ...], config_wrapper: ConfigWrapper, types_namespace: dict[str, Any]
+) -> None:
+    """Collect and set `cls.model_fields` and `cls.__class_vars__`.
+
+    Args:
+        cls: BaseModel or dataclass.
+        bases: Parents of the class, generally `cls.__bases__`.
+        config_wrapper: The config wrapper instance.
+        types_namespace: Optional extra namespace to look for types in.
+    """
+    typevars_map = get_model_typevars_map(cls)
+    fields, class_vars = collect_model_fields(cls, bases, config_wrapper, types_namespace, typevars_map=typevars_map)
+
+    cls.model_fields = fields
+    cls.__class_vars__.update(class_vars)
+
+    for k in class_vars:
+        # Class vars should not be private attributes
+        #     We remove them _here_ and not earlier because we rely on inspecting the class to determine its classvars,
+        #     but private attributes are determined by inspecting the namespace _prior_ to class creation.
+        #     In the case that a classvar with a leading-'_' is defined via a ForwardRef (e.g., when using
+        #     `__future__.annotations`), we want to remove the private attribute which was detected _before_ we knew it
+        #     evaluated to a classvar
+
+        value = cls.__private_attributes__.pop(k, None)
+        if value is not None and value.default is not PydanticUndefined:
+            setattr(cls, k, value.default)
+
+
+def complete_model_class(
+    cls: type[BaseModel],
+    cls_name: str,
+    config_wrapper: ConfigWrapper,
+    *,
+    raise_errors: bool = True,
+    types_namespace: dict[str, Any] | None,
+    create_model_module: str | None = None,
+) -> bool:
+    """Finish building a model class.
+
+    This logic must be called after class has been created since validation functions must be bound
+    and `get_type_hints` requires a class object.
+
+    Args:
+        cls: BaseModel or dataclass.
+        cls_name: The model or dataclass name.
+        config_wrapper: The config wrapper instance.
+        raise_errors: Whether to raise errors.
+        types_namespace: Optional extra namespace to look for types in.
+        create_model_module: The module of the class to be created, if created by `create_model`.
+
+    Returns:
+        `True` if the model is successfully completed, else `False`.
+
+    Raises:
+        PydanticUndefinedAnnotation: If `PydanticUndefinedAnnotation` occurs in`__get_pydantic_core_schema__`
+            and `raise_errors=True`.
+    """
+    typevars_map = get_model_typevars_map(cls)
+    gen_schema = GenerateSchema(
+        config_wrapper,
+        types_namespace,
+        typevars_map,
+    )
+
+    handler = CallbackGetCoreSchemaHandler(
+        partial(gen_schema.generate_schema, from_dunder_get_core_schema=False),
+        gen_schema,
+        ref_mode='unpack',
+    )
+
+    if config_wrapper.defer_build:
+        set_model_mocks(cls, cls_name)
+        return False
+
+    try:
+        schema = cls.__get_pydantic_core_schema__(cls, handler)
+    except PydanticUndefinedAnnotation as e:
+        if raise_errors:
+            raise
+        set_model_mocks(cls, cls_name, f'`{e.name}`')
+        return False
+
+    core_config = config_wrapper.core_config(cls)
+
+    try:
+        schema = gen_schema.clean_schema(schema)
+    except gen_schema.CollectedInvalid:
+        set_model_mocks(cls, cls_name)
+        return False
+
+    # debug(schema)
+    cls.__pydantic_core_schema__ = schema
+
+    cls.__pydantic_validator__ = create_schema_validator(
+        schema,
+        cls,
+        create_model_module or cls.__module__,
+        cls.__qualname__,
+        'create_model' if create_model_module else 'BaseModel',
+        core_config,
+        config_wrapper.plugin_settings,
+    )
+    cls.__pydantic_serializer__ = SchemaSerializer(schema, core_config)
+    cls.__pydantic_complete__ = True
+
+    # set __signature__ attr only for model class, but not for its instances
+    cls.__signature__ = ClassAttribute(
+        '__signature__',
+        generate_pydantic_signature(init=cls.__init__, fields=cls.model_fields, config_wrapper=config_wrapper),
+    )
+    return True
+
+
+class _PydanticWeakRef:
+    """Wrapper for `weakref.ref` that enables `pickle` serialization.
+
+    Cloudpickle fails to serialize `weakref.ref` objects due to an arcane error related
+    to abstract base classes (`abc.ABC`). This class works around the issue by wrapping
+    `weakref.ref` instead of subclassing it.
+
+    See https://github.com/pydantic/pydantic/issues/6763 for context.
+
+    Semantics:
+        - If not pickled, behaves the same as a `weakref.ref`.
+        - If pickled along with the referenced object, the same `weakref.ref` behavior
+          will be maintained between them after unpickling.
+        - If pickled without the referenced object, after unpickling the underlying
+          reference will be cleared (`__call__` will always return `None`).
+    """
+
+    def __init__(self, obj: Any):
+        if obj is None:
+            # The object will be `None` upon deserialization if the serialized weakref
+            # had lost its underlying object.
+            self._wr = None
+        else:
+            self._wr = weakref.ref(obj)
+
+    def __call__(self) -> Any:
+        if self._wr is None:
+            return None
+        else:
+            return self._wr()
+
+    def __reduce__(self) -> tuple[Callable, tuple[weakref.ReferenceType | None]]:
+        return _PydanticWeakRef, (self(),)
+
+
+def build_lenient_weakvaluedict(d: dict[str, Any] | None) -> dict[str, Any] | None:
+    """Takes an input dictionary, and produces a new value that (invertibly) replaces the values with weakrefs.
+
+    We can't just use a WeakValueDictionary because many types (including int, str, etc.) can't be stored as values
+    in a WeakValueDictionary.
+
+    The `unpack_lenient_weakvaluedict` function can be used to reverse this operation.
+    """
+    if d is None:
+        return None
+    result = {}
+    for k, v in d.items():
+        try:
+            proxy = _PydanticWeakRef(v)
+        except TypeError:
+            proxy = v
+        result[k] = proxy
+    return result
+
+
+def unpack_lenient_weakvaluedict(d: dict[str, Any] | None) -> dict[str, Any] | None:
+    """Inverts the transform performed by `build_lenient_weakvaluedict`."""
+    if d is None:
+        return None
+
+    result = {}
+    for k, v in d.items():
+        if isinstance(v, _PydanticWeakRef):
+            v = v()
+            if v is not None:
+                result[k] = v
+        else:
+            result[k] = v
+    return result
+
+
+def default_ignored_types() -> tuple[type[Any], ...]:
+    from ..fields import ComputedFieldInfo
+
+    return (
+        FunctionType,
+        property,
+        classmethod,
+        staticmethod,
+        PydanticDescriptorProxy,
+        ComputedFieldInfo,
+        ValidateCallWrapper,
+    )
diff --git a/lib/pydantic/_internal/_repr.py b/lib/pydantic/_internal/_repr.py
new file mode 100644
index 00000000..479b4479
--- /dev/null
+++ b/lib/pydantic/_internal/_repr.py
@@ -0,0 +1,117 @@
+"""Tools to provide pretty/human-readable display of objects."""
+from __future__ import annotations as _annotations
+
+import types
+import typing
+from typing import Any
+
+import typing_extensions
+
+from . import _typing_extra
+
+if typing.TYPE_CHECKING:
+    ReprArgs: typing_extensions.TypeAlias = 'typing.Iterable[tuple[str | None, Any]]'
+    RichReprResult: typing_extensions.TypeAlias = (
+        'typing.Iterable[Any | tuple[Any] | tuple[str, Any] | tuple[str, Any, Any]]'
+    )
+
+
+class PlainRepr(str):
+    """String class where repr doesn't include quotes. Useful with Representation when you want to return a string
+    representation of something that is valid (or pseudo-valid) python.
+    """
+
+    def __repr__(self) -> str:
+        return str(self)
+
+
+class Representation:
+    # Mixin to provide `__str__`, `__repr__`, and `__pretty__` and `__rich_repr__` methods.
+    # `__pretty__` is used by [devtools](https://python-devtools.helpmanual.io/).
+    # `__rich_repr__` is used by [rich](https://rich.readthedocs.io/en/stable/pretty.html).
+    # (this is not a docstring to avoid adding a docstring to classes which inherit from Representation)
+
+    # we don't want to use a type annotation here as it can break get_type_hints
+    __slots__ = tuple()  # type: typing.Collection[str]
+
+    def __repr_args__(self) -> ReprArgs:
+        """Returns the attributes to show in __str__, __repr__, and __pretty__ this is generally overridden.
+
+        Can either return:
+        * name - value pairs, e.g.: `[('foo_name', 'foo'), ('bar_name', ['b', 'a', 'r'])]`
+        * or, just values, e.g.: `[(None, 'foo'), (None, ['b', 'a', 'r'])]`
+        """
+        attrs_names = self.__slots__
+        if not attrs_names and hasattr(self, '__dict__'):
+            attrs_names = self.__dict__.keys()
+        attrs = ((s, getattr(self, s)) for s in attrs_names)
+        return [(a, v) for a, v in attrs if v is not None]
+
+    def __repr_name__(self) -> str:
+        """Name of the instance's class, used in __repr__."""
+        return self.__class__.__name__
+
+    def __repr_str__(self, join_str: str) -> str:
+        return join_str.join(repr(v) if a is None else f'{a}={v!r}' for a, v in self.__repr_args__())
+
+    def __pretty__(self, fmt: typing.Callable[[Any], Any], **kwargs: Any) -> typing.Generator[Any, None, None]:
+        """Used by devtools (https://python-devtools.helpmanual.io/) to pretty print objects."""
+        yield self.__repr_name__() + '('
+        yield 1
+        for name, value in self.__repr_args__():
+            if name is not None:
+                yield name + '='
+            yield fmt(value)
+            yield ','
+            yield 0
+        yield -1
+        yield ')'
+
+    def __rich_repr__(self) -> RichReprResult:
+        """Used by Rich (https://rich.readthedocs.io/en/stable/pretty.html) to pretty print objects."""
+        for name, field_repr in self.__repr_args__():
+            if name is None:
+                yield field_repr
+            else:
+                yield name, field_repr
+
+    def __str__(self) -> str:
+        return self.__repr_str__(' ')
+
+    def __repr__(self) -> str:
+        return f'{self.__repr_name__()}({self.__repr_str__(", ")})'
+
+
+def display_as_type(obj: Any) -> str:
+    """Pretty representation of a type, should be as close as possible to the original type definition string.
+
+    Takes some logic from `typing._type_repr`.
+    """
+    if isinstance(obj, types.FunctionType):
+        return obj.__name__
+    elif obj is ...:
+        return '...'
+    elif isinstance(obj, Representation):
+        return repr(obj)
+    elif isinstance(obj, typing_extensions.TypeAliasType):
+        return str(obj)
+
+    if not isinstance(obj, (_typing_extra.typing_base, _typing_extra.WithArgsTypes, type)):
+        obj = obj.__class__
+
+    if _typing_extra.origin_is_union(typing_extensions.get_origin(obj)):
+        args = ', '.join(map(display_as_type, typing_extensions.get_args(obj)))
+        return f'Union[{args}]'
+    elif isinstance(obj, _typing_extra.WithArgsTypes):
+        if typing_extensions.get_origin(obj) == typing_extensions.Literal:
+            args = ', '.join(map(repr, typing_extensions.get_args(obj)))
+        else:
+            args = ', '.join(map(display_as_type, typing_extensions.get_args(obj)))
+        try:
+            return f'{obj.__qualname__}[{args}]'
+        except AttributeError:
+            return str(obj)  # handles TypeAliasType in 3.12
+    elif isinstance(obj, type):
+        return obj.__qualname__
+    else:
+        return repr(obj).replace('typing.', '').replace('typing_extensions.', '')
diff --git a/lib/pydantic/_internal/_schema_generation_shared.py b/lib/pydantic/_internal/_schema_generation_shared.py
new file mode 100644
index 00000000..1a9aa852
--- /dev/null
+++ b/lib/pydantic/_internal/_schema_generation_shared.py
@@ -0,0 +1,124 @@
+"""Types and utility functions used by various other internal tools."""
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any, Callable
+
+from pydantic_core import core_schema
+from typing_extensions import Literal
+
+from ..annotated_handlers import GetCoreSchemaHandler, GetJsonSchemaHandler
+
+if TYPE_CHECKING:
+    from ..json_schema import GenerateJsonSchema, JsonSchemaValue
+    from ._core_utils import CoreSchemaOrField
+    from ._generate_schema import GenerateSchema
+
+    GetJsonSchemaFunction = Callable[[CoreSchemaOrField, GetJsonSchemaHandler], JsonSchemaValue]
+    HandlerOverride = Callable[[CoreSchemaOrField], JsonSchemaValue]
+
+
+class GenerateJsonSchemaHandler(GetJsonSchemaHandler):
+    """JsonSchemaHandler implementation that doesn't do ref unwrapping by default.
+
+    This is used for any Annotated metadata so that we don't end up with conflicting
+    modifications to the definition schema.
+
+    Used internally by Pydantic, please do not rely on this implementation.
+    See `GetJsonSchemaHandler` for the handler API.
+    """
+
+    def __init__(self, generate_json_schema: GenerateJsonSchema, handler_override: HandlerOverride | None) -> None:
+        self.generate_json_schema = generate_json_schema
+        self.handler = handler_override or generate_json_schema.generate_inner
+        self.mode = generate_json_schema.mode
+
+    def __call__(self, __core_schema: CoreSchemaOrField) -> JsonSchemaValue:
+        return self.handler(__core_schema)
+
+    def resolve_ref_schema(self, maybe_ref_json_schema: JsonSchemaValue) -> JsonSchemaValue:
+        """Resolves `$ref` in the json schema.
+
+        This returns the input json schema if there is no `$ref` in json schema.
+
+        Args:
+            maybe_ref_json_schema: The input json schema that may contains `$ref`.
+
+        Returns:
+            Resolved json schema.
+
+        Raises:
+            LookupError: If it can't find the definition for `$ref`.
+        """
+        if '$ref' not in maybe_ref_json_schema:
+            return maybe_ref_json_schema
+        ref = maybe_ref_json_schema['$ref']
+        json_schema = self.generate_json_schema.get_schema_from_definitions(ref)
+        if json_schema is None:
+            raise LookupError(
+                f'Could not find a ref for {ref}.'
+                ' Maybe you tried to call resolve_ref_schema from within a recursive model?'
+            )
+        return json_schema
+
+
+class CallbackGetCoreSchemaHandler(GetCoreSchemaHandler):
+    """Wrapper to use an arbitrary function as a `GetCoreSchemaHandler`.
+
+    Used internally by Pydantic, please do not rely on this implementation.
+    See `GetCoreSchemaHandler` for the handler API.
+    """
+
+    def __init__(
+        self,
+        handler: Callable[[Any], core_schema.CoreSchema],
+        generate_schema: GenerateSchema,
+        ref_mode: Literal['to-def', 'unpack'] = 'to-def',
+    ) -> None:
+        self._handler = handler
+        self._generate_schema = generate_schema
+        self._ref_mode = ref_mode
+
+    def __call__(self, __source_type: Any) -> core_schema.CoreSchema:
+        schema = self._handler(__source_type)
+        ref = schema.get('ref')
+        if self._ref_mode == 'to-def':
+            if ref is not None:
+                self._generate_schema.defs.definitions[ref] = schema
+                return core_schema.definition_reference_schema(ref)
+            return schema
+        else:  # ref_mode = 'unpack
+            return self.resolve_ref_schema(schema)
+
+    def _get_types_namespace(self) -> dict[str, Any] | None:
+        return self._generate_schema._types_namespace
+
+    def generate_schema(self, __source_type: Any) -> core_schema.CoreSchema:
+        return self._generate_schema.generate_schema(__source_type)
+
+    @property
+    def field_name(self) -> str | None:
+        return self._generate_schema.field_name_stack.get()
+
+    def resolve_ref_schema(self, maybe_ref_schema: core_schema.CoreSchema) -> core_schema.CoreSchema:
+        """Resolves reference in the core schema.
+
+        Args:
+            maybe_ref_schema: The input core schema that may contains reference.
+
+        Returns:
+            Resolved core schema.
+
+        Raises:
+            LookupError: If it can't find the definition for reference.
+        """
+        if maybe_ref_schema['type'] == 'definition-ref':
+            ref = maybe_ref_schema['schema_ref']
+            if ref not in self._generate_schema.defs.definitions:
+                raise LookupError(
+                    f'Could not find a ref for {ref}.'
+                    ' Maybe you tried to call resolve_ref_schema from within a recursive model?'
+                )
+            return self._generate_schema.defs.definitions[ref]
+        elif maybe_ref_schema['type'] == 'definitions':
+            return self.resolve_ref_schema(maybe_ref_schema['schema'])
+        return maybe_ref_schema
diff --git a/lib/pydantic/_internal/_signature.py b/lib/pydantic/_internal/_signature.py
new file mode 100644
index 00000000..816a1651
--- /dev/null
+++ b/lib/pydantic/_internal/_signature.py
@@ -0,0 +1,164 @@
+from __future__ import annotations
+
+import dataclasses
+from inspect import Parameter, Signature, signature
+from typing import TYPE_CHECKING, Any, Callable
+
+from pydantic_core import PydanticUndefined
+
+from ._config import ConfigWrapper
+from ._utils import is_valid_identifier
+
+if TYPE_CHECKING:
+    from ..fields import FieldInfo
+
+
+def _field_name_for_signature(field_name: str, field_info: FieldInfo) -> str:
+    """Extract the correct name to use for the field when generating a signature.
+
+    Assuming the field has a valid alias, this will return the alias. Otherwise, it will return the field name.
+    First priority is given to the validation_alias, then the alias, then the field name.
+
+    Args:
+        field_name: The name of the field
+        field_info: The corresponding FieldInfo object.
+
+    Returns:
+        The correct name to use when generating a signature.
+    """
+
+    def _alias_if_valid(x: Any) -> str | None:
+        """Return the alias if it is a valid alias and identifier, else None."""
+        return x if isinstance(x, str) and is_valid_identifier(x) else None
+
+    return _alias_if_valid(field_info.alias) or _alias_if_valid(field_info.validation_alias) or field_name
+
+
+def _process_param_defaults(param: Parameter) -> Parameter:
+    """Modify the signature for a parameter in a dataclass where the default value is a FieldInfo instance.
+
+    Args:
+        param (Parameter): The parameter
+
+    Returns:
+        Parameter: The custom processed parameter
+    """
+    from ..fields import FieldInfo
+
+    param_default = param.default
+    if isinstance(param_default, FieldInfo):
+        annotation = param.annotation
+        # Replace the annotation if appropriate
+        # inspect does "clever" things to show annotations as strings because we have
+        # `from __future__ import annotations` in main, we don't want that
+        if annotation == 'Any':
+            annotation = Any
+
+        # Replace the field default
+        default = param_default.default
+        if default is PydanticUndefined:
+            if param_default.default_factory is PydanticUndefined:
+                default = Signature.empty
+            else:
+                # this is used by dataclasses to indicate a factory exists:
+                default = dataclasses._HAS_DEFAULT_FACTORY  # type: ignore
+        return param.replace(
+            annotation=annotation, name=_field_name_for_signature(param.name, param_default), default=default
+        )
+    return param
+
+
+def _generate_signature_parameters(  # noqa: C901 (ignore complexity, could use a refactor)
+    init: Callable[..., None],
+    fields: dict[str, FieldInfo],
+    config_wrapper: ConfigWrapper,
+) -> dict[str, Parameter]:
+    """Generate a mapping of parameter names to Parameter objects for a pydantic BaseModel or dataclass."""
+    from itertools import islice
+
+    present_params = signature(init).parameters.values()
+    merged_params: dict[str, Parameter] = {}
+    var_kw = None
+    use_var_kw = False
+
+    for param in islice(present_params, 1, None):  # skip self arg
+        # inspect does "clever" things to show annotations as strings because we have
+        # `from __future__ import annotations` in main, we don't want that
+        if fields.get(param.name):
+            # exclude params with init=False
+            if getattr(fields[param.name], 'init', True) is False:
+                continue
+            param = param.replace(name=_field_name_for_signature(param.name, fields[param.name]))
+        if param.annotation == 'Any':
+            param = param.replace(annotation=Any)
+        if param.kind is param.VAR_KEYWORD:
+            var_kw = param
+            continue
+        merged_params[param.name] = param
+
+    if var_kw:  # if custom init has no var_kw, fields which are not declared in it cannot be passed through
+        allow_names = config_wrapper.populate_by_name
+        for field_name, field in fields.items():
+            # when alias is a str it should be used for signature generation
+            param_name = _field_name_for_signature(field_name, field)
+
+            if field_name in merged_params or param_name in merged_params:
+                continue
+
+            if not is_valid_identifier(param_name):
+                if allow_names:
+                    param_name = field_name
+                else:
+                    use_var_kw = True
+                    continue
+
+            kwargs = {} if field.is_required() else {'default': field.get_default(call_default_factory=False)}
+            merged_params[param_name] = Parameter(
+                param_name, Parameter.KEYWORD_ONLY, annotation=field.rebuild_annotation(), **kwargs
+            )
+
+    if config_wrapper.extra == 'allow':
+        use_var_kw = True
+
+    if var_kw and use_var_kw:
+        # Make sure the parameter for extra kwargs
+        # does not have the same name as a field
+        default_model_signature = [
+            ('self', Parameter.POSITIONAL_ONLY),
+            ('data', Parameter.VAR_KEYWORD),
+        ]
+        if [(p.name, p.kind) for p in present_params] == default_model_signature:
+            # if this is the standard model signature, use extra_data as the extra args name
+            var_kw_name = 'extra_data'
+        else:
+            # else start from var_kw
+            var_kw_name = var_kw.name
+
+        # generate a name that's definitely unique
+        while var_kw_name in fields:
+            var_kw_name += '_'
+        merged_params[var_kw_name] = var_kw.replace(name=var_kw_name)
+
+    return merged_params
+
+
+def generate_pydantic_signature(
+    init: Callable[..., None], fields: dict[str, FieldInfo], config_wrapper: ConfigWrapper, is_dataclass: bool = False
+) -> Signature:
+    """Generate signature for a pydantic BaseModel or dataclass.
+
+    Args:
+        init: The class init.
+        fields: The model fields.
+        config_wrapper: The config wrapper instance.
+        is_dataclass: Whether the model is a dataclass.
+
+    Returns:
+        The dataclass/BaseModel subclass signature.
+    """
+    merged_params = _generate_signature_parameters(init, fields, config_wrapper)
+
+    if is_dataclass:
+        merged_params = {k: _process_param_defaults(v) for k, v in merged_params.items()}
+
+    return Signature(parameters=list(merged_params.values()), return_annotation=None)
diff --git a/lib/pydantic/_internal/_std_types_schema.py b/lib/pydantic/_internal/_std_types_schema.py
new file mode 100644
index 00000000..c8523bf4
--- /dev/null
+++ b/lib/pydantic/_internal/_std_types_schema.py
@@ -0,0 +1,714 @@
+"""Logic for generating pydantic-core schemas for standard library types.
+
+Import of this module is deferred since it contains imports of many standard library modules.
+"""
+from __future__ import annotations as _annotations
+
+import collections
+import collections.abc
+import dataclasses
+import decimal
+import inspect
+import os
+import typing
+from enum import Enum
+from functools import partial
+from ipaddress import IPv4Address, IPv4Interface, IPv4Network, IPv6Address, IPv6Interface, IPv6Network
+from typing import Any, Callable, Iterable, TypeVar
+
+import typing_extensions
+from pydantic_core import (
+    CoreSchema,
+    MultiHostUrl,
+    PydanticCustomError,
+    PydanticOmit,
+    Url,
+    core_schema,
+)
+from typing_extensions import get_args, get_origin
+
+from pydantic.errors import PydanticSchemaGenerationError
+from pydantic.fields import FieldInfo
+from pydantic.types import Strict
+
+from ..config import ConfigDict
+from ..json_schema import JsonSchemaValue, update_json_schema
+from . import _known_annotated_metadata, _typing_extra, _validators
+from ._core_utils import get_type_ref
+from ._internal_dataclass import slots_true
+from ._schema_generation_shared import GetCoreSchemaHandler, GetJsonSchemaHandler
+
+if typing.TYPE_CHECKING:
+    from ._generate_schema import GenerateSchema
+
+    StdSchemaFunction = Callable[[GenerateSchema, type[Any]], core_schema.CoreSchema]
+
+
+@dataclasses.dataclass(**slots_true)
+class SchemaTransformer:
+    get_core_schema: Callable[[Any, GetCoreSchemaHandler], CoreSchema]
+    get_json_schema: Callable[[CoreSchema, GetJsonSchemaHandler], JsonSchemaValue]
+
+    def __get_pydantic_core_schema__(self, source_type: Any, handler: GetCoreSchemaHandler) -> CoreSchema:
+        return self.get_core_schema(source_type, handler)
+
+    def __get_pydantic_json_schema__(self, schema: CoreSchema, handler: GetJsonSchemaHandler) -> JsonSchemaValue:
+        return self.get_json_schema(schema, handler)
+
+
+def get_enum_core_schema(enum_type: type[Enum], config: ConfigDict) -> CoreSchema:
+    cases: list[Any] = list(enum_type.__members__.values())
+
+    enum_ref = get_type_ref(enum_type)
+    description = None if not enum_type.__doc__ else inspect.cleandoc(enum_type.__doc__)
+    if description == 'An enumeration.':  # This is the default value provided by enum.EnumMeta.__new__; don't use it
+        description = None
+    updates = {'title': enum_type.__name__, 'description': description}
+    updates = {k: v for k, v in updates.items() if v is not None}
+
+    def get_json_schema(_, handler: GetJsonSchemaHandler) -> JsonSchemaValue:
+        json_schema = handler(core_schema.literal_schema([x.value for x in cases], ref=enum_ref))
+        original_schema = handler.resolve_ref_schema(json_schema)
+        update_json_schema(original_schema, updates)
+        return json_schema
+
+    if not cases:
+        # Use an isinstance check for enums with no cases.
+        # The most important use case for this is creating TypeVar bounds for generics that should
+        # be restricted to enums. This is more consistent than it might seem at first, since you can only
+        # subclass enum.Enum (or subclasses of enum.Enum) if all parent classes have no cases.
+        # We use the get_json_schema function when an Enum subclass has been declared with no cases
+        # so that we can still generate a valid json schema.
+        return core_schema.is_instance_schema(enum_type, metadata={'pydantic_js_functions': [get_json_schema]})
+
+    use_enum_values = config.get('use_enum_values', False)
+
+    if len(cases) == 1:
+        expected = repr(cases[0].value)
+    else:
+        expected = ', '.join([repr(case.value) for case in cases[:-1]]) + f' or {cases[-1].value!r}'
+
+    def to_enum(__input_value: Any) -> Enum:
+        try:
+            enum_field = enum_type(__input_value)
+            if use_enum_values:
+                return enum_field.value
+            return enum_field
+        except ValueError:
+            # The type: ignore on the next line is to ignore the requirement of LiteralString
+            raise PydanticCustomError('enum', f'Input should be {expected}', {'expected': expected})  # type: ignore
+
+    strict_python_schema = core_schema.is_instance_schema(enum_type)
+    if use_enum_values:
+        strict_python_schema = core_schema.chain_schema(
+            [strict_python_schema, core_schema.no_info_plain_validator_function(lambda x: x.value)]
+        )
+
+    to_enum_validator = core_schema.no_info_plain_validator_function(to_enum)
+    if issubclass(enum_type, int):
+        # this handles `IntEnum`, and also `Foobar(int, Enum)`
+        updates['type'] = 'integer'
+        lax = core_schema.chain_schema([core_schema.int_schema(), to_enum_validator])
+        # Disallow float from JSON due to strict mode
+        strict = core_schema.json_or_python_schema(
+            json_schema=core_schema.no_info_after_validator_function(to_enum, core_schema.int_schema()),
+            python_schema=strict_python_schema,
+        )
+    elif issubclass(enum_type, str):
+        # this handles `StrEnum` (3.11 only), and also `Foobar(str, Enum)`
+        updates['type'] = 'string'
+        lax = core_schema.chain_schema([core_schema.str_schema(), to_enum_validator])
+        strict = core_schema.json_or_python_schema(
+            json_schema=core_schema.no_info_after_validator_function(to_enum, core_schema.str_schema()),
+            python_schema=strict_python_schema,
+        )
+    elif issubclass(enum_type, float):
+        updates['type'] = 'numeric'
+        lax = core_schema.chain_schema([core_schema.float_schema(), to_enum_validator])
+        strict = core_schema.json_or_python_schema(
+            json_schema=core_schema.no_info_after_validator_function(to_enum, core_schema.float_schema()),
+            python_schema=strict_python_schema,
+        )
+    else:
+        lax = to_enum_validator
+        strict = core_schema.json_or_python_schema(json_schema=to_enum_validator, python_schema=strict_python_schema)
+    return core_schema.lax_or_strict_schema(
+        lax_schema=lax, strict_schema=strict, ref=enum_ref, metadata={'pydantic_js_functions': [get_json_schema]}
+    )
+
+
+@dataclasses.dataclass(**slots_true)
+class InnerSchemaValidator:
+    """Use a fixed CoreSchema, avoiding interference from outward annotations."""
+
+    core_schema: CoreSchema
+    js_schema: JsonSchemaValue | None = None
+    js_core_schema: CoreSchema | None = None
+    js_schema_update: JsonSchemaValue | None = None
+
+    def __get_pydantic_json_schema__(self, _schema: CoreSchema, handler: GetJsonSchemaHandler) -> JsonSchemaValue:
+        if self.js_schema is not None:
+            return self.js_schema
+        js_schema = handler(self.js_core_schema or self.core_schema)
+        if self.js_schema_update is not None:
+            js_schema.update(self.js_schema_update)
+        return js_schema
+
+    def __get_pydantic_core_schema__(self, _source_type: Any, _handler: GetCoreSchemaHandler) -> CoreSchema:
+        return self.core_schema
+
+
+def decimal_prepare_pydantic_annotations(
+    source: Any, annotations: Iterable[Any], config: ConfigDict
+) -> tuple[Any, list[Any]] | None:
+    if source is not decimal.Decimal:
+        return None
+
+    metadata, remaining_annotations = _known_annotated_metadata.collect_known_metadata(annotations)
+
+    config_allow_inf_nan = config.get('allow_inf_nan')
+    if config_allow_inf_nan is not None:
+        metadata.setdefault('allow_inf_nan', config_allow_inf_nan)
+
+    _known_annotated_metadata.check_metadata(
+        metadata, {*_known_annotated_metadata.FLOAT_CONSTRAINTS, 'max_digits', 'decimal_places'}, decimal.Decimal
+    )
+    return source, [InnerSchemaValidator(core_schema.decimal_schema(**metadata)), *remaining_annotations]
+
+
+def datetime_prepare_pydantic_annotations(
+    source_type: Any, annotations: Iterable[Any], _config: ConfigDict
+) -> tuple[Any, list[Any]] | None:
+    import datetime
+
+    metadata, remaining_annotations = _known_annotated_metadata.collect_known_metadata(annotations)
+    if source_type is datetime.date:
+        sv = InnerSchemaValidator(core_schema.date_schema(**metadata))
+    elif source_type is datetime.datetime:
+        sv = InnerSchemaValidator(core_schema.datetime_schema(**metadata))
+    elif source_type is datetime.time:
+        sv = InnerSchemaValidator(core_schema.time_schema(**metadata))
+    elif source_type is datetime.timedelta:
+        sv = InnerSchemaValidator(core_schema.timedelta_schema(**metadata))
+    else:
+        return None
+    # check now that we know the source type is correct
+    _known_annotated_metadata.check_metadata(metadata, _known_annotated_metadata.DATE_TIME_CONSTRAINTS, source_type)
+    return (source_type, [sv, *remaining_annotations])
+
+
+def uuid_prepare_pydantic_annotations(
+    source_type: Any, annotations: Iterable[Any], _config: ConfigDict
+) -> tuple[Any, list[Any]] | None:
+    # UUIDs have no constraints - they are fixed length, constructing a UUID instance checks the length
+
+    from uuid import UUID
+
+    if source_type is not UUID:
+        return None
+
+    return (source_type, [InnerSchemaValidator(core_schema.uuid_schema()), *annotations])
+
+
+def path_schema_prepare_pydantic_annotations(
+    source_type: Any, annotations: Iterable[Any], _config: ConfigDict
+) -> tuple[Any, list[Any]] | None:
+    import pathlib
+
+    if source_type not in {
+        os.PathLike,
+        pathlib.Path,
+        pathlib.PurePath,
+        pathlib.PosixPath,
+        pathlib.PurePosixPath,
+        pathlib.PureWindowsPath,
+    }:
+        return None
+
+    metadata, remaining_annotations = _known_annotated_metadata.collect_known_metadata(annotations)
+    _known_annotated_metadata.check_metadata(metadata, _known_annotated_metadata.STR_CONSTRAINTS, source_type)
+
+    construct_path = pathlib.PurePath if source_type is os.PathLike else source_type
+
+    def path_validator(input_value: str) -> os.PathLike[Any]:
+        try:
+            return construct_path(input_value)
+        except TypeError as e:
+            raise PydanticCustomError('path_type', 'Input is not a valid path') from e
+
+    constrained_str_schema = core_schema.str_schema(**metadata)
+
+    instance_schema = core_schema.json_or_python_schema(
+        json_schema=core_schema.no_info_after_validator_function(path_validator, constrained_str_schema),
+        python_schema=core_schema.is_instance_schema(source_type),
+    )
+
+    strict: bool | None = None
+    for annotation in annotations:
+        if isinstance(annotation, Strict):
+            strict = annotation.strict
+
+    schema = core_schema.lax_or_strict_schema(
+        lax_schema=core_schema.union_schema(
+            [
+                instance_schema,
+                core_schema.no_info_after_validator_function(path_validator, constrained_str_schema),
+            ],
+            custom_error_type='path_type',
+            custom_error_message='Input is not a valid path',
+            strict=True,
+        ),
+        strict_schema=instance_schema,
+        serialization=core_schema.to_string_ser_schema(),
+        strict=strict,
+    )
+
+    return (
+        source_type,
+        [
+            InnerSchemaValidator(schema, js_core_schema=constrained_str_schema, js_schema_update={'format': 'path'}),
+            *remaining_annotations,
+        ],
+    )
+
+
+def dequeue_validator(
+    input_value: Any, handler: core_schema.ValidatorFunctionWrapHandler, maxlen: None | int
+) -> collections.deque[Any]:
+    if isinstance(input_value, collections.deque):
+        maxlens = [v for v in (input_value.maxlen, maxlen) if v is not None]
+        if maxlens:
+            maxlen = min(maxlens)
+        return collections.deque(handler(input_value), maxlen=maxlen)
+    else:
+        return collections.deque(handler(input_value), maxlen=maxlen)
+
+
+@dataclasses.dataclass(**slots_true)
+class SequenceValidator:
+    mapped_origin: type[Any]
+    item_source_type: type[Any]
+    min_length: int | None = None
+    max_length: int | None = None
+    strict: bool = False
+
+    def serialize_sequence_via_list(
+        self, v: Any, handler: core_schema.SerializerFunctionWrapHandler, info: core_schema.SerializationInfo
+    ) -> Any:
+        items: list[Any] = []
+        for index, item in enumerate(v):
+            try:
+                v = handler(item, index)
+            except PydanticOmit:
+                pass
+            else:
+                items.append(v)
+
+        if info.mode_is_json():
+            return items
+        else:
+            return self.mapped_origin(items)
+
+    def __get_pydantic_core_schema__(self, source_type: Any, handler: GetCoreSchemaHandler) -> CoreSchema:
+        if self.item_source_type is Any:
+            items_schema = None
+        else:
+            items_schema = handler.generate_schema(self.item_source_type)
+
+        metadata = {'min_length': self.min_length, 'max_length': self.max_length, 'strict': self.strict}
+
+        if self.mapped_origin in (list, set, frozenset):
+            if self.mapped_origin is list:
+                constrained_schema = core_schema.list_schema(items_schema, **metadata)
+            elif self.mapped_origin is set:
+                constrained_schema = core_schema.set_schema(items_schema, **metadata)
+            else:
+                assert self.mapped_origin is frozenset  # safety check in case we forget to add a case
+                constrained_schema = core_schema.frozenset_schema(items_schema, **metadata)
+
+            schema = constrained_schema
+        else:
+            # safety check in case we forget to add a case
+            assert self.mapped_origin in (collections.deque, collections.Counter)
+
+            if self.mapped_origin is collections.deque:
+                # if we have a MaxLen annotation might as well set that as the default maxlen on the deque
+                # this lets us re-use existing metadata annotations to let users set the maxlen on a dequeue
+                # that e.g. comes from JSON
+                coerce_instance_wrap = partial(
+                    core_schema.no_info_wrap_validator_function,
+                    partial(dequeue_validator, maxlen=metadata.get('max_length', None)),
+                )
+            else:
+                coerce_instance_wrap = partial(core_schema.no_info_after_validator_function, self.mapped_origin)
+
+            constrained_schema = core_schema.list_schema(items_schema, **metadata)
+
+            check_instance = core_schema.json_or_python_schema(
+                json_schema=core_schema.list_schema(),
+                python_schema=core_schema.is_instance_schema(self.mapped_origin),
+            )
+
+            serialization = core_schema.wrap_serializer_function_ser_schema(
+                self.serialize_sequence_via_list, schema=items_schema or core_schema.any_schema(), info_arg=True
+            )
+
+            strict = core_schema.chain_schema([check_instance, coerce_instance_wrap(constrained_schema)])
+
+            if metadata.get('strict', False):
+                schema = strict
+            else:
+                lax = coerce_instance_wrap(constrained_schema)
+                schema = core_schema.lax_or_strict_schema(lax_schema=lax, strict_schema=strict)
+            schema['serialization'] = serialization
+
+        return schema
+
+
+SEQUENCE_ORIGIN_MAP: dict[Any, Any] = {
+    typing.Deque: collections.deque,
+    collections.deque: collections.deque,
+    list: list,
+    typing.List: list,
+    set: set,
+    typing.AbstractSet: set,
+    typing.Set: set,
+    frozenset: frozenset,
+    typing.FrozenSet: frozenset,
+    typing.Sequence: list,
+    typing.MutableSequence: list,
+    typing.MutableSet: set,
+    # this doesn't handle subclasses of these
+    # parametrized typing.Set creates one of these
+    collections.abc.MutableSet: set,
+    collections.abc.Set: frozenset,
+}
+
+
+def identity(s: CoreSchema) -> CoreSchema:
+    return s
+
+
+def sequence_like_prepare_pydantic_annotations(
+    source_type: Any, annotations: Iterable[Any], _config: ConfigDict
+) -> tuple[Any, list[Any]] | None:
+    origin: Any = get_origin(source_type)
+
+    mapped_origin = SEQUENCE_ORIGIN_MAP.get(origin, None) if origin else SEQUENCE_ORIGIN_MAP.get(source_type, None)
+    if mapped_origin is None:
+        return None
+
+    args = get_args(source_type)
+
+    if not args:
+        args = (Any,)
+    elif len(args) != 1:
+        raise ValueError('Expected sequence to have exactly 1 generic parameter')
+
+    item_source_type = args[0]
+
+    metadata, remaining_annotations = _known_annotated_metadata.collect_known_metadata(annotations)
+    _known_annotated_metadata.check_metadata(metadata, _known_annotated_metadata.SEQUENCE_CONSTRAINTS, source_type)
+
+    return (source_type, [SequenceValidator(mapped_origin, item_source_type, **metadata), *remaining_annotations])
+
+
+MAPPING_ORIGIN_MAP: dict[Any, Any] = {
+    typing.DefaultDict: collections.defaultdict,
+    collections.defaultdict: collections.defaultdict,
+    collections.OrderedDict: collections.OrderedDict,
+    typing_extensions.OrderedDict: collections.OrderedDict,
+    dict: dict,
+    typing.Dict: dict,
+    collections.Counter: collections.Counter,
+    typing.Counter: collections.Counter,
+    # this doesn't handle subclasses of these
+    typing.Mapping: dict,
+    typing.MutableMapping: dict,
+    # parametrized typing.{Mutable}Mapping creates one of these
+    collections.abc.MutableMapping: dict,
+    collections.abc.Mapping: dict,
+}
+
+
+def defaultdict_validator(
+    input_value: Any, handler: core_schema.ValidatorFunctionWrapHandler, default_default_factory: Callable[[], Any]
+) -> collections.defaultdict[Any, Any]:
+    if isinstance(input_value, collections.defaultdict):
+        default_factory = input_value.default_factory
+        return collections.defaultdict(default_factory, handler(input_value))
+    else:
+        return collections.defaultdict(default_default_factory, handler(input_value))
+
+
+def get_defaultdict_default_default_factory(values_source_type: Any) -> Callable[[], Any]:
+    def infer_default() -> Callable[[], Any]:
+        allowed_default_types: dict[Any, Any] = {
+            typing.Tuple: tuple,
+            tuple: tuple,
+            collections.abc.Sequence: tuple,
+            collections.abc.MutableSequence: list,
+            typing.List: list,
+            list: list,
+            typing.Sequence: list,
+            typing.Set: set,
+            set: set,
+            typing.MutableSet: set,
+            collections.abc.MutableSet: set,
+            collections.abc.Set: frozenset,
+            typing.MutableMapping: dict,
+            typing.Mapping: dict,
+            collections.abc.Mapping: dict,
+            collections.abc.MutableMapping: dict,
+            float: float,
+            int: int,
+            str: str,
+            bool: bool,
+        }
+        values_type_origin = get_origin(values_source_type) or values_source_type
+        instructions = 'set using `DefaultDict[..., Annotated[..., Field(default_factory=...)]]`'
+        if isinstance(values_type_origin, TypeVar):
+
+            def type_var_default_factory() -> None:
+                raise RuntimeError(
+                    'Generic defaultdict cannot be used without a concrete value type or an'
+                    ' explicit default factory, ' + instructions
+                )
+
+            return type_var_default_factory
+        elif values_type_origin not in allowed_default_types:
+            # a somewhat subjective set of types that have reasonable default values
+            allowed_msg = ', '.join([t.__name__ for t in set(allowed_default_types.values())])
+            raise PydanticSchemaGenerationError(
+                f'Unable to infer a default factory for keys of type {values_source_type}.'
+                f' Only {allowed_msg} are supported, other types require an explicit default factory'
+                ' ' + instructions
+            )
+        return allowed_default_types[values_type_origin]
+
+    # Assume Annotated[..., Field(...)]
+    if _typing_extra.is_annotated(values_source_type):
+        field_info = next((v for v in get_args(values_source_type) if isinstance(v, FieldInfo)), None)
+    else:
+        field_info = None
+    if field_info and field_info.default_factory:
+        default_default_factory = field_info.default_factory
+    else:
+        default_default_factory = infer_default()
+    return default_default_factory
+
+
+@dataclasses.dataclass(**slots_true)
+class MappingValidator:
+    mapped_origin: type[Any]
+    keys_source_type: type[Any]
+    values_source_type: type[Any]
+    min_length: int | None = None
+    max_length: int | None = None
+    strict: bool = False
+
+    def serialize_mapping_via_dict(self, v: Any, handler: core_schema.SerializerFunctionWrapHandler) -> Any:
+        return handler(v)
+
+    def __get_pydantic_core_schema__(self, source_type: Any, handler: GetCoreSchemaHandler) -> CoreSchema:
+        if self.keys_source_type is Any:
+            keys_schema = None
+        else:
+            keys_schema = handler.generate_schema(self.keys_source_type)
+        if self.values_source_type is Any:
+            values_schema = None
+        else:
+            values_schema = handler.generate_schema(self.values_source_type)
+
+        metadata = {'min_length': self.min_length, 'max_length': self.max_length, 'strict': self.strict}
+
+        if self.mapped_origin is dict:
+            schema = core_schema.dict_schema(keys_schema, values_schema, **metadata)
+        else:
+            constrained_schema = core_schema.dict_schema(keys_schema, values_schema, **metadata)
+            check_instance = core_schema.json_or_python_schema(
+                json_schema=core_schema.dict_schema(),
+                python_schema=core_schema.is_instance_schema(self.mapped_origin),
+            )
+
+            if self.mapped_origin is collections.defaultdict:
+                default_default_factory = get_defaultdict_default_default_factory(self.values_source_type)
+                coerce_instance_wrap = partial(
+                    core_schema.no_info_wrap_validator_function,
+                    partial(defaultdict_validator, default_default_factory=default_default_factory),
+                )
+            else:
+                coerce_instance_wrap = partial(core_schema.no_info_after_validator_function, self.mapped_origin)
+
+            serialization = core_schema.wrap_serializer_function_ser_schema(
+                self.serialize_mapping_via_dict,
+                schema=core_schema.dict_schema(
+                    keys_schema or core_schema.any_schema(), values_schema or core_schema.any_schema()
+                ),
+                info_arg=False,
+            )
+
+            strict = core_schema.chain_schema([check_instance, coerce_instance_wrap(constrained_schema)])
+
+            if metadata.get('strict', False):
+                schema = strict
+            else:
+                lax = coerce_instance_wrap(constrained_schema)
+                schema = core_schema.lax_or_strict_schema(lax_schema=lax, strict_schema=strict)
+                schema['serialization'] = serialization
+
+        return schema
+
+
+def mapping_like_prepare_pydantic_annotations(
+    source_type: Any, annotations: Iterable[Any], _config: ConfigDict
+) -> tuple[Any, list[Any]] | None:
+    origin: Any = get_origin(source_type)
+
+    mapped_origin = MAPPING_ORIGIN_MAP.get(origin, None) if origin else MAPPING_ORIGIN_MAP.get(source_type, None)
+    if mapped_origin is None:
+        return None
+
+    args = get_args(source_type)
+
+    if not args:
+        args = (Any, Any)
+    elif mapped_origin is collections.Counter:
+        # a single generic
+        if len(args) != 1:
+            raise ValueError('Expected Counter to have exactly 1 generic parameter')
+        args = (args[0], int)  # keys are always an int
+    elif len(args) != 2:
+        raise ValueError('Expected mapping to have exactly 2 generic parameters')
+
+    keys_source_type, values_source_type = args
+
+    metadata, remaining_annotations = _known_annotated_metadata.collect_known_metadata(annotations)
+    _known_annotated_metadata.check_metadata(metadata, _known_annotated_metadata.SEQUENCE_CONSTRAINTS, source_type)
+
+    return (
+        source_type,
+        [
+            MappingValidator(mapped_origin, keys_source_type, values_source_type, **metadata),
+            *remaining_annotations,
+        ],
+    )
+
+
+def ip_prepare_pydantic_annotations(
+    source_type: Any, annotations: Iterable[Any], _config: ConfigDict
+) -> tuple[Any, list[Any]] | None:
+    def make_strict_ip_schema(tp: type[Any]) -> CoreSchema:
+        return core_schema.json_or_python_schema(
+            json_schema=core_schema.no_info_after_validator_function(tp, core_schema.str_schema()),
+            python_schema=core_schema.is_instance_schema(tp),
+        )
+
+    if source_type is IPv4Address:
+        return source_type, [
+            SchemaTransformer(
+                lambda _1, _2: core_schema.lax_or_strict_schema(
+                    lax_schema=core_schema.no_info_plain_validator_function(_validators.ip_v4_address_validator),
+                    strict_schema=make_strict_ip_schema(IPv4Address),
+                    serialization=core_schema.to_string_ser_schema(),
+                ),
+                lambda _1, _2: {'type': 'string', 'format': 'ipv4'},
+            ),
+            *annotations,
+        ]
+    if source_type is IPv4Network:
+        return source_type, [
+            SchemaTransformer(
+                lambda _1, _2: core_schema.lax_or_strict_schema(
+                    lax_schema=core_schema.no_info_plain_validator_function(_validators.ip_v4_network_validator),
+                    strict_schema=make_strict_ip_schema(IPv4Network),
+                    serialization=core_schema.to_string_ser_schema(),
+                ),
+                lambda _1, _2: {'type': 'string', 'format': 'ipv4network'},
+            ),
+            *annotations,
+        ]
+    if source_type is IPv4Interface:
+        return source_type, [
+            SchemaTransformer(
+                lambda _1, _2: core_schema.lax_or_strict_schema(
+                    lax_schema=core_schema.no_info_plain_validator_function(_validators.ip_v4_interface_validator),
+                    strict_schema=make_strict_ip_schema(IPv4Interface),
+                    serialization=core_schema.to_string_ser_schema(),
+                ),
+                lambda _1, _2: {'type': 'string', 'format': 'ipv4interface'},
+            ),
+            *annotations,
+        ]
+
+    if source_type is IPv6Address:
+        return source_type, [
+            SchemaTransformer(
+                lambda _1, _2: core_schema.lax_or_strict_schema(
+                    lax_schema=core_schema.no_info_plain_validator_function(_validators.ip_v6_address_validator),
+                    strict_schema=make_strict_ip_schema(IPv6Address),
+                    serialization=core_schema.to_string_ser_schema(),
+                ),
+                lambda _1, _2: {'type': 'string', 'format': 'ipv6'},
+            ),
+            *annotations,
+        ]
+    if source_type is IPv6Network:
+        return source_type, [
+            SchemaTransformer(
+                lambda _1, _2: core_schema.lax_or_strict_schema(
+                    lax_schema=core_schema.no_info_plain_validator_function(_validators.ip_v6_network_validator),
+                    strict_schema=make_strict_ip_schema(IPv6Network),
+                    serialization=core_schema.to_string_ser_schema(),
+                ),
+                lambda _1, _2: {'type': 'string', 'format': 'ipv6network'},
+            ),
+            *annotations,
+        ]
+    if source_type is IPv6Interface:
+        return source_type, [
+            SchemaTransformer(
+                lambda _1, _2: core_schema.lax_or_strict_schema(
+                    lax_schema=core_schema.no_info_plain_validator_function(_validators.ip_v6_interface_validator),
+                    strict_schema=make_strict_ip_schema(IPv6Interface),
+                    serialization=core_schema.to_string_ser_schema(),
+                ),
+                lambda _1, _2: {'type': 'string', 'format': 'ipv6interface'},
+            ),
+            *annotations,
+        ]
+
+    return None
+
+
+def url_prepare_pydantic_annotations(
+    source_type: Any, annotations: Iterable[Any], _config: ConfigDict
+) -> tuple[Any, list[Any]] | None:
+    if source_type is Url:
+        return source_type, [
+            SchemaTransformer(
+                lambda _1, _2: core_schema.url_schema(),
+                lambda cs, handler: handler(cs),
+            ),
+            *annotations,
+        ]
+    if source_type is MultiHostUrl:
+        return source_type, [
+            SchemaTransformer(
+                lambda _1, _2: core_schema.multi_host_url_schema(),
+                lambda cs, handler: handler(cs),
+            ),
+            *annotations,
+        ]
+
+
+PREPARE_METHODS: tuple[Callable[[Any, Iterable[Any], ConfigDict], tuple[Any, list[Any]] | None], ...] = (
+    decimal_prepare_pydantic_annotations,
+    sequence_like_prepare_pydantic_annotations,
+    datetime_prepare_pydantic_annotations,
+    uuid_prepare_pydantic_annotations,
+    path_schema_prepare_pydantic_annotations,
+    mapping_like_prepare_pydantic_annotations,
+    ip_prepare_pydantic_annotations,
+    url_prepare_pydantic_annotations,
+)
diff --git a/lib/pydantic/_internal/_typing_extra.py b/lib/pydantic/_internal/_typing_extra.py
new file mode 100644
index 00000000..1d5d3b3f
--- /dev/null
+++ b/lib/pydantic/_internal/_typing_extra.py
@@ -0,0 +1,469 @@
+"""Logic for interacting with type annotations, mostly extensions, shims and hacks to wrap python's typing module."""
+from __future__ import annotations as _annotations
+
+import dataclasses
+import sys
+import types
+import typing
+from collections.abc import Callable
+from functools import partial
+from types import GetSetDescriptorType
+from typing import TYPE_CHECKING, Any, Final
+
+from typing_extensions import Annotated, Literal, TypeAliasType, TypeGuard, get_args, get_origin
+
+if TYPE_CHECKING:
+    from ._dataclasses import StandardDataclass
+
+try:
+    from typing import _TypingBase  # type: ignore[attr-defined]
+except ImportError:
+    from typing import _Final as _TypingBase  # type: ignore[attr-defined]
+
+typing_base = _TypingBase
+
+
+if sys.version_info < (3, 9):
+    # python < 3.9 does not have GenericAlias (list[int], tuple[str, ...] and so on)
+    TypingGenericAlias = ()
+else:
+    from typing import GenericAlias as TypingGenericAlias  # type: ignore
+
+
+if sys.version_info < (3, 11):
+    from typing_extensions import NotRequired, Required
+else:
+    from typing import NotRequired, Required  # noqa: F401
+
+
+if sys.version_info < (3, 10):
+
+    def origin_is_union(tp: type[Any] | None) -> bool:
+        return tp is typing.Union
+
+    WithArgsTypes = (TypingGenericAlias,)
+
+else:
+
+    def origin_is_union(tp: type[Any] | None) -> bool:
+        return tp is typing.Union or tp is types.UnionType
+
+    WithArgsTypes = typing._GenericAlias, types.GenericAlias, types.UnionType  # type: ignore[attr-defined]
+
+
+if sys.version_info < (3, 10):
+    NoneType = type(None)
+    EllipsisType = type(Ellipsis)
+else:
+    from types import NoneType as NoneType
+
+
+LITERAL_TYPES: set[Any] = {Literal}
+if hasattr(typing, 'Literal'):
+    LITERAL_TYPES.add(typing.Literal)  # type: ignore
+
+NONE_TYPES: tuple[Any, ...] = (None, NoneType, *(tp[None] for tp in LITERAL_TYPES))
+
+
+TypeVarType = Any  # since mypy doesn't allow the use of TypeVar as a type
+
+
+def is_none_type(type_: Any) -> bool:
+    return type_ in NONE_TYPES
+
+
+def is_callable_type(type_: type[Any]) -> bool:
+    return type_ is Callable or get_origin(type_) is Callable
+
+
+def is_literal_type(type_: type[Any]) -> bool:
+    return Literal is not None and get_origin(type_) in LITERAL_TYPES
+
+
+def literal_values(type_: type[Any]) -> tuple[Any, ...]:
+    return get_args(type_)
+
+
+def all_literal_values(type_: type[Any]) -> list[Any]:
+    """This method is used to retrieve all Literal values as
+    Literal can be used recursively (see https://www.python.org/dev/peps/pep-0586)
+    e.g. `Literal[Literal[Literal[1, 2, 3], "foo"], 5, None]`.
+    """
+    if not is_literal_type(type_):
+        return [type_]
+
+    values = literal_values(type_)
+    return list(x for value in values for x in all_literal_values(value))
+
+
+def is_annotated(ann_type: Any) -> bool:
+    from ._utils import lenient_issubclass
+
+    origin = get_origin(ann_type)
+    return origin is not None and lenient_issubclass(origin, Annotated)
+
+
+def is_namedtuple(type_: type[Any]) -> bool:
+    """Check if a given class is a named tuple.
+    It can be either a `typing.NamedTuple` or `collections.namedtuple`.
+    """
+    from ._utils import lenient_issubclass
+
+    return lenient_issubclass(type_, tuple) and hasattr(type_, '_fields')
+
+
+test_new_type = typing.NewType('test_new_type', str)
+
+
+def is_new_type(type_: type[Any]) -> bool:
+    """Check whether type_ was created using typing.NewType.
+
+    Can't use isinstance because it fails <3.10.
+    """
+    return isinstance(type_, test_new_type.__class__) and hasattr(type_, '__supertype__')  # type: ignore[arg-type]
+
+
+def _check_classvar(v: type[Any] | None) -> bool:
+    if v is None:
+        return False
+
+    return v.__class__ == typing.ClassVar.__class__ and getattr(v, '_name', None) == 'ClassVar'
+
+
+def is_classvar(ann_type: type[Any]) -> bool:
+    if _check_classvar(ann_type) or _check_classvar(get_origin(ann_type)):
+        return True
+
+    # this is an ugly workaround for class vars that contain forward references and are therefore themselves
+    # forward references, see #3679
+    if ann_type.__class__ == typing.ForwardRef and ann_type.__forward_arg__.startswith('ClassVar['):  # type: ignore
+        return True
+
+    return False
+
+
+def _check_finalvar(v: type[Any] | None) -> bool:
+    """Check if a given type is a `typing.Final` type."""
+    if v is None:
+        return False
+
+    return v.__class__ == Final.__class__ and (sys.version_info < (3, 8) or getattr(v, '_name', None) == 'Final')
+
+
+def is_finalvar(ann_type: Any) -> bool:
+    return _check_finalvar(ann_type) or _check_finalvar(get_origin(ann_type))
+
+
+def parent_frame_namespace(*, parent_depth: int = 2) -> dict[str, Any] | None:
+    """We allow use of items in parent namespace to get around the issue with `get_type_hints` only looking in the
+    global module namespace. See https://github.com/pydantic/pydantic/issues/2678#issuecomment-1008139014 -> Scope
+    and suggestion at the end of the next comment by @gvanrossum.
+
+    WARNING 1: it matters exactly where this is called. By default, this function will build a namespace from the
+    parent of where it is called.
+
+    WARNING 2: this only looks in the parent namespace, not other parents since (AFAIK) there's no way to collect a
+    dict of exactly what's in scope. Using `f_back` would work sometimes but would be very wrong and confusing in many
+    other cases. See https://discuss.python.org/t/is-there-a-way-to-access-parent-nested-namespaces/20659.
+    """
+    frame = sys._getframe(parent_depth)
+    # if f_back is None, it's the global module namespace and we don't need to include it here
+    if frame.f_back is None:
+        return None
+    else:
+        return frame.f_locals
+
+
+def add_module_globals(obj: Any, globalns: dict[str, Any] | None = None) -> dict[str, Any]:
+    module_name = getattr(obj, '__module__', None)
+    if module_name:
+        try:
+            module_globalns = sys.modules[module_name].__dict__
+        except KeyError:
+            # happens occasionally, see https://github.com/pydantic/pydantic/issues/2363
+            pass
+        else:
+            if globalns:
+                return {**module_globalns, **globalns}
+            else:
+                # copy module globals to make sure it can't be updated later
+                return module_globalns.copy()
+
+    return globalns or {}
+
+
+def get_cls_types_namespace(cls: type[Any], parent_namespace: dict[str, Any] | None = None) -> dict[str, Any]:
+    ns = add_module_globals(cls, parent_namespace)
+    ns[cls.__name__] = cls
+    return ns
+
+
+def get_cls_type_hints_lenient(obj: Any, globalns: dict[str, Any] | None = None) -> dict[str, Any]:
+    """Collect annotations from a class, including those from parent classes.
+
+    Unlike `typing.get_type_hints`, this function will not error if a forward reference is not resolvable.
+    """
+    hints = {}
+    for base in reversed(obj.__mro__):
+        ann = base.__dict__.get('__annotations__')
+        localns = dict(vars(base))
+        if ann is not None and ann is not GetSetDescriptorType:
+            for name, value in ann.items():
+                hints[name] = eval_type_lenient(value, globalns, localns)
+    return hints
+
+
+def eval_type_lenient(value: Any, globalns: dict[str, Any] | None = None, localns: dict[str, Any] | None = None) -> Any:
+    """Behaves like typing._eval_type, except it won't raise an error if a forward reference can't be resolved."""
+    if value is None:
+        value = NoneType
+    elif isinstance(value, str):
+        value = _make_forward_ref(value, is_argument=False, is_class=True)
+
+    try:
+        return eval_type_backport(value, globalns, localns)
+    except NameError:
+        # the point of this function is to be tolerant to this case
+        return value
+
+
+def eval_type_backport(
+    value: Any, globalns: dict[str, Any] | None = None, localns: dict[str, Any] | None = None
+) -> Any:
+    """Like `typing._eval_type`, but falls back to the `eval_type_backport` package if it's
+    installed to let older Python versions use newer typing features.
+    Specifically, this transforms `X | Y` into `typing.Union[X, Y]`
+    and `list[X]` into `typing.List[X]` etc. (for all the types made generic in PEP 585)
+    if the original syntax is not supported in the current Python version.
+    """
+    try:
+        return typing._eval_type(  # type: ignore
+            value, globalns, localns
+        )
+    except TypeError as e:
+        if not (isinstance(value, typing.ForwardRef) and is_backport_fixable_error(e)):
+            raise
+        try:
+            from eval_type_backport import eval_type_backport
+        except ImportError:
+            raise TypeError(
+                f'You have a type annotation {value.__forward_arg__!r} '
+                f'which makes use of newer typing features than are supported in your version of Python. '
+                f'To handle this error, you should either remove the use of new syntax '
+                f'or install the `eval_type_backport` package.'
+            ) from e
+
+        return eval_type_backport(value, globalns, localns, try_default=False)
+
+
+def is_backport_fixable_error(e: TypeError) -> bool:
+    msg = str(e)
+    return msg.startswith('unsupported operand type(s) for |: ') or "' object is not subscriptable" in msg
+
+
+def get_function_type_hints(
+    function: Callable[..., Any], *, include_keys: set[str] | None = None, types_namespace: dict[str, Any] | None = None
+) -> dict[str, Any]:
+    """Like `typing.get_type_hints`, but doesn't convert `X` to `Optional[X]` if the default value is `None`, also
+    copes with `partial`.
+    """
+    if isinstance(function, partial):
+        annotations = function.func.__annotations__
+    else:
+        annotations = function.__annotations__
+
+    globalns = add_module_globals(function)
+    type_hints = {}
+    for name, value in annotations.items():
+        if include_keys is not None and name not in include_keys:
+            continue
+        if value is None:
+            value = NoneType
+        elif isinstance(value, str):
+            value = _make_forward_ref(value)
+
+        type_hints[name] = eval_type_backport(value, globalns, types_namespace)
+
+    return type_hints
+
+
+if sys.version_info < (3, 9, 8) or (3, 10) <= sys.version_info < (3, 10, 1):
+
+    def _make_forward_ref(
+        arg: Any,
+        is_argument: bool = True,
+        *,
+        is_class: bool = False,
+    ) -> typing.ForwardRef:
+        """Wrapper for ForwardRef that accounts for the `is_class` argument missing in older versions.
+        The `module` argument is omitted as it breaks <3.9.8, =3.10.0 and isn't used in the calls below.
+
+        See https://github.com/python/cpython/pull/28560 for some background.
+        The backport happened on 3.9.8, see:
+        https://github.com/pydantic/pydantic/discussions/6244#discussioncomment-6275458,
+        and on 3.10.1 for the 3.10 branch, see:
+        https://github.com/pydantic/pydantic/issues/6912
+
+        Implemented as EAFP with memory.
+        """
+        return typing.ForwardRef(arg, is_argument)
+
+else:
+    _make_forward_ref = typing.ForwardRef
+
+
+if sys.version_info >= (3, 10):
+    get_type_hints = typing.get_type_hints
+
+else:
+    """
+    For older versions of python, we have a custom implementation of `get_type_hints` which is a close as possible to
+    the implementation in CPython 3.10.8.
+    """
+
+    @typing.no_type_check
+    def get_type_hints(  # noqa: C901
+        obj: Any,
+        globalns: dict[str, Any] | None = None,
+        localns: dict[str, Any] | None = None,
+        include_extras: bool = False,
+    ) -> dict[str, Any]:  # pragma: no cover
+        """Taken verbatim from python 3.10.8 unchanged, except:
+        * type annotations of the function definition above.
+        * prefixing `typing.` where appropriate
+        * Use `_make_forward_ref` instead of `typing.ForwardRef` to handle the `is_class` argument.
+
+        https://github.com/python/cpython/blob/aaaf5174241496afca7ce4d4584570190ff972fe/Lib/typing.py#L1773-L1875
+
+        DO NOT CHANGE THIS METHOD UNLESS ABSOLUTELY NECESSARY.
+        ======================================================
+
+        Return type hints for an object.
+
+        This is often the same as obj.__annotations__, but it handles
+        forward references encoded as string literals, adds Optional[t] if a
+        default value equal to None is set and recursively replaces all
+        'Annotated[T, ...]' with 'T' (unless 'include_extras=True').
+
+        The argument may be a module, class, method, or function. The annotations
+        are returned as a dictionary. For classes, annotations include also
+        inherited members.
+
+        TypeError is raised if the argument is not of a type that can contain
+        annotations, and an empty dictionary is returned if no annotations are
+        present.
+
+        BEWARE -- the behavior of globalns and localns is counterintuitive
+        (unless you are familiar with how eval() and exec() work).  The
+        search order is locals first, then globals.
+
+        - If no dict arguments are passed, an attempt is made to use the
+          globals from obj (or the respective module's globals for classes),
+          and these are also used as the locals.  If the object does not appear
+          to have globals, an empty dictionary is used.  For classes, the search
+          order is globals first then locals.
+
+        - If one dict argument is passed, it is used for both globals and
+          locals.
+
+        - If two dict arguments are passed, they specify globals and
+          locals, respectively.
+        """
+        if getattr(obj, '__no_type_check__', None):
+            return {}
+        # Classes require a special treatment.
+        if isinstance(obj, type):
+            hints = {}
+            for base in reversed(obj.__mro__):
+                if globalns is None:
+                    base_globals = getattr(sys.modules.get(base.__module__, None), '__dict__', {})
+                else:
+                    base_globals = globalns
+                ann = base.__dict__.get('__annotations__', {})
+                if isinstance(ann, types.GetSetDescriptorType):
+                    ann = {}
+                base_locals = dict(vars(base)) if localns is None else localns
+                if localns is None and globalns is None:
+                    # This is surprising, but required.  Before Python 3.10,
+                    # get_type_hints only evaluated the globalns of
+                    # a class.  To maintain backwards compatibility, we reverse
+                    # the globalns and localns order so that eval() looks into
+                    # *base_globals* first rather than *base_locals*.
+                    # This only affects ForwardRefs.
+                    base_globals, base_locals = base_locals, base_globals
+                for name, value in ann.items():
+                    if value is None:
+                        value = type(None)
+                    if isinstance(value, str):
+                        value = _make_forward_ref(value, is_argument=False, is_class=True)
+
+                    value = eval_type_backport(value, base_globals, base_locals)
+                    hints[name] = value
+            if not include_extras and hasattr(typing, '_strip_annotations'):
+                return {
+                    k: typing._strip_annotations(t)  # type: ignore
+                    for k, t in hints.items()
+                }
+            else:
+                return hints
+
+        if globalns is None:
+            if isinstance(obj, types.ModuleType):
+                globalns = obj.__dict__
+            else:
+                nsobj = obj
+                # Find globalns for the unwrapped object.
+                while hasattr(nsobj, '__wrapped__'):
+                    nsobj = nsobj.__wrapped__
+                globalns = getattr(nsobj, '__globals__', {})
+            if localns is None:
+                localns = globalns
+        elif localns is None:
+            localns = globalns
+        hints = getattr(obj, '__annotations__', None)
+        if hints is None:
+            # Return empty annotations for something that _could_ have them.
+            if isinstance(obj, typing._allowed_types):  # type: ignore
+                return {}
+            else:
+                raise TypeError(f'{obj!r} is not a module, class, method, ' 'or function.')
+        defaults = typing._get_defaults(obj)  # type: ignore
+        hints = dict(hints)
+        for name, value in hints.items():
+            if value is None:
+                value = type(None)
+            if isinstance(value, str):
+                # class-level forward refs were handled above, this must be either
+                # a module-level annotation or a function argument annotation
+
+                value = _make_forward_ref(
+                    value,
+                    is_argument=not isinstance(obj, types.ModuleType),
+                    is_class=False,
+                )
+            value = eval_type_backport(value, globalns, localns)
+            if name in defaults and defaults[name] is None:
+                value = typing.Optional[value]
+            hints[name] = value
+        return hints if include_extras else {k: typing._strip_annotations(t) for k, t in hints.items()}  # type: ignore
+
+
+def is_dataclass(_cls: type[Any]) -> TypeGuard[type[StandardDataclass]]:
+    # The dataclasses.is_dataclass function doesn't seem to provide TypeGuard functionality,
+    # so I created this convenience function
+    return dataclasses.is_dataclass(_cls)
+
+
+def origin_is_type_alias_type(origin: Any) -> TypeGuard[TypeAliasType]:
+    return isinstance(origin, TypeAliasType)
+
+
+if sys.version_info >= (3, 10):
+
+    def is_generic_alias(type_: type[Any]) -> bool:
+        return isinstance(type_, (types.GenericAlias, typing._GenericAlias))  # type: ignore[attr-defined]
+
+else:
+
+    def is_generic_alias(type_: type[Any]) -> bool:
+        return isinstance(type_, typing._GenericAlias)  # type: ignore
diff --git a/lib/pydantic/_internal/_utils.py b/lib/pydantic/_internal/_utils.py
new file mode 100644
index 00000000..31f5b2c5
--- /dev/null
+++ b/lib/pydantic/_internal/_utils.py
@@ -0,0 +1,362 @@
+"""Bucket of reusable internal utilities.
+
+This should be reduced as much as possible with functions only used in one place, moved to that place.
+"""
+from __future__ import annotations as _annotations
+
+import dataclasses
+import keyword
+import typing
+import weakref
+from collections import OrderedDict, defaultdict, deque
+from copy import deepcopy
+from itertools import zip_longest
+from types import BuiltinFunctionType, CodeType, FunctionType, GeneratorType, LambdaType, ModuleType
+from typing import Any, Mapping, TypeVar
+
+from typing_extensions import TypeAlias, TypeGuard
+
+from . import _repr, _typing_extra
+
+if typing.TYPE_CHECKING:
+    MappingIntStrAny: TypeAlias = 'typing.Mapping[int, Any] | typing.Mapping[str, Any]'
+    AbstractSetIntStr: TypeAlias = 'typing.AbstractSet[int] | typing.AbstractSet[str]'
+    from ..main import BaseModel
+
+
+# these are types that are returned unchanged by deepcopy
+IMMUTABLE_NON_COLLECTIONS_TYPES: set[type[Any]] = {
+    int,
+    float,
+    complex,
+    str,
+    bool,
+    bytes,
+    type,
+    _typing_extra.NoneType,
+    FunctionType,
+    BuiltinFunctionType,
+    LambdaType,
+    weakref.ref,
+    CodeType,
+    # note: including ModuleType will differ from behaviour of deepcopy by not producing error.
+    # It might be not a good idea in general, but considering that this function used only internally
+    # against default values of fields, this will allow to actually have a field with module as default value
+    ModuleType,
+    NotImplemented.__class__,
+    Ellipsis.__class__,
+}
+
+# these are types that if empty, might be copied with simple copy() instead of deepcopy()
+BUILTIN_COLLECTIONS: set[type[Any]] = {
+    list,
+    set,
+    tuple,
+    frozenset,
+    dict,
+    OrderedDict,
+    defaultdict,
+    deque,
+}
+
+
+def sequence_like(v: Any) -> bool:
+    return isinstance(v, (list, tuple, set, frozenset, GeneratorType, deque))
+
+
+def lenient_isinstance(o: Any, class_or_tuple: type[Any] | tuple[type[Any], ...] | None) -> bool:  # pragma: no cover
+    try:
+        return isinstance(o, class_or_tuple)  # type: ignore[arg-type]
+    except TypeError:
+        return False
+
+
+def lenient_issubclass(cls: Any, class_or_tuple: Any) -> bool:  # pragma: no cover
+    try:
+        return isinstance(cls, type) and issubclass(cls, class_or_tuple)
+    except TypeError:
+        if isinstance(cls, _typing_extra.WithArgsTypes):
+            return False
+        raise  # pragma: no cover
+
+
+def is_model_class(cls: Any) -> TypeGuard[type[BaseModel]]:
+    """Returns true if cls is a _proper_ subclass of BaseModel, and provides proper type-checking,
+    unlike raw calls to lenient_issubclass.
+    """
+    from ..main import BaseModel
+
+    return lenient_issubclass(cls, BaseModel) and cls is not BaseModel
+
+
+def is_valid_identifier(identifier: str) -> bool:
+    """Checks that a string is a valid identifier and not a Python keyword.
+    :param identifier: The identifier to test.
+    :return: True if the identifier is valid.
+    """
+    return identifier.isidentifier() and not keyword.iskeyword(identifier)
+
+
+KeyType = TypeVar('KeyType')
+
+
+def deep_update(mapping: dict[KeyType, Any], *updating_mappings: dict[KeyType, Any]) -> dict[KeyType, Any]:
+    updated_mapping = mapping.copy()
+    for updating_mapping in updating_mappings:
+        for k, v in updating_mapping.items():
+            if k in updated_mapping and isinstance(updated_mapping[k], dict) and isinstance(v, dict):
+                updated_mapping[k] = deep_update(updated_mapping[k], v)
+            else:
+                updated_mapping[k] = v
+    return updated_mapping
+
+
+def update_not_none(mapping: dict[Any, Any], **update: Any) -> None:
+    mapping.update({k: v for k, v in update.items() if v is not None})
+
+
+T = TypeVar('T')
+
+
+def unique_list(
+    input_list: list[T] | tuple[T, ...],
+    *,
+    name_factory: typing.Callable[[T], str] = str,
+) -> list[T]:
+    """Make a list unique while maintaining order.
+    We update the list if another one with the same name is set
+    (e.g. model validator overridden in subclass).
+    """
+    result: list[T] = []
+    result_names: list[str] = []
+    for v in input_list:
+        v_name = name_factory(v)
+        if v_name not in result_names:
+            result_names.append(v_name)
+            result.append(v)
+        else:
+            result[result_names.index(v_name)] = v
+
+    return result
+
+
+class ValueItems(_repr.Representation):
+    """Class for more convenient calculation of excluded or included fields on values."""
+
+    __slots__ = ('_items', '_type')
+
+    def __init__(self, value: Any, items: AbstractSetIntStr | MappingIntStrAny) -> None:
+        items = self._coerce_items(items)
+
+        if isinstance(value, (list, tuple)):
+            items = self._normalize_indexes(items, len(value))  # type: ignore
+
+        self._items: MappingIntStrAny = items  # type: ignore
+
+    def is_excluded(self, item: Any) -> bool:
+        """Check if item is fully excluded.
+
+        :param item: key or index of a value
+        """
+        return self.is_true(self._items.get(item))
+
+    def is_included(self, item: Any) -> bool:
+        """Check if value is contained in self._items.
+
+        :param item: key or index of value
+        """
+        return item in self._items
+
+    def for_element(self, e: int | str) -> AbstractSetIntStr | MappingIntStrAny | None:
+        """:param e: key or index of element on value
+        :return: raw values for element if self._items is dict and contain needed element
+        """
+        item = self._items.get(e)  # type: ignore
+        return item if not self.is_true(item) else None
+
+    def _normalize_indexes(self, items: MappingIntStrAny, v_length: int) -> dict[int | str, Any]:
+        """:param items: dict or set of indexes which will be normalized
+        :param v_length: length of sequence indexes of which will be
+
+        >>> self._normalize_indexes({0: True, -2: True, -1: True}, 4)
+        {0: True, 2: True, 3: True}
+        >>> self._normalize_indexes({'__all__': True}, 4)
+        {0: True, 1: True, 2: True, 3: True}
+        """
+        normalized_items: dict[int | str, Any] = {}
+        all_items = None
+        for i, v in items.items():
+            if not (isinstance(v, typing.Mapping) or isinstance(v, typing.AbstractSet) or self.is_true(v)):
+                raise TypeError(f'Unexpected type of exclude value for index "{i}" {v.__class__}')
+            if i == '__all__':
+                all_items = self._coerce_value(v)
+                continue
+            if not isinstance(i, int):
+                raise TypeError(
+                    'Excluding fields from a sequence of sub-models or dicts must be performed index-wise: '
+                    'expected integer keys or keyword "__all__"'
+                )
+            normalized_i = v_length + i if i < 0 else i
+            normalized_items[normalized_i] = self.merge(v, normalized_items.get(normalized_i))
+
+        if not all_items:
+            return normalized_items
+        if self.is_true(all_items):
+            for i in range(v_length):
+                normalized_items.setdefault(i, ...)
+            return normalized_items
+        for i in range(v_length):
+            normalized_item = normalized_items.setdefault(i, {})
+            if not self.is_true(normalized_item):
+                normalized_items[i] = self.merge(all_items, normalized_item)
+        return normalized_items
+
+    @classmethod
+    def merge(cls, base: Any, override: Any, intersect: bool = False) -> Any:
+        """Merge a `base` item with an `override` item.
+
+        Both `base` and `override` are converted to dictionaries if possible.
+        Sets are converted to dictionaries with the sets entries as keys and
+        Ellipsis as values.
+
+        Each key-value pair existing in `base` is merged with `override`,
+        while the rest of the key-value pairs are updated recursively with this function.
+
+        Merging takes place based on the "union" of keys if `intersect` is
+        set to `False` (default) and on the intersection of keys if
+        `intersect` is set to `True`.
+        """
+        override = cls._coerce_value(override)
+        base = cls._coerce_value(base)
+        if override is None:
+            return base
+        if cls.is_true(base) or base is None:
+            return override
+        if cls.is_true(override):
+            return base if intersect else override
+
+        # intersection or union of keys while preserving ordering:
+        if intersect:
+            merge_keys = [k for k in base if k in override] + [k for k in override if k in base]
+        else:
+            merge_keys = list(base) + [k for k in override if k not in base]
+
+        merged: dict[int | str, Any] = {}
+        for k in merge_keys:
+            merged_item = cls.merge(base.get(k), override.get(k), intersect=intersect)
+            if merged_item is not None:
+                merged[k] = merged_item
+
+        return merged
+
+    @staticmethod
+    def _coerce_items(items: AbstractSetIntStr | MappingIntStrAny) -> MappingIntStrAny:
+        if isinstance(items, typing.Mapping):
+            pass
+        elif isinstance(items, typing.AbstractSet):
+            items = dict.fromkeys(items, ...)  # type: ignore
+        else:
+            class_name = getattr(items, '__class__', '???')
+            raise TypeError(f'Unexpected type of exclude value {class_name}')
+        return items  # type: ignore
+
+    @classmethod
+    def _coerce_value(cls, value: Any) -> Any:
+        if value is None or cls.is_true(value):
+            return value
+        return cls._coerce_items(value)
+
+    @staticmethod
+    def is_true(v: Any) -> bool:
+        return v is True or v is ...
+
+    def __repr_args__(self) -> _repr.ReprArgs:
+        return [(None, self._items)]
+
+
+if typing.TYPE_CHECKING:
+
+    def ClassAttribute(name: str, value: T) -> T:
+        ...
+
+else:
+
+    class ClassAttribute:
+        """Hide class attribute from its instances."""
+
+        __slots__ = 'name', 'value'
+
+        def __init__(self, name: str, value: Any) -> None:
+            self.name = name
+            self.value = value
+
+        def __get__(self, instance: Any, owner: type[Any]) -> None:
+            if instance is None:
+                return self.value
+            raise AttributeError(f'{self.name!r} attribute of {owner.__name__!r} is class-only')
+
+
+Obj = TypeVar('Obj')
+
+
+def smart_deepcopy(obj: Obj) -> Obj:
+    """Return type as is for immutable built-in types
+    Use obj.copy() for built-in empty collections
+    Use copy.deepcopy() for non-empty collections and unknown objects.
+    """
+    obj_type = obj.__class__
+    if obj_type in IMMUTABLE_NON_COLLECTIONS_TYPES:
+        return obj  # fastest case: obj is immutable and not collection therefore will not be copied anyway
+    try:
+        if not obj and obj_type in BUILTIN_COLLECTIONS:
+            # faster way for empty collections, no need to copy its members
+            return obj if obj_type is tuple else obj.copy()  # tuple doesn't have copy method  # type: ignore
+    except (TypeError, ValueError, RuntimeError):
+        # do we really dare to catch ALL errors? Seems a bit risky
+        pass
+
+    return deepcopy(obj)  # slowest way when we actually might need a deepcopy
+
+
+_SENTINEL = object()
+
+
+def all_identical(left: typing.Iterable[Any], right: typing.Iterable[Any]) -> bool:
+    """Check that the items of `left` are the same objects as those in `right`.
+
+    >>> a, b = object(), object()
+    >>> all_identical([a, b, a], [a, b, a])
+    True
+    >>> all_identical([a, b, [a]], [a, b, [a]])  # new list object, while "equal" is not "identical"
+    False
+    """
+    for left_item, right_item in zip_longest(left, right, fillvalue=_SENTINEL):
+        if left_item is not right_item:
+            return False
+    return True
+
+
+@dataclasses.dataclass(frozen=True)
+class SafeGetItemProxy:
+    """Wrapper redirecting `__getitem__` to `get` with a sentinel value as default
+
+    This makes is safe to use in `operator.itemgetter` when some keys may be missing
+    """
+
+    # Define __slots__manually for performances
+    # @dataclasses.dataclass() only support slots=True in python>=3.10
+    __slots__ = ('wrapped',)
+
+    wrapped: Mapping[str, Any]
+
+    def __getitem__(self, __key: str) -> Any:
+        return self.wrapped.get(__key, _SENTINEL)
+
+    # required to pass the object to operator.itemgetter() instances due to a quirk of typeshed
+    # https://github.com/python/mypy/issues/13713
+    # https://github.com/python/typeshed/pull/8785
+    # Since this is typing-only, hide it in a typing.TYPE_CHECKING block
+    if typing.TYPE_CHECKING:
+
+        def __contains__(self, __key: str) -> bool:
+            return self.wrapped.__contains__(__key)
diff --git a/lib/pydantic/_internal/_validate_call.py b/lib/pydantic/_internal/_validate_call.py
new file mode 100644
index 00000000..664c0630
--- /dev/null
+++ b/lib/pydantic/_internal/_validate_call.py
@@ -0,0 +1,84 @@
+from __future__ import annotations as _annotations
+
+import inspect
+from functools import partial
+from typing import Any, Awaitable, Callable
+
+import pydantic_core
+
+from ..config import ConfigDict
+from ..plugin._schema_validator import create_schema_validator
+from . import _generate_schema, _typing_extra
+from ._config import ConfigWrapper
+
+
+class ValidateCallWrapper:
+    """This is a wrapper around a function that validates the arguments passed to it, and optionally the return value."""
+
+    __slots__ = (
+        '__pydantic_validator__',
+        '__name__',
+        '__qualname__',
+        '__annotations__',
+        '__dict__',  # required for __module__
+    )
+
+    def __init__(self, function: Callable[..., Any], config: ConfigDict | None, validate_return: bool):
+        if isinstance(function, partial):
+            func = function.func
+            schema_type = func
+            self.__name__ = f'partial({func.__name__})'
+            self.__qualname__ = f'partial({func.__qualname__})'
+            self.__module__ = func.__module__
+        else:
+            schema_type = function
+            self.__name__ = function.__name__
+            self.__qualname__ = function.__qualname__
+            self.__module__ = function.__module__
+
+        namespace = _typing_extra.add_module_globals(function, None)
+        config_wrapper = ConfigWrapper(config)
+        gen_schema = _generate_schema.GenerateSchema(config_wrapper, namespace)
+        schema = gen_schema.clean_schema(gen_schema.generate_schema(function))
+        core_config = config_wrapper.core_config(self)
+
+        self.__pydantic_validator__ = create_schema_validator(
+            schema,
+            schema_type,
+            self.__module__,
+            self.__qualname__,
+            'validate_call',
+            core_config,
+            config_wrapper.plugin_settings,
+        )
+
+        if validate_return:
+            signature = inspect.signature(function)
+            return_type = signature.return_annotation if signature.return_annotation is not signature.empty else Any
+            gen_schema = _generate_schema.GenerateSchema(config_wrapper, namespace)
+            schema = gen_schema.clean_schema(gen_schema.generate_schema(return_type))
+            validator = create_schema_validator(
+                schema,
+                schema_type,
+                self.__module__,
+                self.__qualname__,
+                'validate_call',
+                core_config,
+                config_wrapper.plugin_settings,
+            )
+            if inspect.iscoroutinefunction(function):
+
+                async def return_val_wrapper(aw: Awaitable[Any]) -> None:
+                    return validator.validate_python(await aw)
+
+                self.__return_pydantic_validator__ = return_val_wrapper
+            else:
+                self.__return_pydantic_validator__ = validator.validate_python
+        else:
+            self.__return_pydantic_validator__ = None
+
+    def __call__(self, *args: Any, **kwargs: Any) -> Any:
+        res = self.__pydantic_validator__.validate_python(pydantic_core.ArgsKwargs(args, kwargs))
+        if self.__return_pydantic_validator__:
+            return self.__return_pydantic_validator__(res)
+        return res
diff --git a/lib/pydantic/_internal/_validators.py b/lib/pydantic/_internal/_validators.py
new file mode 100644
index 00000000..7193fe5c
--- /dev/null
+++ b/lib/pydantic/_internal/_validators.py
@@ -0,0 +1,278 @@
+"""Validator functions for standard library types.
+
+Import of this module is deferred since it contains imports of many standard library modules.
+"""
+
+from __future__ import annotations as _annotations
+
+import math
+import re
+import typing
+from ipaddress import IPv4Address, IPv4Interface, IPv4Network, IPv6Address, IPv6Interface, IPv6Network
+from typing import Any
+
+from pydantic_core import PydanticCustomError, core_schema
+from pydantic_core._pydantic_core import PydanticKnownError
+
+
+def sequence_validator(
+    __input_value: typing.Sequence[Any],
+    validator: core_schema.ValidatorFunctionWrapHandler,
+) -> typing.Sequence[Any]:
+    """Validator for `Sequence` types, isinstance(v, Sequence) has already been called."""
+    value_type = type(__input_value)
+
+    # We don't accept any plain string as a sequence
+    # Relevant issue: https://github.com/pydantic/pydantic/issues/5595
+    if issubclass(value_type, (str, bytes)):
+        raise PydanticCustomError(
+            'sequence_str',
+            "'{type_name}' instances are not allowed as a Sequence value",
+            {'type_name': value_type.__name__},
+        )
+
+    v_list = validator(__input_value)
+
+    # the rest of the logic is just re-creating the original type from `v_list`
+    if value_type == list:
+        return v_list
+    elif issubclass(value_type, range):
+        # return the list as we probably can't re-create the range
+        return v_list
+    else:
+        # best guess at how to re-create the original type, more custom construction logic might be required
+        return value_type(v_list)  # type: ignore[call-arg]
+
+
+def import_string(value: Any) -> Any:
+    if isinstance(value, str):
+        try:
+            return _import_string_logic(value)
+        except ImportError as e:
+            raise PydanticCustomError('import_error', 'Invalid python path: {error}', {'error': str(e)}) from e
+    else:
+        # otherwise we just return the value and let the next validator do the rest of the work
+        return value
+
+
+def _import_string_logic(dotted_path: str) -> Any:
+    """Inspired by uvicorn — dotted paths should include a colon before the final item if that item is not a module.
+    (This is necessary to distinguish between a submodule and an attribute when there is a conflict.).
+
+    If the dotted path does not include a colon and the final item is not a valid module, importing as an attribute
+    rather than a submodule will be attempted automatically.
+
+    So, for example, the following values of `dotted_path` result in the following returned values:
+    * 'collections': <module 'collections'>
+    * 'collections.abc': <module 'collections.abc'>
+    * 'collections.abc:Mapping': <class 'collections.abc.Mapping'>
+    * `collections.abc.Mapping`: <class 'collections.abc.Mapping'> (though this is a bit slower than the previous line)
+
+    An error will be raised under any of the following scenarios:
+    * `dotted_path` contains more than one colon (e.g., 'collections:abc:Mapping')
+    * the substring of `dotted_path` before the colon is not a valid module in the environment (e.g., '123:Mapping')
+    * the substring of `dotted_path` after the colon is not an attribute of the module (e.g., 'collections:abc123')
+    """
+    from importlib import import_module
+
+    components = dotted_path.strip().split(':')
+    if len(components) > 2:
+        raise ImportError(f"Import strings should have at most one ':'; received {dotted_path!r}")
+
+    module_path = components[0]
+    if not module_path:
+        raise ImportError(f'Import strings should have a nonempty module name; received {dotted_path!r}')
+
+    try:
+        module = import_module(module_path)
+    except ModuleNotFoundError as e:
+        if '.' in module_path:
+            # Check if it would be valid if the final item was separated from its module with a `:`
+            maybe_module_path, maybe_attribute = dotted_path.strip().rsplit('.', 1)
+            try:
+                return _import_string_logic(f'{maybe_module_path}:{maybe_attribute}')
+            except ImportError:
+                pass
+            raise ImportError(f'No module named {module_path!r}') from e
+        raise e
+
+    if len(components) > 1:
+        attribute = components[1]
+        try:
+            return getattr(module, attribute)
+        except AttributeError as e:
+            raise ImportError(f'cannot import name {attribute!r} from {module_path!r}') from e
+    else:
+        return module
+
+
+def pattern_either_validator(__input_value: Any) -> typing.Pattern[Any]:
+    if isinstance(__input_value, typing.Pattern):
+        return __input_value
+    elif isinstance(__input_value, (str, bytes)):
+        # todo strict mode
+        return compile_pattern(__input_value)  # type: ignore
+    else:
+        raise PydanticCustomError('pattern_type', 'Input should be a valid pattern')
+
+
+def pattern_str_validator(__input_value: Any) -> typing.Pattern[str]:
+    if isinstance(__input_value, typing.Pattern):
+        if isinstance(__input_value.pattern, str):
+            return __input_value
+        else:
+            raise PydanticCustomError('pattern_str_type', 'Input should be a string pattern')
+    elif isinstance(__input_value, str):
+        return compile_pattern(__input_value)
+    elif isinstance(__input_value, bytes):
+        raise PydanticCustomError('pattern_str_type', 'Input should be a string pattern')
+    else:
+        raise PydanticCustomError('pattern_type', 'Input should be a valid pattern')
+
+
+def pattern_bytes_validator(__input_value: Any) -> typing.Pattern[bytes]:
+    if isinstance(__input_value, typing.Pattern):
+        if isinstance(__input_value.pattern, bytes):
+            return __input_value
+        else:
+            raise PydanticCustomError('pattern_bytes_type', 'Input should be a bytes pattern')
+    elif isinstance(__input_value, bytes):
+        return compile_pattern(__input_value)
+    elif isinstance(__input_value, str):
+        raise PydanticCustomError('pattern_bytes_type', 'Input should be a bytes pattern')
+    else:
+        raise PydanticCustomError('pattern_type', 'Input should be a valid pattern')
+
+
+PatternType = typing.TypeVar('PatternType', str, bytes)
+
+
+def compile_pattern(pattern: PatternType) -> typing.Pattern[PatternType]:
+    try:
+        return re.compile(pattern)
+    except re.error:
+        raise PydanticCustomError('pattern_regex', 'Input should be a valid regular expression')
+
+
+def ip_v4_address_validator(__input_value: Any) -> IPv4Address:
+    if isinstance(__input_value, IPv4Address):
+        return __input_value
+
+    try:
+        return IPv4Address(__input_value)
+    except ValueError:
+        raise PydanticCustomError('ip_v4_address', 'Input is not a valid IPv4 address')
+
+
+def ip_v6_address_validator(__input_value: Any) -> IPv6Address:
+    if isinstance(__input_value, IPv6Address):
+        return __input_value
+
+    try:
+        return IPv6Address(__input_value)
+    except ValueError:
+        raise PydanticCustomError('ip_v6_address', 'Input is not a valid IPv6 address')
+
+
+def ip_v4_network_validator(__input_value: Any) -> IPv4Network:
+    """Assume IPv4Network initialised with a default `strict` argument.
+
+    See more:
+    https://docs.python.org/library/ipaddress.html#ipaddress.IPv4Network
+    """
+    if isinstance(__input_value, IPv4Network):
+        return __input_value
+
+    try:
+        return IPv4Network(__input_value)
+    except ValueError:
+        raise PydanticCustomError('ip_v4_network', 'Input is not a valid IPv4 network')
+
+
+def ip_v6_network_validator(__input_value: Any) -> IPv6Network:
+    """Assume IPv6Network initialised with a default `strict` argument.
+
+    See more:
+    https://docs.python.org/library/ipaddress.html#ipaddress.IPv6Network
+    """
+    if isinstance(__input_value, IPv6Network):
+        return __input_value
+
+    try:
+        return IPv6Network(__input_value)
+    except ValueError:
+        raise PydanticCustomError('ip_v6_network', 'Input is not a valid IPv6 network')
+
+
+def ip_v4_interface_validator(__input_value: Any) -> IPv4Interface:
+    if isinstance(__input_value, IPv4Interface):
+        return __input_value
+
+    try:
+        return IPv4Interface(__input_value)
+    except ValueError:
+        raise PydanticCustomError('ip_v4_interface', 'Input is not a valid IPv4 interface')
+
+
+def ip_v6_interface_validator(__input_value: Any) -> IPv6Interface:
+    if isinstance(__input_value, IPv6Interface):
+        return __input_value
+
+    try:
+        return IPv6Interface(__input_value)
+    except ValueError:
+        raise PydanticCustomError('ip_v6_interface', 'Input is not a valid IPv6 interface')
+
+
+def greater_than_validator(x: Any, gt: Any) -> Any:
+    if not (x > gt):
+        raise PydanticKnownError('greater_than', {'gt': gt})
+    return x
+
+
+def greater_than_or_equal_validator(x: Any, ge: Any) -> Any:
+    if not (x >= ge):
+        raise PydanticKnownError('greater_than_equal', {'ge': ge})
+    return x
+
+
+def less_than_validator(x: Any, lt: Any) -> Any:
+    if not (x < lt):
+        raise PydanticKnownError('less_than', {'lt': lt})
+    return x
+
+
+def less_than_or_equal_validator(x: Any, le: Any) -> Any:
+    if not (x <= le):
+        raise PydanticKnownError('less_than_equal', {'le': le})
+    return x
+
+
+def multiple_of_validator(x: Any, multiple_of: Any) -> Any:
+    if not (x % multiple_of == 0):
+        raise PydanticKnownError('multiple_of', {'multiple_of': multiple_of})
+    return x
+
+
+def min_length_validator(x: Any, min_length: Any) -> Any:
+    if not (len(x) >= min_length):
+        raise PydanticKnownError(
+            'too_short',
+            {'field_type': 'Value', 'min_length': min_length, 'actual_length': len(x)},
+        )
+    return x
+
+
+def max_length_validator(x: Any, max_length: Any) -> Any:
+    if len(x) > max_length:
+        raise PydanticKnownError(
+            'too_long',
+            {'field_type': 'Value', 'max_length': max_length, 'actual_length': len(x)},
+        )
+    return x
+
+
+def forbid_inf_nan_check(x: Any) -> Any:
+    if not math.isfinite(x):
+        raise PydanticKnownError('finite_number')
+    return x
diff --git a/lib/pydantic/_migration.py b/lib/pydantic/_migration.py
new file mode 100644
index 00000000..c8478a62
--- /dev/null
+++ b/lib/pydantic/_migration.py
@@ -0,0 +1,308 @@
+import sys
+from typing import Any, Callable, Dict
+
+from .version import version_short
+
+MOVED_IN_V2 = {
+    'pydantic.utils:version_info': 'pydantic.version:version_info',
+    'pydantic.error_wrappers:ValidationError': 'pydantic:ValidationError',
+    'pydantic.utils:to_camel': 'pydantic.alias_generators:to_pascal',
+    'pydantic.utils:to_lower_camel': 'pydantic.alias_generators:to_camel',
+    'pydantic:PyObject': 'pydantic.types:ImportString',
+    'pydantic.types:PyObject': 'pydantic.types:ImportString',
+    'pydantic.generics:GenericModel': 'pydantic.BaseModel',
+}
+
+DEPRECATED_MOVED_IN_V2 = {
+    'pydantic.tools:schema_of': 'pydantic.deprecated.tools:schema_of',
+    'pydantic.tools:parse_obj_as': 'pydantic.deprecated.tools:parse_obj_as',
+    'pydantic.tools:schema_json_of': 'pydantic.deprecated.tools:schema_json_of',
+    'pydantic.json:pydantic_encoder': 'pydantic.deprecated.json:pydantic_encoder',
+    'pydantic:validate_arguments': 'pydantic.deprecated.decorator:validate_arguments',
+    'pydantic.json:custom_pydantic_encoder': 'pydantic.deprecated.json:custom_pydantic_encoder',
+    'pydantic.json:timedelta_isoformat': 'pydantic.deprecated.json:timedelta_isoformat',
+    'pydantic.decorator:validate_arguments': 'pydantic.deprecated.decorator:validate_arguments',
+    'pydantic.class_validators:validator': 'pydantic.deprecated.class_validators:validator',
+    'pydantic.class_validators:root_validator': 'pydantic.deprecated.class_validators:root_validator',
+    'pydantic.config:BaseConfig': 'pydantic.deprecated.config:BaseConfig',
+    'pydantic.config:Extra': 'pydantic.deprecated.config:Extra',
+}
+
+REDIRECT_TO_V1 = {
+    f'pydantic.utils:{obj}': f'pydantic.v1.utils:{obj}'
+    for obj in (
+        'deep_update',
+        'GetterDict',
+        'lenient_issubclass',
+        'lenient_isinstance',
+        'is_valid_field',
+        'update_not_none',
+        'import_string',
+        'Representation',
+        'ROOT_KEY',
+        'smart_deepcopy',
+        'sequence_like',
+    )
+}
+
+
+REMOVED_IN_V2 = {
+    'pydantic:ConstrainedBytes',
+    'pydantic:ConstrainedDate',
+    'pydantic:ConstrainedDecimal',
+    'pydantic:ConstrainedFloat',
+    'pydantic:ConstrainedFrozenSet',
+    'pydantic:ConstrainedInt',
+    'pydantic:ConstrainedList',
+    'pydantic:ConstrainedSet',
+    'pydantic:ConstrainedStr',
+    'pydantic:JsonWrapper',
+    'pydantic:NoneBytes',
+    'pydantic:NoneStr',
+    'pydantic:NoneStrBytes',
+    'pydantic:Protocol',
+    'pydantic:Required',
+    'pydantic:StrBytes',
+    'pydantic:compiled',
+    'pydantic.config:get_config',
+    'pydantic.config:inherit_config',
+    'pydantic.config:prepare_config',
+    'pydantic:create_model_from_namedtuple',
+    'pydantic:create_model_from_typeddict',
+    'pydantic.dataclasses:create_pydantic_model_from_dataclass',
+    'pydantic.dataclasses:make_dataclass_validator',
+    'pydantic.dataclasses:set_validation',
+    'pydantic.datetime_parse:parse_date',
+    'pydantic.datetime_parse:parse_time',
+    'pydantic.datetime_parse:parse_datetime',
+    'pydantic.datetime_parse:parse_duration',
+    'pydantic.error_wrappers:ErrorWrapper',
+    'pydantic.errors:AnyStrMaxLengthError',
+    'pydantic.errors:AnyStrMinLengthError',
+    'pydantic.errors:ArbitraryTypeError',
+    'pydantic.errors:BoolError',
+    'pydantic.errors:BytesError',
+    'pydantic.errors:CallableError',
+    'pydantic.errors:ClassError',
+    'pydantic.errors:ColorError',
+    'pydantic.errors:ConfigError',
+    'pydantic.errors:DataclassTypeError',
+    'pydantic.errors:DateError',
+    'pydantic.errors:DateNotInTheFutureError',
+    'pydantic.errors:DateNotInThePastError',
+    'pydantic.errors:DateTimeError',
+    'pydantic.errors:DecimalError',
+    'pydantic.errors:DecimalIsNotFiniteError',
+    'pydantic.errors:DecimalMaxDigitsError',
+    'pydantic.errors:DecimalMaxPlacesError',
+    'pydantic.errors:DecimalWholeDigitsError',
+    'pydantic.errors:DictError',
+    'pydantic.errors:DurationError',
+    'pydantic.errors:EmailError',
+    'pydantic.errors:EnumError',
+    'pydantic.errors:EnumMemberError',
+    'pydantic.errors:ExtraError',
+    'pydantic.errors:FloatError',
+    'pydantic.errors:FrozenSetError',
+    'pydantic.errors:FrozenSetMaxLengthError',
+    'pydantic.errors:FrozenSetMinLengthError',
+    'pydantic.errors:HashableError',
+    'pydantic.errors:IPv4AddressError',
+    'pydantic.errors:IPv4InterfaceError',
+    'pydantic.errors:IPv4NetworkError',
+    'pydantic.errors:IPv6AddressError',
+    'pydantic.errors:IPv6InterfaceError',
+    'pydantic.errors:IPv6NetworkError',
+    'pydantic.errors:IPvAnyAddressError',
+    'pydantic.errors:IPvAnyInterfaceError',
+    'pydantic.errors:IPvAnyNetworkError',
+    'pydantic.errors:IntEnumError',
+    'pydantic.errors:IntegerError',
+    'pydantic.errors:InvalidByteSize',
+    'pydantic.errors:InvalidByteSizeUnit',
+    'pydantic.errors:InvalidDiscriminator',
+    'pydantic.errors:InvalidLengthForBrand',
+    'pydantic.errors:JsonError',
+    'pydantic.errors:JsonTypeError',
+    'pydantic.errors:ListError',
+    'pydantic.errors:ListMaxLengthError',
+    'pydantic.errors:ListMinLengthError',
+    'pydantic.errors:ListUniqueItemsError',
+    'pydantic.errors:LuhnValidationError',
+    'pydantic.errors:MissingDiscriminator',
+    'pydantic.errors:MissingError',
+    'pydantic.errors:NoneIsAllowedError',
+    'pydantic.errors:NoneIsNotAllowedError',
+    'pydantic.errors:NotDigitError',
+    'pydantic.errors:NotNoneError',
+    'pydantic.errors:NumberNotGeError',
+    'pydantic.errors:NumberNotGtError',
+    'pydantic.errors:NumberNotLeError',
+    'pydantic.errors:NumberNotLtError',
+    'pydantic.errors:NumberNotMultipleError',
+    'pydantic.errors:PathError',
+    'pydantic.errors:PathNotADirectoryError',
+    'pydantic.errors:PathNotAFileError',
+    'pydantic.errors:PathNotExistsError',
+    'pydantic.errors:PatternError',
+    'pydantic.errors:PyObjectError',
+    'pydantic.errors:PydanticTypeError',
+    'pydantic.errors:PydanticValueError',
+    'pydantic.errors:SequenceError',
+    'pydantic.errors:SetError',
+    'pydantic.errors:SetMaxLengthError',
+    'pydantic.errors:SetMinLengthError',
+    'pydantic.errors:StrError',
+    'pydantic.errors:StrRegexError',
+    'pydantic.errors:StrictBoolError',
+    'pydantic.errors:SubclassError',
+    'pydantic.errors:TimeError',
+    'pydantic.errors:TupleError',
+    'pydantic.errors:TupleLengthError',
+    'pydantic.errors:UUIDError',
+    'pydantic.errors:UUIDVersionError',
+    'pydantic.errors:UrlError',
+    'pydantic.errors:UrlExtraError',
+    'pydantic.errors:UrlHostError',
+    'pydantic.errors:UrlHostTldError',
+    'pydantic.errors:UrlPortError',
+    'pydantic.errors:UrlSchemeError',
+    'pydantic.errors:UrlSchemePermittedError',
+    'pydantic.errors:UrlUserInfoError',
+    'pydantic.errors:WrongConstantError',
+    'pydantic.main:validate_model',
+    'pydantic.networks:stricturl',
+    'pydantic:parse_file_as',
+    'pydantic:parse_raw_as',
+    'pydantic:stricturl',
+    'pydantic.tools:parse_file_as',
+    'pydantic.tools:parse_raw_as',
+    'pydantic.types:ConstrainedBytes',
+    'pydantic.types:ConstrainedDate',
+    'pydantic.types:ConstrainedDecimal',
+    'pydantic.types:ConstrainedFloat',
+    'pydantic.types:ConstrainedFrozenSet',
+    'pydantic.types:ConstrainedInt',
+    'pydantic.types:ConstrainedList',
+    'pydantic.types:ConstrainedSet',
+    'pydantic.types:ConstrainedStr',
+    'pydantic.types:JsonWrapper',
+    'pydantic.types:NoneBytes',
+    'pydantic.types:NoneStr',
+    'pydantic.types:NoneStrBytes',
+    'pydantic.types:StrBytes',
+    'pydantic.typing:evaluate_forwardref',
+    'pydantic.typing:AbstractSetIntStr',
+    'pydantic.typing:AnyCallable',
+    'pydantic.typing:AnyClassMethod',
+    'pydantic.typing:CallableGenerator',
+    'pydantic.typing:DictAny',
+    'pydantic.typing:DictIntStrAny',
+    'pydantic.typing:DictStrAny',
+    'pydantic.typing:IntStr',
+    'pydantic.typing:ListStr',
+    'pydantic.typing:MappingIntStrAny',
+    'pydantic.typing:NoArgAnyCallable',
+    'pydantic.typing:NoneType',
+    'pydantic.typing:ReprArgs',
+    'pydantic.typing:SetStr',
+    'pydantic.typing:StrPath',
+    'pydantic.typing:TupleGenerator',
+    'pydantic.typing:WithArgsTypes',
+    'pydantic.typing:all_literal_values',
+    'pydantic.typing:display_as_type',
+    'pydantic.typing:get_all_type_hints',
+    'pydantic.typing:get_args',
+    'pydantic.typing:get_origin',
+    'pydantic.typing:get_sub_types',
+    'pydantic.typing:is_callable_type',
+    'pydantic.typing:is_classvar',
+    'pydantic.typing:is_finalvar',
+    'pydantic.typing:is_literal_type',
+    'pydantic.typing:is_namedtuple',
+    'pydantic.typing:is_new_type',
+    'pydantic.typing:is_none_type',
+    'pydantic.typing:is_typeddict',
+    'pydantic.typing:is_typeddict_special',
+    'pydantic.typing:is_union',
+    'pydantic.typing:new_type_supertype',
+    'pydantic.typing:resolve_annotations',
+    'pydantic.typing:typing_base',
+    'pydantic.typing:update_field_forward_refs',
+    'pydantic.typing:update_model_forward_refs',
+    'pydantic.utils:ClassAttribute',
+    'pydantic.utils:DUNDER_ATTRIBUTES',
+    'pydantic.utils:PyObjectStr',
+    'pydantic.utils:ValueItems',
+    'pydantic.utils:almost_equal_floats',
+    'pydantic.utils:get_discriminator_alias_and_values',
+    'pydantic.utils:get_model',
+    'pydantic.utils:get_unique_discriminator_alias',
+    'pydantic.utils:in_ipython',
+    'pydantic.utils:is_valid_identifier',
+    'pydantic.utils:path_type',
+    'pydantic.utils:validate_field_name',
+    'pydantic:validate_model',
+}
+
+
+def getattr_migration(module: str) -> Callable[[str], Any]:
+    """Implement PEP 562 for objects that were either moved or removed on the migration
+    to V2.
+
+    Args:
+        module: The module name.
+
+    Returns:
+        A callable that will raise an error if the object is not found.
+    """
+    # This avoids circular import with errors.py.
+    from .errors import PydanticImportError
+
+    def wrapper(name: str) -> object:
+        """Raise an error if the object is not found, or warn if it was moved.
+
+        In case it was moved, it still returns the object.
+
+        Args:
+            name: The object name.
+
+        Returns:
+            The object.
+        """
+        if name == '__path__':
+            raise AttributeError(f'module {module!r} has no attribute {name!r}')
+
+        import warnings
+
+        from ._internal._validators import import_string
+
+        import_path = f'{module}:{name}'
+        if import_path in MOVED_IN_V2.keys():
+            new_location = MOVED_IN_V2[import_path]
+            warnings.warn(f'`{import_path}` has been moved to `{new_location}`.')
+            return import_string(MOVED_IN_V2[import_path])
+        if import_path in DEPRECATED_MOVED_IN_V2:
+            # skip the warning here because a deprecation warning will be raised elsewhere
+            return import_string(DEPRECATED_MOVED_IN_V2[import_path])
+        if import_path in REDIRECT_TO_V1:
+            new_location = REDIRECT_TO_V1[import_path]
+            warnings.warn(
+                f'`{import_path}` has been removed. We are importing from `{new_location}` instead.'
+                'See the migration guide for more details: https://docs.pydantic.dev/latest/migration/'
+            )
+            return import_string(REDIRECT_TO_V1[import_path])
+        if import_path == 'pydantic:BaseSettings':
+            raise PydanticImportError(
+                '`BaseSettings` has been moved to the `pydantic-settings` package. '
+                f'See https://docs.pydantic.dev/{version_short()}/migration/#basesettings-has-moved-to-pydantic-settings '
+                'for more details.'
+            )
+        if import_path in REMOVED_IN_V2:
+            raise PydanticImportError(f'`{import_path}` has been removed in V2.')
+        globals: Dict[str, Any] = sys.modules[module].__dict__
+        if name in globals:
+            return globals[name]
+        raise AttributeError(f'module {module!r} has no attribute {name!r}')
+
+    return wrapper
diff --git a/lib/pydantic/alias_generators.py b/lib/pydantic/alias_generators.py
new file mode 100644
index 00000000..155e66e0
--- /dev/null
+++ b/lib/pydantic/alias_generators.py
@@ -0,0 +1,50 @@
+"""Alias generators for converting between different capitalization conventions."""
+import re
+
+__all__ = ('to_pascal', 'to_camel', 'to_snake')
+
+
+def to_pascal(snake: str) -> str:
+    """Convert a snake_case string to PascalCase.
+
+    Args:
+        snake: The string to convert.
+
+    Returns:
+        The PascalCase string.
+    """
+    camel = snake.title()
+    return re.sub('([0-9A-Za-z])_(?=[0-9A-Z])', lambda m: m.group(1), camel)
+
+
+def to_camel(snake: str) -> str:
+    """Convert a snake_case string to camelCase.
+
+    Args:
+        snake: The string to convert.
+
+    Returns:
+        The converted camelCase string.
+    """
+    camel = to_pascal(snake)
+    return re.sub('(^_*[A-Z])', lambda m: m.group(1).lower(), camel)
+
+
+def to_snake(camel: str) -> str:
+    """Convert a PascalCase or camelCase string to snake_case.
+
+    Args:
+        camel: The string to convert.
+
+    Returns:
+        The converted string in snake_case.
+    """
+    # Handle the sequence of uppercase letters followed by a lowercase letter
+    snake = re.sub(r'([A-Z]+)([A-Z][a-z])', lambda m: f'{m.group(1)}_{m.group(2)}', camel)
+    # Insert an underscore between a lowercase letter and an uppercase letter
+    snake = re.sub(r'([a-z])([A-Z])', lambda m: f'{m.group(1)}_{m.group(2)}', snake)
+    # Insert an underscore between a digit and an uppercase letter
+    snake = re.sub(r'([0-9])([A-Z])', lambda m: f'{m.group(1)}_{m.group(2)}', snake)
+    # Insert an underscore between a lowercase letter and a digit
+    snake = re.sub(r'([a-z])([0-9])', lambda m: f'{m.group(1)}_{m.group(2)}', snake)
+    return snake.lower()
diff --git a/lib/pydantic/aliases.py b/lib/pydantic/aliases.py
new file mode 100644
index 00000000..b53557b1
--- /dev/null
+++ b/lib/pydantic/aliases.py
@@ -0,0 +1,112 @@
+"""Support for alias configurations."""
+from __future__ import annotations
+
+import dataclasses
+from typing import Callable, Literal
+
+from ._internal import _internal_dataclass
+
+__all__ = ('AliasGenerator', 'AliasPath', 'AliasChoices')
+
+
+@dataclasses.dataclass(**_internal_dataclass.slots_true)
+class AliasPath:
+    """Usage docs: https://docs.pydantic.dev/2.6/concepts/alias#aliaspath-and-aliaschoices
+
+    A data class used by `validation_alias` as a convenience to create aliases.
+
+    Attributes:
+        path: A list of string or integer aliases.
+    """
+
+    path: list[int | str]
+
+    def __init__(self, first_arg: str, *args: str | int) -> None:
+        self.path = [first_arg] + list(args)
+
+    def convert_to_aliases(self) -> list[str | int]:
+        """Converts arguments to a list of string or integer aliases.
+
+        Returns:
+            The list of aliases.
+        """
+        return self.path
+
+
+@dataclasses.dataclass(**_internal_dataclass.slots_true)
+class AliasChoices:
+    """Usage docs: https://docs.pydantic.dev/2.6/concepts/alias#aliaspath-and-aliaschoices
+
+    A data class used by `validation_alias` as a convenience to create aliases.
+
+    Attributes:
+        choices: A list containing a string or `AliasPath`.
+    """
+
+    choices: list[str | AliasPath]
+
+    def __init__(self, first_choice: str | AliasPath, *choices: str | AliasPath) -> None:
+        self.choices = [first_choice] + list(choices)
+
+    def convert_to_aliases(self) -> list[list[str | int]]:
+        """Converts arguments to a list of lists containing string or integer aliases.
+
+        Returns:
+            The list of aliases.
+        """
+        aliases: list[list[str | int]] = []
+        for c in self.choices:
+            if isinstance(c, AliasPath):
+                aliases.append(c.convert_to_aliases())
+            else:
+                aliases.append([c])
+        return aliases
+
+
+@dataclasses.dataclass(**_internal_dataclass.slots_true)
+class AliasGenerator:
+    """Usage docs: https://docs.pydantic.dev/2.6/concepts/alias#using-an-aliasgenerator
+
+    A data class used by `alias_generator` as a convenience to create various aliases.
+
+    Attributes:
+        alias: A callable that takes a field name and returns an alias for it.
+        validation_alias: A callable that takes a field name and returns a validation alias for it.
+        serialization_alias: A callable that takes a field name and returns a serialization alias for it.
+    """
+
+    alias: Callable[[str], str] | None = None
+    validation_alias: Callable[[str], str | AliasPath | AliasChoices] | None = None
+    serialization_alias: Callable[[str], str] | None = None
+
+    def _generate_alias(
+        self,
+        alias_kind: Literal['alias', 'validation_alias', 'serialization_alias'],
+        allowed_types: tuple[type[str] | type[AliasPath] | type[AliasChoices], ...],
+        field_name: str,
+    ) -> str | AliasPath | AliasChoices | None:
+        """Generate an alias of the specified kind. Returns None if the alias generator is None.
+
+        Raises:
+            TypeError: If the alias generator produces an invalid type.
+        """
+        alias = None
+        if alias_generator := getattr(self, alias_kind):
+            alias = alias_generator(field_name)
+            if alias and not isinstance(alias, allowed_types):
+                raise TypeError(
+                    f'Invalid `{alias_kind}` type. `{alias_kind}` generator must produce one of `{allowed_types}`'
+                )
+        return alias
+
+    def generate_aliases(self, field_name: str) -> tuple[str | None, str | AliasPath | AliasChoices | None, str | None]:
+        """Generate `alias`, `validation_alias`, and `serialization_alias` for a field.
+
+        Returns:
+            A tuple of three aliases - validation, alias, and serialization.
+        """
+        alias = self._generate_alias('alias', (str,), field_name)
+        validation_alias = self._generate_alias('validation_alias', (str, AliasChoices, AliasPath), field_name)
+        serialization_alias = self._generate_alias('serialization_alias', (str,), field_name)
+
+        return alias, validation_alias, serialization_alias  # type: ignore
diff --git a/lib/pydantic/annotated_handlers.py b/lib/pydantic/annotated_handlers.py
new file mode 100644
index 00000000..081949a8
--- /dev/null
+++ b/lib/pydantic/annotated_handlers.py
@@ -0,0 +1,120 @@
+"""Type annotations to use with `__get_pydantic_core_schema__` and `__get_pydantic_json_schema__`."""
+from __future__ import annotations as _annotations
+
+from typing import TYPE_CHECKING, Any, Union
+
+from pydantic_core import core_schema
+
+if TYPE_CHECKING:
+    from .json_schema import JsonSchemaMode, JsonSchemaValue
+
+    CoreSchemaOrField = Union[
+        core_schema.CoreSchema,
+        core_schema.ModelField,
+        core_schema.DataclassField,
+        core_schema.TypedDictField,
+        core_schema.ComputedField,
+    ]
+
+__all__ = 'GetJsonSchemaHandler', 'GetCoreSchemaHandler'
+
+
+class GetJsonSchemaHandler:
+    """Handler to call into the next JSON schema generation function.
+
+    Attributes:
+        mode: Json schema mode, can be `validation` or `serialization`.
+    """
+
+    mode: JsonSchemaMode
+
+    def __call__(self, __core_schema: CoreSchemaOrField) -> JsonSchemaValue:
+        """Call the inner handler and get the JsonSchemaValue it returns.
+        This will call the next JSON schema modifying function up until it calls
+        into `pydantic.json_schema.GenerateJsonSchema`, which will raise a
+        `pydantic.errors.PydanticInvalidForJsonSchema` error if it cannot generate
+        a JSON schema.
+
+        Args:
+            __core_schema: A `pydantic_core.core_schema.CoreSchema`.
+
+        Returns:
+            JsonSchemaValue: The JSON schema generated by the inner JSON schema modify
+            functions.
+        """
+        raise NotImplementedError
+
+    def resolve_ref_schema(self, __maybe_ref_json_schema: JsonSchemaValue) -> JsonSchemaValue:
+        """Get the real schema for a `{"$ref": ...}` schema.
+        If the schema given is not a `$ref` schema, it will be returned as is.
+        This means you don't have to check before calling this function.
+
+        Args:
+            __maybe_ref_json_schema: A JsonSchemaValue which may be a `$ref` schema.
+
+        Raises:
+            LookupError: If the ref is not found.
+
+        Returns:
+            JsonSchemaValue: A JsonSchemaValue that has no `$ref`.
+        """
+        raise NotImplementedError
+
+
+class GetCoreSchemaHandler:
+    """Handler to call into the next CoreSchema schema generation function."""
+
+    def __call__(self, __source_type: Any) -> core_schema.CoreSchema:
+        """Call the inner handler and get the CoreSchema it returns.
+        This will call the next CoreSchema modifying function up until it calls
+        into Pydantic's internal schema generation machinery, which will raise a
+        `pydantic.errors.PydanticSchemaGenerationError` error if it cannot generate
+        a CoreSchema for the given source type.
+
+        Args:
+            __source_type: The input type.
+
+        Returns:
+            CoreSchema: The `pydantic-core` CoreSchema generated.
+        """
+        raise NotImplementedError
+
+    def generate_schema(self, __source_type: Any) -> core_schema.CoreSchema:
+        """Generate a schema unrelated to the current context.
+        Use this function if e.g. you are handling schema generation for a sequence
+        and want to generate a schema for its items.
+        Otherwise, you may end up doing something like applying a `min_length` constraint
+        that was intended for the sequence itself to its items!
+
+        Args:
+            __source_type: The input type.
+
+        Returns:
+            CoreSchema: The `pydantic-core` CoreSchema generated.
+        """
+        raise NotImplementedError
+
+    def resolve_ref_schema(self, __maybe_ref_schema: core_schema.CoreSchema) -> core_schema.CoreSchema:
+        """Get the real schema for a `definition-ref` schema.
+        If the schema given is not a `definition-ref` schema, it will be returned as is.
+        This means you don't have to check before calling this function.
+
+        Args:
+            __maybe_ref_schema: A `CoreSchema`, `ref`-based or not.
+
+        Raises:
+            LookupError: If the `ref` is not found.
+
+        Returns:
+            A concrete `CoreSchema`.
+        """
+        raise NotImplementedError
+
+    @property
+    def field_name(self) -> str | None:
+        """Get the name of the closest field to this validator."""
+        raise NotImplementedError
+
+    def _get_types_namespace(self) -> dict[str, Any] | None:
+        """Internal method used during type resolution for serializer annotations."""
+        raise NotImplementedError
diff --git a/lib/pydantic/class_validators.py b/lib/pydantic/class_validators.py
index 87190610..2ff72ae5 100644
--- a/lib/pydantic/class_validators.py
+++ b/lib/pydantic/class_validators.py
@@ -1,342 +1,4 @@
-import warnings
-from collections import ChainMap
-from functools import wraps
-from itertools import chain
-from types import FunctionType
-from typing import TYPE_CHECKING, Any, Callable, Dict, Iterable, List, Optional, Set, Tuple, Type, Union, overload
+"""`class_validators` module is a backport module from V1."""
+from ._migration import getattr_migration
 
-from .errors import ConfigError
-from .typing import AnyCallable
-from .utils import ROOT_KEY, in_ipython
-
-if TYPE_CHECKING:
-    from .typing import AnyClassMethod
-
-
-class Validator:
-    __slots__ = 'func', 'pre', 'each_item', 'always', 'check_fields', 'skip_on_failure'
-
-    def __init__(
-        self,
-        func: AnyCallable,
-        pre: bool = False,
-        each_item: bool = False,
-        always: bool = False,
-        check_fields: bool = False,
-        skip_on_failure: bool = False,
-    ):
-        self.func = func
-        self.pre = pre
-        self.each_item = each_item
-        self.always = always
-        self.check_fields = check_fields
-        self.skip_on_failure = skip_on_failure
-
-
-if TYPE_CHECKING:
-    from inspect import Signature
-
-    from .config import BaseConfig
-    from .fields import ModelField
-    from .types import ModelOrDc
-
-    ValidatorCallable = Callable[[Optional[ModelOrDc], Any, Dict[str, Any], ModelField, Type[BaseConfig]], Any]
-    ValidatorsList = List[ValidatorCallable]
-    ValidatorListDict = Dict[str, List[Validator]]
-
-_FUNCS: Set[str] = set()
-VALIDATOR_CONFIG_KEY = '__validator_config__'
-ROOT_VALIDATOR_CONFIG_KEY = '__root_validator_config__'
-
-
-def validator(
-    *fields: str,
-    pre: bool = False,
-    each_item: bool = False,
-    always: bool = False,
-    check_fields: bool = True,
-    whole: bool = None,
-    allow_reuse: bool = False,
-) -> Callable[[AnyCallable], 'AnyClassMethod']:
-    """
-    Decorate methods on the class indicating that they should be used to validate fields
-    :param fields: which field(s) the method should be called on
-    :param pre: whether or not this validator should be called before the standard validators (else after)
-    :param each_item: for complex objects (sets, lists etc.) whether to validate individual elements rather than the
-      whole object
-    :param always: whether this method and other validators should be called even if the value is missing
-    :param check_fields: whether to check that the fields actually exist on the model
-    :param allow_reuse: whether to track and raise an error if another validator refers to the decorated function
-    """
-    if not fields:
-        raise ConfigError('validator with no fields specified')
-    elif isinstance(fields[0], FunctionType):
-        raise ConfigError(
-            "validators should be used with fields and keyword arguments, not bare. "  # noqa: Q000
-            "E.g. usage should be `@validator('<field_name>', ...)`"
-        )
-    elif not all(isinstance(field, str) for field in fields):
-        raise ConfigError(
-            "validator fields should be passed as separate string args. "  # noqa: Q000
-            "E.g. usage should be `@validator('<field_name_1>', '<field_name_2>', ...)`"
-        )
-
-    if whole is not None:
-        warnings.warn(
-            'The "whole" keyword argument is deprecated, use "each_item" (inverse meaning, default False) instead',
-            DeprecationWarning,
-        )
-        assert each_item is False, '"each_item" and "whole" conflict, remove "whole"'
-        each_item = not whole
-
-    def dec(f: AnyCallable) -> 'AnyClassMethod':
-        f_cls = _prepare_validator(f, allow_reuse)
-        setattr(
-            f_cls,
-            VALIDATOR_CONFIG_KEY,
-            (
-                fields,
-                Validator(func=f_cls.__func__, pre=pre, each_item=each_item, always=always, check_fields=check_fields),
-            ),
-        )
-        return f_cls
-
-    return dec
-
-
-@overload
-def root_validator(_func: AnyCallable) -> 'AnyClassMethod':
-    ...
-
-
-@overload
-def root_validator(
-    *, pre: bool = False, allow_reuse: bool = False, skip_on_failure: bool = False
-) -> Callable[[AnyCallable], 'AnyClassMethod']:
-    ...
-
-
-def root_validator(
-    _func: Optional[AnyCallable] = None, *, pre: bool = False, allow_reuse: bool = False, skip_on_failure: bool = False
-) -> Union['AnyClassMethod', Callable[[AnyCallable], 'AnyClassMethod']]:
-    """
-    Decorate methods on a model indicating that they should be used to validate (and perhaps modify) data either
-    before or after standard model parsing/validation is performed.
-    """
-    if _func:
-        f_cls = _prepare_validator(_func, allow_reuse)
-        setattr(
-            f_cls, ROOT_VALIDATOR_CONFIG_KEY, Validator(func=f_cls.__func__, pre=pre, skip_on_failure=skip_on_failure)
-        )
-        return f_cls
-
-    def dec(f: AnyCallable) -> 'AnyClassMethod':
-        f_cls = _prepare_validator(f, allow_reuse)
-        setattr(
-            f_cls, ROOT_VALIDATOR_CONFIG_KEY, Validator(func=f_cls.__func__, pre=pre, skip_on_failure=skip_on_failure)
-        )
-        return f_cls
-
-    return dec
-
-
-def _prepare_validator(function: AnyCallable, allow_reuse: bool) -> 'AnyClassMethod':
-    """
-    Avoid validators with duplicated names since without this, validators can be overwritten silently
-    which generally isn't the intended behaviour, don't run in ipython (see #312) or if allow_reuse is False.
-    """
-    f_cls = function if isinstance(function, classmethod) else classmethod(function)
-    if not in_ipython() and not allow_reuse:
-        ref = f_cls.__func__.__module__ + '.' + f_cls.__func__.__qualname__
-        if ref in _FUNCS:
-            raise ConfigError(f'duplicate validator function "{ref}"; if this is intended, set `allow_reuse=True`')
-        _FUNCS.add(ref)
-    return f_cls
-
-
-class ValidatorGroup:
-    def __init__(self, validators: 'ValidatorListDict') -> None:
-        self.validators = validators
-        self.used_validators = {'*'}
-
-    def get_validators(self, name: str) -> Optional[Dict[str, Validator]]:
-        self.used_validators.add(name)
-        validators = self.validators.get(name, [])
-        if name != ROOT_KEY:
-            validators += self.validators.get('*', [])
-        if validators:
-            return {v.func.__name__: v for v in validators}
-        else:
-            return None
-
-    def check_for_unused(self) -> None:
-        unused_validators = set(
-            chain.from_iterable(
-                (v.func.__name__ for v in self.validators[f] if v.check_fields)
-                for f in (self.validators.keys() - self.used_validators)
-            )
-        )
-        if unused_validators:
-            fn = ', '.join(unused_validators)
-            raise ConfigError(
-                f"Validators defined with incorrect fields: {fn} "  # noqa: Q000
-                f"(use check_fields=False if you're inheriting from the model and intended this)"
-            )
-
-
-def extract_validators(namespace: Dict[str, Any]) -> Dict[str, List[Validator]]:
-    validators: Dict[str, List[Validator]] = {}
-    for var_name, value in namespace.items():
-        validator_config = getattr(value, VALIDATOR_CONFIG_KEY, None)
-        if validator_config:
-            fields, v = validator_config
-            for field in fields:
-                if field in validators:
-                    validators[field].append(v)
-                else:
-                    validators[field] = [v]
-    return validators
-
-
-def extract_root_validators(namespace: Dict[str, Any]) -> Tuple[List[AnyCallable], List[Tuple[bool, AnyCallable]]]:
-    from inspect import signature
-
-    pre_validators: List[AnyCallable] = []
-    post_validators: List[Tuple[bool, AnyCallable]] = []
-    for name, value in namespace.items():
-        validator_config: Optional[Validator] = getattr(value, ROOT_VALIDATOR_CONFIG_KEY, None)
-        if validator_config:
-            sig = signature(validator_config.func)
-            args = list(sig.parameters.keys())
-            if args[0] == 'self':
-                raise ConfigError(
-                    f'Invalid signature for root validator {name}: {sig}, "self" not permitted as first argument, '
-                    f'should be: (cls, values).'
-                )
-            if len(args) != 2:
-                raise ConfigError(f'Invalid signature for root validator {name}: {sig}, should be: (cls, values).')
-            # check function signature
-            if validator_config.pre:
-                pre_validators.append(validator_config.func)
-            else:
-                post_validators.append((validator_config.skip_on_failure, validator_config.func))
-    return pre_validators, post_validators
-
-
-def inherit_validators(base_validators: 'ValidatorListDict', validators: 'ValidatorListDict') -> 'ValidatorListDict':
-    for field, field_validators in base_validators.items():
-        if field not in validators:
-            validators[field] = []
-        validators[field] += field_validators
-    return validators
-
-
-def make_generic_validator(validator: AnyCallable) -> 'ValidatorCallable':
-    """
-    Make a generic function which calls a validator with the right arguments.
-
-    Unfortunately other approaches (eg. return a partial of a function that builds the arguments) is slow,
-    hence this laborious way of doing things.
-
-    It's done like this so validators don't all need **kwargs in their signature, eg. any combination of
-    the arguments "values", "fields" and/or "config" are permitted.
-    """
-    from inspect import signature
-
-    sig = signature(validator)
-    args = list(sig.parameters.keys())
-    first_arg = args.pop(0)
-    if first_arg == 'self':
-        raise ConfigError(
-            f'Invalid signature for validator {validator}: {sig}, "self" not permitted as first argument, '
-            f'should be: (cls, value, values, config, field), "values", "config" and "field" are all optional.'
-        )
-    elif first_arg == 'cls':
-        # assume the second argument is value
-        return wraps(validator)(_generic_validator_cls(validator, sig, set(args[1:])))
-    else:
-        # assume the first argument was value which has already been removed
-        return wraps(validator)(_generic_validator_basic(validator, sig, set(args)))
-
-
-def prep_validators(v_funcs: Iterable[AnyCallable]) -> 'ValidatorsList':
-    return [make_generic_validator(f) for f in v_funcs if f]
-
-
-all_kwargs = {'values', 'field', 'config'}
-
-
-def _generic_validator_cls(validator: AnyCallable, sig: 'Signature', args: Set[str]) -> 'ValidatorCallable':
-    # assume the first argument is value
-    has_kwargs = False
-    if 'kwargs' in args:
-        has_kwargs = True
-        args -= {'kwargs'}
-
-    if not args.issubset(all_kwargs):
-        raise ConfigError(
-            f'Invalid signature for validator {validator}: {sig}, should be: '
-            f'(cls, value, values, config, field), "values", "config" and "field" are all optional.'
-        )
-
-    if has_kwargs:
-        return lambda cls, v, values, field, config: validator(cls, v, values=values, field=field, config=config)
-    elif args == set():
-        return lambda cls, v, values, field, config: validator(cls, v)
-    elif args == {'values'}:
-        return lambda cls, v, values, field, config: validator(cls, v, values=values)
-    elif args == {'field'}:
-        return lambda cls, v, values, field, config: validator(cls, v, field=field)
-    elif args == {'config'}:
-        return lambda cls, v, values, field, config: validator(cls, v, config=config)
-    elif args == {'values', 'field'}:
-        return lambda cls, v, values, field, config: validator(cls, v, values=values, field=field)
-    elif args == {'values', 'config'}:
-        return lambda cls, v, values, field, config: validator(cls, v, values=values, config=config)
-    elif args == {'field', 'config'}:
-        return lambda cls, v, values, field, config: validator(cls, v, field=field, config=config)
-    else:
-        # args == {'values', 'field', 'config'}
-        return lambda cls, v, values, field, config: validator(cls, v, values=values, field=field, config=config)
-
-
-def _generic_validator_basic(validator: AnyCallable, sig: 'Signature', args: Set[str]) -> 'ValidatorCallable':
-    has_kwargs = False
-    if 'kwargs' in args:
-        has_kwargs = True
-        args -= {'kwargs'}
-
-    if not args.issubset(all_kwargs):
-        raise ConfigError(
-            f'Invalid signature for validator {validator}: {sig}, should be: '
-            f'(value, values, config, field), "values", "config" and "field" are all optional.'
-        )
-
-    if has_kwargs:
-        return lambda cls, v, values, field, config: validator(v, values=values, field=field, config=config)
-    elif args == set():
-        return lambda cls, v, values, field, config: validator(v)
-    elif args == {'values'}:
-        return lambda cls, v, values, field, config: validator(v, values=values)
-    elif args == {'field'}:
-        return lambda cls, v, values, field, config: validator(v, field=field)
-    elif args == {'config'}:
-        return lambda cls, v, values, field, config: validator(v, config=config)
-    elif args == {'values', 'field'}:
-        return lambda cls, v, values, field, config: validator(v, values=values, field=field)
-    elif args == {'values', 'config'}:
-        return lambda cls, v, values, field, config: validator(v, values=values, config=config)
-    elif args == {'field', 'config'}:
-        return lambda cls, v, values, field, config: validator(v, field=field, config=config)
-    else:
-        # args == {'values', 'field', 'config'}
-        return lambda cls, v, values, field, config: validator(v, values=values, field=field, config=config)
-
-
-def gather_all_validators(type_: 'ModelOrDc') -> Dict[str, 'AnyClassMethod']:
-    all_attributes = ChainMap(*[cls.__dict__ for cls in type_.__mro__])  # type: ignore[arg-type,var-annotated]
-    return {
-        k: v
-        for k, v in all_attributes.items()
-        if hasattr(v, VALIDATOR_CONFIG_KEY) or hasattr(v, ROOT_VALIDATOR_CONFIG_KEY)
-    }
+__getattr__ = getattr_migration(__name__)
diff --git a/lib/pydantic/color.py b/lib/pydantic/color.py
index 6fdc9fb1..108bb8fa 100644
--- a/lib/pydantic/color.py
+++ b/lib/pydantic/color.py
@@ -1,22 +1,28 @@
-"""
-Color definitions are  used as per CSS3 specification:
-http://www.w3.org/TR/css3-color/#svg-color
+"""Color definitions are used as per the CSS3
+[CSS Color Module Level 3](http://www.w3.org/TR/css3-color/#svg-color) specification.
 
 A few colors have multiple names referring to the sames colors, eg. `grey` and `gray` or `aqua` and `cyan`.
 
-In these cases the LAST color when sorted alphabetically takes preferences,
-eg. Color((0, 255, 255)).as_named() == 'cyan' because "cyan" comes after "aqua".
+In these cases the _last_ color when sorted alphabetically takes preferences,
+eg. `Color((0, 255, 255)).as_named() == 'cyan'` because "cyan" comes after "aqua".
+
+Warning: Deprecated
+    The `Color` class is deprecated, use `pydantic_extra_types` instead.
+    See [`pydantic-extra-types.Color`](../usage/types/extra_types/color_types.md)
+    for more information.
 """
 import math
 import re
 from colorsys import hls_to_rgb, rgb_to_hls
-from typing import TYPE_CHECKING, Any, Dict, Optional, Tuple, Union, cast
+from typing import Any, Callable, Optional, Tuple, Type, Union, cast
 
-from .errors import ColorError
-from .utils import Representation, almost_equal_floats
+from pydantic_core import CoreSchema, PydanticCustomError, core_schema
+from typing_extensions import deprecated
 
-if TYPE_CHECKING:
-    from .typing import CallableGenerator, ReprArgs
+from ._internal import _repr
+from ._internal._schema_generation_shared import GetJsonSchemaHandler as _GetJsonSchemaHandler
+from .json_schema import JsonSchemaValue
+from .warnings import PydanticDeprecatedSince20
 
 ColorTuple = Union[Tuple[int, int, int], Tuple[int, int, int, float]]
 ColorType = Union[ColorTuple, str]
@@ -24,9 +30,7 @@ HslColorTuple = Union[Tuple[float, float, float], Tuple[float, float, float, flo
 
 
 class RGBA:
-    """
-    Internal use only as a representation of a color.
-    """
+    """Internal use only as a representation of a color."""
 
     __slots__ = 'r', 'g', 'b', 'alpha', '_tuple'
 
@@ -43,24 +47,35 @@ class RGBA:
 
 
 # these are not compiled here to avoid import slowdown, they'll be compiled the first time they're used, then cached
-r_hex_short = r'\s*(?:#|0x)?([0-9a-f])([0-9a-f])([0-9a-f])([0-9a-f])?\s*'
-r_hex_long = r'\s*(?:#|0x)?([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})?\s*'
 _r_255 = r'(\d{1,3}(?:\.\d+)?)'
 _r_comma = r'\s*,\s*'
-r_rgb = fr'\s*rgb\(\s*{_r_255}{_r_comma}{_r_255}{_r_comma}{_r_255}\)\s*'
 _r_alpha = r'(\d(?:\.\d+)?|\.\d+|\d{1,2}%)'
-r_rgba = fr'\s*rgba\(\s*{_r_255}{_r_comma}{_r_255}{_r_comma}{_r_255}{_r_comma}{_r_alpha}\s*\)\s*'
 _r_h = r'(-?\d+(?:\.\d+)?|-?\.\d+)(deg|rad|turn)?'
 _r_sl = r'(\d{1,3}(?:\.\d+)?)%'
-r_hsl = fr'\s*hsl\(\s*{_r_h}{_r_comma}{_r_sl}{_r_comma}{_r_sl}\s*\)\s*'
-r_hsla = fr'\s*hsl\(\s*{_r_h}{_r_comma}{_r_sl}{_r_comma}{_r_sl}{_r_comma}{_r_alpha}\s*\)\s*'
+r_hex_short = r'\s*(?:#|0x)?([0-9a-f])([0-9a-f])([0-9a-f])([0-9a-f])?\s*'
+r_hex_long = r'\s*(?:#|0x)?([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})?\s*'
+# CSS3 RGB examples: rgb(0, 0, 0), rgba(0, 0, 0, 0.5), rgba(0, 0, 0, 50%)
+r_rgb = rf'\s*rgba?\(\s*{_r_255}{_r_comma}{_r_255}{_r_comma}{_r_255}(?:{_r_comma}{_r_alpha})?\s*\)\s*'
+# CSS3 HSL examples: hsl(270, 60%, 50%), hsla(270, 60%, 50%, 0.5), hsla(270, 60%, 50%, 50%)
+r_hsl = rf'\s*hsla?\(\s*{_r_h}{_r_comma}{_r_sl}{_r_comma}{_r_sl}(?:{_r_comma}{_r_alpha})?\s*\)\s*'
+# CSS4 RGB examples: rgb(0 0 0), rgb(0 0 0 / 0.5), rgb(0 0 0 / 50%), rgba(0 0 0 / 50%)
+r_rgb_v4_style = rf'\s*rgba?\(\s*{_r_255}\s+{_r_255}\s+{_r_255}(?:\s*/\s*{_r_alpha})?\s*\)\s*'
+# CSS4 HSL examples: hsl(270 60% 50%), hsl(270 60% 50% / 0.5), hsl(270 60% 50% / 50%), hsla(270 60% 50% / 50%)
+r_hsl_v4_style = rf'\s*hsla?\(\s*{_r_h}\s+{_r_sl}\s+{_r_sl}(?:\s*/\s*{_r_alpha})?\s*\)\s*'
 
 # colors where the two hex characters are the same, if all colors match this the short version of hex colors can be used
 repeat_colors = {int(c * 2, 16) for c in '0123456789abcdef'}
 rads = 2 * math.pi
 
 
-class Color(Representation):
+@deprecated(
+    'The `Color` class is deprecated, use `pydantic_extra_types` instead. '
+    'See https://docs.pydantic.dev/latest/api/pydantic_extra_types_color/.',
+    category=PydanticDeprecatedSince20,
+)
+class Color(_repr.Representation):
+    """Represents a color."""
+
     __slots__ = '_original', '_rgba'
 
     def __init__(self, value: ColorType) -> None:
@@ -74,22 +89,39 @@ class Color(Representation):
             self._rgba = value._rgba
             value = value._original
         else:
-            raise ColorError(reason='value must be a tuple, list or string')
+            raise PydanticCustomError(
+                'color_error', 'value is not a valid color: value must be a tuple, list or string'
+            )
 
         # if we've got here value must be a valid color
         self._original = value
 
     @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+    def __get_pydantic_json_schema__(
+        cls, core_schema: core_schema.CoreSchema, handler: _GetJsonSchemaHandler
+    ) -> JsonSchemaValue:
+        field_schema = {}
         field_schema.update(type='string', format='color')
+        return field_schema
 
     def original(self) -> ColorType:
-        """
-        Original value passed to Color
-        """
+        """Original value passed to `Color`."""
         return self._original
 
     def as_named(self, *, fallback: bool = False) -> str:
+        """Returns the name of the color if it can be found in `COLORS_BY_VALUE` dictionary,
+        otherwise returns the hexadecimal representation of the color or raises `ValueError`.
+
+        Args:
+            fallback: If True, falls back to returning the hexadecimal representation of
+                the color instead of raising a ValueError when no named color is found.
+
+        Returns:
+            The name of the color, or the hexadecimal representation of the color.
+
+        Raises:
+            ValueError: When no named color is found and fallback is `False`.
+        """
         if self._rgba.alpha is None:
             rgb = cast(Tuple[int, int, int], self.as_rgb_tuple())
             try:
@@ -103,9 +135,13 @@ class Color(Representation):
             return self.as_hex()
 
     def as_hex(self) -> str:
-        """
-        Hex string representing the color can be 3, 4, 6 or 8 characters depending on whether the string
+        """Returns the hexadecimal representation of the color.
+
+        Hex string representing the color can be 3, 4, 6, or 8 characters depending on whether the string
         a "short" representation of the color is possible and whether there's an alpha channel.
+
+        Returns:
+            The hexadecimal representation of the color.
         """
         values = [float_to_255(c) for c in self._rgba[:3]]
         if self._rgba.alpha is not None:
@@ -117,9 +153,7 @@ class Color(Representation):
         return '#' + as_hex
 
     def as_rgb(self) -> str:
-        """
-        Color as an rgb(<r>, <g>, <b>) or rgba(<r>, <g>, <b>, <a>) string.
-        """
+        """Color as an `rgb(<r>, <g>, <b>)` or `rgba(<r>, <g>, <b>, <a>)` string."""
         if self._rgba.alpha is None:
             return f'rgb({float_to_255(self._rgba.r)}, {float_to_255(self._rgba.g)}, {float_to_255(self._rgba.b)})'
         else:
@@ -129,14 +163,18 @@ class Color(Representation):
             )
 
     def as_rgb_tuple(self, *, alpha: Optional[bool] = None) -> ColorTuple:
-        """
-        Color as an RGB or RGBA tuple; red, green and blue are in the range 0 to 255, alpha if included is
-        in the range 0 to 1.
+        """Returns the color as an RGB or RGBA tuple.
 
-        :param alpha: whether to include the alpha channel, options are
-          None - (default) include alpha only if it's set (e.g. not None)
-          True - always include alpha,
-          False - always omit alpha,
+        Args:
+            alpha: Whether to include the alpha channel. There are three options for this input:
+
+                - `None` (default): Include alpha only if it's set. (e.g. not `None`)
+                - `True`: Always include alpha.
+                - `False`: Always omit alpha.
+
+        Returns:
+            A tuple that contains the values of the red, green, and blue channels in the range 0 to 255.
+                If alpha is included, it is in the range 0 to 1.
         """
         r, g, b = (float_to_255(c) for c in self._rgba[:3])
         if alpha is None:
@@ -151,9 +189,7 @@ class Color(Representation):
             return r, g, b
 
     def as_hsl(self) -> str:
-        """
-        Color as an hsl(<h>, <s>, <l>) or hsl(<h>, <s>, <l>, <a>) string.
-        """
+        """Color as an `hsl(<h>, <s>, <l>)` or `hsl(<h>, <s>, <l>, <a>)` string."""
         if self._rgba.alpha is None:
             h, s, li = self.as_hsl_tuple(alpha=False)  # type: ignore
             return f'hsl({h * 360:0.0f}, {s:0.0%}, {li:0.0%})'
@@ -162,18 +198,23 @@ class Color(Representation):
             return f'hsl({h * 360:0.0f}, {s:0.0%}, {li:0.0%}, {round(a, 2)})'
 
     def as_hsl_tuple(self, *, alpha: Optional[bool] = None) -> HslColorTuple:
-        """
-        Color as an HSL or HSLA tuple, e.g. hue, saturation, lightness and optionally alpha; all elements are in
-        the range 0 to 1.
+        """Returns the color as an HSL or HSLA tuple.
 
-        NOTE: this is HSL as used in HTML and most other places, not HLS as used in python's colorsys.
+        Args:
+            alpha: Whether to include the alpha channel.
 
-        :param alpha: whether to include the alpha channel, options are
-          None - (default) include alpha only if it's set (e.g. not None)
-          True - always include alpha,
-          False - always omit alpha,
+                - `None` (default): Include the alpha channel only if it's set (e.g. not `None`).
+                - `True`: Always include alpha.
+                - `False`: Always omit alpha.
+
+        Returns:
+            The color as a tuple of hue, saturation, lightness, and alpha (if included).
+                All elements are in the range 0 to 1.
+
+        Note:
+            This is HSL as used in HTML and most other places, not HLS as used in Python's `colorsys`.
         """
-        h, l, s = rgb_to_hls(self._rgba.r, self._rgba.g, self._rgba.b)
+        h, l, s = rgb_to_hls(self._rgba.r, self._rgba.g, self._rgba.b)  # noqa: E741
         if alpha is None:
             if self._rgba.alpha is None:
                 return h, s, l
@@ -189,14 +230,22 @@ class Color(Representation):
         return 1 if self._rgba.alpha is None else self._rgba.alpha
 
     @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield cls
+    def __get_pydantic_core_schema__(
+        cls, source: Type[Any], handler: Callable[[Any], CoreSchema]
+    ) -> core_schema.CoreSchema:
+        return core_schema.with_info_plain_validator_function(
+            cls._validate, serialization=core_schema.to_string_ser_schema()
+        )
+
+    @classmethod
+    def _validate(cls, __input_value: Any, _: Any) -> 'Color':
+        return cls(__input_value)
 
     def __str__(self) -> str:
         return self.as_named(fallback=True)
 
-    def __repr_args__(self) -> 'ReprArgs':
-        return [(None, self.as_named(fallback=True))] + [('rgb', self.as_rgb_tuple())]  # type: ignore
+    def __repr_args__(self) -> '_repr.ReprArgs':
+        return [(None, self.as_named(fallback=True))] + [('rgb', self.as_rgb_tuple())]
 
     def __eq__(self, other: Any) -> bool:
         return isinstance(other, Color) and self.as_rgb_tuple() == other.as_rgb_tuple()
@@ -206,8 +255,16 @@ class Color(Representation):
 
 
 def parse_tuple(value: Tuple[Any, ...]) -> RGBA:
-    """
-    Parse a tuple or list as a color.
+    """Parse a tuple or list to get RGBA values.
+
+    Args:
+        value: A tuple or list.
+
+    Returns:
+        An `RGBA` tuple parsed from the input tuple.
+
+    Raises:
+        PydanticCustomError: If tuple is not valid.
     """
     if len(value) == 3:
         r, g, b = (parse_color_value(v) for v in value)
@@ -216,17 +273,28 @@ def parse_tuple(value: Tuple[Any, ...]) -> RGBA:
         r, g, b = (parse_color_value(v) for v in value[:3])
         return RGBA(r, g, b, parse_float_alpha(value[3]))
     else:
-        raise ColorError(reason='tuples must have length 3 or 4')
+        raise PydanticCustomError('color_error', 'value is not a valid color: tuples must have length 3 or 4')
 
 
 def parse_str(value: str) -> RGBA:
-    """
-    Parse a string to an RGBA tuple, trying the following formats (in this order):
-    * named color, see COLORS_BY_NAME below
+    """Parse a string representing a color to an RGBA tuple.
+
+    Possible formats for the input string include:
+
+    * named color, see `COLORS_BY_NAME`
     * hex short eg. `<prefix>fff` (prefix can be `#`, `0x` or nothing)
     * hex long eg. `<prefix>ffffff` (prefix can be `#`, `0x` or nothing)
-    * `rgb(<r>, <g>, <b>) `
+    * `rgb(<r>, <g>, <b>)`
     * `rgba(<r>, <g>, <b>, <a>)`
+
+    Args:
+        value: A string representing a color.
+
+    Returns:
+        An `RGBA` tuple parsed from the input string.
+
+    Raises:
+        ValueError: If the input string cannot be parsed to an RGBA tuple.
     """
     value_lower = value.lower()
     try:
@@ -256,49 +324,70 @@ def parse_str(value: str) -> RGBA:
             alpha = None
         return ints_to_rgba(r, g, b, alpha)
 
-    m = re.fullmatch(r_rgb, value_lower)
-    if m:
-        return ints_to_rgba(*m.groups(), None)  # type: ignore
-
-    m = re.fullmatch(r_rgba, value_lower)
+    m = re.fullmatch(r_rgb, value_lower) or re.fullmatch(r_rgb_v4_style, value_lower)
     if m:
         return ints_to_rgba(*m.groups())  # type: ignore
 
-    m = re.fullmatch(r_hsl, value_lower)
+    m = re.fullmatch(r_hsl, value_lower) or re.fullmatch(r_hsl_v4_style, value_lower)
     if m:
-        h, h_units, s, l_ = m.groups()
-        return parse_hsl(h, h_units, s, l_)
+        return parse_hsl(*m.groups())  # type: ignore
 
-    m = re.fullmatch(r_hsla, value_lower)
-    if m:
-        h, h_units, s, l_, a = m.groups()
-        return parse_hsl(h, h_units, s, l_, parse_float_alpha(a))
-
-    raise ColorError(reason='string not recognised as a valid color')
+    raise PydanticCustomError('color_error', 'value is not a valid color: string not recognised as a valid color')
 
 
-def ints_to_rgba(r: Union[int, str], g: Union[int, str], b: Union[int, str], alpha: Optional[float]) -> RGBA:
+def ints_to_rgba(r: Union[int, str], g: Union[int, str], b: Union[int, str], alpha: Optional[float] = None) -> RGBA:
+    """Converts integer or string values for RGB color and an optional alpha value to an `RGBA` object.
+
+    Args:
+        r: An integer or string representing the red color value.
+        g: An integer or string representing the green color value.
+        b: An integer or string representing the blue color value.
+        alpha: A float representing the alpha value. Defaults to None.
+
+    Returns:
+        An instance of the `RGBA` class with the corresponding color and alpha values.
+    """
     return RGBA(parse_color_value(r), parse_color_value(g), parse_color_value(b), parse_float_alpha(alpha))
 
 
 def parse_color_value(value: Union[int, str], max_val: int = 255) -> float:
-    """
-    Parse a value checking it's a valid int in the range 0 to max_val and divide by max_val to give a number
-    in the range 0 to 1
+    """Parse the color value provided and return a number between 0 and 1.
+
+    Args:
+        value: An integer or string color value.
+        max_val: Maximum range value. Defaults to 255.
+
+    Raises:
+        PydanticCustomError: If the value is not a valid color.
+
+    Returns:
+        A number between 0 and 1.
     """
     try:
         color = float(value)
     except ValueError:
-        raise ColorError(reason='color values must be a valid number')
+        raise PydanticCustomError('color_error', 'value is not a valid color: color values must be a valid number')
     if 0 <= color <= max_val:
         return color / max_val
     else:
-        raise ColorError(reason=f'color values must be in the range 0 to {max_val}')
+        raise PydanticCustomError(
+            'color_error',
+            'value is not a valid color: color values must be in the range 0 to {max_val}',
+            {'max_val': max_val},
+        )
 
 
 def parse_float_alpha(value: Union[None, str, float, int]) -> Optional[float]:
-    """
-    Parse a value checking it's a valid float in the range 0 to 1
+    """Parse an alpha value checking it's a valid float in the range 0 to 1.
+
+    Args:
+        value: The input value to parse.
+
+    Returns:
+        The parsed value as a float, or `None` if the value was None or equal 1.
+
+    Raises:
+        PydanticCustomError: If the input value cannot be successfully parsed as a float in the expected range.
     """
     if value is None:
         return None
@@ -308,19 +397,28 @@ def parse_float_alpha(value: Union[None, str, float, int]) -> Optional[float]:
         else:
             alpha = float(value)
     except ValueError:
-        raise ColorError(reason='alpha values must be a valid float')
+        raise PydanticCustomError('color_error', 'value is not a valid color: alpha values must be a valid float')
 
-    if almost_equal_floats(alpha, 1):
+    if math.isclose(alpha, 1):
         return None
     elif 0 <= alpha <= 1:
         return alpha
     else:
-        raise ColorError(reason='alpha values must be in the range 0 to 1')
+        raise PydanticCustomError('color_error', 'value is not a valid color: alpha values must be in the range 0 to 1')
 
 
 def parse_hsl(h: str, h_units: str, sat: str, light: str, alpha: Optional[float] = None) -> RGBA:
-    """
-    Parse raw hue, saturation, lightness and alpha values and convert to RGBA.
+    """Parse raw hue, saturation, lightness, and alpha values and convert to RGBA.
+
+    Args:
+        h: The hue value.
+        h_units: The unit for hue value.
+        sat: The saturation value.
+        light: The lightness value.
+        alpha: Alpha value.
+
+    Returns:
+        An instance of `RGBA`.
     """
     s_value, l_value = parse_color_value(sat, 100), parse_color_value(light, 100)
 
@@ -334,10 +432,21 @@ def parse_hsl(h: str, h_units: str, sat: str, light: str, alpha: Optional[float]
         h_value = h_value % 1
 
     r, g, b = hls_to_rgb(h_value, l_value, s_value)
-    return RGBA(r, g, b, alpha)
+    return RGBA(r, g, b, parse_float_alpha(alpha))
 
 
 def float_to_255(c: float) -> int:
+    """Converts a float value between 0 and 1 (inclusive) to an integer between 0 and 255 (inclusive).
+
+    Args:
+        c: The float value to be converted. Must be between 0 and 1 (inclusive).
+
+    Returns:
+        The integer equivalent of the given float value rounded to the nearest whole number.
+
+    Raises:
+        ValueError: If the given float value is outside the acceptable range of 0 to 1 (inclusive).
+    """
     return int(round(c * 255))
 
 
diff --git a/lib/pydantic/config.py b/lib/pydantic/config.py
index 74687ca0..6b22586b 100644
--- a/lib/pydantic/config.py
+++ b/lib/pydantic/config.py
@@ -1,192 +1,912 @@
-import json
-from enum import Enum
-from typing import TYPE_CHECKING, Any, Callable, Dict, ForwardRef, Optional, Tuple, Type, Union
+"""Configuration for Pydantic models."""
+from __future__ import annotations as _annotations
 
-from typing_extensions import Literal, Protocol
+from typing import TYPE_CHECKING, Any, Callable, Dict, List, Type, Union
 
-from .typing import AnyArgTCallable, AnyCallable
-from .utils import GetterDict
-from .version import compiled
+from typing_extensions import Literal, TypeAlias, TypedDict
+
+from ._migration import getattr_migration
+from .aliases import AliasGenerator
 
 if TYPE_CHECKING:
-    from typing import overload
+    from ._internal._generate_schema import GenerateSchema as _GenerateSchema
 
-    from .fields import ModelField
-    from .main import BaseModel
-
-    ConfigType = Type['BaseConfig']
-
-    class SchemaExtraCallable(Protocol):
-        @overload
-        def __call__(self, schema: Dict[str, Any]) -> None:
-            pass
-
-        @overload
-        def __call__(self, schema: Dict[str, Any], model_class: Type[BaseModel]) -> None:
-            pass
-
-else:
-    SchemaExtraCallable = Callable[..., None]
-
-__all__ = 'BaseConfig', 'ConfigDict', 'get_config', 'Extra', 'inherit_config', 'prepare_config'
+__all__ = ('ConfigDict',)
 
 
-class Extra(str, Enum):
-    allow = 'allow'
-    ignore = 'ignore'
-    forbid = 'forbid'
+JsonValue: TypeAlias = Union[int, float, str, bool, None, List['JsonValue'], 'JsonDict']
+JsonDict: TypeAlias = Dict[str, JsonValue]
+
+JsonEncoder = Callable[[Any], Any]
+
+JsonSchemaExtraCallable: TypeAlias = Union[
+    Callable[[JsonDict], None],
+    Callable[[JsonDict, Type[Any]], None],
+]
+
+ExtraValues = Literal['allow', 'ignore', 'forbid']
 
 
-# https://github.com/cython/cython/issues/4003
-# Will be fixed with Cython 3 but still in alpha right now
-if not compiled:
-    from typing_extensions import TypedDict
+class ConfigDict(TypedDict, total=False):
+    """A TypedDict for configuring Pydantic behaviour."""
 
-    class ConfigDict(TypedDict, total=False):
-        title: Optional[str]
-        anystr_lower: bool
-        anystr_strip_whitespace: bool
-        min_anystr_length: int
-        max_anystr_length: Optional[int]
-        validate_all: bool
-        extra: Extra
-        allow_mutation: bool
-        frozen: bool
-        allow_population_by_field_name: bool
-        use_enum_values: bool
-        fields: Dict[str, Union[str, Dict[str, str]]]
-        validate_assignment: bool
-        error_msg_templates: Dict[str, str]
-        arbitrary_types_allowed: bool
-        orm_mode: bool
-        getter_dict: Type[GetterDict]
-        alias_generator: Optional[Callable[[str], str]]
-        keep_untouched: Tuple[type, ...]
-        schema_extra: Union[Dict[str, object], 'SchemaExtraCallable']
-        json_loads: Callable[[str], object]
-        json_dumps: AnyArgTCallable[str]
-        json_encoders: Dict[Type[object], AnyCallable]
-        underscore_attrs_are_private: bool
-        allow_inf_nan: bool
+    title: str | None
+    """The title for the generated JSON schema, defaults to the model's name"""
 
-        # whether or not inherited models as fields should be reconstructed as base model
-        copy_on_model_validation: bool
-        # whether dataclass `__post_init__` should be run after validation
-        post_init_call: Literal['before_validation', 'after_validation']
+    str_to_lower: bool
+    """Whether to convert all characters to lowercase for str types. Defaults to `False`."""
 
-else:
-    ConfigDict = dict  # type: ignore
+    str_to_upper: bool
+    """Whether to convert all characters to uppercase for str types. Defaults to `False`."""
+    str_strip_whitespace: bool
+    """Whether to strip leading and trailing whitespace for str types."""
+
+    str_min_length: int
+    """The minimum length for str types. Defaults to `None`."""
+
+    str_max_length: int | None
+    """The maximum length for str types. Defaults to `None`."""
+
+    extra: ExtraValues | None
+    """
+    Whether to ignore, allow, or forbid extra attributes during model initialization. Defaults to `'ignore'`.
+
+    You can configure how pydantic handles the attributes that are not defined in the model:
+
+    * `allow` - Allow any extra attributes.
+    * `forbid` - Forbid any extra attributes.
+    * `ignore` - Ignore any extra attributes.
+
+    ```py
+    from pydantic import BaseModel, ConfigDict
 
 
-class BaseConfig:
-    title: Optional[str] = None
-    anystr_lower: bool = False
-    anystr_upper: bool = False
-    anystr_strip_whitespace: bool = False
-    min_anystr_length: int = 0
-    max_anystr_length: Optional[int] = None
-    validate_all: bool = False
-    extra: Extra = Extra.ignore
-    allow_mutation: bool = True
-    frozen: bool = False
-    allow_population_by_field_name: bool = False
-    use_enum_values: bool = False
-    fields: Dict[str, Union[str, Dict[str, str]]] = {}
-    validate_assignment: bool = False
-    error_msg_templates: Dict[str, str] = {}
-    arbitrary_types_allowed: bool = False
-    orm_mode: bool = False
-    getter_dict: Type[GetterDict] = GetterDict
-    alias_generator: Optional[Callable[[str], str]] = None
-    keep_untouched: Tuple[type, ...] = ()
-    schema_extra: Union[Dict[str, Any], 'SchemaExtraCallable'] = {}
-    json_loads: Callable[[str], Any] = json.loads
-    json_dumps: Callable[..., str] = json.dumps
-    json_encoders: Dict[Union[Type[Any], str, ForwardRef], AnyCallable] = {}
-    underscore_attrs_are_private: bool = False
-    allow_inf_nan: bool = True
+    class User(BaseModel):
+        model_config = ConfigDict(extra='ignore')  # (1)!
 
-    # whether inherited models as fields should be reconstructed as base model,
-    # and whether such a copy should be shallow or deep
-    copy_on_model_validation: Literal['none', 'deep', 'shallow'] = 'shallow'
-
-    # whether `Union` should check all allowed types before even trying to coerce
-    smart_union: bool = False
-    # whether dataclass `__post_init__` should be run before or after validation
-    post_init_call: Literal['before_validation', 'after_validation'] = 'before_validation'
-
-    @classmethod
-    def get_field_info(cls, name: str) -> Dict[str, Any]:
-        """
-        Get properties of FieldInfo from the `fields` property of the config class.
-        """
-
-        fields_value = cls.fields.get(name)
-
-        if isinstance(fields_value, str):
-            field_info: Dict[str, Any] = {'alias': fields_value}
-        elif isinstance(fields_value, dict):
-            field_info = fields_value
-        else:
-            field_info = {}
-
-        if 'alias' in field_info:
-            field_info.setdefault('alias_priority', 2)
-
-        if field_info.get('alias_priority', 0) <= 1 and cls.alias_generator:
-            alias = cls.alias_generator(name)
-            if not isinstance(alias, str):
-                raise TypeError(f'Config.alias_generator must return str, not {alias.__class__}')
-            field_info.update(alias=alias, alias_priority=1)
-        return field_info
-
-    @classmethod
-    def prepare_field(cls, field: 'ModelField') -> None:
-        """
-        Optional hook to check or modify fields during model creation.
-        """
-        pass
+        name: str
 
 
-def get_config(config: Union[ConfigDict, Type[object], None]) -> Type[BaseConfig]:
-    if config is None:
-        return BaseConfig
+    user = User(name='John Doe', age=20)  # (2)!
+    print(user)
+    #> name='John Doe'
+    ```
 
-    else:
-        config_dict = (
-            config
-            if isinstance(config, dict)
-            else {k: getattr(config, k) for k in dir(config) if not k.startswith('__')}
+    1. This is the default behaviour.
+    2. The `age` argument is ignored.
+
+    Instead, with `extra='allow'`, the `age` argument is included:
+
+    ```py
+    from pydantic import BaseModel, ConfigDict
+
+
+    class User(BaseModel):
+        model_config = ConfigDict(extra='allow')
+
+        name: str
+
+
+    user = User(name='John Doe', age=20)  # (1)!
+    print(user)
+    #> name='John Doe' age=20
+    ```
+
+    1. The `age` argument is included.
+
+    With `extra='forbid'`, an error is raised:
+
+    ```py
+    from pydantic import BaseModel, ConfigDict, ValidationError
+
+
+    class User(BaseModel):
+        model_config = ConfigDict(extra='forbid')
+
+        name: str
+
+
+    try:
+        User(name='John Doe', age=20)
+    except ValidationError as e:
+        print(e)
+        '''
+        1 validation error for User
+        age
+        Extra inputs are not permitted [type=extra_forbidden, input_value=20, input_type=int]
+        '''
+    ```
+    """
+
+    frozen: bool
+    """
+    Whether models are faux-immutable, i.e. whether `__setattr__` is allowed, and also generates
+    a `__hash__()` method for the model. This makes instances of the model potentially hashable if all the
+    attributes are hashable. Defaults to `False`.
+
+    Note:
+        On V1, the inverse of this setting was called `allow_mutation`, and was `True` by default.
+    """
+
+    populate_by_name: bool
+    """
+    Whether an aliased field may be populated by its name as given by the model
+    attribute, as well as the alias. Defaults to `False`.
+
+    Note:
+        The name of this configuration setting was changed in **v2.0** from
+        `allow_population_by_field_name` to `populate_by_name`.
+
+    ```py
+    from pydantic import BaseModel, ConfigDict, Field
+
+
+    class User(BaseModel):
+        model_config = ConfigDict(populate_by_name=True)
+
+        name: str = Field(alias='full_name')  # (1)!
+        age: int
+
+
+    user = User(full_name='John Doe', age=20)  # (2)!
+    print(user)
+    #> name='John Doe' age=20
+    user = User(name='John Doe', age=20)  # (3)!
+    print(user)
+    #> name='John Doe' age=20
+    ```
+
+    1. The field `'name'` has an alias `'full_name'`.
+    2. The model is populated by the alias `'full_name'`.
+    3. The model is populated by the field name `'name'`.
+    """
+
+    use_enum_values: bool
+    """
+    Whether to populate models with the `value` property of enums, rather than the raw enum.
+    This may be useful if you want to serialize `model.model_dump()` later. Defaults to `False`.
+
+    !!! note
+        If you have an `Optional[Enum]` value that you set a default for, you need to use `validate_default=True`
+        for said Field to ensure that the `use_enum_values` flag takes effect on the default, as extracting an
+        enum's value occurs during validation, not serialization.
+
+    ```py
+    from enum import Enum
+    from typing import Optional
+
+    from pydantic import BaseModel, ConfigDict, Field
+
+
+    class SomeEnum(Enum):
+        FOO = 'foo'
+        BAR = 'bar'
+        BAZ = 'baz'
+
+
+    class SomeModel(BaseModel):
+        model_config = ConfigDict(use_enum_values=True)
+
+        some_enum: SomeEnum
+        another_enum: Optional[SomeEnum] = Field(default=SomeEnum.FOO, validate_default=True)
+
+
+    model1 = SomeModel(some_enum=SomeEnum.BAR)
+    print(model1.model_dump())
+    # {'some_enum': 'bar', 'another_enum': 'foo'}
+
+    model2 = SomeModel(some_enum=SomeEnum.BAR, another_enum=SomeEnum.BAZ)
+    print(model2.model_dump())
+    #> {'some_enum': 'bar', 'another_enum': 'baz'}
+    ```
+    """
+
+    validate_assignment: bool
+    """
+    Whether to validate the data when the model is changed. Defaults to `False`.
+
+    The default behavior of Pydantic is to validate the data when the model is created.
+
+    In case the user changes the data after the model is created, the model is _not_ revalidated.
+
+    ```py
+    from pydantic import BaseModel
+
+    class User(BaseModel):
+        name: str
+
+    user = User(name='John Doe')  # (1)!
+    print(user)
+    #> name='John Doe'
+    user.name = 123  # (1)!
+    print(user)
+    #> name=123
+    ```
+
+    1. The validation happens only when the model is created.
+    2. The validation does not happen when the data is changed.
+
+    In case you want to revalidate the model when the data is changed, you can use `validate_assignment=True`:
+
+    ```py
+    from pydantic import BaseModel, ValidationError
+
+    class User(BaseModel, validate_assignment=True):  # (1)!
+        name: str
+
+    user = User(name='John Doe')  # (2)!
+    print(user)
+    #> name='John Doe'
+    try:
+        user.name = 123  # (3)!
+    except ValidationError as e:
+        print(e)
+        '''
+        1 validation error for User
+        name
+          Input should be a valid string [type=string_type, input_value=123, input_type=int]
+        '''
+    ```
+
+    1. You can either use class keyword arguments, or `model_config` to set `validate_assignment=True`.
+    2. The validation happens when the model is created.
+    3. The validation _also_ happens when the data is changed.
+    """
+
+    arbitrary_types_allowed: bool
+    """
+    Whether arbitrary types are allowed for field types. Defaults to `False`.
+
+    ```py
+    from pydantic import BaseModel, ConfigDict, ValidationError
+
+    # This is not a pydantic model, it's an arbitrary class
+    class Pet:
+        def __init__(self, name: str):
+            self.name = name
+
+    class Model(BaseModel):
+        model_config = ConfigDict(arbitrary_types_allowed=True)
+
+        pet: Pet
+        owner: str
+
+    pet = Pet(name='Hedwig')
+    # A simple check of instance type is used to validate the data
+    model = Model(owner='Harry', pet=pet)
+    print(model)
+    #> pet=<__main__.Pet object at 0x0123456789ab> owner='Harry'
+    print(model.pet)
+    #> <__main__.Pet object at 0x0123456789ab>
+    print(model.pet.name)
+    #> Hedwig
+    print(type(model.pet))
+    #> <class '__main__.Pet'>
+    try:
+        # If the value is not an instance of the type, it's invalid
+        Model(owner='Harry', pet='Hedwig')
+    except ValidationError as e:
+        print(e)
+        '''
+        1 validation error for Model
+        pet
+          Input should be an instance of Pet [type=is_instance_of, input_value='Hedwig', input_type=str]
+        '''
+
+    # Nothing in the instance of the arbitrary type is checked
+    # Here name probably should have been a str, but it's not validated
+    pet2 = Pet(name=42)
+    model2 = Model(owner='Harry', pet=pet2)
+    print(model2)
+    #> pet=<__main__.Pet object at 0x0123456789ab> owner='Harry'
+    print(model2.pet)
+    #> <__main__.Pet object at 0x0123456789ab>
+    print(model2.pet.name)
+    #> 42
+    print(type(model2.pet))
+    #> <class '__main__.Pet'>
+    ```
+    """
+
+    from_attributes: bool
+    """
+    Whether to build models and look up discriminators of tagged unions using python object attributes.
+    """
+
+    loc_by_alias: bool
+    """Whether to use the actual key provided in the data (e.g. alias) for error `loc`s rather than the field's name. Defaults to `True`."""
+
+    alias_generator: Callable[[str], str] | AliasGenerator | None
+    """
+    A callable that takes a field name and returns an alias for it
+    or an instance of [`AliasGenerator`][pydantic.aliases.AliasGenerator]. Defaults to `None`.
+
+    When using a callable, the alias generator is used for both validation and serialization.
+    If you want to use different alias generators for validation and serialization, you can use
+    [`AliasGenerator`][pydantic.aliases.AliasGenerator] instead.
+
+    If data source field names do not match your code style (e. g. CamelCase fields),
+    you can automatically generate aliases using `alias_generator`. Here's an example with
+    a basic callable:
+
+    ```py
+    from pydantic import BaseModel, ConfigDict
+    from pydantic.alias_generators import to_pascal
+
+    class Voice(BaseModel):
+        model_config = ConfigDict(alias_generator=to_pascal)
+
+        name: str
+        language_code: str
+
+    voice = Voice(Name='Filiz', LanguageCode='tr-TR')
+    print(voice.language_code)
+    #> tr-TR
+    print(voice.model_dump(by_alias=True))
+    #> {'Name': 'Filiz', 'LanguageCode': 'tr-TR'}
+    ```
+
+    If you want to use different alias generators for validation and serialization, you can use
+    [`AliasGenerator`][pydantic.aliases.AliasGenerator].
+
+    ```py
+    from pydantic import AliasGenerator, BaseModel, ConfigDict
+    from pydantic.alias_generators import to_camel, to_pascal
+
+    class Athlete(BaseModel):
+        first_name: str
+        last_name: str
+        sport: str
+
+        model_config = ConfigDict(
+            alias_generator=AliasGenerator(
+                validation_alias=to_camel,
+                serialization_alias=to_pascal,
+            )
         )
 
-        class Config(BaseConfig):
-            ...
+    athlete = Athlete(firstName='John', lastName='Doe', sport='track')
+    print(athlete.model_dump(by_alias=True))
+    #> {'FirstName': 'John', 'LastName': 'Doe', 'Sport': 'track'}
+    ```
 
-        for k, v in config_dict.items():
-            setattr(Config, k, v)
-        return Config
+    Note:
+        Pydantic offers three built-in alias generators: [`to_pascal`][pydantic.alias_generators.to_pascal],
+        [`to_camel`][pydantic.alias_generators.to_camel], and [`to_snake`][pydantic.alias_generators.to_snake].
+    """
 
+    ignored_types: tuple[type, ...]
+    """A tuple of types that may occur as values of class attributes without annotations. This is
+    typically used for custom descriptors (classes that behave like `property`). If an attribute is set on a
+    class without an annotation and has a type that is not in this tuple (or otherwise recognized by
+    _pydantic_), an error will be raised. Defaults to `()`.
+    """
 
-def inherit_config(self_config: 'ConfigType', parent_config: 'ConfigType', **namespace: Any) -> 'ConfigType':
-    if not self_config:
-        base_classes: Tuple['ConfigType', ...] = (parent_config,)
-    elif self_config == parent_config:
-        base_classes = (self_config,)
-    else:
-        base_classes = self_config, parent_config
+    allow_inf_nan: bool
+    """Whether to allow infinity (`+inf` an `-inf`) and NaN values to float fields. Defaults to `True`."""
 
-    namespace['json_encoders'] = {
-        **getattr(parent_config, 'json_encoders', {}),
-        **getattr(self_config, 'json_encoders', {}),
-        **namespace.get('json_encoders', {}),
+    json_schema_extra: JsonDict | JsonSchemaExtraCallable | None
+    """A dict or callable to provide extra JSON schema properties. Defaults to `None`."""
+
+    json_encoders: dict[type[object], JsonEncoder] | None
+    """
+    A `dict` of custom JSON encoders for specific types. Defaults to `None`.
+
+    !!! warning "Deprecated"
+        This config option is a carryover from v1.
+        We originally planned to remove it in v2 but didn't have a 1:1 replacement so we are keeping it for now.
+        It is still deprecated and will likely be removed in the future.
+    """
+
+    # new in V2
+    strict: bool
+    """
+    _(new in V2)_ If `True`, strict validation is applied to all fields on the model.
+
+    By default, Pydantic attempts to coerce values to the correct type, when possible.
+
+    There are situations in which you may want to disable this behavior, and instead raise an error if a value's type
+    does not match the field's type annotation.
+
+    To configure strict mode for all fields on a model, you can set `strict=True` on the model.
+
+    ```py
+    from pydantic import BaseModel, ConfigDict
+
+    class Model(BaseModel):
+        model_config = ConfigDict(strict=True)
+
+        name: str
+        age: int
+    ```
+
+    See [Strict Mode](../concepts/strict_mode.md) for more details.
+
+    See the [Conversion Table](../concepts/conversion_table.md) for more details on how Pydantic converts data in both
+    strict and lax modes.
+    """
+    # whether instances of models and dataclasses (including subclass instances) should re-validate, default 'never'
+    revalidate_instances: Literal['always', 'never', 'subclass-instances']
+    """
+    When and how to revalidate models and dataclasses during validation. Accepts the string
+    values of `'never'`, `'always'` and `'subclass-instances'`. Defaults to `'never'`.
+
+    - `'never'` will not revalidate models and dataclasses during validation
+    - `'always'` will revalidate models and dataclasses during validation
+    - `'subclass-instances'` will revalidate models and dataclasses during validation if the instance is a
+        subclass of the model or dataclass
+
+    By default, model and dataclass instances are not revalidated during validation.
+
+    ```py
+    from typing import List
+
+    from pydantic import BaseModel
+
+    class User(BaseModel, revalidate_instances='never'):  # (1)!
+        hobbies: List[str]
+
+    class SubUser(User):
+        sins: List[str]
+
+    class Transaction(BaseModel):
+        user: User
+
+    my_user = User(hobbies=['reading'])
+    t = Transaction(user=my_user)
+    print(t)
+    #> user=User(hobbies=['reading'])
+
+    my_user.hobbies = [1]  # (2)!
+    t = Transaction(user=my_user)  # (3)!
+    print(t)
+    #> user=User(hobbies=[1])
+
+    my_sub_user = SubUser(hobbies=['scuba diving'], sins=['lying'])
+    t = Transaction(user=my_sub_user)
+    print(t)
+    #> user=SubUser(hobbies=['scuba diving'], sins=['lying'])
+    ```
+
+    1. `revalidate_instances` is set to `'never'` by **default.
+    2. The assignment is not validated, unless you set `validate_assignment` to `True` in the model's config.
+    3. Since `revalidate_instances` is set to `never`, this is not revalidated.
+
+    If you want to revalidate instances during validation, you can set `revalidate_instances` to `'always'`
+    in the model's config.
+
+    ```py
+    from typing import List
+
+    from pydantic import BaseModel, ValidationError
+
+    class User(BaseModel, revalidate_instances='always'):  # (1)!
+        hobbies: List[str]
+
+    class SubUser(User):
+        sins: List[str]
+
+    class Transaction(BaseModel):
+        user: User
+
+    my_user = User(hobbies=['reading'])
+    t = Transaction(user=my_user)
+    print(t)
+    #> user=User(hobbies=['reading'])
+
+    my_user.hobbies = [1]
+    try:
+        t = Transaction(user=my_user)  # (2)!
+    except ValidationError as e:
+        print(e)
+        '''
+        1 validation error for Transaction
+        user.hobbies.0
+          Input should be a valid string [type=string_type, input_value=1, input_type=int]
+        '''
+
+    my_sub_user = SubUser(hobbies=['scuba diving'], sins=['lying'])
+    t = Transaction(user=my_sub_user)
+    print(t)  # (3)!
+    #> user=User(hobbies=['scuba diving'])
+    ```
+
+    1. `revalidate_instances` is set to `'always'`.
+    2. The model is revalidated, since `revalidate_instances` is set to `'always'`.
+    3. Using `'never'` we would have gotten `user=SubUser(hobbies=['scuba diving'], sins=['lying'])`.
+
+    It's also possible to set `revalidate_instances` to `'subclass-instances'` to only revalidate instances
+    of subclasses of the model.
+
+    ```py
+    from typing import List
+
+    from pydantic import BaseModel
+
+    class User(BaseModel, revalidate_instances='subclass-instances'):  # (1)!
+        hobbies: List[str]
+
+    class SubUser(User):
+        sins: List[str]
+
+    class Transaction(BaseModel):
+        user: User
+
+    my_user = User(hobbies=['reading'])
+    t = Transaction(user=my_user)
+    print(t)
+    #> user=User(hobbies=['reading'])
+
+    my_user.hobbies = [1]
+    t = Transaction(user=my_user)  # (2)!
+    print(t)
+    #> user=User(hobbies=[1])
+
+    my_sub_user = SubUser(hobbies=['scuba diving'], sins=['lying'])
+    t = Transaction(user=my_sub_user)
+    print(t)  # (3)!
+    #> user=User(hobbies=['scuba diving'])
+    ```
+
+    1. `revalidate_instances` is set to `'subclass-instances'`.
+    2. This is not revalidated, since `my_user` is not a subclass of `User`.
+    3. Using `'never'` we would have gotten `user=SubUser(hobbies=['scuba diving'], sins=['lying'])`.
+    """
+
+    ser_json_timedelta: Literal['iso8601', 'float']
+    """
+    The format of JSON serialized timedeltas. Accepts the string values of `'iso8601'` and
+    `'float'`. Defaults to `'iso8601'`.
+
+    - `'iso8601'` will serialize timedeltas to ISO 8601 durations.
+    - `'float'` will serialize timedeltas to the total number of seconds.
+    """
+
+    ser_json_bytes: Literal['utf8', 'base64']
+    """
+    The encoding of JSON serialized bytes. Accepts the string values of `'utf8'` and `'base64'`.
+    Defaults to `'utf8'`.
+
+    - `'utf8'` will serialize bytes to UTF-8 strings.
+    - `'base64'` will serialize bytes to URL safe base64 strings.
+    """
+
+    ser_json_inf_nan: Literal['null', 'constants']
+    """
+    The encoding of JSON serialized infinity and NaN float values. Accepts the string values of `'null'` and `'constants'`.
+    Defaults to `'null'`.
+
+    - `'null'` will serialize infinity and NaN values as `null`.
+    - `'constants'` will serialize infinity and NaN values as `Infinity` and `NaN`.
+    """
+
+    # whether to validate default values during validation, default False
+    validate_default: bool
+    """Whether to validate default values during validation. Defaults to `False`."""
+
+    validate_return: bool
+    """whether to validate the return value from call validators. Defaults to `False`."""
+
+    protected_namespaces: tuple[str, ...]
+    """
+    A `tuple` of strings that prevent model to have field which conflict with them.
+    Defaults to `('model_', )`).
+
+    Pydantic prevents collisions between model attributes and `BaseModel`'s own methods by
+    namespacing them with the prefix `model_`.
+
+    ```py
+    import warnings
+
+    from pydantic import BaseModel
+
+    warnings.filterwarnings('error')  # Raise warnings as errors
+
+    try:
+
+        class Model(BaseModel):
+            model_prefixed_field: str
+
+    except UserWarning as e:
+        print(e)
+        '''
+        Field "model_prefixed_field" has conflict with protected namespace "model_".
+
+        You may be able to resolve this warning by setting `model_config['protected_namespaces'] = ()`.
+        '''
+    ```
+
+    You can customize this behavior using the `protected_namespaces` setting:
+
+    ```py
+    import warnings
+
+    from pydantic import BaseModel, ConfigDict
+
+    warnings.filterwarnings('error')  # Raise warnings as errors
+
+    try:
+
+        class Model(BaseModel):
+            model_prefixed_field: str
+            also_protect_field: str
+
+            model_config = ConfigDict(
+                protected_namespaces=('protect_me_', 'also_protect_')
+            )
+
+    except UserWarning as e:
+        print(e)
+        '''
+        Field "also_protect_field" has conflict with protected namespace "also_protect_".
+
+        You may be able to resolve this warning by setting `model_config['protected_namespaces'] = ('protect_me_',)`.
+        '''
+    ```
+
+    While Pydantic will only emit a warning when an item is in a protected namespace but does not actually have a collision,
+    an error _is_ raised if there is an actual collision with an existing attribute:
+
+    ```py
+    from pydantic import BaseModel
+
+    try:
+
+        class Model(BaseModel):
+            model_validate: str
+
+    except NameError as e:
+        print(e)
+        '''
+        Field "model_validate" conflicts with member <bound method BaseModel.model_validate of <class 'pydantic.main.BaseModel'>> of protected namespace "model_".
+        '''
+    ```
+    """
+
+    hide_input_in_errors: bool
+    """
+    Whether to hide inputs when printing errors. Defaults to `False`.
+
+    Pydantic shows the input value and type when it raises `ValidationError` during the validation.
+
+    ```py
+    from pydantic import BaseModel, ValidationError
+
+    class Model(BaseModel):
+        a: str
+
+    try:
+        Model(a=123)
+    except ValidationError as e:
+        print(e)
+        '''
+        1 validation error for Model
+        a
+          Input should be a valid string [type=string_type, input_value=123, input_type=int]
+        '''
+    ```
+
+    You can hide the input value and type by setting the `hide_input_in_errors` config to `True`.
+
+    ```py
+    from pydantic import BaseModel, ConfigDict, ValidationError
+
+    class Model(BaseModel):
+        a: str
+        model_config = ConfigDict(hide_input_in_errors=True)
+
+    try:
+        Model(a=123)
+    except ValidationError as e:
+        print(e)
+        '''
+        1 validation error for Model
+        a
+          Input should be a valid string [type=string_type]
+        '''
+    ```
+    """
+
+    defer_build: bool
+    """
+    Whether to defer model validator and serializer construction until the first model validation.
+
+    This can be useful to avoid the overhead of building models which are only
+    used nested within other models, or when you want to manually define type namespace via
+    [`Model.model_rebuild(_types_namespace=...)`][pydantic.BaseModel.model_rebuild]. Defaults to False.
+    """
+
+    plugin_settings: dict[str, object] | None
+    """A `dict` of settings for plugins. Defaults to `None`.
+
+    See [Pydantic Plugins](../concepts/plugins.md) for details.
+    """
+
+    schema_generator: type[_GenerateSchema] | None
+    """
+    A custom core schema generator class to use when generating JSON schemas.
+    Useful if you want to change the way types are validated across an entire model/schema. Defaults to `None`.
+
+    The `GenerateSchema` interface is subject to change, currently only the `string_schema` method is public.
+
+    See [#6737](https://github.com/pydantic/pydantic/pull/6737) for details.
+    """
+
+    json_schema_serialization_defaults_required: bool
+    """
+    Whether fields with default values should be marked as required in the serialization schema. Defaults to `False`.
+
+    This ensures that the serialization schema will reflect the fact a field with a default will always be present
+    when serializing the model, even though it is not required for validation.
+
+    However, there are scenarios where this may be undesirable — in particular, if you want to share the schema
+    between validation and serialization, and don't mind fields with defaults being marked as not required during
+    serialization. See [#7209](https://github.com/pydantic/pydantic/issues/7209) for more details.
+
+    ```py
+    from pydantic import BaseModel, ConfigDict
+
+    class Model(BaseModel):
+        a: str = 'a'
+
+        model_config = ConfigDict(json_schema_serialization_defaults_required=True)
+
+    print(Model.model_json_schema(mode='validation'))
+    '''
+    {
+        'properties': {'a': {'default': 'a', 'title': 'A', 'type': 'string'}},
+        'title': 'Model',
+        'type': 'object',
     }
+    '''
+    print(Model.model_json_schema(mode='serialization'))
+    '''
+    {
+        'properties': {'a': {'default': 'a', 'title': 'A', 'type': 'string'}},
+        'required': ['a'],
+        'title': 'Model',
+        'type': 'object',
+    }
+    '''
+    ```
+    """
 
-    return type('Config', base_classes, namespace)
+    json_schema_mode_override: Literal['validation', 'serialization', None]
+    """
+    If not `None`, the specified mode will be used to generate the JSON schema regardless of what `mode` was passed to
+    the function call. Defaults to `None`.
+
+    This provides a way to force the JSON schema generation to reflect a specific mode, e.g., to always use the
+    validation schema.
+
+    It can be useful when using frameworks (such as FastAPI) that may generate different schemas for validation
+    and serialization that must both be referenced from the same schema; when this happens, we automatically append
+    `-Input` to the definition reference for the validation schema and `-Output` to the definition reference for the
+    serialization schema. By specifying a `json_schema_mode_override` though, this prevents the conflict between
+    the validation and serialization schemas (since both will use the specified schema), and so prevents the suffixes
+    from being added to the definition references.
+
+    ```py
+    from pydantic import BaseModel, ConfigDict, Json
+
+    class Model(BaseModel):
+        a: Json[int]  # requires a string to validate, but will dump an int
+
+    print(Model.model_json_schema(mode='serialization'))
+    '''
+    {
+        'properties': {'a': {'title': 'A', 'type': 'integer'}},
+        'required': ['a'],
+        'title': 'Model',
+        'type': 'object',
+    }
+    '''
+
+    class ForceInputModel(Model):
+        # the following ensures that even with mode='serialization', we
+        # will get the schema that would be generated for validation.
+        model_config = ConfigDict(json_schema_mode_override='validation')
+
+    print(ForceInputModel.model_json_schema(mode='serialization'))
+    '''
+    {
+        'properties': {
+            'a': {
+                'contentMediaType': 'application/json',
+                'contentSchema': {'type': 'integer'},
+                'title': 'A',
+                'type': 'string',
+            }
+        },
+        'required': ['a'],
+        'title': 'ForceInputModel',
+        'type': 'object',
+    }
+    '''
+    ```
+    """
+
+    coerce_numbers_to_str: bool
+    """
+    If `True`, enables automatic coercion of any `Number` type to `str` in "lax" (non-strict) mode. Defaults to `False`.
+
+    Pydantic doesn't allow number types (`int`, `float`, `Decimal`) to be coerced as type `str` by default.
+
+    ```py
+    from decimal import Decimal
+
+    from pydantic import BaseModel, ConfigDict, ValidationError
+
+    class Model(BaseModel):
+        value: str
+
+    try:
+        print(Model(value=42))
+    except ValidationError as e:
+        print(e)
+        '''
+        1 validation error for Model
+        value
+          Input should be a valid string [type=string_type, input_value=42, input_type=int]
+        '''
+
+    class Model(BaseModel):
+        model_config = ConfigDict(coerce_numbers_to_str=True)
+
+        value: str
+
+    repr(Model(value=42).value)
+    #> "42"
+    repr(Model(value=42.13).value)
+    #> "42.13"
+    repr(Model(value=Decimal('42.13')).value)
+    #> "42.13"
+    ```
+    """
+
+    regex_engine: Literal['rust-regex', 'python-re']
+    """
+    The regex engine to used for pattern validation
+    Defaults to `'rust-regex'`.
+
+    - `rust-regex` uses the [`regex`](https://docs.rs/regex) Rust crate,
+      which is non-backtracking and therefore more DDoS resistant, but does not support all regex features.
+    - `python-re` use the [`re`](https://docs.python.org/3/library/re.html) module,
+      which supports all regex features, but may be slower.
+
+    ```py
+    from pydantic import BaseModel, ConfigDict, Field, ValidationError
+
+    class Model(BaseModel):
+        model_config = ConfigDict(regex_engine='python-re')
+
+        value: str = Field(pattern=r'^abc(?=def)')
+
+    print(Model(value='abcdef').value)
+    #> abcdef
+
+    try:
+        print(Model(value='abxyzcdef'))
+    except ValidationError as e:
+        print(e)
+        '''
+        1 validation error for Model
+        value
+          String should match pattern '^abc(?=def)' [type=string_pattern_mismatch, input_value='abxyzcdef', input_type=str]
+        '''
+    ```
+    """
+
+    validation_error_cause: bool
+    """
+    If `True`, python exceptions that were part of a validation failure will be shown as an exception group as a cause. Can be useful for debugging. Defaults to `False`.
+
+    Note:
+        Python 3.10 and older don't support exception groups natively. <=3.10, backport must be installed: `pip install exceptiongroup`.
+
+    Note:
+        The structure of validation errors are likely to change in future pydantic versions. Pydantic offers no guarantees about the structure of validation errors. Should be used for visual traceback debugging only.
+    """
 
 
-def prepare_config(config: Type[BaseConfig], cls_name: str) -> None:
-    if not isinstance(config.extra, Extra):
-        try:
-            config.extra = Extra(config.extra)
-        except ValueError:
-            raise ValueError(f'"{cls_name}": {config.extra} is not a valid value for "extra"')
+__getattr__ = getattr_migration(__name__)
diff --git a/lib/pydantic/dataclasses.py b/lib/pydantic/dataclasses.py
index 68331127..d9c9c903 100644
--- a/lib/pydantic/dataclasses.py
+++ b/lib/pydantic/dataclasses.py
@@ -1,479 +1,327 @@
-"""
-The main purpose is to enhance stdlib dataclasses by adding validation
-A pydantic dataclass can be generated from scratch or from a stdlib one.
+"""Provide an enhanced dataclass that performs validation."""
+from __future__ import annotations as _annotations
 
-Behind the scene, a pydantic dataclass is just like a regular one on which we attach
-a `BaseModel` and magic methods to trigger the validation of the data.
-`__init__` and `__post_init__` are hence overridden and have extra logic to be
-able to validate input data.
-
-When a pydantic dataclass is generated from scratch, it's just a plain dataclass
-with validation triggered at initialization
-
-The tricky part if for stdlib dataclasses that are converted after into pydantic ones e.g.
-
-```py
-@dataclasses.dataclass
-class M:
-    x: int
-
-ValidatedM = pydantic.dataclasses.dataclass(M)
-```
-
-We indeed still want to support equality, hashing, repr, ... as if it was the stdlib one!
-
-```py
-assert isinstance(ValidatedM(x=1), M)
-assert ValidatedM(x=1) == M(x=1)
-```
-
-This means we **don't want to create a new dataclass that inherits from it**
-The trick is to create a wrapper around `M` that will act as a proxy to trigger
-validation without altering default `M` behaviour.
-"""
+import dataclasses
 import sys
-from contextlib import contextmanager
-from functools import wraps
-from typing import (
-    TYPE_CHECKING,
-    Any,
-    Callable,
-    ClassVar,
-    Dict,
-    Generator,
-    Optional,
-    Set,
-    Type,
-    TypeVar,
-    Union,
-    overload,
-)
+import types
+from typing import TYPE_CHECKING, Any, Callable, Generic, NoReturn, TypeVar, overload
 
-from typing_extensions import dataclass_transform
+from typing_extensions import Literal, TypeGuard, dataclass_transform
 
-from .class_validators import gather_all_validators
-from .config import BaseConfig, ConfigDict, Extra, get_config
-from .error_wrappers import ValidationError
-from .errors import DataclassTypeError
-from .fields import Field, FieldInfo, Required, Undefined
-from .main import create_model, validate_model
-from .utils import ClassAttribute
+from ._internal import _config, _decorators, _typing_extra
+from ._internal import _dataclasses as _pydantic_dataclasses
+from ._migration import getattr_migration
+from .config import ConfigDict
+from .fields import Field, FieldInfo
 
 if TYPE_CHECKING:
-    from .main import BaseModel
-    from .typing import CallableGenerator, NoArgAnyCallable
+    from ._internal._dataclasses import PydanticDataclass
 
-    DataclassT = TypeVar('DataclassT', bound='Dataclass')
-
-    DataclassClassOrWrapper = Union[Type['Dataclass'], 'DataclassProxy']
-
-    class Dataclass:
-        # stdlib attributes
-        __dataclass_fields__: ClassVar[Dict[str, Any]]
-        __dataclass_params__: ClassVar[Any]  # in reality `dataclasses._DataclassParams`
-        __post_init__: ClassVar[Callable[..., None]]
-
-        # Added by pydantic
-        __pydantic_run_validation__: ClassVar[bool]
-        __post_init_post_parse__: ClassVar[Callable[..., None]]
-        __pydantic_initialised__: ClassVar[bool]
-        __pydantic_model__: ClassVar[Type[BaseModel]]
-        __pydantic_validate_values__: ClassVar[Callable[['Dataclass'], None]]
-        __pydantic_has_field_info_default__: ClassVar[bool]  # whether a `pydantic.Field` is used as default value
-
-        def __init__(self, *args: object, **kwargs: object) -> None:
-            pass
-
-        @classmethod
-        def __get_validators__(cls: Type['Dataclass']) -> 'CallableGenerator':
-            pass
-
-        @classmethod
-        def __validate__(cls: Type['DataclassT'], v: Any) -> 'DataclassT':
-            pass
-
-
-__all__ = [
-    'dataclass',
-    'set_validation',
-    'create_pydantic_model_from_dataclass',
-    'is_builtin_dataclass',
-    'make_dataclass_validator',
-]
+__all__ = 'dataclass', 'rebuild_dataclass'
 
 _T = TypeVar('_T')
 
 if sys.version_info >= (3, 10):
 
-    @dataclass_transform(kw_only_default=True, field_descriptors=(Field, FieldInfo))
+    @dataclass_transform(field_specifiers=(dataclasses.field, Field))
     @overload
     def dataclass(
         *,
-        init: bool = True,
+        init: Literal[False] = False,
         repr: bool = True,
         eq: bool = True,
         order: bool = False,
         unsafe_hash: bool = False,
         frozen: bool = False,
-        config: Union[ConfigDict, Type[object], None] = None,
-        validate_on_init: Optional[bool] = None,
+        config: ConfigDict | type[object] | None = None,
+        validate_on_init: bool | None = None,
         kw_only: bool = ...,
-    ) -> Callable[[Type[_T]], 'DataclassClassOrWrapper']:
+        slots: bool = ...,
+    ) -> Callable[[type[_T]], type[PydanticDataclass]]:  # type: ignore
         ...
 
-    @dataclass_transform(kw_only_default=True, field_descriptors=(Field, FieldInfo))
+    @dataclass_transform(field_specifiers=(dataclasses.field, Field))
     @overload
     def dataclass(
-        _cls: Type[_T],
+        _cls: type[_T],  # type: ignore
         *,
-        init: bool = True,
+        init: Literal[False] = False,
         repr: bool = True,
         eq: bool = True,
         order: bool = False,
         unsafe_hash: bool = False,
         frozen: bool = False,
-        config: Union[ConfigDict, Type[object], None] = None,
-        validate_on_init: Optional[bool] = None,
+        config: ConfigDict | type[object] | None = None,
+        validate_on_init: bool | None = None,
         kw_only: bool = ...,
-    ) -> 'DataclassClassOrWrapper':
+        slots: bool = ...,
+    ) -> type[PydanticDataclass]:
         ...
 
 else:
 
-    @dataclass_transform(kw_only_default=True, field_descriptors=(Field, FieldInfo))
+    @dataclass_transform(field_specifiers=(dataclasses.field, Field))
     @overload
     def dataclass(
         *,
-        init: bool = True,
+        init: Literal[False] = False,
         repr: bool = True,
         eq: bool = True,
         order: bool = False,
         unsafe_hash: bool = False,
         frozen: bool = False,
-        config: Union[ConfigDict, Type[object], None] = None,
-        validate_on_init: Optional[bool] = None,
-    ) -> Callable[[Type[_T]], 'DataclassClassOrWrapper']:
+        config: ConfigDict | type[object] | None = None,
+        validate_on_init: bool | None = None,
+    ) -> Callable[[type[_T]], type[PydanticDataclass]]:  # type: ignore
         ...
 
-    @dataclass_transform(kw_only_default=True, field_descriptors=(Field, FieldInfo))
+    @dataclass_transform(field_specifiers=(dataclasses.field, Field))
     @overload
     def dataclass(
-        _cls: Type[_T],
+        _cls: type[_T],  # type: ignore
         *,
-        init: bool = True,
+        init: Literal[False] = False,
         repr: bool = True,
         eq: bool = True,
         order: bool = False,
         unsafe_hash: bool = False,
         frozen: bool = False,
-        config: Union[ConfigDict, Type[object], None] = None,
-        validate_on_init: Optional[bool] = None,
-    ) -> 'DataclassClassOrWrapper':
+        config: ConfigDict | type[object] | None = None,
+        validate_on_init: bool | None = None,
+    ) -> type[PydanticDataclass]:
         ...
 
 
-@dataclass_transform(kw_only_default=True, field_descriptors=(Field, FieldInfo))
-def dataclass(
-    _cls: Optional[Type[_T]] = None,
+@dataclass_transform(field_specifiers=(dataclasses.field, Field))
+def dataclass(  # noqa: C901
+    _cls: type[_T] | None = None,
     *,
-    init: bool = True,
+    init: Literal[False] = False,
     repr: bool = True,
     eq: bool = True,
     order: bool = False,
     unsafe_hash: bool = False,
     frozen: bool = False,
-    config: Union[ConfigDict, Type[object], None] = None,
-    validate_on_init: Optional[bool] = None,
+    config: ConfigDict | type[object] | None = None,
+    validate_on_init: bool | None = None,
     kw_only: bool = False,
-) -> Union[Callable[[Type[_T]], 'DataclassClassOrWrapper'], 'DataclassClassOrWrapper']:
+    slots: bool = False,
+) -> Callable[[type[_T]], type[PydanticDataclass]] | type[PydanticDataclass]:
+    """Usage docs: https://docs.pydantic.dev/2.6/concepts/dataclasses/
+
+    A decorator used to create a Pydantic-enhanced dataclass, similar to the standard Python `dataclass`,
+    but with added validation.
+
+    This function should be used similarly to `dataclasses.dataclass`.
+
+    Args:
+        _cls: The target `dataclass`.
+        init: Included for signature compatibility with `dataclasses.dataclass`, and is passed through to
+            `dataclasses.dataclass` when appropriate. If specified, must be set to `False`, as pydantic inserts its
+            own  `__init__` function.
+        repr: A boolean indicating whether to include the field in the `__repr__` output.
+        eq: Determines if a `__eq__` method should be generated for the class.
+        order: Determines if comparison magic methods should be generated, such as `__lt__`, but not `__eq__`.
+        unsafe_hash: Determines if a `__hash__` method should be included in the class, as in `dataclasses.dataclass`.
+        frozen: Determines if the generated class should be a 'frozen' `dataclass`, which does not allow its
+            attributes to be modified after it has been initialized.
+        config: The Pydantic config to use for the `dataclass`.
+        validate_on_init: A deprecated parameter included for backwards compatibility; in V2, all Pydantic dataclasses
+            are validated on init.
+        kw_only: Determines if `__init__` method parameters must be specified by keyword only. Defaults to `False`.
+        slots: Determines if the generated class should be a 'slots' `dataclass`, which does not allow the addition of
+            new attributes after instantiation.
+
+    Returns:
+        A decorator that accepts a class as its argument and returns a Pydantic `dataclass`.
+
+    Raises:
+        AssertionError: Raised if `init` is not `False` or `validate_on_init` is `False`.
     """
-    Like the python standard lib dataclasses but with type validation.
-    The result is either a pydantic dataclass that will validate input data
-    or a wrapper that will trigger validation around a stdlib dataclass
-    to avoid modifying it directly
-    """
-    the_config = get_config(config)
+    assert init is False, 'pydantic.dataclasses.dataclass only supports init=False'
+    assert validate_on_init is not False, 'validate_on_init=False is no longer supported'
 
-    def wrap(cls: Type[Any]) -> 'DataclassClassOrWrapper':
-        import dataclasses
+    if sys.version_info >= (3, 10):
+        kwargs = dict(kw_only=kw_only, slots=slots)
+    else:
+        kwargs = {}
 
-        if is_builtin_dataclass(cls) and _extra_dc_args(_cls) == _extra_dc_args(_cls.__bases__[0]):  # type: ignore
-            dc_cls_doc = ''
-            dc_cls = DataclassProxy(cls)
-            default_validate_on_init = False
-        else:
-            dc_cls_doc = cls.__doc__ or ''  # needs to be done before generating dataclass
-            if sys.version_info >= (3, 10):
-                dc_cls = dataclasses.dataclass(
-                    cls,
-                    init=init,
-                    repr=repr,
-                    eq=eq,
-                    order=order,
-                    unsafe_hash=unsafe_hash,
-                    frozen=frozen,
-                    kw_only=kw_only,
-                )
-            else:
-                dc_cls = dataclasses.dataclass(  # type: ignore
-                    cls, init=init, repr=repr, eq=eq, order=order, unsafe_hash=unsafe_hash, frozen=frozen
-                )
-            default_validate_on_init = True
+    def make_pydantic_fields_compatible(cls: type[Any]) -> None:
+        """Make sure that stdlib `dataclasses` understands `Field` kwargs like `kw_only`
+        To do that, we simply change
+          `x: int = pydantic.Field(..., kw_only=True)`
+        into
+          `x: int = dataclasses.field(default=pydantic.Field(..., kw_only=True), kw_only=True)`
+        """
+        for annotation_cls in cls.__mro__:
+            # In Python < 3.9, `__annotations__` might not be present if there are no fields.
+            # we therefore need to use `getattr` to avoid an `AttributeError`.
+            annotations = getattr(annotation_cls, '__annotations__', [])
+            for field_name in annotations:
+                field_value = getattr(cls, field_name, None)
+                # Process only if this is an instance of `FieldInfo`.
+                if not isinstance(field_value, FieldInfo):
+                    continue
 
-        should_validate_on_init = default_validate_on_init if validate_on_init is None else validate_on_init
-        _add_pydantic_validation_attributes(cls, the_config, should_validate_on_init, dc_cls_doc)
-        dc_cls.__pydantic_model__.__try_update_forward_refs__(**{cls.__name__: cls})
-        return dc_cls
+                # Initialize arguments for the standard `dataclasses.field`.
+                field_args: dict = {'default': field_value}
+
+                # Handle `kw_only` for Python 3.10+
+                if sys.version_info >= (3, 10) and field_value.kw_only:
+                    field_args['kw_only'] = True
+
+                # Set `repr` attribute if it's explicitly specified to be not `True`.
+                if field_value.repr is not True:
+                    field_args['repr'] = field_value.repr
+
+                setattr(cls, field_name, dataclasses.field(**field_args))
+                # In Python 3.8, dataclasses checks cls.__dict__['__annotations__'] for annotations,
+                # so we must make sure it's initialized before we add to it.
+                if cls.__dict__.get('__annotations__') is None:
+                    cls.__annotations__ = {}
+                cls.__annotations__[field_name] = annotations[field_name]
+
+    def create_dataclass(cls: type[Any]) -> type[PydanticDataclass]:
+        """Create a Pydantic dataclass from a regular dataclass.
+
+        Args:
+            cls: The class to create the Pydantic dataclass from.
+
+        Returns:
+            A Pydantic dataclass.
+        """
+        original_cls = cls
+
+        config_dict = config
+        if config_dict is None:
+            # if not explicitly provided, read from the type
+            cls_config = getattr(cls, '__pydantic_config__', None)
+            if cls_config is not None:
+                config_dict = cls_config
+        config_wrapper = _config.ConfigWrapper(config_dict)
+        decorators = _decorators.DecoratorInfos.build(cls)
+
+        # Keep track of the original __doc__ so that we can restore it after applying the dataclasses decorator
+        # Otherwise, classes with no __doc__ will have their signature added into the JSON schema description,
+        # since dataclasses.dataclass will set this as the __doc__
+        original_doc = cls.__doc__
+
+        if _pydantic_dataclasses.is_builtin_dataclass(cls):
+            # Don't preserve the docstring for vanilla dataclasses, as it may include the signature
+            # This matches v1 behavior, and there was an explicit test for it
+            original_doc = None
+
+            # We don't want to add validation to the existing std lib dataclass, so we will subclass it
+            #   If the class is generic, we need to make sure the subclass also inherits from Generic
+            #   with all the same parameters.
+            bases = (cls,)
+            if issubclass(cls, Generic):
+                generic_base = Generic[cls.__parameters__]  # type: ignore
+                bases = bases + (generic_base,)
+            cls = types.new_class(cls.__name__, bases)
+
+        make_pydantic_fields_compatible(cls)
+
+        cls = dataclasses.dataclass(  # type: ignore[call-overload]
+            cls,
+            # the value of init here doesn't affect anything except that it makes it easier to generate a signature
+            init=True,
+            repr=repr,
+            eq=eq,
+            order=order,
+            unsafe_hash=unsafe_hash,
+            frozen=frozen,
+            **kwargs,
+        )
+
+        cls.__pydantic_decorators__ = decorators  # type: ignore
+        cls.__doc__ = original_doc
+        cls.__module__ = original_cls.__module__
+        cls.__qualname__ = original_cls.__qualname__
+        pydantic_complete = _pydantic_dataclasses.complete_dataclass(
+            cls, config_wrapper, raise_errors=False, types_namespace=None
+        )
+        cls.__pydantic_complete__ = pydantic_complete  # type: ignore
+        return cls
 
     if _cls is None:
-        return wrap
+        return create_dataclass
 
-    return wrap(_cls)
+    return create_dataclass(_cls)
 
 
-@contextmanager
-def set_validation(cls: Type['DataclassT'], value: bool) -> Generator[Type['DataclassT'], None, None]:
-    original_run_validation = cls.__pydantic_run_validation__
-    try:
-        cls.__pydantic_run_validation__ = value
-        yield cls
-    finally:
-        cls.__pydantic_run_validation__ = original_run_validation
+__getattr__ = getattr_migration(__name__)
+
+if (3, 8) <= sys.version_info < (3, 11):
+    # Monkeypatch dataclasses.InitVar so that typing doesn't error if it occurs as a type when evaluating type hints
+    # Starting in 3.11, typing.get_type_hints will not raise an error if the retrieved type hints are not callable.
+
+    def _call_initvar(*args: Any, **kwargs: Any) -> NoReturn:
+        """This function does nothing but raise an error that is as similar as possible to what you'd get
+        if you were to try calling `InitVar[int]()` without this monkeypatch. The whole purpose is just
+        to ensure typing._type_check does not error if the type hint evaluates to `InitVar[<parameter>]`.
+        """
+        raise TypeError("'InitVar' object is not callable")
+
+    dataclasses.InitVar.__call__ = _call_initvar
 
 
-class DataclassProxy:
-    __slots__ = '__dataclass__'
+def rebuild_dataclass(
+    cls: type[PydanticDataclass],
+    *,
+    force: bool = False,
+    raise_errors: bool = True,
+    _parent_namespace_depth: int = 2,
+    _types_namespace: dict[str, Any] | None = None,
+) -> bool | None:
+    """Try to rebuild the pydantic-core schema for the dataclass.
 
-    def __init__(self, dc_cls: Type['Dataclass']) -> None:
-        object.__setattr__(self, '__dataclass__', dc_cls)
+    This may be necessary when one of the annotations is a ForwardRef which could not be resolved during
+    the initial attempt to build the schema, and automatic rebuilding fails.
 
-    def __call__(self, *args: Any, **kwargs: Any) -> Any:
-        with set_validation(self.__dataclass__, True):
-            return self.__dataclass__(*args, **kwargs)
+    This is analogous to `BaseModel.model_rebuild`.
 
-    def __getattr__(self, name: str) -> Any:
-        return getattr(self.__dataclass__, name)
+    Args:
+        cls: The class to rebuild the pydantic-core schema for.
+        force: Whether to force the rebuilding of the schema, defaults to `False`.
+        raise_errors: Whether to raise errors, defaults to `True`.
+        _parent_namespace_depth: The depth level of the parent namespace, defaults to 2.
+        _types_namespace: The types namespace, defaults to `None`.
 
-    def __instancecheck__(self, instance: Any) -> bool:
-        return isinstance(instance, self.__dataclass__)
-
-
-def _add_pydantic_validation_attributes(  # noqa: C901 (ignore complexity)
-    dc_cls: Type['Dataclass'],
-    config: Type[BaseConfig],
-    validate_on_init: bool,
-    dc_cls_doc: str,
-) -> None:
+    Returns:
+        Returns `None` if the schema is already "complete" and rebuilding was not required.
+        If rebuilding _was_ required, returns `True` if rebuilding was successful, otherwise `False`.
     """
-    We need to replace the right method. If no `__post_init__` has been set in the stdlib dataclass
-    it won't even exist (code is generated on the fly by `dataclasses`)
-    By default, we run validation after `__init__` or `__post_init__` if defined
-    """
-    init = dc_cls.__init__
-
-    @wraps(init)
-    def handle_extra_init(self: 'Dataclass', *args: Any, **kwargs: Any) -> None:
-        if config.extra == Extra.ignore:
-            init(self, *args, **{k: v for k, v in kwargs.items() if k in self.__dataclass_fields__})
-
-        elif config.extra == Extra.allow:
-            for k, v in kwargs.items():
-                self.__dict__.setdefault(k, v)
-            init(self, *args, **{k: v for k, v in kwargs.items() if k in self.__dataclass_fields__})
-
-        else:
-            init(self, *args, **kwargs)
-
-    if hasattr(dc_cls, '__post_init__'):
-        post_init = dc_cls.__post_init__
-
-        @wraps(post_init)
-        def new_post_init(self: 'Dataclass', *args: Any, **kwargs: Any) -> None:
-            if config.post_init_call == 'before_validation':
-                post_init(self, *args, **kwargs)
-
-            if self.__class__.__pydantic_run_validation__:
-                self.__pydantic_validate_values__()
-                if hasattr(self, '__post_init_post_parse__'):
-                    self.__post_init_post_parse__(*args, **kwargs)
-
-            if config.post_init_call == 'after_validation':
-                post_init(self, *args, **kwargs)
-
-        setattr(dc_cls, '__init__', handle_extra_init)
-        setattr(dc_cls, '__post_init__', new_post_init)
-
+    if not force and cls.__pydantic_complete__:
+        return None
     else:
-
-        @wraps(init)
-        def new_init(self: 'Dataclass', *args: Any, **kwargs: Any) -> None:
-            handle_extra_init(self, *args, **kwargs)
-
-            if self.__class__.__pydantic_run_validation__:
-                self.__pydantic_validate_values__()
-
-            if hasattr(self, '__post_init_post_parse__'):
-                # We need to find again the initvars. To do that we use `__dataclass_fields__` instead of
-                # public method `dataclasses.fields`
-                import dataclasses
-
-                # get all initvars and their default values
-                initvars_and_values: Dict[str, Any] = {}
-                for i, f in enumerate(self.__class__.__dataclass_fields__.values()):
-                    if f._field_type is dataclasses._FIELD_INITVAR:  # type: ignore[attr-defined]
-                        try:
-                            # set arg value by default
-                            initvars_and_values[f.name] = args[i]
-                        except IndexError:
-                            initvars_and_values[f.name] = kwargs.get(f.name, f.default)
-
-                self.__post_init_post_parse__(**initvars_and_values)
-
-        setattr(dc_cls, '__init__', new_init)
-
-    setattr(dc_cls, '__pydantic_run_validation__', ClassAttribute('__pydantic_run_validation__', validate_on_init))
-    setattr(dc_cls, '__pydantic_initialised__', False)
-    setattr(dc_cls, '__pydantic_model__', create_pydantic_model_from_dataclass(dc_cls, config, dc_cls_doc))
-    setattr(dc_cls, '__pydantic_validate_values__', _dataclass_validate_values)
-    setattr(dc_cls, '__validate__', classmethod(_validate_dataclass))
-    setattr(dc_cls, '__get_validators__', classmethod(_get_validators))
-
-    if dc_cls.__pydantic_model__.__config__.validate_assignment and not dc_cls.__dataclass_params__.frozen:
-        setattr(dc_cls, '__setattr__', _dataclass_validate_assignment_setattr)
-
-
-def _get_validators(cls: 'DataclassClassOrWrapper') -> 'CallableGenerator':
-    yield cls.__validate__
-
-
-def _validate_dataclass(cls: Type['DataclassT'], v: Any) -> 'DataclassT':
-    with set_validation(cls, True):
-        if isinstance(v, cls):
-            v.__pydantic_validate_values__()
-            return v
-        elif isinstance(v, (list, tuple)):
-            return cls(*v)
-        elif isinstance(v, dict):
-            return cls(**v)
+        if _types_namespace is not None:
+            types_namespace: dict[str, Any] | None = _types_namespace.copy()
         else:
-            raise DataclassTypeError(class_name=cls.__name__)
+            if _parent_namespace_depth > 0:
+                frame_parent_ns = _typing_extra.parent_frame_namespace(parent_depth=_parent_namespace_depth) or {}
+                # Note: we may need to add something similar to cls.__pydantic_parent_namespace__ from BaseModel
+                #   here when implementing handling of recursive generics. See BaseModel.model_rebuild for reference.
+                types_namespace = frame_parent_ns
+            else:
+                types_namespace = {}
+
+            types_namespace = _typing_extra.get_cls_types_namespace(cls, types_namespace)
+        return _pydantic_dataclasses.complete_dataclass(
+            cls,
+            _config.ConfigWrapper(cls.__pydantic_config__, check=False),
+            raise_errors=raise_errors,
+            types_namespace=types_namespace,
+        )
 
 
-def create_pydantic_model_from_dataclass(
-    dc_cls: Type['Dataclass'],
-    config: Type[Any] = BaseConfig,
-    dc_cls_doc: Optional[str] = None,
-) -> Type['BaseModel']:
-    import dataclasses
+def is_pydantic_dataclass(__cls: type[Any]) -> TypeGuard[type[PydanticDataclass]]:
+    """Whether a class is a pydantic dataclass.
 
-    field_definitions: Dict[str, Any] = {}
-    for field in dataclasses.fields(dc_cls):
-        default: Any = Undefined
-        default_factory: Optional['NoArgAnyCallable'] = None
-        field_info: FieldInfo
+    Args:
+        __cls: The class.
 
-        if field.default is not dataclasses.MISSING:
-            default = field.default
-        elif field.default_factory is not dataclasses.MISSING:
-            default_factory = field.default_factory
-        else:
-            default = Required
-
-        if isinstance(default, FieldInfo):
-            field_info = default
-            dc_cls.__pydantic_has_field_info_default__ = True
-        else:
-            field_info = Field(default=default, default_factory=default_factory, **field.metadata)
-
-        field_definitions[field.name] = (field.type, field_info)
-
-    validators = gather_all_validators(dc_cls)
-    model: Type['BaseModel'] = create_model(
-        dc_cls.__name__,
-        __config__=config,
-        __module__=dc_cls.__module__,
-        __validators__=validators,
-        __cls_kwargs__={'__resolve_forward_refs__': False},
-        **field_definitions,
-    )
-    model.__doc__ = dc_cls_doc if dc_cls_doc is not None else dc_cls.__doc__ or ''
-    return model
-
-
-def _dataclass_validate_values(self: 'Dataclass') -> None:
-    # validation errors can occur if this function is called twice on an already initialised dataclass.
-    # for example if Extra.forbid is enabled, it would consider __pydantic_initialised__ an invalid extra property
-    if getattr(self, '__pydantic_initialised__'):
-        return
-    if getattr(self, '__pydantic_has_field_info_default__', False):
-        # We need to remove `FieldInfo` values since they are not valid as input
-        # It's ok to do that because they are obviously the default values!
-        input_data = {k: v for k, v in self.__dict__.items() if not isinstance(v, FieldInfo)}
-    else:
-        input_data = self.__dict__
-    d, _, validation_error = validate_model(self.__pydantic_model__, input_data, cls=self.__class__)
-    if validation_error:
-        raise validation_error
-    self.__dict__.update(d)
-    object.__setattr__(self, '__pydantic_initialised__', True)
-
-
-def _dataclass_validate_assignment_setattr(self: 'Dataclass', name: str, value: Any) -> None:
-    if self.__pydantic_initialised__:
-        d = dict(self.__dict__)
-        d.pop(name, None)
-        known_field = self.__pydantic_model__.__fields__.get(name, None)
-        if known_field:
-            value, error_ = known_field.validate(value, d, loc=name, cls=self.__class__)
-            if error_:
-                raise ValidationError([error_], self.__class__)
-
-    object.__setattr__(self, name, value)
-
-
-def _extra_dc_args(cls: Type[Any]) -> Set[str]:
-    return {
-        x
-        for x in dir(cls)
-        if x not in getattr(cls, '__dataclass_fields__', {}) and not (x.startswith('__') and x.endswith('__'))
-    }
-
-
-def is_builtin_dataclass(_cls: Type[Any]) -> bool:
+    Returns:
+        `True` if the class is a pydantic dataclass, `False` otherwise.
     """
-    Whether a class is a stdlib dataclass
-    (useful to discriminated a pydantic dataclass that is actually a wrapper around a stdlib dataclass)
-
-    we check that
-    - `_cls` is a dataclass
-    - `_cls` is not a processed pydantic dataclass (with a basemodel attached)
-    - `_cls` is not a pydantic dataclass inheriting directly from a stdlib dataclass
-    e.g.
-    ```
-    @dataclasses.dataclass
-    class A:
-        x: int
-
-    @pydantic.dataclasses.dataclass
-    class B(A):
-        y: int
-    ```
-    In this case, when we first check `B`, we make an extra check and look at the annotations ('y'),
-    which won't be a superset of all the dataclass fields (only the stdlib fields i.e. 'x')
-    """
-    import dataclasses
-
-    return (
-        dataclasses.is_dataclass(_cls)
-        and not hasattr(_cls, '__pydantic_model__')
-        and set(_cls.__dataclass_fields__).issuperset(set(getattr(_cls, '__annotations__', {})))
-    )
-
-
-def make_dataclass_validator(dc_cls: Type['Dataclass'], config: Type[BaseConfig]) -> 'CallableGenerator':
-    """
-    Create a pydantic.dataclass from a builtin dataclass to add type validation
-    and yield the validators
-    It retrieves the parameters of the dataclass and forwards them to the newly created dataclass
-    """
-    yield from _get_validators(dataclass(dc_cls, config=config, validate_on_init=False))
+    return dataclasses.is_dataclass(__cls) and '__pydantic_validator__' in __cls.__dict__
diff --git a/lib/pydantic/datetime_parse.py b/lib/pydantic/datetime_parse.py
index cfd54593..902219df 100644
--- a/lib/pydantic/datetime_parse.py
+++ b/lib/pydantic/datetime_parse.py
@@ -1,248 +1,4 @@
-"""
-Functions to parse datetime objects.
+"""The `datetime_parse` module is a backport module from V1."""
+from ._migration import getattr_migration
 
-We're using regular expressions rather than time.strptime because:
-- They provide both validation and parsing.
-- They're more flexible for datetimes.
-- The date/datetime/time constructors produce friendlier error messages.
-
-Stolen from https://raw.githubusercontent.com/django/django/main/django/utils/dateparse.py at
-9718fa2e8abe430c3526a9278dd976443d4ae3c6
-
-Changed to:
-* use standard python datetime types not django.utils.timezone
-* raise ValueError when regex doesn't match rather than returning None
-* support parsing unix timestamps for dates and datetimes
-"""
-import re
-from datetime import date, datetime, time, timedelta, timezone
-from typing import Dict, Optional, Type, Union
-
-from . import errors
-
-date_expr = r'(?P<year>\d{4})-(?P<month>\d{1,2})-(?P<day>\d{1,2})'
-time_expr = (
-    r'(?P<hour>\d{1,2}):(?P<minute>\d{1,2})'
-    r'(?::(?P<second>\d{1,2})(?:\.(?P<microsecond>\d{1,6})\d{0,6})?)?'
-    r'(?P<tzinfo>Z|[+-]\d{2}(?::?\d{2})?)?$'
-)
-
-date_re = re.compile(f'{date_expr}$')
-time_re = re.compile(time_expr)
-datetime_re = re.compile(f'{date_expr}[T ]{time_expr}')
-
-standard_duration_re = re.compile(
-    r'^'
-    r'(?:(?P<days>-?\d+) (days?, )?)?'
-    r'((?:(?P<hours>-?\d+):)(?=\d+:\d+))?'
-    r'(?:(?P<minutes>-?\d+):)?'
-    r'(?P<seconds>-?\d+)'
-    r'(?:\.(?P<microseconds>\d{1,6})\d{0,6})?'
-    r'$'
-)
-
-# Support the sections of ISO 8601 date representation that are accepted by timedelta
-iso8601_duration_re = re.compile(
-    r'^(?P<sign>[-+]?)'
-    r'P'
-    r'(?:(?P<days>\d+(.\d+)?)D)?'
-    r'(?:T'
-    r'(?:(?P<hours>\d+(.\d+)?)H)?'
-    r'(?:(?P<minutes>\d+(.\d+)?)M)?'
-    r'(?:(?P<seconds>\d+(.\d+)?)S)?'
-    r')?'
-    r'$'
-)
-
-EPOCH = datetime(1970, 1, 1)
-# if greater than this, the number is in ms, if less than or equal it's in seconds
-# (in seconds this is 11th October 2603, in ms it's 20th August 1970)
-MS_WATERSHED = int(2e10)
-# slightly more than datetime.max in ns - (datetime.max - EPOCH).total_seconds() * 1e9
-MAX_NUMBER = int(3e20)
-StrBytesIntFloat = Union[str, bytes, int, float]
-
-
-def get_numeric(value: StrBytesIntFloat, native_expected_type: str) -> Union[None, int, float]:
-    if isinstance(value, (int, float)):
-        return value
-    try:
-        return float(value)
-    except ValueError:
-        return None
-    except TypeError:
-        raise TypeError(f'invalid type; expected {native_expected_type}, string, bytes, int or float')
-
-
-def from_unix_seconds(seconds: Union[int, float]) -> datetime:
-    if seconds > MAX_NUMBER:
-        return datetime.max
-    elif seconds < -MAX_NUMBER:
-        return datetime.min
-
-    while abs(seconds) > MS_WATERSHED:
-        seconds /= 1000
-    dt = EPOCH + timedelta(seconds=seconds)
-    return dt.replace(tzinfo=timezone.utc)
-
-
-def _parse_timezone(value: Optional[str], error: Type[Exception]) -> Union[None, int, timezone]:
-    if value == 'Z':
-        return timezone.utc
-    elif value is not None:
-        offset_mins = int(value[-2:]) if len(value) > 3 else 0
-        offset = 60 * int(value[1:3]) + offset_mins
-        if value[0] == '-':
-            offset = -offset
-        try:
-            return timezone(timedelta(minutes=offset))
-        except ValueError:
-            raise error()
-    else:
-        return None
-
-
-def parse_date(value: Union[date, StrBytesIntFloat]) -> date:
-    """
-    Parse a date/int/float/string and return a datetime.date.
-
-    Raise ValueError if the input is well formatted but not a valid date.
-    Raise ValueError if the input isn't well formatted.
-    """
-    if isinstance(value, date):
-        if isinstance(value, datetime):
-            return value.date()
-        else:
-            return value
-
-    number = get_numeric(value, 'date')
-    if number is not None:
-        return from_unix_seconds(number).date()
-
-    if isinstance(value, bytes):
-        value = value.decode()
-
-    match = date_re.match(value)  # type: ignore
-    if match is None:
-        raise errors.DateError()
-
-    kw = {k: int(v) for k, v in match.groupdict().items()}
-
-    try:
-        return date(**kw)
-    except ValueError:
-        raise errors.DateError()
-
-
-def parse_time(value: Union[time, StrBytesIntFloat]) -> time:
-    """
-    Parse a time/string and return a datetime.time.
-
-    Raise ValueError if the input is well formatted but not a valid time.
-    Raise ValueError if the input isn't well formatted, in particular if it contains an offset.
-    """
-    if isinstance(value, time):
-        return value
-
-    number = get_numeric(value, 'time')
-    if number is not None:
-        if number >= 86400:
-            # doesn't make sense since the time time loop back around to 0
-            raise errors.TimeError()
-        return (datetime.min + timedelta(seconds=number)).time()
-
-    if isinstance(value, bytes):
-        value = value.decode()
-
-    match = time_re.match(value)  # type: ignore
-    if match is None:
-        raise errors.TimeError()
-
-    kw = match.groupdict()
-    if kw['microsecond']:
-        kw['microsecond'] = kw['microsecond'].ljust(6, '0')
-
-    tzinfo = _parse_timezone(kw.pop('tzinfo'), errors.TimeError)
-    kw_: Dict[str, Union[None, int, timezone]] = {k: int(v) for k, v in kw.items() if v is not None}
-    kw_['tzinfo'] = tzinfo
-
-    try:
-        return time(**kw_)  # type: ignore
-    except ValueError:
-        raise errors.TimeError()
-
-
-def parse_datetime(value: Union[datetime, StrBytesIntFloat]) -> datetime:
-    """
-    Parse a datetime/int/float/string and return a datetime.datetime.
-
-    This function supports time zone offsets. When the input contains one,
-    the output uses a timezone with a fixed offset from UTC.
-
-    Raise ValueError if the input is well formatted but not a valid datetime.
-    Raise ValueError if the input isn't well formatted.
-    """
-    if isinstance(value, datetime):
-        return value
-
-    number = get_numeric(value, 'datetime')
-    if number is not None:
-        return from_unix_seconds(number)
-
-    if isinstance(value, bytes):
-        value = value.decode()
-
-    match = datetime_re.match(value)  # type: ignore
-    if match is None:
-        raise errors.DateTimeError()
-
-    kw = match.groupdict()
-    if kw['microsecond']:
-        kw['microsecond'] = kw['microsecond'].ljust(6, '0')
-
-    tzinfo = _parse_timezone(kw.pop('tzinfo'), errors.DateTimeError)
-    kw_: Dict[str, Union[None, int, timezone]] = {k: int(v) for k, v in kw.items() if v is not None}
-    kw_['tzinfo'] = tzinfo
-
-    try:
-        return datetime(**kw_)  # type: ignore
-    except ValueError:
-        raise errors.DateTimeError()
-
-
-def parse_duration(value: StrBytesIntFloat) -> timedelta:
-    """
-    Parse a duration int/float/string and return a datetime.timedelta.
-
-    The preferred format for durations in Django is '%d %H:%M:%S.%f'.
-
-    Also supports ISO 8601 representation.
-    """
-    if isinstance(value, timedelta):
-        return value
-
-    if isinstance(value, (int, float)):
-        # below code requires a string
-        value = f'{value:f}'
-    elif isinstance(value, bytes):
-        value = value.decode()
-
-    try:
-        match = standard_duration_re.match(value) or iso8601_duration_re.match(value)
-    except TypeError:
-        raise TypeError('invalid type; expected timedelta, string, bytes, int or float')
-
-    if not match:
-        raise errors.DurationError()
-
-    kw = match.groupdict()
-    sign = -1 if kw.pop('sign', '+') == '-' else 1
-    if kw.get('microseconds'):
-        kw['microseconds'] = kw['microseconds'].ljust(6, '0')
-
-    if kw.get('seconds') and kw.get('microseconds') and kw['seconds'].startswith('-'):
-        kw['microseconds'] = '-' + kw['microseconds']
-
-    kw_ = {k: float(v) for k, v in kw.items() if v is not None}
-
-    return sign * timedelta(**kw_)
+__getattr__ = getattr_migration(__name__)
diff --git a/lib/pydantic/decorator.py b/lib/pydantic/decorator.py
index 089aab65..c3643468 100644
--- a/lib/pydantic/decorator.py
+++ b/lib/pydantic/decorator.py
@@ -1,264 +1,4 @@
-from functools import wraps
-from typing import TYPE_CHECKING, Any, Callable, Dict, List, Mapping, Optional, Tuple, Type, TypeVar, Union, overload
+"""The `decorator` module is a backport module from V1."""
+from ._migration import getattr_migration
 
-from . import validator
-from .config import Extra
-from .errors import ConfigError
-from .main import BaseModel, create_model
-from .typing import get_all_type_hints
-from .utils import to_camel
-
-__all__ = ('validate_arguments',)
-
-if TYPE_CHECKING:
-    from .typing import AnyCallable
-
-    AnyCallableT = TypeVar('AnyCallableT', bound=AnyCallable)
-    ConfigType = Union[None, Type[Any], Dict[str, Any]]
-
-
-@overload
-def validate_arguments(func: None = None, *, config: 'ConfigType' = None) -> Callable[['AnyCallableT'], 'AnyCallableT']:
-    ...
-
-
-@overload
-def validate_arguments(func: 'AnyCallableT') -> 'AnyCallableT':
-    ...
-
-
-def validate_arguments(func: Optional['AnyCallableT'] = None, *, config: 'ConfigType' = None) -> Any:
-    """
-    Decorator to validate the arguments passed to a function.
-    """
-
-    def validate(_func: 'AnyCallable') -> 'AnyCallable':
-        vd = ValidatedFunction(_func, config)
-
-        @wraps(_func)
-        def wrapper_function(*args: Any, **kwargs: Any) -> Any:
-            return vd.call(*args, **kwargs)
-
-        wrapper_function.vd = vd  # type: ignore
-        wrapper_function.validate = vd.init_model_instance  # type: ignore
-        wrapper_function.raw_function = vd.raw_function  # type: ignore
-        wrapper_function.model = vd.model  # type: ignore
-        return wrapper_function
-
-    if func:
-        return validate(func)
-    else:
-        return validate
-
-
-ALT_V_ARGS = 'v__args'
-ALT_V_KWARGS = 'v__kwargs'
-V_POSITIONAL_ONLY_NAME = 'v__positional_only'
-V_DUPLICATE_KWARGS = 'v__duplicate_kwargs'
-
-
-class ValidatedFunction:
-    def __init__(self, function: 'AnyCallableT', config: 'ConfigType'):  # noqa C901
-        from inspect import Parameter, signature
-
-        parameters: Mapping[str, Parameter] = signature(function).parameters
-
-        if parameters.keys() & {ALT_V_ARGS, ALT_V_KWARGS, V_POSITIONAL_ONLY_NAME, V_DUPLICATE_KWARGS}:
-            raise ConfigError(
-                f'"{ALT_V_ARGS}", "{ALT_V_KWARGS}", "{V_POSITIONAL_ONLY_NAME}" and "{V_DUPLICATE_KWARGS}" '
-                f'are not permitted as argument names when using the "{validate_arguments.__name__}" decorator'
-            )
-
-        self.raw_function = function
-        self.arg_mapping: Dict[int, str] = {}
-        self.positional_only_args = set()
-        self.v_args_name = 'args'
-        self.v_kwargs_name = 'kwargs'
-
-        type_hints = get_all_type_hints(function)
-        takes_args = False
-        takes_kwargs = False
-        fields: Dict[str, Tuple[Any, Any]] = {}
-        for i, (name, p) in enumerate(parameters.items()):
-            if p.annotation is p.empty:
-                annotation = Any
-            else:
-                annotation = type_hints[name]
-
-            default = ... if p.default is p.empty else p.default
-            if p.kind == Parameter.POSITIONAL_ONLY:
-                self.arg_mapping[i] = name
-                fields[name] = annotation, default
-                fields[V_POSITIONAL_ONLY_NAME] = List[str], None
-                self.positional_only_args.add(name)
-            elif p.kind == Parameter.POSITIONAL_OR_KEYWORD:
-                self.arg_mapping[i] = name
-                fields[name] = annotation, default
-                fields[V_DUPLICATE_KWARGS] = List[str], None
-            elif p.kind == Parameter.KEYWORD_ONLY:
-                fields[name] = annotation, default
-            elif p.kind == Parameter.VAR_POSITIONAL:
-                self.v_args_name = name
-                fields[name] = Tuple[annotation, ...], None
-                takes_args = True
-            else:
-                assert p.kind == Parameter.VAR_KEYWORD, p.kind
-                self.v_kwargs_name = name
-                fields[name] = Dict[str, annotation], None  # type: ignore
-                takes_kwargs = True
-
-        # these checks avoid a clash between "args" and a field with that name
-        if not takes_args and self.v_args_name in fields:
-            self.v_args_name = ALT_V_ARGS
-
-        # same with "kwargs"
-        if not takes_kwargs and self.v_kwargs_name in fields:
-            self.v_kwargs_name = ALT_V_KWARGS
-
-        if not takes_args:
-            # we add the field so validation below can raise the correct exception
-            fields[self.v_args_name] = List[Any], None
-
-        if not takes_kwargs:
-            # same with kwargs
-            fields[self.v_kwargs_name] = Dict[Any, Any], None
-
-        self.create_model(fields, takes_args, takes_kwargs, config)
-
-    def init_model_instance(self, *args: Any, **kwargs: Any) -> BaseModel:
-        values = self.build_values(args, kwargs)
-        return self.model(**values)
-
-    def call(self, *args: Any, **kwargs: Any) -> Any:
-        m = self.init_model_instance(*args, **kwargs)
-        return self.execute(m)
-
-    def build_values(self, args: Tuple[Any, ...], kwargs: Dict[str, Any]) -> Dict[str, Any]:
-        values: Dict[str, Any] = {}
-        if args:
-            arg_iter = enumerate(args)
-            while True:
-                try:
-                    i, a = next(arg_iter)
-                except StopIteration:
-                    break
-                arg_name = self.arg_mapping.get(i)
-                if arg_name is not None:
-                    values[arg_name] = a
-                else:
-                    values[self.v_args_name] = [a] + [a for _, a in arg_iter]
-                    break
-
-        var_kwargs: Dict[str, Any] = {}
-        wrong_positional_args = []
-        duplicate_kwargs = []
-        fields_alias = [
-            field.alias
-            for name, field in self.model.__fields__.items()
-            if name not in (self.v_args_name, self.v_kwargs_name)
-        ]
-        non_var_fields = set(self.model.__fields__) - {self.v_args_name, self.v_kwargs_name}
-        for k, v in kwargs.items():
-            if k in non_var_fields or k in fields_alias:
-                if k in self.positional_only_args:
-                    wrong_positional_args.append(k)
-                if k in values:
-                    duplicate_kwargs.append(k)
-                values[k] = v
-            else:
-                var_kwargs[k] = v
-
-        if var_kwargs:
-            values[self.v_kwargs_name] = var_kwargs
-        if wrong_positional_args:
-            values[V_POSITIONAL_ONLY_NAME] = wrong_positional_args
-        if duplicate_kwargs:
-            values[V_DUPLICATE_KWARGS] = duplicate_kwargs
-        return values
-
-    def execute(self, m: BaseModel) -> Any:
-        d = {k: v for k, v in m._iter() if k in m.__fields_set__ or m.__fields__[k].default_factory}
-        var_kwargs = d.pop(self.v_kwargs_name, {})
-
-        if self.v_args_name in d:
-            args_: List[Any] = []
-            in_kwargs = False
-            kwargs = {}
-            for name, value in d.items():
-                if in_kwargs:
-                    kwargs[name] = value
-                elif name == self.v_args_name:
-                    args_ += value
-                    in_kwargs = True
-                else:
-                    args_.append(value)
-            return self.raw_function(*args_, **kwargs, **var_kwargs)
-        elif self.positional_only_args:
-            args_ = []
-            kwargs = {}
-            for name, value in d.items():
-                if name in self.positional_only_args:
-                    args_.append(value)
-                else:
-                    kwargs[name] = value
-            return self.raw_function(*args_, **kwargs, **var_kwargs)
-        else:
-            return self.raw_function(**d, **var_kwargs)
-
-    def create_model(self, fields: Dict[str, Any], takes_args: bool, takes_kwargs: bool, config: 'ConfigType') -> None:
-        pos_args = len(self.arg_mapping)
-
-        class CustomConfig:
-            pass
-
-        if not TYPE_CHECKING:  # pragma: no branch
-            if isinstance(config, dict):
-                CustomConfig = type('Config', (), config)  # noqa: F811
-            elif config is not None:
-                CustomConfig = config  # noqa: F811
-
-        if hasattr(CustomConfig, 'fields') or hasattr(CustomConfig, 'alias_generator'):
-            raise ConfigError(
-                'Setting the "fields" and "alias_generator" property on custom Config for '
-                '@validate_arguments is not yet supported, please remove.'
-            )
-
-        class DecoratorBaseModel(BaseModel):
-            @validator(self.v_args_name, check_fields=False, allow_reuse=True)
-            def check_args(cls, v: Optional[List[Any]]) -> Optional[List[Any]]:
-                if takes_args or v is None:
-                    return v
-
-                raise TypeError(f'{pos_args} positional arguments expected but {pos_args + len(v)} given')
-
-            @validator(self.v_kwargs_name, check_fields=False, allow_reuse=True)
-            def check_kwargs(cls, v: Optional[Dict[str, Any]]) -> Optional[Dict[str, Any]]:
-                if takes_kwargs or v is None:
-                    return v
-
-                plural = '' if len(v) == 1 else 's'
-                keys = ', '.join(map(repr, v.keys()))
-                raise TypeError(f'unexpected keyword argument{plural}: {keys}')
-
-            @validator(V_POSITIONAL_ONLY_NAME, check_fields=False, allow_reuse=True)
-            def check_positional_only(cls, v: Optional[List[str]]) -> None:
-                if v is None:
-                    return
-
-                plural = '' if len(v) == 1 else 's'
-                keys = ', '.join(map(repr, v))
-                raise TypeError(f'positional-only argument{plural} passed as keyword argument{plural}: {keys}')
-
-            @validator(V_DUPLICATE_KWARGS, check_fields=False, allow_reuse=True)
-            def check_duplicate_kwargs(cls, v: Optional[List[str]]) -> None:
-                if v is None:
-                    return
-
-                plural = '' if len(v) == 1 else 's'
-                keys = ', '.join(map(repr, v))
-                raise TypeError(f'multiple values for argument{plural}: {keys}')
-
-            class Config(CustomConfig):
-                extra = getattr(CustomConfig, 'extra', Extra.forbid)
-
-        self.model = create_model(to_camel(self.raw_function.__name__), __base__=DecoratorBaseModel, **fields)
+__getattr__ = getattr_migration(__name__)
diff --git a/lib/pydantic/deprecated/__init__.py b/lib/pydantic/deprecated/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/lib/pydantic/deprecated/class_validators.py b/lib/pydantic/deprecated/class_validators.py
new file mode 100644
index 00000000..7b48afd2
--- /dev/null
+++ b/lib/pydantic/deprecated/class_validators.py
@@ -0,0 +1,253 @@
+"""Old `@validator` and `@root_validator` function validators from V1."""
+
+from __future__ import annotations as _annotations
+
+from functools import partial, partialmethod
+from types import FunctionType
+from typing import TYPE_CHECKING, Any, Callable, TypeVar, Union, overload
+from warnings import warn
+
+from typing_extensions import Literal, Protocol, TypeAlias
+
+from .._internal import _decorators, _decorators_v1
+from ..errors import PydanticUserError
+from ..warnings import PydanticDeprecatedSince20
+
+_ALLOW_REUSE_WARNING_MESSAGE = '`allow_reuse` is deprecated and will be ignored; it should no longer be necessary'
+
+
+if TYPE_CHECKING:
+
+    class _OnlyValueValidatorClsMethod(Protocol):
+        def __call__(self, __cls: Any, __value: Any) -> Any:
+            ...
+
+    class _V1ValidatorWithValuesClsMethod(Protocol):
+        def __call__(self, __cls: Any, __value: Any, values: dict[str, Any]) -> Any:
+            ...
+
+    class _V1ValidatorWithValuesKwOnlyClsMethod(Protocol):
+        def __call__(self, __cls: Any, __value: Any, *, values: dict[str, Any]) -> Any:
+            ...
+
+    class _V1ValidatorWithKwargsClsMethod(Protocol):
+        def __call__(self, __cls: Any, **kwargs: Any) -> Any:
+            ...
+
+    class _V1ValidatorWithValuesAndKwargsClsMethod(Protocol):
+        def __call__(self, __cls: Any, values: dict[str, Any], **kwargs: Any) -> Any:
+            ...
+
+    class _V1RootValidatorClsMethod(Protocol):
+        def __call__(
+            self, __cls: Any, __values: _decorators_v1.RootValidatorValues
+        ) -> _decorators_v1.RootValidatorValues:
+            ...
+
+    V1Validator = Union[
+        _OnlyValueValidatorClsMethod,
+        _V1ValidatorWithValuesClsMethod,
+        _V1ValidatorWithValuesKwOnlyClsMethod,
+        _V1ValidatorWithKwargsClsMethod,
+        _V1ValidatorWithValuesAndKwargsClsMethod,
+        _decorators_v1.V1ValidatorWithValues,
+        _decorators_v1.V1ValidatorWithValuesKwOnly,
+        _decorators_v1.V1ValidatorWithKwargs,
+        _decorators_v1.V1ValidatorWithValuesAndKwargs,
+    ]
+
+    V1RootValidator = Union[
+        _V1RootValidatorClsMethod,
+        _decorators_v1.V1RootValidatorFunction,
+    ]
+
+    _PartialClsOrStaticMethod: TypeAlias = Union[classmethod[Any, Any, Any], staticmethod[Any, Any], partialmethod[Any]]
+
+    # Allow both a V1 (assumed pre=False) or V2 (assumed mode='after') validator
+    # We lie to type checkers and say we return the same thing we get
+    # but in reality we return a proxy object that _mostly_ behaves like the wrapped thing
+    _V1ValidatorType = TypeVar('_V1ValidatorType', V1Validator, _PartialClsOrStaticMethod)
+    _V1RootValidatorFunctionType = TypeVar(
+        '_V1RootValidatorFunctionType',
+        _decorators_v1.V1RootValidatorFunction,
+        _V1RootValidatorClsMethod,
+        _PartialClsOrStaticMethod,
+    )
+else:
+    # See PyCharm issues https://youtrack.jetbrains.com/issue/PY-21915
+    # and https://youtrack.jetbrains.com/issue/PY-51428
+    DeprecationWarning = PydanticDeprecatedSince20
+
+
+def validator(
+    __field: str,
+    *fields: str,
+    pre: bool = False,
+    each_item: bool = False,
+    always: bool = False,
+    check_fields: bool | None = None,
+    allow_reuse: bool = False,
+) -> Callable[[_V1ValidatorType], _V1ValidatorType]:
+    """Decorate methods on the class indicating that they should be used to validate fields.
+
+    Args:
+        __field (str): The first field the validator should be called on; this is separate
+            from `fields` to ensure an error is raised if you don't pass at least one.
+        *fields (str): Additional field(s) the validator should be called on.
+        pre (bool, optional): Whether this validator should be called before the standard
+            validators (else after). Defaults to False.
+        each_item (bool, optional): For complex objects (sets, lists etc.) whether to validate
+            individual elements rather than the whole object. Defaults to False.
+        always (bool, optional): Whether this method and other validators should be called even if
+            the value is missing. Defaults to False.
+        check_fields (bool | None, optional): Whether to check that the fields actually exist on the model.
+            Defaults to None.
+        allow_reuse (bool, optional): Whether to track and raise an error if another validator refers to
+            the decorated function. Defaults to False.
+
+    Returns:
+        Callable: A decorator that can be used to decorate a
+            function to be used as a validator.
+    """
+    if allow_reuse is True:  # pragma: no cover
+        warn(_ALLOW_REUSE_WARNING_MESSAGE, DeprecationWarning)
+    fields = tuple((__field, *fields))
+    if isinstance(fields[0], FunctionType):
+        raise PydanticUserError(
+            '`@validator` should be used with fields and keyword arguments, not bare. '
+            "E.g. usage should be `@validator('<field_name>', ...)`",
+            code='validator-no-fields',
+        )
+    elif not all(isinstance(field, str) for field in fields):
+        raise PydanticUserError(
+            '`@validator` fields should be passed as separate string args. '
+            "E.g. usage should be `@validator('<field_name_1>', '<field_name_2>', ...)`",
+            code='validator-invalid-fields',
+        )
+
+    warn(
+        'Pydantic V1 style `@validator` validators are deprecated.'
+        ' You should migrate to Pydantic V2 style `@field_validator` validators,'
+        ' see the migration guide for more details',
+        DeprecationWarning,
+        stacklevel=2,
+    )
+
+    mode: Literal['before', 'after'] = 'before' if pre is True else 'after'
+
+    def dec(f: Any) -> _decorators.PydanticDescriptorProxy[Any]:
+        if _decorators.is_instance_method_from_sig(f):
+            raise PydanticUserError(
+                '`@validator` cannot be applied to instance methods', code='validator-instance-method'
+            )
+        # auto apply the @classmethod decorator
+        f = _decorators.ensure_classmethod_based_on_signature(f)
+        wrap = _decorators_v1.make_generic_v1_field_validator
+        validator_wrapper_info = _decorators.ValidatorDecoratorInfo(
+            fields=fields,
+            mode=mode,
+            each_item=each_item,
+            always=always,
+            check_fields=check_fields,
+        )
+        return _decorators.PydanticDescriptorProxy(f, validator_wrapper_info, shim=wrap)
+
+    return dec  # type: ignore[return-value]
+
+
+@overload
+def root_validator(
+    *,
+    # if you don't specify `pre` the default is `pre=False`
+    # which means you need to specify `skip_on_failure=True`
+    skip_on_failure: Literal[True],
+    allow_reuse: bool = ...,
+) -> Callable[
+    [_V1RootValidatorFunctionType],
+    _V1RootValidatorFunctionType,
+]:
+    ...
+
+
+@overload
+def root_validator(
+    *,
+    # if you specify `pre=True` then you don't need to specify
+    # `skip_on_failure`, in fact it is not allowed as an argument!
+    pre: Literal[True],
+    allow_reuse: bool = ...,
+) -> Callable[
+    [_V1RootValidatorFunctionType],
+    _V1RootValidatorFunctionType,
+]:
+    ...
+
+
+@overload
+def root_validator(
+    *,
+    # if you explicitly specify `pre=False` then you
+    # MUST specify `skip_on_failure=True`
+    pre: Literal[False],
+    skip_on_failure: Literal[True],
+    allow_reuse: bool = ...,
+) -> Callable[
+    [_V1RootValidatorFunctionType],
+    _V1RootValidatorFunctionType,
+]:
+    ...
+
+
+def root_validator(
+    *__args,
+    pre: bool = False,
+    skip_on_failure: bool = False,
+    allow_reuse: bool = False,
+) -> Any:
+    """Decorate methods on a model indicating that they should be used to validate (and perhaps
+    modify) data either before or after standard model parsing/validation is performed.
+
+    Args:
+        pre (bool, optional): Whether this validator should be called before the standard
+            validators (else after). Defaults to False.
+        skip_on_failure (bool, optional): Whether to stop validation and return as soon as a
+            failure is encountered. Defaults to False.
+        allow_reuse (bool, optional): Whether to track and raise an error if another validator
+            refers to the decorated function. Defaults to False.
+
+    Returns:
+        Any: A decorator that can be used to decorate a function to be used as a root_validator.
+    """
+    warn(
+        'Pydantic V1 style `@root_validator` validators are deprecated.'
+        ' You should migrate to Pydantic V2 style `@model_validator` validators,'
+        ' see the migration guide for more details',
+        DeprecationWarning,
+        stacklevel=2,
+    )
+
+    if __args:
+        # Ensure a nice error is raised if someone attempts to use the bare decorator
+        return root_validator()(*__args)  # type: ignore
+
+    if allow_reuse is True:  # pragma: no cover
+        warn(_ALLOW_REUSE_WARNING_MESSAGE, DeprecationWarning)
+    mode: Literal['before', 'after'] = 'before' if pre is True else 'after'
+    if pre is False and skip_on_failure is not True:
+        raise PydanticUserError(
+            'If you use `@root_validator` with pre=False (the default) you MUST specify `skip_on_failure=True`.'
+            ' Note that `@root_validator` is deprecated and should be replaced with `@model_validator`.',
+            code='root-validator-pre-skip',
+        )
+
+    wrap = partial(_decorators_v1.make_v1_generic_root_validator, pre=pre)
+
+    def dec(f: Callable[..., Any] | classmethod[Any, Any, Any] | staticmethod[Any, Any]) -> Any:
+        if _decorators.is_instance_method_from_sig(f):
+            raise TypeError('`@root_validator` cannot be applied to instance methods')
+        # auto apply the @classmethod decorator
+        res = _decorators.ensure_classmethod_based_on_signature(f)
+        dec_info = _decorators.RootValidatorDecoratorInfo(mode=mode)
+        return _decorators.PydanticDescriptorProxy(res, dec_info, shim=wrap)
+
+    return dec
diff --git a/lib/pydantic/deprecated/config.py b/lib/pydantic/deprecated/config.py
new file mode 100644
index 00000000..45400c65
--- /dev/null
+++ b/lib/pydantic/deprecated/config.py
@@ -0,0 +1,72 @@
+from __future__ import annotations as _annotations
+
+import warnings
+from typing import TYPE_CHECKING, Any
+
+from typing_extensions import Literal, deprecated
+
+from .._internal import _config
+from ..warnings import PydanticDeprecatedSince20
+
+if not TYPE_CHECKING:
+    # See PyCharm issues https://youtrack.jetbrains.com/issue/PY-21915
+    # and https://youtrack.jetbrains.com/issue/PY-51428
+    DeprecationWarning = PydanticDeprecatedSince20
+
+__all__ = 'BaseConfig', 'Extra'
+
+
+class _ConfigMetaclass(type):
+    def __getattr__(self, item: str) -> Any:
+        try:
+            obj = _config.config_defaults[item]
+            warnings.warn(_config.DEPRECATION_MESSAGE, DeprecationWarning)
+            return obj
+        except KeyError as exc:
+            raise AttributeError(f"type object '{self.__name__}' has no attribute {exc}") from exc
+
+
+@deprecated('BaseConfig is deprecated. Use the `pydantic.ConfigDict` instead.', category=PydanticDeprecatedSince20)
+class BaseConfig(metaclass=_ConfigMetaclass):
+    """This class is only retained for backwards compatibility.
+
+    !!! Warning "Deprecated"
+        BaseConfig is deprecated. Use the [`pydantic.ConfigDict`][pydantic.ConfigDict] instead.
+    """
+
+    def __getattr__(self, item: str) -> Any:
+        try:
+            obj = super().__getattribute__(item)
+            warnings.warn(_config.DEPRECATION_MESSAGE, DeprecationWarning)
+            return obj
+        except AttributeError as exc:
+            try:
+                return getattr(type(self), item)
+            except AttributeError:
+                # re-raising changes the displayed text to reflect that `self` is not a type
+                raise AttributeError(str(exc)) from exc
+
+    def __init_subclass__(cls, **kwargs: Any) -> None:
+        warnings.warn(_config.DEPRECATION_MESSAGE, DeprecationWarning)
+        return super().__init_subclass__(**kwargs)
+
+
+class _ExtraMeta(type):
+    def __getattribute__(self, __name: str) -> Any:
+        # The @deprecated decorator accesses other attributes, so we only emit a warning for the expected ones
+        if __name in {'allow', 'ignore', 'forbid'}:
+            warnings.warn(
+                "`pydantic.config.Extra` is deprecated, use literal values instead (e.g. `extra='allow'`)",
+                DeprecationWarning,
+                stacklevel=2,
+            )
+        return super().__getattribute__(__name)
+
+
+@deprecated(
+    "Extra is deprecated. Use literal values instead (e.g. `extra='allow'`)", category=PydanticDeprecatedSince20
+)
+class Extra(metaclass=_ExtraMeta):
+    allow: Literal['allow'] = 'allow'
+    ignore: Literal['ignore'] = 'ignore'
+    forbid: Literal['forbid'] = 'forbid'
diff --git a/lib/pydantic/deprecated/copy_internals.py b/lib/pydantic/deprecated/copy_internals.py
new file mode 100644
index 00000000..efe5de28
--- /dev/null
+++ b/lib/pydantic/deprecated/copy_internals.py
@@ -0,0 +1,224 @@
+from __future__ import annotations as _annotations
+
+import typing
+from copy import deepcopy
+from enum import Enum
+from typing import Any, Tuple
+
+import typing_extensions
+
+from .._internal import (
+    _model_construction,
+    _typing_extra,
+    _utils,
+)
+
+if typing.TYPE_CHECKING:
+    from .. import BaseModel
+    from .._internal._utils import AbstractSetIntStr, MappingIntStrAny
+
+    AnyClassMethod = classmethod[Any, Any, Any]
+    TupleGenerator = typing.Generator[Tuple[str, Any], None, None]
+    Model = typing.TypeVar('Model', bound='BaseModel')
+    # should be `set[int] | set[str] | dict[int, IncEx] | dict[str, IncEx] | None`, but mypy can't cope
+    IncEx: typing_extensions.TypeAlias = 'set[int] | set[str] | dict[int, Any] | dict[str, Any] | None'
+
+_object_setattr = _model_construction.object_setattr
+
+
+def _iter(
+    self: BaseModel,
+    to_dict: bool = False,
+    by_alias: bool = False,
+    include: AbstractSetIntStr | MappingIntStrAny | None = None,
+    exclude: AbstractSetIntStr | MappingIntStrAny | None = None,
+    exclude_unset: bool = False,
+    exclude_defaults: bool = False,
+    exclude_none: bool = False,
+) -> TupleGenerator:
+    # Merge field set excludes with explicit exclude parameter with explicit overriding field set options.
+    # The extra "is not None" guards are not logically necessary but optimizes performance for the simple case.
+    if exclude is not None:
+        exclude = _utils.ValueItems.merge(
+            {k: v.exclude for k, v in self.model_fields.items() if v.exclude is not None}, exclude
+        )
+
+    if include is not None:
+        include = _utils.ValueItems.merge({k: True for k in self.model_fields}, include, intersect=True)
+
+    allowed_keys = _calculate_keys(self, include=include, exclude=exclude, exclude_unset=exclude_unset)  # type: ignore
+    if allowed_keys is None and not (to_dict or by_alias or exclude_unset or exclude_defaults or exclude_none):
+        # huge boost for plain _iter()
+        yield from self.__dict__.items()
+        if self.__pydantic_extra__:
+            yield from self.__pydantic_extra__.items()
+        return
+
+    value_exclude = _utils.ValueItems(self, exclude) if exclude is not None else None
+    value_include = _utils.ValueItems(self, include) if include is not None else None
+
+    if self.__pydantic_extra__ is None:
+        items = self.__dict__.items()
+    else:
+        items = list(self.__dict__.items()) + list(self.__pydantic_extra__.items())
+
+    for field_key, v in items:
+        if (allowed_keys is not None and field_key not in allowed_keys) or (exclude_none and v is None):
+            continue
+
+        if exclude_defaults:
+            try:
+                field = self.model_fields[field_key]
+            except KeyError:
+                pass
+            else:
+                if not field.is_required() and field.default == v:
+                    continue
+
+        if by_alias and field_key in self.model_fields:
+            dict_key = self.model_fields[field_key].alias or field_key
+        else:
+            dict_key = field_key
+
+        if to_dict or value_include or value_exclude:
+            v = _get_value(
+                type(self),
+                v,
+                to_dict=to_dict,
+                by_alias=by_alias,
+                include=value_include and value_include.for_element(field_key),
+                exclude=value_exclude and value_exclude.for_element(field_key),
+                exclude_unset=exclude_unset,
+                exclude_defaults=exclude_defaults,
+                exclude_none=exclude_none,
+            )
+        yield dict_key, v
+
+
+def _copy_and_set_values(
+    self: Model,
+    values: dict[str, Any],
+    fields_set: set[str],
+    extra: dict[str, Any] | None = None,
+    private: dict[str, Any] | None = None,
+    *,
+    deep: bool,  # UP006
+) -> Model:
+    if deep:
+        # chances of having empty dict here are quite low for using smart_deepcopy
+        values = deepcopy(values)
+        extra = deepcopy(extra)
+        private = deepcopy(private)
+
+    cls = self.__class__
+    m = cls.__new__(cls)
+    _object_setattr(m, '__dict__', values)
+    _object_setattr(m, '__pydantic_extra__', extra)
+    _object_setattr(m, '__pydantic_fields_set__', fields_set)
+    _object_setattr(m, '__pydantic_private__', private)
+
+    return m
+
+
+@typing.no_type_check
+def _get_value(
+    cls: type[BaseModel],
+    v: Any,
+    to_dict: bool,
+    by_alias: bool,
+    include: AbstractSetIntStr | MappingIntStrAny | None,
+    exclude: AbstractSetIntStr | MappingIntStrAny | None,
+    exclude_unset: bool,
+    exclude_defaults: bool,
+    exclude_none: bool,
+) -> Any:
+    from .. import BaseModel
+
+    if isinstance(v, BaseModel):
+        if to_dict:
+            return v.model_dump(
+                by_alias=by_alias,
+                exclude_unset=exclude_unset,
+                exclude_defaults=exclude_defaults,
+                include=include,  # type: ignore
+                exclude=exclude,  # type: ignore
+                exclude_none=exclude_none,
+            )
+        else:
+            return v.copy(include=include, exclude=exclude)
+
+    value_exclude = _utils.ValueItems(v, exclude) if exclude else None
+    value_include = _utils.ValueItems(v, include) if include else None
+
+    if isinstance(v, dict):
+        return {
+            k_: _get_value(
+                cls,
+                v_,
+                to_dict=to_dict,
+                by_alias=by_alias,
+                exclude_unset=exclude_unset,
+                exclude_defaults=exclude_defaults,
+                include=value_include and value_include.for_element(k_),
+                exclude=value_exclude and value_exclude.for_element(k_),
+                exclude_none=exclude_none,
+            )
+            for k_, v_ in v.items()
+            if (not value_exclude or not value_exclude.is_excluded(k_))
+            and (not value_include or value_include.is_included(k_))
+        }
+
+    elif _utils.sequence_like(v):
+        seq_args = (
+            _get_value(
+                cls,
+                v_,
+                to_dict=to_dict,
+                by_alias=by_alias,
+                exclude_unset=exclude_unset,
+                exclude_defaults=exclude_defaults,
+                include=value_include and value_include.for_element(i),
+                exclude=value_exclude and value_exclude.for_element(i),
+                exclude_none=exclude_none,
+            )
+            for i, v_ in enumerate(v)
+            if (not value_exclude or not value_exclude.is_excluded(i))
+            and (not value_include or value_include.is_included(i))
+        )
+
+        return v.__class__(*seq_args) if _typing_extra.is_namedtuple(v.__class__) else v.__class__(seq_args)
+
+    elif isinstance(v, Enum) and getattr(cls.model_config, 'use_enum_values', False):
+        return v.value
+
+    else:
+        return v
+
+
+def _calculate_keys(
+    self: BaseModel,
+    include: MappingIntStrAny | None,
+    exclude: MappingIntStrAny | None,
+    exclude_unset: bool,
+    update: typing.Dict[str, Any] | None = None,  # noqa UP006
+) -> typing.AbstractSet[str] | None:
+    if include is None and exclude is None and exclude_unset is False:
+        return None
+
+    keys: typing.AbstractSet[str]
+    if exclude_unset:
+        keys = self.__pydantic_fields_set__.copy()
+    else:
+        keys = set(self.__dict__.keys())
+        keys = keys | (self.__pydantic_extra__ or {}).keys()
+
+    if include is not None:
+        keys &= include.keys()
+
+    if update:
+        keys -= update.keys()
+
+    if exclude:
+        keys -= {k for k, v in exclude.items() if _utils.ValueItems.is_true(v)}
+
+    return keys
diff --git a/lib/pydantic/deprecated/decorator.py b/lib/pydantic/deprecated/decorator.py
new file mode 100644
index 00000000..36bd0690
--- /dev/null
+++ b/lib/pydantic/deprecated/decorator.py
@@ -0,0 +1,279 @@
+import warnings
+from functools import wraps
+from typing import TYPE_CHECKING, Any, Callable, Dict, List, Mapping, Optional, Tuple, Type, TypeVar, Union, overload
+
+from typing_extensions import deprecated
+
+from .._internal import _config, _typing_extra
+from ..alias_generators import to_pascal
+from ..errors import PydanticUserError
+from ..functional_validators import field_validator
+from ..main import BaseModel, create_model
+from ..warnings import PydanticDeprecatedSince20
+
+if not TYPE_CHECKING:
+    # See PyCharm issues https://youtrack.jetbrains.com/issue/PY-21915
+    # and https://youtrack.jetbrains.com/issue/PY-51428
+    DeprecationWarning = PydanticDeprecatedSince20
+
+__all__ = ('validate_arguments',)
+
+if TYPE_CHECKING:
+    AnyCallable = Callable[..., Any]
+
+    AnyCallableT = TypeVar('AnyCallableT', bound=AnyCallable)
+    ConfigType = Union[None, Type[Any], Dict[str, Any]]
+
+
+@overload
+def validate_arguments(func: None = None, *, config: 'ConfigType' = None) -> Callable[['AnyCallableT'], 'AnyCallableT']:
+    ...
+
+
+@overload
+def validate_arguments(func: 'AnyCallableT') -> 'AnyCallableT':
+    ...
+
+
+@deprecated(
+    'The `validate_arguments` method is deprecated; use `validate_call` instead.',
+    category=None,
+)
+def validate_arguments(func: Optional['AnyCallableT'] = None, *, config: 'ConfigType' = None) -> Any:
+    """Decorator to validate the arguments passed to a function."""
+    warnings.warn(
+        'The `validate_arguments` method is deprecated; use `validate_call` instead.',
+        PydanticDeprecatedSince20,
+        stacklevel=2,
+    )
+
+    def validate(_func: 'AnyCallable') -> 'AnyCallable':
+        vd = ValidatedFunction(_func, config)
+
+        @wraps(_func)
+        def wrapper_function(*args: Any, **kwargs: Any) -> Any:
+            return vd.call(*args, **kwargs)
+
+        wrapper_function.vd = vd  # type: ignore
+        wrapper_function.validate = vd.init_model_instance  # type: ignore
+        wrapper_function.raw_function = vd.raw_function  # type: ignore
+        wrapper_function.model = vd.model  # type: ignore
+        return wrapper_function
+
+    if func:
+        return validate(func)
+    else:
+        return validate
+
+
+ALT_V_ARGS = 'v__args'
+ALT_V_KWARGS = 'v__kwargs'
+V_POSITIONAL_ONLY_NAME = 'v__positional_only'
+V_DUPLICATE_KWARGS = 'v__duplicate_kwargs'
+
+
+class ValidatedFunction:
+    def __init__(self, function: 'AnyCallable', config: 'ConfigType'):
+        from inspect import Parameter, signature
+
+        parameters: Mapping[str, Parameter] = signature(function).parameters
+
+        if parameters.keys() & {ALT_V_ARGS, ALT_V_KWARGS, V_POSITIONAL_ONLY_NAME, V_DUPLICATE_KWARGS}:
+            raise PydanticUserError(
+                f'"{ALT_V_ARGS}", "{ALT_V_KWARGS}", "{V_POSITIONAL_ONLY_NAME}" and "{V_DUPLICATE_KWARGS}" '
+                f'are not permitted as argument names when using the "{validate_arguments.__name__}" decorator',
+                code=None,
+            )
+
+        self.raw_function = function
+        self.arg_mapping: Dict[int, str] = {}
+        self.positional_only_args: set[str] = set()
+        self.v_args_name = 'args'
+        self.v_kwargs_name = 'kwargs'
+
+        type_hints = _typing_extra.get_type_hints(function, include_extras=True)
+        takes_args = False
+        takes_kwargs = False
+        fields: Dict[str, Tuple[Any, Any]] = {}
+        for i, (name, p) in enumerate(parameters.items()):
+            if p.annotation is p.empty:
+                annotation = Any
+            else:
+                annotation = type_hints[name]
+
+            default = ... if p.default is p.empty else p.default
+            if p.kind == Parameter.POSITIONAL_ONLY:
+                self.arg_mapping[i] = name
+                fields[name] = annotation, default
+                fields[V_POSITIONAL_ONLY_NAME] = List[str], None
+                self.positional_only_args.add(name)
+            elif p.kind == Parameter.POSITIONAL_OR_KEYWORD:
+                self.arg_mapping[i] = name
+                fields[name] = annotation, default
+                fields[V_DUPLICATE_KWARGS] = List[str], None
+            elif p.kind == Parameter.KEYWORD_ONLY:
+                fields[name] = annotation, default
+            elif p.kind == Parameter.VAR_POSITIONAL:
+                self.v_args_name = name
+                fields[name] = Tuple[annotation, ...], None
+                takes_args = True
+            else:
+                assert p.kind == Parameter.VAR_KEYWORD, p.kind
+                self.v_kwargs_name = name
+                fields[name] = Dict[str, annotation], None
+                takes_kwargs = True
+
+        # these checks avoid a clash between "args" and a field with that name
+        if not takes_args and self.v_args_name in fields:
+            self.v_args_name = ALT_V_ARGS
+
+        # same with "kwargs"
+        if not takes_kwargs and self.v_kwargs_name in fields:
+            self.v_kwargs_name = ALT_V_KWARGS
+
+        if not takes_args:
+            # we add the field so validation below can raise the correct exception
+            fields[self.v_args_name] = List[Any], None
+
+        if not takes_kwargs:
+            # same with kwargs
+            fields[self.v_kwargs_name] = Dict[Any, Any], None
+
+        self.create_model(fields, takes_args, takes_kwargs, config)
+
+    def init_model_instance(self, *args: Any, **kwargs: Any) -> BaseModel:
+        values = self.build_values(args, kwargs)
+        return self.model(**values)
+
+    def call(self, *args: Any, **kwargs: Any) -> Any:
+        m = self.init_model_instance(*args, **kwargs)
+        return self.execute(m)
+
+    def build_values(self, args: Tuple[Any, ...], kwargs: Dict[str, Any]) -> Dict[str, Any]:
+        values: Dict[str, Any] = {}
+        if args:
+            arg_iter = enumerate(args)
+            while True:
+                try:
+                    i, a = next(arg_iter)
+                except StopIteration:
+                    break
+                arg_name = self.arg_mapping.get(i)
+                if arg_name is not None:
+                    values[arg_name] = a
+                else:
+                    values[self.v_args_name] = [a] + [a for _, a in arg_iter]
+                    break
+
+        var_kwargs: Dict[str, Any] = {}
+        wrong_positional_args = []
+        duplicate_kwargs = []
+        fields_alias = [
+            field.alias
+            for name, field in self.model.model_fields.items()
+            if name not in (self.v_args_name, self.v_kwargs_name)
+        ]
+        non_var_fields = set(self.model.model_fields) - {self.v_args_name, self.v_kwargs_name}
+        for k, v in kwargs.items():
+            if k in non_var_fields or k in fields_alias:
+                if k in self.positional_only_args:
+                    wrong_positional_args.append(k)
+                if k in values:
+                    duplicate_kwargs.append(k)
+                values[k] = v
+            else:
+                var_kwargs[k] = v
+
+        if var_kwargs:
+            values[self.v_kwargs_name] = var_kwargs
+        if wrong_positional_args:
+            values[V_POSITIONAL_ONLY_NAME] = wrong_positional_args
+        if duplicate_kwargs:
+            values[V_DUPLICATE_KWARGS] = duplicate_kwargs
+        return values
+
+    def execute(self, m: BaseModel) -> Any:
+        d = {k: v for k, v in m.__dict__.items() if k in m.__pydantic_fields_set__ or m.model_fields[k].default_factory}
+        var_kwargs = d.pop(self.v_kwargs_name, {})
+
+        if self.v_args_name in d:
+            args_: List[Any] = []
+            in_kwargs = False
+            kwargs = {}
+            for name, value in d.items():
+                if in_kwargs:
+                    kwargs[name] = value
+                elif name == self.v_args_name:
+                    args_ += value
+                    in_kwargs = True
+                else:
+                    args_.append(value)
+            return self.raw_function(*args_, **kwargs, **var_kwargs)
+        elif self.positional_only_args:
+            args_ = []
+            kwargs = {}
+            for name, value in d.items():
+                if name in self.positional_only_args:
+                    args_.append(value)
+                else:
+                    kwargs[name] = value
+            return self.raw_function(*args_, **kwargs, **var_kwargs)
+        else:
+            return self.raw_function(**d, **var_kwargs)
+
+    def create_model(self, fields: Dict[str, Any], takes_args: bool, takes_kwargs: bool, config: 'ConfigType') -> None:
+        pos_args = len(self.arg_mapping)
+
+        config_wrapper = _config.ConfigWrapper(config)
+
+        if config_wrapper.alias_generator:
+            raise PydanticUserError(
+                'Setting the "alias_generator" property on custom Config for '
+                '@validate_arguments is not yet supported, please remove.',
+                code=None,
+            )
+        if config_wrapper.extra is None:
+            config_wrapper.config_dict['extra'] = 'forbid'
+
+        class DecoratorBaseModel(BaseModel):
+            @field_validator(self.v_args_name, check_fields=False)
+            @classmethod
+            def check_args(cls, v: Optional[List[Any]]) -> Optional[List[Any]]:
+                if takes_args or v is None:
+                    return v
+
+                raise TypeError(f'{pos_args} positional arguments expected but {pos_args + len(v)} given')
+
+            @field_validator(self.v_kwargs_name, check_fields=False)
+            @classmethod
+            def check_kwargs(cls, v: Optional[Dict[str, Any]]) -> Optional[Dict[str, Any]]:
+                if takes_kwargs or v is None:
+                    return v
+
+                plural = '' if len(v) == 1 else 's'
+                keys = ', '.join(map(repr, v.keys()))
+                raise TypeError(f'unexpected keyword argument{plural}: {keys}')
+
+            @field_validator(V_POSITIONAL_ONLY_NAME, check_fields=False)
+            @classmethod
+            def check_positional_only(cls, v: Optional[List[str]]) -> None:
+                if v is None:
+                    return
+
+                plural = '' if len(v) == 1 else 's'
+                keys = ', '.join(map(repr, v))
+                raise TypeError(f'positional-only argument{plural} passed as keyword argument{plural}: {keys}')
+
+            @field_validator(V_DUPLICATE_KWARGS, check_fields=False)
+            @classmethod
+            def check_duplicate_kwargs(cls, v: Optional[List[str]]) -> None:
+                if v is None:
+                    return
+
+                plural = '' if len(v) == 1 else 's'
+                keys = ', '.join(map(repr, v))
+                raise TypeError(f'multiple values for argument{plural}: {keys}')
+
+            model_config = config_wrapper.config_dict
+
+        self.model = create_model(to_pascal(self.raw_function.__name__), __base__=DecoratorBaseModel, **fields)
diff --git a/lib/pydantic/deprecated/json.py b/lib/pydantic/deprecated/json.py
new file mode 100644
index 00000000..79e2f44a
--- /dev/null
+++ b/lib/pydantic/deprecated/json.py
@@ -0,0 +1,140 @@
+import datetime
+import warnings
+from collections import deque
+from decimal import Decimal
+from enum import Enum
+from ipaddress import IPv4Address, IPv4Interface, IPv4Network, IPv6Address, IPv6Interface, IPv6Network
+from pathlib import Path
+from re import Pattern
+from types import GeneratorType
+from typing import TYPE_CHECKING, Any, Callable, Dict, Type, Union
+from uuid import UUID
+
+from typing_extensions import deprecated
+
+from ..color import Color
+from ..networks import NameEmail
+from ..types import SecretBytes, SecretStr
+from ..warnings import PydanticDeprecatedSince20
+
+if not TYPE_CHECKING:
+    # See PyCharm issues https://youtrack.jetbrains.com/issue/PY-21915
+    # and https://youtrack.jetbrains.com/issue/PY-51428
+    DeprecationWarning = PydanticDeprecatedSince20
+
+__all__ = 'pydantic_encoder', 'custom_pydantic_encoder', 'timedelta_isoformat'
+
+
+def isoformat(o: Union[datetime.date, datetime.time]) -> str:
+    return o.isoformat()
+
+
+def decimal_encoder(dec_value: Decimal) -> Union[int, float]:
+    """Encodes a Decimal as int of there's no exponent, otherwise float.
+
+    This is useful when we use ConstrainedDecimal to represent Numeric(x,0)
+    where a integer (but not int typed) is used. Encoding this as a float
+    results in failed round-tripping between encode and parse.
+    Our Id type is a prime example of this.
+
+    >>> decimal_encoder(Decimal("1.0"))
+    1.0
+
+    >>> decimal_encoder(Decimal("1"))
+    1
+    """
+    exponent = dec_value.as_tuple().exponent
+    if isinstance(exponent, int) and exponent >= 0:
+        return int(dec_value)
+    else:
+        return float(dec_value)
+
+
+ENCODERS_BY_TYPE: Dict[Type[Any], Callable[[Any], Any]] = {
+    bytes: lambda o: o.decode(),
+    Color: str,
+    datetime.date: isoformat,
+    datetime.datetime: isoformat,
+    datetime.time: isoformat,
+    datetime.timedelta: lambda td: td.total_seconds(),
+    Decimal: decimal_encoder,
+    Enum: lambda o: o.value,
+    frozenset: list,
+    deque: list,
+    GeneratorType: list,
+    IPv4Address: str,
+    IPv4Interface: str,
+    IPv4Network: str,
+    IPv6Address: str,
+    IPv6Interface: str,
+    IPv6Network: str,
+    NameEmail: str,
+    Path: str,
+    Pattern: lambda o: o.pattern,
+    SecretBytes: str,
+    SecretStr: str,
+    set: list,
+    UUID: str,
+}
+
+
+@deprecated(
+    '`pydantic_encoder` is deprecated, use `pydantic_core.to_jsonable_python` instead.',
+    category=None,
+)
+def pydantic_encoder(obj: Any) -> Any:
+    warnings.warn(
+        '`pydantic_encoder` is deprecated, use `pydantic_core.to_jsonable_python` instead.',
+        category=PydanticDeprecatedSince20,
+        stacklevel=2,
+    )
+    from dataclasses import asdict, is_dataclass
+
+    from ..main import BaseModel
+
+    if isinstance(obj, BaseModel):
+        return obj.model_dump()
+    elif is_dataclass(obj):
+        return asdict(obj)
+
+    # Check the class type and its superclasses for a matching encoder
+    for base in obj.__class__.__mro__[:-1]:
+        try:
+            encoder = ENCODERS_BY_TYPE[base]
+        except KeyError:
+            continue
+        return encoder(obj)
+    else:  # We have exited the for loop without finding a suitable encoder
+        raise TypeError(f"Object of type '{obj.__class__.__name__}' is not JSON serializable")
+
+
+# TODO: Add a suggested migration path once there is a way to use custom encoders
+@deprecated(
+    '`custom_pydantic_encoder` is deprecated, use `BaseModel.model_dump` instead.',
+    category=None,
+)
+def custom_pydantic_encoder(type_encoders: Dict[Any, Callable[[Type[Any]], Any]], obj: Any) -> Any:
+    warnings.warn(
+        '`custom_pydantic_encoder` is deprecated, use `BaseModel.model_dump` instead.',
+        category=PydanticDeprecatedSince20,
+        stacklevel=2,
+    )
+    # Check the class type and its superclasses for a matching encoder
+    for base in obj.__class__.__mro__[:-1]:
+        try:
+            encoder = type_encoders[base]
+        except KeyError:
+            continue
+
+        return encoder(obj)
+    else:  # We have exited the for loop without finding a suitable encoder
+        return pydantic_encoder(obj)
+
+
+@deprecated('`timedelta_isoformat` is deprecated.', category=None)
+def timedelta_isoformat(td: datetime.timedelta) -> str:
+    """ISO 8601 encoding for Python timedelta object."""
+    warnings.warn('`timedelta_isoformat` is deprecated.', category=PydanticDeprecatedSince20, stacklevel=2)
+    minutes, seconds = divmod(td.seconds, 60)
+    hours, minutes = divmod(minutes, 60)
+    return f'{"-" if td.days < 0 else ""}P{abs(td.days)}DT{hours:d}H{minutes:d}M{seconds:d}.{td.microseconds:06d}S'
diff --git a/lib/pydantic/deprecated/parse.py b/lib/pydantic/deprecated/parse.py
new file mode 100644
index 00000000..2a92e62b
--- /dev/null
+++ b/lib/pydantic/deprecated/parse.py
@@ -0,0 +1,80 @@
+from __future__ import annotations
+
+import json
+import pickle
+import warnings
+from enum import Enum
+from pathlib import Path
+from typing import TYPE_CHECKING, Any, Callable
+
+from typing_extensions import deprecated
+
+from ..warnings import PydanticDeprecatedSince20
+
+if not TYPE_CHECKING:
+    # See PyCharm issues https://youtrack.jetbrains.com/issue/PY-21915
+    # and https://youtrack.jetbrains.com/issue/PY-51428
+    DeprecationWarning = PydanticDeprecatedSince20
+
+
+class Protocol(str, Enum):
+    json = 'json'
+    pickle = 'pickle'
+
+
+@deprecated('`load_str_bytes` is deprecated.', category=None)
+def load_str_bytes(
+    b: str | bytes,
+    *,
+    content_type: str | None = None,
+    encoding: str = 'utf8',
+    proto: Protocol | None = None,
+    allow_pickle: bool = False,
+    json_loads: Callable[[str], Any] = json.loads,
+) -> Any:
+    warnings.warn('`load_str_bytes` is deprecated.', category=PydanticDeprecatedSince20, stacklevel=2)
+    if proto is None and content_type:
+        if content_type.endswith(('json', 'javascript')):
+            pass
+        elif allow_pickle and content_type.endswith('pickle'):
+            proto = Protocol.pickle
+        else:
+            raise TypeError(f'Unknown content-type: {content_type}')
+
+    proto = proto or Protocol.json
+
+    if proto == Protocol.json:
+        if isinstance(b, bytes):
+            b = b.decode(encoding)
+        return json_loads(b)  # type: ignore
+    elif proto == Protocol.pickle:
+        if not allow_pickle:
+            raise RuntimeError('Trying to decode with pickle with allow_pickle=False')
+        bb = b if isinstance(b, bytes) else b.encode()  # type: ignore
+        return pickle.loads(bb)
+    else:
+        raise TypeError(f'Unknown protocol: {proto}')
+
+
+@deprecated('`load_file` is deprecated.', category=None)
+def load_file(
+    path: str | Path,
+    *,
+    content_type: str | None = None,
+    encoding: str = 'utf8',
+    proto: Protocol | None = None,
+    allow_pickle: bool = False,
+    json_loads: Callable[[str], Any] = json.loads,
+) -> Any:
+    warnings.warn('`load_file` is deprecated.', category=PydanticDeprecatedSince20, stacklevel=2)
+    path = Path(path)
+    b = path.read_bytes()
+    if content_type is None:
+        if path.suffix in ('.js', '.json'):
+            proto = Protocol.json
+        elif path.suffix == '.pkl':
+            proto = Protocol.pickle
+
+    return load_str_bytes(
+        b, proto=proto, content_type=content_type, encoding=encoding, allow_pickle=allow_pickle, json_loads=json_loads
+    )
diff --git a/lib/pydantic/deprecated/tools.py b/lib/pydantic/deprecated/tools.py
new file mode 100644
index 00000000..b04eae40
--- /dev/null
+++ b/lib/pydantic/deprecated/tools.py
@@ -0,0 +1,103 @@
+from __future__ import annotations
+
+import json
+import warnings
+from typing import TYPE_CHECKING, Any, Callable, Type, TypeVar, Union
+
+from typing_extensions import deprecated
+
+from ..json_schema import DEFAULT_REF_TEMPLATE, GenerateJsonSchema
+from ..type_adapter import TypeAdapter
+from ..warnings import PydanticDeprecatedSince20
+
+if not TYPE_CHECKING:
+    # See PyCharm issues https://youtrack.jetbrains.com/issue/PY-21915
+    # and https://youtrack.jetbrains.com/issue/PY-51428
+    DeprecationWarning = PydanticDeprecatedSince20
+
+__all__ = 'parse_obj_as', 'schema_of', 'schema_json_of'
+
+NameFactory = Union[str, Callable[[Type[Any]], str]]
+
+
+T = TypeVar('T')
+
+
+@deprecated(
+    '`parse_obj_as` is deprecated. Use `pydantic.TypeAdapter.validate_python` instead.',
+    category=None,
+)
+def parse_obj_as(type_: type[T], obj: Any, type_name: NameFactory | None = None) -> T:
+    warnings.warn(
+        '`parse_obj_as` is deprecated. Use `pydantic.TypeAdapter.validate_python` instead.',
+        category=PydanticDeprecatedSince20,
+        stacklevel=2,
+    )
+    if type_name is not None:  # pragma: no cover
+        warnings.warn(
+            'The type_name parameter is deprecated. parse_obj_as no longer creates temporary models',
+            DeprecationWarning,
+            stacklevel=2,
+        )
+    return TypeAdapter(type_).validate_python(obj)
+
+
+@deprecated(
+    '`schema_of` is deprecated. Use `pydantic.TypeAdapter.json_schema` instead.',
+    category=None,
+)
+def schema_of(
+    type_: Any,
+    *,
+    title: NameFactory | None = None,
+    by_alias: bool = True,
+    ref_template: str = DEFAULT_REF_TEMPLATE,
+    schema_generator: type[GenerateJsonSchema] = GenerateJsonSchema,
+) -> dict[str, Any]:
+    """Generate a JSON schema (as dict) for the passed model or dynamically generated one."""
+    warnings.warn(
+        '`schema_of` is deprecated. Use `pydantic.TypeAdapter.json_schema` instead.',
+        category=PydanticDeprecatedSince20,
+        stacklevel=2,
+    )
+    res = TypeAdapter(type_).json_schema(
+        by_alias=by_alias,
+        schema_generator=schema_generator,
+        ref_template=ref_template,
+    )
+    if title is not None:
+        if isinstance(title, str):
+            res['title'] = title
+        else:
+            warnings.warn(
+                'Passing a callable for the `title` parameter is deprecated and no longer supported',
+                DeprecationWarning,
+                stacklevel=2,
+            )
+            res['title'] = title(type_)
+    return res
+
+
+@deprecated(
+    '`schema_json_of` is deprecated. Use `pydantic.TypeAdapter.json_schema` instead.',
+    category=None,
+)
+def schema_json_of(
+    type_: Any,
+    *,
+    title: NameFactory | None = None,
+    by_alias: bool = True,
+    ref_template: str = DEFAULT_REF_TEMPLATE,
+    schema_generator: type[GenerateJsonSchema] = GenerateJsonSchema,
+    **dumps_kwargs: Any,
+) -> str:
+    """Generate a JSON schema (as JSON) for the passed model or dynamically generated one."""
+    warnings.warn(
+        '`schema_json_of` is deprecated. Use `pydantic.TypeAdapter.json_schema` instead.',
+        category=PydanticDeprecatedSince20,
+        stacklevel=2,
+    )
+    return json.dumps(
+        schema_of(type_, title=title, by_alias=by_alias, ref_template=ref_template, schema_generator=schema_generator),
+        **dumps_kwargs,
+    )
diff --git a/lib/pydantic/env_settings.py b/lib/pydantic/env_settings.py
index e9988c01..662f5900 100644
--- a/lib/pydantic/env_settings.py
+++ b/lib/pydantic/env_settings.py
@@ -1,346 +1,4 @@
-import os
-import warnings
-from pathlib import Path
-from typing import AbstractSet, Any, Callable, ClassVar, Dict, List, Mapping, Optional, Tuple, Type, Union
+"""The `env_settings` module is a backport module from V1."""
+from ._migration import getattr_migration
 
-from .config import BaseConfig, Extra
-from .fields import ModelField
-from .main import BaseModel
-from .typing import StrPath, display_as_type, get_origin, is_union
-from .utils import deep_update, path_type, sequence_like
-
-env_file_sentinel = str(object())
-
-SettingsSourceCallable = Callable[['BaseSettings'], Dict[str, Any]]
-DotenvType = Union[StrPath, List[StrPath], Tuple[StrPath, ...]]
-
-
-class SettingsError(ValueError):
-    pass
-
-
-class BaseSettings(BaseModel):
-    """
-    Base class for settings, allowing values to be overridden by environment variables.
-
-    This is useful in production for secrets you do not wish to save in code, it plays nicely with docker(-compose),
-    Heroku and any 12 factor app design.
-    """
-
-    def __init__(
-        __pydantic_self__,
-        _env_file: Optional[DotenvType] = env_file_sentinel,
-        _env_file_encoding: Optional[str] = None,
-        _env_nested_delimiter: Optional[str] = None,
-        _secrets_dir: Optional[StrPath] = None,
-        **values: Any,
-    ) -> None:
-        # Uses something other than `self` the first arg to allow "self" as a settable attribute
-        super().__init__(
-            **__pydantic_self__._build_values(
-                values,
-                _env_file=_env_file,
-                _env_file_encoding=_env_file_encoding,
-                _env_nested_delimiter=_env_nested_delimiter,
-                _secrets_dir=_secrets_dir,
-            )
-        )
-
-    def _build_values(
-        self,
-        init_kwargs: Dict[str, Any],
-        _env_file: Optional[DotenvType] = None,
-        _env_file_encoding: Optional[str] = None,
-        _env_nested_delimiter: Optional[str] = None,
-        _secrets_dir: Optional[StrPath] = None,
-    ) -> Dict[str, Any]:
-        # Configure built-in sources
-        init_settings = InitSettingsSource(init_kwargs=init_kwargs)
-        env_settings = EnvSettingsSource(
-            env_file=(_env_file if _env_file != env_file_sentinel else self.__config__.env_file),
-            env_file_encoding=(
-                _env_file_encoding if _env_file_encoding is not None else self.__config__.env_file_encoding
-            ),
-            env_nested_delimiter=(
-                _env_nested_delimiter if _env_nested_delimiter is not None else self.__config__.env_nested_delimiter
-            ),
-            env_prefix_len=len(self.__config__.env_prefix),
-        )
-        file_secret_settings = SecretsSettingsSource(secrets_dir=_secrets_dir or self.__config__.secrets_dir)
-        # Provide a hook to set built-in sources priority and add / remove sources
-        sources = self.__config__.customise_sources(
-            init_settings=init_settings, env_settings=env_settings, file_secret_settings=file_secret_settings
-        )
-        if sources:
-            return deep_update(*reversed([source(self) for source in sources]))
-        else:
-            # no one should mean to do this, but I think returning an empty dict is marginally preferable
-            # to an informative error and much better than a confusing error
-            return {}
-
-    class Config(BaseConfig):
-        env_prefix: str = ''
-        env_file: Optional[DotenvType] = None
-        env_file_encoding: Optional[str] = None
-        env_nested_delimiter: Optional[str] = None
-        secrets_dir: Optional[StrPath] = None
-        validate_all: bool = True
-        extra: Extra = Extra.forbid
-        arbitrary_types_allowed: bool = True
-        case_sensitive: bool = False
-
-        @classmethod
-        def prepare_field(cls, field: ModelField) -> None:
-            env_names: Union[List[str], AbstractSet[str]]
-            field_info_from_config = cls.get_field_info(field.name)
-
-            env = field_info_from_config.get('env') or field.field_info.extra.get('env')
-            if env is None:
-                if field.has_alias:
-                    warnings.warn(
-                        'aliases are no longer used by BaseSettings to define which environment variables to read. '
-                        'Instead use the "env" field setting. '
-                        'See https://pydantic-docs.helpmanual.io/usage/settings/#environment-variable-names',
-                        FutureWarning,
-                    )
-                env_names = {cls.env_prefix + field.name}
-            elif isinstance(env, str):
-                env_names = {env}
-            elif isinstance(env, (set, frozenset)):
-                env_names = env
-            elif sequence_like(env):
-                env_names = list(env)
-            else:
-                raise TypeError(f'invalid field env: {env!r} ({display_as_type(env)}); should be string, list or set')
-
-            if not cls.case_sensitive:
-                env_names = env_names.__class__(n.lower() for n in env_names)
-            field.field_info.extra['env_names'] = env_names
-
-        @classmethod
-        def customise_sources(
-            cls,
-            init_settings: SettingsSourceCallable,
-            env_settings: SettingsSourceCallable,
-            file_secret_settings: SettingsSourceCallable,
-        ) -> Tuple[SettingsSourceCallable, ...]:
-            return init_settings, env_settings, file_secret_settings
-
-        @classmethod
-        def parse_env_var(cls, field_name: str, raw_val: str) -> Any:
-            return cls.json_loads(raw_val)
-
-    # populated by the metaclass using the Config class defined above, annotated here to help IDEs only
-    __config__: ClassVar[Type[Config]]
-
-
-class InitSettingsSource:
-    __slots__ = ('init_kwargs',)
-
-    def __init__(self, init_kwargs: Dict[str, Any]):
-        self.init_kwargs = init_kwargs
-
-    def __call__(self, settings: BaseSettings) -> Dict[str, Any]:
-        return self.init_kwargs
-
-    def __repr__(self) -> str:
-        return f'InitSettingsSource(init_kwargs={self.init_kwargs!r})'
-
-
-class EnvSettingsSource:
-    __slots__ = ('env_file', 'env_file_encoding', 'env_nested_delimiter', 'env_prefix_len')
-
-    def __init__(
-        self,
-        env_file: Optional[DotenvType],
-        env_file_encoding: Optional[str],
-        env_nested_delimiter: Optional[str] = None,
-        env_prefix_len: int = 0,
-    ):
-        self.env_file: Optional[DotenvType] = env_file
-        self.env_file_encoding: Optional[str] = env_file_encoding
-        self.env_nested_delimiter: Optional[str] = env_nested_delimiter
-        self.env_prefix_len: int = env_prefix_len
-
-    def __call__(self, settings: BaseSettings) -> Dict[str, Any]:  # noqa C901
-        """
-        Build environment variables suitable for passing to the Model.
-        """
-        d: Dict[str, Any] = {}
-
-        if settings.__config__.case_sensitive:
-            env_vars: Mapping[str, Optional[str]] = os.environ
-        else:
-            env_vars = {k.lower(): v for k, v in os.environ.items()}
-
-        dotenv_vars = self._read_env_files(settings.__config__.case_sensitive)
-        if dotenv_vars:
-            env_vars = {**dotenv_vars, **env_vars}
-
-        for field in settings.__fields__.values():
-            env_val: Optional[str] = None
-            for env_name in field.field_info.extra['env_names']:
-                env_val = env_vars.get(env_name)
-                if env_val is not None:
-                    break
-
-            is_complex, allow_parse_failure = self.field_is_complex(field)
-            if is_complex:
-                if env_val is None:
-                    # field is complex but no value found so far, try explode_env_vars
-                    env_val_built = self.explode_env_vars(field, env_vars)
-                    if env_val_built:
-                        d[field.alias] = env_val_built
-                else:
-                    # field is complex and there's a value, decode that as JSON, then add explode_env_vars
-                    try:
-                        env_val = settings.__config__.parse_env_var(field.name, env_val)
-                    except ValueError as e:
-                        if not allow_parse_failure:
-                            raise SettingsError(f'error parsing env var "{env_name}"') from e
-
-                    if isinstance(env_val, dict):
-                        d[field.alias] = deep_update(env_val, self.explode_env_vars(field, env_vars))
-                    else:
-                        d[field.alias] = env_val
-            elif env_val is not None:
-                # simplest case, field is not complex, we only need to add the value if it was found
-                d[field.alias] = env_val
-
-        return d
-
-    def _read_env_files(self, case_sensitive: bool) -> Dict[str, Optional[str]]:
-        env_files = self.env_file
-        if env_files is None:
-            return {}
-
-        if isinstance(env_files, (str, os.PathLike)):
-            env_files = [env_files]
-
-        dotenv_vars = {}
-        for env_file in env_files:
-            env_path = Path(env_file).expanduser()
-            if env_path.is_file():
-                dotenv_vars.update(
-                    read_env_file(env_path, encoding=self.env_file_encoding, case_sensitive=case_sensitive)
-                )
-
-        return dotenv_vars
-
-    def field_is_complex(self, field: ModelField) -> Tuple[bool, bool]:
-        """
-        Find out if a field is complex, and if so whether JSON errors should be ignored
-        """
-        if field.is_complex():
-            allow_parse_failure = False
-        elif is_union(get_origin(field.type_)) and field.sub_fields and any(f.is_complex() for f in field.sub_fields):
-            allow_parse_failure = True
-        else:
-            return False, False
-
-        return True, allow_parse_failure
-
-    def explode_env_vars(self, field: ModelField, env_vars: Mapping[str, Optional[str]]) -> Dict[str, Any]:
-        """
-        Process env_vars and extract the values of keys containing env_nested_delimiter into nested dictionaries.
-
-        This is applied to a single field, hence filtering by env_var prefix.
-        """
-        prefixes = [f'{env_name}{self.env_nested_delimiter}' for env_name in field.field_info.extra['env_names']]
-        result: Dict[str, Any] = {}
-        for env_name, env_val in env_vars.items():
-            if not any(env_name.startswith(prefix) for prefix in prefixes):
-                continue
-            # we remove the prefix before splitting in case the prefix has characters in common with the delimiter
-            env_name_without_prefix = env_name[self.env_prefix_len :]
-            _, *keys, last_key = env_name_without_prefix.split(self.env_nested_delimiter)
-            env_var = result
-            for key in keys:
-                env_var = env_var.setdefault(key, {})
-            env_var[last_key] = env_val
-
-        return result
-
-    def __repr__(self) -> str:
-        return (
-            f'EnvSettingsSource(env_file={self.env_file!r}, env_file_encoding={self.env_file_encoding!r}, '
-            f'env_nested_delimiter={self.env_nested_delimiter!r})'
-        )
-
-
-class SecretsSettingsSource:
-    __slots__ = ('secrets_dir',)
-
-    def __init__(self, secrets_dir: Optional[StrPath]):
-        self.secrets_dir: Optional[StrPath] = secrets_dir
-
-    def __call__(self, settings: BaseSettings) -> Dict[str, Any]:
-        """
-        Build fields from "secrets" files.
-        """
-        secrets: Dict[str, Optional[str]] = {}
-
-        if self.secrets_dir is None:
-            return secrets
-
-        secrets_path = Path(self.secrets_dir).expanduser()
-
-        if not secrets_path.exists():
-            warnings.warn(f'directory "{secrets_path}" does not exist')
-            return secrets
-
-        if not secrets_path.is_dir():
-            raise SettingsError(f'secrets_dir must reference a directory, not a {path_type(secrets_path)}')
-
-        for field in settings.__fields__.values():
-            for env_name in field.field_info.extra['env_names']:
-                path = find_case_path(secrets_path, env_name, settings.__config__.case_sensitive)
-                if not path:
-                    # path does not exist, we curently don't return a warning for this
-                    continue
-
-                if path.is_file():
-                    secret_value = path.read_text().strip()
-                    if field.is_complex():
-                        try:
-                            secret_value = settings.__config__.parse_env_var(field.name, secret_value)
-                        except ValueError as e:
-                            raise SettingsError(f'error parsing env var "{env_name}"') from e
-
-                    secrets[field.alias] = secret_value
-                else:
-                    warnings.warn(
-                        f'attempted to load secret file "{path}" but found a {path_type(path)} instead.',
-                        stacklevel=4,
-                    )
-        return secrets
-
-    def __repr__(self) -> str:
-        return f'SecretsSettingsSource(secrets_dir={self.secrets_dir!r})'
-
-
-def read_env_file(
-    file_path: StrPath, *, encoding: str = None, case_sensitive: bool = False
-) -> Dict[str, Optional[str]]:
-    try:
-        from dotenv import dotenv_values
-    except ImportError as e:
-        raise ImportError('python-dotenv is not installed, run `pip install pydantic[dotenv]`') from e
-
-    file_vars: Dict[str, Optional[str]] = dotenv_values(file_path, encoding=encoding or 'utf8')
-    if not case_sensitive:
-        return {k.lower(): v for k, v in file_vars.items()}
-    else:
-        return file_vars
-
-
-def find_case_path(dir_path: Path, file_name: str, case_sensitive: bool) -> Optional[Path]:
-    """
-    Find a file within path's directory matching filename, optionally ignoring case.
-    """
-    for f in dir_path.iterdir():
-        if f.name == file_name:
-            return f
-        elif not case_sensitive and f.name.lower() == file_name.lower():
-            return f
-    return None
+__getattr__ = getattr_migration(__name__)
diff --git a/lib/pydantic/error_wrappers.py b/lib/pydantic/error_wrappers.py
index 5d3204f4..5144eeee 100644
--- a/lib/pydantic/error_wrappers.py
+++ b/lib/pydantic/error_wrappers.py
@@ -1,162 +1,4 @@
-import json
-from typing import TYPE_CHECKING, Any, Dict, Generator, List, Optional, Sequence, Tuple, Type, Union
+"""The `error_wrappers` module is a backport module from V1."""
+from ._migration import getattr_migration
 
-from .json import pydantic_encoder
-from .utils import Representation
-
-if TYPE_CHECKING:
-    from typing_extensions import TypedDict
-
-    from .config import BaseConfig
-    from .types import ModelOrDc
-    from .typing import ReprArgs
-
-    Loc = Tuple[Union[int, str], ...]
-
-    class _ErrorDictRequired(TypedDict):
-        loc: Loc
-        msg: str
-        type: str
-
-    class ErrorDict(_ErrorDictRequired, total=False):
-        ctx: Dict[str, Any]
-
-
-__all__ = 'ErrorWrapper', 'ValidationError'
-
-
-class ErrorWrapper(Representation):
-    __slots__ = 'exc', '_loc'
-
-    def __init__(self, exc: Exception, loc: Union[str, 'Loc']) -> None:
-        self.exc = exc
-        self._loc = loc
-
-    def loc_tuple(self) -> 'Loc':
-        if isinstance(self._loc, tuple):
-            return self._loc
-        else:
-            return (self._loc,)
-
-    def __repr_args__(self) -> 'ReprArgs':
-        return [('exc', self.exc), ('loc', self.loc_tuple())]
-
-
-# ErrorList is something like Union[List[Union[List[ErrorWrapper], ErrorWrapper]], ErrorWrapper]
-# but recursive, therefore just use:
-ErrorList = Union[Sequence[Any], ErrorWrapper]
-
-
-class ValidationError(Representation, ValueError):
-    __slots__ = 'raw_errors', 'model', '_error_cache'
-
-    def __init__(self, errors: Sequence[ErrorList], model: 'ModelOrDc') -> None:
-        self.raw_errors = errors
-        self.model = model
-        self._error_cache: Optional[List['ErrorDict']] = None
-
-    def errors(self) -> List['ErrorDict']:
-        if self._error_cache is None:
-            try:
-                config = self.model.__config__  # type: ignore
-            except AttributeError:
-                config = self.model.__pydantic_model__.__config__  # type: ignore
-            self._error_cache = list(flatten_errors(self.raw_errors, config))
-        return self._error_cache
-
-    def json(self, *, indent: Union[None, int, str] = 2) -> str:
-        return json.dumps(self.errors(), indent=indent, default=pydantic_encoder)
-
-    def __str__(self) -> str:
-        errors = self.errors()
-        no_errors = len(errors)
-        return (
-            f'{no_errors} validation error{"" if no_errors == 1 else "s"} for {self.model.__name__}\n'
-            f'{display_errors(errors)}'
-        )
-
-    def __repr_args__(self) -> 'ReprArgs':
-        return [('model', self.model.__name__), ('errors', self.errors())]
-
-
-def display_errors(errors: List['ErrorDict']) -> str:
-    return '\n'.join(f'{_display_error_loc(e)}\n  {e["msg"]} ({_display_error_type_and_ctx(e)})' for e in errors)
-
-
-def _display_error_loc(error: 'ErrorDict') -> str:
-    return ' -> '.join(str(e) for e in error['loc'])
-
-
-def _display_error_type_and_ctx(error: 'ErrorDict') -> str:
-    t = 'type=' + error['type']
-    ctx = error.get('ctx')
-    if ctx:
-        return t + ''.join(f'; {k}={v}' for k, v in ctx.items())
-    else:
-        return t
-
-
-def flatten_errors(
-    errors: Sequence[Any], config: Type['BaseConfig'], loc: Optional['Loc'] = None
-) -> Generator['ErrorDict', None, None]:
-    for error in errors:
-        if isinstance(error, ErrorWrapper):
-
-            if loc:
-                error_loc = loc + error.loc_tuple()
-            else:
-                error_loc = error.loc_tuple()
-
-            if isinstance(error.exc, ValidationError):
-                yield from flatten_errors(error.exc.raw_errors, config, error_loc)
-            else:
-                yield error_dict(error.exc, config, error_loc)
-        elif isinstance(error, list):
-            yield from flatten_errors(error, config, loc=loc)
-        else:
-            raise RuntimeError(f'Unknown error object: {error}')
-
-
-def error_dict(exc: Exception, config: Type['BaseConfig'], loc: 'Loc') -> 'ErrorDict':
-    type_ = get_exc_type(exc.__class__)
-    msg_template = config.error_msg_templates.get(type_) or getattr(exc, 'msg_template', None)
-    ctx = exc.__dict__
-    if msg_template:
-        msg = msg_template.format(**ctx)
-    else:
-        msg = str(exc)
-
-    d: 'ErrorDict' = {'loc': loc, 'msg': msg, 'type': type_}
-
-    if ctx:
-        d['ctx'] = ctx
-
-    return d
-
-
-_EXC_TYPE_CACHE: Dict[Type[Exception], str] = {}
-
-
-def get_exc_type(cls: Type[Exception]) -> str:
-    # slightly more efficient than using lru_cache since we don't need to worry about the cache filling up
-    try:
-        return _EXC_TYPE_CACHE[cls]
-    except KeyError:
-        r = _get_exc_type(cls)
-        _EXC_TYPE_CACHE[cls] = r
-        return r
-
-
-def _get_exc_type(cls: Type[Exception]) -> str:
-    if issubclass(cls, AssertionError):
-        return 'assertion_error'
-
-    base_name = 'type_error' if issubclass(cls, TypeError) else 'value_error'
-    if cls in (TypeError, ValueError):
-        # just TypeError or ValueError, no extra code
-        return base_name
-
-    # if it's not a TypeError or ValueError, we just take the lowercase of the exception name
-    # no chaining or snake case logic, use "code" for more complex error types.
-    code = getattr(cls, 'code', None) or cls.__name__.replace('Error', '').lower()
-    return base_name + '.' + code
+__getattr__ = getattr_migration(__name__)
diff --git a/lib/pydantic/errors.py b/lib/pydantic/errors.py
index 7bdafdd1..c5fa9612 100644
--- a/lib/pydantic/errors.py
+++ b/lib/pydantic/errors.py
@@ -1,646 +1,152 @@
-from decimal import Decimal
-from pathlib import Path
-from typing import TYPE_CHECKING, Any, Callable, Sequence, Set, Tuple, Type, Union
+"""Pydantic-specific errors."""
+from __future__ import annotations as _annotations
 
-from .typing import display_as_type
+import re
 
-if TYPE_CHECKING:
-    from .typing import DictStrAny
+from typing_extensions import Literal, Self
+
+from ._migration import getattr_migration
+from .version import version_short
 
-# explicitly state exports to avoid "from .errors import *" also importing Decimal, Path etc.
 __all__ = (
-    'PydanticTypeError',
-    'PydanticValueError',
-    'ConfigError',
-    'MissingError',
-    'ExtraError',
-    'NoneIsNotAllowedError',
-    'NoneIsAllowedError',
-    'WrongConstantError',
-    'NotNoneError',
-    'BoolError',
-    'BytesError',
-    'DictError',
-    'EmailError',
-    'UrlError',
-    'UrlSchemeError',
-    'UrlSchemePermittedError',
-    'UrlUserInfoError',
-    'UrlHostError',
-    'UrlHostTldError',
-    'UrlPortError',
-    'UrlExtraError',
-    'EnumError',
-    'IntEnumError',
-    'EnumMemberError',
-    'IntegerError',
-    'FloatError',
-    'PathError',
-    'PathNotExistsError',
-    'PathNotAFileError',
-    'PathNotADirectoryError',
-    'PyObjectError',
-    'SequenceError',
-    'ListError',
-    'SetError',
-    'FrozenSetError',
-    'TupleError',
-    'TupleLengthError',
-    'ListMinLengthError',
-    'ListMaxLengthError',
-    'ListUniqueItemsError',
-    'SetMinLengthError',
-    'SetMaxLengthError',
-    'FrozenSetMinLengthError',
-    'FrozenSetMaxLengthError',
-    'AnyStrMinLengthError',
-    'AnyStrMaxLengthError',
-    'StrError',
-    'StrRegexError',
-    'NumberNotGtError',
-    'NumberNotGeError',
-    'NumberNotLtError',
-    'NumberNotLeError',
-    'NumberNotMultipleError',
-    'DecimalError',
-    'DecimalIsNotFiniteError',
-    'DecimalMaxDigitsError',
-    'DecimalMaxPlacesError',
-    'DecimalWholeDigitsError',
-    'DateTimeError',
-    'DateError',
-    'DateNotInThePastError',
-    'DateNotInTheFutureError',
-    'TimeError',
-    'DurationError',
-    'HashableError',
-    'UUIDError',
-    'UUIDVersionError',
-    'ArbitraryTypeError',
-    'ClassError',
-    'SubclassError',
-    'JsonError',
-    'JsonTypeError',
-    'PatternError',
-    'DataclassTypeError',
-    'CallableError',
-    'IPvAnyAddressError',
-    'IPvAnyInterfaceError',
-    'IPvAnyNetworkError',
-    'IPv4AddressError',
-    'IPv6AddressError',
-    'IPv4NetworkError',
-    'IPv6NetworkError',
-    'IPv4InterfaceError',
-    'IPv6InterfaceError',
-    'ColorError',
-    'StrictBoolError',
-    'NotDigitError',
-    'LuhnValidationError',
-    'InvalidLengthForBrand',
-    'InvalidByteSize',
-    'InvalidByteSizeUnit',
-    'MissingDiscriminator',
-    'InvalidDiscriminator',
+    'PydanticUserError',
+    'PydanticUndefinedAnnotation',
+    'PydanticImportError',
+    'PydanticSchemaGenerationError',
+    'PydanticInvalidForJsonSchema',
+    'PydanticErrorCodes',
 )
 
-
-def cls_kwargs(cls: Type['PydanticErrorMixin'], ctx: 'DictStrAny') -> 'PydanticErrorMixin':
-    """
-    For built-in exceptions like ValueError or TypeError, we need to implement
-    __reduce__ to override the default behaviour (instead of __getstate__/__setstate__)
-    By default pickle protocol 2 calls `cls.__new__(cls, *args)`.
-    Since we only use kwargs, we need a little constructor to change that.
-    Note: the callable can't be a lambda as pickle looks in the namespace to find it
-    """
-    return cls(**ctx)
+# We use this URL to allow for future flexibility about how we host the docs, while allowing for Pydantic
+# code in the while with "old" URLs to still work.
+# 'u' refers to "user errors" - e.g. errors caused by developers using pydantic, as opposed to validation errors.
+DEV_ERROR_DOCS_URL = f'https://errors.pydantic.dev/{version_short()}/u/'
+PydanticErrorCodes = Literal[
+    'class-not-fully-defined',
+    'custom-json-schema',
+    'decorator-missing-field',
+    'discriminator-no-field',
+    'discriminator-alias-type',
+    'discriminator-needs-literal',
+    'discriminator-alias',
+    'discriminator-validator',
+    'callable-discriminator-no-tag',
+    'typed-dict-version',
+    'model-field-overridden',
+    'model-field-missing-annotation',
+    'config-both',
+    'removed-kwargs',
+    'invalid-for-json-schema',
+    'json-schema-already-used',
+    'base-model-instantiated',
+    'undefined-annotation',
+    'schema-for-unknown-type',
+    'import-error',
+    'create-model-field-definitions',
+    'create-model-config-base',
+    'validator-no-fields',
+    'validator-invalid-fields',
+    'validator-instance-method',
+    'root-validator-pre-skip',
+    'model-serializer-instance-method',
+    'validator-field-config-info',
+    'validator-v1-signature',
+    'validator-signature',
+    'field-serializer-signature',
+    'model-serializer-signature',
+    'multiple-field-serializers',
+    'invalid_annotated_type',
+    'type-adapter-config-unused',
+    'root-model-extra',
+    'unevaluable-type-annotation',
+    'dataclass-init-false-extra-allow',
+    'clashing-init-and-init-var',
+]
 
 
 class PydanticErrorMixin:
-    code: str
-    msg_template: str
+    """A mixin class for common functionality shared by all Pydantic-specific errors.
 
-    def __init__(self, **ctx: Any) -> None:
-        self.__dict__ = ctx
+    Attributes:
+        message: A message describing the error.
+        code: An optional error code from PydanticErrorCodes enum.
+    """
+
+    def __init__(self, message: str, *, code: PydanticErrorCodes | None) -> None:
+        self.message = message
+        self.code = code
 
     def __str__(self) -> str:
-        return self.msg_template.format(**self.__dict__)
+        if self.code is None:
+            return self.message
+        else:
+            return f'{self.message}\n\nFor further information visit {DEV_ERROR_DOCS_URL}{self.code}'
 
-    def __reduce__(self) -> Tuple[Callable[..., 'PydanticErrorMixin'], Tuple[Type['PydanticErrorMixin'], 'DictStrAny']]:
-        return cls_kwargs, (self.__class__, self.__dict__)
 
+class PydanticUserError(PydanticErrorMixin, TypeError):
+    """An error raised due to incorrect use of Pydantic."""
 
-class PydanticTypeError(PydanticErrorMixin, TypeError):
-    pass
 
+class PydanticUndefinedAnnotation(PydanticErrorMixin, NameError):
+    """A subclass of `NameError` raised when handling undefined annotations during `CoreSchema` generation.
 
-class PydanticValueError(PydanticErrorMixin, ValueError):
-    pass
+    Attributes:
+        name: Name of the error.
+        message: Description of the error.
+    """
 
+    def __init__(self, name: str, message: str) -> None:
+        self.name = name
+        super().__init__(message=message, code='undefined-annotation')
 
-class ConfigError(RuntimeError):
-    pass
+    @classmethod
+    def from_name_error(cls, name_error: NameError) -> Self:
+        """Convert a `NameError` to a `PydanticUndefinedAnnotation` error.
 
+        Args:
+            name_error: `NameError` to be converted.
 
-class MissingError(PydanticValueError):
-    msg_template = 'field required'
+        Returns:
+            Converted `PydanticUndefinedAnnotation` error.
+        """
+        try:
+            name = name_error.name  # type: ignore  # python > 3.10
+        except AttributeError:
+            name = re.search(r".*'(.+?)'", str(name_error)).group(1)  # type: ignore[union-attr]
+        return cls(name=name, message=str(name_error))
 
 
-class ExtraError(PydanticValueError):
-    msg_template = 'extra fields not permitted'
+class PydanticImportError(PydanticErrorMixin, ImportError):
+    """An error raised when an import fails due to module changes between V1 and V2.
 
+    Attributes:
+        message: Description of the error.
+    """
 
-class NoneIsNotAllowedError(PydanticTypeError):
-    code = 'none.not_allowed'
-    msg_template = 'none is not an allowed value'
+    def __init__(self, message: str) -> None:
+        super().__init__(message, code='import-error')
 
 
-class NoneIsAllowedError(PydanticTypeError):
-    code = 'none.allowed'
-    msg_template = 'value is not none'
+class PydanticSchemaGenerationError(PydanticUserError):
+    """An error raised during failures to generate a `CoreSchema` for some type.
 
+    Attributes:
+        message: Description of the error.
+    """
 
-class WrongConstantError(PydanticValueError):
-    code = 'const'
+    def __init__(self, message: str) -> None:
+        super().__init__(message, code='schema-for-unknown-type')
 
-    def __str__(self) -> str:
-        permitted = ', '.join(repr(v) for v in self.permitted)  # type: ignore
-        return f'unexpected value; permitted: {permitted}'
 
+class PydanticInvalidForJsonSchema(PydanticUserError):
+    """An error raised during failures to generate a JSON schema for some `CoreSchema`.
 
-class NotNoneError(PydanticTypeError):
-    code = 'not_none'
-    msg_template = 'value is not None'
+    Attributes:
+        message: Description of the error.
+    """
 
+    def __init__(self, message: str) -> None:
+        super().__init__(message, code='invalid-for-json-schema')
 
-class BoolError(PydanticTypeError):
-    msg_template = 'value could not be parsed to a boolean'
 
-
-class BytesError(PydanticTypeError):
-    msg_template = 'byte type expected'
-
-
-class DictError(PydanticTypeError):
-    msg_template = 'value is not a valid dict'
-
-
-class EmailError(PydanticValueError):
-    msg_template = 'value is not a valid email address'
-
-
-class UrlError(PydanticValueError):
-    code = 'url'
-
-
-class UrlSchemeError(UrlError):
-    code = 'url.scheme'
-    msg_template = 'invalid or missing URL scheme'
-
-
-class UrlSchemePermittedError(UrlError):
-    code = 'url.scheme'
-    msg_template = 'URL scheme not permitted'
-
-    def __init__(self, allowed_schemes: Set[str]):
-        super().__init__(allowed_schemes=allowed_schemes)
-
-
-class UrlUserInfoError(UrlError):
-    code = 'url.userinfo'
-    msg_template = 'userinfo required in URL but missing'
-
-
-class UrlHostError(UrlError):
-    code = 'url.host'
-    msg_template = 'URL host invalid'
-
-
-class UrlHostTldError(UrlError):
-    code = 'url.host'
-    msg_template = 'URL host invalid, top level domain required'
-
-
-class UrlPortError(UrlError):
-    code = 'url.port'
-    msg_template = 'URL port invalid, port cannot exceed 65535'
-
-
-class UrlExtraError(UrlError):
-    code = 'url.extra'
-    msg_template = 'URL invalid, extra characters found after valid URL: {extra!r}'
-
-
-class EnumMemberError(PydanticTypeError):
-    code = 'enum'
-
-    def __str__(self) -> str:
-        permitted = ', '.join(repr(v.value) for v in self.enum_values)  # type: ignore
-        return f'value is not a valid enumeration member; permitted: {permitted}'
-
-
-class IntegerError(PydanticTypeError):
-    msg_template = 'value is not a valid integer'
-
-
-class FloatError(PydanticTypeError):
-    msg_template = 'value is not a valid float'
-
-
-class PathError(PydanticTypeError):
-    msg_template = 'value is not a valid path'
-
-
-class _PathValueError(PydanticValueError):
-    def __init__(self, *, path: Path) -> None:
-        super().__init__(path=str(path))
-
-
-class PathNotExistsError(_PathValueError):
-    code = 'path.not_exists'
-    msg_template = 'file or directory at path "{path}" does not exist'
-
-
-class PathNotAFileError(_PathValueError):
-    code = 'path.not_a_file'
-    msg_template = 'path "{path}" does not point to a file'
-
-
-class PathNotADirectoryError(_PathValueError):
-    code = 'path.not_a_directory'
-    msg_template = 'path "{path}" does not point to a directory'
-
-
-class PyObjectError(PydanticTypeError):
-    msg_template = 'ensure this value contains valid import path or valid callable: {error_message}'
-
-
-class SequenceError(PydanticTypeError):
-    msg_template = 'value is not a valid sequence'
-
-
-class IterableError(PydanticTypeError):
-    msg_template = 'value is not a valid iterable'
-
-
-class ListError(PydanticTypeError):
-    msg_template = 'value is not a valid list'
-
-
-class SetError(PydanticTypeError):
-    msg_template = 'value is not a valid set'
-
-
-class FrozenSetError(PydanticTypeError):
-    msg_template = 'value is not a valid frozenset'
-
-
-class DequeError(PydanticTypeError):
-    msg_template = 'value is not a valid deque'
-
-
-class TupleError(PydanticTypeError):
-    msg_template = 'value is not a valid tuple'
-
-
-class TupleLengthError(PydanticValueError):
-    code = 'tuple.length'
-    msg_template = 'wrong tuple length {actual_length}, expected {expected_length}'
-
-    def __init__(self, *, actual_length: int, expected_length: int) -> None:
-        super().__init__(actual_length=actual_length, expected_length=expected_length)
-
-
-class ListMinLengthError(PydanticValueError):
-    code = 'list.min_items'
-    msg_template = 'ensure this value has at least {limit_value} items'
-
-    def __init__(self, *, limit_value: int) -> None:
-        super().__init__(limit_value=limit_value)
-
-
-class ListMaxLengthError(PydanticValueError):
-    code = 'list.max_items'
-    msg_template = 'ensure this value has at most {limit_value} items'
-
-    def __init__(self, *, limit_value: int) -> None:
-        super().__init__(limit_value=limit_value)
-
-
-class ListUniqueItemsError(PydanticValueError):
-    code = 'list.unique_items'
-    msg_template = 'the list has duplicated items'
-
-
-class SetMinLengthError(PydanticValueError):
-    code = 'set.min_items'
-    msg_template = 'ensure this value has at least {limit_value} items'
-
-    def __init__(self, *, limit_value: int) -> None:
-        super().__init__(limit_value=limit_value)
-
-
-class SetMaxLengthError(PydanticValueError):
-    code = 'set.max_items'
-    msg_template = 'ensure this value has at most {limit_value} items'
-
-    def __init__(self, *, limit_value: int) -> None:
-        super().__init__(limit_value=limit_value)
-
-
-class FrozenSetMinLengthError(PydanticValueError):
-    code = 'frozenset.min_items'
-    msg_template = 'ensure this value has at least {limit_value} items'
-
-    def __init__(self, *, limit_value: int) -> None:
-        super().__init__(limit_value=limit_value)
-
-
-class FrozenSetMaxLengthError(PydanticValueError):
-    code = 'frozenset.max_items'
-    msg_template = 'ensure this value has at most {limit_value} items'
-
-    def __init__(self, *, limit_value: int) -> None:
-        super().__init__(limit_value=limit_value)
-
-
-class AnyStrMinLengthError(PydanticValueError):
-    code = 'any_str.min_length'
-    msg_template = 'ensure this value has at least {limit_value} characters'
-
-    def __init__(self, *, limit_value: int) -> None:
-        super().__init__(limit_value=limit_value)
-
-
-class AnyStrMaxLengthError(PydanticValueError):
-    code = 'any_str.max_length'
-    msg_template = 'ensure this value has at most {limit_value} characters'
-
-    def __init__(self, *, limit_value: int) -> None:
-        super().__init__(limit_value=limit_value)
-
-
-class StrError(PydanticTypeError):
-    msg_template = 'str type expected'
-
-
-class StrRegexError(PydanticValueError):
-    code = 'str.regex'
-    msg_template = 'string does not match regex "{pattern}"'
-
-    def __init__(self, *, pattern: str) -> None:
-        super().__init__(pattern=pattern)
-
-
-class _NumberBoundError(PydanticValueError):
-    def __init__(self, *, limit_value: Union[int, float, Decimal]) -> None:
-        super().__init__(limit_value=limit_value)
-
-
-class NumberNotGtError(_NumberBoundError):
-    code = 'number.not_gt'
-    msg_template = 'ensure this value is greater than {limit_value}'
-
-
-class NumberNotGeError(_NumberBoundError):
-    code = 'number.not_ge'
-    msg_template = 'ensure this value is greater than or equal to {limit_value}'
-
-
-class NumberNotLtError(_NumberBoundError):
-    code = 'number.not_lt'
-    msg_template = 'ensure this value is less than {limit_value}'
-
-
-class NumberNotLeError(_NumberBoundError):
-    code = 'number.not_le'
-    msg_template = 'ensure this value is less than or equal to {limit_value}'
-
-
-class NumberNotFiniteError(PydanticValueError):
-    code = 'number.not_finite_number'
-    msg_template = 'ensure this value is a finite number'
-
-
-class NumberNotMultipleError(PydanticValueError):
-    code = 'number.not_multiple'
-    msg_template = 'ensure this value is a multiple of {multiple_of}'
-
-    def __init__(self, *, multiple_of: Union[int, float, Decimal]) -> None:
-        super().__init__(multiple_of=multiple_of)
-
-
-class DecimalError(PydanticTypeError):
-    msg_template = 'value is not a valid decimal'
-
-
-class DecimalIsNotFiniteError(PydanticValueError):
-    code = 'decimal.not_finite'
-    msg_template = 'value is not a valid decimal'
-
-
-class DecimalMaxDigitsError(PydanticValueError):
-    code = 'decimal.max_digits'
-    msg_template = 'ensure that there are no more than {max_digits} digits in total'
-
-    def __init__(self, *, max_digits: int) -> None:
-        super().__init__(max_digits=max_digits)
-
-
-class DecimalMaxPlacesError(PydanticValueError):
-    code = 'decimal.max_places'
-    msg_template = 'ensure that there are no more than {decimal_places} decimal places'
-
-    def __init__(self, *, decimal_places: int) -> None:
-        super().__init__(decimal_places=decimal_places)
-
-
-class DecimalWholeDigitsError(PydanticValueError):
-    code = 'decimal.whole_digits'
-    msg_template = 'ensure that there are no more than {whole_digits} digits before the decimal point'
-
-    def __init__(self, *, whole_digits: int) -> None:
-        super().__init__(whole_digits=whole_digits)
-
-
-class DateTimeError(PydanticValueError):
-    msg_template = 'invalid datetime format'
-
-
-class DateError(PydanticValueError):
-    msg_template = 'invalid date format'
-
-
-class DateNotInThePastError(PydanticValueError):
-    code = 'date.not_in_the_past'
-    msg_template = 'date is not in the past'
-
-
-class DateNotInTheFutureError(PydanticValueError):
-    code = 'date.not_in_the_future'
-    msg_template = 'date is not in the future'
-
-
-class TimeError(PydanticValueError):
-    msg_template = 'invalid time format'
-
-
-class DurationError(PydanticValueError):
-    msg_template = 'invalid duration format'
-
-
-class HashableError(PydanticTypeError):
-    msg_template = 'value is not a valid hashable'
-
-
-class UUIDError(PydanticTypeError):
-    msg_template = 'value is not a valid uuid'
-
-
-class UUIDVersionError(PydanticValueError):
-    code = 'uuid.version'
-    msg_template = 'uuid version {required_version} expected'
-
-    def __init__(self, *, required_version: int) -> None:
-        super().__init__(required_version=required_version)
-
-
-class ArbitraryTypeError(PydanticTypeError):
-    code = 'arbitrary_type'
-    msg_template = 'instance of {expected_arbitrary_type} expected'
-
-    def __init__(self, *, expected_arbitrary_type: Type[Any]) -> None:
-        super().__init__(expected_arbitrary_type=display_as_type(expected_arbitrary_type))
-
-
-class ClassError(PydanticTypeError):
-    code = 'class'
-    msg_template = 'a class is expected'
-
-
-class SubclassError(PydanticTypeError):
-    code = 'subclass'
-    msg_template = 'subclass of {expected_class} expected'
-
-    def __init__(self, *, expected_class: Type[Any]) -> None:
-        super().__init__(expected_class=display_as_type(expected_class))
-
-
-class JsonError(PydanticValueError):
-    msg_template = 'Invalid JSON'
-
-
-class JsonTypeError(PydanticTypeError):
-    code = 'json'
-    msg_template = 'JSON object must be str, bytes or bytearray'
-
-
-class PatternError(PydanticValueError):
-    code = 'regex_pattern'
-    msg_template = 'Invalid regular expression'
-
-
-class DataclassTypeError(PydanticTypeError):
-    code = 'dataclass'
-    msg_template = 'instance of {class_name}, tuple or dict expected'
-
-
-class CallableError(PydanticTypeError):
-    msg_template = '{value} is not callable'
-
-
-class EnumError(PydanticTypeError):
-    code = 'enum_instance'
-    msg_template = '{value} is not a valid Enum instance'
-
-
-class IntEnumError(PydanticTypeError):
-    code = 'int_enum_instance'
-    msg_template = '{value} is not a valid IntEnum instance'
-
-
-class IPvAnyAddressError(PydanticValueError):
-    msg_template = 'value is not a valid IPv4 or IPv6 address'
-
-
-class IPvAnyInterfaceError(PydanticValueError):
-    msg_template = 'value is not a valid IPv4 or IPv6 interface'
-
-
-class IPvAnyNetworkError(PydanticValueError):
-    msg_template = 'value is not a valid IPv4 or IPv6 network'
-
-
-class IPv4AddressError(PydanticValueError):
-    msg_template = 'value is not a valid IPv4 address'
-
-
-class IPv6AddressError(PydanticValueError):
-    msg_template = 'value is not a valid IPv6 address'
-
-
-class IPv4NetworkError(PydanticValueError):
-    msg_template = 'value is not a valid IPv4 network'
-
-
-class IPv6NetworkError(PydanticValueError):
-    msg_template = 'value is not a valid IPv6 network'
-
-
-class IPv4InterfaceError(PydanticValueError):
-    msg_template = 'value is not a valid IPv4 interface'
-
-
-class IPv6InterfaceError(PydanticValueError):
-    msg_template = 'value is not a valid IPv6 interface'
-
-
-class ColorError(PydanticValueError):
-    msg_template = 'value is not a valid color: {reason}'
-
-
-class StrictBoolError(PydanticValueError):
-    msg_template = 'value is not a valid boolean'
-
-
-class NotDigitError(PydanticValueError):
-    code = 'payment_card_number.digits'
-    msg_template = 'card number is not all digits'
-
-
-class LuhnValidationError(PydanticValueError):
-    code = 'payment_card_number.luhn_check'
-    msg_template = 'card number is not luhn valid'
-
-
-class InvalidLengthForBrand(PydanticValueError):
-    code = 'payment_card_number.invalid_length_for_brand'
-    msg_template = 'Length for a {brand} card must be {required_length}'
-
-
-class InvalidByteSize(PydanticValueError):
-    msg_template = 'could not parse value and unit from byte string'
-
-
-class InvalidByteSizeUnit(PydanticValueError):
-    msg_template = 'could not interpret byte unit: {unit}'
-
-
-class MissingDiscriminator(PydanticValueError):
-    code = 'discriminated_union.missing_discriminator'
-    msg_template = 'Discriminator {discriminator_key!r} is missing in value'
-
-
-class InvalidDiscriminator(PydanticValueError):
-    code = 'discriminated_union.invalid_discriminator'
-    msg_template = (
-        'No match for discriminator {discriminator_key!r} and value {discriminator_value!r} '
-        '(allowed values: {allowed_values})'
-    )
-
-    def __init__(self, *, discriminator_key: str, discriminator_value: Any, allowed_values: Sequence[Any]) -> None:
-        super().__init__(
-            discriminator_key=discriminator_key,
-            discriminator_value=discriminator_value,
-            allowed_values=', '.join(map(repr, allowed_values)),
-        )
+__getattr__ = getattr_migration(__name__)
diff --git a/lib/pydantic/fields.py b/lib/pydantic/fields.py
index cecd3d20..b416bb7d 100644
--- a/lib/pydantic/fields.py
+++ b/lib/pydantic/fields.py
@@ -1,1209 +1,875 @@
-import copy
-import re
-from collections import Counter as CollectionCounter, defaultdict, deque
-from collections.abc import Callable, Hashable as CollectionsHashable, Iterable as CollectionsIterable
-from typing import (
-    TYPE_CHECKING,
-    Any,
-    Counter,
-    DefaultDict,
-    Deque,
-    Dict,
-    ForwardRef,
-    FrozenSet,
-    Generator,
-    Iterable,
-    Iterator,
-    List,
-    Mapping,
-    Optional,
-    Pattern,
-    Sequence,
-    Set,
-    Tuple,
-    Type,
-    TypeVar,
-    Union,
-)
+"""Defining fields on models."""
+from __future__ import annotations as _annotations
 
-from typing_extensions import Annotated, Final
+import dataclasses
+import inspect
+import typing
+from copy import copy
+from dataclasses import Field as DataclassField
+from functools import cached_property
+from typing import Any, ClassVar
+from warnings import warn
 
-from . import errors as errors_
-from .class_validators import Validator, make_generic_validator, prep_validators
-from .error_wrappers import ErrorWrapper
-from .errors import ConfigError, InvalidDiscriminator, MissingDiscriminator, NoneIsNotAllowedError
-from .types import Json, JsonWrapper
-from .typing import (
-    NoArgAnyCallable,
-    convert_generics,
-    display_as_type,
-    get_args,
-    get_origin,
-    is_finalvar,
-    is_literal_type,
-    is_new_type,
-    is_none_type,
-    is_typeddict,
-    is_typeddict_special,
-    is_union,
-    new_type_supertype,
-)
-from .utils import (
-    PyObjectStr,
-    Representation,
-    ValueItems,
-    get_discriminator_alias_and_values,
-    get_unique_discriminator_alias,
-    lenient_isinstance,
-    lenient_issubclass,
-    sequence_like,
-    smart_deepcopy,
-)
-from .validators import constant_validator, dict_validator, find_validators, validate_json
+import annotated_types
+import typing_extensions
+from pydantic_core import PydanticUndefined
+from typing_extensions import Literal, Unpack
 
-Required: Any = Ellipsis
+from . import types
+from ._internal import _decorators, _fields, _generics, _internal_dataclass, _repr, _typing_extra, _utils
+from .aliases import AliasChoices, AliasPath
+from .config import JsonDict
+from .errors import PydanticUserError
+from .warnings import PydanticDeprecatedSince20
 
-T = TypeVar('T')
+if typing.TYPE_CHECKING:
+    from ._internal._repr import ReprArgs
+else:
+    # See PyCharm issues https://youtrack.jetbrains.com/issue/PY-21915
+    # and https://youtrack.jetbrains.com/issue/PY-51428
+    DeprecationWarning = PydanticDeprecatedSince20
 
 
-class UndefinedType:
-    def __repr__(self) -> str:
-        return 'PydanticUndefined'
-
-    def __copy__(self: T) -> T:
-        return self
-
-    def __reduce__(self) -> str:
-        return 'Undefined'
-
-    def __deepcopy__(self: T, _: Any) -> T:
-        return self
+_Unset: Any = PydanticUndefined
 
 
-Undefined = UndefinedType()
+class _FromFieldInfoInputs(typing_extensions.TypedDict, total=False):
+    """This class exists solely to add type checking for the `**kwargs` in `FieldInfo.from_field`."""
 
-if TYPE_CHECKING:
-    from .class_validators import ValidatorsList
-    from .config import BaseConfig
-    from .error_wrappers import ErrorList
-    from .types import ModelOrDc
-    from .typing import AbstractSetIntStr, MappingIntStrAny, ReprArgs
-
-    ValidateReturn = Tuple[Optional[Any], Optional[ErrorList]]
-    LocStr = Union[Tuple[Union[int, str], ...], str]
-    BoolUndefined = Union[bool, UndefinedType]
+    annotation: type[Any] | None
+    default_factory: typing.Callable[[], Any] | None
+    alias: str | None
+    alias_priority: int | None
+    validation_alias: str | AliasPath | AliasChoices | None
+    serialization_alias: str | None
+    title: str | None
+    description: str | None
+    examples: list[Any] | None
+    exclude: bool | None
+    gt: float | None
+    ge: float | None
+    lt: float | None
+    le: float | None
+    multiple_of: float | None
+    strict: bool | None
+    min_length: int | None
+    max_length: int | None
+    pattern: str | None
+    allow_inf_nan: bool | None
+    max_digits: int | None
+    decimal_places: int | None
+    union_mode: Literal['smart', 'left_to_right'] | None
+    discriminator: str | types.Discriminator | None
+    json_schema_extra: JsonDict | typing.Callable[[JsonDict], None] | None
+    frozen: bool | None
+    validate_default: bool | None
+    repr: bool
+    init: bool | None
+    init_var: bool | None
+    kw_only: bool | None
 
 
-class FieldInfo(Representation):
-    """
-    Captures extra information about a field.
+class _FieldInfoInputs(_FromFieldInfoInputs, total=False):
+    """This class exists solely to add type checking for the `**kwargs` in `FieldInfo.__init__`."""
+
+    default: Any
+
+
+class FieldInfo(_repr.Representation):
+    """This class holds information about a field.
+
+    `FieldInfo` is used for any field definition regardless of whether the [`Field()`][pydantic.fields.Field]
+    function is explicitly used.
+
+    !!! warning
+        You generally shouldn't be creating `FieldInfo` directly, you'll only need to use it when accessing
+        [`BaseModel`][pydantic.main.BaseModel] `.model_fields` internals.
+
+    Attributes:
+        annotation: The type annotation of the field.
+        default: The default value of the field.
+        default_factory: The factory function used to construct the default for the field.
+        alias: The alias name of the field.
+        alias_priority: The priority of the field's alias.
+        validation_alias: The validation alias of the field.
+        serialization_alias: The serialization alias of the field.
+        title: The title of the field.
+        description: The description of the field.
+        examples: List of examples of the field.
+        exclude: Whether to exclude the field from the model serialization.
+        discriminator: Field name or Discriminator for discriminating the type in a tagged union.
+        json_schema_extra: A dict or callable to provide extra JSON schema properties.
+        frozen: Whether the field is frozen.
+        validate_default: Whether to validate the default value of the field.
+        repr: Whether to include the field in representation of the model.
+        init: Whether the field should be included in the constructor of the dataclass.
+        init_var: Whether the field should _only_ be included in the constructor of the dataclass, and not stored.
+        kw_only: Whether the field should be a keyword-only argument in the constructor of the dataclass.
+        metadata: List of metadata constraints.
     """
 
+    annotation: type[Any] | None
+    default: Any
+    default_factory: typing.Callable[[], Any] | None
+    alias: str | None
+    alias_priority: int | None
+    validation_alias: str | AliasPath | AliasChoices | None
+    serialization_alias: str | None
+    title: str | None
+    description: str | None
+    examples: list[Any] | None
+    exclude: bool | None
+    discriminator: str | types.Discriminator | None
+    json_schema_extra: JsonDict | typing.Callable[[JsonDict], None] | None
+    frozen: bool | None
+    validate_default: bool | None
+    repr: bool
+    init: bool | None
+    init_var: bool | None
+    kw_only: bool | None
+    metadata: list[Any]
+
     __slots__ = (
+        'annotation',
         'default',
         'default_factory',
         'alias',
         'alias_priority',
+        'validation_alias',
+        'serialization_alias',
         'title',
         'description',
+        'examples',
         'exclude',
-        'include',
-        'const',
-        'gt',
-        'ge',
-        'lt',
-        'le',
-        'multiple_of',
-        'allow_inf_nan',
-        'max_digits',
-        'decimal_places',
-        'min_items',
-        'max_items',
-        'unique_items',
-        'min_length',
-        'max_length',
-        'allow_mutation',
-        'repr',
-        'regex',
         'discriminator',
-        'extra',
+        'json_schema_extra',
+        'frozen',
+        'validate_default',
+        'repr',
+        'init',
+        'init_var',
+        'kw_only',
+        'metadata',
+        '_attributes_set',
     )
 
-    # field constraints with the default value, it's also used in update_from_config below
-    __field_constraints__ = {
-        'min_length': None,
-        'max_length': None,
-        'regex': None,
-        'gt': None,
-        'lt': None,
-        'ge': None,
-        'le': None,
-        'multiple_of': None,
+    # used to convert kwargs to metadata/constraints,
+    # None has a special meaning - these items are collected into a `PydanticGeneralMetadata`
+    metadata_lookup: ClassVar[dict[str, typing.Callable[[Any], Any] | None]] = {
+        'strict': types.Strict,
+        'gt': annotated_types.Gt,
+        'ge': annotated_types.Ge,
+        'lt': annotated_types.Lt,
+        'le': annotated_types.Le,
+        'multiple_of': annotated_types.MultipleOf,
+        'min_length': annotated_types.MinLen,
+        'max_length': annotated_types.MaxLen,
+        'pattern': None,
         'allow_inf_nan': None,
         'max_digits': None,
         'decimal_places': None,
-        'min_items': None,
-        'max_items': None,
-        'unique_items': None,
-        'allow_mutation': True,
+        'union_mode': None,
     }
 
-    def __init__(self, default: Any = Undefined, **kwargs: Any) -> None:
-        self.default = default
+    def __init__(self, **kwargs: Unpack[_FieldInfoInputs]) -> None:
+        """This class should generally not be initialized directly; instead, use the `pydantic.fields.Field` function
+        or one of the constructor classmethods.
+
+        See the signature of `pydantic.fields.Field` for more details about the expected arguments.
+        """
+        self._attributes_set = {k: v for k, v in kwargs.items() if v is not _Unset}
+        kwargs = {k: _DefaultValues.get(k) if v is _Unset else v for k, v in kwargs.items()}  # type: ignore
+        self.annotation, annotation_metadata = self._extract_metadata(kwargs.get('annotation'))
+
+        default = kwargs.pop('default', PydanticUndefined)
+        if default is Ellipsis:
+            self.default = PydanticUndefined
+        else:
+            self.default = default
+
         self.default_factory = kwargs.pop('default_factory', None)
-        self.alias = kwargs.pop('alias', None)
-        self.alias_priority = kwargs.pop('alias_priority', 2 if self.alias is not None else None)
+
+        if self.default is not PydanticUndefined and self.default_factory is not None:
+            raise TypeError('cannot specify both default and default_factory')
+
         self.title = kwargs.pop('title', None)
+        self.alias = kwargs.pop('alias', None)
+        self.validation_alias = kwargs.pop('validation_alias', None)
+        self.serialization_alias = kwargs.pop('serialization_alias', None)
+        alias_is_set = any(alias is not None for alias in (self.alias, self.validation_alias, self.serialization_alias))
+        self.alias_priority = kwargs.pop('alias_priority', None) or 2 if alias_is_set else None
         self.description = kwargs.pop('description', None)
+        self.examples = kwargs.pop('examples', None)
         self.exclude = kwargs.pop('exclude', None)
-        self.include = kwargs.pop('include', None)
-        self.const = kwargs.pop('const', None)
-        self.gt = kwargs.pop('gt', None)
-        self.ge = kwargs.pop('ge', None)
-        self.lt = kwargs.pop('lt', None)
-        self.le = kwargs.pop('le', None)
-        self.multiple_of = kwargs.pop('multiple_of', None)
-        self.allow_inf_nan = kwargs.pop('allow_inf_nan', None)
-        self.max_digits = kwargs.pop('max_digits', None)
-        self.decimal_places = kwargs.pop('decimal_places', None)
-        self.min_items = kwargs.pop('min_items', None)
-        self.max_items = kwargs.pop('max_items', None)
-        self.unique_items = kwargs.pop('unique_items', None)
-        self.min_length = kwargs.pop('min_length', None)
-        self.max_length = kwargs.pop('max_length', None)
-        self.allow_mutation = kwargs.pop('allow_mutation', True)
-        self.regex = kwargs.pop('regex', None)
         self.discriminator = kwargs.pop('discriminator', None)
         self.repr = kwargs.pop('repr', True)
-        self.extra = kwargs
+        self.json_schema_extra = kwargs.pop('json_schema_extra', None)
+        self.validate_default = kwargs.pop('validate_default', None)
+        self.frozen = kwargs.pop('frozen', None)
+        # currently only used on dataclasses
+        self.init = kwargs.pop('init', None)
+        self.init_var = kwargs.pop('init_var', None)
+        self.kw_only = kwargs.pop('kw_only', None)
 
-    def __repr_args__(self) -> 'ReprArgs':
+        self.metadata = self._collect_metadata(kwargs) + annotation_metadata  # type: ignore
 
-        field_defaults_to_hide: Dict[str, Any] = {
-            'repr': True,
-            **self.__field_constraints__,
-        }
+    @staticmethod
+    def from_field(default: Any = PydanticUndefined, **kwargs: Unpack[_FromFieldInfoInputs]) -> FieldInfo:
+        """Create a new `FieldInfo` object with the `Field` function.
 
-        attrs = ((s, getattr(self, s)) for s in self.__slots__)
-        return [(a, v) for a, v in attrs if v != field_defaults_to_hide.get(a, None)]
+        Args:
+            default: The default value for the field. Defaults to Undefined.
+            **kwargs: Additional arguments dictionary.
 
-    def get_constraints(self) -> Set[str]:
+        Raises:
+            TypeError: If 'annotation' is passed as a keyword argument.
+
+        Returns:
+            A new FieldInfo object with the given parameters.
+
+        Example:
+            This is how you can create a field with default value like this:
+
+            ```python
+            import pydantic
+
+            class MyModel(pydantic.BaseModel):
+                foo: int = pydantic.Field(4)
+            ```
         """
-        Gets the constraints set on the field by comparing the constraint value with its default value
+        if 'annotation' in kwargs:
+            raise TypeError('"annotation" is not permitted as a Field keyword argument')
+        return FieldInfo(default=default, **kwargs)
 
-        :return: the constraints set on field_info
-        """
-        return {attr for attr, default in self.__field_constraints__.items() if getattr(self, attr) != default}
+    @staticmethod
+    def from_annotation(annotation: type[Any]) -> FieldInfo:
+        """Creates a `FieldInfo` instance from a bare annotation.
 
-    def update_from_config(self, from_config: Dict[str, Any]) -> None:
+        This function is used internally to create a `FieldInfo` from a bare annotation like this:
+
+        ```python
+        import pydantic
+
+        class MyModel(pydantic.BaseModel):
+            foo: int  # <-- like this
+        ```
+
+        We also account for the case where the annotation can be an instance of `Annotated` and where
+        one of the (not first) arguments in `Annotated` is an instance of `FieldInfo`, e.g.:
+
+        ```python
+        import annotated_types
+        from typing_extensions import Annotated
+
+        import pydantic
+
+        class MyModel(pydantic.BaseModel):
+            foo: Annotated[int, annotated_types.Gt(42)]
+            bar: Annotated[int, pydantic.Field(gt=42)]
+        ```
+
+        Args:
+            annotation: An annotation object.
+
+        Returns:
+            An instance of the field metadata.
         """
-        Update this FieldInfo based on a dict from get_field_info, only fields which have not been set are dated.
+        final = False
+        if _typing_extra.is_finalvar(annotation):
+            final = True
+            if annotation is not typing_extensions.Final:
+                annotation = typing_extensions.get_args(annotation)[0]
+
+        if _typing_extra.is_annotated(annotation):
+            first_arg, *extra_args = typing_extensions.get_args(annotation)
+            if _typing_extra.is_finalvar(first_arg):
+                final = True
+            field_info_annotations = [a for a in extra_args if isinstance(a, FieldInfo)]
+            field_info = FieldInfo.merge_field_infos(*field_info_annotations, annotation=first_arg)
+            if field_info:
+                new_field_info = copy(field_info)
+                new_field_info.annotation = first_arg
+                new_field_info.frozen = final or field_info.frozen
+                metadata: list[Any] = []
+                for a in extra_args:
+                    if not isinstance(a, FieldInfo):
+                        metadata.append(a)
+                    else:
+                        metadata.extend(a.metadata)
+                new_field_info.metadata = metadata
+                return new_field_info
+
+        return FieldInfo(annotation=annotation, frozen=final or None)
+
+    @staticmethod
+    def from_annotated_attribute(annotation: type[Any], default: Any) -> FieldInfo:
+        """Create `FieldInfo` from an annotation with a default value.
+
+        This is used in cases like the following:
+
+        ```python
+        import annotated_types
+        from typing_extensions import Annotated
+
+        import pydantic
+
+        class MyModel(pydantic.BaseModel):
+            foo: int = 4  # <-- like this
+            bar: Annotated[int, annotated_types.Gt(4)] = 4  # <-- or this
+            spam: Annotated[int, pydantic.Field(gt=4)] = 4  # <-- or this
+        ```
+
+        Args:
+            annotation: The type annotation of the field.
+            default: The default value of the field.
+
+        Returns:
+            A field object with the passed values.
         """
-        for attr_name, value in from_config.items():
+        if annotation is default:
+            raise PydanticUserError(
+                'Error when building FieldInfo from annotated attribute. '
+                "Make sure you don't have any field name clashing with a type annotation ",
+                code='unevaluable-type-annotation',
+            )
+
+        final = False
+        if _typing_extra.is_finalvar(annotation):
+            final = True
+            if annotation is not typing_extensions.Final:
+                annotation = typing_extensions.get_args(annotation)[0]
+
+        if isinstance(default, FieldInfo):
+            default.annotation, annotation_metadata = FieldInfo._extract_metadata(annotation)
+            default.metadata += annotation_metadata
+            default = default.merge_field_infos(
+                *[x for x in annotation_metadata if isinstance(x, FieldInfo)], default, annotation=default.annotation
+            )
+            default.frozen = final or default.frozen
+            return default
+        elif isinstance(default, dataclasses.Field):
+            init_var = False
+            if annotation is dataclasses.InitVar:
+                init_var = True
+                annotation = Any
+            elif isinstance(annotation, dataclasses.InitVar):
+                init_var = True
+                annotation = annotation.type
+            pydantic_field = FieldInfo._from_dataclass_field(default)
+            pydantic_field.annotation, annotation_metadata = FieldInfo._extract_metadata(annotation)
+            pydantic_field.metadata += annotation_metadata
+            pydantic_field = pydantic_field.merge_field_infos(
+                *[x for x in annotation_metadata if isinstance(x, FieldInfo)],
+                pydantic_field,
+                annotation=pydantic_field.annotation,
+            )
+            pydantic_field.frozen = final or pydantic_field.frozen
+            pydantic_field.init_var = init_var
+            pydantic_field.init = getattr(default, 'init', None)
+            pydantic_field.kw_only = getattr(default, 'kw_only', None)
+            return pydantic_field
+        else:
+            if _typing_extra.is_annotated(annotation):
+                first_arg, *extra_args = typing_extensions.get_args(annotation)
+                field_infos = [a for a in extra_args if isinstance(a, FieldInfo)]
+                field_info = FieldInfo.merge_field_infos(*field_infos, annotation=first_arg, default=default)
+                metadata: list[Any] = []
+                for a in extra_args:
+                    if not isinstance(a, FieldInfo):
+                        metadata.append(a)
+                    else:
+                        metadata.extend(a.metadata)
+                field_info.metadata = metadata
+                return field_info
+
+            return FieldInfo(annotation=annotation, default=default, frozen=final or None)
+
+    @staticmethod
+    def merge_field_infos(*field_infos: FieldInfo, **overrides: Any) -> FieldInfo:
+        """Merge `FieldInfo` instances keeping only explicitly set attributes.
+
+        Later `FieldInfo` instances override earlier ones.
+
+        Returns:
+            FieldInfo: A merged FieldInfo instance.
+        """
+        flattened_field_infos: list[FieldInfo] = []
+        for field_info in field_infos:
+            flattened_field_infos.extend(x for x in field_info.metadata if isinstance(x, FieldInfo))
+            flattened_field_infos.append(field_info)
+        field_infos = tuple(flattened_field_infos)
+        if len(field_infos) == 1:
+            # No merging necessary, but we still need to make a copy and apply the overrides
+            field_info = copy(field_infos[0])
+            field_info._attributes_set.update(overrides)
+            for k, v in overrides.items():
+                setattr(field_info, k, v)
+            return field_info  # type: ignore
+
+        new_kwargs: dict[str, Any] = {}
+        metadata = {}
+        for field_info in field_infos:
+            new_kwargs.update(field_info._attributes_set)
+            for x in field_info.metadata:
+                if not isinstance(x, FieldInfo):
+                    metadata[type(x)] = x
+        new_kwargs.update(overrides)
+        field_info = FieldInfo(**new_kwargs)
+        field_info.metadata = list(metadata.values())
+        return field_info
+
+    @staticmethod
+    def _from_dataclass_field(dc_field: DataclassField[Any]) -> FieldInfo:
+        """Return a new `FieldInfo` instance from a `dataclasses.Field` instance.
+
+        Args:
+            dc_field: The `dataclasses.Field` instance to convert.
+
+        Returns:
+            The corresponding `FieldInfo` instance.
+
+        Raises:
+            TypeError: If any of the `FieldInfo` kwargs does not match the `dataclass.Field` kwargs.
+        """
+        default = dc_field.default
+        if default is dataclasses.MISSING:
+            default = PydanticUndefined
+
+        if dc_field.default_factory is dataclasses.MISSING:
+            default_factory: typing.Callable[[], Any] | None = None
+        else:
+            default_factory = dc_field.default_factory
+
+        # use the `Field` function so in correct kwargs raise the correct `TypeError`
+        dc_field_metadata = {k: v for k, v in dc_field.metadata.items() if k in _FIELD_ARG_NAMES}
+        return Field(default=default, default_factory=default_factory, repr=dc_field.repr, **dc_field_metadata)
+
+    @staticmethod
+    def _extract_metadata(annotation: type[Any] | None) -> tuple[type[Any] | None, list[Any]]:
+        """Tries to extract metadata/constraints from an annotation if it uses `Annotated`.
+
+        Args:
+            annotation: The type hint annotation for which metadata has to be extracted.
+
+        Returns:
+            A tuple containing the extracted metadata type and the list of extra arguments.
+        """
+        if annotation is not None:
+            if _typing_extra.is_annotated(annotation):
+                first_arg, *extra_args = typing_extensions.get_args(annotation)
+                return first_arg, list(extra_args)
+
+        return annotation, []
+
+    @staticmethod
+    def _collect_metadata(kwargs: dict[str, Any]) -> list[Any]:
+        """Collect annotations from kwargs.
+
+        Args:
+            kwargs: Keyword arguments passed to the function.
+
+        Returns:
+            A list of metadata objects - a combination of `annotated_types.BaseMetadata` and
+                `PydanticMetadata`.
+        """
+        metadata: list[Any] = []
+        general_metadata = {}
+        for key, value in list(kwargs.items()):
             try:
-                current_value = getattr(self, attr_name)
-            except AttributeError:
-                # attr_name is not an attribute of FieldInfo, it should therefore be added to extra
-                # (except if extra already has this value!)
-                self.extra.setdefault(attr_name, value)
+                marker = FieldInfo.metadata_lookup[key]
+            except KeyError:
+                continue
+
+            del kwargs[key]
+            if value is not None:
+                if marker is None:
+                    general_metadata[key] = value
+                else:
+                    metadata.append(marker(value))
+        if general_metadata:
+            metadata.append(_fields.pydantic_general_metadata(**general_metadata))
+        return metadata
+
+    def get_default(self, *, call_default_factory: bool = False) -> Any:
+        """Get the default value.
+
+        We expose an option for whether to call the default_factory (if present), as calling it may
+        result in side effects that we want to avoid. However, there are times when it really should
+        be called (namely, when instantiating a model via `model_construct`).
+
+        Args:
+            call_default_factory: Whether to call the default_factory or not. Defaults to `False`.
+
+        Returns:
+            The default value, calling the default factory if requested or `None` if not set.
+        """
+        if self.default_factory is None:
+            return _utils.smart_deepcopy(self.default)
+        elif call_default_factory:
+            return self.default_factory()
+        else:
+            return None
+
+    def is_required(self) -> bool:
+        """Check if the field is required (i.e., does not have a default value or factory).
+
+        Returns:
+            `True` if the field is required, `False` otherwise.
+        """
+        return self.default is PydanticUndefined and self.default_factory is None
+
+    def rebuild_annotation(self) -> Any:
+        """Attempts to rebuild the original annotation for use in function signatures.
+
+        If metadata is present, it adds it to the original annotation using
+        `Annotated`. Otherwise, it returns the original annotation as-is.
+
+        Note that because the metadata has been flattened, the original annotation
+        may not be reconstructed exactly as originally provided, e.g. if the original
+        type had unrecognized annotations, or was annotated with a call to `pydantic.Field`.
+
+        Returns:
+            The rebuilt annotation.
+        """
+        if not self.metadata:
+            return self.annotation
+        else:
+            # Annotated arguments must be a tuple
+            return typing_extensions.Annotated[(self.annotation, *self.metadata)]  # type: ignore
+
+    def apply_typevars_map(self, typevars_map: dict[Any, Any] | None, types_namespace: dict[str, Any] | None) -> None:
+        """Apply a `typevars_map` to the annotation.
+
+        This method is used when analyzing parametrized generic types to replace typevars with their concrete types.
+
+        This method applies the `typevars_map` to the annotation in place.
+
+        Args:
+            typevars_map: A dictionary mapping type variables to their concrete types.
+            types_namespace (dict | None): A dictionary containing related types to the annotated type.
+
+        See Also:
+            pydantic._internal._generics.replace_types is used for replacing the typevars with
+                their concrete types.
+        """
+        annotation = _typing_extra.eval_type_lenient(self.annotation, types_namespace)
+        self.annotation = _generics.replace_types(annotation, typevars_map)
+
+    def __repr_args__(self) -> ReprArgs:
+        yield 'annotation', _repr.PlainRepr(_repr.display_as_type(self.annotation))
+        yield 'required', self.is_required()
+
+        for s in self.__slots__:
+            if s == '_attributes_set':
+                continue
+            if s == 'annotation':
+                continue
+            elif s == 'metadata' and not self.metadata:
+                continue
+            elif s == 'repr' and self.repr is True:
+                continue
+            if s == 'frozen' and self.frozen is False:
+                continue
+            if s == 'validation_alias' and self.validation_alias == self.alias:
+                continue
+            if s == 'serialization_alias' and self.serialization_alias == self.alias:
+                continue
+            if s == 'default_factory' and self.default_factory is not None:
+                yield 'default_factory', _repr.PlainRepr(_repr.display_as_type(self.default_factory))
             else:
-                if current_value is self.__field_constraints__.get(attr_name, None):
-                    setattr(self, attr_name, value)
-                elif attr_name == 'exclude':
-                    self.exclude = ValueItems.merge(value, current_value)
-                elif attr_name == 'include':
-                    self.include = ValueItems.merge(value, current_value, intersect=True)
-
-    def _validate(self) -> None:
-        if self.default is not Undefined and self.default_factory is not None:
-            raise ValueError('cannot specify both default and default_factory')
+                value = getattr(self, s)
+                if value is not None and value is not PydanticUndefined:
+                    yield s, value
 
 
-def Field(
-    default: Any = Undefined,
+class _EmptyKwargs(typing_extensions.TypedDict):
+    """This class exists solely to ensure that type checking warns about passing `**extra` in `Field`."""
+
+
+_DefaultValues = dict(
+    default=...,
+    default_factory=None,
+    alias=None,
+    alias_priority=None,
+    validation_alias=None,
+    serialization_alias=None,
+    title=None,
+    description=None,
+    examples=None,
+    exclude=None,
+    discriminator=None,
+    json_schema_extra=None,
+    frozen=None,
+    validate_default=None,
+    repr=True,
+    init=None,
+    init_var=None,
+    kw_only=None,
+    pattern=None,
+    strict=None,
+    gt=None,
+    ge=None,
+    lt=None,
+    le=None,
+    multiple_of=None,
+    allow_inf_nan=None,
+    max_digits=None,
+    decimal_places=None,
+    min_length=None,
+    max_length=None,
+)
+
+
+def Field(  # noqa: C901
+    default: Any = PydanticUndefined,
     *,
-    default_factory: Optional[NoArgAnyCallable] = None,
-    alias: str = None,
-    title: str = None,
-    description: str = None,
-    exclude: Union['AbstractSetIntStr', 'MappingIntStrAny', Any] = None,
-    include: Union['AbstractSetIntStr', 'MappingIntStrAny', Any] = None,
-    const: bool = None,
-    gt: float = None,
-    ge: float = None,
-    lt: float = None,
-    le: float = None,
-    multiple_of: float = None,
-    allow_inf_nan: bool = None,
-    max_digits: int = None,
-    decimal_places: int = None,
-    min_items: int = None,
-    max_items: int = None,
-    unique_items: bool = None,
-    min_length: int = None,
-    max_length: int = None,
-    allow_mutation: bool = True,
-    regex: str = None,
-    discriminator: str = None,
-    repr: bool = True,
-    **extra: Any,
+    default_factory: typing.Callable[[], Any] | None = _Unset,
+    alias: str | None = _Unset,
+    alias_priority: int | None = _Unset,
+    validation_alias: str | AliasPath | AliasChoices | None = _Unset,
+    serialization_alias: str | None = _Unset,
+    title: str | None = _Unset,
+    description: str | None = _Unset,
+    examples: list[Any] | None = _Unset,
+    exclude: bool | None = _Unset,
+    discriminator: str | types.Discriminator | None = _Unset,
+    json_schema_extra: JsonDict | typing.Callable[[JsonDict], None] | None = _Unset,
+    frozen: bool | None = _Unset,
+    validate_default: bool | None = _Unset,
+    repr: bool = _Unset,
+    init: bool | None = _Unset,
+    init_var: bool | None = _Unset,
+    kw_only: bool | None = _Unset,
+    pattern: str | None = _Unset,
+    strict: bool | None = _Unset,
+    gt: float | None = _Unset,
+    ge: float | None = _Unset,
+    lt: float | None = _Unset,
+    le: float | None = _Unset,
+    multiple_of: float | None = _Unset,
+    allow_inf_nan: bool | None = _Unset,
+    max_digits: int | None = _Unset,
+    decimal_places: int | None = _Unset,
+    min_length: int | None = _Unset,
+    max_length: int | None = _Unset,
+    union_mode: Literal['smart', 'left_to_right'] = _Unset,
+    **extra: Unpack[_EmptyKwargs],
 ) -> Any:
-    """
-    Used to provide extra information about a field, either for the model schema or complex validation. Some arguments
-    apply only to number fields (``int``, ``float``, ``Decimal``) and some apply only to ``str``.
+    """Usage docs: https://docs.pydantic.dev/2.6/concepts/fields
 
-    :param default: since this is replacing the field’s default, its first argument is used
-      to set the default, use ellipsis (``...``) to indicate the field is required
-    :param default_factory: callable that will be called when a default value is needed for this field
-      If both `default` and `default_factory` are set, an error is raised.
-    :param alias: the public name of the field
-    :param title: can be any string, used in the schema
-    :param description: can be any string, used in the schema
-    :param exclude: exclude this field while dumping.
-      Takes same values as the ``include`` and ``exclude`` arguments on the ``.dict`` method.
-    :param include: include this field while dumping.
-      Takes same values as the ``include`` and ``exclude`` arguments on the ``.dict`` method.
-    :param const: this field is required and *must* take it's default value
-    :param gt: only applies to numbers, requires the field to be "greater than". The schema
-      will have an ``exclusiveMinimum`` validation keyword
-    :param ge: only applies to numbers, requires the field to be "greater than or equal to". The
-      schema will have a ``minimum`` validation keyword
-    :param lt: only applies to numbers, requires the field to be "less than". The schema
-      will have an ``exclusiveMaximum`` validation keyword
-    :param le: only applies to numbers, requires the field to be "less than or equal to". The
-      schema will have a ``maximum`` validation keyword
-    :param multiple_of: only applies to numbers, requires the field to be "a multiple of". The
-      schema will have a ``multipleOf`` validation keyword
-    :param allow_inf_nan: only applies to numbers, allows the field to be NaN or infinity (+inf or -inf),
-        which is a valid Python float. Default True, set to False for compatibility with JSON.
-    :param max_digits: only applies to Decimals, requires the field to have a maximum number
-      of digits within the decimal. It does not include a zero before the decimal point or trailing decimal zeroes.
-    :param decimal_places: only applies to Decimals, requires the field to have at most a number of decimal places
-      allowed. It does not include trailing decimal zeroes.
-    :param min_items: only applies to lists, requires the field to have a minimum number of
-      elements. The schema will have a ``minItems`` validation keyword
-    :param max_items: only applies to lists, requires the field to have a maximum number of
-      elements. The schema will have a ``maxItems`` validation keyword
-    :param unique_items: only applies to lists, requires the field not to have duplicated
-      elements. The schema will have a ``uniqueItems`` validation keyword
-    :param min_length: only applies to strings, requires the field to have a minimum length. The
-      schema will have a ``maximum`` validation keyword
-    :param max_length: only applies to strings, requires the field to have a maximum length. The
-      schema will have a ``maxLength`` validation keyword
-    :param allow_mutation: a boolean which defaults to True. When False, the field raises a TypeError if the field is
-      assigned on an instance.  The BaseModel Config must set validate_assignment to True
-    :param regex: only applies to strings, requires the field match against a regular expression
-      pattern string. The schema will have a ``pattern`` validation keyword
-    :param discriminator: only useful with a (discriminated a.k.a. tagged) `Union` of sub models with a common field.
-      The `discriminator` is the name of this common field to shorten validation and improve generated schema
-    :param repr: show this field in the representation
-    :param **extra: any additional keyword arguments will be added as is to the schema
+    Create a field for objects that can be configured.
+
+    Used to provide extra information about a field, either for the model schema or complex validation. Some arguments
+    apply only to number fields (`int`, `float`, `Decimal`) and some apply only to `str`.
+
+    Note:
+        - Any `_Unset` objects will be replaced by the corresponding value defined in the `_DefaultValues` dictionary. If a key for the `_Unset` object is not found in the `_DefaultValues` dictionary, it will default to `None`
+
+    Args:
+        default: Default value if the field is not set.
+        default_factory: A callable to generate the default value, such as :func:`~datetime.utcnow`.
+        alias: The name to use for the attribute when validating or serializing by alias.
+            This is often used for things like converting between snake and camel case.
+        alias_priority: Priority of the alias. This affects whether an alias generator is used.
+        validation_alias: Like `alias`, but only affects validation, not serialization.
+        serialization_alias: Like `alias`, but only affects serialization, not validation.
+        title: Human-readable title.
+        description: Human-readable description.
+        examples: Example values for this field.
+        exclude: Whether to exclude the field from the model serialization.
+        discriminator: Field name or Discriminator for discriminating the type in a tagged union.
+        json_schema_extra: A dict or callable to provide extra JSON schema properties.
+        frozen: Whether the field is frozen. If true, attempts to change the value on an instance will raise an error.
+        validate_default: If `True`, apply validation to the default value every time you create an instance.
+            Otherwise, for performance reasons, the default value of the field is trusted and not validated.
+        repr: A boolean indicating whether to include the field in the `__repr__` output.
+        init: Whether the field should be included in the constructor of the dataclass.
+            (Only applies to dataclasses.)
+        init_var: Whether the field should _only_ be included in the constructor of the dataclass.
+            (Only applies to dataclasses.)
+        kw_only: Whether the field should be a keyword-only argument in the constructor of the dataclass.
+            (Only applies to dataclasses.)
+        strict: If `True`, strict validation is applied to the field.
+            See [Strict Mode](../concepts/strict_mode.md) for details.
+        gt: Greater than. If set, value must be greater than this. Only applicable to numbers.
+        ge: Greater than or equal. If set, value must be greater than or equal to this. Only applicable to numbers.
+        lt: Less than. If set, value must be less than this. Only applicable to numbers.
+        le: Less than or equal. If set, value must be less than or equal to this. Only applicable to numbers.
+        multiple_of: Value must be a multiple of this. Only applicable to numbers.
+        min_length: Minimum length for strings.
+        max_length: Maximum length for strings.
+        pattern: Pattern for strings (a regular expression).
+        allow_inf_nan: Allow `inf`, `-inf`, `nan`. Only applicable to numbers.
+        max_digits: Maximum number of allow digits for strings.
+        decimal_places: Maximum number of decimal places allowed for numbers.
+        union_mode: The strategy to apply when validating a union. Can be `smart` (the default), or `left_to_right`.
+            See [Union Mode](standard_library_types.md#union-mode) for details.
+        extra: (Deprecated) Extra fields that will be included in the JSON schema.
+
+            !!! warning Deprecated
+                The `extra` kwargs is deprecated. Use `json_schema_extra` instead.
+
+    Returns:
+        A new [`FieldInfo`][pydantic.fields.FieldInfo]. The return annotation is `Any` so `Field` can be used on
+            type-annotated fields without causing a type error.
     """
-    field_info = FieldInfo(
+    # Check deprecated and removed params from V1. This logic should eventually be removed.
+    const = extra.pop('const', None)  # type: ignore
+    if const is not None:
+        raise PydanticUserError('`const` is removed, use `Literal` instead', code='removed-kwargs')
+
+    min_items = extra.pop('min_items', None)  # type: ignore
+    if min_items is not None:
+        warn('`min_items` is deprecated and will be removed, use `min_length` instead', DeprecationWarning)
+        if min_length in (None, _Unset):
+            min_length = min_items  # type: ignore
+
+    max_items = extra.pop('max_items', None)  # type: ignore
+    if max_items is not None:
+        warn('`max_items` is deprecated and will be removed, use `max_length` instead', DeprecationWarning)
+        if max_length in (None, _Unset):
+            max_length = max_items  # type: ignore
+
+    unique_items = extra.pop('unique_items', None)  # type: ignore
+    if unique_items is not None:
+        raise PydanticUserError(
+            (
+                '`unique_items` is removed, use `Set` instead'
+                '(this feature is discussed in https://github.com/pydantic/pydantic-core/issues/296)'
+            ),
+            code='removed-kwargs',
+        )
+
+    allow_mutation = extra.pop('allow_mutation', None)  # type: ignore
+    if allow_mutation is not None:
+        warn('`allow_mutation` is deprecated and will be removed. use `frozen` instead', DeprecationWarning)
+        if allow_mutation is False:
+            frozen = True
+
+    regex = extra.pop('regex', None)  # type: ignore
+    if regex is not None:
+        raise PydanticUserError('`regex` is removed. use `pattern` instead', code='removed-kwargs')
+
+    if extra:
+        warn(
+            'Using extra keyword arguments on `Field` is deprecated and will be removed.'
+            ' Use `json_schema_extra` instead.'
+            f' (Extra keys: {", ".join(k.__repr__() for k in extra.keys())})',
+            DeprecationWarning,
+        )
+        if not json_schema_extra or json_schema_extra is _Unset:
+            json_schema_extra = extra  # type: ignore
+
+    if (
+        validation_alias
+        and validation_alias is not _Unset
+        and not isinstance(validation_alias, (str, AliasChoices, AliasPath))
+    ):
+        raise TypeError('Invalid `validation_alias` type. it should be `str`, `AliasChoices`, or `AliasPath`')
+
+    if serialization_alias in (_Unset, None) and isinstance(alias, str):
+        serialization_alias = alias
+
+    if validation_alias in (_Unset, None):
+        validation_alias = alias
+
+    include = extra.pop('include', None)  # type: ignore
+    if include is not None:
+        warn('`include` is deprecated and does nothing. It will be removed, use `exclude` instead', DeprecationWarning)
+
+    return FieldInfo.from_field(
         default,
         default_factory=default_factory,
         alias=alias,
+        alias_priority=alias_priority,
+        validation_alias=validation_alias,
+        serialization_alias=serialization_alias,
         title=title,
         description=description,
+        examples=examples,
         exclude=exclude,
-        include=include,
-        const=const,
+        discriminator=discriminator,
+        json_schema_extra=json_schema_extra,
+        frozen=frozen,
+        pattern=pattern,
+        validate_default=validate_default,
+        repr=repr,
+        init=init,
+        init_var=init_var,
+        kw_only=kw_only,
+        strict=strict,
         gt=gt,
         ge=ge,
         lt=lt,
         le=le,
         multiple_of=multiple_of,
+        min_length=min_length,
+        max_length=max_length,
         allow_inf_nan=allow_inf_nan,
         max_digits=max_digits,
         decimal_places=decimal_places,
-        min_items=min_items,
-        max_items=max_items,
-        unique_items=unique_items,
-        min_length=min_length,
-        max_length=max_length,
-        allow_mutation=allow_mutation,
-        regex=regex,
-        discriminator=discriminator,
-        repr=repr,
-        **extra,
+        union_mode=union_mode,
     )
-    field_info._validate()
-    return field_info
 
 
-# used to be an enum but changed to int's for small performance improvement as less access overhead
-SHAPE_SINGLETON = 1
-SHAPE_LIST = 2
-SHAPE_SET = 3
-SHAPE_MAPPING = 4
-SHAPE_TUPLE = 5
-SHAPE_TUPLE_ELLIPSIS = 6
-SHAPE_SEQUENCE = 7
-SHAPE_FROZENSET = 8
-SHAPE_ITERABLE = 9
-SHAPE_GENERIC = 10
-SHAPE_DEQUE = 11
-SHAPE_DICT = 12
-SHAPE_DEFAULTDICT = 13
-SHAPE_COUNTER = 14
-SHAPE_NAME_LOOKUP = {
-    SHAPE_LIST: 'List[{}]',
-    SHAPE_SET: 'Set[{}]',
-    SHAPE_TUPLE_ELLIPSIS: 'Tuple[{}, ...]',
-    SHAPE_SEQUENCE: 'Sequence[{}]',
-    SHAPE_FROZENSET: 'FrozenSet[{}]',
-    SHAPE_ITERABLE: 'Iterable[{}]',
-    SHAPE_DEQUE: 'Deque[{}]',
-    SHAPE_DICT: 'Dict[{}]',
-    SHAPE_DEFAULTDICT: 'DefaultDict[{}]',
-    SHAPE_COUNTER: 'Counter[{}]',
-}
-
-MAPPING_LIKE_SHAPES: Set[int] = {SHAPE_DEFAULTDICT, SHAPE_DICT, SHAPE_MAPPING, SHAPE_COUNTER}
+_FIELD_ARG_NAMES = set(inspect.signature(Field).parameters)
+_FIELD_ARG_NAMES.remove('extra')  # do not include the varkwargs parameter
 
 
-class ModelField(Representation):
-    __slots__ = (
-        'type_',
-        'outer_type_',
-        'annotation',
-        'sub_fields',
-        'sub_fields_mapping',
-        'key_field',
-        'validators',
-        'pre_validators',
-        'post_validators',
-        'default',
-        'default_factory',
-        'required',
-        'final',
-        'model_config',
-        'name',
-        'alias',
-        'has_alias',
-        'field_info',
-        'discriminator_key',
-        'discriminator_alias',
-        'validate_always',
-        'allow_none',
-        'shape',
-        'class_validators',
-        'parse_json',
-    )
+class ModelPrivateAttr(_repr.Representation):
+    """A descriptor for private attributes in class models.
+
+    !!! warning
+        You generally shouldn't be creating `ModelPrivateAttr` instances directly, instead use
+        `pydantic.fields.PrivateAttr`. (This is similar to `FieldInfo` vs. `Field`.)
+
+    Attributes:
+        default: The default value of the attribute if not provided.
+        default_factory: A callable function that generates the default value of the
+            attribute if not provided.
+    """
+
+    __slots__ = 'default', 'default_factory'
 
     def __init__(
-        self,
-        *,
-        name: str,
-        type_: Type[Any],
-        class_validators: Optional[Dict[str, Validator]],
-        model_config: Type['BaseConfig'],
-        default: Any = None,
-        default_factory: Optional[NoArgAnyCallable] = None,
-        required: 'BoolUndefined' = Undefined,
-        final: bool = False,
-        alias: str = None,
-        field_info: Optional[FieldInfo] = None,
+        self, default: Any = PydanticUndefined, *, default_factory: typing.Callable[[], Any] | None = None
     ) -> None:
-
-        self.name: str = name
-        self.has_alias: bool = alias is not None
-        self.alias: str = alias if alias is not None else name
-        self.annotation = type_
-        self.type_: Any = convert_generics(type_)
-        self.outer_type_: Any = type_
-        self.class_validators = class_validators or {}
-        self.default: Any = default
-        self.default_factory: Optional[NoArgAnyCallable] = default_factory
-        self.required: 'BoolUndefined' = required
-        self.final: bool = final
-        self.model_config = model_config
-        self.field_info: FieldInfo = field_info or FieldInfo(default)
-        self.discriminator_key: Optional[str] = self.field_info.discriminator
-        self.discriminator_alias: Optional[str] = self.discriminator_key
-
-        self.allow_none: bool = False
-        self.validate_always: bool = False
-        self.sub_fields: Optional[List[ModelField]] = None
-        self.sub_fields_mapping: Optional[Dict[str, 'ModelField']] = None  # used for discriminated union
-        self.key_field: Optional[ModelField] = None
-        self.validators: 'ValidatorsList' = []
-        self.pre_validators: Optional['ValidatorsList'] = None
-        self.post_validators: Optional['ValidatorsList'] = None
-        self.parse_json: bool = False
-        self.shape: int = SHAPE_SINGLETON
-        self.model_config.prepare_field(self)
-        self.prepare()
-
-    def get_default(self) -> Any:
-        return smart_deepcopy(self.default) if self.default_factory is None else self.default_factory()
-
-    @staticmethod
-    def _get_field_info(
-        field_name: str, annotation: Any, value: Any, config: Type['BaseConfig']
-    ) -> Tuple[FieldInfo, Any]:
-        """
-        Get a FieldInfo from a root typing.Annotated annotation, value, or config default.
-
-        The FieldInfo may be set in typing.Annotated or the value, but not both. If neither contain
-        a FieldInfo, a new one will be created using the config.
-
-        :param field_name: name of the field for use in error messages
-        :param annotation: a type hint such as `str` or `Annotated[str, Field(..., min_length=5)]`
-        :param value: the field's assigned value
-        :param config: the model's config object
-        :return: the FieldInfo contained in the `annotation`, the value, or a new one from the config.
-        """
-        field_info_from_config = config.get_field_info(field_name)
-
-        field_info = None
-        if get_origin(annotation) is Annotated:
-            field_infos = [arg for arg in get_args(annotation)[1:] if isinstance(arg, FieldInfo)]
-            if len(field_infos) > 1:
-                raise ValueError(f'cannot specify multiple `Annotated` `Field`s for {field_name!r}')
-            field_info = next(iter(field_infos), None)
-            if field_info is not None:
-                field_info = copy.copy(field_info)
-                field_info.update_from_config(field_info_from_config)
-                if field_info.default not in (Undefined, Required):
-                    raise ValueError(f'`Field` default cannot be set in `Annotated` for {field_name!r}')
-                if value is not Undefined and value is not Required:
-                    # check also `Required` because of `validate_arguments` that sets `...` as default value
-                    field_info.default = value
-
-        if isinstance(value, FieldInfo):
-            if field_info is not None:
-                raise ValueError(f'cannot specify `Annotated` and value `Field`s together for {field_name!r}')
-            field_info = value
-            field_info.update_from_config(field_info_from_config)
-        elif field_info is None:
-            field_info = FieldInfo(value, **field_info_from_config)
-        value = None if field_info.default_factory is not None else field_info.default
-        field_info._validate()
-        return field_info, value
-
-    @classmethod
-    def infer(
-        cls,
-        *,
-        name: str,
-        value: Any,
-        annotation: Any,
-        class_validators: Optional[Dict[str, Validator]],
-        config: Type['BaseConfig'],
-    ) -> 'ModelField':
-        from .schema import get_annotation_from_field_info
-
-        field_info, value = cls._get_field_info(name, annotation, value, config)
-        required: 'BoolUndefined' = Undefined
-        if value is Required:
-            required = True
-            value = None
-        elif value is not Undefined:
-            required = False
-        annotation = get_annotation_from_field_info(annotation, field_info, name, config.validate_assignment)
-
-        return cls(
-            name=name,
-            type_=annotation,
-            alias=field_info.alias,
-            class_validators=class_validators,
-            default=value,
-            default_factory=field_info.default_factory,
-            required=required,
-            model_config=config,
-            field_info=field_info,
-        )
-
-    def set_config(self, config: Type['BaseConfig']) -> None:
-        self.model_config = config
-        info_from_config = config.get_field_info(self.name)
-        config.prepare_field(self)
-        new_alias = info_from_config.get('alias')
-        new_alias_priority = info_from_config.get('alias_priority') or 0
-        if new_alias and new_alias_priority >= (self.field_info.alias_priority or 0):
-            self.field_info.alias = new_alias
-            self.field_info.alias_priority = new_alias_priority
-            self.alias = new_alias
-        new_exclude = info_from_config.get('exclude')
-        if new_exclude is not None:
-            self.field_info.exclude = ValueItems.merge(self.field_info.exclude, new_exclude)
-        new_include = info_from_config.get('include')
-        if new_include is not None:
-            self.field_info.include = ValueItems.merge(self.field_info.include, new_include, intersect=True)
-
-    @property
-    def alt_alias(self) -> bool:
-        return self.name != self.alias
-
-    def prepare(self) -> None:
-        """
-        Prepare the field but inspecting self.default, self.type_ etc.
-
-        Note: this method is **not** idempotent (because _type_analysis is not idempotent),
-        e.g. calling it it multiple times may modify the field and configure it incorrectly.
-        """
-        self._set_default_and_type()
-        if self.type_.__class__ is ForwardRef or self.type_.__class__ is DeferredType:
-            # self.type_ is currently a ForwardRef and there's nothing we can do now,
-            # user will need to call model.update_forward_refs()
-            return
-
-        self._type_analysis()
-        if self.required is Undefined:
-            self.required = True
-        if self.default is Undefined and self.default_factory is None:
-            self.default = None
-        self.populate_validators()
-
-    def _set_default_and_type(self) -> None:
-        """
-        Set the default value, infer the type if needed and check if `None` value is valid.
-        """
-        if self.default_factory is not None:
-            if self.type_ is Undefined:
-                raise errors_.ConfigError(
-                    f'you need to set the type of field {self.name!r} when using `default_factory`'
-                )
-            return
-
-        default_value = self.get_default()
-
-        if default_value is not None and self.type_ is Undefined:
-            self.type_ = default_value.__class__
-            self.outer_type_ = self.type_
-            self.annotation = self.type_
-
-        if self.type_ is Undefined:
-            raise errors_.ConfigError(f'unable to infer type for attribute "{self.name}"')
-
-        if self.required is False and default_value is None:
-            self.allow_none = True
-
-    def _type_analysis(self) -> None:  # noqa: C901 (ignore complexity)
-        # typing interface is horrible, we have to do some ugly checks
-        if lenient_issubclass(self.type_, JsonWrapper):
-            self.type_ = self.type_.inner_type
-            self.parse_json = True
-        elif lenient_issubclass(self.type_, Json):
-            self.type_ = Any
-            self.parse_json = True
-        elif isinstance(self.type_, TypeVar):
-            if self.type_.__bound__:
-                self.type_ = self.type_.__bound__
-            elif self.type_.__constraints__:
-                self.type_ = Union[self.type_.__constraints__]
-            else:
-                self.type_ = Any
-        elif is_new_type(self.type_):
-            self.type_ = new_type_supertype(self.type_)
-
-        if self.type_ is Any or self.type_ is object:
-            if self.required is Undefined:
-                self.required = False
-            self.allow_none = True
-            return
-        elif self.type_ is Pattern or self.type_ is re.Pattern:
-            # python 3.7 only, Pattern is a typing object but without sub fields
-            return
-        elif is_literal_type(self.type_):
-            return
-        elif is_typeddict(self.type_):
-            return
-
-        if is_finalvar(self.type_):
-            self.final = True
-
-            if self.type_ is Final:
-                self.type_ = Any
-            else:
-                self.type_ = get_args(self.type_)[0]
-
-            self._type_analysis()
-            return
-
-        origin = get_origin(self.type_)
-
-        if origin is Annotated or is_typeddict_special(origin):
-            self.type_ = get_args(self.type_)[0]
-            self._type_analysis()
-            return
-
-        if self.discriminator_key is not None and not is_union(origin):
-            raise TypeError('`discriminator` can only be used with `Union` type with more than one variant')
-
-        # add extra check for `collections.abc.Hashable` for python 3.10+ where origin is not `None`
-        if origin is None or origin is CollectionsHashable:
-            # field is not "typing" object eg. Union, Dict, List etc.
-            # allow None for virtual superclasses of NoneType, e.g. Hashable
-            if isinstance(self.type_, type) and isinstance(None, self.type_):
-                self.allow_none = True
-            return
-        elif origin is Callable:
-            return
-        elif is_union(origin):
-            types_ = []
-            for type_ in get_args(self.type_):
-                if is_none_type(type_) or type_ is Any or type_ is object:
-                    if self.required is Undefined:
-                        self.required = False
-                    self.allow_none = True
-                if is_none_type(type_):
-                    continue
-                types_.append(type_)
-
-            if len(types_) == 1:
-                # Optional[]
-                self.type_ = types_[0]
-                # this is the one case where the "outer type" isn't just the original type
-                self.outer_type_ = self.type_
-                # re-run to correctly interpret the new self.type_
-                self._type_analysis()
-            else:
-                self.sub_fields = [self._create_sub_type(t, f'{self.name}_{display_as_type(t)}') for t in types_]
-
-                if self.discriminator_key is not None:
-                    self.prepare_discriminated_union_sub_fields()
-            return
-        elif issubclass(origin, Tuple):  # type: ignore
-            # origin == Tuple without item type
-            args = get_args(self.type_)
-            if not args:  # plain tuple
-                self.type_ = Any
-                self.shape = SHAPE_TUPLE_ELLIPSIS
-            elif len(args) == 2 and args[1] is Ellipsis:  # e.g. Tuple[int, ...]
-                self.type_ = args[0]
-                self.shape = SHAPE_TUPLE_ELLIPSIS
-                self.sub_fields = [self._create_sub_type(args[0], f'{self.name}_0')]
-            elif args == ((),):  # Tuple[()] means empty tuple
-                self.shape = SHAPE_TUPLE
-                self.type_ = Any
-                self.sub_fields = []
-            else:
-                self.shape = SHAPE_TUPLE
-                self.sub_fields = [self._create_sub_type(t, f'{self.name}_{i}') for i, t in enumerate(args)]
-            return
-        elif issubclass(origin, List):
-            # Create self validators
-            get_validators = getattr(self.type_, '__get_validators__', None)
-            if get_validators:
-                self.class_validators.update(
-                    {f'list_{i}': Validator(validator, pre=True) for i, validator in enumerate(get_validators())}
-                )
-
-            self.type_ = get_args(self.type_)[0]
-            self.shape = SHAPE_LIST
-        elif issubclass(origin, Set):
-            # Create self validators
-            get_validators = getattr(self.type_, '__get_validators__', None)
-            if get_validators:
-                self.class_validators.update(
-                    {f'set_{i}': Validator(validator, pre=True) for i, validator in enumerate(get_validators())}
-                )
-
-            self.type_ = get_args(self.type_)[0]
-            self.shape = SHAPE_SET
-        elif issubclass(origin, FrozenSet):
-            # Create self validators
-            get_validators = getattr(self.type_, '__get_validators__', None)
-            if get_validators:
-                self.class_validators.update(
-                    {f'frozenset_{i}': Validator(validator, pre=True) for i, validator in enumerate(get_validators())}
-                )
-
-            self.type_ = get_args(self.type_)[0]
-            self.shape = SHAPE_FROZENSET
-        elif issubclass(origin, Deque):
-            self.type_ = get_args(self.type_)[0]
-            self.shape = SHAPE_DEQUE
-        elif issubclass(origin, Sequence):
-            self.type_ = get_args(self.type_)[0]
-            self.shape = SHAPE_SEQUENCE
-        # priority to most common mapping: dict
-        elif origin is dict or origin is Dict:
-            self.key_field = self._create_sub_type(get_args(self.type_)[0], 'key_' + self.name, for_keys=True)
-            self.type_ = get_args(self.type_)[1]
-            self.shape = SHAPE_DICT
-        elif issubclass(origin, DefaultDict):
-            self.key_field = self._create_sub_type(get_args(self.type_)[0], 'key_' + self.name, for_keys=True)
-            self.type_ = get_args(self.type_)[1]
-            self.shape = SHAPE_DEFAULTDICT
-        elif issubclass(origin, Counter):
-            self.key_field = self._create_sub_type(get_args(self.type_)[0], 'key_' + self.name, for_keys=True)
-            self.type_ = int
-            self.shape = SHAPE_COUNTER
-        elif issubclass(origin, Mapping):
-            self.key_field = self._create_sub_type(get_args(self.type_)[0], 'key_' + self.name, for_keys=True)
-            self.type_ = get_args(self.type_)[1]
-            self.shape = SHAPE_MAPPING
-        # Equality check as almost everything inherits form Iterable, including str
-        # check for Iterable and CollectionsIterable, as it could receive one even when declared with the other
-        elif origin in {Iterable, CollectionsIterable}:
-            self.type_ = get_args(self.type_)[0]
-            self.shape = SHAPE_ITERABLE
-            self.sub_fields = [self._create_sub_type(self.type_, f'{self.name}_type')]
-        elif issubclass(origin, Type):  # type: ignore
-            return
-        elif hasattr(origin, '__get_validators__') or self.model_config.arbitrary_types_allowed:
-            # Is a Pydantic-compatible generic that handles itself
-            # or we have arbitrary_types_allowed = True
-            self.shape = SHAPE_GENERIC
-            self.sub_fields = [self._create_sub_type(t, f'{self.name}_{i}') for i, t in enumerate(get_args(self.type_))]
-            self.type_ = origin
-            return
-        else:
-            raise TypeError(f'Fields of type "{origin}" are not supported.')
-
-        # type_ has been refined eg. as the type of a List and sub_fields needs to be populated
-        self.sub_fields = [self._create_sub_type(self.type_, '_' + self.name)]
-
-    def prepare_discriminated_union_sub_fields(self) -> None:
-        """
-        Prepare the mapping <discriminator key> -> <ModelField> and update `sub_fields`
-        Note that this process can be aborted if a `ForwardRef` is encountered
-        """
-        assert self.discriminator_key is not None
-
-        if self.type_.__class__ is DeferredType:
-            return
-
-        assert self.sub_fields is not None
-        sub_fields_mapping: Dict[str, 'ModelField'] = {}
-        all_aliases: Set[str] = set()
-
-        for sub_field in self.sub_fields:
-            t = sub_field.type_
-            if t.__class__ is ForwardRef:
-                # Stopping everything...will need to call `update_forward_refs`
-                return
-
-            alias, discriminator_values = get_discriminator_alias_and_values(t, self.discriminator_key)
-            all_aliases.add(alias)
-            for discriminator_value in discriminator_values:
-                sub_fields_mapping[discriminator_value] = sub_field
-
-        self.sub_fields_mapping = sub_fields_mapping
-        self.discriminator_alias = get_unique_discriminator_alias(all_aliases, self.discriminator_key)
-
-    def _create_sub_type(self, type_: Type[Any], name: str, *, for_keys: bool = False) -> 'ModelField':
-        if for_keys:
-            class_validators = None
-        else:
-            # validators for sub items should not have `each_item` as we want to check only the first sublevel
-            class_validators = {
-                k: Validator(
-                    func=v.func,
-                    pre=v.pre,
-                    each_item=False,
-                    always=v.always,
-                    check_fields=v.check_fields,
-                    skip_on_failure=v.skip_on_failure,
-                )
-                for k, v in self.class_validators.items()
-                if v.each_item
-            }
-
-        field_info, _ = self._get_field_info(name, type_, None, self.model_config)
-
-        return self.__class__(
-            type_=type_,
-            name=name,
-            class_validators=class_validators,
-            model_config=self.model_config,
-            field_info=field_info,
-        )
-
-    def populate_validators(self) -> None:
-        """
-        Prepare self.pre_validators, self.validators, and self.post_validators based on self.type_'s  __get_validators__
-        and class validators. This method should be idempotent, e.g. it should be safe to call multiple times
-        without mis-configuring the field.
-        """
-        self.validate_always = getattr(self.type_, 'validate_always', False) or any(
-            v.always for v in self.class_validators.values()
-        )
-
-        class_validators_ = self.class_validators.values()
-        if not self.sub_fields or self.shape == SHAPE_GENERIC:
-            get_validators = getattr(self.type_, '__get_validators__', None)
-            v_funcs = (
-                *[v.func for v in class_validators_ if v.each_item and v.pre],
-                *(get_validators() if get_validators else list(find_validators(self.type_, self.model_config))),
-                *[v.func for v in class_validators_ if v.each_item and not v.pre],
-            )
-            self.validators = prep_validators(v_funcs)
-
-        self.pre_validators = []
-        self.post_validators = []
-
-        if self.field_info and self.field_info.const:
-            self.post_validators.append(make_generic_validator(constant_validator))
-
-        if class_validators_:
-            self.pre_validators += prep_validators(v.func for v in class_validators_ if not v.each_item and v.pre)
-            self.post_validators += prep_validators(v.func for v in class_validators_ if not v.each_item and not v.pre)
-
-        if self.parse_json:
-            self.pre_validators.append(make_generic_validator(validate_json))
-
-        self.pre_validators = self.pre_validators or None
-        self.post_validators = self.post_validators or None
-
-    def validate(
-        self, v: Any, values: Dict[str, Any], *, loc: 'LocStr', cls: Optional['ModelOrDc'] = None
-    ) -> 'ValidateReturn':
-
-        assert self.type_.__class__ is not DeferredType
-
-        if self.type_.__class__ is ForwardRef:
-            assert cls is not None
-            raise ConfigError(
-                f'field "{self.name}" not yet prepared so type is still a ForwardRef, '
-                f'you might need to call {cls.__name__}.update_forward_refs().'
-            )
-
-        errors: Optional['ErrorList']
-        if self.pre_validators:
-            v, errors = self._apply_validators(v, values, loc, cls, self.pre_validators)
-            if errors:
-                return v, errors
-
-        if v is None:
-            if is_none_type(self.type_):
-                # keep validating
-                pass
-            elif self.allow_none:
-                if self.post_validators:
-                    return self._apply_validators(v, values, loc, cls, self.post_validators)
-                else:
-                    return None, None
-            else:
-                return v, ErrorWrapper(NoneIsNotAllowedError(), loc)
-
-        if self.shape == SHAPE_SINGLETON:
-            v, errors = self._validate_singleton(v, values, loc, cls)
-        elif self.shape in MAPPING_LIKE_SHAPES:
-            v, errors = self._validate_mapping_like(v, values, loc, cls)
-        elif self.shape == SHAPE_TUPLE:
-            v, errors = self._validate_tuple(v, values, loc, cls)
-        elif self.shape == SHAPE_ITERABLE:
-            v, errors = self._validate_iterable(v, values, loc, cls)
-        elif self.shape == SHAPE_GENERIC:
-            v, errors = self._apply_validators(v, values, loc, cls, self.validators)
-        else:
-            #  sequence, list, set, generator, tuple with ellipsis, frozen set
-            v, errors = self._validate_sequence_like(v, values, loc, cls)
-
-        if not errors and self.post_validators:
-            v, errors = self._apply_validators(v, values, loc, cls, self.post_validators)
-        return v, errors
-
-    def _validate_sequence_like(  # noqa: C901 (ignore complexity)
-        self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc']
-    ) -> 'ValidateReturn':
-        """
-        Validate sequence-like containers: lists, tuples, sets and generators
-        Note that large if-else blocks are necessary to enable Cython
-        optimization, which is why we disable the complexity check above.
-        """
-        if not sequence_like(v):
-            e: errors_.PydanticTypeError
-            if self.shape == SHAPE_LIST:
-                e = errors_.ListError()
-            elif self.shape in (SHAPE_TUPLE, SHAPE_TUPLE_ELLIPSIS):
-                e = errors_.TupleError()
-            elif self.shape == SHAPE_SET:
-                e = errors_.SetError()
-            elif self.shape == SHAPE_FROZENSET:
-                e = errors_.FrozenSetError()
-            else:
-                e = errors_.SequenceError()
-            return v, ErrorWrapper(e, loc)
-
-        loc = loc if isinstance(loc, tuple) else (loc,)
-        result = []
-        errors: List[ErrorList] = []
-        for i, v_ in enumerate(v):
-            v_loc = *loc, i
-            r, ee = self._validate_singleton(v_, values, v_loc, cls)
-            if ee:
-                errors.append(ee)
-            else:
-                result.append(r)
-
-        if errors:
-            return v, errors
-
-        converted: Union[List[Any], Set[Any], FrozenSet[Any], Tuple[Any, ...], Iterator[Any], Deque[Any]] = result
-
-        if self.shape == SHAPE_SET:
-            converted = set(result)
-        elif self.shape == SHAPE_FROZENSET:
-            converted = frozenset(result)
-        elif self.shape == SHAPE_TUPLE_ELLIPSIS:
-            converted = tuple(result)
-        elif self.shape == SHAPE_DEQUE:
-            converted = deque(result)
-        elif self.shape == SHAPE_SEQUENCE:
-            if isinstance(v, tuple):
-                converted = tuple(result)
-            elif isinstance(v, set):
-                converted = set(result)
-            elif isinstance(v, Generator):
-                converted = iter(result)
-            elif isinstance(v, deque):
-                converted = deque(result)
-        return converted, None
-
-    def _validate_iterable(
-        self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc']
-    ) -> 'ValidateReturn':
-        """
-        Validate Iterables.
-
-        This intentionally doesn't validate values to allow infinite generators.
-        """
-
-        try:
-            iterable = iter(v)
-        except TypeError:
-            return v, ErrorWrapper(errors_.IterableError(), loc)
-        return iterable, None
-
-    def _validate_tuple(
-        self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc']
-    ) -> 'ValidateReturn':
-        e: Optional[Exception] = None
-        if not sequence_like(v):
-            e = errors_.TupleError()
-        else:
-            actual_length, expected_length = len(v), len(self.sub_fields)  # type: ignore
-            if actual_length != expected_length:
-                e = errors_.TupleLengthError(actual_length=actual_length, expected_length=expected_length)
-
-        if e:
-            return v, ErrorWrapper(e, loc)
-
-        loc = loc if isinstance(loc, tuple) else (loc,)
-        result = []
-        errors: List[ErrorList] = []
-        for i, (v_, field) in enumerate(zip(v, self.sub_fields)):  # type: ignore
-            v_loc = *loc, i
-            r, ee = field.validate(v_, values, loc=v_loc, cls=cls)
-            if ee:
-                errors.append(ee)
-            else:
-                result.append(r)
-
-        if errors:
-            return v, errors
-        else:
-            return tuple(result), None
-
-    def _validate_mapping_like(
-        self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc']
-    ) -> 'ValidateReturn':
-        try:
-            v_iter = dict_validator(v)
-        except TypeError as exc:
-            return v, ErrorWrapper(exc, loc)
-
-        loc = loc if isinstance(loc, tuple) else (loc,)
-        result, errors = {}, []
-        for k, v_ in v_iter.items():
-            v_loc = *loc, '__key__'
-            key_result, key_errors = self.key_field.validate(k, values, loc=v_loc, cls=cls)  # type: ignore
-            if key_errors:
-                errors.append(key_errors)
-                continue
-
-            v_loc = *loc, k
-            value_result, value_errors = self._validate_singleton(v_, values, v_loc, cls)
-            if value_errors:
-                errors.append(value_errors)
-                continue
-
-            result[key_result] = value_result
-        if errors:
-            return v, errors
-        elif self.shape == SHAPE_DICT:
-            return result, None
-        elif self.shape == SHAPE_DEFAULTDICT:
-            return defaultdict(self.type_, result), None
-        elif self.shape == SHAPE_COUNTER:
-            return CollectionCounter(result), None
-        else:
-            return self._get_mapping_value(v, result), None
-
-    def _get_mapping_value(self, original: T, converted: Dict[Any, Any]) -> Union[T, Dict[Any, Any]]:
-        """
-        When type is `Mapping[KT, KV]` (or another unsupported mapping), we try to avoid
-        coercing to `dict` unwillingly.
-        """
-        original_cls = original.__class__
-
-        if original_cls == dict or original_cls == Dict:
-            return converted
-        elif original_cls in {defaultdict, DefaultDict}:
-            return defaultdict(self.type_, converted)
-        else:
-            try:
-                # Counter, OrderedDict, UserDict, ...
-                return original_cls(converted)  # type: ignore
-            except TypeError:
-                raise RuntimeError(f'Could not convert dictionary to {original_cls.__name__!r}') from None
-
-    def _validate_singleton(
-        self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc']
-    ) -> 'ValidateReturn':
-        if self.sub_fields:
-            if self.discriminator_key is not None:
-                return self._validate_discriminated_union(v, values, loc, cls)
-
-            errors = []
-
-            if self.model_config.smart_union and is_union(get_origin(self.type_)):
-                # 1st pass: check if the value is an exact instance of one of the Union types
-                # (e.g. to avoid coercing a bool into an int)
-                for field in self.sub_fields:
-                    if v.__class__ is field.outer_type_:
-                        return v, None
-
-                # 2nd pass: check if the value is an instance of any subclass of the Union types
-                for field in self.sub_fields:
-                    # This whole logic will be improved later on to support more complex `isinstance` checks
-                    # It will probably be done once a strict mode is added and be something like:
-                    # ```
-                    #     value, error = field.validate(v, values, strict=True)
-                    #     if error is None:
-                    #         return value, None
-                    # ```
-                    try:
-                        if isinstance(v, field.outer_type_):
-                            return v, None
-                    except TypeError:
-                        # compound type
-                        if lenient_isinstance(v, get_origin(field.outer_type_)):
-                            value, error = field.validate(v, values, loc=loc, cls=cls)
-                            if not error:
-                                return value, None
-
-            # 1st pass by default or 3rd pass with `smart_union` enabled:
-            # check if the value can be coerced into one of the Union types
-            for field in self.sub_fields:
-                value, error = field.validate(v, values, loc=loc, cls=cls)
-                if error:
-                    errors.append(error)
-                else:
-                    return value, None
-            return v, errors
-        else:
-            return self._apply_validators(v, values, loc, cls, self.validators)
-
-    def _validate_discriminated_union(
-        self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc']
-    ) -> 'ValidateReturn':
-        assert self.discriminator_key is not None
-        assert self.discriminator_alias is not None
-
-        try:
-            discriminator_value = v[self.discriminator_alias]
-        except KeyError:
-            return v, ErrorWrapper(MissingDiscriminator(discriminator_key=self.discriminator_key), loc)
-        except TypeError:
-            try:
-                # BaseModel or dataclass
-                discriminator_value = getattr(v, self.discriminator_key)
-            except (AttributeError, TypeError):
-                return v, ErrorWrapper(MissingDiscriminator(discriminator_key=self.discriminator_key), loc)
-
-        try:
-            sub_field = self.sub_fields_mapping[discriminator_value]  # type: ignore[index]
-        except TypeError:
-            assert cls is not None
-            raise ConfigError(
-                f'field "{self.name}" not yet prepared so type is still a ForwardRef, '
-                f'you might need to call {cls.__name__}.update_forward_refs().'
-            )
-        except KeyError:
-            assert self.sub_fields_mapping is not None
-            return v, ErrorWrapper(
-                InvalidDiscriminator(
-                    discriminator_key=self.discriminator_key,
-                    discriminator_value=discriminator_value,
-                    allowed_values=list(self.sub_fields_mapping),
-                ),
-                loc,
-            )
-        else:
-            if not isinstance(loc, tuple):
-                loc = (loc,)
-            return sub_field.validate(v, values, loc=(*loc, display_as_type(sub_field.type_)), cls=cls)
-
-    def _apply_validators(
-        self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc'], validators: 'ValidatorsList'
-    ) -> 'ValidateReturn':
-        for validator in validators:
-            try:
-                v = validator(cls, v, values, self, self.model_config)
-            except (ValueError, TypeError, AssertionError) as exc:
-                return v, ErrorWrapper(exc, loc)
-        return v, None
-
-    def is_complex(self) -> bool:
-        """
-        Whether the field is "complex" eg. env variables should be parsed as JSON.
-        """
-        from .main import BaseModel
-
-        return (
-            self.shape != SHAPE_SINGLETON
-            or hasattr(self.type_, '__pydantic_model__')
-            or lenient_issubclass(self.type_, (BaseModel, list, set, frozenset, dict))
-        )
-
-    def _type_display(self) -> PyObjectStr:
-        t = display_as_type(self.type_)
-
-        if self.shape in MAPPING_LIKE_SHAPES:
-            t = f'Mapping[{display_as_type(self.key_field.type_)}, {t}]'  # type: ignore
-        elif self.shape == SHAPE_TUPLE:
-            t = 'Tuple[{}]'.format(', '.join(display_as_type(f.type_) for f in self.sub_fields))  # type: ignore
-        elif self.shape == SHAPE_GENERIC:
-            assert self.sub_fields
-            t = '{}[{}]'.format(
-                display_as_type(self.type_), ', '.join(display_as_type(f.type_) for f in self.sub_fields)
-            )
-        elif self.shape != SHAPE_SINGLETON:
-            t = SHAPE_NAME_LOOKUP[self.shape].format(t)
-
-        if self.allow_none and (self.shape != SHAPE_SINGLETON or not self.sub_fields):
-            t = f'Optional[{t}]'
-        return PyObjectStr(t)
-
-    def __repr_args__(self) -> 'ReprArgs':
-        args = [('name', self.name), ('type', self._type_display()), ('required', self.required)]
-
-        if not self.required:
-            if self.default_factory is not None:
-                args.append(('default_factory', f'<function {self.default_factory.__name__}>'))
-            else:
-                args.append(('default', self.default))
-
-        if self.alt_alias:
-            args.append(('alias', self.alias))
-        return args
-
-
-class ModelPrivateAttr(Representation):
-    __slots__ = ('default', 'default_factory')
-
-    def __init__(self, default: Any = Undefined, *, default_factory: Optional[NoArgAnyCallable] = None) -> None:
         self.default = default
         self.default_factory = default_factory
 
+    if not typing.TYPE_CHECKING:
+        # We put `__getattr__` in a non-TYPE_CHECKING block because otherwise, mypy allows arbitrary attribute access
+
+        def __getattr__(self, item: str) -> Any:
+            """This function improves compatibility with custom descriptors by ensuring delegation happens
+            as expected when the default value of a private attribute is a descriptor.
+            """
+            if item in {'__get__', '__set__', '__delete__'}:
+                if hasattr(self.default, item):
+                    return getattr(self.default, item)
+            raise AttributeError(f'{type(self).__name__!r} object has no attribute {item!r}')
+
+    def __set_name__(self, cls: type[Any], name: str) -> None:
+        """Preserve `__set_name__` protocol defined in https://peps.python.org/pep-0487."""
+        if self.default is PydanticUndefined:
+            return
+        if not hasattr(self.default, '__set_name__'):
+            return
+        set_name = self.default.__set_name__
+        if callable(set_name):
+            set_name(cls, name)
+
     def get_default(self) -> Any:
-        return smart_deepcopy(self.default) if self.default_factory is None else self.default_factory()
+        """Retrieve the default value of the object.
+
+        If `self.default_factory` is `None`, the method will return a deep copy of the `self.default` object.
+
+        If `self.default_factory` is not `None`, it will call `self.default_factory` and return the value returned.
+
+        Returns:
+            The default value of the object.
+        """
+        return _utils.smart_deepcopy(self.default) if self.default_factory is None else self.default_factory()
 
     def __eq__(self, other: Any) -> bool:
         return isinstance(other, self.__class__) and (self.default, self.default_factory) == (
@@ -1213,23 +879,32 @@ class ModelPrivateAttr(Representation):
 
 
 def PrivateAttr(
-    default: Any = Undefined,
+    default: Any = PydanticUndefined,
     *,
-    default_factory: Optional[NoArgAnyCallable] = None,
+    default_factory: typing.Callable[[], Any] | None = None,
 ) -> Any:
+    """Usage docs: https://docs.pydantic.dev/2.6/concepts/models/#private-model-attributes
+
+    Indicates that an attribute is intended for private use and not handled during normal validation/serialization.
+
+    Private attributes are not validated by Pydantic, so it's up to you to ensure they are used in a type-safe manner.
+
+    Private attributes are stored in `__private_attributes__` on the model.
+
+    Args:
+        default: The attribute's default value. Defaults to Undefined.
+        default_factory: Callable that will be
+            called when a default value is needed for this attribute.
+            If both `default` and `default_factory` are set, an error will be raised.
+
+    Returns:
+        An instance of [`ModelPrivateAttr`][pydantic.fields.ModelPrivateAttr] class.
+
+    Raises:
+        ValueError: If both `default` and `default_factory` are set.
     """
-    Indicates that attribute is only used internally and never mixed with regular fields.
-
-    Types or values of private attrs are not checked by pydantic and it's up to you to keep them relevant.
-
-    Private attrs are stored in model __slots__.
-
-    :param default: the attribute’s default value
-    :param default_factory: callable that will be called when a default value is needed for this attribute
-      If both `default` and `default_factory` are set, an error is raised.
-    """
-    if default is not Undefined and default_factory is not None:
-        raise ValueError('cannot specify both default and default_factory')
+    if default is not PydanticUndefined and default_factory is not None:
+        raise TypeError('cannot specify both default and default_factory')
 
     return ModelPrivateAttr(
         default,
@@ -1237,11 +912,243 @@ def PrivateAttr(
     )
 
 
-class DeferredType:
-    """
-    Used to postpone field preparation, while creating recursive generic models.
+@dataclasses.dataclass(**_internal_dataclass.slots_true)
+class ComputedFieldInfo:
+    """A container for data from `@computed_field` so that we can access it while building the pydantic-core schema.
+
+    Attributes:
+        decorator_repr: A class variable representing the decorator string, '@computed_field'.
+        wrapped_property: The wrapped computed field property.
+        return_type: The type of the computed field property's return value.
+        alias: The alias of the property to be used during serialization.
+        alias_priority: The priority of the alias. This affects whether an alias generator is used.
+        title: Title of the computed field to include in the serialization JSON schema.
+        description: Description of the computed field to include in the serialization JSON schema.
+        examples: Example values of the computed field to include in the serialization JSON schema.
+        json_schema_extra: A dict or callable to provide extra JSON schema properties.
+        repr: A boolean indicating whether to include the field in the __repr__ output.
     """
 
+    decorator_repr: ClassVar[str] = '@computed_field'
+    wrapped_property: property
+    return_type: Any
+    alias: str | None
+    alias_priority: int | None
+    title: str | None
+    description: str | None
+    examples: list[Any] | None
+    json_schema_extra: JsonDict | typing.Callable[[JsonDict], None] | None
+    repr: bool
 
-def is_finalvar_with_default_val(type_: Type[Any], val: Any) -> bool:
-    return is_finalvar(type_) and val is not Undefined and not isinstance(val, FieldInfo)
+
+def _wrapped_property_is_private(property_: cached_property | property) -> bool:  # type: ignore
+    """Returns true if provided property is private, False otherwise."""
+    wrapped_name: str = ''
+
+    if isinstance(property_, property):
+        wrapped_name = getattr(property_.fget, '__name__', '')
+    elif isinstance(property_, cached_property):  # type: ignore
+        wrapped_name = getattr(property_.func, '__name__', '')  # type: ignore
+
+    return wrapped_name.startswith('_') and not wrapped_name.startswith('__')
+
+
+# this should really be `property[T], cached_property[T]` but property is not generic unlike cached_property
+# See https://github.com/python/typing/issues/985 and linked issues
+PropertyT = typing.TypeVar('PropertyT')
+
+
+@typing.overload
+def computed_field(
+    *,
+    alias: str | None = None,
+    alias_priority: int | None = None,
+    title: str | None = None,
+    description: str | None = None,
+    examples: list[Any] | None = None,
+    json_schema_extra: JsonDict | typing.Callable[[JsonDict], None] | None = None,
+    repr: bool = True,
+    return_type: Any = PydanticUndefined,
+) -> typing.Callable[[PropertyT], PropertyT]:
+    ...
+
+
+@typing.overload
+def computed_field(__func: PropertyT) -> PropertyT:
+    ...
+
+
+def computed_field(
+    __f: PropertyT | None = None,
+    *,
+    alias: str | None = None,
+    alias_priority: int | None = None,
+    title: str | None = None,
+    description: str | None = None,
+    examples: list[Any] | None = None,
+    json_schema_extra: JsonDict | typing.Callable[[JsonDict], None] | None = None,
+    repr: bool | None = None,
+    return_type: Any = PydanticUndefined,
+) -> PropertyT | typing.Callable[[PropertyT], PropertyT]:
+    """Usage docs: https://docs.pydantic.dev/2.6/concepts/fields#the-computed_field-decorator
+
+    Decorator to include `property` and `cached_property` when serializing models or dataclasses.
+
+    This is useful for fields that are computed from other fields, or for fields that are expensive to compute and should be cached.
+
+    ```py
+    from pydantic import BaseModel, computed_field
+
+    class Rectangle(BaseModel):
+        width: int
+        length: int
+
+        @computed_field
+        @property
+        def area(self) -> int:
+            return self.width * self.length
+
+    print(Rectangle(width=3, length=2).model_dump())
+    #> {'width': 3, 'length': 2, 'area': 6}
+    ```
+
+    If applied to functions not yet decorated with `@property` or `@cached_property`, the function is
+    automatically wrapped with `property`. Although this is more concise, you will lose IntelliSense in your IDE,
+    and confuse static type checkers, thus explicit use of `@property` is recommended.
+
+    !!! warning "Mypy Warning"
+        Even with the `@property` or `@cached_property` applied to your function before `@computed_field`,
+        mypy may throw a `Decorated property not supported` error.
+        See [mypy issue #1362](https://github.com/python/mypy/issues/1362), for more information.
+        To avoid this error message, add `# type: ignore[misc]` to the `@computed_field` line.
+
+        [pyright](https://github.com/microsoft/pyright) supports `@computed_field` without error.
+
+    ```py
+    import random
+
+    from pydantic import BaseModel, computed_field
+
+    class Square(BaseModel):
+        width: float
+
+        @computed_field
+        def area(self) -> float:  # converted to a `property` by `computed_field`
+            return round(self.width**2, 2)
+
+        @area.setter
+        def area(self, new_area: float) -> None:
+            self.width = new_area**0.5
+
+        @computed_field(alias='the magic number', repr=False)
+        def random_number(self) -> int:
+            return random.randint(0, 1_000)
+
+    square = Square(width=1.3)
+
+    # `random_number` does not appear in representation
+    print(repr(square))
+    #> Square(width=1.3, area=1.69)
+
+    print(square.random_number)
+    #> 3
+
+    square.area = 4
+
+    print(square.model_dump_json(by_alias=True))
+    #> {"width":2.0,"area":4.0,"the magic number":3}
+    ```
+
+    !!! warning "Overriding with `computed_field`"
+        You can't override a field from a parent class with a `computed_field` in the child class.
+        `mypy` complains about this behavior if allowed, and `dataclasses` doesn't allow this pattern either.
+        See the example below:
+
+    ```py
+    from pydantic import BaseModel, computed_field
+
+    class Parent(BaseModel):
+        a: str
+
+    try:
+
+        class Child(Parent):
+            @computed_field
+            @property
+            def a(self) -> str:
+                return 'new a'
+
+    except ValueError as e:
+        print(repr(e))
+        #> ValueError("you can't override a field with a computed field")
+    ```
+
+    Private properties decorated with `@computed_field` have `repr=False` by default.
+
+    ```py
+    from functools import cached_property
+
+    from pydantic import BaseModel, computed_field
+
+    class Model(BaseModel):
+        foo: int
+
+        @computed_field
+        @cached_property
+        def _private_cached_property(self) -> int:
+            return -self.foo
+
+        @computed_field
+        @property
+        def _private_property(self) -> int:
+            return -self.foo
+
+    m = Model(foo=1)
+    print(repr(m))
+    #> M(foo=1)
+    ```
+
+    Args:
+        __f: the function to wrap.
+        alias: alias to use when serializing this computed field, only used when `by_alias=True`
+        alias_priority: priority of the alias. This affects whether an alias generator is used
+        title: Title to use when including this computed field in JSON Schema
+        description: Description to use when including this computed field in JSON Schema, defaults to the function's
+            docstring
+        examples: Example values to use when including this computed field in JSON Schema
+        json_schema_extra: A dict or callable to provide extra JSON schema properties.
+        repr: whether to include this computed field in model repr.
+            Default is `False` for private properties and `True` for public properties.
+        return_type: optional return for serialization logic to expect when serializing to JSON, if included
+            this must be correct, otherwise a `TypeError` is raised.
+            If you don't include a return type Any is used, which does runtime introspection to handle arbitrary
+            objects.
+
+    Returns:
+        A proxy wrapper for the property.
+    """
+
+    def dec(f: Any) -> Any:
+        nonlocal description, return_type, alias_priority
+        unwrapped = _decorators.unwrap_wrapped_function(f)
+        if description is None and unwrapped.__doc__:
+            description = inspect.cleandoc(unwrapped.__doc__)
+
+        # if the function isn't already decorated with `@property` (or another descriptor), then we wrap it now
+        f = _decorators.ensure_property(f)
+        alias_priority = (alias_priority or 2) if alias is not None else None
+
+        if repr is None:
+            repr_: bool = False if _wrapped_property_is_private(property_=f) else True
+        else:
+            repr_ = repr
+
+        dec_info = ComputedFieldInfo(
+            f, return_type, alias, alias_priority, title, description, examples, json_schema_extra, repr_
+        )
+        return _decorators.PydanticDescriptorProxy(f, dec_info)
+
+    if __f is None:
+        return dec
+    else:
+        return dec(__f)
diff --git a/lib/pydantic/functional_serializers.py b/lib/pydantic/functional_serializers.py
new file mode 100644
index 00000000..6e31bf67
--- /dev/null
+++ b/lib/pydantic/functional_serializers.py
@@ -0,0 +1,395 @@
+"""This module contains related classes and functions for serialization."""
+from __future__ import annotations
+
+import dataclasses
+from functools import partialmethod
+from typing import TYPE_CHECKING, Any, Callable, TypeVar, Union, overload
+
+from pydantic_core import PydanticUndefined, core_schema
+from pydantic_core import core_schema as _core_schema
+from typing_extensions import Annotated, Literal, TypeAlias
+
+from . import PydanticUndefinedAnnotation
+from ._internal import _decorators, _internal_dataclass
+from .annotated_handlers import GetCoreSchemaHandler
+
+
+@dataclasses.dataclass(**_internal_dataclass.slots_true, frozen=True)
+class PlainSerializer:
+    """Plain serializers use a function to modify the output of serialization.
+
+    This is particularly helpful when you want to customize the serialization for annotated types.
+    Consider an input of `list`, which will be serialized into a space-delimited string.
+
+    ```python
+    from typing import List
+
+    from typing_extensions import Annotated
+
+    from pydantic import BaseModel, PlainSerializer
+
+    CustomStr = Annotated[
+        List, PlainSerializer(lambda x: ' '.join(x), return_type=str)
+    ]
+
+    class StudentModel(BaseModel):
+        courses: CustomStr
+
+    student = StudentModel(courses=['Math', 'Chemistry', 'English'])
+    print(student.model_dump())
+    #> {'courses': 'Math Chemistry English'}
+    ```
+
+    Attributes:
+        func: The serializer function.
+        return_type: The return type for the function. If omitted it will be inferred from the type annotation.
+        when_used: Determines when this serializer should be used. Accepts a string with values `'always'`,
+            `'unless-none'`, `'json'`, and `'json-unless-none'`. Defaults to 'always'.
+    """
+
+    func: core_schema.SerializerFunction
+    return_type: Any = PydanticUndefined
+    when_used: Literal['always', 'unless-none', 'json', 'json-unless-none'] = 'always'
+
+    def __get_pydantic_core_schema__(self, source_type: Any, handler: GetCoreSchemaHandler) -> core_schema.CoreSchema:
+        """Gets the Pydantic core schema.
+
+        Args:
+            source_type: The source type.
+            handler: The `GetCoreSchemaHandler` instance.
+
+        Returns:
+            The Pydantic core schema.
+        """
+        schema = handler(source_type)
+        try:
+            return_type = _decorators.get_function_return_type(
+                self.func, self.return_type, handler._get_types_namespace()
+            )
+        except NameError as e:
+            raise PydanticUndefinedAnnotation.from_name_error(e) from e
+        return_schema = None if return_type is PydanticUndefined else handler.generate_schema(return_type)
+        schema['serialization'] = core_schema.plain_serializer_function_ser_schema(
+            function=self.func,
+            info_arg=_decorators.inspect_annotated_serializer(self.func, 'plain'),
+            return_schema=return_schema,
+            when_used=self.when_used,
+        )
+        return schema
+
+
+@dataclasses.dataclass(**_internal_dataclass.slots_true, frozen=True)
+class WrapSerializer:
+    """Wrap serializers receive the raw inputs along with a handler function that applies the standard serialization
+    logic, and can modify the resulting value before returning it as the final output of serialization.
+
+    For example, here's a scenario in which a wrap serializer transforms timezones to UTC **and** utilizes the existing `datetime` serialization logic.
+
+    ```python
+    from datetime import datetime, timezone
+    from typing import Any, Dict
+
+    from typing_extensions import Annotated
+
+    from pydantic import BaseModel, WrapSerializer
+
+    class EventDatetime(BaseModel):
+        start: datetime
+        end: datetime
+
+    def convert_to_utc(value: Any, handler, info) -> Dict[str, datetime]:
+        # Note that `helper` can actually help serialize the `value` for further custom serialization in case it's a subclass.
+        partial_result = handler(value, info)
+        if info.mode == 'json':
+            return {
+                k: datetime.fromisoformat(v).astimezone(timezone.utc)
+                for k, v in partial_result.items()
+            }
+        return {k: v.astimezone(timezone.utc) for k, v in partial_result.items()}
+
+    UTCEventDatetime = Annotated[EventDatetime, WrapSerializer(convert_to_utc)]
+
+    class EventModel(BaseModel):
+        event_datetime: UTCEventDatetime
+
+    dt = EventDatetime(
+        start='2024-01-01T07:00:00-08:00', end='2024-01-03T20:00:00+06:00'
+    )
+    event = EventModel(event_datetime=dt)
+    print(event.model_dump())
+    '''
+    {
+        'event_datetime': {
+            'start': datetime.datetime(
+                2024, 1, 1, 15, 0, tzinfo=datetime.timezone.utc
+            ),
+            'end': datetime.datetime(
+                2024, 1, 3, 14, 0, tzinfo=datetime.timezone.utc
+            ),
+        }
+    }
+    '''
+
+    print(event.model_dump_json())
+    '''
+    {"event_datetime":{"start":"2024-01-01T15:00:00Z","end":"2024-01-03T14:00:00Z"}}
+    '''
+    ```
+
+    Attributes:
+        func: The serializer function to be wrapped.
+        return_type: The return type for the function. If omitted it will be inferred from the type annotation.
+        when_used: Determines when this serializer should be used. Accepts a string with values `'always'`,
+            `'unless-none'`, `'json'`, and `'json-unless-none'`. Defaults to 'always'.
+    """
+
+    func: core_schema.WrapSerializerFunction
+    return_type: Any = PydanticUndefined
+    when_used: Literal['always', 'unless-none', 'json', 'json-unless-none'] = 'always'
+
+    def __get_pydantic_core_schema__(self, source_type: Any, handler: GetCoreSchemaHandler) -> core_schema.CoreSchema:
+        """This method is used to get the Pydantic core schema of the class.
+
+        Args:
+            source_type: Source type.
+            handler: Core schema handler.
+
+        Returns:
+            The generated core schema of the class.
+        """
+        schema = handler(source_type)
+        try:
+            return_type = _decorators.get_function_return_type(
+                self.func, self.return_type, handler._get_types_namespace()
+            )
+        except NameError as e:
+            raise PydanticUndefinedAnnotation.from_name_error(e) from e
+        return_schema = None if return_type is PydanticUndefined else handler.generate_schema(return_type)
+        schema['serialization'] = core_schema.wrap_serializer_function_ser_schema(
+            function=self.func,
+            info_arg=_decorators.inspect_annotated_serializer(self.func, 'wrap'),
+            return_schema=return_schema,
+            when_used=self.when_used,
+        )
+        return schema
+
+
+if TYPE_CHECKING:
+    _PartialClsOrStaticMethod: TypeAlias = Union[classmethod[Any, Any, Any], staticmethod[Any, Any], partialmethod[Any]]
+    _PlainSerializationFunction = Union[_core_schema.SerializerFunction, _PartialClsOrStaticMethod]
+    _WrapSerializationFunction = Union[_core_schema.WrapSerializerFunction, _PartialClsOrStaticMethod]
+    _PlainSerializeMethodType = TypeVar('_PlainSerializeMethodType', bound=_PlainSerializationFunction)
+    _WrapSerializeMethodType = TypeVar('_WrapSerializeMethodType', bound=_WrapSerializationFunction)
+
+
+@overload
+def field_serializer(
+    __field: str,
+    *fields: str,
+    return_type: Any = ...,
+    when_used: Literal['always', 'unless-none', 'json', 'json-unless-none'] = ...,
+    check_fields: bool | None = ...,
+) -> Callable[[_PlainSerializeMethodType], _PlainSerializeMethodType]:
+    ...
+
+
+@overload
+def field_serializer(
+    __field: str,
+    *fields: str,
+    mode: Literal['plain'],
+    return_type: Any = ...,
+    when_used: Literal['always', 'unless-none', 'json', 'json-unless-none'] = ...,
+    check_fields: bool | None = ...,
+) -> Callable[[_PlainSerializeMethodType], _PlainSerializeMethodType]:
+    ...
+
+
+@overload
+def field_serializer(
+    __field: str,
+    *fields: str,
+    mode: Literal['wrap'],
+    return_type: Any = ...,
+    when_used: Literal['always', 'unless-none', 'json', 'json-unless-none'] = ...,
+    check_fields: bool | None = ...,
+) -> Callable[[_WrapSerializeMethodType], _WrapSerializeMethodType]:
+    ...
+
+
+def field_serializer(
+    *fields: str,
+    mode: Literal['plain', 'wrap'] = 'plain',
+    return_type: Any = PydanticUndefined,
+    when_used: Literal['always', 'unless-none', 'json', 'json-unless-none'] = 'always',
+    check_fields: bool | None = None,
+) -> Callable[[Any], Any]:
+    """Decorator that enables custom field serialization.
+
+    In the below example, a field of type `set` is used to mitigate duplication. A `field_serializer` is used to serialize the data as a sorted list.
+
+    ```python
+    from typing import Set
+
+    from pydantic import BaseModel, field_serializer
+
+    class StudentModel(BaseModel):
+        name: str = 'Jane'
+        courses: Set[str]
+
+        @field_serializer('courses', when_used='json')
+        def serialize_courses_in_order(courses: Set[str]):
+            return sorted(courses)
+
+    student = StudentModel(courses={'Math', 'Chemistry', 'English'})
+    print(student.model_dump_json())
+    #> {"name":"Jane","courses":["Chemistry","English","Math"]}
+    ```
+
+    See [Custom serializers](../concepts/serialization.md#custom-serializers) for more information.
+
+    Four signatures are supported:
+
+    - `(self, value: Any, info: FieldSerializationInfo)`
+    - `(self, value: Any, nxt: SerializerFunctionWrapHandler, info: FieldSerializationInfo)`
+    - `(value: Any, info: SerializationInfo)`
+    - `(value: Any, nxt: SerializerFunctionWrapHandler, info: SerializationInfo)`
+
+    Args:
+        fields: Which field(s) the method should be called on.
+        mode: The serialization mode.
+
+            - `plain` means the function will be called instead of the default serialization logic,
+            - `wrap` means the function will be called with an argument to optionally call the
+               default serialization logic.
+        return_type: Optional return type for the function, if omitted it will be inferred from the type annotation.
+        when_used: Determines the serializer will be used for serialization.
+        check_fields: Whether to check that the fields actually exist on the model.
+
+    Returns:
+        The decorator function.
+    """
+
+    def dec(
+        f: Callable[..., Any] | staticmethod[Any, Any] | classmethod[Any, Any, Any],
+    ) -> _decorators.PydanticDescriptorProxy[Any]:
+        dec_info = _decorators.FieldSerializerDecoratorInfo(
+            fields=fields,
+            mode=mode,
+            return_type=return_type,
+            when_used=when_used,
+            check_fields=check_fields,
+        )
+        return _decorators.PydanticDescriptorProxy(f, dec_info)
+
+    return dec
+
+
+FuncType = TypeVar('FuncType', bound=Callable[..., Any])
+
+
+@overload
+def model_serializer(__f: FuncType) -> FuncType:
+    ...
+
+
+@overload
+def model_serializer(
+    *,
+    mode: Literal['plain', 'wrap'] = ...,
+    when_used: Literal['always', 'unless-none', 'json', 'json-unless-none'] = 'always',
+    return_type: Any = ...,
+) -> Callable[[FuncType], FuncType]:
+    ...
+
+
+def model_serializer(
+    __f: Callable[..., Any] | None = None,
+    *,
+    mode: Literal['plain', 'wrap'] = 'plain',
+    when_used: Literal['always', 'unless-none', 'json', 'json-unless-none'] = 'always',
+    return_type: Any = PydanticUndefined,
+) -> Callable[[Any], Any]:
+    """Decorator that enables custom model serialization.
+
+    This is useful when a model need to be serialized in a customized manner, allowing for flexibility beyond just specific fields.
+
+    An example would be to serialize temperature to the same temperature scale, such as degrees Celsius.
+
+    ```python
+    from typing import Literal
+
+    from pydantic import BaseModel, model_serializer
+
+    class TemperatureModel(BaseModel):
+        unit: Literal['C', 'F']
+        value: int
+
+        @model_serializer()
+        def serialize_model(self):
+            if self.unit == 'F':
+                return {'unit': 'C', 'value': int((self.value - 32) / 1.8)}
+            return {'unit': self.unit, 'value': self.value}
+
+    temperature = TemperatureModel(unit='F', value=212)
+    print(temperature.model_dump())
+    #> {'unit': 'C', 'value': 100}
+    ```
+
+    See [Custom serializers](../concepts/serialization.md#custom-serializers) for more information.
+
+    Args:
+        __f: The function to be decorated.
+        mode: The serialization mode.
+
+            - `'plain'` means the function will be called instead of the default serialization logic
+            - `'wrap'` means the function will be called with an argument to optionally call the default
+                serialization logic.
+        when_used: Determines when this serializer should be used.
+        return_type: The return type for the function. If omitted it will be inferred from the type annotation.
+
+    Returns:
+        The decorator function.
+    """
+
+    def dec(f: Callable[..., Any]) -> _decorators.PydanticDescriptorProxy[Any]:
+        dec_info = _decorators.ModelSerializerDecoratorInfo(mode=mode, return_type=return_type, when_used=when_used)
+        return _decorators.PydanticDescriptorProxy(f, dec_info)
+
+    if __f is None:
+        return dec
+    else:
+        return dec(__f)  # type: ignore
+
+
+AnyType = TypeVar('AnyType')
+
+
+if TYPE_CHECKING:
+    SerializeAsAny = Annotated[AnyType, ...]  # SerializeAsAny[list[str]] will be treated by type checkers as list[str]
+    """Force serialization to ignore whatever is defined in the schema and instead ask the object
+    itself how it should be serialized.
+    In particular, this means that when model subclasses are serialized, fields present in the subclass
+    but not in the original schema will be included.
+    """
+else:
+
+    @dataclasses.dataclass(**_internal_dataclass.slots_true)
+    class SerializeAsAny:  # noqa: D101
+        def __class_getitem__(cls, item: Any) -> Any:
+            return Annotated[item, SerializeAsAny()]
+
+        def __get_pydantic_core_schema__(
+            self, source_type: Any, handler: GetCoreSchemaHandler
+        ) -> core_schema.CoreSchema:
+            schema = handler(source_type)
+            schema_to_update = schema
+            while schema_to_update['type'] == 'definitions':
+                schema_to_update = schema_to_update.copy()
+                schema_to_update = schema_to_update['schema']
+            schema_to_update['serialization'] = core_schema.wrap_serializer_function_ser_schema(
+                lambda x, h: h(x), schema=core_schema.any_schema()
+            )
+            return schema
+
+        __hash__ = object.__hash__
diff --git a/lib/pydantic/functional_validators.py b/lib/pydantic/functional_validators.py
new file mode 100644
index 00000000..b547755b
--- /dev/null
+++ b/lib/pydantic/functional_validators.py
@@ -0,0 +1,706 @@
+"""This module contains related classes and functions for validation."""
+
+from __future__ import annotations as _annotations
+
+import dataclasses
+import sys
+from functools import partialmethod
+from types import FunctionType
+from typing import TYPE_CHECKING, Any, Callable, TypeVar, Union, cast, overload
+
+from pydantic_core import core_schema
+from pydantic_core import core_schema as _core_schema
+from typing_extensions import Annotated, Literal, TypeAlias
+
+from . import GetCoreSchemaHandler as _GetCoreSchemaHandler
+from ._internal import _core_metadata, _decorators, _generics, _internal_dataclass
+from .annotated_handlers import GetCoreSchemaHandler
+from .errors import PydanticUserError
+
+if sys.version_info < (3, 11):
+    from typing_extensions import Protocol
+else:
+    from typing import Protocol
+
+_inspect_validator = _decorators.inspect_validator
+
+
+@dataclasses.dataclass(frozen=True, **_internal_dataclass.slots_true)
+class AfterValidator:
+    """Usage docs: https://docs.pydantic.dev/2.6/concepts/validators/#annotated-validators
+
+    A metadata class that indicates that a validation should be applied **after** the inner validation logic.
+
+    Attributes:
+        func: The validator function.
+
+    Example:
+        ```py
+        from typing_extensions import Annotated
+
+        from pydantic import AfterValidator, BaseModel, ValidationError
+
+        MyInt = Annotated[int, AfterValidator(lambda v: v + 1)]
+
+        class Model(BaseModel):
+            a: MyInt
+
+        print(Model(a=1).a)
+        #> 2
+
+        try:
+            Model(a='a')
+        except ValidationError as e:
+            print(e.json(indent=2))
+            '''
+            [
+              {
+                "type": "int_parsing",
+                "loc": [
+                  "a"
+                ],
+                "msg": "Input should be a valid integer, unable to parse string as an integer",
+                "input": "a",
+                "url": "https://errors.pydantic.dev/2/v/int_parsing"
+              }
+            ]
+            '''
+        ```
+    """
+
+    func: core_schema.NoInfoValidatorFunction | core_schema.WithInfoValidatorFunction
+
+    def __get_pydantic_core_schema__(self, source_type: Any, handler: _GetCoreSchemaHandler) -> core_schema.CoreSchema:
+        schema = handler(source_type)
+        info_arg = _inspect_validator(self.func, 'after')
+        if info_arg:
+            func = cast(core_schema.WithInfoValidatorFunction, self.func)
+            return core_schema.with_info_after_validator_function(func, schema=schema, field_name=handler.field_name)
+        else:
+            func = cast(core_schema.NoInfoValidatorFunction, self.func)
+            return core_schema.no_info_after_validator_function(func, schema=schema)
+
+
+@dataclasses.dataclass(frozen=True, **_internal_dataclass.slots_true)
+class BeforeValidator:
+    """Usage docs: https://docs.pydantic.dev/2.6/concepts/validators/#annotated-validators
+
+    A metadata class that indicates that a validation should be applied **before** the inner validation logic.
+
+    Attributes:
+        func: The validator function.
+
+    Example:
+        ```py
+        from typing_extensions import Annotated
+
+        from pydantic import BaseModel, BeforeValidator
+
+        MyInt = Annotated[int, BeforeValidator(lambda v: v + 1)]
+
+        class Model(BaseModel):
+            a: MyInt
+
+        print(Model(a=1).a)
+        #> 2
+
+        try:
+            Model(a='a')
+        except TypeError as e:
+            print(e)
+            #> can only concatenate str (not "int") to str
+        ```
+    """
+
+    func: core_schema.NoInfoValidatorFunction | core_schema.WithInfoValidatorFunction
+
+    def __get_pydantic_core_schema__(self, source_type: Any, handler: _GetCoreSchemaHandler) -> core_schema.CoreSchema:
+        schema = handler(source_type)
+        info_arg = _inspect_validator(self.func, 'before')
+        if info_arg:
+            func = cast(core_schema.WithInfoValidatorFunction, self.func)
+            return core_schema.with_info_before_validator_function(func, schema=schema, field_name=handler.field_name)
+        else:
+            func = cast(core_schema.NoInfoValidatorFunction, self.func)
+            return core_schema.no_info_before_validator_function(func, schema=schema)
+
+
+@dataclasses.dataclass(frozen=True, **_internal_dataclass.slots_true)
+class PlainValidator:
+    """Usage docs: https://docs.pydantic.dev/2.6/concepts/validators/#annotated-validators
+
+    A metadata class that indicates that a validation should be applied **instead** of the inner validation logic.
+
+    Attributes:
+        func: The validator function.
+
+    Example:
+        ```py
+        from typing_extensions import Annotated
+
+        from pydantic import BaseModel, PlainValidator
+
+        MyInt = Annotated[int, PlainValidator(lambda v: int(v) + 1)]
+
+        class Model(BaseModel):
+            a: MyInt
+
+        print(Model(a='1').a)
+        #> 2
+        ```
+    """
+
+    func: core_schema.NoInfoValidatorFunction | core_schema.WithInfoValidatorFunction
+
+    def __get_pydantic_core_schema__(self, source_type: Any, handler: _GetCoreSchemaHandler) -> core_schema.CoreSchema:
+        # Note that for some valid uses of PlainValidator, it is not possible to generate a core schema for the
+        # source_type, so calling `handler(source_type)` will error, which prevents us from generating a proper
+        # serialization schema. To work around this for use cases that will not involve serialization, we simply
+        # catch any PydanticSchemaGenerationError that may be raised while attempting to build the serialization schema
+        # and abort any attempts to handle special serialization.
+        from pydantic import PydanticSchemaGenerationError
+
+        try:
+            schema = handler(source_type)
+            serialization = core_schema.wrap_serializer_function_ser_schema(function=lambda v, h: h(v), schema=schema)
+        except PydanticSchemaGenerationError:
+            serialization = None
+
+        info_arg = _inspect_validator(self.func, 'plain')
+        if info_arg:
+            func = cast(core_schema.WithInfoValidatorFunction, self.func)
+            return core_schema.with_info_plain_validator_function(
+                func, field_name=handler.field_name, serialization=serialization
+            )
+        else:
+            func = cast(core_schema.NoInfoValidatorFunction, self.func)
+            return core_schema.no_info_plain_validator_function(func, serialization=serialization)
+
+
+@dataclasses.dataclass(frozen=True, **_internal_dataclass.slots_true)
+class WrapValidator:
+    """Usage docs: https://docs.pydantic.dev/2.6/concepts/validators/#annotated-validators
+
+    A metadata class that indicates that a validation should be applied **around** the inner validation logic.
+
+    Attributes:
+        func: The validator function.
+
+    ```py
+    from datetime import datetime
+
+    from typing_extensions import Annotated
+
+    from pydantic import BaseModel, ValidationError, WrapValidator
+
+    def validate_timestamp(v, handler):
+        if v == 'now':
+            # we don't want to bother with further validation, just return the new value
+            return datetime.now()
+        try:
+            return handler(v)
+        except ValidationError:
+            # validation failed, in this case we want to return a default value
+            return datetime(2000, 1, 1)
+
+    MyTimestamp = Annotated[datetime, WrapValidator(validate_timestamp)]
+
+    class Model(BaseModel):
+        a: MyTimestamp
+
+    print(Model(a='now').a)
+    #> 2032-01-02 03:04:05.000006
+    print(Model(a='invalid').a)
+    #> 2000-01-01 00:00:00
+    ```
+    """
+
+    func: core_schema.NoInfoWrapValidatorFunction | core_schema.WithInfoWrapValidatorFunction
+
+    def __get_pydantic_core_schema__(self, source_type: Any, handler: _GetCoreSchemaHandler) -> core_schema.CoreSchema:
+        schema = handler(source_type)
+        info_arg = _inspect_validator(self.func, 'wrap')
+        if info_arg:
+            func = cast(core_schema.WithInfoWrapValidatorFunction, self.func)
+            return core_schema.with_info_wrap_validator_function(func, schema=schema, field_name=handler.field_name)
+        else:
+            func = cast(core_schema.NoInfoWrapValidatorFunction, self.func)
+            return core_schema.no_info_wrap_validator_function(func, schema=schema)
+
+
+if TYPE_CHECKING:
+
+    class _OnlyValueValidatorClsMethod(Protocol):
+        def __call__(self, cls: Any, value: Any, /) -> Any:
+            ...
+
+    class _V2ValidatorClsMethod(Protocol):
+        def __call__(self, cls: Any, value: Any, info: _core_schema.ValidationInfo, /) -> Any:
+            ...
+
+    class _V2WrapValidatorClsMethod(Protocol):
+        def __call__(
+            self,
+            cls: Any,
+            value: Any,
+            handler: _core_schema.ValidatorFunctionWrapHandler,
+            info: _core_schema.ValidationInfo,
+            /,
+        ) -> Any:
+            ...
+
+    _V2Validator = Union[
+        _V2ValidatorClsMethod,
+        _core_schema.WithInfoValidatorFunction,
+        _OnlyValueValidatorClsMethod,
+        _core_schema.NoInfoValidatorFunction,
+    ]
+
+    _V2WrapValidator = Union[
+        _V2WrapValidatorClsMethod,
+        _core_schema.WithInfoWrapValidatorFunction,
+    ]
+
+    _PartialClsOrStaticMethod: TypeAlias = Union[classmethod[Any, Any, Any], staticmethod[Any, Any], partialmethod[Any]]
+
+    _V2BeforeAfterOrPlainValidatorType = TypeVar(
+        '_V2BeforeAfterOrPlainValidatorType',
+        _V2Validator,
+        _PartialClsOrStaticMethod,
+    )
+    _V2WrapValidatorType = TypeVar('_V2WrapValidatorType', _V2WrapValidator, _PartialClsOrStaticMethod)
+
+
+@overload
+def field_validator(
+    __field: str,
+    *fields: str,
+    mode: Literal['before', 'after', 'plain'] = ...,
+    check_fields: bool | None = ...,
+) -> Callable[[_V2BeforeAfterOrPlainValidatorType], _V2BeforeAfterOrPlainValidatorType]:
+    ...
+
+
+@overload
+def field_validator(
+    __field: str,
+    *fields: str,
+    mode: Literal['wrap'],
+    check_fields: bool | None = ...,
+) -> Callable[[_V2WrapValidatorType], _V2WrapValidatorType]:
+    ...
+
+
+FieldValidatorModes: TypeAlias = Literal['before', 'after', 'wrap', 'plain']
+
+
+def field_validator(
+    __field: str,
+    *fields: str,
+    mode: FieldValidatorModes = 'after',
+    check_fields: bool | None = None,
+) -> Callable[[Any], Any]:
+    """Usage docs: https://docs.pydantic.dev/2.6/concepts/validators/#field-validators
+
+    Decorate methods on the class indicating that they should be used to validate fields.
+
+    Example usage:
+    ```py
+    from typing import Any
+
+    from pydantic import (
+        BaseModel,
+        ValidationError,
+        field_validator,
+    )
+
+    class Model(BaseModel):
+        a: str
+
+        @field_validator('a')
+        @classmethod
+        def ensure_foobar(cls, v: Any):
+            if 'foobar' not in v:
+                raise ValueError('"foobar" not found in a')
+            return v
+
+    print(repr(Model(a='this is foobar good')))
+    #> Model(a='this is foobar good')
+
+    try:
+        Model(a='snap')
+    except ValidationError as exc_info:
+        print(exc_info)
+        '''
+        1 validation error for Model
+        a
+          Value error, "foobar" not found in a [type=value_error, input_value='snap', input_type=str]
+        '''
+    ```
+
+    For more in depth examples, see [Field Validators](../concepts/validators.md#field-validators).
+
+    Args:
+        __field: The first field the `field_validator` should be called on; this is separate
+            from `fields` to ensure an error is raised if you don't pass at least one.
+        *fields: Additional field(s) the `field_validator` should be called on.
+        mode: Specifies whether to validate the fields before or after validation.
+        check_fields: Whether to check that the fields actually exist on the model.
+
+    Returns:
+        A decorator that can be used to decorate a function to be used as a field_validator.
+
+    Raises:
+        PydanticUserError:
+            - If `@field_validator` is used bare (with no fields).
+            - If the args passed to `@field_validator` as fields are not strings.
+            - If `@field_validator` applied to instance methods.
+    """
+    if isinstance(__field, FunctionType):
+        raise PydanticUserError(
+            '`@field_validator` should be used with fields and keyword arguments, not bare. '
+            "E.g. usage should be `@validator('<field_name>', ...)`",
+            code='validator-no-fields',
+        )
+    fields = __field, *fields
+    if not all(isinstance(field, str) for field in fields):
+        raise PydanticUserError(
+            '`@field_validator` fields should be passed as separate string args. '
+            "E.g. usage should be `@validator('<field_name_1>', '<field_name_2>', ...)`",
+            code='validator-invalid-fields',
+        )
+
+    def dec(
+        f: Callable[..., Any] | staticmethod[Any, Any] | classmethod[Any, Any, Any],
+    ) -> _decorators.PydanticDescriptorProxy[Any]:
+        if _decorators.is_instance_method_from_sig(f):
+            raise PydanticUserError(
+                '`@field_validator` cannot be applied to instance methods', code='validator-instance-method'
+            )
+
+        # auto apply the @classmethod decorator
+        f = _decorators.ensure_classmethod_based_on_signature(f)
+
+        dec_info = _decorators.FieldValidatorDecoratorInfo(fields=fields, mode=mode, check_fields=check_fields)
+        return _decorators.PydanticDescriptorProxy(f, dec_info)
+
+    return dec
+
+
+_ModelType = TypeVar('_ModelType')
+_ModelTypeCo = TypeVar('_ModelTypeCo', covariant=True)
+
+
+class ModelWrapValidatorHandler(_core_schema.ValidatorFunctionWrapHandler, Protocol[_ModelTypeCo]):
+    """@model_validator decorated function handler argument type. This is used when `mode='wrap'`."""
+
+    def __call__(  # noqa: D102
+        self,
+        value: Any,
+        outer_location: str | int | None = None,
+        /,
+    ) -> _ModelTypeCo:  # pragma: no cover
+        ...
+
+
+class ModelWrapValidatorWithoutInfo(Protocol[_ModelType]):
+    """A @model_validator decorated function signature.
+    This is used when `mode='wrap'` and the function does not have info argument.
+    """
+
+    def __call__(  # noqa: D102
+        self,
+        cls: type[_ModelType],
+        # this can be a dict, a model instance
+        # or anything else that gets passed to validate_python
+        # thus validators _must_ handle all cases
+        value: Any,
+        handler: ModelWrapValidatorHandler[_ModelType],
+        /,
+    ) -> _ModelType:
+        ...
+
+
+class ModelWrapValidator(Protocol[_ModelType]):
+    """A @model_validator decorated function signature. This is used when `mode='wrap'`."""
+
+    def __call__(  # noqa: D102
+        self,
+        cls: type[_ModelType],
+        # this can be a dict, a model instance
+        # or anything else that gets passed to validate_python
+        # thus validators _must_ handle all cases
+        value: Any,
+        handler: ModelWrapValidatorHandler[_ModelType],
+        info: _core_schema.ValidationInfo,
+        /,
+    ) -> _ModelType:
+        ...
+
+
+class FreeModelBeforeValidatorWithoutInfo(Protocol):
+    """A @model_validator decorated function signature.
+    This is used when `mode='before'` and the function does not have info argument.
+    """
+
+    def __call__(  # noqa: D102
+        self,
+        # this can be a dict, a model instance
+        # or anything else that gets passed to validate_python
+        # thus validators _must_ handle all cases
+        value: Any,
+        /,
+    ) -> Any:
+        ...
+
+
+class ModelBeforeValidatorWithoutInfo(Protocol):
+    """A @model_validator decorated function signature.
+    This is used when `mode='before'` and the function does not have info argument.
+    """
+
+    def __call__(  # noqa: D102
+        self,
+        cls: Any,
+        # this can be a dict, a model instance
+        # or anything else that gets passed to validate_python
+        # thus validators _must_ handle all cases
+        value: Any,
+        /,
+    ) -> Any:
+        ...
+
+
+class FreeModelBeforeValidator(Protocol):
+    """A `@model_validator` decorated function signature. This is used when `mode='before'`."""
+
+    def __call__(  # noqa: D102
+        self,
+        # this can be a dict, a model instance
+        # or anything else that gets passed to validate_python
+        # thus validators _must_ handle all cases
+        value: Any,
+        info: _core_schema.ValidationInfo,
+        /,
+    ) -> Any:
+        ...
+
+
+class ModelBeforeValidator(Protocol):
+    """A `@model_validator` decorated function signature. This is used when `mode='before'`."""
+
+    def __call__(  # noqa: D102
+        self,
+        cls: Any,
+        # this can be a dict, a model instance
+        # or anything else that gets passed to validate_python
+        # thus validators _must_ handle all cases
+        value: Any,
+        info: _core_schema.ValidationInfo,
+        /,
+    ) -> Any:
+        ...
+
+
+ModelAfterValidatorWithoutInfo = Callable[[_ModelType], _ModelType]
+"""A `@model_validator` decorated function signature. This is used when `mode='after'` and the function does not
+have info argument.
+"""
+
+ModelAfterValidator = Callable[[_ModelType, _core_schema.ValidationInfo], _ModelType]
+"""A `@model_validator` decorated function signature. This is used when `mode='after'`."""
+
+_AnyModelWrapValidator = Union[ModelWrapValidator[_ModelType], ModelWrapValidatorWithoutInfo[_ModelType]]
+_AnyModeBeforeValidator = Union[
+    FreeModelBeforeValidator, ModelBeforeValidator, FreeModelBeforeValidatorWithoutInfo, ModelBeforeValidatorWithoutInfo
+]
+_AnyModelAfterValidator = Union[ModelAfterValidator[_ModelType], ModelAfterValidatorWithoutInfo[_ModelType]]
+
+
+@overload
+def model_validator(
+    *,
+    mode: Literal['wrap'],
+) -> Callable[
+    [_AnyModelWrapValidator[_ModelType]], _decorators.PydanticDescriptorProxy[_decorators.ModelValidatorDecoratorInfo]
+]:
+    ...
+
+
+@overload
+def model_validator(
+    *,
+    mode: Literal['before'],
+) -> Callable[[_AnyModeBeforeValidator], _decorators.PydanticDescriptorProxy[_decorators.ModelValidatorDecoratorInfo]]:
+    ...
+
+
+@overload
+def model_validator(
+    *,
+    mode: Literal['after'],
+) -> Callable[
+    [_AnyModelAfterValidator[_ModelType]], _decorators.PydanticDescriptorProxy[_decorators.ModelValidatorDecoratorInfo]
+]:
+    ...
+
+
+def model_validator(
+    *,
+    mode: Literal['wrap', 'before', 'after'],
+) -> Any:
+    """Usage docs: https://docs.pydantic.dev/2.6/concepts/validators/#model-validators
+
+    Decorate model methods for validation purposes.
+
+    Example usage:
+    ```py
+    from typing_extensions import Self
+
+    from pydantic import BaseModel, ValidationError, model_validator
+
+    class Square(BaseModel):
+        width: float
+        height: float
+
+        @model_validator(mode='after')
+        def verify_square(self) -> Self:
+            if self.width != self.height:
+                raise ValueError('width and height do not match')
+            return self
+
+    s = Square(width=1, height=1)
+    print(repr(s))
+    #> Square(width=1.0, height=1.0)
+
+    try:
+        Square(width=1, height=2)
+    except ValidationError as e:
+        print(e)
+        '''
+        1 validation error for Square
+          Value error, width and height do not match [type=value_error, input_value={'width': 1, 'height': 2}, input_type=dict]
+        '''
+    ```
+
+    For more in depth examples, see [Model Validators](../concepts/validators.md#model-validators).
+
+    Args:
+        mode: A required string literal that specifies the validation mode.
+            It can be one of the following: 'wrap', 'before', or 'after'.
+
+    Returns:
+        A decorator that can be used to decorate a function to be used as a model validator.
+    """
+
+    def dec(f: Any) -> _decorators.PydanticDescriptorProxy[Any]:
+        # auto apply the @classmethod decorator
+        f = _decorators.ensure_classmethod_based_on_signature(f)
+        dec_info = _decorators.ModelValidatorDecoratorInfo(mode=mode)
+        return _decorators.PydanticDescriptorProxy(f, dec_info)
+
+    return dec
+
+
+AnyType = TypeVar('AnyType')
+
+
+if TYPE_CHECKING:
+    # If we add configurable attributes to IsInstance, we'd probably need to stop hiding it from type checkers like this
+    InstanceOf = Annotated[AnyType, ...]  # `IsInstance[Sequence]` will be recognized by type checkers as `Sequence`
+
+else:
+
+    @dataclasses.dataclass(**_internal_dataclass.slots_true)
+    class InstanceOf:
+        '''Generic type for annotating a type that is an instance of a given class.
+
+        Example:
+            ```py
+            from pydantic import BaseModel, InstanceOf
+
+            class Foo:
+                ...
+
+            class Bar(BaseModel):
+                foo: InstanceOf[Foo]
+
+            Bar(foo=Foo())
+            try:
+                Bar(foo=42)
+            except ValidationError as e:
+                print(e)
+                """
+                [
+                │   {
+                │   │   'type': 'is_instance_of',
+                │   │   'loc': ('foo',),
+                │   │   'msg': 'Input should be an instance of Foo',
+                │   │   'input': 42,
+                │   │   'ctx': {'class': 'Foo'},
+                │   │   'url': 'https://errors.pydantic.dev/0.38.0/v/is_instance_of'
+                │   }
+                ]
+                """
+            ```
+        '''
+
+        @classmethod
+        def __class_getitem__(cls, item: AnyType) -> AnyType:
+            return Annotated[item, cls()]
+
+        @classmethod
+        def __get_pydantic_core_schema__(cls, source: Any, handler: GetCoreSchemaHandler) -> core_schema.CoreSchema:
+            from pydantic import PydanticSchemaGenerationError
+
+            # use the generic _origin_ as the second argument to isinstance when appropriate
+            instance_of_schema = core_schema.is_instance_schema(_generics.get_origin(source) or source)
+
+            try:
+                # Try to generate the "standard" schema, which will be used when loading from JSON
+                original_schema = handler(source)
+            except PydanticSchemaGenerationError:
+                # If that fails, just produce a schema that can validate from python
+                return instance_of_schema
+            else:
+                # Use the "original" approach to serialization
+                instance_of_schema['serialization'] = core_schema.wrap_serializer_function_ser_schema(
+                    function=lambda v, h: h(v), schema=original_schema
+                )
+                return core_schema.json_or_python_schema(python_schema=instance_of_schema, json_schema=original_schema)
+
+        __hash__ = object.__hash__
+
+
+if TYPE_CHECKING:
+    SkipValidation = Annotated[AnyType, ...]  # SkipValidation[list[str]] will be treated by type checkers as list[str]
+else:
+
+    @dataclasses.dataclass(**_internal_dataclass.slots_true)
+    class SkipValidation:
+        """If this is applied as an annotation (e.g., via `x: Annotated[int, SkipValidation]`), validation will be
+            skipped. You can also use `SkipValidation[int]` as a shorthand for `Annotated[int, SkipValidation]`.
+
+        This can be useful if you want to use a type annotation for documentation/IDE/type-checking purposes,
+        and know that it is safe to skip validation for one or more of the fields.
+
+        Because this converts the validation schema to `any_schema`, subsequent annotation-applied transformations
+        may not have the expected effects. Therefore, when used, this annotation should generally be the final
+        annotation applied to a type.
+        """
+
+        def __class_getitem__(cls, item: Any) -> Any:
+            return Annotated[item, SkipValidation()]
+
+        @classmethod
+        def __get_pydantic_core_schema__(cls, source: Any, handler: GetCoreSchemaHandler) -> core_schema.CoreSchema:
+            original_schema = handler(source)
+            metadata = _core_metadata.build_metadata_dict(js_annotation_functions=[lambda _c, h: h(original_schema)])
+            return core_schema.any_schema(
+                metadata=metadata,
+                serialization=core_schema.wrap_serializer_function_ser_schema(
+                    function=lambda v, h: h(v), schema=original_schema
+                ),
+            )
+
+        __hash__ = object.__hash__
diff --git a/lib/pydantic/generics.py b/lib/pydantic/generics.py
index a3f52bfe..5f6f7f7a 100644
--- a/lib/pydantic/generics.py
+++ b/lib/pydantic/generics.py
@@ -1,364 +1,4 @@
-import sys
-import typing
-from typing import (
-    TYPE_CHECKING,
-    Any,
-    ClassVar,
-    Dict,
-    Generic,
-    Iterator,
-    List,
-    Mapping,
-    Optional,
-    Tuple,
-    Type,
-    TypeVar,
-    Union,
-    cast,
-)
+"""The `generics` module is a backport module from V1."""
+from ._migration import getattr_migration
 
-from typing_extensions import Annotated
-
-from .class_validators import gather_all_validators
-from .fields import DeferredType
-from .main import BaseModel, create_model
-from .types import JsonWrapper
-from .typing import display_as_type, get_all_type_hints, get_args, get_origin, typing_base
-from .utils import LimitedDict, all_identical, lenient_issubclass
-
-GenericModelT = TypeVar('GenericModelT', bound='GenericModel')
-TypeVarType = Any  # since mypy doesn't allow the use of TypeVar as a type
-
-Parametrization = Mapping[TypeVarType, Type[Any]]
-
-_generic_types_cache: LimitedDict[Tuple[Type[Any], Union[Any, Tuple[Any, ...]]], Type[BaseModel]] = LimitedDict()
-# _assigned_parameters is a Mapping from parametrized version of generic models to assigned types of parametrizations
-# as captured during construction of the class (not instances).
-# E.g., for generic model `Model[A, B]`, when parametrized model `Model[int, str]` is created,
-# `Model[int, str]`: {A: int, B: str}` will be stored in `_assigned_parameters`.
-# (This information is only otherwise available after creation from the class name string).
-_assigned_parameters: LimitedDict[Type[Any], Parametrization] = LimitedDict()
-
-
-class GenericModel(BaseModel):
-    __slots__ = ()
-    __concrete__: ClassVar[bool] = False
-
-    if TYPE_CHECKING:
-        # Putting this in a TYPE_CHECKING block allows us to replace `if Generic not in cls.__bases__` with
-        # `not hasattr(cls, "__parameters__")`. This means we don't need to force non-concrete subclasses of
-        # `GenericModel` to also inherit from `Generic`, which would require changes to the use of `create_model` below.
-        __parameters__: ClassVar[Tuple[TypeVarType, ...]]
-
-    # Setting the return type as Type[Any] instead of Type[BaseModel] prevents PyCharm warnings
-    def __class_getitem__(cls: Type[GenericModelT], params: Union[Type[Any], Tuple[Type[Any], ...]]) -> Type[Any]:
-        """Instantiates a new class from a generic class `cls` and type variables `params`.
-
-        :param params: Tuple of types the class . Given a generic class
-            `Model` with 2 type variables and a concrete model `Model[str, int]`,
-            the value `(str, int)` would be passed to `params`.
-        :return: New model class inheriting from `cls` with instantiated
-            types described by `params`. If no parameters are given, `cls` is
-            returned as is.
-
-        """
-
-        def _cache_key(_params: Any) -> Tuple[Type[GenericModelT], Any, Tuple[Any, ...]]:
-            return cls, _params, get_args(_params)
-
-        cached = _generic_types_cache.get(_cache_key(params))
-        if cached is not None:
-            return cached
-        if cls.__concrete__ and Generic not in cls.__bases__:
-            raise TypeError('Cannot parameterize a concrete instantiation of a generic model')
-        if not isinstance(params, tuple):
-            params = (params,)
-        if cls is GenericModel and any(isinstance(param, TypeVar) for param in params):
-            raise TypeError('Type parameters should be placed on typing.Generic, not GenericModel')
-        if not hasattr(cls, '__parameters__'):
-            raise TypeError(f'Type {cls.__name__} must inherit from typing.Generic before being parameterized')
-
-        check_parameters_count(cls, params)
-        # Build map from generic typevars to passed params
-        typevars_map: Dict[TypeVarType, Type[Any]] = dict(zip(cls.__parameters__, params))
-        if all_identical(typevars_map.keys(), typevars_map.values()) and typevars_map:
-            return cls  # if arguments are equal to parameters it's the same object
-
-        # Create new model with original model as parent inserting fields with DeferredType.
-        model_name = cls.__concrete_name__(params)
-        validators = gather_all_validators(cls)
-
-        type_hints = get_all_type_hints(cls).items()
-        instance_type_hints = {k: v for k, v in type_hints if get_origin(v) is not ClassVar}
-
-        fields = {k: (DeferredType(), cls.__fields__[k].field_info) for k in instance_type_hints if k in cls.__fields__}
-
-        model_module, called_globally = get_caller_frame_info()
-        created_model = cast(
-            Type[GenericModel],  # casting ensures mypy is aware of the __concrete__ and __parameters__ attributes
-            create_model(
-                model_name,
-                __module__=model_module or cls.__module__,
-                __base__=(cls,) + tuple(cls.__parameterized_bases__(typevars_map)),
-                __config__=None,
-                __validators__=validators,
-                __cls_kwargs__=None,
-                **fields,
-            ),
-        )
-
-        _assigned_parameters[created_model] = typevars_map
-
-        if called_globally:  # create global reference and therefore allow pickling
-            object_by_reference = None
-            reference_name = model_name
-            reference_module_globals = sys.modules[created_model.__module__].__dict__
-            while object_by_reference is not created_model:
-                object_by_reference = reference_module_globals.setdefault(reference_name, created_model)
-                reference_name += '_'
-
-        created_model.Config = cls.Config
-
-        # Find any typevars that are still present in the model.
-        # If none are left, the model is fully "concrete", otherwise the new
-        # class is a generic class as well taking the found typevars as
-        # parameters.
-        new_params = tuple(
-            {param: None for param in iter_contained_typevars(typevars_map.values())}
-        )  # use dict as ordered set
-        created_model.__concrete__ = not new_params
-        if new_params:
-            created_model.__parameters__ = new_params
-
-        # Save created model in cache so we don't end up creating duplicate
-        # models that should be identical.
-        _generic_types_cache[_cache_key(params)] = created_model
-        if len(params) == 1:
-            _generic_types_cache[_cache_key(params[0])] = created_model
-
-        # Recursively walk class type hints and replace generic typevars
-        # with concrete types that were passed.
-        _prepare_model_fields(created_model, fields, instance_type_hints, typevars_map)
-
-        return created_model
-
-    @classmethod
-    def __concrete_name__(cls: Type[Any], params: Tuple[Type[Any], ...]) -> str:
-        """Compute class name for child classes.
-
-        :param params: Tuple of types the class . Given a generic class
-            `Model` with 2 type variables and a concrete model `Model[str, int]`,
-            the value `(str, int)` would be passed to `params`.
-        :return: String representing a the new class where `params` are
-            passed to `cls` as type variables.
-
-        This method can be overridden to achieve a custom naming scheme for GenericModels.
-        """
-        param_names = [display_as_type(param) for param in params]
-        params_component = ', '.join(param_names)
-        return f'{cls.__name__}[{params_component}]'
-
-    @classmethod
-    def __parameterized_bases__(cls, typevars_map: Parametrization) -> Iterator[Type[Any]]:
-        """
-        Returns unbound bases of cls parameterised to given type variables
-
-        :param typevars_map: Dictionary of type applications for binding subclasses.
-            Given a generic class `Model` with 2 type variables [S, T]
-            and a concrete model `Model[str, int]`,
-            the value `{S: str, T: int}` would be passed to `typevars_map`.
-        :return: an iterator of generic sub classes, parameterised by `typevars_map`
-            and other assigned parameters of `cls`
-
-        e.g.:
-        ```
-        class A(GenericModel, Generic[T]):
-            ...
-
-        class B(A[V], Generic[V]):
-            ...
-
-        assert A[int] in B.__parameterized_bases__({V: int})
-        ```
-        """
-
-        def build_base_model(
-            base_model: Type[GenericModel], mapped_types: Parametrization
-        ) -> Iterator[Type[GenericModel]]:
-            base_parameters = tuple(mapped_types[param] for param in base_model.__parameters__)
-            parameterized_base = base_model.__class_getitem__(base_parameters)
-            if parameterized_base is base_model or parameterized_base is cls:
-                # Avoid duplication in MRO
-                return
-            yield parameterized_base
-
-        for base_model in cls.__bases__:
-            if not issubclass(base_model, GenericModel):
-                # not a class that can be meaningfully parameterized
-                continue
-            elif not getattr(base_model, '__parameters__', None):
-                # base_model is "GenericModel"  (and has no __parameters__)
-                # or
-                # base_model is already concrete, and will be included transitively via cls.
-                continue
-            elif cls in _assigned_parameters:
-                if base_model in _assigned_parameters:
-                    # cls is partially parameterised but not from base_model
-                    # e.g. cls = B[S], base_model = A[S]
-                    # B[S][int] should subclass A[int],  (and will be transitively via B[int])
-                    # but it's not viable to consistently subclass types with arbitrary construction
-                    # So don't attempt to include A[S][int]
-                    continue
-                else:  # base_model not in _assigned_parameters:
-                    # cls is partially parameterized, base_model is original generic
-                    # e.g.  cls = B[str, T], base_model = B[S, T]
-                    # Need to determine the mapping for the base_model parameters
-                    mapped_types: Parametrization = {
-                        key: typevars_map.get(value, value) for key, value in _assigned_parameters[cls].items()
-                    }
-                    yield from build_base_model(base_model, mapped_types)
-            else:
-                # cls is base generic, so base_class has a distinct base
-                # can construct the Parameterised base model using typevars_map directly
-                yield from build_base_model(base_model, typevars_map)
-
-
-def replace_types(type_: Any, type_map: Mapping[Any, Any]) -> Any:
-    """Return type with all occurrences of `type_map` keys recursively replaced with their values.
-
-    :param type_: Any type, class or generic alias
-    :param type_map: Mapping from `TypeVar` instance to concrete types.
-    :return: New type representing the basic structure of `type_` with all
-        `typevar_map` keys recursively replaced.
-
-    >>> replace_types(Tuple[str, Union[List[str], float]], {str: int})
-    Tuple[int, Union[List[int], float]]
-
-    """
-    if not type_map:
-        return type_
-
-    type_args = get_args(type_)
-    origin_type = get_origin(type_)
-
-    if origin_type is Annotated:
-        annotated_type, *annotations = type_args
-        return Annotated[replace_types(annotated_type, type_map), tuple(annotations)]
-
-    # Having type args is a good indicator that this is a typing module
-    # class instantiation or a generic alias of some sort.
-    if type_args:
-        resolved_type_args = tuple(replace_types(arg, type_map) for arg in type_args)
-        if all_identical(type_args, resolved_type_args):
-            # If all arguments are the same, there is no need to modify the
-            # type or create a new object at all
-            return type_
-        if (
-            origin_type is not None
-            and isinstance(type_, typing_base)
-            and not isinstance(origin_type, typing_base)
-            and getattr(type_, '_name', None) is not None
-        ):
-            # In python < 3.9 generic aliases don't exist so any of these like `list`,
-            # `type` or `collections.abc.Callable` need to be translated.
-            # See: https://www.python.org/dev/peps/pep-0585
-            origin_type = getattr(typing, type_._name)
-        assert origin_type is not None
-        return origin_type[resolved_type_args]
-
-    # We handle pydantic generic models separately as they don't have the same
-    # semantics as "typing" classes or generic aliases
-    if not origin_type and lenient_issubclass(type_, GenericModel) and not type_.__concrete__:
-        type_args = type_.__parameters__
-        resolved_type_args = tuple(replace_types(t, type_map) for t in type_args)
-        if all_identical(type_args, resolved_type_args):
-            return type_
-        return type_[resolved_type_args]
-
-    # Handle special case for typehints that can have lists as arguments.
-    # `typing.Callable[[int, str], int]` is an example for this.
-    if isinstance(type_, (List, list)):
-        resolved_list = list(replace_types(element, type_map) for element in type_)
-        if all_identical(type_, resolved_list):
-            return type_
-        return resolved_list
-
-    # For JsonWrapperValue, need to handle its inner type to allow correct parsing
-    # of generic Json arguments like Json[T]
-    if not origin_type and lenient_issubclass(type_, JsonWrapper):
-        type_.inner_type = replace_types(type_.inner_type, type_map)
-        return type_
-
-    # If all else fails, we try to resolve the type directly and otherwise just
-    # return the input with no modifications.
-    return type_map.get(type_, type_)
-
-
-def check_parameters_count(cls: Type[GenericModel], parameters: Tuple[Any, ...]) -> None:
-    actual = len(parameters)
-    expected = len(cls.__parameters__)
-    if actual != expected:
-        description = 'many' if actual > expected else 'few'
-        raise TypeError(f'Too {description} parameters for {cls.__name__}; actual {actual}, expected {expected}')
-
-
-DictValues: Type[Any] = {}.values().__class__
-
-
-def iter_contained_typevars(v: Any) -> Iterator[TypeVarType]:
-    """Recursively iterate through all subtypes and type args of `v` and yield any typevars that are found."""
-    if isinstance(v, TypeVar):
-        yield v
-    elif hasattr(v, '__parameters__') and not get_origin(v) and lenient_issubclass(v, GenericModel):
-        yield from v.__parameters__
-    elif isinstance(v, (DictValues, list)):
-        for var in v:
-            yield from iter_contained_typevars(var)
-    else:
-        args = get_args(v)
-        for arg in args:
-            yield from iter_contained_typevars(arg)
-
-
-def get_caller_frame_info() -> Tuple[Optional[str], bool]:
-    """
-    Used inside a function to check whether it was called globally
-
-    Will only work against non-compiled code, therefore used only in pydantic.generics
-
-    :returns Tuple[module_name, called_globally]
-    """
-    try:
-        previous_caller_frame = sys._getframe(2)
-    except ValueError as e:
-        raise RuntimeError('This function must be used inside another function') from e
-    except AttributeError:  # sys module does not have _getframe function, so there's nothing we can do about it
-        return None, False
-    frame_globals = previous_caller_frame.f_globals
-    return frame_globals.get('__name__'), previous_caller_frame.f_locals is frame_globals
-
-
-def _prepare_model_fields(
-    created_model: Type[GenericModel],
-    fields: Mapping[str, Any],
-    instance_type_hints: Mapping[str, type],
-    typevars_map: Mapping[Any, type],
-) -> None:
-    """
-    Replace DeferredType fields with concrete type hints and prepare them.
-    """
-
-    for key, field in created_model.__fields__.items():
-        if key not in fields:
-            assert field.type_.__class__ is not DeferredType
-            # https://github.com/nedbat/coveragepy/issues/198
-            continue  # pragma: no cover
-
-        assert field.type_.__class__ is DeferredType, field.type_.__class__
-
-        field_type_hint = instance_type_hints[key]
-        concrete_type = replace_types(field_type_hint, typevars_map)
-        field.type_ = concrete_type
-        field.outer_type_ = concrete_type
-        field.prepare()
-        created_model.__annotations__[key] = concrete_type
+__getattr__ = getattr_migration(__name__)
diff --git a/lib/pydantic/json.py b/lib/pydantic/json.py
index b358b850..020fb6d2 100644
--- a/lib/pydantic/json.py
+++ b/lib/pydantic/json.py
@@ -1,112 +1,4 @@
-import datetime
-from collections import deque
-from decimal import Decimal
-from enum import Enum
-from ipaddress import IPv4Address, IPv4Interface, IPv4Network, IPv6Address, IPv6Interface, IPv6Network
-from pathlib import Path
-from re import Pattern
-from types import GeneratorType
-from typing import Any, Callable, Dict, Type, Union
-from uuid import UUID
+"""The `json` module is a backport module from V1."""
+from ._migration import getattr_migration
 
-from .color import Color
-from .networks import NameEmail
-from .types import SecretBytes, SecretStr
-
-__all__ = 'pydantic_encoder', 'custom_pydantic_encoder', 'timedelta_isoformat'
-
-
-def isoformat(o: Union[datetime.date, datetime.time]) -> str:
-    return o.isoformat()
-
-
-def decimal_encoder(dec_value: Decimal) -> Union[int, float]:
-    """
-    Encodes a Decimal as int of there's no exponent, otherwise float
-
-    This is useful when we use ConstrainedDecimal to represent Numeric(x,0)
-    where a integer (but not int typed) is used. Encoding this as a float
-    results in failed round-tripping between encode and parse.
-    Our Id type is a prime example of this.
-
-    >>> decimal_encoder(Decimal("1.0"))
-    1.0
-
-    >>> decimal_encoder(Decimal("1"))
-    1
-    """
-    if dec_value.as_tuple().exponent >= 0:
-        return int(dec_value)
-    else:
-        return float(dec_value)
-
-
-ENCODERS_BY_TYPE: Dict[Type[Any], Callable[[Any], Any]] = {
-    bytes: lambda o: o.decode(),
-    Color: str,
-    datetime.date: isoformat,
-    datetime.datetime: isoformat,
-    datetime.time: isoformat,
-    datetime.timedelta: lambda td: td.total_seconds(),
-    Decimal: decimal_encoder,
-    Enum: lambda o: o.value,
-    frozenset: list,
-    deque: list,
-    GeneratorType: list,
-    IPv4Address: str,
-    IPv4Interface: str,
-    IPv4Network: str,
-    IPv6Address: str,
-    IPv6Interface: str,
-    IPv6Network: str,
-    NameEmail: str,
-    Path: str,
-    Pattern: lambda o: o.pattern,
-    SecretBytes: str,
-    SecretStr: str,
-    set: list,
-    UUID: str,
-}
-
-
-def pydantic_encoder(obj: Any) -> Any:
-    from dataclasses import asdict, is_dataclass
-
-    from .main import BaseModel
-
-    if isinstance(obj, BaseModel):
-        return obj.dict()
-    elif is_dataclass(obj):
-        return asdict(obj)
-
-    # Check the class type and its superclasses for a matching encoder
-    for base in obj.__class__.__mro__[:-1]:
-        try:
-            encoder = ENCODERS_BY_TYPE[base]
-        except KeyError:
-            continue
-        return encoder(obj)
-    else:  # We have exited the for loop without finding a suitable encoder
-        raise TypeError(f"Object of type '{obj.__class__.__name__}' is not JSON serializable")
-
-
-def custom_pydantic_encoder(type_encoders: Dict[Any, Callable[[Type[Any]], Any]], obj: Any) -> Any:
-    # Check the class type and its superclasses for a matching encoder
-    for base in obj.__class__.__mro__[:-1]:
-        try:
-            encoder = type_encoders[base]
-        except KeyError:
-            continue
-
-        return encoder(obj)
-    else:  # We have exited the for loop without finding a suitable encoder
-        return pydantic_encoder(obj)
-
-
-def timedelta_isoformat(td: datetime.timedelta) -> str:
-    """
-    ISO 8601 encoding for Python timedelta object.
-    """
-    minutes, seconds = divmod(td.seconds, 60)
-    hours, minutes = divmod(minutes, 60)
-    return f'{"-" if td.days < 0 else ""}P{abs(td.days)}DT{hours:d}H{minutes:d}M{seconds:d}.{td.microseconds:06d}S'
+__getattr__ = getattr_migration(__name__)
diff --git a/lib/pydantic/json_schema.py b/lib/pydantic/json_schema.py
new file mode 100644
index 00000000..eee9e60e
--- /dev/null
+++ b/lib/pydantic/json_schema.py
@@ -0,0 +1,2425 @@
+"""
+Usage docs: https://docs.pydantic.dev/2.5/concepts/json_schema/
+
+The `json_schema` module contains classes and functions to allow the way [JSON Schema](https://json-schema.org/)
+is generated to be customized.
+
+In general you shouldn't need to use this module directly; instead, you can
+[`BaseModel.model_json_schema`][pydantic.BaseModel.model_json_schema] and
+[`TypeAdapter.json_schema`][pydantic.TypeAdapter.json_schema].
+"""
+from __future__ import annotations as _annotations
+
+import dataclasses
+import inspect
+import math
+import re
+import warnings
+from collections import defaultdict
+from copy import deepcopy
+from dataclasses import is_dataclass
+from enum import Enum
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    Counter,
+    Dict,
+    Hashable,
+    Iterable,
+    NewType,
+    Sequence,
+    Tuple,
+    TypeVar,
+    Union,
+    cast,
+)
+
+import pydantic_core
+from pydantic_core import CoreSchema, PydanticOmit, core_schema, to_jsonable_python
+from pydantic_core.core_schema import ComputedField
+from typing_extensions import Annotated, Literal, TypeAlias, assert_never, deprecated, final
+
+from pydantic.warnings import PydanticDeprecatedSince26
+
+from ._internal import (
+    _config,
+    _core_metadata,
+    _core_utils,
+    _decorators,
+    _internal_dataclass,
+    _mock_val_ser,
+    _schema_generation_shared,
+    _typing_extra,
+)
+from .annotated_handlers import GetJsonSchemaHandler
+from .config import JsonDict, JsonSchemaExtraCallable, JsonValue
+from .errors import PydanticInvalidForJsonSchema, PydanticUserError
+
+if TYPE_CHECKING:
+    from . import ConfigDict
+    from ._internal._core_utils import CoreSchemaField, CoreSchemaOrField
+    from ._internal._dataclasses import PydanticDataclass
+    from ._internal._schema_generation_shared import GetJsonSchemaFunction
+    from .main import BaseModel
+
+
+CoreSchemaOrFieldType = Literal[core_schema.CoreSchemaType, core_schema.CoreSchemaFieldType]
+"""
+A type alias for defined schema types that represents a union of
+`core_schema.CoreSchemaType` and
+`core_schema.CoreSchemaFieldType`.
+"""
+
+JsonSchemaValue = Dict[str, Any]
+"""
+A type alias for a JSON schema value. This is a dictionary of string keys to arbitrary JSON values.
+"""
+
+JsonSchemaMode = Literal['validation', 'serialization']
+"""
+A type alias that represents the mode of a JSON schema; either 'validation' or 'serialization'.
+
+For some types, the inputs to validation differ from the outputs of serialization. For example,
+computed fields will only be present when serializing, and should not be provided when
+validating. This flag provides a way to indicate whether you want the JSON schema required
+for validation inputs, or that will be matched by serialization outputs.
+"""
+
+_MODE_TITLE_MAPPING: dict[JsonSchemaMode, str] = {'validation': 'Input', 'serialization': 'Output'}
+
+
+def update_json_schema(schema: JsonSchemaValue, updates: dict[str, Any]) -> JsonSchemaValue:
+    """Update a JSON schema in-place by providing a dictionary of updates.
+
+    This function sets the provided key-value pairs in the schema and returns the updated schema.
+
+    Args:
+        schema: The JSON schema to update.
+        updates: A dictionary of key-value pairs to set in the schema.
+
+    Returns:
+        The updated JSON schema.
+    """
+    schema.update(updates)
+    return schema
+
+
+JsonSchemaWarningKind = Literal['skipped-choice', 'non-serializable-default']
+"""
+A type alias representing the kinds of warnings that can be emitted during JSON schema generation.
+
+See [`GenerateJsonSchema.render_warning_message`][pydantic.json_schema.GenerateJsonSchema.render_warning_message]
+for more details.
+"""
+
+
+class PydanticJsonSchemaWarning(UserWarning):
+    """This class is used to emit warnings produced during JSON schema generation.
+    See the [`GenerateJsonSchema.emit_warning`][pydantic.json_schema.GenerateJsonSchema.emit_warning] and
+    [`GenerateJsonSchema.render_warning_message`][pydantic.json_schema.GenerateJsonSchema.render_warning_message]
+    methods for more details; these can be overridden to control warning behavior.
+    """
+
+
+# ##### JSON Schema Generation #####
+DEFAULT_REF_TEMPLATE = '#/$defs/{model}'
+"""The default format string used to generate reference names."""
+
+# There are three types of references relevant to building JSON schemas:
+#   1. core_schema "ref" values; these are not exposed as part of the JSON schema
+#       * these might look like the fully qualified path of a model, its id, or something similar
+CoreRef = NewType('CoreRef', str)
+#   2. keys of the "definitions" object that will eventually go into the JSON schema
+#       * by default, these look like "MyModel", though may change in the presence of collisions
+#       * eventually, we may want to make it easier to modify the way these names are generated
+DefsRef = NewType('DefsRef', str)
+#   3. the values corresponding to the "$ref" key in the schema
+#       * By default, these look like "#/$defs/MyModel", as in {"$ref": "#/$defs/MyModel"}
+JsonRef = NewType('JsonRef', str)
+
+CoreModeRef = Tuple[CoreRef, JsonSchemaMode]
+JsonSchemaKeyT = TypeVar('JsonSchemaKeyT', bound=Hashable)
+
+
+@dataclasses.dataclass(**_internal_dataclass.slots_true)
+class _DefinitionsRemapping:
+    defs_remapping: dict[DefsRef, DefsRef]
+    json_remapping: dict[JsonRef, JsonRef]
+
+    @staticmethod
+    def from_prioritized_choices(
+        prioritized_choices: dict[DefsRef, list[DefsRef]],
+        defs_to_json: dict[DefsRef, JsonRef],
+        definitions: dict[DefsRef, JsonSchemaValue],
+    ) -> _DefinitionsRemapping:
+        """
+        This function should produce a remapping that replaces complex DefsRef with the simpler ones from the
+        prioritized_choices such that applying the name remapping would result in an equivalent JSON schema.
+        """
+        # We need to iteratively simplify the definitions until we reach a fixed point.
+        # The reason for this is that outer definitions may reference inner definitions that get simplified
+        # into an equivalent reference, and the outer definitions won't be equivalent until we've simplified
+        # the inner definitions.
+        copied_definitions = deepcopy(definitions)
+        definitions_schema = {'$defs': copied_definitions}
+        for _iter in range(100):  # prevent an infinite loop in the case of a bug, 100 iterations should be enough
+            # For every possible remapped DefsRef, collect all schemas that that DefsRef might be used for:
+            schemas_for_alternatives: dict[DefsRef, list[JsonSchemaValue]] = defaultdict(list)
+            for defs_ref in copied_definitions:
+                alternatives = prioritized_choices[defs_ref]
+                for alternative in alternatives:
+                    schemas_for_alternatives[alternative].append(copied_definitions[defs_ref])
+
+            # Deduplicate the schemas for each alternative; the idea is that we only want to remap to a new DefsRef
+            # if it introduces no ambiguity, i.e., there is only one distinct schema for that DefsRef.
+            for defs_ref, schemas in schemas_for_alternatives.items():
+                schemas_for_alternatives[defs_ref] = _deduplicate_schemas(schemas_for_alternatives[defs_ref])
+
+            # Build the remapping
+            defs_remapping: dict[DefsRef, DefsRef] = {}
+            json_remapping: dict[JsonRef, JsonRef] = {}
+            for original_defs_ref in definitions:
+                alternatives = prioritized_choices[original_defs_ref]
+                # Pick the first alternative that has only one schema, since that means there is no collision
+                remapped_defs_ref = next(x for x in alternatives if len(schemas_for_alternatives[x]) == 1)
+                defs_remapping[original_defs_ref] = remapped_defs_ref
+                json_remapping[defs_to_json[original_defs_ref]] = defs_to_json[remapped_defs_ref]
+            remapping = _DefinitionsRemapping(defs_remapping, json_remapping)
+            new_definitions_schema = remapping.remap_json_schema({'$defs': copied_definitions})
+            if definitions_schema == new_definitions_schema:
+                # We've reached the fixed point
+                return remapping
+            definitions_schema = new_definitions_schema
+
+        raise PydanticInvalidForJsonSchema('Failed to simplify the JSON schema definitions')
+
+    def remap_defs_ref(self, ref: DefsRef) -> DefsRef:
+        return self.defs_remapping.get(ref, ref)
+
+    def remap_json_ref(self, ref: JsonRef) -> JsonRef:
+        return self.json_remapping.get(ref, ref)
+
+    def remap_json_schema(self, schema: Any) -> Any:
+        """
+        Recursively update the JSON schema replacing all $refs
+        """
+        if isinstance(schema, str):
+            # Note: this may not really be a JsonRef; we rely on having no collisions between JsonRefs and other strings
+            return self.remap_json_ref(JsonRef(schema))
+        elif isinstance(schema, list):
+            return [self.remap_json_schema(item) for item in schema]
+        elif isinstance(schema, dict):
+            for key, value in schema.items():
+                if key == '$ref' and isinstance(value, str):
+                    schema['$ref'] = self.remap_json_ref(JsonRef(value))
+                elif key == '$defs':
+                    schema['$defs'] = {
+                        self.remap_defs_ref(DefsRef(key)): self.remap_json_schema(value)
+                        for key, value in schema['$defs'].items()
+                    }
+                else:
+                    schema[key] = self.remap_json_schema(value)
+        return schema
+
+
+class GenerateJsonSchema:
+    """Usage docs: https://docs.pydantic.dev/2.6/concepts/json_schema/#customizing-the-json-schema-generation-process
+
+    A class for generating JSON schemas.
+
+    This class generates JSON schemas based on configured parameters. The default schema dialect
+    is [https://json-schema.org/draft/2020-12/schema](https://json-schema.org/draft/2020-12/schema).
+    The class uses `by_alias` to configure how fields with
+    multiple names are handled and `ref_template` to format reference names.
+
+    Attributes:
+        schema_dialect: The JSON schema dialect used to generate the schema. See
+            [Declaring a Dialect](https://json-schema.org/understanding-json-schema/reference/schema.html#id4)
+            in the JSON Schema documentation for more information about dialects.
+        ignored_warning_kinds: Warnings to ignore when generating the schema. `self.render_warning_message` will
+            do nothing if its argument `kind` is in `ignored_warning_kinds`;
+            this value can be modified on subclasses to easily control which warnings are emitted.
+        by_alias: Whether to use field aliases when generating the schema.
+        ref_template: The format string used when generating reference names.
+        core_to_json_refs: A mapping of core refs to JSON refs.
+        core_to_defs_refs: A mapping of core refs to definition refs.
+        defs_to_core_refs: A mapping of definition refs to core refs.
+        json_to_defs_refs: A mapping of JSON refs to definition refs.
+        definitions: Definitions in the schema.
+
+    Args:
+        by_alias: Whether to use field aliases in the generated schemas.
+        ref_template: The format string to use when generating reference names.
+
+    Raises:
+        JsonSchemaError: If the instance of the class is inadvertently re-used after generating a schema.
+    """
+
+    schema_dialect = 'https://json-schema.org/draft/2020-12/schema'
+
+    # `self.render_warning_message` will do nothing if its argument `kind` is in `ignored_warning_kinds`;
+    # this value can be modified on subclasses to easily control which warnings are emitted
+    ignored_warning_kinds: set[JsonSchemaWarningKind] = {'skipped-choice'}
+
+    def __init__(self, by_alias: bool = True, ref_template: str = DEFAULT_REF_TEMPLATE):
+        self.by_alias = by_alias
+        self.ref_template = ref_template
+
+        self.core_to_json_refs: dict[CoreModeRef, JsonRef] = {}
+        self.core_to_defs_refs: dict[CoreModeRef, DefsRef] = {}
+        self.defs_to_core_refs: dict[DefsRef, CoreModeRef] = {}
+        self.json_to_defs_refs: dict[JsonRef, DefsRef] = {}
+
+        self.definitions: dict[DefsRef, JsonSchemaValue] = {}
+        self._config_wrapper_stack = _config.ConfigWrapperStack(_config.ConfigWrapper({}))
+
+        self._mode: JsonSchemaMode = 'validation'
+
+        # The following includes a mapping of a fully-unique defs ref choice to a list of preferred
+        # alternatives, which are generally simpler, such as only including the class name.
+        # At the end of schema generation, we use these to produce a JSON schema with more human-readable
+        # definitions, which would also work better in a generated OpenAPI client, etc.
+        self._prioritized_defsref_choices: dict[DefsRef, list[DefsRef]] = {}
+        self._collision_counter: dict[str, int] = defaultdict(int)
+        self._collision_index: dict[str, int] = {}
+
+        self._schema_type_to_method = self.build_schema_type_to_method()
+
+        # When we encounter definitions we need to try to build them immediately
+        # so that they are available schemas that reference them
+        # But it's possible that CoreSchema was never going to be used
+        # (e.g. because the CoreSchema that references short circuits is JSON schema generation without needing
+        #  the reference) so instead of failing altogether if we can't build a definition we
+        # store the error raised and re-throw it if we end up needing that def
+        self._core_defs_invalid_for_json_schema: dict[DefsRef, PydanticInvalidForJsonSchema] = {}
+
+        # This changes to True after generating a schema, to prevent issues caused by accidental re-use
+        # of a single instance of a schema generator
+        self._used = False
+
+    @property
+    def _config(self) -> _config.ConfigWrapper:
+        return self._config_wrapper_stack.tail
+
+    @property
+    def mode(self) -> JsonSchemaMode:
+        if self._config.json_schema_mode_override is not None:
+            return self._config.json_schema_mode_override
+        else:
+            return self._mode
+
+    def build_schema_type_to_method(
+        self,
+    ) -> dict[CoreSchemaOrFieldType, Callable[[CoreSchemaOrField], JsonSchemaValue]]:
+        """Builds a dictionary mapping fields to methods for generating JSON schemas.
+
+        Returns:
+            A dictionary containing the mapping of `CoreSchemaOrFieldType` to a handler method.
+
+        Raises:
+            TypeError: If no method has been defined for generating a JSON schema for a given pydantic core schema type.
+        """
+        mapping: dict[CoreSchemaOrFieldType, Callable[[CoreSchemaOrField], JsonSchemaValue]] = {}
+        core_schema_types: list[CoreSchemaOrFieldType] = _typing_extra.all_literal_values(
+            CoreSchemaOrFieldType  # type: ignore
+        )
+        for key in core_schema_types:
+            method_name = f"{key.replace('-', '_')}_schema"
+            try:
+                mapping[key] = getattr(self, method_name)
+            except AttributeError as e:  # pragma: no cover
+                raise TypeError(
+                    f'No method for generating JsonSchema for core_schema.type={key!r} '
+                    f'(expected: {type(self).__name__}.{method_name})'
+                ) from e
+        return mapping
+
+    def generate_definitions(
+        self, inputs: Sequence[tuple[JsonSchemaKeyT, JsonSchemaMode, core_schema.CoreSchema]]
+    ) -> tuple[dict[tuple[JsonSchemaKeyT, JsonSchemaMode], JsonSchemaValue], dict[DefsRef, JsonSchemaValue]]:
+        """Generates JSON schema definitions from a list of core schemas, pairing the generated definitions with a
+        mapping that links the input keys to the definition references.
+
+        Args:
+            inputs: A sequence of tuples, where:
+
+                - The first element is a JSON schema key type.
+                - The second element is the JSON mode: either 'validation' or 'serialization'.
+                - The third element is a core schema.
+
+        Returns:
+            A tuple where:
+
+                - The first element is a dictionary whose keys are tuples of JSON schema key type and JSON mode, and
+                    whose values are the JSON schema corresponding to that pair of inputs. (These schemas may have
+                    JsonRef references to definitions that are defined in the second returned element.)
+                - The second element is a dictionary whose keys are definition references for the JSON schemas
+                    from the first returned element, and whose values are the actual JSON schema definitions.
+
+        Raises:
+            PydanticUserError: Raised if the JSON schema generator has already been used to generate a JSON schema.
+        """
+        if self._used:
+            raise PydanticUserError(
+                'This JSON schema generator has already been used to generate a JSON schema. '
+                f'You must create a new instance of {type(self).__name__} to generate a new JSON schema.',
+                code='json-schema-already-used',
+            )
+
+        for key, mode, schema in inputs:
+            self._mode = mode
+            self.generate_inner(schema)
+
+        definitions_remapping = self._build_definitions_remapping()
+
+        json_schemas_map: dict[tuple[JsonSchemaKeyT, JsonSchemaMode], DefsRef] = {}
+        for key, mode, schema in inputs:
+            self._mode = mode
+            json_schema = self.generate_inner(schema)
+            json_schemas_map[(key, mode)] = definitions_remapping.remap_json_schema(json_schema)
+
+        json_schema = {'$defs': self.definitions}
+        json_schema = definitions_remapping.remap_json_schema(json_schema)
+        self._used = True
+        return json_schemas_map, _sort_json_schema(json_schema['$defs'])  # type: ignore
+
+    def generate(self, schema: CoreSchema, mode: JsonSchemaMode = 'validation') -> JsonSchemaValue:
+        """Generates a JSON schema for a specified schema in a specified mode.
+
+        Args:
+            schema: A Pydantic model.
+            mode: The mode in which to generate the schema. Defaults to 'validation'.
+
+        Returns:
+            A JSON schema representing the specified schema.
+
+        Raises:
+            PydanticUserError: If the JSON schema generator has already been used to generate a JSON schema.
+        """
+        self._mode = mode
+        if self._used:
+            raise PydanticUserError(
+                'This JSON schema generator has already been used to generate a JSON schema. '
+                f'You must create a new instance of {type(self).__name__} to generate a new JSON schema.',
+                code='json-schema-already-used',
+            )
+
+        json_schema: JsonSchemaValue = self.generate_inner(schema)
+        json_ref_counts = self.get_json_ref_counts(json_schema)
+
+        # Remove the top-level $ref if present; note that the _generate method already ensures there are no sibling keys
+        ref = cast(JsonRef, json_schema.get('$ref'))
+        while ref is not None:  # may need to unpack multiple levels
+            ref_json_schema = self.get_schema_from_definitions(ref)
+            if json_ref_counts[ref] > 1 or ref_json_schema is None:
+                # Keep the ref, but use an allOf to remove the top level $ref
+                json_schema = {'allOf': [{'$ref': ref}]}
+            else:
+                # "Unpack" the ref since this is the only reference
+                json_schema = ref_json_schema.copy()  # copy to prevent recursive dict reference
+                json_ref_counts[ref] -= 1
+            ref = cast(JsonRef, json_schema.get('$ref'))
+
+        self._garbage_collect_definitions(json_schema)
+        definitions_remapping = self._build_definitions_remapping()
+
+        if self.definitions:
+            json_schema['$defs'] = self.definitions
+
+        json_schema = definitions_remapping.remap_json_schema(json_schema)
+
+        # For now, we will not set the $schema key. However, if desired, this can be easily added by overriding
+        # this method and adding the following line after a call to super().generate(schema):
+        # json_schema['$schema'] = self.schema_dialect
+
+        self._used = True
+        return _sort_json_schema(json_schema)
+
+    def generate_inner(self, schema: CoreSchemaOrField) -> JsonSchemaValue:  # noqa: C901
+        """Generates a JSON schema for a given core schema.
+
+        Args:
+            schema: The given core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        # If a schema with the same CoreRef has been handled, just return a reference to it
+        # Note that this assumes that it will _never_ be the case that the same CoreRef is used
+        # on types that should have different JSON schemas
+        if 'ref' in schema:
+            core_ref = CoreRef(schema['ref'])  # type: ignore[typeddict-item]
+            core_mode_ref = (core_ref, self.mode)
+            if core_mode_ref in self.core_to_defs_refs and self.core_to_defs_refs[core_mode_ref] in self.definitions:
+                return {'$ref': self.core_to_json_refs[core_mode_ref]}
+
+        # Generate the JSON schema, accounting for the json_schema_override and core_schema_override
+        metadata_handler = _core_metadata.CoreMetadataHandler(schema)
+
+        def populate_defs(core_schema: CoreSchema, json_schema: JsonSchemaValue) -> JsonSchemaValue:
+            if 'ref' in core_schema:
+                core_ref = CoreRef(core_schema['ref'])  # type: ignore[typeddict-item]
+                defs_ref, ref_json_schema = self.get_cache_defs_ref_schema(core_ref)
+                json_ref = JsonRef(ref_json_schema['$ref'])
+                self.json_to_defs_refs[json_ref] = defs_ref
+                # Replace the schema if it's not a reference to itself
+                # What we want to avoid is having the def be just a ref to itself
+                # which is what would happen if we blindly assigned any
+                if json_schema.get('$ref', None) != json_ref:
+                    self.definitions[defs_ref] = json_schema
+                    self._core_defs_invalid_for_json_schema.pop(defs_ref, None)
+                json_schema = ref_json_schema
+            return json_schema
+
+        def convert_to_all_of(json_schema: JsonSchemaValue) -> JsonSchemaValue:
+            if '$ref' in json_schema and len(json_schema.keys()) > 1:
+                # technically you can't have any other keys next to a "$ref"
+                # but it's an easy mistake to make and not hard to correct automatically here
+                json_schema = json_schema.copy()
+                ref = json_schema.pop('$ref')
+                json_schema = {'allOf': [{'$ref': ref}], **json_schema}
+            return json_schema
+
+        def handler_func(schema_or_field: CoreSchemaOrField) -> JsonSchemaValue:
+            """Generate a JSON schema based on the input schema.
+
+            Args:
+                schema_or_field: The core schema to generate a JSON schema from.
+
+            Returns:
+                The generated JSON schema.
+
+            Raises:
+                TypeError: If an unexpected schema type is encountered.
+            """
+            # Generate the core-schema-type-specific bits of the schema generation:
+            json_schema: JsonSchemaValue | None = None
+            if self.mode == 'serialization' and 'serialization' in schema_or_field:
+                ser_schema = schema_or_field['serialization']  # type: ignore
+                json_schema = self.ser_schema(ser_schema)
+            if json_schema is None:
+                if _core_utils.is_core_schema(schema_or_field) or _core_utils.is_core_schema_field(schema_or_field):
+                    generate_for_schema_type = self._schema_type_to_method[schema_or_field['type']]
+                    json_schema = generate_for_schema_type(schema_or_field)
+                else:
+                    raise TypeError(f'Unexpected schema type: schema={schema_or_field}')
+            if _core_utils.is_core_schema(schema_or_field):
+                json_schema = populate_defs(schema_or_field, json_schema)
+                json_schema = convert_to_all_of(json_schema)
+            return json_schema
+
+        current_handler = _schema_generation_shared.GenerateJsonSchemaHandler(self, handler_func)
+
+        for js_modify_function in metadata_handler.metadata.get('pydantic_js_functions', ()):
+
+            def new_handler_func(
+                schema_or_field: CoreSchemaOrField,
+                current_handler: GetJsonSchemaHandler = current_handler,
+                js_modify_function: GetJsonSchemaFunction = js_modify_function,
+            ) -> JsonSchemaValue:
+                json_schema = js_modify_function(schema_or_field, current_handler)
+                if _core_utils.is_core_schema(schema_or_field):
+                    json_schema = populate_defs(schema_or_field, json_schema)
+                original_schema = current_handler.resolve_ref_schema(json_schema)
+                ref = json_schema.pop('$ref', None)
+                if ref and json_schema:
+                    original_schema.update(json_schema)
+                return original_schema
+
+            current_handler = _schema_generation_shared.GenerateJsonSchemaHandler(self, new_handler_func)
+
+        for js_modify_function in metadata_handler.metadata.get('pydantic_js_annotation_functions', ()):
+
+            def new_handler_func(
+                schema_or_field: CoreSchemaOrField,
+                current_handler: GetJsonSchemaHandler = current_handler,
+                js_modify_function: GetJsonSchemaFunction = js_modify_function,
+            ) -> JsonSchemaValue:
+                json_schema = js_modify_function(schema_or_field, current_handler)
+                if _core_utils.is_core_schema(schema_or_field):
+                    json_schema = populate_defs(schema_or_field, json_schema)
+                    json_schema = convert_to_all_of(json_schema)
+                return json_schema
+
+            current_handler = _schema_generation_shared.GenerateJsonSchemaHandler(self, new_handler_func)
+
+        json_schema = current_handler(schema)
+        if _core_utils.is_core_schema(schema):
+            json_schema = populate_defs(schema, json_schema)
+            json_schema = convert_to_all_of(json_schema)
+        return json_schema
+
+    # ### Schema generation methods
+    def any_schema(self, schema: core_schema.AnySchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches any value.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        return {}
+
+    def none_schema(self, schema: core_schema.NoneSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches `None`.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        return {'type': 'null'}
+
+    def bool_schema(self, schema: core_schema.BoolSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a bool value.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        return {'type': 'boolean'}
+
+    def int_schema(self, schema: core_schema.IntSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches an int value.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        json_schema: dict[str, Any] = {'type': 'integer'}
+        self.update_with_validations(json_schema, schema, self.ValidationsMapping.numeric)
+        json_schema = {k: v for k, v in json_schema.items() if v not in {math.inf, -math.inf}}
+        return json_schema
+
+    def float_schema(self, schema: core_schema.FloatSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a float value.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        json_schema: dict[str, Any] = {'type': 'number'}
+        self.update_with_validations(json_schema, schema, self.ValidationsMapping.numeric)
+        json_schema = {k: v for k, v in json_schema.items() if v not in {math.inf, -math.inf}}
+        return json_schema
+
+    def decimal_schema(self, schema: core_schema.DecimalSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a decimal value.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        json_schema = self.str_schema(core_schema.str_schema())
+        if self.mode == 'validation':
+            multiple_of = schema.get('multiple_of')
+            le = schema.get('le')
+            ge = schema.get('ge')
+            lt = schema.get('lt')
+            gt = schema.get('gt')
+            json_schema = {
+                'anyOf': [
+                    self.float_schema(
+                        core_schema.float_schema(
+                            allow_inf_nan=schema.get('allow_inf_nan'),
+                            multiple_of=None if multiple_of is None else float(multiple_of),
+                            le=None if le is None else float(le),
+                            ge=None if ge is None else float(ge),
+                            lt=None if lt is None else float(lt),
+                            gt=None if gt is None else float(gt),
+                        )
+                    ),
+                    json_schema,
+                ],
+            }
+        return json_schema
+
+    def str_schema(self, schema: core_schema.StringSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a string value.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        json_schema = {'type': 'string'}
+        self.update_with_validations(json_schema, schema, self.ValidationsMapping.string)
+        return json_schema
+
+    def bytes_schema(self, schema: core_schema.BytesSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a bytes value.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        json_schema = {'type': 'string', 'format': 'base64url' if self._config.ser_json_bytes == 'base64' else 'binary'}
+        self.update_with_validations(json_schema, schema, self.ValidationsMapping.bytes)
+        return json_schema
+
+    def date_schema(self, schema: core_schema.DateSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a date value.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        json_schema = {'type': 'string', 'format': 'date'}
+        self.update_with_validations(json_schema, schema, self.ValidationsMapping.date)
+        return json_schema
+
+    def time_schema(self, schema: core_schema.TimeSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a time value.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        return {'type': 'string', 'format': 'time'}
+
+    def datetime_schema(self, schema: core_schema.DatetimeSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a datetime value.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        return {'type': 'string', 'format': 'date-time'}
+
+    def timedelta_schema(self, schema: core_schema.TimedeltaSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a timedelta value.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        if self._config.ser_json_timedelta == 'float':
+            return {'type': 'number'}
+        return {'type': 'string', 'format': 'duration'}
+
+    def literal_schema(self, schema: core_schema.LiteralSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a literal value.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        expected = [v.value if isinstance(v, Enum) else v for v in schema['expected']]
+        # jsonify the expected values
+        expected = [to_jsonable_python(v) for v in expected]
+
+        if len(expected) == 1:
+            return {'const': expected[0]}
+
+        types = {type(e) for e in expected}
+        if types == {str}:
+            return {'enum': expected, 'type': 'string'}
+        elif types == {int}:
+            return {'enum': expected, 'type': 'integer'}
+        elif types == {float}:
+            return {'enum': expected, 'type': 'number'}
+        elif types == {bool}:
+            return {'enum': expected, 'type': 'boolean'}
+        elif types == {list}:
+            return {'enum': expected, 'type': 'array'}
+        # there is not None case because if it's mixed it hits the final `else`
+        # if it's a single Literal[None] then it becomes a `const` schema above
+        else:
+            return {'enum': expected}
+
+    def is_instance_schema(self, schema: core_schema.IsInstanceSchema) -> JsonSchemaValue:
+        """Handles JSON schema generation for a core schema that checks if a value is an instance of a class.
+
+        Unless overridden in a subclass, this raises an error.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        return self.handle_invalid_for_json_schema(schema, f'core_schema.IsInstanceSchema ({schema["cls"]})')
+
+    def is_subclass_schema(self, schema: core_schema.IsSubclassSchema) -> JsonSchemaValue:
+        """Handles JSON schema generation for a core schema that checks if a value is a subclass of a class.
+
+        For backwards compatibility with v1, this does not raise an error, but can be overridden to change this.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        # Note: This is for compatibility with V1; you can override if you want different behavior.
+        return {}
+
+    def callable_schema(self, schema: core_schema.CallableSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a callable value.
+
+        Unless overridden in a subclass, this raises an error.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        return self.handle_invalid_for_json_schema(schema, 'core_schema.CallableSchema')
+
+    def list_schema(self, schema: core_schema.ListSchema) -> JsonSchemaValue:
+        """Returns a schema that matches a list schema.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        items_schema = {} if 'items_schema' not in schema else self.generate_inner(schema['items_schema'])
+        json_schema = {'type': 'array', 'items': items_schema}
+        self.update_with_validations(json_schema, schema, self.ValidationsMapping.array)
+        return json_schema
+
+    @deprecated('`tuple_positional_schema` is deprecated. Use `tuple_schema` instead.', category=None)
+    @final
+    def tuple_positional_schema(self, schema: core_schema.TupleSchema) -> JsonSchemaValue:
+        """Replaced by `tuple_schema`."""
+        warnings.warn(
+            '`tuple_positional_schema` is deprecated. Use `tuple_schema` instead.',
+            PydanticDeprecatedSince26,
+            stacklevel=2,
+        )
+        return self.tuple_schema(schema)
+
+    @deprecated('`tuple_variable_schema` is deprecated. Use `tuple_schema` instead.', category=None)
+    @final
+    def tuple_variable_schema(self, schema: core_schema.TupleSchema) -> JsonSchemaValue:
+        """Replaced by `tuple_schema`."""
+        warnings.warn(
+            '`tuple_variable_schema` is deprecated. Use `tuple_schema` instead.',
+            PydanticDeprecatedSince26,
+            stacklevel=2,
+        )
+        return self.tuple_schema(schema)
+
+    def tuple_schema(self, schema: core_schema.TupleSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a tuple schema e.g. `Tuple[int,
+        str, bool]` or `Tuple[int, ...]`.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        json_schema: JsonSchemaValue = {'type': 'array'}
+        if 'variadic_item_index' in schema:
+            variadic_item_index = schema['variadic_item_index']
+            if variadic_item_index > 0:
+                json_schema['minItems'] = variadic_item_index
+                json_schema['prefixItems'] = [
+                    self.generate_inner(item) for item in schema['items_schema'][:variadic_item_index]
+                ]
+            if variadic_item_index + 1 == len(schema['items_schema']):
+                # if the variadic item is the last item, then represent it faithfully
+                json_schema['items'] = self.generate_inner(schema['items_schema'][variadic_item_index])
+            else:
+                # otherwise, 'items' represents the schema for the variadic
+                # item plus the suffix, so just allow anything for simplicity
+                # for now
+                json_schema['items'] = True
+        else:
+            prefixItems = [self.generate_inner(item) for item in schema['items_schema']]
+            if prefixItems:
+                json_schema['prefixItems'] = prefixItems
+            json_schema['minItems'] = len(prefixItems)
+            json_schema['maxItems'] = len(prefixItems)
+        self.update_with_validations(json_schema, schema, self.ValidationsMapping.array)
+        return json_schema
+
+    def set_schema(self, schema: core_schema.SetSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a set schema.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        return self._common_set_schema(schema)
+
+    def frozenset_schema(self, schema: core_schema.FrozenSetSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a frozenset schema.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        return self._common_set_schema(schema)
+
+    def _common_set_schema(self, schema: core_schema.SetSchema | core_schema.FrozenSetSchema) -> JsonSchemaValue:
+        items_schema = {} if 'items_schema' not in schema else self.generate_inner(schema['items_schema'])
+        json_schema = {'type': 'array', 'uniqueItems': True, 'items': items_schema}
+        self.update_with_validations(json_schema, schema, self.ValidationsMapping.array)
+        return json_schema
+
+    def generator_schema(self, schema: core_schema.GeneratorSchema) -> JsonSchemaValue:
+        """Returns a JSON schema that represents the provided GeneratorSchema.
+
+        Args:
+            schema: The schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        items_schema = {} if 'items_schema' not in schema else self.generate_inner(schema['items_schema'])
+        json_schema = {'type': 'array', 'items': items_schema}
+        self.update_with_validations(json_schema, schema, self.ValidationsMapping.array)
+        return json_schema
+
+    def dict_schema(self, schema: core_schema.DictSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a dict schema.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        json_schema: JsonSchemaValue = {'type': 'object'}
+
+        keys_schema = self.generate_inner(schema['keys_schema']).copy() if 'keys_schema' in schema else {}
+        keys_pattern = keys_schema.pop('pattern', None)
+
+        values_schema = self.generate_inner(schema['values_schema']).copy() if 'values_schema' in schema else {}
+        values_schema.pop('title', None)  # don't give a title to the additionalProperties
+        if values_schema or keys_pattern is not None:  # don't add additionalProperties if it's empty
+            if keys_pattern is None:
+                json_schema['additionalProperties'] = values_schema
+            else:
+                json_schema['patternProperties'] = {keys_pattern: values_schema}
+
+        self.update_with_validations(json_schema, schema, self.ValidationsMapping.object)
+        return json_schema
+
+    def _function_schema(
+        self,
+        schema: _core_utils.AnyFunctionSchema,
+    ) -> JsonSchemaValue:
+        if _core_utils.is_function_with_inner_schema(schema):
+            # This could be wrong if the function's mode is 'before', but in practice will often be right, and when it
+            # isn't, I think it would be hard to automatically infer what the desired schema should be.
+            return self.generate_inner(schema['schema'])
+
+        # function-plain
+        return self.handle_invalid_for_json_schema(
+            schema, f'core_schema.PlainValidatorFunctionSchema ({schema["function"]})'
+        )
+
+    def function_before_schema(self, schema: core_schema.BeforeValidatorFunctionSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a function-before schema.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        return self._function_schema(schema)
+
+    def function_after_schema(self, schema: core_schema.AfterValidatorFunctionSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a function-after schema.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        return self._function_schema(schema)
+
+    def function_plain_schema(self, schema: core_schema.PlainValidatorFunctionSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a function-plain schema.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        return self._function_schema(schema)
+
+    def function_wrap_schema(self, schema: core_schema.WrapValidatorFunctionSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a function-wrap schema.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        return self._function_schema(schema)
+
+    def default_schema(self, schema: core_schema.WithDefaultSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a schema with a default value.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        json_schema = self.generate_inner(schema['schema'])
+
+        if 'default' not in schema:
+            return json_schema
+        default = schema['default']
+        # Note: if you want to include the value returned by the default_factory,
+        # override this method and replace the code above with:
+        # if 'default' in schema:
+        #     default = schema['default']
+        # elif 'default_factory' in schema:
+        #     default = schema['default_factory']()
+        # else:
+        #     return json_schema
+
+        try:
+            encoded_default = self.encode_default(default)
+        except pydantic_core.PydanticSerializationError:
+            self.emit_warning(
+                'non-serializable-default',
+                f'Default value {default} is not JSON serializable; excluding default from JSON schema',
+            )
+            # Return the inner schema, as though there was no default
+            return json_schema
+
+        if '$ref' in json_schema:
+            # Since reference schemas do not support child keys, we wrap the reference schema in a single-case allOf:
+            return {'allOf': [json_schema], 'default': encoded_default}
+        else:
+            json_schema['default'] = encoded_default
+            return json_schema
+
+    def nullable_schema(self, schema: core_schema.NullableSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a schema that allows null values.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        null_schema = {'type': 'null'}
+        inner_json_schema = self.generate_inner(schema['schema'])
+
+        if inner_json_schema == null_schema:
+            return null_schema
+        else:
+            # Thanks to the equality check against `null_schema` above, I think 'oneOf' would also be valid here;
+            # I'll use 'anyOf' for now, but it could be changed it if it would work better with some external tooling
+            return self.get_flattened_anyof([inner_json_schema, null_schema])
+
+    def union_schema(self, schema: core_schema.UnionSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a schema that allows values matching any of the given schemas.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        generated: list[JsonSchemaValue] = []
+
+        choices = schema['choices']
+        for choice in choices:
+            # choice will be a tuple if an explicit label was provided
+            choice_schema = choice[0] if isinstance(choice, tuple) else choice
+            try:
+                generated.append(self.generate_inner(choice_schema))
+            except PydanticOmit:
+                continue
+            except PydanticInvalidForJsonSchema as exc:
+                self.emit_warning('skipped-choice', exc.message)
+        if len(generated) == 1:
+            return generated[0]
+        return self.get_flattened_anyof(generated)
+
+    def tagged_union_schema(self, schema: core_schema.TaggedUnionSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a schema that allows values matching any of the given schemas, where
+        the schemas are tagged with a discriminator field that indicates which schema should be used to validate
+        the value.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        generated: dict[str, JsonSchemaValue] = {}
+        for k, v in schema['choices'].items():
+            if isinstance(k, Enum):
+                k = k.value
+            try:
+                # Use str(k) since keys must be strings for json; while not technically correct,
+                # it's the closest that can be represented in valid JSON
+                generated[str(k)] = self.generate_inner(v).copy()
+            except PydanticOmit:
+                continue
+            except PydanticInvalidForJsonSchema as exc:
+                self.emit_warning('skipped-choice', exc.message)
+
+        one_of_choices = _deduplicate_schemas(generated.values())
+        json_schema: JsonSchemaValue = {'oneOf': one_of_choices}
+
+        # This reflects the v1 behavior; TODO: we should make it possible to exclude OpenAPI stuff from the JSON schema
+        openapi_discriminator = self._extract_discriminator(schema, one_of_choices)
+        if openapi_discriminator is not None:
+            json_schema['discriminator'] = {
+                'propertyName': openapi_discriminator,
+                'mapping': {k: v.get('$ref', v) for k, v in generated.items()},
+            }
+
+        return json_schema
+
+    def _extract_discriminator(
+        self, schema: core_schema.TaggedUnionSchema, one_of_choices: list[JsonDict]
+    ) -> str | None:
+        """Extract a compatible OpenAPI discriminator from the schema and one_of choices that end up in the final
+        schema."""
+        openapi_discriminator: str | None = None
+
+        if isinstance(schema['discriminator'], str):
+            return schema['discriminator']
+
+        if isinstance(schema['discriminator'], list):
+            # If the discriminator is a single item list containing a string, that is equivalent to the string case
+            if len(schema['discriminator']) == 1 and isinstance(schema['discriminator'][0], str):
+                return schema['discriminator'][0]
+            # When an alias is used that is different from the field name, the discriminator will be a list of single
+            # str lists, one for the attribute and one for the actual alias. The logic here will work even if there is
+            # more than one possible attribute, and looks for whether a single alias choice is present as a documented
+            # property on all choices. If so, that property will be used as the OpenAPI discriminator.
+            for alias_path in schema['discriminator']:
+                if not isinstance(alias_path, list):
+                    break  # this means that the discriminator is not a list of alias paths
+                if len(alias_path) != 1:
+                    continue  # this means that the "alias" does not represent a single field
+                alias = alias_path[0]
+                if not isinstance(alias, str):
+                    continue  # this means that the "alias" does not represent a field
+                alias_is_present_on_all_choices = True
+                for choice in one_of_choices:
+                    while '$ref' in choice:
+                        assert isinstance(choice['$ref'], str)
+                        choice = self.get_schema_from_definitions(JsonRef(choice['$ref'])) or {}
+                    properties = choice.get('properties', {})
+                    if not isinstance(properties, dict) or alias not in properties:
+                        alias_is_present_on_all_choices = False
+                        break
+                if alias_is_present_on_all_choices:
+                    openapi_discriminator = alias
+                    break
+        return openapi_discriminator
+
+    def chain_schema(self, schema: core_schema.ChainSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a core_schema.ChainSchema.
+
+        When generating a schema for validation, we return the validation JSON schema for the first step in the chain.
+        For serialization, we return the serialization JSON schema for the last step in the chain.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        step_index = 0 if self.mode == 'validation' else -1  # use first step for validation, last for serialization
+        return self.generate_inner(schema['steps'][step_index])
+
+    def lax_or_strict_schema(self, schema: core_schema.LaxOrStrictSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a schema that allows values matching either the lax schema or the
+        strict schema.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        # TODO: Need to read the default value off of model config or whatever
+        use_strict = schema.get('strict', False)  # TODO: replace this default False
+        # If your JSON schema fails to generate it is probably
+        # because one of the following two branches failed.
+        if use_strict:
+            return self.generate_inner(schema['strict_schema'])
+        else:
+            return self.generate_inner(schema['lax_schema'])
+
+    def json_or_python_schema(self, schema: core_schema.JsonOrPythonSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a schema that allows values matching either the JSON schema or the
+        Python schema.
+
+        The JSON schema is used instead of the Python schema. If you want to use the Python schema, you should override
+        this method.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        return self.generate_inner(schema['json_schema'])
+
+    def typed_dict_schema(self, schema: core_schema.TypedDictSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a schema that defines a typed dict.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        total = schema.get('total', True)
+        named_required_fields: list[tuple[str, bool, CoreSchemaField]] = [
+            (name, self.field_is_required(field, total), field)
+            for name, field in schema['fields'].items()
+            if self.field_is_present(field)
+        ]
+        if self.mode == 'serialization':
+            named_required_fields.extend(self._name_required_computed_fields(schema.get('computed_fields', [])))
+
+        config = _get_typed_dict_config(schema)
+        with self._config_wrapper_stack.push(config):
+            json_schema = self._named_required_fields_schema(named_required_fields)
+
+        extra = schema.get('extra_behavior')
+        if extra is None:
+            extra = config.get('extra', 'ignore')
+        if extra == 'forbid':
+            json_schema['additionalProperties'] = False
+        elif extra == 'allow':
+            json_schema['additionalProperties'] = True
+
+        return json_schema
+
+    @staticmethod
+    def _name_required_computed_fields(
+        computed_fields: list[ComputedField],
+    ) -> list[tuple[str, bool, core_schema.ComputedField]]:
+        return [(field['property_name'], True, field) for field in computed_fields]
+
+    def _named_required_fields_schema(
+        self, named_required_fields: Sequence[tuple[str, bool, CoreSchemaField]]
+    ) -> JsonSchemaValue:
+        properties: dict[str, JsonSchemaValue] = {}
+        required_fields: list[str] = []
+        for name, required, field in named_required_fields:
+            if self.by_alias:
+                name = self._get_alias_name(field, name)
+            try:
+                field_json_schema = self.generate_inner(field).copy()
+            except PydanticOmit:
+                continue
+            if 'title' not in field_json_schema and self.field_title_should_be_set(field):
+                title = self.get_title_from_name(name)
+                field_json_schema['title'] = title
+            field_json_schema = self.handle_ref_overrides(field_json_schema)
+            properties[name] = field_json_schema
+            if required:
+                required_fields.append(name)
+
+        json_schema = {'type': 'object', 'properties': properties}
+        if required_fields:
+            json_schema['required'] = required_fields
+        return json_schema
+
+    def _get_alias_name(self, field: CoreSchemaField, name: str) -> str:
+        if field['type'] == 'computed-field':
+            alias: Any = field.get('alias', name)
+        elif self.mode == 'validation':
+            alias = field.get('validation_alias', name)
+        else:
+            alias = field.get('serialization_alias', name)
+        if isinstance(alias, str):
+            name = alias
+        elif isinstance(alias, list):
+            alias = cast('list[str] | str', alias)
+            for path in alias:
+                if isinstance(path, list) and len(path) == 1 and isinstance(path[0], str):
+                    # Use the first valid single-item string path; the code that constructs the alias array
+                    # should ensure the first such item is what belongs in the JSON schema
+                    name = path[0]
+                    break
+        else:
+            assert_never(alias)
+        return name
+
+    def typed_dict_field_schema(self, schema: core_schema.TypedDictField) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a schema that defines a typed dict field.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        return self.generate_inner(schema['schema'])
+
+    def dataclass_field_schema(self, schema: core_schema.DataclassField) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a schema that defines a dataclass field.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        return self.generate_inner(schema['schema'])
+
+    def model_field_schema(self, schema: core_schema.ModelField) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a schema that defines a model field.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        return self.generate_inner(schema['schema'])
+
+    def computed_field_schema(self, schema: core_schema.ComputedField) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a schema that defines a computed field.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        return self.generate_inner(schema['return_schema'])
+
+    def model_schema(self, schema: core_schema.ModelSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a schema that defines a model.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        # We do not use schema['model'].model_json_schema() here
+        # because it could lead to inconsistent refs handling, etc.
+        cls = cast('type[BaseModel]', schema['cls'])
+        config = cls.model_config
+        title = config.get('title')
+
+        with self._config_wrapper_stack.push(config):
+            json_schema = self.generate_inner(schema['schema'])
+
+        json_schema_extra = config.get('json_schema_extra')
+        if cls.__pydantic_root_model__:
+            root_json_schema_extra = cls.model_fields['root'].json_schema_extra
+            if json_schema_extra and root_json_schema_extra:
+                raise ValueError(
+                    '"model_config[\'json_schema_extra\']" and "Field.json_schema_extra" on "RootModel.root"'
+                    ' field must not be set simultaneously'
+                )
+            if root_json_schema_extra:
+                json_schema_extra = root_json_schema_extra
+
+        json_schema = self._update_class_schema(json_schema, title, config.get('extra', None), cls, json_schema_extra)
+
+        return json_schema
+
+    def _update_class_schema(
+        self,
+        json_schema: JsonSchemaValue,
+        title: str | None,
+        extra: Literal['allow', 'ignore', 'forbid'] | None,
+        cls: type[Any],
+        json_schema_extra: JsonDict | JsonSchemaExtraCallable | None,
+    ) -> JsonSchemaValue:
+        if '$ref' in json_schema:
+            schema_to_update = self.get_schema_from_definitions(JsonRef(json_schema['$ref'])) or json_schema
+        else:
+            schema_to_update = json_schema
+
+        if title is not None:
+            # referenced_schema['title'] = title
+            schema_to_update.setdefault('title', title)
+
+        if 'additionalProperties' not in schema_to_update:
+            if extra == 'allow':
+                schema_to_update['additionalProperties'] = True
+            elif extra == 'forbid':
+                schema_to_update['additionalProperties'] = False
+
+        if isinstance(json_schema_extra, (staticmethod, classmethod)):
+            # In older versions of python, this is necessary to ensure staticmethod/classmethods are callable
+            json_schema_extra = json_schema_extra.__get__(cls)
+
+        if isinstance(json_schema_extra, dict):
+            schema_to_update.update(json_schema_extra)
+        elif callable(json_schema_extra):
+            if len(inspect.signature(json_schema_extra).parameters) > 1:
+                json_schema_extra(schema_to_update, cls)  # type: ignore
+            else:
+                json_schema_extra(schema_to_update)  # type: ignore
+        elif json_schema_extra is not None:
+            raise ValueError(
+                f"model_config['json_schema_extra']={json_schema_extra} should be a dict, callable, or None"
+            )
+
+        return json_schema
+
+    def resolve_schema_to_update(self, json_schema: JsonSchemaValue) -> JsonSchemaValue:
+        """Resolve a JsonSchemaValue to the non-ref schema if it is a $ref schema.
+
+        Args:
+            json_schema: The schema to resolve.
+
+        Returns:
+            The resolved schema.
+        """
+        if '$ref' in json_schema:
+            schema_to_update = self.get_schema_from_definitions(JsonRef(json_schema['$ref']))
+            if schema_to_update is None:
+                raise RuntimeError(f'Cannot update undefined schema for $ref={json_schema["$ref"]}')
+            return self.resolve_schema_to_update(schema_to_update)
+        else:
+            schema_to_update = json_schema
+        return schema_to_update
+
+    def model_fields_schema(self, schema: core_schema.ModelFieldsSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a schema that defines a model's fields.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        named_required_fields: list[tuple[str, bool, CoreSchemaField]] = [
+            (name, self.field_is_required(field, total=True), field)
+            for name, field in schema['fields'].items()
+            if self.field_is_present(field)
+        ]
+        if self.mode == 'serialization':
+            named_required_fields.extend(self._name_required_computed_fields(schema.get('computed_fields', [])))
+        json_schema = self._named_required_fields_schema(named_required_fields)
+        extras_schema = schema.get('extras_schema', None)
+        if extras_schema is not None:
+            schema_to_update = self.resolve_schema_to_update(json_schema)
+            schema_to_update['additionalProperties'] = self.generate_inner(extras_schema)
+        return json_schema
+
+    def field_is_present(self, field: CoreSchemaField) -> bool:
+        """Whether the field should be included in the generated JSON schema.
+
+        Args:
+            field: The schema for the field itself.
+
+        Returns:
+            `True` if the field should be included in the generated JSON schema, `False` otherwise.
+        """
+        if self.mode == 'serialization':
+            # If you still want to include the field in the generated JSON schema,
+            # override this method and return True
+            return not field.get('serialization_exclude')
+        elif self.mode == 'validation':
+            return True
+        else:
+            assert_never(self.mode)
+
+    def field_is_required(
+        self,
+        field: core_schema.ModelField | core_schema.DataclassField | core_schema.TypedDictField,
+        total: bool,
+    ) -> bool:
+        """Whether the field should be marked as required in the generated JSON schema.
+        (Note that this is irrelevant if the field is not present in the JSON schema.).
+
+        Args:
+            field: The schema for the field itself.
+            total: Only applies to `TypedDictField`s.
+                Indicates if the `TypedDict` this field belongs to is total, in which case any fields that don't
+                explicitly specify `required=False` are required.
+
+        Returns:
+            `True` if the field should be marked as required in the generated JSON schema, `False` otherwise.
+        """
+        if self.mode == 'serialization' and self._config.json_schema_serialization_defaults_required:
+            return not field.get('serialization_exclude')
+        else:
+            if field['type'] == 'typed-dict-field':
+                return field.get('required', total)
+            else:
+                return field['schema']['type'] != 'default'
+
+    def dataclass_args_schema(self, schema: core_schema.DataclassArgsSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a schema that defines a dataclass's constructor arguments.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        named_required_fields: list[tuple[str, bool, CoreSchemaField]] = [
+            (field['name'], self.field_is_required(field, total=True), field)
+            for field in schema['fields']
+            if self.field_is_present(field)
+        ]
+        if self.mode == 'serialization':
+            named_required_fields.extend(self._name_required_computed_fields(schema.get('computed_fields', [])))
+        return self._named_required_fields_schema(named_required_fields)
+
+    def dataclass_schema(self, schema: core_schema.DataclassSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a schema that defines a dataclass.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        cls = schema['cls']
+        config: ConfigDict = getattr(cls, '__pydantic_config__', cast('ConfigDict', {}))
+        title = config.get('title') or cls.__name__
+
+        with self._config_wrapper_stack.push(config):
+            json_schema = self.generate_inner(schema['schema']).copy()
+
+        json_schema_extra = config.get('json_schema_extra')
+        json_schema = self._update_class_schema(json_schema, title, config.get('extra', None), cls, json_schema_extra)
+
+        # Dataclass-specific handling of description
+        if is_dataclass(cls) and not hasattr(cls, '__pydantic_validator__'):
+            # vanilla dataclass; don't use cls.__doc__ as it will contain the class signature by default
+            description = None
+        else:
+            description = None if cls.__doc__ is None else inspect.cleandoc(cls.__doc__)
+        if description:
+            json_schema['description'] = description
+
+        return json_schema
+
+    def arguments_schema(self, schema: core_schema.ArgumentsSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a schema that defines a function's arguments.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        metadata = _core_metadata.CoreMetadataHandler(schema).metadata
+        prefer_positional = metadata.get('pydantic_js_prefer_positional_arguments')
+
+        arguments = schema['arguments_schema']
+        kw_only_arguments = [a for a in arguments if a.get('mode') == 'keyword_only']
+        kw_or_p_arguments = [a for a in arguments if a.get('mode') in {'positional_or_keyword', None}]
+        p_only_arguments = [a for a in arguments if a.get('mode') == 'positional_only']
+        var_args_schema = schema.get('var_args_schema')
+        var_kwargs_schema = schema.get('var_kwargs_schema')
+
+        if prefer_positional:
+            positional_possible = not kw_only_arguments and not var_kwargs_schema
+            if positional_possible:
+                return self.p_arguments_schema(p_only_arguments + kw_or_p_arguments, var_args_schema)
+
+        keyword_possible = not p_only_arguments and not var_args_schema
+        if keyword_possible:
+            return self.kw_arguments_schema(kw_or_p_arguments + kw_only_arguments, var_kwargs_schema)
+
+        if not prefer_positional:
+            positional_possible = not kw_only_arguments and not var_kwargs_schema
+            if positional_possible:
+                return self.p_arguments_schema(p_only_arguments + kw_or_p_arguments, var_args_schema)
+
+        raise PydanticInvalidForJsonSchema(
+            'Unable to generate JSON schema for arguments validator with positional-only and keyword-only arguments'
+        )
+
+    def kw_arguments_schema(
+        self, arguments: list[core_schema.ArgumentsParameter], var_kwargs_schema: CoreSchema | None
+    ) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a schema that defines a function's keyword arguments.
+
+        Args:
+            arguments: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        properties: dict[str, JsonSchemaValue] = {}
+        required: list[str] = []
+        for argument in arguments:
+            name = self.get_argument_name(argument)
+            argument_schema = self.generate_inner(argument['schema']).copy()
+            argument_schema['title'] = self.get_title_from_name(name)
+            properties[name] = argument_schema
+
+            if argument['schema']['type'] != 'default':
+                # This assumes that if the argument has a default value,
+                # the inner schema must be of type WithDefaultSchema.
+                # I believe this is true, but I am not 100% sure
+                required.append(name)
+
+        json_schema: JsonSchemaValue = {'type': 'object', 'properties': properties}
+        if required:
+            json_schema['required'] = required
+
+        if var_kwargs_schema:
+            additional_properties_schema = self.generate_inner(var_kwargs_schema)
+            if additional_properties_schema:
+                json_schema['additionalProperties'] = additional_properties_schema
+        else:
+            json_schema['additionalProperties'] = False
+        return json_schema
+
+    def p_arguments_schema(
+        self, arguments: list[core_schema.ArgumentsParameter], var_args_schema: CoreSchema | None
+    ) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a schema that defines a function's positional arguments.
+
+        Args:
+            arguments: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        prefix_items: list[JsonSchemaValue] = []
+        min_items = 0
+
+        for argument in arguments:
+            name = self.get_argument_name(argument)
+
+            argument_schema = self.generate_inner(argument['schema']).copy()
+            argument_schema['title'] = self.get_title_from_name(name)
+            prefix_items.append(argument_schema)
+
+            if argument['schema']['type'] != 'default':
+                # This assumes that if the argument has a default value,
+                # the inner schema must be of type WithDefaultSchema.
+                # I believe this is true, but I am not 100% sure
+                min_items += 1
+
+        json_schema: JsonSchemaValue = {'type': 'array', 'prefixItems': prefix_items}
+        if min_items:
+            json_schema['minItems'] = min_items
+
+        if var_args_schema:
+            items_schema = self.generate_inner(var_args_schema)
+            if items_schema:
+                json_schema['items'] = items_schema
+        else:
+            json_schema['maxItems'] = len(prefix_items)
+
+        return json_schema
+
+    def get_argument_name(self, argument: core_schema.ArgumentsParameter) -> str:
+        """Retrieves the name of an argument.
+
+        Args:
+            argument: The core schema.
+
+        Returns:
+            The name of the argument.
+        """
+        name = argument['name']
+        if self.by_alias:
+            alias = argument.get('alias')
+            if isinstance(alias, str):
+                name = alias
+            else:
+                pass  # might want to do something else?
+        return name
+
+    def call_schema(self, schema: core_schema.CallSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a schema that defines a function call.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        return self.generate_inner(schema['arguments_schema'])
+
+    def custom_error_schema(self, schema: core_schema.CustomErrorSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a schema that defines a custom error.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        return self.generate_inner(schema['schema'])
+
+    def json_schema(self, schema: core_schema.JsonSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a schema that defines a JSON object.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        content_core_schema = schema.get('schema') or core_schema.any_schema()
+        content_json_schema = self.generate_inner(content_core_schema)
+        if self.mode == 'validation':
+            return {'type': 'string', 'contentMediaType': 'application/json', 'contentSchema': content_json_schema}
+        else:
+            # self.mode == 'serialization'
+            return content_json_schema
+
+    def url_schema(self, schema: core_schema.UrlSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a schema that defines a URL.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        json_schema = {'type': 'string', 'format': 'uri', 'minLength': 1}
+        self.update_with_validations(json_schema, schema, self.ValidationsMapping.string)
+        return json_schema
+
+    def multi_host_url_schema(self, schema: core_schema.MultiHostUrlSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a schema that defines a URL that can be used with multiple hosts.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        # Note: 'multi-host-uri' is a custom/pydantic-specific format, not part of the JSON Schema spec
+        json_schema = {'type': 'string', 'format': 'multi-host-uri', 'minLength': 1}
+        self.update_with_validations(json_schema, schema, self.ValidationsMapping.string)
+        return json_schema
+
+    def uuid_schema(self, schema: core_schema.UuidSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a UUID.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        return {'type': 'string', 'format': 'uuid'}
+
+    def definitions_schema(self, schema: core_schema.DefinitionsSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a schema that defines a JSON object with definitions.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        for definition in schema['definitions']:
+            try:
+                self.generate_inner(definition)
+            except PydanticInvalidForJsonSchema as e:
+                core_ref: CoreRef = CoreRef(definition['ref'])  # type: ignore
+                self._core_defs_invalid_for_json_schema[self.get_defs_ref((core_ref, self.mode))] = e
+                continue
+        return self.generate_inner(schema['schema'])
+
+    def definition_ref_schema(self, schema: core_schema.DefinitionReferenceSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a schema that references a definition.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        core_ref = CoreRef(schema['schema_ref'])
+        _, ref_json_schema = self.get_cache_defs_ref_schema(core_ref)
+        return ref_json_schema
+
+    def ser_schema(
+        self, schema: core_schema.SerSchema | core_schema.IncExSeqSerSchema | core_schema.IncExDictSerSchema
+    ) -> JsonSchemaValue | None:
+        """Generates a JSON schema that matches a schema that defines a serialized object.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        schema_type = schema['type']
+        if schema_type == 'function-plain' or schema_type == 'function-wrap':
+            # PlainSerializerFunctionSerSchema or WrapSerializerFunctionSerSchema
+            return_schema = schema.get('return_schema')
+            if return_schema is not None:
+                return self.generate_inner(return_schema)
+        elif schema_type == 'format' or schema_type == 'to-string':
+            # FormatSerSchema or ToStringSerSchema
+            return self.str_schema(core_schema.str_schema())
+        elif schema['type'] == 'model':
+            # ModelSerSchema
+            return self.generate_inner(schema['schema'])
+        return None
+
+    # ### Utility methods
+
+    def get_title_from_name(self, name: str) -> str:
+        """Retrieves a title from a name.
+
+        Args:
+            name: The name to retrieve a title from.
+
+        Returns:
+            The title.
+        """
+        return name.title().replace('_', ' ')
+
+    def field_title_should_be_set(self, schema: CoreSchemaOrField) -> bool:
+        """Returns true if a field with the given schema should have a title set based on the field name.
+
+        Intuitively, we want this to return true for schemas that wouldn't otherwise provide their own title
+        (e.g., int, float, str), and false for those that would (e.g., BaseModel subclasses).
+
+        Args:
+            schema: The schema to check.
+
+        Returns:
+            `True` if the field should have a title set, `False` otherwise.
+        """
+        if _core_utils.is_core_schema_field(schema):
+            if schema['type'] == 'computed-field':
+                field_schema = schema['return_schema']
+            else:
+                field_schema = schema['schema']
+            return self.field_title_should_be_set(field_schema)
+
+        elif _core_utils.is_core_schema(schema):
+            if schema.get('ref'):  # things with refs, such as models and enums, should not have titles set
+                return False
+            if schema['type'] in {'default', 'nullable', 'definitions'}:
+                return self.field_title_should_be_set(schema['schema'])  # type: ignore[typeddict-item]
+            if _core_utils.is_function_with_inner_schema(schema):
+                return self.field_title_should_be_set(schema['schema'])
+            if schema['type'] == 'definition-ref':
+                # Referenced schemas should not have titles set for the same reason
+                # schemas with refs should not
+                return False
+            return True  # anything else should have title set
+
+        else:
+            raise PydanticInvalidForJsonSchema(f'Unexpected schema type: schema={schema}')  # pragma: no cover
+
+    def normalize_name(self, name: str) -> str:
+        """Normalizes a name to be used as a key in a dictionary.
+
+        Args:
+            name: The name to normalize.
+
+        Returns:
+            The normalized name.
+        """
+        return re.sub(r'[^a-zA-Z0-9.\-_]', '_', name).replace('.', '__')
+
+    def get_defs_ref(self, core_mode_ref: CoreModeRef) -> DefsRef:
+        """Override this method to change the way that definitions keys are generated from a core reference.
+
+        Args:
+            core_mode_ref: The core reference.
+
+        Returns:
+            The definitions key.
+        """
+        # Split the core ref into "components"; generic origins and arguments are each separate components
+        core_ref, mode = core_mode_ref
+        components = re.split(r'([\][,])', core_ref)
+        # Remove IDs from each component
+        components = [x.rsplit(':', 1)[0] for x in components]
+        core_ref_no_id = ''.join(components)
+        # Remove everything before the last period from each "component"
+        components = [re.sub(r'(?:[^.[\]]+\.)+((?:[^.[\]]+))', r'\1', x) for x in components]
+        short_ref = ''.join(components)
+
+        mode_title = _MODE_TITLE_MAPPING[mode]
+
+        # It is important that the generated defs_ref values be such that at least one choice will not
+        # be generated for any other core_ref. Currently, this should be the case because we include
+        # the id of the source type in the core_ref
+        name = DefsRef(self.normalize_name(short_ref))
+        name_mode = DefsRef(self.normalize_name(short_ref) + f'-{mode_title}')
+        module_qualname = DefsRef(self.normalize_name(core_ref_no_id))
+        module_qualname_mode = DefsRef(f'{module_qualname}-{mode_title}')
+        module_qualname_id = DefsRef(self.normalize_name(core_ref))
+        occurrence_index = self._collision_index.get(module_qualname_id)
+        if occurrence_index is None:
+            self._collision_counter[module_qualname] += 1
+            occurrence_index = self._collision_index[module_qualname_id] = self._collision_counter[module_qualname]
+
+        module_qualname_occurrence = DefsRef(f'{module_qualname}__{occurrence_index}')
+        module_qualname_occurrence_mode = DefsRef(f'{module_qualname_mode}__{occurrence_index}')
+
+        self._prioritized_defsref_choices[module_qualname_occurrence_mode] = [
+            name,
+            name_mode,
+            module_qualname,
+            module_qualname_mode,
+            module_qualname_occurrence,
+            module_qualname_occurrence_mode,
+        ]
+
+        return module_qualname_occurrence_mode
+
+    def get_cache_defs_ref_schema(self, core_ref: CoreRef) -> tuple[DefsRef, JsonSchemaValue]:
+        """This method wraps the get_defs_ref method with some cache-lookup/population logic,
+        and returns both the produced defs_ref and the JSON schema that will refer to the right definition.
+
+        Args:
+            core_ref: The core reference to get the definitions reference for.
+
+        Returns:
+            A tuple of the definitions reference and the JSON schema that will refer to it.
+        """
+        core_mode_ref = (core_ref, self.mode)
+        maybe_defs_ref = self.core_to_defs_refs.get(core_mode_ref)
+        if maybe_defs_ref is not None:
+            json_ref = self.core_to_json_refs[core_mode_ref]
+            return maybe_defs_ref, {'$ref': json_ref}
+
+        defs_ref = self.get_defs_ref(core_mode_ref)
+
+        # populate the ref translation mappings
+        self.core_to_defs_refs[core_mode_ref] = defs_ref
+        self.defs_to_core_refs[defs_ref] = core_mode_ref
+
+        json_ref = JsonRef(self.ref_template.format(model=defs_ref))
+        self.core_to_json_refs[core_mode_ref] = json_ref
+        self.json_to_defs_refs[json_ref] = defs_ref
+        ref_json_schema = {'$ref': json_ref}
+        return defs_ref, ref_json_schema
+
+    def handle_ref_overrides(self, json_schema: JsonSchemaValue) -> JsonSchemaValue:
+        """It is not valid for a schema with a top-level $ref to have sibling keys.
+
+        During our own schema generation, we treat sibling keys as overrides to the referenced schema,
+        but this is not how the official JSON schema spec works.
+
+        Because of this, we first remove any sibling keys that are redundant with the referenced schema, then if
+        any remain, we transform the schema from a top-level '$ref' to use allOf to move the $ref out of the top level.
+        (See bottom of https://swagger.io/docs/specification/using-ref/ for a reference about this behavior)
+        """
+        if '$ref' in json_schema:
+            # prevent modifications to the input; this copy may be safe to drop if there is significant overhead
+            json_schema = json_schema.copy()
+
+            referenced_json_schema = self.get_schema_from_definitions(JsonRef(json_schema['$ref']))
+            if referenced_json_schema is None:
+                # This can happen when building schemas for models with not-yet-defined references.
+                # It may be a good idea to do a recursive pass at the end of the generation to remove
+                # any redundant override keys.
+                if len(json_schema) > 1:
+                    # Make it an allOf to at least resolve the sibling keys issue
+                    json_schema = json_schema.copy()
+                    json_schema.setdefault('allOf', [])
+                    json_schema['allOf'].append({'$ref': json_schema['$ref']})
+                    del json_schema['$ref']
+
+                return json_schema
+            for k, v in list(json_schema.items()):
+                if k == '$ref':
+                    continue
+                if k in referenced_json_schema and referenced_json_schema[k] == v:
+                    del json_schema[k]  # redundant key
+            if len(json_schema) > 1:
+                # There is a remaining "override" key, so we need to move $ref out of the top level
+                json_ref = JsonRef(json_schema['$ref'])
+                del json_schema['$ref']
+                assert 'allOf' not in json_schema  # this should never happen, but just in case
+                json_schema['allOf'] = [{'$ref': json_ref}]
+
+        return json_schema
+
+    def get_schema_from_definitions(self, json_ref: JsonRef) -> JsonSchemaValue | None:
+        def_ref = self.json_to_defs_refs[json_ref]
+        if def_ref in self._core_defs_invalid_for_json_schema:
+            raise self._core_defs_invalid_for_json_schema[def_ref]
+        return self.definitions.get(def_ref, None)
+
+    def encode_default(self, dft: Any) -> Any:
+        """Encode a default value to a JSON-serializable value.
+
+        This is used to encode default values for fields in the generated JSON schema.
+
+        Args:
+            dft: The default value to encode.
+
+        Returns:
+            The encoded default value.
+        """
+        config = self._config
+        return pydantic_core.to_jsonable_python(
+            dft,
+            timedelta_mode=config.ser_json_timedelta,
+            bytes_mode=config.ser_json_bytes,
+        )
+
+    def update_with_validations(
+        self, json_schema: JsonSchemaValue, core_schema: CoreSchema, mapping: dict[str, str]
+    ) -> None:
+        """Update the json_schema with the corresponding validations specified in the core_schema,
+        using the provided mapping to translate keys in core_schema to the appropriate keys for a JSON schema.
+
+        Args:
+            json_schema: The JSON schema to update.
+            core_schema: The core schema to get the validations from.
+            mapping: A mapping from core_schema attribute names to the corresponding JSON schema attribute names.
+        """
+        for core_key, json_schema_key in mapping.items():
+            if core_key in core_schema:
+                json_schema[json_schema_key] = core_schema[core_key]
+
+    class ValidationsMapping:
+        """This class just contains mappings from core_schema attribute names to the corresponding
+        JSON schema attribute names. While I suspect it is unlikely to be necessary, you can in
+        principle override this class in a subclass of GenerateJsonSchema (by inheriting from
+        GenerateJsonSchema.ValidationsMapping) to change these mappings.
+        """
+
+        numeric = {
+            'multiple_of': 'multipleOf',
+            'le': 'maximum',
+            'ge': 'minimum',
+            'lt': 'exclusiveMaximum',
+            'gt': 'exclusiveMinimum',
+        }
+        bytes = {
+            'min_length': 'minLength',
+            'max_length': 'maxLength',
+        }
+        string = {
+            'min_length': 'minLength',
+            'max_length': 'maxLength',
+            'pattern': 'pattern',
+        }
+        array = {
+            'min_length': 'minItems',
+            'max_length': 'maxItems',
+        }
+        object = {
+            'min_length': 'minProperties',
+            'max_length': 'maxProperties',
+        }
+        date = {
+            'le': 'maximum',
+            'ge': 'minimum',
+            'lt': 'exclusiveMaximum',
+            'gt': 'exclusiveMinimum',
+        }
+
+    def get_flattened_anyof(self, schemas: list[JsonSchemaValue]) -> JsonSchemaValue:
+        members = []
+        for schema in schemas:
+            if len(schema) == 1 and 'anyOf' in schema:
+                members.extend(schema['anyOf'])
+            else:
+                members.append(schema)
+        members = _deduplicate_schemas(members)
+        if len(members) == 1:
+            return members[0]
+        return {'anyOf': members}
+
+    def get_json_ref_counts(self, json_schema: JsonSchemaValue) -> dict[JsonRef, int]:
+        """Get all values corresponding to the key '$ref' anywhere in the json_schema."""
+        json_refs: dict[JsonRef, int] = Counter()
+
+        def _add_json_refs(schema: Any) -> None:
+            if isinstance(schema, dict):
+                if '$ref' in schema:
+                    json_ref = JsonRef(schema['$ref'])
+                    if not isinstance(json_ref, str):
+                        return  # in this case, '$ref' might have been the name of a property
+                    already_visited = json_ref in json_refs
+                    json_refs[json_ref] += 1
+                    if already_visited:
+                        return  # prevent recursion on a definition that was already visited
+                    defs_ref = self.json_to_defs_refs[json_ref]
+                    if defs_ref in self._core_defs_invalid_for_json_schema:
+                        raise self._core_defs_invalid_for_json_schema[defs_ref]
+                    _add_json_refs(self.definitions[defs_ref])
+
+                for v in schema.values():
+                    _add_json_refs(v)
+            elif isinstance(schema, list):
+                for v in schema:
+                    _add_json_refs(v)
+
+        _add_json_refs(json_schema)
+        return json_refs
+
+    def handle_invalid_for_json_schema(self, schema: CoreSchemaOrField, error_info: str) -> JsonSchemaValue:
+        raise PydanticInvalidForJsonSchema(f'Cannot generate a JsonSchema for {error_info}')
+
+    def emit_warning(self, kind: JsonSchemaWarningKind, detail: str) -> None:
+        """This method simply emits PydanticJsonSchemaWarnings based on handling in the `warning_message` method."""
+        message = self.render_warning_message(kind, detail)
+        if message is not None:
+            warnings.warn(message, PydanticJsonSchemaWarning)
+
+    def render_warning_message(self, kind: JsonSchemaWarningKind, detail: str) -> str | None:
+        """This method is responsible for ignoring warnings as desired, and for formatting the warning messages.
+
+        You can override the value of `ignored_warning_kinds` in a subclass of GenerateJsonSchema
+        to modify what warnings are generated. If you want more control, you can override this method;
+        just return None in situations where you don't want warnings to be emitted.
+
+        Args:
+            kind: The kind of warning to render. It can be one of the following:
+
+                - 'skipped-choice': A choice field was skipped because it had no valid choices.
+                - 'non-serializable-default': A default value was skipped because it was not JSON-serializable.
+            detail: A string with additional details about the warning.
+
+        Returns:
+            The formatted warning message, or `None` if no warning should be emitted.
+        """
+        if kind in self.ignored_warning_kinds:
+            return None
+        return f'{detail} [{kind}]'
+
+    def _build_definitions_remapping(self) -> _DefinitionsRemapping:
+        defs_to_json: dict[DefsRef, JsonRef] = {}
+        for defs_refs in self._prioritized_defsref_choices.values():
+            for defs_ref in defs_refs:
+                json_ref = JsonRef(self.ref_template.format(model=defs_ref))
+                defs_to_json[defs_ref] = json_ref
+
+        return _DefinitionsRemapping.from_prioritized_choices(
+            self._prioritized_defsref_choices, defs_to_json, self.definitions
+        )
+
+    def _garbage_collect_definitions(self, schema: JsonSchemaValue) -> None:
+        visited_defs_refs: set[DefsRef] = set()
+        unvisited_json_refs = _get_all_json_refs(schema)
+        while unvisited_json_refs:
+            next_json_ref = unvisited_json_refs.pop()
+            next_defs_ref = self.json_to_defs_refs[next_json_ref]
+            if next_defs_ref in visited_defs_refs:
+                continue
+            visited_defs_refs.add(next_defs_ref)
+            unvisited_json_refs.update(_get_all_json_refs(self.definitions[next_defs_ref]))
+
+        self.definitions = {k: v for k, v in self.definitions.items() if k in visited_defs_refs}
+
+
+# ##### Start JSON Schema Generation Functions #####
+
+
+def model_json_schema(
+    cls: type[BaseModel] | type[PydanticDataclass],
+    by_alias: bool = True,
+    ref_template: str = DEFAULT_REF_TEMPLATE,
+    schema_generator: type[GenerateJsonSchema] = GenerateJsonSchema,
+    mode: JsonSchemaMode = 'validation',
+) -> dict[str, Any]:
+    """Utility function to generate a JSON Schema for a model.
+
+    Args:
+        cls: The model class to generate a JSON Schema for.
+        by_alias: If `True` (the default), fields will be serialized according to their alias.
+            If `False`, fields will be serialized according to their attribute name.
+        ref_template: The template to use for generating JSON Schema references.
+        schema_generator: The class to use for generating the JSON Schema.
+        mode: The mode to use for generating the JSON Schema. It can be one of the following:
+
+            - 'validation': Generate a JSON Schema for validating data.
+            - 'serialization': Generate a JSON Schema for serializing data.
+
+    Returns:
+        The generated JSON Schema.
+    """
+    schema_generator_instance = schema_generator(by_alias=by_alias, ref_template=ref_template)
+    if isinstance(cls.__pydantic_validator__, _mock_val_ser.MockValSer):
+        cls.__pydantic_validator__.rebuild()
+    assert '__pydantic_core_schema__' in cls.__dict__, 'this is a bug! please report it'
+    return schema_generator_instance.generate(cls.__pydantic_core_schema__, mode=mode)
+
+
+def models_json_schema(
+    models: Sequence[tuple[type[BaseModel] | type[PydanticDataclass], JsonSchemaMode]],
+    *,
+    by_alias: bool = True,
+    title: str | None = None,
+    description: str | None = None,
+    ref_template: str = DEFAULT_REF_TEMPLATE,
+    schema_generator: type[GenerateJsonSchema] = GenerateJsonSchema,
+) -> tuple[dict[tuple[type[BaseModel] | type[PydanticDataclass], JsonSchemaMode], JsonSchemaValue], JsonSchemaValue]:
+    """Utility function to generate a JSON Schema for multiple models.
+
+    Args:
+        models: A sequence of tuples of the form (model, mode).
+        by_alias: Whether field aliases should be used as keys in the generated JSON Schema.
+        title: The title of the generated JSON Schema.
+        description: The description of the generated JSON Schema.
+        ref_template: The reference template to use for generating JSON Schema references.
+        schema_generator: The schema generator to use for generating the JSON Schema.
+
+    Returns:
+        A tuple where:
+            - The first element is a dictionary whose keys are tuples of JSON schema key type and JSON mode, and
+                whose values are the JSON schema corresponding to that pair of inputs. (These schemas may have
+                JsonRef references to definitions that are defined in the second returned element.)
+            - The second element is a JSON schema containing all definitions referenced in the first returned
+                    element, along with the optional title and description keys.
+    """
+    for cls, _ in models:
+        if isinstance(cls.__pydantic_validator__, _mock_val_ser.MockValSer):
+            cls.__pydantic_validator__.rebuild()
+
+    instance = schema_generator(by_alias=by_alias, ref_template=ref_template)
+    inputs = [(m, mode, m.__pydantic_core_schema__) for m, mode in models]
+    json_schemas_map, definitions = instance.generate_definitions(inputs)
+
+    json_schema: dict[str, Any] = {}
+    if definitions:
+        json_schema['$defs'] = definitions
+    if title:
+        json_schema['title'] = title
+    if description:
+        json_schema['description'] = description
+
+    return json_schemas_map, json_schema
+
+
+# ##### End JSON Schema Generation Functions #####
+
+
+_HashableJsonValue: TypeAlias = Union[
+    int, float, str, bool, None, Tuple['_HashableJsonValue', ...], Tuple[Tuple[str, '_HashableJsonValue'], ...]
+]
+
+
+def _deduplicate_schemas(schemas: Iterable[JsonDict]) -> list[JsonDict]:
+    return list({_make_json_hashable(schema): schema for schema in schemas}.values())
+
+
+def _make_json_hashable(value: JsonValue) -> _HashableJsonValue:
+    if isinstance(value, dict):
+        return tuple(sorted((k, _make_json_hashable(v)) for k, v in value.items()))
+    elif isinstance(value, list):
+        return tuple(_make_json_hashable(v) for v in value)
+    else:
+        return value
+
+
+def _sort_json_schema(value: JsonSchemaValue, parent_key: str | None = None) -> JsonSchemaValue:
+    if isinstance(value, dict):
+        sorted_dict: dict[str, JsonSchemaValue] = {}
+        keys = value.keys()
+        if (parent_key != 'properties') and (parent_key != 'default'):
+            keys = sorted(keys)
+        for key in keys:
+            sorted_dict[key] = _sort_json_schema(value[key], parent_key=key)
+        return sorted_dict
+    elif isinstance(value, list):
+        sorted_list: list[JsonSchemaValue] = []
+        for item in value:  # type: ignore
+            sorted_list.append(_sort_json_schema(item, parent_key))
+        return sorted_list  # type: ignore
+    else:
+        return value
+
+
+@dataclasses.dataclass(**_internal_dataclass.slots_true)
+class WithJsonSchema:
+    """Usage docs: https://docs.pydantic.dev/2.6/concepts/json_schema/#withjsonschema-annotation
+
+    Add this as an annotation on a field to override the (base) JSON schema that would be generated for that field.
+    This provides a way to set a JSON schema for types that would otherwise raise errors when producing a JSON schema,
+    such as Callable, or types that have an is-instance core schema, without needing to go so far as creating a
+    custom subclass of pydantic.json_schema.GenerateJsonSchema.
+    Note that any _modifications_ to the schema that would normally be made (such as setting the title for model fields)
+    will still be performed.
+
+    If `mode` is set this will only apply to that schema generation mode, allowing you
+    to set different json schemas for validation and serialization.
+    """
+
+    json_schema: JsonSchemaValue | None
+    mode: Literal['validation', 'serialization'] | None = None
+
+    def __get_pydantic_json_schema__(
+        self, core_schema: core_schema.CoreSchema, handler: GetJsonSchemaHandler
+    ) -> JsonSchemaValue:
+        mode = self.mode or handler.mode
+        if mode != handler.mode:
+            return handler(core_schema)
+        if self.json_schema is None:
+            # This exception is handled in pydantic.json_schema.GenerateJsonSchema._named_required_fields_schema
+            raise PydanticOmit
+        else:
+            return self.json_schema
+
+    def __hash__(self) -> int:
+        return hash(type(self.mode))
+
+
+@dataclasses.dataclass(**_internal_dataclass.slots_true)
+class Examples:
+    """Add examples to a JSON schema.
+
+    Examples should be a map of example names (strings)
+    to example values (any valid JSON).
+
+    If `mode` is set this will only apply to that schema generation mode,
+    allowing you to add different examples for validation and serialization.
+    """
+
+    examples: dict[str, Any]
+    mode: Literal['validation', 'serialization'] | None = None
+
+    def __get_pydantic_json_schema__(
+        self, core_schema: core_schema.CoreSchema, handler: GetJsonSchemaHandler
+    ) -> JsonSchemaValue:
+        mode = self.mode or handler.mode
+        json_schema = handler(core_schema)
+        if mode != handler.mode:
+            return json_schema
+        examples = json_schema.get('examples', {})
+        examples.update(to_jsonable_python(self.examples))
+        json_schema['examples'] = examples
+        return json_schema
+
+    def __hash__(self) -> int:
+        return hash(type(self.mode))
+
+
+def _get_all_json_refs(item: Any) -> set[JsonRef]:
+    """Get all the definitions references from a JSON schema."""
+    refs: set[JsonRef] = set()
+    if isinstance(item, dict):
+        for key, value in item.items():
+            if key == '$ref' and isinstance(value, str):
+                # the isinstance check ensures that '$ref' isn't the name of a property, etc.
+                refs.add(JsonRef(value))
+            elif isinstance(value, dict):
+                refs.update(_get_all_json_refs(value))
+            elif isinstance(value, list):
+                for item in value:
+                    refs.update(_get_all_json_refs(item))
+    elif isinstance(item, list):
+        for item in item:
+            refs.update(_get_all_json_refs(item))
+    return refs
+
+
+AnyType = TypeVar('AnyType')
+
+if TYPE_CHECKING:
+    SkipJsonSchema = Annotated[AnyType, ...]
+else:
+
+    @dataclasses.dataclass(**_internal_dataclass.slots_true)
+    class SkipJsonSchema:
+        """Usage docs: https://docs.pydantic.dev/2.6/concepts/json_schema/#skipjsonschema-annotation
+
+        Add this as an annotation on a field to skip generating a JSON schema for that field.
+
+        Example:
+            ```py
+            from typing import Union
+
+            from pydantic import BaseModel
+            from pydantic.json_schema import SkipJsonSchema
+
+            from pprint import pprint
+
+
+            class Model(BaseModel):
+                a: Union[int, None] = None  # (1)!
+                b: Union[int, SkipJsonSchema[None]] = None  # (2)!
+                c: SkipJsonSchema[Union[int, None]] = None  # (3)!
+
+
+            pprint(Model.model_json_schema())
+            '''
+            {
+                'properties': {
+                    'a': {
+                        'anyOf': [
+                            {'type': 'integer'},
+                            {'type': 'null'}
+                        ],
+                        'default': None,
+                        'title': 'A'
+                    },
+                    'b': {
+                        'default': None,
+                        'title': 'B',
+                        'type': 'integer'
+                    }
+                },
+                'title': 'Model',
+                'type': 'object'
+            }
+            '''
+            ```
+
+            1. The integer and null types are both included in the schema for `a`.
+            2. The integer type is the only type included in the schema for `b`.
+            3. The entirety of the `c` field is omitted from the schema.
+        """
+
+        def __class_getitem__(cls, item: AnyType) -> AnyType:
+            return Annotated[item, cls()]
+
+        def __get_pydantic_json_schema__(
+            self, core_schema: CoreSchema, handler: GetJsonSchemaHandler
+        ) -> JsonSchemaValue:
+            raise PydanticOmit
+
+        def __hash__(self) -> int:
+            return hash(type(self))
+
+
+def _get_typed_dict_config(schema: core_schema.TypedDictSchema) -> ConfigDict:
+    metadata = _core_metadata.CoreMetadataHandler(schema).metadata
+    cls = metadata.get('pydantic_typed_dict_cls')
+    if cls is not None:
+        try:
+            return _decorators.get_attribute_from_bases(cls, '__pydantic_config__')
+        except AttributeError:
+            pass
+    return {}
diff --git a/lib/pydantic/main.py b/lib/pydantic/main.py
index 69f3b751..8c7ebbbf 100644
--- a/lib/pydantic/main.py
+++ b/lib/pydantic/main.py
@@ -1,980 +1,1434 @@
+"""Logic for creating models."""
+from __future__ import annotations as _annotations
+
+import operator
+import sys
+import types
+import typing
 import warnings
-from abc import ABCMeta
-from copy import deepcopy
-from enum import Enum
-from functools import partial
-from pathlib import Path
-from types import FunctionType, prepare_class, resolve_bases
-from typing import (
-    TYPE_CHECKING,
-    AbstractSet,
-    Any,
-    Callable,
-    ClassVar,
-    Dict,
-    List,
-    Mapping,
-    Optional,
-    Tuple,
-    Type,
-    TypeVar,
-    Union,
-    cast,
-    no_type_check,
-    overload,
-)
+from copy import copy, deepcopy
+from typing import Any, ClassVar
 
-from typing_extensions import dataclass_transform
+import pydantic_core
+import typing_extensions
+from pydantic_core import PydanticUndefined
 
-from .class_validators import ValidatorGroup, extract_root_validators, extract_validators, inherit_validators
-from .config import BaseConfig, Extra, inherit_config, prepare_config
-from .error_wrappers import ErrorWrapper, ValidationError
-from .errors import ConfigError, DictError, ExtraError, MissingError
-from .fields import (
-    MAPPING_LIKE_SHAPES,
-    Field,
-    FieldInfo,
-    ModelField,
-    ModelPrivateAttr,
-    PrivateAttr,
-    Undefined,
-    is_finalvar_with_default_val,
-)
-from .json import custom_pydantic_encoder, pydantic_encoder
-from .parse import Protocol, load_file, load_str_bytes
-from .schema import default_ref_template, model_schema
-from .types import PyObject, StrBytes
-from .typing import (
-    AnyCallable,
-    get_args,
-    get_origin,
-    is_classvar,
-    is_namedtuple,
-    is_union,
-    resolve_annotations,
-    update_model_forward_refs,
-)
-from .utils import (
-    DUNDER_ATTRIBUTES,
-    ROOT_KEY,
-    ClassAttribute,
-    GetterDict,
-    Representation,
-    ValueItems,
-    generate_model_signature,
-    is_valid_field,
-    is_valid_private_name,
-    lenient_issubclass,
-    sequence_like,
-    smart_deepcopy,
-    unique_list,
-    validate_field_name,
+from ._internal import (
+    _config,
+    _decorators,
+    _fields,
+    _forward_ref,
+    _generics,
+    _mock_val_ser,
+    _model_construction,
+    _repr,
+    _typing_extra,
+    _utils,
 )
+from ._migration import getattr_migration
+from .annotated_handlers import GetCoreSchemaHandler, GetJsonSchemaHandler
+from .config import ConfigDict
+from .errors import PydanticUndefinedAnnotation, PydanticUserError
+from .json_schema import DEFAULT_REF_TEMPLATE, GenerateJsonSchema, JsonSchemaMode, JsonSchemaValue, model_json_schema
+from .warnings import PydanticDeprecatedSince20
 
-if TYPE_CHECKING:
+if typing.TYPE_CHECKING:
     from inspect import Signature
+    from pathlib import Path
 
-    from .class_validators import ValidatorListDict
-    from .types import ModelOrDc
-    from .typing import (
-        AbstractSetIntStr,
-        AnyClassMethod,
-        CallableGenerator,
-        DictAny,
-        DictStrAny,
-        MappingIntStrAny,
-        ReprArgs,
-        SetStr,
-        TupleGenerator,
-    )
+    from pydantic_core import CoreSchema, SchemaSerializer, SchemaValidator
+    from typing_extensions import Literal, Unpack
 
-    Model = TypeVar('Model', bound='BaseModel')
+    from ._internal._utils import AbstractSetIntStr, MappingIntStrAny
+    from .deprecated.parse import Protocol as DeprecatedParseProtocol
+    from .fields import ComputedFieldInfo, FieldInfo, ModelPrivateAttr
+    from .fields import Field as _Field
 
-__all__ = 'BaseModel', 'create_model', 'validate_model'
+    TupleGenerator = typing.Generator[typing.Tuple[str, Any], None, None]
+    Model = typing.TypeVar('Model', bound='BaseModel')
+    # should be `set[int] | set[str] | dict[int, IncEx] | dict[str, IncEx] | None`, but mypy can't cope
+    IncEx: typing_extensions.TypeAlias = 'set[int] | set[str] | dict[int, Any] | dict[str, Any] | None'
+else:
+    # See PyCharm issues https://youtrack.jetbrains.com/issue/PY-21915
+    # and https://youtrack.jetbrains.com/issue/PY-51428
+    DeprecationWarning = PydanticDeprecatedSince20
 
-_T = TypeVar('_T')
+__all__ = 'BaseModel', 'create_model'
+
+_object_setattr = _model_construction.object_setattr
 
 
-def validate_custom_root_type(fields: Dict[str, ModelField]) -> None:
-    if len(fields) > 1:
-        raise ValueError(f'{ROOT_KEY} cannot be mixed with other fields')
+class BaseModel(metaclass=_model_construction.ModelMetaclass):
+    """Usage docs: https://docs.pydantic.dev/2.6/concepts/models/
 
+    A base class for creating Pydantic models.
 
-def generate_hash_function(frozen: bool) -> Optional[Callable[[Any], int]]:
-    def hash_function(self_: Any) -> int:
-        return hash(self_.__class__) + hash(tuple(self_.__dict__.values()))
+    Attributes:
+        __class_vars__: The names of classvars defined on the model.
+        __private_attributes__: Metadata about the private attributes of the model.
+        __signature__: The signature for instantiating the model.
 
-    return hash_function if frozen else None
+        __pydantic_complete__: Whether model building is completed, or if there are still undefined fields.
+        __pydantic_core_schema__: The pydantic-core schema used to build the SchemaValidator and SchemaSerializer.
+        __pydantic_custom_init__: Whether the model has a custom `__init__` function.
+        __pydantic_decorators__: Metadata containing the decorators defined on the model.
+            This replaces `Model.__validators__` and `Model.__root_validators__` from Pydantic V1.
+        __pydantic_generic_metadata__: Metadata for generic models; contains data used for a similar purpose to
+            __args__, __origin__, __parameters__ in typing-module generics. May eventually be replaced by these.
+        __pydantic_parent_namespace__: Parent namespace of the model, used for automatic rebuilding of models.
+        __pydantic_post_init__: The name of the post-init method for the model, if defined.
+        __pydantic_root_model__: Whether the model is a `RootModel`.
+        __pydantic_serializer__: The pydantic-core SchemaSerializer used to dump instances of the model.
+        __pydantic_validator__: The pydantic-core SchemaValidator used to validate instances of the model.
 
+        __pydantic_extra__: An instance attribute with the values of extra fields from validation when
+            `model_config['extra'] == 'allow'`.
+        __pydantic_fields_set__: An instance attribute with the names of fields explicitly set.
+        __pydantic_private__: Instance attribute with the values of private attributes set on the model instance.
+    """
 
-# If a field is of type `Callable`, its default value should be a function and cannot to ignored.
-ANNOTATED_FIELD_UNTOUCHED_TYPES: Tuple[Any, ...] = (property, type, classmethod, staticmethod)
-# When creating a `BaseModel` instance, we bypass all the methods, properties... added to the model
-UNTOUCHED_TYPES: Tuple[Any, ...] = (FunctionType,) + ANNOTATED_FIELD_UNTOUCHED_TYPES
-# Note `ModelMetaclass` refers to `BaseModel`, but is also used to *create* `BaseModel`, so we need to add this extra
-# (somewhat hacky) boolean to keep track of whether we've created the `BaseModel` class yet, and therefore whether it's
-# safe to refer to it. If it *hasn't* been created, we assume that the `__new__` call we're in the middle of is for
-# the `BaseModel` class, since that's defined immediately after the metaclass.
-_is_base_model_class_defined = False
+    if typing.TYPE_CHECKING:
+        # Here we provide annotations for the attributes of BaseModel.
+        # Many of these are populated by the metaclass, which is why this section is in a `TYPE_CHECKING` block.
+        # However, for the sake of easy review, we have included type annotations of all class and instance attributes
+        # of `BaseModel` here:
 
+        # Class attributes
+        model_config: ClassVar[ConfigDict]
+        """
+        Configuration for the model, should be a dictionary conforming to [`ConfigDict`][pydantic.config.ConfigDict].
+        """
 
-@dataclass_transform(kw_only_default=True, field_descriptors=(Field, FieldInfo))
-class ModelMetaclass(ABCMeta):
-    @no_type_check  # noqa C901
-    def __new__(mcs, name, bases, namespace, **kwargs):  # noqa C901
-        fields: Dict[str, ModelField] = {}
-        config = BaseConfig
-        validators: 'ValidatorListDict' = {}
+        model_fields: ClassVar[dict[str, FieldInfo]]
+        """
+        Metadata about the fields defined on the model,
+        mapping of field names to [`FieldInfo`][pydantic.fields.FieldInfo].
 
-        pre_root_validators, post_root_validators = [], []
-        private_attributes: Dict[str, ModelPrivateAttr] = {}
-        base_private_attributes: Dict[str, ModelPrivateAttr] = {}
-        slots: SetStr = namespace.get('__slots__', ())
-        slots = {slots} if isinstance(slots, str) else set(slots)
-        class_vars: SetStr = set()
-        hash_func: Optional[Callable[[Any], int]] = None
+        This replaces `Model.__fields__` from Pydantic V1.
+        """
 
-        for base in reversed(bases):
-            if _is_base_model_class_defined and issubclass(base, BaseModel) and base != BaseModel:
-                fields.update(smart_deepcopy(base.__fields__))
-                config = inherit_config(base.__config__, config)
-                validators = inherit_validators(base.__validators__, validators)
-                pre_root_validators += base.__pre_root_validators__
-                post_root_validators += base.__post_root_validators__
-                base_private_attributes.update(base.__private_attributes__)
-                class_vars.update(base.__class_vars__)
-                hash_func = base.__hash__
+        model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]]
+        """A dictionary of computed field names and their corresponding `ComputedFieldInfo` objects."""
 
-        resolve_forward_refs = kwargs.pop('__resolve_forward_refs__', True)
-        allowed_config_kwargs: SetStr = {
-            key
-            for key in dir(config)
-            if not (key.startswith('__') and key.endswith('__'))  # skip dunder methods and attributes
-        }
-        config_kwargs = {key: kwargs.pop(key) for key in kwargs.keys() & allowed_config_kwargs}
-        config_from_namespace = namespace.get('Config')
-        if config_kwargs and config_from_namespace:
-            raise TypeError('Specifying config in two places is ambiguous, use either Config attribute or class kwargs')
-        config = inherit_config(config_from_namespace, config, **config_kwargs)
+        __class_vars__: ClassVar[set[str]]
+        __private_attributes__: ClassVar[dict[str, ModelPrivateAttr]]
+        __signature__: ClassVar[Signature]
 
-        validators = inherit_validators(extract_validators(namespace), validators)
-        vg = ValidatorGroup(validators)
+        __pydantic_complete__: ClassVar[bool]
+        __pydantic_core_schema__: ClassVar[CoreSchema]
+        __pydantic_custom_init__: ClassVar[bool]
+        __pydantic_decorators__: ClassVar[_decorators.DecoratorInfos]
+        __pydantic_generic_metadata__: ClassVar[_generics.PydanticGenericMetadata]
+        __pydantic_parent_namespace__: ClassVar[dict[str, Any] | None]
+        __pydantic_post_init__: ClassVar[None | Literal['model_post_init']]
+        __pydantic_root_model__: ClassVar[bool]
+        __pydantic_serializer__: ClassVar[SchemaSerializer]
+        __pydantic_validator__: ClassVar[SchemaValidator]
 
-        for f in fields.values():
-            f.set_config(config)
-            extra_validators = vg.get_validators(f.name)
-            if extra_validators:
-                f.class_validators.update(extra_validators)
-                # re-run prepare to add extra validators
-                f.populate_validators()
+        # Instance attributes
+        # Note: we use the non-existent kwarg `init=False` in pydantic.fields.Field below so that @dataclass_transform
+        # doesn't think these are valid as keyword arguments to the class initializer.
+        __pydantic_extra__: dict[str, Any] | None = _Field(init=False)  # type: ignore
+        __pydantic_fields_set__: set[str] = _Field(init=False)  # type: ignore
+        __pydantic_private__: dict[str, Any] | None = _Field(init=False)  # type: ignore
 
-        prepare_config(config, name)
+    else:
+        # `model_fields` and `__pydantic_decorators__` must be set for
+        # pydantic._internal._generate_schema.GenerateSchema.model_schema to work for a plain BaseModel annotation
+        model_fields = {}
+        model_computed_fields = {}
 
-        untouched_types = ANNOTATED_FIELD_UNTOUCHED_TYPES
+        __pydantic_decorators__ = _decorators.DecoratorInfos()
+        __pydantic_parent_namespace__ = None
+        # Prevent `BaseModel` from being instantiated directly:
+        __pydantic_validator__ = _mock_val_ser.MockValSer(
+            'Pydantic models should inherit from BaseModel, BaseModel cannot be instantiated directly',
+            val_or_ser='validator',
+            code='base-model-instantiated',
+        )
+        __pydantic_serializer__ = _mock_val_ser.MockValSer(
+            'Pydantic models should inherit from BaseModel, BaseModel cannot be instantiated directly',
+            val_or_ser='serializer',
+            code='base-model-instantiated',
+        )
 
-        def is_untouched(v: Any) -> bool:
-            return isinstance(v, untouched_types) or v.__class__.__name__ == 'cython_function_or_method'
+    __slots__ = '__dict__', '__pydantic_fields_set__', '__pydantic_extra__', '__pydantic_private__'
 
-        if (namespace.get('__module__'), namespace.get('__qualname__')) != ('pydantic.main', 'BaseModel'):
-            annotations = resolve_annotations(namespace.get('__annotations__', {}), namespace.get('__module__', None))
-            # annotation only fields need to come first in fields
-            for ann_name, ann_type in annotations.items():
-                if is_classvar(ann_type):
-                    class_vars.add(ann_name)
-                elif is_finalvar_with_default_val(ann_type, namespace.get(ann_name, Undefined)):
-                    class_vars.add(ann_name)
-                elif is_valid_field(ann_name):
-                    validate_field_name(bases, ann_name)
-                    value = namespace.get(ann_name, Undefined)
-                    allowed_types = get_args(ann_type) if is_union(get_origin(ann_type)) else (ann_type,)
-                    if (
-                        is_untouched(value)
-                        and ann_type != PyObject
-                        and not any(
-                            lenient_issubclass(get_origin(allowed_type), Type) for allowed_type in allowed_types
-                        )
-                    ):
-                        continue
-                    fields[ann_name] = ModelField.infer(
-                        name=ann_name,
-                        value=value,
-                        annotation=ann_type,
-                        class_validators=vg.get_validators(ann_name),
-                        config=config,
-                    )
-                elif ann_name not in namespace and config.underscore_attrs_are_private:
-                    private_attributes[ann_name] = PrivateAttr()
+    model_config = ConfigDict()
+    __pydantic_complete__ = False
+    __pydantic_root_model__ = False
 
-            untouched_types = UNTOUCHED_TYPES + config.keep_untouched
-            for var_name, value in namespace.items():
-                can_be_changed = var_name not in class_vars and not is_untouched(value)
-                if isinstance(value, ModelPrivateAttr):
-                    if not is_valid_private_name(var_name):
-                        raise NameError(
-                            f'Private attributes "{var_name}" must not be a valid field name; '
-                            f'Use sunder or dunder names, e. g. "_{var_name}" or "__{var_name}__"'
-                        )
-                    private_attributes[var_name] = value
-                elif config.underscore_attrs_are_private and is_valid_private_name(var_name) and can_be_changed:
-                    private_attributes[var_name] = PrivateAttr(default=value)
-                elif is_valid_field(var_name) and var_name not in annotations and can_be_changed:
-                    validate_field_name(bases, var_name)
-                    inferred = ModelField.infer(
-                        name=var_name,
-                        value=value,
-                        annotation=annotations.get(var_name, Undefined),
-                        class_validators=vg.get_validators(var_name),
-                        config=config,
-                    )
-                    if var_name in fields:
-                        if lenient_issubclass(inferred.type_, fields[var_name].type_):
-                            inferred.type_ = fields[var_name].type_
-                        else:
-                            raise TypeError(
-                                f'The type of {name}.{var_name} differs from the new default value; '
-                                f'if you wish to change the type of this field, please use a type annotation'
-                            )
-                    fields[var_name] = inferred
+    def __init__(self, /, **data: Any) -> None:  # type: ignore
+        """Create a new model by parsing and validating input data from keyword arguments.
 
-        _custom_root_type = ROOT_KEY in fields
-        if _custom_root_type:
-            validate_custom_root_type(fields)
-        vg.check_for_unused()
-        if config.json_encoders:
-            json_encoder = partial(custom_pydantic_encoder, config.json_encoders)
+        Raises [`ValidationError`][pydantic_core.ValidationError] if the input data cannot be
+        validated to form a valid model.
+
+        `self` is explicitly positional-only to allow `self` as a field name.
+        """
+        # `__tracebackhide__` tells pytest and some other tools to omit this function from tracebacks
+        __tracebackhide__ = True
+        self.__pydantic_validator__.validate_python(data, self_instance=self)
+
+    # The following line sets a flag that we use to determine when `__init__` gets overridden by the user
+    __init__.__pydantic_base_init__ = True  # pyright: ignore[reportFunctionMemberAccess]
+
+    @property
+    def model_extra(self) -> dict[str, Any] | None:
+        """Get extra fields set during validation.
+
+        Returns:
+            A dictionary of extra fields, or `None` if `config.extra` is not set to `"allow"`.
+        """
+        return self.__pydantic_extra__
+
+    @property
+    def model_fields_set(self) -> set[str]:
+        """Returns the set of fields that have been explicitly set on this model instance.
+
+        Returns:
+            A set of strings representing the fields that have been set,
+                i.e. that were not filled from defaults.
+        """
+        return self.__pydantic_fields_set__
+
+    @classmethod
+    def model_construct(cls: type[Model], _fields_set: set[str] | None = None, **values: Any) -> Model:
+        """Creates a new instance of the `Model` class with validated data.
+
+        Creates a new model setting `__dict__` and `__pydantic_fields_set__` from trusted or pre-validated data.
+        Default values are respected, but no other validation is performed.
+        Behaves as if `Config.extra = 'allow'` was set since it adds all passed values
+
+        Args:
+            _fields_set: The set of field names accepted for the Model instance.
+            values: Trusted or pre-validated data dictionary.
+
+        Returns:
+            A new instance of the `Model` class with validated data.
+        """
+        m = cls.__new__(cls)
+        fields_values: dict[str, Any] = {}
+        fields_set = set()
+
+        for name, field in cls.model_fields.items():
+            if field.alias and field.alias in values:
+                fields_values[name] = values.pop(field.alias)
+                fields_set.add(name)
+            elif name in values:
+                fields_values[name] = values.pop(name)
+                fields_set.add(name)
+            elif not field.is_required():
+                fields_values[name] = field.get_default(call_default_factory=True)
+        if _fields_set is None:
+            _fields_set = fields_set
+
+        _extra: dict[str, Any] | None = None
+        if cls.model_config.get('extra') == 'allow':
+            _extra = {}
+            for k, v in values.items():
+                _extra[k] = v
         else:
-            json_encoder = pydantic_encoder
-        pre_rv_new, post_rv_new = extract_root_validators(namespace)
+            fields_values.update(values)
+        _object_setattr(m, '__dict__', fields_values)
+        _object_setattr(m, '__pydantic_fields_set__', _fields_set)
+        if not cls.__pydantic_root_model__:
+            _object_setattr(m, '__pydantic_extra__', _extra)
 
-        if hash_func is None:
-            hash_func = generate_hash_function(config.frozen)
+        if cls.__pydantic_post_init__:
+            m.model_post_init(None)
+            # update private attributes with values set
+            if hasattr(m, '__pydantic_private__') and m.__pydantic_private__ is not None:
+                for k, v in values.items():
+                    if k in m.__private_attributes__:
+                        m.__pydantic_private__[k] = v
 
-        exclude_from_namespace = fields | private_attributes.keys() | {'__slots__'}
-        new_namespace = {
-            '__config__': config,
-            '__fields__': fields,
-            '__exclude_fields__': {
-                name: field.field_info.exclude for name, field in fields.items() if field.field_info.exclude is not None
-            }
-            or None,
-            '__include_fields__': {
-                name: field.field_info.include for name, field in fields.items() if field.field_info.include is not None
-            }
-            or None,
-            '__validators__': vg.validators,
-            '__pre_root_validators__': unique_list(
-                pre_root_validators + pre_rv_new,
-                name_factory=lambda v: v.__name__,
-            ),
-            '__post_root_validators__': unique_list(
-                post_root_validators + post_rv_new,
-                name_factory=lambda skip_on_failure_and_v: skip_on_failure_and_v[1].__name__,
-            ),
-            '__schema_cache__': {},
-            '__json_encoder__': staticmethod(json_encoder),
-            '__custom_root_type__': _custom_root_type,
-            '__private_attributes__': {**base_private_attributes, **private_attributes},
-            '__slots__': slots | private_attributes.keys(),
-            '__hash__': hash_func,
-            '__class_vars__': class_vars,
-            **{n: v for n, v in namespace.items() if n not in exclude_from_namespace},
-        }
+        elif not cls.__pydantic_root_model__:
+            # Note: if there are any private attributes, cls.__pydantic_post_init__ would exist
+            # Since it doesn't, that means that `__pydantic_private__` should be set to None
+            _object_setattr(m, '__pydantic_private__', None)
 
-        cls = super().__new__(mcs, name, bases, new_namespace, **kwargs)
-        # set __signature__ attr only for model class, but not for its instances
-        cls.__signature__ = ClassAttribute('__signature__', generate_model_signature(cls.__init__, fields, config))
-        if resolve_forward_refs:
-            cls.__try_update_forward_refs__()
+        return m
 
-        # preserve `__set_name__` protocol defined in https://peps.python.org/pep-0487
-        # for attributes not in `new_namespace` (e.g. private attributes)
-        for name, obj in namespace.items():
-            if name not in new_namespace:
-                set_name = getattr(obj, '__set_name__', None)
-                if callable(set_name):
-                    set_name(cls, name)
+    def model_copy(self: Model, *, update: dict[str, Any] | None = None, deep: bool = False) -> Model:
+        """Usage docs: https://docs.pydantic.dev/2.6/concepts/serialization/#model_copy
 
-        return cls
+        Returns a copy of the model.
 
-    def __instancecheck__(self, instance: Any) -> bool:
+        Args:
+            update: Values to change/add in the new model. Note: the data is not validated
+                before creating the new model. You should trust this data.
+            deep: Set to `True` to make a deep copy of the model.
+
+        Returns:
+            New model instance.
         """
-        Avoid calling ABC _abc_subclasscheck unless we're pretty sure.
+        copied = self.__deepcopy__() if deep else self.__copy__()
+        if update:
+            if self.model_config.get('extra') == 'allow':
+                for k, v in update.items():
+                    if k in self.model_fields:
+                        copied.__dict__[k] = v
+                    else:
+                        if copied.__pydantic_extra__ is None:
+                            copied.__pydantic_extra__ = {}
+                        copied.__pydantic_extra__[k] = v
+            else:
+                copied.__dict__.update(update)
+            copied.__pydantic_fields_set__.update(update.keys())
+        return copied
 
-        See #3829 and python/cpython#92810
-        """
-        return hasattr(instance, '__fields__') and super().__instancecheck__(instance)
-
-
-object_setattr = object.__setattr__
-
-
-class BaseModel(Representation, metaclass=ModelMetaclass):
-    if TYPE_CHECKING:
-        # populated by the metaclass, defined here to help IDEs only
-        __fields__: ClassVar[Dict[str, ModelField]] = {}
-        __include_fields__: ClassVar[Optional[Mapping[str, Any]]] = None
-        __exclude_fields__: ClassVar[Optional[Mapping[str, Any]]] = None
-        __validators__: ClassVar[Dict[str, AnyCallable]] = {}
-        __pre_root_validators__: ClassVar[List[AnyCallable]]
-        __post_root_validators__: ClassVar[List[Tuple[bool, AnyCallable]]]
-        __config__: ClassVar[Type[BaseConfig]] = BaseConfig
-        __json_encoder__: ClassVar[Callable[[Any], Any]] = lambda x: x
-        __schema_cache__: ClassVar['DictAny'] = {}
-        __custom_root_type__: ClassVar[bool] = False
-        __signature__: ClassVar['Signature']
-        __private_attributes__: ClassVar[Dict[str, ModelPrivateAttr]]
-        __class_vars__: ClassVar[SetStr]
-        __fields_set__: ClassVar[SetStr] = set()
-
-    Config = BaseConfig
-    __slots__ = ('__dict__', '__fields_set__')
-    __doc__ = ''  # Null out the Representation docstring
-
-    def __init__(__pydantic_self__, **data: Any) -> None:
-        """
-        Create a new model by parsing and validating input data from keyword arguments.
-
-        Raises ValidationError if the input data cannot be parsed to form a valid model.
-        """
-        # Uses something other than `self` the first arg to allow "self" as a settable attribute
-        values, fields_set, validation_error = validate_model(__pydantic_self__.__class__, data)
-        if validation_error:
-            raise validation_error
-        try:
-            object_setattr(__pydantic_self__, '__dict__', values)
-        except TypeError as e:
-            raise TypeError(
-                'Model values must be a dict; you may not have returned a dictionary from a root validator'
-            ) from e
-        object_setattr(__pydantic_self__, '__fields_set__', fields_set)
-        __pydantic_self__._init_private_attributes()
-
-    @no_type_check
-    def __setattr__(self, name, value):  # noqa: C901 (ignore complexity)
-        if name in self.__private_attributes__ or name in DUNDER_ATTRIBUTES:
-            return object_setattr(self, name, value)
-
-        if self.__config__.extra is not Extra.allow and name not in self.__fields__:
-            raise ValueError(f'"{self.__class__.__name__}" object has no field "{name}"')
-        elif not self.__config__.allow_mutation or self.__config__.frozen:
-            raise TypeError(f'"{self.__class__.__name__}" is immutable and does not support item assignment')
-        elif name in self.__fields__ and self.__fields__[name].final:
-            raise TypeError(
-                f'"{self.__class__.__name__}" object "{name}" field is final and does not support reassignment'
-            )
-        elif self.__config__.validate_assignment:
-            new_values = {**self.__dict__, name: value}
-
-            for validator in self.__pre_root_validators__:
-                try:
-                    new_values = validator(self.__class__, new_values)
-                except (ValueError, TypeError, AssertionError) as exc:
-                    raise ValidationError([ErrorWrapper(exc, loc=ROOT_KEY)], self.__class__)
-
-            known_field = self.__fields__.get(name, None)
-            if known_field:
-                # We want to
-                # - make sure validators are called without the current value for this field inside `values`
-                # - keep other values (e.g. submodels) untouched (using `BaseModel.dict()` will change them into dicts)
-                # - keep the order of the fields
-                if not known_field.field_info.allow_mutation:
-                    raise TypeError(f'"{known_field.name}" has allow_mutation set to False and cannot be assigned')
-                dict_without_original_value = {k: v for k, v in self.__dict__.items() if k != name}
-                value, error_ = known_field.validate(value, dict_without_original_value, loc=name, cls=self.__class__)
-                if error_:
-                    raise ValidationError([error_], self.__class__)
-                else:
-                    new_values[name] = value
-
-            errors = []
-            for skip_on_failure, validator in self.__post_root_validators__:
-                if skip_on_failure and errors:
-                    continue
-                try:
-                    new_values = validator(self.__class__, new_values)
-                except (ValueError, TypeError, AssertionError) as exc:
-                    errors.append(ErrorWrapper(exc, loc=ROOT_KEY))
-            if errors:
-                raise ValidationError(errors, self.__class__)
-
-            # update the whole __dict__ as other values than just `value`
-            # may be changed (e.g. with `root_validator`)
-            object_setattr(self, '__dict__', new_values)
-        else:
-            self.__dict__[name] = value
-
-        self.__fields_set__.add(name)
-
-    def __getstate__(self) -> 'DictAny':
-        private_attrs = ((k, getattr(self, k, Undefined)) for k in self.__private_attributes__)
-        return {
-            '__dict__': self.__dict__,
-            '__fields_set__': self.__fields_set__,
-            '__private_attribute_values__': {k: v for k, v in private_attrs if v is not Undefined},
-        }
-
-    def __setstate__(self, state: 'DictAny') -> None:
-        object_setattr(self, '__dict__', state['__dict__'])
-        object_setattr(self, '__fields_set__', state['__fields_set__'])
-        for name, value in state.get('__private_attribute_values__', {}).items():
-            object_setattr(self, name, value)
-
-    def _init_private_attributes(self) -> None:
-        for name, private_attr in self.__private_attributes__.items():
-            default = private_attr.get_default()
-            if default is not Undefined:
-                object_setattr(self, name, default)
-
-    def dict(
+    def model_dump(
         self,
         *,
-        include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
-        exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
+        mode: Literal['json', 'python'] | str = 'python',
+        include: IncEx = None,
+        exclude: IncEx = None,
         by_alias: bool = False,
-        skip_defaults: Optional[bool] = None,
         exclude_unset: bool = False,
         exclude_defaults: bool = False,
         exclude_none: bool = False,
-    ) -> 'DictStrAny':
-        """
+        round_trip: bool = False,
+        warnings: bool = True,
+    ) -> dict[str, Any]:
+        """Usage docs: https://docs.pydantic.dev/2.6/concepts/serialization/#modelmodel_dump
+
         Generate a dictionary representation of the model, optionally specifying which fields to include or exclude.
 
-        """
-        if skip_defaults is not None:
-            warnings.warn(
-                f'{self.__class__.__name__}.dict(): "skip_defaults" is deprecated and replaced by "exclude_unset"',
-                DeprecationWarning,
-            )
-            exclude_unset = skip_defaults
+        Args:
+            mode: The mode in which `to_python` should run.
+                If mode is 'json', the output will only contain JSON serializable types.
+                If mode is 'python', the output may contain non-JSON-serializable Python objects.
+            include: A list of fields to include in the output.
+            exclude: A list of fields to exclude from the output.
+            by_alias: Whether to use the field's alias in the dictionary key if defined.
+            exclude_unset: Whether to exclude fields that have not been explicitly set.
+            exclude_defaults: Whether to exclude fields that are set to their default value.
+            exclude_none: Whether to exclude fields that have a value of `None`.
+            round_trip: If True, dumped values should be valid as input for non-idempotent types such as Json[T].
+            warnings: Whether to log warnings when invalid fields are encountered.
 
-        return dict(
-            self._iter(
-                to_dict=True,
-                by_alias=by_alias,
-                include=include,
-                exclude=exclude,
-                exclude_unset=exclude_unset,
-                exclude_defaults=exclude_defaults,
-                exclude_none=exclude_none,
-            )
+        Returns:
+            A dictionary representation of the model.
+        """
+        return self.__pydantic_serializer__.to_python(
+            self,
+            mode=mode,
+            by_alias=by_alias,
+            include=include,
+            exclude=exclude,
+            exclude_unset=exclude_unset,
+            exclude_defaults=exclude_defaults,
+            exclude_none=exclude_none,
+            round_trip=round_trip,
+            warnings=warnings,
         )
 
-    def json(
+    def model_dump_json(
         self,
         *,
-        include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
-        exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
+        indent: int | None = None,
+        include: IncEx = None,
+        exclude: IncEx = None,
         by_alias: bool = False,
-        skip_defaults: Optional[bool] = None,
         exclude_unset: bool = False,
         exclude_defaults: bool = False,
         exclude_none: bool = False,
-        encoder: Optional[Callable[[Any], Any]] = None,
-        models_as_dict: bool = True,
+        round_trip: bool = False,
+        warnings: bool = True,
+    ) -> str:
+        """Usage docs: https://docs.pydantic.dev/2.6/concepts/serialization/#modelmodel_dump_json
+
+        Generates a JSON representation of the model using Pydantic's `to_json` method.
+
+        Args:
+            indent: Indentation to use in the JSON output. If None is passed, the output will be compact.
+            include: Field(s) to include in the JSON output.
+            exclude: Field(s) to exclude from the JSON output.
+            by_alias: Whether to serialize using field aliases.
+            exclude_unset: Whether to exclude fields that have not been explicitly set.
+            exclude_defaults: Whether to exclude fields that are set to their default value.
+            exclude_none: Whether to exclude fields that have a value of `None`.
+            round_trip: If True, dumped values should be valid as input for non-idempotent types such as Json[T].
+            warnings: Whether to log warnings when invalid fields are encountered.
+
+        Returns:
+            A JSON string representation of the model.
+        """
+        return self.__pydantic_serializer__.to_json(
+            self,
+            indent=indent,
+            include=include,
+            exclude=exclude,
+            by_alias=by_alias,
+            exclude_unset=exclude_unset,
+            exclude_defaults=exclude_defaults,
+            exclude_none=exclude_none,
+            round_trip=round_trip,
+            warnings=warnings,
+        ).decode()
+
+    @classmethod
+    def model_json_schema(
+        cls,
+        by_alias: bool = True,
+        ref_template: str = DEFAULT_REF_TEMPLATE,
+        schema_generator: type[GenerateJsonSchema] = GenerateJsonSchema,
+        mode: JsonSchemaMode = 'validation',
+    ) -> dict[str, Any]:
+        """Generates a JSON schema for a model class.
+
+        Args:
+            by_alias: Whether to use attribute aliases or not.
+            ref_template: The reference template.
+            schema_generator: To override the logic used to generate the JSON schema, as a subclass of
+                `GenerateJsonSchema` with your desired modifications
+            mode: The mode in which to generate the schema.
+
+        Returns:
+            The JSON schema for the given model class.
+        """
+        return model_json_schema(
+            cls, by_alias=by_alias, ref_template=ref_template, schema_generator=schema_generator, mode=mode
+        )
+
+    @classmethod
+    def model_parametrized_name(cls, params: tuple[type[Any], ...]) -> str:
+        """Compute the class name for parametrizations of generic classes.
+
+        This method can be overridden to achieve a custom naming scheme for generic BaseModels.
+
+        Args:
+            params: Tuple of types of the class. Given a generic class
+                `Model` with 2 type variables and a concrete model `Model[str, int]`,
+                the value `(str, int)` would be passed to `params`.
+
+        Returns:
+            String representing the new class where `params` are passed to `cls` as type variables.
+
+        Raises:
+            TypeError: Raised when trying to generate concrete names for non-generic models.
+        """
+        if not issubclass(cls, typing.Generic):
+            raise TypeError('Concrete names should only be generated for generic models.')
+
+        # Any strings received should represent forward references, so we handle them specially below.
+        # If we eventually move toward wrapping them in a ForwardRef in __class_getitem__ in the future,
+        # we may be able to remove this special case.
+        param_names = [param if isinstance(param, str) else _repr.display_as_type(param) for param in params]
+        params_component = ', '.join(param_names)
+        return f'{cls.__name__}[{params_component}]'
+
+    def model_post_init(self, __context: Any) -> None:
+        """Override this method to perform additional initialization after `__init__` and `model_construct`.
+        This is useful if you want to do some validation that requires the entire model to be initialized.
+        """
+        pass
+
+    @classmethod
+    def model_rebuild(
+        cls,
+        *,
+        force: bool = False,
+        raise_errors: bool = True,
+        _parent_namespace_depth: int = 2,
+        _types_namespace: dict[str, Any] | None = None,
+    ) -> bool | None:
+        """Try to rebuild the pydantic-core schema for the model.
+
+        This may be necessary when one of the annotations is a ForwardRef which could not be resolved during
+        the initial attempt to build the schema, and automatic rebuilding fails.
+
+        Args:
+            force: Whether to force the rebuilding of the model schema, defaults to `False`.
+            raise_errors: Whether to raise errors, defaults to `True`.
+            _parent_namespace_depth: The depth level of the parent namespace, defaults to 2.
+            _types_namespace: The types namespace, defaults to `None`.
+
+        Returns:
+            Returns `None` if the schema is already "complete" and rebuilding was not required.
+            If rebuilding _was_ required, returns `True` if rebuilding was successful, otherwise `False`.
+        """
+        if not force and cls.__pydantic_complete__:
+            return None
+        else:
+            if '__pydantic_core_schema__' in cls.__dict__:
+                delattr(cls, '__pydantic_core_schema__')  # delete cached value to ensure full rebuild happens
+            if _types_namespace is not None:
+                types_namespace: dict[str, Any] | None = _types_namespace.copy()
+            else:
+                if _parent_namespace_depth > 0:
+                    frame_parent_ns = _typing_extra.parent_frame_namespace(parent_depth=_parent_namespace_depth) or {}
+                    cls_parent_ns = (
+                        _model_construction.unpack_lenient_weakvaluedict(cls.__pydantic_parent_namespace__) or {}
+                    )
+                    types_namespace = {**cls_parent_ns, **frame_parent_ns}
+                    cls.__pydantic_parent_namespace__ = _model_construction.build_lenient_weakvaluedict(types_namespace)
+                else:
+                    types_namespace = _model_construction.unpack_lenient_weakvaluedict(
+                        cls.__pydantic_parent_namespace__
+                    )
+
+                types_namespace = _typing_extra.get_cls_types_namespace(cls, types_namespace)
+
+            # manually override defer_build so complete_model_class doesn't skip building the model again
+            config = {**cls.model_config, 'defer_build': False}
+            return _model_construction.complete_model_class(
+                cls,
+                cls.__name__,
+                _config.ConfigWrapper(config, check=False),
+                raise_errors=raise_errors,
+                types_namespace=types_namespace,
+            )
+
+    @classmethod
+    def model_validate(
+        cls: type[Model],
+        obj: Any,
+        *,
+        strict: bool | None = None,
+        from_attributes: bool | None = None,
+        context: dict[str, Any] | None = None,
+    ) -> Model:
+        """Validate a pydantic model instance.
+
+        Args:
+            obj: The object to validate.
+            strict: Whether to enforce types strictly.
+            from_attributes: Whether to extract data from object attributes.
+            context: Additional context to pass to the validator.
+
+        Raises:
+            ValidationError: If the object could not be validated.
+
+        Returns:
+            The validated model instance.
+        """
+        # `__tracebackhide__` tells pytest and some other tools to omit this function from tracebacks
+        __tracebackhide__ = True
+        return cls.__pydantic_validator__.validate_python(
+            obj, strict=strict, from_attributes=from_attributes, context=context
+        )
+
+    @classmethod
+    def model_validate_json(
+        cls: type[Model],
+        json_data: str | bytes | bytearray,
+        *,
+        strict: bool | None = None,
+        context: dict[str, Any] | None = None,
+    ) -> Model:
+        """Usage docs: https://docs.pydantic.dev/2.6/concepts/json/#json-parsing
+
+        Validate the given JSON data against the Pydantic model.
+
+        Args:
+            json_data: The JSON data to validate.
+            strict: Whether to enforce types strictly.
+            context: Extra variables to pass to the validator.
+
+        Returns:
+            The validated Pydantic model.
+
+        Raises:
+            ValueError: If `json_data` is not a JSON string.
+        """
+        # `__tracebackhide__` tells pytest and some other tools to omit this function from tracebacks
+        __tracebackhide__ = True
+        return cls.__pydantic_validator__.validate_json(json_data, strict=strict, context=context)
+
+    @classmethod
+    def model_validate_strings(
+        cls: type[Model],
+        obj: Any,
+        *,
+        strict: bool | None = None,
+        context: dict[str, Any] | None = None,
+    ) -> Model:
+        """Validate the given object contains string data against the Pydantic model.
+
+        Args:
+            obj: The object contains string data to validate.
+            strict: Whether to enforce types strictly.
+            context: Extra variables to pass to the validator.
+
+        Returns:
+            The validated Pydantic model.
+        """
+        # `__tracebackhide__` tells pytest and some other tools to omit this function from tracebacks
+        __tracebackhide__ = True
+        return cls.__pydantic_validator__.validate_strings(obj, strict=strict, context=context)
+
+    @classmethod
+    def __get_pydantic_core_schema__(cls, __source: type[BaseModel], __handler: GetCoreSchemaHandler) -> CoreSchema:
+        """Hook into generating the model's CoreSchema.
+
+        Args:
+            __source: The class we are generating a schema for.
+                This will generally be the same as the `cls` argument if this is a classmethod.
+            __handler: Call into Pydantic's internal JSON schema generation.
+                A callable that calls into Pydantic's internal CoreSchema generation logic.
+
+        Returns:
+            A `pydantic-core` `CoreSchema`.
+        """
+        # Only use the cached value from this _exact_ class; we don't want one from a parent class
+        # This is why we check `cls.__dict__` and don't use `cls.__pydantic_core_schema__` or similar.
+        if '__pydantic_core_schema__' in cls.__dict__:
+            # Due to the way generic classes are built, it's possible that an invalid schema may be temporarily
+            # set on generic classes. I think we could resolve this to ensure that we get proper schema caching
+            # for generics, but for simplicity for now, we just always rebuild if the class has a generic origin.
+            if not cls.__pydantic_generic_metadata__['origin']:
+                return cls.__pydantic_core_schema__
+
+        return __handler(__source)
+
+    @classmethod
+    def __get_pydantic_json_schema__(
+        cls,
+        __core_schema: CoreSchema,
+        __handler: GetJsonSchemaHandler,
+    ) -> JsonSchemaValue:
+        """Hook into generating the model's JSON schema.
+
+        Args:
+            __core_schema: A `pydantic-core` CoreSchema.
+                You can ignore this argument and call the handler with a new CoreSchema,
+                wrap this CoreSchema (`{'type': 'nullable', 'schema': current_schema}`),
+                or just call the handler with the original schema.
+            __handler: Call into Pydantic's internal JSON schema generation.
+                This will raise a `pydantic.errors.PydanticInvalidForJsonSchema` if JSON schema
+                generation fails.
+                Since this gets called by `BaseModel.model_json_schema` you can override the
+                `schema_generator` argument to that function to change JSON schema generation globally
+                for a type.
+
+        Returns:
+            A JSON schema, as a Python object.
+        """
+        return __handler(__core_schema)
+
+    @classmethod
+    def __pydantic_init_subclass__(cls, **kwargs: Any) -> None:
+        """This is intended to behave just like `__init_subclass__`, but is called by `ModelMetaclass`
+        only after the class is actually fully initialized. In particular, attributes like `model_fields` will
+        be present when this is called.
+
+        This is necessary because `__init_subclass__` will always be called by `type.__new__`,
+        and it would require a prohibitively large refactor to the `ModelMetaclass` to ensure that
+        `type.__new__` was called in such a manner that the class would already be sufficiently initialized.
+
+        This will receive the same `kwargs` that would be passed to the standard `__init_subclass__`, namely,
+        any kwargs passed to the class definition that aren't used internally by pydantic.
+
+        Args:
+            **kwargs: Any keyword arguments passed to the class definition that aren't used internally
+                by pydantic.
+        """
+        pass
+
+    def __class_getitem__(
+        cls, typevar_values: type[Any] | tuple[type[Any], ...]
+    ) -> type[BaseModel] | _forward_ref.PydanticRecursiveRef:
+        cached = _generics.get_cached_generic_type_early(cls, typevar_values)
+        if cached is not None:
+            return cached
+
+        if cls is BaseModel:
+            raise TypeError('Type parameters should be placed on typing.Generic, not BaseModel')
+        if not hasattr(cls, '__parameters__'):
+            raise TypeError(f'{cls} cannot be parametrized because it does not inherit from typing.Generic')
+        if not cls.__pydantic_generic_metadata__['parameters'] and typing.Generic not in cls.__bases__:
+            raise TypeError(f'{cls} is not a generic class')
+
+        if not isinstance(typevar_values, tuple):
+            typevar_values = (typevar_values,)
+        _generics.check_parameters_count(cls, typevar_values)
+
+        # Build map from generic typevars to passed params
+        typevars_map: dict[_typing_extra.TypeVarType, type[Any]] = dict(
+            zip(cls.__pydantic_generic_metadata__['parameters'], typevar_values)
+        )
+
+        if _utils.all_identical(typevars_map.keys(), typevars_map.values()) and typevars_map:
+            submodel = cls  # if arguments are equal to parameters it's the same object
+            _generics.set_cached_generic_type(cls, typevar_values, submodel)
+        else:
+            parent_args = cls.__pydantic_generic_metadata__['args']
+            if not parent_args:
+                args = typevar_values
+            else:
+                args = tuple(_generics.replace_types(arg, typevars_map) for arg in parent_args)
+
+            origin = cls.__pydantic_generic_metadata__['origin'] or cls
+            model_name = origin.model_parametrized_name(args)
+            params = tuple(
+                {param: None for param in _generics.iter_contained_typevars(typevars_map.values())}
+            )  # use dict as ordered set
+
+            with _generics.generic_recursion_self_type(origin, args) as maybe_self_type:
+                if maybe_self_type is not None:
+                    return maybe_self_type
+
+                cached = _generics.get_cached_generic_type_late(cls, typevar_values, origin, args)
+                if cached is not None:
+                    return cached
+
+                # Attempt to rebuild the origin in case new types have been defined
+                try:
+                    # depth 3 gets you above this __class_getitem__ call
+                    origin.model_rebuild(_parent_namespace_depth=3)
+                except PydanticUndefinedAnnotation:
+                    # It's okay if it fails, it just means there are still undefined types
+                    # that could be evaluated later.
+                    # TODO: Make sure validation fails if there are still undefined types, perhaps using MockValidator
+                    pass
+
+                submodel = _generics.create_generic_submodel(model_name, origin, args, params)
+
+                # Update cache
+                _generics.set_cached_generic_type(cls, typevar_values, submodel, origin, args)
+
+        return submodel
+
+    def __copy__(self: Model) -> Model:
+        """Returns a shallow copy of the model."""
+        cls = type(self)
+        m = cls.__new__(cls)
+        _object_setattr(m, '__dict__', copy(self.__dict__))
+        _object_setattr(m, '__pydantic_extra__', copy(self.__pydantic_extra__))
+        _object_setattr(m, '__pydantic_fields_set__', copy(self.__pydantic_fields_set__))
+
+        if self.__pydantic_private__ is None:
+            _object_setattr(m, '__pydantic_private__', None)
+        else:
+            _object_setattr(
+                m,
+                '__pydantic_private__',
+                {k: v for k, v in self.__pydantic_private__.items() if v is not PydanticUndefined},
+            )
+
+        return m
+
+    def __deepcopy__(self: Model, memo: dict[int, Any] | None = None) -> Model:
+        """Returns a deep copy of the model."""
+        cls = type(self)
+        m = cls.__new__(cls)
+        _object_setattr(m, '__dict__', deepcopy(self.__dict__, memo=memo))
+        _object_setattr(m, '__pydantic_extra__', deepcopy(self.__pydantic_extra__, memo=memo))
+        # This next line doesn't need a deepcopy because __pydantic_fields_set__ is a set[str],
+        # and attempting a deepcopy would be marginally slower.
+        _object_setattr(m, '__pydantic_fields_set__', copy(self.__pydantic_fields_set__))
+
+        if self.__pydantic_private__ is None:
+            _object_setattr(m, '__pydantic_private__', None)
+        else:
+            _object_setattr(
+                m,
+                '__pydantic_private__',
+                deepcopy({k: v for k, v in self.__pydantic_private__.items() if v is not PydanticUndefined}, memo=memo),
+            )
+
+        return m
+
+    if not typing.TYPE_CHECKING:
+        # We put `__getattr__` in a non-TYPE_CHECKING block because otherwise, mypy allows arbitrary attribute access
+
+        def __getattr__(self, item: str) -> Any:
+            private_attributes = object.__getattribute__(self, '__private_attributes__')
+            if item in private_attributes:
+                attribute = private_attributes[item]
+                if hasattr(attribute, '__get__'):
+                    return attribute.__get__(self, type(self))  # type: ignore
+
+                try:
+                    # Note: self.__pydantic_private__ cannot be None if self.__private_attributes__ has items
+                    return self.__pydantic_private__[item]  # type: ignore
+                except KeyError as exc:
+                    raise AttributeError(f'{type(self).__name__!r} object has no attribute {item!r}') from exc
+            else:
+                # `__pydantic_extra__` can fail to be set if the model is not yet fully initialized.
+                # See `BaseModel.__repr_args__` for more details
+                try:
+                    pydantic_extra = object.__getattribute__(self, '__pydantic_extra__')
+                except AttributeError:
+                    pydantic_extra = None
+
+                if pydantic_extra is not None:
+                    try:
+                        return pydantic_extra[item]
+                    except KeyError as exc:
+                        raise AttributeError(f'{type(self).__name__!r} object has no attribute {item!r}') from exc
+                else:
+                    if hasattr(self.__class__, item):
+                        return super().__getattribute__(item)  # Raises AttributeError if appropriate
+                    else:
+                        # this is the current error
+                        raise AttributeError(f'{type(self).__name__!r} object has no attribute {item!r}')
+
+    def __setattr__(self, name: str, value: Any) -> None:
+        if name in self.__class_vars__:
+            raise AttributeError(
+                f'{name!r} is a ClassVar of `{self.__class__.__name__}` and cannot be set on an instance. '
+                f'If you want to set a value on the class, use `{self.__class__.__name__}.{name} = value`.'
+            )
+        elif not _fields.is_valid_field_name(name):
+            if self.__pydantic_private__ is None or name not in self.__private_attributes__:
+                _object_setattr(self, name, value)
+            else:
+                attribute = self.__private_attributes__[name]
+                if hasattr(attribute, '__set__'):
+                    attribute.__set__(self, value)  # type: ignore
+                else:
+                    self.__pydantic_private__[name] = value
+            return
+
+        self._check_frozen(name, value)
+
+        attr = getattr(self.__class__, name, None)
+        if isinstance(attr, property):
+            attr.__set__(self, value)
+        elif self.model_config.get('validate_assignment', None):
+            self.__pydantic_validator__.validate_assignment(self, name, value)
+        elif self.model_config.get('extra') != 'allow' and name not in self.model_fields:
+            # TODO - matching error
+            raise ValueError(f'"{self.__class__.__name__}" object has no field "{name}"')
+        elif self.model_config.get('extra') == 'allow' and name not in self.model_fields:
+            if self.model_extra and name in self.model_extra:
+                self.__pydantic_extra__[name] = value  # type: ignore
+            else:
+                try:
+                    getattr(self, name)
+                except AttributeError:
+                    # attribute does not already exist on instance, so put it in extra
+                    self.__pydantic_extra__[name] = value  # type: ignore
+                else:
+                    # attribute _does_ already exist on instance, and was not in extra, so update it
+                    _object_setattr(self, name, value)
+        else:
+            self.__dict__[name] = value
+            self.__pydantic_fields_set__.add(name)
+
+    def __delattr__(self, item: str) -> Any:
+        if item in self.__private_attributes__:
+            attribute = self.__private_attributes__[item]
+            if hasattr(attribute, '__delete__'):
+                attribute.__delete__(self)  # type: ignore
+                return
+
+            try:
+                # Note: self.__pydantic_private__ cannot be None if self.__private_attributes__ has items
+                del self.__pydantic_private__[item]  # type: ignore
+                return
+            except KeyError as exc:
+                raise AttributeError(f'{type(self).__name__!r} object has no attribute {item!r}') from exc
+
+        self._check_frozen(item, None)
+
+        if item in self.model_fields:
+            object.__delattr__(self, item)
+        elif self.__pydantic_extra__ is not None and item in self.__pydantic_extra__:
+            del self.__pydantic_extra__[item]
+        else:
+            try:
+                object.__delattr__(self, item)
+            except AttributeError:
+                raise AttributeError(f'{type(self).__name__!r} object has no attribute {item!r}')
+
+    def _check_frozen(self, name: str, value: Any) -> None:
+        if self.model_config.get('frozen', None):
+            typ = 'frozen_instance'
+        elif getattr(self.model_fields.get(name), 'frozen', False):
+            typ = 'frozen_field'
+        else:
+            return
+        error: pydantic_core.InitErrorDetails = {
+            'type': typ,
+            'loc': (name,),
+            'input': value,
+        }
+        raise pydantic_core.ValidationError.from_exception_data(self.__class__.__name__, [error])
+
+    def __getstate__(self) -> dict[Any, Any]:
+        private = self.__pydantic_private__
+        if private:
+            private = {k: v for k, v in private.items() if v is not PydanticUndefined}
+        return {
+            '__dict__': self.__dict__,
+            '__pydantic_extra__': self.__pydantic_extra__,
+            '__pydantic_fields_set__': self.__pydantic_fields_set__,
+            '__pydantic_private__': private,
+        }
+
+    def __setstate__(self, state: dict[Any, Any]) -> None:
+        _object_setattr(self, '__pydantic_fields_set__', state['__pydantic_fields_set__'])
+        _object_setattr(self, '__pydantic_extra__', state['__pydantic_extra__'])
+        _object_setattr(self, '__pydantic_private__', state['__pydantic_private__'])
+        _object_setattr(self, '__dict__', state['__dict__'])
+
+    def __eq__(self, other: Any) -> bool:
+        if isinstance(other, BaseModel):
+            # When comparing instances of generic types for equality, as long as all field values are equal,
+            # only require their generic origin types to be equal, rather than exact type equality.
+            # This prevents headaches like MyGeneric(x=1) != MyGeneric[Any](x=1).
+            self_type = self.__pydantic_generic_metadata__['origin'] or self.__class__
+            other_type = other.__pydantic_generic_metadata__['origin'] or other.__class__
+
+            # Perform common checks first
+            if not (
+                self_type == other_type
+                and self.__pydantic_private__ == other.__pydantic_private__
+                and self.__pydantic_extra__ == other.__pydantic_extra__
+            ):
+                return False
+
+            # We only want to compare pydantic fields but ignoring fields is costly.
+            # We'll perform a fast check first, and fallback only when needed
+            # See GH-7444 and GH-7825 for rationale and a performance benchmark
+
+            # First, do the fast (and sometimes faulty) __dict__ comparison
+            if self.__dict__ == other.__dict__:
+                # If the check above passes, then pydantic fields are equal, we can return early
+                return True
+
+            # We don't want to trigger unnecessary costly filtering of __dict__ on all unequal objects, so we return
+            # early if there are no keys to ignore (we would just return False later on anyway)
+            model_fields = type(self).model_fields.keys()
+            if self.__dict__.keys() <= model_fields and other.__dict__.keys() <= model_fields:
+                return False
+
+            # If we reach here, there are non-pydantic-fields keys, mapped to unequal values, that we need to ignore
+            # Resort to costly filtering of the __dict__ objects
+            # We use operator.itemgetter because it is much faster than dict comprehensions
+            # NOTE: Contrary to standard python class and instances, when the Model class has a default value for an
+            # attribute and the model instance doesn't have a corresponding attribute, accessing the missing attribute
+            # raises an error in BaseModel.__getattr__ instead of returning the class attribute
+            # So we can use operator.itemgetter() instead of operator.attrgetter()
+            getter = operator.itemgetter(*model_fields) if model_fields else lambda _: _utils._SENTINEL
+            try:
+                return getter(self.__dict__) == getter(other.__dict__)
+            except KeyError:
+                # In rare cases (such as when using the deprecated BaseModel.copy() method),
+                # the __dict__ may not contain all model fields, which is how we can get here.
+                # getter(self.__dict__) is much faster than any 'safe' method that accounts
+                # for missing keys, and wrapping it in a `try` doesn't slow things down much
+                # in the common case.
+                self_fields_proxy = _utils.SafeGetItemProxy(self.__dict__)
+                other_fields_proxy = _utils.SafeGetItemProxy(other.__dict__)
+                return getter(self_fields_proxy) == getter(other_fields_proxy)
+
+        # other instance is not a BaseModel
+        else:
+            return NotImplemented  # delegate to the other item in the comparison
+
+    if typing.TYPE_CHECKING:
+        # We put `__init_subclass__` in a TYPE_CHECKING block because, even though we want the type-checking benefits
+        # described in the signature of `__init_subclass__` below, we don't want to modify the default behavior of
+        # subclass initialization.
+
+        def __init_subclass__(cls, **kwargs: Unpack[ConfigDict]):
+            """This signature is included purely to help type-checkers check arguments to class declaration, which
+            provides a way to conveniently set model_config key/value pairs.
+
+            ```py
+            from pydantic import BaseModel
+
+            class MyModel(BaseModel, extra='allow'):
+                ...
+            ```
+
+            However, this may be deceiving, since the _actual_ calls to `__init_subclass__` will not receive any
+            of the config arguments, and will only receive any keyword arguments passed during class initialization
+            that are _not_ expected keys in ConfigDict. (This is due to the way `ModelMetaclass.__new__` works.)
+
+            Args:
+                **kwargs: Keyword arguments passed to the class definition, which set model_config
+
+            Note:
+                You may want to override `__pydantic_init_subclass__` instead, which behaves similarly but is called
+                *after* the class is fully initialized.
+            """
+
+    def __iter__(self) -> TupleGenerator:
+        """So `dict(model)` works."""
+        yield from [(k, v) for (k, v) in self.__dict__.items() if not k.startswith('_')]
+        extra = self.__pydantic_extra__
+        if extra:
+            yield from extra.items()
+
+    def __repr__(self) -> str:
+        return f'{self.__repr_name__()}({self.__repr_str__(", ")})'
+
+    def __repr_args__(self) -> _repr.ReprArgs:
+        for k, v in self.__dict__.items():
+            field = self.model_fields.get(k)
+            if field and field.repr:
+                yield k, v
+
+        # `__pydantic_extra__` can fail to be set if the model is not yet fully initialized.
+        # This can happen if a `ValidationError` is raised during initialization and the instance's
+        # repr is generated as part of the exception handling. Therefore, we use `getattr` here
+        # with a fallback, even though the type hints indicate the attribute will always be present.
+        try:
+            pydantic_extra = object.__getattribute__(self, '__pydantic_extra__')
+        except AttributeError:
+            pydantic_extra = None
+
+        if pydantic_extra is not None:
+            yield from ((k, v) for k, v in pydantic_extra.items())
+        yield from ((k, getattr(self, k)) for k, v in self.model_computed_fields.items() if v.repr)
+
+    # take logic from `_repr.Representation` without the side effects of inheritance, see #5740
+    __repr_name__ = _repr.Representation.__repr_name__
+    __repr_str__ = _repr.Representation.__repr_str__
+    __pretty__ = _repr.Representation.__pretty__
+    __rich_repr__ = _repr.Representation.__rich_repr__
+
+    def __str__(self) -> str:
+        return self.__repr_str__(' ')
+
+    # ##### Deprecated methods from v1 #####
+    @property
+    @typing_extensions.deprecated(
+        'The `__fields__` attribute is deprecated, use `model_fields` instead.', category=None
+    )
+    def __fields__(self) -> dict[str, FieldInfo]:
+        warnings.warn(
+            'The `__fields__` attribute is deprecated, use `model_fields` instead.', category=PydanticDeprecatedSince20
+        )
+        return self.model_fields
+
+    @property
+    @typing_extensions.deprecated(
+        'The `__fields_set__` attribute is deprecated, use `model_fields_set` instead.',
+        category=None,
+    )
+    def __fields_set__(self) -> set[str]:
+        warnings.warn(
+            'The `__fields_set__` attribute is deprecated, use `model_fields_set` instead.',
+            category=PydanticDeprecatedSince20,
+        )
+        return self.__pydantic_fields_set__
+
+    @typing_extensions.deprecated('The `dict` method is deprecated; use `model_dump` instead.', category=None)
+    def dict(  # noqa: D102
+        self,
+        *,
+        include: IncEx = None,
+        exclude: IncEx = None,
+        by_alias: bool = False,
+        exclude_unset: bool = False,
+        exclude_defaults: bool = False,
+        exclude_none: bool = False,
+    ) -> typing.Dict[str, Any]:  # noqa UP006
+        warnings.warn('The `dict` method is deprecated; use `model_dump` instead.', category=PydanticDeprecatedSince20)
+        return self.model_dump(
+            include=include,
+            exclude=exclude,
+            by_alias=by_alias,
+            exclude_unset=exclude_unset,
+            exclude_defaults=exclude_defaults,
+            exclude_none=exclude_none,
+        )
+
+    @typing_extensions.deprecated('The `json` method is deprecated; use `model_dump_json` instead.', category=None)
+    def json(  # noqa: D102
+        self,
+        *,
+        include: IncEx = None,
+        exclude: IncEx = None,
+        by_alias: bool = False,
+        exclude_unset: bool = False,
+        exclude_defaults: bool = False,
+        exclude_none: bool = False,
+        encoder: typing.Callable[[Any], Any] | None = PydanticUndefined,  # type: ignore[assignment]
+        models_as_dict: bool = PydanticUndefined,  # type: ignore[assignment]
         **dumps_kwargs: Any,
     ) -> str:
-        """
-        Generate a JSON representation of the model, `include` and `exclude` arguments as per `dict()`.
-
-        `encoder` is an optional function to supply as `default` to json.dumps(), other arguments as per `json.dumps()`.
-        """
-        if skip_defaults is not None:
-            warnings.warn(
-                f'{self.__class__.__name__}.json(): "skip_defaults" is deprecated and replaced by "exclude_unset"',
-                DeprecationWarning,
-            )
-            exclude_unset = skip_defaults
-        encoder = cast(Callable[[Any], Any], encoder or self.__json_encoder__)
-
-        # We don't directly call `self.dict()`, which does exactly this with `to_dict=True`
-        # because we want to be able to keep raw `BaseModel` instances and not as `dict`.
-        # This allows users to write custom JSON encoders for given `BaseModel` classes.
-        data = dict(
-            self._iter(
-                to_dict=models_as_dict,
-                by_alias=by_alias,
-                include=include,
-                exclude=exclude,
-                exclude_unset=exclude_unset,
-                exclude_defaults=exclude_defaults,
-                exclude_none=exclude_none,
-            )
+        warnings.warn(
+            'The `json` method is deprecated; use `model_dump_json` instead.', category=PydanticDeprecatedSince20
+        )
+        if encoder is not PydanticUndefined:
+            raise TypeError('The `encoder` argument is no longer supported; use field serializers instead.')
+        if models_as_dict is not PydanticUndefined:
+            raise TypeError('The `models_as_dict` argument is no longer supported; use a model serializer instead.')
+        if dumps_kwargs:
+            raise TypeError('`dumps_kwargs` keyword arguments are no longer supported.')
+        return self.model_dump_json(
+            include=include,
+            exclude=exclude,
+            by_alias=by_alias,
+            exclude_unset=exclude_unset,
+            exclude_defaults=exclude_defaults,
+            exclude_none=exclude_none,
         )
-        if self.__custom_root_type__:
-            data = data[ROOT_KEY]
-        return self.__config__.json_dumps(data, default=encoder, **dumps_kwargs)
 
     @classmethod
-    def _enforce_dict_if_root(cls, obj: Any) -> Any:
-        if cls.__custom_root_type__ and (
-            not (isinstance(obj, dict) and obj.keys() == {ROOT_KEY})
-            or cls.__fields__[ROOT_KEY].shape in MAPPING_LIKE_SHAPES
-        ):
-            return {ROOT_KEY: obj}
-        else:
-            return obj
+    @typing_extensions.deprecated('The `parse_obj` method is deprecated; use `model_validate` instead.', category=None)
+    def parse_obj(cls: type[Model], obj: Any) -> Model:  # noqa: D102
+        warnings.warn(
+            'The `parse_obj` method is deprecated; use `model_validate` instead.', category=PydanticDeprecatedSince20
+        )
+        return cls.model_validate(obj)
 
     @classmethod
-    def parse_obj(cls: Type['Model'], obj: Any) -> 'Model':
-        obj = cls._enforce_dict_if_root(obj)
-        if not isinstance(obj, dict):
-            try:
-                obj = dict(obj)
-            except (TypeError, ValueError) as e:
-                exc = TypeError(f'{cls.__name__} expected dict not {obj.__class__.__name__}')
-                raise ValidationError([ErrorWrapper(exc, loc=ROOT_KEY)], cls) from e
-        return cls(**obj)
-
-    @classmethod
-    def parse_raw(
-        cls: Type['Model'],
-        b: StrBytes,
+    @typing_extensions.deprecated(
+        'The `parse_raw` method is deprecated; if your data is JSON use `model_validate_json`, '
+        'otherwise load the data then use `model_validate` instead.',
+        category=None,
+    )
+    def parse_raw(  # noqa: D102
+        cls: type[Model],
+        b: str | bytes,
         *,
-        content_type: str = None,
+        content_type: str | None = None,
         encoding: str = 'utf8',
-        proto: Protocol = None,
+        proto: DeprecatedParseProtocol | None = None,
         allow_pickle: bool = False,
-    ) -> 'Model':
+    ) -> Model:  # pragma: no cover
+        warnings.warn(
+            'The `parse_raw` method is deprecated; if your data is JSON use `model_validate_json`, '
+            'otherwise load the data then use `model_validate` instead.',
+            category=PydanticDeprecatedSince20,
+        )
+        from .deprecated import parse
+
         try:
-            obj = load_str_bytes(
+            obj = parse.load_str_bytes(
                 b,
                 proto=proto,
                 content_type=content_type,
                 encoding=encoding,
                 allow_pickle=allow_pickle,
-                json_loads=cls.__config__.json_loads,
             )
-        except (ValueError, TypeError, UnicodeDecodeError) as e:
-            raise ValidationError([ErrorWrapper(e, loc=ROOT_KEY)], cls)
-        return cls.parse_obj(obj)
+        except (ValueError, TypeError) as exc:
+            import json
+
+            # try to match V1
+            if isinstance(exc, UnicodeDecodeError):
+                type_str = 'value_error.unicodedecode'
+            elif isinstance(exc, json.JSONDecodeError):
+                type_str = 'value_error.jsondecode'
+            elif isinstance(exc, ValueError):
+                type_str = 'value_error'
+            else:
+                type_str = 'type_error'
+
+            # ctx is missing here, but since we've added `input` to the error, we're not pretending it's the same
+            error: pydantic_core.InitErrorDetails = {
+                # The type: ignore on the next line is to ignore the requirement of LiteralString
+                'type': pydantic_core.PydanticCustomError(type_str, str(exc)),  # type: ignore
+                'loc': ('__root__',),
+                'input': b,
+            }
+            raise pydantic_core.ValidationError.from_exception_data(cls.__name__, [error])
+        return cls.model_validate(obj)
 
     @classmethod
-    def parse_file(
-        cls: Type['Model'],
-        path: Union[str, Path],
+    @typing_extensions.deprecated(
+        'The `parse_file` method is deprecated; load the data from file, then if your data is JSON '
+        'use `model_validate_json`, otherwise `model_validate` instead.',
+        category=None,
+    )
+    def parse_file(  # noqa: D102
+        cls: type[Model],
+        path: str | Path,
         *,
-        content_type: str = None,
+        content_type: str | None = None,
         encoding: str = 'utf8',
-        proto: Protocol = None,
+        proto: DeprecatedParseProtocol | None = None,
         allow_pickle: bool = False,
-    ) -> 'Model':
-        obj = load_file(
+    ) -> Model:
+        warnings.warn(
+            'The `parse_file` method is deprecated; load the data from file, then if your data is JSON '
+            'use `model_validate_json`, otherwise `model_validate` instead.',
+            category=PydanticDeprecatedSince20,
+        )
+        from .deprecated import parse
+
+        obj = parse.load_file(
             path,
             proto=proto,
             content_type=content_type,
             encoding=encoding,
             allow_pickle=allow_pickle,
-            json_loads=cls.__config__.json_loads,
         )
         return cls.parse_obj(obj)
 
     @classmethod
-    def from_orm(cls: Type['Model'], obj: Any) -> 'Model':
-        if not cls.__config__.orm_mode:
-            raise ConfigError('You must have the config attribute orm_mode=True to use from_orm')
-        obj = {ROOT_KEY: obj} if cls.__custom_root_type__ else cls._decompose_class(obj)
-        m = cls.__new__(cls)
-        values, fields_set, validation_error = validate_model(cls, obj)
-        if validation_error:
-            raise validation_error
-        object_setattr(m, '__dict__', values)
-        object_setattr(m, '__fields_set__', fields_set)
-        m._init_private_attributes()
-        return m
+    @typing_extensions.deprecated(
+        'The `from_orm` method is deprecated; set '
+        "`model_config['from_attributes']=True` and use `model_validate` instead.",
+        category=None,
+    )
+    def from_orm(cls: type[Model], obj: Any) -> Model:  # noqa: D102
+        warnings.warn(
+            'The `from_orm` method is deprecated; set '
+            "`model_config['from_attributes']=True` and use `model_validate` instead.",
+            category=PydanticDeprecatedSince20,
+        )
+        if not cls.model_config.get('from_attributes', None):
+            raise PydanticUserError(
+                'You must set the config attribute `from_attributes=True` to use from_orm', code=None
+            )
+        return cls.model_validate(obj)
 
     @classmethod
-    def construct(cls: Type['Model'], _fields_set: Optional['SetStr'] = None, **values: Any) -> 'Model':
-        """
-        Creates a new model setting __dict__ and __fields_set__ from trusted or pre-validated data.
-        Default values are respected, but no other validation is performed.
-        Behaves as if `Config.extra = 'allow'` was set since it adds all passed values
-        """
-        m = cls.__new__(cls)
-        fields_values: Dict[str, Any] = {}
-        for name, field in cls.__fields__.items():
-            if field.alt_alias and field.alias in values:
-                fields_values[name] = values[field.alias]
-            elif name in values:
-                fields_values[name] = values[name]
-            elif not field.required:
-                fields_values[name] = field.get_default()
-        fields_values.update(values)
-        object_setattr(m, '__dict__', fields_values)
-        if _fields_set is None:
-            _fields_set = set(values.keys())
-        object_setattr(m, '__fields_set__', _fields_set)
-        m._init_private_attributes()
-        return m
-
-    def _copy_and_set_values(self: 'Model', values: 'DictStrAny', fields_set: 'SetStr', *, deep: bool) -> 'Model':
-        if deep:
-            # chances of having empty dict here are quite low for using smart_deepcopy
-            values = deepcopy(values)
-
-        cls = self.__class__
-        m = cls.__new__(cls)
-        object_setattr(m, '__dict__', values)
-        object_setattr(m, '__fields_set__', fields_set)
-        for name in self.__private_attributes__:
-            value = getattr(self, name, Undefined)
-            if value is not Undefined:
-                if deep:
-                    value = deepcopy(value)
-                object_setattr(m, name, value)
-
-        return m
+    @typing_extensions.deprecated('The `construct` method is deprecated; use `model_construct` instead.', category=None)
+    def construct(cls: type[Model], _fields_set: set[str] | None = None, **values: Any) -> Model:  # noqa: D102
+        warnings.warn(
+            'The `construct` method is deprecated; use `model_construct` instead.', category=PydanticDeprecatedSince20
+        )
+        return cls.model_construct(_fields_set=_fields_set, **values)
 
+    @typing_extensions.deprecated(
+        'The `copy` method is deprecated; use `model_copy` instead. '
+        'See the docstring of `BaseModel.copy` for details about how to handle `include` and `exclude`.',
+        category=None,
+    )
     def copy(
-        self: 'Model',
+        self: Model,
         *,
-        include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
-        exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
-        update: Optional['DictStrAny'] = None,
+        include: AbstractSetIntStr | MappingIntStrAny | None = None,
+        exclude: AbstractSetIntStr | MappingIntStrAny | None = None,
+        update: typing.Dict[str, Any] | None = None,  # noqa UP006
         deep: bool = False,
-    ) -> 'Model':
-        """
-        Duplicate a model, optionally choose which fields to include, exclude and change.
+    ) -> Model:  # pragma: no cover
+        """Returns a copy of the model.
 
-        :param include: fields to include in new model
-        :param exclude: fields to exclude from new model, as with values this takes precedence over include
-        :param update: values to change/add in the new model. Note: the data is not validated before creating
-            the new model: you should trust this data
-        :param deep: set to `True` to make a deep copy of the model
-        :return: new model instance
+        !!! warning "Deprecated"
+            This method is now deprecated; use `model_copy` instead.
+
+        If you need `include` or `exclude`, use:
+
+        ```py
+        data = self.model_dump(include=include, exclude=exclude, round_trip=True)
+        data = {**data, **(update or {})}
+        copied = self.model_validate(data)
+        ```
+
+        Args:
+            include: Optional set or mapping specifying which fields to include in the copied model.
+            exclude: Optional set or mapping specifying which fields to exclude in the copied model.
+            update: Optional dictionary of field-value pairs to override field values in the copied model.
+            deep: If True, the values of fields that are Pydantic models will be deep-copied.
+
+        Returns:
+            A copy of the model with included, excluded and updated fields as specified.
         """
+        warnings.warn(
+            'The `copy` method is deprecated; use `model_copy` instead. '
+            'See the docstring of `BaseModel.copy` for details about how to handle `include` and `exclude`.',
+            category=PydanticDeprecatedSince20,
+        )
+        from .deprecated import copy_internals
 
         values = dict(
-            self._iter(to_dict=False, by_alias=False, include=include, exclude=exclude, exclude_unset=False),
+            copy_internals._iter(
+                self, to_dict=False, by_alias=False, include=include, exclude=exclude, exclude_unset=False
+            ),
             **(update or {}),
         )
+        if self.__pydantic_private__ is None:
+            private = None
+        else:
+            private = {k: v for k, v in self.__pydantic_private__.items() if v is not PydanticUndefined}
 
-        # new `__fields_set__` can have unset optional fields with a set value in `update` kwarg
+        if self.__pydantic_extra__ is None:
+            extra: dict[str, Any] | None = None
+        else:
+            extra = self.__pydantic_extra__.copy()
+            for k in list(self.__pydantic_extra__):
+                if k not in values:  # k was in the exclude
+                    extra.pop(k)
+            for k in list(values):
+                if k in self.__pydantic_extra__:  # k must have come from extra
+                    extra[k] = values.pop(k)
+
+        # new `__pydantic_fields_set__` can have unset optional fields with a set value in `update` kwarg
         if update:
-            fields_set = self.__fields_set__ | update.keys()
+            fields_set = self.__pydantic_fields_set__ | update.keys()
         else:
-            fields_set = set(self.__fields_set__)
-
-        return self._copy_and_set_values(values, fields_set, deep=deep)
-
-    @classmethod
-    def schema(cls, by_alias: bool = True, ref_template: str = default_ref_template) -> 'DictStrAny':
-        cached = cls.__schema_cache__.get((by_alias, ref_template))
-        if cached is not None:
-            return cached
-        s = model_schema(cls, by_alias=by_alias, ref_template=ref_template)
-        cls.__schema_cache__[(by_alias, ref_template)] = s
-        return s
-
-    @classmethod
-    def schema_json(
-        cls, *, by_alias: bool = True, ref_template: str = default_ref_template, **dumps_kwargs: Any
-    ) -> str:
-        from .json import pydantic_encoder
-
-        return cls.__config__.json_dumps(
-            cls.schema(by_alias=by_alias, ref_template=ref_template), default=pydantic_encoder, **dumps_kwargs
-        )
-
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield cls.validate
-
-    @classmethod
-    def validate(cls: Type['Model'], value: Any) -> 'Model':
-        if isinstance(value, cls):
-            copy_on_model_validation = cls.__config__.copy_on_model_validation
-            # whether to deep or shallow copy the model on validation, None means do not copy
-            deep_copy: Optional[bool] = None
-            if copy_on_model_validation not in {'deep', 'shallow', 'none'}:
-                # Warn about deprecated behavior
-                warnings.warn(
-                    "`copy_on_model_validation` should be a string: 'deep', 'shallow' or 'none'", DeprecationWarning
-                )
-                if copy_on_model_validation:
-                    deep_copy = False
-
-            if copy_on_model_validation == 'shallow':
-                # shallow copy
-                deep_copy = False
-            elif copy_on_model_validation == 'deep':
-                # deep copy
-                deep_copy = True
-
-            if deep_copy is None:
-                return value
-            else:
-                return value._copy_and_set_values(value.__dict__, value.__fields_set__, deep=deep_copy)
-
-        value = cls._enforce_dict_if_root(value)
-
-        if isinstance(value, dict):
-            return cls(**value)
-        elif cls.__config__.orm_mode:
-            return cls.from_orm(value)
-        else:
-            try:
-                value_as_dict = dict(value)
-            except (TypeError, ValueError) as e:
-                raise DictError() from e
-            return cls(**value_as_dict)
-
-    @classmethod
-    def _decompose_class(cls: Type['Model'], obj: Any) -> GetterDict:
-        if isinstance(obj, GetterDict):
-            return obj
-        return cls.__config__.getter_dict(obj)
-
-    @classmethod
-    @no_type_check
-    def _get_value(
-        cls,
-        v: Any,
-        to_dict: bool,
-        by_alias: bool,
-        include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']],
-        exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']],
-        exclude_unset: bool,
-        exclude_defaults: bool,
-        exclude_none: bool,
-    ) -> Any:
-
-        if isinstance(v, BaseModel):
-            if to_dict:
-                v_dict = v.dict(
-                    by_alias=by_alias,
-                    exclude_unset=exclude_unset,
-                    exclude_defaults=exclude_defaults,
-                    include=include,
-                    exclude=exclude,
-                    exclude_none=exclude_none,
-                )
-                if ROOT_KEY in v_dict:
-                    return v_dict[ROOT_KEY]
-                return v_dict
-            else:
-                return v.copy(include=include, exclude=exclude)
-
-        value_exclude = ValueItems(v, exclude) if exclude else None
-        value_include = ValueItems(v, include) if include else None
-
-        if isinstance(v, dict):
-            return {
-                k_: cls._get_value(
-                    v_,
-                    to_dict=to_dict,
-                    by_alias=by_alias,
-                    exclude_unset=exclude_unset,
-                    exclude_defaults=exclude_defaults,
-                    include=value_include and value_include.for_element(k_),
-                    exclude=value_exclude and value_exclude.for_element(k_),
-                    exclude_none=exclude_none,
-                )
-                for k_, v_ in v.items()
-                if (not value_exclude or not value_exclude.is_excluded(k_))
-                and (not value_include or value_include.is_included(k_))
-            }
-
-        elif sequence_like(v):
-            seq_args = (
-                cls._get_value(
-                    v_,
-                    to_dict=to_dict,
-                    by_alias=by_alias,
-                    exclude_unset=exclude_unset,
-                    exclude_defaults=exclude_defaults,
-                    include=value_include and value_include.for_element(i),
-                    exclude=value_exclude and value_exclude.for_element(i),
-                    exclude_none=exclude_none,
-                )
-                for i, v_ in enumerate(v)
-                if (not value_exclude or not value_exclude.is_excluded(i))
-                and (not value_include or value_include.is_included(i))
-            )
-
-            return v.__class__(*seq_args) if is_namedtuple(v.__class__) else v.__class__(seq_args)
-
-        elif isinstance(v, Enum) and getattr(cls.Config, 'use_enum_values', False):
-            return v.value
-
-        else:
-            return v
-
-    @classmethod
-    def __try_update_forward_refs__(cls, **localns: Any) -> None:
-        """
-        Same as update_forward_refs but will not raise exception
-        when forward references are not defined.
-        """
-        update_model_forward_refs(cls, cls.__fields__.values(), cls.__config__.json_encoders, localns, (NameError,))
-
-    @classmethod
-    def update_forward_refs(cls, **localns: Any) -> None:
-        """
-        Try to update ForwardRefs on fields based on this Model, globalns and localns.
-        """
-        update_model_forward_refs(cls, cls.__fields__.values(), cls.__config__.json_encoders, localns)
-
-    def __iter__(self) -> 'TupleGenerator':
-        """
-        so `dict(model)` works
-        """
-        yield from self.__dict__.items()
-
-    def _iter(
-        self,
-        to_dict: bool = False,
-        by_alias: bool = False,
-        include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
-        exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
-        exclude_unset: bool = False,
-        exclude_defaults: bool = False,
-        exclude_none: bool = False,
-    ) -> 'TupleGenerator':
-
-        # Merge field set excludes with explicit exclude parameter with explicit overriding field set options.
-        # The extra "is not None" guards are not logically necessary but optimizes performance for the simple case.
-        if exclude is not None or self.__exclude_fields__ is not None:
-            exclude = ValueItems.merge(self.__exclude_fields__, exclude)
-
-        if include is not None or self.__include_fields__ is not None:
-            include = ValueItems.merge(self.__include_fields__, include, intersect=True)
-
-        allowed_keys = self._calculate_keys(
-            include=include, exclude=exclude, exclude_unset=exclude_unset  # type: ignore
-        )
-        if allowed_keys is None and not (to_dict or by_alias or exclude_unset or exclude_defaults or exclude_none):
-            # huge boost for plain _iter()
-            yield from self.__dict__.items()
-            return
-
-        value_exclude = ValueItems(self, exclude) if exclude is not None else None
-        value_include = ValueItems(self, include) if include is not None else None
-
-        for field_key, v in self.__dict__.items():
-            if (allowed_keys is not None and field_key not in allowed_keys) or (exclude_none and v is None):
-                continue
-
-            if exclude_defaults:
-                model_field = self.__fields__.get(field_key)
-                if not getattr(model_field, 'required', True) and getattr(model_field, 'default', _missing) == v:
-                    continue
-
-            if by_alias and field_key in self.__fields__:
-                dict_key = self.__fields__[field_key].alias
-            else:
-                dict_key = field_key
-
-            if to_dict or value_include or value_exclude:
-                v = self._get_value(
-                    v,
-                    to_dict=to_dict,
-                    by_alias=by_alias,
-                    include=value_include and value_include.for_element(field_key),
-                    exclude=value_exclude and value_exclude.for_element(field_key),
-                    exclude_unset=exclude_unset,
-                    exclude_defaults=exclude_defaults,
-                    exclude_none=exclude_none,
-                )
-            yield dict_key, v
-
-    def _calculate_keys(
-        self,
-        include: Optional['MappingIntStrAny'],
-        exclude: Optional['MappingIntStrAny'],
-        exclude_unset: bool,
-        update: Optional['DictStrAny'] = None,
-    ) -> Optional[AbstractSet[str]]:
-        if include is None and exclude is None and exclude_unset is False:
-            return None
-
-        keys: AbstractSet[str]
-        if exclude_unset:
-            keys = self.__fields_set__.copy()
-        else:
-            keys = self.__dict__.keys()
-
-        if include is not None:
-            keys &= include.keys()
-
-        if update:
-            keys -= update.keys()
+            fields_set = set(self.__pydantic_fields_set__)
 
+        # removing excluded fields from `__pydantic_fields_set__`
         if exclude:
-            keys -= {k for k, v in exclude.items() if ValueItems.is_true(v)}
+            fields_set -= set(exclude)
 
-        return keys
+        return copy_internals._copy_and_set_values(self, values, fields_set, extra, private, deep=deep)
 
-    def __eq__(self, other: Any) -> bool:
-        if isinstance(other, BaseModel):
-            return self.dict() == other.dict()
-        else:
-            return self.dict() == other
+    @classmethod
+    @typing_extensions.deprecated('The `schema` method is deprecated; use `model_json_schema` instead.', category=None)
+    def schema(  # noqa: D102
+        cls, by_alias: bool = True, ref_template: str = DEFAULT_REF_TEMPLATE
+    ) -> typing.Dict[str, Any]:  # noqa UP006
+        warnings.warn(
+            'The `schema` method is deprecated; use `model_json_schema` instead.', category=PydanticDeprecatedSince20
+        )
+        return cls.model_json_schema(by_alias=by_alias, ref_template=ref_template)
 
-    def __repr_args__(self) -> 'ReprArgs':
-        return [
-            (k, v)
-            for k, v in self.__dict__.items()
-            if k not in DUNDER_ATTRIBUTES and (k not in self.__fields__ or self.__fields__[k].field_info.repr)
-        ]
+    @classmethod
+    @typing_extensions.deprecated(
+        'The `schema_json` method is deprecated; use `model_json_schema` and json.dumps instead.',
+        category=None,
+    )
+    def schema_json(  # noqa: D102
+        cls, *, by_alias: bool = True, ref_template: str = DEFAULT_REF_TEMPLATE, **dumps_kwargs: Any
+    ) -> str:  # pragma: no cover
+        warnings.warn(
+            'The `schema_json` method is deprecated; use `model_json_schema` and json.dumps instead.',
+            category=PydanticDeprecatedSince20,
+        )
+        import json
+
+        from .deprecated.json import pydantic_encoder
+
+        return json.dumps(
+            cls.model_json_schema(by_alias=by_alias, ref_template=ref_template),
+            default=pydantic_encoder,
+            **dumps_kwargs,
+        )
+
+    @classmethod
+    @typing_extensions.deprecated('The `validate` method is deprecated; use `model_validate` instead.', category=None)
+    def validate(cls: type[Model], value: Any) -> Model:  # noqa: D102
+        warnings.warn(
+            'The `validate` method is deprecated; use `model_validate` instead.', category=PydanticDeprecatedSince20
+        )
+        return cls.model_validate(value)
+
+    @classmethod
+    @typing_extensions.deprecated(
+        'The `update_forward_refs` method is deprecated; use `model_rebuild` instead.',
+        category=None,
+    )
+    def update_forward_refs(cls, **localns: Any) -> None:  # noqa: D102
+        warnings.warn(
+            'The `update_forward_refs` method is deprecated; use `model_rebuild` instead.',
+            category=PydanticDeprecatedSince20,
+        )
+        if localns:  # pragma: no cover
+            raise TypeError('`localns` arguments are not longer accepted.')
+        cls.model_rebuild(force=True)
+
+    @typing_extensions.deprecated(
+        'The private method `_iter` will be removed and should no longer be used.', category=None
+    )
+    def _iter(self, *args: Any, **kwargs: Any) -> Any:
+        warnings.warn(
+            'The private method `_iter` will be removed and should no longer be used.',
+            category=PydanticDeprecatedSince20,
+        )
+        from .deprecated import copy_internals
+
+        return copy_internals._iter(self, *args, **kwargs)
+
+    @typing_extensions.deprecated(
+        'The private method `_copy_and_set_values` will be removed and should no longer be used.',
+        category=None,
+    )
+    def _copy_and_set_values(self, *args: Any, **kwargs: Any) -> Any:
+        warnings.warn(
+            'The private method `_copy_and_set_values` will be removed and should no longer be used.',
+            category=PydanticDeprecatedSince20,
+        )
+        from .deprecated import copy_internals
+
+        return copy_internals._copy_and_set_values(self, *args, **kwargs)
+
+    @classmethod
+    @typing_extensions.deprecated(
+        'The private method `_get_value` will be removed and should no longer be used.',
+        category=None,
+    )
+    def _get_value(cls, *args: Any, **kwargs: Any) -> Any:
+        warnings.warn(
+            'The private method `_get_value` will be removed and should no longer be used.',
+            category=PydanticDeprecatedSince20,
+        )
+        from .deprecated import copy_internals
+
+        return copy_internals._get_value(cls, *args, **kwargs)
+
+    @typing_extensions.deprecated(
+        'The private method `_calculate_keys` will be removed and should no longer be used.',
+        category=None,
+    )
+    def _calculate_keys(self, *args: Any, **kwargs: Any) -> Any:
+        warnings.warn(
+            'The private method `_calculate_keys` will be removed and should no longer be used.',
+            category=PydanticDeprecatedSince20,
+        )
+        from .deprecated import copy_internals
+
+        return copy_internals._calculate_keys(self, *args, **kwargs)
 
 
-_is_base_model_class_defined = True
-
-
-@overload
+@typing.overload
 def create_model(
     __model_name: str,
     *,
-    __config__: Optional[Type[BaseConfig]] = None,
+    __config__: ConfigDict | None = None,
+    __doc__: str | None = None,
     __base__: None = None,
     __module__: str = __name__,
-    __validators__: Dict[str, 'AnyClassMethod'] = None,
-    __cls_kwargs__: Dict[str, Any] = None,
+    __validators__: dict[str, classmethod] | None = None,
+    __cls_kwargs__: dict[str, Any] | None = None,
     **field_definitions: Any,
-) -> Type['BaseModel']:
+) -> type[BaseModel]:
     ...
 
 
-@overload
+@typing.overload
 def create_model(
     __model_name: str,
     *,
-    __config__: Optional[Type[BaseConfig]] = None,
-    __base__: Union[Type['Model'], Tuple[Type['Model'], ...]],
+    __config__: ConfigDict | None = None,
+    __doc__: str | None = None,
+    __base__: type[Model] | tuple[type[Model], ...],
     __module__: str = __name__,
-    __validators__: Dict[str, 'AnyClassMethod'] = None,
-    __cls_kwargs__: Dict[str, Any] = None,
+    __validators__: dict[str, classmethod] | None = None,
+    __cls_kwargs__: dict[str, Any] | None = None,
     **field_definitions: Any,
-) -> Type['Model']:
+) -> type[Model]:
     ...
 
 
-def create_model(
+def create_model(  # noqa: C901
     __model_name: str,
     *,
-    __config__: Optional[Type[BaseConfig]] = None,
-    __base__: Union[None, Type['Model'], Tuple[Type['Model'], ...]] = None,
-    __module__: str = __name__,
-    __validators__: Dict[str, 'AnyClassMethod'] = None,
-    __cls_kwargs__: Dict[str, Any] = None,
-    __slots__: Optional[Tuple[str, ...]] = None,
+    __config__: ConfigDict | None = None,
+    __doc__: str | None = None,
+    __base__: type[Model] | tuple[type[Model], ...] | None = None,
+    __module__: str | None = None,
+    __validators__: dict[str, classmethod] | None = None,
+    __cls_kwargs__: dict[str, Any] | None = None,
+    __slots__: tuple[str, ...] | None = None,
     **field_definitions: Any,
-) -> Type['Model']:
-    """
-    Dynamically create a model.
-    :param __model_name: name of the created model
-    :param __config__: config class to use for the new model
-    :param __base__: base class for the new model to inherit from
-    :param __module__: module of the created model
-    :param __validators__: a dict of method names and @validator class methods
-    :param __cls_kwargs__: a dict for class creation
-    :param __slots__: Deprecated, `__slots__` should not be passed to `create_model`
-    :param field_definitions: fields of the model (or extra fields if a base is supplied)
-        in the format `<name>=(<type>, <default default>)` or `<name>=<default value>, e.g.
-        `foobar=(str, ...)` or `foobar=123`, or, for complex use-cases, in the format
-        `<name>=<Field>` or `<name>=(<type>, <FieldInfo>)`, e.g.
-        `foo=Field(datetime, default_factory=datetime.utcnow, alias='bar')` or
-        `foo=(str, FieldInfo(title='Foo'))`
+) -> type[Model]:
+    """Usage docs: https://docs.pydantic.dev/2.6/concepts/models/#dynamic-model-creation
+
+    Dynamically creates and returns a new Pydantic model, in other words, `create_model` dynamically creates a
+    subclass of [`BaseModel`][pydantic.BaseModel].
+
+    Args:
+        __model_name: The name of the newly created model.
+        __config__: The configuration of the new model.
+        __doc__: The docstring of the new model.
+        __base__: The base class or classes for the new model.
+        __module__: The name of the module that the model belongs to;
+            if `None`, the value is taken from `sys._getframe(1)`
+        __validators__: A dictionary of methods that validate fields.
+        __cls_kwargs__: A dictionary of keyword arguments for class creation, such as `metaclass`.
+        __slots__: Deprecated. Should not be passed to `create_model`.
+        **field_definitions: Attributes of the new model. They should be passed in the format:
+            `<name>=(<type>, <default value>)` or `<name>=(<type>, <FieldInfo>)`.
+
+    Returns:
+        The new [model][pydantic.BaseModel].
+
+    Raises:
+        PydanticUserError: If `__base__` and `__config__` are both passed.
     """
     if __slots__ is not None:
         # __slots__ will be ignored from here on
@@ -982,11 +1436,14 @@ def create_model(
 
     if __base__ is not None:
         if __config__ is not None:
-            raise ConfigError('to avoid confusion __config__ and __base__ cannot be used together')
+            raise PydanticUserError(
+                'to avoid confusion `__config__` and `__base__` cannot be used together',
+                code='create-model-config-base',
+            )
         if not isinstance(__base__, tuple):
             __base__ = (__base__,)
     else:
-        __base__ = (cast(Type['Model'], BaseModel),)
+        __base__ = (typing.cast(typing.Type['Model'], BaseModel),)
 
     __cls_kwargs__ = __cls_kwargs__ or {}
 
@@ -994,16 +1451,16 @@ def create_model(
     annotations = {}
 
     for f_name, f_def in field_definitions.items():
-        if not is_valid_field(f_name):
+        if not _fields.is_valid_field_name(f_name):
             warnings.warn(f'fields may not start with an underscore, ignoring "{f_name}"', RuntimeWarning)
         if isinstance(f_def, tuple):
+            f_def = typing.cast('tuple[str, Any]', f_def)
             try:
                 f_annotation, f_value = f_def
             except ValueError as e:
-                raise ConfigError(
-                    'field definitions should either be a tuple of (<type>, <default>) or just a '
-                    'default value, unfortunately this means tuples as '
-                    'default values are not allowed'
+                raise PydanticUserError(
+                    'Field definitions should be a `(<type>, <default>)`.',
+                    code='create-model-field-definitions',
                 ) from e
         else:
             f_annotation, f_value = None, f_def
@@ -1012,98 +1469,32 @@ def create_model(
             annotations[f_name] = f_annotation
         fields[f_name] = f_value
 
-    namespace: 'DictStrAny' = {'__annotations__': annotations, '__module__': __module__}
+    if __module__ is None:
+        f = sys._getframe(1)
+        __module__ = f.f_globals['__name__']
+
+    namespace: dict[str, Any] = {'__annotations__': annotations, '__module__': __module__}
+    if __doc__:
+        namespace.update({'__doc__': __doc__})
     if __validators__:
         namespace.update(__validators__)
     namespace.update(fields)
     if __config__:
-        namespace['Config'] = inherit_config(__config__, BaseConfig)
-    resolved_bases = resolve_bases(__base__)
-    meta, ns, kwds = prepare_class(__model_name, resolved_bases, kwds=__cls_kwargs__)
+        namespace['model_config'] = _config.ConfigWrapper(__config__).config_dict
+    resolved_bases = types.resolve_bases(__base__)
+    meta, ns, kwds = types.prepare_class(__model_name, resolved_bases, kwds=__cls_kwargs__)
     if resolved_bases is not __base__:
         ns['__orig_bases__'] = __base__
     namespace.update(ns)
-    return meta(__model_name, resolved_bases, namespace, **kwds)
+
+    return meta(
+        __model_name,
+        resolved_bases,
+        namespace,
+        __pydantic_reset_parent_namespace__=False,
+        _create_model_module=__module__,
+        **kwds,
+    )
 
 
-_missing = object()
-
-
-def validate_model(  # noqa: C901 (ignore complexity)
-    model: Type[BaseModel], input_data: 'DictStrAny', cls: 'ModelOrDc' = None
-) -> Tuple['DictStrAny', 'SetStr', Optional[ValidationError]]:
-    """
-    validate data against a model.
-    """
-    values = {}
-    errors = []
-    # input_data names, possibly alias
-    names_used = set()
-    # field names, never aliases
-    fields_set = set()
-    config = model.__config__
-    check_extra = config.extra is not Extra.ignore
-    cls_ = cls or model
-
-    for validator in model.__pre_root_validators__:
-        try:
-            input_data = validator(cls_, input_data)
-        except (ValueError, TypeError, AssertionError) as exc:
-            return {}, set(), ValidationError([ErrorWrapper(exc, loc=ROOT_KEY)], cls_)
-
-    for name, field in model.__fields__.items():
-        value = input_data.get(field.alias, _missing)
-        using_name = False
-        if value is _missing and config.allow_population_by_field_name and field.alt_alias:
-            value = input_data.get(field.name, _missing)
-            using_name = True
-
-        if value is _missing:
-            if field.required:
-                errors.append(ErrorWrapper(MissingError(), loc=field.alias))
-                continue
-
-            value = field.get_default()
-
-            if not config.validate_all and not field.validate_always:
-                values[name] = value
-                continue
-        else:
-            fields_set.add(name)
-            if check_extra:
-                names_used.add(field.name if using_name else field.alias)
-
-        v_, errors_ = field.validate(value, values, loc=field.alias, cls=cls_)
-        if isinstance(errors_, ErrorWrapper):
-            errors.append(errors_)
-        elif isinstance(errors_, list):
-            errors.extend(errors_)
-        else:
-            values[name] = v_
-
-    if check_extra:
-        if isinstance(input_data, GetterDict):
-            extra = input_data.extra_keys() - names_used
-        else:
-            extra = input_data.keys() - names_used
-        if extra:
-            fields_set |= extra
-            if config.extra is Extra.allow:
-                for f in extra:
-                    values[f] = input_data[f]
-            else:
-                for f in sorted(extra):
-                    errors.append(ErrorWrapper(ExtraError(), loc=f))
-
-    for skip_on_failure, validator in model.__post_root_validators__:
-        if skip_on_failure and errors:
-            continue
-        try:
-            values = validator(cls_, values)
-        except (ValueError, TypeError, AssertionError) as exc:
-            errors.append(ErrorWrapper(exc, loc=ROOT_KEY))
-
-    if errors:
-        return values, fields_set, ValidationError(errors, cls_)
-    else:
-        return values, fields_set, None
+__getattr__ = getattr_migration(__name__)
diff --git a/lib/pydantic/mypy.py b/lib/pydantic/mypy.py
index 6bd9db18..0e70eab5 100644
--- a/lib/pydantic/mypy.py
+++ b/lib/pydantic/mypy.py
@@ -1,8 +1,13 @@
+"""This module includes classes and functions designed specifically for use with the mypy plugin."""
+
+from __future__ import annotations
+
 import sys
 from configparser import ConfigParser
-from typing import Any, Callable, Dict, List, Optional, Set, Tuple, Type as TypingType, Union
+from typing import Any, Callable, Iterator
 
 from mypy.errorcodes import ErrorCode
+from mypy.expandtype import expand_type, expand_type_by_instance
 from mypy.nodes import (
     ARG_NAMED,
     ARG_NAMED_OPT,
@@ -17,21 +22,23 @@ from mypy.nodes import (
     ClassDef,
     Context,
     Decorator,
+    DictExpr,
     EllipsisExpr,
-    FuncBase,
+    Expression,
     FuncDef,
+    IfStmt,
     JsonDict,
     MemberExpr,
     NameExpr,
     PassStmt,
     PlaceholderNode,
     RefExpr,
+    Statement,
     StrExpr,
-    SymbolNode,
     SymbolTableNode,
     TempNode,
+    TypeAlias,
     TypeInfo,
-    TypeVarExpr,
     Var,
 )
 from mypy.options import Options
@@ -41,11 +48,17 @@ from mypy.plugin import (
     FunctionContext,
     MethodContext,
     Plugin,
+    ReportConfigContext,
     SemanticAnalyzerPluginInterface,
 )
 from mypy.plugins import dataclasses
-from mypy.semanal import set_callable_name  # type: ignore
+from mypy.plugins.common import (
+    deserialize_and_fixup_type,
+)
+from mypy.semanal import set_callable_name
 from mypy.server.trigger import make_wildcard_trigger
+from mypy.state import state
+from mypy.typeops import map_type_from_supertype
 from mypy.types import (
     AnyType,
     CallableType,
@@ -63,76 +76,131 @@ from mypy.typevars import fill_typevars
 from mypy.util import get_unique_redefinition_name
 from mypy.version import __version__ as mypy_version
 
-from pydantic.utils import is_valid_field
+from pydantic._internal import _fields
+from pydantic.version import parse_mypy_version
 
 try:
     from mypy.types import TypeVarDef  # type: ignore[attr-defined]
 except ImportError:  # pragma: no cover
-    # Backward-compatible with TypeVarDef from Mypy 0.910.
+    # Backward-compatible with TypeVarDef from Mypy 0.930.
     from mypy.types import TypeVarType as TypeVarDef
 
 CONFIGFILE_KEY = 'pydantic-mypy'
 METADATA_KEY = 'pydantic-mypy-metadata'
 BASEMODEL_FULLNAME = 'pydantic.main.BaseModel'
-BASESETTINGS_FULLNAME = 'pydantic.env_settings.BaseSettings'
+BASESETTINGS_FULLNAME = 'pydantic_settings.main.BaseSettings'
+ROOT_MODEL_FULLNAME = 'pydantic.root_model.RootModel'
+MODEL_METACLASS_FULLNAME = 'pydantic._internal._model_construction.ModelMetaclass'
 FIELD_FULLNAME = 'pydantic.fields.Field'
 DATACLASS_FULLNAME = 'pydantic.dataclasses.dataclass'
-
-
-def parse_mypy_version(version: str) -> Tuple[int, ...]:
-    return tuple(int(part) for part in version.split('+', 1)[0].split('.'))
+MODEL_VALIDATOR_FULLNAME = 'pydantic.functional_validators.model_validator'
+DECORATOR_FULLNAMES = {
+    'pydantic.functional_validators.field_validator',
+    'pydantic.functional_validators.model_validator',
+    'pydantic.functional_serializers.serializer',
+    'pydantic.functional_serializers.model_serializer',
+    'pydantic.deprecated.class_validators.validator',
+    'pydantic.deprecated.class_validators.root_validator',
+}
 
 
 MYPY_VERSION_TUPLE = parse_mypy_version(mypy_version)
 BUILTINS_NAME = 'builtins' if MYPY_VERSION_TUPLE >= (0, 930) else '__builtins__'
 
+# Increment version if plugin changes and mypy caches should be invalidated
+__version__ = 2
 
-def plugin(version: str) -> 'TypingType[Plugin]':
-    """
-    `version` is the mypy version string
+
+def plugin(version: str) -> type[Plugin]:
+    """`version` is the mypy version string.
 
     We might want to use this to print a warning if the mypy version being used is
     newer, or especially older, than we expect (or need).
+
+    Args:
+        version: The mypy version string.
+
+    Return:
+        The Pydantic mypy plugin type.
     """
     return PydanticPlugin
 
 
+class _DeferAnalysis(Exception):
+    pass
+
+
 class PydanticPlugin(Plugin):
+    """The Pydantic mypy plugin."""
+
     def __init__(self, options: Options) -> None:
         self.plugin_config = PydanticPluginConfig(options)
+        self._plugin_data = self.plugin_config.to_data()
         super().__init__(options)
 
-    def get_base_class_hook(self, fullname: str) -> 'Optional[Callable[[ClassDefContext], None]]':
+    def get_base_class_hook(self, fullname: str) -> Callable[[ClassDefContext], bool] | None:
+        """Update Pydantic model class."""
         sym = self.lookup_fully_qualified(fullname)
         if sym and isinstance(sym.node, TypeInfo):  # pragma: no branch
             # No branching may occur if the mypy cache has not been cleared
-            if any(get_fullname(base) == BASEMODEL_FULLNAME for base in sym.node.mro):
+            if any(base.fullname == BASEMODEL_FULLNAME for base in sym.node.mro):
                 return self._pydantic_model_class_maker_callback
         return None
 
-    def get_function_hook(self, fullname: str) -> 'Optional[Callable[[FunctionContext], Type]]':
+    def get_metaclass_hook(self, fullname: str) -> Callable[[ClassDefContext], None] | None:
+        """Update Pydantic `ModelMetaclass` definition."""
+        if fullname == MODEL_METACLASS_FULLNAME:
+            return self._pydantic_model_metaclass_marker_callback
+        return None
+
+    def get_function_hook(self, fullname: str) -> Callable[[FunctionContext], Type] | None:
+        """Adjust the return type of the `Field` function."""
         sym = self.lookup_fully_qualified(fullname)
         if sym and sym.fullname == FIELD_FULLNAME:
             return self._pydantic_field_callback
         return None
 
-    def get_method_hook(self, fullname: str) -> Optional[Callable[[MethodContext], Type]]:
+    def get_method_hook(self, fullname: str) -> Callable[[MethodContext], Type] | None:
+        """Adjust return type of `from_orm` method call."""
         if fullname.endswith('.from_orm'):
-            return from_orm_callback
+            return from_attributes_callback
         return None
 
-    def get_class_decorator_hook(self, fullname: str) -> Optional[Callable[[ClassDefContext], None]]:
-        if fullname == DATACLASS_FULLNAME:
+    def get_class_decorator_hook(self, fullname: str) -> Callable[[ClassDefContext], None] | None:
+        """Mark pydantic.dataclasses as dataclass.
+
+        Mypy version 1.1.1 added support for `@dataclass_transform` decorator.
+        """
+        if fullname == DATACLASS_FULLNAME and MYPY_VERSION_TUPLE < (1, 1):
             return dataclasses.dataclass_class_maker_callback  # type: ignore[return-value]
         return None
 
-    def _pydantic_model_class_maker_callback(self, ctx: ClassDefContext) -> None:
-        transformer = PydanticModelTransformer(ctx, self.plugin_config)
-        transformer.transform()
+    def report_config_data(self, ctx: ReportConfigContext) -> dict[str, Any]:
+        """Return all plugin config data.
 
-    def _pydantic_field_callback(self, ctx: FunctionContext) -> 'Type':
+        Used by mypy to determine if cache needs to be discarded.
         """
-        Extract the type of the `default` argument from the Field function, and use it as the return type.
+        return self._plugin_data
+
+    def _pydantic_model_class_maker_callback(self, ctx: ClassDefContext) -> bool:
+        transformer = PydanticModelTransformer(ctx.cls, ctx.reason, ctx.api, self.plugin_config)
+        return transformer.transform()
+
+    def _pydantic_model_metaclass_marker_callback(self, ctx: ClassDefContext) -> None:
+        """Reset dataclass_transform_spec attribute of ModelMetaclass.
+
+        Let the plugin handle it. This behavior can be disabled
+        if 'debug_dataclass_transform' is set to True', for testing purposes.
+        """
+        if self.plugin_config.debug_dataclass_transform:
+            return
+        info_metaclass = ctx.cls.info.declared_metaclass
+        assert info_metaclass, "callback not passed from 'get_metaclass_hook'"
+        if getattr(info_metaclass.type, 'dataclass_transform_spec', None):
+            info_metaclass.type.dataclass_transform_spec = None
+
+    def _pydantic_field_callback(self, ctx: FunctionContext) -> Type:
+        """Extract the type of the `default` argument from the Field function, and use it as the return type.
 
         In particular:
         * Check whether the default and default_factory argument is specified.
@@ -164,11 +232,7 @@ class PydanticPlugin(Plugin):
             # Functions which use `ParamSpec` can be overloaded, exposing the callable's types as a parameter
             # Pydantic calls the default factory without any argument, so we retrieve the first item
             if isinstance(default_factory_type, Overloaded):
-                if MYPY_VERSION_TUPLE > (0, 910):
-                    default_factory_type = default_factory_type.items[0]
-                else:
-                    # Mypy0.910 exposes the items of overloaded types in a function
-                    default_factory_type = default_factory_type.items()[0]  # type: ignore[operator]
+                default_factory_type = default_factory_type.items[0]
 
             if isinstance(default_factory_type, CallableType):
                 ret_type = default_factory_type.ret_type
@@ -185,11 +249,26 @@ class PydanticPlugin(Plugin):
 
 
 class PydanticPluginConfig:
-    __slots__ = ('init_forbid_extra', 'init_typed', 'warn_required_dynamic_aliases', 'warn_untyped_fields')
+    """A Pydantic mypy plugin config holder.
+
+    Attributes:
+        init_forbid_extra: Whether to add a `**kwargs` at the end of the generated `__init__` signature.
+        init_typed: Whether to annotate fields in the generated `__init__`.
+        warn_required_dynamic_aliases: Whether to raise required dynamic aliases error.
+        debug_dataclass_transform: Whether to not reset `dataclass_transform_spec` attribute
+            of `ModelMetaclass` for testing purposes.
+    """
+
+    __slots__ = (
+        'init_forbid_extra',
+        'init_typed',
+        'warn_required_dynamic_aliases',
+        'debug_dataclass_transform',
+    )
     init_forbid_extra: bool
     init_typed: bool
     warn_required_dynamic_aliases: bool
-    warn_untyped_fields: bool
+    debug_dataclass_transform: bool  # undocumented
 
     def __init__(self, options: Options) -> None:
         if options.config_file is None:  # pragma: no cover
@@ -210,343 +289,724 @@ class PydanticPluginConfig:
                 setting = plugin_config.getboolean(CONFIGFILE_KEY, key, fallback=False)
                 setattr(self, key, setting)
 
+    def to_data(self) -> dict[str, Any]:
+        """Returns a dict of config names to their values."""
+        return {key: getattr(self, key) for key in self.__slots__}
 
-def from_orm_callback(ctx: MethodContext) -> Type:
-    """
-    Raise an error if orm_mode is not enabled
-    """
+
+def from_attributes_callback(ctx: MethodContext) -> Type:
+    """Raise an error if from_attributes is not enabled."""
     model_type: Instance
-    if isinstance(ctx.type, CallableType) and isinstance(ctx.type.ret_type, Instance):
-        model_type = ctx.type.ret_type  # called on the class
-    elif isinstance(ctx.type, Instance):
-        model_type = ctx.type  # called on an instance (unusual, but still valid)
+    ctx_type = ctx.type
+    if isinstance(ctx_type, TypeType):
+        ctx_type = ctx_type.item
+    if isinstance(ctx_type, CallableType) and isinstance(ctx_type.ret_type, Instance):
+        model_type = ctx_type.ret_type  # called on the class
+    elif isinstance(ctx_type, Instance):
+        model_type = ctx_type  # called on an instance (unusual, but still valid)
     else:  # pragma: no cover
-        detail = f'ctx.type: {ctx.type} (of type {ctx.type.__class__.__name__})'
+        detail = f'ctx.type: {ctx_type} (of type {ctx_type.__class__.__name__})'
         error_unexpected_behavior(detail, ctx.api, ctx.context)
         return ctx.default_return_type
     pydantic_metadata = model_type.type.metadata.get(METADATA_KEY)
     if pydantic_metadata is None:
         return ctx.default_return_type
-    orm_mode = pydantic_metadata.get('config', {}).get('orm_mode')
-    if orm_mode is not True:
-        error_from_orm(get_name(model_type.type), ctx.api, ctx.context)
+    from_attributes = pydantic_metadata.get('config', {}).get('from_attributes')
+    if from_attributes is not True:
+        error_from_attributes(model_type.type.name, ctx.api, ctx.context)
     return ctx.default_return_type
 
 
+class PydanticModelField:
+    """Based on mypy.plugins.dataclasses.DataclassAttribute."""
+
+    def __init__(
+        self,
+        name: str,
+        alias: str | None,
+        has_dynamic_alias: bool,
+        has_default: bool,
+        line: int,
+        column: int,
+        type: Type | None,
+        info: TypeInfo,
+    ):
+        self.name = name
+        self.alias = alias
+        self.has_dynamic_alias = has_dynamic_alias
+        self.has_default = has_default
+        self.line = line
+        self.column = column
+        self.type = type
+        self.info = info
+
+    def to_argument(
+        self,
+        current_info: TypeInfo,
+        typed: bool,
+        force_optional: bool,
+        use_alias: bool,
+        api: SemanticAnalyzerPluginInterface,
+    ) -> Argument:
+        """Based on mypy.plugins.dataclasses.DataclassAttribute.to_argument."""
+        variable = self.to_var(current_info, api, use_alias)
+        type_annotation = self.expand_type(current_info, api) if typed else AnyType(TypeOfAny.explicit)
+        return Argument(
+            variable=variable,
+            type_annotation=type_annotation,
+            initializer=None,
+            kind=ARG_NAMED_OPT if force_optional or self.has_default else ARG_NAMED,
+        )
+
+    def expand_type(self, current_info: TypeInfo, api: SemanticAnalyzerPluginInterface) -> Type | None:
+        """Based on mypy.plugins.dataclasses.DataclassAttribute.expand_type."""
+        # The getattr in the next line is used to prevent errors in legacy versions of mypy without this attribute
+        if self.type is not None and getattr(self.info, 'self_type', None) is not None:
+            # In general, it is not safe to call `expand_type()` during semantic analyzis,
+            # however this plugin is called very late, so all types should be fully ready.
+            # Also, it is tricky to avoid eager expansion of Self types here (e.g. because
+            # we serialize attributes).
+            expanded_type = expand_type(self.type, {self.info.self_type.id: fill_typevars(current_info)})
+            if isinstance(self.type, UnionType) and not isinstance(expanded_type, UnionType):
+                if not api.final_iteration:
+                    raise _DeferAnalysis()
+            return expanded_type
+        return self.type
+
+    def to_var(self, current_info: TypeInfo, api: SemanticAnalyzerPluginInterface, use_alias: bool) -> Var:
+        """Based on mypy.plugins.dataclasses.DataclassAttribute.to_var."""
+        if use_alias and self.alias is not None:
+            name = self.alias
+        else:
+            name = self.name
+
+        return Var(name, self.expand_type(current_info, api))
+
+    def serialize(self) -> JsonDict:
+        """Based on mypy.plugins.dataclasses.DataclassAttribute.serialize."""
+        assert self.type
+        return {
+            'name': self.name,
+            'alias': self.alias,
+            'has_dynamic_alias': self.has_dynamic_alias,
+            'has_default': self.has_default,
+            'line': self.line,
+            'column': self.column,
+            'type': self.type.serialize(),
+        }
+
+    @classmethod
+    def deserialize(cls, info: TypeInfo, data: JsonDict, api: SemanticAnalyzerPluginInterface) -> PydanticModelField:
+        """Based on mypy.plugins.dataclasses.DataclassAttribute.deserialize."""
+        data = data.copy()
+        typ = deserialize_and_fixup_type(data.pop('type'), api)
+        return cls(type=typ, info=info, **data)
+
+    def expand_typevar_from_subtype(self, sub_type: TypeInfo) -> None:
+        """Expands type vars in the context of a subtype when an attribute is inherited
+        from a generic super type.
+        """
+        if self.type is not None:
+            self.type = map_type_from_supertype(self.type, sub_type, self.info)
+
+
+class PydanticModelClassVar:
+    """Based on mypy.plugins.dataclasses.DataclassAttribute.
+
+    ClassVars are ignored by subclasses.
+
+    Attributes:
+        name: the ClassVar name
+    """
+
+    def __init__(self, name):
+        self.name = name
+
+    @classmethod
+    def deserialize(cls, data: JsonDict) -> PydanticModelClassVar:
+        """Based on mypy.plugins.dataclasses.DataclassAttribute.deserialize."""
+        data = data.copy()
+        return cls(**data)
+
+    def serialize(self) -> JsonDict:
+        """Based on mypy.plugins.dataclasses.DataclassAttribute.serialize."""
+        return {
+            'name': self.name,
+        }
+
+
 class PydanticModelTransformer:
-    tracked_config_fields: Set[str] = {
+    """Transform the BaseModel subclass according to the plugin settings.
+
+    Attributes:
+        tracked_config_fields: A set of field configs that the plugin has to track their value.
+    """
+
+    tracked_config_fields: set[str] = {
         'extra',
-        'allow_mutation',
         'frozen',
-        'orm_mode',
-        'allow_population_by_field_name',
+        'from_attributes',
+        'populate_by_name',
         'alias_generator',
     }
 
-    def __init__(self, ctx: ClassDefContext, plugin_config: PydanticPluginConfig) -> None:
-        self._ctx = ctx
+    def __init__(
+        self,
+        cls: ClassDef,
+        reason: Expression | Statement,
+        api: SemanticAnalyzerPluginInterface,
+        plugin_config: PydanticPluginConfig,
+    ) -> None:
+        self._cls = cls
+        self._reason = reason
+        self._api = api
+
         self.plugin_config = plugin_config
 
-    def transform(self) -> None:
-        """
-        Configures the BaseModel subclass according to the plugin settings.
+    def transform(self) -> bool:
+        """Configures the BaseModel subclass according to the plugin settings.
 
         In particular:
+
         * determines the model config and fields,
         * adds a fields-aware signature for the initializer and construct methods
-        * freezes the class if allow_mutation = False or frozen = True
+        * freezes the class if frozen = True
         * stores the fields, config, and if the class is settings in the mypy metadata for access by subclasses
         """
-        ctx = self._ctx
-        info = self._ctx.cls.info
-
-        self.adjust_validator_signatures()
+        info = self._cls.info
+        is_root_model = any(ROOT_MODEL_FULLNAME in base.fullname for base in info.mro[:-1])
         config = self.collect_config()
-        fields = self.collect_fields(config)
+        fields, class_vars = self.collect_fields_and_class_vars(config, is_root_model)
+        if fields is None or class_vars is None:
+            # Some definitions are not ready. We need another pass.
+            return False
         for field in fields:
-            if info[field.name].type is None:
-                if not ctx.api.final_iteration:
-                    ctx.api.defer()
-        is_settings = any(get_fullname(base) == BASESETTINGS_FULLNAME for base in info.mro[:-1])
-        self.add_initializer(fields, config, is_settings)
-        self.add_construct_method(fields)
-        self.set_frozen(fields, frozen=config.allow_mutation is False or config.frozen is True)
+            if field.type is None:
+                return False
+
+        is_settings = any(base.fullname == BASESETTINGS_FULLNAME for base in info.mro[:-1])
+        try:
+            self.add_initializer(fields, config, is_settings, is_root_model)
+            self.add_model_construct_method(fields, config, is_settings)
+            self.set_frozen(fields, self._api, frozen=config.frozen is True)
+        except _DeferAnalysis:
+            if not self._api.final_iteration:
+                self._api.defer()
+
+        self.adjust_decorator_signatures()
+
         info.metadata[METADATA_KEY] = {
             'fields': {field.name: field.serialize() for field in fields},
-            'config': config.set_values_dict(),
+            'class_vars': {class_var.name: class_var.serialize() for class_var in class_vars},
+            'config': config.get_values_dict(),
         }
 
-    def adjust_validator_signatures(self) -> None:
-        """When we decorate a function `f` with `pydantic.validator(...), mypy sees
-        `f` as a regular method taking a `self` instance, even though pydantic
-        internally wraps `f` with `classmethod` if necessary.
+        return True
 
-        Teach mypy this by marking any function whose outermost decorator is a
-        `validator()` call as a classmethod.
+    def adjust_decorator_signatures(self) -> None:
+        """When we decorate a function `f` with `pydantic.validator(...)`, `pydantic.field_validator`
+        or `pydantic.serializer(...)`, mypy sees `f` as a regular method taking a `self` instance,
+        even though pydantic internally wraps `f` with `classmethod` if necessary.
+
+        Teach mypy this by marking any function whose outermost decorator is a `validator()`,
+        `field_validator()` or `serializer()` call as a `classmethod`.
         """
-        for name, sym in self._ctx.cls.info.names.items():
+        for name, sym in self._cls.info.names.items():
             if isinstance(sym.node, Decorator):
                 first_dec = sym.node.original_decorators[0]
                 if (
                     isinstance(first_dec, CallExpr)
                     and isinstance(first_dec.callee, NameExpr)
-                    and first_dec.callee.fullname == 'pydantic.class_validators.validator'
+                    and first_dec.callee.fullname in DECORATOR_FULLNAMES
+                    # @model_validator(mode="after") is an exception, it expects a regular method
+                    and not (
+                        first_dec.callee.fullname == MODEL_VALIDATOR_FULLNAME
+                        and any(
+                            first_dec.arg_names[i] == 'mode' and isinstance(arg, StrExpr) and arg.value == 'after'
+                            for i, arg in enumerate(first_dec.args)
+                        )
+                    )
                 ):
+                    # TODO: Only do this if the first argument of the decorated function is `cls`
                     sym.node.func.is_class = True
 
-    def collect_config(self) -> 'ModelConfigData':
-        """
-        Collects the values of the config attributes that are used by the plugin, accounting for parent classes.
-        """
-        ctx = self._ctx
-        cls = ctx.cls
+    def collect_config(self) -> ModelConfigData:  # noqa: C901 (ignore complexity)
+        """Collects the values of the config attributes that are used by the plugin, accounting for parent classes."""
+        cls = self._cls
         config = ModelConfigData()
+
+        has_config_kwargs = False
+        has_config_from_namespace = False
+
+        # Handle `class MyModel(BaseModel, <name>=<expr>, ...):`
+        for name, expr in cls.keywords.items():
+            config_data = self.get_config_update(name, expr)
+            if config_data:
+                has_config_kwargs = True
+                config.update(config_data)
+
+        # Handle `model_config`
+        stmt: Statement | None = None
         for stmt in cls.defs.body:
-            if not isinstance(stmt, ClassDef):
+            if not isinstance(stmt, (AssignmentStmt, ClassDef)):
                 continue
-            if stmt.name == 'Config':
+
+            if isinstance(stmt, AssignmentStmt):
+                lhs = stmt.lvalues[0]
+                if not isinstance(lhs, NameExpr) or lhs.name != 'model_config':
+                    continue
+
+                if isinstance(stmt.rvalue, CallExpr):  # calls to `dict` or `ConfigDict`
+                    for arg_name, arg in zip(stmt.rvalue.arg_names, stmt.rvalue.args):
+                        if arg_name is None:
+                            continue
+                        config.update(self.get_config_update(arg_name, arg))
+                elif isinstance(stmt.rvalue, DictExpr):  # dict literals
+                    for key_expr, value_expr in stmt.rvalue.items:
+                        if not isinstance(key_expr, StrExpr):
+                            continue
+                        config.update(self.get_config_update(key_expr.value, value_expr))
+
+            elif isinstance(stmt, ClassDef):
+                if stmt.name != 'Config':  # 'deprecated' Config-class
+                    continue
                 for substmt in stmt.defs.body:
                     if not isinstance(substmt, AssignmentStmt):
                         continue
-                    config.update(self.get_config_update(substmt))
-                if (
-                    config.has_alias_generator
-                    and not config.allow_population_by_field_name
-                    and self.plugin_config.warn_required_dynamic_aliases
-                ):
-                    error_required_dynamic_aliases(ctx.api, stmt)
+                    lhs = substmt.lvalues[0]
+                    if not isinstance(lhs, NameExpr):
+                        continue
+                    config.update(self.get_config_update(lhs.name, substmt.rvalue))
+
+            if has_config_kwargs:
+                self._api.fail(
+                    'Specifying config in two places is ambiguous, use either Config attribute or class kwargs',
+                    cls,
+                )
+                break
+
+            has_config_from_namespace = True
+
+        if has_config_kwargs or has_config_from_namespace:
+            if (
+                stmt
+                and config.has_alias_generator
+                and not config.populate_by_name
+                and self.plugin_config.warn_required_dynamic_aliases
+            ):
+                error_required_dynamic_aliases(self._api, stmt)
+
         for info in cls.info.mro[1:]:  # 0 is the current class
             if METADATA_KEY not in info.metadata:
                 continue
 
             # Each class depends on the set of fields in its ancestors
-            ctx.api.add_plugin_dependency(make_wildcard_trigger(get_fullname(info)))
+            self._api.add_plugin_dependency(make_wildcard_trigger(info.fullname))
             for name, value in info.metadata[METADATA_KEY]['config'].items():
                 config.setdefault(name, value)
         return config
 
-    def collect_fields(self, model_config: 'ModelConfigData') -> List['PydanticModelField']:
-        """
-        Collects the fields for the model, accounting for parent classes
-        """
-        # First, collect fields belonging to the current class.
-        ctx = self._ctx
-        cls = self._ctx.cls
-        fields = []  # type: List[PydanticModelField]
-        known_fields = set()  # type: Set[str]
-        for stmt in cls.defs.body:
-            if not isinstance(stmt, AssignmentStmt):  # `and stmt.new_syntax` to require annotation
-                continue
+    def collect_fields_and_class_vars(
+        self, model_config: ModelConfigData, is_root_model: bool
+    ) -> tuple[list[PydanticModelField] | None, list[PydanticModelClassVar] | None]:
+        """Collects the fields for the model, accounting for parent classes."""
+        cls = self._cls
 
-            lhs = stmt.lvalues[0]
-            if not isinstance(lhs, NameExpr) or not is_valid_field(lhs.name):
-                continue
-
-            if not stmt.new_syntax and self.plugin_config.warn_untyped_fields:
-                error_untyped_fields(ctx.api, stmt)
-
-            # if lhs.name == '__config__':  # BaseConfig not well handled; I'm not sure why yet
-            #     continue
-
-            sym = cls.info.names.get(lhs.name)
-            if sym is None:  # pragma: no cover
-                # This is likely due to a star import (see the dataclasses plugin for a more detailed explanation)
-                # This is the same logic used in the dataclasses plugin
-                continue
-
-            node = sym.node
-            if isinstance(node, PlaceholderNode):  # pragma: no cover
-                # See the PlaceholderNode docstring for more detail about how this can occur
-                # Basically, it is an edge case when dealing with complex import logic
-                # This is the same logic used in the dataclasses plugin
-                continue
-            if not isinstance(node, Var):  # pragma: no cover
-                # Don't know if this edge case still happens with the `is_valid_field` check above
-                # but better safe than sorry
-                continue
-
-            # x: ClassVar[int] is ignored by dataclasses.
-            if node.is_classvar:
-                continue
-
-            is_required = self.get_is_required(cls, stmt, lhs)
-            alias, has_dynamic_alias = self.get_alias_info(stmt)
-            if (
-                has_dynamic_alias
-                and not model_config.allow_population_by_field_name
-                and self.plugin_config.warn_required_dynamic_aliases
-            ):
-                error_required_dynamic_aliases(ctx.api, stmt)
-            fields.append(
-                PydanticModelField(
-                    name=lhs.name,
-                    is_required=is_required,
-                    alias=alias,
-                    has_dynamic_alias=has_dynamic_alias,
-                    line=stmt.line,
-                    column=stmt.column,
-                )
-            )
-            known_fields.add(lhs.name)
-        all_fields = fields.copy()
-        for info in cls.info.mro[1:]:  # 0 is the current class, -2 is BaseModel, -1 is object
+        # First, collect fields and ClassVars belonging to any class in the MRO, ignoring duplicates.
+        #
+        # We iterate through the MRO in reverse because attrs defined in the parent must appear
+        # earlier in the attributes list than attrs defined in the child. See:
+        # https://docs.python.org/3/library/dataclasses.html#inheritance
+        #
+        # However, we also want fields defined in the subtype to override ones defined
+        # in the parent. We can implement this via a dict without disrupting the attr order
+        # because dicts preserve insertion order in Python 3.7+.
+        found_fields: dict[str, PydanticModelField] = {}
+        found_class_vars: dict[str, PydanticModelClassVar] = {}
+        for info in reversed(cls.info.mro[1:-1]):  # 0 is the current class, -2 is BaseModel, -1 is object
+            # if BASEMODEL_METADATA_TAG_KEY in info.metadata and BASEMODEL_METADATA_KEY not in info.metadata:
+            #     # We haven't processed the base class yet. Need another pass.
+            #     return None, None
             if METADATA_KEY not in info.metadata:
                 continue
 
-            superclass_fields = []
-            # Each class depends on the set of fields in its ancestors
-            ctx.api.add_plugin_dependency(make_wildcard_trigger(get_fullname(info)))
+            # Each class depends on the set of attributes in its dataclass ancestors.
+            self._api.add_plugin_dependency(make_wildcard_trigger(info.fullname))
 
             for name, data in info.metadata[METADATA_KEY]['fields'].items():
-                if name not in known_fields:
-                    field = PydanticModelField.deserialize(info, data)
-                    known_fields.add(name)
-                    superclass_fields.append(field)
-                else:
-                    (field,) = (a for a in all_fields if a.name == name)
-                    all_fields.remove(field)
-                    superclass_fields.append(field)
-            all_fields = superclass_fields + all_fields
-        return all_fields
+                field = PydanticModelField.deserialize(info, data, self._api)
+                # (The following comment comes directly from the dataclasses plugin)
+                # TODO: We shouldn't be performing type operations during the main
+                #       semantic analysis pass, since some TypeInfo attributes might
+                #       still be in flux. This should be performed in a later phase.
+                with state.strict_optional_set(self._api.options.strict_optional):
+                    field.expand_typevar_from_subtype(cls.info)
+                found_fields[name] = field
 
-    def add_initializer(self, fields: List['PydanticModelField'], config: 'ModelConfigData', is_settings: bool) -> None:
+                sym_node = cls.info.names.get(name)
+                if sym_node and sym_node.node and not isinstance(sym_node.node, Var):
+                    self._api.fail(
+                        'BaseModel field may only be overridden by another field',
+                        sym_node.node,
+                    )
+            # Collect ClassVars
+            for name, data in info.metadata[METADATA_KEY]['class_vars'].items():
+                found_class_vars[name] = PydanticModelClassVar.deserialize(data)
+
+        # Second, collect fields and ClassVars belonging to the current class.
+        current_field_names: set[str] = set()
+        current_class_vars_names: set[str] = set()
+        for stmt in self._get_assignment_statements_from_block(cls.defs):
+            maybe_field = self.collect_field_or_class_var_from_stmt(stmt, model_config, found_class_vars)
+            if isinstance(maybe_field, PydanticModelField):
+                lhs = stmt.lvalues[0]
+                if is_root_model and lhs.name != 'root':
+                    error_extra_fields_on_root_model(self._api, stmt)
+                else:
+                    current_field_names.add(lhs.name)
+                    found_fields[lhs.name] = maybe_field
+            elif isinstance(maybe_field, PydanticModelClassVar):
+                lhs = stmt.lvalues[0]
+                current_class_vars_names.add(lhs.name)
+                found_class_vars[lhs.name] = maybe_field
+
+        return list(found_fields.values()), list(found_class_vars.values())
+
+    def _get_assignment_statements_from_if_statement(self, stmt: IfStmt) -> Iterator[AssignmentStmt]:
+        for body in stmt.body:
+            if not body.is_unreachable:
+                yield from self._get_assignment_statements_from_block(body)
+        if stmt.else_body is not None and not stmt.else_body.is_unreachable:
+            yield from self._get_assignment_statements_from_block(stmt.else_body)
+
+    def _get_assignment_statements_from_block(self, block: Block) -> Iterator[AssignmentStmt]:
+        for stmt in block.body:
+            if isinstance(stmt, AssignmentStmt):
+                yield stmt
+            elif isinstance(stmt, IfStmt):
+                yield from self._get_assignment_statements_from_if_statement(stmt)
+
+    def collect_field_or_class_var_from_stmt(  # noqa C901
+        self, stmt: AssignmentStmt, model_config: ModelConfigData, class_vars: dict[str, PydanticModelClassVar]
+    ) -> PydanticModelField | PydanticModelClassVar | None:
+        """Get pydantic model field from statement.
+
+        Args:
+            stmt: The statement.
+            model_config: Configuration settings for the model.
+            class_vars: ClassVars already known to be defined on the model.
+
+        Returns:
+            A pydantic model field if it could find the field in statement. Otherwise, `None`.
         """
-        Adds a fields-aware `__init__` method to the class.
+        cls = self._cls
+
+        lhs = stmt.lvalues[0]
+        if not isinstance(lhs, NameExpr) or not _fields.is_valid_field_name(lhs.name) or lhs.name == 'model_config':
+            return None
+
+        if not stmt.new_syntax:
+            if (
+                isinstance(stmt.rvalue, CallExpr)
+                and isinstance(stmt.rvalue.callee, CallExpr)
+                and isinstance(stmt.rvalue.callee.callee, NameExpr)
+                and stmt.rvalue.callee.callee.fullname in DECORATOR_FULLNAMES
+            ):
+                # This is a (possibly-reused) validator or serializer, not a field
+                # In particular, it looks something like: my_validator = validator('my_field')(f)
+                # Eventually, we may want to attempt to respect model_config['ignored_types']
+                return None
+
+            if lhs.name in class_vars:
+                # Class vars are not fields and are not required to be annotated
+                return None
+
+            # The assignment does not have an annotation, and it's not anything else we recognize
+            error_untyped_fields(self._api, stmt)
+            return None
+
+        lhs = stmt.lvalues[0]
+        if not isinstance(lhs, NameExpr):
+            return None
+
+        if not _fields.is_valid_field_name(lhs.name) or lhs.name == 'model_config':
+            return None
+
+        sym = cls.info.names.get(lhs.name)
+        if sym is None:  # pragma: no cover
+            # This is likely due to a star import (see the dataclasses plugin for a more detailed explanation)
+            # This is the same logic used in the dataclasses plugin
+            return None
+
+        node = sym.node
+        if isinstance(node, PlaceholderNode):  # pragma: no cover
+            # See the PlaceholderNode docstring for more detail about how this can occur
+            # Basically, it is an edge case when dealing with complex import logic
+
+            # The dataclasses plugin now asserts this cannot happen, but I'd rather not error if it does..
+            return None
+
+        if isinstance(node, TypeAlias):
+            self._api.fail(
+                'Type aliases inside BaseModel definitions are not supported at runtime',
+                node,
+            )
+            # Skip processing this node. This doesn't match the runtime behaviour,
+            # but the only alternative would be to modify the SymbolTable,
+            # and it's a little hairy to do that in a plugin.
+            return None
+
+        if not isinstance(node, Var):  # pragma: no cover
+            # Don't know if this edge case still happens with the `is_valid_field` check above
+            # but better safe than sorry
+
+            # The dataclasses plugin now asserts this cannot happen, but I'd rather not error if it does..
+            return None
+
+        # x: ClassVar[int] is not a field
+        if node.is_classvar:
+            return PydanticModelClassVar(lhs.name)
+
+        # x: InitVar[int] is not supported in BaseModel
+        node_type = get_proper_type(node.type)
+        if isinstance(node_type, Instance) and node_type.type.fullname == 'dataclasses.InitVar':
+            self._api.fail(
+                'InitVar is not supported in BaseModel',
+                node,
+            )
+
+        has_default = self.get_has_default(stmt)
+
+        if sym.type is None and node.is_final and node.is_inferred:
+            # This follows the logic from the dataclasses plugin. The following comment is taken verbatim:
+            #
+            # This is a special case, assignment like x: Final = 42 is classified
+            # annotated above, but mypy strips the `Final` turning it into x = 42.
+            # We do not support inferred types in dataclasses, so we can try inferring
+            # type for simple literals, and otherwise require an explicit type
+            # argument for Final[...].
+            typ = self._api.analyze_simple_literal_type(stmt.rvalue, is_final=True)
+            if typ:
+                node.type = typ
+            else:
+                self._api.fail(
+                    'Need type argument for Final[...] with non-literal default in BaseModel',
+                    stmt,
+                )
+                node.type = AnyType(TypeOfAny.from_error)
+
+        alias, has_dynamic_alias = self.get_alias_info(stmt)
+        if has_dynamic_alias and not model_config.populate_by_name and self.plugin_config.warn_required_dynamic_aliases:
+            error_required_dynamic_aliases(self._api, stmt)
+
+        init_type = self._infer_dataclass_attr_init_type(sym, lhs.name, stmt)
+        return PydanticModelField(
+            name=lhs.name,
+            has_dynamic_alias=has_dynamic_alias,
+            has_default=has_default,
+            alias=alias,
+            line=stmt.line,
+            column=stmt.column,
+            type=init_type,
+            info=cls.info,
+        )
+
+    def _infer_dataclass_attr_init_type(self, sym: SymbolTableNode, name: str, context: Context) -> Type | None:
+        """Infer __init__ argument type for an attribute.
+
+        In particular, possibly use the signature of __set__.
+        """
+        default = sym.type
+        if sym.implicit:
+            return default
+        t = get_proper_type(sym.type)
+
+        # Perform a simple-minded inference from the signature of __set__, if present.
+        # We can't use mypy.checkmember here, since this plugin runs before type checking.
+        # We only support some basic scanerios here, which is hopefully sufficient for
+        # the vast majority of use cases.
+        if not isinstance(t, Instance):
+            return default
+        setter = t.type.get('__set__')
+        if setter:
+            if isinstance(setter.node, FuncDef):
+                super_info = t.type.get_containing_type_info('__set__')
+                assert super_info
+                if setter.type:
+                    setter_type = get_proper_type(map_type_from_supertype(setter.type, t.type, super_info))
+                else:
+                    return AnyType(TypeOfAny.unannotated)
+                if isinstance(setter_type, CallableType) and setter_type.arg_kinds == [
+                    ARG_POS,
+                    ARG_POS,
+                    ARG_POS,
+                ]:
+                    return expand_type_by_instance(setter_type.arg_types[2], t)
+                else:
+                    self._api.fail(f'Unsupported signature for "__set__" in "{t.type.name}"', context)
+            else:
+                self._api.fail(f'Unsupported "__set__" in "{t.type.name}"', context)
+
+        return default
+
+    def add_initializer(
+        self, fields: list[PydanticModelField], config: ModelConfigData, is_settings: bool, is_root_model: bool
+    ) -> None:
+        """Adds a fields-aware `__init__` method to the class.
 
         The added `__init__` will be annotated with types vs. all `Any` depending on the plugin settings.
         """
-        ctx = self._ctx
+        if '__init__' in self._cls.info.names and not self._cls.info.names['__init__'].plugin_generated:
+            return  # Don't generate an __init__ if one already exists
+
         typed = self.plugin_config.init_typed
-        use_alias = config.allow_population_by_field_name is not True
-        force_all_optional = is_settings or bool(
-            config.has_alias_generator and not config.allow_population_by_field_name
-        )
-        init_arguments = self.get_field_arguments(
-            fields, typed=typed, force_all_optional=force_all_optional, use_alias=use_alias
-        )
+        use_alias = config.populate_by_name is not True
+        requires_dynamic_aliases = bool(config.has_alias_generator and not config.populate_by_name)
+        with state.strict_optional_set(self._api.options.strict_optional):
+            args = self.get_field_arguments(
+                fields,
+                typed=typed,
+                requires_dynamic_aliases=requires_dynamic_aliases,
+                use_alias=use_alias,
+                is_settings=is_settings,
+            )
+
+            if is_root_model and MYPY_VERSION_TUPLE <= (1, 0, 1):
+                # convert root argument to positional argument
+                # This is needed because mypy support for `dataclass_transform` isn't complete on 1.0.1
+                args[0].kind = ARG_POS if args[0].kind == ARG_NAMED else ARG_OPT
+
+            if is_settings:
+                base_settings_node = self._api.lookup_fully_qualified(BASESETTINGS_FULLNAME).node
+                if '__init__' in base_settings_node.names:
+                    base_settings_init_node = base_settings_node.names['__init__'].node
+                    if base_settings_init_node is not None and base_settings_init_node.type is not None:
+                        func_type = base_settings_init_node.type
+                        for arg_idx, arg_name in enumerate(func_type.arg_names):
+                            if arg_name.startswith('__') or not arg_name.startswith('_'):
+                                continue
+                            analyzed_variable_type = self._api.anal_type(func_type.arg_types[arg_idx])
+                            variable = Var(arg_name, analyzed_variable_type)
+                            args.append(Argument(variable, analyzed_variable_type, None, ARG_OPT))
+
         if not self.should_init_forbid_extra(fields, config):
             var = Var('kwargs')
-            init_arguments.append(Argument(var, AnyType(TypeOfAny.explicit), None, ARG_STAR2))
+            args.append(Argument(var, AnyType(TypeOfAny.explicit), None, ARG_STAR2))
 
-        if '__init__' not in ctx.cls.info.names:
-            add_method(ctx, '__init__', init_arguments, NoneType())
+        add_method(self._api, self._cls, '__init__', args=args, return_type=NoneType())
 
-    def add_construct_method(self, fields: List['PydanticModelField']) -> None:
-        """
-        Adds a fully typed `construct` classmethod to the class.
+    def add_model_construct_method(
+        self, fields: list[PydanticModelField], config: ModelConfigData, is_settings: bool
+    ) -> None:
+        """Adds a fully typed `model_construct` classmethod to the class.
 
         Similar to the fields-aware __init__ method, but always uses the field names (not aliases),
         and does not treat settings fields as optional.
         """
-        ctx = self._ctx
-        set_str = ctx.api.named_type(f'{BUILTINS_NAME}.set', [ctx.api.named_type(f'{BUILTINS_NAME}.str')])
+        set_str = self._api.named_type(f'{BUILTINS_NAME}.set', [self._api.named_type(f'{BUILTINS_NAME}.str')])
         optional_set_str = UnionType([set_str, NoneType()])
         fields_set_argument = Argument(Var('_fields_set', optional_set_str), optional_set_str, None, ARG_OPT)
-        construct_arguments = self.get_field_arguments(fields, typed=True, force_all_optional=False, use_alias=False)
-        construct_arguments = [fields_set_argument] + construct_arguments
+        with state.strict_optional_set(self._api.options.strict_optional):
+            args = self.get_field_arguments(
+                fields, typed=True, requires_dynamic_aliases=False, use_alias=False, is_settings=is_settings
+            )
+        if not self.should_init_forbid_extra(fields, config):
+            var = Var('kwargs')
+            args.append(Argument(var, AnyType(TypeOfAny.explicit), None, ARG_STAR2))
 
-        obj_type = ctx.api.named_type(f'{BUILTINS_NAME}.object')
-        self_tvar_name = '_PydanticBaseModel'  # Make sure it does not conflict with other names in the class
-        tvar_fullname = ctx.cls.fullname + '.' + self_tvar_name
-        tvd = TypeVarDef(self_tvar_name, tvar_fullname, -1, [], obj_type)
-        self_tvar_expr = TypeVarExpr(self_tvar_name, tvar_fullname, [], obj_type)
-        ctx.cls.info.names[self_tvar_name] = SymbolTableNode(MDEF, self_tvar_expr)
-
-        # Backward-compatible with TypeVarDef from Mypy 0.910.
-        if isinstance(tvd, TypeVarType):
-            self_type = tvd
-        else:
-            self_type = TypeVarType(tvd)  # type: ignore[call-arg]
+        args = [fields_set_argument] + args
 
         add_method(
-            ctx,
-            'construct',
-            construct_arguments,
-            return_type=self_type,
-            self_type=self_type,
-            tvar_def=tvd,
+            self._api,
+            self._cls,
+            'model_construct',
+            args=args,
+            return_type=fill_typevars(self._cls.info),
             is_classmethod=True,
         )
 
-    def set_frozen(self, fields: List['PydanticModelField'], frozen: bool) -> None:
-        """
-        Marks all fields as properties so that attempts to set them trigger mypy errors.
+    def set_frozen(self, fields: list[PydanticModelField], api: SemanticAnalyzerPluginInterface, frozen: bool) -> None:
+        """Marks all fields as properties so that attempts to set them trigger mypy errors.
 
         This is the same approach used by the attrs and dataclasses plugins.
         """
-        info = self._ctx.cls.info
+        info = self._cls.info
         for field in fields:
             sym_node = info.names.get(field.name)
             if sym_node is not None:
                 var = sym_node.node
-                assert isinstance(var, Var)
-                var.is_property = frozen
+                if isinstance(var, Var):
+                    var.is_property = frozen
+                elif isinstance(var, PlaceholderNode) and not self._api.final_iteration:
+                    # See https://github.com/pydantic/pydantic/issues/5191 to hit this branch for test coverage
+                    self._api.defer()
+                else:  # pragma: no cover
+                    # I don't know whether it's possible to hit this branch, but I've added it for safety
+                    try:
+                        var_str = str(var)
+                    except TypeError:
+                        # This happens for PlaceholderNode; perhaps it will happen for other types in the future..
+                        var_str = repr(var)
+                    detail = f'sym_node.node: {var_str} (of type {var.__class__})'
+                    error_unexpected_behavior(detail, self._api, self._cls)
             else:
-                var = field.to_var(info, use_alias=False)
+                var = field.to_var(info, api, use_alias=False)
                 var.info = info
                 var.is_property = frozen
-                var._fullname = get_fullname(info) + '.' + get_name(var)
-                info.names[get_name(var)] = SymbolTableNode(MDEF, var)
+                var._fullname = info.fullname + '.' + var.name
+                info.names[var.name] = SymbolTableNode(MDEF, var)
 
-    def get_config_update(self, substmt: AssignmentStmt) -> Optional['ModelConfigData']:
-        """
-        Determines the config update due to a single statement in the Config class definition.
+    def get_config_update(self, name: str, arg: Expression) -> ModelConfigData | None:
+        """Determines the config update due to a single kwarg in the ConfigDict definition.
 
         Warns if a tracked config attribute is set to a value the plugin doesn't know how to interpret (e.g., an int)
         """
-        lhs = substmt.lvalues[0]
-        if not (isinstance(lhs, NameExpr) and lhs.name in self.tracked_config_fields):
+        if name not in self.tracked_config_fields:
             return None
-        if lhs.name == 'extra':
-            if isinstance(substmt.rvalue, StrExpr):
-                forbid_extra = substmt.rvalue.value == 'forbid'
-            elif isinstance(substmt.rvalue, MemberExpr):
-                forbid_extra = substmt.rvalue.name == 'forbid'
+        if name == 'extra':
+            if isinstance(arg, StrExpr):
+                forbid_extra = arg.value == 'forbid'
+            elif isinstance(arg, MemberExpr):
+                forbid_extra = arg.name == 'forbid'
             else:
-                error_invalid_config_value(lhs.name, self._ctx.api, substmt)
+                error_invalid_config_value(name, self._api, arg)
                 return None
             return ModelConfigData(forbid_extra=forbid_extra)
-        if lhs.name == 'alias_generator':
+        if name == 'alias_generator':
             has_alias_generator = True
-            if isinstance(substmt.rvalue, NameExpr) and substmt.rvalue.fullname == 'builtins.None':
+            if isinstance(arg, NameExpr) and arg.fullname == 'builtins.None':
                 has_alias_generator = False
             return ModelConfigData(has_alias_generator=has_alias_generator)
-        if isinstance(substmt.rvalue, NameExpr) and substmt.rvalue.fullname in ('builtins.True', 'builtins.False'):
-            return ModelConfigData(**{lhs.name: substmt.rvalue.fullname == 'builtins.True'})
-        error_invalid_config_value(lhs.name, self._ctx.api, substmt)
+        if isinstance(arg, NameExpr) and arg.fullname in ('builtins.True', 'builtins.False'):
+            return ModelConfigData(**{name: arg.fullname == 'builtins.True'})
+        error_invalid_config_value(name, self._api, arg)
         return None
 
     @staticmethod
-    def get_is_required(cls: ClassDef, stmt: AssignmentStmt, lhs: NameExpr) -> bool:
-        """
-        Returns a boolean indicating whether the field defined in `stmt` is a required field.
-        """
+    def get_has_default(stmt: AssignmentStmt) -> bool:
+        """Returns a boolean indicating whether the field defined in `stmt` is a required field."""
         expr = stmt.rvalue
         if isinstance(expr, TempNode):
-            # TempNode means annotation-only, so only non-required if Optional
-            value_type = get_proper_type(cls.info[lhs.name].type)
-            if isinstance(value_type, UnionType) and any(isinstance(item, NoneType) for item in value_type.items):
-                # Annotated as Optional, or otherwise having NoneType in the union
-                return False
-            return True
+            # TempNode means annotation-only, so has no default
+            return False
         if isinstance(expr, CallExpr) and isinstance(expr.callee, RefExpr) and expr.callee.fullname == FIELD_FULLNAME:
-            # The "default value" is a call to `Field`; at this point, the field is
-            # only required if default is Ellipsis (i.e., `field_name: Annotation = Field(...)`) or if default_factory
-            # is specified.
+            # The "default value" is a call to `Field`; at this point, the field has a default if and only if:
+            # * there is a positional argument that is not `...`
+            # * there is a keyword argument named "default" that is not `...`
+            # * there is a "default_factory" that is not `None`
             for arg, name in zip(expr.args, expr.arg_names):
-                # If name is None, then this arg is the default because it is the only positonal argument.
+                # If name is None, then this arg is the default because it is the only positional argument.
                 if name is None or name == 'default':
-                    return arg.__class__ is EllipsisExpr
+                    return arg.__class__ is not EllipsisExpr
                 if name == 'default_factory':
-                    return False
-            return True
-        # Only required if the "default value" is Ellipsis (i.e., `field_name: Annotation = ...`)
-        return isinstance(expr, EllipsisExpr)
+                    return not (isinstance(arg, NameExpr) and arg.fullname == 'builtins.None')
+            return False
+        # Has no default if the "default value" is Ellipsis (i.e., `field_name: Annotation = ...`)
+        return not isinstance(expr, EllipsisExpr)
 
     @staticmethod
-    def get_alias_info(stmt: AssignmentStmt) -> Tuple[Optional[str], bool]:
-        """
-        Returns a pair (alias, has_dynamic_alias), extracted from the declaration of the field defined in `stmt`.
+    def get_alias_info(stmt: AssignmentStmt) -> tuple[str | None, bool]:
+        """Returns a pair (alias, has_dynamic_alias), extracted from the declaration of the field defined in `stmt`.
 
         `has_dynamic_alias` is True if and only if an alias is provided, but not as a string literal.
         If `has_dynamic_alias` is True, `alias` will be None.
@@ -573,29 +1033,38 @@ class PydanticModelTransformer:
         return None, False
 
     def get_field_arguments(
-        self, fields: List['PydanticModelField'], typed: bool, force_all_optional: bool, use_alias: bool
-    ) -> List[Argument]:
-        """
-        Helper function used during the construction of the `__init__` and `construct` method signatures.
+        self,
+        fields: list[PydanticModelField],
+        typed: bool,
+        use_alias: bool,
+        requires_dynamic_aliases: bool,
+        is_settings: bool,
+    ) -> list[Argument]:
+        """Helper function used during the construction of the `__init__` and `model_construct` method signatures.
 
         Returns a list of mypy Argument instances for use in the generated signatures.
         """
-        info = self._ctx.cls.info
+        info = self._cls.info
         arguments = [
-            field.to_argument(info, typed=typed, force_optional=force_all_optional, use_alias=use_alias)
+            field.to_argument(
+                info,
+                typed=typed,
+                force_optional=requires_dynamic_aliases or is_settings,
+                use_alias=use_alias,
+                api=self._api,
+            )
             for field in fields
             if not (use_alias and field.has_dynamic_alias)
         ]
         return arguments
 
-    def should_init_forbid_extra(self, fields: List['PydanticModelField'], config: 'ModelConfigData') -> bool:
-        """
-        Indicates whether the generated `__init__` should get a `**kwargs` at the end of its signature
+    def should_init_forbid_extra(self, fields: list[PydanticModelField], config: ModelConfigData) -> bool:
+        """Indicates whether the generated `__init__` should get a `**kwargs` at the end of its signature.
 
         We disallow arbitrary kwargs if the extra config setting is "forbid", or if the plugin config says to,
         *unless* a required dynamic alias is present (since then we can't determine a valid signature).
         """
-        if not config.allow_population_by_field_name:
+        if not config.populate_by_name:
             if self.is_dynamic_alias_present(fields, bool(config.has_alias_generator)):
                 return False
         if config.forbid_extra:
@@ -603,9 +1072,8 @@ class PydanticModelTransformer:
         return self.plugin_config.init_forbid_extra
 
     @staticmethod
-    def is_dynamic_alias_present(fields: List['PydanticModelField'], has_alias_generator: bool) -> bool:
-        """
-        Returns whether any fields on the model have a "dynamic alias", i.e., an alias that cannot be
+    def is_dynamic_alias_present(fields: list[PydanticModelField], has_alias_generator: bool) -> bool:
+        """Returns whether any fields on the model have a "dynamic alias", i.e., an alias that cannot be
         determined during static analysis.
         """
         for field in fields:
@@ -618,95 +1086,74 @@ class PydanticModelTransformer:
         return False
 
 
-class PydanticModelField:
-    def __init__(
-        self, name: str, is_required: bool, alias: Optional[str], has_dynamic_alias: bool, line: int, column: int
-    ):
-        self.name = name
-        self.is_required = is_required
-        self.alias = alias
-        self.has_dynamic_alias = has_dynamic_alias
-        self.line = line
-        self.column = column
-
-    def to_var(self, info: TypeInfo, use_alias: bool) -> Var:
-        name = self.name
-        if use_alias and self.alias is not None:
-            name = self.alias
-        return Var(name, info[self.name].type)
-
-    def to_argument(self, info: TypeInfo, typed: bool, force_optional: bool, use_alias: bool) -> Argument:
-        if typed and info[self.name].type is not None:
-            type_annotation = info[self.name].type
-        else:
-            type_annotation = AnyType(TypeOfAny.explicit)
-        return Argument(
-            variable=self.to_var(info, use_alias),
-            type_annotation=type_annotation,
-            initializer=None,
-            kind=ARG_NAMED_OPT if force_optional or not self.is_required else ARG_NAMED,
-        )
-
-    def serialize(self) -> JsonDict:
-        return self.__dict__
-
-    @classmethod
-    def deserialize(cls, info: TypeInfo, data: JsonDict) -> 'PydanticModelField':
-        return cls(**data)
-
-
 class ModelConfigData:
+    """Pydantic mypy plugin model config class."""
+
     def __init__(
         self,
-        forbid_extra: Optional[bool] = None,
-        allow_mutation: Optional[bool] = None,
-        frozen: Optional[bool] = None,
-        orm_mode: Optional[bool] = None,
-        allow_population_by_field_name: Optional[bool] = None,
-        has_alias_generator: Optional[bool] = None,
+        forbid_extra: bool | None = None,
+        frozen: bool | None = None,
+        from_attributes: bool | None = None,
+        populate_by_name: bool | None = None,
+        has_alias_generator: bool | None = None,
     ):
         self.forbid_extra = forbid_extra
-        self.allow_mutation = allow_mutation
         self.frozen = frozen
-        self.orm_mode = orm_mode
-        self.allow_population_by_field_name = allow_population_by_field_name
+        self.from_attributes = from_attributes
+        self.populate_by_name = populate_by_name
         self.has_alias_generator = has_alias_generator
 
-    def set_values_dict(self) -> Dict[str, Any]:
+    def get_values_dict(self) -> dict[str, Any]:
+        """Returns a dict of Pydantic model config names to their values.
+
+        It includes the config if config value is not `None`.
+        """
         return {k: v for k, v in self.__dict__.items() if v is not None}
 
-    def update(self, config: Optional['ModelConfigData']) -> None:
+    def update(self, config: ModelConfigData | None) -> None:
+        """Update Pydantic model config values."""
         if config is None:
             return
-        for k, v in config.set_values_dict().items():
+        for k, v in config.get_values_dict().items():
             setattr(self, k, v)
 
     def setdefault(self, key: str, value: Any) -> None:
+        """Set default value for Pydantic model config if config value is `None`."""
         if getattr(self, key) is None:
             setattr(self, key, value)
 
 
-ERROR_ORM = ErrorCode('pydantic-orm', 'Invalid from_orm call', 'Pydantic')
+ERROR_ORM = ErrorCode('pydantic-orm', 'Invalid from_attributes call', 'Pydantic')
 ERROR_CONFIG = ErrorCode('pydantic-config', 'Invalid config value', 'Pydantic')
 ERROR_ALIAS = ErrorCode('pydantic-alias', 'Dynamic alias disallowed', 'Pydantic')
 ERROR_UNEXPECTED = ErrorCode('pydantic-unexpected', 'Unexpected behavior', 'Pydantic')
 ERROR_UNTYPED = ErrorCode('pydantic-field', 'Untyped field disallowed', 'Pydantic')
 ERROR_FIELD_DEFAULTS = ErrorCode('pydantic-field', 'Invalid Field defaults', 'Pydantic')
+ERROR_EXTRA_FIELD_ROOT_MODEL = ErrorCode('pydantic-field', 'Extra field on RootModel subclass', 'Pydantic')
 
 
-def error_from_orm(model_name: str, api: CheckerPluginInterface, context: Context) -> None:
-    api.fail(f'"{model_name}" does not have orm_mode=True', context, code=ERROR_ORM)
+def error_from_attributes(model_name: str, api: CheckerPluginInterface, context: Context) -> None:
+    """Emits an error when the model does not have `from_attributes=True`."""
+    api.fail(f'"{model_name}" does not have from_attributes=True', context, code=ERROR_ORM)
 
 
 def error_invalid_config_value(name: str, api: SemanticAnalyzerPluginInterface, context: Context) -> None:
+    """Emits an error when the config value is invalid."""
     api.fail(f'Invalid value for "Config.{name}"', context, code=ERROR_CONFIG)
 
 
 def error_required_dynamic_aliases(api: SemanticAnalyzerPluginInterface, context: Context) -> None:
+    """Emits required dynamic aliases error.
+
+    This will be called when `warn_required_dynamic_aliases=True`.
+    """
     api.fail('Required dynamic aliases disallowed', context, code=ERROR_ALIAS)
 
 
-def error_unexpected_behavior(detail: str, api: CheckerPluginInterface, context: Context) -> None:  # pragma: no cover
+def error_unexpected_behavior(
+    detail: str, api: CheckerPluginInterface | SemanticAnalyzerPluginInterface, context: Context
+) -> None:  # pragma: no cover
+    """Emits unexpected behavior error."""
     # Can't think of a good way to test this, but I confirmed it renders as desired by adding to a non-error path
     link = 'https://github.com/pydantic/pydantic/issues/new/choose'
     full_message = f'The pydantic mypy plugin ran into unexpected behavior: {detail}\n'
@@ -715,55 +1162,70 @@ def error_unexpected_behavior(detail: str, api: CheckerPluginInterface, context:
 
 
 def error_untyped_fields(api: SemanticAnalyzerPluginInterface, context: Context) -> None:
+    """Emits an error when there is an untyped field in the model."""
     api.fail('Untyped fields disallowed', context, code=ERROR_UNTYPED)
 
 
+def error_extra_fields_on_root_model(api: CheckerPluginInterface, context: Context) -> None:
+    """Emits an error when there is more than just a root field defined for a subclass of RootModel."""
+    api.fail('Only `root` is allowed as a field of a `RootModel`', context, code=ERROR_EXTRA_FIELD_ROOT_MODEL)
+
+
 def error_default_and_default_factory_specified(api: CheckerPluginInterface, context: Context) -> None:
+    """Emits an error when `Field` has both `default` and `default_factory` together."""
     api.fail('Field default and default_factory cannot be specified together', context, code=ERROR_FIELD_DEFAULTS)
 
 
 def add_method(
-    ctx: ClassDefContext,
+    api: SemanticAnalyzerPluginInterface | CheckerPluginInterface,
+    cls: ClassDef,
     name: str,
-    args: List[Argument],
+    args: list[Argument],
     return_type: Type,
-    self_type: Optional[Type] = None,
-    tvar_def: Optional[TypeVarDef] = None,
+    self_type: Type | None = None,
+    tvar_def: TypeVarDef | None = None,
     is_classmethod: bool = False,
-    is_new: bool = False,
-    # is_staticmethod: bool = False,
 ) -> None:
-    """
-    Adds a new method to a class.
-
-    This can be dropped if/when https://github.com/python/mypy/issues/7301 is merged
-    """
-    info = ctx.cls.info
+    """Very closely related to `mypy.plugins.common.add_method_to_class`, with a few pydantic-specific changes."""
+    info = cls.info
 
     # First remove any previously generated methods with the same name
     # to avoid clashes and problems in the semantic analyzer.
     if name in info.names:
         sym = info.names[name]
         if sym.plugin_generated and isinstance(sym.node, FuncDef):
-            ctx.cls.defs.body.remove(sym.node)  # pragma: no cover
+            cls.defs.body.remove(sym.node)  # pragma: no cover
 
-    self_type = self_type or fill_typevars(info)
-    if is_classmethod or is_new:
-        first = [Argument(Var('_cls'), TypeType.make_normalized(self_type), None, ARG_POS)]
-    # elif is_staticmethod:
-    #     first = []
+    if isinstance(api, SemanticAnalyzerPluginInterface):
+        function_type = api.named_type('builtins.function')
+    else:
+        function_type = api.named_generic_type('builtins.function', [])
+
+    if is_classmethod:
+        self_type = self_type or TypeType(fill_typevars(info))
+        first = [Argument(Var('_cls'), self_type, None, ARG_POS, True)]
     else:
         self_type = self_type or fill_typevars(info)
+        # `self` is positional *ONLY* here, but this can't be expressed
+        # fully in the mypy internal API. ARG_POS is the closest we can get.
+        # Using ARG_POS will, however, give mypy errors if a `self` field
+        # is present on a model:
+        #
+        #     Name "self" already defined (possibly by an import)  [no-redef]
+        #
+        # As a workaround, we give this argument a name that will
+        # never conflict. By its positional nature, this name will not
+        # be used or exposed to users.
         first = [Argument(Var('__pydantic_self__'), self_type, None, ARG_POS)]
     args = first + args
+
     arg_types, arg_names, arg_kinds = [], [], []
     for arg in args:
         assert arg.type_annotation, 'All arguments must be fully typed.'
         arg_types.append(arg.type_annotation)
-        arg_names.append(get_name(arg.variable))
+        arg_names.append(arg.variable.name)
         arg_kinds.append(arg.kind)
 
-    function_type = ctx.api.named_type(f'{BUILTINS_NAME}.function')
     signature = CallableType(arg_types, arg_kinds, arg_names, return_type, function_type)
     if tvar_def:
         signature.variables = [tvar_def]
@@ -772,8 +1234,7 @@ def add_method(
     func.info = info
     func.type = set_callable_name(signature, func)
     func.is_class = is_classmethod
-    # func.is_static = is_staticmethod
-    func._fullname = get_fullname(info) + '.' + name
+    func._fullname = info.fullname + '.' + name
     func.line = info.line
 
     # NOTE: we would like the plugin generated node to dominate, but we still
@@ -783,68 +1244,44 @@ def add_method(
         r_name = get_unique_redefinition_name(name, info.names)
         info.names[r_name] = info.names[name]
 
-    if is_classmethod:  # or is_staticmethod:
+    # Add decorator for is_classmethod
+    # The dataclasses plugin claims this is unnecessary for classmethods, but not including it results in a
+    # signature incompatible with the superclass, which causes mypy errors to occur for every subclass of BaseModel.
+    if is_classmethod:
         func.is_decorated = True
         v = Var(name, func.type)
         v.info = info
         v._fullname = func._fullname
-        # if is_classmethod:
         v.is_classmethod = True
         dec = Decorator(func, [NameExpr('classmethod')], v)
-        # else:
-        #     v.is_staticmethod = True
-        #     dec = Decorator(func, [NameExpr('staticmethod')], v)
-
         dec.line = info.line
         sym = SymbolTableNode(MDEF, dec)
     else:
         sym = SymbolTableNode(MDEF, func)
     sym.plugin_generated = True
-
     info.names[name] = sym
+
     info.defn.defs.body.append(func)
 
 
-def get_fullname(x: Union[FuncBase, SymbolNode]) -> str:
-    """
-    Used for compatibility with mypy 0.740; can be dropped once support for 0.740 is dropped.
-    """
-    fn = x.fullname
-    if callable(fn):  # pragma: no cover
-        return fn()
-    return fn
+def parse_toml(config_file: str) -> dict[str, Any] | None:
+    """Returns a dict of config keys to values.
 
-
-def get_name(x: Union[FuncBase, SymbolNode]) -> str:
+    It reads configs from toml file and returns `None` if the file is not a toml file.
     """
-    Used for compatibility with mypy 0.740; can be dropped once support for 0.740 is dropped.
-    """
-    fn = x.name
-    if callable(fn):  # pragma: no cover
-        return fn()
-    return fn
-
-
-def parse_toml(config_file: str) -> Optional[Dict[str, Any]]:
     if not config_file.endswith('.toml'):
         return None
 
-    read_mode = 'rb'
     if sys.version_info >= (3, 11):
         import tomllib as toml_
     else:
         try:
             import tomli as toml_
-        except ImportError:
-            # older versions of mypy have toml as a dependency, not tomli
-            read_mode = 'r'
-            try:
-                import toml as toml_  # type: ignore[no-redef]
-            except ImportError:  # pragma: no cover
-                import warnings
+        except ImportError:  # pragma: no cover
+            import warnings
 
-                warnings.warn('No TOML parser installed, cannot read configuration from `pyproject.toml`.')
-                return None
+            warnings.warn('No TOML parser installed, cannot read configuration from `pyproject.toml`.')
+            return None
 
-    with open(config_file, read_mode) as rf:
-        return toml_.load(rf)  # type: ignore[arg-type]
+    with open(config_file, 'rb') as rf:
+        return toml_.load(rf)
diff --git a/lib/pydantic/networks.py b/lib/pydantic/networks.py
index c7d97186..6d9d292f 100644
--- a/lib/pydantic/networks.py
+++ b/lib/pydantic/networks.py
@@ -1,80 +1,35 @@
-import re
-from ipaddress import (
-    IPv4Address,
-    IPv4Interface,
-    IPv4Network,
-    IPv6Address,
-    IPv6Interface,
-    IPv6Network,
-    _BaseAddress,
-    _BaseNetwork,
-)
-from typing import (
-    TYPE_CHECKING,
-    Any,
-    Collection,
-    Dict,
-    Generator,
-    List,
-    Match,
-    Optional,
-    Pattern,
-    Set,
-    Tuple,
-    Type,
-    Union,
-    cast,
-    no_type_check,
-)
+"""The networks module contains types for common network-related fields."""
+from __future__ import annotations as _annotations
 
-from . import errors
-from .utils import Representation, update_not_none
-from .validators import constr_length_validator, str_validator
+import dataclasses as _dataclasses
+import re
+from importlib.metadata import version
+from ipaddress import IPv4Address, IPv4Interface, IPv4Network, IPv6Address, IPv6Interface, IPv6Network
+from typing import TYPE_CHECKING, Any
+
+from pydantic_core import MultiHostUrl, PydanticCustomError, Url, core_schema
+from typing_extensions import Annotated, TypeAlias
+
+from ._internal import _fields, _repr, _schema_generation_shared
+from ._migration import getattr_migration
+from .annotated_handlers import GetCoreSchemaHandler
+from .json_schema import JsonSchemaValue
 
 if TYPE_CHECKING:
     import email_validator
-    from typing_extensions import TypedDict
 
-    from .config import BaseConfig
-    from .fields import ModelField
-    from .typing import AnyCallable
-
-    CallableGenerator = Generator[AnyCallable, None, None]
-
-    class Parts(TypedDict, total=False):
-        scheme: str
-        user: Optional[str]
-        password: Optional[str]
-        ipv4: Optional[str]
-        ipv6: Optional[str]
-        domain: Optional[str]
-        port: Optional[str]
-        path: Optional[str]
-        query: Optional[str]
-        fragment: Optional[str]
-
-    class HostParts(TypedDict, total=False):
-        host: str
-        tld: Optional[str]
-        host_type: Optional[str]
-        port: Optional[str]
-        rebuild: bool
+    NetworkType: TypeAlias = 'str | bytes | int | tuple[str | bytes | int, str | int]'
 
 else:
     email_validator = None
 
-    class Parts(dict):
-        pass
-
-
-NetworkType = Union[str, bytes, int, Tuple[Union[str, bytes, int], Union[str, int]]]
 
 __all__ = [
     'AnyUrl',
     'AnyHttpUrl',
     'FileUrl',
     'HttpUrl',
-    'stricturl',
+    'UrlConstraints',
     'EmailStr',
     'NameEmail',
     'IPvAnyAddress',
@@ -86,489 +41,321 @@ __all__ = [
     'RedisDsn',
     'MongoDsn',
     'KafkaDsn',
+    'NatsDsn',
     'validate_email',
+    'MySQLDsn',
+    'MariaDBDsn',
 ]
 
-_url_regex_cache = None
-_multi_host_url_regex_cache = None
-_ascii_domain_regex_cache = None
-_int_domain_regex_cache = None
-_host_regex_cache = None
 
-_host_regex = (
-    r'(?:'
-    r'(?P<ipv4>(?:\d{1,3}\.){3}\d{1,3})(?=$|[/:#?])|'  # ipv4
-    r'(?P<ipv6>\[[A-F0-9]*:[A-F0-9:]+\])(?=$|[/:#?])|'  # ipv6
-    r'(?P<domain>[^\s/:?#]+)'  # domain, validation occurs later
-    r')?'
-    r'(?::(?P<port>\d+))?'  # port
+@_dataclasses.dataclass
+class UrlConstraints(_fields.PydanticMetadata):
+    """Url constraints.
+
+    Attributes:
+        max_length: The maximum length of the url. Defaults to `None`.
+        allowed_schemes: The allowed schemes. Defaults to `None`.
+        host_required: Whether the host is required. Defaults to `None`.
+        default_host: The default host. Defaults to `None`.
+        default_port: The default port. Defaults to `None`.
+        default_path: The default path. Defaults to `None`.
+    """
+
+    max_length: int | None = None
+    allowed_schemes: list[str] | None = None
+    host_required: bool | None = None
+    default_host: str | None = None
+    default_port: int | None = None
+    default_path: str | None = None
+
+    def __hash__(self) -> int:
+        return hash(
+            (
+                self.max_length,
+                tuple(self.allowed_schemes) if self.allowed_schemes is not None else None,
+                self.host_required,
+                self.default_host,
+                self.default_port,
+                self.default_path,
+            )
+        )
+
+
+AnyUrl = Url
+"""Base type for all URLs.
+
+* Any scheme allowed
+* Top-level domain (TLD) not required
+* Host required
+
+Assuming an input URL of `http://samuel:pass@example.com:8000/the/path/?query=here#fragment=is;this=bit`,
+the types export the following properties:
+
+- `scheme`: the URL scheme (`http`), always set.
+- `host`: the URL host (`example.com`), always set.
+- `username`: optional username if included (`samuel`).
+- `password`: optional password if included (`pass`).
+- `port`: optional port (`8000`).
+- `path`: optional path (`/the/path/`).
+- `query`: optional URL query (for example, `GET` arguments or "search string", such as `query=here`).
+- `fragment`: optional fragment (`fragment=is;this=bit`).
+"""
+AnyHttpUrl = Annotated[Url, UrlConstraints(allowed_schemes=['http', 'https'])]
+"""A type that will accept any http or https URL.
+
+* TLD not required
+* Host required
+"""
+HttpUrl = Annotated[Url, UrlConstraints(max_length=2083, allowed_schemes=['http', 'https'])]
+"""A type that will accept any http or https URL.
+
+* TLD required
+* Host required
+* Max length 2083
+
+```py
+from pydantic import BaseModel, HttpUrl, ValidationError
+
+class MyModel(BaseModel):
+    url: HttpUrl
+
+m = MyModel(url='http://www.example.com')
+print(m.url)
+#> http://www.example.com/
+
+try:
+    MyModel(url='ftp://invalid.url')
+except ValidationError as e:
+    print(e)
+    '''
+    1 validation error for MyModel
+    url
+      URL scheme should be 'http' or 'https' [type=url_scheme, input_value='ftp://invalid.url', input_type=str]
+    '''
+
+try:
+    MyModel(url='not a url')
+except ValidationError as e:
+    print(e)
+    '''
+    1 validation error for MyModel
+    url
+      Input should be a valid URL, relative URL without a base [type=url_parsing, input_value='not a url', input_type=str]
+    '''
+```
+
+"International domains" (e.g. a URL where the host or TLD includes non-ascii characters) will be encoded via
+[punycode](https://en.wikipedia.org/wiki/Punycode) (see
+[this article](https://www.xudongz.com/blog/2017/idn-phishing/) for a good description of why this is important):
+
+```py
+from pydantic import BaseModel, HttpUrl
+
+class MyModel(BaseModel):
+    url: HttpUrl
+
+m1 = MyModel(url='http://puny£code.com')
+print(m1.url)
+#> http://xn--punycode-eja.com/
+m2 = MyModel(url='https://www.аррӏе.com/')
+print(m2.url)
+#> https://www.xn--80ak6aa92e.com/
+m3 = MyModel(url='https://www.example.珠宝/')
+print(m3.url)
+#> https://www.example.xn--pbt977c/
+```
+
+
+!!! warning "Underscores in Hostnames"
+    In Pydantic, underscores are allowed in all parts of a domain except the TLD.
+    Technically this might be wrong - in theory the hostname cannot have underscores, but subdomains can.
+
+    To explain this; consider the following two cases:
+
+    - `exam_ple.co.uk`: the hostname is `exam_ple`, which should not be allowed since it contains an underscore.
+    - `foo_bar.example.com` the hostname is `example`, which should be allowed since the underscore is in the subdomain.
+
+    Without having an exhaustive list of TLDs, it would be impossible to differentiate between these two. Therefore
+    underscores are allowed, but you can always do further validation in a validator if desired.
+
+    Also, Chrome, Firefox, and Safari all currently accept `http://exam_ple.com` as a URL, so we're in good
+    (or at least big) company.
+"""
+FileUrl = Annotated[Url, UrlConstraints(allowed_schemes=['file'])]
+"""A type that will accept any file URL.
+
+* Host not required
+"""
+PostgresDsn = Annotated[
+    MultiHostUrl,
+    UrlConstraints(
+        host_required=True,
+        allowed_schemes=[
+            'postgres',
+            'postgresql',
+            'postgresql+asyncpg',
+            'postgresql+pg8000',
+            'postgresql+psycopg',
+            'postgresql+psycopg2',
+            'postgresql+psycopg2cffi',
+            'postgresql+py-postgresql',
+            'postgresql+pygresql',
+        ],
+    ),
+]
+"""A type that will accept any Postgres DSN.
+
+* User info required
+* TLD not required
+* Host required
+* Supports multiple hosts
+
+If further validation is required, these properties can be used by validators to enforce specific behaviour:
+
+```py
+from pydantic import (
+    BaseModel,
+    HttpUrl,
+    PostgresDsn,
+    ValidationError,
+    field_validator,
 )
-_scheme_regex = r'(?:(?P<scheme>[a-z][a-z0-9+\-.]+)://)?'  # scheme https://tools.ietf.org/html/rfc3986#appendix-A
-_user_info_regex = r'(?:(?P<user>[^\s:/]*)(?::(?P<password>[^\s/]*))?@)?'
-_path_regex = r'(?P<path>/[^\s?#]*)?'
-_query_regex = r'(?:\?(?P<query>[^\s#]*))?'
-_fragment_regex = r'(?:#(?P<fragment>[^\s#]*))?'
 
-
-def url_regex() -> Pattern[str]:
-    global _url_regex_cache
-    if _url_regex_cache is None:
-        _url_regex_cache = re.compile(
-            rf'{_scheme_regex}{_user_info_regex}{_host_regex}{_path_regex}{_query_regex}{_fragment_regex}',
-            re.IGNORECASE,
-        )
-    return _url_regex_cache
-
-
-def multi_host_url_regex() -> Pattern[str]:
-    """
-    Compiled multi host url regex.
-
-    Additionally to `url_regex` it allows to match multiple hosts.
-    E.g. host1.db.net,host2.db.net
-    """
-    global _multi_host_url_regex_cache
-    if _multi_host_url_regex_cache is None:
-        _multi_host_url_regex_cache = re.compile(
-            rf'{_scheme_regex}{_user_info_regex}'
-            r'(?P<hosts>([^/]*))'  # validation occurs later
-            rf'{_path_regex}{_query_regex}{_fragment_regex}',
-            re.IGNORECASE,
-        )
-    return _multi_host_url_regex_cache
-
-
-def ascii_domain_regex() -> Pattern[str]:
-    global _ascii_domain_regex_cache
-    if _ascii_domain_regex_cache is None:
-        ascii_chunk = r'[_0-9a-z](?:[-_0-9a-z]{0,61}[_0-9a-z])?'
-        ascii_domain_ending = r'(?P<tld>\.[a-z]{2,63})?\.?'
-        _ascii_domain_regex_cache = re.compile(
-            fr'(?:{ascii_chunk}\.)*?{ascii_chunk}{ascii_domain_ending}', re.IGNORECASE
-        )
-    return _ascii_domain_regex_cache
-
-
-def int_domain_regex() -> Pattern[str]:
-    global _int_domain_regex_cache
-    if _int_domain_regex_cache is None:
-        int_chunk = r'[_0-9a-\U00040000](?:[-_0-9a-\U00040000]{0,61}[_0-9a-\U00040000])?'
-        int_domain_ending = r'(?P<tld>(\.[^\W\d_]{2,63})|(\.(?:xn--)[_0-9a-z-]{2,63}))?\.?'
-        _int_domain_regex_cache = re.compile(fr'(?:{int_chunk}\.)*?{int_chunk}{int_domain_ending}', re.IGNORECASE)
-    return _int_domain_regex_cache
-
-
-def host_regex() -> Pattern[str]:
-    global _host_regex_cache
-    if _host_regex_cache is None:
-        _host_regex_cache = re.compile(
-            _host_regex,
-            re.IGNORECASE,
-        )
-    return _host_regex_cache
-
-
-class AnyUrl(str):
-    strip_whitespace = True
-    min_length = 1
-    max_length = 2**16
-    allowed_schemes: Optional[Collection[str]] = None
-    tld_required: bool = False
-    user_required: bool = False
-    host_required: bool = True
-    hidden_parts: Set[str] = set()
-
-    __slots__ = ('scheme', 'user', 'password', 'host', 'tld', 'host_type', 'port', 'path', 'query', 'fragment')
-
-    @no_type_check
-    def __new__(cls, url: Optional[str], **kwargs) -> object:
-        return str.__new__(cls, cls.build(**kwargs) if url is None else url)
-
-    def __init__(
-        self,
-        url: str,
-        *,
-        scheme: str,
-        user: Optional[str] = None,
-        password: Optional[str] = None,
-        host: Optional[str] = None,
-        tld: Optional[str] = None,
-        host_type: str = 'domain',
-        port: Optional[str] = None,
-        path: Optional[str] = None,
-        query: Optional[str] = None,
-        fragment: Optional[str] = None,
-    ) -> None:
-        str.__init__(url)
-        self.scheme = scheme
-        self.user = user
-        self.password = password
-        self.host = host
-        self.tld = tld
-        self.host_type = host_type
-        self.port = port
-        self.path = path
-        self.query = query
-        self.fragment = fragment
-
-    @classmethod
-    def build(
-        cls,
-        *,
-        scheme: str,
-        user: Optional[str] = None,
-        password: Optional[str] = None,
-        host: str,
-        port: Optional[str] = None,
-        path: Optional[str] = None,
-        query: Optional[str] = None,
-        fragment: Optional[str] = None,
-        **_kwargs: str,
-    ) -> str:
-        parts = Parts(
-            scheme=scheme,
-            user=user,
-            password=password,
-            host=host,
-            port=port,
-            path=path,
-            query=query,
-            fragment=fragment,
-            **_kwargs,  # type: ignore[misc]
-        )
-
-        url = scheme + '://'
-        if user:
-            url += user
-        if password:
-            url += ':' + password
-        if user or password:
-            url += '@'
-        url += host
-        if port and ('port' not in cls.hidden_parts or cls.get_default_parts(parts).get('port') != port):
-            url += ':' + port
-        if path:
-            url += path
-        if query:
-            url += '?' + query
-        if fragment:
-            url += '#' + fragment
-        return url
-
-    @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-        update_not_none(field_schema, minLength=cls.min_length, maxLength=cls.max_length, format='uri')
-
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield cls.validate
-
-    @classmethod
-    def validate(cls, value: Any, field: 'ModelField', config: 'BaseConfig') -> 'AnyUrl':
-        if value.__class__ == cls:
-            return value
-        value = str_validator(value)
-        if cls.strip_whitespace:
-            value = value.strip()
-        url: str = cast(str, constr_length_validator(value, field, config))
-
-        m = cls._match_url(url)
-        # the regex should always match, if it doesn't please report with details of the URL tried
-        assert m, 'URL regex failed unexpectedly'
-
-        original_parts = cast('Parts', m.groupdict())
-        parts = cls.apply_default_parts(original_parts)
-        parts = cls.validate_parts(parts)
-
-        if m.end() != len(url):
-            raise errors.UrlExtraError(extra=url[m.end() :])
-
-        return cls._build_url(m, url, parts)
-
-    @classmethod
-    def _build_url(cls, m: Match[str], url: str, parts: 'Parts') -> 'AnyUrl':
-        """
-        Validate hosts and build the AnyUrl object. Split from `validate` so this method
-        can be altered in `MultiHostDsn`.
-        """
-        host, tld, host_type, rebuild = cls.validate_host(parts)
-
-        return cls(
-            None if rebuild else url,
-            scheme=parts['scheme'],
-            user=parts['user'],
-            password=parts['password'],
-            host=host,
-            tld=tld,
-            host_type=host_type,
-            port=parts['port'],
-            path=parts['path'],
-            query=parts['query'],
-            fragment=parts['fragment'],
-        )
-
-    @staticmethod
-    def _match_url(url: str) -> Optional[Match[str]]:
-        return url_regex().match(url)
-
-    @staticmethod
-    def _validate_port(port: Optional[str]) -> None:
-        if port is not None and int(port) > 65_535:
-            raise errors.UrlPortError()
-
-    @classmethod
-    def validate_parts(cls, parts: 'Parts', validate_port: bool = True) -> 'Parts':
-        """
-        A method used to validate parts of a URL.
-        Could be overridden to set default values for parts if missing
-        """
-        scheme = parts['scheme']
-        if scheme is None:
-            raise errors.UrlSchemeError()
-
-        if cls.allowed_schemes and scheme.lower() not in cls.allowed_schemes:
-            raise errors.UrlSchemePermittedError(set(cls.allowed_schemes))
-
-        if validate_port:
-            cls._validate_port(parts['port'])
-
-        user = parts['user']
-        if cls.user_required and user is None:
-            raise errors.UrlUserInfoError()
-
-        return parts
-
-    @classmethod
-    def validate_host(cls, parts: 'Parts') -> Tuple[str, Optional[str], str, bool]:
-        tld, host_type, rebuild = None, None, False
-        for f in ('domain', 'ipv4', 'ipv6'):
-            host = parts[f]  # type: ignore[literal-required]
-            if host:
-                host_type = f
-                break
-
-        if host is None:
-            if cls.host_required:
-                raise errors.UrlHostError()
-        elif host_type == 'domain':
-            is_international = False
-            d = ascii_domain_regex().fullmatch(host)
-            if d is None:
-                d = int_domain_regex().fullmatch(host)
-                if d is None:
-                    raise errors.UrlHostError()
-                is_international = True
-
-            tld = d.group('tld')
-            if tld is None and not is_international:
-                d = int_domain_regex().fullmatch(host)
-                assert d is not None
-                tld = d.group('tld')
-                is_international = True
-
-            if tld is not None:
-                tld = tld[1:]
-            elif cls.tld_required:
-                raise errors.UrlHostTldError()
-
-            if is_international:
-                host_type = 'int_domain'
-                rebuild = True
-                host = host.encode('idna').decode('ascii')
-                if tld is not None:
-                    tld = tld.encode('idna').decode('ascii')
-
-        return host, tld, host_type, rebuild  # type: ignore
-
-    @staticmethod
-    def get_default_parts(parts: 'Parts') -> 'Parts':
-        return {}
-
-    @classmethod
-    def apply_default_parts(cls, parts: 'Parts') -> 'Parts':
-        for key, value in cls.get_default_parts(parts).items():
-            if not parts[key]:  # type: ignore[literal-required]
-                parts[key] = value  # type: ignore[literal-required]
-        return parts
-
-    def __repr__(self) -> str:
-        extra = ', '.join(f'{n}={getattr(self, n)!r}' for n in self.__slots__ if getattr(self, n) is not None)
-        return f'{self.__class__.__name__}({super().__repr__()}, {extra})'
-
-
-class AnyHttpUrl(AnyUrl):
-    allowed_schemes = {'http', 'https'}
-
-    __slots__ = ()
-
-
-class HttpUrl(AnyHttpUrl):
-    tld_required = True
-    # https://stackoverflow.com/questions/417142/what-is-the-maximum-length-of-a-url-in-different-browsers
-    max_length = 2083
-    hidden_parts = {'port'}
-
-    @staticmethod
-    def get_default_parts(parts: 'Parts') -> 'Parts':
-        return {'port': '80' if parts['scheme'] == 'http' else '443'}
-
-
-class FileUrl(AnyUrl):
-    allowed_schemes = {'file'}
-    host_required = False
-
-    __slots__ = ()
-
-
-class MultiHostDsn(AnyUrl):
-    __slots__ = AnyUrl.__slots__ + ('hosts',)
-
-    def __init__(self, *args: Any, hosts: Optional[List['HostParts']] = None, **kwargs: Any):
-        super().__init__(*args, **kwargs)
-        self.hosts = hosts
-
-    @staticmethod
-    def _match_url(url: str) -> Optional[Match[str]]:
-        return multi_host_url_regex().match(url)
-
-    @classmethod
-    def validate_parts(cls, parts: 'Parts', validate_port: bool = True) -> 'Parts':
-        return super().validate_parts(parts, validate_port=False)
-
-    @classmethod
-    def _build_url(cls, m: Match[str], url: str, parts: 'Parts') -> 'MultiHostDsn':
-        hosts_parts: List['HostParts'] = []
-        host_re = host_regex()
-        for host in m.groupdict()['hosts'].split(','):
-            d: Parts = host_re.match(host).groupdict()  # type: ignore
-            host, tld, host_type, rebuild = cls.validate_host(d)
-            port = d.get('port')
-            cls._validate_port(port)
-            hosts_parts.append(
-                {
-                    'host': host,
-                    'host_type': host_type,
-                    'tld': tld,
-                    'rebuild': rebuild,
-                    'port': port,
-                }
-            )
-
-        if len(hosts_parts) > 1:
-            return cls(
-                None if any([hp['rebuild'] for hp in hosts_parts]) else url,
-                scheme=parts['scheme'],
-                user=parts['user'],
-                password=parts['password'],
-                path=parts['path'],
-                query=parts['query'],
-                fragment=parts['fragment'],
-                host_type=None,
-                hosts=hosts_parts,
-            )
-        else:
-            # backwards compatibility with single host
-            host_part = hosts_parts[0]
-            return cls(
-                None if host_part['rebuild'] else url,
-                scheme=parts['scheme'],
-                user=parts['user'],
-                password=parts['password'],
-                host=host_part['host'],
-                tld=host_part['tld'],
-                host_type=host_part['host_type'],
-                port=host_part.get('port'),
-                path=parts['path'],
-                query=parts['query'],
-                fragment=parts['fragment'],
-            )
-
-
-class PostgresDsn(MultiHostDsn):
-    allowed_schemes = {
-        'postgres',
-        'postgresql',
-        'postgresql+asyncpg',
-        'postgresql+pg8000',
-        'postgresql+psycopg2',
-        'postgresql+psycopg2cffi',
-        'postgresql+py-postgresql',
-        'postgresql+pygresql',
-    }
-    user_required = True
-
-    __slots__ = ()
-
-
-class CockroachDsn(AnyUrl):
-    allowed_schemes = {
-        'cockroachdb',
-        'cockroachdb+psycopg2',
-        'cockroachdb+asyncpg',
-    }
-    user_required = True
-
-
-class AmqpDsn(AnyUrl):
-    allowed_schemes = {'amqp', 'amqps'}
-    host_required = False
-
-
-class RedisDsn(AnyUrl):
-    __slots__ = ()
-    allowed_schemes = {'redis', 'rediss'}
-    host_required = False
-
-    @staticmethod
-    def get_default_parts(parts: 'Parts') -> 'Parts':
-        return {
-            'domain': 'localhost' if not (parts['ipv4'] or parts['ipv6']) else '',
-            'port': '6379',
-            'path': '/0',
-        }
-
-
-class MongoDsn(AnyUrl):
-    allowed_schemes = {'mongodb'}
-
-    # TODO: Needed to generic "Parts" for "Replica Set", "Sharded Cluster", and other mongodb deployment modes
-    @staticmethod
-    def get_default_parts(parts: 'Parts') -> 'Parts':
-        return {
-            'port': '27017',
-        }
-
-
-class KafkaDsn(AnyUrl):
-    allowed_schemes = {'kafka'}
-
-    @staticmethod
-    def get_default_parts(parts: 'Parts') -> 'Parts':
-        return {
-            'domain': 'localhost',
-            'port': '9092',
-        }
-
-
-def stricturl(
-    *,
-    strip_whitespace: bool = True,
-    min_length: int = 1,
-    max_length: int = 2**16,
-    tld_required: bool = True,
-    host_required: bool = True,
-    allowed_schemes: Optional[Collection[str]] = None,
-) -> Type[AnyUrl]:
-    # use kwargs then define conf in a dict to aid with IDE type hinting
-    namespace = dict(
-        strip_whitespace=strip_whitespace,
-        min_length=min_length,
-        max_length=max_length,
-        tld_required=tld_required,
-        host_required=host_required,
-        allowed_schemes=allowed_schemes,
-    )
-    return type('UrlValue', (AnyUrl,), namespace)
+class MyModel(BaseModel):
+    url: HttpUrl
+
+m = MyModel(url='http://www.example.com')
+
+# the repr() method for a url will display all properties of the url
+print(repr(m.url))
+#> Url('http://www.example.com/')
+print(m.url.scheme)
+#> http
+print(m.url.host)
+#> www.example.com
+print(m.url.port)
+#> 80
+
+class MyDatabaseModel(BaseModel):
+    db: PostgresDsn
+
+    @field_validator('db')
+    def check_db_name(cls, v):
+        assert v.path and len(v.path) > 1, 'database must be provided'
+        return v
+
+m = MyDatabaseModel(db='postgres://user:pass@localhost:5432/foobar')
+print(m.db)
+#> postgres://user:pass@localhost:5432/foobar
+
+try:
+    MyDatabaseModel(db='postgres://user:pass@localhost:5432')
+except ValidationError as e:
+    print(e)
+    '''
+    1 validation error for MyDatabaseModel
+    db
+      Assertion failed, database must be provided
+    assert (None)
+     +  where None = MultiHostUrl('postgres://user:pass@localhost:5432').path [type=assertion_error, input_value='postgres://user:pass@localhost:5432', input_type=str]
+    '''
+```
+"""
+
+CockroachDsn = Annotated[
+    Url,
+    UrlConstraints(
+        host_required=True,
+        allowed_schemes=[
+            'cockroachdb',
+            'cockroachdb+psycopg2',
+            'cockroachdb+asyncpg',
+        ],
+    ),
+]
+"""A type that will accept any Cockroach DSN.
+
+* User info required
+* TLD not required
+* Host required
+"""
+AmqpDsn = Annotated[Url, UrlConstraints(allowed_schemes=['amqp', 'amqps'])]
+"""A type that will accept any AMQP DSN.
+
+* User info required
+* TLD not required
+* Host required
+"""
+RedisDsn = Annotated[
+    Url,
+    UrlConstraints(allowed_schemes=['redis', 'rediss'], default_host='localhost', default_port=6379, default_path='/0'),
+]
+"""A type that will accept any Redis DSN.
+
+* User info required
+* TLD not required
+* Host required (e.g., `rediss://:pass@localhost`)
+"""
+MongoDsn = Annotated[MultiHostUrl, UrlConstraints(allowed_schemes=['mongodb', 'mongodb+srv'], default_port=27017)]
+"""A type that will accept any MongoDB DSN.
+
+* User info not required
+* Database name not required
+* Port not required
+* User info may be passed without user part (e.g., `mongodb://mongodb0.example.com:27017`).
+"""
+KafkaDsn = Annotated[Url, UrlConstraints(allowed_schemes=['kafka'], default_host='localhost', default_port=9092)]
+"""A type that will accept any Kafka DSN.
+
+* User info required
+* TLD not required
+* Host required
+"""
+NatsDsn = Annotated[
+    MultiHostUrl, UrlConstraints(allowed_schemes=['nats', 'tls', 'ws'], default_host='localhost', default_port=4222)
+]
+"""A type that will accept any NATS DSN.
+
+NATS is a connective technology built for the ever increasingly hyper-connected world.
+It is a single technology that enables applications to securely communicate across
+any combination of cloud vendors, on-premise, edge, web and mobile, and devices.
+More: https://nats.io
+"""
+MySQLDsn = Annotated[
+    Url,
+    UrlConstraints(
+        allowed_schemes=[
+            'mysql',
+            'mysql+mysqlconnector',
+            'mysql+aiomysql',
+            'mysql+asyncmy',
+            'mysql+mysqldb',
+            'mysql+pymysql',
+            'mysql+cymysql',
+            'mysql+pyodbc',
+        ],
+        default_port=3306,
+    ),
+]
+"""A type that will accept any MySQL DSN.
+
+* User info required
+* TLD not required
+* Host required
+"""
+MariaDBDsn = Annotated[
+    Url,
+    UrlConstraints(
+        allowed_schemes=['mariadb', 'mariadb+mariadbconnector', 'mariadb+pymysql'],
+        default_port=3306,
+    ),
+]
+"""A type that will accept any MariaDB DSN.
+
+* User info required
+* TLD not required
+* Host required
+"""
 
 
 def import_email_validator() -> None:
@@ -577,27 +364,95 @@ def import_email_validator() -> None:
         import email_validator
     except ImportError as e:
         raise ImportError('email-validator is not installed, run `pip install pydantic[email]`') from e
+    if not version('email-validator').partition('.')[0] == '2':
+        raise ImportError('email-validator version >= 2.0 required, run pip install -U email-validator')
 
 
-class EmailStr(str):
-    @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-        field_schema.update(type='string', format='email')
+if TYPE_CHECKING:
+    EmailStr = Annotated[str, ...]
+else:
 
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        # included here and below so the error happens straight away
-        import_email_validator()
+    class EmailStr:
+        """
+        Info:
+            To use this type, you need to install the optional
+            [`email-validator`](https://github.com/JoshData/python-email-validator) package:
 
-        yield str_validator
-        yield cls.validate
+            ```bash
+            pip install email-validator
+            ```
 
-    @classmethod
-    def validate(cls, value: Union[str]) -> str:
-        return validate_email(value)[1]
+        Validate email addresses.
+
+        ```py
+        from pydantic import BaseModel, EmailStr
+
+        class Model(BaseModel):
+            email: EmailStr
+
+        print(Model(email='contact@mail.com'))
+        #> email='contact@mail.com'
+        ```
+        """  # noqa: D212
+
+        @classmethod
+        def __get_pydantic_core_schema__(
+            cls,
+            _source: type[Any],
+            _handler: GetCoreSchemaHandler,
+        ) -> core_schema.CoreSchema:
+            import_email_validator()
+            return core_schema.no_info_after_validator_function(cls._validate, core_schema.str_schema())
+
+        @classmethod
+        def __get_pydantic_json_schema__(
+            cls, core_schema: core_schema.CoreSchema, handler: _schema_generation_shared.GetJsonSchemaHandler
+        ) -> JsonSchemaValue:
+            field_schema = handler(core_schema)
+            field_schema.update(type='string', format='email')
+            return field_schema
+
+        @classmethod
+        def _validate(cls, __input_value: str) -> str:
+            return validate_email(__input_value)[1]
 
 
-class NameEmail(Representation):
+class NameEmail(_repr.Representation):
+    """
+    Info:
+        To use this type, you need to install the optional
+        [`email-validator`](https://github.com/JoshData/python-email-validator) package:
+
+        ```bash
+        pip install email-validator
+        ```
+
+    Validate a name and email address combination, as specified by
+    [RFC 5322](https://datatracker.ietf.org/doc/html/rfc5322#section-3.4).
+
+    The `NameEmail` has two properties: `name` and `email`.
+    In case the `name` is not provided, it's inferred from the email address.
+
+    ```py
+    from pydantic import BaseModel, NameEmail
+
+    class User(BaseModel):
+        email: NameEmail
+
+    user = User(email='Fred Bloggs <fred.bloggs@example.com>')
+    print(user.email)
+    #> Fred Bloggs <fred.bloggs@example.com>
+    print(user.email.name)
+    #> Fred Bloggs
+
+    user = User(email='fred.bloggs@example.com')
+    print(user.email)
+    #> fred.bloggs <fred.bloggs@example.com>
+    print(user.email.name)
+    #> fred.bloggs
+    ```
+    """  # noqa: D212
+
     __slots__ = 'name', 'email'
 
     def __init__(self, name: str, email: str):
@@ -608,39 +463,76 @@ class NameEmail(Representation):
         return isinstance(other, NameEmail) and (self.name, self.email) == (other.name, other.email)
 
     @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+    def __get_pydantic_json_schema__(
+        cls, core_schema: core_schema.CoreSchema, handler: _schema_generation_shared.GetJsonSchemaHandler
+    ) -> JsonSchemaValue:
+        field_schema = handler(core_schema)
         field_schema.update(type='string', format='name-email')
+        return field_schema
 
     @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
+    def __get_pydantic_core_schema__(
+        cls,
+        _source: type[Any],
+        _handler: GetCoreSchemaHandler,
+    ) -> core_schema.CoreSchema:
         import_email_validator()
-
-        yield cls.validate
+        return core_schema.no_info_after_validator_function(
+            cls._validate,
+            core_schema.union_schema(
+                [core_schema.is_instance_schema(cls), core_schema.str_schema()],
+                custom_error_type='name_email_type',
+                custom_error_message='Input is not a valid NameEmail',
+            ),
+            serialization=core_schema.to_string_ser_schema(),
+        )
 
     @classmethod
-    def validate(cls, value: Any) -> 'NameEmail':
-        if value.__class__ == cls:
-            return value
-        value = str_validator(value)
-        return cls(*validate_email(value))
+    def _validate(cls, __input_value: NameEmail | str) -> NameEmail:
+        if isinstance(__input_value, cls):
+            return __input_value
+        else:
+            name, email = validate_email(__input_value)  # type: ignore[arg-type]
+            return cls(name, email)
 
     def __str__(self) -> str:
         return f'{self.name} <{self.email}>'
 
 
-class IPvAnyAddress(_BaseAddress):
+class IPvAnyAddress:
+    """Validate an IPv4 or IPv6 address.
+
+    ```py
+    from pydantic import BaseModel
+    from pydantic.networks import IPvAnyAddress
+
+    class IpModel(BaseModel):
+        ip: IPvAnyAddress
+
+    print(IpModel(ip='127.0.0.1'))
+    #> ip=IPv4Address('127.0.0.1')
+
+    try:
+        IpModel(ip='http://www.example.com')
+    except ValueError as e:
+        print(e.errors())
+        '''
+        [
+            {
+                'type': 'ip_any_address',
+                'loc': ('ip',),
+                'msg': 'value is not a valid IPv4 or IPv6 address',
+                'input': 'http://www.example.com',
+            }
+        ]
+        '''
+    ```
+    """
+
     __slots__ = ()
 
-    @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-        field_schema.update(type='string', format='ipvanyaddress')
-
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield cls.validate
-
-    @classmethod
-    def validate(cls, value: Union[str, bytes, int]) -> Union[IPv4Address, IPv6Address]:
+    def __new__(cls, value: Any) -> IPv4Address | IPv6Address:
+        """Validate an IPv4 or IPv6 address."""
         try:
             return IPv4Address(value)
         except ValueError:
@@ -649,22 +541,38 @@ class IPvAnyAddress(_BaseAddress):
         try:
             return IPv6Address(value)
         except ValueError:
-            raise errors.IPvAnyAddressError()
+            raise PydanticCustomError('ip_any_address', 'value is not a valid IPv4 or IPv6 address')
+
+    @classmethod
+    def __get_pydantic_json_schema__(
+        cls, core_schema: core_schema.CoreSchema, handler: _schema_generation_shared.GetJsonSchemaHandler
+    ) -> JsonSchemaValue:
+        field_schema = {}
+        field_schema.update(type='string', format='ipvanyaddress')
+        return field_schema
+
+    @classmethod
+    def __get_pydantic_core_schema__(
+        cls,
+        _source: type[Any],
+        _handler: GetCoreSchemaHandler,
+    ) -> core_schema.CoreSchema:
+        return core_schema.no_info_plain_validator_function(
+            cls._validate, serialization=core_schema.to_string_ser_schema()
+        )
+
+    @classmethod
+    def _validate(cls, __input_value: Any) -> IPv4Address | IPv6Address:
+        return cls(__input_value)  # type: ignore[return-value]
 
 
-class IPvAnyInterface(_BaseAddress):
+class IPvAnyInterface:
+    """Validate an IPv4 or IPv6 interface."""
+
     __slots__ = ()
 
-    @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-        field_schema.update(type='string', format='ipvanyinterface')
-
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield cls.validate
-
-    @classmethod
-    def validate(cls, value: NetworkType) -> Union[IPv4Interface, IPv6Interface]:
+    def __new__(cls, value: NetworkType) -> IPv4Interface | IPv6Interface:
+        """Validate an IPv4 or IPv6 interface."""
         try:
             return IPv4Interface(value)
         except ValueError:
@@ -673,21 +581,39 @@ class IPvAnyInterface(_BaseAddress):
         try:
             return IPv6Interface(value)
         except ValueError:
-            raise errors.IPvAnyInterfaceError()
-
-
-class IPvAnyNetwork(_BaseNetwork):  # type: ignore
-    @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-        field_schema.update(type='string', format='ipvanynetwork')
+            raise PydanticCustomError('ip_any_interface', 'value is not a valid IPv4 or IPv6 interface')
 
     @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield cls.validate
+    def __get_pydantic_json_schema__(
+        cls, core_schema: core_schema.CoreSchema, handler: _schema_generation_shared.GetJsonSchemaHandler
+    ) -> JsonSchemaValue:
+        field_schema = {}
+        field_schema.update(type='string', format='ipvanyinterface')
+        return field_schema
 
     @classmethod
-    def validate(cls, value: NetworkType) -> Union[IPv4Network, IPv6Network]:
-        # Assume IP Network is defined with a default value for ``strict`` argument.
+    def __get_pydantic_core_schema__(
+        cls,
+        _source: type[Any],
+        _handler: GetCoreSchemaHandler,
+    ) -> core_schema.CoreSchema:
+        return core_schema.no_info_plain_validator_function(
+            cls._validate, serialization=core_schema.to_string_ser_schema()
+        )
+
+    @classmethod
+    def _validate(cls, __input_value: NetworkType) -> IPv4Interface | IPv6Interface:
+        return cls(__input_value)  # type: ignore[return-value]
+
+
+class IPvAnyNetwork:
+    """Validate an IPv4 or IPv6 network."""
+
+    __slots__ = ()
+
+    def __new__(cls, value: NetworkType) -> IPv4Network | IPv6Network:
+        """Validate an IPv4 or IPv6 network."""
+        # Assume IP Network is defined with a default value for `strict` argument.
         # Define your own class if you want to specify network address check strictness.
         try:
             return IPv4Network(value)
@@ -697,40 +623,86 @@ class IPvAnyNetwork(_BaseNetwork):  # type: ignore
         try:
             return IPv6Network(value)
         except ValueError:
-            raise errors.IPvAnyNetworkError()
+            raise PydanticCustomError('ip_any_network', 'value is not a valid IPv4 or IPv6 network')
+
+    @classmethod
+    def __get_pydantic_json_schema__(
+        cls, core_schema: core_schema.CoreSchema, handler: _schema_generation_shared.GetJsonSchemaHandler
+    ) -> JsonSchemaValue:
+        field_schema = {}
+        field_schema.update(type='string', format='ipvanynetwork')
+        return field_schema
+
+    @classmethod
+    def __get_pydantic_core_schema__(
+        cls,
+        _source: type[Any],
+        _handler: GetCoreSchemaHandler,
+    ) -> core_schema.CoreSchema:
+        return core_schema.no_info_plain_validator_function(
+            cls._validate, serialization=core_schema.to_string_ser_schema()
+        )
+
+    @classmethod
+    def _validate(cls, __input_value: NetworkType) -> IPv4Network | IPv6Network:
+        return cls(__input_value)  # type: ignore[return-value]
 
 
-pretty_email_regex = re.compile(r'([\w ]*?) *<(.*)> *')
+def _build_pretty_email_regex() -> re.Pattern[str]:
+    name_chars = r'[\w!#$%&\'*+\-/=?^_`{|}~]'
+    unquoted_name_group = rf'((?:{name_chars}+\s+)*{name_chars}+)'
+    quoted_name_group = r'"((?:[^"]|\")+)"'
+    email_group = r'<\s*(.+)\s*>'
+    return re.compile(rf'\s*(?:{unquoted_name_group}|{quoted_name_group})?\s*{email_group}\s*')
 
 
-def validate_email(value: Union[str]) -> Tuple[str, str]:
-    """
-    Brutally simple email address validation. Note unlike most email address validation
-    * raw ip address (literal) domain parts are not allowed.
-    * "John Doe <local_part@domain.com>" style "pretty" email addresses are processed
-    * the local part check is extremely basic. This raises the possibility of unicode spoofing, but no better
-        solution is really possible.
-    * spaces are striped from the beginning and end of addresses but no error is raised
+pretty_email_regex = _build_pretty_email_regex()
 
-    See RFC 5322 but treat it with suspicion, there seems to exist no universally acknowledged test for a valid email!
+MAX_EMAIL_LENGTH = 2048
+"""Maximum length for an email.
+A somewhat arbitrary but very generous number compared to what is allowed by most implementations.
+"""
+
+
+def validate_email(value: str) -> tuple[str, str]:
+    """Email address validation using [email-validator](https://pypi.org/project/email-validator/).
+
+    Note:
+        Note that:
+
+        * Raw IP address (literal) domain parts are not allowed.
+        * `"John Doe <local_part@domain.com>"` style "pretty" email addresses are processed.
+        * Spaces are striped from the beginning and end of addresses, but no error is raised.
     """
     if email_validator is None:
         import_email_validator()
 
+    if len(value) > MAX_EMAIL_LENGTH:
+        raise PydanticCustomError(
+            'value_error',
+            'value is not a valid email address: {reason}',
+            {'reason': f'Length must not exceed {MAX_EMAIL_LENGTH} characters'},
+        )
+
     m = pretty_email_regex.fullmatch(value)
-    name: Optional[str] = None
+    name: str | None = None
     if m:
-        name, value = m.groups()
+        unquoted_name, quoted_name, value = m.groups()
+        name = unquoted_name or quoted_name
 
     email = value.strip()
 
     try:
-        email_validator.validate_email(email, check_deliverability=False)
+        parts = email_validator.validate_email(email, check_deliverability=False)
     except email_validator.EmailNotValidError as e:
-        raise errors.EmailError() from e
+        raise PydanticCustomError(
+            'value_error', 'value is not a valid email address: {reason}', {'reason': str(e.args[0])}
+        ) from e
 
-    at_index = email.index('@')
-    local_part = email[:at_index]  # RFC 5321, local part must be case-sensitive.
-    global_part = email[at_index:].lower()
+    email = parts.normalized
+    assert email is not None
+    name = name or parts.local_part
+    return name, email
 
-    return name or local_part, local_part + global_part
+
+__getattr__ = getattr_migration(__name__)
diff --git a/lib/pydantic/parse.py b/lib/pydantic/parse.py
index 7ac330ca..ceee6342 100644
--- a/lib/pydantic/parse.py
+++ b/lib/pydantic/parse.py
@@ -1,66 +1,4 @@
-import json
-import pickle
-from enum import Enum
-from pathlib import Path
-from typing import Any, Callable, Union
+"""The `parse` module is a backport module from V1."""
+from ._migration import getattr_migration
 
-from .types import StrBytes
-
-
-class Protocol(str, Enum):
-    json = 'json'
-    pickle = 'pickle'
-
-
-def load_str_bytes(
-    b: StrBytes,
-    *,
-    content_type: str = None,
-    encoding: str = 'utf8',
-    proto: Protocol = None,
-    allow_pickle: bool = False,
-    json_loads: Callable[[str], Any] = json.loads,
-) -> Any:
-    if proto is None and content_type:
-        if content_type.endswith(('json', 'javascript')):
-            pass
-        elif allow_pickle and content_type.endswith('pickle'):
-            proto = Protocol.pickle
-        else:
-            raise TypeError(f'Unknown content-type: {content_type}')
-
-    proto = proto or Protocol.json
-
-    if proto == Protocol.json:
-        if isinstance(b, bytes):
-            b = b.decode(encoding)
-        return json_loads(b)
-    elif proto == Protocol.pickle:
-        if not allow_pickle:
-            raise RuntimeError('Trying to decode with pickle with allow_pickle=False')
-        bb = b if isinstance(b, bytes) else b.encode()
-        return pickle.loads(bb)
-    else:
-        raise TypeError(f'Unknown protocol: {proto}')
-
-
-def load_file(
-    path: Union[str, Path],
-    *,
-    content_type: str = None,
-    encoding: str = 'utf8',
-    proto: Protocol = None,
-    allow_pickle: bool = False,
-    json_loads: Callable[[str], Any] = json.loads,
-) -> Any:
-    path = Path(path)
-    b = path.read_bytes()
-    if content_type is None:
-        if path.suffix in ('.js', '.json'):
-            proto = Protocol.json
-        elif path.suffix == '.pkl':
-            proto = Protocol.pickle
-
-    return load_str_bytes(
-        b, proto=proto, content_type=content_type, encoding=encoding, allow_pickle=allow_pickle, json_loads=json_loads
-    )
+__getattr__ = getattr_migration(__name__)
diff --git a/lib/pydantic/plugin/__init__.py b/lib/pydantic/plugin/__init__.py
new file mode 100644
index 00000000..84197006
--- /dev/null
+++ b/lib/pydantic/plugin/__init__.py
@@ -0,0 +1,170 @@
+"""Usage docs: https://docs.pydantic.dev/2.6/concepts/plugins#build-a-plugin
+
+Plugin interface for Pydantic plugins, and related types.
+"""
+from __future__ import annotations
+
+from typing import Any, Callable, NamedTuple
+
+from pydantic_core import CoreConfig, CoreSchema, ValidationError
+from typing_extensions import Literal, Protocol, TypeAlias
+
+__all__ = (
+    'PydanticPluginProtocol',
+    'BaseValidateHandlerProtocol',
+    'ValidatePythonHandlerProtocol',
+    'ValidateJsonHandlerProtocol',
+    'ValidateStringsHandlerProtocol',
+    'NewSchemaReturns',
+    'SchemaTypePath',
+    'SchemaKind',
+)
+
+NewSchemaReturns: TypeAlias = 'tuple[ValidatePythonHandlerProtocol | None, ValidateJsonHandlerProtocol | None, ValidateStringsHandlerProtocol | None]'
+
+
+class SchemaTypePath(NamedTuple):
+    """Path defining where `schema_type` was defined, or where `TypeAdapter` was called."""
+
+    module: str
+    name: str
+
+
+SchemaKind: TypeAlias = Literal['BaseModel', 'TypeAdapter', 'dataclass', 'create_model', 'validate_call']
+
+
+class PydanticPluginProtocol(Protocol):
+    """Protocol defining the interface for Pydantic plugins."""
+
+    def new_schema_validator(
+        self,
+        schema: CoreSchema,
+        schema_type: Any,
+        schema_type_path: SchemaTypePath,
+        schema_kind: SchemaKind,
+        config: CoreConfig | None,
+        plugin_settings: dict[str, object],
+    ) -> tuple[
+        ValidatePythonHandlerProtocol | None, ValidateJsonHandlerProtocol | None, ValidateStringsHandlerProtocol | None
+    ]:
+        """This method is called for each plugin every time a new [`SchemaValidator`][pydantic_core.SchemaValidator]
+        is created.
+
+        It should return an event handler for each of the three validation methods, or `None` if the plugin does not
+        implement that method.
+
+        Args:
+            schema: The schema to validate against.
+            schema_type: The original type which the schema was created from, e.g. the model class.
+            schema_type_path: Path defining where `schema_type` was defined, or where `TypeAdapter` was called.
+            schema_kind: The kind of schema to validate against.
+            config: The config to use for validation.
+            plugin_settings: Any plugin settings.
+
+        Returns:
+            A tuple of optional event handlers for each of the three validation methods -
+                `validate_python`, `validate_json`, `validate_strings`.
+        """
+        raise NotImplementedError('Pydantic plugins should implement `new_schema_validator`.')
+
+
+class BaseValidateHandlerProtocol(Protocol):
+    """Base class for plugin callbacks protocols.
+
+    You shouldn't implement this protocol directly, instead use one of the subclasses with adds the correctly
+    typed `on_error` method.
+    """
+
+    on_enter: Callable[..., None]
+    """`on_enter` is changed to be more specific on all subclasses"""
+
+    def on_success(self, result: Any) -> None:
+        """Callback to be notified of successful validation.
+
+        Args:
+            result: The result of the validation.
+        """
+        return
+
+    def on_error(self, error: ValidationError) -> None:
+        """Callback to be notified of validation errors.
+
+        Args:
+            error: The validation error.
+        """
+        return
+
+    def on_exception(self, exception: Exception) -> None:
+        """Callback to be notified of validation exceptions.
+
+        Args:
+            exception: The exception raised during validation.
+        """
+        return
+
+
+class ValidatePythonHandlerProtocol(BaseValidateHandlerProtocol, Protocol):
+    """Event handler for `SchemaValidator.validate_python`."""
+
+    def on_enter(
+        self,
+        input: Any,
+        *,
+        strict: bool | None = None,
+        from_attributes: bool | None = None,
+        context: dict[str, Any] | None = None,
+        self_instance: Any | None = None,
+    ) -> None:
+        """Callback to be notified of validation start, and create an instance of the event handler.
+
+        Args:
+            input: The input to be validated.
+            strict: Whether to validate the object in strict mode.
+            from_attributes: Whether to validate objects as inputs by extracting attributes.
+            context: The context to use for validation, this is passed to functional validators.
+            self_instance: An instance of a model to set attributes on from validation, this is used when running
+                validation from the `__init__` method of a model.
+        """
+        pass
+
+
+class ValidateJsonHandlerProtocol(BaseValidateHandlerProtocol, Protocol):
+    """Event handler for `SchemaValidator.validate_json`."""
+
+    def on_enter(
+        self,
+        input: str | bytes | bytearray,
+        *,
+        strict: bool | None = None,
+        context: dict[str, Any] | None = None,
+        self_instance: Any | None = None,
+    ) -> None:
+        """Callback to be notified of validation start, and create an instance of the event handler.
+
+        Args:
+            input: The JSON data to be validated.
+            strict: Whether to validate the object in strict mode.
+            context: The context to use for validation, this is passed to functional validators.
+            self_instance: An instance of a model to set attributes on from validation, this is used when running
+                validation from the `__init__` method of a model.
+        """
+        pass
+
+
+StringInput: TypeAlias = 'dict[str, StringInput]'
+
+
+class ValidateStringsHandlerProtocol(BaseValidateHandlerProtocol, Protocol):
+    """Event handler for `SchemaValidator.validate_strings`."""
+
+    def on_enter(
+        self, input: StringInput, *, strict: bool | None = None, context: dict[str, Any] | None = None
+    ) -> None:
+        """Callback to be notified of validation start, and create an instance of the event handler.
+
+        Args:
+            input: The string data to be validated.
+            strict: Whether to validate the object in strict mode.
+            context: The context to use for validation, this is passed to functional validators.
+        """
+        pass
diff --git a/lib/pydantic/plugin/_loader.py b/lib/pydantic/plugin/_loader.py
new file mode 100644
index 00000000..9e0e33ca
--- /dev/null
+++ b/lib/pydantic/plugin/_loader.py
@@ -0,0 +1,50 @@
+from __future__ import annotations
+
+import importlib.metadata as importlib_metadata
+import warnings
+from typing import TYPE_CHECKING, Final, Iterable
+
+if TYPE_CHECKING:
+    from . import PydanticPluginProtocol
+
+
+PYDANTIC_ENTRY_POINT_GROUP: Final[str] = 'pydantic'
+
+# cache of plugins
+_plugins: dict[str, PydanticPluginProtocol] | None = None
+# return no plugins while loading plugins to avoid recursion and errors while import plugins
+# this means that if plugins use pydantic
+_loading_plugins: bool = False
+
+
+def get_plugins() -> Iterable[PydanticPluginProtocol]:
+    """Load plugins for Pydantic.
+
+    Inspired by: https://github.com/pytest-dev/pluggy/blob/1.3.0/src/pluggy/_manager.py#L376-L402
+    """
+    global _plugins, _loading_plugins
+    if _loading_plugins:
+        # this happens when plugins themselves use pydantic, we return no plugins
+        return ()
+    elif _plugins is None:
+        _plugins = {}
+        # set _loading_plugins so any plugins that use pydantic don't themselves use plugins
+        _loading_plugins = True
+        try:
+            for dist in importlib_metadata.distributions():
+                for entry_point in dist.entry_points:
+                    if entry_point.group != PYDANTIC_ENTRY_POINT_GROUP:
+                        continue
+                    if entry_point.value in _plugins:
+                        continue
+                    try:
+                        _plugins[entry_point.value] = entry_point.load()
+                    except (ImportError, AttributeError) as e:
+                        warnings.warn(
+                            f'{e.__class__.__name__} while loading the `{entry_point.name}` Pydantic plugin, '
+                            f'this plugin will not be installed.\n\n{e!r}'
+                        )
+        finally:
+            _loading_plugins = False
+
+    return _plugins.values()
diff --git a/lib/pydantic/plugin/_schema_validator.py b/lib/pydantic/plugin/_schema_validator.py
new file mode 100644
index 00000000..7186ece6
--- /dev/null
+++ b/lib/pydantic/plugin/_schema_validator.py
@@ -0,0 +1,138 @@
+"""Pluggable schema validator for pydantic."""
+from __future__ import annotations
+
+import functools
+from typing import TYPE_CHECKING, Any, Callable, Iterable, TypeVar
+
+from pydantic_core import CoreConfig, CoreSchema, SchemaValidator, ValidationError
+from typing_extensions import Literal, ParamSpec
+
+if TYPE_CHECKING:
+    from . import BaseValidateHandlerProtocol, PydanticPluginProtocol, SchemaKind, SchemaTypePath
+
+
+P = ParamSpec('P')
+R = TypeVar('R')
+Event = Literal['on_validate_python', 'on_validate_json', 'on_validate_strings']
+events: list[Event] = list(Event.__args__)  # type: ignore
+
+
+def create_schema_validator(
+    schema: CoreSchema,
+    schema_type: Any,
+    schema_type_module: str,
+    schema_type_name: str,
+    schema_kind: SchemaKind,
+    config: CoreConfig | None = None,
+    plugin_settings: dict[str, Any] | None = None,
+) -> SchemaValidator:
+    """Create a `SchemaValidator` or `PluggableSchemaValidator` if plugins are installed.
+
+    Returns:
+        If plugins are installed then return `PluggableSchemaValidator`, otherwise return `SchemaValidator`.
+    """
+    from . import SchemaTypePath
+    from ._loader import get_plugins
+
+    plugins = get_plugins()
+    if plugins:
+        return PluggableSchemaValidator(
+            schema,
+            schema_type,
+            SchemaTypePath(schema_type_module, schema_type_name),
+            schema_kind,
+            config,
+            plugins,
+            plugin_settings or {},
+        )  # type: ignore
+    else:
+        return SchemaValidator(schema, config)
+
+
+class PluggableSchemaValidator:
+    """Pluggable schema validator."""
+
+    __slots__ = '_schema_validator', 'validate_json', 'validate_python', 'validate_strings'
+
+    def __init__(
+        self,
+        schema: CoreSchema,
+        schema_type: Any,
+        schema_type_path: SchemaTypePath,
+        schema_kind: SchemaKind,
+        config: CoreConfig | None,
+        plugins: Iterable[PydanticPluginProtocol],
+        plugin_settings: dict[str, Any],
+    ) -> None:
+        self._schema_validator = SchemaValidator(schema, config)
+
+        python_event_handlers: list[BaseValidateHandlerProtocol] = []
+        json_event_handlers: list[BaseValidateHandlerProtocol] = []
+        strings_event_handlers: list[BaseValidateHandlerProtocol] = []
+        for plugin in plugins:
+            try:
+                p, j, s = plugin.new_schema_validator(
+                    schema, schema_type, schema_type_path, schema_kind, config, plugin_settings
+                )
+            except TypeError as e:  # pragma: no cover
+                raise TypeError(f'Error using plugin `{plugin.__module__}:{plugin.__class__.__name__}`: {e}') from e
+            if p is not None:
+                python_event_handlers.append(p)
+            if j is not None:
+                json_event_handlers.append(j)
+            if s is not None:
+                strings_event_handlers.append(s)
+
+        self.validate_python = build_wrapper(self._schema_validator.validate_python, python_event_handlers)
+        self.validate_json = build_wrapper(self._schema_validator.validate_json, json_event_handlers)
+        self.validate_strings = build_wrapper(self._schema_validator.validate_strings, strings_event_handlers)
+
+    def __getattr__(self, name: str) -> Any:
+        return getattr(self._schema_validator, name)
+
+
+def build_wrapper(func: Callable[P, R], event_handlers: list[BaseValidateHandlerProtocol]) -> Callable[P, R]:
+    if not event_handlers:
+        return func
+    else:
+        on_enters = tuple(h.on_enter for h in event_handlers if filter_handlers(h, 'on_enter'))
+        on_successes = tuple(h.on_success for h in event_handlers if filter_handlers(h, 'on_success'))
+        on_errors = tuple(h.on_error for h in event_handlers if filter_handlers(h, 'on_error'))
+        on_exceptions = tuple(h.on_exception for h in event_handlers if filter_handlers(h, 'on_exception'))
+
+        @functools.wraps(func)
+        def wrapper(*args: P.args, **kwargs: P.kwargs) -> R:
+            for on_enter_handler in on_enters:
+                on_enter_handler(*args, **kwargs)
+
+            try:
+                result = func(*args, **kwargs)
+            except ValidationError as error:
+                for on_error_handler in on_errors:
+                    on_error_handler(error)
+                raise
+            except Exception as exception:
+                for on_exception_handler in on_exceptions:
+                    on_exception_handler(exception)
+                raise
+            else:
+                for on_success_handler in on_successes:
+                    on_success_handler(result)
+                return result
+
+        return wrapper
+
+
+def filter_handlers(handler_cls: BaseValidateHandlerProtocol, method_name: str) -> bool:
+    """Filter out handler methods which are not implemented by the plugin directly - e.g. are missing
+    or are inherited from the protocol.
+    """
+    handler = getattr(handler_cls, method_name, None)
+    if handler is None:
+        return False
+    elif handler.__module__ == 'pydantic.plugin':
+        # this is the original handler, from the protocol due to runtime inheritance
+        # we don't want to call it
+        return False
+    else:
+        return True
diff --git a/lib/pydantic/root_model.py b/lib/pydantic/root_model.py
new file mode 100644
index 00000000..42186b9d
--- /dev/null
+++ b/lib/pydantic/root_model.py
@@ -0,0 +1,149 @@
+"""RootModel class and type definitions."""
+
+from __future__ import annotations as _annotations
+
+import typing
+from copy import copy, deepcopy
+
+from pydantic_core import PydanticUndefined
+
+from . import PydanticUserError
+from ._internal import _model_construction, _repr
+from .main import BaseModel, _object_setattr
+
+if typing.TYPE_CHECKING:
+    from typing import Any
+
+    from typing_extensions import Literal, dataclass_transform
+
+    from .fields import Field as PydanticModelField
+
+    # dataclass_transform could be applied to RootModel directly, but `ModelMetaclass`'s dataclass_transform
+    # takes priority (at least with pyright). We trick type checkers into thinking we apply dataclass_transform
+    # on a new metaclass.
+    @dataclass_transform(kw_only_default=False, field_specifiers=(PydanticModelField,))
+    class _RootModelMetaclass(_model_construction.ModelMetaclass):
+        ...
+
+    Model = typing.TypeVar('Model', bound='BaseModel')
+else:
+    _RootModelMetaclass = _model_construction.ModelMetaclass
+
+__all__ = ('RootModel',)
+
+
+RootModelRootType = typing.TypeVar('RootModelRootType')
+
+
+class RootModel(BaseModel, typing.Generic[RootModelRootType], metaclass=_RootModelMetaclass):
+    """Usage docs: https://docs.pydantic.dev/2.6/concepts/models/#rootmodel-and-custom-root-types
+
+    A Pydantic `BaseModel` for the root object of the model.
+
+    Attributes:
+        root: The root object of the model.
+        __pydantic_root_model__: Whether the model is a RootModel.
+        __pydantic_private__: Private fields in the model.
+        __pydantic_extra__: Extra fields in the model.
+
+    """
+
+    __pydantic_root_model__ = True
+    __pydantic_private__ = None
+    __pydantic_extra__ = None
+
+    root: RootModelRootType
+
+    def __init_subclass__(cls, **kwargs):
+        extra = cls.model_config.get('extra')
+        if extra is not None:
+            raise PydanticUserError(
+                "`RootModel` does not support setting `model_config['extra']`", code='root-model-extra'
+            )
+        super().__init_subclass__(**kwargs)
+
+    def __init__(self, /, root: RootModelRootType = PydanticUndefined, **data) -> None:  # type: ignore
+        __tracebackhide__ = True
+        if data:
+            if root is not PydanticUndefined:
+                raise ValueError(
+                    '"RootModel.__init__" accepts either a single positional argument or arbitrary keyword arguments'
+                )
+            root = data  # type: ignore
+        self.__pydantic_validator__.validate_python(root, self_instance=self)
+
+    __init__.__pydantic_base_init__ = True  # pyright: ignore[reportFunctionMemberAccess]
+
+    @classmethod
+    def model_construct(cls: type[Model], root: RootModelRootType, _fields_set: set[str] | None = None) -> Model:  # type: ignore
+        """Create a new model using the provided root object and update fields set.
+
+        Args:
+            root: The root object of the model.
+            _fields_set: The set of fields to be updated.
+
+        Returns:
+            The new model.
+
+        Raises:
+            NotImplemented: If the model is not a subclass of `RootModel`.
+        """
+        return super().model_construct(root=root, _fields_set=_fields_set)
+
+    def __getstate__(self) -> dict[Any, Any]:
+        return {
+            '__dict__': self.__dict__,
+            '__pydantic_fields_set__': self.__pydantic_fields_set__,
+        }
+
+    def __setstate__(self, state: dict[Any, Any]) -> None:
+        _object_setattr(self, '__pydantic_fields_set__', state['__pydantic_fields_set__'])
+        _object_setattr(self, '__dict__', state['__dict__'])
+
+    def __copy__(self: Model) -> Model:
+        """Returns a shallow copy of the model."""
+        cls = type(self)
+        m = cls.__new__(cls)
+        _object_setattr(m, '__dict__', copy(self.__dict__))
+        _object_setattr(m, '__pydantic_fields_set__', copy(self.__pydantic_fields_set__))
+        return m
+
+    def __deepcopy__(self: Model, memo: dict[int, Any] | None = None) -> Model:
+        """Returns a deep copy of the model."""
+        cls = type(self)
+        m = cls.__new__(cls)
+        _object_setattr(m, '__dict__', deepcopy(self.__dict__, memo=memo))
+        # This next line doesn't need a deepcopy because __pydantic_fields_set__ is a set[str],
+        # and attempting a deepcopy would be marginally slower.
+        _object_setattr(m, '__pydantic_fields_set__', copy(self.__pydantic_fields_set__))
+        return m
+
+    if typing.TYPE_CHECKING:
+
+        def model_dump(  # type: ignore
+            self,
+            *,
+            mode: Literal['json', 'python'] | str = 'python',
+            include: Any = None,
+            exclude: Any = None,
+            by_alias: bool = False,
+            exclude_unset: bool = False,
+            exclude_defaults: bool = False,
+            exclude_none: bool = False,
+            round_trip: bool = False,
+            warnings: bool = True,
+        ) -> RootModelRootType:
+            """This method is included just to get a more accurate return type for type checkers.
+            It is included in this `if TYPE_CHECKING:` block since no override is actually necessary.
+
+            See the documentation of `BaseModel.model_dump` for more details about the arguments.
+            """
+            ...
+
+    def __eq__(self, other: Any) -> bool:
+        if not isinstance(other, RootModel):
+            return NotImplemented
+        return self.model_fields['root'].annotation == other.model_fields['root'].annotation and super().__eq__(other)
+
+    def __repr_args__(self) -> _repr.ReprArgs:
+        yield 'root', self.root
diff --git a/lib/pydantic/schema.py b/lib/pydantic/schema.py
index e7af56f1..e290aed9 100644
--- a/lib/pydantic/schema.py
+++ b/lib/pydantic/schema.py
@@ -1,1153 +1,4 @@
-import re
-import warnings
-from collections import defaultdict
-from datetime import date, datetime, time, timedelta
-from decimal import Decimal
-from enum import Enum
-from ipaddress import IPv4Address, IPv4Interface, IPv4Network, IPv6Address, IPv6Interface, IPv6Network
-from pathlib import Path
-from typing import (
-    TYPE_CHECKING,
-    Any,
-    Callable,
-    Dict,
-    ForwardRef,
-    FrozenSet,
-    Generic,
-    Iterable,
-    List,
-    Optional,
-    Pattern,
-    Sequence,
-    Set,
-    Tuple,
-    Type,
-    TypeVar,
-    Union,
-    cast,
-)
-from uuid import UUID
+"""The `schema` module is a backport module from V1."""
+from ._migration import getattr_migration
 
-from typing_extensions import Annotated, Literal
-
-from .fields import (
-    MAPPING_LIKE_SHAPES,
-    SHAPE_DEQUE,
-    SHAPE_FROZENSET,
-    SHAPE_GENERIC,
-    SHAPE_ITERABLE,
-    SHAPE_LIST,
-    SHAPE_SEQUENCE,
-    SHAPE_SET,
-    SHAPE_SINGLETON,
-    SHAPE_TUPLE,
-    SHAPE_TUPLE_ELLIPSIS,
-    FieldInfo,
-    ModelField,
-)
-from .json import pydantic_encoder
-from .networks import AnyUrl, EmailStr
-from .types import (
-    ConstrainedDecimal,
-    ConstrainedFloat,
-    ConstrainedFrozenSet,
-    ConstrainedInt,
-    ConstrainedList,
-    ConstrainedSet,
-    SecretBytes,
-    SecretStr,
-    StrictBytes,
-    StrictStr,
-    conbytes,
-    condecimal,
-    confloat,
-    confrozenset,
-    conint,
-    conlist,
-    conset,
-    constr,
-)
-from .typing import (
-    all_literal_values,
-    get_args,
-    get_origin,
-    get_sub_types,
-    is_callable_type,
-    is_literal_type,
-    is_namedtuple,
-    is_none_type,
-    is_union,
-)
-from .utils import ROOT_KEY, get_model, lenient_issubclass
-
-if TYPE_CHECKING:
-    from .dataclasses import Dataclass
-    from .main import BaseModel
-
-default_prefix = '#/definitions/'
-default_ref_template = '#/definitions/{model}'
-
-TypeModelOrEnum = Union[Type['BaseModel'], Type[Enum]]
-TypeModelSet = Set[TypeModelOrEnum]
-
-
-def _apply_modify_schema(
-    modify_schema: Callable[..., None], field: Optional[ModelField], field_schema: Dict[str, Any]
-) -> None:
-    from inspect import signature
-
-    sig = signature(modify_schema)
-    args = set(sig.parameters.keys())
-    if 'field' in args or 'kwargs' in args:
-        modify_schema(field_schema, field=field)
-    else:
-        modify_schema(field_schema)
-
-
-def schema(
-    models: Sequence[Union[Type['BaseModel'], Type['Dataclass']]],
-    *,
-    by_alias: bool = True,
-    title: Optional[str] = None,
-    description: Optional[str] = None,
-    ref_prefix: Optional[str] = None,
-    ref_template: str = default_ref_template,
-) -> Dict[str, Any]:
-    """
-    Process a list of models and generate a single JSON Schema with all of them defined in the ``definitions``
-    top-level JSON key, including their sub-models.
-
-    :param models: a list of models to include in the generated JSON Schema
-    :param by_alias: generate the schemas using the aliases defined, if any
-    :param title: title for the generated schema that includes the definitions
-    :param description: description for the generated schema
-    :param ref_prefix: the JSON Pointer prefix for schema references with ``$ref``, if None, will be set to the
-      default of ``#/definitions/``. Update it if you want the schemas to reference the definitions somewhere
-      else, e.g. for OpenAPI use ``#/components/schemas/``. The resulting generated schemas will still be at the
-      top-level key ``definitions``, so you can extract them from there. But all the references will have the set
-      prefix.
-    :param ref_template: Use a ``string.format()`` template for ``$ref`` instead of a prefix. This can be useful
-      for references that cannot be represented by ``ref_prefix`` such as a definition stored in another file. For
-      a sibling json file in a ``/schemas`` directory use ``"/schemas/${model}.json#"``.
-    :return: dict with the JSON Schema with a ``definitions`` top-level key including the schema definitions for
-      the models and sub-models passed in ``models``.
-    """
-    clean_models = [get_model(model) for model in models]
-    flat_models = get_flat_models_from_models(clean_models)
-    model_name_map = get_model_name_map(flat_models)
-    definitions = {}
-    output_schema: Dict[str, Any] = {}
-    if title:
-        output_schema['title'] = title
-    if description:
-        output_schema['description'] = description
-    for model in clean_models:
-        m_schema, m_definitions, m_nested_models = model_process_schema(
-            model,
-            by_alias=by_alias,
-            model_name_map=model_name_map,
-            ref_prefix=ref_prefix,
-            ref_template=ref_template,
-        )
-        definitions.update(m_definitions)
-        model_name = model_name_map[model]
-        definitions[model_name] = m_schema
-    if definitions:
-        output_schema['definitions'] = definitions
-    return output_schema
-
-
-def model_schema(
-    model: Union[Type['BaseModel'], Type['Dataclass']],
-    by_alias: bool = True,
-    ref_prefix: Optional[str] = None,
-    ref_template: str = default_ref_template,
-) -> Dict[str, Any]:
-    """
-    Generate a JSON Schema for one model. With all the sub-models defined in the ``definitions`` top-level
-    JSON key.
-
-    :param model: a Pydantic model (a class that inherits from BaseModel)
-    :param by_alias: generate the schemas using the aliases defined, if any
-    :param ref_prefix: the JSON Pointer prefix for schema references with ``$ref``, if None, will be set to the
-      default of ``#/definitions/``. Update it if you want the schemas to reference the definitions somewhere
-      else, e.g. for OpenAPI use ``#/components/schemas/``. The resulting generated schemas will still be at the
-      top-level key ``definitions``, so you can extract them from there. But all the references will have the set
-      prefix.
-    :param ref_template: Use a ``string.format()`` template for ``$ref`` instead of a prefix. This can be useful for
-      references that cannot be represented by ``ref_prefix`` such as a definition stored in another file. For a
-      sibling json file in a ``/schemas`` directory use ``"/schemas/${model}.json#"``.
-    :return: dict with the JSON Schema for the passed ``model``
-    """
-    model = get_model(model)
-    flat_models = get_flat_models_from_model(model)
-    model_name_map = get_model_name_map(flat_models)
-    model_name = model_name_map[model]
-    m_schema, m_definitions, nested_models = model_process_schema(
-        model, by_alias=by_alias, model_name_map=model_name_map, ref_prefix=ref_prefix, ref_template=ref_template
-    )
-    if model_name in nested_models:
-        # model_name is in Nested models, it has circular references
-        m_definitions[model_name] = m_schema
-        m_schema = get_schema_ref(model_name, ref_prefix, ref_template, False)
-    if m_definitions:
-        m_schema.update({'definitions': m_definitions})
-    return m_schema
-
-
-def get_field_info_schema(field: ModelField, schema_overrides: bool = False) -> Tuple[Dict[str, Any], bool]:
-
-    # If no title is explicitly set, we don't set title in the schema for enums.
-    # The behaviour is the same as `BaseModel` reference, where the default title
-    # is in the definitions part of the schema.
-    schema_: Dict[str, Any] = {}
-    if field.field_info.title or not lenient_issubclass(field.type_, Enum):
-        schema_['title'] = field.field_info.title or field.alias.title().replace('_', ' ')
-
-    if field.field_info.title:
-        schema_overrides = True
-
-    if field.field_info.description:
-        schema_['description'] = field.field_info.description
-        schema_overrides = True
-
-    if not field.required and field.default is not None and not is_callable_type(field.outer_type_):
-        schema_['default'] = encode_default(field.default)
-        schema_overrides = True
-
-    return schema_, schema_overrides
-
-
-def field_schema(
-    field: ModelField,
-    *,
-    by_alias: bool = True,
-    model_name_map: Dict[TypeModelOrEnum, str],
-    ref_prefix: Optional[str] = None,
-    ref_template: str = default_ref_template,
-    known_models: TypeModelSet = None,
-) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]:
-    """
-    Process a Pydantic field and return a tuple with a JSON Schema for it as the first item.
-    Also return a dictionary of definitions with models as keys and their schemas as values. If the passed field
-    is a model and has sub-models, and those sub-models don't have overrides (as ``title``, ``default``, etc), they
-    will be included in the definitions and referenced in the schema instead of included recursively.
-
-    :param field: a Pydantic ``ModelField``
-    :param by_alias: use the defined alias (if any) in the returned schema
-    :param model_name_map: used to generate the JSON Schema references to other models included in the definitions
-    :param ref_prefix: the JSON Pointer prefix to use for references to other schemas, if None, the default of
-      #/definitions/ will be used
-    :param ref_template: Use a ``string.format()`` template for ``$ref`` instead of a prefix. This can be useful for
-      references that cannot be represented by ``ref_prefix`` such as a definition stored in another file. For a
-      sibling json file in a ``/schemas`` directory use ``"/schemas/${model}.json#"``.
-    :param known_models: used to solve circular references
-    :return: tuple of the schema for this field and additional definitions
-    """
-    s, schema_overrides = get_field_info_schema(field)
-
-    validation_schema = get_field_schema_validations(field)
-    if validation_schema:
-        s.update(validation_schema)
-        schema_overrides = True
-
-    f_schema, f_definitions, f_nested_models = field_type_schema(
-        field,
-        by_alias=by_alias,
-        model_name_map=model_name_map,
-        schema_overrides=schema_overrides,
-        ref_prefix=ref_prefix,
-        ref_template=ref_template,
-        known_models=known_models or set(),
-    )
-
-    # $ref will only be returned when there are no schema_overrides
-    if '$ref' in f_schema:
-        return f_schema, f_definitions, f_nested_models
-    else:
-        s.update(f_schema)
-        return s, f_definitions, f_nested_models
-
-
-numeric_types = (int, float, Decimal)
-_str_types_attrs: Tuple[Tuple[str, Union[type, Tuple[type, ...]], str], ...] = (
-    ('max_length', numeric_types, 'maxLength'),
-    ('min_length', numeric_types, 'minLength'),
-    ('regex', str, 'pattern'),
-)
-
-_numeric_types_attrs: Tuple[Tuple[str, Union[type, Tuple[type, ...]], str], ...] = (
-    ('gt', numeric_types, 'exclusiveMinimum'),
-    ('lt', numeric_types, 'exclusiveMaximum'),
-    ('ge', numeric_types, 'minimum'),
-    ('le', numeric_types, 'maximum'),
-    ('multiple_of', numeric_types, 'multipleOf'),
-)
-
-
-def get_field_schema_validations(field: ModelField) -> Dict[str, Any]:
-    """
-    Get the JSON Schema validation keywords for a ``field`` with an annotation of
-    a Pydantic ``FieldInfo`` with validation arguments.
-    """
-    f_schema: Dict[str, Any] = {}
-
-    if lenient_issubclass(field.type_, Enum):
-        # schema is already updated by `enum_process_schema`; just update with field extra
-        if field.field_info.extra:
-            f_schema.update(field.field_info.extra)
-        return f_schema
-
-    if lenient_issubclass(field.type_, (str, bytes)):
-        for attr_name, t, keyword in _str_types_attrs:
-            attr = getattr(field.field_info, attr_name, None)
-            if isinstance(attr, t):
-                f_schema[keyword] = attr
-    if lenient_issubclass(field.type_, numeric_types) and not issubclass(field.type_, bool):
-        for attr_name, t, keyword in _numeric_types_attrs:
-            attr = getattr(field.field_info, attr_name, None)
-            if isinstance(attr, t):
-                f_schema[keyword] = attr
-    if field.field_info is not None and field.field_info.const:
-        f_schema['const'] = field.default
-    if field.field_info.extra:
-        f_schema.update(field.field_info.extra)
-    modify_schema = getattr(field.outer_type_, '__modify_schema__', None)
-    if modify_schema:
-        _apply_modify_schema(modify_schema, field, f_schema)
-    return f_schema
-
-
-def get_model_name_map(unique_models: TypeModelSet) -> Dict[TypeModelOrEnum, str]:
-    """
-    Process a set of models and generate unique names for them to be used as keys in the JSON Schema
-    definitions. By default the names are the same as the class name. But if two models in different Python
-    modules have the same name (e.g. "users.Model" and "items.Model"), the generated names will be
-    based on the Python module path for those conflicting models to prevent name collisions.
-
-    :param unique_models: a Python set of models
-    :return: dict mapping models to names
-    """
-    name_model_map = {}
-    conflicting_names: Set[str] = set()
-    for model in unique_models:
-        model_name = normalize_name(model.__name__)
-        if model_name in conflicting_names:
-            model_name = get_long_model_name(model)
-            name_model_map[model_name] = model
-        elif model_name in name_model_map:
-            conflicting_names.add(model_name)
-            conflicting_model = name_model_map.pop(model_name)
-            name_model_map[get_long_model_name(conflicting_model)] = conflicting_model
-            name_model_map[get_long_model_name(model)] = model
-        else:
-            name_model_map[model_name] = model
-    return {v: k for k, v in name_model_map.items()}
-
-
-def get_flat_models_from_model(model: Type['BaseModel'], known_models: TypeModelSet = None) -> TypeModelSet:
-    """
-    Take a single ``model`` and generate a set with itself and all the sub-models in the tree. I.e. if you pass
-    model ``Foo`` (subclass of Pydantic ``BaseModel``) as ``model``, and it has a field of type ``Bar`` (also
-    subclass of ``BaseModel``) and that model ``Bar`` has a field of type ``Baz`` (also subclass of ``BaseModel``),
-    the return value will be ``set([Foo, Bar, Baz])``.
-
-    :param model: a Pydantic ``BaseModel`` subclass
-    :param known_models: used to solve circular references
-    :return: a set with the initial model and all its sub-models
-    """
-    known_models = known_models or set()
-    flat_models: TypeModelSet = set()
-    flat_models.add(model)
-    known_models |= flat_models
-    fields = cast(Sequence[ModelField], model.__fields__.values())
-    flat_models |= get_flat_models_from_fields(fields, known_models=known_models)
-    return flat_models
-
-
-def get_flat_models_from_field(field: ModelField, known_models: TypeModelSet) -> TypeModelSet:
-    """
-    Take a single Pydantic ``ModelField`` (from a model) that could have been declared as a sublcass of BaseModel
-    (so, it could be a submodel), and generate a set with its model and all the sub-models in the tree.
-    I.e. if you pass a field that was declared to be of type ``Foo`` (subclass of BaseModel) as ``field``, and that
-    model ``Foo`` has a field of type ``Bar`` (also subclass of ``BaseModel``) and that model ``Bar`` has a field of
-    type ``Baz`` (also subclass of ``BaseModel``), the return value will be ``set([Foo, Bar, Baz])``.
-
-    :param field: a Pydantic ``ModelField``
-    :param known_models: used to solve circular references
-    :return: a set with the model used in the declaration for this field, if any, and all its sub-models
-    """
-    from .main import BaseModel
-
-    flat_models: TypeModelSet = set()
-
-    field_type = field.type_
-    if lenient_issubclass(getattr(field_type, '__pydantic_model__', None), BaseModel):
-        field_type = field_type.__pydantic_model__
-
-    if field.sub_fields and not lenient_issubclass(field_type, BaseModel):
-        flat_models |= get_flat_models_from_fields(field.sub_fields, known_models=known_models)
-    elif lenient_issubclass(field_type, BaseModel) and field_type not in known_models:
-        flat_models |= get_flat_models_from_model(field_type, known_models=known_models)
-    elif lenient_issubclass(field_type, Enum):
-        flat_models.add(field_type)
-    return flat_models
-
-
-def get_flat_models_from_fields(fields: Sequence[ModelField], known_models: TypeModelSet) -> TypeModelSet:
-    """
-    Take a list of Pydantic  ``ModelField``s (from a model) that could have been declared as subclasses of ``BaseModel``
-    (so, any of them could be a submodel), and generate a set with their models and all the sub-models in the tree.
-    I.e. if you pass a the fields of a model ``Foo`` (subclass of ``BaseModel``) as ``fields``, and on of them has a
-    field of type ``Bar`` (also subclass of ``BaseModel``) and that model ``Bar`` has a field of type ``Baz`` (also
-    subclass of ``BaseModel``), the return value will be ``set([Foo, Bar, Baz])``.
-
-    :param fields: a list of Pydantic ``ModelField``s
-    :param known_models: used to solve circular references
-    :return: a set with any model declared in the fields, and all their sub-models
-    """
-    flat_models: TypeModelSet = set()
-    for field in fields:
-        flat_models |= get_flat_models_from_field(field, known_models=known_models)
-    return flat_models
-
-
-def get_flat_models_from_models(models: Sequence[Type['BaseModel']]) -> TypeModelSet:
-    """
-    Take a list of ``models`` and generate a set with them and all their sub-models in their trees. I.e. if you pass
-    a list of two models, ``Foo`` and ``Bar``, both subclasses of Pydantic ``BaseModel`` as models, and ``Bar`` has
-    a field of type ``Baz`` (also subclass of ``BaseModel``), the return value will be ``set([Foo, Bar, Baz])``.
-    """
-    flat_models: TypeModelSet = set()
-    for model in models:
-        flat_models |= get_flat_models_from_model(model)
-    return flat_models
-
-
-def get_long_model_name(model: TypeModelOrEnum) -> str:
-    return f'{model.__module__}__{model.__qualname__}'.replace('.', '__')
-
-
-def field_type_schema(
-    field: ModelField,
-    *,
-    by_alias: bool,
-    model_name_map: Dict[TypeModelOrEnum, str],
-    ref_template: str,
-    schema_overrides: bool = False,
-    ref_prefix: Optional[str] = None,
-    known_models: TypeModelSet,
-) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]:
-    """
-    Used by ``field_schema()``, you probably should be using that function.
-
-    Take a single ``field`` and generate the schema for its type only, not including additional
-    information as title, etc. Also return additional schema definitions, from sub-models.
-    """
-    from .main import BaseModel  # noqa: F811
-
-    definitions = {}
-    nested_models: Set[str] = set()
-    f_schema: Dict[str, Any]
-    if field.shape in {
-        SHAPE_LIST,
-        SHAPE_TUPLE_ELLIPSIS,
-        SHAPE_SEQUENCE,
-        SHAPE_SET,
-        SHAPE_FROZENSET,
-        SHAPE_ITERABLE,
-        SHAPE_DEQUE,
-    }:
-        items_schema, f_definitions, f_nested_models = field_singleton_schema(
-            field,
-            by_alias=by_alias,
-            model_name_map=model_name_map,
-            ref_prefix=ref_prefix,
-            ref_template=ref_template,
-            known_models=known_models,
-        )
-        definitions.update(f_definitions)
-        nested_models.update(f_nested_models)
-        f_schema = {'type': 'array', 'items': items_schema}
-        if field.shape in {SHAPE_SET, SHAPE_FROZENSET}:
-            f_schema['uniqueItems'] = True
-
-    elif field.shape in MAPPING_LIKE_SHAPES:
-        f_schema = {'type': 'object'}
-        key_field = cast(ModelField, field.key_field)
-        regex = getattr(key_field.type_, 'regex', None)
-        items_schema, f_definitions, f_nested_models = field_singleton_schema(
-            field,
-            by_alias=by_alias,
-            model_name_map=model_name_map,
-            ref_prefix=ref_prefix,
-            ref_template=ref_template,
-            known_models=known_models,
-        )
-        definitions.update(f_definitions)
-        nested_models.update(f_nested_models)
-        if regex:
-            # Dict keys have a regex pattern
-            # items_schema might be a schema or empty dict, add it either way
-            f_schema['patternProperties'] = {regex.pattern: items_schema}
-        elif items_schema:
-            # The dict values are not simply Any, so they need a schema
-            f_schema['additionalProperties'] = items_schema
-    elif field.shape == SHAPE_TUPLE or (field.shape == SHAPE_GENERIC and not issubclass(field.type_, BaseModel)):
-        sub_schema = []
-        sub_fields = cast(List[ModelField], field.sub_fields)
-        for sf in sub_fields:
-            sf_schema, sf_definitions, sf_nested_models = field_type_schema(
-                sf,
-                by_alias=by_alias,
-                model_name_map=model_name_map,
-                ref_prefix=ref_prefix,
-                ref_template=ref_template,
-                known_models=known_models,
-            )
-            definitions.update(sf_definitions)
-            nested_models.update(sf_nested_models)
-            sub_schema.append(sf_schema)
-
-        sub_fields_len = len(sub_fields)
-        if field.shape == SHAPE_GENERIC:
-            all_of_schemas = sub_schema[0] if sub_fields_len == 1 else {'type': 'array', 'items': sub_schema}
-            f_schema = {'allOf': [all_of_schemas]}
-        else:
-            f_schema = {
-                'type': 'array',
-                'minItems': sub_fields_len,
-                'maxItems': sub_fields_len,
-            }
-            if sub_fields_len >= 1:
-                f_schema['items'] = sub_schema
-    else:
-        assert field.shape in {SHAPE_SINGLETON, SHAPE_GENERIC}, field.shape
-        f_schema, f_definitions, f_nested_models = field_singleton_schema(
-            field,
-            by_alias=by_alias,
-            model_name_map=model_name_map,
-            schema_overrides=schema_overrides,
-            ref_prefix=ref_prefix,
-            ref_template=ref_template,
-            known_models=known_models,
-        )
-        definitions.update(f_definitions)
-        nested_models.update(f_nested_models)
-
-    # check field type to avoid repeated calls to the same __modify_schema__ method
-    if field.type_ != field.outer_type_:
-        if field.shape == SHAPE_GENERIC:
-            field_type = field.type_
-        else:
-            field_type = field.outer_type_
-        modify_schema = getattr(field_type, '__modify_schema__', None)
-        if modify_schema:
-            _apply_modify_schema(modify_schema, field, f_schema)
-    return f_schema, definitions, nested_models
-
-
-def model_process_schema(
-    model: TypeModelOrEnum,
-    *,
-    by_alias: bool = True,
-    model_name_map: Dict[TypeModelOrEnum, str],
-    ref_prefix: Optional[str] = None,
-    ref_template: str = default_ref_template,
-    known_models: TypeModelSet = None,
-    field: Optional[ModelField] = None,
-) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]:
-    """
-    Used by ``model_schema()``, you probably should be using that function.
-
-    Take a single ``model`` and generate its schema. Also return additional schema definitions, from sub-models. The
-    sub-models of the returned schema will be referenced, but their definitions will not be included in the schema. All
-    the definitions are returned as the second value.
-    """
-    from inspect import getdoc, signature
-
-    known_models = known_models or set()
-    if lenient_issubclass(model, Enum):
-        model = cast(Type[Enum], model)
-        s = enum_process_schema(model, field=field)
-        return s, {}, set()
-    model = cast(Type['BaseModel'], model)
-    s = {'title': model.__config__.title or model.__name__}
-    doc = getdoc(model)
-    if doc:
-        s['description'] = doc
-    known_models.add(model)
-    m_schema, m_definitions, nested_models = model_type_schema(
-        model,
-        by_alias=by_alias,
-        model_name_map=model_name_map,
-        ref_prefix=ref_prefix,
-        ref_template=ref_template,
-        known_models=known_models,
-    )
-    s.update(m_schema)
-    schema_extra = model.__config__.schema_extra
-    if callable(schema_extra):
-        if len(signature(schema_extra).parameters) == 1:
-            schema_extra(s)
-        else:
-            schema_extra(s, model)
-    else:
-        s.update(schema_extra)
-    return s, m_definitions, nested_models
-
-
-def model_type_schema(
-    model: Type['BaseModel'],
-    *,
-    by_alias: bool,
-    model_name_map: Dict[TypeModelOrEnum, str],
-    ref_template: str,
-    ref_prefix: Optional[str] = None,
-    known_models: TypeModelSet,
-) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]:
-    """
-    You probably should be using ``model_schema()``, this function is indirectly used by that function.
-
-    Take a single ``model`` and generate the schema for its type only, not including additional
-    information as title, etc. Also return additional schema definitions, from sub-models.
-    """
-    properties = {}
-    required = []
-    definitions: Dict[str, Any] = {}
-    nested_models: Set[str] = set()
-    for k, f in model.__fields__.items():
-        try:
-            f_schema, f_definitions, f_nested_models = field_schema(
-                f,
-                by_alias=by_alias,
-                model_name_map=model_name_map,
-                ref_prefix=ref_prefix,
-                ref_template=ref_template,
-                known_models=known_models,
-            )
-        except SkipField as skip:
-            warnings.warn(skip.message, UserWarning)
-            continue
-        definitions.update(f_definitions)
-        nested_models.update(f_nested_models)
-        if by_alias:
-            properties[f.alias] = f_schema
-            if f.required:
-                required.append(f.alias)
-        else:
-            properties[k] = f_schema
-            if f.required:
-                required.append(k)
-    if ROOT_KEY in properties:
-        out_schema = properties[ROOT_KEY]
-        out_schema['title'] = model.__config__.title or model.__name__
-    else:
-        out_schema = {'type': 'object', 'properties': properties}
-        if required:
-            out_schema['required'] = required
-    if model.__config__.extra == 'forbid':
-        out_schema['additionalProperties'] = False
-    return out_schema, definitions, nested_models
-
-
-def enum_process_schema(enum: Type[Enum], *, field: Optional[ModelField] = None) -> Dict[str, Any]:
-    """
-    Take a single `enum` and generate its schema.
-
-    This is similar to the `model_process_schema` function, but applies to ``Enum`` objects.
-    """
-    schema_: Dict[str, Any] = {
-        'title': enum.__name__,
-        # Python assigns all enums a default docstring value of 'An enumeration', so
-        # all enums will have a description field even if not explicitly provided.
-        'description': enum.__doc__ or 'An enumeration.',
-        # Add enum values and the enum field type to the schema.
-        'enum': [item.value for item in cast(Iterable[Enum], enum)],
-    }
-
-    add_field_type_to_schema(enum, schema_)
-
-    modify_schema = getattr(enum, '__modify_schema__', None)
-    if modify_schema:
-        _apply_modify_schema(modify_schema, field, schema_)
-
-    return schema_
-
-
-def field_singleton_sub_fields_schema(
-    field: ModelField,
-    *,
-    by_alias: bool,
-    model_name_map: Dict[TypeModelOrEnum, str],
-    ref_template: str,
-    schema_overrides: bool = False,
-    ref_prefix: Optional[str] = None,
-    known_models: TypeModelSet,
-) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]:
-    """
-    This function is indirectly used by ``field_schema()``, you probably should be using that function.
-
-    Take a list of Pydantic ``ModelField`` from the declaration of a type with parameters, and generate their
-    schema. I.e., fields used as "type parameters", like ``str`` and ``int`` in ``Tuple[str, int]``.
-    """
-    sub_fields = cast(List[ModelField], field.sub_fields)
-    definitions = {}
-    nested_models: Set[str] = set()
-    if len(sub_fields) == 1:
-        return field_type_schema(
-            sub_fields[0],
-            by_alias=by_alias,
-            model_name_map=model_name_map,
-            schema_overrides=schema_overrides,
-            ref_prefix=ref_prefix,
-            ref_template=ref_template,
-            known_models=known_models,
-        )
-    else:
-        s: Dict[str, Any] = {}
-        # https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#discriminator-object
-        field_has_discriminator: bool = field.discriminator_key is not None
-        if field_has_discriminator:
-            assert field.sub_fields_mapping is not None
-
-            discriminator_models_refs: Dict[str, Union[str, Dict[str, Any]]] = {}
-
-            for discriminator_value, sub_field in field.sub_fields_mapping.items():
-                # sub_field is either a `BaseModel` or directly an `Annotated` `Union` of many
-                if is_union(get_origin(sub_field.type_)):
-                    sub_models = get_sub_types(sub_field.type_)
-                    discriminator_models_refs[discriminator_value] = {
-                        model_name_map[sub_model]: get_schema_ref(
-                            model_name_map[sub_model], ref_prefix, ref_template, False
-                        )
-                        for sub_model in sub_models
-                    }
-                else:
-                    sub_field_type = sub_field.type_
-                    if hasattr(sub_field_type, '__pydantic_model__'):
-                        sub_field_type = sub_field_type.__pydantic_model__
-
-                    discriminator_model_name = model_name_map[sub_field_type]
-                    discriminator_model_ref = get_schema_ref(discriminator_model_name, ref_prefix, ref_template, False)
-                    discriminator_models_refs[discriminator_value] = discriminator_model_ref['$ref']
-
-            s['discriminator'] = {
-                'propertyName': field.discriminator_alias,
-                'mapping': discriminator_models_refs,
-            }
-
-        sub_field_schemas = []
-        for sf in sub_fields:
-            sub_schema, sub_definitions, sub_nested_models = field_type_schema(
-                sf,
-                by_alias=by_alias,
-                model_name_map=model_name_map,
-                schema_overrides=schema_overrides,
-                ref_prefix=ref_prefix,
-                ref_template=ref_template,
-                known_models=known_models,
-            )
-            definitions.update(sub_definitions)
-            if schema_overrides and 'allOf' in sub_schema:
-                # if the sub_field is a referenced schema we only need the referenced
-                # object. Otherwise we will end up with several allOf inside anyOf/oneOf.
-                # See https://github.com/pydantic/pydantic/issues/1209
-                sub_schema = sub_schema['allOf'][0]
-
-            if sub_schema.keys() == {'discriminator', 'oneOf'}:
-                # we don't want discriminator information inside oneOf choices, this is dealt with elsewhere
-                sub_schema.pop('discriminator')
-            sub_field_schemas.append(sub_schema)
-            nested_models.update(sub_nested_models)
-        s['oneOf' if field_has_discriminator else 'anyOf'] = sub_field_schemas
-        return s, definitions, nested_models
-
-
-# Order is important, e.g. subclasses of str must go before str
-# this is used only for standard library types, custom types should use __modify_schema__ instead
-field_class_to_schema: Tuple[Tuple[Any, Dict[str, Any]], ...] = (
-    (Path, {'type': 'string', 'format': 'path'}),
-    (datetime, {'type': 'string', 'format': 'date-time'}),
-    (date, {'type': 'string', 'format': 'date'}),
-    (time, {'type': 'string', 'format': 'time'}),
-    (timedelta, {'type': 'number', 'format': 'time-delta'}),
-    (IPv4Network, {'type': 'string', 'format': 'ipv4network'}),
-    (IPv6Network, {'type': 'string', 'format': 'ipv6network'}),
-    (IPv4Interface, {'type': 'string', 'format': 'ipv4interface'}),
-    (IPv6Interface, {'type': 'string', 'format': 'ipv6interface'}),
-    (IPv4Address, {'type': 'string', 'format': 'ipv4'}),
-    (IPv6Address, {'type': 'string', 'format': 'ipv6'}),
-    (Pattern, {'type': 'string', 'format': 'regex'}),
-    (str, {'type': 'string'}),
-    (bytes, {'type': 'string', 'format': 'binary'}),
-    (bool, {'type': 'boolean'}),
-    (int, {'type': 'integer'}),
-    (float, {'type': 'number'}),
-    (Decimal, {'type': 'number'}),
-    (UUID, {'type': 'string', 'format': 'uuid'}),
-    (dict, {'type': 'object'}),
-    (list, {'type': 'array', 'items': {}}),
-    (tuple, {'type': 'array', 'items': {}}),
-    (set, {'type': 'array', 'items': {}, 'uniqueItems': True}),
-    (frozenset, {'type': 'array', 'items': {}, 'uniqueItems': True}),
-)
-
-json_scheme = {'type': 'string', 'format': 'json-string'}
-
-
-def add_field_type_to_schema(field_type: Any, schema_: Dict[str, Any]) -> None:
-    """
-    Update the given `schema` with the type-specific metadata for the given `field_type`.
-
-    This function looks through `field_class_to_schema` for a class that matches the given `field_type`,
-    and then modifies the given `schema` with the information from that type.
-    """
-    for type_, t_schema in field_class_to_schema:
-        # Fallback for `typing.Pattern` and `re.Pattern` as they are not a valid class
-        if lenient_issubclass(field_type, type_) or field_type is type_ is Pattern:
-            schema_.update(t_schema)
-            break
-
-
-def get_schema_ref(name: str, ref_prefix: Optional[str], ref_template: str, schema_overrides: bool) -> Dict[str, Any]:
-    if ref_prefix:
-        schema_ref = {'$ref': ref_prefix + name}
-    else:
-        schema_ref = {'$ref': ref_template.format(model=name)}
-    return {'allOf': [schema_ref]} if schema_overrides else schema_ref
-
-
-def field_singleton_schema(  # noqa: C901 (ignore complexity)
-    field: ModelField,
-    *,
-    by_alias: bool,
-    model_name_map: Dict[TypeModelOrEnum, str],
-    ref_template: str,
-    schema_overrides: bool = False,
-    ref_prefix: Optional[str] = None,
-    known_models: TypeModelSet,
-) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]:
-    """
-    This function is indirectly used by ``field_schema()``, you should probably be using that function.
-
-    Take a single Pydantic ``ModelField``, and return its schema and any additional definitions from sub-models.
-    """
-    from .main import BaseModel
-
-    definitions: Dict[str, Any] = {}
-    nested_models: Set[str] = set()
-    field_type = field.type_
-
-    # Recurse into this field if it contains sub_fields and is NOT a
-    # BaseModel OR that BaseModel is a const
-    if field.sub_fields and (
-        (field.field_info and field.field_info.const) or not lenient_issubclass(field_type, BaseModel)
-    ):
-        return field_singleton_sub_fields_schema(
-            field,
-            by_alias=by_alias,
-            model_name_map=model_name_map,
-            schema_overrides=schema_overrides,
-            ref_prefix=ref_prefix,
-            ref_template=ref_template,
-            known_models=known_models,
-        )
-    if field_type is Any or field_type is object or field_type.__class__ == TypeVar or get_origin(field_type) is type:
-        return {}, definitions, nested_models  # no restrictions
-    if is_none_type(field_type):
-        return {'type': 'null'}, definitions, nested_models
-    if is_callable_type(field_type):
-        raise SkipField(f'Callable {field.name} was excluded from schema since JSON schema has no equivalent type.')
-    f_schema: Dict[str, Any] = {}
-    if field.field_info is not None and field.field_info.const:
-        f_schema['const'] = field.default
-
-    if is_literal_type(field_type):
-        values = all_literal_values(field_type)
-
-        if len({v.__class__ for v in values}) > 1:
-            return field_schema(
-                multitypes_literal_field_for_schema(values, field),
-                by_alias=by_alias,
-                model_name_map=model_name_map,
-                ref_prefix=ref_prefix,
-                ref_template=ref_template,
-                known_models=known_models,
-            )
-
-        # All values have the same type
-        field_type = values[0].__class__
-        f_schema['enum'] = list(values)
-        add_field_type_to_schema(field_type, f_schema)
-    elif lenient_issubclass(field_type, Enum):
-        enum_name = model_name_map[field_type]
-        f_schema, schema_overrides = get_field_info_schema(field, schema_overrides)
-        f_schema.update(get_schema_ref(enum_name, ref_prefix, ref_template, schema_overrides))
-        definitions[enum_name] = enum_process_schema(field_type, field=field)
-    elif is_namedtuple(field_type):
-        sub_schema, *_ = model_process_schema(
-            field_type.__pydantic_model__,
-            by_alias=by_alias,
-            model_name_map=model_name_map,
-            ref_prefix=ref_prefix,
-            ref_template=ref_template,
-            known_models=known_models,
-            field=field,
-        )
-        items_schemas = list(sub_schema['properties'].values())
-        f_schema.update(
-            {
-                'type': 'array',
-                'items': items_schemas,
-                'minItems': len(items_schemas),
-                'maxItems': len(items_schemas),
-            }
-        )
-    elif not hasattr(field_type, '__pydantic_model__'):
-        add_field_type_to_schema(field_type, f_schema)
-
-        modify_schema = getattr(field_type, '__modify_schema__', None)
-        if modify_schema:
-            _apply_modify_schema(modify_schema, field, f_schema)
-
-    if f_schema:
-        return f_schema, definitions, nested_models
-
-    # Handle dataclass-based models
-    if lenient_issubclass(getattr(field_type, '__pydantic_model__', None), BaseModel):
-        field_type = field_type.__pydantic_model__
-
-    if issubclass(field_type, BaseModel):
-        model_name = model_name_map[field_type]
-        if field_type not in known_models:
-            sub_schema, sub_definitions, sub_nested_models = model_process_schema(
-                field_type,
-                by_alias=by_alias,
-                model_name_map=model_name_map,
-                ref_prefix=ref_prefix,
-                ref_template=ref_template,
-                known_models=known_models,
-                field=field,
-            )
-            definitions.update(sub_definitions)
-            definitions[model_name] = sub_schema
-            nested_models.update(sub_nested_models)
-        else:
-            nested_models.add(model_name)
-        schema_ref = get_schema_ref(model_name, ref_prefix, ref_template, schema_overrides)
-        return schema_ref, definitions, nested_models
-
-    # For generics with no args
-    args = get_args(field_type)
-    if args is not None and not args and Generic in field_type.__bases__:
-        return f_schema, definitions, nested_models
-
-    raise ValueError(f'Value not declarable with JSON Schema, field: {field}')
-
-
-def multitypes_literal_field_for_schema(values: Tuple[Any, ...], field: ModelField) -> ModelField:
-    """
-    To support `Literal` with values of different types, we split it into multiple `Literal` with same type
-    e.g. `Literal['qwe', 'asd', 1, 2]` becomes `Union[Literal['qwe', 'asd'], Literal[1, 2]]`
-    """
-    literal_distinct_types = defaultdict(list)
-    for v in values:
-        literal_distinct_types[v.__class__].append(v)
-    distinct_literals = (Literal[tuple(same_type_values)] for same_type_values in literal_distinct_types.values())
-
-    return ModelField(
-        name=field.name,
-        type_=Union[tuple(distinct_literals)],  # type: ignore
-        class_validators=field.class_validators,
-        model_config=field.model_config,
-        default=field.default,
-        required=field.required,
-        alias=field.alias,
-        field_info=field.field_info,
-    )
-
-
-def encode_default(dft: Any) -> Any:
-    if isinstance(dft, Enum):
-        return dft.value
-    elif isinstance(dft, (int, float, str)):
-        return dft
-    elif isinstance(dft, (list, tuple)):
-        t = dft.__class__
-        seq_args = (encode_default(v) for v in dft)
-        return t(*seq_args) if is_namedtuple(t) else t(seq_args)
-    elif isinstance(dft, dict):
-        return {encode_default(k): encode_default(v) for k, v in dft.items()}
-    elif dft is None:
-        return None
-    else:
-        return pydantic_encoder(dft)
-
-
-_map_types_constraint: Dict[Any, Callable[..., type]] = {int: conint, float: confloat, Decimal: condecimal}
-
-
-def get_annotation_from_field_info(
-    annotation: Any, field_info: FieldInfo, field_name: str, validate_assignment: bool = False
-) -> Type[Any]:
-    """
-    Get an annotation with validation implemented for numbers and strings based on the field_info.
-    :param annotation: an annotation from a field specification, as ``str``, ``ConstrainedStr``
-    :param field_info: an instance of FieldInfo, possibly with declarations for validations and JSON Schema
-    :param field_name: name of the field for use in error messages
-    :param validate_assignment: default False, flag for BaseModel Config value of validate_assignment
-    :return: the same ``annotation`` if unmodified or a new annotation with validation in place
-    """
-    constraints = field_info.get_constraints()
-    used_constraints: Set[str] = set()
-    if constraints:
-        annotation, used_constraints = get_annotation_with_constraints(annotation, field_info)
-    if validate_assignment:
-        used_constraints.add('allow_mutation')
-
-    unused_constraints = constraints - used_constraints
-    if unused_constraints:
-        raise ValueError(
-            f'On field "{field_name}" the following field constraints are set but not enforced: '
-            f'{", ".join(unused_constraints)}. '
-            f'\nFor more details see https://pydantic-docs.helpmanual.io/usage/schema/#unenforced-field-constraints'
-        )
-
-    return annotation
-
-
-def get_annotation_with_constraints(annotation: Any, field_info: FieldInfo) -> Tuple[Type[Any], Set[str]]:  # noqa: C901
-    """
-    Get an annotation with used constraints implemented for numbers and strings based on the field_info.
-
-    :param annotation: an annotation from a field specification, as ``str``, ``ConstrainedStr``
-    :param field_info: an instance of FieldInfo, possibly with declarations for validations and JSON Schema
-    :return: the same ``annotation`` if unmodified or a new annotation along with the used constraints.
-    """
-    used_constraints: Set[str] = set()
-
-    def go(type_: Any) -> Type[Any]:
-        if (
-            is_literal_type(type_)
-            or isinstance(type_, ForwardRef)
-            or lenient_issubclass(type_, (ConstrainedList, ConstrainedSet, ConstrainedFrozenSet))
-        ):
-            return type_
-        origin = get_origin(type_)
-        if origin is not None:
-            args: Tuple[Any, ...] = get_args(type_)
-            if any(isinstance(a, ForwardRef) for a in args):
-                # forward refs cause infinite recursion below
-                return type_
-
-            if origin is Annotated:
-                return go(args[0])
-            if is_union(origin):
-                return Union[tuple(go(a) for a in args)]  # type: ignore
-
-            if issubclass(origin, List) and (
-                field_info.min_items is not None
-                or field_info.max_items is not None
-                or field_info.unique_items is not None
-            ):
-                used_constraints.update({'min_items', 'max_items', 'unique_items'})
-                return conlist(
-                    go(args[0]),
-                    min_items=field_info.min_items,
-                    max_items=field_info.max_items,
-                    unique_items=field_info.unique_items,
-                )
-
-            if issubclass(origin, Set) and (field_info.min_items is not None or field_info.max_items is not None):
-                used_constraints.update({'min_items', 'max_items'})
-                return conset(go(args[0]), min_items=field_info.min_items, max_items=field_info.max_items)
-
-            if issubclass(origin, FrozenSet) and (field_info.min_items is not None or field_info.max_items is not None):
-                used_constraints.update({'min_items', 'max_items'})
-                return confrozenset(go(args[0]), min_items=field_info.min_items, max_items=field_info.max_items)
-
-            for t in (Tuple, List, Set, FrozenSet, Sequence):
-                if issubclass(origin, t):  # type: ignore
-                    return t[tuple(go(a) for a in args)]  # type: ignore
-
-            if issubclass(origin, Dict):
-                return Dict[args[0], go(args[1])]  # type: ignore
-
-        attrs: Optional[Tuple[str, ...]] = None
-        constraint_func: Optional[Callable[..., type]] = None
-        if isinstance(type_, type):
-            if issubclass(type_, (SecretStr, SecretBytes)):
-                attrs = ('max_length', 'min_length')
-
-                def constraint_func(**kw: Any) -> Type[Any]:
-                    return type(type_.__name__, (type_,), kw)
-
-            elif issubclass(type_, str) and not issubclass(type_, (EmailStr, AnyUrl)):
-                attrs = ('max_length', 'min_length', 'regex')
-                if issubclass(type_, StrictStr):
-
-                    def constraint_func(**kw: Any) -> Type[Any]:
-                        return type(type_.__name__, (type_,), kw)
-
-                else:
-                    constraint_func = constr
-            elif issubclass(type_, bytes):
-                attrs = ('max_length', 'min_length', 'regex')
-                if issubclass(type_, StrictBytes):
-
-                    def constraint_func(**kw: Any) -> Type[Any]:
-                        return type(type_.__name__, (type_,), kw)
-
-                else:
-                    constraint_func = conbytes
-            elif issubclass(type_, numeric_types) and not issubclass(
-                type_,
-                (
-                    ConstrainedInt,
-                    ConstrainedFloat,
-                    ConstrainedDecimal,
-                    ConstrainedList,
-                    ConstrainedSet,
-                    ConstrainedFrozenSet,
-                    bool,
-                ),
-            ):
-                # Is numeric type
-                attrs = ('gt', 'lt', 'ge', 'le', 'multiple_of')
-                if issubclass(type_, float):
-                    attrs += ('allow_inf_nan',)
-                if issubclass(type_, Decimal):
-                    attrs += ('max_digits', 'decimal_places')
-                numeric_type = next(t for t in numeric_types if issubclass(type_, t))  # pragma: no branch
-                constraint_func = _map_types_constraint[numeric_type]
-
-        if attrs:
-            used_constraints.update(set(attrs))
-            kwargs = {
-                attr_name: attr
-                for attr_name, attr in ((attr_name, getattr(field_info, attr_name)) for attr_name in attrs)
-                if attr is not None
-            }
-            if kwargs:
-                constraint_func = cast(Callable[..., type], constraint_func)
-                return constraint_func(**kwargs)
-        return type_
-
-    return go(annotation), used_constraints
-
-
-def normalize_name(name: str) -> str:
-    """
-    Normalizes the given name. This can be applied to either a model *or* enum.
-    """
-    return re.sub(r'[^a-zA-Z0-9.\-_]', '_', name)
-
-
-class SkipField(Exception):
-    """
-    Utility exception used to exclude fields from schema.
-    """
-
-    def __init__(self, message: str) -> None:
-        self.message = message
+__getattr__ = getattr_migration(__name__)
diff --git a/lib/pydantic/tools.py b/lib/pydantic/tools.py
index 9cdb4538..8e317c92 100644
--- a/lib/pydantic/tools.py
+++ b/lib/pydantic/tools.py
@@ -1,92 +1,4 @@
-import json
-from functools import lru_cache
-from pathlib import Path
-from typing import TYPE_CHECKING, Any, Callable, Optional, Type, TypeVar, Union
+"""The `tools` module is a backport module from V1."""
+from ._migration import getattr_migration
 
-from .parse import Protocol, load_file, load_str_bytes
-from .types import StrBytes
-from .typing import display_as_type
-
-__all__ = ('parse_file_as', 'parse_obj_as', 'parse_raw_as', 'schema_of', 'schema_json_of')
-
-NameFactory = Union[str, Callable[[Type[Any]], str]]
-
-if TYPE_CHECKING:
-    from .typing import DictStrAny
-
-
-def _generate_parsing_type_name(type_: Any) -> str:
-    return f'ParsingModel[{display_as_type(type_)}]'
-
-
-@lru_cache(maxsize=2048)
-def _get_parsing_type(type_: Any, *, type_name: Optional[NameFactory] = None) -> Any:
-    from pydantic.main import create_model
-
-    if type_name is None:
-        type_name = _generate_parsing_type_name
-    if not isinstance(type_name, str):
-        type_name = type_name(type_)
-    return create_model(type_name, __root__=(type_, ...))
-
-
-T = TypeVar('T')
-
-
-def parse_obj_as(type_: Type[T], obj: Any, *, type_name: Optional[NameFactory] = None) -> T:
-    model_type = _get_parsing_type(type_, type_name=type_name)  # type: ignore[arg-type]
-    return model_type(__root__=obj).__root__
-
-
-def parse_file_as(
-    type_: Type[T],
-    path: Union[str, Path],
-    *,
-    content_type: str = None,
-    encoding: str = 'utf8',
-    proto: Protocol = None,
-    allow_pickle: bool = False,
-    json_loads: Callable[[str], Any] = json.loads,
-    type_name: Optional[NameFactory] = None,
-) -> T:
-    obj = load_file(
-        path,
-        proto=proto,
-        content_type=content_type,
-        encoding=encoding,
-        allow_pickle=allow_pickle,
-        json_loads=json_loads,
-    )
-    return parse_obj_as(type_, obj, type_name=type_name)
-
-
-def parse_raw_as(
-    type_: Type[T],
-    b: StrBytes,
-    *,
-    content_type: str = None,
-    encoding: str = 'utf8',
-    proto: Protocol = None,
-    allow_pickle: bool = False,
-    json_loads: Callable[[str], Any] = json.loads,
-    type_name: Optional[NameFactory] = None,
-) -> T:
-    obj = load_str_bytes(
-        b,
-        proto=proto,
-        content_type=content_type,
-        encoding=encoding,
-        allow_pickle=allow_pickle,
-        json_loads=json_loads,
-    )
-    return parse_obj_as(type_, obj, type_name=type_name)
-
-
-def schema_of(type_: Any, *, title: Optional[NameFactory] = None, **schema_kwargs: Any) -> 'DictStrAny':
-    """Generate a JSON schema (as dict) for the passed model or dynamically generated one"""
-    return _get_parsing_type(type_, type_name=title).schema(**schema_kwargs)
-
-
-def schema_json_of(type_: Any, *, title: Optional[NameFactory] = None, **schema_json_kwargs: Any) -> str:
-    """Generate a JSON schema (as JSON) for the passed model or dynamically generated one"""
-    return _get_parsing_type(type_, type_name=title).schema_json(**schema_json_kwargs)
+__getattr__ = getattr_migration(__name__)
diff --git a/lib/pydantic/type_adapter.py b/lib/pydantic/type_adapter.py
new file mode 100644
index 00000000..366262fe
--- /dev/null
+++ b/lib/pydantic/type_adapter.py
@@ -0,0 +1,460 @@
+"""Type adapter specification."""
+from __future__ import annotations as _annotations
+
+import sys
+from dataclasses import is_dataclass
+from typing import TYPE_CHECKING, Any, Dict, Generic, Iterable, Set, TypeVar, Union, cast, final, overload
+
+from pydantic_core import CoreSchema, SchemaSerializer, SchemaValidator, Some
+from typing_extensions import Literal, get_args, is_typeddict
+
+from pydantic.errors import PydanticUserError
+from pydantic.main import BaseModel
+
+from ._internal import _config, _generate_schema, _typing_extra
+from .config import ConfigDict
+from .json_schema import (
+    DEFAULT_REF_TEMPLATE,
+    GenerateJsonSchema,
+    JsonSchemaKeyT,
+    JsonSchemaMode,
+    JsonSchemaValue,
+)
+from .plugin._schema_validator import create_schema_validator
+
+T = TypeVar('T')
+
+
+if TYPE_CHECKING:
+    # should be `set[int] | set[str] | dict[int, IncEx] | dict[str, IncEx] | None`, but mypy can't cope
+    IncEx = Union[Set[int], Set[str], Dict[int, Any], Dict[str, Any]]
+
+
+def _get_schema(type_: Any, config_wrapper: _config.ConfigWrapper, parent_depth: int) -> CoreSchema:
+    """`BaseModel` uses its own `__module__` to find out where it was defined
+    and then looks for symbols to resolve forward references in those globals.
+    On the other hand this function can be called with arbitrary objects,
+    including type aliases, where `__module__` (always `typing.py`) is not useful.
+    So instead we look at the globals in our parent stack frame.
+
+    This works for the case where this function is called in a module that
+    has the target of forward references in its scope, but
+    does not always work for more complex cases.
+
+    For example, take the following:
+
+    a.py
+    ```python
+    from typing import Dict, List
+
+    IntList = List[int]
+    OuterDict = Dict[str, 'IntList']
+    ```
+
+    b.py
+    ```python test="skip"
+    from a import OuterDict
+
+    from pydantic import TypeAdapter
+
+    IntList = int  # replaces the symbol the forward reference is looking for
+    v = TypeAdapter(OuterDict)
+    v({'x': 1})  # should fail but doesn't
+    ```
+
+    If `OuterDict` were a `BaseModel`, this would work because it would resolve
+    the forward reference within the `a.py` namespace.
+    But `TypeAdapter(OuterDict)` can't determine what module `OuterDict` came from.
+
+    In other words, the assumption that _all_ forward references exist in the
+    module we are being called from is not technically always true.
+    Although most of the time it is and it works fine for recursive models and such,
+    `BaseModel`'s behavior isn't perfect either and _can_ break in similar ways,
+    so there is no right or wrong between the two.
+
+    But at the very least this behavior is _subtly_ different from `BaseModel`'s.
+    """
+    local_ns = _typing_extra.parent_frame_namespace(parent_depth=parent_depth)
+    global_ns = sys._getframe(max(parent_depth - 1, 1)).f_globals.copy()
+    global_ns.update(local_ns or {})
+    gen = _generate_schema.GenerateSchema(config_wrapper, types_namespace=global_ns, typevars_map={})
+    schema = gen.generate_schema(type_)
+    schema = gen.clean_schema(schema)
+    return schema
+
+
+def _getattr_no_parents(obj: Any, attribute: str) -> Any:
+    """Returns the attribute value without attempting to look up attributes from parent types."""
+    if hasattr(obj, '__dict__'):
+        try:
+            return obj.__dict__[attribute]
+        except KeyError:
+            pass
+
+    slots = getattr(obj, '__slots__', None)
+    if slots is not None and attribute in slots:
+        return getattr(obj, attribute)
+    else:
+        raise AttributeError(attribute)
+
+
+def _type_has_config(type_: Any) -> bool:
+    """Returns whether the type has config."""
+    try:
+        return issubclass(type_, BaseModel) or is_dataclass(type_) or is_typeddict(type_)
+    except TypeError:
+        # type is not a class
+        return False
+
+
+@final
+class TypeAdapter(Generic[T]):
+    """Usage docs: https://docs.pydantic.dev/2.6/concepts/type_adapter/
+
+    Type adapters provide a flexible way to perform validation and serialization based on a Python type.
+
+    A `TypeAdapter` instance exposes some of the functionality from `BaseModel` instance methods
+    for types that do not have such methods (such as dataclasses, primitive types, and more).
+
+    **Note:** `TypeAdapter` instances are not types, and cannot be used as type annotations for fields.
+
+    Attributes:
+        core_schema: The core schema for the type.
+        validator (SchemaValidator): The schema validator for the type.
+        serializer: The schema serializer for the type.
+    """
+
+    @overload
+    def __init__(
+        self,
+        type: type[T],
+        *,
+        config: ConfigDict | None = ...,
+        _parent_depth: int = ...,
+        module: str | None = ...,
+    ) -> None:
+        ...
+
+    # This second overload is for unsupported special forms (such as Union). `pyright` handles them fine, but `mypy` does not match
+    # them against `type: type[T]`, so an explicit overload with `type: T` is needed.
+    @overload
+    def __init__(  # pyright: ignore[reportOverlappingOverload]
+        self,
+        type: T,
+        *,
+        config: ConfigDict | None = ...,
+        _parent_depth: int = ...,
+        module: str | None = ...,
+    ) -> None:
+        ...
+
+    def __init__(
+        self,
+        type: type[T] | T,
+        *,
+        config: ConfigDict | None = None,
+        _parent_depth: int = 2,
+        module: str | None = None,
+    ) -> None:
+        """Initializes the TypeAdapter object.
+
+        Args:
+            type: The type associated with the `TypeAdapter`.
+            config: Configuration for the `TypeAdapter`, should be a dictionary conforming to [`ConfigDict`][pydantic.config.ConfigDict].
+            _parent_depth: depth at which to search the parent namespace to construct the local namespace.
+            module: The module that passes to plugin if provided.
+
+        !!! note
+            You cannot use the `config` argument when instantiating a `TypeAdapter` if the type you're using has its own
+            config that cannot be overridden (ex: `BaseModel`, `TypedDict`, and `dataclass`). A
+            [`type-adapter-config-unused`](../errors/usage_errors.md#type-adapter-config-unused) error will be raised in this case.
+
+        !!! note
+            The `_parent_depth` argument is named with an underscore to suggest its private nature and discourage use.
+            It may be deprecated in a minor version, so we only recommend using it if you're
+            comfortable with potential change in behavior / support.
+
+        ??? tip "Compatibility with `mypy`"
+            Depending on the type used, `mypy` might raise an error when instantiating a `TypeAdapter`. As a workaround, you can explicitly
+            annotate your variable:
+
+            ```py
+            from typing import Union
+
+            from pydantic import TypeAdapter
+
+            ta: TypeAdapter[Union[str, int]] = TypeAdapter(Union[str, int])  # type: ignore[arg-type]
+            ```
+
+        Returns:
+            A type adapter configured for the specified `type`.
+        """
+        type_is_annotated: bool = _typing_extra.is_annotated(type)
+        annotated_type: Any = get_args(type)[0] if type_is_annotated else None
+        type_has_config: bool = _type_has_config(annotated_type if type_is_annotated else type)
+
+        if type_has_config and config is not None:
+            raise PydanticUserError(
+                'Cannot use `config` when the type is a BaseModel, dataclass or TypedDict.'
+                ' These types can have their own config and setting the config via the `config`'
+                ' parameter to TypeAdapter will not override it, thus the `config` you passed to'
+                ' TypeAdapter becomes meaningless, which is probably not what you want.',
+                code='type-adapter-config-unused',
+            )
+
+        config_wrapper = _config.ConfigWrapper(config)
+
+        core_schema: CoreSchema
+        try:
+            core_schema = _getattr_no_parents(type, '__pydantic_core_schema__')
+        except AttributeError:
+            core_schema = _get_schema(type, config_wrapper, parent_depth=_parent_depth + 1)
+
+        core_config = config_wrapper.core_config(None)
+        validator: SchemaValidator
+        try:
+            validator = _getattr_no_parents(type, '__pydantic_validator__')
+        except AttributeError:
+            if module is None:
+                f = sys._getframe(1)
+                module = cast(str, f.f_globals.get('__name__', ''))
+            validator = create_schema_validator(
+                core_schema, type, module, str(type), 'TypeAdapter', core_config, config_wrapper.plugin_settings
+            )  # type: ignore
+
+        serializer: SchemaSerializer
+        try:
+            serializer = _getattr_no_parents(type, '__pydantic_serializer__')
+        except AttributeError:
+            serializer = SchemaSerializer(core_schema, core_config)
+
+        self.core_schema = core_schema
+        self.validator = validator
+        self.serializer = serializer
+
+    def validate_python(
+        self,
+        __object: Any,
+        *,
+        strict: bool | None = None,
+        from_attributes: bool | None = None,
+        context: dict[str, Any] | None = None,
+    ) -> T:
+        """Validate a Python object against the model.
+
+        Args:
+            __object: The Python object to validate against the model.
+            strict: Whether to strictly check types.
+            from_attributes: Whether to extract data from object attributes.
+            context: Additional context to pass to the validator.
+
+        !!! note
+            When using `TypeAdapter` with a Pydantic `dataclass`, the use of the `from_attributes`
+            argument is not supported.
+
+        Returns:
+            The validated object.
+        """
+        return self.validator.validate_python(__object, strict=strict, from_attributes=from_attributes, context=context)
+
+    def validate_json(
+        self, __data: str | bytes, *, strict: bool | None = None, context: dict[str, Any] | None = None
+    ) -> T:
+        """Usage docs: https://docs.pydantic.dev/2.6/concepts/json/#json-parsing
+
+        Validate a JSON string or bytes against the model.
+
+        Args:
+            __data: The JSON data to validate against the model.
+            strict: Whether to strictly check types.
+            context: Additional context to use during validation.
+
+        Returns:
+            The validated object.
+        """
+        return self.validator.validate_json(__data, strict=strict, context=context)
+
+    def validate_strings(self, __obj: Any, *, strict: bool | None = None, context: dict[str, Any] | None = None) -> T:
+        """Validate object contains string data against the model.
+
+        Args:
+            __obj: The object contains string data to validate.
+            strict: Whether to strictly check types.
+            context: Additional context to use during validation.
+
+        Returns:
+            The validated object.
+        """
+        return self.validator.validate_strings(__obj, strict=strict, context=context)
+
+    def get_default_value(self, *, strict: bool | None = None, context: dict[str, Any] | None = None) -> Some[T] | None:
+        """Get the default value for the wrapped type.
+
+        Args:
+            strict: Whether to strictly check types.
+            context: Additional context to pass to the validator.
+
+        Returns:
+            The default value wrapped in a `Some` if there is one or None if not.
+        """
+        return self.validator.get_default_value(strict=strict, context=context)
+
+    def dump_python(
+        self,
+        __instance: T,
+        *,
+        mode: Literal['json', 'python'] = 'python',
+        include: IncEx | None = None,
+        exclude: IncEx | None = None,
+        by_alias: bool = False,
+        exclude_unset: bool = False,
+        exclude_defaults: bool = False,
+        exclude_none: bool = False,
+        round_trip: bool = False,
+        warnings: bool = True,
+    ) -> Any:
+        """Dump an instance of the adapted type to a Python object.
+
+        Args:
+            __instance: The Python object to serialize.
+            mode: The output format.
+            include: Fields to include in the output.
+            exclude: Fields to exclude from the output.
+            by_alias: Whether to use alias names for field names.
+            exclude_unset: Whether to exclude unset fields.
+            exclude_defaults: Whether to exclude fields with default values.
+            exclude_none: Whether to exclude fields with None values.
+            round_trip: Whether to output the serialized data in a way that is compatible with deserialization.
+            warnings: Whether to display serialization warnings.
+
+        Returns:
+            The serialized object.
+        """
+        return self.serializer.to_python(
+            __instance,
+            mode=mode,
+            by_alias=by_alias,
+            include=include,
+            exclude=exclude,
+            exclude_unset=exclude_unset,
+            exclude_defaults=exclude_defaults,
+            exclude_none=exclude_none,
+            round_trip=round_trip,
+            warnings=warnings,
+        )
+
+    def dump_json(
+        self,
+        __instance: T,
+        *,
+        indent: int | None = None,
+        include: IncEx | None = None,
+        exclude: IncEx | None = None,
+        by_alias: bool = False,
+        exclude_unset: bool = False,
+        exclude_defaults: bool = False,
+        exclude_none: bool = False,
+        round_trip: bool = False,
+        warnings: bool = True,
+    ) -> bytes:
+        """Usage docs: https://docs.pydantic.dev/2.6/concepts/json/#json-serialization
+
+        Serialize an instance of the adapted type to JSON.
+
+        Args:
+            __instance: The instance to be serialized.
+            indent: Number of spaces for JSON indentation.
+            include: Fields to include.
+            exclude: Fields to exclude.
+            by_alias: Whether to use alias names for field names.
+            exclude_unset: Whether to exclude unset fields.
+            exclude_defaults: Whether to exclude fields with default values.
+            exclude_none: Whether to exclude fields with a value of `None`.
+            round_trip: Whether to serialize and deserialize the instance to ensure round-tripping.
+            warnings: Whether to emit serialization warnings.
+
+        Returns:
+            The JSON representation of the given instance as bytes.
+        """
+        return self.serializer.to_json(
+            __instance,
+            indent=indent,
+            include=include,
+            exclude=exclude,
+            by_alias=by_alias,
+            exclude_unset=exclude_unset,
+            exclude_defaults=exclude_defaults,
+            exclude_none=exclude_none,
+            round_trip=round_trip,
+            warnings=warnings,
+        )
+
+    def json_schema(
+        self,
+        *,
+        by_alias: bool = True,
+        ref_template: str = DEFAULT_REF_TEMPLATE,
+        schema_generator: type[GenerateJsonSchema] = GenerateJsonSchema,
+        mode: JsonSchemaMode = 'validation',
+    ) -> dict[str, Any]:
+        """Generate a JSON schema for the adapted type.
+
+        Args:
+            by_alias: Whether to use alias names for field names.
+            ref_template: The format string used for generating $ref strings.
+            schema_generator: The generator class used for creating the schema.
+            mode: The mode to use for schema generation.
+
+        Returns:
+            The JSON schema for the model as a dictionary.
+        """
+        schema_generator_instance = schema_generator(by_alias=by_alias, ref_template=ref_template)
+        return schema_generator_instance.generate(self.core_schema, mode=mode)
+
+    @staticmethod
+    def json_schemas(
+        __inputs: Iterable[tuple[JsonSchemaKeyT, JsonSchemaMode, TypeAdapter[Any]]],
+        *,
+        by_alias: bool = True,
+        title: str | None = None,
+        description: str | None = None,
+        ref_template: str = DEFAULT_REF_TEMPLATE,
+        schema_generator: type[GenerateJsonSchema] = GenerateJsonSchema,
+    ) -> tuple[dict[tuple[JsonSchemaKeyT, JsonSchemaMode], JsonSchemaValue], JsonSchemaValue]:
+        """Generate a JSON schema including definitions from multiple type adapters.
+
+        Args:
+            __inputs: Inputs to schema generation. The first two items will form the keys of the (first)
+                output mapping; the type adapters will provide the core schemas that get converted into
+                definitions in the output JSON schema.
+            by_alias: Whether to use alias names.
+            title: The title for the schema.
+            description: The description for the schema.
+            ref_template: The format string used for generating $ref strings.
+            schema_generator: The generator class used for creating the schema.
+
+        Returns:
+            A tuple where:
+
+                - The first element is a dictionary whose keys are tuples of JSON schema key type and JSON mode, and
+                    whose values are the JSON schema corresponding to that pair of inputs. (These schemas may have
+                    JsonRef references to definitions that are defined in the second returned element.)
+                - The second element is a JSON schema containing all definitions referenced in the first returned
+                    element, along with the optional title and description keys.
+
+        """
+        schema_generator_instance = schema_generator(by_alias=by_alias, ref_template=ref_template)
+
+        inputs = [(key, mode, adapter.core_schema) for key, mode, adapter in __inputs]
+
+        json_schemas_map, definitions = schema_generator_instance.generate_definitions(inputs)
+
+        json_schema: dict[str, Any] = {}
+        if definitions:
+            json_schema['$defs'] = definitions
+        if title:
+            json_schema['title'] = title
+        if description:
+            json_schema['description'] = description
+
+        return json_schemas_map, json_schema
diff --git a/lib/pydantic/types.py b/lib/pydantic/types.py
index f98dba3d..c2534c88 100644
--- a/lib/pydantic/types.py
+++ b/lib/pydantic/types.py
@@ -1,12 +1,14 @@
-import abc
-import math
+"""The types module contains custom types used by pydantic."""
+from __future__ import annotations as _annotations
+
+import base64
+import dataclasses as _dataclasses
 import re
-import warnings
-from datetime import date
+from datetime import date, datetime
 from decimal import Decimal
 from enum import Enum
 from pathlib import Path
-from types import new_class
+from types import ModuleType
 from typing import (
     TYPE_CHECKING,
     Any,
@@ -14,78 +16,56 @@ from typing import (
     ClassVar,
     Dict,
     FrozenSet,
+    Generic,
+    Hashable,
+    Iterator,
     List,
-    Optional,
-    Pattern,
     Set,
-    Tuple,
-    Type,
     TypeVar,
     Union,
     cast,
-    overload,
 )
 from uuid import UUID
-from weakref import WeakSet
 
-from . import errors
-from .datetime_parse import parse_date
-from .utils import import_string, update_not_none
-from .validators import (
-    bytes_validator,
-    constr_length_validator,
-    constr_lower,
-    constr_strip_whitespace,
-    constr_upper,
-    decimal_validator,
-    float_finite_validator,
-    float_validator,
-    frozenset_validator,
-    int_validator,
-    list_validator,
-    number_multiple_validator,
-    number_size_validator,
-    path_exists_validator,
-    path_validator,
-    set_validator,
-    str_validator,
-    strict_bytes_validator,
-    strict_float_validator,
-    strict_int_validator,
-    strict_str_validator,
+import annotated_types
+from annotated_types import BaseMetadata, MaxLen, MinLen
+from pydantic_core import CoreSchema, PydanticCustomError, core_schema
+from typing_extensions import Annotated, Literal, Protocol, TypeAlias, TypeAliasType, deprecated
+
+from ._internal import (
+    _core_utils,
+    _fields,
+    _internal_dataclass,
+    _typing_extra,
+    _utils,
+    _validators,
 )
+from ._migration import getattr_migration
+from .annotated_handlers import GetCoreSchemaHandler, GetJsonSchemaHandler
+from .errors import PydanticUserError
+from .json_schema import JsonSchemaValue
+from .warnings import PydanticDeprecatedSince20
 
-__all__ = [
-    'NoneStr',
-    'NoneBytes',
-    'StrBytes',
-    'NoneStrBytes',
+__all__ = (
+    'Strict',
     'StrictStr',
-    'ConstrainedBytes',
     'conbytes',
-    'ConstrainedList',
     'conlist',
-    'ConstrainedSet',
     'conset',
-    'ConstrainedFrozenSet',
     'confrozenset',
-    'ConstrainedStr',
     'constr',
-    'PyObject',
-    'ConstrainedInt',
+    'ImportString',
     'conint',
     'PositiveInt',
     'NegativeInt',
     'NonNegativeInt',
     'NonPositiveInt',
-    'ConstrainedFloat',
     'confloat',
     'PositiveFloat',
     'NegativeFloat',
     'NonNegativeFloat',
     'NonPositiveFloat',
     'FiniteFloat',
-    'ConstrainedDecimal',
     'condecimal',
     'UUID1',
     'UUID3',
@@ -93,9 +73,8 @@ __all__ = [
     'UUID5',
     'FilePath',
     'DirectoryPath',
+    'NewPath',
     'Json',
-    'JsonWrapper',
-    'SecretField',
     'SecretStr',
     'SecretBytes',
     'StrictBool',
@@ -106,845 +85,1512 @@ __all__ = [
     'ByteSize',
     'PastDate',
     'FutureDate',
-    'ConstrainedDate',
+    'PastDatetime',
+    'FutureDatetime',
     'condate',
-]
+    'AwareDatetime',
+    'NaiveDatetime',
+    'AllowInfNan',
+    'EncoderProtocol',
+    'EncodedBytes',
+    'EncodedStr',
+    'Base64Encoder',
+    'Base64Bytes',
+    'Base64Str',
+    'Base64UrlBytes',
+    'Base64UrlStr',
+    'GetPydanticSchema',
+    'StringConstraints',
+    'Tag',
+    'Discriminator',
+    'JsonValue',
+    'OnErrorOmit',
+)
 
-NoneStr = Optional[str]
-NoneBytes = Optional[bytes]
-StrBytes = Union[str, bytes]
-NoneStrBytes = Optional[StrBytes]
-OptionalInt = Optional[int]
-OptionalIntFloat = Union[OptionalInt, float]
-OptionalIntFloatDecimal = Union[OptionalIntFloat, Decimal]
-OptionalDate = Optional[date]
-StrIntFloat = Union[str, int, float]
-
-if TYPE_CHECKING:
-    from typing_extensions import Annotated
-
-    from .dataclasses import Dataclass
-    from .main import BaseModel
-    from .typing import CallableGenerator
-
-    ModelOrDc = Type[Union[BaseModel, Dataclass]]
 
 T = TypeVar('T')
-_DEFINED_TYPES: 'WeakSet[type]' = WeakSet()
 
 
-@overload
-def _registered(typ: Type[T]) -> Type[T]:
-    pass
+@_dataclasses.dataclass
+class Strict(_fields.PydanticMetadata, BaseMetadata):
+    """Usage docs: https://docs.pydantic.dev/2.6/concepts/strict_mode/#strict-mode-with-annotated-strict
 
+    A field metadata class to indicate that a field should be validated in strict mode.
 
-@overload
-def _registered(typ: 'ConstrainedNumberMeta') -> 'ConstrainedNumberMeta':
-    pass
+    Attributes:
+        strict: Whether to validate the field in strict mode.
 
+    Example:
+        ```python
+        from typing_extensions import Annotated
 
-def _registered(typ: Union[Type[T], 'ConstrainedNumberMeta']) -> Union[Type[T], 'ConstrainedNumberMeta']:
-    # In order to generate valid examples of constrained types, Hypothesis needs
-    # to inspect the type object - so we keep a weakref to each contype object
-    # until it can be registered.  When (or if) our Hypothesis plugin is loaded,
-    # it monkeypatches this function.
-    # If Hypothesis is never used, the total effect is to keep a weak reference
-    # which has minimal memory usage and doesn't even affect garbage collection.
-    _DEFINED_TYPES.add(typ)
-    return typ
+        from pydantic.types import Strict
 
+        StrictBool = Annotated[bool, Strict()]
+        ```
+    """
 
-class ConstrainedNumberMeta(type):
-    def __new__(cls, name: str, bases: Any, dct: Dict[str, Any]) -> 'ConstrainedInt':  # type: ignore
-        new_cls = cast('ConstrainedInt', type.__new__(cls, name, bases, dct))
+    strict: bool = True
 
-        if new_cls.gt is not None and new_cls.ge is not None:
-            raise errors.ConfigError('bounds gt and ge cannot be specified at the same time')
-        if new_cls.lt is not None and new_cls.le is not None:
-            raise errors.ConfigError('bounds lt and le cannot be specified at the same time')
-
-        return _registered(new_cls)  # type: ignore
+    def __hash__(self) -> int:
+        return hash(self.strict)
 
 
 # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ BOOLEAN TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-if TYPE_CHECKING:
-    StrictBool = bool
-else:
-
-    class StrictBool(int):
-        """
-        StrictBool to allow for bools which are not type-coerced.
-        """
-
-        @classmethod
-        def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-            field_schema.update(type='boolean')
-
-        @classmethod
-        def __get_validators__(cls) -> 'CallableGenerator':
-            yield cls.validate
-
-        @classmethod
-        def validate(cls, value: Any) -> bool:
-            """
-            Ensure that we only allow bools.
-            """
-            if isinstance(value, bool):
-                return value
-
-            raise errors.StrictBoolError()
-
+StrictBool = Annotated[bool, Strict()]
+"""A boolean that must be either ``True`` or ``False``."""
 
 # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ INTEGER TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 
-class ConstrainedInt(int, metaclass=ConstrainedNumberMeta):
-    strict: bool = False
-    gt: OptionalInt = None
-    ge: OptionalInt = None
-    lt: OptionalInt = None
-    le: OptionalInt = None
-    multiple_of: OptionalInt = None
-
-    @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-        update_not_none(
-            field_schema,
-            exclusiveMinimum=cls.gt,
-            exclusiveMaximum=cls.lt,
-            minimum=cls.ge,
-            maximum=cls.le,
-            multipleOf=cls.multiple_of,
-        )
-
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield strict_int_validator if cls.strict else int_validator
-        yield number_size_validator
-        yield number_multiple_validator
-
-
 def conint(
-    *, strict: bool = False, gt: int = None, ge: int = None, lt: int = None, le: int = None, multiple_of: int = None
-) -> Type[int]:
-    # use kwargs then define conf in a dict to aid with IDE type hinting
-    namespace = dict(strict=strict, gt=gt, ge=ge, lt=lt, le=le, multiple_of=multiple_of)
-    return type('ConstrainedIntValue', (ConstrainedInt,), namespace)
+    *,
+    strict: bool | None = None,
+    gt: int | None = None,
+    ge: int | None = None,
+    lt: int | None = None,
+    le: int | None = None,
+    multiple_of: int | None = None,
+) -> type[int]:
+    """
+    !!! warning "Discouraged"
+        This function is **discouraged** in favor of using
+        [`Annotated`](https://docs.python.org/3/library/typing.html#typing.Annotated) with
+        [`Field`][pydantic.fields.Field] instead.
+
+        This function will be **deprecated** in Pydantic 3.0.
+
+        The reason is that `conint` returns a type, which doesn't play well with static analysis tools.
+
+        === ":x: Don't do this"
+            ```py
+            from pydantic import BaseModel, conint
+
+            class Foo(BaseModel):
+                bar: conint(strict=True, gt=0)
+            ```
+
+        === ":white_check_mark: Do this"
+            ```py
+            from typing_extensions import Annotated
+
+            from pydantic import BaseModel, Field
+
+            class Foo(BaseModel):
+                bar: Annotated[int, Field(strict=True, gt=0)]
+            ```
+
+    A wrapper around `int` that allows for additional constraints.
+
+    Args:
+        strict: Whether to validate the integer in strict mode. Defaults to `None`.
+        gt: The value must be greater than this.
+        ge: The value must be greater than or equal to this.
+        lt: The value must be less than this.
+        le: The value must be less than or equal to this.
+        multiple_of: The value must be a multiple of this.
+
+    Returns:
+        The wrapped integer type.
+
+    ```py
+    from pydantic import BaseModel, ValidationError, conint
+
+    class ConstrainedExample(BaseModel):
+        constrained_int: conint(gt=1)
+
+    m = ConstrainedExample(constrained_int=2)
+    print(repr(m))
+    #> ConstrainedExample(constrained_int=2)
+
+    try:
+        ConstrainedExample(constrained_int=0)
+    except ValidationError as e:
+        print(e.errors())
+        '''
+        [
+            {
+                'type': 'greater_than',
+                'loc': ('constrained_int',),
+                'msg': 'Input should be greater than 1',
+                'input': 0,
+                'ctx': {'gt': 1},
+                'url': 'https://errors.pydantic.dev/2/v/greater_than',
+            }
+        ]
+        '''
+    ```
+
+    """  # noqa: D212
+    return Annotated[
+        int,
+        Strict(strict) if strict is not None else None,
+        annotated_types.Interval(gt=gt, ge=ge, lt=lt, le=le),
+        annotated_types.MultipleOf(multiple_of) if multiple_of is not None else None,
+    ]
 
 
-if TYPE_CHECKING:
-    PositiveInt = int
-    NegativeInt = int
-    NonPositiveInt = int
-    NonNegativeInt = int
-    StrictInt = int
-else:
+PositiveInt = Annotated[int, annotated_types.Gt(0)]
+"""An integer that must be greater than zero.
 
-    class PositiveInt(ConstrainedInt):
-        gt = 0
+```py
+from pydantic import BaseModel, PositiveInt, ValidationError
 
-    class NegativeInt(ConstrainedInt):
-        lt = 0
+class Model(BaseModel):
+    positive_int: PositiveInt
 
-    class NonPositiveInt(ConstrainedInt):
-        le = 0
+m = Model(positive_int=1)
+print(repr(m))
+#> Model(positive_int=1)
 
-    class NonNegativeInt(ConstrainedInt):
-        ge = 0
+try:
+    Model(positive_int=-1)
+except ValidationError as e:
+    print(e.errors())
+    '''
+    [
+        {
+            'type': 'greater_than',
+            'loc': ('positive_int',),
+            'msg': 'Input should be greater than 0',
+            'input': -1,
+            'ctx': {'gt': 0},
+            'url': 'https://errors.pydantic.dev/2/v/greater_than',
+        }
+    ]
+    '''
+```
+"""
+NegativeInt = Annotated[int, annotated_types.Lt(0)]
+"""An integer that must be less than zero.
 
-    class StrictInt(ConstrainedInt):
-        strict = True
+```py
+from pydantic import BaseModel, NegativeInt, ValidationError
 
+class Model(BaseModel):
+    negative_int: NegativeInt
+
+m = Model(negative_int=-1)
+print(repr(m))
+#> Model(negative_int=-1)
+
+try:
+    Model(negative_int=1)
+except ValidationError as e:
+    print(e.errors())
+    '''
+    [
+        {
+            'type': 'less_than',
+            'loc': ('negative_int',),
+            'msg': 'Input should be less than 0',
+            'input': 1,
+            'ctx': {'lt': 0},
+            'url': 'https://errors.pydantic.dev/2/v/less_than',
+        }
+    ]
+    '''
+```
+"""
+NonPositiveInt = Annotated[int, annotated_types.Le(0)]
+"""An integer that must be less than or equal to zero.
+
+```py
+from pydantic import BaseModel, NonPositiveInt, ValidationError
+
+class Model(BaseModel):
+    non_positive_int: NonPositiveInt
+
+m = Model(non_positive_int=0)
+print(repr(m))
+#> Model(non_positive_int=0)
+
+try:
+    Model(non_positive_int=1)
+except ValidationError as e:
+    print(e.errors())
+    '''
+    [
+        {
+            'type': 'less_than_equal',
+            'loc': ('non_positive_int',),
+            'msg': 'Input should be less than or equal to 0',
+            'input': 1,
+            'ctx': {'le': 0},
+            'url': 'https://errors.pydantic.dev/2/v/less_than_equal',
+        }
+    ]
+    '''
+```
+"""
+NonNegativeInt = Annotated[int, annotated_types.Ge(0)]
+"""An integer that must be greater than or equal to zero.
+
+```py
+from pydantic import BaseModel, NonNegativeInt, ValidationError
+
+class Model(BaseModel):
+    non_negative_int: NonNegativeInt
+
+m = Model(non_negative_int=0)
+print(repr(m))
+#> Model(non_negative_int=0)
+
+try:
+    Model(non_negative_int=-1)
+except ValidationError as e:
+    print(e.errors())
+    '''
+    [
+        {
+            'type': 'greater_than_equal',
+            'loc': ('non_negative_int',),
+            'msg': 'Input should be greater than or equal to 0',
+            'input': -1,
+            'ctx': {'ge': 0},
+            'url': 'https://errors.pydantic.dev/2/v/greater_than_equal',
+        }
+    ]
+    '''
+```
+"""
+StrictInt = Annotated[int, Strict()]
+"""An integer that must be validated in strict mode.
+
+```py
+from pydantic import BaseModel, StrictInt, ValidationError
+
+class StrictIntModel(BaseModel):
+    strict_int: StrictInt
+
+try:
+    StrictIntModel(strict_int=3.14159)
+except ValidationError as e:
+    print(e)
+    '''
+    1 validation error for StrictIntModel
+    strict_int
+      Input should be a valid integer [type=int_type, input_value=3.14159, input_type=float]
+    '''
+```
+"""
 
 # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ FLOAT TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 
-class ConstrainedFloat(float, metaclass=ConstrainedNumberMeta):
-    strict: bool = False
-    gt: OptionalIntFloat = None
-    ge: OptionalIntFloat = None
-    lt: OptionalIntFloat = None
-    le: OptionalIntFloat = None
-    multiple_of: OptionalIntFloat = None
-    allow_inf_nan: Optional[bool] = None
+@_dataclasses.dataclass
+class AllowInfNan(_fields.PydanticMetadata):
+    """A field metadata class to indicate that a field should allow ``-inf``, ``inf``, and ``nan``."""
 
-    @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-        update_not_none(
-            field_schema,
-            exclusiveMinimum=cls.gt,
-            exclusiveMaximum=cls.lt,
-            minimum=cls.ge,
-            maximum=cls.le,
-            multipleOf=cls.multiple_of,
-        )
-        # Modify constraints to account for differences between IEEE floats and JSON
-        if field_schema.get('exclusiveMinimum') == -math.inf:
-            del field_schema['exclusiveMinimum']
-        if field_schema.get('minimum') == -math.inf:
-            del field_schema['minimum']
-        if field_schema.get('exclusiveMaximum') == math.inf:
-            del field_schema['exclusiveMaximum']
-        if field_schema.get('maximum') == math.inf:
-            del field_schema['maximum']
+    allow_inf_nan: bool = True
 
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield strict_float_validator if cls.strict else float_validator
-        yield number_size_validator
-        yield number_multiple_validator
-        yield float_finite_validator
+    def __hash__(self) -> int:
+        return hash(self.allow_inf_nan)
 
 
 def confloat(
     *,
-    strict: bool = False,
-    gt: float = None,
-    ge: float = None,
-    lt: float = None,
-    le: float = None,
-    multiple_of: float = None,
-    allow_inf_nan: Optional[bool] = None,
-) -> Type[float]:
-    # use kwargs then define conf in a dict to aid with IDE type hinting
-    namespace = dict(strict=strict, gt=gt, ge=ge, lt=lt, le=le, multiple_of=multiple_of, allow_inf_nan=allow_inf_nan)
-    return type('ConstrainedFloatValue', (ConstrainedFloat,), namespace)
+    strict: bool | None = None,
+    gt: float | None = None,
+    ge: float | None = None,
+    lt: float | None = None,
+    le: float | None = None,
+    multiple_of: float | None = None,
+    allow_inf_nan: bool | None = None,
+) -> type[float]:
+    """
+    !!! warning "Discouraged"
+        This function is **discouraged** in favor of using
+        [`Annotated`](https://docs.python.org/3/library/typing.html#typing.Annotated) with
+        [`Field`][pydantic.fields.Field] instead.
+
+        This function will be **deprecated** in Pydantic 3.0.
+
+        The reason is that `confloat` returns a type, which doesn't play well with static analysis tools.
+
+        === ":x: Don't do this"
+            ```py
+            from pydantic import BaseModel, confloat
+
+            class Foo(BaseModel):
+                bar: confloat(strict=True, gt=0)
+            ```
+
+        === ":white_check_mark: Do this"
+            ```py
+            from typing_extensions import Annotated
+
+            from pydantic import BaseModel, Field
+
+            class Foo(BaseModel):
+                bar: Annotated[float, Field(strict=True, gt=0)]
+            ```
+
+    A wrapper around `float` that allows for additional constraints.
+
+    Args:
+        strict: Whether to validate the float in strict mode.
+        gt: The value must be greater than this.
+        ge: The value must be greater than or equal to this.
+        lt: The value must be less than this.
+        le: The value must be less than or equal to this.
+        multiple_of: The value must be a multiple of this.
+        allow_inf_nan: Whether to allow `-inf`, `inf`, and `nan`.
+
+    Returns:
+        The wrapped float type.
+
+    ```py
+    from pydantic import BaseModel, ValidationError, confloat
+
+    class ConstrainedExample(BaseModel):
+        constrained_float: confloat(gt=1.0)
+
+    m = ConstrainedExample(constrained_float=1.1)
+    print(repr(m))
+    #> ConstrainedExample(constrained_float=1.1)
+
+    try:
+        ConstrainedExample(constrained_float=0.9)
+    except ValidationError as e:
+        print(e.errors())
+        '''
+        [
+            {
+                'type': 'greater_than',
+                'loc': ('constrained_float',),
+                'msg': 'Input should be greater than 1',
+                'input': 0.9,
+                'ctx': {'gt': 1.0},
+                'url': 'https://errors.pydantic.dev/2/v/greater_than',
+            }
+        ]
+        '''
+    ```
+    """  # noqa: D212
+    return Annotated[
+        float,
+        Strict(strict) if strict is not None else None,
+        annotated_types.Interval(gt=gt, ge=ge, lt=lt, le=le),
+        annotated_types.MultipleOf(multiple_of) if multiple_of is not None else None,
+        AllowInfNan(allow_inf_nan) if allow_inf_nan is not None else None,
+    ]
 
 
-if TYPE_CHECKING:
-    PositiveFloat = float
-    NegativeFloat = float
-    NonPositiveFloat = float
-    NonNegativeFloat = float
-    StrictFloat = float
-    FiniteFloat = float
-else:
+PositiveFloat = Annotated[float, annotated_types.Gt(0)]
+"""A float that must be greater than zero.
 
-    class PositiveFloat(ConstrainedFloat):
-        gt = 0
+```py
+from pydantic import BaseModel, PositiveFloat, ValidationError
 
-    class NegativeFloat(ConstrainedFloat):
-        lt = 0
+class Model(BaseModel):
+    positive_float: PositiveFloat
 
-    class NonPositiveFloat(ConstrainedFloat):
-        le = 0
+m = Model(positive_float=1.0)
+print(repr(m))
+#> Model(positive_float=1.0)
 
-    class NonNegativeFloat(ConstrainedFloat):
-        ge = 0
+try:
+    Model(positive_float=-1.0)
+except ValidationError as e:
+    print(e.errors())
+    '''
+    [
+        {
+            'type': 'greater_than',
+            'loc': ('positive_float',),
+            'msg': 'Input should be greater than 0',
+            'input': -1.0,
+            'ctx': {'gt': 0.0},
+            'url': 'https://errors.pydantic.dev/2/v/greater_than',
+        }
+    ]
+    '''
+```
+"""
+NegativeFloat = Annotated[float, annotated_types.Lt(0)]
+"""A float that must be less than zero.
 
-    class StrictFloat(ConstrainedFloat):
-        strict = True
+```py
+from pydantic import BaseModel, NegativeFloat, ValidationError
 
-    class FiniteFloat(ConstrainedFloat):
-        allow_inf_nan = False
+class Model(BaseModel):
+    negative_float: NegativeFloat
+
+m = Model(negative_float=-1.0)
+print(repr(m))
+#> Model(negative_float=-1.0)
+
+try:
+    Model(negative_float=1.0)
+except ValidationError as e:
+    print(e.errors())
+    '''
+    [
+        {
+            'type': 'less_than',
+            'loc': ('negative_float',),
+            'msg': 'Input should be less than 0',
+            'input': 1.0,
+            'ctx': {'lt': 0.0},
+            'url': 'https://errors.pydantic.dev/2/v/less_than',
+        }
+    ]
+    '''
+```
+"""
+NonPositiveFloat = Annotated[float, annotated_types.Le(0)]
+"""A float that must be less than or equal to zero.
+
+```py
+from pydantic import BaseModel, NonPositiveFloat, ValidationError
+
+class Model(BaseModel):
+    non_positive_float: NonPositiveFloat
+
+m = Model(non_positive_float=0.0)
+print(repr(m))
+#> Model(non_positive_float=0.0)
+
+try:
+    Model(non_positive_float=1.0)
+except ValidationError as e:
+    print(e.errors())
+    '''
+    [
+        {
+            'type': 'less_than_equal',
+            'loc': ('non_positive_float',),
+            'msg': 'Input should be less than or equal to 0',
+            'input': 1.0,
+            'ctx': {'le': 0.0},
+            'url': 'https://errors.pydantic.dev/2/v/less_than_equal',
+        }
+    ]
+    '''
+```
+"""
+NonNegativeFloat = Annotated[float, annotated_types.Ge(0)]
+"""A float that must be greater than or equal to zero.
+
+```py
+from pydantic import BaseModel, NonNegativeFloat, ValidationError
+
+class Model(BaseModel):
+    non_negative_float: NonNegativeFloat
+
+m = Model(non_negative_float=0.0)
+print(repr(m))
+#> Model(non_negative_float=0.0)
+
+try:
+    Model(non_negative_float=-1.0)
+except ValidationError as e:
+    print(e.errors())
+    '''
+    [
+        {
+            'type': 'greater_than_equal',
+            'loc': ('non_negative_float',),
+            'msg': 'Input should be greater than or equal to 0',
+            'input': -1.0,
+            'ctx': {'ge': 0.0},
+            'url': 'https://errors.pydantic.dev/2/v/greater_than_equal',
+        }
+    ]
+    '''
+```
+"""
+StrictFloat = Annotated[float, Strict(True)]
+"""A float that must be validated in strict mode.
+
+```py
+from pydantic import BaseModel, StrictFloat, ValidationError
+
+class StrictFloatModel(BaseModel):
+    strict_float: StrictFloat
+
+try:
+    StrictFloatModel(strict_float='1.0')
+except ValidationError as e:
+    print(e)
+    '''
+    1 validation error for StrictFloatModel
+    strict_float
+      Input should be a valid number [type=float_type, input_value='1.0', input_type=str]
+    '''
+```
+"""
+FiniteFloat = Annotated[float, AllowInfNan(False)]
+"""A float that must be finite (not ``-inf``, ``inf``, or ``nan``).
+
+```py
+from pydantic import BaseModel, FiniteFloat
+
+class Model(BaseModel):
+    finite: FiniteFloat
+
+m = Model(finite=1.0)
+print(m)
+#> finite=1.0
+```
+"""
 
 
 # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ BYTES TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 
-class ConstrainedBytes(bytes):
-    strip_whitespace = False
-    to_upper = False
-    to_lower = False
-    min_length: OptionalInt = None
-    max_length: OptionalInt = None
-    strict: bool = False
-
-    @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-        update_not_none(field_schema, minLength=cls.min_length, maxLength=cls.max_length)
-
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield strict_bytes_validator if cls.strict else bytes_validator
-        yield constr_strip_whitespace
-        yield constr_upper
-        yield constr_lower
-        yield constr_length_validator
-
-
 def conbytes(
     *,
-    strip_whitespace: bool = False,
-    to_upper: bool = False,
-    to_lower: bool = False,
-    min_length: int = None,
-    max_length: int = None,
-    strict: bool = False,
-) -> Type[bytes]:
-    # use kwargs then define conf in a dict to aid with IDE type hinting
-    namespace = dict(
-        strip_whitespace=strip_whitespace,
-        to_upper=to_upper,
-        to_lower=to_lower,
-        min_length=min_length,
-        max_length=max_length,
-        strict=strict,
-    )
-    return _registered(type('ConstrainedBytesValue', (ConstrainedBytes,), namespace))
+    min_length: int | None = None,
+    max_length: int | None = None,
+    strict: bool | None = None,
+) -> type[bytes]:
+    """A wrapper around `bytes` that allows for additional constraints.
+
+    Args:
+        min_length: The minimum length of the bytes.
+        max_length: The maximum length of the bytes.
+        strict: Whether to validate the bytes in strict mode.
+
+    Returns:
+        The wrapped bytes type.
+    """
+    return Annotated[
+        bytes,
+        Strict(strict) if strict is not None else None,
+        annotated_types.Len(min_length or 0, max_length),
+    ]
 
 
-if TYPE_CHECKING:
-    StrictBytes = bytes
-else:
-
-    class StrictBytes(ConstrainedBytes):
-        strict = True
+StrictBytes = Annotated[bytes, Strict()]
+"""A bytes that must be validated in strict mode."""
 
 
 # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ STRING TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 
-class ConstrainedStr(str):
-    strip_whitespace = False
-    to_upper = False
-    to_lower = False
-    min_length: OptionalInt = None
-    max_length: OptionalInt = None
-    curtail_length: OptionalInt = None
-    regex: Optional[Pattern[str]] = None
-    strict = False
+@_dataclasses.dataclass(frozen=True)
+class StringConstraints(annotated_types.GroupedMetadata):
+    """Usage docs: https://docs.pydantic.dev/2.6/concepts/fields/#string-constraints
 
-    @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-        update_not_none(
-            field_schema,
-            minLength=cls.min_length,
-            maxLength=cls.max_length,
-            pattern=cls.regex and cls.regex.pattern,
-        )
+    Apply constraints to `str` types.
 
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield strict_str_validator if cls.strict else str_validator
-        yield constr_strip_whitespace
-        yield constr_upper
-        yield constr_lower
-        yield constr_length_validator
-        yield cls.validate
+    Attributes:
+        strip_whitespace: Whether to strip whitespace from the string.
+        to_upper: Whether to convert the string to uppercase.
+        to_lower: Whether to convert the string to lowercase.
+        strict: Whether to validate the string in strict mode.
+        min_length: The minimum length of the string.
+        max_length: The maximum length of the string.
+        pattern: A regex pattern that the string must match.
+    """
 
-    @classmethod
-    def validate(cls, value: Union[str]) -> Union[str]:
-        if cls.curtail_length and len(value) > cls.curtail_length:
-            value = value[: cls.curtail_length]
+    strip_whitespace: bool | None = None
+    to_upper: bool | None = None
+    to_lower: bool | None = None
+    strict: bool | None = None
+    min_length: int | None = None
+    max_length: int | None = None
+    pattern: str | None = None
 
-        if cls.regex:
-            if not cls.regex.match(value):
-                raise errors.StrRegexError(pattern=cls.regex.pattern)
-
-        return value
+    def __iter__(self) -> Iterator[BaseMetadata]:
+        if self.min_length is not None:
+            yield MinLen(self.min_length)
+        if self.max_length is not None:
+            yield MaxLen(self.max_length)
+        if self.strict is not None:
+            yield Strict()
+        if (
+            self.strip_whitespace is not None
+            or self.pattern is not None
+            or self.to_lower is not None
+            or self.to_upper is not None
+        ):
+            yield _fields.pydantic_general_metadata(
+                strip_whitespace=self.strip_whitespace,
+                to_upper=self.to_upper,
+                to_lower=self.to_lower,
+                pattern=self.pattern,
+            )
 
 
 def constr(
     *,
-    strip_whitespace: bool = False,
-    to_upper: bool = False,
-    to_lower: bool = False,
-    strict: bool = False,
-    min_length: int = None,
-    max_length: int = None,
-    curtail_length: int = None,
-    regex: str = None,
-) -> Type[str]:
-    # use kwargs then define conf in a dict to aid with IDE type hinting
-    namespace = dict(
-        strip_whitespace=strip_whitespace,
-        to_upper=to_upper,
-        to_lower=to_lower,
-        strict=strict,
-        min_length=min_length,
-        max_length=max_length,
-        curtail_length=curtail_length,
-        regex=regex and re.compile(regex),
-    )
-    return _registered(type('ConstrainedStrValue', (ConstrainedStr,), namespace))
+    strip_whitespace: bool | None = None,
+    to_upper: bool | None = None,
+    to_lower: bool | None = None,
+    strict: bool | None = None,
+    min_length: int | None = None,
+    max_length: int | None = None,
+    pattern: str | None = None,
+) -> type[str]:
+    """
+    !!! warning "Discouraged"
+        This function is **discouraged** in favor of using
+        [`Annotated`](https://docs.python.org/3/library/typing.html#typing.Annotated) with
+        [`StringConstraints`][pydantic.types.StringConstraints] instead.
+
+        This function will be **deprecated** in Pydantic 3.0.
+
+        The reason is that `constr` returns a type, which doesn't play well with static analysis tools.
+
+        === ":x: Don't do this"
+            ```py
+            from pydantic import BaseModel, constr
+
+            class Foo(BaseModel):
+                bar: constr(strip_whitespace=True, to_upper=True, pattern=r'^[A-Z]+$')
+            ```
+
+        === ":white_check_mark: Do this"
+            ```py
+            from typing_extensions import Annotated
+
+            from pydantic import BaseModel, StringConstraints
+
+            class Foo(BaseModel):
+                bar: Annotated[str, StringConstraints(strip_whitespace=True, to_upper=True, pattern=r'^[A-Z]+$')]
+            ```
+
+    A wrapper around `str` that allows for additional constraints.
+
+    ```py
+    from pydantic import BaseModel, constr
+
+    class Foo(BaseModel):
+        bar: constr(strip_whitespace=True, to_upper=True, pattern=r'^[A-Z]+$')
 
 
-if TYPE_CHECKING:
-    StrictStr = str
-else:
+    foo = Foo(bar='  hello  ')
+    print(foo)
+    #> bar='HELLO'
+    ```
 
-    class StrictStr(ConstrainedStr):
-        strict = True
+    Args:
+        strip_whitespace: Whether to remove leading and trailing whitespace.
+        to_upper: Whether to turn all characters to uppercase.
+        to_lower: Whether to turn all characters to lowercase.
+        strict: Whether to validate the string in strict mode.
+        min_length: The minimum length of the string.
+        max_length: The maximum length of the string.
+        pattern: A regex pattern to validate the string against.
+
+    Returns:
+        The wrapped string type.
+    """  # noqa: D212
+    return Annotated[
+        str,
+        StringConstraints(
+            strip_whitespace=strip_whitespace,
+            to_upper=to_upper,
+            to_lower=to_lower,
+            strict=strict,
+            min_length=min_length,
+            max_length=max_length,
+            pattern=pattern,
+        ),
+    ]
 
 
-# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ SET TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-# This types superclass should be Set[T], but cython chokes on that...
-class ConstrainedSet(set):  # type: ignore
-    # Needed for pydantic to detect that this is a set
-    __origin__ = set
-    __args__: Set[Type[T]]  # type: ignore
-
-    min_items: Optional[int] = None
-    max_items: Optional[int] = None
-    item_type: Type[T]  # type: ignore
-
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield cls.set_length_validator
-
-    @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-        update_not_none(field_schema, minItems=cls.min_items, maxItems=cls.max_items)
-
-    @classmethod
-    def set_length_validator(cls, v: 'Optional[Set[T]]') -> 'Optional[Set[T]]':
-        if v is None:
-            return None
-
-        v = set_validator(v)
-        v_len = len(v)
-
-        if cls.min_items is not None and v_len < cls.min_items:
-            raise errors.SetMinLengthError(limit_value=cls.min_items)
-
-        if cls.max_items is not None and v_len > cls.max_items:
-            raise errors.SetMaxLengthError(limit_value=cls.max_items)
-
-        return v
+StrictStr = Annotated[str, Strict()]
+"""A string that must be validated in strict mode."""
 
 
-def conset(item_type: Type[T], *, min_items: int = None, max_items: int = None) -> Type[Set[T]]:
-    # __args__ is needed to conform to typing generics api
-    namespace = {'min_items': min_items, 'max_items': max_items, 'item_type': item_type, '__args__': [item_type]}
-    # We use new_class to be able to deal with Generic types
-    return new_class('ConstrainedSetValue', (ConstrainedSet,), {}, lambda ns: ns.update(namespace))
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~ COLLECTION TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+HashableItemType = TypeVar('HashableItemType', bound=Hashable)
 
 
-# This types superclass should be FrozenSet[T], but cython chokes on that...
-class ConstrainedFrozenSet(frozenset):  # type: ignore
-    # Needed for pydantic to detect that this is a set
-    __origin__ = frozenset
-    __args__: FrozenSet[Type[T]]  # type: ignore
+def conset(
+    item_type: type[HashableItemType], *, min_length: int | None = None, max_length: int | None = None
+) -> type[set[HashableItemType]]:
+    """A wrapper around `typing.Set` that allows for additional constraints.
 
-    min_items: Optional[int] = None
-    max_items: Optional[int] = None
-    item_type: Type[T]  # type: ignore
+    Args:
+        item_type: The type of the items in the set.
+        min_length: The minimum length of the set.
+        max_length: The maximum length of the set.
 
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield cls.frozenset_length_validator
-
-    @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-        update_not_none(field_schema, minItems=cls.min_items, maxItems=cls.max_items)
-
-    @classmethod
-    def frozenset_length_validator(cls, v: 'Optional[FrozenSet[T]]') -> 'Optional[FrozenSet[T]]':
-        if v is None:
-            return None
-
-        v = frozenset_validator(v)
-        v_len = len(v)
-
-        if cls.min_items is not None and v_len < cls.min_items:
-            raise errors.FrozenSetMinLengthError(limit_value=cls.min_items)
-
-        if cls.max_items is not None and v_len > cls.max_items:
-            raise errors.FrozenSetMaxLengthError(limit_value=cls.max_items)
-
-        return v
+    Returns:
+        The wrapped set type.
+    """
+    return Annotated[Set[item_type], annotated_types.Len(min_length or 0, max_length)]
 
 
-def confrozenset(item_type: Type[T], *, min_items: int = None, max_items: int = None) -> Type[FrozenSet[T]]:
-    # __args__ is needed to conform to typing generics api
-    namespace = {'min_items': min_items, 'max_items': max_items, 'item_type': item_type, '__args__': [item_type]}
-    # We use new_class to be able to deal with Generic types
-    return new_class('ConstrainedFrozenSetValue', (ConstrainedFrozenSet,), {}, lambda ns: ns.update(namespace))
+def confrozenset(
+    item_type: type[HashableItemType], *, min_length: int | None = None, max_length: int | None = None
+) -> type[frozenset[HashableItemType]]:
+    """A wrapper around `typing.FrozenSet` that allows for additional constraints.
+
+    Args:
+        item_type: The type of the items in the frozenset.
+        min_length: The minimum length of the frozenset.
+        max_length: The maximum length of the frozenset.
+
+    Returns:
+        The wrapped frozenset type.
+    """
+    return Annotated[FrozenSet[item_type], annotated_types.Len(min_length or 0, max_length)]
 
 
-# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ LIST TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-# This types superclass should be List[T], but cython chokes on that...
-class ConstrainedList(list):  # type: ignore
-    # Needed for pydantic to detect that this is a list
-    __origin__ = list
-    __args__: Tuple[Type[T], ...]  # type: ignore
-
-    min_items: Optional[int] = None
-    max_items: Optional[int] = None
-    unique_items: Optional[bool] = None
-    item_type: Type[T]  # type: ignore
-
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield cls.list_length_validator
-        if cls.unique_items:
-            yield cls.unique_items_validator
-
-    @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-        update_not_none(field_schema, minItems=cls.min_items, maxItems=cls.max_items, uniqueItems=cls.unique_items)
-
-    @classmethod
-    def list_length_validator(cls, v: 'Optional[List[T]]') -> 'Optional[List[T]]':
-        if v is None:
-            return None
-
-        v = list_validator(v)
-        v_len = len(v)
-
-        if cls.min_items is not None and v_len < cls.min_items:
-            raise errors.ListMinLengthError(limit_value=cls.min_items)
-
-        if cls.max_items is not None and v_len > cls.max_items:
-            raise errors.ListMaxLengthError(limit_value=cls.max_items)
-
-        return v
-
-    @classmethod
-    def unique_items_validator(cls, v: 'List[T]') -> 'List[T]':
-        for i, value in enumerate(v, start=1):
-            if value in v[i:]:
-                raise errors.ListUniqueItemsError()
-
-        return v
+AnyItemType = TypeVar('AnyItemType')
 
 
 def conlist(
-    item_type: Type[T], *, min_items: int = None, max_items: int = None, unique_items: bool = None
-) -> Type[List[T]]:
-    # __args__ is needed to conform to typing generics api
-    namespace = dict(
-        min_items=min_items, max_items=max_items, unique_items=unique_items, item_type=item_type, __args__=(item_type,)
-    )
-    # We use new_class to be able to deal with Generic types
-    return new_class('ConstrainedListValue', (ConstrainedList,), {}, lambda ns: ns.update(namespace))
+    item_type: type[AnyItemType],
+    *,
+    min_length: int | None = None,
+    max_length: int | None = None,
+    unique_items: bool | None = None,
+) -> type[list[AnyItemType]]:
+    """A wrapper around typing.List that adds validation.
+
+    Args:
+        item_type: The type of the items in the list.
+        min_length: The minimum length of the list. Defaults to None.
+        max_length: The maximum length of the list. Defaults to None.
+        unique_items: Whether the items in the list must be unique. Defaults to None.
+            !!! warning Deprecated
+                The `unique_items` parameter is deprecated, use `Set` instead.
+                See [this issue](https://github.com/pydantic/pydantic-core/issues/296) for more details.
+
+    Returns:
+        The wrapped list type.
+    """
+    if unique_items is not None:
+        raise PydanticUserError(
+            (
+                '`unique_items` is removed, use `Set` instead'
+                '(this feature is discussed in https://github.com/pydantic/pydantic-core/issues/296)'
+            ),
+            code='removed-kwargs',
+        )
+    return Annotated[List[item_type], annotated_types.Len(min_length or 0, max_length)]
 
 
-# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ PYOBJECT TYPE ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~ IMPORT STRING TYPE ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
+AnyType = TypeVar('AnyType')
 if TYPE_CHECKING:
-    PyObject = Callable[..., Any]
+    ImportString = Annotated[AnyType, ...]
 else:
 
-    class PyObject:
-        validate_always = True
+    class ImportString:
+        """A type that can be used to import a type from a string.
+
+        `ImportString` expects a string and loads the Python object importable at that dotted path.
+        Attributes of modules may be separated from the module by `:` or `.`, e.g. if `'math:cos'` was provided,
+        the resulting field value would be the function`cos`. If a `.` is used and both an attribute and submodule
+        are present at the same path, the module will be preferred.
+
+        On model instantiation, pointers will be evaluated and imported. There is
+        some nuance to this behavior, demonstrated in the examples below.
+
+        **Good behavior:**
+        ```py
+        from math import cos
+
+        from pydantic import BaseModel, Field, ImportString, ValidationError
+
+
+        class ImportThings(BaseModel):
+            obj: ImportString
+
+
+        # A string value will cause an automatic import
+        my_cos = ImportThings(obj='math.cos')
+
+        # You can use the imported function as you would expect
+        cos_of_0 = my_cos.obj(0)
+        assert cos_of_0 == 1
+
+
+        # A string whose value cannot be imported will raise an error
+        try:
+            ImportThings(obj='foo.bar')
+        except ValidationError as e:
+            print(e)
+            '''
+            1 validation error for ImportThings
+            obj
+            Invalid python path: No module named 'foo.bar' [type=import_error, input_value='foo.bar', input_type=str]
+            '''
+
+
+        # Actual python objects can be assigned as well
+        my_cos = ImportThings(obj=cos)
+        my_cos_2 = ImportThings(obj='math.cos')
+        my_cos_3 = ImportThings(obj='math:cos')
+        assert my_cos == my_cos_2 == my_cos_3
+
+
+        # You can set default field value either as Python object:
+        class ImportThingsDefaultPyObj(BaseModel):
+            obj: ImportString = math.cos
+
+
+        # or as a string value (but only if used with `validate_default=True`)
+        class ImportThingsDefaultString(BaseModel):
+            obj: ImportString = Field(default='math.cos', validate_default=True)
+
+
+        my_cos_default1 = ImportThingsDefaultPyObj()
+        my_cos_default2 = ImportThingsDefaultString()
+        assert my_cos_default1.obj == my_cos_default2.obj == math.cos
+
+
+        # note: this will not work!
+        class ImportThingsMissingValidateDefault(BaseModel):
+            obj: ImportString = 'math.cos'
+
+        my_cos_default3 = ImportThingsMissingValidateDefault()
+        assert my_cos_default3.obj == 'math.cos'  # just string, not evaluated
+        ```
+
+        Serializing an `ImportString` type to json is also possible.
+
+        ```py
+        from pydantic import BaseModel, ImportString
+
+
+        class ImportThings(BaseModel):
+            obj: ImportString
+
+
+        # Create an instance
+        m = ImportThings(obj='math.cos')
+        print(m)
+        #> obj=<built-in function cos>
+        print(m.model_dump_json())
+        #> {"obj":"math.cos"}
+        ```
+        """
 
         @classmethod
-        def __get_validators__(cls) -> 'CallableGenerator':
-            yield cls.validate
+        def __class_getitem__(cls, item: AnyType) -> AnyType:
+            return Annotated[item, cls()]
 
         @classmethod
-        def validate(cls, value: Any) -> Any:
-            if isinstance(value, Callable):
-                return value
+        def __get_pydantic_core_schema__(
+            cls, source: type[Any], handler: GetCoreSchemaHandler
+        ) -> core_schema.CoreSchema:
+            serializer = core_schema.plain_serializer_function_ser_schema(cls._serialize, when_used='json')
+            if cls is source:
+                # Treat bare usage of ImportString (`schema is None`) as the same as ImportString[Any]
+                return core_schema.no_info_plain_validator_function(
+                    function=_validators.import_string, serialization=serializer
+                )
+            else:
+                return core_schema.no_info_before_validator_function(
+                    function=_validators.import_string, schema=handler(source), serialization=serializer
+                )
 
-            try:
-                value = str_validator(value)
-            except errors.StrError:
-                raise errors.PyObjectError(error_message='value is neither a valid import path not a valid callable')
+        @staticmethod
+        def _serialize(v: Any) -> str:
+            if isinstance(v, ModuleType):
+                return v.__name__
+            elif hasattr(v, '__module__') and hasattr(v, '__name__'):
+                return f'{v.__module__}.{v.__name__}'
+            else:
+                return v
 
-            try:
-                return import_string(value)
-            except ImportError as e:
-                raise errors.PyObjectError(error_message=str(e))
+        def __repr__(self) -> str:
+            return 'ImportString'
 
 
 # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ DECIMAL TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 
-class ConstrainedDecimal(Decimal, metaclass=ConstrainedNumberMeta):
-    gt: OptionalIntFloatDecimal = None
-    ge: OptionalIntFloatDecimal = None
-    lt: OptionalIntFloatDecimal = None
-    le: OptionalIntFloatDecimal = None
-    max_digits: OptionalInt = None
-    decimal_places: OptionalInt = None
-    multiple_of: OptionalIntFloatDecimal = None
-
-    @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-        update_not_none(
-            field_schema,
-            exclusiveMinimum=cls.gt,
-            exclusiveMaximum=cls.lt,
-            minimum=cls.ge,
-            maximum=cls.le,
-            multipleOf=cls.multiple_of,
-        )
-
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield decimal_validator
-        yield number_size_validator
-        yield number_multiple_validator
-        yield cls.validate
-
-    @classmethod
-    def validate(cls, value: Decimal) -> Decimal:
-        digit_tuple, exponent = value.as_tuple()[1:]
-        if exponent in {'F', 'n', 'N'}:
-            raise errors.DecimalIsNotFiniteError()
-
-        if exponent >= 0:
-            # A positive exponent adds that many trailing zeros.
-            digits = len(digit_tuple) + exponent
-            decimals = 0
-        else:
-            # If the absolute value of the negative exponent is larger than the
-            # number of digits, then it's the same as the number of digits,
-            # because it'll consume all of the digits in digit_tuple and then
-            # add abs(exponent) - len(digit_tuple) leading zeros after the
-            # decimal point.
-            if abs(exponent) > len(digit_tuple):
-                digits = decimals = abs(exponent)
-            else:
-                digits = len(digit_tuple)
-                decimals = abs(exponent)
-        whole_digits = digits - decimals
-
-        if cls.max_digits is not None and digits > cls.max_digits:
-            raise errors.DecimalMaxDigitsError(max_digits=cls.max_digits)
-
-        if cls.decimal_places is not None and decimals > cls.decimal_places:
-            raise errors.DecimalMaxPlacesError(decimal_places=cls.decimal_places)
-
-        if cls.max_digits is not None and cls.decimal_places is not None:
-            expected = cls.max_digits - cls.decimal_places
-            if whole_digits > expected:
-                raise errors.DecimalWholeDigitsError(whole_digits=expected)
-
-        return value
-
-
 def condecimal(
     *,
-    gt: Decimal = None,
-    ge: Decimal = None,
-    lt: Decimal = None,
-    le: Decimal = None,
-    max_digits: int = None,
-    decimal_places: int = None,
-    multiple_of: Decimal = None,
-) -> Type[Decimal]:
-    # use kwargs then define conf in a dict to aid with IDE type hinting
-    namespace = dict(
-        gt=gt, ge=ge, lt=lt, le=le, max_digits=max_digits, decimal_places=decimal_places, multiple_of=multiple_of
-    )
-    return type('ConstrainedDecimalValue', (ConstrainedDecimal,), namespace)
+    strict: bool | None = None,
+    gt: int | Decimal | None = None,
+    ge: int | Decimal | None = None,
+    lt: int | Decimal | None = None,
+    le: int | Decimal | None = None,
+    multiple_of: int | Decimal | None = None,
+    max_digits: int | None = None,
+    decimal_places: int | None = None,
+    allow_inf_nan: bool | None = None,
+) -> type[Decimal]:
+    """
+    !!! warning "Discouraged"
+        This function is **discouraged** in favor of using
+        [`Annotated`](https://docs.python.org/3/library/typing.html#typing.Annotated) with
+        [`Field`][pydantic.fields.Field] instead.
+
+        This function will be **deprecated** in Pydantic 3.0.
+
+        The reason is that `condecimal` returns a type, which doesn't play well with static analysis tools.
+
+        === ":x: Don't do this"
+            ```py
+            from pydantic import BaseModel, condecimal
+
+            class Foo(BaseModel):
+                bar: condecimal(strict=True, allow_inf_nan=True)
+            ```
+
+        === ":white_check_mark: Do this"
+            ```py
+            from decimal import Decimal
+
+            from typing_extensions import Annotated
+
+            from pydantic import BaseModel, Field
+
+            class Foo(BaseModel):
+                bar: Annotated[Decimal, Field(strict=True, allow_inf_nan=True)]
+            ```
+
+    A wrapper around Decimal that adds validation.
+
+    Args:
+        strict: Whether to validate the value in strict mode. Defaults to `None`.
+        gt: The value must be greater than this. Defaults to `None`.
+        ge: The value must be greater than or equal to this. Defaults to `None`.
+        lt: The value must be less than this. Defaults to `None`.
+        le: The value must be less than or equal to this. Defaults to `None`.
+        multiple_of: The value must be a multiple of this. Defaults to `None`.
+        max_digits: The maximum number of digits. Defaults to `None`.
+        decimal_places: The number of decimal places. Defaults to `None`.
+        allow_inf_nan: Whether to allow infinity and NaN. Defaults to `None`.
+
+    ```py
+    from decimal import Decimal
+
+    from pydantic import BaseModel, ValidationError, condecimal
+
+    class ConstrainedExample(BaseModel):
+        constrained_decimal: condecimal(gt=Decimal('1.0'))
+
+    m = ConstrainedExample(constrained_decimal=Decimal('1.1'))
+    print(repr(m))
+    #> ConstrainedExample(constrained_decimal=Decimal('1.1'))
+
+    try:
+        ConstrainedExample(constrained_decimal=Decimal('0.9'))
+    except ValidationError as e:
+        print(e.errors())
+        '''
+        [
+            {
+                'type': 'greater_than',
+                'loc': ('constrained_decimal',),
+                'msg': 'Input should be greater than 1.0',
+                'input': Decimal('0.9'),
+                'ctx': {'gt': Decimal('1.0')},
+                'url': 'https://errors.pydantic.dev/2/v/greater_than',
+            }
+        ]
+        '''
+    ```
+    """  # noqa: D212
+    return Annotated[
+        Decimal,
+        Strict(strict) if strict is not None else None,
+        annotated_types.Interval(gt=gt, ge=ge, lt=lt, le=le),
+        annotated_types.MultipleOf(multiple_of) if multiple_of is not None else None,
+        _fields.pydantic_general_metadata(max_digits=max_digits, decimal_places=decimal_places),
+        AllowInfNan(allow_inf_nan) if allow_inf_nan is not None else None,
+    ]
 
 
 # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ UUID TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-if TYPE_CHECKING:
-    UUID1 = UUID
-    UUID3 = UUID
-    UUID4 = UUID
-    UUID5 = UUID
-else:
 
-    class UUID1(UUID):
-        _required_version = 1
+@_dataclasses.dataclass(**_internal_dataclass.slots_true)
+class UuidVersion:
+    """A field metadata class to indicate a [UUID](https://docs.python.org/3/library/uuid.html) version."""
 
-        @classmethod
-        def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-            field_schema.update(type='string', format=f'uuid{cls._required_version}')
+    uuid_version: Literal[1, 3, 4, 5]
 
-    class UUID3(UUID1):
-        _required_version = 3
+    def __get_pydantic_json_schema__(
+        self, core_schema: core_schema.CoreSchema, handler: GetJsonSchemaHandler
+    ) -> JsonSchemaValue:
+        field_schema = handler(core_schema)
+        field_schema.pop('anyOf', None)  # remove the bytes/str union
+        field_schema.update(type='string', format=f'uuid{self.uuid_version}')
+        return field_schema
 
-    class UUID4(UUID1):
-        _required_version = 4
+    def __get_pydantic_core_schema__(self, source: Any, handler: GetCoreSchemaHandler) -> core_schema.CoreSchema:
+        if isinstance(self, source):
+            # used directly as a type
+            return core_schema.uuid_schema(version=self.uuid_version)
+        else:
+            # update existing schema with self.uuid_version
+            schema = handler(source)
+            _check_annotated_type(schema['type'], 'uuid', self.__class__.__name__)
+            schema['version'] = self.uuid_version  # type: ignore
+            return schema
 
-    class UUID5(UUID1):
-        _required_version = 5
+    def __hash__(self) -> int:
+        return hash(type(self.uuid_version))
+
+
+UUID1 = Annotated[UUID, UuidVersion(1)]
+"""A [UUID](https://docs.python.org/3/library/uuid.html) that must be version 1.
+
+```py
+import uuid
+
+from pydantic import UUID1, BaseModel
+
+class Model(BaseModel):
+    uuid1: UUID1
+
+Model(uuid1=uuid.uuid1())
+```
+"""
+UUID3 = Annotated[UUID, UuidVersion(3)]
+"""A [UUID](https://docs.python.org/3/library/uuid.html) that must be version 3.
+
+```py
+import uuid
+
+from pydantic import UUID3, BaseModel
+
+class Model(BaseModel):
+    uuid3: UUID3
+
+Model(uuid3=uuid.uuid3(uuid.NAMESPACE_DNS, 'pydantic.org'))
+```
+"""
+UUID4 = Annotated[UUID, UuidVersion(4)]
+"""A [UUID](https://docs.python.org/3/library/uuid.html) that must be version 4.
+
+```py
+import uuid
+
+from pydantic import UUID4, BaseModel
+
+class Model(BaseModel):
+    uuid4: UUID4
+
+Model(uuid4=uuid.uuid4())
+```
+"""
+UUID5 = Annotated[UUID, UuidVersion(5)]
+"""A [UUID](https://docs.python.org/3/library/uuid.html) that must be version 5.
+
+```py
+import uuid
+
+from pydantic import UUID5, BaseModel
+
+class Model(BaseModel):
+    uuid5: UUID5
+
+Model(uuid5=uuid.uuid5(uuid.NAMESPACE_DNS, 'pydantic.org'))
+```
+"""
 
 
 # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ PATH TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-if TYPE_CHECKING:
-    FilePath = Path
-    DirectoryPath = Path
-else:
 
-    class FilePath(Path):
-        @classmethod
-        def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-            field_schema.update(format='file-path')
+@_dataclasses.dataclass
+class PathType:
+    path_type: Literal['file', 'dir', 'new']
 
-        @classmethod
-        def __get_validators__(cls) -> 'CallableGenerator':
-            yield path_validator
-            yield path_exists_validator
-            yield cls.validate
+    def __get_pydantic_json_schema__(
+        self, core_schema: core_schema.CoreSchema, handler: GetJsonSchemaHandler
+    ) -> JsonSchemaValue:
+        field_schema = handler(core_schema)
+        format_conversion = {'file': 'file-path', 'dir': 'directory-path'}
+        field_schema.update(format=format_conversion.get(self.path_type, 'path'), type='string')
+        return field_schema
 
-        @classmethod
-        def validate(cls, value: Path) -> Path:
-            if not value.is_file():
-                raise errors.PathNotAFileError(path=value)
+    def __get_pydantic_core_schema__(self, source: Any, handler: GetCoreSchemaHandler) -> core_schema.CoreSchema:
+        function_lookup = {
+            'file': cast(core_schema.WithInfoValidatorFunction, self.validate_file),
+            'dir': cast(core_schema.WithInfoValidatorFunction, self.validate_directory),
+            'new': cast(core_schema.WithInfoValidatorFunction, self.validate_new),
+        }
 
-            return value
+        return core_schema.with_info_after_validator_function(
+            function_lookup[self.path_type],
+            handler(source),
+        )
 
-    class DirectoryPath(Path):
-        @classmethod
-        def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-            field_schema.update(format='directory-path')
+    @staticmethod
+    def validate_file(path: Path, _: core_schema.ValidationInfo) -> Path:
+        if path.is_file():
+            return path
+        else:
+            raise PydanticCustomError('path_not_file', 'Path does not point to a file')
 
-        @classmethod
-        def __get_validators__(cls) -> 'CallableGenerator':
-            yield path_validator
-            yield path_exists_validator
-            yield cls.validate
+    @staticmethod
+    def validate_directory(path: Path, _: core_schema.ValidationInfo) -> Path:
+        if path.is_dir():
+            return path
+        else:
+            raise PydanticCustomError('path_not_directory', 'Path does not point to a directory')
 
-        @classmethod
-        def validate(cls, value: Path) -> Path:
-            if not value.is_dir():
-                raise errors.PathNotADirectoryError(path=value)
+    @staticmethod
+    def validate_new(path: Path, _: core_schema.ValidationInfo) -> Path:
+        if path.exists():
+            raise PydanticCustomError('path_exists', 'Path already exists')
+        elif not path.parent.exists():
+            raise PydanticCustomError('parent_does_not_exist', 'Parent directory does not exist')
+        else:
+            return path
 
-            return value
+    def __hash__(self) -> int:
+        return hash(type(self.path_type))
+
+
+FilePath = Annotated[Path, PathType('file')]
+"""A path that must point to a file.
+
+```py
+from pathlib import Path
+
+from pydantic import BaseModel, FilePath, ValidationError
+
+class Model(BaseModel):
+    f: FilePath
+
+path = Path('text.txt')
+path.touch()
+m = Model(f='text.txt')
+print(m.model_dump())
+#> {'f': PosixPath('text.txt')}
+path.unlink()
+
+path = Path('directory')
+path.mkdir(exist_ok=True)
+try:
+    Model(f='directory')  # directory
+except ValidationError as e:
+    print(e)
+    '''
+    1 validation error for Model
+    f
+      Path does not point to a file [type=path_not_file, input_value='directory', input_type=str]
+    '''
+path.rmdir()
+
+try:
+    Model(f='not-exists-file')
+except ValidationError as e:
+    print(e)
+    '''
+    1 validation error for Model
+    f
+      Path does not point to a file [type=path_not_file, input_value='not-exists-file', input_type=str]
+    '''
+```
+"""
+DirectoryPath = Annotated[Path, PathType('dir')]
+"""A path that must point to a directory.
+
+```py
+from pathlib import Path
+
+from pydantic import BaseModel, DirectoryPath, ValidationError
+
+class Model(BaseModel):
+    f: DirectoryPath
+
+path = Path('directory/')
+path.mkdir()
+m = Model(f='directory/')
+print(m.model_dump())
+#> {'f': PosixPath('directory')}
+path.rmdir()
+
+path = Path('file.txt')
+path.touch()
+try:
+    Model(f='file.txt')  # file
+except ValidationError as e:
+    print(e)
+    '''
+    1 validation error for Model
+    f
+      Path does not point to a directory [type=path_not_directory, input_value='file.txt', input_type=str]
+    '''
+path.unlink()
+
+try:
+    Model(f='not-exists-directory')
+except ValidationError as e:
+    print(e)
+    '''
+    1 validation error for Model
+    f
+      Path does not point to a directory [type=path_not_directory, input_value='not-exists-directory', input_type=str]
+    '''
+```
+"""
+NewPath = Annotated[Path, PathType('new')]
+"""A path for a new file or directory that must not already exist."""
 
 
 # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ JSON TYPE ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-
-class JsonWrapper:
-    pass
-
-
-class JsonMeta(type):
-    def __getitem__(self, t: Type[Any]) -> Type[JsonWrapper]:
-        if t is Any:
-            return Json  # allow Json[Any] to replecate plain Json
-        return _registered(type('JsonWrapperValue', (JsonWrapper,), {'inner_type': t}))
-
-
 if TYPE_CHECKING:
-    Json = Annotated[T, ...]  # Json[list[str]] will be recognized by type checkers as list[str]
+    Json = Annotated[AnyType, ...]  # Json[list[str]] will be recognized by type checkers as list[str]
 
 else:
 
-    class Json(metaclass=JsonMeta):
+    class Json:
+        """A special type wrapper which loads JSON before parsing.
+
+        You can use the `Json` data type to make Pydantic first load a raw JSON string before
+        validating the loaded data into the parametrized type:
+
+        ```py
+        from typing import Any, List
+
+        from pydantic import BaseModel, Json, ValidationError
+
+
+        class AnyJsonModel(BaseModel):
+            json_obj: Json[Any]
+
+
+        class ConstrainedJsonModel(BaseModel):
+            json_obj: Json[List[int]]
+
+
+        print(AnyJsonModel(json_obj='{"b": 1}'))
+        #> json_obj={'b': 1}
+        print(ConstrainedJsonModel(json_obj='[1, 2, 3]'))
+        #> json_obj=[1, 2, 3]
+
+        try:
+            ConstrainedJsonModel(json_obj=12)
+        except ValidationError as e:
+            print(e)
+            '''
+            1 validation error for ConstrainedJsonModel
+            json_obj
+            JSON input should be string, bytes or bytearray [type=json_type, input_value=12, input_type=int]
+            '''
+
+        try:
+            ConstrainedJsonModel(json_obj='[a, b]')
+        except ValidationError as e:
+            print(e)
+            '''
+            1 validation error for ConstrainedJsonModel
+            json_obj
+            Invalid JSON: expected value at line 1 column 2 [type=json_invalid, input_value='[a, b]', input_type=str]
+            '''
+
+        try:
+            ConstrainedJsonModel(json_obj='["a", "b"]')
+        except ValidationError as e:
+            print(e)
+            '''
+            2 validation errors for ConstrainedJsonModel
+            json_obj.0
+            Input should be a valid integer, unable to parse string as an integer [type=int_parsing, input_value='a', input_type=str]
+            json_obj.1
+            Input should be a valid integer, unable to parse string as an integer [type=int_parsing, input_value='b', input_type=str]
+            '''
+        ```
+
+        When you dump the model using `model_dump` or `model_dump_json`, the dumped value will be the result of validation,
+        not the original JSON string. However, you can use the argument `round_trip=True` to get the original JSON string back:
+
+        ```py
+        from typing import List
+
+        from pydantic import BaseModel, Json
+
+
+        class ConstrainedJsonModel(BaseModel):
+            json_obj: Json[List[int]]
+
+
+        print(ConstrainedJsonModel(json_obj='[1, 2, 3]').model_dump_json())
+        #> {"json_obj":[1,2,3]}
+        print(
+            ConstrainedJsonModel(json_obj='[1, 2, 3]').model_dump_json(round_trip=True)
+        )
+        #> {"json_obj":"[1,2,3]"}
+        ```
+        """
+
         @classmethod
-        def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-            field_schema.update(type='string', format='json-string')
+        def __class_getitem__(cls, item: AnyType) -> AnyType:
+            return Annotated[item, cls()]
+
+        @classmethod
+        def __get_pydantic_core_schema__(cls, source: Any, handler: GetCoreSchemaHandler) -> core_schema.CoreSchema:
+            if cls is source:
+                return core_schema.json_schema(None)
+            else:
+                return core_schema.json_schema(handler(source))
+
+        def __repr__(self) -> str:
+            return 'Json'
+
+        def __hash__(self) -> int:
+            return hash(type(self))
+
+        def __eq__(self, other: Any) -> bool:
+            return type(other) == type(self)
 
 
 # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ SECRET TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
+SecretType = TypeVar('SecretType', str, bytes)
 
-class SecretField(abc.ABC):
-    """
-    Note: this should be implemented as a generic like `SecretField(ABC, Generic[T])`,
-          the `__init__()` should be part of the abstract class and the
-          `get_secret_value()` method should use the generic `T` type.
 
-          However Cython doesn't support very well generics at the moment and
-          the generated code fails to be imported (see
-          https://github.com/cython/cython/issues/2753).
-    """
+class _SecretField(Generic[SecretType]):
+    def __init__(self, secret_value: SecretType) -> None:
+        self._secret_value: SecretType = secret_value
+
+    def get_secret_value(self) -> SecretType:
+        """Get the secret value.
+
+        Returns:
+            The secret value.
+        """
+        return self._secret_value
 
     def __eq__(self, other: Any) -> bool:
         return isinstance(other, self.__class__) and self.get_secret_value() == other.get_secret_value()
 
-    def __str__(self) -> str:
-        return '**********' if self.get_secret_value() else ''
-
     def __hash__(self) -> int:
         return hash(self.get_secret_value())
 
-    @abc.abstractmethod
-    def get_secret_value(self) -> Any:  # pragma: no cover
-        ...
-
-
-class SecretStr(SecretField):
-    min_length: OptionalInt = None
-    max_length: OptionalInt = None
-
-    @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-        update_not_none(
-            field_schema,
-            type='string',
-            writeOnly=True,
-            format='password',
-            minLength=cls.min_length,
-            maxLength=cls.max_length,
-        )
-
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield cls.validate
-        yield constr_length_validator
-
-    @classmethod
-    def validate(cls, value: Any) -> 'SecretStr':
-        if isinstance(value, cls):
-            return value
-        value = str_validator(value)
-        return cls(value)
-
-    def __init__(self, value: str):
-        self._secret_value = value
-
-    def __repr__(self) -> str:
-        return f"SecretStr('{self}')"
-
     def __len__(self) -> int:
         return len(self._secret_value)
 
-    def display(self) -> str:
-        warnings.warn('`secret_str.display()` is deprecated, use `str(secret_str)` instead', DeprecationWarning)
-        return str(self)
-
-    def get_secret_value(self) -> str:
-        return self._secret_value
-
-
-class SecretBytes(SecretField):
-    min_length: OptionalInt = None
-    max_length: OptionalInt = None
-
-    @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-        update_not_none(
-            field_schema,
-            type='string',
-            writeOnly=True,
-            format='password',
-            minLength=cls.min_length,
-            maxLength=cls.max_length,
-        )
-
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield cls.validate
-        yield constr_length_validator
-
-    @classmethod
-    def validate(cls, value: Any) -> 'SecretBytes':
-        if isinstance(value, cls):
-            return value
-        value = bytes_validator(value)
-        return cls(value)
-
-    def __init__(self, value: bytes):
-        self._secret_value = value
+    def __str__(self) -> str:
+        return str(self._display())
 
     def __repr__(self) -> str:
-        return f"SecretBytes(b'{self}')"
+        return f'{self.__class__.__name__}({self._display()!r})'
 
-    def __len__(self) -> int:
-        return len(self._secret_value)
+    def _display(self) -> SecretType:
+        raise NotImplementedError
 
-    def display(self) -> str:
-        warnings.warn('`secret_bytes.display()` is deprecated, use `str(secret_bytes)` instead', DeprecationWarning)
-        return str(self)
+    @classmethod
+    def __get_pydantic_core_schema__(cls, source: type[Any], handler: GetCoreSchemaHandler) -> core_schema.CoreSchema:
+        if issubclass(source, SecretStr):
+            field_type = str
+            inner_schema = core_schema.str_schema()
+        else:
+            assert issubclass(source, SecretBytes)
+            field_type = bytes
+            inner_schema = core_schema.bytes_schema()
+        error_kind = 'string_type' if field_type is str else 'bytes_type'
 
-    def get_secret_value(self) -> bytes:
-        return self._secret_value
+        def serialize(
+            value: _SecretField[SecretType], info: core_schema.SerializationInfo
+        ) -> str | _SecretField[SecretType]:
+            if info.mode == 'json':
+                # we want the output to always be string without the `b'` prefix for bytes,
+                # hence we just use `secret_display`
+                return _secret_display(value.get_secret_value())
+            else:
+                return value
+
+        def get_json_schema(_core_schema: core_schema.CoreSchema, handler: GetJsonSchemaHandler) -> JsonSchemaValue:
+            json_schema = handler(inner_schema)
+            _utils.update_not_none(
+                json_schema,
+                type='string',
+                writeOnly=True,
+                format='password',
+            )
+            return json_schema
+
+        json_schema = core_schema.no_info_after_validator_function(
+            source,  # construct the type
+            inner_schema,
+        )
+        s = core_schema.json_or_python_schema(
+            python_schema=core_schema.union_schema(
+                [
+                    core_schema.is_instance_schema(source),
+                    json_schema,
+                ],
+                strict=True,
+                custom_error_type=error_kind,
+            ),
+            json_schema=json_schema,
+            serialization=core_schema.plain_serializer_function_ser_schema(
+                serialize,
+                info_arg=True,
+                return_schema=core_schema.str_schema(),
+                when_used='json',
+            ),
+        )
+        s.setdefault('metadata', {}).setdefault('pydantic_js_functions', []).append(get_json_schema)
+        return s
+
+
+def _secret_display(value: str | bytes) -> str:
+    return '**********' if value else ''
+
+
+class SecretStr(_SecretField[str]):
+    """A string used for storing sensitive information that you do not want to be visible in logging or tracebacks.
+
+    When the secret value is nonempty, it is displayed as `'**********'` instead of the underlying value in
+    calls to `repr()` and `str()`. If the value _is_ empty, it is displayed as `''`.
+
+    ```py
+    from pydantic import BaseModel, SecretStr
+
+    class User(BaseModel):
+        username: str
+        password: SecretStr
+
+    user = User(username='scolvin', password='password1')
+
+    print(user)
+    #> username='scolvin' password=SecretStr('**********')
+    print(user.password.get_secret_value())
+    #> password1
+    print((SecretStr('password'), SecretStr('')))
+    #> (SecretStr('**********'), SecretStr(''))
+    ```
+    """
+
+    def _display(self) -> str:
+        return _secret_display(self.get_secret_value())
+
+
+class SecretBytes(_SecretField[bytes]):
+    """A bytes used for storing sensitive information that you do not want to be visible in logging or tracebacks.
+
+    It displays `b'**********'` instead of the string value on `repr()` and `str()` calls.
+    When the secret value is nonempty, it is displayed as `b'**********'` instead of the underlying value in
+    calls to `repr()` and `str()`. If the value _is_ empty, it is displayed as `b''`.
+
+    ```py
+    from pydantic import BaseModel, SecretBytes
+
+    class User(BaseModel):
+        username: str
+        password: SecretBytes
+
+    user = User(username='scolvin', password=b'password1')
+    #> username='scolvin' password=SecretBytes(b'**********')
+    print(user.password.get_secret_value())
+    #> b'password1'
+    print((SecretBytes(b'password'), SecretBytes(b'')))
+    #> (SecretBytes(b'**********'), SecretBytes(b''))
+    ```
+    """
+
+    def _display(self) -> bytes:
+        return _secret_display(self.get_secret_value()).encode()
 
 
 # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ PAYMENT CARD TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 
 class PaymentCardBrand(str, Enum):
-    # If you add another card type, please also add it to the
-    # Hypothesis strategy in `pydantic._hypothesis_plugin`.
     amex = 'American Express'
     mastercard = 'Mastercard'
     visa = 'Visa'
@@ -954,10 +1600,13 @@ class PaymentCardBrand(str, Enum):
         return self.value
 
 
+@deprecated(
+    'The `PaymentCardNumber` class is deprecated, use `pydantic_extra_types` instead. '
+    'See https://docs.pydantic.dev/latest/api/pydantic_extra_types_payment/#pydantic_extra_types.payment.PaymentCardNumber.',
+    category=PydanticDeprecatedSince20,
+)
 class PaymentCardNumber(str):
-    """
-    Based on: https://en.wikipedia.org/wiki/Payment_card_number
-    """
+    """Based on: https://en.wikipedia.org/wiki/Payment_card_number."""
 
     strip_whitespace: ClassVar[bool] = True
     min_length: ClassVar[int] = 12
@@ -967,36 +1616,47 @@ class PaymentCardNumber(str):
     brand: PaymentCardBrand
 
     def __init__(self, card_number: str):
+        self.validate_digits(card_number)
+
+        card_number = self.validate_luhn_check_digit(card_number)
+
         self.bin = card_number[:6]
         self.last4 = card_number[-4:]
-        self.brand = self._get_brand(card_number)
+        self.brand = self.validate_brand(card_number)
 
     @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield str_validator
-        yield constr_strip_whitespace
-        yield constr_length_validator
-        yield cls.validate_digits
-        yield cls.validate_luhn_check_digit
-        yield cls
-        yield cls.validate_length_for_brand
+    def __get_pydantic_core_schema__(cls, source: type[Any], handler: GetCoreSchemaHandler) -> core_schema.CoreSchema:
+        return core_schema.with_info_after_validator_function(
+            cls.validate,
+            core_schema.str_schema(
+                min_length=cls.min_length, max_length=cls.max_length, strip_whitespace=cls.strip_whitespace
+            ),
+        )
+
+    @classmethod
+    def validate(cls, __input_value: str, _: core_schema.ValidationInfo) -> PaymentCardNumber:
+        """Validate the card number and return a `PaymentCardNumber` instance."""
+        return cls(__input_value)
 
     @property
     def masked(self) -> str:
+        """Mask all but the last 4 digits of the card number.
+
+        Returns:
+            A masked card number string.
+        """
         num_masked = len(self) - 10  # len(bin) + len(last4) == 10
         return f'{self.bin}{"*" * num_masked}{self.last4}'
 
     @classmethod
-    def validate_digits(cls, card_number: str) -> str:
+    def validate_digits(cls, card_number: str) -> None:
+        """Validate that the card number is all digits."""
         if not card_number.isdigit():
-            raise errors.NotDigitError
-        return card_number
+            raise PydanticCustomError('payment_card_number_digits', 'Card number is not all digits')
 
     @classmethod
     def validate_luhn_check_digit(cls, card_number: str) -> str:
-        """
-        Based on: https://en.wikipedia.org/wiki/Luhn_algorithm
-        """
+        """Based on: https://en.wikipedia.org/wiki/Luhn_algorithm."""
         sum_ = int(card_number[-1])
         length = len(card_number)
         parity = length % 2
@@ -1009,33 +1669,14 @@ class PaymentCardNumber(str):
             sum_ += digit
         valid = sum_ % 10 == 0
         if not valid:
-            raise errors.LuhnValidationError
-        return card_number
-
-    @classmethod
-    def validate_length_for_brand(cls, card_number: 'PaymentCardNumber') -> 'PaymentCardNumber':
-        """
-        Validate length based on BIN for major brands:
-        https://en.wikipedia.org/wiki/Payment_card_number#Issuer_identification_number_(IIN)
-        """
-        required_length: Union[None, int, str] = None
-        if card_number.brand in PaymentCardBrand.mastercard:
-            required_length = 16
-            valid = len(card_number) == required_length
-        elif card_number.brand == PaymentCardBrand.visa:
-            required_length = '13, 16 or 19'
-            valid = len(card_number) in {13, 16, 19}
-        elif card_number.brand == PaymentCardBrand.amex:
-            required_length = 15
-            valid = len(card_number) == required_length
-        else:
-            valid = True
-        if not valid:
-            raise errors.InvalidLengthForBrand(brand=card_number.brand, required_length=required_length)
+            raise PydanticCustomError('payment_card_number_luhn', 'Card number is not luhn valid')
         return card_number
 
     @staticmethod
-    def _get_brand(card_number: str) -> PaymentCardBrand:
+    def validate_brand(card_number: str) -> PaymentCardBrand:
+        """Validate length based on BIN for major brands:
+        https://en.wikipedia.org/wiki/Payment_card_number#Issuer_identification_number_(IIN).
+        """
         if card_number[0] == '4':
             brand = PaymentCardBrand.visa
         elif 51 <= int(card_number[:2]) <= 55:
@@ -1044,144 +1685,1195 @@ class PaymentCardNumber(str):
             brand = PaymentCardBrand.amex
         else:
             brand = PaymentCardBrand.other
+
+        required_length: None | int | str = None
+        if brand in PaymentCardBrand.mastercard:
+            required_length = 16
+            valid = len(card_number) == required_length
+        elif brand == PaymentCardBrand.visa:
+            required_length = '13, 16 or 19'
+            valid = len(card_number) in {13, 16, 19}
+        elif brand == PaymentCardBrand.amex:
+            required_length = 15
+            valid = len(card_number) == required_length
+        else:
+            valid = True
+
+        if not valid:
+            raise PydanticCustomError(
+                'payment_card_number_brand',
+                'Length for a {brand} card must be {required_length}',
+                {'brand': brand, 'required_length': required_length},
+            )
         return brand
 
 
 # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ BYTE SIZE TYPE ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-BYTE_SIZES = {
-    'b': 1,
-    'kb': 10**3,
-    'mb': 10**6,
-    'gb': 10**9,
-    'tb': 10**12,
-    'pb': 10**15,
-    'eb': 10**18,
-    'kib': 2**10,
-    'mib': 2**20,
-    'gib': 2**30,
-    'tib': 2**40,
-    'pib': 2**50,
-    'eib': 2**60,
-}
-BYTE_SIZES.update({k.lower()[0]: v for k, v in BYTE_SIZES.items() if 'i' not in k})
-byte_string_re = re.compile(r'^\s*(\d*\.?\d+)\s*(\w+)?', re.IGNORECASE)
-
 
 class ByteSize(int):
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield cls.validate
+    """Converts a string representing a number of bytes with units (such as `'1KB'` or `'11.5MiB'`) into an integer.
+
+    You can use the `ByteSize` data type to (case-insensitively) convert a string representation of a number of bytes into
+    an integer, and also to print out human-readable strings representing a number of bytes.
+
+    In conformance with [IEC 80000-13 Standard](https://en.wikipedia.org/wiki/ISO/IEC_80000) we interpret `'1KB'` to mean 1000 bytes,
+    and `'1KiB'` to mean 1024 bytes. In general, including a middle `'i'` will cause the unit to be interpreted as a power of 2,
+    rather than a power of 10 (so, for example, `'1 MB'` is treated as `1_000_000` bytes, whereas `'1 MiB'` is treated as `1_048_576` bytes).
+
+    !!! info
+        Note that `1b` will be parsed as "1 byte" and not "1 bit".
+
+    ```py
+    from pydantic import BaseModel, ByteSize
+
+    class MyModel(BaseModel):
+        size: ByteSize
+
+    print(MyModel(size=52000).size)
+    #> 52000
+    print(MyModel(size='3000 KiB').size)
+    #> 3072000
+
+    m = MyModel(size='50 PB')
+    print(m.size.human_readable())
+    #> 44.4PiB
+    print(m.size.human_readable(decimal=True))
+    #> 50.0PB
+
+    print(m.size.to('TiB'))
+    #> 45474.73508864641
+    ```
+    """
+
+    byte_sizes = {
+        'b': 1,
+        'kb': 10**3,
+        'mb': 10**6,
+        'gb': 10**9,
+        'tb': 10**12,
+        'pb': 10**15,
+        'eb': 10**18,
+        'kib': 2**10,
+        'mib': 2**20,
+        'gib': 2**30,
+        'tib': 2**40,
+        'pib': 2**50,
+        'eib': 2**60,
+        'bit': 1 / 8,
+        'kbit': 10**3 / 8,
+        'mbit': 10**6 / 8,
+        'gbit': 10**9 / 8,
+        'tbit': 10**12 / 8,
+        'pbit': 10**15 / 8,
+        'ebit': 10**18 / 8,
+        'kibit': 2**10 / 8,
+        'mibit': 2**20 / 8,
+        'gibit': 2**30 / 8,
+        'tibit': 2**40 / 8,
+        'pibit': 2**50 / 8,
+        'eibit': 2**60 / 8,
+    }
+    byte_sizes.update({k.lower()[0]: v for k, v in byte_sizes.items() if 'i' not in k})
+
+    byte_string_pattern = r'^\s*(\d*\.?\d+)\s*(\w+)?'
+    byte_string_re = re.compile(byte_string_pattern, re.IGNORECASE)
 
     @classmethod
-    def validate(cls, v: StrIntFloat) -> 'ByteSize':
+    def __get_pydantic_core_schema__(cls, source: type[Any], handler: GetCoreSchemaHandler) -> core_schema.CoreSchema:
+        return core_schema.with_info_after_validator_function(
+            function=cls._validate,
+            schema=core_schema.union_schema(
+                [
+                    core_schema.str_schema(pattern=cls.byte_string_pattern),
+                    core_schema.int_schema(ge=0),
+                ],
+                custom_error_type='byte_size',
+                custom_error_message='could not parse value and unit from byte string',
+            ),
+            serialization=core_schema.plain_serializer_function_ser_schema(
+                int, return_schema=core_schema.int_schema(ge=0)
+            ),
+        )
 
+    @classmethod
+    def _validate(cls, __input_value: Any, _: core_schema.ValidationInfo) -> ByteSize:
         try:
-            return cls(int(v))
+            return cls(int(__input_value))
         except ValueError:
             pass
 
-        str_match = byte_string_re.match(str(v))
+        str_match = cls.byte_string_re.match(str(__input_value))
         if str_match is None:
-            raise errors.InvalidByteSize()
+            raise PydanticCustomError('byte_size', 'could not parse value and unit from byte string')
 
         scalar, unit = str_match.groups()
         if unit is None:
             unit = 'b'
 
         try:
-            unit_mult = BYTE_SIZES[unit.lower()]
+            unit_mult = cls.byte_sizes[unit.lower()]
         except KeyError:
-            raise errors.InvalidByteSizeUnit(unit=unit)
+            raise PydanticCustomError('byte_size_unit', 'could not interpret byte unit: {unit}', {'unit': unit})
 
         return cls(int(float(scalar) * unit_mult))
 
     def human_readable(self, decimal: bool = False) -> str:
+        """Converts a byte size to a human readable string.
 
+        Args:
+            decimal: If True, use decimal units (e.g. 1000 bytes per KB). If False, use binary units
+                (e.g. 1024 bytes per KiB).
+
+        Returns:
+            A human readable string representation of the byte size.
+        """
         if decimal:
             divisor = 1000
-            units = ['B', 'KB', 'MB', 'GB', 'TB', 'PB']
+            units = 'B', 'KB', 'MB', 'GB', 'TB', 'PB'
             final_unit = 'EB'
         else:
             divisor = 1024
-            units = ['B', 'KiB', 'MiB', 'GiB', 'TiB', 'PiB']
+            units = 'B', 'KiB', 'MiB', 'GiB', 'TiB', 'PiB'
             final_unit = 'EiB'
 
         num = float(self)
         for unit in units:
             if abs(num) < divisor:
-                return f'{num:0.1f}{unit}'
+                if unit == 'B':
+                    return f'{num:0.0f}{unit}'
+                else:
+                    return f'{num:0.1f}{unit}'
             num /= divisor
 
         return f'{num:0.1f}{final_unit}'
 
     def to(self, unit: str) -> float:
+        """Converts a byte size to another unit, including both byte and bit units.
 
+        Args:
+            unit: The unit to convert to. Must be one of the following: B, KB, MB, GB, TB, PB, EB,
+                KiB, MiB, GiB, TiB, PiB, EiB (byte units) and
+                bit, kbit, mbit, gbit, tbit, pbit, ebit,
+                kibit, mibit, gibit, tibit, pibit, eibit (bit units).
+
+        Returns:
+            The byte size in the new unit.
+        """
         try:
-            unit_div = BYTE_SIZES[unit.lower()]
+            unit_div = self.byte_sizes[unit.lower()]
         except KeyError:
-            raise errors.InvalidByteSizeUnit(unit=unit)
+            raise PydanticCustomError('byte_size_unit', 'Could not interpret byte unit: {unit}', {'unit': unit})
 
         return self / unit_div
 
 
 # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ DATE TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
+
+def _check_annotated_type(annotated_type: str, expected_type: str, annotation: str) -> None:
+    if annotated_type != expected_type:
+        raise PydanticUserError(f"'{annotation}' cannot annotate '{annotated_type}'.", code='invalid_annotated_type')
+
+
 if TYPE_CHECKING:
-    PastDate = date
-    FutureDate = date
+    PastDate = Annotated[date, ...]
+    FutureDate = Annotated[date, ...]
 else:
 
-    class PastDate(date):
-        @classmethod
-        def __get_validators__(cls) -> 'CallableGenerator':
-            yield parse_date
-            yield cls.validate
+    class PastDate:
+        """A date in the past."""
 
         @classmethod
-        def validate(cls, value: date) -> date:
-            if value >= date.today():
-                raise errors.DateNotInThePastError()
+        def __get_pydantic_core_schema__(
+            cls, source: type[Any], handler: GetCoreSchemaHandler
+        ) -> core_schema.CoreSchema:
+            if cls is source:
+                # used directly as a type
+                return core_schema.date_schema(now_op='past')
+            else:
+                schema = handler(source)
+                _check_annotated_type(schema['type'], 'date', cls.__name__)
+                schema['now_op'] = 'past'
+                return schema
 
-            return value
+        def __repr__(self) -> str:
+            return 'PastDate'
 
-    class FutureDate(date):
-        @classmethod
-        def __get_validators__(cls) -> 'CallableGenerator':
-            yield parse_date
-            yield cls.validate
+    class FutureDate:
+        """A date in the future."""
 
         @classmethod
-        def validate(cls, value: date) -> date:
-            if value <= date.today():
-                raise errors.DateNotInTheFutureError()
+        def __get_pydantic_core_schema__(
+            cls, source: type[Any], handler: GetCoreSchemaHandler
+        ) -> core_schema.CoreSchema:
+            if cls is source:
+                # used directly as a type
+                return core_schema.date_schema(now_op='future')
+            else:
+                schema = handler(source)
+                _check_annotated_type(schema['type'], 'date', cls.__name__)
+                schema['now_op'] = 'future'
+                return schema
 
-            return value
-
-
-class ConstrainedDate(date, metaclass=ConstrainedNumberMeta):
-    gt: OptionalDate = None
-    ge: OptionalDate = None
-    lt: OptionalDate = None
-    le: OptionalDate = None
-
-    @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-        update_not_none(field_schema, exclusiveMinimum=cls.gt, exclusiveMaximum=cls.lt, minimum=cls.ge, maximum=cls.le)
-
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield parse_date
-        yield number_size_validator
+        def __repr__(self) -> str:
+            return 'FutureDate'
 
 
 def condate(
     *,
-    gt: date = None,
-    ge: date = None,
-    lt: date = None,
-    le: date = None,
-) -> Type[date]:
-    # use kwargs then define conf in a dict to aid with IDE type hinting
-    namespace = dict(gt=gt, ge=ge, lt=lt, le=le)
-    return type('ConstrainedDateValue', (ConstrainedDate,), namespace)
+    strict: bool | None = None,
+    gt: date | None = None,
+    ge: date | None = None,
+    lt: date | None = None,
+    le: date | None = None,
+) -> type[date]:
+    """A wrapper for date that adds constraints.
+
+    Args:
+        strict: Whether to validate the date value in strict mode. Defaults to `None`.
+        gt: The value must be greater than this. Defaults to `None`.
+        ge: The value must be greater than or equal to this. Defaults to `None`.
+        lt: The value must be less than this. Defaults to `None`.
+        le: The value must be less than or equal to this. Defaults to `None`.
+
+    Returns:
+        A date type with the specified constraints.
+    """
+    return Annotated[
+        date,
+        Strict(strict) if strict is not None else None,
+        annotated_types.Interval(gt=gt, ge=ge, lt=lt, le=le),
+    ]
+
+
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ DATETIME TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+if TYPE_CHECKING:
+    AwareDatetime = Annotated[datetime, ...]
+    NaiveDatetime = Annotated[datetime, ...]
+    PastDatetime = Annotated[datetime, ...]
+    FutureDatetime = Annotated[datetime, ...]
+
+else:
+
+    class AwareDatetime:
+        """A datetime that requires timezone info."""
+
+        @classmethod
+        def __get_pydantic_core_schema__(
+            cls, source: type[Any], handler: GetCoreSchemaHandler
+        ) -> core_schema.CoreSchema:
+            if cls is source:
+                # used directly as a type
+                return core_schema.datetime_schema(tz_constraint='aware')
+            else:
+                schema = handler(source)
+                _check_annotated_type(schema['type'], 'datetime', cls.__name__)
+                schema['tz_constraint'] = 'aware'
+                return schema
+
+        def __repr__(self) -> str:
+            return 'AwareDatetime'
+
+    class NaiveDatetime:
+        """A datetime that doesn't require timezone info."""
+
+        @classmethod
+        def __get_pydantic_core_schema__(
+            cls, source: type[Any], handler: GetCoreSchemaHandler
+        ) -> core_schema.CoreSchema:
+            if cls is source:
+                # used directly as a type
+                return core_schema.datetime_schema(tz_constraint='naive')
+            else:
+                schema = handler(source)
+                _check_annotated_type(schema['type'], 'datetime', cls.__name__)
+                schema['tz_constraint'] = 'naive'
+                return schema
+
+        def __repr__(self) -> str:
+            return 'NaiveDatetime'
+
+    class PastDatetime:
+        """A datetime that must be in the past."""
+
+        @classmethod
+        def __get_pydantic_core_schema__(
+            cls, source: type[Any], handler: GetCoreSchemaHandler
+        ) -> core_schema.CoreSchema:
+            if cls is source:
+                # used directly as a type
+                return core_schema.datetime_schema(now_op='past')
+            else:
+                schema = handler(source)
+                _check_annotated_type(schema['type'], 'datetime', cls.__name__)
+                schema['now_op'] = 'past'
+                return schema
+
+        def __repr__(self) -> str:
+            return 'PastDatetime'
+
+    class FutureDatetime:
+        """A datetime that must be in the future."""
+
+        @classmethod
+        def __get_pydantic_core_schema__(
+            cls, source: type[Any], handler: GetCoreSchemaHandler
+        ) -> core_schema.CoreSchema:
+            if cls is source:
+                # used directly as a type
+                return core_schema.datetime_schema(now_op='future')
+            else:
+                schema = handler(source)
+                _check_annotated_type(schema['type'], 'datetime', cls.__name__)
+                schema['now_op'] = 'future'
+                return schema
+
+        def __repr__(self) -> str:
+            return 'FutureDatetime'
+
+
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Encoded TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+
+class EncoderProtocol(Protocol):
+    """Protocol for encoding and decoding data to and from bytes."""
+
+    @classmethod
+    def decode(cls, data: bytes) -> bytes:
+        """Decode the data using the encoder.
+
+        Args:
+            data: The data to decode.
+
+        Returns:
+            The decoded data.
+        """
+        ...
+
+    @classmethod
+    def encode(cls, value: bytes) -> bytes:
+        """Encode the data using the encoder.
+
+        Args:
+            value: The data to encode.
+
+        Returns:
+            The encoded data.
+        """
+        ...
+
+    @classmethod
+    def get_json_format(cls) -> str:
+        """Get the JSON format for the encoded data.
+
+        Returns:
+            The JSON format for the encoded data.
+        """
+        ...
+
+
+class Base64Encoder(EncoderProtocol):
+    """Standard (non-URL-safe) Base64 encoder."""
+
+    @classmethod
+    def decode(cls, data: bytes) -> bytes:
+        """Decode the data from base64 encoded bytes to original bytes data.
+
+        Args:
+            data: The data to decode.
+
+        Returns:
+            The decoded data.
+        """
+        try:
+            return base64.decodebytes(data)
+        except ValueError as e:
+            raise PydanticCustomError('base64_decode', "Base64 decoding error: '{error}'", {'error': str(e)})
+
+    @classmethod
+    def encode(cls, value: bytes) -> bytes:
+        """Encode the data from bytes to a base64 encoded bytes.
+
+        Args:
+            value: The data to encode.
+
+        Returns:
+            The encoded data.
+        """
+        return base64.encodebytes(value)
+
+    @classmethod
+    def get_json_format(cls) -> Literal['base64']:
+        """Get the JSON format for the encoded data.
+
+        Returns:
+            The JSON format for the encoded data.
+        """
+        return 'base64'
+
+
+class Base64UrlEncoder(EncoderProtocol):
+    """URL-safe Base64 encoder."""
+
+    @classmethod
+    def decode(cls, data: bytes) -> bytes:
+        """Decode the data from base64 encoded bytes to original bytes data.
+
+        Args:
+            data: The data to decode.
+
+        Returns:
+            The decoded data.
+        """
+        try:
+            return base64.urlsafe_b64decode(data)
+        except ValueError as e:
+            raise PydanticCustomError('base64_decode', "Base64 decoding error: '{error}'", {'error': str(e)})
+
+    @classmethod
+    def encode(cls, value: bytes) -> bytes:
+        """Encode the data from bytes to a base64 encoded bytes.
+
+        Args:
+            value: The data to encode.
+
+        Returns:
+            The encoded data.
+        """
+        return base64.urlsafe_b64encode(value)
+
+    @classmethod
+    def get_json_format(cls) -> Literal['base64url']:
+        """Get the JSON format for the encoded data.
+
+        Returns:
+            The JSON format for the encoded data.
+        """
+        return 'base64url'
+
+
+@_dataclasses.dataclass(**_internal_dataclass.slots_true)
+class EncodedBytes:
+    """A bytes type that is encoded and decoded using the specified encoder.
+
+    `EncodedBytes` needs an encoder that implements `EncoderProtocol` to operate.
+
+    ```py
+    from typing_extensions import Annotated
+
+    from pydantic import BaseModel, EncodedBytes, EncoderProtocol, ValidationError
+
+    class MyEncoder(EncoderProtocol):
+        @classmethod
+        def decode(cls, data: bytes) -> bytes:
+            if data == b'**undecodable**':
+                raise ValueError('Cannot decode data')
+            return data[13:]
+
+        @classmethod
+        def encode(cls, value: bytes) -> bytes:
+            return b'**encoded**: ' + value
+
+        @classmethod
+        def get_json_format(cls) -> str:
+            return 'my-encoder'
+
+    MyEncodedBytes = Annotated[bytes, EncodedBytes(encoder=MyEncoder)]
+
+    class Model(BaseModel):
+        my_encoded_bytes: MyEncodedBytes
+
+    # Initialize the model with encoded data
+    m = Model(my_encoded_bytes=b'**encoded**: some bytes')
+
+    # Access decoded value
+    print(m.my_encoded_bytes)
+    #> b'some bytes'
+
+    # Serialize into the encoded form
+    print(m.model_dump())
+    #> {'my_encoded_bytes': b'**encoded**: some bytes'}
+
+    # Validate encoded data
+    try:
+        Model(my_encoded_bytes=b'**undecodable**')
+    except ValidationError as e:
+        print(e)
+        '''
+        1 validation error for Model
+        my_encoded_bytes
+          Value error, Cannot decode data [type=value_error, input_value=b'**undecodable**', input_type=bytes]
+        '''
+    ```
+    """
+
+    encoder: type[EncoderProtocol]
+
+    def __get_pydantic_json_schema__(
+        self, core_schema: core_schema.CoreSchema, handler: GetJsonSchemaHandler
+    ) -> JsonSchemaValue:
+        field_schema = handler(core_schema)
+        field_schema.update(type='string', format=self.encoder.get_json_format())
+        return field_schema
+
+    def __get_pydantic_core_schema__(self, source: type[Any], handler: GetCoreSchemaHandler) -> core_schema.CoreSchema:
+        return core_schema.with_info_after_validator_function(
+            function=self.decode,
+            schema=core_schema.bytes_schema(),
+            serialization=core_schema.plain_serializer_function_ser_schema(function=self.encode),
+        )
+
+    def decode(self, data: bytes, _: core_schema.ValidationInfo) -> bytes:
+        """Decode the data using the specified encoder.
+
+        Args:
+            data: The data to decode.
+
+        Returns:
+            The decoded data.
+        """
+        return self.encoder.decode(data)
+
+    def encode(self, value: bytes) -> bytes:
+        """Encode the data using the specified encoder.
+
+        Args:
+            value: The data to encode.
+
+        Returns:
+            The encoded data.
+        """
+        return self.encoder.encode(value)
+
+    def __hash__(self) -> int:
+        return hash(self.encoder)
+
+
+@_dataclasses.dataclass(**_internal_dataclass.slots_true)
+class EncodedStr(EncodedBytes):
+    """A str type that is encoded and decoded using the specified encoder.
+
+    `EncodedStr` needs an encoder that implements `EncoderProtocol` to operate.
+
+    ```py
+    from typing_extensions import Annotated
+
+    from pydantic import BaseModel, EncodedStr, EncoderProtocol, ValidationError
+
+    class MyEncoder(EncoderProtocol):
+        @classmethod
+        def decode(cls, data: bytes) -> bytes:
+            if data == b'**undecodable**':
+                raise ValueError('Cannot decode data')
+            return data[13:]
+
+        @classmethod
+        def encode(cls, value: bytes) -> bytes:
+            return b'**encoded**: ' + value
+
+        @classmethod
+        def get_json_format(cls) -> str:
+            return 'my-encoder'
+
+    MyEncodedStr = Annotated[str, EncodedStr(encoder=MyEncoder)]
+
+    class Model(BaseModel):
+        my_encoded_str: MyEncodedStr
+
+    # Initialize the model with encoded data
+    m = Model(my_encoded_str='**encoded**: some str')
+
+    # Access decoded value
+    print(m.my_encoded_str)
+    #> some str
+
+    # Serialize into the encoded form
+    print(m.model_dump())
+    #> {'my_encoded_str': '**encoded**: some str'}
+
+    # Validate encoded data
+    try:
+        Model(my_encoded_str='**undecodable**')
+    except ValidationError as e:
+        print(e)
+        '''
+        1 validation error for Model
+        my_encoded_str
+          Value error, Cannot decode data [type=value_error, input_value='**undecodable**', input_type=str]
+        '''
+    ```
+    """
+
+    def __get_pydantic_core_schema__(self, source: type[Any], handler: GetCoreSchemaHandler) -> core_schema.CoreSchema:
+        return core_schema.with_info_after_validator_function(
+            function=self.decode_str,
+            schema=super(EncodedStr, self).__get_pydantic_core_schema__(source=source, handler=handler),  # noqa: UP008
+            serialization=core_schema.plain_serializer_function_ser_schema(function=self.encode_str),
+        )
+
+    def decode_str(self, data: bytes, _: core_schema.ValidationInfo) -> str:
+        """Decode the data using the specified encoder.
+
+        Args:
+            data: The data to decode.
+
+        Returns:
+            The decoded data.
+        """
+        return data.decode()
+
+    def encode_str(self, value: str) -> str:
+        """Encode the data using the specified encoder.
+
+        Args:
+            value: The data to encode.
+
+        Returns:
+            The encoded data.
+        """
+        return super(EncodedStr, self).encode(value=value.encode()).decode()  # noqa: UP008
+
+    def __hash__(self) -> int:
+        return hash(self.encoder)
+
+
+Base64Bytes = Annotated[bytes, EncodedBytes(encoder=Base64Encoder)]
+"""A bytes type that is encoded and decoded using the standard (non-URL-safe) base64 encoder.
+
+Note:
+    Under the hood, `Base64Bytes` use standard library `base64.encodebytes` and `base64.decodebytes` functions.
+
+    As a result, attempting to decode url-safe base64 data using the `Base64Bytes` type may fail or produce an incorrect
+    decoding.
+
+```py
+from pydantic import Base64Bytes, BaseModel, ValidationError
+
+class Model(BaseModel):
+    base64_bytes: Base64Bytes
+
+# Initialize the model with base64 data
+m = Model(base64_bytes=b'VGhpcyBpcyB0aGUgd2F5')
+
+# Access decoded value
+print(m.base64_bytes)
+#> b'This is the way'
+
+# Serialize into the base64 form
+print(m.model_dump())
+#> {'base64_bytes': b'VGhpcyBpcyB0aGUgd2F5\n'}
+
+# Validate base64 data
+try:
+    print(Model(base64_bytes=b'undecodable').base64_bytes)
+except ValidationError as e:
+    print(e)
+    '''
+    1 validation error for Model
+    base64_bytes
+      Base64 decoding error: 'Incorrect padding' [type=base64_decode, input_value=b'undecodable', input_type=bytes]
+    '''
+```
+"""
+Base64Str = Annotated[str, EncodedStr(encoder=Base64Encoder)]
+"""A str type that is encoded and decoded using the standard (non-URL-safe) base64 encoder.
+
+Note:
+    Under the hood, `Base64Bytes` use standard library `base64.encodebytes` and `base64.decodebytes` functions.
+
+    As a result, attempting to decode url-safe base64 data using the `Base64Str` type may fail or produce an incorrect
+    decoding.
+
+```py
+from pydantic import Base64Str, BaseModel, ValidationError
+
+class Model(BaseModel):
+    base64_str: Base64Str
+
+# Initialize the model with base64 data
+m = Model(base64_str='VGhlc2UgYXJlbid0IHRoZSBkcm9pZHMgeW91J3JlIGxvb2tpbmcgZm9y')
+
+# Access decoded value
+print(m.base64_str)
+#> These aren't the droids you're looking for
+
+# Serialize into the base64 form
+print(m.model_dump())
+#> {'base64_str': 'VGhlc2UgYXJlbid0IHRoZSBkcm9pZHMgeW91J3JlIGxvb2tpbmcgZm9y\n'}
+
+# Validate base64 data
+try:
+    print(Model(base64_str='undecodable').base64_str)
+except ValidationError as e:
+    print(e)
+    '''
+    1 validation error for Model
+    base64_str
+      Base64 decoding error: 'Incorrect padding' [type=base64_decode, input_value='undecodable', input_type=str]
+    '''
+```
+"""
+Base64UrlBytes = Annotated[bytes, EncodedBytes(encoder=Base64UrlEncoder)]
+"""A bytes type that is encoded and decoded using the URL-safe base64 encoder.
+
+Note:
+    Under the hood, `Base64UrlBytes` use standard library `base64.urlsafe_b64encode` and `base64.urlsafe_b64decode`
+    functions.
+
+    As a result, the `Base64UrlBytes` type can be used to faithfully decode "vanilla" base64 data
+    (using `'+'` and `'/'`).
+
+```py
+from pydantic import Base64UrlBytes, BaseModel
+
+class Model(BaseModel):
+    base64url_bytes: Base64UrlBytes
+
+# Initialize the model with base64 data
+m = Model(base64url_bytes=b'SHc_dHc-TXc==')
+print(m)
+#> base64url_bytes=b'Hw?tw>Mw'
+```
+"""
+Base64UrlStr = Annotated[str, EncodedStr(encoder=Base64UrlEncoder)]
+"""A str type that is encoded and decoded using the URL-safe base64 encoder.
+
+Note:
+    Under the hood, `Base64UrlStr` use standard library `base64.urlsafe_b64encode` and `base64.urlsafe_b64decode`
+    functions.
+
+    As a result, the `Base64UrlStr` type can be used to faithfully decode "vanilla" base64 data (using `'+'` and `'/'`).
+
+```py
+from pydantic import Base64UrlStr, BaseModel
+
+class Model(BaseModel):
+    base64url_str: Base64UrlStr
+
+# Initialize the model with base64 data
+m = Model(base64url_str='SHc_dHc-TXc==')
+print(m)
+#> base64url_str='Hw?tw>Mw'
+```
+"""
+
+
+__getattr__ = getattr_migration(__name__)
+
+
+@_dataclasses.dataclass(**_internal_dataclass.slots_true)
+class GetPydanticSchema:
+    """Usage docs: https://docs.pydantic.dev/2.6/concepts/types/#using-getpydanticschema-to-reduce-boilerplate
+
+    A convenience class for creating an annotation that provides pydantic custom type hooks.
+
+    This class is intended to eliminate the need to create a custom "marker" which defines the
+     `__get_pydantic_core_schema__` and `__get_pydantic_json_schema__` custom hook methods.
+
+    For example, to have a field treated by type checkers as `int`, but by pydantic as `Any`, you can do:
+    ```python
+    from typing import Any
+
+    from typing_extensions import Annotated
+
+    from pydantic import BaseModel, GetPydanticSchema
+
+    HandleAsAny = GetPydanticSchema(lambda _s, h: h(Any))
+
+    class Model(BaseModel):
+        x: Annotated[int, HandleAsAny]  # pydantic sees `x: Any`
+
+    print(repr(Model(x='abc').x))
+    #> 'abc'
+    ```
+    """
+
+    get_pydantic_core_schema: Callable[[Any, GetCoreSchemaHandler], CoreSchema] | None = None
+    get_pydantic_json_schema: Callable[[Any, GetJsonSchemaHandler], JsonSchemaValue] | None = None
+
+    # Note: we may want to consider adding a convenience staticmethod `def for_type(type_: Any) -> GetPydanticSchema:`
+    #   which returns `GetPydanticSchema(lambda _s, h: h(type_))`
+
+    if not TYPE_CHECKING:
+        # We put `__getattr__` in a non-TYPE_CHECKING block because otherwise, mypy allows arbitrary attribute access
+
+        def __getattr__(self, item: str) -> Any:
+            """Use this rather than defining `__get_pydantic_core_schema__` etc. to reduce the number of nested calls."""
+            if item == '__get_pydantic_core_schema__' and self.get_pydantic_core_schema:
+                return self.get_pydantic_core_schema
+            elif item == '__get_pydantic_json_schema__' and self.get_pydantic_json_schema:
+                return self.get_pydantic_json_schema
+            else:
+                return object.__getattribute__(self, item)
+
+    __hash__ = object.__hash__
+
+
+@_dataclasses.dataclass(**_internal_dataclass.slots_true, frozen=True)
+class Tag:
+    """Provides a way to specify the expected tag to use for a case of a (callable) discriminated union.
+
+    Also provides a way to label a union case in error messages.
+
+    When using a callable `Discriminator`, attach a `Tag` to each case in the `Union` to specify the tag that
+    should be used to identify that case. For example, in the below example, the `Tag` is used to specify that
+    if `get_discriminator_value` returns `'apple'`, the input should be validated as an `ApplePie`, and if it
+    returns `'pumpkin'`, the input should be validated as a `PumpkinPie`.
+
+    The primary role of the `Tag` here is to map the return value from the callable `Discriminator` function to
+    the appropriate member of the `Union` in question.
+
+    ```py
+    from typing import Any, Union
+
+    from typing_extensions import Annotated, Literal
+
+    from pydantic import BaseModel, Discriminator, Tag
+
+    class Pie(BaseModel):
+        time_to_cook: int
+        num_ingredients: int
+
+    class ApplePie(Pie):
+        fruit: Literal['apple'] = 'apple'
+
+    class PumpkinPie(Pie):
+        filling: Literal['pumpkin'] = 'pumpkin'
+
+    def get_discriminator_value(v: Any) -> str:
+        if isinstance(v, dict):
+            return v.get('fruit', v.get('filling'))
+        return getattr(v, 'fruit', getattr(v, 'filling', None))
+
+    class ThanksgivingDinner(BaseModel):
+        dessert: Annotated[
+            Union[
+                Annotated[ApplePie, Tag('apple')],
+                Annotated[PumpkinPie, Tag('pumpkin')],
+            ],
+            Discriminator(get_discriminator_value),
+        ]
+
+    apple_variation = ThanksgivingDinner.model_validate(
+        {'dessert': {'fruit': 'apple', 'time_to_cook': 60, 'num_ingredients': 8}}
+    )
+    print(repr(apple_variation))
+    '''
+    ThanksgivingDinner(dessert=ApplePie(time_to_cook=60, num_ingredients=8, fruit='apple'))
+    '''
+
+    pumpkin_variation = ThanksgivingDinner.model_validate(
+        {
+            'dessert': {
+                'filling': 'pumpkin',
+                'time_to_cook': 40,
+                'num_ingredients': 6,
+            }
+        }
+    )
+    print(repr(pumpkin_variation))
+    '''
+    ThanksgivingDinner(dessert=PumpkinPie(time_to_cook=40, num_ingredients=6, filling='pumpkin'))
+    '''
+    ```
+
+    !!! note
+        You must specify a `Tag` for every case in a `Tag` that is associated with a
+        callable `Discriminator`. Failing to do so will result in a `PydanticUserError` with code
+        [`callable-discriminator-no-tag`](../errors/usage_errors.md#callable-discriminator-no-tag).
+
+    See the [Discriminated Unions] concepts docs for more details on how to use `Tag`s.
+
+    [Discriminated Unions]: ../concepts/unions.md#discriminated-unions
+    """
+
+    tag: str
+
+    def __get_pydantic_core_schema__(self, source_type: Any, handler: GetCoreSchemaHandler) -> CoreSchema:
+        schema = handler(source_type)
+        metadata = schema.setdefault('metadata', {})
+        assert isinstance(metadata, dict)
+        metadata[_core_utils.TAGGED_UNION_TAG_KEY] = self.tag
+        return schema
+
+
+@_dataclasses.dataclass(**_internal_dataclass.slots_true, frozen=True)
+class Discriminator:
+    """Usage docs: https://docs.pydantic.dev/2.6/concepts/unions/#discriminated-unions-with-callable-discriminator
+
+    Provides a way to use a custom callable as the way to extract the value of a union discriminator.
+
+    This allows you to get validation behavior like you'd get from `Field(discriminator=<field_name>)`,
+    but without needing to have a single shared field across all the union choices. This also makes it
+    possible to handle unions of models and primitive types with discriminated-union-style validation errors.
+    Finally, this allows you to use a custom callable as the way to identify which member of a union a value
+    belongs to, while still seeing all the performance benefits of a discriminated union.
+
+    Consider this example, which is much more performant with the use of `Discriminator` and thus a `TaggedUnion`
+    than it would be as a normal `Union`.
+
+    ```py
+    from typing import Any, Union
+
+    from typing_extensions import Annotated, Literal
+
+    from pydantic import BaseModel, Discriminator, Tag
+
+    class Pie(BaseModel):
+        time_to_cook: int
+        num_ingredients: int
+
+    class ApplePie(Pie):
+        fruit: Literal['apple'] = 'apple'
+
+    class PumpkinPie(Pie):
+        filling: Literal['pumpkin'] = 'pumpkin'
+
+    def get_discriminator_value(v: Any) -> str:
+        if isinstance(v, dict):
+            return v.get('fruit', v.get('filling'))
+        return getattr(v, 'fruit', getattr(v, 'filling', None))
+
+    class ThanksgivingDinner(BaseModel):
+        dessert: Annotated[
+            Union[
+                Annotated[ApplePie, Tag('apple')],
+                Annotated[PumpkinPie, Tag('pumpkin')],
+            ],
+            Discriminator(get_discriminator_value),
+        ]
+
+    apple_variation = ThanksgivingDinner.model_validate(
+        {'dessert': {'fruit': 'apple', 'time_to_cook': 60, 'num_ingredients': 8}}
+    )
+    print(repr(apple_variation))
+    '''
+    ThanksgivingDinner(dessert=ApplePie(time_to_cook=60, num_ingredients=8, fruit='apple'))
+    '''
+
+    pumpkin_variation = ThanksgivingDinner.model_validate(
+        {
+            'dessert': {
+                'filling': 'pumpkin',
+                'time_to_cook': 40,
+                'num_ingredients': 6,
+            }
+        }
+    )
+    print(repr(pumpkin_variation))
+    '''
+    ThanksgivingDinner(dessert=PumpkinPie(time_to_cook=40, num_ingredients=6, filling='pumpkin'))
+    '''
+    ```
+
+    See the [Discriminated Unions] concepts docs for more details on how to use `Discriminator`s.
+
+    [Discriminated Unions]: ../concepts/unions.md#discriminated-unions
+    """
+
+    discriminator: str | Callable[[Any], Hashable]
+    """The callable or field name for discriminating the type in a tagged union.
+
+    A `Callable` discriminator must extract the value of the discriminator from the input.
+    A `str` discriminator must be the name of a field to discriminate against.
+    """
+    custom_error_type: str | None = None
+    """Type to use in [custom errors](../errors/errors.md#custom-errors) replacing the standard discriminated union
+    validation errors.
+    """
+    custom_error_message: str | None = None
+    """Message to use in custom errors."""
+    custom_error_context: dict[str, int | str | float] | None = None
+    """Context to use in custom errors."""
+
+    def __get_pydantic_core_schema__(self, source_type: Any, handler: GetCoreSchemaHandler) -> CoreSchema:
+        origin = _typing_extra.get_origin(source_type)
+        if not origin or not _typing_extra.origin_is_union(origin):
+            raise TypeError(f'{type(self).__name__} must be used with a Union type, not {source_type}')
+
+        if isinstance(self.discriminator, str):
+            from pydantic import Field
+
+            return handler(Annotated[source_type, Field(discriminator=self.discriminator)])
+        else:
+            original_schema = handler(source_type)
+            return self._convert_schema(original_schema)
+
+    def _convert_schema(self, original_schema: core_schema.CoreSchema) -> core_schema.TaggedUnionSchema:
+        if original_schema['type'] != 'union':
+            # This likely indicates that the schema was a single-item union that was simplified.
+            # In this case, we do the same thing we do in
+            # `pydantic._internal._discriminated_union._ApplyInferredDiscriminator._apply_to_root`, namely,
+            # package the generated schema back into a single-item union.
+            original_schema = core_schema.union_schema([original_schema])
+
+        tagged_union_choices = {}
+        for i, choice in enumerate(original_schema['choices']):
+            tag = None
+            if isinstance(choice, tuple):
+                choice, tag = choice
+            metadata = choice.get('metadata')
+            if metadata is not None:
+                metadata_tag = metadata.get(_core_utils.TAGGED_UNION_TAG_KEY)
+                if metadata_tag is not None:
+                    tag = metadata_tag
+            if tag is None:
+                raise PydanticUserError(
+                    f'`Tag` not provided for choice {choice} used with `Discriminator`',
+                    code='callable-discriminator-no-tag',
+                )
+            tagged_union_choices[tag] = choice
+
+        # Have to do these verbose checks to ensure falsy values ('' and {}) don't get ignored
+        custom_error_type = self.custom_error_type
+        if custom_error_type is None:
+            custom_error_type = original_schema.get('custom_error_type')
+
+        custom_error_message = self.custom_error_message
+        if custom_error_message is None:
+            custom_error_message = original_schema.get('custom_error_message')
+
+        custom_error_context = self.custom_error_context
+        if custom_error_context is None:
+            custom_error_context = original_schema.get('custom_error_context')
+
+        custom_error_type = original_schema.get('custom_error_type') if custom_error_type is None else custom_error_type
+        return core_schema.tagged_union_schema(
+            tagged_union_choices,
+            self.discriminator,
+            custom_error_type=custom_error_type,
+            custom_error_message=custom_error_message,
+            custom_error_context=custom_error_context,
+            strict=original_schema.get('strict'),
+            ref=original_schema.get('ref'),
+            metadata=original_schema.get('metadata'),
+            serialization=original_schema.get('serialization'),
+        )
+
+
+_JSON_TYPES = {int, float, str, bool, list, dict, type(None)}
+
+
+def _get_type_name(x: Any) -> str:
+    type_ = type(x)
+    if type_ in _JSON_TYPES:
+        return type_.__name__
+
+    # Handle proper subclasses; note we don't need to handle None or bool here
+    if isinstance(x, int):
+        return 'int'
+    if isinstance(x, float):
+        return 'float'
+    if isinstance(x, str):
+        return 'str'
+    if isinstance(x, list):
+        return 'list'
+    if isinstance(x, dict):
+        return 'dict'
+
+    # Fail by returning the type's actual name
+    return getattr(type_, '__name__', '<no type name>')
+
+
+class _AllowAnyJson:
+    @classmethod
+    def __get_pydantic_core_schema__(cls, source_type: Any, handler: GetCoreSchemaHandler) -> CoreSchema:
+        python_schema = handler(source_type)
+        return core_schema.json_or_python_schema(json_schema=core_schema.any_schema(), python_schema=python_schema)
+
+
+if TYPE_CHECKING:
+    # This seems to only be necessary for mypy
+    JsonValue: TypeAlias = Union[
+        List['JsonValue'],
+        Dict[str, 'JsonValue'],
+        str,
+        bool,
+        int,
+        float,
+        None,
+    ]
+    """A `JsonValue` is used to represent a value that can be serialized to JSON.
+
+    It may be one of:
+
+    * `List['JsonValue']`
+    * `Dict[str, 'JsonValue']`
+    * `str`
+    * `bool`
+    * `int`
+    * `float`
+    * `None`
+
+    The following example demonstrates how to use `JsonValue` to validate JSON data,
+    and what kind of errors to expect when input data is not json serializable.
+
+    ```py
+    import json
+
+    from pydantic import BaseModel, JsonValue, ValidationError
+
+    class Model(BaseModel):
+        j: JsonValue
+
+    valid_json_data = {'j': {'a': {'b': {'c': 1, 'd': [2, None]}}}}
+    invalid_json_data = {'j': {'a': {'b': ...}}}
+
+    print(repr(Model.model_validate(valid_json_data)))
+    #> Model(j={'a': {'b': {'c': 1, 'd': [2, None]}}})
+    print(repr(Model.model_validate_json(json.dumps(valid_json_data))))
+    #> Model(j={'a': {'b': {'c': 1, 'd': [2, None]}}})
+
+    try:
+        Model.model_validate(invalid_json_data)
+    except ValidationError as e:
+        print(e)
+        '''
+        1 validation error for Model
+        j.dict.a.dict.b
+          input was not a valid JSON value [type=invalid-json-value, input_value=Ellipsis, input_type=ellipsis]
+        '''
+    ```
+    """
+
+else:
+    JsonValue = TypeAliasType(
+        'JsonValue',
+        Annotated[
+            Union[
+                Annotated[List['JsonValue'], Tag('list')],
+                Annotated[Dict[str, 'JsonValue'], Tag('dict')],
+                Annotated[str, Tag('str')],
+                Annotated[bool, Tag('bool')],
+                Annotated[int, Tag('int')],
+                Annotated[float, Tag('float')],
+                Annotated[None, Tag('NoneType')],
+            ],
+            Discriminator(
+                _get_type_name,
+                custom_error_type='invalid-json-value',
+                custom_error_message='input was not a valid JSON value',
+            ),
+            _AllowAnyJson,
+        ],
+    )
+
+
+class _OnErrorOmit:
+    @classmethod
+    def __get_pydantic_core_schema__(cls, source_type: Any, handler: GetCoreSchemaHandler) -> CoreSchema:
+        # there is no actual default value here but we use with_default_schema since it already has the on_error
+        # behavior implemented and it would be no more efficient to implement it on every other validator
+        # or as a standalone validator
+        return core_schema.with_default_schema(schema=handler(source_type), on_error='omit')
+
+
+OnErrorOmit = Annotated[T, _OnErrorOmit]
+"""
+When used as an item in a list, the key type in a dict, optional values of a TypedDict, etc.
+this annotation omits the item from the iteration if there is any error validating it.
+That is, instead of a [`ValidationError`][pydantic_core.ValidationError] being propagated up and the entire iterable being discarded
+any invalid items are discarded and the valid ones are returned.
+"""
diff --git a/lib/pydantic/typing.py b/lib/pydantic/typing.py
index 5ccf266c..f1b32ba2 100644
--- a/lib/pydantic/typing.py
+++ b/lib/pydantic/typing.py
@@ -1,602 +1,4 @@
-import sys
-from collections.abc import Callable
-from os import PathLike
-from typing import (  # type: ignore
-    TYPE_CHECKING,
-    AbstractSet,
-    Any,
-    Callable as TypingCallable,
-    ClassVar,
-    Dict,
-    ForwardRef,
-    Generator,
-    Iterable,
-    List,
-    Mapping,
-    NewType,
-    Optional,
-    Sequence,
-    Set,
-    Tuple,
-    Type,
-    TypeVar,
-    Union,
-    _eval_type,
-    cast,
-    get_type_hints,
-)
+"""`typing` module is a backport module from V1."""
+from ._migration import getattr_migration
 
-from typing_extensions import (
-    Annotated,
-    Final,
-    Literal,
-    NotRequired as TypedDictNotRequired,
-    Required as TypedDictRequired,
-)
-
-try:
-    from typing import _TypingBase as typing_base  # type: ignore
-except ImportError:
-    from typing import _Final as typing_base  # type: ignore
-
-try:
-    from typing import GenericAlias as TypingGenericAlias  # type: ignore
-except ImportError:
-    # python < 3.9 does not have GenericAlias (list[int], tuple[str, ...] and so on)
-    TypingGenericAlias = ()
-
-try:
-    from types import UnionType as TypesUnionType  # type: ignore
-except ImportError:
-    # python < 3.10 does not have UnionType (str | int, byte | bool and so on)
-    TypesUnionType = ()
-
-
-if sys.version_info < (3, 9):
-
-    def evaluate_forwardref(type_: ForwardRef, globalns: Any, localns: Any) -> Any:
-        return type_._evaluate(globalns, localns)
-
-else:
-
-    def evaluate_forwardref(type_: ForwardRef, globalns: Any, localns: Any) -> Any:
-        # Even though it is the right signature for python 3.9, mypy complains with
-        # `error: Too many arguments for "_evaluate" of "ForwardRef"` hence the cast...
-        return cast(Any, type_)._evaluate(globalns, localns, set())
-
-
-if sys.version_info < (3, 9):
-    # Ensure we always get all the whole `Annotated` hint, not just the annotated type.
-    # For 3.7 to 3.8, `get_type_hints` doesn't recognize `typing_extensions.Annotated`,
-    # so it already returns the full annotation
-    get_all_type_hints = get_type_hints
-
-else:
-
-    def get_all_type_hints(obj: Any, globalns: Any = None, localns: Any = None) -> Any:
-        return get_type_hints(obj, globalns, localns, include_extras=True)
-
-
-_T = TypeVar('_T')
-
-AnyCallable = TypingCallable[..., Any]
-NoArgAnyCallable = TypingCallable[[], Any]
-
-# workaround for https://github.com/python/mypy/issues/9496
-AnyArgTCallable = TypingCallable[..., _T]
-
-
-# Annotated[...] is implemented by returning an instance of one of these classes, depending on
-# python/typing_extensions version.
-AnnotatedTypeNames = {'AnnotatedMeta', '_AnnotatedAlias'}
-
-
-if sys.version_info < (3, 8):
-
-    def get_origin(t: Type[Any]) -> Optional[Type[Any]]:
-        if type(t).__name__ in AnnotatedTypeNames:
-            # weirdly this is a runtime requirement, as well as for mypy
-            return cast(Type[Any], Annotated)
-        return getattr(t, '__origin__', None)
-
-else:
-    from typing import get_origin as _typing_get_origin
-
-    def get_origin(tp: Type[Any]) -> Optional[Type[Any]]:
-        """
-        We can't directly use `typing.get_origin` since we need a fallback to support
-        custom generic classes like `ConstrainedList`
-        It should be useless once https://github.com/cython/cython/issues/3537 is
-        solved and https://github.com/pydantic/pydantic/pull/1753 is merged.
-        """
-        if type(tp).__name__ in AnnotatedTypeNames:
-            return cast(Type[Any], Annotated)  # mypy complains about _SpecialForm
-        return _typing_get_origin(tp) or getattr(tp, '__origin__', None)
-
-
-if sys.version_info < (3, 8):
-    from typing import _GenericAlias
-
-    def get_args(t: Type[Any]) -> Tuple[Any, ...]:
-        """Compatibility version of get_args for python 3.7.
-
-        Mostly compatible with the python 3.8 `typing` module version
-        and able to handle almost all use cases.
-        """
-        if type(t).__name__ in AnnotatedTypeNames:
-            return t.__args__ + t.__metadata__
-        if isinstance(t, _GenericAlias):
-            res = t.__args__
-            if t.__origin__ is Callable and res and res[0] is not Ellipsis:
-                res = (list(res[:-1]), res[-1])
-            return res
-        return getattr(t, '__args__', ())
-
-else:
-    from typing import get_args as _typing_get_args
-
-    def _generic_get_args(tp: Type[Any]) -> Tuple[Any, ...]:
-        """
-        In python 3.9, `typing.Dict`, `typing.List`, ...
-        do have an empty `__args__` by default (instead of the generic ~T for example).
-        In order to still support `Dict` for example and consider it as `Dict[Any, Any]`,
-        we retrieve the `_nparams` value that tells us how many parameters it needs.
-        """
-        if hasattr(tp, '_nparams'):
-            return (Any,) * tp._nparams
-        # Special case for `tuple[()]`, which used to return ((),) with `typing.Tuple`
-        # in python 3.10- but now returns () for `tuple` and `Tuple`.
-        # This will probably be clarified in pydantic v2
-        try:
-            if tp == Tuple[()] or sys.version_info >= (3, 9) and tp == tuple[()]:  # type: ignore[misc]
-                return ((),)
-        # there is a TypeError when compiled with cython
-        except TypeError:  # pragma: no cover
-            pass
-        return ()
-
-    def get_args(tp: Type[Any]) -> Tuple[Any, ...]:
-        """Get type arguments with all substitutions performed.
-
-        For unions, basic simplifications used by Union constructor are performed.
-        Examples::
-            get_args(Dict[str, int]) == (str, int)
-            get_args(int) == ()
-            get_args(Union[int, Union[T, int], str][int]) == (int, str)
-            get_args(Union[int, Tuple[T, int]][str]) == (int, Tuple[str, int])
-            get_args(Callable[[], T][int]) == ([], int)
-        """
-        if type(tp).__name__ in AnnotatedTypeNames:
-            return tp.__args__ + tp.__metadata__
-        # the fallback is needed for the same reasons as `get_origin` (see above)
-        return _typing_get_args(tp) or getattr(tp, '__args__', ()) or _generic_get_args(tp)
-
-
-if sys.version_info < (3, 9):
-
-    def convert_generics(tp: Type[Any]) -> Type[Any]:
-        """Python 3.9 and older only supports generics from `typing` module.
-        They convert strings to ForwardRef automatically.
-
-        Examples::
-            typing.List['Hero'] == typing.List[ForwardRef('Hero')]
-        """
-        return tp
-
-else:
-    from typing import _UnionGenericAlias  # type: ignore
-
-    from typing_extensions import _AnnotatedAlias
-
-    def convert_generics(tp: Type[Any]) -> Type[Any]:
-        """
-        Recursively searches for `str` type hints and replaces them with ForwardRef.
-
-        Examples::
-            convert_generics(list['Hero']) == list[ForwardRef('Hero')]
-            convert_generics(dict['Hero', 'Team']) == dict[ForwardRef('Hero'), ForwardRef('Team')]
-            convert_generics(typing.Dict['Hero', 'Team']) == typing.Dict[ForwardRef('Hero'), ForwardRef('Team')]
-            convert_generics(list[str | 'Hero'] | int) == list[str | ForwardRef('Hero')] | int
-        """
-        origin = get_origin(tp)
-        if not origin or not hasattr(tp, '__args__'):
-            return tp
-
-        args = get_args(tp)
-
-        # typing.Annotated needs special treatment
-        if origin is Annotated:
-            return _AnnotatedAlias(convert_generics(args[0]), args[1:])
-
-        # recursively replace `str` instances inside of `GenericAlias` with `ForwardRef(arg)`
-        converted = tuple(
-            ForwardRef(arg) if isinstance(arg, str) and isinstance(tp, TypingGenericAlias) else convert_generics(arg)
-            for arg in args
-        )
-
-        if converted == args:
-            return tp
-        elif isinstance(tp, TypingGenericAlias):
-            return TypingGenericAlias(origin, converted)
-        elif isinstance(tp, TypesUnionType):
-            # recreate types.UnionType (PEP604, Python >= 3.10)
-            return _UnionGenericAlias(origin, converted)
-        else:
-            try:
-                setattr(tp, '__args__', converted)
-            except AttributeError:
-                pass
-            return tp
-
-
-if sys.version_info < (3, 10):
-
-    def is_union(tp: Optional[Type[Any]]) -> bool:
-        return tp is Union
-
-    WithArgsTypes = (TypingGenericAlias,)
-
-else:
-    import types
-    import typing
-
-    def is_union(tp: Optional[Type[Any]]) -> bool:
-        return tp is Union or tp is types.UnionType  # noqa: E721
-
-    WithArgsTypes = (typing._GenericAlias, types.GenericAlias, types.UnionType)
-
-
-if sys.version_info < (3, 9):
-    StrPath = Union[str, PathLike]
-else:
-    StrPath = Union[str, PathLike]
-    # TODO: Once we switch to Cython 3 to handle generics properly
-    #  (https://github.com/cython/cython/issues/2753), use following lines instead
-    #  of the one above
-    # # os.PathLike only becomes subscriptable from Python 3.9 onwards
-    # StrPath = Union[str, PathLike[str]]
-
-
-if TYPE_CHECKING:
-    from .fields import ModelField
-
-    TupleGenerator = Generator[Tuple[str, Any], None, None]
-    DictStrAny = Dict[str, Any]
-    DictAny = Dict[Any, Any]
-    SetStr = Set[str]
-    ListStr = List[str]
-    IntStr = Union[int, str]
-    AbstractSetIntStr = AbstractSet[IntStr]
-    DictIntStrAny = Dict[IntStr, Any]
-    MappingIntStrAny = Mapping[IntStr, Any]
-    CallableGenerator = Generator[AnyCallable, None, None]
-    ReprArgs = Sequence[Tuple[Optional[str], Any]]
-    AnyClassMethod = classmethod[Any]
-
-__all__ = (
-    'AnyCallable',
-    'NoArgAnyCallable',
-    'NoneType',
-    'is_none_type',
-    'display_as_type',
-    'resolve_annotations',
-    'is_callable_type',
-    'is_literal_type',
-    'all_literal_values',
-    'is_namedtuple',
-    'is_typeddict',
-    'is_typeddict_special',
-    'is_new_type',
-    'new_type_supertype',
-    'is_classvar',
-    'is_finalvar',
-    'update_field_forward_refs',
-    'update_model_forward_refs',
-    'TupleGenerator',
-    'DictStrAny',
-    'DictAny',
-    'SetStr',
-    'ListStr',
-    'IntStr',
-    'AbstractSetIntStr',
-    'DictIntStrAny',
-    'CallableGenerator',
-    'ReprArgs',
-    'AnyClassMethod',
-    'CallableGenerator',
-    'WithArgsTypes',
-    'get_args',
-    'get_origin',
-    'get_sub_types',
-    'typing_base',
-    'get_all_type_hints',
-    'is_union',
-    'StrPath',
-    'MappingIntStrAny',
-)
-
-
-NoneType = None.__class__
-
-
-NONE_TYPES: Tuple[Any, Any, Any] = (None, NoneType, Literal[None])
-
-
-if sys.version_info < (3, 8):
-    # Even though this implementation is slower, we need it for python 3.7:
-    # In python 3.7 "Literal" is not a builtin type and uses a different
-    # mechanism.
-    # for this reason `Literal[None] is Literal[None]` evaluates to `False`,
-    # breaking the faster implementation used for the other python versions.
-
-    def is_none_type(type_: Any) -> bool:
-        return type_ in NONE_TYPES
-
-elif sys.version_info[:2] == (3, 8):
-
-    def is_none_type(type_: Any) -> bool:
-        for none_type in NONE_TYPES:
-            if type_ is none_type:
-                return True
-        # With python 3.8, specifically 3.8.10, Literal "is" check sare very flakey
-        # can change on very subtle changes like use of types in other modules,
-        # hopefully this check avoids that issue.
-        if is_literal_type(type_):  # pragma: no cover
-            return all_literal_values(type_) == (None,)
-        return False
-
-else:
-
-    def is_none_type(type_: Any) -> bool:
-        for none_type in NONE_TYPES:
-            if type_ is none_type:
-                return True
-        return False
-
-
-def display_as_type(v: Type[Any]) -> str:
-    if not isinstance(v, typing_base) and not isinstance(v, WithArgsTypes) and not isinstance(v, type):
-        v = v.__class__
-
-    if is_union(get_origin(v)):
-        return f'Union[{", ".join(map(display_as_type, get_args(v)))}]'
-
-    if isinstance(v, WithArgsTypes):
-        # Generic alias are constructs like `list[int]`
-        return str(v).replace('typing.', '')
-
-    try:
-        return v.__name__
-    except AttributeError:
-        # happens with typing objects
-        return str(v).replace('typing.', '')
-
-
-def resolve_annotations(raw_annotations: Dict[str, Type[Any]], module_name: Optional[str]) -> Dict[str, Type[Any]]:
-    """
-    Partially taken from typing.get_type_hints.
-
-    Resolve string or ForwardRef annotations into type objects if possible.
-    """
-    base_globals: Optional[Dict[str, Any]] = None
-    if module_name:
-        try:
-            module = sys.modules[module_name]
-        except KeyError:
-            # happens occasionally, see https://github.com/pydantic/pydantic/issues/2363
-            pass
-        else:
-            base_globals = module.__dict__
-
-    annotations = {}
-    for name, value in raw_annotations.items():
-        if isinstance(value, str):
-            if (3, 10) > sys.version_info >= (3, 9, 8) or sys.version_info >= (3, 10, 1):
-                value = ForwardRef(value, is_argument=False, is_class=True)
-            else:
-                value = ForwardRef(value, is_argument=False)
-        try:
-            value = _eval_type(value, base_globals, None)
-        except NameError:
-            # this is ok, it can be fixed with update_forward_refs
-            pass
-        annotations[name] = value
-    return annotations
-
-
-def is_callable_type(type_: Type[Any]) -> bool:
-    return type_ is Callable or get_origin(type_) is Callable
-
-
-def is_literal_type(type_: Type[Any]) -> bool:
-    return Literal is not None and get_origin(type_) is Literal
-
-
-def literal_values(type_: Type[Any]) -> Tuple[Any, ...]:
-    return get_args(type_)
-
-
-def all_literal_values(type_: Type[Any]) -> Tuple[Any, ...]:
-    """
-    This method is used to retrieve all Literal values as
-    Literal can be used recursively (see https://www.python.org/dev/peps/pep-0586)
-    e.g. `Literal[Literal[Literal[1, 2, 3], "foo"], 5, None]`
-    """
-    if not is_literal_type(type_):
-        return (type_,)
-
-    values = literal_values(type_)
-    return tuple(x for value in values for x in all_literal_values(value))
-
-
-def is_namedtuple(type_: Type[Any]) -> bool:
-    """
-    Check if a given class is a named tuple.
-    It can be either a `typing.NamedTuple` or `collections.namedtuple`
-    """
-    from .utils import lenient_issubclass
-
-    return lenient_issubclass(type_, tuple) and hasattr(type_, '_fields')
-
-
-def is_typeddict(type_: Type[Any]) -> bool:
-    """
-    Check if a given class is a typed dict (from `typing` or `typing_extensions`)
-    In 3.10, there will be a public method (https://docs.python.org/3.10/library/typing.html#typing.is_typeddict)
-    """
-    from .utils import lenient_issubclass
-
-    return lenient_issubclass(type_, dict) and hasattr(type_, '__total__')
-
-
-def _check_typeddict_special(type_: Any) -> bool:
-    return type_ is TypedDictRequired or type_ is TypedDictNotRequired
-
-
-def is_typeddict_special(type_: Any) -> bool:
-    """
-    Check if type is a TypedDict special form (Required or NotRequired).
-    """
-    return _check_typeddict_special(type_) or _check_typeddict_special(get_origin(type_))
-
-
-test_type = NewType('test_type', str)
-
-
-def is_new_type(type_: Type[Any]) -> bool:
-    """
-    Check whether type_ was created using typing.NewType
-    """
-    return isinstance(type_, test_type.__class__) and hasattr(type_, '__supertype__')  # type: ignore
-
-
-def new_type_supertype(type_: Type[Any]) -> Type[Any]:
-    while hasattr(type_, '__supertype__'):
-        type_ = type_.__supertype__
-    return type_
-
-
-def _check_classvar(v: Optional[Type[Any]]) -> bool:
-    if v is None:
-        return False
-
-    return v.__class__ == ClassVar.__class__ and getattr(v, '_name', None) == 'ClassVar'
-
-
-def _check_finalvar(v: Optional[Type[Any]]) -> bool:
-    """
-    Check if a given type is a `typing.Final` type.
-    """
-    if v is None:
-        return False
-
-    return v.__class__ == Final.__class__ and (sys.version_info < (3, 8) or getattr(v, '_name', None) == 'Final')
-
-
-def is_classvar(ann_type: Type[Any]) -> bool:
-    if _check_classvar(ann_type) or _check_classvar(get_origin(ann_type)):
-        return True
-
-    # this is an ugly workaround for class vars that contain forward references and are therefore themselves
-    # forward references, see #3679
-    if ann_type.__class__ == ForwardRef and ann_type.__forward_arg__.startswith('ClassVar['):
-        return True
-
-    return False
-
-
-def is_finalvar(ann_type: Type[Any]) -> bool:
-    return _check_finalvar(ann_type) or _check_finalvar(get_origin(ann_type))
-
-
-def update_field_forward_refs(field: 'ModelField', globalns: Any, localns: Any) -> None:
-    """
-    Try to update ForwardRefs on fields based on this ModelField, globalns and localns.
-    """
-    prepare = False
-    if field.type_.__class__ == ForwardRef:
-        prepare = True
-        field.type_ = evaluate_forwardref(field.type_, globalns, localns or None)
-    if field.outer_type_.__class__ == ForwardRef:
-        prepare = True
-        field.outer_type_ = evaluate_forwardref(field.outer_type_, globalns, localns or None)
-    if prepare:
-        field.prepare()
-
-    if field.sub_fields:
-        for sub_f in field.sub_fields:
-            update_field_forward_refs(sub_f, globalns=globalns, localns=localns)
-
-    if field.discriminator_key is not None:
-        field.prepare_discriminated_union_sub_fields()
-
-
-def update_model_forward_refs(
-    model: Type[Any],
-    fields: Iterable['ModelField'],
-    json_encoders: Dict[Union[Type[Any], str, ForwardRef], AnyCallable],
-    localns: 'DictStrAny',
-    exc_to_suppress: Tuple[Type[BaseException], ...] = (),
-) -> None:
-    """
-    Try to update model fields ForwardRefs based on model and localns.
-    """
-    if model.__module__ in sys.modules:
-        globalns = sys.modules[model.__module__].__dict__.copy()
-    else:
-        globalns = {}
-
-    globalns.setdefault(model.__name__, model)
-
-    for f in fields:
-        try:
-            update_field_forward_refs(f, globalns=globalns, localns=localns)
-        except exc_to_suppress:
-            pass
-
-    for key in set(json_encoders.keys()):
-        if isinstance(key, str):
-            fr: ForwardRef = ForwardRef(key)
-        elif isinstance(key, ForwardRef):
-            fr = key
-        else:
-            continue
-
-        try:
-            new_key = evaluate_forwardref(fr, globalns, localns or None)
-        except exc_to_suppress:  # pragma: no cover
-            continue
-
-        json_encoders[new_key] = json_encoders.pop(key)
-
-
-def get_class(type_: Type[Any]) -> Union[None, bool, Type[Any]]:
-    """
-    Tries to get the class of a Type[T] annotation. Returns True if Type is used
-    without brackets. Otherwise returns None.
-    """
-    if type_ is type:
-        return True
-
-    if get_origin(type_) is None:
-        return None
-
-    args = get_args(type_)
-    if not args or not isinstance(args[0], type):
-        return True
-    else:
-        return args[0]
-
-
-def get_sub_types(tp: Any) -> List[Any]:
-    """
-    Return all the types that are allowed by type `tp`
-    `tp` can be a `Union` of allowed types or an `Annotated` type
-    """
-    origin = get_origin(tp)
-    if origin is Annotated:
-        return get_sub_types(get_args(tp)[0])
-    elif is_union(origin):
-        return [x for t in get_args(tp) for x in get_sub_types(t)]
-    else:
-        return [tp]
+__getattr__ = getattr_migration(__name__)
diff --git a/lib/pydantic/utils.py b/lib/pydantic/utils.py
index 1d016c0e..1619d1db 100644
--- a/lib/pydantic/utils.py
+++ b/lib/pydantic/utils.py
@@ -1,841 +1,4 @@
-import keyword
-import warnings
-import weakref
-from collections import OrderedDict, defaultdict, deque
-from copy import deepcopy
-from itertools import islice, zip_longest
-from types import BuiltinFunctionType, CodeType, FunctionType, GeneratorType, LambdaType, ModuleType
-from typing import (
-    TYPE_CHECKING,
-    AbstractSet,
-    Any,
-    Callable,
-    Collection,
-    Dict,
-    Generator,
-    Iterable,
-    Iterator,
-    List,
-    Mapping,
-    MutableMapping,
-    NoReturn,
-    Optional,
-    Set,
-    Tuple,
-    Type,
-    TypeVar,
-    Union,
-)
+"""The `utils` module is a backport module from V1."""
+from ._migration import getattr_migration
 
-from typing_extensions import Annotated
-
-from .errors import ConfigError
-from .typing import (
-    NoneType,
-    WithArgsTypes,
-    all_literal_values,
-    display_as_type,
-    get_args,
-    get_origin,
-    is_literal_type,
-    is_union,
-)
-from .version import version_info
-
-if TYPE_CHECKING:
-    from inspect import Signature
-    from pathlib import Path
-
-    from .config import BaseConfig
-    from .dataclasses import Dataclass
-    from .fields import ModelField
-    from .main import BaseModel
-    from .typing import AbstractSetIntStr, DictIntStrAny, IntStr, MappingIntStrAny, ReprArgs
-
-    RichReprResult = Iterable[Union[Any, Tuple[Any], Tuple[str, Any], Tuple[str, Any, Any]]]
-
-__all__ = (
-    'import_string',
-    'sequence_like',
-    'validate_field_name',
-    'lenient_isinstance',
-    'lenient_issubclass',
-    'in_ipython',
-    'is_valid_identifier',
-    'deep_update',
-    'update_not_none',
-    'almost_equal_floats',
-    'get_model',
-    'to_camel',
-    'is_valid_field',
-    'smart_deepcopy',
-    'PyObjectStr',
-    'Representation',
-    'GetterDict',
-    'ValueItems',
-    'version_info',  # required here to match behaviour in v1.3
-    'ClassAttribute',
-    'path_type',
-    'ROOT_KEY',
-    'get_unique_discriminator_alias',
-    'get_discriminator_alias_and_values',
-    'DUNDER_ATTRIBUTES',
-    'LimitedDict',
-)
-
-ROOT_KEY = '__root__'
-# these are types that are returned unchanged by deepcopy
-IMMUTABLE_NON_COLLECTIONS_TYPES: Set[Type[Any]] = {
-    int,
-    float,
-    complex,
-    str,
-    bool,
-    bytes,
-    type,
-    NoneType,
-    FunctionType,
-    BuiltinFunctionType,
-    LambdaType,
-    weakref.ref,
-    CodeType,
-    # note: including ModuleType will differ from behaviour of deepcopy by not producing error.
-    # It might be not a good idea in general, but considering that this function used only internally
-    # against default values of fields, this will allow to actually have a field with module as default value
-    ModuleType,
-    NotImplemented.__class__,
-    Ellipsis.__class__,
-}
-
-# these are types that if empty, might be copied with simple copy() instead of deepcopy()
-BUILTIN_COLLECTIONS: Set[Type[Any]] = {
-    list,
-    set,
-    tuple,
-    frozenset,
-    dict,
-    OrderedDict,
-    defaultdict,
-    deque,
-}
-
-
-def import_string(dotted_path: str) -> Any:
-    """
-    Stolen approximately from django. Import a dotted module path and return the attribute/class designated by the
-    last name in the path. Raise ImportError if the import fails.
-    """
-    from importlib import import_module
-
-    try:
-        module_path, class_name = dotted_path.strip(' ').rsplit('.', 1)
-    except ValueError as e:
-        raise ImportError(f'"{dotted_path}" doesn\'t look like a module path') from e
-
-    module = import_module(module_path)
-    try:
-        return getattr(module, class_name)
-    except AttributeError as e:
-        raise ImportError(f'Module "{module_path}" does not define a "{class_name}" attribute') from e
-
-
-def truncate(v: Union[str], *, max_len: int = 80) -> str:
-    """
-    Truncate a value and add a unicode ellipsis (three dots) to the end if it was too long
-    """
-    warnings.warn('`truncate` is no-longer used by pydantic and is deprecated', DeprecationWarning)
-    if isinstance(v, str) and len(v) > (max_len - 2):
-        # -3 so quote + string + … + quote has correct length
-        return (v[: (max_len - 3)] + '…').__repr__()
-    try:
-        v = v.__repr__()
-    except TypeError:
-        v = v.__class__.__repr__(v)  # in case v is a type
-    if len(v) > max_len:
-        v = v[: max_len - 1] + '…'
-    return v
-
-
-def sequence_like(v: Any) -> bool:
-    return isinstance(v, (list, tuple, set, frozenset, GeneratorType, deque))
-
-
-def validate_field_name(bases: List[Type['BaseModel']], field_name: str) -> None:
-    """
-    Ensure that the field's name does not shadow an existing attribute of the model.
-    """
-    for base in bases:
-        if getattr(base, field_name, None):
-            raise NameError(
-                f'Field name "{field_name}" shadows a BaseModel attribute; '
-                f'use a different field name with "alias=\'{field_name}\'".'
-            )
-
-
-def lenient_isinstance(o: Any, class_or_tuple: Union[Type[Any], Tuple[Type[Any], ...], None]) -> bool:
-    try:
-        return isinstance(o, class_or_tuple)  # type: ignore[arg-type]
-    except TypeError:
-        return False
-
-
-def lenient_issubclass(cls: Any, class_or_tuple: Union[Type[Any], Tuple[Type[Any], ...], None]) -> bool:
-    try:
-        return isinstance(cls, type) and issubclass(cls, class_or_tuple)  # type: ignore[arg-type]
-    except TypeError:
-        if isinstance(cls, WithArgsTypes):
-            return False
-        raise  # pragma: no cover
-
-
-def in_ipython() -> bool:
-    """
-    Check whether we're in an ipython environment, including jupyter notebooks.
-    """
-    try:
-        eval('__IPYTHON__')
-    except NameError:
-        return False
-    else:  # pragma: no cover
-        return True
-
-
-def is_valid_identifier(identifier: str) -> bool:
-    """
-    Checks that a string is a valid identifier and not a Python keyword.
-    :param identifier: The identifier to test.
-    :return: True if the identifier is valid.
-    """
-    return identifier.isidentifier() and not keyword.iskeyword(identifier)
-
-
-KeyType = TypeVar('KeyType')
-
-
-def deep_update(mapping: Dict[KeyType, Any], *updating_mappings: Dict[KeyType, Any]) -> Dict[KeyType, Any]:
-    updated_mapping = mapping.copy()
-    for updating_mapping in updating_mappings:
-        for k, v in updating_mapping.items():
-            if k in updated_mapping and isinstance(updated_mapping[k], dict) and isinstance(v, dict):
-                updated_mapping[k] = deep_update(updated_mapping[k], v)
-            else:
-                updated_mapping[k] = v
-    return updated_mapping
-
-
-def update_not_none(mapping: Dict[Any, Any], **update: Any) -> None:
-    mapping.update({k: v for k, v in update.items() if v is not None})
-
-
-def almost_equal_floats(value_1: float, value_2: float, *, delta: float = 1e-8) -> bool:
-    """
-    Return True if two floats are almost equal
-    """
-    return abs(value_1 - value_2) <= delta
-
-
-def generate_model_signature(
-    init: Callable[..., None], fields: Dict[str, 'ModelField'], config: Type['BaseConfig']
-) -> 'Signature':
-    """
-    Generate signature for model based on its fields
-    """
-    from inspect import Parameter, Signature, signature
-
-    from .config import Extra
-
-    present_params = signature(init).parameters.values()
-    merged_params: Dict[str, Parameter] = {}
-    var_kw = None
-    use_var_kw = False
-
-    for param in islice(present_params, 1, None):  # skip self arg
-        if param.kind is param.VAR_KEYWORD:
-            var_kw = param
-            continue
-        merged_params[param.name] = param
-
-    if var_kw:  # if custom init has no var_kw, fields which are not declared in it cannot be passed through
-        allow_names = config.allow_population_by_field_name
-        for field_name, field in fields.items():
-            param_name = field.alias
-            if field_name in merged_params or param_name in merged_params:
-                continue
-            elif not is_valid_identifier(param_name):
-                if allow_names and is_valid_identifier(field_name):
-                    param_name = field_name
-                else:
-                    use_var_kw = True
-                    continue
-
-            # TODO: replace annotation with actual expected types once #1055 solved
-            kwargs = {'default': field.default} if not field.required else {}
-            merged_params[param_name] = Parameter(
-                param_name, Parameter.KEYWORD_ONLY, annotation=field.annotation, **kwargs
-            )
-
-    if config.extra is Extra.allow:
-        use_var_kw = True
-
-    if var_kw and use_var_kw:
-        # Make sure the parameter for extra kwargs
-        # does not have the same name as a field
-        default_model_signature = [
-            ('__pydantic_self__', Parameter.POSITIONAL_OR_KEYWORD),
-            ('data', Parameter.VAR_KEYWORD),
-        ]
-        if [(p.name, p.kind) for p in present_params] == default_model_signature:
-            # if this is the standard model signature, use extra_data as the extra args name
-            var_kw_name = 'extra_data'
-        else:
-            # else start from var_kw
-            var_kw_name = var_kw.name
-
-        # generate a name that's definitely unique
-        while var_kw_name in fields:
-            var_kw_name += '_'
-        merged_params[var_kw_name] = var_kw.replace(name=var_kw_name)
-
-    return Signature(parameters=list(merged_params.values()), return_annotation=None)
-
-
-def get_model(obj: Union[Type['BaseModel'], Type['Dataclass']]) -> Type['BaseModel']:
-    from .main import BaseModel
-
-    try:
-        model_cls = obj.__pydantic_model__  # type: ignore
-    except AttributeError:
-        model_cls = obj
-
-    if not issubclass(model_cls, BaseModel):
-        raise TypeError('Unsupported type, must be either BaseModel or dataclass')
-    return model_cls
-
-
-def to_camel(string: str) -> str:
-    return ''.join(word.capitalize() for word in string.split('_'))
-
-
-def to_lower_camel(string: str) -> str:
-    if len(string) >= 1:
-        pascal_string = to_camel(string)
-        return pascal_string[0].lower() + pascal_string[1:]
-    return string.lower()
-
-
-T = TypeVar('T')
-
-
-def unique_list(
-    input_list: Union[List[T], Tuple[T, ...]],
-    *,
-    name_factory: Callable[[T], str] = str,
-) -> List[T]:
-    """
-    Make a list unique while maintaining order.
-    We update the list if another one with the same name is set
-    (e.g. root validator overridden in subclass)
-    """
-    result: List[T] = []
-    result_names: List[str] = []
-    for v in input_list:
-        v_name = name_factory(v)
-        if v_name not in result_names:
-            result_names.append(v_name)
-            result.append(v)
-        else:
-            result[result_names.index(v_name)] = v
-
-    return result
-
-
-class PyObjectStr(str):
-    """
-    String class where repr doesn't include quotes. Useful with Representation when you want to return a string
-    representation of something that valid (or pseudo-valid) python.
-    """
-
-    def __repr__(self) -> str:
-        return str(self)
-
-
-class Representation:
-    """
-    Mixin to provide __str__, __repr__, and __pretty__ methods. See #884 for more details.
-
-    __pretty__ is used by [devtools](https://python-devtools.helpmanual.io/) to provide human readable representations
-    of objects.
-    """
-
-    __slots__: Tuple[str, ...] = tuple()
-
-    def __repr_args__(self) -> 'ReprArgs':
-        """
-        Returns the attributes to show in __str__, __repr__, and __pretty__ this is generally overridden.
-
-        Can either return:
-        * name - value pairs, e.g.: `[('foo_name', 'foo'), ('bar_name', ['b', 'a', 'r'])]`
-        * or, just values, e.g.: `[(None, 'foo'), (None, ['b', 'a', 'r'])]`
-        """
-        attrs = ((s, getattr(self, s)) for s in self.__slots__)
-        return [(a, v) for a, v in attrs if v is not None]
-
-    def __repr_name__(self) -> str:
-        """
-        Name of the instance's class, used in __repr__.
-        """
-        return self.__class__.__name__
-
-    def __repr_str__(self, join_str: str) -> str:
-        return join_str.join(repr(v) if a is None else f'{a}={v!r}' for a, v in self.__repr_args__())
-
-    def __pretty__(self, fmt: Callable[[Any], Any], **kwargs: Any) -> Generator[Any, None, None]:
-        """
-        Used by devtools (https://python-devtools.helpmanual.io/) to provide a human readable representations of objects
-        """
-        yield self.__repr_name__() + '('
-        yield 1
-        for name, value in self.__repr_args__():
-            if name is not None:
-                yield name + '='
-            yield fmt(value)
-            yield ','
-            yield 0
-        yield -1
-        yield ')'
-
-    def __str__(self) -> str:
-        return self.__repr_str__(' ')
-
-    def __repr__(self) -> str:
-        return f'{self.__repr_name__()}({self.__repr_str__(", ")})'
-
-    def __rich_repr__(self) -> 'RichReprResult':
-        """Get fields for Rich library"""
-        for name, field_repr in self.__repr_args__():
-            if name is None:
-                yield field_repr
-            else:
-                yield name, field_repr
-
-
-class GetterDict(Representation):
-    """
-    Hack to make object's smell just enough like dicts for validate_model.
-
-    We can't inherit from Mapping[str, Any] because it upsets cython so we have to implement all methods ourselves.
-    """
-
-    __slots__ = ('_obj',)
-
-    def __init__(self, obj: Any):
-        self._obj = obj
-
-    def __getitem__(self, key: str) -> Any:
-        try:
-            return getattr(self._obj, key)
-        except AttributeError as e:
-            raise KeyError(key) from e
-
-    def get(self, key: Any, default: Any = None) -> Any:
-        return getattr(self._obj, key, default)
-
-    def extra_keys(self) -> Set[Any]:
-        """
-        We don't want to get any other attributes of obj if the model didn't explicitly ask for them
-        """
-        return set()
-
-    def keys(self) -> List[Any]:
-        """
-        Keys of the pseudo dictionary, uses a list not set so order information can be maintained like python
-        dictionaries.
-        """
-        return list(self)
-
-    def values(self) -> List[Any]:
-        return [self[k] for k in self]
-
-    def items(self) -> Iterator[Tuple[str, Any]]:
-        for k in self:
-            yield k, self.get(k)
-
-    def __iter__(self) -> Iterator[str]:
-        for name in dir(self._obj):
-            if not name.startswith('_'):
-                yield name
-
-    def __len__(self) -> int:
-        return sum(1 for _ in self)
-
-    def __contains__(self, item: Any) -> bool:
-        return item in self.keys()
-
-    def __eq__(self, other: Any) -> bool:
-        return dict(self) == dict(other.items())
-
-    def __repr_args__(self) -> 'ReprArgs':
-        return [(None, dict(self))]
-
-    def __repr_name__(self) -> str:
-        return f'GetterDict[{display_as_type(self._obj)}]'
-
-
-class ValueItems(Representation):
-    """
-    Class for more convenient calculation of excluded or included fields on values.
-    """
-
-    __slots__ = ('_items', '_type')
-
-    def __init__(self, value: Any, items: Union['AbstractSetIntStr', 'MappingIntStrAny']) -> None:
-        items = self._coerce_items(items)
-
-        if isinstance(value, (list, tuple)):
-            items = self._normalize_indexes(items, len(value))
-
-        self._items: 'MappingIntStrAny' = items
-
-    def is_excluded(self, item: Any) -> bool:
-        """
-        Check if item is fully excluded.
-
-        :param item: key or index of a value
-        """
-        return self.is_true(self._items.get(item))
-
-    def is_included(self, item: Any) -> bool:
-        """
-        Check if value is contained in self._items
-
-        :param item: key or index of value
-        """
-        return item in self._items
-
-    def for_element(self, e: 'IntStr') -> Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']]:
-        """
-        :param e: key or index of element on value
-        :return: raw values for element if self._items is dict and contain needed element
-        """
-
-        item = self._items.get(e)
-        return item if not self.is_true(item) else None
-
-    def _normalize_indexes(self, items: 'MappingIntStrAny', v_length: int) -> 'DictIntStrAny':
-        """
-        :param items: dict or set of indexes which will be normalized
-        :param v_length: length of sequence indexes of which will be
-
-        >>> self._normalize_indexes({0: True, -2: True, -1: True}, 4)
-        {0: True, 2: True, 3: True}
-        >>> self._normalize_indexes({'__all__': True}, 4)
-        {0: True, 1: True, 2: True, 3: True}
-        """
-
-        normalized_items: 'DictIntStrAny' = {}
-        all_items = None
-        for i, v in items.items():
-            if not (isinstance(v, Mapping) or isinstance(v, AbstractSet) or self.is_true(v)):
-                raise TypeError(f'Unexpected type of exclude value for index "{i}" {v.__class__}')
-            if i == '__all__':
-                all_items = self._coerce_value(v)
-                continue
-            if not isinstance(i, int):
-                raise TypeError(
-                    'Excluding fields from a sequence of sub-models or dicts must be performed index-wise: '
-                    'expected integer keys or keyword "__all__"'
-                )
-            normalized_i = v_length + i if i < 0 else i
-            normalized_items[normalized_i] = self.merge(v, normalized_items.get(normalized_i))
-
-        if not all_items:
-            return normalized_items
-        if self.is_true(all_items):
-            for i in range(v_length):
-                normalized_items.setdefault(i, ...)
-            return normalized_items
-        for i in range(v_length):
-            normalized_item = normalized_items.setdefault(i, {})
-            if not self.is_true(normalized_item):
-                normalized_items[i] = self.merge(all_items, normalized_item)
-        return normalized_items
-
-    @classmethod
-    def merge(cls, base: Any, override: Any, intersect: bool = False) -> Any:
-        """
-        Merge a ``base`` item with an ``override`` item.
-
-        Both ``base`` and ``override`` are converted to dictionaries if possible.
-        Sets are converted to dictionaries with the sets entries as keys and
-        Ellipsis as values.
-
-        Each key-value pair existing in ``base`` is merged with ``override``,
-        while the rest of the key-value pairs are updated recursively with this function.
-
-        Merging takes place based on the "union" of keys if ``intersect`` is
-        set to ``False`` (default) and on the intersection of keys if
-        ``intersect`` is set to ``True``.
-        """
-        override = cls._coerce_value(override)
-        base = cls._coerce_value(base)
-        if override is None:
-            return base
-        if cls.is_true(base) or base is None:
-            return override
-        if cls.is_true(override):
-            return base if intersect else override
-
-        # intersection or union of keys while preserving ordering:
-        if intersect:
-            merge_keys = [k for k in base if k in override] + [k for k in override if k in base]
-        else:
-            merge_keys = list(base) + [k for k in override if k not in base]
-
-        merged: 'DictIntStrAny' = {}
-        for k in merge_keys:
-            merged_item = cls.merge(base.get(k), override.get(k), intersect=intersect)
-            if merged_item is not None:
-                merged[k] = merged_item
-
-        return merged
-
-    @staticmethod
-    def _coerce_items(items: Union['AbstractSetIntStr', 'MappingIntStrAny']) -> 'MappingIntStrAny':
-        if isinstance(items, Mapping):
-            pass
-        elif isinstance(items, AbstractSet):
-            items = dict.fromkeys(items, ...)
-        else:
-            class_name = getattr(items, '__class__', '???')
-            assert_never(
-                items,
-                f'Unexpected type of exclude value {class_name}',
-            )
-        return items
-
-    @classmethod
-    def _coerce_value(cls, value: Any) -> Any:
-        if value is None or cls.is_true(value):
-            return value
-        return cls._coerce_items(value)
-
-    @staticmethod
-    def is_true(v: Any) -> bool:
-        return v is True or v is ...
-
-    def __repr_args__(self) -> 'ReprArgs':
-        return [(None, self._items)]
-
-
-class ClassAttribute:
-    """
-    Hide class attribute from its instances
-    """
-
-    __slots__ = (
-        'name',
-        'value',
-    )
-
-    def __init__(self, name: str, value: Any) -> None:
-        self.name = name
-        self.value = value
-
-    def __get__(self, instance: Any, owner: Type[Any]) -> None:
-        if instance is None:
-            return self.value
-        raise AttributeError(f'{self.name!r} attribute of {owner.__name__!r} is class-only')
-
-
-path_types = {
-    'is_dir': 'directory',
-    'is_file': 'file',
-    'is_mount': 'mount point',
-    'is_symlink': 'symlink',
-    'is_block_device': 'block device',
-    'is_char_device': 'char device',
-    'is_fifo': 'FIFO',
-    'is_socket': 'socket',
-}
-
-
-def path_type(p: 'Path') -> str:
-    """
-    Find out what sort of thing a path is.
-    """
-    assert p.exists(), 'path does not exist'
-    for method, name in path_types.items():
-        if getattr(p, method)():
-            return name
-
-    return 'unknown'
-
-
-Obj = TypeVar('Obj')
-
-
-def smart_deepcopy(obj: Obj) -> Obj:
-    """
-    Return type as is for immutable built-in types
-    Use obj.copy() for built-in empty collections
-    Use copy.deepcopy() for non-empty collections and unknown objects
-    """
-
-    obj_type = obj.__class__
-    if obj_type in IMMUTABLE_NON_COLLECTIONS_TYPES:
-        return obj  # fastest case: obj is immutable and not collection therefore will not be copied anyway
-    try:
-        if not obj and obj_type in BUILTIN_COLLECTIONS:
-            # faster way for empty collections, no need to copy its members
-            return obj if obj_type is tuple else obj.copy()  # type: ignore  # tuple doesn't have copy method
-    except (TypeError, ValueError, RuntimeError):
-        # do we really dare to catch ALL errors? Seems a bit risky
-        pass
-
-    return deepcopy(obj)  # slowest way when we actually might need a deepcopy
-
-
-def is_valid_field(name: str) -> bool:
-    if not name.startswith('_'):
-        return True
-    return ROOT_KEY == name
-
-
-DUNDER_ATTRIBUTES = {
-    '__annotations__',
-    '__classcell__',
-    '__doc__',
-    '__module__',
-    '__orig_bases__',
-    '__orig_class__',
-    '__qualname__',
-}
-
-
-def is_valid_private_name(name: str) -> bool:
-    return not is_valid_field(name) and name not in DUNDER_ATTRIBUTES
-
-
-_EMPTY = object()
-
-
-def all_identical(left: Iterable[Any], right: Iterable[Any]) -> bool:
-    """
-    Check that the items of `left` are the same objects as those in `right`.
-
-    >>> a, b = object(), object()
-    >>> all_identical([a, b, a], [a, b, a])
-    True
-    >>> all_identical([a, b, [a]], [a, b, [a]])  # new list object, while "equal" is not "identical"
-    False
-    """
-    for left_item, right_item in zip_longest(left, right, fillvalue=_EMPTY):
-        if left_item is not right_item:
-            return False
-    return True
-
-
-def assert_never(obj: NoReturn, msg: str) -> NoReturn:
-    """
-    Helper to make sure that we have covered all possible types.
-
-    This is mostly useful for ``mypy``, docs:
-    https://mypy.readthedocs.io/en/latest/literal_types.html#exhaustive-checks
-    """
-    raise TypeError(msg)
-
-
-def get_unique_discriminator_alias(all_aliases: Collection[str], discriminator_key: str) -> str:
-    """Validate that all aliases are the same and if that's the case return the alias"""
-    unique_aliases = set(all_aliases)
-    if len(unique_aliases) > 1:
-        raise ConfigError(
-            f'Aliases for discriminator {discriminator_key!r} must be the same (got {", ".join(sorted(all_aliases))})'
-        )
-    return unique_aliases.pop()
-
-
-def get_discriminator_alias_and_values(tp: Any, discriminator_key: str) -> Tuple[str, Tuple[str, ...]]:
-    """
-    Get alias and all valid values in the `Literal` type of the discriminator field
-    `tp` can be a `BaseModel` class or directly an `Annotated` `Union` of many.
-    """
-    is_root_model = getattr(tp, '__custom_root_type__', False)
-
-    if get_origin(tp) is Annotated:
-        tp = get_args(tp)[0]
-
-    if hasattr(tp, '__pydantic_model__'):
-        tp = tp.__pydantic_model__
-
-    if is_union(get_origin(tp)):
-        alias, all_values = _get_union_alias_and_all_values(tp, discriminator_key)
-        return alias, tuple(v for values in all_values for v in values)
-    elif is_root_model:
-        union_type = tp.__fields__[ROOT_KEY].type_
-        alias, all_values = _get_union_alias_and_all_values(union_type, discriminator_key)
-
-        if len(set(all_values)) > 1:
-            raise ConfigError(
-                f'Field {discriminator_key!r} is not the same for all submodels of {display_as_type(tp)!r}'
-            )
-
-        return alias, all_values[0]
-
-    else:
-        try:
-            t_discriminator_type = tp.__fields__[discriminator_key].type_
-        except AttributeError as e:
-            raise TypeError(f'Type {tp.__name__!r} is not a valid `BaseModel` or `dataclass`') from e
-        except KeyError as e:
-            raise ConfigError(f'Model {tp.__name__!r} needs a discriminator field for key {discriminator_key!r}') from e
-
-        if not is_literal_type(t_discriminator_type):
-            raise ConfigError(f'Field {discriminator_key!r} of model {tp.__name__!r} needs to be a `Literal`')
-
-        return tp.__fields__[discriminator_key].alias, all_literal_values(t_discriminator_type)
-
-
-def _get_union_alias_and_all_values(
-    union_type: Type[Any], discriminator_key: str
-) -> Tuple[str, Tuple[Tuple[str, ...], ...]]:
-    zipped_aliases_values = [get_discriminator_alias_and_values(t, discriminator_key) for t in get_args(union_type)]
-    # unzip: [('alias_a',('v1', 'v2)), ('alias_b', ('v3',))] => [('alias_a', 'alias_b'), (('v1', 'v2'), ('v3',))]
-    all_aliases, all_values = zip(*zipped_aliases_values)
-    return get_unique_discriminator_alias(all_aliases, discriminator_key), all_values
-
-
-KT = TypeVar('KT')
-VT = TypeVar('VT')
-if TYPE_CHECKING:
-    # Annoying inheriting from `MutableMapping` and `dict` breaks cython, hence this work around
-    class LimitedDict(dict, MutableMapping[KT, VT]):  # type: ignore[type-arg]
-        def __init__(self, size_limit: int = 1000):
-            ...
-
-else:
-
-    class LimitedDict(dict):
-        """
-        Limit the size/length of a dict used for caching to avoid unlimited increase in memory usage.
-
-        Since the dict is ordered, and we always remove elements from the beginning, this is effectively a FIFO cache.
-
-        Annoying inheriting from `MutableMapping` breaks cython.
-        """
-
-        def __init__(self, size_limit: int = 1000):
-            self.size_limit = size_limit
-            super().__init__()
-
-        def __setitem__(self, __key: Any, __value: Any) -> None:
-            super().__setitem__(__key, __value)
-            if len(self) > self.size_limit:
-                excess = len(self) - self.size_limit + self.size_limit // 10
-                to_remove = list(self.keys())[:excess]
-                for key in to_remove:
-                    del self[key]
-
-        def __class_getitem__(cls, *args: Any) -> Any:
-            # to avoid errors with 3.7
-            pass
+__getattr__ = getattr_migration(__name__)
diff --git a/lib/pydantic/v1/__init__.py b/lib/pydantic/v1/__init__.py
new file mode 100644
index 00000000..3bf1418f
--- /dev/null
+++ b/lib/pydantic/v1/__init__.py
@@ -0,0 +1,131 @@
+# flake8: noqa
+from . import dataclasses
+from .annotated_types import create_model_from_namedtuple, create_model_from_typeddict
+from .class_validators import root_validator, validator
+from .config import BaseConfig, ConfigDict, Extra
+from .decorator import validate_arguments
+from .env_settings import BaseSettings
+from .error_wrappers import ValidationError
+from .errors import *
+from .fields import Field, PrivateAttr, Required
+from .main import *
+from .networks import *
+from .parse import Protocol
+from .tools import *
+from .types import *
+from .version import VERSION, compiled
+
+__version__ = VERSION
+
+# WARNING __all__ from .errors is not included here, it will be removed as an export here in v2
+# please use "from pydantic.errors import ..." instead
+__all__ = [
+    # annotated types utils
+    'create_model_from_namedtuple',
+    'create_model_from_typeddict',
+    # dataclasses
+    'dataclasses',
+    # class_validators
+    'root_validator',
+    'validator',
+    # config
+    'BaseConfig',
+    'ConfigDict',
+    'Extra',
+    # decorator
+    'validate_arguments',
+    # env_settings
+    'BaseSettings',
+    # error_wrappers
+    'ValidationError',
+    # fields
+    'Field',
+    'Required',
+    # main
+    'BaseModel',
+    'create_model',
+    'validate_model',
+    # network
+    'AnyUrl',
+    'AnyHttpUrl',
+    'FileUrl',
+    'HttpUrl',
+    'stricturl',
+    'EmailStr',
+    'NameEmail',
+    'IPvAnyAddress',
+    'IPvAnyInterface',
+    'IPvAnyNetwork',
+    'PostgresDsn',
+    'CockroachDsn',
+    'AmqpDsn',
+    'RedisDsn',
+    'MongoDsn',
+    'KafkaDsn',
+    'validate_email',
+    # parse
+    'Protocol',
+    # tools
+    'parse_file_as',
+    'parse_obj_as',
+    'parse_raw_as',
+    'schema_of',
+    'schema_json_of',
+    # types
+    'NoneStr',
+    'NoneBytes',
+    'StrBytes',
+    'NoneStrBytes',
+    'StrictStr',
+    'ConstrainedBytes',
+    'conbytes',
+    'ConstrainedList',
+    'conlist',
+    'ConstrainedSet',
+    'conset',
+    'ConstrainedFrozenSet',
+    'confrozenset',
+    'ConstrainedStr',
+    'constr',
+    'PyObject',
+    'ConstrainedInt',
+    'conint',
+    'PositiveInt',
+    'NegativeInt',
+    'NonNegativeInt',
+    'NonPositiveInt',
+    'ConstrainedFloat',
+    'confloat',
+    'PositiveFloat',
+    'NegativeFloat',
+    'NonNegativeFloat',
+    'NonPositiveFloat',
+    'FiniteFloat',
+    'ConstrainedDecimal',
+    'condecimal',
+    'ConstrainedDate',
+    'condate',
+    'UUID1',
+    'UUID3',
+    'UUID4',
+    'UUID5',
+    'FilePath',
+    'DirectoryPath',
+    'Json',
+    'JsonWrapper',
+    'SecretField',
+    'SecretStr',
+    'SecretBytes',
+    'StrictBool',
+    'StrictBytes',
+    'StrictInt',
+    'StrictFloat',
+    'PaymentCardNumber',
+    'PrivateAttr',
+    'ByteSize',
+    'PastDate',
+    'FutureDate',
+    # version
+    'compiled',
+    'VERSION',
+]
diff --git a/lib/pydantic/_hypothesis_plugin.py b/lib/pydantic/v1/_hypothesis_plugin.py
similarity index 97%
rename from lib/pydantic/_hypothesis_plugin.py
rename to lib/pydantic/v1/_hypothesis_plugin.py
index a56d2b98..0c529620 100644
--- a/lib/pydantic/_hypothesis_plugin.py
+++ b/lib/pydantic/v1/_hypothesis_plugin.py
@@ -10,7 +10,7 @@ Pydantic is installed.  See also:
 https://hypothesis.readthedocs.io/en/latest/strategies.html#registering-strategies-via-setuptools-entry-points
 https://hypothesis.readthedocs.io/en/latest/data.html#hypothesis.strategies.register_type_strategy
 https://hypothesis.readthedocs.io/en/latest/strategies.html#interaction-with-pytest-cov
-https://pydantic-docs.helpmanual.io/usage/types/#pydantic-types
+https://docs.pydantic.dev/usage/types/#pydantic-types
 
 Note that because our motivation is to *improve user experience*, the strategies
 are always sound (never generate invalid data) but sacrifice completeness for
@@ -46,7 +46,7 @@ from pydantic.utils import lenient_issubclass
 #
 # conlist() and conset() are unsupported for now, because the workarounds for
 # Cython and Hypothesis to handle parametrized generic types are incompatible.
-# Once Cython can support 'normal' generics we'll revisit this.
+# We are rethinking Hypothesis compatibility in Pydantic v2.
 
 # Emails
 try:
@@ -168,6 +168,11 @@ st.register_type_strategy(pydantic.StrictBool, st.booleans())
 st.register_type_strategy(pydantic.StrictStr, st.text())
 
 
+# FutureDate, PastDate
+st.register_type_strategy(pydantic.FutureDate, st.dates(min_value=datetime.date.today() + datetime.timedelta(days=1)))
+st.register_type_strategy(pydantic.PastDate, st.dates(max_value=datetime.date.today() - datetime.timedelta(days=1)))
+
+
 # Constrained-type resolver functions
 #
 # For these ones, we actually want to inspect the type in order to work out a
diff --git a/lib/pydantic/annotated_types.py b/lib/pydantic/v1/annotated_types.py
similarity index 100%
rename from lib/pydantic/annotated_types.py
rename to lib/pydantic/v1/annotated_types.py
diff --git a/lib/pydantic/v1/class_validators.py b/lib/pydantic/v1/class_validators.py
new file mode 100644
index 00000000..71e66509
--- /dev/null
+++ b/lib/pydantic/v1/class_validators.py
@@ -0,0 +1,361 @@
+import warnings
+from collections import ChainMap
+from functools import partial, partialmethod, wraps
+from itertools import chain
+from types import FunctionType
+from typing import TYPE_CHECKING, Any, Callable, Dict, Iterable, List, Optional, Set, Tuple, Type, Union, overload
+
+from .errors import ConfigError
+from .typing import AnyCallable
+from .utils import ROOT_KEY, in_ipython
+
+if TYPE_CHECKING:
+    from .typing import AnyClassMethod
+
+
+class Validator:
+    __slots__ = 'func', 'pre', 'each_item', 'always', 'check_fields', 'skip_on_failure'
+
+    def __init__(
+        self,
+        func: AnyCallable,
+        pre: bool = False,
+        each_item: bool = False,
+        always: bool = False,
+        check_fields: bool = False,
+        skip_on_failure: bool = False,
+    ):
+        self.func = func
+        self.pre = pre
+        self.each_item = each_item
+        self.always = always
+        self.check_fields = check_fields
+        self.skip_on_failure = skip_on_failure
+
+
+if TYPE_CHECKING:
+    from inspect import Signature
+
+    from .config import BaseConfig
+    from .fields import ModelField
+    from .types import ModelOrDc
+
+    ValidatorCallable = Callable[[Optional[ModelOrDc], Any, Dict[str, Any], ModelField, Type[BaseConfig]], Any]
+    ValidatorsList = List[ValidatorCallable]
+    ValidatorListDict = Dict[str, List[Validator]]
+
+_FUNCS: Set[str] = set()
+VALIDATOR_CONFIG_KEY = '__validator_config__'
+ROOT_VALIDATOR_CONFIG_KEY = '__root_validator_config__'
+
+
+def validator(
+    *fields: str,
+    pre: bool = False,
+    each_item: bool = False,
+    always: bool = False,
+    check_fields: bool = True,
+    whole: Optional[bool] = None,
+    allow_reuse: bool = False,
+) -> Callable[[AnyCallable], 'AnyClassMethod']:
+    """
+    Decorate methods on the class indicating that they should be used to validate fields
+    :param fields: which field(s) the method should be called on
+    :param pre: whether or not this validator should be called before the standard validators (else after)
+    :param each_item: for complex objects (sets, lists etc.) whether to validate individual elements rather than the
+      whole object
+    :param always: whether this method and other validators should be called even if the value is missing
+    :param check_fields: whether to check that the fields actually exist on the model
+    :param allow_reuse: whether to track and raise an error if another validator refers to the decorated function
+    """
+    if not fields:
+        raise ConfigError('validator with no fields specified')
+    elif isinstance(fields[0], FunctionType):
+        raise ConfigError(
+            "validators should be used with fields and keyword arguments, not bare. "  # noqa: Q000
+            "E.g. usage should be `@validator('<field_name>', ...)`"
+        )
+    elif not all(isinstance(field, str) for field in fields):
+        raise ConfigError(
+            "validator fields should be passed as separate string args. "  # noqa: Q000
+            "E.g. usage should be `@validator('<field_name_1>', '<field_name_2>', ...)`"
+        )
+
+    if whole is not None:
+        warnings.warn(
+            'The "whole" keyword argument is deprecated, use "each_item" (inverse meaning, default False) instead',
+            DeprecationWarning,
+        )
+        assert each_item is False, '"each_item" and "whole" conflict, remove "whole"'
+        each_item = not whole
+
+    def dec(f: AnyCallable) -> 'AnyClassMethod':
+        f_cls = _prepare_validator(f, allow_reuse)
+        setattr(
+            f_cls,
+            VALIDATOR_CONFIG_KEY,
+            (
+                fields,
+                Validator(func=f_cls.__func__, pre=pre, each_item=each_item, always=always, check_fields=check_fields),
+            ),
+        )
+        return f_cls
+
+    return dec
+
+
+@overload
+def root_validator(_func: AnyCallable) -> 'AnyClassMethod':
+    ...
+
+
+@overload
+def root_validator(
+    *, pre: bool = False, allow_reuse: bool = False, skip_on_failure: bool = False
+) -> Callable[[AnyCallable], 'AnyClassMethod']:
+    ...
+
+
+def root_validator(
+    _func: Optional[AnyCallable] = None, *, pre: bool = False, allow_reuse: bool = False, skip_on_failure: bool = False
+) -> Union['AnyClassMethod', Callable[[AnyCallable], 'AnyClassMethod']]:
+    """
+    Decorate methods on a model indicating that they should be used to validate (and perhaps modify) data either
+    before or after standard model parsing/validation is performed.
+    """
+    if _func:
+        f_cls = _prepare_validator(_func, allow_reuse)
+        setattr(
+            f_cls, ROOT_VALIDATOR_CONFIG_KEY, Validator(func=f_cls.__func__, pre=pre, skip_on_failure=skip_on_failure)
+        )
+        return f_cls
+
+    def dec(f: AnyCallable) -> 'AnyClassMethod':
+        f_cls = _prepare_validator(f, allow_reuse)
+        setattr(
+            f_cls, ROOT_VALIDATOR_CONFIG_KEY, Validator(func=f_cls.__func__, pre=pre, skip_on_failure=skip_on_failure)
+        )
+        return f_cls
+
+    return dec
+
+
+def _prepare_validator(function: AnyCallable, allow_reuse: bool) -> 'AnyClassMethod':
+    """
+    Avoid validators with duplicated names since without this, validators can be overwritten silently
+    which generally isn't the intended behaviour, don't run in ipython (see #312) or if allow_reuse is False.
+    """
+    f_cls = function if isinstance(function, classmethod) else classmethod(function)
+    if not in_ipython() and not allow_reuse:
+        ref = (
+            getattr(f_cls.__func__, '__module__', '<No __module__>')
+            + '.'
+            + getattr(f_cls.__func__, '__qualname__', f'<No __qualname__: id:{id(f_cls.__func__)}>')
+        )
+        if ref in _FUNCS:
+            raise ConfigError(f'duplicate validator function "{ref}"; if this is intended, set `allow_reuse=True`')
+        _FUNCS.add(ref)
+    return f_cls
+
+
+class ValidatorGroup:
+    def __init__(self, validators: 'ValidatorListDict') -> None:
+        self.validators = validators
+        self.used_validators = {'*'}
+
+    def get_validators(self, name: str) -> Optional[Dict[str, Validator]]:
+        self.used_validators.add(name)
+        validators = self.validators.get(name, [])
+        if name != ROOT_KEY:
+            validators += self.validators.get('*', [])
+        if validators:
+            return {getattr(v.func, '__name__', f'<No __name__: id:{id(v.func)}>'): v for v in validators}
+        else:
+            return None
+
+    def check_for_unused(self) -> None:
+        unused_validators = set(
+            chain.from_iterable(
+                (
+                    getattr(v.func, '__name__', f'<No __name__: id:{id(v.func)}>')
+                    for v in self.validators[f]
+                    if v.check_fields
+                )
+                for f in (self.validators.keys() - self.used_validators)
+            )
+        )
+        if unused_validators:
+            fn = ', '.join(unused_validators)
+            raise ConfigError(
+                f"Validators defined with incorrect fields: {fn} "  # noqa: Q000
+                f"(use check_fields=False if you're inheriting from the model and intended this)"
+            )
+
+
+def extract_validators(namespace: Dict[str, Any]) -> Dict[str, List[Validator]]:
+    validators: Dict[str, List[Validator]] = {}
+    for var_name, value in namespace.items():
+        validator_config = getattr(value, VALIDATOR_CONFIG_KEY, None)
+        if validator_config:
+            fields, v = validator_config
+            for field in fields:
+                if field in validators:
+                    validators[field].append(v)
+                else:
+                    validators[field] = [v]
+    return validators
+
+
+def extract_root_validators(namespace: Dict[str, Any]) -> Tuple[List[AnyCallable], List[Tuple[bool, AnyCallable]]]:
+    from inspect import signature
+
+    pre_validators: List[AnyCallable] = []
+    post_validators: List[Tuple[bool, AnyCallable]] = []
+    for name, value in namespace.items():
+        validator_config: Optional[Validator] = getattr(value, ROOT_VALIDATOR_CONFIG_KEY, None)
+        if validator_config:
+            sig = signature(validator_config.func)
+            args = list(sig.parameters.keys())
+            if args[0] == 'self':
+                raise ConfigError(
+                    f'Invalid signature for root validator {name}: {sig}, "self" not permitted as first argument, '
+                    f'should be: (cls, values).'
+                )
+            if len(args) != 2:
+                raise ConfigError(f'Invalid signature for root validator {name}: {sig}, should be: (cls, values).')
+            # check function signature
+            if validator_config.pre:
+                pre_validators.append(validator_config.func)
+            else:
+                post_validators.append((validator_config.skip_on_failure, validator_config.func))
+    return pre_validators, post_validators
+
+
+def inherit_validators(base_validators: 'ValidatorListDict', validators: 'ValidatorListDict') -> 'ValidatorListDict':
+    for field, field_validators in base_validators.items():
+        if field not in validators:
+            validators[field] = []
+        validators[field] += field_validators
+    return validators
+
+
+def make_generic_validator(validator: AnyCallable) -> 'ValidatorCallable':
+    """
+    Make a generic function which calls a validator with the right arguments.
+
+    Unfortunately other approaches (eg. return a partial of a function that builds the arguments) is slow,
+    hence this laborious way of doing things.
+
+    It's done like this so validators don't all need **kwargs in their signature, eg. any combination of
+    the arguments "values", "fields" and/or "config" are permitted.
+    """
+    from inspect import signature
+
+    if not isinstance(validator, (partial, partialmethod)):
+        # This should be the default case, so overhead is reduced
+        sig = signature(validator)
+        args = list(sig.parameters.keys())
+    else:
+        # Fix the generated argument lists of partial methods
+        sig = signature(validator.func)
+        args = [
+            k
+            for k in signature(validator.func).parameters.keys()
+            if k not in validator.args | validator.keywords.keys()
+        ]
+
+    first_arg = args.pop(0)
+    if first_arg == 'self':
+        raise ConfigError(
+            f'Invalid signature for validator {validator}: {sig}, "self" not permitted as first argument, '
+            f'should be: (cls, value, values, config, field), "values", "config" and "field" are all optional.'
+        )
+    elif first_arg == 'cls':
+        # assume the second argument is value
+        return wraps(validator)(_generic_validator_cls(validator, sig, set(args[1:])))
+    else:
+        # assume the first argument was value which has already been removed
+        return wraps(validator)(_generic_validator_basic(validator, sig, set(args)))
+
+
+def prep_validators(v_funcs: Iterable[AnyCallable]) -> 'ValidatorsList':
+    return [make_generic_validator(f) for f in v_funcs if f]
+
+
+all_kwargs = {'values', 'field', 'config'}
+
+
+def _generic_validator_cls(validator: AnyCallable, sig: 'Signature', args: Set[str]) -> 'ValidatorCallable':
+    # assume the first argument is value
+    has_kwargs = False
+    if 'kwargs' in args:
+        has_kwargs = True
+        args -= {'kwargs'}
+
+    if not args.issubset(all_kwargs):
+        raise ConfigError(
+            f'Invalid signature for validator {validator}: {sig}, should be: '
+            f'(cls, value, values, config, field), "values", "config" and "field" are all optional.'
+        )
+
+    if has_kwargs:
+        return lambda cls, v, values, field, config: validator(cls, v, values=values, field=field, config=config)
+    elif args == set():
+        return lambda cls, v, values, field, config: validator(cls, v)
+    elif args == {'values'}:
+        return lambda cls, v, values, field, config: validator(cls, v, values=values)
+    elif args == {'field'}:
+        return lambda cls, v, values, field, config: validator(cls, v, field=field)
+    elif args == {'config'}:
+        return lambda cls, v, values, field, config: validator(cls, v, config=config)
+    elif args == {'values', 'field'}:
+        return lambda cls, v, values, field, config: validator(cls, v, values=values, field=field)
+    elif args == {'values', 'config'}:
+        return lambda cls, v, values, field, config: validator(cls, v, values=values, config=config)
+    elif args == {'field', 'config'}:
+        return lambda cls, v, values, field, config: validator(cls, v, field=field, config=config)
+    else:
+        # args == {'values', 'field', 'config'}
+        return lambda cls, v, values, field, config: validator(cls, v, values=values, field=field, config=config)
+
+
+def _generic_validator_basic(validator: AnyCallable, sig: 'Signature', args: Set[str]) -> 'ValidatorCallable':
+    has_kwargs = False
+    if 'kwargs' in args:
+        has_kwargs = True
+        args -= {'kwargs'}
+
+    if not args.issubset(all_kwargs):
+        raise ConfigError(
+            f'Invalid signature for validator {validator}: {sig}, should be: '
+            f'(value, values, config, field), "values", "config" and "field" are all optional.'
+        )
+
+    if has_kwargs:
+        return lambda cls, v, values, field, config: validator(v, values=values, field=field, config=config)
+    elif args == set():
+        return lambda cls, v, values, field, config: validator(v)
+    elif args == {'values'}:
+        return lambda cls, v, values, field, config: validator(v, values=values)
+    elif args == {'field'}:
+        return lambda cls, v, values, field, config: validator(v, field=field)
+    elif args == {'config'}:
+        return lambda cls, v, values, field, config: validator(v, config=config)
+    elif args == {'values', 'field'}:
+        return lambda cls, v, values, field, config: validator(v, values=values, field=field)
+    elif args == {'values', 'config'}:
+        return lambda cls, v, values, field, config: validator(v, values=values, config=config)
+    elif args == {'field', 'config'}:
+        return lambda cls, v, values, field, config: validator(v, field=field, config=config)
+    else:
+        # args == {'values', 'field', 'config'}
+        return lambda cls, v, values, field, config: validator(v, values=values, field=field, config=config)
+
+
+def gather_all_validators(type_: 'ModelOrDc') -> Dict[str, 'AnyClassMethod']:
+    all_attributes = ChainMap(*[cls.__dict__ for cls in type_.__mro__])  # type: ignore[arg-type,var-annotated]
+    return {
+        k: v
+        for k, v in all_attributes.items()
+        if hasattr(v, VALIDATOR_CONFIG_KEY) or hasattr(v, ROOT_VALIDATOR_CONFIG_KEY)
+    }
diff --git a/lib/pydantic/v1/color.py b/lib/pydantic/v1/color.py
new file mode 100644
index 00000000..6fdc9fb1
--- /dev/null
+++ b/lib/pydantic/v1/color.py
@@ -0,0 +1,494 @@
+"""
+Color definitions are  used as per CSS3 specification:
+http://www.w3.org/TR/css3-color/#svg-color
+
+A few colors have multiple names referring to the sames colors, eg. `grey` and `gray` or `aqua` and `cyan`.
+
+In these cases the LAST color when sorted alphabetically takes preferences,
+eg. Color((0, 255, 255)).as_named() == 'cyan' because "cyan" comes after "aqua".
+"""
+import math
+import re
+from colorsys import hls_to_rgb, rgb_to_hls
+from typing import TYPE_CHECKING, Any, Dict, Optional, Tuple, Union, cast
+
+from .errors import ColorError
+from .utils import Representation, almost_equal_floats
+
+if TYPE_CHECKING:
+    from .typing import CallableGenerator, ReprArgs
+
+ColorTuple = Union[Tuple[int, int, int], Tuple[int, int, int, float]]
+ColorType = Union[ColorTuple, str]
+HslColorTuple = Union[Tuple[float, float, float], Tuple[float, float, float, float]]
+
+
+class RGBA:
+    """
+    Internal use only as a representation of a color.
+    """
+
+    __slots__ = 'r', 'g', 'b', 'alpha', '_tuple'
+
+    def __init__(self, r: float, g: float, b: float, alpha: Optional[float]):
+        self.r = r
+        self.g = g
+        self.b = b
+        self.alpha = alpha
+
+        self._tuple: Tuple[float, float, float, Optional[float]] = (r, g, b, alpha)
+
+    def __getitem__(self, item: Any) -> Any:
+        return self._tuple[item]
+
+
+# these are not compiled here to avoid import slowdown, they'll be compiled the first time they're used, then cached
+r_hex_short = r'\s*(?:#|0x)?([0-9a-f])([0-9a-f])([0-9a-f])([0-9a-f])?\s*'
+r_hex_long = r'\s*(?:#|0x)?([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})?\s*'
+_r_255 = r'(\d{1,3}(?:\.\d+)?)'
+_r_comma = r'\s*,\s*'
+r_rgb = fr'\s*rgb\(\s*{_r_255}{_r_comma}{_r_255}{_r_comma}{_r_255}\)\s*'
+_r_alpha = r'(\d(?:\.\d+)?|\.\d+|\d{1,2}%)'
+r_rgba = fr'\s*rgba\(\s*{_r_255}{_r_comma}{_r_255}{_r_comma}{_r_255}{_r_comma}{_r_alpha}\s*\)\s*'
+_r_h = r'(-?\d+(?:\.\d+)?|-?\.\d+)(deg|rad|turn)?'
+_r_sl = r'(\d{1,3}(?:\.\d+)?)%'
+r_hsl = fr'\s*hsl\(\s*{_r_h}{_r_comma}{_r_sl}{_r_comma}{_r_sl}\s*\)\s*'
+r_hsla = fr'\s*hsl\(\s*{_r_h}{_r_comma}{_r_sl}{_r_comma}{_r_sl}{_r_comma}{_r_alpha}\s*\)\s*'
+
+# colors where the two hex characters are the same, if all colors match this the short version of hex colors can be used
+repeat_colors = {int(c * 2, 16) for c in '0123456789abcdef'}
+rads = 2 * math.pi
+
+
+class Color(Representation):
+    __slots__ = '_original', '_rgba'
+
+    def __init__(self, value: ColorType) -> None:
+        self._rgba: RGBA
+        self._original: ColorType
+        if isinstance(value, (tuple, list)):
+            self._rgba = parse_tuple(value)
+        elif isinstance(value, str):
+            self._rgba = parse_str(value)
+        elif isinstance(value, Color):
+            self._rgba = value._rgba
+            value = value._original
+        else:
+            raise ColorError(reason='value must be a tuple, list or string')
+
+        # if we've got here value must be a valid color
+        self._original = value
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        field_schema.update(type='string', format='color')
+
+    def original(self) -> ColorType:
+        """
+        Original value passed to Color
+        """
+        return self._original
+
+    def as_named(self, *, fallback: bool = False) -> str:
+        if self._rgba.alpha is None:
+            rgb = cast(Tuple[int, int, int], self.as_rgb_tuple())
+            try:
+                return COLORS_BY_VALUE[rgb]
+            except KeyError as e:
+                if fallback:
+                    return self.as_hex()
+                else:
+                    raise ValueError('no named color found, use fallback=True, as_hex() or as_rgb()') from e
+        else:
+            return self.as_hex()
+
+    def as_hex(self) -> str:
+        """
+        Hex string representing the color can be 3, 4, 6 or 8 characters depending on whether the string
+        a "short" representation of the color is possible and whether there's an alpha channel.
+        """
+        values = [float_to_255(c) for c in self._rgba[:3]]
+        if self._rgba.alpha is not None:
+            values.append(float_to_255(self._rgba.alpha))
+
+        as_hex = ''.join(f'{v:02x}' for v in values)
+        if all(c in repeat_colors for c in values):
+            as_hex = ''.join(as_hex[c] for c in range(0, len(as_hex), 2))
+        return '#' + as_hex
+
+    def as_rgb(self) -> str:
+        """
+        Color as an rgb(<r>, <g>, <b>) or rgba(<r>, <g>, <b>, <a>) string.
+        """
+        if self._rgba.alpha is None:
+            return f'rgb({float_to_255(self._rgba.r)}, {float_to_255(self._rgba.g)}, {float_to_255(self._rgba.b)})'
+        else:
+            return (
+                f'rgba({float_to_255(self._rgba.r)}, {float_to_255(self._rgba.g)}, {float_to_255(self._rgba.b)}, '
+                f'{round(self._alpha_float(), 2)})'
+            )
+
+    def as_rgb_tuple(self, *, alpha: Optional[bool] = None) -> ColorTuple:
+        """
+        Color as an RGB or RGBA tuple; red, green and blue are in the range 0 to 255, alpha if included is
+        in the range 0 to 1.
+
+        :param alpha: whether to include the alpha channel, options are
+          None - (default) include alpha only if it's set (e.g. not None)
+          True - always include alpha,
+          False - always omit alpha,
+        """
+        r, g, b = (float_to_255(c) for c in self._rgba[:3])
+        if alpha is None:
+            if self._rgba.alpha is None:
+                return r, g, b
+            else:
+                return r, g, b, self._alpha_float()
+        elif alpha:
+            return r, g, b, self._alpha_float()
+        else:
+            # alpha is False
+            return r, g, b
+
+    def as_hsl(self) -> str:
+        """
+        Color as an hsl(<h>, <s>, <l>) or hsl(<h>, <s>, <l>, <a>) string.
+        """
+        if self._rgba.alpha is None:
+            h, s, li = self.as_hsl_tuple(alpha=False)  # type: ignore
+            return f'hsl({h * 360:0.0f}, {s:0.0%}, {li:0.0%})'
+        else:
+            h, s, li, a = self.as_hsl_tuple(alpha=True)  # type: ignore
+            return f'hsl({h * 360:0.0f}, {s:0.0%}, {li:0.0%}, {round(a, 2)})'
+
+    def as_hsl_tuple(self, *, alpha: Optional[bool] = None) -> HslColorTuple:
+        """
+        Color as an HSL or HSLA tuple, e.g. hue, saturation, lightness and optionally alpha; all elements are in
+        the range 0 to 1.
+
+        NOTE: this is HSL as used in HTML and most other places, not HLS as used in python's colorsys.
+
+        :param alpha: whether to include the alpha channel, options are
+          None - (default) include alpha only if it's set (e.g. not None)
+          True - always include alpha,
+          False - always omit alpha,
+        """
+        h, l, s = rgb_to_hls(self._rgba.r, self._rgba.g, self._rgba.b)
+        if alpha is None:
+            if self._rgba.alpha is None:
+                return h, s, l
+            else:
+                return h, s, l, self._alpha_float()
+        if alpha:
+            return h, s, l, self._alpha_float()
+        else:
+            # alpha is False
+            return h, s, l
+
+    def _alpha_float(self) -> float:
+        return 1 if self._rgba.alpha is None else self._rgba.alpha
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield cls
+
+    def __str__(self) -> str:
+        return self.as_named(fallback=True)
+
+    def __repr_args__(self) -> 'ReprArgs':
+        return [(None, self.as_named(fallback=True))] + [('rgb', self.as_rgb_tuple())]  # type: ignore
+
+    def __eq__(self, other: Any) -> bool:
+        return isinstance(other, Color) and self.as_rgb_tuple() == other.as_rgb_tuple()
+
+    def __hash__(self) -> int:
+        return hash(self.as_rgb_tuple())
+
+
+def parse_tuple(value: Tuple[Any, ...]) -> RGBA:
+    """
+    Parse a tuple or list as a color.
+    """
+    if len(value) == 3:
+        r, g, b = (parse_color_value(v) for v in value)
+        return RGBA(r, g, b, None)
+    elif len(value) == 4:
+        r, g, b = (parse_color_value(v) for v in value[:3])
+        return RGBA(r, g, b, parse_float_alpha(value[3]))
+    else:
+        raise ColorError(reason='tuples must have length 3 or 4')
+
+
+def parse_str(value: str) -> RGBA:
+    """
+    Parse a string to an RGBA tuple, trying the following formats (in this order):
+    * named color, see COLORS_BY_NAME below
+    * hex short eg. `<prefix>fff` (prefix can be `#`, `0x` or nothing)
+    * hex long eg. `<prefix>ffffff` (prefix can be `#`, `0x` or nothing)
+    * `rgb(<r>, <g>, <b>) `
+    * `rgba(<r>, <g>, <b>, <a>)`
+    """
+    value_lower = value.lower()
+    try:
+        r, g, b = COLORS_BY_NAME[value_lower]
+    except KeyError:
+        pass
+    else:
+        return ints_to_rgba(r, g, b, None)
+
+    m = re.fullmatch(r_hex_short, value_lower)
+    if m:
+        *rgb, a = m.groups()
+        r, g, b = (int(v * 2, 16) for v in rgb)
+        if a:
+            alpha: Optional[float] = int(a * 2, 16) / 255
+        else:
+            alpha = None
+        return ints_to_rgba(r, g, b, alpha)
+
+    m = re.fullmatch(r_hex_long, value_lower)
+    if m:
+        *rgb, a = m.groups()
+        r, g, b = (int(v, 16) for v in rgb)
+        if a:
+            alpha = int(a, 16) / 255
+        else:
+            alpha = None
+        return ints_to_rgba(r, g, b, alpha)
+
+    m = re.fullmatch(r_rgb, value_lower)
+    if m:
+        return ints_to_rgba(*m.groups(), None)  # type: ignore
+
+    m = re.fullmatch(r_rgba, value_lower)
+    if m:
+        return ints_to_rgba(*m.groups())  # type: ignore
+
+    m = re.fullmatch(r_hsl, value_lower)
+    if m:
+        h, h_units, s, l_ = m.groups()
+        return parse_hsl(h, h_units, s, l_)
+
+    m = re.fullmatch(r_hsla, value_lower)
+    if m:
+        h, h_units, s, l_, a = m.groups()
+        return parse_hsl(h, h_units, s, l_, parse_float_alpha(a))
+
+    raise ColorError(reason='string not recognised as a valid color')
+
+
+def ints_to_rgba(r: Union[int, str], g: Union[int, str], b: Union[int, str], alpha: Optional[float]) -> RGBA:
+    return RGBA(parse_color_value(r), parse_color_value(g), parse_color_value(b), parse_float_alpha(alpha))
+
+
+def parse_color_value(value: Union[int, str], max_val: int = 255) -> float:
+    """
+    Parse a value checking it's a valid int in the range 0 to max_val and divide by max_val to give a number
+    in the range 0 to 1
+    """
+    try:
+        color = float(value)
+    except ValueError:
+        raise ColorError(reason='color values must be a valid number')
+    if 0 <= color <= max_val:
+        return color / max_val
+    else:
+        raise ColorError(reason=f'color values must be in the range 0 to {max_val}')
+
+
+def parse_float_alpha(value: Union[None, str, float, int]) -> Optional[float]:
+    """
+    Parse a value checking it's a valid float in the range 0 to 1
+    """
+    if value is None:
+        return None
+    try:
+        if isinstance(value, str) and value.endswith('%'):
+            alpha = float(value[:-1]) / 100
+        else:
+            alpha = float(value)
+    except ValueError:
+        raise ColorError(reason='alpha values must be a valid float')
+
+    if almost_equal_floats(alpha, 1):
+        return None
+    elif 0 <= alpha <= 1:
+        return alpha
+    else:
+        raise ColorError(reason='alpha values must be in the range 0 to 1')
+
+
+def parse_hsl(h: str, h_units: str, sat: str, light: str, alpha: Optional[float] = None) -> RGBA:
+    """
+    Parse raw hue, saturation, lightness and alpha values and convert to RGBA.
+    """
+    s_value, l_value = parse_color_value(sat, 100), parse_color_value(light, 100)
+
+    h_value = float(h)
+    if h_units in {None, 'deg'}:
+        h_value = h_value % 360 / 360
+    elif h_units == 'rad':
+        h_value = h_value % rads / rads
+    else:
+        # turns
+        h_value = h_value % 1
+
+    r, g, b = hls_to_rgb(h_value, l_value, s_value)
+    return RGBA(r, g, b, alpha)
+
+
+def float_to_255(c: float) -> int:
+    return int(round(c * 255))
+
+
+COLORS_BY_NAME = {
+    'aliceblue': (240, 248, 255),
+    'antiquewhite': (250, 235, 215),
+    'aqua': (0, 255, 255),
+    'aquamarine': (127, 255, 212),
+    'azure': (240, 255, 255),
+    'beige': (245, 245, 220),
+    'bisque': (255, 228, 196),
+    'black': (0, 0, 0),
+    'blanchedalmond': (255, 235, 205),
+    'blue': (0, 0, 255),
+    'blueviolet': (138, 43, 226),
+    'brown': (165, 42, 42),
+    'burlywood': (222, 184, 135),
+    'cadetblue': (95, 158, 160),
+    'chartreuse': (127, 255, 0),
+    'chocolate': (210, 105, 30),
+    'coral': (255, 127, 80),
+    'cornflowerblue': (100, 149, 237),
+    'cornsilk': (255, 248, 220),
+    'crimson': (220, 20, 60),
+    'cyan': (0, 255, 255),
+    'darkblue': (0, 0, 139),
+    'darkcyan': (0, 139, 139),
+    'darkgoldenrod': (184, 134, 11),
+    'darkgray': (169, 169, 169),
+    'darkgreen': (0, 100, 0),
+    'darkgrey': (169, 169, 169),
+    'darkkhaki': (189, 183, 107),
+    'darkmagenta': (139, 0, 139),
+    'darkolivegreen': (85, 107, 47),
+    'darkorange': (255, 140, 0),
+    'darkorchid': (153, 50, 204),
+    'darkred': (139, 0, 0),
+    'darksalmon': (233, 150, 122),
+    'darkseagreen': (143, 188, 143),
+    'darkslateblue': (72, 61, 139),
+    'darkslategray': (47, 79, 79),
+    'darkslategrey': (47, 79, 79),
+    'darkturquoise': (0, 206, 209),
+    'darkviolet': (148, 0, 211),
+    'deeppink': (255, 20, 147),
+    'deepskyblue': (0, 191, 255),
+    'dimgray': (105, 105, 105),
+    'dimgrey': (105, 105, 105),
+    'dodgerblue': (30, 144, 255),
+    'firebrick': (178, 34, 34),
+    'floralwhite': (255, 250, 240),
+    'forestgreen': (34, 139, 34),
+    'fuchsia': (255, 0, 255),
+    'gainsboro': (220, 220, 220),
+    'ghostwhite': (248, 248, 255),
+    'gold': (255, 215, 0),
+    'goldenrod': (218, 165, 32),
+    'gray': (128, 128, 128),
+    'green': (0, 128, 0),
+    'greenyellow': (173, 255, 47),
+    'grey': (128, 128, 128),
+    'honeydew': (240, 255, 240),
+    'hotpink': (255, 105, 180),
+    'indianred': (205, 92, 92),
+    'indigo': (75, 0, 130),
+    'ivory': (255, 255, 240),
+    'khaki': (240, 230, 140),
+    'lavender': (230, 230, 250),
+    'lavenderblush': (255, 240, 245),
+    'lawngreen': (124, 252, 0),
+    'lemonchiffon': (255, 250, 205),
+    'lightblue': (173, 216, 230),
+    'lightcoral': (240, 128, 128),
+    'lightcyan': (224, 255, 255),
+    'lightgoldenrodyellow': (250, 250, 210),
+    'lightgray': (211, 211, 211),
+    'lightgreen': (144, 238, 144),
+    'lightgrey': (211, 211, 211),
+    'lightpink': (255, 182, 193),
+    'lightsalmon': (255, 160, 122),
+    'lightseagreen': (32, 178, 170),
+    'lightskyblue': (135, 206, 250),
+    'lightslategray': (119, 136, 153),
+    'lightslategrey': (119, 136, 153),
+    'lightsteelblue': (176, 196, 222),
+    'lightyellow': (255, 255, 224),
+    'lime': (0, 255, 0),
+    'limegreen': (50, 205, 50),
+    'linen': (250, 240, 230),
+    'magenta': (255, 0, 255),
+    'maroon': (128, 0, 0),
+    'mediumaquamarine': (102, 205, 170),
+    'mediumblue': (0, 0, 205),
+    'mediumorchid': (186, 85, 211),
+    'mediumpurple': (147, 112, 219),
+    'mediumseagreen': (60, 179, 113),
+    'mediumslateblue': (123, 104, 238),
+    'mediumspringgreen': (0, 250, 154),
+    'mediumturquoise': (72, 209, 204),
+    'mediumvioletred': (199, 21, 133),
+    'midnightblue': (25, 25, 112),
+    'mintcream': (245, 255, 250),
+    'mistyrose': (255, 228, 225),
+    'moccasin': (255, 228, 181),
+    'navajowhite': (255, 222, 173),
+    'navy': (0, 0, 128),
+    'oldlace': (253, 245, 230),
+    'olive': (128, 128, 0),
+    'olivedrab': (107, 142, 35),
+    'orange': (255, 165, 0),
+    'orangered': (255, 69, 0),
+    'orchid': (218, 112, 214),
+    'palegoldenrod': (238, 232, 170),
+    'palegreen': (152, 251, 152),
+    'paleturquoise': (175, 238, 238),
+    'palevioletred': (219, 112, 147),
+    'papayawhip': (255, 239, 213),
+    'peachpuff': (255, 218, 185),
+    'peru': (205, 133, 63),
+    'pink': (255, 192, 203),
+    'plum': (221, 160, 221),
+    'powderblue': (176, 224, 230),
+    'purple': (128, 0, 128),
+    'red': (255, 0, 0),
+    'rosybrown': (188, 143, 143),
+    'royalblue': (65, 105, 225),
+    'saddlebrown': (139, 69, 19),
+    'salmon': (250, 128, 114),
+    'sandybrown': (244, 164, 96),
+    'seagreen': (46, 139, 87),
+    'seashell': (255, 245, 238),
+    'sienna': (160, 82, 45),
+    'silver': (192, 192, 192),
+    'skyblue': (135, 206, 235),
+    'slateblue': (106, 90, 205),
+    'slategray': (112, 128, 144),
+    'slategrey': (112, 128, 144),
+    'snow': (255, 250, 250),
+    'springgreen': (0, 255, 127),
+    'steelblue': (70, 130, 180),
+    'tan': (210, 180, 140),
+    'teal': (0, 128, 128),
+    'thistle': (216, 191, 216),
+    'tomato': (255, 99, 71),
+    'turquoise': (64, 224, 208),
+    'violet': (238, 130, 238),
+    'wheat': (245, 222, 179),
+    'white': (255, 255, 255),
+    'whitesmoke': (245, 245, 245),
+    'yellow': (255, 255, 0),
+    'yellowgreen': (154, 205, 50),
+}
+
+COLORS_BY_VALUE = {v: k for k, v in COLORS_BY_NAME.items()}
diff --git a/lib/pydantic/v1/config.py b/lib/pydantic/v1/config.py
new file mode 100644
index 00000000..a25973af
--- /dev/null
+++ b/lib/pydantic/v1/config.py
@@ -0,0 +1,191 @@
+import json
+from enum import Enum
+from typing import TYPE_CHECKING, Any, Callable, Dict, ForwardRef, Optional, Tuple, Type, Union
+
+from typing_extensions import Literal, Protocol
+
+from .typing import AnyArgTCallable, AnyCallable
+from .utils import GetterDict
+from .version import compiled
+
+if TYPE_CHECKING:
+    from typing import overload
+
+    from .fields import ModelField
+    from .main import BaseModel
+
+    ConfigType = Type['BaseConfig']
+
+    class SchemaExtraCallable(Protocol):
+        @overload
+        def __call__(self, schema: Dict[str, Any]) -> None:
+            pass
+
+        @overload
+        def __call__(self, schema: Dict[str, Any], model_class: Type[BaseModel]) -> None:
+            pass
+
+else:
+    SchemaExtraCallable = Callable[..., None]
+
+__all__ = 'BaseConfig', 'ConfigDict', 'get_config', 'Extra', 'inherit_config', 'prepare_config'
+
+
+class Extra(str, Enum):
+    allow = 'allow'
+    ignore = 'ignore'
+    forbid = 'forbid'
+
+
+# https://github.com/cython/cython/issues/4003
+# Fixed in Cython 3 and Pydantic v1 won't support Cython 3.
+# Pydantic v2 doesn't depend on Cython at all.
+if not compiled:
+    from typing_extensions import TypedDict
+
+    class ConfigDict(TypedDict, total=False):
+        title: Optional[str]
+        anystr_lower: bool
+        anystr_strip_whitespace: bool
+        min_anystr_length: int
+        max_anystr_length: Optional[int]
+        validate_all: bool
+        extra: Extra
+        allow_mutation: bool
+        frozen: bool
+        allow_population_by_field_name: bool
+        use_enum_values: bool
+        fields: Dict[str, Union[str, Dict[str, str]]]
+        validate_assignment: bool
+        error_msg_templates: Dict[str, str]
+        arbitrary_types_allowed: bool
+        orm_mode: bool
+        getter_dict: Type[GetterDict]
+        alias_generator: Optional[Callable[[str], str]]
+        keep_untouched: Tuple[type, ...]
+        schema_extra: Union[Dict[str, object], 'SchemaExtraCallable']
+        json_loads: Callable[[str], object]
+        json_dumps: AnyArgTCallable[str]
+        json_encoders: Dict[Type[object], AnyCallable]
+        underscore_attrs_are_private: bool
+        allow_inf_nan: bool
+        copy_on_model_validation: Literal['none', 'deep', 'shallow']
+        # whether dataclass `__post_init__` should be run after validation
+        post_init_call: Literal['before_validation', 'after_validation']
+
+else:
+    ConfigDict = dict  # type: ignore
+
+
+class BaseConfig:
+    title: Optional[str] = None
+    anystr_lower: bool = False
+    anystr_upper: bool = False
+    anystr_strip_whitespace: bool = False
+    min_anystr_length: int = 0
+    max_anystr_length: Optional[int] = None
+    validate_all: bool = False
+    extra: Extra = Extra.ignore
+    allow_mutation: bool = True
+    frozen: bool = False
+    allow_population_by_field_name: bool = False
+    use_enum_values: bool = False
+    fields: Dict[str, Union[str, Dict[str, str]]] = {}
+    validate_assignment: bool = False
+    error_msg_templates: Dict[str, str] = {}
+    arbitrary_types_allowed: bool = False
+    orm_mode: bool = False
+    getter_dict: Type[GetterDict] = GetterDict
+    alias_generator: Optional[Callable[[str], str]] = None
+    keep_untouched: Tuple[type, ...] = ()
+    schema_extra: Union[Dict[str, Any], 'SchemaExtraCallable'] = {}
+    json_loads: Callable[[str], Any] = json.loads
+    json_dumps: Callable[..., str] = json.dumps
+    json_encoders: Dict[Union[Type[Any], str, ForwardRef], AnyCallable] = {}
+    underscore_attrs_are_private: bool = False
+    allow_inf_nan: bool = True
+
+    # whether inherited models as fields should be reconstructed as base model,
+    # and whether such a copy should be shallow or deep
+    copy_on_model_validation: Literal['none', 'deep', 'shallow'] = 'shallow'
+
+    # whether `Union` should check all allowed types before even trying to coerce
+    smart_union: bool = False
+    # whether dataclass `__post_init__` should be run before or after validation
+    post_init_call: Literal['before_validation', 'after_validation'] = 'before_validation'
+
+    @classmethod
+    def get_field_info(cls, name: str) -> Dict[str, Any]:
+        """
+        Get properties of FieldInfo from the `fields` property of the config class.
+        """
+
+        fields_value = cls.fields.get(name)
+
+        if isinstance(fields_value, str):
+            field_info: Dict[str, Any] = {'alias': fields_value}
+        elif isinstance(fields_value, dict):
+            field_info = fields_value
+        else:
+            field_info = {}
+
+        if 'alias' in field_info:
+            field_info.setdefault('alias_priority', 2)
+
+        if field_info.get('alias_priority', 0) <= 1 and cls.alias_generator:
+            alias = cls.alias_generator(name)
+            if not isinstance(alias, str):
+                raise TypeError(f'Config.alias_generator must return str, not {alias.__class__}')
+            field_info.update(alias=alias, alias_priority=1)
+        return field_info
+
+    @classmethod
+    def prepare_field(cls, field: 'ModelField') -> None:
+        """
+        Optional hook to check or modify fields during model creation.
+        """
+        pass
+
+
+def get_config(config: Union[ConfigDict, Type[object], None]) -> Type[BaseConfig]:
+    if config is None:
+        return BaseConfig
+
+    else:
+        config_dict = (
+            config
+            if isinstance(config, dict)
+            else {k: getattr(config, k) for k in dir(config) if not k.startswith('__')}
+        )
+
+        class Config(BaseConfig):
+            ...
+
+        for k, v in config_dict.items():
+            setattr(Config, k, v)
+        return Config
+
+
+def inherit_config(self_config: 'ConfigType', parent_config: 'ConfigType', **namespace: Any) -> 'ConfigType':
+    if not self_config:
+        base_classes: Tuple['ConfigType', ...] = (parent_config,)
+    elif self_config == parent_config:
+        base_classes = (self_config,)
+    else:
+        base_classes = self_config, parent_config
+
+    namespace['json_encoders'] = {
+        **getattr(parent_config, 'json_encoders', {}),
+        **getattr(self_config, 'json_encoders', {}),
+        **namespace.get('json_encoders', {}),
+    }
+
+    return type('Config', base_classes, namespace)
+
+
+def prepare_config(config: Type[BaseConfig], cls_name: str) -> None:
+    if not isinstance(config.extra, Extra):
+        try:
+            config.extra = Extra(config.extra)
+        except ValueError:
+            raise ValueError(f'"{cls_name}": {config.extra} is not a valid value for "extra"')
diff --git a/lib/pydantic/v1/dataclasses.py b/lib/pydantic/v1/dataclasses.py
new file mode 100644
index 00000000..2df3987a
--- /dev/null
+++ b/lib/pydantic/v1/dataclasses.py
@@ -0,0 +1,500 @@
+"""
+The main purpose is to enhance stdlib dataclasses by adding validation
+A pydantic dataclass can be generated from scratch or from a stdlib one.
+
+Behind the scene, a pydantic dataclass is just like a regular one on which we attach
+a `BaseModel` and magic methods to trigger the validation of the data.
+`__init__` and `__post_init__` are hence overridden and have extra logic to be
+able to validate input data.
+
+When a pydantic dataclass is generated from scratch, it's just a plain dataclass
+with validation triggered at initialization
+
+The tricky part if for stdlib dataclasses that are converted after into pydantic ones e.g.
+
+```py
+@dataclasses.dataclass
+class M:
+    x: int
+
+ValidatedM = pydantic.dataclasses.dataclass(M)
+```
+
+We indeed still want to support equality, hashing, repr, ... as if it was the stdlib one!
+
+```py
+assert isinstance(ValidatedM(x=1), M)
+assert ValidatedM(x=1) == M(x=1)
+```
+
+This means we **don't want to create a new dataclass that inherits from it**
+The trick is to create a wrapper around `M` that will act as a proxy to trigger
+validation without altering default `M` behaviour.
+"""
+import copy
+import dataclasses
+import sys
+from contextlib import contextmanager
+from functools import wraps
+
+try:
+    from functools import cached_property
+except ImportError:
+    # cached_property available only for python3.8+
+    pass
+
+from typing import TYPE_CHECKING, Any, Callable, ClassVar, Dict, Generator, Optional, Type, TypeVar, Union, overload
+
+from typing_extensions import dataclass_transform
+
+from .class_validators import gather_all_validators
+from .config import BaseConfig, ConfigDict, Extra, get_config
+from .error_wrappers import ValidationError
+from .errors import DataclassTypeError
+from .fields import Field, FieldInfo, Required, Undefined
+from .main import create_model, validate_model
+from .utils import ClassAttribute
+
+if TYPE_CHECKING:
+    from .main import BaseModel
+    from .typing import CallableGenerator, NoArgAnyCallable
+
+    DataclassT = TypeVar('DataclassT', bound='Dataclass')
+
+    DataclassClassOrWrapper = Union[Type['Dataclass'], 'DataclassProxy']
+
+    class Dataclass:
+        # stdlib attributes
+        __dataclass_fields__: ClassVar[Dict[str, Any]]
+        __dataclass_params__: ClassVar[Any]  # in reality `dataclasses._DataclassParams`
+        __post_init__: ClassVar[Callable[..., None]]
+
+        # Added by pydantic
+        __pydantic_run_validation__: ClassVar[bool]
+        __post_init_post_parse__: ClassVar[Callable[..., None]]
+        __pydantic_initialised__: ClassVar[bool]
+        __pydantic_model__: ClassVar[Type[BaseModel]]
+        __pydantic_validate_values__: ClassVar[Callable[['Dataclass'], None]]
+        __pydantic_has_field_info_default__: ClassVar[bool]  # whether a `pydantic.Field` is used as default value
+
+        def __init__(self, *args: object, **kwargs: object) -> None:
+            pass
+
+        @classmethod
+        def __get_validators__(cls: Type['Dataclass']) -> 'CallableGenerator':
+            pass
+
+        @classmethod
+        def __validate__(cls: Type['DataclassT'], v: Any) -> 'DataclassT':
+            pass
+
+
+__all__ = [
+    'dataclass',
+    'set_validation',
+    'create_pydantic_model_from_dataclass',
+    'is_builtin_dataclass',
+    'make_dataclass_validator',
+]
+
+_T = TypeVar('_T')
+
+if sys.version_info >= (3, 10):
+
+    @dataclass_transform(field_specifiers=(dataclasses.field, Field))
+    @overload
+    def dataclass(
+        *,
+        init: bool = True,
+        repr: bool = True,
+        eq: bool = True,
+        order: bool = False,
+        unsafe_hash: bool = False,
+        frozen: bool = False,
+        config: Union[ConfigDict, Type[object], None] = None,
+        validate_on_init: Optional[bool] = None,
+        use_proxy: Optional[bool] = None,
+        kw_only: bool = ...,
+    ) -> Callable[[Type[_T]], 'DataclassClassOrWrapper']:
+        ...
+
+    @dataclass_transform(field_specifiers=(dataclasses.field, Field))
+    @overload
+    def dataclass(
+        _cls: Type[_T],
+        *,
+        init: bool = True,
+        repr: bool = True,
+        eq: bool = True,
+        order: bool = False,
+        unsafe_hash: bool = False,
+        frozen: bool = False,
+        config: Union[ConfigDict, Type[object], None] = None,
+        validate_on_init: Optional[bool] = None,
+        use_proxy: Optional[bool] = None,
+        kw_only: bool = ...,
+    ) -> 'DataclassClassOrWrapper':
+        ...
+
+else:
+
+    @dataclass_transform(field_specifiers=(dataclasses.field, Field))
+    @overload
+    def dataclass(
+        *,
+        init: bool = True,
+        repr: bool = True,
+        eq: bool = True,
+        order: bool = False,
+        unsafe_hash: bool = False,
+        frozen: bool = False,
+        config: Union[ConfigDict, Type[object], None] = None,
+        validate_on_init: Optional[bool] = None,
+        use_proxy: Optional[bool] = None,
+    ) -> Callable[[Type[_T]], 'DataclassClassOrWrapper']:
+        ...
+
+    @dataclass_transform(field_specifiers=(dataclasses.field, Field))
+    @overload
+    def dataclass(
+        _cls: Type[_T],
+        *,
+        init: bool = True,
+        repr: bool = True,
+        eq: bool = True,
+        order: bool = False,
+        unsafe_hash: bool = False,
+        frozen: bool = False,
+        config: Union[ConfigDict, Type[object], None] = None,
+        validate_on_init: Optional[bool] = None,
+        use_proxy: Optional[bool] = None,
+    ) -> 'DataclassClassOrWrapper':
+        ...
+
+
+@dataclass_transform(field_specifiers=(dataclasses.field, Field))
+def dataclass(
+    _cls: Optional[Type[_T]] = None,
+    *,
+    init: bool = True,
+    repr: bool = True,
+    eq: bool = True,
+    order: bool = False,
+    unsafe_hash: bool = False,
+    frozen: bool = False,
+    config: Union[ConfigDict, Type[object], None] = None,
+    validate_on_init: Optional[bool] = None,
+    use_proxy: Optional[bool] = None,
+    kw_only: bool = False,
+) -> Union[Callable[[Type[_T]], 'DataclassClassOrWrapper'], 'DataclassClassOrWrapper']:
+    """
+    Like the python standard lib dataclasses but with type validation.
+    The result is either a pydantic dataclass that will validate input data
+    or a wrapper that will trigger validation around a stdlib dataclass
+    to avoid modifying it directly
+    """
+    the_config = get_config(config)
+
+    def wrap(cls: Type[Any]) -> 'DataclassClassOrWrapper':
+        should_use_proxy = (
+            use_proxy
+            if use_proxy is not None
+            else (
+                is_builtin_dataclass(cls)
+                and (cls.__bases__[0] is object or set(dir(cls)) == set(dir(cls.__bases__[0])))
+            )
+        )
+        if should_use_proxy:
+            dc_cls_doc = ''
+            dc_cls = DataclassProxy(cls)
+            default_validate_on_init = False
+        else:
+            dc_cls_doc = cls.__doc__ or ''  # needs to be done before generating dataclass
+            if sys.version_info >= (3, 10):
+                dc_cls = dataclasses.dataclass(
+                    cls,
+                    init=init,
+                    repr=repr,
+                    eq=eq,
+                    order=order,
+                    unsafe_hash=unsafe_hash,
+                    frozen=frozen,
+                    kw_only=kw_only,
+                )
+            else:
+                dc_cls = dataclasses.dataclass(  # type: ignore
+                    cls, init=init, repr=repr, eq=eq, order=order, unsafe_hash=unsafe_hash, frozen=frozen
+                )
+            default_validate_on_init = True
+
+        should_validate_on_init = default_validate_on_init if validate_on_init is None else validate_on_init
+        _add_pydantic_validation_attributes(cls, the_config, should_validate_on_init, dc_cls_doc)
+        dc_cls.__pydantic_model__.__try_update_forward_refs__(**{cls.__name__: cls})
+        return dc_cls
+
+    if _cls is None:
+        return wrap
+
+    return wrap(_cls)
+
+
+@contextmanager
+def set_validation(cls: Type['DataclassT'], value: bool) -> Generator[Type['DataclassT'], None, None]:
+    original_run_validation = cls.__pydantic_run_validation__
+    try:
+        cls.__pydantic_run_validation__ = value
+        yield cls
+    finally:
+        cls.__pydantic_run_validation__ = original_run_validation
+
+
+class DataclassProxy:
+    __slots__ = '__dataclass__'
+
+    def __init__(self, dc_cls: Type['Dataclass']) -> None:
+        object.__setattr__(self, '__dataclass__', dc_cls)
+
+    def __call__(self, *args: Any, **kwargs: Any) -> Any:
+        with set_validation(self.__dataclass__, True):
+            return self.__dataclass__(*args, **kwargs)
+
+    def __getattr__(self, name: str) -> Any:
+        return getattr(self.__dataclass__, name)
+
+    def __setattr__(self, __name: str, __value: Any) -> None:
+        return setattr(self.__dataclass__, __name, __value)
+
+    def __instancecheck__(self, instance: Any) -> bool:
+        return isinstance(instance, self.__dataclass__)
+
+    def __copy__(self) -> 'DataclassProxy':
+        return DataclassProxy(copy.copy(self.__dataclass__))
+
+    def __deepcopy__(self, memo: Any) -> 'DataclassProxy':
+        return DataclassProxy(copy.deepcopy(self.__dataclass__, memo))
+
+
+def _add_pydantic_validation_attributes(  # noqa: C901 (ignore complexity)
+    dc_cls: Type['Dataclass'],
+    config: Type[BaseConfig],
+    validate_on_init: bool,
+    dc_cls_doc: str,
+) -> None:
+    """
+    We need to replace the right method. If no `__post_init__` has been set in the stdlib dataclass
+    it won't even exist (code is generated on the fly by `dataclasses`)
+    By default, we run validation after `__init__` or `__post_init__` if defined
+    """
+    init = dc_cls.__init__
+
+    @wraps(init)
+    def handle_extra_init(self: 'Dataclass', *args: Any, **kwargs: Any) -> None:
+        if config.extra == Extra.ignore:
+            init(self, *args, **{k: v for k, v in kwargs.items() if k in self.__dataclass_fields__})
+
+        elif config.extra == Extra.allow:
+            for k, v in kwargs.items():
+                self.__dict__.setdefault(k, v)
+            init(self, *args, **{k: v for k, v in kwargs.items() if k in self.__dataclass_fields__})
+
+        else:
+            init(self, *args, **kwargs)
+
+    if hasattr(dc_cls, '__post_init__'):
+        try:
+            post_init = dc_cls.__post_init__.__wrapped__  # type: ignore[attr-defined]
+        except AttributeError:
+            post_init = dc_cls.__post_init__
+
+        @wraps(post_init)
+        def new_post_init(self: 'Dataclass', *args: Any, **kwargs: Any) -> None:
+            if config.post_init_call == 'before_validation':
+                post_init(self, *args, **kwargs)
+
+            if self.__class__.__pydantic_run_validation__:
+                self.__pydantic_validate_values__()
+                if hasattr(self, '__post_init_post_parse__'):
+                    self.__post_init_post_parse__(*args, **kwargs)
+
+            if config.post_init_call == 'after_validation':
+                post_init(self, *args, **kwargs)
+
+        setattr(dc_cls, '__init__', handle_extra_init)
+        setattr(dc_cls, '__post_init__', new_post_init)
+
+    else:
+
+        @wraps(init)
+        def new_init(self: 'Dataclass', *args: Any, **kwargs: Any) -> None:
+            handle_extra_init(self, *args, **kwargs)
+
+            if self.__class__.__pydantic_run_validation__:
+                self.__pydantic_validate_values__()
+
+            if hasattr(self, '__post_init_post_parse__'):
+                # We need to find again the initvars. To do that we use `__dataclass_fields__` instead of
+                # public method `dataclasses.fields`
+
+                # get all initvars and their default values
+                initvars_and_values: Dict[str, Any] = {}
+                for i, f in enumerate(self.__class__.__dataclass_fields__.values()):
+                    if f._field_type is dataclasses._FIELD_INITVAR:  # type: ignore[attr-defined]
+                        try:
+                            # set arg value by default
+                            initvars_and_values[f.name] = args[i]
+                        except IndexError:
+                            initvars_and_values[f.name] = kwargs.get(f.name, f.default)
+
+                self.__post_init_post_parse__(**initvars_and_values)
+
+        setattr(dc_cls, '__init__', new_init)
+
+    setattr(dc_cls, '__pydantic_run_validation__', ClassAttribute('__pydantic_run_validation__', validate_on_init))
+    setattr(dc_cls, '__pydantic_initialised__', False)
+    setattr(dc_cls, '__pydantic_model__', create_pydantic_model_from_dataclass(dc_cls, config, dc_cls_doc))
+    setattr(dc_cls, '__pydantic_validate_values__', _dataclass_validate_values)
+    setattr(dc_cls, '__validate__', classmethod(_validate_dataclass))
+    setattr(dc_cls, '__get_validators__', classmethod(_get_validators))
+
+    if dc_cls.__pydantic_model__.__config__.validate_assignment and not dc_cls.__dataclass_params__.frozen:
+        setattr(dc_cls, '__setattr__', _dataclass_validate_assignment_setattr)
+
+
+def _get_validators(cls: 'DataclassClassOrWrapper') -> 'CallableGenerator':
+    yield cls.__validate__
+
+
+def _validate_dataclass(cls: Type['DataclassT'], v: Any) -> 'DataclassT':
+    with set_validation(cls, True):
+        if isinstance(v, cls):
+            v.__pydantic_validate_values__()
+            return v
+        elif isinstance(v, (list, tuple)):
+            return cls(*v)
+        elif isinstance(v, dict):
+            return cls(**v)
+        else:
+            raise DataclassTypeError(class_name=cls.__name__)
+
+
+def create_pydantic_model_from_dataclass(
+    dc_cls: Type['Dataclass'],
+    config: Type[Any] = BaseConfig,
+    dc_cls_doc: Optional[str] = None,
+) -> Type['BaseModel']:
+    field_definitions: Dict[str, Any] = {}
+    for field in dataclasses.fields(dc_cls):
+        default: Any = Undefined
+        default_factory: Optional['NoArgAnyCallable'] = None
+        field_info: FieldInfo
+
+        if field.default is not dataclasses.MISSING:
+            default = field.default
+        elif field.default_factory is not dataclasses.MISSING:
+            default_factory = field.default_factory
+        else:
+            default = Required
+
+        if isinstance(default, FieldInfo):
+            field_info = default
+            dc_cls.__pydantic_has_field_info_default__ = True
+        else:
+            field_info = Field(default=default, default_factory=default_factory, **field.metadata)
+
+        field_definitions[field.name] = (field.type, field_info)
+
+    validators = gather_all_validators(dc_cls)
+    model: Type['BaseModel'] = create_model(
+        dc_cls.__name__,
+        __config__=config,
+        __module__=dc_cls.__module__,
+        __validators__=validators,
+        __cls_kwargs__={'__resolve_forward_refs__': False},
+        **field_definitions,
+    )
+    model.__doc__ = dc_cls_doc if dc_cls_doc is not None else dc_cls.__doc__ or ''
+    return model
+
+
+if sys.version_info >= (3, 8):
+
+    def _is_field_cached_property(obj: 'Dataclass', k: str) -> bool:
+        return isinstance(getattr(type(obj), k, None), cached_property)
+
+else:
+
+    def _is_field_cached_property(obj: 'Dataclass', k: str) -> bool:
+        return False
+
+
+def _dataclass_validate_values(self: 'Dataclass') -> None:
+    # validation errors can occur if this function is called twice on an already initialised dataclass.
+    # for example if Extra.forbid is enabled, it would consider __pydantic_initialised__ an invalid extra property
+    if getattr(self, '__pydantic_initialised__'):
+        return
+    if getattr(self, '__pydantic_has_field_info_default__', False):
+        # We need to remove `FieldInfo` values since they are not valid as input
+        # It's ok to do that because they are obviously the default values!
+        input_data = {
+            k: v
+            for k, v in self.__dict__.items()
+            if not (isinstance(v, FieldInfo) or _is_field_cached_property(self, k))
+        }
+    else:
+        input_data = {k: v for k, v in self.__dict__.items() if not _is_field_cached_property(self, k)}
+    d, _, validation_error = validate_model(self.__pydantic_model__, input_data, cls=self.__class__)
+    if validation_error:
+        raise validation_error
+    self.__dict__.update(d)
+    object.__setattr__(self, '__pydantic_initialised__', True)
+
+
+def _dataclass_validate_assignment_setattr(self: 'Dataclass', name: str, value: Any) -> None:
+    if self.__pydantic_initialised__:
+        d = dict(self.__dict__)
+        d.pop(name, None)
+        known_field = self.__pydantic_model__.__fields__.get(name, None)
+        if known_field:
+            value, error_ = known_field.validate(value, d, loc=name, cls=self.__class__)
+            if error_:
+                raise ValidationError([error_], self.__class__)
+
+    object.__setattr__(self, name, value)
+
+
+def is_builtin_dataclass(_cls: Type[Any]) -> bool:
+    """
+    Whether a class is a stdlib dataclass
+    (useful to discriminated a pydantic dataclass that is actually a wrapper around a stdlib dataclass)
+
+    we check that
+    - `_cls` is a dataclass
+    - `_cls` is not a processed pydantic dataclass (with a basemodel attached)
+    - `_cls` is not a pydantic dataclass inheriting directly from a stdlib dataclass
+    e.g.
+    ```
+    @dataclasses.dataclass
+    class A:
+        x: int
+
+    @pydantic.dataclasses.dataclass
+    class B(A):
+        y: int
+    ```
+    In this case, when we first check `B`, we make an extra check and look at the annotations ('y'),
+    which won't be a superset of all the dataclass fields (only the stdlib fields i.e. 'x')
+    """
+    return (
+        dataclasses.is_dataclass(_cls)
+        and not hasattr(_cls, '__pydantic_model__')
+        and set(_cls.__dataclass_fields__).issuperset(set(getattr(_cls, '__annotations__', {})))
+    )
+
+
+def make_dataclass_validator(dc_cls: Type['Dataclass'], config: Type[BaseConfig]) -> 'CallableGenerator':
+    """
+    Create a pydantic.dataclass from a builtin dataclass to add type validation
+    and yield the validators
+    It retrieves the parameters of the dataclass and forwards them to the newly created dataclass
+    """
+    yield from _get_validators(dataclass(dc_cls, config=config, use_proxy=True))
diff --git a/lib/pydantic/v1/datetime_parse.py b/lib/pydantic/v1/datetime_parse.py
new file mode 100644
index 00000000..cfd54593
--- /dev/null
+++ b/lib/pydantic/v1/datetime_parse.py
@@ -0,0 +1,248 @@
+"""
+Functions to parse datetime objects.
+
+We're using regular expressions rather than time.strptime because:
+- They provide both validation and parsing.
+- They're more flexible for datetimes.
+- The date/datetime/time constructors produce friendlier error messages.
+
+Stolen from https://raw.githubusercontent.com/django/django/main/django/utils/dateparse.py at
+9718fa2e8abe430c3526a9278dd976443d4ae3c6
+
+Changed to:
+* use standard python datetime types not django.utils.timezone
+* raise ValueError when regex doesn't match rather than returning None
+* support parsing unix timestamps for dates and datetimes
+"""
+import re
+from datetime import date, datetime, time, timedelta, timezone
+from typing import Dict, Optional, Type, Union
+
+from . import errors
+
+date_expr = r'(?P<year>\d{4})-(?P<month>\d{1,2})-(?P<day>\d{1,2})'
+time_expr = (
+    r'(?P<hour>\d{1,2}):(?P<minute>\d{1,2})'
+    r'(?::(?P<second>\d{1,2})(?:\.(?P<microsecond>\d{1,6})\d{0,6})?)?'
+    r'(?P<tzinfo>Z|[+-]\d{2}(?::?\d{2})?)?$'
+)
+
+date_re = re.compile(f'{date_expr}$')
+time_re = re.compile(time_expr)
+datetime_re = re.compile(f'{date_expr}[T ]{time_expr}')
+
+standard_duration_re = re.compile(
+    r'^'
+    r'(?:(?P<days>-?\d+) (days?, )?)?'
+    r'((?:(?P<hours>-?\d+):)(?=\d+:\d+))?'
+    r'(?:(?P<minutes>-?\d+):)?'
+    r'(?P<seconds>-?\d+)'
+    r'(?:\.(?P<microseconds>\d{1,6})\d{0,6})?'
+    r'$'
+)
+
+# Support the sections of ISO 8601 date representation that are accepted by timedelta
+iso8601_duration_re = re.compile(
+    r'^(?P<sign>[-+]?)'
+    r'P'
+    r'(?:(?P<days>\d+(.\d+)?)D)?'
+    r'(?:T'
+    r'(?:(?P<hours>\d+(.\d+)?)H)?'
+    r'(?:(?P<minutes>\d+(.\d+)?)M)?'
+    r'(?:(?P<seconds>\d+(.\d+)?)S)?'
+    r')?'
+    r'$'
+)
+
+EPOCH = datetime(1970, 1, 1)
+# if greater than this, the number is in ms, if less than or equal it's in seconds
+# (in seconds this is 11th October 2603, in ms it's 20th August 1970)
+MS_WATERSHED = int(2e10)
+# slightly more than datetime.max in ns - (datetime.max - EPOCH).total_seconds() * 1e9
+MAX_NUMBER = int(3e20)
+StrBytesIntFloat = Union[str, bytes, int, float]
+
+
+def get_numeric(value: StrBytesIntFloat, native_expected_type: str) -> Union[None, int, float]:
+    if isinstance(value, (int, float)):
+        return value
+    try:
+        return float(value)
+    except ValueError:
+        return None
+    except TypeError:
+        raise TypeError(f'invalid type; expected {native_expected_type}, string, bytes, int or float')
+
+
+def from_unix_seconds(seconds: Union[int, float]) -> datetime:
+    if seconds > MAX_NUMBER:
+        return datetime.max
+    elif seconds < -MAX_NUMBER:
+        return datetime.min
+
+    while abs(seconds) > MS_WATERSHED:
+        seconds /= 1000
+    dt = EPOCH + timedelta(seconds=seconds)
+    return dt.replace(tzinfo=timezone.utc)
+
+
+def _parse_timezone(value: Optional[str], error: Type[Exception]) -> Union[None, int, timezone]:
+    if value == 'Z':
+        return timezone.utc
+    elif value is not None:
+        offset_mins = int(value[-2:]) if len(value) > 3 else 0
+        offset = 60 * int(value[1:3]) + offset_mins
+        if value[0] == '-':
+            offset = -offset
+        try:
+            return timezone(timedelta(minutes=offset))
+        except ValueError:
+            raise error()
+    else:
+        return None
+
+
+def parse_date(value: Union[date, StrBytesIntFloat]) -> date:
+    """
+    Parse a date/int/float/string and return a datetime.date.
+
+    Raise ValueError if the input is well formatted but not a valid date.
+    Raise ValueError if the input isn't well formatted.
+    """
+    if isinstance(value, date):
+        if isinstance(value, datetime):
+            return value.date()
+        else:
+            return value
+
+    number = get_numeric(value, 'date')
+    if number is not None:
+        return from_unix_seconds(number).date()
+
+    if isinstance(value, bytes):
+        value = value.decode()
+
+    match = date_re.match(value)  # type: ignore
+    if match is None:
+        raise errors.DateError()
+
+    kw = {k: int(v) for k, v in match.groupdict().items()}
+
+    try:
+        return date(**kw)
+    except ValueError:
+        raise errors.DateError()
+
+
+def parse_time(value: Union[time, StrBytesIntFloat]) -> time:
+    """
+    Parse a time/string and return a datetime.time.
+
+    Raise ValueError if the input is well formatted but not a valid time.
+    Raise ValueError if the input isn't well formatted, in particular if it contains an offset.
+    """
+    if isinstance(value, time):
+        return value
+
+    number = get_numeric(value, 'time')
+    if number is not None:
+        if number >= 86400:
+            # doesn't make sense since the time time loop back around to 0
+            raise errors.TimeError()
+        return (datetime.min + timedelta(seconds=number)).time()
+
+    if isinstance(value, bytes):
+        value = value.decode()
+
+    match = time_re.match(value)  # type: ignore
+    if match is None:
+        raise errors.TimeError()
+
+    kw = match.groupdict()
+    if kw['microsecond']:
+        kw['microsecond'] = kw['microsecond'].ljust(6, '0')
+
+    tzinfo = _parse_timezone(kw.pop('tzinfo'), errors.TimeError)
+    kw_: Dict[str, Union[None, int, timezone]] = {k: int(v) for k, v in kw.items() if v is not None}
+    kw_['tzinfo'] = tzinfo
+
+    try:
+        return time(**kw_)  # type: ignore
+    except ValueError:
+        raise errors.TimeError()
+
+
+def parse_datetime(value: Union[datetime, StrBytesIntFloat]) -> datetime:
+    """
+    Parse a datetime/int/float/string and return a datetime.datetime.
+
+    This function supports time zone offsets. When the input contains one,
+    the output uses a timezone with a fixed offset from UTC.
+
+    Raise ValueError if the input is well formatted but not a valid datetime.
+    Raise ValueError if the input isn't well formatted.
+    """
+    if isinstance(value, datetime):
+        return value
+
+    number = get_numeric(value, 'datetime')
+    if number is not None:
+        return from_unix_seconds(number)
+
+    if isinstance(value, bytes):
+        value = value.decode()
+
+    match = datetime_re.match(value)  # type: ignore
+    if match is None:
+        raise errors.DateTimeError()
+
+    kw = match.groupdict()
+    if kw['microsecond']:
+        kw['microsecond'] = kw['microsecond'].ljust(6, '0')
+
+    tzinfo = _parse_timezone(kw.pop('tzinfo'), errors.DateTimeError)
+    kw_: Dict[str, Union[None, int, timezone]] = {k: int(v) for k, v in kw.items() if v is not None}
+    kw_['tzinfo'] = tzinfo
+
+    try:
+        return datetime(**kw_)  # type: ignore
+    except ValueError:
+        raise errors.DateTimeError()
+
+
+def parse_duration(value: StrBytesIntFloat) -> timedelta:
+    """
+    Parse a duration int/float/string and return a datetime.timedelta.
+
+    The preferred format for durations in Django is '%d %H:%M:%S.%f'.
+
+    Also supports ISO 8601 representation.
+    """
+    if isinstance(value, timedelta):
+        return value
+
+    if isinstance(value, (int, float)):
+        # below code requires a string
+        value = f'{value:f}'
+    elif isinstance(value, bytes):
+        value = value.decode()
+
+    try:
+        match = standard_duration_re.match(value) or iso8601_duration_re.match(value)
+    except TypeError:
+        raise TypeError('invalid type; expected timedelta, string, bytes, int or float')
+
+    if not match:
+        raise errors.DurationError()
+
+    kw = match.groupdict()
+    sign = -1 if kw.pop('sign', '+') == '-' else 1
+    if kw.get('microseconds'):
+        kw['microseconds'] = kw['microseconds'].ljust(6, '0')
+
+    if kw.get('seconds') and kw.get('microseconds') and kw['seconds'].startswith('-'):
+        kw['microseconds'] = '-' + kw['microseconds']
+
+    kw_ = {k: float(v) for k, v in kw.items() if v is not None}
+
+    return sign * timedelta(**kw_)
diff --git a/lib/pydantic/v1/decorator.py b/lib/pydantic/v1/decorator.py
new file mode 100644
index 00000000..089aab65
--- /dev/null
+++ b/lib/pydantic/v1/decorator.py
@@ -0,0 +1,264 @@
+from functools import wraps
+from typing import TYPE_CHECKING, Any, Callable, Dict, List, Mapping, Optional, Tuple, Type, TypeVar, Union, overload
+
+from . import validator
+from .config import Extra
+from .errors import ConfigError
+from .main import BaseModel, create_model
+from .typing import get_all_type_hints
+from .utils import to_camel
+
+__all__ = ('validate_arguments',)
+
+if TYPE_CHECKING:
+    from .typing import AnyCallable
+
+    AnyCallableT = TypeVar('AnyCallableT', bound=AnyCallable)
+    ConfigType = Union[None, Type[Any], Dict[str, Any]]
+
+
+@overload
+def validate_arguments(func: None = None, *, config: 'ConfigType' = None) -> Callable[['AnyCallableT'], 'AnyCallableT']:
+    ...
+
+
+@overload
+def validate_arguments(func: 'AnyCallableT') -> 'AnyCallableT':
+    ...
+
+
+def validate_arguments(func: Optional['AnyCallableT'] = None, *, config: 'ConfigType' = None) -> Any:
+    """
+    Decorator to validate the arguments passed to a function.
+    """
+
+    def validate(_func: 'AnyCallable') -> 'AnyCallable':
+        vd = ValidatedFunction(_func, config)
+
+        @wraps(_func)
+        def wrapper_function(*args: Any, **kwargs: Any) -> Any:
+            return vd.call(*args, **kwargs)
+
+        wrapper_function.vd = vd  # type: ignore
+        wrapper_function.validate = vd.init_model_instance  # type: ignore
+        wrapper_function.raw_function = vd.raw_function  # type: ignore
+        wrapper_function.model = vd.model  # type: ignore
+        return wrapper_function
+
+    if func:
+        return validate(func)
+    else:
+        return validate
+
+
+ALT_V_ARGS = 'v__args'
+ALT_V_KWARGS = 'v__kwargs'
+V_POSITIONAL_ONLY_NAME = 'v__positional_only'
+V_DUPLICATE_KWARGS = 'v__duplicate_kwargs'
+
+
+class ValidatedFunction:
+    def __init__(self, function: 'AnyCallableT', config: 'ConfigType'):  # noqa C901
+        from inspect import Parameter, signature
+
+        parameters: Mapping[str, Parameter] = signature(function).parameters
+
+        if parameters.keys() & {ALT_V_ARGS, ALT_V_KWARGS, V_POSITIONAL_ONLY_NAME, V_DUPLICATE_KWARGS}:
+            raise ConfigError(
+                f'"{ALT_V_ARGS}", "{ALT_V_KWARGS}", "{V_POSITIONAL_ONLY_NAME}" and "{V_DUPLICATE_KWARGS}" '
+                f'are not permitted as argument names when using the "{validate_arguments.__name__}" decorator'
+            )
+
+        self.raw_function = function
+        self.arg_mapping: Dict[int, str] = {}
+        self.positional_only_args = set()
+        self.v_args_name = 'args'
+        self.v_kwargs_name = 'kwargs'
+
+        type_hints = get_all_type_hints(function)
+        takes_args = False
+        takes_kwargs = False
+        fields: Dict[str, Tuple[Any, Any]] = {}
+        for i, (name, p) in enumerate(parameters.items()):
+            if p.annotation is p.empty:
+                annotation = Any
+            else:
+                annotation = type_hints[name]
+
+            default = ... if p.default is p.empty else p.default
+            if p.kind == Parameter.POSITIONAL_ONLY:
+                self.arg_mapping[i] = name
+                fields[name] = annotation, default
+                fields[V_POSITIONAL_ONLY_NAME] = List[str], None
+                self.positional_only_args.add(name)
+            elif p.kind == Parameter.POSITIONAL_OR_KEYWORD:
+                self.arg_mapping[i] = name
+                fields[name] = annotation, default
+                fields[V_DUPLICATE_KWARGS] = List[str], None
+            elif p.kind == Parameter.KEYWORD_ONLY:
+                fields[name] = annotation, default
+            elif p.kind == Parameter.VAR_POSITIONAL:
+                self.v_args_name = name
+                fields[name] = Tuple[annotation, ...], None
+                takes_args = True
+            else:
+                assert p.kind == Parameter.VAR_KEYWORD, p.kind
+                self.v_kwargs_name = name
+                fields[name] = Dict[str, annotation], None  # type: ignore
+                takes_kwargs = True
+
+        # these checks avoid a clash between "args" and a field with that name
+        if not takes_args and self.v_args_name in fields:
+            self.v_args_name = ALT_V_ARGS
+
+        # same with "kwargs"
+        if not takes_kwargs and self.v_kwargs_name in fields:
+            self.v_kwargs_name = ALT_V_KWARGS
+
+        if not takes_args:
+            # we add the field so validation below can raise the correct exception
+            fields[self.v_args_name] = List[Any], None
+
+        if not takes_kwargs:
+            # same with kwargs
+            fields[self.v_kwargs_name] = Dict[Any, Any], None
+
+        self.create_model(fields, takes_args, takes_kwargs, config)
+
+    def init_model_instance(self, *args: Any, **kwargs: Any) -> BaseModel:
+        values = self.build_values(args, kwargs)
+        return self.model(**values)
+
+    def call(self, *args: Any, **kwargs: Any) -> Any:
+        m = self.init_model_instance(*args, **kwargs)
+        return self.execute(m)
+
+    def build_values(self, args: Tuple[Any, ...], kwargs: Dict[str, Any]) -> Dict[str, Any]:
+        values: Dict[str, Any] = {}
+        if args:
+            arg_iter = enumerate(args)
+            while True:
+                try:
+                    i, a = next(arg_iter)
+                except StopIteration:
+                    break
+                arg_name = self.arg_mapping.get(i)
+                if arg_name is not None:
+                    values[arg_name] = a
+                else:
+                    values[self.v_args_name] = [a] + [a for _, a in arg_iter]
+                    break
+
+        var_kwargs: Dict[str, Any] = {}
+        wrong_positional_args = []
+        duplicate_kwargs = []
+        fields_alias = [
+            field.alias
+            for name, field in self.model.__fields__.items()
+            if name not in (self.v_args_name, self.v_kwargs_name)
+        ]
+        non_var_fields = set(self.model.__fields__) - {self.v_args_name, self.v_kwargs_name}
+        for k, v in kwargs.items():
+            if k in non_var_fields or k in fields_alias:
+                if k in self.positional_only_args:
+                    wrong_positional_args.append(k)
+                if k in values:
+                    duplicate_kwargs.append(k)
+                values[k] = v
+            else:
+                var_kwargs[k] = v
+
+        if var_kwargs:
+            values[self.v_kwargs_name] = var_kwargs
+        if wrong_positional_args:
+            values[V_POSITIONAL_ONLY_NAME] = wrong_positional_args
+        if duplicate_kwargs:
+            values[V_DUPLICATE_KWARGS] = duplicate_kwargs
+        return values
+
+    def execute(self, m: BaseModel) -> Any:
+        d = {k: v for k, v in m._iter() if k in m.__fields_set__ or m.__fields__[k].default_factory}
+        var_kwargs = d.pop(self.v_kwargs_name, {})
+
+        if self.v_args_name in d:
+            args_: List[Any] = []
+            in_kwargs = False
+            kwargs = {}
+            for name, value in d.items():
+                if in_kwargs:
+                    kwargs[name] = value
+                elif name == self.v_args_name:
+                    args_ += value
+                    in_kwargs = True
+                else:
+                    args_.append(value)
+            return self.raw_function(*args_, **kwargs, **var_kwargs)
+        elif self.positional_only_args:
+            args_ = []
+            kwargs = {}
+            for name, value in d.items():
+                if name in self.positional_only_args:
+                    args_.append(value)
+                else:
+                    kwargs[name] = value
+            return self.raw_function(*args_, **kwargs, **var_kwargs)
+        else:
+            return self.raw_function(**d, **var_kwargs)
+
+    def create_model(self, fields: Dict[str, Any], takes_args: bool, takes_kwargs: bool, config: 'ConfigType') -> None:
+        pos_args = len(self.arg_mapping)
+
+        class CustomConfig:
+            pass
+
+        if not TYPE_CHECKING:  # pragma: no branch
+            if isinstance(config, dict):
+                CustomConfig = type('Config', (), config)  # noqa: F811
+            elif config is not None:
+                CustomConfig = config  # noqa: F811
+
+        if hasattr(CustomConfig, 'fields') or hasattr(CustomConfig, 'alias_generator'):
+            raise ConfigError(
+                'Setting the "fields" and "alias_generator" property on custom Config for '
+                '@validate_arguments is not yet supported, please remove.'
+            )
+
+        class DecoratorBaseModel(BaseModel):
+            @validator(self.v_args_name, check_fields=False, allow_reuse=True)
+            def check_args(cls, v: Optional[List[Any]]) -> Optional[List[Any]]:
+                if takes_args or v is None:
+                    return v
+
+                raise TypeError(f'{pos_args} positional arguments expected but {pos_args + len(v)} given')
+
+            @validator(self.v_kwargs_name, check_fields=False, allow_reuse=True)
+            def check_kwargs(cls, v: Optional[Dict[str, Any]]) -> Optional[Dict[str, Any]]:
+                if takes_kwargs or v is None:
+                    return v
+
+                plural = '' if len(v) == 1 else 's'
+                keys = ', '.join(map(repr, v.keys()))
+                raise TypeError(f'unexpected keyword argument{plural}: {keys}')
+
+            @validator(V_POSITIONAL_ONLY_NAME, check_fields=False, allow_reuse=True)
+            def check_positional_only(cls, v: Optional[List[str]]) -> None:
+                if v is None:
+                    return
+
+                plural = '' if len(v) == 1 else 's'
+                keys = ', '.join(map(repr, v))
+                raise TypeError(f'positional-only argument{plural} passed as keyword argument{plural}: {keys}')
+
+            @validator(V_DUPLICATE_KWARGS, check_fields=False, allow_reuse=True)
+            def check_duplicate_kwargs(cls, v: Optional[List[str]]) -> None:
+                if v is None:
+                    return
+
+                plural = '' if len(v) == 1 else 's'
+                keys = ', '.join(map(repr, v))
+                raise TypeError(f'multiple values for argument{plural}: {keys}')
+
+            class Config(CustomConfig):
+                extra = getattr(CustomConfig, 'extra', Extra.forbid)
+
+        self.model = create_model(to_camel(self.raw_function.__name__), __base__=DecoratorBaseModel, **fields)
diff --git a/lib/pydantic/v1/env_settings.py b/lib/pydantic/v1/env_settings.py
new file mode 100644
index 00000000..6c446e51
--- /dev/null
+++ b/lib/pydantic/v1/env_settings.py
@@ -0,0 +1,350 @@
+import os
+import warnings
+from pathlib import Path
+from typing import AbstractSet, Any, Callable, ClassVar, Dict, List, Mapping, Optional, Tuple, Type, Union
+
+from .config import BaseConfig, Extra
+from .fields import ModelField
+from .main import BaseModel
+from .types import JsonWrapper
+from .typing import StrPath, display_as_type, get_origin, is_union
+from .utils import deep_update, lenient_issubclass, path_type, sequence_like
+
+env_file_sentinel = str(object())
+
+SettingsSourceCallable = Callable[['BaseSettings'], Dict[str, Any]]
+DotenvType = Union[StrPath, List[StrPath], Tuple[StrPath, ...]]
+
+
+class SettingsError(ValueError):
+    pass
+
+
+class BaseSettings(BaseModel):
+    """
+    Base class for settings, allowing values to be overridden by environment variables.
+
+    This is useful in production for secrets you do not wish to save in code, it plays nicely with docker(-compose),
+    Heroku and any 12 factor app design.
+    """
+
+    def __init__(
+        __pydantic_self__,
+        _env_file: Optional[DotenvType] = env_file_sentinel,
+        _env_file_encoding: Optional[str] = None,
+        _env_nested_delimiter: Optional[str] = None,
+        _secrets_dir: Optional[StrPath] = None,
+        **values: Any,
+    ) -> None:
+        # Uses something other than `self` the first arg to allow "self" as a settable attribute
+        super().__init__(
+            **__pydantic_self__._build_values(
+                values,
+                _env_file=_env_file,
+                _env_file_encoding=_env_file_encoding,
+                _env_nested_delimiter=_env_nested_delimiter,
+                _secrets_dir=_secrets_dir,
+            )
+        )
+
+    def _build_values(
+        self,
+        init_kwargs: Dict[str, Any],
+        _env_file: Optional[DotenvType] = None,
+        _env_file_encoding: Optional[str] = None,
+        _env_nested_delimiter: Optional[str] = None,
+        _secrets_dir: Optional[StrPath] = None,
+    ) -> Dict[str, Any]:
+        # Configure built-in sources
+        init_settings = InitSettingsSource(init_kwargs=init_kwargs)
+        env_settings = EnvSettingsSource(
+            env_file=(_env_file if _env_file != env_file_sentinel else self.__config__.env_file),
+            env_file_encoding=(
+                _env_file_encoding if _env_file_encoding is not None else self.__config__.env_file_encoding
+            ),
+            env_nested_delimiter=(
+                _env_nested_delimiter if _env_nested_delimiter is not None else self.__config__.env_nested_delimiter
+            ),
+            env_prefix_len=len(self.__config__.env_prefix),
+        )
+        file_secret_settings = SecretsSettingsSource(secrets_dir=_secrets_dir or self.__config__.secrets_dir)
+        # Provide a hook to set built-in sources priority and add / remove sources
+        sources = self.__config__.customise_sources(
+            init_settings=init_settings, env_settings=env_settings, file_secret_settings=file_secret_settings
+        )
+        if sources:
+            return deep_update(*reversed([source(self) for source in sources]))
+        else:
+            # no one should mean to do this, but I think returning an empty dict is marginally preferable
+            # to an informative error and much better than a confusing error
+            return {}
+
+    class Config(BaseConfig):
+        env_prefix: str = ''
+        env_file: Optional[DotenvType] = None
+        env_file_encoding: Optional[str] = None
+        env_nested_delimiter: Optional[str] = None
+        secrets_dir: Optional[StrPath] = None
+        validate_all: bool = True
+        extra: Extra = Extra.forbid
+        arbitrary_types_allowed: bool = True
+        case_sensitive: bool = False
+
+        @classmethod
+        def prepare_field(cls, field: ModelField) -> None:
+            env_names: Union[List[str], AbstractSet[str]]
+            field_info_from_config = cls.get_field_info(field.name)
+
+            env = field_info_from_config.get('env') or field.field_info.extra.get('env')
+            if env is None:
+                if field.has_alias:
+                    warnings.warn(
+                        'aliases are no longer used by BaseSettings to define which environment variables to read. '
+                        'Instead use the "env" field setting. '
+                        'See https://pydantic-docs.helpmanual.io/usage/settings/#environment-variable-names',
+                        FutureWarning,
+                    )
+                env_names = {cls.env_prefix + field.name}
+            elif isinstance(env, str):
+                env_names = {env}
+            elif isinstance(env, (set, frozenset)):
+                env_names = env
+            elif sequence_like(env):
+                env_names = list(env)
+            else:
+                raise TypeError(f'invalid field env: {env!r} ({display_as_type(env)}); should be string, list or set')
+
+            if not cls.case_sensitive:
+                env_names = env_names.__class__(n.lower() for n in env_names)
+            field.field_info.extra['env_names'] = env_names
+
+        @classmethod
+        def customise_sources(
+            cls,
+            init_settings: SettingsSourceCallable,
+            env_settings: SettingsSourceCallable,
+            file_secret_settings: SettingsSourceCallable,
+        ) -> Tuple[SettingsSourceCallable, ...]:
+            return init_settings, env_settings, file_secret_settings
+
+        @classmethod
+        def parse_env_var(cls, field_name: str, raw_val: str) -> Any:
+            return cls.json_loads(raw_val)
+
+    # populated by the metaclass using the Config class defined above, annotated here to help IDEs only
+    __config__: ClassVar[Type[Config]]
+
+
+class InitSettingsSource:
+    __slots__ = ('init_kwargs',)
+
+    def __init__(self, init_kwargs: Dict[str, Any]):
+        self.init_kwargs = init_kwargs
+
+    def __call__(self, settings: BaseSettings) -> Dict[str, Any]:
+        return self.init_kwargs
+
+    def __repr__(self) -> str:
+        return f'InitSettingsSource(init_kwargs={self.init_kwargs!r})'
+
+
+class EnvSettingsSource:
+    __slots__ = ('env_file', 'env_file_encoding', 'env_nested_delimiter', 'env_prefix_len')
+
+    def __init__(
+        self,
+        env_file: Optional[DotenvType],
+        env_file_encoding: Optional[str],
+        env_nested_delimiter: Optional[str] = None,
+        env_prefix_len: int = 0,
+    ):
+        self.env_file: Optional[DotenvType] = env_file
+        self.env_file_encoding: Optional[str] = env_file_encoding
+        self.env_nested_delimiter: Optional[str] = env_nested_delimiter
+        self.env_prefix_len: int = env_prefix_len
+
+    def __call__(self, settings: BaseSettings) -> Dict[str, Any]:  # noqa C901
+        """
+        Build environment variables suitable for passing to the Model.
+        """
+        d: Dict[str, Any] = {}
+
+        if settings.__config__.case_sensitive:
+            env_vars: Mapping[str, Optional[str]] = os.environ
+        else:
+            env_vars = {k.lower(): v for k, v in os.environ.items()}
+
+        dotenv_vars = self._read_env_files(settings.__config__.case_sensitive)
+        if dotenv_vars:
+            env_vars = {**dotenv_vars, **env_vars}
+
+        for field in settings.__fields__.values():
+            env_val: Optional[str] = None
+            for env_name in field.field_info.extra['env_names']:
+                env_val = env_vars.get(env_name)
+                if env_val is not None:
+                    break
+
+            is_complex, allow_parse_failure = self.field_is_complex(field)
+            if is_complex:
+                if env_val is None:
+                    # field is complex but no value found so far, try explode_env_vars
+                    env_val_built = self.explode_env_vars(field, env_vars)
+                    if env_val_built:
+                        d[field.alias] = env_val_built
+                else:
+                    # field is complex and there's a value, decode that as JSON, then add explode_env_vars
+                    try:
+                        env_val = settings.__config__.parse_env_var(field.name, env_val)
+                    except ValueError as e:
+                        if not allow_parse_failure:
+                            raise SettingsError(f'error parsing env var "{env_name}"') from e
+
+                    if isinstance(env_val, dict):
+                        d[field.alias] = deep_update(env_val, self.explode_env_vars(field, env_vars))
+                    else:
+                        d[field.alias] = env_val
+            elif env_val is not None:
+                # simplest case, field is not complex, we only need to add the value if it was found
+                d[field.alias] = env_val
+
+        return d
+
+    def _read_env_files(self, case_sensitive: bool) -> Dict[str, Optional[str]]:
+        env_files = self.env_file
+        if env_files is None:
+            return {}
+
+        if isinstance(env_files, (str, os.PathLike)):
+            env_files = [env_files]
+
+        dotenv_vars = {}
+        for env_file in env_files:
+            env_path = Path(env_file).expanduser()
+            if env_path.is_file():
+                dotenv_vars.update(
+                    read_env_file(env_path, encoding=self.env_file_encoding, case_sensitive=case_sensitive)
+                )
+
+        return dotenv_vars
+
+    def field_is_complex(self, field: ModelField) -> Tuple[bool, bool]:
+        """
+        Find out if a field is complex, and if so whether JSON errors should be ignored
+        """
+        if lenient_issubclass(field.annotation, JsonWrapper):
+            return False, False
+
+        if field.is_complex():
+            allow_parse_failure = False
+        elif is_union(get_origin(field.type_)) and field.sub_fields and any(f.is_complex() for f in field.sub_fields):
+            allow_parse_failure = True
+        else:
+            return False, False
+
+        return True, allow_parse_failure
+
+    def explode_env_vars(self, field: ModelField, env_vars: Mapping[str, Optional[str]]) -> Dict[str, Any]:
+        """
+        Process env_vars and extract the values of keys containing env_nested_delimiter into nested dictionaries.
+
+        This is applied to a single field, hence filtering by env_var prefix.
+        """
+        prefixes = [f'{env_name}{self.env_nested_delimiter}' for env_name in field.field_info.extra['env_names']]
+        result: Dict[str, Any] = {}
+        for env_name, env_val in env_vars.items():
+            if not any(env_name.startswith(prefix) for prefix in prefixes):
+                continue
+            # we remove the prefix before splitting in case the prefix has characters in common with the delimiter
+            env_name_without_prefix = env_name[self.env_prefix_len :]
+            _, *keys, last_key = env_name_without_prefix.split(self.env_nested_delimiter)
+            env_var = result
+            for key in keys:
+                env_var = env_var.setdefault(key, {})
+            env_var[last_key] = env_val
+
+        return result
+
+    def __repr__(self) -> str:
+        return (
+            f'EnvSettingsSource(env_file={self.env_file!r}, env_file_encoding={self.env_file_encoding!r}, '
+            f'env_nested_delimiter={self.env_nested_delimiter!r})'
+        )
+
+
+class SecretsSettingsSource:
+    __slots__ = ('secrets_dir',)
+
+    def __init__(self, secrets_dir: Optional[StrPath]):
+        self.secrets_dir: Optional[StrPath] = secrets_dir
+
+    def __call__(self, settings: BaseSettings) -> Dict[str, Any]:
+        """
+        Build fields from "secrets" files.
+        """
+        secrets: Dict[str, Optional[str]] = {}
+
+        if self.secrets_dir is None:
+            return secrets
+
+        secrets_path = Path(self.secrets_dir).expanduser()
+
+        if not secrets_path.exists():
+            warnings.warn(f'directory "{secrets_path}" does not exist')
+            return secrets
+
+        if not secrets_path.is_dir():
+            raise SettingsError(f'secrets_dir must reference a directory, not a {path_type(secrets_path)}')
+
+        for field in settings.__fields__.values():
+            for env_name in field.field_info.extra['env_names']:
+                path = find_case_path(secrets_path, env_name, settings.__config__.case_sensitive)
+                if not path:
+                    # path does not exist, we currently don't return a warning for this
+                    continue
+
+                if path.is_file():
+                    secret_value = path.read_text().strip()
+                    if field.is_complex():
+                        try:
+                            secret_value = settings.__config__.parse_env_var(field.name, secret_value)
+                        except ValueError as e:
+                            raise SettingsError(f'error parsing env var "{env_name}"') from e
+
+                    secrets[field.alias] = secret_value
+                else:
+                    warnings.warn(
+                        f'attempted to load secret file "{path}" but found a {path_type(path)} instead.',
+                        stacklevel=4,
+                    )
+        return secrets
+
+    def __repr__(self) -> str:
+        return f'SecretsSettingsSource(secrets_dir={self.secrets_dir!r})'
+
+
+def read_env_file(
+    file_path: StrPath, *, encoding: str = None, case_sensitive: bool = False
+) -> Dict[str, Optional[str]]:
+    try:
+        from dotenv import dotenv_values
+    except ImportError as e:
+        raise ImportError('python-dotenv is not installed, run `pip install pydantic[dotenv]`') from e
+
+    file_vars: Dict[str, Optional[str]] = dotenv_values(file_path, encoding=encoding or 'utf8')
+    if not case_sensitive:
+        return {k.lower(): v for k, v in file_vars.items()}
+    else:
+        return file_vars
+
+
+def find_case_path(dir_path: Path, file_name: str, case_sensitive: bool) -> Optional[Path]:
+    """
+    Find a file within path's directory matching filename, optionally ignoring case.
+    """
+    for f in dir_path.iterdir():
+        if f.name == file_name:
+            return f
+        elif not case_sensitive and f.name.lower() == file_name.lower():
+            return f
+    return None
diff --git a/lib/pydantic/v1/error_wrappers.py b/lib/pydantic/v1/error_wrappers.py
new file mode 100644
index 00000000..d89a500c
--- /dev/null
+++ b/lib/pydantic/v1/error_wrappers.py
@@ -0,0 +1,161 @@
+import json
+from typing import TYPE_CHECKING, Any, Dict, Generator, List, Optional, Sequence, Tuple, Type, Union
+
+from .json import pydantic_encoder
+from .utils import Representation
+
+if TYPE_CHECKING:
+    from typing_extensions import TypedDict
+
+    from .config import BaseConfig
+    from .types import ModelOrDc
+    from .typing import ReprArgs
+
+    Loc = Tuple[Union[int, str], ...]
+
+    class _ErrorDictRequired(TypedDict):
+        loc: Loc
+        msg: str
+        type: str
+
+    class ErrorDict(_ErrorDictRequired, total=False):
+        ctx: Dict[str, Any]
+
+
+__all__ = 'ErrorWrapper', 'ValidationError'
+
+
+class ErrorWrapper(Representation):
+    __slots__ = 'exc', '_loc'
+
+    def __init__(self, exc: Exception, loc: Union[str, 'Loc']) -> None:
+        self.exc = exc
+        self._loc = loc
+
+    def loc_tuple(self) -> 'Loc':
+        if isinstance(self._loc, tuple):
+            return self._loc
+        else:
+            return (self._loc,)
+
+    def __repr_args__(self) -> 'ReprArgs':
+        return [('exc', self.exc), ('loc', self.loc_tuple())]
+
+
+# ErrorList is something like Union[List[Union[List[ErrorWrapper], ErrorWrapper]], ErrorWrapper]
+# but recursive, therefore just use:
+ErrorList = Union[Sequence[Any], ErrorWrapper]
+
+
+class ValidationError(Representation, ValueError):
+    __slots__ = 'raw_errors', 'model', '_error_cache'
+
+    def __init__(self, errors: Sequence[ErrorList], model: 'ModelOrDc') -> None:
+        self.raw_errors = errors
+        self.model = model
+        self._error_cache: Optional[List['ErrorDict']] = None
+
+    def errors(self) -> List['ErrorDict']:
+        if self._error_cache is None:
+            try:
+                config = self.model.__config__  # type: ignore
+            except AttributeError:
+                config = self.model.__pydantic_model__.__config__  # type: ignore
+            self._error_cache = list(flatten_errors(self.raw_errors, config))
+        return self._error_cache
+
+    def json(self, *, indent: Union[None, int, str] = 2) -> str:
+        return json.dumps(self.errors(), indent=indent, default=pydantic_encoder)
+
+    def __str__(self) -> str:
+        errors = self.errors()
+        no_errors = len(errors)
+        return (
+            f'{no_errors} validation error{"" if no_errors == 1 else "s"} for {self.model.__name__}\n'
+            f'{display_errors(errors)}'
+        )
+
+    def __repr_args__(self) -> 'ReprArgs':
+        return [('model', self.model.__name__), ('errors', self.errors())]
+
+
+def display_errors(errors: List['ErrorDict']) -> str:
+    return '\n'.join(f'{_display_error_loc(e)}\n  {e["msg"]} ({_display_error_type_and_ctx(e)})' for e in errors)
+
+
+def _display_error_loc(error: 'ErrorDict') -> str:
+    return ' -> '.join(str(e) for e in error['loc'])
+
+
+def _display_error_type_and_ctx(error: 'ErrorDict') -> str:
+    t = 'type=' + error['type']
+    ctx = error.get('ctx')
+    if ctx:
+        return t + ''.join(f'; {k}={v}' for k, v in ctx.items())
+    else:
+        return t
+
+
+def flatten_errors(
+    errors: Sequence[Any], config: Type['BaseConfig'], loc: Optional['Loc'] = None
+) -> Generator['ErrorDict', None, None]:
+    for error in errors:
+        if isinstance(error, ErrorWrapper):
+            if loc:
+                error_loc = loc + error.loc_tuple()
+            else:
+                error_loc = error.loc_tuple()
+
+            if isinstance(error.exc, ValidationError):
+                yield from flatten_errors(error.exc.raw_errors, config, error_loc)
+            else:
+                yield error_dict(error.exc, config, error_loc)
+        elif isinstance(error, list):
+            yield from flatten_errors(error, config, loc=loc)
+        else:
+            raise RuntimeError(f'Unknown error object: {error}')
+
+
+def error_dict(exc: Exception, config: Type['BaseConfig'], loc: 'Loc') -> 'ErrorDict':
+    type_ = get_exc_type(exc.__class__)
+    msg_template = config.error_msg_templates.get(type_) or getattr(exc, 'msg_template', None)
+    ctx = exc.__dict__
+    if msg_template:
+        msg = msg_template.format(**ctx)
+    else:
+        msg = str(exc)
+
+    d: 'ErrorDict' = {'loc': loc, 'msg': msg, 'type': type_}
+
+    if ctx:
+        d['ctx'] = ctx
+
+    return d
+
+
+_EXC_TYPE_CACHE: Dict[Type[Exception], str] = {}
+
+
+def get_exc_type(cls: Type[Exception]) -> str:
+    # slightly more efficient than using lru_cache since we don't need to worry about the cache filling up
+    try:
+        return _EXC_TYPE_CACHE[cls]
+    except KeyError:
+        r = _get_exc_type(cls)
+        _EXC_TYPE_CACHE[cls] = r
+        return r
+
+
+def _get_exc_type(cls: Type[Exception]) -> str:
+    if issubclass(cls, AssertionError):
+        return 'assertion_error'
+
+    base_name = 'type_error' if issubclass(cls, TypeError) else 'value_error'
+    if cls in (TypeError, ValueError):
+        # just TypeError or ValueError, no extra code
+        return base_name
+
+    # if it's not a TypeError or ValueError, we just take the lowercase of the exception name
+    # no chaining or snake case logic, use "code" for more complex error types.
+    code = getattr(cls, 'code', None) or cls.__name__.replace('Error', '').lower()
+    return base_name + '.' + code
diff --git a/lib/pydantic/v1/errors.py b/lib/pydantic/v1/errors.py
new file mode 100644
index 00000000..7bdafdd1
--- /dev/null
+++ b/lib/pydantic/v1/errors.py
@@ -0,0 +1,646 @@
+from decimal import Decimal
+from pathlib import Path
+from typing import TYPE_CHECKING, Any, Callable, Sequence, Set, Tuple, Type, Union
+
+from .typing import display_as_type
+
+if TYPE_CHECKING:
+    from .typing import DictStrAny
+
+# explicitly state exports to avoid "from .errors import *" also importing Decimal, Path etc.
+__all__ = (
+    'PydanticTypeError',
+    'PydanticValueError',
+    'ConfigError',
+    'MissingError',
+    'ExtraError',
+    'NoneIsNotAllowedError',
+    'NoneIsAllowedError',
+    'WrongConstantError',
+    'NotNoneError',
+    'BoolError',
+    'BytesError',
+    'DictError',
+    'EmailError',
+    'UrlError',
+    'UrlSchemeError',
+    'UrlSchemePermittedError',
+    'UrlUserInfoError',
+    'UrlHostError',
+    'UrlHostTldError',
+    'UrlPortError',
+    'UrlExtraError',
+    'EnumError',
+    'IntEnumError',
+    'EnumMemberError',
+    'IntegerError',
+    'FloatError',
+    'PathError',
+    'PathNotExistsError',
+    'PathNotAFileError',
+    'PathNotADirectoryError',
+    'PyObjectError',
+    'SequenceError',
+    'ListError',
+    'SetError',
+    'FrozenSetError',
+    'TupleError',
+    'TupleLengthError',
+    'ListMinLengthError',
+    'ListMaxLengthError',
+    'ListUniqueItemsError',
+    'SetMinLengthError',
+    'SetMaxLengthError',
+    'FrozenSetMinLengthError',
+    'FrozenSetMaxLengthError',
+    'AnyStrMinLengthError',
+    'AnyStrMaxLengthError',
+    'StrError',
+    'StrRegexError',
+    'NumberNotGtError',
+    'NumberNotGeError',
+    'NumberNotLtError',
+    'NumberNotLeError',
+    'NumberNotMultipleError',
+    'DecimalError',
+    'DecimalIsNotFiniteError',
+    'DecimalMaxDigitsError',
+    'DecimalMaxPlacesError',
+    'DecimalWholeDigitsError',
+    'DateTimeError',
+    'DateError',
+    'DateNotInThePastError',
+    'DateNotInTheFutureError',
+    'TimeError',
+    'DurationError',
+    'HashableError',
+    'UUIDError',
+    'UUIDVersionError',
+    'ArbitraryTypeError',
+    'ClassError',
+    'SubclassError',
+    'JsonError',
+    'JsonTypeError',
+    'PatternError',
+    'DataclassTypeError',
+    'CallableError',
+    'IPvAnyAddressError',
+    'IPvAnyInterfaceError',
+    'IPvAnyNetworkError',
+    'IPv4AddressError',
+    'IPv6AddressError',
+    'IPv4NetworkError',
+    'IPv6NetworkError',
+    'IPv4InterfaceError',
+    'IPv6InterfaceError',
+    'ColorError',
+    'StrictBoolError',
+    'NotDigitError',
+    'LuhnValidationError',
+    'InvalidLengthForBrand',
+    'InvalidByteSize',
+    'InvalidByteSizeUnit',
+    'MissingDiscriminator',
+    'InvalidDiscriminator',
+)
+
+
+def cls_kwargs(cls: Type['PydanticErrorMixin'], ctx: 'DictStrAny') -> 'PydanticErrorMixin':
+    """
+    For built-in exceptions like ValueError or TypeError, we need to implement
+    __reduce__ to override the default behaviour (instead of __getstate__/__setstate__)
+    By default pickle protocol 2 calls `cls.__new__(cls, *args)`.
+    Since we only use kwargs, we need a little constructor to change that.
+    Note: the callable can't be a lambda as pickle looks in the namespace to find it
+    """
+    return cls(**ctx)
+
+
+class PydanticErrorMixin:
+    code: str
+    msg_template: str
+
+    def __init__(self, **ctx: Any) -> None:
+        self.__dict__ = ctx
+
+    def __str__(self) -> str:
+        return self.msg_template.format(**self.__dict__)
+
+    def __reduce__(self) -> Tuple[Callable[..., 'PydanticErrorMixin'], Tuple[Type['PydanticErrorMixin'], 'DictStrAny']]:
+        return cls_kwargs, (self.__class__, self.__dict__)
+
+
+class PydanticTypeError(PydanticErrorMixin, TypeError):
+    pass
+
+
+class PydanticValueError(PydanticErrorMixin, ValueError):
+    pass
+
+
+class ConfigError(RuntimeError):
+    pass
+
+
+class MissingError(PydanticValueError):
+    msg_template = 'field required'
+
+
+class ExtraError(PydanticValueError):
+    msg_template = 'extra fields not permitted'
+
+
+class NoneIsNotAllowedError(PydanticTypeError):
+    code = 'none.not_allowed'
+    msg_template = 'none is not an allowed value'
+
+
+class NoneIsAllowedError(PydanticTypeError):
+    code = 'none.allowed'
+    msg_template = 'value is not none'
+
+
+class WrongConstantError(PydanticValueError):
+    code = 'const'
+
+    def __str__(self) -> str:
+        permitted = ', '.join(repr(v) for v in self.permitted)  # type: ignore
+        return f'unexpected value; permitted: {permitted}'
+
+
+class NotNoneError(PydanticTypeError):
+    code = 'not_none'
+    msg_template = 'value is not None'
+
+
+class BoolError(PydanticTypeError):
+    msg_template = 'value could not be parsed to a boolean'
+
+
+class BytesError(PydanticTypeError):
+    msg_template = 'byte type expected'
+
+
+class DictError(PydanticTypeError):
+    msg_template = 'value is not a valid dict'
+
+
+class EmailError(PydanticValueError):
+    msg_template = 'value is not a valid email address'
+
+
+class UrlError(PydanticValueError):
+    code = 'url'
+
+
+class UrlSchemeError(UrlError):
+    code = 'url.scheme'
+    msg_template = 'invalid or missing URL scheme'
+
+
+class UrlSchemePermittedError(UrlError):
+    code = 'url.scheme'
+    msg_template = 'URL scheme not permitted'
+
+    def __init__(self, allowed_schemes: Set[str]):
+        super().__init__(allowed_schemes=allowed_schemes)
+
+
+class UrlUserInfoError(UrlError):
+    code = 'url.userinfo'
+    msg_template = 'userinfo required in URL but missing'
+
+
+class UrlHostError(UrlError):
+    code = 'url.host'
+    msg_template = 'URL host invalid'
+
+
+class UrlHostTldError(UrlError):
+    code = 'url.host'
+    msg_template = 'URL host invalid, top level domain required'
+
+
+class UrlPortError(UrlError):
+    code = 'url.port'
+    msg_template = 'URL port invalid, port cannot exceed 65535'
+
+
+class UrlExtraError(UrlError):
+    code = 'url.extra'
+    msg_template = 'URL invalid, extra characters found after valid URL: {extra!r}'
+
+
+class EnumMemberError(PydanticTypeError):
+    code = 'enum'
+
+    def __str__(self) -> str:
+        permitted = ', '.join(repr(v.value) for v in self.enum_values)  # type: ignore
+        return f'value is not a valid enumeration member; permitted: {permitted}'
+
+
+class IntegerError(PydanticTypeError):
+    msg_template = 'value is not a valid integer'
+
+
+class FloatError(PydanticTypeError):
+    msg_template = 'value is not a valid float'
+
+
+class PathError(PydanticTypeError):
+    msg_template = 'value is not a valid path'
+
+
+class _PathValueError(PydanticValueError):
+    def __init__(self, *, path: Path) -> None:
+        super().__init__(path=str(path))
+
+
+class PathNotExistsError(_PathValueError):
+    code = 'path.not_exists'
+    msg_template = 'file or directory at path "{path}" does not exist'
+
+
+class PathNotAFileError(_PathValueError):
+    code = 'path.not_a_file'
+    msg_template = 'path "{path}" does not point to a file'
+
+
+class PathNotADirectoryError(_PathValueError):
+    code = 'path.not_a_directory'
+    msg_template = 'path "{path}" does not point to a directory'
+
+
+class PyObjectError(PydanticTypeError):
+    msg_template = 'ensure this value contains valid import path or valid callable: {error_message}'
+
+
+class SequenceError(PydanticTypeError):
+    msg_template = 'value is not a valid sequence'
+
+
+class IterableError(PydanticTypeError):
+    msg_template = 'value is not a valid iterable'
+
+
+class ListError(PydanticTypeError):
+    msg_template = 'value is not a valid list'
+
+
+class SetError(PydanticTypeError):
+    msg_template = 'value is not a valid set'
+
+
+class FrozenSetError(PydanticTypeError):
+    msg_template = 'value is not a valid frozenset'
+
+
+class DequeError(PydanticTypeError):
+    msg_template = 'value is not a valid deque'
+
+
+class TupleError(PydanticTypeError):
+    msg_template = 'value is not a valid tuple'
+
+
+class TupleLengthError(PydanticValueError):
+    code = 'tuple.length'
+    msg_template = 'wrong tuple length {actual_length}, expected {expected_length}'
+
+    def __init__(self, *, actual_length: int, expected_length: int) -> None:
+        super().__init__(actual_length=actual_length, expected_length=expected_length)
+
+
+class ListMinLengthError(PydanticValueError):
+    code = 'list.min_items'
+    msg_template = 'ensure this value has at least {limit_value} items'
+
+    def __init__(self, *, limit_value: int) -> None:
+        super().__init__(limit_value=limit_value)
+
+
+class ListMaxLengthError(PydanticValueError):
+    code = 'list.max_items'
+    msg_template = 'ensure this value has at most {limit_value} items'
+
+    def __init__(self, *, limit_value: int) -> None:
+        super().__init__(limit_value=limit_value)
+
+
+class ListUniqueItemsError(PydanticValueError):
+    code = 'list.unique_items'
+    msg_template = 'the list has duplicated items'
+
+
+class SetMinLengthError(PydanticValueError):
+    code = 'set.min_items'
+    msg_template = 'ensure this value has at least {limit_value} items'
+
+    def __init__(self, *, limit_value: int) -> None:
+        super().__init__(limit_value=limit_value)
+
+
+class SetMaxLengthError(PydanticValueError):
+    code = 'set.max_items'
+    msg_template = 'ensure this value has at most {limit_value} items'
+
+    def __init__(self, *, limit_value: int) -> None:
+        super().__init__(limit_value=limit_value)
+
+
+class FrozenSetMinLengthError(PydanticValueError):
+    code = 'frozenset.min_items'
+    msg_template = 'ensure this value has at least {limit_value} items'
+
+    def __init__(self, *, limit_value: int) -> None:
+        super().__init__(limit_value=limit_value)
+
+
+class FrozenSetMaxLengthError(PydanticValueError):
+    code = 'frozenset.max_items'
+    msg_template = 'ensure this value has at most {limit_value} items'
+
+    def __init__(self, *, limit_value: int) -> None:
+        super().__init__(limit_value=limit_value)
+
+
+class AnyStrMinLengthError(PydanticValueError):
+    code = 'any_str.min_length'
+    msg_template = 'ensure this value has at least {limit_value} characters'
+
+    def __init__(self, *, limit_value: int) -> None:
+        super().__init__(limit_value=limit_value)
+
+
+class AnyStrMaxLengthError(PydanticValueError):
+    code = 'any_str.max_length'
+    msg_template = 'ensure this value has at most {limit_value} characters'
+
+    def __init__(self, *, limit_value: int) -> None:
+        super().__init__(limit_value=limit_value)
+
+
+class StrError(PydanticTypeError):
+    msg_template = 'str type expected'
+
+
+class StrRegexError(PydanticValueError):
+    code = 'str.regex'
+    msg_template = 'string does not match regex "{pattern}"'
+
+    def __init__(self, *, pattern: str) -> None:
+        super().__init__(pattern=pattern)
+
+
+class _NumberBoundError(PydanticValueError):
+    def __init__(self, *, limit_value: Union[int, float, Decimal]) -> None:
+        super().__init__(limit_value=limit_value)
+
+
+class NumberNotGtError(_NumberBoundError):
+    code = 'number.not_gt'
+    msg_template = 'ensure this value is greater than {limit_value}'
+
+
+class NumberNotGeError(_NumberBoundError):
+    code = 'number.not_ge'
+    msg_template = 'ensure this value is greater than or equal to {limit_value}'
+
+
+class NumberNotLtError(_NumberBoundError):
+    code = 'number.not_lt'
+    msg_template = 'ensure this value is less than {limit_value}'
+
+
+class NumberNotLeError(_NumberBoundError):
+    code = 'number.not_le'
+    msg_template = 'ensure this value is less than or equal to {limit_value}'
+
+
+class NumberNotFiniteError(PydanticValueError):
+    code = 'number.not_finite_number'
+    msg_template = 'ensure this value is a finite number'
+
+
+class NumberNotMultipleError(PydanticValueError):
+    code = 'number.not_multiple'
+    msg_template = 'ensure this value is a multiple of {multiple_of}'
+
+    def __init__(self, *, multiple_of: Union[int, float, Decimal]) -> None:
+        super().__init__(multiple_of=multiple_of)
+
+
+class DecimalError(PydanticTypeError):
+    msg_template = 'value is not a valid decimal'
+
+
+class DecimalIsNotFiniteError(PydanticValueError):
+    code = 'decimal.not_finite'
+    msg_template = 'value is not a valid decimal'
+
+
+class DecimalMaxDigitsError(PydanticValueError):
+    code = 'decimal.max_digits'
+    msg_template = 'ensure that there are no more than {max_digits} digits in total'
+
+    def __init__(self, *, max_digits: int) -> None:
+        super().__init__(max_digits=max_digits)
+
+
+class DecimalMaxPlacesError(PydanticValueError):
+    code = 'decimal.max_places'
+    msg_template = 'ensure that there are no more than {decimal_places} decimal places'
+
+    def __init__(self, *, decimal_places: int) -> None:
+        super().__init__(decimal_places=decimal_places)
+
+
+class DecimalWholeDigitsError(PydanticValueError):
+    code = 'decimal.whole_digits'
+    msg_template = 'ensure that there are no more than {whole_digits} digits before the decimal point'
+
+    def __init__(self, *, whole_digits: int) -> None:
+        super().__init__(whole_digits=whole_digits)
+
+
+class DateTimeError(PydanticValueError):
+    msg_template = 'invalid datetime format'
+
+
+class DateError(PydanticValueError):
+    msg_template = 'invalid date format'
+
+
+class DateNotInThePastError(PydanticValueError):
+    code = 'date.not_in_the_past'
+    msg_template = 'date is not in the past'
+
+
+class DateNotInTheFutureError(PydanticValueError):
+    code = 'date.not_in_the_future'
+    msg_template = 'date is not in the future'
+
+
+class TimeError(PydanticValueError):
+    msg_template = 'invalid time format'
+
+
+class DurationError(PydanticValueError):
+    msg_template = 'invalid duration format'
+
+
+class HashableError(PydanticTypeError):
+    msg_template = 'value is not a valid hashable'
+
+
+class UUIDError(PydanticTypeError):
+    msg_template = 'value is not a valid uuid'
+
+
+class UUIDVersionError(PydanticValueError):
+    code = 'uuid.version'
+    msg_template = 'uuid version {required_version} expected'
+
+    def __init__(self, *, required_version: int) -> None:
+        super().__init__(required_version=required_version)
+
+
+class ArbitraryTypeError(PydanticTypeError):
+    code = 'arbitrary_type'
+    msg_template = 'instance of {expected_arbitrary_type} expected'
+
+    def __init__(self, *, expected_arbitrary_type: Type[Any]) -> None:
+        super().__init__(expected_arbitrary_type=display_as_type(expected_arbitrary_type))
+
+
+class ClassError(PydanticTypeError):
+    code = 'class'
+    msg_template = 'a class is expected'
+
+
+class SubclassError(PydanticTypeError):
+    code = 'subclass'
+    msg_template = 'subclass of {expected_class} expected'
+
+    def __init__(self, *, expected_class: Type[Any]) -> None:
+        super().__init__(expected_class=display_as_type(expected_class))
+
+
+class JsonError(PydanticValueError):
+    msg_template = 'Invalid JSON'
+
+
+class JsonTypeError(PydanticTypeError):
+    code = 'json'
+    msg_template = 'JSON object must be str, bytes or bytearray'
+
+
+class PatternError(PydanticValueError):
+    code = 'regex_pattern'
+    msg_template = 'Invalid regular expression'
+
+
+class DataclassTypeError(PydanticTypeError):
+    code = 'dataclass'
+    msg_template = 'instance of {class_name}, tuple or dict expected'
+
+
+class CallableError(PydanticTypeError):
+    msg_template = '{value} is not callable'
+
+
+class EnumError(PydanticTypeError):
+    code = 'enum_instance'
+    msg_template = '{value} is not a valid Enum instance'
+
+
+class IntEnumError(PydanticTypeError):
+    code = 'int_enum_instance'
+    msg_template = '{value} is not a valid IntEnum instance'
+
+
+class IPvAnyAddressError(PydanticValueError):
+    msg_template = 'value is not a valid IPv4 or IPv6 address'
+
+
+class IPvAnyInterfaceError(PydanticValueError):
+    msg_template = 'value is not a valid IPv4 or IPv6 interface'
+
+
+class IPvAnyNetworkError(PydanticValueError):
+    msg_template = 'value is not a valid IPv4 or IPv6 network'
+
+
+class IPv4AddressError(PydanticValueError):
+    msg_template = 'value is not a valid IPv4 address'
+
+
+class IPv6AddressError(PydanticValueError):
+    msg_template = 'value is not a valid IPv6 address'
+
+
+class IPv4NetworkError(PydanticValueError):
+    msg_template = 'value is not a valid IPv4 network'
+
+
+class IPv6NetworkError(PydanticValueError):
+    msg_template = 'value is not a valid IPv6 network'
+
+
+class IPv4InterfaceError(PydanticValueError):
+    msg_template = 'value is not a valid IPv4 interface'
+
+
+class IPv6InterfaceError(PydanticValueError):
+    msg_template = 'value is not a valid IPv6 interface'
+
+
+class ColorError(PydanticValueError):
+    msg_template = 'value is not a valid color: {reason}'
+
+
+class StrictBoolError(PydanticValueError):
+    msg_template = 'value is not a valid boolean'
+
+
+class NotDigitError(PydanticValueError):
+    code = 'payment_card_number.digits'
+    msg_template = 'card number is not all digits'
+
+
+class LuhnValidationError(PydanticValueError):
+    code = 'payment_card_number.luhn_check'
+    msg_template = 'card number is not luhn valid'
+
+
+class InvalidLengthForBrand(PydanticValueError):
+    code = 'payment_card_number.invalid_length_for_brand'
+    msg_template = 'Length for a {brand} card must be {required_length}'
+
+
+class InvalidByteSize(PydanticValueError):
+    msg_template = 'could not parse value and unit from byte string'
+
+
+class InvalidByteSizeUnit(PydanticValueError):
+    msg_template = 'could not interpret byte unit: {unit}'
+
+
+class MissingDiscriminator(PydanticValueError):
+    code = 'discriminated_union.missing_discriminator'
+    msg_template = 'Discriminator {discriminator_key!r} is missing in value'
+
+
+class InvalidDiscriminator(PydanticValueError):
+    code = 'discriminated_union.invalid_discriminator'
+    msg_template = (
+        'No match for discriminator {discriminator_key!r} and value {discriminator_value!r} '
+        '(allowed values: {allowed_values})'
+    )
+
+    def __init__(self, *, discriminator_key: str, discriminator_value: Any, allowed_values: Sequence[Any]) -> None:
+        super().__init__(
+            discriminator_key=discriminator_key,
+            discriminator_value=discriminator_value,
+            allowed_values=', '.join(map(repr, allowed_values)),
+        )
diff --git a/lib/pydantic/v1/fields.py b/lib/pydantic/v1/fields.py
new file mode 100644
index 00000000..60d260e9
--- /dev/null
+++ b/lib/pydantic/v1/fields.py
@@ -0,0 +1,1253 @@
+import copy
+import re
+from collections import Counter as CollectionCounter, defaultdict, deque
+from collections.abc import Callable, Hashable as CollectionsHashable, Iterable as CollectionsIterable
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Counter,
+    DefaultDict,
+    Deque,
+    Dict,
+    ForwardRef,
+    FrozenSet,
+    Generator,
+    Iterable,
+    Iterator,
+    List,
+    Mapping,
+    Optional,
+    Pattern,
+    Sequence,
+    Set,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+)
+
+from typing_extensions import Annotated, Final
+
+from . import errors as errors_
+from .class_validators import Validator, make_generic_validator, prep_validators
+from .error_wrappers import ErrorWrapper
+from .errors import ConfigError, InvalidDiscriminator, MissingDiscriminator, NoneIsNotAllowedError
+from .types import Json, JsonWrapper
+from .typing import (
+    NoArgAnyCallable,
+    convert_generics,
+    display_as_type,
+    get_args,
+    get_origin,
+    is_finalvar,
+    is_literal_type,
+    is_new_type,
+    is_none_type,
+    is_typeddict,
+    is_typeddict_special,
+    is_union,
+    new_type_supertype,
+)
+from .utils import (
+    PyObjectStr,
+    Representation,
+    ValueItems,
+    get_discriminator_alias_and_values,
+    get_unique_discriminator_alias,
+    lenient_isinstance,
+    lenient_issubclass,
+    sequence_like,
+    smart_deepcopy,
+)
+from .validators import constant_validator, dict_validator, find_validators, validate_json
+
+Required: Any = Ellipsis
+
+T = TypeVar('T')
+
+
+class UndefinedType:
+    def __repr__(self) -> str:
+        return 'PydanticUndefined'
+
+    def __copy__(self: T) -> T:
+        return self
+
+    def __reduce__(self) -> str:
+        return 'Undefined'
+
+    def __deepcopy__(self: T, _: Any) -> T:
+        return self
+
+
+Undefined = UndefinedType()
+
+if TYPE_CHECKING:
+    from .class_validators import ValidatorsList
+    from .config import BaseConfig
+    from .error_wrappers import ErrorList
+    from .types import ModelOrDc
+    from .typing import AbstractSetIntStr, MappingIntStrAny, ReprArgs
+
+    ValidateReturn = Tuple[Optional[Any], Optional[ErrorList]]
+    LocStr = Union[Tuple[Union[int, str], ...], str]
+    BoolUndefined = Union[bool, UndefinedType]
+
+
+class FieldInfo(Representation):
+    """
+    Captures extra information about a field.
+    """
+
+    __slots__ = (
+        'default',
+        'default_factory',
+        'alias',
+        'alias_priority',
+        'title',
+        'description',
+        'exclude',
+        'include',
+        'const',
+        'gt',
+        'ge',
+        'lt',
+        'le',
+        'multiple_of',
+        'allow_inf_nan',
+        'max_digits',
+        'decimal_places',
+        'min_items',
+        'max_items',
+        'unique_items',
+        'min_length',
+        'max_length',
+        'allow_mutation',
+        'repr',
+        'regex',
+        'discriminator',
+        'extra',
+    )
+
+    # field constraints with the default value, it's also used in update_from_config below
+    __field_constraints__ = {
+        'min_length': None,
+        'max_length': None,
+        'regex': None,
+        'gt': None,
+        'lt': None,
+        'ge': None,
+        'le': None,
+        'multiple_of': None,
+        'allow_inf_nan': None,
+        'max_digits': None,
+        'decimal_places': None,
+        'min_items': None,
+        'max_items': None,
+        'unique_items': None,
+        'allow_mutation': True,
+    }
+
+    def __init__(self, default: Any = Undefined, **kwargs: Any) -> None:
+        self.default = default
+        self.default_factory = kwargs.pop('default_factory', None)
+        self.alias = kwargs.pop('alias', None)
+        self.alias_priority = kwargs.pop('alias_priority', 2 if self.alias is not None else None)
+        self.title = kwargs.pop('title', None)
+        self.description = kwargs.pop('description', None)
+        self.exclude = kwargs.pop('exclude', None)
+        self.include = kwargs.pop('include', None)
+        self.const = kwargs.pop('const', None)
+        self.gt = kwargs.pop('gt', None)
+        self.ge = kwargs.pop('ge', None)
+        self.lt = kwargs.pop('lt', None)
+        self.le = kwargs.pop('le', None)
+        self.multiple_of = kwargs.pop('multiple_of', None)
+        self.allow_inf_nan = kwargs.pop('allow_inf_nan', None)
+        self.max_digits = kwargs.pop('max_digits', None)
+        self.decimal_places = kwargs.pop('decimal_places', None)
+        self.min_items = kwargs.pop('min_items', None)
+        self.max_items = kwargs.pop('max_items', None)
+        self.unique_items = kwargs.pop('unique_items', None)
+        self.min_length = kwargs.pop('min_length', None)
+        self.max_length = kwargs.pop('max_length', None)
+        self.allow_mutation = kwargs.pop('allow_mutation', True)
+        self.regex = kwargs.pop('regex', None)
+        self.discriminator = kwargs.pop('discriminator', None)
+        self.repr = kwargs.pop('repr', True)
+        self.extra = kwargs
+
+    def __repr_args__(self) -> 'ReprArgs':
+        field_defaults_to_hide: Dict[str, Any] = {
+            'repr': True,
+            **self.__field_constraints__,
+        }
+
+        attrs = ((s, getattr(self, s)) for s in self.__slots__)
+        return [(a, v) for a, v in attrs if v != field_defaults_to_hide.get(a, None)]
+
+    def get_constraints(self) -> Set[str]:
+        """
+        Gets the constraints set on the field by comparing the constraint value with its default value
+
+        :return: the constraints set on field_info
+        """
+        return {attr for attr, default in self.__field_constraints__.items() if getattr(self, attr) != default}
+
+    def update_from_config(self, from_config: Dict[str, Any]) -> None:
+        """
+        Update this FieldInfo based on a dict from get_field_info, only fields which have not been set are dated.
+        """
+        for attr_name, value in from_config.items():
+            try:
+                current_value = getattr(self, attr_name)
+            except AttributeError:
+                # attr_name is not an attribute of FieldInfo, it should therefore be added to extra
+                # (except if extra already has this value!)
+                self.extra.setdefault(attr_name, value)
+            else:
+                if current_value is self.__field_constraints__.get(attr_name, None):
+                    setattr(self, attr_name, value)
+                elif attr_name == 'exclude':
+                    self.exclude = ValueItems.merge(value, current_value)
+                elif attr_name == 'include':
+                    self.include = ValueItems.merge(value, current_value, intersect=True)
+
+    def _validate(self) -> None:
+        if self.default is not Undefined and self.default_factory is not None:
+            raise ValueError('cannot specify both default and default_factory')
+
+
+def Field(
+    default: Any = Undefined,
+    *,
+    default_factory: Optional[NoArgAnyCallable] = None,
+    alias: Optional[str] = None,
+    title: Optional[str] = None,
+    description: Optional[str] = None,
+    exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny', Any]] = None,
+    include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny', Any]] = None,
+    const: Optional[bool] = None,
+    gt: Optional[float] = None,
+    ge: Optional[float] = None,
+    lt: Optional[float] = None,
+    le: Optional[float] = None,
+    multiple_of: Optional[float] = None,
+    allow_inf_nan: Optional[bool] = None,
+    max_digits: Optional[int] = None,
+    decimal_places: Optional[int] = None,
+    min_items: Optional[int] = None,
+    max_items: Optional[int] = None,
+    unique_items: Optional[bool] = None,
+    min_length: Optional[int] = None,
+    max_length: Optional[int] = None,
+    allow_mutation: bool = True,
+    regex: Optional[str] = None,
+    discriminator: Optional[str] = None,
+    repr: bool = True,
+    **extra: Any,
+) -> Any:
+    """
+    Used to provide extra information about a field, either for the model schema or complex validation. Some arguments
+    apply only to number fields (``int``, ``float``, ``Decimal``) and some apply only to ``str``.
+
+    :param default: since this is replacing the field’s default, its first argument is used
+      to set the default, use ellipsis (``...``) to indicate the field is required
+    :param default_factory: callable that will be called when a default value is needed for this field
+      If both `default` and `default_factory` are set, an error is raised.
+    :param alias: the public name of the field
+    :param title: can be any string, used in the schema
+    :param description: can be any string, used in the schema
+    :param exclude: exclude this field while dumping.
+      Takes same values as the ``include`` and ``exclude`` arguments on the ``.dict`` method.
+    :param include: include this field while dumping.
+      Takes same values as the ``include`` and ``exclude`` arguments on the ``.dict`` method.
+    :param const: this field is required and *must* take it's default value
+    :param gt: only applies to numbers, requires the field to be "greater than". The schema
+      will have an ``exclusiveMinimum`` validation keyword
+    :param ge: only applies to numbers, requires the field to be "greater than or equal to". The
+      schema will have a ``minimum`` validation keyword
+    :param lt: only applies to numbers, requires the field to be "less than". The schema
+      will have an ``exclusiveMaximum`` validation keyword
+    :param le: only applies to numbers, requires the field to be "less than or equal to". The
+      schema will have a ``maximum`` validation keyword
+    :param multiple_of: only applies to numbers, requires the field to be "a multiple of". The
+      schema will have a ``multipleOf`` validation keyword
+    :param allow_inf_nan: only applies to numbers, allows the field to be NaN or infinity (+inf or -inf),
+        which is a valid Python float. Default True, set to False for compatibility with JSON.
+    :param max_digits: only applies to Decimals, requires the field to have a maximum number
+      of digits within the decimal. It does not include a zero before the decimal point or trailing decimal zeroes.
+    :param decimal_places: only applies to Decimals, requires the field to have at most a number of decimal places
+      allowed. It does not include trailing decimal zeroes.
+    :param min_items: only applies to lists, requires the field to have a minimum number of
+      elements. The schema will have a ``minItems`` validation keyword
+    :param max_items: only applies to lists, requires the field to have a maximum number of
+      elements. The schema will have a ``maxItems`` validation keyword
+    :param unique_items: only applies to lists, requires the field not to have duplicated
+      elements. The schema will have a ``uniqueItems`` validation keyword
+    :param min_length: only applies to strings, requires the field to have a minimum length. The
+      schema will have a ``minLength`` validation keyword
+    :param max_length: only applies to strings, requires the field to have a maximum length. The
+      schema will have a ``maxLength`` validation keyword
+    :param allow_mutation: a boolean which defaults to True. When False, the field raises a TypeError if the field is
+      assigned on an instance.  The BaseModel Config must set validate_assignment to True
+    :param regex: only applies to strings, requires the field match against a regular expression
+      pattern string. The schema will have a ``pattern`` validation keyword
+    :param discriminator: only useful with a (discriminated a.k.a. tagged) `Union` of sub models with a common field.
+      The `discriminator` is the name of this common field to shorten validation and improve generated schema
+    :param repr: show this field in the representation
+    :param **extra: any additional keyword arguments will be added as is to the schema
+    """
+    field_info = FieldInfo(
+        default,
+        default_factory=default_factory,
+        alias=alias,
+        title=title,
+        description=description,
+        exclude=exclude,
+        include=include,
+        const=const,
+        gt=gt,
+        ge=ge,
+        lt=lt,
+        le=le,
+        multiple_of=multiple_of,
+        allow_inf_nan=allow_inf_nan,
+        max_digits=max_digits,
+        decimal_places=decimal_places,
+        min_items=min_items,
+        max_items=max_items,
+        unique_items=unique_items,
+        min_length=min_length,
+        max_length=max_length,
+        allow_mutation=allow_mutation,
+        regex=regex,
+        discriminator=discriminator,
+        repr=repr,
+        **extra,
+    )
+    field_info._validate()
+    return field_info
+
+
+# used to be an enum but changed to int's for small performance improvement as less access overhead
+SHAPE_SINGLETON = 1
+SHAPE_LIST = 2
+SHAPE_SET = 3
+SHAPE_MAPPING = 4
+SHAPE_TUPLE = 5
+SHAPE_TUPLE_ELLIPSIS = 6
+SHAPE_SEQUENCE = 7
+SHAPE_FROZENSET = 8
+SHAPE_ITERABLE = 9
+SHAPE_GENERIC = 10
+SHAPE_DEQUE = 11
+SHAPE_DICT = 12
+SHAPE_DEFAULTDICT = 13
+SHAPE_COUNTER = 14
+SHAPE_NAME_LOOKUP = {
+    SHAPE_LIST: 'List[{}]',
+    SHAPE_SET: 'Set[{}]',
+    SHAPE_TUPLE_ELLIPSIS: 'Tuple[{}, ...]',
+    SHAPE_SEQUENCE: 'Sequence[{}]',
+    SHAPE_FROZENSET: 'FrozenSet[{}]',
+    SHAPE_ITERABLE: 'Iterable[{}]',
+    SHAPE_DEQUE: 'Deque[{}]',
+    SHAPE_DICT: 'Dict[{}]',
+    SHAPE_DEFAULTDICT: 'DefaultDict[{}]',
+    SHAPE_COUNTER: 'Counter[{}]',
+}
+
+MAPPING_LIKE_SHAPES: Set[int] = {SHAPE_DEFAULTDICT, SHAPE_DICT, SHAPE_MAPPING, SHAPE_COUNTER}
+
+
+class ModelField(Representation):
+    __slots__ = (
+        'type_',
+        'outer_type_',
+        'annotation',
+        'sub_fields',
+        'sub_fields_mapping',
+        'key_field',
+        'validators',
+        'pre_validators',
+        'post_validators',
+        'default',
+        'default_factory',
+        'required',
+        'final',
+        'model_config',
+        'name',
+        'alias',
+        'has_alias',
+        'field_info',
+        'discriminator_key',
+        'discriminator_alias',
+        'validate_always',
+        'allow_none',
+        'shape',
+        'class_validators',
+        'parse_json',
+    )
+
+    def __init__(
+        self,
+        *,
+        name: str,
+        type_: Type[Any],
+        class_validators: Optional[Dict[str, Validator]],
+        model_config: Type['BaseConfig'],
+        default: Any = None,
+        default_factory: Optional[NoArgAnyCallable] = None,
+        required: 'BoolUndefined' = Undefined,
+        final: bool = False,
+        alias: Optional[str] = None,
+        field_info: Optional[FieldInfo] = None,
+    ) -> None:
+        self.name: str = name
+        self.has_alias: bool = alias is not None
+        self.alias: str = alias if alias is not None else name
+        self.annotation = type_
+        self.type_: Any = convert_generics(type_)
+        self.outer_type_: Any = type_
+        self.class_validators = class_validators or {}
+        self.default: Any = default
+        self.default_factory: Optional[NoArgAnyCallable] = default_factory
+        self.required: 'BoolUndefined' = required
+        self.final: bool = final
+        self.model_config = model_config
+        self.field_info: FieldInfo = field_info or FieldInfo(default)
+        self.discriminator_key: Optional[str] = self.field_info.discriminator
+        self.discriminator_alias: Optional[str] = self.discriminator_key
+
+        self.allow_none: bool = False
+        self.validate_always: bool = False
+        self.sub_fields: Optional[List[ModelField]] = None
+        self.sub_fields_mapping: Optional[Dict[str, 'ModelField']] = None  # used for discriminated union
+        self.key_field: Optional[ModelField] = None
+        self.validators: 'ValidatorsList' = []
+        self.pre_validators: Optional['ValidatorsList'] = None
+        self.post_validators: Optional['ValidatorsList'] = None
+        self.parse_json: bool = False
+        self.shape: int = SHAPE_SINGLETON
+        self.model_config.prepare_field(self)
+        self.prepare()
+
+    def get_default(self) -> Any:
+        return smart_deepcopy(self.default) if self.default_factory is None else self.default_factory()
+
+    @staticmethod
+    def _get_field_info(
+        field_name: str, annotation: Any, value: Any, config: Type['BaseConfig']
+    ) -> Tuple[FieldInfo, Any]:
+        """
+        Get a FieldInfo from a root typing.Annotated annotation, value, or config default.
+
+        The FieldInfo may be set in typing.Annotated or the value, but not both. If neither contain
+        a FieldInfo, a new one will be created using the config.
+
+        :param field_name: name of the field for use in error messages
+        :param annotation: a type hint such as `str` or `Annotated[str, Field(..., min_length=5)]`
+        :param value: the field's assigned value
+        :param config: the model's config object
+        :return: the FieldInfo contained in the `annotation`, the value, or a new one from the config.
+        """
+        field_info_from_config = config.get_field_info(field_name)
+
+        field_info = None
+        if get_origin(annotation) is Annotated:
+            field_infos = [arg for arg in get_args(annotation)[1:] if isinstance(arg, FieldInfo)]
+            if len(field_infos) > 1:
+                raise ValueError(f'cannot specify multiple `Annotated` `Field`s for {field_name!r}')
+            field_info = next(iter(field_infos), None)
+            if field_info is not None:
+                field_info = copy.copy(field_info)
+                field_info.update_from_config(field_info_from_config)
+                if field_info.default not in (Undefined, Required):
+                    raise ValueError(f'`Field` default cannot be set in `Annotated` for {field_name!r}')
+                if value is not Undefined and value is not Required:
+                    # check also `Required` because of `validate_arguments` that sets `...` as default value
+                    field_info.default = value
+
+        if isinstance(value, FieldInfo):
+            if field_info is not None:
+                raise ValueError(f'cannot specify `Annotated` and value `Field`s together for {field_name!r}')
+            field_info = value
+            field_info.update_from_config(field_info_from_config)
+        elif field_info is None:
+            field_info = FieldInfo(value, **field_info_from_config)
+        value = None if field_info.default_factory is not None else field_info.default
+        field_info._validate()
+        return field_info, value
+
+    @classmethod
+    def infer(
+        cls,
+        *,
+        name: str,
+        value: Any,
+        annotation: Any,
+        class_validators: Optional[Dict[str, Validator]],
+        config: Type['BaseConfig'],
+    ) -> 'ModelField':
+        from .schema import get_annotation_from_field_info
+
+        field_info, value = cls._get_field_info(name, annotation, value, config)
+        required: 'BoolUndefined' = Undefined
+        if value is Required:
+            required = True
+            value = None
+        elif value is not Undefined:
+            required = False
+        annotation = get_annotation_from_field_info(annotation, field_info, name, config.validate_assignment)
+
+        return cls(
+            name=name,
+            type_=annotation,
+            alias=field_info.alias,
+            class_validators=class_validators,
+            default=value,
+            default_factory=field_info.default_factory,
+            required=required,
+            model_config=config,
+            field_info=field_info,
+        )
+
+    def set_config(self, config: Type['BaseConfig']) -> None:
+        self.model_config = config
+        info_from_config = config.get_field_info(self.name)
+        config.prepare_field(self)
+        new_alias = info_from_config.get('alias')
+        new_alias_priority = info_from_config.get('alias_priority') or 0
+        if new_alias and new_alias_priority >= (self.field_info.alias_priority or 0):
+            self.field_info.alias = new_alias
+            self.field_info.alias_priority = new_alias_priority
+            self.alias = new_alias
+        new_exclude = info_from_config.get('exclude')
+        if new_exclude is not None:
+            self.field_info.exclude = ValueItems.merge(self.field_info.exclude, new_exclude)
+        new_include = info_from_config.get('include')
+        if new_include is not None:
+            self.field_info.include = ValueItems.merge(self.field_info.include, new_include, intersect=True)
+
+    @property
+    def alt_alias(self) -> bool:
+        return self.name != self.alias
+
+    def prepare(self) -> None:
+        """
+        Prepare the field but inspecting self.default, self.type_ etc.
+
+        Note: this method is **not** idempotent (because _type_analysis is not idempotent),
+        e.g. calling it it multiple times may modify the field and configure it incorrectly.
+        """
+        self._set_default_and_type()
+        if self.type_.__class__ is ForwardRef or self.type_.__class__ is DeferredType:
+            # self.type_ is currently a ForwardRef and there's nothing we can do now,
+            # user will need to call model.update_forward_refs()
+            return
+
+        self._type_analysis()
+        if self.required is Undefined:
+            self.required = True
+        if self.default is Undefined and self.default_factory is None:
+            self.default = None
+        self.populate_validators()
+
+    def _set_default_and_type(self) -> None:
+        """
+        Set the default value, infer the type if needed and check if `None` value is valid.
+        """
+        if self.default_factory is not None:
+            if self.type_ is Undefined:
+                raise errors_.ConfigError(
+                    f'you need to set the type of field {self.name!r} when using `default_factory`'
+                )
+            return
+
+        default_value = self.get_default()
+
+        if default_value is not None and self.type_ is Undefined:
+            self.type_ = default_value.__class__
+            self.outer_type_ = self.type_
+            self.annotation = self.type_
+
+        if self.type_ is Undefined:
+            raise errors_.ConfigError(f'unable to infer type for attribute "{self.name}"')
+
+        if self.required is False and default_value is None:
+            self.allow_none = True
+
+    def _type_analysis(self) -> None:  # noqa: C901 (ignore complexity)
+        # typing interface is horrible, we have to do some ugly checks
+        if lenient_issubclass(self.type_, JsonWrapper):
+            self.type_ = self.type_.inner_type
+            self.parse_json = True
+        elif lenient_issubclass(self.type_, Json):
+            self.type_ = Any
+            self.parse_json = True
+        elif isinstance(self.type_, TypeVar):
+            if self.type_.__bound__:
+                self.type_ = self.type_.__bound__
+            elif self.type_.__constraints__:
+                self.type_ = Union[self.type_.__constraints__]
+            else:
+                self.type_ = Any
+        elif is_new_type(self.type_):
+            self.type_ = new_type_supertype(self.type_)
+
+        if self.type_ is Any or self.type_ is object:
+            if self.required is Undefined:
+                self.required = False
+            self.allow_none = True
+            return
+        elif self.type_ is Pattern or self.type_ is re.Pattern:
+            # python 3.7 only, Pattern is a typing object but without sub fields
+            return
+        elif is_literal_type(self.type_):
+            return
+        elif is_typeddict(self.type_):
+            return
+
+        if is_finalvar(self.type_):
+            self.final = True
+
+            if self.type_ is Final:
+                self.type_ = Any
+            else:
+                self.type_ = get_args(self.type_)[0]
+
+            self._type_analysis()
+            return
+
+        origin = get_origin(self.type_)
+
+        if origin is Annotated or is_typeddict_special(origin):
+            self.type_ = get_args(self.type_)[0]
+            self._type_analysis()
+            return
+
+        if self.discriminator_key is not None and not is_union(origin):
+            raise TypeError('`discriminator` can only be used with `Union` type with more than one variant')
+
+        # add extra check for `collections.abc.Hashable` for python 3.10+ where origin is not `None`
+        if origin is None or origin is CollectionsHashable:
+            # field is not "typing" object eg. Union, Dict, List etc.
+            # allow None for virtual superclasses of NoneType, e.g. Hashable
+            if isinstance(self.type_, type) and isinstance(None, self.type_):
+                self.allow_none = True
+            return
+        elif origin is Callable:
+            return
+        elif is_union(origin):
+            types_ = []
+            for type_ in get_args(self.type_):
+                if is_none_type(type_) or type_ is Any or type_ is object:
+                    if self.required is Undefined:
+                        self.required = False
+                    self.allow_none = True
+                if is_none_type(type_):
+                    continue
+                types_.append(type_)
+
+            if len(types_) == 1:
+                # Optional[]
+                self.type_ = types_[0]
+                # this is the one case where the "outer type" isn't just the original type
+                self.outer_type_ = self.type_
+                # re-run to correctly interpret the new self.type_
+                self._type_analysis()
+            else:
+                self.sub_fields = [self._create_sub_type(t, f'{self.name}_{display_as_type(t)}') for t in types_]
+
+                if self.discriminator_key is not None:
+                    self.prepare_discriminated_union_sub_fields()
+            return
+        elif issubclass(origin, Tuple):  # type: ignore
+            # origin == Tuple without item type
+            args = get_args(self.type_)
+            if not args:  # plain tuple
+                self.type_ = Any
+                self.shape = SHAPE_TUPLE_ELLIPSIS
+            elif len(args) == 2 and args[1] is Ellipsis:  # e.g. Tuple[int, ...]
+                self.type_ = args[0]
+                self.shape = SHAPE_TUPLE_ELLIPSIS
+                self.sub_fields = [self._create_sub_type(args[0], f'{self.name}_0')]
+            elif args == ((),):  # Tuple[()] means empty tuple
+                self.shape = SHAPE_TUPLE
+                self.type_ = Any
+                self.sub_fields = []
+            else:
+                self.shape = SHAPE_TUPLE
+                self.sub_fields = [self._create_sub_type(t, f'{self.name}_{i}') for i, t in enumerate(args)]
+            return
+        elif issubclass(origin, List):
+            # Create self validators
+            get_validators = getattr(self.type_, '__get_validators__', None)
+            if get_validators:
+                self.class_validators.update(
+                    {f'list_{i}': Validator(validator, pre=True) for i, validator in enumerate(get_validators())}
+                )
+
+            self.type_ = get_args(self.type_)[0]
+            self.shape = SHAPE_LIST
+        elif issubclass(origin, Set):
+            # Create self validators
+            get_validators = getattr(self.type_, '__get_validators__', None)
+            if get_validators:
+                self.class_validators.update(
+                    {f'set_{i}': Validator(validator, pre=True) for i, validator in enumerate(get_validators())}
+                )
+
+            self.type_ = get_args(self.type_)[0]
+            self.shape = SHAPE_SET
+        elif issubclass(origin, FrozenSet):
+            # Create self validators
+            get_validators = getattr(self.type_, '__get_validators__', None)
+            if get_validators:
+                self.class_validators.update(
+                    {f'frozenset_{i}': Validator(validator, pre=True) for i, validator in enumerate(get_validators())}
+                )
+
+            self.type_ = get_args(self.type_)[0]
+            self.shape = SHAPE_FROZENSET
+        elif issubclass(origin, Deque):
+            self.type_ = get_args(self.type_)[0]
+            self.shape = SHAPE_DEQUE
+        elif issubclass(origin, Sequence):
+            self.type_ = get_args(self.type_)[0]
+            self.shape = SHAPE_SEQUENCE
+        # priority to most common mapping: dict
+        elif origin is dict or origin is Dict:
+            self.key_field = self._create_sub_type(get_args(self.type_)[0], 'key_' + self.name, for_keys=True)
+            self.type_ = get_args(self.type_)[1]
+            self.shape = SHAPE_DICT
+        elif issubclass(origin, DefaultDict):
+            self.key_field = self._create_sub_type(get_args(self.type_)[0], 'key_' + self.name, for_keys=True)
+            self.type_ = get_args(self.type_)[1]
+            self.shape = SHAPE_DEFAULTDICT
+        elif issubclass(origin, Counter):
+            self.key_field = self._create_sub_type(get_args(self.type_)[0], 'key_' + self.name, for_keys=True)
+            self.type_ = int
+            self.shape = SHAPE_COUNTER
+        elif issubclass(origin, Mapping):
+            self.key_field = self._create_sub_type(get_args(self.type_)[0], 'key_' + self.name, for_keys=True)
+            self.type_ = get_args(self.type_)[1]
+            self.shape = SHAPE_MAPPING
+        # Equality check as almost everything inherits form Iterable, including str
+        # check for Iterable and CollectionsIterable, as it could receive one even when declared with the other
+        elif origin in {Iterable, CollectionsIterable}:
+            self.type_ = get_args(self.type_)[0]
+            self.shape = SHAPE_ITERABLE
+            self.sub_fields = [self._create_sub_type(self.type_, f'{self.name}_type')]
+        elif issubclass(origin, Type):  # type: ignore
+            return
+        elif hasattr(origin, '__get_validators__') or self.model_config.arbitrary_types_allowed:
+            # Is a Pydantic-compatible generic that handles itself
+            # or we have arbitrary_types_allowed = True
+            self.shape = SHAPE_GENERIC
+            self.sub_fields = [self._create_sub_type(t, f'{self.name}_{i}') for i, t in enumerate(get_args(self.type_))]
+            self.type_ = origin
+            return
+        else:
+            raise TypeError(f'Fields of type "{origin}" are not supported.')
+
+        # type_ has been refined eg. as the type of a List and sub_fields needs to be populated
+        self.sub_fields = [self._create_sub_type(self.type_, '_' + self.name)]
+
+    def prepare_discriminated_union_sub_fields(self) -> None:
+        """
+        Prepare the mapping <discriminator key> -> <ModelField> and update `sub_fields`
+        Note that this process can be aborted if a `ForwardRef` is encountered
+        """
+        assert self.discriminator_key is not None
+
+        if self.type_.__class__ is DeferredType:
+            return
+
+        assert self.sub_fields is not None
+        sub_fields_mapping: Dict[str, 'ModelField'] = {}
+        all_aliases: Set[str] = set()
+
+        for sub_field in self.sub_fields:
+            t = sub_field.type_
+            if t.__class__ is ForwardRef:
+                # Stopping everything...will need to call `update_forward_refs`
+                return
+
+            alias, discriminator_values = get_discriminator_alias_and_values(t, self.discriminator_key)
+            all_aliases.add(alias)
+            for discriminator_value in discriminator_values:
+                sub_fields_mapping[discriminator_value] = sub_field
+
+        self.sub_fields_mapping = sub_fields_mapping
+        self.discriminator_alias = get_unique_discriminator_alias(all_aliases, self.discriminator_key)
+
+    def _create_sub_type(self, type_: Type[Any], name: str, *, for_keys: bool = False) -> 'ModelField':
+        if for_keys:
+            class_validators = None
+        else:
+            # validators for sub items should not have `each_item` as we want to check only the first sublevel
+            class_validators = {
+                k: Validator(
+                    func=v.func,
+                    pre=v.pre,
+                    each_item=False,
+                    always=v.always,
+                    check_fields=v.check_fields,
+                    skip_on_failure=v.skip_on_failure,
+                )
+                for k, v in self.class_validators.items()
+                if v.each_item
+            }
+
+        field_info, _ = self._get_field_info(name, type_, None, self.model_config)
+
+        return self.__class__(
+            type_=type_,
+            name=name,
+            class_validators=class_validators,
+            model_config=self.model_config,
+            field_info=field_info,
+        )
+
+    def populate_validators(self) -> None:
+        """
+        Prepare self.pre_validators, self.validators, and self.post_validators based on self.type_'s  __get_validators__
+        and class validators. This method should be idempotent, e.g. it should be safe to call multiple times
+        without mis-configuring the field.
+        """
+        self.validate_always = getattr(self.type_, 'validate_always', False) or any(
+            v.always for v in self.class_validators.values()
+        )
+
+        class_validators_ = self.class_validators.values()
+        if not self.sub_fields or self.shape == SHAPE_GENERIC:
+            get_validators = getattr(self.type_, '__get_validators__', None)
+            v_funcs = (
+                *[v.func for v in class_validators_ if v.each_item and v.pre],
+                *(get_validators() if get_validators else list(find_validators(self.type_, self.model_config))),
+                *[v.func for v in class_validators_ if v.each_item and not v.pre],
+            )
+            self.validators = prep_validators(v_funcs)
+
+        self.pre_validators = []
+        self.post_validators = []
+
+        if self.field_info and self.field_info.const:
+            self.post_validators.append(make_generic_validator(constant_validator))
+
+        if class_validators_:
+            self.pre_validators += prep_validators(v.func for v in class_validators_ if not v.each_item and v.pre)
+            self.post_validators += prep_validators(v.func for v in class_validators_ if not v.each_item and not v.pre)
+
+        if self.parse_json:
+            self.pre_validators.append(make_generic_validator(validate_json))
+
+        self.pre_validators = self.pre_validators or None
+        self.post_validators = self.post_validators or None
+
+    def validate(
+        self, v: Any, values: Dict[str, Any], *, loc: 'LocStr', cls: Optional['ModelOrDc'] = None
+    ) -> 'ValidateReturn':
+        assert self.type_.__class__ is not DeferredType
+
+        if self.type_.__class__ is ForwardRef:
+            assert cls is not None
+            raise ConfigError(
+                f'field "{self.name}" not yet prepared so type is still a ForwardRef, '
+                f'you might need to call {cls.__name__}.update_forward_refs().'
+            )
+
+        errors: Optional['ErrorList']
+        if self.pre_validators:
+            v, errors = self._apply_validators(v, values, loc, cls, self.pre_validators)
+            if errors:
+                return v, errors
+
+        if v is None:
+            if is_none_type(self.type_):
+                # keep validating
+                pass
+            elif self.allow_none:
+                if self.post_validators:
+                    return self._apply_validators(v, values, loc, cls, self.post_validators)
+                else:
+                    return None, None
+            else:
+                return v, ErrorWrapper(NoneIsNotAllowedError(), loc)
+
+        if self.shape == SHAPE_SINGLETON:
+            v, errors = self._validate_singleton(v, values, loc, cls)
+        elif self.shape in MAPPING_LIKE_SHAPES:
+            v, errors = self._validate_mapping_like(v, values, loc, cls)
+        elif self.shape == SHAPE_TUPLE:
+            v, errors = self._validate_tuple(v, values, loc, cls)
+        elif self.shape == SHAPE_ITERABLE:
+            v, errors = self._validate_iterable(v, values, loc, cls)
+        elif self.shape == SHAPE_GENERIC:
+            v, errors = self._apply_validators(v, values, loc, cls, self.validators)
+        else:
+            #  sequence, list, set, generator, tuple with ellipsis, frozen set
+            v, errors = self._validate_sequence_like(v, values, loc, cls)
+
+        if not errors and self.post_validators:
+            v, errors = self._apply_validators(v, values, loc, cls, self.post_validators)
+        return v, errors
+
+    def _validate_sequence_like(  # noqa: C901 (ignore complexity)
+        self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc']
+    ) -> 'ValidateReturn':
+        """
+        Validate sequence-like containers: lists, tuples, sets and generators
+        Note that large if-else blocks are necessary to enable Cython
+        optimization, which is why we disable the complexity check above.
+        """
+        if not sequence_like(v):
+            e: errors_.PydanticTypeError
+            if self.shape == SHAPE_LIST:
+                e = errors_.ListError()
+            elif self.shape in (SHAPE_TUPLE, SHAPE_TUPLE_ELLIPSIS):
+                e = errors_.TupleError()
+            elif self.shape == SHAPE_SET:
+                e = errors_.SetError()
+            elif self.shape == SHAPE_FROZENSET:
+                e = errors_.FrozenSetError()
+            else:
+                e = errors_.SequenceError()
+            return v, ErrorWrapper(e, loc)
+
+        loc = loc if isinstance(loc, tuple) else (loc,)
+        result = []
+        errors: List[ErrorList] = []
+        for i, v_ in enumerate(v):
+            v_loc = *loc, i
+            r, ee = self._validate_singleton(v_, values, v_loc, cls)
+            if ee:
+                errors.append(ee)
+            else:
+                result.append(r)
+
+        if errors:
+            return v, errors
+
+        converted: Union[List[Any], Set[Any], FrozenSet[Any], Tuple[Any, ...], Iterator[Any], Deque[Any]] = result
+
+        if self.shape == SHAPE_SET:
+            converted = set(result)
+        elif self.shape == SHAPE_FROZENSET:
+            converted = frozenset(result)
+        elif self.shape == SHAPE_TUPLE_ELLIPSIS:
+            converted = tuple(result)
+        elif self.shape == SHAPE_DEQUE:
+            converted = deque(result, maxlen=getattr(v, 'maxlen', None))
+        elif self.shape == SHAPE_SEQUENCE:
+            if isinstance(v, tuple):
+                converted = tuple(result)
+            elif isinstance(v, set):
+                converted = set(result)
+            elif isinstance(v, Generator):
+                converted = iter(result)
+            elif isinstance(v, deque):
+                converted = deque(result, maxlen=getattr(v, 'maxlen', None))
+        return converted, None
+
+    def _validate_iterable(
+        self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc']
+    ) -> 'ValidateReturn':
+        """
+        Validate Iterables.
+
+        This intentionally doesn't validate values to allow infinite generators.
+        """
+
+        try:
+            iterable = iter(v)
+        except TypeError:
+            return v, ErrorWrapper(errors_.IterableError(), loc)
+        return iterable, None
+
+    def _validate_tuple(
+        self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc']
+    ) -> 'ValidateReturn':
+        e: Optional[Exception] = None
+        if not sequence_like(v):
+            e = errors_.TupleError()
+        else:
+            actual_length, expected_length = len(v), len(self.sub_fields)  # type: ignore
+            if actual_length != expected_length:
+                e = errors_.TupleLengthError(actual_length=actual_length, expected_length=expected_length)
+
+        if e:
+            return v, ErrorWrapper(e, loc)
+
+        loc = loc if isinstance(loc, tuple) else (loc,)
+        result = []
+        errors: List[ErrorList] = []
+        for i, (v_, field) in enumerate(zip(v, self.sub_fields)):  # type: ignore
+            v_loc = *loc, i
+            r, ee = field.validate(v_, values, loc=v_loc, cls=cls)
+            if ee:
+                errors.append(ee)
+            else:
+                result.append(r)
+
+        if errors:
+            return v, errors
+        else:
+            return tuple(result), None
+
+    def _validate_mapping_like(
+        self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc']
+    ) -> 'ValidateReturn':
+        try:
+            v_iter = dict_validator(v)
+        except TypeError as exc:
+            return v, ErrorWrapper(exc, loc)
+
+        loc = loc if isinstance(loc, tuple) else (loc,)
+        result, errors = {}, []
+        for k, v_ in v_iter.items():
+            v_loc = *loc, '__key__'
+            key_result, key_errors = self.key_field.validate(k, values, loc=v_loc, cls=cls)  # type: ignore
+            if key_errors:
+                errors.append(key_errors)
+                continue
+
+            v_loc = *loc, k
+            value_result, value_errors = self._validate_singleton(v_, values, v_loc, cls)
+            if value_errors:
+                errors.append(value_errors)
+                continue
+
+            result[key_result] = value_result
+        if errors:
+            return v, errors
+        elif self.shape == SHAPE_DICT:
+            return result, None
+        elif self.shape == SHAPE_DEFAULTDICT:
+            return defaultdict(self.type_, result), None
+        elif self.shape == SHAPE_COUNTER:
+            return CollectionCounter(result), None
+        else:
+            return self._get_mapping_value(v, result), None
+
+    def _get_mapping_value(self, original: T, converted: Dict[Any, Any]) -> Union[T, Dict[Any, Any]]:
+        """
+        When type is `Mapping[KT, KV]` (or another unsupported mapping), we try to avoid
+        coercing to `dict` unwillingly.
+        """
+        original_cls = original.__class__
+
+        if original_cls == dict or original_cls == Dict:
+            return converted
+        elif original_cls in {defaultdict, DefaultDict}:
+            return defaultdict(self.type_, converted)
+        else:
+            try:
+                # Counter, OrderedDict, UserDict, ...
+                return original_cls(converted)  # type: ignore
+            except TypeError:
+                raise RuntimeError(f'Could not convert dictionary to {original_cls.__name__!r}') from None
+
+    def _validate_singleton(
+        self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc']
+    ) -> 'ValidateReturn':
+        if self.sub_fields:
+            if self.discriminator_key is not None:
+                return self._validate_discriminated_union(v, values, loc, cls)
+
+            errors = []
+
+            if self.model_config.smart_union and is_union(get_origin(self.type_)):
+                # 1st pass: check if the value is an exact instance of one of the Union types
+                # (e.g. to avoid coercing a bool into an int)
+                for field in self.sub_fields:
+                    if v.__class__ is field.outer_type_:
+                        return v, None
+
+                # 2nd pass: check if the value is an instance of any subclass of the Union types
+                for field in self.sub_fields:
+                    # This whole logic will be improved later on to support more complex `isinstance` checks
+                    # It will probably be done once a strict mode is added and be something like:
+                    # ```
+                    #     value, error = field.validate(v, values, strict=True)
+                    #     if error is None:
+                    #         return value, None
+                    # ```
+                    try:
+                        if isinstance(v, field.outer_type_):
+                            return v, None
+                    except TypeError:
+                        # compound type
+                        if lenient_isinstance(v, get_origin(field.outer_type_)):
+                            value, error = field.validate(v, values, loc=loc, cls=cls)
+                            if not error:
+                                return value, None
+
+            # 1st pass by default or 3rd pass with `smart_union` enabled:
+            # check if the value can be coerced into one of the Union types
+            for field in self.sub_fields:
+                value, error = field.validate(v, values, loc=loc, cls=cls)
+                if error:
+                    errors.append(error)
+                else:
+                    return value, None
+            return v, errors
+        else:
+            return self._apply_validators(v, values, loc, cls, self.validators)
+
+    def _validate_discriminated_union(
+        self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc']
+    ) -> 'ValidateReturn':
+        assert self.discriminator_key is not None
+        assert self.discriminator_alias is not None
+
+        try:
+            try:
+                discriminator_value = v[self.discriminator_alias]
+            except KeyError:
+                if self.model_config.allow_population_by_field_name:
+                    discriminator_value = v[self.discriminator_key]
+                else:
+                    raise
+        except KeyError:
+            return v, ErrorWrapper(MissingDiscriminator(discriminator_key=self.discriminator_key), loc)
+        except TypeError:
+            try:
+                # BaseModel or dataclass
+                discriminator_value = getattr(v, self.discriminator_key)
+            except (AttributeError, TypeError):
+                return v, ErrorWrapper(MissingDiscriminator(discriminator_key=self.discriminator_key), loc)
+
+        if self.sub_fields_mapping is None:
+            assert cls is not None
+            raise ConfigError(
+                f'field "{self.name}" not yet prepared so type is still a ForwardRef, '
+                f'you might need to call {cls.__name__}.update_forward_refs().'
+            )
+
+        try:
+            sub_field = self.sub_fields_mapping[discriminator_value]
+        except (KeyError, TypeError):
+            # KeyError: `discriminator_value` is not in the dictionary.
+            # TypeError: `discriminator_value` is unhashable.
+            assert self.sub_fields_mapping is not None
+            return v, ErrorWrapper(
+                InvalidDiscriminator(
+                    discriminator_key=self.discriminator_key,
+                    discriminator_value=discriminator_value,
+                    allowed_values=list(self.sub_fields_mapping),
+                ),
+                loc,
+            )
+        else:
+            if not isinstance(loc, tuple):
+                loc = (loc,)
+            return sub_field.validate(v, values, loc=(*loc, display_as_type(sub_field.type_)), cls=cls)
+
+    def _apply_validators(
+        self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc'], validators: 'ValidatorsList'
+    ) -> 'ValidateReturn':
+        for validator in validators:
+            try:
+                v = validator(cls, v, values, self, self.model_config)
+            except (ValueError, TypeError, AssertionError) as exc:
+                return v, ErrorWrapper(exc, loc)
+        return v, None
+
+    def is_complex(self) -> bool:
+        """
+        Whether the field is "complex" eg. env variables should be parsed as JSON.
+        """
+        from .main import BaseModel
+
+        return (
+            self.shape != SHAPE_SINGLETON
+            or hasattr(self.type_, '__pydantic_model__')
+            or lenient_issubclass(self.type_, (BaseModel, list, set, frozenset, dict))
+        )
+
+    def _type_display(self) -> PyObjectStr:
+        t = display_as_type(self.type_)
+
+        if self.shape in MAPPING_LIKE_SHAPES:
+            t = f'Mapping[{display_as_type(self.key_field.type_)}, {t}]'  # type: ignore
+        elif self.shape == SHAPE_TUPLE:
+            t = 'Tuple[{}]'.format(', '.join(display_as_type(f.type_) for f in self.sub_fields))  # type: ignore
+        elif self.shape == SHAPE_GENERIC:
+            assert self.sub_fields
+            t = '{}[{}]'.format(
+                display_as_type(self.type_), ', '.join(display_as_type(f.type_) for f in self.sub_fields)
+            )
+        elif self.shape != SHAPE_SINGLETON:
+            t = SHAPE_NAME_LOOKUP[self.shape].format(t)
+
+        if self.allow_none and (self.shape != SHAPE_SINGLETON or not self.sub_fields):
+            t = f'Optional[{t}]'
+        return PyObjectStr(t)
+
+    def __repr_args__(self) -> 'ReprArgs':
+        args = [('name', self.name), ('type', self._type_display()), ('required', self.required)]
+
+        if not self.required:
+            if self.default_factory is not None:
+                args.append(('default_factory', f'<function {self.default_factory.__name__}>'))
+            else:
+                args.append(('default', self.default))
+
+        if self.alt_alias:
+            args.append(('alias', self.alias))
+        return args
+
+
+class ModelPrivateAttr(Representation):
+    __slots__ = ('default', 'default_factory')
+
+    def __init__(self, default: Any = Undefined, *, default_factory: Optional[NoArgAnyCallable] = None) -> None:
+        self.default = default
+        self.default_factory = default_factory
+
+    def get_default(self) -> Any:
+        return smart_deepcopy(self.default) if self.default_factory is None else self.default_factory()
+
+    def __eq__(self, other: Any) -> bool:
+        return isinstance(other, self.__class__) and (self.default, self.default_factory) == (
+            other.default,
+            other.default_factory,
+        )
+
+
+def PrivateAttr(
+    default: Any = Undefined,
+    *,
+    default_factory: Optional[NoArgAnyCallable] = None,
+) -> Any:
+    """
+    Indicates that attribute is only used internally and never mixed with regular fields.
+
+    Types or values of private attrs are not checked by pydantic and it's up to you to keep them relevant.
+
+    Private attrs are stored in model __slots__.
+
+    :param default: the attribute’s default value
+    :param default_factory: callable that will be called when a default value is needed for this attribute
+      If both `default` and `default_factory` are set, an error is raised.
+    """
+    if default is not Undefined and default_factory is not None:
+        raise ValueError('cannot specify both default and default_factory')
+
+    return ModelPrivateAttr(
+        default,
+        default_factory=default_factory,
+    )
+
+
+class DeferredType:
+    """
+    Used to postpone field preparation, while creating recursive generic models.
+    """
+
+
+def is_finalvar_with_default_val(type_: Type[Any], val: Any) -> bool:
+    return is_finalvar(type_) and val is not Undefined and not isinstance(val, FieldInfo)
diff --git a/lib/pydantic/v1/generics.py b/lib/pydantic/v1/generics.py
new file mode 100644
index 00000000..a75b6b98
--- /dev/null
+++ b/lib/pydantic/v1/generics.py
@@ -0,0 +1,400 @@
+import sys
+import types
+import typing
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    ClassVar,
+    Dict,
+    ForwardRef,
+    Generic,
+    Iterator,
+    List,
+    Mapping,
+    Optional,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+    cast,
+)
+from weakref import WeakKeyDictionary, WeakValueDictionary
+
+from typing_extensions import Annotated, Literal as ExtLiteral
+
+from .class_validators import gather_all_validators
+from .fields import DeferredType
+from .main import BaseModel, create_model
+from .types import JsonWrapper
+from .typing import display_as_type, get_all_type_hints, get_args, get_origin, typing_base
+from .utils import all_identical, lenient_issubclass
+
+if sys.version_info >= (3, 10):
+    from typing import _UnionGenericAlias
+if sys.version_info >= (3, 8):
+    from typing import Literal
+
+GenericModelT = TypeVar('GenericModelT', bound='GenericModel')
+TypeVarType = Any  # since mypy doesn't allow the use of TypeVar as a type
+
+CacheKey = Tuple[Type[Any], Any, Tuple[Any, ...]]
+Parametrization = Mapping[TypeVarType, Type[Any]]
+
+# weak dictionaries allow the dynamically created parametrized versions of generic models to get collected
+# once they are no longer referenced by the caller.
+if sys.version_info >= (3, 9):  # Typing for weak dictionaries available at 3.9
+    GenericTypesCache = WeakValueDictionary[CacheKey, Type[BaseModel]]
+    AssignedParameters = WeakKeyDictionary[Type[BaseModel], Parametrization]
+else:
+    GenericTypesCache = WeakValueDictionary
+    AssignedParameters = WeakKeyDictionary
+
+# _generic_types_cache is a Mapping from __class_getitem__ arguments to the parametrized version of generic models.
+# This ensures multiple calls of e.g. A[B] return always the same class.
+_generic_types_cache = GenericTypesCache()
+
+# _assigned_parameters is a Mapping from parametrized version of generic models to assigned types of parametrizations
+# as captured during construction of the class (not instances).
+# E.g., for generic model `Model[A, B]`, when parametrized model `Model[int, str]` is created,
+# `Model[int, str]`: {A: int, B: str}` will be stored in `_assigned_parameters`.
+# (This information is only otherwise available after creation from the class name string).
+_assigned_parameters = AssignedParameters()
+
+
+class GenericModel(BaseModel):
+    __slots__ = ()
+    __concrete__: ClassVar[bool] = False
+
+    if TYPE_CHECKING:
+        # Putting this in a TYPE_CHECKING block allows us to replace `if Generic not in cls.__bases__` with
+        # `not hasattr(cls, "__parameters__")`. This means we don't need to force non-concrete subclasses of
+        # `GenericModel` to also inherit from `Generic`, which would require changes to the use of `create_model` below.
+        __parameters__: ClassVar[Tuple[TypeVarType, ...]]
+
+    # Setting the return type as Type[Any] instead of Type[BaseModel] prevents PyCharm warnings
+    def __class_getitem__(cls: Type[GenericModelT], params: Union[Type[Any], Tuple[Type[Any], ...]]) -> Type[Any]:
+        """Instantiates a new class from a generic class `cls` and type variables `params`.
+
+        :param params: Tuple of types the class . Given a generic class
+            `Model` with 2 type variables and a concrete model `Model[str, int]`,
+            the value `(str, int)` would be passed to `params`.
+        :return: New model class inheriting from `cls` with instantiated
+            types described by `params`. If no parameters are given, `cls` is
+            returned as is.
+
+        """
+
+        def _cache_key(_params: Any) -> CacheKey:
+            args = get_args(_params)
+            # python returns a list for Callables, which is not hashable
+            if len(args) == 2 and isinstance(args[0], list):
+                args = (tuple(args[0]), args[1])
+            return cls, _params, args
+
+        cached = _generic_types_cache.get(_cache_key(params))
+        if cached is not None:
+            return cached
+        if cls.__concrete__ and Generic not in cls.__bases__:
+            raise TypeError('Cannot parameterize a concrete instantiation of a generic model')
+        if not isinstance(params, tuple):
+            params = (params,)
+        if cls is GenericModel and any(isinstance(param, TypeVar) for param in params):
+            raise TypeError('Type parameters should be placed on typing.Generic, not GenericModel')
+        if not hasattr(cls, '__parameters__'):
+            raise TypeError(f'Type {cls.__name__} must inherit from typing.Generic before being parameterized')
+
+        check_parameters_count(cls, params)
+        # Build map from generic typevars to passed params
+        typevars_map: Dict[TypeVarType, Type[Any]] = dict(zip(cls.__parameters__, params))
+        if all_identical(typevars_map.keys(), typevars_map.values()) and typevars_map:
+            return cls  # if arguments are equal to parameters it's the same object
+
+        # Create new model with original model as parent inserting fields with DeferredType.
+        model_name = cls.__concrete_name__(params)
+        validators = gather_all_validators(cls)
+
+        type_hints = get_all_type_hints(cls).items()
+        instance_type_hints = {k: v for k, v in type_hints if get_origin(v) is not ClassVar}
+
+        fields = {k: (DeferredType(), cls.__fields__[k].field_info) for k in instance_type_hints if k in cls.__fields__}
+
+        model_module, called_globally = get_caller_frame_info()
+        created_model = cast(
+            Type[GenericModel],  # casting ensures mypy is aware of the __concrete__ and __parameters__ attributes
+            create_model(
+                model_name,
+                __module__=model_module or cls.__module__,
+                __base__=(cls,) + tuple(cls.__parameterized_bases__(typevars_map)),
+                __config__=None,
+                __validators__=validators,
+                __cls_kwargs__=None,
+                **fields,
+            ),
+        )
+
+        _assigned_parameters[created_model] = typevars_map
+
+        if called_globally:  # create global reference and therefore allow pickling
+            object_by_reference = None
+            reference_name = model_name
+            reference_module_globals = sys.modules[created_model.__module__].__dict__
+            while object_by_reference is not created_model:
+                object_by_reference = reference_module_globals.setdefault(reference_name, created_model)
+                reference_name += '_'
+
+        created_model.Config = cls.Config
+
+        # Find any typevars that are still present in the model.
+        # If none are left, the model is fully "concrete", otherwise the new
+        # class is a generic class as well taking the found typevars as
+        # parameters.
+        new_params = tuple(
+            {param: None for param in iter_contained_typevars(typevars_map.values())}
+        )  # use dict as ordered set
+        created_model.__concrete__ = not new_params
+        if new_params:
+            created_model.__parameters__ = new_params
+
+        # Save created model in cache so we don't end up creating duplicate
+        # models that should be identical.
+        _generic_types_cache[_cache_key(params)] = created_model
+        if len(params) == 1:
+            _generic_types_cache[_cache_key(params[0])] = created_model
+
+        # Recursively walk class type hints and replace generic typevars
+        # with concrete types that were passed.
+        _prepare_model_fields(created_model, fields, instance_type_hints, typevars_map)
+
+        return created_model
+
+    @classmethod
+    def __concrete_name__(cls: Type[Any], params: Tuple[Type[Any], ...]) -> str:
+        """Compute class name for child classes.
+
+        :param params: Tuple of types the class . Given a generic class
+            `Model` with 2 type variables and a concrete model `Model[str, int]`,
+            the value `(str, int)` would be passed to `params`.
+        :return: String representing a the new class where `params` are
+            passed to `cls` as type variables.
+
+        This method can be overridden to achieve a custom naming scheme for GenericModels.
+        """
+        param_names = [display_as_type(param) for param in params]
+        params_component = ', '.join(param_names)
+        return f'{cls.__name__}[{params_component}]'
+
+    @classmethod
+    def __parameterized_bases__(cls, typevars_map: Parametrization) -> Iterator[Type[Any]]:
+        """
+        Returns unbound bases of cls parameterised to given type variables
+
+        :param typevars_map: Dictionary of type applications for binding subclasses.
+            Given a generic class `Model` with 2 type variables [S, T]
+            and a concrete model `Model[str, int]`,
+            the value `{S: str, T: int}` would be passed to `typevars_map`.
+        :return: an iterator of generic sub classes, parameterised by `typevars_map`
+            and other assigned parameters of `cls`
+
+        e.g.:
+        ```
+        class A(GenericModel, Generic[T]):
+            ...
+
+        class B(A[V], Generic[V]):
+            ...
+
+        assert A[int] in B.__parameterized_bases__({V: int})
+        ```
+        """
+
+        def build_base_model(
+            base_model: Type[GenericModel], mapped_types: Parametrization
+        ) -> Iterator[Type[GenericModel]]:
+            base_parameters = tuple(mapped_types[param] for param in base_model.__parameters__)
+            parameterized_base = base_model.__class_getitem__(base_parameters)
+            if parameterized_base is base_model or parameterized_base is cls:
+                # Avoid duplication in MRO
+                return
+            yield parameterized_base
+
+        for base_model in cls.__bases__:
+            if not issubclass(base_model, GenericModel):
+                # not a class that can be meaningfully parameterized
+                continue
+            elif not getattr(base_model, '__parameters__', None):
+                # base_model is "GenericModel"  (and has no __parameters__)
+                # or
+                # base_model is already concrete, and will be included transitively via cls.
+                continue
+            elif cls in _assigned_parameters:
+                if base_model in _assigned_parameters:
+                    # cls is partially parameterised but not from base_model
+                    # e.g. cls = B[S], base_model = A[S]
+                    # B[S][int] should subclass A[int],  (and will be transitively via B[int])
+                    # but it's not viable to consistently subclass types with arbitrary construction
+                    # So don't attempt to include A[S][int]
+                    continue
+                else:  # base_model not in _assigned_parameters:
+                    # cls is partially parameterized, base_model is original generic
+                    # e.g.  cls = B[str, T], base_model = B[S, T]
+                    # Need to determine the mapping for the base_model parameters
+                    mapped_types: Parametrization = {
+                        key: typevars_map.get(value, value) for key, value in _assigned_parameters[cls].items()
+                    }
+                    yield from build_base_model(base_model, mapped_types)
+            else:
+                # cls is base generic, so base_class has a distinct base
+                # can construct the Parameterised base model using typevars_map directly
+                yield from build_base_model(base_model, typevars_map)
+
+
+def replace_types(type_: Any, type_map: Mapping[Any, Any]) -> Any:
+    """Return type with all occurrences of `type_map` keys recursively replaced with their values.
+
+    :param type_: Any type, class or generic alias
+    :param type_map: Mapping from `TypeVar` instance to concrete types.
+    :return: New type representing the basic structure of `type_` with all
+        `typevar_map` keys recursively replaced.
+
+    >>> replace_types(Tuple[str, Union[List[str], float]], {str: int})
+    Tuple[int, Union[List[int], float]]
+
+    """
+    if not type_map:
+        return type_
+
+    type_args = get_args(type_)
+    origin_type = get_origin(type_)
+
+    if origin_type is Annotated:
+        annotated_type, *annotations = type_args
+        return Annotated[replace_types(annotated_type, type_map), tuple(annotations)]
+
+    if (origin_type is ExtLiteral) or (sys.version_info >= (3, 8) and origin_type is Literal):
+        return type_map.get(type_, type_)
+    # Having type args is a good indicator that this is a typing module
+    # class instantiation or a generic alias of some sort.
+    if type_args:
+        resolved_type_args = tuple(replace_types(arg, type_map) for arg in type_args)
+        if all_identical(type_args, resolved_type_args):
+            # If all arguments are the same, there is no need to modify the
+            # type or create a new object at all
+            return type_
+        if (
+            origin_type is not None
+            and isinstance(type_, typing_base)
+            and not isinstance(origin_type, typing_base)
+            and getattr(type_, '_name', None) is not None
+        ):
+            # In python < 3.9 generic aliases don't exist so any of these like `list`,
+            # `type` or `collections.abc.Callable` need to be translated.
+            # See: https://www.python.org/dev/peps/pep-0585
+            origin_type = getattr(typing, type_._name)
+        assert origin_type is not None
+        # PEP-604 syntax (Ex.: list | str) is represented with a types.UnionType object that does not have __getitem__.
+        # We also cannot use isinstance() since we have to compare types.
+        if sys.version_info >= (3, 10) and origin_type is types.UnionType:  # noqa: E721
+            return _UnionGenericAlias(origin_type, resolved_type_args)
+        return origin_type[resolved_type_args]
+
+    # We handle pydantic generic models separately as they don't have the same
+    # semantics as "typing" classes or generic aliases
+    if not origin_type and lenient_issubclass(type_, GenericModel) and not type_.__concrete__:
+        type_args = type_.__parameters__
+        resolved_type_args = tuple(replace_types(t, type_map) for t in type_args)
+        if all_identical(type_args, resolved_type_args):
+            return type_
+        return type_[resolved_type_args]
+
+    # Handle special case for typehints that can have lists as arguments.
+    # `typing.Callable[[int, str], int]` is an example for this.
+    if isinstance(type_, (List, list)):
+        resolved_list = list(replace_types(element, type_map) for element in type_)
+        if all_identical(type_, resolved_list):
+            return type_
+        return resolved_list
+
+    # For JsonWrapperValue, need to handle its inner type to allow correct parsing
+    # of generic Json arguments like Json[T]
+    if not origin_type and lenient_issubclass(type_, JsonWrapper):
+        type_.inner_type = replace_types(type_.inner_type, type_map)
+        return type_
+
+    # If all else fails, we try to resolve the type directly and otherwise just
+    # return the input with no modifications.
+    new_type = type_map.get(type_, type_)
+    # Convert string to ForwardRef
+    if isinstance(new_type, str):
+        return ForwardRef(new_type)
+    else:
+        return new_type
+
+
+def check_parameters_count(cls: Type[GenericModel], parameters: Tuple[Any, ...]) -> None:
+    actual = len(parameters)
+    expected = len(cls.__parameters__)
+    if actual != expected:
+        description = 'many' if actual > expected else 'few'
+        raise TypeError(f'Too {description} parameters for {cls.__name__}; actual {actual}, expected {expected}')
+
+
+DictValues: Type[Any] = {}.values().__class__
+
+
+def iter_contained_typevars(v: Any) -> Iterator[TypeVarType]:
+    """Recursively iterate through all subtypes and type args of `v` and yield any typevars that are found."""
+    if isinstance(v, TypeVar):
+        yield v
+    elif hasattr(v, '__parameters__') and not get_origin(v) and lenient_issubclass(v, GenericModel):
+        yield from v.__parameters__
+    elif isinstance(v, (DictValues, list)):
+        for var in v:
+            yield from iter_contained_typevars(var)
+    else:
+        args = get_args(v)
+        for arg in args:
+            yield from iter_contained_typevars(arg)
+
+
+def get_caller_frame_info() -> Tuple[Optional[str], bool]:
+    """
+    Used inside a function to check whether it was called globally
+
+    Will only work against non-compiled code, therefore used only in pydantic.generics
+
+    :returns Tuple[module_name, called_globally]
+    """
+    try:
+        previous_caller_frame = sys._getframe(2)
+    except ValueError as e:
+        raise RuntimeError('This function must be used inside another function') from e
+    except AttributeError:  # sys module does not have _getframe function, so there's nothing we can do about it
+        return None, False
+    frame_globals = previous_caller_frame.f_globals
+    return frame_globals.get('__name__'), previous_caller_frame.f_locals is frame_globals
+
+
+def _prepare_model_fields(
+    created_model: Type[GenericModel],
+    fields: Mapping[str, Any],
+    instance_type_hints: Mapping[str, type],
+    typevars_map: Mapping[Any, type],
+) -> None:
+    """
+    Replace DeferredType fields with concrete type hints and prepare them.
+    """
+
+    for key, field in created_model.__fields__.items():
+        if key not in fields:
+            assert field.type_.__class__ is not DeferredType
+            # https://github.com/nedbat/coveragepy/issues/198
+            continue  # pragma: no cover
+
+        assert field.type_.__class__ is DeferredType, field.type_.__class__
+
+        field_type_hint = instance_type_hints[key]
+        concrete_type = replace_types(field_type_hint, typevars_map)
+        field.type_ = concrete_type
+        field.outer_type_ = concrete_type
+        field.prepare()
+        created_model.__annotations__[key] = concrete_type
diff --git a/lib/pydantic/v1/json.py b/lib/pydantic/v1/json.py
new file mode 100644
index 00000000..b358b850
--- /dev/null
+++ b/lib/pydantic/v1/json.py
@@ -0,0 +1,112 @@
+import datetime
+from collections import deque
+from decimal import Decimal
+from enum import Enum
+from ipaddress import IPv4Address, IPv4Interface, IPv4Network, IPv6Address, IPv6Interface, IPv6Network
+from pathlib import Path
+from re import Pattern
+from types import GeneratorType
+from typing import Any, Callable, Dict, Type, Union
+from uuid import UUID
+
+from .color import Color
+from .networks import NameEmail
+from .types import SecretBytes, SecretStr
+
+__all__ = 'pydantic_encoder', 'custom_pydantic_encoder', 'timedelta_isoformat'
+
+
+def isoformat(o: Union[datetime.date, datetime.time]) -> str:
+    return o.isoformat()
+
+
+def decimal_encoder(dec_value: Decimal) -> Union[int, float]:
+    """
+    Encodes a Decimal as int of there's no exponent, otherwise float
+
+    This is useful when we use ConstrainedDecimal to represent Numeric(x,0)
+    where a integer (but not int typed) is used. Encoding this as a float
+    results in failed round-tripping between encode and parse.
+    Our Id type is a prime example of this.
+
+    >>> decimal_encoder(Decimal("1.0"))
+    1.0
+
+    >>> decimal_encoder(Decimal("1"))
+    1
+    """
+    if dec_value.as_tuple().exponent >= 0:
+        return int(dec_value)
+    else:
+        return float(dec_value)
+
+
+ENCODERS_BY_TYPE: Dict[Type[Any], Callable[[Any], Any]] = {
+    bytes: lambda o: o.decode(),
+    Color: str,
+    datetime.date: isoformat,
+    datetime.datetime: isoformat,
+    datetime.time: isoformat,
+    datetime.timedelta: lambda td: td.total_seconds(),
+    Decimal: decimal_encoder,
+    Enum: lambda o: o.value,
+    frozenset: list,
+    deque: list,
+    GeneratorType: list,
+    IPv4Address: str,
+    IPv4Interface: str,
+    IPv4Network: str,
+    IPv6Address: str,
+    IPv6Interface: str,
+    IPv6Network: str,
+    NameEmail: str,
+    Path: str,
+    Pattern: lambda o: o.pattern,
+    SecretBytes: str,
+    SecretStr: str,
+    set: list,
+    UUID: str,
+}
+
+
+def pydantic_encoder(obj: Any) -> Any:
+    from dataclasses import asdict, is_dataclass
+
+    from .main import BaseModel
+
+    if isinstance(obj, BaseModel):
+        return obj.dict()
+    elif is_dataclass(obj):
+        return asdict(obj)
+
+    # Check the class type and its superclasses for a matching encoder
+    for base in obj.__class__.__mro__[:-1]:
+        try:
+            encoder = ENCODERS_BY_TYPE[base]
+        except KeyError:
+            continue
+        return encoder(obj)
+    else:  # We have exited the for loop without finding a suitable encoder
+        raise TypeError(f"Object of type '{obj.__class__.__name__}' is not JSON serializable")
+
+
+def custom_pydantic_encoder(type_encoders: Dict[Any, Callable[[Type[Any]], Any]], obj: Any) -> Any:
+    # Check the class type and its superclasses for a matching encoder
+    for base in obj.__class__.__mro__[:-1]:
+        try:
+            encoder = type_encoders[base]
+        except KeyError:
+            continue
+
+        return encoder(obj)
+    else:  # We have exited the for loop without finding a suitable encoder
+        return pydantic_encoder(obj)
+
+
+def timedelta_isoformat(td: datetime.timedelta) -> str:
+    """
+    ISO 8601 encoding for Python timedelta object.
+    """
+    minutes, seconds = divmod(td.seconds, 60)
+    hours, minutes = divmod(minutes, 60)
+    return f'{"-" if td.days < 0 else ""}P{abs(td.days)}DT{hours:d}H{minutes:d}M{seconds:d}.{td.microseconds:06d}S'
diff --git a/lib/pydantic/v1/main.py b/lib/pydantic/v1/main.py
new file mode 100644
index 00000000..08b8af55
--- /dev/null
+++ b/lib/pydantic/v1/main.py
@@ -0,0 +1,1107 @@
+import warnings
+from abc import ABCMeta
+from copy import deepcopy
+from enum import Enum
+from functools import partial
+from pathlib import Path
+from types import FunctionType, prepare_class, resolve_bases
+from typing import (
+    TYPE_CHECKING,
+    AbstractSet,
+    Any,
+    Callable,
+    ClassVar,
+    Dict,
+    List,
+    Mapping,
+    Optional,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+    cast,
+    no_type_check,
+    overload,
+)
+
+from typing_extensions import dataclass_transform
+
+from .class_validators import ValidatorGroup, extract_root_validators, extract_validators, inherit_validators
+from .config import BaseConfig, Extra, inherit_config, prepare_config
+from .error_wrappers import ErrorWrapper, ValidationError
+from .errors import ConfigError, DictError, ExtraError, MissingError
+from .fields import (
+    MAPPING_LIKE_SHAPES,
+    Field,
+    ModelField,
+    ModelPrivateAttr,
+    PrivateAttr,
+    Undefined,
+    is_finalvar_with_default_val,
+)
+from .json import custom_pydantic_encoder, pydantic_encoder
+from .parse import Protocol, load_file, load_str_bytes
+from .schema import default_ref_template, model_schema
+from .types import PyObject, StrBytes
+from .typing import (
+    AnyCallable,
+    get_args,
+    get_origin,
+    is_classvar,
+    is_namedtuple,
+    is_union,
+    resolve_annotations,
+    update_model_forward_refs,
+)
+from .utils import (
+    DUNDER_ATTRIBUTES,
+    ROOT_KEY,
+    ClassAttribute,
+    GetterDict,
+    Representation,
+    ValueItems,
+    generate_model_signature,
+    is_valid_field,
+    is_valid_private_name,
+    lenient_issubclass,
+    sequence_like,
+    smart_deepcopy,
+    unique_list,
+    validate_field_name,
+)
+
+if TYPE_CHECKING:
+    from inspect import Signature
+
+    from .class_validators import ValidatorListDict
+    from .types import ModelOrDc
+    from .typing import (
+        AbstractSetIntStr,
+        AnyClassMethod,
+        CallableGenerator,
+        DictAny,
+        DictStrAny,
+        MappingIntStrAny,
+        ReprArgs,
+        SetStr,
+        TupleGenerator,
+    )
+
+    Model = TypeVar('Model', bound='BaseModel')
+
+__all__ = 'BaseModel', 'create_model', 'validate_model'
+
+_T = TypeVar('_T')
+
+
+def validate_custom_root_type(fields: Dict[str, ModelField]) -> None:
+    if len(fields) > 1:
+        raise ValueError(f'{ROOT_KEY} cannot be mixed with other fields')
+
+
+def generate_hash_function(frozen: bool) -> Optional[Callable[[Any], int]]:
+    def hash_function(self_: Any) -> int:
+        return hash(self_.__class__) + hash(tuple(self_.__dict__.values()))
+
+    return hash_function if frozen else None
+
+
+# If a field is of type `Callable`, its default value should be a function and cannot to ignored.
+ANNOTATED_FIELD_UNTOUCHED_TYPES: Tuple[Any, ...] = (property, type, classmethod, staticmethod)
+# When creating a `BaseModel` instance, we bypass all the methods, properties... added to the model
+UNTOUCHED_TYPES: Tuple[Any, ...] = (FunctionType,) + ANNOTATED_FIELD_UNTOUCHED_TYPES
+# Note `ModelMetaclass` refers to `BaseModel`, but is also used to *create* `BaseModel`, so we need to add this extra
+# (somewhat hacky) boolean to keep track of whether we've created the `BaseModel` class yet, and therefore whether it's
+# safe to refer to it. If it *hasn't* been created, we assume that the `__new__` call we're in the middle of is for
+# the `BaseModel` class, since that's defined immediately after the metaclass.
+_is_base_model_class_defined = False
+
+
+@dataclass_transform(kw_only_default=True, field_specifiers=(Field,))
+class ModelMetaclass(ABCMeta):
+    @no_type_check  # noqa C901
+    def __new__(mcs, name, bases, namespace, **kwargs):  # noqa C901
+        fields: Dict[str, ModelField] = {}
+        config = BaseConfig
+        validators: 'ValidatorListDict' = {}
+
+        pre_root_validators, post_root_validators = [], []
+        private_attributes: Dict[str, ModelPrivateAttr] = {}
+        base_private_attributes: Dict[str, ModelPrivateAttr] = {}
+        slots: SetStr = namespace.get('__slots__', ())
+        slots = {slots} if isinstance(slots, str) else set(slots)
+        class_vars: SetStr = set()
+        hash_func: Optional[Callable[[Any], int]] = None
+
+        for base in reversed(bases):
+            if _is_base_model_class_defined and issubclass(base, BaseModel) and base != BaseModel:
+                fields.update(smart_deepcopy(base.__fields__))
+                config = inherit_config(base.__config__, config)
+                validators = inherit_validators(base.__validators__, validators)
+                pre_root_validators += base.__pre_root_validators__
+                post_root_validators += base.__post_root_validators__
+                base_private_attributes.update(base.__private_attributes__)
+                class_vars.update(base.__class_vars__)
+                hash_func = base.__hash__
+
+        resolve_forward_refs = kwargs.pop('__resolve_forward_refs__', True)
+        allowed_config_kwargs: SetStr = {
+            key
+            for key in dir(config)
+            if not (key.startswith('__') and key.endswith('__'))  # skip dunder methods and attributes
+        }
+        config_kwargs = {key: kwargs.pop(key) for key in kwargs.keys() & allowed_config_kwargs}
+        config_from_namespace = namespace.get('Config')
+        if config_kwargs and config_from_namespace:
+            raise TypeError('Specifying config in two places is ambiguous, use either Config attribute or class kwargs')
+        config = inherit_config(config_from_namespace, config, **config_kwargs)
+
+        validators = inherit_validators(extract_validators(namespace), validators)
+        vg = ValidatorGroup(validators)
+
+        for f in fields.values():
+            f.set_config(config)
+            extra_validators = vg.get_validators(f.name)
+            if extra_validators:
+                f.class_validators.update(extra_validators)
+                # re-run prepare to add extra validators
+                f.populate_validators()
+
+        prepare_config(config, name)
+
+        untouched_types = ANNOTATED_FIELD_UNTOUCHED_TYPES
+
+        def is_untouched(v: Any) -> bool:
+            return isinstance(v, untouched_types) or v.__class__.__name__ == 'cython_function_or_method'
+
+        if (namespace.get('__module__'), namespace.get('__qualname__')) != ('pydantic.main', 'BaseModel'):
+            annotations = resolve_annotations(namespace.get('__annotations__', {}), namespace.get('__module__', None))
+            # annotation only fields need to come first in fields
+            for ann_name, ann_type in annotations.items():
+                if is_classvar(ann_type):
+                    class_vars.add(ann_name)
+                elif is_finalvar_with_default_val(ann_type, namespace.get(ann_name, Undefined)):
+                    class_vars.add(ann_name)
+                elif is_valid_field(ann_name):
+                    validate_field_name(bases, ann_name)
+                    value = namespace.get(ann_name, Undefined)
+                    allowed_types = get_args(ann_type) if is_union(get_origin(ann_type)) else (ann_type,)
+                    if (
+                        is_untouched(value)
+                        and ann_type != PyObject
+                        and not any(
+                            lenient_issubclass(get_origin(allowed_type), Type) for allowed_type in allowed_types
+                        )
+                    ):
+                        continue
+                    fields[ann_name] = ModelField.infer(
+                        name=ann_name,
+                        value=value,
+                        annotation=ann_type,
+                        class_validators=vg.get_validators(ann_name),
+                        config=config,
+                    )
+                elif ann_name not in namespace and config.underscore_attrs_are_private:
+                    private_attributes[ann_name] = PrivateAttr()
+
+            untouched_types = UNTOUCHED_TYPES + config.keep_untouched
+            for var_name, value in namespace.items():
+                can_be_changed = var_name not in class_vars and not is_untouched(value)
+                if isinstance(value, ModelPrivateAttr):
+                    if not is_valid_private_name(var_name):
+                        raise NameError(
+                            f'Private attributes "{var_name}" must not be a valid field name; '
+                            f'Use sunder or dunder names, e. g. "_{var_name}" or "__{var_name}__"'
+                        )
+                    private_attributes[var_name] = value
+                elif config.underscore_attrs_are_private and is_valid_private_name(var_name) and can_be_changed:
+                    private_attributes[var_name] = PrivateAttr(default=value)
+                elif is_valid_field(var_name) and var_name not in annotations and can_be_changed:
+                    validate_field_name(bases, var_name)
+                    inferred = ModelField.infer(
+                        name=var_name,
+                        value=value,
+                        annotation=annotations.get(var_name, Undefined),
+                        class_validators=vg.get_validators(var_name),
+                        config=config,
+                    )
+                    if var_name in fields:
+                        if lenient_issubclass(inferred.type_, fields[var_name].type_):
+                            inferred.type_ = fields[var_name].type_
+                        else:
+                            raise TypeError(
+                                f'The type of {name}.{var_name} differs from the new default value; '
+                                f'if you wish to change the type of this field, please use a type annotation'
+                            )
+                    fields[var_name] = inferred
+
+        _custom_root_type = ROOT_KEY in fields
+        if _custom_root_type:
+            validate_custom_root_type(fields)
+        vg.check_for_unused()
+        if config.json_encoders:
+            json_encoder = partial(custom_pydantic_encoder, config.json_encoders)
+        else:
+            json_encoder = pydantic_encoder
+        pre_rv_new, post_rv_new = extract_root_validators(namespace)
+
+        if hash_func is None:
+            hash_func = generate_hash_function(config.frozen)
+
+        exclude_from_namespace = fields | private_attributes.keys() | {'__slots__'}
+        new_namespace = {
+            '__config__': config,
+            '__fields__': fields,
+            '__exclude_fields__': {
+                name: field.field_info.exclude for name, field in fields.items() if field.field_info.exclude is not None
+            }
+            or None,
+            '__include_fields__': {
+                name: field.field_info.include for name, field in fields.items() if field.field_info.include is not None
+            }
+            or None,
+            '__validators__': vg.validators,
+            '__pre_root_validators__': unique_list(
+                pre_root_validators + pre_rv_new,
+                name_factory=lambda v: v.__name__,
+            ),
+            '__post_root_validators__': unique_list(
+                post_root_validators + post_rv_new,
+                name_factory=lambda skip_on_failure_and_v: skip_on_failure_and_v[1].__name__,
+            ),
+            '__schema_cache__': {},
+            '__json_encoder__': staticmethod(json_encoder),
+            '__custom_root_type__': _custom_root_type,
+            '__private_attributes__': {**base_private_attributes, **private_attributes},
+            '__slots__': slots | private_attributes.keys(),
+            '__hash__': hash_func,
+            '__class_vars__': class_vars,
+            **{n: v for n, v in namespace.items() if n not in exclude_from_namespace},
+        }
+
+        cls = super().__new__(mcs, name, bases, new_namespace, **kwargs)
+        # set __signature__ attr only for model class, but not for its instances
+        cls.__signature__ = ClassAttribute('__signature__', generate_model_signature(cls.__init__, fields, config))
+        if resolve_forward_refs:
+            cls.__try_update_forward_refs__()
+
+        # preserve `__set_name__` protocol defined in https://peps.python.org/pep-0487
+        # for attributes not in `new_namespace` (e.g. private attributes)
+        for name, obj in namespace.items():
+            if name not in new_namespace:
+                set_name = getattr(obj, '__set_name__', None)
+                if callable(set_name):
+                    set_name(cls, name)
+
+        return cls
+
+    def __instancecheck__(self, instance: Any) -> bool:
+        """
+        Avoid calling ABC _abc_subclasscheck unless we're pretty sure.
+
+        See #3829 and python/cpython#92810
+        """
+        return hasattr(instance, '__fields__') and super().__instancecheck__(instance)
+
+
+object_setattr = object.__setattr__
+
+
+class BaseModel(Representation, metaclass=ModelMetaclass):
+    if TYPE_CHECKING:
+        # populated by the metaclass, defined here to help IDEs only
+        __fields__: ClassVar[Dict[str, ModelField]] = {}
+        __include_fields__: ClassVar[Optional[Mapping[str, Any]]] = None
+        __exclude_fields__: ClassVar[Optional[Mapping[str, Any]]] = None
+        __validators__: ClassVar[Dict[str, AnyCallable]] = {}
+        __pre_root_validators__: ClassVar[List[AnyCallable]]
+        __post_root_validators__: ClassVar[List[Tuple[bool, AnyCallable]]]
+        __config__: ClassVar[Type[BaseConfig]] = BaseConfig
+        __json_encoder__: ClassVar[Callable[[Any], Any]] = lambda x: x
+        __schema_cache__: ClassVar['DictAny'] = {}
+        __custom_root_type__: ClassVar[bool] = False
+        __signature__: ClassVar['Signature']
+        __private_attributes__: ClassVar[Dict[str, ModelPrivateAttr]]
+        __class_vars__: ClassVar[SetStr]
+        __fields_set__: ClassVar[SetStr] = set()
+
+    Config = BaseConfig
+    __slots__ = ('__dict__', '__fields_set__')
+    __doc__ = ''  # Null out the Representation docstring
+
+    def __init__(__pydantic_self__, **data: Any) -> None:
+        """
+        Create a new model by parsing and validating input data from keyword arguments.
+
+        Raises ValidationError if the input data cannot be parsed to form a valid model.
+        """
+        # Uses something other than `self` the first arg to allow "self" as a settable attribute
+        values, fields_set, validation_error = validate_model(__pydantic_self__.__class__, data)
+        if validation_error:
+            raise validation_error
+        try:
+            object_setattr(__pydantic_self__, '__dict__', values)
+        except TypeError as e:
+            raise TypeError(
+                'Model values must be a dict; you may not have returned a dictionary from a root validator'
+            ) from e
+        object_setattr(__pydantic_self__, '__fields_set__', fields_set)
+        __pydantic_self__._init_private_attributes()
+
+    @no_type_check
+    def __setattr__(self, name, value):  # noqa: C901 (ignore complexity)
+        if name in self.__private_attributes__ or name in DUNDER_ATTRIBUTES:
+            return object_setattr(self, name, value)
+
+        if self.__config__.extra is not Extra.allow and name not in self.__fields__:
+            raise ValueError(f'"{self.__class__.__name__}" object has no field "{name}"')
+        elif not self.__config__.allow_mutation or self.__config__.frozen:
+            raise TypeError(f'"{self.__class__.__name__}" is immutable and does not support item assignment')
+        elif name in self.__fields__ and self.__fields__[name].final:
+            raise TypeError(
+                f'"{self.__class__.__name__}" object "{name}" field is final and does not support reassignment'
+            )
+        elif self.__config__.validate_assignment:
+            new_values = {**self.__dict__, name: value}
+
+            for validator in self.__pre_root_validators__:
+                try:
+                    new_values = validator(self.__class__, new_values)
+                except (ValueError, TypeError, AssertionError) as exc:
+                    raise ValidationError([ErrorWrapper(exc, loc=ROOT_KEY)], self.__class__)
+
+            known_field = self.__fields__.get(name, None)
+            if known_field:
+                # We want to
+                # - make sure validators are called without the current value for this field inside `values`
+                # - keep other values (e.g. submodels) untouched (using `BaseModel.dict()` will change them into dicts)
+                # - keep the order of the fields
+                if not known_field.field_info.allow_mutation:
+                    raise TypeError(f'"{known_field.name}" has allow_mutation set to False and cannot be assigned')
+                dict_without_original_value = {k: v for k, v in self.__dict__.items() if k != name}
+                value, error_ = known_field.validate(value, dict_without_original_value, loc=name, cls=self.__class__)
+                if error_:
+                    raise ValidationError([error_], self.__class__)
+                else:
+                    new_values[name] = value
+
+            errors = []
+            for skip_on_failure, validator in self.__post_root_validators__:
+                if skip_on_failure and errors:
+                    continue
+                try:
+                    new_values = validator(self.__class__, new_values)
+                except (ValueError, TypeError, AssertionError) as exc:
+                    errors.append(ErrorWrapper(exc, loc=ROOT_KEY))
+            if errors:
+                raise ValidationError(errors, self.__class__)
+
+            # update the whole __dict__ as other values than just `value`
+            # may be changed (e.g. with `root_validator`)
+            object_setattr(self, '__dict__', new_values)
+        else:
+            self.__dict__[name] = value
+
+        self.__fields_set__.add(name)
+
+    def __getstate__(self) -> 'DictAny':
+        private_attrs = ((k, getattr(self, k, Undefined)) for k in self.__private_attributes__)
+        return {
+            '__dict__': self.__dict__,
+            '__fields_set__': self.__fields_set__,
+            '__private_attribute_values__': {k: v for k, v in private_attrs if v is not Undefined},
+        }
+
+    def __setstate__(self, state: 'DictAny') -> None:
+        object_setattr(self, '__dict__', state['__dict__'])
+        object_setattr(self, '__fields_set__', state['__fields_set__'])
+        for name, value in state.get('__private_attribute_values__', {}).items():
+            object_setattr(self, name, value)
+
+    def _init_private_attributes(self) -> None:
+        for name, private_attr in self.__private_attributes__.items():
+            default = private_attr.get_default()
+            if default is not Undefined:
+                object_setattr(self, name, default)
+
+    def dict(
+        self,
+        *,
+        include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
+        exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
+        by_alias: bool = False,
+        skip_defaults: Optional[bool] = None,
+        exclude_unset: bool = False,
+        exclude_defaults: bool = False,
+        exclude_none: bool = False,
+    ) -> 'DictStrAny':
+        """
+        Generate a dictionary representation of the model, optionally specifying which fields to include or exclude.
+
+        """
+        if skip_defaults is not None:
+            warnings.warn(
+                f'{self.__class__.__name__}.dict(): "skip_defaults" is deprecated and replaced by "exclude_unset"',
+                DeprecationWarning,
+            )
+            exclude_unset = skip_defaults
+
+        return dict(
+            self._iter(
+                to_dict=True,
+                by_alias=by_alias,
+                include=include,
+                exclude=exclude,
+                exclude_unset=exclude_unset,
+                exclude_defaults=exclude_defaults,
+                exclude_none=exclude_none,
+            )
+        )
+
+    def json(
+        self,
+        *,
+        include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
+        exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
+        by_alias: bool = False,
+        skip_defaults: Optional[bool] = None,
+        exclude_unset: bool = False,
+        exclude_defaults: bool = False,
+        exclude_none: bool = False,
+        encoder: Optional[Callable[[Any], Any]] = None,
+        models_as_dict: bool = True,
+        **dumps_kwargs: Any,
+    ) -> str:
+        """
+        Generate a JSON representation of the model, `include` and `exclude` arguments as per `dict()`.
+
+        `encoder` is an optional function to supply as `default` to json.dumps(), other arguments as per `json.dumps()`.
+        """
+        if skip_defaults is not None:
+            warnings.warn(
+                f'{self.__class__.__name__}.json(): "skip_defaults" is deprecated and replaced by "exclude_unset"',
+                DeprecationWarning,
+            )
+            exclude_unset = skip_defaults
+        encoder = cast(Callable[[Any], Any], encoder or self.__json_encoder__)
+
+        # We don't directly call `self.dict()`, which does exactly this with `to_dict=True`
+        # because we want to be able to keep raw `BaseModel` instances and not as `dict`.
+        # This allows users to write custom JSON encoders for given `BaseModel` classes.
+        data = dict(
+            self._iter(
+                to_dict=models_as_dict,
+                by_alias=by_alias,
+                include=include,
+                exclude=exclude,
+                exclude_unset=exclude_unset,
+                exclude_defaults=exclude_defaults,
+                exclude_none=exclude_none,
+            )
+        )
+        if self.__custom_root_type__:
+            data = data[ROOT_KEY]
+        return self.__config__.json_dumps(data, default=encoder, **dumps_kwargs)
+
+    @classmethod
+    def _enforce_dict_if_root(cls, obj: Any) -> Any:
+        if cls.__custom_root_type__ and (
+            not (isinstance(obj, dict) and obj.keys() == {ROOT_KEY})
+            and not (isinstance(obj, BaseModel) and obj.__fields__.keys() == {ROOT_KEY})
+            or cls.__fields__[ROOT_KEY].shape in MAPPING_LIKE_SHAPES
+        ):
+            return {ROOT_KEY: obj}
+        else:
+            return obj
+
+    @classmethod
+    def parse_obj(cls: Type['Model'], obj: Any) -> 'Model':
+        obj = cls._enforce_dict_if_root(obj)
+        if not isinstance(obj, dict):
+            try:
+                obj = dict(obj)
+            except (TypeError, ValueError) as e:
+                exc = TypeError(f'{cls.__name__} expected dict not {obj.__class__.__name__}')
+                raise ValidationError([ErrorWrapper(exc, loc=ROOT_KEY)], cls) from e
+        return cls(**obj)
+
+    @classmethod
+    def parse_raw(
+        cls: Type['Model'],
+        b: StrBytes,
+        *,
+        content_type: str = None,
+        encoding: str = 'utf8',
+        proto: Protocol = None,
+        allow_pickle: bool = False,
+    ) -> 'Model':
+        try:
+            obj = load_str_bytes(
+                b,
+                proto=proto,
+                content_type=content_type,
+                encoding=encoding,
+                allow_pickle=allow_pickle,
+                json_loads=cls.__config__.json_loads,
+            )
+        except (ValueError, TypeError, UnicodeDecodeError) as e:
+            raise ValidationError([ErrorWrapper(e, loc=ROOT_KEY)], cls)
+        return cls.parse_obj(obj)
+
+    @classmethod
+    def parse_file(
+        cls: Type['Model'],
+        path: Union[str, Path],
+        *,
+        content_type: str = None,
+        encoding: str = 'utf8',
+        proto: Protocol = None,
+        allow_pickle: bool = False,
+    ) -> 'Model':
+        obj = load_file(
+            path,
+            proto=proto,
+            content_type=content_type,
+            encoding=encoding,
+            allow_pickle=allow_pickle,
+            json_loads=cls.__config__.json_loads,
+        )
+        return cls.parse_obj(obj)
+
+    @classmethod
+    def from_orm(cls: Type['Model'], obj: Any) -> 'Model':
+        if not cls.__config__.orm_mode:
+            raise ConfigError('You must have the config attribute orm_mode=True to use from_orm')
+        obj = {ROOT_KEY: obj} if cls.__custom_root_type__ else cls._decompose_class(obj)
+        m = cls.__new__(cls)
+        values, fields_set, validation_error = validate_model(cls, obj)
+        if validation_error:
+            raise validation_error
+        object_setattr(m, '__dict__', values)
+        object_setattr(m, '__fields_set__', fields_set)
+        m._init_private_attributes()
+        return m
+
+    @classmethod
+    def construct(cls: Type['Model'], _fields_set: Optional['SetStr'] = None, **values: Any) -> 'Model':
+        """
+        Creates a new model setting __dict__ and __fields_set__ from trusted or pre-validated data.
+        Default values are respected, but no other validation is performed.
+        Behaves as if `Config.extra = 'allow'` was set since it adds all passed values
+        """
+        m = cls.__new__(cls)
+        fields_values: Dict[str, Any] = {}
+        for name, field in cls.__fields__.items():
+            if field.alt_alias and field.alias in values:
+                fields_values[name] = values[field.alias]
+            elif name in values:
+                fields_values[name] = values[name]
+            elif not field.required:
+                fields_values[name] = field.get_default()
+        fields_values.update(values)
+        object_setattr(m, '__dict__', fields_values)
+        if _fields_set is None:
+            _fields_set = set(values.keys())
+        object_setattr(m, '__fields_set__', _fields_set)
+        m._init_private_attributes()
+        return m
+
+    def _copy_and_set_values(self: 'Model', values: 'DictStrAny', fields_set: 'SetStr', *, deep: bool) -> 'Model':
+        if deep:
+            # chances of having empty dict here are quite low for using smart_deepcopy
+            values = deepcopy(values)
+
+        cls = self.__class__
+        m = cls.__new__(cls)
+        object_setattr(m, '__dict__', values)
+        object_setattr(m, '__fields_set__', fields_set)
+        for name in self.__private_attributes__:
+            value = getattr(self, name, Undefined)
+            if value is not Undefined:
+                if deep:
+                    value = deepcopy(value)
+                object_setattr(m, name, value)
+
+        return m
+
+    def copy(
+        self: 'Model',
+        *,
+        include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
+        exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
+        update: Optional['DictStrAny'] = None,
+        deep: bool = False,
+    ) -> 'Model':
+        """
+        Duplicate a model, optionally choose which fields to include, exclude and change.
+
+        :param include: fields to include in new model
+        :param exclude: fields to exclude from new model, as with values this takes precedence over include
+        :param update: values to change/add in the new model. Note: the data is not validated before creating
+            the new model: you should trust this data
+        :param deep: set to `True` to make a deep copy of the model
+        :return: new model instance
+        """
+
+        values = dict(
+            self._iter(to_dict=False, by_alias=False, include=include, exclude=exclude, exclude_unset=False),
+            **(update or {}),
+        )
+
+        # new `__fields_set__` can have unset optional fields with a set value in `update` kwarg
+        if update:
+            fields_set = self.__fields_set__ | update.keys()
+        else:
+            fields_set = set(self.__fields_set__)
+
+        return self._copy_and_set_values(values, fields_set, deep=deep)
+
+    @classmethod
+    def schema(cls, by_alias: bool = True, ref_template: str = default_ref_template) -> 'DictStrAny':
+        cached = cls.__schema_cache__.get((by_alias, ref_template))
+        if cached is not None:
+            return cached
+        s = model_schema(cls, by_alias=by_alias, ref_template=ref_template)
+        cls.__schema_cache__[(by_alias, ref_template)] = s
+        return s
+
+    @classmethod
+    def schema_json(
+        cls, *, by_alias: bool = True, ref_template: str = default_ref_template, **dumps_kwargs: Any
+    ) -> str:
+        from .json import pydantic_encoder
+
+        return cls.__config__.json_dumps(
+            cls.schema(by_alias=by_alias, ref_template=ref_template), default=pydantic_encoder, **dumps_kwargs
+        )
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield cls.validate
+
+    @classmethod
+    def validate(cls: Type['Model'], value: Any) -> 'Model':
+        if isinstance(value, cls):
+            copy_on_model_validation = cls.__config__.copy_on_model_validation
+            # whether to deep or shallow copy the model on validation, None means do not copy
+            deep_copy: Optional[bool] = None
+            if copy_on_model_validation not in {'deep', 'shallow', 'none'}:
+                # Warn about deprecated behavior
+                warnings.warn(
+                    "`copy_on_model_validation` should be a string: 'deep', 'shallow' or 'none'", DeprecationWarning
+                )
+                if copy_on_model_validation:
+                    deep_copy = False
+
+            if copy_on_model_validation == 'shallow':
+                # shallow copy
+                deep_copy = False
+            elif copy_on_model_validation == 'deep':
+                # deep copy
+                deep_copy = True
+
+            if deep_copy is None:
+                return value
+            else:
+                return value._copy_and_set_values(value.__dict__, value.__fields_set__, deep=deep_copy)
+
+        value = cls._enforce_dict_if_root(value)
+
+        if isinstance(value, dict):
+            return cls(**value)
+        elif cls.__config__.orm_mode:
+            return cls.from_orm(value)
+        else:
+            try:
+                value_as_dict = dict(value)
+            except (TypeError, ValueError) as e:
+                raise DictError() from e
+            return cls(**value_as_dict)
+
+    @classmethod
+    def _decompose_class(cls: Type['Model'], obj: Any) -> GetterDict:
+        if isinstance(obj, GetterDict):
+            return obj
+        return cls.__config__.getter_dict(obj)
+
+    @classmethod
+    @no_type_check
+    def _get_value(
+        cls,
+        v: Any,
+        to_dict: bool,
+        by_alias: bool,
+        include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']],
+        exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']],
+        exclude_unset: bool,
+        exclude_defaults: bool,
+        exclude_none: bool,
+    ) -> Any:
+        if isinstance(v, BaseModel):
+            if to_dict:
+                v_dict = v.dict(
+                    by_alias=by_alias,
+                    exclude_unset=exclude_unset,
+                    exclude_defaults=exclude_defaults,
+                    include=include,
+                    exclude=exclude,
+                    exclude_none=exclude_none,
+                )
+                if ROOT_KEY in v_dict:
+                    return v_dict[ROOT_KEY]
+                return v_dict
+            else:
+                return v.copy(include=include, exclude=exclude)
+
+        value_exclude = ValueItems(v, exclude) if exclude else None
+        value_include = ValueItems(v, include) if include else None
+
+        if isinstance(v, dict):
+            return {
+                k_: cls._get_value(
+                    v_,
+                    to_dict=to_dict,
+                    by_alias=by_alias,
+                    exclude_unset=exclude_unset,
+                    exclude_defaults=exclude_defaults,
+                    include=value_include and value_include.for_element(k_),
+                    exclude=value_exclude and value_exclude.for_element(k_),
+                    exclude_none=exclude_none,
+                )
+                for k_, v_ in v.items()
+                if (not value_exclude or not value_exclude.is_excluded(k_))
+                and (not value_include or value_include.is_included(k_))
+            }
+
+        elif sequence_like(v):
+            seq_args = (
+                cls._get_value(
+                    v_,
+                    to_dict=to_dict,
+                    by_alias=by_alias,
+                    exclude_unset=exclude_unset,
+                    exclude_defaults=exclude_defaults,
+                    include=value_include and value_include.for_element(i),
+                    exclude=value_exclude and value_exclude.for_element(i),
+                    exclude_none=exclude_none,
+                )
+                for i, v_ in enumerate(v)
+                if (not value_exclude or not value_exclude.is_excluded(i))
+                and (not value_include or value_include.is_included(i))
+            )
+
+            return v.__class__(*seq_args) if is_namedtuple(v.__class__) else v.__class__(seq_args)
+
+        elif isinstance(v, Enum) and getattr(cls.Config, 'use_enum_values', False):
+            return v.value
+
+        else:
+            return v
+
+    @classmethod
+    def __try_update_forward_refs__(cls, **localns: Any) -> None:
+        """
+        Same as update_forward_refs but will not raise exception
+        when forward references are not defined.
+        """
+        update_model_forward_refs(cls, cls.__fields__.values(), cls.__config__.json_encoders, localns, (NameError,))
+
+    @classmethod
+    def update_forward_refs(cls, **localns: Any) -> None:
+        """
+        Try to update ForwardRefs on fields based on this Model, globalns and localns.
+        """
+        update_model_forward_refs(cls, cls.__fields__.values(), cls.__config__.json_encoders, localns)
+
+    def __iter__(self) -> 'TupleGenerator':
+        """
+        so `dict(model)` works
+        """
+        yield from self.__dict__.items()
+
+    def _iter(
+        self,
+        to_dict: bool = False,
+        by_alias: bool = False,
+        include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
+        exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
+        exclude_unset: bool = False,
+        exclude_defaults: bool = False,
+        exclude_none: bool = False,
+    ) -> 'TupleGenerator':
+        # Merge field set excludes with explicit exclude parameter with explicit overriding field set options.
+        # The extra "is not None" guards are not logically necessary but optimizes performance for the simple case.
+        if exclude is not None or self.__exclude_fields__ is not None:
+            exclude = ValueItems.merge(self.__exclude_fields__, exclude)
+
+        if include is not None or self.__include_fields__ is not None:
+            include = ValueItems.merge(self.__include_fields__, include, intersect=True)
+
+        allowed_keys = self._calculate_keys(
+            include=include, exclude=exclude, exclude_unset=exclude_unset  # type: ignore
+        )
+        if allowed_keys is None and not (to_dict or by_alias or exclude_unset or exclude_defaults or exclude_none):
+            # huge boost for plain _iter()
+            yield from self.__dict__.items()
+            return
+
+        value_exclude = ValueItems(self, exclude) if exclude is not None else None
+        value_include = ValueItems(self, include) if include is not None else None
+
+        for field_key, v in self.__dict__.items():
+            if (allowed_keys is not None and field_key not in allowed_keys) or (exclude_none and v is None):
+                continue
+
+            if exclude_defaults:
+                model_field = self.__fields__.get(field_key)
+                if not getattr(model_field, 'required', True) and getattr(model_field, 'default', _missing) == v:
+                    continue
+
+            if by_alias and field_key in self.__fields__:
+                dict_key = self.__fields__[field_key].alias
+            else:
+                dict_key = field_key
+
+            if to_dict or value_include or value_exclude:
+                v = self._get_value(
+                    v,
+                    to_dict=to_dict,
+                    by_alias=by_alias,
+                    include=value_include and value_include.for_element(field_key),
+                    exclude=value_exclude and value_exclude.for_element(field_key),
+                    exclude_unset=exclude_unset,
+                    exclude_defaults=exclude_defaults,
+                    exclude_none=exclude_none,
+                )
+            yield dict_key, v
+
+    def _calculate_keys(
+        self,
+        include: Optional['MappingIntStrAny'],
+        exclude: Optional['MappingIntStrAny'],
+        exclude_unset: bool,
+        update: Optional['DictStrAny'] = None,
+    ) -> Optional[AbstractSet[str]]:
+        if include is None and exclude is None and exclude_unset is False:
+            return None
+
+        keys: AbstractSet[str]
+        if exclude_unset:
+            keys = self.__fields_set__.copy()
+        else:
+            keys = self.__dict__.keys()
+
+        if include is not None:
+            keys &= include.keys()
+
+        if update:
+            keys -= update.keys()
+
+        if exclude:
+            keys -= {k for k, v in exclude.items() if ValueItems.is_true(v)}
+
+        return keys
+
+    def __eq__(self, other: Any) -> bool:
+        if isinstance(other, BaseModel):
+            return self.dict() == other.dict()
+        else:
+            return self.dict() == other
+
+    def __repr_args__(self) -> 'ReprArgs':
+        return [
+            (k, v)
+            for k, v in self.__dict__.items()
+            if k not in DUNDER_ATTRIBUTES and (k not in self.__fields__ or self.__fields__[k].field_info.repr)
+        ]
+
+
+_is_base_model_class_defined = True
+
+
+@overload
+def create_model(
+    __model_name: str,
+    *,
+    __config__: Optional[Type[BaseConfig]] = None,
+    __base__: None = None,
+    __module__: str = __name__,
+    __validators__: Dict[str, 'AnyClassMethod'] = None,
+    __cls_kwargs__: Dict[str, Any] = None,
+    **field_definitions: Any,
+) -> Type['BaseModel']:
+    ...
+
+
+@overload
+def create_model(
+    __model_name: str,
+    *,
+    __config__: Optional[Type[BaseConfig]] = None,
+    __base__: Union[Type['Model'], Tuple[Type['Model'], ...]],
+    __module__: str = __name__,
+    __validators__: Dict[str, 'AnyClassMethod'] = None,
+    __cls_kwargs__: Dict[str, Any] = None,
+    **field_definitions: Any,
+) -> Type['Model']:
+    ...
+
+
+def create_model(
+    __model_name: str,
+    *,
+    __config__: Optional[Type[BaseConfig]] = None,
+    __base__: Union[None, Type['Model'], Tuple[Type['Model'], ...]] = None,
+    __module__: str = __name__,
+    __validators__: Dict[str, 'AnyClassMethod'] = None,
+    __cls_kwargs__: Dict[str, Any] = None,
+    __slots__: Optional[Tuple[str, ...]] = None,
+    **field_definitions: Any,
+) -> Type['Model']:
+    """
+    Dynamically create a model.
+    :param __model_name: name of the created model
+    :param __config__: config class to use for the new model
+    :param __base__: base class for the new model to inherit from
+    :param __module__: module of the created model
+    :param __validators__: a dict of method names and @validator class methods
+    :param __cls_kwargs__: a dict for class creation
+    :param __slots__: Deprecated, `__slots__` should not be passed to `create_model`
+    :param field_definitions: fields of the model (or extra fields if a base is supplied)
+        in the format `<name>=(<type>, <default default>)` or `<name>=<default value>, e.g.
+        `foobar=(str, ...)` or `foobar=123`, or, for complex use-cases, in the format
+        `<name>=<Field>` or `<name>=(<type>, <FieldInfo>)`, e.g.
+        `foo=Field(datetime, default_factory=datetime.utcnow, alias='bar')` or
+        `foo=(str, FieldInfo(title='Foo'))`
+    """
+    if __slots__ is not None:
+        # __slots__ will be ignored from here on
+        warnings.warn('__slots__ should not be passed to create_model', RuntimeWarning)
+
+    if __base__ is not None:
+        if __config__ is not None:
+            raise ConfigError('to avoid confusion __config__ and __base__ cannot be used together')
+        if not isinstance(__base__, tuple):
+            __base__ = (__base__,)
+    else:
+        __base__ = (cast(Type['Model'], BaseModel),)
+
+    __cls_kwargs__ = __cls_kwargs__ or {}
+
+    fields = {}
+    annotations = {}
+
+    for f_name, f_def in field_definitions.items():
+        if not is_valid_field(f_name):
+            warnings.warn(f'fields may not start with an underscore, ignoring "{f_name}"', RuntimeWarning)
+        if isinstance(f_def, tuple):
+            try:
+                f_annotation, f_value = f_def
+            except ValueError as e:
+                raise ConfigError(
+                    'field definitions should either be a tuple of (<type>, <default>) or just a '
+                    'default value, unfortunately this means tuples as '
+                    'default values are not allowed'
+                ) from e
+        else:
+            f_annotation, f_value = None, f_def
+
+        if f_annotation:
+            annotations[f_name] = f_annotation
+        fields[f_name] = f_value
+
+    namespace: 'DictStrAny' = {'__annotations__': annotations, '__module__': __module__}
+    if __validators__:
+        namespace.update(__validators__)
+    namespace.update(fields)
+    if __config__:
+        namespace['Config'] = inherit_config(__config__, BaseConfig)
+    resolved_bases = resolve_bases(__base__)
+    meta, ns, kwds = prepare_class(__model_name, resolved_bases, kwds=__cls_kwargs__)
+    if resolved_bases is not __base__:
+        ns['__orig_bases__'] = __base__
+    namespace.update(ns)
+    return meta(__model_name, resolved_bases, namespace, **kwds)
+
+
+_missing = object()
+
+
+def validate_model(  # noqa: C901 (ignore complexity)
+    model: Type[BaseModel], input_data: 'DictStrAny', cls: 'ModelOrDc' = None
+) -> Tuple['DictStrAny', 'SetStr', Optional[ValidationError]]:
+    """
+    validate data against a model.
+    """
+    values = {}
+    errors = []
+    # input_data names, possibly alias
+    names_used = set()
+    # field names, never aliases
+    fields_set = set()
+    config = model.__config__
+    check_extra = config.extra is not Extra.ignore
+    cls_ = cls or model
+
+    for validator in model.__pre_root_validators__:
+        try:
+            input_data = validator(cls_, input_data)
+        except (ValueError, TypeError, AssertionError) as exc:
+            return {}, set(), ValidationError([ErrorWrapper(exc, loc=ROOT_KEY)], cls_)
+
+    for name, field in model.__fields__.items():
+        value = input_data.get(field.alias, _missing)
+        using_name = False
+        if value is _missing and config.allow_population_by_field_name and field.alt_alias:
+            value = input_data.get(field.name, _missing)
+            using_name = True
+
+        if value is _missing:
+            if field.required:
+                errors.append(ErrorWrapper(MissingError(), loc=field.alias))
+                continue
+
+            value = field.get_default()
+
+            if not config.validate_all and not field.validate_always:
+                values[name] = value
+                continue
+        else:
+            fields_set.add(name)
+            if check_extra:
+                names_used.add(field.name if using_name else field.alias)
+
+        v_, errors_ = field.validate(value, values, loc=field.alias, cls=cls_)
+        if isinstance(errors_, ErrorWrapper):
+            errors.append(errors_)
+        elif isinstance(errors_, list):
+            errors.extend(errors_)
+        else:
+            values[name] = v_
+
+    if check_extra:
+        if isinstance(input_data, GetterDict):
+            extra = input_data.extra_keys() - names_used
+        else:
+            extra = input_data.keys() - names_used
+        if extra:
+            fields_set |= extra
+            if config.extra is Extra.allow:
+                for f in extra:
+                    values[f] = input_data[f]
+            else:
+                for f in sorted(extra):
+                    errors.append(ErrorWrapper(ExtraError(), loc=f))
+
+    for skip_on_failure, validator in model.__post_root_validators__:
+        if skip_on_failure and errors:
+            continue
+        try:
+            values = validator(cls_, values)
+        except (ValueError, TypeError, AssertionError) as exc:
+            errors.append(ErrorWrapper(exc, loc=ROOT_KEY))
+
+    if errors:
+        return values, fields_set, ValidationError(errors, cls_)
+    else:
+        return values, fields_set, None
diff --git a/lib/pydantic/v1/mypy.py b/lib/pydantic/v1/mypy.py
new file mode 100644
index 00000000..1d6d5ae2
--- /dev/null
+++ b/lib/pydantic/v1/mypy.py
@@ -0,0 +1,944 @@
+import sys
+from configparser import ConfigParser
+from typing import Any, Callable, Dict, List, Optional, Set, Tuple, Type as TypingType, Union
+
+from mypy.errorcodes import ErrorCode
+from mypy.nodes import (
+    ARG_NAMED,
+    ARG_NAMED_OPT,
+    ARG_OPT,
+    ARG_POS,
+    ARG_STAR2,
+    MDEF,
+    Argument,
+    AssignmentStmt,
+    Block,
+    CallExpr,
+    ClassDef,
+    Context,
+    Decorator,
+    EllipsisExpr,
+    FuncBase,
+    FuncDef,
+    JsonDict,
+    MemberExpr,
+    NameExpr,
+    PassStmt,
+    PlaceholderNode,
+    RefExpr,
+    StrExpr,
+    SymbolNode,
+    SymbolTableNode,
+    TempNode,
+    TypeInfo,
+    TypeVarExpr,
+    Var,
+)
+from mypy.options import Options
+from mypy.plugin import (
+    CheckerPluginInterface,
+    ClassDefContext,
+    FunctionContext,
+    MethodContext,
+    Plugin,
+    ReportConfigContext,
+    SemanticAnalyzerPluginInterface,
+)
+from mypy.plugins import dataclasses
+from mypy.semanal import set_callable_name  # type: ignore
+from mypy.server.trigger import make_wildcard_trigger
+from mypy.types import (
+    AnyType,
+    CallableType,
+    Instance,
+    NoneType,
+    Overloaded,
+    ProperType,
+    Type,
+    TypeOfAny,
+    TypeType,
+    TypeVarType,
+    UnionType,
+    get_proper_type,
+)
+from mypy.typevars import fill_typevars
+from mypy.util import get_unique_redefinition_name
+from mypy.version import __version__ as mypy_version
+
+from pydantic.utils import is_valid_field
+
+try:
+    from mypy.types import TypeVarDef  # type: ignore[attr-defined]
+except ImportError:  # pragma: no cover
+    # Backward-compatible with TypeVarDef from Mypy 0.910.
+    from mypy.types import TypeVarType as TypeVarDef
+
+CONFIGFILE_KEY = 'pydantic-mypy'
+METADATA_KEY = 'pydantic-mypy-metadata'
+_NAMESPACE = __name__[:-5]  # 'pydantic' in 1.10.X, 'pydantic.v1' in v2.X
+BASEMODEL_FULLNAME = f'{_NAMESPACE}.main.BaseModel'
+BASESETTINGS_FULLNAME = f'{_NAMESPACE}.env_settings.BaseSettings'
+MODEL_METACLASS_FULLNAME = f'{_NAMESPACE}.main.ModelMetaclass'
+FIELD_FULLNAME = f'{_NAMESPACE}.fields.Field'
+DATACLASS_FULLNAME = f'{_NAMESPACE}.dataclasses.dataclass'
+
+
+def parse_mypy_version(version: str) -> Tuple[int, ...]:
+    return tuple(map(int, version.partition('+')[0].split('.')))
+
+
+MYPY_VERSION_TUPLE = parse_mypy_version(mypy_version)
+BUILTINS_NAME = 'builtins' if MYPY_VERSION_TUPLE >= (0, 930) else '__builtins__'
+
+# Increment version if plugin changes and mypy caches should be invalidated
+__version__ = 2
+
+
+def plugin(version: str) -> 'TypingType[Plugin]':
+    """
+    `version` is the mypy version string
+
+    We might want to use this to print a warning if the mypy version being used is
+    newer, or especially older, than we expect (or need).
+    """
+    return PydanticPlugin
+
+
+class PydanticPlugin(Plugin):
+    def __init__(self, options: Options) -> None:
+        self.plugin_config = PydanticPluginConfig(options)
+        self._plugin_data = self.plugin_config.to_data()
+        super().__init__(options)
+
+    def get_base_class_hook(self, fullname: str) -> 'Optional[Callable[[ClassDefContext], None]]':
+        sym = self.lookup_fully_qualified(fullname)
+        if sym and isinstance(sym.node, TypeInfo):  # pragma: no branch
+            # No branching may occur if the mypy cache has not been cleared
+            if any(get_fullname(base) == BASEMODEL_FULLNAME for base in sym.node.mro):
+                return self._pydantic_model_class_maker_callback
+        return None
+
+    def get_metaclass_hook(self, fullname: str) -> Optional[Callable[[ClassDefContext], None]]:
+        if fullname == MODEL_METACLASS_FULLNAME:
+            return self._pydantic_model_metaclass_marker_callback
+        return None
+
+    def get_function_hook(self, fullname: str) -> 'Optional[Callable[[FunctionContext], Type]]':
+        sym = self.lookup_fully_qualified(fullname)
+        if sym and sym.fullname == FIELD_FULLNAME:
+            return self._pydantic_field_callback
+        return None
+
+    def get_method_hook(self, fullname: str) -> Optional[Callable[[MethodContext], Type]]:
+        if fullname.endswith('.from_orm'):
+            return from_orm_callback
+        return None
+
+    def get_class_decorator_hook(self, fullname: str) -> Optional[Callable[[ClassDefContext], None]]:
+        """Mark pydantic.dataclasses as dataclass.
+
+        Mypy version 1.1.1 added support for `@dataclass_transform` decorator.
+        """
+        if fullname == DATACLASS_FULLNAME and MYPY_VERSION_TUPLE < (1, 1):
+            return dataclasses.dataclass_class_maker_callback  # type: ignore[return-value]
+        return None
+
+    def report_config_data(self, ctx: ReportConfigContext) -> Dict[str, Any]:
+        """Return all plugin config data.
+
+        Used by mypy to determine if cache needs to be discarded.
+        """
+        return self._plugin_data
+
+    def _pydantic_model_class_maker_callback(self, ctx: ClassDefContext) -> None:
+        transformer = PydanticModelTransformer(ctx, self.plugin_config)
+        transformer.transform()
+
+    def _pydantic_model_metaclass_marker_callback(self, ctx: ClassDefContext) -> None:
+        """Reset dataclass_transform_spec attribute of ModelMetaclass.
+
+        Let the plugin handle it. This behavior can be disabled
+        if 'debug_dataclass_transform' is set to True', for testing purposes.
+        """
+        if self.plugin_config.debug_dataclass_transform:
+            return
+        info_metaclass = ctx.cls.info.declared_metaclass
+        assert info_metaclass, "callback not passed from 'get_metaclass_hook'"
+        if getattr(info_metaclass.type, 'dataclass_transform_spec', None):
+            info_metaclass.type.dataclass_transform_spec = None  # type: ignore[attr-defined]
+
+    def _pydantic_field_callback(self, ctx: FunctionContext) -> 'Type':
+        """
+        Extract the type of the `default` argument from the Field function, and use it as the return type.
+
+        In particular:
+        * Check whether the default and default_factory argument is specified.
+        * Output an error if both are specified.
+        * Retrieve the type of the argument which is specified, and use it as return type for the function.
+        """
+        default_any_type = ctx.default_return_type
+
+        assert ctx.callee_arg_names[0] == 'default', '"default" is no longer first argument in Field()'
+        assert ctx.callee_arg_names[1] == 'default_factory', '"default_factory" is no longer second argument in Field()'
+        default_args = ctx.args[0]
+        default_factory_args = ctx.args[1]
+
+        if default_args and default_factory_args:
+            error_default_and_default_factory_specified(ctx.api, ctx.context)
+            return default_any_type
+
+        if default_args:
+            default_type = ctx.arg_types[0][0]
+            default_arg = default_args[0]
+
+            # Fallback to default Any type if the field is required
+            if not isinstance(default_arg, EllipsisExpr):
+                return default_type
+
+        elif default_factory_args:
+            default_factory_type = ctx.arg_types[1][0]
+
+            # Functions which use `ParamSpec` can be overloaded, exposing the callable's types as a parameter
+            # Pydantic calls the default factory without any argument, so we retrieve the first item
+            if isinstance(default_factory_type, Overloaded):
+                if MYPY_VERSION_TUPLE > (0, 910):
+                    default_factory_type = default_factory_type.items[0]
+                else:
+                    # Mypy0.910 exposes the items of overloaded types in a function
+                    default_factory_type = default_factory_type.items()[0]  # type: ignore[operator]
+
+            if isinstance(default_factory_type, CallableType):
+                ret_type = default_factory_type.ret_type
+                # mypy doesn't think `ret_type` has `args`, you'd think mypy should know,
+                # add this check in case it varies by version
+                args = getattr(ret_type, 'args', None)
+                if args:
+                    if all(isinstance(arg, TypeVarType) for arg in args):
+                        # Looks like the default factory is a type like `list` or `dict`, replace all args with `Any`
+                        ret_type.args = tuple(default_any_type for _ in args)  # type: ignore[attr-defined]
+                return ret_type
+
+        return default_any_type
+
+
+class PydanticPluginConfig:
+    __slots__ = (
+        'init_forbid_extra',
+        'init_typed',
+        'warn_required_dynamic_aliases',
+        'warn_untyped_fields',
+        'debug_dataclass_transform',
+    )
+    init_forbid_extra: bool
+    init_typed: bool
+    warn_required_dynamic_aliases: bool
+    warn_untyped_fields: bool
+    debug_dataclass_transform: bool  # undocumented
+
+    def __init__(self, options: Options) -> None:
+        if options.config_file is None:  # pragma: no cover
+            return
+
+        toml_config = parse_toml(options.config_file)
+        if toml_config is not None:
+            config = toml_config.get('tool', {}).get('pydantic-mypy', {})
+            for key in self.__slots__:
+                setting = config.get(key, False)
+                if not isinstance(setting, bool):
+                    raise ValueError(f'Configuration value must be a boolean for key: {key}')
+                setattr(self, key, setting)
+        else:
+            plugin_config = ConfigParser()
+            plugin_config.read(options.config_file)
+            for key in self.__slots__:
+                setting = plugin_config.getboolean(CONFIGFILE_KEY, key, fallback=False)
+                setattr(self, key, setting)
+
+    def to_data(self) -> Dict[str, Any]:
+        return {key: getattr(self, key) for key in self.__slots__}
+
+
+def from_orm_callback(ctx: MethodContext) -> Type:
+    """
+    Raise an error if orm_mode is not enabled
+    """
+    model_type: Instance
+    ctx_type = ctx.type
+    if isinstance(ctx_type, TypeType):
+        ctx_type = ctx_type.item
+    if isinstance(ctx_type, CallableType) and isinstance(ctx_type.ret_type, Instance):
+        model_type = ctx_type.ret_type  # called on the class
+    elif isinstance(ctx_type, Instance):
+        model_type = ctx_type  # called on an instance (unusual, but still valid)
+    else:  # pragma: no cover
+        detail = f'ctx.type: {ctx_type} (of type {ctx_type.__class__.__name__})'
+        error_unexpected_behavior(detail, ctx.api, ctx.context)
+        return ctx.default_return_type
+    pydantic_metadata = model_type.type.metadata.get(METADATA_KEY)
+    if pydantic_metadata is None:
+        return ctx.default_return_type
+    orm_mode = pydantic_metadata.get('config', {}).get('orm_mode')
+    if orm_mode is not True:
+        error_from_orm(get_name(model_type.type), ctx.api, ctx.context)
+    return ctx.default_return_type
+
+
+class PydanticModelTransformer:
+    tracked_config_fields: Set[str] = {
+        'extra',
+        'allow_mutation',
+        'frozen',
+        'orm_mode',
+        'allow_population_by_field_name',
+        'alias_generator',
+    }
+
+    def __init__(self, ctx: ClassDefContext, plugin_config: PydanticPluginConfig) -> None:
+        self._ctx = ctx
+        self.plugin_config = plugin_config
+
+    def transform(self) -> None:
+        """
+        Configures the BaseModel subclass according to the plugin settings.
+
+        In particular:
+        * determines the model config and fields,
+        * adds a fields-aware signature for the initializer and construct methods
+        * freezes the class if allow_mutation = False or frozen = True
+        * stores the fields, config, and if the class is settings in the mypy metadata for access by subclasses
+        """
+        ctx = self._ctx
+        info = ctx.cls.info
+
+        self.adjust_validator_signatures()
+        config = self.collect_config()
+        fields = self.collect_fields(config)
+        is_settings = any(get_fullname(base) == BASESETTINGS_FULLNAME for base in info.mro[:-1])
+        self.add_initializer(fields, config, is_settings)
+        self.add_construct_method(fields)
+        self.set_frozen(fields, frozen=config.allow_mutation is False or config.frozen is True)
+        info.metadata[METADATA_KEY] = {
+            'fields': {field.name: field.serialize() for field in fields},
+            'config': config.set_values_dict(),
+        }
+
+    def adjust_validator_signatures(self) -> None:
+        """When we decorate a function `f` with `pydantic.validator(...), mypy sees
+        `f` as a regular method taking a `self` instance, even though pydantic
+        internally wraps `f` with `classmethod` if necessary.
+
+        Teach mypy this by marking any function whose outermost decorator is a
+        `validator()` call as a classmethod.
+        """
+        for name, sym in self._ctx.cls.info.names.items():
+            if isinstance(sym.node, Decorator):
+                first_dec = sym.node.original_decorators[0]
+                if (
+                    isinstance(first_dec, CallExpr)
+                    and isinstance(first_dec.callee, NameExpr)
+                    and first_dec.callee.fullname == f'{_NAMESPACE}.class_validators.validator'
+                ):
+                    sym.node.func.is_class = True
+
+    def collect_config(self) -> 'ModelConfigData':
+        """
+        Collects the values of the config attributes that are used by the plugin, accounting for parent classes.
+        """
+        ctx = self._ctx
+        cls = ctx.cls
+        config = ModelConfigData()
+        for stmt in cls.defs.body:
+            if not isinstance(stmt, ClassDef):
+                continue
+            if stmt.name == 'Config':
+                for substmt in stmt.defs.body:
+                    if not isinstance(substmt, AssignmentStmt):
+                        continue
+                    config.update(self.get_config_update(substmt))
+                if (
+                    config.has_alias_generator
+                    and not config.allow_population_by_field_name
+                    and self.plugin_config.warn_required_dynamic_aliases
+                ):
+                    error_required_dynamic_aliases(ctx.api, stmt)
+        for info in cls.info.mro[1:]:  # 0 is the current class
+            if METADATA_KEY not in info.metadata:
+                continue
+
+            # Each class depends on the set of fields in its ancestors
+            ctx.api.add_plugin_dependency(make_wildcard_trigger(get_fullname(info)))
+            for name, value in info.metadata[METADATA_KEY]['config'].items():
+                config.setdefault(name, value)
+        return config
+
+    def collect_fields(self, model_config: 'ModelConfigData') -> List['PydanticModelField']:
+        """
+        Collects the fields for the model, accounting for parent classes
+        """
+        # First, collect fields belonging to the current class.
+        ctx = self._ctx
+        cls = self._ctx.cls
+        fields = []  # type: List[PydanticModelField]
+        known_fields = set()  # type: Set[str]
+        for stmt in cls.defs.body:
+            if not isinstance(stmt, AssignmentStmt):  # `and stmt.new_syntax` to require annotation
+                continue
+
+            lhs = stmt.lvalues[0]
+            if not isinstance(lhs, NameExpr) or not is_valid_field(lhs.name):
+                continue
+
+            if not stmt.new_syntax and self.plugin_config.warn_untyped_fields:
+                error_untyped_fields(ctx.api, stmt)
+
+            # if lhs.name == '__config__':  # BaseConfig not well handled; I'm not sure why yet
+            #     continue
+
+            sym = cls.info.names.get(lhs.name)
+            if sym is None:  # pragma: no cover
+                # This is likely due to a star import (see the dataclasses plugin for a more detailed explanation)
+                # This is the same logic used in the dataclasses plugin
+                continue
+
+            node = sym.node
+            if isinstance(node, PlaceholderNode):  # pragma: no cover
+                # See the PlaceholderNode docstring for more detail about how this can occur
+                # Basically, it is an edge case when dealing with complex import logic
+                # This is the same logic used in the dataclasses plugin
+                continue
+            if not isinstance(node, Var):  # pragma: no cover
+                # Don't know if this edge case still happens with the `is_valid_field` check above
+                # but better safe than sorry
+                continue
+
+            # x: ClassVar[int] is ignored by dataclasses.
+            if node.is_classvar:
+                continue
+
+            is_required = self.get_is_required(cls, stmt, lhs)
+            alias, has_dynamic_alias = self.get_alias_info(stmt)
+            if (
+                has_dynamic_alias
+                and not model_config.allow_population_by_field_name
+                and self.plugin_config.warn_required_dynamic_aliases
+            ):
+                error_required_dynamic_aliases(ctx.api, stmt)
+            fields.append(
+                PydanticModelField(
+                    name=lhs.name,
+                    is_required=is_required,
+                    alias=alias,
+                    has_dynamic_alias=has_dynamic_alias,
+                    line=stmt.line,
+                    column=stmt.column,
+                )
+            )
+            known_fields.add(lhs.name)
+        all_fields = fields.copy()
+        for info in cls.info.mro[1:]:  # 0 is the current class, -2 is BaseModel, -1 is object
+            if METADATA_KEY not in info.metadata:
+                continue
+
+            superclass_fields = []
+            # Each class depends on the set of fields in its ancestors
+            ctx.api.add_plugin_dependency(make_wildcard_trigger(get_fullname(info)))
+
+            for name, data in info.metadata[METADATA_KEY]['fields'].items():
+                if name not in known_fields:
+                    field = PydanticModelField.deserialize(info, data)
+                    known_fields.add(name)
+                    superclass_fields.append(field)
+                else:
+                    (field,) = (a for a in all_fields if a.name == name)
+                    all_fields.remove(field)
+                    superclass_fields.append(field)
+            all_fields = superclass_fields + all_fields
+        return all_fields
+
+    def add_initializer(self, fields: List['PydanticModelField'], config: 'ModelConfigData', is_settings: bool) -> None:
+        """
+        Adds a fields-aware `__init__` method to the class.
+
+        The added `__init__` will be annotated with types vs. all `Any` depending on the plugin settings.
+        """
+        ctx = self._ctx
+        typed = self.plugin_config.init_typed
+        use_alias = config.allow_population_by_field_name is not True
+        force_all_optional = is_settings or bool(
+            config.has_alias_generator and not config.allow_population_by_field_name
+        )
+        init_arguments = self.get_field_arguments(
+            fields, typed=typed, force_all_optional=force_all_optional, use_alias=use_alias
+        )
+        if not self.should_init_forbid_extra(fields, config):
+            var = Var('kwargs')
+            init_arguments.append(Argument(var, AnyType(TypeOfAny.explicit), None, ARG_STAR2))
+
+        if '__init__' not in ctx.cls.info.names:
+            add_method(ctx, '__init__', init_arguments, NoneType())
+
+    def add_construct_method(self, fields: List['PydanticModelField']) -> None:
+        """
+        Adds a fully typed `construct` classmethod to the class.
+
+        Similar to the fields-aware __init__ method, but always uses the field names (not aliases),
+        and does not treat settings fields as optional.
+        """
+        ctx = self._ctx
+        set_str = ctx.api.named_type(f'{BUILTINS_NAME}.set', [ctx.api.named_type(f'{BUILTINS_NAME}.str')])
+        optional_set_str = UnionType([set_str, NoneType()])
+        fields_set_argument = Argument(Var('_fields_set', optional_set_str), optional_set_str, None, ARG_OPT)
+        construct_arguments = self.get_field_arguments(fields, typed=True, force_all_optional=False, use_alias=False)
+        construct_arguments = [fields_set_argument] + construct_arguments
+
+        obj_type = ctx.api.named_type(f'{BUILTINS_NAME}.object')
+        self_tvar_name = '_PydanticBaseModel'  # Make sure it does not conflict with other names in the class
+        tvar_fullname = ctx.cls.fullname + '.' + self_tvar_name
+        if MYPY_VERSION_TUPLE >= (1, 4):
+            tvd = TypeVarType(
+                self_tvar_name,
+                tvar_fullname,
+                -1,
+                [],
+                obj_type,
+                AnyType(TypeOfAny.from_omitted_generics),  # type: ignore[arg-type]
+            )
+            self_tvar_expr = TypeVarExpr(
+                self_tvar_name,
+                tvar_fullname,
+                [],
+                obj_type,
+                AnyType(TypeOfAny.from_omitted_generics),  # type: ignore[arg-type]
+            )
+        else:
+            tvd = TypeVarDef(self_tvar_name, tvar_fullname, -1, [], obj_type)
+            self_tvar_expr = TypeVarExpr(self_tvar_name, tvar_fullname, [], obj_type)
+        ctx.cls.info.names[self_tvar_name] = SymbolTableNode(MDEF, self_tvar_expr)
+
+        # Backward-compatible with TypeVarDef from Mypy 0.910.
+        if isinstance(tvd, TypeVarType):
+            self_type = tvd
+        else:
+            self_type = TypeVarType(tvd)
+
+        add_method(
+            ctx,
+            'construct',
+            construct_arguments,
+            return_type=self_type,
+            self_type=self_type,
+            tvar_def=tvd,
+            is_classmethod=True,
+        )
+
+    def set_frozen(self, fields: List['PydanticModelField'], frozen: bool) -> None:
+        """
+        Marks all fields as properties so that attempts to set them trigger mypy errors.
+
+        This is the same approach used by the attrs and dataclasses plugins.
+        """
+        ctx = self._ctx
+        info = ctx.cls.info
+        for field in fields:
+            sym_node = info.names.get(field.name)
+            if sym_node is not None:
+                var = sym_node.node
+                if isinstance(var, Var):
+                    var.is_property = frozen
+                elif isinstance(var, PlaceholderNode) and not ctx.api.final_iteration:
+                    # See https://github.com/pydantic/pydantic/issues/5191 to hit this branch for test coverage
+                    ctx.api.defer()
+                else:  # pragma: no cover
+                    # I don't know whether it's possible to hit this branch, but I've added it for safety
+                    try:
+                        var_str = str(var)
+                    except TypeError:
+                        # This happens for PlaceholderNode; perhaps it will happen for other types in the future..
+                        var_str = repr(var)
+                    detail = f'sym_node.node: {var_str} (of type {var.__class__})'
+                    error_unexpected_behavior(detail, ctx.api, ctx.cls)
+            else:
+                var = field.to_var(info, use_alias=False)
+                var.info = info
+                var.is_property = frozen
+                var._fullname = get_fullname(info) + '.' + get_name(var)
+                info.names[get_name(var)] = SymbolTableNode(MDEF, var)
+
+    def get_config_update(self, substmt: AssignmentStmt) -> Optional['ModelConfigData']:
+        """
+        Determines the config update due to a single statement in the Config class definition.
+
+        Warns if a tracked config attribute is set to a value the plugin doesn't know how to interpret (e.g., an int)
+        """
+        lhs = substmt.lvalues[0]
+        if not (isinstance(lhs, NameExpr) and lhs.name in self.tracked_config_fields):
+            return None
+        if lhs.name == 'extra':
+            if isinstance(substmt.rvalue, StrExpr):
+                forbid_extra = substmt.rvalue.value == 'forbid'
+            elif isinstance(substmt.rvalue, MemberExpr):
+                forbid_extra = substmt.rvalue.name == 'forbid'
+            else:
+                error_invalid_config_value(lhs.name, self._ctx.api, substmt)
+                return None
+            return ModelConfigData(forbid_extra=forbid_extra)
+        if lhs.name == 'alias_generator':
+            has_alias_generator = True
+            if isinstance(substmt.rvalue, NameExpr) and substmt.rvalue.fullname == 'builtins.None':
+                has_alias_generator = False
+            return ModelConfigData(has_alias_generator=has_alias_generator)
+        if isinstance(substmt.rvalue, NameExpr) and substmt.rvalue.fullname in ('builtins.True', 'builtins.False'):
+            return ModelConfigData(**{lhs.name: substmt.rvalue.fullname == 'builtins.True'})
+        error_invalid_config_value(lhs.name, self._ctx.api, substmt)
+        return None
+
+    @staticmethod
+    def get_is_required(cls: ClassDef, stmt: AssignmentStmt, lhs: NameExpr) -> bool:
+        """
+        Returns a boolean indicating whether the field defined in `stmt` is a required field.
+        """
+        expr = stmt.rvalue
+        if isinstance(expr, TempNode):
+            # TempNode means annotation-only, so only non-required if Optional
+            value_type = get_proper_type(cls.info[lhs.name].type)
+            return not PydanticModelTransformer.type_has_implicit_default(value_type)
+        if isinstance(expr, CallExpr) and isinstance(expr.callee, RefExpr) and expr.callee.fullname == FIELD_FULLNAME:
+            # The "default value" is a call to `Field`; at this point, the field is
+            # only required if default is Ellipsis (i.e., `field_name: Annotation = Field(...)`) or if default_factory
+            # is specified.
+            for arg, name in zip(expr.args, expr.arg_names):
+                # If name is None, then this arg is the default because it is the only positional argument.
+                if name is None or name == 'default':
+                    return arg.__class__ is EllipsisExpr
+                if name == 'default_factory':
+                    return False
+            # In this case, default and default_factory are not specified, so we need to look at the annotation
+            value_type = get_proper_type(cls.info[lhs.name].type)
+            return not PydanticModelTransformer.type_has_implicit_default(value_type)
+        # Only required if the "default value" is Ellipsis (i.e., `field_name: Annotation = ...`)
+        return isinstance(expr, EllipsisExpr)
+
+    @staticmethod
+    def type_has_implicit_default(type_: Optional[ProperType]) -> bool:
+        """
+        Returns True if the passed type will be given an implicit default value.
+
+        In pydantic v1, this is the case for Optional types and Any (with default value None).
+        """
+        if isinstance(type_, AnyType):
+            # Annotated as Any
+            return True
+        if isinstance(type_, UnionType) and any(
+            isinstance(item, NoneType) or isinstance(item, AnyType) for item in type_.items
+        ):
+            # Annotated as Optional, or otherwise having NoneType or AnyType in the union
+            return True
+        return False
+
+    @staticmethod
+    def get_alias_info(stmt: AssignmentStmt) -> Tuple[Optional[str], bool]:
+        """
+        Returns a pair (alias, has_dynamic_alias), extracted from the declaration of the field defined in `stmt`.
+
+        `has_dynamic_alias` is True if and only if an alias is provided, but not as a string literal.
+        If `has_dynamic_alias` is True, `alias` will be None.
+        """
+        expr = stmt.rvalue
+        if isinstance(expr, TempNode):
+            # TempNode means annotation-only
+            return None, False
+
+        if not (
+            isinstance(expr, CallExpr) and isinstance(expr.callee, RefExpr) and expr.callee.fullname == FIELD_FULLNAME
+        ):
+            # Assigned value is not a call to pydantic.fields.Field
+            return None, False
+
+        for i, arg_name in enumerate(expr.arg_names):
+            if arg_name != 'alias':
+                continue
+            arg = expr.args[i]
+            if isinstance(arg, StrExpr):
+                return arg.value, False
+            else:
+                return None, True
+        return None, False
+
+    def get_field_arguments(
+        self, fields: List['PydanticModelField'], typed: bool, force_all_optional: bool, use_alias: bool
+    ) -> List[Argument]:
+        """
+        Helper function used during the construction of the `__init__` and `construct` method signatures.
+
+        Returns a list of mypy Argument instances for use in the generated signatures.
+        """
+        info = self._ctx.cls.info
+        arguments = [
+            field.to_argument(info, typed=typed, force_optional=force_all_optional, use_alias=use_alias)
+            for field in fields
+            if not (use_alias and field.has_dynamic_alias)
+        ]
+        return arguments
+
+    def should_init_forbid_extra(self, fields: List['PydanticModelField'], config: 'ModelConfigData') -> bool:
+        """
+        Indicates whether the generated `__init__` should get a `**kwargs` at the end of its signature
+
+        We disallow arbitrary kwargs if the extra config setting is "forbid", or if the plugin config says to,
+        *unless* a required dynamic alias is present (since then we can't determine a valid signature).
+        """
+        if not config.allow_population_by_field_name:
+            if self.is_dynamic_alias_present(fields, bool(config.has_alias_generator)):
+                return False
+        if config.forbid_extra:
+            return True
+        return self.plugin_config.init_forbid_extra
+
+    @staticmethod
+    def is_dynamic_alias_present(fields: List['PydanticModelField'], has_alias_generator: bool) -> bool:
+        """
+        Returns whether any fields on the model have a "dynamic alias", i.e., an alias that cannot be
+        determined during static analysis.
+        """
+        for field in fields:
+            if field.has_dynamic_alias:
+                return True
+        if has_alias_generator:
+            for field in fields:
+                if field.alias is None:
+                    return True
+        return False
+
+
+class PydanticModelField:
+    def __init__(
+        self, name: str, is_required: bool, alias: Optional[str], has_dynamic_alias: bool, line: int, column: int
+    ):
+        self.name = name
+        self.is_required = is_required
+        self.alias = alias
+        self.has_dynamic_alias = has_dynamic_alias
+        self.line = line
+        self.column = column
+
+    def to_var(self, info: TypeInfo, use_alias: bool) -> Var:
+        name = self.name
+        if use_alias and self.alias is not None:
+            name = self.alias
+        return Var(name, info[self.name].type)
+
+    def to_argument(self, info: TypeInfo, typed: bool, force_optional: bool, use_alias: bool) -> Argument:
+        if typed and info[self.name].type is not None:
+            type_annotation = info[self.name].type
+        else:
+            type_annotation = AnyType(TypeOfAny.explicit)
+        return Argument(
+            variable=self.to_var(info, use_alias),
+            type_annotation=type_annotation,
+            initializer=None,
+            kind=ARG_NAMED_OPT if force_optional or not self.is_required else ARG_NAMED,
+        )
+
+    def serialize(self) -> JsonDict:
+        return self.__dict__
+
+    @classmethod
+    def deserialize(cls, info: TypeInfo, data: JsonDict) -> 'PydanticModelField':
+        return cls(**data)
+
+
+class ModelConfigData:
+    def __init__(
+        self,
+        forbid_extra: Optional[bool] = None,
+        allow_mutation: Optional[bool] = None,
+        frozen: Optional[bool] = None,
+        orm_mode: Optional[bool] = None,
+        allow_population_by_field_name: Optional[bool] = None,
+        has_alias_generator: Optional[bool] = None,
+    ):
+        self.forbid_extra = forbid_extra
+        self.allow_mutation = allow_mutation
+        self.frozen = frozen
+        self.orm_mode = orm_mode
+        self.allow_population_by_field_name = allow_population_by_field_name
+        self.has_alias_generator = has_alias_generator
+
+    def set_values_dict(self) -> Dict[str, Any]:
+        return {k: v for k, v in self.__dict__.items() if v is not None}
+
+    def update(self, config: Optional['ModelConfigData']) -> None:
+        if config is None:
+            return
+        for k, v in config.set_values_dict().items():
+            setattr(self, k, v)
+
+    def setdefault(self, key: str, value: Any) -> None:
+        if getattr(self, key) is None:
+            setattr(self, key, value)
+
+
+ERROR_ORM = ErrorCode('pydantic-orm', 'Invalid from_orm call', 'Pydantic')
+ERROR_CONFIG = ErrorCode('pydantic-config', 'Invalid config value', 'Pydantic')
+ERROR_ALIAS = ErrorCode('pydantic-alias', 'Dynamic alias disallowed', 'Pydantic')
+ERROR_UNEXPECTED = ErrorCode('pydantic-unexpected', 'Unexpected behavior', 'Pydantic')
+ERROR_UNTYPED = ErrorCode('pydantic-field', 'Untyped field disallowed', 'Pydantic')
+ERROR_FIELD_DEFAULTS = ErrorCode('pydantic-field', 'Invalid Field defaults', 'Pydantic')
+
+
+def error_from_orm(model_name: str, api: CheckerPluginInterface, context: Context) -> None:
+    api.fail(f'"{model_name}" does not have orm_mode=True', context, code=ERROR_ORM)
+
+
+def error_invalid_config_value(name: str, api: SemanticAnalyzerPluginInterface, context: Context) -> None:
+    api.fail(f'Invalid value for "Config.{name}"', context, code=ERROR_CONFIG)
+
+
+def error_required_dynamic_aliases(api: SemanticAnalyzerPluginInterface, context: Context) -> None:
+    api.fail('Required dynamic aliases disallowed', context, code=ERROR_ALIAS)
+
+
+def error_unexpected_behavior(
+    detail: str, api: Union[CheckerPluginInterface, SemanticAnalyzerPluginInterface], context: Context
+) -> None:  # pragma: no cover
+    # Can't think of a good way to test this, but I confirmed it renders as desired by adding to a non-error path
+    link = 'https://github.com/pydantic/pydantic/issues/new/choose'
+    full_message = f'The pydantic mypy plugin ran into unexpected behavior: {detail}\n'
+    full_message += f'Please consider reporting this bug at {link} so we can try to fix it!'
+    api.fail(full_message, context, code=ERROR_UNEXPECTED)
+
+
+def error_untyped_fields(api: SemanticAnalyzerPluginInterface, context: Context) -> None:
+    api.fail('Untyped fields disallowed', context, code=ERROR_UNTYPED)
+
+
+def error_default_and_default_factory_specified(api: CheckerPluginInterface, context: Context) -> None:
+    api.fail('Field default and default_factory cannot be specified together', context, code=ERROR_FIELD_DEFAULTS)
+
+
+def add_method(
+    ctx: ClassDefContext,
+    name: str,
+    args: List[Argument],
+    return_type: Type,
+    self_type: Optional[Type] = None,
+    tvar_def: Optional[TypeVarDef] = None,
+    is_classmethod: bool = False,
+    is_new: bool = False,
+    # is_staticmethod: bool = False,
+) -> None:
+    """
+    Adds a new method to a class.
+
+    This can be dropped if/when https://github.com/python/mypy/issues/7301 is merged
+    """
+    info = ctx.cls.info
+
+    # First remove any previously generated methods with the same name
+    # to avoid clashes and problems in the semantic analyzer.
+    if name in info.names:
+        sym = info.names[name]
+        if sym.plugin_generated and isinstance(sym.node, FuncDef):
+            ctx.cls.defs.body.remove(sym.node)  # pragma: no cover
+
+    self_type = self_type or fill_typevars(info)
+    if is_classmethod or is_new:
+        first = [Argument(Var('_cls'), TypeType.make_normalized(self_type), None, ARG_POS)]
+    # elif is_staticmethod:
+    #     first = []
+    else:
+        self_type = self_type or fill_typevars(info)
+        first = [Argument(Var('__pydantic_self__'), self_type, None, ARG_POS)]
+    args = first + args
+    arg_types, arg_names, arg_kinds = [], [], []
+    for arg in args:
+        assert arg.type_annotation, 'All arguments must be fully typed.'
+        arg_types.append(arg.type_annotation)
+        arg_names.append(get_name(arg.variable))
+        arg_kinds.append(arg.kind)
+
+    function_type = ctx.api.named_type(f'{BUILTINS_NAME}.function')
+    signature = CallableType(arg_types, arg_kinds, arg_names, return_type, function_type)
+    if tvar_def:
+        signature.variables = [tvar_def]
+
+    func = FuncDef(name, args, Block([PassStmt()]))
+    func.info = info
+    func.type = set_callable_name(signature, func)
+    func.is_class = is_classmethod
+    # func.is_static = is_staticmethod
+    func._fullname = get_fullname(info) + '.' + name
+    func.line = info.line
+
+    # NOTE: we would like the plugin generated node to dominate, but we still
+    # need to keep any existing definitions so they get semantically analyzed.
+    if name in info.names:
+        # Get a nice unique name instead.
+        r_name = get_unique_redefinition_name(name, info.names)
+        info.names[r_name] = info.names[name]
+
+    if is_classmethod:  # or is_staticmethod:
+        func.is_decorated = True
+        v = Var(name, func.type)
+        v.info = info
+        v._fullname = func._fullname
+        # if is_classmethod:
+        v.is_classmethod = True
+        dec = Decorator(func, [NameExpr('classmethod')], v)
+        # else:
+        #     v.is_staticmethod = True
+        #     dec = Decorator(func, [NameExpr('staticmethod')], v)
+
+        dec.line = info.line
+        sym = SymbolTableNode(MDEF, dec)
+    else:
+        sym = SymbolTableNode(MDEF, func)
+    sym.plugin_generated = True
+
+    info.names[name] = sym
+    info.defn.defs.body.append(func)
+
+
+def get_fullname(x: Union[FuncBase, SymbolNode]) -> str:
+    """
+    Used for compatibility with mypy 0.740; can be dropped once support for 0.740 is dropped.
+    """
+    fn = x.fullname
+    if callable(fn):  # pragma: no cover
+        return fn()
+    return fn
+
+
+def get_name(x: Union[FuncBase, SymbolNode]) -> str:
+    """
+    Used for compatibility with mypy 0.740; can be dropped once support for 0.740 is dropped.
+    """
+    fn = x.name
+    if callable(fn):  # pragma: no cover
+        return fn()
+    return fn
+
+
+def parse_toml(config_file: str) -> Optional[Dict[str, Any]]:
+    if not config_file.endswith('.toml'):
+        return None
+
+    read_mode = 'rb'
+    if sys.version_info >= (3, 11):
+        import tomllib as toml_
+    else:
+        try:
+            import tomli as toml_
+        except ImportError:
+            # older versions of mypy have toml as a dependency, not tomli
+            read_mode = 'r'
+            try:
+                import toml as toml_  # type: ignore[no-redef]
+            except ImportError:  # pragma: no cover
+                import warnings
+
+                warnings.warn('No TOML parser installed, cannot read configuration from `pyproject.toml`.')
+                return None
+
+    with open(config_file, read_mode) as rf:
+        return toml_.load(rf)  # type: ignore[arg-type]
diff --git a/lib/pydantic/v1/networks.py b/lib/pydantic/v1/networks.py
new file mode 100644
index 00000000..cfebe588
--- /dev/null
+++ b/lib/pydantic/v1/networks.py
@@ -0,0 +1,747 @@
+import re
+from ipaddress import (
+    IPv4Address,
+    IPv4Interface,
+    IPv4Network,
+    IPv6Address,
+    IPv6Interface,
+    IPv6Network,
+    _BaseAddress,
+    _BaseNetwork,
+)
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Collection,
+    Dict,
+    Generator,
+    List,
+    Match,
+    Optional,
+    Pattern,
+    Set,
+    Tuple,
+    Type,
+    Union,
+    cast,
+    no_type_check,
+)
+
+from . import errors
+from .utils import Representation, update_not_none
+from .validators import constr_length_validator, str_validator
+
+if TYPE_CHECKING:
+    import email_validator
+    from typing_extensions import TypedDict
+
+    from .config import BaseConfig
+    from .fields import ModelField
+    from .typing import AnyCallable
+
+    CallableGenerator = Generator[AnyCallable, None, None]
+
+    class Parts(TypedDict, total=False):
+        scheme: str
+        user: Optional[str]
+        password: Optional[str]
+        ipv4: Optional[str]
+        ipv6: Optional[str]
+        domain: Optional[str]
+        port: Optional[str]
+        path: Optional[str]
+        query: Optional[str]
+        fragment: Optional[str]
+
+    class HostParts(TypedDict, total=False):
+        host: str
+        tld: Optional[str]
+        host_type: Optional[str]
+        port: Optional[str]
+        rebuild: bool
+
+else:
+    email_validator = None
+
+    class Parts(dict):
+        pass
+
+
+NetworkType = Union[str, bytes, int, Tuple[Union[str, bytes, int], Union[str, int]]]
+
+__all__ = [
+    'AnyUrl',
+    'AnyHttpUrl',
+    'FileUrl',
+    'HttpUrl',
+    'stricturl',
+    'EmailStr',
+    'NameEmail',
+    'IPvAnyAddress',
+    'IPvAnyInterface',
+    'IPvAnyNetwork',
+    'PostgresDsn',
+    'CockroachDsn',
+    'AmqpDsn',
+    'RedisDsn',
+    'MongoDsn',
+    'KafkaDsn',
+    'validate_email',
+]
+
+_url_regex_cache = None
+_multi_host_url_regex_cache = None
+_ascii_domain_regex_cache = None
+_int_domain_regex_cache = None
+_host_regex_cache = None
+
+_host_regex = (
+    r'(?:'
+    r'(?P<ipv4>(?:\d{1,3}\.){3}\d{1,3})(?=$|[/:#?])|'  # ipv4
+    r'(?P<ipv6>\[[A-F0-9]*:[A-F0-9:]+\])(?=$|[/:#?])|'  # ipv6
+    r'(?P<domain>[^\s/:?#]+)'  # domain, validation occurs later
+    r')?'
+    r'(?::(?P<port>\d+))?'  # port
+)
+_scheme_regex = r'(?:(?P<scheme>[a-z][a-z0-9+\-.]+)://)?'  # scheme https://tools.ietf.org/html/rfc3986#appendix-A
+_user_info_regex = r'(?:(?P<user>[^\s:/]*)(?::(?P<password>[^\s/]*))?@)?'
+_path_regex = r'(?P<path>/[^\s?#]*)?'
+_query_regex = r'(?:\?(?P<query>[^\s#]*))?'
+_fragment_regex = r'(?:#(?P<fragment>[^\s#]*))?'
+
+
+def url_regex() -> Pattern[str]:
+    global _url_regex_cache
+    if _url_regex_cache is None:
+        _url_regex_cache = re.compile(
+            rf'{_scheme_regex}{_user_info_regex}{_host_regex}{_path_regex}{_query_regex}{_fragment_regex}',
+            re.IGNORECASE,
+        )
+    return _url_regex_cache
+
+
+def multi_host_url_regex() -> Pattern[str]:
+    """
+    Compiled multi host url regex.
+
+    Additionally to `url_regex` it allows to match multiple hosts.
+    E.g. host1.db.net,host2.db.net
+    """
+    global _multi_host_url_regex_cache
+    if _multi_host_url_regex_cache is None:
+        _multi_host_url_regex_cache = re.compile(
+            rf'{_scheme_regex}{_user_info_regex}'
+            r'(?P<hosts>([^/]*))'  # validation occurs later
+            rf'{_path_regex}{_query_regex}{_fragment_regex}',
+            re.IGNORECASE,
+        )
+    return _multi_host_url_regex_cache
+
+
+def ascii_domain_regex() -> Pattern[str]:
+    global _ascii_domain_regex_cache
+    if _ascii_domain_regex_cache is None:
+        ascii_chunk = r'[_0-9a-z](?:[-_0-9a-z]{0,61}[_0-9a-z])?'
+        ascii_domain_ending = r'(?P<tld>\.[a-z]{2,63})?\.?'
+        _ascii_domain_regex_cache = re.compile(
+            fr'(?:{ascii_chunk}\.)*?{ascii_chunk}{ascii_domain_ending}', re.IGNORECASE
+        )
+    return _ascii_domain_regex_cache
+
+
+def int_domain_regex() -> Pattern[str]:
+    global _int_domain_regex_cache
+    if _int_domain_regex_cache is None:
+        int_chunk = r'[_0-9a-\U00040000](?:[-_0-9a-\U00040000]{0,61}[_0-9a-\U00040000])?'
+        int_domain_ending = r'(?P<tld>(\.[^\W\d_]{2,63})|(\.(?:xn--)[_0-9a-z-]{2,63}))?\.?'
+        _int_domain_regex_cache = re.compile(fr'(?:{int_chunk}\.)*?{int_chunk}{int_domain_ending}', re.IGNORECASE)
+    return _int_domain_regex_cache
+
+
+def host_regex() -> Pattern[str]:
+    global _host_regex_cache
+    if _host_regex_cache is None:
+        _host_regex_cache = re.compile(
+            _host_regex,
+            re.IGNORECASE,
+        )
+    return _host_regex_cache
+
+
+class AnyUrl(str):
+    strip_whitespace = True
+    min_length = 1
+    max_length = 2**16
+    allowed_schemes: Optional[Collection[str]] = None
+    tld_required: bool = False
+    user_required: bool = False
+    host_required: bool = True
+    hidden_parts: Set[str] = set()
+
+    __slots__ = ('scheme', 'user', 'password', 'host', 'tld', 'host_type', 'port', 'path', 'query', 'fragment')
+
+    @no_type_check
+    def __new__(cls, url: Optional[str], **kwargs) -> object:
+        return str.__new__(cls, cls.build(**kwargs) if url is None else url)
+
+    def __init__(
+        self,
+        url: str,
+        *,
+        scheme: str,
+        user: Optional[str] = None,
+        password: Optional[str] = None,
+        host: Optional[str] = None,
+        tld: Optional[str] = None,
+        host_type: str = 'domain',
+        port: Optional[str] = None,
+        path: Optional[str] = None,
+        query: Optional[str] = None,
+        fragment: Optional[str] = None,
+    ) -> None:
+        str.__init__(url)
+        self.scheme = scheme
+        self.user = user
+        self.password = password
+        self.host = host
+        self.tld = tld
+        self.host_type = host_type
+        self.port = port
+        self.path = path
+        self.query = query
+        self.fragment = fragment
+
+    @classmethod
+    def build(
+        cls,
+        *,
+        scheme: str,
+        user: Optional[str] = None,
+        password: Optional[str] = None,
+        host: str,
+        port: Optional[str] = None,
+        path: Optional[str] = None,
+        query: Optional[str] = None,
+        fragment: Optional[str] = None,
+        **_kwargs: str,
+    ) -> str:
+        parts = Parts(
+            scheme=scheme,
+            user=user,
+            password=password,
+            host=host,
+            port=port,
+            path=path,
+            query=query,
+            fragment=fragment,
+            **_kwargs,  # type: ignore[misc]
+        )
+
+        url = scheme + '://'
+        if user:
+            url += user
+        if password:
+            url += ':' + password
+        if user or password:
+            url += '@'
+        url += host
+        if port and ('port' not in cls.hidden_parts or cls.get_default_parts(parts).get('port') != port):
+            url += ':' + port
+        if path:
+            url += path
+        if query:
+            url += '?' + query
+        if fragment:
+            url += '#' + fragment
+        return url
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        update_not_none(field_schema, minLength=cls.min_length, maxLength=cls.max_length, format='uri')
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield cls.validate
+
+    @classmethod
+    def validate(cls, value: Any, field: 'ModelField', config: 'BaseConfig') -> 'AnyUrl':
+        if value.__class__ == cls:
+            return value
+        value = str_validator(value)
+        if cls.strip_whitespace:
+            value = value.strip()
+        url: str = cast(str, constr_length_validator(value, field, config))
+
+        m = cls._match_url(url)
+        # the regex should always match, if it doesn't please report with details of the URL tried
+        assert m, 'URL regex failed unexpectedly'
+
+        original_parts = cast('Parts', m.groupdict())
+        parts = cls.apply_default_parts(original_parts)
+        parts = cls.validate_parts(parts)
+
+        if m.end() != len(url):
+            raise errors.UrlExtraError(extra=url[m.end() :])
+
+        return cls._build_url(m, url, parts)
+
+    @classmethod
+    def _build_url(cls, m: Match[str], url: str, parts: 'Parts') -> 'AnyUrl':
+        """
+        Validate hosts and build the AnyUrl object. Split from `validate` so this method
+        can be altered in `MultiHostDsn`.
+        """
+        host, tld, host_type, rebuild = cls.validate_host(parts)
+
+        return cls(
+            None if rebuild else url,
+            scheme=parts['scheme'],
+            user=parts['user'],
+            password=parts['password'],
+            host=host,
+            tld=tld,
+            host_type=host_type,
+            port=parts['port'],
+            path=parts['path'],
+            query=parts['query'],
+            fragment=parts['fragment'],
+        )
+
+    @staticmethod
+    def _match_url(url: str) -> Optional[Match[str]]:
+        return url_regex().match(url)
+
+    @staticmethod
+    def _validate_port(port: Optional[str]) -> None:
+        if port is not None and int(port) > 65_535:
+            raise errors.UrlPortError()
+
+    @classmethod
+    def validate_parts(cls, parts: 'Parts', validate_port: bool = True) -> 'Parts':
+        """
+        A method used to validate parts of a URL.
+        Could be overridden to set default values for parts if missing
+        """
+        scheme = parts['scheme']
+        if scheme is None:
+            raise errors.UrlSchemeError()
+
+        if cls.allowed_schemes and scheme.lower() not in cls.allowed_schemes:
+            raise errors.UrlSchemePermittedError(set(cls.allowed_schemes))
+
+        if validate_port:
+            cls._validate_port(parts['port'])
+
+        user = parts['user']
+        if cls.user_required and user is None:
+            raise errors.UrlUserInfoError()
+
+        return parts
+
+    @classmethod
+    def validate_host(cls, parts: 'Parts') -> Tuple[str, Optional[str], str, bool]:
+        tld, host_type, rebuild = None, None, False
+        for f in ('domain', 'ipv4', 'ipv6'):
+            host = parts[f]  # type: ignore[literal-required]
+            if host:
+                host_type = f
+                break
+
+        if host is None:
+            if cls.host_required:
+                raise errors.UrlHostError()
+        elif host_type == 'domain':
+            is_international = False
+            d = ascii_domain_regex().fullmatch(host)
+            if d is None:
+                d = int_domain_regex().fullmatch(host)
+                if d is None:
+                    raise errors.UrlHostError()
+                is_international = True
+
+            tld = d.group('tld')
+            if tld is None and not is_international:
+                d = int_domain_regex().fullmatch(host)
+                assert d is not None
+                tld = d.group('tld')
+                is_international = True
+
+            if tld is not None:
+                tld = tld[1:]
+            elif cls.tld_required:
+                raise errors.UrlHostTldError()
+
+            if is_international:
+                host_type = 'int_domain'
+                rebuild = True
+                host = host.encode('idna').decode('ascii')
+                if tld is not None:
+                    tld = tld.encode('idna').decode('ascii')
+
+        return host, tld, host_type, rebuild  # type: ignore
+
+    @staticmethod
+    def get_default_parts(parts: 'Parts') -> 'Parts':
+        return {}
+
+    @classmethod
+    def apply_default_parts(cls, parts: 'Parts') -> 'Parts':
+        for key, value in cls.get_default_parts(parts).items():
+            if not parts[key]:  # type: ignore[literal-required]
+                parts[key] = value  # type: ignore[literal-required]
+        return parts
+
+    def __repr__(self) -> str:
+        extra = ', '.join(f'{n}={getattr(self, n)!r}' for n in self.__slots__ if getattr(self, n) is not None)
+        return f'{self.__class__.__name__}({super().__repr__()}, {extra})'
+
+
+class AnyHttpUrl(AnyUrl):
+    allowed_schemes = {'http', 'https'}
+
+    __slots__ = ()
+
+
+class HttpUrl(AnyHttpUrl):
+    tld_required = True
+    # https://stackoverflow.com/questions/417142/what-is-the-maximum-length-of-a-url-in-different-browsers
+    max_length = 2083
+    hidden_parts = {'port'}
+
+    @staticmethod
+    def get_default_parts(parts: 'Parts') -> 'Parts':
+        return {'port': '80' if parts['scheme'] == 'http' else '443'}
+
+
+class FileUrl(AnyUrl):
+    allowed_schemes = {'file'}
+    host_required = False
+
+    __slots__ = ()
+
+
+class MultiHostDsn(AnyUrl):
+    __slots__ = AnyUrl.__slots__ + ('hosts',)
+
+    def __init__(self, *args: Any, hosts: Optional[List['HostParts']] = None, **kwargs: Any):
+        super().__init__(*args, **kwargs)
+        self.hosts = hosts
+
+    @staticmethod
+    def _match_url(url: str) -> Optional[Match[str]]:
+        return multi_host_url_regex().match(url)
+
+    @classmethod
+    def validate_parts(cls, parts: 'Parts', validate_port: bool = True) -> 'Parts':
+        return super().validate_parts(parts, validate_port=False)
+
+    @classmethod
+    def _build_url(cls, m: Match[str], url: str, parts: 'Parts') -> 'MultiHostDsn':
+        hosts_parts: List['HostParts'] = []
+        host_re = host_regex()
+        for host in m.groupdict()['hosts'].split(','):
+            d: Parts = host_re.match(host).groupdict()  # type: ignore
+            host, tld, host_type, rebuild = cls.validate_host(d)
+            port = d.get('port')
+            cls._validate_port(port)
+            hosts_parts.append(
+                {
+                    'host': host,
+                    'host_type': host_type,
+                    'tld': tld,
+                    'rebuild': rebuild,
+                    'port': port,
+                }
+            )
+
+        if len(hosts_parts) > 1:
+            return cls(
+                None if any([hp['rebuild'] for hp in hosts_parts]) else url,
+                scheme=parts['scheme'],
+                user=parts['user'],
+                password=parts['password'],
+                path=parts['path'],
+                query=parts['query'],
+                fragment=parts['fragment'],
+                host_type=None,
+                hosts=hosts_parts,
+            )
+        else:
+            # backwards compatibility with single host
+            host_part = hosts_parts[0]
+            return cls(
+                None if host_part['rebuild'] else url,
+                scheme=parts['scheme'],
+                user=parts['user'],
+                password=parts['password'],
+                host=host_part['host'],
+                tld=host_part['tld'],
+                host_type=host_part['host_type'],
+                port=host_part.get('port'),
+                path=parts['path'],
+                query=parts['query'],
+                fragment=parts['fragment'],
+            )
+
+
+class PostgresDsn(MultiHostDsn):
+    allowed_schemes = {
+        'postgres',
+        'postgresql',
+        'postgresql+asyncpg',
+        'postgresql+pg8000',
+        'postgresql+psycopg',
+        'postgresql+psycopg2',
+        'postgresql+psycopg2cffi',
+        'postgresql+py-postgresql',
+        'postgresql+pygresql',
+    }
+    user_required = True
+
+    __slots__ = ()
+
+
+class CockroachDsn(AnyUrl):
+    allowed_schemes = {
+        'cockroachdb',
+        'cockroachdb+psycopg2',
+        'cockroachdb+asyncpg',
+    }
+    user_required = True
+
+
+class AmqpDsn(AnyUrl):
+    allowed_schemes = {'amqp', 'amqps'}
+    host_required = False
+
+
+class RedisDsn(AnyUrl):
+    __slots__ = ()
+    allowed_schemes = {'redis', 'rediss'}
+    host_required = False
+
+    @staticmethod
+    def get_default_parts(parts: 'Parts') -> 'Parts':
+        return {
+            'domain': 'localhost' if not (parts['ipv4'] or parts['ipv6']) else '',
+            'port': '6379',
+            'path': '/0',
+        }
+
+
+class MongoDsn(AnyUrl):
+    allowed_schemes = {'mongodb'}
+
+    # TODO: Needed to generic "Parts" for "Replica Set", "Sharded Cluster", and other mongodb deployment modes
+    @staticmethod
+    def get_default_parts(parts: 'Parts') -> 'Parts':
+        return {
+            'port': '27017',
+        }
+
+
+class KafkaDsn(AnyUrl):
+    allowed_schemes = {'kafka'}
+
+    @staticmethod
+    def get_default_parts(parts: 'Parts') -> 'Parts':
+        return {
+            'domain': 'localhost',
+            'port': '9092',
+        }
+
+
+def stricturl(
+    *,
+    strip_whitespace: bool = True,
+    min_length: int = 1,
+    max_length: int = 2**16,
+    tld_required: bool = True,
+    host_required: bool = True,
+    allowed_schemes: Optional[Collection[str]] = None,
+) -> Type[AnyUrl]:
+    # use kwargs then define conf in a dict to aid with IDE type hinting
+    namespace = dict(
+        strip_whitespace=strip_whitespace,
+        min_length=min_length,
+        max_length=max_length,
+        tld_required=tld_required,
+        host_required=host_required,
+        allowed_schemes=allowed_schemes,
+    )
+    return type('UrlValue', (AnyUrl,), namespace)
+
+
+def import_email_validator() -> None:
+    global email_validator
+    try:
+        import email_validator
+    except ImportError as e:
+        raise ImportError('email-validator is not installed, run `pip install pydantic[email]`') from e
+
+
+class EmailStr(str):
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        field_schema.update(type='string', format='email')
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        # included here and below so the error happens straight away
+        import_email_validator()
+
+        yield str_validator
+        yield cls.validate
+
+    @classmethod
+    def validate(cls, value: Union[str]) -> str:
+        return validate_email(value)[1]
+
+
+class NameEmail(Representation):
+    __slots__ = 'name', 'email'
+
+    def __init__(self, name: str, email: str):
+        self.name = name
+        self.email = email
+
+    def __eq__(self, other: Any) -> bool:
+        return isinstance(other, NameEmail) and (self.name, self.email) == (other.name, other.email)
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        field_schema.update(type='string', format='name-email')
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        import_email_validator()
+
+        yield cls.validate
+
+    @classmethod
+    def validate(cls, value: Any) -> 'NameEmail':
+        if value.__class__ == cls:
+            return value
+        value = str_validator(value)
+        return cls(*validate_email(value))
+
+    def __str__(self) -> str:
+        return f'{self.name} <{self.email}>'
+
+
+class IPvAnyAddress(_BaseAddress):
+    __slots__ = ()
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        field_schema.update(type='string', format='ipvanyaddress')
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield cls.validate
+
+    @classmethod
+    def validate(cls, value: Union[str, bytes, int]) -> Union[IPv4Address, IPv6Address]:
+        try:
+            return IPv4Address(value)
+        except ValueError:
+            pass
+
+        try:
+            return IPv6Address(value)
+        except ValueError:
+            raise errors.IPvAnyAddressError()
+
+
+class IPvAnyInterface(_BaseAddress):
+    __slots__ = ()
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        field_schema.update(type='string', format='ipvanyinterface')
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield cls.validate
+
+    @classmethod
+    def validate(cls, value: NetworkType) -> Union[IPv4Interface, IPv6Interface]:
+        try:
+            return IPv4Interface(value)
+        except ValueError:
+            pass
+
+        try:
+            return IPv6Interface(value)
+        except ValueError:
+            raise errors.IPvAnyInterfaceError()
+
+
+class IPvAnyNetwork(_BaseNetwork):  # type: ignore
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        field_schema.update(type='string', format='ipvanynetwork')
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield cls.validate
+
+    @classmethod
+    def validate(cls, value: NetworkType) -> Union[IPv4Network, IPv6Network]:
+        # Assume IP Network is defined with a default value for ``strict`` argument.
+        # Define your own class if you want to specify network address check strictness.
+        try:
+            return IPv4Network(value)
+        except ValueError:
+            pass
+
+        try:
+            return IPv6Network(value)
+        except ValueError:
+            raise errors.IPvAnyNetworkError()
+
+
+pretty_email_regex = re.compile(r'([\w ]*?) *<(.*)> *')
+MAX_EMAIL_LENGTH = 2048
+"""Maximum length for an email.
+A somewhat arbitrary but very generous number compared to what is allowed by most implementations.
+"""
+
+
+def validate_email(value: Union[str]) -> Tuple[str, str]:
+    """
+    Email address validation using https://pypi.org/project/email-validator/
+    Notes:
+    * raw ip address (literal) domain parts are not allowed.
+    * "John Doe <local_part@domain.com>" style "pretty" email addresses are processed
+    * spaces are striped from the beginning and end of addresses but no error is raised
+    """
+    if email_validator is None:
+        import_email_validator()
+
+    if len(value) > MAX_EMAIL_LENGTH:
+        raise errors.EmailError()
+
+    m = pretty_email_regex.fullmatch(value)
+    name: Union[str, None] = None
+    if m:
+        name, value = m.groups()
+    email = value.strip()
+    try:
+        parts = email_validator.validate_email(email, check_deliverability=False)
+    except email_validator.EmailNotValidError as e:
+        raise errors.EmailError from e
+
+    if hasattr(parts, 'normalized'):
+        # email-validator >= 2
+        email = parts.normalized
+        assert email is not None
+        name = name or parts.local_part
+        return name, email
+    else:
+        # email-validator >1, <2
+        at_index = email.index('@')
+        local_part = email[:at_index]  # RFC 5321, local part must be case-sensitive.
+        global_part = email[at_index:].lower()
+
+        return name or local_part, local_part + global_part
diff --git a/lib/pydantic/v1/parse.py b/lib/pydantic/v1/parse.py
new file mode 100644
index 00000000..7ac330ca
--- /dev/null
+++ b/lib/pydantic/v1/parse.py
@@ -0,0 +1,66 @@
+import json
+import pickle
+from enum import Enum
+from pathlib import Path
+from typing import Any, Callable, Union
+
+from .types import StrBytes
+
+
+class Protocol(str, Enum):
+    json = 'json'
+    pickle = 'pickle'
+
+
+def load_str_bytes(
+    b: StrBytes,
+    *,
+    content_type: str = None,
+    encoding: str = 'utf8',
+    proto: Protocol = None,
+    allow_pickle: bool = False,
+    json_loads: Callable[[str], Any] = json.loads,
+) -> Any:
+    if proto is None and content_type:
+        if content_type.endswith(('json', 'javascript')):
+            pass
+        elif allow_pickle and content_type.endswith('pickle'):
+            proto = Protocol.pickle
+        else:
+            raise TypeError(f'Unknown content-type: {content_type}')
+
+    proto = proto or Protocol.json
+
+    if proto == Protocol.json:
+        if isinstance(b, bytes):
+            b = b.decode(encoding)
+        return json_loads(b)
+    elif proto == Protocol.pickle:
+        if not allow_pickle:
+            raise RuntimeError('Trying to decode with pickle with allow_pickle=False')
+        bb = b if isinstance(b, bytes) else b.encode()
+        return pickle.loads(bb)
+    else:
+        raise TypeError(f'Unknown protocol: {proto}')
+
+
+def load_file(
+    path: Union[str, Path],
+    *,
+    content_type: str = None,
+    encoding: str = 'utf8',
+    proto: Protocol = None,
+    allow_pickle: bool = False,
+    json_loads: Callable[[str], Any] = json.loads,
+) -> Any:
+    path = Path(path)
+    b = path.read_bytes()
+    if content_type is None:
+        if path.suffix in ('.js', '.json'):
+            proto = Protocol.json
+        elif path.suffix == '.pkl':
+            proto = Protocol.pickle
+
+    return load_str_bytes(
+        b, proto=proto, content_type=content_type, encoding=encoding, allow_pickle=allow_pickle, json_loads=json_loads
+    )
diff --git a/lib/pydantic/v1/py.typed b/lib/pydantic/v1/py.typed
new file mode 100644
index 00000000..e69de29b
diff --git a/lib/pydantic/v1/schema.py b/lib/pydantic/v1/schema.py
new file mode 100644
index 00000000..ea16a72a
--- /dev/null
+++ b/lib/pydantic/v1/schema.py
@@ -0,0 +1,1163 @@
+import re
+import warnings
+from collections import defaultdict
+from dataclasses import is_dataclass
+from datetime import date, datetime, time, timedelta
+from decimal import Decimal
+from enum import Enum
+from ipaddress import IPv4Address, IPv4Interface, IPv4Network, IPv6Address, IPv6Interface, IPv6Network
+from pathlib import Path
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    Dict,
+    ForwardRef,
+    FrozenSet,
+    Generic,
+    Iterable,
+    List,
+    Optional,
+    Pattern,
+    Sequence,
+    Set,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+    cast,
+)
+from uuid import UUID
+
+from typing_extensions import Annotated, Literal
+
+from .fields import (
+    MAPPING_LIKE_SHAPES,
+    SHAPE_DEQUE,
+    SHAPE_FROZENSET,
+    SHAPE_GENERIC,
+    SHAPE_ITERABLE,
+    SHAPE_LIST,
+    SHAPE_SEQUENCE,
+    SHAPE_SET,
+    SHAPE_SINGLETON,
+    SHAPE_TUPLE,
+    SHAPE_TUPLE_ELLIPSIS,
+    FieldInfo,
+    ModelField,
+)
+from .json import pydantic_encoder
+from .networks import AnyUrl, EmailStr
+from .types import (
+    ConstrainedDecimal,
+    ConstrainedFloat,
+    ConstrainedFrozenSet,
+    ConstrainedInt,
+    ConstrainedList,
+    ConstrainedSet,
+    ConstrainedStr,
+    SecretBytes,
+    SecretStr,
+    StrictBytes,
+    StrictStr,
+    conbytes,
+    condecimal,
+    confloat,
+    confrozenset,
+    conint,
+    conlist,
+    conset,
+    constr,
+)
+from .typing import (
+    all_literal_values,
+    get_args,
+    get_origin,
+    get_sub_types,
+    is_callable_type,
+    is_literal_type,
+    is_namedtuple,
+    is_none_type,
+    is_union,
+)
+from .utils import ROOT_KEY, get_model, lenient_issubclass
+
+if TYPE_CHECKING:
+    from .dataclasses import Dataclass
+    from .main import BaseModel
+
+default_prefix = '#/definitions/'
+default_ref_template = '#/definitions/{model}'
+
+TypeModelOrEnum = Union[Type['BaseModel'], Type[Enum]]
+TypeModelSet = Set[TypeModelOrEnum]
+
+
+def _apply_modify_schema(
+    modify_schema: Callable[..., None], field: Optional[ModelField], field_schema: Dict[str, Any]
+) -> None:
+    from inspect import signature
+
+    sig = signature(modify_schema)
+    args = set(sig.parameters.keys())
+    if 'field' in args or 'kwargs' in args:
+        modify_schema(field_schema, field=field)
+    else:
+        modify_schema(field_schema)
+
+
+def schema(
+    models: Sequence[Union[Type['BaseModel'], Type['Dataclass']]],
+    *,
+    by_alias: bool = True,
+    title: Optional[str] = None,
+    description: Optional[str] = None,
+    ref_prefix: Optional[str] = None,
+    ref_template: str = default_ref_template,
+) -> Dict[str, Any]:
+    """
+    Process a list of models and generate a single JSON Schema with all of them defined in the ``definitions``
+    top-level JSON key, including their sub-models.
+
+    :param models: a list of models to include in the generated JSON Schema
+    :param by_alias: generate the schemas using the aliases defined, if any
+    :param title: title for the generated schema that includes the definitions
+    :param description: description for the generated schema
+    :param ref_prefix: the JSON Pointer prefix for schema references with ``$ref``, if None, will be set to the
+      default of ``#/definitions/``. Update it if you want the schemas to reference the definitions somewhere
+      else, e.g. for OpenAPI use ``#/components/schemas/``. The resulting generated schemas will still be at the
+      top-level key ``definitions``, so you can extract them from there. But all the references will have the set
+      prefix.
+    :param ref_template: Use a ``string.format()`` template for ``$ref`` instead of a prefix. This can be useful
+      for references that cannot be represented by ``ref_prefix`` such as a definition stored in another file. For
+      a sibling json file in a ``/schemas`` directory use ``"/schemas/${model}.json#"``.
+    :return: dict with the JSON Schema with a ``definitions`` top-level key including the schema definitions for
+      the models and sub-models passed in ``models``.
+    """
+    clean_models = [get_model(model) for model in models]
+    flat_models = get_flat_models_from_models(clean_models)
+    model_name_map = get_model_name_map(flat_models)
+    definitions = {}
+    output_schema: Dict[str, Any] = {}
+    if title:
+        output_schema['title'] = title
+    if description:
+        output_schema['description'] = description
+    for model in clean_models:
+        m_schema, m_definitions, m_nested_models = model_process_schema(
+            model,
+            by_alias=by_alias,
+            model_name_map=model_name_map,
+            ref_prefix=ref_prefix,
+            ref_template=ref_template,
+        )
+        definitions.update(m_definitions)
+        model_name = model_name_map[model]
+        definitions[model_name] = m_schema
+    if definitions:
+        output_schema['definitions'] = definitions
+    return output_schema
+
+
+def model_schema(
+    model: Union[Type['BaseModel'], Type['Dataclass']],
+    by_alias: bool = True,
+    ref_prefix: Optional[str] = None,
+    ref_template: str = default_ref_template,
+) -> Dict[str, Any]:
+    """
+    Generate a JSON Schema for one model. With all the sub-models defined in the ``definitions`` top-level
+    JSON key.
+
+    :param model: a Pydantic model (a class that inherits from BaseModel)
+    :param by_alias: generate the schemas using the aliases defined, if any
+    :param ref_prefix: the JSON Pointer prefix for schema references with ``$ref``, if None, will be set to the
+      default of ``#/definitions/``. Update it if you want the schemas to reference the definitions somewhere
+      else, e.g. for OpenAPI use ``#/components/schemas/``. The resulting generated schemas will still be at the
+      top-level key ``definitions``, so you can extract them from there. But all the references will have the set
+      prefix.
+    :param ref_template: Use a ``string.format()`` template for ``$ref`` instead of a prefix. This can be useful for
+      references that cannot be represented by ``ref_prefix`` such as a definition stored in another file. For a
+      sibling json file in a ``/schemas`` directory use ``"/schemas/${model}.json#"``.
+    :return: dict with the JSON Schema for the passed ``model``
+    """
+    model = get_model(model)
+    flat_models = get_flat_models_from_model(model)
+    model_name_map = get_model_name_map(flat_models)
+    model_name = model_name_map[model]
+    m_schema, m_definitions, nested_models = model_process_schema(
+        model, by_alias=by_alias, model_name_map=model_name_map, ref_prefix=ref_prefix, ref_template=ref_template
+    )
+    if model_name in nested_models:
+        # model_name is in Nested models, it has circular references
+        m_definitions[model_name] = m_schema
+        m_schema = get_schema_ref(model_name, ref_prefix, ref_template, False)
+    if m_definitions:
+        m_schema.update({'definitions': m_definitions})
+    return m_schema
+
+
+def get_field_info_schema(field: ModelField, schema_overrides: bool = False) -> Tuple[Dict[str, Any], bool]:
+    # If no title is explicitly set, we don't set title in the schema for enums.
+    # The behaviour is the same as `BaseModel` reference, where the default title
+    # is in the definitions part of the schema.
+    schema_: Dict[str, Any] = {}
+    if field.field_info.title or not lenient_issubclass(field.type_, Enum):
+        schema_['title'] = field.field_info.title or field.alias.title().replace('_', ' ')
+
+    if field.field_info.title:
+        schema_overrides = True
+
+    if field.field_info.description:
+        schema_['description'] = field.field_info.description
+        schema_overrides = True
+
+    if not field.required and field.default is not None and not is_callable_type(field.outer_type_):
+        schema_['default'] = encode_default(field.default)
+        schema_overrides = True
+
+    return schema_, schema_overrides
+
+
+def field_schema(
+    field: ModelField,
+    *,
+    by_alias: bool = True,
+    model_name_map: Dict[TypeModelOrEnum, str],
+    ref_prefix: Optional[str] = None,
+    ref_template: str = default_ref_template,
+    known_models: Optional[TypeModelSet] = None,
+) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]:
+    """
+    Process a Pydantic field and return a tuple with a JSON Schema for it as the first item.
+    Also return a dictionary of definitions with models as keys and their schemas as values. If the passed field
+    is a model and has sub-models, and those sub-models don't have overrides (as ``title``, ``default``, etc), they
+    will be included in the definitions and referenced in the schema instead of included recursively.
+
+    :param field: a Pydantic ``ModelField``
+    :param by_alias: use the defined alias (if any) in the returned schema
+    :param model_name_map: used to generate the JSON Schema references to other models included in the definitions
+    :param ref_prefix: the JSON Pointer prefix to use for references to other schemas, if None, the default of
+      #/definitions/ will be used
+    :param ref_template: Use a ``string.format()`` template for ``$ref`` instead of a prefix. This can be useful for
+      references that cannot be represented by ``ref_prefix`` such as a definition stored in another file. For a
+      sibling json file in a ``/schemas`` directory use ``"/schemas/${model}.json#"``.
+    :param known_models: used to solve circular references
+    :return: tuple of the schema for this field and additional definitions
+    """
+    s, schema_overrides = get_field_info_schema(field)
+
+    validation_schema = get_field_schema_validations(field)
+    if validation_schema:
+        s.update(validation_schema)
+        schema_overrides = True
+
+    f_schema, f_definitions, f_nested_models = field_type_schema(
+        field,
+        by_alias=by_alias,
+        model_name_map=model_name_map,
+        schema_overrides=schema_overrides,
+        ref_prefix=ref_prefix,
+        ref_template=ref_template,
+        known_models=known_models or set(),
+    )
+
+    # $ref will only be returned when there are no schema_overrides
+    if '$ref' in f_schema:
+        return f_schema, f_definitions, f_nested_models
+    else:
+        s.update(f_schema)
+        return s, f_definitions, f_nested_models
+
+
+numeric_types = (int, float, Decimal)
+_str_types_attrs: Tuple[Tuple[str, Union[type, Tuple[type, ...]], str], ...] = (
+    ('max_length', numeric_types, 'maxLength'),
+    ('min_length', numeric_types, 'minLength'),
+    ('regex', str, 'pattern'),
+)
+
+_numeric_types_attrs: Tuple[Tuple[str, Union[type, Tuple[type, ...]], str], ...] = (
+    ('gt', numeric_types, 'exclusiveMinimum'),
+    ('lt', numeric_types, 'exclusiveMaximum'),
+    ('ge', numeric_types, 'minimum'),
+    ('le', numeric_types, 'maximum'),
+    ('multiple_of', numeric_types, 'multipleOf'),
+)
+
+
+def get_field_schema_validations(field: ModelField) -> Dict[str, Any]:
+    """
+    Get the JSON Schema validation keywords for a ``field`` with an annotation of
+    a Pydantic ``FieldInfo`` with validation arguments.
+    """
+    f_schema: Dict[str, Any] = {}
+
+    if lenient_issubclass(field.type_, Enum):
+        # schema is already updated by `enum_process_schema`; just update with field extra
+        if field.field_info.extra:
+            f_schema.update(field.field_info.extra)
+        return f_schema
+
+    if lenient_issubclass(field.type_, (str, bytes)):
+        for attr_name, t, keyword in _str_types_attrs:
+            attr = getattr(field.field_info, attr_name, None)
+            if isinstance(attr, t):
+                f_schema[keyword] = attr
+    if lenient_issubclass(field.type_, numeric_types) and not issubclass(field.type_, bool):
+        for attr_name, t, keyword in _numeric_types_attrs:
+            attr = getattr(field.field_info, attr_name, None)
+            if isinstance(attr, t):
+                f_schema[keyword] = attr
+    if field.field_info is not None and field.field_info.const:
+        f_schema['const'] = field.default
+    if field.field_info.extra:
+        f_schema.update(field.field_info.extra)
+    modify_schema = getattr(field.outer_type_, '__modify_schema__', None)
+    if modify_schema:
+        _apply_modify_schema(modify_schema, field, f_schema)
+    return f_schema
+
+
+def get_model_name_map(unique_models: TypeModelSet) -> Dict[TypeModelOrEnum, str]:
+    """
+    Process a set of models and generate unique names for them to be used as keys in the JSON Schema
+    definitions. By default the names are the same as the class name. But if two models in different Python
+    modules have the same name (e.g. "users.Model" and "items.Model"), the generated names will be
+    based on the Python module path for those conflicting models to prevent name collisions.
+
+    :param unique_models: a Python set of models
+    :return: dict mapping models to names
+    """
+    name_model_map = {}
+    conflicting_names: Set[str] = set()
+    for model in unique_models:
+        model_name = normalize_name(model.__name__)
+        if model_name in conflicting_names:
+            model_name = get_long_model_name(model)
+            name_model_map[model_name] = model
+        elif model_name in name_model_map:
+            conflicting_names.add(model_name)
+            conflicting_model = name_model_map.pop(model_name)
+            name_model_map[get_long_model_name(conflicting_model)] = conflicting_model
+            name_model_map[get_long_model_name(model)] = model
+        else:
+            name_model_map[model_name] = model
+    return {v: k for k, v in name_model_map.items()}
+
+
+def get_flat_models_from_model(model: Type['BaseModel'], known_models: Optional[TypeModelSet] = None) -> TypeModelSet:
+    """
+    Take a single ``model`` and generate a set with itself and all the sub-models in the tree. I.e. if you pass
+    model ``Foo`` (subclass of Pydantic ``BaseModel``) as ``model``, and it has a field of type ``Bar`` (also
+    subclass of ``BaseModel``) and that model ``Bar`` has a field of type ``Baz`` (also subclass of ``BaseModel``),
+    the return value will be ``set([Foo, Bar, Baz])``.
+
+    :param model: a Pydantic ``BaseModel`` subclass
+    :param known_models: used to solve circular references
+    :return: a set with the initial model and all its sub-models
+    """
+    known_models = known_models or set()
+    flat_models: TypeModelSet = set()
+    flat_models.add(model)
+    known_models |= flat_models
+    fields = cast(Sequence[ModelField], model.__fields__.values())
+    flat_models |= get_flat_models_from_fields(fields, known_models=known_models)
+    return flat_models
+
+
+def get_flat_models_from_field(field: ModelField, known_models: TypeModelSet) -> TypeModelSet:
+    """
+    Take a single Pydantic ``ModelField`` (from a model) that could have been declared as a subclass of BaseModel
+    (so, it could be a submodel), and generate a set with its model and all the sub-models in the tree.
+    I.e. if you pass a field that was declared to be of type ``Foo`` (subclass of BaseModel) as ``field``, and that
+    model ``Foo`` has a field of type ``Bar`` (also subclass of ``BaseModel``) and that model ``Bar`` has a field of
+    type ``Baz`` (also subclass of ``BaseModel``), the return value will be ``set([Foo, Bar, Baz])``.
+
+    :param field: a Pydantic ``ModelField``
+    :param known_models: used to solve circular references
+    :return: a set with the model used in the declaration for this field, if any, and all its sub-models
+    """
+    from .main import BaseModel
+
+    flat_models: TypeModelSet = set()
+
+    field_type = field.type_
+    if lenient_issubclass(getattr(field_type, '__pydantic_model__', None), BaseModel):
+        field_type = field_type.__pydantic_model__
+
+    if field.sub_fields and not lenient_issubclass(field_type, BaseModel):
+        flat_models |= get_flat_models_from_fields(field.sub_fields, known_models=known_models)
+    elif lenient_issubclass(field_type, BaseModel) and field_type not in known_models:
+        flat_models |= get_flat_models_from_model(field_type, known_models=known_models)
+    elif lenient_issubclass(field_type, Enum):
+        flat_models.add(field_type)
+    return flat_models
+
+
+def get_flat_models_from_fields(fields: Sequence[ModelField], known_models: TypeModelSet) -> TypeModelSet:
+    """
+    Take a list of Pydantic  ``ModelField``s (from a model) that could have been declared as subclasses of ``BaseModel``
+    (so, any of them could be a submodel), and generate a set with their models and all the sub-models in the tree.
+    I.e. if you pass a the fields of a model ``Foo`` (subclass of ``BaseModel``) as ``fields``, and on of them has a
+    field of type ``Bar`` (also subclass of ``BaseModel``) and that model ``Bar`` has a field of type ``Baz`` (also
+    subclass of ``BaseModel``), the return value will be ``set([Foo, Bar, Baz])``.
+
+    :param fields: a list of Pydantic ``ModelField``s
+    :param known_models: used to solve circular references
+    :return: a set with any model declared in the fields, and all their sub-models
+    """
+    flat_models: TypeModelSet = set()
+    for field in fields:
+        flat_models |= get_flat_models_from_field(field, known_models=known_models)
+    return flat_models
+
+
+def get_flat_models_from_models(models: Sequence[Type['BaseModel']]) -> TypeModelSet:
+    """
+    Take a list of ``models`` and generate a set with them and all their sub-models in their trees. I.e. if you pass
+    a list of two models, ``Foo`` and ``Bar``, both subclasses of Pydantic ``BaseModel`` as models, and ``Bar`` has
+    a field of type ``Baz`` (also subclass of ``BaseModel``), the return value will be ``set([Foo, Bar, Baz])``.
+    """
+    flat_models: TypeModelSet = set()
+    for model in models:
+        flat_models |= get_flat_models_from_model(model)
+    return flat_models
+
+
+def get_long_model_name(model: TypeModelOrEnum) -> str:
+    return f'{model.__module__}__{model.__qualname__}'.replace('.', '__')
+
+
+def field_type_schema(
+    field: ModelField,
+    *,
+    by_alias: bool,
+    model_name_map: Dict[TypeModelOrEnum, str],
+    ref_template: str,
+    schema_overrides: bool = False,
+    ref_prefix: Optional[str] = None,
+    known_models: TypeModelSet,
+) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]:
+    """
+    Used by ``field_schema()``, you probably should be using that function.
+
+    Take a single ``field`` and generate the schema for its type only, not including additional
+    information as title, etc. Also return additional schema definitions, from sub-models.
+    """
+    from .main import BaseModel  # noqa: F811
+
+    definitions = {}
+    nested_models: Set[str] = set()
+    f_schema: Dict[str, Any]
+    if field.shape in {
+        SHAPE_LIST,
+        SHAPE_TUPLE_ELLIPSIS,
+        SHAPE_SEQUENCE,
+        SHAPE_SET,
+        SHAPE_FROZENSET,
+        SHAPE_ITERABLE,
+        SHAPE_DEQUE,
+    }:
+        items_schema, f_definitions, f_nested_models = field_singleton_schema(
+            field,
+            by_alias=by_alias,
+            model_name_map=model_name_map,
+            ref_prefix=ref_prefix,
+            ref_template=ref_template,
+            known_models=known_models,
+        )
+        definitions.update(f_definitions)
+        nested_models.update(f_nested_models)
+        f_schema = {'type': 'array', 'items': items_schema}
+        if field.shape in {SHAPE_SET, SHAPE_FROZENSET}:
+            f_schema['uniqueItems'] = True
+
+    elif field.shape in MAPPING_LIKE_SHAPES:
+        f_schema = {'type': 'object'}
+        key_field = cast(ModelField, field.key_field)
+        regex = getattr(key_field.type_, 'regex', None)
+        items_schema, f_definitions, f_nested_models = field_singleton_schema(
+            field,
+            by_alias=by_alias,
+            model_name_map=model_name_map,
+            ref_prefix=ref_prefix,
+            ref_template=ref_template,
+            known_models=known_models,
+        )
+        definitions.update(f_definitions)
+        nested_models.update(f_nested_models)
+        if regex:
+            # Dict keys have a regex pattern
+            # items_schema might be a schema or empty dict, add it either way
+            f_schema['patternProperties'] = {ConstrainedStr._get_pattern(regex): items_schema}
+        if items_schema:
+            # The dict values are not simply Any, so they need a schema
+            f_schema['additionalProperties'] = items_schema
+    elif field.shape == SHAPE_TUPLE or (field.shape == SHAPE_GENERIC and not issubclass(field.type_, BaseModel)):
+        sub_schema = []
+        sub_fields = cast(List[ModelField], field.sub_fields)
+        for sf in sub_fields:
+            sf_schema, sf_definitions, sf_nested_models = field_type_schema(
+                sf,
+                by_alias=by_alias,
+                model_name_map=model_name_map,
+                ref_prefix=ref_prefix,
+                ref_template=ref_template,
+                known_models=known_models,
+            )
+            definitions.update(sf_definitions)
+            nested_models.update(sf_nested_models)
+            sub_schema.append(sf_schema)
+
+        sub_fields_len = len(sub_fields)
+        if field.shape == SHAPE_GENERIC:
+            all_of_schemas = sub_schema[0] if sub_fields_len == 1 else {'type': 'array', 'items': sub_schema}
+            f_schema = {'allOf': [all_of_schemas]}
+        else:
+            f_schema = {
+                'type': 'array',
+                'minItems': sub_fields_len,
+                'maxItems': sub_fields_len,
+            }
+            if sub_fields_len >= 1:
+                f_schema['items'] = sub_schema
+    else:
+        assert field.shape in {SHAPE_SINGLETON, SHAPE_GENERIC}, field.shape
+        f_schema, f_definitions, f_nested_models = field_singleton_schema(
+            field,
+            by_alias=by_alias,
+            model_name_map=model_name_map,
+            schema_overrides=schema_overrides,
+            ref_prefix=ref_prefix,
+            ref_template=ref_template,
+            known_models=known_models,
+        )
+        definitions.update(f_definitions)
+        nested_models.update(f_nested_models)
+
+    # check field type to avoid repeated calls to the same __modify_schema__ method
+    if field.type_ != field.outer_type_:
+        if field.shape == SHAPE_GENERIC:
+            field_type = field.type_
+        else:
+            field_type = field.outer_type_
+        modify_schema = getattr(field_type, '__modify_schema__', None)
+        if modify_schema:
+            _apply_modify_schema(modify_schema, field, f_schema)
+    return f_schema, definitions, nested_models
+
+
+def model_process_schema(
+    model: TypeModelOrEnum,
+    *,
+    by_alias: bool = True,
+    model_name_map: Dict[TypeModelOrEnum, str],
+    ref_prefix: Optional[str] = None,
+    ref_template: str = default_ref_template,
+    known_models: Optional[TypeModelSet] = None,
+    field: Optional[ModelField] = None,
+) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]:
+    """
+    Used by ``model_schema()``, you probably should be using that function.
+
+    Take a single ``model`` and generate its schema. Also return additional schema definitions, from sub-models. The
+    sub-models of the returned schema will be referenced, but their definitions will not be included in the schema. All
+    the definitions are returned as the second value.
+    """
+    from inspect import getdoc, signature
+
+    known_models = known_models or set()
+    if lenient_issubclass(model, Enum):
+        model = cast(Type[Enum], model)
+        s = enum_process_schema(model, field=field)
+        return s, {}, set()
+    model = cast(Type['BaseModel'], model)
+    s = {'title': model.__config__.title or model.__name__}
+    doc = getdoc(model)
+    if doc:
+        s['description'] = doc
+    known_models.add(model)
+    m_schema, m_definitions, nested_models = model_type_schema(
+        model,
+        by_alias=by_alias,
+        model_name_map=model_name_map,
+        ref_prefix=ref_prefix,
+        ref_template=ref_template,
+        known_models=known_models,
+    )
+    s.update(m_schema)
+    schema_extra = model.__config__.schema_extra
+    if callable(schema_extra):
+        if len(signature(schema_extra).parameters) == 1:
+            schema_extra(s)
+        else:
+            schema_extra(s, model)
+    else:
+        s.update(schema_extra)
+    return s, m_definitions, nested_models
+
+
+def model_type_schema(
+    model: Type['BaseModel'],
+    *,
+    by_alias: bool,
+    model_name_map: Dict[TypeModelOrEnum, str],
+    ref_template: str,
+    ref_prefix: Optional[str] = None,
+    known_models: TypeModelSet,
+) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]:
+    """
+    You probably should be using ``model_schema()``, this function is indirectly used by that function.
+
+    Take a single ``model`` and generate the schema for its type only, not including additional
+    information as title, etc. Also return additional schema definitions, from sub-models.
+    """
+    properties = {}
+    required = []
+    definitions: Dict[str, Any] = {}
+    nested_models: Set[str] = set()
+    for k, f in model.__fields__.items():
+        try:
+            f_schema, f_definitions, f_nested_models = field_schema(
+                f,
+                by_alias=by_alias,
+                model_name_map=model_name_map,
+                ref_prefix=ref_prefix,
+                ref_template=ref_template,
+                known_models=known_models,
+            )
+        except SkipField as skip:
+            warnings.warn(skip.message, UserWarning)
+            continue
+        definitions.update(f_definitions)
+        nested_models.update(f_nested_models)
+        if by_alias:
+            properties[f.alias] = f_schema
+            if f.required:
+                required.append(f.alias)
+        else:
+            properties[k] = f_schema
+            if f.required:
+                required.append(k)
+    if ROOT_KEY in properties:
+        out_schema = properties[ROOT_KEY]
+        out_schema['title'] = model.__config__.title or model.__name__
+    else:
+        out_schema = {'type': 'object', 'properties': properties}
+        if required:
+            out_schema['required'] = required
+    if model.__config__.extra == 'forbid':
+        out_schema['additionalProperties'] = False
+    return out_schema, definitions, nested_models
+
+
+def enum_process_schema(enum: Type[Enum], *, field: Optional[ModelField] = None) -> Dict[str, Any]:
+    """
+    Take a single `enum` and generate its schema.
+
+    This is similar to the `model_process_schema` function, but applies to ``Enum`` objects.
+    """
+    import inspect
+
+    schema_: Dict[str, Any] = {
+        'title': enum.__name__,
+        # Python assigns all enums a default docstring value of 'An enumeration', so
+        # all enums will have a description field even if not explicitly provided.
+        'description': inspect.cleandoc(enum.__doc__ or 'An enumeration.'),
+        # Add enum values and the enum field type to the schema.
+        'enum': [item.value for item in cast(Iterable[Enum], enum)],
+    }
+
+    add_field_type_to_schema(enum, schema_)
+
+    modify_schema = getattr(enum, '__modify_schema__', None)
+    if modify_schema:
+        _apply_modify_schema(modify_schema, field, schema_)
+
+    return schema_
+
+
+def field_singleton_sub_fields_schema(
+    field: ModelField,
+    *,
+    by_alias: bool,
+    model_name_map: Dict[TypeModelOrEnum, str],
+    ref_template: str,
+    schema_overrides: bool = False,
+    ref_prefix: Optional[str] = None,
+    known_models: TypeModelSet,
+) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]:
+    """
+    This function is indirectly used by ``field_schema()``, you probably should be using that function.
+
+    Take a list of Pydantic ``ModelField`` from the declaration of a type with parameters, and generate their
+    schema. I.e., fields used as "type parameters", like ``str`` and ``int`` in ``Tuple[str, int]``.
+    """
+    sub_fields = cast(List[ModelField], field.sub_fields)
+    definitions = {}
+    nested_models: Set[str] = set()
+    if len(sub_fields) == 1:
+        return field_type_schema(
+            sub_fields[0],
+            by_alias=by_alias,
+            model_name_map=model_name_map,
+            schema_overrides=schema_overrides,
+            ref_prefix=ref_prefix,
+            ref_template=ref_template,
+            known_models=known_models,
+        )
+    else:
+        s: Dict[str, Any] = {}
+        # https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#discriminator-object
+        field_has_discriminator: bool = field.discriminator_key is not None
+        if field_has_discriminator:
+            assert field.sub_fields_mapping is not None
+
+            discriminator_models_refs: Dict[str, Union[str, Dict[str, Any]]] = {}
+
+            for discriminator_value, sub_field in field.sub_fields_mapping.items():
+                if isinstance(discriminator_value, Enum):
+                    discriminator_value = str(discriminator_value.value)
+                # sub_field is either a `BaseModel` or directly an `Annotated` `Union` of many
+                if is_union(get_origin(sub_field.type_)):
+                    sub_models = get_sub_types(sub_field.type_)
+                    discriminator_models_refs[discriminator_value] = {
+                        model_name_map[sub_model]: get_schema_ref(
+                            model_name_map[sub_model], ref_prefix, ref_template, False
+                        )
+                        for sub_model in sub_models
+                    }
+                else:
+                    sub_field_type = sub_field.type_
+                    if hasattr(sub_field_type, '__pydantic_model__'):
+                        sub_field_type = sub_field_type.__pydantic_model__
+
+                    discriminator_model_name = model_name_map[sub_field_type]
+                    discriminator_model_ref = get_schema_ref(discriminator_model_name, ref_prefix, ref_template, False)
+                    discriminator_models_refs[discriminator_value] = discriminator_model_ref['$ref']
+
+            s['discriminator'] = {
+                'propertyName': field.discriminator_alias,
+                'mapping': discriminator_models_refs,
+            }
+
+        sub_field_schemas = []
+        for sf in sub_fields:
+            sub_schema, sub_definitions, sub_nested_models = field_type_schema(
+                sf,
+                by_alias=by_alias,
+                model_name_map=model_name_map,
+                schema_overrides=schema_overrides,
+                ref_prefix=ref_prefix,
+                ref_template=ref_template,
+                known_models=known_models,
+            )
+            definitions.update(sub_definitions)
+            if schema_overrides and 'allOf' in sub_schema:
+                # if the sub_field is a referenced schema we only need the referenced
+                # object. Otherwise we will end up with several allOf inside anyOf/oneOf.
+                # See https://github.com/pydantic/pydantic/issues/1209
+                sub_schema = sub_schema['allOf'][0]
+
+            if sub_schema.keys() == {'discriminator', 'oneOf'}:
+                # we don't want discriminator information inside oneOf choices, this is dealt with elsewhere
+                sub_schema.pop('discriminator')
+            sub_field_schemas.append(sub_schema)
+            nested_models.update(sub_nested_models)
+        s['oneOf' if field_has_discriminator else 'anyOf'] = sub_field_schemas
+        return s, definitions, nested_models
+
+
+# Order is important, e.g. subclasses of str must go before str
+# this is used only for standard library types, custom types should use __modify_schema__ instead
+field_class_to_schema: Tuple[Tuple[Any, Dict[str, Any]], ...] = (
+    (Path, {'type': 'string', 'format': 'path'}),
+    (datetime, {'type': 'string', 'format': 'date-time'}),
+    (date, {'type': 'string', 'format': 'date'}),
+    (time, {'type': 'string', 'format': 'time'}),
+    (timedelta, {'type': 'number', 'format': 'time-delta'}),
+    (IPv4Network, {'type': 'string', 'format': 'ipv4network'}),
+    (IPv6Network, {'type': 'string', 'format': 'ipv6network'}),
+    (IPv4Interface, {'type': 'string', 'format': 'ipv4interface'}),
+    (IPv6Interface, {'type': 'string', 'format': 'ipv6interface'}),
+    (IPv4Address, {'type': 'string', 'format': 'ipv4'}),
+    (IPv6Address, {'type': 'string', 'format': 'ipv6'}),
+    (Pattern, {'type': 'string', 'format': 'regex'}),
+    (str, {'type': 'string'}),
+    (bytes, {'type': 'string', 'format': 'binary'}),
+    (bool, {'type': 'boolean'}),
+    (int, {'type': 'integer'}),
+    (float, {'type': 'number'}),
+    (Decimal, {'type': 'number'}),
+    (UUID, {'type': 'string', 'format': 'uuid'}),
+    (dict, {'type': 'object'}),
+    (list, {'type': 'array', 'items': {}}),
+    (tuple, {'type': 'array', 'items': {}}),
+    (set, {'type': 'array', 'items': {}, 'uniqueItems': True}),
+    (frozenset, {'type': 'array', 'items': {}, 'uniqueItems': True}),
+)
+
+json_scheme = {'type': 'string', 'format': 'json-string'}
+
+
+def add_field_type_to_schema(field_type: Any, schema_: Dict[str, Any]) -> None:
+    """
+    Update the given `schema` with the type-specific metadata for the given `field_type`.
+
+    This function looks through `field_class_to_schema` for a class that matches the given `field_type`,
+    and then modifies the given `schema` with the information from that type.
+    """
+    for type_, t_schema in field_class_to_schema:
+        # Fallback for `typing.Pattern` and `re.Pattern` as they are not a valid class
+        if lenient_issubclass(field_type, type_) or field_type is type_ is Pattern:
+            schema_.update(t_schema)
+            break
+
+
+def get_schema_ref(name: str, ref_prefix: Optional[str], ref_template: str, schema_overrides: bool) -> Dict[str, Any]:
+    if ref_prefix:
+        schema_ref = {'$ref': ref_prefix + name}
+    else:
+        schema_ref = {'$ref': ref_template.format(model=name)}
+    return {'allOf': [schema_ref]} if schema_overrides else schema_ref
+
+
+def field_singleton_schema(  # noqa: C901 (ignore complexity)
+    field: ModelField,
+    *,
+    by_alias: bool,
+    model_name_map: Dict[TypeModelOrEnum, str],
+    ref_template: str,
+    schema_overrides: bool = False,
+    ref_prefix: Optional[str] = None,
+    known_models: TypeModelSet,
+) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]:
+    """
+    This function is indirectly used by ``field_schema()``, you should probably be using that function.
+
+    Take a single Pydantic ``ModelField``, and return its schema and any additional definitions from sub-models.
+    """
+    from .main import BaseModel
+
+    definitions: Dict[str, Any] = {}
+    nested_models: Set[str] = set()
+    field_type = field.type_
+
+    # Recurse into this field if it contains sub_fields and is NOT a
+    # BaseModel OR that BaseModel is a const
+    if field.sub_fields and (
+        (field.field_info and field.field_info.const) or not lenient_issubclass(field_type, BaseModel)
+    ):
+        return field_singleton_sub_fields_schema(
+            field,
+            by_alias=by_alias,
+            model_name_map=model_name_map,
+            schema_overrides=schema_overrides,
+            ref_prefix=ref_prefix,
+            ref_template=ref_template,
+            known_models=known_models,
+        )
+    if field_type is Any or field_type is object or field_type.__class__ == TypeVar or get_origin(field_type) is type:
+        return {}, definitions, nested_models  # no restrictions
+    if is_none_type(field_type):
+        return {'type': 'null'}, definitions, nested_models
+    if is_callable_type(field_type):
+        raise SkipField(f'Callable {field.name} was excluded from schema since JSON schema has no equivalent type.')
+    f_schema: Dict[str, Any] = {}
+    if field.field_info is not None and field.field_info.const:
+        f_schema['const'] = field.default
+
+    if is_literal_type(field_type):
+        values = tuple(x.value if isinstance(x, Enum) else x for x in all_literal_values(field_type))
+
+        if len({v.__class__ for v in values}) > 1:
+            return field_schema(
+                multitypes_literal_field_for_schema(values, field),
+                by_alias=by_alias,
+                model_name_map=model_name_map,
+                ref_prefix=ref_prefix,
+                ref_template=ref_template,
+                known_models=known_models,
+            )
+
+        # All values have the same type
+        field_type = values[0].__class__
+        f_schema['enum'] = list(values)
+        add_field_type_to_schema(field_type, f_schema)
+    elif lenient_issubclass(field_type, Enum):
+        enum_name = model_name_map[field_type]
+        f_schema, schema_overrides = get_field_info_schema(field, schema_overrides)
+        f_schema.update(get_schema_ref(enum_name, ref_prefix, ref_template, schema_overrides))
+        definitions[enum_name] = enum_process_schema(field_type, field=field)
+    elif is_namedtuple(field_type):
+        sub_schema, *_ = model_process_schema(
+            field_type.__pydantic_model__,
+            by_alias=by_alias,
+            model_name_map=model_name_map,
+            ref_prefix=ref_prefix,
+            ref_template=ref_template,
+            known_models=known_models,
+            field=field,
+        )
+        items_schemas = list(sub_schema['properties'].values())
+        f_schema.update(
+            {
+                'type': 'array',
+                'items': items_schemas,
+                'minItems': len(items_schemas),
+                'maxItems': len(items_schemas),
+            }
+        )
+    elif not hasattr(field_type, '__pydantic_model__'):
+        add_field_type_to_schema(field_type, f_schema)
+
+        modify_schema = getattr(field_type, '__modify_schema__', None)
+        if modify_schema:
+            _apply_modify_schema(modify_schema, field, f_schema)
+
+    if f_schema:
+        return f_schema, definitions, nested_models
+
+    # Handle dataclass-based models
+    if lenient_issubclass(getattr(field_type, '__pydantic_model__', None), BaseModel):
+        field_type = field_type.__pydantic_model__
+
+    if issubclass(field_type, BaseModel):
+        model_name = model_name_map[field_type]
+        if field_type not in known_models:
+            sub_schema, sub_definitions, sub_nested_models = model_process_schema(
+                field_type,
+                by_alias=by_alias,
+                model_name_map=model_name_map,
+                ref_prefix=ref_prefix,
+                ref_template=ref_template,
+                known_models=known_models,
+                field=field,
+            )
+            definitions.update(sub_definitions)
+            definitions[model_name] = sub_schema
+            nested_models.update(sub_nested_models)
+        else:
+            nested_models.add(model_name)
+        schema_ref = get_schema_ref(model_name, ref_prefix, ref_template, schema_overrides)
+        return schema_ref, definitions, nested_models
+
+    # For generics with no args
+    args = get_args(field_type)
+    if args is not None and not args and Generic in field_type.__bases__:
+        return f_schema, definitions, nested_models
+
+    raise ValueError(f'Value not declarable with JSON Schema, field: {field}')
+
+
+def multitypes_literal_field_for_schema(values: Tuple[Any, ...], field: ModelField) -> ModelField:
+    """
+    To support `Literal` with values of different types, we split it into multiple `Literal` with same type
+    e.g. `Literal['qwe', 'asd', 1, 2]` becomes `Union[Literal['qwe', 'asd'], Literal[1, 2]]`
+    """
+    literal_distinct_types = defaultdict(list)
+    for v in values:
+        literal_distinct_types[v.__class__].append(v)
+    distinct_literals = (Literal[tuple(same_type_values)] for same_type_values in literal_distinct_types.values())
+
+    return ModelField(
+        name=field.name,
+        type_=Union[tuple(distinct_literals)],  # type: ignore
+        class_validators=field.class_validators,
+        model_config=field.model_config,
+        default=field.default,
+        required=field.required,
+        alias=field.alias,
+        field_info=field.field_info,
+    )
+
+
+def encode_default(dft: Any) -> Any:
+    from .main import BaseModel
+
+    if isinstance(dft, BaseModel) or is_dataclass(dft):
+        dft = cast('dict[str, Any]', pydantic_encoder(dft))
+
+    if isinstance(dft, dict):
+        return {encode_default(k): encode_default(v) for k, v in dft.items()}
+    elif isinstance(dft, Enum):
+        return dft.value
+    elif isinstance(dft, (int, float, str)):
+        return dft
+    elif isinstance(dft, (list, tuple)):
+        t = dft.__class__
+        seq_args = (encode_default(v) for v in dft)
+        return t(*seq_args) if is_namedtuple(t) else t(seq_args)
+    elif dft is None:
+        return None
+    else:
+        return pydantic_encoder(dft)
+
+
+_map_types_constraint: Dict[Any, Callable[..., type]] = {int: conint, float: confloat, Decimal: condecimal}
+
+
+def get_annotation_from_field_info(
+    annotation: Any, field_info: FieldInfo, field_name: str, validate_assignment: bool = False
+) -> Type[Any]:
+    """
+    Get an annotation with validation implemented for numbers and strings based on the field_info.
+    :param annotation: an annotation from a field specification, as ``str``, ``ConstrainedStr``
+    :param field_info: an instance of FieldInfo, possibly with declarations for validations and JSON Schema
+    :param field_name: name of the field for use in error messages
+    :param validate_assignment: default False, flag for BaseModel Config value of validate_assignment
+    :return: the same ``annotation`` if unmodified or a new annotation with validation in place
+    """
+    constraints = field_info.get_constraints()
+    used_constraints: Set[str] = set()
+    if constraints:
+        annotation, used_constraints = get_annotation_with_constraints(annotation, field_info)
+    if validate_assignment:
+        used_constraints.add('allow_mutation')
+
+    unused_constraints = constraints - used_constraints
+    if unused_constraints:
+        raise ValueError(
+            f'On field "{field_name}" the following field constraints are set but not enforced: '
+            f'{", ".join(unused_constraints)}. '
+            f'\nFor more details see https://docs.pydantic.dev/usage/schema/#unenforced-field-constraints'
+        )
+
+    return annotation
+
+
+def get_annotation_with_constraints(annotation: Any, field_info: FieldInfo) -> Tuple[Type[Any], Set[str]]:  # noqa: C901
+    """
+    Get an annotation with used constraints implemented for numbers and strings based on the field_info.
+
+    :param annotation: an annotation from a field specification, as ``str``, ``ConstrainedStr``
+    :param field_info: an instance of FieldInfo, possibly with declarations for validations and JSON Schema
+    :return: the same ``annotation`` if unmodified or a new annotation along with the used constraints.
+    """
+    used_constraints: Set[str] = set()
+
+    def go(type_: Any) -> Type[Any]:
+        if (
+            is_literal_type(type_)
+            or isinstance(type_, ForwardRef)
+            or lenient_issubclass(type_, (ConstrainedList, ConstrainedSet, ConstrainedFrozenSet))
+        ):
+            return type_
+        origin = get_origin(type_)
+        if origin is not None:
+            args: Tuple[Any, ...] = get_args(type_)
+            if any(isinstance(a, ForwardRef) for a in args):
+                # forward refs cause infinite recursion below
+                return type_
+
+            if origin is Annotated:
+                return go(args[0])
+            if is_union(origin):
+                return Union[tuple(go(a) for a in args)]  # type: ignore
+
+            if issubclass(origin, List) and (
+                field_info.min_items is not None
+                or field_info.max_items is not None
+                or field_info.unique_items is not None
+            ):
+                used_constraints.update({'min_items', 'max_items', 'unique_items'})
+                return conlist(
+                    go(args[0]),
+                    min_items=field_info.min_items,
+                    max_items=field_info.max_items,
+                    unique_items=field_info.unique_items,
+                )
+
+            if issubclass(origin, Set) and (field_info.min_items is not None or field_info.max_items is not None):
+                used_constraints.update({'min_items', 'max_items'})
+                return conset(go(args[0]), min_items=field_info.min_items, max_items=field_info.max_items)
+
+            if issubclass(origin, FrozenSet) and (field_info.min_items is not None or field_info.max_items is not None):
+                used_constraints.update({'min_items', 'max_items'})
+                return confrozenset(go(args[0]), min_items=field_info.min_items, max_items=field_info.max_items)
+
+            for t in (Tuple, List, Set, FrozenSet, Sequence):
+                if issubclass(origin, t):  # type: ignore
+                    return t[tuple(go(a) for a in args)]  # type: ignore
+
+            if issubclass(origin, Dict):
+                return Dict[args[0], go(args[1])]  # type: ignore
+
+        attrs: Optional[Tuple[str, ...]] = None
+        constraint_func: Optional[Callable[..., type]] = None
+        if isinstance(type_, type):
+            if issubclass(type_, (SecretStr, SecretBytes)):
+                attrs = ('max_length', 'min_length')
+
+                def constraint_func(**kw: Any) -> Type[Any]:
+                    return type(type_.__name__, (type_,), kw)
+
+            elif issubclass(type_, str) and not issubclass(type_, (EmailStr, AnyUrl)):
+                attrs = ('max_length', 'min_length', 'regex')
+                if issubclass(type_, StrictStr):
+
+                    def constraint_func(**kw: Any) -> Type[Any]:
+                        return type(type_.__name__, (type_,), kw)
+
+                else:
+                    constraint_func = constr
+            elif issubclass(type_, bytes):
+                attrs = ('max_length', 'min_length', 'regex')
+                if issubclass(type_, StrictBytes):
+
+                    def constraint_func(**kw: Any) -> Type[Any]:
+                        return type(type_.__name__, (type_,), kw)
+
+                else:
+                    constraint_func = conbytes
+            elif issubclass(type_, numeric_types) and not issubclass(
+                type_,
+                (
+                    ConstrainedInt,
+                    ConstrainedFloat,
+                    ConstrainedDecimal,
+                    ConstrainedList,
+                    ConstrainedSet,
+                    ConstrainedFrozenSet,
+                    bool,
+                ),
+            ):
+                # Is numeric type
+                attrs = ('gt', 'lt', 'ge', 'le', 'multiple_of')
+                if issubclass(type_, float):
+                    attrs += ('allow_inf_nan',)
+                if issubclass(type_, Decimal):
+                    attrs += ('max_digits', 'decimal_places')
+                numeric_type = next(t for t in numeric_types if issubclass(type_, t))  # pragma: no branch
+                constraint_func = _map_types_constraint[numeric_type]
+
+        if attrs:
+            used_constraints.update(set(attrs))
+            kwargs = {
+                attr_name: attr
+                for attr_name, attr in ((attr_name, getattr(field_info, attr_name)) for attr_name in attrs)
+                if attr is not None
+            }
+            if kwargs:
+                constraint_func = cast(Callable[..., type], constraint_func)
+                return constraint_func(**kwargs)
+        return type_
+
+    return go(annotation), used_constraints
+
+
+def normalize_name(name: str) -> str:
+    """
+    Normalizes the given name. This can be applied to either a model *or* enum.
+    """
+    return re.sub(r'[^a-zA-Z0-9.\-_]', '_', name)
+
+
+class SkipField(Exception):
+    """
+    Utility exception used to exclude fields from schema.
+    """
+
+    def __init__(self, message: str) -> None:
+        self.message = message
diff --git a/lib/pydantic/v1/tools.py b/lib/pydantic/v1/tools.py
new file mode 100644
index 00000000..45be2770
--- /dev/null
+++ b/lib/pydantic/v1/tools.py
@@ -0,0 +1,92 @@
+import json
+from functools import lru_cache
+from pathlib import Path
+from typing import TYPE_CHECKING, Any, Callable, Optional, Type, TypeVar, Union
+
+from .parse import Protocol, load_file, load_str_bytes
+from .types import StrBytes
+from .typing import display_as_type
+
+__all__ = ('parse_file_as', 'parse_obj_as', 'parse_raw_as', 'schema_of', 'schema_json_of')
+
+NameFactory = Union[str, Callable[[Type[Any]], str]]
+
+if TYPE_CHECKING:
+    from .typing import DictStrAny
+
+
+def _generate_parsing_type_name(type_: Any) -> str:
+    return f'ParsingModel[{display_as_type(type_)}]'
+
+
+@lru_cache(maxsize=2048)
+def _get_parsing_type(type_: Any, *, type_name: Optional[NameFactory] = None) -> Any:
+    from .main import create_model
+
+    if type_name is None:
+        type_name = _generate_parsing_type_name
+    if not isinstance(type_name, str):
+        type_name = type_name(type_)
+    return create_model(type_name, __root__=(type_, ...))
+
+
+T = TypeVar('T')
+
+
+def parse_obj_as(type_: Type[T], obj: Any, *, type_name: Optional[NameFactory] = None) -> T:
+    model_type = _get_parsing_type(type_, type_name=type_name)  # type: ignore[arg-type]
+    return model_type(__root__=obj).__root__
+
+
+def parse_file_as(
+    type_: Type[T],
+    path: Union[str, Path],
+    *,
+    content_type: str = None,
+    encoding: str = 'utf8',
+    proto: Protocol = None,
+    allow_pickle: bool = False,
+    json_loads: Callable[[str], Any] = json.loads,
+    type_name: Optional[NameFactory] = None,
+) -> T:
+    obj = load_file(
+        path,
+        proto=proto,
+        content_type=content_type,
+        encoding=encoding,
+        allow_pickle=allow_pickle,
+        json_loads=json_loads,
+    )
+    return parse_obj_as(type_, obj, type_name=type_name)
+
+
+def parse_raw_as(
+    type_: Type[T],
+    b: StrBytes,
+    *,
+    content_type: str = None,
+    encoding: str = 'utf8',
+    proto: Protocol = None,
+    allow_pickle: bool = False,
+    json_loads: Callable[[str], Any] = json.loads,
+    type_name: Optional[NameFactory] = None,
+) -> T:
+    obj = load_str_bytes(
+        b,
+        proto=proto,
+        content_type=content_type,
+        encoding=encoding,
+        allow_pickle=allow_pickle,
+        json_loads=json_loads,
+    )
+    return parse_obj_as(type_, obj, type_name=type_name)
+
+
+def schema_of(type_: Any, *, title: Optional[NameFactory] = None, **schema_kwargs: Any) -> 'DictStrAny':
+    """Generate a JSON schema (as dict) for the passed model or dynamically generated one"""
+    return _get_parsing_type(type_, type_name=title).schema(**schema_kwargs)
+
+
+def schema_json_of(type_: Any, *, title: Optional[NameFactory] = None, **schema_json_kwargs: Any) -> str:
+    """Generate a JSON schema (as JSON) for the passed model or dynamically generated one"""
+    return _get_parsing_type(type_, type_name=title).schema_json(**schema_json_kwargs)
diff --git a/lib/pydantic/v1/types.py b/lib/pydantic/v1/types.py
new file mode 100644
index 00000000..754e58ff
--- /dev/null
+++ b/lib/pydantic/v1/types.py
@@ -0,0 +1,1205 @@
+import abc
+import math
+import re
+import warnings
+from datetime import date
+from decimal import Decimal, InvalidOperation
+from enum import Enum
+from pathlib import Path
+from types import new_class
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    ClassVar,
+    Dict,
+    FrozenSet,
+    List,
+    Optional,
+    Pattern,
+    Set,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+    cast,
+    overload,
+)
+from uuid import UUID
+from weakref import WeakSet
+
+from . import errors
+from .datetime_parse import parse_date
+from .utils import import_string, update_not_none
+from .validators import (
+    bytes_validator,
+    constr_length_validator,
+    constr_lower,
+    constr_strip_whitespace,
+    constr_upper,
+    decimal_validator,
+    float_finite_validator,
+    float_validator,
+    frozenset_validator,
+    int_validator,
+    list_validator,
+    number_multiple_validator,
+    number_size_validator,
+    path_exists_validator,
+    path_validator,
+    set_validator,
+    str_validator,
+    strict_bytes_validator,
+    strict_float_validator,
+    strict_int_validator,
+    strict_str_validator,
+)
+
+__all__ = [
+    'NoneStr',
+    'NoneBytes',
+    'StrBytes',
+    'NoneStrBytes',
+    'StrictStr',
+    'ConstrainedBytes',
+    'conbytes',
+    'ConstrainedList',
+    'conlist',
+    'ConstrainedSet',
+    'conset',
+    'ConstrainedFrozenSet',
+    'confrozenset',
+    'ConstrainedStr',
+    'constr',
+    'PyObject',
+    'ConstrainedInt',
+    'conint',
+    'PositiveInt',
+    'NegativeInt',
+    'NonNegativeInt',
+    'NonPositiveInt',
+    'ConstrainedFloat',
+    'confloat',
+    'PositiveFloat',
+    'NegativeFloat',
+    'NonNegativeFloat',
+    'NonPositiveFloat',
+    'FiniteFloat',
+    'ConstrainedDecimal',
+    'condecimal',
+    'UUID1',
+    'UUID3',
+    'UUID4',
+    'UUID5',
+    'FilePath',
+    'DirectoryPath',
+    'Json',
+    'JsonWrapper',
+    'SecretField',
+    'SecretStr',
+    'SecretBytes',
+    'StrictBool',
+    'StrictBytes',
+    'StrictInt',
+    'StrictFloat',
+    'PaymentCardNumber',
+    'ByteSize',
+    'PastDate',
+    'FutureDate',
+    'ConstrainedDate',
+    'condate',
+]
+
+NoneStr = Optional[str]
+NoneBytes = Optional[bytes]
+StrBytes = Union[str, bytes]
+NoneStrBytes = Optional[StrBytes]
+OptionalInt = Optional[int]
+OptionalIntFloat = Union[OptionalInt, float]
+OptionalIntFloatDecimal = Union[OptionalIntFloat, Decimal]
+OptionalDate = Optional[date]
+StrIntFloat = Union[str, int, float]
+
+if TYPE_CHECKING:
+    from typing_extensions import Annotated
+
+    from .dataclasses import Dataclass
+    from .main import BaseModel
+    from .typing import CallableGenerator
+
+    ModelOrDc = Type[Union[BaseModel, Dataclass]]
+
+T = TypeVar('T')
+_DEFINED_TYPES: 'WeakSet[type]' = WeakSet()
+
+
+@overload
+def _registered(typ: Type[T]) -> Type[T]:
+    pass
+
+
+@overload
+def _registered(typ: 'ConstrainedNumberMeta') -> 'ConstrainedNumberMeta':
+    pass
+
+
+def _registered(typ: Union[Type[T], 'ConstrainedNumberMeta']) -> Union[Type[T], 'ConstrainedNumberMeta']:
+    # In order to generate valid examples of constrained types, Hypothesis needs
+    # to inspect the type object - so we keep a weakref to each contype object
+    # until it can be registered.  When (or if) our Hypothesis plugin is loaded,
+    # it monkeypatches this function.
+    # If Hypothesis is never used, the total effect is to keep a weak reference
+    # which has minimal memory usage and doesn't even affect garbage collection.
+    _DEFINED_TYPES.add(typ)
+    return typ
+
+
+class ConstrainedNumberMeta(type):
+    def __new__(cls, name: str, bases: Any, dct: Dict[str, Any]) -> 'ConstrainedInt':  # type: ignore
+        new_cls = cast('ConstrainedInt', type.__new__(cls, name, bases, dct))
+
+        if new_cls.gt is not None and new_cls.ge is not None:
+            raise errors.ConfigError('bounds gt and ge cannot be specified at the same time')
+        if new_cls.lt is not None and new_cls.le is not None:
+            raise errors.ConfigError('bounds lt and le cannot be specified at the same time')
+
+        return _registered(new_cls)  # type: ignore
+
+
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ BOOLEAN TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+if TYPE_CHECKING:
+    StrictBool = bool
+else:
+
+    class StrictBool(int):
+        """
+        StrictBool to allow for bools which are not type-coerced.
+        """
+
+        @classmethod
+        def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+            field_schema.update(type='boolean')
+
+        @classmethod
+        def __get_validators__(cls) -> 'CallableGenerator':
+            yield cls.validate
+
+        @classmethod
+        def validate(cls, value: Any) -> bool:
+            """
+            Ensure that we only allow bools.
+            """
+            if isinstance(value, bool):
+                return value
+
+            raise errors.StrictBoolError()
+
+
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ INTEGER TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+
+class ConstrainedInt(int, metaclass=ConstrainedNumberMeta):
+    strict: bool = False
+    gt: OptionalInt = None
+    ge: OptionalInt = None
+    lt: OptionalInt = None
+    le: OptionalInt = None
+    multiple_of: OptionalInt = None
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        update_not_none(
+            field_schema,
+            exclusiveMinimum=cls.gt,
+            exclusiveMaximum=cls.lt,
+            minimum=cls.ge,
+            maximum=cls.le,
+            multipleOf=cls.multiple_of,
+        )
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield strict_int_validator if cls.strict else int_validator
+        yield number_size_validator
+        yield number_multiple_validator
+
+
+def conint(
+    *,
+    strict: bool = False,
+    gt: Optional[int] = None,
+    ge: Optional[int] = None,
+    lt: Optional[int] = None,
+    le: Optional[int] = None,
+    multiple_of: Optional[int] = None,
+) -> Type[int]:
+    # use kwargs then define conf in a dict to aid with IDE type hinting
+    namespace = dict(strict=strict, gt=gt, ge=ge, lt=lt, le=le, multiple_of=multiple_of)
+    return type('ConstrainedIntValue', (ConstrainedInt,), namespace)
+
+
+if TYPE_CHECKING:
+    PositiveInt = int
+    NegativeInt = int
+    NonPositiveInt = int
+    NonNegativeInt = int
+    StrictInt = int
+else:
+
+    class PositiveInt(ConstrainedInt):
+        gt = 0
+
+    class NegativeInt(ConstrainedInt):
+        lt = 0
+
+    class NonPositiveInt(ConstrainedInt):
+        le = 0
+
+    class NonNegativeInt(ConstrainedInt):
+        ge = 0
+
+    class StrictInt(ConstrainedInt):
+        strict = True
+
+
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ FLOAT TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+
+class ConstrainedFloat(float, metaclass=ConstrainedNumberMeta):
+    strict: bool = False
+    gt: OptionalIntFloat = None
+    ge: OptionalIntFloat = None
+    lt: OptionalIntFloat = None
+    le: OptionalIntFloat = None
+    multiple_of: OptionalIntFloat = None
+    allow_inf_nan: Optional[bool] = None
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        update_not_none(
+            field_schema,
+            exclusiveMinimum=cls.gt,
+            exclusiveMaximum=cls.lt,
+            minimum=cls.ge,
+            maximum=cls.le,
+            multipleOf=cls.multiple_of,
+        )
+        # Modify constraints to account for differences between IEEE floats and JSON
+        if field_schema.get('exclusiveMinimum') == -math.inf:
+            del field_schema['exclusiveMinimum']
+        if field_schema.get('minimum') == -math.inf:
+            del field_schema['minimum']
+        if field_schema.get('exclusiveMaximum') == math.inf:
+            del field_schema['exclusiveMaximum']
+        if field_schema.get('maximum') == math.inf:
+            del field_schema['maximum']
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield strict_float_validator if cls.strict else float_validator
+        yield number_size_validator
+        yield number_multiple_validator
+        yield float_finite_validator
+
+
+def confloat(
+    *,
+    strict: bool = False,
+    gt: float = None,
+    ge: float = None,
+    lt: float = None,
+    le: float = None,
+    multiple_of: float = None,
+    allow_inf_nan: Optional[bool] = None,
+) -> Type[float]:
+    # use kwargs then define conf in a dict to aid with IDE type hinting
+    namespace = dict(strict=strict, gt=gt, ge=ge, lt=lt, le=le, multiple_of=multiple_of, allow_inf_nan=allow_inf_nan)
+    return type('ConstrainedFloatValue', (ConstrainedFloat,), namespace)
+
+
+if TYPE_CHECKING:
+    PositiveFloat = float
+    NegativeFloat = float
+    NonPositiveFloat = float
+    NonNegativeFloat = float
+    StrictFloat = float
+    FiniteFloat = float
+else:
+
+    class PositiveFloat(ConstrainedFloat):
+        gt = 0
+
+    class NegativeFloat(ConstrainedFloat):
+        lt = 0
+
+    class NonPositiveFloat(ConstrainedFloat):
+        le = 0
+
+    class NonNegativeFloat(ConstrainedFloat):
+        ge = 0
+
+    class StrictFloat(ConstrainedFloat):
+        strict = True
+
+    class FiniteFloat(ConstrainedFloat):
+        allow_inf_nan = False
+
+
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ BYTES TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+
+class ConstrainedBytes(bytes):
+    strip_whitespace = False
+    to_upper = False
+    to_lower = False
+    min_length: OptionalInt = None
+    max_length: OptionalInt = None
+    strict: bool = False
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        update_not_none(field_schema, minLength=cls.min_length, maxLength=cls.max_length)
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield strict_bytes_validator if cls.strict else bytes_validator
+        yield constr_strip_whitespace
+        yield constr_upper
+        yield constr_lower
+        yield constr_length_validator
+
+
+def conbytes(
+    *,
+    strip_whitespace: bool = False,
+    to_upper: bool = False,
+    to_lower: bool = False,
+    min_length: Optional[int] = None,
+    max_length: Optional[int] = None,
+    strict: bool = False,
+) -> Type[bytes]:
+    # use kwargs then define conf in a dict to aid with IDE type hinting
+    namespace = dict(
+        strip_whitespace=strip_whitespace,
+        to_upper=to_upper,
+        to_lower=to_lower,
+        min_length=min_length,
+        max_length=max_length,
+        strict=strict,
+    )
+    return _registered(type('ConstrainedBytesValue', (ConstrainedBytes,), namespace))
+
+
+if TYPE_CHECKING:
+    StrictBytes = bytes
+else:
+
+    class StrictBytes(ConstrainedBytes):
+        strict = True
+
+
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ STRING TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+
+class ConstrainedStr(str):
+    strip_whitespace = False
+    to_upper = False
+    to_lower = False
+    min_length: OptionalInt = None
+    max_length: OptionalInt = None
+    curtail_length: OptionalInt = None
+    regex: Optional[Union[str, Pattern[str]]] = None
+    strict = False
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        update_not_none(
+            field_schema,
+            minLength=cls.min_length,
+            maxLength=cls.max_length,
+            pattern=cls.regex and cls._get_pattern(cls.regex),
+        )
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield strict_str_validator if cls.strict else str_validator
+        yield constr_strip_whitespace
+        yield constr_upper
+        yield constr_lower
+        yield constr_length_validator
+        yield cls.validate
+
+    @classmethod
+    def validate(cls, value: Union[str]) -> Union[str]:
+        if cls.curtail_length and len(value) > cls.curtail_length:
+            value = value[: cls.curtail_length]
+
+        if cls.regex:
+            if not re.match(cls.regex, value):
+                raise errors.StrRegexError(pattern=cls._get_pattern(cls.regex))
+
+        return value
+
+    @staticmethod
+    def _get_pattern(regex: Union[str, Pattern[str]]) -> str:
+        return regex if isinstance(regex, str) else regex.pattern
+
+
+def constr(
+    *,
+    strip_whitespace: bool = False,
+    to_upper: bool = False,
+    to_lower: bool = False,
+    strict: bool = False,
+    min_length: Optional[int] = None,
+    max_length: Optional[int] = None,
+    curtail_length: Optional[int] = None,
+    regex: Optional[str] = None,
+) -> Type[str]:
+    # use kwargs then define conf in a dict to aid with IDE type hinting
+    namespace = dict(
+        strip_whitespace=strip_whitespace,
+        to_upper=to_upper,
+        to_lower=to_lower,
+        strict=strict,
+        min_length=min_length,
+        max_length=max_length,
+        curtail_length=curtail_length,
+        regex=regex and re.compile(regex),
+    )
+    return _registered(type('ConstrainedStrValue', (ConstrainedStr,), namespace))
+
+
+if TYPE_CHECKING:
+    StrictStr = str
+else:
+
+    class StrictStr(ConstrainedStr):
+        strict = True
+
+
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ SET TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+
+# This types superclass should be Set[T], but cython chokes on that...
+class ConstrainedSet(set):  # type: ignore
+    # Needed for pydantic to detect that this is a set
+    __origin__ = set
+    __args__: Set[Type[T]]  # type: ignore
+
+    min_items: Optional[int] = None
+    max_items: Optional[int] = None
+    item_type: Type[T]  # type: ignore
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield cls.set_length_validator
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        update_not_none(field_schema, minItems=cls.min_items, maxItems=cls.max_items)
+
+    @classmethod
+    def set_length_validator(cls, v: 'Optional[Set[T]]') -> 'Optional[Set[T]]':
+        if v is None:
+            return None
+
+        v = set_validator(v)
+        v_len = len(v)
+
+        if cls.min_items is not None and v_len < cls.min_items:
+            raise errors.SetMinLengthError(limit_value=cls.min_items)
+
+        if cls.max_items is not None and v_len > cls.max_items:
+            raise errors.SetMaxLengthError(limit_value=cls.max_items)
+
+        return v
+
+
+def conset(item_type: Type[T], *, min_items: Optional[int] = None, max_items: Optional[int] = None) -> Type[Set[T]]:
+    # __args__ is needed to conform to typing generics api
+    namespace = {'min_items': min_items, 'max_items': max_items, 'item_type': item_type, '__args__': [item_type]}
+    # We use new_class to be able to deal with Generic types
+    return new_class('ConstrainedSetValue', (ConstrainedSet,), {}, lambda ns: ns.update(namespace))
+
+
+# This types superclass should be FrozenSet[T], but cython chokes on that...
+class ConstrainedFrozenSet(frozenset):  # type: ignore
+    # Needed for pydantic to detect that this is a set
+    __origin__ = frozenset
+    __args__: FrozenSet[Type[T]]  # type: ignore
+
+    min_items: Optional[int] = None
+    max_items: Optional[int] = None
+    item_type: Type[T]  # type: ignore
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield cls.frozenset_length_validator
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        update_not_none(field_schema, minItems=cls.min_items, maxItems=cls.max_items)
+
+    @classmethod
+    def frozenset_length_validator(cls, v: 'Optional[FrozenSet[T]]') -> 'Optional[FrozenSet[T]]':
+        if v is None:
+            return None
+
+        v = frozenset_validator(v)
+        v_len = len(v)
+
+        if cls.min_items is not None and v_len < cls.min_items:
+            raise errors.FrozenSetMinLengthError(limit_value=cls.min_items)
+
+        if cls.max_items is not None and v_len > cls.max_items:
+            raise errors.FrozenSetMaxLengthError(limit_value=cls.max_items)
+
+        return v
+
+
+def confrozenset(
+    item_type: Type[T], *, min_items: Optional[int] = None, max_items: Optional[int] = None
+) -> Type[FrozenSet[T]]:
+    # __args__ is needed to conform to typing generics api
+    namespace = {'min_items': min_items, 'max_items': max_items, 'item_type': item_type, '__args__': [item_type]}
+    # We use new_class to be able to deal with Generic types
+    return new_class('ConstrainedFrozenSetValue', (ConstrainedFrozenSet,), {}, lambda ns: ns.update(namespace))
+
+
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ LIST TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+
+# This types superclass should be List[T], but cython chokes on that...
+class ConstrainedList(list):  # type: ignore
+    # Needed for pydantic to detect that this is a list
+    __origin__ = list
+    __args__: Tuple[Type[T], ...]  # type: ignore
+
+    min_items: Optional[int] = None
+    max_items: Optional[int] = None
+    unique_items: Optional[bool] = None
+    item_type: Type[T]  # type: ignore
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield cls.list_length_validator
+        if cls.unique_items:
+            yield cls.unique_items_validator
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        update_not_none(field_schema, minItems=cls.min_items, maxItems=cls.max_items, uniqueItems=cls.unique_items)
+
+    @classmethod
+    def list_length_validator(cls, v: 'Optional[List[T]]') -> 'Optional[List[T]]':
+        if v is None:
+            return None
+
+        v = list_validator(v)
+        v_len = len(v)
+
+        if cls.min_items is not None and v_len < cls.min_items:
+            raise errors.ListMinLengthError(limit_value=cls.min_items)
+
+        if cls.max_items is not None and v_len > cls.max_items:
+            raise errors.ListMaxLengthError(limit_value=cls.max_items)
+
+        return v
+
+    @classmethod
+    def unique_items_validator(cls, v: 'Optional[List[T]]') -> 'Optional[List[T]]':
+        if v is None:
+            return None
+
+        for i, value in enumerate(v, start=1):
+            if value in v[i:]:
+                raise errors.ListUniqueItemsError()
+
+        return v
+
+
+def conlist(
+    item_type: Type[T], *, min_items: Optional[int] = None, max_items: Optional[int] = None, unique_items: bool = None
+) -> Type[List[T]]:
+    # __args__ is needed to conform to typing generics api
+    namespace = dict(
+        min_items=min_items, max_items=max_items, unique_items=unique_items, item_type=item_type, __args__=(item_type,)
+    )
+    # We use new_class to be able to deal with Generic types
+    return new_class('ConstrainedListValue', (ConstrainedList,), {}, lambda ns: ns.update(namespace))
+
+
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ PYOBJECT TYPE ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+
+if TYPE_CHECKING:
+    PyObject = Callable[..., Any]
+else:
+
+    class PyObject:
+        validate_always = True
+
+        @classmethod
+        def __get_validators__(cls) -> 'CallableGenerator':
+            yield cls.validate
+
+        @classmethod
+        def validate(cls, value: Any) -> Any:
+            if isinstance(value, Callable):
+                return value
+
+            try:
+                value = str_validator(value)
+            except errors.StrError:
+                raise errors.PyObjectError(error_message='value is neither a valid import path not a valid callable')
+
+            try:
+                return import_string(value)
+            except ImportError as e:
+                raise errors.PyObjectError(error_message=str(e))
+
+
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ DECIMAL TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+
+class ConstrainedDecimal(Decimal, metaclass=ConstrainedNumberMeta):
+    gt: OptionalIntFloatDecimal = None
+    ge: OptionalIntFloatDecimal = None
+    lt: OptionalIntFloatDecimal = None
+    le: OptionalIntFloatDecimal = None
+    max_digits: OptionalInt = None
+    decimal_places: OptionalInt = None
+    multiple_of: OptionalIntFloatDecimal = None
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        update_not_none(
+            field_schema,
+            exclusiveMinimum=cls.gt,
+            exclusiveMaximum=cls.lt,
+            minimum=cls.ge,
+            maximum=cls.le,
+            multipleOf=cls.multiple_of,
+        )
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield decimal_validator
+        yield number_size_validator
+        yield number_multiple_validator
+        yield cls.validate
+
+    @classmethod
+    def validate(cls, value: Decimal) -> Decimal:
+        try:
+            normalized_value = value.normalize()
+        except InvalidOperation:
+            normalized_value = value
+        digit_tuple, exponent = normalized_value.as_tuple()[1:]
+        if exponent in {'F', 'n', 'N'}:
+            raise errors.DecimalIsNotFiniteError()
+
+        if exponent >= 0:
+            # A positive exponent adds that many trailing zeros.
+            digits = len(digit_tuple) + exponent
+            decimals = 0
+        else:
+            # If the absolute value of the negative exponent is larger than the
+            # number of digits, then it's the same as the number of digits,
+            # because it'll consume all of the digits in digit_tuple and then
+            # add abs(exponent) - len(digit_tuple) leading zeros after the
+            # decimal point.
+            if abs(exponent) > len(digit_tuple):
+                digits = decimals = abs(exponent)
+            else:
+                digits = len(digit_tuple)
+                decimals = abs(exponent)
+        whole_digits = digits - decimals
+
+        if cls.max_digits is not None and digits > cls.max_digits:
+            raise errors.DecimalMaxDigitsError(max_digits=cls.max_digits)
+
+        if cls.decimal_places is not None and decimals > cls.decimal_places:
+            raise errors.DecimalMaxPlacesError(decimal_places=cls.decimal_places)
+
+        if cls.max_digits is not None and cls.decimal_places is not None:
+            expected = cls.max_digits - cls.decimal_places
+            if whole_digits > expected:
+                raise errors.DecimalWholeDigitsError(whole_digits=expected)
+
+        return value
+
+
+def condecimal(
+    *,
+    gt: Decimal = None,
+    ge: Decimal = None,
+    lt: Decimal = None,
+    le: Decimal = None,
+    max_digits: Optional[int] = None,
+    decimal_places: Optional[int] = None,
+    multiple_of: Decimal = None,
+) -> Type[Decimal]:
+    # use kwargs then define conf in a dict to aid with IDE type hinting
+    namespace = dict(
+        gt=gt, ge=ge, lt=lt, le=le, max_digits=max_digits, decimal_places=decimal_places, multiple_of=multiple_of
+    )
+    return type('ConstrainedDecimalValue', (ConstrainedDecimal,), namespace)
+
+
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ UUID TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+if TYPE_CHECKING:
+    UUID1 = UUID
+    UUID3 = UUID
+    UUID4 = UUID
+    UUID5 = UUID
+else:
+
+    class UUID1(UUID):
+        _required_version = 1
+
+        @classmethod
+        def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+            field_schema.update(type='string', format=f'uuid{cls._required_version}')
+
+    class UUID3(UUID1):
+        _required_version = 3
+
+    class UUID4(UUID1):
+        _required_version = 4
+
+    class UUID5(UUID1):
+        _required_version = 5
+
+
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ PATH TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+if TYPE_CHECKING:
+    FilePath = Path
+    DirectoryPath = Path
+else:
+
+    class FilePath(Path):
+        @classmethod
+        def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+            field_schema.update(format='file-path')
+
+        @classmethod
+        def __get_validators__(cls) -> 'CallableGenerator':
+            yield path_validator
+            yield path_exists_validator
+            yield cls.validate
+
+        @classmethod
+        def validate(cls, value: Path) -> Path:
+            if not value.is_file():
+                raise errors.PathNotAFileError(path=value)
+
+            return value
+
+    class DirectoryPath(Path):
+        @classmethod
+        def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+            field_schema.update(format='directory-path')
+
+        @classmethod
+        def __get_validators__(cls) -> 'CallableGenerator':
+            yield path_validator
+            yield path_exists_validator
+            yield cls.validate
+
+        @classmethod
+        def validate(cls, value: Path) -> Path:
+            if not value.is_dir():
+                raise errors.PathNotADirectoryError(path=value)
+
+            return value
+
+
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ JSON TYPE ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+
+class JsonWrapper:
+    pass
+
+
+class JsonMeta(type):
+    def __getitem__(self, t: Type[Any]) -> Type[JsonWrapper]:
+        if t is Any:
+            return Json  # allow Json[Any] to replecate plain Json
+        return _registered(type('JsonWrapperValue', (JsonWrapper,), {'inner_type': t}))
+
+
+if TYPE_CHECKING:
+    Json = Annotated[T, ...]  # Json[list[str]] will be recognized by type checkers as list[str]
+
+else:
+
+    class Json(metaclass=JsonMeta):
+        @classmethod
+        def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+            field_schema.update(type='string', format='json-string')
+
+
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ SECRET TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+
+class SecretField(abc.ABC):
+    """
+    Note: this should be implemented as a generic like `SecretField(ABC, Generic[T])`,
+          the `__init__()` should be part of the abstract class and the
+          `get_secret_value()` method should use the generic `T` type.
+
+          However Cython doesn't support very well generics at the moment and
+          the generated code fails to be imported (see
+          https://github.com/cython/cython/issues/2753).
+    """
+
+    def __eq__(self, other: Any) -> bool:
+        return isinstance(other, self.__class__) and self.get_secret_value() == other.get_secret_value()
+
+    def __str__(self) -> str:
+        return '**********' if self.get_secret_value() else ''
+
+    def __hash__(self) -> int:
+        return hash(self.get_secret_value())
+
+    @abc.abstractmethod
+    def get_secret_value(self) -> Any:  # pragma: no cover
+        ...
+
+
+class SecretStr(SecretField):
+    min_length: OptionalInt = None
+    max_length: OptionalInt = None
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        update_not_none(
+            field_schema,
+            type='string',
+            writeOnly=True,
+            format='password',
+            minLength=cls.min_length,
+            maxLength=cls.max_length,
+        )
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield cls.validate
+        yield constr_length_validator
+
+    @classmethod
+    def validate(cls, value: Any) -> 'SecretStr':
+        if isinstance(value, cls):
+            return value
+        value = str_validator(value)
+        return cls(value)
+
+    def __init__(self, value: str):
+        self._secret_value = value
+
+    def __repr__(self) -> str:
+        return f"SecretStr('{self}')"
+
+    def __len__(self) -> int:
+        return len(self._secret_value)
+
+    def display(self) -> str:
+        warnings.warn('`secret_str.display()` is deprecated, use `str(secret_str)` instead', DeprecationWarning)
+        return str(self)
+
+    def get_secret_value(self) -> str:
+        return self._secret_value
+
+
+class SecretBytes(SecretField):
+    min_length: OptionalInt = None
+    max_length: OptionalInt = None
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        update_not_none(
+            field_schema,
+            type='string',
+            writeOnly=True,
+            format='password',
+            minLength=cls.min_length,
+            maxLength=cls.max_length,
+        )
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield cls.validate
+        yield constr_length_validator
+
+    @classmethod
+    def validate(cls, value: Any) -> 'SecretBytes':
+        if isinstance(value, cls):
+            return value
+        value = bytes_validator(value)
+        return cls(value)
+
+    def __init__(self, value: bytes):
+        self._secret_value = value
+
+    def __repr__(self) -> str:
+        return f"SecretBytes(b'{self}')"
+
+    def __len__(self) -> int:
+        return len(self._secret_value)
+
+    def display(self) -> str:
+        warnings.warn('`secret_bytes.display()` is deprecated, use `str(secret_bytes)` instead', DeprecationWarning)
+        return str(self)
+
+    def get_secret_value(self) -> bytes:
+        return self._secret_value
+
+
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ PAYMENT CARD TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+
+class PaymentCardBrand(str, Enum):
+    # If you add another card type, please also add it to the
+    # Hypothesis strategy in `pydantic._hypothesis_plugin`.
+    amex = 'American Express'
+    mastercard = 'Mastercard'
+    visa = 'Visa'
+    other = 'other'
+
+    def __str__(self) -> str:
+        return self.value
+
+
+class PaymentCardNumber(str):
+    """
+    Based on: https://en.wikipedia.org/wiki/Payment_card_number
+    """
+
+    strip_whitespace: ClassVar[bool] = True
+    min_length: ClassVar[int] = 12
+    max_length: ClassVar[int] = 19
+    bin: str
+    last4: str
+    brand: PaymentCardBrand
+
+    def __init__(self, card_number: str):
+        self.bin = card_number[:6]
+        self.last4 = card_number[-4:]
+        self.brand = self._get_brand(card_number)
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield str_validator
+        yield constr_strip_whitespace
+        yield constr_length_validator
+        yield cls.validate_digits
+        yield cls.validate_luhn_check_digit
+        yield cls
+        yield cls.validate_length_for_brand
+
+    @property
+    def masked(self) -> str:
+        num_masked = len(self) - 10  # len(bin) + len(last4) == 10
+        return f'{self.bin}{"*" * num_masked}{self.last4}'
+
+    @classmethod
+    def validate_digits(cls, card_number: str) -> str:
+        if not card_number.isdigit():
+            raise errors.NotDigitError
+        return card_number
+
+    @classmethod
+    def validate_luhn_check_digit(cls, card_number: str) -> str:
+        """
+        Based on: https://en.wikipedia.org/wiki/Luhn_algorithm
+        """
+        sum_ = int(card_number[-1])
+        length = len(card_number)
+        parity = length % 2
+        for i in range(length - 1):
+            digit = int(card_number[i])
+            if i % 2 == parity:
+                digit *= 2
+            if digit > 9:
+                digit -= 9
+            sum_ += digit
+        valid = sum_ % 10 == 0
+        if not valid:
+            raise errors.LuhnValidationError
+        return card_number
+
+    @classmethod
+    def validate_length_for_brand(cls, card_number: 'PaymentCardNumber') -> 'PaymentCardNumber':
+        """
+        Validate length based on BIN for major brands:
+        https://en.wikipedia.org/wiki/Payment_card_number#Issuer_identification_number_(IIN)
+        """
+        required_length: Union[None, int, str] = None
+        if card_number.brand in PaymentCardBrand.mastercard:
+            required_length = 16
+            valid = len(card_number) == required_length
+        elif card_number.brand == PaymentCardBrand.visa:
+            required_length = '13, 16 or 19'
+            valid = len(card_number) in {13, 16, 19}
+        elif card_number.brand == PaymentCardBrand.amex:
+            required_length = 15
+            valid = len(card_number) == required_length
+        else:
+            valid = True
+        if not valid:
+            raise errors.InvalidLengthForBrand(brand=card_number.brand, required_length=required_length)
+        return card_number
+
+    @staticmethod
+    def _get_brand(card_number: str) -> PaymentCardBrand:
+        if card_number[0] == '4':
+            brand = PaymentCardBrand.visa
+        elif 51 <= int(card_number[:2]) <= 55:
+            brand = PaymentCardBrand.mastercard
+        elif card_number[:2] in {'34', '37'}:
+            brand = PaymentCardBrand.amex
+        else:
+            brand = PaymentCardBrand.other
+        return brand
+
+
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ BYTE SIZE TYPE ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+BYTE_SIZES = {
+    'b': 1,
+    'kb': 10**3,
+    'mb': 10**6,
+    'gb': 10**9,
+    'tb': 10**12,
+    'pb': 10**15,
+    'eb': 10**18,
+    'kib': 2**10,
+    'mib': 2**20,
+    'gib': 2**30,
+    'tib': 2**40,
+    'pib': 2**50,
+    'eib': 2**60,
+}
+BYTE_SIZES.update({k.lower()[0]: v for k, v in BYTE_SIZES.items() if 'i' not in k})
+byte_string_re = re.compile(r'^\s*(\d*\.?\d+)\s*(\w+)?', re.IGNORECASE)
+
+
+class ByteSize(int):
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield cls.validate
+
+    @classmethod
+    def validate(cls, v: StrIntFloat) -> 'ByteSize':
+        try:
+            return cls(int(v))
+        except ValueError:
+            pass
+
+        str_match = byte_string_re.match(str(v))
+        if str_match is None:
+            raise errors.InvalidByteSize()
+
+        scalar, unit = str_match.groups()
+        if unit is None:
+            unit = 'b'
+
+        try:
+            unit_mult = BYTE_SIZES[unit.lower()]
+        except KeyError:
+            raise errors.InvalidByteSizeUnit(unit=unit)
+
+        return cls(int(float(scalar) * unit_mult))
+
+    def human_readable(self, decimal: bool = False) -> str:
+        if decimal:
+            divisor = 1000
+            units = ['B', 'KB', 'MB', 'GB', 'TB', 'PB']
+            final_unit = 'EB'
+        else:
+            divisor = 1024
+            units = ['B', 'KiB', 'MiB', 'GiB', 'TiB', 'PiB']
+            final_unit = 'EiB'
+
+        num = float(self)
+        for unit in units:
+            if abs(num) < divisor:
+                return f'{num:0.1f}{unit}'
+            num /= divisor
+
+        return f'{num:0.1f}{final_unit}'
+
+    def to(self, unit: str) -> float:
+        try:
+            unit_div = BYTE_SIZES[unit.lower()]
+        except KeyError:
+            raise errors.InvalidByteSizeUnit(unit=unit)
+
+        return self / unit_div
+
+
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ DATE TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+if TYPE_CHECKING:
+    PastDate = date
+    FutureDate = date
+else:
+
+    class PastDate(date):
+        @classmethod
+        def __get_validators__(cls) -> 'CallableGenerator':
+            yield parse_date
+            yield cls.validate
+
+        @classmethod
+        def validate(cls, value: date) -> date:
+            if value >= date.today():
+                raise errors.DateNotInThePastError()
+
+            return value
+
+    class FutureDate(date):
+        @classmethod
+        def __get_validators__(cls) -> 'CallableGenerator':
+            yield parse_date
+            yield cls.validate
+
+        @classmethod
+        def validate(cls, value: date) -> date:
+            if value <= date.today():
+                raise errors.DateNotInTheFutureError()
+
+            return value
+
+
+class ConstrainedDate(date, metaclass=ConstrainedNumberMeta):
+    gt: OptionalDate = None
+    ge: OptionalDate = None
+    lt: OptionalDate = None
+    le: OptionalDate = None
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        update_not_none(field_schema, exclusiveMinimum=cls.gt, exclusiveMaximum=cls.lt, minimum=cls.ge, maximum=cls.le)
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield parse_date
+        yield number_size_validator
+
+
+def condate(
+    *,
+    gt: date = None,
+    ge: date = None,
+    lt: date = None,
+    le: date = None,
+) -> Type[date]:
+    # use kwargs then define conf in a dict to aid with IDE type hinting
+    namespace = dict(gt=gt, ge=ge, lt=lt, le=le)
+    return type('ConstrainedDateValue', (ConstrainedDate,), namespace)
diff --git a/lib/pydantic/v1/typing.py b/lib/pydantic/v1/typing.py
new file mode 100644
index 00000000..a690a053
--- /dev/null
+++ b/lib/pydantic/v1/typing.py
@@ -0,0 +1,603 @@
+import sys
+import typing
+from collections.abc import Callable
+from os import PathLike
+from typing import (  # type: ignore
+    TYPE_CHECKING,
+    AbstractSet,
+    Any,
+    Callable as TypingCallable,
+    ClassVar,
+    Dict,
+    ForwardRef,
+    Generator,
+    Iterable,
+    List,
+    Mapping,
+    NewType,
+    Optional,
+    Sequence,
+    Set,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+    _eval_type,
+    cast,
+    get_type_hints,
+)
+
+from typing_extensions import (
+    Annotated,
+    Final,
+    Literal,
+    NotRequired as TypedDictNotRequired,
+    Required as TypedDictRequired,
+)
+
+try:
+    from typing import _TypingBase as typing_base  # type: ignore
+except ImportError:
+    from typing import _Final as typing_base  # type: ignore
+
+try:
+    from typing import GenericAlias as TypingGenericAlias  # type: ignore
+except ImportError:
+    # python < 3.9 does not have GenericAlias (list[int], tuple[str, ...] and so on)
+    TypingGenericAlias = ()
+
+try:
+    from types import UnionType as TypesUnionType  # type: ignore
+except ImportError:
+    # python < 3.10 does not have UnionType (str | int, byte | bool and so on)
+    TypesUnionType = ()
+
+
+if sys.version_info < (3, 9):
+
+    def evaluate_forwardref(type_: ForwardRef, globalns: Any, localns: Any) -> Any:
+        return type_._evaluate(globalns, localns)
+
+else:
+
+    def evaluate_forwardref(type_: ForwardRef, globalns: Any, localns: Any) -> Any:
+        # Even though it is the right signature for python 3.9, mypy complains with
+        # `error: Too many arguments for "_evaluate" of "ForwardRef"` hence the cast...
+        return cast(Any, type_)._evaluate(globalns, localns, set())
+
+
+if sys.version_info < (3, 9):
+    # Ensure we always get all the whole `Annotated` hint, not just the annotated type.
+    # For 3.7 to 3.8, `get_type_hints` doesn't recognize `typing_extensions.Annotated`,
+    # so it already returns the full annotation
+    get_all_type_hints = get_type_hints
+
+else:
+
+    def get_all_type_hints(obj: Any, globalns: Any = None, localns: Any = None) -> Any:
+        return get_type_hints(obj, globalns, localns, include_extras=True)
+
+
+_T = TypeVar('_T')
+
+AnyCallable = TypingCallable[..., Any]
+NoArgAnyCallable = TypingCallable[[], Any]
+
+# workaround for https://github.com/python/mypy/issues/9496
+AnyArgTCallable = TypingCallable[..., _T]
+
+
+# Annotated[...] is implemented by returning an instance of one of these classes, depending on
+# python/typing_extensions version.
+AnnotatedTypeNames = {'AnnotatedMeta', '_AnnotatedAlias'}
+
+
+LITERAL_TYPES: Set[Any] = {Literal}
+if hasattr(typing, 'Literal'):
+    LITERAL_TYPES.add(typing.Literal)
+
+
+if sys.version_info < (3, 8):
+
+    def get_origin(t: Type[Any]) -> Optional[Type[Any]]:
+        if type(t).__name__ in AnnotatedTypeNames:
+            # weirdly this is a runtime requirement, as well as for mypy
+            return cast(Type[Any], Annotated)
+        return getattr(t, '__origin__', None)
+
+else:
+    from typing import get_origin as _typing_get_origin
+
+    def get_origin(tp: Type[Any]) -> Optional[Type[Any]]:
+        """
+        We can't directly use `typing.get_origin` since we need a fallback to support
+        custom generic classes like `ConstrainedList`
+        It should be useless once https://github.com/cython/cython/issues/3537 is
+        solved and https://github.com/pydantic/pydantic/pull/1753 is merged.
+        """
+        if type(tp).__name__ in AnnotatedTypeNames:
+            return cast(Type[Any], Annotated)  # mypy complains about _SpecialForm
+        return _typing_get_origin(tp) or getattr(tp, '__origin__', None)
+
+
+if sys.version_info < (3, 8):
+    from typing import _GenericAlias
+
+    def get_args(t: Type[Any]) -> Tuple[Any, ...]:
+        """Compatibility version of get_args for python 3.7.
+
+        Mostly compatible with the python 3.8 `typing` module version
+        and able to handle almost all use cases.
+        """
+        if type(t).__name__ in AnnotatedTypeNames:
+            return t.__args__ + t.__metadata__
+        if isinstance(t, _GenericAlias):
+            res = t.__args__
+            if t.__origin__ is Callable and res and res[0] is not Ellipsis:
+                res = (list(res[:-1]), res[-1])
+            return res
+        return getattr(t, '__args__', ())
+
+else:
+    from typing import get_args as _typing_get_args
+
+    def _generic_get_args(tp: Type[Any]) -> Tuple[Any, ...]:
+        """
+        In python 3.9, `typing.Dict`, `typing.List`, ...
+        do have an empty `__args__` by default (instead of the generic ~T for example).
+        In order to still support `Dict` for example and consider it as `Dict[Any, Any]`,
+        we retrieve the `_nparams` value that tells us how many parameters it needs.
+        """
+        if hasattr(tp, '_nparams'):
+            return (Any,) * tp._nparams
+        # Special case for `tuple[()]`, which used to return ((),) with `typing.Tuple`
+        # in python 3.10- but now returns () for `tuple` and `Tuple`.
+        # This will probably be clarified in pydantic v2
+        try:
+            if tp == Tuple[()] or sys.version_info >= (3, 9) and tp == tuple[()]:  # type: ignore[misc]
+                return ((),)
+        # there is a TypeError when compiled with cython
+        except TypeError:  # pragma: no cover
+            pass
+        return ()
+
+    def get_args(tp: Type[Any]) -> Tuple[Any, ...]:
+        """Get type arguments with all substitutions performed.
+
+        For unions, basic simplifications used by Union constructor are performed.
+        Examples::
+            get_args(Dict[str, int]) == (str, int)
+            get_args(int) == ()
+            get_args(Union[int, Union[T, int], str][int]) == (int, str)
+            get_args(Union[int, Tuple[T, int]][str]) == (int, Tuple[str, int])
+            get_args(Callable[[], T][int]) == ([], int)
+        """
+        if type(tp).__name__ in AnnotatedTypeNames:
+            return tp.__args__ + tp.__metadata__
+        # the fallback is needed for the same reasons as `get_origin` (see above)
+        return _typing_get_args(tp) or getattr(tp, '__args__', ()) or _generic_get_args(tp)
+
+
+if sys.version_info < (3, 9):
+
+    def convert_generics(tp: Type[Any]) -> Type[Any]:
+        """Python 3.9 and older only supports generics from `typing` module.
+        They convert strings to ForwardRef automatically.
+
+        Examples::
+            typing.List['Hero'] == typing.List[ForwardRef('Hero')]
+        """
+        return tp
+
+else:
+    from typing import _UnionGenericAlias  # type: ignore
+
+    from typing_extensions import _AnnotatedAlias
+
+    def convert_generics(tp: Type[Any]) -> Type[Any]:
+        """
+        Recursively searches for `str` type hints and replaces them with ForwardRef.
+
+        Examples::
+            convert_generics(list['Hero']) == list[ForwardRef('Hero')]
+            convert_generics(dict['Hero', 'Team']) == dict[ForwardRef('Hero'), ForwardRef('Team')]
+            convert_generics(typing.Dict['Hero', 'Team']) == typing.Dict[ForwardRef('Hero'), ForwardRef('Team')]
+            convert_generics(list[str | 'Hero'] | int) == list[str | ForwardRef('Hero')] | int
+        """
+        origin = get_origin(tp)
+        if not origin or not hasattr(tp, '__args__'):
+            return tp
+
+        args = get_args(tp)
+
+        # typing.Annotated needs special treatment
+        if origin is Annotated:
+            return _AnnotatedAlias(convert_generics(args[0]), args[1:])
+
+        # recursively replace `str` instances inside of `GenericAlias` with `ForwardRef(arg)`
+        converted = tuple(
+            ForwardRef(arg) if isinstance(arg, str) and isinstance(tp, TypingGenericAlias) else convert_generics(arg)
+            for arg in args
+        )
+
+        if converted == args:
+            return tp
+        elif isinstance(tp, TypingGenericAlias):
+            return TypingGenericAlias(origin, converted)
+        elif isinstance(tp, TypesUnionType):
+            # recreate types.UnionType (PEP604, Python >= 3.10)
+            return _UnionGenericAlias(origin, converted)
+        else:
+            try:
+                setattr(tp, '__args__', converted)
+            except AttributeError:
+                pass
+            return tp
+
+
+if sys.version_info < (3, 10):
+
+    def is_union(tp: Optional[Type[Any]]) -> bool:
+        return tp is Union
+
+    WithArgsTypes = (TypingGenericAlias,)
+
+else:
+    import types
+    import typing
+
+    def is_union(tp: Optional[Type[Any]]) -> bool:
+        return tp is Union or tp is types.UnionType  # noqa: E721
+
+    WithArgsTypes = (typing._GenericAlias, types.GenericAlias, types.UnionType)
+
+
+StrPath = Union[str, PathLike]
+
+
+if TYPE_CHECKING:
+    from .fields import ModelField
+
+    TupleGenerator = Generator[Tuple[str, Any], None, None]
+    DictStrAny = Dict[str, Any]
+    DictAny = Dict[Any, Any]
+    SetStr = Set[str]
+    ListStr = List[str]
+    IntStr = Union[int, str]
+    AbstractSetIntStr = AbstractSet[IntStr]
+    DictIntStrAny = Dict[IntStr, Any]
+    MappingIntStrAny = Mapping[IntStr, Any]
+    CallableGenerator = Generator[AnyCallable, None, None]
+    ReprArgs = Sequence[Tuple[Optional[str], Any]]
+
+    MYPY = False
+    if MYPY:
+        AnyClassMethod = classmethod[Any]
+    else:
+        # classmethod[TargetType, CallableParamSpecType, CallableReturnType]
+        AnyClassMethod = classmethod[Any, Any, Any]
+
+__all__ = (
+    'AnyCallable',
+    'NoArgAnyCallable',
+    'NoneType',
+    'is_none_type',
+    'display_as_type',
+    'resolve_annotations',
+    'is_callable_type',
+    'is_literal_type',
+    'all_literal_values',
+    'is_namedtuple',
+    'is_typeddict',
+    'is_typeddict_special',
+    'is_new_type',
+    'new_type_supertype',
+    'is_classvar',
+    'is_finalvar',
+    'update_field_forward_refs',
+    'update_model_forward_refs',
+    'TupleGenerator',
+    'DictStrAny',
+    'DictAny',
+    'SetStr',
+    'ListStr',
+    'IntStr',
+    'AbstractSetIntStr',
+    'DictIntStrAny',
+    'CallableGenerator',
+    'ReprArgs',
+    'AnyClassMethod',
+    'CallableGenerator',
+    'WithArgsTypes',
+    'get_args',
+    'get_origin',
+    'get_sub_types',
+    'typing_base',
+    'get_all_type_hints',
+    'is_union',
+    'StrPath',
+    'MappingIntStrAny',
+)
+
+
+NoneType = None.__class__
+
+
+NONE_TYPES: Tuple[Any, Any, Any] = (None, NoneType, Literal[None])
+
+
+if sys.version_info < (3, 8):
+    # Even though this implementation is slower, we need it for python 3.7:
+    # In python 3.7 "Literal" is not a builtin type and uses a different
+    # mechanism.
+    # for this reason `Literal[None] is Literal[None]` evaluates to `False`,
+    # breaking the faster implementation used for the other python versions.
+
+    def is_none_type(type_: Any) -> bool:
+        return type_ in NONE_TYPES
+
+elif sys.version_info[:2] == (3, 8):
+
+    def is_none_type(type_: Any) -> bool:
+        for none_type in NONE_TYPES:
+            if type_ is none_type:
+                return True
+        # With python 3.8, specifically 3.8.10, Literal "is" check sare very flakey
+        # can change on very subtle changes like use of types in other modules,
+        # hopefully this check avoids that issue.
+        if is_literal_type(type_):  # pragma: no cover
+            return all_literal_values(type_) == (None,)
+        return False
+
+else:
+
+    def is_none_type(type_: Any) -> bool:
+        return type_ in NONE_TYPES
+
+
+def display_as_type(v: Type[Any]) -> str:
+    if not isinstance(v, typing_base) and not isinstance(v, WithArgsTypes) and not isinstance(v, type):
+        v = v.__class__
+
+    if is_union(get_origin(v)):
+        return f'Union[{", ".join(map(display_as_type, get_args(v)))}]'
+
+    if isinstance(v, WithArgsTypes):
+        # Generic alias are constructs like `list[int]`
+        return str(v).replace('typing.', '')
+
+    try:
+        return v.__name__
+    except AttributeError:
+        # happens with typing objects
+        return str(v).replace('typing.', '')
+
+
+def resolve_annotations(raw_annotations: Dict[str, Type[Any]], module_name: Optional[str]) -> Dict[str, Type[Any]]:
+    """
+    Partially taken from typing.get_type_hints.
+
+    Resolve string or ForwardRef annotations into type objects if possible.
+    """
+    base_globals: Optional[Dict[str, Any]] = None
+    if module_name:
+        try:
+            module = sys.modules[module_name]
+        except KeyError:
+            # happens occasionally, see https://github.com/pydantic/pydantic/issues/2363
+            pass
+        else:
+            base_globals = module.__dict__
+
+    annotations = {}
+    for name, value in raw_annotations.items():
+        if isinstance(value, str):
+            if (3, 10) > sys.version_info >= (3, 9, 8) or sys.version_info >= (3, 10, 1):
+                value = ForwardRef(value, is_argument=False, is_class=True)
+            else:
+                value = ForwardRef(value, is_argument=False)
+        try:
+            value = _eval_type(value, base_globals, None)
+        except NameError:
+            # this is ok, it can be fixed with update_forward_refs
+            pass
+        annotations[name] = value
+    return annotations
+
+
+def is_callable_type(type_: Type[Any]) -> bool:
+    return type_ is Callable or get_origin(type_) is Callable
+
+
+def is_literal_type(type_: Type[Any]) -> bool:
+    return Literal is not None and get_origin(type_) in LITERAL_TYPES
+
+
+def literal_values(type_: Type[Any]) -> Tuple[Any, ...]:
+    return get_args(type_)
+
+
+def all_literal_values(type_: Type[Any]) -> Tuple[Any, ...]:
+    """
+    This method is used to retrieve all Literal values as
+    Literal can be used recursively (see https://www.python.org/dev/peps/pep-0586)
+    e.g. `Literal[Literal[Literal[1, 2, 3], "foo"], 5, None]`
+    """
+    if not is_literal_type(type_):
+        return (type_,)
+
+    values = literal_values(type_)
+    return tuple(x for value in values for x in all_literal_values(value))
+
+
+def is_namedtuple(type_: Type[Any]) -> bool:
+    """
+    Check if a given class is a named tuple.
+    It can be either a `typing.NamedTuple` or `collections.namedtuple`
+    """
+    from .utils import lenient_issubclass
+
+    return lenient_issubclass(type_, tuple) and hasattr(type_, '_fields')
+
+
+def is_typeddict(type_: Type[Any]) -> bool:
+    """
+    Check if a given class is a typed dict (from `typing` or `typing_extensions`)
+    In 3.10, there will be a public method (https://docs.python.org/3.10/library/typing.html#typing.is_typeddict)
+    """
+    from .utils import lenient_issubclass
+
+    return lenient_issubclass(type_, dict) and hasattr(type_, '__total__')
+
+
+def _check_typeddict_special(type_: Any) -> bool:
+    return type_ is TypedDictRequired or type_ is TypedDictNotRequired
+
+
+def is_typeddict_special(type_: Any) -> bool:
+    """
+    Check if type is a TypedDict special form (Required or NotRequired).
+    """
+    return _check_typeddict_special(type_) or _check_typeddict_special(get_origin(type_))
+
+
+test_type = NewType('test_type', str)
+
+
+def is_new_type(type_: Type[Any]) -> bool:
+    """
+    Check whether type_ was created using typing.NewType
+    """
+    return isinstance(type_, test_type.__class__) and hasattr(type_, '__supertype__')  # type: ignore
+
+
+def new_type_supertype(type_: Type[Any]) -> Type[Any]:
+    while hasattr(type_, '__supertype__'):
+        type_ = type_.__supertype__
+    return type_
+
+
+def _check_classvar(v: Optional[Type[Any]]) -> bool:
+    if v is None:
+        return False
+
+    return v.__class__ == ClassVar.__class__ and getattr(v, '_name', None) == 'ClassVar'
+
+
+def _check_finalvar(v: Optional[Type[Any]]) -> bool:
+    """
+    Check if a given type is a `typing.Final` type.
+    """
+    if v is None:
+        return False
+
+    return v.__class__ == Final.__class__ and (sys.version_info < (3, 8) or getattr(v, '_name', None) == 'Final')
+
+
+def is_classvar(ann_type: Type[Any]) -> bool:
+    if _check_classvar(ann_type) or _check_classvar(get_origin(ann_type)):
+        return True
+
+    # this is an ugly workaround for class vars that contain forward references and are therefore themselves
+    # forward references, see #3679
+    if ann_type.__class__ == ForwardRef and ann_type.__forward_arg__.startswith('ClassVar['):
+        return True
+
+    return False
+
+
+def is_finalvar(ann_type: Type[Any]) -> bool:
+    return _check_finalvar(ann_type) or _check_finalvar(get_origin(ann_type))
+
+
+def update_field_forward_refs(field: 'ModelField', globalns: Any, localns: Any) -> None:
+    """
+    Try to update ForwardRefs on fields based on this ModelField, globalns and localns.
+    """
+    prepare = False
+    if field.type_.__class__ == ForwardRef:
+        prepare = True
+        field.type_ = evaluate_forwardref(field.type_, globalns, localns or None)
+    if field.outer_type_.__class__ == ForwardRef:
+        prepare = True
+        field.outer_type_ = evaluate_forwardref(field.outer_type_, globalns, localns or None)
+    if prepare:
+        field.prepare()
+
+    if field.sub_fields:
+        for sub_f in field.sub_fields:
+            update_field_forward_refs(sub_f, globalns=globalns, localns=localns)
+
+    if field.discriminator_key is not None:
+        field.prepare_discriminated_union_sub_fields()
+
+
+def update_model_forward_refs(
+    model: Type[Any],
+    fields: Iterable['ModelField'],
+    json_encoders: Dict[Union[Type[Any], str, ForwardRef], AnyCallable],
+    localns: 'DictStrAny',
+    exc_to_suppress: Tuple[Type[BaseException], ...] = (),
+) -> None:
+    """
+    Try to update model fields ForwardRefs based on model and localns.
+    """
+    if model.__module__ in sys.modules:
+        globalns = sys.modules[model.__module__].__dict__.copy()
+    else:
+        globalns = {}
+
+    globalns.setdefault(model.__name__, model)
+
+    for f in fields:
+        try:
+            update_field_forward_refs(f, globalns=globalns, localns=localns)
+        except exc_to_suppress:
+            pass
+
+    for key in set(json_encoders.keys()):
+        if isinstance(key, str):
+            fr: ForwardRef = ForwardRef(key)
+        elif isinstance(key, ForwardRef):
+            fr = key
+        else:
+            continue
+
+        try:
+            new_key = evaluate_forwardref(fr, globalns, localns or None)
+        except exc_to_suppress:  # pragma: no cover
+            continue
+
+        json_encoders[new_key] = json_encoders.pop(key)
+
+
+def get_class(type_: Type[Any]) -> Union[None, bool, Type[Any]]:
+    """
+    Tries to get the class of a Type[T] annotation. Returns True if Type is used
+    without brackets. Otherwise returns None.
+    """
+    if type_ is type:
+        return True
+
+    if get_origin(type_) is None:
+        return None
+
+    args = get_args(type_)
+    if not args or not isinstance(args[0], type):
+        return True
+    else:
+        return args[0]
+
+
+def get_sub_types(tp: Any) -> List[Any]:
+    """
+    Return all the types that are allowed by type `tp`
+    `tp` can be a `Union` of allowed types or an `Annotated` type
+    """
+    origin = get_origin(tp)
+    if origin is Annotated:
+        return get_sub_types(get_args(tp)[0])
+    elif is_union(origin):
+        return [x for t in get_args(tp) for x in get_sub_types(t)]
+    else:
+        return [tp]
diff --git a/lib/pydantic/v1/utils.py b/lib/pydantic/v1/utils.py
new file mode 100644
index 00000000..4d0f68ed
--- /dev/null
+++ b/lib/pydantic/v1/utils.py
@@ -0,0 +1,803 @@
+import keyword
+import warnings
+import weakref
+from collections import OrderedDict, defaultdict, deque
+from copy import deepcopy
+from itertools import islice, zip_longest
+from types import BuiltinFunctionType, CodeType, FunctionType, GeneratorType, LambdaType, ModuleType
+from typing import (
+    TYPE_CHECKING,
+    AbstractSet,
+    Any,
+    Callable,
+    Collection,
+    Dict,
+    Generator,
+    Iterable,
+    Iterator,
+    List,
+    Mapping,
+    NoReturn,
+    Optional,
+    Set,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+)
+
+from typing_extensions import Annotated
+
+from .errors import ConfigError
+from .typing import (
+    NoneType,
+    WithArgsTypes,
+    all_literal_values,
+    display_as_type,
+    get_args,
+    get_origin,
+    is_literal_type,
+    is_union,
+)
+from .version import version_info
+
+if TYPE_CHECKING:
+    from inspect import Signature
+    from pathlib import Path
+
+    from .config import BaseConfig
+    from .dataclasses import Dataclass
+    from .fields import ModelField
+    from .main import BaseModel
+    from .typing import AbstractSetIntStr, DictIntStrAny, IntStr, MappingIntStrAny, ReprArgs
+
+    RichReprResult = Iterable[Union[Any, Tuple[Any], Tuple[str, Any], Tuple[str, Any, Any]]]
+
+__all__ = (
+    'import_string',
+    'sequence_like',
+    'validate_field_name',
+    'lenient_isinstance',
+    'lenient_issubclass',
+    'in_ipython',
+    'is_valid_identifier',
+    'deep_update',
+    'update_not_none',
+    'almost_equal_floats',
+    'get_model',
+    'to_camel',
+    'is_valid_field',
+    'smart_deepcopy',
+    'PyObjectStr',
+    'Representation',
+    'GetterDict',
+    'ValueItems',
+    'version_info',  # required here to match behaviour in v1.3
+    'ClassAttribute',
+    'path_type',
+    'ROOT_KEY',
+    'get_unique_discriminator_alias',
+    'get_discriminator_alias_and_values',
+    'DUNDER_ATTRIBUTES',
+)
+
+ROOT_KEY = '__root__'
+# these are types that are returned unchanged by deepcopy
+IMMUTABLE_NON_COLLECTIONS_TYPES: Set[Type[Any]] = {
+    int,
+    float,
+    complex,
+    str,
+    bool,
+    bytes,
+    type,
+    NoneType,
+    FunctionType,
+    BuiltinFunctionType,
+    LambdaType,
+    weakref.ref,
+    CodeType,
+    # note: including ModuleType will differ from behaviour of deepcopy by not producing error.
+    # It might be not a good idea in general, but considering that this function used only internally
+    # against default values of fields, this will allow to actually have a field with module as default value
+    ModuleType,
+    NotImplemented.__class__,
+    Ellipsis.__class__,
+}
+
+# these are types that if empty, might be copied with simple copy() instead of deepcopy()
+BUILTIN_COLLECTIONS: Set[Type[Any]] = {
+    list,
+    set,
+    tuple,
+    frozenset,
+    dict,
+    OrderedDict,
+    defaultdict,
+    deque,
+}
+
+
+def import_string(dotted_path: str) -> Any:
+    """
+    Stolen approximately from django. Import a dotted module path and return the attribute/class designated by the
+    last name in the path. Raise ImportError if the import fails.
+    """
+    from importlib import import_module
+
+    try:
+        module_path, class_name = dotted_path.strip(' ').rsplit('.', 1)
+    except ValueError as e:
+        raise ImportError(f'"{dotted_path}" doesn\'t look like a module path') from e
+
+    module = import_module(module_path)
+    try:
+        return getattr(module, class_name)
+    except AttributeError as e:
+        raise ImportError(f'Module "{module_path}" does not define a "{class_name}" attribute') from e
+
+
+def truncate(v: Union[str], *, max_len: int = 80) -> str:
+    """
+    Truncate a value and add a unicode ellipsis (three dots) to the end if it was too long
+    """
+    warnings.warn('`truncate` is no-longer used by pydantic and is deprecated', DeprecationWarning)
+    if isinstance(v, str) and len(v) > (max_len - 2):
+        # -3 so quote + string + … + quote has correct length
+        return (v[: (max_len - 3)] + '…').__repr__()
+    try:
+        v = v.__repr__()
+    except TypeError:
+        v = v.__class__.__repr__(v)  # in case v is a type
+    if len(v) > max_len:
+        v = v[: max_len - 1] + '…'
+    return v
+
+
+def sequence_like(v: Any) -> bool:
+    return isinstance(v, (list, tuple, set, frozenset, GeneratorType, deque))
+
+
+def validate_field_name(bases: List[Type['BaseModel']], field_name: str) -> None:
+    """
+    Ensure that the field's name does not shadow an existing attribute of the model.
+    """
+    for base in bases:
+        if getattr(base, field_name, None):
+            raise NameError(
+                f'Field name "{field_name}" shadows a BaseModel attribute; '
+                f'use a different field name with "alias=\'{field_name}\'".'
+            )
+
+
+def lenient_isinstance(o: Any, class_or_tuple: Union[Type[Any], Tuple[Type[Any], ...], None]) -> bool:
+    try:
+        return isinstance(o, class_or_tuple)  # type: ignore[arg-type]
+    except TypeError:
+        return False
+
+
+def lenient_issubclass(cls: Any, class_or_tuple: Union[Type[Any], Tuple[Type[Any], ...], None]) -> bool:
+    try:
+        return isinstance(cls, type) and issubclass(cls, class_or_tuple)  # type: ignore[arg-type]
+    except TypeError:
+        if isinstance(cls, WithArgsTypes):
+            return False
+        raise  # pragma: no cover
+
+
+def in_ipython() -> bool:
+    """
+    Check whether we're in an ipython environment, including jupyter notebooks.
+    """
+    try:
+        eval('__IPYTHON__')
+    except NameError:
+        return False
+    else:  # pragma: no cover
+        return True
+
+
+def is_valid_identifier(identifier: str) -> bool:
+    """
+    Checks that a string is a valid identifier and not a Python keyword.
+    :param identifier: The identifier to test.
+    :return: True if the identifier is valid.
+    """
+    return identifier.isidentifier() and not keyword.iskeyword(identifier)
+
+
+KeyType = TypeVar('KeyType')
+
+
+def deep_update(mapping: Dict[KeyType, Any], *updating_mappings: Dict[KeyType, Any]) -> Dict[KeyType, Any]:
+    updated_mapping = mapping.copy()
+    for updating_mapping in updating_mappings:
+        for k, v in updating_mapping.items():
+            if k in updated_mapping and isinstance(updated_mapping[k], dict) and isinstance(v, dict):
+                updated_mapping[k] = deep_update(updated_mapping[k], v)
+            else:
+                updated_mapping[k] = v
+    return updated_mapping
+
+
+def update_not_none(mapping: Dict[Any, Any], **update: Any) -> None:
+    mapping.update({k: v for k, v in update.items() if v is not None})
+
+
+def almost_equal_floats(value_1: float, value_2: float, *, delta: float = 1e-8) -> bool:
+    """
+    Return True if two floats are almost equal
+    """
+    return abs(value_1 - value_2) <= delta
+
+
+def generate_model_signature(
+    init: Callable[..., None], fields: Dict[str, 'ModelField'], config: Type['BaseConfig']
+) -> 'Signature':
+    """
+    Generate signature for model based on its fields
+    """
+    from inspect import Parameter, Signature, signature
+
+    from .config import Extra
+
+    present_params = signature(init).parameters.values()
+    merged_params: Dict[str, Parameter] = {}
+    var_kw = None
+    use_var_kw = False
+
+    for param in islice(present_params, 1, None):  # skip self arg
+        if param.kind is param.VAR_KEYWORD:
+            var_kw = param
+            continue
+        merged_params[param.name] = param
+
+    if var_kw:  # if custom init has no var_kw, fields which are not declared in it cannot be passed through
+        allow_names = config.allow_population_by_field_name
+        for field_name, field in fields.items():
+            param_name = field.alias
+            if field_name in merged_params or param_name in merged_params:
+                continue
+            elif not is_valid_identifier(param_name):
+                if allow_names and is_valid_identifier(field_name):
+                    param_name = field_name
+                else:
+                    use_var_kw = True
+                    continue
+
+            # TODO: replace annotation with actual expected types once #1055 solved
+            kwargs = {'default': field.default} if not field.required else {}
+            merged_params[param_name] = Parameter(
+                param_name, Parameter.KEYWORD_ONLY, annotation=field.annotation, **kwargs
+            )
+
+    if config.extra is Extra.allow:
+        use_var_kw = True
+
+    if var_kw and use_var_kw:
+        # Make sure the parameter for extra kwargs
+        # does not have the same name as a field
+        default_model_signature = [
+            ('__pydantic_self__', Parameter.POSITIONAL_OR_KEYWORD),
+            ('data', Parameter.VAR_KEYWORD),
+        ]
+        if [(p.name, p.kind) for p in present_params] == default_model_signature:
+            # if this is the standard model signature, use extra_data as the extra args name
+            var_kw_name = 'extra_data'
+        else:
+            # else start from var_kw
+            var_kw_name = var_kw.name
+
+        # generate a name that's definitely unique
+        while var_kw_name in fields:
+            var_kw_name += '_'
+        merged_params[var_kw_name] = var_kw.replace(name=var_kw_name)
+
+    return Signature(parameters=list(merged_params.values()), return_annotation=None)
+
+
+def get_model(obj: Union[Type['BaseModel'], Type['Dataclass']]) -> Type['BaseModel']:
+    from .main import BaseModel
+
+    try:
+        model_cls = obj.__pydantic_model__  # type: ignore
+    except AttributeError:
+        model_cls = obj
+
+    if not issubclass(model_cls, BaseModel):
+        raise TypeError('Unsupported type, must be either BaseModel or dataclass')
+    return model_cls
+
+
+def to_camel(string: str) -> str:
+    return ''.join(word.capitalize() for word in string.split('_'))
+
+
+def to_lower_camel(string: str) -> str:
+    if len(string) >= 1:
+        pascal_string = to_camel(string)
+        return pascal_string[0].lower() + pascal_string[1:]
+    return string.lower()
+
+
+T = TypeVar('T')
+
+
+def unique_list(
+    input_list: Union[List[T], Tuple[T, ...]],
+    *,
+    name_factory: Callable[[T], str] = str,
+) -> List[T]:
+    """
+    Make a list unique while maintaining order.
+    We update the list if another one with the same name is set
+    (e.g. root validator overridden in subclass)
+    """
+    result: List[T] = []
+    result_names: List[str] = []
+    for v in input_list:
+        v_name = name_factory(v)
+        if v_name not in result_names:
+            result_names.append(v_name)
+            result.append(v)
+        else:
+            result[result_names.index(v_name)] = v
+
+    return result
+
+
+class PyObjectStr(str):
+    """
+    String class where repr doesn't include quotes. Useful with Representation when you want to return a string
+    representation of something that valid (or pseudo-valid) python.
+    """
+
+    def __repr__(self) -> str:
+        return str(self)
+
+
+class Representation:
+    """
+    Mixin to provide __str__, __repr__, and __pretty__ methods. See #884 for more details.
+
+    __pretty__ is used by [devtools](https://python-devtools.helpmanual.io/) to provide human readable representations
+    of objects.
+    """
+
+    __slots__: Tuple[str, ...] = tuple()
+
+    def __repr_args__(self) -> 'ReprArgs':
+        """
+        Returns the attributes to show in __str__, __repr__, and __pretty__ this is generally overridden.
+
+        Can either return:
+        * name - value pairs, e.g.: `[('foo_name', 'foo'), ('bar_name', ['b', 'a', 'r'])]`
+        * or, just values, e.g.: `[(None, 'foo'), (None, ['b', 'a', 'r'])]`
+        """
+        attrs = ((s, getattr(self, s)) for s in self.__slots__)
+        return [(a, v) for a, v in attrs if v is not None]
+
+    def __repr_name__(self) -> str:
+        """
+        Name of the instance's class, used in __repr__.
+        """
+        return self.__class__.__name__
+
+    def __repr_str__(self, join_str: str) -> str:
+        return join_str.join(repr(v) if a is None else f'{a}={v!r}' for a, v in self.__repr_args__())
+
+    def __pretty__(self, fmt: Callable[[Any], Any], **kwargs: Any) -> Generator[Any, None, None]:
+        """
+        Used by devtools (https://python-devtools.helpmanual.io/) to provide a human readable representations of objects
+        """
+        yield self.__repr_name__() + '('
+        yield 1
+        for name, value in self.__repr_args__():
+            if name is not None:
+                yield name + '='
+            yield fmt(value)
+            yield ','
+            yield 0
+        yield -1
+        yield ')'
+
+    def __str__(self) -> str:
+        return self.__repr_str__(' ')
+
+    def __repr__(self) -> str:
+        return f'{self.__repr_name__()}({self.__repr_str__(", ")})'
+
+    def __rich_repr__(self) -> 'RichReprResult':
+        """Get fields for Rich library"""
+        for name, field_repr in self.__repr_args__():
+            if name is None:
+                yield field_repr
+            else:
+                yield name, field_repr
+
+
+class GetterDict(Representation):
+    """
+    Hack to make object's smell just enough like dicts for validate_model.
+
+    We can't inherit from Mapping[str, Any] because it upsets cython so we have to implement all methods ourselves.
+    """
+
+    __slots__ = ('_obj',)
+
+    def __init__(self, obj: Any):
+        self._obj = obj
+
+    def __getitem__(self, key: str) -> Any:
+        try:
+            return getattr(self._obj, key)
+        except AttributeError as e:
+            raise KeyError(key) from e
+
+    def get(self, key: Any, default: Any = None) -> Any:
+        return getattr(self._obj, key, default)
+
+    def extra_keys(self) -> Set[Any]:
+        """
+        We don't want to get any other attributes of obj if the model didn't explicitly ask for them
+        """
+        return set()
+
+    def keys(self) -> List[Any]:
+        """
+        Keys of the pseudo dictionary, uses a list not set so order information can be maintained like python
+        dictionaries.
+        """
+        return list(self)
+
+    def values(self) -> List[Any]:
+        return [self[k] for k in self]
+
+    def items(self) -> Iterator[Tuple[str, Any]]:
+        for k in self:
+            yield k, self.get(k)
+
+    def __iter__(self) -> Iterator[str]:
+        for name in dir(self._obj):
+            if not name.startswith('_'):
+                yield name
+
+    def __len__(self) -> int:
+        return sum(1 for _ in self)
+
+    def __contains__(self, item: Any) -> bool:
+        return item in self.keys()
+
+    def __eq__(self, other: Any) -> bool:
+        return dict(self) == dict(other.items())
+
+    def __repr_args__(self) -> 'ReprArgs':
+        return [(None, dict(self))]
+
+    def __repr_name__(self) -> str:
+        return f'GetterDict[{display_as_type(self._obj)}]'
+
+
+class ValueItems(Representation):
+    """
+    Class for more convenient calculation of excluded or included fields on values.
+    """
+
+    __slots__ = ('_items', '_type')
+
+    def __init__(self, value: Any, items: Union['AbstractSetIntStr', 'MappingIntStrAny']) -> None:
+        items = self._coerce_items(items)
+
+        if isinstance(value, (list, tuple)):
+            items = self._normalize_indexes(items, len(value))
+
+        self._items: 'MappingIntStrAny' = items
+
+    def is_excluded(self, item: Any) -> bool:
+        """
+        Check if item is fully excluded.
+
+        :param item: key or index of a value
+        """
+        return self.is_true(self._items.get(item))
+
+    def is_included(self, item: Any) -> bool:
+        """
+        Check if value is contained in self._items
+
+        :param item: key or index of value
+        """
+        return item in self._items
+
+    def for_element(self, e: 'IntStr') -> Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']]:
+        """
+        :param e: key or index of element on value
+        :return: raw values for element if self._items is dict and contain needed element
+        """
+
+        item = self._items.get(e)
+        return item if not self.is_true(item) else None
+
+    def _normalize_indexes(self, items: 'MappingIntStrAny', v_length: int) -> 'DictIntStrAny':
+        """
+        :param items: dict or set of indexes which will be normalized
+        :param v_length: length of sequence indexes of which will be
+
+        >>> self._normalize_indexes({0: True, -2: True, -1: True}, 4)
+        {0: True, 2: True, 3: True}
+        >>> self._normalize_indexes({'__all__': True}, 4)
+        {0: True, 1: True, 2: True, 3: True}
+        """
+
+        normalized_items: 'DictIntStrAny' = {}
+        all_items = None
+        for i, v in items.items():
+            if not (isinstance(v, Mapping) or isinstance(v, AbstractSet) or self.is_true(v)):
+                raise TypeError(f'Unexpected type of exclude value for index "{i}" {v.__class__}')
+            if i == '__all__':
+                all_items = self._coerce_value(v)
+                continue
+            if not isinstance(i, int):
+                raise TypeError(
+                    'Excluding fields from a sequence of sub-models or dicts must be performed index-wise: '
+                    'expected integer keys or keyword "__all__"'
+                )
+            normalized_i = v_length + i if i < 0 else i
+            normalized_items[normalized_i] = self.merge(v, normalized_items.get(normalized_i))
+
+        if not all_items:
+            return normalized_items
+        if self.is_true(all_items):
+            for i in range(v_length):
+                normalized_items.setdefault(i, ...)
+            return normalized_items
+        for i in range(v_length):
+            normalized_item = normalized_items.setdefault(i, {})
+            if not self.is_true(normalized_item):
+                normalized_items[i] = self.merge(all_items, normalized_item)
+        return normalized_items
+
+    @classmethod
+    def merge(cls, base: Any, override: Any, intersect: bool = False) -> Any:
+        """
+        Merge a ``base`` item with an ``override`` item.
+
+        Both ``base`` and ``override`` are converted to dictionaries if possible.
+        Sets are converted to dictionaries with the sets entries as keys and
+        Ellipsis as values.
+
+        Each key-value pair existing in ``base`` is merged with ``override``,
+        while the rest of the key-value pairs are updated recursively with this function.
+
+        Merging takes place based on the "union" of keys if ``intersect`` is
+        set to ``False`` (default) and on the intersection of keys if
+        ``intersect`` is set to ``True``.
+        """
+        override = cls._coerce_value(override)
+        base = cls._coerce_value(base)
+        if override is None:
+            return base
+        if cls.is_true(base) or base is None:
+            return override
+        if cls.is_true(override):
+            return base if intersect else override
+
+        # intersection or union of keys while preserving ordering:
+        if intersect:
+            merge_keys = [k for k in base if k in override] + [k for k in override if k in base]
+        else:
+            merge_keys = list(base) + [k for k in override if k not in base]
+
+        merged: 'DictIntStrAny' = {}
+        for k in merge_keys:
+            merged_item = cls.merge(base.get(k), override.get(k), intersect=intersect)
+            if merged_item is not None:
+                merged[k] = merged_item
+
+        return merged
+
+    @staticmethod
+    def _coerce_items(items: Union['AbstractSetIntStr', 'MappingIntStrAny']) -> 'MappingIntStrAny':
+        if isinstance(items, Mapping):
+            pass
+        elif isinstance(items, AbstractSet):
+            items = dict.fromkeys(items, ...)
+        else:
+            class_name = getattr(items, '__class__', '???')
+            assert_never(
+                items,
+                f'Unexpected type of exclude value {class_name}',
+            )
+        return items
+
+    @classmethod
+    def _coerce_value(cls, value: Any) -> Any:
+        if value is None or cls.is_true(value):
+            return value
+        return cls._coerce_items(value)
+
+    @staticmethod
+    def is_true(v: Any) -> bool:
+        return v is True or v is ...
+
+    def __repr_args__(self) -> 'ReprArgs':
+        return [(None, self._items)]
+
+
+class ClassAttribute:
+    """
+    Hide class attribute from its instances
+    """
+
+    __slots__ = (
+        'name',
+        'value',
+    )
+
+    def __init__(self, name: str, value: Any) -> None:
+        self.name = name
+        self.value = value
+
+    def __get__(self, instance: Any, owner: Type[Any]) -> None:
+        if instance is None:
+            return self.value
+        raise AttributeError(f'{self.name!r} attribute of {owner.__name__!r} is class-only')
+
+
+path_types = {
+    'is_dir': 'directory',
+    'is_file': 'file',
+    'is_mount': 'mount point',
+    'is_symlink': 'symlink',
+    'is_block_device': 'block device',
+    'is_char_device': 'char device',
+    'is_fifo': 'FIFO',
+    'is_socket': 'socket',
+}
+
+
+def path_type(p: 'Path') -> str:
+    """
+    Find out what sort of thing a path is.
+    """
+    assert p.exists(), 'path does not exist'
+    for method, name in path_types.items():
+        if getattr(p, method)():
+            return name
+
+    return 'unknown'
+
+
+Obj = TypeVar('Obj')
+
+
+def smart_deepcopy(obj: Obj) -> Obj:
+    """
+    Return type as is for immutable built-in types
+    Use obj.copy() for built-in empty collections
+    Use copy.deepcopy() for non-empty collections and unknown objects
+    """
+
+    obj_type = obj.__class__
+    if obj_type in IMMUTABLE_NON_COLLECTIONS_TYPES:
+        return obj  # fastest case: obj is immutable and not collection therefore will not be copied anyway
+    try:
+        if not obj and obj_type in BUILTIN_COLLECTIONS:
+            # faster way for empty collections, no need to copy its members
+            return obj if obj_type is tuple else obj.copy()  # type: ignore  # tuple doesn't have copy method
+    except (TypeError, ValueError, RuntimeError):
+        # do we really dare to catch ALL errors? Seems a bit risky
+        pass
+
+    return deepcopy(obj)  # slowest way when we actually might need a deepcopy
+
+
+def is_valid_field(name: str) -> bool:
+    if not name.startswith('_'):
+        return True
+    return ROOT_KEY == name
+
+
+DUNDER_ATTRIBUTES = {
+    '__annotations__',
+    '__classcell__',
+    '__doc__',
+    '__module__',
+    '__orig_bases__',
+    '__orig_class__',
+    '__qualname__',
+}
+
+
+def is_valid_private_name(name: str) -> bool:
+    return not is_valid_field(name) and name not in DUNDER_ATTRIBUTES
+
+
+_EMPTY = object()
+
+
+def all_identical(left: Iterable[Any], right: Iterable[Any]) -> bool:
+    """
+    Check that the items of `left` are the same objects as those in `right`.
+
+    >>> a, b = object(), object()
+    >>> all_identical([a, b, a], [a, b, a])
+    True
+    >>> all_identical([a, b, [a]], [a, b, [a]])  # new list object, while "equal" is not "identical"
+    False
+    """
+    for left_item, right_item in zip_longest(left, right, fillvalue=_EMPTY):
+        if left_item is not right_item:
+            return False
+    return True
+
+
+def assert_never(obj: NoReturn, msg: str) -> NoReturn:
+    """
+    Helper to make sure that we have covered all possible types.
+
+    This is mostly useful for ``mypy``, docs:
+    https://mypy.readthedocs.io/en/latest/literal_types.html#exhaustive-checks
+    """
+    raise TypeError(msg)
+
+
+def get_unique_discriminator_alias(all_aliases: Collection[str], discriminator_key: str) -> str:
+    """Validate that all aliases are the same and if that's the case return the alias"""
+    unique_aliases = set(all_aliases)
+    if len(unique_aliases) > 1:
+        raise ConfigError(
+            f'Aliases for discriminator {discriminator_key!r} must be the same (got {", ".join(sorted(all_aliases))})'
+        )
+    return unique_aliases.pop()
+
+
+def get_discriminator_alias_and_values(tp: Any, discriminator_key: str) -> Tuple[str, Tuple[str, ...]]:
+    """
+    Get alias and all valid values in the `Literal` type of the discriminator field
+    `tp` can be a `BaseModel` class or directly an `Annotated` `Union` of many.
+    """
+    is_root_model = getattr(tp, '__custom_root_type__', False)
+
+    if get_origin(tp) is Annotated:
+        tp = get_args(tp)[0]
+
+    if hasattr(tp, '__pydantic_model__'):
+        tp = tp.__pydantic_model__
+
+    if is_union(get_origin(tp)):
+        alias, all_values = _get_union_alias_and_all_values(tp, discriminator_key)
+        return alias, tuple(v for values in all_values for v in values)
+    elif is_root_model:
+        union_type = tp.__fields__[ROOT_KEY].type_
+        alias, all_values = _get_union_alias_and_all_values(union_type, discriminator_key)
+
+        if len(set(all_values)) > 1:
+            raise ConfigError(
+                f'Field {discriminator_key!r} is not the same for all submodels of {display_as_type(tp)!r}'
+            )
+
+        return alias, all_values[0]
+
+    else:
+        try:
+            t_discriminator_type = tp.__fields__[discriminator_key].type_
+        except AttributeError as e:
+            raise TypeError(f'Type {tp.__name__!r} is not a valid `BaseModel` or `dataclass`') from e
+        except KeyError as e:
+            raise ConfigError(f'Model {tp.__name__!r} needs a discriminator field for key {discriminator_key!r}') from e
+
+        if not is_literal_type(t_discriminator_type):
+            raise ConfigError(f'Field {discriminator_key!r} of model {tp.__name__!r} needs to be a `Literal`')
+
+        return tp.__fields__[discriminator_key].alias, all_literal_values(t_discriminator_type)
+
+
+def _get_union_alias_and_all_values(
+    union_type: Type[Any], discriminator_key: str
+) -> Tuple[str, Tuple[Tuple[str, ...], ...]]:
+    zipped_aliases_values = [get_discriminator_alias_and_values(t, discriminator_key) for t in get_args(union_type)]
+    # unzip: [('alias_a',('v1', 'v2)), ('alias_b', ('v3',))] => [('alias_a', 'alias_b'), (('v1', 'v2'), ('v3',))]
+    all_aliases, all_values = zip(*zipped_aliases_values)
+    return get_unique_discriminator_alias(all_aliases, discriminator_key), all_values
diff --git a/lib/pydantic/v1/validators.py b/lib/pydantic/v1/validators.py
new file mode 100644
index 00000000..549a235e
--- /dev/null
+++ b/lib/pydantic/v1/validators.py
@@ -0,0 +1,765 @@
+import math
+import re
+from collections import OrderedDict, deque
+from collections.abc import Hashable as CollectionsHashable
+from datetime import date, datetime, time, timedelta
+from decimal import Decimal, DecimalException
+from enum import Enum, IntEnum
+from ipaddress import IPv4Address, IPv4Interface, IPv4Network, IPv6Address, IPv6Interface, IPv6Network
+from pathlib import Path
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    Deque,
+    Dict,
+    ForwardRef,
+    FrozenSet,
+    Generator,
+    Hashable,
+    List,
+    NamedTuple,
+    Pattern,
+    Set,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+)
+from uuid import UUID
+
+from . import errors
+from .datetime_parse import parse_date, parse_datetime, parse_duration, parse_time
+from .typing import (
+    AnyCallable,
+    all_literal_values,
+    display_as_type,
+    get_class,
+    is_callable_type,
+    is_literal_type,
+    is_namedtuple,
+    is_none_type,
+    is_typeddict,
+)
+from .utils import almost_equal_floats, lenient_issubclass, sequence_like
+
+if TYPE_CHECKING:
+    from typing_extensions import Literal, TypedDict
+
+    from .config import BaseConfig
+    from .fields import ModelField
+    from .types import ConstrainedDecimal, ConstrainedFloat, ConstrainedInt
+
+    ConstrainedNumber = Union[ConstrainedDecimal, ConstrainedFloat, ConstrainedInt]
+    AnyOrderedDict = OrderedDict[Any, Any]
+    Number = Union[int, float, Decimal]
+    StrBytes = Union[str, bytes]
+
+
+def str_validator(v: Any) -> Union[str]:
+    if isinstance(v, str):
+        if isinstance(v, Enum):
+            return v.value
+        else:
+            return v
+    elif isinstance(v, (float, int, Decimal)):
+        # is there anything else we want to add here? If you think so, create an issue.
+        return str(v)
+    elif isinstance(v, (bytes, bytearray)):
+        return v.decode()
+    else:
+        raise errors.StrError()
+
+
+def strict_str_validator(v: Any) -> Union[str]:
+    if isinstance(v, str) and not isinstance(v, Enum):
+        return v
+    raise errors.StrError()
+
+
+def bytes_validator(v: Any) -> Union[bytes]:
+    if isinstance(v, bytes):
+        return v
+    elif isinstance(v, bytearray):
+        return bytes(v)
+    elif isinstance(v, str):
+        return v.encode()
+    elif isinstance(v, (float, int, Decimal)):
+        return str(v).encode()
+    else:
+        raise errors.BytesError()
+
+
+def strict_bytes_validator(v: Any) -> Union[bytes]:
+    if isinstance(v, bytes):
+        return v
+    elif isinstance(v, bytearray):
+        return bytes(v)
+    else:
+        raise errors.BytesError()
+
+
+BOOL_FALSE = {0, '0', 'off', 'f', 'false', 'n', 'no'}
+BOOL_TRUE = {1, '1', 'on', 't', 'true', 'y', 'yes'}
+
+
+def bool_validator(v: Any) -> bool:
+    if v is True or v is False:
+        return v
+    if isinstance(v, bytes):
+        v = v.decode()
+    if isinstance(v, str):
+        v = v.lower()
+    try:
+        if v in BOOL_TRUE:
+            return True
+        if v in BOOL_FALSE:
+            return False
+    except TypeError:
+        raise errors.BoolError()
+    raise errors.BoolError()
+
+
+# matches the default limit cpython, see https://github.com/python/cpython/pull/96500
+max_str_int = 4_300
+
+
+def int_validator(v: Any) -> int:
+    if isinstance(v, int) and not (v is True or v is False):
+        return v
+
+    # see https://github.com/pydantic/pydantic/issues/1477 and in turn, https://github.com/python/cpython/issues/95778
+    # this check should be unnecessary once patch releases are out for 3.7, 3.8, 3.9 and 3.10
+    # but better to check here until then.
+    # NOTICE: this does not fully protect user from the DOS risk since the standard library JSON implementation
+    # (and other std lib modules like xml) use `int()` and are likely called before this, the best workaround is to
+    # 1. update to the latest patch release of python once released, 2. use a different JSON library like ujson
+    if isinstance(v, (str, bytes, bytearray)) and len(v) > max_str_int:
+        raise errors.IntegerError()
+
+    try:
+        return int(v)
+    except (TypeError, ValueError, OverflowError):
+        raise errors.IntegerError()
+
+
+def strict_int_validator(v: Any) -> int:
+    if isinstance(v, int) and not (v is True or v is False):
+        return v
+    raise errors.IntegerError()
+
+
+def float_validator(v: Any) -> float:
+    if isinstance(v, float):
+        return v
+
+    try:
+        return float(v)
+    except (TypeError, ValueError):
+        raise errors.FloatError()
+
+
+def strict_float_validator(v: Any) -> float:
+    if isinstance(v, float):
+        return v
+    raise errors.FloatError()
+
+
+def float_finite_validator(v: 'Number', field: 'ModelField', config: 'BaseConfig') -> 'Number':
+    allow_inf_nan = getattr(field.type_, 'allow_inf_nan', None)
+    if allow_inf_nan is None:
+        allow_inf_nan = config.allow_inf_nan
+
+    if allow_inf_nan is False and (math.isnan(v) or math.isinf(v)):
+        raise errors.NumberNotFiniteError()
+    return v
+
+
+def number_multiple_validator(v: 'Number', field: 'ModelField') -> 'Number':
+    field_type: ConstrainedNumber = field.type_
+    if field_type.multiple_of is not None:
+        mod = float(v) / float(field_type.multiple_of) % 1
+        if not almost_equal_floats(mod, 0.0) and not almost_equal_floats(mod, 1.0):
+            raise errors.NumberNotMultipleError(multiple_of=field_type.multiple_of)
+    return v
+
+
+def number_size_validator(v: 'Number', field: 'ModelField') -> 'Number':
+    field_type: ConstrainedNumber = field.type_
+    if field_type.gt is not None and not v > field_type.gt:
+        raise errors.NumberNotGtError(limit_value=field_type.gt)
+    elif field_type.ge is not None and not v >= field_type.ge:
+        raise errors.NumberNotGeError(limit_value=field_type.ge)
+
+    if field_type.lt is not None and not v < field_type.lt:
+        raise errors.NumberNotLtError(limit_value=field_type.lt)
+    if field_type.le is not None and not v <= field_type.le:
+        raise errors.NumberNotLeError(limit_value=field_type.le)
+
+    return v
+
+
+def constant_validator(v: 'Any', field: 'ModelField') -> 'Any':
+    """Validate ``const`` fields.
+
+    The value provided for a ``const`` field must be equal to the default value
+    of the field. This is to support the keyword of the same name in JSON
+    Schema.
+    """
+    if v != field.default:
+        raise errors.WrongConstantError(given=v, permitted=[field.default])
+
+    return v
+
+
+def anystr_length_validator(v: 'StrBytes', config: 'BaseConfig') -> 'StrBytes':
+    v_len = len(v)
+
+    min_length = config.min_anystr_length
+    if v_len < min_length:
+        raise errors.AnyStrMinLengthError(limit_value=min_length)
+
+    max_length = config.max_anystr_length
+    if max_length is not None and v_len > max_length:
+        raise errors.AnyStrMaxLengthError(limit_value=max_length)
+
+    return v
+
+
+def anystr_strip_whitespace(v: 'StrBytes') -> 'StrBytes':
+    return v.strip()
+
+
+def anystr_upper(v: 'StrBytes') -> 'StrBytes':
+    return v.upper()
+
+
+def anystr_lower(v: 'StrBytes') -> 'StrBytes':
+    return v.lower()
+
+
+def ordered_dict_validator(v: Any) -> 'AnyOrderedDict':
+    if isinstance(v, OrderedDict):
+        return v
+
+    try:
+        return OrderedDict(v)
+    except (TypeError, ValueError):
+        raise errors.DictError()
+
+
+def dict_validator(v: Any) -> Dict[Any, Any]:
+    if isinstance(v, dict):
+        return v
+
+    try:
+        return dict(v)
+    except (TypeError, ValueError):
+        raise errors.DictError()
+
+
+def list_validator(v: Any) -> List[Any]:
+    if isinstance(v, list):
+        return v
+    elif sequence_like(v):
+        return list(v)
+    else:
+        raise errors.ListError()
+
+
+def tuple_validator(v: Any) -> Tuple[Any, ...]:
+    if isinstance(v, tuple):
+        return v
+    elif sequence_like(v):
+        return tuple(v)
+    else:
+        raise errors.TupleError()
+
+
+def set_validator(v: Any) -> Set[Any]:
+    if isinstance(v, set):
+        return v
+    elif sequence_like(v):
+        return set(v)
+    else:
+        raise errors.SetError()
+
+
+def frozenset_validator(v: Any) -> FrozenSet[Any]:
+    if isinstance(v, frozenset):
+        return v
+    elif sequence_like(v):
+        return frozenset(v)
+    else:
+        raise errors.FrozenSetError()
+
+
+def deque_validator(v: Any) -> Deque[Any]:
+    if isinstance(v, deque):
+        return v
+    elif sequence_like(v):
+        return deque(v)
+    else:
+        raise errors.DequeError()
+
+
+def enum_member_validator(v: Any, field: 'ModelField', config: 'BaseConfig') -> Enum:
+    try:
+        enum_v = field.type_(v)
+    except ValueError:
+        # field.type_ should be an enum, so will be iterable
+        raise errors.EnumMemberError(enum_values=list(field.type_))
+    return enum_v.value if config.use_enum_values else enum_v
+
+
+def uuid_validator(v: Any, field: 'ModelField') -> UUID:
+    try:
+        if isinstance(v, str):
+            v = UUID(v)
+        elif isinstance(v, (bytes, bytearray)):
+            try:
+                v = UUID(v.decode())
+            except ValueError:
+                # 16 bytes in big-endian order as the bytes argument fail
+                # the above check
+                v = UUID(bytes=v)
+    except ValueError:
+        raise errors.UUIDError()
+
+    if not isinstance(v, UUID):
+        raise errors.UUIDError()
+
+    required_version = getattr(field.type_, '_required_version', None)
+    if required_version and v.version != required_version:
+        raise errors.UUIDVersionError(required_version=required_version)
+
+    return v
+
+
+def decimal_validator(v: Any) -> Decimal:
+    if isinstance(v, Decimal):
+        return v
+    elif isinstance(v, (bytes, bytearray)):
+        v = v.decode()
+
+    v = str(v).strip()
+
+    try:
+        v = Decimal(v)
+    except DecimalException:
+        raise errors.DecimalError()
+
+    if not v.is_finite():
+        raise errors.DecimalIsNotFiniteError()
+
+    return v
+
+
+def hashable_validator(v: Any) -> Hashable:
+    if isinstance(v, Hashable):
+        return v
+
+    raise errors.HashableError()
+
+
+def ip_v4_address_validator(v: Any) -> IPv4Address:
+    if isinstance(v, IPv4Address):
+        return v
+
+    try:
+        return IPv4Address(v)
+    except ValueError:
+        raise errors.IPv4AddressError()
+
+
+def ip_v6_address_validator(v: Any) -> IPv6Address:
+    if isinstance(v, IPv6Address):
+        return v
+
+    try:
+        return IPv6Address(v)
+    except ValueError:
+        raise errors.IPv6AddressError()
+
+
+def ip_v4_network_validator(v: Any) -> IPv4Network:
+    """
+    Assume IPv4Network initialised with a default ``strict`` argument
+
+    See more:
+    https://docs.python.org/library/ipaddress.html#ipaddress.IPv4Network
+    """
+    if isinstance(v, IPv4Network):
+        return v
+
+    try:
+        return IPv4Network(v)
+    except ValueError:
+        raise errors.IPv4NetworkError()
+
+
+def ip_v6_network_validator(v: Any) -> IPv6Network:
+    """
+    Assume IPv6Network initialised with a default ``strict`` argument
+
+    See more:
+    https://docs.python.org/library/ipaddress.html#ipaddress.IPv6Network
+    """
+    if isinstance(v, IPv6Network):
+        return v
+
+    try:
+        return IPv6Network(v)
+    except ValueError:
+        raise errors.IPv6NetworkError()
+
+
+def ip_v4_interface_validator(v: Any) -> IPv4Interface:
+    if isinstance(v, IPv4Interface):
+        return v
+
+    try:
+        return IPv4Interface(v)
+    except ValueError:
+        raise errors.IPv4InterfaceError()
+
+
+def ip_v6_interface_validator(v: Any) -> IPv6Interface:
+    if isinstance(v, IPv6Interface):
+        return v
+
+    try:
+        return IPv6Interface(v)
+    except ValueError:
+        raise errors.IPv6InterfaceError()
+
+
+def path_validator(v: Any) -> Path:
+    if isinstance(v, Path):
+        return v
+
+    try:
+        return Path(v)
+    except TypeError:
+        raise errors.PathError()
+
+
+def path_exists_validator(v: Any) -> Path:
+    if not v.exists():
+        raise errors.PathNotExistsError(path=v)
+
+    return v
+
+
+def callable_validator(v: Any) -> AnyCallable:
+    """
+    Perform a simple check if the value is callable.
+
+    Note: complete matching of argument type hints and return types is not performed
+    """
+    if callable(v):
+        return v
+
+    raise errors.CallableError(value=v)
+
+
+def enum_validator(v: Any) -> Enum:
+    if isinstance(v, Enum):
+        return v
+
+    raise errors.EnumError(value=v)
+
+
+def int_enum_validator(v: Any) -> IntEnum:
+    if isinstance(v, IntEnum):
+        return v
+
+    raise errors.IntEnumError(value=v)
+
+
+def make_literal_validator(type_: Any) -> Callable[[Any], Any]:
+    permitted_choices = all_literal_values(type_)
+
+    # To have a O(1) complexity and still return one of the values set inside the `Literal`,
+    # we create a dict with the set values (a set causes some problems with the way intersection works).
+    # In some cases the set value and checked value can indeed be different (see `test_literal_validator_str_enum`)
+    allowed_choices = {v: v for v in permitted_choices}
+
+    def literal_validator(v: Any) -> Any:
+        try:
+            return allowed_choices[v]
+        except (KeyError, TypeError):
+            raise errors.WrongConstantError(given=v, permitted=permitted_choices)
+
+    return literal_validator
+
+
+def constr_length_validator(v: 'StrBytes', field: 'ModelField', config: 'BaseConfig') -> 'StrBytes':
+    v_len = len(v)
+
+    min_length = field.type_.min_length if field.type_.min_length is not None else config.min_anystr_length
+    if v_len < min_length:
+        raise errors.AnyStrMinLengthError(limit_value=min_length)
+
+    max_length = field.type_.max_length if field.type_.max_length is not None else config.max_anystr_length
+    if max_length is not None and v_len > max_length:
+        raise errors.AnyStrMaxLengthError(limit_value=max_length)
+
+    return v
+
+
+def constr_strip_whitespace(v: 'StrBytes', field: 'ModelField', config: 'BaseConfig') -> 'StrBytes':
+    strip_whitespace = field.type_.strip_whitespace or config.anystr_strip_whitespace
+    if strip_whitespace:
+        v = v.strip()
+
+    return v
+
+
+def constr_upper(v: 'StrBytes', field: 'ModelField', config: 'BaseConfig') -> 'StrBytes':
+    upper = field.type_.to_upper or config.anystr_upper
+    if upper:
+        v = v.upper()
+
+    return v
+
+
+def constr_lower(v: 'StrBytes', field: 'ModelField', config: 'BaseConfig') -> 'StrBytes':
+    lower = field.type_.to_lower or config.anystr_lower
+    if lower:
+        v = v.lower()
+    return v
+
+
+def validate_json(v: Any, config: 'BaseConfig') -> Any:
+    if v is None:
+        # pass None through to other validators
+        return v
+    try:
+        return config.json_loads(v)  # type: ignore
+    except ValueError:
+        raise errors.JsonError()
+    except TypeError:
+        raise errors.JsonTypeError()
+
+
+T = TypeVar('T')
+
+
+def make_arbitrary_type_validator(type_: Type[T]) -> Callable[[T], T]:
+    def arbitrary_type_validator(v: Any) -> T:
+        if isinstance(v, type_):
+            return v
+        raise errors.ArbitraryTypeError(expected_arbitrary_type=type_)
+
+    return arbitrary_type_validator
+
+
+def make_class_validator(type_: Type[T]) -> Callable[[Any], Type[T]]:
+    def class_validator(v: Any) -> Type[T]:
+        if lenient_issubclass(v, type_):
+            return v
+        raise errors.SubclassError(expected_class=type_)
+
+    return class_validator
+
+
+def any_class_validator(v: Any) -> Type[T]:
+    if isinstance(v, type):
+        return v
+    raise errors.ClassError()
+
+
+def none_validator(v: Any) -> 'Literal[None]':
+    if v is None:
+        return v
+    raise errors.NotNoneError()
+
+
+def pattern_validator(v: Any) -> Pattern[str]:
+    if isinstance(v, Pattern):
+        return v
+
+    str_value = str_validator(v)
+
+    try:
+        return re.compile(str_value)
+    except re.error:
+        raise errors.PatternError()
+
+
+NamedTupleT = TypeVar('NamedTupleT', bound=NamedTuple)
+
+
+def make_namedtuple_validator(
+    namedtuple_cls: Type[NamedTupleT], config: Type['BaseConfig']
+) -> Callable[[Tuple[Any, ...]], NamedTupleT]:
+    from .annotated_types import create_model_from_namedtuple
+
+    NamedTupleModel = create_model_from_namedtuple(
+        namedtuple_cls,
+        __config__=config,
+        __module__=namedtuple_cls.__module__,
+    )
+    namedtuple_cls.__pydantic_model__ = NamedTupleModel  # type: ignore[attr-defined]
+
+    def namedtuple_validator(values: Tuple[Any, ...]) -> NamedTupleT:
+        annotations = NamedTupleModel.__annotations__
+
+        if len(values) > len(annotations):
+            raise errors.ListMaxLengthError(limit_value=len(annotations))
+
+        dict_values: Dict[str, Any] = dict(zip(annotations, values))
+        validated_dict_values: Dict[str, Any] = dict(NamedTupleModel(**dict_values))
+        return namedtuple_cls(**validated_dict_values)
+
+    return namedtuple_validator
+
+
+def make_typeddict_validator(
+    typeddict_cls: Type['TypedDict'], config: Type['BaseConfig']  # type: ignore[valid-type]
+) -> Callable[[Any], Dict[str, Any]]:
+    from .annotated_types import create_model_from_typeddict
+
+    TypedDictModel = create_model_from_typeddict(
+        typeddict_cls,
+        __config__=config,
+        __module__=typeddict_cls.__module__,
+    )
+    typeddict_cls.__pydantic_model__ = TypedDictModel  # type: ignore[attr-defined]
+
+    def typeddict_validator(values: 'TypedDict') -> Dict[str, Any]:  # type: ignore[valid-type]
+        return TypedDictModel.parse_obj(values).dict(exclude_unset=True)
+
+    return typeddict_validator
+
+
+class IfConfig:
+    def __init__(self, validator: AnyCallable, *config_attr_names: str, ignored_value: Any = False) -> None:
+        self.validator = validator
+        self.config_attr_names = config_attr_names
+        self.ignored_value = ignored_value
+
+    def check(self, config: Type['BaseConfig']) -> bool:
+        return any(getattr(config, name) not in {None, self.ignored_value} for name in self.config_attr_names)
+
+
+# order is important here, for example: bool is a subclass of int so has to come first, datetime before date same,
+# IPv4Interface before IPv4Address, etc
+_VALIDATORS: List[Tuple[Type[Any], List[Any]]] = [
+    (IntEnum, [int_validator, enum_member_validator]),
+    (Enum, [enum_member_validator]),
+    (
+        str,
+        [
+            str_validator,
+            IfConfig(anystr_strip_whitespace, 'anystr_strip_whitespace'),
+            IfConfig(anystr_upper, 'anystr_upper'),
+            IfConfig(anystr_lower, 'anystr_lower'),
+            IfConfig(anystr_length_validator, 'min_anystr_length', 'max_anystr_length'),
+        ],
+    ),
+    (
+        bytes,
+        [
+            bytes_validator,
+            IfConfig(anystr_strip_whitespace, 'anystr_strip_whitespace'),
+            IfConfig(anystr_upper, 'anystr_upper'),
+            IfConfig(anystr_lower, 'anystr_lower'),
+            IfConfig(anystr_length_validator, 'min_anystr_length', 'max_anystr_length'),
+        ],
+    ),
+    (bool, [bool_validator]),
+    (int, [int_validator]),
+    (float, [float_validator, IfConfig(float_finite_validator, 'allow_inf_nan', ignored_value=True)]),
+    (Path, [path_validator]),
+    (datetime, [parse_datetime]),
+    (date, [parse_date]),
+    (time, [parse_time]),
+    (timedelta, [parse_duration]),
+    (OrderedDict, [ordered_dict_validator]),
+    (dict, [dict_validator]),
+    (list, [list_validator]),
+    (tuple, [tuple_validator]),
+    (set, [set_validator]),
+    (frozenset, [frozenset_validator]),
+    (deque, [deque_validator]),
+    (UUID, [uuid_validator]),
+    (Decimal, [decimal_validator]),
+    (IPv4Interface, [ip_v4_interface_validator]),
+    (IPv6Interface, [ip_v6_interface_validator]),
+    (IPv4Address, [ip_v4_address_validator]),
+    (IPv6Address, [ip_v6_address_validator]),
+    (IPv4Network, [ip_v4_network_validator]),
+    (IPv6Network, [ip_v6_network_validator]),
+]
+
+
+def find_validators(  # noqa: C901 (ignore complexity)
+    type_: Type[Any], config: Type['BaseConfig']
+) -> Generator[AnyCallable, None, None]:
+    from .dataclasses import is_builtin_dataclass, make_dataclass_validator
+
+    if type_ is Any or type_ is object:
+        return
+    type_type = type_.__class__
+    if type_type == ForwardRef or type_type == TypeVar:
+        return
+
+    if is_none_type(type_):
+        yield none_validator
+        return
+    if type_ is Pattern or type_ is re.Pattern:
+        yield pattern_validator
+        return
+    if type_ is Hashable or type_ is CollectionsHashable:
+        yield hashable_validator
+        return
+    if is_callable_type(type_):
+        yield callable_validator
+        return
+    if is_literal_type(type_):
+        yield make_literal_validator(type_)
+        return
+    if is_builtin_dataclass(type_):
+        yield from make_dataclass_validator(type_, config)
+        return
+    if type_ is Enum:
+        yield enum_validator
+        return
+    if type_ is IntEnum:
+        yield int_enum_validator
+        return
+    if is_namedtuple(type_):
+        yield tuple_validator
+        yield make_namedtuple_validator(type_, config)
+        return
+    if is_typeddict(type_):
+        yield make_typeddict_validator(type_, config)
+        return
+
+    class_ = get_class(type_)
+    if class_ is not None:
+        if class_ is not Any and isinstance(class_, type):
+            yield make_class_validator(class_)
+        else:
+            yield any_class_validator
+        return
+
+    for val_type, validators in _VALIDATORS:
+        try:
+            if issubclass(type_, val_type):
+                for v in validators:
+                    if isinstance(v, IfConfig):
+                        if v.check(config):
+                            yield v.validator
+                    else:
+                        yield v
+                return
+        except TypeError:
+            raise RuntimeError(f'error checking inheritance of {type_!r} (type: {display_as_type(type_)})')
+
+    if config.arbitrary_types_allowed:
+        yield make_arbitrary_type_validator(type_)
+    else:
+        raise RuntimeError(f'no validator found for {type_}, see `arbitrary_types_allowed` in Config')
diff --git a/lib/pydantic/v1/version.py b/lib/pydantic/v1/version.py
new file mode 100644
index 00000000..ec982ba7
--- /dev/null
+++ b/lib/pydantic/v1/version.py
@@ -0,0 +1,38 @@
+__all__ = 'compiled', 'VERSION', 'version_info'
+
+VERSION = '1.10.14'
+
+try:
+    import cython  # type: ignore
+except ImportError:
+    compiled: bool = False
+else:  # pragma: no cover
+    try:
+        compiled = cython.compiled
+    except AttributeError:
+        compiled = False
+
+
+def version_info() -> str:
+    import platform
+    import sys
+    from importlib import import_module
+    from pathlib import Path
+
+    optional_deps = []
+    for p in ('devtools', 'dotenv', 'email-validator', 'typing-extensions'):
+        try:
+            import_module(p.replace('-', '_'))
+        except ImportError:
+            continue
+        optional_deps.append(p)
+
+    info = {
+        'pydantic version': VERSION,
+        'pydantic compiled': compiled,
+        'install path': Path(__file__).resolve().parent,
+        'python version': sys.version,
+        'platform': platform.platform(),
+        'optional deps. installed': optional_deps,
+    }
+    return '\n'.join('{:>30} {}'.format(k + ':', str(v).replace('\n', ' ')) for k, v in info.items())
diff --git a/lib/pydantic/validate_call_decorator.py b/lib/pydantic/validate_call_decorator.py
new file mode 100644
index 00000000..b95fa3b6
--- /dev/null
+++ b/lib/pydantic/validate_call_decorator.py
@@ -0,0 +1,67 @@
+"""Decorator for validating function calls."""
+from __future__ import annotations as _annotations
+
+import functools
+from typing import TYPE_CHECKING, Any, Callable, TypeVar, overload
+
+from ._internal import _validate_call
+
+__all__ = ('validate_call',)
+
+if TYPE_CHECKING:
+    from .config import ConfigDict
+
+    AnyCallableT = TypeVar('AnyCallableT', bound=Callable[..., Any])
+
+
+@overload
+def validate_call(
+    *, config: ConfigDict | None = None, validate_return: bool = False
+) -> Callable[[AnyCallableT], AnyCallableT]:
+    ...
+
+
+@overload
+def validate_call(__func: AnyCallableT) -> AnyCallableT:
+    ...
+
+
+def validate_call(
+    __func: AnyCallableT | None = None,
+    *,
+    config: ConfigDict | None = None,
+    validate_return: bool = False,
+) -> AnyCallableT | Callable[[AnyCallableT], AnyCallableT]:
+    """Usage docs: https://docs.pydantic.dev/2.6/concepts/validation_decorator/
+
+    Returns a decorated wrapper around the function that validates the arguments and, optionally, the return value.
+
+    Usage may be either as a plain decorator `@validate_call` or with arguments `@validate_call(...)`.
+
+    Args:
+        __func: The function to be decorated.
+        config: The configuration dictionary.
+        validate_return: Whether to validate the return value.
+
+    Returns:
+        The decorated function.
+    """
+
+    def validate(function: AnyCallableT) -> AnyCallableT:
+        if isinstance(function, (classmethod, staticmethod)):
+            name = type(function).__name__
+            raise TypeError(f'The `@{name}` decorator should be applied after `@validate_call` (put `@{name}` on top)')
+        validate_call_wrapper = _validate_call.ValidateCallWrapper(function, config, validate_return)
+
+        @functools.wraps(function)
+        def wrapper_function(*args, **kwargs):
+            return validate_call_wrapper(*args, **kwargs)
+
+        wrapper_function.raw_function = function  # type: ignore
+
+        return wrapper_function  # type: ignore
+
+    if __func:
+        return validate(__func)
+    else:
+        return validate
diff --git a/lib/pydantic/validators.py b/lib/pydantic/validators.py
index fb6d0418..55b0339e 100644
--- a/lib/pydantic/validators.py
+++ b/lib/pydantic/validators.py
@@ -1,765 +1,4 @@
-import math
-import re
-from collections import OrderedDict, deque
-from collections.abc import Hashable as CollectionsHashable
-from datetime import date, datetime, time, timedelta
-from decimal import Decimal, DecimalException
-from enum import Enum, IntEnum
-from ipaddress import IPv4Address, IPv4Interface, IPv4Network, IPv6Address, IPv6Interface, IPv6Network
-from pathlib import Path
-from typing import (
-    TYPE_CHECKING,
-    Any,
-    Callable,
-    Deque,
-    Dict,
-    ForwardRef,
-    FrozenSet,
-    Generator,
-    Hashable,
-    List,
-    NamedTuple,
-    Pattern,
-    Set,
-    Tuple,
-    Type,
-    TypeVar,
-    Union,
-)
-from uuid import UUID
+"""The `validators` module is a backport module from V1."""
+from ._migration import getattr_migration
 
-from . import errors
-from .datetime_parse import parse_date, parse_datetime, parse_duration, parse_time
-from .typing import (
-    AnyCallable,
-    all_literal_values,
-    display_as_type,
-    get_class,
-    is_callable_type,
-    is_literal_type,
-    is_namedtuple,
-    is_none_type,
-    is_typeddict,
-)
-from .utils import almost_equal_floats, lenient_issubclass, sequence_like
-
-if TYPE_CHECKING:
-    from typing_extensions import Literal, TypedDict
-
-    from .config import BaseConfig
-    from .fields import ModelField
-    from .types import ConstrainedDecimal, ConstrainedFloat, ConstrainedInt
-
-    ConstrainedNumber = Union[ConstrainedDecimal, ConstrainedFloat, ConstrainedInt]
-    AnyOrderedDict = OrderedDict[Any, Any]
-    Number = Union[int, float, Decimal]
-    StrBytes = Union[str, bytes]
-
-
-def str_validator(v: Any) -> Union[str]:
-    if isinstance(v, str):
-        if isinstance(v, Enum):
-            return v.value
-        else:
-            return v
-    elif isinstance(v, (float, int, Decimal)):
-        # is there anything else we want to add here? If you think so, create an issue.
-        return str(v)
-    elif isinstance(v, (bytes, bytearray)):
-        return v.decode()
-    else:
-        raise errors.StrError()
-
-
-def strict_str_validator(v: Any) -> Union[str]:
-    if isinstance(v, str) and not isinstance(v, Enum):
-        return v
-    raise errors.StrError()
-
-
-def bytes_validator(v: Any) -> Union[bytes]:
-    if isinstance(v, bytes):
-        return v
-    elif isinstance(v, bytearray):
-        return bytes(v)
-    elif isinstance(v, str):
-        return v.encode()
-    elif isinstance(v, (float, int, Decimal)):
-        return str(v).encode()
-    else:
-        raise errors.BytesError()
-
-
-def strict_bytes_validator(v: Any) -> Union[bytes]:
-    if isinstance(v, bytes):
-        return v
-    elif isinstance(v, bytearray):
-        return bytes(v)
-    else:
-        raise errors.BytesError()
-
-
-BOOL_FALSE = {0, '0', 'off', 'f', 'false', 'n', 'no'}
-BOOL_TRUE = {1, '1', 'on', 't', 'true', 'y', 'yes'}
-
-
-def bool_validator(v: Any) -> bool:
-    if v is True or v is False:
-        return v
-    if isinstance(v, bytes):
-        v = v.decode()
-    if isinstance(v, str):
-        v = v.lower()
-    try:
-        if v in BOOL_TRUE:
-            return True
-        if v in BOOL_FALSE:
-            return False
-    except TypeError:
-        raise errors.BoolError()
-    raise errors.BoolError()
-
-
-# matches the default limit cpython, see https://github.com/python/cpython/pull/96500
-max_str_int = 4_300
-
-
-def int_validator(v: Any) -> int:
-    if isinstance(v, int) and not (v is True or v is False):
-        return v
-
-    # see https://github.com/pydantic/pydantic/issues/1477 and in turn, https://github.com/python/cpython/issues/95778
-    # this check should be unnecessary once patch releases are out for 3.7, 3.8, 3.9 and 3.10
-    # but better to check here until then.
-    # NOTICE: this does not fully protect user from the DOS risk since the standard library JSON implementation
-    # (and other std lib modules like xml) use `int()` and are likely called before this, the best workaround is to
-    # 1. update to the latest patch release of python once released, 2. use a different JSON library like ujson
-    if isinstance(v, (str, bytes, bytearray)) and len(v) > max_str_int:
-        raise errors.IntegerError()
-
-    try:
-        return int(v)
-    except (TypeError, ValueError, OverflowError):
-        raise errors.IntegerError()
-
-
-def strict_int_validator(v: Any) -> int:
-    if isinstance(v, int) and not (v is True or v is False):
-        return v
-    raise errors.IntegerError()
-
-
-def float_validator(v: Any) -> float:
-    if isinstance(v, float):
-        return v
-
-    try:
-        return float(v)
-    except (TypeError, ValueError):
-        raise errors.FloatError()
-
-
-def strict_float_validator(v: Any) -> float:
-    if isinstance(v, float):
-        return v
-    raise errors.FloatError()
-
-
-def float_finite_validator(v: 'Number', field: 'ModelField', config: 'BaseConfig') -> 'Number':
-    allow_inf_nan = getattr(field.type_, 'allow_inf_nan', None)
-    if allow_inf_nan is None:
-        allow_inf_nan = config.allow_inf_nan
-
-    if allow_inf_nan is False and (math.isnan(v) or math.isinf(v)):
-        raise errors.NumberNotFiniteError()
-    return v
-
-
-def number_multiple_validator(v: 'Number', field: 'ModelField') -> 'Number':
-    field_type: ConstrainedNumber = field.type_
-    if field_type.multiple_of is not None:
-        mod = float(v) / float(field_type.multiple_of) % 1
-        if not almost_equal_floats(mod, 0.0) and not almost_equal_floats(mod, 1.0):
-            raise errors.NumberNotMultipleError(multiple_of=field_type.multiple_of)
-    return v
-
-
-def number_size_validator(v: 'Number', field: 'ModelField') -> 'Number':
-    field_type: ConstrainedNumber = field.type_
-    if field_type.gt is not None and not v > field_type.gt:
-        raise errors.NumberNotGtError(limit_value=field_type.gt)
-    elif field_type.ge is not None and not v >= field_type.ge:
-        raise errors.NumberNotGeError(limit_value=field_type.ge)
-
-    if field_type.lt is not None and not v < field_type.lt:
-        raise errors.NumberNotLtError(limit_value=field_type.lt)
-    if field_type.le is not None and not v <= field_type.le:
-        raise errors.NumberNotLeError(limit_value=field_type.le)
-
-    return v
-
-
-def constant_validator(v: 'Any', field: 'ModelField') -> 'Any':
-    """Validate ``const`` fields.
-
-    The value provided for a ``const`` field must be equal to the default value
-    of the field. This is to support the keyword of the same name in JSON
-    Schema.
-    """
-    if v != field.default:
-        raise errors.WrongConstantError(given=v, permitted=[field.default])
-
-    return v
-
-
-def anystr_length_validator(v: 'StrBytes', config: 'BaseConfig') -> 'StrBytes':
-    v_len = len(v)
-
-    min_length = config.min_anystr_length
-    if v_len < min_length:
-        raise errors.AnyStrMinLengthError(limit_value=min_length)
-
-    max_length = config.max_anystr_length
-    if max_length is not None and v_len > max_length:
-        raise errors.AnyStrMaxLengthError(limit_value=max_length)
-
-    return v
-
-
-def anystr_strip_whitespace(v: 'StrBytes') -> 'StrBytes':
-    return v.strip()
-
-
-def anystr_upper(v: 'StrBytes') -> 'StrBytes':
-    return v.upper()
-
-
-def anystr_lower(v: 'StrBytes') -> 'StrBytes':
-    return v.lower()
-
-
-def ordered_dict_validator(v: Any) -> 'AnyOrderedDict':
-    if isinstance(v, OrderedDict):
-        return v
-
-    try:
-        return OrderedDict(v)
-    except (TypeError, ValueError):
-        raise errors.DictError()
-
-
-def dict_validator(v: Any) -> Dict[Any, Any]:
-    if isinstance(v, dict):
-        return v
-
-    try:
-        return dict(v)
-    except (TypeError, ValueError):
-        raise errors.DictError()
-
-
-def list_validator(v: Any) -> List[Any]:
-    if isinstance(v, list):
-        return v
-    elif sequence_like(v):
-        return list(v)
-    else:
-        raise errors.ListError()
-
-
-def tuple_validator(v: Any) -> Tuple[Any, ...]:
-    if isinstance(v, tuple):
-        return v
-    elif sequence_like(v):
-        return tuple(v)
-    else:
-        raise errors.TupleError()
-
-
-def set_validator(v: Any) -> Set[Any]:
-    if isinstance(v, set):
-        return v
-    elif sequence_like(v):
-        return set(v)
-    else:
-        raise errors.SetError()
-
-
-def frozenset_validator(v: Any) -> FrozenSet[Any]:
-    if isinstance(v, frozenset):
-        return v
-    elif sequence_like(v):
-        return frozenset(v)
-    else:
-        raise errors.FrozenSetError()
-
-
-def deque_validator(v: Any) -> Deque[Any]:
-    if isinstance(v, deque):
-        return v
-    elif sequence_like(v):
-        return deque(v)
-    else:
-        raise errors.DequeError()
-
-
-def enum_member_validator(v: Any, field: 'ModelField', config: 'BaseConfig') -> Enum:
-    try:
-        enum_v = field.type_(v)
-    except ValueError:
-        # field.type_ should be an enum, so will be iterable
-        raise errors.EnumMemberError(enum_values=list(field.type_))
-    return enum_v.value if config.use_enum_values else enum_v
-
-
-def uuid_validator(v: Any, field: 'ModelField') -> UUID:
-    try:
-        if isinstance(v, str):
-            v = UUID(v)
-        elif isinstance(v, (bytes, bytearray)):
-            try:
-                v = UUID(v.decode())
-            except ValueError:
-                # 16 bytes in big-endian order as the bytes argument fail
-                # the above check
-                v = UUID(bytes=v)
-    except ValueError:
-        raise errors.UUIDError()
-
-    if not isinstance(v, UUID):
-        raise errors.UUIDError()
-
-    required_version = getattr(field.type_, '_required_version', None)
-    if required_version and v.version != required_version:
-        raise errors.UUIDVersionError(required_version=required_version)
-
-    return v
-
-
-def decimal_validator(v: Any) -> Decimal:
-    if isinstance(v, Decimal):
-        return v
-    elif isinstance(v, (bytes, bytearray)):
-        v = v.decode()
-
-    v = str(v).strip()
-
-    try:
-        v = Decimal(v)
-    except DecimalException:
-        raise errors.DecimalError()
-
-    if not v.is_finite():
-        raise errors.DecimalIsNotFiniteError()
-
-    return v
-
-
-def hashable_validator(v: Any) -> Hashable:
-    if isinstance(v, Hashable):
-        return v
-
-    raise errors.HashableError()
-
-
-def ip_v4_address_validator(v: Any) -> IPv4Address:
-    if isinstance(v, IPv4Address):
-        return v
-
-    try:
-        return IPv4Address(v)
-    except ValueError:
-        raise errors.IPv4AddressError()
-
-
-def ip_v6_address_validator(v: Any) -> IPv6Address:
-    if isinstance(v, IPv6Address):
-        return v
-
-    try:
-        return IPv6Address(v)
-    except ValueError:
-        raise errors.IPv6AddressError()
-
-
-def ip_v4_network_validator(v: Any) -> IPv4Network:
-    """
-    Assume IPv4Network initialised with a default ``strict`` argument
-
-    See more:
-    https://docs.python.org/library/ipaddress.html#ipaddress.IPv4Network
-    """
-    if isinstance(v, IPv4Network):
-        return v
-
-    try:
-        return IPv4Network(v)
-    except ValueError:
-        raise errors.IPv4NetworkError()
-
-
-def ip_v6_network_validator(v: Any) -> IPv6Network:
-    """
-    Assume IPv6Network initialised with a default ``strict`` argument
-
-    See more:
-    https://docs.python.org/library/ipaddress.html#ipaddress.IPv6Network
-    """
-    if isinstance(v, IPv6Network):
-        return v
-
-    try:
-        return IPv6Network(v)
-    except ValueError:
-        raise errors.IPv6NetworkError()
-
-
-def ip_v4_interface_validator(v: Any) -> IPv4Interface:
-    if isinstance(v, IPv4Interface):
-        return v
-
-    try:
-        return IPv4Interface(v)
-    except ValueError:
-        raise errors.IPv4InterfaceError()
-
-
-def ip_v6_interface_validator(v: Any) -> IPv6Interface:
-    if isinstance(v, IPv6Interface):
-        return v
-
-    try:
-        return IPv6Interface(v)
-    except ValueError:
-        raise errors.IPv6InterfaceError()
-
-
-def path_validator(v: Any) -> Path:
-    if isinstance(v, Path):
-        return v
-
-    try:
-        return Path(v)
-    except TypeError:
-        raise errors.PathError()
-
-
-def path_exists_validator(v: Any) -> Path:
-    if not v.exists():
-        raise errors.PathNotExistsError(path=v)
-
-    return v
-
-
-def callable_validator(v: Any) -> AnyCallable:
-    """
-    Perform a simple check if the value is callable.
-
-    Note: complete matching of argument type hints and return types is not performed
-    """
-    if callable(v):
-        return v
-
-    raise errors.CallableError(value=v)
-
-
-def enum_validator(v: Any) -> Enum:
-    if isinstance(v, Enum):
-        return v
-
-    raise errors.EnumError(value=v)
-
-
-def int_enum_validator(v: Any) -> IntEnum:
-    if isinstance(v, IntEnum):
-        return v
-
-    raise errors.IntEnumError(value=v)
-
-
-def make_literal_validator(type_: Any) -> Callable[[Any], Any]:
-    permitted_choices = all_literal_values(type_)
-
-    # To have a O(1) complexity and still return one of the values set inside the `Literal`,
-    # we create a dict with the set values (a set causes some problems with the way intersection works).
-    # In some cases the set value and checked value can indeed be different (see `test_literal_validator_str_enum`)
-    allowed_choices = {v: v for v in permitted_choices}
-
-    def literal_validator(v: Any) -> Any:
-        try:
-            return allowed_choices[v]
-        except KeyError:
-            raise errors.WrongConstantError(given=v, permitted=permitted_choices)
-
-    return literal_validator
-
-
-def constr_length_validator(v: 'StrBytes', field: 'ModelField', config: 'BaseConfig') -> 'StrBytes':
-    v_len = len(v)
-
-    min_length = field.type_.min_length if field.type_.min_length is not None else config.min_anystr_length
-    if v_len < min_length:
-        raise errors.AnyStrMinLengthError(limit_value=min_length)
-
-    max_length = field.type_.max_length if field.type_.max_length is not None else config.max_anystr_length
-    if max_length is not None and v_len > max_length:
-        raise errors.AnyStrMaxLengthError(limit_value=max_length)
-
-    return v
-
-
-def constr_strip_whitespace(v: 'StrBytes', field: 'ModelField', config: 'BaseConfig') -> 'StrBytes':
-    strip_whitespace = field.type_.strip_whitespace or config.anystr_strip_whitespace
-    if strip_whitespace:
-        v = v.strip()
-
-    return v
-
-
-def constr_upper(v: 'StrBytes', field: 'ModelField', config: 'BaseConfig') -> 'StrBytes':
-    upper = field.type_.to_upper or config.anystr_upper
-    if upper:
-        v = v.upper()
-
-    return v
-
-
-def constr_lower(v: 'StrBytes', field: 'ModelField', config: 'BaseConfig') -> 'StrBytes':
-    lower = field.type_.to_lower or config.anystr_lower
-    if lower:
-        v = v.lower()
-    return v
-
-
-def validate_json(v: Any, config: 'BaseConfig') -> Any:
-    if v is None:
-        # pass None through to other validators
-        return v
-    try:
-        return config.json_loads(v)  # type: ignore
-    except ValueError:
-        raise errors.JsonError()
-    except TypeError:
-        raise errors.JsonTypeError()
-
-
-T = TypeVar('T')
-
-
-def make_arbitrary_type_validator(type_: Type[T]) -> Callable[[T], T]:
-    def arbitrary_type_validator(v: Any) -> T:
-        if isinstance(v, type_):
-            return v
-        raise errors.ArbitraryTypeError(expected_arbitrary_type=type_)
-
-    return arbitrary_type_validator
-
-
-def make_class_validator(type_: Type[T]) -> Callable[[Any], Type[T]]:
-    def class_validator(v: Any) -> Type[T]:
-        if lenient_issubclass(v, type_):
-            return v
-        raise errors.SubclassError(expected_class=type_)
-
-    return class_validator
-
-
-def any_class_validator(v: Any) -> Type[T]:
-    if isinstance(v, type):
-        return v
-    raise errors.ClassError()
-
-
-def none_validator(v: Any) -> 'Literal[None]':
-    if v is None:
-        return v
-    raise errors.NotNoneError()
-
-
-def pattern_validator(v: Any) -> Pattern[str]:
-    if isinstance(v, Pattern):
-        return v
-
-    str_value = str_validator(v)
-
-    try:
-        return re.compile(str_value)
-    except re.error:
-        raise errors.PatternError()
-
-
-NamedTupleT = TypeVar('NamedTupleT', bound=NamedTuple)
-
-
-def make_namedtuple_validator(
-    namedtuple_cls: Type[NamedTupleT], config: Type['BaseConfig']
-) -> Callable[[Tuple[Any, ...]], NamedTupleT]:
-    from .annotated_types import create_model_from_namedtuple
-
-    NamedTupleModel = create_model_from_namedtuple(
-        namedtuple_cls,
-        __config__=config,
-        __module__=namedtuple_cls.__module__,
-    )
-    namedtuple_cls.__pydantic_model__ = NamedTupleModel  # type: ignore[attr-defined]
-
-    def namedtuple_validator(values: Tuple[Any, ...]) -> NamedTupleT:
-        annotations = NamedTupleModel.__annotations__
-
-        if len(values) > len(annotations):
-            raise errors.ListMaxLengthError(limit_value=len(annotations))
-
-        dict_values: Dict[str, Any] = dict(zip(annotations, values))
-        validated_dict_values: Dict[str, Any] = dict(NamedTupleModel(**dict_values))
-        return namedtuple_cls(**validated_dict_values)
-
-    return namedtuple_validator
-
-
-def make_typeddict_validator(
-    typeddict_cls: Type['TypedDict'], config: Type['BaseConfig']  # type: ignore[valid-type]
-) -> Callable[[Any], Dict[str, Any]]:
-    from .annotated_types import create_model_from_typeddict
-
-    TypedDictModel = create_model_from_typeddict(
-        typeddict_cls,
-        __config__=config,
-        __module__=typeddict_cls.__module__,
-    )
-    typeddict_cls.__pydantic_model__ = TypedDictModel  # type: ignore[attr-defined]
-
-    def typeddict_validator(values: 'TypedDict') -> Dict[str, Any]:  # type: ignore[valid-type]
-        return TypedDictModel.parse_obj(values).dict(exclude_unset=True)
-
-    return typeddict_validator
-
-
-class IfConfig:
-    def __init__(self, validator: AnyCallable, *config_attr_names: str, ignored_value: Any = False) -> None:
-        self.validator = validator
-        self.config_attr_names = config_attr_names
-        self.ignored_value = ignored_value
-
-    def check(self, config: Type['BaseConfig']) -> bool:
-        return any(getattr(config, name) not in {None, self.ignored_value} for name in self.config_attr_names)
-
-
-# order is important here, for example: bool is a subclass of int so has to come first, datetime before date same,
-# IPv4Interface before IPv4Address, etc
-_VALIDATORS: List[Tuple[Type[Any], List[Any]]] = [
-    (IntEnum, [int_validator, enum_member_validator]),
-    (Enum, [enum_member_validator]),
-    (
-        str,
-        [
-            str_validator,
-            IfConfig(anystr_strip_whitespace, 'anystr_strip_whitespace'),
-            IfConfig(anystr_upper, 'anystr_upper'),
-            IfConfig(anystr_lower, 'anystr_lower'),
-            IfConfig(anystr_length_validator, 'min_anystr_length', 'max_anystr_length'),
-        ],
-    ),
-    (
-        bytes,
-        [
-            bytes_validator,
-            IfConfig(anystr_strip_whitespace, 'anystr_strip_whitespace'),
-            IfConfig(anystr_upper, 'anystr_upper'),
-            IfConfig(anystr_lower, 'anystr_lower'),
-            IfConfig(anystr_length_validator, 'min_anystr_length', 'max_anystr_length'),
-        ],
-    ),
-    (bool, [bool_validator]),
-    (int, [int_validator]),
-    (float, [float_validator, IfConfig(float_finite_validator, 'allow_inf_nan', ignored_value=True)]),
-    (Path, [path_validator]),
-    (datetime, [parse_datetime]),
-    (date, [parse_date]),
-    (time, [parse_time]),
-    (timedelta, [parse_duration]),
-    (OrderedDict, [ordered_dict_validator]),
-    (dict, [dict_validator]),
-    (list, [list_validator]),
-    (tuple, [tuple_validator]),
-    (set, [set_validator]),
-    (frozenset, [frozenset_validator]),
-    (deque, [deque_validator]),
-    (UUID, [uuid_validator]),
-    (Decimal, [decimal_validator]),
-    (IPv4Interface, [ip_v4_interface_validator]),
-    (IPv6Interface, [ip_v6_interface_validator]),
-    (IPv4Address, [ip_v4_address_validator]),
-    (IPv6Address, [ip_v6_address_validator]),
-    (IPv4Network, [ip_v4_network_validator]),
-    (IPv6Network, [ip_v6_network_validator]),
-]
-
-
-def find_validators(  # noqa: C901 (ignore complexity)
-    type_: Type[Any], config: Type['BaseConfig']
-) -> Generator[AnyCallable, None, None]:
-    from .dataclasses import is_builtin_dataclass, make_dataclass_validator
-
-    if type_ is Any or type_ is object:
-        return
-    type_type = type_.__class__
-    if type_type == ForwardRef or type_type == TypeVar:
-        return
-
-    if is_none_type(type_):
-        yield none_validator
-        return
-    if type_ is Pattern or type_ is re.Pattern:
-        yield pattern_validator
-        return
-    if type_ is Hashable or type_ is CollectionsHashable:
-        yield hashable_validator
-        return
-    if is_callable_type(type_):
-        yield callable_validator
-        return
-    if is_literal_type(type_):
-        yield make_literal_validator(type_)
-        return
-    if is_builtin_dataclass(type_):
-        yield from make_dataclass_validator(type_, config)
-        return
-    if type_ is Enum:
-        yield enum_validator
-        return
-    if type_ is IntEnum:
-        yield int_enum_validator
-        return
-    if is_namedtuple(type_):
-        yield tuple_validator
-        yield make_namedtuple_validator(type_, config)
-        return
-    if is_typeddict(type_):
-        yield make_typeddict_validator(type_, config)
-        return
-
-    class_ = get_class(type_)
-    if class_ is not None:
-        if class_ is not Any and isinstance(class_, type):
-            yield make_class_validator(class_)
-        else:
-            yield any_class_validator
-        return
-
-    for val_type, validators in _VALIDATORS:
-        try:
-            if issubclass(type_, val_type):
-                for v in validators:
-                    if isinstance(v, IfConfig):
-                        if v.check(config):
-                            yield v.validator
-                    else:
-                        yield v
-                return
-        except TypeError:
-            raise RuntimeError(f'error checking inheritance of {type_!r} (type: {display_as_type(type_)})')
-
-    if config.arbitrary_types_allowed:
-        yield make_arbitrary_type_validator(type_)
-    else:
-        raise RuntimeError(f'no validator found for {type_}, see `arbitrary_types_allowed` in Config')
+__getattr__ = getattr_migration(__name__)
diff --git a/lib/pydantic/version.py b/lib/pydantic/version.py
index 32c61633..3e233771 100644
--- a/lib/pydantic/version.py
+++ b/lib/pydantic/version.py
@@ -1,38 +1,80 @@
-__all__ = 'compiled', 'VERSION', 'version_info'
+"""The `version` module holds the version information for Pydantic."""
+from __future__ import annotations as _annotations
 
-VERSION = '1.10.2'
+__all__ = 'VERSION', 'version_info'
 
-try:
-    import cython  # type: ignore
-except ImportError:
-    compiled: bool = False
-else:  # pragma: no cover
-    try:
-        compiled = cython.compiled
-    except AttributeError:
-        compiled = False
+VERSION = '2.6.4'
+"""The version of Pydantic."""
+
+
+def version_short() -> str:
+    """Return the `major.minor` part of Pydantic version.
+
+    It returns '2.1' if Pydantic version is '2.1.1'.
+    """
+    return '.'.join(VERSION.split('.')[:2])
 
 
 def version_info() -> str:
+    """Return complete version information for Pydantic and its dependencies."""
+    import importlib.metadata as importlib_metadata
+    import os
     import platform
     import sys
-    from importlib import import_module
     from pathlib import Path
 
-    optional_deps = []
-    for p in ('devtools', 'dotenv', 'email-validator', 'typing-extensions'):
-        try:
-            import_module(p.replace('-', '_'))
-        except ImportError:
-            continue
-        optional_deps.append(p)
+    import pydantic_core._pydantic_core as pdc
+
+    from ._internal import _git as git
+
+    # get data about packages that are closely related to pydantic, use pydantic or often conflict with pydantic
+    package_names = {
+        'email-validator',
+        'fastapi',
+        'mypy',
+        'pydantic-extra-types',
+        'pydantic-settings',
+        'pyright',
+        'typing_extensions',
+    }
+    related_packages = []
+
+    for dist in importlib_metadata.distributions():
+        name = dist.metadata['Name']
+        if name in package_names:
+            related_packages.append(f'{name}-{dist.version}')
+
+    pydantic_dir = os.path.abspath(os.path.dirname(os.path.dirname(__file__)))
+    most_recent_commit = (
+        git.git_revision(pydantic_dir) if git.is_git_repo(pydantic_dir) and git.have_git() else 'unknown'
+    )
 
     info = {
         'pydantic version': VERSION,
-        'pydantic compiled': compiled,
+        'pydantic-core version': pdc.__version__,
+        'pydantic-core build': getattr(pdc, 'build_info', None) or pdc.build_profile,
         'install path': Path(__file__).resolve().parent,
         'python version': sys.version,
         'platform': platform.platform(),
-        'optional deps. installed': optional_deps,
+        'related packages': ' '.join(related_packages),
+        'commit': most_recent_commit,
     }
     return '\n'.join('{:>30} {}'.format(k + ':', str(v).replace('\n', ' ')) for k, v in info.items())
+
+
+def parse_mypy_version(version: str) -> tuple[int, ...]:
+    """Parse mypy string version to tuple of ints.
+
+    This function is included here rather than the mypy plugin file because the mypy plugin file cannot be imported
+    outside a mypy run.
+
+    It parses normal version like `0.930` and dev version
+    like `0.940+dev.04cac4b5d911c4f9529e6ce86a27b44f28846f5d.dirty`.
+
+    Args:
+        version: The mypy version string.
+
+    Returns:
+        A tuple of ints. e.g. (0, 930).
+    """
+    return tuple(map(int, version.partition('+')[0].split('.')))
diff --git a/lib/pydantic/warnings.py b/lib/pydantic/warnings.py
new file mode 100644
index 00000000..aedd4fba
--- /dev/null
+++ b/lib/pydantic/warnings.py
@@ -0,0 +1,58 @@
+"""Pydantic-specific warnings."""
+from __future__ import annotations as _annotations
+
+from .version import version_short
+
+__all__ = 'PydanticDeprecatedSince20', 'PydanticDeprecationWarning'
+
+
+class PydanticDeprecationWarning(DeprecationWarning):
+    """A Pydantic specific deprecation warning.
+
+    This warning is raised when using deprecated functionality in Pydantic. It provides information on when the
+    deprecation was introduced and the expected version in which the corresponding functionality will be removed.
+
+    Attributes:
+        message: Description of the warning.
+        since: Pydantic version in what the deprecation was introduced.
+        expected_removal: Pydantic version in what the corresponding functionality expected to be removed.
+    """
+
+    message: str
+    since: tuple[int, int]
+    expected_removal: tuple[int, int]
+
+    def __init__(
+        self, message: str, *args: object, since: tuple[int, int], expected_removal: tuple[int, int] | None = None
+    ) -> None:
+        super().__init__(message, *args)
+        self.message = message.rstrip('.')
+        self.since = since
+        self.expected_removal = expected_removal if expected_removal is not None else (since[0] + 1, 0)
+
+    def __str__(self) -> str:
+        message = (
+            f'{self.message}. Deprecated in Pydantic V{self.since[0]}.{self.since[1]}'
+            f' to be removed in V{self.expected_removal[0]}.{self.expected_removal[1]}.'
+        )
+        if self.since == (2, 0):
+            message += f' See Pydantic V2 Migration Guide at https://errors.pydantic.dev/{version_short()}/migration/'
+        return message
+
+
+class PydanticDeprecatedSince20(PydanticDeprecationWarning):
+    """A specific `PydanticDeprecationWarning` subclass defining functionality deprecated since Pydantic 2.0."""
+
+    def __init__(self, message: str, *args: object) -> None:
+        super().__init__(message, *args, since=(2, 0), expected_removal=(3, 0))
+
+
+class PydanticDeprecatedSince26(PydanticDeprecationWarning):
+    """A specific `PydanticDeprecationWarning` subclass defining functionality deprecated since Pydantic 2.6."""
+
+    def __init__(self, message: str, *args: object) -> None:
+        super().__init__(message, *args, since=(2, 0), expected_removal=(3, 0))
+
+
+class GenericBeforeBaseModelWarning(Warning):
+    pass
diff --git a/lib/pydantic_core/__init__.py b/lib/pydantic_core/__init__.py
new file mode 100644
index 00000000..5b2655c9
--- /dev/null
+++ b/lib/pydantic_core/__init__.py
@@ -0,0 +1,139 @@
+from __future__ import annotations
+
+import sys as _sys
+from typing import Any as _Any
+
+from ._pydantic_core import (
+    ArgsKwargs,
+    MultiHostUrl,
+    PydanticCustomError,
+    PydanticKnownError,
+    PydanticOmit,
+    PydanticSerializationError,
+    PydanticSerializationUnexpectedValue,
+    PydanticUndefined,
+    PydanticUndefinedType,
+    PydanticUseDefault,
+    SchemaError,
+    SchemaSerializer,
+    SchemaValidator,
+    Some,
+    TzInfo,
+    Url,
+    ValidationError,
+    __version__,
+    from_json,
+    to_json,
+    to_jsonable_python,
+    validate_core_schema,
+)
+from .core_schema import CoreConfig, CoreSchema, CoreSchemaType, ErrorType
+
+if _sys.version_info < (3, 11):
+    from typing_extensions import NotRequired as _NotRequired
+else:
+    from typing import NotRequired as _NotRequired
+
+if _sys.version_info < (3, 9):
+    from typing_extensions import TypedDict as _TypedDict
+else:
+    from typing import TypedDict as _TypedDict
+
+__all__ = [
+    '__version__',
+    'CoreConfig',
+    'CoreSchema',
+    'CoreSchemaType',
+    'SchemaValidator',
+    'SchemaSerializer',
+    'Some',
+    'Url',
+    'MultiHostUrl',
+    'ArgsKwargs',
+    'PydanticUndefined',
+    'PydanticUndefinedType',
+    'SchemaError',
+    'ErrorDetails',
+    'InitErrorDetails',
+    'ValidationError',
+    'PydanticCustomError',
+    'PydanticKnownError',
+    'PydanticOmit',
+    'PydanticUseDefault',
+    'PydanticSerializationError',
+    'PydanticSerializationUnexpectedValue',
+    'TzInfo',
+    'to_json',
+    'from_json',
+    'to_jsonable_python',
+    'validate_core_schema',
+]
+
+
+class ErrorDetails(_TypedDict):
+    type: str
+    """
+    The type of error that occurred, this is an identifier designed for
+    programmatic use that will change rarely or never.
+
+    `type` is unique for each error message, and can hence be used as an identifier to build custom error messages.
+    """
+    loc: tuple[int | str, ...]
+    """Tuple of strings and ints identifying where in the schema the error occurred."""
+    msg: str
+    """A human readable error message."""
+    input: _Any
+    """The input data at this `loc` that caused the error."""
+    ctx: _NotRequired[dict[str, _Any]]
+    """
+    Values which are required to render the error message, and could hence be useful in rendering custom error messages.
+    Also useful for passing custom error data forward.
+    """
+
+
+class InitErrorDetails(_TypedDict):
+    type: str | PydanticCustomError
+    """The type of error that occurred, this should a "slug" identifier that changes rarely or never."""
+    loc: _NotRequired[tuple[int | str, ...]]
+    """Tuple of strings and ints identifying where in the schema the error occurred."""
+    input: _Any
+    """The input data at this `loc` that caused the error."""
+    ctx: _NotRequired[dict[str, _Any]]
+    """
+    Values which are required to render the error message, and could hence be useful in rendering custom error messages.
+    Also useful for passing custom error data forward.
+    """
+
+
+class ErrorTypeInfo(_TypedDict):
+    """
+    Gives information about errors.
+    """
+
+    type: ErrorType
+    """The type of error that occurred, this should a "slug" identifier that changes rarely or never."""
+    message_template_python: str
+    """String template to render a human readable error message from using context, when the input is Python."""
+    example_message_python: str
+    """Example of a human readable error message, when the input is Python."""
+    message_template_json: _NotRequired[str]
+    """String template to render a human readable error message from using context, when the input is JSON data."""
+    example_message_json: _NotRequired[str]
+    """Example of a human readable error message, when the input is JSON data."""
+    example_context: dict[str, _Any] | None
+    """Example of context values."""
+
+
+class MultiHostHost(_TypedDict):
+    """
+    A host part of a multi-host URL.
+    """
+
+    username: str | None
+    """The username part of this host, or `None`."""
+    password: str | None
+    """The password part of this host, or `None`."""
+    host: str | None
+    """The host part of this host, or `None`."""
+    port: int | None
+    """The port part of this host, or `None`."""
diff --git a/lib/pydantic_core/_pydantic_core.pyi b/lib/pydantic_core/_pydantic_core.pyi
new file mode 100644
index 00000000..a7b727f8
--- /dev/null
+++ b/lib/pydantic_core/_pydantic_core.pyi
@@ -0,0 +1,882 @@
+from __future__ import annotations
+
+import datetime
+import sys
+from typing import Any, Callable, Generic, Optional, Type, TypeVar
+
+from pydantic_core import ErrorDetails, ErrorTypeInfo, InitErrorDetails, MultiHostHost
+from pydantic_core.core_schema import CoreConfig, CoreSchema, ErrorType
+
+if sys.version_info < (3, 8):
+    from typing_extensions import final
+else:
+    from typing import final
+
+if sys.version_info < (3, 11):
+    from typing_extensions import Literal, LiteralString, Self, TypeAlias
+else:
+    from typing import Literal, LiteralString, Self, TypeAlias
+
+from _typeshed import SupportsAllComparisons
+
+__all__ = [
+    '__version__',
+    'build_profile',
+    'build_info',
+    '_recursion_limit',
+    'ArgsKwargs',
+    'SchemaValidator',
+    'SchemaSerializer',
+    'Url',
+    'MultiHostUrl',
+    'SchemaError',
+    'ValidationError',
+    'PydanticCustomError',
+    'PydanticKnownError',
+    'PydanticOmit',
+    'PydanticUseDefault',
+    'PydanticSerializationError',
+    'PydanticSerializationUnexpectedValue',
+    'PydanticUndefined',
+    'PydanticUndefinedType',
+    'Some',
+    'to_json',
+    'from_json',
+    'to_jsonable_python',
+    'list_all_errors',
+    'TzInfo',
+    'validate_core_schema',
+]
+__version__: str
+build_profile: str
+build_info: str
+_recursion_limit: int
+
+_T = TypeVar('_T', default=Any, covariant=True)
+
+_StringInput: TypeAlias = 'dict[str, _StringInput]'
+
+@final
+class Some(Generic[_T]):
+    """
+    Similar to Rust's [`Option::Some`](https://doc.rust-lang.org/std/option/enum.Option.html) type, this
+    identifies a value as being present, and provides a way to access it.
+
+    Generally used in a union with `None` to different between "some value which could be None" and no value.
+    """
+
+    __match_args__ = ('value',)
+
+    @property
+    def value(self) -> _T:
+        """
+        Returns the value wrapped by `Some`.
+        """
+    @classmethod
+    def __class_getitem__(cls, __item: Any) -> Type[Self]: ...
+
+@final
+class SchemaValidator:
+    """
+    `SchemaValidator` is the Python wrapper for `pydantic-core`'s Rust validation logic, internally it owns one
+    `CombinedValidator` which may in turn own more `CombinedValidator`s which make up the full schema validator.
+    """
+
+    def __new__(cls, schema: CoreSchema, config: CoreConfig | None = None) -> Self:
+        """
+        Create a new SchemaValidator.
+
+        Arguments:
+            schema: The [`CoreSchema`][pydantic_core.core_schema.CoreSchema] to use for validation.
+            config: Optionally a [`CoreConfig`][pydantic_core.core_schema.CoreConfig] to configure validation.
+        """
+    @property
+    def title(self) -> str:
+        """
+        The title of the schema, as used in the heading of [`ValidationError.__str__()`][pydantic_core.ValidationError].
+        """
+    def validate_python(
+        self,
+        input: Any,
+        *,
+        strict: bool | None = None,
+        from_attributes: bool | None = None,
+        context: 'dict[str, Any] | None' = None,
+        self_instance: Any | None = None,
+    ) -> Any:
+        """
+        Validate a Python object against the schema and return the validated object.
+
+        Arguments:
+            input: The Python object to validate.
+            strict: Whether to validate the object in strict mode.
+                If `None`, the value of [`CoreConfig.strict`][pydantic_core.core_schema.CoreConfig] is used.
+            from_attributes: Whether to validate objects as inputs to models by extracting attributes.
+                If `None`, the value of [`CoreConfig.from_attributes`][pydantic_core.core_schema.CoreConfig] is used.
+            context: The context to use for validation, this is passed to functional validators as
+                [`info.context`][pydantic_core.core_schema.ValidationInfo.context].
+            self_instance: An instance of a model set attributes on from validation, this is used when running
+                validation from the `__init__` method of a model.
+
+        Raises:
+            ValidationError: If validation fails.
+            Exception: Other error types maybe raised if internal errors occur.
+
+        Returns:
+            The validated object.
+        """
+    def isinstance_python(
+        self,
+        input: Any,
+        *,
+        strict: bool | None = None,
+        from_attributes: bool | None = None,
+        context: 'dict[str, Any] | None' = None,
+        self_instance: Any | None = None,
+    ) -> bool:
+        """
+        Similar to [`validate_python()`][pydantic_core.SchemaValidator.validate_python] but returns a boolean.
+
+        Arguments match `validate_python()`. This method will not raise `ValidationError`s but will raise internal
+        errors.
+
+        Returns:
+            `True` if validation succeeds, `False` if validation fails.
+        """
+    def validate_json(
+        self,
+        input: str | bytes | bytearray,
+        *,
+        strict: bool | None = None,
+        context: 'dict[str, Any] | None' = None,
+        self_instance: Any | None = None,
+    ) -> Any:
+        """
+        Validate JSON data directly against the schema and return the validated Python object.
+
+        This method should be significantly faster than `validate_python(json.loads(json_data))` as it avoids the
+        need to create intermediate Python objects
+
+        It also handles constructing the correct Python type even in strict mode, where
+        `validate_python(json.loads(json_data))` would fail validation.
+
+        Arguments:
+            input: The JSON data to validate.
+            strict: Whether to validate the object in strict mode.
+                If `None`, the value of [`CoreConfig.strict`][pydantic_core.core_schema.CoreConfig] is used.
+            context: The context to use for validation, this is passed to functional validators as
+                [`info.context`][pydantic_core.core_schema.ValidationInfo.context].
+            self_instance: An instance of a model set attributes on from validation.
+
+        Raises:
+            ValidationError: If validation fails or if the JSON data is invalid.
+            Exception: Other error types maybe raised if internal errors occur.
+
+        Returns:
+            The validated Python object.
+        """
+    def validate_strings(
+        self, input: _StringInput, *, strict: bool | None = None, context: 'dict[str, Any] | None' = None
+    ) -> Any:
+        """
+        Validate a string against the schema and return the validated Python object.
+
+        This is similar to `validate_json` but applies to scenarios where the input will be a string but not
+        JSON data, e.g. URL fragments, query parameters, etc.
+
+        Arguments:
+            input: The input as a string, or bytes/bytearray if `strict=False`.
+            strict: Whether to validate the object in strict mode.
+                If `None`, the value of [`CoreConfig.strict`][pydantic_core.core_schema.CoreConfig] is used.
+            context: The context to use for validation, this is passed to functional validators as
+                [`info.context`][pydantic_core.core_schema.ValidationInfo.context].
+
+        Raises:
+            ValidationError: If validation fails or if the JSON data is invalid.
+            Exception: Other error types maybe raised if internal errors occur.
+
+        Returns:
+            The validated Python object.
+        """
+    def validate_assignment(
+        self,
+        obj: Any,
+        field_name: str,
+        field_value: Any,
+        *,
+        strict: bool | None = None,
+        from_attributes: bool | None = None,
+        context: 'dict[str, Any] | None' = None,
+    ) -> dict[str, Any] | tuple[dict[str, Any], dict[str, Any] | None, set[str]]:
+        """
+        Validate an assignment to a field on a model.
+
+        Arguments:
+            obj: The model instance being assigned to.
+            field_name: The name of the field to validate assignment for.
+            field_value: The value to assign to the field.
+            strict: Whether to validate the object in strict mode.
+                If `None`, the value of [`CoreConfig.strict`][pydantic_core.core_schema.CoreConfig] is used.
+            from_attributes: Whether to validate objects as inputs to models by extracting attributes.
+                If `None`, the value of [`CoreConfig.from_attributes`][pydantic_core.core_schema.CoreConfig] is used.
+            context: The context to use for validation, this is passed to functional validators as
+                [`info.context`][pydantic_core.core_schema.ValidationInfo.context].
+
+        Raises:
+            ValidationError: If validation fails.
+            Exception: Other error types maybe raised if internal errors occur.
+
+        Returns:
+            Either the model dict or a tuple of `(model_data, model_extra, fields_set)`
+        """
+    def get_default_value(self, *, strict: bool | None = None, context: Any = None) -> Some | None:
+        """
+        Get the default value for the schema, including running default value validation.
+
+        Arguments:
+            strict: Whether to validate the default value in strict mode.
+                If `None`, the value of [`CoreConfig.strict`][pydantic_core.core_schema.CoreConfig] is used.
+            context: The context to use for validation, this is passed to functional validators as
+                [`info.context`][pydantic_core.core_schema.ValidationInfo.context].
+
+        Raises:
+            ValidationError: If validation fails.
+            Exception: Other error types maybe raised if internal errors occur.
+
+        Returns:
+            `None` if the schema has no default value, otherwise a [`Some`][pydantic_core.Some] containing the default.
+        """
+
+_IncEx: TypeAlias = set[int] | set[str] | dict[int, _IncEx] | dict[str, _IncEx] | None
+
+@final
+class SchemaSerializer:
+    """
+    `SchemaSerializer` is the Python wrapper for `pydantic-core`'s Rust serialization logic, internally it owns one
+    `CombinedSerializer` which may in turn own more `CombinedSerializer`s which make up the full schema serializer.
+    """
+
+    def __new__(cls, schema: CoreSchema, config: CoreConfig | None = None) -> Self:
+        """
+        Create a new SchemaSerializer.
+
+        Arguments:
+            schema: The [`CoreSchema`][pydantic_core.core_schema.CoreSchema] to use for serialization.
+            config: Optionally a [`CoreConfig`][pydantic_core.core_schema.CoreConfig] to to configure serialization.
+        """
+    def to_python(
+        self,
+        value: Any,
+        *,
+        mode: str | None = None,
+        include: _IncEx = None,
+        exclude: _IncEx = None,
+        by_alias: bool = True,
+        exclude_unset: bool = False,
+        exclude_defaults: bool = False,
+        exclude_none: bool = False,
+        round_trip: bool = False,
+        warnings: bool = True,
+        fallback: Callable[[Any], Any] | None = None,
+    ) -> Any:
+        """
+        Serialize/marshal a Python object to a Python object including transforming and filtering data.
+
+        Arguments:
+            value: The Python object to serialize.
+            mode: The serialization mode to use, either `'python'` or `'json'`, defaults to `'python'`. In JSON mode,
+                all values are converted to JSON compatible types, e.g. `None`, `int`, `float`, `str`, `list`, `dict`.
+            include: A set of fields to include, if `None` all fields are included.
+            exclude: A set of fields to exclude, if `None` no fields are excluded.
+            by_alias: Whether to use the alias names of fields.
+            exclude_unset: Whether to exclude fields that are not set,
+                e.g. are not included in `__pydantic_fields_set__`.
+            exclude_defaults: Whether to exclude fields that are equal to their default value.
+            exclude_none: Whether to exclude fields that have a value of `None`.
+            round_trip: Whether to enable serialization and validation round-trip support.
+            warnings: Whether to log warnings when invalid fields are encountered.
+            fallback: A function to call when an unknown value is encountered,
+                if `None` a [`PydanticSerializationError`][pydantic_core.PydanticSerializationError] error is raised.
+
+        Raises:
+            PydanticSerializationError: If serialization fails and no `fallback` function is provided.
+
+        Returns:
+            The serialized Python object.
+        """
+    def to_json(
+        self,
+        value: Any,
+        *,
+        indent: int | None = None,
+        include: _IncEx = None,
+        exclude: _IncEx = None,
+        by_alias: bool = True,
+        exclude_unset: bool = False,
+        exclude_defaults: bool = False,
+        exclude_none: bool = False,
+        round_trip: bool = False,
+        warnings: bool = True,
+        fallback: Callable[[Any], Any] | None = None,
+    ) -> bytes:
+        """
+        Serialize a Python object to JSON including transforming and filtering data.
+
+        Arguments:
+            value: The Python object to serialize.
+            indent: If `None`, the JSON will be compact, otherwise it will be pretty-printed with the indent provided.
+            include: A set of fields to include, if `None` all fields are included.
+            exclude: A set of fields to exclude, if `None` no fields are excluded.
+            by_alias: Whether to use the alias names of fields.
+            exclude_unset: Whether to exclude fields that are not set,
+                e.g. are not included in `__pydantic_fields_set__`.
+            exclude_defaults: Whether to exclude fields that are equal to their default value.
+            exclude_none: Whether to exclude fields that have a value of `None`.
+            round_trip: Whether to enable serialization and validation round-trip support.
+            warnings: Whether to log warnings when invalid fields are encountered.
+            fallback: A function to call when an unknown value is encountered,
+                if `None` a [`PydanticSerializationError`][pydantic_core.PydanticSerializationError] error is raised.
+
+        Raises:
+            PydanticSerializationError: If serialization fails and no `fallback` function is provided.
+
+        Returns:
+           JSON bytes.
+        """
+
+def to_json(
+    value: Any,
+    *,
+    indent: int | None = None,
+    include: _IncEx = None,
+    exclude: _IncEx = None,
+    by_alias: bool = True,
+    exclude_none: bool = False,
+    round_trip: bool = False,
+    timedelta_mode: Literal['iso8601', 'float'] = 'iso8601',
+    bytes_mode: Literal['utf8', 'base64'] = 'utf8',
+    inf_nan_mode: Literal['null', 'constants'] = 'constants',
+    serialize_unknown: bool = False,
+    fallback: Callable[[Any], Any] | None = None,
+) -> bytes:
+    """
+    Serialize a Python object to JSON including transforming and filtering data.
+
+    This is effectively a standalone version of [`SchemaSerializer.to_json`][pydantic_core.SchemaSerializer.to_json].
+
+    Arguments:
+        value: The Python object to serialize.
+        indent: If `None`, the JSON will be compact, otherwise it will be pretty-printed with the indent provided.
+        include: A set of fields to include, if `None` all fields are included.
+        exclude: A set of fields to exclude, if `None` no fields are excluded.
+        by_alias: Whether to use the alias names of fields.
+        exclude_none: Whether to exclude fields that have a value of `None`.
+        round_trip: Whether to enable serialization and validation round-trip support.
+        timedelta_mode: How to serialize `timedelta` objects, either `'iso8601'` or `'float'`.
+        bytes_mode: How to serialize `bytes` objects, either `'utf8'` or `'base64'`.
+        inf_nan_mode: How to serialize `Infinity`, `-Infinity` and `NaN` values, either `'null'` or `'constants'`.
+        serialize_unknown: Attempt to serialize unknown types, `str(value)` will be used, if that fails
+            `"<Unserializable {value_type} object>"` will be used.
+        fallback: A function to call when an unknown value is encountered,
+            if `None` a [`PydanticSerializationError`][pydantic_core.PydanticSerializationError] error is raised.
+
+    Raises:
+        PydanticSerializationError: If serialization fails and no `fallback` function is provided.
+
+    Returns:
+       JSON bytes.
+    """
+
+def from_json(data: str | bytes | bytearray, *, allow_inf_nan: bool = True, cache_strings: bool = True) -> Any:
+    """
+    Deserialize JSON data to a Python object.
+
+    This is effectively a faster version of `json.loads()`.
+
+    Arguments:
+        data: The JSON data to deserialize.
+        allow_inf_nan: Whether to allow `Infinity`, `-Infinity` and `NaN` values as `json.loads()` does by default.
+        cache_strings: Whether to cache strings to avoid constructing new Python objects,
+            this should have a significant impact on performance while increasing memory usage slightly.
+
+    Raises:
+        ValueError: If deserialization fails.
+
+    Returns:
+        The deserialized Python object.
+    """
+
+def to_jsonable_python(
+    value: Any,
+    *,
+    include: _IncEx = None,
+    exclude: _IncEx = None,
+    by_alias: bool = True,
+    exclude_none: bool = False,
+    round_trip: bool = False,
+    timedelta_mode: Literal['iso8601', 'float'] = 'iso8601',
+    bytes_mode: Literal['utf8', 'base64'] = 'utf8',
+    inf_nan_mode: Literal['null', 'constants'] = 'constants',
+    serialize_unknown: bool = False,
+    fallback: Callable[[Any], Any] | None = None,
+) -> Any:
+    """
+    Serialize/marshal a Python object to a JSON-serializable Python object including transforming and filtering data.
+
+    This is effectively a standalone version of
+    [`SchemaSerializer.to_python(mode='json')`][pydantic_core.SchemaSerializer.to_python].
+
+    Args:
+        value: The Python object to serialize.
+        include: A set of fields to include, if `None` all fields are included.
+        exclude: A set of fields to exclude, if `None` no fields are excluded.
+        by_alias: Whether to use the alias names of fields.
+        exclude_none: Whether to exclude fields that have a value of `None`.
+        round_trip: Whether to enable serialization and validation round-trip support.
+        timedelta_mode: How to serialize `timedelta` objects, either `'iso8601'` or `'float'`.
+        bytes_mode: How to serialize `bytes` objects, either `'utf8'` or `'base64'`.
+        inf_nan_mode: How to serialize `Infinity`, `-Infinity` and `NaN` values, either `'null'` or `'constants'`.
+        serialize_unknown: Attempt to serialize unknown types, `str(value)` will be used, if that fails
+            `"<Unserializable {value_type} object>"` will be used.
+        fallback: A function to call when an unknown value is encountered,
+            if `None` a [`PydanticSerializationError`][pydantic_core.PydanticSerializationError] error is raised.
+
+    Raises:
+        PydanticSerializationError: If serialization fails and no `fallback` function is provided.
+
+    Returns:
+        The serialized Python object.
+    """
+
+class Url(SupportsAllComparisons):
+    """
+    A URL type, internal logic uses the [url rust crate](https://docs.rs/url/latest/url/) originally developed
+    by Mozilla.
+    """
+
+    def __new__(cls, url: str) -> Self:
+        """
+        Create a new `Url` instance.
+
+        Args:
+            url: String representation of a URL.
+
+        Returns:
+            A new `Url` instance.
+
+        Raises:
+            ValidationError: If the URL is invalid.
+        """
+    @property
+    def scheme(self) -> str:
+        """
+        The scheme part of the URL.
+
+        e.g. `https` in `https://user:pass@host:port/path?query#fragment`
+        """
+    @property
+    def username(self) -> str | None:
+        """
+        The username part of the URL, or `None`.
+
+        e.g. `user` in `https://user:pass@host:port/path?query#fragment`
+        """
+    @property
+    def password(self) -> str | None:
+        """
+        The password part of the URL, or `None`.
+
+        e.g. `pass` in `https://user:pass@host:port/path?query#fragment`
+        """
+    @property
+    def host(self) -> str | None:
+        """
+        The host part of the URL, or `None`.
+
+        If the URL must be punycode encoded, this is the encoded host, e.g if the input URL is `https://£££.com`,
+        `host` will be `xn--9aaa.com`
+        """
+    def unicode_host(self) -> str | None:
+        """
+        The host part of the URL as a unicode string, or `None`.
+
+        e.g. `host` in `https://user:pass@host:port/path?query#fragment`
+
+        If the URL must be punycode encoded, this is the decoded host, e.g if the input URL is `https://£££.com`,
+        `unicode_host()` will be `£££.com`
+        """
+    @property
+    def port(self) -> int | None:
+        """
+        The port part of the URL, or `None`.
+
+        e.g. `port` in `https://user:pass@host:port/path?query#fragment`
+        """
+    @property
+    def path(self) -> str | None:
+        """
+        The path part of the URL, or `None`.
+
+        e.g. `/path` in `https://user:pass@host:port/path?query#fragment`
+        """
+    @property
+    def query(self) -> str | None:
+        """
+        The query part of the URL, or `None`.
+
+        e.g. `query` in `https://user:pass@host:port/path?query#fragment`
+        """
+    def query_params(self) -> list[tuple[str, str]]:
+        """
+        The query part of the URL as a list of key-value pairs.
+
+        e.g. `[('foo', 'bar')]` in `https://user:pass@host:port/path?foo=bar#fragment`
+        """
+    @property
+    def fragment(self) -> str | None:
+        """
+        The fragment part of the URL, or `None`.
+
+        e.g. `fragment` in `https://user:pass@host:port/path?query#fragment`
+        """
+    def unicode_string(self) -> str:
+        """
+        The URL as a unicode string, unlike `__str__()` this will not punycode encode the host.
+
+        If the URL must be punycode encoded, this is the decoded string, e.g if the input URL is `https://£££.com`,
+        `unicode_string()` will be `https://£££.com`
+        """
+    def __repr__(self) -> str: ...
+    def __str__(self) -> str:
+        """
+        The URL as a string, this will punycode encode the host if required.
+        """
+    def __deepcopy__(self, memo: dict) -> str: ...
+    @classmethod
+    def build(
+        cls,
+        *,
+        scheme: str,
+        username: Optional[str] = None,
+        password: Optional[str] = None,
+        host: str,
+        port: Optional[int] = None,
+        path: Optional[str] = None,
+        query: Optional[str] = None,
+        fragment: Optional[str] = None,
+    ) -> Self:
+        """
+        Build a new `Url` instance from its component parts.
+
+        Args:
+            scheme: The scheme part of the URL.
+            username: The username part of the URL, or omit for no username.
+            password: The password part of the URL, or omit for no password.
+            host: The host part of the URL.
+            port: The port part of the URL, or omit for no port.
+            path: The path part of the URL, or omit for no path.
+            query: The query part of the URL, or omit for no query.
+            fragment: The fragment part of the URL, or omit for no fragment.
+
+        Returns:
+            An instance of URL
+        """
+
+class MultiHostUrl(SupportsAllComparisons):
+    """
+    A URL type with support for multiple hosts, as used by some databases for DSNs, e.g. `https://foo.com,bar.com/path`.
+
+    Internal URL logic uses the [url rust crate](https://docs.rs/url/latest/url/) originally developed
+    by Mozilla.
+    """
+
+    def __new__(cls, url: str) -> Self:
+        """
+        Create a new `MultiHostUrl` instance.
+
+        Args:
+            url: String representation of a URL.
+
+        Returns:
+            A new `MultiHostUrl` instance.
+
+        Raises:
+            ValidationError: If the URL is invalid.
+        """
+    @property
+    def scheme(self) -> str:
+        """
+        The scheme part of the URL.
+
+        e.g. `https` in `https://foo.com,bar.com/path?query#fragment`
+        """
+    @property
+    def path(self) -> str | None:
+        """
+        The path part of the URL, or `None`.
+
+        e.g. `/path` in `https://foo.com,bar.com/path?query#fragment`
+        """
+    @property
+    def query(self) -> str | None:
+        """
+        The query part of the URL, or `None`.
+
+        e.g. `query` in `https://foo.com,bar.com/path?query#fragment`
+        """
+    def query_params(self) -> list[tuple[str, str]]:
+        """
+        The query part of the URL as a list of key-value pairs.
+
+        e.g. `[('foo', 'bar')]` in `https://foo.com,bar.com/path?query#fragment`
+        """
+    @property
+    def fragment(self) -> str | None:
+        """
+        The fragment part of the URL, or `None`.
+
+        e.g. `fragment` in `https://foo.com,bar.com/path?query#fragment`
+        """
+    def hosts(self) -> list[MultiHostHost]:
+        '''
+
+        The hosts of the `MultiHostUrl` as [`MultiHostHost`][pydantic_core.MultiHostHost] typed dicts.
+
+        ```py
+        from pydantic_core import MultiHostUrl
+
+        mhu = MultiHostUrl('https://foo.com:123,foo:bar@bar.com/path')
+        print(mhu.hosts())
+        """
+        [
+            {'username': None, 'password': None, 'host': 'foo.com', 'port': 123},
+            {'username': 'foo', 'password': 'bar', 'host': 'bar.com', 'port': 443}
+        ]
+        ```
+        Returns:
+            A list of dicts, each representing a host.
+        '''
+    def unicode_string(self) -> str:
+        """
+        The URL as a unicode string, unlike `__str__()` this will not punycode encode the hosts.
+        """
+    def __repr__(self) -> str: ...
+    def __str__(self) -> str:
+        """
+        The URL as a string, this will punycode encode the hosts if required.
+        """
+    def __deepcopy__(self, memo: dict) -> Self: ...
+    @classmethod
+    def build(
+        cls,
+        *,
+        scheme: str,
+        hosts: Optional[list[MultiHostHost]] = None,
+        username: Optional[str] = None,
+        password: Optional[str] = None,
+        host: Optional[str] = None,
+        port: Optional[int] = None,
+        path: Optional[str] = None,
+        query: Optional[str] = None,
+        fragment: Optional[str] = None,
+    ) -> Self:
+        """
+        Build a new `MultiHostUrl` instance from its component parts.
+
+        This method takes either `hosts` - a list of `MultiHostHost` typed dicts, or the individual components
+        `username`, `password`, `host` and `port`.
+
+        Args:
+            scheme: The scheme part of the URL.
+            hosts: Multiple hosts to build the URL from.
+            username: The username part of the URL.
+            password: The password part of the URL.
+            host: The host part of the URL.
+            port: The port part of the URL.
+            path: The path part of the URL.
+            query: The query part of the URL, or omit for no query.
+            fragment: The fragment part of the URL, or omit for no fragment.
+
+        Returns:
+            An instance of `MultiHostUrl`
+        """
+
+@final
+class SchemaError(Exception):
+    """
+    Information about errors that occur while building a [`SchemaValidator`][pydantic_core.SchemaValidator]
+    or [`SchemaSerializer`][pydantic_core.SchemaSerializer].
+    """
+
+    def error_count(self) -> int:
+        """
+        Returns:
+            The number of errors in the schema.
+        """
+    def errors(self) -> list[ErrorDetails]:
+        """
+        Returns:
+            A list of [`ErrorDetails`][pydantic_core.ErrorDetails] for each error in the schema.
+        """
+
+@final
+class ValidationError(ValueError):
+    """
+    `ValidationError` is the exception raised by `pydantic-core` when validation fails, it contains a list of errors
+    which detail why validation failed.
+    """
+
+    @staticmethod
+    def from_exception_data(
+        title: str,
+        line_errors: list[InitErrorDetails],
+        input_type: Literal['python', 'json'] = 'python',
+        hide_input: bool = False,
+    ) -> ValidationError:
+        """
+        Python constructor for a Validation Error.
+
+        The API for constructing validation errors will probably change in the future,
+        hence the static method rather than `__init__`.
+
+        Arguments:
+            title: The title of the error, as used in the heading of `str(validation_error)`
+            line_errors: A list of [`InitErrorDetails`][pydantic_core.InitErrorDetails] which contain information
+                about errors that occurred during validation.
+            input_type: Whether the error is for a Python object or JSON.
+            hide_input: Whether to hide the input value in the error message.
+        """
+    @property
+    def title(self) -> str:
+        """
+        The title of the error, as used in the heading of `str(validation_error)`.
+        """
+    def error_count(self) -> int:
+        """
+        Returns:
+            The number of errors in the validation error.
+        """
+    def errors(
+        self, *, include_url: bool = True, include_context: bool = True, include_input: bool = True
+    ) -> list[ErrorDetails]:
+        """
+        Details about each error in the validation error.
+
+        Args:
+            include_url: Whether to include a URL to documentation on the error each error.
+            include_context: Whether to include the context of each error.
+            include_input: Whether to include the input value of each error.
+
+        Returns:
+            A list of [`ErrorDetails`][pydantic_core.ErrorDetails] for each error in the validation error.
+        """
+    def json(
+        self,
+        *,
+        indent: int | None = None,
+        include_url: bool = True,
+        include_context: bool = True,
+        include_input: bool = True,
+    ) -> str:
+        """
+        Same as [`errors()`][pydantic_core.ValidationError.errors] but returns a JSON string.
+
+        Args:
+            indent: The number of spaces to indent the JSON by, or `None` for no indentation - compact JSON.
+            include_url: Whether to include a URL to documentation on the error each error.
+            include_context: Whether to include the context of each error.
+            include_input: Whether to include the input value of each error.
+
+        Returns:
+            a JSON string.
+        """
+
+    def __repr__(self) -> str:
+        """
+        A string representation of the validation error.
+
+        Whether or not documentation URLs are included in the repr is controlled by the
+        environment variable `PYDANTIC_ERRORS_INCLUDE_URL` being set to `1` or
+        `true`; by default, URLs are shown.
+
+        Due to implementation details, this environment variable can only be set once,
+        before the first validation error is created.
+        """
+
+@final
+class PydanticCustomError(ValueError):
+    def __new__(
+        cls, error_type: LiteralString, message_template: LiteralString, context: dict[str, Any] | None = None
+    ) -> Self: ...
+    @property
+    def context(self) -> dict[str, Any] | None: ...
+    @property
+    def type(self) -> str: ...
+    @property
+    def message_template(self) -> str: ...
+    def message(self) -> str: ...
+
+@final
+class PydanticKnownError(ValueError):
+    def __new__(cls, error_type: ErrorType, context: dict[str, Any] | None = None) -> Self: ...
+    @property
+    def context(self) -> dict[str, Any] | None: ...
+    @property
+    def type(self) -> ErrorType: ...
+    @property
+    def message_template(self) -> str: ...
+    def message(self) -> str: ...
+
+@final
+class PydanticOmit(Exception):
+    def __new__(cls) -> Self: ...
+
+@final
+class PydanticUseDefault(Exception):
+    def __new__(cls) -> Self: ...
+
+@final
+class PydanticSerializationError(ValueError):
+    def __new__(cls, message: str) -> Self: ...
+
+@final
+class PydanticSerializationUnexpectedValue(ValueError):
+    def __new__(cls, message: str | None = None) -> Self: ...
+
+@final
+class ArgsKwargs:
+    def __new__(cls, args: tuple[Any, ...], kwargs: dict[str, Any] | None = None) -> Self: ...
+    @property
+    def args(self) -> tuple[Any, ...]: ...
+    @property
+    def kwargs(self) -> dict[str, Any] | None: ...
+
+@final
+class PydanticUndefinedType:
+    def __copy__(self) -> Self: ...
+    def __deepcopy__(self, memo: Any) -> Self: ...
+
+PydanticUndefined: PydanticUndefinedType
+
+def list_all_errors() -> list[ErrorTypeInfo]:
+    """
+    Get information about all built-in errors.
+
+    Returns:
+        A list of `ErrorTypeInfo` typed dicts.
+    """
+@final
+class TzInfo(datetime.tzinfo):
+    def tzname(self, _dt: datetime.datetime | None) -> str | None: ...
+    def utcoffset(self, _dt: datetime.datetime | None) -> datetime.timedelta: ...
+    def dst(self, _dt: datetime.datetime | None) -> datetime.timedelta: ...
+    def fromutc(self, dt: datetime.datetime) -> datetime.datetime: ...
+    def __deepcopy__(self, _memo: dict[Any, Any]) -> 'TzInfo': ...
+
+def validate_core_schema(schema: CoreSchema, *, strict: bool | None = None) -> CoreSchema:
+    """Validate a CoreSchema
+    This currently uses lax mode for validation (i.e. will coerce strings to dates and such)
+    but may use strict mode in the future.
+    We may also remove this function altogether, do not rely on it being present if you are
+    using pydantic-core directly.
+    """
diff --git a/lib/pydantic_core/core_schema.py b/lib/pydantic_core/core_schema.py
new file mode 100644
index 00000000..31bf4878
--- /dev/null
+++ b/lib/pydantic_core/core_schema.py
@@ -0,0 +1,3980 @@
+"""
+This module contains definitions to build schemas which `pydantic_core` can
+validate and serialize.
+"""
+
+from __future__ import annotations as _annotations
+
+import sys
+import warnings
+from collections.abc import Mapping
+from datetime import date, datetime, time, timedelta
+from decimal import Decimal
+from typing import TYPE_CHECKING, Any, Callable, Dict, Hashable, List, Set, Tuple, Type, Union
+
+from typing_extensions import deprecated
+
+if sys.version_info < (3, 12):
+    from typing_extensions import TypedDict
+else:
+    from typing import TypedDict
+
+if sys.version_info < (3, 11):
+    from typing_extensions import Protocol, Required, TypeAlias
+else:
+    from typing import Protocol, Required, TypeAlias
+
+if sys.version_info < (3, 9):
+    from typing_extensions import Literal
+else:
+    from typing import Literal
+
+if TYPE_CHECKING:
+    from pydantic_core import PydanticUndefined
+else:
+    # The initial build of pydantic_core requires PydanticUndefined to generate
+    # the core schema; so we need to conditionally skip it. mypy doesn't like
+    # this at all, hence the TYPE_CHECKING branch above.
+    try:
+        from pydantic_core import PydanticUndefined
+    except ImportError:
+        PydanticUndefined = object()
+
+
+ExtraBehavior = Literal['allow', 'forbid', 'ignore']
+
+
+class CoreConfig(TypedDict, total=False):
+    """
+    Base class for schema configuration options.
+
+    Attributes:
+        title: The name of the configuration.
+        strict: Whether the configuration should strictly adhere to specified rules.
+        extra_fields_behavior: The behavior for handling extra fields.
+        typed_dict_total: Whether the TypedDict should be considered total. Default is `True`.
+        from_attributes: Whether to use attributes for models, dataclasses, and tagged union keys.
+        loc_by_alias: Whether to use the used alias (or first alias for "field required" errors) instead of
+            `field_names` to construct error `loc`s. Default is `True`.
+        revalidate_instances: Whether instances of models and dataclasses should re-validate. Default is 'never'.
+        validate_default: Whether to validate default values during validation. Default is `False`.
+        populate_by_name: Whether an aliased field may be populated by its name as given by the model attribute,
+            as well as the alias. (Replaces 'allow_population_by_field_name' in Pydantic v1.) Default is `False`.
+        str_max_length: The maximum length for string fields.
+        str_min_length: The minimum length for string fields.
+        str_strip_whitespace: Whether to strip whitespace from string fields.
+        str_to_lower: Whether to convert string fields to lowercase.
+        str_to_upper: Whether to convert string fields to uppercase.
+        allow_inf_nan: Whether to allow infinity and NaN values for float fields. Default is `True`.
+        ser_json_timedelta: The serialization option for `timedelta` values. Default is 'iso8601'.
+        ser_json_bytes: The serialization option for `bytes` values. Default is 'utf8'.
+        ser_json_inf_nan: The serialization option for infinity and NaN values
+            in float fields. Default is 'null'.
+        hide_input_in_errors: Whether to hide input data from `ValidationError` representation.
+        validation_error_cause: Whether to add user-python excs to the __cause__ of a ValidationError.
+            Requires exceptiongroup backport pre Python 3.11.
+        coerce_numbers_to_str: Whether to enable coercion of any `Number` type to `str` (not applicable in `strict` mode).
+        regex_engine: The regex engine to use for regex pattern validation. Default is 'rust-regex'. See `StringSchema`.
+    """
+
+    title: str
+    strict: bool
+    # settings related to typed dicts, model fields, dataclass fields
+    extra_fields_behavior: ExtraBehavior
+    typed_dict_total: bool  # default: True
+    # used for models, dataclasses, and tagged union keys
+    from_attributes: bool
+    # whether to use the used alias (or first alias for "field required" errors) instead of field_names
+    # to construct error `loc`s, default True
+    loc_by_alias: bool
+    # whether instances of models and dataclasses (including subclass instances) should re-validate, default 'never'
+    revalidate_instances: Literal['always', 'never', 'subclass-instances']
+    # whether to validate default values during validation, default False
+    validate_default: bool
+    # used on typed-dicts and arguments
+    populate_by_name: bool  # replaces `allow_population_by_field_name` in pydantic v1
+    # fields related to string fields only
+    str_max_length: int
+    str_min_length: int
+    str_strip_whitespace: bool
+    str_to_lower: bool
+    str_to_upper: bool
+    # fields related to float fields only
+    allow_inf_nan: bool  # default: True
+    # the config options are used to customise serialization to JSON
+    ser_json_timedelta: Literal['iso8601', 'float']  # default: 'iso8601'
+    ser_json_bytes: Literal['utf8', 'base64', 'hex']  # default: 'utf8'
+    ser_json_inf_nan: Literal['null', 'constants']  # default: 'null'
+    # used to hide input data from ValidationError repr
+    hide_input_in_errors: bool
+    validation_error_cause: bool  # default: False
+    coerce_numbers_to_str: bool  # default: False
+    regex_engine: Literal['rust-regex', 'python-re']  # default: 'rust-regex'
+
+
+IncExCall: TypeAlias = 'set[int | str] | dict[int | str, IncExCall] | None'
+
+
+class SerializationInfo(Protocol):
+    @property
+    def include(self) -> IncExCall:
+        ...
+
+    @property
+    def exclude(self) -> IncExCall:
+        ...
+
+    @property
+    def mode(self) -> str:
+        ...
+
+    @property
+    def by_alias(self) -> bool:
+        ...
+
+    @property
+    def exclude_unset(self) -> bool:
+        ...
+
+    @property
+    def exclude_defaults(self) -> bool:
+        ...
+
+    @property
+    def exclude_none(self) -> bool:
+        ...
+
+    @property
+    def round_trip(self) -> bool:
+        ...
+
+    def mode_is_json(self) -> bool:
+        ...
+
+    def __str__(self) -> str:
+        ...
+
+    def __repr__(self) -> str:
+        ...
+
+
+class FieldSerializationInfo(SerializationInfo, Protocol):
+    @property
+    def field_name(self) -> str:
+        ...
+
+
+class ValidationInfo(Protocol):
+    """
+    Argument passed to validation functions.
+    """
+
+    @property
+    def context(self) -> Any | None:
+        """Current validation context."""
+        ...
+
+    @property
+    def config(self) -> CoreConfig | None:
+        """The CoreConfig that applies to this validation."""
+        ...
+
+    @property
+    def mode(self) -> Literal['python', 'json']:
+        """The type of input data we are currently validating"""
+        ...
+
+    @property
+    def data(self) -> Dict[str, Any]:
+        """The data being validated for this model."""
+        ...
+
+    @property
+    def field_name(self) -> str | None:
+        """
+        The name of the current field being validated if this validator is
+        attached to a model field.
+        """
+        ...
+
+
+ExpectedSerializationTypes = Literal[
+    'none',
+    'int',
+    'bool',
+    'float',
+    'str',
+    'bytes',
+    'bytearray',
+    'list',
+    'tuple',
+    'set',
+    'frozenset',
+    'generator',
+    'dict',
+    'datetime',
+    'date',
+    'time',
+    'timedelta',
+    'url',
+    'multi-host-url',
+    'json',
+    'uuid',
+]
+
+
+class SimpleSerSchema(TypedDict, total=False):
+    type: Required[ExpectedSerializationTypes]
+
+
+def simple_ser_schema(type: ExpectedSerializationTypes) -> SimpleSerSchema:
+    """
+    Returns a schema for serialization with a custom type.
+
+    Args:
+        type: The type to use for serialization
+    """
+    return SimpleSerSchema(type=type)
+
+
+# (__input_value: Any) -> Any
+GeneralPlainNoInfoSerializerFunction = Callable[[Any], Any]
+# (__input_value: Any, __info: FieldSerializationInfo) -> Any
+GeneralPlainInfoSerializerFunction = Callable[[Any, SerializationInfo], Any]
+# (__model: Any, __input_value: Any) -> Any
+FieldPlainNoInfoSerializerFunction = Callable[[Any, Any], Any]
+# (__model: Any, __input_value: Any, __info: FieldSerializationInfo) -> Any
+FieldPlainInfoSerializerFunction = Callable[[Any, Any, FieldSerializationInfo], Any]
+SerializerFunction = Union[
+    GeneralPlainNoInfoSerializerFunction,
+    GeneralPlainInfoSerializerFunction,
+    FieldPlainNoInfoSerializerFunction,
+    FieldPlainInfoSerializerFunction,
+]
+
+WhenUsed = Literal['always', 'unless-none', 'json', 'json-unless-none']
+"""
+Values have the following meanings:
+
+* `'always'` means always use
+* `'unless-none'` means use unless the value is `None`
+* `'json'` means use when serializing to JSON
+* `'json-unless-none'` means use when serializing to JSON and the value is not `None`
+"""
+
+
+class PlainSerializerFunctionSerSchema(TypedDict, total=False):
+    type: Required[Literal['function-plain']]
+    function: Required[SerializerFunction]
+    is_field_serializer: bool  # default False
+    info_arg: bool  # default False
+    return_schema: CoreSchema  # if omitted, AnySchema is used
+    when_used: WhenUsed  # default: 'always'
+
+
+def plain_serializer_function_ser_schema(
+    function: SerializerFunction,
+    *,
+    is_field_serializer: bool | None = None,
+    info_arg: bool | None = None,
+    return_schema: CoreSchema | None = None,
+    when_used: WhenUsed = 'always',
+) -> PlainSerializerFunctionSerSchema:
+    """
+    Returns a schema for serialization with a function, can be either a "general" or "field" function.
+
+    Args:
+        function: The function to use for serialization
+        is_field_serializer: Whether the serializer is for a field, e.g. takes `model` as the first argument,
+            and `info` includes `field_name`
+        info_arg: Whether the function takes an `__info` argument
+        return_schema: Schema to use for serializing return value
+        when_used: When the function should be called
+    """
+    if when_used == 'always':
+        # just to avoid extra elements in schema, and to use the actual default defined in rust
+        when_used = None  # type: ignore
+    return _dict_not_none(
+        type='function-plain',
+        function=function,
+        is_field_serializer=is_field_serializer,
+        info_arg=info_arg,
+        return_schema=return_schema,
+        when_used=when_used,
+    )
+
+
+class SerializerFunctionWrapHandler(Protocol):  # pragma: no cover
+    def __call__(self, __input_value: Any, __index_key: int | str | None = None) -> Any:
+        ...
+
+
+# (__input_value: Any, __serializer: SerializerFunctionWrapHandler) -> Any
+GeneralWrapNoInfoSerializerFunction = Callable[[Any, SerializerFunctionWrapHandler], Any]
+# (__input_value: Any, __serializer: SerializerFunctionWrapHandler, __info: SerializationInfo) -> Any
+GeneralWrapInfoSerializerFunction = Callable[[Any, SerializerFunctionWrapHandler, SerializationInfo], Any]
+# (__model: Any, __input_value: Any, __serializer: SerializerFunctionWrapHandler) -> Any
+FieldWrapNoInfoSerializerFunction = Callable[[Any, Any, SerializerFunctionWrapHandler], Any]
+# (__model: Any, __input_value: Any, __serializer: SerializerFunctionWrapHandler, __info: FieldSerializationInfo) -> Any
+FieldWrapInfoSerializerFunction = Callable[[Any, Any, SerializerFunctionWrapHandler, FieldSerializationInfo], Any]
+WrapSerializerFunction = Union[
+    GeneralWrapNoInfoSerializerFunction,
+    GeneralWrapInfoSerializerFunction,
+    FieldWrapNoInfoSerializerFunction,
+    FieldWrapInfoSerializerFunction,
+]
+
+
+class WrapSerializerFunctionSerSchema(TypedDict, total=False):
+    type: Required[Literal['function-wrap']]
+    function: Required[WrapSerializerFunction]
+    is_field_serializer: bool  # default False
+    info_arg: bool  # default False
+    schema: CoreSchema  # if omitted, the schema on which this serializer is defined is used
+    return_schema: CoreSchema  # if omitted, AnySchema is used
+    when_used: WhenUsed  # default: 'always'
+
+
+def wrap_serializer_function_ser_schema(
+    function: WrapSerializerFunction,
+    *,
+    is_field_serializer: bool | None = None,
+    info_arg: bool | None = None,
+    schema: CoreSchema | None = None,
+    return_schema: CoreSchema | None = None,
+    when_used: WhenUsed = 'always',
+) -> WrapSerializerFunctionSerSchema:
+    """
+    Returns a schema for serialization with a wrap function, can be either a "general" or "field" function.
+
+    Args:
+        function: The function to use for serialization
+        is_field_serializer: Whether the serializer is for a field, e.g. takes `model` as the first argument,
+            and `info` includes `field_name`
+        info_arg: Whether the function takes an `__info` argument
+        schema: The schema to use for the inner serialization
+        return_schema: Schema to use for serializing return value
+        when_used: When the function should be called
+    """
+    if when_used == 'always':
+        # just to avoid extra elements in schema, and to use the actual default defined in rust
+        when_used = None  # type: ignore
+    return _dict_not_none(
+        type='function-wrap',
+        function=function,
+        is_field_serializer=is_field_serializer,
+        info_arg=info_arg,
+        schema=schema,
+        return_schema=return_schema,
+        when_used=when_used,
+    )
+
+
+class FormatSerSchema(TypedDict, total=False):
+    type: Required[Literal['format']]
+    formatting_string: Required[str]
+    when_used: WhenUsed  # default: 'json-unless-none'
+
+
+def format_ser_schema(formatting_string: str, *, when_used: WhenUsed = 'json-unless-none') -> FormatSerSchema:
+    """
+    Returns a schema for serialization using python's `format` method.
+
+    Args:
+        formatting_string: String defining the format to use
+        when_used: Same meaning as for [general_function_plain_ser_schema], but with a different default
+    """
+    if when_used == 'json-unless-none':
+        # just to avoid extra elements in schema, and to use the actual default defined in rust
+        when_used = None  # type: ignore
+    return _dict_not_none(type='format', formatting_string=formatting_string, when_used=when_used)
+
+
+class ToStringSerSchema(TypedDict, total=False):
+    type: Required[Literal['to-string']]
+    when_used: WhenUsed  # default: 'json-unless-none'
+
+
+def to_string_ser_schema(*, when_used: WhenUsed = 'json-unless-none') -> ToStringSerSchema:
+    """
+    Returns a schema for serialization using python's `str()` / `__str__` method.
+
+    Args:
+        when_used: Same meaning as for [general_function_plain_ser_schema], but with a different default
+    """
+    s = dict(type='to-string')
+    if when_used != 'json-unless-none':
+        # just to avoid extra elements in schema, and to use the actual default defined in rust
+        s['when_used'] = when_used
+    return s  # type: ignore
+
+
+class ModelSerSchema(TypedDict, total=False):
+    type: Required[Literal['model']]
+    cls: Required[Type[Any]]
+    schema: Required[CoreSchema]
+
+
+def model_ser_schema(cls: Type[Any], schema: CoreSchema) -> ModelSerSchema:
+    """
+    Returns a schema for serialization using a model.
+
+    Args:
+        cls: The expected class type, used to generate warnings if the wrong type is passed
+        schema: Internal schema to use to serialize the model dict
+    """
+    return ModelSerSchema(type='model', cls=cls, schema=schema)
+
+
+SerSchema = Union[
+    SimpleSerSchema,
+    PlainSerializerFunctionSerSchema,
+    WrapSerializerFunctionSerSchema,
+    FormatSerSchema,
+    ToStringSerSchema,
+    ModelSerSchema,
+]
+
+
+class ComputedField(TypedDict, total=False):
+    type: Required[Literal['computed-field']]
+    property_name: Required[str]
+    return_schema: Required[CoreSchema]
+    alias: str
+    metadata: Any
+
+
+def computed_field(
+    property_name: str, return_schema: CoreSchema, *, alias: str | None = None, metadata: Any = None
+) -> ComputedField:
+    """
+    ComputedFields are properties of a model or dataclass that are included in serialization.
+
+    Args:
+        property_name: The name of the property on the model or dataclass
+        return_schema: The schema used for the type returned by the computed field
+        alias: The name to use in the serialized output
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+    """
+    return _dict_not_none(
+        type='computed-field', property_name=property_name, return_schema=return_schema, alias=alias, metadata=metadata
+    )
+
+
+class AnySchema(TypedDict, total=False):
+    type: Required[Literal['any']]
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def any_schema(*, ref: str | None = None, metadata: Any = None, serialization: SerSchema | None = None) -> AnySchema:
+    """
+    Returns a schema that matches any value, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.any_schema()
+    v = SchemaValidator(schema)
+    assert v.validate_python(1) == 1
+    ```
+
+    Args:
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(type='any', ref=ref, metadata=metadata, serialization=serialization)
+
+
+class NoneSchema(TypedDict, total=False):
+    type: Required[Literal['none']]
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def none_schema(*, ref: str | None = None, metadata: Any = None, serialization: SerSchema | None = None) -> NoneSchema:
+    """
+    Returns a schema that matches a None value, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.none_schema()
+    v = SchemaValidator(schema)
+    assert v.validate_python(None) is None
+    ```
+
+    Args:
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(type='none', ref=ref, metadata=metadata, serialization=serialization)
+
+
+class BoolSchema(TypedDict, total=False):
+    type: Required[Literal['bool']]
+    strict: bool
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def bool_schema(
+    strict: bool | None = None, ref: str | None = None, metadata: Any = None, serialization: SerSchema | None = None
+) -> BoolSchema:
+    """
+    Returns a schema that matches a bool value, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.bool_schema()
+    v = SchemaValidator(schema)
+    assert v.validate_python('True') is True
+    ```
+
+    Args:
+        strict: Whether the value should be a bool or a value that can be converted to a bool
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(type='bool', strict=strict, ref=ref, metadata=metadata, serialization=serialization)
+
+
+class IntSchema(TypedDict, total=False):
+    type: Required[Literal['int']]
+    multiple_of: int
+    le: int
+    ge: int
+    lt: int
+    gt: int
+    strict: bool
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def int_schema(
+    *,
+    multiple_of: int | None = None,
+    le: int | None = None,
+    ge: int | None = None,
+    lt: int | None = None,
+    gt: int | None = None,
+    strict: bool | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> IntSchema:
+    """
+    Returns a schema that matches a int value, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.int_schema(multiple_of=2, le=6, ge=2)
+    v = SchemaValidator(schema)
+    assert v.validate_python('4') == 4
+    ```
+
+    Args:
+        multiple_of: The value must be a multiple of this number
+        le: The value must be less than or equal to this number
+        ge: The value must be greater than or equal to this number
+        lt: The value must be strictly less than this number
+        gt: The value must be strictly greater than this number
+        strict: Whether the value should be a int or a value that can be converted to a int
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='int',
+        multiple_of=multiple_of,
+        le=le,
+        ge=ge,
+        lt=lt,
+        gt=gt,
+        strict=strict,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class FloatSchema(TypedDict, total=False):
+    type: Required[Literal['float']]
+    allow_inf_nan: bool  # whether 'NaN', '+inf', '-inf' should be forbidden. default: True
+    multiple_of: float
+    le: float
+    ge: float
+    lt: float
+    gt: float
+    strict: bool
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def float_schema(
+    *,
+    allow_inf_nan: bool | None = None,
+    multiple_of: float | None = None,
+    le: float | None = None,
+    ge: float | None = None,
+    lt: float | None = None,
+    gt: float | None = None,
+    strict: bool | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> FloatSchema:
+    """
+    Returns a schema that matches a float value, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.float_schema(le=0.8, ge=0.2)
+    v = SchemaValidator(schema)
+    assert v.validate_python('0.5') == 0.5
+    ```
+
+    Args:
+        allow_inf_nan: Whether to allow inf and nan values
+        multiple_of: The value must be a multiple of this number
+        le: The value must be less than or equal to this number
+        ge: The value must be greater than or equal to this number
+        lt: The value must be strictly less than this number
+        gt: The value must be strictly greater than this number
+        strict: Whether the value should be a float or a value that can be converted to a float
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='float',
+        allow_inf_nan=allow_inf_nan,
+        multiple_of=multiple_of,
+        le=le,
+        ge=ge,
+        lt=lt,
+        gt=gt,
+        strict=strict,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class DecimalSchema(TypedDict, total=False):
+    type: Required[Literal['decimal']]
+    allow_inf_nan: bool  # whether 'NaN', '+inf', '-inf' should be forbidden. default: False
+    multiple_of: Decimal
+    le: Decimal
+    ge: Decimal
+    lt: Decimal
+    gt: Decimal
+    max_digits: int
+    decimal_places: int
+    strict: bool
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def decimal_schema(
+    *,
+    allow_inf_nan: bool = None,
+    multiple_of: Decimal | None = None,
+    le: Decimal | None = None,
+    ge: Decimal | None = None,
+    lt: Decimal | None = None,
+    gt: Decimal | None = None,
+    max_digits: int | None = None,
+    decimal_places: int | None = None,
+    strict: bool | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> DecimalSchema:
+    """
+    Returns a schema that matches a decimal value, e.g.:
+
+    ```py
+    from decimal import Decimal
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.decimal_schema(le=0.8, ge=0.2)
+    v = SchemaValidator(schema)
+    assert v.validate_python('0.5') == Decimal('0.5')
+    ```
+
+    Args:
+        allow_inf_nan: Whether to allow inf and nan values
+        multiple_of: The value must be a multiple of this number
+        le: The value must be less than or equal to this number
+        ge: The value must be greater than or equal to this number
+        lt: The value must be strictly less than this number
+        gt: The value must be strictly greater than this number
+        max_digits: The maximum number of decimal digits allowed
+        decimal_places: The maximum number of decimal places allowed
+        strict: Whether the value should be a float or a value that can be converted to a float
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='decimal',
+        gt=gt,
+        ge=ge,
+        lt=lt,
+        le=le,
+        max_digits=max_digits,
+        decimal_places=decimal_places,
+        multiple_of=multiple_of,
+        allow_inf_nan=allow_inf_nan,
+        strict=strict,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class StringSchema(TypedDict, total=False):
+    type: Required[Literal['str']]
+    pattern: str
+    max_length: int
+    min_length: int
+    strip_whitespace: bool
+    to_lower: bool
+    to_upper: bool
+    regex_engine: Literal['rust-regex', 'python-re']  # default: 'rust-regex'
+    strict: bool
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def str_schema(
+    *,
+    pattern: str | None = None,
+    max_length: int | None = None,
+    min_length: int | None = None,
+    strip_whitespace: bool | None = None,
+    to_lower: bool | None = None,
+    to_upper: bool | None = None,
+    regex_engine: Literal['rust-regex', 'python-re'] | None = None,
+    strict: bool | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> StringSchema:
+    """
+    Returns a schema that matches a string value, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.str_schema(max_length=10, min_length=2)
+    v = SchemaValidator(schema)
+    assert v.validate_python('hello') == 'hello'
+    ```
+
+    Args:
+        pattern: A regex pattern that the value must match
+        max_length: The value must be at most this length
+        min_length: The value must be at least this length
+        strip_whitespace: Whether to strip whitespace from the value
+        to_lower: Whether to convert the value to lowercase
+        to_upper: Whether to convert the value to uppercase
+        regex_engine: The regex engine to use for pattern validation. Default is 'rust-regex'.
+            - `rust-regex` uses the [`regex`](https://docs.rs/regex) Rust
+              crate, which is non-backtracking and therefore more DDoS
+              resistant, but does not support all regex features.
+            - `python-re` use the [`re`](https://docs.python.org/3/library/re.html) module,
+              which supports all regex features, but may be slower.
+        strict: Whether the value should be a string or a value that can be converted to a string
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='str',
+        pattern=pattern,
+        max_length=max_length,
+        min_length=min_length,
+        strip_whitespace=strip_whitespace,
+        to_lower=to_lower,
+        to_upper=to_upper,
+        regex_engine=regex_engine,
+        strict=strict,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class BytesSchema(TypedDict, total=False):
+    type: Required[Literal['bytes']]
+    max_length: int
+    min_length: int
+    strict: bool
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def bytes_schema(
+    *,
+    max_length: int | None = None,
+    min_length: int | None = None,
+    strict: bool | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> BytesSchema:
+    """
+    Returns a schema that matches a bytes value, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.bytes_schema(max_length=10, min_length=2)
+    v = SchemaValidator(schema)
+    assert v.validate_python(b'hello') == b'hello'
+    ```
+
+    Args:
+        max_length: The value must be at most this length
+        min_length: The value must be at least this length
+        strict: Whether the value should be a bytes or a value that can be converted to a bytes
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='bytes',
+        max_length=max_length,
+        min_length=min_length,
+        strict=strict,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class DateSchema(TypedDict, total=False):
+    type: Required[Literal['date']]
+    strict: bool
+    le: date
+    ge: date
+    lt: date
+    gt: date
+    now_op: Literal['past', 'future']
+    # defaults to current local utc offset from `time.localtime().tm_gmtoff`
+    # value is restricted to -86_400 < offset < 86_400 by bounds in generate_self_schema.py
+    now_utc_offset: int
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def date_schema(
+    *,
+    strict: bool | None = None,
+    le: date | None = None,
+    ge: date | None = None,
+    lt: date | None = None,
+    gt: date | None = None,
+    now_op: Literal['past', 'future'] | None = None,
+    now_utc_offset: int | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> DateSchema:
+    """
+    Returns a schema that matches a date value, e.g.:
+
+    ```py
+    from datetime import date
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.date_schema(le=date(2020, 1, 1), ge=date(2019, 1, 1))
+    v = SchemaValidator(schema)
+    assert v.validate_python(date(2019, 6, 1)) == date(2019, 6, 1)
+    ```
+
+    Args:
+        strict: Whether the value should be a date or a value that can be converted to a date
+        le: The value must be less than or equal to this date
+        ge: The value must be greater than or equal to this date
+        lt: The value must be strictly less than this date
+        gt: The value must be strictly greater than this date
+        now_op: The value must be in the past or future relative to the current date
+        now_utc_offset: The value must be in the past or future relative to the current date with this utc offset
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='date',
+        strict=strict,
+        le=le,
+        ge=ge,
+        lt=lt,
+        gt=gt,
+        now_op=now_op,
+        now_utc_offset=now_utc_offset,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class TimeSchema(TypedDict, total=False):
+    type: Required[Literal['time']]
+    strict: bool
+    le: time
+    ge: time
+    lt: time
+    gt: time
+    tz_constraint: Union[Literal['aware', 'naive'], int]
+    microseconds_precision: Literal['truncate', 'error']
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def time_schema(
+    *,
+    strict: bool | None = None,
+    le: time | None = None,
+    ge: time | None = None,
+    lt: time | None = None,
+    gt: time | None = None,
+    tz_constraint: Literal['aware', 'naive'] | int | None = None,
+    microseconds_precision: Literal['truncate', 'error'] = 'truncate',
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> TimeSchema:
+    """
+    Returns a schema that matches a time value, e.g.:
+
+    ```py
+    from datetime import time
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.time_schema(le=time(12, 0, 0), ge=time(6, 0, 0))
+    v = SchemaValidator(schema)
+    assert v.validate_python(time(9, 0, 0)) == time(9, 0, 0)
+    ```
+
+    Args:
+        strict: Whether the value should be a time or a value that can be converted to a time
+        le: The value must be less than or equal to this time
+        ge: The value must be greater than or equal to this time
+        lt: The value must be strictly less than this time
+        gt: The value must be strictly greater than this time
+        tz_constraint: The value must be timezone aware or naive, or an int to indicate required tz offset
+        microseconds_precision: The behavior when seconds have more than 6 digits or microseconds is too large
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='time',
+        strict=strict,
+        le=le,
+        ge=ge,
+        lt=lt,
+        gt=gt,
+        tz_constraint=tz_constraint,
+        microseconds_precision=microseconds_precision,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class DatetimeSchema(TypedDict, total=False):
+    type: Required[Literal['datetime']]
+    strict: bool
+    le: datetime
+    ge: datetime
+    lt: datetime
+    gt: datetime
+    now_op: Literal['past', 'future']
+    tz_constraint: Union[Literal['aware', 'naive'], int]
+    # defaults to current local utc offset from `time.localtime().tm_gmtoff`
+    # value is restricted to -86_400 < offset < 86_400 by bounds in generate_self_schema.py
+    now_utc_offset: int
+    microseconds_precision: Literal['truncate', 'error']  # default: 'truncate'
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def datetime_schema(
+    *,
+    strict: bool | None = None,
+    le: datetime | None = None,
+    ge: datetime | None = None,
+    lt: datetime | None = None,
+    gt: datetime | None = None,
+    now_op: Literal['past', 'future'] | None = None,
+    tz_constraint: Literal['aware', 'naive'] | int | None = None,
+    now_utc_offset: int | None = None,
+    microseconds_precision: Literal['truncate', 'error'] = 'truncate',
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> DatetimeSchema:
+    """
+    Returns a schema that matches a datetime value, e.g.:
+
+    ```py
+    from datetime import datetime
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.datetime_schema()
+    v = SchemaValidator(schema)
+    now = datetime.now()
+    assert v.validate_python(str(now)) == now
+    ```
+
+    Args:
+        strict: Whether the value should be a datetime or a value that can be converted to a datetime
+        le: The value must be less than or equal to this datetime
+        ge: The value must be greater than or equal to this datetime
+        lt: The value must be strictly less than this datetime
+        gt: The value must be strictly greater than this datetime
+        now_op: The value must be in the past or future relative to the current datetime
+        tz_constraint: The value must be timezone aware or naive, or an int to indicate required tz offset
+            TODO: use of a tzinfo where offset changes based on the datetime is not yet supported
+        now_utc_offset: The value must be in the past or future relative to the current datetime with this utc offset
+        microseconds_precision: The behavior when seconds have more than 6 digits or microseconds is too large
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='datetime',
+        strict=strict,
+        le=le,
+        ge=ge,
+        lt=lt,
+        gt=gt,
+        now_op=now_op,
+        tz_constraint=tz_constraint,
+        now_utc_offset=now_utc_offset,
+        microseconds_precision=microseconds_precision,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class TimedeltaSchema(TypedDict, total=False):
+    type: Required[Literal['timedelta']]
+    strict: bool
+    le: timedelta
+    ge: timedelta
+    lt: timedelta
+    gt: timedelta
+    microseconds_precision: Literal['truncate', 'error']
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def timedelta_schema(
+    *,
+    strict: bool | None = None,
+    le: timedelta | None = None,
+    ge: timedelta | None = None,
+    lt: timedelta | None = None,
+    gt: timedelta | None = None,
+    microseconds_precision: Literal['truncate', 'error'] = 'truncate',
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> TimedeltaSchema:
+    """
+    Returns a schema that matches a timedelta value, e.g.:
+
+    ```py
+    from datetime import timedelta
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.timedelta_schema(le=timedelta(days=1), ge=timedelta(days=0))
+    v = SchemaValidator(schema)
+    assert v.validate_python(timedelta(hours=12)) == timedelta(hours=12)
+    ```
+
+    Args:
+        strict: Whether the value should be a timedelta or a value that can be converted to a timedelta
+        le: The value must be less than or equal to this timedelta
+        ge: The value must be greater than or equal to this timedelta
+        lt: The value must be strictly less than this timedelta
+        gt: The value must be strictly greater than this timedelta
+        microseconds_precision: The behavior when seconds have more than 6 digits or microseconds is too large
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='timedelta',
+        strict=strict,
+        le=le,
+        ge=ge,
+        lt=lt,
+        gt=gt,
+        microseconds_precision=microseconds_precision,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class LiteralSchema(TypedDict, total=False):
+    type: Required[Literal['literal']]
+    expected: Required[List[Any]]
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def literal_schema(
+    expected: list[Any], *, ref: str | None = None, metadata: Any = None, serialization: SerSchema | None = None
+) -> LiteralSchema:
+    """
+    Returns a schema that matches a literal value, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.literal_schema(['hello', 'world'])
+    v = SchemaValidator(schema)
+    assert v.validate_python('hello') == 'hello'
+    ```
+
+    Args:
+        expected: The value must be one of these values
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(type='literal', expected=expected, ref=ref, metadata=metadata, serialization=serialization)
+
+
+# must match input/parse_json.rs::JsonType::try_from
+JsonType = Literal['null', 'bool', 'int', 'float', 'str', 'list', 'dict']
+
+
+class IsInstanceSchema(TypedDict, total=False):
+    type: Required[Literal['is-instance']]
+    cls: Required[Any]
+    cls_repr: str
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def is_instance_schema(
+    cls: Any,
+    *,
+    cls_repr: str | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> IsInstanceSchema:
+    """
+    Returns a schema that checks if a value is an instance of a class, equivalent to python's `isinstance` method, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    class A:
+        pass
+
+    schema = core_schema.is_instance_schema(cls=A)
+    v = SchemaValidator(schema)
+    v.validate_python(A())
+    ```
+
+    Args:
+        cls: The value must be an instance of this class
+        cls_repr: If provided this string is used in the validator name instead of `repr(cls)`
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='is-instance', cls=cls, cls_repr=cls_repr, ref=ref, metadata=metadata, serialization=serialization
+    )
+
+
+class IsSubclassSchema(TypedDict, total=False):
+    type: Required[Literal['is-subclass']]
+    cls: Required[Type[Any]]
+    cls_repr: str
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def is_subclass_schema(
+    cls: Type[Any],
+    *,
+    cls_repr: str | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> IsInstanceSchema:
+    """
+    Returns a schema that checks if a value is a subtype of a class, equivalent to python's `issubclass` method, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    class A:
+        pass
+
+    class B(A):
+        pass
+
+    schema = core_schema.is_subclass_schema(cls=A)
+    v = SchemaValidator(schema)
+    v.validate_python(B)
+    ```
+
+    Args:
+        cls: The value must be a subclass of this class
+        cls_repr: If provided this string is used in the validator name instead of `repr(cls)`
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='is-subclass', cls=cls, cls_repr=cls_repr, ref=ref, metadata=metadata, serialization=serialization
+    )
+
+
+class CallableSchema(TypedDict, total=False):
+    type: Required[Literal['callable']]
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def callable_schema(
+    *, ref: str | None = None, metadata: Any = None, serialization: SerSchema | None = None
+) -> CallableSchema:
+    """
+    Returns a schema that checks if a value is callable, equivalent to python's `callable` method, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.callable_schema()
+    v = SchemaValidator(schema)
+    v.validate_python(min)
+    ```
+
+    Args:
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(type='callable', ref=ref, metadata=metadata, serialization=serialization)
+
+
+class UuidSchema(TypedDict, total=False):
+    type: Required[Literal['uuid']]
+    version: Literal[1, 3, 4, 5]
+    strict: bool
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def uuid_schema(
+    *,
+    version: Literal[1, 3, 4, 5] | None = None,
+    strict: bool | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> UuidSchema:
+    return _dict_not_none(
+        type='uuid', version=version, strict=strict, ref=ref, metadata=metadata, serialization=serialization
+    )
+
+
+class IncExSeqSerSchema(TypedDict, total=False):
+    type: Required[Literal['include-exclude-sequence']]
+    include: Set[int]
+    exclude: Set[int]
+
+
+def filter_seq_schema(*, include: Set[int] | None = None, exclude: Set[int] | None = None) -> IncExSeqSerSchema:
+    return _dict_not_none(type='include-exclude-sequence', include=include, exclude=exclude)
+
+
+IncExSeqOrElseSerSchema = Union[IncExSeqSerSchema, SerSchema]
+
+
+class ListSchema(TypedDict, total=False):
+    type: Required[Literal['list']]
+    items_schema: CoreSchema
+    min_length: int
+    max_length: int
+    strict: bool
+    ref: str
+    metadata: Any
+    serialization: IncExSeqOrElseSerSchema
+
+
+def list_schema(
+    items_schema: CoreSchema | None = None,
+    *,
+    min_length: int | None = None,
+    max_length: int | None = None,
+    strict: bool | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: IncExSeqOrElseSerSchema | None = None,
+) -> ListSchema:
+    """
+    Returns a schema that matches a list value, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.list_schema(core_schema.int_schema(), min_length=0, max_length=10)
+    v = SchemaValidator(schema)
+    assert v.validate_python(['4']) == [4]
+    ```
+
+    Args:
+        items_schema: The value must be a list of items that match this schema
+        min_length: The value must be a list with at least this many items
+        max_length: The value must be a list with at most this many items
+        strict: The value must be a list with exactly this many items
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='list',
+        items_schema=items_schema,
+        min_length=min_length,
+        max_length=max_length,
+        strict=strict,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+# @deprecated('tuple_positional_schema is deprecated. Use pydantic_core.core_schema.tuple_schema instead.')
+def tuple_positional_schema(
+    items_schema: list[CoreSchema],
+    *,
+    extras_schema: CoreSchema | None = None,
+    strict: bool | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: IncExSeqOrElseSerSchema | None = None,
+) -> TupleSchema:
+    """
+    Returns a schema that matches a tuple of schemas, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.tuple_positional_schema(
+        [core_schema.int_schema(), core_schema.str_schema()]
+    )
+    v = SchemaValidator(schema)
+    assert v.validate_python((1, 'hello')) == (1, 'hello')
+    ```
+
+    Args:
+        items_schema: The value must be a tuple with items that match these schemas
+        extras_schema: The value must be a tuple with items that match this schema
+            This was inspired by JSON schema's `prefixItems` and `items` fields.
+            In python's `typing.Tuple`, you can't specify a type for "extra" items -- they must all be the same type
+            if the length is variable. So this field won't be set from a `typing.Tuple` annotation on a pydantic model.
+        strict: The value must be a tuple with exactly this many items
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    if extras_schema is not None:
+        variadic_item_index = len(items_schema)
+        items_schema = items_schema + [extras_schema]
+    else:
+        variadic_item_index = None
+    return tuple_schema(
+        items_schema=items_schema,
+        variadic_item_index=variadic_item_index,
+        strict=strict,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+# @deprecated('tuple_variable_schema is deprecated. Use pydantic_core.core_schema.tuple_schema instead.')
+def tuple_variable_schema(
+    items_schema: CoreSchema | None = None,
+    *,
+    min_length: int | None = None,
+    max_length: int | None = None,
+    strict: bool | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: IncExSeqOrElseSerSchema | None = None,
+) -> TupleSchema:
+    """
+    Returns a schema that matches a tuple of a given schema, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.tuple_variable_schema(
+        items_schema=core_schema.int_schema(), min_length=0, max_length=10
+    )
+    v = SchemaValidator(schema)
+    assert v.validate_python(('1', 2, 3)) == (1, 2, 3)
+    ```
+
+    Args:
+        items_schema: The value must be a tuple with items that match this schema
+        min_length: The value must be a tuple with at least this many items
+        max_length: The value must be a tuple with at most this many items
+        strict: The value must be a tuple with exactly this many items
+        ref: Optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return tuple_schema(
+        items_schema=[items_schema or any_schema()],
+        variadic_item_index=0,
+        min_length=min_length,
+        max_length=max_length,
+        strict=strict,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class TupleSchema(TypedDict, total=False):
+    type: Required[Literal['tuple']]
+    items_schema: Required[List[CoreSchema]]
+    variadic_item_index: int
+    min_length: int
+    max_length: int
+    strict: bool
+    ref: str
+    metadata: Any
+    serialization: IncExSeqOrElseSerSchema
+
+
+def tuple_schema(
+    items_schema: list[CoreSchema],
+    *,
+    variadic_item_index: int | None = None,
+    min_length: int | None = None,
+    max_length: int | None = None,
+    strict: bool | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: IncExSeqOrElseSerSchema | None = None,
+) -> TupleSchema:
+    """
+    Returns a schema that matches a tuple of schemas, with an optional variadic item, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.tuple_schema(
+        [core_schema.int_schema(), core_schema.str_schema(), core_schema.float_schema()],
+        variadic_item_index=1,
+    )
+    v = SchemaValidator(schema)
+    assert v.validate_python((1, 'hello', 'world', 1.5)) == (1, 'hello', 'world', 1.5)
+    ```
+
+    Args:
+        items_schema: The value must be a tuple with items that match these schemas
+        variadic_item_index: The index of the schema in `items_schema` to be treated as variadic (following PEP 646)
+        min_length: The value must be a tuple with at least this many items
+        max_length: The value must be a tuple with at most this many items
+        strict: The value must be a tuple with exactly this many items
+        ref: Optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='tuple',
+        items_schema=items_schema,
+        variadic_item_index=variadic_item_index,
+        min_length=min_length,
+        max_length=max_length,
+        strict=strict,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class SetSchema(TypedDict, total=False):
+    type: Required[Literal['set']]
+    items_schema: CoreSchema
+    min_length: int
+    max_length: int
+    strict: bool
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def set_schema(
+    items_schema: CoreSchema | None = None,
+    *,
+    min_length: int | None = None,
+    max_length: int | None = None,
+    strict: bool | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> SetSchema:
+    """
+    Returns a schema that matches a set of a given schema, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.set_schema(
+        items_schema=core_schema.int_schema(), min_length=0, max_length=10
+    )
+    v = SchemaValidator(schema)
+    assert v.validate_python({1, '2', 3}) == {1, 2, 3}
+    ```
+
+    Args:
+        items_schema: The value must be a set with items that match this schema
+        min_length: The value must be a set with at least this many items
+        max_length: The value must be a set with at most this many items
+        strict: The value must be a set with exactly this many items
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='set',
+        items_schema=items_schema,
+        min_length=min_length,
+        max_length=max_length,
+        strict=strict,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class FrozenSetSchema(TypedDict, total=False):
+    type: Required[Literal['frozenset']]
+    items_schema: CoreSchema
+    min_length: int
+    max_length: int
+    strict: bool
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def frozenset_schema(
+    items_schema: CoreSchema | None = None,
+    *,
+    min_length: int | None = None,
+    max_length: int | None = None,
+    strict: bool | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> FrozenSetSchema:
+    """
+    Returns a schema that matches a frozenset of a given schema, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.frozenset_schema(
+        items_schema=core_schema.int_schema(), min_length=0, max_length=10
+    )
+    v = SchemaValidator(schema)
+    assert v.validate_python(frozenset(range(3))) == frozenset({0, 1, 2})
+    ```
+
+    Args:
+        items_schema: The value must be a frozenset with items that match this schema
+        min_length: The value must be a frozenset with at least this many items
+        max_length: The value must be a frozenset with at most this many items
+        strict: The value must be a frozenset with exactly this many items
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='frozenset',
+        items_schema=items_schema,
+        min_length=min_length,
+        max_length=max_length,
+        strict=strict,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class GeneratorSchema(TypedDict, total=False):
+    type: Required[Literal['generator']]
+    items_schema: CoreSchema
+    min_length: int
+    max_length: int
+    ref: str
+    metadata: Any
+    serialization: IncExSeqOrElseSerSchema
+
+
+def generator_schema(
+    items_schema: CoreSchema | None = None,
+    *,
+    min_length: int | None = None,
+    max_length: int | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: IncExSeqOrElseSerSchema | None = None,
+) -> GeneratorSchema:
+    """
+    Returns a schema that matches a generator value, e.g.:
+
+    ```py
+    from typing import Iterator
+    from pydantic_core import SchemaValidator, core_schema
+
+    def gen() -> Iterator[int]:
+        yield 1
+
+    schema = core_schema.generator_schema(items_schema=core_schema.int_schema())
+    v = SchemaValidator(schema)
+    v.validate_python(gen())
+    ```
+
+    Unlike other types, validated generators do not raise ValidationErrors eagerly,
+    but instead will raise a ValidationError when a violating value is actually read from the generator.
+    This is to ensure that "validated" generators retain the benefit of lazy evaluation.
+
+    Args:
+        items_schema: The value must be a generator with items that match this schema
+        min_length: The value must be a generator that yields at least this many items
+        max_length: The value must be a generator that yields at most this many items
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='generator',
+        items_schema=items_schema,
+        min_length=min_length,
+        max_length=max_length,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+IncExDict = Set[Union[int, str]]
+
+
+class IncExDictSerSchema(TypedDict, total=False):
+    type: Required[Literal['include-exclude-dict']]
+    include: IncExDict
+    exclude: IncExDict
+
+
+def filter_dict_schema(*, include: IncExDict | None = None, exclude: IncExDict | None = None) -> IncExDictSerSchema:
+    return _dict_not_none(type='include-exclude-dict', include=include, exclude=exclude)
+
+
+IncExDictOrElseSerSchema = Union[IncExDictSerSchema, SerSchema]
+
+
+class DictSchema(TypedDict, total=False):
+    type: Required[Literal['dict']]
+    keys_schema: CoreSchema  # default: AnySchema
+    values_schema: CoreSchema  # default: AnySchema
+    min_length: int
+    max_length: int
+    strict: bool
+    ref: str
+    metadata: Any
+    serialization: IncExDictOrElseSerSchema
+
+
+def dict_schema(
+    keys_schema: CoreSchema | None = None,
+    values_schema: CoreSchema | None = None,
+    *,
+    min_length: int | None = None,
+    max_length: int | None = None,
+    strict: bool | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> DictSchema:
+    """
+    Returns a schema that matches a dict value, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.dict_schema(
+        keys_schema=core_schema.str_schema(), values_schema=core_schema.int_schema()
+    )
+    v = SchemaValidator(schema)
+    assert v.validate_python({'a': '1', 'b': 2}) == {'a': 1, 'b': 2}
+    ```
+
+    Args:
+        keys_schema: The value must be a dict with keys that match this schema
+        values_schema: The value must be a dict with values that match this schema
+        min_length: The value must be a dict with at least this many items
+        max_length: The value must be a dict with at most this many items
+        strict: Whether the keys and values should be validated with strict mode
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='dict',
+        keys_schema=keys_schema,
+        values_schema=values_schema,
+        min_length=min_length,
+        max_length=max_length,
+        strict=strict,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+# (__input_value: Any) -> Any
+NoInfoValidatorFunction = Callable[[Any], Any]
+
+
+class NoInfoValidatorFunctionSchema(TypedDict):
+    type: Literal['no-info']
+    function: NoInfoValidatorFunction
+
+
+# (__input_value: Any, __info: ValidationInfo) -> Any
+WithInfoValidatorFunction = Callable[[Any, ValidationInfo], Any]
+
+
+class WithInfoValidatorFunctionSchema(TypedDict, total=False):
+    type: Required[Literal['with-info']]
+    function: Required[WithInfoValidatorFunction]
+    field_name: str
+
+
+ValidationFunction = Union[NoInfoValidatorFunctionSchema, WithInfoValidatorFunctionSchema]
+
+
+class _ValidatorFunctionSchema(TypedDict, total=False):
+    function: Required[ValidationFunction]
+    schema: Required[CoreSchema]
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+class BeforeValidatorFunctionSchema(_ValidatorFunctionSchema, total=False):
+    type: Required[Literal['function-before']]
+
+
+def no_info_before_validator_function(
+    function: NoInfoValidatorFunction,
+    schema: CoreSchema,
+    *,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> BeforeValidatorFunctionSchema:
+    """
+    Returns a schema that calls a validator function before validating, no `info` argument is provided, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    def fn(v: bytes) -> str:
+        return v.decode() + 'world'
+
+    func_schema = core_schema.no_info_before_validator_function(
+        function=fn, schema=core_schema.str_schema()
+    )
+    schema = core_schema.typed_dict_schema({'a': core_schema.typed_dict_field(func_schema)})
+
+    v = SchemaValidator(schema)
+    assert v.validate_python({'a': b'hello '}) == {'a': 'hello world'}
+    ```
+
+    Args:
+        function: The validator function to call
+        schema: The schema to validate the output of the validator function
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='function-before',
+        function={'type': 'no-info', 'function': function},
+        schema=schema,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+def with_info_before_validator_function(
+    function: WithInfoValidatorFunction,
+    schema: CoreSchema,
+    *,
+    field_name: str | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> BeforeValidatorFunctionSchema:
+    """
+    Returns a schema that calls a validator function before validation, the function is called with
+    an `info` argument, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    def fn(v: bytes, info: core_schema.ValidationInfo) -> str:
+        assert info.data is not None
+        assert info.field_name is not None
+        return v.decode() + 'world'
+
+    func_schema = core_schema.with_info_before_validator_function(
+        function=fn, schema=core_schema.str_schema(), field_name='a'
+    )
+    schema = core_schema.typed_dict_schema({'a': core_schema.typed_dict_field(func_schema)})
+
+    v = SchemaValidator(schema)
+    assert v.validate_python({'a': b'hello '}) == {'a': 'hello world'}
+    ```
+
+    Args:
+        function: The validator function to call
+        field_name: The name of the field
+        schema: The schema to validate the output of the validator function
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='function-before',
+        function=_dict_not_none(type='with-info', function=function, field_name=field_name),
+        schema=schema,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class AfterValidatorFunctionSchema(_ValidatorFunctionSchema, total=False):
+    type: Required[Literal['function-after']]
+
+
+def no_info_after_validator_function(
+    function: NoInfoValidatorFunction,
+    schema: CoreSchema,
+    *,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> AfterValidatorFunctionSchema:
+    """
+    Returns a schema that calls a validator function after validating, no `info` argument is provided, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    def fn(v: str) -> str:
+        return v + 'world'
+
+    func_schema = core_schema.no_info_after_validator_function(fn, core_schema.str_schema())
+    schema = core_schema.typed_dict_schema({'a': core_schema.typed_dict_field(func_schema)})
+
+    v = SchemaValidator(schema)
+    assert v.validate_python({'a': b'hello '}) == {'a': 'hello world'}
+    ```
+
+    Args:
+        function: The validator function to call after the schema is validated
+        schema: The schema to validate before the validator function
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='function-after',
+        function={'type': 'no-info', 'function': function},
+        schema=schema,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+def with_info_after_validator_function(
+    function: WithInfoValidatorFunction,
+    schema: CoreSchema,
+    *,
+    field_name: str | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> AfterValidatorFunctionSchema:
+    """
+    Returns a schema that calls a validator function after validation, the function is called with
+    an `info` argument, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    def fn(v: str, info: core_schema.ValidationInfo) -> str:
+        assert info.data is not None
+        assert info.field_name is not None
+        return v + 'world'
+
+    func_schema = core_schema.with_info_after_validator_function(
+        function=fn, schema=core_schema.str_schema(), field_name='a'
+    )
+    schema = core_schema.typed_dict_schema({'a': core_schema.typed_dict_field(func_schema)})
+
+    v = SchemaValidator(schema)
+    assert v.validate_python({'a': b'hello '}) == {'a': 'hello world'}
+    ```
+
+    Args:
+        function: The validator function to call after the schema is validated
+        schema: The schema to validate before the validator function
+        field_name: The name of the field this validators is applied to, if any
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='function-after',
+        function=_dict_not_none(type='with-info', function=function, field_name=field_name),
+        schema=schema,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class ValidatorFunctionWrapHandler(Protocol):
+    def __call__(self, input_value: Any, outer_location: str | int | None = None) -> Any:  # pragma: no cover
+        ...
+
+
+# (__input_value: Any, __validator: ValidatorFunctionWrapHandler) -> Any
+NoInfoWrapValidatorFunction = Callable[[Any, ValidatorFunctionWrapHandler], Any]
+
+
+class NoInfoWrapValidatorFunctionSchema(TypedDict):
+    type: Literal['no-info']
+    function: NoInfoWrapValidatorFunction
+
+
+# (__input_value: Any, __validator: ValidatorFunctionWrapHandler, __info: ValidationInfo) -> Any
+WithInfoWrapValidatorFunction = Callable[[Any, ValidatorFunctionWrapHandler, ValidationInfo], Any]
+
+
+class WithInfoWrapValidatorFunctionSchema(TypedDict, total=False):
+    type: Required[Literal['with-info']]
+    function: Required[WithInfoWrapValidatorFunction]
+    field_name: str
+
+
+WrapValidatorFunction = Union[NoInfoWrapValidatorFunctionSchema, WithInfoWrapValidatorFunctionSchema]
+
+
+class WrapValidatorFunctionSchema(TypedDict, total=False):
+    type: Required[Literal['function-wrap']]
+    function: Required[WrapValidatorFunction]
+    schema: Required[CoreSchema]
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def no_info_wrap_validator_function(
+    function: NoInfoWrapValidatorFunction,
+    schema: CoreSchema,
+    *,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> WrapValidatorFunctionSchema:
+    """
+    Returns a schema which calls a function with a `validator` callable argument which can
+    optionally be used to call inner validation with the function logic, this is much like the
+    "onion" implementation of middleware in many popular web frameworks, no `info` argument is passed, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    def fn(
+        v: str,
+        validator: core_schema.ValidatorFunctionWrapHandler,
+    ) -> str:
+        return validator(input_value=v) + 'world'
+
+    schema = core_schema.no_info_wrap_validator_function(
+        function=fn, schema=core_schema.str_schema()
+    )
+    v = SchemaValidator(schema)
+    assert v.validate_python('hello ') == 'hello world'
+    ```
+
+    Args:
+        function: The validator function to call
+        schema: The schema to validate the output of the validator function
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='function-wrap',
+        function={'type': 'no-info', 'function': function},
+        schema=schema,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+def with_info_wrap_validator_function(
+    function: WithInfoWrapValidatorFunction,
+    schema: CoreSchema,
+    *,
+    field_name: str | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> WrapValidatorFunctionSchema:
+    """
+    Returns a schema which calls a function with a `validator` callable argument which can
+    optionally be used to call inner validation with the function logic, this is much like the
+    "onion" implementation of middleware in many popular web frameworks, an `info` argument is also passed, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    def fn(
+        v: str,
+        validator: core_schema.ValidatorFunctionWrapHandler,
+        info: core_schema.ValidationInfo,
+    ) -> str:
+        return validator(input_value=v) + 'world'
+
+    schema = core_schema.with_info_wrap_validator_function(
+        function=fn, schema=core_schema.str_schema()
+    )
+    v = SchemaValidator(schema)
+    assert v.validate_python('hello ') == 'hello world'
+    ```
+
+    Args:
+        function: The validator function to call
+        schema: The schema to validate the output of the validator function
+        field_name: The name of the field this validators is applied to, if any
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='function-wrap',
+        function=_dict_not_none(type='with-info', function=function, field_name=field_name),
+        schema=schema,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class PlainValidatorFunctionSchema(TypedDict, total=False):
+    type: Required[Literal['function-plain']]
+    function: Required[ValidationFunction]
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def no_info_plain_validator_function(
+    function: NoInfoValidatorFunction,
+    *,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> PlainValidatorFunctionSchema:
+    """
+    Returns a schema that uses the provided function for validation, no `info` argument is passed, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    def fn(v: str) -> str:
+        assert 'hello' in v
+        return v + 'world'
+
+    schema = core_schema.no_info_plain_validator_function(function=fn)
+    v = SchemaValidator(schema)
+    assert v.validate_python('hello ') == 'hello world'
+    ```
+
+    Args:
+        function: The validator function to call
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='function-plain',
+        function={'type': 'no-info', 'function': function},
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+def with_info_plain_validator_function(
+    function: WithInfoValidatorFunction,
+    *,
+    field_name: str | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> PlainValidatorFunctionSchema:
+    """
+    Returns a schema that uses the provided function for validation, an `info` argument is passed, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    def fn(v: str, info: core_schema.ValidationInfo) -> str:
+        assert 'hello' in v
+        return v + 'world'
+
+    schema = core_schema.with_info_plain_validator_function(function=fn)
+    v = SchemaValidator(schema)
+    assert v.validate_python('hello ') == 'hello world'
+    ```
+
+    Args:
+        function: The validator function to call
+        field_name: The name of the field this validators is applied to, if any
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='function-plain',
+        function=_dict_not_none(type='with-info', function=function, field_name=field_name),
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class WithDefaultSchema(TypedDict, total=False):
+    type: Required[Literal['default']]
+    schema: Required[CoreSchema]
+    default: Any
+    default_factory: Callable[[], Any]
+    on_error: Literal['raise', 'omit', 'default']  # default: 'raise'
+    validate_default: bool  # default: False
+    strict: bool
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def with_default_schema(
+    schema: CoreSchema,
+    *,
+    default: Any = PydanticUndefined,
+    default_factory: Callable[[], Any] | None = None,
+    on_error: Literal['raise', 'omit', 'default'] | None = None,
+    validate_default: bool | None = None,
+    strict: bool | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> WithDefaultSchema:
+    """
+    Returns a schema that adds a default value to the given schema, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.with_default_schema(core_schema.str_schema(), default='hello')
+    wrapper_schema = core_schema.typed_dict_schema(
+        {'a': core_schema.typed_dict_field(schema)}
+    )
+    v = SchemaValidator(wrapper_schema)
+    assert v.validate_python({}) == v.validate_python({'a': 'hello'})
+    ```
+
+    Args:
+        schema: The schema to add a default value to
+        default: The default value to use
+        default_factory: A function that returns the default value to use
+        on_error: What to do if the schema validation fails. One of 'raise', 'omit', 'default'
+        validate_default: Whether the default value should be validated
+        strict: Whether the underlying schema should be validated with strict mode
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    s = _dict_not_none(
+        type='default',
+        schema=schema,
+        default_factory=default_factory,
+        on_error=on_error,
+        validate_default=validate_default,
+        strict=strict,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+    if default is not PydanticUndefined:
+        s['default'] = default
+    return s
+
+
+class NullableSchema(TypedDict, total=False):
+    type: Required[Literal['nullable']]
+    schema: Required[CoreSchema]
+    strict: bool
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def nullable_schema(
+    schema: CoreSchema,
+    *,
+    strict: bool | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> NullableSchema:
+    """
+    Returns a schema that matches a nullable value, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.nullable_schema(core_schema.str_schema())
+    v = SchemaValidator(schema)
+    assert v.validate_python(None) is None
+    ```
+
+    Args:
+        schema: The schema to wrap
+        strict: Whether the underlying schema should be validated with strict mode
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='nullable', schema=schema, strict=strict, ref=ref, metadata=metadata, serialization=serialization
+    )
+
+
+class UnionSchema(TypedDict, total=False):
+    type: Required[Literal['union']]
+    choices: Required[List[Union[CoreSchema, Tuple[CoreSchema, str]]]]
+    # default true, whether to automatically collapse unions with one element to the inner validator
+    auto_collapse: bool
+    custom_error_type: str
+    custom_error_message: str
+    custom_error_context: Dict[str, Union[str, int, float]]
+    mode: Literal['smart', 'left_to_right']  # default: 'smart'
+    strict: bool
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def union_schema(
+    choices: list[CoreSchema | tuple[CoreSchema, str]],
+    *,
+    auto_collapse: bool | None = None,
+    custom_error_type: str | None = None,
+    custom_error_message: str | None = None,
+    custom_error_context: dict[str, str | int] | None = None,
+    mode: Literal['smart', 'left_to_right'] | None = None,
+    strict: bool | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> UnionSchema:
+    """
+    Returns a schema that matches a union value, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.union_schema([core_schema.str_schema(), core_schema.int_schema()])
+    v = SchemaValidator(schema)
+    assert v.validate_python('hello') == 'hello'
+    assert v.validate_python(1) == 1
+    ```
+
+    Args:
+        choices: The schemas to match. If a tuple, the second item is used as the label for the case.
+        auto_collapse: whether to automatically collapse unions with one element to the inner validator, default true
+        custom_error_type: The custom error type to use if the validation fails
+        custom_error_message: The custom error message to use if the validation fails
+        custom_error_context: The custom error context to use if the validation fails
+        mode: How to select which choice to return
+            * `smart` (default) will try to return the choice which is the closest match to the input value
+            * `left_to_right` will return the first choice in `choices` which succeeds validation
+        strict: Whether the underlying schemas should be validated with strict mode
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='union',
+        choices=choices,
+        auto_collapse=auto_collapse,
+        custom_error_type=custom_error_type,
+        custom_error_message=custom_error_message,
+        custom_error_context=custom_error_context,
+        mode=mode,
+        strict=strict,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class TaggedUnionSchema(TypedDict, total=False):
+    type: Required[Literal['tagged-union']]
+    choices: Required[Dict[Hashable, CoreSchema]]
+    discriminator: Required[Union[str, List[Union[str, int]], List[List[Union[str, int]]], Callable[[Any], Hashable]]]
+    custom_error_type: str
+    custom_error_message: str
+    custom_error_context: Dict[str, Union[str, int, float]]
+    strict: bool
+    from_attributes: bool  # default: True
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def tagged_union_schema(
+    choices: Dict[Hashable, CoreSchema],
+    discriminator: str | list[str | int] | list[list[str | int]] | Callable[[Any], Hashable],
+    *,
+    custom_error_type: str | None = None,
+    custom_error_message: str | None = None,
+    custom_error_context: dict[str, int | str | float] | None = None,
+    strict: bool | None = None,
+    from_attributes: bool | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> TaggedUnionSchema:
+    """
+    Returns a schema that matches a tagged union value, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    apple_schema = core_schema.typed_dict_schema(
+        {
+            'foo': core_schema.typed_dict_field(core_schema.str_schema()),
+            'bar': core_schema.typed_dict_field(core_schema.int_schema()),
+        }
+    )
+    banana_schema = core_schema.typed_dict_schema(
+        {
+            'foo': core_schema.typed_dict_field(core_schema.str_schema()),
+            'spam': core_schema.typed_dict_field(
+                core_schema.list_schema(items_schema=core_schema.int_schema())
+            ),
+        }
+    )
+    schema = core_schema.tagged_union_schema(
+        choices={
+            'apple': apple_schema,
+            'banana': banana_schema,
+        },
+        discriminator='foo',
+    )
+    v = SchemaValidator(schema)
+    assert v.validate_python({'foo': 'apple', 'bar': '123'}) == {'foo': 'apple', 'bar': 123}
+    assert v.validate_python({'foo': 'banana', 'spam': [1, 2, 3]}) == {
+        'foo': 'banana',
+        'spam': [1, 2, 3],
+    }
+    ```
+
+    Args:
+        choices: The schemas to match
+            When retrieving a schema from `choices` using the discriminator value, if the value is a str,
+            it should be fed back into the `choices` map until a schema is obtained
+            (This approach is to prevent multiple ownership of a single schema in Rust)
+        discriminator: The discriminator to use to determine the schema to use
+            * If `discriminator` is a str, it is the name of the attribute to use as the discriminator
+            * If `discriminator` is a list of int/str, it should be used as a "path" to access the discriminator
+            * If `discriminator` is a list of lists, each inner list is a path, and the first path that exists is used
+            * If `discriminator` is a callable, it should return the discriminator when called on the value to validate;
+              the callable can return `None` to indicate that there is no matching discriminator present on the input
+        custom_error_type: The custom error type to use if the validation fails
+        custom_error_message: The custom error message to use if the validation fails
+        custom_error_context: The custom error context to use if the validation fails
+        strict: Whether the underlying schemas should be validated with strict mode
+        from_attributes: Whether to use the attributes of the object to retrieve the discriminator value
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='tagged-union',
+        choices=choices,
+        discriminator=discriminator,
+        custom_error_type=custom_error_type,
+        custom_error_message=custom_error_message,
+        custom_error_context=custom_error_context,
+        strict=strict,
+        from_attributes=from_attributes,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class ChainSchema(TypedDict, total=False):
+    type: Required[Literal['chain']]
+    steps: Required[List[CoreSchema]]
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def chain_schema(
+    steps: list[CoreSchema], *, ref: str | None = None, metadata: Any = None, serialization: SerSchema | None = None
+) -> ChainSchema:
+    """
+    Returns a schema that chains the provided validation schemas, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    def fn(v: str, info: core_schema.ValidationInfo) -> str:
+        assert 'hello' in v
+        return v + ' world'
+
+    fn_schema = core_schema.with_info_plain_validator_function(function=fn)
+    schema = core_schema.chain_schema(
+        [fn_schema, fn_schema, fn_schema, core_schema.str_schema()]
+    )
+    v = SchemaValidator(schema)
+    assert v.validate_python('hello') == 'hello world world world'
+    ```
+
+    Args:
+        steps: The schemas to chain
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(type='chain', steps=steps, ref=ref, metadata=metadata, serialization=serialization)
+
+
+class LaxOrStrictSchema(TypedDict, total=False):
+    type: Required[Literal['lax-or-strict']]
+    lax_schema: Required[CoreSchema]
+    strict_schema: Required[CoreSchema]
+    strict: bool
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def lax_or_strict_schema(
+    lax_schema: CoreSchema,
+    strict_schema: CoreSchema,
+    *,
+    strict: bool | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> LaxOrStrictSchema:
+    """
+    Returns a schema that uses the lax or strict schema, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    def fn(v: str, info: core_schema.ValidationInfo) -> str:
+        assert 'hello' in v
+        return v + ' world'
+
+    lax_schema = core_schema.int_schema(strict=False)
+    strict_schema = core_schema.int_schema(strict=True)
+
+    schema = core_schema.lax_or_strict_schema(
+        lax_schema=lax_schema, strict_schema=strict_schema, strict=True
+    )
+    v = SchemaValidator(schema)
+    assert v.validate_python(123) == 123
+
+    schema = core_schema.lax_or_strict_schema(
+        lax_schema=lax_schema, strict_schema=strict_schema, strict=False
+    )
+    v = SchemaValidator(schema)
+    assert v.validate_python('123') == 123
+    ```
+
+    Args:
+        lax_schema: The lax schema to use
+        strict_schema: The strict schema to use
+        strict: Whether the strict schema should be used
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='lax-or-strict',
+        lax_schema=lax_schema,
+        strict_schema=strict_schema,
+        strict=strict,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class JsonOrPythonSchema(TypedDict, total=False):
+    type: Required[Literal['json-or-python']]
+    json_schema: Required[CoreSchema]
+    python_schema: Required[CoreSchema]
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def json_or_python_schema(
+    json_schema: CoreSchema,
+    python_schema: CoreSchema,
+    *,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> JsonOrPythonSchema:
+    """
+    Returns a schema that uses the Json or Python schema depending on the input:
+
+    ```py
+    from pydantic_core import SchemaValidator, ValidationError, core_schema
+
+    v = SchemaValidator(
+        core_schema.json_or_python_schema(
+            json_schema=core_schema.int_schema(),
+            python_schema=core_schema.int_schema(strict=True),
+        )
+    )
+
+    assert v.validate_json('"123"') == 123
+
+    try:
+        v.validate_python('123')
+    except ValidationError:
+        pass
+    else:
+        raise AssertionError('Validation should have failed')
+    ```
+
+    Args:
+        json_schema: The schema to use for Json inputs
+        python_schema: The schema to use for Python inputs
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='json-or-python',
+        json_schema=json_schema,
+        python_schema=python_schema,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class TypedDictField(TypedDict, total=False):
+    type: Required[Literal['typed-dict-field']]
+    schema: Required[CoreSchema]
+    required: bool
+    validation_alias: Union[str, List[Union[str, int]], List[List[Union[str, int]]]]
+    serialization_alias: str
+    serialization_exclude: bool  # default: False
+    metadata: Any
+
+
+def typed_dict_field(
+    schema: CoreSchema,
+    *,
+    required: bool | None = None,
+    validation_alias: str | list[str | int] | list[list[str | int]] | None = None,
+    serialization_alias: str | None = None,
+    serialization_exclude: bool | None = None,
+    metadata: Any = None,
+) -> TypedDictField:
+    """
+    Returns a schema that matches a typed dict field, e.g.:
+
+    ```py
+    from pydantic_core import core_schema
+
+    field = core_schema.typed_dict_field(schema=core_schema.int_schema(), required=True)
+    ```
+
+    Args:
+        schema: The schema to use for the field
+        required: Whether the field is required
+        validation_alias: The alias(es) to use to find the field in the validation data
+        serialization_alias: The alias to use as a key when serializing
+        serialization_exclude: Whether to exclude the field when serializing
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+    """
+    return _dict_not_none(
+        type='typed-dict-field',
+        schema=schema,
+        required=required,
+        validation_alias=validation_alias,
+        serialization_alias=serialization_alias,
+        serialization_exclude=serialization_exclude,
+        metadata=metadata,
+    )
+
+
+class TypedDictSchema(TypedDict, total=False):
+    type: Required[Literal['typed-dict']]
+    fields: Required[Dict[str, TypedDictField]]
+    computed_fields: List[ComputedField]
+    strict: bool
+    extras_schema: CoreSchema
+    # all these values can be set via config, equivalent fields have `typed_dict_` prefix
+    extra_behavior: ExtraBehavior
+    total: bool  # default: True
+    populate_by_name: bool  # replaces `allow_population_by_field_name` in pydantic v1
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+    config: CoreConfig
+
+
+def typed_dict_schema(
+    fields: Dict[str, TypedDictField],
+    *,
+    computed_fields: list[ComputedField] | None = None,
+    strict: bool | None = None,
+    extras_schema: CoreSchema | None = None,
+    extra_behavior: ExtraBehavior | None = None,
+    total: bool | None = None,
+    populate_by_name: bool | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+    config: CoreConfig | None = None,
+) -> TypedDictSchema:
+    """
+    Returns a schema that matches a typed dict, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    wrapper_schema = core_schema.typed_dict_schema(
+        {'a': core_schema.typed_dict_field(core_schema.str_schema())}
+    )
+    v = SchemaValidator(wrapper_schema)
+    assert v.validate_python({'a': 'hello'}) == {'a': 'hello'}
+    ```
+
+    Args:
+        fields: The fields to use for the typed dict
+        computed_fields: Computed fields to use when serializing the model, only applies when directly inside a model
+        strict: Whether the typed dict is strict
+        extras_schema: The extra validator to use for the typed dict
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        extra_behavior: The extra behavior to use for the typed dict
+        total: Whether the typed dict is total
+        populate_by_name: Whether the typed dict should populate by name
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='typed-dict',
+        fields=fields,
+        computed_fields=computed_fields,
+        strict=strict,
+        extras_schema=extras_schema,
+        extra_behavior=extra_behavior,
+        total=total,
+        populate_by_name=populate_by_name,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+        config=config,
+    )
+
+
+class ModelField(TypedDict, total=False):
+    type: Required[Literal['model-field']]
+    schema: Required[CoreSchema]
+    validation_alias: Union[str, List[Union[str, int]], List[List[Union[str, int]]]]
+    serialization_alias: str
+    serialization_exclude: bool  # default: False
+    frozen: bool
+    metadata: Any
+
+
+def model_field(
+    schema: CoreSchema,
+    *,
+    validation_alias: str | list[str | int] | list[list[str | int]] | None = None,
+    serialization_alias: str | None = None,
+    serialization_exclude: bool | None = None,
+    frozen: bool | None = None,
+    metadata: Any = None,
+) -> ModelField:
+    """
+    Returns a schema for a model field, e.g.:
+
+    ```py
+    from pydantic_core import core_schema
+
+    field = core_schema.model_field(schema=core_schema.int_schema())
+    ```
+
+    Args:
+        schema: The schema to use for the field
+        validation_alias: The alias(es) to use to find the field in the validation data
+        serialization_alias: The alias to use as a key when serializing
+        serialization_exclude: Whether to exclude the field when serializing
+        frozen: Whether the field is frozen
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+    """
+    return _dict_not_none(
+        type='model-field',
+        schema=schema,
+        validation_alias=validation_alias,
+        serialization_alias=serialization_alias,
+        serialization_exclude=serialization_exclude,
+        frozen=frozen,
+        metadata=metadata,
+    )
+
+
+class ModelFieldsSchema(TypedDict, total=False):
+    type: Required[Literal['model-fields']]
+    fields: Required[Dict[str, ModelField]]
+    model_name: str
+    computed_fields: List[ComputedField]
+    strict: bool
+    extras_schema: CoreSchema
+    # all these values can be set via config, equivalent fields have `typed_dict_` prefix
+    extra_behavior: ExtraBehavior
+    populate_by_name: bool  # replaces `allow_population_by_field_name` in pydantic v1
+    from_attributes: bool
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def model_fields_schema(
+    fields: Dict[str, ModelField],
+    *,
+    model_name: str | None = None,
+    computed_fields: list[ComputedField] | None = None,
+    strict: bool | None = None,
+    extras_schema: CoreSchema | None = None,
+    extra_behavior: ExtraBehavior | None = None,
+    populate_by_name: bool | None = None,
+    from_attributes: bool | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> ModelFieldsSchema:
+    """
+    Returns a schema that matches a typed dict, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    wrapper_schema = core_schema.model_fields_schema(
+        {'a': core_schema.model_field(core_schema.str_schema())}
+    )
+    v = SchemaValidator(wrapper_schema)
+    print(v.validate_python({'a': 'hello'}))
+    #> ({'a': 'hello'}, None, {'a'})
+    ```
+
+    Args:
+        fields: The fields to use for the typed dict
+        model_name: The name of the model, used for error messages, defaults to "Model"
+        computed_fields: Computed fields to use when serializing the model, only applies when directly inside a model
+        strict: Whether the typed dict is strict
+        extras_schema: The extra validator to use for the typed dict
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        extra_behavior: The extra behavior to use for the typed dict
+        populate_by_name: Whether the typed dict should populate by name
+        from_attributes: Whether the typed dict should be populated from attributes
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='model-fields',
+        fields=fields,
+        model_name=model_name,
+        computed_fields=computed_fields,
+        strict=strict,
+        extras_schema=extras_schema,
+        extra_behavior=extra_behavior,
+        populate_by_name=populate_by_name,
+        from_attributes=from_attributes,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class ModelSchema(TypedDict, total=False):
+    type: Required[Literal['model']]
+    cls: Required[Type[Any]]
+    schema: Required[CoreSchema]
+    custom_init: bool
+    root_model: bool
+    post_init: str
+    revalidate_instances: Literal['always', 'never', 'subclass-instances']  # default: 'never'
+    strict: bool
+    frozen: bool
+    extra_behavior: ExtraBehavior
+    config: CoreConfig
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def model_schema(
+    cls: Type[Any],
+    schema: CoreSchema,
+    *,
+    custom_init: bool | None = None,
+    root_model: bool | None = None,
+    post_init: str | None = None,
+    revalidate_instances: Literal['always', 'never', 'subclass-instances'] | None = None,
+    strict: bool | None = None,
+    frozen: bool | None = None,
+    extra_behavior: ExtraBehavior | None = None,
+    config: CoreConfig | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> ModelSchema:
+    """
+    A model schema generally contains a typed-dict schema.
+    It will run the typed dict validator, then create a new class
+    and set the dict and fields set returned from the typed dict validator
+    to `__dict__` and `__pydantic_fields_set__` respectively.
+
+    Example:
+
+    ```py
+    from pydantic_core import CoreConfig, SchemaValidator, core_schema
+
+    class MyModel:
+        __slots__ = (
+            '__dict__',
+            '__pydantic_fields_set__',
+            '__pydantic_extra__',
+            '__pydantic_private__',
+        )
+
+    schema = core_schema.model_schema(
+        cls=MyModel,
+        config=CoreConfig(str_max_length=5),
+        schema=core_schema.model_fields_schema(
+            fields={'a': core_schema.model_field(core_schema.str_schema())},
+        ),
+    )
+    v = SchemaValidator(schema)
+    assert v.isinstance_python({'a': 'hello'}) is True
+    assert v.isinstance_python({'a': 'too long'}) is False
+    ```
+
+    Args:
+        cls: The class to use for the model
+        schema: The schema to use for the model
+        custom_init: Whether the model has a custom init method
+        root_model: Whether the model is a `RootModel`
+        post_init: The call after init to use for the model
+        revalidate_instances: whether instances of models and dataclasses (including subclass instances)
+            should re-validate defaults to config.revalidate_instances, else 'never'
+        strict: Whether the model is strict
+        frozen: Whether the model is frozen
+        extra_behavior: The extra behavior to use for the model, used in serialization
+        config: The config to use for the model
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='model',
+        cls=cls,
+        schema=schema,
+        custom_init=custom_init,
+        root_model=root_model,
+        post_init=post_init,
+        revalidate_instances=revalidate_instances,
+        strict=strict,
+        frozen=frozen,
+        extra_behavior=extra_behavior,
+        config=config,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class DataclassField(TypedDict, total=False):
+    type: Required[Literal['dataclass-field']]
+    name: Required[str]
+    schema: Required[CoreSchema]
+    kw_only: bool  # default: True
+    init: bool  # default: True
+    init_only: bool  # default: False
+    frozen: bool  # default: False
+    validation_alias: Union[str, List[Union[str, int]], List[List[Union[str, int]]]]
+    serialization_alias: str
+    serialization_exclude: bool  # default: False
+    metadata: Any
+
+
+def dataclass_field(
+    name: str,
+    schema: CoreSchema,
+    *,
+    kw_only: bool | None = None,
+    init: bool | None = None,
+    init_only: bool | None = None,
+    validation_alias: str | list[str | int] | list[list[str | int]] | None = None,
+    serialization_alias: str | None = None,
+    serialization_exclude: bool | None = None,
+    metadata: Any = None,
+    frozen: bool | None = None,
+) -> DataclassField:
+    """
+    Returns a schema for a dataclass field, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    field = core_schema.dataclass_field(
+        name='a', schema=core_schema.str_schema(), kw_only=False
+    )
+    schema = core_schema.dataclass_args_schema('Foobar', [field])
+    v = SchemaValidator(schema)
+    assert v.validate_python({'a': 'hello'}) == ({'a': 'hello'}, None)
+    ```
+
+    Args:
+        name: The name to use for the argument parameter
+        schema: The schema to use for the argument parameter
+        kw_only: Whether the field can be set with a positional argument as well as a keyword argument
+        init: Whether the field should be validated during initialization
+        init_only: Whether the field should be omitted  from `__dict__` and passed to `__post_init__`
+        validation_alias: The alias(es) to use to find the field in the validation data
+        serialization_alias: The alias to use as a key when serializing
+        serialization_exclude: Whether to exclude the field when serializing
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        frozen: Whether the field is frozen
+    """
+    return _dict_not_none(
+        type='dataclass-field',
+        name=name,
+        schema=schema,
+        kw_only=kw_only,
+        init=init,
+        init_only=init_only,
+        validation_alias=validation_alias,
+        serialization_alias=serialization_alias,
+        serialization_exclude=serialization_exclude,
+        metadata=metadata,
+        frozen=frozen,
+    )
+
+
+class DataclassArgsSchema(TypedDict, total=False):
+    type: Required[Literal['dataclass-args']]
+    dataclass_name: Required[str]
+    fields: Required[List[DataclassField]]
+    computed_fields: List[ComputedField]
+    populate_by_name: bool  # default: False
+    collect_init_only: bool  # default: False
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+    extra_behavior: ExtraBehavior
+
+
+def dataclass_args_schema(
+    dataclass_name: str,
+    fields: list[DataclassField],
+    *,
+    computed_fields: List[ComputedField] | None = None,
+    populate_by_name: bool | None = None,
+    collect_init_only: bool | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+    extra_behavior: ExtraBehavior | None = None,
+) -> DataclassArgsSchema:
+    """
+    Returns a schema for validating dataclass arguments, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    field_a = core_schema.dataclass_field(
+        name='a', schema=core_schema.str_schema(), kw_only=False
+    )
+    field_b = core_schema.dataclass_field(
+        name='b', schema=core_schema.bool_schema(), kw_only=False
+    )
+    schema = core_schema.dataclass_args_schema('Foobar', [field_a, field_b])
+    v = SchemaValidator(schema)
+    assert v.validate_python({'a': 'hello', 'b': True}) == ({'a': 'hello', 'b': True}, None)
+    ```
+
+    Args:
+        dataclass_name: The name of the dataclass being validated
+        fields: The fields to use for the dataclass
+        computed_fields: Computed fields to use when serializing the dataclass
+        populate_by_name: Whether to populate by name
+        collect_init_only: Whether to collect init only fields into a dict to pass to `__post_init__`
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+        extra_behavior: How to handle extra fields
+    """
+    return _dict_not_none(
+        type='dataclass-args',
+        dataclass_name=dataclass_name,
+        fields=fields,
+        computed_fields=computed_fields,
+        populate_by_name=populate_by_name,
+        collect_init_only=collect_init_only,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+        extra_behavior=extra_behavior,
+    )
+
+
+class DataclassSchema(TypedDict, total=False):
+    type: Required[Literal['dataclass']]
+    cls: Required[Type[Any]]
+    schema: Required[CoreSchema]
+    fields: Required[List[str]]
+    cls_name: str
+    post_init: bool  # default: False
+    revalidate_instances: Literal['always', 'never', 'subclass-instances']  # default: 'never'
+    strict: bool  # default: False
+    frozen: bool  # default False
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+    slots: bool
+    config: CoreConfig
+
+
+def dataclass_schema(
+    cls: Type[Any],
+    schema: CoreSchema,
+    fields: List[str],
+    *,
+    cls_name: str | None = None,
+    post_init: bool | None = None,
+    revalidate_instances: Literal['always', 'never', 'subclass-instances'] | None = None,
+    strict: bool | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+    frozen: bool | None = None,
+    slots: bool | None = None,
+    config: CoreConfig | None = None,
+) -> DataclassSchema:
+    """
+    Returns a schema for a dataclass. As with `ModelSchema`, this schema can only be used as a field within
+    another schema, not as the root type.
+
+    Args:
+        cls: The dataclass type, used to perform subclass checks
+        schema: The schema to use for the dataclass fields
+        fields: Fields of the dataclass, this is used in serialization and in validation during re-validation
+            and while validating assignment
+        cls_name: The name to use in error locs, etc; this is useful for generics (default: `cls.__name__`)
+        post_init: Whether to call `__post_init__` after validation
+        revalidate_instances: whether instances of models and dataclasses (including subclass instances)
+            should re-validate defaults to config.revalidate_instances, else 'never'
+        strict: Whether to require an exact instance of `cls`
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+        frozen: Whether the dataclass is frozen
+        slots: Whether `slots=True` on the dataclass, means each field is assigned independently, rather than
+            simply setting `__dict__`, default false
+    """
+    return _dict_not_none(
+        type='dataclass',
+        cls=cls,
+        fields=fields,
+        cls_name=cls_name,
+        schema=schema,
+        post_init=post_init,
+        revalidate_instances=revalidate_instances,
+        strict=strict,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+        frozen=frozen,
+        slots=slots,
+        config=config,
+    )
+
+
+class ArgumentsParameter(TypedDict, total=False):
+    name: Required[str]
+    schema: Required[CoreSchema]
+    mode: Literal['positional_only', 'positional_or_keyword', 'keyword_only']  # default positional_or_keyword
+    alias: Union[str, List[Union[str, int]], List[List[Union[str, int]]]]
+
+
+def arguments_parameter(
+    name: str,
+    schema: CoreSchema,
+    *,
+    mode: Literal['positional_only', 'positional_or_keyword', 'keyword_only'] | None = None,
+    alias: str | list[str | int] | list[list[str | int]] | None = None,
+) -> ArgumentsParameter:
+    """
+    Returns a schema that matches an argument parameter, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    param = core_schema.arguments_parameter(
+        name='a', schema=core_schema.str_schema(), mode='positional_only'
+    )
+    schema = core_schema.arguments_schema([param])
+    v = SchemaValidator(schema)
+    assert v.validate_python(('hello',)) == (('hello',), {})
+    ```
+
+    Args:
+        name: The name to use for the argument parameter
+        schema: The schema to use for the argument parameter
+        mode: The mode to use for the argument parameter
+        alias: The alias to use for the argument parameter
+    """
+    return _dict_not_none(name=name, schema=schema, mode=mode, alias=alias)
+
+
+class ArgumentsSchema(TypedDict, total=False):
+    type: Required[Literal['arguments']]
+    arguments_schema: Required[List[ArgumentsParameter]]
+    populate_by_name: bool
+    var_args_schema: CoreSchema
+    var_kwargs_schema: CoreSchema
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def arguments_schema(
+    arguments: list[ArgumentsParameter],
+    *,
+    populate_by_name: bool | None = None,
+    var_args_schema: CoreSchema | None = None,
+    var_kwargs_schema: CoreSchema | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> ArgumentsSchema:
+    """
+    Returns a schema that matches an arguments schema, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    param_a = core_schema.arguments_parameter(
+        name='a', schema=core_schema.str_schema(), mode='positional_only'
+    )
+    param_b = core_schema.arguments_parameter(
+        name='b', schema=core_schema.bool_schema(), mode='positional_only'
+    )
+    schema = core_schema.arguments_schema([param_a, param_b])
+    v = SchemaValidator(schema)
+    assert v.validate_python(('hello', True)) == (('hello', True), {})
+    ```
+
+    Args:
+        arguments: The arguments to use for the arguments schema
+        populate_by_name: Whether to populate by name
+        var_args_schema: The variable args schema to use for the arguments schema
+        var_kwargs_schema: The variable kwargs schema to use for the arguments schema
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='arguments',
+        arguments_schema=arguments,
+        populate_by_name=populate_by_name,
+        var_args_schema=var_args_schema,
+        var_kwargs_schema=var_kwargs_schema,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class CallSchema(TypedDict, total=False):
+    type: Required[Literal['call']]
+    arguments_schema: Required[CoreSchema]
+    function: Required[Callable[..., Any]]
+    function_name: str  # default function.__name__
+    return_schema: CoreSchema
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def call_schema(
+    arguments: CoreSchema,
+    function: Callable[..., Any],
+    *,
+    function_name: str | None = None,
+    return_schema: CoreSchema | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> CallSchema:
+    """
+    Returns a schema that matches an arguments schema, then calls a function, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    param_a = core_schema.arguments_parameter(
+        name='a', schema=core_schema.str_schema(), mode='positional_only'
+    )
+    param_b = core_schema.arguments_parameter(
+        name='b', schema=core_schema.bool_schema(), mode='positional_only'
+    )
+    args_schema = core_schema.arguments_schema([param_a, param_b])
+
+    schema = core_schema.call_schema(
+        arguments=args_schema,
+        function=lambda a, b: a + str(not b),
+        return_schema=core_schema.str_schema(),
+    )
+    v = SchemaValidator(schema)
+    assert v.validate_python((('hello', True))) == 'helloFalse'
+    ```
+
+    Args:
+        arguments: The arguments to use for the arguments schema
+        function: The function to use for the call schema
+        function_name: The function name to use for the call schema, if not provided `function.__name__` is used
+        return_schema: The return schema to use for the call schema
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='call',
+        arguments_schema=arguments,
+        function=function,
+        function_name=function_name,
+        return_schema=return_schema,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class CustomErrorSchema(TypedDict, total=False):
+    type: Required[Literal['custom-error']]
+    schema: Required[CoreSchema]
+    custom_error_type: Required[str]
+    custom_error_message: str
+    custom_error_context: Dict[str, Union[str, int, float]]
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def custom_error_schema(
+    schema: CoreSchema,
+    custom_error_type: str,
+    *,
+    custom_error_message: str | None = None,
+    custom_error_context: dict[str, Any] | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> CustomErrorSchema:
+    """
+    Returns a schema that matches a custom error value, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.custom_error_schema(
+        schema=core_schema.int_schema(),
+        custom_error_type='MyError',
+        custom_error_message='Error msg',
+    )
+    v = SchemaValidator(schema)
+    v.validate_python(1)
+    ```
+
+    Args:
+        schema: The schema to use for the custom error schema
+        custom_error_type: The custom error type to use for the custom error schema
+        custom_error_message: The custom error message to use for the custom error schema
+        custom_error_context: The custom error context to use for the custom error schema
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='custom-error',
+        schema=schema,
+        custom_error_type=custom_error_type,
+        custom_error_message=custom_error_message,
+        custom_error_context=custom_error_context,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class JsonSchema(TypedDict, total=False):
+    type: Required[Literal['json']]
+    schema: CoreSchema
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def json_schema(
+    schema: CoreSchema | None = None,
+    *,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> JsonSchema:
+    """
+    Returns a schema that matches a JSON value, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    dict_schema = core_schema.model_fields_schema(
+        {
+            'field_a': core_schema.model_field(core_schema.str_schema()),
+            'field_b': core_schema.model_field(core_schema.bool_schema()),
+        },
+    )
+
+    class MyModel:
+        __slots__ = (
+            '__dict__',
+            '__pydantic_fields_set__',
+            '__pydantic_extra__',
+            '__pydantic_private__',
+        )
+        field_a: str
+        field_b: bool
+
+    json_schema = core_schema.json_schema(schema=dict_schema)
+    schema = core_schema.model_schema(cls=MyModel, schema=json_schema)
+    v = SchemaValidator(schema)
+    m = v.validate_python('{"field_a": "hello", "field_b": true}')
+    assert isinstance(m, MyModel)
+    ```
+
+    Args:
+        schema: The schema to use for the JSON schema
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(type='json', schema=schema, ref=ref, metadata=metadata, serialization=serialization)
+
+
+class UrlSchema(TypedDict, total=False):
+    type: Required[Literal['url']]
+    max_length: int
+    allowed_schemes: List[str]
+    host_required: bool  # default False
+    default_host: str
+    default_port: int
+    default_path: str
+    strict: bool
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def url_schema(
+    *,
+    max_length: int | None = None,
+    allowed_schemes: list[str] | None = None,
+    host_required: bool | None = None,
+    default_host: str | None = None,
+    default_port: int | None = None,
+    default_path: str | None = None,
+    strict: bool | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> UrlSchema:
+    """
+    Returns a schema that matches a URL value, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.url_schema()
+    v = SchemaValidator(schema)
+    print(v.validate_python('https://example.com'))
+    #> https://example.com/
+    ```
+
+    Args:
+        max_length: The maximum length of the URL
+        allowed_schemes: The allowed URL schemes
+        host_required: Whether the URL must have a host
+        default_host: The default host to use if the URL does not have a host
+        default_port: The default port to use if the URL does not have a port
+        default_path: The default path to use if the URL does not have a path
+        strict: Whether to use strict URL parsing
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='url',
+        max_length=max_length,
+        allowed_schemes=allowed_schemes,
+        host_required=host_required,
+        default_host=default_host,
+        default_port=default_port,
+        default_path=default_path,
+        strict=strict,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class MultiHostUrlSchema(TypedDict, total=False):
+    type: Required[Literal['multi-host-url']]
+    max_length: int
+    allowed_schemes: List[str]
+    host_required: bool  # default False
+    default_host: str
+    default_port: int
+    default_path: str
+    strict: bool
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def multi_host_url_schema(
+    *,
+    max_length: int | None = None,
+    allowed_schemes: list[str] | None = None,
+    host_required: bool | None = None,
+    default_host: str | None = None,
+    default_port: int | None = None,
+    default_path: str | None = None,
+    strict: bool | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> MultiHostUrlSchema:
+    """
+    Returns a schema that matches a URL value with possibly multiple hosts, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.multi_host_url_schema()
+    v = SchemaValidator(schema)
+    print(v.validate_python('redis://localhost,0.0.0.0,127.0.0.1'))
+    #> redis://localhost,0.0.0.0,127.0.0.1
+    ```
+
+    Args:
+        max_length: The maximum length of the URL
+        allowed_schemes: The allowed URL schemes
+        host_required: Whether the URL must have a host
+        default_host: The default host to use if the URL does not have a host
+        default_port: The default port to use if the URL does not have a port
+        default_path: The default path to use if the URL does not have a path
+        strict: Whether to use strict URL parsing
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='multi-host-url',
+        max_length=max_length,
+        allowed_schemes=allowed_schemes,
+        host_required=host_required,
+        default_host=default_host,
+        default_port=default_port,
+        default_path=default_path,
+        strict=strict,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class DefinitionsSchema(TypedDict, total=False):
+    type: Required[Literal['definitions']]
+    schema: Required[CoreSchema]
+    definitions: Required[List[CoreSchema]]
+    metadata: Any
+    serialization: SerSchema
+
+
+def definitions_schema(schema: CoreSchema, definitions: list[CoreSchema]) -> DefinitionsSchema:
+    """
+    Build a schema that contains both an inner schema and a list of definitions which can be used
+    within the inner schema.
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.definitions_schema(
+        core_schema.list_schema(core_schema.definition_reference_schema('foobar')),
+        [core_schema.int_schema(ref='foobar')],
+    )
+    v = SchemaValidator(schema)
+    assert v.validate_python([1, 2, '3']) == [1, 2, 3]
+    ```
+
+    Args:
+        schema: The inner schema
+        definitions: List of definitions which can be referenced within inner schema
+    """
+    return DefinitionsSchema(type='definitions', schema=schema, definitions=definitions)
+
+
+class DefinitionReferenceSchema(TypedDict, total=False):
+    type: Required[Literal['definition-ref']]
+    schema_ref: Required[str]
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def definition_reference_schema(
+    schema_ref: str, ref: str | None = None, metadata: Any = None, serialization: SerSchema | None = None
+) -> DefinitionReferenceSchema:
+    """
+    Returns a schema that points to a schema stored in "definitions", this is useful for nested recursive
+    models and also when you want to define validators separately from the main schema, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema_definition = core_schema.definition_reference_schema('list-schema')
+    schema = core_schema.definitions_schema(
+        schema=schema_definition,
+        definitions=[
+            core_schema.list_schema(items_schema=schema_definition, ref='list-schema'),
+        ],
+    )
+    v = SchemaValidator(schema)
+    assert v.validate_python([()]) == [[]]
+    ```
+
+    Args:
+        schema_ref: The schema ref to use for the definition reference schema
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='definition-ref', schema_ref=schema_ref, ref=ref, metadata=metadata, serialization=serialization
+    )
+
+
+MYPY = False
+# See https://github.com/python/mypy/issues/14034 for details, in summary mypy is extremely slow to process this
+# union which kills performance not just for pydantic, but even for code using pydantic
+if not MYPY:
+    CoreSchema = Union[
+        AnySchema,
+        NoneSchema,
+        BoolSchema,
+        IntSchema,
+        FloatSchema,
+        DecimalSchema,
+        StringSchema,
+        BytesSchema,
+        DateSchema,
+        TimeSchema,
+        DatetimeSchema,
+        TimedeltaSchema,
+        LiteralSchema,
+        IsInstanceSchema,
+        IsSubclassSchema,
+        CallableSchema,
+        ListSchema,
+        TupleSchema,
+        SetSchema,
+        FrozenSetSchema,
+        GeneratorSchema,
+        DictSchema,
+        AfterValidatorFunctionSchema,
+        BeforeValidatorFunctionSchema,
+        WrapValidatorFunctionSchema,
+        PlainValidatorFunctionSchema,
+        WithDefaultSchema,
+        NullableSchema,
+        UnionSchema,
+        TaggedUnionSchema,
+        ChainSchema,
+        LaxOrStrictSchema,
+        JsonOrPythonSchema,
+        TypedDictSchema,
+        ModelFieldsSchema,
+        ModelSchema,
+        DataclassArgsSchema,
+        DataclassSchema,
+        ArgumentsSchema,
+        CallSchema,
+        CustomErrorSchema,
+        JsonSchema,
+        UrlSchema,
+        MultiHostUrlSchema,
+        DefinitionsSchema,
+        DefinitionReferenceSchema,
+        UuidSchema,
+    ]
+elif False:
+    CoreSchema: TypeAlias = Mapping[str, Any]
+
+
+# to update this, call `pytest -k test_core_schema_type_literal` and copy the output
+CoreSchemaType = Literal[
+    'any',
+    'none',
+    'bool',
+    'int',
+    'float',
+    'decimal',
+    'str',
+    'bytes',
+    'date',
+    'time',
+    'datetime',
+    'timedelta',
+    'literal',
+    'is-instance',
+    'is-subclass',
+    'callable',
+    'list',
+    'tuple',
+    'set',
+    'frozenset',
+    'generator',
+    'dict',
+    'function-after',
+    'function-before',
+    'function-wrap',
+    'function-plain',
+    'default',
+    'nullable',
+    'union',
+    'tagged-union',
+    'chain',
+    'lax-or-strict',
+    'json-or-python',
+    'typed-dict',
+    'model-fields',
+    'model',
+    'dataclass-args',
+    'dataclass',
+    'arguments',
+    'call',
+    'custom-error',
+    'json',
+    'url',
+    'multi-host-url',
+    'definitions',
+    'definition-ref',
+    'uuid',
+]
+
+CoreSchemaFieldType = Literal['model-field', 'dataclass-field', 'typed-dict-field', 'computed-field']
+
+
+# used in _pydantic_core.pyi::PydanticKnownError
+# to update this, call `pytest -k test_all_errors` and copy the output
+ErrorType = Literal[
+    'no_such_attribute',
+    'json_invalid',
+    'json_type',
+    'recursion_loop',
+    'missing',
+    'frozen_field',
+    'frozen_instance',
+    'extra_forbidden',
+    'invalid_key',
+    'get_attribute_error',
+    'model_type',
+    'model_attributes_type',
+    'dataclass_type',
+    'dataclass_exact_type',
+    'none_required',
+    'greater_than',
+    'greater_than_equal',
+    'less_than',
+    'less_than_equal',
+    'multiple_of',
+    'finite_number',
+    'too_short',
+    'too_long',
+    'iterable_type',
+    'iteration_error',
+    'string_type',
+    'string_sub_type',
+    'string_unicode',
+    'string_too_short',
+    'string_too_long',
+    'string_pattern_mismatch',
+    'enum',
+    'dict_type',
+    'mapping_type',
+    'list_type',
+    'tuple_type',
+    'set_type',
+    'bool_type',
+    'bool_parsing',
+    'int_type',
+    'int_parsing',
+    'int_parsing_size',
+    'int_from_float',
+    'float_type',
+    'float_parsing',
+    'bytes_type',
+    'bytes_too_short',
+    'bytes_too_long',
+    'value_error',
+    'assertion_error',
+    'literal_error',
+    'date_type',
+    'date_parsing',
+    'date_from_datetime_parsing',
+    'date_from_datetime_inexact',
+    'date_past',
+    'date_future',
+    'time_type',
+    'time_parsing',
+    'datetime_type',
+    'datetime_parsing',
+    'datetime_object_invalid',
+    'datetime_from_date_parsing',
+    'datetime_past',
+    'datetime_future',
+    'timezone_naive',
+    'timezone_aware',
+    'timezone_offset',
+    'time_delta_type',
+    'time_delta_parsing',
+    'frozen_set_type',
+    'is_instance_of',
+    'is_subclass_of',
+    'callable_type',
+    'union_tag_invalid',
+    'union_tag_not_found',
+    'arguments_type',
+    'missing_argument',
+    'unexpected_keyword_argument',
+    'missing_keyword_only_argument',
+    'unexpected_positional_argument',
+    'missing_positional_only_argument',
+    'multiple_argument_values',
+    'url_type',
+    'url_parsing',
+    'url_syntax_violation',
+    'url_too_long',
+    'url_scheme',
+    'uuid_type',
+    'uuid_parsing',
+    'uuid_version',
+    'decimal_type',
+    'decimal_parsing',
+    'decimal_max_digits',
+    'decimal_max_places',
+    'decimal_whole_digits',
+]
+
+
+def _dict_not_none(**kwargs: Any) -> Any:
+    return {k: v for k, v in kwargs.items() if v is not None}
+
+
+###############################################################################
+# All this stuff is deprecated by #980 and will be removed eventually
+# They're kept because some code external code will be using them
+
+
+@deprecated('`field_before_validator_function` is deprecated, use `with_info_before_validator_function` instead.')
+def field_before_validator_function(function: WithInfoValidatorFunction, field_name: str, schema: CoreSchema, **kwargs):
+    warnings.warn(
+        '`field_before_validator_function` is deprecated, use `with_info_before_validator_function` instead.',
+        DeprecationWarning,
+    )
+    return with_info_before_validator_function(function, schema, field_name=field_name, **kwargs)
+
+
+@deprecated('`general_before_validator_function` is deprecated, use `with_info_before_validator_function` instead.')
+def general_before_validator_function(*args, **kwargs):
+    warnings.warn(
+        '`general_before_validator_function` is deprecated, use `with_info_before_validator_function` instead.',
+        DeprecationWarning,
+    )
+    return with_info_before_validator_function(*args, **kwargs)
+
+
+@deprecated('`field_after_validator_function` is deprecated, use `with_info_after_validator_function` instead.')
+def field_after_validator_function(function: WithInfoValidatorFunction, field_name: str, schema: CoreSchema, **kwargs):
+    warnings.warn(
+        '`field_after_validator_function` is deprecated, use `with_info_after_validator_function` instead.',
+        DeprecationWarning,
+    )
+    return with_info_after_validator_function(function, schema, field_name=field_name, **kwargs)
+
+
+@deprecated('`general_after_validator_function` is deprecated, use `with_info_after_validator_function` instead.')
+def general_after_validator_function(*args, **kwargs):
+    warnings.warn(
+        '`general_after_validator_function` is deprecated, use `with_info_after_validator_function` instead.',
+        DeprecationWarning,
+    )
+    return with_info_after_validator_function(*args, **kwargs)
+
+
+@deprecated('`field_wrap_validator_function` is deprecated, use `with_info_wrap_validator_function` instead.')
+def field_wrap_validator_function(
+    function: WithInfoWrapValidatorFunction, field_name: str, schema: CoreSchema, **kwargs
+):
+    warnings.warn(
+        '`field_wrap_validator_function` is deprecated, use `with_info_wrap_validator_function` instead.',
+        DeprecationWarning,
+    )
+    return with_info_wrap_validator_function(function, schema, field_name=field_name, **kwargs)
+
+
+@deprecated('`general_wrap_validator_function` is deprecated, use `with_info_wrap_validator_function` instead.')
+def general_wrap_validator_function(*args, **kwargs):
+    warnings.warn(
+        '`general_wrap_validator_function` is deprecated, use `with_info_wrap_validator_function` instead.',
+        DeprecationWarning,
+    )
+    return with_info_wrap_validator_function(*args, **kwargs)
+
+
+@deprecated('`field_plain_validator_function` is deprecated, use `with_info_plain_validator_function` instead.')
+def field_plain_validator_function(function: WithInfoValidatorFunction, field_name: str, **kwargs):
+    warnings.warn(
+        '`field_plain_validator_function` is deprecated, use `with_info_plain_validator_function` instead.',
+        DeprecationWarning,
+    )
+    return with_info_plain_validator_function(function, field_name=field_name, **kwargs)
+
+
+@deprecated('`general_plain_validator_function` is deprecated, use `with_info_plain_validator_function` instead.')
+def general_plain_validator_function(*args, **kwargs):
+    warnings.warn(
+        '`general_plain_validator_function` is deprecated, use `with_info_plain_validator_function` instead.',
+        DeprecationWarning,
+    )
+    return with_info_plain_validator_function(*args, **kwargs)
+
+
+_deprecated_import_lookup = {
+    'FieldValidationInfo': ValidationInfo,
+    'FieldValidatorFunction': WithInfoValidatorFunction,
+    'GeneralValidatorFunction': WithInfoValidatorFunction,
+    'FieldWrapValidatorFunction': WithInfoWrapValidatorFunction,
+}
+
+if TYPE_CHECKING:
+    FieldValidationInfo = ValidationInfo
+
+
+def __getattr__(attr_name: str) -> object:
+    new_attr = _deprecated_import_lookup.get(attr_name)
+    if new_attr is None:
+        raise AttributeError(f"module 'pydantic_core' has no attribute '{attr_name}'")
+    else:
+        import warnings
+
+        msg = f'`{attr_name}` is deprecated, use `{new_attr.__name__}` instead.'
+        warnings.warn(msg, DeprecationWarning, stacklevel=1)
+        return new_attr
diff --git a/lib/pydantic_core/py.typed b/lib/pydantic_core/py.typed
new file mode 100644
index 00000000..e69de29b
diff --git a/lib/pythoncom.py b/lib/pythoncom.py
new file mode 100644
index 00000000..2180ecc3
--- /dev/null
+++ b/lib/pythoncom.py
@@ -0,0 +1,4 @@
+# Magic utility that "redirects" to pythoncomxx.dll
+import pywintypes
+
+pywintypes.__import_pywin32_system_module__("pythoncom", globals())
diff --git a/lib/pythonwin/license.txt b/lib/pythonwin/license.txt
new file mode 100644
index 00000000..fa340d74
--- /dev/null
+++ b/lib/pythonwin/license.txt
@@ -0,0 +1,30 @@
+Unless stated in the specfic source file, this work is
+Copyright (c) 1994-2008, Mark Hammond 
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without 
+modification, are permitted provided that the following conditions 
+are met:
+
+Redistributions of source code must retain the above copyright notice, 
+this list of conditions and the following disclaimer.
+
+Redistributions in binary form must reproduce the above copyright 
+notice, this list of conditions and the following disclaimer in 
+the documentation and/or other materials provided with the distribution.
+
+Neither name of Mark Hammond nor the name of contributors may be used 
+to endorse or promote products derived from this software without 
+specific prior written permission. 
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS
+IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR
+CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 
diff --git a/lib/pythonwin/pywin/Demos/app/basictimerapp.py b/lib/pythonwin/pywin/Demos/app/basictimerapp.py
new file mode 100644
index 00000000..da771da1
--- /dev/null
+++ b/lib/pythonwin/pywin/Demos/app/basictimerapp.py
@@ -0,0 +1,258 @@
+# basictimerapp - a really simple timer application.
+# This should be run using the command line:
+# pythonwin /app demos\basictimerapp.py
+import sys
+import time
+
+import timer
+import win32api
+import win32con
+import win32ui
+from pywin.framework import app, cmdline, dlgappcore
+
+
+class TimerAppDialog(dlgappcore.AppDialog):
+    softspace = 1
+
+    def __init__(self, appName=""):
+        dlgappcore.AppDialog.__init__(self, win32ui.IDD_GENERAL_STATUS)
+        self.timerAppName = appName
+        self.argOff = 0
+        if len(self.timerAppName) == 0:
+            if len(sys.argv) > 1 and sys.argv[1][0] != "/":
+                self.timerAppName = sys.argv[1]
+                self.argOff = 1
+
+    def PreDoModal(self):
+        # 		sys.stderr = sys.stdout
+        pass
+
+    def ProcessArgs(self, args):
+        for arg in args:
+            if arg == "/now":
+                self.OnOK()
+
+    def OnInitDialog(self):
+        win32ui.SetProfileFileName("pytimer.ini")
+        self.title = win32ui.GetProfileVal(
+            self.timerAppName, "Title", "Remote System Timer"
+        )
+        self.buildTimer = win32ui.GetProfileVal(
+            self.timerAppName, "Timer", "EachMinuteIntervaler()"
+        )
+        self.doWork = win32ui.GetProfileVal(self.timerAppName, "Work", "DoDemoWork()")
+        # replace "\n" with real \n.
+        self.doWork = self.doWork.replace("\\n", "\n")
+        dlgappcore.AppDialog.OnInitDialog(self)
+
+        self.SetWindowText(self.title)
+        self.prompt1 = self.GetDlgItem(win32ui.IDC_PROMPT1)
+        self.prompt2 = self.GetDlgItem(win32ui.IDC_PROMPT2)
+        self.prompt3 = self.GetDlgItem(win32ui.IDC_PROMPT3)
+        self.butOK = self.GetDlgItem(win32con.IDOK)
+        self.butCancel = self.GetDlgItem(win32con.IDCANCEL)
+        self.prompt1.SetWindowText("Python Timer App")
+        self.prompt2.SetWindowText("")
+        self.prompt3.SetWindowText("")
+        self.butOK.SetWindowText("Do it now")
+        self.butCancel.SetWindowText("Close")
+
+        self.timerManager = TimerManager(self)
+        self.ProcessArgs(sys.argv[self.argOff :])
+        self.timerManager.go()
+        return 1
+
+    def OnDestroy(self, msg):
+        dlgappcore.AppDialog.OnDestroy(self, msg)
+        self.timerManager.stop()
+
+    def OnOK(self):
+        # stop the timer, then restart after setting special boolean
+        self.timerManager.stop()
+        self.timerManager.bConnectNow = 1
+        self.timerManager.go()
+        return
+
+
+# 	def OnCancel(self): default behaviour - cancel == close.
+# 		return
+
+
+class TimerManager:
+    def __init__(self, dlg):
+        self.dlg = dlg
+        self.timerId = None
+        self.intervaler = eval(self.dlg.buildTimer)
+        self.bConnectNow = 0
+        self.bHaveSetPrompt1 = 0
+
+    def CaptureOutput(self):
+        self.oldOut = sys.stdout
+        self.oldErr = sys.stderr
+        sys.stdout = sys.stderr = self
+        self.bHaveSetPrompt1 = 0
+
+    def ReleaseOutput(self):
+        sys.stdout = self.oldOut
+        sys.stderr = self.oldErr
+
+    def write(self, str):
+        s = str.strip()
+        if len(s):
+            if self.bHaveSetPrompt1:
+                dest = self.dlg.prompt3
+            else:
+                dest = self.dlg.prompt1
+                self.bHaveSetPrompt1 = 1
+            dest.SetWindowText(s)
+
+    def go(self):
+        self.OnTimer(None, None)
+
+    def stop(self):
+        if self.timerId:
+            timer.kill_timer(self.timerId)
+        self.timerId = None
+
+    def OnTimer(self, id, timeVal):
+        if id:
+            timer.kill_timer(id)
+        if self.intervaler.IsTime() or self.bConnectNow:
+            # do the work.
+            try:
+                self.dlg.SetWindowText(self.dlg.title + " - Working...")
+                self.dlg.butOK.EnableWindow(0)
+                self.dlg.butCancel.EnableWindow(0)
+                self.CaptureOutput()
+                try:
+                    exec(self.dlg.doWork)
+                    print("The last operation completed successfully.")
+                except:
+                    t, v, tb = sys.exc_info()
+                    str = "Failed: %s: %s" % (t, repr(v))
+                    print(str)
+                    self.oldErr.write(str)
+                    tb = None  # Prevent cycle
+            finally:
+                self.ReleaseOutput()
+                self.dlg.butOK.EnableWindow()
+                self.dlg.butCancel.EnableWindow()
+                self.dlg.SetWindowText(self.dlg.title)
+        else:
+            now = time.time()
+            nextTime = self.intervaler.GetNextTime()
+            if nextTime:
+                timeDiffSeconds = nextTime - now
+                timeDiffMinutes = int(timeDiffSeconds / 60)
+                timeDiffSeconds = timeDiffSeconds % 60
+                timeDiffHours = int(timeDiffMinutes / 60)
+                timeDiffMinutes = timeDiffMinutes % 60
+                self.dlg.prompt1.SetWindowText(
+                    "Next connection due in %02d:%02d:%02d"
+                    % (timeDiffHours, timeDiffMinutes, timeDiffSeconds)
+                )
+        self.timerId = timer.set_timer(
+            self.intervaler.GetWakeupInterval(), self.OnTimer
+        )
+        self.bConnectNow = 0
+
+
+class TimerIntervaler:
+    def __init__(self):
+        self.nextTime = None
+        self.wakeUpInterval = 2000
+
+    def GetWakeupInterval(self):
+        return self.wakeUpInterval
+
+    def GetNextTime(self):
+        return self.nextTime
+
+    def IsTime(self):
+        now = time.time()
+        if self.nextTime is None:
+            self.nextTime = self.SetFirstTime(now)
+        ret = 0
+        if now >= self.nextTime:
+            ret = 1
+            self.nextTime = self.SetNextTime(self.nextTime, now)
+            # do the work.
+        return ret
+
+
+class EachAnyIntervaler(TimerIntervaler):
+    def __init__(self, timeAt, timePos, timeAdd, wakeUpInterval=None):
+        TimerIntervaler.__init__(self)
+        self.timeAt = timeAt
+        self.timePos = timePos
+        self.timeAdd = timeAdd
+        if wakeUpInterval:
+            self.wakeUpInterval = wakeUpInterval
+
+    def SetFirstTime(self, now):
+        timeTup = time.localtime(now)
+        lst = []
+        for item in timeTup:
+            lst.append(item)
+        bAdd = timeTup[self.timePos] > self.timeAt
+        lst[self.timePos] = self.timeAt
+        for pos in range(self.timePos + 1, 6):
+            lst[pos] = 0
+        ret = time.mktime(tuple(lst))
+        if bAdd:
+            ret = ret + self.timeAdd
+        return ret
+
+    def SetNextTime(self, lastTime, now):
+        return lastTime + self.timeAdd
+
+
+class EachMinuteIntervaler(EachAnyIntervaler):
+    def __init__(self, at=0):
+        EachAnyIntervaler.__init__(self, at, 5, 60, 2000)
+
+
+class EachHourIntervaler(EachAnyIntervaler):
+    def __init__(self, at=0):
+        EachAnyIntervaler.__init__(self, at, 4, 3600, 10000)
+
+
+class EachDayIntervaler(EachAnyIntervaler):
+    def __init__(self, at=0):
+        EachAnyIntervaler.__init__(self, at, 3, 86400, 10000)
+
+
+class TimerDialogApp(dlgappcore.DialogApp):
+    def CreateDialog(self):
+        return TimerAppDialog()
+
+
+def DoDemoWork():
+    print("Doing the work...")
+    print("About to connect")
+    win32api.MessageBeep(win32con.MB_ICONASTERISK)
+    win32api.Sleep(2000)
+    print("Doing something else...")
+    win32api.MessageBeep(win32con.MB_ICONEXCLAMATION)
+    win32api.Sleep(2000)
+    print("More work.")
+    win32api.MessageBeep(win32con.MB_ICONHAND)
+    win32api.Sleep(2000)
+    print("The last bit.")
+    win32api.MessageBeep(win32con.MB_OK)
+    win32api.Sleep(2000)
+
+
+app = TimerDialogApp()
+
+
+def t():
+    t = TimerAppDialog("Test Dialog")
+    t.DoModal()
+    return t
+
+
+if __name__ == "__main__":
+    import demoutils
+
+    demoutils.NeedApp()
diff --git a/lib/pythonwin/pywin/Demos/app/customprint.py b/lib/pythonwin/pywin/Demos/app/customprint.py
new file mode 100644
index 00000000..356073e5
--- /dev/null
+++ b/lib/pythonwin/pywin/Demos/app/customprint.py
@@ -0,0 +1,186 @@
+# A demo of an Application object that has some custom print functionality.
+
+# If you desire, you can also run this from inside Pythonwin, in which
+# case it will do the demo inside the Pythonwin environment.
+
+# This sample was contributed by Roger Burnham.
+
+import win32api
+import win32con
+import win32ui
+from pywin.framework import app
+from pywin.mfc import afxres, dialog, docview
+
+PRINTDLGORD = 1538
+IDC_PRINT_MAG_EDIT = 1010
+
+
+class PrintDemoTemplate(docview.DocTemplate):
+    def _SetupSharedMenu_(self):
+        pass
+
+
+class PrintDemoView(docview.ScrollView):
+    def OnInitialUpdate(self):
+        ret = self._obj_.OnInitialUpdate()
+        self.colors = {
+            "Black": (0x00 << 0) + (0x00 << 8) + (0x00 << 16),
+            "Red": (0xFF << 0) + (0x00 << 8) + (0x00 << 16),
+            "Green": (0x00 << 0) + (0xFF << 8) + (0x00 << 16),
+            "Blue": (0x00 << 0) + (0x00 << 8) + (0xFF << 16),
+            "Cyan": (0x00 << 0) + (0xFF << 8) + (0xFF << 16),
+            "Magenta": (0xFF << 0) + (0x00 << 8) + (0xFF << 16),
+            "Yellow": (0xFF << 0) + (0xFF << 8) + (0x00 << 16),
+        }
+        self.pens = {}
+        for name, color in self.colors.items():
+            self.pens[name] = win32ui.CreatePen(win32con.PS_SOLID, 5, color)
+        self.pen = None
+        self.size = (128, 128)
+        self.SetScaleToFitSize(self.size)
+        self.HookCommand(self.OnFilePrint, afxres.ID_FILE_PRINT)
+        self.HookCommand(self.OnFilePrintPreview, win32ui.ID_FILE_PRINT_PREVIEW)
+        return ret
+
+    def OnDraw(self, dc):
+        oldPen = None
+        x, y = self.size
+        delta = 2
+        colors = list(self.colors.keys())
+        colors.sort()
+        colors = colors * 2
+        for color in colors:
+            if oldPen is None:
+                oldPen = dc.SelectObject(self.pens[color])
+            else:
+                dc.SelectObject(self.pens[color])
+            dc.MoveTo((delta, delta))
+            dc.LineTo((x - delta, delta))
+            dc.LineTo((x - delta, y - delta))
+            dc.LineTo((delta, y - delta))
+            dc.LineTo((delta, delta))
+            delta = delta + 4
+            if x - delta <= 0 or y - delta <= 0:
+                break
+        dc.SelectObject(oldPen)
+
+    def OnPrepareDC(self, dc, pInfo):
+        if dc.IsPrinting():
+            mag = self.prtDlg["mag"]
+            dc.SetMapMode(win32con.MM_ANISOTROPIC)
+            dc.SetWindowOrg((0, 0))
+            dc.SetWindowExt((1, 1))
+            dc.SetViewportOrg((0, 0))
+            dc.SetViewportExt((mag, mag))
+
+    def OnPreparePrinting(self, pInfo):
+        flags = (
+            win32ui.PD_USEDEVMODECOPIES
+            | win32ui.PD_PAGENUMS
+            | win32ui.PD_NOPAGENUMS
+            | win32ui.PD_NOSELECTION
+        )
+        self.prtDlg = ImagePrintDialog(pInfo, PRINTDLGORD, flags)
+        pInfo.SetPrintDialog(self.prtDlg)
+        pInfo.SetMinPage(1)
+        pInfo.SetMaxPage(1)
+        pInfo.SetFromPage(1)
+        pInfo.SetToPage(1)
+        ret = self.DoPreparePrinting(pInfo)
+        return ret
+
+    def OnBeginPrinting(self, dc, pInfo):
+        return self._obj_.OnBeginPrinting(dc, pInfo)
+
+    def OnEndPrinting(self, dc, pInfo):
+        del self.prtDlg
+        return self._obj_.OnEndPrinting(dc, pInfo)
+
+    def OnFilePrintPreview(self, *arg):
+        self._obj_.OnFilePrintPreview()
+
+    def OnFilePrint(self, *arg):
+        self._obj_.OnFilePrint()
+
+    def OnPrint(self, dc, pInfo):
+        doc = self.GetDocument()
+        metrics = dc.GetTextMetrics()
+        cxChar = metrics["tmAveCharWidth"]
+        cyChar = metrics["tmHeight"]
+        left, top, right, bottom = pInfo.GetDraw()
+        dc.TextOut(0, 2 * cyChar, doc.GetTitle())
+        top = top + (7 * cyChar) / 2
+        dc.MoveTo(left, top)
+        dc.LineTo(right, top)
+        top = top + cyChar
+        # this seems to have not effect...
+        # get what I want with the dc.SetWindowOrg calls
+        pInfo.SetDraw((left, top, right, bottom))
+        dc.SetWindowOrg((0, -top))
+
+        self.OnDraw(dc)
+        dc.SetTextAlign(win32con.TA_LEFT | win32con.TA_BOTTOM)
+
+        rect = self.GetWindowRect()
+        rect = self.ScreenToClient(rect)
+        height = rect[3] - rect[1]
+        dc.SetWindowOrg((0, -(top + height + cyChar)))
+        dc.MoveTo(left, 0)
+        dc.LineTo(right, 0)
+
+        x = 0
+        y = (3 * cyChar) / 2
+
+        dc.TextOut(x, y, doc.GetTitle())
+        y = y + cyChar
+
+
+class PrintDemoApp(app.CApp):
+    def __init__(self):
+        app.CApp.__init__(self)
+
+    def InitInstance(self):
+        template = PrintDemoTemplate(None, None, None, PrintDemoView)
+        self.AddDocTemplate(template)
+        self._obj_.InitMDIInstance()
+        self.LoadMainFrame()
+        doc = template.OpenDocumentFile(None)
+        doc.SetTitle("Custom Print Document")
+
+
+class ImagePrintDialog(dialog.PrintDialog):
+    sectionPos = "Image Print Demo"
+
+    def __init__(self, pInfo, dlgID, flags=win32ui.PD_USEDEVMODECOPIES):
+        dialog.PrintDialog.__init__(self, pInfo, dlgID, flags=flags)
+        mag = win32ui.GetProfileVal(self.sectionPos, "Document Magnification", 0)
+        if mag <= 0:
+            mag = 2
+            win32ui.WriteProfileVal(self.sectionPos, "Document Magnification", mag)
+
+        self["mag"] = mag
+
+    def OnInitDialog(self):
+        self.magCtl = self.GetDlgItem(IDC_PRINT_MAG_EDIT)
+        self.magCtl.SetWindowText(repr(self["mag"]))
+        return dialog.PrintDialog.OnInitDialog(self)
+
+    def OnOK(self):
+        dialog.PrintDialog.OnOK(self)
+        strMag = self.magCtl.GetWindowText()
+        try:
+            self["mag"] = int(strMag)
+        except:
+            pass
+        win32ui.WriteProfileVal(self.sectionPos, "Document Magnification", self["mag"])
+
+
+if __name__ == "__main__":
+    # Running under Pythonwin
+    def test():
+        template = PrintDemoTemplate(None, None, None, PrintDemoView)
+        template.OpenDocumentFile(None)
+
+    test()
+else:
+    app = PrintDemoApp()
diff --git a/lib/pythonwin/pywin/Demos/app/demoutils.py b/lib/pythonwin/pywin/Demos/app/demoutils.py
new file mode 100644
index 00000000..ee1fefcf
--- /dev/null
+++ b/lib/pythonwin/pywin/Demos/app/demoutils.py
@@ -0,0 +1,65 @@
+# Utilities for the demos
+
+import sys
+
+import win32api
+import win32con
+import win32ui
+
+NotScriptMsg = """\
+This demo program is not designed to be run as a Script, but is
+probably used by some other test program.  Please try another demo.
+"""
+
+NeedGUIMsg = """\
+This demo program can only be run from inside of Pythonwin
+
+You must start Pythonwin, and select 'Run' from the toolbar or File menu
+"""
+
+
+NeedAppMsg = """\
+This demo program is a 'Pythonwin Application'.
+
+It is more demo code than an example of Pythonwin's capabilities.
+
+To run it, you must execute the command:
+pythonwin.exe /app "%s"
+
+Would you like to execute it now?
+"""
+
+
+def NotAScript():
+    import win32ui
+
+    win32ui.MessageBox(NotScriptMsg, "Demos")
+
+
+def NeedGoodGUI():
+    from pywin.framework.app import HaveGoodGUI
+
+    rc = HaveGoodGUI()
+    if not rc:
+        win32ui.MessageBox(NeedGUIMsg, "Demos")
+    return rc
+
+
+def NeedApp():
+    import win32ui
+
+    rc = win32ui.MessageBox(NeedAppMsg % sys.argv[0], "Demos", win32con.MB_YESNO)
+    if rc == win32con.IDYES:
+        try:
+            parent = win32ui.GetMainFrame().GetSafeHwnd()
+            win32api.ShellExecute(
+                parent, None, "pythonwin.exe", '/app "%s"' % sys.argv[0], None, 1
+            )
+        except win32api.error as details:
+            win32ui.MessageBox("Error executing command - %s" % (details), "Demos")
+
+
+if __name__ == "__main__":
+    import demoutils
+
+    demoutils.NotAScript()
diff --git a/lib/pythonwin/pywin/Demos/app/dlgappdemo.py b/lib/pythonwin/pywin/Demos/app/dlgappdemo.py
new file mode 100644
index 00000000..38659a62
--- /dev/null
+++ b/lib/pythonwin/pywin/Demos/app/dlgappdemo.py
@@ -0,0 +1,51 @@
+# dlgappdemo - a demo of a dialog application.
+# This is a demonstration of both a custom "application" module,
+# and a Python program in a dialog box.
+#
+# NOTE:  You CAN NOT import this module from either PythonWin or Python.
+# This module must be specified on the commandline to PythonWin only.
+# eg, PythonWin /app dlgappdemo.py
+
+import sys
+
+import win32ui
+from pywin.framework import app, dlgappcore
+
+
+class TestDialogApp(dlgappcore.DialogApp):
+    def CreateDialog(self):
+        return TestAppDialog()
+
+
+class TestAppDialog(dlgappcore.AppDialog):
+    def __init__(self):
+        self.edit = None
+        dlgappcore.AppDialog.__init__(self, win32ui.IDD_LARGE_EDIT)
+
+    def OnInitDialog(self):
+        self.SetWindowText("Test dialog application")
+        self.edit = self.GetDlgItem(win32ui.IDC_EDIT1)
+        print("Hello from Python")
+        print("args are:", end=" ")
+        for arg in sys.argv:
+            print(arg)
+        return 1
+
+    def PreDoModal(self):
+        sys.stdout = sys.stderr = self
+
+    def write(self, str):
+        if self.edit:
+            self.edit.SetSel(-2)
+            # translate \n to \n\r
+            self.edit.ReplaceSel(str.replace("\n", "\r\n"))
+        else:
+            win32ui.OutputDebug("dlgapp - no edit control! >>\n%s\n<<\n" % str)
+
+
+app.AppBuilder = TestDialogApp
+
+if __name__ == "__main__":
+    import demoutils
+
+    demoutils.NeedApp()
diff --git a/lib/pythonwin/pywin/Demos/app/dojobapp.py b/lib/pythonwin/pywin/Demos/app/dojobapp.py
new file mode 100644
index 00000000..d97ce5e2
--- /dev/null
+++ b/lib/pythonwin/pywin/Demos/app/dojobapp.py
@@ -0,0 +1,72 @@
+# dojobapp - do a job, show the result in a dialog, and exit.
+#
+# Very simple - faily minimal dialog based app.
+#
+# This should be run using the command line:
+# pythonwin /app demos\dojobapp.py
+
+
+import win32api
+import win32con
+import win32ui
+from pywin.framework import app, dlgappcore
+
+
+class DoJobAppDialog(dlgappcore.AppDialog):
+    softspace = 1
+
+    def __init__(self, appName=""):
+        self.appName = appName
+        dlgappcore.AppDialog.__init__(self, win32ui.IDD_GENERAL_STATUS)
+
+    def PreDoModal(self):
+        pass
+
+    def ProcessArgs(self, args):
+        pass
+
+    def OnInitDialog(self):
+        self.SetWindowText(self.appName)
+        butCancel = self.GetDlgItem(win32con.IDCANCEL)
+        butCancel.ShowWindow(win32con.SW_HIDE)
+        p1 = self.GetDlgItem(win32ui.IDC_PROMPT1)
+        p2 = self.GetDlgItem(win32ui.IDC_PROMPT2)
+
+        # Do something here!
+
+        p1.SetWindowText("Hello there")
+        p2.SetWindowText("from the demo")
+
+    def OnDestroy(self, msg):
+        pass
+
+
+# 	def OnOK(self):
+# 		pass
+# 	def OnCancel(self): default behaviour - cancel == close.
+# 		return
+
+
+class DoJobDialogApp(dlgappcore.DialogApp):
+    def CreateDialog(self):
+        return DoJobAppDialog("Do Something")
+
+
+class CopyToDialogApp(DoJobDialogApp):
+    def __init__(self):
+        DoJobDialogApp.__init__(self)
+
+
+app.AppBuilder = DoJobDialogApp
+
+
+def t():
+    t = DoJobAppDialog("Copy To")
+    t.DoModal()
+    return t
+
+
+if __name__ == "__main__":
+    import demoutils
+
+    demoutils.NeedApp()
diff --git a/lib/pythonwin/pywin/Demos/app/helloapp.py b/lib/pythonwin/pywin/Demos/app/helloapp.py
new file mode 100644
index 00000000..876f16f7
--- /dev/null
+++ b/lib/pythonwin/pywin/Demos/app/helloapp.py
@@ -0,0 +1,53 @@
+##
+## helloapp.py
+##
+##
+## A nice, small 'hello world' Pythonwin application.
+## NOT an MDI application - just a single, normal, top-level window.
+##
+## MUST be run with the command line "pythonwin.exe /app helloapp.py"
+## (or if you are really keen, rename "pythonwin.exe" to something else, then
+## using MSVC or similar, edit the string section in the .EXE to name this file)
+##
+## Originally by Willy Heineman <wheineman@uconect.net>
+
+
+import win32con
+import win32ui
+from pywin.mfc import afxres, dialog, window
+from pywin.mfc.thread import WinApp
+
+
+# The main frame.
+# Does almost nothing at all - doesnt even create a child window!
+class HelloWindow(window.Wnd):
+    def __init__(self):
+        # The window.Wnd ctor creates a Window object, and places it in
+        # self._obj_.  Note the window object exists, but the window itself
+        # does not!
+        window.Wnd.__init__(self, win32ui.CreateWnd())
+
+        # Now we ask the window object to create the window itself.
+        self._obj_.CreateWindowEx(
+            win32con.WS_EX_CLIENTEDGE,
+            win32ui.RegisterWndClass(0, 0, win32con.COLOR_WINDOW + 1),
+            "Hello World!",
+            win32con.WS_OVERLAPPEDWINDOW,
+            (100, 100, 400, 300),
+            None,
+            0,
+            None,
+        )
+
+
+# The application object itself.
+class HelloApp(WinApp):
+    def InitInstance(self):
+        self.frame = HelloWindow()
+        self.frame.ShowWindow(win32con.SW_SHOWNORMAL)
+        # We need to tell MFC what our main frame is.
+        self.SetMainFrame(self.frame)
+
+
+# Now create the application object itself!
+app = HelloApp()
diff --git a/lib/pythonwin/pywin/Demos/cmdserver.py b/lib/pythonwin/pywin/Demos/cmdserver.py
new file mode 100644
index 00000000..7b1c257a
--- /dev/null
+++ b/lib/pythonwin/pywin/Demos/cmdserver.py
@@ -0,0 +1,116 @@
+# cmdserver.py
+
+# Demo code that is not Pythonwin related, but too good to throw away...
+
+import _thread
+import sys
+import traceback
+
+import win32api
+from pywin.framework import winout
+
+
+class ThreadWriter:
+    "Assign an instance to sys.stdout for per-thread printing objects - Courtesy Guido!"
+
+    def __init__(self):
+        "Constructor -- initialize the table of writers"
+        self.writers = {}
+        self.origStdOut = None
+
+    def register(self, writer):
+        "Register the writer for the current thread"
+        self.writers[_thread.get_ident()] = writer
+        if self.origStdOut is None:
+            self.origStdOut = sys.stdout
+            sys.stdout = self
+
+    def unregister(self):
+        "Remove the writer for the current thread, if any"
+        try:
+            del self.writers[_thread.get_ident()]
+        except KeyError:
+            pass
+        if len(self.writers) == 0:
+            sys.stdout = self.origStdOut
+            self.origStdOut = None
+
+    def getwriter(self):
+        "Return the current thread's writer, default sys.stdout"
+        try:
+            return self.writers[_thread.get_ident()]
+        except KeyError:
+            return self.origStdOut
+
+    def write(self, str):
+        "Write to the current thread's writer, default sys.stdout"
+        self.getwriter().write(str)
+
+
+def Test():
+    num = 1
+    while num < 1000:
+        print("Hello there no " + str(num))
+        win32api.Sleep(50)
+        num = num + 1
+
+
+class flags:
+    SERVER_BEST = 0
+    SERVER_IMMEDIATE = 1
+    SERVER_THREAD = 2
+    SERVER_PROCESS = 3
+
+
+def StartServer(cmd, title=None, bCloseOnEnd=0, serverFlags=flags.SERVER_BEST):
+    out = winout.WindowOutput(title, None, winout.flags.WQ_IDLE)
+    if not title:
+        title = cmd
+    out.Create(title)
+    # 	ServerThread((out, cmd, title, bCloseOnEnd))
+    # 	out = sys.stdout
+    _thread.start_new_thread(ServerThread, (out, cmd, title, bCloseOnEnd))
+
+
+def ServerThread(myout, cmd, title, bCloseOnEnd):
+    try:
+        writer.register(myout)
+        print('Executing "%s"\n' % cmd)
+        bOK = 1
+        try:
+            import __main__
+
+            exec(cmd + "\n", __main__.__dict__)
+        except:
+            bOK = 0
+        if bOK:
+            print("Command terminated without errors.")
+        else:
+            t, v, tb = sys.exc_info()
+            print(t, ": ", v)
+            traceback.print_tb(tb)
+            tb = None  # prevent a cycle
+            print("Command terminated with an unhandled exception")
+        writer.unregister()
+        if bOK and bCloseOnEnd:
+            myout.frame.DestroyWindow()
+
+    # Unhandled exception of any kind in a thread kills the gui!
+    except:
+        t, v, tb = sys.exc_info()
+        print(t, ": ", v)
+        traceback.print_tb(tb)
+        tb = None
+        print("Thread failed")
+
+
+# assist for reloading (when debugging) - use only 1 tracer object,
+# else a large chain of tracer objects will exist.
+# try:
+# 	writer
+# except NameError:
+# 	writer=ThreadWriter()
+if __name__ == "__main__":
+    import demoutils
+
+    demoutils.NotAScript()
diff --git a/lib/pythonwin/pywin/Demos/createwin.py b/lib/pythonwin/pywin/Demos/createwin.py
new file mode 100644
index 00000000..38f6947e
--- /dev/null
+++ b/lib/pythonwin/pywin/Demos/createwin.py
@@ -0,0 +1,114 @@
+#
+# Window creation example
+#
+# 	This example creates a minimal "control" that just fills in its
+# 	window with red.  To make your own control, subclass Control and
+# 	write your own OnPaint() method.  See PyCWnd.HookMessage for what
+# 	the parameters to OnPaint are.
+#
+
+import win32api
+import win32con
+import win32ui
+from pywin.mfc import dialog, window
+
+
+class Control(window.Wnd):
+    """Generic control class"""
+
+    def __init__(self):
+        window.Wnd.__init__(self, win32ui.CreateWnd())
+
+    def OnPaint(self):
+        dc, paintStruct = self.BeginPaint()
+        self.DoPaint(dc)
+        self.EndPaint(paintStruct)
+
+    def DoPaint(self, dc):  # Override this!
+        pass
+
+
+class RedBox(Control):
+    def DoPaint(self, dc):
+        dc.FillSolidRect(self.GetClientRect(), win32api.RGB(255, 0, 0))
+
+
+class RedBoxWithPie(RedBox):
+    def DoPaint(self, dc):
+        RedBox.DoPaint(self, dc)
+        r = self.GetClientRect()
+        dc.Pie(r[0], r[1], r[2], r[3], 0, 0, r[2], r[3] // 2)
+
+
+def MakeDlgTemplate():
+    style = (
+        win32con.DS_MODALFRAME
+        | win32con.WS_POPUP
+        | win32con.WS_VISIBLE
+        | win32con.WS_CAPTION
+        | win32con.WS_SYSMENU
+        | win32con.DS_SETFONT
+    )
+    cs = win32con.WS_CHILD | win32con.WS_VISIBLE
+
+    w = 64
+    h = 64
+
+    dlg = [
+        ["Red box", (0, 0, w, h), style, None, (8, "MS Sans Serif")],
+    ]
+
+    s = win32con.WS_TABSTOP | cs
+
+    dlg.append(
+        [
+            128,
+            "Cancel",
+            win32con.IDCANCEL,
+            (7, h - 18, 50, 14),
+            s | win32con.BS_PUSHBUTTON,
+        ]
+    )
+
+    return dlg
+
+
+class TestDialog(dialog.Dialog):
+    def OnInitDialog(self):
+        rc = dialog.Dialog.OnInitDialog(self)
+        self.redbox = RedBox()
+        self.redbox.CreateWindow(
+            None,
+            "RedBox",
+            win32con.WS_CHILD | win32con.WS_VISIBLE,
+            (5, 5, 90, 68),
+            self,
+            1003,
+        )
+        return rc
+
+
+class TestPieDialog(dialog.Dialog):
+    def OnInitDialog(self):
+        rc = dialog.Dialog.OnInitDialog(self)
+        self.control = RedBoxWithPie()
+        self.control.CreateWindow(
+            None,
+            "RedBox with Pie",
+            win32con.WS_CHILD | win32con.WS_VISIBLE,
+            (5, 5, 90, 68),
+            self,
+            1003,
+        )
+
+
+def demo(modal=0):
+    d = TestPieDialog(MakeDlgTemplate())
+    if modal:
+        d.DoModal()
+    else:
+        d.CreateWindow()
+
+
+if __name__ == "__main__":
+    demo(1)
diff --git a/lib/pythonwin/pywin/Demos/demoutils.py b/lib/pythonwin/pywin/Demos/demoutils.py
new file mode 100644
index 00000000..f6080c46
--- /dev/null
+++ b/lib/pythonwin/pywin/Demos/demoutils.py
@@ -0,0 +1,67 @@
+# Utilities for the demos
+
+import sys
+
+import win32api
+import win32con
+import win32ui
+
+NotScriptMsg = """\
+This demo program is not designed to be run as a Script, but is
+probably used by some other test program.  Please try another demo.
+"""
+
+NeedGUIMsg = """\
+This demo program can only be run from inside of Pythonwin
+
+You must start Pythonwin, and select 'Run' from the toolbar or File menu
+"""
+
+
+NeedAppMsg = """\
+This demo program is a 'Pythonwin Application'.
+
+It is more demo code than an example of Pythonwin's capabilities.
+
+To run it, you must execute the command:
+pythonwin.exe /app "%s"
+
+Would you like to execute it now?
+"""
+
+
+def NotAScript():
+    import win32ui
+
+    win32ui.MessageBox(NotScriptMsg, "Demos")
+
+
+def NeedGoodGUI():
+    from pywin.framework.app import HaveGoodGUI
+
+    rc = HaveGoodGUI()
+    if not rc:
+        win32ui.MessageBox(NeedGUIMsg, "Demos")
+    return rc
+
+
+def NeedApp():
+    import win32ui
+
+    rc = win32ui.MessageBox(NeedAppMsg % sys.argv[0], "Demos", win32con.MB_YESNO)
+    if rc == win32con.IDYES:
+        try:
+            parent = win32ui.GetMainFrame().GetSafeHwnd()
+            win32api.ShellExecute(
+                parent, None, "pythonwin.exe", '/app "%s"' % sys.argv[0], None, 1
+            )
+        except win32api.error as details:
+            win32ui.MessageBox("Error executing command - %s" % (details), "Demos")
+
+
+from pywin.framework.app import HaveGoodGUI
+
+if __name__ == "__main__":
+    import demoutils
+
+    demoutils.NotAScript()
diff --git a/lib/pythonwin/pywin/Demos/dibdemo.py b/lib/pythonwin/pywin/Demos/dibdemo.py
new file mode 100644
index 00000000..615227ab
--- /dev/null
+++ b/lib/pythonwin/pywin/Demos/dibdemo.py
@@ -0,0 +1,73 @@
+# A demo which creates a view and a frame which displays a PPM format bitmap
+#
+# This hasnnt been run in a while, as I dont have many of that format around!
+
+import win32api
+import win32con
+import win32ui
+
+
+class DIBView:
+    def __init__(self, doc, dib):
+        self.dib = dib
+        self.view = win32ui.CreateView(doc)
+        self.width = self.height = 0
+        # set up message handlers
+        # 		self.view.OnPrepareDC = self.OnPrepareDC
+        self.view.HookMessage(self.OnSize, win32con.WM_SIZE)
+
+    def OnSize(self, params):
+        lParam = params[3]
+        self.width = win32api.LOWORD(lParam)
+        self.height = win32api.HIWORD(lParam)
+
+    def OnDraw(self, ob, dc):
+        # set sizes used for "non strecth" mode.
+        self.view.SetScrollSizes(win32con.MM_TEXT, self.dib.GetSize())
+        dibSize = self.dib.GetSize()
+        dibRect = (0, 0, dibSize[0], dibSize[1])
+        # stretch BMP.
+        # self.dib.Paint(dc, (0,0,self.width, self.height),dibRect)
+        # non stretch.
+        self.dib.Paint(dc)
+
+
+class DIBDemo:
+    def __init__(self, filename, *bPBM):
+        # init data members
+        f = open(filename, "rb")
+        dib = win32ui.CreateDIBitmap()
+        if len(bPBM) > 0:
+            magic = f.readline()
+            if magic != "P6\n":
+                print("The file is not a PBM format file")
+                raise ValueError("Failed - The file is not a PBM format file")
+            # check magic?
+            rowcollist = f.readline().split()
+            cols = int(rowcollist[0])
+            rows = int(rowcollist[1])
+            f.readline()  # whats this one?
+            dib.LoadPBMData(f, (cols, rows))
+        else:
+            dib.LoadWindowsFormatFile(f)
+        f.close()
+        # create doc/view
+        self.doc = win32ui.CreateDoc()
+        self.dibView = DIBView(self.doc, dib)
+        self.frame = win32ui.CreateMDIFrame()
+        self.frame.LoadFrame()  # this will force OnCreateClient
+        self.doc.SetTitle("DIB Demo")
+        self.frame.ShowWindow()
+
+        # display the sucka
+        self.frame.ActivateFrame()
+
+    def OnCreateClient(self, createparams, context):
+        self.dibView.view.CreateWindow(self.frame)
+        return 1
+
+
+if __name__ == "__main__":
+    import demoutils
+
+    demoutils.NotAScript()
diff --git a/lib/pythonwin/pywin/Demos/dlgtest.py b/lib/pythonwin/pywin/Demos/dlgtest.py
new file mode 100644
index 00000000..8dcb0e5e
--- /dev/null
+++ b/lib/pythonwin/pywin/Demos/dlgtest.py
@@ -0,0 +1,145 @@
+# A Demo of Pythonwin's Dialog and Property Page support.
+
+###################
+#
+# First demo - use the built-in to Pythonwin "Tab Stop" dialog, but
+# customise it heavily.
+#
+# ID's for the tabstop dialog - out test.
+#
+import win32con
+import win32ui
+from pywin.mfc import dialog
+from win32con import IDCANCEL
+from win32ui import IDC_EDIT_TABS, IDC_PROMPT_TABS, IDD_SET_TABSTOPS
+
+
+class TestDialog(dialog.Dialog):
+    def __init__(self, modal=1):
+        dialog.Dialog.__init__(self, IDD_SET_TABSTOPS)
+        self.counter = 0
+        if modal:
+            self.DoModal()
+        else:
+            self.CreateWindow()
+
+    def OnInitDialog(self):
+        # Set the caption of the dialog itself.
+        self.SetWindowText("Used to be Tab Stops!")
+        # Get a child control, remember it, and change its text.
+        self.edit = self.GetDlgItem(IDC_EDIT_TABS)  # the text box.
+        self.edit.SetWindowText("Test")
+        # Hook a Windows message for the dialog.
+        self.edit.HookMessage(self.KillFocus, win32con.WM_KILLFOCUS)
+        # Get the prompt control, and change its next.
+        prompt = self.GetDlgItem(IDC_PROMPT_TABS)  # the prompt box.
+        prompt.SetWindowText("Prompt")
+        # And the same for the button..
+        cancel = self.GetDlgItem(IDCANCEL)  # the cancel button
+        cancel.SetWindowText("&Kill me")
+
+        # And just for demonstration purposes, we hook the notify message for the dialog.
+        # This allows us to be notified when the Edit Control text changes.
+        self.HookCommand(self.OnNotify, IDC_EDIT_TABS)
+
+    def OnNotify(self, controlid, code):
+        if code == win32con.EN_CHANGE:
+            print("Edit text changed!")
+        return 1  # I handled this, so no need to call defaults!
+
+    # kill focus for the edit box.
+    # Simply increment the value in the text box.
+    def KillFocus(self, msg):
+        self.counter = self.counter + 1
+        if self.edit != None:
+            self.edit.SetWindowText(str(self.counter))
+
+    # Called when the dialog box is terminating...
+    def OnDestroy(self, msg):
+        del self.edit
+        del self.counter
+
+
+# A very simply Property Sheet.
+# We only make a new class for demonstration purposes.
+class TestSheet(dialog.PropertySheet):
+    def __init__(self, title):
+        dialog.PropertySheet.__init__(self, title)
+        self.HookMessage(self.OnActivate, win32con.WM_ACTIVATE)
+
+    def OnActivate(self, msg):
+        pass
+
+
+# A very simply Property Page, which will be "owned" by the above
+# Property Sheet.
+# We create a new class, just so we can hook a control notification.
+class TestPage(dialog.PropertyPage):
+    def OnInitDialog(self):
+        # We use the HookNotify function to allow Python to respond to
+        # Windows WM_NOTIFY messages.
+        # In this case, we are interested in BN_CLICKED messages.
+        self.HookNotify(self.OnNotify, win32con.BN_CLICKED)
+
+    def OnNotify(self, std, extra):
+        print("OnNotify", std, extra)
+
+
+# Some code that actually uses these objects.
+def demo(modal=0):
+    TestDialog(modal)
+
+    # property sheet/page demo
+    ps = win32ui.CreatePropertySheet("Property Sheet/Page Demo")
+    # Create a completely standard PropertyPage.
+    page1 = win32ui.CreatePropertyPage(win32ui.IDD_PROPDEMO1)
+    # Create our custom property page.
+    page2 = TestPage(win32ui.IDD_PROPDEMO2)
+    ps.AddPage(page1)
+    ps.AddPage(page2)
+    if modal:
+        ps.DoModal()
+    else:
+        style = (
+            win32con.WS_SYSMENU
+            | win32con.WS_POPUP
+            | win32con.WS_CAPTION
+            | win32con.DS_MODALFRAME
+            | win32con.WS_VISIBLE
+        )
+        styleex = win32con.WS_EX_DLGMODALFRAME | win32con.WS_EX_PALETTEWINDOW
+        ps.CreateWindow(win32ui.GetMainFrame(), style, styleex)
+
+
+def test(modal=1):
+    # 	dlg=dialog.Dialog(1010)
+    # 	dlg.CreateWindow()
+    # 	dlg.EndDialog(0)
+    # 	del dlg
+    # 	return
+    # property sheet/page demo
+    ps = TestSheet("Property Sheet/Page Demo")
+    page1 = win32ui.CreatePropertyPage(win32ui.IDD_PROPDEMO1)
+    page2 = win32ui.CreatePropertyPage(win32ui.IDD_PROPDEMO2)
+    ps.AddPage(page1)
+    ps.AddPage(page2)
+    del page1
+    del page2
+    if modal:
+        ps.DoModal()
+    else:
+        ps.CreateWindow(win32ui.GetMainFrame())
+    return ps
+
+
+def d():
+    dlg = win32ui.CreateDialog(win32ui.IDD_DEBUGGER)
+    dlg.datalist.append((win32ui.IDC_DBG_RADIOSTACK, "radio"))
+    print("data list is ", dlg.datalist)
+    dlg.data["radio"] = 1
+    dlg.DoModal()
+    print(dlg.data["radio"])
+
+
+if __name__ == "__main__":
+    demo(1)
diff --git a/lib/pythonwin/pywin/Demos/dyndlg.py b/lib/pythonwin/pywin/Demos/dyndlg.py
new file mode 100644
index 00000000..46a4e7fc
--- /dev/null
+++ b/lib/pythonwin/pywin/Demos/dyndlg.py
@@ -0,0 +1,104 @@
+# dyndlg.py
+# contributed by Curt Hagenlocher <chi@earthlink.net>
+
+# Dialog Template params:
+# 	Parameter 0 - Window caption
+# 	Parameter 1 - Bounds (rect tuple)
+# 	Parameter 2 - Window style
+# 	Parameter 3 - Extended style
+# 	Parameter 4 - Font tuple
+# 	Parameter 5 - Menu name
+# 	Parameter 6 - Window class
+# Dialog item params:
+# 	Parameter 0 - Window class
+# 	Parameter 1 - Text
+# 	Parameter 2 - ID
+# 	Parameter 3 - Bounds
+# 	Parameter 4 - Style
+# 	Parameter 5 - Extended style
+# 	Parameter 6 - Extra data
+
+
+import win32con
+import win32ui
+from pywin.mfc import dialog, window
+
+
+def MakeDlgTemplate():
+    style = (
+        win32con.DS_MODALFRAME
+        | win32con.WS_POPUP
+        | win32con.WS_VISIBLE
+        | win32con.WS_CAPTION
+        | win32con.WS_SYSMENU
+        | win32con.DS_SETFONT
+    )
+    cs = win32con.WS_CHILD | win32con.WS_VISIBLE
+    dlg = [
+        ["Select Warehouse", (0, 0, 177, 93), style, None, (8, "MS Sans Serif")],
+    ]
+    dlg.append([130, "Current Warehouse:", -1, (7, 7, 69, 9), cs | win32con.SS_LEFT])
+    dlg.append([130, "ASTORIA", 128, (16, 17, 99, 7), cs | win32con.SS_LEFT])
+    dlg.append([130, "New &Warehouse:", -1, (7, 29, 69, 9), cs | win32con.SS_LEFT])
+    s = win32con.WS_TABSTOP | cs
+    # 	dlg.append([131, None, 130, (5, 40, 110, 48),
+    # 		s | win32con.LBS_NOTIFY | win32con.LBS_SORT | win32con.LBS_NOINTEGRALHEIGHT | win32con.WS_VSCROLL | win32con.WS_BORDER])
+    dlg.append(
+        [
+            "{8E27C92B-1264-101C-8A2F-040224009C02}",
+            None,
+            131,
+            (5, 40, 110, 48),
+            win32con.WS_TABSTOP,
+        ]
+    )
+
+    dlg.append(
+        [128, "OK", win32con.IDOK, (124, 5, 50, 14), s | win32con.BS_DEFPUSHBUTTON]
+    )
+    s = win32con.BS_PUSHBUTTON | s
+    dlg.append([128, "Cancel", win32con.IDCANCEL, (124, 22, 50, 14), s])
+    dlg.append([128, "&Help", 100, (124, 74, 50, 14), s])
+
+    return dlg
+
+
+def test1():
+    win32ui.CreateDialogIndirect(MakeDlgTemplate()).DoModal()
+
+
+def test2():
+    dialog.Dialog(MakeDlgTemplate()).DoModal()
+
+
+def test3():
+    dlg = win32ui.LoadDialogResource(win32ui.IDD_SET_TABSTOPS)
+    dlg[0][0] = "New Dialog Title"
+    dlg[0][1] = (80, 20, 161, 60)
+    dlg[1][1] = "&Confusion:"
+    cs = (
+        win32con.WS_CHILD
+        | win32con.WS_VISIBLE
+        | win32con.WS_TABSTOP
+        | win32con.BS_PUSHBUTTON
+    )
+    dlg.append([128, "&Help", 100, (111, 41, 40, 14), cs])
+    dialog.Dialog(dlg).DoModal()
+
+
+def test4():
+    page1 = dialog.PropertyPage(win32ui.LoadDialogResource(win32ui.IDD_PROPDEMO1))
+    page2 = dialog.PropertyPage(win32ui.LoadDialogResource(win32ui.IDD_PROPDEMO2))
+    ps = dialog.PropertySheet("Property Sheet/Page Demo", None, [page1, page2])
+    ps.DoModal()
+
+
+def testall():
+    test1()
+    test2()
+    test3()
+    test4()
+
+
+if __name__ == "__main__":
+    testall()
diff --git a/lib/pythonwin/pywin/Demos/fontdemo.py b/lib/pythonwin/pywin/Demos/fontdemo.py
new file mode 100644
index 00000000..fc35f4ca
--- /dev/null
+++ b/lib/pythonwin/pywin/Demos/fontdemo.py
@@ -0,0 +1,86 @@
+# Demo of Generic document windows, DC, and Font usage
+# by Dave Brennan (brennan@hal.com)
+
+# usage examples:
+
+# >>> from fontdemo import *
+# >>> d = FontDemo('Hello, Python')
+# >>> f1 = { 'name':'Arial', 'height':36, 'weight':win32con.FW_BOLD}
+# >>> d.SetFont(f1)
+# >>> f2 = {'name':'Courier New', 'height':24, 'italic':1}
+# >>> d.SetFont (f2)
+
+import win32api
+import win32con
+import win32ui
+from pywin.mfc import docview
+
+# font is a dictionary in which the following elements matter:
+# (the best matching font to supplied parameters is returned)
+#   name		string name of the font as known by Windows
+#   size		point size of font in logical units
+#   weight		weight of font (win32con.FW_NORMAL, win32con.FW_BOLD)
+#   italic		boolean; true if set to anything but None
+#   underline	boolean; true if set to anything but None
+
+
+class FontView(docview.ScrollView):
+    def __init__(
+        self, doc, text="Python Rules!", font_spec={"name": "Arial", "height": 42}
+    ):
+        docview.ScrollView.__init__(self, doc)
+        self.font = win32ui.CreateFont(font_spec)
+        self.text = text
+        self.width = self.height = 0
+        # set up message handlers
+        self.HookMessage(self.OnSize, win32con.WM_SIZE)
+
+    def OnAttachedObjectDeath(self):
+        docview.ScrollView.OnAttachedObjectDeath(self)
+        del self.font
+
+    def SetFont(self, new_font):
+        # Change font on the fly
+        self.font = win32ui.CreateFont(new_font)
+        # redraw the entire client window
+        selfInvalidateRect(None)
+
+    def OnSize(self, params):
+        lParam = params[3]
+        self.width = win32api.LOWORD(lParam)
+        self.height = win32api.HIWORD(lParam)
+
+    def OnPrepareDC(self, dc, printinfo):
+        # Set up the DC for forthcoming OnDraw call
+        self.SetScrollSizes(win32con.MM_TEXT, (100, 100))
+        dc.SetTextColor(win32api.RGB(0, 0, 255))
+        dc.SetBkColor(win32api.GetSysColor(win32con.COLOR_WINDOW))
+        dc.SelectObject(self.font)
+        dc.SetTextAlign(win32con.TA_CENTER | win32con.TA_BASELINE)
+
+    def OnDraw(self, dc):
+        if self.width == 0 and self.height == 0:
+            left, top, right, bottom = self.GetClientRect()
+            self.width = right - left
+            self.height = bottom - top
+        x, y = self.width // 2, self.height // 2
+        dc.TextOut(x, y, self.text)
+
+
+def FontDemo():
+    # create doc/view
+    template = docview.DocTemplate(win32ui.IDR_PYTHONTYPE, None, None, FontView)
+    doc = template.OpenDocumentFile(None)
+    doc.SetTitle("Font Demo")
+    # 	print "template is ", template, "obj is", template._obj_
+    template.close()
+
+
+# 	print "closed"
+# 	del template
+
+if __name__ == "__main__":
+    import demoutils
+
+    if demoutils.NeedGoodGUI():
+        FontDemo()
diff --git a/lib/pythonwin/pywin/Demos/guidemo.py b/lib/pythonwin/pywin/Demos/guidemo.py
new file mode 100644
index 00000000..b4d88159
--- /dev/null
+++ b/lib/pythonwin/pywin/Demos/guidemo.py
@@ -0,0 +1,86 @@
+# GUI Demo - just a worker script to invoke all the other demo/test scripts.
+import sys
+
+import __main__
+import regutil
+import win32api
+import win32ui
+
+demos = [  # 	('Font', 'import fontdemo;fontdemo.FontDemo()'),
+    ("Open GL Demo", "import openGLDemo;openGLDemo.test()"),
+    ("Threaded GUI", "import threadedgui;threadedgui.ThreadedDemo()"),
+    ("Tree View Demo", "import hiertest;hiertest.demoboth()"),
+    ("3-Way Splitter Window", "import splittst;splittst.demo()"),
+    ("Custom Toolbars and Tooltips", "import toolbar;toolbar.test()"),
+    ("Progress Bar", "import progressbar;progressbar.demo()"),
+    ("Slider Control", "import sliderdemo;sliderdemo.demo()"),
+    ("Dynamic window creation", "import createwin;createwin.demo()"),
+    ("Various Dialog demos", "import dlgtest;dlgtest.demo()"),
+    ("OCX Control Demo", "from ocx import ocxtest;ocxtest.demo()"),
+    ("OCX Serial Port Demo", "from ocx import ocxserialtest;	ocxserialtest.test()"),
+    (
+        "IE4 Control Demo",
+        'from ocx import webbrowser; webbrowser.Demo("http://www.python.org")',
+    ),
+]
+
+
+def demo():
+    try:
+        # seeif I can locate the demo files.
+        import fontdemo
+    except ImportError:
+        # else put the demos direectory on the path (if not already)
+        try:
+            instPath = regutil.GetRegistryDefaultValue(
+                regutil.BuildDefaultPythonKey() + "\\InstallPath"
+            )
+        except win32api.error:
+            print(
+                "The InstallPath can not be located, and the Demos directory is not on the path"
+            )
+            instPath = "."
+
+        demosDir = win32ui.FullPath(instPath + "\\Demos")
+        for path in sys.path:
+            if win32ui.FullPath(path) == demosDir:
+                break
+        else:
+            sys.path.append(demosDir)
+        import fontdemo
+
+    import sys
+
+    if "/go" in sys.argv:
+        for name, cmd in demos:
+            try:
+                exec(cmd)
+            except:
+                print(
+                    "Demo of %s failed - %s:%s"
+                    % (cmd, sys.exc_info()[0], sys.exc_info()[1])
+                )
+        return
+    # Otherwise allow the user to select the demo to run
+
+    import pywin.dialogs.list
+
+    while 1:
+        rc = pywin.dialogs.list.SelectFromLists("Select a Demo", demos, ["Demo Title"])
+        if rc is None:
+            break
+        title, cmd = demos[rc]
+        try:
+            exec(cmd)
+        except:
+            print(
+                "Demo of %s failed - %s:%s"
+                % (title, sys.exc_info()[0], sys.exc_info()[1])
+            )
+
+
+if __name__ == __main__.__name__:
+    import demoutils
+
+    if demoutils.NeedGoodGUI():
+        demo()
diff --git a/lib/pythonwin/pywin/Demos/hiertest.py b/lib/pythonwin/pywin/Demos/hiertest.py
new file mode 100644
index 00000000..287b71da
--- /dev/null
+++ b/lib/pythonwin/pywin/Demos/hiertest.py
@@ -0,0 +1,138 @@
+import os
+
+import commctrl
+import win32ui
+from pywin.mfc import docview, window
+from pywin.tools import hierlist
+
+
+# directory listbox
+# This has obvious limitations - doesnt track subdirs, etc.  Demonstrates
+# simple use of Python code for querying the tree as needed.
+# Only use strings, and lists of strings (from curdir())
+class DirHierList(hierlist.HierList):
+    def __init__(self, root, listBoxID=win32ui.IDC_LIST1):
+        hierlist.HierList.__init__(self, root, win32ui.IDB_HIERFOLDERS, listBoxID)
+
+    def GetText(self, item):
+        return os.path.basename(item)
+
+    def GetSubList(self, item):
+        if os.path.isdir(item):
+            ret = [os.path.join(item, fname) for fname in os.listdir(item)]
+        else:
+            ret = None
+        return ret
+
+    # if the item is a dir, it is expandable.
+    def IsExpandable(self, item):
+        return os.path.isdir(item)
+
+    def GetSelectedBitmapColumn(self, item):
+        return self.GetBitmapColumn(item) + 6  # Use different color for selection
+
+
+class TestDocument(docview.Document):
+    def __init__(self, template):
+        docview.Document.__init__(self, template)
+        self.hierlist = hierlist.HierListWithItems(
+            HLIFileDir("\\"), win32ui.IDB_HIERFOLDERS, win32ui.AFX_IDW_PANE_FIRST
+        )
+
+
+class HierListView(docview.TreeView):
+    def OnInitialUpdate(self):
+        rc = self._obj_.OnInitialUpdate()
+        self.hierList = self.GetDocument().hierlist
+        self.hierList.HierInit(self.GetParent())
+        self.hierList.SetStyle(
+            commctrl.TVS_HASLINES | commctrl.TVS_LINESATROOT | commctrl.TVS_HASBUTTONS
+        )
+        return rc
+
+
+class HierListFrame(window.MDIChildWnd):
+    pass
+
+
+def GetTestRoot():
+    tree1 = ("Tree 1", [("Item 1", "Item 1 data"), "Item 2", 3])
+    tree2 = ("Tree 2", [("Item 2.1", "Item 2 data"), "Item 2.2", 2.3])
+    return ("Root", [tree1, tree2, "Item 3"])
+
+
+def demoboth():
+    template = docview.DocTemplate(
+        win32ui.IDR_PYTHONTYPE, TestDocument, HierListFrame, HierListView
+    )
+    template.OpenDocumentFile(None).SetTitle("Hierlist demo")
+
+    demomodeless()
+
+
+def demomodeless():
+    testList2 = DirHierList("\\")
+    dlg = hierlist.HierDialog("hier list test", testList2)
+    dlg.CreateWindow()
+
+
+def demodlg():
+    testList2 = DirHierList("\\")
+    dlg = hierlist.HierDialog("hier list test", testList2)
+    dlg.DoModal()
+
+
+def demo():
+    template = docview.DocTemplate(
+        win32ui.IDR_PYTHONTYPE, TestDocument, HierListFrame, HierListView
+    )
+    template.OpenDocumentFile(None).SetTitle("Hierlist demo")
+
+
+#
+# Demo/Test for HierList items.
+#
+# Easy to make a better directory program.
+#
+class HLIFileDir(hierlist.HierListItem):
+    def __init__(self, filename):
+        self.filename = filename
+        hierlist.HierListItem.__init__(self)
+
+    def GetText(self):
+        try:
+            return "%-20s %d bytes" % (
+                os.path.basename(self.filename),
+                os.stat(self.filename)[6],
+            )
+        except os.error as details:
+            return "%-20s - %s" % (self.filename, details[1])
+
+    def IsExpandable(self):
+        return os.path.isdir(self.filename)
+
+    def GetSubList(self):
+        ret = []
+        for newname in os.listdir(self.filename):
+            if newname not in (".", ".."):
+                ret.append(HLIFileDir(os.path.join(self.filename, newname)))
+        return ret
+
+
+def demohli():
+    template = docview.DocTemplate(
+        win32ui.IDR_PYTHONTYPE,
+        TestDocument,
+        hierlist.HierListFrame,
+        hierlist.HierListView,
+    )
+    template.OpenDocumentFile(None).SetTitle("Hierlist demo")
+
+
+if __name__ == "__main__":
+    import demoutils
+
+    if demoutils.HaveGoodGUI():
+        demoboth()
+    else:
+        demodlg()
diff --git a/lib/pythonwin/pywin/Demos/menutest.py b/lib/pythonwin/pywin/Demos/menutest.py
new file mode 100644
index 00000000..d2ba65b6
--- /dev/null
+++ b/lib/pythonwin/pywin/Demos/menutest.py
@@ -0,0 +1,13 @@
+# Run this as a python script, to gray "close" off the edit window system menu.
+import win32con
+from pywin.framework import interact
+
+if __name__ == "__main__":
+    import demoutils
+
+    if demoutils.NeedGoodGUI():
+        win = interact.edit.currentView.GetParent()
+        menu = win.GetSystemMenu()
+        id = menu.GetMenuItemID(6)
+        menu.EnableMenuItem(id, win32con.MF_BYCOMMAND | win32con.MF_GRAYED)
+        print("The interactive window's 'Close' menu item is now disabled.")
diff --git a/lib/pythonwin/pywin/Demos/objdoc.py b/lib/pythonwin/pywin/Demos/objdoc.py
new file mode 100644
index 00000000..fff79253
--- /dev/null
+++ b/lib/pythonwin/pywin/Demos/objdoc.py
@@ -0,0 +1,57 @@
+# This is a sample file, and shows the basic framework for using an "Object" based
+# document, rather than a "filename" based document.
+# This is referenced by the Pythonwin .html documentation.
+
+# In the example below, the OpenObject() method is used instead of OpenDocumentFile,
+# and all the core MFC document open functionality is retained.
+
+import win32ui
+from pywin.mfc import docview
+
+
+class object_template(docview.DocTemplate):
+    def __init__(self):
+        docview.DocTemplate.__init__(self, None, None, None, object_view)
+
+    def OpenObject(self, object):  # Use this instead of OpenDocumentFile.
+        # Look for existing open document
+        for doc in self.GetDocumentList():
+            print("document is ", doc)
+            if doc.object is object:
+                doc.GetFirstView().ActivateFrame()
+                return doc
+        # not found - new one.
+        doc = object_document(self, object)
+        frame = self.CreateNewFrame(doc)
+        doc.OnNewDocument()
+        doc.SetTitle(str(object))
+        self.InitialUpdateFrame(frame, doc)
+        return doc
+
+
+class object_document(docview.Document):
+    def __init__(self, template, object):
+        docview.Document.__init__(self, template)
+        self.object = object
+
+    def OnOpenDocument(self, name):
+        raise RuntimeError("Should not be called if template strings set up correctly")
+        return 0
+
+
+class object_view(docview.EditView):
+    def OnInitialUpdate(self):
+        self.ReplaceSel("Object is %s" % repr(self.GetDocument().object))
+
+
+def demo():
+    t = object_template()
+    d = t.OpenObject(win32ui)
+    return (t, d)
+
+
+if __name__ == "__main__":
+    import demoutils
+
+    if demoutils.NeedGoodGUI():
+        demo()
diff --git a/lib/pythonwin/pywin/Demos/ocx/__init__.py b/lib/pythonwin/pywin/Demos/ocx/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/lib/pythonwin/pywin/Demos/ocx/demoutils.py b/lib/pythonwin/pywin/Demos/ocx/demoutils.py
new file mode 100644
index 00000000..27fa091c
--- /dev/null
+++ b/lib/pythonwin/pywin/Demos/ocx/demoutils.py
@@ -0,0 +1,67 @@
+# Utilities for the demos
+
+import sys
+
+import win32api
+import win32con
+import win32ui
+
+NotScriptMsg = """\
+This demo program is not designed to be run as a Script, but is
+probably used by some other test program.  Please try another demo.
+"""
+
+NeedGUIMsg = """\
+This demo program can only be run from inside of Pythonwin
+
+You must start Pythonwin, and select 'Run' from the toolbar or File menu
+"""
+
+
+NeedAppMsg = """\
+This demo program is a 'Pythonwin Application'.
+
+It is more demo code than an example of Pythonwin's capabilities.
+
+To run it, you must execute the command:
+pythonwin.exe /app "%s"
+
+Would you like to execute it now?
+"""
+
+
+def NotAScript():
+    import win32ui
+
+    win32ui.MessageBox(NotScriptMsg, "Demos")
+
+
+def NeedGoodGUI():
+    from pywin.framework.app import HaveGoodGUI
+
+    rc = HaveGoodGUI()
+    if not rc:
+        win32ui.MessageBox(NeedGUIMsg, "Demos")
+    return rc
+
+
+def NeedApp():
+    import win32ui
+
+    rc = win32ui.MessageBox(NeedAppMsg % sys.argv[0], "Demos", win32con.MB_YESNO)
+    if rc == win32con.IDYES:
+        try:
+            parent = win32ui.GetMainFrame().GetSafeHwnd()
+            win32api.ShellExecute(
+                parent, None, "pythonwin.exe", '/app "%s"' % sys.argv[0], None, 1
+            )
+        except win32api.error as details:
+            win32ui.MessageBox("Error executing command - %s" % (details), "Demos")
+
+
+from pywin.framework.app import HaveGoodGUI
+
+if __name__ == "__main__":
+    from . import demoutils
+
+    demoutils.NotAScript()
diff --git a/lib/pythonwin/pywin/Demos/ocx/flash.py b/lib/pythonwin/pywin/Demos/ocx/flash.py
new file mode 100644
index 00000000..239240ee
--- /dev/null
+++ b/lib/pythonwin/pywin/Demos/ocx/flash.py
@@ -0,0 +1,95 @@
+# By Bradley Schatz
+# simple flash/python application demonstrating bidirectional
+# communicaion between flash and python. Click the sphere to see
+# behavior. Uses Bounce.swf from FlashBounce.zip, available from
+# http://pages.cpsc.ucalgary.ca/~saul/vb_examples/tutorial12/
+
+# Update to the path of the .swf file (note it could be a true URL)
+flash_url = "c:\\bounce.swf"
+
+import sys
+
+import regutil
+import win32api
+import win32con
+import win32ui
+from pywin.mfc import activex, window
+from win32com.client import gencache
+
+FlashModule = gencache.EnsureModule("{D27CDB6B-AE6D-11CF-96B8-444553540000}", 0, 1, 0)
+
+if FlashModule is None:
+    raise ImportError("Flash does not appear to be installed.")
+
+
+class MyFlashComponent(activex.Control, FlashModule.ShockwaveFlash):
+    def __init__(self):
+        activex.Control.__init__(self)
+        FlashModule.ShockwaveFlash.__init__(self)
+        self.x = 50
+        self.y = 50
+        self.angle = 30
+        self.started = 0
+
+    def OnFSCommand(self, command, args):
+        print("FSCommend", command, args)
+        self.x = self.x + 20
+        self.y = self.y + 20
+        self.angle = self.angle + 20
+        if self.x > 200 or self.y > 200:
+            self.x = 0
+            self.y = 0
+        if self.angle > 360:
+            self.angle = 0
+        self.SetVariable("xVal", self.x)
+        self.SetVariable("yVal", self.y)
+        self.SetVariable("angle", self.angle)
+        self.TPlay("_root.mikeBall")
+
+    def OnProgress(self, percentDone):
+        print("PercentDone", percentDone)
+
+    def OnReadyStateChange(self, newState):
+        # 0=Loading, 1=Uninitialized, 2=Loaded, 3=Interactive, 4=Complete
+        print("State", newState)
+
+
+class BrowserFrame(window.MDIChildWnd):
+    def __init__(self, url=None):
+        if url is None:
+            self.url = regutil.GetRegisteredHelpFile("Main Python Documentation")
+        else:
+            self.url = url
+        pass  # Dont call base class doc/view version...
+
+    def Create(self, title, rect=None, parent=None):
+        style = win32con.WS_CHILD | win32con.WS_VISIBLE | win32con.WS_OVERLAPPEDWINDOW
+        self._obj_ = win32ui.CreateMDIChild()
+        self._obj_.AttachObject(self)
+        self._obj_.CreateWindow(None, title, style, rect, parent)
+        rect = self.GetClientRect()
+        rect = (0, 0, rect[2] - rect[0], rect[3] - rect[1])
+        self.ocx = MyFlashComponent()
+        self.ocx.CreateControl(
+            "Flash Player", win32con.WS_VISIBLE | win32con.WS_CHILD, rect, self, 1000
+        )
+        self.ocx.LoadMovie(0, flash_url)
+        self.ocx.Play()
+        self.HookMessage(self.OnSize, win32con.WM_SIZE)
+
+    def OnSize(self, params):
+        rect = self.GetClientRect()
+        rect = (0, 0, rect[2] - rect[0], rect[3] - rect[1])
+        self.ocx.SetWindowPos(0, rect, 0)
+
+
+def Demo():
+    url = None
+    if len(sys.argv) > 1:
+        url = win32api.GetFullPathName(sys.argv[1])
+    f = BrowserFrame(url)
+    f.Create("Flash Player")
+
+
+if __name__ == "__main__":
+    Demo()
diff --git a/lib/pythonwin/pywin/Demos/ocx/msoffice.py b/lib/pythonwin/pywin/Demos/ocx/msoffice.py
new file mode 100644
index 00000000..be24ead8
--- /dev/null
+++ b/lib/pythonwin/pywin/Demos/ocx/msoffice.py
@@ -0,0 +1,152 @@
+# This demo uses some of the Microsoft Office components.
+#
+# It was taken from an MSDN article showing how to embed excel.
+# It is not comlpete yet, but it _does_ show an Excel spreadsheet in a frame!
+#
+
+import regutil
+import win32con
+import win32ui
+import win32uiole
+from pywin.mfc import activex, docview, object, window
+from win32com.client import gencache
+
+# WordModule = gencache.EnsureModule('{00020905-0000-0000-C000-000000000046}', 1033, 8, 0)
+# if WordModule is None:
+# 	raise ImportError, "Microsoft Word version 8 does not appear to be installed."
+
+
+class OleClientItem(object.CmdTarget):
+    def __init__(self, doc):
+        object.CmdTarget.__init__(self, win32uiole.CreateOleClientItem(doc))
+
+    def OnGetItemPosition(self):
+        # For now return a hard-coded rect.
+        return (10, 10, 210, 210)
+
+    def OnActivate(self):
+        # Allow only one inplace activate item per frame
+        view = self.GetActiveView()
+        item = self.GetDocument().GetInPlaceActiveItem(view)
+        if item is not None and item._obj_ != self._obj_:
+            item.Close()
+        self._obj_.OnActivate()
+
+    def OnChange(self, oleNotification, dwParam):
+        self._obj_.OnChange(oleNotification, dwParam)
+        self.GetDocument().UpdateAllViews(None)
+
+    def OnChangeItemPosition(self, rect):
+        # During in-place activation CEmbed_ExcelCntrItem::OnChangeItemPosition
+        #  is called by the server to change the position of the in-place
+        #  window.  Usually, this is a result of the data in the server
+        #  document changing such that the extent has changed or as a result
+        #  of in-place resizing.
+        #
+        # The default here is to call the base class, which will call
+        #  COleClientItem::SetItemRects to move the item
+        #  to the new position.
+        if not self._obj_.OnChangeItemPosition(self, rect):
+            return 0
+
+        # TODO: update any cache you may have of the item's rectangle/extent
+        return 1
+
+
+class OleDocument(object.CmdTarget):
+    def __init__(self, template):
+        object.CmdTarget.__init__(self, win32uiole.CreateOleDocument(template))
+        self.EnableCompoundFile()
+
+
+class ExcelView(docview.ScrollView):
+    def OnInitialUpdate(self):
+        self.HookMessage(self.OnSetFocus, win32con.WM_SETFOCUS)
+        self.HookMessage(self.OnSize, win32con.WM_SIZE)
+
+        self.SetScrollSizes(win32con.MM_TEXT, (100, 100))
+        rc = self._obj_.OnInitialUpdate()
+        self.EmbedExcel()
+        return rc
+
+    def EmbedExcel(self):
+        doc = self.GetDocument()
+        self.clientItem = OleClientItem(doc)
+        self.clientItem.CreateNewItem("Excel.Sheet")
+        self.clientItem.DoVerb(-1, self)
+        doc.UpdateAllViews(None)
+
+    def OnDraw(self, dc):
+        doc = self.GetDocument()
+        pos = doc.GetStartPosition()
+        clientItem, pos = doc.GetNextItem(pos)
+        clientItem.Draw(dc, (10, 10, 210, 210))
+
+    # Special handling of OnSetFocus and OnSize are required for a container
+    #  when an object is being edited in-place.
+    def OnSetFocus(self, msg):
+        item = self.GetDocument().GetInPlaceActiveItem(self)
+        if (
+            item is not None
+            and item.GetItemState() == win32uiole.COleClientItem_activeUIState
+        ):
+            wnd = item.GetInPlaceWindow()
+            if wnd is not None:
+                wnd.SetFocus()
+            return 0  # Dont get the base version called.
+        return 1  # Call the base version.
+
+    def OnSize(self, params):
+        item = self.GetDocument().GetInPlaceActiveItem(self)
+        if item is not None:
+            item.SetItemRects()
+        return 1  # do call the base!
+
+
+class OleTemplate(docview.DocTemplate):
+    def __init__(
+        self, resourceId=None, MakeDocument=None, MakeFrame=None, MakeView=None
+    ):
+        if MakeDocument is None:
+            MakeDocument = OleDocument
+        if MakeView is None:
+            MakeView = ExcelView
+        docview.DocTemplate.__init__(
+            self, resourceId, MakeDocument, MakeFrame, MakeView
+        )
+
+
+class WordFrame(window.MDIChildWnd):
+    def __init__(self, doc=None):
+        self._obj_ = win32ui.CreateMDIChild()
+        self._obj_.AttachObject(self)
+        # Dont call base class doc/view version...
+
+    def Create(self, title, rect=None, parent=None):
+        style = win32con.WS_CHILD | win32con.WS_VISIBLE | win32con.WS_OVERLAPPEDWINDOW
+        self._obj_.CreateWindow(None, title, style, rect, parent)
+
+        rect = self.GetClientRect()
+        rect = (0, 0, rect[2] - rect[0], rect[3] - rect[1])
+        self.ocx = MyWordControl()
+        self.ocx.CreateControl(
+            "Microsoft Word", win32con.WS_VISIBLE | win32con.WS_CHILD, rect, self, 20000
+        )
+
+
+def Demo():
+    import sys
+
+    import win32api
+
+    docName = None
+    if len(sys.argv) > 1:
+        docName = win32api.GetFullPathName(sys.argv[1])
+    OleTemplate().OpenDocumentFile(None)
+
+
+# 	f = WordFrame(docName)
+# 	f.Create("Microsoft Office")
+
+if __name__ == "__main__":
+    Demo()
diff --git a/lib/pythonwin/pywin/Demos/ocx/ocxserialtest.py b/lib/pythonwin/pywin/Demos/ocx/ocxserialtest.py
new file mode 100644
index 00000000..326d312c
--- /dev/null
+++ b/lib/pythonwin/pywin/Demos/ocx/ocxserialtest.py
@@ -0,0 +1,133 @@
+# ocxserialtest.py
+#
+# Sample that uses the mscomm OCX to talk to a serial
+# device.
+
+# Very simple -  queries a modem for ATI responses
+
+import pythoncom
+import win32con
+import win32ui
+import win32uiole
+from pywin.mfc import activex, dialog
+from win32com.client import gencache
+
+SERIAL_SETTINGS = "19200,n,8,1"
+SERIAL_PORT = 2
+
+win32ui.DoWaitCursor(1)
+serialModule = gencache.EnsureModule("{648A5603-2C6E-101B-82B6-000000000014}", 0, 1, 1)
+win32ui.DoWaitCursor(0)
+if serialModule is None:
+    raise ImportError("MS COMM Control does not appear to be installed on the PC")
+
+
+def MakeDlgTemplate():
+    style = (
+        win32con.DS_MODALFRAME
+        | win32con.WS_POPUP
+        | win32con.WS_VISIBLE
+        | win32con.WS_CAPTION
+        | win32con.WS_SYSMENU
+        | win32con.DS_SETFONT
+    )
+    cs = win32con.WS_CHILD | win32con.WS_VISIBLE
+    dlg = [
+        ["Very Basic Terminal", (0, 0, 350, 180), style, None, (8, "MS Sans Serif")],
+    ]
+    s = win32con.WS_TABSTOP | cs
+    dlg.append(
+        [
+            "RICHEDIT",
+            None,
+            132,
+            (5, 5, 340, 170),
+            s
+            | win32con.ES_WANTRETURN
+            | win32con.ES_MULTILINE
+            | win32con.ES_AUTOVSCROLL
+            | win32con.WS_VSCROLL,
+        ]
+    )
+    return dlg
+
+
+####################################
+#
+# Serial Control
+#
+class MySerialControl(activex.Control, serialModule.MSComm):
+    def __init__(self, parent):
+        activex.Control.__init__(self)
+        serialModule.MSComm.__init__(self)
+        self.parent = parent
+
+    def OnComm(self):
+        self.parent.OnComm()
+
+
+class TestSerDialog(dialog.Dialog):
+    def __init__(self, *args):
+        dialog.Dialog.__init__(*(self,) + args)
+        self.olectl = None
+
+    def OnComm(self):
+        event = self.olectl.CommEvent
+        if event == serialModule.OnCommConstants.comEvReceive:
+            self.editwindow.ReplaceSel(self.olectl.Input)
+
+    def OnKey(self, key):
+        if self.olectl:
+            self.olectl.Output = chr(key)
+
+    def OnInitDialog(self):
+        rc = dialog.Dialog.OnInitDialog(self)
+        self.editwindow = self.GetDlgItem(132)
+        self.editwindow.HookAllKeyStrokes(self.OnKey)
+
+        self.olectl = MySerialControl(self)
+        try:
+            self.olectl.CreateControl(
+                "OCX",
+                win32con.WS_TABSTOP | win32con.WS_VISIBLE,
+                (7, 43, 500, 300),
+                self._obj_,
+                131,
+            )
+        except win32ui.error:
+            self.MessageBox("The Serial Control could not be created")
+            self.olectl = None
+            self.EndDialog(win32con.IDCANCEL)
+        if self.olectl:
+            self.olectl.Settings = SERIAL_SETTINGS
+            self.olectl.CommPort = SERIAL_PORT
+            self.olectl.RThreshold = 1
+            try:
+                self.olectl.PortOpen = 1
+            except pythoncom.com_error as details:
+                print(
+                    "Could not open the specified serial port - %s"
+                    % (details.excepinfo[2])
+                )
+                self.EndDialog(win32con.IDCANCEL)
+        return rc
+
+    def OnDestroy(self, msg):
+        if self.olectl:
+            try:
+                self.olectl.PortOpen = 0
+            except pythoncom.com_error as details:
+                print("Error closing port - %s" % (details.excepinfo[2]))
+        return dialog.Dialog.OnDestroy(self, msg)
+
+
+def test():
+    d = TestSerDialog(MakeDlgTemplate())
+    d.DoModal()
+
+
+if __name__ == "__main__":
+    from . import demoutils
+
+    if demoutils.NeedGoodGUI():
+        test()
diff --git a/lib/pythonwin/pywin/Demos/ocx/ocxtest.py b/lib/pythonwin/pywin/Demos/ocx/ocxtest.py
new file mode 100644
index 00000000..4a3d7336
--- /dev/null
+++ b/lib/pythonwin/pywin/Demos/ocx/ocxtest.py
@@ -0,0 +1,250 @@
+# OCX Tester for Pythonwin
+#
+# This file _is_ ready to run.  All that is required is that the OCXs being tested
+# are installed on your machine.
+#
+# The .py files behind the OCXs will be automatically generated and imported.
+
+import glob
+import os
+
+import win32api
+import win32con
+import win32ui
+import win32uiole
+from pywin.mfc import activex, dialog, window
+from win32com.client import gencache
+
+
+def MakeDlgTemplate():
+    style = (
+        win32con.DS_MODALFRAME
+        | win32con.WS_POPUP
+        | win32con.WS_VISIBLE
+        | win32con.WS_CAPTION
+        | win32con.WS_SYSMENU
+        | win32con.DS_SETFONT
+    )
+    cs = win32con.WS_CHILD | win32con.WS_VISIBLE
+    dlg = [
+        ["OCX Demos", (0, 0, 350, 350), style, None, (8, "MS Sans Serif")],
+    ]
+    s = win32con.WS_TABSTOP | cs
+    # 	dlg.append([131, None, 130, (5, 40, 110, 48),
+    # 		s | win32con.LBS_NOTIFY | win32con.LBS_SORT | win32con.LBS_NOINTEGRALHEIGHT | win32con.WS_VSCROLL | win32con.WS_BORDER])
+    # 	dlg.append(["{8E27C92B-1264-101C-8A2F-040224009C02}", None, 131, (5, 40, 110, 48),win32con.WS_TABSTOP])
+
+    dlg.append(
+        [128, "About", win32con.IDOK, (124, 5, 50, 14), s | win32con.BS_DEFPUSHBUTTON]
+    )
+    s = win32con.BS_PUSHBUTTON | s
+    dlg.append([128, "Close", win32con.IDCANCEL, (124, 22, 50, 14), s])
+
+    return dlg
+
+
+####################################
+#
+# Calendar test code
+#
+
+
+def GetTestCalendarClass():
+    global calendarParentModule
+    win32ui.DoWaitCursor(1)
+    calendarParentModule = gencache.EnsureModule(
+        "{8E27C92E-1264-101C-8A2F-040224009C02}", 0, 7, 0
+    )
+    win32ui.DoWaitCursor(0)
+    if calendarParentModule is None:
+        return None
+
+    class TestCalDialog(dialog.Dialog):
+        def OnInitDialog(self):
+            class MyCal(activex.Control, calendarParentModule.Calendar):
+                def OnAfterUpdate(self):
+                    print("OnAfterUpdate")
+
+                def OnClick(self):
+                    print("OnClick")
+
+                def OnDblClick(self):
+                    print("OnDblClick")
+
+                def OnKeyDown(self, KeyCode, Shift):
+                    print("OnKeyDown", KeyCode, Shift)
+
+                def OnKeyPress(self, KeyAscii):
+                    print("OnKeyPress", KeyAscii)
+
+                def OnKeyUp(self, KeyCode, Shift):
+                    print("OnKeyUp", KeyCode, Shift)
+
+                def OnBeforeUpdate(self, Cancel):
+                    print("OnBeforeUpdate", Cancel)
+
+                def OnNewMonth(self):
+                    print("OnNewMonth")
+
+                def OnNewYear(self):
+                    print("OnNewYear")
+
+            rc = dialog.Dialog.OnInitDialog(self)
+            self.olectl = MyCal()
+            try:
+                self.olectl.CreateControl(
+                    "OCX",
+                    win32con.WS_TABSTOP | win32con.WS_VISIBLE,
+                    (7, 43, 500, 300),
+                    self._obj_,
+                    131,
+                )
+            except win32ui.error:
+                self.MessageBox("The Calendar Control could not be created")
+                self.olectl = None
+                self.EndDialog(win32con.IDCANCEL)
+
+            return rc
+
+        def OnOK(self):
+            self.olectl.AboutBox()
+
+    return TestCalDialog
+
+
+####################################
+#
+# Video Control
+#
+def GetTestVideoModule():
+    global videoControlModule, videoControlFileName
+    win32ui.DoWaitCursor(1)
+    videoControlModule = gencache.EnsureModule(
+        "{05589FA0-C356-11CE-BF01-00AA0055595A}", 0, 2, 0
+    )
+    win32ui.DoWaitCursor(0)
+    if videoControlModule is None:
+        return None
+    fnames = glob.glob(os.path.join(win32api.GetWindowsDirectory(), "*.avi"))
+    if not fnames:
+        print("No AVI files available in system directory")
+        return None
+    videoControlFileName = fnames[0]
+    return videoControlModule
+
+
+def GetTestVideoDialogClass():
+    if GetTestVideoModule() is None:
+        return None
+
+    class TestVideoDialog(dialog.Dialog):
+        def OnInitDialog(self):
+            rc = dialog.Dialog.OnInitDialog(self)
+            try:
+                self.olectl = activex.MakeControlInstance(
+                    videoControlModule.ActiveMovie
+                )
+                self.olectl.CreateControl(
+                    "",
+                    win32con.WS_TABSTOP | win32con.WS_VISIBLE,
+                    (7, 43, 500, 300),
+                    self._obj_,
+                    131,
+                )
+            except win32ui.error:
+                self.MessageBox("The Video Control could not be created")
+                self.olectl = None
+                self.EndDialog(win32con.IDCANCEL)
+                return
+
+            self.olectl.FileName = videoControlFileName
+            # 			self.olectl.Run()
+            return rc
+
+        def OnOK(self):
+            self.olectl.AboutBox()
+
+    return TestVideoDialog
+
+
+###############
+#
+# An OCX in an MDI Frame
+#
+class OCXFrame(window.MDIChildWnd):
+    def __init__(self):
+        pass  # Dont call base class doc/view version...
+
+    def Create(self, controlClass, title, rect=None, parent=None):
+        style = win32con.WS_CHILD | win32con.WS_VISIBLE | win32con.WS_OVERLAPPEDWINDOW
+        self._obj_ = win32ui.CreateMDIChild()
+        self._obj_.AttachObject(self)
+        self._obj_.CreateWindow(None, title, style, rect, parent)
+
+        rect = self.GetClientRect()
+        rect = (0, 0, rect[2] - rect[0], rect[3] - rect[1])
+        self.ocx = controlClass()
+        self.ocx.CreateControl(
+            "", win32con.WS_VISIBLE | win32con.WS_CHILD, rect, self, 1000
+        )
+
+
+def MDITest():
+    calendarParentModule = gencache.EnsureModule(
+        "{8E27C92E-1264-101C-8A2F-040224009C02}", 0, 7, 0
+    )
+
+    class MyCal(activex.Control, calendarParentModule.Calendar):
+        def OnAfterUpdate(self):
+            print("OnAfterUpdate")
+
+        def OnClick(self):
+            print("OnClick")
+
+    f = OCXFrame()
+    f.Create(MyCal, "Calendar Test")
+
+
+def test1():
+    klass = GetTestCalendarClass()
+    if klass is None:
+        print(
+            "Can not test the MSAccess Calendar control - it does not appear to be installed"
+        )
+        return
+
+    d = klass(MakeDlgTemplate())
+    d.DoModal()
+
+
+def test2():
+    klass = GetTestVideoDialogClass()
+    if klass is None:
+        print("Can not test the Video OCX - it does not appear to be installed,")
+        print("or no AVI files can be found.")
+        return
+    d = klass(MakeDlgTemplate())
+    d.DoModal()
+    d = None
+
+
+def test3():
+    d = TestCOMMDialog(MakeDlgTemplate())
+    d.DoModal()
+    d = None
+
+
+def testall():
+    test1()
+    test2()
+
+
+def demo():
+    testall()
+
+
+if __name__ == "__main__":
+    from . import demoutils
+
+    if demoutils.NeedGoodGUI():
+        testall()
diff --git a/lib/pythonwin/pywin/Demos/ocx/webbrowser.py b/lib/pythonwin/pywin/Demos/ocx/webbrowser.py
new file mode 100644
index 00000000..cc17445e
--- /dev/null
+++ b/lib/pythonwin/pywin/Demos/ocx/webbrowser.py
@@ -0,0 +1,72 @@
+# This demo uses the IE4 Web Browser control.
+
+# It catches an "OnNavigate" event, and updates the frame title.
+# (event stuff by Neil Hodgson)
+
+import sys
+
+import regutil
+import win32api
+import win32con
+import win32ui
+from pywin.mfc import activex, window
+from win32com.client import gencache
+
+WebBrowserModule = gencache.EnsureModule(
+    "{EAB22AC0-30C1-11CF-A7EB-0000C05BAE0B}", 0, 1, 1
+)
+if WebBrowserModule is None:
+    raise ImportError("IE4 does not appear to be installed.")
+
+
+class MyWebBrowser(activex.Control, WebBrowserModule.WebBrowser):
+    def OnBeforeNavigate2(
+        self, pDisp, URL, Flags, TargetFrameName, PostData, Headers, Cancel
+    ):
+        self.GetParent().OnNavigate(URL)
+        # print "BeforeNavigate2", pDisp, URL, Flags, TargetFrameName, PostData, Headers, Cancel
+
+
+class BrowserFrame(window.MDIChildWnd):
+    def __init__(self, url=None):
+        if url is None:
+            self.url = regutil.GetRegisteredHelpFile("Main Python Documentation")
+            if self.url is None:
+                self.url = "http://www.python.org"
+        else:
+            self.url = url
+        pass  # Dont call base class doc/view version...
+
+    def Create(self, title, rect=None, parent=None):
+        style = win32con.WS_CHILD | win32con.WS_VISIBLE | win32con.WS_OVERLAPPEDWINDOW
+        self._obj_ = win32ui.CreateMDIChild()
+        self._obj_.AttachObject(self)
+        self._obj_.CreateWindow(None, title, style, rect, parent)
+        rect = self.GetClientRect()
+        rect = (0, 0, rect[2] - rect[0], rect[3] - rect[1])
+        self.ocx = MyWebBrowser()
+        self.ocx.CreateControl(
+            "Web Browser", win32con.WS_VISIBLE | win32con.WS_CHILD, rect, self, 1000
+        )
+        self.ocx.Navigate(self.url)
+        self.HookMessage(self.OnSize, win32con.WM_SIZE)
+
+    def OnSize(self, params):
+        rect = self.GetClientRect()
+        rect = (0, 0, rect[2] - rect[0], rect[3] - rect[1])
+        self.ocx.SetWindowPos(0, rect, 0)
+
+    def OnNavigate(self, url):
+        title = "Web Browser - %s" % (url,)
+        self.SetWindowText(title)
+
+
+def Demo(url=None):
+    if url is None and len(sys.argv) > 1:
+        url = win32api.GetFullPathName(sys.argv[1])
+    f = BrowserFrame(url)
+    f.Create("Web Browser")
+
+
+if __name__ == "__main__":
+    Demo()
diff --git a/lib/pythonwin/pywin/Demos/openGLDemo.py b/lib/pythonwin/pywin/Demos/openGLDemo.py
new file mode 100644
index 00000000..9274949d
--- /dev/null
+++ b/lib/pythonwin/pywin/Demos/openGLDemo.py
@@ -0,0 +1,370 @@
+# Ported from the win32 and MFC OpenGL Samples.
+
+import sys
+
+from pywin.mfc import docview
+
+try:
+    from OpenGL.GL import *  # nopycln: import
+    from OpenGL.GLU import *  # nopycln: import
+except ImportError:
+    print("The OpenGL extensions do not appear to be installed.")
+    print("This Pythonwin demo can not run")
+    sys.exit(1)
+
+import timer
+import win32api
+import win32con
+import win32ui
+
+PFD_TYPE_RGBA = 0
+PFD_TYPE_COLORINDEX = 1
+PFD_MAIN_PLANE = 0
+PFD_OVERLAY_PLANE = 1
+PFD_UNDERLAY_PLANE = -1
+PFD_DOUBLEBUFFER = 0x00000001
+PFD_STEREO = 0x00000002
+PFD_DRAW_TO_WINDOW = 0x00000004
+PFD_DRAW_TO_BITMAP = 0x00000008
+PFD_SUPPORT_GDI = 0x00000010
+PFD_SUPPORT_OPENGL = 0x00000020
+PFD_GENERIC_FORMAT = 0x00000040
+PFD_NEED_PALETTE = 0x00000080
+PFD_NEED_SYSTEM_PALETTE = 0x00000100
+PFD_SWAP_EXCHANGE = 0x00000200
+PFD_SWAP_COPY = 0x00000400
+PFD_SWAP_LAYER_BUFFERS = 0x00000800
+PFD_GENERIC_ACCELERATED = 0x00001000
+PFD_DEPTH_DONTCARE = 0x20000000
+PFD_DOUBLEBUFFER_DONTCARE = 0x40000000
+PFD_STEREO_DONTCARE = 0x80000000
+
+
+# threeto8 = [0, 0o111>>1, 0o222>>1, 0o333>>1, 0o444>>1, 0o555>>1, 0o666>>1, 0o377]
+threeto8 = [0, 73 >> 1, 146 >> 1, 219 >> 1, 292 >> 1, 365 >> 1, 438 >> 1, 255]
+twoto8 = [0, 0x55, 0xAA, 0xFF]
+oneto8 = [0, 255]
+
+
+def ComponentFromIndex(i, nbits, shift):
+    # val = (unsigned char) (i >> shift);
+    val = (i >> shift) & 0xF
+    if nbits == 1:
+        val = val & 0x1
+        return oneto8[val]
+    elif nbits == 2:
+        val = val & 0x3
+        return twoto8[val]
+    elif nbits == 3:
+        val = val & 0x7
+        return threeto8[val]
+    else:
+        return 0
+
+
+OpenGLViewParent = docview.ScrollView
+
+
+class OpenGLView(OpenGLViewParent):
+    def PreCreateWindow(self, cc):
+        self.HookMessage(self.OnSize, win32con.WM_SIZE)
+        # An OpenGL window must be created with the following flags and must not
+        # include CS_PARENTDC for the class style. Refer to SetPixelFormat
+        # documentation in the "Comments" section for further information.
+        style = cc[5]
+        style = style | win32con.WS_CLIPSIBLINGS | win32con.WS_CLIPCHILDREN
+        cc = cc[0], cc[1], cc[2], cc[3], cc[4], style, cc[6], cc[7], cc[8]
+        cc = self._obj_.PreCreateWindow(cc)
+        return cc
+
+    def OnSize(self, params):
+        lParam = params[3]
+        cx = win32api.LOWORD(lParam)
+        cy = win32api.HIWORD(lParam)
+        glViewport(0, 0, cx, cy)
+
+        if self.oldrect[2] > cx or self.oldrect[3] > cy:
+            self.RedrawWindow()
+
+        self.OnSizeChange(cx, cy)
+
+        self.oldrect = self.oldrect[0], self.oldrect[1], cx, cy
+
+    def OnInitialUpdate(self):
+        self.SetScaleToFitSize(
+            (100, 100)
+        )  # or SetScrollSizes() - A Pythonwin requirement
+        return self._obj_.OnInitialUpdate()
+
+    # 		return rc
+
+    def OnCreate(self, cs):
+        self.oldrect = self.GetClientRect()
+        self._InitContexts()
+        self.Init()
+
+    def OnDestroy(self, msg):
+        self.Term()
+        self._DestroyContexts()
+        return OpenGLViewParent.OnDestroy(self, msg)
+
+    def OnDraw(self, dc):
+        self.DrawScene()
+
+    def OnEraseBkgnd(self, dc):
+        return 1
+
+    # The OpenGL helpers
+    def _SetupPixelFormat(self):
+        dc = self.dc.GetSafeHdc()
+        pfd = CreatePIXELFORMATDESCRIPTOR()
+        pfd.dwFlags = PFD_DRAW_TO_WINDOW | PFD_SUPPORT_OPENGL | PFD_DOUBLEBUFFER
+        pfd.iPixelType = PFD_TYPE_RGBA
+        pfd.cColorBits = 24
+        pfd.cDepthBits = 32
+        pfd.iLayerType = PFD_MAIN_PLANE
+        pixelformat = ChoosePixelFormat(dc, pfd)
+        SetPixelFormat(dc, pixelformat, pfd)
+        self._CreateRGBPalette()
+
+    def _CreateRGBPalette(self):
+        dc = self.dc.GetSafeHdc()
+        n = GetPixelFormat(dc)
+        pfd = DescribePixelFormat(dc, n)
+        if pfd.dwFlags & PFD_NEED_PALETTE:
+            n = 1 << pfd.cColorBits
+            pal = []
+            for i in range(n):
+                this = (
+                    ComponentFromIndex(i, pfd.cRedBits, pfd.cRedShift),
+                    ComponentFromIndex(i, pfd.cGreenBits, pfd.cGreenShift),
+                    ComponentFromIndex(i, pfd.cBlueBits, pfd.cBlueShift),
+                    0,
+                )
+                pal.append(this)
+            hpal = win32ui.CreatePalette(pal)
+            self.dc.SelectPalette(hpal, 0)
+            self.dc.RealizePalette()
+
+    def _InitContexts(self):
+        self.dc = self.GetDC()
+        self._SetupPixelFormat()
+        hrc = wglCreateContext(self.dc.GetSafeHdc())
+        wglMakeCurrent(self.dc.GetSafeHdc(), hrc)
+
+    def _DestroyContexts(self):
+        hrc = wglGetCurrentContext()
+        wglMakeCurrent(0, 0)
+        if hrc:
+            wglDeleteContext(hrc)
+
+    # The methods to support OpenGL
+    def DrawScene(self):
+        assert 0, "You must override this method"
+
+    def Init(self):
+        assert 0, "You must override this method"
+
+    def OnSizeChange(self, cx, cy):
+        pass
+
+    def Term(self):
+        pass
+
+
+class TestView(OpenGLView):
+    def OnSizeChange(self, right, bottom):
+        glClearColor(0.0, 0.0, 0.0, 1.0)
+        glClearDepth(1.0)
+        glEnable(GL_DEPTH_TEST)
+
+        glMatrixMode(GL_PROJECTION)
+        if bottom:
+            aspect = right / bottom
+        else:
+            aspect = 0  # When window created!
+        glLoadIdentity()
+        gluPerspective(45.0, aspect, 3.0, 7.0)
+        glMatrixMode(GL_MODELVIEW)
+
+        near_plane = 3.0
+        far_plane = 7.0
+        maxObjectSize = 3.0
+        self.radius = near_plane + maxObjectSize / 2.0
+
+    def Init(self):
+        pass
+
+    def DrawScene(self):
+        glClearColor(0.0, 0.0, 0.0, 1.0)
+        glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT)
+
+        glPushMatrix()
+        glTranslatef(0.0, 0.0, -self.radius)
+
+        self._DrawCone()
+
+        self._DrawPyramid()
+
+        glPopMatrix()
+        glFinish()
+
+        SwapBuffers(wglGetCurrentDC())
+
+    def _DrawCone(self):
+        glColor3f(0.0, 1.0, 0.0)
+
+        glPushMatrix()
+        glTranslatef(-1.0, 0.0, 0.0)
+        quadObj = gluNewQuadric()
+        gluQuadricDrawStyle(quadObj, GLU_FILL)
+        gluQuadricNormals(quadObj, GLU_SMOOTH)
+        gluCylinder(quadObj, 1.0, 0.0, 1.0, 20, 10)
+        # 		gluDeleteQuadric(quadObj);
+        glPopMatrix()
+
+    def _DrawPyramid(self):
+        glPushMatrix()
+        glTranslatef(1.0, 0.0, 0.0)
+        glBegin(GL_TRIANGLE_FAN)
+        glColor3f(1.0, 0.0, 0.0)
+        glVertex3f(0.0, 1.0, 0.0)
+        glColor3f(0.0, 1.0, 0.0)
+        glVertex3f(-1.0, 0.0, 0.0)
+        glColor3f(0.0, 0.0, 1.0)
+        glVertex3f(0.0, 0.0, 1.0)
+        glColor3f(0.0, 1.0, 0.0)
+        glVertex3f(1.0, 0.0, 0.0)
+        glEnd()
+        glPopMatrix()
+
+
+class CubeView(OpenGLView):
+    def OnSizeChange(self, right, bottom):
+        glClearColor(0.0, 0.0, 0.0, 1.0)
+        glClearDepth(1.0)
+        glEnable(GL_DEPTH_TEST)
+
+        glMatrixMode(GL_PROJECTION)
+        if bottom:
+            aspect = right / bottom
+        else:
+            aspect = 0  # When window created!
+        glLoadIdentity()
+        gluPerspective(45.0, aspect, 3.0, 7.0)
+        glMatrixMode(GL_MODELVIEW)
+
+        near_plane = 3.0
+        far_plane = 7.0
+        maxObjectSize = 3.0
+        self.radius = near_plane + maxObjectSize / 2.0
+
+    def Init(self):
+        self.busy = 0
+        self.wAngleY = 10.0
+        self.wAngleX = 1.0
+        self.wAngleZ = 5.0
+        self.timerid = timer.set_timer(150, self.OnTimer)
+
+    def OnTimer(self, id, timeVal):
+        self.DrawScene()
+
+    def Term(self):
+        timer.kill_timer(self.timerid)
+
+    def DrawScene(self):
+        if self.busy:
+            return
+        self.busy = 1
+
+        glClearColor(0.0, 0.0, 0.0, 1.0)
+        glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT)
+
+        glPushMatrix()
+
+        glTranslatef(0.0, 0.0, -self.radius)
+        glRotatef(self.wAngleX, 1.0, 0.0, 0.0)
+        glRotatef(self.wAngleY, 0.0, 1.0, 0.0)
+        glRotatef(self.wAngleZ, 0.0, 0.0, 1.0)
+
+        self.wAngleX = self.wAngleX + 1.0
+        self.wAngleY = self.wAngleY + 10.0
+        self.wAngleZ = self.wAngleZ + 5.0
+
+        glBegin(GL_QUAD_STRIP)
+        glColor3f(1.0, 0.0, 1.0)
+        glVertex3f(-0.5, 0.5, 0.5)
+
+        glColor3f(1.0, 0.0, 0.0)
+        glVertex3f(-0.5, -0.5, 0.5)
+
+        glColor3f(1.0, 1.0, 1.0)
+        glVertex3f(0.5, 0.5, 0.5)
+
+        glColor3f(1.0, 1.0, 0.0)
+        glVertex3f(0.5, -0.5, 0.5)
+
+        glColor3f(0.0, 1.0, 1.0)
+        glVertex3f(0.5, 0.5, -0.5)
+
+        glColor3f(0.0, 1.0, 0.0)
+        glVertex3f(0.5, -0.5, -0.5)
+
+        glColor3f(0.0, 0.0, 1.0)
+        glVertex3f(-0.5, 0.5, -0.5)
+
+        glColor3f(0.0, 0.0, 0.0)
+        glVertex3f(-0.5, -0.5, -0.5)
+
+        glColor3f(1.0, 0.0, 1.0)
+        glVertex3f(-0.5, 0.5, 0.5)
+
+        glColor3f(1.0, 0.0, 0.0)
+        glVertex3f(-0.5, -0.5, 0.5)
+
+        glEnd()
+
+        glBegin(GL_QUADS)
+        glColor3f(1.0, 0.0, 1.0)
+        glVertex3f(-0.5, 0.5, 0.5)
+
+        glColor3f(1.0, 1.0, 1.0)
+        glVertex3f(0.5, 0.5, 0.5)
+
+        glColor3f(0.0, 1.0, 1.0)
+        glVertex3f(0.5, 0.5, -0.5)
+
+        glColor3f(0.0, 0.0, 1.0)
+        glVertex3f(-0.5, 0.5, -0.5)
+        glEnd()
+
+        glBegin(GL_QUADS)
+        glColor3f(1.0, 0.0, 0.0)
+        glVertex3f(-0.5, -0.5, 0.5)
+
+        glColor3f(1.0, 1.0, 0.0)
+        glVertex3f(0.5, -0.5, 0.5)
+
+        glColor3f(0.0, 1.0, 0.0)
+        glVertex3f(0.5, -0.5, -0.5)
+
+        glColor3f(0.0, 0.0, 0.0)
+        glVertex3f(-0.5, -0.5, -0.5)
+        glEnd()
+
+        glPopMatrix()
+
+        glFinish()
+        SwapBuffers(wglGetCurrentDC())
+
+        self.busy = 0
+
+
+def test():
+    template = docview.DocTemplate(None, None, None, CubeView)
+    # 	template = docview.DocTemplate(None, None, None, TestView )
+    template.OpenDocumentFile(None)
+
+
+if __name__ == "__main__":
+    test()
diff --git a/lib/pythonwin/pywin/Demos/progressbar.py b/lib/pythonwin/pywin/Demos/progressbar.py
new file mode 100644
index 00000000..81cd7e38
--- /dev/null
+++ b/lib/pythonwin/pywin/Demos/progressbar.py
@@ -0,0 +1,105 @@
+#
+# Progress bar control example
+#
+# 	PyCProgressCtrl encapsulates the MFC CProgressCtrl class.  To use it,
+# 	you:
+#
+# 	- Create the control with win32ui.CreateProgressCtrl()
+# 	- Create the control window with PyCProgressCtrl.CreateWindow()
+# 	- Initialize the range if you want it to be other than (0, 100) using
+# 	  PyCProgressCtrl.SetRange()
+# 	- Either:
+# 	  - Set the step size with PyCProgressCtrl.SetStep(), and
+# 	  - Increment using PyCProgressCtrl.StepIt()
+# 	  or:
+# 	  - Set the amount completed using PyCProgressCtrl.SetPos()
+#
+# Example and progress bar code courtesy of KDL Technologies, Ltd., Hong Kong SAR, China.
+#
+
+import win32con
+import win32ui
+from pywin.mfc import dialog
+
+
+def MakeDlgTemplate():
+    style = (
+        win32con.DS_MODALFRAME
+        | win32con.WS_POPUP
+        | win32con.WS_VISIBLE
+        | win32con.WS_CAPTION
+        | win32con.WS_SYSMENU
+        | win32con.DS_SETFONT
+    )
+    cs = win32con.WS_CHILD | win32con.WS_VISIBLE
+
+    w = 215
+    h = 36
+
+    dlg = [
+        [
+            "Progress bar control example",
+            (0, 0, w, h),
+            style,
+            None,
+            (8, "MS Sans Serif"),
+        ],
+    ]
+
+    s = win32con.WS_TABSTOP | cs
+
+    dlg.append(
+        [
+            128,
+            "Tick",
+            win32con.IDOK,
+            (10, h - 18, 50, 14),
+            s | win32con.BS_DEFPUSHBUTTON,
+        ]
+    )
+
+    dlg.append(
+        [
+            128,
+            "Cancel",
+            win32con.IDCANCEL,
+            (w - 60, h - 18, 50, 14),
+            s | win32con.BS_PUSHBUTTON,
+        ]
+    )
+
+    return dlg
+
+
+class TestDialog(dialog.Dialog):
+    def OnInitDialog(self):
+        rc = dialog.Dialog.OnInitDialog(self)
+        self.pbar = win32ui.CreateProgressCtrl()
+        self.pbar.CreateWindow(
+            win32con.WS_CHILD | win32con.WS_VISIBLE, (10, 10, 310, 24), self, 1001
+        )
+        # self.pbar.SetStep (5)
+        self.progress = 0
+        self.pincr = 5
+        return rc
+
+    def OnOK(self):
+        # NB: StepIt wraps at the end if you increment past the upper limit!
+        # self.pbar.StepIt()
+        self.progress = self.progress + self.pincr
+        if self.progress > 100:
+            self.progress = 100
+        if self.progress <= 100:
+            self.pbar.SetPos(self.progress)
+
+
+def demo(modal=0):
+    d = TestDialog(MakeDlgTemplate())
+    if modal:
+        d.DoModal()
+    else:
+        d.CreateWindow()
+
+
+if __name__ == "__main__":
+    demo(1)
diff --git a/lib/pythonwin/pywin/Demos/sliderdemo.py b/lib/pythonwin/pywin/Demos/sliderdemo.py
new file mode 100644
index 00000000..9fc7b570
--- /dev/null
+++ b/lib/pythonwin/pywin/Demos/sliderdemo.py
@@ -0,0 +1,76 @@
+# sliderdemo.py
+# Demo of the slider control courtesy of Mike Fletcher.
+
+import win32con
+import win32ui
+from pywin.mfc import dialog
+
+
+class MyDialog(dialog.Dialog):
+    """
+    Example using simple controls
+    """
+
+    _dialogstyle = (
+        win32con.WS_MINIMIZEBOX
+        | win32con.WS_DLGFRAME
+        | win32con.DS_MODALFRAME
+        | win32con.WS_POPUP
+        | win32con.WS_VISIBLE
+        | win32con.WS_CAPTION
+        | win32con.WS_SYSMENU
+        | win32con.DS_SETFONT
+    )
+    _buttonstyle = (
+        win32con.BS_PUSHBUTTON
+        | win32con.WS_TABSTOP
+        | win32con.WS_CHILD
+        | win32con.WS_VISIBLE
+    )
+    ### The static template, contains all "normal" dialog items
+    DIALOGTEMPLATE = [
+        # the dialog itself is the first element in the template
+        ["Example slider", (0, 0, 50, 43), _dialogstyle, None, (8, "MS SansSerif")],
+        # rest of elements are the controls within the dialog
+        # standard "Close" button
+        [128, "Close", win32con.IDCANCEL, (0, 30, 50, 13), _buttonstyle],
+    ]
+    ### ID of the control to be created during dialog initialisation
+    IDC_SLIDER = 9500
+
+    def __init__(self):
+        dialog.Dialog.__init__(self, self.DIALOGTEMPLATE)
+
+    def OnInitDialog(self):
+        rc = dialog.Dialog.OnInitDialog(self)
+        # now initialise your controls that you want to create
+        # programmatically, including those which are OLE controls
+        # those created directly by win32ui.Create*
+        # and your "custom controls" which are subclasses/whatever
+        win32ui.EnableControlContainer()
+        self.slider = win32ui.CreateSliderCtrl()
+        self.slider.CreateWindow(
+            win32con.WS_TABSTOP | win32con.WS_VISIBLE,
+            (0, 0, 100, 30),
+            self._obj_,
+            self.IDC_SLIDER,
+        )
+        self.HookMessage(self.OnSliderMove, win32con.WM_HSCROLL)
+        return rc
+
+    def OnSliderMove(self, params):
+        print("Slider moved")
+
+    def OnCancel(self):
+        print("The slider control is at position", self.slider.GetPos())
+        self._obj_.OnCancel()
+
+
+###
+def demo():
+    dia = MyDialog()
+    dia.DoModal()
+
+
+if __name__ == "__main__":
+    demo()
diff --git a/lib/pythonwin/pywin/Demos/splittst.py b/lib/pythonwin/pywin/Demos/splittst.py
new file mode 100644
index 00000000..0114bf09
--- /dev/null
+++ b/lib/pythonwin/pywin/Demos/splittst.py
@@ -0,0 +1,79 @@
+import commctrl
+import fontdemo
+import win32ui
+from pywin.mfc import docview, window
+
+# derive from CMDIChild.  This does much work for us.
+
+
+class SplitterFrame(window.MDIChildWnd):
+    def __init__(self):
+        # call base CreateFrame
+        self.images = None
+        window.MDIChildWnd.__init__(self)
+
+    def OnCreateClient(self, cp, context):
+        splitter = win32ui.CreateSplitter()
+        doc = context.doc
+        frame_rect = self.GetWindowRect()
+        size = ((frame_rect[2] - frame_rect[0]), (frame_rect[3] - frame_rect[1]) // 2)
+        sub_size = (size[0] // 2, size[1])
+        splitter.CreateStatic(self, 2, 1)
+        self.v1 = win32ui.CreateEditView(doc)
+        self.v2 = fontdemo.FontView(doc)
+        # CListControl view
+        self.v3 = win32ui.CreateListView(doc)
+        sub_splitter = win32ui.CreateSplitter()
+        # pass "splitter" so each view knows how to get to the others
+        sub_splitter.CreateStatic(splitter, 1, 2)
+        sub_splitter.CreateView(self.v1, 0, 0, (sub_size))
+        sub_splitter.CreateView(self.v2, 0, 1, (0, 0))  # size ignored.
+        splitter.SetRowInfo(0, size[1], 0)
+        splitter.CreateView(self.v3, 1, 0, (0, 0))  # size ignored.
+        # Setup items in the imagelist
+        self.images = win32ui.CreateImageList(32, 32, 1, 5, 5)
+        self.images.Add(win32ui.GetApp().LoadIcon(win32ui.IDR_MAINFRAME))
+        self.images.Add(win32ui.GetApp().LoadIcon(win32ui.IDR_PYTHONCONTYPE))
+        self.images.Add(win32ui.GetApp().LoadIcon(win32ui.IDR_TEXTTYPE))
+        self.v3.SetImageList(self.images, commctrl.LVSIL_NORMAL)
+        self.v3.InsertItem(0, "Icon 1", 0)
+        self.v3.InsertItem(0, "Icon 2", 1)
+        self.v3.InsertItem(0, "Icon 3", 2)
+        # 		self.v3.Arrange(commctrl.LVA_DEFAULT) Hmmm - win95 aligns left always???
+        return 1
+
+    def OnDestroy(self, msg):
+        window.MDIChildWnd.OnDestroy(self, msg)
+        if self.images:
+            self.images.DeleteImageList()
+            self.images = None
+
+    def InitialUpdateFrame(self, doc, makeVisible):
+        self.v1.ReplaceSel("Hello from Edit Window 1")
+        self.v1.SetModifiedFlag(0)
+
+
+class SampleTemplate(docview.DocTemplate):
+    def __init__(self):
+        docview.DocTemplate.__init__(
+            self, win32ui.IDR_PYTHONTYPE, None, SplitterFrame, None
+        )
+
+    def InitialUpdateFrame(self, frame, doc, makeVisible):
+        # 		print "frame is ", frame, frame._obj_
+        # 		print "doc is ", doc, doc._obj_
+        self._obj_.InitialUpdateFrame(frame, doc, makeVisible)  # call default handler.
+        frame.InitialUpdateFrame(doc, makeVisible)
+
+
+def demo():
+    template = SampleTemplate()
+    doc = template.OpenDocumentFile(None)
+    doc.SetTitle("Splitter Demo")
+
+
+if __name__ == "__main__":
+    import demoutils
+
+    if demoutils.NeedGoodGUI():
+        demo()
diff --git a/lib/pythonwin/pywin/Demos/threadedgui.py b/lib/pythonwin/pywin/Demos/threadedgui.py
new file mode 100644
index 00000000..bbe1369e
--- /dev/null
+++ b/lib/pythonwin/pywin/Demos/threadedgui.py
@@ -0,0 +1,189 @@
+# Demo of using just windows, without documents and views.
+
+# Also demo of a GUI thread, pretty much direct from the MFC C++ sample MTMDI.
+
+import timer
+import win32api
+import win32con
+import win32ui
+from pywin.mfc import docview, thread, window
+from pywin.mfc.thread import WinThread
+
+WM_USER_PREPARE_TO_CLOSE = win32con.WM_USER + 32
+
+# font is a dictionary in which the following elements matter:
+# (the best matching font to supplied parameters is returned)
+#   name		string name of the font as known by Windows
+#   size		point size of font in logical units
+#   weight		weight of font (win32con.FW_NORMAL, win32con.FW_BOLD)
+#   italic		boolean; true if set to anything but None
+#   underline	boolean; true if set to anything but None
+
+
+# This window is a child window of a frame.  It is not the frame window itself.
+class FontWindow(window.Wnd):
+    def __init__(self, text="Python Rules!"):
+        window.Wnd.__init__(self)
+        self.text = text
+        self.index = 0
+        self.incr = 1
+        self.width = self.height = 0
+        self.ChangeAttributes()
+        # set up message handlers
+
+    def Create(self, title, style, rect, parent):
+        classStyle = win32con.CS_HREDRAW | win32con.CS_VREDRAW
+        className = win32ui.RegisterWndClass(
+            classStyle, 0, win32con.COLOR_WINDOW + 1, 0
+        )
+        self._obj_ = win32ui.CreateWnd()
+        self._obj_.AttachObject(self)
+        self._obj_.CreateWindow(
+            className, title, style, rect, parent, win32ui.AFX_IDW_PANE_FIRST
+        )
+        self.HookMessage(self.OnSize, win32con.WM_SIZE)
+        self.HookMessage(self.OnPrepareToClose, WM_USER_PREPARE_TO_CLOSE)
+        self.HookMessage(self.OnDestroy, win32con.WM_DESTROY)
+        self.timerid = timer.set_timer(100, self.OnTimer)
+        self.InvalidateRect()
+
+    def OnDestroy(self, msg):
+        timer.kill_timer(self.timerid)
+
+    def OnTimer(self, id, timeVal):
+        self.index = self.index + self.incr
+        if self.index > len(self.text):
+            self.incr = -1
+            self.index = len(self.text)
+        elif self.index < 0:
+            self.incr = 1
+            self.index = 0
+        self.InvalidateRect()
+
+    def OnPaint(self):
+        # 		print "Paint message from thread", win32api.GetCurrentThreadId()
+        dc, paintStruct = self.BeginPaint()
+        self.OnPrepareDC(dc, None)
+
+        if self.width == 0 and self.height == 0:
+            left, top, right, bottom = self.GetClientRect()
+            self.width = right - left
+            self.height = bottom - top
+        x, y = self.width // 2, self.height // 2
+        dc.TextOut(x, y, self.text[: self.index])
+        self.EndPaint(paintStruct)
+
+    def ChangeAttributes(self):
+        font_spec = {"name": "Arial", "height": 42}
+        self.font = win32ui.CreateFont(font_spec)
+
+    def OnPrepareToClose(self, params):
+        self.DestroyWindow()
+
+    def OnSize(self, params):
+        lParam = params[3]
+        self.width = win32api.LOWORD(lParam)
+        self.height = win32api.HIWORD(lParam)
+
+    def OnPrepareDC(self, dc, printinfo):
+        # Set up the DC for forthcoming OnDraw call
+        dc.SetTextColor(win32api.RGB(0, 0, 255))
+        dc.SetBkColor(win32api.GetSysColor(win32con.COLOR_WINDOW))
+        dc.SelectObject(self.font)
+        dc.SetTextAlign(win32con.TA_CENTER | win32con.TA_BASELINE)
+
+
+class FontFrame(window.MDIChildWnd):
+    def __init__(self):
+        pass  # Dont call base class doc/view version...
+
+    def Create(self, title, rect=None, parent=None):
+        style = win32con.WS_CHILD | win32con.WS_VISIBLE | win32con.WS_OVERLAPPEDWINDOW
+        self._obj_ = win32ui.CreateMDIChild()
+        self._obj_.AttachObject(self)
+
+        self._obj_.CreateWindow(None, title, style, rect, parent)
+        rect = self.GetClientRect()
+        rect = (0, 0, rect[2] - rect[0], rect[3] - rect[1])
+        self.child = FontWindow("Not threaded")
+        self.child.Create(
+            "FontDemo", win32con.WS_CHILD | win32con.WS_VISIBLE, rect, self
+        )
+
+
+class TestThread(WinThread):
+    def __init__(self, parentWindow):
+        self.parentWindow = parentWindow
+        self.child = None
+        WinThread.__init__(self)
+
+    def InitInstance(self):
+        rect = self.parentWindow.GetClientRect()
+        rect = (0, 0, rect[2] - rect[0], rect[3] - rect[1])
+
+        self.child = FontWindow()
+        self.child.Create(
+            "FontDemo", win32con.WS_CHILD | win32con.WS_VISIBLE, rect, self.parentWindow
+        )
+        self.SetMainFrame(self.child)
+        return WinThread.InitInstance(self)
+
+    def ExitInstance(self):
+        return 0
+
+
+class ThreadedFontFrame(window.MDIChildWnd):
+    def __init__(self):
+        pass  # Dont call base class doc/view version...
+        self.thread = None
+
+    def Create(self, title, rect=None, parent=None):
+        style = win32con.WS_CHILD | win32con.WS_VISIBLE | win32con.WS_OVERLAPPEDWINDOW
+        self._obj_ = win32ui.CreateMDIChild()
+        self._obj_.CreateWindow(None, title, style, rect, parent)
+        self._obj_.HookMessage(self.OnDestroy, win32con.WM_DESTROY)
+        self._obj_.HookMessage(self.OnSize, win32con.WM_SIZE)
+
+        self.thread = TestThread(self)
+        self.thread.CreateThread()
+
+    def OnSize(self, msg):
+        pass
+
+    def OnDestroy(self, msg):
+        win32ui.OutputDebugString("OnDestroy\n")
+        if self.thread and self.thread.child:
+            child = self.thread.child
+            child.SendMessage(WM_USER_PREPARE_TO_CLOSE, 0, 0)
+            win32ui.OutputDebugString("Destroyed\n")
+
+
+def Demo():
+    f = FontFrame()
+    f.Create("Font Demo")
+
+
+def ThreadedDemo():
+    rect = win32ui.GetMainFrame().GetMDIClient().GetClientRect()
+    rect = rect[0], int(rect[3] * 3 / 4), int(rect[2] / 4), rect[3]
+    incr = rect[2]
+    for i in range(4):
+        if i == 0:
+            f = FontFrame()
+            title = "Not threaded"
+        else:
+            f = ThreadedFontFrame()
+            title = "Threaded GUI Demo"
+        f.Create(title, rect)
+        rect = rect[0] + incr, rect[1], rect[2] + incr, rect[3]
+    # Givem a chance to start
+    win32api.Sleep(100)
+    win32ui.PumpWaitingMessages()
+
+
+if __name__ == "__main__":
+    import demoutils
+
+    if demoutils.NeedGoodGUI():
+        ThreadedDemo()
+# 		Demo()
diff --git a/lib/pythonwin/pywin/Demos/toolbar.py b/lib/pythonwin/pywin/Demos/toolbar.py
new file mode 100644
index 00000000..e56aefef
--- /dev/null
+++ b/lib/pythonwin/pywin/Demos/toolbar.py
@@ -0,0 +1,106 @@
+# Demo of ToolBars
+
+# Shows the toolbar control.
+# Demos how to make custom tooltips, etc.
+
+import commctrl
+import win32api
+import win32con
+import win32ui
+from pywin.mfc import afxres, docview, window
+
+
+class GenericFrame(window.MDIChildWnd):
+    def OnCreateClient(self, cp, context):
+        # handlers for toolbar buttons
+        self.HookCommand(self.OnPrevious, 401)
+        self.HookCommand(self.OnNext, 402)
+        # Its not necessary for us to hook both of these - the
+        # common controls should fall-back all by themselves.
+        # Indeed, given we hook TTN_NEEDTEXTW, commctrl.TTN_NEEDTEXTA
+        # will not be called.
+        self.HookNotify(self.GetTTText, commctrl.TTN_NEEDTEXT)
+        self.HookNotify(self.GetTTText, commctrl.TTN_NEEDTEXTW)
+
+        # 		parent = win32ui.GetMainFrame()
+        parent = self
+        style = (
+            win32con.WS_CHILD
+            | win32con.WS_VISIBLE
+            | afxres.CBRS_SIZE_DYNAMIC
+            | afxres.CBRS_TOP
+            | afxres.CBRS_TOOLTIPS
+            | afxres.CBRS_FLYBY
+        )
+
+        buttons = (win32ui.ID_APP_ABOUT, win32ui.ID_VIEW_INTERACTIVE)
+        bitmap = win32ui.IDB_BROWSER_HIER
+        tbid = 0xE840
+        self.toolbar = tb = win32ui.CreateToolBar(parent, style, tbid)
+        tb.LoadBitmap(bitmap)
+        tb.SetButtons(buttons)
+
+        tb.EnableDocking(afxres.CBRS_ALIGN_ANY)
+        tb.SetWindowText("Test")
+        parent.EnableDocking(afxres.CBRS_ALIGN_ANY)
+        parent.DockControlBar(tb)
+        parent.LoadBarState("ToolbarTest")
+        window.MDIChildWnd.OnCreateClient(self, cp, context)
+        return 1
+
+    def OnDestroy(self, msg):
+        self.SaveBarState("ToolbarTest")
+
+    def GetTTText(self, std, extra):
+        (hwndFrom, idFrom, code) = std
+        text, hinst, flags = extra
+        if flags & commctrl.TTF_IDISHWND:
+            return  # Not handled
+        if idFrom == win32ui.ID_APP_ABOUT:
+            # our 'extra' return value needs to be the following
+            # entries from a NMTTDISPINFO[W] struct:
+            # (szText, hinst, uFlags).  None means 'don't change
+            # the value'
+            return 0, ("It works!", None, None)
+        return None  # not handled.
+
+    def GetMessageString(self, id):
+        if id == win32ui.ID_APP_ABOUT:
+            return "Dialog Test\nTest"
+        else:
+            return self._obj_.GetMessageString(id)
+
+    def OnSize(self, params):
+        print("OnSize called with ", params)
+
+    def OnNext(self, id, cmd):
+        print("OnNext called")
+
+    def OnPrevious(self, id, cmd):
+        print("OnPrevious called")
+
+
+msg = """\
+This toolbar was dynamically created.\r
+\r
+The first item's tooltips is provided by Python code.\r
+\r
+(Dont close the window with the toolbar in a floating state - it may not re-appear!)\r
+"""
+
+
+def test():
+    template = docview.DocTemplate(
+        win32ui.IDR_PYTHONTYPE, None, GenericFrame, docview.EditView
+    )
+    doc = template.OpenDocumentFile(None)
+    doc.SetTitle("Toolbar Test")
+    view = doc.GetFirstView()
+    view.SetWindowText(msg)
+
+
+if __name__ == "__main__":
+    import demoutils
+
+    if demoutils.NeedGoodGUI():
+        test()
diff --git a/lib/pythonwin/pywin/IDLE.cfg b/lib/pythonwin/pywin/IDLE.cfg
new file mode 100644
index 00000000..b1987b14
--- /dev/null
+++ b/lib/pythonwin/pywin/IDLE.cfg
@@ -0,0 +1,29 @@
+[General]
+# We base this configuration on the default config.
+# You can list "Based On" as many times as you like
+Based On          = default
+
+[Keys]
+# Only list keys different to default.
+# Note you may wish to rebind some of the default
+# Pythonwin keys to "Beep" or "DoNothing"
+
+Alt+L             = LocateSelectedFile
+Ctrl+Q            = AppExit
+
+# Other non-default Pythonwin keys
+Alt+A             = EditSelectAll
+Alt+M             = LocateModule
+
+# Movement
+Ctrl+D            = GotoEndOfFile
+
+# Tabs and other indent features
+Alt+T            = <<toggle-tabs>>
+Ctrl+[            = <<indent-region>>
+Ctrl+]            = <<dedent-region>>
+
+[Keys:Interactive]
+Alt+P             = <<history-previous>>
+Alt+N             = <<history-next>>
+
diff --git a/lib/pythonwin/pywin/__init__.py b/lib/pythonwin/pywin/__init__.py
new file mode 100644
index 00000000..2e44fba5
--- /dev/null
+++ b/lib/pythonwin/pywin/__init__.py
@@ -0,0 +1,10 @@
+# is_platform_unicode is an old variable that was never correctly used and
+# is no longer referenced in pywin32.  It is staying for a few releases incase
+# others are looking at it, but it will go away soon!
+is_platform_unicode = 0
+
+# Ditto default_platform_encoding - not referenced and will die.
+default_platform_encoding = "mbcs"
+
+# This one *is* real and used - but in practice can't be changed.
+default_scintilla_encoding = "utf-8"  # Scintilla _only_ supports this ATM
diff --git a/lib/pythonwin/pywin/default.cfg b/lib/pythonwin/pywin/default.cfg
new file mode 100644
index 00000000..55371f6b
--- /dev/null
+++ b/lib/pythonwin/pywin/default.cfg
@@ -0,0 +1,215 @@
+# The default keyboard etc configuration file for Pythonwin.
+#
+# The format of this file is very similar to a Windows INI file.
+# Sections are identified with [Section] lines, but comments
+# use the standatd Python # character.  Depending on the section,
+# lines may not be in the standard "key=value" format.
+
+# NOTE:  You should not need to modify this file.
+# Simply create a new .CFG file, and add an entry:
+# [General]
+# BasedOn = Default
+#
+# and add your customisations.  Then select your new configuration 
+# from the Pythonwin View/Options/Editor dialog.
+# This way you get to add your own customisations,
+# but still take advantage of changes to the default
+# configuration in new releases.
+
+# See IDLE.cfg for an example extension configuration.
+#
+##########################################################################
+
+[IDLE Extensions]
+
+# The list of IDLE extensions to load.  The extensions
+# AutoIndent, AutoFormat and possibly others are
+# "built-in", so do not need specifying.
+
+FormatParagraph
+CallTips
+
+
+[Keys]
+
+# The list of _default_ key definitions.  
+#  See [Keys:Interactive] and [Keys:Editor] below for further defs.
+
+#Events of the format <<event-name>> 
+# are events defined in IDLE extensions.
+
+Alt+Q             = <<format-paragraph>>
+
+Ctrl+W            = ViewWhitespace
+Ctrl+Shift+8      = ViewWhitespace # The MSVC default key def.
+
+Ctrl+Shift+F      = ViewFixedFont
+
+# Auto-complete, call-tips, etc.
+Alt+/             = <<expand-word>>
+Ctrl+Space   = <<expand-word>>
+(           = <<paren-open>>
+)           = <<paren-close>>
+Up                = <<check-calltip-cancel>>
+Down              = <<check-calltip-cancel>>
+Left              = <<check-calltip-cancel>>
+Right             = <<check-calltip-cancel>>
+.                 = KeyDot
+
+# Debugger - These are the MSVC default keys, for want of a better choice.
+F9                = DbgBreakpointToggle
+F5                = DbgGo
+Shift+F5          = DbgClose
+F11               = DbgStep
+F10               = DbgStepOver
+Shift+F11         = DbgStepOut
+
+Ctrl+F3           = AutoFindNext
+
+
+[Keys:Editor]
+# Key bindings specific to the editor
+F2                = GotoNextBookmark
+Ctrl+F2           = ToggleBookmark
+Ctrl+G            = GotoLine
+
+Alt+I             = ShowInteractiveWindow
+Alt-B             = AddBanner # A sample Event defined in this file.
+
+# Block operations
+Alt+3             = <<comment-region>>
+Shift+Alt+3       = <<uncomment-region>>
+Alt+4             = <<uncomment-region>> # IDLE default.
+Alt+5             = <<tabify-region>>
+Alt+6             = <<untabify-region>>
+
+# Tabs and other indent features
+Back              = <<smart-backspace>>
+Ctrl+T            = <<toggle-tabs>>
+Alt+U             = <<change-indentwidth>>
+Enter             = EnterKey
+Tab               = TabKey
+Shift-Tab         = <<dedent-region>>
+
+# Folding
+Add               = FoldExpand
+Alt+Add           = FoldExpandAll
+Shift+Add         = FoldExpandSecondLevel
+Subtract          = FoldCollapse
+Alt+Subtract      = FoldCollapseAll
+Shift+Subtract    = FoldCollapseSecondLevel
+Multiply          = FoldTopLevel
+
+[Keys:Interactive]
+# Key bindings specific to the interactive window.
+# History for the interactive window
+Ctrl+Up           = <<history-previous>>
+Ctrl+Down         = <<history-next>>
+Enter             = ProcessEnter
+Ctrl+Enter        = ProcessEnter
+Shift+Enter       = ProcessEnter
+Esc               = ProcessEsc
+Alt+I             = WindowBack # Toggle back to previous window.
+Home              = InteractiveHome # A sample Event defined in this file.
+Shift+Home        = InteractiveHomeExtend # A sample Event defined in this file.
+
+# When docked, the Ctrl+Tab and Shift+Ctrl+Tab keys dont work as expected.
+Ctrl+Tab          = MDINext
+Ctrl+Shift+Tab    = MDIPrev
+
+[Extensions]
+# Python event handlers specific to this config file.
+# All functions not starting with an "_" are assumed
+# to be events, and take 2 params:
+# * editor_window is the same object passed to IDLE
+#   extensions.  editor_window.text is a text widget
+#   that conforms to the Tk text widget interface.
+# * event is the event being fired.  Will always be None
+#   in the current implementation.
+
+# Simply by defining these functions, they are available as
+# events.
+# Note that we bind keystrokes to these events in the various
+# [Keys] sections.
+
+# Add a simple file/class/function simple banner
+def AddBanner(editor_window, event):
+
+	text = editor_window.text
+	big_line = "#" * 70
+	banner = "%s\n## \n## \n## \n%s\n" % (big_line, big_line)
+
+	# Insert at the start of the current line.
+	pos = text.index("insert linestart")
+
+	text.undo_block_start() # Allow action to be undone as a single unit.
+	text.insert(pos, banner)
+	text.undo_block_stop()
+
+	# Now set the insert point to the middle of the banner.
+	line, col = [int(s) for s in pos.split(".")]
+	text.mark_set("insert", "%d.1 lineend" % (line+2, ) )
+
+
+# Here is a sample event bound to the "Home" key in the
+# interactive window
+def InteractiveHome(editor_window, event):
+	return _DoInteractiveHome(editor_window.text, 0)
+
+def InteractiveHomeExtend(editor_window, event):
+	return _DoInteractiveHome(editor_window.text, 1)
+
+def _DoInteractiveHome(text, extend):
+	import sys
+	# If Scintilla has an autocomplete window open, then let Scintilla handle it.
+	if text.edit.SCIAutoCActive():
+		return 1
+	of_interest = "insert linestart + %d c" % len(sys.ps1)
+	if not text.compare("insert", "==", of_interest) and \
+	   text.get("insert linestart", of_interest) in [sys.ps1, sys.ps2]: # Not sys.ps? line
+		end = of_interest
+	else:
+		end = "insert linestart"
+
+	if extend: start = "insert"
+	else: start = end
+	text.tag_add("sel", start, end)
+
+# From Niki Spahie
+def AutoFindNext(editor_window, event):
+    "find selected text or word under cursor"
+
+    from pywin.scintilla import find
+    from pywin.scintilla import scintillacon
+
+    try:
+        sci = editor_window.edit
+        word = sci.GetSelText()
+        if word:
+            find.lastSearch.findText = word
+            find.lastSearch.sel = sci.GetSel()
+        else:
+            pos = sci.SendScintilla( scintillacon.SCI_GETCURRENTPOS )
+            start = sci.SendScintilla( scintillacon.SCI_WORDSTARTPOSITION, pos, 1 )
+            end = sci.SendScintilla( scintillacon.SCI_WORDENDPOSITION, pos, 1 )
+            word = sci.GetTextRange( start, end )
+            if word:
+                find.lastSearch.findText = word
+                find.lastSearch.sel = (start,end)
+    except Exception:
+        import traceback
+        traceback.print_exc()
+    find.FindNext()
+
+
+# A couple of generic events.
+def Beep(editor_window, event):
+	editor_window.text.beep()
+
+def DoNothing(editor_window, event):
+	pass
+
+def ContinueEvent(editor_window, event):
+	# Almost an "unbind" - allows Pythonwin/MFC to handle the keystroke
+	return 1
+
diff --git a/lib/pythonwin/pywin/dialogs/__init__.py b/lib/pythonwin/pywin/dialogs/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/lib/pythonwin/pywin/dialogs/ideoptions.py b/lib/pythonwin/pywin/dialogs/ideoptions.py
new file mode 100644
index 00000000..f1bae90d
--- /dev/null
+++ b/lib/pythonwin/pywin/dialogs/ideoptions.py
@@ -0,0 +1,139 @@
+# The property page to define generic IDE options for Pythonwin
+
+import win32con
+import win32ui
+from pywin.framework import interact
+from pywin.mfc import dialog
+
+buttonControlMap = {
+    win32ui.IDC_BUTTON1: win32ui.IDC_EDIT1,
+    win32ui.IDC_BUTTON2: win32ui.IDC_EDIT2,
+    win32ui.IDC_BUTTON3: win32ui.IDC_EDIT3,
+}
+
+
+class OptionsPropPage(dialog.PropertyPage):
+    def __init__(self):
+        dialog.PropertyPage.__init__(self, win32ui.IDD_PP_IDE)
+        self.AddDDX(win32ui.IDC_CHECK1, "bShowAtStartup")
+        self.AddDDX(win32ui.IDC_CHECK2, "bDocking")
+        self.AddDDX(win32ui.IDC_EDIT4, "MRUSize", "i")
+
+    def OnInitDialog(self):
+        edit = self.GetDlgItem(win32ui.IDC_EDIT1)
+        format = eval(
+            win32ui.GetProfileVal(
+                interact.sectionProfile,
+                interact.STYLE_INTERACTIVE_PROMPT,
+                str(interact.formatInput),
+            )
+        )
+        edit.SetDefaultCharFormat(format)
+        edit.SetWindowText("Input Text")
+
+        edit = self.GetDlgItem(win32ui.IDC_EDIT2)
+        format = eval(
+            win32ui.GetProfileVal(
+                interact.sectionProfile,
+                interact.STYLE_INTERACTIVE_OUTPUT,
+                str(interact.formatOutput),
+            )
+        )
+        edit.SetDefaultCharFormat(format)
+        edit.SetWindowText("Output Text")
+
+        edit = self.GetDlgItem(win32ui.IDC_EDIT3)
+        format = eval(
+            win32ui.GetProfileVal(
+                interact.sectionProfile,
+                interact.STYLE_INTERACTIVE_ERROR,
+                str(interact.formatOutputError),
+            )
+        )
+        edit.SetDefaultCharFormat(format)
+        edit.SetWindowText("Error Text")
+
+        self["bShowAtStartup"] = interact.LoadPreference("Show at startup", 1)
+        self["bDocking"] = interact.LoadPreference("Docking", 0)
+        self["MRUSize"] = win32ui.GetProfileVal("Settings", "Recent File List Size", 10)
+
+        # Hook the button clicks.
+        self.HookCommand(self.HandleCharFormatChange, win32ui.IDC_BUTTON1)
+        self.HookCommand(self.HandleCharFormatChange, win32ui.IDC_BUTTON2)
+        self.HookCommand(self.HandleCharFormatChange, win32ui.IDC_BUTTON3)
+
+        # Ensure the spin control remains in range.
+        spinner = self.GetDlgItem(win32ui.IDC_SPIN1)
+        spinner.SetRange(1, 16)
+
+        return dialog.PropertyPage.OnInitDialog(self)
+
+    # Called to save away the new format tuple for the specified item.
+    def HandleCharFormatChange(self, id, code):
+        if code == win32con.BN_CLICKED:
+            editId = buttonControlMap.get(id)
+            assert editId is not None, "Format button has no associated edit control"
+            editControl = self.GetDlgItem(editId)
+            existingFormat = editControl.GetDefaultCharFormat()
+            flags = win32con.CF_SCREENFONTS
+            d = win32ui.CreateFontDialog(existingFormat, flags, None, self)
+            if d.DoModal() == win32con.IDOK:
+                cf = d.GetCharFormat()
+                editControl.SetDefaultCharFormat(cf)
+                self.SetModified(1)
+            return 0  # We handled this fully!
+
+    def OnOK(self):
+        # Handle the edit controls - get all the fonts, put them back into interact, then
+        # get interact to save its stuff!
+        controlAttrs = [
+            (win32ui.IDC_EDIT1, interact.STYLE_INTERACTIVE_PROMPT),
+            (win32ui.IDC_EDIT2, interact.STYLE_INTERACTIVE_OUTPUT),
+            (win32ui.IDC_EDIT3, interact.STYLE_INTERACTIVE_ERROR),
+        ]
+        for id, key in controlAttrs:
+            control = self.GetDlgItem(id)
+            fmt = control.GetDefaultCharFormat()
+            win32ui.WriteProfileVal(interact.sectionProfile, key, str(fmt))
+
+        # Save the other interactive window options.
+        interact.SavePreference("Show at startup", self["bShowAtStartup"])
+        interact.SavePreference("Docking", self["bDocking"])
+
+        # And the other options.
+        win32ui.WriteProfileVal("Settings", "Recent File List Size", self["MRUSize"])
+
+        return 1
+
+    def ChangeFormat(self, fmtAttribute, fmt):
+        dlg = win32ui.CreateFontDialog(fmt)
+        if dlg.DoModal() != win32con.IDOK:
+            return None
+        return dlg.GetCharFormat()
+
+    def OnFormatTitle(self, command, code):
+        fmt = self.GetFormat(interact.formatTitle)
+        if fmt:
+            formatTitle = fmt
+            SaveFontPreferences()
+
+    def OnFormatInput(self, command, code):
+        global formatInput
+        fmt = self.GetFormat(formatInput)
+        if fmt:
+            formatInput = fmt
+            SaveFontPreferences()
+
+    def OnFormatOutput(self, command, code):
+        global formatOutput
+        fmt = self.GetFormat(formatOutput)
+        if fmt:
+            formatOutput = fmt
+            SaveFontPreferences()
+
+    def OnFormatError(self, command, code):
+        global formatOutputError
+        fmt = self.GetFormat(formatOutputError)
+        if fmt:
+            formatOutputError = fmt
+            SaveFontPreferences()
diff --git a/lib/pythonwin/pywin/dialogs/list.py b/lib/pythonwin/pywin/dialogs/list.py
new file mode 100644
index 00000000..b9934ce7
--- /dev/null
+++ b/lib/pythonwin/pywin/dialogs/list.py
@@ -0,0 +1,143 @@
+import commctrl
+import win32api
+import win32con
+import win32ui
+from pywin.mfc import dialog
+
+
+class ListDialog(dialog.Dialog):
+    def __init__(self, title, list):
+        dialog.Dialog.__init__(self, self._maketemplate(title))
+        self.HookMessage(self.on_size, win32con.WM_SIZE)
+        self.HookNotify(self.OnListItemChange, commctrl.LVN_ITEMCHANGED)
+        self.HookCommand(self.OnListClick, win32ui.IDC_LIST1)
+        self.items = list
+
+    def _maketemplate(self, title):
+        style = win32con.WS_DLGFRAME | win32con.WS_SYSMENU | win32con.WS_VISIBLE
+        ls = (
+            win32con.WS_CHILD
+            | win32con.WS_VISIBLE
+            | commctrl.LVS_ALIGNLEFT
+            | commctrl.LVS_REPORT
+        )
+        bs = win32con.WS_CHILD | win32con.WS_VISIBLE
+        return [
+            [title, (0, 0, 200, 200), style, None, (8, "MS Sans Serif")],
+            ["SysListView32", None, win32ui.IDC_LIST1, (0, 0, 200, 200), ls],
+            [128, "OK", win32con.IDOK, (10, 0, 50, 14), bs | win32con.BS_DEFPUSHBUTTON],
+            [128, "Cancel", win32con.IDCANCEL, (0, 0, 50, 14), bs],
+        ]
+
+    def FillList(self):
+        size = self.GetWindowRect()
+        width = size[2] - size[0] - (10)
+        itemDetails = (commctrl.LVCFMT_LEFT, width, "Item", 0)
+        self.itemsControl.InsertColumn(0, itemDetails)
+        index = 0
+        for item in self.items:
+            index = self.itemsControl.InsertItem(index + 1, str(item), 0)
+
+    def OnListClick(self, id, code):
+        if code == commctrl.NM_DBLCLK:
+            self.EndDialog(win32con.IDOK)
+        return 1
+
+    def OnListItemChange(self, std, extra):
+        (hwndFrom, idFrom, code), (
+            itemNotify,
+            sub,
+            newState,
+            oldState,
+            change,
+            point,
+            lparam,
+        ) = (std, extra)
+        oldSel = (oldState & commctrl.LVIS_SELECTED) != 0
+        newSel = (newState & commctrl.LVIS_SELECTED) != 0
+        if oldSel != newSel:
+            try:
+                self.selecteditem = itemNotify
+                self.butOK.EnableWindow(1)
+            except win32ui.error:
+                self.selecteditem = None
+
+    def OnInitDialog(self):
+        rc = dialog.Dialog.OnInitDialog(self)
+        self.itemsControl = self.GetDlgItem(win32ui.IDC_LIST1)
+        self.butOK = self.GetDlgItem(win32con.IDOK)
+        self.butCancel = self.GetDlgItem(win32con.IDCANCEL)
+
+        self.FillList()
+
+        size = self.GetWindowRect()
+        self.LayoutControls(size[2] - size[0], size[3] - size[1])
+        self.butOK.EnableWindow(0)  # wait for first selection
+        return rc
+
+    def LayoutControls(self, w, h):
+        self.itemsControl.MoveWindow((0, 0, w, h - 30))
+        self.butCancel.MoveWindow((10, h - 24, 60, h - 4))
+        self.butOK.MoveWindow((w - 60, h - 24, w - 10, h - 4))
+
+    def on_size(self, params):
+        lparam = params[3]
+        w = win32api.LOWORD(lparam)
+        h = win32api.HIWORD(lparam)
+        self.LayoutControls(w, h)
+
+
+class ListsDialog(ListDialog):
+    def __init__(self, title, list, colHeadings=["Item"]):
+        ListDialog.__init__(self, title, list)
+        self.colHeadings = colHeadings
+
+    def FillList(self):
+        index = 0
+        size = self.GetWindowRect()
+        width = (
+            size[2] - size[0] - (10) - win32api.GetSystemMetrics(win32con.SM_CXVSCROLL)
+        )
+        numCols = len(self.colHeadings)
+
+        for col in self.colHeadings:
+            itemDetails = (commctrl.LVCFMT_LEFT, int(width / numCols), col, 0)
+            self.itemsControl.InsertColumn(index, itemDetails)
+            index = index + 1
+        index = 0
+        for items in self.items:
+            index = self.itemsControl.InsertItem(index + 1, str(items[0]), 0)
+            for itemno in range(1, numCols):
+                item = items[itemno]
+                self.itemsControl.SetItemText(index, itemno, str(item))
+
+
+def SelectFromList(title, lst):
+    dlg = ListDialog(title, lst)
+    if dlg.DoModal() == win32con.IDOK:
+        return dlg.selecteditem
+    else:
+        return None
+
+
+def SelectFromLists(title, lists, headings):
+    dlg = ListsDialog(title, lists, headings)
+    if dlg.DoModal() == win32con.IDOK:
+        return dlg.selecteditem
+    else:
+        return None
+
+
+def test():
+    # 	print SelectFromList('Single list',  [1,2,3])
+    print(
+        SelectFromLists(
+            "Multi-List",
+            [("1", 1, "a"), ("2", 2, "b"), ("3", 3, "c")],
+            ["Col 1", "Col 2"],
+        )
+    )
+
+
+if __name__ == "__main__":
+    test()
diff --git a/lib/pythonwin/pywin/dialogs/login.py b/lib/pythonwin/pywin/dialogs/login.py
new file mode 100644
index 00000000..2a329569
--- /dev/null
+++ b/lib/pythonwin/pywin/dialogs/login.py
@@ -0,0 +1,156 @@
+"""login -- PythonWin user ID and password dialog box
+
+(Adapted from originally distributed with Mark Hammond's PythonWin - 
+this now replaces it!)
+
+login.GetLogin() displays a modal "OK/Cancel" dialog box with input
+fields for a user ID and password. The password field input is masked
+with *'s. GetLogin takes two optional parameters, a window title, and a
+default user ID. If these parameters are omitted, the title defaults to
+"Login", and the user ID is left blank. GetLogin returns a (userid, password)
+tuple. GetLogin can be called from scripts running on the console - i.e. you
+don't need to write a full-blown GUI app to use it.
+
+login.GetPassword() is similar, except there is no username field.
+
+Example:
+import pywin.dialogs.login
+title = "FTP Login"
+def_user = "fred"
+userid, password = pywin.dialogs.login.GetLogin(title, def_user)
+
+Jim Eggleston, 28 August 1996
+Merged with dlgpass and moved to pywin.dialogs by Mark Hammond Jan 1998.
+"""
+
+import win32api
+import win32con
+import win32ui
+from pywin.mfc import dialog
+
+
+def MakeLoginDlgTemplate(title):
+    style = (
+        win32con.DS_MODALFRAME
+        | win32con.WS_POPUP
+        | win32con.WS_VISIBLE
+        | win32con.WS_CAPTION
+        | win32con.WS_SYSMENU
+        | win32con.DS_SETFONT
+    )
+    cs = win32con.WS_CHILD | win32con.WS_VISIBLE
+
+    # Window frame and title
+    dlg = [
+        [title, (0, 0, 184, 40), style, None, (8, "MS Sans Serif")],
+    ]
+
+    # ID label and text box
+    dlg.append([130, "User ID:", -1, (7, 9, 69, 9), cs | win32con.SS_LEFT])
+    s = cs | win32con.WS_TABSTOP | win32con.WS_BORDER
+    dlg.append(["EDIT", None, win32ui.IDC_EDIT1, (50, 7, 60, 12), s])
+
+    # Password label and text box
+    dlg.append([130, "Password:", -1, (7, 22, 69, 9), cs | win32con.SS_LEFT])
+    s = cs | win32con.WS_TABSTOP | win32con.WS_BORDER
+    dlg.append(
+        ["EDIT", None, win32ui.IDC_EDIT2, (50, 20, 60, 12), s | win32con.ES_PASSWORD]
+    )
+
+    # OK/Cancel Buttons
+    s = cs | win32con.WS_TABSTOP
+    dlg.append(
+        [128, "OK", win32con.IDOK, (124, 5, 50, 14), s | win32con.BS_DEFPUSHBUTTON]
+    )
+    s = win32con.BS_PUSHBUTTON | s
+    dlg.append([128, "Cancel", win32con.IDCANCEL, (124, 20, 50, 14), s])
+    return dlg
+
+
+def MakePasswordDlgTemplate(title):
+    style = (
+        win32con.DS_MODALFRAME
+        | win32con.WS_POPUP
+        | win32con.WS_VISIBLE
+        | win32con.WS_CAPTION
+        | win32con.WS_SYSMENU
+        | win32con.DS_SETFONT
+    )
+    cs = win32con.WS_CHILD | win32con.WS_VISIBLE
+    # Window frame and title
+    dlg = [
+        [title, (0, 0, 177, 45), style, None, (8, "MS Sans Serif")],
+    ]
+
+    # Password label and text box
+    dlg.append([130, "Password:", -1, (7, 7, 69, 9), cs | win32con.SS_LEFT])
+    s = cs | win32con.WS_TABSTOP | win32con.WS_BORDER
+    dlg.append(
+        ["EDIT", None, win32ui.IDC_EDIT1, (50, 7, 60, 12), s | win32con.ES_PASSWORD]
+    )
+
+    # OK/Cancel Buttons
+    s = cs | win32con.WS_TABSTOP | win32con.BS_PUSHBUTTON
+    dlg.append(
+        [128, "OK", win32con.IDOK, (124, 5, 50, 14), s | win32con.BS_DEFPUSHBUTTON]
+    )
+    dlg.append([128, "Cancel", win32con.IDCANCEL, (124, 22, 50, 14), s])
+    return dlg
+
+
+class LoginDlg(dialog.Dialog):
+    Cancel = 0
+
+    def __init__(self, title):
+        dialog.Dialog.__init__(self, MakeLoginDlgTemplate(title))
+        self.AddDDX(win32ui.IDC_EDIT1, "userid")
+        self.AddDDX(win32ui.IDC_EDIT2, "password")
+
+
+def GetLogin(title="Login", userid="", password=""):
+    d = LoginDlg(title)
+    d["userid"] = userid
+    d["password"] = password
+    if d.DoModal() != win32con.IDOK:
+        return (None, None)
+    else:
+        return (d["userid"], d["password"])
+
+
+class PasswordDlg(dialog.Dialog):
+    def __init__(self, title):
+        dialog.Dialog.__init__(self, MakePasswordDlgTemplate(title))
+        self.AddDDX(win32ui.IDC_EDIT1, "password")
+
+
+def GetPassword(title="Password", password=""):
+    d = PasswordDlg(title)
+    d["password"] = password
+    if d.DoModal() != win32con.IDOK:
+        return None
+    return d["password"]
+
+
+if __name__ == "__main__":
+    import sys
+
+    title = "Login"
+    def_user = ""
+    if len(sys.argv) > 1:
+        title = sys.argv[1]
+    if len(sys.argv) > 2:
+        def_userid = sys.argv[2]
+    userid, password = GetLogin(title, def_user)
+    if userid == password == None:
+        print("User pressed Cancel")
+    else:
+        print("User ID: ", userid)
+        print("Password:", password)
+        newpassword = GetPassword("Reenter just for fun", password)
+        if newpassword is None:
+            print("User cancelled")
+        else:
+            what = ""
+            if newpassword != password:
+                what = "not "
+            print("The passwords did %smatch" % (what))
diff --git a/lib/pythonwin/pywin/dialogs/status.py b/lib/pythonwin/pywin/dialogs/status.py
new file mode 100644
index 00000000..aef33914
--- /dev/null
+++ b/lib/pythonwin/pywin/dialogs/status.py
@@ -0,0 +1,242 @@
+# No cancel button.
+
+import threading
+import time
+
+import win32api
+import win32con
+import win32ui
+from pywin.mfc import dialog
+from pywin.mfc.thread import WinThread
+
+
+def MakeProgressDlgTemplate(caption, staticText=""):
+    style = (
+        win32con.DS_MODALFRAME
+        | win32con.WS_POPUP
+        | win32con.WS_VISIBLE
+        | win32con.WS_CAPTION
+        | win32con.WS_SYSMENU
+        | win32con.DS_SETFONT
+    )
+    cs = win32con.WS_CHILD | win32con.WS_VISIBLE
+
+    w = 215
+    h = 36  # With button
+    h = 40
+
+    dlg = [
+        [caption, (0, 0, w, h), style, None, (8, "MS Sans Serif")],
+    ]
+
+    s = win32con.WS_TABSTOP | cs
+
+    dlg.append([130, staticText, 1000, (7, 7, w - 7, h - 32), cs | win32con.SS_LEFT])
+
+    #    dlg.append([128,
+    # 		"Cancel",
+    # 		win32con.IDCANCEL,
+    # 		(w - 60, h - 18, 50, 14), s | win32con.BS_PUSHBUTTON])
+
+    return dlg
+
+
+class CStatusProgressDialog(dialog.Dialog):
+    def __init__(self, title, msg="", maxticks=100, tickincr=1):
+        self.initMsg = msg
+        templ = MakeProgressDlgTemplate(title, msg)
+        dialog.Dialog.__init__(self, templ)
+        self.maxticks = maxticks
+        self.tickincr = tickincr
+        self.pbar = None
+
+    def OnInitDialog(self):
+        rc = dialog.Dialog.OnInitDialog(self)
+        self.static = self.GetDlgItem(1000)
+        self.pbar = win32ui.CreateProgressCtrl()
+        self.pbar.CreateWindow(
+            win32con.WS_CHILD | win32con.WS_VISIBLE, (10, 30, 310, 44), self, 1001
+        )
+        self.pbar.SetRange(0, self.maxticks)
+        self.pbar.SetStep(self.tickincr)
+        self.progress = 0
+        self.pincr = 5
+        return rc
+
+    def Close(self):
+        self.EndDialog(0)
+
+    def SetMaxTicks(self, maxticks):
+        if self.pbar is not None:
+            self.pbar.SetRange(0, maxticks)
+
+    def Tick(self):
+        if self.pbar is not None:
+            self.pbar.StepIt()
+
+    def SetTitle(self, text):
+        self.SetWindowText(text)
+
+    def SetText(self, text):
+        self.SetDlgItemText(1000, text)
+
+    def Set(self, pos, max=None):
+        if self.pbar is not None:
+            self.pbar.SetPos(pos)
+            if max is not None:
+                self.pbar.SetRange(0, max)
+
+
+# a progress dialog created in a new thread - especially suitable for
+# console apps with no message loop.
+MYWM_SETTITLE = win32con.WM_USER + 10
+MYWM_SETMSG = win32con.WM_USER + 11
+MYWM_TICK = win32con.WM_USER + 12
+MYWM_SETMAXTICKS = win32con.WM_USER + 13
+MYWM_SET = win32con.WM_USER + 14
+
+
+class CThreadedStatusProcessDialog(CStatusProgressDialog):
+    def __init__(self, title, msg="", maxticks=100, tickincr=1):
+        self.title = title
+        self.msg = msg
+        self.threadid = win32api.GetCurrentThreadId()
+        CStatusProgressDialog.__init__(self, title, msg, maxticks, tickincr)
+
+    def OnInitDialog(self):
+        rc = CStatusProgressDialog.OnInitDialog(self)
+        self.HookMessage(self.OnTitle, MYWM_SETTITLE)
+        self.HookMessage(self.OnMsg, MYWM_SETMSG)
+        self.HookMessage(self.OnTick, MYWM_TICK)
+        self.HookMessage(self.OnMaxTicks, MYWM_SETMAXTICKS)
+        self.HookMessage(self.OnSet, MYWM_SET)
+        return rc
+
+    def _Send(self, msg):
+        try:
+            self.PostMessage(msg)
+        except win32ui.error:
+            # the user closed the window - but this does not cancel the
+            # process - so just ignore it.
+            pass
+
+    def OnTitle(self, msg):
+        CStatusProgressDialog.SetTitle(self, self.title)
+
+    def OnMsg(self, msg):
+        CStatusProgressDialog.SetText(self, self.msg)
+
+    def OnTick(self, msg):
+        CStatusProgressDialog.Tick(self)
+
+    def OnMaxTicks(self, msg):
+        CStatusProgressDialog.SetMaxTicks(self, self.maxticks)
+
+    def OnSet(self, msg):
+        CStatusProgressDialog.Set(self, self.pos, self.max)
+
+    def Close(self):
+        assert self.threadid, "No thread!"
+        win32api.PostThreadMessage(self.threadid, win32con.WM_QUIT, 0, 0)
+
+    def SetMaxTicks(self, maxticks):
+        self.maxticks = maxticks
+        self._Send(MYWM_SETMAXTICKS)
+
+    def SetTitle(self, title):
+        self.title = title
+        self._Send(MYWM_SETTITLE)
+
+    def SetText(self, text):
+        self.msg = text
+        self._Send(MYWM_SETMSG)
+
+    def Tick(self):
+        self._Send(MYWM_TICK)
+
+    def Set(self, pos, max=None):
+        self.pos = pos
+        self.max = max
+        self._Send(MYWM_SET)
+
+
+class ProgressThread(WinThread):
+    def __init__(self, title, msg="", maxticks=100, tickincr=1):
+        self.title = title
+        self.msg = msg
+        self.maxticks = maxticks
+        self.tickincr = tickincr
+        self.dialog = None
+        WinThread.__init__(self)
+        self.createdEvent = threading.Event()
+
+    def InitInstance(self):
+        self.dialog = CThreadedStatusProcessDialog(
+            self.title, self.msg, self.maxticks, self.tickincr
+        )
+        self.dialog.CreateWindow()
+        try:
+            self.dialog.SetForegroundWindow()
+        except win32ui.error:
+            pass
+        self.createdEvent.set()
+        return WinThread.InitInstance(self)
+
+    def ExitInstance(self):
+        return 0
+
+
+def StatusProgressDialog(title, msg="", maxticks=100, parent=None):
+    d = CStatusProgressDialog(title, msg, maxticks)
+    d.CreateWindow(parent)
+    return d
+
+
+def ThreadedStatusProgressDialog(title, msg="", maxticks=100):
+    t = ProgressThread(title, msg, maxticks)
+    t.CreateThread()
+    # Need to run a basic "PumpWaitingMessages" loop just incase we are
+    # running inside Pythonwin.
+    # Basic timeout incase things go terribly wrong.  Ideally we should use
+    # win32event.MsgWaitForMultipleObjects(), but we use a threading module
+    # event - so use a dumb strategy
+    end_time = time.time() + 10
+    while time.time() < end_time:
+        if t.createdEvent.isSet():
+            break
+        win32ui.PumpWaitingMessages()
+        time.sleep(0.1)
+    return t.dialog
+
+
+def demo():
+    d = StatusProgressDialog("A Demo", "Doing something...")
+    import win32api
+
+    for i in range(100):
+        if i == 50:
+            d.SetText("Getting there...")
+        if i == 90:
+            d.SetText("Nearly done...")
+        win32api.Sleep(20)
+        d.Tick()
+    d.Close()
+
+
+def thread_demo():
+    d = ThreadedStatusProgressDialog("A threaded demo", "Doing something")
+    import win32api
+
+    for i in range(100):
+        if i == 50:
+            d.SetText("Getting there...")
+        if i == 90:
+            d.SetText("Nearly done...")
+        win32api.Sleep(20)
+        d.Tick()
+    d.Close()
+
+
+if __name__ == "__main__":
+    thread_demo()
+    # demo()
diff --git a/lib/pythonwin/pywin/docking/DockingBar.py b/lib/pythonwin/pywin/docking/DockingBar.py
new file mode 100644
index 00000000..3e51eb70
--- /dev/null
+++ b/lib/pythonwin/pywin/docking/DockingBar.py
@@ -0,0 +1,679 @@
+# DockingBar.py
+
+# Ported directly (comments and all) from the samples at www.codeguru.com
+
+# WARNING: Use at your own risk, as this interface is highly likely to change.
+# Currently we support only one child per DockingBar.  Later we need to add
+# support for multiple children.
+
+import struct
+
+import win32api
+import win32con
+import win32ui
+from pywin.mfc import afxres, window
+
+clrBtnHilight = win32api.GetSysColor(win32con.COLOR_BTNHILIGHT)
+clrBtnShadow = win32api.GetSysColor(win32con.COLOR_BTNSHADOW)
+
+
+def CenterPoint(rect):
+    width = rect[2] - rect[0]
+    height = rect[3] - rect[1]
+    return rect[0] + width // 2, rect[1] + height // 2
+
+
+def OffsetRect(rect, point):
+    (x, y) = point
+    return rect[0] + x, rect[1] + y, rect[2] + x, rect[3] + y
+
+
+def DeflateRect(rect, point):
+    (x, y) = point
+    return rect[0] + x, rect[1] + y, rect[2] - x, rect[3] - y
+
+
+def PtInRect(rect, pt):
+    return rect[0] <= pt[0] < rect[2] and rect[1] <= pt[1] < rect[3]
+
+
+class DockingBar(window.Wnd):
+    def __init__(self, obj=None):
+        if obj is None:
+            obj = win32ui.CreateControlBar()
+        window.Wnd.__init__(self, obj)
+        self.dialog = None
+        self.nDockBarID = 0
+        self.sizeMin = 32, 32
+        self.sizeHorz = 200, 200
+        self.sizeVert = 200, 200
+        self.sizeFloat = 200, 200
+        self.bTracking = 0
+        self.bInRecalcNC = 0
+        self.cxEdge = 6
+        self.cxBorder = 3
+        self.cxGripper = 20
+        self.brushBkgd = win32ui.CreateBrush()
+        self.brushBkgd.CreateSolidBrush(win32api.GetSysColor(win32con.COLOR_BTNFACE))
+
+        # Support for diagonal resizing
+        self.cyBorder = 3
+        self.cCaptionSize = win32api.GetSystemMetrics(win32con.SM_CYSMCAPTION)
+        self.cMinWidth = win32api.GetSystemMetrics(win32con.SM_CXMIN)
+        self.cMinHeight = win32api.GetSystemMetrics(win32con.SM_CYMIN)
+        self.rectUndock = (0, 0, 0, 0)
+
+    def OnUpdateCmdUI(self, target, bDisableIfNoHndler):
+        return self.UpdateDialogControls(target, bDisableIfNoHndler)
+
+    def CreateWindow(
+        self,
+        parent,
+        childCreator,
+        title,
+        id,
+        style=win32con.WS_CHILD | win32con.WS_VISIBLE | afxres.CBRS_LEFT,
+        childCreatorArgs=(),
+    ):
+        assert not (
+            (style & afxres.CBRS_SIZE_FIXED) and (style & afxres.CBRS_SIZE_DYNAMIC)
+        ), "Invalid style"
+        self.rectClose = self.rectBorder = self.rectGripper = self.rectTracker = (
+            0,
+            0,
+            0,
+            0,
+        )
+
+        # save the style
+        self._obj_.dwStyle = style & afxres.CBRS_ALL
+
+        cursor = win32api.LoadCursor(0, win32con.IDC_ARROW)
+        wndClass = win32ui.RegisterWndClass(
+            win32con.CS_DBLCLKS, cursor, self.brushBkgd.GetSafeHandle(), 0
+        )
+
+        self._obj_.CreateWindow(wndClass, title, style, (0, 0, 0, 0), parent, id)
+
+        # Create the child dialog
+        self.dialog = childCreator(*(self,) + childCreatorArgs)
+
+        # use the dialog dimensions as default base dimensions
+        assert self.dialog.IsWindow(), (
+            "The childCreator function %s did not create a window!" % childCreator
+        )
+        rect = self.dialog.GetWindowRect()
+        self.sizeHorz = self.sizeVert = self.sizeFloat = (
+            rect[2] - rect[0],
+            rect[3] - rect[1],
+        )
+
+        self.sizeHorz = self.sizeHorz[0], self.sizeHorz[1] + self.cxEdge + self.cxBorder
+        self.sizeVert = self.sizeVert[0] + self.cxEdge + self.cxBorder, self.sizeVert[1]
+        self.HookMessages()
+
+    def CalcFixedLayout(self, bStretch, bHorz):
+        rectTop = self.dockSite.GetControlBar(
+            afxres.AFX_IDW_DOCKBAR_TOP
+        ).GetWindowRect()
+        rectLeft = self.dockSite.GetControlBar(
+            afxres.AFX_IDW_DOCKBAR_LEFT
+        ).GetWindowRect()
+        if bStretch:
+            nHorzDockBarWidth = 32767
+            nVertDockBarHeight = 32767
+        else:
+            nHorzDockBarWidth = rectTop[2] - rectTop[0] + 4
+            nVertDockBarHeight = rectLeft[3] - rectLeft[1] + 4
+
+        if self.IsFloating():
+            return self.sizeFloat
+        if bHorz:
+            return nHorzDockBarWidth, self.sizeHorz[1]
+        return self.sizeVert[0], nVertDockBarHeight
+
+    def CalcDynamicLayout(self, length, mode):
+        # Support for diagonal sizing.
+        if self.IsFloating():
+            self.GetParent().GetParent().ModifyStyle(win32ui.MFS_4THICKFRAME, 0)
+        if mode & (win32ui.LM_HORZDOCK | win32ui.LM_VERTDOCK):
+            flags = (
+                win32con.SWP_NOSIZE
+                | win32con.SWP_NOMOVE
+                | win32con.SWP_NOZORDER
+                | win32con.SWP_NOACTIVATE
+                | win32con.SWP_FRAMECHANGED
+            )
+            self.SetWindowPos(
+                0,
+                (
+                    0,
+                    0,
+                    0,
+                    0,
+                ),
+                flags,
+            )
+            self.dockSite.RecalcLayout()
+            return self._obj_.CalcDynamicLayout(length, mode)
+
+        if mode & win32ui.LM_MRUWIDTH:
+            return self.sizeFloat
+        if mode & win32ui.LM_COMMIT:
+            self.sizeFloat = length, self.sizeFloat[1]
+            return self.sizeFloat
+        # More diagonal sizing.
+        if self.IsFloating():
+            dc = self.dockContext
+            pt = win32api.GetCursorPos()
+            windowRect = self.GetParent().GetParent().GetWindowRect()
+
+            hittest = dc.nHitTest
+            if hittest == win32con.HTTOPLEFT:
+                cx = max(windowRect[2] - pt[0], self.cMinWidth) - self.cxBorder
+                cy = max(windowRect[3] - self.cCaptionSize - pt[1], self.cMinHeight) - 1
+                self.sizeFloat = cx, cy
+
+                top = (
+                    min(pt[1], windowRect[3] - self.cCaptionSize - self.cMinHeight)
+                    - self.cyBorder
+                )
+                left = min(pt[0], windowRect[2] - self.cMinWidth) - 1
+                dc.rectFrameDragHorz = (
+                    left,
+                    top,
+                    dc.rectFrameDragHorz[2],
+                    dc.rectFrameDragHorz[3],
+                )
+                return self.sizeFloat
+            if hittest == win32con.HTTOPRIGHT:
+                cx = max(pt[0] - windowRect[0], self.cMinWidth)
+                cy = max(windowRect[3] - self.cCaptionSize - pt[1], self.cMinHeight) - 1
+                self.sizeFloat = cx, cy
+
+                top = (
+                    min(pt[1], windowRect[3] - self.cCaptionSize - self.cMinHeight)
+                    - self.cyBorder
+                )
+                dc.rectFrameDragHorz = (
+                    dc.rectFrameDragHorz[0],
+                    top,
+                    dc.rectFrameDragHorz[2],
+                    dc.rectFrameDragHorz[3],
+                )
+                return self.sizeFloat
+
+            if hittest == win32con.HTBOTTOMLEFT:
+                cx = max(windowRect[2] - pt[0], self.cMinWidth) - self.cxBorder
+                cy = max(pt[1] - windowRect[1] - self.cCaptionSize, self.cMinHeight)
+                self.sizeFloat = cx, cy
+
+                left = min(pt[0], windowRect[2] - self.cMinWidth) - 1
+                dc.rectFrameDragHorz = (
+                    left,
+                    dc.rectFrameDragHorz[1],
+                    dc.rectFrameDragHorz[2],
+                    dc.rectFrameDragHorz[3],
+                )
+                return self.sizeFloat
+
+            if hittest == win32con.HTBOTTOMRIGHT:
+                cx = max(pt[0] - windowRect[0], self.cMinWidth)
+                cy = max(pt[1] - windowRect[1] - self.cCaptionSize, self.cMinHeight)
+                self.sizeFloat = cx, cy
+                return self.sizeFloat
+
+        if mode & win32ui.LM_LENGTHY:
+            self.sizeFloat = self.sizeFloat[0], max(self.sizeMin[1], length)
+            return self.sizeFloat
+        else:
+            return max(self.sizeMin[0], length), self.sizeFloat[1]
+
+    def OnWindowPosChanged(self, msg):
+        if self.GetSafeHwnd() == 0 or self.dialog is None:
+            return 0
+        lparam = msg[3]
+        """ LPARAM used with WM_WINDOWPOSCHANGED:
+			typedef struct {
+				HWND hwnd;
+				HWND hwndInsertAfter;
+				int x;
+				int y;
+				int cx;
+				int cy;
+				UINT flags;} WINDOWPOS;
+		"""
+        format = "PPiiiii"
+        bytes = win32ui.GetBytes(lparam, struct.calcsize(format))
+        hwnd, hwndAfter, x, y, cx, cy, flags = struct.unpack(format, bytes)
+
+        if self.bInRecalcNC:
+            rc = self.GetClientRect()
+            self.dialog.MoveWindow(rc)
+            return 0
+        # Find on which side are we docked
+        nDockBarID = self.GetParent().GetDlgCtrlID()
+        # Return if dropped at same location
+        # no docking side change and no size change
+        if (
+            (nDockBarID == self.nDockBarID)
+            and (flags & win32con.SWP_NOSIZE)
+            and (
+                (self._obj_.dwStyle & afxres.CBRS_BORDER_ANY) != afxres.CBRS_BORDER_ANY
+            )
+        ):
+            return
+        self.nDockBarID = nDockBarID
+
+        # Force recalc the non-client area
+        self.bInRecalcNC = 1
+        try:
+            swpflags = (
+                win32con.SWP_NOSIZE
+                | win32con.SWP_NOMOVE
+                | win32con.SWP_NOZORDER
+                | win32con.SWP_FRAMECHANGED
+            )
+            self.SetWindowPos(0, (0, 0, 0, 0), swpflags)
+        finally:
+            self.bInRecalcNC = 0
+        return 0
+
+    # This is a virtual and not a message hook.
+    def OnSetCursor(self, window, nHitTest, wMouseMsg):
+        if nHitTest != win32con.HTSIZE or self.bTracking:
+            return self._obj_.OnSetCursor(window, nHitTest, wMouseMsg)
+
+        if self.IsHorz():
+            win32api.SetCursor(win32api.LoadCursor(0, win32con.IDC_SIZENS))
+        else:
+            win32api.SetCursor(win32api.LoadCursor(0, win32con.IDC_SIZEWE))
+        return 1
+
+    # Mouse Handling
+    def OnLButtonUp(self, msg):
+        if not self.bTracking:
+            return 1  # pass it on.
+        self.StopTracking(1)
+        return 0  # Dont pass on
+
+    def OnLButtonDown(self, msg):
+        # UINT nFlags, CPoint point)
+        # only start dragging if clicked in "void" space
+        if self.dockBar is not None:
+            # start the drag
+            pt = msg[5]
+            pt = self.ClientToScreen(pt)
+            self.dockContext.StartDrag(pt)
+            return 0
+        return 1
+
+    def OnNcLButtonDown(self, msg):
+        if self.bTracking:
+            return 0
+        nHitTest = wparam = msg[2]
+        pt = msg[5]
+
+        if nHitTest == win32con.HTSYSMENU and not self.IsFloating():
+            self.GetDockingFrame().ShowControlBar(self, 0, 0)
+        elif nHitTest == win32con.HTMINBUTTON and not self.IsFloating():
+            self.dockContext.ToggleDocking()
+        elif (
+            nHitTest == win32con.HTCAPTION
+            and not self.IsFloating()
+            and self.dockBar is not None
+        ):
+            self.dockContext.StartDrag(pt)
+        elif nHitTest == win32con.HTSIZE and not self.IsFloating():
+            self.StartTracking()
+        else:
+            return 1
+        return 0
+
+    def OnLButtonDblClk(self, msg):
+        # only toggle docking if clicked in "void" space
+        if self.dockBar is not None:
+            # toggle docking
+            self.dockContext.ToggleDocking()
+            return 0
+        return 1
+
+    def OnNcLButtonDblClk(self, msg):
+        nHitTest = wparam = msg[2]
+        # UINT nHitTest, CPoint point)
+        if self.dockBar is not None and nHitTest == win32con.HTCAPTION:
+            # toggle docking
+            self.dockContext.ToggleDocking()
+            return 0
+        return 1
+
+    def OnMouseMove(self, msg):
+        flags = wparam = msg[2]
+        lparam = msg[3]
+        if self.IsFloating() or not self.bTracking:
+            return 1
+
+        # Convert unsigned 16 bit to signed 32 bit.
+        x = win32api.LOWORD(lparam)
+        if x & 32768:
+            x = x | -65536
+        y = win32api.HIWORD(lparam)
+        if y & 32768:
+            y = y | -65536
+        pt = x, y
+        cpt = CenterPoint(self.rectTracker)
+        pt = self.ClientToWnd(pt)
+        if self.IsHorz():
+            if cpt[1] != pt[1]:
+                self.OnInvertTracker(self.rectTracker)
+                self.rectTracker = OffsetRect(self.rectTracker, (0, pt[1] - cpt[1]))
+                self.OnInvertTracker(self.rectTracker)
+        else:
+            if cpt[0] != pt[0]:
+                self.OnInvertTracker(self.rectTracker)
+                self.rectTracker = OffsetRect(self.rectTracker, (pt[0] - cpt[0], 0))
+                self.OnInvertTracker(self.rectTracker)
+
+        return 0  # Dont pass it on.
+
+    # 	def OnBarStyleChange(self, old, new):
+
+    def OnNcCalcSize(self, bCalcValid, size_info):
+        (rc0, rc1, rc2, pos) = size_info
+        self.rectBorder = self.GetWindowRect()
+        self.rectBorder = OffsetRect(
+            self.rectBorder, (-self.rectBorder[0], -self.rectBorder[1])
+        )
+
+        dwBorderStyle = self._obj_.dwStyle | afxres.CBRS_BORDER_ANY
+
+        if self.nDockBarID == afxres.AFX_IDW_DOCKBAR_TOP:
+            dwBorderStyle = dwBorderStyle & ~afxres.CBRS_BORDER_BOTTOM
+            rc0.left = rc0.left + self.cxGripper
+            rc0.bottom = rc0.bottom - self.cxEdge
+            rc0.top = rc0.top + self.cxBorder
+            rc0.right = rc0.right - self.cxBorder
+            self.rectBorder = (
+                self.rectBorder[0],
+                self.rectBorder[3] - self.cxEdge,
+                self.rectBorder[2],
+                self.rectBorder[3],
+            )
+        elif self.nDockBarID == afxres.AFX_IDW_DOCKBAR_BOTTOM:
+            dwBorderStyle = dwBorderStyle & ~afxres.CBRS_BORDER_TOP
+            rc0.left = rc0.left + self.cxGripper
+            rc0.top = rc0.top + self.cxEdge
+            rc0.bottom = rc0.bottom - self.cxBorder
+            rc0.right = rc0.right - self.cxBorder
+            self.rectBorder = (
+                self.rectBorder[0],
+                self.rectBorder[1],
+                self.rectBorder[2],
+                self.rectBorder[1] + self.cxEdge,
+            )
+        elif self.nDockBarID == afxres.AFX_IDW_DOCKBAR_LEFT:
+            dwBorderStyle = dwBorderStyle & ~afxres.CBRS_BORDER_RIGHT
+            rc0.right = rc0.right - self.cxEdge
+            rc0.left = rc0.left + self.cxBorder
+            rc0.bottom = rc0.bottom - self.cxBorder
+            rc0.top = rc0.top + self.cxGripper
+            self.rectBorder = (
+                self.rectBorder[2] - self.cxEdge,
+                self.rectBorder[1],
+                self.rectBorder[2],
+                self.rectBorder[3],
+            )
+        elif self.nDockBarID == afxres.AFX_IDW_DOCKBAR_RIGHT:
+            dwBorderStyle = dwBorderStyle & ~afxres.CBRS_BORDER_LEFT
+            rc0.left = rc0.left + self.cxEdge
+            rc0.right = rc0.right - self.cxBorder
+            rc0.bottom = rc0.bottom - self.cxBorder
+            rc0.top = rc0.top + self.cxGripper
+            self.rectBorder = (
+                self.rectBorder[0],
+                self.rectBorder[1],
+                self.rectBorder[0] + self.cxEdge,
+                self.rectBorder[3],
+            )
+        else:
+            self.rectBorder = 0, 0, 0, 0
+
+        self.SetBarStyle(dwBorderStyle)
+        return 0
+
+    def OnNcPaint(self, msg):
+        self.EraseNonClient()
+        dc = self.GetWindowDC()
+        ctl = win32api.GetSysColor(win32con.COLOR_BTNHIGHLIGHT)
+        cbr = win32api.GetSysColor(win32con.COLOR_BTNSHADOW)
+        dc.Draw3dRect(self.rectBorder, ctl, cbr)
+
+        self.DrawGripper(dc)
+
+        rect = self.GetClientRect()
+        self.InvalidateRect(rect, 1)
+        return 0
+
+    def OnNcHitTest(self, pt):  # A virtual, not a hooked message.
+        if self.IsFloating():
+            return 1
+
+        ptOrig = pt
+        rect = self.GetWindowRect()
+        pt = pt[0] - rect[0], pt[1] - rect[1]
+
+        if PtInRect(self.rectClose, pt):
+            return win32con.HTSYSMENU
+        elif PtInRect(self.rectUndock, pt):
+            return win32con.HTMINBUTTON
+        elif PtInRect(self.rectGripper, pt):
+            return win32con.HTCAPTION
+        elif PtInRect(self.rectBorder, pt):
+            return win32con.HTSIZE
+        else:
+            return self._obj_.OnNcHitTest(ptOrig)
+
+    def StartTracking(self):
+        self.SetCapture()
+
+        # make sure no updates are pending
+        self.RedrawWindow(None, None, win32con.RDW_ALLCHILDREN | win32con.RDW_UPDATENOW)
+        self.dockSite.LockWindowUpdate()
+
+        self.ptOld = CenterPoint(self.rectBorder)
+        self.bTracking = 1
+
+        self.rectTracker = self.rectBorder
+        if not self.IsHorz():
+            l, t, r, b = self.rectTracker
+            b = b - 4
+            self.rectTracker = l, t, r, b
+
+        self.OnInvertTracker(self.rectTracker)
+
+    def OnCaptureChanged(self, msg):
+        hwnd = lparam = msg[3]
+        if self.bTracking and hwnd != self.GetSafeHwnd():
+            self.StopTracking(0)  # cancel tracking
+        return 1
+
+    def StopTracking(self, bAccept):
+        self.OnInvertTracker(self.rectTracker)
+        self.dockSite.UnlockWindowUpdate()
+        self.bTracking = 0
+        self.ReleaseCapture()
+        if not bAccept:
+            return
+
+        rcc = self.dockSite.GetWindowRect()
+        if self.IsHorz():
+            newsize = self.sizeHorz[1]
+            maxsize = newsize + (rcc[3] - rcc[1])
+            minsize = self.sizeMin[1]
+        else:
+            newsize = self.sizeVert[0]
+            maxsize = newsize + (rcc[2] - rcc[0])
+            minsize = self.sizeMin[0]
+
+        pt = CenterPoint(self.rectTracker)
+        if self.nDockBarID == afxres.AFX_IDW_DOCKBAR_TOP:
+            newsize = newsize + (pt[1] - self.ptOld[1])
+        elif self.nDockBarID == afxres.AFX_IDW_DOCKBAR_BOTTOM:
+            newsize = newsize + (-pt[1] + self.ptOld[1])
+        elif self.nDockBarID == afxres.AFX_IDW_DOCKBAR_LEFT:
+            newsize = newsize + (pt[0] - self.ptOld[0])
+        elif self.nDockBarID == afxres.AFX_IDW_DOCKBAR_RIGHT:
+            newsize = newsize + (-pt[0] + self.ptOld[0])
+        newsize = max(minsize, min(maxsize, newsize))
+        if self.IsHorz():
+            self.sizeHorz = self.sizeHorz[0], newsize
+        else:
+            self.sizeVert = newsize, self.sizeVert[1]
+        self.dockSite.RecalcLayout()
+        return 0
+
+    def OnInvertTracker(self, rect):
+        assert rect[2] - rect[0] > 0 and rect[3] - rect[1] > 0, "rect is empty"
+        assert self.bTracking
+        rcc = self.GetWindowRect()
+        rcf = self.dockSite.GetWindowRect()
+
+        rect = OffsetRect(rect, (rcc[0] - rcf[0], rcc[1] - rcf[1]))
+        rect = DeflateRect(rect, (1, 1))
+
+        flags = win32con.DCX_WINDOW | win32con.DCX_CACHE | win32con.DCX_LOCKWINDOWUPDATE
+        dc = self.dockSite.GetDCEx(None, flags)
+        try:
+            brush = win32ui.GetHalftoneBrush()
+            oldBrush = dc.SelectObject(brush)
+
+            dc.PatBlt(
+                (rect[0], rect[1]),
+                (rect[2] - rect[0], rect[3] - rect[1]),
+                win32con.PATINVERT,
+            )
+            dc.SelectObject(oldBrush)
+        finally:
+            self.dockSite.ReleaseDC(dc)
+
+    def IsHorz(self):
+        return (
+            self.nDockBarID == afxres.AFX_IDW_DOCKBAR_TOP
+            or self.nDockBarID == afxres.AFX_IDW_DOCKBAR_BOTTOM
+        )
+
+    def ClientToWnd(self, pt):
+        x, y = pt
+        if self.nDockBarID == afxres.AFX_IDW_DOCKBAR_BOTTOM:
+            y = y + self.cxEdge
+        elif self.nDockBarID == afxres.AFX_IDW_DOCKBAR_RIGHT:
+            x = x + self.cxEdge
+        return x, y
+
+    def DrawGripper(self, dc):
+        # no gripper if floating
+        if self._obj_.dwStyle & afxres.CBRS_FLOATING:
+            return
+
+        # -==HACK==-
+        # in order to calculate the client area properly after docking,
+        # the client area must be recalculated twice (I have no idea why)
+        self.dockSite.RecalcLayout()
+        # -==END HACK==-
+
+        gripper = self.GetWindowRect()
+        gripper = self.ScreenToClient(gripper)
+        gripper = OffsetRect(gripper, (-gripper[0], -gripper[1]))
+        gl, gt, gr, gb = gripper
+
+        if self._obj_.dwStyle & afxres.CBRS_ORIENT_HORZ:
+            # gripper at left
+            self.rectGripper = gl, gt + 40, gl + 20, gb
+            # draw close box
+            self.rectClose = gl + 7, gt + 10, gl + 19, gt + 22
+            dc.DrawFrameControl(
+                self.rectClose, win32con.DFC_CAPTION, win32con.DFCS_CAPTIONCLOSE
+            )
+            # draw docking toggle box
+            self.rectUndock = OffsetRect(self.rectClose, (0, 13))
+            dc.DrawFrameControl(
+                self.rectUndock, win32con.DFC_CAPTION, win32con.DFCS_CAPTIONMAX
+            )
+
+            gt = gt + 38
+            gb = gb - 10
+            gl = gl + 10
+            gr = gl + 3
+            gripper = gl, gt, gr, gb
+            dc.Draw3dRect(gripper, clrBtnHilight, clrBtnShadow)
+            dc.Draw3dRect(OffsetRect(gripper, (4, 0)), clrBtnHilight, clrBtnShadow)
+        else:
+            # gripper at top
+            self.rectGripper = gl, gt, gr - 40, gt + 20
+            # draw close box
+            self.rectClose = gr - 21, gt + 7, gr - 10, gt + 18
+            dc.DrawFrameControl(
+                self.rectClose, win32con.DFC_CAPTION, win32con.DFCS_CAPTIONCLOSE
+            )
+            #  draw docking toggle box
+            self.rectUndock = OffsetRect(self.rectClose, (-13, 0))
+            dc.DrawFrameControl(
+                self.rectUndock, win32con.DFC_CAPTION, win32con.DFCS_CAPTIONMAX
+            )
+            gr = gr - 38
+            gl = gl + 10
+            gt = gt + 10
+            gb = gt + 3
+
+            gripper = gl, gt, gr, gb
+            dc.Draw3dRect(gripper, clrBtnHilight, clrBtnShadow)
+            dc.Draw3dRect(OffsetRect(gripper, (0, 4)), clrBtnHilight, clrBtnShadow)
+
+    def HookMessages(self):
+        self.HookMessage(self.OnLButtonUp, win32con.WM_LBUTTONUP)
+        self.HookMessage(self.OnLButtonDown, win32con.WM_LBUTTONDOWN)
+        self.HookMessage(self.OnLButtonDblClk, win32con.WM_LBUTTONDBLCLK)
+        self.HookMessage(self.OnNcLButtonDown, win32con.WM_NCLBUTTONDOWN)
+        self.HookMessage(self.OnNcLButtonDblClk, win32con.WM_NCLBUTTONDBLCLK)
+        self.HookMessage(self.OnMouseMove, win32con.WM_MOUSEMOVE)
+        self.HookMessage(self.OnNcPaint, win32con.WM_NCPAINT)
+        self.HookMessage(self.OnCaptureChanged, win32con.WM_CAPTURECHANGED)
+        self.HookMessage(self.OnWindowPosChanged, win32con.WM_WINDOWPOSCHANGED)
+
+
+# 		self.HookMessage(self.OnSize, win32con.WM_SIZE)
+
+
+def EditCreator(parent):
+    d = win32ui.CreateEdit()
+    es = (
+        win32con.WS_CHILD
+        | win32con.WS_VISIBLE
+        | win32con.WS_BORDER
+        | win32con.ES_MULTILINE
+        | win32con.ES_WANTRETURN
+    )
+    d.CreateWindow(es, (0, 0, 150, 150), parent, 1000)
+    return d
+
+
+def test():
+    import pywin.mfc.dialog
+
+    global bar
+    bar = DockingBar()
+    creator = EditCreator
+    bar.CreateWindow(win32ui.GetMainFrame(), creator, "Coolbar Demo", 0xFFFFF)
+    # 	win32ui.GetMainFrame().ShowControlBar(bar, 1, 0)
+    bar.SetBarStyle(
+        bar.GetBarStyle()
+        | afxres.CBRS_TOOLTIPS
+        | afxres.CBRS_FLYBY
+        | afxres.CBRS_SIZE_DYNAMIC
+    )
+    bar.EnableDocking(afxres.CBRS_ALIGN_ANY)
+    win32ui.GetMainFrame().DockControlBar(bar, afxres.AFX_IDW_DOCKBAR_BOTTOM)
+
+
+if __name__ == "__main__":
+    test()
diff --git a/lib/pythonwin/pywin/docking/__init__.py b/lib/pythonwin/pywin/docking/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/lib/pythonwin/pywin/framework/__init__.py b/lib/pythonwin/pywin/framework/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/lib/pythonwin/pywin/framework/app.py b/lib/pythonwin/pywin/framework/app.py
new file mode 100644
index 00000000..f994f99f
--- /dev/null
+++ b/lib/pythonwin/pywin/framework/app.py
@@ -0,0 +1,457 @@
+# App.py
+# Application stuff.
+# The application is responsible for managing the main frame window.
+#
+# We also grab the FileOpen command, to invoke our Python editor
+" The PythonWin application code. Manages most aspects of MDI, etc "
+import os
+import sys
+import traceback
+
+import regutil
+import win32api
+import win32con
+import win32ui
+from pywin.mfc import afxres, dialog, window
+from pywin.mfc.thread import WinApp
+
+from . import scriptutils
+
+## NOTE: App and AppBuild should NOT be used - instead, you should contruct your
+## APP class manually whenever you like (just ensure you leave these 2 params None!)
+## Whoever wants the generic "Application" should get it via win32iu.GetApp()
+
+# These are "legacy"
+AppBuilder = None
+App = None  # default - if used, must end up a CApp derived class.
+
+
+# Helpers that should one day be removed!
+def AddIdleHandler(handler):
+    print(
+        "app.AddIdleHandler is deprecated - please use win32ui.GetApp().AddIdleHandler() instead."
+    )
+    return win32ui.GetApp().AddIdleHandler(handler)
+
+
+def DeleteIdleHandler(handler):
+    print(
+        "app.DeleteIdleHandler is deprecated - please use win32ui.GetApp().DeleteIdleHandler() instead."
+    )
+    return win32ui.GetApp().DeleteIdleHandler(handler)
+
+
+# Helper for writing a Window position by name, and later loading it.
+def SaveWindowSize(section, rect, state=""):
+    """Writes a rectangle to an INI file
+    Args: section = section name in the applications INI file
+          rect = a rectangle in a (cy, cx, y, x) tuple
+                 (same format as CREATESTRUCT position tuples)."""
+    left, top, right, bottom = rect
+    if state:
+        state = state + " "
+    win32ui.WriteProfileVal(section, state + "left", left)
+    win32ui.WriteProfileVal(section, state + "top", top)
+    win32ui.WriteProfileVal(section, state + "right", right)
+    win32ui.WriteProfileVal(section, state + "bottom", bottom)
+
+
+def LoadWindowSize(section, state=""):
+    """Loads a section from an INI file, and returns a rect in a tuple (see SaveWindowSize)"""
+    if state:
+        state = state + " "
+    left = win32ui.GetProfileVal(section, state + "left", 0)
+    top = win32ui.GetProfileVal(section, state + "top", 0)
+    right = win32ui.GetProfileVal(section, state + "right", 0)
+    bottom = win32ui.GetProfileVal(section, state + "bottom", 0)
+    return (left, top, right, bottom)
+
+
+def RectToCreateStructRect(rect):
+    return (rect[3] - rect[1], rect[2] - rect[0], rect[1], rect[0])
+
+
+# Define FrameWindow and Application objects
+#
+# The Main Frame of the application.
+class MainFrame(window.MDIFrameWnd):
+    sectionPos = "Main Window"
+    statusBarIndicators = (
+        afxres.ID_SEPARATOR,  # // status line indicator
+        afxres.ID_INDICATOR_CAPS,
+        afxres.ID_INDICATOR_NUM,
+        afxres.ID_INDICATOR_SCRL,
+        win32ui.ID_INDICATOR_LINENUM,
+        win32ui.ID_INDICATOR_COLNUM,
+    )
+
+    def OnCreate(self, cs):
+        self._CreateStatusBar()
+        return 0
+
+    def _CreateStatusBar(self):
+        self.statusBar = win32ui.CreateStatusBar(self)
+        self.statusBar.SetIndicators(self.statusBarIndicators)
+        self.HookCommandUpdate(self.OnUpdatePosIndicator, win32ui.ID_INDICATOR_LINENUM)
+        self.HookCommandUpdate(self.OnUpdatePosIndicator, win32ui.ID_INDICATOR_COLNUM)
+
+    def OnUpdatePosIndicator(self, cmdui):
+        editControl = scriptutils.GetActiveEditControl()
+        value = " " * 5
+        if editControl is not None:
+            try:
+                startChar, endChar = editControl.GetSel()
+                lineNo = editControl.LineFromChar(startChar)
+                colNo = endChar - editControl.LineIndex(lineNo)
+
+                if cmdui.m_nID == win32ui.ID_INDICATOR_LINENUM:
+                    value = "%0*d" % (5, lineNo + 1)
+                else:
+                    value = "%0*d" % (3, colNo + 1)
+            except win32ui.error:
+                pass
+        cmdui.SetText(value)
+        cmdui.Enable()
+
+    def PreCreateWindow(self, cc):
+        cc = self._obj_.PreCreateWindow(cc)
+        pos = LoadWindowSize(self.sectionPos)
+        self.startRect = pos
+        if pos[2] - pos[0]:
+            rect = RectToCreateStructRect(pos)
+            cc = cc[0], cc[1], cc[2], cc[3], rect, cc[5], cc[6], cc[7], cc[8]
+        return cc
+
+    def OnDestroy(self, msg):
+        # use GetWindowPlacement(), as it works even when min'd or max'd
+        rectNow = self.GetWindowPlacement()[4]
+        if rectNow != self.startRect:
+            SaveWindowSize(self.sectionPos, rectNow)
+        return 0
+
+
+class CApp(WinApp):
+    "A class for the application"
+
+    def __init__(self):
+        self.oldCallbackCaller = None
+        WinApp.__init__(self, win32ui.GetApp())
+        self.idleHandlers = []
+
+    def InitInstance(self):
+        "Called to crank up the app"
+        HookInput()
+        numMRU = win32ui.GetProfileVal("Settings", "Recent File List Size", 10)
+        win32ui.LoadStdProfileSettings(numMRU)
+        # 		self._obj_.InitMDIInstance()
+        if win32api.GetVersionEx()[0] < 4:
+            win32ui.SetDialogBkColor()
+            win32ui.Enable3dControls()
+
+        # install a "callback caller" - a manager for the callbacks
+        # 		self.oldCallbackCaller = win32ui.InstallCallbackCaller(self.CallbackManager)
+        self.LoadMainFrame()
+        self.SetApplicationPaths()
+
+    def ExitInstance(self):
+        "Called as the app dies - too late to prevent it here!"
+        win32ui.OutputDebug("Application shutdown\n")
+        # Restore the callback manager, if any.
+        try:
+            win32ui.InstallCallbackCaller(self.oldCallbackCaller)
+        except AttributeError:
+            pass
+        if self.oldCallbackCaller:
+            del self.oldCallbackCaller
+        self.frame = None  # clean Python references to the now destroyed window object.
+        self.idleHandlers = []
+        # Attempt cleanup if not already done!
+        if self._obj_:
+            self._obj_.AttachObject(None)
+        self._obj_ = None
+        global App
+        global AppBuilder
+        App = None
+        AppBuilder = None
+        return 0
+
+    def HaveIdleHandler(self, handler):
+        return handler in self.idleHandlers
+
+    def AddIdleHandler(self, handler):
+        self.idleHandlers.append(handler)
+
+    def DeleteIdleHandler(self, handler):
+        self.idleHandlers.remove(handler)
+
+    def OnIdle(self, count):
+        try:
+            ret = 0
+            handlers = self.idleHandlers[:]  # copy list, as may be modified during loop
+            for handler in handlers:
+                try:
+                    thisRet = handler(handler, count)
+                except:
+                    print("Idle handler %s failed" % (repr(handler)))
+                    traceback.print_exc()
+                    print("Idle handler removed from list")
+                    try:
+                        self.DeleteIdleHandler(handler)
+                    except ValueError:  # Item not in list.
+                        pass
+                    thisRet = 0
+                ret = ret or thisRet
+            return ret
+        except KeyboardInterrupt:
+            pass
+
+    def CreateMainFrame(self):
+        return MainFrame()
+
+    def LoadMainFrame(self):
+        "Create the main applications frame"
+        self.frame = self.CreateMainFrame()
+        self.SetMainFrame(self.frame)
+        self.frame.LoadFrame(win32ui.IDR_MAINFRAME, win32con.WS_OVERLAPPEDWINDOW)
+        self.frame.DragAcceptFiles()  # we can accept these.
+        self.frame.ShowWindow(win32ui.GetInitialStateRequest())
+        self.frame.UpdateWindow()
+        self.HookCommands()
+
+    def OnHelp(self, id, code):
+        try:
+            if id == win32ui.ID_HELP_GUI_REF:
+                helpFile = regutil.GetRegisteredHelpFile("Pythonwin Reference")
+                helpCmd = win32con.HELP_CONTENTS
+            else:
+                helpFile = regutil.GetRegisteredHelpFile("Main Python Documentation")
+                helpCmd = win32con.HELP_FINDER
+            if helpFile is None:
+                win32ui.MessageBox("The help file is not registered!")
+            else:
+                from . import help
+
+                help.OpenHelpFile(helpFile, helpCmd)
+        except:
+            t, v, tb = sys.exc_info()
+            win32ui.MessageBox(
+                "Internal error in help file processing\r\n%s: %s" % (t, v)
+            )
+            tb = None  # Prevent a cycle
+
+    def DoLoadModules(self, modules):
+        # XXX - this should go, but the debugger uses it :-(
+        # dont do much checking!
+        for module in modules:
+            __import__(module)
+
+    def HookCommands(self):
+        self.frame.HookMessage(self.OnDropFiles, win32con.WM_DROPFILES)
+        self.HookCommand(self.HandleOnFileOpen, win32ui.ID_FILE_OPEN)
+        self.HookCommand(self.HandleOnFileNew, win32ui.ID_FILE_NEW)
+        self.HookCommand(self.OnFileMRU, win32ui.ID_FILE_MRU_FILE1)
+        self.HookCommand(self.OnHelpAbout, win32ui.ID_APP_ABOUT)
+        self.HookCommand(self.OnHelp, win32ui.ID_HELP_PYTHON)
+        self.HookCommand(self.OnHelp, win32ui.ID_HELP_GUI_REF)
+        # Hook for the right-click menu.
+        self.frame.GetWindow(win32con.GW_CHILD).HookMessage(
+            self.OnRClick, win32con.WM_RBUTTONDOWN
+        )
+
+    def SetApplicationPaths(self):
+        # Load the users/application paths
+        new_path = []
+        apppath = win32ui.GetProfileVal("Python", "Application Path", "").split(";")
+        for path in apppath:
+            if len(path) > 0:
+                new_path.append(win32ui.FullPath(path))
+        for extra_num in range(1, 11):
+            apppath = win32ui.GetProfileVal(
+                "Python", "Application Path %d" % extra_num, ""
+            ).split(";")
+            if len(apppath) == 0:
+                break
+            for path in apppath:
+                if len(path) > 0:
+                    new_path.append(win32ui.FullPath(path))
+        sys.path = new_path + sys.path
+
+    def OnRClick(self, params):
+        "Handle right click message"
+        # put up the entire FILE menu!
+        menu = win32ui.LoadMenu(win32ui.IDR_TEXTTYPE).GetSubMenu(0)
+        menu.TrackPopupMenu(params[5])  # track at mouse position.
+        return 0
+
+    def OnDropFiles(self, msg):
+        "Handle a file being dropped from file manager"
+        hDropInfo = msg[2]
+        self.frame.SetActiveWindow()  # active us
+        nFiles = win32api.DragQueryFile(hDropInfo)
+        try:
+            for iFile in range(0, nFiles):
+                fileName = win32api.DragQueryFile(hDropInfo, iFile)
+                win32ui.GetApp().OpenDocumentFile(fileName)
+        finally:
+            win32api.DragFinish(hDropInfo)
+
+        return 0
+
+    # No longer used by Pythonwin, as the C++ code has this same basic functionality
+    # but handles errors slightly better.
+    # It all still works, tho, so if you need similar functionality, you can use it.
+    # Therefore I havent deleted this code completely!
+    # 	def CallbackManager( self, ob, args = () ):
+    # 		"""Manage win32 callbacks.  Trap exceptions, report on them, then return 'All OK'
+    # 		to the frame-work. """
+    # 		import traceback
+    # 		try:
+    # 			ret = apply(ob, args)
+    # 			return ret
+    # 		except:
+    # 			# take copies of the exception values, else other (handled) exceptions may get
+    # 			# copied over by the other fns called.
+    # 			win32ui.SetStatusText('An exception occured in a windows command handler.')
+    # 			t, v, tb = sys.exc_info()
+    # 			traceback.print_exception(t, v, tb.tb_next)
+    # 			try:
+    # 				sys.stdout.flush()
+    # 			except (NameError, AttributeError):
+    # 				pass
+
+    # Command handlers.
+    def OnFileMRU(self, id, code):
+        "Called when a File 1-n message is recieved"
+        fileName = win32ui.GetRecentFileList()[id - win32ui.ID_FILE_MRU_FILE1]
+        win32ui.GetApp().OpenDocumentFile(fileName)
+
+    def HandleOnFileOpen(self, id, code):
+        "Called when FileOpen message is received"
+        win32ui.GetApp().OnFileOpen()
+
+    def HandleOnFileNew(self, id, code):
+        "Called when FileNew message is received"
+        win32ui.GetApp().OnFileNew()
+
+    def OnHelpAbout(self, id, code):
+        "Called when HelpAbout message is received.  Displays the About dialog."
+        win32ui.InitRichEdit()
+        dlg = AboutBox()
+        dlg.DoModal()
+
+
+def _GetRegistryValue(key, val, default=None):
+    # val is registry value - None for default val.
+    try:
+        hkey = win32api.RegOpenKey(win32con.HKEY_CURRENT_USER, key)
+        return win32api.RegQueryValueEx(hkey, val)[0]
+    except win32api.error:
+        try:
+            hkey = win32api.RegOpenKey(win32con.HKEY_LOCAL_MACHINE, key)
+            return win32api.RegQueryValueEx(hkey, val)[0]
+        except win32api.error:
+            return default
+
+
+scintilla = "Scintilla is Copyright 1998-2008 Neil Hodgson (http://www.scintilla.org)"
+idle = "This program uses IDLE extensions by Guido van Rossum, Tim Peters and others."
+contributors = "Thanks to the following people for making significant contributions: Roger Upole, Sidnei da Silva, Sam Rushing, Curt Hagenlocher, Dave Brennan, Roger Burnham, Gordon McMillan, Neil Hodgson, Laramie Leavitt. (let me know if I have forgotten you!)"
+
+
+# The About Box
+class AboutBox(dialog.Dialog):
+    def __init__(self, idd=win32ui.IDD_ABOUTBOX):
+        dialog.Dialog.__init__(self, idd)
+
+    def OnInitDialog(self):
+        text = (
+            "Pythonwin - Python IDE and GUI Framework for Windows.\n\n%s\n\nPython is %s\n\n%s\n\n%s\n\n%s"
+            % (win32ui.copyright, sys.copyright, scintilla, idle, contributors)
+        )
+        self.SetDlgItemText(win32ui.IDC_EDIT1, text)
+        # Get the build number - written by installers.
+        # For distutils build, read pywin32.version.txt
+        import sysconfig
+
+        site_packages = sysconfig.get_paths()["platlib"]
+        try:
+            build_no = (
+                open(os.path.join(site_packages, "pywin32.version.txt")).read().strip()
+            )
+            ver = "pywin32 build %s" % build_no
+        except EnvironmentError:
+            ver = None
+        if ver is None:
+            # See if we are Part of Active Python
+            ver = _GetRegistryValue(
+                "SOFTWARE\\ActiveState\\ActivePython", "CurrentVersion"
+            )
+            if ver is not None:
+                ver = "ActivePython build %s" % (ver,)
+        if ver is None:
+            ver = ""
+        self.SetDlgItemText(win32ui.IDC_ABOUT_VERSION, ver)
+        self.HookCommand(self.OnButHomePage, win32ui.IDC_BUTTON1)
+
+    def OnButHomePage(self, id, code):
+        if code == win32con.BN_CLICKED:
+            win32api.ShellExecute(
+                0, "open", "https://github.com/mhammond/pywin32", None, "", 1
+            )
+
+
+def Win32RawInput(prompt=None):
+    "Provide raw_input() for gui apps"
+    # flush stderr/out first.
+    try:
+        sys.stdout.flush()
+        sys.stderr.flush()
+    except:
+        pass
+    if prompt is None:
+        prompt = ""
+    ret = dialog.GetSimpleInput(prompt)
+    if ret == None:
+        raise KeyboardInterrupt("operation cancelled")
+    return ret
+
+
+def Win32Input(prompt=None):
+    "Provide input() for gui apps"
+    return eval(input(prompt))
+
+
+def HookInput():
+    try:
+        raw_input
+        # must be py2x...
+        sys.modules["__builtin__"].raw_input = Win32RawInput
+        sys.modules["__builtin__"].input = Win32Input
+    except NameError:
+        # must be py3k
+        import code
+
+        sys.modules["builtins"].input = Win32RawInput
+
+
+def HaveGoodGUI():
+    """Returns true if we currently have a good gui available."""
+    return "pywin.framework.startup" in sys.modules
+
+
+def CreateDefaultGUI(appClass=None):
+    """Creates a default GUI environment"""
+    if appClass is None:
+        from . import intpyapp  # Bring in the default app - could be param'd later.
+
+        appClass = intpyapp.InteractivePythonApp
+    # Create and init the app.
+    appClass().InitInstance()
+
+
+def CheckCreateDefaultGUI():
+    """Checks and creates if necessary a default GUI environment."""
+    rc = HaveGoodGUI()
+    if not rc:
+        CreateDefaultGUI()
+    return rc
diff --git a/lib/pythonwin/pywin/framework/bitmap.py b/lib/pythonwin/pywin/framework/bitmap.py
new file mode 100644
index 00000000..1501f72d
--- /dev/null
+++ b/lib/pythonwin/pywin/framework/bitmap.py
@@ -0,0 +1,164 @@
+import os
+
+import win32api
+import win32con
+import win32ui
+from pywin.mfc import docview, window
+
+from . import app
+
+bStretch = 1
+
+
+class BitmapDocument(docview.Document):
+    "A bitmap document.  Holds the bitmap data itself."
+
+    def __init__(self, template):
+        docview.Document.__init__(self, template)
+        self.bitmap = None
+
+    def OnNewDocument(self):
+        # I can not create new bitmaps.
+        win32ui.MessageBox("Bitmaps can not be created.")
+
+    def OnOpenDocument(self, filename):
+        self.bitmap = win32ui.CreateBitmap()
+        # init data members
+        f = open(filename, "rb")
+        try:
+            try:
+                self.bitmap.LoadBitmapFile(f)
+            except IOError:
+                win32ui.MessageBox("Could not load the bitmap from %s" % filename)
+                return 0
+        finally:
+            f.close()
+        self.size = self.bitmap.GetSize()
+        return 1
+
+    def DeleteContents(self):
+        self.bitmap = None
+
+
+class BitmapView(docview.ScrollView):
+    "A view of a bitmap.  Obtains data from document."
+
+    def __init__(self, doc):
+        docview.ScrollView.__init__(self, doc)
+        self.width = self.height = 0
+        # set up message handlers
+        self.HookMessage(self.OnSize, win32con.WM_SIZE)
+
+    def OnInitialUpdate(self):
+        doc = self.GetDocument()
+        if doc.bitmap:
+            bitmapSize = doc.bitmap.GetSize()
+            self.SetScrollSizes(win32con.MM_TEXT, bitmapSize)
+
+    def OnSize(self, params):
+        lParam = params[3]
+        self.width = win32api.LOWORD(lParam)
+        self.height = win32api.HIWORD(lParam)
+
+    def OnDraw(self, dc):
+        # set sizes used for "non stretch" mode.
+        doc = self.GetDocument()
+        if doc.bitmap is None:
+            return
+        bitmapSize = doc.bitmap.GetSize()
+        if bStretch:
+            # stretch BMP.
+            viewRect = (0, 0, self.width, self.height)
+            bitmapRect = (0, 0, bitmapSize[0], bitmapSize[1])
+            doc.bitmap.Paint(dc, viewRect, bitmapRect)
+        else:
+            # non stretch.
+            doc.bitmap.Paint(dc)
+
+
+class BitmapFrame(window.MDIChildWnd):
+    def OnCreateClient(self, createparams, context):
+        borderX = win32api.GetSystemMetrics(win32con.SM_CXFRAME)
+        borderY = win32api.GetSystemMetrics(win32con.SM_CYFRAME)
+        titleY = win32api.GetSystemMetrics(win32con.SM_CYCAPTION)  # includes border
+        # try and maintain default window pos, else adjust if cant fit
+        # get the main client window dimensions.
+        mdiClient = win32ui.GetMainFrame().GetWindow(win32con.GW_CHILD)
+        clientWindowRect = mdiClient.ScreenToClient(mdiClient.GetWindowRect())
+        clientWindowSize = (
+            clientWindowRect[2] - clientWindowRect[0],
+            clientWindowRect[3] - clientWindowRect[1],
+        )
+        left, top, right, bottom = mdiClient.ScreenToClient(self.GetWindowRect())
+        # 		width, height=context.doc.size[0], context.doc.size[1]
+        # 		width = width+borderX*2
+        # 		height= height+titleY+borderY*2-1
+        # 		if (left+width)>clientWindowSize[0]:
+        # 			left = clientWindowSize[0] - width
+        # 		if left<0:
+        # 			left = 0
+        # 			width = clientWindowSize[0]
+        # 		if (top+height)>clientWindowSize[1]:
+        # 			top = clientWindowSize[1] - height
+        # 		if top<0:
+        # 			top = 0
+        # 			height = clientWindowSize[1]
+        # 		self.frame.MoveWindow((left, top, left+width, top+height),0)
+        window.MDIChildWnd.OnCreateClient(self, createparams, context)
+        return 1
+
+
+class BitmapTemplate(docview.DocTemplate):
+    def __init__(self):
+        docview.DocTemplate.__init__(
+            self, win32ui.IDR_PYTHONTYPE, BitmapDocument, BitmapFrame, BitmapView
+        )
+
+    def MatchDocType(self, fileName, fileType):
+        doc = self.FindOpenDocument(fileName)
+        if doc:
+            return doc
+        ext = os.path.splitext(fileName)[1].lower()
+        if ext == ".bmp":  # removed due to PIL! or ext=='.ppm':
+            return win32ui.CDocTemplate_Confidence_yesAttemptNative
+        return win32ui.CDocTemplate_Confidence_maybeAttemptForeign
+
+
+# 		return win32ui.CDocTemplate_Confidence_noAttempt
+
+# For debugging purposes, when this module may be reloaded many times.
+try:
+    win32ui.GetApp().RemoveDocTemplate(bitmapTemplate)
+except NameError:
+    pass
+
+bitmapTemplate = BitmapTemplate()
+bitmapTemplate.SetDocStrings(
+    "\nBitmap\nBitmap\nBitmap (*.bmp)\n.bmp\nPythonBitmapFileType\nPython Bitmap File"
+)
+win32ui.GetApp().AddDocTemplate(bitmapTemplate)
+
+# This works, but just didnt make it through the code reorg.
+# class PPMBitmap(Bitmap):
+# 	def LoadBitmapFile(self, file ):
+# 		magic=file.readline()
+# 		if magic <> "P6\n":
+# 			raise TypeError, "The file is not a PPM format file"
+# 		rowcollist=string.split(file.readline())
+# 		cols=string.atoi(rowcollist[0])
+# 		rows=string.atoi(rowcollist[1])
+# 		file.readline()	# whats this one?
+# 		self.bitmap.LoadPPMFile(file,(cols,rows))
+
+
+def t():
+    bitmapTemplate.OpenDocumentFile("d:\\winnt\\arcade.bmp")
+    # OpenBMPFile( 'd:\\winnt\\arcade.bmp')
+
+
+def demo():
+    import glob
+
+    winDir = win32api.GetWindowsDirectory()
+    for fileName in glob.glob1(winDir, "*.bmp")[:2]:
+        bitmapTemplate.OpenDocumentFile(os.path.join(winDir, fileName))
diff --git a/lib/pythonwin/pywin/framework/cmdline.py b/lib/pythonwin/pywin/framework/cmdline.py
new file mode 100644
index 00000000..dba31d1a
--- /dev/null
+++ b/lib/pythonwin/pywin/framework/cmdline.py
@@ -0,0 +1,56 @@
+# cmdline - command line utilities.
+import string
+import sys
+
+import win32ui
+
+
+def ParseArgs(str):
+    import string
+
+    ret = []
+    pos = 0
+    length = len(str)
+    while pos < length:
+        try:
+            while str[pos] in string.whitespace:
+                pos = pos + 1
+        except IndexError:
+            break
+        if pos >= length:
+            break
+        if str[pos] == '"':
+            pos = pos + 1
+            try:
+                endPos = str.index('"', pos) - 1
+                nextPos = endPos + 2
+            except ValueError:
+                endPos = length
+                nextPos = endPos + 1
+        else:
+            endPos = pos
+            while endPos < length and not str[endPos] in string.whitespace:
+                endPos = endPos + 1
+            nextPos = endPos + 1
+        ret.append(str[pos : endPos + 1].strip())
+        pos = nextPos
+    return ret
+
+
+def FixArgFileName(fileName):
+    """Convert a filename on the commandline to something useful.
+    Given an automatic filename on the commandline, turn it a python module name,
+    with the path added to sys.path."""
+    import os
+
+    path, fname = os.path.split(fileName)
+    if len(path) == 0:
+        path = os.curdir
+    path = os.path.abspath(path)
+    # must check that the command line arg's path is in sys.path
+    for syspath in sys.path:
+        if os.path.abspath(syspath) == path:
+            break
+    else:
+        sys.path.append(path)
+    return os.path.splitext(fname)[0]
diff --git a/lib/pythonwin/pywin/framework/dbgcommands.py b/lib/pythonwin/pywin/framework/dbgcommands.py
new file mode 100644
index 00000000..e295926c
--- /dev/null
+++ b/lib/pythonwin/pywin/framework/dbgcommands.py
@@ -0,0 +1,189 @@
+# Command Handlers for the debugger.
+
+# Not in the debugger package, as I always want these interfaces to be
+# available, even if the debugger has not yet been (or can not be)
+# imported
+import warnings
+
+import win32ui
+from pywin.scintilla.control import CScintillaEditInterface
+
+from . import scriptutils
+
+IdToBarNames = {
+    win32ui.IDC_DBG_STACK: ("Stack", 0),
+    win32ui.IDC_DBG_BREAKPOINTS: ("Breakpoints", 0),
+    win32ui.IDC_DBG_WATCH: ("Watch", 1),
+}
+
+
+class DebuggerCommandHandler:
+    def HookCommands(self):
+        commands = (
+            (self.OnStep, None, win32ui.IDC_DBG_STEP),
+            (self.OnStepOut, self.OnUpdateOnlyBreak, win32ui.IDC_DBG_STEPOUT),
+            (self.OnStepOver, None, win32ui.IDC_DBG_STEPOVER),
+            (self.OnGo, None, win32ui.IDC_DBG_GO),
+            (self.OnClose, self.OnUpdateClose, win32ui.IDC_DBG_CLOSE),
+            (self.OnAdd, self.OnUpdateAddBreakpoints, win32ui.IDC_DBG_ADD),
+            (self.OnClearAll, self.OnUpdateClearAllBreakpoints, win32ui.IDC_DBG_CLEAR),
+            # 		                  (self.OnDebuggerToolbar, self.OnUpdateDebuggerToolbar, win32ui.ID_DEBUGGER_TOOLBAR),
+        )
+
+        frame = win32ui.GetMainFrame()
+
+        for methHandler, methUpdate, id in commands:
+            frame.HookCommand(methHandler, id)
+            if not methUpdate is None:
+                frame.HookCommandUpdate(methUpdate, id)
+
+        for id in list(IdToBarNames.keys()):
+            frame.HookCommand(self.OnDebuggerBar, id)
+            frame.HookCommandUpdate(self.OnUpdateDebuggerBar, id)
+
+    def OnDebuggerToolbar(self, id, code):
+        if code == 0:
+            return not win32ui.GetMainFrame().OnBarCheck(id)
+
+    def OnUpdateDebuggerToolbar(self, cmdui):
+        win32ui.GetMainFrame().OnUpdateControlBarMenu(cmdui)
+        cmdui.Enable(1)
+
+    def _GetDebugger(self):
+        try:
+            import pywin.debugger
+
+            return pywin.debugger.currentDebugger
+        except ImportError:
+            return None
+
+    def _DoOrStart(self, doMethod, startFlag):
+        d = self._GetDebugger()
+        if d is not None and d.IsDebugging():
+            method = getattr(d, doMethod)
+            method()
+        else:
+            scriptutils.RunScript(
+                defName=None, defArgs=None, bShowDialog=0, debuggingType=startFlag
+            )
+
+    def OnStep(self, msg, code):
+        self._DoOrStart("do_set_step", scriptutils.RS_DEBUGGER_STEP)
+
+    def OnStepOver(self, msg, code):
+        self._DoOrStart("do_set_next", scriptutils.RS_DEBUGGER_STEP)
+
+    def OnStepOut(self, msg, code):
+        d = self._GetDebugger()
+        if d is not None and d.IsDebugging():
+            d.do_set_return()
+
+    def OnGo(self, msg, code):
+        self._DoOrStart("do_set_continue", scriptutils.RS_DEBUGGER_GO)
+
+    def OnClose(self, msg, code):
+        d = self._GetDebugger()
+        if d is not None:
+            if d.IsDebugging():
+                d.set_quit()
+            else:
+                d.close()
+
+    def OnUpdateClose(self, cmdui):
+        d = self._GetDebugger()
+        if d is not None and d.inited:
+            cmdui.Enable(1)
+        else:
+            cmdui.Enable(0)
+
+    def OnAdd(self, msg, code):
+        doc, view = scriptutils.GetActiveEditorDocument()
+        if doc is None:
+            ## Don't do a messagebox, as this could be triggered from the app's
+            ## idle loop whenever the debug toolbar is visible, giving a never-ending
+            ## series of dialogs.  This can happen when the OnUpdate handler
+            ## for the toolbar button IDC_DBG_ADD fails, since MFC falls back to
+            ## sending a normal command if the UI update command fails.
+            ## win32ui.MessageBox('There is no active window - no breakpoint can be added')
+            warnings.warn("There is no active window - no breakpoint can be added")
+            return None
+        pathName = doc.GetPathName()
+        lineNo = view.LineFromChar(view.GetSel()[0]) + 1
+        # If I have a debugger, then tell it, otherwise just add a marker
+        d = self._GetDebugger()
+        if d is None:
+            import pywin.framework.editor.color.coloreditor
+
+            doc.MarkerToggle(
+                lineNo, pywin.framework.editor.color.coloreditor.MARKER_BREAKPOINT
+            )
+        else:
+            if d.get_break(pathName, lineNo):
+                win32ui.SetStatusText("Clearing breakpoint", 1)
+                rc = d.clear_break(pathName, lineNo)
+            else:
+                win32ui.SetStatusText("Setting breakpoint", 1)
+                rc = d.set_break(pathName, lineNo)
+            if rc:
+                win32ui.MessageBox(rc)
+            d.GUIRespondDebuggerData()
+
+    def OnClearAll(self, msg, code):
+        win32ui.SetStatusText("Clearing all breakpoints")
+        d = self._GetDebugger()
+        if d is None:
+            import pywin.framework.editor
+            import pywin.framework.editor.color.coloreditor
+
+            for doc in pywin.framework.editor.editorTemplate.GetDocumentList():
+                doc.MarkerDeleteAll(
+                    pywin.framework.editor.color.coloreditor.MARKER_BREAKPOINT
+                )
+        else:
+            d.clear_all_breaks()
+            d.UpdateAllLineStates()
+            d.GUIRespondDebuggerData()
+
+    def OnUpdateOnlyBreak(self, cmdui):
+        d = self._GetDebugger()
+        ok = d is not None and d.IsBreak()
+        cmdui.Enable(ok)
+
+    def OnUpdateAddBreakpoints(self, cmdui):
+        doc, view = scriptutils.GetActiveEditorDocument()
+        if doc is None or not isinstance(view, CScintillaEditInterface):
+            enabled = 0
+        else:
+            enabled = 1
+            lineNo = view.LineFromChar(view.GetSel()[0]) + 1
+            import pywin.framework.editor.color.coloreditor
+
+            cmdui.SetCheck(
+                doc.MarkerAtLine(
+                    lineNo, pywin.framework.editor.color.coloreditor.MARKER_BREAKPOINT
+                )
+                != 0
+            )
+        cmdui.Enable(enabled)
+
+    def OnUpdateClearAllBreakpoints(self, cmdui):
+        d = self._GetDebugger()
+        cmdui.Enable(d is None or len(d.breaks) != 0)
+
+    def OnUpdateDebuggerBar(self, cmdui):
+        name, always = IdToBarNames.get(cmdui.m_nID)
+        enabled = always
+        d = self._GetDebugger()
+        if d is not None and d.IsDebugging() and name is not None:
+            enabled = 1
+            bar = d.GetDebuggerBar(name)
+            cmdui.SetCheck(bar.IsWindowVisible())
+        cmdui.Enable(enabled)
+
+    def OnDebuggerBar(self, id, code):
+        name = IdToBarNames.get(id)[0]
+        d = self._GetDebugger()
+        if d is not None and name is not None:
+            bar = d.GetDebuggerBar(name)
+            newState = not bar.IsWindowVisible()
+            win32ui.GetMainFrame().ShowControlBar(bar, newState, 1)
diff --git a/lib/pythonwin/pywin/framework/dlgappcore.py b/lib/pythonwin/pywin/framework/dlgappcore.py
new file mode 100644
index 00000000..4b60cc1c
--- /dev/null
+++ b/lib/pythonwin/pywin/framework/dlgappcore.py
@@ -0,0 +1,75 @@
+# dlgappcore.
+#
+# base classes for dialog based apps.
+
+
+import win32api
+import win32con
+import win32ui
+from pywin.mfc import dialog
+
+from . import app
+
+error = "Dialog Application Error"
+
+
+class AppDialog(dialog.Dialog):
+    "The dialog box for the application"
+
+    def __init__(self, id, dll=None):
+        self.iconId = win32ui.IDR_MAINFRAME
+        dialog.Dialog.__init__(self, id, dll)
+
+    def OnInitDialog(self):
+        return dialog.Dialog.OnInitDialog(self)
+
+    # Provide support for a dlg app using an icon
+    def OnPaint(self):
+        if not self.IsIconic():
+            return self._obj_.OnPaint()
+        self.DefWindowProc(win32con.WM_ICONERASEBKGND, dc.GetHandleOutput(), 0)
+        left, top, right, bottom = self.GetClientRect()
+        left = (right - win32api.GetSystemMetrics(win32con.SM_CXICON)) >> 1
+        top = (bottom - win32api.GetSystemMetrics(win32con.SM_CYICON)) >> 1
+        hIcon = win32ui.GetApp().LoadIcon(self.iconId)
+        self.GetDC().DrawIcon((left, top), hIcon)
+
+    # Only needed to provide a minimized icon (and this seems
+    # less important under win95/NT4
+    def OnEraseBkgnd(self, dc):
+        if self.IsIconic():
+            return 1
+        else:
+            return self._obj_.OnEraseBkgnd(dc)
+
+    def OnQueryDragIcon(self):
+        return win32ui.GetApp().LoadIcon(self.iconId)
+
+    def PreDoModal(self):
+        pass
+
+
+class DialogApp(app.CApp):
+    "An application class, for an app with main dialog box"
+
+    def InitInstance(self):
+        # 		win32ui.SetProfileFileName('dlgapp.ini')
+        win32ui.LoadStdProfileSettings()
+        win32ui.EnableControlContainer()
+        win32ui.Enable3dControls()
+        self.dlg = self.frame = self.CreateDialog()
+
+        if self.frame is None:
+            raise error("No dialog was created by CreateDialog()")
+            return
+
+        self._obj_.InitDlgInstance(self.dlg)
+        self.PreDoModal()
+        self.dlg.PreDoModal()
+        self.dlg.DoModal()
+
+    def CreateDialog(self):
+        pass
+
+    def PreDoModal(self):
+        pass
diff --git a/lib/pythonwin/pywin/framework/editor/ModuleBrowser.py b/lib/pythonwin/pywin/framework/editor/ModuleBrowser.py
new file mode 100644
index 00000000..7fd96532
--- /dev/null
+++ b/lib/pythonwin/pywin/framework/editor/ModuleBrowser.py
@@ -0,0 +1,235 @@
+# ModuleBrowser.py - A view that provides a module browser for an editor document.
+import pyclbr
+
+import afxres
+import commctrl
+import pywin.framework.scriptutils
+import pywin.mfc.docview
+import win32api
+import win32con
+import win32ui
+from pywin.tools import browser, hierlist
+
+
+class HierListCLBRModule(hierlist.HierListItem):
+    def __init__(self, modName, clbrdata):
+        self.modName = modName
+        self.clbrdata = clbrdata
+
+    def GetText(self):
+        return self.modName
+
+    def GetSubList(self):
+        ret = []
+        for item in self.clbrdata.values():
+            if (
+                item.__class__ != pyclbr.Class
+            ):  # ie, it is a pyclbr Function instance (only introduced post 1.5.2)
+                ret.append(HierListCLBRFunction(item))
+            else:
+                ret.append(HierListCLBRClass(item))
+        ret.sort()
+        return ret
+
+    def IsExpandable(self):
+        return 1
+
+
+class HierListCLBRItem(hierlist.HierListItem):
+    def __init__(self, name, file, lineno, suffix=""):
+        self.name = str(name)
+        self.file = file
+        self.lineno = lineno
+        self.suffix = suffix
+
+    def __lt__(self, other):
+        return self.name < other.name
+
+    def __eq__(self, other):
+        return self.name == other.name
+
+    def GetText(self):
+        return self.name + self.suffix
+
+    def TakeDefaultAction(self):
+        if self.file:
+            pywin.framework.scriptutils.JumpToDocument(
+                self.file, self.lineno, bScrollToTop=1
+            )
+        else:
+            win32ui.SetStatusText("Can not locate the source code for this object.")
+
+    def PerformItemSelected(self):
+        if self.file is None:
+            msg = "%s - source can not be located." % (self.name,)
+        else:
+            msg = "%s defined at line %d of %s" % (self.name, self.lineno, self.file)
+        win32ui.SetStatusText(msg)
+
+
+class HierListCLBRClass(HierListCLBRItem):
+    def __init__(self, clbrclass, suffix=""):
+        try:
+            name = clbrclass.name
+            file = clbrclass.file
+            lineno = clbrclass.lineno
+            self.super = clbrclass.super
+            self.methods = clbrclass.methods
+        except AttributeError:
+            name = clbrclass
+            file = lineno = None
+            self.super = []
+            self.methods = {}
+        HierListCLBRItem.__init__(self, name, file, lineno, suffix)
+
+    def GetSubList(self):
+        r1 = []
+        for c in self.super:
+            r1.append(HierListCLBRClass(c, " (Parent class)"))
+        r1.sort()
+        r2 = []
+        for meth, lineno in self.methods.items():
+            r2.append(HierListCLBRMethod(meth, self.file, lineno))
+        r2.sort()
+        return r1 + r2
+
+    def IsExpandable(self):
+        return len(self.methods) + len(self.super)
+
+    def GetBitmapColumn(self):
+        return 21
+
+
+class HierListCLBRFunction(HierListCLBRItem):
+    def __init__(self, clbrfunc, suffix=""):
+        name = clbrfunc.name
+        file = clbrfunc.file
+        lineno = clbrfunc.lineno
+        HierListCLBRItem.__init__(self, name, file, lineno, suffix)
+
+    def GetBitmapColumn(self):
+        return 22
+
+
+class HierListCLBRMethod(HierListCLBRItem):
+    def GetBitmapColumn(self):
+        return 22
+
+
+class HierListCLBRErrorItem(hierlist.HierListItem):
+    def __init__(self, text):
+        self.text = text
+
+    def GetText(self):
+        return self.text
+
+    def GetSubList(self):
+        return [HierListCLBRErrorItem(self.text)]
+
+    def IsExpandable(self):
+        return 0
+
+
+class HierListCLBRErrorRoot(HierListCLBRErrorItem):
+    def IsExpandable(self):
+        return 1
+
+
+class BrowserView(pywin.mfc.docview.TreeView):
+    def OnInitialUpdate(self):
+        self.list = None
+        rc = self._obj_.OnInitialUpdate()
+        self.HookMessage(self.OnSize, win32con.WM_SIZE)
+        self.bDirty = 0
+        self.destroying = 0
+        return rc
+
+    def DestroyBrowser(self):
+        self.DestroyList()
+
+    def OnActivateView(self, activate, av, dv):
+        #        print "AV", self.bDirty, activate
+        if activate:
+            self.CheckRefreshList()
+        return self._obj_.OnActivateView(activate, av, dv)
+
+    def _MakeRoot(self):
+        path = self.GetDocument().GetPathName()
+        if not path:
+            return HierListCLBRErrorRoot(
+                "Error: Can not browse a file until it is saved"
+            )
+        else:
+            mod, path = pywin.framework.scriptutils.GetPackageModuleName(path)
+            if self.bDirty:
+                what = "Refreshing"
+                # Hack for pyclbr being too smart
+                try:
+                    del pyclbr._modules[mod]
+                except (KeyError, AttributeError):
+                    pass
+            else:
+                what = "Building"
+            win32ui.SetStatusText("%s class list - please wait..." % (what,), 1)
+            win32ui.DoWaitCursor(1)
+            try:
+                reader = pyclbr.readmodule_ex  # new version post 1.5.2
+            except AttributeError:
+                reader = pyclbr.readmodule
+            try:
+                data = reader(mod, [path])
+                if data:
+                    return HierListCLBRModule(mod, data)
+                else:
+                    return HierListCLBRErrorRoot("No Python classes in module.")
+
+            finally:
+                win32ui.DoWaitCursor(0)
+                win32ui.SetStatusText(win32ui.LoadString(afxres.AFX_IDS_IDLEMESSAGE))
+
+    def DestroyList(self):
+        self.destroying = 1
+        list = getattr(
+            self, "list", None
+        )  # If the document was not successfully opened, we may not have a list.
+        self.list = None
+        if list is not None:
+            list.HierTerm()
+        self.destroying = 0
+
+    def CheckMadeList(self):
+        if self.list is not None or self.destroying:
+            return
+        self.rootitem = root = self._MakeRoot()
+        self.list = list = hierlist.HierListWithItems(root, win32ui.IDB_BROWSER_HIER)
+        list.HierInit(self.GetParentFrame(), self)
+        list.SetStyle(
+            commctrl.TVS_HASLINES | commctrl.TVS_LINESATROOT | commctrl.TVS_HASBUTTONS
+        )
+
+    def CheckRefreshList(self):
+        if self.bDirty:
+            if self.list is None:
+                self.CheckMadeList()
+            else:
+                new_root = self._MakeRoot()
+                if self.rootitem.__class__ == new_root.__class__ == HierListCLBRModule:
+                    self.rootitem.modName = new_root.modName
+                    self.rootitem.clbrdata = new_root.clbrdata
+                    self.list.Refresh()
+                else:
+                    self.list.AcceptRoot(self._MakeRoot())
+            self.bDirty = 0
+
+    def OnSize(self, params):
+        lparam = params[3]
+        w = win32api.LOWORD(lparam)
+        h = win32api.HIWORD(lparam)
+        if w != 0:
+            self.CheckMadeList()
+        elif w == 0:
+            self.DestroyList()
+        return 1
+
+    def _UpdateUIForState(self):
+        self.bDirty = 1
diff --git a/lib/pythonwin/pywin/framework/editor/__init__.py b/lib/pythonwin/pywin/framework/editor/__init__.py
new file mode 100644
index 00000000..ce13ece6
--- /dev/null
+++ b/lib/pythonwin/pywin/framework/editor/__init__.py
@@ -0,0 +1,106 @@
+# __init__ for the Pythonwin editor package.
+#
+# We used to support optional editors - eg, color or non-color.
+#
+# This really isnt necessary with Scintilla, and scintilla
+# is getting so deeply embedded that it was too much work.
+
+import sys
+
+import win32con
+import win32ui
+
+defaultCharacterFormat = (-402653169, 0, 200, 0, 0, 0, 49, "Courier New")
+
+##def GetDefaultEditorModuleName():
+##	import pywin
+##	# If someone has set pywin.editormodulename, then this is what we use
+##	try:
+##		prefModule = pywin.editormodulename
+##	except AttributeError:
+##		prefModule = win32ui.GetProfileVal("Editor","Module", "")
+##	return prefModule
+##
+##def WriteDefaultEditorModule(module):
+##	try:
+##		module = module.__name__
+##	except:
+##		pass
+##	win32ui.WriteProfileVal("Editor", "Module", module)
+
+
+def LoadDefaultEditor():
+    pass
+
+
+##	prefModule = GetDefaultEditorModuleName()
+##	restorePrefModule = None
+##	mod = None
+##	if prefModule:
+##		try:
+##			mod = __import__(prefModule)
+##		except 'xx':
+##			msg = "Importing your preferred editor ('%s') failed.\n\nError %s: %s\n\nAn attempt will be made to load the default editor.\n\nWould you like this editor disabled in the future?" % (prefModule, sys.exc_info()[0], sys.exc_info()[1])
+##			rc = win32ui.MessageBox(msg, "Error importing editor", win32con.MB_YESNO)
+##			if rc == win32con.IDNO:
+##				restorePrefModule = prefModule
+##			WriteDefaultEditorModule("")
+##			del rc
+##
+##	try:
+##		# Try and load the default one - dont catch errors here.
+##		if mod is None:
+##			prefModule = "pywin.framework.editor.color.coloreditor"
+##			mod = __import__(prefModule)
+##
+##		# Get at the real module.
+##		mod = sys.modules[prefModule]
+##
+##		# Do a "from mod import *"
+##		globals().update(mod.__dict__)
+##
+##	finally:
+##		# Restore the users default editor if it failed and they requested not to disable it.
+##		if restorePrefModule:
+##			WriteDefaultEditorModule(restorePrefModule)
+
+
+def GetEditorOption(option, defaultValue, min=None, max=None):
+    rc = win32ui.GetProfileVal("Editor", option, defaultValue)
+    if min is not None and rc < min:
+        rc = defaultValue
+    if max is not None and rc > max:
+        rc = defaultValue
+    return rc
+
+
+def SetEditorOption(option, newValue):
+    win32ui.WriteProfileVal("Editor", option, newValue)
+
+
+def DeleteEditorOption(option):
+    try:
+        win32ui.WriteProfileVal("Editor", option, None)
+    except win32ui.error:
+        pass
+
+
+# Load and save font tuples
+def GetEditorFontOption(option, default=None):
+    if default is None:
+        default = defaultCharacterFormat
+    fmt = GetEditorOption(option, "")
+    if fmt == "":
+        return default
+    try:
+        return eval(fmt)
+    except:
+        print("WARNING: Invalid font setting in registry - setting ignored")
+        return default
+
+
+def SetEditorFontOption(option, newValue):
+    SetEditorOption(option, str(newValue))
+
+
+from pywin.framework.editor.color.coloreditor import editorTemplate
diff --git a/lib/pythonwin/pywin/framework/editor/color/__init__.py b/lib/pythonwin/pywin/framework/editor/color/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/lib/pythonwin/pywin/framework/editor/color/coloreditor.py b/lib/pythonwin/pywin/framework/editor/color/coloreditor.py
new file mode 100644
index 00000000..4aacc0ea
--- /dev/null
+++ b/lib/pythonwin/pywin/framework/editor/color/coloreditor.py
@@ -0,0 +1,664 @@
+# Color Editor originally by Neil Hodgson, but restructured by mh to integrate
+# even tighter into Pythonwin.
+
+import pywin.scintilla.keycodes
+import win32api
+import win32con
+import win32ui
+from pywin.framework.editor import (
+    GetEditorFontOption,
+    GetEditorOption,
+    SetEditorFontOption,
+    SetEditorOption,
+    defaultCharacterFormat,
+)
+from pywin.scintilla import bindings
+
+# from pywin.framework.editor import EditorPropertyPage
+
+MSG_CHECK_EXTERNAL_FILE = (
+    win32con.WM_USER + 1999
+)  ## WARNING: Duplicated in document.py and editor.py
+
+# Define a few common markers
+MARKER_BOOKMARK = 0
+MARKER_BREAKPOINT = 1
+MARKER_CURRENT = 2
+
+import pywin.scintilla.view
+from pywin.debugger import dbgcon
+from pywin.framework.editor.document import EditorDocumentBase
+from pywin.scintilla import scintillacon  # For the marker definitions
+from pywin.scintilla.document import CScintillaDocument
+
+
+class SyntEditDocument(EditorDocumentBase):
+    "A SyntEdit document."
+
+    def OnDebuggerStateChange(self, state):
+        self._ApplyOptionalToViews("OnDebuggerStateChange", state)
+
+    def HookViewNotifications(self, view):
+        EditorDocumentBase.HookViewNotifications(self, view)
+        view.SCISetUndoCollection(1)
+
+    def FinalizeViewCreation(self, view):
+        EditorDocumentBase.FinalizeViewCreation(self, view)
+        if view == self.GetFirstView():
+            self.GetDocTemplate().CheckIDLEMenus(view.idle)
+
+
+SyntEditViewParent = pywin.scintilla.view.CScintillaView
+
+
+class SyntEditView(SyntEditViewParent):
+    "A view of a SyntEdit.  Obtains data from document."
+
+    def __init__(self, doc):
+        SyntEditViewParent.__init__(self, doc)
+        self.bCheckingFile = 0
+
+    def OnInitialUpdate(self):
+        SyntEditViewParent.OnInitialUpdate(self)
+
+        self.HookMessage(self.OnRClick, win32con.WM_RBUTTONDOWN)
+
+        for id in (
+            win32ui.ID_VIEW_FOLD_COLLAPSE,
+            win32ui.ID_VIEW_FOLD_COLLAPSE_ALL,
+            win32ui.ID_VIEW_FOLD_EXPAND,
+            win32ui.ID_VIEW_FOLD_EXPAND_ALL,
+        ):
+            self.HookCommand(self.OnCmdViewFold, id)
+            self.HookCommandUpdate(self.OnUpdateViewFold, id)
+        self.HookCommand(self.OnCmdViewFoldTopLevel, win32ui.ID_VIEW_FOLD_TOPLEVEL)
+
+        # Define the markers
+        # 		self.SCIMarkerDeleteAll()
+        self.SCIMarkerDefineAll(
+            MARKER_BOOKMARK,
+            scintillacon.SC_MARK_ROUNDRECT,
+            win32api.RGB(0x0, 0x0, 0x0),
+            win32api.RGB(0, 0xFF, 0xFF),
+        )
+
+        self.SCIMarkerDefine(MARKER_CURRENT, scintillacon.SC_MARK_ARROW)
+        self.SCIMarkerSetBack(MARKER_CURRENT, win32api.RGB(0xFF, 0xFF, 0x00))
+
+        # Define the folding markers
+        if 1:  # traditional markers
+            self.SCIMarkerDefineAll(
+                scintillacon.SC_MARKNUM_FOLDEROPEN,
+                scintillacon.SC_MARK_MINUS,
+                win32api.RGB(0xFF, 0xFF, 0xFF),
+                win32api.RGB(0, 0, 0),
+            )
+            self.SCIMarkerDefineAll(
+                scintillacon.SC_MARKNUM_FOLDER,
+                scintillacon.SC_MARK_PLUS,
+                win32api.RGB(0xFF, 0xFF, 0xFF),
+                win32api.RGB(0, 0, 0),
+            )
+            self.SCIMarkerDefineAll(
+                scintillacon.SC_MARKNUM_FOLDERSUB,
+                scintillacon.SC_MARK_EMPTY,
+                win32api.RGB(0xFF, 0xFF, 0xFF),
+                win32api.RGB(0, 0, 0),
+            )
+            self.SCIMarkerDefineAll(
+                scintillacon.SC_MARKNUM_FOLDERTAIL,
+                scintillacon.SC_MARK_EMPTY,
+                win32api.RGB(0xFF, 0xFF, 0xFF),
+                win32api.RGB(0, 0, 0),
+            )
+            self.SCIMarkerDefineAll(
+                scintillacon.SC_MARKNUM_FOLDEREND,
+                scintillacon.SC_MARK_EMPTY,
+                win32api.RGB(0xFF, 0xFF, 0xFF),
+                win32api.RGB(0, 0, 0),
+            )
+            self.SCIMarkerDefineAll(
+                scintillacon.SC_MARKNUM_FOLDEROPENMID,
+                scintillacon.SC_MARK_EMPTY,
+                win32api.RGB(0xFF, 0xFF, 0xFF),
+                win32api.RGB(0, 0, 0),
+            )
+            self.SCIMarkerDefineAll(
+                scintillacon.SC_MARKNUM_FOLDERMIDTAIL,
+                scintillacon.SC_MARK_EMPTY,
+                win32api.RGB(0xFF, 0xFF, 0xFF),
+                win32api.RGB(0, 0, 0),
+            )
+        else:  # curved markers
+            self.SCIMarkerDefineAll(
+                scintillacon.SC_MARKNUM_FOLDEROPEN,
+                scintillacon.SC_MARK_CIRCLEMINUS,
+                win32api.RGB(0xFF, 0xFF, 0xFF),
+                win32api.RGB(0, 0, 0),
+            )
+            self.SCIMarkerDefineAll(
+                scintillacon.SC_MARKNUM_FOLDER,
+                scintillacon.SC_MARK_CIRCLEPLUS,
+                win32api.RGB(0xFF, 0xFF, 0xFF),
+                win32api.RGB(0, 0, 0),
+            )
+            self.SCIMarkerDefineAll(
+                scintillacon.SC_MARKNUM_FOLDERSUB,
+                scintillacon.SC_MARK_VLINE,
+                win32api.RGB(0xFF, 0xFF, 0xFF),
+                win32api.RGB(0, 0, 0),
+            )
+            self.SCIMarkerDefineAll(
+                scintillacon.SC_MARKNUM_FOLDERTAIL,
+                scintillacon.SC_MARK_LCORNERCURVE,
+                win32api.RGB(0xFF, 0xFF, 0xFF),
+                win32api.RGB(0, 0, 0),
+            )
+            self.SCIMarkerDefineAll(
+                scintillacon.SC_MARKNUM_FOLDEREND,
+                scintillacon.SC_MARK_CIRCLEPLUSCONNECTED,
+                win32api.RGB(0xFF, 0xFF, 0xFF),
+                win32api.RGB(0, 0, 0),
+            )
+            self.SCIMarkerDefineAll(
+                scintillacon.SC_MARKNUM_FOLDEROPENMID,
+                scintillacon.SC_MARK_CIRCLEMINUSCONNECTED,
+                win32api.RGB(0xFF, 0xFF, 0xFF),
+                win32api.RGB(0, 0, 0),
+            )
+            self.SCIMarkerDefineAll(
+                scintillacon.SC_MARKNUM_FOLDERMIDTAIL,
+                scintillacon.SC_MARK_TCORNERCURVE,
+                win32api.RGB(0xFF, 0xFF, 0xFF),
+                win32api.RGB(0, 0, 0),
+            )
+
+        self.SCIMarkerDefine(MARKER_BREAKPOINT, scintillacon.SC_MARK_CIRCLE)
+        # Marker background depends on debugger state
+        self.SCIMarkerSetFore(MARKER_BREAKPOINT, win32api.RGB(0x0, 0, 0))
+        # Get the current debugger state.
+        try:
+            import pywin.debugger
+
+            if pywin.debugger.currentDebugger is None:
+                state = dbgcon.DBGSTATE_NOT_DEBUGGING
+            else:
+                state = pywin.debugger.currentDebugger.debuggerState
+        except ImportError:
+            state = dbgcon.DBGSTATE_NOT_DEBUGGING
+        self.OnDebuggerStateChange(state)
+
+    def _GetSubConfigNames(self):
+        return ["editor"]  # Allow [Keys:Editor] sections to be specific to us
+
+    def DoConfigChange(self):
+        SyntEditViewParent.DoConfigChange(self)
+        tabSize = GetEditorOption("Tab Size", 4, 2)
+        indentSize = GetEditorOption("Indent Size", 4, 2)
+        bUseTabs = GetEditorOption("Use Tabs", 0)
+        bSmartTabs = GetEditorOption("Smart Tabs", 1)
+        ext = self.idle.IDLEExtension("AutoIndent")  # Required extension.
+
+        self.SCISetViewWS(GetEditorOption("View Whitespace", 0))
+        self.SCISetViewEOL(GetEditorOption("View EOL", 0))
+        self.SCISetIndentationGuides(GetEditorOption("View Indentation Guides", 0))
+
+        if GetEditorOption("Right Edge Enabled", 0):
+            mode = scintillacon.EDGE_BACKGROUND
+        else:
+            mode = scintillacon.EDGE_NONE
+        self.SCISetEdgeMode(mode)
+        self.SCISetEdgeColumn(GetEditorOption("Right Edge Column", 75))
+        self.SCISetEdgeColor(
+            GetEditorOption("Right Edge Color", win32api.RGB(0xEF, 0xEF, 0xEF))
+        )
+
+        width = GetEditorOption("Marker Margin Width", 16)
+        self.SCISetMarginWidthN(1, width)
+        width = GetEditorOption("Fold Margin Width", 12)
+        self.SCISetMarginWidthN(2, width)
+        width = GetEditorOption("Line Number Margin Width", 0)
+        self.SCISetMarginWidthN(0, width)
+        self.bFolding = GetEditorOption("Enable Folding", 1)
+        fold_flags = 0
+        self.SendScintilla(
+            scintillacon.SCI_SETMODEVENTMASK, scintillacon.SC_MOD_CHANGEFOLD
+        )
+        if self.bFolding:
+            if GetEditorOption("Fold Lines", 1):
+                fold_flags = 16
+
+        self.SCISetProperty("fold", self.bFolding)
+        self.SCISetFoldFlags(fold_flags)
+
+        tt_color = GetEditorOption("Tab Timmy Color", win32api.RGB(0xFF, 0, 0))
+        self.SendScintilla(scintillacon.SCI_INDICSETFORE, 1, tt_color)
+
+        tt_use = GetEditorOption("Use Tab Timmy", 1)
+        if tt_use:
+            self.SCISetProperty("tab.timmy.whinge.level", "1")
+
+        # Auto-indent has very complicated behaviour.  In a nutshell, the only
+        # way to get sensible behaviour from it is to ensure tabwidth != indentsize.
+        # Further, usetabs will only ever go from 1->0, never 0->1.
+        # This is _not_ the behaviour Pythonwin wants:
+        # * Tab width is arbitary, so should have no impact on smarts.
+        # * bUseTabs setting should reflect how new files are created, and
+        #   if Smart Tabs disabled, existing files are edited
+        # * If "Smart Tabs" is enabled, bUseTabs should have no bearing
+        #   for existing files (unless of course no context can be determined)
+        #
+        # So for smart tabs we configure the widget with completely dummy
+        # values (ensuring tabwidth != indentwidth), ask it to guess, then
+        # look at the values it has guessed, and re-configure
+        if bSmartTabs:
+            ext.config(usetabs=1, tabwidth=5, indentwidth=4)
+            ext.set_indentation_params(1)
+            if ext.indentwidth == 5:
+                # Either 5 literal spaces, or a single tab character. Assume a tab
+                usetabs = 1
+                indentwidth = tabSize
+            else:
+                # Either Indented with spaces, and indent size has been guessed or
+                # an empty file (or no context found - tough!)
+                if self.GetTextLength() == 0:  # emtpy
+                    usetabs = bUseTabs
+                    indentwidth = indentSize
+                else:  # guessed.
+                    indentwidth = ext.indentwidth
+                    usetabs = 0
+            # Tab size can never be guessed - set at user preference.
+            ext.config(usetabs=usetabs, indentwidth=indentwidth, tabwidth=tabSize)
+        else:
+            # Dont want smart-tabs - just set the options!
+            ext.config(usetabs=bUseTabs, tabwidth=tabSize, indentwidth=indentSize)
+        self.SCISetIndent(indentSize)
+        self.SCISetTabWidth(tabSize)
+
+    def OnDebuggerStateChange(self, state):
+        if state == dbgcon.DBGSTATE_NOT_DEBUGGING:
+            # Indicate breakpoints arent really usable.
+            # Not quite white - useful when no marker margin, so set as background color.
+            self.SCIMarkerSetBack(MARKER_BREAKPOINT, win32api.RGB(0xEF, 0xEF, 0xEF))
+        else:
+            # A light-red, so still readable when no marker margin.
+            self.SCIMarkerSetBack(MARKER_BREAKPOINT, win32api.RGB(0xFF, 0x80, 0x80))
+
+    def HookDocumentHandlers(self):
+        SyntEditViewParent.HookDocumentHandlers(self)
+        self.HookMessage(self.OnCheckExternalDocumentUpdated, MSG_CHECK_EXTERNAL_FILE)
+
+    def HookHandlers(self):
+        SyntEditViewParent.HookHandlers(self)
+        self.HookMessage(self.OnSetFocus, win32con.WM_SETFOCUS)
+
+    def _PrepareUserStateChange(self):
+        return self.GetSel(), self.GetFirstVisibleLine()
+
+    def _EndUserStateChange(self, info):
+        scrollOff = info[1] - self.GetFirstVisibleLine()
+        if scrollOff:
+            self.LineScroll(scrollOff)
+        # Make sure we dont reset the cursor beyond the buffer.
+        max = self.GetTextLength()
+        newPos = min(info[0][0], max), min(info[0][1], max)
+        self.SetSel(newPos)
+
+    #######################################
+    # The Windows Message or Notify handlers.
+    #######################################
+    def OnMarginClick(self, std, extra):
+        notify = self.SCIUnpackNotifyMessage(extra)
+        if notify.margin == 2:  # Our fold margin
+            line_click = self.LineFromChar(notify.position)
+            # 			max_line = self.GetLineCount()
+            if self.SCIGetFoldLevel(line_click) & scintillacon.SC_FOLDLEVELHEADERFLAG:
+                # If a fold point.
+                self.SCIToggleFold(line_click)
+        return 1
+
+    def OnSetFocus(self, msg):
+        # Even though we use file change notifications, we should be very sure about it here.
+        self.OnCheckExternalDocumentUpdated(msg)
+        return 1
+
+    def OnCheckExternalDocumentUpdated(self, msg):
+        if self.bCheckingFile:
+            return
+        self.bCheckingFile = 1
+        self.GetDocument().CheckExternalDocumentUpdated()
+        self.bCheckingFile = 0
+
+    def OnRClick(self, params):
+        menu = win32ui.CreatePopupMenu()
+        self.AppendMenu(menu, "&Locate module", "LocateModule")
+        self.AppendMenu(menu, flags=win32con.MF_SEPARATOR)
+        self.AppendMenu(menu, "&Undo", "EditUndo")
+        self.AppendMenu(menu, "&Redo", "EditRedo")
+        self.AppendMenu(menu, flags=win32con.MF_SEPARATOR)
+        self.AppendMenu(menu, "Cu&t", "EditCut")
+        self.AppendMenu(menu, "&Copy", "EditCopy")
+        self.AppendMenu(menu, "&Paste", "EditPaste")
+        self.AppendMenu(menu, flags=win32con.MF_SEPARATOR)
+        self.AppendMenu(menu, "&Select all", "EditSelectAll")
+        self.AppendMenu(
+            menu, "View &Whitespace", "ViewWhitespace", checked=self.SCIGetViewWS()
+        )
+        self.AppendMenu(
+            menu, "&Fixed Font", "ViewFixedFont", checked=self._GetColorizer().bUseFixed
+        )
+        self.AppendMenu(menu, flags=win32con.MF_SEPARATOR)
+        self.AppendMenu(menu, "&Goto line...", "GotoLine")
+
+        submenu = win32ui.CreatePopupMenu()
+        newitems = self.idle.GetMenuItems("edit")
+        for text, event in newitems:
+            self.AppendMenu(submenu, text, event)
+
+        flags = win32con.MF_STRING | win32con.MF_ENABLED | win32con.MF_POPUP
+        menu.AppendMenu(flags, submenu.GetHandle(), "&Source code")
+
+        flags = (
+            win32con.TPM_LEFTALIGN | win32con.TPM_LEFTBUTTON | win32con.TPM_RIGHTBUTTON
+        )
+        menu.TrackPopupMenu(params[5], flags, self)
+        return 0
+
+    def OnCmdViewFold(self, cid, code):  # Handle the menu command
+        if cid == win32ui.ID_VIEW_FOLD_EXPAND_ALL:
+            self.FoldExpandAllEvent(None)
+        elif cid == win32ui.ID_VIEW_FOLD_EXPAND:
+            self.FoldExpandEvent(None)
+        elif cid == win32ui.ID_VIEW_FOLD_COLLAPSE_ALL:
+            self.FoldCollapseAllEvent(None)
+        elif cid == win32ui.ID_VIEW_FOLD_COLLAPSE:
+            self.FoldCollapseEvent(None)
+        else:
+            print("Unknown collapse/expand ID")
+
+    def OnUpdateViewFold(self, cmdui):  # Update the tick on the UI.
+        if not self.bFolding:
+            cmdui.Enable(0)
+            return
+        id = cmdui.m_nID
+        if id in (win32ui.ID_VIEW_FOLD_EXPAND_ALL, win32ui.ID_VIEW_FOLD_COLLAPSE_ALL):
+            cmdui.Enable()
+        else:
+            enable = 0
+            lineno = self.LineFromChar(self.GetSel()[0])
+            foldable = (
+                self.SCIGetFoldLevel(lineno) & scintillacon.SC_FOLDLEVELHEADERFLAG
+            )
+            is_expanded = self.SCIGetFoldExpanded(lineno)
+            if id == win32ui.ID_VIEW_FOLD_EXPAND:
+                if foldable and not is_expanded:
+                    enable = 1
+            elif id == win32ui.ID_VIEW_FOLD_COLLAPSE:
+                if foldable and is_expanded:
+                    enable = 1
+            cmdui.Enable(enable)
+
+    def OnCmdViewFoldTopLevel(self, cid, code):  # Handle the menu command
+        self.FoldTopLevelEvent(None)
+
+    #######################################
+    # The Events
+    #######################################
+    def ToggleBookmarkEvent(self, event, pos=-1):
+        """Toggle a bookmark at the specified or current position"""
+        if pos == -1:
+            pos, end = self.GetSel()
+        startLine = self.LineFromChar(pos)
+        self.GetDocument().MarkerToggle(startLine + 1, MARKER_BOOKMARK)
+        return 0
+
+    def GotoNextBookmarkEvent(self, event, fromPos=-1):
+        """Move to the next bookmark"""
+        if fromPos == -1:
+            fromPos, end = self.GetSel()
+        startLine = self.LineFromChar(fromPos) + 1  # Zero based line to start
+        nextLine = self.GetDocument().MarkerGetNext(startLine + 1, MARKER_BOOKMARK) - 1
+        if nextLine < 0:
+            nextLine = self.GetDocument().MarkerGetNext(0, MARKER_BOOKMARK) - 1
+        if nextLine < 0 or nextLine == startLine - 1:
+            win32api.MessageBeep()
+        else:
+            self.SCIEnsureVisible(nextLine)
+            self.SCIGotoLine(nextLine)
+        return 0
+
+    def TabKeyEvent(self, event):
+        """Insert an indent.  If no selection, a single indent, otherwise a block indent"""
+        # Handle auto-complete first.
+        if self.SCIAutoCActive():
+            self.SCIAutoCComplete()
+            return 0
+        # Call the IDLE event.
+        return self.bindings.fire("<<smart-indent>>", event)
+
+    def EnterKeyEvent(self, event):
+        """Handle the enter key with special handling for auto-complete"""
+        # Handle auto-complete first.
+        if self.SCIAutoCActive():
+            self.SCIAutoCComplete()
+            self.SCIAutoCCancel()
+        # Call the IDLE event.
+        return self.bindings.fire("<<newline-and-indent>>", event)
+
+    def ShowInteractiveWindowEvent(self, event):
+        import pywin.framework.interact
+
+        pywin.framework.interact.ShowInteractiveWindow()
+
+    def FoldTopLevelEvent(self, event=None):
+        if not self.bFolding:
+            return 1
+
+        win32ui.DoWaitCursor(1)
+        try:
+            self.Colorize()
+            maxLine = self.GetLineCount()
+            # Find the first line, and check out its state.
+            for lineSeek in range(maxLine):
+                if self.SCIGetFoldLevel(lineSeek) & scintillacon.SC_FOLDLEVELHEADERFLAG:
+                    expanding = not self.SCIGetFoldExpanded(lineSeek)
+                    break
+            else:
+                # no folds here!
+                return
+            for lineSeek in range(lineSeek, maxLine):
+                level = self.SCIGetFoldLevel(lineSeek)
+                level_no = (
+                    level
+                    & scintillacon.SC_FOLDLEVELNUMBERMASK
+                    - scintillacon.SC_FOLDLEVELBASE
+                )
+                is_header = level & scintillacon.SC_FOLDLEVELHEADERFLAG
+                # 			print lineSeek, level_no, is_header
+                if level_no == 0 and is_header:
+                    if (expanding and not self.SCIGetFoldExpanded(lineSeek)) or (
+                        not expanding and self.SCIGetFoldExpanded(lineSeek)
+                    ):
+                        self.SCIToggleFold(lineSeek)
+        finally:
+            win32ui.DoWaitCursor(-1)
+
+    def FoldExpandSecondLevelEvent(self, event):
+        if not self.bFolding:
+            return 1
+        win32ui.DoWaitCursor(1)
+        ## I think this is needed since Scintilla may not have
+        ## already formatted parts of file outside visible window.
+        self.Colorize()
+        levels = [scintillacon.SC_FOLDLEVELBASE]
+        ## Scintilla's level number is based on amount of whitespace indentation
+        for lineno in range(self.GetLineCount()):
+            level = self.SCIGetFoldLevel(lineno)
+            if not level & scintillacon.SC_FOLDLEVELHEADERFLAG:
+                continue
+            curr_level = level & scintillacon.SC_FOLDLEVELNUMBERMASK
+            if curr_level > levels[-1]:
+                levels.append(curr_level)
+            try:
+                level_ind = levels.index(curr_level)
+            except ValueError:
+                ## probably syntax error in source file, bail
+                break
+            levels = levels[: level_ind + 1]
+            if level_ind == 1 and not self.SCIGetFoldExpanded(lineno):
+                self.SCIToggleFold(lineno)
+        win32ui.DoWaitCursor(-1)
+
+    def FoldCollapseSecondLevelEvent(self, event):
+        if not self.bFolding:
+            return 1
+        win32ui.DoWaitCursor(1)
+        ## I think this is needed since Scintilla may not have
+        ## already formatted parts of file outside visible window.
+        self.Colorize()
+        levels = [scintillacon.SC_FOLDLEVELBASE]
+        ## Scintilla's level number is based on amount of whitespace indentation
+        for lineno in range(self.GetLineCount()):
+            level = self.SCIGetFoldLevel(lineno)
+            if not level & scintillacon.SC_FOLDLEVELHEADERFLAG:
+                continue
+            curr_level = level & scintillacon.SC_FOLDLEVELNUMBERMASK
+            if curr_level > levels[-1]:
+                levels.append(curr_level)
+            try:
+                level_ind = levels.index(curr_level)
+            except ValueError:
+                ## probably syntax error in source file, bail
+                break
+            levels = levels[: level_ind + 1]
+            if level_ind == 1 and self.SCIGetFoldExpanded(lineno):
+                self.SCIToggleFold(lineno)
+        win32ui.DoWaitCursor(-1)
+
+    def FoldExpandEvent(self, event):
+        if not self.bFolding:
+            return 1
+        win32ui.DoWaitCursor(1)
+        lineno = self.LineFromChar(self.GetSel()[0])
+        if self.SCIGetFoldLevel(
+            lineno
+        ) & scintillacon.SC_FOLDLEVELHEADERFLAG and not self.SCIGetFoldExpanded(lineno):
+            self.SCIToggleFold(lineno)
+        win32ui.DoWaitCursor(-1)
+
+    def FoldExpandAllEvent(self, event):
+        if not self.bFolding:
+            return 1
+        win32ui.DoWaitCursor(1)
+        for lineno in range(0, self.GetLineCount()):
+            if self.SCIGetFoldLevel(
+                lineno
+            ) & scintillacon.SC_FOLDLEVELHEADERFLAG and not self.SCIGetFoldExpanded(
+                lineno
+            ):
+                self.SCIToggleFold(lineno)
+        win32ui.DoWaitCursor(-1)
+
+    def FoldCollapseEvent(self, event):
+        if not self.bFolding:
+            return 1
+        win32ui.DoWaitCursor(1)
+        lineno = self.LineFromChar(self.GetSel()[0])
+        if self.SCIGetFoldLevel(
+            lineno
+        ) & scintillacon.SC_FOLDLEVELHEADERFLAG and self.SCIGetFoldExpanded(lineno):
+            self.SCIToggleFold(lineno)
+        win32ui.DoWaitCursor(-1)
+
+    def FoldCollapseAllEvent(self, event):
+        if not self.bFolding:
+            return 1
+        win32ui.DoWaitCursor(1)
+        self.Colorize()
+        for lineno in range(0, self.GetLineCount()):
+            if self.SCIGetFoldLevel(
+                lineno
+            ) & scintillacon.SC_FOLDLEVELHEADERFLAG and self.SCIGetFoldExpanded(lineno):
+                self.SCIToggleFold(lineno)
+        win32ui.DoWaitCursor(-1)
+
+
+from pywin.framework.editor.frame import EditorFrame
+
+
+class SplitterFrame(EditorFrame):
+    def OnCreate(self, cs):
+        self.HookCommand(self.OnWindowSplit, win32ui.ID_WINDOW_SPLIT)
+        return 1
+
+    def OnWindowSplit(self, id, code):
+        self.GetDlgItem(win32ui.AFX_IDW_PANE_FIRST).DoKeyboardSplit()
+        return 1
+
+
+from pywin.framework.editor.template import EditorTemplateBase
+
+
+class SyntEditTemplate(EditorTemplateBase):
+    def __init__(
+        self, res=win32ui.IDR_TEXTTYPE, makeDoc=None, makeFrame=None, makeView=None
+    ):
+        if makeDoc is None:
+            makeDoc = SyntEditDocument
+        if makeView is None:
+            makeView = SyntEditView
+        if makeFrame is None:
+            makeFrame = SplitterFrame
+        self.bSetMenus = 0
+        EditorTemplateBase.__init__(self, res, makeDoc, makeFrame, makeView)
+
+    def CheckIDLEMenus(self, idle):
+        if self.bSetMenus:
+            return
+        self.bSetMenus = 1
+
+        submenu = win32ui.CreatePopupMenu()
+        newitems = idle.GetMenuItems("edit")
+        flags = win32con.MF_STRING | win32con.MF_ENABLED
+        for text, event in newitems:
+            id = bindings.event_to_commands.get(event)
+            if id is not None:
+                keyname = pywin.scintilla.view.configManager.get_key_binding(
+                    event, ["editor"]
+                )
+                if keyname is not None:
+                    text = text + "\t" + keyname
+                submenu.AppendMenu(flags, id, text)
+
+        mainMenu = self.GetSharedMenu()
+        editMenu = mainMenu.GetSubMenu(1)
+        editMenu.AppendMenu(win32con.MF_SEPARATOR, 0, "")
+        editMenu.AppendMenu(
+            win32con.MF_STRING | win32con.MF_POPUP | win32con.MF_ENABLED,
+            submenu.GetHandle(),
+            "&Source Code",
+        )
+
+    def _CreateDocTemplate(self, resourceId):
+        return win32ui.CreateDocTemplate(resourceId)
+
+    def CreateWin32uiDocument(self):
+        return self.DoCreateDoc()
+
+    def GetPythonPropertyPages(self):
+        """Returns a list of property pages"""
+        from pywin.scintilla import configui
+
+        return EditorTemplateBase.GetPythonPropertyPages(self) + [
+            configui.ScintillaFormatPropertyPage()
+        ]
+
+
+# For debugging purposes, when this module may be reloaded many times.
+try:
+    win32ui.GetApp().RemoveDocTemplate(editorTemplate)
+except NameError:
+    pass
+
+editorTemplate = SyntEditTemplate()
+win32ui.GetApp().AddDocTemplate(editorTemplate)
diff --git a/lib/pythonwin/pywin/framework/editor/configui.py b/lib/pythonwin/pywin/framework/editor/configui.py
new file mode 100644
index 00000000..903ad66c
--- /dev/null
+++ b/lib/pythonwin/pywin/framework/editor/configui.py
@@ -0,0 +1,308 @@
+import pywin.scintilla.config
+import win32api
+import win32con
+import win32ui
+from pywin.framework.editor import (
+    DeleteEditorOption,
+    GetEditorFontOption,
+    GetEditorOption,
+    SetEditorFontOption,
+    SetEditorOption,
+    defaultCharacterFormat,
+    editorTemplate,
+)
+from pywin.mfc import dialog
+
+from . import document
+
+# The standard 16 color VGA palette should always be possible
+paletteVGA = (
+    ("Black", 0, 0, 0),
+    ("Navy", 0, 0, 128),
+    ("Green", 0, 128, 0),
+    ("Cyan", 0, 128, 128),
+    ("Maroon", 128, 0, 0),
+    ("Purple", 128, 0, 128),
+    ("Olive", 128, 128, 0),
+    ("Gray", 128, 128, 128),
+    ("Silver", 192, 192, 192),
+    ("Blue", 0, 0, 255),
+    ("Lime", 0, 255, 0),
+    ("Aqua", 0, 255, 255),
+    ("Red", 255, 0, 0),
+    ("Fuchsia", 255, 0, 255),
+    ("Yellow", 255, 255, 0),
+    ("White", 255, 255, 255),
+)
+
+
+######################################################
+#
+# Property Page for editor options
+#
+class EditorPropertyPage(dialog.PropertyPage):
+    def __init__(self):
+        dialog.PropertyPage.__init__(self, win32ui.IDD_PP_EDITOR)
+        self.autooptions = []
+        self._AddEditorOption(win32ui.IDC_AUTO_RELOAD, "i", "Auto Reload", 1)
+        self._AddEditorOption(
+            win32ui.IDC_COMBO1, "i", "Backup Type", document.BAK_DOT_BAK_BAK_DIR
+        )
+        self._AddEditorOption(
+            win32ui.IDC_AUTOCOMPLETE, "i", "Autocomplete Attributes", 1
+        )
+        self._AddEditorOption(win32ui.IDC_CALLTIPS, "i", "Show Call Tips", 1)
+        self._AddEditorOption(
+            win32ui.IDC_MARGIN_LINENUMBER, "i", "Line Number Margin Width", 0
+        )
+        self._AddEditorOption(win32ui.IDC_RADIO1, "i", "MarkersInMargin", None)
+        self._AddEditorOption(
+            win32ui.IDC_MARGIN_MARKER, "i", "Marker Margin Width", None
+        )
+        self["Marker Margin Width"] = GetEditorOption("Marker Margin Width", 16)
+
+        # Folding
+        self._AddEditorOption(win32ui.IDC_MARGIN_FOLD, "i", "Fold Margin Width", 12)
+        self._AddEditorOption(win32ui.IDC_FOLD_ENABLE, "i", "Enable Folding", 1)
+        self._AddEditorOption(win32ui.IDC_FOLD_ON_OPEN, "i", "Fold On Open", 0)
+        self._AddEditorOption(win32ui.IDC_FOLD_SHOW_LINES, "i", "Fold Lines", 1)
+
+        # Right edge.
+        self._AddEditorOption(
+            win32ui.IDC_RIGHTEDGE_ENABLE, "i", "Right Edge Enabled", 0
+        )
+        self._AddEditorOption(
+            win32ui.IDC_RIGHTEDGE_COLUMN, "i", "Right Edge Column", 75
+        )
+
+        # Source control, etc
+        self.AddDDX(win32ui.IDC_VSS_INTEGRATE, "bVSS")
+        self.AddDDX(win32ui.IDC_KEYBOARD_CONFIG, "Configs", "l")
+        self["Configs"] = pywin.scintilla.config.find_config_files()
+
+    def _AddEditorOption(self, idd, typ, optionName, defaultVal):
+        self.AddDDX(idd, optionName, typ)
+        # some options are "derived" - ie, can be implied from others
+        # (eg, "view markers in background" is implied from "markerMarginWidth==0"
+        # So we don't actually store these values, but they do still get DDX support.
+        if defaultVal is not None:
+            self[optionName] = GetEditorOption(optionName, defaultVal)
+            self.autooptions.append((optionName, defaultVal))
+
+    def OnInitDialog(self):
+        for name, val in self.autooptions:
+            self[name] = GetEditorOption(name, val)
+
+        # Note that these MUST be in the same order as the BAK constants.
+        cbo = self.GetDlgItem(win32ui.IDC_COMBO1)
+        cbo.AddString("None")
+        cbo.AddString(".BAK File")
+        cbo.AddString("TEMP dir")
+        cbo.AddString("Own dir")
+
+        # Source Safe
+        bVSS = (
+            GetEditorOption("Source Control Module", "") == "pywin.framework.editor.vss"
+        )
+        self["bVSS"] = bVSS
+
+        edit = self.GetDlgItem(win32ui.IDC_RIGHTEDGE_SAMPLE)
+        edit.SetWindowText("Sample Color")
+
+        rc = dialog.PropertyPage.OnInitDialog(self)
+
+        try:
+            self.GetDlgItem(win32ui.IDC_KEYBOARD_CONFIG).SelectString(
+                -1, GetEditorOption("Keyboard Config", "default")
+            )
+        except win32ui.error:
+            import traceback
+
+            traceback.print_exc()
+            pass
+
+        self.HookCommand(self.OnButSimple, win32ui.IDC_FOLD_ENABLE)
+        self.HookCommand(self.OnButSimple, win32ui.IDC_RADIO1)
+        self.HookCommand(self.OnButSimple, win32ui.IDC_RADIO2)
+        self.HookCommand(self.OnButSimple, win32ui.IDC_RIGHTEDGE_ENABLE)
+        self.HookCommand(self.OnButEdgeColor, win32ui.IDC_RIGHTEDGE_DEFINE)
+
+        butMarginEnabled = self["Marker Margin Width"] > 0
+        self.GetDlgItem(win32ui.IDC_RADIO1).SetCheck(butMarginEnabled)
+        self.GetDlgItem(win32ui.IDC_RADIO2).SetCheck(not butMarginEnabled)
+
+        self.edgeColor = self.initialEdgeColor = GetEditorOption(
+            "Right Edge Color", win32api.RGB(0xEF, 0xEF, 0xEF)
+        )
+        for spinner_id in (win32ui.IDC_SPIN1, win32ui.IDC_SPIN2, win32ui.IDC_SPIN3):
+            spinner = self.GetDlgItem(spinner_id)
+            spinner.SetRange(0, 100)
+        self.UpdateUIForState()
+
+        return rc
+
+    def OnButSimple(self, id, code):
+        if code == win32con.BN_CLICKED:
+            self.UpdateUIForState()
+
+    def OnButEdgeColor(self, id, code):
+        if code == win32con.BN_CLICKED:
+            d = win32ui.CreateColorDialog(self.edgeColor, 0, self)
+            # Ensure the current color is a custom color (as it may not be in the swatch)
+            # plus some other nice gray scales.
+            ccs = [self.edgeColor]
+            for c in range(0xEF, 0x4F, -0x10):
+                ccs.append(win32api.RGB(c, c, c))
+            d.SetCustomColors(ccs)
+            if d.DoModal() == win32con.IDOK:
+                self.edgeColor = d.GetColor()
+                self.UpdateUIForState()
+
+    def UpdateUIForState(self):
+        folding = self.GetDlgItem(win32ui.IDC_FOLD_ENABLE).GetCheck()
+        self.GetDlgItem(win32ui.IDC_FOLD_ON_OPEN).EnableWindow(folding)
+        self.GetDlgItem(win32ui.IDC_FOLD_SHOW_LINES).EnableWindow(folding)
+
+        widthEnabled = self.GetDlgItem(win32ui.IDC_RADIO1).GetCheck()
+        self.GetDlgItem(win32ui.IDC_MARGIN_MARKER).EnableWindow(widthEnabled)
+        self.UpdateData()  # Ensure self[] is up to date with the control data.
+        if widthEnabled and self["Marker Margin Width"] == 0:
+            self["Marker Margin Width"] = 16
+            self.UpdateData(0)  # Ensure control up to date with self[]
+
+        # Right edge
+        edgeEnabled = self.GetDlgItem(win32ui.IDC_RIGHTEDGE_ENABLE).GetCheck()
+        self.GetDlgItem(win32ui.IDC_RIGHTEDGE_COLUMN).EnableWindow(edgeEnabled)
+        self.GetDlgItem(win32ui.IDC_RIGHTEDGE_SAMPLE).EnableWindow(edgeEnabled)
+        self.GetDlgItem(win32ui.IDC_RIGHTEDGE_DEFINE).EnableWindow(edgeEnabled)
+
+        edit = self.GetDlgItem(win32ui.IDC_RIGHTEDGE_SAMPLE)
+        edit.SetBackgroundColor(0, self.edgeColor)
+
+    def OnOK(self):
+        for name, defVal in self.autooptions:
+            SetEditorOption(name, self[name])
+        # Margin width gets handled differently.
+        if self["MarkersInMargin"] == 0:
+            SetEditorOption("Marker Margin Width", self["Marker Margin Width"])
+        else:
+            SetEditorOption("Marker Margin Width", 0)
+        if self.edgeColor != self.initialEdgeColor:
+            SetEditorOption("Right Edge Color", self.edgeColor)
+        if self["bVSS"]:
+            SetEditorOption("Source Control Module", "pywin.framework.editor.vss")
+        else:
+            if (
+                GetEditorOption("Source Control Module", "")
+                == "pywin.framework.editor.vss"
+            ):
+                SetEditorOption("Source Control Module", "")
+        # Keyboard config
+        configname = self.GetDlgItem(win32ui.IDC_KEYBOARD_CONFIG).GetWindowText()
+        if configname:
+            if configname == "default":
+                DeleteEditorOption("Keyboard Config")
+            else:
+                SetEditorOption("Keyboard Config", configname)
+
+            import pywin.scintilla.view
+
+            pywin.scintilla.view.LoadConfiguration()
+
+        # Now tell all views we have changed.
+        ##		for doc in editorTemplate.GetDocumentList():
+        ##			for view in doc.GetAllViews():
+        ##				try:
+        ##					fn = view.OnConfigChange
+        ##				except AttributeError:
+        ##					continue
+        ##				fn()
+        return 1
+
+
+class EditorWhitespacePropertyPage(dialog.PropertyPage):
+    def __init__(self):
+        dialog.PropertyPage.__init__(self, win32ui.IDD_PP_TABS)
+        self.autooptions = []
+        self._AddEditorOption(win32ui.IDC_TAB_SIZE, "i", "Tab Size", 4)
+        self._AddEditorOption(win32ui.IDC_INDENT_SIZE, "i", "Indent Size", 4)
+        self._AddEditorOption(win32ui.IDC_USE_SMART_TABS, "i", "Smart Tabs", 1)
+        self._AddEditorOption(win32ui.IDC_VIEW_WHITESPACE, "i", "View Whitespace", 0)
+        self._AddEditorOption(win32ui.IDC_VIEW_EOL, "i", "View EOL", 0)
+        self._AddEditorOption(
+            win32ui.IDC_VIEW_INDENTATIONGUIDES, "i", "View Indentation Guides", 0
+        )
+
+    def _AddEditorOption(self, idd, typ, optionName, defaultVal):
+        self.AddDDX(idd, optionName, typ)
+        self[optionName] = GetEditorOption(optionName, defaultVal)
+        self.autooptions.append((optionName, defaultVal))
+
+    def OnInitDialog(self):
+        for name, val in self.autooptions:
+            self[name] = GetEditorOption(name, val)
+
+        rc = dialog.PropertyPage.OnInitDialog(self)
+
+        idc = win32ui.IDC_TABTIMMY_NONE
+        if GetEditorOption("Use Tab Timmy", 1):
+            idc = win32ui.IDC_TABTIMMY_IND
+        self.GetDlgItem(idc).SetCheck(1)
+
+        idc = win32ui.IDC_RADIO1
+        if GetEditorOption("Use Tabs", 0):
+            idc = win32ui.IDC_USE_TABS
+        self.GetDlgItem(idc).SetCheck(1)
+
+        tt_color = GetEditorOption("Tab Timmy Color", win32api.RGB(0xFF, 0, 0))
+        self.cbo = self.GetDlgItem(win32ui.IDC_COMBO1)
+        for c in paletteVGA:
+            self.cbo.AddString(c[0])
+        sel = 0
+        for c in paletteVGA:
+            if tt_color == win32api.RGB(c[1], c[2], c[3]):
+                break
+            sel = sel + 1
+        else:
+            sel = -1
+        self.cbo.SetCurSel(sel)
+        self.HookCommand(self.OnButSimple, win32ui.IDC_TABTIMMY_NONE)
+        self.HookCommand(self.OnButSimple, win32ui.IDC_TABTIMMY_IND)
+        self.HookCommand(self.OnButSimple, win32ui.IDC_TABTIMMY_BG)
+        # Set ranges for the spinners.
+        for spinner_id in [win32ui.IDC_SPIN1, win32ui.IDC_SPIN2]:
+            spinner = self.GetDlgItem(spinner_id)
+            spinner.SetRange(1, 16)
+        return rc
+
+    def OnButSimple(self, id, code):
+        if code == win32con.BN_CLICKED:
+            self.UpdateUIForState()
+
+    def UpdateUIForState(self):
+        timmy = self.GetDlgItem(win32ui.IDC_TABTIMMY_NONE).GetCheck()
+        self.GetDlgItem(win32ui.IDC_COMBO1).EnableWindow(not timmy)
+
+    def OnOK(self):
+        for name, defVal in self.autooptions:
+            SetEditorOption(name, self[name])
+
+        SetEditorOption("Use Tabs", self.GetDlgItem(win32ui.IDC_USE_TABS).GetCheck())
+
+        SetEditorOption(
+            "Use Tab Timmy", self.GetDlgItem(win32ui.IDC_TABTIMMY_IND).GetCheck()
+        )
+        c = paletteVGA[self.cbo.GetCurSel()]
+        SetEditorOption("Tab Timmy Color", win32api.RGB(c[1], c[2], c[3]))
+
+        return 1
+
+
+def testpp():
+    ps = dialog.PropertySheet("Editor Options")
+    ps.AddPage(EditorWhitespacePropertyPage())
+    ps.DoModal()
+
+
+if __name__ == "__main__":
+    testpp()
diff --git a/lib/pythonwin/pywin/framework/editor/document.py b/lib/pythonwin/pywin/framework/editor/document.py
new file mode 100644
index 00000000..e66947b8
--- /dev/null
+++ b/lib/pythonwin/pywin/framework/editor/document.py
@@ -0,0 +1,378 @@
+# We no longer support the old, non-colour editor!
+
+import os
+import shutil
+import traceback
+
+import win32api
+import win32con
+import win32ui
+from pywin.framework.editor import GetEditorOption
+from pywin.mfc import docview, object
+
+BAK_NONE = 0
+BAK_DOT_BAK = 1
+BAK_DOT_BAK_TEMP_DIR = 2
+BAK_DOT_BAK_BAK_DIR = 3
+
+MSG_CHECK_EXTERNAL_FILE = (
+    win32con.WM_USER + 1999
+)  ## WARNING: Duplicated in editor.py and coloreditor.py
+
+import pywin.scintilla.document
+
+ParentEditorDocument = pywin.scintilla.document.CScintillaDocument
+
+
+class EditorDocumentBase(ParentEditorDocument):
+    def __init__(self, template):
+        self.bAutoReload = GetEditorOption("Auto Reload", 1)
+        self.bDeclinedReload = 0  # Has the user declined to reload.
+        self.fileStat = None
+        self.bReportedFileNotFound = 0
+
+        # what sort of bak file should I create.
+        # default to write to %temp%/bak/filename.ext
+        self.bakFileType = GetEditorOption("Backup Type", BAK_DOT_BAK_BAK_DIR)
+
+        self.watcherThread = FileWatchingThread(self)
+        self.watcherThread.CreateThread()
+        # Should I try and use VSS integration?
+        self.scModuleName = GetEditorOption("Source Control Module", "")
+        self.scModule = None  # Loaded when first used.
+        ParentEditorDocument.__init__(self, template, template.CreateWin32uiDocument())
+
+    def OnCloseDocument(self):
+        self.watcherThread.SignalStop()
+        return self._obj_.OnCloseDocument()
+
+    # 	def OnOpenDocument(self, name):
+    # 		rc = ParentEditorDocument.OnOpenDocument(self, name)
+    # 		self.GetFirstView()._SetLoadedText(self.text)
+    # 		self._DocumentStateChanged()
+    # 		return rc
+
+    def OnSaveDocument(self, fileName):
+        win32ui.SetStatusText("Saving file...", 1)
+        # rename to bak if required.
+        dir, basename = os.path.split(fileName)
+        if self.bakFileType == BAK_DOT_BAK:
+            bakFileName = dir + "\\" + os.path.splitext(basename)[0] + ".bak"
+        elif self.bakFileType == BAK_DOT_BAK_TEMP_DIR:
+            bakFileName = (
+                win32api.GetTempPath() + "\\" + os.path.splitext(basename)[0] + ".bak"
+            )
+        elif self.bakFileType == BAK_DOT_BAK_BAK_DIR:
+            tempPath = os.path.join(win32api.GetTempPath(), "bak")
+            try:
+                os.mkdir(tempPath, 0)
+            except os.error:
+                pass
+            bakFileName = os.path.join(tempPath, basename)
+        try:
+            os.unlink(bakFileName)  # raise NameError if no bakups wanted.
+        except (os.error, NameError):
+            pass
+        try:
+            # Do a copy as it might be on different volumes,
+            # and the file may be a hard-link, causing the link
+            # to follow the backup.
+            shutil.copy2(fileName, bakFileName)
+        except (os.error, NameError, IOError):
+            pass
+        try:
+            self.SaveFile(fileName)
+        except IOError as details:
+            win32ui.MessageBox("Error - could not save file\r\n\r\n%s" % details)
+            return 0
+        except (UnicodeEncodeError, LookupError) as details:
+            rc = win32ui.MessageBox(
+                "Encoding failed: \r\n%s" % details
+                + "\r\nPlease add desired source encoding as first line of file, eg \r\n"
+                + "# -*- coding: mbcs -*-\r\n\r\n"
+                + "If you continue, the file will be saved as binary and will\r\n"
+                + "not be valid in the declared encoding.\r\n\r\n"
+                + "Save the file as binary with an invalid encoding?",
+                "File save failed",
+                win32con.MB_YESNO | win32con.MB_DEFBUTTON2,
+            )
+            if rc == win32con.IDYES:
+                try:
+                    self.SaveFile(fileName, encoding="latin-1")
+                except IOError as details:
+                    win32ui.MessageBox(
+                        "Error - could not save file\r\n\r\n%s" % details
+                    )
+                    return 0
+            else:
+                return 0
+        self.SetModifiedFlag(0)  # No longer dirty
+        self.bDeclinedReload = 0  # They probably want to know if it changes again!
+        win32ui.AddToRecentFileList(fileName)
+        self.SetPathName(fileName)
+        win32ui.SetStatusText("Ready")
+        self._DocumentStateChanged()
+        return 1
+
+    def FinalizeViewCreation(self, view):
+        ParentEditorDocument.FinalizeViewCreation(self, view)
+        if view == self.GetFirstView():
+            self._DocumentStateChanged()
+            if view.bFolding and GetEditorOption("Fold On Open", 0):
+                view.FoldTopLevelEvent()
+
+    def HookViewNotifications(self, view):
+        ParentEditorDocument.HookViewNotifications(self, view)
+
+    # Support for reloading the document from disk - presumably after some
+    # external application has modified it (or possibly source control has
+    # checked it out.
+    def ReloadDocument(self):
+        """Reloads the document from disk.  Assumes the file has
+        been saved and user has been asked if necessary - it just does it!
+        """
+        win32ui.SetStatusText("Reloading document.  Please wait...", 1)
+        self.SetModifiedFlag(0)
+        # Loop over all views, saving their state, then reload the document
+        views = self.GetAllViews()
+        states = []
+        for view in views:
+            try:
+                info = view._PrepareUserStateChange()
+            except AttributeError:  # Not our editor view?
+                info = None
+            states.append(info)
+        self.OnOpenDocument(self.GetPathName())
+        for view, info in zip(views, states):
+            if info is not None:
+                view._EndUserStateChange(info)
+        self._DocumentStateChanged()
+        win32ui.SetStatusText("Document reloaded.")
+
+    # Reloading the file
+    def CheckExternalDocumentUpdated(self):
+        if self.bDeclinedReload or not self.GetPathName():
+            return
+        try:
+            newstat = os.stat(self.GetPathName())
+        except os.error as exc:
+            if not self.bReportedFileNotFound:
+                print(
+                    "The file '%s' is open for editing, but\nchecking it for changes caused the error: %s"
+                    % (self.GetPathName(), exc.strerror)
+                )
+                self.bReportedFileNotFound = 1
+            return
+        if self.bReportedFileNotFound:
+            print(
+                "The file '%s' has re-appeared - continuing to watch for changes..."
+                % (self.GetPathName(),)
+            )
+            self.bReportedFileNotFound = (
+                0  # Once found again we want to start complaining.
+            )
+        changed = (
+            (self.fileStat is None)
+            or self.fileStat[0] != newstat[0]
+            or self.fileStat[6] != newstat[6]
+            or self.fileStat[8] != newstat[8]
+            or self.fileStat[9] != newstat[9]
+        )
+        if changed:
+            question = None
+            if self.IsModified():
+                question = (
+                    "%s\r\n\r\nThis file has been modified outside of the source editor.\r\nDo you want to reload it and LOSE THE CHANGES in the source editor?"
+                    % self.GetPathName()
+                )
+                mbStyle = win32con.MB_YESNO | win32con.MB_DEFBUTTON2  # Default to "No"
+            else:
+                if not self.bAutoReload:
+                    question = (
+                        "%s\r\n\r\nThis file has been modified outside of the source editor.\r\nDo you want to reload it?"
+                        % self.GetPathName()
+                    )
+                    mbStyle = win32con.MB_YESNO  # Default to "Yes"
+            if question:
+                rc = win32ui.MessageBox(question, None, mbStyle)
+                if rc != win32con.IDYES:
+                    self.bDeclinedReload = 1
+                    return
+            self.ReloadDocument()
+
+    def _DocumentStateChanged(self):
+        """Called whenever the documents state (on disk etc) has been changed
+        by the editor (eg, as the result of a save operation)
+        """
+        if self.GetPathName():
+            try:
+                self.fileStat = os.stat(self.GetPathName())
+            except os.error:
+                self.fileStat = None
+        else:
+            self.fileStat = None
+        self.watcherThread._DocumentStateChanged()
+        self._UpdateUIForState()
+        self._ApplyOptionalToViews("_UpdateUIForState")
+        self._ApplyOptionalToViews("SetReadOnly", self._IsReadOnly())
+        self._ApplyOptionalToViews("SCISetSavePoint")
+        # Allow the debugger to reset us too.
+        import pywin.debugger
+
+        if pywin.debugger.currentDebugger is not None:
+            pywin.debugger.currentDebugger.UpdateDocumentLineStates(self)
+
+    # Read-only document support - make it obvious to the user
+    # that the file is read-only.
+    def _IsReadOnly(self):
+        return self.fileStat is not None and (self.fileStat[0] & 128) == 0
+
+    def _UpdateUIForState(self):
+        """Change the title to reflect the state of the document -
+        eg ReadOnly, Dirty, etc
+        """
+        filename = self.GetPathName()
+        if not filename:
+            return  # New file - nothing to do
+        try:
+            # This seems necessary so the internal state of the window becomes
+            # "visible".  without it, it is still shown, but certain functions
+            # (such as updating the title) dont immediately work?
+            self.GetFirstView().ShowWindow(win32con.SW_SHOW)
+            title = win32ui.GetFileTitle(filename)
+        except win32ui.error:
+            title = filename
+        if self._IsReadOnly():
+            title = title + " (read-only)"
+        self.SetTitle(title)
+
+    def MakeDocumentWritable(self):
+        pretend_ss = 0  # Set to 1 to test this without source safe :-)
+        if not self.scModuleName and not pretend_ss:  # No Source Control support.
+            win32ui.SetStatusText(
+                "Document is read-only, and no source-control system is configured"
+            )
+            win32api.MessageBeep()
+            return 0
+
+        # We have source control support - check if the user wants to use it.
+        msg = "Would you like to check this file out?"
+        defButton = win32con.MB_YESNO
+        if self.IsModified():
+            msg = msg + "\r\n\r\nALL CHANGES IN THE EDITOR WILL BE LOST"
+            defButton = win32con.MB_YESNO
+        if win32ui.MessageBox(msg, None, defButton) != win32con.IDYES:
+            return 0
+
+        if pretend_ss:
+            print("We are only pretending to check it out!")
+            win32api.SetFileAttributes(
+                self.GetPathName(), win32con.FILE_ATTRIBUTE_NORMAL
+            )
+            self.ReloadDocument()
+            return 1
+
+        # Now call on the module to do it.
+        if self.scModule is None:
+            try:
+                self.scModule = __import__(self.scModuleName)
+                for part in self.scModuleName.split(".")[1:]:
+                    self.scModule = getattr(self.scModule, part)
+            except:
+                traceback.print_exc()
+                print("Error loading source control module.")
+                return 0
+
+        if self.scModule.CheckoutFile(self.GetPathName()):
+            self.ReloadDocument()
+            return 1
+        return 0
+
+    def CheckMakeDocumentWritable(self):
+        if self._IsReadOnly():
+            return self.MakeDocumentWritable()
+        return 1
+
+    def SaveModified(self):
+        # Called as the document is closed.  If we are about
+        # to prompt for a save, bring the document to the foreground.
+        if self.IsModified():
+            frame = self.GetFirstView().GetParentFrame()
+            try:
+                frame.MDIActivate()
+                frame.AutoRestore()
+            except:
+                print("Could not bring document to foreground")
+        return self._obj_.SaveModified()
+
+
+# NOTE - I DONT use the standard threading module,
+# as this waits for all threads to terminate at shutdown.
+# When using the debugger, it is possible shutdown will
+# occur without Pythonwin getting a complete shutdown,
+# so we deadlock at the end - threading is waiting for
+import pywin.mfc.thread
+import win32event
+
+
+class FileWatchingThread(pywin.mfc.thread.WinThread):
+    def __init__(self, doc):
+        self.doc = doc
+        self.adminEvent = win32event.CreateEvent(None, 0, 0, None)
+        self.stopEvent = win32event.CreateEvent(None, 0, 0, None)
+        self.watchEvent = None
+        pywin.mfc.thread.WinThread.__init__(self)
+
+    def _DocumentStateChanged(self):
+        win32event.SetEvent(self.adminEvent)
+
+    def RefreshEvent(self):
+        self.hwnd = self.doc.GetFirstView().GetSafeHwnd()
+        if self.watchEvent is not None:
+            win32api.FindCloseChangeNotification(self.watchEvent)
+            self.watchEvent = None
+        path = self.doc.GetPathName()
+        if path:
+            path = os.path.dirname(path)
+        if path:
+            filter = (
+                win32con.FILE_NOTIFY_CHANGE_FILE_NAME
+                | win32con.FILE_NOTIFY_CHANGE_ATTRIBUTES
+                | win32con.FILE_NOTIFY_CHANGE_LAST_WRITE
+            )
+            try:
+                self.watchEvent = win32api.FindFirstChangeNotification(path, 0, filter)
+            except win32api.error as exc:
+                print("Can not watch file", path, "for changes -", exc.strerror)
+
+    def SignalStop(self):
+        win32event.SetEvent(self.stopEvent)
+
+    def Run(self):
+        while 1:
+            handles = [self.stopEvent, self.adminEvent]
+            if self.watchEvent is not None:
+                handles.append(self.watchEvent)
+            rc = win32event.WaitForMultipleObjects(handles, 0, win32event.INFINITE)
+            if rc == win32event.WAIT_OBJECT_0:
+                break
+            elif rc == win32event.WAIT_OBJECT_0 + 1:
+                self.RefreshEvent()
+            else:
+                win32api.PostMessage(self.hwnd, MSG_CHECK_EXTERNAL_FILE, 0, 0)
+                try:
+                    # If the directory has been removed underneath us, we get this error.
+                    win32api.FindNextChangeNotification(self.watchEvent)
+                except win32api.error as exc:
+                    print(
+                        "Can not watch file",
+                        self.doc.GetPathName(),
+                        "for changes -",
+                        exc.strerror,
+                    )
+                    break
+
+        # close a circular reference
+        self.doc = None
+        if self.watchEvent:
+            win32api.FindCloseChangeNotification(self.watchEvent)
diff --git a/lib/pythonwin/pywin/framework/editor/editor.py b/lib/pythonwin/pywin/framework/editor/editor.py
new file mode 100644
index 00000000..aa1f5385
--- /dev/null
+++ b/lib/pythonwin/pywin/framework/editor/editor.py
@@ -0,0 +1,516 @@
+#####################################################################
+#
+# editor.py
+#
+# A general purpose text editor, built on top of the win32ui edit
+# type, which is built on an MFC CEditView
+#
+#
+# We now support reloading of externally modified documented
+# (eg, presumably by some other process, such as source control or
+# another editor.
+# We also suport auto-loading of externally modified files.
+# - if the current document has not been modified in this
+# editor, but has been modified on disk, then the file
+# can be automatically reloaded.
+#
+# Note that it will _always_ prompt you if the file in the editor has been modified.
+
+
+import re
+
+import regex
+import win32api
+import win32con
+import win32ui
+from pywin.framework.editor import (
+    GetEditorFontOption,
+    GetEditorOption,
+    SetEditorFontOption,
+    SetEditorOption,
+    defaultCharacterFormat,
+)
+from pywin.mfc import afxres, dialog, docview
+
+patImport = regex.symcomp("import \(<name>.*\)")
+patIndent = regex.compile("^\\([ \t]*[~ \t]\\)")
+
+ID_LOCATE_FILE = 0xE200
+ID_GOTO_LINE = 0xE2001
+MSG_CHECK_EXTERNAL_FILE = (
+    win32con.WM_USER + 1999
+)  ## WARNING: Duplicated in document.py and coloreditor.py
+
+# Key Codes that modify the bufffer when Ctrl or Alt are NOT pressed.
+MODIFYING_VK_KEYS = [
+    win32con.VK_BACK,
+    win32con.VK_TAB,
+    win32con.VK_RETURN,
+    win32con.VK_SPACE,
+    win32con.VK_DELETE,
+]
+for k in range(48, 91):
+    MODIFYING_VK_KEYS.append(k)
+
+# Key Codes that modify the bufffer when Ctrl is pressed.
+MODIFYING_VK_KEYS_CTRL = [
+    win32con.VK_BACK,
+    win32con.VK_RETURN,
+    win32con.VK_SPACE,
+    win32con.VK_DELETE,
+]
+
+# Key Codes that modify the bufffer when Alt is pressed.
+MODIFYING_VK_KEYS_ALT = [
+    win32con.VK_BACK,
+    win32con.VK_RETURN,
+    win32con.VK_SPACE,
+    win32con.VK_DELETE,
+]
+
+
+# The editor itself starts here.
+# Using the MFC Document/View model, we have an EditorDocument, which is responsible for
+# managing the contents of the file, and a view which is responsible for rendering it.
+#
+# Due to a limitation in the Windows edit controls, we are limited to one view
+# per document, although nothing in this code assumes this (I hope!)
+
+isRichText = 1  # We are using the Rich Text control.  This has not been tested with value "0" for quite some time!
+
+# ParentEditorDocument=docview.Document
+from .document import EditorDocumentBase
+
+ParentEditorDocument = EditorDocumentBase
+
+
+class EditorDocument(ParentEditorDocument):
+    #
+    # File loading and saving operations
+    #
+    def OnOpenDocument(self, filename):
+        #
+        # handle Unix and PC text file format.
+        #
+
+        # Get the "long name" of the file name, as it may have been translated
+        # to short names by the shell.
+        self.SetPathName(filename)  # Must set this early!
+        # Now do the work!
+        self.BeginWaitCursor()
+        win32ui.SetStatusText("Loading file...", 1)
+        try:
+            f = open(filename, "rb")
+        except IOError:
+            win32ui.MessageBox(
+                filename
+                + "\nCan not find this file\nPlease verify that the correct path and file name are given"
+            )
+            self.EndWaitCursor()
+            return 0
+        raw = f.read()
+        f.close()
+        contents = self.TranslateLoadedData(raw)
+        rc = 0
+        try:
+            self.GetFirstView().SetWindowText(contents)
+            rc = 1
+        except TypeError:  # Null byte in file.
+            win32ui.MessageBox("This file contains NULL bytes, and can not be edited")
+            rc = 0
+
+        self.EndWaitCursor()
+        self.SetModifiedFlag(0)  # No longer dirty
+        self._DocumentStateChanged()
+        return rc
+
+    def TranslateLoadedData(self, data):
+        """Given raw data read from a file, massage it suitable for the edit window"""
+        # if a CR in the first 250 chars, then perform the expensive translate
+        if data[:250].find("\r") == -1:
+            win32ui.SetStatusText(
+                "Translating from Unix file format - please wait...", 1
+            )
+            return re.sub("\r*\n", "\r\n", data)
+        else:
+            return data
+
+    def SaveFile(self, fileName, encoding=None):
+        if isRichText:
+            view = self.GetFirstView()
+            view.SaveTextFile(fileName, encoding=encoding)
+        else:  # Old style edit view window.
+            self.GetFirstView().SaveFile(fileName)
+        try:
+            # Make sure line cache has updated info about me!
+            import linecache
+
+            linecache.checkcache()
+        except:
+            pass
+
+    #
+    # Color state stuff
+    #
+    def SetAllLineColors(self, color=None):
+        for view in self.GetAllViews():
+            view.SetAllLineColors(color)
+
+    def SetLineColor(self, lineNo, color):
+        "Color a line of all views"
+        for view in self.GetAllViews():
+            view.SetLineColor(lineNo, color)
+
+
+# 	def StreamTextOut(self, data): ### This seems unreliable???
+# 		self.saveFileHandle.write(data)
+# 		return 1 # keep em coming!
+
+# ParentEditorView=docview.EditView
+ParentEditorView = docview.RichEditView
+
+
+class EditorView(ParentEditorView):
+    def __init__(self, doc):
+        ParentEditorView.__init__(self, doc)
+        if isRichText:
+            self.SetWordWrap(win32ui.CRichEditView_WrapNone)
+
+        self.addToMRU = 1
+        self.HookHandlers()
+        self.bCheckingFile = 0
+
+        self.defCharFormat = GetEditorFontOption("Default Font", defaultCharacterFormat)
+
+        # Smart tabs override everything else if context can be worked out.
+        self.bSmartTabs = GetEditorOption("Smart Tabs", 1)
+
+        self.tabSize = GetEditorOption("Tab Size", 8)
+        self.indentSize = GetEditorOption("Indent Size", 8)
+        # If next indent is at a tab position, and useTabs is set, a tab will be inserted.
+        self.bUseTabs = GetEditorOption("Use Tabs", 1)
+
+    def OnInitialUpdate(self):
+        rc = self._obj_.OnInitialUpdate()
+        self.SetDefaultCharFormat(self.defCharFormat)
+        return rc
+
+    def CutCurLine(self):
+        curLine = self._obj_.LineFromChar()
+        nextLine = curLine + 1
+        start = self._obj_.LineIndex(curLine)
+        end = self._obj_.LineIndex(nextLine)
+        if end == 0:  # must be last line.
+            end = start + self.end.GetLineLength(curLine)
+        self._obj_.SetSel(start, end)
+        self._obj_.Cut()
+
+    def _PrepareUserStateChange(self):
+        "Return selection, lineindex, etc info, so it can be restored"
+        self.SetRedraw(0)
+        return self.GetModify(), self.GetSel(), self.GetFirstVisibleLine()
+
+    def _EndUserStateChange(self, info):
+        scrollOff = info[2] - self.GetFirstVisibleLine()
+        if scrollOff:
+            self.LineScroll(scrollOff)
+        self.SetSel(info[1])
+        self.SetModify(info[0])
+        self.SetRedraw(1)
+        self.InvalidateRect()
+        self.UpdateWindow()
+
+    def _UpdateUIForState(self):
+        self.SetReadOnly(self.GetDocument()._IsReadOnly())
+
+    def SetAllLineColors(self, color=None):
+        if isRichText:
+            info = self._PrepareUserStateChange()
+            try:
+                if color is None:
+                    color = self.defCharFormat[4]
+                self.SetSel(0, -1)
+                self.SetSelectionCharFormat((win32con.CFM_COLOR, 0, 0, 0, color))
+            finally:
+                self._EndUserStateChange(info)
+
+    def SetLineColor(self, lineNo, color):
+        "lineNo is the 1 based line number to set.  If color is None, default color is used."
+        if isRichText:
+            info = self._PrepareUserStateChange()
+            try:
+                if color is None:
+                    color = self.defCharFormat[4]
+                lineNo = lineNo - 1
+                startIndex = self.LineIndex(lineNo)
+                if startIndex != -1:
+                    self.SetSel(startIndex, self.LineIndex(lineNo + 1))
+                    self.SetSelectionCharFormat((win32con.CFM_COLOR, 0, 0, 0, color))
+            finally:
+                self._EndUserStateChange(info)
+
+    def Indent(self):
+        """Insert an indent to move the cursor to the next tab position.
+
+        Honors the tab size and 'use tabs' settings.  Assumes the cursor is already at the
+        position to be indented, and the selection is a single character (ie, not a block)
+        """
+        start, end = self._obj_.GetSel()
+        startLine = self._obj_.LineFromChar(start)
+        line = self._obj_.GetLine(startLine)
+        realCol = start - self._obj_.LineIndex(startLine)
+        # Calulate the next tab stop.
+        # Expand existing tabs.
+        curCol = 0
+        for ch in line[:realCol]:
+            if ch == "\t":
+                curCol = ((curCol / self.tabSize) + 1) * self.tabSize
+            else:
+                curCol = curCol + 1
+        nextColumn = ((curCol / self.indentSize) + 1) * self.indentSize
+        # 		print "curCol is", curCol, "nextColumn is", nextColumn
+        ins = None
+        if self.bSmartTabs:
+            # Look for some context.
+            if realCol == 0:  # Start of the line - see if the line above can tell us
+                lookLine = startLine - 1
+                while lookLine >= 0:
+                    check = self._obj_.GetLine(lookLine)[0:1]
+                    if check in ("\t", " "):
+                        ins = check
+                        break
+                    lookLine = lookLine - 1
+            else:  # See if the previous char can tell us
+                check = line[realCol - 1]
+                if check in ("\t", " "):
+                    ins = check
+
+        # Either smart tabs off, or not smart enough!
+        # Use the "old style" settings.
+        if ins is None:
+            if self.bUseTabs and nextColumn % self.tabSize == 0:
+                ins = "\t"
+            else:
+                ins = " "
+
+        if ins == " ":
+            # Calc the number of spaces to take us to the next stop
+            ins = ins * (nextColumn - curCol)
+
+        self._obj_.ReplaceSel(ins)
+
+    def BlockDent(self, isIndent, startLine, endLine):
+        "Indent/Undent all lines specified"
+        if not self.GetDocument().CheckMakeDocumentWritable():
+            return 0
+        tabSize = self.tabSize  # hard-code for now!
+        info = self._PrepareUserStateChange()
+        try:
+            for lineNo in range(startLine, endLine):
+                pos = self._obj_.LineIndex(lineNo)
+                self._obj_.SetSel(pos, pos)
+                if isIndent:
+                    self.Indent()
+                else:
+                    line = self._obj_.GetLine(lineNo)
+                    try:
+                        noToDel = 0
+                        if line[0] == "\t":
+                            noToDel = 1
+                        elif line[0] == " ":
+                            for noToDel in range(0, tabSize):
+                                if line[noToDel] != " ":
+                                    break
+                            else:
+                                noToDel = tabSize
+                        if noToDel:
+                            self._obj_.SetSel(pos, pos + noToDel)
+                            self._obj_.Clear()
+                    except IndexError:
+                        pass
+        finally:
+            self._EndUserStateChange(info)
+        self.GetDocument().SetModifiedFlag(1)  # Now dirty
+        self._obj_.SetSel(self.LineIndex(startLine), self.LineIndex(endLine))
+
+    def GotoLine(self, lineNo=None):
+        try:
+            if lineNo is None:
+                lineNo = int(input("Enter Line Number"))
+        except (ValueError, KeyboardInterrupt):
+            return 0
+        self.GetLineCount()  # Seems to be needed when file first opened???
+        charNo = self.LineIndex(lineNo - 1)
+        self.SetSel(charNo)
+
+    def HookHandlers(self):  # children can override, but should still call me!
+        # 		self.HookAllKeyStrokes(self.OnKey)
+        self.HookMessage(self.OnCheckExternalDocumentUpdated, MSG_CHECK_EXTERNAL_FILE)
+        self.HookMessage(self.OnRClick, win32con.WM_RBUTTONDOWN)
+        self.HookMessage(self.OnSetFocus, win32con.WM_SETFOCUS)
+        self.HookMessage(self.OnKeyDown, win32con.WM_KEYDOWN)
+        self.HookKeyStroke(self.OnKeyCtrlY, 25)  # ^Y
+        self.HookKeyStroke(self.OnKeyCtrlG, 7)  # ^G
+        self.HookKeyStroke(self.OnKeyTab, 9)  # TAB
+        self.HookKeyStroke(self.OnKeyEnter, 13)  # Enter
+        self.HookCommand(self.OnCmdLocateFile, ID_LOCATE_FILE)
+        self.HookCommand(self.OnCmdGotoLine, ID_GOTO_LINE)
+        self.HookCommand(self.OnEditPaste, afxres.ID_EDIT_PASTE)
+        self.HookCommand(self.OnEditCut, afxres.ID_EDIT_CUT)
+
+    # Hook Handlers
+    def OnSetFocus(self, msg):
+        # Even though we use file change notifications, we should be very sure about it here.
+        self.OnCheckExternalDocumentUpdated(msg)
+
+    def OnRClick(self, params):
+        menu = win32ui.CreatePopupMenu()
+
+        # look for a module name
+        line = self._obj_.GetLine().strip()
+        flags = win32con.MF_STRING | win32con.MF_ENABLED
+        if patImport.match(line) == len(line):
+            menu.AppendMenu(
+                flags, ID_LOCATE_FILE, "&Locate %s.py" % patImport.group("name")
+            )
+            menu.AppendMenu(win32con.MF_SEPARATOR)
+        menu.AppendMenu(flags, win32ui.ID_EDIT_UNDO, "&Undo")
+        menu.AppendMenu(win32con.MF_SEPARATOR)
+        menu.AppendMenu(flags, win32ui.ID_EDIT_CUT, "Cu&t")
+        menu.AppendMenu(flags, win32ui.ID_EDIT_COPY, "&Copy")
+        menu.AppendMenu(flags, win32ui.ID_EDIT_PASTE, "&Paste")
+        menu.AppendMenu(flags, win32con.MF_SEPARATOR)
+        menu.AppendMenu(flags, win32ui.ID_EDIT_SELECT_ALL, "&Select all")
+        menu.AppendMenu(flags, win32con.MF_SEPARATOR)
+        menu.AppendMenu(flags, ID_GOTO_LINE, "&Goto line...")
+        menu.TrackPopupMenu(params[5])
+        return 0
+
+    def OnCmdGotoLine(self, cmd, code):
+        self.GotoLine()
+        return 0
+
+    def OnCmdLocateFile(self, cmd, code):
+        modName = patImport.group("name")
+        if not modName:
+            return 0
+        import pywin.framework.scriptutils
+
+        fileName = pywin.framework.scriptutils.LocatePythonFile(modName)
+        if fileName is None:
+            win32ui.SetStatusText("Can't locate module %s" % modName)
+        else:
+            win32ui.GetApp().OpenDocumentFile(fileName)
+        return 0
+
+    # Key handlers
+    def OnKeyEnter(self, key):
+        if not self.GetDocument().CheckMakeDocumentWritable():
+            return 0
+        curLine = self._obj_.GetLine()
+        self._obj_.ReplaceSel("\r\n")  # insert the newline
+        # If the current line indicates the next should be indented,
+        # then copy the current indentation to this line.
+        res = patIndent.match(curLine, 0)
+        if res > 0 and curLine.strip():
+            curIndent = patIndent.group(1)
+            self._obj_.ReplaceSel(curIndent)
+        return 0  # dont pass on
+
+    def OnKeyCtrlY(self, key):
+        if not self.GetDocument().CheckMakeDocumentWritable():
+            return 0
+        self.CutCurLine()
+        return 0  # dont let him have it!
+
+    def OnKeyCtrlG(self, key):
+        self.GotoLine()
+        return 0  # dont let him have it!
+
+    def OnKeyTab(self, key):
+        if not self.GetDocument().CheckMakeDocumentWritable():
+            return 0
+        start, end = self._obj_.GetSel()
+        if start == end:  # normal TAB key
+            self.Indent()
+            return 0  # we handled this.
+
+        # Otherwise it is a block indent/dedent.
+        if start > end:
+            start, end = end, start  # swap them.
+        startLine = self._obj_.LineFromChar(start)
+        endLine = self._obj_.LineFromChar(end)
+
+        self.BlockDent(win32api.GetKeyState(win32con.VK_SHIFT) >= 0, startLine, endLine)
+        return 0
+
+    def OnEditPaste(self, id, code):
+        # Return 1 if we can make the file editable.(or it already is!)
+        return self.GetDocument().CheckMakeDocumentWritable()
+
+    def OnEditCut(self, id, code):
+        # Return 1 if we can make the file editable.(or it already is!)
+        return self.GetDocument().CheckMakeDocumentWritable()
+
+    def OnKeyDown(self, msg):
+        key = msg[2]
+        if win32api.GetKeyState(win32con.VK_CONTROL) & 0x8000:
+            modList = MODIFYING_VK_KEYS_CTRL
+        elif win32api.GetKeyState(win32con.VK_MENU) & 0x8000:
+            modList = MODIFYING_VK_KEYS_ALT
+        else:
+            modList = MODIFYING_VK_KEYS
+
+        if key in modList:
+            # Return 1 if we can make the file editable.(or it already is!)
+            return self.GetDocument().CheckMakeDocumentWritable()
+        return 1  # Pass it on OK
+
+    # 	def OnKey(self, key):
+    # 		return self.GetDocument().CheckMakeDocumentWritable()
+
+    def OnCheckExternalDocumentUpdated(self, msg):
+        if self._obj_ is None or self.bCheckingFile:
+            return
+        self.bCheckingFile = 1
+        self.GetDocument().CheckExternalDocumentUpdated()
+        self.bCheckingFile = 0
+
+
+from .template import EditorTemplateBase
+
+
+class EditorTemplate(EditorTemplateBase):
+    def __init__(
+        self, res=win32ui.IDR_TEXTTYPE, makeDoc=None, makeFrame=None, makeView=None
+    ):
+        if makeDoc is None:
+            makeDoc = EditorDocument
+        if makeView is None:
+            makeView = EditorView
+        EditorTemplateBase.__init__(self, res, makeDoc, makeFrame, makeView)
+
+    def _CreateDocTemplate(self, resourceId):
+        return win32ui.CreateRichEditDocTemplate(resourceId)
+
+    def CreateWin32uiDocument(self):
+        return self.DoCreateRichEditDoc()
+
+
+def Create(fileName=None, title=None, template=None):
+    return editorTemplate.OpenDocumentFile(fileName)
+
+
+from pywin.framework.editor import GetDefaultEditorModuleName
+
+prefModule = GetDefaultEditorModuleName()
+# Initialize only if this is the "default" editor.
+if __name__ == prefModule:
+    # For debugging purposes, when this module may be reloaded many times.
+    try:
+        win32ui.GetApp().RemoveDocTemplate(editorTemplate)
+    except (NameError, win32ui.error):
+        pass
+
+    editorTemplate = EditorTemplate()
+    win32ui.GetApp().AddDocTemplate(editorTemplate)
diff --git a/lib/pythonwin/pywin/framework/editor/frame.py b/lib/pythonwin/pywin/framework/editor/frame.py
new file mode 100644
index 00000000..e927d16e
--- /dev/null
+++ b/lib/pythonwin/pywin/framework/editor/frame.py
@@ -0,0 +1,74 @@
+# frame.py - The MDI frame window for an editor.
+import pywin.framework.window
+import win32con
+import win32ui
+
+from . import ModuleBrowser
+
+
+class EditorFrame(pywin.framework.window.MDIChildWnd):
+    def OnCreateClient(self, cp, context):
+        # Create the default view as specified by the template (ie, the editor view)
+        view = context.template.MakeView(context.doc)
+        # Create the browser view.
+        browserView = ModuleBrowser.BrowserView(context.doc)
+        view2 = context.template.MakeView(context.doc)
+
+        splitter = win32ui.CreateSplitter()
+        style = win32con.WS_CHILD | win32con.WS_VISIBLE
+        splitter.CreateStatic(self, 1, 2, style, win32ui.AFX_IDW_PANE_FIRST)
+        sub_splitter = self.sub_splitter = win32ui.CreateSplitter()
+        sub_splitter.CreateStatic(splitter, 2, 1, style, win32ui.AFX_IDW_PANE_FIRST + 1)
+
+        # Note we must add the default view first, so that doc.GetFirstView() returns the editor view.
+        sub_splitter.CreateView(view, 1, 0, (0, 0))
+        splitter.CreateView(browserView, 0, 0, (0, 0))
+        sub_splitter.CreateView(view2, 0, 0, (0, 0))
+
+        ##        print "First view is", context.doc.GetFirstView()
+        ##        print "Views are", view, view2, browserView
+        ##        print "Parents are", view.GetParent(), view2.GetParent(), browserView.GetParent()
+        ##        print "Splitter is", splitter
+        ##        print "sub splitter is", sub_splitter
+        ## Old
+        ##        splitter.CreateStatic (self, 1, 2)
+        ##        splitter.CreateView(view, 0, 1, (0,0)) # size ignored.
+        ##        splitter.CreateView (browserView, 0, 0, (0, 0))
+
+        # Restrict the size of the browser splitter (and we can avoid filling
+        # it until it is shown)
+        splitter.SetColumnInfo(0, 10, 20)
+        # And the active view is our default view (so it gets initial focus)
+        self.SetActiveView(view)
+
+    def GetEditorView(self):
+        # In a multi-view (eg, splitter) environment, get
+        # an editor (ie, scintilla) view
+        # Look for the splitter opened the most!
+        if self.sub_splitter is None:
+            return self.GetDlgItem(win32ui.AFX_IDW_PANE_FIRST)
+        v1 = self.sub_splitter.GetPane(0, 0)
+        v2 = self.sub_splitter.GetPane(1, 0)
+        r1 = v1.GetWindowRect()
+        r2 = v2.GetWindowRect()
+        if r1[3] - r1[1] > r2[3] - r2[1]:
+            return v1
+        return v2
+
+    def GetBrowserView(self):
+        # XXX - should fix this :-)
+        return self.GetActiveDocument().GetAllViews()[1]
+
+    def OnClose(self):
+        doc = self.GetActiveDocument()
+        if not doc.SaveModified():
+            ## Cancel button selected from Save dialog, do not actually close
+            ## print 'close cancelled'
+            return 0
+        ## So the 'Save' dialog doesn't come up twice
+        doc._obj_.SetModifiedFlag(False)
+
+        # Must force the module browser to close itself here (OnDestroy for the view itself is too late!)
+        self.sub_splitter = None  # ensure no circles!
+        self.GetBrowserView().DestroyBrowser()
+        return self._obj_.OnClose()
diff --git a/lib/pythonwin/pywin/framework/editor/template.py b/lib/pythonwin/pywin/framework/editor/template.py
new file mode 100644
index 00000000..362a74a6
--- /dev/null
+++ b/lib/pythonwin/pywin/framework/editor/template.py
@@ -0,0 +1,60 @@
+import os
+
+import pywin.framework.window
+import win32api
+import win32ui
+from pywin.mfc import docview
+
+from . import frame
+
+ParentEditorTemplate = docview.DocTemplate
+
+
+class EditorTemplateBase(ParentEditorTemplate):
+    def __init__(
+        self, res=win32ui.IDR_TEXTTYPE, makeDoc=None, makeFrame=None, makeView=None
+    ):
+        if makeFrame is None:
+            makeFrame = frame.EditorFrame
+        ParentEditorTemplate.__init__(self, res, makeDoc, makeFrame, makeView)
+
+    def _CreateDocTemplate(self, resourceId):
+        assert 0, "You must override this"
+
+    def CreateWin32uiDocument(self):
+        assert 0, "You must override this"
+
+    def GetFileExtensions(self):
+        return ".txt", ".py"
+
+    def MatchDocType(self, fileName, fileType):
+        doc = self.FindOpenDocument(fileName)
+        if doc:
+            return doc
+        ext = os.path.splitext(fileName)[1].lower()
+        if ext in self.GetFileExtensions():
+            return win32ui.CDocTemplate_Confidence_yesAttemptNative
+        return win32ui.CDocTemplate_Confidence_maybeAttemptForeign
+
+    def InitialUpdateFrame(self, frame, doc, makeVisible=1):
+        self._obj_.InitialUpdateFrame(frame, doc, makeVisible)  # call default handler.
+        doc._UpdateUIForState()
+
+    def GetPythonPropertyPages(self):
+        """Returns a list of property pages"""
+        from . import configui
+
+        return [configui.EditorPropertyPage(), configui.EditorWhitespacePropertyPage()]
+
+    def OpenDocumentFile(self, filename, bMakeVisible=1):
+        if filename is not None:
+            try:
+                path = os.path.split(filename)[0]
+                # 				print "The editor is translating", `filename`,"to",
+                filename = win32api.FindFiles(filename)[0][8]
+                filename = os.path.join(path, filename)
+            # 				print `filename`
+            except (win32api.error, IndexError) as details:
+                pass
+        # 				print "Couldnt get the full filename!", details
+        return self._obj_.OpenDocumentFile(filename, bMakeVisible)
diff --git a/lib/pythonwin/pywin/framework/editor/vss.py b/lib/pythonwin/pywin/framework/editor/vss.py
new file mode 100644
index 00000000..718f83ee
--- /dev/null
+++ b/lib/pythonwin/pywin/framework/editor/vss.py
@@ -0,0 +1,104 @@
+# vss.py -- Source Control using Microsoft VSS.
+
+# Provides routines for checking files out of VSS.
+#
+# Uses an INI file very similar to how VB integrates with VSS - even
+# as far as using the same name.
+
+# The file must be named "Mssccprj.scc", and be in the format of
+# an INI file.  This file may be in a parent directory, in which
+# case the project name will be built from what is specified in the
+# ini file, plus the path from the INI file to the file itself.
+#
+# The INI file should have a [Python] section, and a
+# Project=Project Name
+#  and optionally
+# Database=??
+
+
+import os
+import sys
+import traceback
+
+import win32api
+import win32ui
+
+g_iniName = "Mssccprj.scc"  # Use the same INI name as VB!
+
+g_sourceSafe = None
+
+
+def FindVssProjectInfo(fullfname):
+    """Looks up the file system for an INI file describing the project.
+
+    Looking up the tree is for ni style packages.
+
+    Returns (projectName, pathToFileName) where pathToFileName contains
+    the path from the ini file to the actual file.
+    """
+    path, fnameonly = os.path.split(fullfname)
+    origPath = path
+    project = ""
+    retPaths = [fnameonly]
+    while not project:
+        iniName = os.path.join(path, g_iniName)
+        database = win32api.GetProfileVal("Python", "Database", "", iniName)
+        project = win32api.GetProfileVal("Python", "Project", "", iniName)
+        if project:
+            break
+        # No valid INI file in this directory - look up a level.
+        path, addpath = os.path.split(path)
+        if not addpath:  # Root?
+            break
+        retPaths.insert(0, addpath)
+    if not project:
+        win32ui.MessageBox(
+            "%s\r\n\r\nThis directory is not configured for Python/VSS" % origPath
+        )
+        return
+    return project, "/".join(retPaths), database
+
+
+def CheckoutFile(fileName):
+    global g_sourceSafe
+    import pythoncom
+
+    ok = 0
+    # Assumes the fileName has a complete path,
+    # and that the INI file can be found in that path
+    # (or a parent path if a ni style package)
+    try:
+        import win32com.client
+        import win32com.client.gencache
+
+        mod = win32com.client.gencache.EnsureModule(
+            "{783CD4E0-9D54-11CF-B8EE-00608CC9A71F}", 0, 5, 0
+        )
+        if mod is None:
+            win32ui.MessageBox(
+                "VSS does not appear to be installed.  The TypeInfo can not be created"
+            )
+            return ok
+
+        rc = FindVssProjectInfo(fileName)
+        if rc is None:
+            return
+        project, vssFname, database = rc
+        if g_sourceSafe is None:
+            g_sourceSafe = win32com.client.Dispatch("SourceSafe")
+            # SS seems a bit wierd.  It defaults the arguments as empty strings, but
+            # then complains when they are used - so we pass "Missing"
+            if not database:
+                database = pythoncom.Missing
+            g_sourceSafe.Open(database, pythoncom.Missing, pythoncom.Missing)
+        item = g_sourceSafe.VSSItem("$/%s/%s" % (project, vssFname))
+        item.Checkout(None, fileName)
+        ok = 1
+    except pythoncom.com_error as exc:
+        win32ui.MessageBox(exc.strerror, "Error checking out file")
+    except:
+        typ, val, tb = sys.exc_info()
+        traceback.print_exc()
+        win32ui.MessageBox("%s - %s" % (str(typ), str(val)), "Error checking out file")
+        tb = None  # Cleanup a cycle
+    return ok
diff --git a/lib/pythonwin/pywin/framework/help.py b/lib/pythonwin/pywin/framework/help.py
new file mode 100644
index 00000000..ab664b4d
--- /dev/null
+++ b/lib/pythonwin/pywin/framework/help.py
@@ -0,0 +1,173 @@
+# help.py - help utilities for PythonWin.
+import os
+
+import regutil
+import win32api
+import win32con
+import win32ui
+
+htmlhelp_handle = None
+
+html_help_command_translators = {
+    win32con.HELP_CONTENTS: 1,  # HH_DISPLAY_TOC
+    win32con.HELP_CONTEXT: 15,  # HH_HELP_CONTEXT
+    win32con.HELP_FINDER: 1,  # HH_DISPLAY_TOC
+}
+
+
+def FinalizeHelp():
+    global htmlhelp_handle
+    if htmlhelp_handle is not None:
+        import win32help
+
+        try:
+            # frame = win32ui.GetMainFrame().GetSafeHwnd()
+            frame = 0
+            win32help.HtmlHelp(frame, None, win32help.HH_UNINITIALIZE, htmlhelp_handle)
+        except win32help.error:
+            print("Failed to finalize htmlhelp!")
+        htmlhelp_handle = None
+
+
+def OpenHelpFile(fileName, helpCmd=None, helpArg=None):
+    "Open a help file, given a full path"
+    # default help arg.
+    win32ui.DoWaitCursor(1)
+    try:
+        if helpCmd is None:
+            helpCmd = win32con.HELP_CONTENTS
+        ext = os.path.splitext(fileName)[1].lower()
+        if ext == ".hlp":
+            win32api.WinHelp(
+                win32ui.GetMainFrame().GetSafeHwnd(), fileName, helpCmd, helpArg
+            )
+        # XXX - using the htmlhelp API wreaks havoc with keyboard shortcuts
+        # so we disable it, forcing ShellExecute, which works fine (but
+        # doesn't close the help file when Pythonwin is closed.
+        # Tom Heller also points out http://www.microsoft.com/mind/0499/faq/faq0499.asp,
+        # which may or may not be related.
+        elif 0 and ext == ".chm":
+            import win32help
+
+            global htmlhelp_handle
+            helpCmd = html_help_command_translators.get(helpCmd, helpCmd)
+            # frame = win32ui.GetMainFrame().GetSafeHwnd()
+            frame = 0  # Dont want it overlapping ours!
+            if htmlhelp_handle is None:
+                htmlhelp_hwnd, htmlhelp_handle = win32help.HtmlHelp(
+                    frame, None, win32help.HH_INITIALIZE
+                )
+            win32help.HtmlHelp(frame, fileName, helpCmd, helpArg)
+        else:
+            # Hope that the extension is registered, and we know what to do!
+            win32api.ShellExecute(0, "open", fileName, None, "", win32con.SW_SHOW)
+        return fileName
+    finally:
+        win32ui.DoWaitCursor(-1)
+
+
+def ListAllHelpFiles():
+    ret = []
+    ret = _ListAllHelpFilesInRoot(win32con.HKEY_LOCAL_MACHINE)
+    # Ensure we don't get dups.
+    for item in _ListAllHelpFilesInRoot(win32con.HKEY_CURRENT_USER):
+        if item not in ret:
+            ret.append(item)
+    return ret
+
+
+def _ListAllHelpFilesInRoot(root):
+    """Returns a list of (helpDesc, helpFname) for all registered help files"""
+    import regutil
+
+    retList = []
+    try:
+        key = win32api.RegOpenKey(
+            root, regutil.BuildDefaultPythonKey() + "\\Help", 0, win32con.KEY_READ
+        )
+    except win32api.error as exc:
+        import winerror
+
+        if exc.winerror != winerror.ERROR_FILE_NOT_FOUND:
+            raise
+        return retList
+    try:
+        keyNo = 0
+        while 1:
+            try:
+                helpDesc = win32api.RegEnumKey(key, keyNo)
+                helpFile = win32api.RegQueryValue(key, helpDesc)
+                retList.append((helpDesc, helpFile))
+                keyNo = keyNo + 1
+            except win32api.error as exc:
+                import winerror
+
+                if exc.winerror != winerror.ERROR_NO_MORE_ITEMS:
+                    raise
+                break
+    finally:
+        win32api.RegCloseKey(key)
+    return retList
+
+
+def SelectAndRunHelpFile():
+    from pywin.dialogs import list
+
+    helpFiles = ListAllHelpFiles()
+    if len(helpFiles) == 1:
+        # only 1 help file registered - probably ours - no point asking
+        index = 0
+    else:
+        index = list.SelectFromLists("Select Help file", helpFiles, ["Title"])
+    if index is not None:
+        OpenHelpFile(helpFiles[index][1])
+
+
+helpIDMap = None
+
+
+def SetHelpMenuOtherHelp(mainMenu):
+    """Modifies the main Help Menu to handle all registered help files.
+    mainMenu -- The main menu to modify - usually from docTemplate.GetSharedMenu()
+    """
+
+    # Load all help files from the registry.
+    global helpIDMap
+    if helpIDMap is None:
+        helpIDMap = {}
+        cmdID = win32ui.ID_HELP_OTHER
+        excludeList = ["Main Python Documentation", "Pythonwin Reference"]
+        firstList = ListAllHelpFiles()
+        # We actually want to not only exclude these entries, but
+        # their help file names (as many entries may share the same name)
+        excludeFnames = []
+        for desc, fname in firstList:
+            if desc in excludeList:
+                excludeFnames.append(fname)
+
+        helpDescs = []
+        for desc, fname in firstList:
+            if fname not in excludeFnames:
+                helpIDMap[cmdID] = (desc, fname)
+                win32ui.GetMainFrame().HookCommand(HandleHelpOtherCommand, cmdID)
+                cmdID = cmdID + 1
+
+    helpMenu = mainMenu.GetSubMenu(
+        mainMenu.GetMenuItemCount() - 1
+    )  # Help menu always last.
+    otherHelpMenuPos = 2  # cant search for ID, as sub-menu has no ID.
+    otherMenu = helpMenu.GetSubMenu(otherHelpMenuPos)
+    while otherMenu.GetMenuItemCount():
+        otherMenu.DeleteMenu(0, win32con.MF_BYPOSITION)
+
+    if helpIDMap:
+        for id, (desc, fname) in helpIDMap.items():
+            otherMenu.AppendMenu(win32con.MF_ENABLED | win32con.MF_STRING, id, desc)
+    else:
+        helpMenu.EnableMenuItem(
+            otherHelpMenuPos, win32con.MF_BYPOSITION | win32con.MF_GRAYED
+        )
+
+
+def HandleHelpOtherCommand(cmd, code):
+    OpenHelpFile(helpIDMap[cmd][1])
diff --git a/lib/pythonwin/pywin/framework/interact.py b/lib/pythonwin/pywin/framework/interact.py
new file mode 100644
index 00000000..5f0b87f2
--- /dev/null
+++ b/lib/pythonwin/pywin/framework/interact.py
@@ -0,0 +1,985 @@
+##################################################################
+##
+## Interactive Shell Window
+##
+
+import array
+import code
+import os
+import string
+import sys
+import traceback
+
+import __main__
+import afxres
+import pywin.framework.app
+import pywin.scintilla.control
+import pywin.scintilla.formatter
+import pywin.scintilla.IDLEenvironment
+import win32api
+import win32clipboard
+import win32con
+import win32ui
+
+## sequential after ID_GOTO_LINE defined in editor.py
+ID_EDIT_COPY_CODE = 0xE2002
+ID_EDIT_EXEC_CLIPBOARD = 0x2003
+
+trace = pywin.scintilla.formatter.trace
+
+import re
+
+from . import winout
+
+# from IDLE.
+_is_block_opener = re.compile(r":\s*(#.*)?$").search
+_is_block_closer = re.compile(
+    r"""
+    \s*
+    ( return
+    | break
+    | continue
+    | raise
+    | pass
+    )
+    \b
+""",
+    re.VERBOSE,
+).match
+
+tracebackHeader = "Traceback (".encode("ascii")
+
+sectionProfile = "Interactive Window"
+valueFormatTitle = "FormatTitle"
+valueFormatInput = "FormatInput"
+valueFormatOutput = "FormatOutput"
+valueFormatOutputError = "FormatOutputError"
+
+# These are defaults only.  Values are read from the registry.
+formatTitle = (-536870897, 0, 220, 0, 16711680, 184, 34, "Arial")
+formatInput = (-402653169, 0, 200, 0, 0, 0, 49, "Courier New")
+formatOutput = (-402653169, 0, 200, 0, 8421376, 0, 49, "Courier New")
+formatOutputError = (-402653169, 0, 200, 0, 255, 0, 49, "Courier New")
+
+try:
+    sys.ps1
+except AttributeError:
+    sys.ps1 = ">>> "
+    sys.ps2 = "... "
+
+
+def LoadPreference(preference, default=""):
+    return win32ui.GetProfileVal(sectionProfile, preference, default)
+
+
+def SavePreference(prefName, prefValue):
+    win32ui.WriteProfileVal(sectionProfile, prefName, prefValue)
+
+
+def GetPromptPrefix(line):
+    ps1 = sys.ps1
+    if line[: len(ps1)] == ps1:
+        return ps1
+    ps2 = sys.ps2
+    if line[: len(ps2)] == ps2:
+        return ps2
+
+
+#############################################################
+#
+# Colorizer related code.
+#
+#############################################################
+STYLE_INTERACTIVE_EOL = "Interactive EOL"
+STYLE_INTERACTIVE_OUTPUT = "Interactive Output"
+STYLE_INTERACTIVE_PROMPT = "Interactive Prompt"
+STYLE_INTERACTIVE_BANNER = "Interactive Banner"
+STYLE_INTERACTIVE_ERROR = "Interactive Error"
+STYLE_INTERACTIVE_ERROR_FINALLINE = "Interactive Error (final line)"
+
+INTERACTIVE_STYLES = [
+    STYLE_INTERACTIVE_EOL,
+    STYLE_INTERACTIVE_OUTPUT,
+    STYLE_INTERACTIVE_PROMPT,
+    STYLE_INTERACTIVE_BANNER,
+    STYLE_INTERACTIVE_ERROR,
+    STYLE_INTERACTIVE_ERROR_FINALLINE,
+]
+
+FormatterParent = pywin.scintilla.formatter.PythonSourceFormatter
+
+
+class InteractiveFormatter(FormatterParent):
+    def __init__(self, scintilla):
+        FormatterParent.__init__(self, scintilla)
+        self.bannerDisplayed = False
+
+    def SetStyles(self):
+        FormatterParent.SetStyles(self)
+        Style = pywin.scintilla.formatter.Style
+        self.RegisterStyle(Style(STYLE_INTERACTIVE_EOL, STYLE_INTERACTIVE_PROMPT))
+        self.RegisterStyle(Style(STYLE_INTERACTIVE_PROMPT, formatInput))
+        self.RegisterStyle(Style(STYLE_INTERACTIVE_OUTPUT, formatOutput))
+        self.RegisterStyle(Style(STYLE_INTERACTIVE_BANNER, formatTitle))
+        self.RegisterStyle(Style(STYLE_INTERACTIVE_ERROR, formatOutputError))
+        self.RegisterStyle(
+            Style(STYLE_INTERACTIVE_ERROR_FINALLINE, STYLE_INTERACTIVE_ERROR)
+        )
+
+    def LoadPreference(self, name, default):
+        rc = win32ui.GetProfileVal("Format", name, default)
+        if rc == default:
+            rc = win32ui.GetProfileVal(sectionProfile, name, default)
+        return rc
+
+    def ColorizeInteractiveCode(self, cdoc, styleStart, stylePyStart):
+        lengthDoc = len(cdoc)
+        if lengthDoc == 0:
+            return
+        state = styleStart
+        # As per comments in Colorize(), we work with the raw utf8
+        # bytes. To avoid too muych py3k pain, we treat each utf8 byte
+        # as a latin-1 unicode character - we only use it to compare
+        # against ascii chars anyway...
+        chNext = cdoc[0:1].decode("latin-1")
+        startSeg = 0
+        i = 0
+        lastState = state  # debug only
+        while i < lengthDoc:
+            ch = chNext
+            chNext = cdoc[i + 1 : i + 2].decode("latin-1")
+
+            # 			trace("ch=%r, i=%d, next=%r, state=%s" % (ch, i, chNext, state))
+            if state == STYLE_INTERACTIVE_EOL:
+                if ch not in "\r\n":
+                    self.ColorSeg(startSeg, i - 1, state)
+                    startSeg = i
+                    if ch in (sys.ps1[0], sys.ps2[0]):
+                        state = STYLE_INTERACTIVE_PROMPT
+                    elif cdoc[i : i + len(tracebackHeader)] == tracebackHeader:
+                        state = STYLE_INTERACTIVE_ERROR
+                    else:
+                        state = STYLE_INTERACTIVE_OUTPUT
+            elif state == STYLE_INTERACTIVE_PROMPT:
+                if ch not in sys.ps1 + sys.ps2 + " ":
+                    self.ColorSeg(startSeg, i - 1, state)
+                    startSeg = i
+                    if ch in "\r\n":
+                        state = STYLE_INTERACTIVE_EOL
+                    else:
+                        state = stylePyStart  # Start coloring Python code.
+            elif state in (STYLE_INTERACTIVE_OUTPUT,):
+                if ch in "\r\n":
+                    self.ColorSeg(startSeg, i - 1, state)
+                    startSeg = i
+                    state = STYLE_INTERACTIVE_EOL
+            elif state == STYLE_INTERACTIVE_ERROR:
+                if ch in "\r\n" and chNext and chNext not in string.whitespace:
+                    # Everything including me
+                    self.ColorSeg(startSeg, i, state)
+                    startSeg = i + 1
+                    state = STYLE_INTERACTIVE_ERROR_FINALLINE
+                elif i == 0 and ch not in string.whitespace:
+                    # If we are coloring from the start of a line,
+                    # we need this better check for the last line
+                    # Color up to not including me
+                    self.ColorSeg(startSeg, i - 1, state)
+                    startSeg = i
+                    state = STYLE_INTERACTIVE_ERROR_FINALLINE
+            elif state == STYLE_INTERACTIVE_ERROR_FINALLINE:
+                if ch in "\r\n":
+                    self.ColorSeg(startSeg, i - 1, state)
+                    startSeg = i
+                    state = STYLE_INTERACTIVE_EOL
+            elif state == STYLE_INTERACTIVE_BANNER:
+                if ch in "\r\n" and (chNext == "" or chNext in ">["):
+                    # Everything including me
+                    self.ColorSeg(startSeg, i - 1, state)
+                    startSeg = i
+                    state = STYLE_INTERACTIVE_EOL
+            else:
+                # It is a PythonColorizer state - seek past the end of the line
+                # and ask the Python colorizer to color that.
+                end = startSeg
+                while end < lengthDoc and cdoc[end] not in "\r\n".encode("ascii"):
+                    end = end + 1
+                self.ColorizePythonCode(cdoc[:end], startSeg, state)
+                stylePyStart = self.GetStringStyle(end - 1)
+                if stylePyStart is None:
+                    stylePyStart = pywin.scintilla.formatter.STYLE_DEFAULT
+                else:
+                    stylePyStart = stylePyStart.name
+                startSeg = end
+                i = end - 1  # ready for increment.
+                chNext = cdoc[end : end + 1].decode("latin-1")
+                state = STYLE_INTERACTIVE_EOL
+            if lastState != state:
+                lastState = state
+            i = i + 1
+        # and the rest
+        if startSeg < i:
+            self.ColorSeg(startSeg, i - 1, state)
+
+    def Colorize(self, start=0, end=-1):
+        # scintilla's formatting is all done in terms of utf, so
+        # we work with utf8 bytes instead of unicode.  This magically
+        # works as any extended chars found in the utf8 don't change
+        # the semantics.
+        stringVal = self.scintilla.GetTextRange(start, end, decode=False)
+        styleStart = None
+        stylePyStart = None
+        if start > 1:
+            # Likely we are being asked to color from the start of the line.
+            # We find the last formatted character on the previous line.
+            # If TQString, we continue it.  Otherwise, we reset.
+            look = start - 1
+            while look and self.scintilla.SCIGetCharAt(look) in "\n\r":
+                look = look - 1
+            if look and look < start - 1:  # Did we find a char before the \n\r sets?
+                strstyle = self.GetStringStyle(look)
+                quote_char = None
+                if strstyle is not None:
+                    if strstyle.name == pywin.scintilla.formatter.STYLE_TQSSTRING:
+                        quote_char = "'"
+                    elif strstyle.name == pywin.scintilla.formatter.STYLE_TQDSTRING:
+                        quote_char = '"'
+                    if quote_char is not None:
+                        # It is a TQS.  If the TQS is not terminated, we
+                        # carry the style through.
+                        if look > 2:
+                            look_str = (
+                                self.scintilla.SCIGetCharAt(look - 2)
+                                + self.scintilla.SCIGetCharAt(look - 1)
+                                + self.scintilla.SCIGetCharAt(look)
+                            )
+                            if look_str != quote_char * 3:
+                                stylePyStart = strstyle.name
+        if stylePyStart is None:
+            stylePyStart = pywin.scintilla.formatter.STYLE_DEFAULT
+
+        if start > 0:
+            stylenum = self.scintilla.SCIGetStyleAt(start - 1)
+            styleStart = self.GetStyleByNum(stylenum).name
+        elif self.bannerDisplayed:
+            styleStart = STYLE_INTERACTIVE_EOL
+        else:
+            styleStart = STYLE_INTERACTIVE_BANNER
+            self.bannerDisplayed = True
+        self.scintilla.SCIStartStyling(start, 31)
+        self.style_buffer = array.array("b", (0,) * len(stringVal))
+        self.ColorizeInteractiveCode(stringVal, styleStart, stylePyStart)
+        self.scintilla.SCISetStylingEx(self.style_buffer)
+        self.style_buffer = None
+
+
+###############################################################
+#
+# This class handles the Python interactive interpreter.
+#
+# It uses a basic EditWindow, and does all the magic.
+# This is triggered by the enter key hander attached by the
+# start-up code.  It determines if a command is to be executed
+# or continued (ie, emit "... ") by snooping around the current
+# line, looking for the prompts
+#
+class PythonwinInteractiveInterpreter(code.InteractiveInterpreter):
+    def __init__(self, locals=None, globals=None):
+        if locals is None:
+            locals = __main__.__dict__
+        if globals is None:
+            globals = locals
+        self.globals = globals
+        code.InteractiveInterpreter.__init__(self, locals)
+
+    def showsyntaxerror(self, filename=None):
+        sys.stderr.write(
+            tracebackHeader.decode("ascii")
+        )  # So the color syntaxer recognises it.
+        code.InteractiveInterpreter.showsyntaxerror(self, filename)
+
+    def runcode(self, code):
+        try:
+            exec(code, self.globals, self.locals)
+        except SystemExit:
+            raise
+        except:
+            self.showtraceback()
+
+
+class InteractiveCore:
+    def __init__(self, banner=None):
+        self.banner = banner
+
+    # 		LoadFontPreferences()
+    def Init(self):
+        self.oldStdOut = self.oldStdErr = None
+
+        # 		self.SetWordWrap(win32ui.CRichEditView_WrapNone)
+        self.interp = PythonwinInteractiveInterpreter()
+
+        self.OutputGrab()  # Release at cleanup.
+
+        if self.GetTextLength() == 0:
+            if self.banner is None:
+                suffix = ""
+                if win32ui.debug:
+                    suffix = ", debug build"
+                sys.stderr.write(
+                    "PythonWin %s on %s%s.\n" % (sys.version, sys.platform, suffix)
+                )
+                sys.stderr.write(
+                    "Portions %s - see 'Help/About PythonWin' for further copyright information.\n"
+                    % (win32ui.copyright,)
+                )
+            else:
+                sys.stderr.write(banner)
+        rcfile = os.environ.get("PYTHONSTARTUP")
+        if rcfile:
+            import __main__
+
+            try:
+                exec(
+                    compile(
+                        open(rcfile, "rb").read(), rcfile, "exec", dont_inherit=True
+                    ),
+                    __main__.__dict__,
+                    __main__.__dict__,
+                )
+            except:
+                sys.stderr.write(
+                    ">>> \nError executing PYTHONSTARTUP script %r\n" % (rcfile)
+                )
+                traceback.print_exc(file=sys.stderr)
+        self.AppendToPrompt([])
+
+    def SetContext(self, globals, locals, name="Dbg"):
+        oldPrompt = sys.ps1
+        if globals is None:
+            # Reset
+            sys.ps1 = ">>> "
+            sys.ps2 = "... "
+            locals = globals = __main__.__dict__
+        else:
+            sys.ps1 = "[%s]>>> " % name
+            sys.ps2 = "[%s]... " % name
+        self.interp.locals = locals
+        self.interp.globals = globals
+        self.AppendToPrompt([], oldPrompt)
+
+    def GetContext(self):
+        return self.interp.globals, self.interp.locals
+
+    def DoGetLine(self, line=-1):
+        if line == -1:
+            line = self.LineFromChar()
+        line = self.GetLine(line)
+        while line and line[-1] in ("\r", "\n"):
+            line = line[:-1]
+        return line
+
+    def AppendToPrompt(self, bufLines, oldPrompt=None):
+        "Take a command and stick it at the end of the buffer (with python prompts inserted if required)."
+        self.flush()
+        lastLineNo = self.GetLineCount() - 1
+        line = self.DoGetLine(lastLineNo)
+        if oldPrompt and line == oldPrompt:
+            self.SetSel(self.GetTextLength() - len(oldPrompt), self.GetTextLength())
+            self.ReplaceSel(sys.ps1)
+        elif line != str(sys.ps1):
+            if len(line) != 0:
+                self.write("\n")
+            self.write(sys.ps1)
+        self.flush()
+        self.idle.text.mark_set("iomark", "end-1c")
+        if not bufLines:
+            return
+        terms = (["\n" + sys.ps2] * (len(bufLines) - 1)) + [""]
+        for bufLine, term in zip(bufLines, terms):
+            if bufLine.strip():
+                self.write(bufLine + term)
+        self.flush()
+
+    def EnsureNoPrompt(self):
+        # Get ready to write some text NOT at a Python prompt.
+        self.flush()
+        lastLineNo = self.GetLineCount() - 1
+        line = self.DoGetLine(lastLineNo)
+        if not line or line in (sys.ps1, sys.ps2):
+            self.SetSel(self.GetTextLength() - len(line), self.GetTextLength())
+            self.ReplaceSel("")
+        else:
+            # Just add a new line.
+            self.write("\n")
+
+    def _GetSubConfigNames(self):
+        return ["interactive"]  # Allow [Keys:Interactive] sections to be specific
+
+    def HookHandlers(self):
+        # Hook menu command (executed when a menu item with that ID is selected from a menu/toolbar
+        self.HookCommand(self.OnSelectBlock, win32ui.ID_EDIT_SELECT_BLOCK)
+        self.HookCommand(self.OnEditCopyCode, ID_EDIT_COPY_CODE)
+        self.HookCommand(self.OnEditExecClipboard, ID_EDIT_EXEC_CLIPBOARD)
+        mod = pywin.scintilla.IDLEenvironment.GetIDLEModule("IdleHistory")
+        if mod is not None:
+            self.history = mod.History(self.idle.text, "\n" + sys.ps2)
+        else:
+            self.history = None
+        # hack for now for event handling.
+
+    # GetBlockBoundary takes a line number, and will return the
+    # start and and line numbers of the block, and a flag indicating if the
+    # block is a Python code block.
+    # If the line specified has a Python prompt, then the lines are parsed
+    # backwards and forwards, and the flag is true.
+    # If the line does not start with a prompt, the block is searched forward
+    # and backward until a prompt _is_ found, and all lines in between without
+    # prompts are returned, and the flag is false.
+    def GetBlockBoundary(self, lineNo):
+        line = self.DoGetLine(lineNo)
+        maxLineNo = self.GetLineCount() - 1
+        prefix = GetPromptPrefix(line)
+        if prefix is None:  # Non code block
+            flag = 0
+            startLineNo = lineNo
+            while startLineNo > 0:
+                if GetPromptPrefix(self.DoGetLine(startLineNo - 1)) is not None:
+                    break  # there _is_ a prompt
+                startLineNo = startLineNo - 1
+            endLineNo = lineNo
+            while endLineNo < maxLineNo:
+                if GetPromptPrefix(self.DoGetLine(endLineNo + 1)) is not None:
+                    break  # there _is_ a prompt
+                endLineNo = endLineNo + 1
+        else:  # Code block
+            flag = 1
+            startLineNo = lineNo
+            while startLineNo > 0 and prefix != str(sys.ps1):
+                prefix = GetPromptPrefix(self.DoGetLine(startLineNo - 1))
+                if prefix is None:
+                    break
+                    # there is no prompt.
+                startLineNo = startLineNo - 1
+            endLineNo = lineNo
+            while endLineNo < maxLineNo:
+                prefix = GetPromptPrefix(self.DoGetLine(endLineNo + 1))
+                if prefix is None:
+                    break  # there is no prompt
+                if prefix == str(sys.ps1):
+                    break  # this is another command
+                endLineNo = endLineNo + 1
+                # continue until end of buffer, or no prompt
+        return (startLineNo, endLineNo, flag)
+
+    def ExtractCommand(self, lines):
+        start, end = lines
+        retList = []
+        while end >= start:
+            thisLine = self.DoGetLine(end)
+            promptLen = len(GetPromptPrefix(thisLine))
+            retList = [thisLine[promptLen:]] + retList
+            end = end - 1
+        return retList
+
+    def OutputGrab(self):
+        # 		import win32traceutil; return
+        self.oldStdOut = sys.stdout
+        self.oldStdErr = sys.stderr
+        sys.stdout = self
+        sys.stderr = self
+        self.flush()
+
+    def OutputRelease(self):
+        # a command may have overwritten these - only restore if not.
+        if self.oldStdOut is not None:
+            if sys.stdout == self:
+                sys.stdout = self.oldStdOut
+        if self.oldStdErr is not None:
+            if sys.stderr == self:
+                sys.stderr = self.oldStdErr
+        self.oldStdOut = None
+        self.oldStdErr = None
+        self.flush()
+
+    ###################################
+    #
+    # Message/Command/Key Hooks.
+    #
+    # Enter key handler
+    #
+    def ProcessEnterEvent(self, event):
+        # If autocompletion has been triggered, complete and do not process event
+        if self.SCIAutoCActive():
+            self.SCIAutoCComplete()
+            self.SCICancel()
+            return
+
+        self.SCICancel()
+        # First, check for an error message
+        haveGrabbedOutput = 0
+        if self.HandleSpecialLine():
+            return 0
+
+        lineNo = self.LineFromChar()
+        start, end, isCode = self.GetBlockBoundary(lineNo)
+        # If we are not in a code block just go to the prompt (or create a new one)
+        if not isCode:
+            self.AppendToPrompt([])
+            win32ui.SetStatusText(win32ui.LoadString(afxres.AFX_IDS_IDLEMESSAGE))
+            return
+
+        lines = self.ExtractCommand((start, end))
+
+        # If we are in a code-block, but it isnt at the end of the buffer
+        # then copy it to the end ready for editing and subsequent execution
+        if end != self.GetLineCount() - 1:
+            win32ui.SetStatusText("Press ENTER to execute command")
+            self.AppendToPrompt(lines)
+            self.SetSel(-2)
+            return
+
+        # If SHIFT held down, we want new code here and now!
+        bNeedIndent = (
+            win32api.GetKeyState(win32con.VK_SHIFT) < 0
+            or win32api.GetKeyState(win32con.VK_CONTROL) < 0
+        )
+        if bNeedIndent:
+            self.ReplaceSel("\n")
+        else:
+            self.SetSel(-2)
+            self.ReplaceSel("\n")
+            source = "\n".join(lines)
+            while source and source[-1] in "\t ":
+                source = source[:-1]
+            self.OutputGrab()  # grab the output for the command exec.
+            try:
+                if self.interp.runsource(
+                    source, "<interactive input>"
+                ):  # Need more input!
+                    bNeedIndent = 1
+                else:
+                    # If the last line isnt empty, append a newline
+                    if self.history is not None:
+                        self.history.history_store(source)
+                    self.AppendToPrompt([])
+                    win32ui.SetStatusText(
+                        win32ui.LoadString(afxres.AFX_IDS_IDLEMESSAGE)
+                    )
+            # 					win32ui.SetStatusText('Successfully executed statement')
+            finally:
+                self.OutputRelease()
+        if bNeedIndent:
+            win32ui.SetStatusText("Ready to continue the command")
+            # Now attempt correct indentation (should use IDLE?)
+            curLine = self.DoGetLine(lineNo)[len(sys.ps2) :]
+            pos = 0
+            indent = ""
+            while len(curLine) > pos and curLine[pos] in string.whitespace:
+                indent = indent + curLine[pos]
+                pos = pos + 1
+            if _is_block_opener(curLine):
+                indent = indent + "\t"
+            elif _is_block_closer(curLine):
+                indent = indent[:-1]
+            # use ReplaceSel to ensure it goes at the cursor rather than end of buffer.
+            self.ReplaceSel(sys.ps2 + indent)
+        return 0
+
+    # ESC key handler
+    def ProcessEscEvent(self, event):
+        # Implement a cancel.
+        if self.SCIAutoCActive() or self.SCICallTipActive():
+            self.SCICancel()
+        else:
+            win32ui.SetStatusText("Cancelled.")
+            self.AppendToPrompt(("",))
+        return 0
+
+    def OnSelectBlock(self, command, code):
+        lineNo = self.LineFromChar()
+        start, end, isCode = self.GetBlockBoundary(lineNo)
+        startIndex = self.LineIndex(start)
+        endIndex = self.LineIndex(end + 1) - 2  # skip \r + \n
+        if endIndex < 0:  # must be beyond end of buffer
+            endIndex = -2  # self.Length()
+        self.SetSel(startIndex, endIndex)
+
+    def OnEditCopyCode(self, command, code):
+        """Sanitizes code from interactive window, removing prompts and output,
+        and inserts it in the clipboard."""
+        code = self.GetSelText()
+        lines = code.splitlines()
+        out_lines = []
+        for line in lines:
+            if line.startswith(sys.ps1):
+                line = line[len(sys.ps1) :]
+                out_lines.append(line)
+            elif line.startswith(sys.ps2):
+                line = line[len(sys.ps2) :]
+                out_lines.append(line)
+        out_code = os.linesep.join(out_lines)
+        win32clipboard.OpenClipboard()
+        try:
+            win32clipboard.SetClipboardData(
+                win32clipboard.CF_UNICODETEXT, str(out_code)
+            )
+        finally:
+            win32clipboard.CloseClipboard()
+
+    def OnEditExecClipboard(self, command, code):
+        """Executes python code directly from the clipboard."""
+        win32clipboard.OpenClipboard()
+        try:
+            code = win32clipboard.GetClipboardData(win32clipboard.CF_UNICODETEXT)
+        finally:
+            win32clipboard.CloseClipboard()
+
+        code = code.replace("\r\n", "\n") + "\n"
+        try:
+            o = compile(code, "<clipboard>", "exec")
+            exec(o, __main__.__dict__)
+        except:
+            traceback.print_exc()
+
+    def GetRightMenuItems(self):
+        # Just override parents
+        ret = []
+        flags = 0
+        ret.append((flags, win32ui.ID_EDIT_UNDO, "&Undo"))
+        ret.append(win32con.MF_SEPARATOR)
+        ret.append((flags, win32ui.ID_EDIT_CUT, "Cu&t"))
+        ret.append((flags, win32ui.ID_EDIT_COPY, "&Copy"))
+
+        start, end = self.GetSel()
+        if start != end:
+            ret.append((flags, ID_EDIT_COPY_CODE, "Copy code without prompts"))
+        if win32clipboard.IsClipboardFormatAvailable(win32clipboard.CF_UNICODETEXT):
+            ret.append(
+                (flags, ID_EDIT_EXEC_CLIPBOARD, "Execute python code from clipboard")
+            )
+
+        ret.append((flags, win32ui.ID_EDIT_PASTE, "&Paste"))
+        ret.append(win32con.MF_SEPARATOR)
+        ret.append((flags, win32ui.ID_EDIT_SELECT_ALL, "&Select all"))
+        ret.append((flags, win32ui.ID_EDIT_SELECT_BLOCK, "Select &block"))
+        ret.append((flags, win32ui.ID_VIEW_WHITESPACE, "View &Whitespace"))
+        return ret
+
+    def MDINextEvent(self, event):
+        win32ui.GetMainFrame().MDINext(0)
+
+    def MDIPrevEvent(self, event):
+        win32ui.GetMainFrame().MDINext(0)
+
+    def WindowBackEvent(self, event):
+        parent = self.GetParentFrame()
+        if parent == win32ui.GetMainFrame():
+            # It is docked.
+            try:
+                wnd, isactive = parent.MDIGetActive()
+                wnd.SetFocus()
+            except win32ui.error:
+                # No MDI window active!
+                pass
+        else:
+            # Normal Window
+            try:
+                lastActive = self.GetParentFrame().lastActive
+                # If the window is invalid, reset it.
+                if lastActive is not None and (
+                    lastActive._obj_ is None or lastActive.GetSafeHwnd() == 0
+                ):
+                    lastActive = self.GetParentFrame().lastActive = None
+                    win32ui.SetStatusText("The last active Window has been closed.")
+            except AttributeError:
+                print("Can't find the last active window!")
+                lastActive = None
+            if lastActive is not None:
+                lastActive.MDIActivate()
+
+
+class InteractiveView(InteractiveCore, winout.WindowOutputView):
+    def __init__(self, doc):
+        InteractiveCore.__init__(self)
+        winout.WindowOutputView.__init__(self, doc)
+        self.encoding = pywin.default_scintilla_encoding
+
+    def _MakeColorizer(self):
+        return InteractiveFormatter(self)
+
+    def OnInitialUpdate(self):
+        winout.WindowOutputView.OnInitialUpdate(self)
+        self.SetWordWrap()
+        self.Init()
+
+    def HookHandlers(self):
+        winout.WindowOutputView.HookHandlers(self)
+        InteractiveCore.HookHandlers(self)
+
+
+class CInteractivePython(winout.WindowOutput):
+    def __init__(self, makeDoc=None, makeFrame=None):
+        self.IsFinalDestroy = 0
+        winout.WindowOutput.__init__(
+            self,
+            sectionProfile,
+            sectionProfile,
+            winout.flags.WQ_LINE,
+            1,
+            None,
+            makeDoc,
+            makeFrame,
+            InteractiveView,
+        )
+        self.Create()
+
+    def OnViewDestroy(self, view):
+        if self.IsFinalDestroy:
+            view.OutputRelease()
+        winout.WindowOutput.OnViewDestroy(self, view)
+
+    def Close(self):
+        self.IsFinalDestroy = 1
+        winout.WindowOutput.Close(self)
+
+
+class InteractiveFrame(winout.WindowOutputFrame):
+    def __init__(self):
+        self.lastActive = None
+        winout.WindowOutputFrame.__init__(self)
+
+    def OnMDIActivate(self, bActive, wndActive, wndDeactive):
+        if bActive:
+            self.lastActive = wndDeactive
+
+
+######################################################################
+##
+## Dockable Window Support
+##
+######################################################################
+ID_DOCKED_INTERACTIVE_CONTROLBAR = 0xE802
+
+DockedInteractiveViewParent = InteractiveView
+
+
+class DockedInteractiveView(DockedInteractiveViewParent):
+    def HookHandlers(self):
+        DockedInteractiveViewParent.HookHandlers(self)
+        self.HookMessage(self.OnSetFocus, win32con.WM_SETFOCUS)
+        self.HookMessage(self.OnKillFocus, win32con.WM_KILLFOCUS)
+
+    def OnSetFocus(self, msg):
+        self.GetParentFrame().SetActiveView(self)
+        return 1
+
+    def OnKillFocus(self, msg):
+        # If we are losing focus to another in this app, reset the main frame's active view.
+        hwnd = wparam = msg[2]
+        try:
+            wnd = win32ui.CreateWindowFromHandle(hwnd)
+            reset = wnd.GetTopLevelFrame() == self.GetTopLevelFrame()
+        except win32ui.error:
+            reset = 0  # Not my window
+        if reset:
+            self.GetParentFrame().SetActiveView(None)
+        return 1
+
+    def OnDestroy(self, msg):
+        newSize = self.GetWindowPlacement()[4]
+        pywin.framework.app.SaveWindowSize("Interactive Window", newSize, "docked")
+        try:
+            if self.GetParentFrame().GetActiveView == self:
+                self.GetParentFrame().SetActiveView(None)
+        except win32ui.error:
+            pass
+        try:
+            if win32ui.GetMainFrame().GetActiveView() == self:
+                win32ui.GetMainFrame().SetActiveView(None)
+        except win32ui.error:
+            pass
+        return DockedInteractiveViewParent.OnDestroy(self, msg)
+
+
+class CDockedInteractivePython(CInteractivePython):
+    def __init__(self, dockbar):
+        self.bFirstCreated = 0
+        self.dockbar = dockbar
+        CInteractivePython.__init__(self)
+
+    def NeedRecreateWindow(self):
+        if self.bCreating:
+            return 0
+        try:
+            frame = win32ui.GetMainFrame()
+            if frame.closing:
+                return 0  # Dieing!
+        except (win32ui.error, AttributeError):
+            return 0  # The app is dieing!
+        try:
+            cb = frame.GetControlBar(ID_DOCKED_INTERACTIVE_CONTROLBAR)
+            return not cb.IsWindowVisible()
+        except win32ui.error:
+            return 1  # Control bar does not exist!
+
+    def RecreateWindow(self):
+        try:
+            dockbar = win32ui.GetMainFrame().GetControlBar(
+                ID_DOCKED_INTERACTIVE_CONTROLBAR
+            )
+            win32ui.GetMainFrame().ShowControlBar(dockbar, 1, 1)
+        except win32ui.error:
+            CreateDockedInteractiveWindow()
+
+    def Create(self):
+        self.bCreating = 1
+        doc = InteractiveDocument(None, self.DoCreateDoc())
+        view = DockedInteractiveView(doc)
+        defRect = pywin.framework.app.LoadWindowSize("Interactive Window", "docked")
+        if defRect[2] - defRect[0] == 0:
+            defRect = 0, 0, 500, 200
+        style = win32con.WS_CHILD | win32con.WS_VISIBLE | win32con.WS_BORDER
+        id = 1050  # win32ui.AFX_IDW_PANE_FIRST
+        view.CreateWindow(self.dockbar, id, style, defRect)
+        view.OnInitialUpdate()
+        self.bFirstCreated = 1
+
+        self.currentView = doc.GetFirstView()
+        self.bCreating = 0
+        if self.title:
+            doc.SetTitle(self.title)
+
+
+# The factory we pass to the dockable window support.
+def InteractiveViewCreator(parent):
+    global edit
+    edit = CDockedInteractivePython(parent)
+    return edit.currentView
+
+
+def CreateDockedInteractiveWindow():
+    # Later, the DockingBar should be capable of hosting multiple
+    # children.
+    from pywin.docking.DockingBar import DockingBar
+
+    bar = DockingBar()
+    creator = InteractiveViewCreator
+    bar.CreateWindow(
+        win32ui.GetMainFrame(),
+        creator,
+        "Interactive Window",
+        ID_DOCKED_INTERACTIVE_CONTROLBAR,
+    )
+    bar.SetBarStyle(
+        bar.GetBarStyle()
+        | afxres.CBRS_TOOLTIPS
+        | afxres.CBRS_FLYBY
+        | afxres.CBRS_SIZE_DYNAMIC
+    )
+    bar.EnableDocking(afxres.CBRS_ALIGN_ANY)
+    win32ui.GetMainFrame().DockControlBar(bar, afxres.AFX_IDW_DOCKBAR_BOTTOM)
+
+
+######################################################################
+#
+# The public interface to this module.
+#
+######################################################################
+# No extra functionality now, but maybe later, so
+# publicize these names.
+InteractiveDocument = winout.WindowOutputDocument
+
+# We remember our one and only interactive window in the "edit" variable.
+edit = None
+
+
+def CreateInteractiveWindowUserPreference(makeDoc=None, makeFrame=None):
+    """Create some sort of interactive window if the user's preference say we should."""
+    bCreate = LoadPreference("Show at startup", 1)
+    if bCreate:
+        CreateInteractiveWindow(makeDoc, makeFrame)
+
+
+def CreateInteractiveWindow(makeDoc=None, makeFrame=None):
+    """Create a standard or docked interactive window unconditionally"""
+    assert edit is None, "Creating second interactive window!"
+    bDocking = LoadPreference("Docking", 0)
+    if bDocking:
+        CreateDockedInteractiveWindow()
+    else:
+        CreateMDIInteractiveWindow(makeDoc, makeFrame)
+    assert edit is not None, "Created interactive window, but did not set the global!"
+    edit.currentView.SetFocus()
+
+
+def CreateMDIInteractiveWindow(makeDoc=None, makeFrame=None):
+    """Create a standard (non-docked) interactive window unconditionally"""
+    global edit
+    if makeDoc is None:
+        makeDoc = InteractiveDocument
+    if makeFrame is None:
+        makeFrame = InteractiveFrame
+    edit = CInteractivePython(makeDoc=makeDoc, makeFrame=makeFrame)
+
+
+def DestroyInteractiveWindow():
+    """Destroy the interactive window.
+    This is different to Closing the window,
+    which may automatically re-appear.  Once destroyed, it can never be recreated,
+    and a complete new instance must be created (which the various other helper
+    functions will then do after making this call
+    """
+    global edit
+    if edit is not None and edit.currentView is not None:
+        if edit.currentView.GetParentFrame() == win32ui.GetMainFrame():
+            # It is docked - do nothing now (this is only called at shutdown!)
+            pass
+        else:
+            # It is a standard window - call Close on the container.
+            edit.Close()
+            edit = None
+
+
+def CloseInteractiveWindow():
+    """Close the interactive window, allowing it to be re-created on demand."""
+    global edit
+    if edit is not None and edit.currentView is not None:
+        if edit.currentView.GetParentFrame() == win32ui.GetMainFrame():
+            # It is docked, just hide the dock bar.
+            frame = win32ui.GetMainFrame()
+            cb = frame.GetControlBar(ID_DOCKED_INTERACTIVE_CONTROLBAR)
+            frame.ShowControlBar(cb, 0, 1)
+        else:
+            # It is a standard window - destroy the frame/view, allowing the object itself to remain.
+            edit.currentView.GetParentFrame().DestroyWindow()
+
+
+def ToggleInteractiveWindow():
+    """If the interactive window is visible, hide it, otherwise show it."""
+    if edit is None:
+        CreateInteractiveWindow()
+    else:
+        if edit.NeedRecreateWindow():
+            edit.RecreateWindow()
+        else:
+            # Close it, allowing a reopen.
+            CloseInteractiveWindow()
+
+
+def ShowInteractiveWindow():
+    """Shows (or creates if necessary) an interactive window"""
+    if edit is None:
+        CreateInteractiveWindow()
+    else:
+        if edit.NeedRecreateWindow():
+            edit.RecreateWindow()
+        else:
+            parent = edit.currentView.GetParentFrame()
+            if parent == win32ui.GetMainFrame():  # It is docked.
+                edit.currentView.SetFocus()
+            else:  # It is a "normal" window
+                edit.currentView.GetParentFrame().AutoRestore()
+                win32ui.GetMainFrame().MDIActivate(edit.currentView.GetParentFrame())
+
+
+def IsInteractiveWindowVisible():
+    return edit is not None and not edit.NeedRecreateWindow()
diff --git a/lib/pythonwin/pywin/framework/intpyapp.py b/lib/pythonwin/pywin/framework/intpyapp.py
new file mode 100644
index 00000000..48461dba
--- /dev/null
+++ b/lib/pythonwin/pywin/framework/intpyapp.py
@@ -0,0 +1,555 @@
+# intpyapp.py  - Interactive Python application class
+#
+import os
+import sys
+import traceback
+
+import __main__
+import commctrl
+import win32api
+import win32con
+import win32ui
+from pywin.mfc import afxres, dialog
+
+from . import app, dbgcommands
+
+lastLocateFileName = ".py"  # used in the "File/Locate" dialog...
+
+
+# todo - _SetupSharedMenu should be moved to a framework class.
+def _SetupSharedMenu_(self):
+    sharedMenu = self.GetSharedMenu()
+    from pywin.framework import toolmenu
+
+    toolmenu.SetToolsMenu(sharedMenu)
+    from pywin.framework import help
+
+    help.SetHelpMenuOtherHelp(sharedMenu)
+
+
+from pywin.mfc import docview
+
+docview.DocTemplate._SetupSharedMenu_ = _SetupSharedMenu_
+
+
+class MainFrame(app.MainFrame):
+    def OnCreate(self, createStruct):
+        self.closing = 0
+        if app.MainFrame.OnCreate(self, createStruct) == -1:
+            return -1
+        style = (
+            win32con.WS_CHILD
+            | afxres.CBRS_SIZE_DYNAMIC
+            | afxres.CBRS_TOP
+            | afxres.CBRS_TOOLTIPS
+            | afxres.CBRS_FLYBY
+        )
+
+        self.EnableDocking(afxres.CBRS_ALIGN_ANY)
+
+        tb = win32ui.CreateToolBar(self, style | win32con.WS_VISIBLE)
+        tb.ModifyStyle(0, commctrl.TBSTYLE_FLAT)
+        tb.LoadToolBar(win32ui.IDR_MAINFRAME)
+        tb.EnableDocking(afxres.CBRS_ALIGN_ANY)
+        tb.SetWindowText("Standard")
+        self.DockControlBar(tb)
+        # Any other packages which use toolbars
+        from pywin.debugger.debugger import PrepareControlBars
+
+        PrepareControlBars(self)
+        # Note "interact" also uses dockable windows, but they already happen
+
+        # And a "Tools" menu on the main frame.
+        menu = self.GetMenu()
+        from . import toolmenu
+
+        toolmenu.SetToolsMenu(menu, 2)
+        # And fix the "Help" menu on the main frame
+        from pywin.framework import help
+
+        help.SetHelpMenuOtherHelp(menu)
+
+    def OnClose(self):
+        try:
+            import pywin.debugger
+
+            if (
+                pywin.debugger.currentDebugger is not None
+                and pywin.debugger.currentDebugger.pumping
+            ):
+                try:
+                    pywin.debugger.currentDebugger.close(1)
+                except:
+                    traceback.print_exc()
+                return
+        except win32ui.error:
+            pass
+        self.closing = 1
+        self.SaveBarState("ToolbarDefault")
+        self.SetActiveView(None)  # Otherwise MFC's OnClose may _not_ prompt for save.
+
+        from pywin.framework import help
+
+        help.FinalizeHelp()
+
+        self.DestroyControlBar(afxres.AFX_IDW_TOOLBAR)
+        self.DestroyControlBar(win32ui.ID_VIEW_TOOLBAR_DBG)
+
+        return self._obj_.OnClose()
+
+    def DestroyControlBar(self, id):
+        try:
+            bar = self.GetControlBar(id)
+        except win32ui.error:
+            return
+        bar.DestroyWindow()
+
+    def OnCommand(self, wparam, lparam):
+        # By default, the current MDI child frame will process WM_COMMAND
+        # messages before any docked control bars - even if the control bar
+        # has focus.  This is a problem for the interactive window when docked.
+        # Therefore, we detect the situation of a view having the main frame
+        # as its parent, and assume it must be a docked view (which it will in an MDI app)
+        try:
+            v = (
+                self.GetActiveView()
+            )  # Raise an exception if none - good - then we want default handling
+            # Main frame _does_ have a current view (ie, a docking view) - see if it wants it.
+            if v.OnCommand(wparam, lparam):
+                return 1
+        except (win32ui.error, AttributeError):
+            pass
+        return self._obj_.OnCommand(wparam, lparam)
+
+
+class InteractivePythonApp(app.CApp):
+    # This works if necessary - just we dont need to override the Run method.
+    # 	def Run(self):
+    # 		return self._obj_.Run()
+
+    def HookCommands(self):
+        app.CApp.HookCommands(self)
+        dbgcommands.DebuggerCommandHandler().HookCommands()
+        self.HookCommand(self.OnViewBrowse, win32ui.ID_VIEW_BROWSE)
+        self.HookCommand(self.OnFileImport, win32ui.ID_FILE_IMPORT)
+        self.HookCommand(self.OnFileCheck, win32ui.ID_FILE_CHECK)
+        self.HookCommandUpdate(self.OnUpdateFileCheck, win32ui.ID_FILE_CHECK)
+        self.HookCommand(self.OnFileRun, win32ui.ID_FILE_RUN)
+        self.HookCommand(self.OnFileLocate, win32ui.ID_FILE_LOCATE)
+        self.HookCommand(self.OnInteractiveWindow, win32ui.ID_VIEW_INTERACTIVE)
+        self.HookCommandUpdate(
+            self.OnUpdateInteractiveWindow, win32ui.ID_VIEW_INTERACTIVE
+        )
+        self.HookCommand(self.OnViewOptions, win32ui.ID_VIEW_OPTIONS)
+        self.HookCommand(self.OnHelpIndex, afxres.ID_HELP_INDEX)
+        self.HookCommand(self.OnFileSaveAll, win32ui.ID_FILE_SAVE_ALL)
+        self.HookCommand(self.OnViewToolbarDbg, win32ui.ID_VIEW_TOOLBAR_DBG)
+        self.HookCommandUpdate(self.OnUpdateViewToolbarDbg, win32ui.ID_VIEW_TOOLBAR_DBG)
+
+    def CreateMainFrame(self):
+        return MainFrame()
+
+    def MakeExistingDDEConnection(self):
+        # Use DDE to connect to an existing instance
+        # Return None if no existing instance
+        try:
+            from . import intpydde
+        except ImportError:
+            # No dde support!
+            return None
+        conv = intpydde.CreateConversation(self.ddeServer)
+        try:
+            conv.ConnectTo("Pythonwin", "System")
+            return conv
+        except intpydde.error:
+            return None
+
+    def InitDDE(self):
+        # Do all the magic DDE handling.
+        # Returns TRUE if we have pumped the arguments to our
+        # remote DDE app, and we should terminate.
+        try:
+            from . import intpydde
+        except ImportError:
+            self.ddeServer = None
+            intpydde = None
+        if intpydde is not None:
+            self.ddeServer = intpydde.DDEServer(self)
+            self.ddeServer.Create("Pythonwin", intpydde.CBF_FAIL_SELFCONNECTIONS)
+            try:
+                # If there is an existing instance, pump the arguments to it.
+                connection = self.MakeExistingDDEConnection()
+                if connection is not None:
+                    connection.Exec("self.Activate()")
+                    if self.ProcessArgs(sys.argv, connection) is None:
+                        return 1
+            except:
+                # It is too early to 'print' an exception - we
+                # don't have stdout setup yet!
+                win32ui.DisplayTraceback(
+                    sys.exc_info(), " - error in DDE conversation with Pythonwin"
+                )
+                return 1
+
+    def InitInstance(self):
+        # Allow "/nodde" and "/new" to optimize this!
+        if (
+            "/nodde" not in sys.argv
+            and "/new" not in sys.argv
+            and "-nodde" not in sys.argv
+            and "-new" not in sys.argv
+        ):
+            if self.InitDDE():
+                return 1  # A remote DDE client is doing it for us!
+        else:
+            self.ddeServer = None
+
+        win32ui.SetRegistryKey(
+            "Python %s" % (sys.winver,)
+        )  # MFC automatically puts the main frame caption on!
+        app.CApp.InitInstance(self)
+
+        # Create the taskbar icon
+        win32ui.CreateDebuggerThread()
+
+        # Allow Pythonwin to host OCX controls.
+        win32ui.EnableControlContainer()
+
+        # Display the interactive window if the user wants it.
+        from . import interact
+
+        interact.CreateInteractiveWindowUserPreference()
+
+        # Load the modules we use internally.
+        self.LoadSystemModules()
+
+        # Load additional module the user may want.
+        self.LoadUserModules()
+
+        # Load the ToolBar state near the end of the init process, as
+        # there may be Toolbar IDs created by the user or other modules.
+        # By now all these modules should be loaded, so all the toolbar IDs loaded.
+        try:
+            self.frame.LoadBarState("ToolbarDefault")
+        except win32ui.error:
+            # MFC sucks.  It does essentially "GetDlgItem(x)->Something", so if the
+            # toolbar with ID x does not exist, MFC crashes!  Pythonwin has a trap for this
+            # but I need to investigate more how to prevent it (AFAIK, ensuring all the
+            # toolbars are created by now _should_ stop it!)
+            pass
+
+        # Finally process the command line arguments.
+        try:
+            self.ProcessArgs(sys.argv)
+        except:
+            # too early for printing anything.
+            win32ui.DisplayTraceback(
+                sys.exc_info(), " - error processing command line args"
+            )
+
+    def ExitInstance(self):
+        win32ui.DestroyDebuggerThread()
+        try:
+            from . import interact
+
+            interact.DestroyInteractiveWindow()
+        except:
+            pass
+        if self.ddeServer is not None:
+            self.ddeServer.Shutdown()
+            self.ddeServer = None
+        return app.CApp.ExitInstance(self)
+
+    def Activate(self):
+        # Bring to the foreground.  Mainly used when another app starts up, it asks
+        # this one to activate itself, then it terminates.
+        frame = win32ui.GetMainFrame()
+        frame.SetForegroundWindow()
+        if frame.GetWindowPlacement()[1] == win32con.SW_SHOWMINIMIZED:
+            frame.ShowWindow(win32con.SW_RESTORE)
+
+    def ProcessArgs(self, args, dde=None):
+        # If we are going to talk to a remote app via DDE, then
+        # activate it!
+        if (
+            len(args) < 1 or not args[0]
+        ):  # argv[0]=='' when started without args, just like Python.exe!
+            return
+
+        i = 0
+        while i < len(args):
+            argType = args[i]
+            i += 1
+            if argType.startswith("-"):
+                # Support dash options. Slash options are misinterpreted by python init
+                # as path and not finding usually 'C:\\' ends up in sys.path[0]
+                argType = "/" + argType[1:]
+            if not argType.startswith("/"):
+                argType = win32ui.GetProfileVal(
+                    "Python", "Default Arg Type", "/edit"
+                ).lower()
+                i -= 1  #  arg is /edit's parameter
+            par = i < len(args) and args[i] or "MISSING"
+            if argType in ("/nodde", "/new", "-nodde", "-new"):
+                # Already handled
+                pass
+            elif argType.startswith("/goto:"):
+                gotoline = int(argType[len("/goto:") :])
+                if dde:
+                    dde.Exec(
+                        "from pywin.framework import scriptutils\n"
+                        "ed = scriptutils.GetActiveEditControl()\n"
+                        "if ed: ed.SetSel(ed.LineIndex(%s - 1))" % gotoline
+                    )
+                else:
+                    from . import scriptutils
+
+                    ed = scriptutils.GetActiveEditControl()
+                    if ed:
+                        ed.SetSel(ed.LineIndex(gotoline - 1))
+            elif argType == "/edit":
+                # Load up the default application.
+                i += 1
+                fname = win32api.GetFullPathName(par)
+                if not os.path.isfile(fname):
+                    # if we don't catch this, OpenDocumentFile() (actually
+                    # PyCDocument.SetPathName() in
+                    # pywin.scintilla.document.CScintillaDocument.OnOpenDocument)
+                    # segfaults Pythonwin on recent PY3 builds (b228)
+                    win32ui.MessageBox(
+                        "No such file: %s\n\nCommand Line: %s"
+                        % (fname, win32api.GetCommandLine()),
+                        "Open file for edit",
+                        win32con.MB_ICONERROR,
+                    )
+                    continue
+                if dde:
+                    dde.Exec("win32ui.GetApp().OpenDocumentFile(%s)" % (repr(fname)))
+                else:
+                    win32ui.GetApp().OpenDocumentFile(par)
+            elif argType == "/rundlg":
+                if dde:
+                    dde.Exec(
+                        "from pywin.framework import scriptutils;scriptutils.RunScript(%r, %r, 1)"
+                        % (par, " ".join(args[i + 1 :]))
+                    )
+                else:
+                    from . import scriptutils
+
+                    scriptutils.RunScript(par, " ".join(args[i + 1 :]))
+                return
+            elif argType == "/run":
+                if dde:
+                    dde.Exec(
+                        "from pywin.framework import scriptutils;scriptutils.RunScript(%r, %r, 0)"
+                        % (par, " ".join(args[i + 1 :]))
+                    )
+                else:
+                    from . import scriptutils
+
+                    scriptutils.RunScript(par, " ".join(args[i + 1 :]), 0)
+                return
+            elif argType == "/app":
+                raise RuntimeError(
+                    "/app only supported for new instances of Pythonwin.exe"
+                )
+            elif argType == "/dde":  # Send arbitary command
+                if dde is not None:
+                    dde.Exec(par)
+                else:
+                    win32ui.MessageBox(
+                        "The /dde command can only be used\r\nwhen Pythonwin is already running"
+                    )
+                i += 1
+            else:
+                raise ValueError("Command line argument not recognised: %s" % argType)
+
+    def LoadSystemModules(self):
+        self.DoLoadModules("pywin.framework.editor,pywin.framework.stdin")
+
+    def LoadUserModules(self, moduleNames=None):
+        # Load the users modules.
+        if moduleNames is None:
+            default = "pywin.framework.sgrepmdi,pywin.framework.mdi_pychecker"
+            moduleNames = win32ui.GetProfileVal("Python", "Startup Modules", default)
+        self.DoLoadModules(moduleNames)
+
+    def DoLoadModules(self, moduleNames):  # ", sep string of module names.
+        if not moduleNames:
+            return
+        modules = moduleNames.split(",")
+        for module in modules:
+            try:
+                __import__(module)
+            except:  # Catch em all, else the app itself dies! 'ImportError:
+                traceback.print_exc()
+                msg = 'Startup import of user module "%s" failed' % module
+                print(msg)
+                win32ui.MessageBox(msg)
+
+    #
+    # DDE Callback
+    #
+    def OnDDECommand(self, command):
+        try:
+            exec(command + "\n")
+        except:
+            print("ERROR executing DDE command: ", command)
+            traceback.print_exc()
+            raise
+
+    #
+    # General handlers
+    #
+    def OnViewBrowse(self, id, code):
+        "Called when ViewBrowse message is received"
+        from pywin.tools import browser
+
+        obName = dialog.GetSimpleInput("Object", "__builtins__", "Browse Python Object")
+        if obName is None:
+            return
+        try:
+            browser.Browse(eval(obName, __main__.__dict__, __main__.__dict__))
+        except NameError:
+            win32ui.MessageBox("This is no object with this name")
+        except AttributeError:
+            win32ui.MessageBox("The object has no attribute of that name")
+        except:
+            traceback.print_exc()
+            win32ui.MessageBox("This object can not be browsed")
+
+    def OnFileImport(self, id, code):
+        "Called when a FileImport message is received. Import the current or specified file"
+        from . import scriptutils
+
+        scriptutils.ImportFile()
+
+    def OnFileCheck(self, id, code):
+        "Called when a FileCheck message is received. Check the current file."
+        from . import scriptutils
+
+        scriptutils.CheckFile()
+
+    def OnUpdateFileCheck(self, cmdui):
+        from . import scriptutils
+
+        cmdui.Enable(scriptutils.GetActiveFileName(0) is not None)
+
+    def OnFileRun(self, id, code):
+        "Called when a FileRun message is received."
+        from . import scriptutils
+
+        showDlg = win32api.GetKeyState(win32con.VK_SHIFT) >= 0
+        scriptutils.RunScript(None, None, showDlg)
+
+    def OnFileLocate(self, id, code):
+        from . import scriptutils
+
+        global lastLocateFileName  # save the new version away for next time...
+
+        name = dialog.GetSimpleInput(
+            "File name", lastLocateFileName, "Locate Python File"
+        )
+        if name is None:  # Cancelled.
+            return
+        lastLocateFileName = name
+        # if ".py" supplied, rip it off!
+        # should also check for .pys and .pyw
+        if lastLocateFileName[-3:].lower() == ".py":
+            lastLocateFileName = lastLocateFileName[:-3]
+        lastLocateFileName = lastLocateFileName.replace(".", "\\")
+        newName = scriptutils.LocatePythonFile(lastLocateFileName)
+        if newName is None:
+            win32ui.MessageBox("The file '%s' can not be located" % lastLocateFileName)
+        else:
+            win32ui.GetApp().OpenDocumentFile(newName)
+
+    # Display all the "options" proprety pages we can find
+    def OnViewOptions(self, id, code):
+        win32ui.InitRichEdit()
+        sheet = dialog.PropertySheet("Pythonwin Options")
+        # Add property pages we know about that need manual work.
+        from pywin.dialogs import ideoptions
+
+        sheet.AddPage(ideoptions.OptionsPropPage())
+
+        from . import toolmenu
+
+        sheet.AddPage(toolmenu.ToolMenuPropPage())
+
+        # Get other dynamic pages from templates.
+        pages = []
+        for template in self.GetDocTemplateList():
+            try:
+                # Dont actually call the function with the exception handler.
+                getter = template.GetPythonPropertyPages
+            except AttributeError:
+                # Template does not provide property pages!
+                continue
+            pages = pages + getter()
+
+        # Debugger template goes at the end
+        try:
+            from pywin.debugger import configui
+        except ImportError:
+            configui = None
+        if configui is not None:
+            pages.append(configui.DebuggerOptionsPropPage())
+        # Now simply add the pages, and display the dialog.
+        for page in pages:
+            sheet.AddPage(page)
+
+        if sheet.DoModal() == win32con.IDOK:
+            win32ui.SetStatusText("Applying configuration changes...", 1)
+            win32ui.DoWaitCursor(1)
+            # Tell every Window in our app that win.ini has changed!
+            win32ui.GetMainFrame().SendMessageToDescendants(
+                win32con.WM_WININICHANGE, 0, 0
+            )
+            win32ui.DoWaitCursor(0)
+
+    def OnInteractiveWindow(self, id, code):
+        # toggle the existing state.
+        from . import interact
+
+        interact.ToggleInteractiveWindow()
+
+    def OnUpdateInteractiveWindow(self, cmdui):
+        try:
+            interact = sys.modules["pywin.framework.interact"]
+            state = interact.IsInteractiveWindowVisible()
+        except KeyError:  # Interactive module hasnt ever been imported.
+            state = 0
+        cmdui.Enable()
+        cmdui.SetCheck(state)
+
+    def OnFileSaveAll(self, id, code):
+        # Only attempt to save editor documents.
+        from pywin.framework.editor import editorTemplate
+
+        num = 0
+        for doc in editorTemplate.GetDocumentList():
+            if doc.IsModified() and doc.GetPathName():
+                num = num = 1
+                doc.OnSaveDocument(doc.GetPathName())
+        win32ui.SetStatusText("%d documents saved" % num, 1)
+
+    def OnViewToolbarDbg(self, id, code):
+        if code == 0:
+            return not win32ui.GetMainFrame().OnBarCheck(id)
+
+    def OnUpdateViewToolbarDbg(self, cmdui):
+        win32ui.GetMainFrame().OnUpdateControlBarMenu(cmdui)
+        cmdui.Enable(1)
+
+    def OnHelpIndex(self, id, code):
+        from . import help
+
+        help.SelectAndRunHelpFile()
+
+
+# As per the comments in app.py, this use is depreciated.
+# app.AppBuilder = InteractivePythonApp
+
+# Now all we do is create the application
+thisApp = InteractivePythonApp()
diff --git a/lib/pythonwin/pywin/framework/intpydde.py b/lib/pythonwin/pywin/framework/intpydde.py
new file mode 100644
index 00000000..1f869b0f
--- /dev/null
+++ b/lib/pythonwin/pywin/framework/intpydde.py
@@ -0,0 +1,60 @@
+# DDE support for Pythonwin
+#
+# Seems to work fine (in the context that IE4 seems to have broken
+# DDE on _all_ NT4 machines I have tried, but only when a "Command Prompt" window
+# is open.  Strange, but true.  If you have problems with this, close all Command Prompts!
+
+
+import sys
+import traceback
+
+import win32api
+import win32ui
+from dde import *
+from pywin.mfc import object
+
+
+class DDESystemTopic(object.Object):
+    def __init__(self, app):
+        self.app = app
+        object.Object.__init__(self, CreateServerSystemTopic())
+
+    def Exec(self, data):
+        try:
+            # 			print "Executing", cmd
+            self.app.OnDDECommand(data)
+        except:
+            t, v, tb = sys.exc_info()
+            # The DDE Execution failed.
+            print("Error executing DDE command.")
+            traceback.print_exception(t, v, tb)
+            return 0
+
+
+class DDEServer(object.Object):
+    def __init__(self, app):
+        self.app = app
+        object.Object.__init__(self, CreateServer())
+        self.topic = self.item = None
+
+    def CreateSystemTopic(self):
+        return DDESystemTopic(self.app)
+
+    def Shutdown(self):
+        self._obj_.Shutdown()
+        self._obj_.Destroy()
+        if self.topic is not None:
+            self.topic.Destroy()
+            self.topic = None
+        if self.item is not None:
+            self.item.Destroy()
+            self.item = None
+
+    def OnCreate(self):
+        return 1
+
+    def Status(self, msg):
+        try:
+            win32ui.SetStatusText(msg)
+        except win32ui.error:
+            pass
diff --git a/lib/pythonwin/pywin/framework/mdi_pychecker.py b/lib/pythonwin/pywin/framework/mdi_pychecker.py
new file mode 100644
index 00000000..c89f33b9
--- /dev/null
+++ b/lib/pythonwin/pywin/framework/mdi_pychecker.py
@@ -0,0 +1,849 @@
+######################################################################
+##
+## The Pychecker MDI Plug-In UserModule for Pythonwin
+##
+## contributed by Robert Kiendl
+##
+## Style is similar to (and inherited) from the SGrepMDI UserModule
+##
+## Usage:
+##
+## Start Pychecker on current file: Menu/File/New../Pychecker.
+## Use it: Jump to Pychecker warning source lines by double-click.
+## Auto-add "#$pycheck_no" / "#$pycheck_no=specific-re-pattern" tags
+## to source lines by context/right-mouse-click on warning lines.
+##
+## It requires pychecker installed and the pychecker.bat to be on
+## the PATH. Example pychecker.bat:
+##
+##   REM pychecker.bat
+##   C:\bin\python.exe C:\PYTHON23\Lib\site-packages\pychecker\checker.py %1 %2 %3 %4 %5 %6 %7 %8 %9
+##
+## Adding it as default module in PythonWin:
+##
+##  +++ ./intpyapp.py	2006-10-02 17:59:32.974161600 +0200
+##  @@ -272,7 +282,7 @@
+## 	def LoadUserModules(self, moduleNames = None):
+## 		# Load the users modules.
+## 		if moduleNames is None:
+##  -			default = "sgrepmdi"
+##  +			default = "sgrepmdi,mdi_pychecker"
+## 			moduleNames=win32ui.GetProfileVal('Python','Startup Modules',default)
+## 		self.DoLoadModules(moduleNames)
+##
+######################################################################
+
+import glob
+import os
+import re
+import sys
+import time
+
+import win32api
+import win32con
+import win32ui
+from pywin.mfc import dialog, docview, window
+
+from . import scriptutils
+
+
+def getsubdirs(d):
+    dlist = []
+    flist = glob.glob(d + "\\*")
+    for f in flist:
+        if os.path.isdir(f):
+            dlist.append(f)
+            dlist = dlist + getsubdirs(f)
+    return dlist
+
+
+class dirpath:
+    def __init__(self, str, recurse=0):
+        dp = str.split(";")
+        dirs = {}
+        for d in dp:
+            if os.path.isdir(d):
+                d = d.lower()
+                if d not in dirs:
+                    dirs[d] = None
+                    if recurse:
+                        subdirs = getsubdirs(d)
+                        for sd in subdirs:
+                            sd = sd.lower()
+                            if sd not in dirs:
+                                dirs[sd] = None
+            elif os.path.isfile(d):
+                pass
+            else:
+                x = None
+                if d in os.environ:
+                    x = dirpath(os.environ[d])
+                elif d[:5] == "HKEY_":
+                    keystr = d.split("\\")
+                    try:
+                        root = eval("win32con." + keystr[0])
+                    except:
+                        win32ui.MessageBox(
+                            "Can't interpret registry key name '%s'" % keystr[0]
+                        )
+                    try:
+                        subkey = "\\".join(keystr[1:])
+                        val = win32api.RegQueryValue(root, subkey)
+                        if val:
+                            x = dirpath(val)
+                        else:
+                            win32ui.MessageBox(
+                                "Registry path '%s' did not return a path entry" % d
+                            )
+                    except:
+                        win32ui.MessageBox(
+                            "Can't interpret registry key value: %s" % keystr[1:]
+                        )
+                else:
+                    win32ui.MessageBox("Directory '%s' not found" % d)
+                if x:
+                    for xd in x:
+                        if xd not in dirs:
+                            dirs[xd] = None
+                            if recurse:
+                                subdirs = getsubdirs(xd)
+                                for sd in subdirs:
+                                    sd = sd.lower()
+                                    if sd not in dirs:
+                                        dirs[sd] = None
+        self.dirs = []
+        for d in dirs.keys():
+            self.dirs.append(d)
+
+    def __getitem__(self, key):
+        return self.dirs[key]
+
+    def __len__(self):
+        return len(self.dirs)
+
+    def __setitem__(self, key, value):
+        self.dirs[key] = value
+
+    def __delitem__(self, key):
+        del self.dirs[key]
+
+    def __getslice__(self, lo, hi):
+        return self.dirs[lo:hi]
+
+    def __setslice__(self, lo, hi, seq):
+        self.dirs[lo:hi] = seq
+
+    def __delslice__(self, lo, hi):
+        del self.dirs[lo:hi]
+
+    def __add__(self, other):
+        if type(other) == type(self) or type(other) == type([]):
+            return self.dirs + other.dirs
+
+    def __radd__(self, other):
+        if type(other) == type(self) or type(other) == type([]):
+            return other.dirs + self.dirs
+
+
+# Group(1) is the filename, group(2) is the lineno.
+# regexGrepResult=regex.compile("^\\([a-zA-Z]:.*\\)(\\([0-9]+\\))")
+# regexGrep=re.compile(r"^([a-zA-Z]:[^(]*)\((\d+)\)")
+regexGrep = re.compile(r"^(..[^\(:]+)?[\(:](\d+)[\):]:?\s*(.*)")
+
+# these are the atom numbers defined by Windows for basic dialog controls
+
+BUTTON = 0x80
+EDIT = 0x81
+STATIC = 0x82
+LISTBOX = 0x83
+SCROLLBAR = 0x84
+COMBOBOX = 0x85
+
+
+class TheTemplate(docview.RichEditDocTemplate):
+    def __init__(self):
+        docview.RichEditDocTemplate.__init__(
+            self, win32ui.IDR_TEXTTYPE, TheDocument, TheFrame, TheView
+        )
+        self.SetDocStrings(
+            "\nPychecker\nPychecker\nPychecker params (*.pychecker)\n.pychecker\n\n\n"
+        )
+        win32ui.GetApp().AddDocTemplate(self)
+        self.docparams = None
+
+    def MatchDocType(self, fileName, fileType):
+        doc = self.FindOpenDocument(fileName)
+        if doc:
+            return doc
+        ext = os.path.splitext(fileName)[1].lower()
+        if ext == ".pychecker":
+            return win32ui.CDocTemplate_Confidence_yesAttemptNative
+        return win32ui.CDocTemplate_Confidence_noAttempt
+
+    def setParams(self, params):
+        self.docparams = params
+
+    def readParams(self):
+        tmp = self.docparams
+        self.docparams = None
+        return tmp
+
+
+class TheFrame(window.MDIChildWnd):
+    # The template and doc params will one day be removed.
+    def __init__(self, wnd=None):
+        window.MDIChildWnd.__init__(self, wnd)
+
+
+class TheDocument(docview.RichEditDoc):
+    def __init__(self, template):
+        docview.RichEditDoc.__init__(self, template)
+        self.dirpattern = ""
+        self.filpattern = ""
+        self.greppattern = ""
+        self.casesensitive = 1
+        self.recurse = 1
+        self.verbose = 0
+
+    def OnOpenDocument(self, fnm):
+        # this bizarre stuff with params is so right clicking in a result window
+        # and starting a new grep can communicate the default parameters to the
+        # new grep.
+        try:
+            params = open(fnm, "r").read()
+        except:
+            params = None
+        self.setInitParams(params)
+        return self.OnNewDocument()
+
+    def OnCloseDocument(self):
+        try:
+            win32ui.GetApp().DeleteIdleHandler(self.idleHandler)
+        except:
+            pass
+        return self._obj_.OnCloseDocument()
+
+    def saveInitParams(self):
+        # Only save the flags, not the text boxes.
+        paramstr = "\t\t\t%d\t%d" % (self.casesensitive, self.recurse)
+        win32ui.WriteProfileVal("Pychecker", "Params", paramstr)
+
+    def setInitParams(self, paramstr):
+        if paramstr is None:
+            paramstr = win32ui.GetProfileVal("Pychecker", "Params", "\t\t\t1\t0\t0")
+        params = paramstr.split("\t")
+        if len(params) < 3:
+            params = params + [""] * (3 - len(params))
+        if len(params) < 6:
+            params = params + [0] * (6 - len(params))
+        self.dirpattern = params[0]
+        self.filpattern = params[1]
+        self.greppattern = params[2] or "-#1000 --only"
+        self.casesensitive = int(params[3])
+        self.recurse = int(params[4])
+        self.verbose = int(params[5])
+        # setup some reasonable defaults.
+        if not self.dirpattern:
+            try:
+                editor = win32ui.GetMainFrame().MDIGetActive()[0].GetEditorView()
+                self.dirpattern = os.path.abspath(
+                    os.path.dirname(editor.GetDocument().GetPathName())
+                )
+            except (AttributeError, win32ui.error):
+                self.dirpattern = os.getcwd()
+        if not self.filpattern:
+            try:
+                editor = win32ui.GetMainFrame().MDIGetActive()[0].GetEditorView()
+                self.filpattern = editor.GetDocument().GetPathName()
+            except AttributeError:
+                self.filpattern = "*.py"
+
+    def OnNewDocument(self):
+        if self.dirpattern == "":
+            self.setInitParams(greptemplate.readParams())
+        d = TheDialog(
+            self.dirpattern,
+            self.filpattern,
+            self.greppattern,
+            self.casesensitive,
+            self.recurse,
+            self.verbose,
+        )
+        if d.DoModal() == win32con.IDOK:
+            self.dirpattern = d["dirpattern"]
+            self.filpattern = d["filpattern"]
+            self.greppattern = d["greppattern"]
+            # self.casesensitive = d['casesensitive']
+            # self.recurse = d['recursive']
+            # self.verbose = d['verbose']
+            self.doSearch()
+            self.saveInitParams()
+            return 1
+        return 0  # cancelled - return zero to stop frame creation.
+
+    def doSearch(self):
+        self.dp = dirpath(self.dirpattern, self.recurse)
+        self.SetTitle(
+            "Pychecker Run '%s' (options: %s)" % (self.filpattern, self.greppattern)
+        )
+        # self.text = []
+        self.GetFirstView().Append(
+            "#Pychecker Run in " + self.dirpattern + "  %s\n" % time.asctime()
+        )
+        if self.verbose:
+            self.GetFirstView().Append("#   =" + repr(self.dp.dirs) + "\n")
+        self.GetFirstView().Append("# Files   " + self.filpattern + "\n")
+        self.GetFirstView().Append("# Options " + self.greppattern + "\n")
+        self.fplist = self.filpattern.split(";")
+        self.GetFirstView().Append(
+            "# Running...  ( double click on result lines in order to jump to the source code ) \n"
+        )
+        win32ui.SetStatusText("Pychecker running.  Please wait...", 0)
+        self.dpndx = self.fpndx = 0
+        self.fndx = -1
+        if not self.dp:
+            self.GetFirstView().Append(
+                "# ERROR: '%s' does not resolve to any search locations"
+                % self.dirpattern
+            )
+            self.SetModifiedFlag(0)
+        else:
+            ##self.flist = glob.glob(self.dp[0]+'\\'+self.fplist[0])
+            import operator
+
+            self.flist = reduce(operator.add, list(map(glob.glob, self.fplist)))
+            # import pywin.debugger;pywin.debugger.set_trace()
+            self.startPycheckerRun()
+
+    def idleHandler(self, handler, count):
+        import time
+
+        time.sleep(0.001)
+        if self.result != None:
+            win32ui.GetApp().DeleteIdleHandler(self.idleHandler)
+            return 0
+        return 1  # more
+
+    def startPycheckerRun(self):
+        self.result = None
+        old = win32api.SetCursor(win32api.LoadCursor(0, win32con.IDC_APPSTARTING))
+        win32ui.GetApp().AddIdleHandler(self.idleHandler)
+        import _thread
+
+        _thread.start_new(self.threadPycheckerRun, ())
+        ##win32api.SetCursor(old)
+
+    def threadPycheckerRun(self):
+        result = ""
+        rc = -1
+        try:
+            options = self.greppattern
+            files = " ".join(self.flist)
+            # Recently MarkH has failed to run pychecker without it having
+            # been explicitly installed - so we assume it is and locate it
+            # from its default location.
+            # Step1 - get python.exe
+            py = os.path.join(sys.prefix, "python.exe")
+            if not os.path.isfile(py):
+                if "64 bit" in sys.version:
+                    py = os.path.join(sys.prefix, "PCBuild", "amd64", "python.exe")
+                else:
+                    py = os.path.join(sys.prefix, "PCBuild", "python.exe")
+            try:
+                py = win32api.GetShortPathName(py)
+            except win32api.error:
+                py = ""
+            # Find checker.py
+            import sysconfig
+
+            pychecker = os.path.join(
+                sysconfig.get_paths()["purelib"], "pychecker", "checker.py"
+            )
+            if not os.path.isfile(py):
+                result = "Can't find python.exe!\n"
+            elif not os.path.isfile(pychecker):
+                result = (
+                    "Can't find checker.py - please install pychecker "
+                    "(or run 'setup.py install' if you have the source version)\n"
+                )
+            else:
+                cmd = '%s "%s" %s %s 2>&1' % (py, pychecker, options, files)
+                ##fin,fout,ferr=os.popen3(cmd)
+                ##result=ferr.read()+fout.read()
+                result = os.popen(cmd).read()
+                ##rc=f.close()
+            self.GetFirstView().Append(result)
+        finally:
+            self.result = result
+            print("== Pychecker run finished ==")
+            self.GetFirstView().Append("\n" + "== Pychecker run finished ==")
+            self.SetModifiedFlag(0)
+
+    def _inactive_idleHandler(self, handler, count):
+        self.fndx = self.fndx + 1
+        if self.fndx < len(self.flist):
+            f = self.flist[self.fndx]
+            if self.verbose:
+                self.GetFirstView().Append("# .." + f + "\n")
+            win32ui.SetStatusText("Searching " + f, 0)
+            lines = open(f, "r").readlines()
+            for i in range(len(lines)):
+                line = lines[i]
+                if self.pat.search(line) != None:
+                    self.GetFirstView().Append(f + "(" + repr(i + 1) + ") " + line)
+        else:
+            self.fndx = -1
+            self.fpndx = self.fpndx + 1
+            if self.fpndx < len(self.fplist):
+                self.flist = glob.glob(
+                    self.dp[self.dpndx] + "\\" + self.fplist[self.fpndx]
+                )
+            else:
+                self.fpndx = 0
+                self.dpndx = self.dpndx + 1
+                if self.dpndx < len(self.dp):
+                    self.flist = glob.glob(
+                        self.dp[self.dpndx] + "\\" + self.fplist[self.fpndx]
+                    )
+                else:
+                    win32ui.SetStatusText("Search complete.", 0)
+                    self.SetModifiedFlag(0)  # default to not modified.
+                    try:
+                        win32ui.GetApp().DeleteIdleHandler(self.idleHandler)
+                    except:
+                        pass
+                    return 0
+        return 1
+
+    def GetParams(self):
+        return (
+            self.dirpattern
+            + "\t"
+            + self.filpattern
+            + "\t"
+            + self.greppattern
+            + "\t"
+            + repr(self.casesensitive)
+            + "\t"
+            + repr(self.recurse)
+            + "\t"
+            + repr(self.verbose)
+        )
+
+    def OnSaveDocument(self, filename):
+        #       print 'OnSaveDocument() filename=',filename
+        savefile = open(filename, "wb")
+        txt = self.GetParams() + "\n"
+        #       print 'writing',txt
+        savefile.write(txt)
+        savefile.close()
+        self.SetModifiedFlag(0)
+        return 1
+
+
+ID_OPEN_FILE = 0xE500
+ID_PYCHECKER = 0xE501
+ID_SAVERESULTS = 0x502
+ID_TRYAGAIN = 0x503
+ID_ADDCOMMENT = 0x504
+ID_ADDPYCHECKNO2 = 0x505
+
+
+class TheView(docview.RichEditView):
+    def __init__(self, doc):
+        docview.RichEditView.__init__(self, doc)
+        self.SetWordWrap(win32ui.CRichEditView_WrapNone)
+        self.HookHandlers()
+
+    def OnInitialUpdate(self):
+        rc = self._obj_.OnInitialUpdate()
+        format = (-402653169, 0, 200, 0, 0, 0, 49, "Courier New")
+        self.SetDefaultCharFormat(format)
+        return rc
+
+    def HookHandlers(self):
+        self.HookMessage(self.OnRClick, win32con.WM_RBUTTONDOWN)
+        self.HookCommand(self.OnCmdOpenFile, ID_OPEN_FILE)
+        self.HookCommand(self.OnCmdThe, ID_PYCHECKER)
+        self.HookCommand(self.OnCmdSave, ID_SAVERESULTS)
+        self.HookCommand(self.OnTryAgain, ID_TRYAGAIN)
+        self.HookCommand(self.OnAddComment, ID_ADDCOMMENT)
+        self.HookCommand(self.OnAddComment, ID_ADDPYCHECKNO2)
+        self.HookMessage(self.OnLDblClick, win32con.WM_LBUTTONDBLCLK)
+
+    def OnLDblClick(self, params):
+        line = self.GetLine()
+        regexGrepResult = regexGrep.match(line)
+        if regexGrepResult:
+            fname = regexGrepResult.group(1)
+            line = int(regexGrepResult.group(2))
+            scriptutils.JumpToDocument(fname, line)
+            return 0  # dont pass on
+        return 1  # pass it on by default.
+
+    def OnRClick(self, params):
+        menu = win32ui.CreatePopupMenu()
+        flags = win32con.MF_STRING | win32con.MF_ENABLED
+        lineno = self._obj_.LineFromChar(-1)  # selection or current line
+        line = self._obj_.GetLine(lineno)
+        regexGrepResult = regexGrep.match(line)
+        charstart, charend = self._obj_.GetSel()
+        if regexGrepResult:
+            self.fnm = regexGrepResult.group(1)
+            self.lnnum = int(regexGrepResult.group(2))
+            menu.AppendMenu(flags, ID_OPEN_FILE, "&Open " + self.fnm)
+            menu.AppendMenu(
+                flags, ID_ADDCOMMENT, "&Add to source: Comment Tag/#$pycheck_no .."
+            )
+            menu.AppendMenu(
+                flags,
+                ID_ADDPYCHECKNO2,
+                "&Add to source: Specific #$pycheck_no=%(errtext)s ..",
+            )
+            menu.AppendMenu(win32con.MF_SEPARATOR)
+        menu.AppendMenu(flags, ID_TRYAGAIN, "&Try Again")
+        menu.AppendMenu(flags, win32ui.ID_EDIT_CUT, "Cu&t")
+        menu.AppendMenu(flags, win32ui.ID_EDIT_COPY, "&Copy")
+        menu.AppendMenu(flags, win32ui.ID_EDIT_PASTE, "&Paste")
+        menu.AppendMenu(flags, win32con.MF_SEPARATOR)
+        menu.AppendMenu(flags, win32ui.ID_EDIT_SELECT_ALL, "&Select all")
+        menu.AppendMenu(flags, win32con.MF_SEPARATOR)
+        menu.AppendMenu(flags, ID_SAVERESULTS, "Sa&ve results")
+        menu.TrackPopupMenu(params[5])
+        return 0
+
+    def OnAddComment(self, cmd, code):
+        addspecific = cmd == ID_ADDPYCHECKNO2
+        _ = list(self.GetSel())
+        _.sort()
+        start, end = _
+        line_start, line_end = self.LineFromChar(start), self.LineFromChar(end)
+        first = 1
+        for i in range(line_start, line_end + 1):
+            line = self.GetLine(i)
+            m = regexGrep.match(line)
+            if m:
+                if first:
+                    first = 0
+                    cmnt = dialog.GetSimpleInput(
+                        "Add to %s lines" % (line_end - line_start + 1),
+                        addspecific
+                        and "  #$pycheck_no=%(errtext)s"
+                        or "  #$pycheck_no",
+                    )
+                    if not cmnt:
+                        return 0
+                ##import pywin.debugger;pywin.debugger.set_trace()
+                fname = m.group(1)
+                line = int(m.group(2))
+                view = scriptutils.JumpToDocument(fname, line)
+                pos = view.LineIndex(line) - 1
+                if view.GetTextRange(pos - 1, pos) in ("\r", "\n"):
+                    pos -= 1
+                view.SetSel(pos, pos)
+                errtext = m.group(3)
+                if start != end and line_start == line_end:
+                    errtext = self.GetSelText()
+                errtext = repr(re.escape(errtext).replace("\ ", " "))
+                view.ReplaceSel(addspecific and cmnt % locals() or cmnt)
+        return 0
+
+    def OnCmdOpenFile(self, cmd, code):
+        doc = win32ui.GetApp().OpenDocumentFile(self.fnm)
+        if doc:
+            vw = doc.GetFirstView()
+            # hope you have an editor that implements GotoLine()!
+            try:
+                vw.GotoLine(int(self.lnnum))
+            except:
+                pass
+        return 0
+
+    def OnCmdThe(self, cmd, code):
+        curparamsstr = self.GetDocument().GetParams()
+        params = curparamsstr.split("\t")
+        params[2] = self.sel
+        greptemplate.setParams("\t".join(params))
+        greptemplate.OpenDocumentFile()
+        return 0
+
+    def OnTryAgain(self, cmd, code):
+        greptemplate.setParams(self.GetDocument().GetParams())
+        greptemplate.OpenDocumentFile()
+        return 0
+
+    def OnCmdSave(self, cmd, code):
+        flags = win32con.OFN_OVERWRITEPROMPT
+        dlg = win32ui.CreateFileDialog(
+            0, None, None, flags, "Text Files (*.txt)|*.txt||", self
+        )
+        dlg.SetOFNTitle("Save Results As")
+        if dlg.DoModal() == win32con.IDOK:
+            pn = dlg.GetPathName()
+            self._obj_.SaveFile(pn)
+        return 0
+
+    def Append(self, strng):
+        numlines = self.GetLineCount()
+        endpos = self.LineIndex(numlines - 1) + len(self.GetLine(numlines - 1))
+        self.SetSel(endpos, endpos)
+        self.ReplaceSel(strng)
+
+
+class TheDialog(dialog.Dialog):
+    def __init__(self, dp, fp, gp, cs, r, v):
+        style = (
+            win32con.DS_MODALFRAME
+            | win32con.WS_POPUP
+            | win32con.WS_VISIBLE
+            | win32con.WS_CAPTION
+            | win32con.WS_SYSMENU
+            | win32con.DS_SETFONT
+        )
+        CS = win32con.WS_CHILD | win32con.WS_VISIBLE
+        tmp = [
+            ["Pychecker Run", (0, 0, 210, 90), style, None, (8, "MS Sans Serif")],
+        ]
+        tmp.append([STATIC, "Files:", -1, (7, 7, 50, 9), CS])
+        tmp.append(
+            [
+                EDIT,
+                gp,
+                103,
+                (52, 7, 144, 11),
+                CS | win32con.WS_TABSTOP | win32con.ES_AUTOHSCROLL | win32con.WS_BORDER,
+            ]
+        )
+        tmp.append([STATIC, "Directories:", -1, (7, 20, 50, 9), CS])
+        tmp.append(
+            [
+                EDIT,
+                dp,
+                102,
+                (52, 20, 128, 11),
+                CS | win32con.WS_TABSTOP | win32con.ES_AUTOHSCROLL | win32con.WS_BORDER,
+            ]
+        )
+        tmp.append(
+            [
+                BUTTON,
+                "...",
+                110,
+                (182, 20, 16, 11),
+                CS | win32con.BS_PUSHBUTTON | win32con.WS_TABSTOP,
+            ]
+        )
+        tmp.append([STATIC, "Options:", -1, (7, 33, 50, 9), CS])
+        tmp.append(
+            [
+                EDIT,
+                fp,
+                101,
+                (52, 33, 128, 11),
+                CS | win32con.WS_TABSTOP | win32con.ES_AUTOHSCROLL | win32con.WS_BORDER,
+            ]
+        )
+        tmp.append(
+            [
+                BUTTON,
+                "...",
+                111,
+                (182, 33, 16, 11),
+                CS | win32con.BS_PUSHBUTTON | win32con.WS_TABSTOP,
+            ]
+        )
+        # tmp.append([BUTTON,'Case sensitive',       104, (7,  45,  72,  9), CS | win32con.BS_AUTOCHECKBOX | win32con.BS_LEFTTEXT| win32con.WS_TABSTOP])
+        # tmp.append([BUTTON,'Subdirectories',       105, (7,  56,  72,  9), CS | win32con.BS_AUTOCHECKBOX | win32con.BS_LEFTTEXT| win32con.WS_TABSTOP])
+        # tmp.append([BUTTON,'Verbose',              106, (7,  67,  72,  9), CS | win32con.BS_AUTOCHECKBOX | win32con.BS_LEFTTEXT| win32con.WS_TABSTOP])
+        tmp.append(
+            [
+                BUTTON,
+                "OK",
+                win32con.IDOK,
+                (166, 53, 32, 12),
+                CS | win32con.BS_DEFPUSHBUTTON | win32con.WS_TABSTOP,
+            ]
+        )
+        tmp.append(
+            [
+                BUTTON,
+                "Cancel",
+                win32con.IDCANCEL,
+                (166, 67, 32, 12),
+                CS | win32con.BS_PUSHBUTTON | win32con.WS_TABSTOP,
+            ]
+        )
+        dialog.Dialog.__init__(self, tmp)
+        self.AddDDX(101, "greppattern")
+        self.AddDDX(102, "dirpattern")
+        self.AddDDX(103, "filpattern")
+        # self.AddDDX(104,'casesensitive')
+        # self.AddDDX(105,'recursive')
+        # self.AddDDX(106,'verbose')
+        self._obj_.data["greppattern"] = gp
+        self._obj_.data["dirpattern"] = dp
+        self._obj_.data["filpattern"] = fp
+        # self._obj_.data['casesensitive']  = cs
+        # self._obj_.data['recursive'] = r
+        # self._obj_.data['verbose']  = v
+        self.HookCommand(self.OnMoreDirectories, 110)
+        self.HookCommand(self.OnMoreFiles, 111)
+
+    def OnMoreDirectories(self, cmd, code):
+        self.getMore("Pychecker\\Directories", "dirpattern")
+
+    def OnMoreFiles(self, cmd, code):
+        self.getMore("Pychecker\\File Types", "filpattern")
+
+    def getMore(self, section, key):
+        self.UpdateData(1)
+        # get the items out of the ini file
+        ini = win32ui.GetProfileFileName()
+        secitems = win32api.GetProfileSection(section, ini)
+        items = []
+        for secitem in secitems:
+            items.append(secitem.split("=")[1])
+        dlg = TheParamsDialog(items)
+        if dlg.DoModal() == win32con.IDOK:
+            itemstr = ";".join(dlg.getItems())
+            self._obj_.data[key] = itemstr
+            # update the ini file with dlg.getNew()
+            i = 0
+            newitems = dlg.getNew()
+            if newitems:
+                items = items + newitems
+                for item in items:
+                    win32api.WriteProfileVal(section, repr(i), item, ini)
+                    i = i + 1
+            self.UpdateData(0)
+
+    def OnOK(self):
+        self.UpdateData(1)
+        for id, name in (
+            (101, "greppattern"),
+            (102, "dirpattern"),
+            (103, "filpattern"),
+        ):
+            if not self[name]:
+                self.GetDlgItem(id).SetFocus()
+                win32api.MessageBeep()
+                win32ui.SetStatusText("Please enter a value")
+                return
+        self._obj_.OnOK()
+
+
+class TheParamsDialog(dialog.Dialog):
+    def __init__(self, items):
+        self.items = items
+        self.newitems = []
+        style = (
+            win32con.DS_MODALFRAME
+            | win32con.WS_POPUP
+            | win32con.WS_VISIBLE
+            | win32con.WS_CAPTION
+            | win32con.WS_SYSMENU
+            | win32con.DS_SETFONT
+        )
+        CS = win32con.WS_CHILD | win32con.WS_VISIBLE
+        tmp = [
+            [
+                "Pychecker Parameters",
+                (0, 0, 205, 100),
+                style,
+                None,
+                (8, "MS Sans Serif"),
+            ],
+        ]
+        tmp.append(
+            [
+                LISTBOX,
+                "",
+                107,
+                (7, 7, 150, 72),
+                CS
+                | win32con.LBS_MULTIPLESEL
+                | win32con.LBS_STANDARD
+                | win32con.LBS_HASSTRINGS
+                | win32con.WS_TABSTOP
+                | win32con.LBS_NOTIFY,
+            ]
+        )
+        tmp.append(
+            [
+                BUTTON,
+                "OK",
+                win32con.IDOK,
+                (167, 7, 32, 12),
+                CS | win32con.BS_DEFPUSHBUTTON | win32con.WS_TABSTOP,
+            ]
+        )
+        tmp.append(
+            [
+                BUTTON,
+                "Cancel",
+                win32con.IDCANCEL,
+                (167, 23, 32, 12),
+                CS | win32con.BS_PUSHBUTTON | win32con.WS_TABSTOP,
+            ]
+        )
+        tmp.append([STATIC, "New:", -1, (2, 83, 15, 12), CS])
+        tmp.append(
+            [
+                EDIT,
+                "",
+                108,
+                (18, 83, 139, 12),
+                CS | win32con.WS_TABSTOP | win32con.ES_AUTOHSCROLL | win32con.WS_BORDER,
+            ]
+        )
+        tmp.append(
+            [
+                BUTTON,
+                "Add",
+                109,
+                (167, 83, 32, 12),
+                CS | win32con.BS_PUSHBUTTON | win32con.WS_TABSTOP,
+            ]
+        )
+        dialog.Dialog.__init__(self, tmp)
+        self.HookCommand(self.OnAddItem, 109)
+        self.HookCommand(self.OnListDoubleClick, 107)
+
+    def OnInitDialog(self):
+        lb = self.GetDlgItem(107)
+        for item in self.items:
+            lb.AddString(item)
+        return self._obj_.OnInitDialog()
+
+    def OnAddItem(self, cmd, code):
+        eb = self.GetDlgItem(108)
+        item = eb.GetLine(0)
+        self.newitems.append(item)
+        lb = self.GetDlgItem(107)
+        i = lb.AddString(item)
+        lb.SetSel(i, 1)
+        return 1
+
+    def OnListDoubleClick(self, cmd, code):
+        if code == win32con.LBN_DBLCLK:
+            self.OnOK()
+            return 1
+
+    def OnOK(self):
+        lb = self.GetDlgItem(107)
+        self.selections = lb.GetSelTextItems()
+        self._obj_.OnOK()
+
+    def getItems(self):
+        return self.selections
+
+    def getNew(self):
+        return self.newitems
+
+
+try:
+    win32ui.GetApp().RemoveDocTemplate(greptemplate)
+except NameError:
+    pass
+
+greptemplate = TheTemplate()
diff --git a/lib/pythonwin/pywin/framework/scriptutils.py b/lib/pythonwin/pywin/framework/scriptutils.py
new file mode 100644
index 00000000..e5bc57c8
--- /dev/null
+++ b/lib/pythonwin/pywin/framework/scriptutils.py
@@ -0,0 +1,688 @@
+"""
+Various utilities for running/importing a script
+"""
+import bdb
+import linecache
+import os
+import sys
+import traceback
+
+import __main__
+import win32api
+import win32con
+import win32ui
+from pywin.mfc import dialog
+from pywin.mfc.docview import TreeView
+
+from .cmdline import ParseArgs
+
+RS_DEBUGGER_NONE = 0  # Dont run under the debugger.
+RS_DEBUGGER_STEP = 1  # Start stepping under the debugger
+RS_DEBUGGER_GO = 2  # Just run under the debugger, stopping only at break-points.
+RS_DEBUGGER_PM = 3  # Dont run under debugger, but do post-mortem analysis on exception.
+
+debugging_options = """No debugging
+Step-through in the debugger
+Run in the debugger
+Post-Mortem of unhandled exceptions""".split(
+    "\n"
+)
+
+byte_cr = "\r".encode("ascii")
+byte_lf = "\n".encode("ascii")
+byte_crlf = "\r\n".encode("ascii")
+
+
+# A dialog box for the "Run Script" command.
+class DlgRunScript(dialog.Dialog):
+    "A class for the 'run script' dialog"
+
+    def __init__(self, bHaveDebugger):
+        dialog.Dialog.__init__(self, win32ui.IDD_RUN_SCRIPT)
+        self.AddDDX(win32ui.IDC_EDIT1, "script")
+        self.AddDDX(win32ui.IDC_EDIT2, "args")
+        self.AddDDX(win32ui.IDC_COMBO1, "debuggingType", "i")
+        self.HookCommand(self.OnBrowse, win32ui.IDC_BUTTON2)
+        self.bHaveDebugger = bHaveDebugger
+
+    def OnInitDialog(self):
+        rc = dialog.Dialog.OnInitDialog(self)
+        cbo = self.GetDlgItem(win32ui.IDC_COMBO1)
+        for o in debugging_options:
+            cbo.AddString(o)
+        cbo.SetCurSel(self["debuggingType"])
+        if not self.bHaveDebugger:
+            cbo.EnableWindow(0)
+
+    def OnBrowse(self, id, code):
+        if code != 0:  # BN_CLICKED
+            return 1
+        openFlags = win32con.OFN_OVERWRITEPROMPT | win32con.OFN_FILEMUSTEXIST
+        dlg = win32ui.CreateFileDialog(
+            1, None, None, openFlags, "Python Scripts (*.py)|*.py||", self
+        )
+        dlg.SetOFNTitle("Run Script")
+        if dlg.DoModal() != win32con.IDOK:
+            return 0
+        self["script"] = dlg.GetPathName()
+        self.UpdateData(0)
+        return 0
+
+
+def GetDebugger():
+    """Get the default Python debugger.  Returns the debugger, or None.
+
+    It is assumed the debugger has a standard "pdb" defined interface.
+    Currently always returns the 'pywin.debugger' debugger, or None
+    (pdb is _not_ returned as it is not effective in this GUI environment)
+    """
+    try:
+        import pywin.debugger
+
+        return pywin.debugger
+    except ImportError:
+        return None
+
+
+def IsOnPythonPath(path):
+    "Given a path only, see if it is on the Pythonpath.  Assumes path is a full path spec."
+    # must check that the command line arg's path is in sys.path
+    for syspath in sys.path:
+        try:
+            # Python 1.5 and later allows an empty sys.path entry.
+            if syspath and win32ui.FullPath(syspath) == path:
+                return 1
+        except win32ui.error as details:
+            print(
+                "Warning: The sys.path entry '%s' is invalid\n%s" % (syspath, details)
+            )
+    return 0
+
+
+def GetPackageModuleName(fileName):
+    """Given a filename, return (module name, new path).
+    eg - given "c:\a\b\c\my.py", return ("b.c.my",None) if "c:\a" is on sys.path.
+    If no package found, will return ("my", "c:\a\b\c")
+    """
+    path, fname = os.path.split(fileName)
+    path = origPath = win32ui.FullPath(path)
+    fname = os.path.splitext(fname)[0]
+    modBits = []
+    newPathReturn = None
+    if not IsOnPythonPath(path):
+        # Module not directly on the search path - see if under a package.
+        while len(path) > 3:  # ie 'C:\'
+            path, modBit = os.path.split(path)
+            modBits.append(modBit)
+            # If on path, _and_ existing package of that name loaded.
+            if (
+                IsOnPythonPath(path)
+                and modBit in sys.modules
+                and (
+                    os.path.exists(os.path.join(path, modBit, "__init__.py"))
+                    or os.path.exists(os.path.join(path, modBit, "__init__.pyc"))
+                    or os.path.exists(os.path.join(path, modBit, "__init__.pyo"))
+                )
+            ):
+                modBits.reverse()
+                return ".".join(modBits) + "." + fname, newPathReturn
+            # Not found - look a level higher
+        else:
+            newPathReturn = origPath
+
+    return fname, newPathReturn
+
+
+def GetActiveView():
+    """Gets the edit control (eg, EditView) with the focus, or None"""
+    try:
+        childFrame, bIsMaximised = win32ui.GetMainFrame().MDIGetActive()
+        return childFrame.GetActiveView()
+    except win32ui.error:
+        return None
+
+
+def GetActiveEditControl():
+    view = GetActiveView()
+    if view is None:
+        return None
+    if hasattr(view, "SCIAddText"):  # Is it a scintilla control?
+        return view
+    try:
+        return view.GetRichEditCtrl()
+    except AttributeError:
+        pass
+    try:
+        return view.GetEditCtrl()
+    except AttributeError:
+        pass
+
+
+def GetActiveEditorDocument():
+    """Returns the active editor document and view, or (None,None) if no
+    active document or its not an editor document.
+    """
+    view = GetActiveView()
+    if view is None or isinstance(view, TreeView):
+        return (None, None)
+    doc = view.GetDocument()
+    if hasattr(doc, "MarkerAdd"):  # Is it an Editor document?
+        return doc, view
+    return (None, None)
+
+
+def GetActiveFileName(bAutoSave=1):
+    """Gets the file name for the active frame, saving it if necessary.
+
+    Returns None if it cant be found, or raises KeyboardInterrupt.
+    """
+    pathName = None
+    active = GetActiveView()
+    if active is None:
+        return None
+    try:
+        doc = active.GetDocument()
+        pathName = doc.GetPathName()
+
+        if bAutoSave and (
+            len(pathName) > 0
+            or doc.GetTitle()[:8] == "Untitled"
+            or doc.GetTitle()[:6] == "Script"
+        ):  # if not a special purpose window
+            if doc.IsModified():
+                try:
+                    doc.OnSaveDocument(pathName)
+                    pathName = doc.GetPathName()
+
+                    # clear the linecache buffer
+                    linecache.clearcache()
+
+                except win32ui.error:
+                    raise KeyboardInterrupt
+
+    except (win32ui.error, AttributeError):
+        pass
+    if not pathName:
+        return None
+    return pathName
+
+
+lastScript = ""
+lastArgs = ""
+lastDebuggingType = RS_DEBUGGER_NONE
+
+
+def RunScript(defName=None, defArgs=None, bShowDialog=1, debuggingType=None):
+    global lastScript, lastArgs, lastDebuggingType
+    _debugger_stop_frame_ = 1  # Magic variable so the debugger will hide me!
+
+    # Get the debugger - may be None!
+    debugger = GetDebugger()
+
+    if defName is None:
+        try:
+            pathName = GetActiveFileName()
+        except KeyboardInterrupt:
+            return  # User cancelled save.
+    else:
+        pathName = defName
+    if not pathName:
+        pathName = lastScript
+    if defArgs is None:
+        args = ""
+        if pathName == lastScript:
+            args = lastArgs
+    else:
+        args = defArgs
+    if debuggingType is None:
+        debuggingType = lastDebuggingType
+
+    if not pathName or bShowDialog:
+        dlg = DlgRunScript(debugger is not None)
+        dlg["script"] = pathName
+        dlg["args"] = args
+        dlg["debuggingType"] = debuggingType
+        if dlg.DoModal() != win32con.IDOK:
+            return
+        script = dlg["script"]
+        args = dlg["args"]
+        debuggingType = dlg["debuggingType"]
+        if not script:
+            return
+        if debuggingType == RS_DEBUGGER_GO and debugger is not None:
+            # This may surprise users - they select "Run under debugger", but
+            # it appears not to!  Only warn when they pick from the dialog!
+            # First - ensure the debugger is activated to pickup any break-points
+            # set in the editor.
+            try:
+                # Create the debugger, but _dont_ init the debugger GUI.
+                rd = debugger._GetCurrentDebugger()
+            except AttributeError:
+                rd = None
+            if rd is not None and len(rd.breaks) == 0:
+                msg = "There are no active break-points.\r\n\r\nSelecting this debug option without any\r\nbreak-points is unlikely to have the desired effect\r\nas the debugger is unlikely to be invoked..\r\n\r\nWould you like to step-through in the debugger instead?"
+                rc = win32ui.MessageBox(
+                    msg,
+                    win32ui.LoadString(win32ui.IDR_DEBUGGER),
+                    win32con.MB_YESNOCANCEL | win32con.MB_ICONINFORMATION,
+                )
+                if rc == win32con.IDCANCEL:
+                    return
+                if rc == win32con.IDYES:
+                    debuggingType = RS_DEBUGGER_STEP
+
+        lastDebuggingType = debuggingType
+        lastScript = script
+        lastArgs = args
+    else:
+        script = pathName
+
+    # try and open the script.
+    if (
+        len(os.path.splitext(script)[1]) == 0
+    ):  # check if no extension supplied, and give one.
+        script = script + ".py"
+    # If no path specified, try and locate the file
+    path, fnameonly = os.path.split(script)
+    if len(path) == 0:
+        try:
+            os.stat(fnameonly)  # See if it is OK as is...
+            script = fnameonly
+        except os.error:
+            fullScript = LocatePythonFile(script)
+            if fullScript is None:
+                win32ui.MessageBox("The file '%s' can not be located" % script)
+                return
+            script = fullScript
+    else:
+        path = win32ui.FullPath(path)
+        if not IsOnPythonPath(path):
+            sys.path.append(path)
+
+    # py3k fun: If we use text mode to open the file, we get \r\n
+    # translated so Python allows the syntax (good!), but we get back
+    # text already decoded from the default encoding (bad!) and Python
+    # ignores any encoding decls (bad!).  If we use binary mode we get
+    # the raw bytes and Python looks at the encoding (good!) but \r\n
+    # chars stay in place so Python throws a syntax error (bad!).
+    # So: so the binary thing and manually normalize \r\n.
+    try:
+        f = open(script, "rb")
+    except IOError as exc:
+        win32ui.MessageBox(
+            "The file could not be opened - %s (%d)" % (exc.strerror, exc.errno)
+        )
+        return
+
+    # Get the source-code - as above, normalize \r\n
+    code = f.read().replace(byte_crlf, byte_lf).replace(byte_cr, byte_lf) + byte_lf
+
+    # Remember and hack sys.argv for the script.
+    oldArgv = sys.argv
+    sys.argv = ParseArgs(args)
+    sys.argv.insert(0, script)
+    # sys.path[0] is the path of the script
+    oldPath0 = sys.path[0]
+    newPath0 = os.path.split(script)[0]
+    if not oldPath0:  # if sys.path[0] is empty
+        sys.path[0] = newPath0
+        insertedPath0 = 0
+    else:
+        sys.path.insert(0, newPath0)
+        insertedPath0 = 1
+    bWorked = 0
+    win32ui.DoWaitCursor(1)
+    base = os.path.split(script)[1]
+    # Allow windows to repaint before starting.
+    win32ui.PumpWaitingMessages()
+    win32ui.SetStatusText("Running script %s..." % base, 1)
+    exitCode = 0
+    from pywin.framework import interact
+
+    # Check the debugger flags
+    if debugger is None and (debuggingType != RS_DEBUGGER_NONE):
+        win32ui.MessageBox(
+            "No debugger is installed.  Debugging options have been ignored!"
+        )
+        debuggingType = RS_DEBUGGER_NONE
+
+    # Get a code object - ignore the debugger for this, as it is probably a syntax error
+    # at this point
+    try:
+        codeObject = compile(code, script, "exec")
+    except:
+        # Almost certainly a syntax error!
+        _HandlePythonFailure("run script", script)
+        # No code object which to run/debug.
+        return
+    __main__.__file__ = script
+    try:
+        if debuggingType == RS_DEBUGGER_STEP:
+            debugger.run(codeObject, __main__.__dict__, start_stepping=1)
+        elif debuggingType == RS_DEBUGGER_GO:
+            debugger.run(codeObject, __main__.__dict__, start_stepping=0)
+        else:
+            # Post mortem or no debugging
+            exec(codeObject, __main__.__dict__)
+        bWorked = 1
+    except bdb.BdbQuit:
+        # Dont print tracebacks when the debugger quit, but do print a message.
+        print("Debugging session cancelled.")
+        exitCode = 1
+        bWorked = 1
+    except SystemExit as code:
+        exitCode = code
+        bWorked = 1
+    except KeyboardInterrupt:
+        # Consider this successful, as we dont want the debugger.
+        # (but we do want a traceback!)
+        if interact.edit and interact.edit.currentView:
+            interact.edit.currentView.EnsureNoPrompt()
+        traceback.print_exc()
+        if interact.edit and interact.edit.currentView:
+            interact.edit.currentView.AppendToPrompt([])
+        bWorked = 1
+    except:
+        if interact.edit and interact.edit.currentView:
+            interact.edit.currentView.EnsureNoPrompt()
+        traceback.print_exc()
+        if interact.edit and interact.edit.currentView:
+            interact.edit.currentView.AppendToPrompt([])
+        if debuggingType == RS_DEBUGGER_PM:
+            debugger.pm()
+    del __main__.__file__
+    sys.argv = oldArgv
+    if insertedPath0:
+        del sys.path[0]
+    else:
+        sys.path[0] = oldPath0
+    f.close()
+    if bWorked:
+        win32ui.SetStatusText("Script '%s' returned exit code %s" % (script, exitCode))
+    else:
+        win32ui.SetStatusText("Exception raised while running script  %s" % base)
+    try:
+        sys.stdout.flush()
+    except AttributeError:
+        pass
+
+    win32ui.DoWaitCursor(0)
+
+
+def ImportFile():
+    """This code looks for the current window, and determines if it can be imported.  If not,
+    it will prompt for a file name, and allow it to be imported."""
+    try:
+        pathName = GetActiveFileName()
+    except KeyboardInterrupt:
+        pathName = None
+
+    if pathName is not None:
+        if os.path.splitext(pathName)[1].lower() not in (".py", ".pyw", ".pyx"):
+            pathName = None
+
+    if pathName is None:
+        openFlags = win32con.OFN_OVERWRITEPROMPT | win32con.OFN_FILEMUSTEXIST
+        dlg = win32ui.CreateFileDialog(
+            1, None, None, openFlags, "Python Scripts (*.py;*.pyw)|*.py;*.pyw;*.pyx||"
+        )
+        dlg.SetOFNTitle("Import Script")
+        if dlg.DoModal() != win32con.IDOK:
+            return 0
+
+        pathName = dlg.GetPathName()
+
+    # If already imported, dont look for package
+    path, modName = os.path.split(pathName)
+    modName, modExt = os.path.splitext(modName)
+    newPath = None
+    # note that some packages (*cough* email *cough*) use "lazy importers"
+    # meaning sys.modules can change as a side-effect of looking at
+    # module.__file__ - so we must take a copy (ie, items() in py2k,
+    # list(items()) in py3k)
+    for key, mod in list(sys.modules.items()):
+        if getattr(mod, "__file__", None):
+            fname = mod.__file__
+            base, ext = os.path.splitext(fname)
+            if ext.lower() in (".pyo", ".pyc"):
+                ext = ".py"
+            fname = base + ext
+            if win32ui.ComparePath(fname, pathName):
+                modName = key
+                break
+    else:  # for not broken
+        modName, newPath = GetPackageModuleName(pathName)
+        if newPath:
+            sys.path.append(newPath)
+
+    if modName in sys.modules:
+        bNeedReload = 1
+        what = "reload"
+    else:
+        what = "import"
+        bNeedReload = 0
+
+    win32ui.SetStatusText(what.capitalize() + "ing module...", 1)
+    win32ui.DoWaitCursor(1)
+    # 	win32ui.GetMainFrame().BeginWaitCursor()
+
+    try:
+        # always do an import, as it is cheap if it's already loaded.  This ensures
+        # it is in our name space.
+        codeObj = compile("import " + modName, "<auto import>", "exec")
+    except SyntaxError:
+        win32ui.SetStatusText('Invalid filename for import: "' + modName + '"')
+        return
+    try:
+        exec(codeObj, __main__.__dict__)
+        mod = sys.modules.get(modName)
+        if bNeedReload:
+            from importlib import reload
+
+            mod = reload(sys.modules[modName])
+        win32ui.SetStatusText(
+            "Successfully "
+            + what
+            + "ed module '"
+            + modName
+            + "': %s" % getattr(mod, "__file__", "<unkown file>")
+        )
+    except:
+        _HandlePythonFailure(what)
+    win32ui.DoWaitCursor(0)
+
+
+def CheckFile():
+    """This code looks for the current window, and gets Python to check it
+    without actually executing any code (ie, by compiling only)
+    """
+    try:
+        pathName = GetActiveFileName()
+    except KeyboardInterrupt:
+        return
+
+    what = "check"
+    win32ui.SetStatusText(what.capitalize() + "ing module...", 1)
+    win32ui.DoWaitCursor(1)
+    try:
+        f = open(pathName)
+    except IOError as details:
+        print("Cant open file '%s' - %s" % (pathName, details))
+        return
+    try:
+        code = f.read() + "\n"
+    finally:
+        f.close()
+    try:
+        codeObj = compile(code, pathName, "exec")
+        if RunTabNanny(pathName):
+            win32ui.SetStatusText(
+                "Python and the TabNanny successfully checked the file '"
+                + os.path.basename(pathName)
+                + "'"
+            )
+    except SyntaxError:
+        _HandlePythonFailure(what, pathName)
+    except:
+        traceback.print_exc()
+        _HandlePythonFailure(what)
+    win32ui.DoWaitCursor(0)
+
+
+def RunTabNanny(filename):
+    import io as io
+
+    tabnanny = FindTabNanny()
+    if tabnanny is None:
+        win32ui.MessageBox("The TabNanny is not around, so the children can run amok!")
+        return
+
+    # Capture the tab-nanny output
+    newout = io.StringIO()
+    old_out = sys.stderr, sys.stdout
+    sys.stderr = sys.stdout = newout
+    try:
+        tabnanny.check(filename)
+    finally:
+        # Restore output
+        sys.stderr, sys.stdout = old_out
+    data = newout.getvalue()
+    if data:
+        try:
+            lineno = data.split()[1]
+            lineno = int(lineno)
+            _JumpToPosition(filename, lineno)
+            try:  # Try and display whitespace
+                GetActiveEditControl().SCISetViewWS(1)
+            except:
+                pass
+            win32ui.SetStatusText("The TabNanny found trouble at line %d" % lineno)
+        except (IndexError, TypeError, ValueError):
+            print("The tab nanny complained, but I cant see where!")
+            print(data)
+        return 0
+    return 1
+
+
+def _JumpToPosition(fileName, lineno, col=1):
+    JumpToDocument(fileName, lineno, col)
+
+
+def JumpToDocument(fileName, lineno=0, col=1, nChars=0, bScrollToTop=0):
+    # Jump to the position in a file.
+    # If lineno is <= 0, dont move the position - just open/restore.
+    # if nChars > 0, select that many characters.
+    # if bScrollToTop, the specified line will be moved to the top of the window
+    #  (eg, bScrollToTop should be false when jumping to an error line to retain the
+    #  context, but true when jumping to a method defn, where we want the full body.
+    # Return the view which is editing the file, or None on error.
+    doc = win32ui.GetApp().OpenDocumentFile(fileName)
+    if doc is None:
+        return None
+    frame = doc.GetFirstView().GetParentFrame()
+    try:
+        view = frame.GetEditorView()
+        if frame.GetActiveView() != view:
+            frame.SetActiveView(view)
+        frame.AutoRestore()
+    except AttributeError:  # Not an editor frame??
+        view = doc.GetFirstView()
+    if lineno > 0:
+        charNo = view.LineIndex(lineno - 1)
+        start = charNo + col - 1
+        size = view.GetTextLength()
+        try:
+            view.EnsureCharsVisible(charNo)
+        except AttributeError:
+            print("Doesnt appear to be one of our views?")
+        view.SetSel(min(start, size), min(start + nChars, size))
+    if bScrollToTop:
+        curTop = view.GetFirstVisibleLine()
+        nScroll = (lineno - 1) - curTop
+        view.LineScroll(nScroll, 0)
+    view.SetFocus()
+    return view
+
+
+def _HandlePythonFailure(what, syntaxErrorPathName=None):
+    typ, details, tb = sys.exc_info()
+    if isinstance(details, SyntaxError):
+        try:
+            msg, (fileName, line, col, text) = details
+            if (not fileName or fileName == "<string>") and syntaxErrorPathName:
+                fileName = syntaxErrorPathName
+            _JumpToPosition(fileName, line, col)
+        except (TypeError, ValueError):
+            msg = str(details)
+        win32ui.SetStatusText("Failed to " + what + " - syntax error - %s" % msg)
+    else:
+        traceback.print_exc()
+        win32ui.SetStatusText("Failed to " + what + " - " + str(details))
+    tb = None  # Clean up a cycle.
+
+
+# Find the Python TabNanny in either the standard library or the Python Tools/Scripts directory.
+def FindTabNanny():
+    try:
+        return __import__("tabnanny")
+    except ImportError:
+        pass
+    # OK - not in the standard library - go looking.
+    filename = "tabnanny.py"
+    try:
+        path = win32api.RegQueryValue(
+            win32con.HKEY_LOCAL_MACHINE,
+            "SOFTWARE\\Python\\PythonCore\\%s\\InstallPath" % (sys.winver),
+        )
+    except win32api.error:
+        print("WARNING - The Python registry does not have an 'InstallPath' setting")
+        print("          The file '%s' can not be located" % (filename))
+        return None
+    fname = os.path.join(path, "Tools\\Scripts\\%s" % filename)
+    try:
+        os.stat(fname)
+    except os.error:
+        print(
+            "WARNING - The file '%s' can not be located in path '%s'" % (filename, path)
+        )
+        return None
+
+    tabnannyhome, tabnannybase = os.path.split(fname)
+    tabnannybase = os.path.splitext(tabnannybase)[0]
+    # Put tab nanny at the top of the path.
+    sys.path.insert(0, tabnannyhome)
+    try:
+        return __import__(tabnannybase)
+    finally:
+        # remove the tab-nanny from the path
+        del sys.path[0]
+
+
+def LocatePythonFile(fileName, bBrowseIfDir=1):
+    "Given a file name, return a fully qualified file name, or None"
+    # first look for the exact file as specified
+    if not os.path.isfile(fileName):
+        # Go looking!
+        baseName = fileName
+        for path in sys.path:
+            fileName = os.path.abspath(os.path.join(path, baseName))
+            if os.path.isdir(fileName):
+                if bBrowseIfDir:
+                    d = win32ui.CreateFileDialog(
+                        1, "*.py", None, 0, "Python Files (*.py)|*.py|All files|*.*"
+                    )
+                    d.SetOFNInitialDir(fileName)
+                    rc = d.DoModal()
+                    if rc == win32con.IDOK:
+                        fileName = d.GetPathName()
+                        break
+                    else:
+                        return None
+            else:
+                fileName = fileName + ".py"
+                if os.path.isfile(fileName):
+                    break  # Found it!
+
+        else:  # for not broken out of
+            return None
+    return win32ui.FullPath(fileName)
diff --git a/lib/pythonwin/pywin/framework/sgrepmdi.py b/lib/pythonwin/pywin/framework/sgrepmdi.py
new file mode 100644
index 00000000..b7d938bb
--- /dev/null
+++ b/lib/pythonwin/pywin/framework/sgrepmdi.py
@@ -0,0 +1,758 @@
+# SGrepMDI is by Gordon McMillan (gmcm@hypernet.com)
+# It does basically what Find In Files does in MSVC with a couple enhancements.
+# - It saves any directories in the app's ini file (if you want to get rid
+# 	of them you'll have to edit the file)
+# - "Directories" can be directories,
+#  -	semicolon separated lists of "directories",
+#  -	environment variables that evaluate to "directories",
+#  -	registry path names that evaluate to "directories",
+#  -	all of which is recursive, so you can mix them all up.
+# - It is MDI, so you can 'nest' greps and return to earlier ones,
+# 	(ie, have multiple results open at the same time)
+# - Like FIF, double clicking a line opens an editor and takes you to the line.
+# - You can highlight text, right click and start a new grep with the selected
+# 	text as search pattern and same directories etc as before.
+# - You can save grep parameters (so you don't lose your hardearned pattern)
+# 	from File|Save
+# - You can save grep results by right clicking in the result window.
+# Hats off to Mark Hammond for providing an environment where I could cobble
+# something like this together in a couple evenings!
+
+import glob
+import os
+import re
+
+import win32api
+import win32con
+import win32ui
+from pywin.mfc import dialog, docview, window
+
+from . import scriptutils
+
+
+def getsubdirs(d):
+    dlist = []
+    flist = glob.glob(d + "\\*")
+    for f in flist:
+        if os.path.isdir(f):
+            dlist.append(f)
+            dlist = dlist + getsubdirs(f)
+    return dlist
+
+
+class dirpath:
+    def __init__(self, str, recurse=0):
+        dp = str.split(";")
+        dirs = {}
+        for d in dp:
+            if os.path.isdir(d):
+                d = d.lower()
+                if d not in dirs:
+                    dirs[d] = None
+                    if recurse:
+                        subdirs = getsubdirs(d)
+                        for sd in subdirs:
+                            sd = sd.lower()
+                            if sd not in dirs:
+                                dirs[sd] = None
+            elif os.path.isfile(d):
+                pass
+            else:
+                x = None
+                if d in os.environ:
+                    x = dirpath(os.environ[d])
+                elif d[:5] == "HKEY_":
+                    keystr = d.split("\\")
+                    try:
+                        root = eval("win32con." + keystr[0])
+                    except:
+                        win32ui.MessageBox(
+                            "Can't interpret registry key name '%s'" % keystr[0]
+                        )
+                    try:
+                        subkey = "\\".join(keystr[1:])
+                        val = win32api.RegQueryValue(root, subkey)
+                        if val:
+                            x = dirpath(val)
+                        else:
+                            win32ui.MessageBox(
+                                "Registry path '%s' did not return a path entry" % d
+                            )
+                    except:
+                        win32ui.MessageBox(
+                            "Can't interpret registry key value: %s" % keystr[1:]
+                        )
+                else:
+                    win32ui.MessageBox("Directory '%s' not found" % d)
+                if x:
+                    for xd in x:
+                        if xd not in dirs:
+                            dirs[xd] = None
+                            if recurse:
+                                subdirs = getsubdirs(xd)
+                                for sd in subdirs:
+                                    sd = sd.lower()
+                                    if sd not in dirs:
+                                        dirs[sd] = None
+        self.dirs = []
+        for d in list(dirs.keys()):
+            self.dirs.append(d)
+
+    def __getitem__(self, key):
+        return self.dirs[key]
+
+    def __len__(self):
+        return len(self.dirs)
+
+    def __setitem__(self, key, value):
+        self.dirs[key] = value
+
+    def __delitem__(self, key):
+        del self.dirs[key]
+
+    def __getslice__(self, lo, hi):
+        return self.dirs[lo:hi]
+
+    def __setslice__(self, lo, hi, seq):
+        self.dirs[lo:hi] = seq
+
+    def __delslice__(self, lo, hi):
+        del self.dirs[lo:hi]
+
+    def __add__(self, other):
+        if type(other) == type(self) or type(other) == type([]):
+            return self.dirs + other.dirs
+
+    def __radd__(self, other):
+        if type(other) == type(self) or type(other) == type([]):
+            return other.dirs + self.dirs
+
+
+# Group(1) is the filename, group(2) is the lineno.
+# regexGrepResult=regex.compile("^\\([a-zA-Z]:.*\\)(\\([0-9]+\\))")
+
+regexGrep = re.compile(r"^([a-zA-Z]:[^(]*)\(([0-9]+)\)")
+
+# these are the atom numbers defined by Windows for basic dialog controls
+
+BUTTON = 0x80
+EDIT = 0x81
+STATIC = 0x82
+LISTBOX = 0x83
+SCROLLBAR = 0x84
+COMBOBOX = 0x85
+
+
+class GrepTemplate(docview.RichEditDocTemplate):
+    def __init__(self):
+        docview.RichEditDocTemplate.__init__(
+            self, win32ui.IDR_TEXTTYPE, GrepDocument, GrepFrame, GrepView
+        )
+        self.SetDocStrings("\nGrep\nGrep\nGrep params (*.grep)\n.grep\n\n\n")
+        win32ui.GetApp().AddDocTemplate(self)
+        self.docparams = None
+
+    def MatchDocType(self, fileName, fileType):
+        doc = self.FindOpenDocument(fileName)
+        if doc:
+            return doc
+        ext = os.path.splitext(fileName)[1].lower()
+        if ext == ".grep":
+            return win32ui.CDocTemplate_Confidence_yesAttemptNative
+        return win32ui.CDocTemplate_Confidence_noAttempt
+
+    def setParams(self, params):
+        self.docparams = params
+
+    def readParams(self):
+        tmp = self.docparams
+        self.docparams = None
+        return tmp
+
+
+class GrepFrame(window.MDIChildWnd):
+    # The template and doc params will one day be removed.
+    def __init__(self, wnd=None):
+        window.MDIChildWnd.__init__(self, wnd)
+
+
+class GrepDocument(docview.RichEditDoc):
+    def __init__(self, template):
+        docview.RichEditDoc.__init__(self, template)
+        self.dirpattern = ""
+        self.filpattern = ""
+        self.greppattern = ""
+        self.casesensitive = 1
+        self.recurse = 1
+        self.verbose = 0
+
+    def OnOpenDocument(self, fnm):
+        # this bizarre stuff with params is so right clicking in a result window
+        # and starting a new grep can communicate the default parameters to the
+        # new grep.
+        try:
+            params = open(fnm, "r").read()
+        except:
+            params = None
+        self.setInitParams(params)
+        return self.OnNewDocument()
+
+    def OnCloseDocument(self):
+        try:
+            win32ui.GetApp().DeleteIdleHandler(self.SearchFile)
+        except:
+            pass
+        return self._obj_.OnCloseDocument()
+
+    def saveInitParams(self):
+        # Only save the flags, not the text boxes.
+        paramstr = "\t%s\t\t%d\t%d" % (
+            self.filpattern,
+            self.casesensitive,
+            self.recurse,
+        )
+        win32ui.WriteProfileVal("Grep", "Params", paramstr)
+
+    def setInitParams(self, paramstr):
+        if paramstr is None:
+            paramstr = win32ui.GetProfileVal("Grep", "Params", "\t\t\t1\t0\t0")
+        params = paramstr.split("\t")
+        if len(params) < 3:
+            params = params + [""] * (3 - len(params))
+        if len(params) < 6:
+            params = params + [0] * (6 - len(params))
+        self.dirpattern = params[0]
+        self.filpattern = params[1]
+        self.greppattern = params[2]
+        self.casesensitive = int(params[3])
+        self.recurse = int(params[4])
+        self.verbose = int(params[5])
+        # setup some reasonable defaults.
+        if not self.dirpattern:
+            try:
+                editor = win32ui.GetMainFrame().MDIGetActive()[0].GetEditorView()
+                self.dirpattern = os.path.abspath(
+                    os.path.dirname(editor.GetDocument().GetPathName())
+                )
+            except (AttributeError, win32ui.error):
+                self.dirpattern = os.getcwd()
+        if not self.filpattern:
+            self.filpattern = "*.py"
+
+    def OnNewDocument(self):
+        if self.dirpattern == "":
+            self.setInitParams(greptemplate.readParams())
+        d = GrepDialog(
+            self.dirpattern,
+            self.filpattern,
+            self.greppattern,
+            self.casesensitive,
+            self.recurse,
+            self.verbose,
+        )
+        if d.DoModal() == win32con.IDOK:
+            self.dirpattern = d["dirpattern"]
+            self.filpattern = d["filpattern"]
+            self.greppattern = d["greppattern"]
+            self.casesensitive = d["casesensitive"]
+            self.recurse = d["recursive"]
+            self.verbose = d["verbose"]
+            self.doSearch()
+            self.saveInitParams()
+            return 1
+        return 0  # cancelled - return zero to stop frame creation.
+
+    def doSearch(self):
+        self.dp = dirpath(self.dirpattern, self.recurse)
+        self.SetTitle("Grep for %s in %s" % (self.greppattern, self.filpattern))
+        # self.text = []
+        self.GetFirstView().Append("#Search " + self.dirpattern + "\n")
+        if self.verbose:
+            self.GetFirstView().Append("#   =" + repr(self.dp.dirs) + "\n")
+        self.GetFirstView().Append("# Files " + self.filpattern + "\n")
+        self.GetFirstView().Append("#   For " + self.greppattern + "\n")
+        self.fplist = self.filpattern.split(";")
+        if self.casesensitive:
+            self.pat = re.compile(self.greppattern)
+        else:
+            self.pat = re.compile(self.greppattern, re.IGNORECASE)
+        win32ui.SetStatusText("Searching.  Please wait...", 0)
+        self.dpndx = self.fpndx = 0
+        self.fndx = -1
+        if not self.dp:
+            self.GetFirstView().Append(
+                "# ERROR: '%s' does not resolve to any search locations"
+                % self.dirpattern
+            )
+            self.SetModifiedFlag(0)
+        else:
+            self.flist = glob.glob(self.dp[0] + "\\" + self.fplist[0])
+            win32ui.GetApp().AddIdleHandler(self.SearchFile)
+
+    def SearchFile(self, handler, count):
+        self.fndx = self.fndx + 1
+        if self.fndx < len(self.flist):
+            f = self.flist[self.fndx]
+            if self.verbose:
+                self.GetFirstView().Append("# .." + f + "\n")
+            # Directories may match the file type pattern, and files may be removed
+            #  while grep is running
+            if os.path.isfile(f):
+                win32ui.SetStatusText("Searching " + f, 0)
+                lines = open(f, "r").readlines()
+                for i in range(len(lines)):
+                    line = lines[i]
+                    if self.pat.search(line) != None:
+                        self.GetFirstView().Append(f + "(" + repr(i + 1) + ") " + line)
+        else:
+            self.fndx = -1
+            self.fpndx = self.fpndx + 1
+            if self.fpndx < len(self.fplist):
+                self.flist = glob.glob(
+                    self.dp[self.dpndx] + "\\" + self.fplist[self.fpndx]
+                )
+            else:
+                self.fpndx = 0
+                self.dpndx = self.dpndx + 1
+                if self.dpndx < len(self.dp):
+                    self.flist = glob.glob(
+                        self.dp[self.dpndx] + "\\" + self.fplist[self.fpndx]
+                    )
+                else:
+                    win32ui.SetStatusText("Search complete.", 0)
+                    self.SetModifiedFlag(0)  # default to not modified.
+                    try:
+                        win32ui.GetApp().DeleteIdleHandler(self.SearchFile)
+                    except:
+                        pass
+                    return 0
+        return 1
+
+    def GetParams(self):
+        return (
+            self.dirpattern
+            + "\t"
+            + self.filpattern
+            + "\t"
+            + self.greppattern
+            + "\t"
+            + repr(self.casesensitive)
+            + "\t"
+            + repr(self.recurse)
+            + "\t"
+            + repr(self.verbose)
+        )
+
+    def OnSaveDocument(self, filename):
+        # 		print 'OnSaveDocument() filename=',filename
+        savefile = open(filename, "wb")
+        txt = self.GetParams() + "\n"
+        # 		print 'writing',txt
+        savefile.write(txt)
+        savefile.close()
+        self.SetModifiedFlag(0)
+        return 1
+
+
+ID_OPEN_FILE = 0xE400
+ID_GREP = 0xE401
+ID_SAVERESULTS = 0x402
+ID_TRYAGAIN = 0x403
+
+
+class GrepView(docview.RichEditView):
+    def __init__(self, doc):
+        docview.RichEditView.__init__(self, doc)
+        self.SetWordWrap(win32ui.CRichEditView_WrapNone)
+        self.HookHandlers()
+
+    def OnInitialUpdate(self):
+        rc = self._obj_.OnInitialUpdate()
+        format = (-402653169, 0, 200, 0, 0, 0, 49, "Courier New")
+        self.SetDefaultCharFormat(format)
+        return rc
+
+    def HookHandlers(self):
+        self.HookMessage(self.OnRClick, win32con.WM_RBUTTONDOWN)
+        self.HookCommand(self.OnCmdOpenFile, ID_OPEN_FILE)
+        self.HookCommand(self.OnCmdGrep, ID_GREP)
+        self.HookCommand(self.OnCmdSave, ID_SAVERESULTS)
+        self.HookCommand(self.OnTryAgain, ID_TRYAGAIN)
+        self.HookMessage(self.OnLDblClick, win32con.WM_LBUTTONDBLCLK)
+
+    def OnLDblClick(self, params):
+        line = self.GetLine()
+        regexGrepResult = regexGrep.match(line)
+        if regexGrepResult:
+            fname = regexGrepResult.group(1)
+            line = int(regexGrepResult.group(2))
+            scriptutils.JumpToDocument(fname, line)
+            return 0  # dont pass on
+        return 1  # pass it on by default.
+
+    def OnRClick(self, params):
+        menu = win32ui.CreatePopupMenu()
+        flags = win32con.MF_STRING | win32con.MF_ENABLED
+        lineno = self._obj_.LineFromChar(-1)  # selection or current line
+        line = self._obj_.GetLine(lineno)
+        regexGrepResult = regexGrep.match(line)
+        if regexGrepResult:
+            self.fnm = regexGrepResult.group(1)
+            self.lnnum = int(regexGrepResult.group(2))
+            menu.AppendMenu(flags, ID_OPEN_FILE, "&Open " + self.fnm)
+            menu.AppendMenu(win32con.MF_SEPARATOR)
+        menu.AppendMenu(flags, ID_TRYAGAIN, "&Try Again")
+        charstart, charend = self._obj_.GetSel()
+        if charstart != charend:
+            linestart = self._obj_.LineIndex(lineno)
+            self.sel = line[charstart - linestart : charend - linestart]
+            menu.AppendMenu(flags, ID_GREP, "&Grep for " + self.sel)
+            menu.AppendMenu(win32con.MF_SEPARATOR)
+        menu.AppendMenu(flags, win32ui.ID_EDIT_CUT, "Cu&t")
+        menu.AppendMenu(flags, win32ui.ID_EDIT_COPY, "&Copy")
+        menu.AppendMenu(flags, win32ui.ID_EDIT_PASTE, "&Paste")
+        menu.AppendMenu(flags, win32con.MF_SEPARATOR)
+        menu.AppendMenu(flags, win32ui.ID_EDIT_SELECT_ALL, "&Select all")
+        menu.AppendMenu(flags, win32con.MF_SEPARATOR)
+        menu.AppendMenu(flags, ID_SAVERESULTS, "Sa&ve results")
+        menu.TrackPopupMenu(params[5])
+        return 0
+
+    def OnCmdOpenFile(self, cmd, code):
+        doc = win32ui.GetApp().OpenDocumentFile(self.fnm)
+        if doc:
+            vw = doc.GetFirstView()
+            # hope you have an editor that implements GotoLine()!
+            try:
+                vw.GotoLine(int(self.lnnum))
+            except:
+                pass
+        return 0
+
+    def OnCmdGrep(self, cmd, code):
+        if code != 0:
+            return 1
+        curparamsstr = self.GetDocument().GetParams()
+        params = curparamsstr.split("\t")
+        params[2] = self.sel
+        greptemplate.setParams("\t".join(params))
+        greptemplate.OpenDocumentFile()
+        return 0
+
+    def OnTryAgain(self, cmd, code):
+        if code != 0:
+            return 1
+        greptemplate.setParams(self.GetDocument().GetParams())
+        greptemplate.OpenDocumentFile()
+        return 0
+
+    def OnCmdSave(self, cmd, code):
+        if code != 0:
+            return 1
+        flags = win32con.OFN_OVERWRITEPROMPT
+        dlg = win32ui.CreateFileDialog(
+            0, None, None, flags, "Text Files (*.txt)|*.txt||", self
+        )
+        dlg.SetOFNTitle("Save Results As")
+        if dlg.DoModal() == win32con.IDOK:
+            pn = dlg.GetPathName()
+            self._obj_.SaveTextFile(pn)
+        return 0
+
+    def Append(self, strng):
+        numlines = self.GetLineCount()
+        endpos = self.LineIndex(numlines - 1) + len(self.GetLine(numlines - 1))
+        self.SetSel(endpos, endpos)
+        self.ReplaceSel(strng)
+
+
+class GrepDialog(dialog.Dialog):
+    def __init__(self, dp, fp, gp, cs, r, v):
+        style = (
+            win32con.DS_MODALFRAME
+            | win32con.WS_POPUP
+            | win32con.WS_VISIBLE
+            | win32con.WS_CAPTION
+            | win32con.WS_SYSMENU
+            | win32con.DS_SETFONT
+        )
+        CS = win32con.WS_CHILD | win32con.WS_VISIBLE
+        tmp = [
+            ["Grep", (0, 0, 210, 90), style, None, (8, "MS Sans Serif")],
+        ]
+        tmp.append([STATIC, "Grep For:", -1, (7, 7, 50, 9), CS])
+        tmp.append(
+            [
+                EDIT,
+                gp,
+                101,
+                (52, 7, 144, 11),
+                CS | win32con.WS_TABSTOP | win32con.ES_AUTOHSCROLL | win32con.WS_BORDER,
+            ]
+        )
+        tmp.append([STATIC, "Directories:", -1, (7, 20, 50, 9), CS])
+        tmp.append(
+            [
+                EDIT,
+                dp,
+                102,
+                (52, 20, 128, 11),
+                CS | win32con.WS_TABSTOP | win32con.ES_AUTOHSCROLL | win32con.WS_BORDER,
+            ]
+        )
+        tmp.append(
+            [
+                BUTTON,
+                "...",
+                110,
+                (182, 20, 16, 11),
+                CS | win32con.BS_PUSHBUTTON | win32con.WS_TABSTOP,
+            ]
+        )
+        tmp.append([STATIC, "File types:", -1, (7, 33, 50, 9), CS])
+        tmp.append(
+            [
+                EDIT,
+                fp,
+                103,
+                (52, 33, 128, 11),
+                CS | win32con.WS_TABSTOP | win32con.ES_AUTOHSCROLL | win32con.WS_BORDER,
+            ]
+        )
+        tmp.append(
+            [
+                BUTTON,
+                "...",
+                111,
+                (182, 33, 16, 11),
+                CS | win32con.BS_PUSHBUTTON | win32con.WS_TABSTOP,
+            ]
+        )
+        tmp.append(
+            [
+                BUTTON,
+                "Case sensitive",
+                104,
+                (7, 45, 72, 9),
+                CS
+                | win32con.BS_AUTOCHECKBOX
+                | win32con.BS_LEFTTEXT
+                | win32con.WS_TABSTOP,
+            ]
+        )
+        tmp.append(
+            [
+                BUTTON,
+                "Subdirectories",
+                105,
+                (7, 56, 72, 9),
+                CS
+                | win32con.BS_AUTOCHECKBOX
+                | win32con.BS_LEFTTEXT
+                | win32con.WS_TABSTOP,
+            ]
+        )
+        tmp.append(
+            [
+                BUTTON,
+                "Verbose",
+                106,
+                (7, 67, 72, 9),
+                CS
+                | win32con.BS_AUTOCHECKBOX
+                | win32con.BS_LEFTTEXT
+                | win32con.WS_TABSTOP,
+            ]
+        )
+        tmp.append(
+            [
+                BUTTON,
+                "OK",
+                win32con.IDOK,
+                (166, 53, 32, 12),
+                CS | win32con.BS_DEFPUSHBUTTON | win32con.WS_TABSTOP,
+            ]
+        )
+        tmp.append(
+            [
+                BUTTON,
+                "Cancel",
+                win32con.IDCANCEL,
+                (166, 67, 32, 12),
+                CS | win32con.BS_PUSHBUTTON | win32con.WS_TABSTOP,
+            ]
+        )
+        dialog.Dialog.__init__(self, tmp)
+        self.AddDDX(101, "greppattern")
+        self.AddDDX(102, "dirpattern")
+        self.AddDDX(103, "filpattern")
+        self.AddDDX(104, "casesensitive")
+        self.AddDDX(105, "recursive")
+        self.AddDDX(106, "verbose")
+        self._obj_.data["greppattern"] = gp
+        self._obj_.data["dirpattern"] = dp
+        self._obj_.data["filpattern"] = fp
+        self._obj_.data["casesensitive"] = cs
+        self._obj_.data["recursive"] = r
+        self._obj_.data["verbose"] = v
+        self.HookCommand(self.OnMoreDirectories, 110)
+        self.HookCommand(self.OnMoreFiles, 111)
+
+    def OnMoreDirectories(self, cmd, code):
+        if code != 0:
+            return 1
+        self.getMore("Grep\\Directories", "dirpattern")
+
+    def OnMoreFiles(self, cmd, code):
+        if code != 0:
+            return 1
+        self.getMore("Grep\\File Types", "filpattern")
+
+    def getMore(self, section, key):
+        self.UpdateData(1)
+        # get the items out of the ini file
+        ini = win32ui.GetProfileFileName()
+        secitems = win32api.GetProfileSection(section, ini)
+        items = []
+        for secitem in secitems:
+            items.append(secitem.split("=")[1])
+        dlg = GrepParamsDialog(items)
+        if dlg.DoModal() == win32con.IDOK:
+            itemstr = ";".join(dlg.getItems())
+            self._obj_.data[key] = itemstr
+            # update the ini file with dlg.getNew()
+            i = 0
+            newitems = dlg.getNew()
+            if newitems:
+                items = items + newitems
+                for item in items:
+                    win32api.WriteProfileVal(section, repr(i), item, ini)
+                    i = i + 1
+            self.UpdateData(0)
+
+    def OnOK(self):
+        self.UpdateData(1)
+        for id, name in (
+            (101, "greppattern"),
+            (102, "dirpattern"),
+            (103, "filpattern"),
+        ):
+            if not self[name]:
+                self.GetDlgItem(id).SetFocus()
+                win32api.MessageBeep()
+                win32ui.SetStatusText("Please enter a value")
+                return
+        self._obj_.OnOK()
+
+
+class GrepParamsDialog(dialog.Dialog):
+    def __init__(self, items):
+        self.items = items
+        self.newitems = []
+        style = (
+            win32con.DS_MODALFRAME
+            | win32con.WS_POPUP
+            | win32con.WS_VISIBLE
+            | win32con.WS_CAPTION
+            | win32con.WS_SYSMENU
+            | win32con.DS_SETFONT
+        )
+        CS = win32con.WS_CHILD | win32con.WS_VISIBLE
+        tmp = [
+            ["Grep Parameters", (0, 0, 205, 100), style, None, (8, "MS Sans Serif")],
+        ]
+        tmp.append(
+            [
+                LISTBOX,
+                "",
+                107,
+                (7, 7, 150, 72),
+                CS
+                | win32con.LBS_MULTIPLESEL
+                | win32con.LBS_STANDARD
+                | win32con.LBS_HASSTRINGS
+                | win32con.WS_TABSTOP
+                | win32con.LBS_NOTIFY,
+            ]
+        )
+        tmp.append(
+            [
+                BUTTON,
+                "OK",
+                win32con.IDOK,
+                (167, 7, 32, 12),
+                CS | win32con.BS_DEFPUSHBUTTON | win32con.WS_TABSTOP,
+            ]
+        )
+        tmp.append(
+            [
+                BUTTON,
+                "Cancel",
+                win32con.IDCANCEL,
+                (167, 23, 32, 12),
+                CS | win32con.BS_PUSHBUTTON | win32con.WS_TABSTOP,
+            ]
+        )
+        tmp.append([STATIC, "New:", -1, (2, 83, 15, 12), CS])
+        tmp.append(
+            [
+                EDIT,
+                "",
+                108,
+                (18, 83, 139, 12),
+                CS | win32con.WS_TABSTOP | win32con.ES_AUTOHSCROLL | win32con.WS_BORDER,
+            ]
+        )
+        tmp.append(
+            [
+                BUTTON,
+                "Add",
+                109,
+                (167, 83, 32, 12),
+                CS | win32con.BS_PUSHBUTTON | win32con.WS_TABSTOP,
+            ]
+        )
+        dialog.Dialog.__init__(self, tmp)
+        self.HookCommand(self.OnAddItem, 109)
+        self.HookCommand(self.OnListDoubleClick, 107)
+
+    def OnInitDialog(self):
+        lb = self.GetDlgItem(107)
+        for item in self.items:
+            lb.AddString(item)
+        return self._obj_.OnInitDialog()
+
+    def OnAddItem(self, cmd, code):
+        if code != 0:
+            return 1
+        eb = self.GetDlgItem(108)
+        item = eb.GetLine(0)
+        self.newitems.append(item)
+        lb = self.GetDlgItem(107)
+        i = lb.AddString(item)
+        lb.SetSel(i, 1)
+        return 1
+
+    def OnListDoubleClick(self, cmd, code):
+        if code == win32con.LBN_DBLCLK:
+            self.OnOK()
+            return 1
+
+    def OnOK(self):
+        lb = self.GetDlgItem(107)
+        self.selections = lb.GetSelTextItems()
+        self._obj_.OnOK()
+
+    def getItems(self):
+        return self.selections
+
+    def getNew(self):
+        return self.newitems
+
+
+try:
+    win32ui.GetApp().RemoveDocTemplate(greptemplate)
+except NameError:
+    pass
+
+greptemplate = GrepTemplate()
diff --git a/lib/pythonwin/pywin/framework/startup.py b/lib/pythonwin/pywin/framework/startup.py
new file mode 100644
index 00000000..4a732322
--- /dev/null
+++ b/lib/pythonwin/pywin/framework/startup.py
@@ -0,0 +1,80 @@
+# startup.py
+#
+"The main application startup code for PythonWin."
+
+#
+# This does the basic command line handling.
+
+# Keep this as short as possible, cos error output is only redirected if
+# this runs OK.  Errors in imported modules are much better - the messages go somewhere (not any more :-)
+
+import os
+import sys
+
+import win32api
+import win32ui
+
+if not sys.argv:
+    # Initialize sys.argv from commandline. When sys.argv is empty list (
+    # different from [''] meaning "no cmd line arguments" ), then C
+    # bootstrapping or another method of invocation failed to initialize
+    # sys.argv and it will be done here. ( This was a workaround for a bug in
+    # win32ui but is retained for other situations. )
+    argv = win32api.CommandLineToArgv(win32api.GetCommandLine())
+    sys.argv = argv[1:]
+    if os.getcwd() not in sys.path and "." not in sys.path:
+        sys.path.insert(0, os.getcwd())
+
+# You may wish to redirect error output somewhere useful if you have startup errors.
+# eg, 'import win32traceutil' will do this for you.
+# import win32traceutil # Just uncomment this line to see error output!
+
+# An old class I used to use - generally only useful if Pythonwin is running under MSVC
+# class DebugOutput:
+# 	softspace=1
+# 	def write(self,message):
+# 		win32ui.OutputDebug(message)
+# sys.stderr=sys.stdout=DebugOutput()
+
+# To fix a problem with Pythonwin when started from the Pythonwin directory,
+# we update the pywin path to ensure it is absolute.
+# If it is indeed relative, it will be relative to our current directory.
+# If its already absolute, then this will have no affect.
+import pywin
+import pywin.framework
+
+pywin.__path__[0] = win32ui.FullPath(pywin.__path__[0])
+pywin.framework.__path__[0] = win32ui.FullPath(pywin.framework.__path__[0])
+
+# make a few wierd sys values.  This is so later we can clobber sys.argv to trick
+# scripts when running under a GUI environment.
+
+moduleName = "pywin.framework.intpyapp"
+sys.appargvoffset = 0
+sys.appargv = sys.argv[:]
+# Must check for /app param here.
+if len(sys.argv) >= 2 and sys.argv[0].lower() in ("/app", "-app"):
+    from . import cmdline
+
+    moduleName = cmdline.FixArgFileName(sys.argv[1])
+    sys.appargvoffset = 2
+    newargv = sys.argv[sys.appargvoffset :]
+    # 	newargv.insert(0, sys.argv[0])
+    sys.argv = newargv
+
+# Import the application module.
+__import__(moduleName)
+
+try:
+    win32ui.GetApp()._obj_
+    # This worked - an app already exists - do nothing more
+except (AttributeError, win32ui.error):
+    # This means either no app object exists at all, or the one
+    # that does exist does not have a Python class (ie, was created
+    # by the host .EXE).  In this case, we do the "old style" init...
+    from . import app
+
+    if app.AppBuilder is None:
+        raise TypeError("No application object has been registered")
+
+    app.App = app.AppBuilder()
diff --git a/lib/pythonwin/pywin/framework/stdin.py b/lib/pythonwin/pywin/framework/stdin.py
new file mode 100644
index 00000000..2f3adcb6
--- /dev/null
+++ b/lib/pythonwin/pywin/framework/stdin.py
@@ -0,0 +1,176 @@
+# Copyright (c) 2000 David Abrahams. Permission to copy, use, modify, sell
+# and distribute this software is granted provided this copyright
+# notice appears in all copies. This software is provided "as is" without
+# express or implied warranty, and with no claim as to its suitability for
+# any purpose.
+"""Provides a class Stdin which can be used to emulate the regular old
+sys.stdin for the PythonWin interactive window. Right now it just pops
+up a raw_input() dialog. With luck, someone will integrate it into the
+actual PythonWin interactive window someday.
+
+WARNING: Importing this file automatically replaces sys.stdin with an
+instance of Stdin (below). This is useful because you can just open
+Stdin.py in PythonWin and hit the import button to get it set up right
+if you don't feel like changing PythonWin's source. To put things back
+the way they were, simply use this magic incantation:
+    import sys
+    sys.stdin = sys.stdin.real_file
+"""
+import sys
+
+try:
+    get_input_line = raw_input  # py2x
+except NameError:
+    get_input_line = input  # py3k
+
+
+class Stdin:
+    def __init__(self):
+        self.real_file = sys.stdin  # NOTE: Likely to be None in py3k
+        self.buffer = ""
+        self.closed = False
+
+    def __getattr__(self, name):
+        """Forward most functions to the real sys.stdin for absolute realism."""
+        if self.real_file is None:
+            raise AttributeError(name)
+        return getattr(self.real_file, name)
+
+    def isatty(self):
+        """Return 1 if the file is connected to a tty(-like) device, else 0."""
+        return 1
+
+    def read(self, size=-1):
+        """Read at most size bytes from the file (less if the read
+        hits EOF or no more data is immediately available on a pipe,
+        tty or similar device). If the size argument is negative or
+        omitted, read all data until EOF is reached. The bytes are
+        returned as a string object. An empty string is returned when
+        EOF is encountered immediately. (For certain files, like ttys,
+        it makes sense to continue reading after an EOF is hit.)"""
+        result_size = self.__get_lines(size)
+        return self.__extract_from_buffer(result_size)
+
+    def readline(self, size=-1):
+        """Read one entire line from the file. A trailing newline
+        character is kept in the string2.6 (but may be absent when a file ends
+        with an incomplete line). If the size argument is present and
+        non-negative, it is a maximum byte count (including the trailing
+        newline) and an incomplete line may be returned. An empty string is
+        returned when EOF is hit immediately. Note: unlike stdio's fgets(),
+        the returned string contains null characters ('\0') if they occurred
+        in the input.
+        """
+        maximum_result_size = self.__get_lines(size, lambda buffer: "\n" in buffer)
+
+        if "\n" in self.buffer[:maximum_result_size]:
+            result_size = self.buffer.find("\n", 0, maximum_result_size) + 1
+            assert result_size > 0
+        else:
+            result_size = maximum_result_size
+
+        return self.__extract_from_buffer(result_size)
+
+    def __extract_from_buffer(self, character_count):
+        """Remove the first character_count characters from the internal buffer and
+        return them.
+        """
+        result = self.buffer[:character_count]
+        self.buffer = self.buffer[character_count:]
+        return result
+
+    def __get_lines(self, desired_size, done_reading=lambda buffer: False):
+        """Keep adding lines to our internal buffer until done_reading(self.buffer)
+        is true or EOF has been reached or we have desired_size bytes in the buffer.
+        If desired_size < 0, we are never satisfied until we reach EOF. If done_reading
+        is not supplied, it is not consulted.
+
+        If desired_size < 0, returns the length of the internal buffer. Otherwise,
+        returns desired_size.
+        """
+        while not done_reading(self.buffer) and (
+            desired_size < 0 or len(self.buffer) < desired_size
+        ):
+            try:
+                self.__get_line()
+            except (
+                EOFError,
+                KeyboardInterrupt,
+            ):  # deal with cancellation of get_input_line dialog
+                desired_size = len(self.buffer)  # Be satisfied!
+
+        if desired_size < 0:
+            return len(self.buffer)
+        else:
+            return desired_size
+
+    def __get_line(self):
+        """Grab one line from get_input_line() and append it to the buffer."""
+        line = get_input_line()
+        print(">>>", line)  # echo input to console
+        self.buffer = self.buffer + line + "\n"
+
+    def readlines(self, *sizehint):
+        """Read until EOF using readline() and return a list containing the lines
+        thus read. If the optional sizehint argument is present, instead of
+        reading up to EOF, whole lines totalling approximately sizehint bytes
+        (possibly after rounding up to an internal buffer size) are read.
+        """
+        result = []
+        total_read = 0
+        while sizehint == () or total_read < sizehint[0]:
+            line = self.readline()
+            if line == "":
+                break
+            total_read = total_read + len(line)
+            result.append(line)
+        return result
+
+
+if __name__ == "__main__":
+    test_input = r"""this is some test
+input that I am hoping
+~
+will be very instructive
+and when I am done
+I will have tested everything.
+Twelve and twenty blackbirds
+baked in a pie. Patty cake
+patty cake so am I.
+~
+Thirty-five niggling idiots!
+Sell you soul to the devil, baby
+"""
+
+    def fake_raw_input(prompt=None):
+        """Replacement for raw_input() which pulls lines out of global test_input.
+        For testing only!
+        """
+        global test_input
+        if "\n" not in test_input:
+            end_of_line_pos = len(test_input)
+        else:
+            end_of_line_pos = test_input.find("\n")
+        result = test_input[:end_of_line_pos]
+        test_input = test_input[end_of_line_pos + 1 :]
+        if len(result) == 0 or result[0] == "~":
+            raise EOFError()
+        return result
+
+    get_input_line = fake_raw_input
+
+    # Some completely inadequate tests, just to make sure the code's not totally broken
+    try:
+        x = Stdin()
+        print(x.read())
+        print(x.readline())
+        print(x.read(12))
+        print(x.readline(47))
+        print(x.readline(3))
+        print(x.readlines())
+    finally:
+        get_input_line = raw_input
+else:
+    import sys
+
+    sys.stdin = Stdin()
diff --git a/lib/pythonwin/pywin/framework/toolmenu.py b/lib/pythonwin/pywin/framework/toolmenu.py
new file mode 100644
index 00000000..3f739e09
--- /dev/null
+++ b/lib/pythonwin/pywin/framework/toolmenu.py
@@ -0,0 +1,284 @@
+# toolmenu.py
+
+import sys
+
+import win32api
+import win32con
+import win32ui
+
+from . import app
+
+tools = {}
+idPos = 100
+
+# The default items should no tools menu exist in the INI file.
+defaultToolMenuItems = [
+    ("Browser", "win32ui.GetApp().OnViewBrowse(0,0)"),
+    (
+        "Browse PythonPath",
+        "from pywin.tools import browseProjects;browseProjects.Browse()",
+    ),
+    ("Edit Python Path", "from pywin.tools import regedit;regedit.EditRegistry()"),
+    ("COM Makepy utility", "from win32com.client import makepy;makepy.main()"),
+    (
+        "COM Browser",
+        "from win32com.client import combrowse;combrowse.main(modal=False)",
+    ),
+    (
+        "Trace Collector Debugging tool",
+        "from pywin.tools import TraceCollector;TraceCollector.MakeOutputWindow()",
+    ),
+]
+
+
+def LoadToolMenuItems():
+    # Load from the registry.
+    items = []
+    lookNo = 1
+    while 1:
+        menu = win32ui.GetProfileVal("Tools Menu\\%s" % lookNo, "", "")
+        if menu == "":
+            break
+        cmd = win32ui.GetProfileVal("Tools Menu\\%s" % lookNo, "Command", "")
+        items.append((menu, cmd))
+        lookNo = lookNo + 1
+
+    if len(items) == 0:
+        items = defaultToolMenuItems
+    return items
+
+
+def WriteToolMenuItems(items):
+    # Items is a list of (menu, command)
+    # Delete the entire registry tree.
+    try:
+        mainKey = win32ui.GetAppRegistryKey()
+        toolKey = win32api.RegOpenKey(mainKey, "Tools Menu")
+    except win32ui.error:
+        toolKey = None
+    if toolKey is not None:
+        while 1:
+            try:
+                subkey = win32api.RegEnumKey(toolKey, 0)
+            except win32api.error:
+                break
+            win32api.RegDeleteKey(toolKey, subkey)
+    # Keys are now removed - write the new ones.
+    # But first check if we have the defaults - and if so, dont write anything!
+    if items == defaultToolMenuItems:
+        return
+    itemNo = 1
+    for menu, cmd in items:
+        win32ui.WriteProfileVal("Tools Menu\\%s" % itemNo, "", menu)
+        win32ui.WriteProfileVal("Tools Menu\\%s" % itemNo, "Command", cmd)
+        itemNo = itemNo + 1
+
+
+def SetToolsMenu(menu, menuPos=None):
+    global tools
+    global idPos
+
+    # todo - check the menu does not already exist.
+    # Create the new menu
+    toolsMenu = win32ui.CreatePopupMenu()
+
+    # Load from the ini file.
+    items = LoadToolMenuItems()
+    for menuString, cmd in items:
+        tools[idPos] = (menuString, cmd, menuString)
+        toolsMenu.AppendMenu(
+            win32con.MF_ENABLED | win32con.MF_STRING, idPos, menuString
+        )
+        win32ui.GetMainFrame().HookCommand(HandleToolCommand, idPos)
+        idPos = idPos + 1
+
+    # Find the correct spot to insert the new tools menu.
+    if menuPos is None:
+        menuPos = menu.GetMenuItemCount() - 2
+        if menuPos < 0:
+            menuPos = 0
+
+    menu.InsertMenu(
+        menuPos,
+        win32con.MF_BYPOSITION
+        | win32con.MF_ENABLED
+        | win32con.MF_STRING
+        | win32con.MF_POPUP,
+        toolsMenu.GetHandle(),
+        "&Tools",
+    )
+
+
+def HandleToolCommand(cmd, code):
+    import re
+    import traceback
+
+    global tools
+    (menuString, pyCmd, desc) = tools[cmd]
+    win32ui.SetStatusText("Executing tool %s" % desc, 1)
+    pyCmd = re.sub("\\\\n", "\n", pyCmd)
+    win32ui.DoWaitCursor(1)
+    oldFlag = None
+    try:
+        oldFlag = sys.stdout.template.writeQueueing
+        sys.stdout.template.writeQueueing = 0
+    except (NameError, AttributeError):
+        pass
+
+    try:
+        exec("%s\n" % pyCmd)
+        worked = 1
+    except SystemExit:
+        # The program raised a SystemExit - ignore it.
+        worked = 1
+    except:
+        print("Failed to execute command:\n%s" % pyCmd)
+        traceback.print_exc()
+        worked = 0
+    if oldFlag is not None:
+        sys.stdout.template.writeQueueing = oldFlag
+    win32ui.DoWaitCursor(0)
+    if worked:
+        text = "Completed successfully."
+    else:
+        text = "Error executing %s." % desc
+    win32ui.SetStatusText(text, 1)
+
+
+# The property page for maintaing the items on the Tools menu.
+import commctrl
+from pywin.mfc import dialog
+
+if win32ui.UNICODE:
+    LVN_ENDLABELEDIT = commctrl.LVN_ENDLABELEDITW
+else:
+    LVN_ENDLABELEDIT = commctrl.LVN_ENDLABELEDITA
+
+
+class ToolMenuPropPage(dialog.PropertyPage):
+    def __init__(self):
+        self.bImChangingEditControls = 0  # Am I programatically changing the controls?
+        dialog.PropertyPage.__init__(self, win32ui.IDD_PP_TOOLMENU)
+
+    def OnInitDialog(self):
+        self.editMenuCommand = self.GetDlgItem(win32ui.IDC_EDIT2)
+        self.butNew = self.GetDlgItem(win32ui.IDC_BUTTON3)
+
+        # Now hook the change notification messages for the edit controls.
+        self.HookCommand(self.OnCommandEditControls, win32ui.IDC_EDIT1)
+        self.HookCommand(self.OnCommandEditControls, win32ui.IDC_EDIT2)
+
+        self.HookNotify(self.OnNotifyListControl, commctrl.LVN_ITEMCHANGED)
+        self.HookNotify(self.OnNotifyListControlEndLabelEdit, commctrl.LVN_ENDLABELEDIT)
+
+        # Hook the button clicks.
+        self.HookCommand(self.OnButtonNew, win32ui.IDC_BUTTON3)  # New Item
+        self.HookCommand(self.OnButtonDelete, win32ui.IDC_BUTTON4)  # Delete item
+        self.HookCommand(self.OnButtonMove, win32ui.IDC_BUTTON1)  # Move up
+        self.HookCommand(self.OnButtonMove, win32ui.IDC_BUTTON2)  # Move down
+
+        # Setup the columns in the list control
+        lc = self.GetDlgItem(win32ui.IDC_LIST1)
+        rect = lc.GetWindowRect()
+        cx = rect[2] - rect[0]
+        colSize = cx / 2 - win32api.GetSystemMetrics(win32con.SM_CXBORDER) - 1
+
+        item = commctrl.LVCFMT_LEFT, colSize, "Menu Text"
+        lc.InsertColumn(0, item)
+
+        item = commctrl.LVCFMT_LEFT, colSize, "Python Command"
+        lc.InsertColumn(1, item)
+
+        # Insert the existing tools menu
+        itemNo = 0
+        for desc, cmd in LoadToolMenuItems():
+            lc.InsertItem(itemNo, desc)
+            lc.SetItemText(itemNo, 1, cmd)
+            itemNo = itemNo + 1
+
+        self.listControl = lc
+        return dialog.PropertyPage.OnInitDialog(self)
+
+    def OnOK(self):
+        # Write the menu back to the registry.
+        items = []
+        itemLook = 0
+        while 1:
+            try:
+                text = self.listControl.GetItemText(itemLook, 0)
+                if not text:
+                    break
+                items.append((text, self.listControl.GetItemText(itemLook, 1)))
+            except win32ui.error:
+                # no more items!
+                break
+            itemLook = itemLook + 1
+        WriteToolMenuItems(items)
+        return self._obj_.OnOK()
+
+    def OnCommandEditControls(self, id, cmd):
+        # 		print "OnEditControls", id, cmd
+        if cmd == win32con.EN_CHANGE and not self.bImChangingEditControls:
+            itemNo = self.listControl.GetNextItem(-1, commctrl.LVNI_SELECTED)
+            newText = self.editMenuCommand.GetWindowText()
+            self.listControl.SetItemText(itemNo, 1, newText)
+
+        return 0
+
+    def OnNotifyListControlEndLabelEdit(self, id, cmd):
+        newText = self.listControl.GetEditControl().GetWindowText()
+        itemNo = self.listControl.GetNextItem(-1, commctrl.LVNI_SELECTED)
+        self.listControl.SetItemText(itemNo, 0, newText)
+
+    def OnNotifyListControl(self, id, cmd):
+        # 		print id, cmd
+        try:
+            itemNo = self.listControl.GetNextItem(-1, commctrl.LVNI_SELECTED)
+        except win32ui.error:  # No selection!
+            return
+
+        self.bImChangingEditControls = 1
+        try:
+            item = self.listControl.GetItem(itemNo, 1)
+            self.editMenuCommand.SetWindowText(item[4])
+        finally:
+            self.bImChangingEditControls = 0
+
+        return 0  # we have handled this!
+
+    def OnButtonNew(self, id, cmd):
+        if cmd == win32con.BN_CLICKED:
+            newIndex = self.listControl.GetItemCount()
+            self.listControl.InsertItem(newIndex, "Click to edit the text")
+            self.listControl.EnsureVisible(newIndex, 0)
+
+    def OnButtonMove(self, id, cmd):
+        if cmd == win32con.BN_CLICKED:
+            try:
+                itemNo = self.listControl.GetNextItem(-1, commctrl.LVNI_SELECTED)
+            except win32ui.error:
+                return
+            menu = self.listControl.GetItemText(itemNo, 0)
+            cmd = self.listControl.GetItemText(itemNo, 1)
+            if id == win32ui.IDC_BUTTON1:
+                # Move up
+                if itemNo > 0:
+                    self.listControl.DeleteItem(itemNo)
+                    # reinsert it.
+                    self.listControl.InsertItem(itemNo - 1, menu)
+                    self.listControl.SetItemText(itemNo - 1, 1, cmd)
+            else:
+                # Move down.
+                if itemNo < self.listControl.GetItemCount() - 1:
+                    self.listControl.DeleteItem(itemNo)
+                    # reinsert it.
+                    self.listControl.InsertItem(itemNo + 1, menu)
+                    self.listControl.SetItemText(itemNo + 1, 1, cmd)
+
+    def OnButtonDelete(self, id, cmd):
+        if cmd == win32con.BN_CLICKED:
+            try:
+                itemNo = self.listControl.GetNextItem(-1, commctrl.LVNI_SELECTED)
+            except win32ui.error:  # No selection!
+                return
+            self.listControl.DeleteItem(itemNo)
diff --git a/lib/pythonwin/pywin/framework/window.py b/lib/pythonwin/pywin/framework/window.py
new file mode 100644
index 00000000..58fd4d95
--- /dev/null
+++ b/lib/pythonwin/pywin/framework/window.py
@@ -0,0 +1,14 @@
+# Framework Window classes.
+
+# Most Pythonwin windows should use these classes rather than
+# the raw MFC ones if they want Pythonwin specific functionality.
+import pywin.mfc.window
+import win32con
+
+
+class MDIChildWnd(pywin.mfc.window.MDIChildWnd):
+    def AutoRestore(self):
+        "If the window is minimised or maximised, restore it."
+        p = self.GetWindowPlacement()
+        if p[1] == win32con.SW_MINIMIZE or p[1] == win32con.SW_SHOWMINIMIZED:
+            self.SetWindowPlacement(p[0], win32con.SW_RESTORE, p[2], p[3], p[4])
diff --git a/lib/pythonwin/pywin/framework/winout.py b/lib/pythonwin/pywin/framework/winout.py
new file mode 100644
index 00000000..e78e959a
--- /dev/null
+++ b/lib/pythonwin/pywin/framework/winout.py
@@ -0,0 +1,594 @@
+# winout.py
+#
+# generic "output window"
+#
+# This Window will detect itself closing, and recreate next time output is
+# written to it.
+
+# This has the option of writing output at idle time (by hooking the
+# idle message, and queueing output) or writing as each
+# write is executed.
+# Updating the window directly gives a jerky appearance as many writes
+# take place between commands, and the windows scrolls, and updates etc
+# Updating at idle-time may defer all output of a long process, giving the
+# appearence nothing is happening.
+# There is a compromise "line" mode, which will output whenever
+# a complete line is available.
+
+# behaviour depends on self.writeQueueing
+
+# This module is thread safe - output can originate from any thread.  If any thread
+# other than the main thread attempts to print, it is always queued until next idle time
+
+import queue
+import re
+
+import win32api
+import win32con
+import win32ui
+from pywin.framework import app, window
+from pywin.mfc import docview
+
+debug = lambda msg: None
+
+##debug=win32ui.OutputDebugString
+##import win32trace;win32trace.InitWrite() # for debugging - delete me!
+##debug = win32trace.write
+
+
+class flags:
+    # queueing of output.
+    WQ_NONE = 0
+    WQ_LINE = 1
+    WQ_IDLE = 2
+
+
+# WindowOutputDocumentParent=docview.RichEditDoc
+# WindowOutputDocumentParent=docview.Document
+import pywin.scintilla.document
+from pywin import default_scintilla_encoding
+from pywin.scintilla import scintillacon
+
+WindowOutputDocumentParent = pywin.scintilla.document.CScintillaDocument
+
+
+class WindowOutputDocument(WindowOutputDocumentParent):
+    def SaveModified(self):
+        return 1  # say it is OK to destroy my document
+
+    def OnSaveDocument(self, fileName):
+        win32ui.SetStatusText("Saving file...", 1)
+        try:
+            self.SaveFile(fileName)
+        except IOError as details:
+            win32ui.MessageBox("Error - could not save file\r\n\r\n%s" % details)
+            return 0
+        win32ui.SetStatusText("Ready")
+        return 1
+
+
+class WindowOutputFrame(window.MDIChildWnd):
+    def __init__(self, wnd=None):
+        window.MDIChildWnd.__init__(self, wnd)
+        self.HookMessage(self.OnSizeMove, win32con.WM_SIZE)
+        self.HookMessage(self.OnSizeMove, win32con.WM_MOVE)
+
+    def LoadFrame(self, idResource, style, wndParent, context):
+        self.template = context.template
+        return self._obj_.LoadFrame(idResource, style, wndParent, context)
+
+    def PreCreateWindow(self, cc):
+        cc = self._obj_.PreCreateWindow(cc)
+        if (
+            self.template.defSize
+            and self.template.defSize[0] != self.template.defSize[1]
+        ):
+            rect = app.RectToCreateStructRect(self.template.defSize)
+            cc = cc[0], cc[1], cc[2], cc[3], rect, cc[5], cc[6], cc[7], cc[8]
+        return cc
+
+    def OnSizeMove(self, msg):
+        # so recreate maintains position.
+        # Need to map coordinates from the
+        # frame windows first child.
+        mdiClient = self.GetParent()
+        self.template.defSize = mdiClient.ScreenToClient(self.GetWindowRect())
+
+    def OnDestroy(self, message):
+        self.template.OnFrameDestroy(self)
+        return 1
+
+
+class WindowOutputViewImpl:
+    def __init__(self):
+        self.patErrorMessage = re.compile('\W*File "(.*)", line ([0-9]+)')
+        self.template = self.GetDocument().GetDocTemplate()
+
+    def HookHandlers(self):
+        # Hook for the right-click menu.
+        self.HookMessage(self.OnRClick, win32con.WM_RBUTTONDOWN)
+
+    def OnDestroy(self, msg):
+        self.template.OnViewDestroy(self)
+
+    def OnInitialUpdate(self):
+        self.RestoreKillBuffer()
+        self.SetSel(-2)  # end of buffer
+
+    def GetRightMenuItems(self):
+        ret = []
+        flags = win32con.MF_STRING | win32con.MF_ENABLED
+        ret.append((flags, win32ui.ID_EDIT_COPY, "&Copy"))
+        ret.append((flags, win32ui.ID_EDIT_SELECT_ALL, "&Select all"))
+        return ret
+
+    #
+    # Windows command handlers, virtuals, etc.
+    #
+    def OnRClick(self, params):
+        paramsList = self.GetRightMenuItems()
+        menu = win32ui.CreatePopupMenu()
+        for appendParams in paramsList:
+            if type(appendParams) != type(()):
+                appendParams = (appendParams,)
+            menu.AppendMenu(*appendParams)
+        menu.TrackPopupMenu(params[5])  # track at mouse position.
+        return 0
+
+    # as this is often used as an output window, exeptions will often
+    # be printed.  Therefore, we support this functionality at this level.
+    # Returns TRUE if the current line is an error message line, and will
+    # jump to it.  FALSE if no error (and no action taken)
+    def HandleSpecialLine(self):
+        from . import scriptutils
+
+        line = self.GetLine()
+        if line[:11] == "com_error: ":
+            # An OLE Exception - pull apart the exception
+            # and try and locate a help file.
+            try:
+                import win32api
+                import win32con
+
+                det = eval(line[line.find(":") + 1 :].strip())
+                win32ui.SetStatusText("Opening help file on OLE error...")
+                from . import help
+
+                help.OpenHelpFile(det[2][3], win32con.HELP_CONTEXT, det[2][4])
+                return 1
+            except win32api.error as details:
+                win32ui.SetStatusText(
+                    "The help file could not be opened - %s" % details.strerror
+                )
+                return 1
+            except:
+                win32ui.SetStatusText(
+                    "Line is a COM error, but no WinHelp details can be parsed"
+                )
+        # Look for a Python traceback.
+        matchResult = self.patErrorMessage.match(line)
+        if matchResult is None:
+            # No match - try the previous line
+            lineNo = self.LineFromChar()
+            if lineNo > 0:
+                line = self.GetLine(lineNo - 1)
+                matchResult = self.patErrorMessage.match(line)
+        if matchResult is not None:
+            # we have an error line.
+            fileName = matchResult.group(1)
+            if fileName[0] == "<":
+                win32ui.SetStatusText("Can not load this file")
+                return 1  # still was an error message.
+            else:
+                lineNoString = matchResult.group(2)
+                # Attempt to locate the file (in case it is a relative spec)
+                fileNameSpec = fileName
+                fileName = scriptutils.LocatePythonFile(fileName)
+                if fileName is None:
+                    # Dont force update, so it replaces the idle prompt.
+                    win32ui.SetStatusText(
+                        "Cant locate the file '%s'" % (fileNameSpec), 0
+                    )
+                    return 1
+
+                win32ui.SetStatusText(
+                    "Jumping to line " + lineNoString + " of file " + fileName, 1
+                )
+                if not scriptutils.JumpToDocument(fileName, int(lineNoString)):
+                    win32ui.SetStatusText("Could not open %s" % fileName)
+                    return 1  # still was an error message.
+                return 1
+        return 0  # not an error line
+
+    def write(self, msg):
+        return self.template.write(msg)
+
+    def writelines(self, lines):
+        for line in lines:
+            self.write(line)
+
+    def flush(self):
+        self.template.flush()
+
+
+class WindowOutputViewRTF(docview.RichEditView, WindowOutputViewImpl):
+    def __init__(self, doc):
+        docview.RichEditView.__init__(self, doc)
+        WindowOutputViewImpl.__init__(self)
+
+    def OnInitialUpdate(self):
+        WindowOutputViewImpl.OnInitialUpdate(self)
+        return docview.RichEditView.OnInitialUpdate(self)
+
+    def OnDestroy(self, msg):
+        WindowOutputViewImpl.OnDestroy(self, msg)
+        docview.RichEditView.OnDestroy(self, msg)
+
+    def HookHandlers(self):
+        WindowOutputViewImpl.HookHandlers(self)
+        # Hook for finding and locating error messages
+        self.HookMessage(self.OnLDoubleClick, win32con.WM_LBUTTONDBLCLK)
+
+    # 		docview.RichEditView.HookHandlers(self)
+
+    def OnLDoubleClick(self, params):
+        if self.HandleSpecialLine():
+            return 0  # dont pass on
+        return 1  # pass it on by default.
+
+    def RestoreKillBuffer(self):
+        if len(self.template.killBuffer):
+            self.StreamIn(win32con.SF_RTF, self._StreamRTFIn)
+            self.template.killBuffer = []
+
+    def SaveKillBuffer(self):
+        self.StreamOut(win32con.SF_RTFNOOBJS, self._StreamRTFOut)
+
+    def _StreamRTFOut(self, data):
+        self.template.killBuffer.append(data)
+        return 1  # keep em coming!
+
+    def _StreamRTFIn(self, bytes):
+        try:
+            item = self.template.killBuffer[0]
+            self.template.killBuffer.remove(item)
+            if bytes < len(item):
+                print("Warning - output buffer not big enough!")
+            return item
+        except IndexError:
+            return None
+
+    def dowrite(self, str):
+        self.SetSel(-2)
+        self.ReplaceSel(str)
+
+
+import pywin.scintilla.view
+
+
+class WindowOutputViewScintilla(
+    pywin.scintilla.view.CScintillaView, WindowOutputViewImpl
+):
+    def __init__(self, doc):
+        pywin.scintilla.view.CScintillaView.__init__(self, doc)
+        WindowOutputViewImpl.__init__(self)
+
+    def OnInitialUpdate(self):
+        pywin.scintilla.view.CScintillaView.OnInitialUpdate(self)
+        self.SCISetMarginWidth(3)
+        WindowOutputViewImpl.OnInitialUpdate(self)
+
+    def OnDestroy(self, msg):
+        WindowOutputViewImpl.OnDestroy(self, msg)
+        pywin.scintilla.view.CScintillaView.OnDestroy(self, msg)
+
+    def HookHandlers(self):
+        WindowOutputViewImpl.HookHandlers(self)
+        pywin.scintilla.view.CScintillaView.HookHandlers(self)
+        self.GetParent().HookNotify(
+            self.OnScintillaDoubleClick, scintillacon.SCN_DOUBLECLICK
+        )
+
+    ##		self.HookMessage(self.OnLDoubleClick,win32con.WM_LBUTTONDBLCLK)
+
+    def OnScintillaDoubleClick(self, std, extra):
+        self.HandleSpecialLine()
+
+    ##	def OnLDoubleClick(self,params):
+    ##			return 0	# never dont pass on
+
+    def RestoreKillBuffer(self):
+        assert len(self.template.killBuffer) in (0, 1), "Unexpected killbuffer contents"
+        if self.template.killBuffer:
+            self.SCIAddText(self.template.killBuffer[0])
+        self.template.killBuffer = []
+
+    def SaveKillBuffer(self):
+        self.template.killBuffer = [self.GetTextRange(0, -1)]
+
+    def dowrite(self, str):
+        end = self.GetTextLength()
+        atEnd = end == self.GetSel()[0]
+        self.SCIInsertText(str, end)
+        if atEnd:
+            self.SetSel(self.GetTextLength())
+
+    def SetWordWrap(self, bWrapOn=1):
+        if bWrapOn:
+            wrap_mode = scintillacon.SC_WRAP_WORD
+        else:
+            wrap_mode = scintillacon.SC_WRAP_NONE
+        self.SCISetWrapMode(wrap_mode)
+
+    def _MakeColorizer(self):
+        return None  # No colorizer for me!
+
+
+WindowOutputView = WindowOutputViewScintilla
+
+
+# The WindowOutput class is actually an MFC template.  This is a conventient way of
+# making sure that my state can exist beyond the life of the windows themselves.
+# This is primarily to support the functionality of a WindowOutput window automatically
+# being recreated if necessary when written to.
+class WindowOutput(docview.DocTemplate):
+    """Looks like a general Output Window - text can be written by the 'write' method.
+    Will auto-create itself on first write, and also on next write after being closed"""
+
+    softspace = 1
+
+    def __init__(
+        self,
+        title=None,
+        defSize=None,
+        queueing=flags.WQ_LINE,
+        bAutoRestore=1,
+        style=None,
+        makeDoc=None,
+        makeFrame=None,
+        makeView=None,
+    ):
+        """init the output window -
+        Params
+        title=None -- What is the title of the window
+        defSize=None -- What is the default size for the window - if this
+                        is a string, the size will be loaded from the ini file.
+        queueing = flags.WQ_LINE -- When should output be written
+        bAutoRestore=1 -- Should a minimized window be restored.
+        style -- Style for Window, or None for default.
+        makeDoc, makeFrame, makeView -- Classes for frame, view and window respectively.
+        """
+        if makeDoc is None:
+            makeDoc = WindowOutputDocument
+        if makeFrame is None:
+            makeFrame = WindowOutputFrame
+        if makeView is None:
+            makeView = WindowOutputViewScintilla
+        docview.DocTemplate.__init__(
+            self, win32ui.IDR_PYTHONTYPE, makeDoc, makeFrame, makeView
+        )
+        self.SetDocStrings("\nOutput\n\nText Documents (*.txt)\n.txt\n\n\n")
+        win32ui.GetApp().AddDocTemplate(self)
+        self.writeQueueing = queueing
+        self.errorCantRecreate = 0
+        self.killBuffer = []
+        self.style = style
+        self.bAutoRestore = bAutoRestore
+        self.title = title
+        self.bCreating = 0
+        self.interruptCount = 0
+        if type(defSize) == type(""):  # is a string - maintain size pos from ini file.
+            self.iniSizeSection = defSize
+            self.defSize = app.LoadWindowSize(defSize)
+            self.loadedSize = self.defSize
+        else:
+            self.iniSizeSection = None
+            self.defSize = defSize
+        self.currentView = None
+        self.outputQueue = queue.Queue(-1)
+        self.mainThreadId = win32api.GetCurrentThreadId()
+        self.idleHandlerSet = 0
+        self.SetIdleHandler()
+
+    def __del__(self):
+        self.Close()
+
+    def Create(self, title=None, style=None):
+        self.bCreating = 1
+        if title:
+            self.title = title
+        if style:
+            self.style = style
+        doc = self.OpenDocumentFile()
+        if doc is None:
+            return
+        self.currentView = doc.GetFirstView()
+        self.bCreating = 0
+        if self.title:
+            doc.SetTitle(self.title)
+
+    def Close(self):
+        self.RemoveIdleHandler()
+        try:
+            parent = self.currentView.GetParent()
+        except (AttributeError, win32ui.error):  # Already closed
+            return
+        parent.DestroyWindow()
+
+    def SetTitle(self, title):
+        self.title = title
+        if self.currentView:
+            self.currentView.GetDocument().SetTitle(self.title)
+
+    def OnViewDestroy(self, view):
+        self.currentView.SaveKillBuffer()
+        self.currentView = None
+
+    def OnFrameDestroy(self, frame):
+        if self.iniSizeSection:
+            # use GetWindowPlacement(), as it works even when min'd or max'd
+            newSize = frame.GetWindowPlacement()[4]
+            if self.loadedSize != newSize:
+                app.SaveWindowSize(self.iniSizeSection, newSize)
+
+    def SetIdleHandler(self):
+        if not self.idleHandlerSet:
+            debug("Idle handler set\n")
+            win32ui.GetApp().AddIdleHandler(self.QueueIdleHandler)
+            self.idleHandlerSet = 1
+
+    def RemoveIdleHandler(self):
+        if self.idleHandlerSet:
+            debug("Idle handler reset\n")
+            if win32ui.GetApp().DeleteIdleHandler(self.QueueIdleHandler) == 0:
+                debug("Error deleting idle handler\n")
+            self.idleHandlerSet = 0
+
+    def RecreateWindow(self):
+        if self.errorCantRecreate:
+            debug("Error = not trying again")
+            return 0
+        try:
+            # This will fail if app shutting down
+            win32ui.GetMainFrame().GetSafeHwnd()
+            self.Create()
+            return 1
+        except (win32ui.error, AttributeError):
+            self.errorCantRecreate = 1
+            debug("Winout can not recreate the Window!\n")
+            return 0
+
+    # this handles the idle message, and does the printing.
+    def QueueIdleHandler(self, handler, count):
+        try:
+            bEmpty = self.QueueFlush(20)
+            # If the queue is empty, then we are back to idle and restart interrupt logic.
+            if bEmpty:
+                self.interruptCount = 0
+        except KeyboardInterrupt:
+            # First interrupt since idle we just pass on.
+            # later ones we dump the queue and give up.
+            self.interruptCount = self.interruptCount + 1
+            if self.interruptCount > 1:
+                # Drop the queue quickly as the user is already annoyed :-)
+                self.outputQueue = queue.Queue(-1)
+                print("Interrupted.")
+                bEmpty = 1
+            else:
+                raise  # re-raise the error so the users exception filters up.
+        return not bEmpty  # More to do if not empty.
+
+    # Returns true if the Window needs to be recreated.
+    def NeedRecreateWindow(self):
+        try:
+            if self.currentView is not None and self.currentView.IsWindow():
+                return 0
+        except (
+            win32ui.error,
+            AttributeError,
+        ):  # Attribute error if the win32ui object has died.
+            pass
+        return 1
+
+    # Returns true if the Window is OK (either cos it was, or because it was recreated
+    def CheckRecreateWindow(self):
+        if self.bCreating:
+            return 1
+        if not self.NeedRecreateWindow():
+            return 1
+        if self.bAutoRestore:
+            if self.RecreateWindow():
+                return 1
+        return 0
+
+    def QueueFlush(self, max=None):
+        # Returns true if the queue is empty after the flush
+        # 		debug("Queueflush - %d, %d\n" % (max, self.outputQueue.qsize()))
+        if self.bCreating:
+            return 1
+        items = []
+        rc = 0
+        while max is None or max > 0:
+            try:
+                item = self.outputQueue.get_nowait()
+                items.append(item)
+            except queue.Empty:
+                rc = 1
+                break
+            if max is not None:
+                max = max - 1
+        if len(items) != 0:
+            if not self.CheckRecreateWindow():
+                debug(":Recreate failed!\n")
+                return 1  # In trouble - so say we have nothing to do.
+            win32ui.PumpWaitingMessages()  # Pump paint messages
+            self.currentView.dowrite("".join(items))
+        return rc
+
+    def HandleOutput(self, message):
+        # 		debug("QueueOutput on thread %d, flags %d with '%s'...\n" % (win32api.GetCurrentThreadId(), self.writeQueueing, message ))
+        self.outputQueue.put(message)
+        if win32api.GetCurrentThreadId() != self.mainThreadId:
+            pass
+        # 			debug("not my thread - ignoring queue options!\n")
+        elif self.writeQueueing == flags.WQ_LINE:
+            pos = message.rfind("\n")
+            if pos >= 0:
+                # 				debug("Line queueing - forcing flush\n")
+                self.QueueFlush()
+                return
+        elif self.writeQueueing == flags.WQ_NONE:
+            # 			debug("WQ_NONE - flushing!\n")
+            self.QueueFlush()
+            return
+        # Let our idle handler get it - wake it up
+        try:
+            win32ui.GetMainFrame().PostMessage(
+                win32con.WM_USER
+            )  # Kick main thread off.
+        except win32ui.error:
+            # This can happen as the app is shutting down, so we send it to the C++ debugger
+            win32api.OutputDebugString(message)
+
+    # delegate certain fns to my view.
+    def writelines(self, lines):
+        for line in lines:
+            self.write(line)
+
+    def write(self, message):
+        self.HandleOutput(message)
+
+    def flush(self):
+        self.QueueFlush()
+
+    def HandleSpecialLine(self):
+        self.currentView.HandleSpecialLine()
+
+
+def RTFWindowOutput(*args, **kw):
+    kw["makeView"] = WindowOutputViewRTF
+    return WindowOutput(*args, **kw)
+
+
+def thread_test(o):
+    for i in range(5):
+        o.write("Hi from thread %d\n" % (win32api.GetCurrentThreadId()))
+        win32api.Sleep(100)
+
+
+def test():
+    w = WindowOutput(queueing=flags.WQ_IDLE)
+    w.write("First bit of text\n")
+    import _thread
+
+    for i in range(5):
+        w.write("Hello from the main thread\n")
+        _thread.start_new(thread_test, (w,))
+    for i in range(2):
+        w.write("Hello from the main thread\n")
+        win32api.Sleep(50)
+    return w
+
+
+if __name__ == "__main__":
+    test()
diff --git a/lib/pythonwin/pywin/idle/AutoExpand.py b/lib/pythonwin/pywin/idle/AutoExpand.py
new file mode 100644
index 00000000..3b302ee9
--- /dev/null
+++ b/lib/pythonwin/pywin/idle/AutoExpand.py
@@ -0,0 +1,95 @@
+import re
+import string
+
+###$ event <<expand-word>>
+###$ win <Alt-slash>
+###$ unix <Alt-slash>
+
+
+class AutoExpand:
+    keydefs = {
+        "<<expand-word>>": ["<Alt-slash>"],
+    }
+
+    unix_keydefs = {
+        "<<expand-word>>": ["<Meta-slash>"],
+    }
+
+    menudefs = [
+        (
+            "edit",
+            [
+                ("E_xpand word", "<<expand-word>>"),
+            ],
+        ),
+    ]
+
+    wordchars = string.ascii_letters + string.digits + "_"
+
+    def __init__(self, editwin):
+        self.text = editwin.text
+        self.text.wordlist = None  # XXX what is this?
+        self.state = None
+
+    def expand_word_event(self, event):
+        curinsert = self.text.index("insert")
+        curline = self.text.get("insert linestart", "insert lineend")
+        if not self.state:
+            words = self.getwords()
+            index = 0
+        else:
+            words, index, insert, line = self.state
+            if insert != curinsert or line != curline:
+                words = self.getwords()
+                index = 0
+        if not words:
+            self.text.bell()
+            return "break"
+        word = self.getprevword()
+        self.text.delete("insert - %d chars" % len(word), "insert")
+        newword = words[index]
+        index = (index + 1) % len(words)
+        if index == 0:
+            self.text.bell()  # Warn we cycled around
+        self.text.insert("insert", newword)
+        curinsert = self.text.index("insert")
+        curline = self.text.get("insert linestart", "insert lineend")
+        self.state = words, index, curinsert, curline
+        return "break"
+
+    def getwords(self):
+        word = self.getprevword()
+        if not word:
+            return []
+        before = self.text.get("1.0", "insert wordstart")
+        wbefore = re.findall(r"\b" + word + r"\w+\b", before)
+        del before
+        after = self.text.get("insert wordend", "end")
+        wafter = re.findall(r"\b" + word + r"\w+\b", after)
+        del after
+        if not wbefore and not wafter:
+            return []
+        words = []
+        dict = {}
+        # search backwards through words before
+        wbefore.reverse()
+        for w in wbefore:
+            if dict.get(w):
+                continue
+            words.append(w)
+            dict[w] = w
+        # search onwards through words after
+        for w in wafter:
+            if dict.get(w):
+                continue
+            words.append(w)
+            dict[w] = w
+        words.append(word)
+        return words
+
+    def getprevword(self):
+        line = self.text.get("insert linestart", "insert")
+        i = len(line)
+        while i > 0 and line[i - 1] in self.wordchars:
+            i = i - 1
+        return line[i:]
diff --git a/lib/pythonwin/pywin/idle/AutoIndent.py b/lib/pythonwin/pywin/idle/AutoIndent.py
new file mode 100644
index 00000000..c5adc5f8
--- /dev/null
+++ b/lib/pythonwin/pywin/idle/AutoIndent.py
@@ -0,0 +1,547 @@
+import sys
+import tokenize
+
+from pywin import default_scintilla_encoding
+
+from . import PyParse
+
+if sys.version_info < (3,):
+    # in py2k, tokenize() takes a 'token eater' callback, while
+    # generate_tokens is a generator that works with str objects.
+    token_generator = tokenize.generate_tokens
+else:
+    # in py3k tokenize() is the generator working with 'byte' objects, and
+    # token_generator is the 'undocumented b/w compat' function that
+    # theoretically works with str objects - but actually seems to fail)
+    token_generator = tokenize.tokenize
+
+
+class AutoIndent:
+    menudefs = [
+        (
+            "edit",
+            [
+                None,
+                ("_Indent region", "<<indent-region>>"),
+                ("_Dedent region", "<<dedent-region>>"),
+                ("Comment _out region", "<<comment-region>>"),
+                ("U_ncomment region", "<<uncomment-region>>"),
+                ("Tabify region", "<<tabify-region>>"),
+                ("Untabify region", "<<untabify-region>>"),
+                ("Toggle tabs", "<<toggle-tabs>>"),
+                ("New indent width", "<<change-indentwidth>>"),
+            ],
+        ),
+    ]
+
+    keydefs = {
+        "<<smart-backspace>>": ["<Key-BackSpace>"],
+        "<<newline-and-indent>>": ["<Key-Return>", "<KP_Enter>"],
+        "<<smart-indent>>": ["<Key-Tab>"],
+    }
+
+    windows_keydefs = {
+        "<<indent-region>>": ["<Control-bracketright>"],
+        "<<dedent-region>>": ["<Control-bracketleft>"],
+        "<<comment-region>>": ["<Alt-Key-3>"],
+        "<<uncomment-region>>": ["<Alt-Key-4>"],
+        "<<tabify-region>>": ["<Alt-Key-5>"],
+        "<<untabify-region>>": ["<Alt-Key-6>"],
+        "<<toggle-tabs>>": ["<Alt-Key-t>"],
+        "<<change-indentwidth>>": ["<Alt-Key-u>"],
+    }
+
+    unix_keydefs = {
+        "<<indent-region>>": [
+            "<Alt-bracketright>",
+            "<Meta-bracketright>",
+            "<Control-bracketright>",
+        ],
+        "<<dedent-region>>": [
+            "<Alt-bracketleft>",
+            "<Meta-bracketleft>",
+            "<Control-bracketleft>",
+        ],
+        "<<comment-region>>": ["<Alt-Key-3>", "<Meta-Key-3>"],
+        "<<uncomment-region>>": ["<Alt-Key-4>", "<Meta-Key-4>"],
+        "<<tabify-region>>": ["<Alt-Key-5>", "<Meta-Key-5>"],
+        "<<untabify-region>>": ["<Alt-Key-6>", "<Meta-Key-6>"],
+        "<<toggle-tabs>>": ["<Alt-Key-t>"],
+        "<<change-indentwidth>>": ["<Alt-Key-u>"],
+    }
+
+    # usetabs true  -> literal tab characters are used by indent and
+    #                  dedent cmds, possibly mixed with spaces if
+    #                  indentwidth is not a multiple of tabwidth
+    #         false -> tab characters are converted to spaces by indent
+    #                  and dedent cmds, and ditto TAB keystrokes
+    # indentwidth is the number of characters per logical indent level.
+    # tabwidth is the display width of a literal tab character.
+    # CAUTION:  telling Tk to use anything other than its default
+    # tab setting causes it to use an entirely different tabbing algorithm,
+    # treating tab stops as fixed distances from the left margin.
+    # Nobody expects this, so for now tabwidth should never be changed.
+    usetabs = 1
+    indentwidth = 4
+    tabwidth = 8  # for IDLE use, must remain 8 until Tk is fixed
+
+    # If context_use_ps1 is true, parsing searches back for a ps1 line;
+    # else searches for a popular (if, def, ...) Python stmt.
+    context_use_ps1 = 0
+
+    # When searching backwards for a reliable place to begin parsing,
+    # first start num_context_lines[0] lines back, then
+    # num_context_lines[1] lines back if that didn't work, and so on.
+    # The last value should be huge (larger than the # of lines in a
+    # conceivable file).
+    # Making the initial values larger slows things down more often.
+    num_context_lines = 50, 500, 5000000
+
+    def __init__(self, editwin):
+        self.editwin = editwin
+        self.text = editwin.text
+
+    def config(self, **options):
+        for key, value in options.items():
+            if key == "usetabs":
+                self.usetabs = value
+            elif key == "indentwidth":
+                self.indentwidth = value
+            elif key == "tabwidth":
+                self.tabwidth = value
+            elif key == "context_use_ps1":
+                self.context_use_ps1 = value
+            else:
+                raise KeyError("bad option name: %s" % repr(key))
+
+    # If ispythonsource and guess are true, guess a good value for
+    # indentwidth based on file content (if possible), and if
+    # indentwidth != tabwidth set usetabs false.
+    # In any case, adjust the Text widget's view of what a tab
+    # character means.
+
+    def set_indentation_params(self, ispythonsource, guess=1):
+        if guess and ispythonsource:
+            i = self.guess_indent()
+            if 2 <= i <= 8:
+                self.indentwidth = i
+            if self.indentwidth != self.tabwidth:
+                self.usetabs = 0
+
+        self.editwin.set_tabwidth(self.tabwidth)
+
+    def smart_backspace_event(self, event):
+        text = self.text
+        first, last = self.editwin.get_selection_indices()
+        if first and last:
+            text.delete(first, last)
+            text.mark_set("insert", first)
+            return "break"
+        # Delete whitespace left, until hitting a real char or closest
+        # preceding virtual tab stop.
+        chars = text.get("insert linestart", "insert")
+        if chars == "":
+            if text.compare("insert", ">", "1.0"):
+                # easy: delete preceding newline
+                text.delete("insert-1c")
+            else:
+                text.bell()  # at start of buffer
+            return "break"
+        if chars[-1] not in " \t":
+            # easy: delete preceding real char
+            text.delete("insert-1c")
+            return "break"
+        # Ick.  It may require *inserting* spaces if we back up over a
+        # tab character!  This is written to be clear, not fast.
+        have = len(chars.expandtabs(self.tabwidth))
+        assert have > 0
+        want = int((have - 1) / self.indentwidth) * self.indentwidth
+        ncharsdeleted = 0
+        while 1:
+            chars = chars[:-1]
+            ncharsdeleted = ncharsdeleted + 1
+            have = len(chars.expandtabs(self.tabwidth))
+            if have <= want or chars[-1] not in " \t":
+                break
+        text.undo_block_start()
+        text.delete("insert-%dc" % ncharsdeleted, "insert")
+        if have < want:
+            text.insert("insert", " " * (want - have))
+        text.undo_block_stop()
+        return "break"
+
+    def smart_indent_event(self, event):
+        # if intraline selection:
+        #     delete it
+        # elif multiline selection:
+        #     do indent-region & return
+        # indent one level
+        text = self.text
+        first, last = self.editwin.get_selection_indices()
+        text.undo_block_start()
+        try:
+            if first and last:
+                if index2line(first) != index2line(last):
+                    return self.indent_region_event(event)
+                text.delete(first, last)
+                text.mark_set("insert", first)
+            prefix = text.get("insert linestart", "insert")
+            raw, effective = classifyws(prefix, self.tabwidth)
+            if raw == len(prefix):
+                # only whitespace to the left
+                self.reindent_to(effective + self.indentwidth)
+            else:
+                if self.usetabs:
+                    pad = "\t"
+                else:
+                    effective = len(prefix.expandtabs(self.tabwidth))
+                    n = self.indentwidth
+                    pad = " " * (n - effective % n)
+                text.insert("insert", pad)
+            text.see("insert")
+            return "break"
+        finally:
+            text.undo_block_stop()
+
+    def newline_and_indent_event(self, event):
+        text = self.text
+        first, last = self.editwin.get_selection_indices()
+        text.undo_block_start()
+        try:
+            if first and last:
+                text.delete(first, last)
+                text.mark_set("insert", first)
+            line = text.get("insert linestart", "insert")
+            i, n = 0, len(line)
+            while i < n and line[i] in " \t":
+                i = i + 1
+            if i == n:
+                # the cursor is in or at leading indentation; just inject
+                # an empty line at the start and strip space from current line
+                text.delete("insert - %d chars" % i, "insert")
+                text.insert("insert linestart", "\n")
+                return "break"
+            indent = line[:i]
+            # strip whitespace before insert point
+            i = 0
+            while line and line[-1] in " \t":
+                line = line[:-1]
+                i = i + 1
+            if i:
+                text.delete("insert - %d chars" % i, "insert")
+            # strip whitespace after insert point
+            while text.get("insert") in " \t":
+                text.delete("insert")
+            # start new line
+            text.insert("insert", "\n")
+
+            # adjust indentation for continuations and block
+            # open/close first need to find the last stmt
+            lno = index2line(text.index("insert"))
+            y = PyParse.Parser(self.indentwidth, self.tabwidth)
+            for context in self.num_context_lines:
+                startat = max(lno - context, 1)
+                startatindex = repr(startat) + ".0"
+                rawtext = text.get(startatindex, "insert")
+                y.set_str(rawtext)
+                bod = y.find_good_parse_start(
+                    self.context_use_ps1, self._build_char_in_string_func(startatindex)
+                )
+                if bod is not None or startat == 1:
+                    break
+            y.set_lo(bod or 0)
+            c = y.get_continuation_type()
+            if c != PyParse.C_NONE:
+                # The current stmt hasn't ended yet.
+                if c == PyParse.C_STRING:
+                    # inside a string; just mimic the current indent
+                    text.insert("insert", indent)
+                elif c == PyParse.C_BRACKET:
+                    # line up with the first (if any) element of the
+                    # last open bracket structure; else indent one
+                    # level beyond the indent of the line with the
+                    # last open bracket
+                    self.reindent_to(y.compute_bracket_indent())
+                elif c == PyParse.C_BACKSLASH:
+                    # if more than one line in this stmt already, just
+                    # mimic the current indent; else if initial line
+                    # has a start on an assignment stmt, indent to
+                    # beyond leftmost =; else to beyond first chunk of
+                    # non-whitespace on initial line
+                    if y.get_num_lines_in_stmt() > 1:
+                        text.insert("insert", indent)
+                    else:
+                        self.reindent_to(y.compute_backslash_indent())
+                else:
+                    assert 0, "bogus continuation type " + repr(c)
+                return "break"
+
+            # This line starts a brand new stmt; indent relative to
+            # indentation of initial line of closest preceding
+            # interesting stmt.
+            indent = y.get_base_indent_string()
+            text.insert("insert", indent)
+            if y.is_block_opener():
+                self.smart_indent_event(event)
+            elif indent and y.is_block_closer():
+                self.smart_backspace_event(event)
+            return "break"
+        finally:
+            text.see("insert")
+            text.undo_block_stop()
+
+    auto_indent = newline_and_indent_event
+
+    # Our editwin provides a is_char_in_string function that works
+    # with a Tk text index, but PyParse only knows about offsets into
+    # a string. This builds a function for PyParse that accepts an
+    # offset.
+
+    def _build_char_in_string_func(self, startindex):
+        def inner(offset, _startindex=startindex, _icis=self.editwin.is_char_in_string):
+            return _icis(_startindex + "+%dc" % offset)
+
+        return inner
+
+    def indent_region_event(self, event):
+        head, tail, chars, lines = self.get_region()
+        for pos in range(len(lines)):
+            line = lines[pos]
+            if line:
+                raw, effective = classifyws(line, self.tabwidth)
+                effective = effective + self.indentwidth
+                lines[pos] = self._make_blanks(effective) + line[raw:]
+        self.set_region(head, tail, chars, lines)
+        return "break"
+
+    def dedent_region_event(self, event):
+        head, tail, chars, lines = self.get_region()
+        for pos in range(len(lines)):
+            line = lines[pos]
+            if line:
+                raw, effective = classifyws(line, self.tabwidth)
+                effective = max(effective - self.indentwidth, 0)
+                lines[pos] = self._make_blanks(effective) + line[raw:]
+        self.set_region(head, tail, chars, lines)
+        return "break"
+
+    def comment_region_event(self, event):
+        head, tail, chars, lines = self.get_region()
+        for pos in range(len(lines) - 1):
+            line = lines[pos]
+            lines[pos] = "##" + line
+        self.set_region(head, tail, chars, lines)
+
+    def uncomment_region_event(self, event):
+        head, tail, chars, lines = self.get_region()
+        for pos in range(len(lines)):
+            line = lines[pos]
+            if not line:
+                continue
+            if line[:2] == "##":
+                line = line[2:]
+            elif line[:1] == "#":
+                line = line[1:]
+            lines[pos] = line
+        self.set_region(head, tail, chars, lines)
+
+    def tabify_region_event(self, event):
+        head, tail, chars, lines = self.get_region()
+        tabwidth = self._asktabwidth()
+        for pos in range(len(lines)):
+            line = lines[pos]
+            if line:
+                raw, effective = classifyws(line, tabwidth)
+                ntabs, nspaces = divmod(effective, tabwidth)
+                lines[pos] = "\t" * ntabs + " " * nspaces + line[raw:]
+        self.set_region(head, tail, chars, lines)
+
+    def untabify_region_event(self, event):
+        head, tail, chars, lines = self.get_region()
+        tabwidth = self._asktabwidth()
+        for pos in range(len(lines)):
+            lines[pos] = lines[pos].expandtabs(tabwidth)
+        self.set_region(head, tail, chars, lines)
+
+    def toggle_tabs_event(self, event):
+        if self.editwin.askyesno(
+            "Toggle tabs",
+            "Turn tabs " + ("on", "off")[self.usetabs] + "?",
+            parent=self.text,
+        ):
+            self.usetabs = not self.usetabs
+        return "break"
+
+    # XXX this isn't bound to anything -- see class tabwidth comments
+    def change_tabwidth_event(self, event):
+        new = self._asktabwidth()
+        if new != self.tabwidth:
+            self.tabwidth = new
+            self.set_indentation_params(0, guess=0)
+        return "break"
+
+    def change_indentwidth_event(self, event):
+        new = self.editwin.askinteger(
+            "Indent width",
+            "New indent width (1-16)",
+            parent=self.text,
+            initialvalue=self.indentwidth,
+            minvalue=1,
+            maxvalue=16,
+        )
+        if new and new != self.indentwidth:
+            self.indentwidth = new
+        return "break"
+
+    def get_region(self):
+        text = self.text
+        first, last = self.editwin.get_selection_indices()
+        if first and last:
+            head = text.index(first + " linestart")
+            tail = text.index(last + "-1c lineend +1c")
+        else:
+            head = text.index("insert linestart")
+            tail = text.index("insert lineend +1c")
+        chars = text.get(head, tail)
+        lines = chars.split("\n")
+        return head, tail, chars, lines
+
+    def set_region(self, head, tail, chars, lines):
+        text = self.text
+        newchars = "\n".join(lines)
+        if newchars == chars:
+            text.bell()
+            return
+        text.tag_remove("sel", "1.0", "end")
+        text.mark_set("insert", head)
+        text.undo_block_start()
+        text.delete(head, tail)
+        text.insert(head, newchars)
+        text.undo_block_stop()
+        text.tag_add("sel", head, "insert")
+
+    # Make string that displays as n leading blanks.
+
+    def _make_blanks(self, n):
+        if self.usetabs:
+            ntabs, nspaces = divmod(n, self.tabwidth)
+            return "\t" * ntabs + " " * nspaces
+        else:
+            return " " * n
+
+    # Delete from beginning of line to insert point, then reinsert
+    # column logical (meaning use tabs if appropriate) spaces.
+
+    def reindent_to(self, column):
+        text = self.text
+        text.undo_block_start()
+        if text.compare("insert linestart", "!=", "insert"):
+            text.delete("insert linestart", "insert")
+        if column:
+            text.insert("insert", self._make_blanks(column))
+        text.undo_block_stop()
+
+    def _asktabwidth(self):
+        return (
+            self.editwin.askinteger(
+                "Tab width",
+                "Spaces per tab?",
+                parent=self.text,
+                initialvalue=self.tabwidth,
+                minvalue=1,
+                maxvalue=16,
+            )
+            or self.tabwidth
+        )
+
+    # Guess indentwidth from text content.
+    # Return guessed indentwidth.  This should not be believed unless
+    # it's in a reasonable range (e.g., it will be 0 if no indented
+    # blocks are found).
+
+    def guess_indent(self):
+        opener, indented = IndentSearcher(self.text, self.tabwidth).run()
+        if opener and indented:
+            raw, indentsmall = classifyws(opener, self.tabwidth)
+            raw, indentlarge = classifyws(indented, self.tabwidth)
+        else:
+            indentsmall = indentlarge = 0
+        return indentlarge - indentsmall
+
+
+# "line.col" -> line, as an int
+def index2line(index):
+    return int(float(index))
+
+
+# Look at the leading whitespace in s.
+# Return pair (# of leading ws characters,
+#              effective # of leading blanks after expanding
+#              tabs to width tabwidth)
+
+
+def classifyws(s, tabwidth):
+    raw = effective = 0
+    for ch in s:
+        if ch == " ":
+            raw = raw + 1
+            effective = effective + 1
+        elif ch == "\t":
+            raw = raw + 1
+            effective = (effective // tabwidth + 1) * tabwidth
+        else:
+            break
+    return raw, effective
+
+
+class IndentSearcher:
+    # .run() chews over the Text widget, looking for a block opener
+    # and the stmt following it.  Returns a pair,
+    #     (line containing block opener, line containing stmt)
+    # Either or both may be None.
+
+    def __init__(self, text, tabwidth):
+        self.text = text
+        self.tabwidth = tabwidth
+        self.i = self.finished = 0
+        self.blkopenline = self.indentedline = None
+
+    def readline(self):
+        if self.finished:
+            val = ""
+        else:
+            i = self.i = self.i + 1
+            mark = repr(i) + ".0"
+            if self.text.compare(mark, ">=", "end"):
+                val = ""
+            else:
+                val = self.text.get(mark, mark + " lineend+1c")
+        # hrm - not sure this is correct in py3k - the source code may have
+        # an encoding declared, but the data will *always* be in
+        # default_scintilla_encoding - so if anyone looks at the encoding decl
+        # in the source they will be wrong.  I think.  Maybe.  Or something...
+        return val.encode(default_scintilla_encoding)
+
+    def run(self):
+        OPENERS = ("class", "def", "for", "if", "try", "while")
+        INDENT = tokenize.INDENT
+        NAME = tokenize.NAME
+
+        save_tabsize = tokenize.tabsize
+        tokenize.tabsize = self.tabwidth
+        try:
+            try:
+                for typ, token, start, end, line in token_generator(self.readline):
+                    if typ == NAME and token in OPENERS:
+                        self.blkopenline = line
+                    elif typ == INDENT and self.blkopenline:
+                        self.indentedline = line
+                        break
+
+            except (tokenize.TokenError, IndentationError):
+                # since we cut off the tokenizer early, we can trigger
+                # spurious errors
+                pass
+        finally:
+            tokenize.tabsize = save_tabsize
+        return self.blkopenline, self.indentedline
diff --git a/lib/pythonwin/pywin/idle/CallTips.py b/lib/pythonwin/pywin/idle/CallTips.py
new file mode 100644
index 00000000..cecc760a
--- /dev/null
+++ b/lib/pythonwin/pywin/idle/CallTips.py
@@ -0,0 +1,219 @@
+# CallTips.py - An IDLE extension that provides "Call Tips" - ie, a floating window that
+# displays parameter information as you open parens.
+
+import inspect
+import string
+import sys
+import traceback
+
+
+class CallTips:
+    menudefs = []
+
+    keydefs = {
+        "<<paren-open>>": ["<Key-parenleft>"],
+        "<<paren-close>>": ["<Key-parenright>"],
+        "<<check-calltip-cancel>>": ["<KeyRelease>"],
+        "<<calltip-cancel>>": ["<ButtonPress>", "<Key-Escape>"],
+    }
+
+    windows_keydefs = {}
+
+    unix_keydefs = {}
+
+    def __init__(self, editwin):
+        self.editwin = editwin
+        self.text = editwin.text
+        self.calltip = None
+        if hasattr(self.text, "make_calltip_window"):
+            self._make_calltip_window = self.text.make_calltip_window
+        else:
+            self._make_calltip_window = self._make_tk_calltip_window
+
+    def close(self):
+        self._make_calltip_window = None
+
+    # Makes a Tk based calltip window.  Used by IDLE, but not Pythonwin.
+    # See __init__ above for how this is used.
+    def _make_tk_calltip_window(self):
+        import CallTipWindow
+
+        return CallTipWindow.CallTip(self.text)
+
+    def _remove_calltip_window(self):
+        if self.calltip:
+            self.calltip.hidetip()
+            self.calltip = None
+
+    def paren_open_event(self, event):
+        self._remove_calltip_window()
+        arg_text = get_arg_text(self.get_object_at_cursor())
+        if arg_text:
+            self.calltip_start = self.text.index("insert")
+            self.calltip = self._make_calltip_window()
+            self.calltip.showtip(arg_text)
+        return ""  # so the event is handled normally.
+
+    def paren_close_event(self, event):
+        # Now just hides, but later we should check if other
+        # paren'd expressions remain open.
+        self._remove_calltip_window()
+        return ""  # so the event is handled normally.
+
+    def check_calltip_cancel_event(self, event):
+        if self.calltip:
+            # If we have moved before the start of the calltip,
+            # or off the calltip line, then cancel the tip.
+            # (Later need to be smarter about multi-line, etc)
+            if self.text.compare(
+                "insert", "<=", self.calltip_start
+            ) or self.text.compare("insert", ">", self.calltip_start + " lineend"):
+                self._remove_calltip_window()
+        return ""  # so the event is handled normally.
+
+    def calltip_cancel_event(self, event):
+        self._remove_calltip_window()
+        return ""  # so the event is handled normally.
+
+    def get_object_at_cursor(
+        self,
+        wordchars="._"
+        + string.ascii_uppercase
+        + string.ascii_lowercase
+        + string.digits,
+    ):
+        # XXX - This needs to be moved to a better place
+        # so the "." attribute lookup code can also use it.
+        text = self.text
+        chars = text.get("insert linestart", "insert")
+        i = len(chars)
+        while i and chars[i - 1] in wordchars:
+            i = i - 1
+        word = chars[i:]
+        if word:
+            # How is this for a hack!
+            import __main__
+
+            namespace = sys.modules.copy()
+            namespace.update(__main__.__dict__)
+            try:
+                return eval(word, namespace)
+            except:
+                pass
+        return None  # Can't find an object.
+
+
+def _find_constructor(class_ob):
+    # Given a class object, return a function object used for the
+    # constructor (ie, __init__() ) or None if we can't find one.
+    try:
+        return class_ob.__init__
+    except AttributeError:
+        for base in class_ob.__bases__:
+            rc = _find_constructor(base)
+            if rc is not None:
+                return rc
+    return None
+
+
+def get_arg_text(ob):
+    # Get a string describing the arguments for the given object.
+    argText = ""
+    if ob is not None:
+        if inspect.isclass(ob):
+            # Look for the highest __init__ in the class chain.
+            fob = _find_constructor(ob)
+            if fob is None:
+                fob = lambda: None
+        else:
+            fob = ob
+        if inspect.isfunction(fob) or inspect.ismethod(fob):
+            try:
+                argText = str(inspect.signature(fob))
+            except:
+                print("Failed to format the args")
+                traceback.print_exc()
+        # See if we can use the docstring
+        if hasattr(ob, "__doc__"):
+            doc = ob.__doc__
+            try:
+                doc = doc.strip()
+                pos = doc.find("\n")
+            except AttributeError:
+                ## New style classes may have __doc__ slot without actually
+                ## having a string assigned to it
+                pass
+            else:
+                if pos < 0 or pos > 70:
+                    pos = 70
+                if argText:
+                    argText = argText + "\n"
+                argText = argText + doc[:pos]
+
+    return argText
+
+
+#################################################
+#
+# Test code
+#
+if __name__ == "__main__":
+
+    def t1():
+        "()"
+
+    def t2(a, b=None):
+        "(a, b=None)"
+
+    def t3(a, *args):
+        "(a, *args)"
+
+    def t4(*args):
+        "(*args)"
+
+    def t5(a, *args):
+        "(a, *args)"
+
+    def t6(a, b=None, *args, **kw):
+        "(a, b=None, *args, **kw)"
+
+    class TC:
+        "(self, a=None, *b)"
+
+        def __init__(self, a=None, *b):
+            "(self, a=None, *b)"
+
+        def t1(self):
+            "(self)"
+
+        def t2(self, a, b=None):
+            "(self, a, b=None)"
+
+        def t3(self, a, *args):
+            "(self, a, *args)"
+
+        def t4(self, *args):
+            "(self, *args)"
+
+        def t5(self, a, *args):
+            "(self, a, *args)"
+
+        def t6(self, a, b=None, *args, **kw):
+            "(self, a, b=None, *args, **kw)"
+
+    def test(tests):
+        failed = []
+        for t in tests:
+            expected = t.__doc__ + "\n" + t.__doc__
+            if get_arg_text(t) != expected:
+                failed.append(t)
+                print(
+                    "%s - expected %s, but got %s"
+                    % (t, repr(expected), repr(get_arg_text(t)))
+                )
+        print("%d of %d tests failed" % (len(failed), len(tests)))
+
+    tc = TC()
+    tests = t1, t2, t3, t4, t5, t6, TC, tc.t1, tc.t2, tc.t3, tc.t4, tc.t5, tc.t6
+
+    test(tests)
diff --git a/lib/pythonwin/pywin/idle/FormatParagraph.py b/lib/pythonwin/pywin/idle/FormatParagraph.py
new file mode 100644
index 00000000..143c18ee
--- /dev/null
+++ b/lib/pythonwin/pywin/idle/FormatParagraph.py
@@ -0,0 +1,166 @@
+# Extension to format a paragraph
+
+# Does basic, standard text formatting, and also understands Python
+# comment blocks.  Thus, for editing Python source code, this
+# extension is really only suitable for reformatting these comment
+# blocks or triple-quoted strings.
+
+# Known problems with comment reformatting:
+# * If there is a selection marked, and the first line of the
+#   selection is not complete, the block will probably not be detected
+#   as comments, and will have the normal "text formatting" rules
+#   applied.
+# * If a comment block has leading whitespace that mixes tabs and
+#   spaces, they will not be considered part of the same block.
+# * Fancy comments, like this bulleted list, arent handled :-)
+
+import re
+
+
+class FormatParagraph:
+    menudefs = [
+        (
+            "edit",
+            [
+                ("Format Paragraph", "<<format-paragraph>>"),
+            ],
+        )
+    ]
+
+    keydefs = {
+        "<<format-paragraph>>": ["<Alt-q>"],
+    }
+
+    unix_keydefs = {
+        "<<format-paragraph>>": ["<Meta-q>"],
+    }
+
+    def __init__(self, editwin):
+        self.editwin = editwin
+
+    def close(self):
+        self.editwin = None
+
+    def format_paragraph_event(self, event):
+        text = self.editwin.text
+        first, last = self.editwin.get_selection_indices()
+        if first and last:
+            data = text.get(first, last)
+            comment_header = ""
+        else:
+            first, last, comment_header, data = find_paragraph(
+                text, text.index("insert")
+            )
+        if comment_header:
+            # Reformat the comment lines - convert to text sans header.
+            lines = data.split("\n")
+            lines = map(lambda st, l=len(comment_header): st[l:], lines)
+            data = "\n".join(lines)
+            # Reformat to 70 chars or a 20 char width, whichever is greater.
+            format_width = max(70 - len(comment_header), 20)
+            newdata = reformat_paragraph(data, format_width)
+            # re-split and re-insert the comment header.
+            newdata = newdata.split("\n")
+            # If the block ends in a \n, we dont want the comment
+            # prefix inserted after it. (Im not sure it makes sense to
+            # reformat a comment block that isnt made of complete
+            # lines, but whatever!)  Can't think of a clean soltution,
+            # so we hack away
+            block_suffix = ""
+            if not newdata[-1]:
+                block_suffix = "\n"
+                newdata = newdata[:-1]
+            builder = lambda item, prefix=comment_header: prefix + item
+            newdata = "\n".join([builder(d) for d in newdata]) + block_suffix
+        else:
+            # Just a normal text format
+            newdata = reformat_paragraph(data)
+        text.tag_remove("sel", "1.0", "end")
+        if newdata != data:
+            text.mark_set("insert", first)
+            text.undo_block_start()
+            text.delete(first, last)
+            text.insert(first, newdata)
+            text.undo_block_stop()
+        else:
+            text.mark_set("insert", last)
+        text.see("insert")
+
+
+def find_paragraph(text, mark):
+    lineno, col = list(map(int, mark.split(".")))
+    line = text.get("%d.0" % lineno, "%d.0 lineend" % lineno)
+    while text.compare("%d.0" % lineno, "<", "end") and is_all_white(line):
+        lineno = lineno + 1
+        line = text.get("%d.0" % lineno, "%d.0 lineend" % lineno)
+    first_lineno = lineno
+    comment_header = get_comment_header(line)
+    comment_header_len = len(comment_header)
+    while get_comment_header(line) == comment_header and not is_all_white(
+        line[comment_header_len:]
+    ):
+        lineno = lineno + 1
+        line = text.get("%d.0" % lineno, "%d.0 lineend" % lineno)
+    last = "%d.0" % lineno
+    # Search back to beginning of paragraph
+    lineno = first_lineno - 1
+    line = text.get("%d.0" % lineno, "%d.0 lineend" % lineno)
+    while (
+        lineno > 0
+        and get_comment_header(line) == comment_header
+        and not is_all_white(line[comment_header_len:])
+    ):
+        lineno = lineno - 1
+        line = text.get("%d.0" % lineno, "%d.0 lineend" % lineno)
+    first = "%d.0" % (lineno + 1)
+    return first, last, comment_header, text.get(first, last)
+
+
+def reformat_paragraph(data, limit=70):
+    lines = data.split("\n")
+    i = 0
+    n = len(lines)
+    while i < n and is_all_white(lines[i]):
+        i = i + 1
+    if i >= n:
+        return data
+    indent1 = get_indent(lines[i])
+    if i + 1 < n and not is_all_white(lines[i + 1]):
+        indent2 = get_indent(lines[i + 1])
+    else:
+        indent2 = indent1
+    new = lines[:i]
+    partial = indent1
+    while i < n and not is_all_white(lines[i]):
+        # XXX Should take double space after period (etc.) into account
+        words = re.split("(\s+)", lines[i])
+        for j in range(0, len(words), 2):
+            word = words[j]
+            if not word:
+                continue  # Can happen when line ends in whitespace
+            if len((partial + word).expandtabs()) > limit and partial != indent1:
+                new.append(partial.rstrip())
+                partial = indent2
+            partial = partial + word + " "
+            if j + 1 < len(words) and words[j + 1] != " ":
+                partial = partial + " "
+        i = i + 1
+    new.append(partial.rstrip())
+    # XXX Should reformat remaining paragraphs as well
+    new.extend(lines[i:])
+    return "\n".join(new)
+
+
+def is_all_white(line):
+    return re.match(r"^\s*$", line) is not None
+
+
+def get_indent(line):
+    return re.match(r"^(\s*)", line).group()
+
+
+def get_comment_header(line):
+    m = re.match(r"^(\s*#*)", line)
+    if m is None:
+        return ""
+    return m.group(1)
diff --git a/lib/pythonwin/pywin/idle/IdleHistory.py b/lib/pythonwin/pywin/idle/IdleHistory.py
new file mode 100644
index 00000000..24e69240
--- /dev/null
+++ b/lib/pythonwin/pywin/idle/IdleHistory.py
@@ -0,0 +1,87 @@
+class History:
+    def __init__(self, text, output_sep="\n"):
+        self.text = text
+        self.history = []
+        self.history_prefix = None
+        self.history_pointer = None
+        self.output_sep = output_sep
+        text.bind("<<history-previous>>", self.history_prev)
+        text.bind("<<history-next>>", self.history_next)
+
+    def history_next(self, event):
+        self.history_do(0)
+        return "break"
+
+    def history_prev(self, event):
+        self.history_do(1)
+        return "break"
+
+    def _get_source(self, start, end):
+        # Get source code from start index to end index.  Lines in the
+        # text control may be separated by sys.ps2 .
+        lines = self.text.get(start, end).split(self.output_sep)
+        return "\n".join(lines)
+
+    def _put_source(self, where, source):
+        output = self.output_sep.join(source.split("\n"))
+        self.text.insert(where, output)
+
+    def history_do(self, reverse):
+        nhist = len(self.history)
+        pointer = self.history_pointer
+        prefix = self.history_prefix
+        if pointer is not None and prefix is not None:
+            if (
+                self.text.compare("insert", "!=", "end-1c")
+                or self._get_source("iomark", "end-1c") != self.history[pointer]
+            ):
+                pointer = prefix = None
+        if pointer is None or prefix is None:
+            prefix = self._get_source("iomark", "end-1c")
+            if reverse:
+                pointer = nhist
+            else:
+                pointer = -1
+        nprefix = len(prefix)
+        while 1:
+            if reverse:
+                pointer = pointer - 1
+            else:
+                pointer = pointer + 1
+            if pointer < 0 or pointer >= nhist:
+                self.text.bell()
+                if self._get_source("iomark", "end-1c") != prefix:
+                    self.text.delete("iomark", "end-1c")
+                    self._put_source("iomark", prefix)
+                pointer = prefix = None
+                break
+            item = self.history[pointer]
+            if item[:nprefix] == prefix and len(item) > nprefix:
+                self.text.delete("iomark", "end-1c")
+                self._put_source("iomark", item)
+                break
+        self.text.mark_set("insert", "end-1c")
+        self.text.see("insert")
+        self.text.tag_remove("sel", "1.0", "end")
+        self.history_pointer = pointer
+        self.history_prefix = prefix
+
+    def history_store(self, source):
+        source = source.strip()
+        if len(source) > 2:
+            # avoid duplicates
+            try:
+                self.history.remove(source)
+            except ValueError:
+                pass
+            self.history.append(source)
+        self.history_pointer = None
+        self.history_prefix = None
+
+    def recall(self, s):
+        s = s.strip()
+        self.text.tag_remove("sel", "1.0", "end")
+        self.text.delete("iomark", "end-1c")
+        self.text.mark_set("insert", "end-1c")
+        self.text.insert("insert", s)
+        self.text.see("insert")
diff --git a/lib/pythonwin/pywin/idle/PyParse.py b/lib/pythonwin/pywin/idle/PyParse.py
new file mode 100644
index 00000000..173336ca
--- /dev/null
+++ b/lib/pythonwin/pywin/idle/PyParse.py
@@ -0,0 +1,591 @@
+import re
+import string
+import sys
+
+# Reason last stmt is continued (or C_NONE if it's not).
+C_NONE, C_BACKSLASH, C_STRING, C_BRACKET = list(range(4))
+
+if 0:  # for throwaway debugging output
+
+    def dump(*stuff):
+        sys.__stdout__.write(" ".join(map(str, stuff)) + "\n")
+
+
+# Find what looks like the start of a popular stmt.
+
+_synchre = re.compile(
+    r"""
+    ^
+    [ \t]*
+    (?: if
+    |   for
+    |   while
+    |   else
+    |   def
+    |   return
+    |   assert
+    |   break
+    |   class
+    |   continue
+    |   elif
+    |   try
+    |   except
+    |   raise
+    |   import
+    )
+    \b
+""",
+    re.VERBOSE | re.MULTILINE,
+).search
+
+# Match blank line or non-indenting comment line.
+
+_junkre = re.compile(
+    r"""
+    [ \t]*
+    (?: \# \S .* )?
+    \n
+""",
+    re.VERBOSE,
+).match
+
+# Match any flavor of string; the terminating quote is optional
+# so that we're robust in the face of incomplete program text.
+
+_match_stringre = re.compile(
+    r"""
+    \""" [^"\\]* (?:
+                     (?: \\. | "(?!"") )
+                     [^"\\]*
+                 )*
+    (?: \""" )?
+
+|   " [^"\\\n]* (?: \\. [^"\\\n]* )* "?
+
+|   ''' [^'\\]* (?:
+                   (?: \\. | '(?!'') )
+                   [^'\\]*
+                )*
+    (?: ''' )?
+
+|   ' [^'\\\n]* (?: \\. [^'\\\n]* )* '?
+""",
+    re.VERBOSE | re.DOTALL,
+).match
+
+# Match a line that starts with something interesting;
+# used to find the first item of a bracket structure.
+
+_itemre = re.compile(
+    r"""
+    [ \t]*
+    [^\s#\\]    # if we match, m.end()-1 is the interesting char
+""",
+    re.VERBOSE,
+).match
+
+# Match start of stmts that should be followed by a dedent.
+
+_closere = re.compile(
+    r"""
+    \s*
+    (?: return
+    |   break
+    |   continue
+    |   raise
+    |   pass
+    )
+    \b
+""",
+    re.VERBOSE,
+).match
+
+# Chew up non-special chars as quickly as possible.  If match is
+# successful, m.end() less 1 is the index of the last boring char
+# matched.  If match is unsuccessful, the string starts with an
+# interesting char.
+
+_chew_ordinaryre = re.compile(
+    r"""
+    [^[\](){}#'"\\]+
+""",
+    re.VERBOSE,
+).match
+
+# Build translation table to map uninteresting chars to "x", open
+# brackets to "(", and close brackets to ")".
+
+_tran = ["x"] * 256
+for ch in "({[":
+    _tran[ord(ch)] = "("
+for ch in ")}]":
+    _tran[ord(ch)] = ")"
+for ch in "\"'\\\n#":
+    _tran[ord(ch)] = ch
+# We are called with unicode strings, and str.translate is one of the few
+# py2k functions which can't 'do the right thing' - so take care to ensure
+# _tran is full of unicode...
+_tran = "".join(_tran)
+del ch
+
+
+class Parser:
+    def __init__(self, indentwidth, tabwidth):
+        self.indentwidth = indentwidth
+        self.tabwidth = tabwidth
+
+    def set_str(self, str):
+        assert len(str) == 0 or str[-1] == "\n", "Oops - have str %r" % (str,)
+        self.str = str
+        self.study_level = 0
+
+    # Return index of a good place to begin parsing, as close to the
+    # end of the string as possible.  This will be the start of some
+    # popular stmt like "if" or "def".  Return None if none found:
+    # the caller should pass more prior context then, if possible, or
+    # if not (the entire program text up until the point of interest
+    # has already been tried) pass 0 to set_lo.
+    #
+    # This will be reliable iff given a reliable is_char_in_string
+    # function, meaning that when it says "no", it's absolutely
+    # guaranteed that the char is not in a string.
+    #
+    # Ack, hack: in the shell window this kills us, because there's
+    # no way to tell the differences between output, >>> etc and
+    # user input.  Indeed, IDLE's first output line makes the rest
+    # look like it's in an unclosed paren!:
+    # Python 1.5.2 (#0, Apr 13 1999, ...
+
+    def find_good_parse_start(self, use_ps1, is_char_in_string=None):
+        str, pos = self.str, None
+        if use_ps1:
+            # shell window
+            ps1 = "\n" + sys.ps1
+            i = str.rfind(ps1)
+            if i >= 0:
+                pos = i + len(ps1)
+                # make it look like there's a newline instead
+                # of ps1 at the start -- hacking here once avoids
+                # repeated hackery later
+                self.str = str[: pos - 1] + "\n" + str[pos:]
+            return pos
+
+        # File window -- real work.
+        if not is_char_in_string:
+            # no clue -- make the caller pass everything
+            return None
+
+        # Peek back from the end for a good place to start,
+        # but don't try too often; pos will be left None, or
+        # bumped to a legitimate synch point.
+        limit = len(str)
+        for tries in range(5):
+            i = str.rfind(":\n", 0, limit)
+            if i < 0:
+                break
+            i = str.rfind("\n", 0, i) + 1  # start of colon line
+            m = _synchre(str, i, limit)
+            if m and not is_char_in_string(m.start()):
+                pos = m.start()
+                break
+            limit = i
+        if pos is None:
+            # Nothing looks like a block-opener, or stuff does
+            # but is_char_in_string keeps returning true; most likely
+            # we're in or near a giant string, the colorizer hasn't
+            # caught up enough to be helpful, or there simply *aren't*
+            # any interesting stmts.  In any of these cases we're
+            # going to have to parse the whole thing to be sure, so
+            # give it one last try from the start, but stop wasting
+            # time here regardless of the outcome.
+            m = _synchre(str)
+            if m and not is_char_in_string(m.start()):
+                pos = m.start()
+            return pos
+
+        # Peeking back worked; look forward until _synchre no longer
+        # matches.
+        i = pos + 1
+        while 1:
+            m = _synchre(str, i)
+            if m:
+                s, i = m.span()
+                if not is_char_in_string(s):
+                    pos = s
+            else:
+                break
+        return pos
+
+    # Throw away the start of the string.  Intended to be called with
+    # find_good_parse_start's result.
+
+    def set_lo(self, lo):
+        assert lo == 0 or self.str[lo - 1] == "\n"
+        if lo > 0:
+            self.str = self.str[lo:]
+
+    # As quickly as humanly possible <wink>, find the line numbers (0-
+    # based) of the non-continuation lines.
+    # Creates self.{goodlines, continuation}.
+
+    def _study1(self):
+        if self.study_level >= 1:
+            return
+        self.study_level = 1
+
+        # Map all uninteresting characters to "x", all open brackets
+        # to "(", all close brackets to ")", then collapse runs of
+        # uninteresting characters.  This can cut the number of chars
+        # by a factor of 10-40, and so greatly speed the following loop.
+        str = self.str
+        str = str.translate(_tran)
+        str = str.replace("xxxxxxxx", "x")
+        str = str.replace("xxxx", "x")
+        str = str.replace("xx", "x")
+        str = str.replace("xx", "x")
+        str = str.replace("\nx", "\n")
+        # note that replacing x\n with \n would be incorrect, because
+        # x may be preceded by a backslash
+
+        # March over the squashed version of the program, accumulating
+        # the line numbers of non-continued stmts, and determining
+        # whether & why the last stmt is a continuation.
+        continuation = C_NONE
+        level = lno = 0  # level is nesting level; lno is line number
+        self.goodlines = goodlines = [0]
+        push_good = goodlines.append
+        i, n = 0, len(str)
+        while i < n:
+            ch = str[i]
+            i = i + 1
+
+            # cases are checked in decreasing order of frequency
+            if ch == "x":
+                continue
+
+            if ch == "\n":
+                lno = lno + 1
+                if level == 0:
+                    push_good(lno)
+                    # else we're in an unclosed bracket structure
+                continue
+
+            if ch == "(":
+                level = level + 1
+                continue
+
+            if ch == ")":
+                if level:
+                    level = level - 1
+                    # else the program is invalid, but we can't complain
+                continue
+
+            if ch == '"' or ch == "'":
+                # consume the string
+                quote = ch
+                if str[i - 1 : i + 2] == quote * 3:
+                    quote = quote * 3
+                w = len(quote) - 1
+                i = i + w
+                while i < n:
+                    ch = str[i]
+                    i = i + 1
+
+                    if ch == "x":
+                        continue
+
+                    if str[i - 1 : i + w] == quote:
+                        i = i + w
+                        break
+
+                    if ch == "\n":
+                        lno = lno + 1
+                        if w == 0:
+                            # unterminated single-quoted string
+                            if level == 0:
+                                push_good(lno)
+                            break
+                        continue
+
+                    if ch == "\\":
+                        assert i < n
+                        if str[i] == "\n":
+                            lno = lno + 1
+                        i = i + 1
+                        continue
+
+                    # else comment char or paren inside string
+
+                else:
+                    # didn't break out of the loop, so we're still
+                    # inside a string
+                    continuation = C_STRING
+                continue  # with outer loop
+
+            if ch == "#":
+                # consume the comment
+                i = str.find("\n", i)
+                assert i >= 0
+                continue
+
+            assert ch == "\\"
+            assert i < n
+            if str[i] == "\n":
+                lno = lno + 1
+                if i + 1 == n:
+                    continuation = C_BACKSLASH
+            i = i + 1
+
+        # The last stmt may be continued for all 3 reasons.
+        # String continuation takes precedence over bracket
+        # continuation, which beats backslash continuation.
+        if continuation != C_STRING and level > 0:
+            continuation = C_BRACKET
+        self.continuation = continuation
+
+        # Push the final line number as a sentinel value, regardless of
+        # whether it's continued.
+        assert (continuation == C_NONE) == (goodlines[-1] == lno)
+        if goodlines[-1] != lno:
+            push_good(lno)
+
+    def get_continuation_type(self):
+        self._study1()
+        return self.continuation
+
+    # study1 was sufficient to determine the continuation status,
+    # but doing more requires looking at every character.  study2
+    # does this for the last interesting statement in the block.
+    # Creates:
+    #     self.stmt_start, stmt_end
+    #         slice indices of last interesting stmt
+    #     self.lastch
+    #         last non-whitespace character before optional trailing
+    #         comment
+    #     self.lastopenbracketpos
+    #         if continuation is C_BRACKET, index of last open bracket
+
+    def _study2(self):
+        _ws = string.whitespace
+        if self.study_level >= 2:
+            return
+        self._study1()
+        self.study_level = 2
+
+        # Set p and q to slice indices of last interesting stmt.
+        str, goodlines = self.str, self.goodlines
+        i = len(goodlines) - 1
+        p = len(str)  # index of newest line
+        while i:
+            assert p
+            # p is the index of the stmt at line number goodlines[i].
+            # Move p back to the stmt at line number goodlines[i-1].
+            q = p
+            for nothing in range(goodlines[i - 1], goodlines[i]):
+                # tricky: sets p to 0 if no preceding newline
+                p = str.rfind("\n", 0, p - 1) + 1
+            # The stmt str[p:q] isn't a continuation, but may be blank
+            # or a non-indenting comment line.
+            if _junkre(str, p):
+                i = i - 1
+            else:
+                break
+        if i == 0:
+            # nothing but junk!
+            assert p == 0
+            q = p
+        self.stmt_start, self.stmt_end = p, q
+
+        # Analyze this stmt, to find the last open bracket (if any)
+        # and last interesting character (if any).
+        lastch = ""
+        stack = []  # stack of open bracket indices
+        push_stack = stack.append
+        while p < q:
+            # suck up all except ()[]{}'"#\\
+            m = _chew_ordinaryre(str, p, q)
+            if m:
+                # we skipped at least one boring char
+                newp = m.end()
+                # back up over totally boring whitespace
+                i = newp - 1  # index of last boring char
+                while i >= p and str[i] in " \t\n":
+                    i = i - 1
+                if i >= p:
+                    lastch = str[i]
+                p = newp
+                if p >= q:
+                    break
+
+            ch = str[p]
+
+            if ch in "([{":
+                push_stack(p)
+                lastch = ch
+                p = p + 1
+                continue
+
+            if ch in ")]}":
+                if stack:
+                    del stack[-1]
+                lastch = ch
+                p = p + 1
+                continue
+
+            if ch == '"' or ch == "'":
+                # consume string
+                # Note that study1 did this with a Python loop, but
+                # we use a regexp here; the reason is speed in both
+                # cases; the string may be huge, but study1 pre-squashed
+                # strings to a couple of characters per line.  study1
+                # also needed to keep track of newlines, and we don't
+                # have to.
+                lastch = ch
+                p = _match_stringre(str, p, q).end()
+                continue
+
+            if ch == "#":
+                # consume comment and trailing newline
+                p = str.find("\n", p, q) + 1
+                assert p > 0
+                continue
+
+            assert ch == "\\"
+            p = p + 1  # beyond backslash
+            assert p < q
+            if str[p] != "\n":
+                # the program is invalid, but can't complain
+                lastch = ch + str[p]
+            p = p + 1  # beyond escaped char
+
+        # end while p < q:
+
+        self.lastch = lastch
+        if stack:
+            self.lastopenbracketpos = stack[-1]
+
+    # Assuming continuation is C_BRACKET, return the number
+    # of spaces the next line should be indented.
+
+    def compute_bracket_indent(self):
+        self._study2()
+        assert self.continuation == C_BRACKET
+        j = self.lastopenbracketpos
+        str = self.str
+        n = len(str)
+        origi = i = str.rfind("\n", 0, j) + 1
+        j = j + 1  # one beyond open bracket
+        # find first list item; set i to start of its line
+        while j < n:
+            m = _itemre(str, j)
+            if m:
+                j = m.end() - 1  # index of first interesting char
+                extra = 0
+                break
+            else:
+                # this line is junk; advance to next line
+                i = j = str.find("\n", j) + 1
+        else:
+            # nothing interesting follows the bracket;
+            # reproduce the bracket line's indentation + a level
+            j = i = origi
+            while str[j] in " \t":
+                j = j + 1
+            extra = self.indentwidth
+        return len(str[i:j].expandtabs(self.tabwidth)) + extra
+
+    # Return number of physical lines in last stmt (whether or not
+    # it's an interesting stmt!  this is intended to be called when
+    # continuation is C_BACKSLASH).
+
+    def get_num_lines_in_stmt(self):
+        self._study1()
+        goodlines = self.goodlines
+        return goodlines[-1] - goodlines[-2]
+
+    # Assuming continuation is C_BACKSLASH, return the number of spaces
+    # the next line should be indented.  Also assuming the new line is
+    # the first one following the initial line of the stmt.
+
+    def compute_backslash_indent(self):
+        self._study2()
+        assert self.continuation == C_BACKSLASH
+        str = self.str
+        i = self.stmt_start
+        while str[i] in " \t":
+            i = i + 1
+        startpos = i
+
+        # See whether the initial line starts an assignment stmt; i.e.,
+        # look for an = operator
+        endpos = str.find("\n", startpos) + 1
+        found = level = 0
+        while i < endpos:
+            ch = str[i]
+            if ch in "([{":
+                level = level + 1
+                i = i + 1
+            elif ch in ")]}":
+                if level:
+                    level = level - 1
+                i = i + 1
+            elif ch == '"' or ch == "'":
+                i = _match_stringre(str, i, endpos).end()
+            elif ch == "#":
+                break
+            elif (
+                level == 0
+                and ch == "="
+                and (i == 0 or str[i - 1] not in "=<>!")
+                and str[i + 1] != "="
+            ):
+                found = 1
+                break
+            else:
+                i = i + 1
+
+        if found:
+            # found a legit =, but it may be the last interesting
+            # thing on the line
+            i = i + 1  # move beyond the =
+            found = re.match(r"\s*\\", str[i:endpos]) is None
+
+        if not found:
+            # oh well ... settle for moving beyond the first chunk
+            # of non-whitespace chars
+            i = startpos
+            while str[i] not in " \t\n":
+                i = i + 1
+
+        return len(str[self.stmt_start : i].expandtabs(self.tabwidth)) + 1
+
+    # Return the leading whitespace on the initial line of the last
+    # interesting stmt.
+
+    def get_base_indent_string(self):
+        self._study2()
+        i, n = self.stmt_start, self.stmt_end
+        j = i
+        str = self.str
+        while j < n and str[j] in " \t":
+            j = j + 1
+        return str[i:j]
+
+    # Did the last interesting stmt open a block?
+
+    def is_block_opener(self):
+        self._study2()
+        return self.lastch == ":"
+
+    # Did the last interesting stmt close a block?
+
+    def is_block_closer(self):
+        self._study2()
+        return _closere(self.str, self.stmt_start) is not None
+
+    # index of last open bracket ({[, or None if none
+    lastopenbracketpos = None
+
+    def get_last_open_bracket_pos(self):
+        self._study2()
+        return self.lastopenbracketpos
diff --git a/lib/pythonwin/pywin/idle/__init__.py b/lib/pythonwin/pywin/idle/__init__.py
new file mode 100644
index 00000000..b175d755
--- /dev/null
+++ b/lib/pythonwin/pywin/idle/__init__.py
@@ -0,0 +1 @@
+# This file denotes the directory as a Python package.
diff --git a/lib/pythonwin/pywin/mfc/__init__.py b/lib/pythonwin/pywin/mfc/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/lib/pythonwin/pywin/mfc/activex.py b/lib/pythonwin/pywin/mfc/activex.py
new file mode 100644
index 00000000..596bbef5
--- /dev/null
+++ b/lib/pythonwin/pywin/mfc/activex.py
@@ -0,0 +1,86 @@
+"""Support for ActiveX control hosting in Pythonwin.
+"""
+import win32ui
+import win32uiole
+
+from . import window
+
+# XXX - we are still "classic style" classes in py2x, so we need can't yet
+# use 'type()' everywhere - revisit soon, as py2x will move to new-style too...
+try:
+    from types import ClassType as new_type
+except ImportError:
+    new_type = type  # py3k
+
+
+class Control(window.Wnd):
+    """An ActiveX control base class.  A new class must be derived from both
+    this class and the Events class.  See the demos for more details.
+    """
+
+    def __init__(self):
+        self.__dict__["_dispobj_"] = None
+        window.Wnd.__init__(self)
+
+    def _GetControlCLSID(self):
+        return self.CLSID
+
+    def _GetDispatchClass(self):
+        return self.default_interface
+
+    def _GetEventMap(self):
+        return self.default_source._dispid_to_func_
+
+    def CreateControl(self, windowTitle, style, rect, parent, id, lic_string=None):
+        clsid = str(self._GetControlCLSID())
+        self.__dict__["_obj_"] = win32ui.CreateControl(
+            clsid, windowTitle, style, rect, parent, id, None, False, lic_string
+        )
+        klass = self._GetDispatchClass()
+        dispobj = klass(win32uiole.GetIDispatchForWindow(self._obj_))
+        self.HookOleEvents()
+        self.__dict__["_dispobj_"] = dispobj
+
+    def HookOleEvents(self):
+        dict = self._GetEventMap()
+        for dispid, methodName in dict.items():
+            if hasattr(self, methodName):
+                self._obj_.HookOleEvent(getattr(self, methodName), dispid)
+
+    def __getattr__(self, attr):
+        # Delegate attributes to the windows and the Dispatch object for this class
+        try:
+            return window.Wnd.__getattr__(self, attr)
+        except AttributeError:
+            pass
+        return getattr(self._dispobj_, attr)
+
+    def __setattr__(self, attr, value):
+        if hasattr(self.__dict__, attr):
+            self.__dict__[attr] = value
+            return
+        try:
+            if self._dispobj_:
+                self._dispobj_.__setattr__(attr, value)
+                return
+        except AttributeError:
+            pass
+        self.__dict__[attr] = value
+
+
+def MakeControlClass(controlClass, name=None):
+    """Given a CoClass in a generated .py file, this function will return a Class
+    object which can be used as an OCX control.
+
+    This function is used when you do not want to handle any events from the OCX
+    control.  If you need events, then you should derive a class from both the
+    activex.Control class and the CoClass
+    """
+    if name is None:
+        name = controlClass.__name__
+    return new_type("OCX" + name, (Control, controlClass), {})
+
+
+def MakeControlInstance(controlClass, name=None):
+    """As for MakeControlClass(), but returns an instance of the class."""
+    return MakeControlClass(controlClass, name)()
diff --git a/lib/pythonwin/pywin/mfc/afxres.py b/lib/pythonwin/pywin/mfc/afxres.py
new file mode 100644
index 00000000..249211ff
--- /dev/null
+++ b/lib/pythonwin/pywin/mfc/afxres.py
@@ -0,0 +1,501 @@
+# Generated by h2py from stdin
+TCS_MULTILINE = 0x0200
+CBRS_ALIGN_LEFT = 0x1000
+CBRS_ALIGN_TOP = 0x2000
+CBRS_ALIGN_RIGHT = 0x4000
+CBRS_ALIGN_BOTTOM = 0x8000
+CBRS_ALIGN_ANY = 0xF000
+CBRS_BORDER_LEFT = 0x0100
+CBRS_BORDER_TOP = 0x0200
+CBRS_BORDER_RIGHT = 0x0400
+CBRS_BORDER_BOTTOM = 0x0800
+CBRS_BORDER_ANY = 0x0F00
+CBRS_TOOLTIPS = 0x0010
+CBRS_FLYBY = 0x0020
+CBRS_FLOAT_MULTI = 0x0040
+CBRS_BORDER_3D = 0x0080
+CBRS_HIDE_INPLACE = 0x0008
+CBRS_SIZE_DYNAMIC = 0x0004
+CBRS_SIZE_FIXED = 0x0002
+CBRS_FLOATING = 0x0001
+CBRS_GRIPPER = 0x00400000
+CBRS_ORIENT_HORZ = CBRS_ALIGN_TOP | CBRS_ALIGN_BOTTOM
+CBRS_ORIENT_VERT = CBRS_ALIGN_LEFT | CBRS_ALIGN_RIGHT
+CBRS_ORIENT_ANY = CBRS_ORIENT_HORZ | CBRS_ORIENT_VERT
+CBRS_ALL = 0xFFFF
+CBRS_NOALIGN = 0x00000000
+CBRS_LEFT = CBRS_ALIGN_LEFT | CBRS_BORDER_RIGHT
+CBRS_TOP = CBRS_ALIGN_TOP | CBRS_BORDER_BOTTOM
+CBRS_RIGHT = CBRS_ALIGN_RIGHT | CBRS_BORDER_LEFT
+CBRS_BOTTOM = CBRS_ALIGN_BOTTOM | CBRS_BORDER_TOP
+SBPS_NORMAL = 0x0000
+SBPS_NOBORDERS = 0x0100
+SBPS_POPOUT = 0x0200
+SBPS_OWNERDRAW = 0x1000
+SBPS_DISABLED = 0x04000000
+SBPS_STRETCH = 0x08000000
+ID_INDICATOR_EXT = 0xE700
+ID_INDICATOR_CAPS = 0xE701
+ID_INDICATOR_NUM = 0xE702
+ID_INDICATOR_SCRL = 0xE703
+ID_INDICATOR_OVR = 0xE704
+ID_INDICATOR_REC = 0xE705
+ID_INDICATOR_KANA = 0xE706
+ID_SEPARATOR = 0
+AFX_IDW_CONTROLBAR_FIRST = 0xE800
+AFX_IDW_CONTROLBAR_LAST = 0xE8FF
+AFX_IDW_TOOLBAR = 0xE800
+AFX_IDW_STATUS_BAR = 0xE801
+AFX_IDW_PREVIEW_BAR = 0xE802
+AFX_IDW_RESIZE_BAR = 0xE803
+AFX_IDW_DOCKBAR_TOP = 0xE81B
+AFX_IDW_DOCKBAR_LEFT = 0xE81C
+AFX_IDW_DOCKBAR_RIGHT = 0xE81D
+AFX_IDW_DOCKBAR_BOTTOM = 0xE81E
+AFX_IDW_DOCKBAR_FLOAT = 0xE81F
+
+
+def AFX_CONTROLBAR_MASK(nIDC):
+    return 1 << (nIDC - AFX_IDW_CONTROLBAR_FIRST)
+
+
+AFX_IDW_PANE_FIRST = 0xE900
+AFX_IDW_PANE_LAST = 0xE9FF
+AFX_IDW_HSCROLL_FIRST = 0xEA00
+AFX_IDW_VSCROLL_FIRST = 0xEA10
+AFX_IDW_SIZE_BOX = 0xEA20
+AFX_IDW_PANE_SAVE = 0xEA21
+AFX_IDS_APP_TITLE = 0xE000
+AFX_IDS_IDLEMESSAGE = 0xE001
+AFX_IDS_HELPMODEMESSAGE = 0xE002
+AFX_IDS_APP_TITLE_EMBEDDING = 0xE003
+AFX_IDS_COMPANY_NAME = 0xE004
+AFX_IDS_OBJ_TITLE_INPLACE = 0xE005
+ID_FILE_NEW = 0xE100
+ID_FILE_OPEN = 0xE101
+ID_FILE_CLOSE = 0xE102
+ID_FILE_SAVE = 0xE103
+ID_FILE_SAVE_AS = 0xE104
+ID_FILE_PAGE_SETUP = 0xE105
+ID_FILE_PRINT_SETUP = 0xE106
+ID_FILE_PRINT = 0xE107
+ID_FILE_PRINT_DIRECT = 0xE108
+ID_FILE_PRINT_PREVIEW = 0xE109
+ID_FILE_UPDATE = 0xE10A
+ID_FILE_SAVE_COPY_AS = 0xE10B
+ID_FILE_SEND_MAIL = 0xE10C
+ID_FILE_MRU_FIRST = 0xE110
+ID_FILE_MRU_FILE1 = 0xE110
+ID_FILE_MRU_FILE2 = 0xE111
+ID_FILE_MRU_FILE3 = 0xE112
+ID_FILE_MRU_FILE4 = 0xE113
+ID_FILE_MRU_FILE5 = 0xE114
+ID_FILE_MRU_FILE6 = 0xE115
+ID_FILE_MRU_FILE7 = 0xE116
+ID_FILE_MRU_FILE8 = 0xE117
+ID_FILE_MRU_FILE9 = 0xE118
+ID_FILE_MRU_FILE10 = 0xE119
+ID_FILE_MRU_FILE11 = 0xE11A
+ID_FILE_MRU_FILE12 = 0xE11B
+ID_FILE_MRU_FILE13 = 0xE11C
+ID_FILE_MRU_FILE14 = 0xE11D
+ID_FILE_MRU_FILE15 = 0xE11E
+ID_FILE_MRU_FILE16 = 0xE11F
+ID_FILE_MRU_LAST = 0xE11F
+ID_EDIT_CLEAR = 0xE120
+ID_EDIT_CLEAR_ALL = 0xE121
+ID_EDIT_COPY = 0xE122
+ID_EDIT_CUT = 0xE123
+ID_EDIT_FIND = 0xE124
+ID_EDIT_PASTE = 0xE125
+ID_EDIT_PASTE_LINK = 0xE126
+ID_EDIT_PASTE_SPECIAL = 0xE127
+ID_EDIT_REPEAT = 0xE128
+ID_EDIT_REPLACE = 0xE129
+ID_EDIT_SELECT_ALL = 0xE12A
+ID_EDIT_UNDO = 0xE12B
+ID_EDIT_REDO = 0xE12C
+ID_WINDOW_NEW = 0xE130
+ID_WINDOW_ARRANGE = 0xE131
+ID_WINDOW_CASCADE = 0xE132
+ID_WINDOW_TILE_HORZ = 0xE133
+ID_WINDOW_TILE_VERT = 0xE134
+ID_WINDOW_SPLIT = 0xE135
+AFX_IDM_WINDOW_FIRST = 0xE130
+AFX_IDM_WINDOW_LAST = 0xE13F
+AFX_IDM_FIRST_MDICHILD = 0xFF00
+ID_APP_ABOUT = 0xE140
+ID_APP_EXIT = 0xE141
+ID_HELP_INDEX = 0xE142
+ID_HELP_FINDER = 0xE143
+ID_HELP_USING = 0xE144
+ID_CONTEXT_HELP = 0xE145
+ID_HELP = 0xE146
+ID_DEFAULT_HELP = 0xE147
+ID_NEXT_PANE = 0xE150
+ID_PREV_PANE = 0xE151
+ID_FORMAT_FONT = 0xE160
+ID_OLE_INSERT_NEW = 0xE200
+ID_OLE_EDIT_LINKS = 0xE201
+ID_OLE_EDIT_CONVERT = 0xE202
+ID_OLE_EDIT_CHANGE_ICON = 0xE203
+ID_OLE_EDIT_PROPERTIES = 0xE204
+ID_OLE_VERB_FIRST = 0xE210
+ID_OLE_VERB_LAST = 0xE21F
+AFX_ID_PREVIEW_CLOSE = 0xE300
+AFX_ID_PREVIEW_NUMPAGE = 0xE301
+AFX_ID_PREVIEW_NEXT = 0xE302
+AFX_ID_PREVIEW_PREV = 0xE303
+AFX_ID_PREVIEW_PRINT = 0xE304
+AFX_ID_PREVIEW_ZOOMIN = 0xE305
+AFX_ID_PREVIEW_ZOOMOUT = 0xE306
+ID_VIEW_TOOLBAR = 0xE800
+ID_VIEW_STATUS_BAR = 0xE801
+ID_RECORD_FIRST = 0xE900
+ID_RECORD_LAST = 0xE901
+ID_RECORD_NEXT = 0xE902
+ID_RECORD_PREV = 0xE903
+IDC_STATIC = -1
+AFX_IDS_SCFIRST = 0xEF00
+AFX_IDS_SCSIZE = 0xEF00
+AFX_IDS_SCMOVE = 0xEF01
+AFX_IDS_SCMINIMIZE = 0xEF02
+AFX_IDS_SCMAXIMIZE = 0xEF03
+AFX_IDS_SCNEXTWINDOW = 0xEF04
+AFX_IDS_SCPREVWINDOW = 0xEF05
+AFX_IDS_SCCLOSE = 0xEF06
+AFX_IDS_SCRESTORE = 0xEF12
+AFX_IDS_SCTASKLIST = 0xEF13
+AFX_IDS_MDICHILD = 0xEF1F
+AFX_IDS_DESKACCESSORY = 0xEFDA
+AFX_IDS_OPENFILE = 0xF000
+AFX_IDS_SAVEFILE = 0xF001
+AFX_IDS_ALLFILTER = 0xF002
+AFX_IDS_UNTITLED = 0xF003
+AFX_IDS_SAVEFILECOPY = 0xF004
+AFX_IDS_PREVIEW_CLOSE = 0xF005
+AFX_IDS_UNNAMED_FILE = 0xF006
+AFX_IDS_ABOUT = 0xF010
+AFX_IDS_HIDE = 0xF011
+AFX_IDP_NO_ERROR_AVAILABLE = 0xF020
+AFX_IDS_NOT_SUPPORTED_EXCEPTION = 0xF021
+AFX_IDS_RESOURCE_EXCEPTION = 0xF022
+AFX_IDS_MEMORY_EXCEPTION = 0xF023
+AFX_IDS_USER_EXCEPTION = 0xF024
+AFX_IDS_PRINTONPORT = 0xF040
+AFX_IDS_ONEPAGE = 0xF041
+AFX_IDS_TWOPAGE = 0xF042
+AFX_IDS_PRINTPAGENUM = 0xF043
+AFX_IDS_PREVIEWPAGEDESC = 0xF044
+AFX_IDS_PRINTDEFAULTEXT = 0xF045
+AFX_IDS_PRINTDEFAULT = 0xF046
+AFX_IDS_PRINTFILTER = 0xF047
+AFX_IDS_PRINTCAPTION = 0xF048
+AFX_IDS_PRINTTOFILE = 0xF049
+AFX_IDS_OBJECT_MENUITEM = 0xF080
+AFX_IDS_EDIT_VERB = 0xF081
+AFX_IDS_ACTIVATE_VERB = 0xF082
+AFX_IDS_CHANGE_LINK = 0xF083
+AFX_IDS_AUTO = 0xF084
+AFX_IDS_MANUAL = 0xF085
+AFX_IDS_FROZEN = 0xF086
+AFX_IDS_ALL_FILES = 0xF087
+AFX_IDS_SAVE_MENU = 0xF088
+AFX_IDS_UPDATE_MENU = 0xF089
+AFX_IDS_SAVE_AS_MENU = 0xF08A
+AFX_IDS_SAVE_COPY_AS_MENU = 0xF08B
+AFX_IDS_EXIT_MENU = 0xF08C
+AFX_IDS_UPDATING_ITEMS = 0xF08D
+AFX_IDS_METAFILE_FORMAT = 0xF08E
+AFX_IDS_DIB_FORMAT = 0xF08F
+AFX_IDS_BITMAP_FORMAT = 0xF090
+AFX_IDS_LINKSOURCE_FORMAT = 0xF091
+AFX_IDS_EMBED_FORMAT = 0xF092
+AFX_IDS_PASTELINKEDTYPE = 0xF094
+AFX_IDS_UNKNOWNTYPE = 0xF095
+AFX_IDS_RTF_FORMAT = 0xF096
+AFX_IDS_TEXT_FORMAT = 0xF097
+AFX_IDS_INVALID_CURRENCY = 0xF098
+AFX_IDS_INVALID_DATETIME = 0xF099
+AFX_IDS_INVALID_DATETIMESPAN = 0xF09A
+AFX_IDP_INVALID_FILENAME = 0xF100
+AFX_IDP_FAILED_TO_OPEN_DOC = 0xF101
+AFX_IDP_FAILED_TO_SAVE_DOC = 0xF102
+AFX_IDP_ASK_TO_SAVE = 0xF103
+AFX_IDP_FAILED_TO_CREATE_DOC = 0xF104
+AFX_IDP_FILE_TOO_LARGE = 0xF105
+AFX_IDP_FAILED_TO_START_PRINT = 0xF106
+AFX_IDP_FAILED_TO_LAUNCH_HELP = 0xF107
+AFX_IDP_INTERNAL_FAILURE = 0xF108
+AFX_IDP_COMMAND_FAILURE = 0xF109
+AFX_IDP_FAILED_MEMORY_ALLOC = 0xF10A
+AFX_IDP_PARSE_INT = 0xF110
+AFX_IDP_PARSE_REAL = 0xF111
+AFX_IDP_PARSE_INT_RANGE = 0xF112
+AFX_IDP_PARSE_REAL_RANGE = 0xF113
+AFX_IDP_PARSE_STRING_SIZE = 0xF114
+AFX_IDP_PARSE_RADIO_BUTTON = 0xF115
+AFX_IDP_PARSE_BYTE = 0xF116
+AFX_IDP_PARSE_UINT = 0xF117
+AFX_IDP_PARSE_DATETIME = 0xF118
+AFX_IDP_PARSE_CURRENCY = 0xF119
+AFX_IDP_FAILED_INVALID_FORMAT = 0xF120
+AFX_IDP_FAILED_INVALID_PATH = 0xF121
+AFX_IDP_FAILED_DISK_FULL = 0xF122
+AFX_IDP_FAILED_ACCESS_READ = 0xF123
+AFX_IDP_FAILED_ACCESS_WRITE = 0xF124
+AFX_IDP_FAILED_IO_ERROR_READ = 0xF125
+AFX_IDP_FAILED_IO_ERROR_WRITE = 0xF126
+AFX_IDP_STATIC_OBJECT = 0xF180
+AFX_IDP_FAILED_TO_CONNECT = 0xF181
+AFX_IDP_SERVER_BUSY = 0xF182
+AFX_IDP_BAD_VERB = 0xF183
+AFX_IDP_FAILED_TO_NOTIFY = 0xF185
+AFX_IDP_FAILED_TO_LAUNCH = 0xF186
+AFX_IDP_ASK_TO_UPDATE = 0xF187
+AFX_IDP_FAILED_TO_UPDATE = 0xF188
+AFX_IDP_FAILED_TO_REGISTER = 0xF189
+AFX_IDP_FAILED_TO_AUTO_REGISTER = 0xF18A
+AFX_IDP_FAILED_TO_CONVERT = 0xF18B
+AFX_IDP_GET_NOT_SUPPORTED = 0xF18C
+AFX_IDP_SET_NOT_SUPPORTED = 0xF18D
+AFX_IDP_ASK_TO_DISCARD = 0xF18E
+AFX_IDP_FAILED_TO_CREATE = 0xF18F
+AFX_IDP_FAILED_MAPI_LOAD = 0xF190
+AFX_IDP_INVALID_MAPI_DLL = 0xF191
+AFX_IDP_FAILED_MAPI_SEND = 0xF192
+AFX_IDP_FILE_NONE = 0xF1A0
+AFX_IDP_FILE_GENERIC = 0xF1A1
+AFX_IDP_FILE_NOT_FOUND = 0xF1A2
+AFX_IDP_FILE_BAD_PATH = 0xF1A3
+AFX_IDP_FILE_TOO_MANY_OPEN = 0xF1A4
+AFX_IDP_FILE_ACCESS_DENIED = 0xF1A5
+AFX_IDP_FILE_INVALID_FILE = 0xF1A6
+AFX_IDP_FILE_REMOVE_CURRENT = 0xF1A7
+AFX_IDP_FILE_DIR_FULL = 0xF1A8
+AFX_IDP_FILE_BAD_SEEK = 0xF1A9
+AFX_IDP_FILE_HARD_IO = 0xF1AA
+AFX_IDP_FILE_SHARING = 0xF1AB
+AFX_IDP_FILE_LOCKING = 0xF1AC
+AFX_IDP_FILE_DISKFULL = 0xF1AD
+AFX_IDP_FILE_EOF = 0xF1AE
+AFX_IDP_ARCH_NONE = 0xF1B0
+AFX_IDP_ARCH_GENERIC = 0xF1B1
+AFX_IDP_ARCH_READONLY = 0xF1B2
+AFX_IDP_ARCH_ENDOFFILE = 0xF1B3
+AFX_IDP_ARCH_WRITEONLY = 0xF1B4
+AFX_IDP_ARCH_BADINDEX = 0xF1B5
+AFX_IDP_ARCH_BADCLASS = 0xF1B6
+AFX_IDP_ARCH_BADSCHEMA = 0xF1B7
+AFX_IDS_OCC_SCALEUNITS_PIXELS = 0xF1C0
+AFX_IDS_STATUS_FONT = 0xF230
+AFX_IDS_TOOLTIP_FONT = 0xF231
+AFX_IDS_UNICODE_FONT = 0xF232
+AFX_IDS_MINI_FONT = 0xF233
+AFX_IDP_SQL_FIRST = 0xF280
+AFX_IDP_SQL_CONNECT_FAIL = 0xF281
+AFX_IDP_SQL_RECORDSET_FORWARD_ONLY = 0xF282
+AFX_IDP_SQL_EMPTY_COLUMN_LIST = 0xF283
+AFX_IDP_SQL_FIELD_SCHEMA_MISMATCH = 0xF284
+AFX_IDP_SQL_ILLEGAL_MODE = 0xF285
+AFX_IDP_SQL_MULTIPLE_ROWS_AFFECTED = 0xF286
+AFX_IDP_SQL_NO_CURRENT_RECORD = 0xF287
+AFX_IDP_SQL_NO_ROWS_AFFECTED = 0xF288
+AFX_IDP_SQL_RECORDSET_READONLY = 0xF289
+AFX_IDP_SQL_SQL_NO_TOTAL = 0xF28A
+AFX_IDP_SQL_ODBC_LOAD_FAILED = 0xF28B
+AFX_IDP_SQL_DYNASET_NOT_SUPPORTED = 0xF28C
+AFX_IDP_SQL_SNAPSHOT_NOT_SUPPORTED = 0xF28D
+AFX_IDP_SQL_API_CONFORMANCE = 0xF28E
+AFX_IDP_SQL_SQL_CONFORMANCE = 0xF28F
+AFX_IDP_SQL_NO_DATA_FOUND = 0xF290
+AFX_IDP_SQL_ROW_UPDATE_NOT_SUPPORTED = 0xF291
+AFX_IDP_SQL_ODBC_V2_REQUIRED = 0xF292
+AFX_IDP_SQL_NO_POSITIONED_UPDATES = 0xF293
+AFX_IDP_SQL_LOCK_MODE_NOT_SUPPORTED = 0xF294
+AFX_IDP_SQL_DATA_TRUNCATED = 0xF295
+AFX_IDP_SQL_ROW_FETCH = 0xF296
+AFX_IDP_SQL_INCORRECT_ODBC = 0xF297
+AFX_IDP_SQL_UPDATE_DELETE_FAILED = 0xF298
+AFX_IDP_SQL_DYNAMIC_CURSOR_NOT_SUPPORTED = 0xF299
+AFX_IDP_DAO_FIRST = 0xF2A0
+AFX_IDP_DAO_ENGINE_INITIALIZATION = 0xF2A0
+AFX_IDP_DAO_DFX_BIND = 0xF2A1
+AFX_IDP_DAO_OBJECT_NOT_OPEN = 0xF2A2
+AFX_IDP_DAO_ROWTOOSHORT = 0xF2A3
+AFX_IDP_DAO_BADBINDINFO = 0xF2A4
+AFX_IDP_DAO_COLUMNUNAVAILABLE = 0xF2A5
+AFX_IDC_LISTBOX = 100
+AFX_IDC_CHANGE = 101
+AFX_IDC_PRINT_DOCNAME = 201
+AFX_IDC_PRINT_PRINTERNAME = 202
+AFX_IDC_PRINT_PORTNAME = 203
+AFX_IDC_PRINT_PAGENUM = 204
+ID_APPLY_NOW = 0x3021
+ID_WIZBACK = 0x3023
+ID_WIZNEXT = 0x3024
+ID_WIZFINISH = 0x3025
+AFX_IDC_TAB_CONTROL = 0x3020
+AFX_IDD_FILEOPEN = 28676
+AFX_IDD_FILESAVE = 28677
+AFX_IDD_FONT = 28678
+AFX_IDD_COLOR = 28679
+AFX_IDD_PRINT = 28680
+AFX_IDD_PRINTSETUP = 28681
+AFX_IDD_FIND = 28682
+AFX_IDD_REPLACE = 28683
+AFX_IDD_NEWTYPEDLG = 30721
+AFX_IDD_PRINTDLG = 30722
+AFX_IDD_PREVIEW_TOOLBAR = 30723
+AFX_IDD_PREVIEW_SHORTTOOLBAR = 30731
+AFX_IDD_INSERTOBJECT = 30724
+AFX_IDD_CHANGEICON = 30725
+AFX_IDD_CONVERT = 30726
+AFX_IDD_PASTESPECIAL = 30727
+AFX_IDD_EDITLINKS = 30728
+AFX_IDD_FILEBROWSE = 30729
+AFX_IDD_BUSY = 30730
+AFX_IDD_OBJECTPROPERTIES = 30732
+AFX_IDD_CHANGESOURCE = 30733
+AFX_IDC_CONTEXTHELP = 30977
+AFX_IDC_MAGNIFY = 30978
+AFX_IDC_SMALLARROWS = 30979
+AFX_IDC_HSPLITBAR = 30980
+AFX_IDC_VSPLITBAR = 30981
+AFX_IDC_NODROPCRSR = 30982
+AFX_IDC_TRACKNWSE = 30983
+AFX_IDC_TRACKNESW = 30984
+AFX_IDC_TRACKNS = 30985
+AFX_IDC_TRACKWE = 30986
+AFX_IDC_TRACK4WAY = 30987
+AFX_IDC_MOVE4WAY = 30988
+AFX_IDB_MINIFRAME_MENU = 30994
+AFX_IDB_CHECKLISTBOX_NT = 30995
+AFX_IDB_CHECKLISTBOX_95 = 30996
+AFX_IDR_PREVIEW_ACCEL = 30997
+AFX_IDI_STD_MDIFRAME = 31233
+AFX_IDI_STD_FRAME = 31234
+AFX_IDC_FONTPROP = 1000
+AFX_IDC_FONTNAMES = 1001
+AFX_IDC_FONTSTYLES = 1002
+AFX_IDC_FONTSIZES = 1003
+AFX_IDC_STRIKEOUT = 1004
+AFX_IDC_UNDERLINE = 1005
+AFX_IDC_SAMPLEBOX = 1006
+AFX_IDC_COLOR_BLACK = 1100
+AFX_IDC_COLOR_WHITE = 1101
+AFX_IDC_COLOR_RED = 1102
+AFX_IDC_COLOR_GREEN = 1103
+AFX_IDC_COLOR_BLUE = 1104
+AFX_IDC_COLOR_YELLOW = 1105
+AFX_IDC_COLOR_MAGENTA = 1106
+AFX_IDC_COLOR_CYAN = 1107
+AFX_IDC_COLOR_GRAY = 1108
+AFX_IDC_COLOR_LIGHTGRAY = 1109
+AFX_IDC_COLOR_DARKRED = 1110
+AFX_IDC_COLOR_DARKGREEN = 1111
+AFX_IDC_COLOR_DARKBLUE = 1112
+AFX_IDC_COLOR_LIGHTBROWN = 1113
+AFX_IDC_COLOR_DARKMAGENTA = 1114
+AFX_IDC_COLOR_DARKCYAN = 1115
+AFX_IDC_COLORPROP = 1116
+AFX_IDC_SYSTEMCOLORS = 1117
+AFX_IDC_PROPNAME = 1201
+AFX_IDC_PICTURE = 1202
+AFX_IDC_BROWSE = 1203
+AFX_IDC_CLEAR = 1204
+AFX_IDD_PROPPAGE_COLOR = 32257
+AFX_IDD_PROPPAGE_FONT = 32258
+AFX_IDD_PROPPAGE_PICTURE = 32259
+AFX_IDB_TRUETYPE = 32384
+AFX_IDS_PROPPAGE_UNKNOWN = 0xFE01
+AFX_IDS_COLOR_DESKTOP = 0xFE04
+AFX_IDS_COLOR_APPWORKSPACE = 0xFE05
+AFX_IDS_COLOR_WNDBACKGND = 0xFE06
+AFX_IDS_COLOR_WNDTEXT = 0xFE07
+AFX_IDS_COLOR_MENUBAR = 0xFE08
+AFX_IDS_COLOR_MENUTEXT = 0xFE09
+AFX_IDS_COLOR_ACTIVEBAR = 0xFE0A
+AFX_IDS_COLOR_INACTIVEBAR = 0xFE0B
+AFX_IDS_COLOR_ACTIVETEXT = 0xFE0C
+AFX_IDS_COLOR_INACTIVETEXT = 0xFE0D
+AFX_IDS_COLOR_ACTIVEBORDER = 0xFE0E
+AFX_IDS_COLOR_INACTIVEBORDER = 0xFE0F
+AFX_IDS_COLOR_WNDFRAME = 0xFE10
+AFX_IDS_COLOR_SCROLLBARS = 0xFE11
+AFX_IDS_COLOR_BTNFACE = 0xFE12
+AFX_IDS_COLOR_BTNSHADOW = 0xFE13
+AFX_IDS_COLOR_BTNTEXT = 0xFE14
+AFX_IDS_COLOR_BTNHIGHLIGHT = 0xFE15
+AFX_IDS_COLOR_DISABLEDTEXT = 0xFE16
+AFX_IDS_COLOR_HIGHLIGHT = 0xFE17
+AFX_IDS_COLOR_HIGHLIGHTTEXT = 0xFE18
+AFX_IDS_REGULAR = 0xFE19
+AFX_IDS_BOLD = 0xFE1A
+AFX_IDS_ITALIC = 0xFE1B
+AFX_IDS_BOLDITALIC = 0xFE1C
+AFX_IDS_SAMPLETEXT = 0xFE1D
+AFX_IDS_DISPLAYSTRING_FONT = 0xFE1E
+AFX_IDS_DISPLAYSTRING_COLOR = 0xFE1F
+AFX_IDS_DISPLAYSTRING_PICTURE = 0xFE20
+AFX_IDS_PICTUREFILTER = 0xFE21
+AFX_IDS_PICTYPE_UNKNOWN = 0xFE22
+AFX_IDS_PICTYPE_NONE = 0xFE23
+AFX_IDS_PICTYPE_BITMAP = 0xFE24
+AFX_IDS_PICTYPE_METAFILE = 0xFE25
+AFX_IDS_PICTYPE_ICON = 0xFE26
+AFX_IDS_COLOR_PPG = 0xFE28
+AFX_IDS_COLOR_PPG_CAPTION = 0xFE29
+AFX_IDS_FONT_PPG = 0xFE2A
+AFX_IDS_FONT_PPG_CAPTION = 0xFE2B
+AFX_IDS_PICTURE_PPG = 0xFE2C
+AFX_IDS_PICTURE_PPG_CAPTION = 0xFE2D
+AFX_IDS_PICTUREBROWSETITLE = 0xFE30
+AFX_IDS_BORDERSTYLE_0 = 0xFE31
+AFX_IDS_BORDERSTYLE_1 = 0xFE32
+AFX_IDS_VERB_EDIT = 0xFE40
+AFX_IDS_VERB_PROPERTIES = 0xFE41
+AFX_IDP_PICTURECANTOPEN = 0xFE83
+AFX_IDP_PICTURECANTLOAD = 0xFE84
+AFX_IDP_PICTURETOOLARGE = 0xFE85
+AFX_IDP_PICTUREREADFAILED = 0xFE86
+AFX_IDP_E_ILLEGALFUNCTIONCALL = 0xFEA0
+AFX_IDP_E_OVERFLOW = 0xFEA1
+AFX_IDP_E_OUTOFMEMORY = 0xFEA2
+AFX_IDP_E_DIVISIONBYZERO = 0xFEA3
+AFX_IDP_E_OUTOFSTRINGSPACE = 0xFEA4
+AFX_IDP_E_OUTOFSTACKSPACE = 0xFEA5
+AFX_IDP_E_BADFILENAMEORNUMBER = 0xFEA6
+AFX_IDP_E_FILENOTFOUND = 0xFEA7
+AFX_IDP_E_BADFILEMODE = 0xFEA8
+AFX_IDP_E_FILEALREADYOPEN = 0xFEA9
+AFX_IDP_E_DEVICEIOERROR = 0xFEAA
+AFX_IDP_E_FILEALREADYEXISTS = 0xFEAB
+AFX_IDP_E_BADRECORDLENGTH = 0xFEAC
+AFX_IDP_E_DISKFULL = 0xFEAD
+AFX_IDP_E_BADRECORDNUMBER = 0xFEAE
+AFX_IDP_E_BADFILENAME = 0xFEAF
+AFX_IDP_E_TOOMANYFILES = 0xFEB0
+AFX_IDP_E_DEVICEUNAVAILABLE = 0xFEB1
+AFX_IDP_E_PERMISSIONDENIED = 0xFEB2
+AFX_IDP_E_DISKNOTREADY = 0xFEB3
+AFX_IDP_E_PATHFILEACCESSERROR = 0xFEB4
+AFX_IDP_E_PATHNOTFOUND = 0xFEB5
+AFX_IDP_E_INVALIDPATTERNSTRING = 0xFEB6
+AFX_IDP_E_INVALIDUSEOFNULL = 0xFEB7
+AFX_IDP_E_INVALIDFILEFORMAT = 0xFEB8
+AFX_IDP_E_INVALIDPROPERTYVALUE = 0xFEB9
+AFX_IDP_E_INVALIDPROPERTYARRAYINDEX = 0xFEBA
+AFX_IDP_E_SETNOTSUPPORTEDATRUNTIME = 0xFEBB
+AFX_IDP_E_SETNOTSUPPORTED = 0xFEBC
+AFX_IDP_E_NEEDPROPERTYARRAYINDEX = 0xFEBD
+AFX_IDP_E_SETNOTPERMITTED = 0xFEBE
+AFX_IDP_E_GETNOTSUPPORTEDATRUNTIME = 0xFEBF
+AFX_IDP_E_GETNOTSUPPORTED = 0xFEC0
+AFX_IDP_E_PROPERTYNOTFOUND = 0xFEC1
+AFX_IDP_E_INVALIDCLIPBOARDFORMAT = 0xFEC2
+AFX_IDP_E_INVALIDPICTURE = 0xFEC3
+AFX_IDP_E_PRINTERERROR = 0xFEC4
+AFX_IDP_E_CANTSAVEFILETOTEMP = 0xFEC5
+AFX_IDP_E_SEARCHTEXTNOTFOUND = 0xFEC6
+AFX_IDP_E_REPLACEMENTSTOOLONG = 0xFEC7
diff --git a/lib/pythonwin/pywin/mfc/dialog.py b/lib/pythonwin/pywin/mfc/dialog.py
new file mode 100644
index 00000000..25fe1363
--- /dev/null
+++ b/lib/pythonwin/pywin/mfc/dialog.py
@@ -0,0 +1,278 @@
+""" \
+Base class for Dialogs.  Also contains a few useful utility functions
+"""
+# dialog.py
+# Python class for Dialog Boxes in PythonWin.
+
+import win32con
+import win32ui
+
+# sob - 2to3 doesn't see this as a relative import :(
+from pywin.mfc import window
+
+
+def dllFromDll(dllid):
+    "given a 'dll' (maybe a dll, filename, etc), return a DLL object"
+    if dllid == None:
+        return None
+    elif type("") == type(dllid):
+        return win32ui.LoadLibrary(dllid)
+    else:
+        try:
+            dllid.GetFileName()
+        except AttributeError:
+            raise TypeError("DLL parameter must be None, a filename or a dll object")
+        return dllid
+
+
+class Dialog(window.Wnd):
+    "Base class for a dialog"
+
+    def __init__(self, id, dllid=None):
+        """id is the resource ID, or a template
+        dllid may be None, a dll object, or a string with a dll name"""
+        # must take a reference to the DLL until InitDialog.
+        self.dll = dllFromDll(dllid)
+        if type(id) == type([]):  # a template
+            dlg = win32ui.CreateDialogIndirect(id)
+        else:
+            dlg = win32ui.CreateDialog(id, self.dll)
+        window.Wnd.__init__(self, dlg)
+        self.HookCommands()
+        self.bHaveInit = None
+
+    def HookCommands(self):
+        pass
+
+    def OnAttachedObjectDeath(self):
+        self.data = self._obj_.data
+        window.Wnd.OnAttachedObjectDeath(self)
+
+    # provide virtuals.
+    def OnOK(self):
+        self._obj_.OnOK()
+
+    def OnCancel(self):
+        self._obj_.OnCancel()
+
+    def OnInitDialog(self):
+        self.bHaveInit = 1
+        if self._obj_.data:
+            self._obj_.UpdateData(0)
+        return 1  # I did NOT set focus to a child window.
+
+    def OnDestroy(self, msg):
+        self.dll = None  # theoretically not needed if object destructs normally.
+
+    # DDX support
+    def AddDDX(self, *args):
+        self._obj_.datalist.append(args)
+
+    # Make a dialog object look like a dictionary for the DDX support
+    def __bool__(self):
+        return True
+
+    def __len__(self):
+        return len(self.data)
+
+    def __getitem__(self, key):
+        return self.data[key]
+
+    def __setitem__(self, key, item):
+        self._obj_.data[key] = item  # self.UpdateData(0)
+
+    def keys(self):
+        return list(self.data.keys())
+
+    def items(self):
+        return list(self.data.items())
+
+    def values(self):
+        return list(self.data.values())
+
+    # XXX - needs py3k work!
+    def has_key(self, key):
+        return key in self.data
+
+
+class PrintDialog(Dialog):
+    "Base class for a print dialog"
+
+    def __init__(
+        self,
+        pInfo,
+        dlgID,
+        printSetupOnly=0,
+        flags=(
+            win32ui.PD_ALLPAGES
+            | win32ui.PD_USEDEVMODECOPIES
+            | win32ui.PD_NOPAGENUMS
+            | win32ui.PD_HIDEPRINTTOFILE
+            | win32ui.PD_NOSELECTION
+        ),
+        parent=None,
+        dllid=None,
+    ):
+        self.dll = dllFromDll(dllid)
+        if type(dlgID) == type([]):  # a template
+            raise TypeError("dlgID parameter must be an integer resource ID")
+        dlg = win32ui.CreatePrintDialog(dlgID, printSetupOnly, flags, parent, self.dll)
+        window.Wnd.__init__(self, dlg)
+        self.HookCommands()
+        self.bHaveInit = None
+        self.pInfo = pInfo
+        # init values (if PrintSetup is called, values still available)
+        flags = pInfo.GetFlags()
+        self["toFile"] = flags & win32ui.PD_PRINTTOFILE != 0
+        self["direct"] = pInfo.GetDirect()
+        self["preview"] = pInfo.GetPreview()
+        self["continuePrinting"] = pInfo.GetContinuePrinting()
+        self["curPage"] = pInfo.GetCurPage()
+        self["numPreviewPages"] = pInfo.GetNumPreviewPages()
+        self["userData"] = pInfo.GetUserData()
+        self["draw"] = pInfo.GetDraw()
+        self["pageDesc"] = pInfo.GetPageDesc()
+        self["minPage"] = pInfo.GetMinPage()
+        self["maxPage"] = pInfo.GetMaxPage()
+        self["offsetPage"] = pInfo.GetOffsetPage()
+        self["fromPage"] = pInfo.GetFromPage()
+        self["toPage"] = pInfo.GetToPage()
+        # these values updated after OnOK
+        self["copies"] = 0
+        self["deviceName"] = ""
+        self["driverName"] = ""
+        self["printAll"] = 0
+        self["printCollate"] = 0
+        self["printRange"] = 0
+        self["printSelection"] = 0
+
+    def OnInitDialog(self):
+        self.pInfo.CreatePrinterDC()  # This also sets the hDC of the pInfo structure.
+        return self._obj_.OnInitDialog()
+
+    def OnCancel(self):
+        del self.pInfo
+
+    def OnOK(self):
+        """DoModal has finished. Can now access the users choices"""
+        self._obj_.OnOK()
+        pInfo = self.pInfo
+        # user values
+        flags = pInfo.GetFlags()
+        self["toFile"] = flags & win32ui.PD_PRINTTOFILE != 0
+        self["direct"] = pInfo.GetDirect()
+        self["preview"] = pInfo.GetPreview()
+        self["continuePrinting"] = pInfo.GetContinuePrinting()
+        self["curPage"] = pInfo.GetCurPage()
+        self["numPreviewPages"] = pInfo.GetNumPreviewPages()
+        self["userData"] = pInfo.GetUserData()
+        self["draw"] = pInfo.GetDraw()
+        self["pageDesc"] = pInfo.GetPageDesc()
+        self["minPage"] = pInfo.GetMinPage()
+        self["maxPage"] = pInfo.GetMaxPage()
+        self["offsetPage"] = pInfo.GetOffsetPage()
+        self["fromPage"] = pInfo.GetFromPage()
+        self["toPage"] = pInfo.GetToPage()
+        self["copies"] = pInfo.GetCopies()
+        self["deviceName"] = pInfo.GetDeviceName()
+        self["driverName"] = pInfo.GetDriverName()
+        self["printAll"] = pInfo.PrintAll()
+        self["printCollate"] = pInfo.PrintCollate()
+        self["printRange"] = pInfo.PrintRange()
+        self["printSelection"] = pInfo.PrintSelection()
+        del self.pInfo
+
+
+class PropertyPage(Dialog):
+    "Base class for a Property Page"
+
+    def __init__(self, id, dllid=None, caption=0):
+        """id is the resource ID
+        dllid may be None, a dll object, or a string with a dll name"""
+
+        self.dll = dllFromDll(dllid)
+        if self.dll:
+            oldRes = win32ui.SetResource(self.dll)
+        if type(id) == type([]):
+            dlg = win32ui.CreatePropertyPageIndirect(id)
+        else:
+            dlg = win32ui.CreatePropertyPage(id, caption)
+        if self.dll:
+            win32ui.SetResource(oldRes)
+        # dont call dialog init!
+        window.Wnd.__init__(self, dlg)
+        self.HookCommands()
+
+
+class PropertySheet(window.Wnd):
+    def __init__(self, caption, dll=None, pageList=None):  # parent=None, style,etc):
+        "Initialize a property sheet.  pageList is a list of ID's"
+        # must take a reference to the DLL until InitDialog.
+        self.dll = dllFromDll(dll)
+        self.sheet = win32ui.CreatePropertySheet(caption)
+        window.Wnd.__init__(self, self.sheet)
+        if not pageList is None:
+            self.AddPage(pageList)
+
+    def OnInitDialog(self):
+        return self._obj_.OnInitDialog()
+
+    def DoModal(self):
+        if self.dll:
+            oldRes = win32ui.SetResource(self.dll)
+        rc = self.sheet.DoModal()
+        if self.dll:
+            win32ui.SetResource(oldRes)
+        return rc
+
+    def AddPage(self, pages):
+        if self.dll:
+            oldRes = win32ui.SetResource(self.dll)
+        try:  # try list style access
+            pages[0]
+            isSeq = 1
+        except (TypeError, KeyError):
+            isSeq = 0
+        if isSeq:
+            for page in pages:
+                self.DoAddSinglePage(page)
+        else:
+            self.DoAddSinglePage(pages)
+        if self.dll:
+            win32ui.SetResource(oldRes)
+
+    def DoAddSinglePage(self, page):
+        "Page may be page, or int ID. Assumes DLL setup"
+        if type(page) == type(0):
+            self.sheet.AddPage(win32ui.CreatePropertyPage(page))
+        else:
+            self.sheet.AddPage(page)
+
+
+# define some app utility functions.
+def GetSimpleInput(prompt, defValue="", title=None):
+    """displays a dialog, and returns a string, or None if cancelled.
+    args prompt, defValue='', title=main frames title"""
+    # uses a simple dialog to return a string object.
+    if title is None:
+        title = win32ui.GetMainFrame().GetWindowText()
+    # 2to3 insists on converting 'Dialog.__init__' to 'tkinter.dialog...'
+    DlgBaseClass = Dialog
+
+    class DlgSimpleInput(DlgBaseClass):
+        def __init__(self, prompt, defValue, title):
+            self.title = title
+            DlgBaseClass.__init__(self, win32ui.IDD_SIMPLE_INPUT)
+            self.AddDDX(win32ui.IDC_EDIT1, "result")
+            self.AddDDX(win32ui.IDC_PROMPT1, "prompt")
+            self._obj_.data["result"] = defValue
+            self._obj_.data["prompt"] = prompt
+
+        def OnInitDialog(self):
+            self.SetWindowText(self.title)
+            return DlgBaseClass.OnInitDialog(self)
+
+    dlg = DlgSimpleInput(prompt, defValue, title)
+    if dlg.DoModal() != win32con.IDOK:
+        return None
+    return dlg["result"]
diff --git a/lib/pythonwin/pywin/mfc/docview.py b/lib/pythonwin/pywin/mfc/docview.py
new file mode 100644
index 00000000..7da91b46
--- /dev/null
+++ b/lib/pythonwin/pywin/mfc/docview.py
@@ -0,0 +1,151 @@
+# document and view classes for MFC.
+import win32ui
+
+from . import object, window
+
+
+class View(window.Wnd):
+    def __init__(self, initobj):
+        window.Wnd.__init__(self, initobj)
+
+    def OnInitialUpdate(self):
+        pass
+
+
+# Simple control based views.
+class CtrlView(View):
+    def __init__(self, doc, wndclass, style=0):
+        View.__init__(self, win32ui.CreateCtrlView(doc, wndclass, style))
+
+
+class EditView(CtrlView):
+    def __init__(self, doc):
+        View.__init__(self, win32ui.CreateEditView(doc))
+
+
+class RichEditView(CtrlView):
+    def __init__(self, doc):
+        View.__init__(self, win32ui.CreateRichEditView(doc))
+
+
+class ListView(CtrlView):
+    def __init__(self, doc):
+        View.__init__(self, win32ui.CreateListView(doc))
+
+
+class TreeView(CtrlView):
+    def __init__(self, doc):
+        View.__init__(self, win32ui.CreateTreeView(doc))
+
+
+# Other more advanced views.
+class ScrollView(View):
+    def __init__(self, doc):
+        View.__init__(self, win32ui.CreateView(doc))
+
+
+class FormView(View):
+    def __init__(self, doc, id):
+        View.__init__(self, win32ui.CreateFormView(doc, id))
+
+
+class Document(object.CmdTarget):
+    def __init__(self, template, docobj=None):
+        if docobj is None:
+            docobj = template.DoCreateDoc()
+        object.CmdTarget.__init__(self, docobj)
+
+
+class RichEditDoc(object.CmdTarget):
+    def __init__(self, template):
+        object.CmdTarget.__init__(self, template.DoCreateRichEditDoc())
+
+
+class CreateContext:
+    "A transient base class used as a CreateContext"
+
+    def __init__(self, template, doc=None):
+        self.template = template
+        self.doc = doc
+
+    def __del__(self):
+        self.close()
+
+    def close(self):
+        self.doc = None
+        self.template = None
+
+
+class DocTemplate(object.CmdTarget):
+    def __init__(
+        self, resourceId=None, MakeDocument=None, MakeFrame=None, MakeView=None
+    ):
+        if resourceId is None:
+            resourceId = win32ui.IDR_PYTHONTYPE
+        object.CmdTarget.__init__(self, self._CreateDocTemplate(resourceId))
+        self.MakeDocument = MakeDocument
+        self.MakeFrame = MakeFrame
+        self.MakeView = MakeView
+        self._SetupSharedMenu_()
+
+    def _SetupSharedMenu_(self):
+        pass  # to be overridden by each "app"
+
+    def _CreateDocTemplate(self, resourceId):
+        return win32ui.CreateDocTemplate(resourceId)
+
+    def __del__(self):
+        object.CmdTarget.__del__(self)
+
+    def CreateCreateContext(self, doc=None):
+        return CreateContext(self, doc)
+
+    def CreateNewFrame(self, doc):
+        makeFrame = self.MakeFrame
+        if makeFrame is None:
+            makeFrame = window.MDIChildWnd
+        wnd = makeFrame()
+        context = self.CreateCreateContext(doc)
+        wnd.LoadFrame(
+            self.GetResourceID(), -1, None, context
+        )  # triggers OnCreateClient...
+        return wnd
+
+    def CreateNewDocument(self):
+        makeDocument = self.MakeDocument
+        if makeDocument is None:
+            makeDocument = Document
+        return makeDocument(self)
+
+    def CreateView(self, frame, context):
+        makeView = self.MakeView
+        if makeView is None:
+            makeView = EditView
+        view = makeView(context.doc)
+        view.CreateWindow(frame)
+
+
+class RichEditDocTemplate(DocTemplate):
+    def __init__(
+        self, resourceId=None, MakeDocument=None, MakeFrame=None, MakeView=None
+    ):
+        if MakeView is None:
+            MakeView = RichEditView
+        if MakeDocument is None:
+            MakeDocument = RichEditDoc
+        DocTemplate.__init__(self, resourceId, MakeDocument, MakeFrame, MakeView)
+
+    def _CreateDocTemplate(self, resourceId):
+        return win32ui.CreateRichEditDocTemplate(resourceId)
+
+
+def t():
+    class FormTemplate(DocTemplate):
+        def CreateView(self, frame, context):
+            makeView = self.MakeView
+            # 			view = FormView(context.doc, win32ui.IDD_PROPDEMO1)
+            view = ListView(context.doc)
+            view.CreateWindow(frame)
+
+    t = FormTemplate()
+    return t.OpenDocumentFile(None)
diff --git a/lib/pythonwin/pywin/mfc/object.py b/lib/pythonwin/pywin/mfc/object.py
new file mode 100644
index 00000000..70138b6e
--- /dev/null
+++ b/lib/pythonwin/pywin/mfc/object.py
@@ -0,0 +1,66 @@
+# MFC base classes.
+
+import win32ui
+
+
+class Object:
+    def __init__(self, initObj=None):
+        self.__dict__["_obj_"] = initObj
+        # 		self._obj_ = initObj
+        if initObj is not None:
+            initObj.AttachObject(self)
+
+    def __del__(self):
+        self.close()
+
+    def __getattr__(
+        self, attr
+    ):  # Make this object look like the underlying win32ui one.
+        # During cleanup __dict__ is not available, causing recursive death.
+        if not attr.startswith("__"):
+            try:
+                o = self.__dict__["_obj_"]
+                if o is not None:
+                    return getattr(o, attr)
+                # Only raise this error for non "internal" names -
+                # Python may be calling __len__, __nonzero__, etc, so
+                # we dont want this exception
+                if attr[0] != "_" and attr[-1] != "_":
+                    raise win32ui.error("The MFC object has died.")
+            except KeyError:
+                # No _obj_ at all - dont report MFC object died when there isnt one!
+                pass
+        raise AttributeError(attr)
+
+    def OnAttachedObjectDeath(self):
+        # 		print "object", self.__class__.__name__, "dieing"
+        self._obj_ = None
+
+    def close(self):
+        if "_obj_" in self.__dict__:
+            if self._obj_ is not None:
+                self._obj_.AttachObject(None)
+                self._obj_ = None
+
+
+class CmdTarget(Object):
+    def __init__(self, initObj):
+        Object.__init__(self, initObj)
+
+    def HookNotifyRange(self, handler, firstID, lastID):
+        oldhandlers = []
+        for i in range(firstID, lastID + 1):
+            oldhandlers.append(self.HookNotify(handler, i))
+        return oldhandlers
+
+    def HookCommandRange(self, handler, firstID, lastID):
+        oldhandlers = []
+        for i in range(firstID, lastID + 1):
+            oldhandlers.append(self.HookCommand(handler, i))
+        return oldhandlers
+
+    def HookCommandUpdateRange(self, handler, firstID, lastID):
+        oldhandlers = []
+        for i in range(firstID, lastID + 1):
+            oldhandlers.append(self.HookCommandUpdate(handler, i))
+        return oldhandlers
diff --git a/lib/pythonwin/pywin/mfc/thread.py b/lib/pythonwin/pywin/mfc/thread.py
new file mode 100644
index 00000000..90a0a762
--- /dev/null
+++ b/lib/pythonwin/pywin/mfc/thread.py
@@ -0,0 +1,25 @@
+# Thread and application objects
+
+import win32ui
+
+from . import object
+
+
+class WinThread(object.CmdTarget):
+    def __init__(self, initObj=None):
+        if initObj is None:
+            initObj = win32ui.CreateThread()
+        object.CmdTarget.__init__(self, initObj)
+
+    def InitInstance(self):
+        pass  # Default None/0 return indicates success for InitInstance()
+
+    def ExitInstance(self):
+        pass
+
+
+class WinApp(WinThread):
+    def __init__(self, initApp=None):
+        if initApp is None:
+            initApp = win32ui.GetApp()
+        WinThread.__init__(self, initApp)
diff --git a/lib/pythonwin/pywin/mfc/window.py b/lib/pythonwin/pywin/mfc/window.py
new file mode 100644
index 00000000..e52a7c1c
--- /dev/null
+++ b/lib/pythonwin/pywin/mfc/window.py
@@ -0,0 +1,50 @@
+# The MFCish window classes.
+import win32con
+import win32ui
+
+from . import object
+
+
+class Wnd(object.CmdTarget):
+    def __init__(self, initobj=None):
+        object.CmdTarget.__init__(self, initobj)
+        if self._obj_:
+            self._obj_.HookMessage(self.OnDestroy, win32con.WM_DESTROY)
+
+    def OnDestroy(self, msg):
+        pass
+
+
+# NOTE NOTE - This facility is currently disabled in Pythonwin!!!!!
+# Note - to process all messages for your window, add the following method
+# to a derived class.  This code provides default message handling (ie, is
+# identical, except presumably in speed, as if the method did not exist at
+# all, so presumably will be modified to test for specific messages to be
+# useful!
+# 	def WindowProc(self, msg, wParam, lParam):
+# 		rc, lResult = self._obj_.OnWndMsg(msg, wParam, lParam)
+# 		if not rc: lResult = self._obj_.DefWindowProc(msg, wParam, lParam)
+# 		return lResult
+
+
+class FrameWnd(Wnd):
+    def __init__(self, wnd):
+        Wnd.__init__(self, wnd)
+
+
+class MDIChildWnd(FrameWnd):
+    def __init__(self, wnd=None):
+        if wnd is None:
+            wnd = win32ui.CreateMDIChild()
+        FrameWnd.__init__(self, wnd)
+
+    def OnCreateClient(self, cp, context):
+        if context is not None and context.template is not None:
+            context.template.CreateView(self, context)
+
+
+class MDIFrameWnd(FrameWnd):
+    def __init__(self, wnd=None):
+        if wnd is None:
+            wnd = win32ui.CreateMDIFrame()
+        FrameWnd.__init__(self, wnd)
diff --git a/lib/pythonwin/pywin/scintilla/IDLEenvironment.py b/lib/pythonwin/pywin/scintilla/IDLEenvironment.py
new file mode 100644
index 00000000..b1db5093
--- /dev/null
+++ b/lib/pythonwin/pywin/scintilla/IDLEenvironment.py
@@ -0,0 +1,598 @@
+# Code that allows Pythonwin to pretend it is IDLE
+# (at least as far as most IDLE extensions are concerned)
+
+import string
+import sys
+
+import win32api
+import win32con
+import win32ui
+from pywin import default_scintilla_encoding
+from pywin.mfc.dialog import GetSimpleInput
+
+wordchars = string.ascii_uppercase + string.ascii_lowercase + string.digits
+
+
+class TextError(Exception):  # When a TclError would normally be raised.
+    pass
+
+
+class EmptyRange(Exception):  # Internally raised.
+    pass
+
+
+def GetIDLEModule(module):
+    try:
+        # First get it from Pythonwin it is exists.
+        modname = "pywin.idle." + module
+        __import__(modname)
+    except ImportError as details:
+        msg = (
+            "The IDLE extension '%s' can not be located.\r\n\r\n"
+            "Please correct the installation and restart the"
+            " application.\r\n\r\n%s" % (module, details)
+        )
+        win32ui.MessageBox(msg)
+        return None
+    mod = sys.modules[modname]
+    mod.TclError = TextError  # A hack that can go soon!
+    return mod
+
+
+# A class that is injected into the IDLE auto-indent extension.
+# It allows for decent performance when opening a new file,
+# as auto-indent uses the tokenizer module to determine indents.
+# The default AutoIndent readline method works OK, but it goes through
+# this layer of Tk index indirection for every single line.  For large files
+# without indents (and even small files with indents :-) it was pretty slow!
+def fast_readline(self):
+    if self.finished:
+        val = ""
+    else:
+        if "_scint_lines" not in self.__dict__:
+            # XXX - note - assumes this is only called once the file is loaded!
+            self._scint_lines = self.text.edit.GetTextRange().split("\n")
+        sl = self._scint_lines
+        i = self.i = self.i + 1
+        if i >= len(sl):
+            val = ""
+        else:
+            val = sl[i] + "\n"
+    return val.encode(default_scintilla_encoding)
+
+
+try:
+    GetIDLEModule("AutoIndent").IndentSearcher.readline = fast_readline
+except AttributeError:  # GetIDLEModule may return None
+    pass
+
+
+# A class that attempts to emulate an IDLE editor window.
+# Construct with a Pythonwin view.
+class IDLEEditorWindow:
+    def __init__(self, edit):
+        self.edit = edit
+        self.text = TkText(edit)
+        self.extensions = {}
+        self.extension_menus = {}
+
+    def close(self):
+        self.edit = self.text = None
+        self.extension_menus = None
+        try:
+            for ext in self.extensions.values():
+                closer = getattr(ext, "close", None)
+                if closer is not None:
+                    closer()
+        finally:
+            self.extensions = {}
+
+    def IDLEExtension(self, extension):
+        ext = self.extensions.get(extension)
+        if ext is not None:
+            return ext
+        mod = GetIDLEModule(extension)
+        if mod is None:
+            return None
+        klass = getattr(mod, extension)
+        ext = self.extensions[extension] = klass(self)
+        # Find and bind all the events defined in the extension.
+        events = [item for item in dir(klass) if item[-6:] == "_event"]
+        for event in events:
+            name = "<<%s>>" % (event[:-6].replace("_", "-"),)
+            self.edit.bindings.bind(name, getattr(ext, event))
+        return ext
+
+    def GetMenuItems(self, menu_name):
+        # Get all menu items for the menu name (eg, "edit")
+        bindings = self.edit.bindings
+        ret = []
+        for ext in self.extensions.values():
+            menudefs = getattr(ext, "menudefs", [])
+            for name, items in menudefs:
+                if name == menu_name:
+                    for text, event in [item for item in items if item is not None]:
+                        text = text.replace("&", "&&")
+                        text = text.replace("_", "&")
+                        ret.append((text, event))
+        return ret
+
+    ######################################################################
+    # The IDLE "Virtual UI" methods that are exposed to the IDLE extensions.
+    #
+    def askinteger(
+        self, caption, prompt, parent=None, initialvalue=0, minvalue=None, maxvalue=None
+    ):
+        while 1:
+            rc = GetSimpleInput(prompt, str(initialvalue), caption)
+            if rc is None:
+                return 0  # Correct "cancel" semantics?
+            err = None
+            try:
+                rc = int(rc)
+            except ValueError:
+                err = "Please enter an integer"
+            if not err and minvalue is not None and rc < minvalue:
+                err = "Please enter an integer greater then or equal to %s" % (
+                    minvalue,
+                )
+            if not err and maxvalue is not None and rc > maxvalue:
+                err = "Please enter an integer less then or equal to %s" % (maxvalue,)
+            if err:
+                win32ui.MessageBox(err, caption, win32con.MB_OK)
+                continue
+            return rc
+
+    def askyesno(self, caption, prompt, parent=None):
+        return win32ui.MessageBox(prompt, caption, win32con.MB_YESNO) == win32con.IDYES
+
+    ######################################################################
+    # The IDLE "Virtual Text Widget" methods that are exposed to the IDLE extensions.
+    #
+
+    # Is character at text_index in a Python string?  Return 0 for
+    # "guaranteed no", true for anything else.
+    def is_char_in_string(self, text_index):
+        # A helper for the code analyser - we need internal knowledge of
+        # the colorizer to get this information
+        # This assumes the colorizer has got to this point!
+        text_index = self.text._getoffset(text_index)
+        c = self.text.edit._GetColorizer()
+        if c and c.GetStringStyle(text_index) is None:
+            return 0
+        return 1
+
+    # If a selection is defined in the text widget, return
+    # (start, end) as Tkinter text indices, otherwise return
+    # (None, None)
+    def get_selection_indices(self):
+        try:
+            first = self.text.index("sel.first")
+            last = self.text.index("sel.last")
+            return first, last
+        except TextError:
+            return None, None
+
+    def set_tabwidth(self, width):
+        self.edit.SCISetTabWidth(width)
+
+    def get_tabwidth(self):
+        return self.edit.GetTabWidth()
+
+
+# A class providing the generic "Call Tips" interface
+class CallTips:
+    def __init__(self, edit):
+        self.edit = edit
+
+    def showtip(self, tip_text):
+        self.edit.SCICallTipShow(tip_text)
+
+    def hidetip(self):
+        self.edit.SCICallTipCancel()
+
+
+########################################
+#
+# Helpers for the TkText emulation.
+def TkOffsetToIndex(offset, edit):
+    lineoff = 0
+    # May be 1 > actual end if we pretended there was a trailing '\n'
+    offset = min(offset, edit.GetTextLength())
+    line = edit.LineFromChar(offset)
+    lineIndex = edit.LineIndex(line)
+    return "%d.%d" % (line + 1, offset - lineIndex)
+
+
+def _NextTok(str, pos):
+    # Returns (token, endPos)
+    end = len(str)
+    if pos >= end:
+        return None, 0
+    while pos < end and str[pos] in string.whitespace:
+        pos = pos + 1
+    # Special case for +-
+    if str[pos] in "+-":
+        return str[pos], pos + 1
+    # Digits also a special case.
+    endPos = pos
+    while endPos < end and str[endPos] in string.digits + ".":
+        endPos = endPos + 1
+    if pos != endPos:
+        return str[pos:endPos], endPos
+    endPos = pos
+    while endPos < end and str[endPos] not in string.whitespace + string.digits + "+-":
+        endPos = endPos + 1
+    if pos != endPos:
+        return str[pos:endPos], endPos
+    return None, 0
+
+
+def TkIndexToOffset(bm, edit, marks):
+    base, nextTokPos = _NextTok(bm, 0)
+    if base is None:
+        raise ValueError("Empty bookmark ID!")
+    if base.find(".") > 0:
+        try:
+            line, col = base.split(".", 2)
+            if col == "first" or col == "last":
+                # Tag name
+                if line != "sel":
+                    raise ValueError("Tags arent here!")
+                sel = edit.GetSel()
+                if sel[0] == sel[1]:
+                    raise EmptyRange
+                if col == "first":
+                    pos = sel[0]
+                else:
+                    pos = sel[1]
+            else:
+                # Lines are 1 based for tkinter
+                line = int(line) - 1
+                if line > edit.GetLineCount():
+                    pos = edit.GetTextLength() + 1
+                else:
+                    pos = edit.LineIndex(line)
+                    if pos == -1:
+                        pos = edit.GetTextLength()
+                    pos = pos + int(col)
+        except (ValueError, IndexError):
+            raise ValueError("Unexpected literal in '%s'" % base)
+    elif base == "insert":
+        pos = edit.GetSel()[0]
+    elif base == "end":
+        pos = edit.GetTextLength()
+        # Pretend there is a trailing '\n' if necessary
+        if pos and edit.SCIGetCharAt(pos - 1) != "\n":
+            pos = pos + 1
+    else:
+        try:
+            pos = marks[base]
+        except KeyError:
+            raise ValueError("Unsupported base offset or undefined mark '%s'" % base)
+
+    while 1:
+        word, nextTokPos = _NextTok(bm, nextTokPos)
+        if word is None:
+            break
+        if word in ("+", "-"):
+            num, nextTokPos = _NextTok(bm, nextTokPos)
+            if num is None:
+                raise ValueError("+/- operator needs 2 args")
+            what, nextTokPos = _NextTok(bm, nextTokPos)
+            if what is None:
+                raise ValueError("+/- operator needs 2 args")
+            if what[0] != "c":
+                raise ValueError("+/- only supports chars")
+            if word == "+":
+                pos = pos + int(num)
+            else:
+                pos = pos - int(num)
+        elif word == "wordstart":
+            while pos > 0 and edit.SCIGetCharAt(pos - 1) in wordchars:
+                pos = pos - 1
+        elif word == "wordend":
+            end = edit.GetTextLength()
+            while pos < end and edit.SCIGetCharAt(pos) in wordchars:
+                pos = pos + 1
+        elif word == "linestart":
+            while pos > 0 and edit.SCIGetCharAt(pos - 1) not in "\n\r":
+                pos = pos - 1
+        elif word == "lineend":
+            end = edit.GetTextLength()
+            while pos < end and edit.SCIGetCharAt(pos) not in "\n\r":
+                pos = pos + 1
+        else:
+            raise ValueError("Unsupported relative offset '%s'" % word)
+    return max(pos, 0)  # Tkinter is tollerant of -ve indexes - we aren't
+
+
+# A class that resembles an IDLE (ie, a Tk) text widget.
+# Construct with an edit object (eg, an editor view)
+class TkText:
+    def __init__(self, edit):
+        self.calltips = None
+        self.edit = edit
+        self.marks = {}
+
+    ##	def __getattr__(self, attr):
+    ##		if attr=="tk": return self # So text.tk.call works.
+    ##		if attr=="master": return None # ditto!
+    ##		raise AttributeError, attr
+    ##	def __getitem__(self, item):
+    ##		if item=="tabs":
+    ##			size = self.edit.GetTabWidth()
+    ##			if size==8: return "" # Tk default
+    ##			return size # correct semantics?
+    ##		elif item=="font": # Used for measurements we dont need to do!
+    ##			return "Dont know the font"
+    ##		raise IndexError, "Invalid index '%s'" % item
+    def make_calltip_window(self):
+        if self.calltips is None:
+            self.calltips = CallTips(self.edit)
+        return self.calltips
+
+    def _getoffset(self, index):
+        return TkIndexToOffset(index, self.edit, self.marks)
+
+    def _getindex(self, off):
+        return TkOffsetToIndex(off, self.edit)
+
+    def _fix_indexes(self, start, end):
+        # first some magic to handle skipping over utf8 extended chars.
+        while start > 0 and ord(self.edit.SCIGetCharAt(start)) & 0xC0 == 0x80:
+            start -= 1
+        while (
+            end < self.edit.GetTextLength()
+            and ord(self.edit.SCIGetCharAt(end)) & 0xC0 == 0x80
+        ):
+            end += 1
+        # now handling fixing \r\n->\n disparities...
+        if (
+            start > 0
+            and self.edit.SCIGetCharAt(start) == "\n"
+            and self.edit.SCIGetCharAt(start - 1) == "\r"
+        ):
+            start = start - 1
+        if (
+            end < self.edit.GetTextLength()
+            and self.edit.SCIGetCharAt(end - 1) == "\r"
+            and self.edit.SCIGetCharAt(end) == "\n"
+        ):
+            end = end + 1
+        return start, end
+
+    ##	def get_tab_width(self):
+    ##		return self.edit.GetTabWidth()
+    ##	def call(self, *rest):
+    ##		# Crap to support Tk measurement hacks for tab widths
+    ##		if rest[0] != "font" or rest[1] != "measure":
+    ##			raise ValueError, "Unsupport call type"
+    ##		return len(rest[5])
+    ##	def configure(self, **kw):
+    ##		for name, val in kw.items():
+    ##			if name=="tabs":
+    ##				self.edit.SCISetTabWidth(int(val))
+    ##			else:
+    ##				raise ValueError, "Unsupported configuration item %s" % kw
+    def bind(self, binding, handler):
+        self.edit.bindings.bind(binding, handler)
+
+    def get(self, start, end=None):
+        try:
+            start = self._getoffset(start)
+            if end is None:
+                end = start + 1
+            else:
+                end = self._getoffset(end)
+        except EmptyRange:
+            return ""
+        # Simple semantic checks to conform to the Tk text interface
+        if end <= start:
+            return ""
+        max = self.edit.GetTextLength()
+        checkEnd = 0
+        if end > max:
+            end = max
+            checkEnd = 1
+        start, end = self._fix_indexes(start, end)
+        ret = self.edit.GetTextRange(start, end)
+        # pretend a trailing '\n' exists if necessary.
+        if checkEnd and (not ret or ret[-1] != "\n"):
+            ret = ret + "\n"
+        return ret.replace("\r", "")
+
+    def index(self, spec):
+        try:
+            return self._getindex(self._getoffset(spec))
+        except EmptyRange:
+            return ""
+
+    def insert(self, pos, text):
+        try:
+            pos = self._getoffset(pos)
+        except EmptyRange:
+            raise TextError("Empty range")
+        self.edit.SetSel((pos, pos))
+        # IDLE only deals with "\n" - we will be nicer
+
+        bits = text.split("\n")
+        self.edit.SCIAddText(bits[0])
+        for bit in bits[1:]:
+            self.edit.SCINewline()
+            self.edit.SCIAddText(bit)
+
+    def delete(self, start, end=None):
+        try:
+            start = self._getoffset(start)
+            if end is not None:
+                end = self._getoffset(end)
+        except EmptyRange:
+            raise TextError("Empty range")
+        # If end is specified and == start, then we must delete nothing.
+        if start == end:
+            return
+        # If end is not specified, delete one char
+        if end is None:
+            end = start + 1
+        else:
+            # Tk says not to delete in this case, but our control would.
+            if end < start:
+                return
+        if start == self.edit.GetTextLength():
+            return  # Nothing to delete.
+        old = self.edit.GetSel()[0]  # Lose a selection
+        # Hack for partial '\r\n' and UTF-8 char removal
+        start, end = self._fix_indexes(start, end)
+        self.edit.SetSel((start, end))
+        self.edit.Clear()
+        if old >= start and old < end:
+            old = start
+        elif old >= end:
+            old = old - (end - start)
+        self.edit.SetSel(old)
+
+    def bell(self):
+        win32api.MessageBeep()
+
+    def see(self, pos):
+        # Most commands we use in Scintilla actually force the selection
+        # to be seen, making this unnecessary.
+        pass
+
+    def mark_set(self, name, pos):
+        try:
+            pos = self._getoffset(pos)
+        except EmptyRange:
+            raise TextError("Empty range '%s'" % pos)
+        if name == "insert":
+            self.edit.SetSel(pos)
+        else:
+            self.marks[name] = pos
+
+    def tag_add(self, name, start, end):
+        if name != "sel":
+            raise ValueError("Only sel tag is supported")
+        try:
+            start = self._getoffset(start)
+            end = self._getoffset(end)
+        except EmptyRange:
+            raise TextError("Empty range")
+        self.edit.SetSel(start, end)
+
+    def tag_remove(self, name, start, end):
+        if name != "sel" or start != "1.0" or end != "end":
+            raise ValueError("Cant remove this tag")
+        # Turn the sel into a cursor
+        self.edit.SetSel(self.edit.GetSel()[0])
+
+    def compare(self, i1, op, i2):
+        try:
+            i1 = self._getoffset(i1)
+        except EmptyRange:
+            i1 = ""
+        try:
+            i2 = self._getoffset(i2)
+        except EmptyRange:
+            i2 = ""
+        return eval("%d%s%d" % (i1, op, i2))
+
+    def undo_block_start(self):
+        self.edit.SCIBeginUndoAction()
+
+    def undo_block_stop(self):
+        self.edit.SCIEndUndoAction()
+
+
+######################################################################
+#
+# Test related code.
+#
+######################################################################
+def TestCheck(index, edit, expected=None):
+    rc = TkIndexToOffset(index, edit, {})
+    if rc != expected:
+        print("ERROR: Index", index, ", expected", expected, "but got", rc)
+
+
+def TestGet(fr, to, t, expected):
+    got = t.get(fr, to)
+    if got != expected:
+        print(
+            "ERROR: get(%s, %s) expected %s, but got %s"
+            % (repr(fr), repr(to), repr(expected), repr(got))
+        )
+
+
+def test():
+    import pywin.framework.editor
+
+    d = pywin.framework.editor.editorTemplate.OpenDocumentFile(None)
+    e = d.GetFirstView()
+    t = TkText(e)
+    e.SCIAddText("hi there how\nare you today\r\nI hope you are well")
+    e.SetSel((4, 4))
+
+    skip = """
+	TestCheck("insert", e, 4)
+	TestCheck("insert wordstart", e, 3)
+	TestCheck("insert wordend", e, 8)
+	TestCheck("insert linestart", e, 0)
+	TestCheck("insert lineend", e, 12)
+	TestCheck("insert + 4 chars", e, 8)
+	TestCheck("insert +4c", e, 8)
+	TestCheck("insert - 2 chars", e, 2)
+	TestCheck("insert -2c", e, 2)
+	TestCheck("insert-2c", e, 2)
+	TestCheck("insert-2 c", e, 2)
+	TestCheck("insert- 2c", e, 2)
+	TestCheck("1.1", e, 1)
+	TestCheck("1.0", e, 0)
+	TestCheck("2.0", e, 13)
+	try:
+		TestCheck("sel.first", e, 0)
+		print "*** sel.first worked with an empty selection"
+	except TextError:
+		pass
+	e.SetSel((4,5))
+	TestCheck("sel.first- 2c", e, 2)
+	TestCheck("sel.last- 2c", e, 3)
+	"""
+    # Check EOL semantics
+    e.SetSel((4, 4))
+    TestGet("insert lineend", "insert lineend +1c", t, "\n")
+    e.SetSel((20, 20))
+    TestGet("insert lineend", "insert lineend +1c", t, "\n")
+    e.SetSel((35, 35))
+    TestGet("insert lineend", "insert lineend +1c", t, "\n")
+
+
+class IDLEWrapper:
+    def __init__(self, control):
+        self.text = control
+
+
+def IDLETest(extension):
+    import os
+    import sys
+
+    modname = "pywin.idle." + extension
+    __import__(modname)
+    mod = sys.modules[modname]
+    mod.TclError = TextError
+    klass = getattr(mod, extension)
+
+    # Create a new Scintilla Window.
+    import pywin.framework.editor
+
+    d = pywin.framework.editor.editorTemplate.OpenDocumentFile(None)
+    v = d.GetFirstView()
+    fname = os.path.splitext(__file__)[0] + ".py"
+    v.SCIAddText(open(fname).read())
+    d.SetModifiedFlag(0)
+    r = klass(IDLEWrapper(TkText(v)))
+    return r
+
+
+if __name__ == "__main__":
+    test()
diff --git a/lib/pythonwin/pywin/scintilla/__init__.py b/lib/pythonwin/pywin/scintilla/__init__.py
new file mode 100644
index 00000000..0981b622
--- /dev/null
+++ b/lib/pythonwin/pywin/scintilla/__init__.py
@@ -0,0 +1 @@
+# package init.
diff --git a/lib/pythonwin/pywin/scintilla/bindings.py b/lib/pythonwin/pywin/scintilla/bindings.py
new file mode 100644
index 00000000..785bd42a
--- /dev/null
+++ b/lib/pythonwin/pywin/scintilla/bindings.py
@@ -0,0 +1,178 @@
+import traceback
+
+import win32api
+import win32con
+import win32ui
+
+from . import IDLEenvironment, keycodes
+
+HANDLER_ARGS_GUESS = 0
+HANDLER_ARGS_NATIVE = 1
+HANDLER_ARGS_IDLE = 2
+HANDLER_ARGS_EXTENSION = 3
+
+next_id = 5000
+
+event_to_commands = {}  # dict of integer IDs to event names.
+command_to_events = {}  # dict of event names to int IDs
+
+
+def assign_command_id(event, id=0):
+    global next_id
+    if id == 0:
+        id = event_to_commands.get(event, 0)
+        if id == 0:
+            id = next_id
+            next_id = next_id + 1
+        # Only map the ones we allocated - specified ones are assumed to have a handler
+        command_to_events[id] = event
+    event_to_commands[event] = id
+    return id
+
+
+class SendCommandHandler:
+    def __init__(self, cmd):
+        self.cmd = cmd
+
+    def __call__(self, *args):
+        win32ui.GetMainFrame().SendMessage(win32con.WM_COMMAND, self.cmd)
+
+
+class Binding:
+    def __init__(self, handler, handler_args_type):
+        self.handler = handler
+        self.handler_args_type = handler_args_type
+
+
+class BindingsManager:
+    def __init__(self, parent_view):
+        self.parent_view = parent_view
+        self.bindings = {}  # dict of Binding instances.
+        self.keymap = {}
+
+    def prepare_configure(self):
+        self.keymap = {}
+
+    def complete_configure(self):
+        for id in command_to_events.keys():
+            self.parent_view.HookCommand(self._OnCommand, id)
+
+    def close(self):
+        self.parent_view = self.bindings = self.keymap = None
+
+    def report_error(self, problem):
+        try:
+            win32ui.SetStatusText(problem, 1)
+        except win32ui.error:
+            # No status bar!
+            print(problem)
+
+    def update_keymap(self, keymap):
+        self.keymap.update(keymap)
+
+    def bind(self, event, handler, handler_args_type=HANDLER_ARGS_GUESS, cid=0):
+        if handler is None:
+            handler = SendCommandHandler(cid)
+        self.bindings[event] = self._new_binding(handler, handler_args_type)
+        self.bind_command(event, cid)
+
+    def bind_command(self, event, id=0):
+        "Binds an event to a Windows control/command ID"
+        id = assign_command_id(event, id)
+        return id
+
+    def get_command_id(self, event):
+        id = event_to_commands.get(event)
+        if id is None:
+            # See if we even have an event of that name!?
+            if event not in self.bindings:
+                return None
+            id = self.bind_command(event)
+        return id
+
+    def _OnCommand(self, id, code):
+        event = command_to_events.get(id)
+        if event is None:
+            self.report_error("No event associated with event ID %d" % id)
+            return 1
+        return self.fire(event)
+
+    def _new_binding(self, event, handler_args_type):
+        return Binding(event, handler_args_type)
+
+    def _get_IDLE_handler(self, ext, handler):
+        try:
+            instance = self.parent_view.idle.IDLEExtension(ext)
+            name = handler.replace("-", "_") + "_event"
+            return getattr(instance, name)
+        except (ImportError, AttributeError):
+            msg = "Can not find event '%s' in IDLE extension '%s'" % (handler, ext)
+            self.report_error(msg)
+            return None
+
+    def fire(self, event, event_param=None):
+        # Fire the specified event.  Result is native Pythonwin result
+        # (ie, 1==pass one, 0 or None==handled)
+
+        # First look up the event directly - if there, we are set.
+        binding = self.bindings.get(event)
+        if binding is None:
+            # If possible, find it!
+            # A native method name
+            handler = getattr(self.parent_view, event + "Event", None)
+            if handler is None:
+                # Can't decide if I should report an error??
+                self.report_error("The event name '%s' can not be found." % event)
+                # Either way, just let the default handlers grab it.
+                return 1
+            binding = self._new_binding(handler, HANDLER_ARGS_NATIVE)
+            # Cache it.
+            self.bindings[event] = binding
+
+        handler_args_type = binding.handler_args_type
+        # Now actually fire it.
+        if handler_args_type == HANDLER_ARGS_GUESS:
+            # Can't be native, as natives are never added with "guess".
+            # Must be extension or IDLE.
+            if event[0] == "<":
+                handler_args_type = HANDLER_ARGS_IDLE
+            else:
+                handler_args_type = HANDLER_ARGS_EXTENSION
+        try:
+            if handler_args_type == HANDLER_ARGS_EXTENSION:
+                args = self.parent_view.idle, event_param
+            else:
+                args = (event_param,)
+            rc = binding.handler(*args)
+            if handler_args_type == HANDLER_ARGS_IDLE:
+                # Convert to our return code.
+                if rc in (None, "break"):
+                    rc = 0
+                else:
+                    rc = 1
+        except:
+            message = "Firing event '%s' failed." % event
+            print(message)
+            traceback.print_exc()
+            self.report_error(message)
+            rc = 1  # Let any default handlers have a go!
+        return rc
+
+    def fire_key_event(self, msg):
+        key = msg[2]
+        keyState = 0
+        if win32api.GetKeyState(win32con.VK_CONTROL) & 0x8000:
+            keyState = (
+                keyState | win32con.RIGHT_CTRL_PRESSED | win32con.LEFT_CTRL_PRESSED
+            )
+        if win32api.GetKeyState(win32con.VK_SHIFT) & 0x8000:
+            keyState = keyState | win32con.SHIFT_PRESSED
+        if win32api.GetKeyState(win32con.VK_MENU) & 0x8000:
+            keyState = keyState | win32con.LEFT_ALT_PRESSED | win32con.RIGHT_ALT_PRESSED
+        keyinfo = key, keyState
+        # Special hacks for the dead-char key on non-US keyboards.
+        # (XXX - which do not work :-(
+        event = self.keymap.get(keyinfo)
+        if event is None:
+            return 1
+        return self.fire(event, None)
diff --git a/lib/pythonwin/pywin/scintilla/config.py b/lib/pythonwin/pywin/scintilla/config.py
new file mode 100644
index 00000000..9a1b210e
--- /dev/null
+++ b/lib/pythonwin/pywin/scintilla/config.py
@@ -0,0 +1,365 @@
+# config.py - deals with loading configuration information.
+
+# Loads config data from a .cfg file.  Also caches the compiled
+# data back into a .cfc file.
+
+# If you are wondering how to avoid needing .cfg files (eg,
+# if you are freezing Pythonwin etc) I suggest you create a
+# .py file, and put the config info in a docstring.  Then
+# pass a CStringIO file (rather than a filename) to the
+# config manager.
+import glob
+import importlib.util
+import marshal
+import os
+import stat
+import sys
+import traceback
+import types
+
+import pywin
+import win32api
+
+from . import keycodes
+
+debugging = 0
+if debugging:
+    import win32traceutil  # Some trace statements fire before the interactive window is open.
+
+    def trace(*args):
+        sys.stderr.write(" ".join(map(str, args)) + "\n")
+
+else:
+    trace = lambda *args: None
+
+compiled_config_version = 3
+
+
+def split_line(line, lineno):
+    comment_pos = line.find("#")
+    if comment_pos >= 0:
+        line = line[:comment_pos]
+    sep_pos = line.rfind("=")
+    if sep_pos == -1:
+        if line.strip():
+            print("Warning: Line %d: %s is an invalid entry" % (lineno, repr(line)))
+            return None, None
+        return "", ""
+    return line[:sep_pos].strip(), line[sep_pos + 1 :].strip()
+
+
+def get_section_header(line):
+    # Returns the section if the line is a section header, else None
+    if line[0] == "[":
+        end = line.find("]")
+        if end == -1:
+            end = len(line)
+        rc = line[1:end].lower()
+        try:
+            i = rc.index(":")
+            return rc[:i], rc[i + 1 :]
+        except ValueError:
+            return rc, ""
+    return None, None
+
+
+def find_config_file(f):
+    return os.path.join(pywin.__path__[0], f + ".cfg")
+
+
+def find_config_files():
+    return [
+        os.path.split(x)[1]
+        for x in [
+            os.path.splitext(x)[0]
+            for x in glob.glob(os.path.join(pywin.__path__[0], "*.cfg"))
+        ]
+    ]
+
+
+class ConfigManager:
+    def __init__(self, f):
+        self.filename = "unknown"
+        self.last_error = None
+        self.key_to_events = {}
+        b_close = False
+        if hasattr(f, "readline"):
+            fp = f
+            self.filename = "<config string>"
+            compiled_name = None
+        else:
+            try:
+                f = find_config_file(f)
+                src_stat = os.stat(f)
+            except os.error:
+                self.report_error("Config file '%s' not found" % f)
+                return
+            self.filename = f
+            self.basename = os.path.basename(f)
+            trace("Loading configuration", self.basename)
+            compiled_name = os.path.splitext(f)[0] + ".cfc"
+            try:
+                cf = open(compiled_name, "rb")
+                try:
+                    ver = marshal.load(cf)
+                    ok = compiled_config_version == ver
+                    if ok:
+                        kblayoutname = marshal.load(cf)
+                        magic = marshal.load(cf)
+                        size = marshal.load(cf)
+                        mtime = marshal.load(cf)
+                        if (
+                            magic == importlib.util.MAGIC_NUMBER
+                            and win32api.GetKeyboardLayoutName() == kblayoutname
+                            and src_stat[stat.ST_MTIME] == mtime
+                            and src_stat[stat.ST_SIZE] == size
+                        ):
+                            self.cache = marshal.load(cf)
+                            trace("Configuration loaded cached", compiled_name)
+                            return  # We are ready to roll!
+                finally:
+                    cf.close()
+            except (os.error, IOError, EOFError):
+                pass
+            fp = open(f)
+            b_close = True
+        self.cache = {}
+        lineno = 1
+        line = fp.readline()
+        while line:
+            # Skip to the next section (maybe already there!)
+            section, subsection = get_section_header(line)
+            while line and section is None:
+                line = fp.readline()
+                if not line:
+                    break
+                lineno = lineno + 1
+                section, subsection = get_section_header(line)
+            if not line:
+                break
+
+            if section == "keys":
+                line, lineno = self._load_keys(subsection, fp, lineno)
+            elif section == "extensions":
+                line, lineno = self._load_extensions(subsection, fp, lineno)
+            elif section == "idle extensions":
+                line, lineno = self._load_idle_extensions(subsection, fp, lineno)
+            elif section == "general":
+                line, lineno = self._load_general(subsection, fp, lineno)
+            else:
+                self.report_error(
+                    "Unrecognised section header '%s:%s'" % (section, subsection)
+                )
+                line = fp.readline()
+                lineno = lineno + 1
+        if b_close:
+            fp.close()
+        # Check critical data.
+        if not self.cache.get("keys"):
+            self.report_error("No keyboard definitions were loaded")
+        if not self.last_error and compiled_name:
+            try:
+                cf = open(compiled_name, "wb")
+                marshal.dump(compiled_config_version, cf)
+                marshal.dump(win32api.GetKeyboardLayoutName(), cf)
+                marshal.dump(importlib.util.MAGIC_NUMBER, cf)
+                marshal.dump(src_stat[stat.ST_SIZE], cf)
+                marshal.dump(src_stat[stat.ST_MTIME], cf)
+                marshal.dump(self.cache, cf)
+                cf.close()
+            except (IOError, EOFError):
+                pass  # Ignore errors - may be read only.
+
+    def configure(self, editor, subsections=None):
+        # Execute the extension code, and find any events.
+        # First, we "recursively" connect any we are based on.
+        if subsections is None:
+            subsections = []
+        subsections = [""] + subsections
+        general = self.get_data("general")
+        if general:
+            parents = general.get("based on", [])
+            for parent in parents:
+                trace("Configuration based on", parent, "- loading.")
+                parent = self.__class__(parent)
+                parent.configure(editor, subsections)
+                if parent.last_error:
+                    self.report_error(parent.last_error)
+
+        bindings = editor.bindings
+        codeob = self.get_data("extension code")
+        if codeob is not None:
+            ns = {}
+            try:
+                exec(codeob, ns)
+            except:
+                traceback.print_exc()
+                self.report_error("Executing extension code failed")
+                ns = None
+            if ns:
+                num = 0
+                for name, func in list(ns.items()):
+                    if type(func) == types.FunctionType and name[:1] != "_":
+                        bindings.bind(name, func)
+                        num = num + 1
+                trace("Configuration Extension code loaded", num, "events")
+        # Load the idle extensions
+        for subsection in subsections:
+            for ext in self.get_data("idle extensions", {}).get(subsection, []):
+                try:
+                    editor.idle.IDLEExtension(ext)
+                    trace("Loaded IDLE extension", ext)
+                except:
+                    self.report_error("Can not load the IDLE extension '%s'" % ext)
+
+        # Now bind up the key-map (remembering a reverse map
+        subsection_keymap = self.get_data("keys")
+        num_bound = 0
+        for subsection in subsections:
+            keymap = subsection_keymap.get(subsection, {})
+            bindings.update_keymap(keymap)
+            num_bound = num_bound + len(keymap)
+        trace("Configuration bound", num_bound, "keys")
+
+    def get_key_binding(self, event, subsections=None):
+        if subsections is None:
+            subsections = []
+        subsections = [""] + subsections
+
+        subsection_keymap = self.get_data("keys")
+        for subsection in subsections:
+            map = self.key_to_events.get(subsection)
+            if map is None:  # Build it
+                map = {}
+                keymap = subsection_keymap.get(subsection, {})
+                for key_info, map_event in list(keymap.items()):
+                    map[map_event] = key_info
+                self.key_to_events[subsection] = map
+
+            info = map.get(event)
+            if info is not None:
+                return keycodes.make_key_name(info[0], info[1])
+        return None
+
+    def report_error(self, msg):
+        self.last_error = msg
+        print("Error in %s: %s" % (self.filename, msg))
+
+    def report_warning(self, msg):
+        print("Warning in %s: %s" % (self.filename, msg))
+
+    def _readline(self, fp, lineno, bStripComments=1):
+        line = fp.readline()
+        lineno = lineno + 1
+        if line:
+            bBreak = (
+                get_section_header(line)[0] is not None
+            )  # A new section is starting
+            if bStripComments and not bBreak:
+                pos = line.find("#")
+                if pos >= 0:
+                    line = line[:pos] + "\n"
+        else:
+            bBreak = 1
+        return line, lineno, bBreak
+
+    def get_data(self, name, default=None):
+        return self.cache.get(name, default)
+
+    def _save_data(self, name, data):
+        self.cache[name] = data
+        return data
+
+    def _load_general(self, sub_section, fp, lineno):
+        map = {}
+        while 1:
+            line, lineno, bBreak = self._readline(fp, lineno)
+            if bBreak:
+                break
+
+            key, val = split_line(line, lineno)
+            if not key:
+                continue
+            key = key.lower()
+            l = map.get(key, [])
+            l.append(val)
+            map[key] = l
+        self._save_data("general", map)
+        return line, lineno
+
+    def _load_keys(self, sub_section, fp, lineno):
+        # Builds a nested dictionary of
+        # (scancode, flags) = event_name
+        main_map = self.get_data("keys", {})
+        map = main_map.get(sub_section, {})
+        while 1:
+            line, lineno, bBreak = self._readline(fp, lineno)
+            if bBreak:
+                break
+
+            key, event = split_line(line, lineno)
+            if not event:
+                continue
+            sc, flag = keycodes.parse_key_name(key)
+            if sc is None:
+                self.report_warning("Line %d: Invalid key name '%s'" % (lineno, key))
+            else:
+                map[sc, flag] = event
+        main_map[sub_section] = map
+        self._save_data("keys", main_map)
+        return line, lineno
+
+    def _load_extensions(self, sub_section, fp, lineno):
+        start_lineno = lineno
+        lines = []
+        while 1:
+            line, lineno, bBreak = self._readline(fp, lineno, 0)
+            if bBreak:
+                break
+            lines.append(line)
+        try:
+            c = compile(
+                "\n" * start_lineno + "".join(lines),  # produces correct tracebacks
+                self.filename,
+                "exec",
+            )
+            self._save_data("extension code", c)
+        except SyntaxError as details:
+            errlineno = details.lineno + start_lineno
+            # Should handle syntax errors better here, and offset the lineno.
+            self.report_error(
+                "Compiling extension code failed:\r\nFile: %s\r\nLine %d\r\n%s"
+                % (details.filename, errlineno, details.msg)
+            )
+        return line, lineno
+
+    def _load_idle_extensions(self, sub_section, fp, lineno):
+        extension_map = self.get_data("idle extensions")
+        if extension_map is None:
+            extension_map = {}
+        extensions = []
+        while 1:
+            line, lineno, bBreak = self._readline(fp, lineno)
+            if bBreak:
+                break
+            line = line.strip()
+            if line:
+                extensions.append(line)
+        extension_map[sub_section] = extensions
+        self._save_data("idle extensions", extension_map)
+        return line, lineno
+
+
+def test():
+    import time
+
+    start = time.clock()
+    f = "default"
+    cm = ConfigManager(f)
+    map = cm.get_data("keys")
+    took = time.clock() - start
+    print("Loaded %s items in %.4f secs" % (len(map), took))
+
+
+if __name__ == "__main__":
+    test()
diff --git a/lib/pythonwin/pywin/scintilla/configui.py b/lib/pythonwin/pywin/scintilla/configui.py
new file mode 100644
index 00000000..8b6157b6
--- /dev/null
+++ b/lib/pythonwin/pywin/scintilla/configui.py
@@ -0,0 +1,292 @@
+import win32api
+import win32con
+import win32ui
+from pywin.mfc import dialog
+
+# Used to indicate that style should use default color
+from win32con import CLR_INVALID
+
+from . import scintillacon
+
+######################################################
+# Property Page for syntax formatting options
+
+# The standard 16 color VGA palette should always be possible
+paletteVGA = (
+    ("Black", win32api.RGB(0, 0, 0)),
+    ("Navy", win32api.RGB(0, 0, 128)),
+    ("Green", win32api.RGB(0, 128, 0)),
+    ("Cyan", win32api.RGB(0, 128, 128)),
+    ("Maroon", win32api.RGB(128, 0, 0)),
+    ("Purple", win32api.RGB(128, 0, 128)),
+    ("Olive", win32api.RGB(128, 128, 0)),
+    ("Gray", win32api.RGB(128, 128, 128)),
+    ("Silver", win32api.RGB(192, 192, 192)),
+    ("Blue", win32api.RGB(0, 0, 255)),
+    ("Lime", win32api.RGB(0, 255, 0)),
+    ("Aqua", win32api.RGB(0, 255, 255)),
+    ("Red", win32api.RGB(255, 0, 0)),
+    ("Fuchsia", win32api.RGB(255, 0, 255)),
+    ("Yellow", win32api.RGB(255, 255, 0)),
+    ("White", win32api.RGB(255, 255, 255)),
+    # and a few others will generally be possible.
+    ("DarkGrey", win32api.RGB(64, 64, 64)),
+    ("PurpleBlue", win32api.RGB(64, 64, 192)),
+    ("DarkGreen", win32api.RGB(0, 96, 0)),
+    ("DarkOlive", win32api.RGB(128, 128, 64)),
+    ("MediumBlue", win32api.RGB(0, 0, 192)),
+    ("DarkNavy", win32api.RGB(0, 0, 96)),
+    ("Magenta", win32api.RGB(96, 0, 96)),
+    ("OffWhite", win32api.RGB(255, 255, 220)),
+    ("LightPurple", win32api.RGB(220, 220, 255)),
+    ("<Default>", win32con.CLR_INVALID),
+)
+
+
+class ScintillaFormatPropertyPage(dialog.PropertyPage):
+    def __init__(self, scintillaClass=None, caption=0):
+        self.scintillaClass = scintillaClass
+        dialog.PropertyPage.__init__(self, win32ui.IDD_PP_FORMAT, caption=caption)
+
+    def OnInitDialog(self):
+        try:
+            if self.scintillaClass is None:
+                from . import control
+
+                sc = control.CScintillaEdit
+            else:
+                sc = self.scintillaClass
+
+            self.scintilla = sc()
+            style = win32con.WS_CHILD | win32con.WS_VISIBLE | win32con.ES_MULTILINE
+            # Convert the rect size
+            rect = self.MapDialogRect((5, 5, 120, 75))
+            self.scintilla.CreateWindow(style, rect, self, 111)
+            self.HookNotify(self.OnBraceMatch, scintillacon.SCN_CHECKBRACE)
+            self.scintilla.HookKeyStroke(self.OnEsc, 27)
+            self.scintilla.SCISetViewWS(1)
+            self.pos_bstart = self.pos_bend = self.pos_bbad = 0
+
+            colorizer = self.scintilla._GetColorizer()
+            text = colorizer.GetSampleText()
+            items = text.split("|", 2)
+            pos = len(items[0])
+            self.scintilla.SCIAddText("".join(items))
+            self.scintilla.SetSel(pos, pos)
+            self.scintilla.ApplyFormattingStyles()
+            self.styles = self.scintilla._GetColorizer().styles
+
+            self.cbo = self.GetDlgItem(win32ui.IDC_COMBO1)
+            for c in paletteVGA:
+                self.cbo.AddString(c[0])
+
+            self.cboBoldItalic = self.GetDlgItem(win32ui.IDC_COMBO2)
+            for item in ("Bold Italic", "Bold", "Italic", "Regular"):
+                self.cboBoldItalic.InsertString(0, item)
+
+            self.butIsDefault = self.GetDlgItem(win32ui.IDC_CHECK1)
+            self.butIsDefaultBackground = self.GetDlgItem(win32ui.IDC_CHECK2)
+            self.listbox = self.GetDlgItem(win32ui.IDC_LIST1)
+            self.HookCommand(self.OnListCommand, win32ui.IDC_LIST1)
+            names = list(self.styles.keys())
+            names.sort()
+            for name in names:
+                if self.styles[name].aliased is None:
+                    self.listbox.AddString(name)
+            self.listbox.SetCurSel(0)
+
+            idc = win32ui.IDC_RADIO1
+            if not self.scintilla._GetColorizer().bUseFixed:
+                idc = win32ui.IDC_RADIO2
+            self.GetDlgItem(idc).SetCheck(1)
+            self.UpdateUIForStyle(self.styles[names[0]])
+
+            self.scintilla.HookFormatter(self)
+            self.HookCommand(self.OnButDefaultFixedFont, win32ui.IDC_BUTTON1)
+            self.HookCommand(self.OnButDefaultPropFont, win32ui.IDC_BUTTON2)
+            self.HookCommand(self.OnButThisFont, win32ui.IDC_BUTTON3)
+            self.HookCommand(self.OnButUseDefaultFont, win32ui.IDC_CHECK1)
+            self.HookCommand(self.OnButThisBackground, win32ui.IDC_BUTTON4)
+            self.HookCommand(self.OnButUseDefaultBackground, win32ui.IDC_CHECK2)
+            self.HookCommand(self.OnStyleUIChanged, win32ui.IDC_COMBO1)
+            self.HookCommand(self.OnStyleUIChanged, win32ui.IDC_COMBO2)
+            self.HookCommand(self.OnButFixedOrDefault, win32ui.IDC_RADIO1)
+            self.HookCommand(self.OnButFixedOrDefault, win32ui.IDC_RADIO2)
+        except:
+            import traceback
+
+            traceback.print_exc()
+
+    def OnEsc(self, ch):
+        self.GetParent().EndDialog(win32con.IDCANCEL)
+
+    def OnBraceMatch(self, std, extra):
+        import pywin.scintilla.view
+
+        pywin.scintilla.view.DoBraceMatch(self.scintilla)
+
+    def GetSelectedStyle(self):
+        return self.styles[self.listbox.GetText(self.listbox.GetCurSel())]
+
+    def _DoButDefaultFont(self, extra_flags, attr):
+        baseFormat = getattr(self.scintilla._GetColorizer(), attr)
+        flags = (
+            extra_flags
+            | win32con.CF_SCREENFONTS
+            | win32con.CF_EFFECTS
+            | win32con.CF_FORCEFONTEXIST
+        )
+        d = win32ui.CreateFontDialog(baseFormat, flags, None, self)
+        if d.DoModal() == win32con.IDOK:
+            setattr(self.scintilla._GetColorizer(), attr, d.GetCharFormat())
+            self.OnStyleUIChanged(0, win32con.BN_CLICKED)
+
+    def OnButDefaultFixedFont(self, id, code):
+        if code == win32con.BN_CLICKED:
+            self._DoButDefaultFont(win32con.CF_FIXEDPITCHONLY, "baseFormatFixed")
+            return 1
+
+    def OnButDefaultPropFont(self, id, code):
+        if code == win32con.BN_CLICKED:
+            self._DoButDefaultFont(win32con.CF_SCALABLEONLY, "baseFormatProp")
+            return 1
+
+    def OnButFixedOrDefault(self, id, code):
+        if code == win32con.BN_CLICKED:
+            bUseFixed = id == win32ui.IDC_RADIO1
+            self.GetDlgItem(win32ui.IDC_RADIO1).GetCheck() != 0
+            self.scintilla._GetColorizer().bUseFixed = bUseFixed
+            self.scintilla.ApplyFormattingStyles(0)
+            return 1
+
+    def OnButThisFont(self, id, code):
+        if code == win32con.BN_CLICKED:
+            flags = (
+                win32con.CF_SCREENFONTS
+                | win32con.CF_EFFECTS
+                | win32con.CF_FORCEFONTEXIST
+            )
+            style = self.GetSelectedStyle()
+            # If the selected style is based on the default, we need to apply
+            # the default to it.
+            def_format = self.scintilla._GetColorizer().GetDefaultFormat()
+            format = style.GetCompleteFormat(def_format)
+            d = win32ui.CreateFontDialog(format, flags, None, self)
+            if d.DoModal() == win32con.IDOK:
+                style.format = d.GetCharFormat()
+                self.scintilla.ApplyFormattingStyles(0)
+            return 1
+
+    def OnButUseDefaultFont(self, id, code):
+        if code == win32con.BN_CLICKED:
+            isDef = self.butIsDefault.GetCheck()
+            self.GetDlgItem(win32ui.IDC_BUTTON3).EnableWindow(not isDef)
+            if isDef:  # Being reset to the default font.
+                style = self.GetSelectedStyle()
+                style.ForceAgainstDefault()
+                self.UpdateUIForStyle(style)
+                self.scintilla.ApplyFormattingStyles(0)
+            else:
+                # User wants to override default -
+                # do nothing!
+                pass
+
+    def OnButThisBackground(self, id, code):
+        if code == win32con.BN_CLICKED:
+            style = self.GetSelectedStyle()
+            bg = win32api.RGB(0xFF, 0xFF, 0xFF)
+            if style.background != CLR_INVALID:
+                bg = style.background
+            d = win32ui.CreateColorDialog(bg, 0, self)
+            if d.DoModal() == win32con.IDOK:
+                style.background = d.GetColor()
+                self.scintilla.ApplyFormattingStyles(0)
+            return 1
+
+    def OnButUseDefaultBackground(self, id, code):
+        if code == win32con.BN_CLICKED:
+            isDef = self.butIsDefaultBackground.GetCheck()
+            self.GetDlgItem(win32ui.IDC_BUTTON4).EnableWindow(not isDef)
+            if isDef:  # Being reset to the default color
+                style = self.GetSelectedStyle()
+                style.background = style.default_background
+                self.UpdateUIForStyle(style)
+                self.scintilla.ApplyFormattingStyles(0)
+            else:
+                # User wants to override default -
+                # do nothing!
+                pass
+
+    def OnListCommand(self, id, code):
+        if code == win32con.LBN_SELCHANGE:
+            style = self.GetSelectedStyle()
+            self.UpdateUIForStyle(style)
+        return 1
+
+    def UpdateUIForStyle(self, style):
+        format = style.format
+        sel = 0
+        for c in paletteVGA:
+            if format[4] == c[1]:
+                # 				print "Style", style.name, "is", c[0]
+                break
+            sel = sel + 1
+        else:
+            sel = -1
+        self.cbo.SetCurSel(sel)
+        self.butIsDefault.SetCheck(style.IsBasedOnDefault())
+        self.GetDlgItem(win32ui.IDC_BUTTON3).EnableWindow(not style.IsBasedOnDefault())
+
+        self.butIsDefaultBackground.SetCheck(
+            style.background == style.default_background
+        )
+        self.GetDlgItem(win32ui.IDC_BUTTON4).EnableWindow(
+            style.background != style.default_background
+        )
+
+        bold = format[1] & win32con.CFE_BOLD != 0
+        italic = format[1] & win32con.CFE_ITALIC != 0
+        self.cboBoldItalic.SetCurSel(bold * 2 + italic)
+
+    def OnStyleUIChanged(self, id, code):
+        if code in [win32con.BN_CLICKED, win32con.CBN_SELCHANGE]:
+            style = self.GetSelectedStyle()
+            self.ApplyUIFormatToStyle(style)
+            self.scintilla.ApplyFormattingStyles(0)
+            return 0
+        return 1
+
+    def ApplyUIFormatToStyle(self, style):
+        format = style.format
+        color = paletteVGA[self.cbo.GetCurSel()]
+        effect = 0
+        sel = self.cboBoldItalic.GetCurSel()
+        if sel == 0:
+            effect = 0
+        elif sel == 1:
+            effect = win32con.CFE_ITALIC
+        elif sel == 2:
+            effect = win32con.CFE_BOLD
+        else:
+            effect = win32con.CFE_BOLD | win32con.CFE_ITALIC
+        maskFlags = (
+            format[0] | win32con.CFM_COLOR | win32con.CFM_BOLD | win32con.CFM_ITALIC
+        )
+        style.format = (
+            maskFlags,
+            effect,
+            style.format[2],
+            style.format[3],
+            color[1],
+        ) + style.format[5:]
+
+    def OnOK(self):
+        self.scintilla._GetColorizer().SavePreferences()
+        return 1
+
+
+def test():
+    page = ColorEditorPropertyPage()
+    sheet = pywin.mfc.dialog.PropertySheet("Test")
+    sheet.AddPage(page)
+    sheet.CreateWindow()
diff --git a/lib/pythonwin/pywin/scintilla/control.py b/lib/pythonwin/pywin/scintilla/control.py
new file mode 100644
index 00000000..460b1686
--- /dev/null
+++ b/lib/pythonwin/pywin/scintilla/control.py
@@ -0,0 +1,569 @@
+# An Python interface to the Scintilla control.
+#
+# Exposes Python classes that allow you to use Scintilla as
+# a "standard" MFC edit control (eg, control.GetTextLength(), control.GetSel()
+# plus many Scintilla specific features (eg control.SCIAddStyledText())
+
+import array
+import os
+import struct
+
+import win32api
+import win32con
+import win32ui
+from pywin import default_scintilla_encoding
+from pywin.mfc import window
+
+from . import scintillacon
+
+# Load Scintilla.dll to get access to the control.
+# We expect to find this in the same directory as win32ui.pyd
+dllid = None
+if win32ui.debug:  # If running _d version of Pythonwin...
+    try:
+        dllid = win32api.LoadLibrary(
+            os.path.join(os.path.split(win32ui.__file__)[0], "Scintilla_d.DLL")
+        )
+    except (
+        win32api.error
+    ):  # Not there - we dont _need_ a debug ver, so ignore this error.
+        pass
+if dllid is None:
+    try:
+        dllid = win32api.LoadLibrary(
+            os.path.join(os.path.split(win32ui.__file__)[0], "Scintilla.DLL")
+        )
+    except win32api.error:
+        pass
+if dllid is None:
+    # Still not there - lets see if Windows can find it by searching?
+    dllid = win32api.LoadLibrary("Scintilla.DLL")
+
+# null_byte is str in py2k, bytes on py3k
+null_byte = "\0".encode("ascii")
+
+## These are from Richedit.h - need to add to win32con or commctrl
+EM_GETTEXTRANGE = 1099
+EM_EXLINEFROMCHAR = 1078
+EM_FINDTEXTEX = 1103
+EM_GETSELTEXT = 1086
+EM_EXSETSEL = win32con.WM_USER + 55
+
+
+class ScintillaNotification:
+    def __init__(self, **args):
+        self.__dict__.update(args)
+
+
+class ScintillaControlInterface:
+    def SCIUnpackNotifyMessage(self, msg):
+        format = "iiiiPiiiPPiiii"
+        bytes = win32ui.GetBytes(msg, struct.calcsize(format))
+        (
+            position,
+            ch,
+            modifiers,
+            modificationType,
+            text_ptr,
+            length,
+            linesAdded,
+            msg,
+            wParam,
+            lParam,
+            line,
+            foldLevelNow,
+            foldLevelPrev,
+            margin,
+        ) = struct.unpack(format, bytes)
+        return ScintillaNotification(
+            position=position,
+            ch=ch,
+            modifiers=modifiers,
+            modificationType=modificationType,
+            text_ptr=text_ptr,
+            length=length,
+            linesAdded=linesAdded,
+            msg=msg,
+            wParam=wParam,
+            lParam=lParam,
+            line=line,
+            foldLevelNow=foldLevelNow,
+            foldLevelPrev=foldLevelPrev,
+            margin=margin,
+        )
+
+    def SCIAddText(self, text):
+        self.SendMessage(
+            scintillacon.SCI_ADDTEXT, text.encode(default_scintilla_encoding)
+        )
+
+    def SCIAddStyledText(self, text, style=None):
+        # If style is None, text is assumed to be a "native" Scintilla buffer.
+        # If style is specified, text is a normal string, and the style is
+        # assumed to apply to the entire string.
+        if style is not None:
+            text = list(map(lambda char, style=style: char + chr(style), text))
+            text = "".join(text)
+        self.SendMessage(
+            scintillacon.SCI_ADDSTYLEDTEXT, text.encode(default_scintilla_encoding)
+        )
+
+    def SCIInsertText(self, text, pos=-1):
+        # SCIInsertText allows unicode or bytes - but if they are bytes,
+        # the caller must ensure it is encoded correctly.
+        if isinstance(text, str):
+            text = text.encode(default_scintilla_encoding)
+        self.SendScintilla(scintillacon.SCI_INSERTTEXT, pos, text + null_byte)
+
+    def SCISetSavePoint(self):
+        self.SendScintilla(scintillacon.SCI_SETSAVEPOINT)
+
+    def SCISetUndoCollection(self, collectFlag):
+        self.SendScintilla(scintillacon.SCI_SETUNDOCOLLECTION, collectFlag)
+
+    def SCIBeginUndoAction(self):
+        self.SendScintilla(scintillacon.SCI_BEGINUNDOACTION)
+
+    def SCIEndUndoAction(self):
+        self.SendScintilla(scintillacon.SCI_ENDUNDOACTION)
+
+    def SCIGetCurrentPos(self):
+        return self.SendScintilla(scintillacon.SCI_GETCURRENTPOS)
+
+    def SCIGetCharAt(self, pos):
+        # Must ensure char is unsigned!
+        return chr(self.SendScintilla(scintillacon.SCI_GETCHARAT, pos) & 0xFF)
+
+    def SCIGotoLine(self, line):
+        self.SendScintilla(scintillacon.SCI_GOTOLINE, line)
+
+    def SCIBraceMatch(self, pos, maxReStyle):
+        return self.SendScintilla(scintillacon.SCI_BRACEMATCH, pos, maxReStyle)
+
+    def SCIBraceHighlight(self, pos, posOpposite):
+        return self.SendScintilla(scintillacon.SCI_BRACEHIGHLIGHT, pos, posOpposite)
+
+    def SCIBraceBadHighlight(self, pos):
+        return self.SendScintilla(scintillacon.SCI_BRACEBADLIGHT, pos)
+
+    ####################################
+    # Styling
+    # 	def SCIColourise(self, start=0, end=-1):
+    #   NOTE - dependent on of we use builtin lexer, so handled below.
+    def SCIGetEndStyled(self):
+        return self.SendScintilla(scintillacon.SCI_GETENDSTYLED)
+
+    def SCIStyleSetFore(self, num, v):
+        return self.SendScintilla(scintillacon.SCI_STYLESETFORE, num, v)
+
+    def SCIStyleSetBack(self, num, v):
+        return self.SendScintilla(scintillacon.SCI_STYLESETBACK, num, v)
+
+    def SCIStyleSetEOLFilled(self, num, v):
+        return self.SendScintilla(scintillacon.SCI_STYLESETEOLFILLED, num, v)
+
+    def SCIStyleSetFont(self, num, name, characterset=0):
+        buff = (name + "\0").encode(default_scintilla_encoding)
+        self.SendScintilla(scintillacon.SCI_STYLESETFONT, num, buff)
+        self.SendScintilla(scintillacon.SCI_STYLESETCHARACTERSET, num, characterset)
+
+    def SCIStyleSetBold(self, num, bBold):
+        self.SendScintilla(scintillacon.SCI_STYLESETBOLD, num, bBold)
+
+    def SCIStyleSetItalic(self, num, bItalic):
+        self.SendScintilla(scintillacon.SCI_STYLESETITALIC, num, bItalic)
+
+    def SCIStyleSetSize(self, num, size):
+        self.SendScintilla(scintillacon.SCI_STYLESETSIZE, num, size)
+
+    def SCIGetViewWS(self):
+        return self.SendScintilla(scintillacon.SCI_GETVIEWWS)
+
+    def SCISetViewWS(self, val):
+        self.SendScintilla(scintillacon.SCI_SETVIEWWS, not (val == 0))
+        self.InvalidateRect()
+
+    def SCISetIndentationGuides(self, val):
+        self.SendScintilla(scintillacon.SCI_SETINDENTATIONGUIDES, val)
+
+    def SCIGetIndentationGuides(self):
+        return self.SendScintilla(scintillacon.SCI_GETINDENTATIONGUIDES)
+
+    def SCISetIndent(self, val):
+        self.SendScintilla(scintillacon.SCI_SETINDENT, val)
+
+    def SCIGetIndent(self, val):
+        return self.SendScintilla(scintillacon.SCI_GETINDENT)
+
+    def SCIGetViewEOL(self):
+        return self.SendScintilla(scintillacon.SCI_GETVIEWEOL)
+
+    def SCISetViewEOL(self, val):
+        self.SendScintilla(scintillacon.SCI_SETVIEWEOL, not (val == 0))
+        self.InvalidateRect()
+
+    def SCISetTabWidth(self, width):
+        self.SendScintilla(scintillacon.SCI_SETTABWIDTH, width, 0)
+
+    def SCIStartStyling(self, pos, mask):
+        self.SendScintilla(scintillacon.SCI_STARTSTYLING, pos, mask)
+
+    def SCISetStyling(self, pos, attr):
+        self.SendScintilla(scintillacon.SCI_SETSTYLING, pos, attr)
+
+    def SCISetStylingEx(self, ray):  # ray is an array.
+        address, length = ray.buffer_info()
+        self.SendScintilla(scintillacon.SCI_SETSTYLINGEX, length, address)
+
+    def SCIGetStyleAt(self, pos):
+        return self.SendScintilla(scintillacon.SCI_GETSTYLEAT, pos)
+
+    def SCISetMarginWidth(self, width):
+        self.SendScintilla(scintillacon.SCI_SETMARGINWIDTHN, 1, width)
+
+    def SCISetMarginWidthN(self, n, width):
+        self.SendScintilla(scintillacon.SCI_SETMARGINWIDTHN, n, width)
+
+    def SCISetFoldFlags(self, flags):
+        self.SendScintilla(scintillacon.SCI_SETFOLDFLAGS, flags)
+
+    # Markers
+    def SCIMarkerDefineAll(self, markerNum, markerType, fore, back):
+        self.SCIMarkerDefine(markerNum, markerType)
+        self.SCIMarkerSetFore(markerNum, fore)
+        self.SCIMarkerSetBack(markerNum, back)
+
+    def SCIMarkerDefine(self, markerNum, markerType):
+        self.SendScintilla(scintillacon.SCI_MARKERDEFINE, markerNum, markerType)
+
+    def SCIMarkerSetFore(self, markerNum, fore):
+        self.SendScintilla(scintillacon.SCI_MARKERSETFORE, markerNum, fore)
+
+    def SCIMarkerSetBack(self, markerNum, back):
+        self.SendScintilla(scintillacon.SCI_MARKERSETBACK, markerNum, back)
+
+    def SCIMarkerAdd(self, lineNo, markerNum):
+        self.SendScintilla(scintillacon.SCI_MARKERADD, lineNo, markerNum)
+
+    def SCIMarkerDelete(self, lineNo, markerNum):
+        self.SendScintilla(scintillacon.SCI_MARKERDELETE, lineNo, markerNum)
+
+    def SCIMarkerDeleteAll(self, markerNum=-1):
+        self.SendScintilla(scintillacon.SCI_MARKERDELETEALL, markerNum)
+
+    def SCIMarkerGet(self, lineNo):
+        return self.SendScintilla(scintillacon.SCI_MARKERGET, lineNo)
+
+    def SCIMarkerNext(self, lineNo, markerNum):
+        return self.SendScintilla(scintillacon.SCI_MARKERNEXT, lineNo, markerNum)
+
+    def SCICancel(self):
+        self.SendScintilla(scintillacon.SCI_CANCEL)
+
+    # AutoComplete
+    def SCIAutoCShow(self, text):
+        if type(text) in [type([]), type(())]:
+            text = " ".join(text)
+        buff = (text + "\0").encode(default_scintilla_encoding)
+        return self.SendScintilla(scintillacon.SCI_AUTOCSHOW, 0, buff)
+
+    def SCIAutoCCancel(self):
+        self.SendScintilla(scintillacon.SCI_AUTOCCANCEL)
+
+    def SCIAutoCActive(self):
+        return self.SendScintilla(scintillacon.SCI_AUTOCACTIVE)
+
+    def SCIAutoCComplete(self):
+        return self.SendScintilla(scintillacon.SCI_AUTOCCOMPLETE)
+
+    def SCIAutoCStops(self, stops):
+        buff = (stops + "\0").encode(default_scintilla_encoding)
+        self.SendScintilla(scintillacon.SCI_AUTOCSTOPS, 0, buff)
+
+    def SCIAutoCSetAutoHide(self, hide):
+        self.SendScintilla(scintillacon.SCI_AUTOCSETAUTOHIDE, hide)
+
+    def SCIAutoCSetFillups(self, fillups):
+        self.SendScintilla(scintillacon.SCI_AUTOCSETFILLUPS, fillups)
+
+    # Call tips
+    def SCICallTipShow(self, text, pos=-1):
+        if pos == -1:
+            pos = self.GetSel()[0]
+        buff = (text + "\0").encode(default_scintilla_encoding)
+        self.SendScintilla(scintillacon.SCI_CALLTIPSHOW, pos, buff)
+
+    def SCICallTipCancel(self):
+        self.SendScintilla(scintillacon.SCI_CALLTIPCANCEL)
+
+    def SCICallTipActive(self):
+        return self.SendScintilla(scintillacon.SCI_CALLTIPACTIVE)
+
+    def SCICallTipPosStart(self):
+        return self.SendScintilla(scintillacon.SCI_CALLTIPPOSSTART)
+
+    def SCINewline(self):
+        self.SendScintilla(scintillacon.SCI_NEWLINE)
+
+    # Lexer etc
+    def SCISetKeywords(self, keywords, kw_list_no=0):
+        buff = (keywords + "\0").encode(default_scintilla_encoding)
+        self.SendScintilla(scintillacon.SCI_SETKEYWORDS, kw_list_no, buff)
+
+    def SCISetProperty(self, name, value):
+        name_buff = array.array("b", (name + "\0").encode(default_scintilla_encoding))
+        val_buff = array.array(
+            "b", (str(value) + "\0").encode(default_scintilla_encoding)
+        )
+        address_name_buffer = name_buff.buffer_info()[0]
+        address_val_buffer = val_buff.buffer_info()[0]
+        self.SendScintilla(
+            scintillacon.SCI_SETPROPERTY, address_name_buffer, address_val_buffer
+        )
+
+    def SCISetStyleBits(self, nbits):
+        self.SendScintilla(scintillacon.SCI_SETSTYLEBITS, nbits)
+
+    # Folding
+    def SCIGetFoldLevel(self, lineno):
+        return self.SendScintilla(scintillacon.SCI_GETFOLDLEVEL, lineno)
+
+    def SCIToggleFold(self, lineno):
+        return self.SendScintilla(scintillacon.SCI_TOGGLEFOLD, lineno)
+
+    def SCIEnsureVisible(self, lineno):
+        self.SendScintilla(scintillacon.SCI_ENSUREVISIBLE, lineno)
+
+    def SCIGetFoldExpanded(self, lineno):
+        return self.SendScintilla(scintillacon.SCI_GETFOLDEXPANDED, lineno)
+
+    # right edge
+    def SCISetEdgeColumn(self, edge):
+        self.SendScintilla(scintillacon.SCI_SETEDGECOLUMN, edge)
+
+    def SCIGetEdgeColumn(self):
+        return self.SendScintilla(scintillacon.SCI_GETEDGECOLUMN)
+
+    def SCISetEdgeMode(self, mode):
+        self.SendScintilla(scintillacon.SCI_SETEDGEMODE, mode)
+
+    def SCIGetEdgeMode(self):
+        return self.SendScintilla(scintillacon.SCI_GETEDGEMODE)
+
+    def SCISetEdgeColor(self, color):
+        self.SendScintilla(scintillacon.SCI_SETEDGECOLOUR, color)
+
+    def SCIGetEdgeColor(self):
+        return self.SendScintilla(scintillacon.SCI_GETEDGECOLOR)
+
+    # Multi-doc
+    def SCIGetDocPointer(self):
+        return self.SendScintilla(scintillacon.SCI_GETDOCPOINTER)
+
+    def SCISetDocPointer(self, p):
+        return self.SendScintilla(scintillacon.SCI_SETDOCPOINTER, 0, p)
+
+    def SCISetWrapMode(self, mode):
+        return self.SendScintilla(scintillacon.SCI_SETWRAPMODE, mode)
+
+    def SCIGetWrapMode(self):
+        return self.SendScintilla(scintillacon.SCI_GETWRAPMODE)
+
+
+class CScintillaEditInterface(ScintillaControlInterface):
+    def close(self):
+        self.colorizer = None
+
+    def Clear(self):
+        self.SendScintilla(win32con.WM_CLEAR)
+
+    def FindText(self, flags, range, findText):
+        """LPARAM for EM_FINDTEXTEX:
+                typedef struct _findtextex {
+                CHARRANGE chrg;
+                LPCTSTR lpstrText;
+                CHARRANGE chrgText;} FINDTEXTEX;
+        typedef struct _charrange {
+                LONG cpMin;
+                LONG cpMax;} CHARRANGE;
+        """
+        findtextex_fmt = "llPll"
+        ## Scintilla does not handle unicode in EM_FINDTEXT msg (FINDTEXTEX struct)
+        txt_buff = (findText + "\0").encode(default_scintilla_encoding)
+        txt_array = array.array("b", txt_buff)
+        ft_buff = struct.pack(
+            findtextex_fmt, range[0], range[1], txt_array.buffer_info()[0], 0, 0
+        )
+        ft_array = array.array("b", ft_buff)
+        rc = self.SendScintilla(EM_FINDTEXTEX, flags, ft_array.buffer_info()[0])
+        ftUnpacked = struct.unpack(findtextex_fmt, ft_array)
+        return rc, (ftUnpacked[3], ftUnpacked[4])
+
+    def GetSel(self):
+        currentPos = self.SendScintilla(scintillacon.SCI_GETCURRENTPOS)
+        anchorPos = self.SendScintilla(scintillacon.SCI_GETANCHOR)
+        if currentPos < anchorPos:
+            return (currentPos, anchorPos)
+        else:
+            return (anchorPos, currentPos)
+        return currentPos
+
+    def GetSelText(self):
+        start, end = self.GetSel()
+        txtBuf = array.array("b", null_byte * (end - start + 1))
+        addressTxtBuf = txtBuf.buffer_info()[0]
+        # EM_GETSELTEXT is documented as returning the number of chars
+        # not including the NULL, but scintilla includes the NULL.  A
+        # quick glance at the scintilla impl doesn't make this
+        # obvious - the NULL is included in the 'selection' object
+        # and reflected in the length of that 'selection' object.
+        # I expect that is a bug in scintilla and may be fixed by now,
+        # but we just blindly assume that the last char is \0 and
+        # strip it.
+        self.SendScintilla(EM_GETSELTEXT, 0, addressTxtBuf)
+        return txtBuf.tobytes()[:-1].decode(default_scintilla_encoding)
+
+    def SetSel(self, start=0, end=None):
+        if type(start) == type(()):
+            assert (
+                end is None
+            ), "If you pass a point in the first param, the second must be None"
+            start, end = start
+        elif end is None:
+            end = start
+        if start < 0:
+            start = self.GetTextLength()
+        if end < 0:
+            end = self.GetTextLength()
+        assert start <= self.GetTextLength(), "The start postion is invalid (%d/%d)" % (
+            start,
+            self.GetTextLength(),
+        )
+        assert end <= self.GetTextLength(), "The end postion is invalid (%d/%d)" % (
+            end,
+            self.GetTextLength(),
+        )
+        cr = struct.pack("ll", start, end)
+        crBuff = array.array("b", cr)
+        addressCrBuff = crBuff.buffer_info()[0]
+        rc = self.SendScintilla(EM_EXSETSEL, 0, addressCrBuff)
+
+    def GetLineCount(self):
+        return self.SendScintilla(win32con.EM_GETLINECOUNT)
+
+    def LineFromChar(self, charPos=-1):
+        if charPos == -1:
+            charPos = self.GetSel()[0]
+        assert (
+            charPos >= 0 and charPos <= self.GetTextLength()
+        ), "The charPos postion (%s) is invalid (max=%s)" % (
+            charPos,
+            self.GetTextLength(),
+        )
+        # return self.SendScintilla(EM_EXLINEFROMCHAR, charPos)
+        # EM_EXLINEFROMCHAR puts charPos in lParam, not wParam
+        return self.SendScintilla(EM_EXLINEFROMCHAR, 0, charPos)
+
+    def LineIndex(self, line):
+        return self.SendScintilla(win32con.EM_LINEINDEX, line)
+
+    def ScrollCaret(self):
+        return self.SendScintilla(win32con.EM_SCROLLCARET)
+
+    def GetCurLineNumber(self):
+        return self.LineFromChar(self.SCIGetCurrentPos())
+
+    def GetTextLength(self):
+        return self.SendScintilla(scintillacon.SCI_GETTEXTLENGTH)
+
+    def GetTextRange(self, start=0, end=-1, decode=True):
+        if end == -1:
+            end = self.SendScintilla(scintillacon.SCI_GETTEXTLENGTH)
+        assert end >= start, "Negative index requested (%d/%d)" % (start, end)
+        assert (
+            start >= 0 and start <= self.GetTextLength()
+        ), "The start postion is invalid"
+        assert end >= 0 and end <= self.GetTextLength(), "The end postion is invalid"
+        initer = null_byte * (end - start + 1)
+        buff = array.array("b", initer)
+        addressBuffer = buff.buffer_info()[0]
+        tr = struct.pack("llP", start, end, addressBuffer)
+        trBuff = array.array("b", tr)
+        addressTrBuff = trBuff.buffer_info()[0]
+        num_bytes = self.SendScintilla(EM_GETTEXTRANGE, 0, addressTrBuff)
+        ret = buff.tobytes()[:num_bytes]
+        if decode:
+            ret = ret.decode(default_scintilla_encoding)
+        return ret
+
+    def ReplaceSel(self, str):
+        buff = (str + "\0").encode(default_scintilla_encoding)
+        self.SendScintilla(scintillacon.SCI_REPLACESEL, 0, buff)
+
+    def GetLine(self, line=-1):
+        if line == -1:
+            line = self.GetCurLineNumber()
+        start = self.LineIndex(line)
+        end = self.LineIndex(line + 1)
+        return self.GetTextRange(start, end)
+
+    def SetReadOnly(self, flag=1):
+        return self.SendScintilla(win32con.EM_SETREADONLY, flag)
+
+    def LineScroll(self, lines, cols=0):
+        return self.SendScintilla(win32con.EM_LINESCROLL, cols, lines)
+
+    def GetFirstVisibleLine(self):
+        return self.SendScintilla(win32con.EM_GETFIRSTVISIBLELINE)
+
+    def SetWordWrap(self, mode):
+        if mode != win32ui.CRichEditView_WrapNone:
+            raise ValueError("We dont support word-wrap (I dont think :-)")
+
+
+class CScintillaColorEditInterface(CScintillaEditInterface):
+    ################################
+    # Plug-in colorizer support
+    def _GetColorizer(self):
+        if not hasattr(self, "colorizer"):
+            self.colorizer = self._MakeColorizer()
+        return self.colorizer
+
+    def _MakeColorizer(self):
+        # Give parent a chance to hook.
+        parent_func = getattr(self.GetParentFrame(), "_MakeColorizer", None)
+        if parent_func is not None:
+            return parent_func()
+        from . import formatter
+
+        ##		return formatter.PythonSourceFormatter(self)
+        return formatter.BuiltinPythonSourceFormatter(self)
+
+    def Colorize(self, start=0, end=-1):
+        c = self._GetColorizer()
+        if c is not None:
+            c.Colorize(start, end)
+
+    def ApplyFormattingStyles(self, bReload=1):
+        c = self._GetColorizer()
+        if c is not None:
+            c.ApplyFormattingStyles(bReload)
+
+    # The Parent window will normally hook
+    def HookFormatter(self, parent=None):
+        c = self._GetColorizer()
+        if c is not None:  # No need if we have no color!
+            c.HookFormatter(parent)
+
+
+class CScintillaEdit(window.Wnd, CScintillaColorEditInterface):
+    def __init__(self, wnd=None):
+        if wnd is None:
+            wnd = win32ui.CreateWnd()
+        window.Wnd.__init__(self, wnd)
+
+    def SendScintilla(self, msg, w=0, l=0):
+        return self.SendMessage(msg, w, l)
+
+    def CreateWindow(self, style, rect, parent, id):
+        self._obj_.CreateWindow("Scintilla", "Scintilla", style, rect, parent, id, None)
diff --git a/lib/pythonwin/pywin/scintilla/document.py b/lib/pythonwin/pywin/scintilla/document.py
new file mode 100644
index 00000000..cddb442c
--- /dev/null
+++ b/lib/pythonwin/pywin/scintilla/document.py
@@ -0,0 +1,312 @@
+import codecs
+import re
+import string
+
+import win32con
+import win32ui
+from pywin import default_scintilla_encoding
+from pywin.mfc import docview
+
+from . import scintillacon
+
+crlf_bytes = "\r\n".encode("ascii")
+lf_bytes = "\n".encode("ascii")
+
+# re from pep263 - but we use it both on bytes and strings.
+re_encoding_bytes = re.compile("coding[:=]\s*([-\w.]+)".encode("ascii"))
+re_encoding_text = re.compile("coding[:=]\s*([-\w.]+)")
+
+ParentScintillaDocument = docview.Document
+
+
+class CScintillaDocument(ParentScintillaDocument):
+    "A SyntEdit document."
+
+    def __init__(self, *args):
+        self.bom = None  # the BOM, if any, read from the file.
+        # the encoding we detected from the source.  Might have
+        # detected via the BOM or an encoding decl.  Note that in
+        # the latter case (ie, while self.bom is None), it can't be
+        # trusted - the user may have edited the encoding decl between
+        # open and save.
+        self.source_encoding = None
+        ParentScintillaDocument.__init__(self, *args)
+
+    def DeleteContents(self):
+        pass
+
+    def OnOpenDocument(self, filename):
+        # init data members
+        # print "Opening", filename
+        self.SetPathName(filename)  # Must set this early!
+        try:
+            # load the text as binary we can get smart
+            # about detecting any existing EOL conventions.
+            f = open(filename, "rb")
+            try:
+                self._LoadTextFromFile(f)
+            finally:
+                f.close()
+        except IOError:
+            rc = win32ui.MessageBox(
+                "Could not load the file from %s\n\nDo you want to create a new file?"
+                % filename,
+                "Pythonwin",
+                win32con.MB_YESNO | win32con.MB_ICONWARNING,
+            )
+            if rc == win32con.IDNO:
+                return 0
+            assert rc == win32con.IDYES, rc
+            try:
+                f = open(filename, "wb+")
+                try:
+                    self._LoadTextFromFile(f)
+                finally:
+                    f.close()
+            except IOError as e:
+                rc = win32ui.MessageBox("Cannot create the file %s" % filename)
+        return 1
+
+    def SaveFile(self, fileName, encoding=None):
+        view = self.GetFirstView()
+        ok = view.SaveTextFile(fileName, encoding=encoding)
+        if ok:
+            view.SCISetSavePoint()
+        return ok
+
+    def ApplyFormattingStyles(self):
+        self._ApplyOptionalToViews("ApplyFormattingStyles")
+
+    # #####################
+    # File related functions
+    # Helper to transfer text from the MFC document to the control.
+    def _LoadTextFromFile(self, f):
+        # detect EOL mode - we don't support \r only - so find the
+        # first '\n' and guess based on the char before.
+        l = f.readline()
+        l2 = f.readline()
+        # If line ends with \r\n or has no line ending, use CRLF.
+        if l.endswith(crlf_bytes) or not l.endswith(lf_bytes):
+            eol_mode = scintillacon.SC_EOL_CRLF
+        else:
+            eol_mode = scintillacon.SC_EOL_LF
+
+        # Detect the encoding - first look for a BOM, and if not found,
+        # look for a pep263 encoding declaration.
+        for bom, encoding in (
+            (codecs.BOM_UTF8, "utf8"),
+            (codecs.BOM_UTF16_LE, "utf_16_le"),
+            (codecs.BOM_UTF16_BE, "utf_16_be"),
+        ):
+            if l.startswith(bom):
+                self.bom = bom
+                self.source_encoding = encoding
+                l = l[len(bom) :]  # remove it.
+                break
+        else:
+            # no bom detected - look for pep263 encoding decl.
+            for look in (l, l2):
+                # Note we are looking at raw bytes here: so
+                # both the re itself uses bytes and the result
+                # is bytes - but we need the result as a string.
+                match = re_encoding_bytes.search(look)
+                if match is not None:
+                    self.source_encoding = match.group(1).decode("ascii")
+                    break
+
+        # reading by lines would be too slow?  Maybe we can use the
+        # incremental encoders? For now just stick with loading the
+        # entire file in memory.
+        text = l + l2 + f.read()
+
+        # Translate from source encoding to UTF-8 bytes for Scintilla
+        source_encoding = self.source_encoding
+        # If we don't know an encoding, try utf-8 - if that fails we will
+        # fallback to latin-1 to treat it as bytes...
+        if source_encoding is None:
+            source_encoding = "utf-8"
+        # we could optimize this by avoiding utf8 to-ing and from-ing,
+        # but then we would lose the ability to handle invalid utf8
+        # (and even then, the use of encoding aliases makes this tricky)
+        # To create an invalid utf8 file:
+        # >>> open(filename, "wb").write(codecs.BOM_UTF8+"bad \xa9har\r\n")
+        try:
+            dec = text.decode(source_encoding)
+        except UnicodeError:
+            print(
+                "WARNING: Failed to decode bytes from '%s' encoding - treating as latin1"
+                % source_encoding
+            )
+            dec = text.decode("latin1")
+        except LookupError:
+            print(
+                "WARNING: Invalid encoding '%s' specified - treating as latin1"
+                % source_encoding
+            )
+            dec = text.decode("latin1")
+        # and put it back as utf8 - this shouldn't fail.
+        text = dec.encode(default_scintilla_encoding)
+
+        view = self.GetFirstView()
+        if view.IsWindow():
+            # Turn off undo collection while loading
+            view.SendScintilla(scintillacon.SCI_SETUNDOCOLLECTION, 0, 0)
+            # Make sure the control isnt read-only
+            view.SetReadOnly(0)
+            view.SendScintilla(scintillacon.SCI_CLEARALL)
+            view.SendMessage(scintillacon.SCI_ADDTEXT, text)
+            view.SendScintilla(scintillacon.SCI_SETUNDOCOLLECTION, 1, 0)
+            view.SendScintilla(win32con.EM_EMPTYUNDOBUFFER, 0, 0)
+            # set EOL mode
+            view.SendScintilla(scintillacon.SCI_SETEOLMODE, eol_mode)
+
+    def _SaveTextToFile(self, view, filename, encoding=None):
+        s = view.GetTextRange()  # already decoded from scintilla's encoding
+        source_encoding = encoding
+        if source_encoding is None:
+            if self.bom:
+                source_encoding = self.source_encoding
+            else:
+                # no BOM - look for an encoding.
+                bits = re.split("[\r\n]+", s, 3)
+                for look in bits[:-1]:
+                    match = re_encoding_text.search(look)
+                    if match is not None:
+                        source_encoding = match.group(1)
+                        self.source_encoding = source_encoding
+                        break
+
+            if source_encoding is None:
+                source_encoding = "utf-8"
+
+        ## encode data before opening file so script is not lost if encoding fails
+        file_contents = s.encode(source_encoding)
+        # Open in binary mode as scintilla itself ensures the
+        # line endings are already appropriate
+        f = open(filename, "wb")
+        try:
+            if self.bom:
+                f.write(self.bom)
+            f.write(file_contents)
+        finally:
+            f.close()
+        self.SetModifiedFlag(0)
+
+    def FinalizeViewCreation(self, view):
+        pass
+
+    def HookViewNotifications(self, view):
+        parent = view.GetParentFrame()
+        parent.HookNotify(
+            ViewNotifyDelegate(self, "OnBraceMatch"), scintillacon.SCN_CHECKBRACE
+        )
+        parent.HookNotify(
+            ViewNotifyDelegate(self, "OnMarginClick"), scintillacon.SCN_MARGINCLICK
+        )
+        parent.HookNotify(
+            ViewNotifyDelegate(self, "OnNeedShown"), scintillacon.SCN_NEEDSHOWN
+        )
+
+        parent.HookNotify(
+            DocumentNotifyDelegate(self, "OnSavePointReached"),
+            scintillacon.SCN_SAVEPOINTREACHED,
+        )
+        parent.HookNotify(
+            DocumentNotifyDelegate(self, "OnSavePointLeft"),
+            scintillacon.SCN_SAVEPOINTLEFT,
+        )
+        parent.HookNotify(
+            DocumentNotifyDelegate(self, "OnModifyAttemptRO"),
+            scintillacon.SCN_MODIFYATTEMPTRO,
+        )
+        # Tell scintilla what characters should abort auto-complete.
+        view.SCIAutoCStops(string.whitespace + "()[]:;+-/*=\\?'!#@$%^&,<>\"'|")
+
+        if view != self.GetFirstView():
+            view.SCISetDocPointer(self.GetFirstView().SCIGetDocPointer())
+
+    def OnSavePointReached(self, std, extra):
+        self.SetModifiedFlag(0)
+
+    def OnSavePointLeft(self, std, extra):
+        self.SetModifiedFlag(1)
+
+    def OnModifyAttemptRO(self, std, extra):
+        self.MakeDocumentWritable()
+
+    # All Marker functions are 1 based.
+    def MarkerAdd(self, lineNo, marker):
+        self.GetEditorView().SCIMarkerAdd(lineNo - 1, marker)
+
+    def MarkerCheck(self, lineNo, marker):
+        v = self.GetEditorView()
+        lineNo = lineNo - 1  # Make 0 based
+        markerState = v.SCIMarkerGet(lineNo)
+        return markerState & (1 << marker) != 0
+
+    def MarkerToggle(self, lineNo, marker):
+        v = self.GetEditorView()
+        if self.MarkerCheck(lineNo, marker):
+            v.SCIMarkerDelete(lineNo - 1, marker)
+        else:
+            v.SCIMarkerAdd(lineNo - 1, marker)
+
+    def MarkerDelete(self, lineNo, marker):
+        self.GetEditorView().SCIMarkerDelete(lineNo - 1, marker)
+
+    def MarkerDeleteAll(self, marker):
+        self.GetEditorView().SCIMarkerDeleteAll(marker)
+
+    def MarkerGetNext(self, lineNo, marker):
+        return self.GetEditorView().SCIMarkerNext(lineNo - 1, 1 << marker) + 1
+
+    def MarkerAtLine(self, lineNo, marker):
+        markerState = self.GetEditorView().SCIMarkerGet(lineNo - 1)
+        return markerState & (1 << marker)
+
+    # Helper for reflecting functions to views.
+    def _ApplyToViews(self, funcName, *args):
+        for view in self.GetAllViews():
+            func = getattr(view, funcName)
+            func(*args)
+
+    def _ApplyOptionalToViews(self, funcName, *args):
+        for view in self.GetAllViews():
+            func = getattr(view, funcName, None)
+            if func is not None:
+                func(*args)
+
+    def GetEditorView(self):
+        # Find the first frame with a view,
+        # then ask it to give the editor view
+        # as it knows which one is "active"
+        try:
+            frame_gev = self.GetFirstView().GetParentFrame().GetEditorView
+        except AttributeError:
+            return self.GetFirstView()
+        return frame_gev()
+
+
+# Delegate to the correct view, based on the control that sent it.
+class ViewNotifyDelegate:
+    def __init__(self, doc, name):
+        self.doc = doc
+        self.name = name
+
+    def __call__(self, std, extra):
+        (hwndFrom, idFrom, code) = std
+        for v in self.doc.GetAllViews():
+            if v.GetSafeHwnd() == hwndFrom:
+                return getattr(v, self.name)(*(std, extra))
+
+
+# Delegate to the document, but only from a single view (as each view sends it seperately)
+class DocumentNotifyDelegate:
+    def __init__(self, doc, name):
+        self.doc = doc
+        self.delegate = getattr(doc, name)
+
+    def __call__(self, std, extra):
+        (hwndFrom, idFrom, code) = std
+        if hwndFrom == self.doc.GetEditorView().GetSafeHwnd():
+            self.delegate(*(std, extra))
diff --git a/lib/pythonwin/pywin/scintilla/find.py b/lib/pythonwin/pywin/scintilla/find.py
new file mode 100644
index 00000000..e1d21a5b
--- /dev/null
+++ b/lib/pythonwin/pywin/scintilla/find.py
@@ -0,0 +1,510 @@
+# find.py - Find and Replace
+import afxres
+import win32api
+import win32con
+import win32ui
+from pywin.framework import scriptutils
+from pywin.mfc import dialog
+
+FOUND_NOTHING = 0
+FOUND_NORMAL = 1
+FOUND_LOOPED_BACK = 2
+FOUND_NEXT_FILE = 3
+
+
+class SearchParams:
+    def __init__(self, other=None):
+        if other is None:
+            self.__dict__["findText"] = ""
+            self.__dict__["replaceText"] = ""
+            self.__dict__["matchCase"] = 0
+            self.__dict__["matchWords"] = 0
+            self.__dict__["acrossFiles"] = 0
+            self.__dict__["remember"] = 1
+            self.__dict__["sel"] = (-1, -1)
+            self.__dict__["keepDialogOpen"] = 0
+        else:
+            self.__dict__.update(other.__dict__)
+
+    # Helper so we cant misspell attributes :-)
+    def __setattr__(self, attr, val):
+        if not hasattr(self, attr):
+            raise AttributeError(attr)
+        self.__dict__[attr] = val
+
+
+curDialog = None
+lastSearch = defaultSearch = SearchParams()
+searchHistory = []
+
+
+def ShowFindDialog():
+    _ShowDialog(FindDialog)
+
+
+def ShowReplaceDialog():
+    _ShowDialog(ReplaceDialog)
+
+
+def _ShowDialog(dlgClass):
+    global curDialog
+    if curDialog is not None:
+        if curDialog.__class__ != dlgClass:
+            curDialog.DestroyWindow()
+            curDialog = None
+        else:
+            curDialog.SetFocus()
+    if curDialog is None:
+        curDialog = dlgClass()
+        curDialog.CreateWindow()
+
+
+def FindNext():
+    params = SearchParams(lastSearch)
+    params.sel = (-1, -1)
+    if not params.findText:
+        ShowFindDialog()
+    else:
+        return _FindIt(None, params)
+
+
+def _GetControl(control=None):
+    if control is None:
+        control = scriptutils.GetActiveEditControl()
+    return control
+
+
+def _FindIt(control, searchParams):
+    global lastSearch, defaultSearch
+    control = _GetControl(control)
+    if control is None:
+        return FOUND_NOTHING
+
+    # Move to the next char, so we find the next one.
+    flags = 0
+    if searchParams.matchWords:
+        flags = flags | win32con.FR_WHOLEWORD
+    if searchParams.matchCase:
+        flags = flags | win32con.FR_MATCHCASE
+    if searchParams.sel == (-1, -1):
+        sel = control.GetSel()
+        # If the position is the same as we found last time,
+        # then we assume it is a "FindNext"
+        if sel == lastSearch.sel:
+            sel = sel[0] + 1, sel[0] + 1
+    else:
+        sel = searchParams.sel
+
+    if sel[0] == sel[1]:
+        sel = sel[0], control.GetTextLength()
+
+    rc = FOUND_NOTHING
+    # (Old edit control will fail here!)
+    posFind, foundSel = control.FindText(flags, sel, searchParams.findText)
+    lastSearch = SearchParams(searchParams)
+    if posFind >= 0:
+        rc = FOUND_NORMAL
+        lineno = control.LineFromChar(posFind)
+        control.SCIEnsureVisible(lineno)
+        control.SetSel(foundSel)
+        control.SetFocus()
+        win32ui.SetStatusText(win32ui.LoadString(afxres.AFX_IDS_IDLEMESSAGE))
+    if rc == FOUND_NOTHING and lastSearch.acrossFiles:
+        # Loop around all documents.  First find this document.
+        try:
+            try:
+                doc = control.GetDocument()
+            except AttributeError:
+                try:
+                    doc = control.GetParent().GetDocument()
+                except AttributeError:
+                    print("Cant find a document for the control!")
+                    doc = None
+            if doc is not None:
+                template = doc.GetDocTemplate()
+                alldocs = template.GetDocumentList()
+                mypos = lookpos = alldocs.index(doc)
+                while 1:
+                    lookpos = (lookpos + 1) % len(alldocs)
+                    if lookpos == mypos:
+                        break
+                    view = alldocs[lookpos].GetFirstView()
+                    posFind, foundSel = view.FindText(
+                        flags, (0, view.GetTextLength()), searchParams.findText
+                    )
+                    if posFind >= 0:
+                        nChars = foundSel[1] - foundSel[0]
+                        lineNo = view.LineFromChar(posFind)  # zero based.
+                        lineStart = view.LineIndex(lineNo)
+                        colNo = posFind - lineStart  # zero based.
+                        scriptutils.JumpToDocument(
+                            alldocs[lookpos].GetPathName(),
+                            lineNo + 1,
+                            colNo + 1,
+                            nChars,
+                        )
+                        rc = FOUND_NEXT_FILE
+                        break
+        except win32ui.error:
+            pass
+    if rc == FOUND_NOTHING:
+        # Loop around this control - attempt to find from the start of the control.
+        posFind, foundSel = control.FindText(
+            flags, (0, sel[0] - 1), searchParams.findText
+        )
+        if posFind >= 0:
+            control.SCIEnsureVisible(control.LineFromChar(foundSel[0]))
+            control.SetSel(foundSel)
+            control.SetFocus()
+            win32ui.SetStatusText("Not found! Searching from the top of the file.")
+            rc = FOUND_LOOPED_BACK
+        else:
+            lastSearch.sel = -1, -1
+            win32ui.SetStatusText("Can not find '%s'" % searchParams.findText)
+
+    if rc != FOUND_NOTHING:
+        lastSearch.sel = foundSel
+
+    if lastSearch.remember:
+        defaultSearch = lastSearch
+
+        # track search history
+        try:
+            ix = searchHistory.index(searchParams.findText)
+        except ValueError:
+            if len(searchHistory) > 50:
+                searchHistory[50:] = []
+        else:
+            del searchHistory[ix]
+        searchHistory.insert(0, searchParams.findText)
+
+    return rc
+
+
+def _ReplaceIt(control):
+    control = _GetControl(control)
+    statusText = "Can not find '%s'." % lastSearch.findText
+    rc = FOUND_NOTHING
+    if control is not None and lastSearch.sel != (-1, -1):
+        control.ReplaceSel(lastSearch.replaceText)
+        rc = FindNext()
+        if rc != FOUND_NOTHING:
+            statusText = win32ui.LoadString(afxres.AFX_IDS_IDLEMESSAGE)
+    win32ui.SetStatusText(statusText)
+    return rc
+
+
+class FindReplaceDialog(dialog.Dialog):
+    def __init__(self):
+        dialog.Dialog.__init__(self, self._GetDialogTemplate())
+        self.HookCommand(self.OnFindNext, 109)
+
+    def OnInitDialog(self):
+        self.editFindText = self.GetDlgItem(102)
+        self.butMatchWords = self.GetDlgItem(105)
+        self.butMatchCase = self.GetDlgItem(107)
+        self.butKeepDialogOpen = self.GetDlgItem(115)
+        self.butAcrossFiles = self.GetDlgItem(116)
+        self.butRemember = self.GetDlgItem(117)
+
+        self.editFindText.SetWindowText(defaultSearch.findText)
+        control = _GetControl()
+        # _GetControl only gets normal MDI windows; if the interactive
+        # window is docked and no document open, we get None.
+        if control:
+            # If we have a selection, default to that.
+            sel = control.GetSelText()
+            if len(sel) != 0:
+                self.editFindText.SetWindowText(sel)
+                if defaultSearch.remember:
+                    defaultSearch.findText = sel
+        for hist in searchHistory:
+            self.editFindText.AddString(hist)
+
+        if hasattr(self.editFindText, "SetEditSel"):
+            self.editFindText.SetEditSel(0, -1)
+        else:
+            self.editFindText.SetSel(0, -1)
+        self.butMatchWords.SetCheck(defaultSearch.matchWords)
+        self.butMatchCase.SetCheck(defaultSearch.matchCase)
+        self.butKeepDialogOpen.SetCheck(defaultSearch.keepDialogOpen)
+        self.butAcrossFiles.SetCheck(defaultSearch.acrossFiles)
+        self.butRemember.SetCheck(defaultSearch.remember)
+        return dialog.Dialog.OnInitDialog(self)
+
+    def OnDestroy(self, msg):
+        global curDialog
+        curDialog = None
+        return dialog.Dialog.OnDestroy(self, msg)
+
+    def DoFindNext(self):
+        params = SearchParams()
+        params.findText = self.editFindText.GetWindowText()
+        params.matchCase = self.butMatchCase.GetCheck()
+        params.matchWords = self.butMatchWords.GetCheck()
+        params.acrossFiles = self.butAcrossFiles.GetCheck()
+        params.remember = self.butRemember.GetCheck()
+        return _FindIt(None, params)
+
+    def OnFindNext(self, id, code):
+        if code != 0:  # BN_CLICKED
+            # 3d controls (python.exe + start_pythonwin.pyw) send
+            # other notification codes
+            return 1  #
+        if not self.editFindText.GetWindowText():
+            win32api.MessageBeep()
+            return 1
+        if self.DoFindNext() != FOUND_NOTHING:
+            if not self.butKeepDialogOpen.GetCheck():
+                self.DestroyWindow()
+
+
+class FindDialog(FindReplaceDialog):
+    def _GetDialogTemplate(self):
+        style = (
+            win32con.DS_MODALFRAME
+            | win32con.WS_POPUP
+            | win32con.WS_VISIBLE
+            | win32con.WS_CAPTION
+            | win32con.WS_SYSMENU
+            | win32con.DS_SETFONT
+        )
+        visible = win32con.WS_CHILD | win32con.WS_VISIBLE
+        dt = [
+            ["Find", (0, 2, 240, 75), style, None, (8, "MS Sans Serif")],
+            ["Static", "Fi&nd What:", 101, (5, 8, 40, 10), visible],
+            [
+                "ComboBox",
+                "",
+                102,
+                (50, 7, 120, 120),
+                visible
+                | win32con.WS_BORDER
+                | win32con.WS_TABSTOP
+                | win32con.WS_VSCROLL
+                | win32con.CBS_DROPDOWN
+                | win32con.CBS_AUTOHSCROLL,
+            ],
+            [
+                "Button",
+                "Match &whole word only",
+                105,
+                (5, 23, 100, 10),
+                visible | win32con.BS_AUTOCHECKBOX | win32con.WS_TABSTOP,
+            ],
+            [
+                "Button",
+                "Match &case",
+                107,
+                (5, 33, 100, 10),
+                visible | win32con.BS_AUTOCHECKBOX | win32con.WS_TABSTOP,
+            ],
+            [
+                "Button",
+                "Keep &dialog open",
+                115,
+                (5, 43, 100, 10),
+                visible | win32con.BS_AUTOCHECKBOX | win32con.WS_TABSTOP,
+            ],
+            [
+                "Button",
+                "Across &open files",
+                116,
+                (5, 52, 100, 10),
+                visible | win32con.BS_AUTOCHECKBOX | win32con.WS_TABSTOP,
+            ],
+            [
+                "Button",
+                "&Remember as default search",
+                117,
+                (5, 61, 150, 10),
+                visible | win32con.BS_AUTOCHECKBOX | win32con.WS_TABSTOP,
+            ],
+            [
+                "Button",
+                "&Find Next",
+                109,
+                (185, 5, 50, 14),
+                visible | win32con.BS_DEFPUSHBUTTON | win32con.WS_TABSTOP,
+            ],
+            [
+                "Button",
+                "Cancel",
+                win32con.IDCANCEL,
+                (185, 23, 50, 14),
+                visible | win32con.WS_TABSTOP,
+            ],
+        ]
+        return dt
+
+
+class ReplaceDialog(FindReplaceDialog):
+    def _GetDialogTemplate(self):
+        style = (
+            win32con.DS_MODALFRAME
+            | win32con.WS_POPUP
+            | win32con.WS_VISIBLE
+            | win32con.WS_CAPTION
+            | win32con.WS_SYSMENU
+            | win32con.DS_SETFONT
+        )
+        visible = win32con.WS_CHILD | win32con.WS_VISIBLE
+        dt = [
+            ["Replace", (0, 2, 240, 95), style, 0, (8, "MS Sans Serif")],
+            ["Static", "Fi&nd What:", 101, (5, 8, 40, 10), visible],
+            [
+                "ComboBox",
+                "",
+                102,
+                (60, 7, 110, 120),
+                visible
+                | win32con.WS_BORDER
+                | win32con.WS_TABSTOP
+                | win32con.WS_VSCROLL
+                | win32con.CBS_DROPDOWN
+                | win32con.CBS_AUTOHSCROLL,
+            ],
+            ["Static", "Re&place with:", 103, (5, 25, 50, 10), visible],
+            [
+                "ComboBox",
+                "",
+                104,
+                (60, 24, 110, 120),
+                visible
+                | win32con.WS_BORDER
+                | win32con.WS_TABSTOP
+                | win32con.WS_VSCROLL
+                | win32con.CBS_DROPDOWN
+                | win32con.CBS_AUTOHSCROLL,
+            ],
+            [
+                "Button",
+                "Match &whole word only",
+                105,
+                (5, 42, 100, 10),
+                visible | win32con.BS_AUTOCHECKBOX | win32con.WS_TABSTOP,
+            ],
+            [
+                "Button",
+                "Match &case",
+                107,
+                (5, 52, 100, 10),
+                visible | win32con.BS_AUTOCHECKBOX | win32con.WS_TABSTOP,
+            ],
+            [
+                "Button",
+                "Keep &dialog open",
+                115,
+                (5, 62, 100, 10),
+                visible | win32con.BS_AUTOCHECKBOX | win32con.WS_TABSTOP,
+            ],
+            [
+                "Button",
+                "Across &open files",
+                116,
+                (5, 72, 100, 10),
+                visible | win32con.BS_AUTOCHECKBOX | win32con.WS_TABSTOP,
+            ],
+            [
+                "Button",
+                "&Remember as default search",
+                117,
+                (5, 81, 150, 10),
+                visible | win32con.BS_AUTOCHECKBOX | win32con.WS_TABSTOP,
+            ],
+            [
+                "Button",
+                "&Find Next",
+                109,
+                (185, 5, 50, 14),
+                visible | win32con.BS_DEFPUSHBUTTON | win32con.WS_TABSTOP,
+            ],
+            [
+                "Button",
+                "&Replace",
+                110,
+                (185, 23, 50, 14),
+                visible | win32con.WS_TABSTOP,
+            ],
+            [
+                "Button",
+                "Replace &All",
+                111,
+                (185, 41, 50, 14),
+                visible | win32con.WS_TABSTOP,
+            ],
+            [
+                "Button",
+                "Cancel",
+                win32con.IDCANCEL,
+                (185, 59, 50, 14),
+                visible | win32con.WS_TABSTOP,
+            ],
+        ]
+        return dt
+
+    def OnInitDialog(self):
+        rc = FindReplaceDialog.OnInitDialog(self)
+        self.HookCommand(self.OnReplace, 110)
+        self.HookCommand(self.OnReplaceAll, 111)
+        self.HookMessage(self.OnActivate, win32con.WM_ACTIVATE)
+        self.editReplaceText = self.GetDlgItem(104)
+        self.editReplaceText.SetWindowText(lastSearch.replaceText)
+        if hasattr(self.editReplaceText, "SetEditSel"):
+            self.editReplaceText.SetEditSel(0, -1)
+        else:
+            self.editReplaceText.SetSel(0, -1)
+        self.butReplace = self.GetDlgItem(110)
+        self.butReplaceAll = self.GetDlgItem(111)
+        self.CheckButtonStates()
+        return rc  # 0 when focus set
+
+    def CheckButtonStates(self):
+        # We can do a "Replace" or "Replace All" if the current selection
+        # is the same as the search text.
+        ft = self.editFindText.GetWindowText()
+        control = _GetControl()
+        # 		bCanReplace = len(ft)>0 and control.GetSelText() == ft
+        bCanReplace = control is not None and lastSearch.sel == control.GetSel()
+        self.butReplace.EnableWindow(bCanReplace)
+
+    # 		self.butReplaceAll.EnableWindow(bCanReplace)
+
+    def OnActivate(self, msg):
+        wparam = msg[2]
+        fActive = win32api.LOWORD(wparam)
+        if fActive != win32con.WA_INACTIVE:
+            self.CheckButtonStates()
+
+    def OnFindNext(self, id, code):
+        if code != 0:
+            return 1
+        self.DoFindNext()
+        self.CheckButtonStates()
+
+    def OnReplace(self, id, code):
+        if code != 0:
+            return 1
+        lastSearch.replaceText = self.editReplaceText.GetWindowText()
+        _ReplaceIt(None)
+
+    def OnReplaceAll(self, id, code):
+        if code != 0:
+            return 1
+        control = _GetControl(None)
+        if control is not None:
+            control.SetSel(0)
+            num = 0
+            if self.DoFindNext() == FOUND_NORMAL:
+                num = 1
+                lastSearch.replaceText = self.editReplaceText.GetWindowText()
+                while _ReplaceIt(control) == FOUND_NORMAL:
+                    num = num + 1
+
+            win32ui.SetStatusText("Replaced %d occurrences" % num)
+            if num > 0 and not self.butKeepDialogOpen.GetCheck():
+                self.DestroyWindow()
+
+
+if __name__ == "__main__":
+    ShowFindDialog()
diff --git a/lib/pythonwin/pywin/scintilla/formatter.py b/lib/pythonwin/pywin/scintilla/formatter.py
new file mode 100644
index 00000000..56100ccf
--- /dev/null
+++ b/lib/pythonwin/pywin/scintilla/formatter.py
@@ -0,0 +1,695 @@
+# Does Python source formatting for Scintilla controls.
+import array
+import string
+
+import win32api
+import win32con
+import win32ui
+
+from . import scintillacon
+
+WM_KICKIDLE = 0x036A
+
+# Used to indicate that style should use default color
+from win32con import CLR_INVALID
+
+debugging = 0
+if debugging:
+    # Output must go to another process else the result of
+    # the printing itself will trigger again trigger a trace.
+
+    import win32trace
+    import win32traceutil
+
+    def trace(*args):
+        win32trace.write(" ".join(map(str, args)) + "\n")
+
+else:
+    trace = lambda *args: None
+
+
+class Style:
+    """Represents a single format"""
+
+    def __init__(self, name, format, background=CLR_INVALID):
+        self.name = name  # Name the format representes eg, "String", "Class"
+        # Default background for each style is only used when there are no
+        # saved settings (generally on first startup)
+        self.background = self.default_background = background
+        if type(format) == type(""):
+            self.aliased = format
+            self.format = None
+        else:
+            self.format = format
+            self.aliased = None
+        self.stylenum = None  # Not yet registered.
+
+    def IsBasedOnDefault(self):
+        return len(self.format) == 5
+
+    # If the currently extended font defintion matches the
+    # default format, restore the format to the "simple" format.
+    def NormalizeAgainstDefault(self, defaultFormat):
+        if self.IsBasedOnDefault():
+            return 0  # No more to do, and not changed.
+        bIsDefault = (
+            self.format[7] == defaultFormat[7] and self.format[2] == defaultFormat[2]
+        )
+        if bIsDefault:
+            self.ForceAgainstDefault()
+        return bIsDefault
+
+    def ForceAgainstDefault(self):
+        self.format = self.format[:5]
+
+    def GetCompleteFormat(self, defaultFormat):
+        # Get the complete style after applying any relevant defaults.
+        if len(self.format) == 5:  # It is a default one
+            fmt = self.format + defaultFormat[5:]
+        else:
+            fmt = self.format
+        flags = (
+            win32con.CFM_BOLD
+            | win32con.CFM_CHARSET
+            | win32con.CFM_COLOR
+            | win32con.CFM_FACE
+            | win32con.CFM_ITALIC
+            | win32con.CFM_SIZE
+        )
+        return (flags,) + fmt[1:]
+
+
+# The Formatter interface
+# used primarily when the actual formatting is done by Scintilla!
+class FormatterBase:
+    def __init__(self, scintilla):
+        self.scintilla = scintilla
+        self.baseFormatFixed = (-402653169, 0, 200, 0, 0, 0, 49, "Courier New")
+        self.baseFormatProp = (-402653169, 0, 200, 0, 0, 0, 49, "Arial")
+        self.bUseFixed = 1
+        self.styles = {}  # Indexed by name
+        self.styles_by_id = {}  # Indexed by allocated ID.
+        self.SetStyles()
+
+    def HookFormatter(self, parent=None):
+        raise NotImplementedError()
+
+    # Used by the IDLE extensions to quickly determine if a character is a string.
+    def GetStringStyle(self, pos):
+        try:
+            style = self.styles_by_id[self.scintilla.SCIGetStyleAt(pos)]
+        except KeyError:
+            # A style we dont know about - probably not even a .py file - can't be a string
+            return None
+        if style.name in self.string_style_names:
+            return style
+        return None
+
+    def RegisterStyle(self, style, stylenum):
+        assert stylenum is not None, "We must have a style number"
+        assert style.stylenum is None, "Style has already been registered"
+        assert stylenum not in self.styles, "We are reusing a style number!"
+        style.stylenum = stylenum
+        self.styles[style.name] = style
+        self.styles_by_id[stylenum] = style
+
+    def SetStyles(self):
+        raise NotImplementedError()
+
+    def GetSampleText(self):
+        return "Sample Text for the Format Dialog"
+
+    def GetDefaultFormat(self):
+        if self.bUseFixed:
+            return self.baseFormatFixed
+        return self.baseFormatProp
+
+    # Update the control with the new style format.
+    def _ReformatStyle(self, style):
+        ## Selection (background only for now)
+        ## Passing False for WPARAM to SCI_SETSELBACK is documented as resetting to scintilla default,
+        ## but does not work - selection background is not visible at all.
+        ## Default value in SPECIAL_STYLES taken from scintilla source.
+        if style.name == STYLE_SELECTION:
+            clr = style.background
+            self.scintilla.SendScintilla(scintillacon.SCI_SETSELBACK, True, clr)
+
+            ## Can't change font for selection, but could set color
+            ## However, the font color dropbox has no option for default, and thus would
+            ## always override syntax coloring
+            ## clr = style.format[4]
+            ## self.scintilla.SendScintilla(scintillacon.SCI_SETSELFORE, clr != CLR_INVALID, clr)
+            return
+
+        assert style.stylenum is not None, "Unregistered style."
+        # print "Reformat style", style.name, style.stylenum
+        scintilla = self.scintilla
+        stylenum = style.stylenum
+        # Now we have the style number, indirect for the actual style.
+        if style.aliased is not None:
+            style = self.styles[style.aliased]
+        f = style.format
+        if style.IsBasedOnDefault():
+            baseFormat = self.GetDefaultFormat()
+        else:
+            baseFormat = f
+        scintilla.SCIStyleSetFore(stylenum, f[4])
+        scintilla.SCIStyleSetFont(stylenum, baseFormat[7], baseFormat[5])
+        if f[1] & 1:
+            scintilla.SCIStyleSetBold(stylenum, 1)
+        else:
+            scintilla.SCIStyleSetBold(stylenum, 0)
+        if f[1] & 2:
+            scintilla.SCIStyleSetItalic(stylenum, 1)
+        else:
+            scintilla.SCIStyleSetItalic(stylenum, 0)
+        scintilla.SCIStyleSetSize(stylenum, int(baseFormat[2] / 20))
+        scintilla.SCIStyleSetEOLFilled(stylenum, 1)  # Only needed for unclosed strings.
+
+        ## Default style background to whitespace background if set,
+        ##	otherwise use system window color
+        bg = style.background
+        if bg == CLR_INVALID:
+            bg = self.styles[STYLE_DEFAULT].background
+        if bg == CLR_INVALID:
+            bg = win32api.GetSysColor(win32con.COLOR_WINDOW)
+        scintilla.SCIStyleSetBack(stylenum, bg)
+
+    def GetStyleByNum(self, stylenum):
+        return self.styles_by_id[stylenum]
+
+    def ApplyFormattingStyles(self, bReload=1):
+        if bReload:
+            self.LoadPreferences()
+        baseFormat = self.GetDefaultFormat()
+        defaultStyle = Style("default", baseFormat)
+        defaultStyle.stylenum = scintillacon.STYLE_DEFAULT
+        self._ReformatStyle(defaultStyle)
+        for style in list(self.styles.values()):
+            if style.aliased is None:
+                style.NormalizeAgainstDefault(baseFormat)
+            self._ReformatStyle(style)
+        self.scintilla.InvalidateRect()
+
+    # Some functions for loading and saving preferences.  By default
+    # an INI file (well, MFC maps this to the registry) is used.
+    def LoadPreferences(self):
+        self.baseFormatFixed = eval(
+            self.LoadPreference("Base Format Fixed", str(self.baseFormatFixed))
+        )
+        self.baseFormatProp = eval(
+            self.LoadPreference("Base Format Proportional", str(self.baseFormatProp))
+        )
+        self.bUseFixed = int(self.LoadPreference("Use Fixed", 1))
+
+        for style in list(self.styles.values()):
+            new = self.LoadPreference(style.name, str(style.format))
+            try:
+                style.format = eval(new)
+            except:
+                print("Error loading style data for", style.name)
+            # Use "vanilla" background hardcoded in PYTHON_STYLES if no settings in registry
+            style.background = int(
+                self.LoadPreference(
+                    style.name + " background", style.default_background
+                )
+            )
+
+    def LoadPreference(self, name, default):
+        return win32ui.GetProfileVal("Format", name, default)
+
+    def SavePreferences(self):
+        self.SavePreference("Base Format Fixed", str(self.baseFormatFixed))
+        self.SavePreference("Base Format Proportional", str(self.baseFormatProp))
+        self.SavePreference("Use Fixed", self.bUseFixed)
+        for style in list(self.styles.values()):
+            if style.aliased is None:
+                self.SavePreference(style.name, str(style.format))
+                bg_name = style.name + " background"
+                self.SavePreference(bg_name, style.background)
+
+    def SavePreference(self, name, value):
+        win32ui.WriteProfileVal("Format", name, value)
+
+
+# An abstract formatter
+# For all formatters we actually implement here.
+# (as opposed to those formatters built in to Scintilla)
+class Formatter(FormatterBase):
+    def __init__(self, scintilla):
+        self.bCompleteWhileIdle = 0
+        self.bHaveIdleHandler = 0  # Dont currently have an idle handle
+        self.nextstylenum = 0
+        FormatterBase.__init__(self, scintilla)
+
+    def HookFormatter(self, parent=None):
+        if parent is None:
+            parent = self.scintilla.GetParent()  # was GetParentFrame()!?
+        parent.HookNotify(self.OnStyleNeeded, scintillacon.SCN_STYLENEEDED)
+
+    def OnStyleNeeded(self, std, extra):
+        notify = self.scintilla.SCIUnpackNotifyMessage(extra)
+        endStyledChar = self.scintilla.SendScintilla(scintillacon.SCI_GETENDSTYLED)
+        lineEndStyled = self.scintilla.LineFromChar(endStyledChar)
+        endStyled = self.scintilla.LineIndex(lineEndStyled)
+        # print "enPosPaint %d endStyledChar %d lineEndStyled %d endStyled %d" % (endPosPaint, endStyledChar, lineEndStyled, endStyled)
+        self.Colorize(endStyled, notify.position)
+
+    def ColorSeg(self, start, end, styleName):
+        end = end + 1
+        # 		assert end-start>=0, "Can't have negative styling"
+        stylenum = self.styles[styleName].stylenum
+        while start < end:
+            self.style_buffer[start] = stylenum
+            start = start + 1
+        # self.scintilla.SCISetStyling(end - start + 1, stylenum)
+
+    def RegisterStyle(self, style, stylenum=None):
+        if stylenum is None:
+            stylenum = self.nextstylenum
+            self.nextstylenum = self.nextstylenum + 1
+        FormatterBase.RegisterStyle(self, style, stylenum)
+
+    def ColorizeString(self, str, charStart, styleStart):
+        raise RuntimeError("You must override this method")
+
+    def Colorize(self, start=0, end=-1):
+        scintilla = self.scintilla
+        # scintilla's formatting is all done in terms of utf, so
+        # we work with utf8 bytes instead of unicode.  This magically
+        # works as any extended chars found in the utf8 don't change
+        # the semantics.
+        stringVal = scintilla.GetTextRange(start, end, decode=False)
+        if start > 0:
+            stylenum = scintilla.SCIGetStyleAt(start - 1)
+            styleStart = self.GetStyleByNum(stylenum).name
+        else:
+            styleStart = None
+        # 		trace("Coloring", start, end, end-start, len(stringVal), styleStart, self.scintilla.SCIGetCharAt(start))
+        scintilla.SCIStartStyling(start, 31)
+        self.style_buffer = array.array("b", (0,) * len(stringVal))
+        self.ColorizeString(stringVal, styleStart)
+        scintilla.SCISetStylingEx(self.style_buffer)
+        self.style_buffer = None
+        # 		trace("After styling, end styled is", self.scintilla.SCIGetEndStyled())
+        if (
+            self.bCompleteWhileIdle
+            and not self.bHaveIdleHandler
+            and end != -1
+            and end < scintilla.GetTextLength()
+        ):
+            self.bHaveIdleHandler = 1
+            win32ui.GetApp().AddIdleHandler(self.DoMoreColoring)
+            # Kicking idle makes the app seem slower when initially repainting!
+
+    # 			win32ui.GetMainFrame().PostMessage(WM_KICKIDLE, 0, 0)
+
+    def DoMoreColoring(self, handler, count):
+        try:
+            scintilla = self.scintilla
+            endStyled = scintilla.SCIGetEndStyled()
+            lineStartStyled = scintilla.LineFromChar(endStyled)
+            start = scintilla.LineIndex(lineStartStyled)
+            end = scintilla.LineIndex(lineStartStyled + 1)
+            textlen = scintilla.GetTextLength()
+            if end < 0:
+                end = textlen
+
+            finished = end >= textlen
+            self.Colorize(start, end)
+        except (win32ui.error, AttributeError):
+            # Window may have closed before we finished - no big deal!
+            finished = 1
+
+        if finished:
+            self.bHaveIdleHandler = 0
+            win32ui.GetApp().DeleteIdleHandler(handler)
+        return not finished
+
+
+# A Formatter that knows how to format Python source
+from keyword import iskeyword, kwlist
+
+wordstarts = "_0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz"
+wordchars = "._0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz"
+operators = "%^&*()-+=|{}[]:;<>,/?!.~"
+
+STYLE_DEFAULT = "Whitespace"
+STYLE_COMMENT = "Comment"
+STYLE_COMMENT_BLOCK = "Comment Blocks"
+STYLE_NUMBER = "Number"
+STYLE_STRING = "String"
+STYLE_SQSTRING = "SQ String"
+STYLE_TQSSTRING = "TQS String"
+STYLE_TQDSTRING = "TQD String"
+STYLE_KEYWORD = "Keyword"
+STYLE_CLASS = "Class"
+STYLE_METHOD = "Method"
+STYLE_OPERATOR = "Operator"
+STYLE_IDENTIFIER = "Identifier"
+STYLE_BRACE = "Brace/Paren - matching"
+STYLE_BRACEBAD = "Brace/Paren - unmatched"
+STYLE_STRINGEOL = "String with no terminator"
+STYLE_LINENUMBER = "Line numbers"
+STYLE_INDENTGUIDE = "Indent guide"
+STYLE_SELECTION = "Selection"
+
+STRING_STYLES = [
+    STYLE_STRING,
+    STYLE_SQSTRING,
+    STYLE_TQSSTRING,
+    STYLE_TQDSTRING,
+    STYLE_STRINGEOL,
+]
+
+# These styles can have any ID - they are not special to scintilla itself.
+# However, if we use the built-in lexer, then we must use its style numbers
+# so in that case, they _are_ special.
+# (name, format, background, scintilla id)
+PYTHON_STYLES = [
+    (STYLE_DEFAULT, (0, 0, 200, 0, 0x808080), CLR_INVALID, scintillacon.SCE_P_DEFAULT),
+    (
+        STYLE_COMMENT,
+        (0, 2, 200, 0, 0x008000),
+        CLR_INVALID,
+        scintillacon.SCE_P_COMMENTLINE,
+    ),
+    (
+        STYLE_COMMENT_BLOCK,
+        (0, 2, 200, 0, 0x808080),
+        CLR_INVALID,
+        scintillacon.SCE_P_COMMENTBLOCK,
+    ),
+    (STYLE_NUMBER, (0, 0, 200, 0, 0x808000), CLR_INVALID, scintillacon.SCE_P_NUMBER),
+    (STYLE_STRING, (0, 0, 200, 0, 0x008080), CLR_INVALID, scintillacon.SCE_P_STRING),
+    (STYLE_SQSTRING, STYLE_STRING, CLR_INVALID, scintillacon.SCE_P_CHARACTER),
+    (STYLE_TQSSTRING, STYLE_STRING, CLR_INVALID, scintillacon.SCE_P_TRIPLE),
+    (STYLE_TQDSTRING, STYLE_STRING, CLR_INVALID, scintillacon.SCE_P_TRIPLEDOUBLE),
+    (STYLE_STRINGEOL, (0, 0, 200, 0, 0x000000), 0x008080, scintillacon.SCE_P_STRINGEOL),
+    (STYLE_KEYWORD, (0, 1, 200, 0, 0x800000), CLR_INVALID, scintillacon.SCE_P_WORD),
+    (STYLE_CLASS, (0, 1, 200, 0, 0xFF0000), CLR_INVALID, scintillacon.SCE_P_CLASSNAME),
+    (STYLE_METHOD, (0, 1, 200, 0, 0x808000), CLR_INVALID, scintillacon.SCE_P_DEFNAME),
+    (
+        STYLE_OPERATOR,
+        (0, 0, 200, 0, 0x000000),
+        CLR_INVALID,
+        scintillacon.SCE_P_OPERATOR,
+    ),
+    (
+        STYLE_IDENTIFIER,
+        (0, 0, 200, 0, 0x000000),
+        CLR_INVALID,
+        scintillacon.SCE_P_IDENTIFIER,
+    ),
+]
+
+# These styles _always_ have this specific style number, regardless of
+# internal or external formatter.
+SPECIAL_STYLES = [
+    (STYLE_BRACE, (0, 0, 200, 0, 0x000000), 0xFFFF80, scintillacon.STYLE_BRACELIGHT),
+    (STYLE_BRACEBAD, (0, 0, 200, 0, 0x000000), 0x8EA5F2, scintillacon.STYLE_BRACEBAD),
+    (
+        STYLE_LINENUMBER,
+        (0, 0, 200, 0, 0x000000),
+        win32api.GetSysColor(win32con.COLOR_3DFACE),
+        scintillacon.STYLE_LINENUMBER,
+    ),
+    (
+        STYLE_INDENTGUIDE,
+        (0, 0, 200, 0, 0x000000),
+        CLR_INVALID,
+        scintillacon.STYLE_INDENTGUIDE,
+    ),
+    ## Not actually a style; requires special handling to send appropriate messages to scintilla
+    (
+        STYLE_SELECTION,
+        (0, 0, 200, 0, CLR_INVALID),
+        win32api.RGB(0xC0, 0xC0, 0xC0),
+        999999,
+    ),
+]
+
+PythonSampleCode = """\
+# Some Python
+class Sample(Super):
+  def Fn(self):
+\tself.v = 1024
+dest = 'dest.html'
+x = func(a + 1)|)
+s = "I forget...
+## A large
+## comment block"""
+
+
+class PythonSourceFormatter(Formatter):
+    string_style_names = STRING_STYLES
+
+    def GetSampleText(self):
+        return PythonSampleCode
+
+    def LoadStyles(self):
+        pass
+
+    def SetStyles(self):
+        for name, format, bg, ignore in PYTHON_STYLES:
+            self.RegisterStyle(Style(name, format, bg))
+        for name, format, bg, sc_id in SPECIAL_STYLES:
+            self.RegisterStyle(Style(name, format, bg), sc_id)
+
+    def ClassifyWord(self, cdoc, start, end, prevWord):
+        word = cdoc[start : end + 1].decode("latin-1")
+        attr = STYLE_IDENTIFIER
+        if prevWord == "class":
+            attr = STYLE_CLASS
+        elif prevWord == "def":
+            attr = STYLE_METHOD
+        elif word[0] in string.digits:
+            attr = STYLE_NUMBER
+        elif iskeyword(word):
+            attr = STYLE_KEYWORD
+        self.ColorSeg(start, end, attr)
+        return word
+
+    def ColorizeString(self, str, styleStart):
+        if styleStart is None:
+            styleStart = STYLE_DEFAULT
+        return self.ColorizePythonCode(str, 0, styleStart)
+
+    def ColorizePythonCode(self, cdoc, charStart, styleStart):
+        # Straight translation of C++, should do better
+        lengthDoc = len(cdoc)
+        if lengthDoc <= charStart:
+            return
+        prevWord = ""
+        state = styleStart
+        chPrev = chPrev2 = chPrev3 = " "
+        chNext2 = chNext = cdoc[charStart : charStart + 1].decode("latin-1")
+        startSeg = i = charStart
+        while i < lengthDoc:
+            ch = chNext
+            chNext = " "
+            if i + 1 < lengthDoc:
+                chNext = cdoc[i + 1 : i + 2].decode("latin-1")
+            chNext2 = " "
+            if i + 2 < lengthDoc:
+                chNext2 = cdoc[i + 2 : i + 3].decode("latin-1")
+            if state == STYLE_DEFAULT:
+                if ch in wordstarts:
+                    self.ColorSeg(startSeg, i - 1, STYLE_DEFAULT)
+                    state = STYLE_KEYWORD
+                    startSeg = i
+                elif ch == "#":
+                    self.ColorSeg(startSeg, i - 1, STYLE_DEFAULT)
+                    if chNext == "#":
+                        state = STYLE_COMMENT_BLOCK
+                    else:
+                        state = STYLE_COMMENT
+                    startSeg = i
+                elif ch == '"':
+                    self.ColorSeg(startSeg, i - 1, STYLE_DEFAULT)
+                    startSeg = i
+                    state = STYLE_COMMENT
+                    if chNext == '"' and chNext2 == '"':
+                        i = i + 2
+                        state = STYLE_TQDSTRING
+                        ch = " "
+                        chPrev = " "
+                        chNext = " "
+                        if i + 1 < lengthDoc:
+                            chNext = cdoc[i + 1]
+                    else:
+                        state = STYLE_STRING
+                elif ch == "'":
+                    self.ColorSeg(startSeg, i - 1, STYLE_DEFAULT)
+                    startSeg = i
+                    state = STYLE_COMMENT
+                    if chNext == "'" and chNext2 == "'":
+                        i = i + 2
+                        state = STYLE_TQSSTRING
+                        ch = " "
+                        chPrev = " "
+                        chNext = " "
+                        if i + 1 < lengthDoc:
+                            chNext = cdoc[i + 1]
+                    else:
+                        state = STYLE_SQSTRING
+                elif ch in operators:
+                    self.ColorSeg(startSeg, i - 1, STYLE_DEFAULT)
+                    self.ColorSeg(i, i, STYLE_OPERATOR)
+                    startSeg = i + 1
+            elif state == STYLE_KEYWORD:
+                if ch not in wordchars:
+                    prevWord = self.ClassifyWord(cdoc, startSeg, i - 1, prevWord)
+                    state = STYLE_DEFAULT
+                    startSeg = i
+                    if ch == "#":
+                        if chNext == "#":
+                            state = STYLE_COMMENT_BLOCK
+                        else:
+                            state = STYLE_COMMENT
+                    elif ch == '"':
+                        if chNext == '"' and chNext2 == '"':
+                            i = i + 2
+                            state = STYLE_TQDSTRING
+                            ch = " "
+                            chPrev = " "
+                            chNext = " "
+                            if i + 1 < lengthDoc:
+                                chNext = cdoc[i + 1]
+                        else:
+                            state = STYLE_STRING
+                    elif ch == "'":
+                        if chNext == "'" and chNext2 == "'":
+                            i = i + 2
+                            state = STYLE_TQSSTRING
+                            ch = " "
+                            chPrev = " "
+                            chNext = " "
+                            if i + 1 < lengthDoc:
+                                chNext = cdoc[i + 1]
+                        else:
+                            state = STYLE_SQSTRING
+                    elif ch in operators:
+                        self.ColorSeg(startSeg, i, STYLE_OPERATOR)
+                        startSeg = i + 1
+            elif state == STYLE_COMMENT or state == STYLE_COMMENT_BLOCK:
+                if ch == "\r" or ch == "\n":
+                    self.ColorSeg(startSeg, i - 1, state)
+                    state = STYLE_DEFAULT
+                    startSeg = i
+            elif state == STYLE_STRING:
+                if ch == "\\":
+                    if chNext == '"' or chNext == "'" or chNext == "\\":
+                        i = i + 1
+                        ch = chNext
+                        chNext = " "
+                        if i + 1 < lengthDoc:
+                            chNext = cdoc[i + 1]
+                elif ch == '"':
+                    self.ColorSeg(startSeg, i, STYLE_STRING)
+                    state = STYLE_DEFAULT
+                    startSeg = i + 1
+            elif state == STYLE_SQSTRING:
+                if ch == "\\":
+                    if chNext == '"' or chNext == "'" or chNext == "\\":
+                        i = i + 1
+                        ch = chNext
+                        chNext = " "
+                        if i + 1 < lengthDoc:
+                            chNext = cdoc[i + 1]
+                elif ch == "'":
+                    self.ColorSeg(startSeg, i, STYLE_SQSTRING)
+                    state = STYLE_DEFAULT
+                    startSeg = i + 1
+            elif state == STYLE_TQSSTRING:
+                if ch == "'" and chPrev == "'" and chPrev2 == "'" and chPrev3 != "\\":
+                    self.ColorSeg(startSeg, i, STYLE_TQSSTRING)
+                    state = STYLE_DEFAULT
+                    startSeg = i + 1
+            elif (
+                state == STYLE_TQDSTRING
+                and ch == '"'
+                and chPrev == '"'
+                and chPrev2 == '"'
+                and chPrev3 != "\\"
+            ):
+                self.ColorSeg(startSeg, i, STYLE_TQDSTRING)
+                state = STYLE_DEFAULT
+                startSeg = i + 1
+            chPrev3 = chPrev2
+            chPrev2 = chPrev
+            chPrev = ch
+            i = i + 1
+        if startSeg < lengthDoc:
+            if state == STYLE_KEYWORD:
+                self.ClassifyWord(cdoc, startSeg, lengthDoc - 1, prevWord)
+            else:
+                self.ColorSeg(startSeg, lengthDoc - 1, state)
+
+
+# These taken from the SciTE properties file.
+source_formatter_extensions = [
+    (".py .pys .pyw".split(), scintillacon.SCLEX_PYTHON),
+    (".html .htm .asp .shtml".split(), scintillacon.SCLEX_HTML),
+    (
+        "c .cc .cpp .cxx .h .hh .hpp .hxx .idl .odl .php3 .phtml .inc .js".split(),
+        scintillacon.SCLEX_CPP,
+    ),
+    (".vbs .frm .ctl .cls".split(), scintillacon.SCLEX_VB),
+    (".pl .pm .cgi .pod".split(), scintillacon.SCLEX_PERL),
+    (".sql .spec .body .sps .spb .sf .sp".split(), scintillacon.SCLEX_SQL),
+    (".tex .sty".split(), scintillacon.SCLEX_LATEX),
+    (".xml .xul".split(), scintillacon.SCLEX_XML),
+    (".err".split(), scintillacon.SCLEX_ERRORLIST),
+    (".mak".split(), scintillacon.SCLEX_MAKEFILE),
+    (".bat .cmd".split(), scintillacon.SCLEX_BATCH),
+]
+
+
+class BuiltinSourceFormatter(FormatterBase):
+    # A class that represents a formatter built-in to Scintilla
+    def __init__(self, scintilla, ext):
+        self.ext = ext
+        FormatterBase.__init__(self, scintilla)
+
+    def Colorize(self, start=0, end=-1):
+        self.scintilla.SendScintilla(scintillacon.SCI_COLOURISE, start, end)
+
+    def RegisterStyle(self, style, stylenum=None):
+        assert style.stylenum is None, "Style has already been registered"
+        if stylenum is None:
+            stylenum = self.nextstylenum
+            self.nextstylenum = self.nextstylenum + 1
+        assert self.styles.get(stylenum) is None, "We are reusing a style number!"
+        style.stylenum = stylenum
+        self.styles[style.name] = style
+        self.styles_by_id[stylenum] = style
+
+    def HookFormatter(self, parent=None):
+        sc = self.scintilla
+        for exts, formatter in source_formatter_extensions:
+            if self.ext in exts:
+                formatter_use = formatter
+                break
+        else:
+            formatter_use = scintillacon.SCLEX_PYTHON
+        sc.SendScintilla(scintillacon.SCI_SETLEXER, formatter_use)
+        keywords = " ".join(kwlist)
+        sc.SCISetKeywords(keywords)
+
+
+class BuiltinPythonSourceFormatter(BuiltinSourceFormatter):
+    sci_lexer_name = scintillacon.SCLEX_PYTHON
+    string_style_names = STRING_STYLES
+
+    def __init__(self, sc, ext=".py"):
+        BuiltinSourceFormatter.__init__(self, sc, ext)
+
+    def SetStyles(self):
+        for name, format, bg, sc_id in PYTHON_STYLES:
+            self.RegisterStyle(Style(name, format, bg), sc_id)
+        for name, format, bg, sc_id in SPECIAL_STYLES:
+            self.RegisterStyle(Style(name, format, bg), sc_id)
+
+    def GetSampleText(self):
+        return PythonSampleCode
diff --git a/lib/pythonwin/pywin/scintilla/keycodes.py b/lib/pythonwin/pywin/scintilla/keycodes.py
new file mode 100644
index 00000000..badcef3e
--- /dev/null
+++ b/lib/pythonwin/pywin/scintilla/keycodes.py
@@ -0,0 +1,190 @@
+import win32api
+import win32con
+import win32ui
+
+MAPVK_VK_TO_CHAR = 2
+
+key_name_to_vk = {}
+key_code_to_name = {}
+
+_better_names = {
+    "escape": "esc",
+    "return": "enter",
+    "back": "pgup",
+    "next": "pgdn",
+}
+
+
+def _fillvkmap():
+    # Pull the VK_names from win32con
+    names = [entry for entry in win32con.__dict__ if entry.startswith("VK_")]
+    for name in names:
+        code = getattr(win32con, name)
+        n = name[3:].lower()
+        key_name_to_vk[n] = code
+        if n in _better_names:
+            n = _better_names[n]
+            key_name_to_vk[n] = code
+        key_code_to_name[code] = n
+
+
+_fillvkmap()
+
+
+def get_vk(chardesc):
+    if len(chardesc) == 1:
+        # it is a character.
+        info = win32api.VkKeyScan(chardesc)
+        if info == -1:
+            # Note: returning None, None causes an error when keyboard layout is non-English, see the report below
+            # https://stackoverflow.com/questions/45138084/pythonwin-occasionally-gives-an-error-on-opening
+            return 0, 0
+        vk = win32api.LOBYTE(info)
+        state = win32api.HIBYTE(info)
+        modifiers = 0
+        if state & 0x1:
+            modifiers |= win32con.SHIFT_PRESSED
+        if state & 0x2:
+            modifiers |= win32con.LEFT_CTRL_PRESSED | win32con.RIGHT_CTRL_PRESSED
+        if state & 0x4:
+            modifiers |= win32con.LEFT_ALT_PRESSED | win32con.RIGHT_ALT_PRESSED
+        return vk, modifiers
+    # must be a 'key name'
+    return key_name_to_vk.get(chardesc.lower()), 0
+
+
+modifiers = {
+    "alt": win32con.LEFT_ALT_PRESSED | win32con.RIGHT_ALT_PRESSED,
+    "lalt": win32con.LEFT_ALT_PRESSED,
+    "ralt": win32con.RIGHT_ALT_PRESSED,
+    "ctrl": win32con.LEFT_CTRL_PRESSED | win32con.RIGHT_CTRL_PRESSED,
+    "ctl": win32con.LEFT_CTRL_PRESSED | win32con.RIGHT_CTRL_PRESSED,
+    "control": win32con.LEFT_CTRL_PRESSED | win32con.RIGHT_CTRL_PRESSED,
+    "lctrl": win32con.LEFT_CTRL_PRESSED,
+    "lctl": win32con.LEFT_CTRL_PRESSED,
+    "rctrl": win32con.RIGHT_CTRL_PRESSED,
+    "rctl": win32con.RIGHT_CTRL_PRESSED,
+    "shift": win32con.SHIFT_PRESSED,
+    "key": 0,  # ignore key tag.
+}
+
+
+def parse_key_name(name):
+    name = name + "-"  # Add a sentinal
+    start = pos = 0
+    max = len(name)
+    toks = []
+    while pos < max:
+        if name[pos] in "+-":
+            tok = name[start:pos]
+            # use the ascii lower() version of tok, so ascii chars require
+            # an explicit shift modifier - ie 'Ctrl+G' should be treated as
+            # 'ctrl+g' - 'ctrl+shift+g' would be needed if desired.
+            # This is mainly to avoid changing all the old keystroke defs
+            toks.append(tok.lower())
+            pos += 1  # skip the sep
+            start = pos
+        pos += 1
+    flags = 0
+    # do the modifiers
+    for tok in toks[:-1]:
+        mod = modifiers.get(tok.lower())
+        if mod is not None:
+            flags |= mod
+    # the key name
+    vk, this_flags = get_vk(toks[-1])
+    return vk, flags | this_flags
+
+
+_checks = [
+    [  # Shift
+        ("Shift", win32con.SHIFT_PRESSED),
+    ],
+    [  # Ctrl key
+        ("Ctrl", win32con.LEFT_CTRL_PRESSED | win32con.RIGHT_CTRL_PRESSED),
+        ("LCtrl", win32con.LEFT_CTRL_PRESSED),
+        ("RCtrl", win32con.RIGHT_CTRL_PRESSED),
+    ],
+    [  # Alt key
+        ("Alt", win32con.LEFT_ALT_PRESSED | win32con.RIGHT_ALT_PRESSED),
+        ("LAlt", win32con.LEFT_ALT_PRESSED),
+        ("RAlt", win32con.RIGHT_ALT_PRESSED),
+    ],
+]
+
+
+def make_key_name(vk, flags):
+    # Check alt keys.
+    flags_done = 0
+    parts = []
+    for moddata in _checks:
+        for name, checkflag in moddata:
+            if flags & checkflag:
+                parts.append(name)
+                flags_done = flags_done & checkflag
+                break
+    if flags_done & flags:
+        parts.append(hex(flags & ~flags_done))
+    # Now the key name.
+    if vk is None:
+        parts.append("<Unknown scan code>")
+    else:
+        try:
+            parts.append(key_code_to_name[vk])
+        except KeyError:
+            # Not in our virtual key map - ask Windows what character this
+            # key corresponds to.
+            scancode = win32api.MapVirtualKey(vk, MAPVK_VK_TO_CHAR)
+            parts.append(chr(scancode))
+    sep = "+"
+    if sep in parts:
+        sep = "-"
+    return sep.join([p.capitalize() for p in parts])
+
+
+def _psc(char):
+    sc, mods = get_vk(char)
+    print("Char %s -> %d -> %s" % (repr(char), sc, key_code_to_name.get(sc)))
+
+
+def test1():
+    for ch in """aA0/?[{}];:'"`~_-+=\\|,<.>/?""":
+        _psc(ch)
+    for code in ["Home", "End", "Left", "Right", "Up", "Down", "Menu", "Next"]:
+        _psc(code)
+
+
+def _pkn(n):
+    vk, flags = parse_key_name(n)
+    print("%s -> %s,%s -> %s" % (n, vk, flags, make_key_name(vk, flags)))
+
+
+def test2():
+    _pkn("ctrl+alt-shift+x")
+    _pkn("ctrl-home")
+    _pkn("Shift-+")
+    _pkn("Shift--")
+    _pkn("Shift+-")
+    _pkn("Shift++")
+    _pkn("LShift-+")
+    _pkn("ctl+home")
+    _pkn("ctl+enter")
+    _pkn("alt+return")
+    _pkn("Alt+/")
+    _pkn("Alt+BadKeyName")
+    _pkn("A")  # an ascii char - should be seen as 'a'
+    _pkn("a")
+    _pkn("Shift-A")
+    _pkn("Shift-a")
+    _pkn("a")
+    _pkn("(")
+    _pkn("Ctrl+(")
+    _pkn("Ctrl+Shift-8")
+    _pkn("Ctrl+*")
+    _pkn("{")
+    _pkn("!")
+    _pkn(".")
+
+
+if __name__ == "__main__":
+    test2()
diff --git a/lib/pythonwin/pywin/scintilla/scintillacon.py b/lib/pythonwin/pywin/scintilla/scintillacon.py
new file mode 100644
index 00000000..e7657dc7
--- /dev/null
+++ b/lib/pythonwin/pywin/scintilla/scintillacon.py
@@ -0,0 +1,2001 @@
+# Generated by h2py from Include\scintilla.h
+
+
+# Included from BaseTsd.h
+def HandleToUlong(h):
+    return HandleToULong(h)
+
+
+def UlongToHandle(ul):
+    return ULongToHandle(ul)
+
+
+def UlongToPtr(ul):
+    return ULongToPtr(ul)
+
+
+def UintToPtr(ui):
+    return UIntToPtr(ui)
+
+
+INVALID_POSITION = -1
+SCI_START = 2000
+SCI_OPTIONAL_START = 3000
+SCI_LEXER_START = 4000
+SCI_ADDTEXT = 2001
+SCI_ADDSTYLEDTEXT = 2002
+SCI_INSERTTEXT = 2003
+SCI_CLEARALL = 2004
+SCI_CLEARDOCUMENTSTYLE = 2005
+SCI_GETLENGTH = 2006
+SCI_GETCHARAT = 2007
+SCI_GETCURRENTPOS = 2008
+SCI_GETANCHOR = 2009
+SCI_GETSTYLEAT = 2010
+SCI_REDO = 2011
+SCI_SETUNDOCOLLECTION = 2012
+SCI_SELECTALL = 2013
+SCI_SETSAVEPOINT = 2014
+SCI_GETSTYLEDTEXT = 2015
+SCI_CANREDO = 2016
+SCI_MARKERLINEFROMHANDLE = 2017
+SCI_MARKERDELETEHANDLE = 2018
+SCI_GETUNDOCOLLECTION = 2019
+SCWS_INVISIBLE = 0
+SCWS_VISIBLEALWAYS = 1
+SCWS_VISIBLEAFTERINDENT = 2
+SCI_GETVIEWWS = 2020
+SCI_SETVIEWWS = 2021
+SCI_POSITIONFROMPOINT = 2022
+SCI_POSITIONFROMPOINTCLOSE = 2023
+SCI_GOTOLINE = 2024
+SCI_GOTOPOS = 2025
+SCI_SETANCHOR = 2026
+SCI_GETCURLINE = 2027
+SCI_GETENDSTYLED = 2028
+SC_EOL_CRLF = 0
+SC_EOL_CR = 1
+SC_EOL_LF = 2
+SCI_CONVERTEOLS = 2029
+SCI_GETEOLMODE = 2030
+SCI_SETEOLMODE = 2031
+SCI_STARTSTYLING = 2032
+SCI_SETSTYLING = 2033
+SCI_GETBUFFEREDDRAW = 2034
+SCI_SETBUFFEREDDRAW = 2035
+SCI_SETTABWIDTH = 2036
+SCI_GETTABWIDTH = 2121
+SC_CP_UTF8 = 65001
+SC_CP_DBCS = 1
+SCI_SETCODEPAGE = 2037
+SCI_SETUSEPALETTE = 2039
+MARKER_MAX = 31
+SC_MARK_CIRCLE = 0
+SC_MARK_ROUNDRECT = 1
+SC_MARK_ARROW = 2
+SC_MARK_SMALLRECT = 3
+SC_MARK_SHORTARROW = 4
+SC_MARK_EMPTY = 5
+SC_MARK_ARROWDOWN = 6
+SC_MARK_MINUS = 7
+SC_MARK_PLUS = 8
+SC_MARK_VLINE = 9
+SC_MARK_LCORNER = 10
+SC_MARK_TCORNER = 11
+SC_MARK_BOXPLUS = 12
+SC_MARK_BOXPLUSCONNECTED = 13
+SC_MARK_BOXMINUS = 14
+SC_MARK_BOXMINUSCONNECTED = 15
+SC_MARK_LCORNERCURVE = 16
+SC_MARK_TCORNERCURVE = 17
+SC_MARK_CIRCLEPLUS = 18
+SC_MARK_CIRCLEPLUSCONNECTED = 19
+SC_MARK_CIRCLEMINUS = 20
+SC_MARK_CIRCLEMINUSCONNECTED = 21
+SC_MARK_BACKGROUND = 22
+SC_MARK_DOTDOTDOT = 23
+SC_MARK_ARROWS = 24
+SC_MARK_PIXMAP = 25
+SC_MARK_FULLRECT = 26
+SC_MARK_LEFTRECT = 27
+SC_MARK_CHARACTER = 10000
+SC_MARKNUM_FOLDEREND = 25
+SC_MARKNUM_FOLDEROPENMID = 26
+SC_MARKNUM_FOLDERMIDTAIL = 27
+SC_MARKNUM_FOLDERTAIL = 28
+SC_MARKNUM_FOLDERSUB = 29
+SC_MARKNUM_FOLDER = 30
+SC_MARKNUM_FOLDEROPEN = 31
+SC_MASK_FOLDERS = -33554432
+SCI_MARKERDEFINE = 2040
+SCI_MARKERSETFORE = 2041
+SCI_MARKERSETBACK = 2042
+SCI_MARKERADD = 2043
+SCI_MARKERDELETE = 2044
+SCI_MARKERDELETEALL = 2045
+SCI_MARKERGET = 2046
+SCI_MARKERNEXT = 2047
+SCI_MARKERPREVIOUS = 2048
+SCI_MARKERDEFINEPIXMAP = 2049
+SCI_MARKERADDSET = 2466
+SCI_MARKERSETALPHA = 2476
+SC_MARGIN_SYMBOL = 0
+SC_MARGIN_NUMBER = 1
+SC_MARGIN_BACK = 2
+SC_MARGIN_FORE = 3
+SCI_SETMARGINTYPEN = 2240
+SCI_GETMARGINTYPEN = 2241
+SCI_SETMARGINWIDTHN = 2242
+SCI_GETMARGINWIDTHN = 2243
+SCI_SETMARGINMASKN = 2244
+SCI_GETMARGINMASKN = 2245
+SCI_SETMARGINSENSITIVEN = 2246
+SCI_GETMARGINSENSITIVEN = 2247
+STYLE_DEFAULT = 32
+STYLE_LINENUMBER = 33
+STYLE_BRACELIGHT = 34
+STYLE_BRACEBAD = 35
+STYLE_CONTROLCHAR = 36
+STYLE_INDENTGUIDE = 37
+STYLE_CALLTIP = 38
+STYLE_LASTPREDEFINED = 39
+STYLE_MAX = 255
+SC_CHARSET_ANSI = 0
+SC_CHARSET_DEFAULT = 1
+SC_CHARSET_BALTIC = 186
+SC_CHARSET_CHINESEBIG5 = 136
+SC_CHARSET_EASTEUROPE = 238
+SC_CHARSET_GB2312 = 134
+SC_CHARSET_GREEK = 161
+SC_CHARSET_HANGUL = 129
+SC_CHARSET_MAC = 77
+SC_CHARSET_OEM = 255
+SC_CHARSET_RUSSIAN = 204
+SC_CHARSET_CYRILLIC = 1251
+SC_CHARSET_SHIFTJIS = 128
+SC_CHARSET_SYMBOL = 2
+SC_CHARSET_TURKISH = 162
+SC_CHARSET_JOHAB = 130
+SC_CHARSET_HEBREW = 177
+SC_CHARSET_ARABIC = 178
+SC_CHARSET_VIETNAMESE = 163
+SC_CHARSET_THAI = 222
+SC_CHARSET_8859_15 = 1000
+SCI_STYLECLEARALL = 2050
+SCI_STYLESETFORE = 2051
+SCI_STYLESETBACK = 2052
+SCI_STYLESETBOLD = 2053
+SCI_STYLESETITALIC = 2054
+SCI_STYLESETSIZE = 2055
+SCI_STYLESETFONT = 2056
+SCI_STYLESETEOLFILLED = 2057
+SCI_STYLERESETDEFAULT = 2058
+SCI_STYLESETUNDERLINE = 2059
+SC_CASE_MIXED = 0
+SC_CASE_UPPER = 1
+SC_CASE_LOWER = 2
+SCI_STYLEGETFORE = 2481
+SCI_STYLEGETBACK = 2482
+SCI_STYLEGETBOLD = 2483
+SCI_STYLEGETITALIC = 2484
+SCI_STYLEGETSIZE = 2485
+SCI_STYLEGETFONT = 2486
+SCI_STYLEGETEOLFILLED = 2487
+SCI_STYLEGETUNDERLINE = 2488
+SCI_STYLEGETCASE = 2489
+SCI_STYLEGETCHARACTERSET = 2490
+SCI_STYLEGETVISIBLE = 2491
+SCI_STYLEGETCHANGEABLE = 2492
+SCI_STYLEGETHOTSPOT = 2493
+SCI_STYLESETCASE = 2060
+SCI_STYLESETCHARACTERSET = 2066
+SCI_STYLESETHOTSPOT = 2409
+SCI_SETSELFORE = 2067
+SCI_SETSELBACK = 2068
+SCI_GETSELALPHA = 2477
+SCI_SETSELALPHA = 2478
+SCI_GETSELEOLFILLED = 2479
+SCI_SETSELEOLFILLED = 2480
+SCI_SETCARETFORE = 2069
+SCI_ASSIGNCMDKEY = 2070
+SCI_CLEARCMDKEY = 2071
+SCI_CLEARALLCMDKEYS = 2072
+SCI_SETSTYLINGEX = 2073
+SCI_STYLESETVISIBLE = 2074
+SCI_GETCARETPERIOD = 2075
+SCI_SETCARETPERIOD = 2076
+SCI_SETWORDCHARS = 2077
+SCI_BEGINUNDOACTION = 2078
+SCI_ENDUNDOACTION = 2079
+INDIC_PLAIN = 0
+INDIC_SQUIGGLE = 1
+INDIC_TT = 2
+INDIC_DIAGONAL = 3
+INDIC_STRIKE = 4
+INDIC_HIDDEN = 5
+INDIC_BOX = 6
+INDIC_ROUNDBOX = 7
+INDIC_MAX = 31
+INDIC_CONTAINER = 8
+INDIC0_MASK = 0x20
+INDIC1_MASK = 0x40
+INDIC2_MASK = 0x80
+INDICS_MASK = 0xE0
+SCI_INDICSETSTYLE = 2080
+SCI_INDICGETSTYLE = 2081
+SCI_INDICSETFORE = 2082
+SCI_INDICGETFORE = 2083
+SCI_INDICSETUNDER = 2510
+SCI_INDICGETUNDER = 2511
+SCI_SETWHITESPACEFORE = 2084
+SCI_SETWHITESPACEBACK = 2085
+SCI_SETSTYLEBITS = 2090
+SCI_GETSTYLEBITS = 2091
+SCI_SETLINESTATE = 2092
+SCI_GETLINESTATE = 2093
+SCI_GETMAXLINESTATE = 2094
+SCI_GETCARETLINEVISIBLE = 2095
+SCI_SETCARETLINEVISIBLE = 2096
+SCI_GETCARETLINEBACK = 2097
+SCI_SETCARETLINEBACK = 2098
+SCI_STYLESETCHANGEABLE = 2099
+SCI_AUTOCSHOW = 2100
+SCI_AUTOCCANCEL = 2101
+SCI_AUTOCACTIVE = 2102
+SCI_AUTOCPOSSTART = 2103
+SCI_AUTOCCOMPLETE = 2104
+SCI_AUTOCSTOPS = 2105
+SCI_AUTOCSETSEPARATOR = 2106
+SCI_AUTOCGETSEPARATOR = 2107
+SCI_AUTOCSELECT = 2108
+SCI_AUTOCSETCANCELATSTART = 2110
+SCI_AUTOCGETCANCELATSTART = 2111
+SCI_AUTOCSETFILLUPS = 2112
+SCI_AUTOCSETCHOOSESINGLE = 2113
+SCI_AUTOCGETCHOOSESINGLE = 2114
+SCI_AUTOCSETIGNORECASE = 2115
+SCI_AUTOCGETIGNORECASE = 2116
+SCI_USERLISTSHOW = 2117
+SCI_AUTOCSETAUTOHIDE = 2118
+SCI_AUTOCGETAUTOHIDE = 2119
+SCI_AUTOCSETDROPRESTOFWORD = 2270
+SCI_AUTOCGETDROPRESTOFWORD = 2271
+SCI_REGISTERIMAGE = 2405
+SCI_CLEARREGISTEREDIMAGES = 2408
+SCI_AUTOCGETTYPESEPARATOR = 2285
+SCI_AUTOCSETTYPESEPARATOR = 2286
+SCI_AUTOCSETMAXWIDTH = 2208
+SCI_AUTOCGETMAXWIDTH = 2209
+SCI_AUTOCSETMAXHEIGHT = 2210
+SCI_AUTOCGETMAXHEIGHT = 2211
+SCI_SETINDENT = 2122
+SCI_GETINDENT = 2123
+SCI_SETUSETABS = 2124
+SCI_GETUSETABS = 2125
+SCI_SETLINEINDENTATION = 2126
+SCI_GETLINEINDENTATION = 2127
+SCI_GETLINEINDENTPOSITION = 2128
+SCI_GETCOLUMN = 2129
+SCI_SETHSCROLLBAR = 2130
+SCI_GETHSCROLLBAR = 2131
+SC_IV_NONE = 0
+SC_IV_REAL = 1
+SC_IV_LOOKFORWARD = 2
+SC_IV_LOOKBOTH = 3
+SCI_SETINDENTATIONGUIDES = 2132
+SCI_GETINDENTATIONGUIDES = 2133
+SCI_SETHIGHLIGHTGUIDE = 2134
+SCI_GETHIGHLIGHTGUIDE = 2135
+SCI_GETLINEENDPOSITION = 2136
+SCI_GETCODEPAGE = 2137
+SCI_GETCARETFORE = 2138
+SCI_GETUSEPALETTE = 2139
+SCI_GETREADONLY = 2140
+SCI_SETCURRENTPOS = 2141
+SCI_SETSELECTIONSTART = 2142
+SCI_GETSELECTIONSTART = 2143
+SCI_SETSELECTIONEND = 2144
+SCI_GETSELECTIONEND = 2145
+SCI_SETPRINTMAGNIFICATION = 2146
+SCI_GETPRINTMAGNIFICATION = 2147
+SC_PRINT_NORMAL = 0
+SC_PRINT_INVERTLIGHT = 1
+SC_PRINT_BLACKONWHITE = 2
+SC_PRINT_COLOURONWHITE = 3
+SC_PRINT_COLOURONWHITEDEFAULTBG = 4
+SCI_SETPRINTCOLOURMODE = 2148
+SCI_GETPRINTCOLOURMODE = 2149
+SCFIND_WHOLEWORD = 2
+SCFIND_MATCHCASE = 4
+SCFIND_WORDSTART = 0x00100000
+SCFIND_REGEXP = 0x00200000
+SCFIND_POSIX = 0x00400000
+SCI_FINDTEXT = 2150
+SCI_FORMATRANGE = 2151
+SCI_GETFIRSTVISIBLELINE = 2152
+SCI_GETLINE = 2153
+SCI_GETLINECOUNT = 2154
+SCI_SETMARGINLEFT = 2155
+SCI_GETMARGINLEFT = 2156
+SCI_SETMARGINRIGHT = 2157
+SCI_GETMARGINRIGHT = 2158
+SCI_GETMODIFY = 2159
+SCI_SETSEL = 2160
+SCI_GETSELTEXT = 2161
+SCI_GETTEXTRANGE = 2162
+SCI_HIDESELECTION = 2163
+SCI_POINTXFROMPOSITION = 2164
+SCI_POINTYFROMPOSITION = 2165
+SCI_LINEFROMPOSITION = 2166
+SCI_POSITIONFROMLINE = 2167
+SCI_LINESCROLL = 2168
+SCI_SCROLLCARET = 2169
+SCI_REPLACESEL = 2170
+SCI_SETREADONLY = 2171
+SCI_NULL = 2172
+SCI_CANPASTE = 2173
+SCI_CANUNDO = 2174
+SCI_EMPTYUNDOBUFFER = 2175
+SCI_UNDO = 2176
+SCI_CUT = 2177
+SCI_COPY = 2178
+SCI_PASTE = 2179
+SCI_CLEAR = 2180
+SCI_SETTEXT = 2181
+SCI_GETTEXT = 2182
+SCI_GETTEXTLENGTH = 2183
+SCI_GETDIRECTFUNCTION = 2184
+SCI_GETDIRECTPOINTER = 2185
+SCI_SETOVERTYPE = 2186
+SCI_GETOVERTYPE = 2187
+SCI_SETCARETWIDTH = 2188
+SCI_GETCARETWIDTH = 2189
+SCI_SETTARGETSTART = 2190
+SCI_GETTARGETSTART = 2191
+SCI_SETTARGETEND = 2192
+SCI_GETTARGETEND = 2193
+SCI_REPLACETARGET = 2194
+SCI_REPLACETARGETRE = 2195
+SCI_SEARCHINTARGET = 2197
+SCI_SETSEARCHFLAGS = 2198
+SCI_GETSEARCHFLAGS = 2199
+SCI_CALLTIPSHOW = 2200
+SCI_CALLTIPCANCEL = 2201
+SCI_CALLTIPACTIVE = 2202
+SCI_CALLTIPPOSSTART = 2203
+SCI_CALLTIPSETHLT = 2204
+SCI_CALLTIPSETBACK = 2205
+SCI_CALLTIPSETFORE = 2206
+SCI_CALLTIPSETFOREHLT = 2207
+SCI_CALLTIPUSESTYLE = 2212
+SCI_VISIBLEFROMDOCLINE = 2220
+SCI_DOCLINEFROMVISIBLE = 2221
+SCI_WRAPCOUNT = 2235
+SC_FOLDLEVELBASE = 0x400
+SC_FOLDLEVELWHITEFLAG = 0x1000
+SC_FOLDLEVELHEADERFLAG = 0x2000
+SC_FOLDLEVELBOXHEADERFLAG = 0x4000
+SC_FOLDLEVELBOXFOOTERFLAG = 0x8000
+SC_FOLDLEVELCONTRACTED = 0x10000
+SC_FOLDLEVELUNINDENT = 0x20000
+SC_FOLDLEVELNUMBERMASK = 0x0FFF
+SCI_SETFOLDLEVEL = 2222
+SCI_GETFOLDLEVEL = 2223
+SCI_GETLASTCHILD = 2224
+SCI_GETFOLDPARENT = 2225
+SCI_SHOWLINES = 2226
+SCI_HIDELINES = 2227
+SCI_GETLINEVISIBLE = 2228
+SCI_SETFOLDEXPANDED = 2229
+SCI_GETFOLDEXPANDED = 2230
+SCI_TOGGLEFOLD = 2231
+SCI_ENSUREVISIBLE = 2232
+SC_FOLDFLAG_LINEBEFORE_EXPANDED = 0x0002
+SC_FOLDFLAG_LINEBEFORE_CONTRACTED = 0x0004
+SC_FOLDFLAG_LINEAFTER_EXPANDED = 0x0008
+SC_FOLDFLAG_LINEAFTER_CONTRACTED = 0x0010
+SC_FOLDFLAG_LEVELNUMBERS = 0x0040
+SC_FOLDFLAG_BOX = 0x0001
+SCI_SETFOLDFLAGS = 2233
+SCI_ENSUREVISIBLEENFORCEPOLICY = 2234
+SCI_SETTABINDENTS = 2260
+SCI_GETTABINDENTS = 2261
+SCI_SETBACKSPACEUNINDENTS = 2262
+SCI_GETBACKSPACEUNINDENTS = 2263
+SC_TIME_FOREVER = 10000000
+SCI_SETMOUSEDWELLTIME = 2264
+SCI_GETMOUSEDWELLTIME = 2265
+SCI_WORDSTARTPOSITION = 2266
+SCI_WORDENDPOSITION = 2267
+SC_WRAP_NONE = 0
+SC_WRAP_WORD = 1
+SC_WRAP_CHAR = 2
+SCI_SETWRAPMODE = 2268
+SCI_GETWRAPMODE = 2269
+SC_WRAPVISUALFLAG_NONE = 0x0000
+SC_WRAPVISUALFLAG_END = 0x0001
+SC_WRAPVISUALFLAG_START = 0x0002
+SCI_SETWRAPVISUALFLAGS = 2460
+SCI_GETWRAPVISUALFLAGS = 2461
+SC_WRAPVISUALFLAGLOC_DEFAULT = 0x0000
+SC_WRAPVISUALFLAGLOC_END_BY_TEXT = 0x0001
+SC_WRAPVISUALFLAGLOC_START_BY_TEXT = 0x0002
+SCI_SETWRAPVISUALFLAGSLOCATION = 2462
+SCI_GETWRAPVISUALFLAGSLOCATION = 2463
+SCI_SETWRAPSTARTINDENT = 2464
+SCI_GETWRAPSTARTINDENT = 2465
+SC_CACHE_NONE = 0
+SC_CACHE_CARET = 1
+SC_CACHE_PAGE = 2
+SC_CACHE_DOCUMENT = 3
+SCI_SETLAYOUTCACHE = 2272
+SCI_GETLAYOUTCACHE = 2273
+SCI_SETSCROLLWIDTH = 2274
+SCI_GETSCROLLWIDTH = 2275
+SCI_SETSCROLLWIDTHTRACKING = 2516
+SCI_GETSCROLLWIDTHTRACKING = 2517
+SCI_TEXTWIDTH = 2276
+SCI_SETENDATLASTLINE = 2277
+SCI_GETENDATLASTLINE = 2278
+SCI_TEXTHEIGHT = 2279
+SCI_SETVSCROLLBAR = 2280
+SCI_GETVSCROLLBAR = 2281
+SCI_APPENDTEXT = 2282
+SCI_GETTWOPHASEDRAW = 2283
+SCI_SETTWOPHASEDRAW = 2284
+SCI_TARGETFROMSELECTION = 2287
+SCI_LINESJOIN = 2288
+SCI_LINESSPLIT = 2289
+SCI_SETFOLDMARGINCOLOUR = 2290
+SCI_SETFOLDMARGINHICOLOUR = 2291
+SCI_LINEDOWN = 2300
+SCI_LINEDOWNEXTEND = 2301
+SCI_LINEUP = 2302
+SCI_LINEUPEXTEND = 2303
+SCI_CHARLEFT = 2304
+SCI_CHARLEFTEXTEND = 2305
+SCI_CHARRIGHT = 2306
+SCI_CHARRIGHTEXTEND = 2307
+SCI_WORDLEFT = 2308
+SCI_WORDLEFTEXTEND = 2309
+SCI_WORDRIGHT = 2310
+SCI_WORDRIGHTEXTEND = 2311
+SCI_HOME = 2312
+SCI_HOMEEXTEND = 2313
+SCI_LINEEND = 2314
+SCI_LINEENDEXTEND = 2315
+SCI_DOCUMENTSTART = 2316
+SCI_DOCUMENTSTARTEXTEND = 2317
+SCI_DOCUMENTEND = 2318
+SCI_DOCUMENTENDEXTEND = 2319
+SCI_PAGEUP = 2320
+SCI_PAGEUPEXTEND = 2321
+SCI_PAGEDOWN = 2322
+SCI_PAGEDOWNEXTEND = 2323
+SCI_EDITTOGGLEOVERTYPE = 2324
+SCI_CANCEL = 2325
+SCI_DELETEBACK = 2326
+SCI_TAB = 2327
+SCI_BACKTAB = 2328
+SCI_NEWLINE = 2329
+SCI_FORMFEED = 2330
+SCI_VCHOME = 2331
+SCI_VCHOMEEXTEND = 2332
+SCI_ZOOMIN = 2333
+SCI_ZOOMOUT = 2334
+SCI_DELWORDLEFT = 2335
+SCI_DELWORDRIGHT = 2336
+SCI_DELWORDRIGHTEND = 2518
+SCI_LINECUT = 2337
+SCI_LINEDELETE = 2338
+SCI_LINETRANSPOSE = 2339
+SCI_LINEDUPLICATE = 2404
+SCI_LOWERCASE = 2340
+SCI_UPPERCASE = 2341
+SCI_LINESCROLLDOWN = 2342
+SCI_LINESCROLLUP = 2343
+SCI_DELETEBACKNOTLINE = 2344
+SCI_HOMEDISPLAY = 2345
+SCI_HOMEDISPLAYEXTEND = 2346
+SCI_LINEENDDISPLAY = 2347
+SCI_LINEENDDISPLAYEXTEND = 2348
+SCI_HOMEWRAP = 2349
+SCI_HOMEWRAPEXTEND = 2450
+SCI_LINEENDWRAP = 2451
+SCI_LINEENDWRAPEXTEND = 2452
+SCI_VCHOMEWRAP = 2453
+SCI_VCHOMEWRAPEXTEND = 2454
+SCI_LINECOPY = 2455
+SCI_MOVECARETINSIDEVIEW = 2401
+SCI_LINELENGTH = 2350
+SCI_BRACEHIGHLIGHT = 2351
+SCI_BRACEBADLIGHT = 2352
+SCI_BRACEMATCH = 2353
+SCI_GETVIEWEOL = 2355
+SCI_SETVIEWEOL = 2356
+SCI_GETDOCPOINTER = 2357
+SCI_SETDOCPOINTER = 2358
+SCI_SETMODEVENTMASK = 2359
+EDGE_NONE = 0
+EDGE_LINE = 1
+EDGE_BACKGROUND = 2
+SCI_GETEDGECOLUMN = 2360
+SCI_SETEDGECOLUMN = 2361
+SCI_GETEDGEMODE = 2362
+SCI_SETEDGEMODE = 2363
+SCI_GETEDGECOLOUR = 2364
+SCI_SETEDGECOLOUR = 2365
+SCI_SEARCHANCHOR = 2366
+SCI_SEARCHNEXT = 2367
+SCI_SEARCHPREV = 2368
+SCI_LINESONSCREEN = 2370
+SCI_USEPOPUP = 2371
+SCI_SELECTIONISRECTANGLE = 2372
+SCI_SETZOOM = 2373
+SCI_GETZOOM = 2374
+SCI_CREATEDOCUMENT = 2375
+SCI_ADDREFDOCUMENT = 2376
+SCI_RELEASEDOCUMENT = 2377
+SCI_GETMODEVENTMASK = 2378
+SCI_SETFOCUS = 2380
+SCI_GETFOCUS = 2381
+SCI_SETSTATUS = 2382
+SCI_GETSTATUS = 2383
+SCI_SETMOUSEDOWNCAPTURES = 2384
+SCI_GETMOUSEDOWNCAPTURES = 2385
+SC_CURSORNORMAL = -1
+SC_CURSORWAIT = 4
+SCI_SETCURSOR = 2386
+SCI_GETCURSOR = 2387
+SCI_SETCONTROLCHARSYMBOL = 2388
+SCI_GETCONTROLCHARSYMBOL = 2389
+SCI_WORDPARTLEFT = 2390
+SCI_WORDPARTLEFTEXTEND = 2391
+SCI_WORDPARTRIGHT = 2392
+SCI_WORDPARTRIGHTEXTEND = 2393
+VISIBLE_SLOP = 0x01
+VISIBLE_STRICT = 0x04
+SCI_SETVISIBLEPOLICY = 2394
+SCI_DELLINELEFT = 2395
+SCI_DELLINERIGHT = 2396
+SCI_SETXOFFSET = 2397
+SCI_GETXOFFSET = 2398
+SCI_CHOOSECARETX = 2399
+SCI_GRABFOCUS = 2400
+CARET_SLOP = 0x01
+CARET_STRICT = 0x04
+CARET_JUMPS = 0x10
+CARET_EVEN = 0x08
+SCI_SETXCARETPOLICY = 2402
+SCI_SETYCARETPOLICY = 2403
+SCI_SETPRINTWRAPMODE = 2406
+SCI_GETPRINTWRAPMODE = 2407
+SCI_SETHOTSPOTACTIVEFORE = 2410
+SCI_GETHOTSPOTACTIVEFORE = 2494
+SCI_SETHOTSPOTACTIVEBACK = 2411
+SCI_GETHOTSPOTACTIVEBACK = 2495
+SCI_SETHOTSPOTACTIVEUNDERLINE = 2412
+SCI_GETHOTSPOTACTIVEUNDERLINE = 2496
+SCI_SETHOTSPOTSINGLELINE = 2421
+SCI_GETHOTSPOTSINGLELINE = 2497
+SCI_PARADOWN = 2413
+SCI_PARADOWNEXTEND = 2414
+SCI_PARAUP = 2415
+SCI_PARAUPEXTEND = 2416
+SCI_POSITIONBEFORE = 2417
+SCI_POSITIONAFTER = 2418
+SCI_COPYRANGE = 2419
+SCI_COPYTEXT = 2420
+SC_SEL_STREAM = 0
+SC_SEL_RECTANGLE = 1
+SC_SEL_LINES = 2
+SCI_SETSELECTIONMODE = 2422
+SCI_GETSELECTIONMODE = 2423
+SCI_GETLINESELSTARTPOSITION = 2424
+SCI_GETLINESELENDPOSITION = 2425
+SCI_LINEDOWNRECTEXTEND = 2426
+SCI_LINEUPRECTEXTEND = 2427
+SCI_CHARLEFTRECTEXTEND = 2428
+SCI_CHARRIGHTRECTEXTEND = 2429
+SCI_HOMERECTEXTEND = 2430
+SCI_VCHOMERECTEXTEND = 2431
+SCI_LINEENDRECTEXTEND = 2432
+SCI_PAGEUPRECTEXTEND = 2433
+SCI_PAGEDOWNRECTEXTEND = 2434
+SCI_STUTTEREDPAGEUP = 2435
+SCI_STUTTEREDPAGEUPEXTEND = 2436
+SCI_STUTTEREDPAGEDOWN = 2437
+SCI_STUTTEREDPAGEDOWNEXTEND = 2438
+SCI_WORDLEFTEND = 2439
+SCI_WORDLEFTENDEXTEND = 2440
+SCI_WORDRIGHTEND = 2441
+SCI_WORDRIGHTENDEXTEND = 2442
+SCI_SETWHITESPACECHARS = 2443
+SCI_SETCHARSDEFAULT = 2444
+SCI_AUTOCGETCURRENT = 2445
+SCI_ALLOCATE = 2446
+SCI_TARGETASUTF8 = 2447
+SCI_SETLENGTHFORENCODE = 2448
+SCI_ENCODEDFROMUTF8 = 2449
+SCI_FINDCOLUMN = 2456
+SCI_GETCARETSTICKY = 2457
+SCI_SETCARETSTICKY = 2458
+SCI_TOGGLECARETSTICKY = 2459
+SCI_SETPASTECONVERTENDINGS = 2467
+SCI_GETPASTECONVERTENDINGS = 2468
+SCI_SELECTIONDUPLICATE = 2469
+SC_ALPHA_TRANSPARENT = 0
+SC_ALPHA_OPAQUE = 255
+SC_ALPHA_NOALPHA = 256
+SCI_SETCARETLINEBACKALPHA = 2470
+SCI_GETCARETLINEBACKALPHA = 2471
+CARETSTYLE_INVISIBLE = 0
+CARETSTYLE_LINE = 1
+CARETSTYLE_BLOCK = 2
+SCI_SETCARETSTYLE = 2512
+SCI_GETCARETSTYLE = 2513
+SCI_SETINDICATORCURRENT = 2500
+SCI_GETINDICATORCURRENT = 2501
+SCI_SETINDICATORVALUE = 2502
+SCI_GETINDICATORVALUE = 2503
+SCI_INDICATORFILLRANGE = 2504
+SCI_INDICATORCLEARRANGE = 2505
+SCI_INDICATORALLONFOR = 2506
+SCI_INDICATORVALUEAT = 2507
+SCI_INDICATORSTART = 2508
+SCI_INDICATOREND = 2509
+SCI_SETPOSITIONCACHE = 2514
+SCI_GETPOSITIONCACHE = 2515
+SCI_COPYALLOWLINE = 2519
+SCI_GETCHARACTERPOINTER = 2520
+SCI_SETKEYSUNICODE = 2521
+SCI_GETKEYSUNICODE = 2522
+SCI_STARTRECORD = 3001
+SCI_STOPRECORD = 3002
+SCI_SETLEXER = 4001
+SCI_GETLEXER = 4002
+SCI_COLOURISE = 4003
+SCI_SETPROPERTY = 4004
+KEYWORDSET_MAX = 8
+SCI_SETKEYWORDS = 4005
+SCI_SETLEXERLANGUAGE = 4006
+SCI_LOADLEXERLIBRARY = 4007
+SCI_GETPROPERTY = 4008
+SCI_GETPROPERTYEXPANDED = 4009
+SCI_GETPROPERTYINT = 4010
+SCI_GETSTYLEBITSNEEDED = 4011
+SC_MOD_INSERTTEXT = 0x1
+SC_MOD_DELETETEXT = 0x2
+SC_MOD_CHANGESTYLE = 0x4
+SC_MOD_CHANGEFOLD = 0x8
+SC_PERFORMED_USER = 0x10
+SC_PERFORMED_UNDO = 0x20
+SC_PERFORMED_REDO = 0x40
+SC_MULTISTEPUNDOREDO = 0x80
+SC_LASTSTEPINUNDOREDO = 0x100
+SC_MOD_CHANGEMARKER = 0x200
+SC_MOD_BEFOREINSERT = 0x400
+SC_MOD_BEFOREDELETE = 0x800
+SC_MULTILINEUNDOREDO = 0x1000
+SC_STARTACTION = 0x2000
+SC_MOD_CHANGEINDICATOR = 0x4000
+SC_MOD_CHANGELINESTATE = 0x8000
+SC_MODEVENTMASKALL = 0xFFFF
+SCEN_CHANGE = 768
+SCEN_SETFOCUS = 512
+SCEN_KILLFOCUS = 256
+SCK_DOWN = 300
+SCK_UP = 301
+SCK_LEFT = 302
+SCK_RIGHT = 303
+SCK_HOME = 304
+SCK_END = 305
+SCK_PRIOR = 306
+SCK_NEXT = 307
+SCK_DELETE = 308
+SCK_INSERT = 309
+SCK_ESCAPE = 7
+SCK_BACK = 8
+SCK_TAB = 9
+SCK_RETURN = 13
+SCK_ADD = 310
+SCK_SUBTRACT = 311
+SCK_DIVIDE = 312
+SCK_WIN = 313
+SCK_RWIN = 314
+SCK_MENU = 315
+SCMOD_NORM = 0
+SCMOD_SHIFT = 1
+SCMOD_CTRL = 2
+SCMOD_ALT = 4
+SCN_STYLENEEDED = 2000
+SCN_CHARADDED = 2001
+SCN_SAVEPOINTREACHED = 2002
+SCN_SAVEPOINTLEFT = 2003
+SCN_MODIFYATTEMPTRO = 2004
+SCN_KEY = 2005
+SCN_DOUBLECLICK = 2006
+SCN_UPDATEUI = 2007
+SCN_MODIFIED = 2008
+SCN_MACRORECORD = 2009
+SCN_MARGINCLICK = 2010
+SCN_NEEDSHOWN = 2011
+SCN_PAINTED = 2013
+SCN_USERLISTSELECTION = 2014
+SCN_URIDROPPED = 2015
+SCN_DWELLSTART = 2016
+SCN_DWELLEND = 2017
+SCN_ZOOM = 2018
+SCN_HOTSPOTCLICK = 2019
+SCN_HOTSPOTDOUBLECLICK = 2020
+SCN_CALLTIPCLICK = 2021
+SCN_AUTOCSELECTION = 2022
+SCN_INDICATORCLICK = 2023
+SCN_INDICATORRELEASE = 2024
+SCN_AUTOCCANCELLED = 2025
+SCI_SETCARETPOLICY = 2369
+CARET_CENTER = 0x02
+CARET_XEVEN = 0x08
+CARET_XJUMPS = 0x10
+SCN_POSCHANGED = 2012
+SCN_CHECKBRACE = 2007
+# Generated by h2py from Include\scilexer.h
+SCLEX_CONTAINER = 0
+SCLEX_NULL = 1
+SCLEX_PYTHON = 2
+SCLEX_CPP = 3
+SCLEX_HTML = 4
+SCLEX_XML = 5
+SCLEX_PERL = 6
+SCLEX_SQL = 7
+SCLEX_VB = 8
+SCLEX_PROPERTIES = 9
+SCLEX_ERRORLIST = 10
+SCLEX_MAKEFILE = 11
+SCLEX_BATCH = 12
+SCLEX_XCODE = 13
+SCLEX_LATEX = 14
+SCLEX_LUA = 15
+SCLEX_DIFF = 16
+SCLEX_CONF = 17
+SCLEX_PASCAL = 18
+SCLEX_AVE = 19
+SCLEX_ADA = 20
+SCLEX_LISP = 21
+SCLEX_RUBY = 22
+SCLEX_EIFFEL = 23
+SCLEX_EIFFELKW = 24
+SCLEX_TCL = 25
+SCLEX_NNCRONTAB = 26
+SCLEX_BULLANT = 27
+SCLEX_VBSCRIPT = 28
+SCLEX_BAAN = 31
+SCLEX_MATLAB = 32
+SCLEX_SCRIPTOL = 33
+SCLEX_ASM = 34
+SCLEX_CPPNOCASE = 35
+SCLEX_FORTRAN = 36
+SCLEX_F77 = 37
+SCLEX_CSS = 38
+SCLEX_POV = 39
+SCLEX_LOUT = 40
+SCLEX_ESCRIPT = 41
+SCLEX_PS = 42
+SCLEX_NSIS = 43
+SCLEX_MMIXAL = 44
+SCLEX_CLW = 45
+SCLEX_CLWNOCASE = 46
+SCLEX_LOT = 47
+SCLEX_YAML = 48
+SCLEX_TEX = 49
+SCLEX_METAPOST = 50
+SCLEX_POWERBASIC = 51
+SCLEX_FORTH = 52
+SCLEX_ERLANG = 53
+SCLEX_OCTAVE = 54
+SCLEX_MSSQL = 55
+SCLEX_VERILOG = 56
+SCLEX_KIX = 57
+SCLEX_GUI4CLI = 58
+SCLEX_SPECMAN = 59
+SCLEX_AU3 = 60
+SCLEX_APDL = 61
+SCLEX_BASH = 62
+SCLEX_ASN1 = 63
+SCLEX_VHDL = 64
+SCLEX_CAML = 65
+SCLEX_BLITZBASIC = 66
+SCLEX_PUREBASIC = 67
+SCLEX_HASKELL = 68
+SCLEX_PHPSCRIPT = 69
+SCLEX_TADS3 = 70
+SCLEX_REBOL = 71
+SCLEX_SMALLTALK = 72
+SCLEX_FLAGSHIP = 73
+SCLEX_CSOUND = 74
+SCLEX_FREEBASIC = 75
+SCLEX_INNOSETUP = 76
+SCLEX_OPAL = 77
+SCLEX_SPICE = 78
+SCLEX_D = 79
+SCLEX_CMAKE = 80
+SCLEX_GAP = 81
+SCLEX_PLM = 82
+SCLEX_PROGRESS = 83
+SCLEX_ABAQUS = 84
+SCLEX_ASYMPTOTE = 85
+SCLEX_R = 86
+SCLEX_MAGIK = 87
+SCLEX_POWERSHELL = 88
+SCLEX_MYSQL = 89
+SCLEX_PO = 90
+SCLEX_AUTOMATIC = 1000
+SCE_P_DEFAULT = 0
+SCE_P_COMMENTLINE = 1
+SCE_P_NUMBER = 2
+SCE_P_STRING = 3
+SCE_P_CHARACTER = 4
+SCE_P_WORD = 5
+SCE_P_TRIPLE = 6
+SCE_P_TRIPLEDOUBLE = 7
+SCE_P_CLASSNAME = 8
+SCE_P_DEFNAME = 9
+SCE_P_OPERATOR = 10
+SCE_P_IDENTIFIER = 11
+SCE_P_COMMENTBLOCK = 12
+SCE_P_STRINGEOL = 13
+SCE_P_WORD2 = 14
+SCE_P_DECORATOR = 15
+SCE_C_DEFAULT = 0
+SCE_C_COMMENT = 1
+SCE_C_COMMENTLINE = 2
+SCE_C_COMMENTDOC = 3
+SCE_C_NUMBER = 4
+SCE_C_WORD = 5
+SCE_C_STRING = 6
+SCE_C_CHARACTER = 7
+SCE_C_UUID = 8
+SCE_C_PREPROCESSOR = 9
+SCE_C_OPERATOR = 10
+SCE_C_IDENTIFIER = 11
+SCE_C_STRINGEOL = 12
+SCE_C_VERBATIM = 13
+SCE_C_REGEX = 14
+SCE_C_COMMENTLINEDOC = 15
+SCE_C_WORD2 = 16
+SCE_C_COMMENTDOCKEYWORD = 17
+SCE_C_COMMENTDOCKEYWORDERROR = 18
+SCE_C_GLOBALCLASS = 19
+SCE_D_DEFAULT = 0
+SCE_D_COMMENT = 1
+SCE_D_COMMENTLINE = 2
+SCE_D_COMMENTDOC = 3
+SCE_D_COMMENTNESTED = 4
+SCE_D_NUMBER = 5
+SCE_D_WORD = 6
+SCE_D_WORD2 = 7
+SCE_D_WORD3 = 8
+SCE_D_TYPEDEF = 9
+SCE_D_STRING = 10
+SCE_D_STRINGEOL = 11
+SCE_D_CHARACTER = 12
+SCE_D_OPERATOR = 13
+SCE_D_IDENTIFIER = 14
+SCE_D_COMMENTLINEDOC = 15
+SCE_D_COMMENTDOCKEYWORD = 16
+SCE_D_COMMENTDOCKEYWORDERROR = 17
+SCE_TCL_DEFAULT = 0
+SCE_TCL_COMMENT = 1
+SCE_TCL_COMMENTLINE = 2
+SCE_TCL_NUMBER = 3
+SCE_TCL_WORD_IN_QUOTE = 4
+SCE_TCL_IN_QUOTE = 5
+SCE_TCL_OPERATOR = 6
+SCE_TCL_IDENTIFIER = 7
+SCE_TCL_SUBSTITUTION = 8
+SCE_TCL_SUB_BRACE = 9
+SCE_TCL_MODIFIER = 10
+SCE_TCL_EXPAND = 11
+SCE_TCL_WORD = 12
+SCE_TCL_WORD2 = 13
+SCE_TCL_WORD3 = 14
+SCE_TCL_WORD4 = 15
+SCE_TCL_WORD5 = 16
+SCE_TCL_WORD6 = 17
+SCE_TCL_WORD7 = 18
+SCE_TCL_WORD8 = 19
+SCE_TCL_COMMENT_BOX = 20
+SCE_TCL_BLOCK_COMMENT = 21
+SCE_H_DEFAULT = 0
+SCE_H_TAG = 1
+SCE_H_TAGUNKNOWN = 2
+SCE_H_ATTRIBUTE = 3
+SCE_H_ATTRIBUTEUNKNOWN = 4
+SCE_H_NUMBER = 5
+SCE_H_DOUBLESTRING = 6
+SCE_H_SINGLESTRING = 7
+SCE_H_OTHER = 8
+SCE_H_COMMENT = 9
+SCE_H_ENTITY = 10
+SCE_H_TAGEND = 11
+SCE_H_XMLSTART = 12
+SCE_H_XMLEND = 13
+SCE_H_SCRIPT = 14
+SCE_H_ASP = 15
+SCE_H_ASPAT = 16
+SCE_H_CDATA = 17
+SCE_H_QUESTION = 18
+SCE_H_VALUE = 19
+SCE_H_XCCOMMENT = 20
+SCE_H_SGML_DEFAULT = 21
+SCE_H_SGML_COMMAND = 22
+SCE_H_SGML_1ST_PARAM = 23
+SCE_H_SGML_DOUBLESTRING = 24
+SCE_H_SGML_SIMPLESTRING = 25
+SCE_H_SGML_ERROR = 26
+SCE_H_SGML_SPECIAL = 27
+SCE_H_SGML_ENTITY = 28
+SCE_H_SGML_COMMENT = 29
+SCE_H_SGML_1ST_PARAM_COMMENT = 30
+SCE_H_SGML_BLOCK_DEFAULT = 31
+SCE_HJ_START = 40
+SCE_HJ_DEFAULT = 41
+SCE_HJ_COMMENT = 42
+SCE_HJ_COMMENTLINE = 43
+SCE_HJ_COMMENTDOC = 44
+SCE_HJ_NUMBER = 45
+SCE_HJ_WORD = 46
+SCE_HJ_KEYWORD = 47
+SCE_HJ_DOUBLESTRING = 48
+SCE_HJ_SINGLESTRING = 49
+SCE_HJ_SYMBOLS = 50
+SCE_HJ_STRINGEOL = 51
+SCE_HJ_REGEX = 52
+SCE_HJA_START = 55
+SCE_HJA_DEFAULT = 56
+SCE_HJA_COMMENT = 57
+SCE_HJA_COMMENTLINE = 58
+SCE_HJA_COMMENTDOC = 59
+SCE_HJA_NUMBER = 60
+SCE_HJA_WORD = 61
+SCE_HJA_KEYWORD = 62
+SCE_HJA_DOUBLESTRING = 63
+SCE_HJA_SINGLESTRING = 64
+SCE_HJA_SYMBOLS = 65
+SCE_HJA_STRINGEOL = 66
+SCE_HJA_REGEX = 67
+SCE_HB_START = 70
+SCE_HB_DEFAULT = 71
+SCE_HB_COMMENTLINE = 72
+SCE_HB_NUMBER = 73
+SCE_HB_WORD = 74
+SCE_HB_STRING = 75
+SCE_HB_IDENTIFIER = 76
+SCE_HB_STRINGEOL = 77
+SCE_HBA_START = 80
+SCE_HBA_DEFAULT = 81
+SCE_HBA_COMMENTLINE = 82
+SCE_HBA_NUMBER = 83
+SCE_HBA_WORD = 84
+SCE_HBA_STRING = 85
+SCE_HBA_IDENTIFIER = 86
+SCE_HBA_STRINGEOL = 87
+SCE_HP_START = 90
+SCE_HP_DEFAULT = 91
+SCE_HP_COMMENTLINE = 92
+SCE_HP_NUMBER = 93
+SCE_HP_STRING = 94
+SCE_HP_CHARACTER = 95
+SCE_HP_WORD = 96
+SCE_HP_TRIPLE = 97
+SCE_HP_TRIPLEDOUBLE = 98
+SCE_HP_CLASSNAME = 99
+SCE_HP_DEFNAME = 100
+SCE_HP_OPERATOR = 101
+SCE_HP_IDENTIFIER = 102
+SCE_HPHP_COMPLEX_VARIABLE = 104
+SCE_HPA_START = 105
+SCE_HPA_DEFAULT = 106
+SCE_HPA_COMMENTLINE = 107
+SCE_HPA_NUMBER = 108
+SCE_HPA_STRING = 109
+SCE_HPA_CHARACTER = 110
+SCE_HPA_WORD = 111
+SCE_HPA_TRIPLE = 112
+SCE_HPA_TRIPLEDOUBLE = 113
+SCE_HPA_CLASSNAME = 114
+SCE_HPA_DEFNAME = 115
+SCE_HPA_OPERATOR = 116
+SCE_HPA_IDENTIFIER = 117
+SCE_HPHP_DEFAULT = 118
+SCE_HPHP_HSTRING = 119
+SCE_HPHP_SIMPLESTRING = 120
+SCE_HPHP_WORD = 121
+SCE_HPHP_NUMBER = 122
+SCE_HPHP_VARIABLE = 123
+SCE_HPHP_COMMENT = 124
+SCE_HPHP_COMMENTLINE = 125
+SCE_HPHP_HSTRING_VARIABLE = 126
+SCE_HPHP_OPERATOR = 127
+SCE_PL_DEFAULT = 0
+SCE_PL_ERROR = 1
+SCE_PL_COMMENTLINE = 2
+SCE_PL_POD = 3
+SCE_PL_NUMBER = 4
+SCE_PL_WORD = 5
+SCE_PL_STRING = 6
+SCE_PL_CHARACTER = 7
+SCE_PL_PUNCTUATION = 8
+SCE_PL_PREPROCESSOR = 9
+SCE_PL_OPERATOR = 10
+SCE_PL_IDENTIFIER = 11
+SCE_PL_SCALAR = 12
+SCE_PL_ARRAY = 13
+SCE_PL_HASH = 14
+SCE_PL_SYMBOLTABLE = 15
+SCE_PL_VARIABLE_INDEXER = 16
+SCE_PL_REGEX = 17
+SCE_PL_REGSUBST = 18
+SCE_PL_LONGQUOTE = 19
+SCE_PL_BACKTICKS = 20
+SCE_PL_DATASECTION = 21
+SCE_PL_HERE_DELIM = 22
+SCE_PL_HERE_Q = 23
+SCE_PL_HERE_QQ = 24
+SCE_PL_HERE_QX = 25
+SCE_PL_STRING_Q = 26
+SCE_PL_STRING_QQ = 27
+SCE_PL_STRING_QX = 28
+SCE_PL_STRING_QR = 29
+SCE_PL_STRING_QW = 30
+SCE_PL_POD_VERB = 31
+SCE_PL_SUB_PROTOTYPE = 40
+SCE_PL_FORMAT_IDENT = 41
+SCE_PL_FORMAT = 42
+SCE_RB_DEFAULT = 0
+SCE_RB_ERROR = 1
+SCE_RB_COMMENTLINE = 2
+SCE_RB_POD = 3
+SCE_RB_NUMBER = 4
+SCE_RB_WORD = 5
+SCE_RB_STRING = 6
+SCE_RB_CHARACTER = 7
+SCE_RB_CLASSNAME = 8
+SCE_RB_DEFNAME = 9
+SCE_RB_OPERATOR = 10
+SCE_RB_IDENTIFIER = 11
+SCE_RB_REGEX = 12
+SCE_RB_GLOBAL = 13
+SCE_RB_SYMBOL = 14
+SCE_RB_MODULE_NAME = 15
+SCE_RB_INSTANCE_VAR = 16
+SCE_RB_CLASS_VAR = 17
+SCE_RB_BACKTICKS = 18
+SCE_RB_DATASECTION = 19
+SCE_RB_HERE_DELIM = 20
+SCE_RB_HERE_Q = 21
+SCE_RB_HERE_QQ = 22
+SCE_RB_HERE_QX = 23
+SCE_RB_STRING_Q = 24
+SCE_RB_STRING_QQ = 25
+SCE_RB_STRING_QX = 26
+SCE_RB_STRING_QR = 27
+SCE_RB_STRING_QW = 28
+SCE_RB_WORD_DEMOTED = 29
+SCE_RB_STDIN = 30
+SCE_RB_STDOUT = 31
+SCE_RB_STDERR = 40
+SCE_RB_UPPER_BOUND = 41
+SCE_B_DEFAULT = 0
+SCE_B_COMMENT = 1
+SCE_B_NUMBER = 2
+SCE_B_KEYWORD = 3
+SCE_B_STRING = 4
+SCE_B_PREPROCESSOR = 5
+SCE_B_OPERATOR = 6
+SCE_B_IDENTIFIER = 7
+SCE_B_DATE = 8
+SCE_B_STRINGEOL = 9
+SCE_B_KEYWORD2 = 10
+SCE_B_KEYWORD3 = 11
+SCE_B_KEYWORD4 = 12
+SCE_B_CONSTANT = 13
+SCE_B_ASM = 14
+SCE_B_LABEL = 15
+SCE_B_ERROR = 16
+SCE_B_HEXNUMBER = 17
+SCE_B_BINNUMBER = 18
+SCE_PROPS_DEFAULT = 0
+SCE_PROPS_COMMENT = 1
+SCE_PROPS_SECTION = 2
+SCE_PROPS_ASSIGNMENT = 3
+SCE_PROPS_DEFVAL = 4
+SCE_PROPS_KEY = 5
+SCE_L_DEFAULT = 0
+SCE_L_COMMAND = 1
+SCE_L_TAG = 2
+SCE_L_MATH = 3
+SCE_L_COMMENT = 4
+SCE_LUA_DEFAULT = 0
+SCE_LUA_COMMENT = 1
+SCE_LUA_COMMENTLINE = 2
+SCE_LUA_COMMENTDOC = 3
+SCE_LUA_NUMBER = 4
+SCE_LUA_WORD = 5
+SCE_LUA_STRING = 6
+SCE_LUA_CHARACTER = 7
+SCE_LUA_LITERALSTRING = 8
+SCE_LUA_PREPROCESSOR = 9
+SCE_LUA_OPERATOR = 10
+SCE_LUA_IDENTIFIER = 11
+SCE_LUA_STRINGEOL = 12
+SCE_LUA_WORD2 = 13
+SCE_LUA_WORD3 = 14
+SCE_LUA_WORD4 = 15
+SCE_LUA_WORD5 = 16
+SCE_LUA_WORD6 = 17
+SCE_LUA_WORD7 = 18
+SCE_LUA_WORD8 = 19
+SCE_ERR_DEFAULT = 0
+SCE_ERR_PYTHON = 1
+SCE_ERR_GCC = 2
+SCE_ERR_MS = 3
+SCE_ERR_CMD = 4
+SCE_ERR_BORLAND = 5
+SCE_ERR_PERL = 6
+SCE_ERR_NET = 7
+SCE_ERR_LUA = 8
+SCE_ERR_CTAG = 9
+SCE_ERR_DIFF_CHANGED = 10
+SCE_ERR_DIFF_ADDITION = 11
+SCE_ERR_DIFF_DELETION = 12
+SCE_ERR_DIFF_MESSAGE = 13
+SCE_ERR_PHP = 14
+SCE_ERR_ELF = 15
+SCE_ERR_IFC = 16
+SCE_ERR_IFORT = 17
+SCE_ERR_ABSF = 18
+SCE_ERR_TIDY = 19
+SCE_ERR_JAVA_STACK = 20
+SCE_ERR_VALUE = 21
+SCE_BAT_DEFAULT = 0
+SCE_BAT_COMMENT = 1
+SCE_BAT_WORD = 2
+SCE_BAT_LABEL = 3
+SCE_BAT_HIDE = 4
+SCE_BAT_COMMAND = 5
+SCE_BAT_IDENTIFIER = 6
+SCE_BAT_OPERATOR = 7
+SCE_MAKE_DEFAULT = 0
+SCE_MAKE_COMMENT = 1
+SCE_MAKE_PREPROCESSOR = 2
+SCE_MAKE_IDENTIFIER = 3
+SCE_MAKE_OPERATOR = 4
+SCE_MAKE_TARGET = 5
+SCE_MAKE_IDEOL = 9
+SCE_DIFF_DEFAULT = 0
+SCE_DIFF_COMMENT = 1
+SCE_DIFF_COMMAND = 2
+SCE_DIFF_HEADER = 3
+SCE_DIFF_POSITION = 4
+SCE_DIFF_DELETED = 5
+SCE_DIFF_ADDED = 6
+SCE_DIFF_CHANGED = 7
+SCE_CONF_DEFAULT = 0
+SCE_CONF_COMMENT = 1
+SCE_CONF_NUMBER = 2
+SCE_CONF_IDENTIFIER = 3
+SCE_CONF_EXTENSION = 4
+SCE_CONF_PARAMETER = 5
+SCE_CONF_STRING = 6
+SCE_CONF_OPERATOR = 7
+SCE_CONF_IP = 8
+SCE_CONF_DIRECTIVE = 9
+SCE_AVE_DEFAULT = 0
+SCE_AVE_COMMENT = 1
+SCE_AVE_NUMBER = 2
+SCE_AVE_WORD = 3
+SCE_AVE_STRING = 6
+SCE_AVE_ENUM = 7
+SCE_AVE_STRINGEOL = 8
+SCE_AVE_IDENTIFIER = 9
+SCE_AVE_OPERATOR = 10
+SCE_AVE_WORD1 = 11
+SCE_AVE_WORD2 = 12
+SCE_AVE_WORD3 = 13
+SCE_AVE_WORD4 = 14
+SCE_AVE_WORD5 = 15
+SCE_AVE_WORD6 = 16
+SCE_ADA_DEFAULT = 0
+SCE_ADA_WORD = 1
+SCE_ADA_IDENTIFIER = 2
+SCE_ADA_NUMBER = 3
+SCE_ADA_DELIMITER = 4
+SCE_ADA_CHARACTER = 5
+SCE_ADA_CHARACTEREOL = 6
+SCE_ADA_STRING = 7
+SCE_ADA_STRINGEOL = 8
+SCE_ADA_LABEL = 9
+SCE_ADA_COMMENTLINE = 10
+SCE_ADA_ILLEGAL = 11
+SCE_BAAN_DEFAULT = 0
+SCE_BAAN_COMMENT = 1
+SCE_BAAN_COMMENTDOC = 2
+SCE_BAAN_NUMBER = 3
+SCE_BAAN_WORD = 4
+SCE_BAAN_STRING = 5
+SCE_BAAN_PREPROCESSOR = 6
+SCE_BAAN_OPERATOR = 7
+SCE_BAAN_IDENTIFIER = 8
+SCE_BAAN_STRINGEOL = 9
+SCE_BAAN_WORD2 = 10
+SCE_LISP_DEFAULT = 0
+SCE_LISP_COMMENT = 1
+SCE_LISP_NUMBER = 2
+SCE_LISP_KEYWORD = 3
+SCE_LISP_KEYWORD_KW = 4
+SCE_LISP_SYMBOL = 5
+SCE_LISP_STRING = 6
+SCE_LISP_STRINGEOL = 8
+SCE_LISP_IDENTIFIER = 9
+SCE_LISP_OPERATOR = 10
+SCE_LISP_SPECIAL = 11
+SCE_LISP_MULTI_COMMENT = 12
+SCE_EIFFEL_DEFAULT = 0
+SCE_EIFFEL_COMMENTLINE = 1
+SCE_EIFFEL_NUMBER = 2
+SCE_EIFFEL_WORD = 3
+SCE_EIFFEL_STRING = 4
+SCE_EIFFEL_CHARACTER = 5
+SCE_EIFFEL_OPERATOR = 6
+SCE_EIFFEL_IDENTIFIER = 7
+SCE_EIFFEL_STRINGEOL = 8
+SCE_NNCRONTAB_DEFAULT = 0
+SCE_NNCRONTAB_COMMENT = 1
+SCE_NNCRONTAB_TASK = 2
+SCE_NNCRONTAB_SECTION = 3
+SCE_NNCRONTAB_KEYWORD = 4
+SCE_NNCRONTAB_MODIFIER = 5
+SCE_NNCRONTAB_ASTERISK = 6
+SCE_NNCRONTAB_NUMBER = 7
+SCE_NNCRONTAB_STRING = 8
+SCE_NNCRONTAB_ENVIRONMENT = 9
+SCE_NNCRONTAB_IDENTIFIER = 10
+SCE_FORTH_DEFAULT = 0
+SCE_FORTH_COMMENT = 1
+SCE_FORTH_COMMENT_ML = 2
+SCE_FORTH_IDENTIFIER = 3
+SCE_FORTH_CONTROL = 4
+SCE_FORTH_KEYWORD = 5
+SCE_FORTH_DEFWORD = 6
+SCE_FORTH_PREWORD1 = 7
+SCE_FORTH_PREWORD2 = 8
+SCE_FORTH_NUMBER = 9
+SCE_FORTH_STRING = 10
+SCE_FORTH_LOCALE = 11
+SCE_MATLAB_DEFAULT = 0
+SCE_MATLAB_COMMENT = 1
+SCE_MATLAB_COMMAND = 2
+SCE_MATLAB_NUMBER = 3
+SCE_MATLAB_KEYWORD = 4
+SCE_MATLAB_STRING = 5
+SCE_MATLAB_OPERATOR = 6
+SCE_MATLAB_IDENTIFIER = 7
+SCE_MATLAB_DOUBLEQUOTESTRING = 8
+SCE_SCRIPTOL_DEFAULT = 0
+SCE_SCRIPTOL_WHITE = 1
+SCE_SCRIPTOL_COMMENTLINE = 2
+SCE_SCRIPTOL_PERSISTENT = 3
+SCE_SCRIPTOL_CSTYLE = 4
+SCE_SCRIPTOL_COMMENTBLOCK = 5
+SCE_SCRIPTOL_NUMBER = 6
+SCE_SCRIPTOL_STRING = 7
+SCE_SCRIPTOL_CHARACTER = 8
+SCE_SCRIPTOL_STRINGEOL = 9
+SCE_SCRIPTOL_KEYWORD = 10
+SCE_SCRIPTOL_OPERATOR = 11
+SCE_SCRIPTOL_IDENTIFIER = 12
+SCE_SCRIPTOL_TRIPLE = 13
+SCE_SCRIPTOL_CLASSNAME = 14
+SCE_SCRIPTOL_PREPROCESSOR = 15
+SCE_ASM_DEFAULT = 0
+SCE_ASM_COMMENT = 1
+SCE_ASM_NUMBER = 2
+SCE_ASM_STRING = 3
+SCE_ASM_OPERATOR = 4
+SCE_ASM_IDENTIFIER = 5
+SCE_ASM_CPUINSTRUCTION = 6
+SCE_ASM_MATHINSTRUCTION = 7
+SCE_ASM_REGISTER = 8
+SCE_ASM_DIRECTIVE = 9
+SCE_ASM_DIRECTIVEOPERAND = 10
+SCE_ASM_COMMENTBLOCK = 11
+SCE_ASM_CHARACTER = 12
+SCE_ASM_STRINGEOL = 13
+SCE_ASM_EXTINSTRUCTION = 14
+SCE_F_DEFAULT = 0
+SCE_F_COMMENT = 1
+SCE_F_NUMBER = 2
+SCE_F_STRING1 = 3
+SCE_F_STRING2 = 4
+SCE_F_STRINGEOL = 5
+SCE_F_OPERATOR = 6
+SCE_F_IDENTIFIER = 7
+SCE_F_WORD = 8
+SCE_F_WORD2 = 9
+SCE_F_WORD3 = 10
+SCE_F_PREPROCESSOR = 11
+SCE_F_OPERATOR2 = 12
+SCE_F_LABEL = 13
+SCE_F_CONTINUATION = 14
+SCE_CSS_DEFAULT = 0
+SCE_CSS_TAG = 1
+SCE_CSS_CLASS = 2
+SCE_CSS_PSEUDOCLASS = 3
+SCE_CSS_UNKNOWN_PSEUDOCLASS = 4
+SCE_CSS_OPERATOR = 5
+SCE_CSS_IDENTIFIER = 6
+SCE_CSS_UNKNOWN_IDENTIFIER = 7
+SCE_CSS_VALUE = 8
+SCE_CSS_COMMENT = 9
+SCE_CSS_ID = 10
+SCE_CSS_IMPORTANT = 11
+SCE_CSS_DIRECTIVE = 12
+SCE_CSS_DOUBLESTRING = 13
+SCE_CSS_SINGLESTRING = 14
+SCE_CSS_IDENTIFIER2 = 15
+SCE_CSS_ATTRIBUTE = 16
+SCE_CSS_IDENTIFIER3 = 17
+SCE_CSS_PSEUDOELEMENT = 18
+SCE_CSS_EXTENDED_IDENTIFIER = 19
+SCE_CSS_EXTENDED_PSEUDOCLASS = 20
+SCE_CSS_EXTENDED_PSEUDOELEMENT = 21
+SCE_POV_DEFAULT = 0
+SCE_POV_COMMENT = 1
+SCE_POV_COMMENTLINE = 2
+SCE_POV_NUMBER = 3
+SCE_POV_OPERATOR = 4
+SCE_POV_IDENTIFIER = 5
+SCE_POV_STRING = 6
+SCE_POV_STRINGEOL = 7
+SCE_POV_DIRECTIVE = 8
+SCE_POV_BADDIRECTIVE = 9
+SCE_POV_WORD2 = 10
+SCE_POV_WORD3 = 11
+SCE_POV_WORD4 = 12
+SCE_POV_WORD5 = 13
+SCE_POV_WORD6 = 14
+SCE_POV_WORD7 = 15
+SCE_POV_WORD8 = 16
+SCE_LOUT_DEFAULT = 0
+SCE_LOUT_COMMENT = 1
+SCE_LOUT_NUMBER = 2
+SCE_LOUT_WORD = 3
+SCE_LOUT_WORD2 = 4
+SCE_LOUT_WORD3 = 5
+SCE_LOUT_WORD4 = 6
+SCE_LOUT_STRING = 7
+SCE_LOUT_OPERATOR = 8
+SCE_LOUT_IDENTIFIER = 9
+SCE_LOUT_STRINGEOL = 10
+SCE_ESCRIPT_DEFAULT = 0
+SCE_ESCRIPT_COMMENT = 1
+SCE_ESCRIPT_COMMENTLINE = 2
+SCE_ESCRIPT_COMMENTDOC = 3
+SCE_ESCRIPT_NUMBER = 4
+SCE_ESCRIPT_WORD = 5
+SCE_ESCRIPT_STRING = 6
+SCE_ESCRIPT_OPERATOR = 7
+SCE_ESCRIPT_IDENTIFIER = 8
+SCE_ESCRIPT_BRACE = 9
+SCE_ESCRIPT_WORD2 = 10
+SCE_ESCRIPT_WORD3 = 11
+SCE_PS_DEFAULT = 0
+SCE_PS_COMMENT = 1
+SCE_PS_DSC_COMMENT = 2
+SCE_PS_DSC_VALUE = 3
+SCE_PS_NUMBER = 4
+SCE_PS_NAME = 5
+SCE_PS_KEYWORD = 6
+SCE_PS_LITERAL = 7
+SCE_PS_IMMEVAL = 8
+SCE_PS_PAREN_ARRAY = 9
+SCE_PS_PAREN_DICT = 10
+SCE_PS_PAREN_PROC = 11
+SCE_PS_TEXT = 12
+SCE_PS_HEXSTRING = 13
+SCE_PS_BASE85STRING = 14
+SCE_PS_BADSTRINGCHAR = 15
+SCE_NSIS_DEFAULT = 0
+SCE_NSIS_COMMENT = 1
+SCE_NSIS_STRINGDQ = 2
+SCE_NSIS_STRINGLQ = 3
+SCE_NSIS_STRINGRQ = 4
+SCE_NSIS_FUNCTION = 5
+SCE_NSIS_VARIABLE = 6
+SCE_NSIS_LABEL = 7
+SCE_NSIS_USERDEFINED = 8
+SCE_NSIS_SECTIONDEF = 9
+SCE_NSIS_SUBSECTIONDEF = 10
+SCE_NSIS_IFDEFINEDEF = 11
+SCE_NSIS_MACRODEF = 12
+SCE_NSIS_STRINGVAR = 13
+SCE_NSIS_NUMBER = 14
+SCE_NSIS_SECTIONGROUP = 15
+SCE_NSIS_PAGEEX = 16
+SCE_NSIS_FUNCTIONDEF = 17
+SCE_NSIS_COMMENTBOX = 18
+SCE_MMIXAL_LEADWS = 0
+SCE_MMIXAL_COMMENT = 1
+SCE_MMIXAL_LABEL = 2
+SCE_MMIXAL_OPCODE = 3
+SCE_MMIXAL_OPCODE_PRE = 4
+SCE_MMIXAL_OPCODE_VALID = 5
+SCE_MMIXAL_OPCODE_UNKNOWN = 6
+SCE_MMIXAL_OPCODE_POST = 7
+SCE_MMIXAL_OPERANDS = 8
+SCE_MMIXAL_NUMBER = 9
+SCE_MMIXAL_REF = 10
+SCE_MMIXAL_CHAR = 11
+SCE_MMIXAL_STRING = 12
+SCE_MMIXAL_REGISTER = 13
+SCE_MMIXAL_HEX = 14
+SCE_MMIXAL_OPERATOR = 15
+SCE_MMIXAL_SYMBOL = 16
+SCE_MMIXAL_INCLUDE = 17
+SCE_CLW_DEFAULT = 0
+SCE_CLW_LABEL = 1
+SCE_CLW_COMMENT = 2
+SCE_CLW_STRING = 3
+SCE_CLW_USER_IDENTIFIER = 4
+SCE_CLW_INTEGER_CONSTANT = 5
+SCE_CLW_REAL_CONSTANT = 6
+SCE_CLW_PICTURE_STRING = 7
+SCE_CLW_KEYWORD = 8
+SCE_CLW_COMPILER_DIRECTIVE = 9
+SCE_CLW_RUNTIME_EXPRESSIONS = 10
+SCE_CLW_BUILTIN_PROCEDURES_FUNCTION = 11
+SCE_CLW_STRUCTURE_DATA_TYPE = 12
+SCE_CLW_ATTRIBUTE = 13
+SCE_CLW_STANDARD_EQUATE = 14
+SCE_CLW_ERROR = 15
+SCE_CLW_DEPRECATED = 16
+SCE_LOT_DEFAULT = 0
+SCE_LOT_HEADER = 1
+SCE_LOT_BREAK = 2
+SCE_LOT_SET = 3
+SCE_LOT_PASS = 4
+SCE_LOT_FAIL = 5
+SCE_LOT_ABORT = 6
+SCE_YAML_DEFAULT = 0
+SCE_YAML_COMMENT = 1
+SCE_YAML_IDENTIFIER = 2
+SCE_YAML_KEYWORD = 3
+SCE_YAML_NUMBER = 4
+SCE_YAML_REFERENCE = 5
+SCE_YAML_DOCUMENT = 6
+SCE_YAML_TEXT = 7
+SCE_YAML_ERROR = 8
+SCE_YAML_OPERATOR = 9
+SCE_TEX_DEFAULT = 0
+SCE_TEX_SPECIAL = 1
+SCE_TEX_GROUP = 2
+SCE_TEX_SYMBOL = 3
+SCE_TEX_COMMAND = 4
+SCE_TEX_TEXT = 5
+SCE_METAPOST_DEFAULT = 0
+SCE_METAPOST_SPECIAL = 1
+SCE_METAPOST_GROUP = 2
+SCE_METAPOST_SYMBOL = 3
+SCE_METAPOST_COMMAND = 4
+SCE_METAPOST_TEXT = 5
+SCE_METAPOST_EXTRA = 6
+SCE_ERLANG_DEFAULT = 0
+SCE_ERLANG_COMMENT = 1
+SCE_ERLANG_VARIABLE = 2
+SCE_ERLANG_NUMBER = 3
+SCE_ERLANG_KEYWORD = 4
+SCE_ERLANG_STRING = 5
+SCE_ERLANG_OPERATOR = 6
+SCE_ERLANG_ATOM = 7
+SCE_ERLANG_FUNCTION_NAME = 8
+SCE_ERLANG_CHARACTER = 9
+SCE_ERLANG_MACRO = 10
+SCE_ERLANG_RECORD = 11
+SCE_ERLANG_SEPARATOR = 12
+SCE_ERLANG_NODE_NAME = 13
+SCE_ERLANG_UNKNOWN = 31
+SCE_MSSQL_DEFAULT = 0
+SCE_MSSQL_COMMENT = 1
+SCE_MSSQL_LINE_COMMENT = 2
+SCE_MSSQL_NUMBER = 3
+SCE_MSSQL_STRING = 4
+SCE_MSSQL_OPERATOR = 5
+SCE_MSSQL_IDENTIFIER = 6
+SCE_MSSQL_VARIABLE = 7
+SCE_MSSQL_COLUMN_NAME = 8
+SCE_MSSQL_STATEMENT = 9
+SCE_MSSQL_DATATYPE = 10
+SCE_MSSQL_SYSTABLE = 11
+SCE_MSSQL_GLOBAL_VARIABLE = 12
+SCE_MSSQL_FUNCTION = 13
+SCE_MSSQL_STORED_PROCEDURE = 14
+SCE_MSSQL_DEFAULT_PREF_DATATYPE = 15
+SCE_MSSQL_COLUMN_NAME_2 = 16
+SCE_V_DEFAULT = 0
+SCE_V_COMMENT = 1
+SCE_V_COMMENTLINE = 2
+SCE_V_COMMENTLINEBANG = 3
+SCE_V_NUMBER = 4
+SCE_V_WORD = 5
+SCE_V_STRING = 6
+SCE_V_WORD2 = 7
+SCE_V_WORD3 = 8
+SCE_V_PREPROCESSOR = 9
+SCE_V_OPERATOR = 10
+SCE_V_IDENTIFIER = 11
+SCE_V_STRINGEOL = 12
+SCE_V_USER = 19
+SCE_KIX_DEFAULT = 0
+SCE_KIX_COMMENT = 1
+SCE_KIX_STRING1 = 2
+SCE_KIX_STRING2 = 3
+SCE_KIX_NUMBER = 4
+SCE_KIX_VAR = 5
+SCE_KIX_MACRO = 6
+SCE_KIX_KEYWORD = 7
+SCE_KIX_FUNCTIONS = 8
+SCE_KIX_OPERATOR = 9
+SCE_KIX_IDENTIFIER = 31
+SCE_GC_DEFAULT = 0
+SCE_GC_COMMENTLINE = 1
+SCE_GC_COMMENTBLOCK = 2
+SCE_GC_GLOBAL = 3
+SCE_GC_EVENT = 4
+SCE_GC_ATTRIBUTE = 5
+SCE_GC_CONTROL = 6
+SCE_GC_COMMAND = 7
+SCE_GC_STRING = 8
+SCE_GC_OPERATOR = 9
+SCE_SN_DEFAULT = 0
+SCE_SN_CODE = 1
+SCE_SN_COMMENTLINE = 2
+SCE_SN_COMMENTLINEBANG = 3
+SCE_SN_NUMBER = 4
+SCE_SN_WORD = 5
+SCE_SN_STRING = 6
+SCE_SN_WORD2 = 7
+SCE_SN_WORD3 = 8
+SCE_SN_PREPROCESSOR = 9
+SCE_SN_OPERATOR = 10
+SCE_SN_IDENTIFIER = 11
+SCE_SN_STRINGEOL = 12
+SCE_SN_REGEXTAG = 13
+SCE_SN_SIGNAL = 14
+SCE_SN_USER = 19
+SCE_AU3_DEFAULT = 0
+SCE_AU3_COMMENT = 1
+SCE_AU3_COMMENTBLOCK = 2
+SCE_AU3_NUMBER = 3
+SCE_AU3_FUNCTION = 4
+SCE_AU3_KEYWORD = 5
+SCE_AU3_MACRO = 6
+SCE_AU3_STRING = 7
+SCE_AU3_OPERATOR = 8
+SCE_AU3_VARIABLE = 9
+SCE_AU3_SENT = 10
+SCE_AU3_PREPROCESSOR = 11
+SCE_AU3_SPECIAL = 12
+SCE_AU3_EXPAND = 13
+SCE_AU3_COMOBJ = 14
+SCE_AU3_UDF = 15
+SCE_APDL_DEFAULT = 0
+SCE_APDL_COMMENT = 1
+SCE_APDL_COMMENTBLOCK = 2
+SCE_APDL_NUMBER = 3
+SCE_APDL_STRING = 4
+SCE_APDL_OPERATOR = 5
+SCE_APDL_WORD = 6
+SCE_APDL_PROCESSOR = 7
+SCE_APDL_COMMAND = 8
+SCE_APDL_SLASHCOMMAND = 9
+SCE_APDL_STARCOMMAND = 10
+SCE_APDL_ARGUMENT = 11
+SCE_APDL_FUNCTION = 12
+SCE_SH_DEFAULT = 0
+SCE_SH_ERROR = 1
+SCE_SH_COMMENTLINE = 2
+SCE_SH_NUMBER = 3
+SCE_SH_WORD = 4
+SCE_SH_STRING = 5
+SCE_SH_CHARACTER = 6
+SCE_SH_OPERATOR = 7
+SCE_SH_IDENTIFIER = 8
+SCE_SH_SCALAR = 9
+SCE_SH_PARAM = 10
+SCE_SH_BACKTICKS = 11
+SCE_SH_HERE_DELIM = 12
+SCE_SH_HERE_Q = 13
+SCE_ASN1_DEFAULT = 0
+SCE_ASN1_COMMENT = 1
+SCE_ASN1_IDENTIFIER = 2
+SCE_ASN1_STRING = 3
+SCE_ASN1_OID = 4
+SCE_ASN1_SCALAR = 5
+SCE_ASN1_KEYWORD = 6
+SCE_ASN1_ATTRIBUTE = 7
+SCE_ASN1_DESCRIPTOR = 8
+SCE_ASN1_TYPE = 9
+SCE_ASN1_OPERATOR = 10
+SCE_VHDL_DEFAULT = 0
+SCE_VHDL_COMMENT = 1
+SCE_VHDL_COMMENTLINEBANG = 2
+SCE_VHDL_NUMBER = 3
+SCE_VHDL_STRING = 4
+SCE_VHDL_OPERATOR = 5
+SCE_VHDL_IDENTIFIER = 6
+SCE_VHDL_STRINGEOL = 7
+SCE_VHDL_KEYWORD = 8
+SCE_VHDL_STDOPERATOR = 9
+SCE_VHDL_ATTRIBUTE = 10
+SCE_VHDL_STDFUNCTION = 11
+SCE_VHDL_STDPACKAGE = 12
+SCE_VHDL_STDTYPE = 13
+SCE_VHDL_USERWORD = 14
+SCE_CAML_DEFAULT = 0
+SCE_CAML_IDENTIFIER = 1
+SCE_CAML_TAGNAME = 2
+SCE_CAML_KEYWORD = 3
+SCE_CAML_KEYWORD2 = 4
+SCE_CAML_KEYWORD3 = 5
+SCE_CAML_LINENUM = 6
+SCE_CAML_OPERATOR = 7
+SCE_CAML_NUMBER = 8
+SCE_CAML_CHAR = 9
+SCE_CAML_STRING = 11
+SCE_CAML_COMMENT = 12
+SCE_CAML_COMMENT1 = 13
+SCE_CAML_COMMENT2 = 14
+SCE_CAML_COMMENT3 = 15
+SCE_HA_DEFAULT = 0
+SCE_HA_IDENTIFIER = 1
+SCE_HA_KEYWORD = 2
+SCE_HA_NUMBER = 3
+SCE_HA_STRING = 4
+SCE_HA_CHARACTER = 5
+SCE_HA_CLASS = 6
+SCE_HA_MODULE = 7
+SCE_HA_CAPITAL = 8
+SCE_HA_DATA = 9
+SCE_HA_IMPORT = 10
+SCE_HA_OPERATOR = 11
+SCE_HA_INSTANCE = 12
+SCE_HA_COMMENTLINE = 13
+SCE_HA_COMMENTBLOCK = 14
+SCE_HA_COMMENTBLOCK2 = 15
+SCE_HA_COMMENTBLOCK3 = 16
+SCE_T3_DEFAULT = 0
+SCE_T3_X_DEFAULT = 1
+SCE_T3_PREPROCESSOR = 2
+SCE_T3_BLOCK_COMMENT = 3
+SCE_T3_LINE_COMMENT = 4
+SCE_T3_OPERATOR = 5
+SCE_T3_KEYWORD = 6
+SCE_T3_NUMBER = 7
+SCE_T3_IDENTIFIER = 8
+SCE_T3_S_STRING = 9
+SCE_T3_D_STRING = 10
+SCE_T3_X_STRING = 11
+SCE_T3_LIB_DIRECTIVE = 12
+SCE_T3_MSG_PARAM = 13
+SCE_T3_HTML_TAG = 14
+SCE_T3_HTML_DEFAULT = 15
+SCE_T3_HTML_STRING = 16
+SCE_T3_USER1 = 17
+SCE_T3_USER2 = 18
+SCE_T3_USER3 = 19
+SCE_T3_BRACE = 20
+SCE_REBOL_DEFAULT = 0
+SCE_REBOL_COMMENTLINE = 1
+SCE_REBOL_COMMENTBLOCK = 2
+SCE_REBOL_PREFACE = 3
+SCE_REBOL_OPERATOR = 4
+SCE_REBOL_CHARACTER = 5
+SCE_REBOL_QUOTEDSTRING = 6
+SCE_REBOL_BRACEDSTRING = 7
+SCE_REBOL_NUMBER = 8
+SCE_REBOL_PAIR = 9
+SCE_REBOL_TUPLE = 10
+SCE_REBOL_BINARY = 11
+SCE_REBOL_MONEY = 12
+SCE_REBOL_ISSUE = 13
+SCE_REBOL_TAG = 14
+SCE_REBOL_FILE = 15
+SCE_REBOL_EMAIL = 16
+SCE_REBOL_URL = 17
+SCE_REBOL_DATE = 18
+SCE_REBOL_TIME = 19
+SCE_REBOL_IDENTIFIER = 20
+SCE_REBOL_WORD = 21
+SCE_REBOL_WORD2 = 22
+SCE_REBOL_WORD3 = 23
+SCE_REBOL_WORD4 = 24
+SCE_REBOL_WORD5 = 25
+SCE_REBOL_WORD6 = 26
+SCE_REBOL_WORD7 = 27
+SCE_REBOL_WORD8 = 28
+SCE_SQL_DEFAULT = 0
+SCE_SQL_COMMENT = 1
+SCE_SQL_COMMENTLINE = 2
+SCE_SQL_COMMENTDOC = 3
+SCE_SQL_NUMBER = 4
+SCE_SQL_WORD = 5
+SCE_SQL_STRING = 6
+SCE_SQL_CHARACTER = 7
+SCE_SQL_SQLPLUS = 8
+SCE_SQL_SQLPLUS_PROMPT = 9
+SCE_SQL_OPERATOR = 10
+SCE_SQL_IDENTIFIER = 11
+SCE_SQL_SQLPLUS_COMMENT = 13
+SCE_SQL_COMMENTLINEDOC = 15
+SCE_SQL_WORD2 = 16
+SCE_SQL_COMMENTDOCKEYWORD = 17
+SCE_SQL_COMMENTDOCKEYWORDERROR = 18
+SCE_SQL_USER1 = 19
+SCE_SQL_USER2 = 20
+SCE_SQL_USER3 = 21
+SCE_SQL_USER4 = 22
+SCE_SQL_QUOTEDIDENTIFIER = 23
+SCE_ST_DEFAULT = 0
+SCE_ST_STRING = 1
+SCE_ST_NUMBER = 2
+SCE_ST_COMMENT = 3
+SCE_ST_SYMBOL = 4
+SCE_ST_BINARY = 5
+SCE_ST_BOOL = 6
+SCE_ST_SELF = 7
+SCE_ST_SUPER = 8
+SCE_ST_NIL = 9
+SCE_ST_GLOBAL = 10
+SCE_ST_RETURN = 11
+SCE_ST_SPECIAL = 12
+SCE_ST_KWSEND = 13
+SCE_ST_ASSIGN = 14
+SCE_ST_CHARACTER = 15
+SCE_ST_SPEC_SEL = 16
+SCE_FS_DEFAULT = 0
+SCE_FS_COMMENT = 1
+SCE_FS_COMMENTLINE = 2
+SCE_FS_COMMENTDOC = 3
+SCE_FS_COMMENTLINEDOC = 4
+SCE_FS_COMMENTDOCKEYWORD = 5
+SCE_FS_COMMENTDOCKEYWORDERROR = 6
+SCE_FS_KEYWORD = 7
+SCE_FS_KEYWORD2 = 8
+SCE_FS_KEYWORD3 = 9
+SCE_FS_KEYWORD4 = 10
+SCE_FS_NUMBER = 11
+SCE_FS_STRING = 12
+SCE_FS_PREPROCESSOR = 13
+SCE_FS_OPERATOR = 14
+SCE_FS_IDENTIFIER = 15
+SCE_FS_DATE = 16
+SCE_FS_STRINGEOL = 17
+SCE_FS_CONSTANT = 18
+SCE_FS_ASM = 19
+SCE_FS_LABEL = 20
+SCE_FS_ERROR = 21
+SCE_FS_HEXNUMBER = 22
+SCE_FS_BINNUMBER = 23
+SCE_CSOUND_DEFAULT = 0
+SCE_CSOUND_COMMENT = 1
+SCE_CSOUND_NUMBER = 2
+SCE_CSOUND_OPERATOR = 3
+SCE_CSOUND_INSTR = 4
+SCE_CSOUND_IDENTIFIER = 5
+SCE_CSOUND_OPCODE = 6
+SCE_CSOUND_HEADERSTMT = 7
+SCE_CSOUND_USERKEYWORD = 8
+SCE_CSOUND_COMMENTBLOCK = 9
+SCE_CSOUND_PARAM = 10
+SCE_CSOUND_ARATE_VAR = 11
+SCE_CSOUND_KRATE_VAR = 12
+SCE_CSOUND_IRATE_VAR = 13
+SCE_CSOUND_GLOBAL_VAR = 14
+SCE_CSOUND_STRINGEOL = 15
+SCE_INNO_DEFAULT = 0
+SCE_INNO_COMMENT = 1
+SCE_INNO_KEYWORD = 2
+SCE_INNO_PARAMETER = 3
+SCE_INNO_SECTION = 4
+SCE_INNO_PREPROC = 5
+SCE_INNO_PREPROC_INLINE = 6
+SCE_INNO_COMMENT_PASCAL = 7
+SCE_INNO_KEYWORD_PASCAL = 8
+SCE_INNO_KEYWORD_USER = 9
+SCE_INNO_STRING_DOUBLE = 10
+SCE_INNO_STRING_SINGLE = 11
+SCE_INNO_IDENTIFIER = 12
+SCE_OPAL_SPACE = 0
+SCE_OPAL_COMMENT_BLOCK = 1
+SCE_OPAL_COMMENT_LINE = 2
+SCE_OPAL_INTEGER = 3
+SCE_OPAL_KEYWORD = 4
+SCE_OPAL_SORT = 5
+SCE_OPAL_STRING = 6
+SCE_OPAL_PAR = 7
+SCE_OPAL_BOOL_CONST = 8
+SCE_OPAL_DEFAULT = 32
+SCE_SPICE_DEFAULT = 0
+SCE_SPICE_IDENTIFIER = 1
+SCE_SPICE_KEYWORD = 2
+SCE_SPICE_KEYWORD2 = 3
+SCE_SPICE_KEYWORD3 = 4
+SCE_SPICE_NUMBER = 5
+SCE_SPICE_DELIMITER = 6
+SCE_SPICE_VALUE = 7
+SCE_SPICE_COMMENTLINE = 8
+SCE_CMAKE_DEFAULT = 0
+SCE_CMAKE_COMMENT = 1
+SCE_CMAKE_STRINGDQ = 2
+SCE_CMAKE_STRINGLQ = 3
+SCE_CMAKE_STRINGRQ = 4
+SCE_CMAKE_COMMANDS = 5
+SCE_CMAKE_PARAMETERS = 6
+SCE_CMAKE_VARIABLE = 7
+SCE_CMAKE_USERDEFINED = 8
+SCE_CMAKE_WHILEDEF = 9
+SCE_CMAKE_FOREACHDEF = 10
+SCE_CMAKE_IFDEFINEDEF = 11
+SCE_CMAKE_MACRODEF = 12
+SCE_CMAKE_STRINGVAR = 13
+SCE_CMAKE_NUMBER = 14
+SCE_GAP_DEFAULT = 0
+SCE_GAP_IDENTIFIER = 1
+SCE_GAP_KEYWORD = 2
+SCE_GAP_KEYWORD2 = 3
+SCE_GAP_KEYWORD3 = 4
+SCE_GAP_KEYWORD4 = 5
+SCE_GAP_STRING = 6
+SCE_GAP_CHAR = 7
+SCE_GAP_OPERATOR = 8
+SCE_GAP_COMMENT = 9
+SCE_GAP_NUMBER = 10
+SCE_GAP_STRINGEOL = 11
+SCE_PLM_DEFAULT = 0
+SCE_PLM_COMMENT = 1
+SCE_PLM_STRING = 2
+SCE_PLM_NUMBER = 3
+SCE_PLM_IDENTIFIER = 4
+SCE_PLM_OPERATOR = 5
+SCE_PLM_CONTROL = 6
+SCE_PLM_KEYWORD = 7
+SCE_4GL_DEFAULT = 0
+SCE_4GL_NUMBER = 1
+SCE_4GL_WORD = 2
+SCE_4GL_STRING = 3
+SCE_4GL_CHARACTER = 4
+SCE_4GL_PREPROCESSOR = 5
+SCE_4GL_OPERATOR = 6
+SCE_4GL_IDENTIFIER = 7
+SCE_4GL_BLOCK = 8
+SCE_4GL_END = 9
+SCE_4GL_COMMENT1 = 10
+SCE_4GL_COMMENT2 = 11
+SCE_4GL_COMMENT3 = 12
+SCE_4GL_COMMENT4 = 13
+SCE_4GL_COMMENT5 = 14
+SCE_4GL_COMMENT6 = 15
+SCE_4GL_DEFAULT_ = 16
+SCE_4GL_NUMBER_ = 17
+SCE_4GL_WORD_ = 18
+SCE_4GL_STRING_ = 19
+SCE_4GL_CHARACTER_ = 20
+SCE_4GL_PREPROCESSOR_ = 21
+SCE_4GL_OPERATOR_ = 22
+SCE_4GL_IDENTIFIER_ = 23
+SCE_4GL_BLOCK_ = 24
+SCE_4GL_END_ = 25
+SCE_4GL_COMMENT1_ = 26
+SCE_4GL_COMMENT2_ = 27
+SCE_4GL_COMMENT3_ = 28
+SCE_4GL_COMMENT4_ = 29
+SCE_4GL_COMMENT5_ = 30
+SCE_4GL_COMMENT6_ = 31
+SCE_ABAQUS_DEFAULT = 0
+SCE_ABAQUS_COMMENT = 1
+SCE_ABAQUS_COMMENTBLOCK = 2
+SCE_ABAQUS_NUMBER = 3
+SCE_ABAQUS_STRING = 4
+SCE_ABAQUS_OPERATOR = 5
+SCE_ABAQUS_WORD = 6
+SCE_ABAQUS_PROCESSOR = 7
+SCE_ABAQUS_COMMAND = 8
+SCE_ABAQUS_SLASHCOMMAND = 9
+SCE_ABAQUS_STARCOMMAND = 10
+SCE_ABAQUS_ARGUMENT = 11
+SCE_ABAQUS_FUNCTION = 12
+SCE_ASY_DEFAULT = 0
+SCE_ASY_COMMENT = 1
+SCE_ASY_COMMENTLINE = 2
+SCE_ASY_NUMBER = 3
+SCE_ASY_WORD = 4
+SCE_ASY_STRING = 5
+SCE_ASY_CHARACTER = 6
+SCE_ASY_OPERATOR = 7
+SCE_ASY_IDENTIFIER = 8
+SCE_ASY_STRINGEOL = 9
+SCE_ASY_COMMENTLINEDOC = 10
+SCE_ASY_WORD2 = 11
+SCE_R_DEFAULT = 0
+SCE_R_COMMENT = 1
+SCE_R_KWORD = 2
+SCE_R_BASEKWORD = 3
+SCE_R_OTHERKWORD = 4
+SCE_R_NUMBER = 5
+SCE_R_STRING = 6
+SCE_R_STRING2 = 7
+SCE_R_OPERATOR = 8
+SCE_R_IDENTIFIER = 9
+SCE_R_INFIX = 10
+SCE_R_INFIXEOL = 11
+SCE_MAGIK_DEFAULT = 0
+SCE_MAGIK_COMMENT = 1
+SCE_MAGIK_HYPER_COMMENT = 16
+SCE_MAGIK_STRING = 2
+SCE_MAGIK_CHARACTER = 3
+SCE_MAGIK_NUMBER = 4
+SCE_MAGIK_IDENTIFIER = 5
+SCE_MAGIK_OPERATOR = 6
+SCE_MAGIK_FLOW = 7
+SCE_MAGIK_CONTAINER = 8
+SCE_MAGIK_BRACKET_BLOCK = 9
+SCE_MAGIK_BRACE_BLOCK = 10
+SCE_MAGIK_SQBRACKET_BLOCK = 11
+SCE_MAGIK_UNKNOWN_KEYWORD = 12
+SCE_MAGIK_KEYWORD = 13
+SCE_MAGIK_PRAGMA = 14
+SCE_MAGIK_SYMBOL = 15
+SCE_POWERSHELL_DEFAULT = 0
+SCE_POWERSHELL_COMMENT = 1
+SCE_POWERSHELL_STRING = 2
+SCE_POWERSHELL_CHARACTER = 3
+SCE_POWERSHELL_NUMBER = 4
+SCE_POWERSHELL_VARIABLE = 5
+SCE_POWERSHELL_OPERATOR = 6
+SCE_POWERSHELL_IDENTIFIER = 7
+SCE_POWERSHELL_KEYWORD = 8
+SCE_POWERSHELL_CMDLET = 9
+SCE_POWERSHELL_ALIAS = 10
+SCE_MYSQL_DEFAULT = 0
+SCE_MYSQL_COMMENT = 1
+SCE_MYSQL_COMMENTLINE = 2
+SCE_MYSQL_VARIABLE = 3
+SCE_MYSQL_SYSTEMVARIABLE = 4
+SCE_MYSQL_KNOWNSYSTEMVARIABLE = 5
+SCE_MYSQL_NUMBER = 6
+SCE_MYSQL_MAJORKEYWORD = 7
+SCE_MYSQL_KEYWORD = 8
+SCE_MYSQL_DATABASEOBJECT = 9
+SCE_MYSQL_PROCEDUREKEYWORD = 10
+SCE_MYSQL_STRING = 11
+SCE_MYSQL_SQSTRING = 12
+SCE_MYSQL_DQSTRING = 13
+SCE_MYSQL_OPERATOR = 14
+SCE_MYSQL_FUNCTION = 15
+SCE_MYSQL_IDENTIFIER = 16
+SCE_MYSQL_QUOTEDIDENTIFIER = 17
+SCE_MYSQL_USER1 = 18
+SCE_MYSQL_USER2 = 19
+SCE_MYSQL_USER3 = 20
+SCE_PO_DEFAULT = 0
+SCE_PO_COMMENT = 1
+SCE_PO_MSGID = 2
+SCE_PO_MSGID_TEXT = 3
+SCE_PO_MSGSTR = 4
+SCE_PO_MSGSTR_TEXT = 5
+SCE_PO_MSGCTXT = 6
+SCE_PO_MSGCTXT_TEXT = 7
+SCE_PO_FUZZY = 8
+SCLEX_ASP = 29
+SCLEX_PHP = 30
diff --git a/lib/pythonwin/pywin/scintilla/view.py b/lib/pythonwin/pywin/scintilla/view.py
new file mode 100644
index 00000000..3783666f
--- /dev/null
+++ b/lib/pythonwin/pywin/scintilla/view.py
@@ -0,0 +1,832 @@
+# A general purpose MFC CCtrlView view that uses Scintilla.
+
+import array
+import os
+import re
+import string
+import struct
+import sys
+
+import __main__  # for attribute lookup
+import afxres
+import win32con
+import win32ui
+from pywin.mfc import dialog, docview
+
+from . import IDLEenvironment  # IDLE emulation.
+from . import bindings, control, keycodes, scintillacon
+
+PRINTDLGORD = 1538
+IDC_PRINT_MAG_EDIT = 1010
+EM_FORMATRANGE = win32con.WM_USER + 57
+
+wordbreaks = "._" + string.ascii_uppercase + string.ascii_lowercase + string.digits
+
+patImport = re.compile("import (?P<name>.*)")
+
+_event_commands = [
+    # File menu
+    "win32ui.ID_FILE_LOCATE",
+    "win32ui.ID_FILE_CHECK",
+    "afxres.ID_FILE_CLOSE",
+    "afxres.ID_FILE_NEW",
+    "afxres.ID_FILE_OPEN",
+    "afxres.ID_FILE_SAVE",
+    "afxres.ID_FILE_SAVE_AS",
+    "win32ui.ID_FILE_SAVE_ALL",
+    # Edit menu
+    "afxres.ID_EDIT_UNDO",
+    "afxres.ID_EDIT_REDO",
+    "afxres.ID_EDIT_CUT",
+    "afxres.ID_EDIT_COPY",
+    "afxres.ID_EDIT_PASTE",
+    "afxres.ID_EDIT_SELECT_ALL",
+    "afxres.ID_EDIT_FIND",
+    "afxres.ID_EDIT_REPEAT",
+    "afxres.ID_EDIT_REPLACE",
+    # View menu
+    "win32ui.ID_VIEW_WHITESPACE",
+    "win32ui.ID_VIEW_FIXED_FONT",
+    "win32ui.ID_VIEW_BROWSE",
+    "win32ui.ID_VIEW_INTERACTIVE",
+    # Window menu
+    "afxres.ID_WINDOW_ARRANGE",
+    "afxres.ID_WINDOW_CASCADE",
+    "afxres.ID_WINDOW_NEW",
+    "afxres.ID_WINDOW_SPLIT",
+    "afxres.ID_WINDOW_TILE_HORZ",
+    "afxres.ID_WINDOW_TILE_VERT",
+    # Others
+    "afxres.ID_APP_EXIT",
+    "afxres.ID_APP_ABOUT",
+]
+
+_extra_event_commands = [
+    ("EditDelete", afxres.ID_EDIT_CLEAR),
+    ("LocateModule", win32ui.ID_FILE_LOCATE),
+    ("GotoLine", win32ui.ID_EDIT_GOTO_LINE),
+    ("DbgBreakpointToggle", win32ui.IDC_DBG_ADD),
+    ("DbgGo", win32ui.IDC_DBG_GO),
+    ("DbgStepOver", win32ui.IDC_DBG_STEPOVER),
+    ("DbgStep", win32ui.IDC_DBG_STEP),
+    ("DbgStepOut", win32ui.IDC_DBG_STEPOUT),
+    ("DbgBreakpointClearAll", win32ui.IDC_DBG_CLEAR),
+    ("DbgClose", win32ui.IDC_DBG_CLOSE),
+]
+
+event_commands = []
+
+
+def _CreateEvents():
+    for name in _event_commands:
+        val = eval(name)
+        name_parts = name.split("_")[1:]
+        name_parts = [p.capitalize() for p in name_parts]
+        event = "".join(name_parts)
+        event_commands.append((event, val))
+    for name, id in _extra_event_commands:
+        event_commands.append((name, id))
+
+
+_CreateEvents()
+del _event_commands
+del _extra_event_commands
+
+command_reflectors = [
+    (win32ui.ID_EDIT_UNDO, win32con.WM_UNDO),
+    (win32ui.ID_EDIT_REDO, scintillacon.SCI_REDO),
+    (win32ui.ID_EDIT_CUT, win32con.WM_CUT),
+    (win32ui.ID_EDIT_COPY, win32con.WM_COPY),
+    (win32ui.ID_EDIT_PASTE, win32con.WM_PASTE),
+    (win32ui.ID_EDIT_CLEAR, win32con.WM_CLEAR),
+    (win32ui.ID_EDIT_SELECT_ALL, scintillacon.SCI_SELECTALL),
+]
+
+
+def DoBraceMatch(control):
+    curPos = control.SCIGetCurrentPos()
+    charBefore = " "
+    if curPos:
+        charBefore = control.SCIGetCharAt(curPos - 1)
+    charAt = control.SCIGetCharAt(curPos)
+    braceAtPos = braceOpposite = -1
+    if charBefore in "[](){}":
+        braceAtPos = curPos - 1
+    if braceAtPos == -1:
+        if charAt in "[](){}":
+            braceAtPos = curPos
+    if braceAtPos != -1:
+        braceOpposite = control.SCIBraceMatch(braceAtPos, 0)
+    if braceAtPos != -1 and braceOpposite == -1:
+        control.SCIBraceBadHighlight(braceAtPos)
+    else:
+        # either clear them both or set them both.
+        control.SCIBraceHighlight(braceAtPos, braceOpposite)
+
+
+def _get_class_attributes(ob):
+    # Recurse into base classes looking for attributes
+    items = []
+    try:
+        items = items + dir(ob)
+        for i in ob.__bases__:
+            for item in _get_class_attributes(i):
+                if item not in items:
+                    items.append(item)
+    except AttributeError:
+        pass
+    return items
+
+
+# Supposed to look like an MFC CEditView, but
+# also supports IDLE extensions and other source code generic features.
+class CScintillaView(docview.CtrlView, control.CScintillaColorEditInterface):
+    def __init__(self, doc):
+        docview.CtrlView.__init__(
+            self,
+            doc,
+            "Scintilla",
+            win32con.WS_CHILD
+            | win32con.WS_VSCROLL
+            | win32con.WS_HSCROLL
+            | win32con.WS_CLIPCHILDREN
+            | win32con.WS_VISIBLE,
+        )
+        self._tabWidth = (
+            8  # Mirror of what we send to Scintilla - never change this directly
+        )
+        self.bAutoCompleteAttributes = 1
+        self.bShowCallTips = 1
+        self.bMatchBraces = 0  # Editor option will default this to true later!
+        self.bindings = bindings.BindingsManager(self)
+
+        self.idle = IDLEenvironment.IDLEEditorWindow(self)
+        self.idle.IDLEExtension("AutoExpand")
+        # SendScintilla is called so frequently it is worth optimizing.
+        self.SendScintilla = self._obj_.SendMessage
+
+    def _MakeColorizer(self):
+        ext = os.path.splitext(self.GetDocument().GetPathName())[1]
+        from . import formatter
+
+        return formatter.BuiltinPythonSourceFormatter(self, ext)
+
+    # 	def SendScintilla(self, msg, w=0, l=0):
+    # 		return self._obj_.SendMessage(msg, w, l)
+
+    def SCISetTabWidth(self, width):
+        # I need to remember the tab-width for the AutoIndent extension.  This may go.
+        self._tabWidth = width
+        control.CScintillaEditInterface.SCISetTabWidth(self, width)
+
+    def GetTabWidth(self):
+        return self._tabWidth
+
+    def HookHandlers(self):
+        # Create events for all the menu names.
+        for name, val in event_commands:
+            # 			handler = lambda id, code, tosend=val, parent=parent: parent.OnCommand(tosend, 0) and 0
+            self.bindings.bind(name, None, cid=val)
+
+        # Hook commands that do nothing other than send Scintilla messages.
+        for command, reflection in command_reflectors:
+            handler = (
+                lambda id, code, ss=self.SendScintilla, tosend=reflection: ss(tosend)
+                and 0
+            )
+            self.HookCommand(handler, command)
+
+        self.HookCommand(self.OnCmdViewWS, win32ui.ID_VIEW_WHITESPACE)
+        self.HookCommandUpdate(self.OnUpdateViewWS, win32ui.ID_VIEW_WHITESPACE)
+        self.HookCommand(
+            self.OnCmdViewIndentationGuides, win32ui.ID_VIEW_INDENTATIONGUIDES
+        )
+        self.HookCommandUpdate(
+            self.OnUpdateViewIndentationGuides, win32ui.ID_VIEW_INDENTATIONGUIDES
+        )
+        self.HookCommand(self.OnCmdViewRightEdge, win32ui.ID_VIEW_RIGHT_EDGE)
+        self.HookCommandUpdate(self.OnUpdateViewRightEdge, win32ui.ID_VIEW_RIGHT_EDGE)
+        self.HookCommand(self.OnCmdViewEOL, win32ui.ID_VIEW_EOL)
+        self.HookCommandUpdate(self.OnUpdateViewEOL, win32ui.ID_VIEW_EOL)
+        self.HookCommand(self.OnCmdViewFixedFont, win32ui.ID_VIEW_FIXED_FONT)
+        self.HookCommandUpdate(self.OnUpdateViewFixedFont, win32ui.ID_VIEW_FIXED_FONT)
+        self.HookCommand(self.OnCmdFileLocate, win32ui.ID_FILE_LOCATE)
+        self.HookCommand(self.OnCmdEditFind, win32ui.ID_EDIT_FIND)
+        self.HookCommand(self.OnCmdEditRepeat, win32ui.ID_EDIT_REPEAT)
+        self.HookCommand(self.OnCmdEditReplace, win32ui.ID_EDIT_REPLACE)
+        self.HookCommand(self.OnCmdGotoLine, win32ui.ID_EDIT_GOTO_LINE)
+        self.HookCommand(self.OnFilePrint, afxres.ID_FILE_PRINT)
+        self.HookCommand(self.OnFilePrint, afxres.ID_FILE_PRINT_DIRECT)
+        self.HookCommand(self.OnFilePrintPreview, win32ui.ID_FILE_PRINT_PREVIEW)
+        # Key bindings.
+        self.HookMessage(self.OnKeyDown, win32con.WM_KEYDOWN)
+        self.HookMessage(self.OnKeyDown, win32con.WM_SYSKEYDOWN)
+        # Hook wheeley mouse events
+        # 		self.HookMessage(self.OnMouseWheel, win32con.WM_MOUSEWHEEL)
+        self.HookFormatter()
+
+    def OnInitialUpdate(self):
+        doc = self.GetDocument()
+
+        # Enable Unicode
+        self.SendScintilla(scintillacon.SCI_SETCODEPAGE, scintillacon.SC_CP_UTF8, 0)
+        self.SendScintilla(scintillacon.SCI_SETKEYSUNICODE, 1, 0)
+
+        # Create margins
+        self.SendScintilla(
+            scintillacon.SCI_SETMARGINTYPEN, 1, scintillacon.SC_MARGIN_SYMBOL
+        )
+        self.SendScintilla(scintillacon.SCI_SETMARGINMASKN, 1, 0xF)
+        self.SendScintilla(
+            scintillacon.SCI_SETMARGINTYPEN, 2, scintillacon.SC_MARGIN_SYMBOL
+        )
+        self.SendScintilla(
+            scintillacon.SCI_SETMARGINMASKN, 2, scintillacon.SC_MASK_FOLDERS
+        )
+        self.SendScintilla(scintillacon.SCI_SETMARGINSENSITIVEN, 2, 1)
+
+        self.GetDocument().HookViewNotifications(
+            self
+        )  # is there an MFC way to grab this?
+        self.HookHandlers()
+
+        # Load the configuration information.
+        self.OnWinIniChange(None)
+
+        self.SetSel()
+
+        self.GetDocument().FinalizeViewCreation(
+            self
+        )  # is there an MFC way to grab this?
+
+    def _GetSubConfigNames(self):
+        return None  # By default we use only sections without sub-sections.
+
+    def OnWinIniChange(self, section=None):
+        self.bindings.prepare_configure()
+        try:
+            self.DoConfigChange()
+        finally:
+            self.bindings.complete_configure()
+
+    def DoConfigChange(self):
+        # Bit of a hack I dont kow what to do about - these should be "editor options"
+        from pywin.framework.editor import GetEditorOption
+
+        self.bAutoCompleteAttributes = GetEditorOption("Autocomplete Attributes", 1)
+        self.bShowCallTips = GetEditorOption("Show Call Tips", 1)
+        # Update the key map and extension data.
+        configManager.configure(self, self._GetSubConfigNames())
+        if configManager.last_error:
+            win32ui.MessageBox(configManager.last_error, "Configuration Error")
+        self.bMatchBraces = GetEditorOption("Match Braces", 1)
+        self.ApplyFormattingStyles(1)
+
+    def OnDestroy(self, msg):
+        self.bindings.close()
+        self.bindings = None
+        self.idle.close()
+        self.idle = None
+        control.CScintillaColorEditInterface.close(self)
+        return docview.CtrlView.OnDestroy(self, msg)
+
+    def OnMouseWheel(self, msg):
+        zDelta = msg[2] >> 16
+        vpos = self.GetScrollPos(win32con.SB_VERT)
+        vpos = vpos - zDelta / 40  # 3 lines per notch
+        self.SetScrollPos(win32con.SB_VERT, vpos)
+        self.SendScintilla(
+            win32con.WM_VSCROLL, (vpos << 16) | win32con.SB_THUMBPOSITION, 0
+        )
+
+    def OnBraceMatch(self, std, extra):
+        if not self.bMatchBraces:
+            return
+        DoBraceMatch(self)
+
+    def OnNeedShown(self, std, extra):
+        notify = self.SCIUnpackNotifyMessage(extra)
+        # OnNeedShown is called before an edit operation when
+        # text is folded (as it is possible the text insertion will happen
+        # in a folded region.)  As this happens _before_ the insert,
+        # we ignore the length (if we are at EOF, pos + length may
+        # actually be beyond the end of buffer)
+        self.EnsureCharsVisible(notify.position)
+
+    def EnsureCharsVisible(self, start, end=None):
+        if end is None:
+            end = start
+        lineStart = self.LineFromChar(min(start, end))
+        lineEnd = self.LineFromChar(max(start, end))
+        while lineStart <= lineEnd:
+            self.SCIEnsureVisible(lineStart)
+            lineStart = lineStart + 1
+
+    # Helper to add an event to a menu.
+    def AppendMenu(self, menu, text="", event=None, flags=None, checked=0):
+        if event is None:
+            assert flags is not None, "No event or custom flags!"
+            cmdid = 0
+        else:
+            cmdid = self.bindings.get_command_id(event)
+            if cmdid is None:
+                # No event of that name - no point displaying it.
+                print(
+                    'View.AppendMenu(): Unknown event "%s" specified for menu text "%s" - ignored'
+                    % (event, text)
+                )
+                return
+            keyname = configManager.get_key_binding(event, self._GetSubConfigNames())
+            if keyname is not None:
+                text = text + "\t" + keyname
+        if flags is None:
+            flags = win32con.MF_STRING | win32con.MF_ENABLED
+        if checked:
+            flags = flags | win32con.MF_CHECKED
+        menu.AppendMenu(flags, cmdid, text)
+
+    def OnKeyDown(self, msg):
+        return self.bindings.fire_key_event(msg)
+
+    def GotoEndOfFileEvent(self, event):
+        self.SetSel(-1)
+
+    def KeyDotEvent(self, event):
+        ## Don't trigger autocomplete if any text is selected
+        s, e = self.GetSel()
+        if s != e:
+            return 1
+        self.SCIAddText(".")
+        if self.bAutoCompleteAttributes:
+            self._AutoComplete()
+
+    # View Whitespace/EOL/Indentation UI.
+
+    def OnCmdViewWS(self, cmd, code):  # Handle the menu command
+        viewWS = self.SCIGetViewWS()
+        self.SCISetViewWS(not viewWS)
+
+    def OnUpdateViewWS(self, cmdui):  # Update the tick on the UI.
+        cmdui.SetCheck(self.SCIGetViewWS())
+        cmdui.Enable()
+
+    def OnCmdViewIndentationGuides(self, cmd, code):  # Handle the menu command
+        viewIG = self.SCIGetIndentationGuides()
+        self.SCISetIndentationGuides(not viewIG)
+
+    def OnUpdateViewIndentationGuides(self, cmdui):  # Update the tick on the UI.
+        cmdui.SetCheck(self.SCIGetIndentationGuides())
+        cmdui.Enable()
+
+    def OnCmdViewRightEdge(self, cmd, code):  # Handle the menu command
+        if self.SCIGetEdgeMode() == scintillacon.EDGE_NONE:
+            mode = scintillacon.EDGE_BACKGROUND
+        else:
+            mode = scintillacon.EDGE_NONE
+        self.SCISetEdgeMode(mode)
+
+    def OnUpdateViewRightEdge(self, cmdui):  # Update the tick on the UI.
+        cmdui.SetCheck(self.SCIGetEdgeMode() != scintillacon.EDGE_NONE)
+        cmdui.Enable()
+
+    def OnCmdViewEOL(self, cmd, code):  # Handle the menu command
+        viewEOL = self.SCIGetViewEOL()
+        self.SCISetViewEOL(not viewEOL)
+
+    def OnUpdateViewEOL(self, cmdui):  # Update the tick on the UI.
+        cmdui.SetCheck(self.SCIGetViewEOL())
+        cmdui.Enable()
+
+    def OnCmdViewFixedFont(self, cmd, code):  # Handle the menu command
+        self._GetColorizer().bUseFixed = not self._GetColorizer().bUseFixed
+        self.ApplyFormattingStyles(0)
+        # Ensure the selection is visible!
+        self.ScrollCaret()
+
+    def OnUpdateViewFixedFont(self, cmdui):  # Update the tick on the UI.
+        c = self._GetColorizer()
+        if c is not None:
+            cmdui.SetCheck(c.bUseFixed)
+        cmdui.Enable(c is not None)
+
+    def OnCmdEditFind(self, cmd, code):
+        from . import find
+
+        find.ShowFindDialog()
+
+    def OnCmdEditRepeat(self, cmd, code):
+        from . import find
+
+        find.FindNext()
+
+    def OnCmdEditReplace(self, cmd, code):
+        from . import find
+
+        find.ShowReplaceDialog()
+
+    def OnCmdFileLocate(self, cmd, id):
+        line = self.GetLine().strip()
+        import pywin.framework.scriptutils
+
+        m = patImport.match(line)
+        if m:
+            # Module name on this line - locate that!
+            modName = m.group("name")
+            fileName = pywin.framework.scriptutils.LocatePythonFile(modName)
+            if fileName is None:
+                win32ui.SetStatusText("Can't locate module %s" % modName)
+                return 1  # Let the default get it.
+            else:
+                win32ui.GetApp().OpenDocumentFile(fileName)
+        else:
+            # Just to a "normal" locate - let the default handler get it.
+            return 1
+        return 0
+
+    def OnCmdGotoLine(self, cmd, id):
+        try:
+            lineNo = int(input("Enter Line Number")) - 1
+        except (ValueError, KeyboardInterrupt):
+            return 0
+        self.SCIEnsureVisible(lineNo)
+        self.SCIGotoLine(lineNo)
+        return 0
+
+    def SaveTextFile(self, filename, encoding=None):
+        doc = self.GetDocument()
+        doc._SaveTextToFile(self, filename, encoding=encoding)
+        doc.SetModifiedFlag(0)
+        return 1
+
+    def _AutoComplete(self):
+        def list2dict(l):
+            ret = {}
+            for i in l:
+                ret[i] = None
+            return ret
+
+        self.SCIAutoCCancel()  # Cancel old auto-complete lists.
+        # First try and get an object without evaluating calls
+        ob = self._GetObjectAtPos(bAllowCalls=0)
+        # If that failed, try and process call or indexing to get the object.
+        if ob is None:
+            ob = self._GetObjectAtPos(bAllowCalls=1)
+        items_dict = {}
+        if ob is not None:
+            try:  # Catch unexpected errors when fetching attribute names from the object
+                # extra attributes of win32ui objects
+                if hasattr(ob, "_obj_"):
+                    try:
+                        items_dict.update(list2dict(dir(ob._obj_)))
+                    except AttributeError:
+                        pass  # object has no __dict__
+
+                # normal attributes
+                try:
+                    items_dict.update(list2dict(dir(ob)))
+                except AttributeError:
+                    pass  # object has no __dict__
+                if hasattr(ob, "__class__"):
+                    items_dict.update(list2dict(_get_class_attributes(ob.__class__)))
+                # The object may be a COM object with typelib support - lets see if we can get its props.
+                # (contributed by Stefan Migowsky)
+                try:
+                    # Get the automation attributes
+                    items_dict.update(ob.__class__._prop_map_get_)
+                    # See if there is an write only property
+                    # could be optimized
+                    items_dict.update(ob.__class__._prop_map_put_)
+                    # append to the already evaluated list
+                except AttributeError:
+                    pass
+                # The object might be a pure COM dynamic dispatch with typelib support - lets see if we can get its props.
+                if hasattr(ob, "_oleobj_"):
+                    try:
+                        for iTI in range(0, ob._oleobj_.GetTypeInfoCount()):
+                            typeInfo = ob._oleobj_.GetTypeInfo(iTI)
+                            self._UpdateWithITypeInfo(items_dict, typeInfo)
+                    except:
+                        pass
+            except:
+                win32ui.SetStatusText(
+                    "Error attempting to get object attributes - %s"
+                    % (repr(sys.exc_info()[0]),)
+                )
+
+        # ensure all keys are strings.
+        items = [str(k) for k in items_dict.keys()]
+        # All names that start with "_" go!
+        items = [k for k in items if not k.startswith("_")]
+
+        if not items:
+            # Heuristics a-la AutoExpand
+            # The idea is to find other usages of the current binding
+            # and assume, that it refers to the same object (or at least,
+            # to an object of the same type)
+            # Contributed by Vadim Chugunov [vadimch@yahoo.com]
+            left, right = self._GetWordSplit()
+            if left == "":  # Ignore standalone dots
+                return None
+            # We limit our search to the current class, if that
+            # information is available
+            minline, maxline, curclass = self._GetClassInfoFromBrowser()
+            endpos = self.LineIndex(maxline)
+            text = self.GetTextRange(self.LineIndex(minline), endpos)
+            try:
+                l = re.findall(r"\b" + left + "\.\w+", text)
+            except re.error:
+                # parens etc may make an invalid RE, but this code wouldnt
+                # benefit even if the RE did work :-)
+                l = []
+            prefix = len(left) + 1
+            unique = {}
+            for li in l:
+                unique[li[prefix:]] = 1
+            # Assuming traditional usage of self...
+            if curclass and left == "self":
+                self._UpdateWithClassMethods(unique, curclass)
+
+            items = [
+                word for word in unique.keys() if word[:2] != "__" or word[-2:] != "__"
+            ]
+            # Ignore the word currently to the right of the dot - probably a red-herring.
+            try:
+                items.remove(right[1:])
+            except ValueError:
+                pass
+        if items:
+            items.sort()
+            self.SCIAutoCSetAutoHide(0)
+            self.SCIAutoCShow(items)
+
+    def _UpdateWithITypeInfo(self, items_dict, typeInfo):
+        import pythoncom
+
+        typeInfos = [typeInfo]
+        # suppress IDispatch and IUnknown methods
+        inspectedIIDs = {pythoncom.IID_IDispatch: None}
+
+        while len(typeInfos) > 0:
+            typeInfo = typeInfos.pop()
+            typeAttr = typeInfo.GetTypeAttr()
+
+            if typeAttr.iid not in inspectedIIDs:
+                inspectedIIDs[typeAttr.iid] = None
+                for iFun in range(0, typeAttr.cFuncs):
+                    funDesc = typeInfo.GetFuncDesc(iFun)
+                    funName = typeInfo.GetNames(funDesc.memid)[0]
+                    if funName not in items_dict:
+                        items_dict[funName] = None
+
+                # Inspect the type info of all implemented types
+                # E.g. IShellDispatch5 implements IShellDispatch4 which implements IShellDispatch3 ...
+                for iImplType in range(0, typeAttr.cImplTypes):
+                    iRefType = typeInfo.GetRefTypeOfImplType(iImplType)
+                    refTypeInfo = typeInfo.GetRefTypeInfo(iRefType)
+                    typeInfos.append(refTypeInfo)
+
+    # TODO: This is kinda slow. Probably need some kind of cache
+    # here that is flushed upon file save
+    # Or maybe we don't need the superclass methods at all ?
+    def _UpdateWithClassMethods(self, dict, classinfo):
+        if not hasattr(classinfo, "methods"):
+            # No 'methods' - probably not what we think it is.
+            return
+        dict.update(classinfo.methods)
+        for super in classinfo.super:
+            if hasattr(super, "methods"):
+                self._UpdateWithClassMethods(dict, super)
+
+    # Find which class definition caret is currently in and return
+    # indexes of the the first and the last lines of that class definition
+    # Data is obtained from module browser (if enabled)
+    def _GetClassInfoFromBrowser(self, pos=-1):
+        minline = 0
+        maxline = self.GetLineCount() - 1
+        doc = self.GetParentFrame().GetActiveDocument()
+        browser = None
+        try:
+            if doc is not None:
+                browser = doc.GetAllViews()[1]
+        except IndexError:
+            pass
+        if browser is None:
+            return (minline, maxline, None)  # Current window has no browser
+        if not browser.list:
+            return (minline, maxline, None)  # Not initialized
+        path = self.GetDocument().GetPathName()
+        if not path:
+            return (minline, maxline, None)  # No current path
+
+        import pywin.framework.scriptutils
+
+        curmodule, path = pywin.framework.scriptutils.GetPackageModuleName(path)
+        try:
+            clbrdata = browser.list.root.clbrdata
+        except AttributeError:
+            return (minline, maxline, None)  # No class data for this module.
+        curline = self.LineFromChar(pos)
+        curclass = None
+        # Find out which class we are in
+        for item in clbrdata.values():
+            if item.module == curmodule:
+                item_lineno = (
+                    item.lineno - 1
+                )  # Scintilla counts lines from 0, whereas pyclbr - from 1
+                if minline < item_lineno <= curline:
+                    minline = item_lineno
+                    curclass = item
+                if curline < item_lineno < maxline:
+                    maxline = item_lineno
+        return (minline, maxline, curclass)
+
+    def _GetObjectAtPos(self, pos=-1, bAllowCalls=0):
+        left, right = self._GetWordSplit(pos, bAllowCalls)
+        if left:  # It is an attribute lookup
+            # How is this for a hack!
+            namespace = sys.modules.copy()
+            namespace.update(__main__.__dict__)
+            # Get the debugger's context.
+            try:
+                from pywin.framework import interact
+
+                if interact.edit is not None and interact.edit.currentView is not None:
+                    globs, locs = interact.edit.currentView.GetContext()[:2]
+                    if globs:
+                        namespace.update(globs)
+                    if locs:
+                        namespace.update(locs)
+            except ImportError:
+                pass
+            try:
+                return eval(left, namespace)
+            except:
+                pass
+        return None
+
+    def _GetWordSplit(self, pos=-1, bAllowCalls=0):
+        if pos == -1:
+            pos = self.GetSel()[0] - 1  # Character before current one
+        limit = self.GetTextLength()
+        before = []
+        after = []
+        index = pos - 1
+        wordbreaks_use = wordbreaks
+        if bAllowCalls:
+            wordbreaks_use = wordbreaks_use + "()[]"
+        while index >= 0:
+            char = self.SCIGetCharAt(index)
+            if char not in wordbreaks_use:
+                break
+            before.insert(0, char)
+            index = index - 1
+        index = pos
+        while index <= limit:
+            char = self.SCIGetCharAt(index)
+            if char not in wordbreaks_use:
+                break
+            after.append(char)
+            index = index + 1
+        return "".join(before), "".join(after)
+
+    def OnPrepareDC(self, dc, pInfo):
+        # 		print "OnPrepareDC for page", pInfo.GetCurPage(), "of", pInfo.GetFromPage(), "to", pInfo.GetToPage(), ", starts=", self.starts
+        if dc.IsPrinting():
+            # Check if we are beyond the end.
+            # (only do this when actually printing, else messes up print preview!)
+            if not pInfo.GetPreview() and self.starts is not None:
+                prevPage = pInfo.GetCurPage() - 1
+                if prevPage > 0 and self.starts[prevPage] >= self.GetTextLength():
+                    # All finished.
+                    pInfo.SetContinuePrinting(0)
+                    return
+            dc.SetMapMode(win32con.MM_TEXT)
+
+    def OnPreparePrinting(self, pInfo):
+        flags = (
+            win32ui.PD_USEDEVMODECOPIES | win32ui.PD_ALLPAGES | win32ui.PD_NOSELECTION
+        )  # Dont support printing just a selection.
+        # NOTE: Custom print dialogs are stopping the user's values from coming back :-(
+        # 		self.prtDlg = PrintDialog(pInfo, PRINTDLGORD, flags)
+        # 		pInfo.SetPrintDialog(self.prtDlg)
+        pInfo.SetMinPage(1)
+        # max page remains undefined for now.
+        pInfo.SetFromPage(1)
+        pInfo.SetToPage(1)
+        ret = self.DoPreparePrinting(pInfo)
+        return ret
+
+    def OnBeginPrinting(self, dc, pInfo):
+        self.starts = None
+        return self._obj_.OnBeginPrinting(dc, pInfo)
+
+    def CalculatePageRanges(self, dc, pInfo):
+        # Calculate page ranges and max page
+        self.starts = {0: 0}
+        metrics = dc.GetTextMetrics()
+        left, top, right, bottom = pInfo.GetDraw()
+        # Leave space at the top for the header.
+        rc = (left, top + int((9 * metrics["tmHeight"]) / 2), right, bottom)
+        pageStart = 0
+        maxPage = 0
+        textLen = self.GetTextLength()
+        while pageStart < textLen:
+            pageStart = self.FormatRange(dc, pageStart, textLen, rc, 0)
+            maxPage = maxPage + 1
+            self.starts[maxPage] = pageStart
+        # And a sentinal for one page past the end
+        self.starts[maxPage + 1] = textLen
+        # When actually printing, maxPage doesnt have any effect at this late state.
+        # but is needed to make the Print Preview work correctly.
+        pInfo.SetMaxPage(maxPage)
+
+    def OnFilePrintPreview(self, *arg):
+        self._obj_.OnFilePrintPreview()
+
+    def OnFilePrint(self, *arg):
+        self._obj_.OnFilePrint()
+
+    def FormatRange(self, dc, pageStart, lengthDoc, rc, draw):
+        """
+        typedef struct _formatrange {
+                HDC hdc;
+                HDC hdcTarget;
+                RECT rc;
+                RECT rcPage;
+                CHARRANGE chrg;} FORMATRANGE;
+        """
+        fmt = "PPIIIIIIIIll"
+        hdcRender = dc.GetHandleOutput()
+        hdcFormat = dc.GetHandleAttrib()
+        fr = struct.pack(
+            fmt,
+            hdcRender,
+            hdcFormat,
+            rc[0],
+            rc[1],
+            rc[2],
+            rc[3],
+            rc[0],
+            rc[1],
+            rc[2],
+            rc[3],
+            pageStart,
+            lengthDoc,
+        )
+        nextPageStart = self.SendScintilla(EM_FORMATRANGE, draw, fr)
+        return nextPageStart
+
+    def OnPrint(self, dc, pInfo):
+        metrics = dc.GetTextMetrics()
+        # 		print "dev", w, h, l, metrics['tmAscent'], metrics['tmDescent']
+        if self.starts is None:
+            self.CalculatePageRanges(dc, pInfo)
+        pageNum = pInfo.GetCurPage() - 1
+        # Setup the header of the page - docname on left, pagenum on right.
+        doc = self.GetDocument()
+        cxChar = metrics["tmAveCharWidth"]
+        cyChar = metrics["tmHeight"]
+        left, top, right, bottom = pInfo.GetDraw()
+        dc.TextOut(0, 2 * cyChar, doc.GetTitle())
+        pagenum_str = win32ui.LoadString(afxres.AFX_IDS_PRINTPAGENUM) % (pageNum + 1,)
+        dc.SetTextAlign(win32con.TA_RIGHT)
+        dc.TextOut(right, 2 * cyChar, pagenum_str)
+        dc.SetTextAlign(win32con.TA_LEFT)
+        top = top + int((7 * cyChar) / 2)
+        dc.MoveTo(left, top)
+        dc.LineTo(right, top)
+        top = top + cyChar
+        rc = (left, top, right, bottom)
+        nextPageStart = self.FormatRange(
+            dc, self.starts[pageNum], self.starts[pageNum + 1], rc, 1
+        )
+
+
+def LoadConfiguration():
+    global configManager
+    # Bit of a hack I dont kow what to do about?
+    from .config import ConfigManager
+
+    configName = rc = win32ui.GetProfileVal("Editor", "Keyboard Config", "default")
+    configManager = ConfigManager(configName)
+    if configManager.last_error:
+        bTryDefault = 0
+        msg = "Error loading configuration '%s'\n\n%s" % (
+            configName,
+            configManager.last_error,
+        )
+        if configName != "default":
+            msg = msg + "\n\nThe default configuration will be loaded."
+            bTryDefault = 1
+        win32ui.MessageBox(msg)
+        if bTryDefault:
+            configManager = ConfigManager("default")
+            if configManager.last_error:
+                win32ui.MessageBox(
+                    "Error loading configuration 'default'\n\n%s"
+                    % (configManager.last_error)
+                )
+
+
+configManager = None
+LoadConfiguration()
diff --git a/lib/pythonwin/pywin/tools/TraceCollector.py b/lib/pythonwin/pywin/tools/TraceCollector.py
new file mode 100644
index 00000000..5800488b
--- /dev/null
+++ b/lib/pythonwin/pywin/tools/TraceCollector.py
@@ -0,0 +1,79 @@
+# win32traceutil like utility for Pythonwin
+import _thread
+
+import win32api
+import win32event
+import win32trace
+from pywin.framework import winout
+
+outputWindow = None
+
+
+def CollectorThread(stopEvent, file):
+    win32trace.InitRead()
+    handle = win32trace.GetHandle()
+    # Run this thread at a lower priority to the main message-loop (and printing output)
+    # thread can keep up
+    import win32process
+
+    win32process.SetThreadPriority(
+        win32api.GetCurrentThread(), win32process.THREAD_PRIORITY_BELOW_NORMAL
+    )
+
+    try:
+        while 1:
+            rc = win32event.WaitForMultipleObjects(
+                (handle, stopEvent), 0, win32event.INFINITE
+            )
+            if rc == win32event.WAIT_OBJECT_0:
+                # About the only char we can't live with is \0!
+                file.write(win32trace.read().replace("\0", "<null>"))
+            else:
+                # Stop event
+                break
+    finally:
+        win32trace.TermRead()
+        print("Thread dieing")
+
+
+class WindowOutput(winout.WindowOutput):
+    def __init__(self, *args):
+        winout.WindowOutput.__init__(*(self,) + args)
+        self.hStopThread = win32event.CreateEvent(None, 0, 0, None)
+        _thread.start_new(CollectorThread, (self.hStopThread, self))
+
+    def _StopThread(self):
+        win32event.SetEvent(self.hStopThread)
+        self.hStopThread = None
+
+    def Close(self):
+        self._StopThread()
+        winout.WindowOutput.Close(self)
+        # 	def OnViewDestroy(self, frame):
+        # 		return winout.WindowOutput.OnViewDestroy(self, frame)
+        # 	def Create(self, title=None, style = None):
+        # 		rc = winout.WindowOutput.Create(self, title, style)
+        return rc
+
+
+def MakeOutputWindow():
+    # Note that it will not show until the first string written or
+    # you pass bShow = 1
+    global outputWindow
+    if outputWindow is None:
+        title = "Python Trace Collector"
+        # queueingFlag doesnt matter, as all output will come from new thread
+        outputWindow = WindowOutput(title, title)
+        # Let people know what this does!
+        msg = """\
+# This window will display output from any programs that import win32traceutil
+# win32com servers registered with '--debug' are in this category.
+"""
+        outputWindow.write(msg)
+    # force existing window open
+    outputWindow.write("")
+    return outputWindow
+
+
+if __name__ == "__main__":
+    MakeOutputWindow()
diff --git a/lib/pythonwin/pywin/tools/__init__.py b/lib/pythonwin/pywin/tools/__init__.py
new file mode 100644
index 00000000..8b137891
--- /dev/null
+++ b/lib/pythonwin/pywin/tools/__init__.py
@@ -0,0 +1 @@
+
diff --git a/lib/pythonwin/pywin/tools/browseProjects.py b/lib/pythonwin/pywin/tools/browseProjects.py
new file mode 100644
index 00000000..e3255579
--- /dev/null
+++ b/lib/pythonwin/pywin/tools/browseProjects.py
@@ -0,0 +1,324 @@
+import glob
+import os
+import pyclbr
+
+import afxres
+import commctrl
+import pywin.framework.scriptutils
+import regutil
+import win32api
+import win32con
+import win32ui
+from pywin.mfc import dialog
+
+from . import hierlist
+
+
+class HLIErrorItem(hierlist.HierListItem):
+    def __init__(self, text):
+        self.text = text
+        hierlist.HierListItem.__init__(self)
+
+    def GetText(self):
+        return self.text
+
+
+class HLICLBRItem(hierlist.HierListItem):
+    def __init__(self, name, file, lineno, suffix=""):
+        # If the 'name' object itself has a .name, use it.  Not sure
+        # how this happens, but seems pyclbr related.
+        # See PyWin32 bug 817035
+        self.name = getattr(name, "name", name)
+        self.file = file
+        self.lineno = lineno
+        self.suffix = suffix
+
+    def __lt__(self, other):
+        return self.name < other.name
+
+    def __eq__(self, other):
+        return self.name == other.name
+
+    def GetText(self):
+        return self.name + self.suffix
+
+    def TakeDefaultAction(self):
+        if self.file:
+            pywin.framework.scriptutils.JumpToDocument(
+                self.file, self.lineno, bScrollToTop=1
+            )
+        else:
+            win32ui.SetStatusText("The source of this object is unknown")
+
+    def PerformItemSelected(self):
+        if self.file is None:
+            msg = "%s - source can not be located." % (self.name,)
+        else:
+            msg = "%s defined at line %d of %s" % (self.name, self.lineno, self.file)
+        win32ui.SetStatusText(msg)
+
+
+class HLICLBRClass(HLICLBRItem):
+    def __init__(self, clbrclass, suffix=""):
+        try:
+            name = clbrclass.name
+            file = clbrclass.file
+            lineno = clbrclass.lineno
+            self.super = clbrclass.super
+            self.methods = clbrclass.methods
+        except AttributeError:
+            name = clbrclass
+            file = lineno = None
+            self.super = []
+            self.methods = {}
+        HLICLBRItem.__init__(self, name, file, lineno, suffix)
+
+    def GetSubList(self):
+        ret = []
+        for c in self.super:
+            ret.append(HLICLBRClass(c, " (Parent class)"))
+        for meth, lineno in self.methods.items():
+            ret.append(HLICLBRMethod(meth, self.file, lineno, " (method)"))
+        return ret
+
+    def IsExpandable(self):
+        return len(self.methods) + len(self.super)
+
+    def GetBitmapColumn(self):
+        return 21
+
+
+class HLICLBRFunction(HLICLBRClass):
+    def GetBitmapColumn(self):
+        return 22
+
+
+class HLICLBRMethod(HLICLBRItem):
+    def GetBitmapColumn(self):
+        return 22
+
+
+class HLIModuleItem(hierlist.HierListItem):
+    def __init__(self, path):
+        hierlist.HierListItem.__init__(self)
+        self.path = path
+
+    def GetText(self):
+        return os.path.split(self.path)[1] + " (module)"
+
+    def IsExpandable(self):
+        return 1
+
+    def TakeDefaultAction(self):
+        win32ui.GetApp().OpenDocumentFile(self.path)
+
+    def GetBitmapColumn(self):
+        col = 4  # Default
+        try:
+            if win32api.GetFileAttributes(self.path) & win32con.FILE_ATTRIBUTE_READONLY:
+                col = 5
+        except win32api.error:
+            pass
+        return col
+
+    def GetSubList(self):
+        mod, path = pywin.framework.scriptutils.GetPackageModuleName(self.path)
+        win32ui.SetStatusText("Building class list - please wait...", 1)
+        win32ui.DoWaitCursor(1)
+        try:
+            try:
+                reader = pyclbr.readmodule_ex  # Post 1.5.2 interface.
+                extra_msg = " or functions"
+            except AttributeError:
+                reader = pyclbr.readmodule
+                extra_msg = ""
+            data = reader(mod, [path])
+            if data:
+                ret = []
+                for item in data.values():
+                    if (
+                        item.__class__ != pyclbr.Class
+                    ):  # ie, it is a pyclbr Function instance (only introduced post 1.5.2)
+                        ret.append(HLICLBRFunction(item, " (function)"))
+                    else:
+                        ret.append(HLICLBRClass(item, " (class)"))
+                ret.sort()
+                return ret
+            else:
+                return [HLIErrorItem("No Python classes%s in module." % (extra_msg,))]
+        finally:
+            win32ui.DoWaitCursor(0)
+            win32ui.SetStatusText(win32ui.LoadString(afxres.AFX_IDS_IDLEMESSAGE))
+
+
+def MakePathSubList(path):
+    ret = []
+    for filename in glob.glob(os.path.join(path, "*")):
+        if os.path.isdir(filename) and os.path.isfile(
+            os.path.join(filename, "__init__.py")
+        ):
+            ret.append(HLIDirectoryItem(filename, os.path.split(filename)[1]))
+        else:
+            if os.path.splitext(filename)[1].lower() in [".py", ".pyw"]:
+                ret.append(HLIModuleItem(filename))
+    return ret
+
+
+class HLIDirectoryItem(hierlist.HierListItem):
+    def __init__(self, path, displayName=None, bSubDirs=0):
+        hierlist.HierListItem.__init__(self)
+        self.path = path
+        self.bSubDirs = bSubDirs
+        if displayName:
+            self.displayName = displayName
+        else:
+            self.displayName = path
+
+    def IsExpandable(self):
+        return 1
+
+    def GetText(self):
+        return self.displayName
+
+    def GetSubList(self):
+        ret = MakePathSubList(self.path)
+        if (
+            os.path.split(self.path)[1] == "win32com"
+        ):  # Complete and utter hack for win32com.
+            try:
+                path = win32api.GetFullPathName(
+                    os.path.join(self.path, "..\\win32comext")
+                )
+                ret = ret + MakePathSubList(path)
+            except win32ui.error:
+                pass
+        return ret
+
+
+class HLIProjectRoot(hierlist.HierListItem):
+    def __init__(self, projectName, displayName=None):
+        hierlist.HierListItem.__init__(self)
+        self.projectName = projectName
+        self.displayName = displayName or projectName
+
+    def GetText(self):
+        return self.displayName
+
+    def IsExpandable(self):
+        return 1
+
+    def GetSubList(self):
+        paths = regutil.GetRegisteredNamedPath(self.projectName)
+        pathList = paths.split(";")
+        if len(pathList) == 1:  # Single dir - dont bother putting the dir in
+            ret = MakePathSubList(pathList[0])
+        else:
+            ret = list(map(HLIDirectoryItem, pathList))
+        return ret
+
+
+class HLIRoot(hierlist.HierListItem):
+    def __init__(self):
+        hierlist.HierListItem.__init__(self)
+
+    def IsExpandable(self):
+        return 1
+
+    def GetSubList(self):
+        keyStr = regutil.BuildDefaultPythonKey() + "\\PythonPath"
+        hKey = win32api.RegOpenKey(regutil.GetRootKey(), keyStr)
+        try:
+            ret = []
+            ret.append(HLIProjectRoot("", "Standard Python Library"))  # The core path.
+            index = 0
+            while 1:
+                try:
+                    ret.append(HLIProjectRoot(win32api.RegEnumKey(hKey, index)))
+                    index = index + 1
+                except win32api.error:
+                    break
+            return ret
+        finally:
+            win32api.RegCloseKey(hKey)
+
+
+class dynamic_browser(dialog.Dialog):
+    style = win32con.WS_OVERLAPPEDWINDOW | win32con.WS_VISIBLE
+    cs = (
+        win32con.WS_CHILD
+        | win32con.WS_VISIBLE
+        | commctrl.TVS_HASLINES
+        | commctrl.TVS_LINESATROOT
+        | commctrl.TVS_HASBUTTONS
+    )
+
+    dt = [
+        ["Python Projects", (0, 0, 200, 200), style, None, (8, "MS Sans Serif")],
+        ["SysTreeView32", None, win32ui.IDC_LIST1, (0, 0, 200, 200), cs],
+    ]
+
+    def __init__(self, hli_root):
+        dialog.Dialog.__init__(self, self.dt)
+        self.hier_list = hierlist.HierListWithItems(hli_root, win32ui.IDB_BROWSER_HIER)
+        self.HookMessage(self.on_size, win32con.WM_SIZE)
+
+    def OnInitDialog(self):
+        self.hier_list.HierInit(self)
+        return dialog.Dialog.OnInitDialog(self)
+
+    def on_size(self, params):
+        lparam = params[3]
+        w = win32api.LOWORD(lparam)
+        h = win32api.HIWORD(lparam)
+        self.GetDlgItem(win32ui.IDC_LIST1).MoveWindow((0, 0, w, h))
+
+
+def BrowseDialog():
+    root = HLIRoot()
+    if not root.IsExpandable():
+        raise TypeError(
+            "Browse() argument must have __dict__ attribute, or be a Browser supported type"
+        )
+
+    dlg = dynamic_browser(root)
+    dlg.CreateWindow()
+
+
+def DockableBrowserCreator(parent):
+    root = HLIRoot()
+    hl = hierlist.HierListWithItems(root, win32ui.IDB_BROWSER_HIER)
+
+    style = (
+        win32con.WS_CHILD
+        | win32con.WS_VISIBLE
+        | win32con.WS_BORDER
+        | commctrl.TVS_HASLINES
+        | commctrl.TVS_LINESATROOT
+        | commctrl.TVS_HASBUTTONS
+    )
+
+    control = win32ui.CreateTreeCtrl()
+    control.CreateWindow(style, (0, 0, 150, 300), parent, win32ui.IDC_LIST1)
+    list = hl.HierInit(parent, control)
+    return control
+
+
+def DockablePathBrowser():
+    import pywin.docking.DockingBar
+
+    bar = pywin.docking.DockingBar.DockingBar()
+    bar.CreateWindow(
+        win32ui.GetMainFrame(), DockableBrowserCreator, "Path Browser", 0x8E0A
+    )
+    bar.SetBarStyle(
+        bar.GetBarStyle()
+        | afxres.CBRS_TOOLTIPS
+        | afxres.CBRS_FLYBY
+        | afxres.CBRS_SIZE_DYNAMIC
+    )
+    bar.EnableDocking(afxres.CBRS_ALIGN_ANY)
+    win32ui.GetMainFrame().DockControlBar(bar)
+
+
+# The "default" entry point
+Browse = DockablePathBrowser
diff --git a/lib/pythonwin/pywin/tools/browser.py b/lib/pythonwin/pywin/tools/browser.py
new file mode 100644
index 00000000..9d9a193d
--- /dev/null
+++ b/lib/pythonwin/pywin/tools/browser.py
@@ -0,0 +1,517 @@
+# basic module browser.
+
+# usage:
+# >>> import browser
+# >>> browser.Browse()
+# or
+# >>> browser.Browse(your_module)
+import sys
+import types
+
+import __main__
+import win32ui
+from pywin.mfc import dialog
+
+from . import hierlist
+
+special_names = ["__doc__", "__name__", "__self__"]
+
+
+#
+# HierList items
+class HLIPythonObject(hierlist.HierListItem):
+    def __init__(self, myobject=None, name=None):
+        hierlist.HierListItem.__init__(self)
+        self.myobject = myobject
+        self.knownExpandable = None
+        if name:
+            self.name = name
+        else:
+            try:
+                self.name = myobject.__name__
+            except (AttributeError, TypeError):
+                try:
+                    r = repr(myobject)
+                    if len(r) > 20:
+                        r = r[:20] + "..."
+                    self.name = r
+                except (AttributeError, TypeError):
+                    self.name = "???"
+
+    def __lt__(self, other):
+        return self.name < other.name
+
+    def __eq__(self, other):
+        return self.name == other.name
+
+    def __repr__(self):
+        try:
+            type = self.GetHLIType()
+        except:
+            type = "Generic"
+        return (
+            "HLIPythonObject("
+            + type
+            + ") - name: "
+            + self.name
+            + " object: "
+            + repr(self.myobject)
+        )
+
+    def GetText(self):
+        try:
+            return str(self.name) + " (" + self.GetHLIType() + ")"
+        except AttributeError:
+            return str(self.name) + " = " + repr(self.myobject)
+
+    def InsertDocString(self, lst):
+        ob = None
+        try:
+            ob = self.myobject.__doc__
+        except (AttributeError, TypeError):
+            pass
+        # I don't quite grok descriptors enough to know how to
+        # best hook them up. Eg:
+        # >>> object.__getattribute__.__class__.__doc__
+        # <attribute '__doc__' of 'wrapper_descriptor' objects>
+        if ob and isinstance(ob, str):
+            lst.insert(0, HLIDocString(ob, "Doc"))
+
+    def GetSubList(self):
+        ret = []
+        try:
+            for key, ob in self.myobject.__dict__.items():
+                if key not in special_names:
+                    ret.append(MakeHLI(ob, key))
+        except (AttributeError, TypeError):
+            pass
+        try:
+            for name in self.myobject.__methods__:
+                ret.append(HLIMethod(name))  # no MakeHLI, as cant auto detect
+        except (AttributeError, TypeError):
+            pass
+        try:
+            for member in self.myobject.__members__:
+                if not member in special_names:
+                    ret.append(MakeHLI(getattr(self.myobject, member), member))
+        except (AttributeError, TypeError):
+            pass
+        ret.sort()
+        self.InsertDocString(ret)
+        return ret
+
+    # if the has a dict, it is expandable.
+    def IsExpandable(self):
+        if self.knownExpandable is None:
+            self.knownExpandable = self.CalculateIsExpandable()
+        return self.knownExpandable
+
+    def CalculateIsExpandable(self):
+        if hasattr(self.myobject, "__doc__"):
+            return 1
+        try:
+            for key in self.myobject.__dict__.keys():
+                if key not in special_names:
+                    return 1
+        except (AttributeError, TypeError):
+            pass
+        try:
+            self.myobject.__methods__
+            return 1
+        except (AttributeError, TypeError):
+            pass
+        try:
+            for item in self.myobject.__members__:
+                if item not in special_names:
+                    return 1
+        except (AttributeError, TypeError):
+            pass
+        return 0
+
+    def GetBitmapColumn(self):
+        if self.IsExpandable():
+            return 0
+        else:
+            return 4
+
+    def TakeDefaultAction(self):
+        ShowObject(self.myobject, self.name)
+
+
+class HLIDocString(HLIPythonObject):
+    def GetHLIType(self):
+        return "DocString"
+
+    def GetText(self):
+        return self.myobject.strip()
+
+    def IsExpandable(self):
+        return 0
+
+    def GetBitmapColumn(self):
+        return 6
+
+
+class HLIModule(HLIPythonObject):
+    def GetHLIType(self):
+        return "Module"
+
+
+class HLIFrame(HLIPythonObject):
+    def GetHLIType(self):
+        return "Stack Frame"
+
+
+class HLITraceback(HLIPythonObject):
+    def GetHLIType(self):
+        return "Traceback"
+
+
+class HLIClass(HLIPythonObject):
+    def GetHLIType(self):
+        return "Class"
+
+    def GetSubList(self):
+        ret = []
+        for base in self.myobject.__bases__:
+            ret.append(MakeHLI(base, "Base class: " + base.__name__))
+        ret = ret + HLIPythonObject.GetSubList(self)
+        return ret
+
+
+class HLIMethod(HLIPythonObject):
+    # myobject is just a string for methods.
+    def GetHLIType(self):
+        return "Method"
+
+    def GetText(self):
+        return "Method: " + self.myobject + "()"
+
+
+class HLICode(HLIPythonObject):
+    def GetHLIType(self):
+        return "Code"
+
+    def IsExpandable(self):
+        return self.myobject
+
+    def GetSubList(self):
+        ret = []
+        ret.append(MakeHLI(self.myobject.co_consts, "Constants (co_consts)"))
+        ret.append(MakeHLI(self.myobject.co_names, "Names (co_names)"))
+        ret.append(MakeHLI(self.myobject.co_filename, "Filename (co_filename)"))
+        ret.append(MakeHLI(self.myobject.co_argcount, "Number of args (co_argcount)"))
+        ret.append(MakeHLI(self.myobject.co_varnames, "Param names (co_varnames)"))
+
+        return ret
+
+
+class HLIInstance(HLIPythonObject):
+    def GetHLIType(self):
+        return "Instance"
+
+    def GetText(self):
+        return (
+            str(self.name)
+            + " (Instance of class "
+            + str(self.myobject.__class__.__name__)
+            + ")"
+        )
+
+    def IsExpandable(self):
+        return 1
+
+    def GetSubList(self):
+        ret = []
+        ret.append(MakeHLI(self.myobject.__class__))
+        ret = ret + HLIPythonObject.GetSubList(self)
+        return ret
+
+
+class HLIBuiltinFunction(HLIPythonObject):
+    def GetHLIType(self):
+        return "Builtin Function"
+
+
+class HLIFunction(HLIPythonObject):
+    def GetHLIType(self):
+        return "Function"
+
+    def IsExpandable(self):
+        return 1
+
+    def GetSubList(self):
+        ret = []
+        # 		ret.append( MakeHLI( self.myobject.func_argcount, "Arg Count" ))
+        try:
+            ret.append(MakeHLI(self.myobject.func_argdefs, "Arg Defs"))
+        except AttributeError:
+            pass
+        try:
+            code = self.myobject.__code__
+            globs = self.myobject.__globals__
+        except AttributeError:
+            # must be py2.5 or earlier...
+            code = self.myobject.func_code
+            globs = self.myobject.func_globals
+        ret.append(MakeHLI(code, "Code"))
+        ret.append(MakeHLI(globs, "Globals"))
+        self.InsertDocString(ret)
+        return ret
+
+
+class HLISeq(HLIPythonObject):
+    def GetHLIType(self):
+        return "Sequence (abstract!)"
+
+    def IsExpandable(self):
+        return len(self.myobject) > 0
+
+    def GetSubList(self):
+        ret = []
+        pos = 0
+        for item in self.myobject:
+            ret.append(MakeHLI(item, "[" + str(pos) + "]"))
+            pos = pos + 1
+        self.InsertDocString(ret)
+        return ret
+
+
+class HLIList(HLISeq):
+    def GetHLIType(self):
+        return "List"
+
+
+class HLITuple(HLISeq):
+    def GetHLIType(self):
+        return "Tuple"
+
+
+class HLIDict(HLIPythonObject):
+    def GetHLIType(self):
+        return "Dict"
+
+    def IsExpandable(self):
+        try:
+            self.myobject.__doc__
+            return 1
+        except (AttributeError, TypeError):
+            return len(self.myobject) > 0
+
+    def GetSubList(self):
+        ret = []
+        keys = list(self.myobject.keys())
+        keys.sort()
+        for key in keys:
+            ob = self.myobject[key]
+            ret.append(MakeHLI(ob, str(key)))
+        self.InsertDocString(ret)
+        return ret
+
+
+# In Python 1.6, strings and Unicode have builtin methods, but we dont really want to see these
+class HLIString(HLIPythonObject):
+    def IsExpandable(self):
+        return 0
+
+
+TypeMap = {
+    type: HLIClass,
+    types.FunctionType: HLIFunction,
+    tuple: HLITuple,
+    dict: HLIDict,
+    list: HLIList,
+    types.ModuleType: HLIModule,
+    types.CodeType: HLICode,
+    types.BuiltinFunctionType: HLIBuiltinFunction,
+    types.FrameType: HLIFrame,
+    types.TracebackType: HLITraceback,
+    str: HLIString,
+    int: HLIPythonObject,
+    bool: HLIPythonObject,
+    float: HLIPythonObject,
+}
+
+
+def MakeHLI(ob, name=None):
+    try:
+        cls = TypeMap[type(ob)]
+    except KeyError:
+        # hrmph - this check gets more and more bogus as Python
+        # improves.  Its possible we should just *always* use
+        # HLIInstance?
+        if hasattr(ob, "__class__"):  # 'new style' class
+            cls = HLIInstance
+        else:
+            cls = HLIPythonObject
+    return cls(ob, name)
+
+
+#########################################
+#
+# Dialog related.
+
+
+class DialogShowObject(dialog.Dialog):
+    def __init__(self, object, title):
+        self.object = object
+        self.title = title
+        dialog.Dialog.__init__(self, win32ui.IDD_LARGE_EDIT)
+
+    def OnInitDialog(self):
+        import re
+
+        self.SetWindowText(self.title)
+        self.edit = self.GetDlgItem(win32ui.IDC_EDIT1)
+        try:
+            strval = str(self.object)
+        except:
+            t, v, tb = sys.exc_info()
+            strval = "Exception getting object value\n\n%s:%s" % (t, v)
+            tb = None
+        strval = re.sub("\n", "\r\n", strval)
+        self.edit.ReplaceSel(strval)
+
+
+def ShowObject(object, title):
+    dlg = DialogShowObject(object, title)
+    dlg.DoModal()
+
+
+# And some mods for a sizable dialog from Sam Rushing!
+import commctrl
+import win32api
+import win32con
+
+
+class dynamic_browser(dialog.Dialog):
+    style = win32con.WS_OVERLAPPEDWINDOW | win32con.WS_VISIBLE
+    cs = (
+        win32con.WS_CHILD
+        | win32con.WS_VISIBLE
+        | commctrl.TVS_HASLINES
+        | commctrl.TVS_LINESATROOT
+        | commctrl.TVS_HASBUTTONS
+    )
+
+    dt = [
+        ["Python Object Browser", (0, 0, 200, 200), style, None, (8, "MS Sans Serif")],
+        ["SysTreeView32", None, win32ui.IDC_LIST1, (0, 0, 200, 200), cs],
+    ]
+
+    def __init__(self, hli_root):
+        dialog.Dialog.__init__(self, self.dt)
+        self.hier_list = hierlist.HierListWithItems(hli_root, win32ui.IDB_BROWSER_HIER)
+        self.HookMessage(self.on_size, win32con.WM_SIZE)
+
+    def OnInitDialog(self):
+        self.hier_list.HierInit(self)
+        return dialog.Dialog.OnInitDialog(self)
+
+    def OnOK(self):
+        self.hier_list.HierTerm()
+        self.hier_list = None
+        return self._obj_.OnOK()
+
+    def OnCancel(self):
+        self.hier_list.HierTerm()
+        self.hier_list = None
+        return self._obj_.OnCancel()
+
+    def on_size(self, params):
+        lparam = params[3]
+        w = win32api.LOWORD(lparam)
+        h = win32api.HIWORD(lparam)
+        self.GetDlgItem(win32ui.IDC_LIST1).MoveWindow((0, 0, w, h))
+
+
+def Browse(ob=__main__):
+    "Browse the argument, or the main dictionary"
+    root = MakeHLI(ob, "root")
+    if not root.IsExpandable():
+        raise TypeError(
+            "Browse() argument must have __dict__ attribute, or be a Browser supported type"
+        )
+
+    dlg = dynamic_browser(root)
+    dlg.CreateWindow()
+    return dlg
+
+
+#
+#
+# Classes for using the browser in an MDI window, rather than a dialog
+#
+from pywin.mfc import docview
+
+
+class BrowserTemplate(docview.DocTemplate):
+    def __init__(self):
+        docview.DocTemplate.__init__(
+            self, win32ui.IDR_PYTHONTYPE, BrowserDocument, None, BrowserView
+        )
+
+    def OpenObject(self, root):  # Use this instead of OpenDocumentFile.
+        # Look for existing open document
+        for doc in self.GetDocumentList():
+            if doc.root == root:
+                doc.GetFirstView().ActivateFrame()
+                return doc
+        # not found - new one.
+        doc = BrowserDocument(self, root)
+        frame = self.CreateNewFrame(doc)
+        doc.OnNewDocument()
+        self.InitialUpdateFrame(frame, doc, 1)
+        return doc
+
+
+class BrowserDocument(docview.Document):
+    def __init__(self, template, root):
+        docview.Document.__init__(self, template)
+        self.root = root
+        self.SetTitle("Browser: " + root.name)
+
+    def OnOpenDocument(self, name):
+        raise TypeError("This template can not open files")
+        return 0
+
+
+class BrowserView(docview.TreeView):
+    def OnInitialUpdate(self):
+        import commctrl
+
+        rc = self._obj_.OnInitialUpdate()
+        list = hierlist.HierListWithItems(
+            self.GetDocument().root,
+            win32ui.IDB_BROWSER_HIER,
+            win32ui.AFX_IDW_PANE_FIRST,
+        )
+        list.HierInit(self.GetParent())
+        list.SetStyle(
+            commctrl.TVS_HASLINES | commctrl.TVS_LINESATROOT | commctrl.TVS_HASBUTTONS
+        )
+        return rc
+
+
+template = None
+
+
+def MakeTemplate():
+    global template
+    if template is None:
+        template = (
+            BrowserTemplate()
+        )  # win32ui.IDR_PYTHONTYPE, BrowserDocument, None, BrowserView)
+
+
+def BrowseMDI(ob=__main__):
+    """Browse an object using an MDI window."""
+
+    MakeTemplate()
+    root = MakeHLI(ob, repr(ob))
+    if not root.IsExpandable():
+        raise TypeError(
+            "Browse() argument must have __dict__ attribute, or be a Browser supported type"
+        )
+
+    template.OpenObject(root)
diff --git a/lib/pythonwin/pywin/tools/hierlist.py b/lib/pythonwin/pywin/tools/hierlist.py
new file mode 100644
index 00000000..a60b7324
--- /dev/null
+++ b/lib/pythonwin/pywin/tools/hierlist.py
@@ -0,0 +1,367 @@
+# hierlist
+#
+# IMPORTANT - Please read before using.
+
+# This module exposes an API for a Hierarchical Tree Control.
+# Previously, a custom tree control was included in Pythonwin which
+# has an API very similar to this.
+
+# The current control used is the common "Tree Control".  This module exists now
+# to provide an API similar to the old control, but for the new Tree control.
+
+# If you need to use the Tree Control, you may still find this API a reasonable
+# choice.  However, you should investigate using the tree control directly
+# to provide maximum flexibility (but with extra work).
+
+import sys
+
+import commctrl
+import win32api
+import win32con
+import win32ui
+from pywin.mfc import dialog, docview, object, window
+from win32api import RGB
+
+
+# helper to get the text of an arbitary item
+def GetItemText(item):
+    if type(item) == type(()) or type(item) == type([]):
+        use = item[0]
+    else:
+        use = item
+    if type(use) == type(""):
+        return use
+    else:
+        return repr(item)
+
+
+class HierDialog(dialog.Dialog):
+    def __init__(
+        self,
+        title,
+        hierList,
+        bitmapID=win32ui.IDB_HIERFOLDERS,
+        dlgID=win32ui.IDD_TREE,
+        dll=None,
+        childListBoxID=win32ui.IDC_LIST1,
+    ):
+        dialog.Dialog.__init__(self, dlgID, dll)  # reuse this dialog.
+        self.hierList = hierList
+        self.dlgID = dlgID
+        self.title = title
+
+    # 		self.childListBoxID = childListBoxID
+    def OnInitDialog(self):
+        self.SetWindowText(self.title)
+        self.hierList.HierInit(self)
+        return dialog.Dialog.OnInitDialog(self)
+
+
+class HierList(object.Object):
+    def __init__(
+        self, root, bitmapID=win32ui.IDB_HIERFOLDERS, listBoxId=None, bitmapMask=None
+    ):  # used to create object.
+        self.listControl = None
+        self.bitmapID = bitmapID
+        self.root = root
+        self.listBoxId = listBoxId
+        self.itemHandleMap = {}
+        self.filledItemHandlesMap = {}
+        self.bitmapMask = bitmapMask
+
+    def __getattr__(self, attr):
+        try:
+            return getattr(self.listControl, attr)
+        except AttributeError:
+            return object.Object.__getattr__(self, attr)
+
+    def ItemFromHandle(self, handle):
+        return self.itemHandleMap[handle]
+
+    def SetStyle(self, newStyle):
+        hwnd = self.listControl.GetSafeHwnd()
+        style = win32api.GetWindowLong(hwnd, win32con.GWL_STYLE)
+        win32api.SetWindowLong(hwnd, win32con.GWL_STYLE, (style | newStyle))
+
+    def HierInit(self, parent, listControl=None):  # Used when window first exists.
+        # this also calls "Create" on the listbox.
+        # params - id of listbbox, ID of bitmap, size of bitmaps
+        if self.bitmapMask is None:
+            bitmapMask = RGB(0, 0, 255)
+        else:
+            bitmapMask = self.bitmapMask
+        self.imageList = win32ui.CreateImageList(self.bitmapID, 16, 0, bitmapMask)
+        if listControl is None:
+            if self.listBoxId is None:
+                self.listBoxId = win32ui.IDC_LIST1
+            self.listControl = parent.GetDlgItem(self.listBoxId)
+        else:
+            self.listControl = listControl
+            lbid = listControl.GetDlgCtrlID()
+            assert self.listBoxId is None or self.listBoxId == lbid, (
+                "An invalid listbox control ID has been specified (specified as %s, but exists as %s)"
+                % (self.listBoxId, lbid)
+            )
+            self.listBoxId = lbid
+        self.listControl.SetImageList(self.imageList, commctrl.LVSIL_NORMAL)
+        # 		self.list.AttachObject(self)
+
+        ## ??? Need a better way to do this - either some way to detect if it's compiled with UNICODE
+        ##  defined, and/or a way to switch the constants based on UNICODE ???
+        if sys.version_info[0] < 3:
+            parent.HookNotify(self.OnTreeItemExpanding, commctrl.TVN_ITEMEXPANDINGA)
+            parent.HookNotify(self.OnTreeItemSelChanged, commctrl.TVN_SELCHANGEDA)
+        else:
+            parent.HookNotify(self.OnTreeItemExpanding, commctrl.TVN_ITEMEXPANDINGW)
+            parent.HookNotify(self.OnTreeItemSelChanged, commctrl.TVN_SELCHANGEDW)
+        parent.HookNotify(self.OnTreeItemDoubleClick, commctrl.NM_DBLCLK)
+        self.notify_parent = parent
+
+        if self.root:
+            self.AcceptRoot(self.root)
+
+    def DeleteAllItems(self):
+        self.listControl.DeleteAllItems()
+        self.root = None
+        self.itemHandleMap = {}
+        self.filledItemHandlesMap = {}
+
+    def HierTerm(self):
+        # Dont want notifies as we kill the list.
+        parent = self.notify_parent  # GetParentFrame()
+        if sys.version_info[0] < 3:
+            parent.HookNotify(None, commctrl.TVN_ITEMEXPANDINGA)
+            parent.HookNotify(None, commctrl.TVN_SELCHANGEDA)
+        else:
+            parent.HookNotify(None, commctrl.TVN_ITEMEXPANDINGW)
+            parent.HookNotify(None, commctrl.TVN_SELCHANGEDW)
+        parent.HookNotify(None, commctrl.NM_DBLCLK)
+
+        self.DeleteAllItems()
+        self.listControl = None
+        self.notify_parent = None  # Break a possible cycle
+
+    def OnTreeItemDoubleClick(self, info, extra):
+        (hwndFrom, idFrom, code) = info
+        if idFrom != self.listBoxId:
+            return None
+        item = self.itemHandleMap[self.listControl.GetSelectedItem()]
+        self.TakeDefaultAction(item)
+        return 1
+
+    def OnTreeItemExpanding(self, info, extra):
+        (hwndFrom, idFrom, code) = info
+        if idFrom != self.listBoxId:
+            return None
+        action, itemOld, itemNew, pt = extra
+        itemHandle = itemNew[0]
+        if itemHandle not in self.filledItemHandlesMap:
+            item = self.itemHandleMap[itemHandle]
+            self.AddSubList(itemHandle, self.GetSubList(item))
+            self.filledItemHandlesMap[itemHandle] = None
+        return 0
+
+    def OnTreeItemSelChanged(self, info, extra):
+        (hwndFrom, idFrom, code) = info
+        if idFrom != self.listBoxId:
+            return None
+        action, itemOld, itemNew, pt = extra
+        itemHandle = itemNew[0]
+        item = self.itemHandleMap[itemHandle]
+        self.PerformItemSelected(item)
+        return 1
+
+    def AddSubList(self, parentHandle, subItems):
+        for item in subItems:
+            self.AddItem(parentHandle, item)
+
+    def AddItem(self, parentHandle, item, hInsertAfter=commctrl.TVI_LAST):
+        text = self.GetText(item)
+        if self.IsExpandable(item):
+            cItems = 1  # Trick it !!
+        else:
+            cItems = 0
+        bitmapCol = self.GetBitmapColumn(item)
+        bitmapSel = self.GetSelectedBitmapColumn(item)
+        if bitmapSel is None:
+            bitmapSel = bitmapCol
+        ## if type(text) is str:
+        ##	text = text.encode("mbcs")
+        hitem = self.listControl.InsertItem(
+            parentHandle,
+            hInsertAfter,
+            (None, None, None, text, bitmapCol, bitmapSel, cItems, 0),
+        )
+        self.itemHandleMap[hitem] = item
+        return hitem
+
+    def _GetChildHandles(self, handle):
+        ret = []
+        try:
+            handle = self.listControl.GetChildItem(handle)
+            while 1:
+                ret.append(handle)
+                handle = self.listControl.GetNextItem(handle, commctrl.TVGN_NEXT)
+        except win32ui.error:
+            # out of children
+            pass
+        return ret
+
+    def Refresh(self, hparent=None):
+        # Attempt to refresh the given item's sub-entries, but maintain the tree state
+        # (ie, the selected item, expanded items, etc)
+        if hparent is None:
+            hparent = commctrl.TVI_ROOT
+        if hparent not in self.filledItemHandlesMap:
+            # This item has never been expanded, so no refresh can possibly be required.
+            return
+        root_item = self.itemHandleMap[hparent]
+        old_handles = self._GetChildHandles(hparent)
+        old_items = list(map(self.ItemFromHandle, old_handles))
+        new_items = self.GetSubList(root_item)
+        # Now an inefficient technique for synching the items.
+        inew = 0
+        hAfter = commctrl.TVI_FIRST
+        for iold in range(len(old_items)):
+            inewlook = inew
+            matched = 0
+            while inewlook < len(new_items):
+                if old_items[iold] == new_items[inewlook]:
+                    matched = 1
+                    break
+                inewlook = inewlook + 1
+            if matched:
+                # Insert the new items.
+                # 				print "Inserting after", old_items[iold], old_handles[iold]
+                for i in range(inew, inewlook):
+                    # 					print "Inserting index %d (%s)" % (i, new_items[i])
+                    hAfter = self.AddItem(hparent, new_items[i], hAfter)
+
+                inew = inewlook + 1
+                # And recursively refresh iold
+                hold = old_handles[iold]
+                if hold in self.filledItemHandlesMap:
+                    self.Refresh(hold)
+            else:
+                # Remove the deleted items.
+                # 				print "Deleting %d (%s)" % (iold, old_items[iold])
+                hdelete = old_handles[iold]
+                # First recurse and remove the children from the map.
+                for hchild in self._GetChildHandles(hdelete):
+                    del self.itemHandleMap[hchild]
+                    if hchild in self.filledItemHandlesMap:
+                        del self.filledItemHandlesMap[hchild]
+                self.listControl.DeleteItem(hdelete)
+            hAfter = old_handles[iold]
+        # Fill any remaining new items:
+        for newItem in new_items[inew:]:
+            # 			print "Inserting new item", newItem
+            self.AddItem(hparent, newItem)
+
+    def AcceptRoot(self, root):
+        self.listControl.DeleteAllItems()
+        self.itemHandleMap = {commctrl.TVI_ROOT: root}
+        self.filledItemHandlesMap = {commctrl.TVI_ROOT: root}
+        subItems = self.GetSubList(root)
+        self.AddSubList(0, subItems)
+
+    def GetBitmapColumn(self, item):
+        if self.IsExpandable(item):
+            return 0
+        else:
+            return 4
+
+    def GetSelectedBitmapColumn(self, item):
+        return 0
+
+    def CheckChangedChildren(self):
+        return self.listControl.CheckChangedChildren()
+
+    def GetText(self, item):
+        return GetItemText(item)
+
+    def PerformItemSelected(self, item):
+        try:
+            win32ui.SetStatusText("Selected " + self.GetText(item))
+        except win32ui.error:  # No status bar!
+            pass
+
+    def TakeDefaultAction(self, item):
+        win32ui.MessageBox("Got item " + self.GetText(item))
+
+
+##########################################################################
+#
+# Classes for use with seperate HierListItems.
+#
+#
+class HierListWithItems(HierList):
+    def __init__(
+        self, root, bitmapID=win32ui.IDB_HIERFOLDERS, listBoxID=None, bitmapMask=None
+    ):  # used to create object.
+        HierList.__init__(self, root, bitmapID, listBoxID, bitmapMask)
+
+    def DelegateCall(self, fn):
+        return fn()
+
+    def GetBitmapColumn(self, item):
+        rc = self.DelegateCall(item.GetBitmapColumn)
+        if rc is None:
+            rc = HierList.GetBitmapColumn(self, item)
+        return rc
+
+    def GetSelectedBitmapColumn(self, item):
+        return self.DelegateCall(item.GetSelectedBitmapColumn)
+
+    def IsExpandable(self, item):
+        return self.DelegateCall(item.IsExpandable)
+
+    def GetText(self, item):
+        return self.DelegateCall(item.GetText)
+
+    def GetSubList(self, item):
+        return self.DelegateCall(item.GetSubList)
+
+    def PerformItemSelected(self, item):
+        func = getattr(item, "PerformItemSelected", None)
+        if func is None:
+            return HierList.PerformItemSelected(self, item)
+        else:
+            return self.DelegateCall(func)
+
+    def TakeDefaultAction(self, item):
+        func = getattr(item, "TakeDefaultAction", None)
+        if func is None:
+            return HierList.TakeDefaultAction(self, item)
+        else:
+            return self.DelegateCall(func)
+
+
+# A hier list item - for use with a HierListWithItems
+class HierListItem:
+    def __init__(self):
+        pass
+
+    def GetText(self):
+        pass
+
+    def GetSubList(self):
+        pass
+
+    def IsExpandable(self):
+        pass
+
+    def GetBitmapColumn(self):
+        return None  # indicate he should do it.
+
+    def GetSelectedBitmapColumn(self):
+        return None  # same as other
+
+    # for py3k/rich-comp sorting compatibility.
+    def __lt__(self, other):
+        # we want unrelated items to be sortable...
+        return id(self) < id(other)
+
+    # for py3k/rich-comp equality compatibility.
+    def __eq__(self, other):
+        return False
diff --git a/lib/pythonwin/pywin/tools/regedit.py b/lib/pythonwin/pywin/tools/regedit.py
new file mode 100644
index 00000000..b94d3050
--- /dev/null
+++ b/lib/pythonwin/pywin/tools/regedit.py
@@ -0,0 +1,386 @@
+# Regedit - a Registry Editor for Python
+
+import commctrl
+import regutil
+import win32api
+import win32con
+import win32ui
+from pywin.mfc import dialog, docview, window
+
+from . import hierlist
+
+
+def SafeApply(fn, args, err_desc=""):
+    try:
+        fn(*args)
+        return 1
+    except win32api.error as exc:
+        msg = "Error " + err_desc + "\r\n\r\n" + exc.strerror
+        win32ui.MessageBox(msg)
+        return 0
+
+
+class SplitterFrame(window.MDIChildWnd):
+    def __init__(self):
+        # call base CreateFrame
+        self.images = None
+        window.MDIChildWnd.__init__(self)
+
+    def OnCreateClient(self, cp, context):
+        splitter = win32ui.CreateSplitter()
+        doc = context.doc
+        frame_rect = self.GetWindowRect()
+        size = ((frame_rect[2] - frame_rect[0]), (frame_rect[3] - frame_rect[1]) // 2)
+        sub_size = (size[0] // 3, size[1])
+        splitter.CreateStatic(self, 1, 2)
+        # CTreeControl view
+        self.keysview = RegistryTreeView(doc)
+        # CListControl view
+        self.valuesview = RegistryValueView(doc)
+
+        splitter.CreatePane(self.keysview, 0, 0, (sub_size))
+        splitter.CreatePane(self.valuesview, 0, 1, (0, 0))  # size ignored.
+        splitter.SetRowInfo(0, size[1], 0)
+        # Setup items in the imagelist
+
+        return 1
+
+    def OnItemDoubleClick(self, info, extra):
+        (hwndFrom, idFrom, code) = info
+        if idFrom == win32ui.AFX_IDW_PANE_FIRST:
+            # Tree control
+            return None
+        elif idFrom == win32ui.AFX_IDW_PANE_FIRST + 1:
+            item = self.keysview.SelectedItem()
+            self.valuesview.EditValue(item)
+            return 0
+            # List control
+        else:
+            return None  # Pass it on
+
+    def PerformItemSelected(self, item):
+        return self.valuesview.UpdateForRegItem(item)
+
+    def OnDestroy(self, msg):
+        window.MDIChildWnd.OnDestroy(self, msg)
+        if self.images:
+            self.images.DeleteImageList()
+            self.images = None
+
+
+class RegistryTreeView(docview.TreeView):
+    def OnInitialUpdate(self):
+        rc = self._obj_.OnInitialUpdate()
+        self.frame = self.GetParent().GetParent()
+        self.hierList = hierlist.HierListWithItems(
+            self.GetHLIRoot(), win32ui.IDB_HIERFOLDERS, win32ui.AFX_IDW_PANE_FIRST
+        )
+        self.hierList.HierInit(self.frame, self.GetTreeCtrl())
+        self.hierList.SetStyle(
+            commctrl.TVS_HASLINES | commctrl.TVS_LINESATROOT | commctrl.TVS_HASBUTTONS
+        )
+        self.hierList.PerformItemSelected = self.PerformItemSelected
+
+        self.frame.HookNotify(self.frame.OnItemDoubleClick, commctrl.NM_DBLCLK)
+        self.frame.HookNotify(self.OnItemRightClick, commctrl.NM_RCLICK)
+
+    # 		self.HookMessage(self.OnItemRightClick, win32con.WM_RBUTTONUP)
+
+    def GetHLIRoot(self):
+        doc = self.GetDocument()
+        regroot = doc.root
+        subkey = doc.subkey
+        return HLIRegistryKey(regroot, subkey, "Root")
+
+    def OnItemRightClick(self, notify_data, extra):
+        # First select the item we right-clicked on.
+        pt = self.ScreenToClient(win32api.GetCursorPos())
+        flags, hItem = self.HitTest(pt)
+        if hItem == 0 or commctrl.TVHT_ONITEM & flags == 0:
+            return None
+        self.Select(hItem, commctrl.TVGN_CARET)
+
+        menu = win32ui.CreatePopupMenu()
+        menu.AppendMenu(win32con.MF_STRING | win32con.MF_ENABLED, 1000, "Add Key")
+        menu.AppendMenu(win32con.MF_STRING | win32con.MF_ENABLED, 1001, "Add Value")
+        menu.AppendMenu(win32con.MF_STRING | win32con.MF_ENABLED, 1002, "Delete Key")
+        self.HookCommand(self.OnAddKey, 1000)
+        self.HookCommand(self.OnAddValue, 1001)
+        self.HookCommand(self.OnDeleteKey, 1002)
+        menu.TrackPopupMenu(win32api.GetCursorPos())  # track at mouse position.
+        return None
+
+    def OnDeleteKey(self, command, code):
+        hitem = self.hierList.GetSelectedItem()
+        item = self.hierList.ItemFromHandle(hitem)
+        msg = "Are you sure you wish to delete the key '%s'?" % (item.keyName,)
+        id = win32ui.MessageBox(msg, None, win32con.MB_YESNO)
+        if id != win32con.IDYES:
+            return
+        if SafeApply(
+            win32api.RegDeleteKey, (item.keyRoot, item.keyName), "deleting registry key"
+        ):
+            # Get the items parent.
+            try:
+                hparent = self.GetParentItem(hitem)
+            except win32ui.error:
+                hparent = None
+            self.hierList.Refresh(hparent)
+
+    def OnAddKey(self, command, code):
+        from pywin.mfc import dialog
+
+        val = dialog.GetSimpleInput("New key name", "", "Add new key")
+        if val is None:
+            return  # cancelled.
+        hitem = self.hierList.GetSelectedItem()
+        item = self.hierList.ItemFromHandle(hitem)
+        if SafeApply(win32api.RegCreateKey, (item.keyRoot, item.keyName + "\\" + val)):
+            self.hierList.Refresh(hitem)
+
+    def OnAddValue(self, command, code):
+        from pywin.mfc import dialog
+
+        val = dialog.GetSimpleInput("New value", "", "Add new value")
+        if val is None:
+            return  # cancelled.
+        hitem = self.hierList.GetSelectedItem()
+        item = self.hierList.ItemFromHandle(hitem)
+        if SafeApply(
+            win32api.RegSetValue, (item.keyRoot, item.keyName, win32con.REG_SZ, val)
+        ):
+            # Simply re-select the current item to refresh the right spitter.
+            self.PerformItemSelected(item)
+
+    # 			self.Select(hitem, commctrl.TVGN_CARET)
+
+    def PerformItemSelected(self, item):
+        return self.frame.PerformItemSelected(item)
+
+    def SelectedItem(self):
+        return self.hierList.ItemFromHandle(self.hierList.GetSelectedItem())
+
+    def SearchSelectedItem(self):
+        handle = self.hierList.GetChildItem(0)
+        while 1:
+            # 			print "State is", self.hierList.GetItemState(handle, -1)
+            if self.hierList.GetItemState(handle, commctrl.TVIS_SELECTED):
+                # 				print "Item is ", self.hierList.ItemFromHandle(handle)
+                return self.hierList.ItemFromHandle(handle)
+            handle = self.hierList.GetNextSiblingItem(handle)
+
+
+class RegistryValueView(docview.ListView):
+    def OnInitialUpdate(self):
+        hwnd = self._obj_.GetSafeHwnd()
+        style = win32api.GetWindowLong(hwnd, win32con.GWL_STYLE)
+        win32api.SetWindowLong(
+            hwnd,
+            win32con.GWL_STYLE,
+            (style & ~commctrl.LVS_TYPEMASK) | commctrl.LVS_REPORT,
+        )
+
+        itemDetails = (commctrl.LVCFMT_LEFT, 100, "Name", 0)
+        self.InsertColumn(0, itemDetails)
+        itemDetails = (commctrl.LVCFMT_LEFT, 500, "Data", 0)
+        self.InsertColumn(1, itemDetails)
+
+    def UpdateForRegItem(self, item):
+        self.DeleteAllItems()
+        hkey = win32api.RegOpenKey(item.keyRoot, item.keyName)
+        try:
+            valNum = 0
+            ret = []
+            while 1:
+                try:
+                    res = win32api.RegEnumValue(hkey, valNum)
+                except win32api.error:
+                    break
+                name = res[0]
+                if not name:
+                    name = "(Default)"
+                self.InsertItem(valNum, name)
+                self.SetItemText(valNum, 1, str(res[1]))
+                valNum = valNum + 1
+        finally:
+            win32api.RegCloseKey(hkey)
+
+    def EditValue(self, item):
+        # Edit the current value
+        class EditDialog(dialog.Dialog):
+            def __init__(self, item):
+                self.item = item
+                dialog.Dialog.__init__(self, win32ui.IDD_LARGE_EDIT)
+
+            def OnInitDialog(self):
+                self.SetWindowText("Enter new value")
+                self.GetDlgItem(win32con.IDCANCEL).ShowWindow(win32con.SW_SHOW)
+                self.edit = self.GetDlgItem(win32ui.IDC_EDIT1)
+                # Modify the edit windows style
+                style = win32api.GetWindowLong(
+                    self.edit.GetSafeHwnd(), win32con.GWL_STYLE
+                )
+                style = style & (~win32con.ES_WANTRETURN)
+                win32api.SetWindowLong(
+                    self.edit.GetSafeHwnd(), win32con.GWL_STYLE, style
+                )
+                self.edit.SetWindowText(str(self.item))
+                self.edit.SetSel(-1)
+                return dialog.Dialog.OnInitDialog(self)
+
+            def OnDestroy(self, msg):
+                self.newvalue = self.edit.GetWindowText()
+
+        try:
+            index = self.GetNextItem(-1, commctrl.LVNI_SELECTED)
+        except win32ui.error:
+            return  # No item selected.
+
+        if index == 0:
+            keyVal = ""
+        else:
+            keyVal = self.GetItemText(index, 0)
+        # Query for a new value.
+        try:
+            newVal = self.GetItemsCurrentValue(item, keyVal)
+        except TypeError as details:
+            win32ui.MessageBox(details)
+            return
+
+        d = EditDialog(newVal)
+        if d.DoModal() == win32con.IDOK:
+            try:
+                self.SetItemsCurrentValue(item, keyVal, d.newvalue)
+            except win32api.error as exc:
+                win32ui.MessageBox("Error setting value\r\n\n%s" % exc.strerror)
+            self.UpdateForRegItem(item)
+
+    def GetItemsCurrentValue(self, item, valueName):
+        hkey = win32api.RegOpenKey(item.keyRoot, item.keyName)
+        try:
+            val, type = win32api.RegQueryValueEx(hkey, valueName)
+            if type != win32con.REG_SZ:
+                raise TypeError("Only strings can be edited")
+            return val
+        finally:
+            win32api.RegCloseKey(hkey)
+
+    def SetItemsCurrentValue(self, item, valueName, value):
+        # ** Assumes already checked is a string.
+        hkey = win32api.RegOpenKey(
+            item.keyRoot, item.keyName, 0, win32con.KEY_SET_VALUE
+        )
+        try:
+            win32api.RegSetValueEx(hkey, valueName, 0, win32con.REG_SZ, value)
+        finally:
+            win32api.RegCloseKey(hkey)
+
+
+class RegTemplate(docview.DocTemplate):
+    def __init__(self):
+        docview.DocTemplate.__init__(
+            self, win32ui.IDR_PYTHONTYPE, None, SplitterFrame, None
+        )
+
+    # 	def InitialUpdateFrame(self, frame, doc, makeVisible=1):
+    # 		self._obj_.InitialUpdateFrame(frame, doc, makeVisible) # call default handler.
+    # 		frame.InitialUpdateFrame(doc, makeVisible)
+
+    def OpenRegistryKey(
+        self, root=None, subkey=None
+    ):  # Use this instead of OpenDocumentFile.
+        # Look for existing open document
+        if root is None:
+            root = regutil.GetRootKey()
+        if subkey is None:
+            subkey = regutil.BuildDefaultPythonKey()
+        for doc in self.GetDocumentList():
+            if doc.root == root and doc.subkey == subkey:
+                doc.GetFirstView().ActivateFrame()
+                return doc
+        # not found - new one.
+        doc = RegDocument(self, root, subkey)
+        frame = self.CreateNewFrame(doc)
+        doc.OnNewDocument()
+        self.InitialUpdateFrame(frame, doc, 1)
+        return doc
+
+
+class RegDocument(docview.Document):
+    def __init__(self, template, root, subkey):
+        docview.Document.__init__(self, template)
+        self.root = root
+        self.subkey = subkey
+        self.SetTitle("Registry Editor: " + subkey)
+
+    def OnOpenDocument(self, name):
+        raise TypeError("This template can not open files")
+        return 0
+
+
+class HLIRegistryKey(hierlist.HierListItem):
+    def __init__(self, keyRoot, keyName, userName):
+        self.keyRoot = keyRoot
+        self.keyName = keyName
+        self.userName = userName
+        hierlist.HierListItem.__init__(self)
+
+    def __lt__(self, other):
+        return self.name < other.name
+
+    def __eq__(self, other):
+        return (
+            self.keyRoot == other.keyRoot
+            and self.keyName == other.keyName
+            and self.userName == other.userName
+        )
+
+    def __repr__(self):
+        return "<%s with root=%s, key=%s>" % (
+            self.__class__.__name__,
+            self.keyRoot,
+            self.keyName,
+        )
+
+    def GetText(self):
+        return self.userName
+
+    def IsExpandable(self):
+        # All keys are expandable, even if they currently have zero children.
+        return 1
+
+    ##		hkey = win32api.RegOpenKey(self.keyRoot, self.keyName)
+    ##		try:
+    ##			keys, vals, dt = win32api.RegQueryInfoKey(hkey)
+    ##			return (keys>0)
+    ##		finally:
+    ##			win32api.RegCloseKey(hkey)
+
+    def GetSubList(self):
+        hkey = win32api.RegOpenKey(self.keyRoot, self.keyName)
+        win32ui.DoWaitCursor(1)
+        try:
+            keyNum = 0
+            ret = []
+            while 1:
+                try:
+                    key = win32api.RegEnumKey(hkey, keyNum)
+                except win32api.error:
+                    break
+                ret.append(HLIRegistryKey(self.keyRoot, self.keyName + "\\" + key, key))
+                keyNum = keyNum + 1
+        finally:
+            win32api.RegCloseKey(hkey)
+            win32ui.DoWaitCursor(0)
+        return ret
+
+
+template = RegTemplate()
+
+
+def EditRegistry(root=None, key=None):
+    doc = template.OpenRegistryKey(root, key)
+
+
+if __name__ == "__main__":
+    EditRegistry()
diff --git a/lib/pythonwin/pywin/tools/regpy.py b/lib/pythonwin/pywin/tools/regpy.py
new file mode 100644
index 00000000..11ad63af
--- /dev/null
+++ b/lib/pythonwin/pywin/tools/regpy.py
@@ -0,0 +1,81 @@
+# (sort-of) Registry editor
+import commctrl
+import dialog
+import win32con
+import win32ui
+
+
+class RegistryControl:
+    def __init__(self, key):
+        self.key = key
+
+
+class RegEditPropertyPage(dialog.PropertyPage):
+    IDC_LISTVIEW = 1000
+
+    def GetTemplate(self):
+        "Return the template used to create this dialog"
+
+        w = 152  # Dialog width
+        h = 122  # Dialog height
+        SS_STD = win32con.WS_CHILD | win32con.WS_VISIBLE
+        FRAMEDLG_STD = win32con.WS_CAPTION | win32con.WS_SYSMENU
+        style = (
+            FRAMEDLG_STD
+            | win32con.WS_VISIBLE
+            | win32con.DS_SETFONT
+            | win32con.WS_MINIMIZEBOX
+        )
+        template = [
+            [self.caption, (0, 0, w, h), style, None, (8, "Helv")],
+        ]
+        lvStyle = (
+            SS_STD
+            | commctrl.LVS_EDITLABELS
+            | commctrl.LVS_REPORT
+            | commctrl.LVS_AUTOARRANGE
+            | commctrl.LVS_ALIGNLEFT
+            | win32con.WS_BORDER
+            | win32con.WS_TABSTOP
+        )
+        template.append(
+            ["SysListView32", "", self.IDC_LISTVIEW, (10, 10, 185, 100), lvStyle]
+        )
+        return template
+
+
+class RegistryPage(RegEditPropertyPage):
+    def __init__(self):
+        self.caption = "Path"
+        RegEditPropertyPage.__init__(self, self.GetTemplate())
+
+    def OnInitDialog(self):
+        self.listview = self.GetDlgItem(self.IDC_LISTVIEW)
+        RegEditPropertyPage.OnInitDialog(self)
+        # Setup the listview columns
+        itemDetails = (commctrl.LVCFMT_LEFT, 100, "App", 0)
+        self.listview.InsertColumn(0, itemDetails)
+        itemDetails = (commctrl.LVCFMT_LEFT, 1024, "Paths", 0)
+        self.listview.InsertColumn(1, itemDetails)
+
+        index = self.listview.InsertItem(0, "App")
+        self.listview.SetItemText(index, 1, "Path")
+
+
+class RegistrySheet(dialog.PropertySheet):
+    def __init__(self, title):
+        dialog.PropertySheet.__init__(self, title)
+        self.HookMessage(self.OnActivate, win32con.WM_ACTIVATE)
+
+    def OnActivate(self, msg):
+        print("OnAcivate")
+
+
+def t():
+    ps = RegistrySheet("Registry Settings")
+    ps.AddPage(RegistryPage())
+    ps.DoModal()
+
+
+if __name__ == "__main__":
+    t()
diff --git a/lib/pythonwin/start_pythonwin.pyw b/lib/pythonwin/start_pythonwin.pyw
new file mode 100644
index 00000000..0a1b2e60
--- /dev/null
+++ b/lib/pythonwin/start_pythonwin.pyw
@@ -0,0 +1,19 @@
+# A Python file that can be used to start Pythonwin, instead of using
+# pythonwin.exe
+import os
+import sys
+
+import win32ui
+
+import pywin.framework.intpyapp  # InteractivePythonApp()
+
+assert pywin.framework.intpyapp  # not unused
+# Pretend this script doesn't exist, or pythonwin tries to edit it
+sys.argv[:] = sys.argv[1:] or [""]  # like PySys_SetArgv(Ex)
+if sys.path[0] not in ("", ".", os.getcwd()):
+    sys.path.insert(0, os.getcwd())
+# And bootstrap the app.
+app = win32ui.GetApp()
+if not app.InitInstance():
+    # Run when not already handled by DDE
+    app.Run()
diff --git a/lib/pywin32.version.txt b/lib/pywin32.version.txt
new file mode 100644
index 00000000..cd307095
--- /dev/null
+++ b/lib/pywin32.version.txt
@@ -0,0 +1 @@
+306
diff --git a/lib/tempora/timing.py b/lib/tempora/timing.py
index aed0d336..e74b8962 100644
--- a/lib/tempora/timing.py
+++ b/lib/tempora/timing.py
@@ -1,22 +1,21 @@
+import collections.abc
+import contextlib
 import datetime
 import functools
 import numbers
 import time
-import collections.abc
-import contextlib
 
 import jaraco.functools
 
 
 class Stopwatch:
     """
-    A simple stopwatch which starts automatically.
+    A simple stopwatch that starts automatically.
 
     >>> w = Stopwatch()
     >>> _1_sec = datetime.timedelta(seconds=1)
     >>> w.split() < _1_sec
     True
-    >>> import time
     >>> time.sleep(1.0)
     >>> w.split() >= _1_sec
     True
@@ -27,13 +26,13 @@ class Stopwatch:
     >>> w.split() < _1_sec
     True
 
-    It should be possible to launch the Stopwatch in a context:
+    Launch the Stopwatch in a context:
 
     >>> with Stopwatch() as watch:
     ...     assert isinstance(watch.split(), datetime.timedelta)
 
-    In that case, the watch is stopped when the context is exited,
-    so to read the elapsed time:
+    After exiting the context, the watch is stopped; read the
+    elapsed time directly:
 
     >>> watch.elapsed
     datetime.timedelta(...)
diff --git a/lib/typing_extensions.py b/lib/typing_extensions.py
index ef42417c..f3132ea4 100644
--- a/lib/typing_extensions.py
+++ b/lib/typing_extensions.py
@@ -2,11 +2,12 @@ import abc
 import collections
 import collections.abc
 import functools
+import inspect
 import operator
 import sys
 import types as _types
 import typing
-
+import warnings
 
 __all__ = [
     # Super-special typing primitives.
@@ -31,6 +32,7 @@ __all__ = [
     'Coroutine',
     'AsyncGenerator',
     'AsyncContextManager',
+    'Buffer',
     'ChainMap',
 
     # Concrete collection types.
@@ -43,7 +45,13 @@ __all__ = [
     'TypedDict',
 
     # Structural checks, a.k.a. protocols.
+    'SupportsAbs',
+    'SupportsBytes',
+    'SupportsComplex',
+    'SupportsFloat',
     'SupportsIndex',
+    'SupportsInt',
+    'SupportsRound',
 
     # One-off things.
     'Annotated',
@@ -51,12 +59,17 @@ __all__ = [
     'assert_type',
     'clear_overloads',
     'dataclass_transform',
+    'deprecated',
+    'Doc',
     'get_overloads',
     'final',
     'get_args',
     'get_origin',
+    'get_original_bases',
+    'get_protocol_members',
     'get_type_hints',
     'IntVar',
+    'is_protocol',
     'is_typeddict',
     'Literal',
     'NewType',
@@ -68,12 +81,54 @@ __all__ = [
     'runtime_checkable',
     'Text',
     'TypeAlias',
+    'TypeAliasType',
     'TypeGuard',
+    'TypeIs',
     'TYPE_CHECKING',
     'Never',
     'NoReturn',
+    'ReadOnly',
     'Required',
     'NotRequired',
+
+    # Pure aliases, have always been in typing
+    'AbstractSet',
+    'AnyStr',
+    'BinaryIO',
+    'Callable',
+    'Collection',
+    'Container',
+    'Dict',
+    'ForwardRef',
+    'FrozenSet',
+    'Generator',
+    'Generic',
+    'Hashable',
+    'IO',
+    'ItemsView',
+    'Iterable',
+    'Iterator',
+    'KeysView',
+    'List',
+    'Mapping',
+    'MappingView',
+    'Match',
+    'MutableMapping',
+    'MutableSequence',
+    'MutableSet',
+    'Optional',
+    'Pattern',
+    'Reversible',
+    'Sequence',
+    'Set',
+    'Sized',
+    'TextIO',
+    'Tuple',
+    'Union',
+    'ValuesView',
+    'cast',
+    'no_type_check',
+    'no_type_check_decorator',
 ]
 
 # for backward compatibility
@@ -83,7 +138,13 @@ GenericMeta = type
 # The functions below are modified copies of typing internal helpers.
 # They are needed by _ProtocolMeta and they provide support for PEP 646.
 
-_marker = object()
+
+class _Sentinel:
+    def __repr__(self):
+        return "<sentinel>"
+
+
+_marker = _Sentinel()
 
 
 def _check_generic(cls, parameters, elen=_marker):
@@ -184,36 +245,13 @@ else:
 
 ClassVar = typing.ClassVar
 
-# On older versions of typing there is an internal class named "Final".
-# 3.8+
-if hasattr(typing, 'Final') and sys.version_info[:2] >= (3, 7):
-    Final = typing.Final
-# 3.7
-else:
-    class _FinalForm(typing._SpecialForm, _root=True):
 
-        def __repr__(self):
-            return 'typing_extensions.' + self._name
+class _ExtensionsSpecialForm(typing._SpecialForm, _root=True):
+    def __repr__(self):
+        return 'typing_extensions.' + self._name
 
-        def __getitem__(self, parameters):
-            item = typing._type_check(parameters,
-                                      f'{self._name} accepts only a single type.')
-            return typing._GenericAlias(self, (item,))
 
-    Final = _FinalForm('Final',
-                       doc="""A special typing construct to indicate that a name
-                       cannot be re-assigned or overridden in a subclass.
-                       For example:
-
-                           MAX_SIZE: Final = 9000
-                           MAX_SIZE += 1  # Error reported by type checker
-
-                           class Connection:
-                               TIMEOUT: Final[int] = 10
-                           class FastConnector(Connection):
-                               TIMEOUT = 1  # Error reported by type checker
-
-                       There is no runtime checking of these properties.""")
+Final = typing.Final
 
 if sys.version_info >= (3, 11):
     final = typing.final
@@ -257,21 +295,67 @@ def IntVar(name):
     return typing.TypeVar(name)
 
 
-# 3.8+:
-if hasattr(typing, 'Literal'):
+# A Literal bug was fixed in 3.11.0, 3.10.1 and 3.9.8
+if sys.version_info >= (3, 10, 1):
     Literal = typing.Literal
-# 3.7:
 else:
-    class _LiteralForm(typing._SpecialForm, _root=True):
+    def _flatten_literal_params(parameters):
+        """An internal helper for Literal creation: flatten Literals among parameters"""
+        params = []
+        for p in parameters:
+            if isinstance(p, _LiteralGenericAlias):
+                params.extend(p.__args__)
+            else:
+                params.append(p)
+        return tuple(params)
 
-        def __repr__(self):
-            return 'typing_extensions.' + self._name
+    def _value_and_type_iter(params):
+        for p in params:
+            yield p, type(p)
+
+    class _LiteralGenericAlias(typing._GenericAlias, _root=True):
+        def __eq__(self, other):
+            if not isinstance(other, _LiteralGenericAlias):
+                return NotImplemented
+            these_args_deduped = set(_value_and_type_iter(self.__args__))
+            other_args_deduped = set(_value_and_type_iter(other.__args__))
+            return these_args_deduped == other_args_deduped
+
+        def __hash__(self):
+            return hash(frozenset(_value_and_type_iter(self.__args__)))
+
+    class _LiteralForm(_ExtensionsSpecialForm, _root=True):
+        def __init__(self, doc: str):
+            self._name = 'Literal'
+            self._doc = self.__doc__ = doc
 
         def __getitem__(self, parameters):
-            return typing._GenericAlias(self, parameters)
+            if not isinstance(parameters, tuple):
+                parameters = (parameters,)
 
-    Literal = _LiteralForm('Literal',
-                           doc="""A type that can be used to indicate to type checkers
+            parameters = _flatten_literal_params(parameters)
+
+            val_type_pairs = list(_value_and_type_iter(parameters))
+            try:
+                deduped_pairs = set(val_type_pairs)
+            except TypeError:
+                # unhashable parameters
+                pass
+            else:
+                # similar logic to typing._deduplicate on Python 3.9+
+                if len(deduped_pairs) < len(val_type_pairs):
+                    new_parameters = []
+                    for pair in val_type_pairs:
+                        if pair in deduped_pairs:
+                            new_parameters.append(pair[0])
+                            deduped_pairs.remove(pair)
+                    assert not deduped_pairs, deduped_pairs
+                    parameters = tuple(new_parameters)
+
+            return _LiteralGenericAlias(self, parameters)
+
+    Literal = _LiteralForm(doc="""\
+                           A type that can be used to indicate to type checkers
                            that the corresponding value has a value literally equivalent
                            to the provided parameter. For example:
 
@@ -285,7 +369,7 @@ else:
                            instead of a type.""")
 
 
-_overload_dummy = typing._overload_dummy  # noqa
+_overload_dummy = typing._overload_dummy
 
 
 if hasattr(typing, "get_overloads"):  # 3.11+
@@ -359,8 +443,6 @@ Type = typing.Type
 
 # Various ABCs mimicking those in collections.abc.
 # A few are simply re-exported for completeness.
-
-
 Awaitable = typing.Awaitable
 Coroutine = typing.Coroutine
 AsyncIterable = typing.AsyncIterable
@@ -369,278 +451,343 @@ Deque = typing.Deque
 ContextManager = typing.ContextManager
 AsyncContextManager = typing.AsyncContextManager
 DefaultDict = typing.DefaultDict
-
-# 3.7.2+
-if hasattr(typing, 'OrderedDict'):
-    OrderedDict = typing.OrderedDict
-# 3.7.0-3.7.2
-else:
-    OrderedDict = typing._alias(collections.OrderedDict, (KT, VT))
-
+OrderedDict = typing.OrderedDict
 Counter = typing.Counter
 ChainMap = typing.ChainMap
 AsyncGenerator = typing.AsyncGenerator
-NewType = typing.NewType
 Text = typing.Text
 TYPE_CHECKING = typing.TYPE_CHECKING
 
 
-_PROTO_WHITELIST = ['Callable', 'Awaitable',
-                    'Iterable', 'Iterator', 'AsyncIterable', 'AsyncIterator',
-                    'Hashable', 'Sized', 'Container', 'Collection', 'Reversible',
-                    'ContextManager', 'AsyncContextManager']
+_PROTO_ALLOWLIST = {
+    'collections.abc': [
+        'Callable', 'Awaitable', 'Iterable', 'Iterator', 'AsyncIterable',
+        'Hashable', 'Sized', 'Container', 'Collection', 'Reversible', 'Buffer',
+    ],
+    'contextlib': ['AbstractContextManager', 'AbstractAsyncContextManager'],
+    'typing_extensions': ['Buffer'],
+}
+
+
+_EXCLUDED_ATTRS = {
+    "__abstractmethods__", "__annotations__", "__weakref__", "_is_protocol",
+    "_is_runtime_protocol", "__dict__", "__slots__", "__parameters__",
+    "__orig_bases__", "__module__", "_MutableMapping__marker", "__doc__",
+    "__subclasshook__", "__orig_class__", "__init__", "__new__",
+    "__protocol_attrs__", "__non_callable_proto_members__",
+    "__match_args__",
+}
+
+if sys.version_info >= (3, 9):
+    _EXCLUDED_ATTRS.add("__class_getitem__")
+
+if sys.version_info >= (3, 12):
+    _EXCLUDED_ATTRS.add("__type_params__")
+
+_EXCLUDED_ATTRS = frozenset(_EXCLUDED_ATTRS)
 
 
 def _get_protocol_attrs(cls):
     attrs = set()
     for base in cls.__mro__[:-1]:  # without object
-        if base.__name__ in ('Protocol', 'Generic'):
+        if base.__name__ in {'Protocol', 'Generic'}:
             continue
         annotations = getattr(base, '__annotations__', {})
-        for attr in list(base.__dict__.keys()) + list(annotations.keys()):
-            if (not attr.startswith('_abc_') and attr not in (
-                    '__abstractmethods__', '__annotations__', '__weakref__',
-                    '_is_protocol', '_is_runtime_protocol', '__dict__',
-                    '__args__', '__slots__',
-                    '__next_in_mro__', '__parameters__', '__origin__',
-                    '__orig_bases__', '__extra__', '__tree_hash__',
-                    '__doc__', '__subclasshook__', '__init__', '__new__',
-                    '__module__', '_MutableMapping__marker', '_gorg')):
+        for attr in (*base.__dict__, *annotations):
+            if (not attr.startswith('_abc_') and attr not in _EXCLUDED_ATTRS):
                 attrs.add(attr)
     return attrs
 
 
-def _is_callable_members_only(cls):
-    return all(callable(getattr(cls, attr, None)) for attr in _get_protocol_attrs(cls))
+def _caller(depth=2):
+    try:
+        return sys._getframe(depth).f_globals.get('__name__', '__main__')
+    except (AttributeError, ValueError):  # For platforms without _getframe()
+        return None
 
 
-def _maybe_adjust_parameters(cls):
-    """Helper function used in Protocol.__init_subclass__ and _TypedDictMeta.__new__.
-
-    The contents of this function are very similar
-    to logic found in typing.Generic.__init_subclass__
-    on the CPython main branch.
-    """
-    tvars = []
-    if '__orig_bases__' in cls.__dict__:
-        tvars = typing._collect_type_vars(cls.__orig_bases__)
-        # Look for Generic[T1, ..., Tn] or Protocol[T1, ..., Tn].
-        # If found, tvars must be a subset of it.
-        # If not found, tvars is it.
-        # Also check for and reject plain Generic,
-        # and reject multiple Generic[...] and/or Protocol[...].
-        gvars = None
-        for base in cls.__orig_bases__:
-            if (isinstance(base, typing._GenericAlias) and
-                    base.__origin__ in (typing.Generic, Protocol)):
-                # for error messages
-                the_base = base.__origin__.__name__
-                if gvars is not None:
-                    raise TypeError(
-                        "Cannot inherit from Generic[...]"
-                        " and/or Protocol[...] multiple types.")
-                gvars = base.__parameters__
-        if gvars is None:
-            gvars = tvars
-        else:
-            tvarset = set(tvars)
-            gvarset = set(gvars)
-            if not tvarset <= gvarset:
-                s_vars = ', '.join(str(t) for t in tvars if t not in gvarset)
-                s_args = ', '.join(str(g) for g in gvars)
-                raise TypeError(f"Some type variables ({s_vars}) are"
-                                f" not listed in {the_base}[{s_args}]")
-            tvars = gvars
-    cls.__parameters__ = tuple(tvars)
-
-
-# 3.8+
-if hasattr(typing, 'Protocol'):
+# `__match_args__` attribute was removed from protocol members in 3.13,
+# we want to backport this change to older Python versions.
+if sys.version_info >= (3, 13):
     Protocol = typing.Protocol
-# 3.7
 else:
+    def _allow_reckless_class_checks(depth=3):
+        """Allow instance and class checks for special stdlib modules.
+        The abc and functools modules indiscriminately call isinstance() and
+        issubclass() on the whole MRO of a user class, which may contain protocols.
+        """
+        return _caller(depth) in {'abc', 'functools', None}
 
     def _no_init(self, *args, **kwargs):
         if type(self)._is_protocol:
             raise TypeError('Protocols cannot be instantiated')
 
-    class _ProtocolMeta(abc.ABCMeta):  # noqa: B024
-        # This metaclass is a bit unfortunate and exists only because of the lack
-        # of __instancehook__.
+    def _type_check_issubclass_arg_1(arg):
+        """Raise TypeError if `arg` is not an instance of `type`
+        in `issubclass(arg, <protocol>)`.
+
+        In most cases, this is verified by type.__subclasscheck__.
+        Checking it again unnecessarily would slow down issubclass() checks,
+        so, we don't perform this check unless we absolutely have to.
+
+        For various error paths, however,
+        we want to ensure that *this* error message is shown to the user
+        where relevant, rather than a typing.py-specific error message.
+        """
+        if not isinstance(arg, type):
+            # Same error message as for issubclass(1, int).
+            raise TypeError('issubclass() arg 1 must be a class')
+
+    # Inheriting from typing._ProtocolMeta isn't actually desirable,
+    # but is necessary to allow typing.Protocol and typing_extensions.Protocol
+    # to mix without getting TypeErrors about "metaclass conflict"
+    class _ProtocolMeta(type(typing.Protocol)):
+        # This metaclass is somewhat unfortunate,
+        # but is necessary for several reasons...
+        #
+        # NOTE: DO NOT call super() in any methods in this class
+        # That would call the methods on typing._ProtocolMeta on Python 3.8-3.11
+        # and those are slow
+        def __new__(mcls, name, bases, namespace, **kwargs):
+            if name == "Protocol" and len(bases) < 2:
+                pass
+            elif {Protocol, typing.Protocol} & set(bases):
+                for base in bases:
+                    if not (
+                        base in {object, typing.Generic, Protocol, typing.Protocol}
+                        or base.__name__ in _PROTO_ALLOWLIST.get(base.__module__, [])
+                        or is_protocol(base)
+                    ):
+                        raise TypeError(
+                            f"Protocols can only inherit from other protocols, "
+                            f"got {base!r}"
+                        )
+            return abc.ABCMeta.__new__(mcls, name, bases, namespace, **kwargs)
+
+        def __init__(cls, *args, **kwargs):
+            abc.ABCMeta.__init__(cls, *args, **kwargs)
+            if getattr(cls, "_is_protocol", False):
+                cls.__protocol_attrs__ = _get_protocol_attrs(cls)
+
+        def __subclasscheck__(cls, other):
+            if cls is Protocol:
+                return type.__subclasscheck__(cls, other)
+            if (
+                getattr(cls, '_is_protocol', False)
+                and not _allow_reckless_class_checks()
+            ):
+                if not getattr(cls, '_is_runtime_protocol', False):
+                    _type_check_issubclass_arg_1(other)
+                    raise TypeError(
+                        "Instance and class checks can only be used with "
+                        "@runtime_checkable protocols"
+                    )
+                if (
+                    # this attribute is set by @runtime_checkable:
+                    cls.__non_callable_proto_members__
+                    and cls.__dict__.get("__subclasshook__") is _proto_hook
+                ):
+                    _type_check_issubclass_arg_1(other)
+                    non_method_attrs = sorted(cls.__non_callable_proto_members__)
+                    raise TypeError(
+                        "Protocols with non-method members don't support issubclass()."
+                        f" Non-method members: {str(non_method_attrs)[1:-1]}."
+                    )
+            return abc.ABCMeta.__subclasscheck__(cls, other)
+
         def __instancecheck__(cls, instance):
             # We need this method for situations where attributes are
             # assigned in __init__.
-            if ((not getattr(cls, '_is_protocol', False) or
-                 _is_callable_members_only(cls)) and
-                    issubclass(instance.__class__, cls)):
+            if cls is Protocol:
+                return type.__instancecheck__(cls, instance)
+            if not getattr(cls, "_is_protocol", False):
+                # i.e., it's a concrete subclass of a protocol
+                return abc.ABCMeta.__instancecheck__(cls, instance)
+
+            if (
+                not getattr(cls, '_is_runtime_protocol', False) and
+                not _allow_reckless_class_checks()
+            ):
+                raise TypeError("Instance and class checks can only be used with"
+                                " @runtime_checkable protocols")
+
+            if abc.ABCMeta.__instancecheck__(cls, instance):
                 return True
-            if cls._is_protocol:
-                if all(hasattr(instance, attr) and
-                       (not callable(getattr(cls, attr, None)) or
-                        getattr(instance, attr) is not None)
-                       for attr in _get_protocol_attrs(cls)):
-                    return True
-            return super().__instancecheck__(instance)
 
-    class Protocol(metaclass=_ProtocolMeta):
-        # There is quite a lot of overlapping code with typing.Generic.
-        # Unfortunately it is hard to avoid this while these live in two different
-        # modules. The duplicated code will be removed when Protocol is moved to typing.
-        """Base class for protocol classes. Protocol classes are defined as::
+            for attr in cls.__protocol_attrs__:
+                try:
+                    val = inspect.getattr_static(instance, attr)
+                except AttributeError:
+                    break
+                # this attribute is set by @runtime_checkable:
+                if val is None and attr not in cls.__non_callable_proto_members__:
+                    break
+            else:
+                return True
 
-            class Proto(Protocol):
-                def meth(self) -> int:
-                    ...
+            return False
 
-        Such classes are primarily used with static type checkers that recognize
-        structural subtyping (static duck-typing), for example::
+        def __eq__(cls, other):
+            # Hack so that typing.Generic.__class_getitem__
+            # treats typing_extensions.Protocol
+            # as equivalent to typing.Protocol
+            if abc.ABCMeta.__eq__(cls, other) is True:
+                return True
+            return cls is Protocol and other is typing.Protocol
 
-            class C:
-                def meth(self) -> int:
-                    return 0
+        # This has to be defined, or the abc-module cache
+        # complains about classes with this metaclass being unhashable,
+        # if we define only __eq__!
+        def __hash__(cls) -> int:
+            return type.__hash__(cls)
 
-            def func(x: Proto) -> int:
-                return x.meth()
+    @classmethod
+    def _proto_hook(cls, other):
+        if not cls.__dict__.get('_is_protocol', False):
+            return NotImplemented
 
-            func(C())  # Passes static type check
+        for attr in cls.__protocol_attrs__:
+            for base in other.__mro__:
+                # Check if the members appears in the class dictionary...
+                if attr in base.__dict__:
+                    if base.__dict__[attr] is None:
+                        return NotImplemented
+                    break
 
-        See PEP 544 for details. Protocol classes decorated with
-        @typing_extensions.runtime act as simple-minded runtime protocol that checks
-        only the presence of given attributes, ignoring their type signatures.
+                # ...or in annotations, if it is a sub-protocol.
+                annotations = getattr(base, '__annotations__', {})
+                if (
+                    isinstance(annotations, collections.abc.Mapping)
+                    and attr in annotations
+                    and is_protocol(other)
+                ):
+                    break
+            else:
+                return NotImplemented
+        return True
 
-        Protocol classes can be generic, they are defined as::
-
-            class GenProto(Protocol[T]):
-                def meth(self) -> T:
-                    ...
-        """
+    class Protocol(typing.Generic, metaclass=_ProtocolMeta):
+        __doc__ = typing.Protocol.__doc__
         __slots__ = ()
         _is_protocol = True
-
-        def __new__(cls, *args, **kwds):
-            if cls is Protocol:
-                raise TypeError("Type Protocol cannot be instantiated; "
-                                "it can only be used as a base class")
-            return super().__new__(cls)
-
-        @typing._tp_cache
-        def __class_getitem__(cls, params):
-            if not isinstance(params, tuple):
-                params = (params,)
-            if not params and cls is not typing.Tuple:
-                raise TypeError(
-                    f"Parameter list to {cls.__qualname__}[...] cannot be empty")
-            msg = "Parameters to generic types must be types."
-            params = tuple(typing._type_check(p, msg) for p in params)  # noqa
-            if cls is Protocol:
-                # Generic can only be subscripted with unique type variables.
-                if not all(isinstance(p, typing.TypeVar) for p in params):
-                    i = 0
-                    while isinstance(params[i], typing.TypeVar):
-                        i += 1
-                    raise TypeError(
-                        "Parameters to Protocol[...] must all be type variables."
-                        f" Parameter {i + 1} is {params[i]}")
-                if len(set(params)) != len(params):
-                    raise TypeError(
-                        "Parameters to Protocol[...] must all be unique")
-            else:
-                # Subscripting a regular Generic subclass.
-                _check_generic(cls, params, len(cls.__parameters__))
-            return typing._GenericAlias(cls, params)
+        _is_runtime_protocol = False
 
         def __init_subclass__(cls, *args, **kwargs):
-            if '__orig_bases__' in cls.__dict__:
-                error = typing.Generic in cls.__orig_bases__
-            else:
-                error = typing.Generic in cls.__bases__
-            if error:
-                raise TypeError("Cannot inherit from plain Generic")
-            _maybe_adjust_parameters(cls)
+            super().__init_subclass__(*args, **kwargs)
 
             # Determine if this is a protocol or a concrete subclass.
-            if not cls.__dict__.get('_is_protocol', None):
+            if not cls.__dict__.get('_is_protocol', False):
                 cls._is_protocol = any(b is Protocol for b in cls.__bases__)
 
             # Set (or override) the protocol subclass hook.
-            def _proto_hook(other):
-                if not cls.__dict__.get('_is_protocol', None):
-                    return NotImplemented
-                if not getattr(cls, '_is_runtime_protocol', False):
-                    if sys._getframe(2).f_globals['__name__'] in ['abc', 'functools']:
-                        return NotImplemented
-                    raise TypeError("Instance and class checks can only be used with"
-                                    " @runtime protocols")
-                if not _is_callable_members_only(cls):
-                    if sys._getframe(2).f_globals['__name__'] in ['abc', 'functools']:
-                        return NotImplemented
-                    raise TypeError("Protocols with non-method members"
-                                    " don't support issubclass()")
-                if not isinstance(other, type):
-                    # Same error as for issubclass(1, int)
-                    raise TypeError('issubclass() arg 1 must be a class')
-                for attr in _get_protocol_attrs(cls):
-                    for base in other.__mro__:
-                        if attr in base.__dict__:
-                            if base.__dict__[attr] is None:
-                                return NotImplemented
-                            break
-                        annotations = getattr(base, '__annotations__', {})
-                        if (isinstance(annotations, typing.Mapping) and
-                                attr in annotations and
-                                isinstance(other, _ProtocolMeta) and
-                                other._is_protocol):
-                            break
-                    else:
-                        return NotImplemented
-                return True
             if '__subclasshook__' not in cls.__dict__:
                 cls.__subclasshook__ = _proto_hook
 
-            # We have nothing more to do for non-protocols.
-            if not cls._is_protocol:
-                return
-
-            # Check consistency of bases.
-            for base in cls.__bases__:
-                if not (base in (object, typing.Generic) or
-                        base.__module__ == 'collections.abc' and
-                        base.__name__ in _PROTO_WHITELIST or
-                        isinstance(base, _ProtocolMeta) and base._is_protocol):
-                    raise TypeError('Protocols can only inherit from other'
-                                    f' protocols, got {repr(base)}')
-            cls.__init__ = _no_init
+            # Prohibit instantiation for protocol classes
+            if cls._is_protocol and cls.__init__ is Protocol.__init__:
+                cls.__init__ = _no_init
 
 
-# 3.8+
-if hasattr(typing, 'runtime_checkable'):
+if sys.version_info >= (3, 13):
     runtime_checkable = typing.runtime_checkable
-# 3.7
 else:
     def runtime_checkable(cls):
-        """Mark a protocol class as a runtime protocol, so that it
-        can be used with isinstance() and issubclass(). Raise TypeError
-        if applied to a non-protocol class.
+        """Mark a protocol class as a runtime protocol.
 
-        This allows a simple-minded structural check very similar to the
-        one-offs in collections.abc such as Hashable.
+        Such protocol can be used with isinstance() and issubclass().
+        Raise TypeError if applied to a non-protocol class.
+        This allows a simple-minded structural check very similar to
+        one trick ponies in collections.abc such as Iterable.
+
+        For example::
+
+            @runtime_checkable
+            class Closable(Protocol):
+                def close(self): ...
+
+            assert isinstance(open('/some/file'), Closable)
+
+        Warning: this will check only the presence of the required methods,
+        not their type signatures!
         """
-        if not isinstance(cls, _ProtocolMeta) or not cls._is_protocol:
+        if not issubclass(cls, typing.Generic) or not getattr(cls, '_is_protocol', False):
             raise TypeError('@runtime_checkable can be only applied to protocol classes,'
-                            f' got {cls!r}')
+                            ' got %r' % cls)
         cls._is_runtime_protocol = True
+
+        # Only execute the following block if it's a typing_extensions.Protocol class.
+        # typing.Protocol classes don't need it.
+        if isinstance(cls, _ProtocolMeta):
+            # PEP 544 prohibits using issubclass()
+            # with protocols that have non-method members.
+            # See gh-113320 for why we compute this attribute here,
+            # rather than in `_ProtocolMeta.__init__`
+            cls.__non_callable_proto_members__ = set()
+            for attr in cls.__protocol_attrs__:
+                try:
+                    is_callable = callable(getattr(cls, attr, None))
+                except Exception as e:
+                    raise TypeError(
+                        f"Failed to determine whether protocol member {attr!r} "
+                        "is a method member"
+                    ) from e
+                else:
+                    if not is_callable:
+                        cls.__non_callable_proto_members__.add(attr)
+
         return cls
 
 
-# Exists for backwards compatibility.
+# The "runtime" alias exists for backwards compatibility.
 runtime = runtime_checkable
 
 
-# 3.8+
-if hasattr(typing, 'SupportsIndex'):
+# Our version of runtime-checkable protocols is faster on Python 3.8-3.11
+if sys.version_info >= (3, 12):
+    SupportsInt = typing.SupportsInt
+    SupportsFloat = typing.SupportsFloat
+    SupportsComplex = typing.SupportsComplex
+    SupportsBytes = typing.SupportsBytes
     SupportsIndex = typing.SupportsIndex
-# 3.7
+    SupportsAbs = typing.SupportsAbs
+    SupportsRound = typing.SupportsRound
 else:
+    @runtime_checkable
+    class SupportsInt(Protocol):
+        """An ABC with one abstract method __int__."""
+        __slots__ = ()
+
+        @abc.abstractmethod
+        def __int__(self) -> int:
+            pass
+
+    @runtime_checkable
+    class SupportsFloat(Protocol):
+        """An ABC with one abstract method __float__."""
+        __slots__ = ()
+
+        @abc.abstractmethod
+        def __float__(self) -> float:
+            pass
+
+    @runtime_checkable
+    class SupportsComplex(Protocol):
+        """An ABC with one abstract method __complex__."""
+        __slots__ = ()
+
+        @abc.abstractmethod
+        def __complex__(self) -> complex:
+            pass
+
+    @runtime_checkable
+    class SupportsBytes(Protocol):
+        """An ABC with one abstract method __bytes__."""
+        __slots__ = ()
+
+        @abc.abstractmethod
+        def __bytes__(self) -> bytes:
+            pass
+
     @runtime_checkable
     class SupportsIndex(Protocol):
         __slots__ = ()
@@ -649,8 +796,45 @@ else:
         def __index__(self) -> int:
             pass
 
+    @runtime_checkable
+    class SupportsAbs(Protocol[T_co]):
+        """
+        An ABC with one abstract method __abs__ that is covariant in its return type.
+        """
+        __slots__ = ()
 
-if hasattr(typing, "Required"):
+        @abc.abstractmethod
+        def __abs__(self) -> T_co:
+            pass
+
+    @runtime_checkable
+    class SupportsRound(Protocol[T_co]):
+        """
+        An ABC with one abstract method __round__ that is covariant in its return type.
+        """
+        __slots__ = ()
+
+        @abc.abstractmethod
+        def __round__(self, ndigits: int = 0) -> T_co:
+            pass
+
+
+def _ensure_subclassable(mro_entries):
+    def inner(func):
+        if sys.implementation.name == "pypy" and sys.version_info < (3, 9):
+            cls_dict = {
+                "__call__": staticmethod(func),
+                "__mro_entries__": staticmethod(mro_entries)
+            }
+            t = type(func.__name__, (), cls_dict)
+            return functools.update_wrapper(t(), func)
+        else:
+            func.__mro_entries__ = mro_entries
+            return func
+    return inner
+
+
+if hasattr(typing, "ReadOnly"):
     # The standard library TypedDict in Python 3.8 does not store runtime information
     # about which (if any) keys are optional.  See https://bugs.python.org/issue38834
     # The standard library TypedDict in Python 3.9.0/1 does not honour the "total"
@@ -658,148 +842,164 @@ if hasattr(typing, "Required"):
     # The standard library TypedDict below Python 3.11 does not store runtime
     # information about optional and required keys when using Required or NotRequired.
     # Generic TypedDicts are also impossible using typing.TypedDict on Python <3.11.
+    # Aaaand on 3.12 we add __orig_bases__ to TypedDict
+    # to enable better runtime introspection.
+    # On 3.13 we deprecate some odd ways of creating TypedDicts.
+    # PEP 705 proposes adding the ReadOnly[] qualifier.
     TypedDict = typing.TypedDict
     _TypedDictMeta = typing._TypedDictMeta
     is_typeddict = typing.is_typeddict
 else:
-    def _check_fails(cls, other):
-        try:
-            if sys._getframe(1).f_globals['__name__'] not in ['abc',
-                                                              'functools',
-                                                              'typing']:
-                # Typed dicts are only for static structural subtyping.
-                raise TypeError('TypedDict does not support instance and class checks')
-        except (AttributeError, ValueError):
-            pass
-        return False
+    # 3.10.0 and later
+    _TAKES_MODULE = "module" in inspect.signature(typing._type_check).parameters
 
-    def _dict_new(*args, **kwargs):
-        if not args:
-            raise TypeError('TypedDict.__new__(): not enough arguments')
-        _, args = args[0], args[1:]  # allow the "cls" keyword be passed
-        return dict(*args, **kwargs)
-
-    _dict_new.__text_signature__ = '($cls, _typename, _fields=None, /, **kwargs)'
-
-    def _typeddict_new(*args, total=True, **kwargs):
-        if not args:
-            raise TypeError('TypedDict.__new__(): not enough arguments')
-        _, args = args[0], args[1:]  # allow the "cls" keyword be passed
-        if args:
-            typename, args = args[0], args[1:]  # allow the "_typename" keyword be passed
-        elif '_typename' in kwargs:
-            typename = kwargs.pop('_typename')
-            import warnings
-            warnings.warn("Passing '_typename' as keyword argument is deprecated",
-                          DeprecationWarning, stacklevel=2)
-        else:
-            raise TypeError("TypedDict.__new__() missing 1 required positional "
-                            "argument: '_typename'")
-        if args:
-            try:
-                fields, = args  # allow the "_fields" keyword be passed
-            except ValueError:
-                raise TypeError('TypedDict.__new__() takes from 2 to 3 '
-                                f'positional arguments but {len(args) + 2} '
-                                'were given')
-        elif '_fields' in kwargs and len(kwargs) == 1:
-            fields = kwargs.pop('_fields')
-            import warnings
-            warnings.warn("Passing '_fields' as keyword argument is deprecated",
-                          DeprecationWarning, stacklevel=2)
-        else:
-            fields = None
-
-        if fields is None:
-            fields = kwargs
-        elif kwargs:
-            raise TypeError("TypedDict takes either a dict or keyword arguments,"
-                            " but not both")
-
-        ns = {'__annotations__': dict(fields)}
-        try:
-            # Setting correct module is necessary to make typed dict classes pickleable.
-            ns['__module__'] = sys._getframe(1).f_globals.get('__name__', '__main__')
-        except (AttributeError, ValueError):
-            pass
-
-        return _TypedDictMeta(typename, (), ns, total=total)
-
-    _typeddict_new.__text_signature__ = ('($cls, _typename, _fields=None,'
-                                         ' /, *, total=True, **kwargs)')
+    def _get_typeddict_qualifiers(annotation_type):
+        while True:
+            annotation_origin = get_origin(annotation_type)
+            if annotation_origin is Annotated:
+                annotation_args = get_args(annotation_type)
+                if annotation_args:
+                    annotation_type = annotation_args[0]
+                else:
+                    break
+            elif annotation_origin is Required:
+                yield Required
+                annotation_type, = get_args(annotation_type)
+            elif annotation_origin is NotRequired:
+                yield NotRequired
+                annotation_type, = get_args(annotation_type)
+            elif annotation_origin is ReadOnly:
+                yield ReadOnly
+                annotation_type, = get_args(annotation_type)
+            else:
+                break
 
     class _TypedDictMeta(type):
-        def __init__(cls, name, bases, ns, total=True):
-            super().__init__(name, bases, ns)
+        def __new__(cls, name, bases, ns, *, total=True, closed=False):
+            """Create new typed dict class object.
 
-        def __new__(cls, name, bases, ns, total=True):
-            # Create new typed dict class object.
-            # This method is called directly when TypedDict is subclassed,
-            # or via _typeddict_new when TypedDict is instantiated. This way
-            # TypedDict supports all three syntaxes described in its docstring.
-            # Subclasses and instances of TypedDict return actual dictionaries
-            # via _dict_new.
-            ns['__new__'] = _typeddict_new if name == 'TypedDict' else _dict_new
-            # Don't insert typing.Generic into __bases__ here,
-            # or Generic.__init_subclass__ will raise TypeError
-            # in the super().__new__() call.
-            # Instead, monkey-patch __bases__ onto the class after it's been created.
-            tp_dict = super().__new__(cls, name, (dict,), ns)
+            This method is called when TypedDict is subclassed,
+            or when TypedDict is instantiated. This way
+            TypedDict supports all three syntax forms described in its docstring.
+            Subclasses and instances of TypedDict return actual dictionaries.
+            """
+            for base in bases:
+                if type(base) is not _TypedDictMeta and base is not typing.Generic:
+                    raise TypeError('cannot inherit from both a TypedDict type '
+                                    'and a non-TypedDict base class')
 
-            if any(issubclass(base, typing.Generic) for base in bases):
-                tp_dict.__bases__ = (typing.Generic, dict)
-                _maybe_adjust_parameters(tp_dict)
+            if any(issubclass(b, typing.Generic) for b in bases):
+                generic_base = (typing.Generic,)
+            else:
+                generic_base = ()
+
+            # typing.py generally doesn't let you inherit from plain Generic, unless
+            # the name of the class happens to be "Protocol"
+            tp_dict = type.__new__(_TypedDictMeta, "Protocol", (*generic_base, dict), ns)
+            tp_dict.__name__ = name
+            if tp_dict.__qualname__ == "Protocol":
+                tp_dict.__qualname__ = name
+
+            if not hasattr(tp_dict, '__orig_bases__'):
+                tp_dict.__orig_bases__ = bases
 
             annotations = {}
             own_annotations = ns.get('__annotations__', {})
             msg = "TypedDict('Name', {f0: t0, f1: t1, ...}); each t must be a type"
-            own_annotations = {
-                n: typing._type_check(tp, msg) for n, tp in own_annotations.items()
-            }
+            if _TAKES_MODULE:
+                own_annotations = {
+                    n: typing._type_check(tp, msg, module=tp_dict.__module__)
+                    for n, tp in own_annotations.items()
+                }
+            else:
+                own_annotations = {
+                    n: typing._type_check(tp, msg)
+                    for n, tp in own_annotations.items()
+                }
             required_keys = set()
             optional_keys = set()
+            readonly_keys = set()
+            mutable_keys = set()
+            extra_items_type = None
 
             for base in bases:
-                annotations.update(base.__dict__.get('__annotations__', {}))
-                required_keys.update(base.__dict__.get('__required_keys__', ()))
-                optional_keys.update(base.__dict__.get('__optional_keys__', ()))
+                base_dict = base.__dict__
+
+                annotations.update(base_dict.get('__annotations__', {}))
+                required_keys.update(base_dict.get('__required_keys__', ()))
+                optional_keys.update(base_dict.get('__optional_keys__', ()))
+                readonly_keys.update(base_dict.get('__readonly_keys__', ()))
+                mutable_keys.update(base_dict.get('__mutable_keys__', ()))
+                base_extra_items_type = base_dict.get('__extra_items__', None)
+                if base_extra_items_type is not None:
+                    extra_items_type = base_extra_items_type
+
+            if closed and extra_items_type is None:
+                extra_items_type = Never
+            if closed and "__extra_items__" in own_annotations:
+                annotation_type = own_annotations.pop("__extra_items__")
+                qualifiers = set(_get_typeddict_qualifiers(annotation_type))
+                if Required in qualifiers:
+                    raise TypeError(
+                        "Special key __extra_items__ does not support "
+                        "Required"
+                    )
+                if NotRequired in qualifiers:
+                    raise TypeError(
+                        "Special key __extra_items__ does not support "
+                        "NotRequired"
+                    )
+                extra_items_type = annotation_type
 
             annotations.update(own_annotations)
             for annotation_key, annotation_type in own_annotations.items():
-                annotation_origin = get_origin(annotation_type)
-                if annotation_origin is Annotated:
-                    annotation_args = get_args(annotation_type)
-                    if annotation_args:
-                        annotation_type = annotation_args[0]
-                        annotation_origin = get_origin(annotation_type)
+                qualifiers = set(_get_typeddict_qualifiers(annotation_type))
 
-                if annotation_origin is Required:
+                if Required in qualifiers:
                     required_keys.add(annotation_key)
-                elif annotation_origin is NotRequired:
+                elif NotRequired in qualifiers:
                     optional_keys.add(annotation_key)
                 elif total:
                     required_keys.add(annotation_key)
                 else:
                     optional_keys.add(annotation_key)
+                if ReadOnly in qualifiers:
+                    mutable_keys.discard(annotation_key)
+                    readonly_keys.add(annotation_key)
+                else:
+                    mutable_keys.add(annotation_key)
+                    readonly_keys.discard(annotation_key)
 
             tp_dict.__annotations__ = annotations
             tp_dict.__required_keys__ = frozenset(required_keys)
             tp_dict.__optional_keys__ = frozenset(optional_keys)
+            tp_dict.__readonly_keys__ = frozenset(readonly_keys)
+            tp_dict.__mutable_keys__ = frozenset(mutable_keys)
             if not hasattr(tp_dict, '__total__'):
                 tp_dict.__total__ = total
+            tp_dict.__closed__ = closed
+            tp_dict.__extra_items__ = extra_items_type
             return tp_dict
 
-        __instancecheck__ = __subclasscheck__ = _check_fails
+        __call__ = dict  # static method
 
-    TypedDict = _TypedDictMeta('TypedDict', (dict,), {})
-    TypedDict.__module__ = __name__
-    TypedDict.__doc__ = \
-        """A simple typed name space. At runtime it is equivalent to a plain dict.
+        def __subclasscheck__(cls, other):
+            # Typed dicts are only for static structural subtyping.
+            raise TypeError('TypedDict does not support instance and class checks')
 
-        TypedDict creates a dictionary type that expects all of its
-        instances to have a certain set of keys, with each key
+        __instancecheck__ = __subclasscheck__
+
+    _TypedDict = type.__new__(_TypedDictMeta, 'TypedDict', (), {})
+
+    @_ensure_subclassable(lambda bases: (_TypedDict,))
+    def TypedDict(typename, fields=_marker, /, *, total=True, closed=False, **kwargs):
+        """A simple typed namespace. At runtime it is equivalent to a plain dict.
+
+        TypedDict creates a dictionary type such that a type checker will expect all
+        instances to have a certain set of keys, where each key is
         associated with a value of a consistent type. This expectation
-        is not checked at runtime but is only enforced by type checkers.
+        is not checked at runtime.
+
         Usage::
 
             class Point2D(TypedDict):
@@ -814,14 +1014,71 @@ else:
 
         The type info can be accessed via the Point2D.__annotations__ dict, and
         the Point2D.__required_keys__ and Point2D.__optional_keys__ frozensets.
-        TypedDict supports two additional equivalent forms::
+        TypedDict supports an additional equivalent form::
 
-            Point2D = TypedDict('Point2D', x=int, y=int, label=str)
             Point2D = TypedDict('Point2D', {'x': int, 'y': int, 'label': str})
 
-        The class syntax is only supported in Python 3.6+, while two other
-        syntax forms work for Python 2.7 and 3.2+
+        By default, all keys must be present in a TypedDict. It is possible
+        to override this by specifying totality::
+
+            class Point2D(TypedDict, total=False):
+                x: int
+                y: int
+
+        This means that a Point2D TypedDict can have any of the keys omitted. A type
+        checker is only expected to support a literal False or True as the value of
+        the total argument. True is the default, and makes all items defined in the
+        class body be required.
+
+        The Required and NotRequired special forms can also be used to mark
+        individual keys as being required or not required::
+
+            class Point2D(TypedDict):
+                x: int  # the "x" key must always be present (Required is the default)
+                y: NotRequired[int]  # the "y" key can be omitted
+
+        See PEP 655 for more details on Required and NotRequired.
         """
+        if fields is _marker or fields is None:
+            if fields is _marker:
+                deprecated_thing = "Failing to pass a value for the 'fields' parameter"
+            else:
+                deprecated_thing = "Passing `None` as the 'fields' parameter"
+
+            example = f"`{typename} = TypedDict({typename!r}, {{}})`"
+            deprecation_msg = (
+                f"{deprecated_thing} is deprecated and will be disallowed in "
+                "Python 3.15. To create a TypedDict class with 0 fields "
+                "using the functional syntax, pass an empty dictionary, e.g. "
+            ) + example + "."
+            warnings.warn(deprecation_msg, DeprecationWarning, stacklevel=2)
+            if closed is not False and closed is not True:
+                kwargs["closed"] = closed
+                closed = False
+            fields = kwargs
+        elif kwargs:
+            raise TypeError("TypedDict takes either a dict or keyword arguments,"
+                            " but not both")
+        if kwargs:
+            if sys.version_info >= (3, 13):
+                raise TypeError("TypedDict takes no keyword arguments")
+            warnings.warn(
+                "The kwargs-based syntax for TypedDict definitions is deprecated "
+                "in Python 3.11, will be removed in Python 3.13, and may not be "
+                "understood by third-party type checkers.",
+                DeprecationWarning,
+                stacklevel=2,
+            )
+
+        ns = {'__annotations__': dict(fields)}
+        module = _caller()
+        if module is not None:
+            # Setting correct module is necessary to make typed dict classes pickleable.
+            ns['__module__'] = module
+
+        td = _TypedDictMeta(typename, (), ns, total=total, closed=closed)
+        td.__orig_bases__ = (TypedDict,)
+        return td
 
     if hasattr(typing, "_TypedDictMeta"):
         _TYPEDDICT_TYPES = (typing._TypedDictMeta, _TypedDictMeta)
@@ -839,14 +1096,17 @@ else:
             is_typeddict(Film)  # => True
             is_typeddict(Union[list, str])  # => False
         """
-        return isinstance(tp, tuple(_TYPEDDICT_TYPES))
+        # On 3.8, this would otherwise return True
+        if hasattr(typing, "TypedDict") and tp is typing.TypedDict:
+            return False
+        return isinstance(tp, _TYPEDDICT_TYPES)
 
 
 if hasattr(typing, "assert_type"):
     assert_type = typing.assert_type
 
 else:
-    def assert_type(__val, __typ):
+    def assert_type(val, typ, /):
         """Assert (to the type checker) that the value is of the given type.
 
         When the type checker encounters a call to assert_type(), it
@@ -859,15 +1119,12 @@ else:
         At runtime this returns the first argument unchanged and otherwise
         does nothing.
         """
-        return __val
+        return val
 
 
-if hasattr(typing, "Required"):
+if hasattr(typing, "Required"):  # 3.11+
     get_type_hints = typing.get_type_hints
-else:
-    import functools
-    import types
-
+else:  # <=3.10
     # replaces _strip_annotations()
     def _strip_extras(t):
         """Strips Annotated, Required and NotRequired from a given type."""
@@ -880,12 +1137,12 @@ else:
             if stripped_args == t.__args__:
                 return t
             return t.copy_with(stripped_args)
-        if hasattr(types, "GenericAlias") and isinstance(t, types.GenericAlias):
+        if hasattr(_types, "GenericAlias") and isinstance(t, _types.GenericAlias):
             stripped_args = tuple(_strip_extras(a) for a in t.__args__)
             if stripped_args == t.__args__:
                 return t
-            return types.GenericAlias(t.__origin__, stripped_args)
-        if hasattr(types, "UnionType") and isinstance(t, types.UnionType):
+            return _types.GenericAlias(t.__origin__, stripped_args)
+        if hasattr(_types, "UnionType") and isinstance(t, _types.UnionType):
             stripped_args = tuple(_strip_extras(a) for a in t.__args__)
             if stripped_args == t.__args__:
                 return t
@@ -925,11 +1182,11 @@ else:
         - If two dict arguments are passed, they specify globals and
           locals, respectively.
         """
-        if hasattr(typing, "Annotated"):
+        if hasattr(typing, "Annotated"):  # 3.9+
             hint = typing.get_type_hints(
                 obj, globalns=globalns, localns=localns, include_extras=True
             )
-        else:
+        else:  # 3.8
             hint = typing.get_type_hints(obj, globalns=globalns, localns=localns)
         if include_extras:
             return hint
@@ -942,7 +1199,7 @@ if hasattr(typing, 'Annotated'):
     # Not exported and not a public API, but needed for get_origin() and get_args()
     # to work.
     _AnnotatedAlias = typing._AnnotatedAlias
-# 3.7-3.8
+# 3.8
 else:
     class _AnnotatedAlias(typing._GenericAlias, _root=True):
         """Runtime representation of an annotated type.
@@ -1047,7 +1304,7 @@ else:
 if sys.version_info[:2] >= (3, 10):
     get_origin = typing.get_origin
     get_args = typing.get_args
-# 3.7-3.9
+# 3.8-3.9
 else:
     try:
         # 3.9+
@@ -1112,11 +1369,7 @@ if hasattr(typing, 'TypeAlias'):
     TypeAlias = typing.TypeAlias
 # 3.9
 elif sys.version_info[:2] >= (3, 9):
-    class _TypeAliasForm(typing._SpecialForm, _root=True):
-        def __repr__(self):
-            return 'typing_extensions.' + self._name
-
-    @_TypeAliasForm
+    @_ExtensionsSpecialForm
     def TypeAlias(self, parameters):
         """Special marker indicating that an assignment should
         be recognized as a proper type alias definition by type
@@ -1129,68 +1382,89 @@ elif sys.version_info[:2] >= (3, 9):
         It's invalid when used anywhere except as in the example above.
         """
         raise TypeError(f"{self} is not subscriptable")
-# 3.7-3.8
+# 3.8
 else:
-    class _TypeAliasForm(typing._SpecialForm, _root=True):
-        def __repr__(self):
-            return 'typing_extensions.' + self._name
+    TypeAlias = _ExtensionsSpecialForm(
+        'TypeAlias',
+        doc="""Special marker indicating that an assignment should
+        be recognized as a proper type alias definition by type
+        checkers.
 
-    TypeAlias = _TypeAliasForm('TypeAlias',
-                               doc="""Special marker indicating that an assignment should
-                               be recognized as a proper type alias definition by type
-                               checkers.
+        For example::
 
-                               For example::
+            Predicate: TypeAlias = Callable[..., bool]
 
-                                   Predicate: TypeAlias = Callable[..., bool]
+        It's invalid when used anywhere except as in the example
+        above."""
+    )
 
-                               It's invalid when used anywhere except as in the example
-                               above.""")
+
+def _set_default(type_param, default):
+    if isinstance(default, (tuple, list)):
+        type_param.__default__ = tuple((typing._type_check(d, "Default must be a type")
+                                        for d in default))
+    elif default != _marker:
+        if isinstance(type_param, ParamSpec) and default is ...:  # ... not valid <3.11
+            type_param.__default__ = default
+        else:
+            type_param.__default__ = typing._type_check(default, "Default must be a type")
+    else:
+        type_param.__default__ = None
+
+
+def _set_module(typevarlike):
+    # for pickling:
+    def_mod = _caller(depth=3)
+    if def_mod != 'typing_extensions':
+        typevarlike.__module__ = def_mod
 
 
 class _DefaultMixin:
     """Mixin for TypeVarLike defaults."""
 
     __slots__ = ()
+    __init__ = _set_default
 
-    def __init__(self, default):
-        if isinstance(default, (tuple, list)):
-            self.__default__ = tuple((typing._type_check(d, "Default must be a type")
-                                      for d in default))
-        elif default:
-            self.__default__ = typing._type_check(default, "Default must be a type")
-        else:
-            self.__default__ = None
+
+# Classes using this metaclass must provide a _backported_typevarlike ClassVar
+class _TypeVarLikeMeta(type):
+    def __instancecheck__(cls, __instance: Any) -> bool:
+        return isinstance(__instance, cls._backported_typevarlike)
 
 
 # Add default and infer_variance parameters from PEP 696 and 695
-class TypeVar(typing.TypeVar, _DefaultMixin, _root=True):
+class TypeVar(metaclass=_TypeVarLikeMeta):
     """Type variable."""
 
-    __module__ = 'typing'
+    _backported_typevarlike = typing.TypeVar
 
-    def __init__(self, name, *constraints, bound=None,
-                 covariant=False, contravariant=False,
-                 default=None, infer_variance=False):
-        super().__init__(name, *constraints, bound=bound, covariant=covariant,
-                         contravariant=contravariant)
-        _DefaultMixin.__init__(self, default)
-        self.__infer_variance__ = infer_variance
+    def __new__(cls, name, *constraints, bound=None,
+                covariant=False, contravariant=False,
+                default=_marker, infer_variance=False):
+        if hasattr(typing, "TypeAliasType"):
+            # PEP 695 implemented (3.12+), can pass infer_variance to typing.TypeVar
+            typevar = typing.TypeVar(name, *constraints, bound=bound,
+                                     covariant=covariant, contravariant=contravariant,
+                                     infer_variance=infer_variance)
+        else:
+            typevar = typing.TypeVar(name, *constraints, bound=bound,
+                                     covariant=covariant, contravariant=contravariant)
+            if infer_variance and (covariant or contravariant):
+                raise ValueError("Variance cannot be specified with infer_variance.")
+            typevar.__infer_variance__ = infer_variance
+        _set_default(typevar, default)
+        _set_module(typevar)
+        return typevar
 
-        # for pickling:
-        try:
-            def_mod = sys._getframe(1).f_globals.get('__name__', '__main__')
-        except (AttributeError, ValueError):
-            def_mod = None
-        if def_mod != 'typing_extensions':
-            self.__module__ = def_mod
+    def __init_subclass__(cls) -> None:
+        raise TypeError(f"type '{__name__}.TypeVar' is not an acceptable base type")
 
 
 # Python 3.10+ has PEP 612
 if hasattr(typing, 'ParamSpecArgs'):
     ParamSpecArgs = typing.ParamSpecArgs
     ParamSpecKwargs = typing.ParamSpecKwargs
-# 3.7-3.9
+# 3.8-3.9
 else:
     class _Immutable:
         """Mixin to indicate that object should not be copied."""
@@ -1251,27 +1525,35 @@ else:
 # 3.10+
 if hasattr(typing, 'ParamSpec'):
 
-    # Add default Parameter - PEP 696
-    class ParamSpec(typing.ParamSpec, _DefaultMixin, _root=True):
-        """Parameter specification variable."""
+    # Add default parameter - PEP 696
+    class ParamSpec(metaclass=_TypeVarLikeMeta):
+        """Parameter specification."""
 
-        __module__ = 'typing'
+        _backported_typevarlike = typing.ParamSpec
 
-        def __init__(self, name, *, bound=None, covariant=False, contravariant=False,
-                     default=None):
-            super().__init__(name, bound=bound, covariant=covariant,
-                             contravariant=contravariant)
-            _DefaultMixin.__init__(self, default)
+        def __new__(cls, name, *, bound=None,
+                    covariant=False, contravariant=False,
+                    infer_variance=False, default=_marker):
+            if hasattr(typing, "TypeAliasType"):
+                # PEP 695 implemented, can pass infer_variance to typing.TypeVar
+                paramspec = typing.ParamSpec(name, bound=bound,
+                                             covariant=covariant,
+                                             contravariant=contravariant,
+                                             infer_variance=infer_variance)
+            else:
+                paramspec = typing.ParamSpec(name, bound=bound,
+                                             covariant=covariant,
+                                             contravariant=contravariant)
+                paramspec.__infer_variance__ = infer_variance
 
-            # for pickling:
-            try:
-                def_mod = sys._getframe(1).f_globals.get('__name__', '__main__')
-            except (AttributeError, ValueError):
-                def_mod = None
-            if def_mod != 'typing_extensions':
-                self.__module__ = def_mod
+            _set_default(paramspec, default)
+            _set_module(paramspec)
+            return paramspec
 
-# 3.7-3.9
+        def __init_subclass__(cls) -> None:
+            raise TypeError(f"type '{__name__}.ParamSpec' is not an acceptable base type")
+
+# 3.8-3.9
 else:
 
     # Inherits from list as a workaround for Callable checks in Python < 3.9.2.
@@ -1334,11 +1616,12 @@ else:
             return ParamSpecKwargs(self)
 
         def __init__(self, name, *, bound=None, covariant=False, contravariant=False,
-                     default=None):
+                     infer_variance=False, default=_marker):
             super().__init__([self])
             self.__name__ = name
             self.__covariant__ = bool(covariant)
             self.__contravariant__ = bool(contravariant)
+            self.__infer_variance__ = bool(infer_variance)
             if bound:
                 self.__bound__ = typing._type_check(bound, 'Bound must be a type.')
             else:
@@ -1346,15 +1629,14 @@ else:
             _DefaultMixin.__init__(self, default)
 
             # for pickling:
-            try:
-                def_mod = sys._getframe(1).f_globals.get('__name__', '__main__')
-            except (AttributeError, ValueError):
-                def_mod = None
+            def_mod = _caller()
             if def_mod != 'typing_extensions':
                 self.__module__ = def_mod
 
         def __repr__(self):
-            if self.__covariant__:
+            if self.__infer_variance__:
+                prefix = ''
+            elif self.__covariant__:
                 prefix = '+'
             elif self.__contravariant__:
                 prefix = '-'
@@ -1376,7 +1658,7 @@ else:
             pass
 
 
-# 3.7-3.9
+# 3.8-3.9
 if not hasattr(typing, 'Concatenate'):
     # Inherits from list as a workaround for Callable checks in Python < 3.9.2.
     class _ConcatenateGenericAlias(list):
@@ -1411,7 +1693,7 @@ if not hasattr(typing, 'Concatenate'):
             )
 
 
-# 3.7-3.9
+# 3.8-3.9
 @typing._tp_cache
 def _concatenate_getitem(self, parameters):
     if parameters == ():
@@ -1429,10 +1711,10 @@ def _concatenate_getitem(self, parameters):
 # 3.10+
 if hasattr(typing, 'Concatenate'):
     Concatenate = typing.Concatenate
-    _ConcatenateGenericAlias = typing._ConcatenateGenericAlias # noqa
+    _ConcatenateGenericAlias = typing._ConcatenateGenericAlias  # noqa: F811
 # 3.9
 elif sys.version_info[:2] >= (3, 9):
-    @_TypeAliasForm
+    @_ExtensionsSpecialForm
     def Concatenate(self, parameters):
         """Used in conjunction with ``ParamSpec`` and ``Callable`` to represent a
         higher order function which adds, removes or transforms parameters of a
@@ -1445,12 +1727,9 @@ elif sys.version_info[:2] >= (3, 9):
         See PEP 612 for detailed information.
         """
         return _concatenate_getitem(self, parameters)
-# 3.7-8
+# 3.8
 else:
-    class _ConcatenateForm(typing._SpecialForm, _root=True):
-        def __repr__(self):
-            return 'typing_extensions.' + self._name
-
+    class _ConcatenateForm(_ExtensionsSpecialForm, _root=True):
         def __getitem__(self, parameters):
             return _concatenate_getitem(self, parameters)
 
@@ -1472,11 +1751,7 @@ if hasattr(typing, 'TypeGuard'):
     TypeGuard = typing.TypeGuard
 # 3.9
 elif sys.version_info[:2] >= (3, 9):
-    class _TypeGuardForm(typing._SpecialForm, _root=True):
-        def __repr__(self):
-            return 'typing_extensions.' + self._name
-
-    @_TypeGuardForm
+    @_ExtensionsSpecialForm
     def TypeGuard(self, parameters):
         """Special typing form used to annotate the return type of a user-defined
         type guard function.  ``TypeGuard`` only accepts a single type argument.
@@ -1522,13 +1797,9 @@ elif sys.version_info[:2] >= (3, 9):
         """
         item = typing._type_check(parameters, f'{self} accepts only a single type.')
         return typing._GenericAlias(self, (item,))
-# 3.7-3.8
+# 3.8
 else:
-    class _TypeGuardForm(typing._SpecialForm, _root=True):
-
-        def __repr__(self):
-            return 'typing_extensions.' + self._name
-
+    class _TypeGuardForm(_ExtensionsSpecialForm, _root=True):
         def __getitem__(self, parameters):
             item = typing._type_check(parameters,
                                       f'{self._name} accepts only a single type')
@@ -1579,6 +1850,98 @@ else:
         PEP 647 (User-Defined Type Guards).
         """)
 
+# 3.13+
+if hasattr(typing, 'TypeIs'):
+    TypeIs = typing.TypeIs
+# 3.9
+elif sys.version_info[:2] >= (3, 9):
+    @_ExtensionsSpecialForm
+    def TypeIs(self, parameters):
+        """Special typing form used to annotate the return type of a user-defined
+        type narrower function.  ``TypeIs`` only accepts a single type argument.
+        At runtime, functions marked this way should return a boolean.
+
+        ``TypeIs`` aims to benefit *type narrowing* -- a technique used by static
+        type checkers to determine a more precise type of an expression within a
+        program's code flow.  Usually type narrowing is done by analyzing
+        conditional code flow and applying the narrowing to a block of code.  The
+        conditional expression here is sometimes referred to as a "type guard".
+
+        Sometimes it would be convenient to use a user-defined boolean function
+        as a type guard.  Such a function should use ``TypeIs[...]`` as its
+        return type to alert static type checkers to this intention.
+
+        Using  ``-> TypeIs`` tells the static type checker that for a given
+        function:
+
+        1. The return value is a boolean.
+        2. If the return value is ``True``, the type of its argument
+        is the intersection of the type inside ``TypeGuard`` and the argument's
+        previously known type.
+
+        For example::
+
+            def is_awaitable(val: object) -> TypeIs[Awaitable[Any]]:
+                return hasattr(val, '__await__')
+
+            def f(val: Union[int, Awaitable[int]]) -> int:
+                if is_awaitable(val):
+                    assert_type(val, Awaitable[int])
+                else:
+                    assert_type(val, int)
+
+        ``TypeIs`` also works with type variables.  For more information, see
+        PEP 742 (Narrowing types with TypeIs).
+        """
+        item = typing._type_check(parameters, f'{self} accepts only a single type.')
+        return typing._GenericAlias(self, (item,))
+# 3.8
+else:
+    class _TypeIsForm(_ExtensionsSpecialForm, _root=True):
+        def __getitem__(self, parameters):
+            item = typing._type_check(parameters,
+                                      f'{self._name} accepts only a single type')
+            return typing._GenericAlias(self, (item,))
+
+    TypeIs = _TypeIsForm(
+        'TypeIs',
+        doc="""Special typing form used to annotate the return type of a user-defined
+        type narrower function.  ``TypeIs`` only accepts a single type argument.
+        At runtime, functions marked this way should return a boolean.
+
+        ``TypeIs`` aims to benefit *type narrowing* -- a technique used by static
+        type checkers to determine a more precise type of an expression within a
+        program's code flow.  Usually type narrowing is done by analyzing
+        conditional code flow and applying the narrowing to a block of code.  The
+        conditional expression here is sometimes referred to as a "type guard".
+
+        Sometimes it would be convenient to use a user-defined boolean function
+        as a type guard.  Such a function should use ``TypeIs[...]`` as its
+        return type to alert static type checkers to this intention.
+
+        Using  ``-> TypeIs`` tells the static type checker that for a given
+        function:
+
+        1. The return value is a boolean.
+        2. If the return value is ``True``, the type of its argument
+        is the intersection of the type inside ``TypeGuard`` and the argument's
+        previously known type.
+
+        For example::
+
+            def is_awaitable(val: object) -> TypeIs[Awaitable[Any]]:
+                return hasattr(val, '__await__')
+
+            def f(val: Union[int, Awaitable[int]]) -> int:
+                if is_awaitable(val):
+                    assert_type(val, Awaitable[int])
+                else:
+                    assert_type(val, int)
+
+        ``TypeIs`` also works with type variables.  For more information, see
+        PEP 742 (Narrowing types with TypeIs).
+        """)
+
 
 # Vendored from cpython typing._SpecialFrom
 class _SpecialForm(typing._Final, _root=True):
@@ -1624,7 +1987,7 @@ class _SpecialForm(typing._Final, _root=True):
         return self._getitem(self, parameters)
 
 
-if hasattr(typing, "LiteralString"):
+if hasattr(typing, "LiteralString"):  # 3.11+
     LiteralString = typing.LiteralString
 else:
     @_SpecialForm
@@ -1647,7 +2010,7 @@ else:
         raise TypeError(f"{self} is not subscriptable")
 
 
-if hasattr(typing, "Self"):
+if hasattr(typing, "Self"):  # 3.11+
     Self = typing.Self
 else:
     @_SpecialForm
@@ -1668,7 +2031,7 @@ else:
         raise TypeError(f"{self} is not subscriptable")
 
 
-if hasattr(typing, "Never"):
+if hasattr(typing, "Never"):  # 3.11+
     Never = typing.Never
 else:
     @_SpecialForm
@@ -1698,14 +2061,10 @@ else:
         raise TypeError(f"{self} is not subscriptable")
 
 
-if hasattr(typing, 'Required'):
+if hasattr(typing, 'Required'):  # 3.11+
     Required = typing.Required
     NotRequired = typing.NotRequired
-elif sys.version_info[:2] >= (3, 9):
-    class _ExtensionsSpecialForm(typing._SpecialForm, _root=True):
-        def __repr__(self):
-            return 'typing_extensions.' + self._name
-
+elif sys.version_info[:2] >= (3, 9):  # 3.9-3.10
     @_ExtensionsSpecialForm
     def Required(self, parameters):
         """A special typing construct to mark a key of a total=False TypedDict
@@ -1743,11 +2102,8 @@ elif sys.version_info[:2] >= (3, 9):
         item = typing._type_check(parameters, f'{self._name} accepts only a single type.')
         return typing._GenericAlias(self, (item,))
 
-else:
-    class _RequiredForm(typing._SpecialForm, _root=True):
-        def __repr__(self):
-            return 'typing_extensions.' + self._name
-
+else:  # 3.8
+    class _RequiredForm(_ExtensionsSpecialForm, _root=True):
         def __getitem__(self, parameters):
             item = typing._type_check(parameters,
                                       f'{self._name} accepts only a single type.')
@@ -1786,59 +2142,129 @@ else:
         """)
 
 
-if hasattr(typing, "Unpack"):  # 3.11+
+if hasattr(typing, 'ReadOnly'):
+    ReadOnly = typing.ReadOnly
+elif sys.version_info[:2] >= (3, 9):  # 3.9-3.12
+    @_ExtensionsSpecialForm
+    def ReadOnly(self, parameters):
+        """A special typing construct to mark an item of a TypedDict as read-only.
+
+        For example:
+
+            class Movie(TypedDict):
+                title: ReadOnly[str]
+                year: int
+
+            def mutate_movie(m: Movie) -> None:
+                m["year"] = 1992  # allowed
+                m["title"] = "The Matrix"  # typechecker error
+
+        There is no runtime checking for this property.
+        """
+        item = typing._type_check(parameters, f'{self._name} accepts only a single type.')
+        return typing._GenericAlias(self, (item,))
+
+else:  # 3.8
+    class _ReadOnlyForm(_ExtensionsSpecialForm, _root=True):
+        def __getitem__(self, parameters):
+            item = typing._type_check(parameters,
+                                      f'{self._name} accepts only a single type.')
+            return typing._GenericAlias(self, (item,))
+
+    ReadOnly = _ReadOnlyForm(
+        'ReadOnly',
+        doc="""A special typing construct to mark a key of a TypedDict as read-only.
+
+        For example:
+
+            class Movie(TypedDict):
+                title: ReadOnly[str]
+                year: int
+
+            def mutate_movie(m: Movie) -> None:
+                m["year"] = 1992  # allowed
+                m["title"] = "The Matrix"  # typechecker error
+
+        There is no runtime checking for this propery.
+        """)
+
+
+_UNPACK_DOC = """\
+Type unpack operator.
+
+The type unpack operator takes the child types from some container type,
+such as `tuple[int, str]` or a `TypeVarTuple`, and 'pulls them out'. For
+example:
+
+  # For some generic class `Foo`:
+  Foo[Unpack[tuple[int, str]]]  # Equivalent to Foo[int, str]
+
+  Ts = TypeVarTuple('Ts')
+  # Specifies that `Bar` is generic in an arbitrary number of types.
+  # (Think of `Ts` as a tuple of an arbitrary number of individual
+  #  `TypeVar`s, which the `Unpack` is 'pulling out' directly into the
+  #  `Generic[]`.)
+  class Bar(Generic[Unpack[Ts]]): ...
+  Bar[int]  # Valid
+  Bar[int, str]  # Also valid
+
+From Python 3.11, this can also be done using the `*` operator:
+
+    Foo[*tuple[int, str]]
+    class Bar(Generic[*Ts]): ...
+
+The operator can also be used along with a `TypedDict` to annotate
+`**kwargs` in a function signature. For instance:
+
+  class Movie(TypedDict):
+    name: str
+    year: int
+
+  # This function expects two keyword arguments - *name* of type `str` and
+  # *year* of type `int`.
+  def foo(**kwargs: Unpack[Movie]): ...
+
+Note that there is only some runtime checking of this operator. Not
+everything the runtime allows may be accepted by static type checkers.
+
+For more information, see PEP 646 and PEP 692.
+"""
+
+
+if sys.version_info >= (3, 12):  # PEP 692 changed the repr of Unpack[]
     Unpack = typing.Unpack
-elif sys.version_info[:2] >= (3, 9):
-    class _UnpackSpecialForm(typing._SpecialForm, _root=True):
-        def __repr__(self):
-            return 'typing_extensions.' + self._name
+
+    def _is_unpack(obj):
+        return get_origin(obj) is Unpack
+
+elif sys.version_info[:2] >= (3, 9):  # 3.9+
+    class _UnpackSpecialForm(_ExtensionsSpecialForm, _root=True):
+        def __init__(self, getitem):
+            super().__init__(getitem)
+            self.__doc__ = _UNPACK_DOC
 
     class _UnpackAlias(typing._GenericAlias, _root=True):
         __class__ = typing.TypeVar
 
     @_UnpackSpecialForm
     def Unpack(self, parameters):
-        """A special typing construct to unpack a variadic type. For example:
-
-            Shape = TypeVarTuple('Shape')
-            Batch = NewType('Batch', int)
-
-            def add_batch_axis(
-                x: Array[Unpack[Shape]]
-            ) -> Array[Batch, Unpack[Shape]]: ...
-
-        """
         item = typing._type_check(parameters, f'{self._name} accepts only a single type.')
         return _UnpackAlias(self, (item,))
 
     def _is_unpack(obj):
         return isinstance(obj, _UnpackAlias)
 
-else:
+else:  # 3.8
     class _UnpackAlias(typing._GenericAlias, _root=True):
         __class__ = typing.TypeVar
 
-    class _UnpackForm(typing._SpecialForm, _root=True):
-        def __repr__(self):
-            return 'typing_extensions.' + self._name
-
+    class _UnpackForm(_ExtensionsSpecialForm, _root=True):
         def __getitem__(self, parameters):
             item = typing._type_check(parameters,
                                       f'{self._name} accepts only a single type.')
             return _UnpackAlias(self, (item,))
 
-    Unpack = _UnpackForm(
-        'Unpack',
-        doc="""A special typing construct to unpack a variadic type. For example:
-
-            Shape = TypeVarTuple('Shape')
-            Batch = NewType('Batch', int)
-
-            def add_batch_axis(
-                x: Array[Unpack[Shape]]
-            ) -> Array[Batch, Unpack[Shape]]: ...
-
-        """)
+    Unpack = _UnpackForm('Unpack', doc=_UNPACK_DOC)
 
     def _is_unpack(obj):
         return isinstance(obj, _UnpackAlias)
@@ -1846,23 +2272,22 @@ else:
 
 if hasattr(typing, "TypeVarTuple"):  # 3.11+
 
-    # Add default Parameter - PEP 696
-    class TypeVarTuple(typing.TypeVarTuple, _DefaultMixin, _root=True):
+    # Add default parameter - PEP 696
+    class TypeVarTuple(metaclass=_TypeVarLikeMeta):
         """Type variable tuple."""
 
-        def __init__(self, name, *, default=None):
-            super().__init__(name)
-            _DefaultMixin.__init__(self, default)
+        _backported_typevarlike = typing.TypeVarTuple
 
-            # for pickling:
-            try:
-                def_mod = sys._getframe(1).f_globals.get('__name__', '__main__')
-            except (AttributeError, ValueError):
-                def_mod = None
-            if def_mod != 'typing_extensions':
-                self.__module__ = def_mod
+        def __new__(cls, name, *, default=_marker):
+            tvt = typing.TypeVarTuple(name)
+            _set_default(tvt, default)
+            _set_module(tvt)
+            return tvt
 
-else:
+        def __init_subclass__(self, *args, **kwds):
+            raise TypeError("Cannot subclass special typing classes")
+
+else:  # <=3.10
     class TypeVarTuple(_DefaultMixin):
         """Type variable tuple.
 
@@ -1913,15 +2338,12 @@ else:
         def __iter__(self):
             yield self.__unpacked__
 
-        def __init__(self, name, *, default=None):
+        def __init__(self, name, *, default=_marker):
             self.__name__ = name
             _DefaultMixin.__init__(self, default)
 
             # for pickling:
-            try:
-                def_mod = sys._getframe(1).f_globals.get('__name__', '__main__')
-            except (AttributeError, ValueError):
-                def_mod = None
+            def_mod = _caller()
             if def_mod != 'typing_extensions':
                 self.__module__ = def_mod
 
@@ -1944,10 +2366,10 @@ else:
                 raise TypeError("Cannot subclass special typing classes")
 
 
-if hasattr(typing, "reveal_type"):
+if hasattr(typing, "reveal_type"):  # 3.11+
     reveal_type = typing.reveal_type
-else:
-    def reveal_type(__obj: T) -> T:
+else:  # <=3.10
+    def reveal_type(obj: T, /) -> T:
         """Reveal the inferred type of a variable.
 
         When a static type checker encounters a call to ``reveal_type()``,
@@ -1963,14 +2385,14 @@ else:
         argument and returns it unchanged.
 
         """
-        print(f"Runtime type is {type(__obj).__name__!r}", file=sys.stderr)
-        return __obj
+        print(f"Runtime type is {type(obj).__name__!r}", file=sys.stderr)
+        return obj
 
 
-if hasattr(typing, "assert_never"):
+if hasattr(typing, "assert_never"):  # 3.11+
     assert_never = typing.assert_never
-else:
-    def assert_never(__arg: Never) -> Never:
+else:  # <=3.10
+    def assert_never(arg: Never, /) -> Never:
         """Assert to the type checker that a line of code is unreachable.
 
         Example::
@@ -1993,14 +2415,16 @@ else:
         raise AssertionError("Expected code to be unreachable")
 
 
-if hasattr(typing, 'dataclass_transform'):
+if sys.version_info >= (3, 12):  # 3.12+
+    # dataclass_transform exists in 3.11 but lacks the frozen_default parameter
     dataclass_transform = typing.dataclass_transform
-else:
+else:  # <=3.11
     def dataclass_transform(
         *,
         eq_default: bool = True,
         order_default: bool = False,
         kw_only_default: bool = False,
+        frozen_default: bool = False,
         field_specifiers: typing.Tuple[
             typing.Union[typing.Type[typing.Any], typing.Callable[..., typing.Any]],
             ...
@@ -2057,6 +2481,8 @@ else:
           assumed to be True or False if it is omitted by the caller.
         - ``kw_only_default`` indicates whether the ``kw_only`` parameter is
           assumed to be True or False if it is omitted by the caller.
+        - ``frozen_default`` indicates whether the ``frozen`` parameter is
+          assumed to be True or False if it is omitted by the caller.
         - ``field_specifiers`` specifies a static list of supported classes
           or functions that describe fields, similar to ``dataclasses.field()``.
 
@@ -2071,6 +2497,7 @@ else:
                 "eq_default": eq_default,
                 "order_default": order_default,
                 "kw_only_default": kw_only_default,
+                "frozen_default": frozen_default,
                 "field_specifiers": field_specifiers,
                 "kwargs": kwargs,
             }
@@ -2078,18 +2505,18 @@ else:
         return decorator
 
 
-if hasattr(typing, "override"):
+if hasattr(typing, "override"):  # 3.12+
     override = typing.override
-else:
+else:  # <=3.11
     _F = typing.TypeVar("_F", bound=typing.Callable[..., typing.Any])
 
-    def override(__arg: _F) -> _F:
+    def override(arg: _F, /) -> _F:
         """Indicate that a method is intended to override a method in a base class.
 
         Usage:
 
             class Base:
-                def method(self) -> None: ...
+                def method(self) -> None:
                     pass
 
             class Child(Base):
@@ -2102,10 +2529,156 @@ else:
         This helps prevent bugs that may occur when a base class is changed
         without an equivalent change to a child class.
 
+        There is no runtime checking of these properties. The decorator
+        sets the ``__override__`` attribute to ``True`` on the decorated object
+        to allow runtime introspection.
+
         See PEP 698 for details.
 
         """
-        return __arg
+        try:
+            arg.__override__ = True
+        except (AttributeError, TypeError):
+            # Skip the attribute silently if it is not writable.
+            # AttributeError happens if the object has __slots__ or a
+            # read-only property, TypeError if it's a builtin class.
+            pass
+        return arg
+
+
+if hasattr(warnings, "deprecated"):
+    deprecated = warnings.deprecated
+else:
+    _T = typing.TypeVar("_T")
+
+    class deprecated:
+        """Indicate that a class, function or overload is deprecated.
+
+        When this decorator is applied to an object, the type checker
+        will generate a diagnostic on usage of the deprecated object.
+
+        Usage:
+
+            @deprecated("Use B instead")
+            class A:
+                pass
+
+            @deprecated("Use g instead")
+            def f():
+                pass
+
+            @overload
+            @deprecated("int support is deprecated")
+            def g(x: int) -> int: ...
+            @overload
+            def g(x: str) -> int: ...
+
+        The warning specified by *category* will be emitted at runtime
+        on use of deprecated objects. For functions, that happens on calls;
+        for classes, on instantiation and on creation of subclasses.
+        If the *category* is ``None``, no warning is emitted at runtime.
+        The *stacklevel* determines where the
+        warning is emitted. If it is ``1`` (the default), the warning
+        is emitted at the direct caller of the deprecated object; if it
+        is higher, it is emitted further up the stack.
+        Static type checker behavior is not affected by the *category*
+        and *stacklevel* arguments.
+
+        The deprecation message passed to the decorator is saved in the
+        ``__deprecated__`` attribute on the decorated object.
+        If applied to an overload, the decorator
+        must be after the ``@overload`` decorator for the attribute to
+        exist on the overload as returned by ``get_overloads()``.
+
+        See PEP 702 for details.
+
+        """
+        def __init__(
+            self,
+            message: str,
+            /,
+            *,
+            category: typing.Optional[typing.Type[Warning]] = DeprecationWarning,
+            stacklevel: int = 1,
+        ) -> None:
+            if not isinstance(message, str):
+                raise TypeError(
+                    "Expected an object of type str for 'message', not "
+                    f"{type(message).__name__!r}"
+                )
+            self.message = message
+            self.category = category
+            self.stacklevel = stacklevel
+
+        def __call__(self, arg: _T, /) -> _T:
+            # Make sure the inner functions created below don't
+            # retain a reference to self.
+            msg = self.message
+            category = self.category
+            stacklevel = self.stacklevel
+            if category is None:
+                arg.__deprecated__ = msg
+                return arg
+            elif isinstance(arg, type):
+                import functools
+                from types import MethodType
+
+                original_new = arg.__new__
+
+                @functools.wraps(original_new)
+                def __new__(cls, *args, **kwargs):
+                    if cls is arg:
+                        warnings.warn(msg, category=category, stacklevel=stacklevel + 1)
+                    if original_new is not object.__new__:
+                        return original_new(cls, *args, **kwargs)
+                    # Mirrors a similar check in object.__new__.
+                    elif cls.__init__ is object.__init__ and (args or kwargs):
+                        raise TypeError(f"{cls.__name__}() takes no arguments")
+                    else:
+                        return original_new(cls)
+
+                arg.__new__ = staticmethod(__new__)
+
+                original_init_subclass = arg.__init_subclass__
+                # We need slightly different behavior if __init_subclass__
+                # is a bound method (likely if it was implemented in Python)
+                if isinstance(original_init_subclass, MethodType):
+                    original_init_subclass = original_init_subclass.__func__
+
+                    @functools.wraps(original_init_subclass)
+                    def __init_subclass__(*args, **kwargs):
+                        warnings.warn(msg, category=category, stacklevel=stacklevel + 1)
+                        return original_init_subclass(*args, **kwargs)
+
+                    arg.__init_subclass__ = classmethod(__init_subclass__)
+                # Or otherwise, which likely means it's a builtin such as
+                # object's implementation of __init_subclass__.
+                else:
+                    @functools.wraps(original_init_subclass)
+                    def __init_subclass__(*args, **kwargs):
+                        warnings.warn(msg, category=category, stacklevel=stacklevel + 1)
+                        return original_init_subclass(*args, **kwargs)
+
+                    arg.__init_subclass__ = __init_subclass__
+
+                arg.__deprecated__ = __new__.__deprecated__ = msg
+                __init_subclass__.__deprecated__ = msg
+                return arg
+            elif callable(arg):
+                import functools
+
+                @functools.wraps(arg)
+                def wrapper(*args, **kwargs):
+                    warnings.warn(msg, category=category, stacklevel=stacklevel + 1)
+                    return arg(*args, **kwargs)
+
+                arg.__deprecated__ = wrapper.__deprecated__ = msg
+                return wrapper
+            else:
+                raise TypeError(
+                    "@deprecated decorator with non-None category must be applied to "
+                    f"a class or callable, not {arg!r}"
+                )
 
 
 # We have to do some monkey patching to deal with the dual nature of
@@ -2120,18 +2693,14 @@ if not hasattr(typing, "TypeVarTuple"):
     typing._check_generic = _check_generic
 
 
-# Backport typing.NamedTuple as it exists in Python 3.11.
+# Backport typing.NamedTuple as it exists in Python 3.13.
 # In 3.11, the ability to define generic `NamedTuple`s was supported.
 # This was explicitly disallowed in 3.9-3.10, and only half-worked in <=3.8.
-if sys.version_info >= (3, 11):
+# On 3.12, we added __orig_bases__ to call-based NamedTuples
+# On 3.13, we deprecated kwargs-based NamedTuples
+if sys.version_info >= (3, 13):
     NamedTuple = typing.NamedTuple
 else:
-    def _caller():
-        try:
-            return sys._getframe(2).f_globals.get('__name__', '__main__')
-        except (AttributeError, ValueError):  # For platforms without _getframe()
-            return None
-
     def _make_nmtuple(name, types, module, defaults=()):
         fields = [n for n, t in types]
         annotations = {n: typing._type_check(t, f"field {n} annotation must be a type")
@@ -2173,37 +2742,486 @@ else:
             )
             nm_tpl.__bases__ = bases
             if typing.Generic in bases:
-                class_getitem = typing.Generic.__class_getitem__.__func__
-                nm_tpl.__class_getitem__ = classmethod(class_getitem)
+                if hasattr(typing, '_generic_class_getitem'):  # 3.12+
+                    nm_tpl.__class_getitem__ = classmethod(typing._generic_class_getitem)
+                else:
+                    class_getitem = typing.Generic.__class_getitem__.__func__
+                    nm_tpl.__class_getitem__ = classmethod(class_getitem)
             # update from user namespace without overriding special namedtuple attributes
-            for key in ns:
+            for key, val in ns.items():
                 if key in _prohibited_namedtuple_fields:
                     raise AttributeError("Cannot overwrite NamedTuple attribute " + key)
-                elif key not in _special_namedtuple_fields and key not in nm_tpl._fields:
-                    setattr(nm_tpl, key, ns[key])
+                elif key not in _special_namedtuple_fields:
+                    if key not in nm_tpl._fields:
+                        setattr(nm_tpl, key, ns[key])
+                    try:
+                        set_name = type(val).__set_name__
+                    except AttributeError:
+                        pass
+                    else:
+                        try:
+                            set_name(val, nm_tpl, key)
+                        except BaseException as e:
+                            msg = (
+                                f"Error calling __set_name__ on {type(val).__name__!r} "
+                                f"instance {key!r} in {typename!r}"
+                            )
+                            # BaseException.add_note() existed on py311,
+                            # but the __set_name__ machinery didn't start
+                            # using add_note() until py312.
+                            # Making sure exceptions are raised in the same way
+                            # as in "normal" classes seems most important here.
+                            if sys.version_info >= (3, 12):
+                                e.add_note(msg)
+                                raise
+                            else:
+                                raise RuntimeError(msg) from e
+
             if typing.Generic in bases:
                 nm_tpl.__init_subclass__()
             return nm_tpl
 
-    def NamedTuple(__typename, __fields=None, **kwargs):
-        if __fields is None:
-            __fields = kwargs.items()
-        elif kwargs:
-            raise TypeError("Either list of fields or keywords"
-                            " can be provided to NamedTuple, not both")
-        return _make_nmtuple(__typename, __fields, module=_caller())
-
-    NamedTuple.__doc__ = typing.NamedTuple.__doc__
     _NamedTuple = type.__new__(_NamedTupleMeta, 'NamedTuple', (), {})
 
-    # On 3.8+, alter the signature so that it matches typing.NamedTuple.
-    # The signature of typing.NamedTuple on >=3.8 is invalid syntax in Python 3.7,
-    # so just leave the signature as it is on 3.7.
-    if sys.version_info >= (3, 8):
-        NamedTuple.__text_signature__ = '(typename, fields=None, /, **kwargs)'
-
     def _namedtuple_mro_entries(bases):
         assert NamedTuple in bases
         return (_NamedTuple,)
 
-    NamedTuple.__mro_entries__ = _namedtuple_mro_entries
+    @_ensure_subclassable(_namedtuple_mro_entries)
+    def NamedTuple(typename, fields=_marker, /, **kwargs):
+        """Typed version of namedtuple.
+
+        Usage::
+
+            class Employee(NamedTuple):
+                name: str
+                id: int
+
+        This is equivalent to::
+
+            Employee = collections.namedtuple('Employee', ['name', 'id'])
+
+        The resulting class has an extra __annotations__ attribute, giving a
+        dict that maps field names to types.  (The field names are also in
+        the _fields attribute, which is part of the namedtuple API.)
+        An alternative equivalent functional syntax is also accepted::
+
+            Employee = NamedTuple('Employee', [('name', str), ('id', int)])
+        """
+        if fields is _marker:
+            if kwargs:
+                deprecated_thing = "Creating NamedTuple classes using keyword arguments"
+                deprecation_msg = (
+                    "{name} is deprecated and will be disallowed in Python {remove}. "
+                    "Use the class-based or functional syntax instead."
+                )
+            else:
+                deprecated_thing = "Failing to pass a value for the 'fields' parameter"
+                example = f"`{typename} = NamedTuple({typename!r}, [])`"
+                deprecation_msg = (
+                    "{name} is deprecated and will be disallowed in Python {remove}. "
+                    "To create a NamedTuple class with 0 fields "
+                    "using the functional syntax, "
+                    "pass an empty list, e.g. "
+                ) + example + "."
+        elif fields is None:
+            if kwargs:
+                raise TypeError(
+                    "Cannot pass `None` as the 'fields' parameter "
+                    "and also specify fields using keyword arguments"
+                )
+            else:
+                deprecated_thing = "Passing `None` as the 'fields' parameter"
+                example = f"`{typename} = NamedTuple({typename!r}, [])`"
+                deprecation_msg = (
+                    "{name} is deprecated and will be disallowed in Python {remove}. "
+                    "To create a NamedTuple class with 0 fields "
+                    "using the functional syntax, "
+                    "pass an empty list, e.g. "
+                ) + example + "."
+        elif kwargs:
+            raise TypeError("Either list of fields or keywords"
+                            " can be provided to NamedTuple, not both")
+        if fields is _marker or fields is None:
+            warnings.warn(
+                deprecation_msg.format(name=deprecated_thing, remove="3.15"),
+                DeprecationWarning,
+                stacklevel=2,
+            )
+            fields = kwargs.items()
+        nt = _make_nmtuple(typename, fields, module=_caller())
+        nt.__orig_bases__ = (NamedTuple,)
+        return nt
+
+
+if hasattr(collections.abc, "Buffer"):
+    Buffer = collections.abc.Buffer
+else:
+    class Buffer(abc.ABC):
+        """Base class for classes that implement the buffer protocol.
+
+        The buffer protocol allows Python objects to expose a low-level
+        memory buffer interface. Before Python 3.12, it is not possible
+        to implement the buffer protocol in pure Python code, or even
+        to check whether a class implements the buffer protocol. In
+        Python 3.12 and higher, the ``__buffer__`` method allows access
+        to the buffer protocol from Python code, and the
+        ``collections.abc.Buffer`` ABC allows checking whether a class
+        implements the buffer protocol.
+
+        To indicate support for the buffer protocol in earlier versions,
+        inherit from this ABC, either in a stub file or at runtime,
+        or use ABC registration. This ABC provides no methods, because
+        there is no Python-accessible methods shared by pre-3.12 buffer
+        classes. It is useful primarily for static checks.
+
+        """
+
+    # As a courtesy, register the most common stdlib buffer classes.
+    Buffer.register(memoryview)
+    Buffer.register(bytearray)
+    Buffer.register(bytes)
+
+
+# Backport of types.get_original_bases, available on 3.12+ in CPython
+if hasattr(_types, "get_original_bases"):
+    get_original_bases = _types.get_original_bases
+else:
+    def get_original_bases(cls, /):
+        """Return the class's "original" bases prior to modification by `__mro_entries__`.
+
+        Examples::
+
+            from typing import TypeVar, Generic
+            from typing_extensions import NamedTuple, TypedDict
+
+            T = TypeVar("T")
+            class Foo(Generic[T]): ...
+            class Bar(Foo[int], float): ...
+            class Baz(list[str]): ...
+            Eggs = NamedTuple("Eggs", [("a", int), ("b", str)])
+            Spam = TypedDict("Spam", {"a": int, "b": str})
+
+            assert get_original_bases(Bar) == (Foo[int], float)
+            assert get_original_bases(Baz) == (list[str],)
+            assert get_original_bases(Eggs) == (NamedTuple,)
+            assert get_original_bases(Spam) == (TypedDict,)
+            assert get_original_bases(int) == (object,)
+        """
+        try:
+            return cls.__dict__.get("__orig_bases__", cls.__bases__)
+        except AttributeError:
+            raise TypeError(
+                f'Expected an instance of type, not {type(cls).__name__!r}'
+            ) from None
+
+
+# NewType is a class on Python 3.10+, making it pickleable
+# The error message for subclassing instances of NewType was improved on 3.11+
+if sys.version_info >= (3, 11):
+    NewType = typing.NewType
+else:
+    class NewType:
+        """NewType creates simple unique types with almost zero
+        runtime overhead. NewType(name, tp) is considered a subtype of tp
+        by static type checkers. At runtime, NewType(name, tp) returns
+        a dummy callable that simply returns its argument. Usage::
+            UserId = NewType('UserId', int)
+            def name_by_id(user_id: UserId) -> str:
+                ...
+            UserId('user')          # Fails type check
+            name_by_id(42)          # Fails type check
+            name_by_id(UserId(42))  # OK
+            num = UserId(5) + 1     # type: int
+        """
+
+        def __call__(self, obj, /):
+            return obj
+
+        def __init__(self, name, tp):
+            self.__qualname__ = name
+            if '.' in name:
+                name = name.rpartition('.')[-1]
+            self.__name__ = name
+            self.__supertype__ = tp
+            def_mod = _caller()
+            if def_mod != 'typing_extensions':
+                self.__module__ = def_mod
+
+        def __mro_entries__(self, bases):
+            # We defined __mro_entries__ to get a better error message
+            # if a user attempts to subclass a NewType instance. bpo-46170
+            supercls_name = self.__name__
+
+            class Dummy:
+                def __init_subclass__(cls):
+                    subcls_name = cls.__name__
+                    raise TypeError(
+                        f"Cannot subclass an instance of NewType. "
+                        f"Perhaps you were looking for: "
+                        f"`{subcls_name} = NewType({subcls_name!r}, {supercls_name})`"
+                    )
+
+            return (Dummy,)
+
+        def __repr__(self):
+            return f'{self.__module__}.{self.__qualname__}'
+
+        def __reduce__(self):
+            return self.__qualname__
+
+        if sys.version_info >= (3, 10):
+            # PEP 604 methods
+            # It doesn't make sense to have these methods on Python <3.10
+
+            def __or__(self, other):
+                return typing.Union[self, other]
+
+            def __ror__(self, other):
+                return typing.Union[other, self]
+
+
+if hasattr(typing, "TypeAliasType"):
+    TypeAliasType = typing.TypeAliasType
+else:
+    def _is_unionable(obj):
+        """Corresponds to is_unionable() in unionobject.c in CPython."""
+        return obj is None or isinstance(obj, (
+            type,
+            _types.GenericAlias,
+            _types.UnionType,
+            TypeAliasType,
+        ))
+
+    class TypeAliasType:
+        """Create named, parameterized type aliases.
+
+        This provides a backport of the new `type` statement in Python 3.12:
+
+            type ListOrSet[T] = list[T] | set[T]
+
+        is equivalent to:
+
+            T = TypeVar("T")
+            ListOrSet = TypeAliasType("ListOrSet", list[T] | set[T], type_params=(T,))
+
+        The name ListOrSet can then be used as an alias for the type it refers to.
+
+        The type_params argument should contain all the type parameters used
+        in the value of the type alias. If the alias is not generic, this
+        argument is omitted.
+
+        Static type checkers should only support type aliases declared using
+        TypeAliasType that follow these rules:
+
+        - The first argument (the name) must be a string literal.
+        - The TypeAliasType instance must be immediately assigned to a variable
+          of the same name. (For example, 'X = TypeAliasType("Y", int)' is invalid,
+          as is 'X, Y = TypeAliasType("X", int), TypeAliasType("Y", int)').
+
+        """
+
+        def __init__(self, name: str, value, *, type_params=()):
+            if not isinstance(name, str):
+                raise TypeError("TypeAliasType name must be a string")
+            self.__value__ = value
+            self.__type_params__ = type_params
+
+            parameters = []
+            for type_param in type_params:
+                if isinstance(type_param, TypeVarTuple):
+                    parameters.extend(type_param)
+                else:
+                    parameters.append(type_param)
+            self.__parameters__ = tuple(parameters)
+            def_mod = _caller()
+            if def_mod != 'typing_extensions':
+                self.__module__ = def_mod
+            # Setting this attribute closes the TypeAliasType from further modification
+            self.__name__ = name
+
+        def __setattr__(self, name: str, value: object, /) -> None:
+            if hasattr(self, "__name__"):
+                self._raise_attribute_error(name)
+            super().__setattr__(name, value)
+
+        def __delattr__(self, name: str, /) -> Never:
+            self._raise_attribute_error(name)
+
+        def _raise_attribute_error(self, name: str) -> Never:
+            # Match the Python 3.12 error messages exactly
+            if name == "__name__":
+                raise AttributeError("readonly attribute")
+            elif name in {"__value__", "__type_params__", "__parameters__", "__module__"}:
+                raise AttributeError(
+                    f"attribute '{name}' of 'typing.TypeAliasType' objects "
+                    "is not writable"
+                )
+            else:
+                raise AttributeError(
+                    f"'typing.TypeAliasType' object has no attribute '{name}'"
+                )
+
+        def __repr__(self) -> str:
+            return self.__name__
+
+        def __getitem__(self, parameters):
+            if not isinstance(parameters, tuple):
+                parameters = (parameters,)
+            parameters = [
+                typing._type_check(
+                    item, f'Subscripting {self.__name__} requires a type.'
+                )
+                for item in parameters
+            ]
+            return typing._GenericAlias(self, tuple(parameters))
+
+        def __reduce__(self):
+            return self.__name__
+
+        def __init_subclass__(cls, *args, **kwargs):
+            raise TypeError(
+                "type 'typing_extensions.TypeAliasType' is not an acceptable base type"
+            )
+
+        # The presence of this method convinces typing._type_check
+        # that TypeAliasTypes are types.
+        def __call__(self):
+            raise TypeError("Type alias is not callable")
+
+        if sys.version_info >= (3, 10):
+            def __or__(self, right):
+                # For forward compatibility with 3.12, reject Unions
+                # that are not accepted by the built-in Union.
+                if not _is_unionable(right):
+                    return NotImplemented
+                return typing.Union[self, right]
+
+            def __ror__(self, left):
+                if not _is_unionable(left):
+                    return NotImplemented
+                return typing.Union[left, self]
+
+
+if hasattr(typing, "is_protocol"):
+    is_protocol = typing.is_protocol
+    get_protocol_members = typing.get_protocol_members
+else:
+    def is_protocol(tp: type, /) -> bool:
+        """Return True if the given type is a Protocol.
+
+        Example::
+
+            >>> from typing_extensions import Protocol, is_protocol
+            >>> class P(Protocol):
+            ...     def a(self) -> str: ...
+            ...     b: int
+            >>> is_protocol(P)
+            True
+            >>> is_protocol(int)
+            False
+        """
+        return (
+            isinstance(tp, type)
+            and getattr(tp, '_is_protocol', False)
+            and tp is not Protocol
+            and tp is not typing.Protocol
+        )
+
+    def get_protocol_members(tp: type, /) -> typing.FrozenSet[str]:
+        """Return the set of members defined in a Protocol.
+
+        Example::
+
+            >>> from typing_extensions import Protocol, get_protocol_members
+            >>> class P(Protocol):
+            ...     def a(self) -> str: ...
+            ...     b: int
+            >>> get_protocol_members(P)
+            frozenset({'a', 'b'})
+
+        Raise a TypeError for arguments that are not Protocols.
+        """
+        if not is_protocol(tp):
+            raise TypeError(f'{tp!r} is not a Protocol')
+        if hasattr(tp, '__protocol_attrs__'):
+            return frozenset(tp.__protocol_attrs__)
+        return frozenset(_get_protocol_attrs(tp))
+
+
+if hasattr(typing, "Doc"):
+    Doc = typing.Doc
+else:
+    class Doc:
+        """Define the documentation of a type annotation using ``Annotated``, to be
+         used in class attributes, function and method parameters, return values,
+         and variables.
+
+        The value should be a positional-only string literal to allow static tools
+        like editors and documentation generators to use it.
+
+        This complements docstrings.
+
+        The string value passed is available in the attribute ``documentation``.
+
+        Example::
+
+            >>> from typing_extensions import Annotated, Doc
+            >>> def hi(to: Annotated[str, Doc("Who to say hi to")]) -> None: ...
+        """
+        def __init__(self, documentation: str, /) -> None:
+            self.documentation = documentation
+
+        def __repr__(self) -> str:
+            return f"Doc({self.documentation!r})"
+
+        def __hash__(self) -> int:
+            return hash(self.documentation)
+
+        def __eq__(self, other: object) -> bool:
+            if not isinstance(other, Doc):
+                return NotImplemented
+            return self.documentation == other.documentation
+
+
+# Aliases for items that have always been in typing.
+# Explicitly assign these (rather than using `from typing import *` at the top),
+# so that we get a CI error if one of these is deleted from typing.py
+# in a future version of Python
+AbstractSet = typing.AbstractSet
+AnyStr = typing.AnyStr
+BinaryIO = typing.BinaryIO
+Callable = typing.Callable
+Collection = typing.Collection
+Container = typing.Container
+Dict = typing.Dict
+ForwardRef = typing.ForwardRef
+FrozenSet = typing.FrozenSet
+Generator = typing.Generator
+Generic = typing.Generic
+Hashable = typing.Hashable
+IO = typing.IO
+ItemsView = typing.ItemsView
+Iterable = typing.Iterable
+Iterator = typing.Iterator
+KeysView = typing.KeysView
+List = typing.List
+Mapping = typing.Mapping
+MappingView = typing.MappingView
+Match = typing.Match
+MutableMapping = typing.MutableMapping
+MutableSequence = typing.MutableSequence
+MutableSet = typing.MutableSet
+Optional = typing.Optional
+Pattern = typing.Pattern
+Reversible = typing.Reversible
+Sequence = typing.Sequence
+Set = typing.Set
+Sized = typing.Sized
+TextIO = typing.TextIO
+Tuple = typing.Tuple
+Union = typing.Union
+ValuesView = typing.ValuesView
+cast = typing.cast
+no_type_check = typing.no_type_check
+no_type_check_decorator = typing.no_type_check_decorator
diff --git a/lib/win32/Demos/BackupRead_BackupWrite.py b/lib/win32/Demos/BackupRead_BackupWrite.py
new file mode 100644
index 00000000..0e9fc9f9
--- /dev/null
+++ b/lib/win32/Demos/BackupRead_BackupWrite.py
@@ -0,0 +1,121 @@
+## demonstrates using BackupRead and BackupWrite to copy all of a file's data streams
+
+
+import ntsecuritycon
+import pythoncom
+import pywintypes
+import win32api
+import win32con
+import win32file
+import win32security
+from pywin32_testutil import ob2memory, str2bytes
+from win32com import storagecon
+
+all_sd_info = (
+    win32security.DACL_SECURITY_INFORMATION
+    | win32security.DACL_SECURITY_INFORMATION
+    | win32security.OWNER_SECURITY_INFORMATION
+    | win32security.GROUP_SECURITY_INFORMATION
+)
+
+tempdir = win32api.GetTempPath()
+tempfile = win32api.GetTempFileName(tempdir, "bkr")[0]
+outfile = win32api.GetTempFileName(tempdir, "out")[0]
+print("Filename:", tempfile, "Output file:", outfile)
+
+f = open(tempfile, "w")
+f.write("some random junk" + "x" * 100)
+f.close()
+
+## add a couple of alternate data streams
+f = open(tempfile + ":streamdata", "w")
+f.write("data written to alternate stream" + "y" * 100)
+f.close()
+
+f = open(tempfile + ":anotherstream", "w")
+f.write("z" * 100)
+f.close()
+
+## add Summary Information, which is stored as a separate stream
+m = storagecon.STGM_READWRITE | storagecon.STGM_SHARE_EXCLUSIVE | storagecon.STGM_DIRECT
+pss = pythoncom.StgOpenStorageEx(
+    tempfile, m, storagecon.STGFMT_FILE, 0, pythoncom.IID_IPropertySetStorage, None
+)
+ps = pss.Create(
+    pythoncom.FMTID_SummaryInformation,
+    pythoncom.IID_IPropertyStorage,
+    0,
+    storagecon.STGM_READWRITE | storagecon.STGM_SHARE_EXCLUSIVE,
+)
+ps.WriteMultiple(
+    (storagecon.PIDSI_KEYWORDS, storagecon.PIDSI_COMMENTS), ("keywords", "comments")
+)
+ps = None
+pss = None
+
+## add a custom security descriptor to make sure we don't
+##   get a default that would always be the same for both files in temp dir
+new_sd = pywintypes.SECURITY_DESCRIPTOR()
+sid = win32security.LookupAccountName("", "EveryOne")[0]
+acl = pywintypes.ACL()
+acl.AddAccessAllowedAce(1, win32con.GENERIC_READ, sid)
+acl.AddAccessAllowedAce(1, ntsecuritycon.FILE_APPEND_DATA, sid)
+acl.AddAccessAllowedAce(1, win32con.GENERIC_WRITE, sid)
+acl.AddAccessAllowedAce(1, ntsecuritycon.FILE_ALL_ACCESS, sid)
+
+new_sd.SetSecurityDescriptorDacl(True, acl, False)
+win32security.SetFileSecurity(tempfile, win32security.DACL_SECURITY_INFORMATION, new_sd)
+
+
+sa = pywintypes.SECURITY_ATTRIBUTES()
+sa.bInheritHandle = True
+h = win32file.CreateFile(
+    tempfile,
+    win32con.GENERIC_ALL,
+    win32con.FILE_SHARE_READ,
+    sa,
+    win32con.OPEN_EXISTING,
+    win32file.FILE_FLAG_BACKUP_SEMANTICS,
+    None,
+)
+
+outh = win32file.CreateFile(
+    outfile,
+    win32con.GENERIC_ALL,
+    win32con.FILE_SHARE_READ | win32con.FILE_SHARE_WRITE,
+    sa,
+    win32con.OPEN_EXISTING,
+    win32file.FILE_FLAG_BACKUP_SEMANTICS,
+    None,
+)
+
+ctxt = 0
+outctxt = 0
+buf = None
+readsize = 100
+
+while 1:
+    bytes_read, buf, ctxt = win32file.BackupRead(h, readsize, buf, False, True, ctxt)
+    if bytes_read == 0:
+        break
+    bytes_written, outctxt = win32file.BackupWrite(
+        outh, bytes_read, buf, False, True, outctxt
+    )
+    print("Written:", bytes_written, "Context:", outctxt)
+win32file.BackupRead(h, 0, buf, True, True, ctxt)
+win32file.BackupWrite(outh, 0, str2bytes(""), True, True, outctxt)
+win32file.CloseHandle(h)
+win32file.CloseHandle(outh)
+
+assert open(tempfile).read() == open(outfile).read(), "File contents differ !"
+assert (
+    open(tempfile + ":streamdata").read() == open(outfile + ":streamdata").read()
+), "streamdata contents differ !"
+assert (
+    open(tempfile + ":anotherstream").read() == open(outfile + ":anotherstream").read()
+), "anotherstream contents differ !"
+assert (
+    ob2memory(win32security.GetFileSecurity(tempfile, all_sd_info))[:]
+    == ob2memory(win32security.GetFileSecurity(outfile, all_sd_info))[:]
+), "Security descriptors are different !"
+## also should check Summary Info programatically
diff --git a/lib/win32/Demos/BackupSeek_streamheaders.py b/lib/win32/Demos/BackupSeek_streamheaders.py
new file mode 100644
index 00000000..8b828d1d
--- /dev/null
+++ b/lib/win32/Demos/BackupSeek_streamheaders.py
@@ -0,0 +1,137 @@
+## demonstrates using BackupSeek to enumerate data streams for a file
+import struct
+
+import pythoncom
+import pywintypes
+import win32api
+import win32con
+import win32file
+from win32com import storagecon
+
+stream_types = {
+    win32con.BACKUP_DATA: "Standard data",
+    win32con.BACKUP_EA_DATA: "Extended attribute data",
+    win32con.BACKUP_SECURITY_DATA: "Security descriptor data",
+    win32con.BACKUP_ALTERNATE_DATA: "Alternative data streams",
+    win32con.BACKUP_LINK: "Hard link information",
+    win32con.BACKUP_PROPERTY_DATA: "Property data",
+    win32con.BACKUP_OBJECT_ID: "Objects identifiers",
+    win32con.BACKUP_REPARSE_DATA: "Reparse points",
+    win32con.BACKUP_SPARSE_BLOCK: "Sparse file",
+}
+
+tempdir = win32api.GetTempPath()
+tempfile = win32api.GetTempFileName(tempdir, "bkr")[0]
+print("Filename:", tempfile)
+
+f = open(tempfile, "w")
+f.write("some random junk" + "x" * 100)
+f.close()
+
+f = open(tempfile + ":streamdata", "w")
+f.write("data written to alternate stream" + "y" * 100)
+f.close()
+
+f = open(tempfile + ":anotherstream", "w")
+f.write("z" * 200)
+f.close()
+
+## add Summary Information, which is stored as a separate stream
+m = storagecon.STGM_READWRITE | storagecon.STGM_SHARE_EXCLUSIVE | storagecon.STGM_DIRECT
+pss = pythoncom.StgOpenStorageEx(
+    tempfile, m, storagecon.STGFMT_FILE, 0, pythoncom.IID_IPropertySetStorage, None
+)
+ps = pss.Create(
+    pythoncom.FMTID_SummaryInformation,
+    pythoncom.IID_IPropertyStorage,
+    0,
+    storagecon.STGM_READWRITE | storagecon.STGM_SHARE_EXCLUSIVE,
+)
+ps.WriteMultiple(
+    (storagecon.PIDSI_KEYWORDS, storagecon.PIDSI_COMMENTS), ("keywords", "comments")
+)
+ps = None
+pss = None
+
+sa = pywintypes.SECURITY_ATTRIBUTES()
+sa.bInheritHandle = False
+h = win32file.CreateFile(
+    tempfile,
+    win32con.GENERIC_ALL,
+    win32con.FILE_SHARE_READ,
+    sa,
+    win32con.OPEN_EXISTING,
+    win32file.FILE_FLAG_BACKUP_SEMANTICS,
+    None,
+)
+
+
+""" stream header:
+typedef struct _WIN32_STREAM_ID {
+    DWORD dwStreamId;  DWORD dwStreamAttributes;  LARGE_INTEGER Size;
+    DWORD dwStreamNameSize;  WCHAR cStreamName[ANYSIZE_ARRAY];
+}
+"""
+
+win32_stream_id_format = "LLQL"
+win32_stream_id_size = struct.calcsize(win32_stream_id_format)
+
+
+def parse_stream_header(h, ctxt, data):
+    stream_type, stream_attributes, stream_size, stream_name_size = struct.unpack(
+        win32_stream_id_format, data
+    )
+    print(
+        "\nType:",
+        stream_type,
+        stream_types[stream_type],
+        "Attributes:",
+        stream_attributes,
+        "Size:",
+        stream_size,
+        "Name len:",
+        stream_name_size,
+    )
+    if stream_name_size > 0:
+        ## ??? sdk says this size is in characters, but it appears to be number of bytes ???
+        bytes_read, stream_name_buf, ctxt = win32file.BackupRead(
+            h, stream_name_size, None, False, True, ctxt
+        )
+        stream_name = pywintypes.UnicodeFromRaw(stream_name_buf[:])
+    else:
+        stream_name = "Unnamed"
+    print("Name:" + stream_name)
+    return (
+        ctxt,
+        stream_type,
+        stream_attributes,
+        stream_size,
+        stream_name_size,
+        stream_name,
+    )
+
+
+ctxt = 0
+win32_stream_id_buf = (
+    None  ## gets rebound to a writable buffer on first call and reused
+)
+while 1:
+    bytes_read, win32_stream_id_buf, ctxt = win32file.BackupRead(
+        h, win32_stream_id_size, win32_stream_id_buf, False, True, ctxt
+    )
+    if bytes_read == 0:
+        break
+    (
+        ctxt,
+        stream_type,
+        stream_attributes,
+        stream_size,
+        stream_name_size,
+        stream_name,
+    ) = parse_stream_header(h, ctxt, win32_stream_id_buf[:])
+    if stream_size > 0:
+        bytes_moved = win32file.BackupSeek(h, stream_size, ctxt)
+        print("Moved: ", bytes_moved)
+
+win32file.BackupRead(h, win32_stream_id_size, win32_stream_id_buf, True, True, ctxt)
+win32file.CloseHandle(h)
diff --git a/lib/win32/Demos/CopyFileEx.py b/lib/win32/Demos/CopyFileEx.py
new file mode 100644
index 00000000..cdac78e5
--- /dev/null
+++ b/lib/win32/Demos/CopyFileEx.py
@@ -0,0 +1,57 @@
+import win32api
+import win32file
+
+
+def ProgressRoutine(
+    TotalFileSize,
+    TotalBytesTransferred,
+    StreamSize,
+    StreamBytesTransferred,
+    StreamNumber,
+    CallbackReason,
+    SourceFile,
+    DestinationFile,
+    Data,
+):
+    print(Data)
+    print(
+        TotalFileSize,
+        TotalBytesTransferred,
+        StreamSize,
+        StreamBytesTransferred,
+        StreamNumber,
+        CallbackReason,
+        SourceFile,
+        DestinationFile,
+    )
+    ##if TotalBytesTransferred > 100000:
+    ##    return win32file.PROGRESS_STOP
+    return win32file.PROGRESS_CONTINUE
+
+
+temp_dir = win32api.GetTempPath()
+fsrc = win32api.GetTempFileName(temp_dir, "cfe")[0]
+fdst = win32api.GetTempFileName(temp_dir, "cfe")[0]
+print(fsrc, fdst)
+
+f = open(fsrc, "w")
+f.write("xxxxxxxxxxxxxxxx\n" * 32768)
+f.close()
+## add a couple of extra data streams
+f = open(fsrc + ":stream_y", "w")
+f.write("yyyyyyyyyyyyyyyy\n" * 32768)
+f.close()
+f = open(fsrc + ":stream_z", "w")
+f.write("zzzzzzzzzzzzzzzz\n" * 32768)
+f.close()
+
+operation_desc = "Copying " + fsrc + " to " + fdst
+win32file.CopyFileEx(
+    fsrc,
+    fdst,
+    ProgressRoutine,
+    Data=operation_desc,
+    Cancel=False,
+    CopyFlags=win32file.COPY_FILE_RESTARTABLE,
+    Transaction=None,
+)
diff --git a/lib/win32/Demos/CreateFileTransacted_MiniVersion.py b/lib/win32/Demos/CreateFileTransacted_MiniVersion.py
new file mode 100644
index 00000000..fd600b59
--- /dev/null
+++ b/lib/win32/Demos/CreateFileTransacted_MiniVersion.py
@@ -0,0 +1,123 @@
+"""
+This demonstrates the creation of miniversions of a file during a transaction.
+The FSCTL_TXFS_CREATE_MINIVERSION control code saves any changes to a new
+miniversion (effectively a savepoint within a transaction).
+"""
+
+import os
+import struct
+
+import win32api
+import win32con
+import win32file
+import win32transaction
+import winerror
+import winioctlcon
+from pywin32_testutil import str2bytes  # py3k-friendly helper
+
+
+def demo():
+    """
+    Definition of buffer used with FSCTL_TXFS_CREATE_MINIVERSION:
+    typedef struct _TXFS_CREATE_MINIVERSION_INFO{
+        USHORT StructureVersion;
+        USHORT StructureLength;
+        ULONG BaseVersion;
+        USHORT MiniVersion;}
+    """
+    buf_fmt = "HHLH0L"  ## buffer size must include struct padding
+    buf_size = struct.calcsize(buf_fmt)
+
+    tempdir = win32api.GetTempPath()
+    tempfile = win32api.GetTempFileName(tempdir, "cft")[0]
+    print("Demonstrating transactions on tempfile", tempfile)
+    f = open(tempfile, "w")
+    f.write("This is original file.\n")
+    f.close()
+
+    trans = win32transaction.CreateTransaction(
+        Description="Test creating miniversions of a file"
+    )
+    hfile = win32file.CreateFileW(
+        tempfile,
+        win32con.GENERIC_READ | win32con.GENERIC_WRITE,
+        win32con.FILE_SHARE_READ | win32con.FILE_SHARE_WRITE,
+        None,
+        win32con.OPEN_EXISTING,
+        0,
+        None,
+        Transaction=trans,
+    )
+
+    win32file.WriteFile(hfile, str2bytes("This is first miniversion.\n"))
+    buf = win32file.DeviceIoControl(
+        hfile, winioctlcon.FSCTL_TXFS_CREATE_MINIVERSION, None, buf_size, None
+    )
+    struct_ver, struct_len, base_ver, ver_1 = struct.unpack(buf_fmt, buf)
+
+    win32file.SetFilePointer(hfile, 0, win32con.FILE_BEGIN)
+    win32file.WriteFile(hfile, str2bytes("This is second miniversion!\n"))
+    buf = win32file.DeviceIoControl(
+        hfile, winioctlcon.FSCTL_TXFS_CREATE_MINIVERSION, None, buf_size, None
+    )
+    struct_ver, struct_len, base_ver, ver_2 = struct.unpack(buf_fmt, buf)
+    hfile.Close()
+
+    ## miniversions can't be opened with write access
+    hfile_0 = win32file.CreateFileW(
+        tempfile,
+        win32con.GENERIC_READ,
+        win32con.FILE_SHARE_READ | win32con.FILE_SHARE_WRITE,
+        None,
+        win32con.OPEN_EXISTING,
+        0,
+        None,
+        Transaction=trans,
+        MiniVersion=base_ver,
+    )
+    print("version:", base_ver, win32file.ReadFile(hfile_0, 100))
+    hfile_0.Close()
+
+    hfile_1 = win32file.CreateFileW(
+        tempfile,
+        win32con.GENERIC_READ,
+        win32con.FILE_SHARE_READ | win32con.FILE_SHARE_WRITE,
+        None,
+        win32con.OPEN_EXISTING,
+        0,
+        None,
+        Transaction=trans,
+        MiniVersion=ver_1,
+    )
+    print("version:", ver_1, win32file.ReadFile(hfile_1, 100))
+    hfile_1.Close()
+
+    hfile_2 = win32file.CreateFileW(
+        tempfile,
+        win32con.GENERIC_READ,
+        win32con.FILE_SHARE_READ | win32con.FILE_SHARE_WRITE,
+        None,
+        win32con.OPEN_EXISTING,
+        0,
+        None,
+        Transaction=trans,
+        MiniVersion=ver_2,
+    )
+    print("version:", ver_2, win32file.ReadFile(hfile_2, 100))
+    hfile_2.Close()
+
+    ## MiniVersions are destroyed when transaction is committed or rolled back
+    win32transaction.CommitTransaction(trans)
+
+    os.unlink(tempfile)
+
+
+if __name__ == "__main__":
+    # When run on CI, this fails with NOT_SUPPORTED, so don't have that cause "failure"
+    try:
+        demo()
+    except win32file.error as e:
+        if e.winerror == winerror.ERROR_NOT_SUPPORTED:
+            print("These features are not supported by this filesystem.")
+        else:
+            raise
diff --git a/lib/win32/Demos/EvtFormatMessage.py b/lib/win32/Demos/EvtFormatMessage.py
new file mode 100644
index 00000000..12543869
--- /dev/null
+++ b/lib/win32/Demos/EvtFormatMessage.py
@@ -0,0 +1,83 @@
+import sys
+
+import win32evtlog
+
+
+def main():
+    path = "System"
+    num_events = 5
+    if len(sys.argv) > 2:
+        path = sys.argv[1]
+        num_events = int(sys.argv[2])
+    elif len(sys.argv) > 1:
+        path = sys.argv[1]
+
+    query = win32evtlog.EvtQuery(path, win32evtlog.EvtQueryForwardDirection)
+    events = win32evtlog.EvtNext(query, num_events)
+    context = win32evtlog.EvtCreateRenderContext(win32evtlog.EvtRenderContextSystem)
+
+    for i, event in enumerate(events, 1):
+        result = win32evtlog.EvtRender(
+            event, win32evtlog.EvtRenderEventValues, Context=context
+        )
+
+        print("Event {}".format(i))
+
+        level_value, level_variant = result[win32evtlog.EvtSystemLevel]
+        if level_variant != win32evtlog.EvtVarTypeNull:
+            if level_value == 1:
+                print("    Level: CRITICAL")
+            elif level_value == 2:
+                print("    Level: ERROR")
+            elif level_value == 3:
+                print("    Level: WARNING")
+            elif level_value == 4:
+                print("    Level: INFO")
+            elif level_value == 5:
+                print("    Level: VERBOSE")
+            else:
+                print("    Level: UNKNOWN")
+
+        time_created_value, time_created_variant = result[
+            win32evtlog.EvtSystemTimeCreated
+        ]
+        if time_created_variant != win32evtlog.EvtVarTypeNull:
+            print("    Timestamp: {}".format(time_created_value.isoformat()))
+
+        computer_value, computer_variant = result[win32evtlog.EvtSystemComputer]
+        if computer_variant != win32evtlog.EvtVarTypeNull:
+            print("    FQDN: {}".format(computer_value))
+
+        provider_name_value, provider_name_variant = result[
+            win32evtlog.EvtSystemProviderName
+        ]
+        if provider_name_variant != win32evtlog.EvtVarTypeNull:
+            print("    Provider: {}".format(provider_name_value))
+
+            try:
+                metadata = win32evtlog.EvtOpenPublisherMetadata(provider_name_value)
+            # pywintypes.error: (2, 'EvtOpenPublisherMetadata', 'The system cannot find the file specified.')
+            except Exception:
+                pass
+            else:
+                try:
+                    message = win32evtlog.EvtFormatMessage(
+                        metadata, event, win32evtlog.EvtFormatMessageEvent
+                    )
+                # pywintypes.error: (15027, 'EvtFormatMessage: allocated 0, need buffer of size 0', 'The message resource is present but the message was not found in the message table.')
+                except Exception:
+                    pass
+                else:
+                    try:
+                        print("    Message: {}".format(message))
+                    except UnicodeEncodeError:
+                        # Obscure error when run under subprocess.Popen(), presumably due to
+                        # not knowing the correct encoding for the console.
+                        # > UnicodeEncodeError: \'charmap\' codec can\'t encode character \'\\u200e\' in position 57: character maps to <undefined>\r\n'
+                        # Can't reproduce when running manually, so it seems more a subprocess.Popen()
+                        # than ours:
+                        print(" Failed to decode:", repr(message))
+
+
+if __name__ == "__main__":
+    main()
diff --git a/lib/win32/Demos/EvtSubscribe_pull.py b/lib/win32/Demos/EvtSubscribe_pull.py
new file mode 100644
index 00000000..f4059796
--- /dev/null
+++ b/lib/win32/Demos/EvtSubscribe_pull.py
@@ -0,0 +1,28 @@
+## Demonstrates how to create a "pull" subscription
+import win32con
+import win32event
+import win32evtlog
+
+query_text = '*[System[Provider[@Name="Microsoft-Windows-Winlogon"]]]'
+
+h = win32event.CreateEvent(None, 0, 0, None)
+s = win32evtlog.EvtSubscribe(
+    "System",
+    win32evtlog.EvtSubscribeStartAtOldestRecord,
+    SignalEvent=h,
+    Query=query_text,
+)
+
+while 1:
+    while 1:
+        events = win32evtlog.EvtNext(s, 10)
+        if len(events) == 0:
+            break
+        ##for event in events:
+        ##	print(win32evtlog.EvtRender(event, win32evtlog.EvtRenderEventXml))
+        print("retrieved %s events" % len(events))
+    while 1:
+        print("waiting...")
+        w = win32event.WaitForSingleObjectEx(h, 2000, True)
+        if w == win32con.WAIT_OBJECT_0:
+            break
diff --git a/lib/win32/Demos/EvtSubscribe_push.py b/lib/win32/Demos/EvtSubscribe_push.py
new file mode 100644
index 00000000..519ef0d7
--- /dev/null
+++ b/lib/win32/Demos/EvtSubscribe_push.py
@@ -0,0 +1,25 @@
+## Demonstrates a "push" subscription with a callback function
+import win32evtlog
+
+query_text = '*[System[Provider[@Name="Microsoft-Windows-Winlogon"]]]'
+
+
+def c(reason, context, evt):
+    if reason == win32evtlog.EvtSubscribeActionError:
+        print("EvtSubscribeActionError")
+    elif reason == win32evtlog.EvtSubscribeActionDeliver:
+        print("EvtSubscribeActionDeliver")
+    else:
+        print("??? Unknown action ???", reason)
+    context.append(win32evtlog.EvtRender(evt, win32evtlog.EvtRenderEventXml))
+    return 0
+
+
+evttext = []
+s = win32evtlog.EvtSubscribe(
+    "System",
+    win32evtlog.EvtSubscribeStartAtOldestRecord,
+    Query="*",
+    Callback=c,
+    Context=evttext,
+)
diff --git a/lib/win32/Demos/FileSecurityTest.py b/lib/win32/Demos/FileSecurityTest.py
new file mode 100644
index 00000000..90c45483
--- /dev/null
+++ b/lib/win32/Demos/FileSecurityTest.py
@@ -0,0 +1,137 @@
+# Contributed by Kelly Kranabetter.
+import os
+import sys
+
+import ntsecuritycon
+import pywintypes
+import win32security
+import winerror
+
+# get security information
+# name=r"c:\autoexec.bat"
+# name= r"g:\!workgrp\lim"
+name = sys.argv[0]
+
+if not os.path.exists(name):
+    print(name, "does not exist!")
+    sys.exit()
+
+print("On file ", name, "\n")
+
+# get owner SID
+print("OWNER")
+try:
+    sd = win32security.GetFileSecurity(name, win32security.OWNER_SECURITY_INFORMATION)
+    sid = sd.GetSecurityDescriptorOwner()
+    print("  ", win32security.LookupAccountSid(None, sid))
+except pywintypes.error as exc:
+    # in automation and network shares we see:
+    # pywintypes.error: (1332, 'LookupAccountName', 'No mapping between account names and security IDs was done.')
+    if exc.winerror != winerror.ERROR_NONE_MAPPED:
+        raise
+    print("No owner information is available")
+
+# get group SID
+try:
+    print("GROUP")
+    sd = win32security.GetFileSecurity(name, win32security.GROUP_SECURITY_INFORMATION)
+    sid = sd.GetSecurityDescriptorGroup()
+    print("  ", win32security.LookupAccountSid(None, sid))
+except pywintypes.error as exc:
+    if exc.winerror != winerror.ERROR_NONE_MAPPED:
+        raise
+    print("No group information is available")
+
+# get ACEs
+sd = win32security.GetFileSecurity(name, win32security.DACL_SECURITY_INFORMATION)
+dacl = sd.GetSecurityDescriptorDacl()
+if dacl == None:
+    print("No Discretionary ACL")
+else:
+    for ace_no in range(0, dacl.GetAceCount()):
+        ace = dacl.GetAce(ace_no)
+        print("ACE", ace_no)
+
+        print("  -Type")
+        for i in (
+            "ACCESS_ALLOWED_ACE_TYPE",
+            "ACCESS_DENIED_ACE_TYPE",
+            "SYSTEM_AUDIT_ACE_TYPE",
+            "SYSTEM_ALARM_ACE_TYPE",
+        ):
+            if getattr(ntsecuritycon, i) == ace[0][0]:
+                print("    ", i)
+
+        print("  -Flags", hex(ace[0][1]))
+        for i in (
+            "OBJECT_INHERIT_ACE",
+            "CONTAINER_INHERIT_ACE",
+            "NO_PROPAGATE_INHERIT_ACE",
+            "INHERIT_ONLY_ACE",
+            "SUCCESSFUL_ACCESS_ACE_FLAG",
+            "FAILED_ACCESS_ACE_FLAG",
+        ):
+            if getattr(ntsecuritycon, i) & ace[0][1] == getattr(ntsecuritycon, i):
+                print("    ", i)
+
+        print("  -mask", hex(ace[1]))
+
+        # files and directories do permissions differently
+        permissions_file = (
+            "DELETE",
+            "READ_CONTROL",
+            "WRITE_DAC",
+            "WRITE_OWNER",
+            "SYNCHRONIZE",
+            "FILE_GENERIC_READ",
+            "FILE_GENERIC_WRITE",
+            "FILE_GENERIC_EXECUTE",
+            "FILE_DELETE_CHILD",
+        )
+        permissions_dir = (
+            "DELETE",
+            "READ_CONTROL",
+            "WRITE_DAC",
+            "WRITE_OWNER",
+            "SYNCHRONIZE",
+            "FILE_ADD_SUBDIRECTORY",
+            "FILE_ADD_FILE",
+            "FILE_DELETE_CHILD",
+            "FILE_LIST_DIRECTORY",
+            "FILE_TRAVERSE",
+            "FILE_READ_ATTRIBUTES",
+            "FILE_WRITE_ATTRIBUTES",
+            "FILE_READ_EA",
+            "FILE_WRITE_EA",
+        )
+        permissions_dir_inherit = (
+            "DELETE",
+            "READ_CONTROL",
+            "WRITE_DAC",
+            "WRITE_OWNER",
+            "SYNCHRONIZE",
+            "GENERIC_READ",
+            "GENERIC_WRITE",
+            "GENERIC_EXECUTE",
+            "GENERIC_ALL",
+        )
+        if os.path.isfile(name):
+            permissions = permissions_file
+        else:
+            permissions = permissions_dir
+            # directories also contain an ACE that is inherited by children (files) within them
+            if (
+                ace[0][1] & ntsecuritycon.OBJECT_INHERIT_ACE
+                == ntsecuritycon.OBJECT_INHERIT_ACE
+                and ace[0][1] & ntsecuritycon.INHERIT_ONLY_ACE
+                == ntsecuritycon.INHERIT_ONLY_ACE
+            ):
+                permissions = permissions_dir_inherit
+
+        calc_mask = 0  # calculate the mask so we can see if we are printing all of the permissions
+        for i in permissions:
+            if getattr(ntsecuritycon, i) & ace[1] == getattr(ntsecuritycon, i):
+                calc_mask = calc_mask | getattr(ntsecuritycon, i)
+                print("    ", i)
+        print("  ", "Calculated Check Mask=", hex(calc_mask))
+        print("  -SID\n    ", win32security.LookupAccountSid(None, ace[2]))
diff --git a/lib/win32/Demos/GetSaveFileName.py b/lib/win32/Demos/GetSaveFileName.py
new file mode 100644
index 00000000..28587505
--- /dev/null
+++ b/lib/win32/Demos/GetSaveFileName.py
@@ -0,0 +1,43 @@
+import os
+
+import win32con
+import win32gui
+
+filter = "Python Scripts\0*.py;*.pyw;*.pys\0Text files\0*.txt\0"
+customfilter = "Other file types\0*.*\0"
+
+fname, customfilter, flags = win32gui.GetSaveFileNameW(
+    InitialDir=os.environ["temp"],
+    Flags=win32con.OFN_ALLOWMULTISELECT | win32con.OFN_EXPLORER,
+    File="somefilename",
+    DefExt="py",
+    Title="GetSaveFileNameW",
+    Filter=filter,
+    CustomFilter=customfilter,
+    FilterIndex=1,
+)
+
+print("save file names:", repr(fname))
+print("filter used:", repr(customfilter))
+print("Flags:", flags)
+for k, v in list(win32con.__dict__.items()):
+    if k.startswith("OFN_") and flags & v:
+        print("\t" + k)
+
+fname, customfilter, flags = win32gui.GetOpenFileNameW(
+    InitialDir=os.environ["temp"],
+    Flags=win32con.OFN_ALLOWMULTISELECT | win32con.OFN_EXPLORER,
+    File="somefilename",
+    DefExt="py",
+    Title="GetOpenFileNameW",
+    Filter=filter,
+    CustomFilter=customfilter,
+    FilterIndex=0,
+)
+
+print("open file names:", repr(fname))
+print("filter used:", repr(customfilter))
+print("Flags:", flags)
+for k, v in list(win32con.__dict__.items()):
+    if k.startswith("OFN_") and flags & v:
+        print("\t" + k)
diff --git a/lib/win32/Demos/NetValidatePasswordPolicy.py b/lib/win32/Demos/NetValidatePasswordPolicy.py
new file mode 100644
index 00000000..86c3bc40
--- /dev/null
+++ b/lib/win32/Demos/NetValidatePasswordPolicy.py
@@ -0,0 +1,127 @@
+"""A demo of using win32net.NetValidatePasswordPolicy.
+
+Example usage:
+
+% NetValidatePasswordPolicy.py --password=foo change
+which might return:
+
+> Result of 'change' validation is 0: The operation completed successfully.
+
+or depending on the policy:
+
+> Result of 'change' validation is 2245: The password does not meet the
+> password policy requirements. Check the minimum password length,
+> password complexity and password history requirements.
+
+Adding --user doesn't seem to change the output (even the PasswordLastSet seen
+when '-f' is used doesn't depend on the username), but theoretically it will
+also check the password history for the specified user.
+
+% NetValidatePasswordPolicy.py auth
+
+which always (with and without '-m') seems to return:
+
+> Result of 'auth' validation is 2701: Password must change at next logon
+"""
+
+import optparse
+import sys
+from pprint import pprint
+
+import win32api
+import win32net
+import win32netcon
+
+
+def main():
+    parser = optparse.OptionParser(
+        "%prog [options] auth|change ...",
+        description="A win32net.NetValidatePasswordPolicy demo.",
+    )
+
+    parser.add_option(
+        "-u",
+        "--username",
+        action="store",
+        help="The username to pass to the function (only for the " "change command",
+    )
+
+    parser.add_option(
+        "-p",
+        "--password",
+        action="store",
+        help="The clear-text password to pass to the function "
+        "(only for the 'change' command)",
+    )
+
+    parser.add_option(
+        "-m",
+        "--password-matched",
+        action="store_false",
+        default=True,
+        help="Used to specify the password does NOT match (ie, "
+        "uses False for the PasswordMatch/PasswordMatched "
+        "arg, both 'auth' and 'change' commands)",
+    )
+
+    parser.add_option(
+        "-s",
+        "--server",
+        action="store",
+        help="The name of the server to execute the command on",
+    )
+
+    parser.add_option(
+        "-f",
+        "--show_fields",
+        action="store_true",
+        default=False,
+        help="Print the NET_VALIDATE_PERSISTED_FIELDS returned",
+    )
+
+    options, args = parser.parse_args()
+
+    if not args:
+        args = ["auth"]
+
+    for arg in args:
+        if arg == "auth":
+            input = {
+                "PasswordMatched": options.password_matched,
+            }
+            val_type = win32netcon.NetValidateAuthentication
+        elif arg == "change":
+            input = {
+                "ClearPassword": options.password,
+                "PasswordMatch": options.password_matched,
+                "UserAccountName": options.username,
+            }
+            val_type = win32netcon.NetValidatePasswordChange
+        else:
+            parser.error("Invalid arg - must be 'auth' or 'change'")
+
+        try:
+            fields, status = win32net.NetValidatePasswordPolicy(
+                options.server, None, val_type, input
+            )
+        except NotImplementedError:
+            print("NetValidatePasswordPolicy not implemented on this platform.")
+            return 1
+        except win32net.error as exc:
+            print("NetValidatePasswordPolicy failed: ", exc)
+            return 1
+
+        if options.show_fields:
+            print("NET_VALIDATE_PERSISTED_FIELDS fields:")
+            pprint(fields)
+
+        print(
+            "Result of %r validation is %d: %s"
+            % (arg, status, win32api.FormatMessage(status).strip())
+        )
+
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())
diff --git a/lib/win32/Demos/OpenEncryptedFileRaw.py b/lib/win32/Demos/OpenEncryptedFileRaw.py
new file mode 100644
index 00000000..aa0f2a7c
--- /dev/null
+++ b/lib/win32/Demos/OpenEncryptedFileRaw.py
@@ -0,0 +1,67 @@
+import os
+
+import win32api
+import win32file
+import winerror
+
+
+def ReadCallback(input_buffer, data, buflen):
+    fnamein, fnameout, f = data
+    ## print fnamein, fnameout, buflen
+    f.write(input_buffer)
+    ## python 2.3 throws an error if return value is a plain int
+    return winerror.ERROR_SUCCESS
+
+
+def WriteCallback(output_buffer, data, buflen):
+    fnamebackup, fnameout, f = data
+    file_data = f.read(buflen)
+    ## returning 0 as len terminates WriteEncryptedFileRaw
+    output_len = len(file_data)
+    output_buffer[:output_len] = file_data
+    return winerror.ERROR_SUCCESS, output_len
+
+
+tmp_dir = win32api.GetTempPath()
+dst_dir = win32api.GetTempFileName(tmp_dir, "oef")[0]
+os.remove(dst_dir)
+os.mkdir(dst_dir)
+print("Destination dir:", dst_dir)
+
+## create an encrypted file
+fname = win32api.GetTempFileName(dst_dir, "ref")[0]
+print("orig file:", fname)
+f = open(fname, "w")
+f.write("xxxxxxxxxxxxxxxx\n" * 32768)
+f.close()
+## add a couple of extra data streams
+f = open(fname + ":stream_y", "w")
+f.write("yyyyyyyyyyyyyyyy\n" * 32768)
+f.close()
+f = open(fname + ":stream_z", "w")
+f.write("zzzzzzzzzzzzzzzz\n" * 32768)
+f.close()
+win32file.EncryptFile(fname)
+
+## backup raw data of encrypted file
+bkup_fname = win32api.GetTempFileName(dst_dir, "bef")[0]
+print("backup file:", bkup_fname)
+f = open(bkup_fname, "wb")
+ctxt = win32file.OpenEncryptedFileRaw(fname, 0)
+try:
+    win32file.ReadEncryptedFileRaw(ReadCallback, (fname, bkup_fname, f), ctxt)
+finally:
+    ## if context is not closed, file remains locked even if calling process is killed
+    win32file.CloseEncryptedFileRaw(ctxt)
+    f.close()
+
+## restore data from backup to new encrypted file
+dst_fname = win32api.GetTempFileName(dst_dir, "wef")[0]
+print("restored file:", dst_fname)
+f = open(bkup_fname, "rb")
+ctxtout = win32file.OpenEncryptedFileRaw(dst_fname, win32file.CREATE_FOR_IMPORT)
+try:
+    win32file.WriteEncryptedFileRaw(WriteCallback, (bkup_fname, dst_fname, f), ctxtout)
+finally:
+    win32file.CloseEncryptedFileRaw(ctxtout)
+    f.close()
diff --git a/lib/win32/Demos/RegCreateKeyTransacted.py b/lib/win32/Demos/RegCreateKeyTransacted.py
new file mode 100644
index 00000000..687f07ae
--- /dev/null
+++ b/lib/win32/Demos/RegCreateKeyTransacted.py
@@ -0,0 +1,60 @@
+import win32api
+import win32con
+import win32transaction
+
+keyname = "Pywin32 test transacted registry functions"
+subkeyname = "test transacted subkey"
+classname = "Transacted Class"
+
+trans = win32transaction.CreateTransaction(Description="test RegCreateKeyTransacted")
+key, disp = win32api.RegCreateKeyEx(
+    win32con.HKEY_CURRENT_USER,
+    keyname,
+    samDesired=win32con.KEY_ALL_ACCESS,
+    Class=classname,
+)
+## clean up any existing keys
+for subk in win32api.RegEnumKeyExW(key):
+    win32api.RegDeleteKey(key, subk[0])
+
+## reopen key in transacted mode
+transacted_key = win32api.RegOpenKeyTransacted(
+    Key=win32con.HKEY_CURRENT_USER,
+    SubKey=keyname,
+    Transaction=trans,
+    samDesired=win32con.KEY_ALL_ACCESS,
+)
+subkey, disp = win32api.RegCreateKeyEx(
+    transacted_key,
+    subkeyname,
+    Transaction=trans,
+    samDesired=win32con.KEY_ALL_ACCESS,
+    Class=classname,
+)
+
+## Newly created key should not be visible from non-transacted handle
+subkeys = [s[0] for s in win32api.RegEnumKeyExW(key)]
+assert subkeyname not in subkeys
+
+transacted_subkeys = [s[0] for s in win32api.RegEnumKeyExW(transacted_key)]
+assert subkeyname in transacted_subkeys
+
+## Key should be visible to non-transacted handle after commit
+win32transaction.CommitTransaction(trans)
+subkeys = [s[0] for s in win32api.RegEnumKeyExW(key)]
+assert subkeyname in subkeys
+
+## test transacted delete
+del_trans = win32transaction.CreateTransaction(
+    Description="test RegDeleteKeyTransacted"
+)
+win32api.RegDeleteKeyEx(key, subkeyname, Transaction=del_trans)
+## subkey should still show up for non-transacted handle
+subkeys = [s[0] for s in win32api.RegEnumKeyExW(key)]
+assert subkeyname in subkeys
+## ... and should be gone after commit
+win32transaction.CommitTransaction(del_trans)
+subkeys = [s[0] for s in win32api.RegEnumKeyExW(key)]
+assert subkeyname not in subkeys
+
+win32api.RegDeleteKey(win32con.HKEY_CURRENT_USER, keyname)
diff --git a/lib/win32/Demos/RegRestoreKey.py b/lib/win32/Demos/RegRestoreKey.py
new file mode 100644
index 00000000..69ce32ea
--- /dev/null
+++ b/lib/win32/Demos/RegRestoreKey.py
@@ -0,0 +1,71 @@
+import os
+
+import ntsecuritycon
+import win32api
+import win32con
+import win32security
+import winnt
+
+temp_dir = win32api.GetTempPath()
+fname = win32api.GetTempFileName(temp_dir, "rsk")[0]
+print(fname)
+## file can't exist
+os.remove(fname)
+
+## enable backup and restore privs
+required_privs = (
+    (
+        win32security.LookupPrivilegeValue("", ntsecuritycon.SE_BACKUP_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", ntsecuritycon.SE_RESTORE_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+)
+ph = win32api.GetCurrentProcess()
+th = win32security.OpenProcessToken(
+    ph, win32con.TOKEN_READ | win32con.TOKEN_ADJUST_PRIVILEGES
+)
+adjusted_privs = win32security.AdjustTokenPrivileges(th, 0, required_privs)
+
+try:
+    sa = win32security.SECURITY_ATTRIBUTES()
+    my_sid = win32security.GetTokenInformation(th, ntsecuritycon.TokenUser)[0]
+    sa.SECURITY_DESCRIPTOR.SetSecurityDescriptorOwner(my_sid, 0)
+
+    k, disp = win32api.RegCreateKeyEx(
+        win32con.HKEY_CURRENT_USER,
+        "Python test key",
+        SecurityAttributes=sa,
+        samDesired=win32con.KEY_ALL_ACCESS,
+        Class="some class",
+        Options=0,
+    )
+    win32api.RegSetValue(k, None, win32con.REG_SZ, "Default value for python test key")
+
+    subk, disp = win32api.RegCreateKeyEx(
+        k,
+        "python test subkey",
+        SecurityAttributes=sa,
+        samDesired=win32con.KEY_ALL_ACCESS,
+        Class="some other class",
+        Options=0,
+    )
+    win32api.RegSetValue(subk, None, win32con.REG_SZ, "Default value for subkey")
+
+    win32api.RegSaveKeyEx(
+        k, fname, Flags=winnt.REG_STANDARD_FORMAT, SecurityAttributes=sa
+    )
+
+    restored_key, disp = win32api.RegCreateKeyEx(
+        win32con.HKEY_CURRENT_USER,
+        "Python test key(restored)",
+        SecurityAttributes=sa,
+        samDesired=win32con.KEY_ALL_ACCESS,
+        Class="restored class",
+        Options=0,
+    )
+    win32api.RegRestoreKey(restored_key, fname)
+finally:
+    win32security.AdjustTokenPrivileges(th, 0, adjusted_privs)
diff --git a/lib/win32/Demos/SystemParametersInfo.py b/lib/win32/Demos/SystemParametersInfo.py
new file mode 100644
index 00000000..55a331e6
--- /dev/null
+++ b/lib/win32/Demos/SystemParametersInfo.py
@@ -0,0 +1,210 @@
+import glob
+import os
+import time
+
+import win32api
+import win32con
+import win32gui
+
+## some of these tests will fail for systems prior to XP
+
+for pname in (
+    ## Set actions all take an unsigned int in pvParam
+    "SPI_GETMOUSESPEED",
+    "SPI_GETACTIVEWNDTRKTIMEOUT",
+    "SPI_GETCARETWIDTH",
+    "SPI_GETFOREGROUNDFLASHCOUNT",
+    "SPI_GETFOREGROUNDLOCKTIMEOUT",
+    ## Set actions all take an unsigned int in uiParam
+    "SPI_GETWHEELSCROLLLINES",
+    "SPI_GETKEYBOARDDELAY",
+    "SPI_GETKEYBOARDSPEED",
+    "SPI_GETMOUSEHOVERHEIGHT",
+    "SPI_GETMOUSEHOVERWIDTH",
+    "SPI_GETMOUSEHOVERTIME",
+    "SPI_GETSCREENSAVETIMEOUT",
+    "SPI_GETMENUSHOWDELAY",
+    "SPI_GETLOWPOWERTIMEOUT",
+    "SPI_GETPOWEROFFTIMEOUT",
+    "SPI_GETBORDER",
+    ## below are winxp only:
+    "SPI_GETFONTSMOOTHINGCONTRAST",
+    "SPI_GETFONTSMOOTHINGTYPE",
+    "SPI_GETFOCUSBORDERHEIGHT",
+    "SPI_GETFOCUSBORDERWIDTH",
+    "SPI_GETMOUSECLICKLOCKTIME",
+):
+    print(pname)
+    cget = getattr(win32con, pname)
+    cset = getattr(win32con, pname.replace("_GET", "_SET"))
+    orig_value = win32gui.SystemParametersInfo(cget)
+    print("\toriginal setting:", orig_value)
+    win32gui.SystemParametersInfo(cset, orig_value + 1)
+    new_value = win32gui.SystemParametersInfo(cget)
+    print("\tnew value:", new_value)
+    # On Vista, some of these values seem to be ignored.  So only "fail" if
+    # the new value isn't what we set or the original
+    if new_value != orig_value + 1:
+        assert new_value == orig_value
+        print("Strange - setting %s seems to have been ignored" % (pname,))
+    win32gui.SystemParametersInfo(cset, orig_value)
+    assert win32gui.SystemParametersInfo(cget) == orig_value
+
+
+# these take a boolean value in pvParam
+# change to opposite, check that it was changed and change back
+for pname in (
+    "SPI_GETFLATMENU",
+    "SPI_GETDROPSHADOW",
+    "SPI_GETKEYBOARDCUES",
+    "SPI_GETMENUFADE",
+    "SPI_GETCOMBOBOXANIMATION",
+    "SPI_GETCURSORSHADOW",
+    "SPI_GETGRADIENTCAPTIONS",
+    "SPI_GETHOTTRACKING",
+    "SPI_GETLISTBOXSMOOTHSCROLLING",
+    "SPI_GETMENUANIMATION",
+    "SPI_GETSELECTIONFADE",
+    "SPI_GETTOOLTIPANIMATION",
+    "SPI_GETTOOLTIPFADE",
+    "SPI_GETUIEFFECTS",
+    "SPI_GETACTIVEWINDOWTRACKING",
+    "SPI_GETACTIVEWNDTRKZORDER",
+):
+    print(pname)
+    cget = getattr(win32con, pname)
+    cset = getattr(win32con, pname.replace("_GET", "_SET"))
+    orig_value = win32gui.SystemParametersInfo(cget)
+    print(orig_value)
+    win32gui.SystemParametersInfo(cset, not orig_value)
+    new_value = win32gui.SystemParametersInfo(cget)
+    print(new_value)
+    assert orig_value != new_value
+    win32gui.SystemParametersInfo(cset, orig_value)
+    assert win32gui.SystemParametersInfo(cget) == orig_value
+
+
+# these take a boolean in uiParam
+#  could combine with above section now that SystemParametersInfo only takes a single parameter
+for pname in (
+    "SPI_GETFONTSMOOTHING",
+    "SPI_GETICONTITLEWRAP",
+    "SPI_GETBEEP",
+    "SPI_GETBLOCKSENDINPUTRESETS",
+    "SPI_GETKEYBOARDPREF",
+    "SPI_GETSCREENSAVEACTIVE",
+    "SPI_GETMENUDROPALIGNMENT",
+    "SPI_GETDRAGFULLWINDOWS",
+    "SPI_GETSHOWIMEUI",
+):
+    cget = getattr(win32con, pname)
+    cset = getattr(win32con, pname.replace("_GET", "_SET"))
+    orig_value = win32gui.SystemParametersInfo(cget)
+    win32gui.SystemParametersInfo(cset, not orig_value)
+    new_value = win32gui.SystemParametersInfo(cget)
+    # Some of these also can't be changed (eg, SPI_GETSCREENSAVEACTIVE) so
+    # don't actually get upset.
+    if orig_value != new_value:
+        print("successfully toggled", pname, "from", orig_value, "to", new_value)
+    else:
+        print("couldn't toggle", pname, "from", orig_value)
+    win32gui.SystemParametersInfo(cset, orig_value)
+    assert win32gui.SystemParametersInfo(cget) == orig_value
+
+
+print("SPI_GETICONTITLELOGFONT")
+lf = win32gui.SystemParametersInfo(win32con.SPI_GETICONTITLELOGFONT)
+orig_height = lf.lfHeight
+orig_italic = lf.lfItalic
+print("Height:", orig_height, "Italic:", orig_italic)
+lf.lfHeight += 2
+lf.lfItalic = not lf.lfItalic
+win32gui.SystemParametersInfo(win32con.SPI_SETICONTITLELOGFONT, lf)
+new_lf = win32gui.SystemParametersInfo(win32con.SPI_GETICONTITLELOGFONT)
+print("New Height:", new_lf.lfHeight, "New Italic:", new_lf.lfItalic)
+assert new_lf.lfHeight == orig_height + 2
+assert new_lf.lfItalic != orig_italic
+
+lf.lfHeight = orig_height
+lf.lfItalic = orig_italic
+win32gui.SystemParametersInfo(win32con.SPI_SETICONTITLELOGFONT, lf)
+new_lf = win32gui.SystemParametersInfo(win32con.SPI_GETICONTITLELOGFONT)
+assert new_lf.lfHeight == orig_height
+assert new_lf.lfItalic == orig_italic
+
+
+print("SPI_GETMOUSEHOVERWIDTH, SPI_GETMOUSEHOVERHEIGHT, SPI_GETMOUSEHOVERTIME")
+w = win32gui.SystemParametersInfo(win32con.SPI_GETMOUSEHOVERWIDTH)
+h = win32gui.SystemParametersInfo(win32con.SPI_GETMOUSEHOVERHEIGHT)
+t = win32gui.SystemParametersInfo(win32con.SPI_GETMOUSEHOVERTIME)
+print("w,h,t:", w, h, t)
+
+win32gui.SystemParametersInfo(win32con.SPI_SETMOUSEHOVERWIDTH, w + 1)
+win32gui.SystemParametersInfo(win32con.SPI_SETMOUSEHOVERHEIGHT, h + 2)
+win32gui.SystemParametersInfo(win32con.SPI_SETMOUSEHOVERTIME, t + 3)
+new_w = win32gui.SystemParametersInfo(win32con.SPI_GETMOUSEHOVERWIDTH)
+new_h = win32gui.SystemParametersInfo(win32con.SPI_GETMOUSEHOVERHEIGHT)
+new_t = win32gui.SystemParametersInfo(win32con.SPI_GETMOUSEHOVERTIME)
+print("new w,h,t:", new_w, new_h, new_t)
+assert new_w == w + 1
+assert new_h == h + 2
+assert new_t == t + 3
+
+win32gui.SystemParametersInfo(win32con.SPI_SETMOUSEHOVERWIDTH, w)
+win32gui.SystemParametersInfo(win32con.SPI_SETMOUSEHOVERHEIGHT, h)
+win32gui.SystemParametersInfo(win32con.SPI_SETMOUSEHOVERTIME, t)
+new_w = win32gui.SystemParametersInfo(win32con.SPI_GETMOUSEHOVERWIDTH)
+new_h = win32gui.SystemParametersInfo(win32con.SPI_GETMOUSEHOVERHEIGHT)
+new_t = win32gui.SystemParametersInfo(win32con.SPI_GETMOUSEHOVERTIME)
+assert new_w == w
+assert new_h == h
+assert new_t == t
+
+
+print("SPI_SETDOUBLECLKWIDTH, SPI_SETDOUBLECLKHEIGHT")
+x = win32api.GetSystemMetrics(win32con.SM_CXDOUBLECLK)
+y = win32api.GetSystemMetrics(win32con.SM_CYDOUBLECLK)
+print("x,y:", x, y)
+win32gui.SystemParametersInfo(win32con.SPI_SETDOUBLECLKWIDTH, x + 1)
+win32gui.SystemParametersInfo(win32con.SPI_SETDOUBLECLKHEIGHT, y + 2)
+new_x = win32api.GetSystemMetrics(win32con.SM_CXDOUBLECLK)
+new_y = win32api.GetSystemMetrics(win32con.SM_CYDOUBLECLK)
+print("new x,y:", new_x, new_y)
+assert new_x == x + 1
+assert new_y == y + 2
+win32gui.SystemParametersInfo(win32con.SPI_SETDOUBLECLKWIDTH, x)
+win32gui.SystemParametersInfo(win32con.SPI_SETDOUBLECLKHEIGHT, y)
+new_x = win32api.GetSystemMetrics(win32con.SM_CXDOUBLECLK)
+new_y = win32api.GetSystemMetrics(win32con.SM_CYDOUBLECLK)
+assert new_x == x
+assert new_y == y
+
+
+print("SPI_SETDRAGWIDTH, SPI_SETDRAGHEIGHT")
+dw = win32api.GetSystemMetrics(win32con.SM_CXDRAG)
+dh = win32api.GetSystemMetrics(win32con.SM_CYDRAG)
+print("dw,dh:", dw, dh)
+win32gui.SystemParametersInfo(win32con.SPI_SETDRAGWIDTH, dw + 1)
+win32gui.SystemParametersInfo(win32con.SPI_SETDRAGHEIGHT, dh + 2)
+new_dw = win32api.GetSystemMetrics(win32con.SM_CXDRAG)
+new_dh = win32api.GetSystemMetrics(win32con.SM_CYDRAG)
+print("new dw,dh:", new_dw, new_dh)
+assert new_dw == dw + 1
+assert new_dh == dh + 2
+win32gui.SystemParametersInfo(win32con.SPI_SETDRAGWIDTH, dw)
+win32gui.SystemParametersInfo(win32con.SPI_SETDRAGHEIGHT, dh)
+new_dw = win32api.GetSystemMetrics(win32con.SM_CXDRAG)
+new_dh = win32api.GetSystemMetrics(win32con.SM_CYDRAG)
+assert new_dw == dw
+assert new_dh == dh
+
+
+orig_wallpaper = win32gui.SystemParametersInfo(Action=win32con.SPI_GETDESKWALLPAPER)
+print("Original: ", orig_wallpaper)
+for bmp in glob.glob(os.path.join(os.environ["windir"], "*.bmp")):
+    print(bmp)
+    win32gui.SystemParametersInfo(win32con.SPI_SETDESKWALLPAPER, Param=bmp)
+    print(win32gui.SystemParametersInfo(Action=win32con.SPI_GETDESKWALLPAPER))
+    time.sleep(1)
+
+win32gui.SystemParametersInfo(win32con.SPI_SETDESKWALLPAPER, Param=orig_wallpaper)
diff --git a/lib/win32/Demos/c_extension/setup.py b/lib/win32/Demos/c_extension/setup.py
new file mode 100644
index 00000000..6f5cb417
--- /dev/null
+++ b/lib/win32/Demos/c_extension/setup.py
@@ -0,0 +1,26 @@
+# A sample distutils script to show to build your own
+# extension module which extends pywintypes or pythoncom.
+#
+# Use 'python setup.py build' to build this extension.
+import os
+from distutils.core import Extension, setup
+from sysconfig import get_paths
+
+sources = ["win32_extension.cpp"]
+lib_dir = get_paths()["platlib"]
+
+# Specify the directory where the PyWin32 .h and .lib files are installed.
+# If you are doing a win32com extension, you will also need to add
+# win32com\Include and win32com\Libs.
+ext = Extension(
+    "win32_extension",
+    sources,
+    include_dirs=[os.path.join(lib_dir, "win32", "include")],
+    library_dirs=[os.path.join(lib_dir, "win32", "libs")],
+)
+
+setup(
+    name="win32 extension sample",
+    version="0.1",
+    ext_modules=[ext],
+)
diff --git a/lib/win32/Demos/cerapi.py b/lib/win32/Demos/cerapi.py
new file mode 100644
index 00000000..c5d93166
--- /dev/null
+++ b/lib/win32/Demos/cerapi.py
@@ -0,0 +1,254 @@
+# A demo of the Windows CE Remote API
+#
+# This connects to a CE device, and interacts with it.
+
+import getopt
+import os
+import sys
+
+import win32api
+import win32con
+import win32event
+import wincerapi
+
+
+def DumpPythonRegistry():
+    try:
+        h = wincerapi.CeRegOpenKeyEx(
+            win32con.HKEY_LOCAL_MACHINE,
+            "Software\\Python\\PythonCore\\%s\\PythonPath" % sys.winver,
+        )
+    except win32api.error:
+        print("The remote device does not appear to have Python installed")
+        return 0
+    path, typ = wincerapi.CeRegQueryValueEx(h, None)
+    print("The remote PythonPath is '%s'" % (str(path),))
+    h.Close()
+    return 1
+
+
+def DumpRegistry(root, level=0):
+    # A recursive dump of the remote registry to test most functions.
+    h = wincerapi.CeRegOpenKeyEx(win32con.HKEY_LOCAL_MACHINE, None)
+    level_prefix = " " * level
+    index = 0
+    # Enumerate values.
+    while 1:
+        try:
+            name, data, typ = wincerapi.CeRegEnumValue(root, index)
+        except win32api.error:
+            break
+        print("%s%s=%s" % (level_prefix, name, repr(str(data))))
+        index = index + 1
+    # Now enumerate all keys.
+    index = 0
+    while 1:
+        try:
+            name, klass = wincerapi.CeRegEnumKeyEx(root, index)
+        except win32api.error:
+            break
+        print("%s%s\\" % (level_prefix, name))
+        subkey = wincerapi.CeRegOpenKeyEx(root, name)
+        DumpRegistry(subkey, level + 1)
+        index = index + 1
+
+
+def DemoCopyFile():
+    # Create a file on the device, and write a string.
+    cefile = wincerapi.CeCreateFile(
+        "TestPython", win32con.GENERIC_WRITE, 0, None, win32con.OPEN_ALWAYS, 0, None
+    )
+    wincerapi.CeWriteFile(cefile, "Hello from Python")
+    cefile.Close()
+    # reopen the file and check the data.
+    cefile = wincerapi.CeCreateFile(
+        "TestPython", win32con.GENERIC_READ, 0, None, win32con.OPEN_EXISTING, 0, None
+    )
+    if wincerapi.CeReadFile(cefile, 100) != "Hello from Python":
+        print("Couldnt read the data from the device!")
+    cefile.Close()
+    # Delete the test file
+    wincerapi.CeDeleteFile("TestPython")
+    print("Created, wrote to, read from and deleted a test file!")
+
+
+def DemoCreateProcess():
+    try:
+        hp, ht, pid, tid = wincerapi.CeCreateProcess(
+            "Windows\\Python.exe", "", None, None, 0, 0, None, "", None
+        )
+
+        # Not necessary, except to see if handle closing raises an exception
+        # (if auto-closed, the error is suppressed)
+        hp.Close()
+        ht.Close()
+        print("Python is running on the remote device!")
+    except win32api.error as xxx_todo_changeme1:
+        (hr, fn, msg) = xxx_todo_changeme1.args
+        print("Couldnt execute remote process -", msg)
+
+
+def DumpRemoteMachineStatus():
+    (
+        ACLineStatus,
+        BatteryFlag,
+        BatteryLifePercent,
+        BatteryLifeTime,
+        BatteryFullLifeTime,
+        BackupBatteryFlag,
+        BackupBatteryLifePercent,
+        BackupBatteryLifeTime,
+        BackupBatteryLifeTime,
+    ) = wincerapi.CeGetSystemPowerStatusEx()
+    if ACLineStatus:
+        power = "AC"
+    else:
+        power = "battery"
+    if BatteryLifePercent == 255:
+        batPerc = "unknown"
+    else:
+        batPerc = BatteryLifePercent
+    print(
+        "The batteries are at %s%%, and is currently being powered by %s"
+        % (batPerc, power)
+    )
+
+    (
+        memLoad,
+        totalPhys,
+        availPhys,
+        totalPage,
+        availPage,
+        totalVirt,
+        availVirt,
+    ) = wincerapi.CeGlobalMemoryStatus()
+
+    print("The memory is %d%% utilized." % (memLoad))
+    print("%-20s%-10s%-10s" % ("", "Total", "Avail"))
+    print("%-20s%-10s%-10s" % ("Physical Memory", totalPhys, availPhys))
+    print("%-20s%-10s%-10s" % ("Virtual Memory", totalVirt, availVirt))
+    print("%-20s%-10s%-10s" % ("Paging file", totalPage, availPage))
+
+    storeSize, freeSize = wincerapi.CeGetStoreInformation()
+    print("%-20s%-10s%-10s" % ("File store", storeSize, freeSize))
+
+    print("The CE temp path is", wincerapi.CeGetTempPath())
+    print("The system info for the device is", wincerapi.CeGetSystemInfo())
+
+
+def DumpRemoteFolders():
+    # Dump all special folders possible.
+    for name, val in list(wincerapi.__dict__.items()):
+        if name[:6] == "CSIDL_":
+            try:
+                loc = str(wincerapi.CeGetSpecialFolderPath(val))
+                print("Folder %s is at %s" % (name, loc))
+            except win32api.error as details:
+                pass
+
+    # Get the shortcut targets for the "Start Menu"
+    print("Dumping start menu shortcuts...")
+    try:
+        startMenu = str(wincerapi.CeGetSpecialFolderPath(wincerapi.CSIDL_STARTMENU))
+    except win32api.error as details:
+        print("This device has no start menu!", details)
+        startMenu = None
+
+    if startMenu:
+        for fileAttr in wincerapi.CeFindFiles(os.path.join(startMenu, "*")):
+            fileName = fileAttr[8]
+            fullPath = os.path.join(startMenu, str(fileName))
+            try:
+                resolved = wincerapi.CeSHGetShortcutTarget(fullPath)
+            except win32api.error as xxx_todo_changeme:
+                (rc, fn, msg) = xxx_todo_changeme.args
+                resolved = "#Error - %s" % msg
+            print("%s->%s" % (fileName, resolved))
+
+    #       print "The start menu is at",
+    #       print wincerapi.CeSHGetShortcutTarget("\\Windows\\Start Menu\\Shortcut to Python.exe.lnk")
+
+
+def usage():
+    print("Options:")
+    print("-a - Execute all demos")
+    print("-p - Execute Python process on remote device")
+    print("-r - Dump the remote registry")
+    print("-f - Dump all remote special folder locations")
+    print("-s - Dont dump machine status")
+    print("-y - Perform asynch init of CE connection")
+
+
+def main():
+    async_init = bStartPython = bDumpRegistry = bDumpFolders = 0
+    bDumpStatus = 1
+    try:
+        opts, args = getopt.getopt(sys.argv[1:], "apr")
+    except getopt.error as why:
+        print("Invalid usage:", why)
+        usage()
+        return
+
+    for o, v in opts:
+        if o == "-a":
+            bStartPython = bDumpRegistry = bDumpStatus = bDumpFolders = asynch_init = 1
+        if o == "-p":
+            bStartPython = 1
+        if o == "-r":
+            bDumpRegistry = 1
+        if o == "-s":
+            bDumpStatus = 0
+        if o == "-f":
+            bDumpFolders = 1
+        if o == "-y":
+            print("Doing asynch init of CE connection")
+            async_init = 1
+
+    if async_init:
+        event, rc = wincerapi.CeRapiInitEx()
+        while 1:
+            rc = win32event.WaitForSingleObject(event, 500)
+            if rc == win32event.WAIT_OBJECT_0:
+                # We connected.
+                break
+            else:
+                print(
+                    "Waiting for Initialize to complete (picture a Cancel button here :)"
+                )
+    else:
+        wincerapi.CeRapiInit()
+    print("Connected to remote CE device.")
+    try:
+        verinfo = wincerapi.CeGetVersionEx()
+        print(
+            "The device is running windows CE version %d.%d - %s"
+            % (verinfo[0], verinfo[1], verinfo[4])
+        )
+
+        if bDumpStatus:
+            print("Dumping remote machine status")
+            DumpRemoteMachineStatus()
+
+        if bDumpRegistry:
+            print("Dumping remote registry...")
+            DumpRegistry(win32con.HKEY_LOCAL_MACHINE)
+
+        if bDumpFolders:
+            print("Dumping remote folder information")
+            DumpRemoteFolders()
+
+        DemoCopyFile()
+        if bStartPython:
+            print("Starting remote Python process")
+            if DumpPythonRegistry():
+                DemoCreateProcess()
+            else:
+                print("Not trying to start Python, as it's not installed")
+
+    finally:
+        wincerapi.CeRapiUninit()
+        print("Disconnected")
+
+
+if __name__ == "__main__":
+    main()
diff --git a/lib/win32/Demos/dde/ddeclient.py b/lib/win32/Demos/dde/ddeclient.py
new file mode 100644
index 00000000..32af3130
--- /dev/null
+++ b/lib/win32/Demos/dde/ddeclient.py
@@ -0,0 +1,18 @@
+# 'Request' example added jjk  11/20/98
+
+import dde
+import win32ui
+
+server = dde.CreateServer()
+server.Create("TestClient")
+
+conversation = dde.CreateConversation(server)
+
+conversation.ConnectTo("RunAny", "RunAnyCommand")
+conversation.Exec("DoSomething")
+conversation.Exec("DoSomethingElse")
+
+conversation.ConnectTo("RunAny", "ComputeStringLength")
+s = "abcdefghi"
+sl = conversation.Request(s)
+print('length of "%s" is %s' % (s, sl))
diff --git a/lib/win32/Demos/dde/ddeserver.py b/lib/win32/Demos/dde/ddeserver.py
new file mode 100644
index 00000000..0374827f
--- /dev/null
+++ b/lib/win32/Demos/dde/ddeserver.py
@@ -0,0 +1,42 @@
+# 'Request' example added jjk  11/20/98
+
+import dde
+import win32ui
+from pywin.mfc import object
+
+
+class MySystemTopic(object.Object):
+    def __init__(self):
+        object.Object.__init__(self, dde.CreateServerSystemTopic())
+
+    def Exec(self, cmd):
+        print("System Topic asked to exec", cmd)
+
+
+class MyOtherTopic(object.Object):
+    def __init__(self, topicName):
+        object.Object.__init__(self, dde.CreateTopic(topicName))
+
+    def Exec(self, cmd):
+        print("Other Topic asked to exec", cmd)
+
+
+class MyRequestTopic(object.Object):
+    def __init__(self, topicName):
+        topic = dde.CreateTopic(topicName)
+        topic.AddItem(dde.CreateStringItem(""))
+        object.Object.__init__(self, topic)
+
+    def Request(self, aString):
+        print("Request Topic asked to compute length of:", aString)
+        return str(len(aString))
+
+
+server = dde.CreateServer()
+server.AddTopic(MySystemTopic())
+server.AddTopic(MyOtherTopic("RunAnyCommand"))
+server.AddTopic(MyRequestTopic("ComputeStringLength"))
+server.Create("RunAny")
+
+while 1:
+    win32ui.PumpWaitingMessages(0, -1)
diff --git a/lib/win32/Demos/desktopmanager.py b/lib/win32/Demos/desktopmanager.py
new file mode 100644
index 00000000..6ffaf2a9
--- /dev/null
+++ b/lib/win32/Demos/desktopmanager.py
@@ -0,0 +1,246 @@
+# Demonstrates using a taskbar icon to create and navigate between desktops
+
+import _thread
+import io
+import time
+import traceback
+
+import pywintypes
+import win32api
+import win32con
+import win32gui
+import win32process
+import win32service
+
+## "Shell_TrayWnd" is class of system tray window, broadcasts "TaskbarCreated" when initialized
+
+
+def desktop_name_dlgproc(hwnd, msg, wparam, lparam):
+    """Handles messages from the desktop name dialog box"""
+    if msg in (win32con.WM_CLOSE, win32con.WM_DESTROY):
+        win32gui.DestroyWindow(hwnd)
+    elif msg == win32con.WM_COMMAND:
+        if wparam == win32con.IDOK:
+            desktop_name = win32gui.GetDlgItemText(hwnd, 72)
+            print("new desktop name: ", desktop_name)
+            win32gui.DestroyWindow(hwnd)
+            create_desktop(desktop_name)
+
+        elif wparam == win32con.IDCANCEL:
+            win32gui.DestroyWindow(hwnd)
+
+
+def get_new_desktop_name(parent_hwnd):
+    """Create a dialog box to ask the user for name of desktop to be created"""
+    msgs = {
+        win32con.WM_COMMAND: desktop_name_dlgproc,
+        win32con.WM_CLOSE: desktop_name_dlgproc,
+        win32con.WM_DESTROY: desktop_name_dlgproc,
+    }
+    # dlg item [type, caption, id, (x,y,cx,cy), style, ex style
+    style = (
+        win32con.WS_BORDER
+        | win32con.WS_VISIBLE
+        | win32con.WS_CAPTION
+        | win32con.WS_SYSMENU
+    )  ## |win32con.DS_SYSMODAL
+    h = win32gui.CreateDialogIndirect(
+        win32api.GetModuleHandle(None),
+        [
+            ["One ugly dialog box !", (100, 100, 200, 100), style, 0],
+            [
+                "Button",
+                "Create",
+                win32con.IDOK,
+                (10, 10, 30, 20),
+                win32con.WS_VISIBLE
+                | win32con.WS_TABSTOP
+                | win32con.BS_HOLLOW
+                | win32con.BS_DEFPUSHBUTTON,
+            ],
+            [
+                "Button",
+                "Never mind",
+                win32con.IDCANCEL,
+                (45, 10, 50, 20),
+                win32con.WS_VISIBLE | win32con.WS_TABSTOP | win32con.BS_HOLLOW,
+            ],
+            ["Static", "Desktop name:", 71, (10, 40, 70, 10), win32con.WS_VISIBLE],
+            ["Edit", "", 72, (75, 40, 90, 10), win32con.WS_VISIBLE],
+        ],
+        parent_hwnd,
+        msgs,
+    )  ## parent_hwnd, msgs)
+
+    win32gui.EnableWindow(h, True)
+    hcontrol = win32gui.GetDlgItem(h, 72)
+    win32gui.EnableWindow(hcontrol, True)
+    win32gui.SetFocus(hcontrol)
+
+
+def new_icon(hdesk, desktop_name):
+    """Runs as a thread on each desktop to create a new tray icon and handle its messages"""
+    global id
+    id = id + 1
+    hdesk.SetThreadDesktop()
+    ## apparently the threads can't use same hinst, so each needs its own window class
+    windowclassname = "PythonDesktopManager" + desktop_name
+    wc = win32gui.WNDCLASS()
+    wc.hInstance = win32api.GetModuleHandle(None)
+    wc.lpszClassName = windowclassname
+    wc.style = win32con.CS_VREDRAW | win32con.CS_HREDRAW | win32con.CS_GLOBALCLASS
+    wc.hCursor = win32gui.LoadCursor(0, win32con.IDC_ARROW)
+    wc.hbrBackground = win32con.COLOR_WINDOW
+    wc.lpfnWndProc = icon_wndproc
+    windowclass = win32gui.RegisterClass(wc)
+    style = win32con.WS_OVERLAPPED | win32con.WS_SYSMENU
+    hwnd = win32gui.CreateWindow(
+        windowclass,
+        "dm_" + desktop_name,
+        win32con.WS_SYSMENU,
+        0,
+        0,
+        win32con.CW_USEDEFAULT,
+        win32con.CW_USEDEFAULT,
+        0,
+        0,
+        wc.hInstance,
+        None,
+    )
+    win32gui.UpdateWindow(hwnd)
+    flags = win32gui.NIF_ICON | win32gui.NIF_MESSAGE | win32gui.NIF_TIP
+    notify_info = (
+        hwnd,
+        id,
+        flags,
+        win32con.WM_USER + 20,
+        hicon,
+        "Desktop Manager (%s)" % desktop_name,
+    )
+    window_info[hwnd] = notify_info
+    ## wait for explorer to initialize system tray for new desktop
+    tray_found = 0
+    while not tray_found:
+        try:
+            tray_found = win32gui.FindWindow("Shell_TrayWnd", None)
+        except win32gui.error:
+            traceback.print_exc
+            time.sleep(0.5)
+    win32gui.Shell_NotifyIcon(win32gui.NIM_ADD, notify_info)
+    win32gui.PumpMessages()
+
+
+def create_desktop(desktop_name, start_explorer=1):
+    """Creates a new desktop and spawns a thread running on it
+    Will also start a new icon thread on an existing desktop
+    """
+    sa = pywintypes.SECURITY_ATTRIBUTES()
+    sa.bInheritHandle = 1
+
+    try:
+        hdesk = win32service.CreateDesktop(
+            desktop_name, 0, win32con.MAXIMUM_ALLOWED, sa
+        )
+    except win32service.error:
+        traceback.print_exc()
+        errbuf = io.StringIO()
+        traceback.print_exc(None, errbuf)
+        win32api.MessageBox(0, errbuf.getvalue(), "Desktop creation failed")
+        return
+    if start_explorer:
+        s = win32process.STARTUPINFO()
+        s.lpDesktop = desktop_name
+        prc_info = win32process.CreateProcess(
+            None,
+            "Explorer.exe",
+            None,
+            None,
+            True,
+            win32con.CREATE_NEW_CONSOLE,
+            None,
+            "c:\\",
+            s,
+        )
+
+    th = _thread.start_new_thread(new_icon, (hdesk, desktop_name))
+    hdesk.SwitchDesktop()
+
+
+def icon_wndproc(hwnd, msg, wp, lp):
+    """Window proc for the tray icons"""
+    if lp == win32con.WM_LBUTTONDOWN:
+        ## popup menu won't disappear if you don't do this
+        win32gui.SetForegroundWindow(hwnd)
+
+        curr_desktop = win32service.OpenInputDesktop(0, True, win32con.MAXIMUM_ALLOWED)
+        curr_desktop_name = win32service.GetUserObjectInformation(
+            curr_desktop, win32con.UOI_NAME
+        )
+        winsta = win32service.GetProcessWindowStation()
+        desktops = winsta.EnumDesktops()
+        m = win32gui.CreatePopupMenu()
+        desktop_cnt = len(desktops)
+        ## *don't* create an item 0
+        for d in range(1, desktop_cnt + 1):
+            mf_flags = win32con.MF_STRING
+            ## if you switch to winlogon yourself, there's nothing there and you're stuck
+            if desktops[d - 1].lower() in ("winlogon", "disconnect"):
+                mf_flags = mf_flags | win32con.MF_GRAYED | win32con.MF_DISABLED
+            if desktops[d - 1] == curr_desktop_name:
+                mf_flags = mf_flags | win32con.MF_CHECKED
+            win32gui.AppendMenu(m, mf_flags, d, desktops[d - 1])
+        win32gui.AppendMenu(m, win32con.MF_STRING, desktop_cnt + 1, "Create new ...")
+        win32gui.AppendMenu(m, win32con.MF_STRING, desktop_cnt + 2, "Exit")
+
+        x, y = win32gui.GetCursorPos()
+        d = win32gui.TrackPopupMenu(
+            m,
+            win32con.TPM_LEFTBUTTON | win32con.TPM_RETURNCMD | win32con.TPM_NONOTIFY,
+            x,
+            y,
+            0,
+            hwnd,
+            None,
+        )
+        win32gui.PumpWaitingMessages()
+        win32gui.DestroyMenu(m)
+        if d == desktop_cnt + 1:  ## Create new
+            get_new_desktop_name(hwnd)
+        elif d == desktop_cnt + 2:  ## Exit
+            win32gui.PostQuitMessage(0)
+            win32gui.Shell_NotifyIcon(win32gui.NIM_DELETE, window_info[hwnd])
+            del window_info[hwnd]
+            origin_desktop.SwitchDesktop()
+        elif d > 0:
+            hdesk = win32service.OpenDesktop(
+                desktops[d - 1], 0, 0, win32con.MAXIMUM_ALLOWED
+            )
+            hdesk.SwitchDesktop()
+        return 0
+    else:
+        return win32gui.DefWindowProc(hwnd, msg, wp, lp)
+
+
+window_info = {}
+origin_desktop = win32service.OpenInputDesktop(0, True, win32con.MAXIMUM_ALLOWED)
+origin_desktop_name = win32service.GetUserObjectInformation(
+    origin_desktop, win32service.UOI_NAME
+)
+
+hinst = win32api.GetModuleHandle(None)
+try:
+    hicon = win32gui.LoadIcon(hinst, 1)  ## python.exe and pythonw.exe
+except win32gui.error:
+    hicon = win32gui.LoadIcon(hinst, 135)  ## pythonwin's icon
+id = 0
+
+create_desktop(str(origin_desktop_name), 0)
+
+## wait for first thread to initialize its icon
+while not window_info:
+    time.sleep(1)
+
+## exit when last tray icon goes away
+while window_info:
+    win32gui.PumpWaitingMessages()
+    time.sleep(3)
diff --git a/lib/win32/Demos/eventLogDemo.py b/lib/win32/Demos/eventLogDemo.py
new file mode 100644
index 00000000..8d4220b0
--- /dev/null
+++ b/lib/win32/Demos/eventLogDemo.py
@@ -0,0 +1,142 @@
+import win32api  # To translate NT Sids to account names.
+import win32con
+import win32evtlog
+import win32evtlogutil
+import win32security
+
+
+def ReadLog(computer, logType="Application", dumpEachRecord=0):
+    # read the entire log back.
+    h = win32evtlog.OpenEventLog(computer, logType)
+    numRecords = win32evtlog.GetNumberOfEventLogRecords(h)
+    #       print "There are %d records" % numRecords
+
+    num = 0
+    while 1:
+        objects = win32evtlog.ReadEventLog(
+            h,
+            win32evtlog.EVENTLOG_BACKWARDS_READ | win32evtlog.EVENTLOG_SEQUENTIAL_READ,
+            0,
+        )
+        if not objects:
+            break
+        for object in objects:
+            # get it for testing purposes, but dont print it.
+            msg = win32evtlogutil.SafeFormatMessage(object, logType)
+            if object.Sid is not None:
+                try:
+                    domain, user, typ = win32security.LookupAccountSid(
+                        computer, object.Sid
+                    )
+                    sidDesc = "%s/%s" % (domain, user)
+                except win32security.error:
+                    sidDesc = str(object.Sid)
+                user_desc = "Event associated with user %s" % (sidDesc,)
+            else:
+                user_desc = None
+            if dumpEachRecord:
+                print(
+                    "Event record from %r generated at %s"
+                    % (object.SourceName, object.TimeGenerated.Format())
+                )
+                if user_desc:
+                    print(user_desc)
+                try:
+                    print(msg)
+                except UnicodeError:
+                    print("(unicode error printing message: repr() follows...)")
+                    print(repr(msg))
+
+        num = num + len(objects)
+
+    if numRecords == num:
+        print("Successfully read all", numRecords, "records")
+    else:
+        print(
+            "Couldn't get all records - reported %d, but found %d" % (numRecords, num)
+        )
+        print(
+            "(Note that some other app may have written records while we were running!)"
+        )
+    win32evtlog.CloseEventLog(h)
+
+
+def usage():
+    print("Writes an event to the event log.")
+    print("-w : Dont write any test records.")
+    print("-r : Dont read the event log")
+    print("-c : computerName : Process the log on the specified computer")
+    print("-v : Verbose")
+    print("-t : LogType - Use the specified log - default = 'Application'")
+
+
+def test():
+    # check if running on Windows NT, if not, display notice and terminate
+    if win32api.GetVersion() & 0x80000000:
+        print("This sample only runs on NT")
+        return
+
+    import getopt
+    import sys
+
+    opts, args = getopt.getopt(sys.argv[1:], "rwh?c:t:v")
+    computer = None
+    do_read = do_write = 1
+
+    logType = "Application"
+    verbose = 0
+
+    if len(args) > 0:
+        print("Invalid args")
+        usage()
+        return 1
+    for opt, val in opts:
+        if opt == "-t":
+            logType = val
+        if opt == "-c":
+            computer = val
+        if opt in ["-h", "-?"]:
+            usage()
+            return
+        if opt == "-r":
+            do_read = 0
+        if opt == "-w":
+            do_write = 0
+        if opt == "-v":
+            verbose = verbose + 1
+    if do_write:
+        ph = win32api.GetCurrentProcess()
+        th = win32security.OpenProcessToken(ph, win32con.TOKEN_READ)
+        my_sid = win32security.GetTokenInformation(th, win32security.TokenUser)[0]
+
+        win32evtlogutil.ReportEvent(
+            logType,
+            2,
+            strings=["The message text for event 2", "Another insert"],
+            data="Raw\0Data".encode("ascii"),
+            sid=my_sid,
+        )
+        win32evtlogutil.ReportEvent(
+            logType,
+            1,
+            eventType=win32evtlog.EVENTLOG_WARNING_TYPE,
+            strings=["A warning", "An even more dire warning"],
+            data="Raw\0Data".encode("ascii"),
+            sid=my_sid,
+        )
+        win32evtlogutil.ReportEvent(
+            logType,
+            1,
+            eventType=win32evtlog.EVENTLOG_INFORMATION_TYPE,
+            strings=["An info", "Too much info"],
+            data="Raw\0Data".encode("ascii"),
+            sid=my_sid,
+        )
+        print("Successfully wrote 3 records to the log")
+
+    if do_read:
+        ReadLog(computer, logType, verbose > 0)
+
+
+if __name__ == "__main__":
+    test()
diff --git a/lib/win32/Demos/getfilever.py b/lib/win32/Demos/getfilever.py
new file mode 100644
index 00000000..721e72f3
--- /dev/null
+++ b/lib/win32/Demos/getfilever.py
@@ -0,0 +1,33 @@
+import os
+
+import win32api
+
+ver_strings = (
+    "Comments",
+    "InternalName",
+    "ProductName",
+    "CompanyName",
+    "LegalCopyright",
+    "ProductVersion",
+    "FileDescription",
+    "LegalTrademarks",
+    "PrivateBuild",
+    "FileVersion",
+    "OriginalFilename",
+    "SpecialBuild",
+)
+fname = os.environ["comspec"]
+d = win32api.GetFileVersionInfo(fname, "\\")
+## backslash as parm returns dictionary of numeric info corresponding to VS_FIXEDFILEINFO struc
+for n, v in d.items():
+    print(n, v)
+
+pairs = win32api.GetFileVersionInfo(fname, "\\VarFileInfo\\Translation")
+## \VarFileInfo\Translation returns list of available (language, codepage) pairs that can be used to retreive string info
+## any other must be of the form \StringfileInfo\%04X%04X\parm_name, middle two are language/codepage pair returned from above
+for lang, codepage in pairs:
+    print("lang: ", lang, "codepage:", codepage)
+    for ver_string in ver_strings:
+        str_info = "\\StringFileInfo\\%04X%04X\\%s" % (lang, codepage, ver_string)
+        ## print str_info
+        print(ver_string, repr(win32api.GetFileVersionInfo(fname, str_info)))
diff --git a/lib/win32/Demos/images/frowny.bmp b/lib/win32/Demos/images/frowny.bmp
new file mode 100644
index 0000000000000000000000000000000000000000..43e7621e2e081bc6200523f459f6d803d3133eaa
GIT binary patch
literal 3126
zcmds(J8#oa7>3`t#z~xu5<3kk2}&SQ1*JkPv}?r1z><}fm6e&5m6es1l|R5gsDy;7
zs^YGyR9sYXSM~AQUvzXrY!e)@U_G&%i=Ov<=X~cV*KTZ85no%pU*KyneHGB*6R+v_
z`bO{XcAotA0Og2EI|6mmLqNu8k>$((7k;1>!<FkaKYj?`AGMDTJBJ5n4&I!7`>Ox?
z#rc=}qvw0;`@8Wv4-jsU#cQ$s_2W+&5r69+`Xl0;oSgdkqxk)s|Mg4t^Ko_rtGKxL
z?9%R2V3lN7p?-+uh{*PPXppW*AW{~|7r`nV_+-8c^^ZiBj7akr(I%HgOhgZB1m$i7
zYB5cq3BMhI3faVf%yg7Dgg2ZYzxuaDOvK`TyJ;!^&0lpwG7-5hG8SP(1%0ykL;>q$
zri!>atwQ}bMNEYH%|!iixz#^Yh2;l4a!bUHFcak?AR$Ubo7P1@fD%dDdSS6kbo}bS
zEs_{v`?YCpf7;fw{SI7mM<g+#3YSzI5S^$nDkp&7AZfcBI7f8+>c1<J7-9Q$>)HOa
z1H|^jamhWA#0dC3Vw%?M?p2gX+8KpHolNIH_TLvtj8MN>Zqu~tPdf%@{N)<TwFe?5
z!a<*0MUPCZeKB9fCe{crBKBHDvky$iANwDQm<ZdS*tDh!+i$Oh?bnnmC=wHqxEAAh
zch6U0ALj6UqE7p+e!Gf%5ovy$ZjnbKOGa#<LF|$1v-%&4EE$pJ*OW=2LGnc)I+TL>
zk=viBKVKD#_@{H_uE1Rh;gRf)g4-i5d}5C?`<Zg%&tC3)emgxr=CO^4Hi`sZH6s3B
LYX36d^D_Ql#L5Rl

literal 0
HcmV?d00001

diff --git a/lib/win32/Demos/images/smiley.bmp b/lib/win32/Demos/images/smiley.bmp
new file mode 100644
index 0000000000000000000000000000000000000000..12ed5dee2d1df987c6c3bd5d134e6075ff160c39
GIT binary patch
literal 3126
zcmds&Ju^c=6o%hK=0=E&!GswKCJLi4Dq5pcXtY|bR;|@)wOXw|;2-!GzKyR5MqcOc
zxiTla?oC|L*m>{HW<Q>H&z`+E>zgZ8xUwSkf;_XyQ^1t8q$K0|L+h*avwtt35^J~~
z3pLRU#zg%(fxqAb6Hb!3DZISk`58}7cznde1Mcr}cZb_s+}z;$I$t(B_|0aPg)!*m
zsx*e?MQF9~@qzbuyuIP|71<UN#pNX~E_%sG!YA`sID@n(B8-Zr$uY7b{CpPaQ7C_&
z{H;Yw6lK&!OQdgMGWbn1yirjDQ6oGh<*$;y#WzsX6<*qaUoDP{w#W@~jci*erAsb!
zQW%Bn*C>>~O?no(v`e~mQW%Bd1CeNlY+L9e|DZB%lrFGQ1pHmHZK2cK2i5&X=>i*t
z;TKU7?UB~P%SCq!?;92H_sM=*7(R+6(E-^{i$V>Bn%*DfACmpFu>8shDkDdvXQ4^c
z+P)W>3p*NqY3Be@vVX@vCOr#F2-9sx!;iV;tIIOVBDK)9Hr?7|qv+t<{|h&uOj|2o
zqtLZB-P&WL=-}H|FNKfE3DF4|9@LNCi$#oz?9R2V{8RFm7HRy%#YLCTLQgE*x$V(8
z`J(8BpF~j_fXEf^(t5c-X(pB{cAwep82-i2PIo@Ob&t0;h*iX@qbx#HjrGGlTc&Lb
HJU9On!KEHb

literal 0
HcmV?d00001

diff --git a/lib/win32/Demos/mmapfile_demo.py b/lib/win32/Demos/mmapfile_demo.py
new file mode 100644
index 00000000..9068ce72
--- /dev/null
+++ b/lib/win32/Demos/mmapfile_demo.py
@@ -0,0 +1,102 @@
+import os
+import tempfile
+
+import mmapfile
+import win32api
+import winerror
+from pywin32_testutil import str2bytes
+
+system_info = win32api.GetSystemInfo()
+page_size = system_info[1]
+alloc_size = system_info[7]
+
+fname = tempfile.mktemp()
+mapping_name = os.path.split(fname)[1]
+fsize = 8 * page_size
+print(fname, fsize, mapping_name)
+
+m1 = mmapfile.mmapfile(File=fname, Name=mapping_name, MaximumSize=fsize)
+m1.seek(100)
+m1.write_byte(str2bytes("?"))
+m1.seek(-1, 1)
+assert m1.read_byte() == str2bytes("?")
+
+## A reopened named mapping should have exact same size as original mapping
+m2 = mmapfile.mmapfile(Name=mapping_name, File=None, MaximumSize=fsize * 2)
+assert m2.size() == m1.size()
+m1.seek(0, 0)
+m1.write(fsize * str2bytes("s"))
+assert m2.read(fsize) == fsize * str2bytes("s")
+
+move_src = 100
+move_dest = 500
+move_size = 150
+
+m2.seek(move_src, 0)
+assert m2.tell() == move_src
+m2.write(str2bytes("m") * move_size)
+m2.move(move_dest, move_src, move_size)
+m2.seek(move_dest, 0)
+assert m2.read(move_size) == str2bytes("m") * move_size
+##    m2.write('x'* (fsize+1))
+
+m2.close()
+m1.resize(fsize * 2)
+assert m1.size() == fsize * 2
+m1.seek(fsize)
+m1.write(str2bytes("w") * fsize)
+m1.flush()
+m1.close()
+os.remove(fname)
+
+
+## Test a file with size larger than 32 bits
+## need 10 GB free on drive where your temp folder lives
+fname_large = tempfile.mktemp()
+mapping_name = "Pywin32_large_mmap"
+offsetdata = str2bytes("This is start of offset")
+
+## Deliberately use odd numbers to test rounding logic
+fsize = (1024 * 1024 * 1024 * 10) + 333
+offset = (1024 * 1024 * 32) + 42
+view_size = (1024 * 1024 * 16) + 111
+
+## round mapping size and view size up to multiple of system page size
+if fsize % page_size:
+    fsize += page_size - (fsize % page_size)
+if view_size % page_size:
+    view_size += page_size - (view_size % page_size)
+## round offset down to multiple of allocation granularity
+offset -= offset % alloc_size
+
+m1 = None
+m2 = None
+try:
+    try:
+        m1 = mmapfile.mmapfile(fname_large, mapping_name, fsize, 0, offset * 2)
+    except mmapfile.error as exc:
+        # if we don't have enough disk-space, that's OK.
+        if exc.winerror != winerror.ERROR_DISK_FULL:
+            raise
+        print("skipping large file test - need", fsize, "available bytes.")
+    else:
+        m1.seek(offset)
+        m1.write(offsetdata)
+
+        ## When reopening an existing mapping without passing a file handle, you have
+        ##  to specify a positive size even though it's ignored
+        m2 = mmapfile.mmapfile(
+            File=None,
+            Name=mapping_name,
+            MaximumSize=1,
+            FileOffset=offset,
+            NumberOfBytesToMap=view_size,
+        )
+        assert m2.read(len(offsetdata)) == offsetdata
+finally:
+    if m1 is not None:
+        m1.close()
+    if m2 is not None:
+        m2.close()
+    if os.path.exists(fname_large):
+        os.remove(fname_large)
diff --git a/lib/win32/Demos/pipes/cat.py b/lib/win32/Demos/pipes/cat.py
new file mode 100644
index 00000000..13b6400a
--- /dev/null
+++ b/lib/win32/Demos/pipes/cat.py
@@ -0,0 +1,17 @@
+"""cat.py
+a version of unix cat, tweaked to show off runproc.py
+"""
+
+import sys
+
+data = sys.stdin.read(1)
+sys.stdout.write(data)
+sys.stdout.flush()
+while data:
+    data = sys.stdin.read(1)
+    sys.stdout.write(data)
+    sys.stdout.flush()
+# Just here to have something to read from stderr.
+sys.stderr.write("Blah...")
+
+# end of cat.py
diff --git a/lib/win32/Demos/pipes/runproc.py b/lib/win32/Demos/pipes/runproc.py
new file mode 100644
index 00000000..2ed02dd3
--- /dev/null
+++ b/lib/win32/Demos/pipes/runproc.py
@@ -0,0 +1,114 @@
+"""runproc.py
+
+start a process with three inherited pipes.
+Try to write to and read from those.
+"""
+
+import msvcrt
+import os
+
+import win32api
+import win32con
+import win32file
+import win32pipe
+import win32process
+import win32security
+
+
+class Process:
+    def run(self, cmdline):
+        # security attributes for pipes
+        sAttrs = win32security.SECURITY_ATTRIBUTES()
+        sAttrs.bInheritHandle = 1
+
+        # create pipes
+        hStdin_r, self.hStdin_w = win32pipe.CreatePipe(sAttrs, 0)
+        self.hStdout_r, hStdout_w = win32pipe.CreatePipe(sAttrs, 0)
+        self.hStderr_r, hStderr_w = win32pipe.CreatePipe(sAttrs, 0)
+
+        # set the info structure for the new process.
+        StartupInfo = win32process.STARTUPINFO()
+        StartupInfo.hStdInput = hStdin_r
+        StartupInfo.hStdOutput = hStdout_w
+        StartupInfo.hStdError = hStderr_w
+        StartupInfo.dwFlags = win32process.STARTF_USESTDHANDLES
+        # Mark doesn't support wShowWindow yet.
+        # StartupInfo.dwFlags = StartupInfo.dwFlags | win32process.STARTF_USESHOWWINDOW
+        # StartupInfo.wShowWindow = win32con.SW_HIDE
+
+        # Create new output read handles and the input write handle. Set
+        # the inheritance properties to FALSE. Otherwise, the child inherits
+        # the these handles; resulting in non-closeable handles to the pipes
+        # being created.
+        pid = win32api.GetCurrentProcess()
+
+        tmp = win32api.DuplicateHandle(
+            pid,
+            self.hStdin_w,
+            pid,
+            0,
+            0,  # non-inheritable!!
+            win32con.DUPLICATE_SAME_ACCESS,
+        )
+        # Close the inhertible version of the handle
+        win32file.CloseHandle(self.hStdin_w)
+        self.hStdin_w = tmp
+        tmp = win32api.DuplicateHandle(
+            pid,
+            self.hStdout_r,
+            pid,
+            0,
+            0,  # non-inheritable!
+            win32con.DUPLICATE_SAME_ACCESS,
+        )
+        # Close the inhertible version of the handle
+        win32file.CloseHandle(self.hStdout_r)
+        self.hStdout_r = tmp
+
+        # start the process.
+        hProcess, hThread, dwPid, dwTid = win32process.CreateProcess(
+            None,  # program
+            cmdline,  # command line
+            None,  # process security attributes
+            None,  # thread attributes
+            1,  # inherit handles, or USESTDHANDLES won't work.
+            # creation flags. Don't access the console.
+            0,  # Don't need anything here.
+            # If you're in a GUI app, you should use
+            # CREATE_NEW_CONSOLE here, or any subprocesses
+            # might fall victim to the problem described in:
+            # KB article: Q156755, cmd.exe requires
+            # an NT console in order to perform redirection..
+            None,  # no new environment
+            None,  # current directory (stay where we are)
+            StartupInfo,
+        )
+        # normally, we would save the pid etc. here...
+
+        # Child is launched. Close the parents copy of those pipe handles
+        # that only the child should have open.
+        # You need to make sure that no handles to the write end of the
+        # output pipe are maintained in this process or else the pipe will
+        # not close when the child process exits and the ReadFile will hang.
+        win32file.CloseHandle(hStderr_w)
+        win32file.CloseHandle(hStdout_w)
+        win32file.CloseHandle(hStdin_r)
+
+        self.stdin = os.fdopen(msvcrt.open_osfhandle(self.hStdin_w, 0), "wb")
+        self.stdin.write("hmmmmm\r\n")
+        self.stdin.flush()
+        self.stdin.close()
+
+        self.stdout = os.fdopen(msvcrt.open_osfhandle(self.hStdout_r, 0), "rb")
+        print("Read on stdout: ", repr(self.stdout.read()))
+
+        self.stderr = os.fdopen(msvcrt.open_osfhandle(self.hStderr_r, 0), "rb")
+        print("Read on stderr: ", repr(self.stderr.read()))
+
+
+if __name__ == "__main__":
+    p = Process()
+    exe = win32api.GetModuleFileName(0)
+    p.run(exe + " cat.py")
+
+# end of runproc.py
diff --git a/lib/win32/Demos/print_desktop.py b/lib/win32/Demos/print_desktop.py
new file mode 100644
index 00000000..d06504e2
--- /dev/null
+++ b/lib/win32/Demos/print_desktop.py
@@ -0,0 +1,113 @@
+import pywintypes
+import win32api
+import win32con
+import win32gui
+import win32print
+
+pname = win32print.GetDefaultPrinter()
+print(pname)
+p = win32print.OpenPrinter(pname)
+print("Printer handle: ", p)
+print_processor = win32print.GetPrinter(p, 2)["pPrintProcessor"]
+## call with last parm set to 0 to get total size needed for printer's DEVMODE
+dmsize = win32print.DocumentProperties(0, p, pname, None, None, 0)
+## dmDriverExtra should be total size - fixed size
+driverextra = (
+    dmsize - pywintypes.DEVMODEType().Size
+)  ## need a better way to get DEVMODE.dmSize
+dm = pywintypes.DEVMODEType(driverextra)
+dm.Fields = dm.Fields | win32con.DM_ORIENTATION | win32con.DM_COPIES
+dm.Orientation = win32con.DMORIENT_LANDSCAPE
+dm.Copies = 2
+win32print.DocumentProperties(
+    0, p, pname, dm, dm, win32con.DM_IN_BUFFER | win32con.DM_OUT_BUFFER
+)
+
+pDC = win32gui.CreateDC(print_processor, pname, dm)
+printerwidth = win32print.GetDeviceCaps(pDC, win32con.PHYSICALWIDTH)
+printerheight = win32print.GetDeviceCaps(pDC, win32con.PHYSICALHEIGHT)
+
+hwnd = win32gui.GetDesktopWindow()
+l, t, r, b = win32gui.GetWindowRect(hwnd)
+desktopheight = b - t
+desktopwidth = r - l
+dDC = win32gui.GetWindowDC(hwnd)
+
+dcDC = win32gui.CreateCompatibleDC(dDC)
+dcBM = win32gui.CreateCompatibleBitmap(dDC, desktopwidth, desktopheight)
+win32gui.SelectObject(dcDC, dcBM)
+win32gui.StretchBlt(
+    dcDC,
+    0,
+    0,
+    desktopwidth,
+    desktopheight,
+    dDC,
+    0,
+    0,
+    desktopwidth,
+    desktopheight,
+    win32con.SRCCOPY,
+)
+
+pcDC = win32gui.CreateCompatibleDC(pDC)
+pcBM = win32gui.CreateCompatibleBitmap(pDC, printerwidth, printerheight)
+win32gui.SelectObject(pcDC, pcBM)
+win32gui.StretchBlt(
+    pcDC,
+    0,
+    0,
+    printerwidth,
+    printerheight,
+    dcDC,
+    0,
+    0,
+    desktopwidth,
+    desktopheight,
+    win32con.SRCCOPY,
+)
+
+win32print.StartDoc(pDC, ("desktop.bmp", None, None, 0))
+win32print.StartPage(pDC)
+win32gui.StretchBlt(
+    pDC,
+    0,
+    0,
+    int(printerwidth * 0.9),
+    int(printerheight * 0.9),
+    pcDC,
+    0,
+    0,
+    printerwidth,
+    printerheight,
+    win32con.SRCCOPY,
+)
+
+font = win32gui.LOGFONT()
+font.lfHeight = int(printerheight / 20)
+font.lfWidth = font.lfHeight
+font.lfWeight = 150
+font.lfItalic = 1
+font.lfUnderline = 1
+hf = win32gui.CreateFontIndirect(font)
+win32gui.SelectObject(pDC, hf)
+win32gui.SetBkMode(pDC, win32con.TRANSPARENT)
+win32gui.SetTextColor(pDC, win32api.RGB(0, 255, 0))
+win32gui.DrawText(
+    pDC,
+    "Printed by Python!",
+    -1,
+    (0, 0, int(printerwidth * 0.9), int(printerheight * 0.9)),
+    win32con.DT_RIGHT | win32con.DT_BOTTOM | win32con.DT_SINGLELINE,
+)
+win32print.EndPage(pDC)
+win32print.EndDoc(pDC)
+
+win32print.ClosePrinter(p)
+win32gui.DeleteObject(dcBM)
+win32gui.DeleteObject(pcBM)
+win32gui.DeleteObject(hf)
+win32gui.DeleteDC(dDC)
+win32gui.DeleteDC(dcDC)
+win32gui.DeleteDC(pDC)
+win32gui.DeleteDC(pcDC)
diff --git a/lib/win32/Demos/rastest.py b/lib/win32/Demos/rastest.py
new file mode 100644
index 00000000..669a2a80
--- /dev/null
+++ b/lib/win32/Demos/rastest.py
@@ -0,0 +1,168 @@
+# rastest.py - test/demonstrate the win32ras module.
+# Much of the code here contributed by Jethro Wright.
+
+import os
+import sys
+
+import win32ras
+
+# Build a little dictionary of RAS states to decent strings.
+# eg win32ras.RASCS_OpenPort -> "OpenPort"
+stateMap = {}
+for name, val in list(win32ras.__dict__.items()):
+    if name[:6] == "RASCS_":
+        stateMap[val] = name[6:]
+
+# Use a lock so the callback can tell the main thread when it is finished.
+import win32event
+
+callbackEvent = win32event.CreateEvent(None, 0, 0, None)
+
+
+def Callback(hras, msg, state, error, exterror):
+    #       print "Callback called with ", hras, msg, state, error, exterror
+    stateName = stateMap.get(state, "Unknown state?")
+    print("Status is %s (%04lx), error code is %d" % (stateName, state, error))
+    finished = state in [win32ras.RASCS_Connected]
+    if finished:
+        win32event.SetEvent(callbackEvent)
+    if error != 0 or int(state) == win32ras.RASCS_Disconnected:
+        #       we know for sure this is a good place to hangup....
+        print("Detected call failure: %s" % win32ras.GetErrorString(error))
+        HangUp(hras)
+        win32event.SetEvent(callbackEvent)
+
+
+def ShowConnections():
+    print("All phone-book entries:")
+    for (name,) in win32ras.EnumEntries():
+        print(" ", name)
+    print("Current Connections:")
+    for con in win32ras.EnumConnections():
+        print(" ", con)
+
+
+def EditEntry(entryName):
+    try:
+        win32ras.EditPhonebookEntry(0, None, entryName)
+    except win32ras.error as xxx_todo_changeme:
+        (rc, function, msg) = xxx_todo_changeme.args
+        print("Can not edit/find the RAS entry -", msg)
+
+
+def HangUp(hras):
+    #       trap potential, irrelevant errors from win32ras....
+    try:
+        win32ras.HangUp(hras)
+    except:
+        print("Tried to hang up gracefully on error, but didn't work....")
+    return None
+
+
+def Connect(entryName, bUseCallback):
+    if bUseCallback:
+        theCallback = Callback
+        win32event.ResetEvent(callbackEvent)
+    else:
+        theCallback = None
+    #       in order to *use* the username/password of a particular dun entry, one must
+    #       explicitly get those params under win95....
+    try:
+        dp, b = win32ras.GetEntryDialParams(None, entryName)
+    except:
+        print("Couldn't find DUN entry: %s" % entryName)
+    else:
+        hras, rc = win32ras.Dial(
+            None, None, (entryName, "", "", dp[3], dp[4], ""), theCallback
+        )
+        #       hras, rc = win32ras.Dial(None, None, (entryName, ),theCallback)
+        #       print hras, rc
+        if not bUseCallback and rc != 0:
+            print("Could not dial the RAS connection:", win32ras.GetErrorString(rc))
+            hras = HangUp(hras)
+        #       don't wait here if there's no need to....
+        elif (
+            bUseCallback
+            and win32event.WaitForSingleObject(callbackEvent, 60000)
+            != win32event.WAIT_OBJECT_0
+        ):
+            print("Gave up waiting for the process to complete!")
+            #       sdk docs state one must explcitly hangup, even if there's an error....
+            try:
+                cs = win32ras.GetConnectStatus(hras)
+            except:
+                #       on error, attempt a hang up anyway....
+                hras = HangUp(hras)
+            else:
+                if int(cs[0]) == win32ras.RASCS_Disconnected:
+                    hras = HangUp(hras)
+    return hras, rc
+
+
+def Disconnect(rasEntry):
+    # Need to find the entry
+    name = rasEntry.lower()
+    for hcon, entryName, devName, devType in win32ras.EnumConnections():
+        if entryName.lower() == name:
+            win32ras.HangUp(hcon)
+            print("Disconnected from", rasEntry)
+            break
+    else:
+        print("Could not find an open connection to", entryName)
+
+
+usage = """
+Usage: %s [-s] [-l] [-c connection] [-d connection]
+-l : List phone-book entries and current connections.
+-s : Show status while connecting/disconnecting (uses callbacks)
+-c : Connect to the specified phonebook name.
+-d : Disconnect from the specified phonebook name.
+-e : Edit the specified phonebook entry.
+"""
+
+
+def main():
+    import getopt
+
+    try:
+        opts, args = getopt.getopt(sys.argv[1:], "slc:d:e:")
+    except getopt.error as why:
+        print(why)
+        print(
+            usage
+            % (
+                os.path.basename(
+                    sys.argv[0],
+                )
+            )
+        )
+        return
+
+    bCallback = 0
+    if args or not opts:
+        print(
+            usage
+            % (
+                os.path.basename(
+                    sys.argv[0],
+                )
+            )
+        )
+        return
+    for opt, val in opts:
+        if opt == "-s":
+            bCallback = 1
+        if opt == "-l":
+            ShowConnections()
+        if opt == "-c":
+            hras, rc = Connect(val, bCallback)
+            if hras != None:
+                print("hras: 0x%8lx, rc: 0x%04x" % (hras, rc))
+        if opt == "-d":
+            Disconnect(val)
+        if opt == "-e":
+            EditEntry(val)
+
+
+if __name__ == "__main__":
+    main()
diff --git a/lib/win32/Demos/security/GetTokenInformation.py b/lib/win32/Demos/security/GetTokenInformation.py
new file mode 100644
index 00000000..192c549e
--- /dev/null
+++ b/lib/win32/Demos/security/GetTokenInformation.py
@@ -0,0 +1,110 @@
+""" Lists various types of information about current user's access token,
+    including UAC status on Vista
+"""
+
+import pywintypes
+import win32api
+import win32con
+import win32security
+import winerror
+from security_enums import (
+    SECURITY_IMPERSONATION_LEVEL,
+    TOKEN_ELEVATION_TYPE,
+    TOKEN_GROUP_ATTRIBUTES,
+    TOKEN_PRIVILEGE_ATTRIBUTES,
+    TOKEN_TYPE,
+)
+
+
+def dump_token(th):
+    token_type = win32security.GetTokenInformation(th, win32security.TokenType)
+    print("TokenType:", token_type, TOKEN_TYPE.lookup_name(token_type))
+    if token_type == win32security.TokenImpersonation:
+        imp_lvl = win32security.GetTokenInformation(
+            th, win32security.TokenImpersonationLevel
+        )
+        print(
+            "TokenImpersonationLevel:",
+            imp_lvl,
+            SECURITY_IMPERSONATION_LEVEL.lookup_name(imp_lvl),
+        )
+
+    print(
+        "TokenSessionId:",
+        win32security.GetTokenInformation(th, win32security.TokenSessionId),
+    )
+
+    privs = win32security.GetTokenInformation(th, win32security.TokenPrivileges)
+    print("TokenPrivileges:")
+    for priv_luid, priv_flags in privs:
+        flag_names, unk = TOKEN_PRIVILEGE_ATTRIBUTES.lookup_flags(priv_flags)
+        flag_desc = " ".join(flag_names)
+        if unk:
+            flag_desc += "(" + str(unk) + ")"
+
+        priv_name = win32security.LookupPrivilegeName("", priv_luid)
+        priv_desc = win32security.LookupPrivilegeDisplayName("", priv_name)
+        print("\t", priv_name, priv_desc, priv_flags, flag_desc)
+
+    print("TokenGroups:")
+    groups = win32security.GetTokenInformation(th, win32security.TokenGroups)
+    for group_sid, group_attr in groups:
+        flag_names, unk = TOKEN_GROUP_ATTRIBUTES.lookup_flags(group_attr)
+        flag_desc = " ".join(flag_names)
+        if unk:
+            flag_desc += "(" + str(unk) + ")"
+        if group_attr & TOKEN_GROUP_ATTRIBUTES.SE_GROUP_LOGON_ID:
+            sid_desc = "Logon sid"
+        else:
+            sid_desc = win32security.LookupAccountSid("", group_sid)
+        print("\t", group_sid, sid_desc, group_attr, flag_desc)
+
+    ## Vista token information types, will throw (87, 'GetTokenInformation', 'The parameter is incorrect.') on earier OS
+    try:
+        is_elevated = win32security.GetTokenInformation(
+            th, win32security.TokenElevation
+        )
+        print("TokenElevation:", is_elevated)
+    except pywintypes.error as details:
+        if details.winerror != winerror.ERROR_INVALID_PARAMETER:
+            raise
+        return None
+    print(
+        "TokenHasRestrictions:",
+        win32security.GetTokenInformation(th, win32security.TokenHasRestrictions),
+    )
+    print(
+        "TokenMandatoryPolicy",
+        win32security.GetTokenInformation(th, win32security.TokenMandatoryPolicy),
+    )
+    print(
+        "TokenVirtualizationAllowed:",
+        win32security.GetTokenInformation(th, win32security.TokenVirtualizationAllowed),
+    )
+    print(
+        "TokenVirtualizationEnabled:",
+        win32security.GetTokenInformation(th, win32security.TokenVirtualizationEnabled),
+    )
+
+    elevation_type = win32security.GetTokenInformation(
+        th, win32security.TokenElevationType
+    )
+    print(
+        "TokenElevationType:",
+        elevation_type,
+        TOKEN_ELEVATION_TYPE.lookup_name(elevation_type),
+    )
+    if elevation_type != win32security.TokenElevationTypeDefault:
+        lt = win32security.GetTokenInformation(th, win32security.TokenLinkedToken)
+        print("TokenLinkedToken:", lt)
+    else:
+        lt = None
+    return lt
+
+
+ph = win32api.GetCurrentProcess()
+th = win32security.OpenProcessToken(ph, win32con.MAXIMUM_ALLOWED)
+lt = dump_token(th)
+if lt:
+    print("\n\nlinked token info:")
+    dump_token(lt)
diff --git a/lib/win32/Demos/security/account_rights.py b/lib/win32/Demos/security/account_rights.py
new file mode 100644
index 00000000..357b789a
--- /dev/null
+++ b/lib/win32/Demos/security/account_rights.py
@@ -0,0 +1,51 @@
+import ntsecuritycon
+import win32api
+import win32con
+import win32file
+import win32security
+from security_enums import ACCESS_MODE, ACE_FLAGS, TRUSTEE_FORM, TRUSTEE_TYPE
+
+new_privs = (
+    (
+        win32security.LookupPrivilegeValue("", ntsecuritycon.SE_SECURITY_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", ntsecuritycon.SE_CREATE_PERMANENT_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", "SeEnableDelegationPrivilege"),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),  ##doesn't seem to be in ntsecuritycon.py ?
+)
+
+ph = win32api.GetCurrentProcess()
+th = win32security.OpenProcessToken(
+    ph, win32security.TOKEN_ALL_ACCESS
+)  ##win32con.TOKEN_ADJUST_PRIVILEGES)
+win32security.AdjustTokenPrivileges(th, 0, new_privs)
+
+policy_handle = win32security.GetPolicyHandle("", win32security.POLICY_ALL_ACCESS)
+tmp_sid = win32security.LookupAccountName("", "tmp")[0]
+
+privs = [
+    ntsecuritycon.SE_DEBUG_NAME,
+    ntsecuritycon.SE_TCB_NAME,
+    ntsecuritycon.SE_RESTORE_NAME,
+    ntsecuritycon.SE_REMOTE_SHUTDOWN_NAME,
+]
+win32security.LsaAddAccountRights(policy_handle, tmp_sid, privs)
+
+privlist = win32security.LsaEnumerateAccountRights(policy_handle, tmp_sid)
+for priv in privlist:
+    print(priv)
+
+privs = [ntsecuritycon.SE_DEBUG_NAME, ntsecuritycon.SE_TCB_NAME]
+win32security.LsaRemoveAccountRights(policy_handle, tmp_sid, 0, privs)
+
+privlist = win32security.LsaEnumerateAccountRights(policy_handle, tmp_sid)
+for priv in privlist:
+    print(priv)
+
+win32security.LsaClose(policy_handle)
diff --git a/lib/win32/Demos/security/explicit_entries.py b/lib/win32/Demos/security/explicit_entries.py
new file mode 100644
index 00000000..b04f4517
--- /dev/null
+++ b/lib/win32/Demos/security/explicit_entries.py
@@ -0,0 +1,171 @@
+import os
+
+import ntsecuritycon
+import win32api
+import win32con
+import win32file
+import win32security
+from security_enums import ACCESS_MODE, ACE_FLAGS, TRUSTEE_FORM, TRUSTEE_TYPE
+
+fname = os.path.join(win32api.GetTempPath(), "win32security_test.txt")
+f = open(fname, "w")
+f.write("Hello from Python\n")
+f.close()
+print("Testing on file", fname)
+
+new_privs = (
+    (
+        win32security.LookupPrivilegeValue("", ntsecuritycon.SE_SECURITY_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", ntsecuritycon.SE_SHUTDOWN_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", ntsecuritycon.SE_RESTORE_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", ntsecuritycon.SE_TAKE_OWNERSHIP_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", ntsecuritycon.SE_CREATE_PERMANENT_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", "SeEnableDelegationPrivilege"),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),  ##doesn't seem to be in ntsecuritycon.py ?
+)
+
+ph = win32api.GetCurrentProcess()
+th = win32security.OpenProcessToken(
+    ph, win32security.TOKEN_ALL_ACCESS
+)  ##win32con.TOKEN_ADJUST_PRIVILEGES)
+win32security.AdjustTokenPrivileges(th, 0, new_privs)
+
+all_security_info = (
+    win32security.OWNER_SECURITY_INFORMATION
+    | win32security.GROUP_SECURITY_INFORMATION
+    | win32security.DACL_SECURITY_INFORMATION
+    | win32security.SACL_SECURITY_INFORMATION
+)
+
+sd = win32security.GetFileSecurity(fname, all_security_info)
+
+old_sacl = sd.GetSecurityDescriptorSacl()
+if old_sacl == None:
+    old_sacl = win32security.ACL()
+old_dacl = sd.GetSecurityDescriptorDacl()
+if old_dacl == None:
+    old_dacl = win32security.ACL()
+
+my_sid = win32security.GetTokenInformation(th, ntsecuritycon.TokenUser)[0]
+tmp_sid = win32security.LookupAccountName("", "tmp")[0]
+pwr_sid = win32security.LookupAccountName("", "Power Users")[0]
+
+
+## MultipleTrustee,MultipleTrusteeOperation,TrusteeForm,TrusteeType,Identifier
+## first two are ignored
+my_trustee = {}
+my_trustee["MultipleTrustee"] = None
+my_trustee["MultipleTrusteeOperation"] = 0
+my_trustee["TrusteeForm"] = TRUSTEE_FORM.TRUSTEE_IS_SID
+my_trustee["TrusteeType"] = TRUSTEE_TYPE.TRUSTEE_IS_USER
+my_trustee["Identifier"] = my_sid
+
+tmp_trustee = {}
+tmp_trustee["MultipleTrustee"] = None
+tmp_trustee["MultipleTrusteeOperation"] = 0
+tmp_trustee["TrusteeForm"] = TRUSTEE_FORM.TRUSTEE_IS_NAME
+tmp_trustee["TrusteeType"] = TRUSTEE_TYPE.TRUSTEE_IS_USER
+tmp_trustee["Identifier"] = "rupole\\tmp"
+
+pwr_trustee = {}
+pwr_trustee["MultipleTrustee"] = None
+pwr_trustee["MultipleTrusteeOperation"] = 0
+pwr_trustee["TrusteeForm"] = TRUSTEE_FORM.TRUSTEE_IS_SID
+pwr_trustee["TrusteeType"] = TRUSTEE_TYPE.TRUSTEE_IS_USER
+pwr_trustee["Identifier"] = pwr_sid
+
+expl_list = []
+expl_list.append(
+    {
+        "Trustee": my_trustee,
+        "Inheritance": ACE_FLAGS.NO_INHERITANCE,
+        "AccessMode": ACCESS_MODE.SET_AUDIT_SUCCESS,  ##|ACCESS_MODE.SET_AUDIT_FAILURE,
+        "AccessPermissions": win32con.GENERIC_ALL,
+    }
+)
+
+expl_list.append(
+    {
+        "Trustee": my_trustee,
+        "Inheritance": ACE_FLAGS.NO_INHERITANCE,
+        "AccessMode": ACCESS_MODE.SET_AUDIT_FAILURE,
+        "AccessPermissions": win32con.GENERIC_ALL,
+    }
+)
+
+expl_list.append(
+    {
+        "Trustee": tmp_trustee,
+        "Inheritance": ACE_FLAGS.NO_INHERITANCE,
+        "AccessMode": ACCESS_MODE.SET_AUDIT_SUCCESS,
+        "AccessPermissions": win32con.GENERIC_ALL,
+    }
+)
+
+expl_list.append(
+    {
+        "Trustee": tmp_trustee,
+        "Inheritance": ACE_FLAGS.NO_INHERITANCE,
+        "AccessMode": ACCESS_MODE.SET_AUDIT_FAILURE,
+        "AccessPermissions": win32con.GENERIC_ALL,
+    }
+)
+old_sacl.SetEntriesInAcl(expl_list)
+
+expl_list = []
+expl_list.append(
+    {
+        "Trustee": tmp_trustee,
+        "Inheritance": ACE_FLAGS.NO_INHERITANCE,
+        "AccessMode": ACCESS_MODE.DENY_ACCESS,
+        "AccessPermissions": win32con.DELETE,
+    }
+)
+
+expl_list.append(
+    {
+        "Trustee": tmp_trustee,
+        "Inheritance": ACE_FLAGS.NO_INHERITANCE,
+        "AccessMode": ACCESS_MODE.GRANT_ACCESS,
+        "AccessPermissions": win32con.WRITE_OWNER,
+    }
+)
+expl_list.append(
+    {
+        "Trustee": pwr_trustee,
+        "Inheritance": ACE_FLAGS.NO_INHERITANCE,
+        "AccessMode": ACCESS_MODE.GRANT_ACCESS,
+        "AccessPermissions": win32con.GENERIC_READ,
+    }
+)
+expl_list.append(
+    {
+        "Trustee": my_trustee,
+        "Inheritance": ACE_FLAGS.NO_INHERITANCE,
+        "AccessMode": ACCESS_MODE.GRANT_ACCESS,
+        "AccessPermissions": win32con.GENERIC_ALL,
+    }
+)
+
+old_dacl.SetEntriesInAcl(expl_list)
+sd.SetSecurityDescriptorSacl(1, old_sacl, 1)
+sd.SetSecurityDescriptorDacl(1, old_dacl, 1)
+sd.SetSecurityDescriptorOwner(pwr_sid, 1)
+
+win32security.SetFileSecurity(fname, all_security_info, sd)
diff --git a/lib/win32/Demos/security/get_policy_info.py b/lib/win32/Demos/security/get_policy_info.py
new file mode 100644
index 00000000..1eba9cd0
--- /dev/null
+++ b/lib/win32/Demos/security/get_policy_info.py
@@ -0,0 +1,42 @@
+import ntsecuritycon
+import win32api
+import win32file
+import win32security
+
+policy_handle = win32security.GetPolicyHandle("rupole", win32security.POLICY_ALL_ACCESS)
+
+## mod_nbr, mod_time = win32security.LsaQueryInformationPolicy(policy_handle,win32security.PolicyModificationInformation)
+## print mod_nbr, mod_time
+
+(
+    domain_name,
+    dns_domain_name,
+    dns_forest_name,
+    domain_guid,
+    domain_sid,
+) = win32security.LsaQueryInformationPolicy(
+    policy_handle, win32security.PolicyDnsDomainInformation
+)
+print(domain_name, dns_domain_name, dns_forest_name, domain_guid, domain_sid)
+
+event_audit_info = win32security.LsaQueryInformationPolicy(
+    policy_handle, win32security.PolicyAuditEventsInformation
+)
+print(event_audit_info)
+
+domain_name, sid = win32security.LsaQueryInformationPolicy(
+    policy_handle, win32security.PolicyPrimaryDomainInformation
+)
+print(domain_name, sid)
+
+domain_name, sid = win32security.LsaQueryInformationPolicy(
+    policy_handle, win32security.PolicyAccountDomainInformation
+)
+print(domain_name, sid)
+
+server_role = win32security.LsaQueryInformationPolicy(
+    policy_handle, win32security.PolicyLsaServerRoleInformation
+)
+print("server role: ", server_role)
+
+win32security.LsaClose(policy_handle)
diff --git a/lib/win32/Demos/security/list_rights.py b/lib/win32/Demos/security/list_rights.py
new file mode 100644
index 00000000..780008a2
--- /dev/null
+++ b/lib/win32/Demos/security/list_rights.py
@@ -0,0 +1,37 @@
+import ntsecuritycon
+import win32api
+import win32con
+import win32file
+import win32security
+from security_enums import ACCESS_MODE, ACE_FLAGS, TRUSTEE_FORM, TRUSTEE_TYPE
+
+new_privs = (
+    (
+        win32security.LookupPrivilegeValue("", ntsecuritycon.SE_SECURITY_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", ntsecuritycon.SE_CREATE_PERMANENT_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", "SeEnableDelegationPrivilege"),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),  ##doesn't seem to be in ntsecuritycon.py ?
+)
+
+ph = win32api.GetCurrentProcess()
+th = win32security.OpenProcessToken(
+    ph, win32security.TOKEN_ALL_ACCESS
+)  ##win32con.TOKEN_ADJUST_PRIVILEGES)
+win32security.AdjustTokenPrivileges(th, 0, new_privs)
+
+policy_handle = win32security.GetPolicyHandle("", win32security.POLICY_ALL_ACCESS)
+
+sidlist = win32security.LsaEnumerateAccountsWithUserRight(
+    policy_handle, ntsecuritycon.SE_RESTORE_NAME
+)
+for sid in sidlist:
+    print(win32security.LookupAccountSid("", sid))
+
+win32security.LsaClose(policy_handle)
diff --git a/lib/win32/Demos/security/localized_names.py b/lib/win32/Demos/security/localized_names.py
new file mode 100644
index 00000000..30a0bde6
--- /dev/null
+++ b/lib/win32/Demos/security/localized_names.py
@@ -0,0 +1,65 @@
+# A Python port of the MS knowledge base article Q157234
+# "How to deal with localized and renamed user and group names"
+# http://support.microsoft.com/default.aspx?kbid=157234
+
+import sys
+
+import pywintypes
+from ntsecuritycon import *
+from win32net import NetUserModalsGet
+from win32security import LookupAccountSid
+
+
+def LookupAliasFromRid(TargetComputer, Rid):
+    # Sid is the same regardless of machine, since the well-known
+    # BUILTIN domain is referenced.
+    sid = pywintypes.SID()
+    sid.Initialize(SECURITY_NT_AUTHORITY, 2)
+
+    for i, r in enumerate((SECURITY_BUILTIN_DOMAIN_RID, Rid)):
+        sid.SetSubAuthority(i, r)
+
+    name, domain, typ = LookupAccountSid(TargetComputer, sid)
+    return name
+
+
+def LookupUserGroupFromRid(TargetComputer, Rid):
+    # get the account domain Sid on the target machine
+    # note: if you were looking up multiple sids based on the same
+    # account domain, only need to call this once.
+    umi2 = NetUserModalsGet(TargetComputer, 2)
+    domain_sid = umi2["domain_id"]
+
+    SubAuthorityCount = domain_sid.GetSubAuthorityCount()
+
+    # create and init new sid with acct domain Sid + acct Rid
+    sid = pywintypes.SID()
+    sid.Initialize(domain_sid.GetSidIdentifierAuthority(), SubAuthorityCount + 1)
+
+    # copy existing subauthorities from account domain Sid into
+    # new Sid
+    for i in range(SubAuthorityCount):
+        sid.SetSubAuthority(i, domain_sid.GetSubAuthority(i))
+
+    # append Rid to new Sid
+    sid.SetSubAuthority(SubAuthorityCount, Rid)
+
+    name, domain, typ = LookupAccountSid(TargetComputer, sid)
+    return name
+
+
+def main():
+    if len(sys.argv) == 2:
+        targetComputer = sys.argv[1]
+    else:
+        targetComputer = None
+
+    name = LookupUserGroupFromRid(targetComputer, DOMAIN_USER_RID_ADMIN)
+    print("'Administrator' user name = %s" % (name,))
+
+    name = LookupAliasFromRid(targetComputer, DOMAIN_ALIAS_RID_ADMINS)
+    print("'Administrators' local group/alias name = %s" % (name,))
+
+
+if __name__ == "__main__":
+    main()
diff --git a/lib/win32/Demos/security/lsaregevent.py b/lib/win32/Demos/security/lsaregevent.py
new file mode 100644
index 00000000..38e7adc9
--- /dev/null
+++ b/lib/win32/Demos/security/lsaregevent.py
@@ -0,0 +1,14 @@
+import win32event
+import win32security
+
+evt = win32event.CreateEvent(None, 0, 0, None)
+win32security.LsaRegisterPolicyChangeNotification(
+    win32security.PolicyNotifyAuditEventsInformation, evt
+)
+print("Waiting for you change Audit policy in Management console ...")
+ret_code = win32event.WaitForSingleObject(evt, 1000000000)
+## should come back when you change Audit policy in Management console ...
+print(ret_code)
+win32security.LsaUnregisterPolicyChangeNotification(
+    win32security.PolicyNotifyAuditEventsInformation, evt
+)
diff --git a/lib/win32/Demos/security/lsastore.py b/lib/win32/Demos/security/lsastore.py
new file mode 100644
index 00000000..dd9ff384
--- /dev/null
+++ b/lib/win32/Demos/security/lsastore.py
@@ -0,0 +1,12 @@
+import win32security
+
+policy_handle = win32security.GetPolicyHandle("", win32security.POLICY_ALL_ACCESS)
+privatedata = "some sensitive data"
+keyname = "tmp"
+win32security.LsaStorePrivateData(policy_handle, keyname, privatedata)
+retrieveddata = win32security.LsaRetrievePrivateData(policy_handle, keyname)
+assert retrieveddata == privatedata
+
+## passing None deletes key
+win32security.LsaStorePrivateData(policy_handle, keyname, None)
+win32security.LsaClose(policy_handle)
diff --git a/lib/win32/Demos/security/query_information.py b/lib/win32/Demos/security/query_information.py
new file mode 100644
index 00000000..9fa3e4a9
--- /dev/null
+++ b/lib/win32/Demos/security/query_information.py
@@ -0,0 +1,25 @@
+import win32api
+import win32security
+import winerror
+from ntsecuritycon import *
+
+
+# This is a Python implementation of win32api.GetDomainName()
+def GetDomainName():
+    try:
+        tok = win32security.OpenThreadToken(win32api.GetCurrentThread(), TOKEN_QUERY, 1)
+    except win32api.error as details:
+        if details[0] != winerror.ERROR_NO_TOKEN:
+            raise
+        # attempt to open the process token, since no thread token
+        # exists
+        tok = win32security.OpenProcessToken(win32api.GetCurrentProcess(), TOKEN_QUERY)
+    sid, attr = win32security.GetTokenInformation(tok, TokenUser)
+    win32api.CloseHandle(tok)
+
+    name, dom, typ = win32security.LookupAccountSid(None, sid)
+    return dom
+
+
+if __name__ == "__main__":
+    print("Domain name is", GetDomainName())
diff --git a/lib/win32/Demos/security/regsave_sa.py b/lib/win32/Demos/security/regsave_sa.py
new file mode 100644
index 00000000..29a6ac10
--- /dev/null
+++ b/lib/win32/Demos/security/regsave_sa.py
@@ -0,0 +1,61 @@
+fname = "h:\\tmp.reg"
+
+import os
+
+import ntsecuritycon
+import pywintypes
+import win32api
+import win32con
+import win32security
+
+## regsave will not overwrite a file
+if os.path.isfile(fname):
+    os.remove(fname)
+
+new_privs = (
+    (
+        win32security.LookupPrivilegeValue("", ntsecuritycon.SE_SECURITY_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", ntsecuritycon.SE_TCB_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", ntsecuritycon.SE_BACKUP_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", ntsecuritycon.SE_RESTORE_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+)
+ph = win32api.GetCurrentProcess()
+th = win32security.OpenProcessToken(
+    ph, win32security.TOKEN_ALL_ACCESS | win32con.TOKEN_ADJUST_PRIVILEGES
+)
+win32security.AdjustTokenPrivileges(th, 0, new_privs)
+my_sid = win32security.GetTokenInformation(th, ntsecuritycon.TokenUser)[0]
+
+hklm = win32api.RegOpenKey(
+    win32con.HKEY_LOCAL_MACHINE, None, 0, win32con.KEY_ALL_ACCESS
+)
+skey = win32api.RegOpenKey(hklm, "SYSTEM", 0, win32con.KEY_ALL_ACCESS)
+
+sa = pywintypes.SECURITY_ATTRIBUTES()
+sd = pywintypes.SECURITY_DESCRIPTOR()
+sa.SECURITY_DESCRIPTOR = sd
+acl = pywintypes.ACL()
+
+pwr_sid = win32security.LookupAccountName("", "Power Users")[0]
+acl.AddAccessAllowedAce(
+    win32con.ACL_REVISION,
+    win32con.GENERIC_READ | win32con.ACCESS_SYSTEM_SECURITY,
+    my_sid,
+)
+sd.SetSecurityDescriptorDacl(1, acl, 0)
+sd.SetSecurityDescriptorOwner(pwr_sid, 0)
+sa.bInheritHandle = 1
+assert sa.SECURITY_DESCRIPTOR is sd
+
+win32api.RegSaveKey(skey, fname, sa)
diff --git a/lib/win32/Demos/security/regsecurity.py b/lib/win32/Demos/security/regsecurity.py
new file mode 100644
index 00000000..3bac65c0
--- /dev/null
+++ b/lib/win32/Demos/security/regsecurity.py
@@ -0,0 +1,36 @@
+import ntsecuritycon
+import win32api
+import win32con
+import win32security
+
+new_privs = (
+    (
+        win32security.LookupPrivilegeValue("", ntsecuritycon.SE_SECURITY_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", ntsecuritycon.SE_TCB_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+)
+ph = win32api.GetCurrentProcess()
+th = win32security.OpenProcessToken(
+    ph, win32security.TOKEN_ALL_ACCESS | win32con.TOKEN_ADJUST_PRIVILEGES
+)
+
+win32security.AdjustTokenPrivileges(th, 0, new_privs)
+hkey = win32api.RegOpenKey(
+    win32con.HKEY_LOCAL_MACHINE, None, 0, win32con.KEY_ALL_ACCESS
+)
+win32api.RegCreateKey(hkey, "SYSTEM\\NOTMP")
+notmpkey = win32api.RegOpenKey(
+    hkey, "SYSTEM\\notmp", 0, win32con.ACCESS_SYSTEM_SECURITY
+)
+
+tmp_sid = win32security.LookupAccountName("", "tmp")[0]
+sacl = win32security.ACL()
+sacl.AddAuditAccessAce(win32security.ACL_REVISION, win32con.GENERIC_ALL, tmp_sid, 1, 1)
+
+sd = win32security.SECURITY_DESCRIPTOR()
+sd.SetSecurityDescriptorSacl(1, sacl, 1)
+win32api.RegSetKeySecurity(notmpkey, win32con.SACL_SECURITY_INFORMATION, sd)
diff --git a/lib/win32/Demos/security/sa_inherit.py b/lib/win32/Demos/security/sa_inherit.py
new file mode 100644
index 00000000..a2855e50
--- /dev/null
+++ b/lib/win32/Demos/security/sa_inherit.py
@@ -0,0 +1,8 @@
+import pywintypes
+import win32security
+
+sa = pywintypes.SECURITY_ATTRIBUTES()
+tmp_sid = win32security.LookupAccountName("", "tmp")[0]
+sa.SetSecurityDescriptorOwner(tmp_sid, 0)
+sid = sa.SECURITY_DESCRIPTOR.GetSecurityDescriptorOwner()
+print(win32security.LookupAccountSid("", sid))
diff --git a/lib/win32/Demos/security/security_enums.py b/lib/win32/Demos/security/security_enums.py
new file mode 100644
index 00000000..ab3cc6d3
--- /dev/null
+++ b/lib/win32/Demos/security/security_enums.py
@@ -0,0 +1,336 @@
+import ntsecuritycon
+import win32security
+import winnt
+
+
+class Enum:
+    def __init__(self, *const_names):
+        """Accepts variable number of constant names that can be found in either
+        win32security, ntsecuritycon, or winnt."""
+        for const_name in const_names:
+            try:
+                const_val = getattr(win32security, const_name)
+            except AttributeError:
+                try:
+                    const_val = getattr(ntsecuritycon, const_name)
+                except AttributeError:
+                    try:
+                        const_val = getattr(winnt, const_name)
+                    except AttributeError:
+                        raise AttributeError(
+                            'Constant "%s" not found in win32security, ntsecuritycon, or winnt.'
+                            % const_name
+                        )
+            setattr(self, const_name, const_val)
+
+    def lookup_name(self, const_val):
+        """Looks up the name of a particular value."""
+        for k, v in self.__dict__.items():
+            if v == const_val:
+                return k
+        raise AttributeError("Value %s not found in enum" % const_val)
+
+    def lookup_flags(self, flags):
+        """Returns the names of all recognized flags in input, and any flags not found in the enum."""
+        flag_names = []
+        unknown_flags = flags
+        for k, v in self.__dict__.items():
+            if flags & v == v:
+                flag_names.append(k)
+                unknown_flags = unknown_flags & ~v
+        return flag_names, unknown_flags
+
+
+TOKEN_INFORMATION_CLASS = Enum(
+    "TokenUser",
+    "TokenGroups",
+    "TokenPrivileges",
+    "TokenOwner",
+    "TokenPrimaryGroup",
+    "TokenDefaultDacl",
+    "TokenSource",
+    "TokenType",
+    "TokenImpersonationLevel",
+    "TokenStatistics",
+    "TokenRestrictedSids",
+    "TokenSessionId",
+    "TokenGroupsAndPrivileges",
+    "TokenSessionReference",
+    "TokenSandBoxInert",
+    "TokenAuditPolicy",
+    "TokenOrigin",
+    "TokenElevationType",
+    "TokenLinkedToken",
+    "TokenElevation",
+    "TokenHasRestrictions",
+    "TokenAccessInformation",
+    "TokenVirtualizationAllowed",
+    "TokenVirtualizationEnabled",
+    "TokenIntegrityLevel",
+    "TokenUIAccess",
+    "TokenMandatoryPolicy",
+    "TokenLogonSid",
+)
+
+TOKEN_TYPE = Enum("TokenPrimary", "TokenImpersonation")
+
+TOKEN_ELEVATION_TYPE = Enum(
+    "TokenElevationTypeDefault", "TokenElevationTypeFull", "TokenElevationTypeLimited"
+)
+
+POLICY_AUDIT_EVENT_TYPE = Enum(
+    "AuditCategorySystem",
+    "AuditCategoryLogon",
+    "AuditCategoryObjectAccess",
+    "AuditCategoryPrivilegeUse",
+    "AuditCategoryDetailedTracking",
+    "AuditCategoryPolicyChange",
+    "AuditCategoryAccountManagement",
+    "AuditCategoryDirectoryServiceAccess",
+    "AuditCategoryAccountLogon",
+)
+
+POLICY_INFORMATION_CLASS = Enum(
+    "PolicyAuditLogInformation",
+    "PolicyAuditEventsInformation",
+    "PolicyPrimaryDomainInformation",
+    "PolicyPdAccountInformation",
+    "PolicyAccountDomainInformation",
+    "PolicyLsaServerRoleInformation",
+    "PolicyReplicaSourceInformation",
+    "PolicyDefaultQuotaInformation",
+    "PolicyModificationInformation",
+    "PolicyAuditFullSetInformation",
+    "PolicyAuditFullQueryInformation",
+    "PolicyDnsDomainInformation",
+)
+
+POLICY_LSA_SERVER_ROLE = Enum("PolicyServerRoleBackup", "PolicyServerRolePrimary")
+
+## access modes for opening a policy handle - this is not a real enum
+POLICY_ACCESS_MODES = Enum(
+    "POLICY_VIEW_LOCAL_INFORMATION",
+    "POLICY_VIEW_AUDIT_INFORMATION",
+    "POLICY_GET_PRIVATE_INFORMATION",
+    "POLICY_TRUST_ADMIN",
+    "POLICY_CREATE_ACCOUNT",
+    "POLICY_CREATE_SECRET",
+    "POLICY_CREATE_PRIVILEGE",
+    "POLICY_SET_DEFAULT_QUOTA_LIMITS",
+    "POLICY_SET_AUDIT_REQUIREMENTS",
+    "POLICY_AUDIT_LOG_ADMIN",
+    "POLICY_SERVER_ADMIN",
+    "POLICY_LOOKUP_NAMES",
+    "POLICY_NOTIFICATION",
+    "POLICY_ALL_ACCESS",
+    "POLICY_READ",
+    "POLICY_WRITE",
+    "POLICY_EXECUTE",
+)
+
+## EventAuditingOptions flags - not a real enum
+POLICY_AUDIT_EVENT_OPTIONS_FLAGS = Enum(
+    "POLICY_AUDIT_EVENT_UNCHANGED",
+    "POLICY_AUDIT_EVENT_SUCCESS",
+    "POLICY_AUDIT_EVENT_FAILURE",
+    "POLICY_AUDIT_EVENT_NONE",
+)
+
+# AceType in ACE_HEADER - not a real enum
+ACE_TYPE = Enum(
+    "ACCESS_MIN_MS_ACE_TYPE",
+    "ACCESS_ALLOWED_ACE_TYPE",
+    "ACCESS_DENIED_ACE_TYPE",
+    "SYSTEM_AUDIT_ACE_TYPE",
+    "SYSTEM_ALARM_ACE_TYPE",
+    "ACCESS_MAX_MS_V2_ACE_TYPE",
+    "ACCESS_ALLOWED_COMPOUND_ACE_TYPE",
+    "ACCESS_MAX_MS_V3_ACE_TYPE",
+    "ACCESS_MIN_MS_OBJECT_ACE_TYPE",
+    "ACCESS_ALLOWED_OBJECT_ACE_TYPE",
+    "ACCESS_DENIED_OBJECT_ACE_TYPE",
+    "SYSTEM_AUDIT_OBJECT_ACE_TYPE",
+    "SYSTEM_ALARM_OBJECT_ACE_TYPE",
+    "ACCESS_MAX_MS_OBJECT_ACE_TYPE",
+    "ACCESS_MAX_MS_V4_ACE_TYPE",
+    "ACCESS_MAX_MS_ACE_TYPE",
+    "ACCESS_ALLOWED_CALLBACK_ACE_TYPE",
+    "ACCESS_DENIED_CALLBACK_ACE_TYPE",
+    "ACCESS_ALLOWED_CALLBACK_OBJECT_ACE_TYPE",
+    "ACCESS_DENIED_CALLBACK_OBJECT_ACE_TYPE",
+    "SYSTEM_AUDIT_CALLBACK_ACE_TYPE",
+    "SYSTEM_ALARM_CALLBACK_ACE_TYPE",
+    "SYSTEM_AUDIT_CALLBACK_OBJECT_ACE_TYPE",
+    "SYSTEM_ALARM_CALLBACK_OBJECT_ACE_TYPE",
+    "SYSTEM_MANDATORY_LABEL_ACE_TYPE",
+    "ACCESS_MAX_MS_V5_ACE_TYPE",
+)
+
+# bit flags for AceFlags - not a real enum
+ACE_FLAGS = Enum(
+    "CONTAINER_INHERIT_ACE",
+    "FAILED_ACCESS_ACE_FLAG",
+    "INHERIT_ONLY_ACE",
+    "INHERITED_ACE",
+    "NO_PROPAGATE_INHERIT_ACE",
+    "OBJECT_INHERIT_ACE",
+    "SUCCESSFUL_ACCESS_ACE_FLAG",
+    "NO_INHERITANCE",
+    "SUB_CONTAINERS_AND_OBJECTS_INHERIT",
+    "SUB_CONTAINERS_ONLY_INHERIT",
+    "SUB_OBJECTS_ONLY_INHERIT",
+)
+
+# used in SetEntriesInAcl - very similar to ACE_TYPE
+ACCESS_MODE = Enum(
+    "NOT_USED_ACCESS",
+    "GRANT_ACCESS",
+    "SET_ACCESS",
+    "DENY_ACCESS",
+    "REVOKE_ACCESS",
+    "SET_AUDIT_SUCCESS",
+    "SET_AUDIT_FAILURE",
+)
+
+# Bit flags in PSECURITY_DESCRIPTOR->Control - not a real enum
+SECURITY_DESCRIPTOR_CONTROL_FLAGS = Enum(
+    "SE_DACL_AUTO_INHERITED",  ## win2k and up
+    "SE_SACL_AUTO_INHERITED",  ## win2k and up
+    "SE_DACL_PROTECTED",  ## win2k and up
+    "SE_SACL_PROTECTED",  ## win2k and up
+    "SE_DACL_DEFAULTED",
+    "SE_DACL_PRESENT",
+    "SE_GROUP_DEFAULTED",
+    "SE_OWNER_DEFAULTED",
+    "SE_SACL_PRESENT",
+    "SE_SELF_RELATIVE",
+    "SE_SACL_DEFAULTED",
+)
+
+# types of SID
+SID_NAME_USE = Enum(
+    "SidTypeUser",
+    "SidTypeGroup",
+    "SidTypeDomain",
+    "SidTypeAlias",
+    "SidTypeWellKnownGroup",
+    "SidTypeDeletedAccount",
+    "SidTypeInvalid",
+    "SidTypeUnknown",
+    "SidTypeComputer",
+    "SidTypeLabel",
+)
+
+## bit flags, not a real enum
+TOKEN_ACCESS_PRIVILEGES = Enum(
+    "TOKEN_ADJUST_DEFAULT",
+    "TOKEN_ADJUST_GROUPS",
+    "TOKEN_ADJUST_PRIVILEGES",
+    "TOKEN_ALL_ACCESS",
+    "TOKEN_ASSIGN_PRIMARY",
+    "TOKEN_DUPLICATE",
+    "TOKEN_EXECUTE",
+    "TOKEN_IMPERSONATE",
+    "TOKEN_QUERY",
+    "TOKEN_QUERY_SOURCE",
+    "TOKEN_READ",
+    "TOKEN_WRITE",
+)
+
+SECURITY_IMPERSONATION_LEVEL = Enum(
+    "SecurityAnonymous",
+    "SecurityIdentification",
+    "SecurityImpersonation",
+    "SecurityDelegation",
+)
+
+POLICY_SERVER_ENABLE_STATE = Enum("PolicyServerEnabled", "PolicyServerDisabled")
+
+POLICY_NOTIFICATION_INFORMATION_CLASS = Enum(
+    "PolicyNotifyAuditEventsInformation",
+    "PolicyNotifyAccountDomainInformation",
+    "PolicyNotifyServerRoleInformation",
+    "PolicyNotifyDnsDomainInformation",
+    "PolicyNotifyDomainEfsInformation",
+    "PolicyNotifyDomainKerberosTicketInformation",
+    "PolicyNotifyMachineAccountPasswordInformation",
+)
+
+TRUSTED_INFORMATION_CLASS = Enum(
+    "TrustedDomainNameInformation",
+    "TrustedControllersInformation",
+    "TrustedPosixOffsetInformation",
+    "TrustedPasswordInformation",
+    "TrustedDomainInformationBasic",
+    "TrustedDomainInformationEx",
+    "TrustedDomainAuthInformation",
+    "TrustedDomainFullInformation",
+    "TrustedDomainAuthInformationInternal",
+    "TrustedDomainFullInformationInternal",
+    "TrustedDomainInformationEx2Internal",
+    "TrustedDomainFullInformation2Internal",
+)
+
+TRUSTEE_FORM = Enum(
+    "TRUSTEE_IS_SID",
+    "TRUSTEE_IS_NAME",
+    "TRUSTEE_BAD_FORM",
+    "TRUSTEE_IS_OBJECTS_AND_SID",
+    "TRUSTEE_IS_OBJECTS_AND_NAME",
+)
+
+TRUSTEE_TYPE = Enum(
+    "TRUSTEE_IS_UNKNOWN",
+    "TRUSTEE_IS_USER",
+    "TRUSTEE_IS_GROUP",
+    "TRUSTEE_IS_DOMAIN",
+    "TRUSTEE_IS_ALIAS",
+    "TRUSTEE_IS_WELL_KNOWN_GROUP",
+    "TRUSTEE_IS_DELETED",
+    "TRUSTEE_IS_INVALID",
+    "TRUSTEE_IS_COMPUTER",
+)
+
+## SE_OBJECT_TYPE - securable objects
+SE_OBJECT_TYPE = Enum(
+    "SE_UNKNOWN_OBJECT_TYPE",
+    "SE_FILE_OBJECT",
+    "SE_SERVICE",
+    "SE_PRINTER",
+    "SE_REGISTRY_KEY",
+    "SE_LMSHARE",
+    "SE_KERNEL_OBJECT",
+    "SE_WINDOW_OBJECT",
+    "SE_DS_OBJECT",
+    "SE_DS_OBJECT_ALL",
+    "SE_PROVIDER_DEFINED_OBJECT",
+    "SE_WMIGUID_OBJECT",
+    "SE_REGISTRY_WOW64_32KEY",
+)
+
+PRIVILEGE_FLAGS = Enum(
+    "SE_PRIVILEGE_ENABLED_BY_DEFAULT",
+    "SE_PRIVILEGE_ENABLED",
+    "SE_PRIVILEGE_USED_FOR_ACCESS",
+)
+
+# Group flags used with TokenGroups
+TOKEN_GROUP_ATTRIBUTES = Enum(
+    "SE_GROUP_MANDATORY",
+    "SE_GROUP_ENABLED_BY_DEFAULT",
+    "SE_GROUP_ENABLED",
+    "SE_GROUP_OWNER",
+    "SE_GROUP_USE_FOR_DENY_ONLY",
+    "SE_GROUP_INTEGRITY",
+    "SE_GROUP_INTEGRITY_ENABLED",
+    "SE_GROUP_LOGON_ID",
+    "SE_GROUP_RESOURCE",
+)
+
+# Privilege flags returned by TokenPrivileges
+TOKEN_PRIVILEGE_ATTRIBUTES = Enum(
+    "SE_PRIVILEGE_ENABLED_BY_DEFAULT",
+    "SE_PRIVILEGE_ENABLED",
+    "SE_PRIVILEGE_REMOVED",
+    "SE_PRIVILEGE_USED_FOR_ACCESS",
+)
diff --git a/lib/win32/Demos/security/set_file_audit.py b/lib/win32/Demos/security/set_file_audit.py
new file mode 100644
index 00000000..324d7274
--- /dev/null
+++ b/lib/win32/Demos/security/set_file_audit.py
@@ -0,0 +1,107 @@
+import os
+
+import ntsecuritycon
+import win32api
+import win32con
+import win32file
+import win32security
+from win32security import (
+    ACL_REVISION_DS,
+    CONTAINER_INHERIT_ACE,
+    DACL_SECURITY_INFORMATION,
+    GROUP_SECURITY_INFORMATION,
+    OBJECT_INHERIT_ACE,
+    OWNER_SECURITY_INFORMATION,
+    PROTECTED_DACL_SECURITY_INFORMATION,
+    SACL_SECURITY_INFORMATION,
+    SE_FILE_OBJECT,
+)
+
+## SE_SECURITY_NAME needed to access SACL, SE_RESTORE_NAME needed to change owner to someone other than yourself
+new_privs = (
+    (
+        win32security.LookupPrivilegeValue("", ntsecuritycon.SE_SECURITY_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", ntsecuritycon.SE_RESTORE_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+)
+ph = win32api.GetCurrentProcess()
+th = win32security.OpenProcessToken(
+    ph, win32security.TOKEN_ALL_ACCESS | win32con.TOKEN_ADJUST_PRIVILEGES
+)
+modified_privs = win32security.AdjustTokenPrivileges(th, 0, new_privs)
+
+## look up a few sids that should be available on most systems
+my_sid = win32security.GetTokenInformation(th, ntsecuritycon.TokenUser)[0]
+pwr_sid = win32security.LookupAccountName("", "Power Users")[0]
+admin_sid = win32security.LookupAccountName("", "Administrators")[0]
+everyone_sid = win32security.LookupAccountName("", "EveryOne")[0]
+
+## create a dir and set security so Everyone has read permissions, and all files and subdirs inherit its ACLs
+temp_dir = win32api.GetTempPath()
+dir_name = win32api.GetTempFileName(temp_dir, "sfa")[0]
+os.remove(dir_name)
+os.mkdir(dir_name)
+dir_dacl = win32security.ACL()
+dir_dacl.AddAccessAllowedAceEx(
+    ACL_REVISION_DS,
+    CONTAINER_INHERIT_ACE | OBJECT_INHERIT_ACE,
+    win32con.GENERIC_READ,
+    everyone_sid,
+)
+## make sure current user has permissions on dir
+dir_dacl.AddAccessAllowedAceEx(
+    ACL_REVISION_DS,
+    CONTAINER_INHERIT_ACE | OBJECT_INHERIT_ACE,
+    win32con.GENERIC_ALL,
+    my_sid,
+)
+## keep dir from inheriting any permissions so it only has ACEs explicitely set here
+win32security.SetNamedSecurityInfo(
+    dir_name,
+    SE_FILE_OBJECT,
+    OWNER_SECURITY_INFORMATION
+    | GROUP_SECURITY_INFORMATION
+    | DACL_SECURITY_INFORMATION
+    | PROTECTED_DACL_SECURITY_INFORMATION,
+    pwr_sid,
+    pwr_sid,
+    dir_dacl,
+    None,
+)
+
+## Create a file in the dir and add some specific permissions to it
+fname = win32api.GetTempFileName(dir_name, "sfa")[0]
+print(fname)
+file_sd = win32security.GetNamedSecurityInfo(
+    fname, SE_FILE_OBJECT, DACL_SECURITY_INFORMATION | SACL_SECURITY_INFORMATION
+)
+file_dacl = file_sd.GetSecurityDescriptorDacl()
+file_sacl = file_sd.GetSecurityDescriptorSacl()
+
+if file_dacl is None:
+    file_dacl = win32security.ACL()
+if file_sacl is None:
+    file_sacl = win32security.ACL()
+
+file_dacl.AddAccessDeniedAce(file_dacl.GetAclRevision(), win32con.DELETE, admin_sid)
+file_dacl.AddAccessDeniedAce(file_dacl.GetAclRevision(), win32con.DELETE, my_sid)
+file_dacl.AddAccessAllowedAce(file_dacl.GetAclRevision(), win32con.GENERIC_ALL, pwr_sid)
+file_sacl.AddAuditAccessAce(
+    file_dacl.GetAclRevision(), win32con.GENERIC_ALL, my_sid, True, True
+)
+
+win32security.SetNamedSecurityInfo(
+    fname,
+    SE_FILE_OBJECT,
+    DACL_SECURITY_INFORMATION | SACL_SECURITY_INFORMATION,
+    None,
+    None,
+    file_dacl,
+    file_sacl,
+)
+
+win32security.AdjustTokenPrivileges(th, 0, modified_privs)
diff --git a/lib/win32/Demos/security/set_file_owner.py b/lib/win32/Demos/security/set_file_owner.py
new file mode 100644
index 00000000..5a384da0
--- /dev/null
+++ b/lib/win32/Demos/security/set_file_owner.py
@@ -0,0 +1,74 @@
+fname = r"h:\tmp.txt"
+
+import ntsecuritycon
+import win32api
+import win32con
+import win32file
+import win32security
+
+new_privs = (
+    (
+        win32security.LookupPrivilegeValue("", ntsecuritycon.SE_SECURITY_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", ntsecuritycon.SE_SHUTDOWN_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", ntsecuritycon.SE_TCB_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", ntsecuritycon.SE_RESTORE_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", ntsecuritycon.SE_TAKE_OWNERSHIP_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", ntsecuritycon.SE_CREATE_PERMANENT_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", "SeEnableDelegationPrivilege"),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),  ##doesn't seem to be in ntsecuritycon.py ?
+)
+
+ph = win32api.GetCurrentProcess()
+th = win32security.OpenProcessToken(
+    ph, win32security.TOKEN_ALL_ACCESS | win32con.TOKEN_ADJUST_PRIVILEGES
+)
+win32security.AdjustTokenPrivileges(th, 0, new_privs)
+
+all_security_info = (
+    win32security.OWNER_SECURITY_INFORMATION
+    | win32security.GROUP_SECURITY_INFORMATION
+    | win32security.DACL_SECURITY_INFORMATION
+    | win32security.SACL_SECURITY_INFORMATION
+)
+
+sd = win32security.GetFileSecurity(fname, all_security_info)
+old_dacl = sd.GetSecurityDescriptorDacl()
+old_sacl = sd.GetSecurityDescriptorSacl()
+old_group = sd.GetSecurityDescriptorGroup()
+
+new_sd = win32security.SECURITY_DESCRIPTOR()
+print(
+    "relative, valid, size: ",
+    new_sd.IsSelfRelative(),
+    new_sd.IsValid(),
+    new_sd.GetLength(),
+)
+
+my_sid = win32security.GetTokenInformation(th, ntsecuritycon.TokenUser)[0]
+tmp_sid = win32security.LookupAccountName("", "tmp")[0]
+
+new_sd.SetSecurityDescriptorSacl(1, old_sacl, 1)
+new_sd.SetSecurityDescriptorDacl(1, old_dacl, 1)
+new_sd.SetSecurityDescriptorOwner(tmp_sid, 0)
+new_sd.SetSecurityDescriptorGroup(old_group, 0)
+
+win32security.SetFileSecurity(fname, all_security_info, new_sd)
diff --git a/lib/win32/Demos/security/set_policy_info.py b/lib/win32/Demos/security/set_policy_info.py
new file mode 100644
index 00000000..5dd3cf81
--- /dev/null
+++ b/lib/win32/Demos/security/set_policy_info.py
@@ -0,0 +1,28 @@
+import ntsecuritycon
+import win32api
+import win32file
+import win32security
+
+policy_handle = win32security.GetPolicyHandle("rupole", win32security.POLICY_ALL_ACCESS)
+
+event_audit_info = win32security.LsaQueryInformationPolicy(
+    policy_handle, win32security.PolicyAuditEventsInformation
+)
+print(event_audit_info)
+
+new_audit_info = list(event_audit_info[1])
+new_audit_info[win32security.AuditCategoryPolicyChange] = (
+    win32security.POLICY_AUDIT_EVENT_SUCCESS | win32security.POLICY_AUDIT_EVENT_FAILURE
+)
+new_audit_info[win32security.AuditCategoryAccountLogon] = (
+    win32security.POLICY_AUDIT_EVENT_SUCCESS | win32security.POLICY_AUDIT_EVENT_FAILURE
+)
+new_audit_info[win32security.AuditCategoryLogon] = (
+    win32security.POLICY_AUDIT_EVENT_SUCCESS | win32security.POLICY_AUDIT_EVENT_FAILURE
+)
+
+win32security.LsaSetInformationPolicy(
+    policy_handle, win32security.PolicyAuditEventsInformation, (1, new_audit_info)
+)
+
+win32security.LsaClose(policy_handle)
diff --git a/lib/win32/Demos/security/setkernelobjectsecurity.py b/lib/win32/Demos/security/setkernelobjectsecurity.py
new file mode 100644
index 00000000..34c8f446
--- /dev/null
+++ b/lib/win32/Demos/security/setkernelobjectsecurity.py
@@ -0,0 +1,135 @@
+import win32api
+import win32con
+import win32process
+import win32security
+
+## You need SE_RESTORE_NAME to be able to set the owner of a security descriptor to anybody
+## other than yourself or your primary group.  Most admin logins don't have it by default, so
+## enabling it may fail
+new_privs = (
+    (
+        win32security.LookupPrivilegeValue("", win32security.SE_SECURITY_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", win32security.SE_TCB_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", win32security.SE_SHUTDOWN_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", win32security.SE_RESTORE_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", win32security.SE_TAKE_OWNERSHIP_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", win32security.SE_CREATE_PERMANENT_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", win32security.SE_ENABLE_DELEGATION_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", win32security.SE_CHANGE_NOTIFY_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", win32security.SE_DEBUG_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue(
+            "", win32security.SE_PROF_SINGLE_PROCESS_NAME
+        ),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", win32security.SE_SYSTEM_PROFILE_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", win32security.SE_LOCK_MEMORY_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+)
+
+all_info = (
+    win32security.OWNER_SECURITY_INFORMATION
+    | win32security.GROUP_SECURITY_INFORMATION
+    | win32security.DACL_SECURITY_INFORMATION
+    | win32security.SACL_SECURITY_INFORMATION
+)
+
+pid = win32api.GetCurrentProcessId()
+ph = win32api.OpenProcess(win32con.PROCESS_ALL_ACCESS, 0, pid)
+## PROCESS_ALL_ACCESS does not contain ACCESS_SYSTEM_SECURITY (neccessy to do SACLs)
+th = win32security.OpenProcessToken(
+    ph, win32security.TOKEN_ALL_ACCESS
+)  ##win32con.TOKEN_ADJUST_PRIVILEGES)
+old_privs = win32security.GetTokenInformation(th, win32security.TokenPrivileges)
+desired_privs = tuple((e[0], win32con.SE_PRIVILEGE_ENABLED) for e in old_privs)
+modified_privs = win32security.AdjustTokenPrivileges(
+    th, 0, desired_privs
+)  # Will (partially) fail for new_privs (unless they are a subset of current ones)
+gle = win32api.GetLastError()
+if gle != 0:
+    print("AdjustTokenPrivileges error:", gle)
+# print(modified_privs)
+my_sid = win32security.GetTokenInformation(th, win32security.TokenUser)[0]
+pwr_sid = win32security.LookupAccountName("", "Power Users")[0]
+## reopen process with ACCESS_SYSTEM_SECURITY now that sufficent privs are enabled
+ph = win32api.OpenProcess(
+    win32con.PROCESS_ALL_ACCESS | win32con.ACCESS_SYSTEM_SECURITY, 0, pid
+)
+
+sd = win32security.GetKernelObjectSecurity(ph, all_info)
+dacl = sd.GetSecurityDescriptorDacl()
+if dacl is None:
+    dacl = win32security.ACL()
+sacl = sd.GetSecurityDescriptorSacl()
+if sacl is None:
+    sacl = win32security.ACL()
+
+dacl_ace_cnt = dacl.GetAceCount()
+sacl_ace_cnt = sacl.GetAceCount()
+
+dacl.AddAccessAllowedAce(
+    dacl.GetAclRevision(), win32con.ACCESS_SYSTEM_SECURITY | win32con.WRITE_DAC, my_sid
+)
+sacl.AddAuditAccessAce(sacl.GetAclRevision(), win32con.GENERIC_ALL, my_sid, 1, 1)
+sd.SetSecurityDescriptorDacl(1, dacl, 0)
+sd.SetSecurityDescriptorSacl(1, sacl, 0)
+sd.SetSecurityDescriptorGroup(pwr_sid, 0)
+sd.SetSecurityDescriptorOwner(pwr_sid, 0)
+
+win32security.SetKernelObjectSecurity(ph, all_info, sd)
+new_sd = win32security.GetKernelObjectSecurity(ph, all_info)
+
+if new_sd.GetSecurityDescriptorDacl().GetAceCount() != dacl_ace_cnt + 1:
+    print("New dacl doesn" "t contain extra ace ????")
+if new_sd.GetSecurityDescriptorSacl().GetAceCount() != sacl_ace_cnt + 1:
+    print("New Sacl doesn" "t contain extra ace ????")
+if (
+    win32security.LookupAccountSid("", new_sd.GetSecurityDescriptorOwner())[0]
+    != "Power Users"
+):
+    print("Owner not successfully set to Power Users !!!!!")
+if (
+    win32security.LookupAccountSid("", new_sd.GetSecurityDescriptorGroup())[0]
+    != "Power Users"
+):
+    print("Group not successfully set to Power Users !!!!!")
+
+sd.SetSecurityDescriptorSacl(0, None, 0)
+win32security.SetKernelObjectSecurity(ph, win32security.SACL_SECURITY_INFORMATION, sd)
+new_sd_1 = win32security.GetKernelObjectSecurity(
+    ph, win32security.SACL_SECURITY_INFORMATION
+)
+if new_sd_1.GetSecurityDescriptorSacl() is not None:
+    print("Unable to set Sacl to NULL !!!!!!!!")
diff --git a/lib/win32/Demos/security/setnamedsecurityinfo.py b/lib/win32/Demos/security/setnamedsecurityinfo.py
new file mode 100644
index 00000000..8915a0df
--- /dev/null
+++ b/lib/win32/Demos/security/setnamedsecurityinfo.py
@@ -0,0 +1,131 @@
+import win32api
+import win32con
+import win32process
+import win32security
+
+fname, tmp = win32api.GetTempFileName(win32api.GetTempPath(), "tmp")
+print(fname)
+## You need SE_RESTORE_NAME to be able to set the owner of a security descriptor to anybody
+## other than yourself or your primary group.  Most admin logins don't have it by default, so
+## enabling it may fail
+new_privs = (
+    (
+        win32security.LookupPrivilegeValue("", win32security.SE_SECURITY_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", win32security.SE_TCB_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", win32security.SE_SHUTDOWN_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", win32security.SE_RESTORE_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", win32security.SE_TAKE_OWNERSHIP_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", win32security.SE_CREATE_PERMANENT_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", win32security.SE_ENABLE_DELEGATION_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", win32security.SE_CHANGE_NOTIFY_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", win32security.SE_DEBUG_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue(
+            "", win32security.SE_PROF_SINGLE_PROCESS_NAME
+        ),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", win32security.SE_SYSTEM_PROFILE_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", win32security.SE_LOCK_MEMORY_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+)
+
+all_info = (
+    win32security.OWNER_SECURITY_INFORMATION
+    | win32security.GROUP_SECURITY_INFORMATION
+    | win32security.DACL_SECURITY_INFORMATION
+    | win32security.SACL_SECURITY_INFORMATION
+)
+
+ph = win32process.GetCurrentProcess()
+th = win32security.OpenProcessToken(
+    ph, win32security.TOKEN_ALL_ACCESS
+)  ##win32con.TOKEN_ADJUST_PRIVILEGES)
+win32security.AdjustTokenPrivileges(th, 0, new_privs)
+my_sid = win32security.GetTokenInformation(th, win32security.TokenUser)[0]
+pwr_sid = win32security.LookupAccountName("", "Power Users")[0]
+
+sd = win32security.GetNamedSecurityInfo(fname, win32security.SE_FILE_OBJECT, all_info)
+dacl = sd.GetSecurityDescriptorDacl()
+if dacl is None:
+    dacl = win32security.ACL()
+sacl = sd.GetSecurityDescriptorSacl()
+if sacl is None:
+    sacl = win32security.ACL()
+
+dacl_ace_cnt = dacl.GetAceCount()
+sacl_ace_cnt = sacl.GetAceCount()
+
+dacl.AddAccessAllowedAce(
+    dacl.GetAclRevision(), win32con.ACCESS_SYSTEM_SECURITY | win32con.WRITE_DAC, my_sid
+)
+sacl.AddAuditAccessAce(sacl.GetAclRevision(), win32con.GENERIC_ALL, my_sid, 1, 1)
+
+win32security.SetNamedSecurityInfo(
+    fname, win32security.SE_FILE_OBJECT, all_info, pwr_sid, pwr_sid, dacl, sacl
+)
+new_sd = win32security.GetNamedSecurityInfo(
+    fname, win32security.SE_FILE_OBJECT, all_info
+)
+
+## could do additional checking to make sure added ACE contains expected info
+if new_sd.GetSecurityDescriptorDacl().GetAceCount() != dacl_ace_cnt + 1:
+    print("New dacl doesn" "t contain extra ace ????")
+if new_sd.GetSecurityDescriptorSacl().GetAceCount() != sacl_ace_cnt + 1:
+    print("New Sacl doesn" "t contain extra ace ????")
+if (
+    win32security.LookupAccountSid("", new_sd.GetSecurityDescriptorOwner())[0]
+    != "Power Users"
+):
+    print("Owner not successfully set to Power Users !!!!!")
+if (
+    win32security.LookupAccountSid("", new_sd.GetSecurityDescriptorGroup())[0]
+    != "Power Users"
+):
+    print("Group not successfully set to Power Users !!!!!")
+
+win32security.SetNamedSecurityInfo(
+    fname,
+    win32security.SE_FILE_OBJECT,
+    win32security.SACL_SECURITY_INFORMATION,
+    None,
+    None,
+    None,
+    None,
+)
+new_sd_1 = win32security.GetNamedSecurityInfo(
+    fname, win32security.SE_FILE_OBJECT, win32security.SACL_SECURITY_INFORMATION
+)
+if new_sd_1.GetSecurityDescriptorSacl() is not None:
+    print("Unable to set Sacl to NULL !!!!!!!!")
diff --git a/lib/win32/Demos/security/setsecurityinfo.py b/lib/win32/Demos/security/setsecurityinfo.py
new file mode 100644
index 00000000..d784d950
--- /dev/null
+++ b/lib/win32/Demos/security/setsecurityinfo.py
@@ -0,0 +1,132 @@
+import win32api
+import win32con
+import win32process
+import win32security
+
+## You need SE_RESTORE_NAME to be able to set the owner of a security descriptor to anybody
+## other than yourself or your primary group.  Most admin logins don't have it by default, so
+## enabling it may fail
+new_privs = (
+    (
+        win32security.LookupPrivilegeValue("", win32security.SE_SECURITY_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", win32security.SE_TCB_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", win32security.SE_SHUTDOWN_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", win32security.SE_RESTORE_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", win32security.SE_TAKE_OWNERSHIP_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", win32security.SE_CREATE_PERMANENT_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", win32security.SE_ENABLE_DELEGATION_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", win32security.SE_CHANGE_NOTIFY_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", win32security.SE_DEBUG_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue(
+            "", win32security.SE_PROF_SINGLE_PROCESS_NAME
+        ),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", win32security.SE_SYSTEM_PROFILE_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", win32security.SE_LOCK_MEMORY_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+)
+
+all_info = (
+    win32security.OWNER_SECURITY_INFORMATION
+    | win32security.GROUP_SECURITY_INFORMATION
+    | win32security.DACL_SECURITY_INFORMATION
+    | win32security.SACL_SECURITY_INFORMATION
+)
+
+pid = win32api.GetCurrentProcessId()
+ph = win32api.OpenProcess(win32con.PROCESS_ALL_ACCESS, 0, pid)
+## PROCESS_ALL_ACCESS does not contain ACCESS_SYSTEM_SECURITY (neccessy to do SACLs)
+th = win32security.OpenProcessToken(
+    ph, win32security.TOKEN_ALL_ACCESS
+)  ##win32con.TOKEN_ADJUST_PRIVILEGES)
+old_privs = win32security.AdjustTokenPrivileges(th, 0, new_privs)
+my_sid = win32security.GetTokenInformation(th, win32security.TokenUser)[0]
+pwr_sid = win32security.LookupAccountName("", "Power Users")[0]
+## reopen process with ACCESS_SYSTEM_SECURITY now that sufficent privs are enabled
+ph = win32api.OpenProcess(
+    win32con.PROCESS_ALL_ACCESS | win32con.ACCESS_SYSTEM_SECURITY, 0, pid
+)
+
+sd = win32security.GetSecurityInfo(ph, win32security.SE_KERNEL_OBJECT, all_info)
+dacl = sd.GetSecurityDescriptorDacl()
+if dacl is None:
+    dacl = win32security.ACL()
+sacl = sd.GetSecurityDescriptorSacl()
+if sacl is None:
+    sacl = win32security.ACL()
+
+dacl_ace_cnt = dacl.GetAceCount()
+sacl_ace_cnt = sacl.GetAceCount()
+
+dacl.AddAccessAllowedAce(
+    dacl.GetAclRevision(), win32con.ACCESS_SYSTEM_SECURITY | win32con.WRITE_DAC, my_sid
+)
+sacl.AddAuditAccessAce(sacl.GetAclRevision(), win32con.GENERIC_ALL, my_sid, 1, 1)
+
+win32security.SetSecurityInfo(
+    ph, win32security.SE_KERNEL_OBJECT, all_info, pwr_sid, pwr_sid, dacl, sacl
+)
+new_sd = win32security.GetSecurityInfo(ph, win32security.SE_KERNEL_OBJECT, all_info)
+
+if new_sd.GetSecurityDescriptorDacl().GetAceCount() != dacl_ace_cnt + 1:
+    print("New dacl doesn" "t contain extra ace ????")
+if new_sd.GetSecurityDescriptorSacl().GetAceCount() != sacl_ace_cnt + 1:
+    print("New Sacl doesn" "t contain extra ace ????")
+if (
+    win32security.LookupAccountSid("", new_sd.GetSecurityDescriptorOwner())[0]
+    != "Power Users"
+):
+    print("Owner not successfully set to Power Users !!!!!")
+if (
+    win32security.LookupAccountSid("", new_sd.GetSecurityDescriptorGroup())[0]
+    != "Power Users"
+):
+    print("Group not successfully set to Power Users !!!!!")
+
+win32security.SetSecurityInfo(
+    ph,
+    win32security.SE_KERNEL_OBJECT,
+    win32security.SACL_SECURITY_INFORMATION,
+    None,
+    None,
+    None,
+    None,
+)
+new_sd_1 = win32security.GetSecurityInfo(
+    ph, win32security.SE_KERNEL_OBJECT, win32security.SACL_SECURITY_INFORMATION
+)
+if new_sd_1.GetSecurityDescriptorSacl() is not None:
+    print("Unable to set Sacl to NULL !!!!!!!!")
diff --git a/lib/win32/Demos/security/setuserobjectsecurity.py b/lib/win32/Demos/security/setuserobjectsecurity.py
new file mode 100644
index 00000000..668571f6
--- /dev/null
+++ b/lib/win32/Demos/security/setuserobjectsecurity.py
@@ -0,0 +1,103 @@
+import win32api
+import win32con
+import win32process
+import win32security
+
+new_privs = (
+    (
+        win32security.LookupPrivilegeValue("", win32security.SE_SECURITY_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", win32security.SE_TCB_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", win32security.SE_SHUTDOWN_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", win32security.SE_RESTORE_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", win32security.SE_TAKE_OWNERSHIP_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", win32security.SE_CREATE_PERMANENT_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", win32security.SE_ENABLE_DELEGATION_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", win32security.SE_CHANGE_NOTIFY_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", win32security.SE_DEBUG_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue(
+            "", win32security.SE_PROF_SINGLE_PROCESS_NAME
+        ),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", win32security.SE_SYSTEM_PROFILE_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+    (
+        win32security.LookupPrivilegeValue("", win32security.SE_LOCK_MEMORY_NAME),
+        win32con.SE_PRIVILEGE_ENABLED,
+    ),
+)
+
+all_info = (
+    win32security.OWNER_SECURITY_INFORMATION
+    | win32security.GROUP_SECURITY_INFORMATION
+    | win32security.DACL_SECURITY_INFORMATION
+    | win32security.SACL_SECURITY_INFORMATION
+)
+info = (
+    win32security.OWNER_SECURITY_INFORMATION
+    | win32security.GROUP_SECURITY_INFORMATION
+    | win32security.DACL_SECURITY_INFORMATION
+)
+
+ph = win32process.GetCurrentProcess()
+th = win32security.OpenProcessToken(
+    ph, win32security.TOKEN_ALL_ACCESS
+)  ##win32con.TOKEN_ADJUST_PRIVILEGES)
+win32security.AdjustTokenPrivileges(th, 0, new_privs)
+my_sid = win32security.GetTokenInformation(th, win32security.TokenUser)[0]
+pwr_sid = win32security.LookupAccountName("", "Power Users")[0]
+
+h = win32process.GetProcessWindowStation()
+sd = win32security.GetUserObjectSecurity(h, info)
+dacl = sd.GetSecurityDescriptorDacl()
+ace_cnt = dacl.GetAceCount()
+
+dacl.AddAccessAllowedAce(
+    dacl.GetAclRevision(), win32con.ACCESS_SYSTEM_SECURITY | win32con.WRITE_DAC, my_sid
+)
+sd.SetSecurityDescriptorDacl(1, dacl, 0)
+sd.SetSecurityDescriptorGroup(pwr_sid, 0)
+sd.SetSecurityDescriptorOwner(pwr_sid, 0)
+
+win32security.SetUserObjectSecurity(h, info, sd)
+new_sd = win32security.GetUserObjectSecurity(h, info)
+assert (
+    new_sd.GetSecurityDescriptorDacl().GetAceCount() == ace_cnt + 1
+), "Did not add an ace to the Dacl !!!!!!"
+assert (
+    win32security.LookupAccountSid("", new_sd.GetSecurityDescriptorOwner())[0]
+    == "Power Users"
+), "Owner not successfully set to Power Users !!!!!"
+assert (
+    win32security.LookupAccountSid("", new_sd.GetSecurityDescriptorGroup())[0]
+    == "Power Users"
+), "Group not successfully set to Power Users !!!!!"
diff --git a/lib/win32/Demos/security/sspi/fetch_url.py b/lib/win32/Demos/security/sspi/fetch_url.py
new file mode 100644
index 00000000..3b43b7e4
--- /dev/null
+++ b/lib/win32/Demos/security/sspi/fetch_url.py
@@ -0,0 +1,160 @@
+"""
+Fetches a URL from a web-server supporting NTLM authentication
+eg, IIS.
+
+If no arguments are specified, a default of http://localhost/localstart.asp
+is used.  This script does follow simple 302 redirections, so pointing at the
+root of an IIS server is should work.
+"""
+
+import http.client  # sorry, this demo needs 2.3+
+import optparse
+import urllib.error
+import urllib.parse
+import urllib.request
+from base64 import decodestring, encodestring
+
+from sspi import ClientAuth
+
+options = None  # set to optparse options object
+
+
+def open_url(host, url):
+    h = http.client.HTTPConnection(host)
+    #    h.set_debuglevel(9)
+    h.putrequest("GET", url)
+    h.endheaders()
+    resp = h.getresponse()
+    print("Initial response is", resp.status, resp.reason)
+    body = resp.read()
+    if resp.status == 302:  # object moved
+        url = "/" + resp.msg["location"]
+        resp.close()
+        h.putrequest("GET", url)
+        h.endheaders()
+        resp = h.getresponse()
+        print("After redirect response is", resp.status, resp.reason)
+    if options.show_headers:
+        print("Initial response headers:")
+        for name, val in list(resp.msg.items()):
+            print(" %s: %s" % (name, val))
+    if options.show_body:
+        print(body)
+    if resp.status == 401:
+        # 401: Unauthorized - here is where the real work starts
+        auth_info = None
+        if options.user or options.domain or options.password:
+            auth_info = options.user, options.domain, options.password
+        ca = ClientAuth("NTLM", auth_info=auth_info)
+        auth_scheme = ca.pkg_info["Name"]
+        data = None
+        while 1:
+            err, out_buf = ca.authorize(data)
+            data = out_buf[0].Buffer
+            # Encode it as base64 as required by HTTP
+            auth = encodestring(data).replace("\012", "")
+            h.putrequest("GET", url)
+            h.putheader("Authorization", auth_scheme + " " + auth)
+            h.putheader("Content-Length", "0")
+            h.endheaders()
+            resp = h.getresponse()
+            if options.show_headers:
+                print("Token dance headers:")
+                for name, val in list(resp.msg.items()):
+                    print(" %s: %s" % (name, val))
+
+            if err == 0:
+                break
+            else:
+                if resp.status != 401:
+                    print("Eeek - got response", resp.status)
+                    cl = resp.msg.get("content-length")
+                    if cl:
+                        print(repr(resp.read(int(cl))))
+                    else:
+                        print("no content!")
+
+                assert resp.status == 401, resp.status
+
+            assert not resp.will_close, "NTLM is per-connection - must not close"
+            schemes = [
+                s.strip() for s in resp.msg.get("WWW-Authenticate", "").split(",")
+            ]
+            for scheme in schemes:
+                if scheme.startswith(auth_scheme):
+                    data = decodestring(scheme[len(auth_scheme) + 1 :])
+                    break
+            else:
+                print(
+                    "Could not find scheme '%s' in schemes %r" % (auth_scheme, schemes)
+                )
+                break
+
+            resp.read()
+    print("Final response status is", resp.status, resp.reason)
+    if resp.status == 200:
+        # Worked!
+        # Check we can read it again without re-authenticating.
+        if resp.will_close:
+            print(
+                "EEEK - response will close, but NTLM is per connection - it must stay open"
+            )
+        body = resp.read()
+        if options.show_body:
+            print("Final response body:")
+            print(body)
+        h.putrequest("GET", url)
+        h.endheaders()
+        resp = h.getresponse()
+        print("Second fetch response is", resp.status, resp.reason)
+        if options.show_headers:
+            print("Second response headers:")
+            for name, val in list(resp.msg.items()):
+                print(" %s: %s" % (name, val))
+
+        resp.read(int(resp.msg.get("content-length", 0)))
+    elif resp.status == 500:
+        print("Error text")
+        print(resp.read())
+    else:
+        if options.show_body:
+            cl = resp.msg.get("content-length")
+            print(resp.read(int(cl)))
+
+
+if __name__ == "__main__":
+    parser = optparse.OptionParser(description=__doc__)
+
+    parser.add_option(
+        "",
+        "--show-body",
+        action="store_true",
+        help="print the body of each response as it is received",
+    )
+
+    parser.add_option(
+        "",
+        "--show-headers",
+        action="store_true",
+        help="print the headers of each response as it is received",
+    )
+
+    parser.add_option("", "--user", action="store", help="The username to login with")
+
+    parser.add_option(
+        "", "--password", action="store", help="The password to login with"
+    )
+
+    parser.add_option("", "--domain", action="store", help="The domain to login to")
+
+    options, args = parser.parse_args()
+    if not args:
+        print("Run with --help for usage details")
+        args = ["http://localhost/localstart.asp"]
+    for url in args:
+        scheme, netloc, path, params, query, fragment = urllib.parse.urlparse(url)
+        if (scheme != "http") or params or query or fragment:
+            parser.error("Scheme must be http, URL must be simple")
+
+        print("Opening '%s' from '%s'" % (path, netloc))
+        r = open_url(netloc, path)
diff --git a/lib/win32/Demos/security/sspi/simple_auth.py b/lib/win32/Demos/security/sspi/simple_auth.py
new file mode 100644
index 00000000..cc0ce5cf
--- /dev/null
+++ b/lib/win32/Demos/security/sspi/simple_auth.py
@@ -0,0 +1,72 @@
+# A demo of basic SSPI authentication.
+# There is a 'client' context and a 'server' context - typically these will
+# be on different machines (here they are in the same process, but the same
+# concepts apply)
+import sspi
+import sspicon
+import win32api
+import win32security
+
+
+def lookup_ret_code(err):
+    for k, v in list(sspicon.__dict__.items()):
+        if k[0:6] in ("SEC_I_", "SEC_E_") and v == err:
+            return k
+
+
+"""
+pkg_name='Kerberos'
+sspiclient=SSPIClient(pkg_name, win32api.GetUserName(),  ## target spn is ourself
+    None, None,   ## use none for client name and authentication information for current context
+    ## u'username', (u'username',u'domain.com',u'passwd'),
+    sspicon.ISC_REQ_INTEGRITY|sspicon.ISC_REQ_SEQUENCE_DETECT|sspicon.ISC_REQ_REPLAY_DETECT|    \
+        sspicon.ISC_REQ_DELEGATE|sspicon.ISC_REQ_CONFIDENTIALITY|sspicon.ISC_REQ_USE_SESSION_KEY)
+sspiserver=SSPIServer(pkg_name, None,
+    sspicon.ASC_REQ_INTEGRITY|sspicon.ASC_REQ_SEQUENCE_DETECT|sspicon.ASC_REQ_REPLAY_DETECT|   \
+        sspicon.ASC_REQ_DELEGATE|sspicon.ASC_REQ_CONFIDENTIALITY|sspicon.ASC_REQ_STREAM|sspicon.ASC_REQ_USE_SESSION_KEY)
+"""
+
+pkg_name = "NTLM"
+
+# Setup the 2 contexts.
+sspiclient = sspi.ClientAuth(pkg_name)
+sspiserver = sspi.ServerAuth(pkg_name)
+
+# Perform the authentication dance, each loop exchanging more information
+# on the way to completing authentication.
+sec_buffer = None
+while 1:
+    err, sec_buffer = sspiclient.authorize(sec_buffer)
+    err, sec_buffer = sspiserver.authorize(sec_buffer)
+    if err == 0:
+        break
+
+# The server can now impersonate the client.  In this demo the 2 users will
+# always be the same.
+sspiserver.ctxt.ImpersonateSecurityContext()
+print("Impersonated user: ", win32api.GetUserNameEx(win32api.NameSamCompatible))
+sspiserver.ctxt.RevertSecurityContext()
+print("Reverted to self: ", win32api.GetUserName())
+
+pkg_size_info = sspiclient.ctxt.QueryContextAttributes(sspicon.SECPKG_ATTR_SIZES)
+# Now sign some data
+msg = "some data to be encrypted ......"
+
+sigsize = pkg_size_info["MaxSignature"]
+sigbuf = win32security.PySecBufferDescType()
+sigbuf.append(win32security.PySecBufferType(len(msg), sspicon.SECBUFFER_DATA))
+sigbuf.append(win32security.PySecBufferType(sigsize, sspicon.SECBUFFER_TOKEN))
+sigbuf[0].Buffer = msg
+sspiclient.ctxt.MakeSignature(0, sigbuf, 1)
+sspiserver.ctxt.VerifySignature(sigbuf, 1)
+
+# And finally encrypt some.
+trailersize = pkg_size_info["SecurityTrailer"]
+encbuf = win32security.PySecBufferDescType()
+encbuf.append(win32security.PySecBufferType(len(msg), sspicon.SECBUFFER_DATA))
+encbuf.append(win32security.PySecBufferType(trailersize, sspicon.SECBUFFER_TOKEN))
+encbuf[0].Buffer = msg
+sspiclient.ctxt.EncryptMessage(0, encbuf, 1)
+print("Encrypted data:", repr(encbuf[0].Buffer))
+sspiserver.ctxt.DecryptMessage(encbuf, 1)
+print("Unencrypted data:", encbuf[0].Buffer)
diff --git a/lib/win32/Demos/security/sspi/socket_server.py b/lib/win32/Demos/security/sspi/socket_server.py
new file mode 100644
index 00000000..4d606bb8
--- /dev/null
+++ b/lib/win32/Demos/security/sspi/socket_server.py
@@ -0,0 +1,201 @@
+"""A sample socket server and client using SSPI authentication and encryption.
+
+You must run with either 'client' or 'server' as arguments.  A server must be
+running before a client can connect.
+
+To use with Kerberos you should include in the client options
+--target-spn=username, where 'username' is the user under which the server is
+being run.
+
+Running either the client or server as a different user can be informative.
+A command-line such as the following may be useful:
+`runas /user:{user} {fqp}\python.exe {fqp}\socket_server.py --wait client|server`
+
+{fqp} should specify the relevant fully-qualified path names.
+
+To use 'runas' with Kerberos, the client program will need to
+specify --target-spn with the username under which the *server* is running.
+
+See the SSPI documentation for more details.
+"""
+
+
+import http.client  # sorry, this demo needs 2.3+
+import optparse
+import socketserver
+import struct
+import traceback
+
+import sspi
+import win32api
+import win32security
+
+options = None  # set to optparse object.
+
+
+def GetUserName():
+    try:
+        return win32api.GetUserName()
+    except win32api.error as details:
+        # Seeing 'access denied' errors here for non-local users (presumably
+        # without permission to login locally).  Get the fully-qualified
+        # username, although a side-effect of these permission-denied errors
+        # is a lack of Python codecs - so printing the Unicode value fails.
+        # So just return the repr(), and avoid codecs completely.
+        return repr(win32api.GetUserNameEx(win32api.NameSamCompatible))
+
+
+# Send a simple "message" over a socket - send the number of bytes first,
+# then the string.  Ditto for receive.
+def _send_msg(s, m):
+    s.send(struct.pack("i", len(m)))
+    s.send(m)
+
+
+def _get_msg(s):
+    size_data = s.recv(struct.calcsize("i"))
+    if not size_data:
+        return None
+    cb = struct.unpack("i", size_data)[0]
+    return s.recv(cb)
+
+
+class SSPISocketServer(socketserver.TCPServer):
+    def __init__(self, *args, **kw):
+        socketserver.TCPServer.__init__(self, *args, **kw)
+        self.sa = sspi.ServerAuth(options.package)
+
+    def verify_request(self, sock, ca):
+        # Do the sspi auth dance
+        self.sa.reset()
+        while 1:
+            data = _get_msg(sock)
+            if data is None:
+                return False
+            try:
+                err, sec_buffer = self.sa.authorize(data)
+            except sspi.error as details:
+                print("FAILED to authorize client:", details)
+                return False
+
+            if err == 0:
+                break
+            _send_msg(sock, sec_buffer[0].Buffer)
+        return True
+
+    def process_request(self, request, client_address):
+        # An example using the connection once it is established.
+        print("The server is running as user", GetUserName())
+        self.sa.ctxt.ImpersonateSecurityContext()
+        try:
+            print("Having conversation with client as user", GetUserName())
+            while 1:
+                # we need to grab 2 bits of data - the encrypted data, and the
+                # 'key'
+                data = _get_msg(request)
+                key = _get_msg(request)
+                if data is None or key is None:
+                    break
+                data = self.sa.decrypt(data, key)
+                print("Client sent:", repr(data))
+        finally:
+            self.sa.ctxt.RevertSecurityContext()
+        self.close_request(request)
+        print("The server is back to user", GetUserName())
+
+
+def serve():
+    s = SSPISocketServer(("localhost", options.port), None)
+    print("Running test server...")
+    s.serve_forever()
+
+
+def sspi_client():
+    c = http.client.HTTPConnection("localhost", options.port)
+    c.connect()
+    # Do the auth dance.
+    ca = sspi.ClientAuth(options.package, targetspn=options.target_spn)
+    data = None
+    while 1:
+        err, out_buf = ca.authorize(data)
+        _send_msg(c.sock, out_buf[0].Buffer)
+        if err == 0:
+            break
+        data = _get_msg(c.sock)
+    print("Auth dance complete - sending a few encryted messages")
+    # Assume out data is sensitive - encrypt the message.
+    for data in "Hello from the client".split():
+        blob, key = ca.encrypt(data)
+        _send_msg(c.sock, blob)
+        _send_msg(c.sock, key)
+    c.sock.close()
+    print("Client completed.")
+
+
+if __name__ == "__main__":
+    parser = optparse.OptionParser("%prog [options] client|server", description=__doc__)
+
+    parser.add_option(
+        "",
+        "--package",
+        action="store",
+        default="NTLM",
+        help="The SSPI package to use (eg, Kerberos) - default is NTLM",
+    )
+
+    parser.add_option(
+        "",
+        "--target-spn",
+        action="store",
+        help="""The target security provider name to use. The
+                      string contents are security-package specific.  For
+                      example, 'Kerberos' or 'Negotiate' require the server
+                      principal name (SPN) (ie, the username) of the remote
+                      process.  For NTLM this must be blank.""",
+    )
+
+    parser.add_option(
+        "",
+        "--port",
+        action="store",
+        default="8181",
+        help="The port number to use (default=8181)",
+    )
+
+    parser.add_option(
+        "",
+        "--wait",
+        action="store_true",
+        help="""Cause the program to wait for input just before
+                              terminating. Useful when using via runas to see
+                              any error messages before termination.
+                           """,
+    )
+
+    options, args = parser.parse_args()
+    try:
+        options.port = int(options.port)
+    except (ValueError, TypeError):
+        parser.error("--port must be an integer")
+
+    try:
+        try:
+            if not args:
+                args = [""]
+            if args[0] == "client":
+                sspi_client()
+            elif args[0] == "server":
+                serve()
+            else:
+                parser.error(
+                    "You must supply 'client' or 'server' - " "use --help for details"
+                )
+        except KeyboardInterrupt:
+            pass
+        except SystemExit:
+            pass
+        except:
+            traceback.print_exc()
+    finally:
+        if options.wait:
+            input("Press enter to continue")
diff --git a/lib/win32/Demos/security/sspi/validate_password.py b/lib/win32/Demos/security/sspi/validate_password.py
new file mode 100644
index 00000000..40b6ad5b
--- /dev/null
+++ b/lib/win32/Demos/security/sspi/validate_password.py
@@ -0,0 +1,41 @@
+# Demonstrates how to validate a password.
+# See also MSKB article Q180548
+#
+# To use with Kerberos you need to jump through the 'targetspn' hoops.
+
+import sys
+
+import win32security
+from sspi import ClientAuth, ServerAuth
+
+
+def validate(username, password, domain=""):
+    auth_info = username, domain, password
+    ca = ClientAuth("NTLM", auth_info=auth_info)
+    sa = ServerAuth("NTLM")
+
+    data = err = None
+    while err != 0:
+        err, data = ca.authorize(data)
+        err, data = sa.authorize(data)
+    # If we get here without exception, we worked!
+
+
+if __name__ == "__main__":
+    if len(sys.argv) not in [2, 3, 4]:
+        print("Usage: %s username [password [domain]]" % (__file__,))
+        sys.exit(1)
+
+    # password and domain are optional!
+    password = None
+    if len(sys.argv) >= 3:
+        password = sys.argv[2]
+    domain = ""
+    if len(sys.argv) >= 4:
+        domain = sys.argv[3]
+    try:
+        validate(sys.argv[1], password, domain)
+        print("Validated OK")
+    except win32security.error as details:
+        hr, func, msg = details
+        print("Validation failed: %s (%d)" % (msg, hr))
diff --git a/lib/win32/Demos/service/nativePipeTestService.py b/lib/win32/Demos/service/nativePipeTestService.py
new file mode 100644
index 00000000..4ac05eba
--- /dev/null
+++ b/lib/win32/Demos/service/nativePipeTestService.py
@@ -0,0 +1,63 @@
+# This is an example of a service hosted by python.exe rather than
+# pythonservice.exe.
+
+# Note that it is very rare that using python.exe is a better option
+# than the default pythonservice.exe - the latter has better error handling
+# so that if Python itself can't be initialized or there are very early
+# import errors, you will get error details written to the event log.  When
+# using python.exe instead, you are forced to wait for the interpreter startup
+# and imports to succeed before you are able to effectively setup your own
+# error handling.
+
+# So in short, please make sure you *really* want to do this, otherwise just
+# stick with the default.
+
+import os
+import sys
+
+import servicemanager
+import win32serviceutil
+from pipeTestService import TestPipeService
+
+
+class NativeTestPipeService(TestPipeService):
+    _svc_name_ = "PyNativePipeTestService"
+    _svc_display_name_ = "Python Native Pipe Test Service"
+    _svc_description_ = "Tests Python.exe hosted services"
+    # tell win32serviceutil we have a custom executable and custom args
+    # so registration does the right thing.
+    _exe_name_ = sys.executable
+    _exe_args_ = '"' + os.path.abspath(sys.argv[0]) + '"'
+
+
+def main():
+    if len(sys.argv) == 1:
+        # service must be starting...
+        print("service is starting...")
+        print("(execute this script with '--help' if that isn't what you want)")
+
+        # for the sake of debugging etc, we use win32traceutil to see
+        # any unhandled exceptions and print statements.
+        import win32traceutil
+
+        print("service is still starting...")
+
+        servicemanager.Initialize()
+        servicemanager.PrepareToHostSingle(NativeTestPipeService)
+        # Now ask the service manager to fire things up for us...
+        servicemanager.StartServiceCtrlDispatcher()
+        print("service done!")
+    else:
+        win32serviceutil.HandleCommandLine(NativeTestPipeService)
+
+
+if __name__ == "__main__":
+    try:
+        main()
+    except (SystemExit, KeyboardInterrupt):
+        raise
+    except:
+        print("Something went bad!")
+        import traceback
+
+        traceback.print_exc()
diff --git a/lib/win32/Demos/service/pipeTestService.py b/lib/win32/Demos/service/pipeTestService.py
new file mode 100644
index 00000000..2efda606
--- /dev/null
+++ b/lib/win32/Demos/service/pipeTestService.py
@@ -0,0 +1,184 @@
+# A Demo of services and named pipes.
+
+# A multi-threaded service that simply echos back its input.
+
+# * Install as a service using "pipeTestService.py install"
+# * Use Control Panel to change the user name of the service
+#   to a real user name (ie, NOT the SystemAccount)
+# * Start the service.
+# * Run the "pipeTestServiceClient.py" program as the client pipe side.
+
+import _thread
+import traceback
+
+# Old versions of the service framework would not let you import this
+# module at the top-level.  Now you can, and can check 'Debugging()' and
+# 'RunningAsService()' to check your context.
+import pywintypes
+import servicemanager
+import win32con
+import win32service
+import win32serviceutil
+import winerror
+from ntsecuritycon import *
+from win32api import *
+
+# Use "import *" to keep this looking as much as a "normal" service
+# as possible.  Real code shouldn't do this.
+from win32event import *
+from win32file import *
+from win32pipe import *
+
+
+def ApplyIgnoreError(fn, args):
+    try:
+        return fn(*args)
+    except error:  # Ignore win32api errors.
+        return None
+
+
+class TestPipeService(win32serviceutil.ServiceFramework):
+    _svc_name_ = "PyPipeTestService"
+    _svc_display_name_ = "Python Pipe Test Service"
+    _svc_description_ = "Tests Python service framework by receiving and echoing messages over a named pipe"
+
+    def __init__(self, args):
+        win32serviceutil.ServiceFramework.__init__(self, args)
+        self.hWaitStop = CreateEvent(None, 0, 0, None)
+        self.overlapped = pywintypes.OVERLAPPED()
+        self.overlapped.hEvent = CreateEvent(None, 0, 0, None)
+        self.thread_handles = []
+
+    def CreatePipeSecurityObject(self):
+        # Create a security object giving World read/write access,
+        # but only "Owner" modify access.
+        sa = pywintypes.SECURITY_ATTRIBUTES()
+        sidEveryone = pywintypes.SID()
+        sidEveryone.Initialize(SECURITY_WORLD_SID_AUTHORITY, 1)
+        sidEveryone.SetSubAuthority(0, SECURITY_WORLD_RID)
+        sidCreator = pywintypes.SID()
+        sidCreator.Initialize(SECURITY_CREATOR_SID_AUTHORITY, 1)
+        sidCreator.SetSubAuthority(0, SECURITY_CREATOR_OWNER_RID)
+
+        acl = pywintypes.ACL()
+        acl.AddAccessAllowedAce(FILE_GENERIC_READ | FILE_GENERIC_WRITE, sidEveryone)
+        acl.AddAccessAllowedAce(FILE_ALL_ACCESS, sidCreator)
+
+        sa.SetSecurityDescriptorDacl(1, acl, 0)
+        return sa
+
+    # The functions executed in their own thread to process a client request.
+    def DoProcessClient(self, pipeHandle, tid):
+        try:
+            try:
+                # Create a loop, reading large data.  If we knew the data stream was
+                # was small, a simple ReadFile would do.
+                d = "".encode("ascii")  # ensure bytes on py2k and py3k...
+                hr = winerror.ERROR_MORE_DATA
+                while hr == winerror.ERROR_MORE_DATA:
+                    hr, thisd = ReadFile(pipeHandle, 256)
+                    d = d + thisd
+                print("Read", d)
+                ok = 1
+            except error:
+                # Client disconnection - do nothing
+                ok = 0
+
+            # A secure service would handle (and ignore!) errors writing to the
+            # pipe, but for the sake of this demo we dont (if only to see what errors
+            # we can get when our clients break at strange times :-)
+            if ok:
+                msg = (
+                    "%s (on thread %d) sent me %s"
+                    % (GetNamedPipeHandleState(pipeHandle, False, True)[4], tid, d)
+                ).encode("ascii")
+                WriteFile(pipeHandle, msg)
+        finally:
+            ApplyIgnoreError(DisconnectNamedPipe, (pipeHandle,))
+            ApplyIgnoreError(CloseHandle, (pipeHandle,))
+
+    def ProcessClient(self, pipeHandle):
+        try:
+            procHandle = GetCurrentProcess()
+            th = DuplicateHandle(
+                procHandle,
+                GetCurrentThread(),
+                procHandle,
+                0,
+                0,
+                win32con.DUPLICATE_SAME_ACCESS,
+            )
+            try:
+                self.thread_handles.append(th)
+                try:
+                    return self.DoProcessClient(pipeHandle, th)
+                except:
+                    traceback.print_exc()
+            finally:
+                self.thread_handles.remove(th)
+        except:
+            traceback.print_exc()
+
+    def SvcStop(self):
+        self.ReportServiceStatus(win32service.SERVICE_STOP_PENDING)
+        SetEvent(self.hWaitStop)
+
+    def SvcDoRun(self):
+        # Write an event log record - in debug mode we will also
+        # see this message printed.
+        servicemanager.LogMsg(
+            servicemanager.EVENTLOG_INFORMATION_TYPE,
+            servicemanager.PYS_SERVICE_STARTED,
+            (self._svc_name_, ""),
+        )
+
+        num_connections = 0
+        while 1:
+            pipeHandle = CreateNamedPipe(
+                "\\\\.\\pipe\\PyPipeTest",
+                PIPE_ACCESS_DUPLEX | FILE_FLAG_OVERLAPPED,
+                PIPE_TYPE_MESSAGE | PIPE_READMODE_BYTE,
+                PIPE_UNLIMITED_INSTANCES,  # max instances
+                0,
+                0,
+                6000,
+                self.CreatePipeSecurityObject(),
+            )
+            try:
+                hr = ConnectNamedPipe(pipeHandle, self.overlapped)
+            except error as details:
+                print("Error connecting pipe!", details)
+                CloseHandle(pipeHandle)
+                break
+            if hr == winerror.ERROR_PIPE_CONNECTED:
+                # Client is already connected - signal event
+                SetEvent(self.overlapped.hEvent)
+            rc = WaitForMultipleObjects(
+                (self.hWaitStop, self.overlapped.hEvent), 0, INFINITE
+            )
+            if rc == WAIT_OBJECT_0:
+                # Stop event
+                break
+            else:
+                # Pipe event - spawn thread to deal with it.
+                _thread.start_new_thread(self.ProcessClient, (pipeHandle,))
+                num_connections = num_connections + 1
+
+        # Sleep to ensure that any new threads are in the list, and then
+        # wait for all current threads to finish.
+        # What is a better way?
+        Sleep(500)
+        while self.thread_handles:
+            self.ReportServiceStatus(win32service.SERVICE_STOP_PENDING, 5000)
+            print("Waiting for %d threads to finish..." % (len(self.thread_handles)))
+            WaitForMultipleObjects(self.thread_handles, 1, 3000)
+        # Write another event log record.
+        servicemanager.LogMsg(
+            servicemanager.EVENTLOG_INFORMATION_TYPE,
+            servicemanager.PYS_SERVICE_STOPPED,
+            (self._svc_name_, " after processing %d connections" % (num_connections,)),
+        )
+
+
+if __name__ == "__main__":
+    win32serviceutil.HandleCommandLine(TestPipeService)
diff --git a/lib/win32/Demos/service/pipeTestServiceClient.py b/lib/win32/Demos/service/pipeTestServiceClient.py
new file mode 100644
index 00000000..98fdb3c9
--- /dev/null
+++ b/lib/win32/Demos/service/pipeTestServiceClient.py
@@ -0,0 +1,156 @@
+# A Test Program for pipeTestService.py
+#
+# Install and start the Pipe Test service, then run this test
+# either from the same machine, or from another using the "-s" param.
+#
+# Eg: pipeTestServiceClient.py -s server_name Hi There
+# Should work.
+
+import os
+import sys
+import traceback
+
+import pywintypes
+import win32api
+import winerror
+from win32event import *
+from win32file import *
+from win32pipe import *
+
+verbose = 0
+
+# def ReadFromPipe(pipeName):
+# Could (Should?) use CallNamedPipe, but this technique allows variable size
+# messages (whereas you must supply a buffer size for CallNamedPipe!
+#       hPipe = CreateFile(pipeName, GENERIC_WRITE, 0, None, OPEN_EXISTING, FILE_ATTRIBUTE_NORMAL, 0)
+#       more = 1
+#       while more:
+#               hr = ReadFile(hPipe, 256)
+#               if hr==0:
+#                       more = 0
+#               except win32api.error (hr, fn, desc):
+#                       if hr==winerror.ERROR_MORE_DATA:
+#                               data = dat
+#
+
+
+def CallPipe(fn, args):
+    ret = None
+    retryCount = 0
+    while retryCount < 8:  # Keep looping until user cancels.
+        retryCount = retryCount + 1
+        try:
+            return fn(*args)
+        except win32api.error as exc:
+            if exc.winerror == winerror.ERROR_PIPE_BUSY:
+                win32api.Sleep(5000)
+                continue
+            else:
+                raise
+
+    raise RuntimeError("Could not make a connection to the server")
+
+
+def testClient(server, msg):
+    if verbose:
+        print("Sending", msg)
+    data = CallPipe(
+        CallNamedPipe,
+        ("\\\\%s\\pipe\\PyPipeTest" % server, msg, 256, NMPWAIT_WAIT_FOREVER),
+    )
+    if verbose:
+        print("Server sent back '%s'" % data)
+    print("Sent and received a message!")
+
+
+def testLargeMessage(server, size=4096):
+    if verbose:
+        print("Sending message of size %d" % (size))
+    msg = "*" * size
+    data = CallPipe(
+        CallNamedPipe,
+        ("\\\\%s\\pipe\\PyPipeTest" % server, msg, 512, NMPWAIT_WAIT_FOREVER),
+    )
+    if len(data) - size:
+        print("Sizes are all wrong - send %d, got back %d" % (size, len(data)))
+
+
+def stressThread(server, numMessages, wait):
+    try:
+        try:
+            for i in range(numMessages):
+                r = CallPipe(
+                    CallNamedPipe,
+                    (
+                        "\\\\%s\\pipe\\PyPipeTest" % server,
+                        "#" * 512,
+                        1024,
+                        NMPWAIT_WAIT_FOREVER,
+                    ),
+                )
+        except:
+            traceback.print_exc()
+            print("Failed after %d messages" % i)
+    finally:
+        SetEvent(wait)
+
+
+def stressTestClient(server, numThreads, numMessages):
+    import _thread
+
+    thread_waits = []
+    for t_num in range(numThreads):
+        # Note I could just wait on thread handles (after calling DuplicateHandle)
+        # See the service itself for an example of waiting for the clients...
+        wait = CreateEvent(None, 0, 0, None)
+        thread_waits.append(wait)
+        _thread.start_new_thread(stressThread, (server, numMessages, wait))
+    # Wait for all threads to finish.
+    WaitForMultipleObjects(thread_waits, 1, INFINITE)
+
+
+def main():
+    import getopt
+    import sys
+
+    server = "."
+    thread_count = 0
+    msg_count = 500
+    try:
+        opts, args = getopt.getopt(sys.argv[1:], "s:t:m:vl")
+        for o, a in opts:
+            if o == "-s":
+                server = a
+            if o == "-m":
+                msg_count = int(a)
+            if o == "-t":
+                thread_count = int(a)
+            if o == "-v":
+                global verbose
+                verbose = 1
+            if o == "-l":
+                testLargeMessage(server)
+        msg = " ".join(args).encode("mbcs")
+    except getopt.error as msg:
+        print(msg)
+        my_name = os.path.split(sys.argv[0])[1]
+        print(
+            "Usage: %s [-v] [-s server] [-t thread_count=0] [-m msg_count=500] msg ..."
+            % my_name
+        )
+        print("       -v = verbose")
+        print(
+            "       Specifying a value for -t will stress test using that many threads."
+        )
+        return
+    testClient(server, msg)
+    if thread_count > 0:
+        print(
+            "Spawning %d threads each sending %d messages..."
+            % (thread_count, msg_count)
+        )
+        stressTestClient(server, thread_count, msg_count)
+
+
+if __name__ == "__main__":
+    main()
diff --git a/lib/win32/Demos/service/serviceEvents.py b/lib/win32/Demos/service/serviceEvents.py
new file mode 100644
index 00000000..a62784f9
--- /dev/null
+++ b/lib/win32/Demos/service/serviceEvents.py
@@ -0,0 +1,98 @@
+# A Demo of a service that takes advantage of the additional notifications
+# available in later Windows versions.
+
+# Note that all output is written as event log entries - so you must install
+# and start the service, then look at the event log for messages as events
+# are generated.
+
+# Events are generated for USB device insertion and removal, power state
+# changes and hardware profile events - so try putting your computer to
+# sleep and waking it, inserting a memory stick, etc then check the event log
+
+# Most event notification support lives around win32gui
+import servicemanager
+import win32con
+import win32event
+import win32gui
+import win32gui_struct
+import win32service
+import win32serviceutil
+
+GUID_DEVINTERFACE_USB_DEVICE = "{A5DCBF10-6530-11D2-901F-00C04FB951ED}"
+
+
+class EventDemoService(win32serviceutil.ServiceFramework):
+    _svc_name_ = "PyServiceEventDemo"
+    _svc_display_name_ = "Python Service Event Demo"
+    _svc_description_ = (
+        "Demonstrates a Python service which takes advantage of the extra notifications"
+    )
+
+    def __init__(self, args):
+        win32serviceutil.ServiceFramework.__init__(self, args)
+        self.hWaitStop = win32event.CreateEvent(None, 0, 0, None)
+        # register for a device notification - we pass our service handle
+        # instead of a window handle.
+        filter = win32gui_struct.PackDEV_BROADCAST_DEVICEINTERFACE(
+            GUID_DEVINTERFACE_USB_DEVICE
+        )
+        self.hdn = win32gui.RegisterDeviceNotification(
+            self.ssh, filter, win32con.DEVICE_NOTIFY_SERVICE_HANDLE
+        )
+
+    # Override the base class so we can accept additional events.
+    def GetAcceptedControls(self):
+        # say we accept them all.
+        rc = win32serviceutil.ServiceFramework.GetAcceptedControls(self)
+        rc |= (
+            win32service.SERVICE_ACCEPT_PARAMCHANGE
+            | win32service.SERVICE_ACCEPT_NETBINDCHANGE
+            | win32service.SERVICE_CONTROL_DEVICEEVENT
+            | win32service.SERVICE_ACCEPT_HARDWAREPROFILECHANGE
+            | win32service.SERVICE_ACCEPT_POWEREVENT
+            | win32service.SERVICE_ACCEPT_SESSIONCHANGE
+        )
+        return rc
+
+    # All extra events are sent via SvcOtherEx (SvcOther remains as a
+    # function taking only the first args for backwards compat)
+    def SvcOtherEx(self, control, event_type, data):
+        # This is only showing a few of the extra events - see the MSDN
+        # docs for "HandlerEx callback" for more info.
+        if control == win32service.SERVICE_CONTROL_DEVICEEVENT:
+            info = win32gui_struct.UnpackDEV_BROADCAST(data)
+            msg = "A device event occurred: %x - %s" % (event_type, info)
+        elif control == win32service.SERVICE_CONTROL_HARDWAREPROFILECHANGE:
+            msg = "A hardware profile changed: type=%s, data=%s" % (event_type, data)
+        elif control == win32service.SERVICE_CONTROL_POWEREVENT:
+            msg = "A power event: setting %s" % data
+        elif control == win32service.SERVICE_CONTROL_SESSIONCHANGE:
+            # data is a single elt tuple, but this could potentially grow
+            # in the future if the win32 struct does
+            msg = "Session event: type=%s, data=%s" % (event_type, data)
+        else:
+            msg = "Other event: code=%d, type=%s, data=%s" % (control, event_type, data)
+
+        servicemanager.LogMsg(
+            servicemanager.EVENTLOG_INFORMATION_TYPE,
+            0xF000,  #  generic message
+            (msg, ""),
+        )
+
+    def SvcStop(self):
+        self.ReportServiceStatus(win32service.SERVICE_STOP_PENDING)
+        win32event.SetEvent(self.hWaitStop)
+
+    def SvcDoRun(self):
+        # do nothing at all - just wait to be stopped
+        win32event.WaitForSingleObject(self.hWaitStop, win32event.INFINITE)
+        # Write a stop message.
+        servicemanager.LogMsg(
+            servicemanager.EVENTLOG_INFORMATION_TYPE,
+            servicemanager.PYS_SERVICE_STOPPED,
+            (self._svc_name_, ""),
+        )
+
+
+if __name__ == "__main__":
+    win32serviceutil.HandleCommandLine(EventDemoService)
diff --git a/lib/win32/Demos/timer_demo.py b/lib/win32/Demos/timer_demo.py
new file mode 100644
index 00000000..61115f06
--- /dev/null
+++ b/lib/win32/Demos/timer_demo.py
@@ -0,0 +1,72 @@
+# -*- Mode: Python; tab-width: 4 -*-
+#
+
+# This module, and the timer.pyd core timer support, were written by
+# Sam Rushing (rushing@nightmare.com)
+
+import time
+
+# Timers are based on Windows messages.  So we need
+# to do the event-loop thing!
+import timer
+import win32event
+import win32gui
+
+# glork holds a simple counter for us.
+
+
+class glork:
+    def __init__(self, delay=1000, max=10):
+        self.x = 0
+        self.max = max
+        self.id = timer.set_timer(delay, self.increment)
+        # Could use the threading module, but this is
+        # a win32 extension test after all! :-)
+        self.event = win32event.CreateEvent(None, 0, 0, None)
+
+    def increment(self, id, time):
+        print("x = %d" % self.x)
+        self.x = self.x + 1
+        # if we've reached the max count,
+        # kill off the timer.
+        if self.x > self.max:
+            # we could have used 'self.id' here, too
+            timer.kill_timer(id)
+            win32event.SetEvent(self.event)
+
+
+# create a counter that will count from '1' thru '10', incrementing
+# once a second, and then stop.
+
+
+def demo(delay=1000, stop=10):
+    g = glork(delay, stop)
+    # Timers are message based - so we need
+    # To run a message loop while waiting for our timers
+    # to expire.
+    start_time = time.time()
+    while 1:
+        # We can't simply give a timeout of 30 seconds, as
+        # we may continouusly be recieving other input messages,
+        # and therefore never expire.
+        rc = win32event.MsgWaitForMultipleObjects(
+            (g.event,),  # list of objects
+            0,  # wait all
+            500,  # timeout
+            win32event.QS_ALLEVENTS,  # type of input
+        )
+        if rc == win32event.WAIT_OBJECT_0:
+            # Event signalled.
+            break
+        elif rc == win32event.WAIT_OBJECT_0 + 1:
+            # Message waiting.
+            if win32gui.PumpWaitingMessages():
+                raise RuntimeError("We got an unexpected WM_QUIT message!")
+        else:
+            # This wait timed-out.
+            if time.time() - start_time > 30:
+                raise RuntimeError("We timed out waiting for the timers to expire!")
+
+
+if __name__ == "__main__":
+    demo()
diff --git a/lib/win32/Demos/win32clipboardDemo.py b/lib/win32/Demos/win32clipboardDemo.py
new file mode 100644
index 00000000..1252ff7d
--- /dev/null
+++ b/lib/win32/Demos/win32clipboardDemo.py
@@ -0,0 +1,145 @@
+# win32clipboardDemo.py
+#
+# Demo/test of the win32clipboard module.
+
+import win32con
+from pywin32_testutil import str2bytes  # py3k-friendly helper
+from win32clipboard import *
+
+if not __debug__:
+    print("WARNING: The test code in this module uses assert")
+    print("This instance of Python has asserts disabled, so many tests will be skipped")
+
+cf_names = {}
+# Build map of CF_* constants to names.
+for name, val in list(win32con.__dict__.items()):
+    if name[:3] == "CF_" and name != "CF_SCREENFONTS":  # CF_SCREEN_FONTS==CF_TEXT!?!?
+        cf_names[val] = name
+
+
+def TestEmptyClipboard():
+    OpenClipboard()
+    try:
+        EmptyClipboard()
+        assert (
+            EnumClipboardFormats(0) == 0
+        ), "Clipboard formats were available after emptying it!"
+    finally:
+        CloseClipboard()
+
+
+def TestText():
+    OpenClipboard()
+    try:
+        text = "Hello from Python"
+        text_bytes = str2bytes(text)
+        SetClipboardText(text)
+        got = GetClipboardData(win32con.CF_TEXT)
+        # CF_TEXT always gives us 'bytes' back .
+        assert got == text_bytes, "Didnt get the correct result back - '%r'." % (got,)
+    finally:
+        CloseClipboard()
+
+    OpenClipboard()
+    try:
+        # CF_UNICODE text always gives unicode objects back.
+        got = GetClipboardData(win32con.CF_UNICODETEXT)
+        assert got == text, "Didnt get the correct result back - '%r'." % (got,)
+        assert type(got) == str, "Didnt get the correct result back - '%r'." % (got,)
+
+        # CF_OEMTEXT is a bytes-based format.
+        got = GetClipboardData(win32con.CF_OEMTEXT)
+        assert got == text_bytes, "Didnt get the correct result back - '%r'." % (got,)
+
+        # Unicode tests
+        EmptyClipboard()
+        text = "Hello from Python unicode"
+        text_bytes = str2bytes(text)
+        # Now set the Unicode value
+        SetClipboardData(win32con.CF_UNICODETEXT, text)
+        # Get it in Unicode.
+        got = GetClipboardData(win32con.CF_UNICODETEXT)
+        assert got == text, "Didnt get the correct result back - '%r'." % (got,)
+        assert type(got) == str, "Didnt get the correct result back - '%r'." % (got,)
+
+        # Close and open the clipboard to ensure auto-conversions take place.
+    finally:
+        CloseClipboard()
+
+    OpenClipboard()
+    try:
+        # Make sure I can still get the text as bytes
+        got = GetClipboardData(win32con.CF_TEXT)
+        assert got == text_bytes, "Didnt get the correct result back - '%r'." % (got,)
+        # Make sure we get back the correct types.
+        got = GetClipboardData(win32con.CF_UNICODETEXT)
+        assert type(got) == str, "Didnt get the correct result back - '%r'." % (got,)
+        got = GetClipboardData(win32con.CF_OEMTEXT)
+        assert got == text_bytes, "Didnt get the correct result back - '%r'." % (got,)
+        print("Clipboard text tests worked correctly")
+    finally:
+        CloseClipboard()
+
+
+def TestClipboardEnum():
+    OpenClipboard()
+    try:
+        # Enumerate over the clipboard types
+        enum = 0
+        while 1:
+            enum = EnumClipboardFormats(enum)
+            if enum == 0:
+                break
+            assert IsClipboardFormatAvailable(
+                enum
+            ), "Have format, but clipboard says it is not available!"
+            n = cf_names.get(enum, "")
+            if not n:
+                try:
+                    n = GetClipboardFormatName(enum)
+                except error:
+                    n = "unknown (%s)" % (enum,)
+
+            print("Have format", n)
+        print("Clipboard enumerator tests worked correctly")
+    finally:
+        CloseClipboard()
+
+
+class Foo:
+    def __init__(self, **kw):
+        self.__dict__.update(kw)
+
+    def __cmp__(self, other):
+        return cmp(self.__dict__, other.__dict__)
+
+    def __eq__(self, other):
+        return self.__dict__ == other.__dict__
+
+
+def TestCustomFormat():
+    OpenClipboard()
+    try:
+        # Just for the fun of it pickle Python objects through the clipboard
+        fmt = RegisterClipboardFormat("Python Pickle Format")
+        import pickle
+
+        pickled_object = Foo(a=1, b=2, Hi=3)
+        SetClipboardData(fmt, pickle.dumps(pickled_object))
+        # Now read it back.
+        data = GetClipboardData(fmt)
+        loaded_object = pickle.loads(data)
+        assert pickle.loads(data) == pickled_object, "Didnt get the correct data!"
+
+        print("Clipboard custom format tests worked correctly")
+    finally:
+        CloseClipboard()
+
+
+if __name__ == "__main__":
+    TestEmptyClipboard()
+    TestText()
+    TestCustomFormat()
+    TestClipboardEnum()
+    # And leave it empty at the end!
+    TestEmptyClipboard()
diff --git a/lib/win32/Demos/win32clipboard_bitmapdemo.py b/lib/win32/Demos/win32clipboard_bitmapdemo.py
new file mode 100644
index 00000000..7d453025
--- /dev/null
+++ b/lib/win32/Demos/win32clipboard_bitmapdemo.py
@@ -0,0 +1,117 @@
+import win32api
+import win32clipboard
+import win32con
+import win32gui
+
+
+class ViewerWindow:
+    def __init__(self):
+        self.hwndNextViewer = None
+
+    def OnPaint(self, hwnd, msg, wp, lp):
+        dc, ps = win32gui.BeginPaint(hwnd)
+        wndrect = win32gui.GetClientRect(hwnd)
+        wndwidth = wndrect[2] - wndrect[0]
+        wndheight = wndrect[3] - wndrect[1]
+        win32clipboard.OpenClipboard()
+        try:
+            try:
+                hbitmap = win32clipboard.GetClipboardData(win32clipboard.CF_BITMAP)
+            except TypeError:
+                font = win32gui.LOGFONT()
+                font.lfHeight = 15  # int(wndheight/20)
+                font.lfWidth = 15  # font.lfHeight
+                #            font.lfWeight=150
+                hf = win32gui.CreateFontIndirect(font)
+                win32gui.SelectObject(dc, hf)
+                win32gui.SetBkMode(dc, win32con.TRANSPARENT)
+                win32gui.SetTextColor(dc, win32api.RGB(0, 0, 0))
+                win32gui.DrawText(
+                    dc,
+                    "No bitmaps are in the clipboard\n(try pressing the PrtScn button)",
+                    -1,
+                    (0, 0, wndwidth, wndheight),
+                    win32con.DT_CENTER,
+                )
+            else:
+                bminfo = win32gui.GetObject(hbitmap)
+                dcDC = win32gui.CreateCompatibleDC(None)
+                win32gui.SelectObject(dcDC, hbitmap)
+                win32gui.StretchBlt(
+                    dc,
+                    0,
+                    0,
+                    wndwidth,
+                    wndheight,
+                    dcDC,
+                    0,
+                    0,
+                    bminfo.bmWidth,
+                    bminfo.bmHeight,
+                    win32con.SRCCOPY,
+                )
+                win32gui.DeleteDC(dcDC)
+                win32gui.EndPaint(hwnd, ps)
+        finally:
+            win32clipboard.CloseClipboard()
+        return 0
+
+    def OnDrawClipboard(self, hwnd, msg, wp, lp):
+        win32gui.InvalidateRect(hwnd, None, True)
+
+    def OnChangeCBChain(self, hwnd, msg, wp, lp):
+        # If the next window is closing, repair the chain.
+        if wp == self.hwndNextViewer:
+            self.hwndNextViewer = lp
+        # Otherwise, pass the message to the next link.
+        elif self.hwndNextViewer:
+            win32gui.SendMessage(self.hwndNextViewer, msg, wp, lp)
+
+    def OnCreate(self, hwnd, msg, wp, lp):
+        self.hwndNextViewer = win32gui.SetClipboardViewer(hwnd)
+
+    def OnClose(self, hwnd, msg, wp, lp):
+        win32clipboard.ChangeClipboardChain(hwnd, self.hwndNextViewer)
+        win32gui.DestroyWindow(hwnd)
+        win32gui.PostQuitMessage(0)
+
+    def go(self):
+        wndproc = {
+            win32con.WM_PAINT: self.OnPaint,
+            win32con.WM_CLOSE: self.OnClose,
+            win32con.WM_CREATE: self.OnCreate,
+            win32con.WM_DRAWCLIPBOARD: self.OnDrawClipboard,
+            win32con.WM_CHANGECBCHAIN: self.OnChangeCBChain,
+        }
+
+        wc = win32gui.WNDCLASS()
+        wc.lpszClassName = "test_win32clipboard_bmp"
+        wc.style = win32con.CS_GLOBALCLASS | win32con.CS_VREDRAW | win32con.CS_HREDRAW
+        wc.hbrBackground = win32con.COLOR_WINDOW + 1
+        wc.lpfnWndProc = wndproc
+        class_atom = win32gui.RegisterClass(wc)
+        hwnd = win32gui.CreateWindowEx(
+            0,
+            class_atom,
+            "ClipboardViewer",
+            win32con.WS_CAPTION
+            | win32con.WS_VISIBLE
+            | win32con.WS_THICKFRAME
+            | win32con.WS_SYSMENU,
+            100,
+            100,
+            900,
+            900,
+            0,
+            0,
+            0,
+            None,
+        )
+        win32clipboard.SetClipboardViewer(hwnd)
+        win32gui.PumpMessages()
+        win32gui.UnregisterClass(class_atom, None)
+
+
+if __name__ == "__main__":
+    w = ViewerWindow()
+    w.go()
diff --git a/lib/win32/Demos/win32comport_demo.py b/lib/win32/Demos/win32comport_demo.py
new file mode 100644
index 00000000..c0be2391
--- /dev/null
+++ b/lib/win32/Demos/win32comport_demo.py
@@ -0,0 +1,144 @@
+# This is a simple serial port terminal demo.
+#
+# Its primary purpose is to demonstrate the native serial port access offered via
+# win32file.
+
+# It uses 3 threads:
+# - The main thread, which cranks up the other 2 threads, then simply waits for them to exit.
+# - The user-input thread - blocks waiting for a keyboard character, and when found sends it
+#   out the COM port.  If the character is Ctrl+C, it stops, signalling the COM port thread to stop.
+# - The COM port thread is simply listening for input on the COM port, and prints it to the screen.
+
+# This demo uses userlapped IO, so that none of the read or write operations actually block (however,
+# in this sample, the very next thing we do _is_ block - so it shows off the concepts even though it
+# doesnt exploit them.
+
+import msvcrt  # For the getch() function.
+import sys
+import threading
+
+import win32con  # constants.
+from win32event import *  # We use events and the WaitFor[Multiple]Objects functions.
+from win32file import *  # The base COM port and file IO functions.
+
+
+def FindModem():
+    # Snoop over the comports, seeing if it is likely we have a modem.
+    for i in range(1, 5):
+        port = "COM%d" % (i,)
+        try:
+            handle = CreateFile(
+                port,
+                win32con.GENERIC_READ | win32con.GENERIC_WRITE,
+                0,  # exclusive access
+                None,  # no security
+                win32con.OPEN_EXISTING,
+                win32con.FILE_ATTRIBUTE_NORMAL,
+                None,
+            )
+            # It appears that an available COM port will always success here,
+            # just return 0 for the status flags.  We only care that it has _any_ status
+            # flags (and therefore probably a real modem)
+            if GetCommModemStatus(handle) != 0:
+                return port
+        except error:
+            pass  # No port, or modem status failed.
+    return None
+
+
+# A basic synchronous COM port file-like object
+class SerialTTY:
+    def __init__(self, port):
+        if type(port) == type(0):
+            port = "COM%d" % (port,)
+        self.handle = CreateFile(
+            port,
+            win32con.GENERIC_READ | win32con.GENERIC_WRITE,
+            0,  # exclusive access
+            None,  # no security
+            win32con.OPEN_EXISTING,
+            win32con.FILE_ATTRIBUTE_NORMAL | win32con.FILE_FLAG_OVERLAPPED,
+            None,
+        )
+        # Tell the port we want a notification on each char.
+        SetCommMask(self.handle, EV_RXCHAR)
+        # Setup a 4k buffer
+        SetupComm(self.handle, 4096, 4096)
+        # Remove anything that was there
+        PurgeComm(
+            self.handle, PURGE_TXABORT | PURGE_RXABORT | PURGE_TXCLEAR | PURGE_RXCLEAR
+        )
+        # Setup for overlapped IO.
+        timeouts = 0xFFFFFFFF, 0, 1000, 0, 1000
+        SetCommTimeouts(self.handle, timeouts)
+        # Setup the connection info.
+        dcb = GetCommState(self.handle)
+        dcb.BaudRate = CBR_115200
+        dcb.ByteSize = 8
+        dcb.Parity = NOPARITY
+        dcb.StopBits = ONESTOPBIT
+        SetCommState(self.handle, dcb)
+        print("Connected to %s at %s baud" % (port, dcb.BaudRate))
+
+    def _UserInputReaderThread(self):
+        overlapped = OVERLAPPED()
+        overlapped.hEvent = CreateEvent(None, 1, 0, None)
+        try:
+            while 1:
+                ch = msvcrt.getch()
+                if ord(ch) == 3:
+                    break
+                WriteFile(self.handle, ch, overlapped)
+                # Wait for the write to complete.
+                WaitForSingleObject(overlapped.hEvent, INFINITE)
+        finally:
+            SetEvent(self.eventStop)
+
+    def _ComPortThread(self):
+        overlapped = OVERLAPPED()
+        overlapped.hEvent = CreateEvent(None, 1, 0, None)
+        while 1:
+            # XXX - note we could _probably_ just use overlapped IO on the win32file.ReadFile() statement
+            # XXX but this tests the COM stuff!
+            rc, mask = WaitCommEvent(self.handle, overlapped)
+            if rc == 0:  # Character already ready!
+                SetEvent(overlapped.hEvent)
+            rc = WaitForMultipleObjects(
+                [overlapped.hEvent, self.eventStop], 0, INFINITE
+            )
+            if rc == WAIT_OBJECT_0:
+                # Some input - read and print it
+                flags, comstat = ClearCommError(self.handle)
+                rc, data = ReadFile(self.handle, comstat.cbInQue, overlapped)
+                WaitForSingleObject(overlapped.hEvent, INFINITE)
+                sys.stdout.write(data)
+            else:
+                # Stop the thread!
+                # Just incase the user input thread uis still going, close it
+                sys.stdout.close()
+                break
+
+    def Run(self):
+        self.eventStop = CreateEvent(None, 0, 0, None)
+        # Start the reader and writer threads.
+        user_thread = threading.Thread(target=self._UserInputReaderThread)
+        user_thread.start()
+        com_thread = threading.Thread(target=self._ComPortThread)
+        com_thread.start()
+        user_thread.join()
+        com_thread.join()
+
+
+if __name__ == "__main__":
+    print("Serial port terminal demo - press Ctrl+C to exit")
+    if len(sys.argv) <= 1:
+        port = FindModem()
+        if port is None:
+            print("No COM port specified, and no modem could be found")
+            print("Please re-run this script with the name of a COM port (eg COM3)")
+            sys.exit(1)
+    else:
+        port = sys.argv[1]
+
+    tty = SerialTTY(port)
+    tty.Run()
diff --git a/lib/win32/Demos/win32console_demo.py b/lib/win32/Demos/win32console_demo.py
new file mode 100644
index 00000000..bb9162bf
--- /dev/null
+++ b/lib/win32/Demos/win32console_demo.py
@@ -0,0 +1,135 @@
+import time
+
+import win32con
+import win32console
+
+virtual_keys = {}
+for k, v in list(win32con.__dict__.items()):
+    if k.startswith("VK_"):
+        virtual_keys[v] = k
+
+free_console = True
+try:
+    win32console.AllocConsole()
+except win32console.error as exc:
+    if exc.winerror != 5:
+        raise
+    ## only free console if one was created successfully
+    free_console = False
+
+stdout = win32console.GetStdHandle(win32console.STD_OUTPUT_HANDLE)
+stdin = win32console.GetStdHandle(win32console.STD_INPUT_HANDLE)
+newbuffer = win32console.CreateConsoleScreenBuffer()
+newbuffer.SetConsoleActiveScreenBuffer()
+newbuffer.SetConsoleTextAttribute(
+    win32console.FOREGROUND_RED
+    | win32console.FOREGROUND_INTENSITY
+    | win32console.BACKGROUND_GREEN
+    | win32console.BACKGROUND_INTENSITY
+)
+newbuffer.WriteConsole("This is a new screen buffer\n")
+
+## test setting screen buffer and window size
+## screen buffer size cannot be smaller than window size
+window_size = newbuffer.GetConsoleScreenBufferInfo()["Window"]
+coord = win32console.PyCOORDType(X=window_size.Right + 20, Y=window_size.Bottom + 20)
+newbuffer.SetConsoleScreenBufferSize(coord)
+
+window_size.Right += 10
+window_size.Bottom += 10
+newbuffer.SetConsoleWindowInfo(Absolute=True, ConsoleWindow=window_size)
+
+## write some records to the input queue
+x = win32console.PyINPUT_RECORDType(win32console.KEY_EVENT)
+x.Char = "X"
+x.KeyDown = True
+x.RepeatCount = 1
+x.VirtualKeyCode = 0x58
+x.ControlKeyState = win32con.SHIFT_PRESSED
+
+z = win32console.PyINPUT_RECORDType(win32console.KEY_EVENT)
+z.Char = "Z"
+z.KeyDown = True
+z.RepeatCount = 1
+z.VirtualKeyCode = 0x5A
+z.ControlKeyState = win32con.SHIFT_PRESSED
+
+stdin.WriteConsoleInput([x, z, x])
+
+newbuffer.SetConsoleTextAttribute(
+    win32console.FOREGROUND_RED
+    | win32console.FOREGROUND_INTENSITY
+    | win32console.BACKGROUND_GREEN
+    | win32console.BACKGROUND_INTENSITY
+)
+newbuffer.WriteConsole("Press some keys, click some characters with the mouse\n")
+
+newbuffer.SetConsoleTextAttribute(
+    win32console.FOREGROUND_BLUE
+    | win32console.FOREGROUND_INTENSITY
+    | win32console.BACKGROUND_RED
+    | win32console.BACKGROUND_INTENSITY
+)
+newbuffer.WriteConsole('Hit "End" key to quit\n')
+
+breakout = False
+while not breakout:
+    input_records = stdin.ReadConsoleInput(10)
+    for input_record in input_records:
+        if input_record.EventType == win32console.KEY_EVENT:
+            if input_record.KeyDown:
+                if input_record.Char == "\0":
+                    newbuffer.WriteConsole(
+                        virtual_keys.get(
+                            input_record.VirtualKeyCode,
+                            "VirtualKeyCode: %s" % input_record.VirtualKeyCode,
+                        )
+                    )
+                else:
+                    newbuffer.WriteConsole(input_record.Char)
+                if input_record.VirtualKeyCode == win32con.VK_END:
+                    breakout = True
+                    break
+        elif input_record.EventType == win32console.MOUSE_EVENT:
+            if input_record.EventFlags == 0:  ## 0 indicates a button event
+                if input_record.ButtonState != 0:  ## exclude button releases
+                    pos = input_record.MousePosition
+                    # switch the foreground and background colors of the character that was clicked
+                    attr = newbuffer.ReadConsoleOutputAttribute(
+                        Length=1, ReadCoord=pos
+                    )[0]
+                    new_attr = attr
+                    if attr & win32console.FOREGROUND_BLUE:
+                        new_attr = (
+                            new_attr & ~win32console.FOREGROUND_BLUE
+                        ) | win32console.BACKGROUND_BLUE
+                    if attr & win32console.FOREGROUND_RED:
+                        new_attr = (
+                            new_attr & ~win32console.FOREGROUND_RED
+                        ) | win32console.BACKGROUND_RED
+                    if attr & win32console.FOREGROUND_GREEN:
+                        new_attr = (
+                            new_attr & ~win32console.FOREGROUND_GREEN
+                        ) | win32console.BACKGROUND_GREEN
+
+                    if attr & win32console.BACKGROUND_BLUE:
+                        new_attr = (
+                            new_attr & ~win32console.BACKGROUND_BLUE
+                        ) | win32console.FOREGROUND_BLUE
+                    if attr & win32console.BACKGROUND_RED:
+                        new_attr = (
+                            new_attr & ~win32console.BACKGROUND_RED
+                        ) | win32console.FOREGROUND_RED
+                    if attr & win32console.BACKGROUND_GREEN:
+                        new_attr = (
+                            new_attr & ~win32console.BACKGROUND_GREEN
+                        ) | win32console.FOREGROUND_GREEN
+                    newbuffer.WriteConsoleOutputAttribute((new_attr,), pos)
+        else:
+            newbuffer.WriteConsole(str(input_record))
+    time.sleep(0.1)
+
+stdout.SetConsoleActiveScreenBuffer()
+newbuffer.Close()
+if free_console:
+    win32console.FreeConsole()
diff --git a/lib/win32/Demos/win32cred_demo.py b/lib/win32/Demos/win32cred_demo.py
new file mode 100644
index 00000000..3b49ca7c
--- /dev/null
+++ b/lib/win32/Demos/win32cred_demo.py
@@ -0,0 +1,82 @@
+"""
+Demonstrates prompting for credentials, saving, and loggging on with marshalled credential.
+Also shows how to load user's profile
+"""
+
+import win32api
+import win32con
+import win32cred
+import win32net
+import win32profile
+import win32security
+
+## Prompt for a username/pwd for local computer
+uiinfo = {
+    "MessageText": "Enter credentials for local machine",
+    "CaptionText": "win32cred_demo.py",
+}
+target, pwd, save = win32cred.CredUIPromptForCredentials(
+    TargetName=win32api.GetComputerName(),
+    AuthError=0,
+    Flags=win32cred.CREDUI_FLAGS_DO_NOT_PERSIST
+    | win32cred.CREDUI_FLAGS_SHOW_SAVE_CHECK_BOX,
+    Save=False,
+    UiInfo=uiinfo,
+)
+
+attrs = [
+    {"Keyword": "attr1", "Flags": 0, "Value": "unicode data"},
+    {"Keyword": "attr2", "Flags": 0, "Value": b"character data"},
+]
+cred = {
+    "Comment": "Created by win32cred_demo.py",
+    "UserName": target,
+    "TargetAlias": None,
+    "TargetName": target,
+    "CredentialBlob": pwd,
+    "Flags": win32cred.CRED_FLAGS_USERNAME_TARGET,
+    "Persist": win32cred.CRED_PERSIST_ENTERPRISE,
+    "Type": win32cred.CRED_TYPE_DOMAIN_PASSWORD,
+    "Attributes": attrs,
+}
+win32cred.CredWrite(cred)
+pwd = None
+print(win32cred.CredRead(target, win32cred.CRED_TYPE_DOMAIN_PASSWORD))
+
+## Marshal saved credential and use it to log on
+mc = win32cred.CredMarshalCredential(win32cred.UsernameTargetCredential, target)
+
+# As of pywin32 301 this no longer works for markh and unclear when it stopped, or
+# even if it ever did! # Fails in Python 2.7 too, so not a 3.x regression.
+try:
+    th = win32security.LogonUser(
+        mc,
+        None,
+        "",
+        win32con.LOGON32_LOGON_INTERACTIVE,
+        win32con.LOGON32_PROVIDER_DEFAULT,
+    )
+    win32security.ImpersonateLoggedOnUser(th)
+    print("GetUserName:", win32api.GetUserName())
+    win32security.RevertToSelf()
+
+    ## Load user's profile.  (first check if user has a roaming profile)
+    username, domain = win32cred.CredUIParseUserName(target)
+    user_info_4 = win32net.NetUserGetInfo(None, username, 4)
+    profilepath = user_info_4["profile"]
+    ## LoadUserProfile apparently doesn't like an empty string
+    if not profilepath:
+        profilepath = None
+
+    ## leave Flags in since 2.3 still chokes on some types of optional keyword args
+    hk = win32profile.LoadUserProfile(
+        th, {"UserName": username, "Flags": 0, "ProfilePath": profilepath}
+    )
+    ## Get user's environment variables in a form that can be passed to win32process.CreateProcessAsUser
+    env = win32profile.CreateEnvironmentBlock(th, False)
+
+    ## Cleanup should probably be in a finally block
+    win32profile.UnloadUserProfile(th, hk)
+    th.Close()
+except win32security.error as exc:
+    print("Failed to login for some reason", exc)
diff --git a/lib/win32/Demos/win32fileDemo.py b/lib/win32/Demos/win32fileDemo.py
new file mode 100644
index 00000000..a8099925
--- /dev/null
+++ b/lib/win32/Demos/win32fileDemo.py
@@ -0,0 +1,41 @@
+# This is a "demo" of win32file - it used to be more a test case than a
+# demo, so has been moved to the test directory.
+
+import os
+
+# Please contribute your favourite simple little demo.
+import win32api
+import win32con
+import win32file
+
+
+# A very simple demo - note that this does no more than you can do with
+# builtin Python file objects, so for something as simple as this, you
+# generally *should* use builtin Python objects.  Only use win32file etc
+# when you need win32 specific features not available in Python.
+def SimpleFileDemo():
+    testName = os.path.join(win32api.GetTempPath(), "win32file_demo_test_file")
+    if os.path.exists(testName):
+        os.unlink(testName)
+    # Open the file for writing.
+    handle = win32file.CreateFile(
+        testName, win32file.GENERIC_WRITE, 0, None, win32con.CREATE_NEW, 0, None
+    )
+    test_data = "Hello\0there".encode("ascii")
+    win32file.WriteFile(handle, test_data)
+    handle.Close()
+    # Open it for reading.
+    handle = win32file.CreateFile(
+        testName, win32file.GENERIC_READ, 0, None, win32con.OPEN_EXISTING, 0, None
+    )
+    rc, data = win32file.ReadFile(handle, 1024)
+    handle.Close()
+    if data == test_data:
+        print("Successfully wrote and read a file")
+    else:
+        raise Exception("Got different data back???")
+    os.unlink(testName)
+
+
+if __name__ == "__main__":
+    SimpleFileDemo()
diff --git a/lib/win32/Demos/win32gui_demo.py b/lib/win32/Demos/win32gui_demo.py
new file mode 100644
index 00000000..41844a92
--- /dev/null
+++ b/lib/win32/Demos/win32gui_demo.py
@@ -0,0 +1,177 @@
+# The start of a win32gui generic demo.
+# Feel free to contribute more demos back ;-)
+
+import math
+import random
+import time
+
+import win32api
+import win32con
+import win32gui
+
+
+def _MyCallback(hwnd, extra):
+    hwnds, classes = extra
+    hwnds.append(hwnd)
+    classes[win32gui.GetClassName(hwnd)] = 1
+
+
+def TestEnumWindows():
+    windows = []
+    classes = {}
+    win32gui.EnumWindows(_MyCallback, (windows, classes))
+    print(
+        "Enumerated a total of %d windows with %d classes"
+        % (len(windows), len(classes))
+    )
+    if "tooltips_class32" not in classes:
+        print("Hrmmmm - I'm very surprised to not find a 'tooltips_class32' class.")
+
+
+def OnPaint_1(hwnd, msg, wp, lp):
+    dc, ps = win32gui.BeginPaint(hwnd)
+    win32gui.SetGraphicsMode(dc, win32con.GM_ADVANCED)
+    br = win32gui.CreateSolidBrush(win32api.RGB(255, 0, 0))
+    win32gui.SelectObject(dc, br)
+    angle = win32gui.GetWindowLong(hwnd, win32con.GWL_USERDATA)
+    win32gui.SetWindowLong(hwnd, win32con.GWL_USERDATA, angle + 2)
+    r_angle = angle * (math.pi / 180)
+    win32gui.SetWorldTransform(
+        dc,
+        {
+            "M11": math.cos(r_angle),
+            "M12": math.sin(r_angle),
+            "M21": math.sin(r_angle) * -1,
+            "M22": math.cos(r_angle),
+            "Dx": 250,
+            "Dy": 250,
+        },
+    )
+    win32gui.MoveToEx(dc, 250, 250)
+    win32gui.BeginPath(dc)
+    win32gui.Pie(dc, 10, 70, 200, 200, 350, 350, 75, 10)
+    win32gui.Chord(dc, 200, 200, 850, 0, 350, 350, 75, 10)
+    win32gui.LineTo(dc, 300, 300)
+    win32gui.LineTo(dc, 100, 20)
+    win32gui.LineTo(dc, 20, 100)
+    win32gui.LineTo(dc, 400, 0)
+    win32gui.LineTo(dc, 0, 400)
+    win32gui.EndPath(dc)
+    win32gui.StrokeAndFillPath(dc)
+    win32gui.EndPaint(hwnd, ps)
+    return 0
+
+
+wndproc_1 = {win32con.WM_PAINT: OnPaint_1}
+
+
+def OnPaint_2(hwnd, msg, wp, lp):
+    dc, ps = win32gui.BeginPaint(hwnd)
+    win32gui.SetGraphicsMode(dc, win32con.GM_ADVANCED)
+    l, t, r, b = win32gui.GetClientRect(hwnd)
+
+    for x in range(25):
+        vertices = (
+            {
+                "x": int(random.random() * r),
+                "y": int(random.random() * b),
+                "Red": int(random.random() * 0xFF00),
+                "Green": 0,
+                "Blue": 0,
+                "Alpha": 0,
+            },
+            {
+                "x": int(random.random() * r),
+                "y": int(random.random() * b),
+                "Red": 0,
+                "Green": int(random.random() * 0xFF00),
+                "Blue": 0,
+                "Alpha": 0,
+            },
+            {
+                "x": int(random.random() * r),
+                "y": int(random.random() * b),
+                "Red": 0,
+                "Green": 0,
+                "Blue": int(random.random() * 0xFF00),
+                "Alpha": 0,
+            },
+        )
+        mesh = ((0, 1, 2),)
+        win32gui.GradientFill(dc, vertices, mesh, win32con.GRADIENT_FILL_TRIANGLE)
+    win32gui.EndPaint(hwnd, ps)
+    return 0
+
+
+wndproc_2 = {win32con.WM_PAINT: OnPaint_2}
+
+
+def TestSetWorldTransform():
+    wc = win32gui.WNDCLASS()
+    wc.lpszClassName = "test_win32gui_1"
+    wc.style = win32con.CS_GLOBALCLASS | win32con.CS_VREDRAW | win32con.CS_HREDRAW
+    wc.hbrBackground = win32con.COLOR_WINDOW + 1
+    wc.lpfnWndProc = wndproc_1
+    class_atom = win32gui.RegisterClass(wc)
+    hwnd = win32gui.CreateWindow(
+        wc.lpszClassName,
+        "Spin the Lobster!",
+        win32con.WS_CAPTION | win32con.WS_VISIBLE,
+        100,
+        100,
+        900,
+        900,
+        0,
+        0,
+        0,
+        None,
+    )
+    for x in range(500):
+        win32gui.InvalidateRect(hwnd, None, True)
+        win32gui.PumpWaitingMessages()
+        time.sleep(0.01)
+    win32gui.DestroyWindow(hwnd)
+    win32gui.UnregisterClass(wc.lpszClassName, None)
+
+
+def TestGradientFill():
+    wc = win32gui.WNDCLASS()
+    wc.lpszClassName = "test_win32gui_2"
+    wc.style = win32con.CS_GLOBALCLASS | win32con.CS_VREDRAW | win32con.CS_HREDRAW
+    wc.hbrBackground = win32con.COLOR_WINDOW + 1
+    wc.lpfnWndProc = wndproc_2
+    class_atom = win32gui.RegisterClass(wc)
+    hwnd = win32gui.CreateWindowEx(
+        0,
+        class_atom,
+        "Kaleidoscope",
+        win32con.WS_CAPTION
+        | win32con.WS_VISIBLE
+        | win32con.WS_THICKFRAME
+        | win32con.WS_SYSMENU,
+        100,
+        100,
+        900,
+        900,
+        0,
+        0,
+        0,
+        None,
+    )
+    s = win32gui.GetWindowLong(hwnd, win32con.GWL_EXSTYLE)
+    win32gui.SetWindowLong(hwnd, win32con.GWL_EXSTYLE, s | win32con.WS_EX_LAYERED)
+    win32gui.SetLayeredWindowAttributes(hwnd, 0, 175, win32con.LWA_ALPHA)
+    for x in range(30):
+        win32gui.InvalidateRect(hwnd, None, True)
+        win32gui.PumpWaitingMessages()
+        time.sleep(0.3)
+    win32gui.DestroyWindow(hwnd)
+    win32gui.UnregisterClass(class_atom, None)
+
+
+print("Enumerating all windows...")
+TestEnumWindows()
+print("Testing drawing functions ...")
+TestSetWorldTransform()
+TestGradientFill()
+print("All tests done!")
diff --git a/lib/win32/Demos/win32gui_devicenotify.py b/lib/win32/Demos/win32gui_devicenotify.py
new file mode 100644
index 00000000..34ad8a25
--- /dev/null
+++ b/lib/win32/Demos/win32gui_devicenotify.py
@@ -0,0 +1,107 @@
+# Demo RegisterDeviceNotification etc.  Creates a hidden window to receive
+# notifications.  See serviceEvents.py for an example of a service doing
+# that.
+import sys
+import time
+
+import win32api
+import win32con
+import win32file
+import win32gui
+import win32gui_struct
+import winnt
+
+# These device GUIDs are from Ioevent.h in the Windows SDK.  Ideally they
+# could be collected somewhere for pywin32...
+GUID_DEVINTERFACE_USB_DEVICE = "{A5DCBF10-6530-11D2-901F-00C04FB951ED}"
+
+
+# WM_DEVICECHANGE message handler.
+def OnDeviceChange(hwnd, msg, wp, lp):
+    # Unpack the 'lp' into the appropriate DEV_BROADCAST_* structure,
+    # using the self-identifying data inside the DEV_BROADCAST_HDR.
+    info = win32gui_struct.UnpackDEV_BROADCAST(lp)
+    print("Device change notification:", wp, str(info))
+    if (
+        wp == win32con.DBT_DEVICEQUERYREMOVE
+        and info.devicetype == win32con.DBT_DEVTYP_HANDLE
+    ):
+        # Our handle is stored away in the structure - just close it
+        print("Device being removed - closing handle")
+        win32file.CloseHandle(info.handle)
+        # and cancel our notifications - if it gets plugged back in we get
+        # the same notification and try and close the same handle...
+        win32gui.UnregisterDeviceNotification(info.hdevnotify)
+    return True
+
+
+def TestDeviceNotifications(dir_names):
+    wc = win32gui.WNDCLASS()
+    wc.lpszClassName = "test_devicenotify"
+    wc.style = win32con.CS_GLOBALCLASS | win32con.CS_VREDRAW | win32con.CS_HREDRAW
+    wc.hbrBackground = win32con.COLOR_WINDOW + 1
+    wc.lpfnWndProc = {win32con.WM_DEVICECHANGE: OnDeviceChange}
+    class_atom = win32gui.RegisterClass(wc)
+    hwnd = win32gui.CreateWindow(
+        wc.lpszClassName,
+        "Testing some devices",
+        # no need for it to be visible.
+        win32con.WS_CAPTION,
+        100,
+        100,
+        900,
+        900,
+        0,
+        0,
+        0,
+        None,
+    )
+
+    hdevs = []
+    # Watch for all USB device notifications
+    filter = win32gui_struct.PackDEV_BROADCAST_DEVICEINTERFACE(
+        GUID_DEVINTERFACE_USB_DEVICE
+    )
+    hdev = win32gui.RegisterDeviceNotification(
+        hwnd, filter, win32con.DEVICE_NOTIFY_WINDOW_HANDLE
+    )
+    hdevs.append(hdev)
+    # and create handles for all specified directories
+    for d in dir_names:
+        hdir = win32file.CreateFile(
+            d,
+            winnt.FILE_LIST_DIRECTORY,
+            winnt.FILE_SHARE_READ | winnt.FILE_SHARE_WRITE | winnt.FILE_SHARE_DELETE,
+            None,  # security attributes
+            win32con.OPEN_EXISTING,
+            win32con.FILE_FLAG_BACKUP_SEMANTICS
+            | win32con.FILE_FLAG_OVERLAPPED,  # required privileges: SE_BACKUP_NAME and SE_RESTORE_NAME.
+            None,
+        )
+
+        filter = win32gui_struct.PackDEV_BROADCAST_HANDLE(hdir)
+        hdev = win32gui.RegisterDeviceNotification(
+            hwnd, filter, win32con.DEVICE_NOTIFY_WINDOW_HANDLE
+        )
+        hdevs.append(hdev)
+
+    # now start a message pump and wait for messages to be delivered.
+    print("Watching", len(hdevs), "handles - press Ctrl+C to terminate, or")
+    print("add and remove some USB devices...")
+    if not dir_names:
+        print("(Note you can also pass paths to watch on the command-line - eg,")
+        print("pass the root of an inserted USB stick to see events specific to")
+        print("that volume)")
+    while 1:
+        win32gui.PumpWaitingMessages()
+        time.sleep(0.01)
+    win32gui.DestroyWindow(hwnd)
+    win32gui.UnregisterClass(wc.lpszClassName, None)
+
+
+if __name__ == "__main__":
+    # optionally pass device/directory names to watch for notifications.
+    # Eg, plug in a USB device - assume it connects as E: - then execute:
+    # % win32gui_devicenotify.py E:
+    # Then remove and insert the device.
+    TestDeviceNotifications(sys.argv[1:])
diff --git a/lib/win32/Demos/win32gui_dialog.py b/lib/win32/Demos/win32gui_dialog.py
new file mode 100644
index 00000000..e3b89ba9
--- /dev/null
+++ b/lib/win32/Demos/win32gui_dialog.py
@@ -0,0 +1,458 @@
+# A demo of a fairly complex dialog.
+#
+# Features:
+# * Uses a "dynamic dialog resource" to build the dialog.
+# * Uses a ListView control.
+# * Dynamically resizes content.
+# * Uses a second worker thread to fill the list.
+# * Demostrates support for windows XP themes.
+
+# If you are on Windows XP, and specify a '--noxp' argument, you will see:
+# * alpha-blend issues with icons
+# * The buttons are "old" style, rather than based on the XP theme.
+# Hence, using:
+#   import winxpgui as win32gui
+# is recommended.
+# Please report any problems.
+import sys
+
+if "--noxp" in sys.argv:
+    import win32gui
+else:
+    import winxpgui as win32gui
+
+import array
+import os
+import queue
+import struct
+
+import commctrl
+import win32api
+import win32con
+import win32gui_struct
+import winerror
+
+IDC_SEARCHTEXT = 1024
+IDC_BUTTON_SEARCH = 1025
+IDC_BUTTON_DISPLAY = 1026
+IDC_LISTBOX = 1027
+
+WM_SEARCH_RESULT = win32con.WM_USER + 512
+WM_SEARCH_FINISHED = win32con.WM_USER + 513
+
+
+class _WIN32MASKEDSTRUCT:
+    def __init__(self, **kw):
+        full_fmt = ""
+        for name, fmt, default, mask in self._struct_items_:
+            self.__dict__[name] = None
+            if fmt == "z":
+                full_fmt += "pi"
+            else:
+                full_fmt += fmt
+        for name, val in kw.items():
+            if name not in self.__dict__:
+                raise ValueError("LVITEM structures do not have an item '%s'" % (name,))
+            self.__dict__[name] = val
+
+    def __setattr__(self, attr, val):
+        if not attr.startswith("_") and attr not in self.__dict__:
+            raise AttributeError(attr)
+        self.__dict__[attr] = val
+
+    def toparam(self):
+        self._buffs = []
+        full_fmt = ""
+        vals = []
+        mask = 0
+        # calc the mask
+        for name, fmt, default, this_mask in self._struct_items_:
+            if this_mask is not None and self.__dict__.get(name) is not None:
+                mask |= this_mask
+        self.mask = mask
+        for name, fmt, default, this_mask in self._struct_items_:
+            val = self.__dict__[name]
+            if fmt == "z":
+                fmt = "Pi"
+                if val is None:
+                    vals.append(0)
+                    vals.append(0)
+                else:
+                    # Note this demo still works with byte strings.  An
+                    # alternate strategy would be to use unicode natively
+                    # and use the 'W' version of the messages - eg,
+                    # LVM_SETITEMW etc.
+                    val = val + "\0"
+                    if isinstance(val, str):
+                        val = val.encode("mbcs")
+                    str_buf = array.array("b", val)
+                    vals.append(str_buf.buffer_info()[0])
+                    vals.append(len(val))
+                    self._buffs.append(str_buf)  # keep alive during the call.
+            else:
+                if val is None:
+                    val = default
+                vals.append(val)
+            full_fmt += fmt
+        return struct.pack(*(full_fmt,) + tuple(vals))
+
+
+# NOTE: See the win32gui_struct module for an alternative way of dealing
+# with these structures
+class LVITEM(_WIN32MASKEDSTRUCT):
+    _struct_items_ = [
+        ("mask", "I", 0, None),
+        ("iItem", "i", 0, None),
+        ("iSubItem", "i", 0, None),
+        ("state", "I", 0, commctrl.LVIF_STATE),
+        ("stateMask", "I", 0, None),
+        ("text", "z", None, commctrl.LVIF_TEXT),
+        ("iImage", "i", 0, commctrl.LVIF_IMAGE),
+        ("lParam", "i", 0, commctrl.LVIF_PARAM),
+        ("iIdent", "i", 0, None),
+    ]
+
+
+class LVCOLUMN(_WIN32MASKEDSTRUCT):
+    _struct_items_ = [
+        ("mask", "I", 0, None),
+        ("fmt", "i", 0, commctrl.LVCF_FMT),
+        ("cx", "i", 0, commctrl.LVCF_WIDTH),
+        ("text", "z", None, commctrl.LVCF_TEXT),
+        ("iSubItem", "i", 0, commctrl.LVCF_SUBITEM),
+        ("iImage", "i", 0, commctrl.LVCF_IMAGE),
+        ("iOrder", "i", 0, commctrl.LVCF_ORDER),
+    ]
+
+
+class DemoWindowBase:
+    def __init__(self):
+        win32gui.InitCommonControls()
+        self.hinst = win32gui.dllhandle
+        self.list_data = {}
+
+    def _RegisterWndClass(self):
+        className = "PythonDocSearch"
+        message_map = {}
+        wc = win32gui.WNDCLASS()
+        wc.SetDialogProc()  # Make it a dialog class.
+        wc.hInstance = self.hinst
+        wc.lpszClassName = className
+        wc.style = win32con.CS_VREDRAW | win32con.CS_HREDRAW
+        wc.hCursor = win32gui.LoadCursor(0, win32con.IDC_ARROW)
+        wc.hbrBackground = win32con.COLOR_WINDOW + 1
+        wc.lpfnWndProc = message_map  # could also specify a wndproc.
+        # C code: wc.cbWndExtra = DLGWINDOWEXTRA + sizeof(HBRUSH) + (sizeof(COLORREF));
+        wc.cbWndExtra = win32con.DLGWINDOWEXTRA + struct.calcsize("Pi")
+        icon_flags = win32con.LR_LOADFROMFILE | win32con.LR_DEFAULTSIZE
+
+        ## py.ico went away in python 2.5, load from executable instead
+        this_app = win32api.GetModuleHandle(None)
+        try:
+            wc.hIcon = win32gui.LoadIcon(this_app, 1)  ## python.exe and pythonw.exe
+        except win32gui.error:
+            wc.hIcon = win32gui.LoadIcon(this_app, 135)  ## pythonwin's icon
+        try:
+            classAtom = win32gui.RegisterClass(wc)
+        except win32gui.error as err_info:
+            if err_info.winerror != winerror.ERROR_CLASS_ALREADY_EXISTS:
+                raise
+        return className
+
+    def _GetDialogTemplate(self, dlgClassName):
+        style = (
+            win32con.WS_THICKFRAME
+            | win32con.WS_POPUP
+            | win32con.WS_VISIBLE
+            | win32con.WS_CAPTION
+            | win32con.WS_SYSMENU
+            | win32con.DS_SETFONT
+            | win32con.WS_MINIMIZEBOX
+        )
+        cs = win32con.WS_CHILD | win32con.WS_VISIBLE
+        title = "Dynamic Dialog Demo"
+
+        # Window frame and title
+        dlg = [
+            [
+                title,
+                (0, 0, 210, 250),
+                style,
+                None,
+                (8, "MS Sans Serif"),
+                None,
+                dlgClassName,
+            ],
+        ]
+
+        # ID label and text box
+        dlg.append([130, "Enter something", -1, (5, 5, 200, 9), cs | win32con.SS_LEFT])
+        s = cs | win32con.WS_TABSTOP | win32con.WS_BORDER
+        dlg.append(["EDIT", None, IDC_SEARCHTEXT, (5, 15, 200, 12), s])
+
+        # Search/Display Buttons
+        # (x positions don't matter here)
+        s = cs | win32con.WS_TABSTOP
+        dlg.append(
+            [
+                128,
+                "Fill List",
+                IDC_BUTTON_SEARCH,
+                (5, 35, 50, 14),
+                s | win32con.BS_DEFPUSHBUTTON,
+            ]
+        )
+        s = win32con.BS_PUSHBUTTON | s
+        dlg.append([128, "Display", IDC_BUTTON_DISPLAY, (100, 35, 50, 14), s])
+
+        # List control.
+        # Can't make this work :(
+        ##        s = cs | win32con.WS_TABSTOP
+        ##        dlg.append(['SysListView32', "Title", IDC_LISTBOX, (5, 505, 200, 200), s])
+
+        return dlg
+
+    def _DoCreate(self, fn):
+        message_map = {
+            win32con.WM_SIZE: self.OnSize,
+            win32con.WM_COMMAND: self.OnCommand,
+            win32con.WM_NOTIFY: self.OnNotify,
+            win32con.WM_INITDIALOG: self.OnInitDialog,
+            win32con.WM_CLOSE: self.OnClose,
+            win32con.WM_DESTROY: self.OnDestroy,
+            WM_SEARCH_RESULT: self.OnSearchResult,
+            WM_SEARCH_FINISHED: self.OnSearchFinished,
+        }
+        dlgClassName = self._RegisterWndClass()
+        template = self._GetDialogTemplate(dlgClassName)
+        return fn(self.hinst, template, 0, message_map)
+
+    def _SetupList(self):
+        child_style = (
+            win32con.WS_CHILD
+            | win32con.WS_VISIBLE
+            | win32con.WS_BORDER
+            | win32con.WS_HSCROLL
+            | win32con.WS_VSCROLL
+        )
+        child_style |= (
+            commctrl.LVS_SINGLESEL | commctrl.LVS_SHOWSELALWAYS | commctrl.LVS_REPORT
+        )
+        self.hwndList = win32gui.CreateWindow(
+            "SysListView32",
+            None,
+            child_style,
+            0,
+            0,
+            100,
+            100,
+            self.hwnd,
+            IDC_LISTBOX,
+            self.hinst,
+            None,
+        )
+
+        child_ex_style = win32gui.SendMessage(
+            self.hwndList, commctrl.LVM_GETEXTENDEDLISTVIEWSTYLE, 0, 0
+        )
+        child_ex_style |= commctrl.LVS_EX_FULLROWSELECT
+        win32gui.SendMessage(
+            self.hwndList, commctrl.LVM_SETEXTENDEDLISTVIEWSTYLE, 0, child_ex_style
+        )
+
+        # Add an image list - use the builtin shell folder icon - this
+        # demonstrates the problem with alpha-blending of icons on XP if
+        # winxpgui is not used in place of win32gui.
+        il = win32gui.ImageList_Create(
+            win32api.GetSystemMetrics(win32con.SM_CXSMICON),
+            win32api.GetSystemMetrics(win32con.SM_CYSMICON),
+            commctrl.ILC_COLOR32 | commctrl.ILC_MASK,
+            1,  # initial size
+            0,
+        )  # cGrow
+
+        shell_dll = os.path.join(win32api.GetSystemDirectory(), "shell32.dll")
+        large, small = win32gui.ExtractIconEx(shell_dll, 4, 1)
+        win32gui.ImageList_ReplaceIcon(il, -1, small[0])
+        win32gui.DestroyIcon(small[0])
+        win32gui.DestroyIcon(large[0])
+        win32gui.SendMessage(
+            self.hwndList, commctrl.LVM_SETIMAGELIST, commctrl.LVSIL_SMALL, il
+        )
+
+        # Setup the list control columns.
+        lvc = LVCOLUMN(
+            mask=commctrl.LVCF_FMT
+            | commctrl.LVCF_WIDTH
+            | commctrl.LVCF_TEXT
+            | commctrl.LVCF_SUBITEM
+        )
+        lvc.fmt = commctrl.LVCFMT_LEFT
+        lvc.iSubItem = 1
+        lvc.text = "Title"
+        lvc.cx = 200
+        win32gui.SendMessage(self.hwndList, commctrl.LVM_INSERTCOLUMN, 0, lvc.toparam())
+        lvc.iSubItem = 0
+        lvc.text = "Order"
+        lvc.cx = 50
+        win32gui.SendMessage(self.hwndList, commctrl.LVM_INSERTCOLUMN, 0, lvc.toparam())
+
+        win32gui.UpdateWindow(self.hwnd)
+
+    def ClearListItems(self):
+        win32gui.SendMessage(self.hwndList, commctrl.LVM_DELETEALLITEMS)
+        self.list_data = {}
+
+    def AddListItem(self, data, *columns):
+        num_items = win32gui.SendMessage(self.hwndList, commctrl.LVM_GETITEMCOUNT)
+        item = LVITEM(text=columns[0], iItem=num_items)
+        new_index = win32gui.SendMessage(
+            self.hwndList, commctrl.LVM_INSERTITEM, 0, item.toparam()
+        )
+        col_no = 1
+        for col in columns[1:]:
+            item = LVITEM(text=col, iItem=new_index, iSubItem=col_no)
+            win32gui.SendMessage(self.hwndList, commctrl.LVM_SETITEM, 0, item.toparam())
+            col_no += 1
+        self.list_data[new_index] = data
+
+    def OnInitDialog(self, hwnd, msg, wparam, lparam):
+        self.hwnd = hwnd
+        # centre the dialog
+        desktop = win32gui.GetDesktopWindow()
+        l, t, r, b = win32gui.GetWindowRect(self.hwnd)
+        dt_l, dt_t, dt_r, dt_b = win32gui.GetWindowRect(desktop)
+        centre_x, centre_y = win32gui.ClientToScreen(
+            desktop, ((dt_r - dt_l) // 2, (dt_b - dt_t) // 2)
+        )
+        win32gui.MoveWindow(
+            hwnd, centre_x - (r // 2), centre_y - (b // 2), r - l, b - t, 0
+        )
+        self._SetupList()
+        l, t, r, b = win32gui.GetClientRect(self.hwnd)
+        self._DoSize(r - l, b - t, 1)
+
+    def _DoSize(self, cx, cy, repaint=1):
+        # right-justify the textbox.
+        ctrl = win32gui.GetDlgItem(self.hwnd, IDC_SEARCHTEXT)
+        l, t, r, b = win32gui.GetWindowRect(ctrl)
+        l, t = win32gui.ScreenToClient(self.hwnd, (l, t))
+        r, b = win32gui.ScreenToClient(self.hwnd, (r, b))
+        win32gui.MoveWindow(ctrl, l, t, cx - l - 5, b - t, repaint)
+        # The button.
+        ctrl = win32gui.GetDlgItem(self.hwnd, IDC_BUTTON_DISPLAY)
+        l, t, r, b = win32gui.GetWindowRect(ctrl)
+        l, t = win32gui.ScreenToClient(self.hwnd, (l, t))
+        r, b = win32gui.ScreenToClient(self.hwnd, (r, b))
+        list_y = b + 10
+        w = r - l
+        win32gui.MoveWindow(ctrl, cx - 5 - w, t, w, b - t, repaint)
+
+        # The list control
+        win32gui.MoveWindow(self.hwndList, 0, list_y, cx, cy - list_y, repaint)
+        # The last column of the list control.
+        new_width = cx - win32gui.SendMessage(
+            self.hwndList, commctrl.LVM_GETCOLUMNWIDTH, 0
+        )
+        win32gui.SendMessage(self.hwndList, commctrl.LVM_SETCOLUMNWIDTH, 1, new_width)
+
+    def OnSize(self, hwnd, msg, wparam, lparam):
+        x = win32api.LOWORD(lparam)
+        y = win32api.HIWORD(lparam)
+        self._DoSize(x, y)
+        return 1
+
+    def OnSearchResult(self, hwnd, msg, wparam, lparam):
+        try:
+            while 1:
+                params = self.result_queue.get(0)
+                self.AddListItem(*params)
+        except queue.Empty:
+            pass
+
+    def OnSearchFinished(self, hwnd, msg, wparam, lparam):
+        print("OnSearchFinished")
+
+    def OnNotify(self, hwnd, msg, wparam, lparam):
+        info = win32gui_struct.UnpackNMITEMACTIVATE(lparam)
+        if info.code == commctrl.NM_DBLCLK:
+            print("Double click on item", info.iItem + 1)
+        return 1
+
+    def OnCommand(self, hwnd, msg, wparam, lparam):
+        id = win32api.LOWORD(wparam)
+        if id == IDC_BUTTON_SEARCH:
+            self.ClearListItems()
+
+            def fill_slowly(q, hwnd):
+                import time
+
+                for i in range(20):
+                    q.put(("whatever", str(i + 1), "Search result " + str(i)))
+                    win32gui.PostMessage(hwnd, WM_SEARCH_RESULT, 0, 0)
+                    time.sleep(0.25)
+                win32gui.PostMessage(hwnd, WM_SEARCH_FINISHED, 0, 0)
+
+            import threading
+
+            self.result_queue = queue.Queue()
+            thread = threading.Thread(
+                target=fill_slowly, args=(self.result_queue, self.hwnd)
+            )
+            thread.start()
+        elif id == IDC_BUTTON_DISPLAY:
+            print("Display button selected")
+            sel = win32gui.SendMessage(
+                self.hwndList, commctrl.LVM_GETNEXTITEM, -1, commctrl.LVNI_SELECTED
+            )
+            print("The selected item is", sel + 1)
+
+    # These function differ based on how the window is used, so may be overridden
+    def OnClose(self, hwnd, msg, wparam, lparam):
+        raise NotImplementedError
+
+    def OnDestroy(self, hwnd, msg, wparam, lparam):
+        pass
+
+
+# An implementation suitable for use with the Win32 Window functions (ie, not
+# a true dialog)
+class DemoWindow(DemoWindowBase):
+    def CreateWindow(self):
+        # Create the window via CreateDialogBoxIndirect - it can then
+        # work as a "normal" window, once a message loop is established.
+        self._DoCreate(win32gui.CreateDialogIndirect)
+
+    def OnClose(self, hwnd, msg, wparam, lparam):
+        win32gui.DestroyWindow(hwnd)
+
+    # We need to arrange to a WM_QUIT message to be sent to our
+    # PumpMessages() loop.
+    def OnDestroy(self, hwnd, msg, wparam, lparam):
+        win32gui.PostQuitMessage(0)  # Terminate the app.
+
+
+# An implementation suitable for use with the Win32 Dialog functions.
+class DemoDialog(DemoWindowBase):
+    def DoModal(self):
+        return self._DoCreate(win32gui.DialogBoxIndirect)
+
+    def OnClose(self, hwnd, msg, wparam, lparam):
+        win32gui.EndDialog(hwnd, 0)
+
+
+def DemoModal():
+    w = DemoDialog()
+    w.DoModal()
+
+
+def DemoCreateWindow():
+    w = DemoWindow()
+    w.CreateWindow()
+    # PumpMessages runs until PostQuitMessage() is called by someone.
+    win32gui.PumpMessages()
+
+
+if __name__ == "__main__":
+    DemoModal()
+    DemoCreateWindow()
diff --git a/lib/win32/Demos/win32gui_menu.py b/lib/win32/Demos/win32gui_menu.py
new file mode 100644
index 00000000..c462b062
--- /dev/null
+++ b/lib/win32/Demos/win32gui_menu.py
@@ -0,0 +1,420 @@
+# Demonstrates some advanced menu concepts using win32gui.
+# This creates a taskbar icon which has some fancy menus (but note that
+# selecting the menu items does nothing useful - see win32gui_taskbar.py
+# for examples of this.
+
+# NOTE: This is a work in progress.  Todo:
+# * The "Checked" menu items don't work correctly - I'm not sure why.
+# * No support for GetMenuItemInfo.
+
+# Based on Andy McKay's demo code.
+from win32api import *
+
+# Try and use XP features, so we get alpha-blending etc.
+try:
+    from winxpgui import *
+except ImportError:
+    from win32gui import *
+
+import array
+import os
+import struct
+import sys
+
+import win32con
+from win32gui_struct import *
+
+this_dir = os.path.split(sys.argv[0])[0]
+
+
+class MainWindow:
+    def __init__(self):
+        message_map = {
+            win32con.WM_DESTROY: self.OnDestroy,
+            win32con.WM_COMMAND: self.OnCommand,
+            win32con.WM_USER + 20: self.OnTaskbarNotify,
+            # owner-draw related handlers.
+            win32con.WM_MEASUREITEM: self.OnMeasureItem,
+            win32con.WM_DRAWITEM: self.OnDrawItem,
+        }
+        # Register the Window class.
+        wc = WNDCLASS()
+        hinst = wc.hInstance = GetModuleHandle(None)
+        wc.lpszClassName = "PythonTaskbarDemo"
+        wc.lpfnWndProc = message_map  # could also specify a wndproc.
+        classAtom = RegisterClass(wc)
+        # Create the Window.
+        style = win32con.WS_OVERLAPPED | win32con.WS_SYSMENU
+        self.hwnd = CreateWindow(
+            classAtom,
+            "Taskbar Demo",
+            style,
+            0,
+            0,
+            win32con.CW_USEDEFAULT,
+            win32con.CW_USEDEFAULT,
+            0,
+            0,
+            hinst,
+            None,
+        )
+        UpdateWindow(self.hwnd)
+        iconPathName = os.path.abspath(os.path.join(sys.prefix, "pyc.ico"))
+        # py2.5 includes the .ico files in the DLLs dir for some reason.
+        if not os.path.isfile(iconPathName):
+            iconPathName = os.path.abspath(
+                os.path.join(os.path.split(sys.executable)[0], "DLLs", "pyc.ico")
+            )
+        if not os.path.isfile(iconPathName):
+            # Look in the source tree.
+            iconPathName = os.path.abspath(
+                os.path.join(os.path.split(sys.executable)[0], "..\\PC\\pyc.ico")
+            )
+        if os.path.isfile(iconPathName):
+            icon_flags = win32con.LR_LOADFROMFILE | win32con.LR_DEFAULTSIZE
+            hicon = LoadImage(
+                hinst, iconPathName, win32con.IMAGE_ICON, 0, 0, icon_flags
+            )
+        else:
+            iconPathName = None
+            print("Can't find a Python icon file - using default")
+            hicon = LoadIcon(0, win32con.IDI_APPLICATION)
+        self.iconPathName = iconPathName
+
+        # Load up some information about menus needed by our owner-draw code.
+        # The font to use on the menu.
+        ncm = SystemParametersInfo(win32con.SPI_GETNONCLIENTMETRICS)
+        self.font_menu = CreateFontIndirect(ncm["lfMenuFont"])
+        # spacing for our ownerdraw menus - not sure exactly what constants
+        # should be used (and if you owner-draw all items on the menu, it
+        # doesn't matter!)
+        self.menu_icon_height = GetSystemMetrics(win32con.SM_CYMENU) - 4
+        self.menu_icon_width = self.menu_icon_height
+        self.icon_x_pad = 8  # space from end of icon to start of text.
+        # A map we use to stash away data we need for ownerdraw.  Keyed
+        # by integer ID - that ID will be set in dwTypeData of the menu item.
+        self.menu_item_map = {}
+
+        # Finally, create the menu
+        self.createMenu()
+
+        flags = NIF_ICON | NIF_MESSAGE | NIF_TIP
+        nid = (self.hwnd, 0, flags, win32con.WM_USER + 20, hicon, "Python Demo")
+        Shell_NotifyIcon(NIM_ADD, nid)
+        print("Please right-click on the Python icon in the taskbar")
+
+    def createMenu(self):
+        self.hmenu = menu = CreatePopupMenu()
+        # Create our 'Exit' item with the standard, ugly 'close' icon.
+        item, extras = PackMENUITEMINFO(
+            text="Exit", hbmpItem=win32con.HBMMENU_MBAR_CLOSE, wID=1000
+        )
+        InsertMenuItem(menu, 0, 1, item)
+        # Create a 'text only' menu via InsertMenuItem rather then
+        # AppendMenu, just to prove we can!
+        item, extras = PackMENUITEMINFO(text="Text only item", wID=1001)
+        InsertMenuItem(menu, 0, 1, item)
+
+        load_bmp_flags = win32con.LR_LOADFROMFILE | win32con.LR_LOADTRANSPARENT
+        # These images are "over sized", so we load them scaled.
+        hbmp = LoadImage(
+            0,
+            os.path.join(this_dir, "images/smiley.bmp"),
+            win32con.IMAGE_BITMAP,
+            20,
+            20,
+            load_bmp_flags,
+        )
+
+        # Create a top-level menu with a bitmap
+        item, extras = PackMENUITEMINFO(
+            text="Menu with bitmap", hbmpItem=hbmp, wID=1002
+        )
+        InsertMenuItem(menu, 0, 1, item)
+
+        # Owner-draw menus mainly from:
+        # http://windowssdk.msdn.microsoft.com/en-us/library/ms647558.aspx
+        # and:
+        # http://www.codeguru.com/cpp/controls/menu/bitmappedmenus/article.php/c165
+
+        # Create one with an icon - this is *lots* more work - we do it
+        # owner-draw!  The primary reason is to handle transparency better -
+        # converting to a bitmap causes the background to be incorrect when
+        # the menu item is selected.  I can't see a simpler way.
+        # First, load the icon we want to use.
+        ico_x = GetSystemMetrics(win32con.SM_CXSMICON)
+        ico_y = GetSystemMetrics(win32con.SM_CYSMICON)
+        if self.iconPathName:
+            hicon = LoadImage(
+                0,
+                self.iconPathName,
+                win32con.IMAGE_ICON,
+                ico_x,
+                ico_y,
+                win32con.LR_LOADFROMFILE,
+            )
+        else:
+            shell_dll = os.path.join(GetSystemDirectory(), "shell32.dll")
+            large, small = win32gui.ExtractIconEx(shell_dll, 4, 1)
+            hicon = small[0]
+            DestroyIcon(large[0])
+
+        # Stash away the text and hicon in our map, and add the owner-draw
+        # item to the menu.
+        index = 0
+        self.menu_item_map[index] = (hicon, "Menu with owner-draw icon")
+        item, extras = PackMENUITEMINFO(
+            fType=win32con.MFT_OWNERDRAW, dwItemData=index, wID=1009
+        )
+        InsertMenuItem(menu, 0, 1, item)
+
+        # Add another icon-based icon - but this time using HBMMENU_CALLBACK
+        # in the hbmpItem elt, so we only need to draw the icon (ie, not the
+        # text or checkmark)
+        index = 1
+        self.menu_item_map[index] = (hicon, None)
+        item, extras = PackMENUITEMINFO(
+            text="Menu with o-d icon 2",
+            dwItemData=index,
+            hbmpItem=win32con.HBMMENU_CALLBACK,
+            wID=1010,
+        )
+        InsertMenuItem(menu, 0, 1, item)
+
+        # Add another icon-based icon - this time by converting
+        # via bitmap.  Note the icon background when selected is ugly :(
+        hdcBitmap = CreateCompatibleDC(0)
+        hdcScreen = GetDC(0)
+        hbm = CreateCompatibleBitmap(hdcScreen, ico_x, ico_y)
+        hbmOld = SelectObject(hdcBitmap, hbm)
+        SetBkMode(hdcBitmap, win32con.TRANSPARENT)
+        # Fill the background.
+        brush = GetSysColorBrush(win32con.COLOR_MENU)
+        FillRect(hdcBitmap, (0, 0, 16, 16), brush)
+        # unclear if brush needs to be freed.  Best clue I can find is:
+        # "GetSysColorBrush returns a cached brush instead of allocating a new
+        # one." - implies no DeleteObject.
+        # draw the icon
+        DrawIconEx(hdcBitmap, 0, 0, hicon, ico_x, ico_y, 0, 0, win32con.DI_NORMAL)
+        SelectObject(hdcBitmap, hbmOld)
+        DeleteDC(hdcBitmap)
+        item, extras = PackMENUITEMINFO(
+            text="Menu with icon", hbmpItem=hbm.Detach(), wID=1011
+        )
+        InsertMenuItem(menu, 0, 1, item)
+
+        # Create a sub-menu, and put a few funky ones there.
+        self.sub_menu = sub_menu = CreatePopupMenu()
+        # A 'checkbox' menu.
+        item, extras = PackMENUITEMINFO(
+            fState=win32con.MFS_CHECKED, text="Checkbox menu", hbmpItem=hbmp, wID=1003
+        )
+        InsertMenuItem(sub_menu, 0, 1, item)
+        # A 'radio' menu.
+        InsertMenu(sub_menu, 0, win32con.MF_BYPOSITION, win32con.MF_SEPARATOR, None)
+        item, extras = PackMENUITEMINFO(
+            fType=win32con.MFT_RADIOCHECK,
+            fState=win32con.MFS_CHECKED,
+            text="Checkbox menu - bullet 1",
+            hbmpItem=hbmp,
+            wID=1004,
+        )
+        InsertMenuItem(sub_menu, 0, 1, item)
+        item, extras = PackMENUITEMINFO(
+            fType=win32con.MFT_RADIOCHECK,
+            fState=win32con.MFS_UNCHECKED,
+            text="Checkbox menu - bullet 2",
+            hbmpItem=hbmp,
+            wID=1005,
+        )
+        InsertMenuItem(sub_menu, 0, 1, item)
+        # And add the sub-menu to the top-level menu.
+        item, extras = PackMENUITEMINFO(text="Sub-Menu", hSubMenu=sub_menu)
+        InsertMenuItem(menu, 0, 1, item)
+
+        # Set 'Exit' as the default option.
+        SetMenuDefaultItem(menu, 1000, 0)
+
+    def OnDestroy(self, hwnd, msg, wparam, lparam):
+        nid = (self.hwnd, 0)
+        Shell_NotifyIcon(NIM_DELETE, nid)
+        PostQuitMessage(0)  # Terminate the app.
+
+    def OnTaskbarNotify(self, hwnd, msg, wparam, lparam):
+        if lparam == win32con.WM_RBUTTONUP:
+            print("You right clicked me.")
+            # display the menu at the cursor pos.
+            pos = GetCursorPos()
+            SetForegroundWindow(self.hwnd)
+            TrackPopupMenu(
+                self.hmenu, win32con.TPM_LEFTALIGN, pos[0], pos[1], 0, self.hwnd, None
+            )
+            PostMessage(self.hwnd, win32con.WM_NULL, 0, 0)
+        elif lparam == win32con.WM_LBUTTONDBLCLK:
+            print("You double-clicked me")
+            # find the default menu item and fire it.
+            cmd = GetMenuDefaultItem(self.hmenu, False, 0)
+            if cmd == -1:
+                print("Can't find a default!")
+            # and just pretend it came from the menu
+            self.OnCommand(hwnd, win32con.WM_COMMAND, cmd, 0)
+        return 1
+
+    def OnCommand(self, hwnd, msg, wparam, lparam):
+        id = LOWORD(wparam)
+        if id == 1000:
+            print("Goodbye")
+            DestroyWindow(self.hwnd)
+        elif id in (1003, 1004, 1005):
+            # Our 'checkbox' and 'radio' items
+            state = GetMenuState(self.sub_menu, id, win32con.MF_BYCOMMAND)
+            if state == -1:
+                raise RuntimeError("No item found")
+            if state & win32con.MF_CHECKED:
+                check_flags = win32con.MF_UNCHECKED
+                print("Menu was checked - unchecking")
+            else:
+                check_flags = win32con.MF_CHECKED
+                print("Menu was unchecked - checking")
+
+            if id == 1003:
+                # simple checkbox
+                rc = CheckMenuItem(
+                    self.sub_menu, id, win32con.MF_BYCOMMAND | check_flags
+                )
+            else:
+                # radio button - must pass the first and last IDs in the
+                # "group", and the ID in the group that is to be selected.
+                rc = CheckMenuRadioItem(
+                    self.sub_menu, 1004, 1005, id, win32con.MF_BYCOMMAND
+                )
+            # Get and check the new state - first the simple way...
+            new_state = GetMenuState(self.sub_menu, id, win32con.MF_BYCOMMAND)
+            if new_state & win32con.MF_CHECKED != check_flags:
+                raise RuntimeError("The new item didn't get the new checked state!")
+            # Now the long-winded way via GetMenuItemInfo...
+            buf, extras = EmptyMENUITEMINFO()
+            win32gui.GetMenuItemInfo(self.sub_menu, id, False, buf)
+            (
+                fType,
+                fState,
+                wID,
+                hSubMenu,
+                hbmpChecked,
+                hbmpUnchecked,
+                dwItemData,
+                text,
+                hbmpItem,
+            ) = UnpackMENUITEMINFO(buf)
+
+            if fState & win32con.MF_CHECKED != check_flags:
+                raise RuntimeError("The new item didn't get the new checked state!")
+        else:
+            print("OnCommand for ID", id)
+
+    # Owner-draw related functions.  We only have 1 owner-draw item, but
+    # we pretend we have more than that :)
+    def OnMeasureItem(self, hwnd, msg, wparam, lparam):
+        ## Last item of MEASUREITEMSTRUCT is a ULONG_PTR
+        fmt = "5iP"
+        buf = PyMakeBuffer(struct.calcsize(fmt), lparam)
+        data = struct.unpack(fmt, buf)
+        ctlType, ctlID, itemID, itemWidth, itemHeight, itemData = data
+
+        hicon, text = self.menu_item_map[itemData]
+        if text is None:
+            # Only drawing icon due to HBMMENU_CALLBACK
+            cx = self.menu_icon_width
+            cy = self.menu_icon_height
+        else:
+            # drawing the lot!
+            dc = GetDC(hwnd)
+            oldFont = SelectObject(dc, self.font_menu)
+            cx, cy = GetTextExtentPoint32(dc, text)
+            SelectObject(dc, oldFont)
+            ReleaseDC(hwnd, dc)
+
+            cx += GetSystemMetrics(win32con.SM_CXMENUCHECK)
+            cx += self.menu_icon_width + self.icon_x_pad
+
+            cy = GetSystemMetrics(win32con.SM_CYMENU)
+
+        new_data = struct.pack(fmt, ctlType, ctlID, itemID, cx, cy, itemData)
+        PySetMemory(lparam, new_data)
+        return True
+
+    def OnDrawItem(self, hwnd, msg, wparam, lparam):
+        ## lparam is a DRAWITEMSTRUCT
+        fmt = "5i2P4iP"
+        data = struct.unpack(fmt, PyGetMemory(lparam, struct.calcsize(fmt)))
+        (
+            ctlType,
+            ctlID,
+            itemID,
+            itemAction,
+            itemState,
+            hwndItem,
+            hDC,
+            left,
+            top,
+            right,
+            bot,
+            itemData,
+        ) = data
+
+        rect = left, top, right, bot
+        hicon, text = self.menu_item_map[itemData]
+
+        if text is None:
+            # This means the menu-item had HBMMENU_CALLBACK - so all we
+            # draw is the icon.  rect is the entire area we should use.
+            DrawIconEx(
+                hDC, left, top, hicon, right - left, bot - top, 0, 0, win32con.DI_NORMAL
+            )
+        else:
+            # If the user has selected the item, use the selected
+            # text and background colors to display the item.
+            selected = itemState & win32con.ODS_SELECTED
+            if selected:
+                crText = SetTextColor(hDC, GetSysColor(win32con.COLOR_HIGHLIGHTTEXT))
+                crBkgnd = SetBkColor(hDC, GetSysColor(win32con.COLOR_HIGHLIGHT))
+
+            each_pad = self.icon_x_pad // 2
+            x_icon = left + GetSystemMetrics(win32con.SM_CXMENUCHECK) + each_pad
+            x_text = x_icon + self.menu_icon_width + each_pad
+
+            # Draw text first, specifying a complete rect to fill - this sets
+            # up the background (but overwrites anything else already there!)
+            # Select the font, draw it, and restore the previous font.
+            hfontOld = SelectObject(hDC, self.font_menu)
+            ExtTextOut(hDC, x_text, top + 2, win32con.ETO_OPAQUE, rect, text)
+            SelectObject(hDC, hfontOld)
+
+            # Icon image next.  Icons are transparent - no need to handle
+            # selection specially.
+            DrawIconEx(
+                hDC,
+                x_icon,
+                top + 2,
+                hicon,
+                self.menu_icon_width,
+                self.menu_icon_height,
+                0,
+                0,
+                win32con.DI_NORMAL,
+            )
+
+            # Return the text and background colors to their
+            # normal state (not selected).
+            if selected:
+                SetTextColor(hDC, crText)
+                SetBkColor(hDC, crBkgnd)
+
+
+def main():
+    w = MainWindow()
+    PumpMessages()
+
+
+if __name__ == "__main__":
+    main()
diff --git a/lib/win32/Demos/win32gui_taskbar.py b/lib/win32/Demos/win32gui_taskbar.py
new file mode 100644
index 00000000..84d642a9
--- /dev/null
+++ b/lib/win32/Demos/win32gui_taskbar.py
@@ -0,0 +1,141 @@
+# Creates a task-bar icon.  Run from Python.exe to see the
+# messages printed.
+import os
+import sys
+
+import win32api
+import win32con
+import win32gui
+import winerror
+
+
+class MainWindow:
+    def __init__(self):
+        msg_TaskbarRestart = win32gui.RegisterWindowMessage("TaskbarCreated")
+        message_map = {
+            msg_TaskbarRestart: self.OnRestart,
+            win32con.WM_DESTROY: self.OnDestroy,
+            win32con.WM_COMMAND: self.OnCommand,
+            win32con.WM_USER + 20: self.OnTaskbarNotify,
+        }
+        # Register the Window class.
+        wc = win32gui.WNDCLASS()
+        hinst = wc.hInstance = win32api.GetModuleHandle(None)
+        wc.lpszClassName = "PythonTaskbarDemo"
+        wc.style = win32con.CS_VREDRAW | win32con.CS_HREDRAW
+        wc.hCursor = win32api.LoadCursor(0, win32con.IDC_ARROW)
+        wc.hbrBackground = win32con.COLOR_WINDOW
+        wc.lpfnWndProc = message_map  # could also specify a wndproc.
+
+        # Don't blow up if class already registered to make testing easier
+        try:
+            classAtom = win32gui.RegisterClass(wc)
+        except win32gui.error as err_info:
+            if err_info.winerror != winerror.ERROR_CLASS_ALREADY_EXISTS:
+                raise
+
+        # Create the Window.
+        style = win32con.WS_OVERLAPPED | win32con.WS_SYSMENU
+        self.hwnd = win32gui.CreateWindow(
+            wc.lpszClassName,
+            "Taskbar Demo",
+            style,
+            0,
+            0,
+            win32con.CW_USEDEFAULT,
+            win32con.CW_USEDEFAULT,
+            0,
+            0,
+            hinst,
+            None,
+        )
+        win32gui.UpdateWindow(self.hwnd)
+        self._DoCreateIcons()
+
+    def _DoCreateIcons(self):
+        # Try and find a custom icon
+        hinst = win32api.GetModuleHandle(None)
+        iconPathName = os.path.abspath(
+            os.path.join(os.path.split(sys.executable)[0], "pyc.ico")
+        )
+        if not os.path.isfile(iconPathName):
+            # Look in DLLs dir, a-la py 2.5
+            iconPathName = os.path.abspath(
+                os.path.join(os.path.split(sys.executable)[0], "DLLs", "pyc.ico")
+            )
+        if not os.path.isfile(iconPathName):
+            # Look in the source tree.
+            iconPathName = os.path.abspath(
+                os.path.join(os.path.split(sys.executable)[0], "..\\PC\\pyc.ico")
+            )
+        if os.path.isfile(iconPathName):
+            icon_flags = win32con.LR_LOADFROMFILE | win32con.LR_DEFAULTSIZE
+            hicon = win32gui.LoadImage(
+                hinst, iconPathName, win32con.IMAGE_ICON, 0, 0, icon_flags
+            )
+        else:
+            print("Can't find a Python icon file - using default")
+            hicon = win32gui.LoadIcon(0, win32con.IDI_APPLICATION)
+
+        flags = win32gui.NIF_ICON | win32gui.NIF_MESSAGE | win32gui.NIF_TIP
+        nid = (self.hwnd, 0, flags, win32con.WM_USER + 20, hicon, "Python Demo")
+        try:
+            win32gui.Shell_NotifyIcon(win32gui.NIM_ADD, nid)
+        except win32gui.error:
+            # This is common when windows is starting, and this code is hit
+            # before the taskbar has been created.
+            print("Failed to add the taskbar icon - is explorer running?")
+            # but keep running anyway - when explorer starts, we get the
+            # TaskbarCreated message.
+
+    def OnRestart(self, hwnd, msg, wparam, lparam):
+        self._DoCreateIcons()
+
+    def OnDestroy(self, hwnd, msg, wparam, lparam):
+        nid = (self.hwnd, 0)
+        win32gui.Shell_NotifyIcon(win32gui.NIM_DELETE, nid)
+        win32gui.PostQuitMessage(0)  # Terminate the app.
+
+    def OnTaskbarNotify(self, hwnd, msg, wparam, lparam):
+        if lparam == win32con.WM_LBUTTONUP:
+            print("You clicked me.")
+        elif lparam == win32con.WM_LBUTTONDBLCLK:
+            print("You double-clicked me - goodbye")
+            win32gui.DestroyWindow(self.hwnd)
+        elif lparam == win32con.WM_RBUTTONUP:
+            print("You right clicked me.")
+            menu = win32gui.CreatePopupMenu()
+            win32gui.AppendMenu(menu, win32con.MF_STRING, 1023, "Display Dialog")
+            win32gui.AppendMenu(menu, win32con.MF_STRING, 1024, "Say Hello")
+            win32gui.AppendMenu(menu, win32con.MF_STRING, 1025, "Exit program")
+            pos = win32gui.GetCursorPos()
+            # See http://msdn.microsoft.com/library/default.asp?url=/library/en-us/winui/menus_0hdi.asp
+            win32gui.SetForegroundWindow(self.hwnd)
+            win32gui.TrackPopupMenu(
+                menu, win32con.TPM_LEFTALIGN, pos[0], pos[1], 0, self.hwnd, None
+            )
+            win32gui.PostMessage(self.hwnd, win32con.WM_NULL, 0, 0)
+        return 1
+
+    def OnCommand(self, hwnd, msg, wparam, lparam):
+        id = win32api.LOWORD(wparam)
+        if id == 1023:
+            import win32gui_dialog
+
+            win32gui_dialog.DemoModal()
+        elif id == 1024:
+            print("Hello")
+        elif id == 1025:
+            print("Goodbye")
+            win32gui.DestroyWindow(self.hwnd)
+        else:
+            print("Unknown command -", id)
+
+
+def main():
+    w = MainWindow()
+    win32gui.PumpMessages()
+
+
+if __name__ == "__main__":
+    main()
diff --git a/lib/win32/Demos/win32netdemo.py b/lib/win32/Demos/win32netdemo.py
new file mode 100644
index 00000000..36c49542
--- /dev/null
+++ b/lib/win32/Demos/win32netdemo.py
@@ -0,0 +1,274 @@
+import getopt
+import sys
+import traceback
+
+import win32api
+import win32net
+import win32netcon
+import win32security
+
+verbose_level = 0
+
+server = None  # Run on local machine.
+
+
+def verbose(msg):
+    if verbose_level:
+        print(msg)
+
+
+def CreateUser():
+    "Creates a new test user, then deletes the user"
+    testName = "PyNetTestUser"
+    try:
+        win32net.NetUserDel(server, testName)
+        print("Warning - deleted user before creating it!")
+    except win32net.error:
+        pass
+
+    d = {}
+    d["name"] = testName
+    d["password"] = "deleteme"
+    d["priv"] = win32netcon.USER_PRIV_USER
+    d["comment"] = "Delete me - created by Python test code"
+    d["flags"] = win32netcon.UF_NORMAL_ACCOUNT | win32netcon.UF_SCRIPT
+    win32net.NetUserAdd(server, 1, d)
+    try:
+        try:
+            win32net.NetUserChangePassword(server, testName, "wrong", "new")
+            print("ERROR: NetUserChangePassword worked with a wrong password!")
+        except win32net.error:
+            pass
+        win32net.NetUserChangePassword(server, testName, "deleteme", "new")
+    finally:
+        win32net.NetUserDel(server, testName)
+    print("Created a user, changed their password, and deleted them!")
+
+
+def UserEnum():
+    "Enumerates all the local users"
+    resume = 0
+    nuser = 0
+    while 1:
+        data, total, resume = win32net.NetUserEnum(
+            server, 3, win32netcon.FILTER_NORMAL_ACCOUNT, resume
+        )
+        verbose(
+            "Call to NetUserEnum obtained %d entries of %d total" % (len(data), total)
+        )
+        for user in data:
+            verbose("Found user %s" % user["name"])
+            nuser = nuser + 1
+        if not resume:
+            break
+    assert nuser, "Could not find any users!"
+    print("Enumerated all the local users")
+
+
+def GroupEnum():
+    "Enumerates all the domain groups"
+    nmembers = 0
+    resume = 0
+    while 1:
+        data, total, resume = win32net.NetGroupEnum(server, 1, resume)
+        #               print "Call to NetGroupEnum obtained %d entries of %d total" % (len(data), total)
+        for group in data:
+            verbose("Found group %(name)s:%(comment)s " % group)
+            memberresume = 0
+            while 1:
+                memberdata, total, memberresume = win32net.NetGroupGetUsers(
+                    server, group["name"], 0, resume
+                )
+                for member in memberdata:
+                    verbose(" Member %(name)s" % member)
+                    nmembers = nmembers + 1
+                if memberresume == 0:
+                    break
+        if not resume:
+            break
+    assert nmembers, "Couldnt find a single member in a single group!"
+    print("Enumerated all the groups")
+
+
+def LocalGroupEnum():
+    "Enumerates all the local groups"
+    resume = 0
+    nmembers = 0
+    while 1:
+        data, total, resume = win32net.NetLocalGroupEnum(server, 1, resume)
+        for group in data:
+            verbose("Found group %(name)s:%(comment)s " % group)
+            memberresume = 0
+            while 1:
+                memberdata, total, memberresume = win32net.NetLocalGroupGetMembers(
+                    server, group["name"], 2, resume
+                )
+                for member in memberdata:
+                    # Just for the sake of it, we convert the SID to a username
+                    username, domain, type = win32security.LookupAccountSid(
+                        server, member["sid"]
+                    )
+                    nmembers = nmembers + 1
+                    verbose(" Member %s (%s)" % (username, member["domainandname"]))
+                if memberresume == 0:
+                    break
+        if not resume:
+            break
+    assert nmembers, "Couldnt find a single member in a single group!"
+    print("Enumerated all the local groups")
+
+
+def ServerEnum():
+    "Enumerates all servers on the network"
+    resume = 0
+    while 1:
+        data, total, resume = win32net.NetServerEnum(
+            server, 100, win32netcon.SV_TYPE_ALL, None, resume
+        )
+        for s in data:
+            verbose("Found server %s" % s["name"])
+            # Now loop over the shares.
+            shareresume = 0
+            while 1:
+                sharedata, total, shareresume = win32net.NetShareEnum(
+                    server, 2, shareresume
+                )
+                for share in sharedata:
+                    verbose(
+                        " %(netname)s (%(path)s):%(remark)s - in use by %(current_uses)d users"
+                        % share
+                    )
+                if not shareresume:
+                    break
+        if not resume:
+            break
+    print("Enumerated all the servers on the network")
+
+
+def LocalGroup(uname=None):
+    "Creates a local group, adds some members, deletes them, then removes the group"
+    level = 3
+    if uname is None:
+        uname = win32api.GetUserName()
+    if uname.find("\\") < 0:
+        uname = win32api.GetDomainName() + "\\" + uname
+    group = "python_test_group"
+    # delete the group if it already exists
+    try:
+        win32net.NetLocalGroupDel(server, group)
+        print("WARNING: existing local group '%s' has been deleted.")
+    except win32net.error:
+        pass
+    group_data = {"name": group}
+    win32net.NetLocalGroupAdd(server, 1, group_data)
+    try:
+        u = {"domainandname": uname}
+        win32net.NetLocalGroupAddMembers(server, group, level, [u])
+        mem, tot, res = win32net.NetLocalGroupGetMembers(server, group, level)
+        print("members are", mem)
+        if mem[0]["domainandname"] != uname:
+            print("ERROR: LocalGroup just added %s, but members are %r" % (uname, mem))
+        # Convert the list of dicts to a list of strings.
+        win32net.NetLocalGroupDelMembers(
+            server, group, [m["domainandname"] for m in mem]
+        )
+    finally:
+        win32net.NetLocalGroupDel(server, group)
+    print("Created a local group, added and removed members, then deleted the group")
+
+
+def GetInfo(userName=None):
+    "Dumps level 3 information about the current user"
+    if userName is None:
+        userName = win32api.GetUserName()
+    print("Dumping level 3 information about user")
+    info = win32net.NetUserGetInfo(server, userName, 3)
+    for key, val in list(info.items()):
+        verbose("%s=%s" % (key, val))
+
+
+def SetInfo(userName=None):
+    "Attempts to change the current users comment, then set it back"
+    if userName is None:
+        userName = win32api.GetUserName()
+    oldData = win32net.NetUserGetInfo(server, userName, 3)
+    try:
+        d = oldData.copy()
+        d["usr_comment"] = "Test comment"
+        win32net.NetUserSetInfo(server, userName, 3, d)
+        new = win32net.NetUserGetInfo(server, userName, 3)["usr_comment"]
+        if str(new) != "Test comment":
+            raise RuntimeError("Could not read the same comment back - got %s" % new)
+        print("Changed the data for the user")
+    finally:
+        win32net.NetUserSetInfo(server, userName, 3, oldData)
+
+
+def SetComputerInfo():
+    "Doesnt actually change anything, just make sure we could ;-)"
+    info = win32net.NetWkstaGetInfo(None, 502)
+    # *sob* - but we can't!  Why not!!!
+    # win32net.NetWkstaSetInfo(None, 502, info)
+
+
+def usage(tests):
+    import os
+
+    print("Usage: %s [-s server ] [-v] [Test ...]" % os.path.basename(sys.argv[0]))
+    print("  -v : Verbose - print more information")
+    print("  -s : server - execute the tests against the named server")
+    print("  -c : include the CreateUser test by default")
+    print("where Test is one of:")
+    for t in tests:
+        print(t.__name__, ":", t.__doc__)
+    print()
+    print("If not tests are specified, all tests are run")
+    sys.exit(1)
+
+
+def main():
+    tests = []
+    for ob in list(globals().values()):
+        if type(ob) == type(main) and ob.__doc__:
+            tests.append(ob)
+    opts, args = getopt.getopt(sys.argv[1:], "s:hvc")
+    create_user = False
+    for opt, val in opts:
+        if opt == "-s":
+            global server
+            server = val
+        if opt == "-h":
+            usage(tests)
+        if opt == "-v":
+            global verbose_level
+            verbose_level = verbose_level + 1
+        if opt == "-c":
+            create_user = True
+
+    if len(args) == 0:
+        print("Running all tests - use '-h' to see command-line options...")
+        dotests = tests
+        if not create_user:
+            dotests.remove(CreateUser)
+    else:
+        dotests = []
+        for arg in args:
+            for t in tests:
+                if t.__name__ == arg:
+                    dotests.append(t)
+                    break
+            else:
+                print("Test '%s' unknown - skipping" % arg)
+    if not len(dotests):
+        print("Nothing to do!")
+        usage(tests)
+    for test in dotests:
+        try:
+            test()
+        except:
+            print("Test %s failed" % test.__name__)
+            traceback.print_exc()
+
+
+if __name__ == "__main__":
+    main()
diff --git a/lib/win32/Demos/win32rcparser_demo.py b/lib/win32/Demos/win32rcparser_demo.py
new file mode 100644
index 00000000..6a41d453
--- /dev/null
+++ b/lib/win32/Demos/win32rcparser_demo.py
@@ -0,0 +1,86 @@
+# A demo of the win32rcparser module and using win32gui
+
+import os
+
+import commctrl
+import win32api
+import win32con
+import win32gui
+import win32rcparser
+
+this_dir = os.path.abspath(os.path.dirname(__file__))
+g_rcname = os.path.abspath(
+    os.path.join(this_dir, "..", "test", "win32rcparser", "test.rc")
+)
+
+if not os.path.isfile(g_rcname):
+    raise RuntimeError("Can't locate test.rc (should be at '%s')" % (g_rcname,))
+
+
+class DemoWindow:
+    def __init__(self, dlg_template):
+        self.dlg_template = dlg_template
+
+    def CreateWindow(self):
+        self._DoCreate(win32gui.CreateDialogIndirect)
+
+    def DoModal(self):
+        return self._DoCreate(win32gui.DialogBoxIndirect)
+
+    def _DoCreate(self, fn):
+        message_map = {
+            win32con.WM_INITDIALOG: self.OnInitDialog,
+            win32con.WM_CLOSE: self.OnClose,
+            win32con.WM_DESTROY: self.OnDestroy,
+            win32con.WM_COMMAND: self.OnCommand,
+        }
+        return fn(0, self.dlg_template, 0, message_map)
+
+    def OnInitDialog(self, hwnd, msg, wparam, lparam):
+        self.hwnd = hwnd
+        # centre the dialog
+        desktop = win32gui.GetDesktopWindow()
+        l, t, r, b = win32gui.GetWindowRect(self.hwnd)
+        dt_l, dt_t, dt_r, dt_b = win32gui.GetWindowRect(desktop)
+        centre_x, centre_y = win32gui.ClientToScreen(
+            desktop, ((dt_r - dt_l) // 2, (dt_b - dt_t) // 2)
+        )
+        win32gui.MoveWindow(
+            hwnd, centre_x - (r // 2), centre_y - (b // 2), r - l, b - t, 0
+        )
+
+    def OnCommand(self, hwnd, msg, wparam, lparam):
+        # Needed to make OK/Cancel work - no other controls are handled.
+        id = win32api.LOWORD(wparam)
+        if id in [win32con.IDOK, win32con.IDCANCEL]:
+            win32gui.EndDialog(hwnd, id)
+
+    def OnClose(self, hwnd, msg, wparam, lparam):
+        win32gui.EndDialog(hwnd, 0)
+
+    def OnDestroy(self, hwnd, msg, wparam, lparam):
+        pass
+
+
+def DemoModal():
+    # Load the .rc file.
+    resources = win32rcparser.Parse(g_rcname)
+    for id, ddef in resources.dialogs.items():
+        print("Displaying dialog", id)
+        w = DemoWindow(ddef)
+        w.DoModal()
+
+
+if __name__ == "__main__":
+    flags = 0
+    for flag in """ICC_DATE_CLASSES ICC_ANIMATE_CLASS ICC_ANIMATE_CLASS 
+                   ICC_BAR_CLASSES ICC_COOL_CLASSES ICC_DATE_CLASSES
+                   ICC_HOTKEY_CLASS ICC_INTERNET_CLASSES ICC_LISTVIEW_CLASSES
+                   ICC_PAGESCROLLER_CLASS ICC_PROGRESS_CLASS ICC_TAB_CLASSES
+                   ICC_TREEVIEW_CLASSES ICC_UPDOWN_CLASS ICC_USEREX_CLASSES
+                   ICC_WIN95_CLASSES  """.split():
+        flags |= getattr(commctrl, flag)
+    win32gui.InitCommonControlsEx(flags)
+    # Need to do this go get rich-edit working.
+    win32api.LoadLibrary("riched20.dll")
+    DemoModal()
diff --git a/lib/win32/Demos/win32servicedemo.py b/lib/win32/Demos/win32servicedemo.py
new file mode 100644
index 00000000..75967ef3
--- /dev/null
+++ b/lib/win32/Demos/win32servicedemo.py
@@ -0,0 +1,23 @@
+import win32con
+import win32service
+
+
+def EnumServices():
+    resume = 0
+    accessSCM = win32con.GENERIC_READ
+    accessSrv = win32service.SC_MANAGER_ALL_ACCESS
+
+    # Open Service Control Manager
+    hscm = win32service.OpenSCManager(None, None, accessSCM)
+
+    # Enumerate Service Control Manager DB
+
+    typeFilter = win32service.SERVICE_WIN32
+    stateFilter = win32service.SERVICE_STATE_ALL
+
+    statuses = win32service.EnumServicesStatus(hscm, typeFilter, stateFilter)
+    for short_name, desc, status in statuses:
+        print(short_name, desc, status)
+
+
+EnumServices()
diff --git a/lib/win32/Demos/win32ts_logoff_disconnected.py b/lib/win32/Demos/win32ts_logoff_disconnected.py
new file mode 100644
index 00000000..be61e5d1
--- /dev/null
+++ b/lib/win32/Demos/win32ts_logoff_disconnected.py
@@ -0,0 +1,24 @@
+""" Finds any disconnected terminal service sessions and logs them off"""
+import pywintypes
+import win32ts
+import winerror
+
+sessions = win32ts.WTSEnumerateSessions(win32ts.WTS_CURRENT_SERVER_HANDLE)
+for session in sessions:
+    """
+    WTS_CONNECTSTATE_CLASS: WTSActive,WTSConnected,WTSConnectQuery,WTSShadow,WTSDisconnected,
+          WTSIdle,WTSListen,WTSReset,WTSDown,WTSInit
+    """
+    if session["State"] == win32ts.WTSDisconnected:
+        sessionid = session["SessionId"]
+        username = win32ts.WTSQuerySessionInformation(
+            win32ts.WTS_CURRENT_SERVER_HANDLE, sessionid, win32ts.WTSUserName
+        )
+        print("Logging off disconnected user:", username)
+        try:
+            win32ts.WTSLogoffSession(win32ts.WTS_CURRENT_SERVER_HANDLE, sessionid, True)
+        except pywintypes.error as e:
+            if e.winerror == winerror.ERROR_ACCESS_DENIED:
+                print("Can't kill that session:", e.strerror)
+            else:
+                raise
diff --git a/lib/win32/Demos/win32wnet/testwnet.py b/lib/win32/Demos/win32wnet/testwnet.py
new file mode 100644
index 00000000..3b21ac29
--- /dev/null
+++ b/lib/win32/Demos/win32wnet/testwnet.py
@@ -0,0 +1,125 @@
+import os
+
+import win32api
+import win32wnet
+from winnetwk import *
+
+possible_shares = []
+
+
+def _doDumpHandle(handle, level=0):
+    indent = " " * level
+    while 1:
+        items = win32wnet.WNetEnumResource(handle, 0)
+        if len(items) == 0:
+            break
+        for item in items:
+            try:
+                if item.dwDisplayType == RESOURCEDISPLAYTYPE_SHARE:
+                    print(indent + "Have share with name:", item.lpRemoteName)
+                    possible_shares.append(item)
+                elif item.dwDisplayType == RESOURCEDISPLAYTYPE_GENERIC:
+                    print(
+                        indent + "Have generic resource with name:", item.lpRemoteName
+                    )
+                else:
+                    # Try generic!
+                    print(indent + "Enumerating " + item.lpRemoteName, end=" ")
+                    k = win32wnet.WNetOpenEnum(
+                        RESOURCE_GLOBALNET, RESOURCETYPE_ANY, 0, item
+                    )
+                    print()
+                    _doDumpHandle(k, level + 1)
+                    win32wnet.WNetCloseEnum(
+                        k
+                    )  # could do k.Close(), but this is a good test!
+            except win32wnet.error as details:
+                print(indent + "Couldn't enumerate this resource: " + details.strerror)
+
+
+def TestOpenEnum():
+    print("Enumerating all resources on the network - this may take some time...")
+    handle = win32wnet.WNetOpenEnum(RESOURCE_GLOBALNET, RESOURCETYPE_ANY, 0, None)
+
+    try:
+        _doDumpHandle(handle)
+    finally:
+        handle.Close()
+    print("Finished dumping all resources.")
+
+
+def findUnusedDriveLetter():
+    existing = [
+        x[0].lower() for x in win32api.GetLogicalDriveStrings().split("\0") if x
+    ]
+    handle = win32wnet.WNetOpenEnum(RESOURCE_REMEMBERED, RESOURCETYPE_DISK, 0, None)
+    try:
+        while 1:
+            items = win32wnet.WNetEnumResource(handle, 0)
+            if len(items) == 0:
+                break
+            xtra = [i.lpLocalName[0].lower() for i in items if i.lpLocalName]
+            existing.extend(xtra)
+    finally:
+        handle.Close()
+    for maybe in "defghijklmnopqrstuvwxyz":
+        if maybe not in existing:
+            return maybe
+    raise RuntimeError("All drive mappings are taken?")
+
+
+def TestConnection():
+    if len(possible_shares) == 0:
+        print("Couldn't find any potential shares to connect to")
+        return
+    localName = findUnusedDriveLetter() + ":"
+    for share in possible_shares:
+        print("Attempting connection of", localName, "to", share.lpRemoteName)
+        try:
+            win32wnet.WNetAddConnection2(share.dwType, localName, share.lpRemoteName)
+        except win32wnet.error as details:
+            print("Couldn't connect: " + details.strerror)
+            continue
+        # Have a connection.
+        try:
+            fname = os.path.join(localName + "\\", os.listdir(localName + "\\")[0])
+            try:
+                print(
+                    "Universal name of '%s' is '%s'"
+                    % (fname, win32wnet.WNetGetUniversalName(fname))
+                )
+            except win32wnet.error as details:
+                print(
+                    "Couldn't get universal name of '%s': %s"
+                    % (fname, details.strerror)
+                )
+            print("User name for this connection is", win32wnet.WNetGetUser(localName))
+        finally:
+            win32wnet.WNetCancelConnection2(localName, 0, 0)
+        # and do it again, but this time by using the more modern
+        # NETRESOURCE way.
+        nr = win32wnet.NETRESOURCE()
+        nr.dwType = share.dwType
+        nr.lpLocalName = localName
+        nr.lpRemoteName = share.lpRemoteName
+        win32wnet.WNetAddConnection2(nr)
+        win32wnet.WNetCancelConnection2(localName, 0, 0)
+
+        # and one more time using WNetAddConnection3
+        win32wnet.WNetAddConnection3(0, nr)
+        win32wnet.WNetCancelConnection2(localName, 0, 0)
+
+        # Only do the first share that succeeds.
+        break
+
+
+def TestGetUser():
+    u = win32wnet.WNetGetUser()
+    print("Current global user is", repr(u))
+    if u != win32wnet.WNetGetUser(None):
+        raise RuntimeError("Default value didnt seem to work!")
+
+
+TestGetUser()
+TestOpenEnum()
+TestConnection()
diff --git a/lib/win32/Demos/win32wnet/winnetwk.py b/lib/win32/Demos/win32wnet/winnetwk.py
new file mode 100644
index 00000000..036e2ebf
--- /dev/null
+++ b/lib/win32/Demos/win32wnet/winnetwk.py
@@ -0,0 +1,100 @@
+# Generated by h2py from d:\mssdk\include\winnetwk.h
+WNNC_NET_MSNET = 0x00010000
+WNNC_NET_LANMAN = 0x00020000
+WNNC_NET_NETWARE = 0x00030000
+WNNC_NET_VINES = 0x00040000
+WNNC_NET_10NET = 0x00050000
+WNNC_NET_LOCUS = 0x00060000
+WNNC_NET_SUN_PC_NFS = 0x00070000
+WNNC_NET_LANSTEP = 0x00080000
+WNNC_NET_9TILES = 0x00090000
+WNNC_NET_LANTASTIC = 0x000A0000
+WNNC_NET_AS400 = 0x000B0000
+WNNC_NET_FTP_NFS = 0x000C0000
+WNNC_NET_PATHWORKS = 0x000D0000
+WNNC_NET_LIFENET = 0x000E0000
+WNNC_NET_POWERLAN = 0x000F0000
+WNNC_NET_BWNFS = 0x00100000
+WNNC_NET_COGENT = 0x00110000
+WNNC_NET_FARALLON = 0x00120000
+WNNC_NET_APPLETALK = 0x00130000
+WNNC_NET_INTERGRAPH = 0x00140000
+WNNC_NET_SYMFONET = 0x00150000
+WNNC_NET_CLEARCASE = 0x00160000
+WNNC_NET_FRONTIER = 0x00170000
+WNNC_NET_BMC = 0x00180000
+WNNC_NET_DCE = 0x00190000
+WNNC_NET_DECORB = 0x00200000
+WNNC_NET_PROTSTOR = 0x00210000
+WNNC_NET_FJ_REDIR = 0x00220000
+WNNC_NET_DISTINCT = 0x00230000
+WNNC_NET_TWINS = 0x00240000
+WNNC_NET_RDR2SAMPLE = 0x00250000
+RESOURCE_CONNECTED = 0x00000001
+RESOURCE_GLOBALNET = 0x00000002
+RESOURCE_REMEMBERED = 0x00000003
+RESOURCE_RECENT = 0x00000004
+RESOURCE_CONTEXT = 0x00000005
+RESOURCETYPE_ANY = 0x00000000
+RESOURCETYPE_DISK = 0x00000001
+RESOURCETYPE_PRINT = 0x00000002
+RESOURCETYPE_RESERVED = 0x00000008
+RESOURCETYPE_UNKNOWN = 0xFFFFFFFF
+RESOURCEUSAGE_CONNECTABLE = 0x00000001
+RESOURCEUSAGE_CONTAINER = 0x00000002
+RESOURCEUSAGE_NOLOCALDEVICE = 0x00000004
+RESOURCEUSAGE_SIBLING = 0x00000008
+RESOURCEUSAGE_ATTACHED = 0x00000010
+RESOURCEUSAGE_ALL = (
+    RESOURCEUSAGE_CONNECTABLE | RESOURCEUSAGE_CONTAINER | RESOURCEUSAGE_ATTACHED
+)
+RESOURCEUSAGE_RESERVED = 0x80000000
+RESOURCEDISPLAYTYPE_GENERIC = 0x00000000
+RESOURCEDISPLAYTYPE_DOMAIN = 0x00000001
+RESOURCEDISPLAYTYPE_SERVER = 0x00000002
+RESOURCEDISPLAYTYPE_SHARE = 0x00000003
+RESOURCEDISPLAYTYPE_FILE = 0x00000004
+RESOURCEDISPLAYTYPE_GROUP = 0x00000005
+RESOURCEDISPLAYTYPE_NETWORK = 0x00000006
+RESOURCEDISPLAYTYPE_ROOT = 0x00000007
+RESOURCEDISPLAYTYPE_SHAREADMIN = 0x00000008
+RESOURCEDISPLAYTYPE_DIRECTORY = 0x00000009
+RESOURCEDISPLAYTYPE_TREE = 0x0000000A
+RESOURCEDISPLAYTYPE_NDSCONTAINER = 0x0000000B
+NETPROPERTY_PERSISTENT = 1
+CONNECT_UPDATE_PROFILE = 0x00000001
+CONNECT_UPDATE_RECENT = 0x00000002
+CONNECT_TEMPORARY = 0x00000004
+CONNECT_INTERACTIVE = 0x00000008
+CONNECT_PROMPT = 0x00000010
+CONNECT_NEED_DRIVE = 0x00000020
+CONNECT_REFCOUNT = 0x00000040
+CONNECT_REDIRECT = 0x00000080
+CONNECT_LOCALDRIVE = 0x00000100
+CONNECT_CURRENT_MEDIA = 0x00000200
+CONNECT_DEFERRED = 0x00000400
+CONNECT_RESERVED = 0xFF000000
+CONNDLG_RO_PATH = 0x00000001
+CONNDLG_CONN_POINT = 0x00000002
+CONNDLG_USE_MRU = 0x00000004
+CONNDLG_HIDE_BOX = 0x00000008
+CONNDLG_PERSIST = 0x00000010
+CONNDLG_NOT_PERSIST = 0x00000020
+DISC_UPDATE_PROFILE = 0x00000001
+DISC_NO_FORCE = 0x00000040
+UNIVERSAL_NAME_INFO_LEVEL = 0x00000001
+REMOTE_NAME_INFO_LEVEL = 0x00000002
+WNFMT_MULTILINE = 0x01
+WNFMT_ABBREVIATED = 0x02
+WNFMT_INENUM = 0x10
+WNFMT_CONNECTION = 0x20
+NETINFO_DLL16 = 0x00000001
+NETINFO_DISKRED = 0x00000004
+NETINFO_PRINTERRED = 0x00000008
+RP_LOGON = 0x01
+RP_INIFILE = 0x02
+PP_DISPLAYERRORS = 0x01
+WNCON_FORNETCARD = 0x00000001
+WNCON_NOTROUTED = 0x00000002
+WNCON_SLOWLINK = 0x00000004
+WNCON_DYNAMIC = 0x00000008
diff --git a/lib/win32/Demos/winprocess.py b/lib/win32/Demos/winprocess.py
new file mode 100644
index 00000000..48f6fe71
--- /dev/null
+++ b/lib/win32/Demos/winprocess.py
@@ -0,0 +1,230 @@
+"""
+Windows Process Control
+
+winprocess.run launches a child process and returns the exit code.
+Optionally, it can:
+  redirect stdin, stdout & stderr to files
+  run the command as another user
+  limit the process's running time
+  control the process window (location, size, window state, desktop)
+Works on Windows NT, 2000 & XP. Requires Mark Hammond's win32
+extensions.
+
+This code is free for any purpose, with no warranty of any kind.
+-- John B. Dell'Aquila <jbd@alum.mit.edu>
+"""
+
+import msvcrt
+import os
+
+import win32api
+import win32con
+import win32event
+import win32gui
+import win32process
+import win32security
+
+
+def logonUser(loginString):
+    """
+    Login as specified user and return handle.
+    loginString:  'Domain\nUser\nPassword'; for local
+        login use . or empty string as domain
+        e.g. '.\nadministrator\nsecret_password'
+    """
+    domain, user, passwd = loginString.split("\n")
+    return win32security.LogonUser(
+        user,
+        domain,
+        passwd,
+        win32con.LOGON32_LOGON_INTERACTIVE,
+        win32con.LOGON32_PROVIDER_DEFAULT,
+    )
+
+
+class Process:
+    """
+    A Windows process.
+    """
+
+    def __init__(
+        self,
+        cmd,
+        login=None,
+        hStdin=None,
+        hStdout=None,
+        hStderr=None,
+        show=1,
+        xy=None,
+        xySize=None,
+        desktop=None,
+    ):
+        """
+        Create a Windows process.
+        cmd:     command to run
+        login:   run as user 'Domain\nUser\nPassword'
+        hStdin, hStdout, hStderr:
+                 handles for process I/O; default is caller's stdin,
+                 stdout & stderr
+        show:    wShowWindow (0=SW_HIDE, 1=SW_NORMAL, ...)
+        xy:      window offset (x, y) of upper left corner in pixels
+        xySize:  window size (width, height) in pixels
+        desktop: lpDesktop - name of desktop e.g. 'winsta0\\default'
+                 None = inherit current desktop
+                 '' = create new desktop if necessary
+
+        User calling login requires additional privileges:
+          Act as part of the operating system [not needed on Windows XP]
+          Increase quotas
+          Replace a process level token
+        Login string must EITHER be an administrator's account
+        (ordinary user can't access current desktop - see Microsoft
+        Q165194) OR use desktop='' to run another desktop invisibly
+        (may be very slow to startup & finalize).
+        """
+        si = win32process.STARTUPINFO()
+        si.dwFlags = win32con.STARTF_USESTDHANDLES ^ win32con.STARTF_USESHOWWINDOW
+        if hStdin is None:
+            si.hStdInput = win32api.GetStdHandle(win32api.STD_INPUT_HANDLE)
+        else:
+            si.hStdInput = hStdin
+        if hStdout is None:
+            si.hStdOutput = win32api.GetStdHandle(win32api.STD_OUTPUT_HANDLE)
+        else:
+            si.hStdOutput = hStdout
+        if hStderr is None:
+            si.hStdError = win32api.GetStdHandle(win32api.STD_ERROR_HANDLE)
+        else:
+            si.hStdError = hStderr
+        si.wShowWindow = show
+        if xy is not None:
+            si.dwX, si.dwY = xy
+            si.dwFlags ^= win32con.STARTF_USEPOSITION
+        if xySize is not None:
+            si.dwXSize, si.dwYSize = xySize
+            si.dwFlags ^= win32con.STARTF_USESIZE
+        if desktop is not None:
+            si.lpDesktop = desktop
+        procArgs = (
+            None,  # appName
+            cmd,  # commandLine
+            None,  # processAttributes
+            None,  # threadAttributes
+            1,  # bInheritHandles
+            win32process.CREATE_NEW_CONSOLE,  # dwCreationFlags
+            None,  # newEnvironment
+            None,  # currentDirectory
+            si,
+        )  # startupinfo
+        if login is not None:
+            hUser = logonUser(login)
+            win32security.ImpersonateLoggedOnUser(hUser)
+            procHandles = win32process.CreateProcessAsUser(hUser, *procArgs)
+            win32security.RevertToSelf()
+        else:
+            procHandles = win32process.CreateProcess(*procArgs)
+        self.hProcess, self.hThread, self.PId, self.TId = procHandles
+
+    def wait(self, mSec=None):
+        """
+        Wait for process to finish or for specified number of
+        milliseconds to elapse.
+        """
+        if mSec is None:
+            mSec = win32event.INFINITE
+        return win32event.WaitForSingleObject(self.hProcess, mSec)
+
+    def kill(self, gracePeriod=5000):
+        """
+        Kill process. Try for an orderly shutdown via WM_CLOSE.  If
+        still running after gracePeriod (5 sec. default), terminate.
+        """
+        win32gui.EnumWindows(self.__close__, 0)
+        if self.wait(gracePeriod) != win32event.WAIT_OBJECT_0:
+            win32process.TerminateProcess(self.hProcess, 0)
+            win32api.Sleep(100)  # wait for resources to be released
+
+    def __close__(self, hwnd, dummy):
+        """
+        EnumWindows callback - sends WM_CLOSE to any window
+        owned by this process.
+        """
+        TId, PId = win32process.GetWindowThreadProcessId(hwnd)
+        if PId == self.PId:
+            win32gui.PostMessage(hwnd, win32con.WM_CLOSE, 0, 0)
+
+    def exitCode(self):
+        """
+        Return process exit code.
+        """
+        return win32process.GetExitCodeProcess(self.hProcess)
+
+
+def run(cmd, mSec=None, stdin=None, stdout=None, stderr=None, **kw):
+    """
+    Run cmd as a child process and return exit code.
+    mSec:  terminate cmd after specified number of milliseconds
+    stdin, stdout, stderr:
+           file objects for child I/O (use hStdin etc. to attach
+           handles instead of files); default is caller's stdin,
+           stdout & stderr;
+    kw:    see Process.__init__ for more keyword options
+    """
+    if stdin is not None:
+        kw["hStdin"] = msvcrt.get_osfhandle(stdin.fileno())
+    if stdout is not None:
+        kw["hStdout"] = msvcrt.get_osfhandle(stdout.fileno())
+    if stderr is not None:
+        kw["hStderr"] = msvcrt.get_osfhandle(stderr.fileno())
+    child = Process(cmd, **kw)
+    if child.wait(mSec) != win32event.WAIT_OBJECT_0:
+        child.kill()
+        raise WindowsError("process timeout exceeded")
+    return child.exitCode()
+
+
+if __name__ == "__main__":
+    # Pipe commands to a shell and display the output in notepad
+    print("Testing winprocess.py...")
+
+    import tempfile
+
+    timeoutSeconds = 15
+    cmdString = (
+        """\
+REM      Test of winprocess.py piping commands to a shell.\r
+REM      This 'notepad' process will terminate in %d seconds.\r
+vol\r
+net user\r
+_this_is_a_test_of_stderr_\r
+"""
+        % timeoutSeconds
+    )
+
+    cmd_name = tempfile.mktemp()
+    out_name = cmd_name + ".txt"
+    try:
+        cmd = open(cmd_name, "w+b")
+        out = open(out_name, "w+b")
+        cmd.write(cmdString.encode("mbcs"))
+        cmd.seek(0)
+        print(
+            "CMD.EXE exit code:",
+            run("cmd.exe", show=0, stdin=cmd, stdout=out, stderr=out),
+        )
+        cmd.close()
+        print(
+            "NOTEPAD exit code:",
+            run(
+                "notepad.exe %s" % out.name,
+                show=win32con.SW_MAXIMIZE,
+                mSec=timeoutSeconds * 1000,
+            ),
+        )
+        out.close()
+    finally:
+        for n in (cmd_name, out_name):
+            try:
+                os.unlink(cmd_name)
+            except os.error:
+                pass
diff --git a/lib/win32/include/PyWinTypes.h b/lib/win32/include/PyWinTypes.h
new file mode 100644
index 00000000..edfdb0b6
--- /dev/null
+++ b/lib/win32/include/PyWinTypes.h
@@ -0,0 +1,727 @@
+
+#ifndef __PYWINTYPES_H__
+#define __PYWINTYPES_H__
+
+// If building under a GCC, tweak what we need.
+#if defined(__GNUC__) && defined(_POSIX_C_SOURCE)
+// python.h complains if _POSIX_C_SOURCE is already defined
+#undef _POSIX_C_SOURCE
+#endif
+
+// windows rpc.h defines "small" as "char" which breaks Python's accu.h,
+// so we undefine it before including python.
+#ifdef small
+#undef small
+#endif
+
+#include "Python.h"
+#include "structmember.h"
+#include "windows.h"
+
+// Helpers for our modules.
+// Some macros to help the pywin32 modules co-exist in py2x and py3k.
+// Creates and initializes local variables called 'module' and 'dict'.
+
+// Maybe these should all be removed - they existed to help in the py2->3
+// transition.
+// On one hand: the code would be cleaner if they were all just re-inlined?
+// On the other: high confidence everything uses the exact same patterns?
+// (Regardless, *some*, eg, PYWIN_MODULE_INIT_RETURN_* should be re-inlined!)
+
+// Use to define the function itself (ie, its name, linkage, params)
+#define PYWIN_MODULE_INIT_FUNC(module_name) extern "C" __declspec(dllexport) PyObject *PyInit_##module_name(void)
+
+// If the module needs to early-exit on an error condition.
+#define PYWIN_MODULE_INIT_RETURN_ERROR return NULL;
+
+// When the module has successfully initialized.
+#define PYWIN_MODULE_INIT_RETURN_SUCCESS return module;
+
+// To setup the module object itself and the module's dictionary.
+#define PYWIN_MODULE_INIT_PREPARE(module_name, functions, docstring)                                        \
+    PyObject *dict, *module;                                                                                \
+    static PyModuleDef module_name##_def = {PyModuleDef_HEAD_INIT, #module_name, docstring, -1, functions}; \
+    if (PyWinGlobals_Ensure() == -1)                                                                        \
+        return NULL;                                                                                        \
+    if (!(module = PyModule_Create(&module_name##_def)))                                                    \
+        return NULL;                                                                                        \
+    if (!(dict = PyModule_GetDict(module)))                                                                 \
+        return NULL;
+
+// Helpers for our types.
+// Macro to handle PyObject layout changes in Py3k
+#define PYWIN_OBJECT_HEAD PyVarObject_HEAD_INIT(NULL, 0)
+
+/* Attribute names are passed as Unicode in Py3k, so use a macro to
+    switch between string and unicode conversion.  This function is not
+    documented, but is used extensively in the Python codebase itself,
+    so it's reasonable to assume it won't disappear anytime soon.
+*/
+#define PYWIN_ATTR_CONVERT (char *)_PyUnicode_AsString
+
+typedef Py_ssize_t Py_hash_t;
+
+// This only enables runtime checks in debug builds - so we use
+// our own so we can enable it always should we desire...
+#define PyWin_SAFE_DOWNCAST Py_SAFE_DOWNCAST
+
+// Lars: for WAVEFORMATEX
+#include "mmsystem.h"
+
+#ifdef BUILD_PYWINTYPES
+/* We are building pywintypesxx.dll */
+#define PYWINTYPES_EXPORT __declspec(dllexport)
+#else
+/* This module uses pywintypesxx.dll */
+#define PYWINTYPES_EXPORT __declspec(dllimport)
+#if defined(_MSC_VER)
+#if defined(DEBUG) || defined(_DEBUG)
+#pragma comment(lib, "pywintypes_d.lib")
+#else
+#pragma comment(lib, "pywintypes.lib")
+#endif  // DEBUG/_DEBUG
+#endif  // _MSC_VER
+#endif  // BUILD_PYWINTYPES
+
+// Py3k uses memoryview object in place of buffer, and we don't yet.
+extern PYWINTYPES_EXPORT PyObject *PyBuffer_New(Py_ssize_t size);
+extern PYWINTYPES_EXPORT PyObject *PyBuffer_FromMemory(void *buf, Py_ssize_t size);
+
+// Formats a python traceback into a character string - result must be free()ed
+PYWINTYPES_EXPORT WCHAR *GetPythonTraceback(PyObject *exc_type, PyObject *exc_value, PyObject *exc_tb);
+
+#include <tchar.h>
+/*
+** Error/Exception handling
+*/
+extern PYWINTYPES_EXPORT PyObject *PyWinExc_ApiError;
+// Register a Windows DLL that contains the messages in the specified range.
+extern PYWINTYPES_EXPORT BOOL PyWin_RegisterErrorMessageModule(DWORD first, DWORD last, HINSTANCE hmod);
+// Get the previously registered hmodule for an error code.
+extern PYWINTYPES_EXPORT HINSTANCE PyWin_GetErrorMessageModule(DWORD err);
+
+/* A global function that sets an API style error (ie, (code, fn, errTest)) */
+PYWINTYPES_EXPORT PyObject *PyWin_SetAPIError(char *fnName, long err = 0);
+
+/* Basic COM Exception handling.  The main COM exception object
+   is actually defined here.  However, the most useful functions
+   for raising the exception are still in the COM package.  Therefore,
+   you can use the fn below to raise a basic COM exception - no fancy error
+   messages available, just the HRESULT.  It will, however, _be_ a COM
+   exception, and therefore trappable like any other COM exception
+*/
+extern PYWINTYPES_EXPORT PyObject *PyWinExc_COMError;
+PYWINTYPES_EXPORT PyObject *PyWin_SetBasicCOMError(HRESULT hr);
+
+// *************
+// strings, which are a bit of a mess!
+//
+// This has gone from 2.x ascii-only, to 2.x+3.x ascii-or-unicode, to 3.x unicode-only,
+// - this baggage means some strange APIs which convert to and from "char *" in various ways.
+//
+// A sizes/lengths are reported as a `DWORD` rather than a `Py_ssize_t`, that's what the callers
+// need. `Py_ssize_t` used as the "in" type.
+// (We also use this for UINT and ULONG, all of which are 32bit unsigned ints.)
+
+// Sometimes we need to downcast from a ssize_t to a DWORD
+inline bool PyWin_is_ssize_dword(Py_ssize_t val) {
+    return val <= MAXDWORD;
+}
+
+#define PYWIN_CHECK_SSIZE_DWORD(val, failResult) \
+    if (!PyWin_is_ssize_dword(val)) { \
+        PyErr_SetString(PyExc_ValueError, "value is larger than a DWORD"); \
+        return failResult; \
+    }
+
+// Almost all of these are roughly identical! But start with BSTR
+// Given a PyObject (string, Unicode, etc) create a "BSTR" with the value
+PYWINTYPES_EXPORT BOOL PyWinObject_AsBstr(PyObject *stringObject, BSTR *pResult, BOOL bNoneOK = FALSE,
+                                          DWORD *pResultLen = NULL);
+// And free it when finished.
+PYWINTYPES_EXPORT void PyWinObject_FreeBstr(BSTR pResult);
+
+PYWINTYPES_EXPORT PyObject *PyWinObject_FromBstr(const BSTR bstr, BOOL takeOwnership = FALSE);
+
+// Given a string or Unicode object, get WCHAR characters.
+PYWINTYPES_EXPORT BOOL PyWinObject_AsWCHAR(PyObject *stringObject, WCHAR **pResult, BOOL bNoneOK = FALSE,
+                                           DWORD *pResultLen = NULL);
+// And free it when finished.
+PYWINTYPES_EXPORT void PyWinObject_FreeWCHAR(WCHAR *pResult);
+
+inline BOOL PyWinObject_AsWCHAR(PyObject *stringObject, unsigned short **pResult, BOOL bNoneOK = FALSE,
+                                DWORD *pResultLen = NULL)
+{
+    return PyWinObject_AsWCHAR(stringObject, (WCHAR **)pResult, bNoneOK, pResultLen);
+}
+inline void PyWinObject_FreeWCHAR(unsigned short *pResult) { PyWinObject_FreeWCHAR((WCHAR *)pResult); }
+
+// A bit unfortunate, but used when we logically want a "string" but only have
+// a "char *" to put it in.
+// * accepts bytes but boesn't try to accept buffer-like objects.
+// * accepts unicode objects and converts via the code-page.
+PYWINTYPES_EXPORT BOOL PyWinObject_AsChars(PyObject *stringObject, char **pResult, BOOL bNoneOK = FALSE,
+                                           DWORD *pResultLen = NULL);
+// And free it when finished.
+PYWINTYPES_EXPORT void PyWinObject_FreeChars(char *pResult);
+
+// Automatically freed WCHAR that can be used anywhere WCHAR * is required
+class TmpWCHAR {
+   public:
+    WCHAR *tmp;  // (NULL after conversion error)
+    Py_ssize_t length;  // only set after successful auto-conversion; w/o trailing \0
+    PyObject *u;        // auxiliary slot for u2w()
+
+    TmpWCHAR() { tmp = NULL; }
+    TmpWCHAR(WCHAR *t) { tmp = t; }
+    TmpWCHAR(PyObject *ob) : tmp(NULL) { *this = ob; }
+    WCHAR *u2w() { return *this = u; }
+    WCHAR *operator=(PyObject *ob) {
+        if (tmp)
+            PyMem_Free(tmp);
+        if (ob == NULL)
+            tmp = NULL;  // (exception already has been set in this case)
+        else
+            tmp = PyUnicode_AsWideCharString(ob, &length);
+        return tmp;
+    }
+    WCHAR *operator=(WCHAR *t)
+    {
+        if (tmp)
+            PyMem_Free(tmp);
+        tmp = t;
+        return t;
+    }
+    WCHAR **operator&() { return &tmp; }
+    boolean operator==(WCHAR *t) { return tmp == t; }
+    operator WCHAR *() { return tmp; }
+    ~TmpWCHAR() { if (tmp) PyMem_Free(tmp); }
+   private:
+    // Block unwanted copy construction
+    TmpWCHAR(const TmpWCHAR& o);  // = delete;
+    const TmpWCHAR& operator=(const TmpWCHAR& o);  // = delete;
+};
+
+// More string helpers - how many do we need?
+// A couple which should die or be modernized and have some `char *` vs `wchar_t *` confusion.
+PYWINTYPES_EXPORT PyObject *PyWinCoreString_FromString(const char *str, Py_ssize_t len = (Py_ssize_t)-1);
+PYWINTYPES_EXPORT PyObject *PyWinCoreString_FromString(const WCHAR *str, Py_ssize_t len = (Py_ssize_t)-1);
+
+#define PyWinObject_FromWCHAR PyWinObject_FromOLECHAR
+
+PYWINTYPES_EXPORT PyObject *PyWinObject_FromOLECHAR(const OLECHAR *str);
+PYWINTYPES_EXPORT PyObject *PyWinObject_FromOLECHAR(const OLECHAR *str, Py_ssize_t numChars);
+
+#define PyWinObject_AsTCHAR PyWinObject_AsWCHAR
+#define PyWinObject_FreeTCHAR PyWinObject_FreeWCHAR
+#define PyWinObject_FromTCHAR PyWinObject_FromOLECHAR
+
+// String support for buffers allocated via CoTaskMemAlloc and CoTaskMemFree
+PYWINTYPES_EXPORT BOOL PyWinObject_AsTaskAllocatedWCHAR(PyObject *stringObject, WCHAR **ppResult, BOOL bNoneOK = FALSE);
+PYWINTYPES_EXPORT void PyWinObject_FreeTaskAllocatedWCHAR(WCHAR *str);
+
+// Copy null terminated string with same allocator as PyWinObject_AsWCHAR, etc
+// ? wot?
+PYWINTYPES_EXPORT WCHAR *PyWin_CopyString(const WCHAR *input);
+PYWINTYPES_EXPORT char *PyWin_CopyString(const char *input);
+
+// Some helpers for arrays of strings.
+//
+// Converts a series of consecutive null terminated strings into a list
+// ??? wot?
+PYWINTYPES_EXPORT PyObject *PyWinObject_FromMultipleString(WCHAR *multistring);
+PYWINTYPES_EXPORT PyObject *PyWinObject_FromMultipleString(char *multistring);
+// Converts a sequence of str/unicode objects into a series of consecutive null-terminated
+//	wide character strings with extra terminating null
+PYWINTYPES_EXPORT BOOL PyWinObject_AsMultipleString(PyObject *ob, WCHAR **pmultistring, BOOL bNoneOK = TRUE,
+                                                    DWORD *chars_returned = NULL);
+PYWINTYPES_EXPORT void PyWinObject_FreeMultipleString(WCHAR *pmultistring);
+
+// Convert a sequence of strings to an array of WCHAR pointers
+PYWINTYPES_EXPORT void PyWinObject_FreeWCHARArray(LPWSTR *wchars, DWORD str_cnt);
+PYWINTYPES_EXPORT BOOL PyWinObject_AsWCHARArray(PyObject *str_seq, LPWSTR **wchars, DWORD *str_cnt,
+                                                BOOL bNoneOK = FALSE);
+
+// Convert a sequence of string or unicode objects to an array of char *
+PYWINTYPES_EXPORT void PyWinObject_FreeCharArray(char **pchars, DWORD str_cnt);
+PYWINTYPES_EXPORT BOOL PyWinObject_AsCharArray(PyObject *str_seq, char ***pchars, DWORD *str_cnt, BOOL bNoneOK = FALSE);
+
+// Bytes/Buffer helpers.
+// replacement for PyWinObject_AsReadBuffer and PyWinObject_AsWriteBuffer
+class PYWINTYPES_EXPORT PyWinBufferView
+{
+public:
+    PyWinBufferView() { m_view.obj = NULL; }
+    PyWinBufferView(PyObject *ob, bool bWrite = false, bool bNoneOk = false) {
+        m_view.obj = NULL;
+        init(ob, bWrite, bNoneOk);
+    }
+    ~PyWinBufferView() { release(); }
+    bool init(PyObject *ob, bool bWrite = false, bool bNoneOk = false);
+    void release() {
+        if (m_view.obj != NULL && m_view.obj != Py_None) {
+            PyBuffer_Release(&m_view);  // sets view->obj = NULL
+        }
+    }
+    bool ok() { return m_view.obj != NULL; }
+    void* ptr() { return m_view.buf; }
+    DWORD len() { return static_cast<DWORD>(m_view.len); }
+
+private:
+    Py_buffer m_view;
+
+    // don't copy objects and don't use C++ >= 11 -> not implemented private
+    // copy ctor and assignment operator
+    PyWinBufferView(const PyWinBufferView& src);
+    PyWinBufferView& operator=(PyWinBufferView const &);
+};
+
+
+// For 64-bit python compatibility, convert sequence to tuple and check length fits in a DWORD
+PYWINTYPES_EXPORT PyObject *PyWinSequence_Tuple(PyObject *obseq, DWORD *len);
+
+// Pointers.
+// Substitute for Python's inconsistent PyLong_AsVoidPtr
+PYWINTYPES_EXPORT BOOL PyWinLong_AsVoidPtr(PyObject *ob, void **pptr);
+PYWINTYPES_EXPORT PyObject *PyWinLong_FromVoidPtr(const void *ptr);
+
+/*
+** LARGE_INTEGER objects
+*/
+// AsLARGE_INTEGER takes either int or long
+PYWINTYPES_EXPORT BOOL PyWinObject_AsLARGE_INTEGER(PyObject *ob, LARGE_INTEGER *pResult);
+PYWINTYPES_EXPORT BOOL PyWinObject_AsULARGE_INTEGER(PyObject *ob, ULARGE_INTEGER *pResult);
+PYWINTYPES_EXPORT PyObject *PyWinObject_FromLARGE_INTEGER(const LARGE_INTEGER &val);
+PYWINTYPES_EXPORT PyObject *PyWinObject_FromULARGE_INTEGER(const ULARGE_INTEGER &val);
+// Helpers that take a Py_LONG_LONG, but (a) have pywin32 consistent signatures
+// and (b) handle int *and* long (where Python only starts doing that in the
+// PyLong_* APIs post 2.4)
+// We also happen to know a LARGE_INTEGER is an __int64, so do it the easy way
+#define PyWinObject_AsPY_LONG_LONG(ob, pResult) PyWinObject_AsLARGE_INTEGER((ob), (LARGE_INTEGER *)(pResult))
+#define PyWinObject_AsUPY_LONG_LONG(ob, pResult) PyWinObject_AsULARGE_INTEGER((ob), (ULARGE_INTEGER *)(pResult))
+#define PyWinObject_FromPY_LONG_LONG(val) PyWinObject_FromLARGE_INTEGER((LARGE_INTEGER)val)
+#define PyWinObject_FromUPY_LONG_LONG(val) PyWinObject_FromULARGE_INTEGER((ULARGE_INTEGER)val)
+
+// A DWORD_PTR and ULONG_PTR appear to mean "integer long enough to hold a pointer"
+// It is *not* actually a pointer (but is the same size as a pointer)
+inline PyObject *PyWinObject_FromULONG_PTR(ULONG_PTR v) { return PyWinLong_FromVoidPtr((void *)v); }
+inline BOOL PyWinLong_AsULONG_PTR(PyObject *ob, ULONG_PTR *r) { return PyWinLong_AsVoidPtr(ob, (void **)r); }
+
+inline PyObject *PyWinObject_FromDWORD_PTR(DWORD_PTR v) { return PyLong_FromVoidPtr((void *)v); }
+inline BOOL PyWinLong_AsDWORD_PTR(PyObject *ob, DWORD_PTR *r) { return PyWinLong_AsVoidPtr(ob, (void **)r); }
+
+/*
+** OVERLAPPED Object and API
+*/
+class PyOVERLAPPED;                                      // forward declare
+extern PYWINTYPES_EXPORT PyTypeObject PyOVERLAPPEDType;  // the Type for PyOVERLAPPED
+#define PyOVERLAPPED_Check(ob) ((ob)->ob_type == &PyOVERLAPPEDType)
+PYWINTYPES_EXPORT BOOL PyWinObject_AsOVERLAPPED(PyObject *ob, OVERLAPPED **ppOverlapped, BOOL bNoneOK = TRUE);
+PYWINTYPES_EXPORT BOOL PyWinObject_AsPyOVERLAPPED(PyObject *ob, PyOVERLAPPED **ppOverlapped, BOOL bNoneOK = TRUE);
+PYWINTYPES_EXPORT PyObject *PyWinObject_FromOVERLAPPED(const OVERLAPPED *pOverlapped);
+
+// A global function that can work as a module method for making an OVERLAPPED object.
+PYWINTYPES_EXPORT PyObject *PyWinMethod_NewOVERLAPPED(PyObject *self, PyObject *args);
+
+#ifndef NO_PYWINTYPES_IID
+/*
+** IID/GUID support
+*/
+
+extern PYWINTYPES_EXPORT PyTypeObject PyIIDType;  // the Type for PyIID
+#define PyIID_Check(ob) ((ob)->ob_type == &PyIIDType)
+
+// Given an object repring a CLSID (either PyIID or string), fill the CLSID.
+PYWINTYPES_EXPORT BOOL PyWinObject_AsIID(PyObject *obCLSID, CLSID *clsid);
+
+// return a native PyIID object representing an IID
+PYWINTYPES_EXPORT PyObject *PyWinObject_FromIID(const IID &riid);
+
+// return a string/Unicode object representing an IID
+PYWINTYPES_EXPORT PyObject *PyWinCoreString_FromIID(const IID &riid);
+
+// A global function that can work as a module method for making an IID object.
+PYWINTYPES_EXPORT PyObject *PyWinMethod_NewIID(PyObject *self, PyObject *args);
+#endif /*NO_PYWINTYPES_IID */
+
+/*
+** TIME support
+**
+** We use a subclass of the builtin datetime.
+*/
+
+PYWINTYPES_EXPORT PyObject *PyWinObject_FromSYSTEMTIME(const SYSTEMTIME &t);
+PYWINTYPES_EXPORT PyObject *PyWinObject_FromFILETIME(const FILETIME &t);
+
+// Converts a TimeStamp, which is in 100 nanosecond units like a FILETIME
+// TimeStamp is actually defined as a LARGE_INTEGER, so this function will also
+// accept Windows security "TimeStamp" objects directly - however, we use a
+// LARGE_INTEGER prototype to avoid pulling in the windows security headers.
+PYWINTYPES_EXPORT PyObject *PyWinObject_FromTimeStamp(const LARGE_INTEGER &t);
+PYWINTYPES_EXPORT PyObject *PyWinTimeObject_Fromtime_t(time_t t);
+PYWINTYPES_EXPORT PyObject *PyWinObject_FromDATE(DATE t);
+
+PYWINTYPES_EXPORT BOOL PyWinObject_AsDATE(PyObject *ob, DATE *pDate);
+PYWINTYPES_EXPORT BOOL PyWinObject_AsFILETIME(PyObject *ob, FILETIME *pDate);
+PYWINTYPES_EXPORT BOOL PyWinObject_AsSYSTEMTIME(PyObject *ob, SYSTEMTIME *pDate);
+
+// A global function that can work as a module method for making a time object.
+PYWINTYPES_EXPORT PyObject *PyWinMethod_NewTime(PyObject *self, PyObject *args);
+PYWINTYPES_EXPORT PyObject *PyWinMethod_NewTimeStamp(PyObject *self, PyObject *args);
+
+PYWINTYPES_EXPORT BOOL PyWinTime_Check(PyObject *ob);
+
+// functions to return WIN32_FIND_DATA tuples, used in shell, win32api, and win32file
+PYWINTYPES_EXPORT PyObject *PyObject_FromWIN32_FIND_DATAW(WIN32_FIND_DATAW *pData);
+#define PyObject_FromWIN32_FIND_DATA PyObject_FromWIN32_FIND_DATAW
+
+// POINT tuple, used in win32api_display.cpp and win32gui.i
+PYWINTYPES_EXPORT BOOL PyWinObject_AsPOINT(PyObject *obpoint, LPPOINT ppoint);
+
+// IO_COUNTERS dict, used in win32process and win32job
+PYWINTYPES_EXPORT PyObject *PyWinObject_FromIO_COUNTERS(PIO_COUNTERS pioc);
+
+// Make an array of DWORD's from a sequence of Python ints
+PYWINTYPES_EXPORT BOOL PyWinObject_AsDWORDArray(PyObject *obdwords, DWORD **pdwords, DWORD *item_cnt,
+                                                BOOL bNoneOk = TRUE);
+
+// Conversion for resource id/name and class atom
+PYWINTYPES_EXPORT BOOL PyWinObject_AsResourceIdA(PyObject *ob, char **presource_id, BOOL bNoneOK = FALSE);
+PYWINTYPES_EXPORT void PyWinObject_FreeResourceIdA(char *resource_id);
+
+PYWINTYPES_EXPORT BOOL PyWinObject_AsResourceId(PyObject *ob, WCHAR **presource_id, BOOL bNoneOK = FALSE);
+PYWINTYPES_EXPORT void PyWinObject_FreeResourceId(WCHAR *resource_id);
+
+// WPARAM and LPARAM conversion.
+// Auto-freed WPARAM / LPARAM which ensure any memory referenced remains valid when a String or
+// Buffer object is used. Make sure the destructor is called with the GIL held.
+class PyWin_PARAMHolder {
+  protected:
+    WPARAM _pa;
+    // Holds *either* a PyWinBufferView (which will auto-free) *or* a "void *" that we
+    // will auto-free.
+    void *_pymem;
+    void _free() {
+        if (_pymem) {
+            PyMem_Free(_pymem);
+            _pymem = NULL;
+        }
+    }
+  public:
+    PyWinBufferView bufferView;
+
+    PyWin_PARAMHolder(WPARAM t=0):_pa(t),_pymem(NULL) {}
+    ~PyWin_PARAMHolder() {
+        _free();
+    }
+    WCHAR *set_allocated(WCHAR *t) {
+        assert(!bufferView.ok()); // should be one or the other.
+        _free();
+        _pymem = t;
+        _pa = (WPARAM)t;
+        return t;
+    }
+    // When init_buffer() fails, an appropriate Python error has been set too
+    bool init_buffer(PyObject *ob) {
+        assert(!_pymem); // should be one or the other!
+        _free();
+        if (!bufferView.init(ob)) {
+            return false;
+        }
+        _pa = (WPARAM)bufferView.ptr();
+        return true;
+    }
+
+    WPARAM operator=(WPARAM t) {
+        return _pa = t;
+    }
+    operator WPARAM() { return _pa; }
+    operator LPARAM() { return (LPARAM)_pa; }
+};
+
+PYWINTYPES_EXPORT BOOL PyWinObject_AsPARAM(PyObject *ob, PyWin_PARAMHolder *pparam);
+inline PyObject *PyWinObject_FromPARAM(WPARAM param) { return PyWinObject_FromULONG_PTR(param); }
+inline PyObject *PyWinObject_FromPARAM(LPARAM param) { return PyWinObject_FromULONG_PTR(param); }
+
+PYWINTYPES_EXPORT BOOL PyWinObject_AsSimplePARAM(PyObject *ob, WPARAM *pparam);
+inline BOOL PyWinObject_AsSimplePARAM(PyObject *ob, LPARAM *pparam) { return PyWinObject_AsSimplePARAM(ob, (WPARAM *)pparam); }
+
+// RECT conversions
+// @object PyRECT|Tuple of 4 ints defining a rectangle: (left, top, right, bottom)
+PYWINTYPES_EXPORT BOOL PyWinObject_AsRECT(PyObject *obrect, LPRECT prect);
+PYWINTYPES_EXPORT PyObject *PyWinObject_FromRECT(LPRECT prect);
+
+/*
+** SECURITY_ATTRIBUTES support
+*/
+extern PYWINTYPES_EXPORT PyTypeObject PySECURITY_ATTRIBUTESType;
+#define PySECURITY_ATTRIBUTES_Check(ob) ((ob)->ob_type == &PySECURITY_ATTRIBUTESType)
+extern PYWINTYPES_EXPORT PyTypeObject PyDEVMODEWType;
+
+PYWINTYPES_EXPORT PyObject *PyWinMethod_NewSECURITY_ATTRIBUTES(PyObject *self, PyObject *args);
+PYWINTYPES_EXPORT BOOL PyWinObject_AsSECURITY_ATTRIBUTES(PyObject *ob, SECURITY_ATTRIBUTES **ppSECURITY_ATTRIBUTES,
+                                                         BOOL bNoneOK = TRUE);
+PYWINTYPES_EXPORT PyObject *PyWinObject_FromSECURITY_ATTRIBUTES(const SECURITY_ATTRIBUTES &sa);
+PYWINTYPES_EXPORT BOOL PyWinObject_AsDEVMODE(PyObject *ob, PDEVMODEW *ppDEVMODE, BOOL bNoneOK);
+PYWINTYPES_EXPORT PyObject *PyWinObject_FromDEVMODE(PDEVMODEW);
+
+/*
+** WAVEFORMATEX support
+*/
+
+PYWINTYPES_EXPORT PyObject *PyWinMethod_NewWAVEFORMATEX(PyObject *self, PyObject *args);
+PYWINTYPES_EXPORT PyObject *PyWinObject_FromWAVEFROMATEX(const WAVEFORMATEX &wfx);
+PYWINTYPES_EXPORT BOOL PyWinObject_AsWAVEFORMATEX(PyObject *ob, WAVEFORMATEX **ppWAVEFORMATEX, BOOL bNoneOK = TRUE);
+extern PYWINTYPES_EXPORT PyTypeObject PyWAVEFORMATEXType;
+#define PyWAVEFORMATEX_Check(ob) ((ob)->ob_type == &PyWAVEFORMATEXType)
+
+/*
+** SECURITY_DESCRIPTOR support
+*/
+extern PYWINTYPES_EXPORT PyTypeObject PySECURITY_DESCRIPTORType;
+#define PySECURITY_DESCRIPTOR_Check(ob) ((ob)->ob_type == &PySECURITY_DESCRIPTORType)
+
+PYWINTYPES_EXPORT PyObject *PyWinMethod_NewSECURITY_DESCRIPTOR(PyObject *self, PyObject *args);
+PYWINTYPES_EXPORT BOOL PyWinObject_AsSECURITY_DESCRIPTOR(PyObject *ob, PSECURITY_DESCRIPTOR *ppSECURITY_DESCRIPTOR,
+                                                         BOOL bNoneOK = TRUE);
+PYWINTYPES_EXPORT PyObject *PyWinObject_FromSECURITY_DESCRIPTOR(PSECURITY_DESCRIPTOR psd);
+
+PYWINTYPES_EXPORT BOOL _MakeAbsoluteSD(PSECURITY_DESCRIPTOR psd_relative, PSECURITY_DESCRIPTOR *ppsd_absolute);
+PYWINTYPES_EXPORT void FreeAbsoluteSD(PSECURITY_DESCRIPTOR psd);
+
+/*
+** SID support
+*/
+extern PYWINTYPES_EXPORT PyTypeObject PySIDType;
+#define PySID_Check(ob) ((ob)->ob_type == &PySIDType)
+
+PYWINTYPES_EXPORT PyObject *PyWinMethod_NewSID(PyObject *self, PyObject *args);
+PYWINTYPES_EXPORT BOOL PyWinObject_AsSID(PyObject *ob, PSID *ppSID, BOOL bNoneOK = FALSE);
+PYWINTYPES_EXPORT PyObject *PyWinObject_FromSID(PSID pSID);
+
+/*
+** ACL support
+*/
+extern PYWINTYPES_EXPORT PyTypeObject PyACLType;
+#define PyACL_Check(ob) ((ob)->ob_type == &PyACLType)
+
+PYWINTYPES_EXPORT PyObject *PyWinMethod_NewACL(PyObject *self, PyObject *args);
+PYWINTYPES_EXPORT BOOL PyWinObject_AsACL(PyObject *ob, PACL *ppACL, BOOL bNoneOK = FALSE);
+
+/*
+** Win32 HANDLE wrapper - any handle closable by "CloseHandle()"
+*/
+extern PYWINTYPES_EXPORT PyTypeObject PyHANDLEType;  // the Type for PyHANDLE
+#define PyHANDLE_Check(ob) ((ob)->ob_type == &PyHANDLEType)
+
+// Convert an object to a HANDLE - None is always OK, as are ints, etc.
+PYWINTYPES_EXPORT BOOL PyWinObject_AsHANDLE(PyObject *ob, HANDLE *pRes);
+// For handles that use PyHANDLE.
+PYWINTYPES_EXPORT PyObject *PyWinObject_FromHANDLE(HANDLE h);
+// For handles that aren't returned as PyHANDLE or a subclass thereof (HDC, HWND, etc).
+// Return as python ints or longs
+PYWINTYPES_EXPORT PyObject *PyWinLong_FromHANDLE(HANDLE h);
+
+// A global function that can work as a module method for making a HANDLE object.
+PYWINTYPES_EXPORT PyObject *PyWinMethod_NewHANDLE(PyObject *self, PyObject *args);
+
+// A global function that does the right thing wrt closing a "handle".
+// The object can be either a PyHANDLE or an integer.
+// If result is FALSE, a Python error is all setup (cf PyHANDLE::Close(), which doesnt set the Python error)
+PYWINTYPES_EXPORT BOOL PyWinObject_CloseHANDLE(PyObject *obHandle);
+
+PYWINTYPES_EXPORT BOOL PyWinObject_AsHKEY(PyObject *ob, HKEY *pRes);
+PYWINTYPES_EXPORT PyObject *PyWinObject_FromHKEY(HKEY h);
+PYWINTYPES_EXPORT BOOL PyWinObject_CloseHKEY(PyObject *obHandle);
+
+// MSG structure keeps coming up...
+PYWINTYPES_EXPORT BOOL PyWinObject_AsMSG(PyObject *ob, MSG *pMsg);
+PYWINTYPES_EXPORT PyObject *PyWinObject_FromMSG(const MSG *pMsg);
+
+#include "winsock.h"
+/*
+** SOCKET support.
+*/
+PYWINTYPES_EXPORT
+BOOL PySocket_AsSOCKET
+    //-------------------------------------------------------------------------
+    // Helper function for dealing with socket arguments.
+    (PyObject *obSocket,
+     // [in] Python object being converted into a SOCKET handle.
+     SOCKET *ps
+     // [out] Returned socket handle
+    );
+
+/*
+** Other Utilities
+*/
+// ----------------------------------------------------------------------
+// WARNING - NEVER EVER USE new() ON THIS CLASS
+// This class can be used as a local variable, typically in a Python/C
+// function, and can be passed whereever a TCHAR/WCHAR is expected.
+// Typical Usage:
+// PyWin_AutoFreeBstr arg;
+// PyArg_ParseTuple("O", &obStr);
+// PyWinObject_AsAutoFreeBstr(obStr, &arg);
+// CallTheFunction(arg); // Will correctly pass BSTR/OLECHAR
+// -- when the function goes out of scope, the string owned by "arg" will
+// -- automatically be freed.
+// ----------------------------------------------------------------------
+class PYWINTYPES_EXPORT PyWin_AutoFreeBstr {
+   public:
+    PyWin_AutoFreeBstr(BSTR bstr = NULL);
+    ~PyWin_AutoFreeBstr();
+    void SetBstr(BSTR bstr);
+    operator BSTR() { return m_bstr; }
+
+   private:
+    BSTR m_bstr;
+};
+
+inline BOOL PyWinObject_AsAutoFreeBstr(PyObject *stringObject, PyWin_AutoFreeBstr *pResult, BOOL bNoneOK = FALSE)
+{
+    if (bNoneOK && stringObject == Py_None) {
+        pResult->SetBstr(NULL);
+        return TRUE;
+    }
+    BSTR bs;
+    if (!PyWinObject_AsBstr(stringObject, &bs, bNoneOK))
+        return FALSE;
+    pResult->SetBstr(bs);
+    return TRUE;
+}
+
+// ----------------------------------------------------------------------
+//
+// THREAD MANAGEMENT
+//
+
+// ### need to rename the PYCOM_ stuff soon...
+
+// We have 2 discrete locks in use (when no free-threaded is used, anyway).
+// The first type of lock is the global Python lock.  This is the standard lock
+// in use by Python, and must be used as documented by Python.  Specifically, no
+// 2 threads may _ever_ call _any_ Python code (including INCREF/DECREF) without
+// first having this thread lock.
+//
+// The second type of lock is a "global framework lock".  This lock is simply a
+// critical section, and used whenever 2 threads of C code need access to global
+// data.  This is different than the Python lock - this lock is used when no Python
+// code can ever be called by the threads, but the C code still needs thread-safety.
+
+// We also supply helper classes which make the usage of these locks a one-liner.
+
+// The "framework" lock, implemented as a critical section.
+PYWINTYPES_EXPORT void PyWin_AcquireGlobalLock(void);
+PYWINTYPES_EXPORT void PyWin_ReleaseGlobalLock(void);
+
+// Helper class for the DLL global lock.
+//
+// This class magically waits for the Win32/COM framework global lock, and releases it
+// when finished.
+// NEVER new one of these objects - only use on the stack!
+class CEnterLeaveFramework {
+   public:
+    CEnterLeaveFramework() { PyWin_AcquireGlobalLock(); }
+    ~CEnterLeaveFramework() { PyWin_ReleaseGlobalLock(); }
+};
+
+// Python thread-lock stuff.  Free-threading patches use different semantics, but
+// these are abstracted away here...
+#ifndef FORCE_NO_FREE_THREAD
+#ifdef WITH_FREE_THREAD
+#define PYCOM_USE_FREE_THREAD
+#endif
+#endif
+#ifdef PYCOM_USE_FREE_THREAD
+#include <threadstate.h>
+#else
+#include <pystate.h>
+#endif
+
+// Helper class for Enter/Leave Python
+//
+// This class magically waits for the Python global lock, and releases it
+// when finished.
+
+// Nested invocations will deadlock, so be careful.
+
+// NEVER new one of these objects - only use on the stack!
+#ifndef PYCOM_USE_FREE_THREAD
+extern PYWINTYPES_EXPORT PyInterpreterState *PyWin_InterpreterState;
+extern PYWINTYPES_EXPORT BOOL PyWinThreadState_Ensure();
+extern PYWINTYPES_EXPORT void PyWinThreadState_Free();
+extern PYWINTYPES_EXPORT void PyWinThreadState_Clear();
+extern PYWINTYPES_EXPORT void PyWinInterpreterLock_Acquire();
+extern PYWINTYPES_EXPORT void PyWinInterpreterLock_Release();
+
+extern PYWINTYPES_EXPORT int PyWinGlobals_Ensure();
+extern PYWINTYPES_EXPORT void PyWinGlobals_Free();
+#else
+#define PyWinThreadState_Ensure PyThreadState_Ensure
+#define PyWinThreadState_Free PyThreadState_Free
+#define PyWinThreadState_Clear PyThreadState_ClearExc
+
+#endif
+
+extern PYWINTYPES_EXPORT void PyWin_MakePendingCalls();
+
+class CEnterLeavePython {
+   public:
+    CEnterLeavePython() : released(TRUE) { acquire(); }
+    void acquire(void)
+    {
+        if (!released)
+            return;
+        state = PyGILState_Ensure();
+        released = FALSE;
+    }
+    ~CEnterLeavePython() { release(); }
+    void release(void)
+    {
+        if (!released) {
+            PyGILState_Release(state);
+            released = TRUE;
+        }
+    }
+
+   private:
+    PyGILState_STATE state;
+    BOOL released;
+};
+
+// A helper for simple exception handling.
+// try/__try
+#if defined(__MINGW32__) || defined(MAINWIN)
+#define PYWINTYPES_TRY try
+#else
+#define PYWINTYPES_TRY __try
+#endif /* MAINWIN */
+
+// catch/__except
+#if defined(__MINGW32__) || defined(MAINWIN)
+#define PYWINTYPES_EXCEPT catch (...)
+#else
+#define PYWINTYPES_EXCEPT __except (EXCEPTION_EXECUTE_HANDLER)
+#endif
+// End of exception helper macros.
+
+// Class to hold a temporary reference that decrements itself
+class TmpPyObject {
+   public:
+    PyObject *tmp;
+    TmpPyObject() { tmp = NULL; }
+    TmpPyObject(PyObject *ob) { tmp = ob; }
+    PyObject *operator=(PyObject *ob)
+    {
+        Py_XDECREF(tmp);
+        tmp = ob;
+        return tmp;
+    }
+
+    boolean operator==(PyObject *ob) { return tmp == ob; }
+    operator PyObject *() { return tmp; }
+    ~TmpPyObject() { Py_XDECREF(tmp); }
+};
+
+#endif  // __PYWINTYPES_H__
diff --git a/lib/win32/lib/afxres.py b/lib/win32/lib/afxres.py
new file mode 100644
index 00000000..249211ff
--- /dev/null
+++ b/lib/win32/lib/afxres.py
@@ -0,0 +1,501 @@
+# Generated by h2py from stdin
+TCS_MULTILINE = 0x0200
+CBRS_ALIGN_LEFT = 0x1000
+CBRS_ALIGN_TOP = 0x2000
+CBRS_ALIGN_RIGHT = 0x4000
+CBRS_ALIGN_BOTTOM = 0x8000
+CBRS_ALIGN_ANY = 0xF000
+CBRS_BORDER_LEFT = 0x0100
+CBRS_BORDER_TOP = 0x0200
+CBRS_BORDER_RIGHT = 0x0400
+CBRS_BORDER_BOTTOM = 0x0800
+CBRS_BORDER_ANY = 0x0F00
+CBRS_TOOLTIPS = 0x0010
+CBRS_FLYBY = 0x0020
+CBRS_FLOAT_MULTI = 0x0040
+CBRS_BORDER_3D = 0x0080
+CBRS_HIDE_INPLACE = 0x0008
+CBRS_SIZE_DYNAMIC = 0x0004
+CBRS_SIZE_FIXED = 0x0002
+CBRS_FLOATING = 0x0001
+CBRS_GRIPPER = 0x00400000
+CBRS_ORIENT_HORZ = CBRS_ALIGN_TOP | CBRS_ALIGN_BOTTOM
+CBRS_ORIENT_VERT = CBRS_ALIGN_LEFT | CBRS_ALIGN_RIGHT
+CBRS_ORIENT_ANY = CBRS_ORIENT_HORZ | CBRS_ORIENT_VERT
+CBRS_ALL = 0xFFFF
+CBRS_NOALIGN = 0x00000000
+CBRS_LEFT = CBRS_ALIGN_LEFT | CBRS_BORDER_RIGHT
+CBRS_TOP = CBRS_ALIGN_TOP | CBRS_BORDER_BOTTOM
+CBRS_RIGHT = CBRS_ALIGN_RIGHT | CBRS_BORDER_LEFT
+CBRS_BOTTOM = CBRS_ALIGN_BOTTOM | CBRS_BORDER_TOP
+SBPS_NORMAL = 0x0000
+SBPS_NOBORDERS = 0x0100
+SBPS_POPOUT = 0x0200
+SBPS_OWNERDRAW = 0x1000
+SBPS_DISABLED = 0x04000000
+SBPS_STRETCH = 0x08000000
+ID_INDICATOR_EXT = 0xE700
+ID_INDICATOR_CAPS = 0xE701
+ID_INDICATOR_NUM = 0xE702
+ID_INDICATOR_SCRL = 0xE703
+ID_INDICATOR_OVR = 0xE704
+ID_INDICATOR_REC = 0xE705
+ID_INDICATOR_KANA = 0xE706
+ID_SEPARATOR = 0
+AFX_IDW_CONTROLBAR_FIRST = 0xE800
+AFX_IDW_CONTROLBAR_LAST = 0xE8FF
+AFX_IDW_TOOLBAR = 0xE800
+AFX_IDW_STATUS_BAR = 0xE801
+AFX_IDW_PREVIEW_BAR = 0xE802
+AFX_IDW_RESIZE_BAR = 0xE803
+AFX_IDW_DOCKBAR_TOP = 0xE81B
+AFX_IDW_DOCKBAR_LEFT = 0xE81C
+AFX_IDW_DOCKBAR_RIGHT = 0xE81D
+AFX_IDW_DOCKBAR_BOTTOM = 0xE81E
+AFX_IDW_DOCKBAR_FLOAT = 0xE81F
+
+
+def AFX_CONTROLBAR_MASK(nIDC):
+    return 1 << (nIDC - AFX_IDW_CONTROLBAR_FIRST)
+
+
+AFX_IDW_PANE_FIRST = 0xE900
+AFX_IDW_PANE_LAST = 0xE9FF
+AFX_IDW_HSCROLL_FIRST = 0xEA00
+AFX_IDW_VSCROLL_FIRST = 0xEA10
+AFX_IDW_SIZE_BOX = 0xEA20
+AFX_IDW_PANE_SAVE = 0xEA21
+AFX_IDS_APP_TITLE = 0xE000
+AFX_IDS_IDLEMESSAGE = 0xE001
+AFX_IDS_HELPMODEMESSAGE = 0xE002
+AFX_IDS_APP_TITLE_EMBEDDING = 0xE003
+AFX_IDS_COMPANY_NAME = 0xE004
+AFX_IDS_OBJ_TITLE_INPLACE = 0xE005
+ID_FILE_NEW = 0xE100
+ID_FILE_OPEN = 0xE101
+ID_FILE_CLOSE = 0xE102
+ID_FILE_SAVE = 0xE103
+ID_FILE_SAVE_AS = 0xE104
+ID_FILE_PAGE_SETUP = 0xE105
+ID_FILE_PRINT_SETUP = 0xE106
+ID_FILE_PRINT = 0xE107
+ID_FILE_PRINT_DIRECT = 0xE108
+ID_FILE_PRINT_PREVIEW = 0xE109
+ID_FILE_UPDATE = 0xE10A
+ID_FILE_SAVE_COPY_AS = 0xE10B
+ID_FILE_SEND_MAIL = 0xE10C
+ID_FILE_MRU_FIRST = 0xE110
+ID_FILE_MRU_FILE1 = 0xE110
+ID_FILE_MRU_FILE2 = 0xE111
+ID_FILE_MRU_FILE3 = 0xE112
+ID_FILE_MRU_FILE4 = 0xE113
+ID_FILE_MRU_FILE5 = 0xE114
+ID_FILE_MRU_FILE6 = 0xE115
+ID_FILE_MRU_FILE7 = 0xE116
+ID_FILE_MRU_FILE8 = 0xE117
+ID_FILE_MRU_FILE9 = 0xE118
+ID_FILE_MRU_FILE10 = 0xE119
+ID_FILE_MRU_FILE11 = 0xE11A
+ID_FILE_MRU_FILE12 = 0xE11B
+ID_FILE_MRU_FILE13 = 0xE11C
+ID_FILE_MRU_FILE14 = 0xE11D
+ID_FILE_MRU_FILE15 = 0xE11E
+ID_FILE_MRU_FILE16 = 0xE11F
+ID_FILE_MRU_LAST = 0xE11F
+ID_EDIT_CLEAR = 0xE120
+ID_EDIT_CLEAR_ALL = 0xE121
+ID_EDIT_COPY = 0xE122
+ID_EDIT_CUT = 0xE123
+ID_EDIT_FIND = 0xE124
+ID_EDIT_PASTE = 0xE125
+ID_EDIT_PASTE_LINK = 0xE126
+ID_EDIT_PASTE_SPECIAL = 0xE127
+ID_EDIT_REPEAT = 0xE128
+ID_EDIT_REPLACE = 0xE129
+ID_EDIT_SELECT_ALL = 0xE12A
+ID_EDIT_UNDO = 0xE12B
+ID_EDIT_REDO = 0xE12C
+ID_WINDOW_NEW = 0xE130
+ID_WINDOW_ARRANGE = 0xE131
+ID_WINDOW_CASCADE = 0xE132
+ID_WINDOW_TILE_HORZ = 0xE133
+ID_WINDOW_TILE_VERT = 0xE134
+ID_WINDOW_SPLIT = 0xE135
+AFX_IDM_WINDOW_FIRST = 0xE130
+AFX_IDM_WINDOW_LAST = 0xE13F
+AFX_IDM_FIRST_MDICHILD = 0xFF00
+ID_APP_ABOUT = 0xE140
+ID_APP_EXIT = 0xE141
+ID_HELP_INDEX = 0xE142
+ID_HELP_FINDER = 0xE143
+ID_HELP_USING = 0xE144
+ID_CONTEXT_HELP = 0xE145
+ID_HELP = 0xE146
+ID_DEFAULT_HELP = 0xE147
+ID_NEXT_PANE = 0xE150
+ID_PREV_PANE = 0xE151
+ID_FORMAT_FONT = 0xE160
+ID_OLE_INSERT_NEW = 0xE200
+ID_OLE_EDIT_LINKS = 0xE201
+ID_OLE_EDIT_CONVERT = 0xE202
+ID_OLE_EDIT_CHANGE_ICON = 0xE203
+ID_OLE_EDIT_PROPERTIES = 0xE204
+ID_OLE_VERB_FIRST = 0xE210
+ID_OLE_VERB_LAST = 0xE21F
+AFX_ID_PREVIEW_CLOSE = 0xE300
+AFX_ID_PREVIEW_NUMPAGE = 0xE301
+AFX_ID_PREVIEW_NEXT = 0xE302
+AFX_ID_PREVIEW_PREV = 0xE303
+AFX_ID_PREVIEW_PRINT = 0xE304
+AFX_ID_PREVIEW_ZOOMIN = 0xE305
+AFX_ID_PREVIEW_ZOOMOUT = 0xE306
+ID_VIEW_TOOLBAR = 0xE800
+ID_VIEW_STATUS_BAR = 0xE801
+ID_RECORD_FIRST = 0xE900
+ID_RECORD_LAST = 0xE901
+ID_RECORD_NEXT = 0xE902
+ID_RECORD_PREV = 0xE903
+IDC_STATIC = -1
+AFX_IDS_SCFIRST = 0xEF00
+AFX_IDS_SCSIZE = 0xEF00
+AFX_IDS_SCMOVE = 0xEF01
+AFX_IDS_SCMINIMIZE = 0xEF02
+AFX_IDS_SCMAXIMIZE = 0xEF03
+AFX_IDS_SCNEXTWINDOW = 0xEF04
+AFX_IDS_SCPREVWINDOW = 0xEF05
+AFX_IDS_SCCLOSE = 0xEF06
+AFX_IDS_SCRESTORE = 0xEF12
+AFX_IDS_SCTASKLIST = 0xEF13
+AFX_IDS_MDICHILD = 0xEF1F
+AFX_IDS_DESKACCESSORY = 0xEFDA
+AFX_IDS_OPENFILE = 0xF000
+AFX_IDS_SAVEFILE = 0xF001
+AFX_IDS_ALLFILTER = 0xF002
+AFX_IDS_UNTITLED = 0xF003
+AFX_IDS_SAVEFILECOPY = 0xF004
+AFX_IDS_PREVIEW_CLOSE = 0xF005
+AFX_IDS_UNNAMED_FILE = 0xF006
+AFX_IDS_ABOUT = 0xF010
+AFX_IDS_HIDE = 0xF011
+AFX_IDP_NO_ERROR_AVAILABLE = 0xF020
+AFX_IDS_NOT_SUPPORTED_EXCEPTION = 0xF021
+AFX_IDS_RESOURCE_EXCEPTION = 0xF022
+AFX_IDS_MEMORY_EXCEPTION = 0xF023
+AFX_IDS_USER_EXCEPTION = 0xF024
+AFX_IDS_PRINTONPORT = 0xF040
+AFX_IDS_ONEPAGE = 0xF041
+AFX_IDS_TWOPAGE = 0xF042
+AFX_IDS_PRINTPAGENUM = 0xF043
+AFX_IDS_PREVIEWPAGEDESC = 0xF044
+AFX_IDS_PRINTDEFAULTEXT = 0xF045
+AFX_IDS_PRINTDEFAULT = 0xF046
+AFX_IDS_PRINTFILTER = 0xF047
+AFX_IDS_PRINTCAPTION = 0xF048
+AFX_IDS_PRINTTOFILE = 0xF049
+AFX_IDS_OBJECT_MENUITEM = 0xF080
+AFX_IDS_EDIT_VERB = 0xF081
+AFX_IDS_ACTIVATE_VERB = 0xF082
+AFX_IDS_CHANGE_LINK = 0xF083
+AFX_IDS_AUTO = 0xF084
+AFX_IDS_MANUAL = 0xF085
+AFX_IDS_FROZEN = 0xF086
+AFX_IDS_ALL_FILES = 0xF087
+AFX_IDS_SAVE_MENU = 0xF088
+AFX_IDS_UPDATE_MENU = 0xF089
+AFX_IDS_SAVE_AS_MENU = 0xF08A
+AFX_IDS_SAVE_COPY_AS_MENU = 0xF08B
+AFX_IDS_EXIT_MENU = 0xF08C
+AFX_IDS_UPDATING_ITEMS = 0xF08D
+AFX_IDS_METAFILE_FORMAT = 0xF08E
+AFX_IDS_DIB_FORMAT = 0xF08F
+AFX_IDS_BITMAP_FORMAT = 0xF090
+AFX_IDS_LINKSOURCE_FORMAT = 0xF091
+AFX_IDS_EMBED_FORMAT = 0xF092
+AFX_IDS_PASTELINKEDTYPE = 0xF094
+AFX_IDS_UNKNOWNTYPE = 0xF095
+AFX_IDS_RTF_FORMAT = 0xF096
+AFX_IDS_TEXT_FORMAT = 0xF097
+AFX_IDS_INVALID_CURRENCY = 0xF098
+AFX_IDS_INVALID_DATETIME = 0xF099
+AFX_IDS_INVALID_DATETIMESPAN = 0xF09A
+AFX_IDP_INVALID_FILENAME = 0xF100
+AFX_IDP_FAILED_TO_OPEN_DOC = 0xF101
+AFX_IDP_FAILED_TO_SAVE_DOC = 0xF102
+AFX_IDP_ASK_TO_SAVE = 0xF103
+AFX_IDP_FAILED_TO_CREATE_DOC = 0xF104
+AFX_IDP_FILE_TOO_LARGE = 0xF105
+AFX_IDP_FAILED_TO_START_PRINT = 0xF106
+AFX_IDP_FAILED_TO_LAUNCH_HELP = 0xF107
+AFX_IDP_INTERNAL_FAILURE = 0xF108
+AFX_IDP_COMMAND_FAILURE = 0xF109
+AFX_IDP_FAILED_MEMORY_ALLOC = 0xF10A
+AFX_IDP_PARSE_INT = 0xF110
+AFX_IDP_PARSE_REAL = 0xF111
+AFX_IDP_PARSE_INT_RANGE = 0xF112
+AFX_IDP_PARSE_REAL_RANGE = 0xF113
+AFX_IDP_PARSE_STRING_SIZE = 0xF114
+AFX_IDP_PARSE_RADIO_BUTTON = 0xF115
+AFX_IDP_PARSE_BYTE = 0xF116
+AFX_IDP_PARSE_UINT = 0xF117
+AFX_IDP_PARSE_DATETIME = 0xF118
+AFX_IDP_PARSE_CURRENCY = 0xF119
+AFX_IDP_FAILED_INVALID_FORMAT = 0xF120
+AFX_IDP_FAILED_INVALID_PATH = 0xF121
+AFX_IDP_FAILED_DISK_FULL = 0xF122
+AFX_IDP_FAILED_ACCESS_READ = 0xF123
+AFX_IDP_FAILED_ACCESS_WRITE = 0xF124
+AFX_IDP_FAILED_IO_ERROR_READ = 0xF125
+AFX_IDP_FAILED_IO_ERROR_WRITE = 0xF126
+AFX_IDP_STATIC_OBJECT = 0xF180
+AFX_IDP_FAILED_TO_CONNECT = 0xF181
+AFX_IDP_SERVER_BUSY = 0xF182
+AFX_IDP_BAD_VERB = 0xF183
+AFX_IDP_FAILED_TO_NOTIFY = 0xF185
+AFX_IDP_FAILED_TO_LAUNCH = 0xF186
+AFX_IDP_ASK_TO_UPDATE = 0xF187
+AFX_IDP_FAILED_TO_UPDATE = 0xF188
+AFX_IDP_FAILED_TO_REGISTER = 0xF189
+AFX_IDP_FAILED_TO_AUTO_REGISTER = 0xF18A
+AFX_IDP_FAILED_TO_CONVERT = 0xF18B
+AFX_IDP_GET_NOT_SUPPORTED = 0xF18C
+AFX_IDP_SET_NOT_SUPPORTED = 0xF18D
+AFX_IDP_ASK_TO_DISCARD = 0xF18E
+AFX_IDP_FAILED_TO_CREATE = 0xF18F
+AFX_IDP_FAILED_MAPI_LOAD = 0xF190
+AFX_IDP_INVALID_MAPI_DLL = 0xF191
+AFX_IDP_FAILED_MAPI_SEND = 0xF192
+AFX_IDP_FILE_NONE = 0xF1A0
+AFX_IDP_FILE_GENERIC = 0xF1A1
+AFX_IDP_FILE_NOT_FOUND = 0xF1A2
+AFX_IDP_FILE_BAD_PATH = 0xF1A3
+AFX_IDP_FILE_TOO_MANY_OPEN = 0xF1A4
+AFX_IDP_FILE_ACCESS_DENIED = 0xF1A5
+AFX_IDP_FILE_INVALID_FILE = 0xF1A6
+AFX_IDP_FILE_REMOVE_CURRENT = 0xF1A7
+AFX_IDP_FILE_DIR_FULL = 0xF1A8
+AFX_IDP_FILE_BAD_SEEK = 0xF1A9
+AFX_IDP_FILE_HARD_IO = 0xF1AA
+AFX_IDP_FILE_SHARING = 0xF1AB
+AFX_IDP_FILE_LOCKING = 0xF1AC
+AFX_IDP_FILE_DISKFULL = 0xF1AD
+AFX_IDP_FILE_EOF = 0xF1AE
+AFX_IDP_ARCH_NONE = 0xF1B0
+AFX_IDP_ARCH_GENERIC = 0xF1B1
+AFX_IDP_ARCH_READONLY = 0xF1B2
+AFX_IDP_ARCH_ENDOFFILE = 0xF1B3
+AFX_IDP_ARCH_WRITEONLY = 0xF1B4
+AFX_IDP_ARCH_BADINDEX = 0xF1B5
+AFX_IDP_ARCH_BADCLASS = 0xF1B6
+AFX_IDP_ARCH_BADSCHEMA = 0xF1B7
+AFX_IDS_OCC_SCALEUNITS_PIXELS = 0xF1C0
+AFX_IDS_STATUS_FONT = 0xF230
+AFX_IDS_TOOLTIP_FONT = 0xF231
+AFX_IDS_UNICODE_FONT = 0xF232
+AFX_IDS_MINI_FONT = 0xF233
+AFX_IDP_SQL_FIRST = 0xF280
+AFX_IDP_SQL_CONNECT_FAIL = 0xF281
+AFX_IDP_SQL_RECORDSET_FORWARD_ONLY = 0xF282
+AFX_IDP_SQL_EMPTY_COLUMN_LIST = 0xF283
+AFX_IDP_SQL_FIELD_SCHEMA_MISMATCH = 0xF284
+AFX_IDP_SQL_ILLEGAL_MODE = 0xF285
+AFX_IDP_SQL_MULTIPLE_ROWS_AFFECTED = 0xF286
+AFX_IDP_SQL_NO_CURRENT_RECORD = 0xF287
+AFX_IDP_SQL_NO_ROWS_AFFECTED = 0xF288
+AFX_IDP_SQL_RECORDSET_READONLY = 0xF289
+AFX_IDP_SQL_SQL_NO_TOTAL = 0xF28A
+AFX_IDP_SQL_ODBC_LOAD_FAILED = 0xF28B
+AFX_IDP_SQL_DYNASET_NOT_SUPPORTED = 0xF28C
+AFX_IDP_SQL_SNAPSHOT_NOT_SUPPORTED = 0xF28D
+AFX_IDP_SQL_API_CONFORMANCE = 0xF28E
+AFX_IDP_SQL_SQL_CONFORMANCE = 0xF28F
+AFX_IDP_SQL_NO_DATA_FOUND = 0xF290
+AFX_IDP_SQL_ROW_UPDATE_NOT_SUPPORTED = 0xF291
+AFX_IDP_SQL_ODBC_V2_REQUIRED = 0xF292
+AFX_IDP_SQL_NO_POSITIONED_UPDATES = 0xF293
+AFX_IDP_SQL_LOCK_MODE_NOT_SUPPORTED = 0xF294
+AFX_IDP_SQL_DATA_TRUNCATED = 0xF295
+AFX_IDP_SQL_ROW_FETCH = 0xF296
+AFX_IDP_SQL_INCORRECT_ODBC = 0xF297
+AFX_IDP_SQL_UPDATE_DELETE_FAILED = 0xF298
+AFX_IDP_SQL_DYNAMIC_CURSOR_NOT_SUPPORTED = 0xF299
+AFX_IDP_DAO_FIRST = 0xF2A0
+AFX_IDP_DAO_ENGINE_INITIALIZATION = 0xF2A0
+AFX_IDP_DAO_DFX_BIND = 0xF2A1
+AFX_IDP_DAO_OBJECT_NOT_OPEN = 0xF2A2
+AFX_IDP_DAO_ROWTOOSHORT = 0xF2A3
+AFX_IDP_DAO_BADBINDINFO = 0xF2A4
+AFX_IDP_DAO_COLUMNUNAVAILABLE = 0xF2A5
+AFX_IDC_LISTBOX = 100
+AFX_IDC_CHANGE = 101
+AFX_IDC_PRINT_DOCNAME = 201
+AFX_IDC_PRINT_PRINTERNAME = 202
+AFX_IDC_PRINT_PORTNAME = 203
+AFX_IDC_PRINT_PAGENUM = 204
+ID_APPLY_NOW = 0x3021
+ID_WIZBACK = 0x3023
+ID_WIZNEXT = 0x3024
+ID_WIZFINISH = 0x3025
+AFX_IDC_TAB_CONTROL = 0x3020
+AFX_IDD_FILEOPEN = 28676
+AFX_IDD_FILESAVE = 28677
+AFX_IDD_FONT = 28678
+AFX_IDD_COLOR = 28679
+AFX_IDD_PRINT = 28680
+AFX_IDD_PRINTSETUP = 28681
+AFX_IDD_FIND = 28682
+AFX_IDD_REPLACE = 28683
+AFX_IDD_NEWTYPEDLG = 30721
+AFX_IDD_PRINTDLG = 30722
+AFX_IDD_PREVIEW_TOOLBAR = 30723
+AFX_IDD_PREVIEW_SHORTTOOLBAR = 30731
+AFX_IDD_INSERTOBJECT = 30724
+AFX_IDD_CHANGEICON = 30725
+AFX_IDD_CONVERT = 30726
+AFX_IDD_PASTESPECIAL = 30727
+AFX_IDD_EDITLINKS = 30728
+AFX_IDD_FILEBROWSE = 30729
+AFX_IDD_BUSY = 30730
+AFX_IDD_OBJECTPROPERTIES = 30732
+AFX_IDD_CHANGESOURCE = 30733
+AFX_IDC_CONTEXTHELP = 30977
+AFX_IDC_MAGNIFY = 30978
+AFX_IDC_SMALLARROWS = 30979
+AFX_IDC_HSPLITBAR = 30980
+AFX_IDC_VSPLITBAR = 30981
+AFX_IDC_NODROPCRSR = 30982
+AFX_IDC_TRACKNWSE = 30983
+AFX_IDC_TRACKNESW = 30984
+AFX_IDC_TRACKNS = 30985
+AFX_IDC_TRACKWE = 30986
+AFX_IDC_TRACK4WAY = 30987
+AFX_IDC_MOVE4WAY = 30988
+AFX_IDB_MINIFRAME_MENU = 30994
+AFX_IDB_CHECKLISTBOX_NT = 30995
+AFX_IDB_CHECKLISTBOX_95 = 30996
+AFX_IDR_PREVIEW_ACCEL = 30997
+AFX_IDI_STD_MDIFRAME = 31233
+AFX_IDI_STD_FRAME = 31234
+AFX_IDC_FONTPROP = 1000
+AFX_IDC_FONTNAMES = 1001
+AFX_IDC_FONTSTYLES = 1002
+AFX_IDC_FONTSIZES = 1003
+AFX_IDC_STRIKEOUT = 1004
+AFX_IDC_UNDERLINE = 1005
+AFX_IDC_SAMPLEBOX = 1006
+AFX_IDC_COLOR_BLACK = 1100
+AFX_IDC_COLOR_WHITE = 1101
+AFX_IDC_COLOR_RED = 1102
+AFX_IDC_COLOR_GREEN = 1103
+AFX_IDC_COLOR_BLUE = 1104
+AFX_IDC_COLOR_YELLOW = 1105
+AFX_IDC_COLOR_MAGENTA = 1106
+AFX_IDC_COLOR_CYAN = 1107
+AFX_IDC_COLOR_GRAY = 1108
+AFX_IDC_COLOR_LIGHTGRAY = 1109
+AFX_IDC_COLOR_DARKRED = 1110
+AFX_IDC_COLOR_DARKGREEN = 1111
+AFX_IDC_COLOR_DARKBLUE = 1112
+AFX_IDC_COLOR_LIGHTBROWN = 1113
+AFX_IDC_COLOR_DARKMAGENTA = 1114
+AFX_IDC_COLOR_DARKCYAN = 1115
+AFX_IDC_COLORPROP = 1116
+AFX_IDC_SYSTEMCOLORS = 1117
+AFX_IDC_PROPNAME = 1201
+AFX_IDC_PICTURE = 1202
+AFX_IDC_BROWSE = 1203
+AFX_IDC_CLEAR = 1204
+AFX_IDD_PROPPAGE_COLOR = 32257
+AFX_IDD_PROPPAGE_FONT = 32258
+AFX_IDD_PROPPAGE_PICTURE = 32259
+AFX_IDB_TRUETYPE = 32384
+AFX_IDS_PROPPAGE_UNKNOWN = 0xFE01
+AFX_IDS_COLOR_DESKTOP = 0xFE04
+AFX_IDS_COLOR_APPWORKSPACE = 0xFE05
+AFX_IDS_COLOR_WNDBACKGND = 0xFE06
+AFX_IDS_COLOR_WNDTEXT = 0xFE07
+AFX_IDS_COLOR_MENUBAR = 0xFE08
+AFX_IDS_COLOR_MENUTEXT = 0xFE09
+AFX_IDS_COLOR_ACTIVEBAR = 0xFE0A
+AFX_IDS_COLOR_INACTIVEBAR = 0xFE0B
+AFX_IDS_COLOR_ACTIVETEXT = 0xFE0C
+AFX_IDS_COLOR_INACTIVETEXT = 0xFE0D
+AFX_IDS_COLOR_ACTIVEBORDER = 0xFE0E
+AFX_IDS_COLOR_INACTIVEBORDER = 0xFE0F
+AFX_IDS_COLOR_WNDFRAME = 0xFE10
+AFX_IDS_COLOR_SCROLLBARS = 0xFE11
+AFX_IDS_COLOR_BTNFACE = 0xFE12
+AFX_IDS_COLOR_BTNSHADOW = 0xFE13
+AFX_IDS_COLOR_BTNTEXT = 0xFE14
+AFX_IDS_COLOR_BTNHIGHLIGHT = 0xFE15
+AFX_IDS_COLOR_DISABLEDTEXT = 0xFE16
+AFX_IDS_COLOR_HIGHLIGHT = 0xFE17
+AFX_IDS_COLOR_HIGHLIGHTTEXT = 0xFE18
+AFX_IDS_REGULAR = 0xFE19
+AFX_IDS_BOLD = 0xFE1A
+AFX_IDS_ITALIC = 0xFE1B
+AFX_IDS_BOLDITALIC = 0xFE1C
+AFX_IDS_SAMPLETEXT = 0xFE1D
+AFX_IDS_DISPLAYSTRING_FONT = 0xFE1E
+AFX_IDS_DISPLAYSTRING_COLOR = 0xFE1F
+AFX_IDS_DISPLAYSTRING_PICTURE = 0xFE20
+AFX_IDS_PICTUREFILTER = 0xFE21
+AFX_IDS_PICTYPE_UNKNOWN = 0xFE22
+AFX_IDS_PICTYPE_NONE = 0xFE23
+AFX_IDS_PICTYPE_BITMAP = 0xFE24
+AFX_IDS_PICTYPE_METAFILE = 0xFE25
+AFX_IDS_PICTYPE_ICON = 0xFE26
+AFX_IDS_COLOR_PPG = 0xFE28
+AFX_IDS_COLOR_PPG_CAPTION = 0xFE29
+AFX_IDS_FONT_PPG = 0xFE2A
+AFX_IDS_FONT_PPG_CAPTION = 0xFE2B
+AFX_IDS_PICTURE_PPG = 0xFE2C
+AFX_IDS_PICTURE_PPG_CAPTION = 0xFE2D
+AFX_IDS_PICTUREBROWSETITLE = 0xFE30
+AFX_IDS_BORDERSTYLE_0 = 0xFE31
+AFX_IDS_BORDERSTYLE_1 = 0xFE32
+AFX_IDS_VERB_EDIT = 0xFE40
+AFX_IDS_VERB_PROPERTIES = 0xFE41
+AFX_IDP_PICTURECANTOPEN = 0xFE83
+AFX_IDP_PICTURECANTLOAD = 0xFE84
+AFX_IDP_PICTURETOOLARGE = 0xFE85
+AFX_IDP_PICTUREREADFAILED = 0xFE86
+AFX_IDP_E_ILLEGALFUNCTIONCALL = 0xFEA0
+AFX_IDP_E_OVERFLOW = 0xFEA1
+AFX_IDP_E_OUTOFMEMORY = 0xFEA2
+AFX_IDP_E_DIVISIONBYZERO = 0xFEA3
+AFX_IDP_E_OUTOFSTRINGSPACE = 0xFEA4
+AFX_IDP_E_OUTOFSTACKSPACE = 0xFEA5
+AFX_IDP_E_BADFILENAMEORNUMBER = 0xFEA6
+AFX_IDP_E_FILENOTFOUND = 0xFEA7
+AFX_IDP_E_BADFILEMODE = 0xFEA8
+AFX_IDP_E_FILEALREADYOPEN = 0xFEA9
+AFX_IDP_E_DEVICEIOERROR = 0xFEAA
+AFX_IDP_E_FILEALREADYEXISTS = 0xFEAB
+AFX_IDP_E_BADRECORDLENGTH = 0xFEAC
+AFX_IDP_E_DISKFULL = 0xFEAD
+AFX_IDP_E_BADRECORDNUMBER = 0xFEAE
+AFX_IDP_E_BADFILENAME = 0xFEAF
+AFX_IDP_E_TOOMANYFILES = 0xFEB0
+AFX_IDP_E_DEVICEUNAVAILABLE = 0xFEB1
+AFX_IDP_E_PERMISSIONDENIED = 0xFEB2
+AFX_IDP_E_DISKNOTREADY = 0xFEB3
+AFX_IDP_E_PATHFILEACCESSERROR = 0xFEB4
+AFX_IDP_E_PATHNOTFOUND = 0xFEB5
+AFX_IDP_E_INVALIDPATTERNSTRING = 0xFEB6
+AFX_IDP_E_INVALIDUSEOFNULL = 0xFEB7
+AFX_IDP_E_INVALIDFILEFORMAT = 0xFEB8
+AFX_IDP_E_INVALIDPROPERTYVALUE = 0xFEB9
+AFX_IDP_E_INVALIDPROPERTYARRAYINDEX = 0xFEBA
+AFX_IDP_E_SETNOTSUPPORTEDATRUNTIME = 0xFEBB
+AFX_IDP_E_SETNOTSUPPORTED = 0xFEBC
+AFX_IDP_E_NEEDPROPERTYARRAYINDEX = 0xFEBD
+AFX_IDP_E_SETNOTPERMITTED = 0xFEBE
+AFX_IDP_E_GETNOTSUPPORTEDATRUNTIME = 0xFEBF
+AFX_IDP_E_GETNOTSUPPORTED = 0xFEC0
+AFX_IDP_E_PROPERTYNOTFOUND = 0xFEC1
+AFX_IDP_E_INVALIDCLIPBOARDFORMAT = 0xFEC2
+AFX_IDP_E_INVALIDPICTURE = 0xFEC3
+AFX_IDP_E_PRINTERERROR = 0xFEC4
+AFX_IDP_E_CANTSAVEFILETOTEMP = 0xFEC5
+AFX_IDP_E_SEARCHTEXTNOTFOUND = 0xFEC6
+AFX_IDP_E_REPLACEMENTSTOOLONG = 0xFEC7
diff --git a/lib/win32/lib/commctrl.py b/lib/win32/lib/commctrl.py
new file mode 100644
index 00000000..26641e84
--- /dev/null
+++ b/lib/win32/lib/commctrl.py
@@ -0,0 +1,1551 @@
+# Generated by h2py from COMMCTRL.H
+WM_USER = 1024
+ICC_LISTVIEW_CLASSES = 1  # listview, header
+ICC_TREEVIEW_CLASSES = 2  # treeview, tooltips
+ICC_BAR_CLASSES = 4  # toolbar, statusbar, trackbar, tooltips
+ICC_TAB_CLASSES = 8  # tab, tooltips
+ICC_UPDOWN_CLASS = 16  # updown
+ICC_PROGRESS_CLASS = 32  # progress
+ICC_HOTKEY_CLASS = 64  # hotkey
+ICC_ANIMATE_CLASS = 128  # animate
+ICC_WIN95_CLASSES = 255
+ICC_DATE_CLASSES = 256  # month picker, date picker, time picker, updown
+ICC_USEREX_CLASSES = 512  # comboex
+ICC_COOL_CLASSES = 1024  # rebar (coolbar) control
+ICC_INTERNET_CLASSES = 2048
+ICC_PAGESCROLLER_CLASS = 4096  # page scroller
+ICC_NATIVEFNTCTL_CLASS = 8192  # native font control
+ODT_HEADER = 100
+ODT_TAB = 101
+ODT_LISTVIEW = 102
+PY_0U = 0
+NM_FIRST = PY_0U  # generic to all controls
+NM_LAST = PY_0U - 99
+LVN_FIRST = PY_0U - 100  # listview
+LVN_LAST = PY_0U - 199
+HDN_FIRST = PY_0U - 300  # header
+HDN_LAST = PY_0U - 399
+TVN_FIRST = PY_0U - 400  # treeview
+TVN_LAST = PY_0U - 499
+TTN_FIRST = PY_0U - 520  # tooltips
+TTN_LAST = PY_0U - 549
+TCN_FIRST = PY_0U - 550  # tab control
+TCN_LAST = PY_0U - 580
+CDN_FIRST = PY_0U - 601  # common dialog (new)
+CDN_LAST = PY_0U - 699
+TBN_FIRST = PY_0U - 700  # toolbar
+TBN_LAST = PY_0U - 720
+UDN_FIRST = PY_0U - 721  # updown
+UDN_LAST = PY_0U - 740
+MCN_FIRST = PY_0U - 750  # monthcal
+MCN_LAST = PY_0U - 759
+DTN_FIRST = PY_0U - 760  # datetimepick
+DTN_LAST = PY_0U - 799
+CBEN_FIRST = PY_0U - 800  # combo box ex
+CBEN_LAST = PY_0U - 830
+RBN_FIRST = PY_0U - 831  # rebar
+RBN_LAST = PY_0U - 859
+IPN_FIRST = PY_0U - 860  # internet address
+IPN_LAST = PY_0U - 879  # internet address
+SBN_FIRST = PY_0U - 880  # status bar
+SBN_LAST = PY_0U - 899
+PGN_FIRST = PY_0U - 900  # Pager Control
+PGN_LAST = PY_0U - 950
+LVM_FIRST = 4096  # ListView messages
+TV_FIRST = 4352  # TreeView messages
+HDM_FIRST = 4608  # Header messages
+TCM_FIRST = 4864  # Tab control messages
+PGM_FIRST = 5120  # Pager control messages
+CCM_FIRST = 8192  # Common control shared messages
+CCM_SETBKCOLOR = CCM_FIRST + 1  # lParam is bkColor
+CCM_SETCOLORSCHEME = CCM_FIRST + 2  # lParam is color scheme
+CCM_GETCOLORSCHEME = CCM_FIRST + 3  # fills in COLORSCHEME pointed to by lParam
+CCM_GETDROPTARGET = CCM_FIRST + 4
+CCM_SETUNICODEFORMAT = CCM_FIRST + 5
+CCM_GETUNICODEFORMAT = CCM_FIRST + 6
+INFOTIPSIZE = 1024
+NM_OUTOFMEMORY = NM_FIRST - 1
+NM_CLICK = NM_FIRST - 2  # uses NMCLICK struct
+NM_DBLCLK = NM_FIRST - 3
+NM_RETURN = NM_FIRST - 4
+NM_RCLICK = NM_FIRST - 5  # uses NMCLICK struct
+NM_RDBLCLK = NM_FIRST - 6
+NM_SETFOCUS = NM_FIRST - 7
+NM_KILLFOCUS = NM_FIRST - 8
+NM_CUSTOMDRAW = NM_FIRST - 12
+NM_HOVER = NM_FIRST - 13
+NM_NCHITTEST = NM_FIRST - 14  # uses NMMOUSE struct
+NM_KEYDOWN = NM_FIRST - 15  # uses NMKEY struct
+NM_RELEASEDCAPTURE = NM_FIRST - 16
+NM_SETCURSOR = NM_FIRST - 17  # uses NMMOUSE struct
+NM_CHAR = NM_FIRST - 18  # uses NMCHAR struct
+MSGF_COMMCTRL_BEGINDRAG = 16896
+MSGF_COMMCTRL_SIZEHEADER = 16897
+MSGF_COMMCTRL_DRAGSELECT = 16898
+MSGF_COMMCTRL_TOOLBARCUST = 16899
+CDRF_DODEFAULT = 0
+CDRF_NEWFONT = 2
+CDRF_SKIPDEFAULT = 4
+CDRF_NOTIFYPOSTPAINT = 16
+CDRF_NOTIFYITEMDRAW = 32
+CDRF_NOTIFYSUBITEMDRAW = 32  # flags are the same, we can distinguish by context
+CDRF_NOTIFYPOSTERASE = 64
+CDDS_PREPAINT = 1
+CDDS_POSTPAINT = 2
+CDDS_PREERASE = 3
+CDDS_POSTERASE = 4
+CDDS_ITEM = 65536
+CDDS_ITEMPREPAINT = CDDS_ITEM | CDDS_PREPAINT
+CDDS_ITEMPOSTPAINT = CDDS_ITEM | CDDS_POSTPAINT
+CDDS_ITEMPREERASE = CDDS_ITEM | CDDS_PREERASE
+CDDS_ITEMPOSTERASE = CDDS_ITEM | CDDS_POSTERASE
+CDDS_SUBITEM = 131072
+CDIS_SELECTED = 1
+CDIS_GRAYED = 2
+CDIS_DISABLED = 4
+CDIS_CHECKED = 8
+CDIS_FOCUS = 16
+CDIS_DEFAULT = 32
+CDIS_HOT = 64
+CDIS_MARKED = 128
+CDIS_INDETERMINATE = 256
+CLR_NONE = -1  # 0xFFFFFFFFL
+CLR_DEFAULT = -16777216  # 0xFF000000L
+ILC_MASK = 1
+ILC_COLOR = 0
+ILC_COLORDDB = 254
+ILC_COLOR4 = 4
+ILC_COLOR8 = 8
+ILC_COLOR16 = 16
+ILC_COLOR24 = 24
+ILC_COLOR32 = 32
+ILC_PALETTE = 2048  # (not implemented)
+ILD_NORMAL = 0
+ILD_TRANSPARENT = 1
+ILD_MASK = 16
+ILD_IMAGE = 32
+ILD_ROP = 64
+ILD_BLEND25 = 2
+ILD_BLEND50 = 4
+ILD_OVERLAYMASK = 3840
+ILD_SELECTED = ILD_BLEND50
+ILD_FOCUS = ILD_BLEND25
+ILD_BLEND = ILD_BLEND50
+CLR_HILIGHT = CLR_DEFAULT
+ILCF_MOVE = 0
+ILCF_SWAP = 1
+WC_HEADERA = "SysHeader32"
+WC_HEADER = WC_HEADERA
+HDS_HORZ = 0
+HDS_BUTTONS = 2
+HDS_HOTTRACK = 4
+HDS_HIDDEN = 8
+HDS_DRAGDROP = 64
+HDS_FULLDRAG = 128
+HDI_WIDTH = 1
+HDI_HEIGHT = HDI_WIDTH
+HDI_TEXT = 2
+HDI_FORMAT = 4
+HDI_LPARAM = 8
+HDI_BITMAP = 16
+HDI_IMAGE = 32
+HDI_DI_SETITEM = 64
+HDI_ORDER = 128
+HDF_LEFT = 0
+HDF_RIGHT = 1
+HDF_CENTER = 2
+HDF_JUSTIFYMASK = 3
+HDF_RTLREADING = 4
+HDF_OWNERDRAW = 32768
+HDF_STRING = 16384
+HDF_BITMAP = 8192
+HDF_BITMAP_ON_RIGHT = 4096
+HDF_IMAGE = 2048
+HDM_GETITEMCOUNT = HDM_FIRST + 0
+HDM_INSERTITEMA = HDM_FIRST + 1
+HDM_INSERTITEMW = HDM_FIRST + 10
+HDM_INSERTITEM = HDM_INSERTITEMA
+HDM_DELETEITEM = HDM_FIRST + 2
+HDM_GETITEMA = HDM_FIRST + 3
+HDM_GETITEMW = HDM_FIRST + 11
+HDM_GETITEM = HDM_GETITEMA
+HDM_SETITEMA = HDM_FIRST + 4
+HDM_SETITEMW = HDM_FIRST + 12
+HDM_SETITEM = HDM_SETITEMA
+HDM_LAYOUT = HDM_FIRST + 5
+HHT_NOWHERE = 1
+HHT_ONHEADER = 2
+HHT_ONDIVIDER = 4
+HHT_ONDIVOPEN = 8
+HHT_ABOVE = 256
+HHT_BELOW = 512
+HHT_TORIGHT = 1024
+HHT_TOLEFT = 2048
+HDM_HITTEST = HDM_FIRST + 6
+HDM_GETITEMRECT = HDM_FIRST + 7
+HDM_SETIMAGELIST = HDM_FIRST + 8
+HDM_GETIMAGELIST = HDM_FIRST + 9
+HDM_ORDERTOINDEX = HDM_FIRST + 15
+HDM_CREATEDRAGIMAGE = HDM_FIRST + 16  # wparam = which item (by index)
+HDM_GETORDERARRAY = HDM_FIRST + 17
+HDM_SETORDERARRAY = HDM_FIRST + 18
+HDM_SETHOTDIVIDER = HDM_FIRST + 19
+HDM_SETUNICODEFORMAT = CCM_SETUNICODEFORMAT
+HDM_GETUNICODEFORMAT = CCM_GETUNICODEFORMAT
+HDN_ITEMCHANGINGA = HDN_FIRST - 0
+HDN_ITEMCHANGINGW = HDN_FIRST - 20
+HDN_ITEMCHANGEDA = HDN_FIRST - 1
+HDN_ITEMCHANGEDW = HDN_FIRST - 21
+HDN_ITEMCLICKA = HDN_FIRST - 2
+HDN_ITEMCLICKW = HDN_FIRST - 22
+HDN_ITEMDBLCLICKA = HDN_FIRST - 3
+HDN_ITEMDBLCLICKW = HDN_FIRST - 23
+HDN_DIVIDERDBLCLICKA = HDN_FIRST - 5
+HDN_DIVIDERDBLCLICKW = HDN_FIRST - 25
+HDN_BEGINTRACKA = HDN_FIRST - 6
+HDN_BEGINTRACKW = HDN_FIRST - 26
+HDN_ENDTRACKA = HDN_FIRST - 7
+HDN_ENDTRACKW = HDN_FIRST - 27
+HDN_TRACKA = HDN_FIRST - 8
+HDN_TRACKW = HDN_FIRST - 28
+HDN_GETDISPINFOA = HDN_FIRST - 9
+HDN_GETDISPINFOW = HDN_FIRST - 29
+HDN_BEGINDRAG = HDN_FIRST - 10
+HDN_ENDDRAG = HDN_FIRST - 11
+HDN_ITEMCHANGING = HDN_ITEMCHANGINGA
+HDN_ITEMCHANGED = HDN_ITEMCHANGEDA
+HDN_ITEMCLICK = HDN_ITEMCLICKA
+HDN_ITEMDBLCLICK = HDN_ITEMDBLCLICKA
+HDN_DIVIDERDBLCLICK = HDN_DIVIDERDBLCLICKA
+HDN_BEGINTRACK = HDN_BEGINTRACKA
+HDN_ENDTRACK = HDN_ENDTRACKA
+HDN_TRACK = HDN_TRACKA
+HDN_GETDISPINFO = HDN_GETDISPINFOA
+TOOLBARCLASSNAMEA = "ToolbarWindow32"
+TOOLBARCLASSNAME = TOOLBARCLASSNAMEA
+CMB_MASKED = 2
+TBSTATE_CHECKED = 1
+TBSTATE_PRESSED = 2
+TBSTATE_ENABLED = 4
+TBSTATE_HIDDEN = 8
+TBSTATE_INDETERMINATE = 16
+TBSTATE_WRAP = 32
+TBSTATE_ELLIPSES = 64
+TBSTATE_MARKED = 128
+TBSTYLE_BUTTON = 0
+TBSTYLE_SEP = 1
+TBSTYLE_CHECK = 2
+TBSTYLE_GROUP = 4
+TBSTYLE_CHECKGROUP = TBSTYLE_GROUP | TBSTYLE_CHECK
+TBSTYLE_DROPDOWN = 8
+TBSTYLE_AUTOSIZE = 16  # automatically calculate the cx of the button
+TBSTYLE_NOPREFIX = 32  # if this button should not have accel prefix
+TBSTYLE_TOOLTIPS = 256
+TBSTYLE_WRAPABLE = 512
+TBSTYLE_ALTDRAG = 1024
+TBSTYLE_FLAT = 2048
+TBSTYLE_LIST = 4096
+TBSTYLE_CUSTOMERASE = 8192
+TBSTYLE_REGISTERDROP = 16384
+TBSTYLE_TRANSPARENT = 32768
+TBSTYLE_EX_DRAWDDARROWS = 1
+BTNS_BUTTON = TBSTYLE_BUTTON
+BTNS_SEP = TBSTYLE_SEP  # 0x0001
+BTNS_CHECK = TBSTYLE_CHECK  # 0x0002
+BTNS_GROUP = TBSTYLE_GROUP  # 0x0004
+BTNS_CHECKGROUP = TBSTYLE_CHECKGROUP  # (TBSTYLE_GROUP | TBSTYLE_CHECK)
+BTNS_DROPDOWN = TBSTYLE_DROPDOWN  # 0x0008
+BTNS_AUTOSIZE = TBSTYLE_AUTOSIZE  # 0x0010; automatically calculate the cx of the button
+BTNS_NOPREFIX = TBSTYLE_NOPREFIX  # 0x0020; this button should not have accel prefix
+BTNS_SHOWTEXT = (
+    64  # 0x0040              // ignored unless TBSTYLE_EX_MIXEDBUTTONS is set
+)
+BTNS_WHOLEDROPDOWN = (
+    128  # 0x0080          // draw drop-down arrow, but without split arrow section
+)
+TBCDRF_NOEDGES = 65536  # Don't draw button edges
+TBCDRF_HILITEHOTTRACK = 131072  # Use color of the button bk when hottracked
+TBCDRF_NOOFFSET = 262144  # Don't offset button if pressed
+TBCDRF_NOMARK = 524288  # Don't draw default highlight of image/text for TBSTATE_MARKED
+TBCDRF_NOETCHEDEFFECT = 1048576  # Don't draw etched effect for disabled items
+TB_ENABLEBUTTON = WM_USER + 1
+TB_CHECKBUTTON = WM_USER + 2
+TB_PRESSBUTTON = WM_USER + 3
+TB_HIDEBUTTON = WM_USER + 4
+TB_INDETERMINATE = WM_USER + 5
+TB_MARKBUTTON = WM_USER + 6
+TB_ISBUTTONENABLED = WM_USER + 9
+TB_ISBUTTONCHECKED = WM_USER + 10
+TB_ISBUTTONPRESSED = WM_USER + 11
+TB_ISBUTTONHIDDEN = WM_USER + 12
+TB_ISBUTTONINDETERMINATE = WM_USER + 13
+TB_ISBUTTONHIGHLIGHTED = WM_USER + 14
+TB_SETSTATE = WM_USER + 17
+TB_GETSTATE = WM_USER + 18
+TB_ADDBITMAP = WM_USER + 19
+HINST_COMMCTRL = -1
+IDB_STD_SMALL_COLOR = 0
+IDB_STD_LARGE_COLOR = 1
+IDB_VIEW_SMALL_COLOR = 4
+IDB_VIEW_LARGE_COLOR = 5
+IDB_HIST_SMALL_COLOR = 8
+IDB_HIST_LARGE_COLOR = 9
+STD_CUT = 0
+STD_COPY = 1
+STD_PASTE = 2
+STD_UNDO = 3
+STD_REDOW = 4
+STD_DELETE = 5
+STD_FILENEW = 6
+STD_FILEOPEN = 7
+STD_FILESAVE = 8
+STD_PRINTPRE = 9
+STD_PROPERTIES = 10
+STD_HELP = 11
+STD_FIND = 12
+STD_REPLACE = 13
+STD_PRINT = 14
+VIEW_LARGEICONS = 0
+VIEW_SMALLICONS = 1
+VIEW_LIST = 2
+VIEW_DETAILS = 3
+VIEW_SORTNAME = 4
+VIEW_SORTSIZE = 5
+VIEW_SORTDATE = 6
+VIEW_SORTTYPE = 7
+VIEW_PARENTFOLDER = 8
+VIEW_NETCONNECT = 9
+VIEW_NETDISCONNECT = 10
+VIEW_NEWFOLDER = 11
+VIEW_VIEWMENU = 12
+HIST_BACK = 0
+HIST_FORWARD = 1
+HIST_FAVORITES = 2
+HIST_ADDTOFAVORITES = 3
+HIST_VIEWTREE = 4
+TB_ADDBUTTONSA = WM_USER + 20
+TB_INSERTBUTTONA = WM_USER + 21
+TB_ADDBUTTONS = WM_USER + 20
+TB_INSERTBUTTON = WM_USER + 21
+TB_DELETEBUTTON = WM_USER + 22
+TB_GETBUTTON = WM_USER + 23
+TB_BUTTONCOUNT = WM_USER + 24
+TB_COMMANDTOINDEX = WM_USER + 25
+TB_SAVERESTOREA = WM_USER + 26
+TB_SAVERESTOREW = WM_USER + 76
+TB_CUSTOMIZE = WM_USER + 27
+TB_ADDSTRINGA = WM_USER + 28
+TB_ADDSTRINGW = WM_USER + 77
+TB_GETITEMRECT = WM_USER + 29
+TB_BUTTONSTRUCTSIZE = WM_USER + 30
+TB_SETBUTTONSIZE = WM_USER + 31
+TB_SETBITMAPSIZE = WM_USER + 32
+TB_AUTOSIZE = WM_USER + 33
+TB_GETTOOLTIPS = WM_USER + 35
+TB_SETTOOLTIPS = WM_USER + 36
+TB_SETPARENT = WM_USER + 37
+TB_SETROWS = WM_USER + 39
+TB_GETROWS = WM_USER + 40
+TB_SETCMDID = WM_USER + 42
+TB_CHANGEBITMAP = WM_USER + 43
+TB_GETBITMAP = WM_USER + 44
+TB_GETBUTTONTEXTA = WM_USER + 45
+TB_GETBUTTONTEXTW = WM_USER + 75
+TB_REPLACEBITMAP = WM_USER + 46
+TB_SETINDENT = WM_USER + 47
+TB_SETIMAGELIST = WM_USER + 48
+TB_GETIMAGELIST = WM_USER + 49
+TB_LOADIMAGES = WM_USER + 50
+TB_GETRECT = WM_USER + 51  # wParam is the Cmd instead of index
+TB_SETHOTIMAGELIST = WM_USER + 52
+TB_GETHOTIMAGELIST = WM_USER + 53
+TB_SETDISABLEDIMAGELIST = WM_USER + 54
+TB_GETDISABLEDIMAGELIST = WM_USER + 55
+TB_SETSTYLE = WM_USER + 56
+TB_GETSTYLE = WM_USER + 57
+TB_GETBUTTONSIZE = WM_USER + 58
+TB_SETBUTTONWIDTH = WM_USER + 59
+TB_SETMAXTEXTROWS = WM_USER + 60
+TB_GETTEXTROWS = WM_USER + 61
+TB_GETBUTTONTEXT = TB_GETBUTTONTEXTA
+TB_SAVERESTORE = TB_SAVERESTOREA
+TB_ADDSTRING = TB_ADDSTRINGA
+TB_GETOBJECT = WM_USER + 62  # wParam == IID, lParam void **ppv
+TB_GETHOTITEM = WM_USER + 71
+TB_SETHOTITEM = WM_USER + 72  # wParam == iHotItem
+TB_SETANCHORHIGHLIGHT = WM_USER + 73  # wParam == TRUE/FALSE
+TB_GETANCHORHIGHLIGHT = WM_USER + 74
+TB_MAPACCELERATORA = WM_USER + 78  # wParam == ch, lParam int * pidBtn
+TBIMHT_AFTER = 1  # TRUE = insert After iButton, otherwise before
+TBIMHT_BACKGROUND = 2  # TRUE iff missed buttons completely
+TB_GETINSERTMARK = WM_USER + 79  # lParam == LPTBINSERTMARK
+TB_SETINSERTMARK = WM_USER + 80  # lParam == LPTBINSERTMARK
+TB_INSERTMARKHITTEST = WM_USER + 81  # wParam == LPPOINT lParam == LPTBINSERTMARK
+TB_MOVEBUTTON = WM_USER + 82
+TB_GETMAXSIZE = WM_USER + 83  # lParam == LPSIZE
+TB_SETEXTENDEDSTYLE = WM_USER + 84  # For TBSTYLE_EX_*
+TB_GETEXTENDEDSTYLE = WM_USER + 85  # For TBSTYLE_EX_*
+TB_GETPADDING = WM_USER + 86
+TB_SETPADDING = WM_USER + 87
+TB_SETINSERTMARKCOLOR = WM_USER + 88
+TB_GETINSERTMARKCOLOR = WM_USER + 89
+TB_SETCOLORSCHEME = CCM_SETCOLORSCHEME  # lParam is color scheme
+TB_GETCOLORSCHEME = CCM_GETCOLORSCHEME  # fills in COLORSCHEME pointed to by lParam
+TB_SETUNICODEFORMAT = CCM_SETUNICODEFORMAT
+TB_GETUNICODEFORMAT = CCM_GETUNICODEFORMAT
+TB_MAPACCELERATORW = WM_USER + 90  # wParam == ch, lParam int * pidBtn
+TB_MAPACCELERATOR = TB_MAPACCELERATORA
+TBBF_LARGE = 1
+TB_GETBITMAPFLAGS = WM_USER + 41
+TBIF_IMAGE = 1
+TBIF_TEXT = 2
+TBIF_STATE = 4
+TBIF_STYLE = 8
+TBIF_LPARAM = 16
+TBIF_COMMAND = 32
+TBIF_SIZE = 64
+TB_GETBUTTONINFOW = WM_USER + 63
+TB_SETBUTTONINFOW = WM_USER + 64
+TB_GETBUTTONINFOA = WM_USER + 65
+TB_SETBUTTONINFOA = WM_USER + 66
+TB_INSERTBUTTONW = WM_USER + 67
+TB_ADDBUTTONSW = WM_USER + 68
+TB_HITTEST = WM_USER + 69
+TB_SETDRAWTEXTFLAGS = WM_USER + 70  # wParam == mask lParam == bit values
+TBN_GETBUTTONINFOA = TBN_FIRST - 0
+TBN_GETBUTTONINFOW = TBN_FIRST - 20
+TBN_BEGINDRAG = TBN_FIRST - 1
+TBN_ENDDRAG = TBN_FIRST - 2
+TBN_BEGINADJUST = TBN_FIRST - 3
+TBN_ENDADJUST = TBN_FIRST - 4
+TBN_RESET = TBN_FIRST - 5
+TBN_QUERYINSERT = TBN_FIRST - 6
+TBN_QUERYDELETE = TBN_FIRST - 7
+TBN_TOOLBARCHANGE = TBN_FIRST - 8
+TBN_CUSTHELP = TBN_FIRST - 9
+TBN_DROPDOWN = TBN_FIRST - 10
+TBN_GETOBJECT = TBN_FIRST - 12
+HICF_OTHER = 0
+HICF_MOUSE = 1  # Triggered by mouse
+HICF_ARROWKEYS = 2  # Triggered by arrow keys
+HICF_ACCELERATOR = 4  # Triggered by accelerator
+HICF_DUPACCEL = 8  # This accelerator is not unique
+HICF_ENTERING = 16  # idOld is invalid
+HICF_LEAVING = 32  # idNew is invalid
+HICF_RESELECT = 64  # hot item reselected
+TBN_HOTITEMCHANGE = TBN_FIRST - 13
+TBN_DRAGOUT = (
+    TBN_FIRST - 14
+)  # this is sent when the user clicks down on a button then drags off the button
+TBN_DELETINGBUTTON = TBN_FIRST - 15  # uses TBNOTIFY
+TBN_GETDISPINFOA = (
+    TBN_FIRST - 16
+)  # This is sent when the  toolbar needs  some display information
+TBN_GETDISPINFOW = (
+    TBN_FIRST - 17
+)  # This is sent when the  toolbar needs  some display information
+TBN_GETINFOTIPA = TBN_FIRST - 18
+TBN_GETINFOTIPW = TBN_FIRST - 19
+TBN_GETINFOTIP = TBN_GETINFOTIPA
+TBNF_IMAGE = 1
+TBNF_TEXT = 2
+TBNF_DI_SETITEM = 268435456
+TBN_GETDISPINFO = TBN_GETDISPINFOA
+TBDDRET_DEFAULT = 0
+TBDDRET_NODEFAULT = 1
+TBDDRET_TREATPRESSED = 2  # Treat as a standard press button
+TBN_GETBUTTONINFO = TBN_GETBUTTONINFOA
+REBARCLASSNAMEA = "ReBarWindow32"
+REBARCLASSNAME = REBARCLASSNAMEA
+RBIM_IMAGELIST = 1
+RBS_TOOLTIPS = 256
+RBS_VARHEIGHT = 512
+RBS_BANDBORDERS = 1024
+RBS_FIXEDORDER = 2048
+RBS_REGISTERDROP = 4096
+RBS_AUTOSIZE = 8192
+RBS_VERTICALGRIPPER = (
+    16384  # this always has the vertical gripper (default for horizontal mode)
+)
+RBS_DBLCLKTOGGLE = 32768
+RBBS_BREAK = 1  # break to new line
+RBBS_FIXEDSIZE = 2  # band can't be sized
+RBBS_CHILDEDGE = 4  # edge around top & bottom of child window
+RBBS_HIDDEN = 8  # don't show
+RBBS_NOVERT = 16  # don't show when vertical
+RBBS_FIXEDBMP = 32  # bitmap doesn't move during band resize
+RBBS_VARIABLEHEIGHT = 64  # allow autosizing of this child vertically
+RBBS_GRIPPERALWAYS = 128  # always show the gripper
+RBBS_NOGRIPPER = 256  # never show the gripper
+RBBIM_STYLE = 1
+RBBIM_COLORS = 2
+RBBIM_TEXT = 4
+RBBIM_IMAGE = 8
+RBBIM_CHILD = 16
+RBBIM_CHILDSIZE = 32
+RBBIM_SIZE = 64
+RBBIM_BACKGROUND = 128
+RBBIM_ID = 256
+RBBIM_IDEALSIZE = 512
+RBBIM_LPARAM = 1024
+RB_INSERTBANDA = WM_USER + 1
+RB_DELETEBAND = WM_USER + 2
+RB_GETBARINFO = WM_USER + 3
+RB_SETBARINFO = WM_USER + 4
+RB_SETBANDINFOA = WM_USER + 6
+RB_SETPARENT = WM_USER + 7
+RB_HITTEST = WM_USER + 8
+RB_GETRECT = WM_USER + 9
+RB_INSERTBANDW = WM_USER + 10
+RB_SETBANDINFOW = WM_USER + 11
+RB_GETBANDCOUNT = WM_USER + 12
+RB_GETROWCOUNT = WM_USER + 13
+RB_GETROWHEIGHT = WM_USER + 14
+RB_IDTOINDEX = WM_USER + 16  # wParam == id
+RB_GETTOOLTIPS = WM_USER + 17
+RB_SETTOOLTIPS = WM_USER + 18
+RB_SETBKCOLOR = WM_USER + 19  # sets the default BK color
+RB_GETBKCOLOR = WM_USER + 20  # defaults to CLR_NONE
+RB_SETTEXTCOLOR = WM_USER + 21
+RB_GETTEXTCOLOR = WM_USER + 22  # defaults to 0x00000000
+RB_SIZETORECT = (
+    WM_USER + 23
+)  # resize the rebar/break bands and such to this rect (lparam)
+RB_SETCOLORSCHEME = CCM_SETCOLORSCHEME  # lParam is color scheme
+RB_GETCOLORSCHEME = CCM_GETCOLORSCHEME  # fills in COLORSCHEME pointed to by lParam
+RB_INSERTBAND = RB_INSERTBANDA
+RB_SETBANDINFO = RB_SETBANDINFOA
+RB_BEGINDRAG = WM_USER + 24
+RB_ENDDRAG = WM_USER + 25
+RB_DRAGMOVE = WM_USER + 26
+RB_GETBARHEIGHT = WM_USER + 27
+RB_GETBANDINFOW = WM_USER + 28
+RB_GETBANDINFOA = WM_USER + 29
+RB_GETBANDINFO = RB_GETBANDINFOA
+RB_MINIMIZEBAND = WM_USER + 30
+RB_MAXIMIZEBAND = WM_USER + 31
+RB_GETDROPTARGET = CCM_GETDROPTARGET
+RB_GETBANDBORDERS = (
+    WM_USER + 34
+)  # returns in lparam = lprc the amount of edges added to band wparam
+RB_SHOWBAND = WM_USER + 35  # show/hide band
+RB_SETPALETTE = WM_USER + 37
+RB_GETPALETTE = WM_USER + 38
+RB_MOVEBAND = WM_USER + 39
+RB_SETUNICODEFORMAT = CCM_SETUNICODEFORMAT
+RB_GETUNICODEFORMAT = CCM_GETUNICODEFORMAT
+RBN_HEIGHTCHANGE = RBN_FIRST - 0
+RBN_GETOBJECT = RBN_FIRST - 1
+RBN_LAYOUTCHANGED = RBN_FIRST - 2
+RBN_AUTOSIZE = RBN_FIRST - 3
+RBN_BEGINDRAG = RBN_FIRST - 4
+RBN_ENDDRAG = RBN_FIRST - 5
+RBN_DELETINGBAND = RBN_FIRST - 6  # Uses NMREBAR
+RBN_DELETEDBAND = RBN_FIRST - 7  # Uses NMREBAR
+RBN_CHILDSIZE = RBN_FIRST - 8
+RBNM_ID = 1
+RBNM_STYLE = 2
+RBNM_LPARAM = 4
+RBHT_NOWHERE = 1
+RBHT_CAPTION = 2
+RBHT_CLIENT = 3
+RBHT_GRABBER = 4
+TOOLTIPS_CLASSA = "tooltips_class32"
+TOOLTIPS_CLASS = TOOLTIPS_CLASSA
+TTS_ALWAYSTIP = 1
+TTS_NOPREFIX = 2
+TTF_IDISHWND = 1
+TTF_CENTERTIP = 2
+TTF_RTLREADING = 4
+TTF_SUBCLASS = 16
+TTF_TRACK = 32
+TTF_ABSOLUTE = 128
+TTF_TRANSPARENT = 256
+TTF_DI_SETITEM = 32768  # valid only on the TTN_NEEDTEXT callback
+TTDT_AUTOMATIC = 0
+TTDT_RESHOW = 1
+TTDT_AUTOPOP = 2
+TTDT_INITIAL = 3
+TTM_ACTIVATE = WM_USER + 1
+TTM_SETDELAYTIME = WM_USER + 3
+TTM_ADDTOOLA = WM_USER + 4
+TTM_ADDTOOLW = WM_USER + 50
+TTM_DELTOOLA = WM_USER + 5
+TTM_DELTOOLW = WM_USER + 51
+TTM_NEWTOOLRECTA = WM_USER + 6
+TTM_NEWTOOLRECTW = WM_USER + 52
+TTM_RELAYEVENT = WM_USER + 7
+TTM_GETTOOLINFOA = WM_USER + 8
+TTM_GETTOOLINFOW = WM_USER + 53
+TTM_SETTOOLINFOA = WM_USER + 9
+TTM_SETTOOLINFOW = WM_USER + 54
+TTM_HITTESTA = WM_USER + 10
+TTM_HITTESTW = WM_USER + 55
+TTM_GETTEXTA = WM_USER + 11
+TTM_GETTEXTW = WM_USER + 56
+TTM_UPDATETIPTEXTA = WM_USER + 12
+TTM_UPDATETIPTEXTW = WM_USER + 57
+TTM_GETTOOLCOUNT = WM_USER + 13
+TTM_ENUMTOOLSA = WM_USER + 14
+TTM_ENUMTOOLSW = WM_USER + 58
+TTM_GETCURRENTTOOLA = WM_USER + 15
+TTM_GETCURRENTTOOLW = WM_USER + 59
+TTM_WINDOWFROMPOINT = WM_USER + 16
+TTM_TRACKACTIVATE = WM_USER + 17  # wParam = TRUE/FALSE start end  lparam = LPTOOLINFO
+TTM_TRACKPOSITION = WM_USER + 18  # lParam = dwPos
+TTM_SETTIPBKCOLOR = WM_USER + 19
+TTM_SETTIPTEXTCOLOR = WM_USER + 20
+TTM_GETDELAYTIME = WM_USER + 21
+TTM_GETTIPBKCOLOR = WM_USER + 22
+TTM_GETTIPTEXTCOLOR = WM_USER + 23
+TTM_SETMAXTIPWIDTH = WM_USER + 24
+TTM_GETMAXTIPWIDTH = WM_USER + 25
+TTM_SETMARGIN = WM_USER + 26  # lParam = lprc
+TTM_GETMARGIN = WM_USER + 27  # lParam = lprc
+TTM_POP = WM_USER + 28
+TTM_UPDATE = WM_USER + 29
+TTM_ADDTOOL = TTM_ADDTOOLA
+TTM_DELTOOL = TTM_DELTOOLA
+TTM_NEWTOOLRECT = TTM_NEWTOOLRECTA
+TTM_GETTOOLINFO = TTM_GETTOOLINFOA
+TTM_SETTOOLINFO = TTM_SETTOOLINFOA
+TTM_HITTEST = TTM_HITTESTA
+TTM_GETTEXT = TTM_GETTEXTA
+TTM_UPDATETIPTEXT = TTM_UPDATETIPTEXTA
+TTM_ENUMTOOLS = TTM_ENUMTOOLSA
+TTM_GETCURRENTTOOL = TTM_GETCURRENTTOOLA
+TTN_GETDISPINFOA = TTN_FIRST - 0
+TTN_GETDISPINFOW = TTN_FIRST - 10
+TTN_SHOW = TTN_FIRST - 1
+TTN_POP = TTN_FIRST - 2
+TTN_GETDISPINFO = TTN_GETDISPINFOA
+TTN_NEEDTEXT = TTN_GETDISPINFO
+TTN_NEEDTEXTA = TTN_GETDISPINFOA
+TTN_NEEDTEXTW = TTN_GETDISPINFOW
+SBARS_SIZEGRIP = 256
+SBARS_TOOLTIPS = 2048
+STATUSCLASSNAMEA = "msctls_statusbar32"
+STATUSCLASSNAME = STATUSCLASSNAMEA
+SB_SETTEXTA = WM_USER + 1
+SB_SETTEXTW = WM_USER + 11
+SB_GETTEXTA = WM_USER + 2
+SB_GETTEXTW = WM_USER + 13
+SB_GETTEXTLENGTHA = WM_USER + 3
+SB_GETTEXTLENGTHW = WM_USER + 12
+SB_GETTEXT = SB_GETTEXTA
+SB_SETTEXT = SB_SETTEXTA
+SB_GETTEXTLENGTH = SB_GETTEXTLENGTHA
+SB_SETPARTS = WM_USER + 4
+SB_GETPARTS = WM_USER + 6
+SB_GETBORDERS = WM_USER + 7
+SB_SETMINHEIGHT = WM_USER + 8
+SB_SIMPLE = WM_USER + 9
+SB_GETRECT = WM_USER + 10
+SB_ISSIMPLE = WM_USER + 14
+SB_SETICON = WM_USER + 15
+SB_SETTIPTEXTA = WM_USER + 16
+SB_SETTIPTEXTW = WM_USER + 17
+SB_GETTIPTEXTA = WM_USER + 18
+SB_GETTIPTEXTW = WM_USER + 19
+SB_GETICON = WM_USER + 20
+SB_SETTIPTEXT = SB_SETTIPTEXTA
+SB_GETTIPTEXT = SB_GETTIPTEXTA
+SB_SETUNICODEFORMAT = CCM_SETUNICODEFORMAT
+SB_GETUNICODEFORMAT = CCM_GETUNICODEFORMAT
+SBT_OWNERDRAW = 4096
+SBT_NOBORDERS = 256
+SBT_POPOUT = 512
+SBT_RTLREADING = 1024
+SBT_NOTABPARSING = 2048
+SBT_TOOLTIPS = 2048
+SB_SETBKCOLOR = CCM_SETBKCOLOR  # lParam = bkColor
+SBN_SIMPLEMODECHANGE = SBN_FIRST - 0
+TRACKBAR_CLASSA = "msctls_trackbar32"
+TRACKBAR_CLASS = TRACKBAR_CLASSA
+TBS_AUTOTICKS = 1
+TBS_VERT = 2
+TBS_HORZ = 0
+TBS_TOP = 4
+TBS_BOTTOM = 0
+TBS_LEFT = 4
+TBS_RIGHT = 0
+TBS_BOTH = 8
+TBS_NOTICKS = 16
+TBS_ENABLESELRANGE = 32
+TBS_FIXEDLENGTH = 64
+TBS_NOTHUMB = 128
+TBS_TOOLTIPS = 256
+TBM_GETPOS = WM_USER
+TBM_GETRANGEMIN = WM_USER + 1
+TBM_GETRANGEMAX = WM_USER + 2
+TBM_GETTIC = WM_USER + 3
+TBM_SETTIC = WM_USER + 4
+TBM_SETPOS = WM_USER + 5
+TBM_SETRANGE = WM_USER + 6
+TBM_SETRANGEMIN = WM_USER + 7
+TBM_SETRANGEMAX = WM_USER + 8
+TBM_CLEARTICS = WM_USER + 9
+TBM_SETSEL = WM_USER + 10
+TBM_SETSELSTART = WM_USER + 11
+TBM_SETSELEND = WM_USER + 12
+TBM_GETPTICS = WM_USER + 14
+TBM_GETTICPOS = WM_USER + 15
+TBM_GETNUMTICS = WM_USER + 16
+TBM_GETSELSTART = WM_USER + 17
+TBM_GETSELEND = WM_USER + 18
+TBM_CLEARSEL = WM_USER + 19
+TBM_SETTICFREQ = WM_USER + 20
+TBM_SETPAGESIZE = WM_USER + 21
+TBM_GETPAGESIZE = WM_USER + 22
+TBM_SETLINESIZE = WM_USER + 23
+TBM_GETLINESIZE = WM_USER + 24
+TBM_GETTHUMBRECT = WM_USER + 25
+TBM_GETCHANNELRECT = WM_USER + 26
+TBM_SETTHUMBLENGTH = WM_USER + 27
+TBM_GETTHUMBLENGTH = WM_USER + 28
+TBM_SETTOOLTIPS = WM_USER + 29
+TBM_GETTOOLTIPS = WM_USER + 30
+TBM_SETTIPSIDE = WM_USER + 31
+TBTS_TOP = 0
+TBTS_LEFT = 1
+TBTS_BOTTOM = 2
+TBTS_RIGHT = 3
+TBM_SETBUDDY = WM_USER + 32  # wparam = BOOL fLeft; (or right)
+TBM_GETBUDDY = WM_USER + 33  # wparam = BOOL fLeft; (or right)
+TBM_SETUNICODEFORMAT = CCM_SETUNICODEFORMAT
+TBM_GETUNICODEFORMAT = CCM_GETUNICODEFORMAT
+TB_LINEUP = 0
+TB_LINEDOWN = 1
+TB_PAGEUP = 2
+TB_PAGEDOWN = 3
+TB_THUMBPOSITION = 4
+TB_THUMBTRACK = 5
+TB_TOP = 6
+TB_BOTTOM = 7
+TB_ENDTRACK = 8
+TBCD_TICS = 1
+TBCD_THUMB = 2
+TBCD_CHANNEL = 3
+DL_BEGINDRAG = WM_USER + 133
+DL_DRAGGING = WM_USER + 134
+DL_DROPPED = WM_USER + 135
+DL_CANCELDRAG = WM_USER + 136
+DL_CURSORSET = 0
+DL_STOPCURSOR = 1
+DL_COPYCURSOR = 2
+DL_MOVECURSOR = 3
+DRAGLISTMSGSTRING = "commctrl_DragListMsg"
+UPDOWN_CLASSA = "msctls_updown32"
+UPDOWN_CLASS = UPDOWN_CLASSA
+UD_MAXVAL = 32767
+UD_MINVAL = -UD_MAXVAL
+UDS_WRAP = 1
+UDS_SETBUDDYINT = 2
+UDS_ALIGNRIGHT = 4
+UDS_ALIGNLEFT = 8
+UDS_AUTOBUDDY = 16
+UDS_ARROWKEYS = 32
+UDS_HORZ = 64
+UDS_NOTHOUSANDS = 128
+UDS_HOTTRACK = 256
+UDM_SETRANGE = WM_USER + 101
+UDM_GETRANGE = WM_USER + 102
+UDM_SETPOS = WM_USER + 103
+UDM_GETPOS = WM_USER + 104
+UDM_SETBUDDY = WM_USER + 105
+UDM_GETBUDDY = WM_USER + 106
+UDM_SETACCEL = WM_USER + 107
+UDM_GETACCEL = WM_USER + 108
+UDM_SETBASE = WM_USER + 109
+UDM_GETBASE = WM_USER + 110
+UDM_SETRANGE32 = WM_USER + 111
+UDM_GETRANGE32 = WM_USER + 112  # wParam & lParam are LPINT
+UDM_SETUNICODEFORMAT = CCM_SETUNICODEFORMAT
+UDM_GETUNICODEFORMAT = CCM_GETUNICODEFORMAT
+UDN_DELTAPOS = UDN_FIRST - 1
+PROGRESS_CLASSA = "msctls_progress32"
+PROGRESS_CLASS = PROGRESS_CLASSA
+PBS_SMOOTH = 1
+PBS_VERTICAL = 4
+PBM_SETRANGE = WM_USER + 1
+PBM_SETPOS = WM_USER + 2
+PBM_DELTAPOS = WM_USER + 3
+PBM_SETSTEP = WM_USER + 4
+PBM_STEPIT = WM_USER + 5
+PBM_SETRANGE32 = WM_USER + 6  # lParam = high, wParam = low
+PBM_GETRANGE = (
+    WM_USER + 7
+)  # wParam = return (TRUE ? low : high). lParam = PPBRANGE or NULL
+PBM_GETPOS = WM_USER + 8
+PBM_SETBARCOLOR = WM_USER + 9  # lParam = bar color
+PBM_SETBKCOLOR = CCM_SETBKCOLOR  # lParam = bkColor
+HOTKEYF_SHIFT = 1
+HOTKEYF_CONTROL = 2
+HOTKEYF_ALT = 4
+HOTKEYF_EXT = 8
+HKCOMB_NONE = 1
+HKCOMB_S = 2
+HKCOMB_C = 4
+HKCOMB_A = 8
+HKCOMB_SC = 16
+HKCOMB_SA = 32
+HKCOMB_CA = 64
+HKCOMB_SCA = 128
+HKM_SETHOTKEY = WM_USER + 1
+HKM_GETHOTKEY = WM_USER + 2
+HKM_SETRULES = WM_USER + 3
+HOTKEY_CLASSA = "msctls_hotkey32"
+HOTKEY_CLASS = HOTKEY_CLASSA
+CCS_TOP = 0x00000001
+CCS_NOMOVEY = 0x00000002
+CCS_BOTTOM = 0x00000003
+CCS_NORESIZE = 0x00000004
+CCS_NOPARENTALIGN = 0x00000008
+CCS_ADJUSTABLE = 0x00000020
+CCS_NODIVIDER = 0x00000040
+CCS_VERT = 0x00000080
+CCS_LEFT = CCS_VERT | CCS_TOP
+CCS_RIGHT = CCS_VERT | CCS_BOTTOM
+CCS_NOMOVEX = CCS_VERT | CCS_NOMOVEY
+WC_LISTVIEWA = "SysListView32"
+WC_LISTVIEW = WC_LISTVIEWA
+LVS_ICON = 0
+LVS_REPORT = 1
+LVS_SMALLICON = 2
+LVS_LIST = 3
+LVS_TYPEMASK = 3
+LVS_SINGLESEL = 4
+LVS_SHOWSELALWAYS = 8
+LVS_SORTASCENDING = 16
+LVS_SORTDESCENDING = 32
+LVS_SHAREIMAGELISTS = 64
+LVS_NOLABELWRAP = 128
+LVS_AUTOARRANGE = 256
+LVS_EDITLABELS = 512
+LVS_OWNERDATA = 4096
+LVS_NOSCROLL = 8192
+LVS_TYPESTYLEMASK = 64512
+LVS_ALIGNTOP = 0
+LVS_ALIGNLEFT = 2048
+LVS_ALIGNMASK = 3072
+LVS_OWNERDRAWFIXED = 1024
+LVS_NOCOLUMNHEADER = 16384
+LVS_NOSORTHEADER = 32768
+LVM_SETUNICODEFORMAT = CCM_SETUNICODEFORMAT
+LVM_GETUNICODEFORMAT = CCM_GETUNICODEFORMAT
+LVM_GETBKCOLOR = LVM_FIRST + 0
+LVM_SETBKCOLOR = LVM_FIRST + 1
+LVM_GETIMAGELIST = LVM_FIRST + 2
+LVSIL_NORMAL = 0
+LVSIL_SMALL = 1
+LVSIL_STATE = 2
+LVM_SETIMAGELIST = LVM_FIRST + 3
+LVM_GETITEMCOUNT = LVM_FIRST + 4
+LVIF_TEXT = 1
+LVIF_IMAGE = 2
+LVIF_PARAM = 4
+LVIF_STATE = 8
+LVIF_INDENT = 16
+LVIF_NORECOMPUTE = 2048
+LVIS_FOCUSED = 1
+LVIS_SELECTED = 2
+LVIS_CUT = 4
+LVIS_DROPHILITED = 8
+LVIS_ACTIVATING = 32
+LVIS_OVERLAYMASK = 3840
+LVIS_STATEIMAGEMASK = 61440
+I_INDENTCALLBACK = -1
+LPSTR_TEXTCALLBACKA = -1
+LPSTR_TEXTCALLBACK = LPSTR_TEXTCALLBACKA
+I_IMAGECALLBACK = -1
+LVM_GETITEMA = LVM_FIRST + 5
+LVM_GETITEMW = LVM_FIRST + 75
+LVM_GETITEM = LVM_GETITEMA
+LVM_SETITEMA = LVM_FIRST + 6
+LVM_SETITEMW = LVM_FIRST + 76
+LVM_SETITEM = LVM_SETITEMA
+LVM_INSERTITEMA = LVM_FIRST + 7
+LVM_INSERTITEMW = LVM_FIRST + 77
+LVM_INSERTITEM = LVM_INSERTITEMA
+LVM_DELETEITEM = LVM_FIRST + 8
+LVM_DELETEALLITEMS = LVM_FIRST + 9
+LVM_GETCALLBACKMASK = LVM_FIRST + 10
+LVM_SETCALLBACKMASK = LVM_FIRST + 11
+LVNI_ALL = 0
+LVNI_FOCUSED = 1
+LVNI_SELECTED = 2
+LVNI_CUT = 4
+LVNI_DROPHILITED = 8
+LVNI_ABOVE = 256
+LVNI_BELOW = 512
+LVNI_TOLEFT = 1024
+LVNI_TORIGHT = 2048
+LVM_GETNEXTITEM = LVM_FIRST + 12
+LVFI_PARAM = 1
+LVFI_STRING = 2
+LVFI_PARTIAL = 8
+LVFI_WRAP = 32
+LVFI_NEARESTXY = 64
+LVM_FINDITEMA = LVM_FIRST + 13
+LVM_FINDITEMW = LVM_FIRST + 83
+LVM_FINDITEM = LVM_FINDITEMA
+LVIR_BOUNDS = 0
+LVIR_ICON = 1
+LVIR_LABEL = 2
+LVIR_SELECTBOUNDS = 3
+LVM_GETITEMRECT = LVM_FIRST + 14
+LVM_SETITEMPOSITION = LVM_FIRST + 15
+LVM_GETITEMPOSITION = LVM_FIRST + 16
+LVM_GETSTRINGWIDTHA = LVM_FIRST + 17
+LVM_GETSTRINGWIDTHW = LVM_FIRST + 87
+LVM_GETSTRINGWIDTH = LVM_GETSTRINGWIDTHA
+LVHT_NOWHERE = 1
+LVHT_ONITEMICON = 2
+LVHT_ONITEMLABEL = 4
+LVHT_ONITEMSTATEICON = 8
+LVHT_ONITEM = LVHT_ONITEMICON | LVHT_ONITEMLABEL | LVHT_ONITEMSTATEICON
+LVHT_ABOVE = 8
+LVHT_BELOW = 16
+LVHT_TORIGHT = 32
+LVHT_TOLEFT = 64
+LVM_HITTEST = LVM_FIRST + 18
+LVM_ENSUREVISIBLE = LVM_FIRST + 19
+LVM_SCROLL = LVM_FIRST + 20
+LVM_REDRAWITEMS = LVM_FIRST + 21
+LVA_DEFAULT = 0
+LVA_ALIGNLEFT = 1
+LVA_ALIGNTOP = 2
+LVA_SNAPTOGRID = 5
+LVM_ARRANGE = LVM_FIRST + 22
+LVM_EDITLABELA = LVM_FIRST + 23
+LVM_EDITLABELW = LVM_FIRST + 118
+LVM_EDITLABEL = LVM_EDITLABELA
+LVM_GETEDITCONTROL = LVM_FIRST + 24
+LVCF_FMT = 1
+LVCF_WIDTH = 2
+LVCF_TEXT = 4
+LVCF_SUBITEM = 8
+LVCF_IMAGE = 16
+LVCF_ORDER = 32
+LVCFMT_LEFT = 0
+LVCFMT_RIGHT = 1
+LVCFMT_CENTER = 2
+LVCFMT_JUSTIFYMASK = 3
+LVCFMT_IMAGE = 2048
+LVCFMT_BITMAP_ON_RIGHT = 4096
+LVCFMT_COL_HAS_IMAGES = 32768
+LVM_GETCOLUMNA = LVM_FIRST + 25
+LVM_GETCOLUMNW = LVM_FIRST + 95
+LVM_GETCOLUMN = LVM_GETCOLUMNA
+LVM_SETCOLUMNA = LVM_FIRST + 26
+LVM_SETCOLUMNW = LVM_FIRST + 96
+LVM_SETCOLUMN = LVM_SETCOLUMNA
+LVM_INSERTCOLUMNA = LVM_FIRST + 27
+LVM_INSERTCOLUMNW = LVM_FIRST + 97
+LVM_INSERTCOLUMN = LVM_INSERTCOLUMNA
+LVM_DELETECOLUMN = LVM_FIRST + 28
+LVM_GETCOLUMNWIDTH = LVM_FIRST + 29
+LVSCW_AUTOSIZE = -1
+LVSCW_AUTOSIZE_USEHEADER = -2
+LVM_SETCOLUMNWIDTH = LVM_FIRST + 30
+LVM_GETHEADER = LVM_FIRST + 31
+LVM_CREATEDRAGIMAGE = LVM_FIRST + 33
+LVM_GETVIEWRECT = LVM_FIRST + 34
+LVM_GETTEXTCOLOR = LVM_FIRST + 35
+LVM_SETTEXTCOLOR = LVM_FIRST + 36
+LVM_GETTEXTBKCOLOR = LVM_FIRST + 37
+LVM_SETTEXTBKCOLOR = LVM_FIRST + 38
+LVM_GETTOPINDEX = LVM_FIRST + 39
+LVM_GETCOUNTPERPAGE = LVM_FIRST + 40
+LVM_GETORIGIN = LVM_FIRST + 41
+LVM_UPDATE = LVM_FIRST + 42
+LVM_SETITEMSTATE = LVM_FIRST + 43
+LVM_GETITEMSTATE = LVM_FIRST + 44
+LVM_GETITEMTEXTA = LVM_FIRST + 45
+LVM_GETITEMTEXTW = LVM_FIRST + 115
+LVM_GETITEMTEXT = LVM_GETITEMTEXTA
+LVM_SETITEMTEXTA = LVM_FIRST + 46
+LVM_SETITEMTEXTW = LVM_FIRST + 116
+LVM_SETITEMTEXT = LVM_SETITEMTEXTA
+LVSICF_NOINVALIDATEALL = 1
+LVSICF_NOSCROLL = 2
+LVM_SETITEMCOUNT = LVM_FIRST + 47
+LVM_SORTITEMS = LVM_FIRST + 48
+LVM_SETITEMPOSITION32 = LVM_FIRST + 49
+LVM_GETSELECTEDCOUNT = LVM_FIRST + 50
+LVM_GETITEMSPACING = LVM_FIRST + 51
+LVM_GETISEARCHSTRINGA = LVM_FIRST + 52
+LVM_GETISEARCHSTRINGW = LVM_FIRST + 117
+LVM_GETISEARCHSTRING = LVM_GETISEARCHSTRINGA
+LVM_SETICONSPACING = LVM_FIRST + 53
+LVM_SETEXTENDEDLISTVIEWSTYLE = LVM_FIRST + 54  # optional wParam == mask
+LVM_GETEXTENDEDLISTVIEWSTYLE = LVM_FIRST + 55
+LVS_EX_GRIDLINES = 1
+LVS_EX_SUBITEMIMAGES = 2
+LVS_EX_CHECKBOXES = 4
+LVS_EX_TRACKSELECT = 8
+LVS_EX_HEADERDRAGDROP = 16
+LVS_EX_FULLROWSELECT = 32  # applies to report mode only
+LVS_EX_ONECLICKACTIVATE = 64
+LVS_EX_TWOCLICKACTIVATE = 128
+LVS_EX_FLATSB = 256
+LVS_EX_REGIONAL = 512
+LVS_EX_INFOTIP = 1024  # listview does InfoTips for you
+LVS_EX_UNDERLINEHOT = 2048
+LVS_EX_UNDERLINECOLD = 4096
+LVS_EX_MULTIWORKAREAS = 8192
+LVM_GETSUBITEMRECT = LVM_FIRST + 56
+LVM_SUBITEMHITTEST = LVM_FIRST + 57
+LVM_SETCOLUMNORDERARRAY = LVM_FIRST + 58
+LVM_GETCOLUMNORDERARRAY = LVM_FIRST + 59
+LVM_SETHOTITEM = LVM_FIRST + 60
+LVM_GETHOTITEM = LVM_FIRST + 61
+LVM_SETHOTCURSOR = LVM_FIRST + 62
+LVM_GETHOTCURSOR = LVM_FIRST + 63
+LVM_APPROXIMATEVIEWRECT = LVM_FIRST + 64
+LV_MAX_WORKAREAS = 16
+LVM_SETWORKAREAS = LVM_FIRST + 65
+LVM_GETWORKAREAS = LVM_FIRST + 70
+LVM_GETNUMBEROFWORKAREAS = LVM_FIRST + 73
+LVM_GETSELECTIONMARK = LVM_FIRST + 66
+LVM_SETSELECTIONMARK = LVM_FIRST + 67
+LVM_SETHOVERTIME = LVM_FIRST + 71
+LVM_GETHOVERTIME = LVM_FIRST + 72
+LVM_SETTOOLTIPS = LVM_FIRST + 74
+LVM_GETTOOLTIPS = LVM_FIRST + 78
+LVBKIF_SOURCE_NONE = 0
+LVBKIF_SOURCE_HBITMAP = 1
+LVBKIF_SOURCE_URL = 2
+LVBKIF_SOURCE_MASK = 3
+LVBKIF_STYLE_NORMAL = 0
+LVBKIF_STYLE_TILE = 16
+LVBKIF_STYLE_MASK = 16
+LVM_SETBKIMAGEA = LVM_FIRST + 68
+LVM_SETBKIMAGEW = LVM_FIRST + 138
+LVM_GETBKIMAGEA = LVM_FIRST + 69
+LVM_GETBKIMAGEW = LVM_FIRST + 139
+LVKF_ALT = 1
+LVKF_CONTROL = 2
+LVKF_SHIFT = 4
+LVN_ITEMCHANGING = LVN_FIRST - 0
+LVN_ITEMCHANGED = LVN_FIRST - 1
+LVN_INSERTITEM = LVN_FIRST - 2
+LVN_DELETEITEM = LVN_FIRST - 3
+LVN_DELETEALLITEMS = LVN_FIRST - 4
+LVN_BEGINLABELEDITA = LVN_FIRST - 5
+LVN_BEGINLABELEDITW = LVN_FIRST - 75
+LVN_ENDLABELEDITA = LVN_FIRST - 6
+LVN_ENDLABELEDITW = LVN_FIRST - 76
+LVN_COLUMNCLICK = LVN_FIRST - 8
+LVN_BEGINDRAG = LVN_FIRST - 9
+LVN_BEGINRDRAG = LVN_FIRST - 11
+LVN_ODCACHEHINT = LVN_FIRST - 13
+LVN_ODFINDITEMA = LVN_FIRST - 52
+LVN_ODFINDITEMW = LVN_FIRST - 79
+LVN_ITEMACTIVATE = LVN_FIRST - 14
+LVN_ODSTATECHANGED = LVN_FIRST - 15
+LVN_ODFINDITEM = LVN_ODFINDITEMA
+LVN_HOTTRACK = LVN_FIRST - 21
+LVN_GETDISPINFOA = LVN_FIRST - 50
+LVN_GETDISPINFOW = LVN_FIRST - 77
+LVN_SETDISPINFOA = LVN_FIRST - 51
+LVN_SETDISPINFOW = LVN_FIRST - 78
+LVN_BEGINLABELEDIT = LVN_BEGINLABELEDITA
+LVN_ENDLABELEDIT = LVN_ENDLABELEDITA
+LVN_GETDISPINFO = LVN_GETDISPINFOA
+LVN_SETDISPINFO = LVN_SETDISPINFOA
+LVIF_DI_SETITEM = 4096
+LVN_KEYDOWN = LVN_FIRST - 55
+LVN_MARQUEEBEGIN = LVN_FIRST - 56
+LVGIT_UNFOLDED = 1
+LVN_GETINFOTIPA = LVN_FIRST - 57
+LVN_GETINFOTIPW = LVN_FIRST - 58
+LVN_GETINFOTIP = LVN_GETINFOTIPA
+WC_TREEVIEWA = "SysTreeView32"
+WC_TREEVIEW = WC_TREEVIEWA
+TVS_HASBUTTONS = 1
+TVS_HASLINES = 2
+TVS_LINESATROOT = 4
+TVS_EDITLABELS = 8
+TVS_DISABLEDRAGDROP = 16
+TVS_SHOWSELALWAYS = 32
+TVS_RTLREADING = 64
+TVS_NOTOOLTIPS = 128
+TVS_CHECKBOXES = 256
+TVS_TRACKSELECT = 512
+TVS_SINGLEEXPAND = 1024
+TVS_INFOTIP = 2048
+TVS_FULLROWSELECT = 4096
+TVS_NOSCROLL = 8192
+TVS_NONEVENHEIGHT = 16384
+TVIF_TEXT = 1
+TVIF_IMAGE = 2
+TVIF_PARAM = 4
+TVIF_STATE = 8
+TVIF_HANDLE = 16
+TVIF_SELECTEDIMAGE = 32
+TVIF_CHILDREN = 64
+TVIF_INTEGRAL = 128
+TVIS_SELECTED = 2
+TVIS_CUT = 4
+TVIS_DROPHILITED = 8
+TVIS_BOLD = 16
+TVIS_EXPANDED = 32
+TVIS_EXPANDEDONCE = 64
+TVIS_EXPANDPARTIAL = 128
+TVIS_OVERLAYMASK = 3840
+TVIS_STATEIMAGEMASK = 61440
+TVIS_USERMASK = 61440
+I_CHILDRENCALLBACK = -1
+TVI_ROOT = -65536
+TVI_FIRST = -65535
+TVI_LAST = -65534
+TVI_SORT = -65533
+TVM_INSERTITEMA = TV_FIRST + 0
+TVM_INSERTITEMW = TV_FIRST + 50
+TVM_INSERTITEM = TVM_INSERTITEMA
+TVM_DELETEITEM = TV_FIRST + 1
+TVM_EXPAND = TV_FIRST + 2
+TVE_COLLAPSE = 1
+TVE_EXPAND = 2
+TVE_TOGGLE = 3
+TVE_EXPANDPARTIAL = 16384
+TVE_COLLAPSERESET = 32768
+TVM_GETITEMRECT = TV_FIRST + 4
+TVM_GETCOUNT = TV_FIRST + 5
+TVM_GETINDENT = TV_FIRST + 6
+TVM_SETINDENT = TV_FIRST + 7
+TVM_GETIMAGELIST = TV_FIRST + 8
+TVSIL_NORMAL = 0
+TVSIL_STATE = 2
+TVM_SETIMAGELIST = TV_FIRST + 9
+TVM_GETNEXTITEM = TV_FIRST + 10
+TVGN_ROOT = 0
+TVGN_NEXT = 1
+TVGN_PREVIOUS = 2
+TVGN_PARENT = 3
+TVGN_CHILD = 4
+TVGN_FIRSTVISIBLE = 5
+TVGN_NEXTVISIBLE = 6
+TVGN_PREVIOUSVISIBLE = 7
+TVGN_DROPHILITE = 8
+TVGN_CARET = 9
+TVGN_LASTVISIBLE = 10
+TVM_SELECTITEM = TV_FIRST + 11
+TVM_GETITEMA = TV_FIRST + 12
+TVM_GETITEMW = TV_FIRST + 62
+TVM_GETITEM = TVM_GETITEMA
+TVM_SETITEMA = TV_FIRST + 13
+TVM_SETITEMW = TV_FIRST + 63
+TVM_SETITEM = TVM_SETITEMA
+TVM_EDITLABELA = TV_FIRST + 14
+TVM_EDITLABELW = TV_FIRST + 65
+TVM_EDITLABEL = TVM_EDITLABELA
+TVM_GETEDITCONTROL = TV_FIRST + 15
+TVM_GETVISIBLECOUNT = TV_FIRST + 16
+TVM_HITTEST = TV_FIRST + 17
+TVHT_NOWHERE = 1
+TVHT_ONITEMICON = 2
+TVHT_ONITEMLABEL = 4
+TVHT_ONITEMINDENT = 8
+TVHT_ONITEMBUTTON = 16
+TVHT_ONITEMRIGHT = 32
+TVHT_ONITEMSTATEICON = 64
+TVHT_ABOVE = 256
+TVHT_BELOW = 512
+TVHT_TORIGHT = 1024
+TVHT_TOLEFT = 2048
+TVHT_ONITEM = TVHT_ONITEMICON | TVHT_ONITEMLABEL | TVHT_ONITEMSTATEICON
+TVM_CREATEDRAGIMAGE = TV_FIRST + 18
+TVM_SORTCHILDREN = TV_FIRST + 19
+TVM_ENSUREVISIBLE = TV_FIRST + 20
+TVM_SORTCHILDRENCB = TV_FIRST + 21
+TVM_ENDEDITLABELNOW = TV_FIRST + 22
+TVM_GETISEARCHSTRINGA = TV_FIRST + 23
+TVM_GETISEARCHSTRINGW = TV_FIRST + 64
+TVM_GETISEARCHSTRING = TVM_GETISEARCHSTRINGA
+TVM_SETTOOLTIPS = TV_FIRST + 24
+TVM_GETTOOLTIPS = TV_FIRST + 25
+TVM_SETINSERTMARK = TV_FIRST + 26
+TVM_SETUNICODEFORMAT = CCM_SETUNICODEFORMAT
+TVM_GETUNICODEFORMAT = CCM_GETUNICODEFORMAT
+TVM_SETITEMHEIGHT = TV_FIRST + 27
+TVM_GETITEMHEIGHT = TV_FIRST + 28
+TVM_SETBKCOLOR = TV_FIRST + 29
+TVM_SETTEXTCOLOR = TV_FIRST + 30
+TVM_GETBKCOLOR = TV_FIRST + 31
+TVM_GETTEXTCOLOR = TV_FIRST + 32
+TVM_SETSCROLLTIME = TV_FIRST + 33
+TVM_GETSCROLLTIME = TV_FIRST + 34
+TVM_SETINSERTMARKCOLOR = TV_FIRST + 37
+TVM_GETINSERTMARKCOLOR = TV_FIRST + 38
+TVN_SELCHANGINGA = TVN_FIRST - 1
+TVN_SELCHANGINGW = TVN_FIRST - 50
+TVN_SELCHANGEDA = TVN_FIRST - 2
+TVN_SELCHANGEDW = TVN_FIRST - 51
+TVC_UNKNOWN = 0
+TVC_BYMOUSE = 1
+TVC_BYKEYBOARD = 2
+TVN_GETDISPINFOA = TVN_FIRST - 3
+TVN_GETDISPINFOW = TVN_FIRST - 52
+TVN_SETDISPINFOA = TVN_FIRST - 4
+TVN_SETDISPINFOW = TVN_FIRST - 53
+TVIF_DI_SETITEM = 4096
+TVN_ITEMEXPANDINGA = TVN_FIRST - 5
+TVN_ITEMEXPANDINGW = TVN_FIRST - 54
+TVN_ITEMEXPANDEDA = TVN_FIRST - 6
+TVN_ITEMEXPANDEDW = TVN_FIRST - 55
+TVN_BEGINDRAGA = TVN_FIRST - 7
+TVN_BEGINDRAGW = TVN_FIRST - 56
+TVN_BEGINRDRAGA = TVN_FIRST - 8
+TVN_BEGINRDRAGW = TVN_FIRST - 57
+TVN_DELETEITEMA = TVN_FIRST - 9
+TVN_DELETEITEMW = TVN_FIRST - 58
+TVN_BEGINLABELEDITA = TVN_FIRST - 10
+TVN_BEGINLABELEDITW = TVN_FIRST - 59
+TVN_ENDLABELEDITA = TVN_FIRST - 11
+TVN_ENDLABELEDITW = TVN_FIRST - 60
+TVN_KEYDOWN = TVN_FIRST - 12
+TVN_GETINFOTIPA = TVN_FIRST - 13
+TVN_GETINFOTIPW = TVN_FIRST - 14
+TVN_SINGLEEXPAND = TVN_FIRST - 15
+TVN_SELCHANGING = TVN_SELCHANGINGA
+TVN_SELCHANGED = TVN_SELCHANGEDA
+TVN_GETDISPINFO = TVN_GETDISPINFOA
+TVN_SETDISPINFO = TVN_SETDISPINFOA
+TVN_ITEMEXPANDING = TVN_ITEMEXPANDINGA
+TVN_ITEMEXPANDED = TVN_ITEMEXPANDEDA
+TVN_BEGINDRAG = TVN_BEGINDRAGA
+TVN_BEGINRDRAG = TVN_BEGINRDRAGA
+TVN_DELETEITEM = TVN_DELETEITEMA
+TVN_BEGINLABELEDIT = TVN_BEGINLABELEDITA
+TVN_ENDLABELEDIT = TVN_ENDLABELEDITA
+TVN_GETINFOTIP = TVN_GETINFOTIPA
+TVCDRF_NOIMAGES = 65536
+WC_COMBOBOXEXA = "ComboBoxEx32"
+WC_COMBOBOXEX = WC_COMBOBOXEXA
+CBEIF_TEXT = 1
+CBEIF_IMAGE = 2
+CBEIF_SELECTEDIMAGE = 4
+CBEIF_OVERLAY = 8
+CBEIF_INDENT = 16
+CBEIF_LPARAM = 32
+CBEIF_DI_SETITEM = 268435456
+CBEM_INSERTITEMA = WM_USER + 1
+CBEM_SETIMAGELIST = WM_USER + 2
+CBEM_GETIMAGELIST = WM_USER + 3
+CBEM_GETITEMA = WM_USER + 4
+CBEM_SETITEMA = WM_USER + 5
+# CBEM_DELETEITEM = CB_DELETESTRING
+CBEM_GETCOMBOCONTROL = WM_USER + 6
+CBEM_GETEDITCONTROL = WM_USER + 7
+CBEM_SETEXSTYLE = WM_USER + 8  # use  SETEXTENDEDSTYLE instead
+CBEM_SETEXTENDEDSTYLE = WM_USER + 14  # lparam == new style, wParam (optional) == mask
+CBEM_GETEXSTYLE = WM_USER + 9  # use GETEXTENDEDSTYLE instead
+CBEM_GETEXTENDEDSTYLE = WM_USER + 9
+CBEM_SETUNICODEFORMAT = CCM_SETUNICODEFORMAT
+CBEM_GETUNICODEFORMAT = CCM_GETUNICODEFORMAT
+CBEM_HASEDITCHANGED = WM_USER + 10
+CBEM_INSERTITEMW = WM_USER + 11
+CBEM_SETITEMW = WM_USER + 12
+CBEM_GETITEMW = WM_USER + 13
+CBEM_INSERTITEM = CBEM_INSERTITEMA
+CBEM_SETITEM = CBEM_SETITEMA
+CBEM_GETITEM = CBEM_GETITEMA
+CBES_EX_NOEDITIMAGE = 1
+CBES_EX_NOEDITIMAGEINDENT = 2
+CBES_EX_PATHWORDBREAKPROC = 4
+CBES_EX_NOSIZELIMIT = 8
+CBES_EX_CASESENSITIVE = 16
+CBEN_GETDISPINFO = CBEN_FIRST - 0
+CBEN_GETDISPINFOA = CBEN_FIRST - 0
+CBEN_INSERTITEM = CBEN_FIRST - 1
+CBEN_DELETEITEM = CBEN_FIRST - 2
+CBEN_BEGINEDIT = CBEN_FIRST - 4
+CBEN_ENDEDITA = CBEN_FIRST - 5
+CBEN_ENDEDITW = CBEN_FIRST - 6
+CBEN_GETDISPINFOW = CBEN_FIRST - 7
+CBEN_DRAGBEGINA = CBEN_FIRST - 8
+CBEN_DRAGBEGINW = CBEN_FIRST - 9
+CBEN_DRAGBEGIN = CBEN_DRAGBEGINA
+CBEN_ENDEDIT = CBEN_ENDEDITA
+CBENF_KILLFOCUS = 1
+CBENF_RETURN = 2
+CBENF_ESCAPE = 3
+CBENF_DROPDOWN = 4
+CBEMAXSTRLEN = 260
+WC_TABCONTROLA = "SysTabControl32"
+WC_TABCONTROL = WC_TABCONTROLA
+TCS_SCROLLOPPOSITE = 1  # assumes multiline tab
+TCS_BOTTOM = 2
+TCS_RIGHT = 2
+TCS_MULTISELECT = 4  # allow multi-select in button mode
+TCS_FLATBUTTONS = 8
+TCS_FORCEICONLEFT = 16
+TCS_FORCELABELLEFT = 32
+TCS_HOTTRACK = 64
+TCS_VERTICAL = 128
+TCS_TABS = 0
+TCS_BUTTONS = 256
+TCS_SINGLELINE = 0
+TCS_MULTILINE = 512
+TCS_RIGHTJUSTIFY = 0
+TCS_FIXEDWIDTH = 1024
+TCS_RAGGEDRIGHT = 2048
+TCS_FOCUSONBUTTONDOWN = 4096
+TCS_OWNERDRAWFIXED = 8192
+TCS_TOOLTIPS = 16384
+TCS_FOCUSNEVER = 32768
+TCS_EX_FLATSEPARATORS = 1
+TCS_EX_REGISTERDROP = 2
+TCM_GETIMAGELIST = TCM_FIRST + 2
+TCM_SETIMAGELIST = TCM_FIRST + 3
+TCM_GETITEMCOUNT = TCM_FIRST + 4
+TCIF_TEXT = 1
+TCIF_IMAGE = 2
+TCIF_RTLREADING = 4
+TCIF_PARAM = 8
+TCIF_STATE = 16
+TCIS_BUTTONPRESSED = 1
+TCIS_HIGHLIGHTED = 2
+TCM_GETITEMA = TCM_FIRST + 5
+TCM_GETITEMW = TCM_FIRST + 60
+TCM_GETITEM = TCM_GETITEMA
+TCM_SETITEMA = TCM_FIRST + 6
+TCM_SETITEMW = TCM_FIRST + 61
+TCM_SETITEM = TCM_SETITEMA
+TCM_INSERTITEMA = TCM_FIRST + 7
+TCM_INSERTITEMW = TCM_FIRST + 62
+TCM_INSERTITEM = TCM_INSERTITEMA
+TCM_DELETEITEM = TCM_FIRST + 8
+TCM_DELETEALLITEMS = TCM_FIRST + 9
+TCM_GETITEMRECT = TCM_FIRST + 10
+TCM_GETCURSEL = TCM_FIRST + 11
+TCM_SETCURSEL = TCM_FIRST + 12
+TCHT_NOWHERE = 1
+TCHT_ONITEMICON = 2
+TCHT_ONITEMLABEL = 4
+TCHT_ONITEM = TCHT_ONITEMICON | TCHT_ONITEMLABEL
+TCM_HITTEST = TCM_FIRST + 13
+TCM_SETITEMEXTRA = TCM_FIRST + 14
+TCM_ADJUSTRECT = TCM_FIRST + 40
+TCM_SETITEMSIZE = TCM_FIRST + 41
+TCM_REMOVEIMAGE = TCM_FIRST + 42
+TCM_SETPADDING = TCM_FIRST + 43
+TCM_GETROWCOUNT = TCM_FIRST + 44
+TCM_GETTOOLTIPS = TCM_FIRST + 45
+TCM_SETTOOLTIPS = TCM_FIRST + 46
+TCM_GETCURFOCUS = TCM_FIRST + 47
+TCM_SETCURFOCUS = TCM_FIRST + 48
+TCM_SETMINTABWIDTH = TCM_FIRST + 49
+TCM_DESELECTALL = TCM_FIRST + 50
+TCM_HIGHLIGHTITEM = TCM_FIRST + 51
+TCM_SETEXTENDEDSTYLE = TCM_FIRST + 52  # optional wParam == mask
+TCM_GETEXTENDEDSTYLE = TCM_FIRST + 53
+TCM_SETUNICODEFORMAT = CCM_SETUNICODEFORMAT
+TCM_GETUNICODEFORMAT = CCM_GETUNICODEFORMAT
+TCN_KEYDOWN = TCN_FIRST - 0
+ANIMATE_CLASSA = "SysAnimate32"
+ANIMATE_CLASS = ANIMATE_CLASSA
+ACS_CENTER = 1
+ACS_TRANSPARENT = 2
+ACS_AUTOPLAY = 4
+ACS_TIMER = 8  # don't use threads... use timers
+ACM_OPENA = WM_USER + 100
+ACM_OPENW = WM_USER + 103
+ACM_OPEN = ACM_OPENA
+ACM_PLAY = WM_USER + 101
+ACM_STOP = WM_USER + 102
+ACN_START = 1
+ACN_STOP = 2
+MONTHCAL_CLASSA = "SysMonthCal32"
+MONTHCAL_CLASS = MONTHCAL_CLASSA
+MCM_FIRST = 4096
+MCM_GETCURSEL = MCM_FIRST + 1
+MCM_SETCURSEL = MCM_FIRST + 2
+MCM_GETMAXSELCOUNT = MCM_FIRST + 3
+MCM_SETMAXSELCOUNT = MCM_FIRST + 4
+MCM_GETSELRANGE = MCM_FIRST + 5
+MCM_SETSELRANGE = MCM_FIRST + 6
+MCM_GETMONTHRANGE = MCM_FIRST + 7
+MCM_SETDAYSTATE = MCM_FIRST + 8
+MCM_GETMINREQRECT = MCM_FIRST + 9
+MCM_SETCOLOR = MCM_FIRST + 10
+MCM_GETCOLOR = MCM_FIRST + 11
+MCSC_BACKGROUND = 0  # the background color (between months)
+MCSC_TEXT = 1  # the dates
+MCSC_TITLEBK = 2  # background of the title
+MCSC_TITLETEXT = 3
+MCSC_MONTHBK = 4  # background within the month cal
+MCSC_TRAILINGTEXT = 5  # the text color of header & trailing days
+MCM_SETTODAY = MCM_FIRST + 12
+MCM_GETTODAY = MCM_FIRST + 13
+MCM_HITTEST = MCM_FIRST + 14
+MCHT_TITLE = 65536
+MCHT_CALENDAR = 131072
+MCHT_TODAYLINK = 196608
+MCHT_NEXT = 16777216  # these indicate that hitting
+MCHT_PREV = 33554432  # here will go to the next/prev month
+MCHT_NOWHERE = 0
+MCHT_TITLEBK = MCHT_TITLE
+MCHT_TITLEMONTH = MCHT_TITLE | 1
+MCHT_TITLEYEAR = MCHT_TITLE | 2
+MCHT_TITLEBTNNEXT = MCHT_TITLE | MCHT_NEXT | 3
+MCHT_TITLEBTNPREV = MCHT_TITLE | MCHT_PREV | 3
+MCHT_CALENDARBK = MCHT_CALENDAR
+MCHT_CALENDARDATE = MCHT_CALENDAR | 1
+MCHT_CALENDARDATENEXT = MCHT_CALENDARDATE | MCHT_NEXT
+MCHT_CALENDARDATEPREV = MCHT_CALENDARDATE | MCHT_PREV
+MCHT_CALENDARDAY = MCHT_CALENDAR | 2
+MCHT_CALENDARWEEKNUM = MCHT_CALENDAR | 3
+MCM_SETFIRSTDAYOFWEEK = MCM_FIRST + 15
+MCM_GETFIRSTDAYOFWEEK = MCM_FIRST + 16
+MCM_GETRANGE = MCM_FIRST + 17
+MCM_SETRANGE = MCM_FIRST + 18
+MCM_GETMONTHDELTA = MCM_FIRST + 19
+MCM_SETMONTHDELTA = MCM_FIRST + 20
+MCM_GETMAXTODAYWIDTH = MCM_FIRST + 21
+MCM_SETUNICODEFORMAT = CCM_SETUNICODEFORMAT
+MCM_GETUNICODEFORMAT = CCM_GETUNICODEFORMAT
+MCN_SELCHANGE = MCN_FIRST + 1
+MCN_GETDAYSTATE = MCN_FIRST + 3
+MCN_SELECT = MCN_FIRST + 4
+MCS_DAYSTATE = 1
+MCS_MULTISELECT = 2
+MCS_WEEKNUMBERS = 4
+MCS_NOTODAYCIRCLE = 8
+MCS_NOTODAY = 8
+GMR_VISIBLE = 0  # visible portion of display
+GMR_DAYSTATE = 1  # above plus the grayed out parts of
+DATETIMEPICK_CLASSA = "SysDateTimePick32"
+DATETIMEPICK_CLASS = DATETIMEPICK_CLASSA
+DTM_FIRST = 4096
+DTM_GETSYSTEMTIME = DTM_FIRST + 1
+DTM_SETSYSTEMTIME = DTM_FIRST + 2
+DTM_GETRANGE = DTM_FIRST + 3
+DTM_SETRANGE = DTM_FIRST + 4
+DTM_SETFORMATA = DTM_FIRST + 5
+DTM_SETFORMATW = DTM_FIRST + 50
+DTM_SETFORMAT = DTM_SETFORMATA
+DTM_SETMCCOLOR = DTM_FIRST + 6
+DTM_GETMCCOLOR = DTM_FIRST + 7
+DTM_GETMONTHCAL = DTM_FIRST + 8
+DTM_SETMCFONT = DTM_FIRST + 9
+DTM_GETMCFONT = DTM_FIRST + 10
+DTS_UPDOWN = 1  # use UPDOWN instead of MONTHCAL
+DTS_SHOWNONE = 2  # allow a NONE selection
+DTS_SHORTDATEFORMAT = (
+    0  # use the short date format (app must forward WM_WININICHANGE messages)
+)
+DTS_LONGDATEFORMAT = (
+    4  # use the long date format (app must forward WM_WININICHANGE messages)
+)
+DTS_TIMEFORMAT = 9  # use the time format (app must forward WM_WININICHANGE messages)
+DTS_APPCANPARSE = 16  # allow user entered strings (app MUST respond to DTN_USERSTRING)
+DTS_RIGHTALIGN = 32  # right-align popup instead of left-align it
+DTN_DATETIMECHANGE = DTN_FIRST + 1  # the systemtime has changed
+DTN_USERSTRINGA = DTN_FIRST + 2  # the user has entered a string
+DTN_USERSTRINGW = DTN_FIRST + 15
+DTN_USERSTRING = DTN_USERSTRINGW
+DTN_WMKEYDOWNA = DTN_FIRST + 3  # modify keydown on app format field (X)
+DTN_WMKEYDOWNW = DTN_FIRST + 16
+DTN_WMKEYDOWN = DTN_WMKEYDOWNA
+DTN_FORMATA = DTN_FIRST + 4  # query display for app format field (X)
+DTN_FORMATW = DTN_FIRST + 17
+DTN_FORMAT = DTN_FORMATA
+DTN_FORMATQUERYA = DTN_FIRST + 5  # query formatting info for app format field (X)
+DTN_FORMATQUERYW = DTN_FIRST + 18
+DTN_FORMATQUERY = DTN_FORMATQUERYA
+DTN_DROPDOWN = DTN_FIRST + 6  # MonthCal has dropped down
+DTN_CLOSEUP = DTN_FIRST + 7  # MonthCal is popping up
+GDTR_MIN = 1
+GDTR_MAX = 2
+GDT_ERROR = -1
+GDT_VALID = 0
+GDT_NONE = 1
+IPM_CLEARADDRESS = WM_USER + 100  # no parameters
+IPM_SETADDRESS = WM_USER + 101  # lparam = TCP/IP address
+IPM_GETADDRESS = (
+    WM_USER + 102
+)  # lresult = # of non black fields.  lparam = LPDWORD for TCP/IP address
+IPM_SETRANGE = WM_USER + 103  # wparam = field, lparam = range
+IPM_SETFOCUS = WM_USER + 104  # wparam = field
+IPM_ISBLANK = WM_USER + 105  # no parameters
+WC_IPADDRESSA = "SysIPAddress32"
+WC_IPADDRESS = WC_IPADDRESSA
+IPN_FIELDCHANGED = IPN_FIRST - 0
+WC_PAGESCROLLERA = "SysPager"
+WC_PAGESCROLLER = WC_PAGESCROLLERA
+PGS_VERT = 0
+PGS_HORZ = 1
+PGS_AUTOSCROLL = 2
+PGS_DRAGNDROP = 4
+PGF_INVISIBLE = 0  # Scroll button is not visible
+PGF_NORMAL = 1  # Scroll button is in normal state
+PGF_GRAYED = 2  # Scroll button is in grayed state
+PGF_DEPRESSED = 4  # Scroll button is in depressed state
+PGF_HOT = 8  # Scroll button is in hot state
+PGB_TOPORLEFT = 0
+PGB_BOTTOMORRIGHT = 1
+PGM_SETCHILD = PGM_FIRST + 1  # lParam == hwnd
+PGM_RECALCSIZE = PGM_FIRST + 2
+PGM_FORWARDMOUSE = PGM_FIRST + 3
+PGM_SETBKCOLOR = PGM_FIRST + 4
+PGM_GETBKCOLOR = PGM_FIRST + 5
+PGM_SETBORDER = PGM_FIRST + 6
+PGM_GETBORDER = PGM_FIRST + 7
+PGM_SETPOS = PGM_FIRST + 8
+PGM_GETPOS = PGM_FIRST + 9
+PGM_SETBUTTONSIZE = PGM_FIRST + 10
+PGM_GETBUTTONSIZE = PGM_FIRST + 11
+PGM_GETBUTTONSTATE = PGM_FIRST + 12
+PGM_GETDROPTARGET = CCM_GETDROPTARGET
+PGN_SCROLL = PGN_FIRST - 1
+PGF_SCROLLUP = 1
+PGF_SCROLLDOWN = 2
+PGF_SCROLLLEFT = 4
+PGF_SCROLLRIGHT = 8
+PGK_SHIFT = 1
+PGK_CONTROL = 2
+PGK_MENU = 4
+PGN_CALCSIZE = PGN_FIRST - 2
+PGF_CALCWIDTH = 1
+PGF_CALCHEIGHT = 2
+WC_NATIVEFONTCTLA = "NativeFontCtl"
+WC_NATIVEFONTCTL = WC_NATIVEFONTCTLA
+NFS_EDIT = 1
+NFS_STATIC = 2
+NFS_LISTCOMBO = 4
+NFS_BUTTON = 8
+NFS_ALL = 16
+WM_MOUSEHOVER = 673
+WM_MOUSELEAVE = 675
+TME_HOVER = 1
+TME_LEAVE = 2
+TME_QUERY = 1073741824
+TME_CANCEL = -2147483648
+HOVER_DEFAULT = -1
+WSB_PROP_CYVSCROLL = 0x00000001
+WSB_PROP_CXHSCROLL = 0x00000002
+WSB_PROP_CYHSCROLL = 0x00000004
+WSB_PROP_CXVSCROLL = 0x00000008
+WSB_PROP_CXHTHUMB = 0x00000010
+WSB_PROP_CYVTHUMB = 0x00000020
+WSB_PROP_VBKGCOLOR = 0x00000040
+WSB_PROP_HBKGCOLOR = 0x00000080
+WSB_PROP_VSTYLE = 0x00000100
+WSB_PROP_HSTYLE = 0x00000200
+WSB_PROP_WINSTYLE = 0x00000400
+WSB_PROP_PALETTE = 0x00000800
+WSB_PROP_MASK = 0x00000FFF
+FSB_FLAT_MODE = 2
+FSB_ENCARTA_MODE = 1
+FSB_REGULAR_MODE = 0
+
+
+def INDEXTOOVERLAYMASK(i):
+    return i << 8
+
+
+def INDEXTOSTATEIMAGEMASK(i):
+    return i << 12
diff --git a/lib/win32/lib/dbi.py b/lib/win32/lib/dbi.py
new file mode 100644
index 00000000..c33d6721
--- /dev/null
+++ b/lib/win32/lib/dbi.py
@@ -0,0 +1,27 @@
+"""
+Skeleton replacement for removed dbi module.
+Use of objects created by this module should be replaced with native Python objects.
+Dates are now returned as datetime.datetime objects, but will still accept PyTime
+objects also.
+Raw data for binary fields should be passed as buffer objects for Python 2.x,
+and memoryview objects in Py3k.
+"""
+
+import warnings
+
+warnings.warn(
+    "dbi module is obsolete, code should now use native python datetime and buffer/memoryview objects",
+    DeprecationWarning,
+)
+
+import datetime
+
+dbDate = dbiDate = datetime.datetime
+
+try:
+    dbRaw = dbiRaw = buffer
+except NameError:
+    dbRaw = dbiRaw = memoryview
+
+# type names are still exported by odbc module
+from odbc import *
diff --git a/lib/win32/lib/mmsystem.py b/lib/win32/lib/mmsystem.py
new file mode 100644
index 00000000..4d36b5ef
--- /dev/null
+++ b/lib/win32/lib/mmsystem.py
@@ -0,0 +1,954 @@
+# Generated by h2py from d:/msdev/include/mmsystem.h
+MAXPNAMELEN = 32
+MAXERRORLENGTH = 256
+MAX_JOYSTICKOEMVXDNAME = 260
+MM_MICROSOFT = 1
+MM_MIDI_MAPPER = 1
+MM_WAVE_MAPPER = 2
+MM_SNDBLST_MIDIOUT = 3
+MM_SNDBLST_MIDIIN = 4
+MM_SNDBLST_SYNTH = 5
+MM_SNDBLST_WAVEOUT = 6
+MM_SNDBLST_WAVEIN = 7
+MM_ADLIB = 9
+MM_MPU401_MIDIOUT = 10
+MM_MPU401_MIDIIN = 11
+MM_PC_JOYSTICK = 12
+TIME_MS = 0x0001
+TIME_SAMPLES = 0x0002
+TIME_BYTES = 0x0004
+TIME_SMPTE = 0x0008
+TIME_MIDI = 0x0010
+TIME_TICKS = 0x0020
+MM_JOY1MOVE = 0x3A0
+MM_JOY2MOVE = 0x3A1
+MM_JOY1ZMOVE = 0x3A2
+MM_JOY2ZMOVE = 0x3A3
+MM_JOY1BUTTONDOWN = 0x3B5
+MM_JOY2BUTTONDOWN = 0x3B6
+MM_JOY1BUTTONUP = 0x3B7
+MM_JOY2BUTTONUP = 0x3B8
+MM_MCINOTIFY = 0x3B9
+MM_WOM_OPEN = 0x3BB
+MM_WOM_CLOSE = 0x3BC
+MM_WOM_DONE = 0x3BD
+MM_WIM_OPEN = 0x3BE
+MM_WIM_CLOSE = 0x3BF
+MM_WIM_DATA = 0x3C0
+MM_MIM_OPEN = 0x3C1
+MM_MIM_CLOSE = 0x3C2
+MM_MIM_DATA = 0x3C3
+MM_MIM_LONGDATA = 0x3C4
+MM_MIM_ERROR = 0x3C5
+MM_MIM_LONGERROR = 0x3C6
+MM_MOM_OPEN = 0x3C7
+MM_MOM_CLOSE = 0x3C8
+MM_MOM_DONE = 0x3C9
+MM_STREAM_OPEN = 0x3D4
+MM_STREAM_CLOSE = 0x3D5
+MM_STREAM_DONE = 0x3D6
+MM_STREAM_ERROR = 0x3D7
+MM_MOM_POSITIONCB = 0x3CA
+MM_MIM_MOREDATA = 0x3CC
+MM_MIXM_LINE_CHANGE = 0x3D0
+MM_MIXM_CONTROL_CHANGE = 0x3D1
+MMSYSERR_BASE = 0
+WAVERR_BASE = 32
+MIDIERR_BASE = 64
+TIMERR_BASE = 96
+JOYERR_BASE = 160
+MCIERR_BASE = 256
+MIXERR_BASE = 1024
+MCI_STRING_OFFSET = 512
+MCI_VD_OFFSET = 1024
+MCI_CD_OFFSET = 1088
+MCI_WAVE_OFFSET = 1152
+MCI_SEQ_OFFSET = 1216
+MMSYSERR_NOERROR = 0
+MMSYSERR_ERROR = MMSYSERR_BASE + 1
+MMSYSERR_BADDEVICEID = MMSYSERR_BASE + 2
+MMSYSERR_NOTENABLED = MMSYSERR_BASE + 3
+MMSYSERR_ALLOCATED = MMSYSERR_BASE + 4
+MMSYSERR_INVALHANDLE = MMSYSERR_BASE + 5
+MMSYSERR_NODRIVER = MMSYSERR_BASE + 6
+MMSYSERR_NOMEM = MMSYSERR_BASE + 7
+MMSYSERR_NOTSUPPORTED = MMSYSERR_BASE + 8
+MMSYSERR_BADERRNUM = MMSYSERR_BASE + 9
+MMSYSERR_INVALFLAG = MMSYSERR_BASE + 10
+MMSYSERR_INVALPARAM = MMSYSERR_BASE + 11
+MMSYSERR_HANDLEBUSY = MMSYSERR_BASE + 12
+MMSYSERR_INVALIDALIAS = MMSYSERR_BASE + 13
+MMSYSERR_BADDB = MMSYSERR_BASE + 14
+MMSYSERR_KEYNOTFOUND = MMSYSERR_BASE + 15
+MMSYSERR_READERROR = MMSYSERR_BASE + 16
+MMSYSERR_WRITEERROR = MMSYSERR_BASE + 17
+MMSYSERR_DELETEERROR = MMSYSERR_BASE + 18
+MMSYSERR_VALNOTFOUND = MMSYSERR_BASE + 19
+MMSYSERR_NODRIVERCB = MMSYSERR_BASE + 20
+MMSYSERR_LASTERROR = MMSYSERR_BASE + 20
+DRV_LOAD = 0x0001
+DRV_ENABLE = 0x0002
+DRV_OPEN = 0x0003
+DRV_CLOSE = 0x0004
+DRV_DISABLE = 0x0005
+DRV_FREE = 0x0006
+DRV_CONFIGURE = 0x0007
+DRV_QUERYCONFIGURE = 0x0008
+DRV_INSTALL = 0x0009
+DRV_REMOVE = 0x000A
+DRV_EXITSESSION = 0x000B
+DRV_POWER = 0x000F
+DRV_RESERVED = 0x0800
+DRV_USER = 0x4000
+DRVCNF_CANCEL = 0x0000
+DRVCNF_OK = 0x0001
+DRVCNF_RESTART = 0x0002
+DRV_CANCEL = DRVCNF_CANCEL
+DRV_OK = DRVCNF_OK
+DRV_RESTART = DRVCNF_RESTART
+DRV_MCI_FIRST = DRV_RESERVED
+DRV_MCI_LAST = DRV_RESERVED + 0xFFF
+CALLBACK_TYPEMASK = 0x00070000
+CALLBACK_NULL = 0x00000000
+CALLBACK_WINDOW = 0x00010000
+CALLBACK_TASK = 0x00020000
+CALLBACK_FUNCTION = 0x00030000
+CALLBACK_THREAD = CALLBACK_TASK
+CALLBACK_EVENT = 0x00050000
+SND_SYNC = 0x0000
+SND_ASYNC = 0x0001
+SND_NODEFAULT = 0x0002
+SND_MEMORY = 0x0004
+SND_LOOP = 0x0008
+SND_NOSTOP = 0x0010
+SND_NOWAIT = 0x00002000
+SND_ALIAS = 0x00010000
+SND_ALIAS_ID = 0x00110000
+SND_FILENAME = 0x00020000
+SND_RESOURCE = 0x00040004
+SND_PURGE = 0x0040
+SND_APPLICATION = 0x0080
+SND_ALIAS_START = 0
+WAVERR_BADFORMAT = WAVERR_BASE + 0
+WAVERR_STILLPLAYING = WAVERR_BASE + 1
+WAVERR_UNPREPARED = WAVERR_BASE + 2
+WAVERR_SYNC = WAVERR_BASE + 3
+WAVERR_LASTERROR = WAVERR_BASE + 3
+WOM_OPEN = MM_WOM_OPEN
+WOM_CLOSE = MM_WOM_CLOSE
+WOM_DONE = MM_WOM_DONE
+WIM_OPEN = MM_WIM_OPEN
+WIM_CLOSE = MM_WIM_CLOSE
+WIM_DATA = MM_WIM_DATA
+WAVE_MAPPER = -1  # 0xFFFFFFFF
+WAVE_FORMAT_QUERY = 0x0001
+WAVE_ALLOWSYNC = 0x0002
+WAVE_MAPPED = 0x0004
+WAVE_FORMAT_DIRECT = 0x0008
+WAVE_FORMAT_DIRECT_QUERY = WAVE_FORMAT_QUERY | WAVE_FORMAT_DIRECT
+WHDR_DONE = 0x00000001
+WHDR_PREPARED = 0x00000002
+WHDR_BEGINLOOP = 0x00000004
+WHDR_ENDLOOP = 0x00000008
+WHDR_INQUEUE = 0x00000010
+WAVECAPS_PITCH = 0x0001
+WAVECAPS_PLAYBACKRATE = 0x0002
+WAVECAPS_VOLUME = 0x0004
+WAVECAPS_LRVOLUME = 0x0008
+WAVECAPS_SYNC = 0x0010
+WAVECAPS_SAMPLEACCURATE = 0x0020
+WAVECAPS_DIRECTSOUND = 0x0040
+WAVE_INVALIDFORMAT = 0x00000000
+WAVE_FORMAT_1M08 = 0x00000001
+WAVE_FORMAT_1S08 = 0x00000002
+WAVE_FORMAT_1M16 = 0x00000004
+WAVE_FORMAT_1S16 = 0x00000008
+WAVE_FORMAT_2M08 = 0x00000010
+WAVE_FORMAT_2S08 = 0x00000020
+WAVE_FORMAT_2M16 = 0x00000040
+WAVE_FORMAT_2S16 = 0x00000080
+WAVE_FORMAT_4M08 = 0x00000100
+WAVE_FORMAT_4S08 = 0x00000200
+WAVE_FORMAT_4M16 = 0x00000400
+WAVE_FORMAT_4S16 = 0x00000800
+WAVE_FORMAT_PCM = 1
+WAVE_FORMAT_IEEE_FLOAT = 3
+MIDIERR_UNPREPARED = MIDIERR_BASE + 0
+MIDIERR_STILLPLAYING = MIDIERR_BASE + 1
+MIDIERR_NOMAP = MIDIERR_BASE + 2
+MIDIERR_NOTREADY = MIDIERR_BASE + 3
+MIDIERR_NODEVICE = MIDIERR_BASE + 4
+MIDIERR_INVALIDSETUP = MIDIERR_BASE + 5
+MIDIERR_BADOPENMODE = MIDIERR_BASE + 6
+MIDIERR_DONT_CONTINUE = MIDIERR_BASE + 7
+MIDIERR_LASTERROR = MIDIERR_BASE + 7
+MIDIPATCHSIZE = 128
+MIM_OPEN = MM_MIM_OPEN
+MIM_CLOSE = MM_MIM_CLOSE
+MIM_DATA = MM_MIM_DATA
+MIM_LONGDATA = MM_MIM_LONGDATA
+MIM_ERROR = MM_MIM_ERROR
+MIM_LONGERROR = MM_MIM_LONGERROR
+MOM_OPEN = MM_MOM_OPEN
+MOM_CLOSE = MM_MOM_CLOSE
+MOM_DONE = MM_MOM_DONE
+MIM_MOREDATA = MM_MIM_MOREDATA
+MOM_POSITIONCB = MM_MOM_POSITIONCB
+MIDI_IO_STATUS = 0x00000020
+MIDI_CACHE_ALL = 1
+MIDI_CACHE_BESTFIT = 2
+MIDI_CACHE_QUERY = 3
+MIDI_UNCACHE = 4
+MOD_MIDIPORT = 1
+MOD_SYNTH = 2
+MOD_SQSYNTH = 3
+MOD_FMSYNTH = 4
+MOD_MAPPER = 5
+MIDICAPS_VOLUME = 0x0001
+MIDICAPS_LRVOLUME = 0x0002
+MIDICAPS_CACHE = 0x0004
+MIDICAPS_STREAM = 0x0008
+MHDR_DONE = 0x00000001
+MHDR_PREPARED = 0x00000002
+MHDR_INQUEUE = 0x00000004
+MHDR_ISSTRM = 0x00000008
+MEVT_F_SHORT = 0x00000000
+MEVT_F_LONG = -2147483648  # 0x80000000
+MEVT_F_CALLBACK = 0x40000000
+
+
+def MEVT_EVENTTYPE(x):
+    return (BYTE)(((x) >> 24) & 0xFF)
+
+
+def MEVT_EVENTPARM(x):
+    return (DWORD)((x) & 0x00FFFFFF)
+
+
+MIDISTRM_ERROR = -2
+MIDIPROP_SET = -2147483648  # 0x80000000
+MIDIPROP_GET = 0x40000000
+MIDIPROP_TIMEDIV = 0x00000001
+MIDIPROP_TEMPO = 0x00000002
+AUXCAPS_CDAUDIO = 1
+AUXCAPS_AUXIN = 2
+AUXCAPS_VOLUME = 0x0001
+AUXCAPS_LRVOLUME = 0x0002
+MIXER_SHORT_NAME_CHARS = 16
+MIXER_LONG_NAME_CHARS = 64
+MIXERR_INVALLINE = MIXERR_BASE + 0
+MIXERR_INVALCONTROL = MIXERR_BASE + 1
+MIXERR_INVALVALUE = MIXERR_BASE + 2
+MIXERR_LASTERROR = MIXERR_BASE + 2
+MIXER_OBJECTF_HANDLE = -2147483648  # 0x80000000
+MIXER_OBJECTF_MIXER = 0x00000000
+MIXER_OBJECTF_HMIXER = MIXER_OBJECTF_HANDLE | MIXER_OBJECTF_MIXER
+MIXER_OBJECTF_WAVEOUT = 0x10000000
+MIXER_OBJECTF_HWAVEOUT = MIXER_OBJECTF_HANDLE | MIXER_OBJECTF_WAVEOUT
+MIXER_OBJECTF_WAVEIN = 0x20000000
+MIXER_OBJECTF_HWAVEIN = MIXER_OBJECTF_HANDLE | MIXER_OBJECTF_WAVEIN
+MIXER_OBJECTF_MIDIOUT = 0x30000000
+MIXER_OBJECTF_HMIDIOUT = MIXER_OBJECTF_HANDLE | MIXER_OBJECTF_MIDIOUT
+MIXER_OBJECTF_MIDIIN = 0x40000000
+MIXER_OBJECTF_HMIDIIN = MIXER_OBJECTF_HANDLE | MIXER_OBJECTF_MIDIIN
+MIXER_OBJECTF_AUX = 0x50000000
+MIXERLINE_LINEF_ACTIVE = 0x00000001
+MIXERLINE_LINEF_DISCONNECTED = 0x00008000
+MIXERLINE_LINEF_SOURCE = -2147483648  # 0x80000000
+MIXERLINE_COMPONENTTYPE_DST_FIRST = 0x00000000
+MIXERLINE_COMPONENTTYPE_DST_UNDEFINED = MIXERLINE_COMPONENTTYPE_DST_FIRST + 0
+MIXERLINE_COMPONENTTYPE_DST_DIGITAL = MIXERLINE_COMPONENTTYPE_DST_FIRST + 1
+MIXERLINE_COMPONENTTYPE_DST_LINE = MIXERLINE_COMPONENTTYPE_DST_FIRST + 2
+MIXERLINE_COMPONENTTYPE_DST_MONITOR = MIXERLINE_COMPONENTTYPE_DST_FIRST + 3
+MIXERLINE_COMPONENTTYPE_DST_SPEAKERS = MIXERLINE_COMPONENTTYPE_DST_FIRST + 4
+MIXERLINE_COMPONENTTYPE_DST_HEADPHONES = MIXERLINE_COMPONENTTYPE_DST_FIRST + 5
+MIXERLINE_COMPONENTTYPE_DST_TELEPHONE = MIXERLINE_COMPONENTTYPE_DST_FIRST + 6
+MIXERLINE_COMPONENTTYPE_DST_WAVEIN = MIXERLINE_COMPONENTTYPE_DST_FIRST + 7
+MIXERLINE_COMPONENTTYPE_DST_VOICEIN = MIXERLINE_COMPONENTTYPE_DST_FIRST + 8
+MIXERLINE_COMPONENTTYPE_DST_LAST = MIXERLINE_COMPONENTTYPE_DST_FIRST + 8
+MIXERLINE_COMPONENTTYPE_SRC_FIRST = 0x00001000
+MIXERLINE_COMPONENTTYPE_SRC_UNDEFINED = MIXERLINE_COMPONENTTYPE_SRC_FIRST + 0
+MIXERLINE_COMPONENTTYPE_SRC_DIGITAL = MIXERLINE_COMPONENTTYPE_SRC_FIRST + 1
+MIXERLINE_COMPONENTTYPE_SRC_LINE = MIXERLINE_COMPONENTTYPE_SRC_FIRST + 2
+MIXERLINE_COMPONENTTYPE_SRC_MICROPHONE = MIXERLINE_COMPONENTTYPE_SRC_FIRST + 3
+MIXERLINE_COMPONENTTYPE_SRC_SYNTHESIZER = MIXERLINE_COMPONENTTYPE_SRC_FIRST + 4
+MIXERLINE_COMPONENTTYPE_SRC_COMPACTDISC = MIXERLINE_COMPONENTTYPE_SRC_FIRST + 5
+MIXERLINE_COMPONENTTYPE_SRC_TELEPHONE = MIXERLINE_COMPONENTTYPE_SRC_FIRST + 6
+MIXERLINE_COMPONENTTYPE_SRC_PCSPEAKER = MIXERLINE_COMPONENTTYPE_SRC_FIRST + 7
+MIXERLINE_COMPONENTTYPE_SRC_WAVEOUT = MIXERLINE_COMPONENTTYPE_SRC_FIRST + 8
+MIXERLINE_COMPONENTTYPE_SRC_AUXILIARY = MIXERLINE_COMPONENTTYPE_SRC_FIRST + 9
+MIXERLINE_COMPONENTTYPE_SRC_ANALOG = MIXERLINE_COMPONENTTYPE_SRC_FIRST + 10
+MIXERLINE_COMPONENTTYPE_SRC_LAST = MIXERLINE_COMPONENTTYPE_SRC_FIRST + 10
+MIXERLINE_TARGETTYPE_UNDEFINED = 0
+MIXERLINE_TARGETTYPE_WAVEOUT = 1
+MIXERLINE_TARGETTYPE_WAVEIN = 2
+MIXERLINE_TARGETTYPE_MIDIOUT = 3
+MIXERLINE_TARGETTYPE_MIDIIN = 4
+MIXERLINE_TARGETTYPE_AUX = 5
+MIXER_GETLINEINFOF_DESTINATION = 0x00000000
+MIXER_GETLINEINFOF_SOURCE = 0x00000001
+MIXER_GETLINEINFOF_LINEID = 0x00000002
+MIXER_GETLINEINFOF_COMPONENTTYPE = 0x00000003
+MIXER_GETLINEINFOF_TARGETTYPE = 0x00000004
+MIXER_GETLINEINFOF_QUERYMASK = 0x0000000F
+MIXERCONTROL_CONTROLF_UNIFORM = 0x00000001
+MIXERCONTROL_CONTROLF_MULTIPLE = 0x00000002
+MIXERCONTROL_CONTROLF_DISABLED = -2147483648  # 0x80000000
+MIXERCONTROL_CT_CLASS_MASK = -268435456  # 0xF0000000
+MIXERCONTROL_CT_CLASS_CUSTOM = 0x00000000
+MIXERCONTROL_CT_CLASS_METER = 0x10000000
+MIXERCONTROL_CT_CLASS_SWITCH = 0x20000000
+MIXERCONTROL_CT_CLASS_NUMBER = 0x30000000
+MIXERCONTROL_CT_CLASS_SLIDER = 0x40000000
+MIXERCONTROL_CT_CLASS_FADER = 0x50000000
+MIXERCONTROL_CT_CLASS_TIME = 0x60000000
+MIXERCONTROL_CT_CLASS_LIST = 0x70000000
+MIXERCONTROL_CT_SUBCLASS_MASK = 0x0F000000
+MIXERCONTROL_CT_SC_SWITCH_BOOLEAN = 0x00000000
+MIXERCONTROL_CT_SC_SWITCH_BUTTON = 0x01000000
+MIXERCONTROL_CT_SC_METER_POLLED = 0x00000000
+MIXERCONTROL_CT_SC_TIME_MICROSECS = 0x00000000
+MIXERCONTROL_CT_SC_TIME_MILLISECS = 0x01000000
+MIXERCONTROL_CT_SC_LIST_SINGLE = 0x00000000
+MIXERCONTROL_CT_SC_LIST_MULTIPLE = 0x01000000
+MIXERCONTROL_CT_UNITS_MASK = 0x00FF0000
+MIXERCONTROL_CT_UNITS_CUSTOM = 0x00000000
+MIXERCONTROL_CT_UNITS_BOOLEAN = 0x00010000
+MIXERCONTROL_CT_UNITS_SIGNED = 0x00020000
+MIXERCONTROL_CT_UNITS_UNSIGNED = 0x00030000
+MIXERCONTROL_CT_UNITS_DECIBELS = 0x00040000
+MIXERCONTROL_CT_UNITS_PERCENT = 0x00050000
+MIXERCONTROL_CONTROLTYPE_CUSTOM = (
+    MIXERCONTROL_CT_CLASS_CUSTOM | MIXERCONTROL_CT_UNITS_CUSTOM
+)
+MIXERCONTROL_CONTROLTYPE_BOOLEANMETER = (
+    MIXERCONTROL_CT_CLASS_METER
+    | MIXERCONTROL_CT_SC_METER_POLLED
+    | MIXERCONTROL_CT_UNITS_BOOLEAN
+)
+MIXERCONTROL_CONTROLTYPE_SIGNEDMETER = (
+    MIXERCONTROL_CT_CLASS_METER
+    | MIXERCONTROL_CT_SC_METER_POLLED
+    | MIXERCONTROL_CT_UNITS_SIGNED
+)
+MIXERCONTROL_CONTROLTYPE_PEAKMETER = MIXERCONTROL_CONTROLTYPE_SIGNEDMETER + 1
+MIXERCONTROL_CONTROLTYPE_UNSIGNEDMETER = (
+    MIXERCONTROL_CT_CLASS_METER
+    | MIXERCONTROL_CT_SC_METER_POLLED
+    | MIXERCONTROL_CT_UNITS_UNSIGNED
+)
+MIXERCONTROL_CONTROLTYPE_BOOLEAN = (
+    MIXERCONTROL_CT_CLASS_SWITCH
+    | MIXERCONTROL_CT_SC_SWITCH_BOOLEAN
+    | MIXERCONTROL_CT_UNITS_BOOLEAN
+)
+MIXERCONTROL_CONTROLTYPE_ONOFF = MIXERCONTROL_CONTROLTYPE_BOOLEAN + 1
+MIXERCONTROL_CONTROLTYPE_MUTE = MIXERCONTROL_CONTROLTYPE_BOOLEAN + 2
+MIXERCONTROL_CONTROLTYPE_MONO = MIXERCONTROL_CONTROLTYPE_BOOLEAN + 3
+MIXERCONTROL_CONTROLTYPE_LOUDNESS = MIXERCONTROL_CONTROLTYPE_BOOLEAN + 4
+MIXERCONTROL_CONTROLTYPE_STEREOENH = MIXERCONTROL_CONTROLTYPE_BOOLEAN + 5
+MIXERCONTROL_CONTROLTYPE_BUTTON = (
+    MIXERCONTROL_CT_CLASS_SWITCH
+    | MIXERCONTROL_CT_SC_SWITCH_BUTTON
+    | MIXERCONTROL_CT_UNITS_BOOLEAN
+)
+MIXERCONTROL_CONTROLTYPE_DECIBELS = (
+    MIXERCONTROL_CT_CLASS_NUMBER | MIXERCONTROL_CT_UNITS_DECIBELS
+)
+MIXERCONTROL_CONTROLTYPE_SIGNED = (
+    MIXERCONTROL_CT_CLASS_NUMBER | MIXERCONTROL_CT_UNITS_SIGNED
+)
+MIXERCONTROL_CONTROLTYPE_UNSIGNED = (
+    MIXERCONTROL_CT_CLASS_NUMBER | MIXERCONTROL_CT_UNITS_UNSIGNED
+)
+MIXERCONTROL_CONTROLTYPE_PERCENT = (
+    MIXERCONTROL_CT_CLASS_NUMBER | MIXERCONTROL_CT_UNITS_PERCENT
+)
+MIXERCONTROL_CONTROLTYPE_SLIDER = (
+    MIXERCONTROL_CT_CLASS_SLIDER | MIXERCONTROL_CT_UNITS_SIGNED
+)
+MIXERCONTROL_CONTROLTYPE_PAN = MIXERCONTROL_CONTROLTYPE_SLIDER + 1
+MIXERCONTROL_CONTROLTYPE_QSOUNDPAN = MIXERCONTROL_CONTROLTYPE_SLIDER + 2
+MIXERCONTROL_CONTROLTYPE_FADER = (
+    MIXERCONTROL_CT_CLASS_FADER | MIXERCONTROL_CT_UNITS_UNSIGNED
+)
+MIXERCONTROL_CONTROLTYPE_VOLUME = MIXERCONTROL_CONTROLTYPE_FADER + 1
+MIXERCONTROL_CONTROLTYPE_BASS = MIXERCONTROL_CONTROLTYPE_FADER + 2
+MIXERCONTROL_CONTROLTYPE_TREBLE = MIXERCONTROL_CONTROLTYPE_FADER + 3
+MIXERCONTROL_CONTROLTYPE_EQUALIZER = MIXERCONTROL_CONTROLTYPE_FADER + 4
+MIXERCONTROL_CONTROLTYPE_SINGLESELECT = (
+    MIXERCONTROL_CT_CLASS_LIST
+    | MIXERCONTROL_CT_SC_LIST_SINGLE
+    | MIXERCONTROL_CT_UNITS_BOOLEAN
+)
+MIXERCONTROL_CONTROLTYPE_MUX = MIXERCONTROL_CONTROLTYPE_SINGLESELECT + 1
+MIXERCONTROL_CONTROLTYPE_MULTIPLESELECT = (
+    MIXERCONTROL_CT_CLASS_LIST
+    | MIXERCONTROL_CT_SC_LIST_MULTIPLE
+    | MIXERCONTROL_CT_UNITS_BOOLEAN
+)
+MIXERCONTROL_CONTROLTYPE_MIXER = MIXERCONTROL_CONTROLTYPE_MULTIPLESELECT + 1
+MIXERCONTROL_CONTROLTYPE_MICROTIME = (
+    MIXERCONTROL_CT_CLASS_TIME
+    | MIXERCONTROL_CT_SC_TIME_MICROSECS
+    | MIXERCONTROL_CT_UNITS_UNSIGNED
+)
+MIXERCONTROL_CONTROLTYPE_MILLITIME = (
+    MIXERCONTROL_CT_CLASS_TIME
+    | MIXERCONTROL_CT_SC_TIME_MILLISECS
+    | MIXERCONTROL_CT_UNITS_UNSIGNED
+)
+MIXER_GETLINECONTROLSF_ALL = 0x00000000
+MIXER_GETLINECONTROLSF_ONEBYID = 0x00000001
+MIXER_GETLINECONTROLSF_ONEBYTYPE = 0x00000002
+MIXER_GETLINECONTROLSF_QUERYMASK = 0x0000000F
+MIXER_GETCONTROLDETAILSF_VALUE = 0x00000000
+MIXER_GETCONTROLDETAILSF_LISTTEXT = 0x00000001
+MIXER_GETCONTROLDETAILSF_QUERYMASK = 0x0000000F
+MIXER_SETCONTROLDETAILSF_VALUE = 0x00000000
+MIXER_SETCONTROLDETAILSF_CUSTOM = 0x00000001
+MIXER_SETCONTROLDETAILSF_QUERYMASK = 0x0000000F
+TIMERR_NOERROR = 0
+TIMERR_NOCANDO = TIMERR_BASE + 1
+TIMERR_STRUCT = TIMERR_BASE + 33
+TIME_ONESHOT = 0x0000
+TIME_PERIODIC = 0x0001
+TIME_CALLBACK_FUNCTION = 0x0000
+TIME_CALLBACK_EVENT_SET = 0x0010
+TIME_CALLBACK_EVENT_PULSE = 0x0020
+JOYERR_NOERROR = 0
+JOYERR_PARMS = JOYERR_BASE + 5
+JOYERR_NOCANDO = JOYERR_BASE + 6
+JOYERR_UNPLUGGED = JOYERR_BASE + 7
+JOY_BUTTON1 = 0x0001
+JOY_BUTTON2 = 0x0002
+JOY_BUTTON3 = 0x0004
+JOY_BUTTON4 = 0x0008
+JOY_BUTTON1CHG = 0x0100
+JOY_BUTTON2CHG = 0x0200
+JOY_BUTTON3CHG = 0x0400
+JOY_BUTTON4CHG = 0x0800
+JOY_BUTTON5 = 0x00000010
+JOY_BUTTON6 = 0x00000020
+JOY_BUTTON7 = 0x00000040
+JOY_BUTTON8 = 0x00000080
+JOY_BUTTON9 = 0x00000100
+JOY_BUTTON10 = 0x00000200
+JOY_BUTTON11 = 0x00000400
+JOY_BUTTON12 = 0x00000800
+JOY_BUTTON13 = 0x00001000
+JOY_BUTTON14 = 0x00002000
+JOY_BUTTON15 = 0x00004000
+JOY_BUTTON16 = 0x00008000
+JOY_BUTTON17 = 0x00010000
+JOY_BUTTON18 = 0x00020000
+JOY_BUTTON19 = 0x00040000
+JOY_BUTTON20 = 0x00080000
+JOY_BUTTON21 = 0x00100000
+JOY_BUTTON22 = 0x00200000
+JOY_BUTTON23 = 0x00400000
+JOY_BUTTON24 = 0x00800000
+JOY_BUTTON25 = 0x01000000
+JOY_BUTTON26 = 0x02000000
+JOY_BUTTON27 = 0x04000000
+JOY_BUTTON28 = 0x08000000
+JOY_BUTTON29 = 0x10000000
+JOY_BUTTON30 = 0x20000000
+JOY_BUTTON31 = 0x40000000
+JOY_BUTTON32 = -2147483648  # 0x80000000
+JOY_POVFORWARD = 0
+JOY_POVRIGHT = 9000
+JOY_POVBACKWARD = 18000
+JOY_POVLEFT = 27000
+JOY_RETURNX = 0x00000001
+JOY_RETURNY = 0x00000002
+JOY_RETURNZ = 0x00000004
+JOY_RETURNR = 0x00000008
+JOY_RETURNU = 0x00000010
+JOY_RETURNV = 0x00000020
+JOY_RETURNPOV = 0x00000040
+JOY_RETURNBUTTONS = 0x00000080
+JOY_RETURNRAWDATA = 0x00000100
+JOY_RETURNPOVCTS = 0x00000200
+JOY_RETURNCENTERED = 0x00000400
+JOY_USEDEADZONE = 0x00000800
+JOY_RETURNALL = (
+    JOY_RETURNX
+    | JOY_RETURNY
+    | JOY_RETURNZ
+    | JOY_RETURNR
+    | JOY_RETURNU
+    | JOY_RETURNV
+    | JOY_RETURNPOV
+    | JOY_RETURNBUTTONS
+)
+JOY_CAL_READALWAYS = 0x00010000
+JOY_CAL_READXYONLY = 0x00020000
+JOY_CAL_READ3 = 0x00040000
+JOY_CAL_READ4 = 0x00080000
+JOY_CAL_READXONLY = 0x00100000
+JOY_CAL_READYONLY = 0x00200000
+JOY_CAL_READ5 = 0x00400000
+JOY_CAL_READ6 = 0x00800000
+JOY_CAL_READZONLY = 0x01000000
+JOY_CAL_READRONLY = 0x02000000
+JOY_CAL_READUONLY = 0x04000000
+JOY_CAL_READVONLY = 0x08000000
+JOYSTICKID1 = 0
+JOYSTICKID2 = 1
+JOYCAPS_HASZ = 0x0001
+JOYCAPS_HASR = 0x0002
+JOYCAPS_HASU = 0x0004
+JOYCAPS_HASV = 0x0008
+JOYCAPS_HASPOV = 0x0010
+JOYCAPS_POV4DIR = 0x0020
+JOYCAPS_POVCTS = 0x0040
+MMIOERR_BASE = 256
+MMIOERR_FILENOTFOUND = MMIOERR_BASE + 1
+MMIOERR_OUTOFMEMORY = MMIOERR_BASE + 2
+MMIOERR_CANNOTOPEN = MMIOERR_BASE + 3
+MMIOERR_CANNOTCLOSE = MMIOERR_BASE + 4
+MMIOERR_CANNOTREAD = MMIOERR_BASE + 5
+MMIOERR_CANNOTWRITE = MMIOERR_BASE + 6
+MMIOERR_CANNOTSEEK = MMIOERR_BASE + 7
+MMIOERR_CANNOTEXPAND = MMIOERR_BASE + 8
+MMIOERR_CHUNKNOTFOUND = MMIOERR_BASE + 9
+MMIOERR_UNBUFFERED = MMIOERR_BASE + 10
+MMIOERR_PATHNOTFOUND = MMIOERR_BASE + 11
+MMIOERR_ACCESSDENIED = MMIOERR_BASE + 12
+MMIOERR_SHARINGVIOLATION = MMIOERR_BASE + 13
+MMIOERR_NETWORKERROR = MMIOERR_BASE + 14
+MMIOERR_TOOMANYOPENFILES = MMIOERR_BASE + 15
+MMIOERR_INVALIDFILE = MMIOERR_BASE + 16
+CFSEPCHAR = ord("+")
+MMIO_RWMODE = 0x00000003
+MMIO_SHAREMODE = 0x00000070
+MMIO_CREATE = 0x00001000
+MMIO_PARSE = 0x00000100
+MMIO_DELETE = 0x00000200
+MMIO_EXIST = 0x00004000
+MMIO_ALLOCBUF = 0x00010000
+MMIO_GETTEMP = 0x00020000
+MMIO_DIRTY = 0x10000000
+MMIO_READ = 0x00000000
+MMIO_WRITE = 0x00000001
+MMIO_READWRITE = 0x00000002
+MMIO_COMPAT = 0x00000000
+MMIO_EXCLUSIVE = 0x00000010
+MMIO_DENYWRITE = 0x00000020
+MMIO_DENYREAD = 0x00000030
+MMIO_DENYNONE = 0x00000040
+MMIO_FHOPEN = 0x0010
+MMIO_EMPTYBUF = 0x0010
+MMIO_TOUPPER = 0x0010
+MMIO_INSTALLPROC = 0x00010000
+MMIO_GLOBALPROC = 0x10000000
+MMIO_REMOVEPROC = 0x00020000
+MMIO_UNICODEPROC = 0x01000000
+MMIO_FINDPROC = 0x00040000
+MMIO_FINDCHUNK = 0x0010
+MMIO_FINDRIFF = 0x0020
+MMIO_FINDLIST = 0x0040
+MMIO_CREATERIFF = 0x0020
+MMIO_CREATELIST = 0x0040
+MMIOM_READ = MMIO_READ
+MMIOM_WRITE = MMIO_WRITE
+MMIOM_SEEK = 2
+MMIOM_OPEN = 3
+MMIOM_CLOSE = 4
+MMIOM_WRITEFLUSH = 5
+MMIOM_RENAME = 6
+MMIOM_USER = 0x8000
+SEEK_SET = 0
+SEEK_CUR = 1
+SEEK_END = 2
+MMIO_DEFAULTBUFFER = 8192
+MCIERR_INVALID_DEVICE_ID = MCIERR_BASE + 1
+MCIERR_UNRECOGNIZED_KEYWORD = MCIERR_BASE + 3
+MCIERR_UNRECOGNIZED_COMMAND = MCIERR_BASE + 5
+MCIERR_HARDWARE = MCIERR_BASE + 6
+MCIERR_INVALID_DEVICE_NAME = MCIERR_BASE + 7
+MCIERR_OUT_OF_MEMORY = MCIERR_BASE + 8
+MCIERR_DEVICE_OPEN = MCIERR_BASE + 9
+MCIERR_CANNOT_LOAD_DRIVER = MCIERR_BASE + 10
+MCIERR_MISSING_COMMAND_STRING = MCIERR_BASE + 11
+MCIERR_PARAM_OVERFLOW = MCIERR_BASE + 12
+MCIERR_MISSING_STRING_ARGUMENT = MCIERR_BASE + 13
+MCIERR_BAD_INTEGER = MCIERR_BASE + 14
+MCIERR_PARSER_INTERNAL = MCIERR_BASE + 15
+MCIERR_DRIVER_INTERNAL = MCIERR_BASE + 16
+MCIERR_MISSING_PARAMETER = MCIERR_BASE + 17
+MCIERR_UNSUPPORTED_FUNCTION = MCIERR_BASE + 18
+MCIERR_FILE_NOT_FOUND = MCIERR_BASE + 19
+MCIERR_DEVICE_NOT_READY = MCIERR_BASE + 20
+MCIERR_INTERNAL = MCIERR_BASE + 21
+MCIERR_DRIVER = MCIERR_BASE + 22
+MCIERR_CANNOT_USE_ALL = MCIERR_BASE + 23
+MCIERR_MULTIPLE = MCIERR_BASE + 24
+MCIERR_EXTENSION_NOT_FOUND = MCIERR_BASE + 25
+MCIERR_OUTOFRANGE = MCIERR_BASE + 26
+MCIERR_FLAGS_NOT_COMPATIBLE = MCIERR_BASE + 28
+MCIERR_FILE_NOT_SAVED = MCIERR_BASE + 30
+MCIERR_DEVICE_TYPE_REQUIRED = MCIERR_BASE + 31
+MCIERR_DEVICE_LOCKED = MCIERR_BASE + 32
+MCIERR_DUPLICATE_ALIAS = MCIERR_BASE + 33
+MCIERR_BAD_CONSTANT = MCIERR_BASE + 34
+MCIERR_MUST_USE_SHAREABLE = MCIERR_BASE + 35
+MCIERR_MISSING_DEVICE_NAME = MCIERR_BASE + 36
+MCIERR_BAD_TIME_FORMAT = MCIERR_BASE + 37
+MCIERR_NO_CLOSING_QUOTE = MCIERR_BASE + 38
+MCIERR_DUPLICATE_FLAGS = MCIERR_BASE + 39
+MCIERR_INVALID_FILE = MCIERR_BASE + 40
+MCIERR_NULL_PARAMETER_BLOCK = MCIERR_BASE + 41
+MCIERR_UNNAMED_RESOURCE = MCIERR_BASE + 42
+MCIERR_NEW_REQUIRES_ALIAS = MCIERR_BASE + 43
+MCIERR_NOTIFY_ON_AUTO_OPEN = MCIERR_BASE + 44
+MCIERR_NO_ELEMENT_ALLOWED = MCIERR_BASE + 45
+MCIERR_NONAPPLICABLE_FUNCTION = MCIERR_BASE + 46
+MCIERR_ILLEGAL_FOR_AUTO_OPEN = MCIERR_BASE + 47
+MCIERR_FILENAME_REQUIRED = MCIERR_BASE + 48
+MCIERR_EXTRA_CHARACTERS = MCIERR_BASE + 49
+MCIERR_DEVICE_NOT_INSTALLED = MCIERR_BASE + 50
+MCIERR_GET_CD = MCIERR_BASE + 51
+MCIERR_SET_CD = MCIERR_BASE + 52
+MCIERR_SET_DRIVE = MCIERR_BASE + 53
+MCIERR_DEVICE_LENGTH = MCIERR_BASE + 54
+MCIERR_DEVICE_ORD_LENGTH = MCIERR_BASE + 55
+MCIERR_NO_INTEGER = MCIERR_BASE + 56
+MCIERR_WAVE_OUTPUTSINUSE = MCIERR_BASE + 64
+MCIERR_WAVE_SETOUTPUTINUSE = MCIERR_BASE + 65
+MCIERR_WAVE_INPUTSINUSE = MCIERR_BASE + 66
+MCIERR_WAVE_SETINPUTINUSE = MCIERR_BASE + 67
+MCIERR_WAVE_OUTPUTUNSPECIFIED = MCIERR_BASE + 68
+MCIERR_WAVE_INPUTUNSPECIFIED = MCIERR_BASE + 69
+MCIERR_WAVE_OUTPUTSUNSUITABLE = MCIERR_BASE + 70
+MCIERR_WAVE_SETOUTPUTUNSUITABLE = MCIERR_BASE + 71
+MCIERR_WAVE_INPUTSUNSUITABLE = MCIERR_BASE + 72
+MCIERR_WAVE_SETINPUTUNSUITABLE = MCIERR_BASE + 73
+MCIERR_SEQ_DIV_INCOMPATIBLE = MCIERR_BASE + 80
+MCIERR_SEQ_PORT_INUSE = MCIERR_BASE + 81
+MCIERR_SEQ_PORT_NONEXISTENT = MCIERR_BASE + 82
+MCIERR_SEQ_PORT_MAPNODEVICE = MCIERR_BASE + 83
+MCIERR_SEQ_PORT_MISCERROR = MCIERR_BASE + 84
+MCIERR_SEQ_TIMER = MCIERR_BASE + 85
+MCIERR_SEQ_PORTUNSPECIFIED = MCIERR_BASE + 86
+MCIERR_SEQ_NOMIDIPRESENT = MCIERR_BASE + 87
+MCIERR_NO_WINDOW = MCIERR_BASE + 90
+MCIERR_CREATEWINDOW = MCIERR_BASE + 91
+MCIERR_FILE_READ = MCIERR_BASE + 92
+MCIERR_FILE_WRITE = MCIERR_BASE + 93
+MCIERR_NO_IDENTITY = MCIERR_BASE + 94
+MCIERR_CUSTOM_DRIVER_BASE = MCIERR_BASE + 256
+MCI_FIRST = DRV_MCI_FIRST
+MCI_OPEN = 0x0803
+MCI_CLOSE = 0x0804
+MCI_ESCAPE = 0x0805
+MCI_PLAY = 0x0806
+MCI_SEEK = 0x0807
+MCI_STOP = 0x0808
+MCI_PAUSE = 0x0809
+MCI_INFO = 0x080A
+MCI_GETDEVCAPS = 0x080B
+MCI_SPIN = 0x080C
+MCI_SET = 0x080D
+MCI_STEP = 0x080E
+MCI_RECORD = 0x080F
+MCI_SYSINFO = 0x0810
+MCI_BREAK = 0x0811
+MCI_SAVE = 0x0813
+MCI_STATUS = 0x0814
+MCI_CUE = 0x0830
+MCI_REALIZE = 0x0840
+MCI_WINDOW = 0x0841
+MCI_PUT = 0x0842
+MCI_WHERE = 0x0843
+MCI_FREEZE = 0x0844
+MCI_UNFREEZE = 0x0845
+MCI_LOAD = 0x0850
+MCI_CUT = 0x0851
+MCI_COPY = 0x0852
+MCI_PASTE = 0x0853
+MCI_UPDATE = 0x0854
+MCI_RESUME = 0x0855
+MCI_DELETE = 0x0856
+MCI_USER_MESSAGES = DRV_MCI_FIRST + 0x400
+MCI_LAST = 0x0FFF
+MCI_DEVTYPE_VCR = 513
+MCI_DEVTYPE_VIDEODISC = 514
+MCI_DEVTYPE_OVERLAY = 515
+MCI_DEVTYPE_CD_AUDIO = 516
+MCI_DEVTYPE_DAT = 517
+MCI_DEVTYPE_SCANNER = 518
+MCI_DEVTYPE_ANIMATION = 519
+MCI_DEVTYPE_DIGITAL_VIDEO = 520
+MCI_DEVTYPE_OTHER = 521
+MCI_DEVTYPE_WAVEFORM_AUDIO = 522
+MCI_DEVTYPE_SEQUENCER = 523
+MCI_DEVTYPE_FIRST = MCI_DEVTYPE_VCR
+MCI_DEVTYPE_LAST = MCI_DEVTYPE_SEQUENCER
+MCI_DEVTYPE_FIRST_USER = 0x1000
+MCI_MODE_NOT_READY = MCI_STRING_OFFSET + 12
+MCI_MODE_STOP = MCI_STRING_OFFSET + 13
+MCI_MODE_PLAY = MCI_STRING_OFFSET + 14
+MCI_MODE_RECORD = MCI_STRING_OFFSET + 15
+MCI_MODE_SEEK = MCI_STRING_OFFSET + 16
+MCI_MODE_PAUSE = MCI_STRING_OFFSET + 17
+MCI_MODE_OPEN = MCI_STRING_OFFSET + 18
+MCI_FORMAT_MILLISECONDS = 0
+MCI_FORMAT_HMS = 1
+MCI_FORMAT_MSF = 2
+MCI_FORMAT_FRAMES = 3
+MCI_FORMAT_SMPTE_24 = 4
+MCI_FORMAT_SMPTE_25 = 5
+MCI_FORMAT_SMPTE_30 = 6
+MCI_FORMAT_SMPTE_30DROP = 7
+MCI_FORMAT_BYTES = 8
+MCI_FORMAT_SAMPLES = 9
+MCI_FORMAT_TMSF = 10
+
+
+def MCI_MSF_MINUTE(msf):
+    return (BYTE)(msf)
+
+
+def MCI_MSF_SECOND(msf):
+    return (BYTE)(((WORD)(msf)) >> 8)
+
+
+def MCI_MSF_FRAME(msf):
+    return (BYTE)((msf) >> 16)
+
+
+def MCI_TMSF_TRACK(tmsf):
+    return (BYTE)(tmsf)
+
+
+def MCI_TMSF_MINUTE(tmsf):
+    return (BYTE)(((WORD)(tmsf)) >> 8)
+
+
+def MCI_TMSF_SECOND(tmsf):
+    return (BYTE)((tmsf) >> 16)
+
+
+def MCI_TMSF_FRAME(tmsf):
+    return (BYTE)((tmsf) >> 24)
+
+
+def MCI_HMS_HOUR(hms):
+    return (BYTE)(hms)
+
+
+def MCI_HMS_MINUTE(hms):
+    return (BYTE)(((WORD)(hms)) >> 8)
+
+
+def MCI_HMS_SECOND(hms):
+    return (BYTE)((hms) >> 16)
+
+
+MCI_NOTIFY_SUCCESSFUL = 0x0001
+MCI_NOTIFY_SUPERSEDED = 0x0002
+MCI_NOTIFY_ABORTED = 0x0004
+MCI_NOTIFY_FAILURE = 0x0008
+MCI_NOTIFY = 0x00000001
+MCI_WAIT = 0x00000002
+MCI_FROM = 0x00000004
+MCI_TO = 0x00000008
+MCI_TRACK = 0x00000010
+MCI_OPEN_SHAREABLE = 0x00000100
+MCI_OPEN_ELEMENT = 0x00000200
+MCI_OPEN_ALIAS = 0x00000400
+MCI_OPEN_ELEMENT_ID = 0x00000800
+MCI_OPEN_TYPE_ID = 0x00001000
+MCI_OPEN_TYPE = 0x00002000
+MCI_SEEK_TO_START = 0x00000100
+MCI_SEEK_TO_END = 0x00000200
+MCI_STATUS_ITEM = 0x00000100
+MCI_STATUS_START = 0x00000200
+MCI_STATUS_LENGTH = 0x00000001
+MCI_STATUS_POSITION = 0x00000002
+MCI_STATUS_NUMBER_OF_TRACKS = 0x00000003
+MCI_STATUS_MODE = 0x00000004
+MCI_STATUS_MEDIA_PRESENT = 0x00000005
+MCI_STATUS_TIME_FORMAT = 0x00000006
+MCI_STATUS_READY = 0x00000007
+MCI_STATUS_CURRENT_TRACK = 0x00000008
+MCI_INFO_PRODUCT = 0x00000100
+MCI_INFO_FILE = 0x00000200
+MCI_INFO_MEDIA_UPC = 0x00000400
+MCI_INFO_MEDIA_IDENTITY = 0x00000800
+MCI_INFO_NAME = 0x00001000
+MCI_INFO_COPYRIGHT = 0x00002000
+MCI_GETDEVCAPS_ITEM = 0x00000100
+MCI_GETDEVCAPS_CAN_RECORD = 0x00000001
+MCI_GETDEVCAPS_HAS_AUDIO = 0x00000002
+MCI_GETDEVCAPS_HAS_VIDEO = 0x00000003
+MCI_GETDEVCAPS_DEVICE_TYPE = 0x00000004
+MCI_GETDEVCAPS_USES_FILES = 0x00000005
+MCI_GETDEVCAPS_COMPOUND_DEVICE = 0x00000006
+MCI_GETDEVCAPS_CAN_EJECT = 0x00000007
+MCI_GETDEVCAPS_CAN_PLAY = 0x00000008
+MCI_GETDEVCAPS_CAN_SAVE = 0x00000009
+MCI_SYSINFO_QUANTITY = 0x00000100
+MCI_SYSINFO_OPEN = 0x00000200
+MCI_SYSINFO_NAME = 0x00000400
+MCI_SYSINFO_INSTALLNAME = 0x00000800
+MCI_SET_DOOR_OPEN = 0x00000100
+MCI_SET_DOOR_CLOSED = 0x00000200
+MCI_SET_TIME_FORMAT = 0x00000400
+MCI_SET_AUDIO = 0x00000800
+MCI_SET_VIDEO = 0x00001000
+MCI_SET_ON = 0x00002000
+MCI_SET_OFF = 0x00004000
+MCI_SET_AUDIO_ALL = 0x00000000
+MCI_SET_AUDIO_LEFT = 0x00000001
+MCI_SET_AUDIO_RIGHT = 0x00000002
+MCI_BREAK_KEY = 0x00000100
+MCI_BREAK_HWND = 0x00000200
+MCI_BREAK_OFF = 0x00000400
+MCI_RECORD_INSERT = 0x00000100
+MCI_RECORD_OVERWRITE = 0x00000200
+MCI_SAVE_FILE = 0x00000100
+MCI_LOAD_FILE = 0x00000100
+MCI_VD_MODE_PARK = MCI_VD_OFFSET + 1
+MCI_VD_MEDIA_CLV = MCI_VD_OFFSET + 2
+MCI_VD_MEDIA_CAV = MCI_VD_OFFSET + 3
+MCI_VD_MEDIA_OTHER = MCI_VD_OFFSET + 4
+MCI_VD_FORMAT_TRACK = 0x4001
+MCI_VD_PLAY_REVERSE = 0x00010000
+MCI_VD_PLAY_FAST = 0x00020000
+MCI_VD_PLAY_SPEED = 0x00040000
+MCI_VD_PLAY_SCAN = 0x00080000
+MCI_VD_PLAY_SLOW = 0x00100000
+MCI_VD_SEEK_REVERSE = 0x00010000
+MCI_VD_STATUS_SPEED = 0x00004002
+MCI_VD_STATUS_FORWARD = 0x00004003
+MCI_VD_STATUS_MEDIA_TYPE = 0x00004004
+MCI_VD_STATUS_SIDE = 0x00004005
+MCI_VD_STATUS_DISC_SIZE = 0x00004006
+MCI_VD_GETDEVCAPS_CLV = 0x00010000
+MCI_VD_GETDEVCAPS_CAV = 0x00020000
+MCI_VD_SPIN_UP = 0x00010000
+MCI_VD_SPIN_DOWN = 0x00020000
+MCI_VD_GETDEVCAPS_CAN_REVERSE = 0x00004002
+MCI_VD_GETDEVCAPS_FAST_RATE = 0x00004003
+MCI_VD_GETDEVCAPS_SLOW_RATE = 0x00004004
+MCI_VD_GETDEVCAPS_NORMAL_RATE = 0x00004005
+MCI_VD_STEP_FRAMES = 0x00010000
+MCI_VD_STEP_REVERSE = 0x00020000
+MCI_VD_ESCAPE_STRING = 0x00000100
+MCI_CDA_STATUS_TYPE_TRACK = 0x00004001
+MCI_CDA_TRACK_AUDIO = MCI_CD_OFFSET + 0
+MCI_CDA_TRACK_OTHER = MCI_CD_OFFSET + 1
+MCI_WAVE_PCM = MCI_WAVE_OFFSET + 0
+MCI_WAVE_MAPPER = MCI_WAVE_OFFSET + 1
+MCI_WAVE_OPEN_BUFFER = 0x00010000
+MCI_WAVE_SET_FORMATTAG = 0x00010000
+MCI_WAVE_SET_CHANNELS = 0x00020000
+MCI_WAVE_SET_SAMPLESPERSEC = 0x00040000
+MCI_WAVE_SET_AVGBYTESPERSEC = 0x00080000
+MCI_WAVE_SET_BLOCKALIGN = 0x00100000
+MCI_WAVE_SET_BITSPERSAMPLE = 0x00200000
+MCI_WAVE_INPUT = 0x00400000
+MCI_WAVE_OUTPUT = 0x00800000
+MCI_WAVE_STATUS_FORMATTAG = 0x00004001
+MCI_WAVE_STATUS_CHANNELS = 0x00004002
+MCI_WAVE_STATUS_SAMPLESPERSEC = 0x00004003
+MCI_WAVE_STATUS_AVGBYTESPERSEC = 0x00004004
+MCI_WAVE_STATUS_BLOCKALIGN = 0x00004005
+MCI_WAVE_STATUS_BITSPERSAMPLE = 0x00004006
+MCI_WAVE_STATUS_LEVEL = 0x00004007
+MCI_WAVE_SET_ANYINPUT = 0x04000000
+MCI_WAVE_SET_ANYOUTPUT = 0x08000000
+MCI_WAVE_GETDEVCAPS_INPUTS = 0x00004001
+MCI_WAVE_GETDEVCAPS_OUTPUTS = 0x00004002
+MCI_SEQ_DIV_PPQN = 0 + MCI_SEQ_OFFSET
+MCI_SEQ_DIV_SMPTE_24 = 1 + MCI_SEQ_OFFSET
+MCI_SEQ_DIV_SMPTE_25 = 2 + MCI_SEQ_OFFSET
+MCI_SEQ_DIV_SMPTE_30DROP = 3 + MCI_SEQ_OFFSET
+MCI_SEQ_DIV_SMPTE_30 = 4 + MCI_SEQ_OFFSET
+MCI_SEQ_FORMAT_SONGPTR = 0x4001
+MCI_SEQ_FILE = 0x4002
+MCI_SEQ_MIDI = 0x4003
+MCI_SEQ_SMPTE = 0x4004
+MCI_SEQ_NONE = 65533
+MCI_SEQ_MAPPER = 65535
+MCI_SEQ_STATUS_TEMPO = 0x00004002
+MCI_SEQ_STATUS_PORT = 0x00004003
+MCI_SEQ_STATUS_SLAVE = 0x00004007
+MCI_SEQ_STATUS_MASTER = 0x00004008
+MCI_SEQ_STATUS_OFFSET = 0x00004009
+MCI_SEQ_STATUS_DIVTYPE = 0x0000400A
+MCI_SEQ_STATUS_NAME = 0x0000400B
+MCI_SEQ_STATUS_COPYRIGHT = 0x0000400C
+MCI_SEQ_SET_TEMPO = 0x00010000
+MCI_SEQ_SET_PORT = 0x00020000
+MCI_SEQ_SET_SLAVE = 0x00040000
+MCI_SEQ_SET_MASTER = 0x00080000
+MCI_SEQ_SET_OFFSET = 0x01000000
+MCI_ANIM_OPEN_WS = 0x00010000
+MCI_ANIM_OPEN_PARENT = 0x00020000
+MCI_ANIM_OPEN_NOSTATIC = 0x00040000
+MCI_ANIM_PLAY_SPEED = 0x00010000
+MCI_ANIM_PLAY_REVERSE = 0x00020000
+MCI_ANIM_PLAY_FAST = 0x00040000
+MCI_ANIM_PLAY_SLOW = 0x00080000
+MCI_ANIM_PLAY_SCAN = 0x00100000
+MCI_ANIM_STEP_REVERSE = 0x00010000
+MCI_ANIM_STEP_FRAMES = 0x00020000
+MCI_ANIM_STATUS_SPEED = 0x00004001
+MCI_ANIM_STATUS_FORWARD = 0x00004002
+MCI_ANIM_STATUS_HWND = 0x00004003
+MCI_ANIM_STATUS_HPAL = 0x00004004
+MCI_ANIM_STATUS_STRETCH = 0x00004005
+MCI_ANIM_INFO_TEXT = 0x00010000
+MCI_ANIM_GETDEVCAPS_CAN_REVERSE = 0x00004001
+MCI_ANIM_GETDEVCAPS_FAST_RATE = 0x00004002
+MCI_ANIM_GETDEVCAPS_SLOW_RATE = 0x00004003
+MCI_ANIM_GETDEVCAPS_NORMAL_RATE = 0x00004004
+MCI_ANIM_GETDEVCAPS_PALETTES = 0x00004006
+MCI_ANIM_GETDEVCAPS_CAN_STRETCH = 0x00004007
+MCI_ANIM_GETDEVCAPS_MAX_WINDOWS = 0x00004008
+MCI_ANIM_REALIZE_NORM = 0x00010000
+MCI_ANIM_REALIZE_BKGD = 0x00020000
+MCI_ANIM_WINDOW_HWND = 0x00010000
+MCI_ANIM_WINDOW_STATE = 0x00040000
+MCI_ANIM_WINDOW_TEXT = 0x00080000
+MCI_ANIM_WINDOW_ENABLE_STRETCH = 0x00100000
+MCI_ANIM_WINDOW_DISABLE_STRETCH = 0x00200000
+MCI_ANIM_WINDOW_DEFAULT = 0x00000000
+MCI_ANIM_RECT = 0x00010000
+MCI_ANIM_PUT_SOURCE = 0x00020000
+MCI_ANIM_PUT_DESTINATION = 0x00040000
+MCI_ANIM_WHERE_SOURCE = 0x00020000
+MCI_ANIM_WHERE_DESTINATION = 0x00040000
+MCI_ANIM_UPDATE_HDC = 0x00020000
+MCI_OVLY_OPEN_WS = 0x00010000
+MCI_OVLY_OPEN_PARENT = 0x00020000
+MCI_OVLY_STATUS_HWND = 0x00004001
+MCI_OVLY_STATUS_STRETCH = 0x00004002
+MCI_OVLY_INFO_TEXT = 0x00010000
+MCI_OVLY_GETDEVCAPS_CAN_STRETCH = 0x00004001
+MCI_OVLY_GETDEVCAPS_CAN_FREEZE = 0x00004002
+MCI_OVLY_GETDEVCAPS_MAX_WINDOWS = 0x00004003
+MCI_OVLY_WINDOW_HWND = 0x00010000
+MCI_OVLY_WINDOW_STATE = 0x00040000
+MCI_OVLY_WINDOW_TEXT = 0x00080000
+MCI_OVLY_WINDOW_ENABLE_STRETCH = 0x00100000
+MCI_OVLY_WINDOW_DISABLE_STRETCH = 0x00200000
+MCI_OVLY_WINDOW_DEFAULT = 0x00000000
+MCI_OVLY_RECT = 0x00010000
+MCI_OVLY_PUT_SOURCE = 0x00020000
+MCI_OVLY_PUT_DESTINATION = 0x00040000
+MCI_OVLY_PUT_FRAME = 0x00080000
+MCI_OVLY_PUT_VIDEO = 0x00100000
+MCI_OVLY_WHERE_SOURCE = 0x00020000
+MCI_OVLY_WHERE_DESTINATION = 0x00040000
+MCI_OVLY_WHERE_FRAME = 0x00080000
+MCI_OVLY_WHERE_VIDEO = 0x00100000
+SELECTDIB = 41
+
+
+def DIBINDEX(n):
+    return MAKELONG((n), 0x10FF)
diff --git a/lib/win32/lib/netbios.py b/lib/win32/lib/netbios.py
new file mode 100644
index 00000000..dca4dee6
--- /dev/null
+++ b/lib/win32/lib/netbios.py
@@ -0,0 +1,304 @@
+import struct
+import sys
+
+import win32wnet
+
+# Constants generated by h2py from nb30.h
+NCBNAMSZ = 16
+MAX_LANA = 254
+NAME_FLAGS_MASK = 0x87
+GROUP_NAME = 0x80
+UNIQUE_NAME = 0x00
+REGISTERING = 0x00
+REGISTERED = 0x04
+DEREGISTERED = 0x05
+DUPLICATE = 0x06
+DUPLICATE_DEREG = 0x07
+LISTEN_OUTSTANDING = 0x01
+CALL_PENDING = 0x02
+SESSION_ESTABLISHED = 0x03
+HANGUP_PENDING = 0x04
+HANGUP_COMPLETE = 0x05
+SESSION_ABORTED = 0x06
+ALL_TRANSPORTS = "M\0\0\0"
+MS_NBF = "MNBF"
+NCBCALL = 0x10
+NCBLISTEN = 0x11
+NCBHANGUP = 0x12
+NCBSEND = 0x14
+NCBRECV = 0x15
+NCBRECVANY = 0x16
+NCBCHAINSEND = 0x17
+NCBDGSEND = 0x20
+NCBDGRECV = 0x21
+NCBDGSENDBC = 0x22
+NCBDGRECVBC = 0x23
+NCBADDNAME = 0x30
+NCBDELNAME = 0x31
+NCBRESET = 0x32
+NCBASTAT = 0x33
+NCBSSTAT = 0x34
+NCBCANCEL = 0x35
+NCBADDGRNAME = 0x36
+NCBENUM = 0x37
+NCBUNLINK = 0x70
+NCBSENDNA = 0x71
+NCBCHAINSENDNA = 0x72
+NCBLANSTALERT = 0x73
+NCBACTION = 0x77
+NCBFINDNAME = 0x78
+NCBTRACE = 0x79
+ASYNCH = 0x80
+NRC_GOODRET = 0x00
+NRC_BUFLEN = 0x01
+NRC_ILLCMD = 0x03
+NRC_CMDTMO = 0x05
+NRC_INCOMP = 0x06
+NRC_BADDR = 0x07
+NRC_SNUMOUT = 0x08
+NRC_NORES = 0x09
+NRC_SCLOSED = 0x0A
+NRC_CMDCAN = 0x0B
+NRC_DUPNAME = 0x0D
+NRC_NAMTFUL = 0x0E
+NRC_ACTSES = 0x0F
+NRC_LOCTFUL = 0x11
+NRC_REMTFUL = 0x12
+NRC_ILLNN = 0x13
+NRC_NOCALL = 0x14
+NRC_NOWILD = 0x15
+NRC_INUSE = 0x16
+NRC_NAMERR = 0x17
+NRC_SABORT = 0x18
+NRC_NAMCONF = 0x19
+NRC_IFBUSY = 0x21
+NRC_TOOMANY = 0x22
+NRC_BRIDGE = 0x23
+NRC_CANOCCR = 0x24
+NRC_CANCEL = 0x26
+NRC_DUPENV = 0x30
+NRC_ENVNOTDEF = 0x34
+NRC_OSRESNOTAV = 0x35
+NRC_MAXAPPS = 0x36
+NRC_NOSAPS = 0x37
+NRC_NORESOURCES = 0x38
+NRC_INVADDRESS = 0x39
+NRC_INVDDID = 0x3B
+NRC_LOCKFAIL = 0x3C
+NRC_OPENERR = 0x3F
+NRC_SYSTEM = 0x40
+NRC_PENDING = 0xFF
+
+
+UCHAR = "B"
+WORD = "H"
+DWORD = "I"
+USHORT = "H"
+ULONG = "I"
+
+ADAPTER_STATUS_ITEMS = [
+    ("6s", "adapter_address"),
+    (UCHAR, "rev_major"),
+    (UCHAR, "reserved0"),
+    (UCHAR, "adapter_type"),
+    (UCHAR, "rev_minor"),
+    (WORD, "duration"),
+    (WORD, "frmr_recv"),
+    (WORD, "frmr_xmit"),
+    (WORD, "iframe_recv_err"),
+    (WORD, "xmit_aborts"),
+    (DWORD, "xmit_success"),
+    (DWORD, "recv_success"),
+    (WORD, "iframe_xmit_err"),
+    (WORD, "recv_buff_unavail"),
+    (WORD, "t1_timeouts"),
+    (WORD, "ti_timeouts"),
+    (DWORD, "reserved1"),
+    (WORD, "free_ncbs"),
+    (WORD, "max_cfg_ncbs"),
+    (WORD, "max_ncbs"),
+    (WORD, "xmit_buf_unavail"),
+    (WORD, "max_dgram_size"),
+    (WORD, "pending_sess"),
+    (WORD, "max_cfg_sess"),
+    (WORD, "max_sess"),
+    (WORD, "max_sess_pkt_size"),
+    (WORD, "name_count"),
+]
+
+NAME_BUFFER_ITEMS = [
+    (str(NCBNAMSZ) + "s", "name"),
+    (UCHAR, "name_num"),
+    (UCHAR, "name_flags"),
+]
+
+SESSION_HEADER_ITEMS = [
+    (UCHAR, "sess_name"),
+    (UCHAR, "num_sess"),
+    (UCHAR, "rcv_dg_outstanding"),
+    (UCHAR, "rcv_any_outstanding"),
+]
+
+SESSION_BUFFER_ITEMS = [
+    (UCHAR, "lsn"),
+    (UCHAR, "state"),
+    (str(NCBNAMSZ) + "s", "local_name"),
+    (str(NCBNAMSZ) + "s", "remote_name"),
+    (UCHAR, "rcvs_outstanding"),
+    (UCHAR, "sends_outstanding"),
+]
+
+LANA_ENUM_ITEMS = [
+    ("B", "length"),  # Number of valid entries in lana[]
+    (str(MAX_LANA + 1) + "s", "lana"),
+]
+
+FIND_NAME_HEADER_ITEMS = [
+    (WORD, "node_count"),
+    (UCHAR, "reserved"),
+    (UCHAR, "unique_group"),
+]
+
+FIND_NAME_BUFFER_ITEMS = [
+    (UCHAR, "length"),
+    (UCHAR, "access_control"),
+    (UCHAR, "frame_control"),
+    ("6s", "destination_addr"),
+    ("6s", "source_addr"),
+    ("18s", "routing_info"),
+]
+
+ACTION_HEADER_ITEMS = [
+    (ULONG, "transport_id"),
+    (USHORT, "action_code"),
+    (USHORT, "reserved"),
+]
+
+del UCHAR, WORD, DWORD, USHORT, ULONG
+
+NCB = win32wnet.NCB
+
+
+def Netbios(ncb):
+    ob = ncb.Buffer
+    is_ours = hasattr(ob, "_pack")
+    if is_ours:
+        ob._pack()
+    try:
+        return win32wnet.Netbios(ncb)
+    finally:
+        if is_ours:
+            ob._unpack()
+
+
+class NCBStruct:
+    def __init__(self, items):
+        self._format = "".join([item[0] for item in items])
+        self._items = items
+        self._buffer_ = win32wnet.NCBBuffer(struct.calcsize(self._format))
+
+        for format, name in self._items:
+            if len(format) == 1:
+                if format == "c":
+                    val = "\0"
+                else:
+                    val = 0
+            else:
+                l = int(format[:-1])
+                val = "\0" * l
+            self.__dict__[name] = val
+
+    def _pack(self):
+        vals = []
+        for format, name in self._items:
+            try:
+                vals.append(self.__dict__[name])
+            except KeyError:
+                vals.append(None)
+
+        self._buffer_[:] = struct.pack(*(self._format,) + tuple(vals))
+
+    def _unpack(self):
+        items = struct.unpack(self._format, self._buffer_)
+        assert len(items) == len(self._items), "unexpected number of items to unpack!"
+        for (format, name), val in zip(self._items, items):
+            self.__dict__[name] = val
+
+    def __setattr__(self, attr, val):
+        if attr not in self.__dict__ and attr[0] != "_":
+            for format, attr_name in self._items:
+                if attr == attr_name:
+                    break
+            else:
+                raise AttributeError(attr)
+        self.__dict__[attr] = val
+
+
+def ADAPTER_STATUS():
+    return NCBStruct(ADAPTER_STATUS_ITEMS)
+
+
+def NAME_BUFFER():
+    return NCBStruct(NAME_BUFFER_ITEMS)
+
+
+def SESSION_HEADER():
+    return NCBStruct(SESSION_HEADER_ITEMS)
+
+
+def SESSION_BUFFER():
+    return NCBStruct(SESSION_BUFFER_ITEMS)
+
+
+def LANA_ENUM():
+    return NCBStruct(LANA_ENUM_ITEMS)
+
+
+def FIND_NAME_HEADER():
+    return NCBStruct(FIND_NAME_HEADER_ITEMS)
+
+
+def FIND_NAME_BUFFER():
+    return NCBStruct(FIND_NAME_BUFFER_ITEMS)
+
+
+def ACTION_HEADER():
+    return NCBStruct(ACTION_HEADER_ITEMS)
+
+
+def byte_to_int(b):
+    """Given an element in a binary buffer, return its integer value"""
+    if sys.version_info >= (3, 0):
+        # a byte is already an int in py3k
+        return b
+    return ord(b)  # its a char from a string in py2k.
+
+
+if __name__ == "__main__":
+    # code ported from "HOWTO: Get the MAC Address for an Ethernet Adapter"
+    # MS KB ID: Q118623
+    ncb = NCB()
+    ncb.Command = NCBENUM
+    la_enum = LANA_ENUM()
+    ncb.Buffer = la_enum
+    rc = Netbios(ncb)
+    if rc != 0:
+        raise RuntimeError("Unexpected result %d" % (rc,))
+    for i in range(la_enum.length):
+        ncb.Reset()
+        ncb.Command = NCBRESET
+        ncb.Lana_num = byte_to_int(la_enum.lana[i])
+        rc = Netbios(ncb)
+        if rc != 0:
+            raise RuntimeError("Unexpected result %d" % (rc,))
+        ncb.Reset()
+        ncb.Command = NCBASTAT
+        ncb.Lana_num = byte_to_int(la_enum.lana[i])
+        ncb.Callname = "*               ".encode("ascii")  # ensure bytes on py2x and 3k
+        adapter = ADAPTER_STATUS()
+        ncb.Buffer = adapter
+        Netbios(ncb)
+        print("Adapter address:", end=" ")
+        for ch in adapter.adapter_address:
+            print("%02x" % (byte_to_int(ch),), end=" ")
+        print()
diff --git a/lib/win32/lib/ntsecuritycon.py b/lib/win32/lib/ntsecuritycon.py
new file mode 100644
index 00000000..4d5b2ed5
--- /dev/null
+++ b/lib/win32/lib/ntsecuritycon.py
@@ -0,0 +1,731 @@
+# Hacked from winnt.h
+
+DELETE = 65536
+READ_CONTROL = 131072
+WRITE_DAC = 262144
+WRITE_OWNER = 524288
+SYNCHRONIZE = 1048576
+STANDARD_RIGHTS_REQUIRED = 983040
+STANDARD_RIGHTS_READ = READ_CONTROL
+STANDARD_RIGHTS_WRITE = READ_CONTROL
+STANDARD_RIGHTS_EXECUTE = READ_CONTROL
+STANDARD_RIGHTS_ALL = 2031616
+SPECIFIC_RIGHTS_ALL = 65535
+ACCESS_SYSTEM_SECURITY = 16777216
+MAXIMUM_ALLOWED = 33554432
+GENERIC_READ = -2147483648
+GENERIC_WRITE = 1073741824
+GENERIC_EXECUTE = 536870912
+GENERIC_ALL = 268435456
+
+# file security permissions
+FILE_READ_DATA = 1
+FILE_LIST_DIRECTORY = 1
+FILE_WRITE_DATA = 2
+FILE_ADD_FILE = 2
+FILE_APPEND_DATA = 4
+FILE_ADD_SUBDIRECTORY = 4
+FILE_CREATE_PIPE_INSTANCE = 4
+FILE_READ_EA = 8
+FILE_WRITE_EA = 16
+FILE_EXECUTE = 32
+FILE_TRAVERSE = 32
+FILE_DELETE_CHILD = 64
+FILE_READ_ATTRIBUTES = 128
+FILE_WRITE_ATTRIBUTES = 256
+FILE_ALL_ACCESS = STANDARD_RIGHTS_REQUIRED | SYNCHRONIZE | 511
+FILE_GENERIC_READ = (
+    STANDARD_RIGHTS_READ
+    | FILE_READ_DATA
+    | FILE_READ_ATTRIBUTES
+    | FILE_READ_EA
+    | SYNCHRONIZE
+)
+FILE_GENERIC_WRITE = (
+    STANDARD_RIGHTS_WRITE
+    | FILE_WRITE_DATA
+    | FILE_WRITE_ATTRIBUTES
+    | FILE_WRITE_EA
+    | FILE_APPEND_DATA
+    | SYNCHRONIZE
+)
+FILE_GENERIC_EXECUTE = (
+    STANDARD_RIGHTS_EXECUTE | FILE_READ_ATTRIBUTES | FILE_EXECUTE | SYNCHRONIZE
+)
+
+
+SECURITY_NULL_SID_AUTHORITY = (0, 0, 0, 0, 0, 0)
+SECURITY_WORLD_SID_AUTHORITY = (0, 0, 0, 0, 0, 1)
+SECURITY_LOCAL_SID_AUTHORITY = (0, 0, 0, 0, 0, 2)
+SECURITY_CREATOR_SID_AUTHORITY = (0, 0, 0, 0, 0, 3)
+SECURITY_NON_UNIQUE_AUTHORITY = (0, 0, 0, 0, 0, 4)
+SECURITY_RESOURCE_MANAGER_AUTHORITY = (0, 0, 0, 0, 0, 9)
+
+SECURITY_NULL_RID = 0
+SECURITY_WORLD_RID = 0
+SECURITY_LOCAL_RID = 0x00000000
+
+SECURITY_CREATOR_OWNER_RID = 0
+SECURITY_CREATOR_GROUP_RID = 1
+
+SECURITY_CREATOR_OWNER_SERVER_RID = 2
+SECURITY_CREATOR_GROUP_SERVER_RID = 3
+SECURITY_CREATOR_OWNER_RIGHTS_RID = 4
+
+# NT well-known SIDs
+SECURITY_NT_AUTHORITY = (0, 0, 0, 0, 0, 5)
+
+SECURITY_DIALUP_RID = 1
+SECURITY_NETWORK_RID = 2
+SECURITY_BATCH_RID = 3
+SECURITY_INTERACTIVE_RID = 4
+SECURITY_SERVICE_RID = 6
+SECURITY_ANONYMOUS_LOGON_RID = 7
+SECURITY_PROXY_RID = 8
+SECURITY_SERVER_LOGON_RID = 9
+
+SECURITY_LOGON_IDS_RID = 5
+SECURITY_LOGON_IDS_RID_COUNT = 3
+
+SECURITY_LOCAL_SYSTEM_RID = 18
+
+SECURITY_NT_NON_UNIQUE = 21
+
+SECURITY_BUILTIN_DOMAIN_RID = 32
+
+# well-known domain relative sub-authority values (RIDs)...
+DOMAIN_USER_RID_ADMIN = 500
+DOMAIN_USER_RID_GUEST = 501
+DOMAIN_USER_RID_KRBTGT = 502
+DOMAIN_USER_RID_MAX = 999
+
+# well-known groups ...
+DOMAIN_GROUP_RID_ADMINS = 512
+DOMAIN_GROUP_RID_USERS = 513
+DOMAIN_GROUP_RID_GUESTS = 514
+DOMAIN_GROUP_RID_COMPUTERS = 515
+DOMAIN_GROUP_RID_CONTROLLERS = 516
+DOMAIN_GROUP_RID_CERT_ADMINS = 517
+DOMAIN_GROUP_RID_SCHEMA_ADMINS = 518
+DOMAIN_GROUP_RID_ENTERPRISE_ADMINS = 519
+DOMAIN_GROUP_RID_POLICY_ADMINS = 520
+DOMAIN_GROUP_RID_READONLY_CONTROLLERS = 521
+
+# well-known aliases ...
+DOMAIN_ALIAS_RID_ADMINS = 544
+DOMAIN_ALIAS_RID_USERS = 545
+DOMAIN_ALIAS_RID_GUESTS = 546
+DOMAIN_ALIAS_RID_POWER_USERS = 547
+DOMAIN_ALIAS_RID_ACCOUNT_OPS = 548
+DOMAIN_ALIAS_RID_SYSTEM_OPS = 549
+DOMAIN_ALIAS_RID_PRINT_OPS = 550
+DOMAIN_ALIAS_RID_BACKUP_OPS = 551
+DOMAIN_ALIAS_RID_REPLICATOR = 552
+DOMAIN_ALIAS_RID_RAS_SERVERS = 553
+DOMAIN_ALIAS_RID_PREW2KCOMPACCESS = 554
+DOMAIN_ALIAS_RID_REMOTE_DESKTOP_USERS = 555
+DOMAIN_ALIAS_RID_NETWORK_CONFIGURATION_OPS = 556
+DOMAIN_ALIAS_RID_INCOMING_FOREST_TRUST_BUILDERS = 557
+DOMAIN_ALIAS_RID_MONITORING_USERS = 558
+DOMAIN_ALIAS_RID_LOGGING_USERS = 559
+DOMAIN_ALIAS_RID_AUTHORIZATIONACCESS = 560
+DOMAIN_ALIAS_RID_TS_LICENSE_SERVERS = 561
+DOMAIN_ALIAS_RID_DCOM_USERS = 562
+DOMAIN_ALIAS_RID_IUSERS = 568
+DOMAIN_ALIAS_RID_CRYPTO_OPERATORS = 569
+DOMAIN_ALIAS_RID_CACHEABLE_PRINCIPALS_GROUP = 571
+DOMAIN_ALIAS_RID_NON_CACHEABLE_PRINCIPALS_GROUP = 572
+DOMAIN_ALIAS_RID_EVENT_LOG_READERS_GROUP = 573
+
+SECURITY_MANDATORY_LABEL_AUTHORITY = (0, 0, 0, 0, 0, 16)
+SECURITY_MANDATORY_UNTRUSTED_RID = 0x00000000
+SECURITY_MANDATORY_LOW_RID = 0x00001000
+SECURITY_MANDATORY_MEDIUM_RID = 0x00002000
+SECURITY_MANDATORY_HIGH_RID = 0x00003000
+SECURITY_MANDATORY_SYSTEM_RID = 0x00004000
+SECURITY_MANDATORY_PROTECTED_PROCESS_RID = 0x00005000
+SECURITY_MANDATORY_MAXIMUM_USER_RID = SECURITY_MANDATORY_SYSTEM_RID
+
+SYSTEM_LUID = (999, 0)
+ANONYMOUS_LOGON_LUID = (998, 0)
+LOCALSERVICE_LUID = (997, 0)
+NETWORKSERVICE_LUID = (996, 0)
+IUSER_LUID = (995, 0)
+
+# Group attributes
+
+SE_GROUP_MANDATORY = 1
+SE_GROUP_ENABLED_BY_DEFAULT = 2
+SE_GROUP_ENABLED = 4
+SE_GROUP_OWNER = 8
+SE_GROUP_USE_FOR_DENY_ONLY = 16
+SE_GROUP_INTEGRITY = 32
+SE_GROUP_INTEGRITY_ENABLED = 64
+SE_GROUP_RESOURCE = 536870912
+SE_GROUP_LOGON_ID = -1073741824
+
+
+# User attributes
+# (None yet defined.)
+
+# ACE types
+ACCESS_MIN_MS_ACE_TYPE = 0
+ACCESS_ALLOWED_ACE_TYPE = 0
+ACCESS_DENIED_ACE_TYPE = 1
+SYSTEM_AUDIT_ACE_TYPE = 2
+SYSTEM_ALARM_ACE_TYPE = 3
+ACCESS_MAX_MS_V2_ACE_TYPE = 3
+ACCESS_ALLOWED_COMPOUND_ACE_TYPE = 4
+ACCESS_MAX_MS_V3_ACE_TYPE = 4
+ACCESS_MIN_MS_OBJECT_ACE_TYPE = 5
+ACCESS_ALLOWED_OBJECT_ACE_TYPE = 5
+ACCESS_DENIED_OBJECT_ACE_TYPE = 6
+SYSTEM_AUDIT_OBJECT_ACE_TYPE = 7
+SYSTEM_ALARM_OBJECT_ACE_TYPE = 8
+ACCESS_MAX_MS_OBJECT_ACE_TYPE = 8
+ACCESS_MAX_MS_V4_ACE_TYPE = 8
+ACCESS_MAX_MS_ACE_TYPE = 8
+ACCESS_ALLOWED_CALLBACK_ACE_TYPE = 9
+ACCESS_DENIED_CALLBACK_ACE_TYPE = 10
+ACCESS_ALLOWED_CALLBACK_OBJECT_ACE_TYPE = 11
+ACCESS_DENIED_CALLBACK_OBJECT_ACE_TYPE = 12
+SYSTEM_AUDIT_CALLBACK_ACE_TYPE = 13
+SYSTEM_ALARM_CALLBACK_ACE_TYPE = 14
+SYSTEM_AUDIT_CALLBACK_OBJECT_ACE_TYPE = 15
+SYSTEM_ALARM_CALLBACK_OBJECT_ACE_TYPE = 16
+SYSTEM_MANDATORY_LABEL_ACE_TYPE = 17
+ACCESS_MAX_MS_V5_ACE_TYPE = 17
+
+#  The following are the inherit flags that go into the AceFlags field
+#  of an Ace header.
+
+OBJECT_INHERIT_ACE = 1
+CONTAINER_INHERIT_ACE = 2
+NO_PROPAGATE_INHERIT_ACE = 4
+INHERIT_ONLY_ACE = 8
+VALID_INHERIT_FLAGS = 15
+
+
+SUCCESSFUL_ACCESS_ACE_FLAG = 64
+FAILED_ACCESS_ACE_FLAG = 128
+
+SE_OWNER_DEFAULTED = 1
+SE_GROUP_DEFAULTED = 2
+SE_DACL_PRESENT = 4
+SE_DACL_DEFAULTED = 8
+SE_SACL_PRESENT = 16
+SE_SACL_DEFAULTED = 32
+SE_SELF_RELATIVE = 32768
+
+
+SE_PRIVILEGE_ENABLED_BY_DEFAULT = 1
+SE_PRIVILEGE_ENABLED = 2
+SE_PRIVILEGE_USED_FOR_ACCESS = -2147483648
+
+PRIVILEGE_SET_ALL_NECESSARY = 1
+
+#               NT Defined Privileges
+
+SE_CREATE_TOKEN_NAME = "SeCreateTokenPrivilege"
+SE_ASSIGNPRIMARYTOKEN_NAME = "SeAssignPrimaryTokenPrivilege"
+SE_LOCK_MEMORY_NAME = "SeLockMemoryPrivilege"
+SE_INCREASE_QUOTA_NAME = "SeIncreaseQuotaPrivilege"
+SE_UNSOLICITED_INPUT_NAME = "SeUnsolicitedInputPrivilege"
+SE_MACHINE_ACCOUNT_NAME = "SeMachineAccountPrivilege"
+SE_TCB_NAME = "SeTcbPrivilege"
+SE_SECURITY_NAME = "SeSecurityPrivilege"
+SE_TAKE_OWNERSHIP_NAME = "SeTakeOwnershipPrivilege"
+SE_LOAD_DRIVER_NAME = "SeLoadDriverPrivilege"
+SE_SYSTEM_PROFILE_NAME = "SeSystemProfilePrivilege"
+SE_SYSTEMTIME_NAME = "SeSystemtimePrivilege"
+SE_PROF_SINGLE_PROCESS_NAME = "SeProfileSingleProcessPrivilege"
+SE_INC_BASE_PRIORITY_NAME = "SeIncreaseBasePriorityPrivilege"
+SE_CREATE_PAGEFILE_NAME = "SeCreatePagefilePrivilege"
+SE_CREATE_PERMANENT_NAME = "SeCreatePermanentPrivilege"
+SE_BACKUP_NAME = "SeBackupPrivilege"
+SE_RESTORE_NAME = "SeRestorePrivilege"
+SE_SHUTDOWN_NAME = "SeShutdownPrivilege"
+SE_DEBUG_NAME = "SeDebugPrivilege"
+SE_AUDIT_NAME = "SeAuditPrivilege"
+SE_SYSTEM_ENVIRONMENT_NAME = "SeSystemEnvironmentPrivilege"
+SE_CHANGE_NOTIFY_NAME = "SeChangeNotifyPrivilege"
+SE_REMOTE_SHUTDOWN_NAME = "SeRemoteShutdownPrivilege"
+
+
+# Enum SECURITY_IMPERSONATION_LEVEL:
+SecurityAnonymous = 0
+SecurityIdentification = 1
+SecurityImpersonation = 2
+SecurityDelegation = 3
+
+SECURITY_MAX_IMPERSONATION_LEVEL = SecurityDelegation
+
+DEFAULT_IMPERSONATION_LEVEL = SecurityImpersonation
+
+TOKEN_ASSIGN_PRIMARY = 1
+TOKEN_DUPLICATE = 2
+TOKEN_IMPERSONATE = 4
+TOKEN_QUERY = 8
+TOKEN_QUERY_SOURCE = 16
+TOKEN_ADJUST_PRIVILEGES = 32
+TOKEN_ADJUST_GROUPS = 64
+TOKEN_ADJUST_DEFAULT = 128
+
+TOKEN_ALL_ACCESS = (
+    STANDARD_RIGHTS_REQUIRED
+    | TOKEN_ASSIGN_PRIMARY
+    | TOKEN_DUPLICATE
+    | TOKEN_IMPERSONATE
+    | TOKEN_QUERY
+    | TOKEN_QUERY_SOURCE
+    | TOKEN_ADJUST_PRIVILEGES
+    | TOKEN_ADJUST_GROUPS
+    | TOKEN_ADJUST_DEFAULT
+)
+
+
+TOKEN_READ = STANDARD_RIGHTS_READ | TOKEN_QUERY
+
+
+TOKEN_WRITE = (
+    STANDARD_RIGHTS_WRITE
+    | TOKEN_ADJUST_PRIVILEGES
+    | TOKEN_ADJUST_GROUPS
+    | TOKEN_ADJUST_DEFAULT
+)
+
+TOKEN_EXECUTE = STANDARD_RIGHTS_EXECUTE
+
+SidTypeUser = 1
+SidTypeGroup = 2
+SidTypeDomain = 3
+SidTypeAlias = 4
+SidTypeWellKnownGroup = 5
+SidTypeDeletedAccount = 6
+SidTypeInvalid = 7
+SidTypeUnknown = 8
+SidTypeComputer = 9
+SidTypeLabel = 10
+
+# Token types
+TokenPrimary = 1
+TokenImpersonation = 2
+
+# TOKEN_INFORMATION_CLASS, used with Get/SetTokenInformation
+TokenUser = 1
+TokenGroups = 2
+TokenPrivileges = 3
+TokenOwner = 4
+TokenPrimaryGroup = 5
+TokenDefaultDacl = 6
+TokenSource = 7
+TokenType = 8
+TokenImpersonationLevel = 9
+TokenStatistics = 10
+TokenRestrictedSids = 11
+TokenSessionId = 12
+TokenGroupsAndPrivileges = 13
+TokenSessionReference = 14
+TokenSandBoxInert = 15
+TokenAuditPolicy = 16
+TokenOrigin = 17
+TokenElevationType = 18
+TokenLinkedToken = 19
+TokenElevation = 20
+TokenHasRestrictions = 21
+TokenAccessInformation = 22
+TokenVirtualizationAllowed = 23
+TokenVirtualizationEnabled = 24
+TokenIntegrityLevel = 25
+TokenUIAccess = 26
+TokenMandatoryPolicy = 27
+TokenLogonSid = 28
+
+# DirectoryService related constants.
+# Generated by h2py from NtDsAPI.h
+DS_BEHAVIOR_WIN2000 = 0
+DS_BEHAVIOR_WIN2003_WITH_MIXED_DOMAINS = 1
+DS_BEHAVIOR_WIN2003 = 2
+DS_SYNCED_EVENT_NAME = "NTDSInitialSyncsCompleted"
+ACTRL_DS_OPEN = 0x00000000
+ACTRL_DS_CREATE_CHILD = 0x00000001
+ACTRL_DS_DELETE_CHILD = 0x00000002
+ACTRL_DS_LIST = 0x00000004
+ACTRL_DS_SELF = 0x00000008
+ACTRL_DS_READ_PROP = 0x00000010
+ACTRL_DS_WRITE_PROP = 0x00000020
+ACTRL_DS_DELETE_TREE = 0x00000040
+ACTRL_DS_LIST_OBJECT = 0x00000080
+ACTRL_DS_CONTROL_ACCESS = 0x00000100
+NTDSAPI_BIND_ALLOW_DELEGATION = 0x00000001
+DS_REPSYNC_ASYNCHRONOUS_OPERATION = 0x00000001
+DS_REPSYNC_WRITEABLE = 0x00000002
+DS_REPSYNC_PERIODIC = 0x00000004
+DS_REPSYNC_INTERSITE_MESSAGING = 0x00000008
+DS_REPSYNC_ALL_SOURCES = 0x00000010
+DS_REPSYNC_FULL = 0x00000020
+DS_REPSYNC_URGENT = 0x00000040
+DS_REPSYNC_NO_DISCARD = 0x00000080
+DS_REPSYNC_FORCE = 0x00000100
+DS_REPSYNC_ADD_REFERENCE = 0x00000200
+DS_REPSYNC_NEVER_COMPLETED = 0x00000400
+DS_REPSYNC_TWO_WAY = 0x00000800
+DS_REPSYNC_NEVER_NOTIFY = 0x00001000
+DS_REPSYNC_INITIAL = 0x00002000
+DS_REPSYNC_USE_COMPRESSION = 0x00004000
+DS_REPSYNC_ABANDONED = 0x00008000
+DS_REPSYNC_INITIAL_IN_PROGRESS = 0x00010000
+DS_REPSYNC_PARTIAL_ATTRIBUTE_SET = 0x00020000
+DS_REPSYNC_REQUEUE = 0x00040000
+DS_REPSYNC_NOTIFICATION = 0x00080000
+DS_REPSYNC_ASYNCHRONOUS_REPLICA = 0x00100000
+DS_REPSYNC_CRITICAL = 0x00200000
+DS_REPSYNC_FULL_IN_PROGRESS = 0x00400000
+DS_REPSYNC_PREEMPTED = 0x00800000
+DS_REPADD_ASYNCHRONOUS_OPERATION = 0x00000001
+DS_REPADD_WRITEABLE = 0x00000002
+DS_REPADD_INITIAL = 0x00000004
+DS_REPADD_PERIODIC = 0x00000008
+DS_REPADD_INTERSITE_MESSAGING = 0x00000010
+DS_REPADD_ASYNCHRONOUS_REPLICA = 0x00000020
+DS_REPADD_DISABLE_NOTIFICATION = 0x00000040
+DS_REPADD_DISABLE_PERIODIC = 0x00000080
+DS_REPADD_USE_COMPRESSION = 0x00000100
+DS_REPADD_NEVER_NOTIFY = 0x00000200
+DS_REPADD_TWO_WAY = 0x00000400
+DS_REPADD_CRITICAL = 0x00000800
+DS_REPDEL_ASYNCHRONOUS_OPERATION = 0x00000001
+DS_REPDEL_WRITEABLE = 0x00000002
+DS_REPDEL_INTERSITE_MESSAGING = 0x00000004
+DS_REPDEL_IGNORE_ERRORS = 0x00000008
+DS_REPDEL_LOCAL_ONLY = 0x00000010
+DS_REPDEL_NO_SOURCE = 0x00000020
+DS_REPDEL_REF_OK = 0x00000040
+DS_REPMOD_ASYNCHRONOUS_OPERATION = 0x00000001
+DS_REPMOD_WRITEABLE = 0x00000002
+DS_REPMOD_UPDATE_FLAGS = 0x00000001
+DS_REPMOD_UPDATE_ADDRESS = 0x00000002
+DS_REPMOD_UPDATE_SCHEDULE = 0x00000004
+DS_REPMOD_UPDATE_RESULT = 0x00000008
+DS_REPMOD_UPDATE_TRANSPORT = 0x00000010
+DS_REPUPD_ASYNCHRONOUS_OPERATION = 0x00000001
+DS_REPUPD_WRITEABLE = 0x00000002
+DS_REPUPD_ADD_REFERENCE = 0x00000004
+DS_REPUPD_DELETE_REFERENCE = 0x00000008
+DS_INSTANCETYPE_IS_NC_HEAD = 0x00000001
+DS_INSTANCETYPE_NC_IS_WRITEABLE = 0x00000004
+DS_INSTANCETYPE_NC_COMING = 0x00000010
+DS_INSTANCETYPE_NC_GOING = 0x00000020
+NTDSDSA_OPT_IS_GC = 1 << 0
+NTDSDSA_OPT_DISABLE_INBOUND_REPL = 1 << 1
+NTDSDSA_OPT_DISABLE_OUTBOUND_REPL = 1 << 2
+NTDSDSA_OPT_DISABLE_NTDSCONN_XLATE = 1 << 3
+NTDSCONN_OPT_IS_GENERATED = 1 << 0
+NTDSCONN_OPT_TWOWAY_SYNC = 1 << 1
+NTDSCONN_OPT_OVERRIDE_NOTIFY_DEFAULT = 1 << 2
+NTDSCONN_OPT_USE_NOTIFY = 1 << 3
+NTDSCONN_OPT_DISABLE_INTERSITE_COMPRESSION = 1 << 4
+NTDSCONN_OPT_USER_OWNED_SCHEDULE = 1 << 5
+NTDSCONN_KCC_NO_REASON = 0
+NTDSCONN_KCC_GC_TOPOLOGY = 1 << 0
+NTDSCONN_KCC_RING_TOPOLOGY = 1 << 1
+NTDSCONN_KCC_MINIMIZE_HOPS_TOPOLOGY = 1 << 2
+NTDSCONN_KCC_STALE_SERVERS_TOPOLOGY = 1 << 3
+NTDSCONN_KCC_OSCILLATING_CONNECTION_TOPOLOGY = 1 << 4
+NTDSCONN_KCC_INTERSITE_GC_TOPOLOGY = 1 << 5
+NTDSCONN_KCC_INTERSITE_TOPOLOGY = 1 << 6
+NTDSCONN_KCC_SERVER_FAILOVER_TOPOLOGY = 1 << 7
+NTDSCONN_KCC_SITE_FAILOVER_TOPOLOGY = 1 << 8
+NTDSCONN_KCC_REDUNDANT_SERVER_TOPOLOGY = 1 << 9
+FRSCONN_PRIORITY_MASK = 0x70000000
+FRSCONN_MAX_PRIORITY = 0x8
+NTDSCONN_OPT_IGNORE_SCHEDULE_MASK = -2147483648
+
+NTDSSETTINGS_OPT_IS_AUTO_TOPOLOGY_DISABLED = 1 << 0
+NTDSSETTINGS_OPT_IS_TOPL_CLEANUP_DISABLED = 1 << 1
+NTDSSETTINGS_OPT_IS_TOPL_MIN_HOPS_DISABLED = 1 << 2
+NTDSSETTINGS_OPT_IS_TOPL_DETECT_STALE_DISABLED = 1 << 3
+NTDSSETTINGS_OPT_IS_INTER_SITE_AUTO_TOPOLOGY_DISABLED = 1 << 4
+NTDSSETTINGS_OPT_IS_GROUP_CACHING_ENABLED = 1 << 5
+NTDSSETTINGS_OPT_FORCE_KCC_WHISTLER_BEHAVIOR = 1 << 6
+NTDSSETTINGS_OPT_FORCE_KCC_W2K_ELECTION = 1 << 7
+NTDSSETTINGS_OPT_IS_RAND_BH_SELECTION_DISABLED = 1 << 8
+NTDSSETTINGS_OPT_IS_SCHEDULE_HASHING_ENABLED = 1 << 9
+NTDSSETTINGS_OPT_IS_REDUNDANT_SERVER_TOPOLOGY_ENABLED = 1 << 10
+NTDSSETTINGS_DEFAULT_SERVER_REDUNDANCY = 2
+NTDSTRANSPORT_OPT_IGNORE_SCHEDULES = 1 << 0
+NTDSTRANSPORT_OPT_BRIDGES_REQUIRED = 1 << 1
+NTDSSITECONN_OPT_USE_NOTIFY = 1 << 0
+NTDSSITECONN_OPT_TWOWAY_SYNC = 1 << 1
+NTDSSITECONN_OPT_DISABLE_COMPRESSION = 1 << 2
+NTDSSITELINK_OPT_USE_NOTIFY = 1 << 0
+NTDSSITELINK_OPT_TWOWAY_SYNC = 1 << 1
+NTDSSITELINK_OPT_DISABLE_COMPRESSION = 1 << 2
+GUID_USERS_CONTAINER_A = "a9d1ca15768811d1aded00c04fd8d5cd"
+GUID_COMPUTRS_CONTAINER_A = "aa312825768811d1aded00c04fd8d5cd"
+GUID_SYSTEMS_CONTAINER_A = "ab1d30f3768811d1aded00c04fd8d5cd"
+GUID_DOMAIN_CONTROLLERS_CONTAINER_A = "a361b2ffffd211d1aa4b00c04fd7d83a"
+GUID_INFRASTRUCTURE_CONTAINER_A = "2fbac1870ade11d297c400c04fd8d5cd"
+GUID_DELETED_OBJECTS_CONTAINER_A = "18e2ea80684f11d2b9aa00c04f79f805"
+GUID_LOSTANDFOUND_CONTAINER_A = "ab8153b7768811d1aded00c04fd8d5cd"
+GUID_FOREIGNSECURITYPRINCIPALS_CONTAINER_A = "22b70c67d56e4efb91e9300fca3dc1aa"
+GUID_PROGRAM_DATA_CONTAINER_A = "09460c08ae1e4a4ea0f64aee7daa1e5a"
+GUID_MICROSOFT_PROGRAM_DATA_CONTAINER_A = "f4be92a4c777485e878e9421d53087db"
+GUID_NTDS_QUOTAS_CONTAINER_A = "6227f0af1fc2410d8e3bb10615bb5b0f"
+GUID_USERS_CONTAINER_BYTE = (
+    "\xa9\xd1\xca\x15\x76\x88\x11\xd1\xad\xed\x00\xc0\x4f\xd8\xd5\xcd"
+)
+GUID_COMPUTRS_CONTAINER_BYTE = (
+    "\xaa\x31\x28\x25\x76\x88\x11\xd1\xad\xed\x00\xc0\x4f\xd8\xd5\xcd"
+)
+GUID_SYSTEMS_CONTAINER_BYTE = (
+    "\xab\x1d\x30\xf3\x76\x88\x11\xd1\xad\xed\x00\xc0\x4f\xd8\xd5\xcd"
+)
+GUID_DOMAIN_CONTROLLERS_CONTAINER_BYTE = (
+    "\xa3\x61\xb2\xff\xff\xd2\x11\xd1\xaa\x4b\x00\xc0\x4f\xd7\xd8\x3a"
+)
+GUID_INFRASTRUCTURE_CONTAINER_BYTE = (
+    "\x2f\xba\xc1\x87\x0a\xde\x11\xd2\x97\xc4\x00\xc0\x4f\xd8\xd5\xcd"
+)
+GUID_DELETED_OBJECTS_CONTAINER_BYTE = (
+    "\x18\xe2\xea\x80\x68\x4f\x11\xd2\xb9\xaa\x00\xc0\x4f\x79\xf8\x05"
+)
+GUID_LOSTANDFOUND_CONTAINER_BYTE = (
+    "\xab\x81\x53\xb7\x76\x88\x11\xd1\xad\xed\x00\xc0\x4f\xd8\xd5\xcd"
+)
+GUID_FOREIGNSECURITYPRINCIPALS_CONTAINER_BYTE = (
+    "\x22\xb7\x0c\x67\xd5\x6e\x4e\xfb\x91\xe9\x30\x0f\xca\x3d\xc1\xaa"
+)
+GUID_PROGRAM_DATA_CONTAINER_BYTE = (
+    "\x09\x46\x0c\x08\xae\x1e\x4a\x4e\xa0\xf6\x4a\xee\x7d\xaa\x1e\x5a"
+)
+GUID_MICROSOFT_PROGRAM_DATA_CONTAINER_BYTE = (
+    "\xf4\xbe\x92\xa4\xc7\x77\x48\x5e\x87\x8e\x94\x21\xd5\x30\x87\xdb"
+)
+GUID_NTDS_QUOTAS_CONTAINER_BYTE = (
+    "\x62\x27\xf0\xaf\x1f\xc2\x41\x0d\x8e\x3b\xb1\x06\x15\xbb\x5b\x0f"
+)
+DS_REPSYNCALL_NO_OPTIONS = 0x00000000
+DS_REPSYNCALL_ABORT_IF_SERVER_UNAVAILABLE = 0x00000001
+DS_REPSYNCALL_SYNC_ADJACENT_SERVERS_ONLY = 0x00000002
+DS_REPSYNCALL_ID_SERVERS_BY_DN = 0x00000004
+DS_REPSYNCALL_DO_NOT_SYNC = 0x00000008
+DS_REPSYNCALL_SKIP_INITIAL_CHECK = 0x00000010
+DS_REPSYNCALL_PUSH_CHANGES_OUTWARD = 0x00000020
+DS_REPSYNCALL_CROSS_SITE_BOUNDARIES = 0x00000040
+DS_LIST_DSA_OBJECT_FOR_SERVER = 0
+DS_LIST_DNS_HOST_NAME_FOR_SERVER = 1
+DS_LIST_ACCOUNT_OBJECT_FOR_SERVER = 2
+DS_ROLE_SCHEMA_OWNER = 0
+DS_ROLE_DOMAIN_OWNER = 1
+DS_ROLE_PDC_OWNER = 2
+DS_ROLE_RID_OWNER = 3
+DS_ROLE_INFRASTRUCTURE_OWNER = 4
+DS_SCHEMA_GUID_NOT_FOUND = 0
+DS_SCHEMA_GUID_ATTR = 1
+DS_SCHEMA_GUID_ATTR_SET = 2
+DS_SCHEMA_GUID_CLASS = 3
+DS_SCHEMA_GUID_CONTROL_RIGHT = 4
+DS_KCC_FLAG_ASYNC_OP = 1 << 0
+DS_KCC_FLAG_DAMPED = 1 << 1
+DS_EXIST_ADVISORY_MODE = 0x1
+DS_REPL_INFO_FLAG_IMPROVE_LINKED_ATTRS = 0x00000001
+DS_REPL_NBR_WRITEABLE = 0x00000010
+DS_REPL_NBR_SYNC_ON_STARTUP = 0x00000020
+DS_REPL_NBR_DO_SCHEDULED_SYNCS = 0x00000040
+DS_REPL_NBR_USE_ASYNC_INTERSITE_TRANSPORT = 0x00000080
+DS_REPL_NBR_TWO_WAY_SYNC = 0x00000200
+DS_REPL_NBR_RETURN_OBJECT_PARENTS = 0x00000800
+DS_REPL_NBR_FULL_SYNC_IN_PROGRESS = 0x00010000
+DS_REPL_NBR_FULL_SYNC_NEXT_PACKET = 0x00020000
+DS_REPL_NBR_NEVER_SYNCED = 0x00200000
+DS_REPL_NBR_PREEMPTED = 0x01000000
+DS_REPL_NBR_IGNORE_CHANGE_NOTIFICATIONS = 0x04000000
+DS_REPL_NBR_DISABLE_SCHEDULED_SYNC = 0x08000000
+DS_REPL_NBR_COMPRESS_CHANGES = 0x10000000
+DS_REPL_NBR_NO_CHANGE_NOTIFICATIONS = 0x20000000
+DS_REPL_NBR_PARTIAL_ATTRIBUTE_SET = 0x40000000
+DS_REPL_NBR_MODIFIABLE_MASK = (
+    DS_REPL_NBR_SYNC_ON_STARTUP
+    | DS_REPL_NBR_DO_SCHEDULED_SYNCS
+    | DS_REPL_NBR_TWO_WAY_SYNC
+    | DS_REPL_NBR_IGNORE_CHANGE_NOTIFICATIONS
+    | DS_REPL_NBR_DISABLE_SCHEDULED_SYNC
+    | DS_REPL_NBR_COMPRESS_CHANGES
+    | DS_REPL_NBR_NO_CHANGE_NOTIFICATIONS
+)
+
+# from enum DS_NAME_FORMAT
+DS_UNKNOWN_NAME = 0
+DS_FQDN_1779_NAME = 1
+DS_NT4_ACCOUNT_NAME = 2
+DS_DISPLAY_NAME = 3
+DS_UNIQUE_ID_NAME = 6
+DS_CANONICAL_NAME = 7
+DS_USER_PRINCIPAL_NAME = 8
+DS_CANONICAL_NAME_EX = 9
+DS_SERVICE_PRINCIPAL_NAME = 10
+DS_SID_OR_SID_HISTORY_NAME = 11
+DS_DNS_DOMAIN_NAME = 12
+
+DS_DOMAIN_SIMPLE_NAME = DS_USER_PRINCIPAL_NAME
+DS_ENTERPRISE_SIMPLE_NAME = DS_USER_PRINCIPAL_NAME
+
+# from enum DS_NAME_FLAGS
+DS_NAME_NO_FLAGS = 0x0
+DS_NAME_FLAG_SYNTACTICAL_ONLY = 0x1
+DS_NAME_FLAG_EVAL_AT_DC = 0x2
+DS_NAME_FLAG_GCVERIFY = 0x4
+DS_NAME_FLAG_TRUST_REFERRAL = 0x8
+
+# from enum DS_NAME_ERROR
+DS_NAME_NO_ERROR = 0
+DS_NAME_ERROR_RESOLVING = 1
+DS_NAME_ERROR_NOT_FOUND = 2
+DS_NAME_ERROR_NOT_UNIQUE = 3
+DS_NAME_ERROR_NO_MAPPING = 4
+DS_NAME_ERROR_DOMAIN_ONLY = 5
+DS_NAME_ERROR_NO_SYNTACTICAL_MAPPING = 6
+DS_NAME_ERROR_TRUST_REFERRAL = 7
+
+
+# from enum DS_SPN_NAME_TYPE
+DS_SPN_DNS_HOST = 0
+DS_SPN_DN_HOST = 1
+DS_SPN_NB_HOST = 2
+DS_SPN_DOMAIN = 3
+DS_SPN_NB_DOMAIN = 4
+DS_SPN_SERVICE = 5
+
+# from enum DS_SPN_WRITE_OP
+DS_SPN_ADD_SPN_OP = 0
+DS_SPN_REPLACE_SPN_OP = 1
+DS_SPN_DELETE_SPN_OP = 2
+
+# Generated by h2py from DsGetDC.h
+DS_FORCE_REDISCOVERY = 0x00000001
+DS_DIRECTORY_SERVICE_REQUIRED = 0x00000010
+DS_DIRECTORY_SERVICE_PREFERRED = 0x00000020
+DS_GC_SERVER_REQUIRED = 0x00000040
+DS_PDC_REQUIRED = 0x00000080
+DS_BACKGROUND_ONLY = 0x00000100
+DS_IP_REQUIRED = 0x00000200
+DS_KDC_REQUIRED = 0x00000400
+DS_TIMESERV_REQUIRED = 0x00000800
+DS_WRITABLE_REQUIRED = 0x00001000
+DS_GOOD_TIMESERV_PREFERRED = 0x00002000
+DS_AVOID_SELF = 0x00004000
+DS_ONLY_LDAP_NEEDED = 0x00008000
+DS_IS_FLAT_NAME = 0x00010000
+DS_IS_DNS_NAME = 0x00020000
+DS_RETURN_DNS_NAME = 0x40000000
+DS_RETURN_FLAT_NAME = -2147483648
+DSGETDC_VALID_FLAGS = (
+    DS_FORCE_REDISCOVERY
+    | DS_DIRECTORY_SERVICE_REQUIRED
+    | DS_DIRECTORY_SERVICE_PREFERRED
+    | DS_GC_SERVER_REQUIRED
+    | DS_PDC_REQUIRED
+    | DS_BACKGROUND_ONLY
+    | DS_IP_REQUIRED
+    | DS_KDC_REQUIRED
+    | DS_TIMESERV_REQUIRED
+    | DS_WRITABLE_REQUIRED
+    | DS_GOOD_TIMESERV_PREFERRED
+    | DS_AVOID_SELF
+    | DS_ONLY_LDAP_NEEDED
+    | DS_IS_FLAT_NAME
+    | DS_IS_DNS_NAME
+    | DS_RETURN_FLAT_NAME
+    | DS_RETURN_DNS_NAME
+)
+DS_INET_ADDRESS = 1
+DS_NETBIOS_ADDRESS = 2
+DS_PDC_FLAG = 0x00000001
+DS_GC_FLAG = 0x00000004
+DS_LDAP_FLAG = 0x00000008
+DS_DS_FLAG = 0x00000010
+DS_KDC_FLAG = 0x00000020
+DS_TIMESERV_FLAG = 0x00000040
+DS_CLOSEST_FLAG = 0x00000080
+DS_WRITABLE_FLAG = 0x00000100
+DS_GOOD_TIMESERV_FLAG = 0x00000200
+DS_NDNC_FLAG = 0x00000400
+DS_PING_FLAGS = 0x0000FFFF
+DS_DNS_CONTROLLER_FLAG = 0x20000000
+DS_DNS_DOMAIN_FLAG = 0x40000000
+DS_DNS_FOREST_FLAG = -2147483648
+DS_DOMAIN_IN_FOREST = 0x0001
+DS_DOMAIN_DIRECT_OUTBOUND = 0x0002
+DS_DOMAIN_TREE_ROOT = 0x0004
+DS_DOMAIN_PRIMARY = 0x0008
+DS_DOMAIN_NATIVE_MODE = 0x0010
+DS_DOMAIN_DIRECT_INBOUND = 0x0020
+DS_DOMAIN_VALID_FLAGS = (
+    DS_DOMAIN_IN_FOREST
+    | DS_DOMAIN_DIRECT_OUTBOUND
+    | DS_DOMAIN_TREE_ROOT
+    | DS_DOMAIN_PRIMARY
+    | DS_DOMAIN_NATIVE_MODE
+    | DS_DOMAIN_DIRECT_INBOUND
+)
+DS_GFTI_UPDATE_TDO = 0x1
+DS_GFTI_VALID_FLAGS = 0x1
+DS_ONLY_DO_SITE_NAME = 0x01
+DS_NOTIFY_AFTER_SITE_RECORDS = 0x02
+DS_OPEN_VALID_OPTION_FLAGS = DS_ONLY_DO_SITE_NAME | DS_NOTIFY_AFTER_SITE_RECORDS
+DS_OPEN_VALID_FLAGS = (
+    DS_FORCE_REDISCOVERY
+    | DS_ONLY_LDAP_NEEDED
+    | DS_KDC_REQUIRED
+    | DS_PDC_REQUIRED
+    | DS_GC_SERVER_REQUIRED
+    | DS_WRITABLE_REQUIRED
+)
+
+## from aclui.h
+# SI_OBJECT_INFO.dwFlags
+SI_EDIT_PERMS = 0x00000000
+SI_EDIT_OWNER = 0x00000001
+SI_EDIT_AUDITS = 0x00000002
+SI_CONTAINER = 0x00000004
+SI_READONLY = 0x00000008
+SI_ADVANCED = 0x00000010
+SI_RESET = 0x00000020
+SI_OWNER_READONLY = 0x00000040
+SI_EDIT_PROPERTIES = 0x00000080
+SI_OWNER_RECURSE = 0x00000100
+SI_NO_ACL_PROTECT = 0x00000200
+SI_NO_TREE_APPLY = 0x00000400
+SI_PAGE_TITLE = 0x00000800
+SI_SERVER_IS_DC = 0x00001000
+SI_RESET_DACL_TREE = 0x00004000
+SI_RESET_SACL_TREE = 0x00008000
+SI_OBJECT_GUID = 0x00010000
+SI_EDIT_EFFECTIVE = 0x00020000
+SI_RESET_DACL = 0x00040000
+SI_RESET_SACL = 0x00080000
+SI_RESET_OWNER = 0x00100000
+SI_NO_ADDITIONAL_PERMISSION = 0x00200000
+SI_MAY_WRITE = 0x10000000
+SI_EDIT_ALL = SI_EDIT_PERMS | SI_EDIT_OWNER | SI_EDIT_AUDITS
+SI_AUDITS_ELEVATION_REQUIRED = 0x02000000
+SI_VIEW_ONLY = 0x00400000
+SI_OWNER_ELEVATION_REQUIRED = 0x04000000
+SI_PERMS_ELEVATION_REQUIRED = 0x01000000
+
+# SI_ACCESS.dwFlags
+SI_ACCESS_SPECIFIC = 0x00010000
+SI_ACCESS_GENERAL = 0x00020000
+SI_ACCESS_CONTAINER = 0x00040000
+SI_ACCESS_PROPERTY = 0x00080000
+
+# SI_PAGE_TYPE enum
+SI_PAGE_PERM = 0
+SI_PAGE_ADVPERM = 1
+SI_PAGE_AUDIT = 2
+SI_PAGE_OWNER = 3
+SI_PAGE_EFFECTIVE = 4
+
+CFSTR_ACLUI_SID_INFO_LIST = "CFSTR_ACLUI_SID_INFO_LIST"
+PSPCB_SI_INITDIALOG = 1025  ## WM_USER+1
diff --git a/lib/win32/lib/pywin32_bootstrap.py b/lib/win32/lib/pywin32_bootstrap.py
new file mode 100644
index 00000000..fbc4f7be
--- /dev/null
+++ b/lib/win32/lib/pywin32_bootstrap.py
@@ -0,0 +1,29 @@
+# Imported by pywin32.pth to bootstrap the pywin32 environment in "portable"
+# environments or any other case where the post-install script isn't run.
+#
+# In short, there's a directory installed by pywin32 named 'pywin32_system32'
+# with some important DLLs which need to be found by Python when some pywin32
+# modules are imported.
+# If Python has `os.add_dll_directory()`, we need to call it with this path.
+# Otherwise, we add this path to PATH.
+
+
+try:
+    import pywin32_system32
+except ImportError:  # Python ≥3.6: replace ImportError with ModuleNotFoundError
+    pass
+else:
+    import os
+
+    # We're guaranteed only that __path__: Iterable[str]
+    # https://docs.python.org/3/reference/import.html#__path__
+    for path in pywin32_system32.__path__:
+        if os.path.isdir(path):
+            if hasattr(os, "add_dll_directory"):
+                os.add_dll_directory(path)
+            # This is to ensure the pywin32 path is in the beginning to find the
+            # pywin32 DLLs first and prevent other PATH entries to shadow them
+            elif not os.environ["PATH"].startswith(path):
+                os.environ["PATH"] = os.environ["PATH"].replace(os.pathsep + path, "")
+                os.environ["PATH"] = path + os.pathsep + os.environ["PATH"]
+            break
diff --git a/lib/win32/lib/pywin32_testutil.py b/lib/win32/lib/pywin32_testutil.py
new file mode 100644
index 00000000..41566a8e
--- /dev/null
+++ b/lib/win32/lib/pywin32_testutil.py
@@ -0,0 +1,327 @@
+# Utilities for the pywin32 tests
+import gc
+import os
+import site
+import sys
+import unittest
+
+import winerror
+
+##
+## General purpose utilities for the test suite.
+##
+
+
+# The test suite has lots of string constants containing binary data, but
+# the strings are used in various "bytes" contexts.
+def str2bytes(sval):
+    if sys.version_info < (3, 0) and isinstance(sval, str):
+        sval = sval.decode("latin1")
+    return sval.encode("latin1")
+
+
+# Sometimes we want to pass a string that should explicitly be treated as
+# a memory blob.
+def str2memory(sval):
+    if sys.version_info < (3, 0):
+        return buffer(sval)
+    # py3k.
+    return memoryview(sval.encode("latin1"))
+
+
+# Sometimes we want to pass an object that exposes its memory
+def ob2memory(ob):
+    if sys.version_info < (3, 0):
+        return buffer(ob)
+    # py3k.
+    return memoryview(ob)
+
+
+##
+## unittest related stuff
+##
+
+
+# This is a specialized TestCase adaptor which wraps a real test.
+class LeakTestCase(unittest.TestCase):
+    """An 'adaptor' which takes another test.  In debug builds we execute the
+    test once to remove one-off side-effects, then capture the total
+    reference count, then execute the test a few times.  If the total
+    refcount at the end is greater than we first captured, we have a leak!
+
+    In release builds the test is executed just once, as normal.
+
+    Generally used automatically by the test runner - you can safely
+    ignore this.
+    """
+
+    def __init__(self, real_test):
+        unittest.TestCase.__init__(self)
+        self.real_test = real_test
+        self.num_test_cases = 1
+        self.num_leak_iters = 2  # seems to be enough!
+        if hasattr(sys, "gettotalrefcount"):
+            self.num_test_cases = self.num_test_cases + self.num_leak_iters
+
+    def countTestCases(self):
+        return self.num_test_cases
+
+    def __call__(self, result=None):
+        # For the COM suite's sake, always ensure we don't leak
+        # gateways/interfaces
+        from pythoncom import _GetGatewayCount, _GetInterfaceCount
+
+        gc.collect()
+        ni = _GetInterfaceCount()
+        ng = _GetGatewayCount()
+        self.real_test(result)
+        # Failed - no point checking anything else
+        if result.shouldStop or not result.wasSuccessful():
+            return
+        self._do_leak_tests(result)
+        gc.collect()
+        lost_i = _GetInterfaceCount() - ni
+        lost_g = _GetGatewayCount() - ng
+        if lost_i or lost_g:
+            msg = "%d interface objects and %d gateway objects leaked" % (
+                lost_i,
+                lost_g,
+            )
+            exc = AssertionError(msg)
+            result.addFailure(self.real_test, (exc.__class__, exc, None))
+
+    def runTest(self):
+        assert 0, "not used"
+
+    def _do_leak_tests(self, result=None):
+        try:
+            gtrc = sys.gettotalrefcount
+        except AttributeError:
+            return  # can't do leak tests in this build
+        # Assume already called once, to prime any caches etc
+        gc.collect()
+        trc = gtrc()
+        for i in range(self.num_leak_iters):
+            self.real_test(result)
+            if result.shouldStop:
+                break
+        del i  # created after we remembered the refcount!
+        # int division here means one or 2 stray references won't force
+        # failure, but one per loop
+        gc.collect()
+        lost = (gtrc() - trc) // self.num_leak_iters
+        if lost < 0:
+            msg = "LeakTest: %s appeared to gain %d references!!" % (
+                self.real_test,
+                -lost,
+            )
+            result.addFailure(self.real_test, (AssertionError, msg, None))
+        if lost > 0:
+            msg = "LeakTest: %s lost %d references" % (self.real_test, lost)
+            exc = AssertionError(msg)
+            result.addFailure(self.real_test, (exc.__class__, exc, None))
+
+
+class TestLoader(unittest.TestLoader):
+    def loadTestsFromTestCase(self, testCaseClass):
+        """Return a suite of all tests cases contained in testCaseClass"""
+        leak_tests = []
+        for name in self.getTestCaseNames(testCaseClass):
+            real_test = testCaseClass(name)
+            leak_test = self._getTestWrapper(real_test)
+            leak_tests.append(leak_test)
+        return self.suiteClass(leak_tests)
+
+    def fixupTestsForLeakTests(self, test):
+        if isinstance(test, unittest.TestSuite):
+            test._tests = [self.fixupTestsForLeakTests(t) for t in test._tests]
+            return test
+        else:
+            # just a normal test case.
+            return self._getTestWrapper(test)
+
+    def _getTestWrapper(self, test):
+        # one or 2 tests in the COM test suite set this...
+        no_leak_tests = getattr(test, "no_leak_tests", False)
+        if no_leak_tests:
+            print("Test says it doesn't want leak tests!")
+            return test
+        return LeakTestCase(test)
+
+    def loadTestsFromModule(self, mod):
+        if hasattr(mod, "suite"):
+            tests = mod.suite()
+        else:
+            tests = unittest.TestLoader.loadTestsFromModule(self, mod)
+        return self.fixupTestsForLeakTests(tests)
+
+    def loadTestsFromName(self, name, module=None):
+        test = unittest.TestLoader.loadTestsFromName(self, name, module)
+        if isinstance(test, unittest.TestSuite):
+            pass  # hmmm? print "Don't wrap suites yet!", test._tests
+        elif isinstance(test, unittest.TestCase):
+            test = self._getTestWrapper(test)
+        else:
+            print("XXX - what is", test)
+        return test
+
+
+# Lots of classes necessary to support one simple feature: we want a 3rd
+# test result state - "SKIPPED" - to indicate that the test wasn't able
+# to be executed for various reasons.  Inspired by bzr's tests, but it
+# has other concepts, such as "Expected Failure", which we don't bother
+# with.
+
+# win32 error codes that probably mean we need to be elevated (ie, if we
+# aren't elevated, we treat these error codes as 'skipped')
+non_admin_error_codes = [
+    winerror.ERROR_ACCESS_DENIED,
+    winerror.ERROR_PRIVILEGE_NOT_HELD,
+]
+
+_is_admin = None
+
+
+def check_is_admin():
+    global _is_admin
+    if _is_admin is None:
+        import pythoncom
+        from win32com.shell.shell import IsUserAnAdmin
+
+        try:
+            _is_admin = IsUserAnAdmin()
+        except pythoncom.com_error as exc:
+            if exc.hresult != winerror.E_NOTIMPL:
+                raise
+            # not impl on this platform - must be old - assume is admin
+            _is_admin = True
+    return _is_admin
+
+
+# Find a test "fixture" (eg, binary test file) expected to be very close to
+# the test being run.
+# If the tests are being run from the "installed" version, then these fixtures
+# probably don't exist - the test is "skipped".
+# But it's fatal if we think we might be running from a pywin32 source tree.
+def find_test_fixture(basename, extra_dir="."):
+    # look for the test file in various places
+    candidates = [
+        os.path.dirname(sys.argv[0]),
+        extra_dir,
+        ".",
+    ]
+    for candidate in candidates:
+        fname = os.path.join(candidate, basename)
+        if os.path.isfile(fname):
+            return fname
+    else:
+        # Can't find it - see if this is expected or not.
+        # This module is typically always in the installed dir, so use argv[0]
+        this_file = os.path.normcase(os.path.abspath(sys.argv[0]))
+        dirs_to_check = site.getsitepackages()[:]
+        if site.USER_SITE:
+            dirs_to_check.append(site.USER_SITE)
+
+        for d in dirs_to_check:
+            d = os.path.normcase(d)
+            if os.path.commonprefix([this_file, d]) == d:
+                # looks like we are in an installed Python, so skip the text.
+                raise TestSkipped(f"Can't find test fixture '{fname}'")
+        # Looks like we are running from source, so this is fatal.
+        raise RuntimeError(f"Can't find test fixture '{fname}'")
+
+
+# If this exception is raised by a test, the test is reported as a 'skip'
+class TestSkipped(Exception):
+    pass
+
+
+# This appears to have been "upgraded" to non-private in 3.11
+try:
+    TextTestResult = unittest._TextTestResult
+except AttributeError:
+    TextTestResult = unittest.TextTestResult
+
+
+# The 'TestResult' subclass that records the failures and has the special
+# handling for the TestSkipped exception.
+class TestResult(TextTestResult):
+    def __init__(self, *args, **kw):
+        super(TestResult, self).__init__(*args, **kw)
+        self.skips = {}  # count of skips for each reason.
+
+    def addError(self, test, err):
+        """Called when an error has occurred. 'err' is a tuple of values as
+        returned by sys.exc_info().
+        """
+        # translate a couple of 'well-known' exceptions into 'skipped'
+        import pywintypes
+
+        exc_val = err[1]
+        # translate ERROR_ACCESS_DENIED for non-admin users to be skipped.
+        # (access denied errors for an admin user aren't expected.)
+        if (
+            isinstance(exc_val, pywintypes.error)
+            and exc_val.winerror in non_admin_error_codes
+            and not check_is_admin()
+        ):
+            exc_val = TestSkipped(exc_val)
+        # and COM errors due to objects not being registered (the com test
+        # suite will attempt to catch this and handle it itself if the user
+        # is admin)
+        elif isinstance(exc_val, pywintypes.com_error) and exc_val.hresult in [
+            winerror.CO_E_CLASSSTRING,
+            winerror.REGDB_E_CLASSNOTREG,
+            winerror.TYPE_E_LIBNOTREGISTERED,
+        ]:
+            exc_val = TestSkipped(exc_val)
+        # NotImplemented generally means the platform doesn't support the
+        # functionality.
+        elif isinstance(exc_val, NotImplementedError):
+            exc_val = TestSkipped(NotImplementedError)
+
+        if isinstance(exc_val, TestSkipped):
+            reason = exc_val.args[0]
+            # if the reason itself is another exception, get its args.
+            try:
+                reason = tuple(reason.args)
+            except (AttributeError, TypeError):
+                pass
+            self.skips.setdefault(reason, 0)
+            self.skips[reason] += 1
+            if self.showAll:
+                self.stream.writeln("SKIP (%s)" % (reason,))
+            elif self.dots:
+                self.stream.write("S")
+                self.stream.flush()
+            return
+        super(TestResult, self).addError(test, err)
+
+    def printErrors(self):
+        super(TestResult, self).printErrors()
+        for reason, num_skipped in self.skips.items():
+            self.stream.writeln("SKIPPED: %d tests - %s" % (num_skipped, reason))
+
+
+# TestRunner subclass necessary just to get our TestResult hooked up.
+class TestRunner(unittest.TextTestRunner):
+    def _makeResult(self):
+        return TestResult(self.stream, self.descriptions, self.verbosity)
+
+
+# TestProgream subclass necessary just to get our TestRunner hooked up,
+# which is necessary to get our TestResult hooked up *sob*
+class TestProgram(unittest.TestProgram):
+    def runTests(self):
+        # clobber existing runner - *sob* - it shouldn't be this hard
+        self.testRunner = TestRunner(verbosity=self.verbosity)
+        unittest.TestProgram.runTests(self)
+
+
+# A convenient entry-point - if used, 'SKIPPED' exceptions will be supressed.
+def testmain(*args, **kw):
+    new_kw = kw.copy()
+    if "testLoader" not in new_kw:
+        new_kw["testLoader"] = TestLoader()
+    program_class = new_kw.get("testProgram", TestProgram)
+    program_class(*args, **new_kw)
diff --git a/lib/win32/lib/pywintypes.py b/lib/win32/lib/pywintypes.py
new file mode 100644
index 00000000..115c4f82
--- /dev/null
+++ b/lib/win32/lib/pywintypes.py
@@ -0,0 +1,126 @@
+# Magic utility that "redirects" to pywintypesxx.dll
+import importlib.machinery
+import importlib.util
+import os
+import sys
+
+
+def __import_pywin32_system_module__(modname, globs):
+    # This has been through a number of iterations.  The problem: how to
+    # locate pywintypesXX.dll when it may be in a number of places, and how
+    # to avoid ever loading it twice.  This problem is compounded by the
+    # fact that the "right" way to do this requires win32api, but this
+    # itself requires pywintypesXX.
+    # And the killer problem is that someone may have done 'import win32api'
+    # before this code is called.  In that case Windows will have already
+    # loaded pywintypesXX as part of loading win32api - but by the time
+    # we get here, we may locate a different one.  This appears to work, but
+    # then starts raising bizarre TypeErrors complaining that something
+    # is not a pywintypes type when it clearly is!
+
+    # So in what we hope is the last major iteration of this, we now
+    # rely on a _win32sysloader module, implemented in C but not relying
+    # on pywintypesXX.dll.  It then can check if the DLL we are looking for
+    # lib is already loaded.
+    # See if this is a debug build.
+    suffix = "_d" if "_d.pyd" in importlib.machinery.EXTENSION_SUFFIXES else ""
+    filename = "%s%d%d%s.dll" % (
+        modname,
+        sys.version_info[0],
+        sys.version_info[1],
+        suffix,
+    )
+    if hasattr(sys, "frozen"):
+        # If we are running from a frozen program (py2exe, McMillan, freeze)
+        # then we try and load the DLL from our sys.path
+        # XXX - This path may also benefit from _win32sysloader?  However,
+        # MarkH has never seen the DLL load problem with py2exe programs...
+        for look in sys.path:
+            # If the sys.path entry is a (presumably) .zip file, use the
+            # directory
+            if os.path.isfile(look):
+                look = os.path.dirname(look)
+            found = os.path.join(look, filename)
+            if os.path.isfile(found):
+                break
+        else:
+            raise ImportError(
+                "Module '%s' isn't in frozen sys.path %s" % (modname, sys.path)
+            )
+    else:
+        # First see if it already in our process - if so, we must use that.
+        import _win32sysloader
+
+        found = _win32sysloader.GetModuleFilename(filename)
+        if found is None:
+            # We ask Windows to load it next.  This is in an attempt to
+            # get the exact same module loaded should pywintypes be imported
+            # first (which is how we are here) or if, eg, win32api was imported
+            # first thereby implicitly loading the DLL.
+
+            # Sadly though, it doesn't quite work - if pywintypesxx.dll
+            # is in system32 *and* the executable's directory, on XP SP2, an
+            # import of win32api will cause Windows to load pywintypes
+            # from system32, where LoadLibrary for that name will
+            # load the one in the exe's dir.
+            # That shouldn't really matter though, so long as we only ever
+            # get one loaded.
+            found = _win32sysloader.LoadModule(filename)
+        if found is None:
+            # Windows can't find it - which although isn't relevent here,
+            # means that we *must* be the first win32 import, as an attempt
+            # to import win32api etc would fail when Windows attempts to
+            # locate the DLL.
+            # This is most likely to happen for "non-admin" installs, where
+            # we can't put the files anywhere else on the global path.
+
+            # If there is a version in our Python directory, use that
+            if os.path.isfile(os.path.join(sys.prefix, filename)):
+                found = os.path.join(sys.prefix, filename)
+        if found is None:
+            # Not in the Python directory?  Maybe we were installed via
+            # easy_install...
+            if os.path.isfile(os.path.join(os.path.dirname(__file__), filename)):
+                found = os.path.join(os.path.dirname(__file__), filename)
+
+        # There are 2 site-packages directories - one "global" and one "user".
+        # We could be in either, or both (but with different versions!). Factors include
+        # virtualenvs, post-install script being run or not, `setup.py install` flags, etc.
+
+        # In a worst-case, it means, say 'python -c "import win32api"'
+        # will not work but 'python -c "import pywintypes, win32api"' will,
+        # but it's better than nothing.
+
+        # We use the same logic as pywin32_bootstrap to find potential location for the dll
+        # Simply import pywin32_system32 and look in the paths in pywin32_system32.__path__
+
+        if found is None:
+            import pywin32_system32
+
+            for path in pywin32_system32.__path__:
+                maybe = os.path.join(path, filename)
+                if os.path.isfile(maybe):
+                    found = maybe
+                    break
+
+        if found is None:
+            # give up in disgust.
+            raise ImportError("No system module '%s' (%s)" % (modname, filename))
+    # After importing the module, sys.modules is updated to the DLL we just
+    # loaded - which isn't what we want. So we update sys.modules to refer to
+    # this module, and update our globals from it.
+    old_mod = sys.modules[modname]
+    # Load the DLL.
+    loader = importlib.machinery.ExtensionFileLoader(modname, found)
+    spec = importlib.machinery.ModuleSpec(name=modname, loader=loader, origin=found)
+    mod = importlib.util.module_from_spec(spec)
+    spec.loader.exec_module(mod)
+
+    # Check the sys.modules[] behaviour we describe above is true...
+    assert sys.modules[modname] is mod
+    # as above - re-reset to the *old* module object then update globs.
+    sys.modules[modname] = old_mod
+    globs.update(mod.__dict__)
+
+
+__import_pywin32_system_module__("pywintypes", globals())
diff --git a/lib/win32/lib/rasutil.py b/lib/win32/lib/rasutil.py
new file mode 100644
index 00000000..fb71b4fc
--- /dev/null
+++ b/lib/win32/lib/rasutil.py
@@ -0,0 +1,40 @@
+import win32ras
+
+stateStrings = {
+    win32ras.RASCS_OpenPort: "OpenPort",
+    win32ras.RASCS_PortOpened: "PortOpened",
+    win32ras.RASCS_ConnectDevice: "ConnectDevice",
+    win32ras.RASCS_DeviceConnected: "DeviceConnected",
+    win32ras.RASCS_AllDevicesConnected: "AllDevicesConnected",
+    win32ras.RASCS_Authenticate: "Authenticate",
+    win32ras.RASCS_AuthNotify: "AuthNotify",
+    win32ras.RASCS_AuthRetry: "AuthRetry",
+    win32ras.RASCS_AuthCallback: "AuthCallback",
+    win32ras.RASCS_AuthChangePassword: "AuthChangePassword",
+    win32ras.RASCS_AuthProject: "AuthProject",
+    win32ras.RASCS_AuthLinkSpeed: "AuthLinkSpeed",
+    win32ras.RASCS_AuthAck: "AuthAck",
+    win32ras.RASCS_ReAuthenticate: "ReAuthenticate",
+    win32ras.RASCS_Authenticated: "Authenticated",
+    win32ras.RASCS_PrepareForCallback: "PrepareForCallback",
+    win32ras.RASCS_WaitForModemReset: "WaitForModemReset",
+    win32ras.RASCS_WaitForCallback: "WaitForCallback",
+    win32ras.RASCS_Projected: "Projected",
+    win32ras.RASCS_StartAuthentication: "StartAuthentication",
+    win32ras.RASCS_CallbackComplete: "CallbackComplete",
+    win32ras.RASCS_LogonNetwork: "LogonNetwork",
+    win32ras.RASCS_Interactive: "Interactive",
+    win32ras.RASCS_RetryAuthentication: "RetryAuthentication",
+    win32ras.RASCS_CallbackSetByCaller: "CallbackSetByCaller",
+    win32ras.RASCS_PasswordExpired: "PasswordExpired",
+    win32ras.RASCS_Connected: "Connected",
+    win32ras.RASCS_Disconnected: "Disconnected",
+}
+
+
+def TestCallback(hras, msg, state, error, exterror):
+    print("Callback called with ", hras, msg, stateStrings[state], error, exterror)
+
+
+def test(rasName="_ Divert Off"):
+    return win32ras.Dial(None, None, (rasName,), TestCallback)
diff --git a/lib/win32/lib/regcheck.py b/lib/win32/lib/regcheck.py
new file mode 100644
index 00000000..c07b77b7
--- /dev/null
+++ b/lib/win32/lib/regcheck.py
@@ -0,0 +1,162 @@
+# This module is very old and useless in this day and age!  It will be
+# removed in a few years (ie, 2009 or so...)
+
+import warnings
+
+warnings.warn(
+    "The regcheck module has been pending deprecation since build 210",
+    category=PendingDeprecationWarning,
+)
+
+import os
+import sys
+
+import regutil
+import win32api
+import win32con
+
+
+def CheckRegisteredExe(exename):
+    try:
+        os.stat(
+            win32api.RegQueryValue(
+                regutil.GetRootKey(), regutil.GetAppPathsKey() + "\\" + exename
+            )
+        )
+    # 	except SystemError:
+    except (os.error, win32api.error):
+        print("Registration of %s - Not registered correctly" % exename)
+
+
+def CheckPathString(pathString):
+    for path in pathString.split(";"):
+        if not os.path.isdir(path):
+            return "'%s' is not a valid directory!" % path
+    return None
+
+
+def CheckPythonPaths(verbose):
+    if verbose:
+        print("Python Paths:")
+    # Check the core path
+    if verbose:
+        print("\tCore Path:", end=" ")
+    try:
+        appPath = win32api.RegQueryValue(
+            regutil.GetRootKey(), regutil.BuildDefaultPythonKey() + "\\PythonPath"
+        )
+    except win32api.error as exc:
+        print("** does not exist - ", exc.strerror)
+    problem = CheckPathString(appPath)
+    if problem:
+        print(problem)
+    else:
+        if verbose:
+            print(appPath)
+
+    key = win32api.RegOpenKey(
+        regutil.GetRootKey(),
+        regutil.BuildDefaultPythonKey() + "\\PythonPath",
+        0,
+        win32con.KEY_READ,
+    )
+    try:
+        keyNo = 0
+        while 1:
+            try:
+                appName = win32api.RegEnumKey(key, keyNo)
+                appPath = win32api.RegQueryValue(key, appName)
+                if verbose:
+                    print("\t" + appName + ":", end=" ")
+                if appPath:
+                    problem = CheckPathString(appPath)
+                    if problem:
+                        print(problem)
+                    else:
+                        if verbose:
+                            print(appPath)
+                else:
+                    if verbose:
+                        print("(empty)")
+                keyNo = keyNo + 1
+            except win32api.error:
+                break
+    finally:
+        win32api.RegCloseKey(key)
+
+
+def CheckHelpFiles(verbose):
+    if verbose:
+        print("Help Files:")
+    try:
+        key = win32api.RegOpenKey(
+            regutil.GetRootKey(),
+            regutil.BuildDefaultPythonKey() + "\\Help",
+            0,
+            win32con.KEY_READ,
+        )
+    except win32api.error as exc:
+        import winerror
+
+        if exc.winerror != winerror.ERROR_FILE_NOT_FOUND:
+            raise
+        return
+
+    try:
+        keyNo = 0
+        while 1:
+            try:
+                helpDesc = win32api.RegEnumKey(key, keyNo)
+                helpFile = win32api.RegQueryValue(key, helpDesc)
+                if verbose:
+                    print("\t" + helpDesc + ":", end=" ")
+                # query the os section.
+                try:
+                    os.stat(helpFile)
+                    if verbose:
+                        print(helpFile)
+                except os.error:
+                    print("** Help file %s does not exist" % helpFile)
+                keyNo = keyNo + 1
+            except win32api.error as exc:
+                import winerror
+
+                if exc.winerror != winerror.ERROR_NO_MORE_ITEMS:
+                    raise
+                break
+    finally:
+        win32api.RegCloseKey(key)
+
+
+def CheckRegisteredModules(verbose):
+    # Check out all registered modules.
+    k = regutil.BuildDefaultPythonKey() + "\\Modules"
+    try:
+        keyhandle = win32api.RegOpenKey(regutil.GetRootKey(), k)
+        print("WARNING: 'Modules' registry entry is deprectated and evil!")
+    except win32api.error as exc:
+        import winerror
+
+        if exc.winerror != winerror.ERROR_FILE_NOT_FOUND:
+            raise
+        return
+
+
+def CheckRegistry(verbose=0):
+    # check the registered modules
+    if verbose and "pythonpath" in os.environ:
+        print("Warning - PythonPath in environment - please check it!")
+    # Check out all paths on sys.path
+
+    CheckPythonPaths(verbose)
+    CheckHelpFiles(verbose)
+    CheckRegisteredModules(verbose)
+    CheckRegisteredExe("Python.exe")
+
+
+if __name__ == "__main__":
+    if len(sys.argv) > 1 and sys.argv[1] == "-q":
+        verbose = 0
+    else:
+        verbose = 1
+    CheckRegistry(verbose)
diff --git a/lib/win32/lib/regutil.py b/lib/win32/lib/regutil.py
new file mode 100644
index 00000000..1abdd551
--- /dev/null
+++ b/lib/win32/lib/regutil.py
@@ -0,0 +1,397 @@
+# Some registry helpers.
+import os
+import sys
+
+import win32api
+import win32con
+
+error = "Registry utility error"
+
+# A .py file has a CLSID associated with it (why? - dunno!)
+CLSIDPyFile = "{b51df050-06ae-11cf-ad3b-524153480001}"
+
+RegistryIDPyFile = "Python.File"  # The registry "file type" of a .py file
+RegistryIDPycFile = "Python.CompiledFile"  # The registry "file type" of a .pyc file
+
+
+def BuildDefaultPythonKey():
+    """Builds a string containing the path to the current registry key.
+
+    The Python registry key contains the Python version.  This function
+    uses the version of the DLL used by the current process to get the
+    registry key currently in use.
+    """
+    return "Software\\Python\\PythonCore\\" + sys.winver
+
+
+def GetRootKey():
+    """Retrieves the Registry root in use by Python."""
+    keyname = BuildDefaultPythonKey()
+    try:
+        k = win32api.RegOpenKey(win32con.HKEY_CURRENT_USER, keyname)
+        k.close()
+        return win32con.HKEY_CURRENT_USER
+    except win32api.error:
+        return win32con.HKEY_LOCAL_MACHINE
+
+
+def GetRegistryDefaultValue(subkey, rootkey=None):
+    """A helper to return the default value for a key in the registry."""
+    if rootkey is None:
+        rootkey = GetRootKey()
+    return win32api.RegQueryValue(rootkey, subkey)
+
+
+def SetRegistryDefaultValue(subKey, value, rootkey=None):
+    """A helper to set the default value for a key in the registry"""
+    if rootkey is None:
+        rootkey = GetRootKey()
+    if type(value) == str:
+        typeId = win32con.REG_SZ
+    elif type(value) == int:
+        typeId = win32con.REG_DWORD
+    else:
+        raise TypeError("Value must be string or integer - was passed " + repr(value))
+
+    win32api.RegSetValue(rootkey, subKey, typeId, value)
+
+
+def GetAppPathsKey():
+    return "Software\\Microsoft\\Windows\\CurrentVersion\\App Paths"
+
+
+def RegisterPythonExe(exeFullPath, exeAlias=None, exeAppPath=None):
+    """Register a .exe file that uses Python.
+
+    Registers the .exe with the OS.  This allows the specified .exe to
+    be run from the command-line or start button without using the full path,
+    and also to setup application specific path (ie, os.environ['PATH']).
+
+    Currently the exeAppPath is not supported, so this function is general
+    purpose, and not specific to Python at all.  Later, exeAppPath may provide
+    a reasonable default that is used.
+
+    exeFullPath -- The full path to the .exe
+    exeAlias = None -- An alias for the exe - if none, the base portion
+              of the filename is used.
+    exeAppPath -- Not supported.
+    """
+    # Note - Dont work on win32s (but we dont care anymore!)
+    if exeAppPath:
+        raise error("Do not support exeAppPath argument currently")
+    if exeAlias is None:
+        exeAlias = os.path.basename(exeFullPath)
+    win32api.RegSetValue(
+        GetRootKey(), GetAppPathsKey() + "\\" + exeAlias, win32con.REG_SZ, exeFullPath
+    )
+
+
+def GetRegisteredExe(exeAlias):
+    """Get a registered .exe"""
+    return win32api.RegQueryValue(GetRootKey(), GetAppPathsKey() + "\\" + exeAlias)
+
+
+def UnregisterPythonExe(exeAlias):
+    """Unregister a .exe file that uses Python."""
+    try:
+        win32api.RegDeleteKey(GetRootKey(), GetAppPathsKey() + "\\" + exeAlias)
+    except win32api.error as exc:
+        import winerror
+
+        if exc.winerror != winerror.ERROR_FILE_NOT_FOUND:
+            raise
+        return
+
+
+def RegisterNamedPath(name, path):
+    """Register a named path - ie, a named PythonPath entry."""
+    keyStr = BuildDefaultPythonKey() + "\\PythonPath"
+    if name:
+        keyStr = keyStr + "\\" + name
+    win32api.RegSetValue(GetRootKey(), keyStr, win32con.REG_SZ, path)
+
+
+def UnregisterNamedPath(name):
+    """Unregister a named path - ie, a named PythonPath entry."""
+    keyStr = BuildDefaultPythonKey() + "\\PythonPath\\" + name
+    try:
+        win32api.RegDeleteKey(GetRootKey(), keyStr)
+    except win32api.error as exc:
+        import winerror
+
+        if exc.winerror != winerror.ERROR_FILE_NOT_FOUND:
+            raise
+        return
+
+
+def GetRegisteredNamedPath(name):
+    """Get a registered named path, or None if it doesnt exist."""
+    keyStr = BuildDefaultPythonKey() + "\\PythonPath"
+    if name:
+        keyStr = keyStr + "\\" + name
+    try:
+        return win32api.RegQueryValue(GetRootKey(), keyStr)
+    except win32api.error as exc:
+        import winerror
+
+        if exc.winerror != winerror.ERROR_FILE_NOT_FOUND:
+            raise
+        return None
+
+
+def RegisterModule(modName, modPath):
+    """Register an explicit module in the registry.  This forces the Python import
+    mechanism to locate this module directly, without a sys.path search.  Thus
+    a registered module need not appear in sys.path at all.
+
+    modName -- The name of the module, as used by import.
+    modPath -- The full path and file name of the module.
+    """
+    try:
+        import os
+
+        os.stat(modPath)
+    except os.error:
+        print("Warning: Registering non-existant module %s" % modPath)
+    win32api.RegSetValue(
+        GetRootKey(),
+        BuildDefaultPythonKey() + "\\Modules\\%s" % modName,
+        win32con.REG_SZ,
+        modPath,
+    )
+
+
+def UnregisterModule(modName):
+    """Unregister an explicit module in the registry.
+
+    modName -- The name of the module, as used by import.
+    """
+    try:
+        win32api.RegDeleteKey(
+            GetRootKey(), BuildDefaultPythonKey() + "\\Modules\\%s" % modName
+        )
+    except win32api.error as exc:
+        import winerror
+
+        if exc.winerror != winerror.ERROR_FILE_NOT_FOUND:
+            raise
+
+
+def GetRegisteredHelpFile(helpDesc):
+    """Given a description, return the registered entry."""
+    try:
+        return GetRegistryDefaultValue(BuildDefaultPythonKey() + "\\Help\\" + helpDesc)
+    except win32api.error:
+        try:
+            return GetRegistryDefaultValue(
+                BuildDefaultPythonKey() + "\\Help\\" + helpDesc,
+                win32con.HKEY_CURRENT_USER,
+            )
+        except win32api.error:
+            pass
+    return None
+
+
+def RegisterHelpFile(helpFile, helpPath, helpDesc=None, bCheckFile=1):
+    """Register a help file in the registry.
+
+      Note that this used to support writing to the Windows Help
+      key, however this is no longer done, as it seems to be incompatible.
+
+    helpFile -- the base name of the help file.
+    helpPath -- the path to the help file
+    helpDesc -- A description for the help file.  If None, the helpFile param is used.
+    bCheckFile -- A flag indicating if the file existence should be checked.
+    """
+    if helpDesc is None:
+        helpDesc = helpFile
+    fullHelpFile = os.path.join(helpPath, helpFile)
+    try:
+        if bCheckFile:
+            os.stat(fullHelpFile)
+    except os.error:
+        raise ValueError("Help file does not exist")
+    # Now register with Python itself.
+    win32api.RegSetValue(
+        GetRootKey(),
+        BuildDefaultPythonKey() + "\\Help\\%s" % helpDesc,
+        win32con.REG_SZ,
+        fullHelpFile,
+    )
+
+
+def UnregisterHelpFile(helpFile, helpDesc=None):
+    """Unregister a help file in the registry.
+
+    helpFile -- the base name of the help file.
+    helpDesc -- A description for the help file.  If None, the helpFile param is used.
+    """
+    key = win32api.RegOpenKey(
+        win32con.HKEY_LOCAL_MACHINE,
+        "Software\\Microsoft\\Windows\\Help",
+        0,
+        win32con.KEY_ALL_ACCESS,
+    )
+    try:
+        try:
+            win32api.RegDeleteValue(key, helpFile)
+        except win32api.error as exc:
+            import winerror
+
+            if exc.winerror != winerror.ERROR_FILE_NOT_FOUND:
+                raise
+    finally:
+        win32api.RegCloseKey(key)
+
+    # Now de-register with Python itself.
+    if helpDesc is None:
+        helpDesc = helpFile
+    try:
+        win32api.RegDeleteKey(
+            GetRootKey(), BuildDefaultPythonKey() + "\\Help\\%s" % helpDesc
+        )
+    except win32api.error as exc:
+        import winerror
+
+        if exc.winerror != winerror.ERROR_FILE_NOT_FOUND:
+            raise
+
+
+def RegisterCoreDLL(coredllName=None):
+    """Registers the core DLL in the registry.
+
+    If no params are passed, the name of the Python DLL used in
+    the current process is used and registered.
+    """
+    if coredllName is None:
+        coredllName = win32api.GetModuleFileName(sys.dllhandle)
+        # must exist!
+    else:
+        try:
+            os.stat(coredllName)
+        except os.error:
+            print("Warning: Registering non-existant core DLL %s" % coredllName)
+
+    hKey = win32api.RegCreateKey(GetRootKey(), BuildDefaultPythonKey())
+    try:
+        win32api.RegSetValue(hKey, "Dll", win32con.REG_SZ, coredllName)
+    finally:
+        win32api.RegCloseKey(hKey)
+    # Lastly, setup the current version to point to me.
+    win32api.RegSetValue(
+        GetRootKey(),
+        "Software\\Python\\PythonCore\\CurrentVersion",
+        win32con.REG_SZ,
+        sys.winver,
+    )
+
+
+def RegisterFileExtensions(defPyIcon, defPycIcon, runCommand):
+    """Register the core Python file extensions.
+
+    defPyIcon -- The default icon to use for .py files, in 'fname,offset' format.
+    defPycIcon -- The default icon to use for .pyc files, in 'fname,offset' format.
+    runCommand -- The command line to use for running .py files
+    """
+    # Register the file extensions.
+    pythonFileId = RegistryIDPyFile
+    win32api.RegSetValue(
+        win32con.HKEY_CLASSES_ROOT, ".py", win32con.REG_SZ, pythonFileId
+    )
+    win32api.RegSetValue(
+        win32con.HKEY_CLASSES_ROOT, pythonFileId, win32con.REG_SZ, "Python File"
+    )
+    win32api.RegSetValue(
+        win32con.HKEY_CLASSES_ROOT,
+        "%s\\CLSID" % pythonFileId,
+        win32con.REG_SZ,
+        CLSIDPyFile,
+    )
+    win32api.RegSetValue(
+        win32con.HKEY_CLASSES_ROOT,
+        "%s\\DefaultIcon" % pythonFileId,
+        win32con.REG_SZ,
+        defPyIcon,
+    )
+    base = "%s\\Shell" % RegistryIDPyFile
+    win32api.RegSetValue(
+        win32con.HKEY_CLASSES_ROOT, base + "\\Open", win32con.REG_SZ, "Run"
+    )
+    win32api.RegSetValue(
+        win32con.HKEY_CLASSES_ROOT,
+        base + "\\Open\\Command",
+        win32con.REG_SZ,
+        runCommand,
+    )
+
+    # Register the .PYC.
+    pythonFileId = RegistryIDPycFile
+    win32api.RegSetValue(
+        win32con.HKEY_CLASSES_ROOT, ".pyc", win32con.REG_SZ, pythonFileId
+    )
+    win32api.RegSetValue(
+        win32con.HKEY_CLASSES_ROOT,
+        pythonFileId,
+        win32con.REG_SZ,
+        "Compiled Python File",
+    )
+    win32api.RegSetValue(
+        win32con.HKEY_CLASSES_ROOT,
+        "%s\\DefaultIcon" % pythonFileId,
+        win32con.REG_SZ,
+        defPycIcon,
+    )
+    base = "%s\\Shell" % pythonFileId
+    win32api.RegSetValue(
+        win32con.HKEY_CLASSES_ROOT, base + "\\Open", win32con.REG_SZ, "Run"
+    )
+    win32api.RegSetValue(
+        win32con.HKEY_CLASSES_ROOT,
+        base + "\\Open\\Command",
+        win32con.REG_SZ,
+        runCommand,
+    )
+
+
+def RegisterShellCommand(shellCommand, exeCommand, shellUserCommand=None):
+    # Last param for "Open" - for a .py file to be executed by the command line
+    # or shell execute (eg, just entering "foo.py"), the Command must be "Open",
+    # but you may associate a different name for the right-click menu.
+    # In our case, normally we have "Open=Run"
+    base = "%s\\Shell" % RegistryIDPyFile
+    if shellUserCommand:
+        win32api.RegSetValue(
+            win32con.HKEY_CLASSES_ROOT,
+            base + "\\%s" % (shellCommand),
+            win32con.REG_SZ,
+            shellUserCommand,
+        )
+
+    win32api.RegSetValue(
+        win32con.HKEY_CLASSES_ROOT,
+        base + "\\%s\\Command" % (shellCommand),
+        win32con.REG_SZ,
+        exeCommand,
+    )
+
+
+def RegisterDDECommand(shellCommand, ddeApp, ddeTopic, ddeCommand):
+    base = "%s\\Shell" % RegistryIDPyFile
+    win32api.RegSetValue(
+        win32con.HKEY_CLASSES_ROOT,
+        base + "\\%s\\ddeexec" % (shellCommand),
+        win32con.REG_SZ,
+        ddeCommand,
+    )
+    win32api.RegSetValue(
+        win32con.HKEY_CLASSES_ROOT,
+        base + "\\%s\\ddeexec\\Application" % (shellCommand),
+        win32con.REG_SZ,
+        ddeApp,
+    )
+    win32api.RegSetValue(
+        win32con.HKEY_CLASSES_ROOT,
+        base + "\\%s\\ddeexec\\Topic" % (shellCommand),
+        win32con.REG_SZ,
+        ddeTopic,
+    )
diff --git a/lib/win32/lib/sspi.py b/lib/win32/lib/sspi.py
new file mode 100644
index 00000000..22c0e4a0
--- /dev/null
+++ b/lib/win32/lib/sspi.py
@@ -0,0 +1,412 @@
+"""
+Helper classes for SSPI authentication via the win32security module.
+
+SSPI authentication involves a token-exchange "dance", the exact details
+of which depends on the authentication provider used.  There are also
+a number of complex flags and constants that need to be used - in most
+cases, there are reasonable defaults.
+
+These classes attempt to hide these details from you until you really need
+to know.  They are not designed to handle all cases, just the common ones.
+If you need finer control than offered here, just use the win32security
+functions directly.
+"""
+# Based on Roger Upole's sspi demos.
+# $Id$
+import sspicon
+import win32security
+
+error = win32security.error
+
+
+class _BaseAuth(object):
+    def __init__(self):
+        self.reset()
+
+    def reset(self):
+        """Reset everything to an unauthorized state"""
+        self.ctxt = None
+        self.authenticated = False
+        self.initiator_name = None
+        self.service_name = None
+
+        # The next seq_num for an encrypt/sign operation
+        self.next_seq_num = 0
+
+    def _get_next_seq_num(self):
+        """Get the next sequence number for a transmission.  Default
+        implementation is to increment a counter
+        """
+        ret = self.next_seq_num
+        self.next_seq_num = self.next_seq_num + 1
+        return ret
+
+    def encrypt(self, data):
+        """Encrypt a string, returning a tuple of (encrypted_data, trailer).
+        These can be passed to decrypt to get back the original string.
+        """
+        pkg_size_info = self.ctxt.QueryContextAttributes(sspicon.SECPKG_ATTR_SIZES)
+        trailersize = pkg_size_info["SecurityTrailer"]
+
+        encbuf = win32security.PySecBufferDescType()
+        encbuf.append(win32security.PySecBufferType(len(data), sspicon.SECBUFFER_DATA))
+        encbuf.append(
+            win32security.PySecBufferType(trailersize, sspicon.SECBUFFER_TOKEN)
+        )
+        encbuf[0].Buffer = data
+        self.ctxt.EncryptMessage(0, encbuf, self._get_next_seq_num())
+        return encbuf[0].Buffer, encbuf[1].Buffer
+
+    def decrypt(self, data, trailer):
+        """Decrypt a previously encrypted string, returning the orignal data"""
+        encbuf = win32security.PySecBufferDescType()
+        encbuf.append(win32security.PySecBufferType(len(data), sspicon.SECBUFFER_DATA))
+        encbuf.append(
+            win32security.PySecBufferType(len(trailer), sspicon.SECBUFFER_TOKEN)
+        )
+        encbuf[0].Buffer = data
+        encbuf[1].Buffer = trailer
+        self.ctxt.DecryptMessage(encbuf, self._get_next_seq_num())
+        return encbuf[0].Buffer
+
+    def sign(self, data):
+        """sign a string suitable for transmission, returning the signature.
+        Passing the data and signature to verify will determine if the data
+        is unchanged.
+        """
+        pkg_size_info = self.ctxt.QueryContextAttributes(sspicon.SECPKG_ATTR_SIZES)
+        sigsize = pkg_size_info["MaxSignature"]
+        sigbuf = win32security.PySecBufferDescType()
+        sigbuf.append(win32security.PySecBufferType(len(data), sspicon.SECBUFFER_DATA))
+        sigbuf.append(win32security.PySecBufferType(sigsize, sspicon.SECBUFFER_TOKEN))
+        sigbuf[0].Buffer = data
+
+        self.ctxt.MakeSignature(0, sigbuf, self._get_next_seq_num())
+        return sigbuf[1].Buffer
+
+    def verify(self, data, sig):
+        """Verifies data and its signature.  If verification fails, an sspi.error
+        will be raised.
+        """
+        sigbuf = win32security.PySecBufferDescType()
+        sigbuf.append(win32security.PySecBufferType(len(data), sspicon.SECBUFFER_DATA))
+        sigbuf.append(win32security.PySecBufferType(len(sig), sspicon.SECBUFFER_TOKEN))
+
+        sigbuf[0].Buffer = data
+        sigbuf[1].Buffer = sig
+        self.ctxt.VerifySignature(sigbuf, self._get_next_seq_num())
+
+    def unwrap(self, token):
+        """
+        GSSAPI's unwrap with SSPI.
+        https://docs.microsoft.com/en-us/windows/win32/secauthn/sspi-kerberos-interoperability-with-gssapi
+
+        Usable mainly with Kerberos SSPI package, but this is not enforced.
+
+        Return the clear text, and a boolean that is True if the token was encrypted.
+        """
+        buffer = win32security.PySecBufferDescType()
+        # This buffer will contain a "stream", which is the token coming from the other side
+        buffer.append(
+            win32security.PySecBufferType(len(token), sspicon.SECBUFFER_STREAM)
+        )
+        buffer[0].Buffer = token
+
+        # This buffer will receive the clear, or just unwrapped text if no encryption was used.
+        # Will be resized by the lib.
+        buffer.append(win32security.PySecBufferType(0, sspicon.SECBUFFER_DATA))
+
+        pfQOP = self.ctxt.DecryptMessage(buffer, self._get_next_seq_num())
+
+        r = buffer[1].Buffer
+        return r, not (pfQOP == sspicon.SECQOP_WRAP_NO_ENCRYPT)
+
+    def wrap(self, msg, encrypt=False):
+        """
+        GSSAPI's wrap with SSPI.
+        https://docs.microsoft.com/en-us/windows/win32/secauthn/sspi-kerberos-interoperability-with-gssapi
+
+        Usable mainly with Kerberos SSPI package, but this is not enforced.
+
+        Wrap a message to be sent to the other side. Encrypted if encrypt is True.
+        """
+
+        size_info = self.ctxt.QueryContextAttributes(sspicon.SECPKG_ATTR_SIZES)
+        trailer_size = size_info["SecurityTrailer"]
+        block_size = size_info["BlockSize"]
+
+        buffer = win32security.PySecBufferDescType()
+
+        # This buffer will contain unencrypted data to wrap, and maybe encrypt.
+        buffer.append(win32security.PySecBufferType(len(msg), sspicon.SECBUFFER_DATA))
+        buffer[0].Buffer = msg
+
+        # Will receive the token that forms the beginning of the msg
+        buffer.append(
+            win32security.PySecBufferType(trailer_size, sspicon.SECBUFFER_TOKEN)
+        )
+
+        # The trailer is needed in case of block encryption
+        buffer.append(
+            win32security.PySecBufferType(block_size, sspicon.SECBUFFER_PADDING)
+        )
+
+        fQOP = 0 if encrypt else sspicon.SECQOP_WRAP_NO_ENCRYPT
+        self.ctxt.EncryptMessage(fQOP, buffer, self._get_next_seq_num())
+
+        # Sec token, then data, then padding
+        r = buffer[1].Buffer + buffer[0].Buffer + buffer[2].Buffer
+        return r
+
+    def _amend_ctx_name(self):
+        """Adds initiator and service names in the security context for ease of use"""
+        if not self.authenticated:
+            raise ValueError("Sec context is not completely authenticated")
+
+        try:
+            names = self.ctxt.QueryContextAttributes(sspicon.SECPKG_ATTR_NATIVE_NAMES)
+        except error:
+            # The SSP doesn't provide these attributes.
+            pass
+        else:
+            self.initiator_name, self.service_name = names
+
+
+class ClientAuth(_BaseAuth):
+    """Manages the client side of an SSPI authentication handshake"""
+
+    def __init__(
+        self,
+        pkg_name,  # Name of the package to used.
+        client_name=None,  # User for whom credentials are used.
+        auth_info=None,  # or a tuple of (username, domain, password)
+        targetspn=None,  # Target security context provider name.
+        scflags=None,  # security context flags
+        datarep=sspicon.SECURITY_NETWORK_DREP,
+    ):
+        if scflags is None:
+            scflags = (
+                sspicon.ISC_REQ_INTEGRITY
+                | sspicon.ISC_REQ_SEQUENCE_DETECT
+                | sspicon.ISC_REQ_REPLAY_DETECT
+                | sspicon.ISC_REQ_CONFIDENTIALITY
+            )
+        self.scflags = scflags
+        self.datarep = datarep
+        self.targetspn = targetspn
+        self.pkg_info = win32security.QuerySecurityPackageInfo(pkg_name)
+        (
+            self.credentials,
+            self.credentials_expiry,
+        ) = win32security.AcquireCredentialsHandle(
+            client_name,
+            self.pkg_info["Name"],
+            sspicon.SECPKG_CRED_OUTBOUND,
+            None,
+            auth_info,
+        )
+        _BaseAuth.__init__(self)
+
+    def authorize(self, sec_buffer_in):
+        """Perform *one* step of the client authentication process. Pass None for the first round"""
+        if (
+            sec_buffer_in is not None
+            and type(sec_buffer_in) != win32security.PySecBufferDescType
+        ):
+            # User passed us the raw data - wrap it into a SecBufferDesc
+            sec_buffer_new = win32security.PySecBufferDescType()
+            tokenbuf = win32security.PySecBufferType(
+                self.pkg_info["MaxToken"], sspicon.SECBUFFER_TOKEN
+            )
+            tokenbuf.Buffer = sec_buffer_in
+            sec_buffer_new.append(tokenbuf)
+            sec_buffer_in = sec_buffer_new
+        sec_buffer_out = win32security.PySecBufferDescType()
+        tokenbuf = win32security.PySecBufferType(
+            self.pkg_info["MaxToken"], sspicon.SECBUFFER_TOKEN
+        )
+        sec_buffer_out.append(tokenbuf)
+        ## input context handle should be NULL on first call
+        ctxtin = self.ctxt
+        if self.ctxt is None:
+            self.ctxt = win32security.PyCtxtHandleType()
+        err, attr, exp = win32security.InitializeSecurityContext(
+            self.credentials,
+            ctxtin,
+            self.targetspn,
+            self.scflags,
+            self.datarep,
+            sec_buffer_in,
+            self.ctxt,
+            sec_buffer_out,
+        )
+        # Stash these away incase someone needs to know the state from the
+        # final call.
+        self.ctxt_attr = attr
+        self.ctxt_expiry = exp
+
+        if err in (sspicon.SEC_I_COMPLETE_NEEDED, sspicon.SEC_I_COMPLETE_AND_CONTINUE):
+            self.ctxt.CompleteAuthToken(sec_buffer_out)
+
+        self.authenticated = err == 0
+        if self.authenticated:
+            self._amend_ctx_name()
+
+        return err, sec_buffer_out
+
+
+class ServerAuth(_BaseAuth):
+    """Manages the server side of an SSPI authentication handshake"""
+
+    def __init__(
+        self, pkg_name, spn=None, scflags=None, datarep=sspicon.SECURITY_NETWORK_DREP
+    ):
+        self.spn = spn
+        self.datarep = datarep
+
+        if scflags is None:
+            scflags = (
+                sspicon.ASC_REQ_INTEGRITY
+                | sspicon.ASC_REQ_SEQUENCE_DETECT
+                | sspicon.ASC_REQ_REPLAY_DETECT
+                | sspicon.ASC_REQ_CONFIDENTIALITY
+            )
+        # Should we default to sspicon.KerbAddExtraCredentialsMessage
+        # if pkg_name=='Kerberos'?
+        self.scflags = scflags
+
+        self.pkg_info = win32security.QuerySecurityPackageInfo(pkg_name)
+
+        (
+            self.credentials,
+            self.credentials_expiry,
+        ) = win32security.AcquireCredentialsHandle(
+            spn, self.pkg_info["Name"], sspicon.SECPKG_CRED_INBOUND, None, None
+        )
+        _BaseAuth.__init__(self)
+
+    def authorize(self, sec_buffer_in):
+        """Perform *one* step of the server authentication process."""
+        if (
+            sec_buffer_in is not None
+            and type(sec_buffer_in) != win32security.PySecBufferDescType
+        ):
+            # User passed us the raw data - wrap it into a SecBufferDesc
+            sec_buffer_new = win32security.PySecBufferDescType()
+            tokenbuf = win32security.PySecBufferType(
+                self.pkg_info["MaxToken"], sspicon.SECBUFFER_TOKEN
+            )
+            tokenbuf.Buffer = sec_buffer_in
+            sec_buffer_new.append(tokenbuf)
+            sec_buffer_in = sec_buffer_new
+
+        sec_buffer_out = win32security.PySecBufferDescType()
+        tokenbuf = win32security.PySecBufferType(
+            self.pkg_info["MaxToken"], sspicon.SECBUFFER_TOKEN
+        )
+        sec_buffer_out.append(tokenbuf)
+        ## input context handle is None initially, then handle returned from last call thereafter
+        ctxtin = self.ctxt
+        if self.ctxt is None:
+            self.ctxt = win32security.PyCtxtHandleType()
+        err, attr, exp = win32security.AcceptSecurityContext(
+            self.credentials,
+            ctxtin,
+            sec_buffer_in,
+            self.scflags,
+            self.datarep,
+            self.ctxt,
+            sec_buffer_out,
+        )
+
+        # Stash these away incase someone needs to know the state from the
+        # final call.
+        self.ctxt_attr = attr
+        self.ctxt_expiry = exp
+
+        if err in (sspicon.SEC_I_COMPLETE_NEEDED, sspicon.SEC_I_COMPLETE_AND_CONTINUE):
+            self.ctxt.CompleteAuthToken(sec_buffer_out)
+
+        self.authenticated = err == 0
+        if self.authenticated:
+            self._amend_ctx_name()
+
+        return err, sec_buffer_out
+
+
+if __name__ == "__main__":
+    # This is the security package (the security support provider / the security backend)
+    # we want to use for this example.
+    ssp = "Kerberos"  # or "NTLM" or "Negotiate" which enable negotiation between
+    # Kerberos (prefered) and NTLM (if not supported on the other side).
+
+    flags = (
+        sspicon.ISC_REQ_MUTUAL_AUTH
+        | sspicon.ISC_REQ_INTEGRITY  # mutual authentication
+        | sspicon.ISC_REQ_SEQUENCE_DETECT  # check for integrity
+        | sspicon.ISC_REQ_CONFIDENTIALITY  # enable out-of-order messages
+        | sspicon.ISC_REQ_REPLAY_DETECT  # request confidentiality  # request replay detection
+    )
+
+    # Get our identity, mandatory for the Kerberos case *for this example*
+    # Kerberos cannot be used if we don't tell it the target we want
+    # to authenticate to.
+    cred_handle, exp = win32security.AcquireCredentialsHandle(
+        None, ssp, sspicon.SECPKG_CRED_INBOUND, None, None
+    )
+    cred = cred_handle.QueryCredentialsAttributes(sspicon.SECPKG_CRED_ATTR_NAMES)
+    print("We are:", cred)
+
+    # Setup the 2 contexts. In real life, only one is needed: the other one is
+    # created in the process we want to communicate with.
+    sspiclient = ClientAuth(ssp, scflags=flags, targetspn=cred)
+    sspiserver = ServerAuth(ssp, scflags=flags)
+
+    print(
+        "SSP : %s (%s)" % (sspiclient.pkg_info["Name"], sspiclient.pkg_info["Comment"])
+    )
+
+    # Perform the authentication dance, each loop exchanging more information
+    # on the way to completing authentication.
+    sec_buffer = None
+    client_step = 0
+    server_step = 0
+    while not (sspiclient.authenticated) or len(sec_buffer[0].Buffer):
+        client_step += 1
+        err, sec_buffer = sspiclient.authorize(sec_buffer)
+        print("Client step %s" % client_step)
+        if sspiserver.authenticated and len(sec_buffer[0].Buffer) == 0:
+            break
+
+        server_step += 1
+        err, sec_buffer = sspiserver.authorize(sec_buffer)
+        print("Server step %s" % server_step)
+
+    # Authentication process is finished.
+    print("Initiator name from the service side:", sspiserver.initiator_name)
+    print("Service name from the client side:   ", sspiclient.service_name)
+
+    data = "hello".encode("ascii")  # py3k-friendly
+
+    # Simple signature, not compatible with GSSAPI.
+    sig = sspiclient.sign(data)
+    sspiserver.verify(data, sig)
+
+    # Encryption
+    encrypted, sig = sspiclient.encrypt(data)
+    decrypted = sspiserver.decrypt(encrypted, sig)
+    assert decrypted == data
+
+    # GSSAPI wrapping, no encryption (NTLM always encrypts)
+    wrapped = sspiclient.wrap(data)
+    unwrapped, was_encrypted = sspiserver.unwrap(wrapped)
+    print("encrypted ?", was_encrypted)
+    assert data == unwrapped
+
+    # GSSAPI wrapping, with encryption
+    wrapped = sspiserver.wrap(data, encrypt=True)
+    unwrapped, was_encrypted = sspiclient.unwrap(wrapped)
+    print("encrypted ?", was_encrypted)
+    assert data == unwrapped
+
+    print("cool!")
diff --git a/lib/win32/lib/sspicon.py b/lib/win32/lib/sspicon.py
new file mode 100644
index 00000000..12f7482d
--- /dev/null
+++ b/lib/win32/lib/sspicon.py
@@ -0,0 +1,477 @@
+# Generated by h2py from c:\microsoft sdk\include\sspi.h
+ISSP_LEVEL = 32
+ISSP_MODE = 1
+
+
+def SEC_SUCCESS(Status):
+    return (Status) >= 0
+
+
+SECPKG_FLAG_INTEGRITY = 1
+SECPKG_FLAG_PRIVACY = 2
+SECPKG_FLAG_TOKEN_ONLY = 4
+SECPKG_FLAG_DATAGRAM = 8
+SECPKG_FLAG_CONNECTION = 16
+SECPKG_FLAG_MULTI_REQUIRED = 32
+SECPKG_FLAG_CLIENT_ONLY = 64
+SECPKG_FLAG_EXTENDED_ERROR = 128
+SECPKG_FLAG_IMPERSONATION = 256
+SECPKG_FLAG_ACCEPT_WIN32_NAME = 512
+SECPKG_FLAG_STREAM = 1024
+SECPKG_FLAG_NEGOTIABLE = 2048
+SECPKG_FLAG_GSS_COMPATIBLE = 4096
+SECPKG_FLAG_LOGON = 8192
+SECPKG_FLAG_ASCII_BUFFERS = 16384
+SECPKG_FLAG_FRAGMENT = 32768
+SECPKG_FLAG_MUTUAL_AUTH = 65536
+SECPKG_FLAG_DELEGATION = 131072
+SECPKG_FLAG_READONLY_WITH_CHECKSUM = 262144
+SECPKG_ID_NONE = 65535
+
+SECBUFFER_VERSION = 0
+SECBUFFER_EMPTY = 0
+SECBUFFER_DATA = 1
+SECBUFFER_TOKEN = 2
+SECBUFFER_PKG_PARAMS = 3
+SECBUFFER_MISSING = 4
+SECBUFFER_EXTRA = 5
+SECBUFFER_STREAM_TRAILER = 6
+SECBUFFER_STREAM_HEADER = 7
+SECBUFFER_NEGOTIATION_INFO = 8
+SECBUFFER_PADDING = 9
+SECBUFFER_STREAM = 10
+SECBUFFER_MECHLIST = 11
+SECBUFFER_MECHLIST_SIGNATURE = 12
+SECBUFFER_TARGET = 13
+SECBUFFER_CHANNEL_BINDINGS = 14
+SECBUFFER_ATTRMASK = -268435456
+SECBUFFER_READONLY = -2147483648
+SECBUFFER_READONLY_WITH_CHECKSUM = 268435456
+SECBUFFER_RESERVED = 1610612736
+
+SECURITY_NATIVE_DREP = 16
+SECURITY_NETWORK_DREP = 0
+
+SECPKG_CRED_INBOUND = 1
+SECPKG_CRED_OUTBOUND = 2
+SECPKG_CRED_BOTH = 3
+SECPKG_CRED_DEFAULT = 4
+SECPKG_CRED_RESERVED = -268435456
+
+ISC_REQ_DELEGATE = 1
+ISC_REQ_MUTUAL_AUTH = 2
+ISC_REQ_REPLAY_DETECT = 4
+ISC_REQ_SEQUENCE_DETECT = 8
+ISC_REQ_CONFIDENTIALITY = 16
+ISC_REQ_USE_SESSION_KEY = 32
+ISC_REQ_PROMPT_FOR_CREDS = 64
+ISC_REQ_USE_SUPPLIED_CREDS = 128
+ISC_REQ_ALLOCATE_MEMORY = 256
+ISC_REQ_USE_DCE_STYLE = 512
+ISC_REQ_DATAGRAM = 1024
+ISC_REQ_CONNECTION = 2048
+ISC_REQ_CALL_LEVEL = 4096
+ISC_REQ_FRAGMENT_SUPPLIED = 8192
+ISC_REQ_EXTENDED_ERROR = 16384
+ISC_REQ_STREAM = 32768
+ISC_REQ_INTEGRITY = 65536
+ISC_REQ_IDENTIFY = 131072
+ISC_REQ_NULL_SESSION = 262144
+ISC_REQ_MANUAL_CRED_VALIDATION = 524288
+ISC_REQ_RESERVED1 = 1048576
+ISC_REQ_FRAGMENT_TO_FIT = 2097152
+ISC_REQ_HTTP = 0x10000000
+ISC_RET_DELEGATE = 1
+ISC_RET_MUTUAL_AUTH = 2
+ISC_RET_REPLAY_DETECT = 4
+ISC_RET_SEQUENCE_DETECT = 8
+ISC_RET_CONFIDENTIALITY = 16
+ISC_RET_USE_SESSION_KEY = 32
+ISC_RET_USED_COLLECTED_CREDS = 64
+ISC_RET_USED_SUPPLIED_CREDS = 128
+ISC_RET_ALLOCATED_MEMORY = 256
+ISC_RET_USED_DCE_STYLE = 512
+ISC_RET_DATAGRAM = 1024
+ISC_RET_CONNECTION = 2048
+ISC_RET_INTERMEDIATE_RETURN = 4096
+ISC_RET_CALL_LEVEL = 8192
+ISC_RET_EXTENDED_ERROR = 16384
+ISC_RET_STREAM = 32768
+ISC_RET_INTEGRITY = 65536
+ISC_RET_IDENTIFY = 131072
+ISC_RET_NULL_SESSION = 262144
+ISC_RET_MANUAL_CRED_VALIDATION = 524288
+ISC_RET_RESERVED1 = 1048576
+ISC_RET_FRAGMENT_ONLY = 2097152
+
+ASC_REQ_DELEGATE = 1
+ASC_REQ_MUTUAL_AUTH = 2
+ASC_REQ_REPLAY_DETECT = 4
+ASC_REQ_SEQUENCE_DETECT = 8
+ASC_REQ_CONFIDENTIALITY = 16
+ASC_REQ_USE_SESSION_KEY = 32
+ASC_REQ_ALLOCATE_MEMORY = 256
+ASC_REQ_USE_DCE_STYLE = 512
+ASC_REQ_DATAGRAM = 1024
+ASC_REQ_CONNECTION = 2048
+ASC_REQ_CALL_LEVEL = 4096
+ASC_REQ_EXTENDED_ERROR = 32768
+ASC_REQ_STREAM = 65536
+ASC_REQ_INTEGRITY = 131072
+ASC_REQ_LICENSING = 262144
+ASC_REQ_IDENTIFY = 524288
+ASC_REQ_ALLOW_NULL_SESSION = 1048576
+ASC_REQ_ALLOW_NON_USER_LOGONS = 2097152
+ASC_REQ_ALLOW_CONTEXT_REPLAY = 4194304
+ASC_REQ_FRAGMENT_TO_FIT = 8388608
+ASC_REQ_FRAGMENT_SUPPLIED = 8192
+ASC_REQ_NO_TOKEN = 16777216
+ASC_RET_DELEGATE = 1
+ASC_RET_MUTUAL_AUTH = 2
+ASC_RET_REPLAY_DETECT = 4
+ASC_RET_SEQUENCE_DETECT = 8
+ASC_RET_CONFIDENTIALITY = 16
+ASC_RET_USE_SESSION_KEY = 32
+ASC_RET_ALLOCATED_MEMORY = 256
+ASC_RET_USED_DCE_STYLE = 512
+ASC_RET_DATAGRAM = 1024
+ASC_RET_CONNECTION = 2048
+ASC_RET_CALL_LEVEL = 8192
+ASC_RET_THIRD_LEG_FAILED = 16384
+ASC_RET_EXTENDED_ERROR = 32768
+ASC_RET_STREAM = 65536
+ASC_RET_INTEGRITY = 131072
+ASC_RET_LICENSING = 262144
+ASC_RET_IDENTIFY = 524288
+ASC_RET_NULL_SESSION = 1048576
+ASC_RET_ALLOW_NON_USER_LOGONS = 2097152
+ASC_RET_ALLOW_CONTEXT_REPLAY = 4194304
+ASC_RET_FRAGMENT_ONLY = 8388608
+
+SECPKG_CRED_ATTR_NAMES = 1
+SECPKG_ATTR_SIZES = 0
+SECPKG_ATTR_NAMES = 1
+SECPKG_ATTR_LIFESPAN = 2
+SECPKG_ATTR_DCE_INFO = 3
+SECPKG_ATTR_STREAM_SIZES = 4
+SECPKG_ATTR_KEY_INFO = 5
+SECPKG_ATTR_AUTHORITY = 6
+SECPKG_ATTR_PROTO_INFO = 7
+SECPKG_ATTR_PASSWORD_EXPIRY = 8
+SECPKG_ATTR_SESSION_KEY = 9
+SECPKG_ATTR_PACKAGE_INFO = 10
+SECPKG_ATTR_USER_FLAGS = 11
+SECPKG_ATTR_NEGOTIATION_INFO = 12
+SECPKG_ATTR_NATIVE_NAMES = 13
+SECPKG_ATTR_FLAGS = 14
+SECPKG_ATTR_USE_VALIDATED = 15
+SECPKG_ATTR_CREDENTIAL_NAME = 16
+SECPKG_ATTR_TARGET_INFORMATION = 17
+SECPKG_ATTR_ACCESS_TOKEN = 18
+SECPKG_ATTR_TARGET = 19
+SECPKG_ATTR_AUTHENTICATION_ID = 20
+
+## attributes from schannel.h
+SECPKG_ATTR_REMOTE_CERT_CONTEXT = 83
+SECPKG_ATTR_LOCAL_CERT_CONTEXT = 84
+SECPKG_ATTR_ROOT_STORE = 85
+SECPKG_ATTR_SUPPORTED_ALGS = 86
+SECPKG_ATTR_CIPHER_STRENGTHS = 87
+SECPKG_ATTR_SUPPORTED_PROTOCOLS = 88
+SECPKG_ATTR_ISSUER_LIST_EX = 89
+SECPKG_ATTR_CONNECTION_INFO = 90
+SECPKG_ATTR_EAP_KEY_BLOCK = 91
+SECPKG_ATTR_MAPPED_CRED_ATTR = 92
+SECPKG_ATTR_SESSION_INFO = 93
+SECPKG_ATTR_APP_DATA = 94
+
+SECPKG_NEGOTIATION_COMPLETE = 0
+SECPKG_NEGOTIATION_OPTIMISTIC = 1
+SECPKG_NEGOTIATION_IN_PROGRESS = 2
+SECPKG_NEGOTIATION_DIRECT = 3
+SECPKG_NEGOTIATION_TRY_MULTICRED = 4
+SECPKG_CONTEXT_EXPORT_RESET_NEW = 1
+SECPKG_CONTEXT_EXPORT_DELETE_OLD = 2
+SECQOP_WRAP_NO_ENCRYPT = -2147483647
+SECURITY_ENTRYPOINT_ANSIW = "InitSecurityInterfaceW"
+SECURITY_ENTRYPOINT_ANSIA = "InitSecurityInterfaceA"
+SECURITY_ENTRYPOINT16 = "INITSECURITYINTERFACEA"
+SECURITY_ENTRYPOINT = SECURITY_ENTRYPOINT16
+SECURITY_ENTRYPOINT_ANSI = SECURITY_ENTRYPOINT16
+SECURITY_SUPPORT_PROVIDER_INTERFACE_VERSION = 1
+SECURITY_SUPPORT_PROVIDER_INTERFACE_VERSION_2 = 2
+SASL_OPTION_SEND_SIZE = 1
+SASL_OPTION_RECV_SIZE = 2
+SASL_OPTION_AUTHZ_STRING = 3
+SASL_OPTION_AUTHZ_PROCESSING = 4
+SEC_WINNT_AUTH_IDENTITY_ANSI = 1
+SEC_WINNT_AUTH_IDENTITY_UNICODE = 2
+SEC_WINNT_AUTH_IDENTITY_VERSION = 512
+SEC_WINNT_AUTH_IDENTITY_MARSHALLED = 4
+SEC_WINNT_AUTH_IDENTITY_ONLY = 8
+SECPKG_OPTIONS_TYPE_UNKNOWN = 0
+SECPKG_OPTIONS_TYPE_LSA = 1
+SECPKG_OPTIONS_TYPE_SSPI = 2
+SECPKG_OPTIONS_PERMANENT = 1
+
+SEC_E_INSUFFICIENT_MEMORY = -2146893056
+SEC_E_INVALID_HANDLE = -2146893055
+SEC_E_UNSUPPORTED_FUNCTION = -2146893054
+SEC_E_TARGET_UNKNOWN = -2146893053
+SEC_E_INTERNAL_ERROR = -2146893052
+SEC_E_SECPKG_NOT_FOUND = -2146893051
+SEC_E_NOT_OWNER = -2146893050
+SEC_E_CANNOT_INSTALL = -2146893049
+SEC_E_INVALID_TOKEN = -2146893048
+SEC_E_CANNOT_PACK = -2146893047
+SEC_E_QOP_NOT_SUPPORTED = -2146893046
+SEC_E_NO_IMPERSONATION = -2146893045
+SEC_E_LOGON_DENIED = -2146893044
+SEC_E_UNKNOWN_CREDENTIALS = -2146893043
+SEC_E_NO_CREDENTIALS = -2146893042
+SEC_E_MESSAGE_ALTERED = -2146893041
+SEC_E_OUT_OF_SEQUENCE = -2146893040
+SEC_E_NO_AUTHENTICATING_AUTHORITY = -2146893039
+SEC_I_CONTINUE_NEEDED = 590610
+SEC_I_COMPLETE_NEEDED = 590611
+SEC_I_COMPLETE_AND_CONTINUE = 590612
+SEC_I_LOCAL_LOGON = 590613
+SEC_E_BAD_PKGID = -2146893034
+SEC_E_CONTEXT_EXPIRED = -2146893033
+SEC_I_CONTEXT_EXPIRED = 590615
+SEC_E_INCOMPLETE_MESSAGE = -2146893032
+SEC_E_INCOMPLETE_CREDENTIALS = -2146893024
+SEC_E_BUFFER_TOO_SMALL = -2146893023
+SEC_I_INCOMPLETE_CREDENTIALS = 590624
+SEC_I_RENEGOTIATE = 590625
+SEC_E_WRONG_PRINCIPAL = -2146893022
+SEC_I_NO_LSA_CONTEXT = 590627
+SEC_E_TIME_SKEW = -2146893020
+SEC_E_UNTRUSTED_ROOT = -2146893019
+SEC_E_ILLEGAL_MESSAGE = -2146893018
+SEC_E_CERT_UNKNOWN = -2146893017
+SEC_E_CERT_EXPIRED = -2146893016
+SEC_E_ENCRYPT_FAILURE = -2146893015
+SEC_E_DECRYPT_FAILURE = -2146893008
+SEC_E_ALGORITHM_MISMATCH = -2146893007
+SEC_E_SECURITY_QOS_FAILED = -2146893006
+SEC_E_UNFINISHED_CONTEXT_DELETED = -2146893005
+SEC_E_NO_TGT_REPLY = -2146893004
+SEC_E_NO_IP_ADDRESSES = -2146893003
+SEC_E_WRONG_CREDENTIAL_HANDLE = -2146893002
+SEC_E_CRYPTO_SYSTEM_INVALID = -2146893001
+SEC_E_MAX_REFERRALS_EXCEEDED = -2146893000
+SEC_E_MUST_BE_KDC = -2146892999
+SEC_E_STRONG_CRYPTO_NOT_SUPPORTED = -2146892998
+SEC_E_TOO_MANY_PRINCIPALS = -2146892997
+SEC_E_NO_PA_DATA = -2146892996
+SEC_E_PKINIT_NAME_MISMATCH = -2146892995
+SEC_E_SMARTCARD_LOGON_REQUIRED = -2146892994
+SEC_E_SHUTDOWN_IN_PROGRESS = -2146892993
+SEC_E_KDC_INVALID_REQUEST = -2146892992
+SEC_E_KDC_UNABLE_TO_REFER = -2146892991
+SEC_E_KDC_UNKNOWN_ETYPE = -2146892990
+SEC_E_UNSUPPORTED_PREAUTH = -2146892989
+SEC_E_DELEGATION_REQUIRED = -2146892987
+SEC_E_BAD_BINDINGS = -2146892986
+SEC_E_MULTIPLE_ACCOUNTS = -2146892985
+SEC_E_NO_KERB_KEY = -2146892984
+
+ERROR_IPSEC_QM_POLICY_EXISTS = 13000
+ERROR_IPSEC_QM_POLICY_NOT_FOUND = 13001
+ERROR_IPSEC_QM_POLICY_IN_USE = 13002
+ERROR_IPSEC_MM_POLICY_EXISTS = 13003
+ERROR_IPSEC_MM_POLICY_NOT_FOUND = 13004
+ERROR_IPSEC_MM_POLICY_IN_USE = 13005
+ERROR_IPSEC_MM_FILTER_EXISTS = 13006
+ERROR_IPSEC_MM_FILTER_NOT_FOUND = 13007
+ERROR_IPSEC_TRANSPORT_FILTER_EXISTS = 13008
+ERROR_IPSEC_TRANSPORT_FILTER_NOT_FOUND = 13009
+ERROR_IPSEC_MM_AUTH_EXISTS = 13010
+ERROR_IPSEC_MM_AUTH_NOT_FOUND = 13011
+ERROR_IPSEC_MM_AUTH_IN_USE = 13012
+ERROR_IPSEC_DEFAULT_MM_POLICY_NOT_FOUND = 13013
+ERROR_IPSEC_DEFAULT_MM_AUTH_NOT_FOUND = 13014
+ERROR_IPSEC_DEFAULT_QM_POLICY_NOT_FOUND = 13015
+ERROR_IPSEC_TUNNEL_FILTER_EXISTS = 13016
+ERROR_IPSEC_TUNNEL_FILTER_NOT_FOUND = 13017
+ERROR_IPSEC_MM_FILTER_PENDING_DELETION = 13018
+ERROR_IPSEC_TRANSPORT_FILTER_PENDING_DELETION = 13019
+ERROR_IPSEC_TUNNEL_FILTER_PENDING_DELETION = 13020
+ERROR_IPSEC_MM_POLICY_PENDING_DELETION = 13021
+ERROR_IPSEC_MM_AUTH_PENDING_DELETION = 13022
+ERROR_IPSEC_QM_POLICY_PENDING_DELETION = 13023
+WARNING_IPSEC_MM_POLICY_PRUNED = 13024
+WARNING_IPSEC_QM_POLICY_PRUNED = 13025
+ERROR_IPSEC_IKE_NEG_STATUS_BEGIN = 13800
+ERROR_IPSEC_IKE_AUTH_FAIL = 13801
+ERROR_IPSEC_IKE_ATTRIB_FAIL = 13802
+ERROR_IPSEC_IKE_NEGOTIATION_PENDING = 13803
+ERROR_IPSEC_IKE_GENERAL_PROCESSING_ERROR = 13804
+ERROR_IPSEC_IKE_TIMED_OUT = 13805
+ERROR_IPSEC_IKE_NO_CERT = 13806
+ERROR_IPSEC_IKE_SA_DELETED = 13807
+ERROR_IPSEC_IKE_SA_REAPED = 13808
+ERROR_IPSEC_IKE_MM_ACQUIRE_DROP = 13809
+ERROR_IPSEC_IKE_QM_ACQUIRE_DROP = 13810
+ERROR_IPSEC_IKE_QUEUE_DROP_MM = 13811
+ERROR_IPSEC_IKE_QUEUE_DROP_NO_MM = 13812
+ERROR_IPSEC_IKE_DROP_NO_RESPONSE = 13813
+ERROR_IPSEC_IKE_MM_DELAY_DROP = 13814
+ERROR_IPSEC_IKE_QM_DELAY_DROP = 13815
+ERROR_IPSEC_IKE_ERROR = 13816
+ERROR_IPSEC_IKE_CRL_FAILED = 13817
+ERROR_IPSEC_IKE_INVALID_KEY_USAGE = 13818
+ERROR_IPSEC_IKE_INVALID_CERT_TYPE = 13819
+ERROR_IPSEC_IKE_NO_PRIVATE_KEY = 13820
+ERROR_IPSEC_IKE_DH_FAIL = 13822
+ERROR_IPSEC_IKE_INVALID_HEADER = 13824
+ERROR_IPSEC_IKE_NO_POLICY = 13825
+ERROR_IPSEC_IKE_INVALID_SIGNATURE = 13826
+ERROR_IPSEC_IKE_KERBEROS_ERROR = 13827
+ERROR_IPSEC_IKE_NO_PUBLIC_KEY = 13828
+ERROR_IPSEC_IKE_PROCESS_ERR = 13829
+ERROR_IPSEC_IKE_PROCESS_ERR_SA = 13830
+ERROR_IPSEC_IKE_PROCESS_ERR_PROP = 13831
+ERROR_IPSEC_IKE_PROCESS_ERR_TRANS = 13832
+ERROR_IPSEC_IKE_PROCESS_ERR_KE = 13833
+ERROR_IPSEC_IKE_PROCESS_ERR_ID = 13834
+ERROR_IPSEC_IKE_PROCESS_ERR_CERT = 13835
+ERROR_IPSEC_IKE_PROCESS_ERR_CERT_REQ = 13836
+ERROR_IPSEC_IKE_PROCESS_ERR_HASH = 13837
+ERROR_IPSEC_IKE_PROCESS_ERR_SIG = 13838
+ERROR_IPSEC_IKE_PROCESS_ERR_NONCE = 13839
+ERROR_IPSEC_IKE_PROCESS_ERR_NOTIFY = 13840
+ERROR_IPSEC_IKE_PROCESS_ERR_DELETE = 13841
+ERROR_IPSEC_IKE_PROCESS_ERR_VENDOR = 13842
+ERROR_IPSEC_IKE_INVALID_PAYLOAD = 13843
+ERROR_IPSEC_IKE_LOAD_SOFT_SA = 13844
+ERROR_IPSEC_IKE_SOFT_SA_TORN_DOWN = 13845
+ERROR_IPSEC_IKE_INVALID_COOKIE = 13846
+ERROR_IPSEC_IKE_NO_PEER_CERT = 13847
+ERROR_IPSEC_IKE_PEER_CRL_FAILED = 13848
+ERROR_IPSEC_IKE_POLICY_CHANGE = 13849
+ERROR_IPSEC_IKE_NO_MM_POLICY = 13850
+ERROR_IPSEC_IKE_NOTCBPRIV = 13851
+ERROR_IPSEC_IKE_SECLOADFAIL = 13852
+ERROR_IPSEC_IKE_FAILSSPINIT = 13853
+ERROR_IPSEC_IKE_FAILQUERYSSP = 13854
+ERROR_IPSEC_IKE_SRVACQFAIL = 13855
+ERROR_IPSEC_IKE_SRVQUERYCRED = 13856
+ERROR_IPSEC_IKE_GETSPIFAIL = 13857
+ERROR_IPSEC_IKE_INVALID_FILTER = 13858
+ERROR_IPSEC_IKE_OUT_OF_MEMORY = 13859
+ERROR_IPSEC_IKE_ADD_UPDATE_KEY_FAILED = 13860
+ERROR_IPSEC_IKE_INVALID_POLICY = 13861
+ERROR_IPSEC_IKE_UNKNOWN_DOI = 13862
+ERROR_IPSEC_IKE_INVALID_SITUATION = 13863
+ERROR_IPSEC_IKE_DH_FAILURE = 13864
+ERROR_IPSEC_IKE_INVALID_GROUP = 13865
+ERROR_IPSEC_IKE_ENCRYPT = 13866
+ERROR_IPSEC_IKE_DECRYPT = 13867
+ERROR_IPSEC_IKE_POLICY_MATCH = 13868
+ERROR_IPSEC_IKE_UNSUPPORTED_ID = 13869
+ERROR_IPSEC_IKE_INVALID_HASH = 13870
+ERROR_IPSEC_IKE_INVALID_HASH_ALG = 13871
+ERROR_IPSEC_IKE_INVALID_HASH_SIZE = 13872
+ERROR_IPSEC_IKE_INVALID_ENCRYPT_ALG = 13873
+ERROR_IPSEC_IKE_INVALID_AUTH_ALG = 13874
+ERROR_IPSEC_IKE_INVALID_SIG = 13875
+ERROR_IPSEC_IKE_LOAD_FAILED = 13876
+ERROR_IPSEC_IKE_RPC_DELETE = 13877
+ERROR_IPSEC_IKE_BENIGN_REINIT = 13878
+ERROR_IPSEC_IKE_INVALID_RESPONDER_LIFETIME_NOTIFY = 13879
+ERROR_IPSEC_IKE_INVALID_CERT_KEYLEN = 13881
+ERROR_IPSEC_IKE_MM_LIMIT = 13882
+ERROR_IPSEC_IKE_NEGOTIATION_DISABLED = 13883
+ERROR_IPSEC_IKE_NEG_STATUS_END = 13884
+CRYPT_E_MSG_ERROR = -2146889727
+CRYPT_E_UNKNOWN_ALGO = -2146889726
+CRYPT_E_OID_FORMAT = -2146889725
+CRYPT_E_INVALID_MSG_TYPE = -2146889724
+CRYPT_E_UNEXPECTED_ENCODING = -2146889723
+CRYPT_E_AUTH_ATTR_MISSING = -2146889722
+CRYPT_E_HASH_VALUE = -2146889721
+CRYPT_E_INVALID_INDEX = -2146889720
+CRYPT_E_ALREADY_DECRYPTED = -2146889719
+CRYPT_E_NOT_DECRYPTED = -2146889718
+CRYPT_E_RECIPIENT_NOT_FOUND = -2146889717
+CRYPT_E_CONTROL_TYPE = -2146889716
+CRYPT_E_ISSUER_SERIALNUMBER = -2146889715
+CRYPT_E_SIGNER_NOT_FOUND = -2146889714
+CRYPT_E_ATTRIBUTES_MISSING = -2146889713
+CRYPT_E_STREAM_MSG_NOT_READY = -2146889712
+CRYPT_E_STREAM_INSUFFICIENT_DATA = -2146889711
+CRYPT_I_NEW_PROTECTION_REQUIRED = 593938
+CRYPT_E_BAD_LEN = -2146885631
+CRYPT_E_BAD_ENCODE = -2146885630
+CRYPT_E_FILE_ERROR = -2146885629
+CRYPT_E_NOT_FOUND = -2146885628
+CRYPT_E_EXISTS = -2146885627
+CRYPT_E_NO_PROVIDER = -2146885626
+CRYPT_E_SELF_SIGNED = -2146885625
+CRYPT_E_DELETED_PREV = -2146885624
+CRYPT_E_NO_MATCH = -2146885623
+CRYPT_E_UNEXPECTED_MSG_TYPE = -2146885622
+CRYPT_E_NO_KEY_PROPERTY = -2146885621
+CRYPT_E_NO_DECRYPT_CERT = -2146885620
+CRYPT_E_BAD_MSG = -2146885619
+CRYPT_E_NO_SIGNER = -2146885618
+CRYPT_E_PENDING_CLOSE = -2146885617
+CRYPT_E_REVOKED = -2146885616
+CRYPT_E_NO_REVOCATION_DLL = -2146885615
+CRYPT_E_NO_REVOCATION_CHECK = -2146885614
+CRYPT_E_REVOCATION_OFFLINE = -2146885613
+CRYPT_E_NOT_IN_REVOCATION_DATABASE = -2146885612
+CRYPT_E_INVALID_NUMERIC_STRING = -2146885600
+CRYPT_E_INVALID_PRINTABLE_STRING = -2146885599
+CRYPT_E_INVALID_IA5_STRING = -2146885598
+CRYPT_E_INVALID_X500_STRING = -2146885597
+CRYPT_E_NOT_CHAR_STRING = -2146885596
+CRYPT_E_FILERESIZED = -2146885595
+CRYPT_E_SECURITY_SETTINGS = -2146885594
+CRYPT_E_NO_VERIFY_USAGE_DLL = -2146885593
+CRYPT_E_NO_VERIFY_USAGE_CHECK = -2146885592
+CRYPT_E_VERIFY_USAGE_OFFLINE = -2146885591
+CRYPT_E_NOT_IN_CTL = -2146885590
+CRYPT_E_NO_TRUSTED_SIGNER = -2146885589
+CRYPT_E_MISSING_PUBKEY_PARA = -2146885588
+CRYPT_E_OSS_ERROR = -2146881536
+
+## Kerberos message types for LsaCallAuthenticationPackage (from ntsecapi.h)
+KerbDebugRequestMessage = 0
+KerbQueryTicketCacheMessage = 1
+KerbChangeMachinePasswordMessage = 2
+KerbVerifyPacMessage = 3
+KerbRetrieveTicketMessage = 4
+KerbUpdateAddressesMessage = 5
+KerbPurgeTicketCacheMessage = 6
+KerbChangePasswordMessage = 7
+KerbRetrieveEncodedTicketMessage = 8
+KerbDecryptDataMessage = 9
+KerbAddBindingCacheEntryMessage = 10
+KerbSetPasswordMessage = 11
+KerbSetPasswordExMessage = 12
+KerbVerifyCredentialsMessage = 13
+KerbQueryTicketCacheExMessage = 14
+KerbPurgeTicketCacheExMessage = 15
+KerbRefreshSmartcardCredentialsMessage = 16
+KerbAddExtraCredentialsMessage = 17
+KerbQuerySupplementalCredentialsMessage = 18
+
+## messages used with msv1_0 from ntsecapi.h
+MsV1_0Lm20ChallengeRequest = 0
+MsV1_0Lm20GetChallengeResponse = 1
+MsV1_0EnumerateUsers = 2
+MsV1_0GetUserInfo = 3
+MsV1_0ReLogonUsers = 4
+MsV1_0ChangePassword = 5
+MsV1_0ChangeCachedPassword = 6
+MsV1_0GenericPassthrough = 7
+MsV1_0CacheLogon = 8
+MsV1_0SubAuth = 9
+MsV1_0DeriveCredential = 10
+MsV1_0CacheLookup = 11
+MsV1_0SetProcessOption = 12
+
+SEC_E_OK = 0
diff --git a/lib/win32/lib/win2kras.py b/lib/win32/lib/win2kras.py
new file mode 100644
index 00000000..f1c18b3a
--- /dev/null
+++ b/lib/win32/lib/win2kras.py
@@ -0,0 +1,7 @@
+# win2kras used to be an extension module with wrapped the "new" RAS functions
+# in Windows 2000, so win32ras could still be used on NT/etc.
+# I think in 2021 we can be confident pywin32 is not used on earlier OSs, so
+# that functionality is now in win32ras.
+#
+# This exists just to avoid breaking old scripts.
+from win32ras import *
diff --git a/lib/win32/lib/win32con.py b/lib/win32/lib/win32con.py
new file mode 100644
index 00000000..9916ba4a
--- /dev/null
+++ b/lib/win32/lib/win32con.py
@@ -0,0 +1,5083 @@
+# Generated by h2py from commdlg.h (plus modifications 4jan98)
+WINVER = 1280
+WM_USER = 1024
+PY_0U = 0
+OFN_READONLY = 1
+OFN_OVERWRITEPROMPT = 2
+OFN_HIDEREADONLY = 4
+OFN_NOCHANGEDIR = 8
+OFN_SHOWHELP = 16
+OFN_ENABLEHOOK = 32
+OFN_ENABLETEMPLATE = 64
+OFN_ENABLETEMPLATEHANDLE = 128
+OFN_NOVALIDATE = 256
+OFN_ALLOWMULTISELECT = 512
+OFN_EXTENSIONDIFFERENT = 1024
+OFN_PATHMUSTEXIST = 2048
+OFN_FILEMUSTEXIST = 4096
+OFN_CREATEPROMPT = 8192
+OFN_SHAREAWARE = 16384
+OFN_NOREADONLYRETURN = 32768
+OFN_NOTESTFILECREATE = 65536
+OFN_NONETWORKBUTTON = 131072
+OFN_NOLONGNAMES = 262144
+OFN_EXPLORER = 524288  # new look commdlg
+OFN_NODEREFERENCELINKS = 1048576
+OFN_LONGNAMES = 2097152  # force long names for 3.x modules
+OFN_ENABLEINCLUDENOTIFY = 4194304  # send include message to callback
+OFN_ENABLESIZING = 8388608
+OFN_DONTADDTORECENT = 33554432
+OFN_FORCESHOWHIDDEN = 268435456  # Show All files including System and hidden files
+OFN_EX_NOPLACESBAR = 1
+OFN_SHAREFALLTHROUGH = 2
+OFN_SHARENOWARN = 1
+OFN_SHAREWARN = 0
+CDN_FIRST = PY_0U - 601
+CDN_LAST = PY_0U - 699
+CDN_INITDONE = CDN_FIRST - 0
+CDN_SELCHANGE = CDN_FIRST - 1
+CDN_FOLDERCHANGE = CDN_FIRST - 2
+CDN_SHAREVIOLATION = CDN_FIRST - 3
+CDN_HELP = CDN_FIRST - 4
+CDN_FILEOK = CDN_FIRST - 5
+CDN_TYPECHANGE = CDN_FIRST - 6
+CDN_INCLUDEITEM = CDN_FIRST - 7
+CDM_FIRST = WM_USER + 100
+CDM_LAST = WM_USER + 200
+CDM_GETSPEC = CDM_FIRST + 0
+CDM_GETFILEPATH = CDM_FIRST + 1
+CDM_GETFOLDERPATH = CDM_FIRST + 2
+CDM_GETFOLDERIDLIST = CDM_FIRST + 3
+CDM_SETCONTROLTEXT = CDM_FIRST + 4
+CDM_HIDECONTROL = CDM_FIRST + 5
+CDM_SETDEFEXT = CDM_FIRST + 6
+CC_RGBINIT = 1
+CC_FULLOPEN = 2
+CC_PREVENTFULLOPEN = 4
+CC_SHOWHELP = 8
+CC_ENABLEHOOK = 16
+CC_ENABLETEMPLATE = 32
+CC_ENABLETEMPLATEHANDLE = 64
+CC_SOLIDCOLOR = 128
+CC_ANYCOLOR = 256
+FR_DOWN = 1
+FR_WHOLEWORD = 2
+FR_MATCHCASE = 4
+FR_FINDNEXT = 8
+FR_REPLACE = 16
+FR_REPLACEALL = 32
+FR_DIALOGTERM = 64
+FR_SHOWHELP = 128
+FR_ENABLEHOOK = 256
+FR_ENABLETEMPLATE = 512
+FR_NOUPDOWN = 1024
+FR_NOMATCHCASE = 2048
+FR_NOWHOLEWORD = 4096
+FR_ENABLETEMPLATEHANDLE = 8192
+FR_HIDEUPDOWN = 16384
+FR_HIDEMATCHCASE = 32768
+FR_HIDEWHOLEWORD = 65536
+CF_SCREENFONTS = 1
+CF_PRINTERFONTS = 2
+CF_BOTH = CF_SCREENFONTS | CF_PRINTERFONTS
+CF_SHOWHELP = 4
+CF_ENABLEHOOK = 8
+CF_ENABLETEMPLATE = 16
+CF_ENABLETEMPLATEHANDLE = 32
+CF_INITTOLOGFONTSTRUCT = 64
+CF_USESTYLE = 128
+CF_EFFECTS = 256
+CF_APPLY = 512
+CF_ANSIONLY = 1024
+CF_SCRIPTSONLY = CF_ANSIONLY
+CF_NOVECTORFONTS = 2048
+CF_NOOEMFONTS = CF_NOVECTORFONTS
+CF_NOSIMULATIONS = 4096
+CF_LIMITSIZE = 8192
+CF_FIXEDPITCHONLY = 16384
+CF_WYSIWYG = 32768  # must also have CF_SCREENFONTS & CF_PRINTERFONTS
+CF_FORCEFONTEXIST = 65536
+CF_SCALABLEONLY = 131072
+CF_TTONLY = 262144
+CF_NOFACESEL = 524288
+CF_NOSTYLESEL = 1048576
+CF_NOSIZESEL = 2097152
+CF_SELECTSCRIPT = 4194304
+CF_NOSCRIPTSEL = 8388608
+CF_NOVERTFONTS = 16777216
+SIMULATED_FONTTYPE = 32768
+PRINTER_FONTTYPE = 16384
+SCREEN_FONTTYPE = 8192
+BOLD_FONTTYPE = 256
+ITALIC_FONTTYPE = 512
+REGULAR_FONTTYPE = 1024
+OPENTYPE_FONTTYPE = 65536
+TYPE1_FONTTYPE = 131072
+DSIG_FONTTYPE = 262144
+WM_CHOOSEFONT_GETLOGFONT = WM_USER + 1
+WM_CHOOSEFONT_SETLOGFONT = WM_USER + 101
+WM_CHOOSEFONT_SETFLAGS = WM_USER + 102
+LBSELCHSTRINGA = "commdlg_LBSelChangedNotify"
+SHAREVISTRINGA = "commdlg_ShareViolation"
+FILEOKSTRINGA = "commdlg_FileNameOK"
+COLOROKSTRINGA = "commdlg_ColorOK"
+SETRGBSTRINGA = "commdlg_SetRGBColor"
+HELPMSGSTRINGA = "commdlg_help"
+FINDMSGSTRINGA = "commdlg_FindReplace"
+LBSELCHSTRING = LBSELCHSTRINGA
+SHAREVISTRING = SHAREVISTRINGA
+FILEOKSTRING = FILEOKSTRINGA
+COLOROKSTRING = COLOROKSTRINGA
+SETRGBSTRING = SETRGBSTRINGA
+HELPMSGSTRING = HELPMSGSTRINGA
+FINDMSGSTRING = FINDMSGSTRINGA
+CD_LBSELNOITEMS = -1
+CD_LBSELCHANGE = 0
+CD_LBSELSUB = 1
+CD_LBSELADD = 2
+PD_ALLPAGES = 0
+PD_SELECTION = 1
+PD_PAGENUMS = 2
+PD_NOSELECTION = 4
+PD_NOPAGENUMS = 8
+PD_COLLATE = 16
+PD_PRINTTOFILE = 32
+PD_PRINTSETUP = 64
+PD_NOWARNING = 128
+PD_RETURNDC = 256
+PD_RETURNIC = 512
+PD_RETURNDEFAULT = 1024
+PD_SHOWHELP = 2048
+PD_ENABLEPRINTHOOK = 4096
+PD_ENABLESETUPHOOK = 8192
+PD_ENABLEPRINTTEMPLATE = 16384
+PD_ENABLESETUPTEMPLATE = 32768
+PD_ENABLEPRINTTEMPLATEHANDLE = 65536
+PD_ENABLESETUPTEMPLATEHANDLE = 131072
+PD_USEDEVMODECOPIES = 262144
+PD_DISABLEPRINTTOFILE = 524288
+PD_HIDEPRINTTOFILE = 1048576
+PD_NONETWORKBUTTON = 2097152
+DN_DEFAULTPRN = 1
+WM_PSD_PAGESETUPDLG = WM_USER
+WM_PSD_FULLPAGERECT = WM_USER + 1
+WM_PSD_MINMARGINRECT = WM_USER + 2
+WM_PSD_MARGINRECT = WM_USER + 3
+WM_PSD_GREEKTEXTRECT = WM_USER + 4
+WM_PSD_ENVSTAMPRECT = WM_USER + 5
+WM_PSD_YAFULLPAGERECT = WM_USER + 6
+PSD_DEFAULTMINMARGINS = 0  # default (printer's)
+PSD_INWININIINTLMEASURE = 0  # 1st of 4 possible
+PSD_MINMARGINS = 1  # use caller's
+PSD_MARGINS = 2  # use caller's
+PSD_INTHOUSANDTHSOFINCHES = 4  # 2nd of 4 possible
+PSD_INHUNDREDTHSOFMILLIMETERS = 8  # 3rd of 4 possible
+PSD_DISABLEMARGINS = 16
+PSD_DISABLEPRINTER = 32
+PSD_NOWARNING = 128  # must be same as PD_*
+PSD_DISABLEORIENTATION = 256
+PSD_RETURNDEFAULT = 1024  # must be same as PD_*
+PSD_DISABLEPAPER = 512
+PSD_SHOWHELP = 2048  # must be same as PD_*
+PSD_ENABLEPAGESETUPHOOK = 8192  # must be same as PD_*
+PSD_ENABLEPAGESETUPTEMPLATE = 32768  # must be same as PD_*
+PSD_ENABLEPAGESETUPTEMPLATEHANDLE = 131072  # must be same as PD_*
+PSD_ENABLEPAGEPAINTHOOK = 262144
+PSD_DISABLEPAGEPAINTING = 524288
+PSD_NONETWORKBUTTON = 2097152  # must be same as PD_*
+
+# Generated by h2py from winreg.h
+HKEY_CLASSES_ROOT = -2147483648
+HKEY_CURRENT_USER = -2147483647
+HKEY_LOCAL_MACHINE = -2147483646
+HKEY_USERS = -2147483645
+HKEY_PERFORMANCE_DATA = -2147483644
+HKEY_CURRENT_CONFIG = -2147483643
+HKEY_DYN_DATA = -2147483642
+HKEY_PERFORMANCE_TEXT = -2147483568  # ?? 4Jan98
+HKEY_PERFORMANCE_NLSTEXT = -2147483552  # ?? 4Jan98
+
+# Generated by h2py from winuser.h
+HWND_BROADCAST = 65535
+HWND_DESKTOP = 0
+HWND_TOP = 0
+HWND_BOTTOM = 1
+HWND_TOPMOST = -1
+HWND_NOTOPMOST = -2
+HWND_MESSAGE = -3
+
+# winuser.h line 4601
+SM_CXSCREEN = 0
+SM_CYSCREEN = 1
+SM_CXVSCROLL = 2
+SM_CYHSCROLL = 3
+SM_CYCAPTION = 4
+SM_CXBORDER = 5
+SM_CYBORDER = 6
+SM_CXDLGFRAME = 7
+SM_CYDLGFRAME = 8
+SM_CYVTHUMB = 9
+SM_CXHTHUMB = 10
+SM_CXICON = 11
+SM_CYICON = 12
+SM_CXCURSOR = 13
+SM_CYCURSOR = 14
+SM_CYMENU = 15
+SM_CXFULLSCREEN = 16
+SM_CYFULLSCREEN = 17
+SM_CYKANJIWINDOW = 18
+SM_MOUSEPRESENT = 19
+SM_CYVSCROLL = 20
+SM_CXHSCROLL = 21
+SM_DEBUG = 22
+SM_SWAPBUTTON = 23
+SM_RESERVED1 = 24
+SM_RESERVED2 = 25
+SM_RESERVED3 = 26
+SM_RESERVED4 = 27
+SM_CXMIN = 28
+SM_CYMIN = 29
+SM_CXSIZE = 30
+SM_CYSIZE = 31
+SM_CXFRAME = 32
+SM_CYFRAME = 33
+SM_CXMINTRACK = 34
+SM_CYMINTRACK = 35
+SM_CXDOUBLECLK = 36
+SM_CYDOUBLECLK = 37
+SM_CXICONSPACING = 38
+SM_CYICONSPACING = 39
+SM_MENUDROPALIGNMENT = 40
+SM_PENWINDOWS = 41
+SM_DBCSENABLED = 42
+SM_CMOUSEBUTTONS = 43
+SM_CXFIXEDFRAME = SM_CXDLGFRAME
+SM_CYFIXEDFRAME = SM_CYDLGFRAME
+SM_CXSIZEFRAME = SM_CXFRAME
+SM_CYSIZEFRAME = SM_CYFRAME
+SM_SECURE = 44
+SM_CXEDGE = 45
+SM_CYEDGE = 46
+SM_CXMINSPACING = 47
+SM_CYMINSPACING = 48
+SM_CXSMICON = 49
+SM_CYSMICON = 50
+SM_CYSMCAPTION = 51
+SM_CXSMSIZE = 52
+SM_CYSMSIZE = 53
+SM_CXMENUSIZE = 54
+SM_CYMENUSIZE = 55
+SM_ARRANGE = 56
+SM_CXMINIMIZED = 57
+SM_CYMINIMIZED = 58
+SM_CXMAXTRACK = 59
+SM_CYMAXTRACK = 60
+SM_CXMAXIMIZED = 61
+SM_CYMAXIMIZED = 62
+SM_NETWORK = 63
+SM_CLEANBOOT = 67
+SM_CXDRAG = 68
+SM_CYDRAG = 69
+SM_SHOWSOUNDS = 70
+SM_CXMENUCHECK = 71
+SM_CYMENUCHECK = 72
+SM_SLOWMACHINE = 73
+SM_MIDEASTENABLED = 74
+SM_MOUSEWHEELPRESENT = 75
+SM_XVIRTUALSCREEN = 76
+SM_YVIRTUALSCREEN = 77
+SM_CXVIRTUALSCREEN = 78
+SM_CYVIRTUALSCREEN = 79
+SM_CMONITORS = 80
+SM_SAMEDISPLAYFORMAT = 81
+SM_CMETRICS = 83
+MNC_IGNORE = 0
+MNC_CLOSE = 1
+MNC_EXECUTE = 2
+MNC_SELECT = 3
+MNS_NOCHECK = -2147483648
+MNS_MODELESS = 1073741824
+MNS_DRAGDROP = 536870912
+MNS_AUTODISMISS = 268435456
+MNS_NOTIFYBYPOS = 134217728
+MNS_CHECKORBMP = 67108864
+MIM_MAXHEIGHT = 1
+MIM_BACKGROUND = 2
+MIM_HELPID = 4
+MIM_MENUDATA = 8
+MIM_STYLE = 16
+MIM_APPLYTOSUBMENUS = -2147483648
+MND_CONTINUE = 0
+MND_ENDMENU = 1
+MNGOF_GAP = 3
+MNGO_NOINTERFACE = 0
+MNGO_NOERROR = 1
+MIIM_STATE = 1
+MIIM_ID = 2
+MIIM_SUBMENU = 4
+MIIM_CHECKMARKS = 8
+MIIM_TYPE = 16
+MIIM_DATA = 32
+MIIM_STRING = 64
+MIIM_BITMAP = 128
+MIIM_FTYPE = 256
+HBMMENU_CALLBACK = -1
+HBMMENU_SYSTEM = 1
+HBMMENU_MBAR_RESTORE = 2
+HBMMENU_MBAR_MINIMIZE = 3
+HBMMENU_MBAR_CLOSE = 5
+HBMMENU_MBAR_CLOSE_D = 6
+HBMMENU_MBAR_MINIMIZE_D = 7
+HBMMENU_POPUP_CLOSE = 8
+HBMMENU_POPUP_RESTORE = 9
+HBMMENU_POPUP_MAXIMIZE = 10
+HBMMENU_POPUP_MINIMIZE = 11
+GMDI_USEDISABLED = 1
+GMDI_GOINTOPOPUPS = 2
+TPM_LEFTBUTTON = 0
+TPM_RIGHTBUTTON = 2
+TPM_LEFTALIGN = 0
+TPM_CENTERALIGN = 4
+TPM_RIGHTALIGN = 8
+TPM_TOPALIGN = 0
+TPM_VCENTERALIGN = 16
+TPM_BOTTOMALIGN = 32
+TPM_HORIZONTAL = 0
+TPM_VERTICAL = 64
+TPM_NONOTIFY = 128
+TPM_RETURNCMD = 256
+TPM_RECURSE = 1
+DOF_EXECUTABLE = 32769
+DOF_DOCUMENT = 32770
+DOF_DIRECTORY = 32771
+DOF_MULTIPLE = 32772
+DOF_PROGMAN = 1
+DOF_SHELLDATA = 2
+DO_DROPFILE = 1162627398
+DO_PRINTFILE = 1414419024
+DT_TOP = 0
+DT_LEFT = 0
+DT_CENTER = 1
+DT_RIGHT = 2
+DT_VCENTER = 4
+DT_BOTTOM = 8
+DT_WORDBREAK = 16
+DT_SINGLELINE = 32
+DT_EXPANDTABS = 64
+DT_TABSTOP = 128
+DT_NOCLIP = 256
+DT_EXTERNALLEADING = 512
+DT_CALCRECT = 1024
+DT_NOPREFIX = 2048
+DT_INTERNAL = 4096
+DT_EDITCONTROL = 8192
+DT_PATH_ELLIPSIS = 16384
+DT_END_ELLIPSIS = 32768
+DT_MODIFYSTRING = 65536
+DT_RTLREADING = 131072
+DT_WORD_ELLIPSIS = 262144
+DST_COMPLEX = 0
+DST_TEXT = 1
+DST_PREFIXTEXT = 2
+DST_ICON = 3
+DST_BITMAP = 4
+DSS_NORMAL = 0
+DSS_UNION = 16
+DSS_DISABLED = 32
+DSS_MONO = 128
+DSS_RIGHT = 32768
+DCX_WINDOW = 1
+DCX_CACHE = 2
+DCX_NORESETATTRS = 4
+DCX_CLIPCHILDREN = 8
+DCX_CLIPSIBLINGS = 16
+DCX_PARENTCLIP = 32
+DCX_EXCLUDERGN = 64
+DCX_INTERSECTRGN = 128
+DCX_EXCLUDEUPDATE = 256
+DCX_INTERSECTUPDATE = 512
+DCX_LOCKWINDOWUPDATE = 1024
+DCX_VALIDATE = 2097152
+CUDR_NORMAL = 0
+CUDR_NOSNAPTOGRID = 1
+CUDR_NORESOLVEPOSITIONS = 2
+CUDR_NOCLOSEGAPS = 4
+CUDR_NEGATIVECOORDS = 8
+CUDR_NOPRIMARY = 16
+RDW_INVALIDATE = 1
+RDW_INTERNALPAINT = 2
+RDW_ERASE = 4
+RDW_VALIDATE = 8
+RDW_NOINTERNALPAINT = 16
+RDW_NOERASE = 32
+RDW_NOCHILDREN = 64
+RDW_ALLCHILDREN = 128
+RDW_UPDATENOW = 256
+RDW_ERASENOW = 512
+RDW_FRAME = 1024
+RDW_NOFRAME = 2048
+SW_SCROLLCHILDREN = 1
+SW_INVALIDATE = 2
+SW_ERASE = 4
+SW_SMOOTHSCROLL = 16  # Use smooth scrolling
+ESB_ENABLE_BOTH = 0
+ESB_DISABLE_BOTH = 3
+ESB_DISABLE_LEFT = 1
+ESB_DISABLE_RIGHT = 2
+ESB_DISABLE_UP = 1
+ESB_DISABLE_DOWN = 2
+ESB_DISABLE_LTUP = ESB_DISABLE_LEFT
+ESB_DISABLE_RTDN = ESB_DISABLE_RIGHT
+HELPINFO_WINDOW = 1
+HELPINFO_MENUITEM = 2
+MB_OK = 0
+MB_OKCANCEL = 1
+MB_ABORTRETRYIGNORE = 2
+MB_YESNOCANCEL = 3
+MB_YESNO = 4
+MB_RETRYCANCEL = 5
+MB_ICONHAND = 16
+MB_ICONQUESTION = 32
+MB_ICONEXCLAMATION = 48
+MB_ICONASTERISK = 64
+MB_ICONWARNING = MB_ICONEXCLAMATION
+MB_ICONERROR = MB_ICONHAND
+MB_ICONINFORMATION = MB_ICONASTERISK
+MB_ICONSTOP = MB_ICONHAND
+MB_DEFBUTTON1 = 0
+MB_DEFBUTTON2 = 256
+MB_DEFBUTTON3 = 512
+MB_DEFBUTTON4 = 768
+MB_APPLMODAL = 0
+MB_SYSTEMMODAL = 4096
+MB_TASKMODAL = 8192
+MB_HELP = 16384
+MB_NOFOCUS = 32768
+MB_SETFOREGROUND = 65536
+MB_DEFAULT_DESKTOP_ONLY = 131072
+MB_TOPMOST = 262144
+MB_RIGHT = 524288
+MB_RTLREADING = 1048576
+MB_SERVICE_NOTIFICATION = 2097152
+MB_TYPEMASK = 15
+MB_USERICON = 128
+MB_ICONMASK = 240
+MB_DEFMASK = 3840
+MB_MODEMASK = 12288
+MB_MISCMASK = 49152
+# winuser.h line 6373
+CWP_ALL = 0
+CWP_SKIPINVISIBLE = 1
+CWP_SKIPDISABLED = 2
+CWP_SKIPTRANSPARENT = 4
+CTLCOLOR_MSGBOX = 0
+CTLCOLOR_EDIT = 1
+CTLCOLOR_LISTBOX = 2
+CTLCOLOR_BTN = 3
+CTLCOLOR_DLG = 4
+CTLCOLOR_SCROLLBAR = 5
+CTLCOLOR_STATIC = 6
+CTLCOLOR_MAX = 7
+COLOR_SCROLLBAR = 0
+COLOR_BACKGROUND = 1
+COLOR_ACTIVECAPTION = 2
+COLOR_INACTIVECAPTION = 3
+COLOR_MENU = 4
+COLOR_WINDOW = 5
+COLOR_WINDOWFRAME = 6
+COLOR_MENUTEXT = 7
+COLOR_WINDOWTEXT = 8
+COLOR_CAPTIONTEXT = 9
+COLOR_ACTIVEBORDER = 10
+COLOR_INACTIVEBORDER = 11
+COLOR_APPWORKSPACE = 12
+COLOR_HIGHLIGHT = 13
+COLOR_HIGHLIGHTTEXT = 14
+COLOR_BTNFACE = 15
+COLOR_BTNSHADOW = 16
+COLOR_GRAYTEXT = 17
+COLOR_BTNTEXT = 18
+COLOR_INACTIVECAPTIONTEXT = 19
+COLOR_BTNHIGHLIGHT = 20
+COLOR_3DDKSHADOW = 21
+COLOR_3DLIGHT = 22
+COLOR_INFOTEXT = 23
+COLOR_INFOBK = 24
+COLOR_HOTLIGHT = 26
+COLOR_GRADIENTACTIVECAPTION = 27
+COLOR_GRADIENTINACTIVECAPTION = 28
+COLOR_DESKTOP = COLOR_BACKGROUND
+COLOR_3DFACE = COLOR_BTNFACE
+COLOR_3DSHADOW = COLOR_BTNSHADOW
+COLOR_3DHIGHLIGHT = COLOR_BTNHIGHLIGHT
+COLOR_3DHILIGHT = COLOR_BTNHIGHLIGHT
+COLOR_BTNHILIGHT = COLOR_BTNHIGHLIGHT
+GW_HWNDFIRST = 0
+GW_HWNDLAST = 1
+GW_HWNDNEXT = 2
+GW_HWNDPREV = 3
+GW_OWNER = 4
+GW_CHILD = 5
+GW_ENABLEDPOPUP = 6
+GW_MAX = 6
+MF_INSERT = 0
+MF_CHANGE = 128
+MF_APPEND = 256
+MF_DELETE = 512
+MF_REMOVE = 4096
+MF_BYCOMMAND = 0
+MF_BYPOSITION = 1024
+MF_SEPARATOR = 2048
+MF_ENABLED = 0
+MF_GRAYED = 1
+MF_DISABLED = 2
+MF_UNCHECKED = 0
+MF_CHECKED = 8
+MF_USECHECKBITMAPS = 512
+MF_STRING = 0
+MF_BITMAP = 4
+MF_OWNERDRAW = 256
+MF_POPUP = 16
+MF_MENUBARBREAK = 32
+MF_MENUBREAK = 64
+MF_UNHILITE = 0
+MF_HILITE = 128
+MF_DEFAULT = 4096
+MF_SYSMENU = 8192
+MF_HELP = 16384
+MF_RIGHTJUSTIFY = 16384
+MF_MOUSESELECT = 32768
+MF_END = 128
+MFT_STRING = MF_STRING
+MFT_BITMAP = MF_BITMAP
+MFT_MENUBARBREAK = MF_MENUBARBREAK
+MFT_MENUBREAK = MF_MENUBREAK
+MFT_OWNERDRAW = MF_OWNERDRAW
+MFT_RADIOCHECK = 512
+MFT_SEPARATOR = MF_SEPARATOR
+MFT_RIGHTORDER = 8192
+MFT_RIGHTJUSTIFY = MF_RIGHTJUSTIFY
+MFS_GRAYED = 3
+MFS_DISABLED = MFS_GRAYED
+MFS_CHECKED = MF_CHECKED
+MFS_HILITE = MF_HILITE
+MFS_ENABLED = MF_ENABLED
+MFS_UNCHECKED = MF_UNCHECKED
+MFS_UNHILITE = MF_UNHILITE
+MFS_DEFAULT = MF_DEFAULT
+MFS_MASK = 4235
+MFS_HOTTRACKDRAWN = 268435456
+MFS_CACHEDBMP = 536870912
+MFS_BOTTOMGAPDROP = 1073741824
+MFS_TOPGAPDROP = -2147483648
+MFS_GAPDROP = -1073741824
+SC_SIZE = 61440
+SC_MOVE = 61456
+SC_MINIMIZE = 61472
+SC_MAXIMIZE = 61488
+SC_NEXTWINDOW = 61504
+SC_PREVWINDOW = 61520
+SC_CLOSE = 61536
+SC_VSCROLL = 61552
+SC_HSCROLL = 61568
+SC_MOUSEMENU = 61584
+SC_KEYMENU = 61696
+SC_ARRANGE = 61712
+SC_RESTORE = 61728
+SC_TASKLIST = 61744
+SC_SCREENSAVE = 61760
+SC_HOTKEY = 61776
+SC_DEFAULT = 61792
+SC_MONITORPOWER = 61808
+SC_CONTEXTHELP = 61824
+SC_SEPARATOR = 61455
+SC_ICON = SC_MINIMIZE
+SC_ZOOM = SC_MAXIMIZE
+IDC_ARROW = 32512
+IDC_IBEAM = 32513
+IDC_WAIT = 32514
+IDC_CROSS = 32515
+IDC_UPARROW = 32516
+IDC_SIZE = 32640  # OBSOLETE: use IDC_SIZEALL
+IDC_ICON = 32641  # OBSOLETE: use IDC_ARROW
+IDC_SIZENWSE = 32642
+IDC_SIZENESW = 32643
+IDC_SIZEWE = 32644
+IDC_SIZENS = 32645
+IDC_SIZEALL = 32646
+IDC_NO = 32648
+IDC_HAND = 32649
+IDC_APPSTARTING = 32650
+IDC_HELP = 32651
+IMAGE_BITMAP = 0
+IMAGE_ICON = 1
+IMAGE_CURSOR = 2
+IMAGE_ENHMETAFILE = 3
+LR_DEFAULTCOLOR = 0
+LR_MONOCHROME = 1
+LR_COLOR = 2
+LR_COPYRETURNORG = 4
+LR_COPYDELETEORG = 8
+LR_LOADFROMFILE = 16
+LR_LOADTRANSPARENT = 32
+LR_DEFAULTSIZE = 64
+LR_LOADREALSIZE = 128
+LR_LOADMAP3DCOLORS = 4096
+LR_CREATEDIBSECTION = 8192
+LR_COPYFROMRESOURCE = 16384
+LR_SHARED = 32768
+DI_MASK = 1
+DI_IMAGE = 2
+DI_NORMAL = 3
+DI_COMPAT = 4
+DI_DEFAULTSIZE = 8
+RES_ICON = 1
+RES_CURSOR = 2
+OBM_CLOSE = 32754
+OBM_UPARROW = 32753
+OBM_DNARROW = 32752
+OBM_RGARROW = 32751
+OBM_LFARROW = 32750
+OBM_REDUCE = 32749
+OBM_ZOOM = 32748
+OBM_RESTORE = 32747
+OBM_REDUCED = 32746
+OBM_ZOOMD = 32745
+OBM_RESTORED = 32744
+OBM_UPARROWD = 32743
+OBM_DNARROWD = 32742
+OBM_RGARROWD = 32741
+OBM_LFARROWD = 32740
+OBM_MNARROW = 32739
+OBM_COMBO = 32738
+OBM_UPARROWI = 32737
+OBM_DNARROWI = 32736
+OBM_RGARROWI = 32735
+OBM_LFARROWI = 32734
+OBM_OLD_CLOSE = 32767
+OBM_SIZE = 32766
+OBM_OLD_UPARROW = 32765
+OBM_OLD_DNARROW = 32764
+OBM_OLD_RGARROW = 32763
+OBM_OLD_LFARROW = 32762
+OBM_BTSIZE = 32761
+OBM_CHECK = 32760
+OBM_CHECKBOXES = 32759
+OBM_BTNCORNERS = 32758
+OBM_OLD_REDUCE = 32757
+OBM_OLD_ZOOM = 32756
+OBM_OLD_RESTORE = 32755
+OCR_NORMAL = 32512
+OCR_IBEAM = 32513
+OCR_WAIT = 32514
+OCR_CROSS = 32515
+OCR_UP = 32516
+OCR_SIZE = 32640
+OCR_ICON = 32641
+OCR_SIZENWSE = 32642
+OCR_SIZENESW = 32643
+OCR_SIZEWE = 32644
+OCR_SIZENS = 32645
+OCR_SIZEALL = 32646
+OCR_ICOCUR = 32647
+OCR_NO = 32648
+OCR_HAND = 32649
+OCR_APPSTARTING = 32650
+# winuser.h line 7455
+OIC_SAMPLE = 32512
+OIC_HAND = 32513
+OIC_QUES = 32514
+OIC_BANG = 32515
+OIC_NOTE = 32516
+OIC_WINLOGO = 32517
+OIC_WARNING = OIC_BANG
+OIC_ERROR = OIC_HAND
+OIC_INFORMATION = OIC_NOTE
+ORD_LANGDRIVER = 1
+IDI_APPLICATION = 32512
+IDI_HAND = 32513
+IDI_QUESTION = 32514
+IDI_EXCLAMATION = 32515
+IDI_ASTERISK = 32516
+IDI_WINLOGO = 32517
+IDI_WARNING = IDI_EXCLAMATION
+IDI_ERROR = IDI_HAND
+IDI_INFORMATION = IDI_ASTERISK
+IDOK = 1
+IDCANCEL = 2
+IDABORT = 3
+IDRETRY = 4
+IDIGNORE = 5
+IDYES = 6
+IDNO = 7
+IDCLOSE = 8
+IDHELP = 9
+ES_LEFT = 0
+ES_CENTER = 1
+ES_RIGHT = 2
+ES_MULTILINE = 4
+ES_UPPERCASE = 8
+ES_LOWERCASE = 16
+ES_PASSWORD = 32
+ES_AUTOVSCROLL = 64
+ES_AUTOHSCROLL = 128
+ES_NOHIDESEL = 256
+ES_OEMCONVERT = 1024
+ES_READONLY = 2048
+ES_WANTRETURN = 4096
+ES_NUMBER = 8192
+EN_SETFOCUS = 256
+EN_KILLFOCUS = 512
+EN_CHANGE = 768
+EN_UPDATE = 1024
+EN_ERRSPACE = 1280
+EN_MAXTEXT = 1281
+EN_HSCROLL = 1537
+EN_VSCROLL = 1538
+EC_LEFTMARGIN = 1
+EC_RIGHTMARGIN = 2
+EC_USEFONTINFO = 65535
+EMSIS_COMPOSITIONSTRING = 1
+EIMES_GETCOMPSTRATONCE = 1
+EIMES_CANCELCOMPSTRINFOCUS = 2
+EIMES_COMPLETECOMPSTRKILLFOCUS = 4
+EM_GETSEL = 176
+EM_SETSEL = 177
+EM_GETRECT = 178
+EM_SETRECT = 179
+EM_SETRECTNP = 180
+EM_SCROLL = 181
+EM_LINESCROLL = 182
+EM_SCROLLCARET = 183
+EM_GETMODIFY = 184
+EM_SETMODIFY = 185
+EM_GETLINECOUNT = 186
+EM_LINEINDEX = 187
+EM_SETHANDLE = 188
+EM_GETHANDLE = 189
+EM_GETTHUMB = 190
+EM_LINELENGTH = 193
+EM_REPLACESEL = 194
+EM_GETLINE = 196
+EM_LIMITTEXT = 197
+EM_CANUNDO = 198
+EM_UNDO = 199
+EM_FMTLINES = 200
+EM_LINEFROMCHAR = 201
+EM_SETTABSTOPS = 203
+EM_SETPASSWORDCHAR = 204
+EM_EMPTYUNDOBUFFER = 205
+EM_GETFIRSTVISIBLELINE = 206
+EM_SETREADONLY = 207
+EM_SETWORDBREAKPROC = 208
+EM_GETWORDBREAKPROC = 209
+EM_GETPASSWORDCHAR = 210
+EM_SETMARGINS = 211
+EM_GETMARGINS = 212
+EM_SETLIMITTEXT = EM_LIMITTEXT
+EM_GETLIMITTEXT = 213
+EM_POSFROMCHAR = 214
+EM_CHARFROMPOS = 215
+EM_SETIMESTATUS = 216
+EM_GETIMESTATUS = 217
+WB_LEFT = 0
+WB_RIGHT = 1
+WB_ISDELIMITER = 2
+BS_PUSHBUTTON = 0
+BS_DEFPUSHBUTTON = 1
+BS_CHECKBOX = 2
+BS_AUTOCHECKBOX = 3
+BS_RADIOBUTTON = 4
+BS_3STATE = 5
+BS_AUTO3STATE = 6
+BS_GROUPBOX = 7
+BS_USERBUTTON = 8
+BS_AUTORADIOBUTTON = 9
+BS_OWNERDRAW = 11
+BS_LEFTTEXT = 32
+BS_TEXT = 0
+BS_ICON = 64
+BS_BITMAP = 128
+BS_LEFT = 256
+BS_RIGHT = 512
+BS_CENTER = 768
+BS_TOP = 1024
+BS_BOTTOM = 2048
+BS_VCENTER = 3072
+BS_PUSHLIKE = 4096
+BS_MULTILINE = 8192
+BS_NOTIFY = 16384
+BS_FLAT = 32768
+BS_RIGHTBUTTON = BS_LEFTTEXT
+BN_CLICKED = 0
+BN_PAINT = 1
+BN_HILITE = 2
+BN_UNHILITE = 3
+BN_DISABLE = 4
+BN_DOUBLECLICKED = 5
+BN_PUSHED = BN_HILITE
+BN_UNPUSHED = BN_UNHILITE
+BN_DBLCLK = BN_DOUBLECLICKED
+BN_SETFOCUS = 6
+BN_KILLFOCUS = 7
+BM_GETCHECK = 240
+BM_SETCHECK = 241
+BM_GETSTATE = 242
+BM_SETSTATE = 243
+BM_SETSTYLE = 244
+BM_CLICK = 245
+BM_GETIMAGE = 246
+BM_SETIMAGE = 247
+BST_UNCHECKED = 0
+BST_CHECKED = 1
+BST_INDETERMINATE = 2
+BST_PUSHED = 4
+BST_FOCUS = 8
+SS_LEFT = 0
+SS_CENTER = 1
+SS_RIGHT = 2
+SS_ICON = 3
+SS_BLACKRECT = 4
+SS_GRAYRECT = 5
+SS_WHITERECT = 6
+SS_BLACKFRAME = 7
+SS_GRAYFRAME = 8
+SS_WHITEFRAME = 9
+SS_USERITEM = 10
+SS_SIMPLE = 11
+SS_LEFTNOWORDWRAP = 12
+SS_BITMAP = 14
+SS_OWNERDRAW = 13
+SS_ENHMETAFILE = 15
+SS_ETCHEDHORZ = 16
+SS_ETCHEDVERT = 17
+SS_ETCHEDFRAME = 18
+SS_TYPEMASK = 31
+SS_NOPREFIX = 128
+SS_NOTIFY = 256
+SS_CENTERIMAGE = 512
+SS_RIGHTJUST = 1024
+SS_REALSIZEIMAGE = 2048
+SS_SUNKEN = 4096
+SS_ENDELLIPSIS = 16384
+SS_PATHELLIPSIS = 32768
+SS_WORDELLIPSIS = 49152
+SS_ELLIPSISMASK = 49152
+STM_SETICON = 368
+STM_GETICON = 369
+STM_SETIMAGE = 370
+STM_GETIMAGE = 371
+STN_CLICKED = 0
+STN_DBLCLK = 1
+STN_ENABLE = 2
+STN_DISABLE = 3
+STM_MSGMAX = 372
+DWL_MSGRESULT = 0
+DWL_DLGPROC = 4
+DWL_USER = 8
+DDL_READWRITE = 0
+DDL_READONLY = 1
+DDL_HIDDEN = 2
+DDL_SYSTEM = 4
+DDL_DIRECTORY = 16
+DDL_ARCHIVE = 32
+DDL_POSTMSGS = 8192
+DDL_DRIVES = 16384
+DDL_EXCLUSIVE = 32768
+
+# from winuser.h line 153
+RT_CURSOR = 1
+RT_BITMAP = 2
+RT_ICON = 3
+RT_MENU = 4
+RT_DIALOG = 5
+RT_STRING = 6
+RT_FONTDIR = 7
+RT_FONT = 8
+RT_ACCELERATOR = 9
+RT_RCDATA = 10
+RT_MESSAGETABLE = 11
+DIFFERENCE = 11
+RT_GROUP_CURSOR = RT_CURSOR + DIFFERENCE
+RT_GROUP_ICON = RT_ICON + DIFFERENCE
+RT_VERSION = 16
+RT_DLGINCLUDE = 17
+RT_PLUGPLAY = 19
+RT_VXD = 20
+RT_ANICURSOR = 21
+RT_ANIICON = 22
+RT_HTML = 23
+# from winuser.h line 218
+SB_HORZ = 0
+SB_VERT = 1
+SB_CTL = 2
+SB_BOTH = 3
+SB_LINEUP = 0
+SB_LINELEFT = 0
+SB_LINEDOWN = 1
+SB_LINERIGHT = 1
+SB_PAGEUP = 2
+SB_PAGELEFT = 2
+SB_PAGEDOWN = 3
+SB_PAGERIGHT = 3
+SB_THUMBPOSITION = 4
+SB_THUMBTRACK = 5
+SB_TOP = 6
+SB_LEFT = 6
+SB_BOTTOM = 7
+SB_RIGHT = 7
+SB_ENDSCROLL = 8
+SW_HIDE = 0
+SW_SHOWNORMAL = 1
+SW_NORMAL = 1
+SW_SHOWMINIMIZED = 2
+SW_SHOWMAXIMIZED = 3
+SW_MAXIMIZE = 3
+SW_SHOWNOACTIVATE = 4
+SW_SHOW = 5
+SW_MINIMIZE = 6
+SW_SHOWMINNOACTIVE = 7
+SW_SHOWNA = 8
+SW_RESTORE = 9
+SW_SHOWDEFAULT = 10
+SW_FORCEMINIMIZE = 11
+SW_MAX = 11
+HIDE_WINDOW = 0
+SHOW_OPENWINDOW = 1
+SHOW_ICONWINDOW = 2
+SHOW_FULLSCREEN = 3
+SHOW_OPENNOACTIVATE = 4
+SW_PARENTCLOSING = 1
+SW_OTHERZOOM = 2
+SW_PARENTOPENING = 3
+SW_OTHERUNZOOM = 4
+AW_HOR_POSITIVE = 1
+AW_HOR_NEGATIVE = 2
+AW_VER_POSITIVE = 4
+AW_VER_NEGATIVE = 8
+AW_CENTER = 16
+AW_HIDE = 65536
+AW_ACTIVATE = 131072
+AW_SLIDE = 262144
+AW_BLEND = 524288
+KF_EXTENDED = 256
+KF_DLGMODE = 2048
+KF_MENUMODE = 4096
+KF_ALTDOWN = 8192
+KF_REPEAT = 16384
+KF_UP = 32768
+VK_LBUTTON = 1
+VK_RBUTTON = 2
+VK_CANCEL = 3
+VK_MBUTTON = 4
+VK_BACK = 8
+VK_TAB = 9
+VK_CLEAR = 12
+VK_RETURN = 13
+VK_SHIFT = 16
+VK_CONTROL = 17
+VK_MENU = 18
+VK_PAUSE = 19
+VK_CAPITAL = 20
+VK_KANA = 21
+VK_HANGEUL = 21  # old name - should be here for compatibility
+VK_HANGUL = 21
+VK_JUNJA = 23
+VK_FINAL = 24
+VK_HANJA = 25
+VK_KANJI = 25
+VK_ESCAPE = 27
+VK_CONVERT = 28
+VK_NONCONVERT = 29
+VK_ACCEPT = 30
+VK_MODECHANGE = 31
+VK_SPACE = 32
+VK_PRIOR = 33
+VK_NEXT = 34
+VK_END = 35
+VK_HOME = 36
+VK_LEFT = 37
+VK_UP = 38
+VK_RIGHT = 39
+VK_DOWN = 40
+VK_SELECT = 41
+VK_PRINT = 42
+VK_EXECUTE = 43
+VK_SNAPSHOT = 44
+VK_INSERT = 45
+VK_DELETE = 46
+VK_HELP = 47
+VK_LWIN = 91
+VK_RWIN = 92
+VK_APPS = 93
+VK_NUMPAD0 = 96
+VK_NUMPAD1 = 97
+VK_NUMPAD2 = 98
+VK_NUMPAD3 = 99
+VK_NUMPAD4 = 100
+VK_NUMPAD5 = 101
+VK_NUMPAD6 = 102
+VK_NUMPAD7 = 103
+VK_NUMPAD8 = 104
+VK_NUMPAD9 = 105
+VK_MULTIPLY = 106
+VK_ADD = 107
+VK_SEPARATOR = 108
+VK_SUBTRACT = 109
+VK_DECIMAL = 110
+VK_DIVIDE = 111
+VK_F1 = 112
+VK_F2 = 113
+VK_F3 = 114
+VK_F4 = 115
+VK_F5 = 116
+VK_F6 = 117
+VK_F7 = 118
+VK_F8 = 119
+VK_F9 = 120
+VK_F10 = 121
+VK_F11 = 122
+VK_F12 = 123
+VK_F13 = 124
+VK_F14 = 125
+VK_F15 = 126
+VK_F16 = 127
+VK_F17 = 128
+VK_F18 = 129
+VK_F19 = 130
+VK_F20 = 131
+VK_F21 = 132
+VK_F22 = 133
+VK_F23 = 134
+VK_F24 = 135
+VK_NUMLOCK = 144
+VK_SCROLL = 145
+VK_LSHIFT = 160
+VK_RSHIFT = 161
+VK_LCONTROL = 162
+VK_RCONTROL = 163
+VK_LMENU = 164
+VK_RMENU = 165
+VK_PROCESSKEY = 229
+VK_ATTN = 246
+VK_CRSEL = 247
+VK_EXSEL = 248
+VK_EREOF = 249
+VK_PLAY = 250
+VK_ZOOM = 251
+VK_NONAME = 252
+VK_PA1 = 253
+VK_OEM_CLEAR = 254
+# multi-media related "keys"
+MOUSEEVENTF_XDOWN = 0x0080
+MOUSEEVENTF_XUP = 0x0100
+MOUSEEVENTF_WHEEL = 0x0800
+VK_XBUTTON1 = 0x05
+VK_XBUTTON2 = 0x06
+VK_VOLUME_MUTE = 0xAD
+VK_VOLUME_DOWN = 0xAE
+VK_VOLUME_UP = 0xAF
+VK_MEDIA_NEXT_TRACK = 0xB0
+VK_MEDIA_PREV_TRACK = 0xB1
+VK_MEDIA_PLAY_PAUSE = 0xB3
+VK_BROWSER_BACK = 0xA6
+VK_BROWSER_FORWARD = 0xA7
+WH_MIN = -1
+WH_MSGFILTER = -1
+WH_JOURNALRECORD = 0
+WH_JOURNALPLAYBACK = 1
+WH_KEYBOARD = 2
+WH_GETMESSAGE = 3
+WH_CALLWNDPROC = 4
+WH_CBT = 5
+WH_SYSMSGFILTER = 6
+WH_MOUSE = 7
+WH_HARDWARE = 8
+WH_DEBUG = 9
+WH_SHELL = 10
+WH_FOREGROUNDIDLE = 11
+WH_CALLWNDPROCRET = 12
+WH_KEYBOARD_LL = 13
+WH_MOUSE_LL = 14
+WH_MAX = 14
+WH_MINHOOK = WH_MIN
+WH_MAXHOOK = WH_MAX
+HC_ACTION = 0
+HC_GETNEXT = 1
+HC_SKIP = 2
+HC_NOREMOVE = 3
+HC_NOREM = HC_NOREMOVE
+HC_SYSMODALON = 4
+HC_SYSMODALOFF = 5
+HCBT_MOVESIZE = 0
+HCBT_MINMAX = 1
+HCBT_QS = 2
+HCBT_CREATEWND = 3
+HCBT_DESTROYWND = 4
+HCBT_ACTIVATE = 5
+HCBT_CLICKSKIPPED = 6
+HCBT_KEYSKIPPED = 7
+HCBT_SYSCOMMAND = 8
+HCBT_SETFOCUS = 9
+MSGF_DIALOGBOX = 0
+MSGF_MESSAGEBOX = 1
+MSGF_MENU = 2
+# MSGF_MOVE = 3
+# MSGF_SIZE = 4
+MSGF_SCROLLBAR = 5
+MSGF_NEXTWINDOW = 6
+# MSGF_MAINLOOP = 8
+MSGF_MAX = 8
+MSGF_USER = 4096
+HSHELL_WINDOWCREATED = 1
+HSHELL_WINDOWDESTROYED = 2
+HSHELL_ACTIVATESHELLWINDOW = 3
+HSHELL_WINDOWACTIVATED = 4
+HSHELL_GETMINRECT = 5
+HSHELL_REDRAW = 6
+HSHELL_TASKMAN = 7
+HSHELL_LANGUAGE = 8
+HSHELL_ACCESSIBILITYSTATE = 11
+ACCESS_STICKYKEYS = 1
+ACCESS_FILTERKEYS = 2
+ACCESS_MOUSEKEYS = 3
+# winuser.h line 624
+LLKHF_EXTENDED = 1
+LLKHF_INJECTED = 16
+LLKHF_ALTDOWN = 32
+LLKHF_UP = 128
+LLKHF_LOWER_IL_INJECTED = 2
+LLMHF_INJECTED = 1
+LLMHF_LOWER_IL_INJECTED = 2
+# line 692
+HKL_PREV = 0
+HKL_NEXT = 1
+KLF_ACTIVATE = 1
+KLF_SUBSTITUTE_OK = 2
+KLF_UNLOADPREVIOUS = 4
+KLF_REORDER = 8
+KLF_REPLACELANG = 16
+KLF_NOTELLSHELL = 128
+KLF_SETFORPROCESS = 256
+KL_NAMELENGTH = 9
+DESKTOP_READOBJECTS = 1
+DESKTOP_CREATEWINDOW = 2
+DESKTOP_CREATEMENU = 4
+DESKTOP_HOOKCONTROL = 8
+DESKTOP_JOURNALRECORD = 16
+DESKTOP_JOURNALPLAYBACK = 32
+DESKTOP_ENUMERATE = 64
+DESKTOP_WRITEOBJECTS = 128
+DESKTOP_SWITCHDESKTOP = 256
+DF_ALLOWOTHERACCOUNTHOOK = 1
+WINSTA_ENUMDESKTOPS = 1
+WINSTA_READATTRIBUTES = 2
+WINSTA_ACCESSCLIPBOARD = 4
+WINSTA_CREATEDESKTOP = 8
+WINSTA_WRITEATTRIBUTES = 16
+WINSTA_ACCESSGLOBALATOMS = 32
+WINSTA_EXITWINDOWS = 64
+WINSTA_ENUMERATE = 256
+WINSTA_READSCREEN = 512
+WSF_VISIBLE = 1
+UOI_FLAGS = 1
+UOI_NAME = 2
+UOI_TYPE = 3
+UOI_USER_SID = 4
+GWL_WNDPROC = -4
+GWL_HINSTANCE = -6
+GWL_HWNDPARENT = -8
+GWL_STYLE = -16
+GWL_EXSTYLE = -20
+GWL_USERDATA = -21
+GWL_ID = -12
+GCL_MENUNAME = -8
+GCL_HBRBACKGROUND = -10
+GCL_HCURSOR = -12
+GCL_HICON = -14
+GCL_HMODULE = -16
+GCL_CBWNDEXTRA = -18
+GCL_CBCLSEXTRA = -20
+GCL_WNDPROC = -24
+GCL_STYLE = -26
+GCW_ATOM = -32
+GCL_HICONSM = -34
+# line 1291
+WM_NULL = 0
+WM_CREATE = 1
+WM_DESTROY = 2
+WM_MOVE = 3
+WM_SIZE = 5
+WM_ACTIVATE = 6
+WA_INACTIVE = 0
+WA_ACTIVE = 1
+WA_CLICKACTIVE = 2
+WM_SETFOCUS = 7
+WM_KILLFOCUS = 8
+WM_ENABLE = 10
+WM_SETREDRAW = 11
+WM_SETTEXT = 12
+WM_GETTEXT = 13
+WM_GETTEXTLENGTH = 14
+WM_PAINT = 15
+WM_CLOSE = 16
+WM_QUERYENDSESSION = 17
+WM_QUIT = 18
+WM_QUERYOPEN = 19
+WM_ERASEBKGND = 20
+WM_SYSCOLORCHANGE = 21
+WM_ENDSESSION = 22
+WM_SHOWWINDOW = 24
+WM_WININICHANGE = 26
+WM_SETTINGCHANGE = WM_WININICHANGE
+WM_DEVMODECHANGE = 27
+WM_ACTIVATEAPP = 28
+WM_FONTCHANGE = 29
+WM_TIMECHANGE = 30
+WM_CANCELMODE = 31
+WM_SETCURSOR = 32
+WM_MOUSEACTIVATE = 33
+WM_CHILDACTIVATE = 34
+WM_QUEUESYNC = 35
+WM_GETMINMAXINFO = 36
+WM_PAINTICON = 38
+WM_ICONERASEBKGND = 39
+WM_NEXTDLGCTL = 40
+WM_SPOOLERSTATUS = 42
+WM_DRAWITEM = 43
+WM_MEASUREITEM = 44
+WM_DELETEITEM = 45
+WM_VKEYTOITEM = 46
+WM_CHARTOITEM = 47
+WM_SETFONT = 48
+WM_GETFONT = 49
+WM_SETHOTKEY = 50
+WM_GETHOTKEY = 51
+WM_QUERYDRAGICON = 55
+WM_COMPAREITEM = 57
+WM_GETOBJECT = 61
+WM_COMPACTING = 65
+WM_COMMNOTIFY = 68
+WM_WINDOWPOSCHANGING = 70
+WM_WINDOWPOSCHANGED = 71
+WM_POWER = 72
+PWR_OK = 1
+PWR_FAIL = -1
+PWR_SUSPENDREQUEST = 1
+PWR_SUSPENDRESUME = 2
+PWR_CRITICALRESUME = 3
+WM_COPYDATA = 74
+WM_CANCELJOURNAL = 75
+WM_NOTIFY = 78
+WM_INPUTLANGCHANGEREQUEST = 80
+WM_INPUTLANGCHANGE = 81
+WM_TCARD = 82
+WM_HELP = 83
+WM_USERCHANGED = 84
+WM_NOTIFYFORMAT = 85
+NFR_ANSI = 1
+NFR_UNICODE = 2
+NF_QUERY = 3
+NF_REQUERY = 4
+WM_CONTEXTMENU = 123
+WM_STYLECHANGING = 124
+WM_STYLECHANGED = 125
+WM_DISPLAYCHANGE = 126
+WM_GETICON = 127
+WM_SETICON = 128
+WM_NCCREATE = 129
+WM_NCDESTROY = 130
+WM_NCCALCSIZE = 131
+WM_NCHITTEST = 132
+WM_NCPAINT = 133
+WM_NCACTIVATE = 134
+WM_GETDLGCODE = 135
+WM_SYNCPAINT = 136
+WM_NCMOUSEMOVE = 160
+WM_NCLBUTTONDOWN = 161
+WM_NCLBUTTONUP = 162
+WM_NCLBUTTONDBLCLK = 163
+WM_NCRBUTTONDOWN = 164
+WM_NCRBUTTONUP = 165
+WM_NCRBUTTONDBLCLK = 166
+WM_NCMBUTTONDOWN = 167
+WM_NCMBUTTONUP = 168
+WM_NCMBUTTONDBLCLK = 169
+WM_KEYFIRST = 256
+WM_KEYDOWN = 256
+WM_KEYUP = 257
+WM_CHAR = 258
+WM_DEADCHAR = 259
+WM_SYSKEYDOWN = 260
+WM_SYSKEYUP = 261
+WM_SYSCHAR = 262
+WM_SYSDEADCHAR = 263
+WM_KEYLAST = 264
+WM_IME_STARTCOMPOSITION = 269
+WM_IME_ENDCOMPOSITION = 270
+WM_IME_COMPOSITION = 271
+WM_IME_KEYLAST = 271
+WM_INITDIALOG = 272
+WM_COMMAND = 273
+WM_SYSCOMMAND = 274
+WM_TIMER = 275
+WM_HSCROLL = 276
+WM_VSCROLL = 277
+WM_INITMENU = 278
+WM_INITMENUPOPUP = 279
+WM_MENUSELECT = 287
+WM_MENUCHAR = 288
+WM_ENTERIDLE = 289
+WM_MENURBUTTONUP = 290
+WM_MENUDRAG = 291
+WM_MENUGETOBJECT = 292
+WM_UNINITMENUPOPUP = 293
+WM_MENUCOMMAND = 294
+WM_CTLCOLORMSGBOX = 306
+WM_CTLCOLOREDIT = 307
+WM_CTLCOLORLISTBOX = 308
+WM_CTLCOLORBTN = 309
+WM_CTLCOLORDLG = 310
+WM_CTLCOLORSCROLLBAR = 311
+WM_CTLCOLORSTATIC = 312
+WM_MOUSEFIRST = 512
+WM_MOUSEMOVE = 512
+WM_LBUTTONDOWN = 513
+WM_LBUTTONUP = 514
+WM_LBUTTONDBLCLK = 515
+WM_RBUTTONDOWN = 516
+WM_RBUTTONUP = 517
+WM_RBUTTONDBLCLK = 518
+WM_MBUTTONDOWN = 519
+WM_MBUTTONUP = 520
+WM_MBUTTONDBLCLK = 521
+WM_MOUSEWHEEL = 522
+WM_MOUSELAST = 522
+WHEEL_DELTA = 120  # Value for rolling one detent
+WHEEL_PAGESCROLL = -1  # Scroll one page
+WM_PARENTNOTIFY = 528
+MENULOOP_WINDOW = 0
+MENULOOP_POPUP = 1
+WM_ENTERMENULOOP = 529
+WM_EXITMENULOOP = 530
+WM_NEXTMENU = 531
+WM_SIZING = 532
+WM_CAPTURECHANGED = 533
+WM_MOVING = 534
+WM_POWERBROADCAST = 536
+PBT_APMQUERYSUSPEND = 0
+PBT_APMQUERYSTANDBY = 1
+PBT_APMQUERYSUSPENDFAILED = 2
+PBT_APMQUERYSTANDBYFAILED = 3
+PBT_APMSUSPEND = 4
+PBT_APMSTANDBY = 5
+PBT_APMRESUMECRITICAL = 6
+PBT_APMRESUMESUSPEND = 7
+PBT_APMRESUMESTANDBY = 8
+PBTF_APMRESUMEFROMFAILURE = 1
+PBT_APMBATTERYLOW = 9
+PBT_APMPOWERSTATUSCHANGE = 10
+PBT_APMOEMEVENT = 11
+PBT_APMRESUMEAUTOMATIC = 18
+WM_DEVICECHANGE = 537
+WM_MDICREATE = 544
+WM_MDIDESTROY = 545
+WM_MDIACTIVATE = 546
+WM_MDIRESTORE = 547
+WM_MDINEXT = 548
+WM_MDIMAXIMIZE = 549
+WM_MDITILE = 550
+WM_MDICASCADE = 551
+WM_MDIICONARRANGE = 552
+WM_MDIGETACTIVE = 553
+WM_MDISETMENU = 560
+WM_ENTERSIZEMOVE = 561
+WM_EXITSIZEMOVE = 562
+WM_DROPFILES = 563
+WM_MDIREFRESHMENU = 564
+WM_IME_SETCONTEXT = 641
+WM_IME_NOTIFY = 642
+WM_IME_CONTROL = 643
+WM_IME_COMPOSITIONFULL = 644
+WM_IME_SELECT = 645
+WM_IME_CHAR = 646
+WM_IME_REQUEST = 648
+WM_IME_KEYDOWN = 656
+WM_IME_KEYUP = 657
+WM_MOUSEHOVER = 673
+WM_MOUSELEAVE = 675
+WM_CUT = 768
+WM_COPY = 769
+WM_PASTE = 770
+WM_CLEAR = 771
+WM_UNDO = 772
+WM_RENDERFORMAT = 773
+WM_RENDERALLFORMATS = 774
+WM_DESTROYCLIPBOARD = 775
+WM_DRAWCLIPBOARD = 776
+WM_PAINTCLIPBOARD = 777
+WM_VSCROLLCLIPBOARD = 778
+WM_SIZECLIPBOARD = 779
+WM_ASKCBFORMATNAME = 780
+WM_CHANGECBCHAIN = 781
+WM_HSCROLLCLIPBOARD = 782
+WM_QUERYNEWPALETTE = 783
+WM_PALETTEISCHANGING = 784
+WM_PALETTECHANGED = 785
+WM_HOTKEY = 786
+WM_PRINT = 791
+WM_PRINTCLIENT = 792
+WM_HANDHELDFIRST = 856
+WM_HANDHELDLAST = 863
+WM_AFXFIRST = 864
+WM_AFXLAST = 895
+WM_PENWINFIRST = 896
+WM_PENWINLAST = 911
+WM_APP = 32768
+WMSZ_LEFT = 1
+WMSZ_RIGHT = 2
+WMSZ_TOP = 3
+WMSZ_TOPLEFT = 4
+WMSZ_TOPRIGHT = 5
+WMSZ_BOTTOM = 6
+WMSZ_BOTTOMLEFT = 7
+WMSZ_BOTTOMRIGHT = 8
+# ST_BEGINSWP = 0
+# ST_ENDSWP = 1
+HTERROR = -2
+HTTRANSPARENT = -1
+HTNOWHERE = 0
+HTCLIENT = 1
+HTCAPTION = 2
+HTSYSMENU = 3
+HTGROWBOX = 4
+HTSIZE = HTGROWBOX
+HTMENU = 5
+HTHSCROLL = 6
+HTVSCROLL = 7
+HTMINBUTTON = 8
+HTMAXBUTTON = 9
+HTLEFT = 10
+HTRIGHT = 11
+HTTOP = 12
+HTTOPLEFT = 13
+HTTOPRIGHT = 14
+HTBOTTOM = 15
+HTBOTTOMLEFT = 16
+HTBOTTOMRIGHT = 17
+HTBORDER = 18
+HTREDUCE = HTMINBUTTON
+HTZOOM = HTMAXBUTTON
+HTSIZEFIRST = HTLEFT
+HTSIZELAST = HTBOTTOMRIGHT
+HTOBJECT = 19
+HTCLOSE = 20
+HTHELP = 21
+SMTO_NORMAL = 0
+SMTO_BLOCK = 1
+SMTO_ABORTIFHUNG = 2
+SMTO_NOTIMEOUTIFNOTHUNG = 8
+MA_ACTIVATE = 1
+MA_ACTIVATEANDEAT = 2
+MA_NOACTIVATE = 3
+MA_NOACTIVATEANDEAT = 4
+ICON_SMALL = 0
+ICON_BIG = 1
+SIZE_RESTORED = 0
+SIZE_MINIMIZED = 1
+SIZE_MAXIMIZED = 2
+SIZE_MAXSHOW = 3
+SIZE_MAXHIDE = 4
+SIZENORMAL = SIZE_RESTORED
+SIZEICONIC = SIZE_MINIMIZED
+SIZEFULLSCREEN = SIZE_MAXIMIZED
+SIZEZOOMSHOW = SIZE_MAXSHOW
+SIZEZOOMHIDE = SIZE_MAXHIDE
+WVR_ALIGNTOP = 16
+WVR_ALIGNLEFT = 32
+WVR_ALIGNBOTTOM = 64
+WVR_ALIGNRIGHT = 128
+WVR_HREDRAW = 256
+WVR_VREDRAW = 512
+WVR_REDRAW = WVR_HREDRAW | WVR_VREDRAW
+WVR_VALIDRECTS = 1024
+MK_LBUTTON = 1
+MK_RBUTTON = 2
+MK_SHIFT = 4
+MK_CONTROL = 8
+MK_MBUTTON = 16
+TME_HOVER = 1
+TME_LEAVE = 2
+TME_QUERY = 1073741824
+TME_CANCEL = -2147483648
+HOVER_DEFAULT = -1
+WS_OVERLAPPED = 0
+WS_POPUP = -2147483648
+WS_CHILD = 1073741824
+WS_MINIMIZE = 536870912
+WS_VISIBLE = 268435456
+WS_DISABLED = 134217728
+WS_CLIPSIBLINGS = 67108864
+WS_CLIPCHILDREN = 33554432
+WS_MAXIMIZE = 16777216
+WS_CAPTION = 12582912
+WS_BORDER = 8388608
+WS_DLGFRAME = 4194304
+WS_VSCROLL = 2097152
+WS_HSCROLL = 1048576
+WS_SYSMENU = 524288
+WS_THICKFRAME = 262144
+WS_GROUP = 131072
+WS_TABSTOP = 65536
+WS_MINIMIZEBOX = 131072
+WS_MAXIMIZEBOX = 65536
+WS_TILED = WS_OVERLAPPED
+WS_ICONIC = WS_MINIMIZE
+WS_SIZEBOX = WS_THICKFRAME
+WS_OVERLAPPEDWINDOW = (
+    WS_OVERLAPPED
+    | WS_CAPTION
+    | WS_SYSMENU
+    | WS_THICKFRAME
+    | WS_MINIMIZEBOX
+    | WS_MAXIMIZEBOX
+)
+WS_POPUPWINDOW = WS_POPUP | WS_BORDER | WS_SYSMENU
+WS_CHILDWINDOW = WS_CHILD
+WS_TILEDWINDOW = WS_OVERLAPPEDWINDOW
+WS_EX_DLGMODALFRAME = 1
+WS_EX_NOPARENTNOTIFY = 4
+WS_EX_TOPMOST = 8
+WS_EX_ACCEPTFILES = 16
+WS_EX_TRANSPARENT = 32
+WS_EX_MDICHILD = 64
+WS_EX_TOOLWINDOW = 128
+WS_EX_WINDOWEDGE = 256
+WS_EX_CLIENTEDGE = 512
+WS_EX_CONTEXTHELP = 1024
+WS_EX_RIGHT = 4096
+WS_EX_LEFT = 0
+WS_EX_RTLREADING = 8192
+WS_EX_LTRREADING = 0
+WS_EX_LEFTSCROLLBAR = 16384
+WS_EX_RIGHTSCROLLBAR = 0
+WS_EX_CONTROLPARENT = 65536
+WS_EX_STATICEDGE = 131072
+WS_EX_APPWINDOW = 262144
+WS_EX_OVERLAPPEDWINDOW = WS_EX_WINDOWEDGE | WS_EX_CLIENTEDGE
+WS_EX_PALETTEWINDOW = WS_EX_WINDOWEDGE | WS_EX_TOOLWINDOW | WS_EX_TOPMOST
+WS_EX_LAYERED = 0x00080000
+WS_EX_NOINHERITLAYOUT = 0x00100000
+WS_EX_LAYOUTRTL = 0x00400000
+WS_EX_COMPOSITED = 0x02000000
+WS_EX_NOACTIVATE = 0x08000000
+
+CS_VREDRAW = 1
+CS_HREDRAW = 2
+# CS_KEYCVTWINDOW = 0x0004
+CS_DBLCLKS = 8
+CS_OWNDC = 32
+CS_CLASSDC = 64
+CS_PARENTDC = 128
+# CS_NOKEYCVT = 0x0100
+CS_NOCLOSE = 512
+CS_SAVEBITS = 2048
+CS_BYTEALIGNCLIENT = 4096
+CS_BYTEALIGNWINDOW = 8192
+CS_GLOBALCLASS = 16384
+CS_IME = 65536
+PRF_CHECKVISIBLE = 1
+PRF_NONCLIENT = 2
+PRF_CLIENT = 4
+PRF_ERASEBKGND = 8
+PRF_CHILDREN = 16
+PRF_OWNED = 32
+BDR_RAISEDOUTER = 1
+BDR_SUNKENOUTER = 2
+BDR_RAISEDINNER = 4
+BDR_SUNKENINNER = 8
+BDR_OUTER = 3
+BDR_INNER = 12
+# BDR_RAISED = 0x0005
+# BDR_SUNKEN = 0x000a
+EDGE_RAISED = BDR_RAISEDOUTER | BDR_RAISEDINNER
+EDGE_SUNKEN = BDR_SUNKENOUTER | BDR_SUNKENINNER
+EDGE_ETCHED = BDR_SUNKENOUTER | BDR_RAISEDINNER
+EDGE_BUMP = BDR_RAISEDOUTER | BDR_SUNKENINNER
+
+# winuser.h line 2879
+ISMEX_NOSEND = 0
+ISMEX_SEND = 1
+ISMEX_NOTIFY = 2
+ISMEX_CALLBACK = 4
+ISMEX_REPLIED = 8
+CW_USEDEFAULT = -2147483648
+FLASHW_STOP = 0
+FLASHW_CAPTION = 1
+FLASHW_TRAY = 2
+FLASHW_ALL = FLASHW_CAPTION | FLASHW_TRAY
+FLASHW_TIMER = 4
+FLASHW_TIMERNOFG = 12
+
+# winuser.h line 7963
+DS_ABSALIGN = 1
+DS_SYSMODAL = 2
+DS_LOCALEDIT = 32
+DS_SETFONT = 64
+DS_MODALFRAME = 128
+DS_NOIDLEMSG = 256
+DS_SETFOREGROUND = 512
+DS_3DLOOK = 4
+DS_FIXEDSYS = 8
+DS_NOFAILCREATE = 16
+DS_CONTROL = 1024
+DS_CENTER = 2048
+DS_CENTERMOUSE = 4096
+DS_CONTEXTHELP = 8192
+DM_GETDEFID = WM_USER + 0
+DM_SETDEFID = WM_USER + 1
+DM_REPOSITION = WM_USER + 2
+# PSM_PAGEINFO = (WM_USER+100)
+# PSM_SHEETINFO = (WM_USER+101)
+# PSI_SETACTIVE = 0x0001
+# PSI_KILLACTIVE = 0x0002
+# PSI_APPLY = 0x0003
+# PSI_RESET = 0x0004
+# PSI_HASHELP = 0x0005
+# PSI_HELP = 0x0006
+# PSI_CHANGED = 0x0001
+# PSI_GUISTART = 0x0002
+# PSI_REBOOT = 0x0003
+# PSI_GETSIBLINGS = 0x0004
+DC_HASDEFID = 21323
+DLGC_WANTARROWS = 1
+DLGC_WANTTAB = 2
+DLGC_WANTALLKEYS = 4
+DLGC_WANTMESSAGE = 4
+DLGC_HASSETSEL = 8
+DLGC_DEFPUSHBUTTON = 16
+DLGC_UNDEFPUSHBUTTON = 32
+DLGC_RADIOBUTTON = 64
+DLGC_WANTCHARS = 128
+DLGC_STATIC = 256
+DLGC_BUTTON = 8192
+LB_CTLCODE = 0
+LB_OKAY = 0
+LB_ERR = -1
+LB_ERRSPACE = -2
+LBN_ERRSPACE = -2
+LBN_SELCHANGE = 1
+LBN_DBLCLK = 2
+LBN_SELCANCEL = 3
+LBN_SETFOCUS = 4
+LBN_KILLFOCUS = 5
+LB_ADDSTRING = 384
+LB_INSERTSTRING = 385
+LB_DELETESTRING = 386
+LB_SELITEMRANGEEX = 387
+LB_RESETCONTENT = 388
+LB_SETSEL = 389
+LB_SETCURSEL = 390
+LB_GETSEL = 391
+LB_GETCURSEL = 392
+LB_GETTEXT = 393
+LB_GETTEXTLEN = 394
+LB_GETCOUNT = 395
+LB_SELECTSTRING = 396
+LB_DIR = 397
+LB_GETTOPINDEX = 398
+LB_FINDSTRING = 399
+LB_GETSELCOUNT = 400
+LB_GETSELITEMS = 401
+LB_SETTABSTOPS = 402
+LB_GETHORIZONTALEXTENT = 403
+LB_SETHORIZONTALEXTENT = 404
+LB_SETCOLUMNWIDTH = 405
+LB_ADDFILE = 406
+LB_SETTOPINDEX = 407
+LB_GETITEMRECT = 408
+LB_GETITEMDATA = 409
+LB_SETITEMDATA = 410
+LB_SELITEMRANGE = 411
+LB_SETANCHORINDEX = 412
+LB_GETANCHORINDEX = 413
+LB_SETCARETINDEX = 414
+LB_GETCARETINDEX = 415
+LB_SETITEMHEIGHT = 416
+LB_GETITEMHEIGHT = 417
+LB_FINDSTRINGEXACT = 418
+LB_SETLOCALE = 421
+LB_GETLOCALE = 422
+LB_SETCOUNT = 423
+LB_INITSTORAGE = 424
+LB_ITEMFROMPOINT = 425
+LB_MSGMAX = 432
+LBS_NOTIFY = 1
+LBS_SORT = 2
+LBS_NOREDRAW = 4
+LBS_MULTIPLESEL = 8
+LBS_OWNERDRAWFIXED = 16
+LBS_OWNERDRAWVARIABLE = 32
+LBS_HASSTRINGS = 64
+LBS_USETABSTOPS = 128
+LBS_NOINTEGRALHEIGHT = 256
+LBS_MULTICOLUMN = 512
+LBS_WANTKEYBOARDINPUT = 1024
+LBS_EXTENDEDSEL = 2048
+LBS_DISABLENOSCROLL = 4096
+LBS_NODATA = 8192
+LBS_NOSEL = 16384
+LBS_STANDARD = LBS_NOTIFY | LBS_SORT | WS_VSCROLL | WS_BORDER
+CB_OKAY = 0
+CB_ERR = -1
+CB_ERRSPACE = -2
+CBN_ERRSPACE = -1
+CBN_SELCHANGE = 1
+CBN_DBLCLK = 2
+CBN_SETFOCUS = 3
+CBN_KILLFOCUS = 4
+CBN_EDITCHANGE = 5
+CBN_EDITUPDATE = 6
+CBN_DROPDOWN = 7
+CBN_CLOSEUP = 8
+CBN_SELENDOK = 9
+CBN_SELENDCANCEL = 10
+CBS_SIMPLE = 1
+CBS_DROPDOWN = 2
+CBS_DROPDOWNLIST = 3
+CBS_OWNERDRAWFIXED = 16
+CBS_OWNERDRAWVARIABLE = 32
+CBS_AUTOHSCROLL = 64
+CBS_OEMCONVERT = 128
+CBS_SORT = 256
+CBS_HASSTRINGS = 512
+CBS_NOINTEGRALHEIGHT = 1024
+CBS_DISABLENOSCROLL = 2048
+CBS_UPPERCASE = 8192
+CBS_LOWERCASE = 16384
+CB_GETEDITSEL = 320
+CB_LIMITTEXT = 321
+CB_SETEDITSEL = 322
+CB_ADDSTRING = 323
+CB_DELETESTRING = 324
+CB_DIR = 325
+CB_GETCOUNT = 326
+CB_GETCURSEL = 327
+CB_GETLBTEXT = 328
+CB_GETLBTEXTLEN = 329
+CB_INSERTSTRING = 330
+CB_RESETCONTENT = 331
+CB_FINDSTRING = 332
+CB_SELECTSTRING = 333
+CB_SETCURSEL = 334
+CB_SHOWDROPDOWN = 335
+CB_GETITEMDATA = 336
+CB_SETITEMDATA = 337
+CB_GETDROPPEDCONTROLRECT = 338
+CB_SETITEMHEIGHT = 339
+CB_GETITEMHEIGHT = 340
+CB_SETEXTENDEDUI = 341
+CB_GETEXTENDEDUI = 342
+CB_GETDROPPEDSTATE = 343
+CB_FINDSTRINGEXACT = 344
+CB_SETLOCALE = 345
+CB_GETLOCALE = 346
+CB_GETTOPINDEX = 347
+CB_SETTOPINDEX = 348
+CB_GETHORIZONTALEXTENT = 349
+CB_SETHORIZONTALEXTENT = 350
+CB_GETDROPPEDWIDTH = 351
+CB_SETDROPPEDWIDTH = 352
+CB_INITSTORAGE = 353
+CB_MSGMAX = 354
+SBS_HORZ = 0
+SBS_VERT = 1
+SBS_TOPALIGN = 2
+SBS_LEFTALIGN = 2
+SBS_BOTTOMALIGN = 4
+SBS_RIGHTALIGN = 4
+SBS_SIZEBOXTOPLEFTALIGN = 2
+SBS_SIZEBOXBOTTOMRIGHTALIGN = 4
+SBS_SIZEBOX = 8
+SBS_SIZEGRIP = 16
+SBM_SETPOS = 224
+SBM_GETPOS = 225
+SBM_SETRANGE = 226
+SBM_SETRANGEREDRAW = 230
+SBM_GETRANGE = 227
+SBM_ENABLE_ARROWS = 228
+SBM_SETSCROLLINFO = 233
+SBM_GETSCROLLINFO = 234
+SIF_RANGE = 1
+SIF_PAGE = 2
+SIF_POS = 4
+SIF_DISABLENOSCROLL = 8
+SIF_TRACKPOS = 16
+SIF_ALL = SIF_RANGE | SIF_PAGE | SIF_POS | SIF_TRACKPOS
+MDIS_ALLCHILDSTYLES = 1
+MDITILE_VERTICAL = 0
+MDITILE_HORIZONTAL = 1
+MDITILE_SKIPDISABLED = 2
+MDITILE_ZORDER = 4
+
+IMC_GETCANDIDATEPOS = 7
+IMC_SETCANDIDATEPOS = 8
+IMC_GETCOMPOSITIONFONT = 9
+IMC_SETCOMPOSITIONFONT = 10
+IMC_GETCOMPOSITIONWINDOW = 11
+IMC_SETCOMPOSITIONWINDOW = 12
+IMC_GETSTATUSWINDOWPOS = 15
+IMC_SETSTATUSWINDOWPOS = 16
+IMC_CLOSESTATUSWINDOW = 33
+IMC_OPENSTATUSWINDOW = 34
+# Generated by h2py from \msvc20\include\winnt.h
+# hacked and split by mhammond.
+DELETE = 65536
+READ_CONTROL = 131072
+WRITE_DAC = 262144
+WRITE_OWNER = 524288
+SYNCHRONIZE = 1048576
+STANDARD_RIGHTS_REQUIRED = 983040
+STANDARD_RIGHTS_READ = READ_CONTROL
+STANDARD_RIGHTS_WRITE = READ_CONTROL
+STANDARD_RIGHTS_EXECUTE = READ_CONTROL
+STANDARD_RIGHTS_ALL = 2031616
+SPECIFIC_RIGHTS_ALL = 65535
+ACCESS_SYSTEM_SECURITY = 16777216
+MAXIMUM_ALLOWED = 33554432
+GENERIC_READ = -2147483648
+GENERIC_WRITE = 1073741824
+GENERIC_EXECUTE = 536870912
+GENERIC_ALL = 268435456
+
+SERVICE_KERNEL_DRIVER = 1
+SERVICE_FILE_SYSTEM_DRIVER = 2
+SERVICE_ADAPTER = 4
+SERVICE_RECOGNIZER_DRIVER = 8
+SERVICE_DRIVER = (
+    SERVICE_KERNEL_DRIVER | SERVICE_FILE_SYSTEM_DRIVER | SERVICE_RECOGNIZER_DRIVER
+)
+SERVICE_WIN32_OWN_PROCESS = 16
+SERVICE_WIN32_SHARE_PROCESS = 32
+SERVICE_WIN32 = SERVICE_WIN32_OWN_PROCESS | SERVICE_WIN32_SHARE_PROCESS
+SERVICE_INTERACTIVE_PROCESS = 256
+SERVICE_TYPE_ALL = (
+    SERVICE_WIN32 | SERVICE_ADAPTER | SERVICE_DRIVER | SERVICE_INTERACTIVE_PROCESS
+)
+SERVICE_BOOT_START = 0
+SERVICE_SYSTEM_START = 1
+SERVICE_AUTO_START = 2
+SERVICE_DEMAND_START = 3
+SERVICE_DISABLED = 4
+SERVICE_ERROR_IGNORE = 0
+SERVICE_ERROR_NORMAL = 1
+SERVICE_ERROR_SEVERE = 2
+SERVICE_ERROR_CRITICAL = 3
+TAPE_ERASE_SHORT = 0
+TAPE_ERASE_LONG = 1
+TAPE_LOAD = 0
+TAPE_UNLOAD = 1
+TAPE_TENSION = 2
+TAPE_LOCK = 3
+TAPE_UNLOCK = 4
+TAPE_FORMAT = 5
+TAPE_SETMARKS = 0
+TAPE_FILEMARKS = 1
+TAPE_SHORT_FILEMARKS = 2
+TAPE_LONG_FILEMARKS = 3
+TAPE_ABSOLUTE_POSITION = 0
+TAPE_LOGICAL_POSITION = 1
+TAPE_PSEUDO_LOGICAL_POSITION = 2
+TAPE_REWIND = 0
+TAPE_ABSOLUTE_BLOCK = 1
+TAPE_LOGICAL_BLOCK = 2
+TAPE_PSEUDO_LOGICAL_BLOCK = 3
+TAPE_SPACE_END_OF_DATA = 4
+TAPE_SPACE_RELATIVE_BLOCKS = 5
+TAPE_SPACE_FILEMARKS = 6
+TAPE_SPACE_SEQUENTIAL_FMKS = 7
+TAPE_SPACE_SETMARKS = 8
+TAPE_SPACE_SEQUENTIAL_SMKS = 9
+TAPE_DRIVE_FIXED = 1
+TAPE_DRIVE_SELECT = 2
+TAPE_DRIVE_INITIATOR = 4
+TAPE_DRIVE_ERASE_SHORT = 16
+TAPE_DRIVE_ERASE_LONG = 32
+TAPE_DRIVE_ERASE_BOP_ONLY = 64
+TAPE_DRIVE_ERASE_IMMEDIATE = 128
+TAPE_DRIVE_TAPE_CAPACITY = 256
+TAPE_DRIVE_TAPE_REMAINING = 512
+TAPE_DRIVE_FIXED_BLOCK = 1024
+TAPE_DRIVE_VARIABLE_BLOCK = 2048
+TAPE_DRIVE_WRITE_PROTECT = 4096
+TAPE_DRIVE_EOT_WZ_SIZE = 8192
+TAPE_DRIVE_ECC = 65536
+TAPE_DRIVE_COMPRESSION = 131072
+TAPE_DRIVE_PADDING = 262144
+TAPE_DRIVE_REPORT_SMKS = 524288
+TAPE_DRIVE_GET_ABSOLUTE_BLK = 1048576
+TAPE_DRIVE_GET_LOGICAL_BLK = 2097152
+TAPE_DRIVE_SET_EOT_WZ_SIZE = 4194304
+TAPE_DRIVE_LOAD_UNLOAD = -2147483647
+TAPE_DRIVE_TENSION = -2147483646
+TAPE_DRIVE_LOCK_UNLOCK = -2147483644
+TAPE_DRIVE_REWIND_IMMEDIATE = -2147483640
+TAPE_DRIVE_SET_BLOCK_SIZE = -2147483632
+TAPE_DRIVE_LOAD_UNLD_IMMED = -2147483616
+TAPE_DRIVE_TENSION_IMMED = -2147483584
+TAPE_DRIVE_LOCK_UNLK_IMMED = -2147483520
+TAPE_DRIVE_SET_ECC = -2147483392
+TAPE_DRIVE_SET_COMPRESSION = -2147483136
+TAPE_DRIVE_SET_PADDING = -2147482624
+TAPE_DRIVE_SET_REPORT_SMKS = -2147481600
+TAPE_DRIVE_ABSOLUTE_BLK = -2147479552
+TAPE_DRIVE_ABS_BLK_IMMED = -2147475456
+TAPE_DRIVE_LOGICAL_BLK = -2147467264
+TAPE_DRIVE_LOG_BLK_IMMED = -2147450880
+TAPE_DRIVE_END_OF_DATA = -2147418112
+TAPE_DRIVE_RELATIVE_BLKS = -2147352576
+TAPE_DRIVE_FILEMARKS = -2147221504
+TAPE_DRIVE_SEQUENTIAL_FMKS = -2146959360
+TAPE_DRIVE_SETMARKS = -2146435072
+TAPE_DRIVE_SEQUENTIAL_SMKS = -2145386496
+TAPE_DRIVE_REVERSE_POSITION = -2143289344
+TAPE_DRIVE_SPACE_IMMEDIATE = -2139095040
+TAPE_DRIVE_WRITE_SETMARKS = -2130706432
+TAPE_DRIVE_WRITE_FILEMARKS = -2113929216
+TAPE_DRIVE_WRITE_SHORT_FMKS = -2080374784
+TAPE_DRIVE_WRITE_LONG_FMKS = -2013265920
+TAPE_DRIVE_WRITE_MARK_IMMED = -1879048192
+TAPE_DRIVE_FORMAT = -1610612736
+TAPE_DRIVE_FORMAT_IMMEDIATE = -1073741824
+TAPE_FIXED_PARTITIONS = 0
+TAPE_SELECT_PARTITIONS = 1
+TAPE_INITIATOR_PARTITIONS = 2
+# Generated by h2py from \msvc20\include\winnt.h
+# hacked and split by mhammond.
+
+APPLICATION_ERROR_MASK = 536870912
+ERROR_SEVERITY_SUCCESS = 0
+ERROR_SEVERITY_INFORMATIONAL = 1073741824
+ERROR_SEVERITY_WARNING = -2147483648
+ERROR_SEVERITY_ERROR = -1073741824
+MINCHAR = 128
+MAXCHAR = 127
+MINSHORT = 32768
+MAXSHORT = 32767
+MINLONG = -2147483648
+MAXLONG = 2147483647
+MAXBYTE = 255
+MAXWORD = 65535
+MAXDWORD = -1
+LANG_NEUTRAL = 0
+LANG_BULGARIAN = 2
+LANG_CHINESE = 4
+LANG_CROATIAN = 26
+LANG_CZECH = 5
+LANG_DANISH = 6
+LANG_DUTCH = 19
+LANG_ENGLISH = 9
+LANG_FINNISH = 11
+LANG_FRENCH = 12
+LANG_GERMAN = 7
+LANG_GREEK = 8
+LANG_HUNGARIAN = 14
+LANG_ICELANDIC = 15
+LANG_ITALIAN = 16
+LANG_JAPANESE = 17
+LANG_KOREAN = 18
+LANG_NORWEGIAN = 20
+LANG_POLISH = 21
+LANG_PORTUGUESE = 22
+LANG_ROMANIAN = 24
+LANG_RUSSIAN = 25
+LANG_SLOVAK = 27
+LANG_SLOVENIAN = 36
+LANG_SPANISH = 10
+LANG_SWEDISH = 29
+LANG_TURKISH = 31
+SUBLANG_NEUTRAL = 0
+SUBLANG_DEFAULT = 1
+SUBLANG_SYS_DEFAULT = 2
+SUBLANG_CHINESE_TRADITIONAL = 1
+SUBLANG_CHINESE_SIMPLIFIED = 2
+SUBLANG_CHINESE_HONGKONG = 3
+SUBLANG_CHINESE_SINGAPORE = 4
+SUBLANG_DUTCH = 1
+SUBLANG_DUTCH_BELGIAN = 2
+SUBLANG_ENGLISH_US = 1
+SUBLANG_ENGLISH_UK = 2
+SUBLANG_ENGLISH_AUS = 3
+SUBLANG_ENGLISH_CAN = 4
+SUBLANG_ENGLISH_NZ = 5
+SUBLANG_ENGLISH_EIRE = 6
+SUBLANG_FRENCH = 1
+SUBLANG_FRENCH_BELGIAN = 2
+SUBLANG_FRENCH_CANADIAN = 3
+SUBLANG_FRENCH_SWISS = 4
+SUBLANG_GERMAN = 1
+SUBLANG_GERMAN_SWISS = 2
+SUBLANG_GERMAN_AUSTRIAN = 3
+SUBLANG_ITALIAN = 1
+SUBLANG_ITALIAN_SWISS = 2
+SUBLANG_NORWEGIAN_BOKMAL = 1
+SUBLANG_NORWEGIAN_NYNORSK = 2
+SUBLANG_PORTUGUESE = 2
+SUBLANG_PORTUGUESE_BRAZILIAN = 1
+SUBLANG_SPANISH = 1
+SUBLANG_SPANISH_MEXICAN = 2
+SUBLANG_SPANISH_MODERN = 3
+SORT_DEFAULT = 0
+SORT_JAPANESE_XJIS = 0
+SORT_JAPANESE_UNICODE = 1
+SORT_CHINESE_BIG5 = 0
+SORT_CHINESE_UNICODE = 1
+SORT_KOREAN_KSC = 0
+SORT_KOREAN_UNICODE = 1
+
+
+def PRIMARYLANGID(lgid):
+    return (lgid) & 1023
+
+
+def SUBLANGID(lgid):
+    return (lgid) >> 10
+
+
+NLS_VALID_LOCALE_MASK = 1048575
+CONTEXT_PORTABLE_32BIT = 1048576
+CONTEXT_ALPHA = 131072
+CONTEXT_CONTROL = CONTEXT_ALPHA | 1
+CONTEXT_FLOATING_POINT = CONTEXT_ALPHA | 2
+CONTEXT_INTEGER = CONTEXT_ALPHA | 4
+CONTEXT_FULL = CONTEXT_CONTROL | CONTEXT_FLOATING_POINT | CONTEXT_INTEGER
+SIZE_OF_80387_REGISTERS = 80
+CONTEXT_FULL = CONTEXT_CONTROL | CONTEXT_FLOATING_POINT | CONTEXT_INTEGER
+CONTEXT_CONTROL = 1
+CONTEXT_FLOATING_POINT = 2
+CONTEXT_INTEGER = 4
+CONTEXT_FULL = CONTEXT_CONTROL | CONTEXT_FLOATING_POINT | CONTEXT_INTEGER
+PROCESS_TERMINATE = 1
+PROCESS_CREATE_THREAD = 2
+PROCESS_VM_OPERATION = 8
+PROCESS_VM_READ = 16
+PROCESS_VM_WRITE = 32
+PROCESS_DUP_HANDLE = 64
+PROCESS_CREATE_PROCESS = 128
+PROCESS_SET_QUOTA = 256
+PROCESS_SET_INFORMATION = 512
+PROCESS_QUERY_INFORMATION = 1024
+PROCESS_SUSPEND_RESUME = 2048
+PROCESS_QUERY_LIMITED_INFORMATION = 4096
+PROCESS_SET_LIMITED_INFORMATION = 8192
+PROCESS_ALL_ACCESS = STANDARD_RIGHTS_REQUIRED | SYNCHRONIZE | 4095
+THREAD_TERMINATE = 1
+THREAD_SUSPEND_RESUME = 2
+THREAD_GET_CONTEXT = 8
+THREAD_SET_CONTEXT = 16
+THREAD_SET_INFORMATION = 32
+THREAD_QUERY_INFORMATION = 64
+THREAD_SET_THREAD_TOKEN = 128
+THREAD_IMPERSONATE = 256
+THREAD_DIRECT_IMPERSONATION = 512
+THREAD_SET_LIMITED_INFORMATION = 1024
+THREAD_QUERY_LIMITED_INFORMATION = 2048
+THREAD_RESUME = 4096
+TLS_MINIMUM_AVAILABLE = 64
+EVENT_MODIFY_STATE = 2
+MUTANT_QUERY_STATE = 1
+SEMAPHORE_MODIFY_STATE = 2
+TIME_ZONE_ID_UNKNOWN = 0
+TIME_ZONE_ID_STANDARD = 1
+TIME_ZONE_ID_DAYLIGHT = 2
+PROCESSOR_INTEL_386 = 386
+PROCESSOR_INTEL_486 = 486
+PROCESSOR_INTEL_PENTIUM = 586
+PROCESSOR_INTEL_860 = 860
+PROCESSOR_MIPS_R2000 = 2000
+PROCESSOR_MIPS_R3000 = 3000
+PROCESSOR_MIPS_R4000 = 4000
+PROCESSOR_ALPHA_21064 = 21064
+PROCESSOR_PPC_601 = 601
+PROCESSOR_PPC_603 = 603
+PROCESSOR_PPC_604 = 604
+PROCESSOR_PPC_620 = 620
+SECTION_QUERY = 1
+SECTION_MAP_WRITE = 2
+SECTION_MAP_READ = 4
+SECTION_MAP_EXECUTE = 8
+SECTION_EXTEND_SIZE = 16
+PAGE_NOACCESS = 1
+PAGE_READONLY = 2
+PAGE_READWRITE = 4
+PAGE_WRITECOPY = 8
+PAGE_EXECUTE = 16
+PAGE_EXECUTE_READ = 32
+PAGE_EXECUTE_READWRITE = 64
+PAGE_EXECUTE_WRITECOPY = 128
+PAGE_GUARD = 256
+PAGE_NOCACHE = 512
+MEM_COMMIT = 4096
+MEM_RESERVE = 8192
+MEM_DECOMMIT = 16384
+MEM_RELEASE = 32768
+MEM_FREE = 65536
+MEM_PRIVATE = 131072
+MEM_MAPPED = 262144
+MEM_TOP_DOWN = 1048576
+
+# Generated by h2py from \msvc20\include\winnt.h
+# hacked and split by mhammond.
+SEC_FILE = 8388608
+SEC_IMAGE = 16777216
+SEC_RESERVE = 67108864
+SEC_COMMIT = 134217728
+SEC_NOCACHE = 268435456
+MEM_IMAGE = SEC_IMAGE
+FILE_SHARE_READ = 1
+FILE_SHARE_WRITE = 2
+FILE_SHARE_DELETE = 4
+FILE_ATTRIBUTE_READONLY = 1
+FILE_ATTRIBUTE_HIDDEN = 2
+FILE_ATTRIBUTE_SYSTEM = 4
+FILE_ATTRIBUTE_DIRECTORY = 16
+FILE_ATTRIBUTE_ARCHIVE = 32
+FILE_ATTRIBUTE_DEVICE = 64
+FILE_ATTRIBUTE_NORMAL = 128
+FILE_ATTRIBUTE_TEMPORARY = 256
+FILE_ATTRIBUTE_SPARSE_FILE = 512
+FILE_ATTRIBUTE_REPARSE_POINT = 1024
+FILE_ATTRIBUTE_COMPRESSED = 2048
+FILE_ATTRIBUTE_OFFLINE = 4096
+FILE_ATTRIBUTE_NOT_CONTENT_INDEXED = 8192
+FILE_ATTRIBUTE_ENCRYPTED = 16384
+FILE_ATTRIBUTE_VIRTUAL = 65536
+# These FILE_ATTRIBUTE_* flags  are apparently old definitions from Windows 95
+# and conflict with current values above - but they live on for b/w compat...
+FILE_ATTRIBUTE_ATOMIC_WRITE = 512
+FILE_ATTRIBUTE_XACTION_WRITE = 1024
+
+FILE_NOTIFY_CHANGE_FILE_NAME = 1
+FILE_NOTIFY_CHANGE_DIR_NAME = 2
+FILE_NOTIFY_CHANGE_ATTRIBUTES = 4
+FILE_NOTIFY_CHANGE_SIZE = 8
+FILE_NOTIFY_CHANGE_LAST_WRITE = 16
+FILE_NOTIFY_CHANGE_SECURITY = 256
+FILE_CASE_SENSITIVE_SEARCH = 1
+FILE_CASE_PRESERVED_NAMES = 2
+FILE_UNICODE_ON_DISK = 4
+FILE_PERSISTENT_ACLS = 8
+FILE_FILE_COMPRESSION = 16
+FILE_NAMED_STREAMS = 262144
+FILE_PERSISTENT_ACLS = 0x00000008
+FILE_READ_ONLY_VOLUME = 0x00080000
+FILE_SEQUENTIAL_WRITE_ONCE = 0x00100000
+FILE_SUPPORTS_ENCRYPTION = 0x00020000
+FILE_SUPPORTS_EXTENDED_ATTRIBUTES = 0x00800000
+FILE_SUPPORTS_HARD_LINKS = 0x00400000
+FILE_SUPPORTS_OBJECT_IDS = 0x00010000
+FILE_SUPPORTS_OPEN_BY_FILE_ID = 0x01000000
+FILE_SUPPORTS_REPARSE_POINTS = 0x00000080
+FILE_SUPPORTS_SPARSE_FILES = 0x00000040
+FILE_SUPPORTS_TRANSACTIONS = 0x00200000
+FILE_SUPPORTS_USN_JOURNAL = 0x02000000
+FILE_UNICODE_ON_DISK = 0x00000004
+FILE_VOLUME_IS_COMPRESSED = 0x00008000
+FILE_VOLUME_QUOTAS = 0x00000020
+FILE_VOLUME_IS_COMPRESSED = 32768
+IO_COMPLETION_MODIFY_STATE = 2
+DUPLICATE_CLOSE_SOURCE = 1
+DUPLICATE_SAME_ACCESS = 2
+SID_MAX_SUB_AUTHORITIES = 15
+SECURITY_NULL_RID = 0
+SECURITY_WORLD_RID = 0
+SECURITY_LOCAL_RID = 0x00000000
+SECURITY_CREATOR_OWNER_RID = 0
+SECURITY_CREATOR_GROUP_RID = 1
+SECURITY_DIALUP_RID = 1
+SECURITY_NETWORK_RID = 2
+SECURITY_BATCH_RID = 3
+SECURITY_INTERACTIVE_RID = 4
+SECURITY_SERVICE_RID = 6
+SECURITY_ANONYMOUS_LOGON_RID = 7
+SECURITY_LOGON_IDS_RID = 5
+SECURITY_LOGON_IDS_RID_COUNT = 3
+SECURITY_LOCAL_SYSTEM_RID = 18
+SECURITY_NT_NON_UNIQUE = 21
+SECURITY_BUILTIN_DOMAIN_RID = 32
+DOMAIN_USER_RID_ADMIN = 500
+DOMAIN_USER_RID_GUEST = 501
+DOMAIN_GROUP_RID_ADMINS = 512
+DOMAIN_GROUP_RID_USERS = 513
+DOMAIN_GROUP_RID_GUESTS = 514
+DOMAIN_ALIAS_RID_ADMINS = 544
+DOMAIN_ALIAS_RID_USERS = 545
+DOMAIN_ALIAS_RID_GUESTS = 546
+DOMAIN_ALIAS_RID_POWER_USERS = 547
+DOMAIN_ALIAS_RID_ACCOUNT_OPS = 548
+DOMAIN_ALIAS_RID_SYSTEM_OPS = 549
+DOMAIN_ALIAS_RID_PRINT_OPS = 550
+DOMAIN_ALIAS_RID_BACKUP_OPS = 551
+DOMAIN_ALIAS_RID_REPLICATOR = 552
+SE_GROUP_MANDATORY = 1
+SE_GROUP_ENABLED_BY_DEFAULT = 2
+SE_GROUP_ENABLED = 4
+SE_GROUP_OWNER = 8
+SE_GROUP_LOGON_ID = -1073741824
+ACL_REVISION = 2
+ACL_REVISION1 = 1
+ACL_REVISION2 = 2
+ACCESS_ALLOWED_ACE_TYPE = 0
+ACCESS_DENIED_ACE_TYPE = 1
+SYSTEM_AUDIT_ACE_TYPE = 2
+SYSTEM_ALARM_ACE_TYPE = 3
+OBJECT_INHERIT_ACE = 1
+CONTAINER_INHERIT_ACE = 2
+NO_PROPAGATE_INHERIT_ACE = 4
+INHERIT_ONLY_ACE = 8
+VALID_INHERIT_FLAGS = 15
+SUCCESSFUL_ACCESS_ACE_FLAG = 64
+FAILED_ACCESS_ACE_FLAG = 128
+SECURITY_DESCRIPTOR_REVISION = 1
+SECURITY_DESCRIPTOR_REVISION1 = 1
+SECURITY_DESCRIPTOR_MIN_LENGTH = 20
+SE_OWNER_DEFAULTED = 1
+SE_GROUP_DEFAULTED = 2
+SE_DACL_PRESENT = 4
+SE_DACL_DEFAULTED = 8
+SE_SACL_PRESENT = 16
+SE_SACL_DEFAULTED = 32
+SE_SELF_RELATIVE = 32768
+SE_PRIVILEGE_ENABLED_BY_DEFAULT = 1
+SE_PRIVILEGE_ENABLED = 2
+SE_PRIVILEGE_USED_FOR_ACCESS = -2147483648
+PRIVILEGE_SET_ALL_NECESSARY = 1
+SE_CREATE_TOKEN_NAME = "SeCreateTokenPrivilege"
+SE_ASSIGNPRIMARYTOKEN_NAME = "SeAssignPrimaryTokenPrivilege"
+SE_LOCK_MEMORY_NAME = "SeLockMemoryPrivilege"
+SE_INCREASE_QUOTA_NAME = "SeIncreaseQuotaPrivilege"
+SE_UNSOLICITED_INPUT_NAME = "SeUnsolicitedInputPrivilege"
+SE_MACHINE_ACCOUNT_NAME = "SeMachineAccountPrivilege"
+SE_TCB_NAME = "SeTcbPrivilege"
+SE_SECURITY_NAME = "SeSecurityPrivilege"
+SE_TAKE_OWNERSHIP_NAME = "SeTakeOwnershipPrivilege"
+SE_LOAD_DRIVER_NAME = "SeLoadDriverPrivilege"
+SE_SYSTEM_PROFILE_NAME = "SeSystemProfilePrivilege"
+SE_SYSTEMTIME_NAME = "SeSystemtimePrivilege"
+SE_PROF_SINGLE_PROCESS_NAME = "SeProfileSingleProcessPrivilege"
+SE_INC_BASE_PRIORITY_NAME = "SeIncreaseBasePriorityPrivilege"
+SE_CREATE_PAGEFILE_NAME = "SeCreatePagefilePrivilege"
+SE_CREATE_PERMANENT_NAME = "SeCreatePermanentPrivilege"
+SE_BACKUP_NAME = "SeBackupPrivilege"
+SE_RESTORE_NAME = "SeRestorePrivilege"
+SE_SHUTDOWN_NAME = "SeShutdownPrivilege"
+SE_DEBUG_NAME = "SeDebugPrivilege"
+SE_AUDIT_NAME = "SeAuditPrivilege"
+SE_SYSTEM_ENVIRONMENT_NAME = "SeSystemEnvironmentPrivilege"
+SE_CHANGE_NOTIFY_NAME = "SeChangeNotifyPrivilege"
+SE_REMOTE_SHUTDOWN_NAME = "SeRemoteShutdownPrivilege"
+
+TOKEN_ASSIGN_PRIMARY = 1
+TOKEN_DUPLICATE = 2
+TOKEN_IMPERSONATE = 4
+TOKEN_QUERY = 8
+TOKEN_QUERY_SOURCE = 16
+TOKEN_ADJUST_PRIVILEGES = 32
+TOKEN_ADJUST_GROUPS = 64
+TOKEN_ADJUST_DEFAULT = 128
+TOKEN_ADJUST_SESSIONID = 256
+TOKEN_ALL_ACCESS = (
+    STANDARD_RIGHTS_REQUIRED
+    | TOKEN_ASSIGN_PRIMARY
+    | TOKEN_DUPLICATE
+    | TOKEN_IMPERSONATE
+    | TOKEN_QUERY
+    | TOKEN_QUERY_SOURCE
+    | TOKEN_ADJUST_PRIVILEGES
+    | TOKEN_ADJUST_GROUPS
+    | TOKEN_ADJUST_DEFAULT
+    | TOKEN_ADJUST_SESSIONID
+)
+TOKEN_READ = STANDARD_RIGHTS_READ | TOKEN_QUERY
+TOKEN_WRITE = (
+    STANDARD_RIGHTS_WRITE
+    | TOKEN_ADJUST_PRIVILEGES
+    | TOKEN_ADJUST_GROUPS
+    | TOKEN_ADJUST_DEFAULT
+)
+TOKEN_EXECUTE = STANDARD_RIGHTS_EXECUTE
+TOKEN_SOURCE_LENGTH = 8
+
+KEY_QUERY_VALUE = 1
+KEY_SET_VALUE = 2
+KEY_CREATE_SUB_KEY = 4
+KEY_ENUMERATE_SUB_KEYS = 8
+KEY_NOTIFY = 16
+KEY_CREATE_LINK = 32
+KEY_WOW64_32KEY = 512
+KEY_WOW64_64KEY = 256
+KEY_WOW64_RES = 768
+KEY_READ = (
+    STANDARD_RIGHTS_READ | KEY_QUERY_VALUE | KEY_ENUMERATE_SUB_KEYS | KEY_NOTIFY
+) & (~SYNCHRONIZE)
+KEY_WRITE = (STANDARD_RIGHTS_WRITE | KEY_SET_VALUE | KEY_CREATE_SUB_KEY) & (
+    ~SYNCHRONIZE
+)
+KEY_EXECUTE = (KEY_READ) & (~SYNCHRONIZE)
+KEY_ALL_ACCESS = (
+    STANDARD_RIGHTS_ALL
+    | KEY_QUERY_VALUE
+    | KEY_SET_VALUE
+    | KEY_CREATE_SUB_KEY
+    | KEY_ENUMERATE_SUB_KEYS
+    | KEY_NOTIFY
+    | KEY_CREATE_LINK
+) & (~SYNCHRONIZE)
+REG_NOTIFY_CHANGE_ATTRIBUTES = 2
+REG_NOTIFY_CHANGE_SECURITY = 8
+REG_RESOURCE_REQUIREMENTS_LIST = 10
+REG_NONE = 0  # No value type
+REG_SZ = 1  # Unicode nul terminated string
+REG_EXPAND_SZ = 2  # Unicode nul terminated string
+# (with environment variable references)
+REG_BINARY = 3  # Free form binary
+REG_DWORD = 4  # 32-bit number
+REG_DWORD_LITTLE_ENDIAN = 4  # 32-bit number (same as REG_DWORD)
+REG_DWORD_BIG_ENDIAN = 5  # 32-bit number
+REG_LINK = 6  # Symbolic Link (unicode)
+REG_MULTI_SZ = 7  # Multiple Unicode strings
+REG_RESOURCE_LIST = 8  # Resource list in the resource map
+REG_FULL_RESOURCE_DESCRIPTOR = 9  # Resource list in the hardware description
+REG_RESOURCE_REQUIREMENTS_LIST = 10
+REG_QWORD = 11  # 64-bit number
+REG_QWORD_LITTLE_ENDIAN = 11  # 64-bit number (same as REG_QWORD)
+
+
+# Generated by h2py from \msvc20\include\winnt.h
+# hacked and split by mhammond.
+# Included from string.h
+_NLSCMPERROR = 2147483647
+NULL = 0
+HEAP_NO_SERIALIZE = 1
+HEAP_GROWABLE = 2
+HEAP_GENERATE_EXCEPTIONS = 4
+HEAP_ZERO_MEMORY = 8
+HEAP_REALLOC_IN_PLACE_ONLY = 16
+HEAP_TAIL_CHECKING_ENABLED = 32
+HEAP_FREE_CHECKING_ENABLED = 64
+HEAP_DISABLE_COALESCE_ON_FREE = 128
+IS_TEXT_UNICODE_ASCII16 = 1
+IS_TEXT_UNICODE_REVERSE_ASCII16 = 16
+IS_TEXT_UNICODE_STATISTICS = 2
+IS_TEXT_UNICODE_REVERSE_STATISTICS = 32
+IS_TEXT_UNICODE_CONTROLS = 4
+IS_TEXT_UNICODE_REVERSE_CONTROLS = 64
+IS_TEXT_UNICODE_SIGNATURE = 8
+IS_TEXT_UNICODE_REVERSE_SIGNATURE = 128
+IS_TEXT_UNICODE_ILLEGAL_CHARS = 256
+IS_TEXT_UNICODE_ODD_LENGTH = 512
+IS_TEXT_UNICODE_DBCS_LEADBYTE = 1024
+IS_TEXT_UNICODE_NULL_BYTES = 4096
+IS_TEXT_UNICODE_UNICODE_MASK = 15
+IS_TEXT_UNICODE_REVERSE_MASK = 240
+IS_TEXT_UNICODE_NOT_UNICODE_MASK = 3840
+IS_TEXT_UNICODE_NOT_ASCII_MASK = 61440
+COMPRESSION_FORMAT_NONE = 0
+COMPRESSION_FORMAT_DEFAULT = 1
+COMPRESSION_FORMAT_LZNT1 = 2
+COMPRESSION_ENGINE_STANDARD = 0
+COMPRESSION_ENGINE_MAXIMUM = 256
+MESSAGE_RESOURCE_UNICODE = 1
+RTL_CRITSECT_TYPE = 0
+RTL_RESOURCE_TYPE = 1
+DLL_PROCESS_ATTACH = 1
+DLL_THREAD_ATTACH = 2
+DLL_THREAD_DETACH = 3
+DLL_PROCESS_DETACH = 0
+EVENTLOG_SEQUENTIAL_READ = 0x0001
+EVENTLOG_SEEK_READ = 0x0002
+EVENTLOG_FORWARDS_READ = 0x0004
+EVENTLOG_BACKWARDS_READ = 0x0008
+EVENTLOG_SUCCESS = 0x0000
+EVENTLOG_ERROR_TYPE = 1
+EVENTLOG_WARNING_TYPE = 2
+EVENTLOG_INFORMATION_TYPE = 4
+EVENTLOG_AUDIT_SUCCESS = 8
+EVENTLOG_AUDIT_FAILURE = 16
+EVENTLOG_START_PAIRED_EVENT = 1
+EVENTLOG_END_PAIRED_EVENT = 2
+EVENTLOG_END_ALL_PAIRED_EVENTS = 4
+EVENTLOG_PAIRED_EVENT_ACTIVE = 8
+EVENTLOG_PAIRED_EVENT_INACTIVE = 16
+# Generated by h2py from \msvc20\include\winnt.h
+# hacked and split by mhammond.
+OWNER_SECURITY_INFORMATION = 0x00000001
+GROUP_SECURITY_INFORMATION = 0x00000002
+DACL_SECURITY_INFORMATION = 0x00000004
+SACL_SECURITY_INFORMATION = 0x00000008
+IMAGE_SIZEOF_FILE_HEADER = 20
+IMAGE_FILE_MACHINE_UNKNOWN = 0
+IMAGE_NUMBEROF_DIRECTORY_ENTRIES = 16
+IMAGE_SIZEOF_ROM_OPTIONAL_HEADER = 56
+IMAGE_SIZEOF_STD_OPTIONAL_HEADER = 28
+IMAGE_SIZEOF_NT_OPTIONAL_HEADER = 224
+IMAGE_NT_OPTIONAL_HDR_MAGIC = 267
+IMAGE_ROM_OPTIONAL_HDR_MAGIC = 263
+IMAGE_SIZEOF_SHORT_NAME = 8
+IMAGE_SIZEOF_SECTION_HEADER = 40
+IMAGE_SIZEOF_SYMBOL = 18
+IMAGE_SYM_CLASS_NULL = 0
+IMAGE_SYM_CLASS_AUTOMATIC = 1
+IMAGE_SYM_CLASS_EXTERNAL = 2
+IMAGE_SYM_CLASS_STATIC = 3
+IMAGE_SYM_CLASS_REGISTER = 4
+IMAGE_SYM_CLASS_EXTERNAL_DEF = 5
+IMAGE_SYM_CLASS_LABEL = 6
+IMAGE_SYM_CLASS_UNDEFINED_LABEL = 7
+IMAGE_SYM_CLASS_MEMBER_OF_STRUCT = 8
+IMAGE_SYM_CLASS_ARGUMENT = 9
+IMAGE_SYM_CLASS_STRUCT_TAG = 10
+IMAGE_SYM_CLASS_MEMBER_OF_UNION = 11
+IMAGE_SYM_CLASS_UNION_TAG = 12
+IMAGE_SYM_CLASS_TYPE_DEFINITION = 13
+IMAGE_SYM_CLASS_UNDEFINED_STATIC = 14
+IMAGE_SYM_CLASS_ENUM_TAG = 15
+IMAGE_SYM_CLASS_MEMBER_OF_ENUM = 16
+IMAGE_SYM_CLASS_REGISTER_PARAM = 17
+IMAGE_SYM_CLASS_BIT_FIELD = 18
+IMAGE_SYM_CLASS_BLOCK = 100
+IMAGE_SYM_CLASS_FUNCTION = 101
+IMAGE_SYM_CLASS_END_OF_STRUCT = 102
+IMAGE_SYM_CLASS_FILE = 103
+IMAGE_SYM_CLASS_SECTION = 104
+IMAGE_SYM_CLASS_WEAK_EXTERNAL = 105
+N_BTMASK = 15
+N_TMASK = 48
+N_TMASK1 = 192
+N_TMASK2 = 240
+N_BTSHFT = 4
+N_TSHIFT = 2
+IMAGE_SIZEOF_AUX_SYMBOL = 18
+IMAGE_COMDAT_SELECT_NODUPLICATES = 1
+IMAGE_COMDAT_SELECT_ANY = 2
+IMAGE_COMDAT_SELECT_SAME_SIZE = 3
+IMAGE_COMDAT_SELECT_EXACT_MATCH = 4
+IMAGE_COMDAT_SELECT_ASSOCIATIVE = 5
+IMAGE_WEAK_EXTERN_SEARCH_NOLIBRARY = 1
+IMAGE_WEAK_EXTERN_SEARCH_LIBRARY = 2
+IMAGE_WEAK_EXTERN_SEARCH_ALIAS = 3
+IMAGE_SIZEOF_RELOCATION = 10
+IMAGE_REL_I386_SECTION = 10
+IMAGE_REL_I386_SECREL = 11
+IMAGE_REL_MIPS_REFHALF = 1
+IMAGE_REL_MIPS_REFWORD = 2
+IMAGE_REL_MIPS_JMPADDR = 3
+IMAGE_REL_MIPS_REFHI = 4
+IMAGE_REL_MIPS_REFLO = 5
+IMAGE_REL_MIPS_GPREL = 6
+IMAGE_REL_MIPS_LITERAL = 7
+IMAGE_REL_MIPS_SECTION = 10
+IMAGE_REL_MIPS_SECREL = 11
+IMAGE_REL_MIPS_REFWORDNB = 34
+IMAGE_REL_MIPS_PAIR = 37
+IMAGE_REL_ALPHA_ABSOLUTE = 0
+IMAGE_REL_ALPHA_REFLONG = 1
+IMAGE_REL_ALPHA_REFQUAD = 2
+IMAGE_REL_ALPHA_GPREL32 = 3
+IMAGE_REL_ALPHA_LITERAL = 4
+IMAGE_REL_ALPHA_LITUSE = 5
+IMAGE_REL_ALPHA_GPDISP = 6
+IMAGE_REL_ALPHA_BRADDR = 7
+IMAGE_REL_ALPHA_HINT = 8
+IMAGE_REL_ALPHA_INLINE_REFLONG = 9
+IMAGE_REL_ALPHA_REFHI = 10
+IMAGE_REL_ALPHA_REFLO = 11
+IMAGE_REL_ALPHA_PAIR = 12
+IMAGE_REL_ALPHA_MATCH = 13
+IMAGE_REL_ALPHA_SECTION = 14
+IMAGE_REL_ALPHA_SECREL = 15
+IMAGE_REL_ALPHA_REFLONGNB = 16
+IMAGE_SIZEOF_BASE_RELOCATION = 8
+IMAGE_REL_BASED_ABSOLUTE = 0
+IMAGE_REL_BASED_HIGH = 1
+IMAGE_REL_BASED_LOW = 2
+IMAGE_REL_BASED_HIGHLOW = 3
+IMAGE_REL_BASED_HIGHADJ = 4
+IMAGE_REL_BASED_MIPS_JMPADDR = 5
+IMAGE_SIZEOF_LINENUMBER = 6
+IMAGE_ARCHIVE_START_SIZE = 8
+IMAGE_ARCHIVE_START = "!<arch>\n"
+IMAGE_ARCHIVE_END = "`\n"
+IMAGE_ARCHIVE_PAD = "\n"
+IMAGE_ARCHIVE_LINKER_MEMBER = "/               "
+IMAGE_ARCHIVE_LONGNAMES_MEMBER = "//              "
+IMAGE_SIZEOF_ARCHIVE_MEMBER_HDR = 60
+IMAGE_ORDINAL_FLAG = -2147483648
+
+
+def IMAGE_SNAP_BY_ORDINAL(Ordinal):
+    return (Ordinal & IMAGE_ORDINAL_FLAG) != 0
+
+
+def IMAGE_ORDINAL(Ordinal):
+    return Ordinal & 65535
+
+
+IMAGE_RESOURCE_NAME_IS_STRING = -2147483648
+IMAGE_RESOURCE_DATA_IS_DIRECTORY = -2147483648
+IMAGE_DEBUG_TYPE_UNKNOWN = 0
+IMAGE_DEBUG_TYPE_COFF = 1
+IMAGE_DEBUG_TYPE_CODEVIEW = 2
+IMAGE_DEBUG_TYPE_FPO = 3
+IMAGE_DEBUG_TYPE_MISC = 4
+IMAGE_DEBUG_TYPE_EXCEPTION = 5
+IMAGE_DEBUG_TYPE_FIXUP = 6
+IMAGE_DEBUG_TYPE_OMAP_TO_SRC = 7
+IMAGE_DEBUG_TYPE_OMAP_FROM_SRC = 8
+FRAME_FPO = 0
+FRAME_TRAP = 1
+FRAME_TSS = 2
+SIZEOF_RFPO_DATA = 16
+IMAGE_DEBUG_MISC_EXENAME = 1
+IMAGE_SEPARATE_DEBUG_SIGNATURE = 18756
+# Generated by h2py from \msvcnt\include\wingdi.h
+# hacked and split manually by mhammond.
+NEWFRAME = 1
+ABORTDOC = 2
+NEXTBAND = 3
+SETCOLORTABLE = 4
+GETCOLORTABLE = 5
+FLUSHOUTPUT = 6
+DRAFTMODE = 7
+QUERYESCSUPPORT = 8
+SETABORTPROC = 9
+STARTDOC = 10
+ENDDOC = 11
+GETPHYSPAGESIZE = 12
+GETPRINTINGOFFSET = 13
+GETSCALINGFACTOR = 14
+MFCOMMENT = 15
+GETPENWIDTH = 16
+SETCOPYCOUNT = 17
+SELECTPAPERSOURCE = 18
+DEVICEDATA = 19
+PASSTHROUGH = 19
+GETTECHNOLGY = 20
+GETTECHNOLOGY = 20
+SETLINECAP = 21
+SETLINEJOIN = 22
+SETMITERLIMIT = 23
+BANDINFO = 24
+DRAWPATTERNRECT = 25
+GETVECTORPENSIZE = 26
+GETVECTORBRUSHSIZE = 27
+ENABLEDUPLEX = 28
+GETSETPAPERBINS = 29
+GETSETPRINTORIENT = 30
+ENUMPAPERBINS = 31
+SETDIBSCALING = 32
+EPSPRINTING = 33
+ENUMPAPERMETRICS = 34
+GETSETPAPERMETRICS = 35
+POSTSCRIPT_DATA = 37
+POSTSCRIPT_IGNORE = 38
+MOUSETRAILS = 39
+GETDEVICEUNITS = 42
+GETEXTENDEDTEXTMETRICS = 256
+GETEXTENTTABLE = 257
+GETPAIRKERNTABLE = 258
+GETTRACKKERNTABLE = 259
+EXTTEXTOUT = 512
+GETFACENAME = 513
+DOWNLOADFACE = 514
+ENABLERELATIVEWIDTHS = 768
+ENABLEPAIRKERNING = 769
+SETKERNTRACK = 770
+SETALLJUSTVALUES = 771
+SETCHARSET = 772
+STRETCHBLT = 2048
+GETSETSCREENPARAMS = 3072
+BEGIN_PATH = 4096
+CLIP_TO_PATH = 4097
+END_PATH = 4098
+EXT_DEVICE_CAPS = 4099
+RESTORE_CTM = 4100
+SAVE_CTM = 4101
+SET_ARC_DIRECTION = 4102
+SET_BACKGROUND_COLOR = 4103
+SET_POLY_MODE = 4104
+SET_SCREEN_ANGLE = 4105
+SET_SPREAD = 4106
+TRANSFORM_CTM = 4107
+SET_CLIP_BOX = 4108
+SET_BOUNDS = 4109
+SET_MIRROR_MODE = 4110
+OPENCHANNEL = 4110
+DOWNLOADHEADER = 4111
+CLOSECHANNEL = 4112
+POSTSCRIPT_PASSTHROUGH = 4115
+ENCAPSULATED_POSTSCRIPT = 4116
+SP_NOTREPORTED = 16384
+SP_ERROR = -1
+SP_APPABORT = -2
+SP_USERABORT = -3
+SP_OUTOFDISK = -4
+SP_OUTOFMEMORY = -5
+PR_JOBSTATUS = 0
+
+## GDI object types
+OBJ_PEN = 1
+OBJ_BRUSH = 2
+OBJ_DC = 3
+OBJ_METADC = 4
+OBJ_PAL = 5
+OBJ_FONT = 6
+OBJ_BITMAP = 7
+OBJ_REGION = 8
+OBJ_METAFILE = 9
+OBJ_MEMDC = 10
+OBJ_EXTPEN = 11
+OBJ_ENHMETADC = 12
+OBJ_ENHMETAFILE = 13
+OBJ_COLORSPACE = 14
+
+MWT_IDENTITY = 1
+MWT_LEFTMULTIPLY = 2
+MWT_RIGHTMULTIPLY = 3
+MWT_MIN = MWT_IDENTITY
+MWT_MAX = MWT_RIGHTMULTIPLY
+BI_RGB = 0
+BI_RLE8 = 1
+BI_RLE4 = 2
+BI_BITFIELDS = 3
+TMPF_FIXED_PITCH = 1
+TMPF_VECTOR = 2
+TMPF_DEVICE = 8
+TMPF_TRUETYPE = 4
+NTM_REGULAR = 64
+NTM_BOLD = 32
+NTM_ITALIC = 1
+LF_FACESIZE = 32
+LF_FULLFACESIZE = 64
+OUT_DEFAULT_PRECIS = 0
+OUT_STRING_PRECIS = 1
+OUT_CHARACTER_PRECIS = 2
+OUT_STROKE_PRECIS = 3
+OUT_TT_PRECIS = 4
+OUT_DEVICE_PRECIS = 5
+OUT_RASTER_PRECIS = 6
+OUT_TT_ONLY_PRECIS = 7
+OUT_OUTLINE_PRECIS = 8
+CLIP_DEFAULT_PRECIS = 0
+CLIP_CHARACTER_PRECIS = 1
+CLIP_STROKE_PRECIS = 2
+CLIP_MASK = 15
+CLIP_LH_ANGLES = 1 << 4
+CLIP_TT_ALWAYS = 2 << 4
+CLIP_EMBEDDED = 8 << 4
+DEFAULT_QUALITY = 0
+DRAFT_QUALITY = 1
+PROOF_QUALITY = 2
+NONANTIALIASED_QUALITY = 3
+ANTIALIASED_QUALITY = 4
+CLEARTYPE_QUALITY = 5
+CLEARTYPE_NATURAL_QUALITY = 6
+DEFAULT_PITCH = 0
+FIXED_PITCH = 1
+VARIABLE_PITCH = 2
+ANSI_CHARSET = 0
+DEFAULT_CHARSET = 1
+SYMBOL_CHARSET = 2
+SHIFTJIS_CHARSET = 128
+HANGEUL_CHARSET = 129
+CHINESEBIG5_CHARSET = 136
+OEM_CHARSET = 255
+JOHAB_CHARSET = 130
+HEBREW_CHARSET = 177
+ARABIC_CHARSET = 178
+GREEK_CHARSET = 161
+TURKISH_CHARSET = 162
+VIETNAMESE_CHARSET = 163
+THAI_CHARSET = 222
+EASTEUROPE_CHARSET = 238
+RUSSIAN_CHARSET = 204
+MAC_CHARSET = 77
+BALTIC_CHARSET = 186
+FF_DONTCARE = 0 << 4
+FF_ROMAN = 1 << 4
+FF_SWISS = 2 << 4
+FF_MODERN = 3 << 4
+FF_SCRIPT = 4 << 4
+FF_DECORATIVE = 5 << 4
+FW_DONTCARE = 0
+FW_THIN = 100
+FW_EXTRALIGHT = 200
+FW_LIGHT = 300
+FW_NORMAL = 400
+FW_MEDIUM = 500
+FW_SEMIBOLD = 600
+FW_BOLD = 700
+FW_EXTRABOLD = 800
+FW_HEAVY = 900
+FW_ULTRALIGHT = FW_EXTRALIGHT
+FW_REGULAR = FW_NORMAL
+FW_DEMIBOLD = FW_SEMIBOLD
+FW_ULTRABOLD = FW_EXTRABOLD
+FW_BLACK = FW_HEAVY
+# Generated by h2py from \msvcnt\include\wingdi.h
+# hacked and split manually by mhammond.
+BS_SOLID = 0
+BS_NULL = 1
+BS_HOLLOW = BS_NULL
+BS_HATCHED = 2
+BS_PATTERN = 3
+BS_INDEXED = 4
+BS_DIBPATTERN = 5
+BS_DIBPATTERNPT = 6
+BS_PATTERN8X8 = 7
+BS_DIBPATTERN8X8 = 8
+HS_HORIZONTAL = 0
+HS_VERTICAL = 1
+HS_FDIAGONAL = 2
+HS_BDIAGONAL = 3
+HS_CROSS = 4
+HS_DIAGCROSS = 5
+HS_FDIAGONAL1 = 6
+HS_BDIAGONAL1 = 7
+HS_SOLID = 8
+HS_DENSE1 = 9
+HS_DENSE2 = 10
+HS_DENSE3 = 11
+HS_DENSE4 = 12
+HS_DENSE5 = 13
+HS_DENSE6 = 14
+HS_DENSE7 = 15
+HS_DENSE8 = 16
+HS_NOSHADE = 17
+HS_HALFTONE = 18
+HS_SOLIDCLR = 19
+HS_DITHEREDCLR = 20
+HS_SOLIDTEXTCLR = 21
+HS_DITHEREDTEXTCLR = 22
+HS_SOLIDBKCLR = 23
+HS_DITHEREDBKCLR = 24
+HS_API_MAX = 25
+PS_SOLID = 0
+PS_DASH = 1
+PS_DOT = 2
+PS_DASHDOT = 3
+PS_DASHDOTDOT = 4
+PS_NULL = 5
+PS_INSIDEFRAME = 6
+PS_USERSTYLE = 7
+PS_ALTERNATE = 8
+PS_STYLE_MASK = 15
+PS_ENDCAP_ROUND = 0
+PS_ENDCAP_SQUARE = 256
+PS_ENDCAP_FLAT = 512
+PS_ENDCAP_MASK = 3840
+PS_JOIN_ROUND = 0
+PS_JOIN_BEVEL = 4096
+PS_JOIN_MITER = 8192
+PS_JOIN_MASK = 61440
+PS_COSMETIC = 0
+PS_GEOMETRIC = 65536
+PS_TYPE_MASK = 983040
+AD_COUNTERCLOCKWISE = 1
+AD_CLOCKWISE = 2
+DRIVERVERSION = 0
+TECHNOLOGY = 2
+HORZSIZE = 4
+VERTSIZE = 6
+HORZRES = 8
+VERTRES = 10
+BITSPIXEL = 12
+PLANES = 14
+NUMBRUSHES = 16
+NUMPENS = 18
+NUMMARKERS = 20
+NUMFONTS = 22
+NUMCOLORS = 24
+PDEVICESIZE = 26
+CURVECAPS = 28
+LINECAPS = 30
+POLYGONALCAPS = 32
+TEXTCAPS = 34
+CLIPCAPS = 36
+RASTERCAPS = 38
+ASPECTX = 40
+ASPECTY = 42
+ASPECTXY = 44
+LOGPIXELSX = 88
+LOGPIXELSY = 90
+SIZEPALETTE = 104
+NUMRESERVED = 106
+COLORRES = 108
+
+PHYSICALWIDTH = 110
+PHYSICALHEIGHT = 111
+PHYSICALOFFSETX = 112
+PHYSICALOFFSETY = 113
+SCALINGFACTORX = 114
+SCALINGFACTORY = 115
+VREFRESH = 116
+DESKTOPVERTRES = 117
+DESKTOPHORZRES = 118
+BLTALIGNMENT = 119
+SHADEBLENDCAPS = 120
+COLORMGMTCAPS = 121
+
+DT_PLOTTER = 0
+DT_RASDISPLAY = 1
+DT_RASPRINTER = 2
+DT_RASCAMERA = 3
+DT_CHARSTREAM = 4
+DT_METAFILE = 5
+DT_DISPFILE = 6
+CC_NONE = 0
+CC_CIRCLES = 1
+CC_PIE = 2
+CC_CHORD = 4
+CC_ELLIPSES = 8
+CC_WIDE = 16
+CC_STYLED = 32
+CC_WIDESTYLED = 64
+CC_INTERIORS = 128
+CC_ROUNDRECT = 256
+LC_NONE = 0
+LC_POLYLINE = 2
+LC_MARKER = 4
+LC_POLYMARKER = 8
+LC_WIDE = 16
+LC_STYLED = 32
+LC_WIDESTYLED = 64
+LC_INTERIORS = 128
+PC_NONE = 0
+PC_POLYGON = 1
+PC_RECTANGLE = 2
+PC_WINDPOLYGON = 4
+PC_TRAPEZOID = 4
+PC_SCANLINE = 8
+PC_WIDE = 16
+PC_STYLED = 32
+PC_WIDESTYLED = 64
+PC_INTERIORS = 128
+CP_NONE = 0
+CP_RECTANGLE = 1
+CP_REGION = 2
+TC_OP_CHARACTER = 1
+TC_OP_STROKE = 2
+TC_CP_STROKE = 4
+TC_CR_90 = 8
+TC_CR_ANY = 16
+TC_SF_X_YINDEP = 32
+TC_SA_DOUBLE = 64
+TC_SA_INTEGER = 128
+TC_SA_CONTIN = 256
+TC_EA_DOUBLE = 512
+TC_IA_ABLE = 1024
+TC_UA_ABLE = 2048
+TC_SO_ABLE = 4096
+TC_RA_ABLE = 8192
+TC_VA_ABLE = 16384
+TC_RESERVED = 32768
+TC_SCROLLBLT = 65536
+RC_BITBLT = 1
+RC_BANDING = 2
+RC_SCALING = 4
+RC_BITMAP64 = 8
+RC_GDI20_OUTPUT = 16
+RC_GDI20_STATE = 32
+RC_SAVEBITMAP = 64
+RC_DI_BITMAP = 128
+RC_PALETTE = 256
+RC_DIBTODEV = 512
+RC_BIGFONT = 1024
+RC_STRETCHBLT = 2048
+RC_FLOODFILL = 4096
+RC_STRETCHDIB = 8192
+RC_OP_DX_OUTPUT = 16384
+RC_DEVBITS = 32768
+DIB_RGB_COLORS = 0
+DIB_PAL_COLORS = 1
+DIB_PAL_INDICES = 2
+DIB_PAL_PHYSINDICES = 2
+DIB_PAL_LOGINDICES = 4
+SYSPAL_ERROR = 0
+SYSPAL_STATIC = 1
+SYSPAL_NOSTATIC = 2
+CBM_CREATEDIB = 2
+CBM_INIT = 4
+FLOODFILLBORDER = 0
+FLOODFILLSURFACE = 1
+CCHDEVICENAME = 32
+CCHFORMNAME = 32
+# Generated by h2py from \msvcnt\include\wingdi.h
+# hacked and split manually by mhammond.
+
+# DEVMODE.dmFields
+DM_SPECVERSION = 800
+DM_ORIENTATION = 1
+DM_PAPERSIZE = 2
+DM_PAPERLENGTH = 4
+DM_PAPERWIDTH = 8
+DM_SCALE = 16
+DM_POSITION = 32
+DM_NUP = 64
+DM_DISPLAYORIENTATION = 128
+DM_COPIES = 256
+DM_DEFAULTSOURCE = 512
+DM_PRINTQUALITY = 1024
+DM_COLOR = 2048
+DM_DUPLEX = 4096
+DM_YRESOLUTION = 8192
+DM_TTOPTION = 16384
+DM_COLLATE = 32768
+DM_FORMNAME = 65536
+DM_LOGPIXELS = 131072
+DM_BITSPERPEL = 262144
+DM_PELSWIDTH = 524288
+DM_PELSHEIGHT = 1048576
+DM_DISPLAYFLAGS = 2097152
+DM_DISPLAYFREQUENCY = 4194304
+DM_ICMMETHOD = 8388608
+DM_ICMINTENT = 16777216
+DM_MEDIATYPE = 33554432
+DM_DITHERTYPE = 67108864
+DM_PANNINGWIDTH = 134217728
+DM_PANNINGHEIGHT = 268435456
+DM_DISPLAYFIXEDOUTPUT = 536870912
+
+# DEVMODE.dmOrientation
+DMORIENT_PORTRAIT = 1
+DMORIENT_LANDSCAPE = 2
+
+# DEVMODE.dmDisplayOrientation
+DMDO_DEFAULT = 0
+DMDO_90 = 1
+DMDO_180 = 2
+DMDO_270 = 3
+
+# DEVMODE.dmDisplayFixedOutput
+DMDFO_DEFAULT = 0
+DMDFO_STRETCH = 1
+DMDFO_CENTER = 2
+
+# DEVMODE.dmPaperSize
+DMPAPER_LETTER = 1
+DMPAPER_LETTERSMALL = 2
+DMPAPER_TABLOID = 3
+DMPAPER_LEDGER = 4
+DMPAPER_LEGAL = 5
+DMPAPER_STATEMENT = 6
+DMPAPER_EXECUTIVE = 7
+DMPAPER_A3 = 8
+DMPAPER_A4 = 9
+DMPAPER_A4SMALL = 10
+DMPAPER_A5 = 11
+DMPAPER_B4 = 12
+DMPAPER_B5 = 13
+DMPAPER_FOLIO = 14
+DMPAPER_QUARTO = 15
+DMPAPER_10X14 = 16
+DMPAPER_11X17 = 17
+DMPAPER_NOTE = 18
+DMPAPER_ENV_9 = 19
+DMPAPER_ENV_10 = 20
+DMPAPER_ENV_11 = 21
+DMPAPER_ENV_12 = 22
+DMPAPER_ENV_14 = 23
+DMPAPER_CSHEET = 24
+DMPAPER_DSHEET = 25
+DMPAPER_ESHEET = 26
+DMPAPER_ENV_DL = 27
+DMPAPER_ENV_C5 = 28
+DMPAPER_ENV_C3 = 29
+DMPAPER_ENV_C4 = 30
+DMPAPER_ENV_C6 = 31
+DMPAPER_ENV_C65 = 32
+DMPAPER_ENV_B4 = 33
+DMPAPER_ENV_B5 = 34
+DMPAPER_ENV_B6 = 35
+DMPAPER_ENV_ITALY = 36
+DMPAPER_ENV_MONARCH = 37
+DMPAPER_ENV_PERSONAL = 38
+DMPAPER_FANFOLD_US = 39
+DMPAPER_FANFOLD_STD_GERMAN = 40
+DMPAPER_FANFOLD_LGL_GERMAN = 41
+DMPAPER_ISO_B4 = 42
+DMPAPER_JAPANESE_POSTCARD = 43
+DMPAPER_9X11 = 44
+DMPAPER_10X11 = 45
+DMPAPER_15X11 = 46
+DMPAPER_ENV_INVITE = 47
+DMPAPER_RESERVED_48 = 48
+DMPAPER_RESERVED_49 = 49
+DMPAPER_LETTER_EXTRA = 50
+DMPAPER_LEGAL_EXTRA = 51
+DMPAPER_TABLOID_EXTRA = 52
+DMPAPER_A4_EXTRA = 53
+DMPAPER_LETTER_TRANSVERSE = 54
+DMPAPER_A4_TRANSVERSE = 55
+DMPAPER_LETTER_EXTRA_TRANSVERSE = 56
+DMPAPER_A_PLUS = 57
+DMPAPER_B_PLUS = 58
+DMPAPER_LETTER_PLUS = 59
+DMPAPER_A4_PLUS = 60
+DMPAPER_A5_TRANSVERSE = 61
+DMPAPER_B5_TRANSVERSE = 62
+DMPAPER_A3_EXTRA = 63
+DMPAPER_A5_EXTRA = 64
+DMPAPER_B5_EXTRA = 65
+DMPAPER_A2 = 66
+DMPAPER_A3_TRANSVERSE = 67
+DMPAPER_A3_EXTRA_TRANSVERSE = 68
+DMPAPER_DBL_JAPANESE_POSTCARD = 69
+DMPAPER_A6 = 70
+DMPAPER_JENV_KAKU2 = 71
+DMPAPER_JENV_KAKU3 = 72
+DMPAPER_JENV_CHOU3 = 73
+DMPAPER_JENV_CHOU4 = 74
+DMPAPER_LETTER_ROTATED = 75
+DMPAPER_A3_ROTATED = 76
+DMPAPER_A4_ROTATED = 77
+DMPAPER_A5_ROTATED = 78
+DMPAPER_B4_JIS_ROTATED = 79
+DMPAPER_B5_JIS_ROTATED = 80
+DMPAPER_JAPANESE_POSTCARD_ROTATED = 81
+DMPAPER_DBL_JAPANESE_POSTCARD_ROTATED = 82
+DMPAPER_A6_ROTATED = 83
+DMPAPER_JENV_KAKU2_ROTATED = 84
+DMPAPER_JENV_KAKU3_ROTATED = 85
+DMPAPER_JENV_CHOU3_ROTATED = 86
+DMPAPER_JENV_CHOU4_ROTATED = 87
+DMPAPER_B6_JIS = 88
+DMPAPER_B6_JIS_ROTATED = 89
+DMPAPER_12X11 = 90
+DMPAPER_JENV_YOU4 = 91
+DMPAPER_JENV_YOU4_ROTATED = 92
+DMPAPER_P16K = 93
+DMPAPER_P32K = 94
+DMPAPER_P32KBIG = 95
+DMPAPER_PENV_1 = 96
+DMPAPER_PENV_2 = 97
+DMPAPER_PENV_3 = 98
+DMPAPER_PENV_4 = 99
+DMPAPER_PENV_5 = 100
+DMPAPER_PENV_6 = 101
+DMPAPER_PENV_7 = 102
+DMPAPER_PENV_8 = 103
+DMPAPER_PENV_9 = 104
+DMPAPER_PENV_10 = 105
+DMPAPER_P16K_ROTATED = 106
+DMPAPER_P32K_ROTATED = 107
+DMPAPER_P32KBIG_ROTATED = 108
+DMPAPER_PENV_1_ROTATED = 109
+DMPAPER_PENV_2_ROTATED = 110
+DMPAPER_PENV_3_ROTATED = 111
+DMPAPER_PENV_4_ROTATED = 112
+DMPAPER_PENV_5_ROTATED = 113
+DMPAPER_PENV_6_ROTATED = 114
+DMPAPER_PENV_7_ROTATED = 115
+DMPAPER_PENV_8_ROTATED = 116
+DMPAPER_PENV_9_ROTATED = 117
+DMPAPER_PENV_10_ROTATED = 118
+DMPAPER_LAST = DMPAPER_PENV_10_ROTATED
+DMPAPER_USER = 256
+
+# DEVMODE.dmDefaultSource
+DMBIN_UPPER = 1
+DMBIN_ONLYONE = 1
+DMBIN_LOWER = 2
+DMBIN_MIDDLE = 3
+DMBIN_MANUAL = 4
+DMBIN_ENVELOPE = 5
+DMBIN_ENVMANUAL = 6
+DMBIN_AUTO = 7
+DMBIN_TRACTOR = 8
+DMBIN_SMALLFMT = 9
+DMBIN_LARGEFMT = 10
+DMBIN_LARGECAPACITY = 11
+DMBIN_CASSETTE = 14
+DMBIN_FORMSOURCE = 15
+DMBIN_LAST = DMBIN_FORMSOURCE
+DMBIN_USER = 256
+
+# DEVMODE.dmPrintQuality
+DMRES_DRAFT = -1
+DMRES_LOW = -2
+DMRES_MEDIUM = -3
+DMRES_HIGH = -4
+
+# DEVMODE.dmColor
+DMCOLOR_MONOCHROME = 1
+DMCOLOR_COLOR = 2
+
+# DEVMODE.dmDuplex
+DMDUP_SIMPLEX = 1
+DMDUP_VERTICAL = 2
+DMDUP_HORIZONTAL = 3
+
+# DEVMODE.dmTTOption
+DMTT_BITMAP = 1
+DMTT_DOWNLOAD = 2
+DMTT_SUBDEV = 3
+DMTT_DOWNLOAD_OUTLINE = 4
+
+# DEVMODE.dmCollate
+DMCOLLATE_FALSE = 0
+DMCOLLATE_TRUE = 1
+
+# DEVMODE.dmDisplayFlags
+DM_GRAYSCALE = 1
+DM_INTERLACED = 2
+
+# DEVMODE.dmICMMethod
+DMICMMETHOD_NONE = 1
+DMICMMETHOD_SYSTEM = 2
+DMICMMETHOD_DRIVER = 3
+DMICMMETHOD_DEVICE = 4
+DMICMMETHOD_USER = 256
+
+# DEVMODE.dmICMIntent
+DMICM_SATURATE = 1
+DMICM_CONTRAST = 2
+DMICM_COLORIMETRIC = 3
+DMICM_ABS_COLORIMETRIC = 4
+DMICM_USER = 256
+
+# DEVMODE.dmMediaType
+DMMEDIA_STANDARD = 1
+DMMEDIA_TRANSPARENCY = 2
+DMMEDIA_GLOSSY = 3
+DMMEDIA_USER = 256
+
+# DEVMODE.dmDitherType
+DMDITHER_NONE = 1
+DMDITHER_COARSE = 2
+DMDITHER_FINE = 3
+DMDITHER_LINEART = 4
+DMDITHER_ERRORDIFFUSION = 5
+DMDITHER_RESERVED6 = 6
+DMDITHER_RESERVED7 = 7
+DMDITHER_RESERVED8 = 8
+DMDITHER_RESERVED9 = 9
+DMDITHER_GRAYSCALE = 10
+DMDITHER_USER = 256
+
+# DEVMODE.dmNup
+DMNUP_SYSTEM = 1
+DMNUP_ONEUP = 2
+
+# used with ExtEscape
+FEATURESETTING_NUP = 0
+FEATURESETTING_OUTPUT = 1
+FEATURESETTING_PSLEVEL = 2
+FEATURESETTING_CUSTPAPER = 3
+FEATURESETTING_MIRROR = 4
+FEATURESETTING_NEGATIVE = 5
+FEATURESETTING_PROTOCOL = 6
+FEATURESETTING_PRIVATE_BEGIN = 0x1000
+FEATURESETTING_PRIVATE_END = 0x1FFF
+
+RDH_RECTANGLES = 1
+GGO_METRICS = 0
+GGO_BITMAP = 1
+GGO_NATIVE = 2
+TT_POLYGON_TYPE = 24
+TT_PRIM_LINE = 1
+TT_PRIM_QSPLINE = 2
+TT_AVAILABLE = 1
+TT_ENABLED = 2
+DM_UPDATE = 1
+DM_COPY = 2
+DM_PROMPT = 4
+DM_MODIFY = 8
+DM_IN_BUFFER = DM_MODIFY
+DM_IN_PROMPT = DM_PROMPT
+DM_OUT_BUFFER = DM_COPY
+DM_OUT_DEFAULT = DM_UPDATE
+
+# DISPLAY_DEVICE.StateFlags
+DISPLAY_DEVICE_ATTACHED_TO_DESKTOP = 1
+DISPLAY_DEVICE_MULTI_DRIVER = 2
+DISPLAY_DEVICE_PRIMARY_DEVICE = 4
+DISPLAY_DEVICE_MIRRORING_DRIVER = 8
+DISPLAY_DEVICE_VGA_COMPATIBLE = 16
+DISPLAY_DEVICE_REMOVABLE = 32
+DISPLAY_DEVICE_MODESPRUNED = 134217728
+DISPLAY_DEVICE_REMOTE = 67108864
+DISPLAY_DEVICE_DISCONNECT = 33554432
+
+# DeviceCapabilities types
+DC_FIELDS = 1
+DC_PAPERS = 2
+DC_PAPERSIZE = 3
+DC_MINEXTENT = 4
+DC_MAXEXTENT = 5
+DC_BINS = 6
+DC_DUPLEX = 7
+DC_SIZE = 8
+DC_EXTRA = 9
+DC_VERSION = 10
+DC_DRIVER = 11
+DC_BINNAMES = 12
+DC_ENUMRESOLUTIONS = 13
+DC_FILEDEPENDENCIES = 14
+DC_TRUETYPE = 15
+DC_PAPERNAMES = 16
+DC_ORIENTATION = 17
+DC_COPIES = 18
+DC_BINADJUST = 19
+DC_EMF_COMPLIANT = 20
+DC_DATATYPE_PRODUCED = 21
+DC_COLLATE = 22
+DC_MANUFACTURER = 23
+DC_MODEL = 24
+DC_PERSONALITY = 25
+DC_PRINTRATE = 26
+DC_PRINTRATEUNIT = 27
+DC_PRINTERMEM = 28
+DC_MEDIAREADY = 29
+DC_STAPLE = 30
+DC_PRINTRATEPPM = 31
+DC_COLORDEVICE = 32
+DC_NUP = 33
+DC_MEDIATYPENAMES = 34
+DC_MEDIATYPES = 35
+
+PRINTRATEUNIT_PPM = 1
+PRINTRATEUNIT_CPS = 2
+PRINTRATEUNIT_LPM = 3
+PRINTRATEUNIT_IPM = 4
+
+# TrueType constants
+DCTT_BITMAP = 1
+DCTT_DOWNLOAD = 2
+DCTT_SUBDEV = 4
+DCTT_DOWNLOAD_OUTLINE = 8
+
+DCBA_FACEUPNONE = 0
+DCBA_FACEUPCENTER = 1
+DCBA_FACEUPLEFT = 2
+DCBA_FACEUPRIGHT = 3
+DCBA_FACEDOWNNONE = 256
+DCBA_FACEDOWNCENTER = 257
+DCBA_FACEDOWNLEFT = 258
+DCBA_FACEDOWNRIGHT = 259
+
+CA_NEGATIVE = 1
+CA_LOG_FILTER = 2
+ILLUMINANT_DEVICE_DEFAULT = 0
+ILLUMINANT_A = 1
+ILLUMINANT_B = 2
+ILLUMINANT_C = 3
+ILLUMINANT_D50 = 4
+ILLUMINANT_D55 = 5
+ILLUMINANT_D65 = 6
+ILLUMINANT_D75 = 7
+ILLUMINANT_F2 = 8
+ILLUMINANT_MAX_INDEX = ILLUMINANT_F2
+ILLUMINANT_TUNGSTEN = ILLUMINANT_A
+ILLUMINANT_DAYLIGHT = ILLUMINANT_C
+ILLUMINANT_FLUORESCENT = ILLUMINANT_F2
+ILLUMINANT_NTSC = ILLUMINANT_C
+
+# Generated by h2py from \msvcnt\include\wingdi.h
+# hacked and split manually by mhammond.
+FONTMAPPER_MAX = 10
+ENHMETA_SIGNATURE = 1179469088
+ENHMETA_STOCK_OBJECT = -2147483648
+EMR_HEADER = 1
+EMR_POLYBEZIER = 2
+EMR_POLYGON = 3
+EMR_POLYLINE = 4
+EMR_POLYBEZIERTO = 5
+EMR_POLYLINETO = 6
+EMR_POLYPOLYLINE = 7
+EMR_POLYPOLYGON = 8
+EMR_SETWINDOWEXTEX = 9
+EMR_SETWINDOWORGEX = 10
+EMR_SETVIEWPORTEXTEX = 11
+EMR_SETVIEWPORTORGEX = 12
+EMR_SETBRUSHORGEX = 13
+EMR_EOF = 14
+EMR_SETPIXELV = 15
+EMR_SETMAPPERFLAGS = 16
+EMR_SETMAPMODE = 17
+EMR_SETBKMODE = 18
+EMR_SETPOLYFILLMODE = 19
+EMR_SETROP2 = 20
+EMR_SETSTRETCHBLTMODE = 21
+EMR_SETTEXTALIGN = 22
+EMR_SETCOLORADJUSTMENT = 23
+EMR_SETTEXTCOLOR = 24
+EMR_SETBKCOLOR = 25
+EMR_OFFSETCLIPRGN = 26
+EMR_MOVETOEX = 27
+EMR_SETMETARGN = 28
+EMR_EXCLUDECLIPRECT = 29
+EMR_INTERSECTCLIPRECT = 30
+EMR_SCALEVIEWPORTEXTEX = 31
+EMR_SCALEWINDOWEXTEX = 32
+EMR_SAVEDC = 33
+EMR_RESTOREDC = 34
+EMR_SETWORLDTRANSFORM = 35
+EMR_MODIFYWORLDTRANSFORM = 36
+EMR_SELECTOBJECT = 37
+EMR_CREATEPEN = 38
+EMR_CREATEBRUSHINDIRECT = 39
+EMR_DELETEOBJECT = 40
+EMR_ANGLEARC = 41
+EMR_ELLIPSE = 42
+EMR_RECTANGLE = 43
+EMR_ROUNDRECT = 44
+EMR_ARC = 45
+EMR_CHORD = 46
+EMR_PIE = 47
+EMR_SELECTPALETTE = 48
+EMR_CREATEPALETTE = 49
+EMR_SETPALETTEENTRIES = 50
+EMR_RESIZEPALETTE = 51
+EMR_REALIZEPALETTE = 52
+EMR_EXTFLOODFILL = 53
+EMR_LINETO = 54
+EMR_ARCTO = 55
+EMR_POLYDRAW = 56
+EMR_SETARCDIRECTION = 57
+EMR_SETMITERLIMIT = 58
+EMR_BEGINPATH = 59
+EMR_ENDPATH = 60
+EMR_CLOSEFIGURE = 61
+EMR_FILLPATH = 62
+EMR_STROKEANDFILLPATH = 63
+EMR_STROKEPATH = 64
+EMR_FLATTENPATH = 65
+EMR_WIDENPATH = 66
+EMR_SELECTCLIPPATH = 67
+EMR_ABORTPATH = 68
+EMR_GDICOMMENT = 70
+EMR_FILLRGN = 71
+EMR_FRAMERGN = 72
+EMR_INVERTRGN = 73
+EMR_PAINTRGN = 74
+EMR_EXTSELECTCLIPRGN = 75
+EMR_BITBLT = 76
+EMR_STRETCHBLT = 77
+EMR_MASKBLT = 78
+EMR_PLGBLT = 79
+EMR_SETDIBITSTODEVICE = 80
+EMR_STRETCHDIBITS = 81
+EMR_EXTCREATEFONTINDIRECTW = 82
+EMR_EXTTEXTOUTA = 83
+EMR_EXTTEXTOUTW = 84
+EMR_POLYBEZIER16 = 85
+EMR_POLYGON16 = 86
+EMR_POLYLINE16 = 87
+EMR_POLYBEZIERTO16 = 88
+EMR_POLYLINETO16 = 89
+EMR_POLYPOLYLINE16 = 90
+EMR_POLYPOLYGON16 = 91
+EMR_POLYDRAW16 = 92
+EMR_CREATEMONOBRUSH = 93
+EMR_CREATEDIBPATTERNBRUSHPT = 94
+EMR_EXTCREATEPEN = 95
+EMR_POLYTEXTOUTA = 96
+EMR_POLYTEXTOUTW = 97
+EMR_MIN = 1
+EMR_MAX = 97
+# Generated by h2py from \msvcnt\include\wingdi.h
+# hacked and split manually by mhammond.
+PANOSE_COUNT = 10
+PAN_FAMILYTYPE_INDEX = 0
+PAN_SERIFSTYLE_INDEX = 1
+PAN_WEIGHT_INDEX = 2
+PAN_PROPORTION_INDEX = 3
+PAN_CONTRAST_INDEX = 4
+PAN_STROKEVARIATION_INDEX = 5
+PAN_ARMSTYLE_INDEX = 6
+PAN_LETTERFORM_INDEX = 7
+PAN_MIDLINE_INDEX = 8
+PAN_XHEIGHT_INDEX = 9
+PAN_CULTURE_LATIN = 0
+PAN_ANY = 0
+PAN_NO_FIT = 1
+PAN_FAMILY_TEXT_DISPLAY = 2
+PAN_FAMILY_SCRIPT = 3
+PAN_FAMILY_DECORATIVE = 4
+PAN_FAMILY_PICTORIAL = 5
+PAN_SERIF_COVE = 2
+PAN_SERIF_OBTUSE_COVE = 3
+PAN_SERIF_SQUARE_COVE = 4
+PAN_SERIF_OBTUSE_SQUARE_COVE = 5
+PAN_SERIF_SQUARE = 6
+PAN_SERIF_THIN = 7
+PAN_SERIF_BONE = 8
+PAN_SERIF_EXAGGERATED = 9
+PAN_SERIF_TRIANGLE = 10
+PAN_SERIF_NORMAL_SANS = 11
+PAN_SERIF_OBTUSE_SANS = 12
+PAN_SERIF_PERP_SANS = 13
+PAN_SERIF_FLARED = 14
+PAN_SERIF_ROUNDED = 15
+PAN_WEIGHT_VERY_LIGHT = 2
+PAN_WEIGHT_LIGHT = 3
+PAN_WEIGHT_THIN = 4
+PAN_WEIGHT_BOOK = 5
+PAN_WEIGHT_MEDIUM = 6
+PAN_WEIGHT_DEMI = 7
+PAN_WEIGHT_BOLD = 8
+PAN_WEIGHT_HEAVY = 9
+PAN_WEIGHT_BLACK = 10
+PAN_WEIGHT_NORD = 11
+PAN_PROP_OLD_STYLE = 2
+PAN_PROP_MODERN = 3
+PAN_PROP_EVEN_WIDTH = 4
+PAN_PROP_EXPANDED = 5
+PAN_PROP_CONDENSED = 6
+PAN_PROP_VERY_EXPANDED = 7
+PAN_PROP_VERY_CONDENSED = 8
+PAN_PROP_MONOSPACED = 9
+PAN_CONTRAST_NONE = 2
+PAN_CONTRAST_VERY_LOW = 3
+PAN_CONTRAST_LOW = 4
+PAN_CONTRAST_MEDIUM_LOW = 5
+PAN_CONTRAST_MEDIUM = 6
+PAN_CONTRAST_MEDIUM_HIGH = 7
+PAN_CONTRAST_HIGH = 8
+PAN_CONTRAST_VERY_HIGH = 9
+PAN_STROKE_GRADUAL_DIAG = 2
+PAN_STROKE_GRADUAL_TRAN = 3
+PAN_STROKE_GRADUAL_VERT = 4
+PAN_STROKE_GRADUAL_HORZ = 5
+PAN_STROKE_RAPID_VERT = 6
+PAN_STROKE_RAPID_HORZ = 7
+PAN_STROKE_INSTANT_VERT = 8
+PAN_STRAIGHT_ARMS_HORZ = 2
+PAN_STRAIGHT_ARMS_WEDGE = 3
+PAN_STRAIGHT_ARMS_VERT = 4
+PAN_STRAIGHT_ARMS_SINGLE_SERIF = 5
+PAN_STRAIGHT_ARMS_DOUBLE_SERIF = 6
+PAN_BENT_ARMS_HORZ = 7
+PAN_BENT_ARMS_WEDGE = 8
+PAN_BENT_ARMS_VERT = 9
+PAN_BENT_ARMS_SINGLE_SERIF = 10
+PAN_BENT_ARMS_DOUBLE_SERIF = 11
+PAN_LETT_NORMAL_CONTACT = 2
+PAN_LETT_NORMAL_WEIGHTED = 3
+PAN_LETT_NORMAL_BOXED = 4
+PAN_LETT_NORMAL_FLATTENED = 5
+PAN_LETT_NORMAL_ROUNDED = 6
+PAN_LETT_NORMAL_OFF_CENTER = 7
+PAN_LETT_NORMAL_SQUARE = 8
+PAN_LETT_OBLIQUE_CONTACT = 9
+PAN_LETT_OBLIQUE_WEIGHTED = 10
+PAN_LETT_OBLIQUE_BOXED = 11
+PAN_LETT_OBLIQUE_FLATTENED = 12
+PAN_LETT_OBLIQUE_ROUNDED = 13
+PAN_LETT_OBLIQUE_OFF_CENTER = 14
+PAN_LETT_OBLIQUE_SQUARE = 15
+PAN_MIDLINE_STANDARD_TRIMMED = 2
+PAN_MIDLINE_STANDARD_POINTED = 3
+PAN_MIDLINE_STANDARD_SERIFED = 4
+PAN_MIDLINE_HIGH_TRIMMED = 5
+PAN_MIDLINE_HIGH_POINTED = 6
+PAN_MIDLINE_HIGH_SERIFED = 7
+PAN_MIDLINE_CONSTANT_TRIMMED = 8
+PAN_MIDLINE_CONSTANT_POINTED = 9
+PAN_MIDLINE_CONSTANT_SERIFED = 10
+PAN_MIDLINE_LOW_TRIMMED = 11
+PAN_MIDLINE_LOW_POINTED = 12
+PAN_MIDLINE_LOW_SERIFED = 13
+PAN_XHEIGHT_CONSTANT_SMALL = 2
+PAN_XHEIGHT_CONSTANT_STD = 3
+PAN_XHEIGHT_CONSTANT_LARGE = 4
+PAN_XHEIGHT_DUCKING_SMALL = 5
+PAN_XHEIGHT_DUCKING_STD = 6
+PAN_XHEIGHT_DUCKING_LARGE = 7
+ELF_VENDOR_SIZE = 4
+ELF_VERSION = 0
+ELF_CULTURE_LATIN = 0
+RASTER_FONTTYPE = 1
+DEVICE_FONTTYPE = 2
+TRUETYPE_FONTTYPE = 4
+
+
+def PALETTEINDEX(i):
+    return 16777216 | (i)
+
+
+PC_RESERVED = 1
+PC_EXPLICIT = 2
+PC_NOCOLLAPSE = 4
+
+
+def GetRValue(rgb):
+    return rgb & 0xFF
+
+
+def GetGValue(rgb):
+    return (rgb >> 8) & 0xFF
+
+
+def GetBValue(rgb):
+    return (rgb >> 16) & 0xFF
+
+
+TRANSPARENT = 1
+OPAQUE = 2
+BKMODE_LAST = 2
+GM_COMPATIBLE = 1
+GM_ADVANCED = 2
+GM_LAST = 2
+PT_CLOSEFIGURE = 1
+PT_LINETO = 2
+PT_BEZIERTO = 4
+PT_MOVETO = 6
+MM_TEXT = 1
+MM_LOMETRIC = 2
+MM_HIMETRIC = 3
+MM_LOENGLISH = 4
+MM_HIENGLISH = 5
+MM_TWIPS = 6
+MM_ISOTROPIC = 7
+MM_ANISOTROPIC = 8
+MM_MIN = MM_TEXT
+MM_MAX = MM_ANISOTROPIC
+MM_MAX_FIXEDSCALE = MM_TWIPS
+ABSOLUTE = 1
+RELATIVE = 2
+WHITE_BRUSH = 0
+LTGRAY_BRUSH = 1
+GRAY_BRUSH = 2
+DKGRAY_BRUSH = 3
+BLACK_BRUSH = 4
+NULL_BRUSH = 5
+HOLLOW_BRUSH = NULL_BRUSH
+WHITE_PEN = 6
+BLACK_PEN = 7
+NULL_PEN = 8
+OEM_FIXED_FONT = 10
+ANSI_FIXED_FONT = 11
+ANSI_VAR_FONT = 12
+SYSTEM_FONT = 13
+DEVICE_DEFAULT_FONT = 14
+DEFAULT_PALETTE = 15
+SYSTEM_FIXED_FONT = 16
+STOCK_LAST = 16
+CLR_INVALID = -1
+
+DC_BRUSH = 18
+DC_PEN = 19
+
+# Exception/Status codes from winuser.h and winnt.h
+STATUS_WAIT_0 = 0
+STATUS_ABANDONED_WAIT_0 = 128
+STATUS_USER_APC = 192
+STATUS_TIMEOUT = 258
+STATUS_PENDING = 259
+STATUS_SEGMENT_NOTIFICATION = 1073741829
+STATUS_GUARD_PAGE_VIOLATION = -2147483647
+STATUS_DATATYPE_MISALIGNMENT = -2147483646
+STATUS_BREAKPOINT = -2147483645
+STATUS_SINGLE_STEP = -2147483644
+STATUS_ACCESS_VIOLATION = -1073741819
+STATUS_IN_PAGE_ERROR = -1073741818
+STATUS_INVALID_HANDLE = -1073741816
+STATUS_NO_MEMORY = -1073741801
+STATUS_ILLEGAL_INSTRUCTION = -1073741795
+STATUS_NONCONTINUABLE_EXCEPTION = -1073741787
+STATUS_INVALID_DISPOSITION = -1073741786
+STATUS_ARRAY_BOUNDS_EXCEEDED = -1073741684
+STATUS_FLOAT_DENORMAL_OPERAND = -1073741683
+STATUS_FLOAT_DIVIDE_BY_ZERO = -1073741682
+STATUS_FLOAT_INEXACT_RESULT = -1073741681
+STATUS_FLOAT_INVALID_OPERATION = -1073741680
+STATUS_FLOAT_OVERFLOW = -1073741679
+STATUS_FLOAT_STACK_CHECK = -1073741678
+STATUS_FLOAT_UNDERFLOW = -1073741677
+STATUS_INTEGER_DIVIDE_BY_ZERO = -1073741676
+STATUS_INTEGER_OVERFLOW = -1073741675
+STATUS_PRIVILEGED_INSTRUCTION = -1073741674
+STATUS_STACK_OVERFLOW = -1073741571
+STATUS_CONTROL_C_EXIT = -1073741510
+
+
+WAIT_FAILED = -1
+WAIT_OBJECT_0 = STATUS_WAIT_0 + 0
+
+WAIT_ABANDONED = STATUS_ABANDONED_WAIT_0 + 0
+WAIT_ABANDONED_0 = STATUS_ABANDONED_WAIT_0 + 0
+
+WAIT_TIMEOUT = STATUS_TIMEOUT
+WAIT_IO_COMPLETION = STATUS_USER_APC
+STILL_ACTIVE = STATUS_PENDING
+EXCEPTION_ACCESS_VIOLATION = STATUS_ACCESS_VIOLATION
+EXCEPTION_DATATYPE_MISALIGNMENT = STATUS_DATATYPE_MISALIGNMENT
+EXCEPTION_BREAKPOINT = STATUS_BREAKPOINT
+EXCEPTION_SINGLE_STEP = STATUS_SINGLE_STEP
+EXCEPTION_ARRAY_BOUNDS_EXCEEDED = STATUS_ARRAY_BOUNDS_EXCEEDED
+EXCEPTION_FLT_DENORMAL_OPERAND = STATUS_FLOAT_DENORMAL_OPERAND
+EXCEPTION_FLT_DIVIDE_BY_ZERO = STATUS_FLOAT_DIVIDE_BY_ZERO
+EXCEPTION_FLT_INEXACT_RESULT = STATUS_FLOAT_INEXACT_RESULT
+EXCEPTION_FLT_INVALID_OPERATION = STATUS_FLOAT_INVALID_OPERATION
+EXCEPTION_FLT_OVERFLOW = STATUS_FLOAT_OVERFLOW
+EXCEPTION_FLT_STACK_CHECK = STATUS_FLOAT_STACK_CHECK
+EXCEPTION_FLT_UNDERFLOW = STATUS_FLOAT_UNDERFLOW
+EXCEPTION_INT_DIVIDE_BY_ZERO = STATUS_INTEGER_DIVIDE_BY_ZERO
+EXCEPTION_INT_OVERFLOW = STATUS_INTEGER_OVERFLOW
+EXCEPTION_PRIV_INSTRUCTION = STATUS_PRIVILEGED_INSTRUCTION
+EXCEPTION_IN_PAGE_ERROR = STATUS_IN_PAGE_ERROR
+EXCEPTION_ILLEGAL_INSTRUCTION = STATUS_ILLEGAL_INSTRUCTION
+EXCEPTION_NONCONTINUABLE_EXCEPTION = STATUS_NONCONTINUABLE_EXCEPTION
+EXCEPTION_STACK_OVERFLOW = STATUS_STACK_OVERFLOW
+EXCEPTION_INVALID_DISPOSITION = STATUS_INVALID_DISPOSITION
+EXCEPTION_GUARD_PAGE = STATUS_GUARD_PAGE_VIOLATION
+EXCEPTION_INVALID_HANDLE = STATUS_INVALID_HANDLE
+CONTROL_C_EXIT = STATUS_CONTROL_C_EXIT
+
+# winuser.h line 8594
+# constants used with SystemParametersInfo
+SPI_GETBEEP = 1
+SPI_SETBEEP = 2
+SPI_GETMOUSE = 3
+SPI_SETMOUSE = 4
+SPI_GETBORDER = 5
+SPI_SETBORDER = 6
+SPI_GETKEYBOARDSPEED = 10
+SPI_SETKEYBOARDSPEED = 11
+SPI_LANGDRIVER = 12
+SPI_ICONHORIZONTALSPACING = 13
+SPI_GETSCREENSAVETIMEOUT = 14
+SPI_SETSCREENSAVETIMEOUT = 15
+SPI_GETSCREENSAVEACTIVE = 16
+SPI_SETSCREENSAVEACTIVE = 17
+SPI_GETGRIDGRANULARITY = 18
+SPI_SETGRIDGRANULARITY = 19
+SPI_SETDESKWALLPAPER = 20
+SPI_SETDESKPATTERN = 21
+SPI_GETKEYBOARDDELAY = 22
+SPI_SETKEYBOARDDELAY = 23
+SPI_ICONVERTICALSPACING = 24
+SPI_GETICONTITLEWRAP = 25
+SPI_SETICONTITLEWRAP = 26
+SPI_GETMENUDROPALIGNMENT = 27
+SPI_SETMENUDROPALIGNMENT = 28
+SPI_SETDOUBLECLKWIDTH = 29
+SPI_SETDOUBLECLKHEIGHT = 30
+SPI_GETICONTITLELOGFONT = 31
+SPI_SETDOUBLECLICKTIME = 32
+SPI_SETMOUSEBUTTONSWAP = 33
+SPI_SETICONTITLELOGFONT = 34
+SPI_GETFASTTASKSWITCH = 35
+SPI_SETFASTTASKSWITCH = 36
+SPI_SETDRAGFULLWINDOWS = 37
+SPI_GETDRAGFULLWINDOWS = 38
+SPI_GETNONCLIENTMETRICS = 41
+SPI_SETNONCLIENTMETRICS = 42
+SPI_GETMINIMIZEDMETRICS = 43
+SPI_SETMINIMIZEDMETRICS = 44
+SPI_GETICONMETRICS = 45
+SPI_SETICONMETRICS = 46
+SPI_SETWORKAREA = 47
+SPI_GETWORKAREA = 48
+SPI_SETPENWINDOWS = 49
+SPI_GETFILTERKEYS = 50
+SPI_SETFILTERKEYS = 51
+SPI_GETTOGGLEKEYS = 52
+SPI_SETTOGGLEKEYS = 53
+SPI_GETMOUSEKEYS = 54
+SPI_SETMOUSEKEYS = 55
+SPI_GETSHOWSOUNDS = 56
+SPI_SETSHOWSOUNDS = 57
+SPI_GETSTICKYKEYS = 58
+SPI_SETSTICKYKEYS = 59
+SPI_GETACCESSTIMEOUT = 60
+SPI_SETACCESSTIMEOUT = 61
+SPI_GETSERIALKEYS = 62
+SPI_SETSERIALKEYS = 63
+SPI_GETSOUNDSENTRY = 64
+SPI_SETSOUNDSENTRY = 65
+SPI_GETHIGHCONTRAST = 66
+SPI_SETHIGHCONTRAST = 67
+SPI_GETKEYBOARDPREF = 68
+SPI_SETKEYBOARDPREF = 69
+SPI_GETSCREENREADER = 70
+SPI_SETSCREENREADER = 71
+SPI_GETANIMATION = 72
+SPI_SETANIMATION = 73
+SPI_GETFONTSMOOTHING = 74
+SPI_SETFONTSMOOTHING = 75
+SPI_SETDRAGWIDTH = 76
+SPI_SETDRAGHEIGHT = 77
+SPI_SETHANDHELD = 78
+SPI_GETLOWPOWERTIMEOUT = 79
+SPI_GETPOWEROFFTIMEOUT = 80
+SPI_SETLOWPOWERTIMEOUT = 81
+SPI_SETPOWEROFFTIMEOUT = 82
+SPI_GETLOWPOWERACTIVE = 83
+SPI_GETPOWEROFFACTIVE = 84
+SPI_SETLOWPOWERACTIVE = 85
+SPI_SETPOWEROFFACTIVE = 86
+SPI_SETCURSORS = 87
+SPI_SETICONS = 88
+SPI_GETDEFAULTINPUTLANG = 89
+SPI_SETDEFAULTINPUTLANG = 90
+SPI_SETLANGTOGGLE = 91
+SPI_GETWINDOWSEXTENSION = 92
+SPI_SETMOUSETRAILS = 93
+SPI_GETMOUSETRAILS = 94
+SPI_GETSNAPTODEFBUTTON = 95
+SPI_SETSNAPTODEFBUTTON = 96
+SPI_SETSCREENSAVERRUNNING = 97
+SPI_SCREENSAVERRUNNING = SPI_SETSCREENSAVERRUNNING
+SPI_GETMOUSEHOVERWIDTH = 98
+SPI_SETMOUSEHOVERWIDTH = 99
+SPI_GETMOUSEHOVERHEIGHT = 100
+SPI_SETMOUSEHOVERHEIGHT = 101
+SPI_GETMOUSEHOVERTIME = 102
+SPI_SETMOUSEHOVERTIME = 103
+SPI_GETWHEELSCROLLLINES = 104
+SPI_SETWHEELSCROLLLINES = 105
+SPI_GETMENUSHOWDELAY = 106
+SPI_SETMENUSHOWDELAY = 107
+
+SPI_GETSHOWIMEUI = 110
+SPI_SETSHOWIMEUI = 111
+SPI_GETMOUSESPEED = 112
+SPI_SETMOUSESPEED = 113
+SPI_GETSCREENSAVERRUNNING = 114
+SPI_GETDESKWALLPAPER = 115
+
+SPI_GETACTIVEWINDOWTRACKING = 4096
+SPI_SETACTIVEWINDOWTRACKING = 4097
+SPI_GETMENUANIMATION = 4098
+SPI_SETMENUANIMATION = 4099
+SPI_GETCOMBOBOXANIMATION = 4100
+SPI_SETCOMBOBOXANIMATION = 4101
+SPI_GETLISTBOXSMOOTHSCROLLING = 4102
+SPI_SETLISTBOXSMOOTHSCROLLING = 4103
+SPI_GETGRADIENTCAPTIONS = 4104
+SPI_SETGRADIENTCAPTIONS = 4105
+SPI_GETKEYBOARDCUES = 4106
+SPI_SETKEYBOARDCUES = 4107
+SPI_GETMENUUNDERLINES = 4106
+SPI_SETMENUUNDERLINES = 4107
+SPI_GETACTIVEWNDTRKZORDER = 4108
+SPI_SETACTIVEWNDTRKZORDER = 4109
+SPI_GETHOTTRACKING = 4110
+SPI_SETHOTTRACKING = 4111
+
+SPI_GETMENUFADE = 4114
+SPI_SETMENUFADE = 4115
+SPI_GETSELECTIONFADE = 4116
+SPI_SETSELECTIONFADE = 4117
+SPI_GETTOOLTIPANIMATION = 4118
+SPI_SETTOOLTIPANIMATION = 4119
+SPI_GETTOOLTIPFADE = 4120
+SPI_SETTOOLTIPFADE = 4121
+SPI_GETCURSORSHADOW = 4122
+SPI_SETCURSORSHADOW = 4123
+SPI_GETMOUSESONAR = 4124
+SPI_SETMOUSESONAR = 4125
+SPI_GETMOUSECLICKLOCK = 4126
+SPI_SETMOUSECLICKLOCK = 4127
+SPI_GETMOUSEVANISH = 4128
+SPI_SETMOUSEVANISH = 4129
+SPI_GETFLATMENU = 4130
+SPI_SETFLATMENU = 4131
+SPI_GETDROPSHADOW = 4132
+SPI_SETDROPSHADOW = 4133
+SPI_GETBLOCKSENDINPUTRESETS = 4134
+SPI_SETBLOCKSENDINPUTRESETS = 4135
+SPI_GETUIEFFECTS = 4158
+SPI_SETUIEFFECTS = 4159
+
+SPI_GETFOREGROUNDLOCKTIMEOUT = 8192
+SPI_SETFOREGROUNDLOCKTIMEOUT = 8193
+SPI_GETACTIVEWNDTRKTIMEOUT = 8194
+SPI_SETACTIVEWNDTRKTIMEOUT = 8195
+SPI_GETFOREGROUNDFLASHCOUNT = 8196
+SPI_SETFOREGROUNDFLASHCOUNT = 8197
+SPI_GETCARETWIDTH = 8198
+SPI_SETCARETWIDTH = 8199
+SPI_GETMOUSECLICKLOCKTIME = 8200
+SPI_SETMOUSECLICKLOCKTIME = 8201
+SPI_GETFONTSMOOTHINGTYPE = 8202
+SPI_SETFONTSMOOTHINGTYPE = 8203
+SPI_GETFONTSMOOTHINGCONTRAST = 8204
+SPI_SETFONTSMOOTHINGCONTRAST = 8205
+SPI_GETFOCUSBORDERWIDTH = 8206
+SPI_SETFOCUSBORDERWIDTH = 8207
+SPI_GETFOCUSBORDERHEIGHT = 8208
+SPI_SETFOCUSBORDERHEIGHT = 8209
+SPI_GETFONTSMOOTHINGORIENTATION = 8210
+SPI_SETFONTSMOOTHINGORIENTATION = 8211
+
+# fWinIni flags for SystemParametersInfo
+SPIF_UPDATEINIFILE = 1
+SPIF_SENDWININICHANGE = 2
+SPIF_SENDCHANGE = SPIF_SENDWININICHANGE
+
+# used with SystemParametersInfo and SPI_GETFONTSMOOTHINGTYPE/SPI_SETFONTSMOOTHINGTYPE
+FE_FONTSMOOTHINGSTANDARD = 1
+FE_FONTSMOOTHINGCLEARTYPE = 2
+FE_FONTSMOOTHINGDOCKING = 32768
+
+METRICS_USEDEFAULT = -1
+ARW_BOTTOMLEFT = 0
+ARW_BOTTOMRIGHT = 1
+ARW_TOPLEFT = 2
+ARW_TOPRIGHT = 3
+ARW_STARTMASK = 3
+ARW_STARTRIGHT = 1
+ARW_STARTTOP = 2
+ARW_LEFT = 0
+ARW_RIGHT = 0
+ARW_UP = 4
+ARW_DOWN = 4
+ARW_HIDE = 8
+# ARW_VALID = 0x000F
+SERKF_SERIALKEYSON = 1
+SERKF_AVAILABLE = 2
+SERKF_INDICATOR = 4
+HCF_HIGHCONTRASTON = 1
+HCF_AVAILABLE = 2
+HCF_HOTKEYACTIVE = 4
+HCF_CONFIRMHOTKEY = 8
+HCF_HOTKEYSOUND = 16
+HCF_INDICATOR = 32
+HCF_HOTKEYAVAILABLE = 64
+CDS_UPDATEREGISTRY = 1
+CDS_TEST = 2
+CDS_FULLSCREEN = 4
+CDS_GLOBAL = 8
+CDS_SET_PRIMARY = 16
+CDS_RESET = 1073741824
+CDS_SETRECT = 536870912
+CDS_NORESET = 268435456
+
+# return values from ChangeDisplaySettings and ChangeDisplaySettingsEx
+DISP_CHANGE_SUCCESSFUL = 0
+DISP_CHANGE_RESTART = 1
+DISP_CHANGE_FAILED = -1
+DISP_CHANGE_BADMODE = -2
+DISP_CHANGE_NOTUPDATED = -3
+DISP_CHANGE_BADFLAGS = -4
+DISP_CHANGE_BADPARAM = -5
+DISP_CHANGE_BADDUALVIEW = -6
+
+ENUM_CURRENT_SETTINGS = -1
+ENUM_REGISTRY_SETTINGS = -2
+FKF_FILTERKEYSON = 1
+FKF_AVAILABLE = 2
+FKF_HOTKEYACTIVE = 4
+FKF_CONFIRMHOTKEY = 8
+FKF_HOTKEYSOUND = 16
+FKF_INDICATOR = 32
+FKF_CLICKON = 64
+SKF_STICKYKEYSON = 1
+SKF_AVAILABLE = 2
+SKF_HOTKEYACTIVE = 4
+SKF_CONFIRMHOTKEY = 8
+SKF_HOTKEYSOUND = 16
+SKF_INDICATOR = 32
+SKF_AUDIBLEFEEDBACK = 64
+SKF_TRISTATE = 128
+SKF_TWOKEYSOFF = 256
+SKF_LALTLATCHED = 268435456
+SKF_LCTLLATCHED = 67108864
+SKF_LSHIFTLATCHED = 16777216
+SKF_RALTLATCHED = 536870912
+SKF_RCTLLATCHED = 134217728
+SKF_RSHIFTLATCHED = 33554432
+SKF_LWINLATCHED = 1073741824
+SKF_RWINLATCHED = -2147483648
+SKF_LALTLOCKED = 1048576
+SKF_LCTLLOCKED = 262144
+SKF_LSHIFTLOCKED = 65536
+SKF_RALTLOCKED = 2097152
+SKF_RCTLLOCKED = 524288
+SKF_RSHIFTLOCKED = 131072
+SKF_LWINLOCKED = 4194304
+SKF_RWINLOCKED = 8388608
+MKF_MOUSEKEYSON = 1
+MKF_AVAILABLE = 2
+MKF_HOTKEYACTIVE = 4
+MKF_CONFIRMHOTKEY = 8
+MKF_HOTKEYSOUND = 16
+MKF_INDICATOR = 32
+MKF_MODIFIERS = 64
+MKF_REPLACENUMBERS = 128
+MKF_LEFTBUTTONSEL = 268435456
+MKF_RIGHTBUTTONSEL = 536870912
+MKF_LEFTBUTTONDOWN = 16777216
+MKF_RIGHTBUTTONDOWN = 33554432
+MKF_MOUSEMODE = -2147483648
+ATF_TIMEOUTON = 1
+ATF_ONOFFFEEDBACK = 2
+SSGF_NONE = 0
+SSGF_DISPLAY = 3
+SSTF_NONE = 0
+SSTF_CHARS = 1
+SSTF_BORDER = 2
+SSTF_DISPLAY = 3
+SSWF_NONE = 0
+SSWF_TITLE = 1
+SSWF_WINDOW = 2
+SSWF_DISPLAY = 3
+SSWF_CUSTOM = 4
+SSF_SOUNDSENTRYON = 1
+SSF_AVAILABLE = 2
+SSF_INDICATOR = 4
+TKF_TOGGLEKEYSON = 1
+TKF_AVAILABLE = 2
+TKF_HOTKEYACTIVE = 4
+TKF_CONFIRMHOTKEY = 8
+TKF_HOTKEYSOUND = 16
+TKF_INDICATOR = 32
+SLE_ERROR = 1
+SLE_MINORERROR = 2
+SLE_WARNING = 3
+MONITOR_DEFAULTTONULL = 0
+MONITOR_DEFAULTTOPRIMARY = 1
+MONITOR_DEFAULTTONEAREST = 2
+MONITORINFOF_PRIMARY = 1
+CCHDEVICENAME = 32
+CHILDID_SELF = 0
+INDEXID_OBJECT = 0
+INDEXID_CONTAINER = 0
+OBJID_WINDOW = 0
+OBJID_SYSMENU = -1
+OBJID_TITLEBAR = -2
+OBJID_MENU = -3
+OBJID_CLIENT = -4
+OBJID_VSCROLL = -5
+OBJID_HSCROLL = -6
+OBJID_SIZEGRIP = -7
+OBJID_CARET = -8
+OBJID_CURSOR = -9
+OBJID_ALERT = -10
+OBJID_SOUND = -11
+EVENT_MIN = 1
+EVENT_MAX = 2147483647
+EVENT_SYSTEM_SOUND = 1
+EVENT_SYSTEM_ALERT = 2
+EVENT_SYSTEM_FOREGROUND = 3
+EVENT_SYSTEM_MENUSTART = 4
+EVENT_SYSTEM_MENUEND = 5
+EVENT_SYSTEM_MENUPOPUPSTART = 6
+EVENT_SYSTEM_MENUPOPUPEND = 7
+EVENT_SYSTEM_CAPTURESTART = 8
+EVENT_SYSTEM_CAPTUREEND = 9
+EVENT_SYSTEM_MOVESIZESTART = 10
+EVENT_SYSTEM_MOVESIZEEND = 11
+EVENT_SYSTEM_CONTEXTHELPSTART = 12
+EVENT_SYSTEM_CONTEXTHELPEND = 13
+EVENT_SYSTEM_DRAGDROPSTART = 14
+EVENT_SYSTEM_DRAGDROPEND = 15
+EVENT_SYSTEM_DIALOGSTART = 16
+EVENT_SYSTEM_DIALOGEND = 17
+EVENT_SYSTEM_SCROLLINGSTART = 18
+EVENT_SYSTEM_SCROLLINGEND = 19
+EVENT_SYSTEM_SWITCHSTART = 20
+EVENT_SYSTEM_SWITCHEND = 21
+EVENT_SYSTEM_MINIMIZESTART = 22
+EVENT_SYSTEM_MINIMIZEEND = 23
+EVENT_OBJECT_CREATE = 32768
+EVENT_OBJECT_DESTROY = 32769
+EVENT_OBJECT_SHOW = 32770
+EVENT_OBJECT_HIDE = 32771
+EVENT_OBJECT_REORDER = 32772
+EVENT_OBJECT_FOCUS = 32773
+EVENT_OBJECT_SELECTION = 32774
+EVENT_OBJECT_SELECTIONADD = 32775
+EVENT_OBJECT_SELECTIONREMOVE = 32776
+EVENT_OBJECT_SELECTIONWITHIN = 32777
+EVENT_OBJECT_STATECHANGE = 32778
+EVENT_OBJECT_LOCATIONCHANGE = 32779
+EVENT_OBJECT_NAMECHANGE = 32780
+EVENT_OBJECT_DESCRIPTIONCHANGE = 32781
+EVENT_OBJECT_VALUECHANGE = 32782
+EVENT_OBJECT_PARENTCHANGE = 32783
+EVENT_OBJECT_HELPCHANGE = 32784
+EVENT_OBJECT_DEFACTIONCHANGE = 32785
+EVENT_OBJECT_ACCELERATORCHANGE = 32786
+SOUND_SYSTEM_STARTUP = 1
+SOUND_SYSTEM_SHUTDOWN = 2
+SOUND_SYSTEM_BEEP = 3
+SOUND_SYSTEM_ERROR = 4
+SOUND_SYSTEM_QUESTION = 5
+SOUND_SYSTEM_WARNING = 6
+SOUND_SYSTEM_INFORMATION = 7
+SOUND_SYSTEM_MAXIMIZE = 8
+SOUND_SYSTEM_MINIMIZE = 9
+SOUND_SYSTEM_RESTOREUP = 10
+SOUND_SYSTEM_RESTOREDOWN = 11
+SOUND_SYSTEM_APPSTART = 12
+SOUND_SYSTEM_FAULT = 13
+SOUND_SYSTEM_APPEND = 14
+SOUND_SYSTEM_MENUCOMMAND = 15
+SOUND_SYSTEM_MENUPOPUP = 16
+CSOUND_SYSTEM = 16
+ALERT_SYSTEM_INFORMATIONAL = 1
+ALERT_SYSTEM_WARNING = 2
+ALERT_SYSTEM_ERROR = 3
+ALERT_SYSTEM_QUERY = 4
+ALERT_SYSTEM_CRITICAL = 5
+CALERT_SYSTEM = 6
+WINEVENT_OUTOFCONTEXT = 0
+WINEVENT_SKIPOWNTHREAD = 1
+WINEVENT_SKIPOWNPROCESS = 2
+WINEVENT_INCONTEXT = 4
+GUI_CARETBLINKING = 1
+GUI_INMOVESIZE = 2
+GUI_INMENUMODE = 4
+GUI_SYSTEMMENUMODE = 8
+GUI_POPUPMENUMODE = 16
+STATE_SYSTEM_UNAVAILABLE = 1
+STATE_SYSTEM_SELECTED = 2
+STATE_SYSTEM_FOCUSED = 4
+STATE_SYSTEM_PRESSED = 8
+STATE_SYSTEM_CHECKED = 16
+STATE_SYSTEM_MIXED = 32
+STATE_SYSTEM_READONLY = 64
+STATE_SYSTEM_HOTTRACKED = 128
+STATE_SYSTEM_DEFAULT = 256
+STATE_SYSTEM_EXPANDED = 512
+STATE_SYSTEM_COLLAPSED = 1024
+STATE_SYSTEM_BUSY = 2048
+STATE_SYSTEM_FLOATING = 4096
+STATE_SYSTEM_MARQUEED = 8192
+STATE_SYSTEM_ANIMATED = 16384
+STATE_SYSTEM_INVISIBLE = 32768
+STATE_SYSTEM_OFFSCREEN = 65536
+STATE_SYSTEM_SIZEABLE = 131072
+STATE_SYSTEM_MOVEABLE = 262144
+STATE_SYSTEM_SELFVOICING = 524288
+STATE_SYSTEM_FOCUSABLE = 1048576
+STATE_SYSTEM_SELECTABLE = 2097152
+STATE_SYSTEM_LINKED = 4194304
+STATE_SYSTEM_TRAVERSED = 8388608
+STATE_SYSTEM_MULTISELECTABLE = 16777216
+STATE_SYSTEM_EXTSELECTABLE = 33554432
+STATE_SYSTEM_ALERT_LOW = 67108864
+STATE_SYSTEM_ALERT_MEDIUM = 134217728
+STATE_SYSTEM_ALERT_HIGH = 268435456
+STATE_SYSTEM_VALID = 536870911
+CCHILDREN_TITLEBAR = 5
+CCHILDREN_SCROLLBAR = 5
+CURSOR_SHOWING = 1
+WS_ACTIVECAPTION = 1
+GA_MIC = 1
+GA_PARENT = 1
+GA_ROOT = 2
+GA_ROOTOWNER = 3
+GA_MAC = 4
+
+# winuser.h line 1979
+BF_LEFT = 1
+BF_TOP = 2
+BF_RIGHT = 4
+BF_BOTTOM = 8
+BF_TOPLEFT = BF_TOP | BF_LEFT
+BF_TOPRIGHT = BF_TOP | BF_RIGHT
+BF_BOTTOMLEFT = BF_BOTTOM | BF_LEFT
+BF_BOTTOMRIGHT = BF_BOTTOM | BF_RIGHT
+BF_RECT = BF_LEFT | BF_TOP | BF_RIGHT | BF_BOTTOM
+BF_DIAGONAL = 16
+BF_DIAGONAL_ENDTOPRIGHT = BF_DIAGONAL | BF_TOP | BF_RIGHT
+BF_DIAGONAL_ENDTOPLEFT = BF_DIAGONAL | BF_TOP | BF_LEFT
+BF_DIAGONAL_ENDBOTTOMLEFT = BF_DIAGONAL | BF_BOTTOM | BF_LEFT
+BF_DIAGONAL_ENDBOTTOMRIGHT = BF_DIAGONAL | BF_BOTTOM | BF_RIGHT
+BF_MIDDLE = 2048
+BF_SOFT = 4096
+BF_ADJUST = 8192
+BF_FLAT = 16384
+BF_MONO = 32768
+DFC_CAPTION = 1
+DFC_MENU = 2
+DFC_SCROLL = 3
+DFC_BUTTON = 4
+DFC_POPUPMENU = 5
+DFCS_CAPTIONCLOSE = 0
+DFCS_CAPTIONMIN = 1
+DFCS_CAPTIONMAX = 2
+DFCS_CAPTIONRESTORE = 3
+DFCS_CAPTIONHELP = 4
+DFCS_MENUARROW = 0
+DFCS_MENUCHECK = 1
+DFCS_MENUBULLET = 2
+DFCS_MENUARROWRIGHT = 4
+DFCS_SCROLLUP = 0
+DFCS_SCROLLDOWN = 1
+DFCS_SCROLLLEFT = 2
+DFCS_SCROLLRIGHT = 3
+DFCS_SCROLLCOMBOBOX = 5
+DFCS_SCROLLSIZEGRIP = 8
+DFCS_SCROLLSIZEGRIPRIGHT = 16
+DFCS_BUTTONCHECK = 0
+DFCS_BUTTONRADIOIMAGE = 1
+DFCS_BUTTONRADIOMASK = 2
+DFCS_BUTTONRADIO = 4
+DFCS_BUTTON3STATE = 8
+DFCS_BUTTONPUSH = 16
+DFCS_INACTIVE = 256
+DFCS_PUSHED = 512
+DFCS_CHECKED = 1024
+DFCS_TRANSPARENT = 2048
+DFCS_HOT = 4096
+DFCS_ADJUSTRECT = 8192
+DFCS_FLAT = 16384
+DFCS_MONO = 32768
+DC_ACTIVE = 1
+DC_SMALLCAP = 2
+DC_ICON = 4
+DC_TEXT = 8
+DC_INBUTTON = 16
+DC_GRADIENT = 32
+IDANI_OPEN = 1
+IDANI_CLOSE = 2
+IDANI_CAPTION = 3
+CF_TEXT = 1
+CF_BITMAP = 2
+CF_METAFILEPICT = 3
+CF_SYLK = 4
+CF_DIF = 5
+CF_TIFF = 6
+CF_OEMTEXT = 7
+CF_DIB = 8
+CF_PALETTE = 9
+CF_PENDATA = 10
+CF_RIFF = 11
+CF_WAVE = 12
+CF_UNICODETEXT = 13
+CF_ENHMETAFILE = 14
+CF_HDROP = 15
+CF_LOCALE = 16
+CF_DIBV5 = 17
+CF_MAX = 18
+CF_OWNERDISPLAY = 128
+CF_DSPTEXT = 129
+CF_DSPBITMAP = 130
+CF_DSPMETAFILEPICT = 131
+CF_DSPENHMETAFILE = 142
+CF_PRIVATEFIRST = 512
+CF_PRIVATELAST = 767
+CF_GDIOBJFIRST = 768
+CF_GDIOBJLAST = 1023
+FVIRTKEY = 1
+FNOINVERT = 2
+FSHIFT = 4
+FCONTROL = 8
+FALT = 16
+WPF_SETMINPOSITION = 1
+WPF_RESTORETOMAXIMIZED = 2
+ODT_MENU = 1
+ODT_LISTBOX = 2
+ODT_COMBOBOX = 3
+ODT_BUTTON = 4
+ODT_STATIC = 5
+ODA_DRAWENTIRE = 1
+ODA_SELECT = 2
+ODA_FOCUS = 4
+ODS_SELECTED = 1
+ODS_GRAYED = 2
+ODS_DISABLED = 4
+ODS_CHECKED = 8
+ODS_FOCUS = 16
+ODS_DEFAULT = 32
+ODS_COMBOBOXEDIT = 4096
+ODS_HOTLIGHT = 64
+ODS_INACTIVE = 128
+PM_NOREMOVE = 0
+PM_REMOVE = 1
+PM_NOYIELD = 2
+MOD_ALT = 1
+MOD_CONTROL = 2
+MOD_SHIFT = 4
+MOD_WIN = 8
+IDHOT_SNAPWINDOW = -1
+IDHOT_SNAPDESKTOP = -2
+# EW_RESTARTWINDOWS = 0x0042
+# EW_REBOOTSYSTEM = 0x0043
+# EW_EXITANDEXECAPP = 0x0044
+ENDSESSION_LOGOFF = -2147483648
+EWX_LOGOFF = 0
+EWX_SHUTDOWN = 1
+EWX_REBOOT = 2
+EWX_FORCE = 4
+EWX_POWEROFF = 8
+EWX_FORCEIFHUNG = 16
+BSM_ALLCOMPONENTS = 0
+BSM_VXDS = 1
+BSM_NETDRIVER = 2
+BSM_INSTALLABLEDRIVERS = 4
+BSM_APPLICATIONS = 8
+BSM_ALLDESKTOPS = 16
+BSF_QUERY = 1
+BSF_IGNORECURRENTTASK = 2
+BSF_FLUSHDISK = 4
+BSF_NOHANG = 8
+BSF_POSTMESSAGE = 16
+BSF_FORCEIFHUNG = 32
+BSF_NOTIMEOUTIFNOTHUNG = 64
+BROADCAST_QUERY_DENY = 1112363332  # Return this value to deny a query.
+
+DBWF_LPARAMPOINTER = 32768
+
+# winuser.h line 3232
+SWP_NOSIZE = 1
+SWP_NOMOVE = 2
+SWP_NOZORDER = 4
+SWP_NOREDRAW = 8
+SWP_NOACTIVATE = 16
+SWP_FRAMECHANGED = 32
+SWP_SHOWWINDOW = 64
+SWP_HIDEWINDOW = 128
+SWP_NOCOPYBITS = 256
+SWP_NOOWNERZORDER = 512
+SWP_NOSENDCHANGING = 1024
+SWP_DRAWFRAME = SWP_FRAMECHANGED
+SWP_NOREPOSITION = SWP_NOOWNERZORDER
+SWP_DEFERERASE = 8192
+SWP_ASYNCWINDOWPOS = 16384
+
+DLGWINDOWEXTRA = 30
+# winuser.h line 4249
+KEYEVENTF_EXTENDEDKEY = 1
+KEYEVENTF_KEYUP = 2
+# if(_WIN32_WINNT >= 0x0500)
+KEYEVENTF_UNICODE = 4
+KEYEVENTF_SCANCODE = 8
+# endif /* _WIN32_WINNT >= 0x0500 */
+MOUSEEVENTF_MOVE = 1
+MOUSEEVENTF_LEFTDOWN = 2
+MOUSEEVENTF_LEFTUP = 4
+MOUSEEVENTF_RIGHTDOWN = 8
+MOUSEEVENTF_RIGHTUP = 16
+MOUSEEVENTF_MIDDLEDOWN = 32
+MOUSEEVENTF_MIDDLEUP = 64
+MOUSEEVENTF_XDOWN = 128
+MOUSEEVENTF_XUP = 256
+MOUSEEVENTF_WHEEL = 2048
+# if (_WIN32_WINNT >= 0x0600)
+MOUSEEVENTF_HWHEEL = 4096
+# endif
+# if(WINVER >= 0x0600)
+MOUSEEVENTF_MOVE_NOCOALESCE = 8192
+# endif /* WINVER >= 0x0600 */
+MOUSEEVENTF_VIRTUALDESK = 16384
+MOUSEEVENTF_ABSOLUTE = 32768
+INPUT_MOUSE = 0
+INPUT_KEYBOARD = 1
+INPUT_HARDWARE = 2
+MWMO_WAITALL = 1
+MWMO_ALERTABLE = 2
+MWMO_INPUTAVAILABLE = 4
+QS_KEY = 1
+QS_MOUSEMOVE = 2
+QS_MOUSEBUTTON = 4
+QS_POSTMESSAGE = 8
+QS_TIMER = 16
+QS_PAINT = 32
+QS_SENDMESSAGE = 64
+QS_HOTKEY = 128
+QS_MOUSE = QS_MOUSEMOVE | QS_MOUSEBUTTON
+QS_INPUT = QS_MOUSE | QS_KEY
+QS_ALLEVENTS = QS_INPUT | QS_POSTMESSAGE | QS_TIMER | QS_PAINT | QS_HOTKEY
+QS_ALLINPUT = (
+    QS_INPUT | QS_POSTMESSAGE | QS_TIMER | QS_PAINT | QS_HOTKEY | QS_SENDMESSAGE
+)
+
+
+IMN_CLOSESTATUSWINDOW = 1
+IMN_OPENSTATUSWINDOW = 2
+IMN_CHANGECANDIDATE = 3
+IMN_CLOSECANDIDATE = 4
+IMN_OPENCANDIDATE = 5
+IMN_SETCONVERSIONMODE = 6
+IMN_SETSENTENCEMODE = 7
+IMN_SETOPENSTATUS = 8
+IMN_SETCANDIDATEPOS = 9
+IMN_SETCOMPOSITIONFONT = 10
+IMN_SETCOMPOSITIONWINDOW = 11
+IMN_SETSTATUSWINDOWPOS = 12
+IMN_GUIDELINE = 13
+IMN_PRIVATE = 14
+
+# winuser.h line 8518
+HELP_CONTEXT = 1
+HELP_QUIT = 2
+HELP_INDEX = 3
+HELP_CONTENTS = 3
+HELP_HELPONHELP = 4
+HELP_SETINDEX = 5
+HELP_SETCONTENTS = 5
+HELP_CONTEXTPOPUP = 8
+HELP_FORCEFILE = 9
+HELP_KEY = 257
+HELP_COMMAND = 258
+HELP_PARTIALKEY = 261
+HELP_MULTIKEY = 513
+HELP_SETWINPOS = 515
+HELP_CONTEXTMENU = 10
+HELP_FINDER = 11
+HELP_WM_HELP = 12
+HELP_SETPOPUP_POS = 13
+HELP_TCARD = 32768
+HELP_TCARD_DATA = 16
+HELP_TCARD_OTHER_CALLER = 17
+IDH_NO_HELP = 28440
+IDH_MISSING_CONTEXT = 28441  # Control doesn't have matching help context
+IDH_GENERIC_HELP_BUTTON = 28442  # Property sheet help button
+IDH_OK = 28443
+IDH_CANCEL = 28444
+IDH_HELP = 28445
+GR_GDIOBJECTS = 0  # Count of GDI objects
+GR_USEROBJECTS = 1  # Count of USER objects
+# Generated by h2py from \msvcnt\include\wingdi.h
+# manually added (missed by generation some how!
+SRCCOPY = 13369376  # dest = source
+SRCPAINT = 15597702  # dest = source OR dest
+SRCAND = 8913094  # dest = source AND dest
+SRCINVERT = 6684742  # dest = source XOR dest
+SRCERASE = 4457256  # dest = source AND (NOT dest )
+NOTSRCCOPY = 3342344  # dest = (NOT source)
+NOTSRCERASE = 1114278  # dest = (NOT src) AND (NOT dest)
+MERGECOPY = 12583114  # dest = (source AND pattern)
+MERGEPAINT = 12255782  # dest = (NOT source) OR dest
+PATCOPY = 15728673  # dest = pattern
+PATPAINT = 16452105  # dest = DPSnoo
+PATINVERT = 5898313  # dest = pattern XOR dest
+DSTINVERT = 5570569  # dest = (NOT dest)
+BLACKNESS = 66  # dest = BLACK
+WHITENESS = 16711778  # dest = WHITE
+
+# hacked and split manually by mhammond.
+R2_BLACK = 1
+R2_NOTMERGEPEN = 2
+R2_MASKNOTPEN = 3
+R2_NOTCOPYPEN = 4
+R2_MASKPENNOT = 5
+R2_NOT = 6
+R2_XORPEN = 7
+R2_NOTMASKPEN = 8
+R2_MASKPEN = 9
+R2_NOTXORPEN = 10
+R2_NOP = 11
+R2_MERGENOTPEN = 12
+R2_COPYPEN = 13
+R2_MERGEPENNOT = 14
+R2_MERGEPEN = 15
+R2_WHITE = 16
+R2_LAST = 16
+GDI_ERROR = -1
+ERROR = 0
+NULLREGION = 1
+SIMPLEREGION = 2
+COMPLEXREGION = 3
+RGN_ERROR = ERROR
+RGN_AND = 1
+RGN_OR = 2
+RGN_XOR = 3
+RGN_DIFF = 4
+RGN_COPY = 5
+RGN_MIN = RGN_AND
+RGN_MAX = RGN_COPY
+
+## Stretching modes used with Get/SetStretchBltMode
+BLACKONWHITE = 1
+WHITEONBLACK = 2
+COLORONCOLOR = 3
+HALFTONE = 4
+MAXSTRETCHBLTMODE = 4
+STRETCH_ANDSCANS = BLACKONWHITE
+STRETCH_ORSCANS = WHITEONBLACK
+STRETCH_DELETESCANS = COLORONCOLOR
+STRETCH_HALFTONE = HALFTONE
+
+ALTERNATE = 1
+WINDING = 2
+POLYFILL_LAST = 2
+
+## flags used with SetLayout
+LAYOUT_RTL = 1
+LAYOUT_BTT = 2
+LAYOUT_VBH = 4
+LAYOUT_ORIENTATIONMASK = LAYOUT_RTL | LAYOUT_BTT | LAYOUT_VBH
+LAYOUT_BITMAPORIENTATIONPRESERVED = 8
+
+TA_NOUPDATECP = 0
+TA_UPDATECP = 1
+TA_LEFT = 0
+TA_RIGHT = 2
+TA_CENTER = 6
+TA_TOP = 0
+TA_BOTTOM = 8
+TA_BASELINE = 24
+TA_MASK = TA_BASELINE + TA_CENTER + TA_UPDATECP
+VTA_BASELINE = TA_BASELINE
+VTA_LEFT = TA_BOTTOM
+VTA_RIGHT = TA_TOP
+VTA_CENTER = TA_CENTER
+VTA_BOTTOM = TA_RIGHT
+VTA_TOP = TA_LEFT
+ETO_GRAYED = 1
+ETO_OPAQUE = 2
+ETO_CLIPPED = 4
+ASPECT_FILTERING = 1
+DCB_RESET = 1
+DCB_ACCUMULATE = 2
+DCB_DIRTY = DCB_ACCUMULATE
+DCB_SET = DCB_RESET | DCB_ACCUMULATE
+DCB_ENABLE = 4
+DCB_DISABLE = 8
+META_SETBKCOLOR = 513
+META_SETBKMODE = 258
+META_SETMAPMODE = 259
+META_SETROP2 = 260
+META_SETRELABS = 261
+META_SETPOLYFILLMODE = 262
+META_SETSTRETCHBLTMODE = 263
+META_SETTEXTCHAREXTRA = 264
+META_SETTEXTCOLOR = 521
+META_SETTEXTJUSTIFICATION = 522
+META_SETWINDOWORG = 523
+META_SETWINDOWEXT = 524
+META_SETVIEWPORTORG = 525
+META_SETVIEWPORTEXT = 526
+META_OFFSETWINDOWORG = 527
+META_SCALEWINDOWEXT = 1040
+META_OFFSETVIEWPORTORG = 529
+META_SCALEVIEWPORTEXT = 1042
+META_LINETO = 531
+META_MOVETO = 532
+META_EXCLUDECLIPRECT = 1045
+META_INTERSECTCLIPRECT = 1046
+META_ARC = 2071
+META_ELLIPSE = 1048
+META_FLOODFILL = 1049
+META_PIE = 2074
+META_RECTANGLE = 1051
+META_ROUNDRECT = 1564
+META_PATBLT = 1565
+META_SAVEDC = 30
+META_SETPIXEL = 1055
+META_OFFSETCLIPRGN = 544
+META_TEXTOUT = 1313
+META_BITBLT = 2338
+META_STRETCHBLT = 2851
+META_POLYGON = 804
+META_POLYLINE = 805
+META_ESCAPE = 1574
+META_RESTOREDC = 295
+META_FILLREGION = 552
+META_FRAMEREGION = 1065
+META_INVERTREGION = 298
+META_PAINTREGION = 299
+META_SELECTCLIPREGION = 300
+META_SELECTOBJECT = 301
+META_SETTEXTALIGN = 302
+META_CHORD = 2096
+META_SETMAPPERFLAGS = 561
+META_EXTTEXTOUT = 2610
+META_SETDIBTODEV = 3379
+META_SELECTPALETTE = 564
+META_REALIZEPALETTE = 53
+META_ANIMATEPALETTE = 1078
+META_SETPALENTRIES = 55
+META_POLYPOLYGON = 1336
+META_RESIZEPALETTE = 313
+META_DIBBITBLT = 2368
+META_DIBSTRETCHBLT = 2881
+META_DIBCREATEPATTERNBRUSH = 322
+META_STRETCHDIB = 3907
+META_EXTFLOODFILL = 1352
+META_DELETEOBJECT = 496
+META_CREATEPALETTE = 247
+META_CREATEPATTERNBRUSH = 505
+META_CREATEPENINDIRECT = 762
+META_CREATEFONTINDIRECT = 763
+META_CREATEBRUSHINDIRECT = 764
+META_CREATEREGION = 1791
+FILE_BEGIN = 0
+FILE_CURRENT = 1
+FILE_END = 2
+FILE_FLAG_WRITE_THROUGH = -2147483648
+FILE_FLAG_OVERLAPPED = 1073741824
+FILE_FLAG_NO_BUFFERING = 536870912
+FILE_FLAG_RANDOM_ACCESS = 268435456
+FILE_FLAG_SEQUENTIAL_SCAN = 134217728
+FILE_FLAG_DELETE_ON_CLOSE = 67108864
+FILE_FLAG_BACKUP_SEMANTICS = 33554432
+FILE_FLAG_POSIX_SEMANTICS = 16777216
+CREATE_NEW = 1
+CREATE_ALWAYS = 2
+OPEN_EXISTING = 3
+OPEN_ALWAYS = 4
+TRUNCATE_EXISTING = 5
+PIPE_ACCESS_INBOUND = 1
+PIPE_ACCESS_OUTBOUND = 2
+PIPE_ACCESS_DUPLEX = 3
+PIPE_CLIENT_END = 0
+PIPE_SERVER_END = 1
+PIPE_WAIT = 0
+PIPE_NOWAIT = 1
+PIPE_READMODE_BYTE = 0
+PIPE_READMODE_MESSAGE = 2
+PIPE_TYPE_BYTE = 0
+PIPE_TYPE_MESSAGE = 4
+PIPE_UNLIMITED_INSTANCES = 255
+SECURITY_CONTEXT_TRACKING = 262144
+SECURITY_EFFECTIVE_ONLY = 524288
+SECURITY_SQOS_PRESENT = 1048576
+SECURITY_VALID_SQOS_FLAGS = 2031616
+DTR_CONTROL_DISABLE = 0
+DTR_CONTROL_ENABLE = 1
+DTR_CONTROL_HANDSHAKE = 2
+RTS_CONTROL_DISABLE = 0
+RTS_CONTROL_ENABLE = 1
+RTS_CONTROL_HANDSHAKE = 2
+RTS_CONTROL_TOGGLE = 3
+GMEM_FIXED = 0
+GMEM_MOVEABLE = 2
+GMEM_NOCOMPACT = 16
+GMEM_NODISCARD = 32
+GMEM_ZEROINIT = 64
+GMEM_MODIFY = 128
+GMEM_DISCARDABLE = 256
+GMEM_NOT_BANKED = 4096
+GMEM_SHARE = 8192
+GMEM_DDESHARE = 8192
+GMEM_NOTIFY = 16384
+GMEM_LOWER = GMEM_NOT_BANKED
+GMEM_VALID_FLAGS = 32626
+GMEM_INVALID_HANDLE = 32768
+GHND = GMEM_MOVEABLE | GMEM_ZEROINIT
+GPTR = GMEM_FIXED | GMEM_ZEROINIT
+GMEM_DISCARDED = 16384
+GMEM_LOCKCOUNT = 255
+LMEM_FIXED = 0
+LMEM_MOVEABLE = 2
+LMEM_NOCOMPACT = 16
+LMEM_NODISCARD = 32
+LMEM_ZEROINIT = 64
+LMEM_MODIFY = 128
+LMEM_DISCARDABLE = 3840
+LMEM_VALID_FLAGS = 3954
+LMEM_INVALID_HANDLE = 32768
+LHND = LMEM_MOVEABLE | LMEM_ZEROINIT
+LPTR = LMEM_FIXED | LMEM_ZEROINIT
+NONZEROLHND = LMEM_MOVEABLE
+NONZEROLPTR = LMEM_FIXED
+LMEM_DISCARDED = 16384
+LMEM_LOCKCOUNT = 255
+DEBUG_PROCESS = 1
+DEBUG_ONLY_THIS_PROCESS = 2
+CREATE_SUSPENDED = 4
+DETACHED_PROCESS = 8
+CREATE_NEW_CONSOLE = 16
+NORMAL_PRIORITY_CLASS = 32
+IDLE_PRIORITY_CLASS = 64
+HIGH_PRIORITY_CLASS = 128
+REALTIME_PRIORITY_CLASS = 256
+CREATE_NEW_PROCESS_GROUP = 512
+CREATE_UNICODE_ENVIRONMENT = 1024
+CREATE_SEPARATE_WOW_VDM = 2048
+CREATE_SHARED_WOW_VDM = 4096
+CREATE_DEFAULT_ERROR_MODE = 67108864
+CREATE_NO_WINDOW = 134217728
+PROFILE_USER = 268435456
+PROFILE_KERNEL = 536870912
+PROFILE_SERVER = 1073741824
+THREAD_BASE_PRIORITY_LOWRT = 15
+THREAD_BASE_PRIORITY_MAX = 2
+THREAD_BASE_PRIORITY_MIN = -2
+THREAD_BASE_PRIORITY_IDLE = -15
+THREAD_PRIORITY_LOWEST = THREAD_BASE_PRIORITY_MIN
+THREAD_PRIORITY_BELOW_NORMAL = THREAD_PRIORITY_LOWEST + 1
+THREAD_PRIORITY_HIGHEST = THREAD_BASE_PRIORITY_MAX
+THREAD_PRIORITY_ABOVE_NORMAL = THREAD_PRIORITY_HIGHEST - 1
+THREAD_PRIORITY_ERROR_RETURN = MAXLONG
+THREAD_PRIORITY_TIME_CRITICAL = THREAD_BASE_PRIORITY_LOWRT
+THREAD_PRIORITY_IDLE = THREAD_BASE_PRIORITY_IDLE
+THREAD_PRIORITY_NORMAL = 0
+THREAD_MODE_BACKGROUND_BEGIN = 0x00010000
+THREAD_MODE_BACKGROUND_END = 0x00020000
+
+EXCEPTION_DEBUG_EVENT = 1
+CREATE_THREAD_DEBUG_EVENT = 2
+CREATE_PROCESS_DEBUG_EVENT = 3
+EXIT_THREAD_DEBUG_EVENT = 4
+EXIT_PROCESS_DEBUG_EVENT = 5
+LOAD_DLL_DEBUG_EVENT = 6
+UNLOAD_DLL_DEBUG_EVENT = 7
+OUTPUT_DEBUG_STRING_EVENT = 8
+RIP_EVENT = 9
+DRIVE_UNKNOWN = 0
+DRIVE_NO_ROOT_DIR = 1
+DRIVE_REMOVABLE = 2
+DRIVE_FIXED = 3
+DRIVE_REMOTE = 4
+DRIVE_CDROM = 5
+DRIVE_RAMDISK = 6
+FILE_TYPE_UNKNOWN = 0
+FILE_TYPE_DISK = 1
+FILE_TYPE_CHAR = 2
+FILE_TYPE_PIPE = 3
+FILE_TYPE_REMOTE = 32768
+NOPARITY = 0
+ODDPARITY = 1
+EVENPARITY = 2
+MARKPARITY = 3
+SPACEPARITY = 4
+ONESTOPBIT = 0
+ONE5STOPBITS = 1
+TWOSTOPBITS = 2
+CBR_110 = 110
+CBR_300 = 300
+CBR_600 = 600
+CBR_1200 = 1200
+CBR_2400 = 2400
+CBR_4800 = 4800
+CBR_9600 = 9600
+CBR_14400 = 14400
+CBR_19200 = 19200
+CBR_38400 = 38400
+CBR_56000 = 56000
+CBR_57600 = 57600
+CBR_115200 = 115200
+CBR_128000 = 128000
+CBR_256000 = 256000
+S_QUEUEEMPTY = 0
+S_THRESHOLD = 1
+S_ALLTHRESHOLD = 2
+S_NORMAL = 0
+S_LEGATO = 1
+S_STACCATO = 2
+NMPWAIT_WAIT_FOREVER = -1
+NMPWAIT_NOWAIT = 1
+NMPWAIT_USE_DEFAULT_WAIT = 0
+OF_READ = 0
+OF_WRITE = 1
+OF_READWRITE = 2
+OF_SHARE_COMPAT = 0
+OF_SHARE_EXCLUSIVE = 16
+OF_SHARE_DENY_WRITE = 32
+OF_SHARE_DENY_READ = 48
+OF_SHARE_DENY_NONE = 64
+OF_PARSE = 256
+OF_DELETE = 512
+OF_VERIFY = 1024
+OF_CANCEL = 2048
+OF_CREATE = 4096
+OF_PROMPT = 8192
+OF_EXIST = 16384
+OF_REOPEN = 32768
+OFS_MAXPATHNAME = 128
+MAXINTATOM = 49152
+
+# winbase.h
+PROCESS_HEAP_REGION = 1
+PROCESS_HEAP_UNCOMMITTED_RANGE = 2
+PROCESS_HEAP_ENTRY_BUSY = 4
+PROCESS_HEAP_ENTRY_MOVEABLE = 16
+PROCESS_HEAP_ENTRY_DDESHARE = 32
+SCS_32BIT_BINARY = 0
+SCS_DOS_BINARY = 1
+SCS_WOW_BINARY = 2
+SCS_PIF_BINARY = 3
+SCS_POSIX_BINARY = 4
+SCS_OS216_BINARY = 5
+SEM_FAILCRITICALERRORS = 1
+SEM_NOGPFAULTERRORBOX = 2
+SEM_NOALIGNMENTFAULTEXCEPT = 4
+SEM_NOOPENFILEERRORBOX = 32768
+LOCKFILE_FAIL_IMMEDIATELY = 1
+LOCKFILE_EXCLUSIVE_LOCK = 2
+HANDLE_FLAG_INHERIT = 1
+HANDLE_FLAG_PROTECT_FROM_CLOSE = 2
+HINSTANCE_ERROR = 32
+GET_TAPE_MEDIA_INFORMATION = 0
+GET_TAPE_DRIVE_INFORMATION = 1
+SET_TAPE_MEDIA_INFORMATION = 0
+SET_TAPE_DRIVE_INFORMATION = 1
+FORMAT_MESSAGE_ALLOCATE_BUFFER = 256
+FORMAT_MESSAGE_IGNORE_INSERTS = 512
+FORMAT_MESSAGE_FROM_STRING = 1024
+FORMAT_MESSAGE_FROM_HMODULE = 2048
+FORMAT_MESSAGE_FROM_SYSTEM = 4096
+FORMAT_MESSAGE_ARGUMENT_ARRAY = 8192
+FORMAT_MESSAGE_MAX_WIDTH_MASK = 255
+BACKUP_INVALID = 0
+BACKUP_DATA = 1
+BACKUP_EA_DATA = 2
+BACKUP_SECURITY_DATA = 3
+BACKUP_ALTERNATE_DATA = 4
+BACKUP_LINK = 5
+BACKUP_PROPERTY_DATA = 6
+BACKUP_OBJECT_ID = 7
+BACKUP_REPARSE_DATA = 8
+BACKUP_SPARSE_BLOCK = 9
+
+STREAM_NORMAL_ATTRIBUTE = 0
+STREAM_MODIFIED_WHEN_READ = 1
+STREAM_CONTAINS_SECURITY = 2
+STREAM_CONTAINS_PROPERTIES = 4
+STARTF_USESHOWWINDOW = 1
+STARTF_USESIZE = 2
+STARTF_USEPOSITION = 4
+STARTF_USECOUNTCHARS = 8
+STARTF_USEFILLATTRIBUTE = 16
+STARTF_FORCEONFEEDBACK = 64
+STARTF_FORCEOFFFEEDBACK = 128
+STARTF_USESTDHANDLES = 256
+STARTF_USEHOTKEY = 512
+SHUTDOWN_NORETRY = 1
+DONT_RESOLVE_DLL_REFERENCES = 1
+LOAD_LIBRARY_AS_DATAFILE = 2
+LOAD_WITH_ALTERED_SEARCH_PATH = 8
+DDD_RAW_TARGET_PATH = 1
+DDD_REMOVE_DEFINITION = 2
+DDD_EXACT_MATCH_ON_REMOVE = 4
+MOVEFILE_REPLACE_EXISTING = 1
+MOVEFILE_COPY_ALLOWED = 2
+MOVEFILE_DELAY_UNTIL_REBOOT = 4
+MAX_COMPUTERNAME_LENGTH = 15
+LOGON32_LOGON_INTERACTIVE = 2
+LOGON32_LOGON_NETWORK = 3
+LOGON32_LOGON_BATCH = 4
+LOGON32_LOGON_SERVICE = 5
+LOGON32_LOGON_UNLOCK = 7
+LOGON32_LOGON_NETWORK_CLEARTEXT = 8
+LOGON32_LOGON_NEW_CREDENTIALS = 9
+LOGON32_PROVIDER_DEFAULT = 0
+LOGON32_PROVIDER_WINNT35 = 1
+LOGON32_PROVIDER_WINNT40 = 2
+LOGON32_PROVIDER_WINNT50 = 3
+VER_PLATFORM_WIN32s = 0
+VER_PLATFORM_WIN32_WINDOWS = 1
+VER_PLATFORM_WIN32_NT = 2
+TC_NORMAL = 0
+TC_HARDERR = 1
+TC_GP_TRAP = 2
+TC_SIGNAL = 3
+AC_LINE_OFFLINE = 0
+AC_LINE_ONLINE = 1
+AC_LINE_BACKUP_POWER = 2
+AC_LINE_UNKNOWN = 255
+BATTERY_FLAG_HIGH = 1
+BATTERY_FLAG_LOW = 2
+BATTERY_FLAG_CRITICAL = 4
+BATTERY_FLAG_CHARGING = 8
+BATTERY_FLAG_NO_BATTERY = 128
+BATTERY_FLAG_UNKNOWN = 255
+BATTERY_PERCENTAGE_UNKNOWN = 255
+BATTERY_LIFE_UNKNOWN = -1
+
+# Generated by h2py from d:\msdev\include\richedit.h
+cchTextLimitDefault = 32767
+WM_CONTEXTMENU = 123
+WM_PRINTCLIENT = 792
+EN_MSGFILTER = 1792
+EN_REQUESTRESIZE = 1793
+EN_SELCHANGE = 1794
+EN_DROPFILES = 1795
+EN_PROTECTED = 1796
+EN_CORRECTTEXT = 1797
+EN_STOPNOUNDO = 1798
+EN_IMECHANGE = 1799
+EN_SAVECLIPBOARD = 1800
+EN_OLEOPFAILED = 1801
+ENM_NONE = 0
+ENM_CHANGE = 1
+ENM_UPDATE = 2
+ENM_SCROLL = 4
+ENM_KEYEVENTS = 65536
+ENM_MOUSEEVENTS = 131072
+ENM_REQUESTRESIZE = 262144
+ENM_SELCHANGE = 524288
+ENM_DROPFILES = 1048576
+ENM_PROTECTED = 2097152
+ENM_CORRECTTEXT = 4194304
+ENM_IMECHANGE = 8388608
+ES_SAVESEL = 32768
+ES_SUNKEN = 16384
+ES_DISABLENOSCROLL = 8192
+ES_SELECTIONBAR = 16777216
+ES_EX_NOCALLOLEINIT = 16777216
+ES_VERTICAL = 4194304
+ES_NOIME = 524288
+ES_SELFIME = 262144
+ECO_AUTOWORDSELECTION = 1
+ECO_AUTOVSCROLL = 64
+ECO_AUTOHSCROLL = 128
+ECO_NOHIDESEL = 256
+ECO_READONLY = 2048
+ECO_WANTRETURN = 4096
+ECO_SAVESEL = 32768
+ECO_SELECTIONBAR = 16777216
+ECO_VERTICAL = 4194304
+ECOOP_SET = 1
+ECOOP_OR = 2
+ECOOP_AND = 3
+ECOOP_XOR = 4
+WB_CLASSIFY = 3
+WB_MOVEWORDLEFT = 4
+WB_MOVEWORDRIGHT = 5
+WB_LEFTBREAK = 6
+WB_RIGHTBREAK = 7
+WB_MOVEWORDPREV = 4
+WB_MOVEWORDNEXT = 5
+WB_PREVBREAK = 6
+WB_NEXTBREAK = 7
+PC_FOLLOWING = 1
+PC_LEADING = 2
+PC_OVERFLOW = 3
+PC_DELIMITER = 4
+WBF_WORDWRAP = 16
+WBF_WORDBREAK = 32
+WBF_OVERFLOW = 64
+WBF_LEVEL1 = 128
+WBF_LEVEL2 = 256
+WBF_CUSTOM = 512
+CFM_BOLD = 1
+CFM_ITALIC = 2
+CFM_UNDERLINE = 4
+CFM_STRIKEOUT = 8
+CFM_PROTECTED = 16
+CFM_SIZE = -2147483648
+CFM_COLOR = 1073741824
+CFM_FACE = 536870912
+CFM_OFFSET = 268435456
+CFM_CHARSET = 134217728
+CFE_BOLD = 1
+CFE_ITALIC = 2
+CFE_UNDERLINE = 4
+CFE_STRIKEOUT = 8
+CFE_PROTECTED = 16
+CFE_AUTOCOLOR = 1073741824
+yHeightCharPtsMost = 1638
+SCF_SELECTION = 1
+SCF_WORD = 2
+SF_TEXT = 1
+SF_RTF = 2
+SF_RTFNOOBJS = 3
+SF_TEXTIZED = 4
+SFF_SELECTION = 32768
+SFF_PLAINRTF = 16384
+MAX_TAB_STOPS = 32
+lDefaultTab = 720
+PFM_STARTINDENT = 1
+PFM_RIGHTINDENT = 2
+PFM_OFFSET = 4
+PFM_ALIGNMENT = 8
+PFM_TABSTOPS = 16
+PFM_NUMBERING = 32
+PFM_OFFSETINDENT = -2147483648
+PFN_BULLET = 1
+PFA_LEFT = 1
+PFA_RIGHT = 2
+PFA_CENTER = 3
+WM_NOTIFY = 78
+SEL_EMPTY = 0
+SEL_TEXT = 1
+SEL_OBJECT = 2
+SEL_MULTICHAR = 4
+SEL_MULTIOBJECT = 8
+OLEOP_DOVERB = 1
+CF_RTF = "Rich Text Format"
+CF_RTFNOOBJS = "Rich Text Format Without Objects"
+CF_RETEXTOBJ = "RichEdit Text and Objects"
+
+# From wincon.h
+RIGHT_ALT_PRESSED = 1  # the right alt key is pressed.
+LEFT_ALT_PRESSED = 2  # the left alt key is pressed.
+RIGHT_CTRL_PRESSED = 4  # the right ctrl key is pressed.
+LEFT_CTRL_PRESSED = 8  # the left ctrl key is pressed.
+SHIFT_PRESSED = 16  # the shift key is pressed.
+NUMLOCK_ON = 32  # the numlock light is on.
+SCROLLLOCK_ON = 64  # the scrolllock light is on.
+CAPSLOCK_ON = 128  # the capslock light is on.
+ENHANCED_KEY = 256  # the key is enhanced.
+NLS_DBCSCHAR = 65536  # DBCS for JPN: SBCS/DBCS mode.
+NLS_ALPHANUMERIC = 0  # DBCS for JPN: Alphanumeric mode.
+NLS_KATAKANA = 131072  # DBCS for JPN: Katakana mode.
+NLS_HIRAGANA = 262144  # DBCS for JPN: Hiragana mode.
+NLS_ROMAN = 4194304  # DBCS for JPN: Roman/Noroman mode.
+NLS_IME_CONVERSION = 8388608  # DBCS for JPN: IME conversion.
+NLS_IME_DISABLE = 536870912  # DBCS for JPN: IME enable/disable.
+
+FROM_LEFT_1ST_BUTTON_PRESSED = 1
+RIGHTMOST_BUTTON_PRESSED = 2
+FROM_LEFT_2ND_BUTTON_PRESSED = 4
+FROM_LEFT_3RD_BUTTON_PRESSED = 8
+FROM_LEFT_4TH_BUTTON_PRESSED = 16
+
+CTRL_C_EVENT = 0
+CTRL_BREAK_EVENT = 1
+CTRL_CLOSE_EVENT = 2
+CTRL_LOGOFF_EVENT = 5
+CTRL_SHUTDOWN_EVENT = 6
+
+MOUSE_MOVED = 1
+DOUBLE_CLICK = 2
+MOUSE_WHEELED = 4
+
+# property sheet window messages from prsht.h
+PSM_SETCURSEL = WM_USER + 101
+PSM_REMOVEPAGE = WM_USER + 102
+PSM_ADDPAGE = WM_USER + 103
+PSM_CHANGED = WM_USER + 104
+PSM_RESTARTWINDOWS = WM_USER + 105
+PSM_REBOOTSYSTEM = WM_USER + 106
+PSM_CANCELTOCLOSE = WM_USER + 107
+PSM_QUERYSIBLINGS = WM_USER + 108
+PSM_UNCHANGED = WM_USER + 109
+PSM_APPLY = WM_USER + 110
+PSM_SETTITLEA = WM_USER + 111
+PSM_SETTITLEW = WM_USER + 120
+PSM_SETWIZBUTTONS = WM_USER + 112
+PSM_PRESSBUTTON = WM_USER + 113
+PSM_SETCURSELID = WM_USER + 114
+PSM_SETFINISHTEXTA = WM_USER + 115
+PSM_SETFINISHTEXTW = WM_USER + 121
+PSM_GETTABCONTROL = WM_USER + 116
+PSM_ISDIALOGMESSAGE = WM_USER + 117
+PSM_GETCURRENTPAGEHWND = WM_USER + 118
+PSM_INSERTPAGE = WM_USER + 119
+PSM_SETHEADERTITLEA = WM_USER + 125
+PSM_SETHEADERTITLEW = WM_USER + 126
+PSM_SETHEADERSUBTITLEA = WM_USER + 127
+PSM_SETHEADERSUBTITLEW = WM_USER + 128
+PSM_HWNDTOINDEX = WM_USER + 129
+PSM_INDEXTOHWND = WM_USER + 130
+PSM_PAGETOINDEX = WM_USER + 131
+PSM_INDEXTOPAGE = WM_USER + 132
+PSM_IDTOINDEX = WM_USER + 133
+PSM_INDEXTOID = WM_USER + 134
+PSM_GETRESULT = WM_USER + 135
+PSM_RECALCPAGESIZES = WM_USER + 136
+
+# GetUserNameEx/GetComputerNameEx
+NameUnknown = 0
+NameFullyQualifiedDN = 1
+NameSamCompatible = 2
+NameDisplay = 3
+NameUniqueId = 6
+NameCanonical = 7
+NameUserPrincipal = 8
+NameCanonicalEx = 9
+NameServicePrincipal = 10
+NameDnsDomain = 12
+
+ComputerNameNetBIOS = 0
+ComputerNameDnsHostname = 1
+ComputerNameDnsDomain = 2
+ComputerNameDnsFullyQualified = 3
+ComputerNamePhysicalNetBIOS = 4
+ComputerNamePhysicalDnsHostname = 5
+ComputerNamePhysicalDnsDomain = 6
+ComputerNamePhysicalDnsFullyQualified = 7
+
+LWA_COLORKEY = 0x00000001
+LWA_ALPHA = 0x00000002
+ULW_COLORKEY = 0x00000001
+ULW_ALPHA = 0x00000002
+ULW_OPAQUE = 0x00000004
+
+# WinDef.h
+TRUE = 1
+FALSE = 0
+MAX_PATH = 260
+# WinGDI.h
+AC_SRC_OVER = 0
+AC_SRC_ALPHA = 1
+GRADIENT_FILL_RECT_H = 0
+GRADIENT_FILL_RECT_V = 1
+GRADIENT_FILL_TRIANGLE = 2
+GRADIENT_FILL_OP_FLAG = 255
+
+## flags used with Get/SetSystemFileCacheSize
+MM_WORKING_SET_MAX_HARD_ENABLE = 1
+MM_WORKING_SET_MAX_HARD_DISABLE = 2
+MM_WORKING_SET_MIN_HARD_ENABLE = 4
+MM_WORKING_SET_MIN_HARD_DISABLE = 8
+
+## Flags for GetFinalPathNameByHandle
+VOLUME_NAME_DOS = 0
+VOLUME_NAME_GUID = 1
+VOLUME_NAME_NT = 2
+VOLUME_NAME_NONE = 4
+FILE_NAME_NORMALIZED = 0
+FILE_NAME_OPENED = 8
+
+DEVICE_NOTIFY_WINDOW_HANDLE = 0x00000000
+DEVICE_NOTIFY_SERVICE_HANDLE = 0x00000001
+
+# From Dbt.h
+# Generated by h2py from Dbt.h
+WM_DEVICECHANGE = 0x0219
+BSF_QUERY = 0x00000001
+BSF_IGNORECURRENTTASK = 0x00000002
+BSF_FLUSHDISK = 0x00000004
+BSF_NOHANG = 0x00000008
+BSF_POSTMESSAGE = 0x00000010
+BSF_FORCEIFHUNG = 0x00000020
+BSF_NOTIMEOUTIFNOTHUNG = 0x00000040
+BSF_MSGSRV32ISOK = -2147483648
+BSF_MSGSRV32ISOK_BIT = 31
+BSM_ALLCOMPONENTS = 0x00000000
+BSM_VXDS = 0x00000001
+BSM_NETDRIVER = 0x00000002
+BSM_INSTALLABLEDRIVERS = 0x00000004
+BSM_APPLICATIONS = 0x00000008
+DBT_APPYBEGIN = 0x0000
+DBT_APPYEND = 0x0001
+DBT_DEVNODES_CHANGED = 0x0007
+DBT_QUERYCHANGECONFIG = 0x0017
+DBT_CONFIGCHANGED = 0x0018
+DBT_CONFIGCHANGECANCELED = 0x0019
+DBT_MONITORCHANGE = 0x001B
+DBT_SHELLLOGGEDON = 0x0020
+DBT_CONFIGMGAPI32 = 0x0022
+DBT_VXDINITCOMPLETE = 0x0023
+DBT_VOLLOCKQUERYLOCK = 0x8041
+DBT_VOLLOCKLOCKTAKEN = 0x8042
+DBT_VOLLOCKLOCKFAILED = 0x8043
+DBT_VOLLOCKQUERYUNLOCK = 0x8044
+DBT_VOLLOCKLOCKRELEASED = 0x8045
+DBT_VOLLOCKUNLOCKFAILED = 0x8046
+LOCKP_ALLOW_WRITES = 0x01
+LOCKP_FAIL_WRITES = 0x00
+LOCKP_FAIL_MEM_MAPPING = 0x02
+LOCKP_ALLOW_MEM_MAPPING = 0x00
+LOCKP_USER_MASK = 0x03
+LOCKP_LOCK_FOR_FORMAT = 0x04
+LOCKF_LOGICAL_LOCK = 0x00
+LOCKF_PHYSICAL_LOCK = 0x01
+DBT_NO_DISK_SPACE = 0x0047
+DBT_LOW_DISK_SPACE = 0x0048
+DBT_CONFIGMGPRIVATE = 0x7FFF
+DBT_DEVICEARRIVAL = 0x8000
+DBT_DEVICEQUERYREMOVE = 0x8001
+DBT_DEVICEQUERYREMOVEFAILED = 0x8002
+DBT_DEVICEREMOVEPENDING = 0x8003
+DBT_DEVICEREMOVECOMPLETE = 0x8004
+DBT_DEVICETYPESPECIFIC = 0x8005
+DBT_CUSTOMEVENT = 0x8006
+DBT_DEVTYP_OEM = 0x00000000
+DBT_DEVTYP_DEVNODE = 0x00000001
+DBT_DEVTYP_VOLUME = 0x00000002
+DBT_DEVTYP_PORT = 0x00000003
+DBT_DEVTYP_NET = 0x00000004
+DBT_DEVTYP_DEVICEINTERFACE = 0x00000005
+DBT_DEVTYP_HANDLE = 0x00000006
+DBTF_MEDIA = 0x0001
+DBTF_NET = 0x0002
+DBTF_RESOURCE = 0x00000001
+DBTF_XPORT = 0x00000002
+DBTF_SLOWNET = 0x00000004
+DBT_VPOWERDAPI = 0x8100
+DBT_USERDEFINED = 0xFFFF
diff --git a/lib/win32/lib/win32cryptcon.py b/lib/win32/lib/win32cryptcon.py
new file mode 100644
index 00000000..8d71996a
--- /dev/null
+++ b/lib/win32/lib/win32cryptcon.py
@@ -0,0 +1,1925 @@
+# Generated by h2py from WinCrypt.h
+def GET_ALG_CLASS(x):
+    return x & (7 << 13)
+
+
+def GET_ALG_TYPE(x):
+    return x & (15 << 9)
+
+
+def GET_ALG_SID(x):
+    return x & (511)
+
+
+ALG_CLASS_ANY = 0
+ALG_CLASS_SIGNATURE = 1 << 13
+ALG_CLASS_MSG_ENCRYPT = 2 << 13
+ALG_CLASS_DATA_ENCRYPT = 3 << 13
+ALG_CLASS_HASH = 4 << 13
+ALG_CLASS_KEY_EXCHANGE = 5 << 13
+ALG_CLASS_ALL = 7 << 13
+ALG_TYPE_ANY = 0
+ALG_TYPE_DSS = 1 << 9
+ALG_TYPE_RSA = 2 << 9
+ALG_TYPE_BLOCK = 3 << 9
+ALG_TYPE_STREAM = 4 << 9
+ALG_TYPE_DH = 5 << 9
+ALG_TYPE_SECURECHANNEL = 6 << 9
+ALG_SID_ANY = 0
+ALG_SID_RSA_ANY = 0
+ALG_SID_RSA_PKCS = 1
+ALG_SID_RSA_MSATWORK = 2
+ALG_SID_RSA_ENTRUST = 3
+ALG_SID_RSA_PGP = 4
+ALG_SID_DSS_ANY = 0
+ALG_SID_DSS_PKCS = 1
+ALG_SID_DSS_DMS = 2
+ALG_SID_DES = 1
+ALG_SID_3DES = 3
+ALG_SID_DESX = 4
+ALG_SID_IDEA = 5
+ALG_SID_CAST = 6
+ALG_SID_SAFERSK64 = 7
+ALG_SID_SAFERSK128 = 8
+ALG_SID_3DES_112 = 9
+ALG_SID_CYLINK_MEK = 12
+ALG_SID_RC5 = 13
+ALG_SID_AES_128 = 14
+ALG_SID_AES_192 = 15
+ALG_SID_AES_256 = 16
+ALG_SID_AES = 17
+ALG_SID_SKIPJACK = 10
+ALG_SID_TEK = 11
+CRYPT_MODE_CBCI = 6
+CRYPT_MODE_CFBP = 7
+CRYPT_MODE_OFBP = 8
+CRYPT_MODE_CBCOFM = 9
+CRYPT_MODE_CBCOFMI = 10
+ALG_SID_RC2 = 2
+ALG_SID_RC4 = 1
+ALG_SID_SEAL = 2
+ALG_SID_DH_SANDF = 1
+ALG_SID_DH_EPHEM = 2
+ALG_SID_AGREED_KEY_ANY = 3
+ALG_SID_KEA = 4
+ALG_SID_MD2 = 1
+ALG_SID_MD4 = 2
+ALG_SID_MD5 = 3
+ALG_SID_SHA = 4
+ALG_SID_SHA1 = 4
+ALG_SID_MAC = 5
+ALG_SID_RIPEMD = 6
+ALG_SID_RIPEMD160 = 7
+ALG_SID_SSL3SHAMD5 = 8
+ALG_SID_HMAC = 9
+ALG_SID_TLS1PRF = 10
+ALG_SID_HASH_REPLACE_OWF = 11
+ALG_SID_SHA_256 = 12
+ALG_SID_SHA_384 = 13
+ALG_SID_SHA_512 = 14
+ALG_SID_SSL3_MASTER = 1
+ALG_SID_SCHANNEL_MASTER_HASH = 2
+ALG_SID_SCHANNEL_MAC_KEY = 3
+ALG_SID_PCT1_MASTER = 4
+ALG_SID_SSL2_MASTER = 5
+ALG_SID_TLS1_MASTER = 6
+ALG_SID_SCHANNEL_ENC_KEY = 7
+ALG_SID_EXAMPLE = 80
+CALG_MD2 = ALG_CLASS_HASH | ALG_TYPE_ANY | ALG_SID_MD2
+CALG_MD4 = ALG_CLASS_HASH | ALG_TYPE_ANY | ALG_SID_MD4
+CALG_MD5 = ALG_CLASS_HASH | ALG_TYPE_ANY | ALG_SID_MD5
+CALG_SHA = ALG_CLASS_HASH | ALG_TYPE_ANY | ALG_SID_SHA
+CALG_SHA1 = ALG_CLASS_HASH | ALG_TYPE_ANY | ALG_SID_SHA1
+CALG_MAC = ALG_CLASS_HASH | ALG_TYPE_ANY | ALG_SID_MAC
+CALG_RSA_SIGN = ALG_CLASS_SIGNATURE | ALG_TYPE_RSA | ALG_SID_RSA_ANY
+CALG_DSS_SIGN = ALG_CLASS_SIGNATURE | ALG_TYPE_DSS | ALG_SID_DSS_ANY
+CALG_NO_SIGN = ALG_CLASS_SIGNATURE | ALG_TYPE_ANY | ALG_SID_ANY
+CALG_RSA_KEYX = ALG_CLASS_KEY_EXCHANGE | ALG_TYPE_RSA | ALG_SID_RSA_ANY
+CALG_DES = ALG_CLASS_DATA_ENCRYPT | ALG_TYPE_BLOCK | ALG_SID_DES
+CALG_3DES_112 = ALG_CLASS_DATA_ENCRYPT | ALG_TYPE_BLOCK | ALG_SID_3DES_112
+CALG_3DES = ALG_CLASS_DATA_ENCRYPT | ALG_TYPE_BLOCK | ALG_SID_3DES
+CALG_DESX = ALG_CLASS_DATA_ENCRYPT | ALG_TYPE_BLOCK | ALG_SID_DESX
+CALG_RC2 = ALG_CLASS_DATA_ENCRYPT | ALG_TYPE_BLOCK | ALG_SID_RC2
+CALG_RC4 = ALG_CLASS_DATA_ENCRYPT | ALG_TYPE_STREAM | ALG_SID_RC4
+CALG_SEAL = ALG_CLASS_DATA_ENCRYPT | ALG_TYPE_STREAM | ALG_SID_SEAL
+CALG_DH_SF = ALG_CLASS_KEY_EXCHANGE | ALG_TYPE_DH | ALG_SID_DH_SANDF
+CALG_DH_EPHEM = ALG_CLASS_KEY_EXCHANGE | ALG_TYPE_DH | ALG_SID_DH_EPHEM
+CALG_AGREEDKEY_ANY = ALG_CLASS_KEY_EXCHANGE | ALG_TYPE_DH | ALG_SID_AGREED_KEY_ANY
+CALG_KEA_KEYX = ALG_CLASS_KEY_EXCHANGE | ALG_TYPE_DH | ALG_SID_KEA
+CALG_HUGHES_MD5 = ALG_CLASS_KEY_EXCHANGE | ALG_TYPE_ANY | ALG_SID_MD5
+CALG_SKIPJACK = ALG_CLASS_DATA_ENCRYPT | ALG_TYPE_BLOCK | ALG_SID_SKIPJACK
+CALG_TEK = ALG_CLASS_DATA_ENCRYPT | ALG_TYPE_BLOCK | ALG_SID_TEK
+CALG_CYLINK_MEK = ALG_CLASS_DATA_ENCRYPT | ALG_TYPE_BLOCK | ALG_SID_CYLINK_MEK
+CALG_SSL3_SHAMD5 = ALG_CLASS_HASH | ALG_TYPE_ANY | ALG_SID_SSL3SHAMD5
+CALG_SSL3_MASTER = ALG_CLASS_MSG_ENCRYPT | ALG_TYPE_SECURECHANNEL | ALG_SID_SSL3_MASTER
+CALG_SCHANNEL_MASTER_HASH = (
+    ALG_CLASS_MSG_ENCRYPT | ALG_TYPE_SECURECHANNEL | ALG_SID_SCHANNEL_MASTER_HASH
+)
+CALG_SCHANNEL_MAC_KEY = (
+    ALG_CLASS_MSG_ENCRYPT | ALG_TYPE_SECURECHANNEL | ALG_SID_SCHANNEL_MAC_KEY
+)
+CALG_SCHANNEL_ENC_KEY = (
+    ALG_CLASS_MSG_ENCRYPT | ALG_TYPE_SECURECHANNEL | ALG_SID_SCHANNEL_ENC_KEY
+)
+CALG_PCT1_MASTER = ALG_CLASS_MSG_ENCRYPT | ALG_TYPE_SECURECHANNEL | ALG_SID_PCT1_MASTER
+CALG_SSL2_MASTER = ALG_CLASS_MSG_ENCRYPT | ALG_TYPE_SECURECHANNEL | ALG_SID_SSL2_MASTER
+CALG_TLS1_MASTER = ALG_CLASS_MSG_ENCRYPT | ALG_TYPE_SECURECHANNEL | ALG_SID_TLS1_MASTER
+CALG_RC5 = ALG_CLASS_DATA_ENCRYPT | ALG_TYPE_BLOCK | ALG_SID_RC5
+CALG_HMAC = ALG_CLASS_HASH | ALG_TYPE_ANY | ALG_SID_HMAC
+CALG_TLS1PRF = ALG_CLASS_HASH | ALG_TYPE_ANY | ALG_SID_TLS1PRF
+CALG_HASH_REPLACE_OWF = ALG_CLASS_HASH | ALG_TYPE_ANY | ALG_SID_HASH_REPLACE_OWF
+CALG_AES_128 = ALG_CLASS_DATA_ENCRYPT | ALG_TYPE_BLOCK | ALG_SID_AES_128
+CALG_AES_192 = ALG_CLASS_DATA_ENCRYPT | ALG_TYPE_BLOCK | ALG_SID_AES_192
+CALG_AES_256 = ALG_CLASS_DATA_ENCRYPT | ALG_TYPE_BLOCK | ALG_SID_AES_256
+CALG_AES = ALG_CLASS_DATA_ENCRYPT | ALG_TYPE_BLOCK | ALG_SID_AES
+CALG_SHA_256 = ALG_CLASS_HASH | ALG_TYPE_ANY | ALG_SID_SHA_256
+CALG_SHA_384 = ALG_CLASS_HASH | ALG_TYPE_ANY | ALG_SID_SHA_384
+CALG_SHA_512 = ALG_CLASS_HASH | ALG_TYPE_ANY | ALG_SID_SHA_512
+CRYPT_VERIFYCONTEXT = -268435456
+CRYPT_NEWKEYSET = 0x00000008
+CRYPT_DELETEKEYSET = 0x00000010
+CRYPT_MACHINE_KEYSET = 0x00000020
+CRYPT_SILENT = 0x00000040
+CRYPT_EXPORTABLE = 0x00000001
+CRYPT_USER_PROTECTED = 0x00000002
+CRYPT_CREATE_SALT = 0x00000004
+CRYPT_UPDATE_KEY = 0x00000008
+CRYPT_NO_SALT = 0x00000010
+CRYPT_PREGEN = 0x00000040
+CRYPT_RECIPIENT = 0x00000010
+CRYPT_INITIATOR = 0x00000040
+CRYPT_ONLINE = 0x00000080
+CRYPT_SF = 0x00000100
+CRYPT_CREATE_IV = 0x00000200
+CRYPT_KEK = 0x00000400
+CRYPT_DATA_KEY = 0x00000800
+CRYPT_VOLATILE = 0x00001000
+CRYPT_SGCKEY = 0x00002000
+CRYPT_ARCHIVABLE = 0x00004000
+RSA1024BIT_KEY = 0x04000000
+CRYPT_SERVER = 0x00000400
+KEY_LENGTH_MASK = -65536
+CRYPT_Y_ONLY = 0x00000001
+CRYPT_SSL2_FALLBACK = 0x00000002
+CRYPT_DESTROYKEY = 0x00000004
+CRYPT_OAEP = 0x00000040
+CRYPT_BLOB_VER3 = 0x00000080
+CRYPT_IPSEC_HMAC_KEY = 0x00000100
+CRYPT_DECRYPT_RSA_NO_PADDING_CHECK = 0x00000020
+CRYPT_SECRETDIGEST = 0x00000001
+CRYPT_OWF_REPL_LM_HASH = 0x00000001
+CRYPT_LITTLE_ENDIAN = 0x00000001
+CRYPT_NOHASHOID = 0x00000001
+CRYPT_TYPE2_FORMAT = 0x00000002
+CRYPT_X931_FORMAT = 0x00000004
+CRYPT_MACHINE_DEFAULT = 0x00000001
+CRYPT_USER_DEFAULT = 0x00000002
+CRYPT_DELETE_DEFAULT = 0x00000004
+SIMPLEBLOB = 0x1
+PUBLICKEYBLOB = 0x6
+PRIVATEKEYBLOB = 0x7
+PLAINTEXTKEYBLOB = 0x8
+OPAQUEKEYBLOB = 0x9
+PUBLICKEYBLOBEX = 0xA
+SYMMETRICWRAPKEYBLOB = 0xB
+AT_KEYEXCHANGE = 1
+AT_SIGNATURE = 2
+CRYPT_USERDATA = 1
+KP_IV = 1
+KP_SALT = 2
+KP_PADDING = 3
+KP_MODE = 4
+KP_MODE_BITS = 5
+KP_PERMISSIONS = 6
+KP_ALGID = 7
+KP_BLOCKLEN = 8
+KP_KEYLEN = 9
+KP_SALT_EX = 10
+KP_P = 11
+KP_G = 12
+KP_Q = 13
+KP_X = 14
+KP_Y = 15
+KP_RA = 16
+KP_RB = 17
+KP_INFO = 18
+KP_EFFECTIVE_KEYLEN = 19
+KP_SCHANNEL_ALG = 20
+KP_CLIENT_RANDOM = 21
+KP_SERVER_RANDOM = 22
+KP_RP = 23
+KP_PRECOMP_MD5 = 24
+KP_PRECOMP_SHA = 25
+KP_CERTIFICATE = 26
+KP_CLEAR_KEY = 27
+KP_PUB_EX_LEN = 28
+KP_PUB_EX_VAL = 29
+KP_KEYVAL = 30
+KP_ADMIN_PIN = 31
+KP_KEYEXCHANGE_PIN = 32
+KP_SIGNATURE_PIN = 33
+KP_PREHASH = 34
+KP_ROUNDS = 35
+KP_OAEP_PARAMS = 36
+KP_CMS_KEY_INFO = 37
+KP_CMS_DH_KEY_INFO = 38
+KP_PUB_PARAMS = 39
+KP_VERIFY_PARAMS = 40
+KP_HIGHEST_VERSION = 41
+KP_GET_USE_COUNT = 42
+PKCS5_PADDING = 1
+RANDOM_PADDING = 2
+ZERO_PADDING = 3
+CRYPT_MODE_CBC = 1
+CRYPT_MODE_ECB = 2
+CRYPT_MODE_OFB = 3
+CRYPT_MODE_CFB = 4
+CRYPT_MODE_CTS = 5
+CRYPT_ENCRYPT = 0x0001
+CRYPT_DECRYPT = 0x0002
+CRYPT_EXPORT = 0x0004
+CRYPT_READ = 0x0008
+CRYPT_WRITE = 0x0010
+CRYPT_MAC = 0x0020
+CRYPT_EXPORT_KEY = 0x0040
+CRYPT_IMPORT_KEY = 0x0080
+CRYPT_ARCHIVE = 0x0100
+HP_ALGID = 0x0001
+HP_HASHVAL = 0x0002
+HP_HASHSIZE = 0x0004
+HP_HMAC_INFO = 0x0005
+HP_TLS1PRF_LABEL = 0x0006
+HP_TLS1PRF_SEED = 0x0007
+
+CRYPT_FAILED = 0
+CRYPT_SUCCEED = 1
+
+
+def RCRYPT_SUCCEEDED(rt):
+    return (rt) == CRYPT_SUCCEED
+
+
+def RCRYPT_FAILED(rt):
+    return (rt) == CRYPT_FAILED
+
+
+PP_ENUMALGS = 1
+PP_ENUMCONTAINERS = 2
+PP_IMPTYPE = 3
+PP_NAME = 4
+PP_VERSION = 5
+PP_CONTAINER = 6
+PP_CHANGE_PASSWORD = 7
+PP_KEYSET_SEC_DESCR = 8
+PP_CERTCHAIN = 9
+PP_KEY_TYPE_SUBTYPE = 10
+PP_PROVTYPE = 16
+PP_KEYSTORAGE = 17
+PP_APPLI_CERT = 18
+PP_SYM_KEYSIZE = 19
+PP_SESSION_KEYSIZE = 20
+PP_UI_PROMPT = 21
+PP_ENUMALGS_EX = 22
+PP_ENUMMANDROOTS = 25
+PP_ENUMELECTROOTS = 26
+PP_KEYSET_TYPE = 27
+PP_ADMIN_PIN = 31
+PP_KEYEXCHANGE_PIN = 32
+PP_SIGNATURE_PIN = 33
+PP_SIG_KEYSIZE_INC = 34
+PP_KEYX_KEYSIZE_INC = 35
+PP_UNIQUE_CONTAINER = 36
+PP_SGC_INFO = 37
+PP_USE_HARDWARE_RNG = 38
+PP_KEYSPEC = 39
+PP_ENUMEX_SIGNING_PROT = 40
+PP_CRYPT_COUNT_KEY_USE = 41
+CRYPT_FIRST = 1
+CRYPT_NEXT = 2
+CRYPT_SGC_ENUM = 4
+CRYPT_IMPL_HARDWARE = 1
+CRYPT_IMPL_SOFTWARE = 2
+CRYPT_IMPL_MIXED = 3
+CRYPT_IMPL_UNKNOWN = 4
+CRYPT_IMPL_REMOVABLE = 8
+CRYPT_SEC_DESCR = 0x00000001
+CRYPT_PSTORE = 0x00000002
+CRYPT_UI_PROMPT = 0x00000004
+CRYPT_FLAG_PCT1 = 0x0001
+CRYPT_FLAG_SSL2 = 0x0002
+CRYPT_FLAG_SSL3 = 0x0004
+CRYPT_FLAG_TLS1 = 0x0008
+CRYPT_FLAG_IPSEC = 0x0010
+CRYPT_FLAG_SIGNING = 0x0020
+CRYPT_SGC = 0x0001
+CRYPT_FASTSGC = 0x0002
+PP_CLIENT_HWND = 1
+PP_CONTEXT_INFO = 11
+PP_KEYEXCHANGE_KEYSIZE = 12
+PP_SIGNATURE_KEYSIZE = 13
+PP_KEYEXCHANGE_ALG = 14
+PP_SIGNATURE_ALG = 15
+PP_DELETEKEY = 24
+PROV_RSA_FULL = 1
+PROV_RSA_SIG = 2
+PROV_DSS = 3
+PROV_FORTEZZA = 4
+PROV_MS_EXCHANGE = 5
+PROV_SSL = 6
+PROV_RSA_SCHANNEL = 12
+PROV_DSS_DH = 13
+PROV_EC_ECDSA_SIG = 14
+PROV_EC_ECNRA_SIG = 15
+PROV_EC_ECDSA_FULL = 16
+PROV_EC_ECNRA_FULL = 17
+PROV_DH_SCHANNEL = 18
+PROV_SPYRUS_LYNKS = 20
+PROV_RNG = 21
+PROV_INTEL_SEC = 22
+PROV_REPLACE_OWF = 23
+PROV_RSA_AES = 24
+MS_DEF_PROV_A = "Microsoft Base Cryptographic Provider v1.0"
+MS_DEF_PROV = MS_DEF_PROV_A
+MS_ENHANCED_PROV_A = "Microsoft Enhanced Cryptographic Provider v1.0"
+MS_ENHANCED_PROV = MS_ENHANCED_PROV_A
+MS_STRONG_PROV_A = "Microsoft Strong Cryptographic Provider"
+MS_STRONG_PROV = MS_STRONG_PROV_A
+MS_DEF_RSA_SIG_PROV_A = "Microsoft RSA Signature Cryptographic Provider"
+MS_DEF_RSA_SIG_PROV = MS_DEF_RSA_SIG_PROV_A
+MS_DEF_RSA_SCHANNEL_PROV_A = "Microsoft RSA SChannel Cryptographic Provider"
+MS_DEF_RSA_SCHANNEL_PROV = MS_DEF_RSA_SCHANNEL_PROV_A
+MS_DEF_DSS_PROV_A = "Microsoft Base DSS Cryptographic Provider"
+MS_DEF_DSS_PROV = MS_DEF_DSS_PROV_A
+MS_DEF_DSS_DH_PROV_A = "Microsoft Base DSS and Diffie-Hellman Cryptographic Provider"
+MS_DEF_DSS_DH_PROV = MS_DEF_DSS_DH_PROV_A
+MS_ENH_DSS_DH_PROV_A = (
+    "Microsoft Enhanced DSS and Diffie-Hellman Cryptographic Provider"
+)
+MS_ENH_DSS_DH_PROV = MS_ENH_DSS_DH_PROV_A
+MS_DEF_DH_SCHANNEL_PROV_A = "Microsoft DH SChannel Cryptographic Provider"
+MS_DEF_DH_SCHANNEL_PROV = MS_DEF_DH_SCHANNEL_PROV_A
+MS_SCARD_PROV_A = "Microsoft Base Smart Card Crypto Provider"
+MS_SCARD_PROV = MS_SCARD_PROV_A
+MS_ENH_RSA_AES_PROV_A = "Microsoft Enhanced RSA and AES Cryptographic Provider"
+MS_ENH_RSA_AES_PROV = MS_ENH_RSA_AES_PROV_A
+MAXUIDLEN = 64
+EXPO_OFFLOAD_REG_VALUE = "ExpoOffload"
+EXPO_OFFLOAD_FUNC_NAME = "OffloadModExpo"
+szKEY_CRYPTOAPI_PRIVATE_KEY_OPTIONS = "Software\\Policies\\Microsoft\\Cryptography"
+szFORCE_KEY_PROTECTION = "ForceKeyProtection"
+dwFORCE_KEY_PROTECTION_DISABLED = 0x0
+dwFORCE_KEY_PROTECTION_USER_SELECT = 0x1
+dwFORCE_KEY_PROTECTION_HIGH = 0x2
+szKEY_CACHE_ENABLED = "CachePrivateKeys"
+szKEY_CACHE_SECONDS = "PrivateKeyLifetimeSeconds"
+CUR_BLOB_VERSION = 2
+SCHANNEL_MAC_KEY = 0x00000000
+SCHANNEL_ENC_KEY = 0x00000001
+INTERNATIONAL_USAGE = 0x00000001
+szOID_RSA = "1.2.840.113549"
+szOID_PKCS = "1.2.840.113549.1"
+szOID_RSA_HASH = "1.2.840.113549.2"
+szOID_RSA_ENCRYPT = "1.2.840.113549.3"
+szOID_PKCS_1 = "1.2.840.113549.1.1"
+szOID_PKCS_2 = "1.2.840.113549.1.2"
+szOID_PKCS_3 = "1.2.840.113549.1.3"
+szOID_PKCS_4 = "1.2.840.113549.1.4"
+szOID_PKCS_5 = "1.2.840.113549.1.5"
+szOID_PKCS_6 = "1.2.840.113549.1.6"
+szOID_PKCS_7 = "1.2.840.113549.1.7"
+szOID_PKCS_8 = "1.2.840.113549.1.8"
+szOID_PKCS_9 = "1.2.840.113549.1.9"
+szOID_PKCS_10 = "1.2.840.113549.1.10"
+szOID_PKCS_12 = "1.2.840.113549.1.12"
+szOID_RSA_RSA = "1.2.840.113549.1.1.1"
+szOID_RSA_MD2RSA = "1.2.840.113549.1.1.2"
+szOID_RSA_MD4RSA = "1.2.840.113549.1.1.3"
+szOID_RSA_MD5RSA = "1.2.840.113549.1.1.4"
+szOID_RSA_SHA1RSA = "1.2.840.113549.1.1.5"
+szOID_RSA_SETOAEP_RSA = "1.2.840.113549.1.1.6"
+szOID_RSA_DH = "1.2.840.113549.1.3.1"
+szOID_RSA_data = "1.2.840.113549.1.7.1"
+szOID_RSA_signedData = "1.2.840.113549.1.7.2"
+szOID_RSA_envelopedData = "1.2.840.113549.1.7.3"
+szOID_RSA_signEnvData = "1.2.840.113549.1.7.4"
+szOID_RSA_digestedData = "1.2.840.113549.1.7.5"
+szOID_RSA_hashedData = "1.2.840.113549.1.7.5"
+szOID_RSA_encryptedData = "1.2.840.113549.1.7.6"
+szOID_RSA_emailAddr = "1.2.840.113549.1.9.1"
+szOID_RSA_unstructName = "1.2.840.113549.1.9.2"
+szOID_RSA_contentType = "1.2.840.113549.1.9.3"
+szOID_RSA_messageDigest = "1.2.840.113549.1.9.4"
+szOID_RSA_signingTime = "1.2.840.113549.1.9.5"
+szOID_RSA_counterSign = "1.2.840.113549.1.9.6"
+szOID_RSA_challengePwd = "1.2.840.113549.1.9.7"
+szOID_RSA_unstructAddr = "1.2.840.113549.1.9.8"
+szOID_RSA_extCertAttrs = "1.2.840.113549.1.9.9"
+szOID_RSA_certExtensions = "1.2.840.113549.1.9.14"
+szOID_RSA_SMIMECapabilities = "1.2.840.113549.1.9.15"
+szOID_RSA_preferSignedData = "1.2.840.113549.1.9.15.1"
+szOID_RSA_SMIMEalg = "1.2.840.113549.1.9.16.3"
+szOID_RSA_SMIMEalgESDH = "1.2.840.113549.1.9.16.3.5"
+szOID_RSA_SMIMEalgCMS3DESwrap = "1.2.840.113549.1.9.16.3.6"
+szOID_RSA_SMIMEalgCMSRC2wrap = "1.2.840.113549.1.9.16.3.7"
+szOID_RSA_MD2 = "1.2.840.113549.2.2"
+szOID_RSA_MD4 = "1.2.840.113549.2.4"
+szOID_RSA_MD5 = "1.2.840.113549.2.5"
+szOID_RSA_RC2CBC = "1.2.840.113549.3.2"
+szOID_RSA_RC4 = "1.2.840.113549.3.4"
+szOID_RSA_DES_EDE3_CBC = "1.2.840.113549.3.7"
+szOID_RSA_RC5_CBCPad = "1.2.840.113549.3.9"
+szOID_ANSI_X942 = "1.2.840.10046"
+szOID_ANSI_X942_DH = "1.2.840.10046.2.1"
+szOID_X957 = "1.2.840.10040"
+szOID_X957_DSA = "1.2.840.10040.4.1"
+szOID_X957_SHA1DSA = "1.2.840.10040.4.3"
+szOID_DS = "2.5"
+szOID_DSALG = "2.5.8"
+szOID_DSALG_CRPT = "2.5.8.1"
+szOID_DSALG_HASH = "2.5.8.2"
+szOID_DSALG_SIGN = "2.5.8.3"
+szOID_DSALG_RSA = "2.5.8.1.1"
+szOID_OIW = "1.3.14"
+szOID_OIWSEC = "1.3.14.3.2"
+szOID_OIWSEC_md4RSA = "1.3.14.3.2.2"
+szOID_OIWSEC_md5RSA = "1.3.14.3.2.3"
+szOID_OIWSEC_md4RSA2 = "1.3.14.3.2.4"
+szOID_OIWSEC_desECB = "1.3.14.3.2.6"
+szOID_OIWSEC_desCBC = "1.3.14.3.2.7"
+szOID_OIWSEC_desOFB = "1.3.14.3.2.8"
+szOID_OIWSEC_desCFB = "1.3.14.3.2.9"
+szOID_OIWSEC_desMAC = "1.3.14.3.2.10"
+szOID_OIWSEC_rsaSign = "1.3.14.3.2.11"
+szOID_OIWSEC_dsa = "1.3.14.3.2.12"
+szOID_OIWSEC_shaDSA = "1.3.14.3.2.13"
+szOID_OIWSEC_mdc2RSA = "1.3.14.3.2.14"
+szOID_OIWSEC_shaRSA = "1.3.14.3.2.15"
+szOID_OIWSEC_dhCommMod = "1.3.14.3.2.16"
+szOID_OIWSEC_desEDE = "1.3.14.3.2.17"
+szOID_OIWSEC_sha = "1.3.14.3.2.18"
+szOID_OIWSEC_mdc2 = "1.3.14.3.2.19"
+szOID_OIWSEC_dsaComm = "1.3.14.3.2.20"
+szOID_OIWSEC_dsaCommSHA = "1.3.14.3.2.21"
+szOID_OIWSEC_rsaXchg = "1.3.14.3.2.22"
+szOID_OIWSEC_keyHashSeal = "1.3.14.3.2.23"
+szOID_OIWSEC_md2RSASign = "1.3.14.3.2.24"
+szOID_OIWSEC_md5RSASign = "1.3.14.3.2.25"
+szOID_OIWSEC_sha1 = "1.3.14.3.2.26"
+szOID_OIWSEC_dsaSHA1 = "1.3.14.3.2.27"
+szOID_OIWSEC_dsaCommSHA1 = "1.3.14.3.2.28"
+szOID_OIWSEC_sha1RSASign = "1.3.14.3.2.29"
+szOID_OIWDIR = "1.3.14.7.2"
+szOID_OIWDIR_CRPT = "1.3.14.7.2.1"
+szOID_OIWDIR_HASH = "1.3.14.7.2.2"
+szOID_OIWDIR_SIGN = "1.3.14.7.2.3"
+szOID_OIWDIR_md2 = "1.3.14.7.2.2.1"
+szOID_OIWDIR_md2RSA = "1.3.14.7.2.3.1"
+szOID_INFOSEC = "2.16.840.1.101.2.1"
+szOID_INFOSEC_sdnsSignature = "2.16.840.1.101.2.1.1.1"
+szOID_INFOSEC_mosaicSignature = "2.16.840.1.101.2.1.1.2"
+szOID_INFOSEC_sdnsConfidentiality = "2.16.840.1.101.2.1.1.3"
+szOID_INFOSEC_mosaicConfidentiality = "2.16.840.1.101.2.1.1.4"
+szOID_INFOSEC_sdnsIntegrity = "2.16.840.1.101.2.1.1.5"
+szOID_INFOSEC_mosaicIntegrity = "2.16.840.1.101.2.1.1.6"
+szOID_INFOSEC_sdnsTokenProtection = "2.16.840.1.101.2.1.1.7"
+szOID_INFOSEC_mosaicTokenProtection = "2.16.840.1.101.2.1.1.8"
+szOID_INFOSEC_sdnsKeyManagement = "2.16.840.1.101.2.1.1.9"
+szOID_INFOSEC_mosaicKeyManagement = "2.16.840.1.101.2.1.1.10"
+szOID_INFOSEC_sdnsKMandSig = "2.16.840.1.101.2.1.1.11"
+szOID_INFOSEC_mosaicKMandSig = "2.16.840.1.101.2.1.1.12"
+szOID_INFOSEC_SuiteASignature = "2.16.840.1.101.2.1.1.13"
+szOID_INFOSEC_SuiteAConfidentiality = "2.16.840.1.101.2.1.1.14"
+szOID_INFOSEC_SuiteAIntegrity = "2.16.840.1.101.2.1.1.15"
+szOID_INFOSEC_SuiteATokenProtection = "2.16.840.1.101.2.1.1.16"
+szOID_INFOSEC_SuiteAKeyManagement = "2.16.840.1.101.2.1.1.17"
+szOID_INFOSEC_SuiteAKMandSig = "2.16.840.1.101.2.1.1.18"
+szOID_INFOSEC_mosaicUpdatedSig = "2.16.840.1.101.2.1.1.19"
+szOID_INFOSEC_mosaicKMandUpdSig = "2.16.840.1.101.2.1.1.20"
+szOID_INFOSEC_mosaicUpdatedInteg = "2.16.840.1.101.2.1.1.21"
+szOID_COMMON_NAME = "2.5.4.3"
+szOID_SUR_NAME = "2.5.4.4"
+szOID_DEVICE_SERIAL_NUMBER = "2.5.4.5"
+szOID_COUNTRY_NAME = "2.5.4.6"
+szOID_LOCALITY_NAME = "2.5.4.7"
+szOID_STATE_OR_PROVINCE_NAME = "2.5.4.8"
+szOID_STREET_ADDRESS = "2.5.4.9"
+szOID_ORGANIZATION_NAME = "2.5.4.10"
+szOID_ORGANIZATIONAL_UNIT_NAME = "2.5.4.11"
+szOID_TITLE = "2.5.4.12"
+szOID_DESCRIPTION = "2.5.4.13"
+szOID_SEARCH_GUIDE = "2.5.4.14"
+szOID_BUSINESS_CATEGORY = "2.5.4.15"
+szOID_POSTAL_ADDRESS = "2.5.4.16"
+szOID_POSTAL_CODE = "2.5.4.17"
+szOID_POST_OFFICE_BOX = "2.5.4.18"
+szOID_PHYSICAL_DELIVERY_OFFICE_NAME = "2.5.4.19"
+szOID_TELEPHONE_NUMBER = "2.5.4.20"
+szOID_TELEX_NUMBER = "2.5.4.21"
+szOID_TELETEXT_TERMINAL_IDENTIFIER = "2.5.4.22"
+szOID_FACSIMILE_TELEPHONE_NUMBER = "2.5.4.23"
+szOID_X21_ADDRESS = "2.5.4.24"
+szOID_INTERNATIONAL_ISDN_NUMBER = "2.5.4.25"
+szOID_REGISTERED_ADDRESS = "2.5.4.26"
+szOID_DESTINATION_INDICATOR = "2.5.4.27"
+szOID_PREFERRED_DELIVERY_METHOD = "2.5.4.28"
+szOID_PRESENTATION_ADDRESS = "2.5.4.29"
+szOID_SUPPORTED_APPLICATION_CONTEXT = "2.5.4.30"
+szOID_MEMBER = "2.5.4.31"
+szOID_OWNER = "2.5.4.32"
+szOID_ROLE_OCCUPANT = "2.5.4.33"
+szOID_SEE_ALSO = "2.5.4.34"
+szOID_USER_PASSWORD = "2.5.4.35"
+szOID_USER_CERTIFICATE = "2.5.4.36"
+szOID_CA_CERTIFICATE = "2.5.4.37"
+szOID_AUTHORITY_REVOCATION_LIST = "2.5.4.38"
+szOID_CERTIFICATE_REVOCATION_LIST = "2.5.4.39"
+szOID_CROSS_CERTIFICATE_PAIR = "2.5.4.40"
+szOID_GIVEN_NAME = "2.5.4.42"
+szOID_INITIALS = "2.5.4.43"
+szOID_DN_QUALIFIER = "2.5.4.46"
+szOID_DOMAIN_COMPONENT = "0.9.2342.19200300.100.1.25"
+szOID_PKCS_12_FRIENDLY_NAME_ATTR = "1.2.840.113549.1.9.20"
+szOID_PKCS_12_LOCAL_KEY_ID = "1.2.840.113549.1.9.21"
+szOID_PKCS_12_KEY_PROVIDER_NAME_ATTR = "1.3.6.1.4.1.311.17.1"
+szOID_LOCAL_MACHINE_KEYSET = "1.3.6.1.4.1.311.17.2"
+szOID_KEYID_RDN = "1.3.6.1.4.1.311.10.7.1"
+CERT_RDN_ANY_TYPE = 0
+CERT_RDN_ENCODED_BLOB = 1
+CERT_RDN_OCTET_STRING = 2
+CERT_RDN_NUMERIC_STRING = 3
+CERT_RDN_PRINTABLE_STRING = 4
+CERT_RDN_TELETEX_STRING = 5
+CERT_RDN_T61_STRING = 5
+CERT_RDN_VIDEOTEX_STRING = 6
+CERT_RDN_IA5_STRING = 7
+CERT_RDN_GRAPHIC_STRING = 8
+CERT_RDN_VISIBLE_STRING = 9
+CERT_RDN_ISO646_STRING = 9
+CERT_RDN_GENERAL_STRING = 10
+CERT_RDN_UNIVERSAL_STRING = 11
+CERT_RDN_INT4_STRING = 11
+CERT_RDN_BMP_STRING = 12
+CERT_RDN_UNICODE_STRING = 12
+CERT_RDN_UTF8_STRING = 13
+CERT_RDN_TYPE_MASK = 0x000000FF
+CERT_RDN_FLAGS_MASK = -16777216
+CERT_RDN_ENABLE_T61_UNICODE_FLAG = -2147483648
+CERT_RDN_ENABLE_UTF8_UNICODE_FLAG = 0x20000000
+CERT_RDN_DISABLE_CHECK_TYPE_FLAG = 0x40000000
+CERT_RDN_DISABLE_IE4_UTF8_FLAG = 0x01000000
+CERT_RSA_PUBLIC_KEY_OBJID = szOID_RSA_RSA
+CERT_DEFAULT_OID_PUBLIC_KEY_SIGN = szOID_RSA_RSA
+CERT_DEFAULT_OID_PUBLIC_KEY_XCHG = szOID_RSA_RSA
+CERT_V1 = 0
+CERT_V2 = 1
+CERT_V3 = 2
+CERT_INFO_VERSION_FLAG = 1
+CERT_INFO_SERIAL_NUMBER_FLAG = 2
+CERT_INFO_SIGNATURE_ALGORITHM_FLAG = 3
+CERT_INFO_ISSUER_FLAG = 4
+CERT_INFO_NOT_BEFORE_FLAG = 5
+CERT_INFO_NOT_AFTER_FLAG = 6
+CERT_INFO_SUBJECT_FLAG = 7
+CERT_INFO_SUBJECT_PUBLIC_KEY_INFO_FLAG = 8
+CERT_INFO_ISSUER_UNIQUE_ID_FLAG = 9
+CERT_INFO_SUBJECT_UNIQUE_ID_FLAG = 10
+CERT_INFO_EXTENSION_FLAG = 11
+CRL_V1 = 0
+CRL_V2 = 1
+CERT_REQUEST_V1 = 0
+CERT_KEYGEN_REQUEST_V1 = 0
+CTL_V1 = 0
+CERT_ENCODING_TYPE_MASK = 0x0000FFFF
+CMSG_ENCODING_TYPE_MASK = -65536
+
+
+def GET_CERT_ENCODING_TYPE(X):
+    return X & CERT_ENCODING_TYPE_MASK
+
+
+def GET_CMSG_ENCODING_TYPE(X):
+    return X & CMSG_ENCODING_TYPE_MASK
+
+
+CRYPT_ASN_ENCODING = 0x00000001
+CRYPT_NDR_ENCODING = 0x00000002
+X509_ASN_ENCODING = 0x00000001
+X509_NDR_ENCODING = 0x00000002
+PKCS_7_ASN_ENCODING = 0x00010000
+PKCS_7_NDR_ENCODING = 0x00020000
+CRYPT_FORMAT_STR_MULTI_LINE = 0x0001
+CRYPT_FORMAT_STR_NO_HEX = 0x0010
+CRYPT_FORMAT_SIMPLE = 0x0001
+CRYPT_FORMAT_X509 = 0x0002
+CRYPT_FORMAT_OID = 0x0004
+CRYPT_FORMAT_RDN_SEMICOLON = 0x0100
+CRYPT_FORMAT_RDN_CRLF = 0x0200
+CRYPT_FORMAT_RDN_UNQUOTE = 0x0400
+CRYPT_FORMAT_RDN_REVERSE = 0x0800
+CRYPT_FORMAT_COMMA = 0x1000
+CRYPT_FORMAT_SEMICOLON = CRYPT_FORMAT_RDN_SEMICOLON
+CRYPT_FORMAT_CRLF = CRYPT_FORMAT_RDN_CRLF
+CRYPT_ENCODE_NO_SIGNATURE_BYTE_REVERSAL_FLAG = 0x8
+CRYPT_ENCODE_ALLOC_FLAG = 0x8000
+CRYPT_UNICODE_NAME_ENCODE_ENABLE_T61_UNICODE_FLAG = CERT_RDN_ENABLE_T61_UNICODE_FLAG
+CRYPT_UNICODE_NAME_ENCODE_ENABLE_UTF8_UNICODE_FLAG = CERT_RDN_ENABLE_UTF8_UNICODE_FLAG
+CRYPT_UNICODE_NAME_ENCODE_DISABLE_CHECK_TYPE_FLAG = CERT_RDN_DISABLE_CHECK_TYPE_FLAG
+CRYPT_SORTED_CTL_ENCODE_HASHED_SUBJECT_IDENTIFIER_FLAG = 0x10000
+CRYPT_DECODE_NOCOPY_FLAG = 0x1
+CRYPT_DECODE_TO_BE_SIGNED_FLAG = 0x2
+CRYPT_DECODE_SHARE_OID_STRING_FLAG = 0x4
+CRYPT_DECODE_NO_SIGNATURE_BYTE_REVERSAL_FLAG = 0x8
+CRYPT_DECODE_ALLOC_FLAG = 0x8000
+CRYPT_UNICODE_NAME_DECODE_DISABLE_IE4_UTF8_FLAG = CERT_RDN_DISABLE_IE4_UTF8_FLAG
+
+CRYPT_ENCODE_DECODE_NONE = 0
+X509_CERT = 1
+X509_CERT_TO_BE_SIGNED = 2
+X509_CERT_CRL_TO_BE_SIGNED = 3
+X509_CERT_REQUEST_TO_BE_SIGNED = 4
+X509_EXTENSIONS = 5
+X509_NAME_VALUE = 6
+X509_NAME = 7
+X509_PUBLIC_KEY_INFO = 8
+X509_AUTHORITY_KEY_ID = 9
+X509_KEY_ATTRIBUTES = 10
+X509_KEY_USAGE_RESTRICTION = 11
+X509_ALTERNATE_NAME = 12
+X509_BASIC_CONSTRAINTS = 13
+X509_KEY_USAGE = 14
+X509_BASIC_CONSTRAINTS2 = 15
+X509_CERT_POLICIES = 16
+PKCS_UTC_TIME = 17
+PKCS_TIME_REQUEST = 18
+RSA_CSP_PUBLICKEYBLOB = 19
+X509_UNICODE_NAME = 20
+X509_KEYGEN_REQUEST_TO_BE_SIGNED = 21
+PKCS_ATTRIBUTE = 22
+PKCS_CONTENT_INFO_SEQUENCE_OF_ANY = 23
+X509_UNICODE_NAME_VALUE = 24
+X509_ANY_STRING = X509_NAME_VALUE
+X509_UNICODE_ANY_STRING = X509_UNICODE_NAME_VALUE
+X509_OCTET_STRING = 25
+X509_BITS = 26
+X509_INTEGER = 27
+X509_MULTI_BYTE_INTEGER = 28
+X509_ENUMERATED = 29
+X509_CHOICE_OF_TIME = 30
+X509_AUTHORITY_KEY_ID2 = 31
+X509_AUTHORITY_INFO_ACCESS = 32
+X509_SUBJECT_INFO_ACCESS = X509_AUTHORITY_INFO_ACCESS
+X509_CRL_REASON_CODE = X509_ENUMERATED
+PKCS_CONTENT_INFO = 33
+X509_SEQUENCE_OF_ANY = 34
+X509_CRL_DIST_POINTS = 35
+X509_ENHANCED_KEY_USAGE = 36
+PKCS_CTL = 37
+X509_MULTI_BYTE_UINT = 38
+X509_DSS_PUBLICKEY = X509_MULTI_BYTE_UINT
+X509_DSS_PARAMETERS = 39
+X509_DSS_SIGNATURE = 40
+PKCS_RC2_CBC_PARAMETERS = 41
+PKCS_SMIME_CAPABILITIES = 42
+X509_QC_STATEMENTS_EXT = 42
+PKCS_RSA_PRIVATE_KEY = 43
+PKCS_PRIVATE_KEY_INFO = 44
+PKCS_ENCRYPTED_PRIVATE_KEY_INFO = 45
+X509_PKIX_POLICY_QUALIFIER_USERNOTICE = 46
+X509_DH_PUBLICKEY = X509_MULTI_BYTE_UINT
+X509_DH_PARAMETERS = 47
+PKCS_ATTRIBUTES = 48
+PKCS_SORTED_CTL = 49
+X509_ECC_SIGNATURE = 47
+X942_DH_PARAMETERS = 50
+X509_BITS_WITHOUT_TRAILING_ZEROES = 51
+X942_OTHER_INFO = 52
+X509_CERT_PAIR = 53
+X509_ISSUING_DIST_POINT = 54
+X509_NAME_CONSTRAINTS = 55
+X509_POLICY_MAPPINGS = 56
+X509_POLICY_CONSTRAINTS = 57
+X509_CROSS_CERT_DIST_POINTS = 58
+CMC_DATA = 59
+CMC_RESPONSE = 60
+CMC_STATUS = 61
+CMC_ADD_EXTENSIONS = 62
+CMC_ADD_ATTRIBUTES = 63
+X509_CERTIFICATE_TEMPLATE = 64
+OCSP_SIGNED_REQUEST = 65
+OCSP_REQUEST = 66
+OCSP_RESPONSE = 67
+OCSP_BASIC_SIGNED_RESPONSE = 68
+OCSP_BASIC_RESPONSE = 69
+X509_LOGOTYPE_EXT = 70
+X509_BIOMETRIC_EXT = 71
+CNG_RSA_PUBLIC_KEY_BLOB = 72
+X509_OBJECT_IDENTIFIER = 73
+X509_ALGORITHM_IDENTIFIER = 74
+PKCS_RSA_SSA_PSS_PARAMETERS = 75
+PKCS_RSAES_OAEP_PARAMETERS = 76
+ECC_CMS_SHARED_INFO = 77
+TIMESTAMP_REQUEST = 78
+TIMESTAMP_RESPONSE = 79
+TIMESTAMP_INFO = 80
+X509_CERT_BUNDLE = 81
+PKCS7_SIGNER_INFO = 500
+CMS_SIGNER_INFO = 501
+
+szOID_AUTHORITY_KEY_IDENTIFIER = "2.5.29.1"
+szOID_KEY_ATTRIBUTES = "2.5.29.2"
+szOID_CERT_POLICIES_95 = "2.5.29.3"
+szOID_KEY_USAGE_RESTRICTION = "2.5.29.4"
+szOID_SUBJECT_ALT_NAME = "2.5.29.7"
+szOID_ISSUER_ALT_NAME = "2.5.29.8"
+szOID_BASIC_CONSTRAINTS = "2.5.29.10"
+szOID_KEY_USAGE = "2.5.29.15"
+szOID_PRIVATEKEY_USAGE_PERIOD = "2.5.29.16"
+szOID_BASIC_CONSTRAINTS2 = "2.5.29.19"
+szOID_CERT_POLICIES = "2.5.29.32"
+szOID_ANY_CERT_POLICY = "2.5.29.32.0"
+szOID_AUTHORITY_KEY_IDENTIFIER2 = "2.5.29.35"
+szOID_SUBJECT_KEY_IDENTIFIER = "2.5.29.14"
+szOID_SUBJECT_ALT_NAME2 = "2.5.29.17"
+szOID_ISSUER_ALT_NAME2 = "2.5.29.18"
+szOID_CRL_REASON_CODE = "2.5.29.21"
+szOID_REASON_CODE_HOLD = "2.5.29.23"
+szOID_CRL_DIST_POINTS = "2.5.29.31"
+szOID_ENHANCED_KEY_USAGE = "2.5.29.37"
+szOID_CRL_NUMBER = "2.5.29.20"
+szOID_DELTA_CRL_INDICATOR = "2.5.29.27"
+szOID_ISSUING_DIST_POINT = "2.5.29.28"
+szOID_FRESHEST_CRL = "2.5.29.46"
+szOID_NAME_CONSTRAINTS = "2.5.29.30"
+szOID_POLICY_MAPPINGS = "2.5.29.33"
+szOID_LEGACY_POLICY_MAPPINGS = "2.5.29.5"
+szOID_POLICY_CONSTRAINTS = "2.5.29.36"
+szOID_RENEWAL_CERTIFICATE = "1.3.6.1.4.1.311.13.1"
+szOID_ENROLLMENT_NAME_VALUE_PAIR = "1.3.6.1.4.1.311.13.2.1"
+szOID_ENROLLMENT_CSP_PROVIDER = "1.3.6.1.4.1.311.13.2.2"
+szOID_OS_VERSION = "1.3.6.1.4.1.311.13.2.3"
+szOID_ENROLLMENT_AGENT = "1.3.6.1.4.1.311.20.2.1"
+szOID_PKIX = "1.3.6.1.5.5.7"
+szOID_PKIX_PE = "1.3.6.1.5.5.7.1"
+szOID_AUTHORITY_INFO_ACCESS = "1.3.6.1.5.5.7.1.1"
+szOID_CERT_EXTENSIONS = "1.3.6.1.4.1.311.2.1.14"
+szOID_NEXT_UPDATE_LOCATION = "1.3.6.1.4.1.311.10.2"
+szOID_REMOVE_CERTIFICATE = "1.3.6.1.4.1.311.10.8.1"
+szOID_CROSS_CERT_DIST_POINTS = "1.3.6.1.4.1.311.10.9.1"
+szOID_CTL = "1.3.6.1.4.1.311.10.1"
+szOID_SORTED_CTL = "1.3.6.1.4.1.311.10.1.1"
+szOID_SERIALIZED = "1.3.6.1.4.1.311.10.3.3.1"
+szOID_NT_PRINCIPAL_NAME = "1.3.6.1.4.1.311.20.2.3"
+szOID_PRODUCT_UPDATE = "1.3.6.1.4.1.311.31.1"
+szOID_ANY_APPLICATION_POLICY = "1.3.6.1.4.1.311.10.12.1"
+szOID_AUTO_ENROLL_CTL_USAGE = "1.3.6.1.4.1.311.20.1"
+szOID_ENROLL_CERTTYPE_EXTENSION = "1.3.6.1.4.1.311.20.2"
+szOID_CERT_MANIFOLD = "1.3.6.1.4.1.311.20.3"
+szOID_CERTSRV_CA_VERSION = "1.3.6.1.4.1.311.21.1"
+szOID_CERTSRV_PREVIOUS_CERT_HASH = "1.3.6.1.4.1.311.21.2"
+szOID_CRL_VIRTUAL_BASE = "1.3.6.1.4.1.311.21.3"
+szOID_CRL_NEXT_PUBLISH = "1.3.6.1.4.1.311.21.4"
+szOID_KP_CA_EXCHANGE = "1.3.6.1.4.1.311.21.5"
+szOID_KP_KEY_RECOVERY_AGENT = "1.3.6.1.4.1.311.21.6"
+szOID_CERTIFICATE_TEMPLATE = "1.3.6.1.4.1.311.21.7"
+szOID_ENTERPRISE_OID_ROOT = "1.3.6.1.4.1.311.21.8"
+szOID_RDN_DUMMY_SIGNER = "1.3.6.1.4.1.311.21.9"
+szOID_APPLICATION_CERT_POLICIES = "1.3.6.1.4.1.311.21.10"
+szOID_APPLICATION_POLICY_MAPPINGS = "1.3.6.1.4.1.311.21.11"
+szOID_APPLICATION_POLICY_CONSTRAINTS = "1.3.6.1.4.1.311.21.12"
+szOID_ARCHIVED_KEY_ATTR = "1.3.6.1.4.1.311.21.13"
+szOID_CRL_SELF_CDP = "1.3.6.1.4.1.311.21.14"
+szOID_REQUIRE_CERT_CHAIN_POLICY = "1.3.6.1.4.1.311.21.15"
+szOID_ARCHIVED_KEY_CERT_HASH = "1.3.6.1.4.1.311.21.16"
+szOID_ISSUED_CERT_HASH = "1.3.6.1.4.1.311.21.17"
+szOID_DS_EMAIL_REPLICATION = "1.3.6.1.4.1.311.21.19"
+szOID_REQUEST_CLIENT_INFO = "1.3.6.1.4.1.311.21.20"
+szOID_ENCRYPTED_KEY_HASH = "1.3.6.1.4.1.311.21.21"
+szOID_CERTSRV_CROSSCA_VERSION = "1.3.6.1.4.1.311.21.22"
+szOID_NTDS_REPLICATION = "1.3.6.1.4.1.311.25.1"
+szOID_SUBJECT_DIR_ATTRS = "2.5.29.9"
+szOID_PKIX_KP = "1.3.6.1.5.5.7.3"
+szOID_PKIX_KP_SERVER_AUTH = "1.3.6.1.5.5.7.3.1"
+szOID_PKIX_KP_CLIENT_AUTH = "1.3.6.1.5.5.7.3.2"
+szOID_PKIX_KP_CODE_SIGNING = "1.3.6.1.5.5.7.3.3"
+szOID_PKIX_KP_EMAIL_PROTECTION = "1.3.6.1.5.5.7.3.4"
+szOID_PKIX_KP_IPSEC_END_SYSTEM = "1.3.6.1.5.5.7.3.5"
+szOID_PKIX_KP_IPSEC_TUNNEL = "1.3.6.1.5.5.7.3.6"
+szOID_PKIX_KP_IPSEC_USER = "1.3.6.1.5.5.7.3.7"
+szOID_PKIX_KP_TIMESTAMP_SIGNING = "1.3.6.1.5.5.7.3.8"
+szOID_IPSEC_KP_IKE_INTERMEDIATE = "1.3.6.1.5.5.8.2.2"
+szOID_KP_CTL_USAGE_SIGNING = "1.3.6.1.4.1.311.10.3.1"
+szOID_KP_TIME_STAMP_SIGNING = "1.3.6.1.4.1.311.10.3.2"
+szOID_SERVER_GATED_CRYPTO = "1.3.6.1.4.1.311.10.3.3"
+szOID_SGC_NETSCAPE = "2.16.840.1.113730.4.1"
+szOID_KP_EFS = "1.3.6.1.4.1.311.10.3.4"
+szOID_EFS_RECOVERY = "1.3.6.1.4.1.311.10.3.4.1"
+szOID_WHQL_CRYPTO = "1.3.6.1.4.1.311.10.3.5"
+szOID_NT5_CRYPTO = "1.3.6.1.4.1.311.10.3.6"
+szOID_OEM_WHQL_CRYPTO = "1.3.6.1.4.1.311.10.3.7"
+szOID_EMBEDDED_NT_CRYPTO = "1.3.6.1.4.1.311.10.3.8"
+szOID_ROOT_LIST_SIGNER = "1.3.6.1.4.1.311.10.3.9"
+szOID_KP_QUALIFIED_SUBORDINATION = "1.3.6.1.4.1.311.10.3.10"
+szOID_KP_KEY_RECOVERY = "1.3.6.1.4.1.311.10.3.11"
+szOID_KP_DOCUMENT_SIGNING = "1.3.6.1.4.1.311.10.3.12"
+szOID_KP_LIFETIME_SIGNING = "1.3.6.1.4.1.311.10.3.13"
+szOID_KP_MOBILE_DEVICE_SOFTWARE = "1.3.6.1.4.1.311.10.3.14"
+szOID_DRM = "1.3.6.1.4.1.311.10.5.1"
+szOID_DRM_INDIVIDUALIZATION = "1.3.6.1.4.1.311.10.5.2"
+szOID_LICENSES = "1.3.6.1.4.1.311.10.6.1"
+szOID_LICENSE_SERVER = "1.3.6.1.4.1.311.10.6.2"
+szOID_KP_SMARTCARD_LOGON = "1.3.6.1.4.1.311.20.2.2"
+szOID_YESNO_TRUST_ATTR = "1.3.6.1.4.1.311.10.4.1"
+szOID_PKIX_POLICY_QUALIFIER_CPS = "1.3.6.1.5.5.7.2.1"
+szOID_PKIX_POLICY_QUALIFIER_USERNOTICE = "1.3.6.1.5.5.7.2.2"
+szOID_CERT_POLICIES_95_QUALIFIER1 = "2.16.840.1.113733.1.7.1.1"
+CERT_UNICODE_RDN_ERR_INDEX_MASK = 0x3FF
+CERT_UNICODE_RDN_ERR_INDEX_SHIFT = 22
+CERT_UNICODE_ATTR_ERR_INDEX_MASK = 0x003F
+CERT_UNICODE_ATTR_ERR_INDEX_SHIFT = 16
+CERT_UNICODE_VALUE_ERR_INDEX_MASK = 0x0000FFFF
+CERT_UNICODE_VALUE_ERR_INDEX_SHIFT = 0
+CERT_DIGITAL_SIGNATURE_KEY_USAGE = 0x80
+CERT_NON_REPUDIATION_KEY_USAGE = 0x40
+CERT_KEY_ENCIPHERMENT_KEY_USAGE = 0x20
+CERT_DATA_ENCIPHERMENT_KEY_USAGE = 0x10
+CERT_KEY_AGREEMENT_KEY_USAGE = 0x08
+CERT_KEY_CERT_SIGN_KEY_USAGE = 0x04
+CERT_OFFLINE_CRL_SIGN_KEY_USAGE = 0x02
+CERT_CRL_SIGN_KEY_USAGE = 0x02
+CERT_ENCIPHER_ONLY_KEY_USAGE = 0x01
+CERT_DECIPHER_ONLY_KEY_USAGE = 0x80
+CERT_ALT_NAME_OTHER_NAME = 1
+CERT_ALT_NAME_RFC822_NAME = 2
+CERT_ALT_NAME_DNS_NAME = 3
+CERT_ALT_NAME_X400_ADDRESS = 4
+CERT_ALT_NAME_DIRECTORY_NAME = 5
+CERT_ALT_NAME_EDI_PARTY_NAME = 6
+CERT_ALT_NAME_URL = 7
+CERT_ALT_NAME_IP_ADDRESS = 8
+CERT_ALT_NAME_REGISTERED_ID = 9
+CERT_ALT_NAME_ENTRY_ERR_INDEX_MASK = 0xFF
+CERT_ALT_NAME_ENTRY_ERR_INDEX_SHIFT = 16
+CERT_ALT_NAME_VALUE_ERR_INDEX_MASK = 0x0000FFFF
+CERT_ALT_NAME_VALUE_ERR_INDEX_SHIFT = 0
+CERT_CA_SUBJECT_FLAG = 0x80
+CERT_END_ENTITY_SUBJECT_FLAG = 0x40
+szOID_PKIX_ACC_DESCR = "1.3.6.1.5.5.7.48"
+szOID_PKIX_OCSP = "1.3.6.1.5.5.7.48.1"
+szOID_PKIX_CA_ISSUERS = "1.3.6.1.5.5.7.48.2"
+CRL_REASON_UNSPECIFIED = 0
+CRL_REASON_KEY_COMPROMISE = 1
+CRL_REASON_CA_COMPROMISE = 2
+CRL_REASON_AFFILIATION_CHANGED = 3
+CRL_REASON_SUPERSEDED = 4
+CRL_REASON_CESSATION_OF_OPERATION = 5
+CRL_REASON_CERTIFICATE_HOLD = 6
+CRL_REASON_REMOVE_FROM_CRL = 8
+CRL_DIST_POINT_NO_NAME = 0
+CRL_DIST_POINT_FULL_NAME = 1
+CRL_DIST_POINT_ISSUER_RDN_NAME = 2
+CRL_REASON_UNUSED_FLAG = 0x80
+CRL_REASON_KEY_COMPROMISE_FLAG = 0x40
+CRL_REASON_CA_COMPROMISE_FLAG = 0x20
+CRL_REASON_AFFILIATION_CHANGED_FLAG = 0x10
+CRL_REASON_SUPERSEDED_FLAG = 0x08
+CRL_REASON_CESSATION_OF_OPERATION_FLAG = 0x04
+CRL_REASON_CERTIFICATE_HOLD_FLAG = 0x02
+CRL_DIST_POINT_ERR_INDEX_MASK = 0x7F
+CRL_DIST_POINT_ERR_INDEX_SHIFT = 24
+
+CRL_DIST_POINT_ERR_CRL_ISSUER_BIT = -2147483648
+
+CROSS_CERT_DIST_POINT_ERR_INDEX_MASK = 0xFF
+CROSS_CERT_DIST_POINT_ERR_INDEX_SHIFT = 24
+
+CERT_EXCLUDED_SUBTREE_BIT = -2147483648
+
+SORTED_CTL_EXT_FLAGS_OFFSET = 0 * 4
+SORTED_CTL_EXT_COUNT_OFFSET = 1 * 4
+SORTED_CTL_EXT_MAX_COLLISION_OFFSET = 2 * 4
+SORTED_CTL_EXT_HASH_BUCKET_OFFSET = 3 * 4
+SORTED_CTL_EXT_HASHED_SUBJECT_IDENTIFIER_FLAG = 0x1
+CERT_DSS_R_LEN = 20
+CERT_DSS_S_LEN = 20
+CERT_DSS_SIGNATURE_LEN = CERT_DSS_R_LEN + CERT_DSS_S_LEN
+CERT_MAX_ASN_ENCODED_DSS_SIGNATURE_LEN = 2 + 2 * (2 + 20 + 1)
+CRYPT_X942_COUNTER_BYTE_LENGTH = 4
+CRYPT_X942_KEY_LENGTH_BYTE_LENGTH = 4
+CRYPT_X942_PUB_INFO_BYTE_LENGTH = 512 / 8
+CRYPT_RC2_40BIT_VERSION = 160
+CRYPT_RC2_56BIT_VERSION = 52
+CRYPT_RC2_64BIT_VERSION = 120
+CRYPT_RC2_128BIT_VERSION = 58
+szOID_VERISIGN_PRIVATE_6_9 = "2.16.840.1.113733.1.6.9"
+szOID_VERISIGN_ONSITE_JURISDICTION_HASH = "2.16.840.1.113733.1.6.11"
+szOID_VERISIGN_BITSTRING_6_13 = "2.16.840.1.113733.1.6.13"
+szOID_VERISIGN_ISS_STRONG_CRYPTO = "2.16.840.1.113733.1.8.1"
+szOID_NETSCAPE = "2.16.840.1.113730"
+szOID_NETSCAPE_CERT_EXTENSION = "2.16.840.1.113730.1"
+szOID_NETSCAPE_CERT_TYPE = "2.16.840.1.113730.1.1"
+szOID_NETSCAPE_BASE_URL = "2.16.840.1.113730.1.2"
+szOID_NETSCAPE_REVOCATION_URL = "2.16.840.1.113730.1.3"
+szOID_NETSCAPE_CA_REVOCATION_URL = "2.16.840.1.113730.1.4"
+szOID_NETSCAPE_CERT_RENEWAL_URL = "2.16.840.1.113730.1.7"
+szOID_NETSCAPE_CA_POLICY_URL = "2.16.840.1.113730.1.8"
+szOID_NETSCAPE_SSL_SERVER_NAME = "2.16.840.1.113730.1.12"
+szOID_NETSCAPE_COMMENT = "2.16.840.1.113730.1.13"
+szOID_NETSCAPE_DATA_TYPE = "2.16.840.1.113730.2"
+szOID_NETSCAPE_CERT_SEQUENCE = "2.16.840.1.113730.2.5"
+NETSCAPE_SSL_CLIENT_AUTH_CERT_TYPE = 0x80
+NETSCAPE_SSL_SERVER_AUTH_CERT_TYPE = 0x40
+NETSCAPE_SMIME_CERT_TYPE = 0x20
+NETSCAPE_SIGN_CERT_TYPE = 0x10
+NETSCAPE_SSL_CA_CERT_TYPE = 0x04
+NETSCAPE_SMIME_CA_CERT_TYPE = 0x02
+NETSCAPE_SIGN_CA_CERT_TYPE = 0x01
+szOID_CT_PKI_DATA = "1.3.6.1.5.5.7.12.2"
+szOID_CT_PKI_RESPONSE = "1.3.6.1.5.5.7.12.3"
+szOID_PKIX_NO_SIGNATURE = "1.3.6.1.5.5.7.6.2"
+szOID_CMC = "1.3.6.1.5.5.7.7"
+szOID_CMC_STATUS_INFO = "1.3.6.1.5.5.7.7.1"
+szOID_CMC_IDENTIFICATION = "1.3.6.1.5.5.7.7.2"
+szOID_CMC_IDENTITY_PROOF = "1.3.6.1.5.5.7.7.3"
+szOID_CMC_DATA_RETURN = "1.3.6.1.5.5.7.7.4"
+szOID_CMC_TRANSACTION_ID = "1.3.6.1.5.5.7.7.5"
+szOID_CMC_SENDER_NONCE = "1.3.6.1.5.5.7.7.6"
+szOID_CMC_RECIPIENT_NONCE = "1.3.6.1.5.5.7.7.7"
+szOID_CMC_ADD_EXTENSIONS = "1.3.6.1.5.5.7.7.8"
+szOID_CMC_ENCRYPTED_POP = "1.3.6.1.5.5.7.7.9"
+szOID_CMC_DECRYPTED_POP = "1.3.6.1.5.5.7.7.10"
+szOID_CMC_LRA_POP_WITNESS = "1.3.6.1.5.5.7.7.11"
+szOID_CMC_GET_CERT = "1.3.6.1.5.5.7.7.15"
+szOID_CMC_GET_CRL = "1.3.6.1.5.5.7.7.16"
+szOID_CMC_REVOKE_REQUEST = "1.3.6.1.5.5.7.7.17"
+szOID_CMC_REG_INFO = "1.3.6.1.5.5.7.7.18"
+szOID_CMC_RESPONSE_INFO = "1.3.6.1.5.5.7.7.19"
+szOID_CMC_QUERY_PENDING = "1.3.6.1.5.5.7.7.21"
+szOID_CMC_ID_POP_LINK_RANDOM = "1.3.6.1.5.5.7.7.22"
+szOID_CMC_ID_POP_LINK_WITNESS = "1.3.6.1.5.5.7.7.23"
+szOID_CMC_ID_CONFIRM_CERT_ACCEPTANCE = "1.3.6.1.5.5.7.7.24"
+szOID_CMC_ADD_ATTRIBUTES = "1.3.6.1.4.1.311.10.10.1"
+CMC_TAGGED_CERT_REQUEST_CHOICE = 1
+CMC_OTHER_INFO_NO_CHOICE = 0
+CMC_OTHER_INFO_FAIL_CHOICE = 1
+CMC_OTHER_INFO_PEND_CHOICE = 2
+CMC_STATUS_SUCCESS = 0
+CMC_STATUS_FAILED = 2
+CMC_STATUS_PENDING = 3
+CMC_STATUS_NO_SUPPORT = 4
+CMC_STATUS_CONFIRM_REQUIRED = 5
+CMC_FAIL_BAD_ALG = 0
+CMC_FAIL_BAD_MESSAGE_CHECK = 1
+CMC_FAIL_BAD_REQUEST = 2
+CMC_FAIL_BAD_TIME = 3
+CMC_FAIL_BAD_CERT_ID = 4
+CMC_FAIL_UNSUPORTED_EXT = 5
+CMC_FAIL_MUST_ARCHIVE_KEYS = 6
+CMC_FAIL_BAD_IDENTITY = 7
+CMC_FAIL_POP_REQUIRED = 8
+CMC_FAIL_POP_FAILED = 9
+CMC_FAIL_NO_KEY_REUSE = 10
+CMC_FAIL_INTERNAL_CA_ERROR = 11
+CMC_FAIL_TRY_LATER = 12
+CRYPT_OID_ENCODE_OBJECT_FUNC = "CryptDllEncodeObject"
+CRYPT_OID_DECODE_OBJECT_FUNC = "CryptDllDecodeObject"
+CRYPT_OID_ENCODE_OBJECT_EX_FUNC = "CryptDllEncodeObjectEx"
+CRYPT_OID_DECODE_OBJECT_EX_FUNC = "CryptDllDecodeObjectEx"
+CRYPT_OID_CREATE_COM_OBJECT_FUNC = "CryptDllCreateCOMObject"
+CRYPT_OID_VERIFY_REVOCATION_FUNC = "CertDllVerifyRevocation"
+CRYPT_OID_VERIFY_CTL_USAGE_FUNC = "CertDllVerifyCTLUsage"
+CRYPT_OID_FORMAT_OBJECT_FUNC = "CryptDllFormatObject"
+CRYPT_OID_FIND_OID_INFO_FUNC = "CryptDllFindOIDInfo"
+CRYPT_OID_FIND_LOCALIZED_NAME_FUNC = "CryptDllFindLocalizedName"
+
+CRYPT_OID_REGPATH = "Software\\Microsoft\\Cryptography\\OID"
+CRYPT_OID_REG_ENCODING_TYPE_PREFIX = "EncodingType "
+CRYPT_OID_REG_DLL_VALUE_NAME = "Dll"
+CRYPT_OID_REG_FUNC_NAME_VALUE_NAME = "FuncName"
+CRYPT_OID_REG_FUNC_NAME_VALUE_NAME_A = "FuncName"
+CRYPT_OID_REG_FLAGS_VALUE_NAME = "CryptFlags"
+CRYPT_DEFAULT_OID = "DEFAULT"
+CRYPT_INSTALL_OID_FUNC_BEFORE_FLAG = 1
+CRYPT_GET_INSTALLED_OID_FUNC_FLAG = 0x1
+CRYPT_REGISTER_FIRST_INDEX = 0
+CRYPT_REGISTER_LAST_INDEX = -1
+CRYPT_MATCH_ANY_ENCODING_TYPE = -1
+CRYPT_HASH_ALG_OID_GROUP_ID = 1
+CRYPT_ENCRYPT_ALG_OID_GROUP_ID = 2
+CRYPT_PUBKEY_ALG_OID_GROUP_ID = 3
+CRYPT_SIGN_ALG_OID_GROUP_ID = 4
+CRYPT_RDN_ATTR_OID_GROUP_ID = 5
+CRYPT_EXT_OR_ATTR_OID_GROUP_ID = 6
+CRYPT_ENHKEY_USAGE_OID_GROUP_ID = 7
+CRYPT_POLICY_OID_GROUP_ID = 8
+CRYPT_TEMPLATE_OID_GROUP_ID = 9
+CRYPT_LAST_OID_GROUP_ID = 9
+CRYPT_FIRST_ALG_OID_GROUP_ID = CRYPT_HASH_ALG_OID_GROUP_ID
+CRYPT_LAST_ALG_OID_GROUP_ID = CRYPT_SIGN_ALG_OID_GROUP_ID
+CRYPT_OID_INHIBIT_SIGNATURE_FORMAT_FLAG = 0x1
+CRYPT_OID_USE_PUBKEY_PARA_FOR_PKCS7_FLAG = 0x2
+CRYPT_OID_NO_NULL_ALGORITHM_PARA_FLAG = 0x4
+CRYPT_OID_INFO_OID_KEY = 1
+CRYPT_OID_INFO_NAME_KEY = 2
+CRYPT_OID_INFO_ALGID_KEY = 3
+CRYPT_OID_INFO_SIGN_KEY = 4
+CRYPT_INSTALL_OID_INFO_BEFORE_FLAG = 1
+CRYPT_LOCALIZED_NAME_ENCODING_TYPE = 0
+CRYPT_LOCALIZED_NAME_OID = "LocalizedNames"
+szOID_PKCS_7_DATA = "1.2.840.113549.1.7.1"
+szOID_PKCS_7_SIGNED = "1.2.840.113549.1.7.2"
+szOID_PKCS_7_ENVELOPED = "1.2.840.113549.1.7.3"
+szOID_PKCS_7_SIGNEDANDENVELOPED = "1.2.840.113549.1.7.4"
+szOID_PKCS_7_DIGESTED = "1.2.840.113549.1.7.5"
+szOID_PKCS_7_ENCRYPTED = "1.2.840.113549.1.7.6"
+szOID_PKCS_9_CONTENT_TYPE = "1.2.840.113549.1.9.3"
+szOID_PKCS_9_MESSAGE_DIGEST = "1.2.840.113549.1.9.4"
+CMSG_DATA = 1
+CMSG_SIGNED = 2
+CMSG_ENVELOPED = 3
+CMSG_SIGNED_AND_ENVELOPED = 4
+CMSG_HASHED = 5
+CMSG_ENCRYPTED = 6
+
+CMSG_ALL_FLAGS = -1
+CMSG_DATA_FLAG = 1 << CMSG_DATA
+CMSG_SIGNED_FLAG = 1 << CMSG_SIGNED
+CMSG_ENVELOPED_FLAG = 1 << CMSG_ENVELOPED
+CMSG_SIGNED_AND_ENVELOPED_FLAG = 1 << CMSG_SIGNED_AND_ENVELOPED
+CMSG_HASHED_FLAG = 1 << CMSG_HASHED
+CMSG_ENCRYPTED_FLAG = 1 << CMSG_ENCRYPTED
+CERT_ID_ISSUER_SERIAL_NUMBER = 1
+CERT_ID_KEY_IDENTIFIER = 2
+CERT_ID_SHA1_HASH = 3
+CMSG_KEY_AGREE_EPHEMERAL_KEY_CHOICE = 1
+CMSG_KEY_AGREE_STATIC_KEY_CHOICE = 2
+CMSG_MAIL_LIST_HANDLE_KEY_CHOICE = 1
+CMSG_KEY_TRANS_RECIPIENT = 1
+CMSG_KEY_AGREE_RECIPIENT = 2
+CMSG_MAIL_LIST_RECIPIENT = 3
+CMSG_SP3_COMPATIBLE_ENCRYPT_FLAG = -2147483648
+CMSG_RC4_NO_SALT_FLAG = 0x40000000
+CMSG_INDEFINITE_LENGTH = -1
+CMSG_BARE_CONTENT_FLAG = 0x00000001
+CMSG_LENGTH_ONLY_FLAG = 0x00000002
+CMSG_DETACHED_FLAG = 0x00000004
+CMSG_AUTHENTICATED_ATTRIBUTES_FLAG = 0x00000008
+CMSG_CONTENTS_OCTETS_FLAG = 0x00000010
+CMSG_MAX_LENGTH_FLAG = 0x00000020
+CMSG_CMS_ENCAPSULATED_CONTENT_FLAG = 0x00000040
+CMSG_CRYPT_RELEASE_CONTEXT_FLAG = 0x00008000
+CMSG_TYPE_PARAM = 1
+CMSG_CONTENT_PARAM = 2
+CMSG_BARE_CONTENT_PARAM = 3
+CMSG_INNER_CONTENT_TYPE_PARAM = 4
+CMSG_SIGNER_COUNT_PARAM = 5
+CMSG_SIGNER_INFO_PARAM = 6
+CMSG_SIGNER_CERT_INFO_PARAM = 7
+CMSG_SIGNER_HASH_ALGORITHM_PARAM = 8
+CMSG_SIGNER_AUTH_ATTR_PARAM = 9
+CMSG_SIGNER_UNAUTH_ATTR_PARAM = 10
+CMSG_CERT_COUNT_PARAM = 11
+CMSG_CERT_PARAM = 12
+CMSG_CRL_COUNT_PARAM = 13
+CMSG_CRL_PARAM = 14
+CMSG_ENVELOPE_ALGORITHM_PARAM = 15
+CMSG_RECIPIENT_COUNT_PARAM = 17
+CMSG_RECIPIENT_INDEX_PARAM = 18
+CMSG_RECIPIENT_INFO_PARAM = 19
+CMSG_HASH_ALGORITHM_PARAM = 20
+CMSG_HASH_DATA_PARAM = 21
+CMSG_COMPUTED_HASH_PARAM = 22
+CMSG_ENCRYPT_PARAM = 26
+CMSG_ENCRYPTED_DIGEST = 27
+CMSG_ENCODED_SIGNER = 28
+CMSG_ENCODED_MESSAGE = 29
+CMSG_VERSION_PARAM = 30
+CMSG_ATTR_CERT_COUNT_PARAM = 31
+CMSG_ATTR_CERT_PARAM = 32
+CMSG_CMS_RECIPIENT_COUNT_PARAM = 33
+CMSG_CMS_RECIPIENT_INDEX_PARAM = 34
+CMSG_CMS_RECIPIENT_ENCRYPTED_KEY_INDEX_PARAM = 35
+CMSG_CMS_RECIPIENT_INFO_PARAM = 36
+CMSG_UNPROTECTED_ATTR_PARAM = 37
+CMSG_SIGNER_CERT_ID_PARAM = 38
+CMSG_CMS_SIGNER_INFO_PARAM = 39
+CMSG_SIGNED_DATA_V1 = 1
+CMSG_SIGNED_DATA_V3 = 3
+CMSG_SIGNED_DATA_PKCS_1_5_VERSION = CMSG_SIGNED_DATA_V1
+CMSG_SIGNED_DATA_CMS_VERSION = CMSG_SIGNED_DATA_V3
+CMSG_SIGNER_INFO_V1 = 1
+CMSG_SIGNER_INFO_V3 = 3
+CMSG_SIGNER_INFO_PKCS_1_5_VERSION = CMSG_SIGNER_INFO_V1
+CMSG_SIGNER_INFO_CMS_VERSION = CMSG_SIGNER_INFO_V3
+CMSG_HASHED_DATA_V0 = 0
+CMSG_HASHED_DATA_V2 = 2
+CMSG_HASHED_DATA_PKCS_1_5_VERSION = CMSG_HASHED_DATA_V0
+CMSG_HASHED_DATA_CMS_VERSION = CMSG_HASHED_DATA_V2
+CMSG_ENVELOPED_DATA_V0 = 0
+CMSG_ENVELOPED_DATA_V2 = 2
+CMSG_ENVELOPED_DATA_PKCS_1_5_VERSION = CMSG_ENVELOPED_DATA_V0
+CMSG_ENVELOPED_DATA_CMS_VERSION = CMSG_ENVELOPED_DATA_V2
+CMSG_KEY_AGREE_ORIGINATOR_CERT = 1
+CMSG_KEY_AGREE_ORIGINATOR_PUBLIC_KEY = 2
+CMSG_ENVELOPED_RECIPIENT_V0 = 0
+CMSG_ENVELOPED_RECIPIENT_V2 = 2
+CMSG_ENVELOPED_RECIPIENT_V3 = 3
+CMSG_ENVELOPED_RECIPIENT_V4 = 4
+CMSG_KEY_TRANS_PKCS_1_5_VERSION = CMSG_ENVELOPED_RECIPIENT_V0
+CMSG_KEY_TRANS_CMS_VERSION = CMSG_ENVELOPED_RECIPIENT_V2
+CMSG_KEY_AGREE_VERSION = CMSG_ENVELOPED_RECIPIENT_V3
+CMSG_MAIL_LIST_VERSION = CMSG_ENVELOPED_RECIPIENT_V4
+CMSG_CTRL_VERIFY_SIGNATURE = 1
+CMSG_CTRL_DECRYPT = 2
+CMSG_CTRL_VERIFY_HASH = 5
+CMSG_CTRL_ADD_SIGNER = 6
+CMSG_CTRL_DEL_SIGNER = 7
+CMSG_CTRL_ADD_SIGNER_UNAUTH_ATTR = 8
+CMSG_CTRL_DEL_SIGNER_UNAUTH_ATTR = 9
+CMSG_CTRL_ADD_CERT = 10
+CMSG_CTRL_DEL_CERT = 11
+CMSG_CTRL_ADD_CRL = 12
+CMSG_CTRL_DEL_CRL = 13
+CMSG_CTRL_ADD_ATTR_CERT = 14
+CMSG_CTRL_DEL_ATTR_CERT = 15
+CMSG_CTRL_KEY_TRANS_DECRYPT = 16
+CMSG_CTRL_KEY_AGREE_DECRYPT = 17
+CMSG_CTRL_MAIL_LIST_DECRYPT = 18
+CMSG_CTRL_VERIFY_SIGNATURE_EX = 19
+CMSG_CTRL_ADD_CMS_SIGNER_INFO = 20
+CMSG_VERIFY_SIGNER_PUBKEY = 1
+CMSG_VERIFY_SIGNER_CERT = 2
+CMSG_VERIFY_SIGNER_CHAIN = 3
+CMSG_VERIFY_SIGNER_NULL = 4
+CMSG_OID_GEN_ENCRYPT_KEY_FUNC = "CryptMsgDllGenEncryptKey"
+CMSG_OID_EXPORT_ENCRYPT_KEY_FUNC = "CryptMsgDllExportEncryptKey"
+CMSG_OID_IMPORT_ENCRYPT_KEY_FUNC = "CryptMsgDllImportEncryptKey"
+CMSG_CONTENT_ENCRYPT_PAD_ENCODED_LEN_FLAG = 0x00000001
+CMSG_DEFAULT_INSTALLABLE_FUNC_OID = 1
+CMSG_CONTENT_ENCRYPT_FREE_PARA_FLAG = 0x00000001
+CMSG_CONTENT_ENCRYPT_RELEASE_CONTEXT_FLAG = 0x00008000
+CMSG_OID_GEN_CONTENT_ENCRYPT_KEY_FUNC = "CryptMsgDllGenContentEncryptKey"
+CMSG_KEY_TRANS_ENCRYPT_FREE_PARA_FLAG = 0x00000001
+CMSG_OID_EXPORT_KEY_TRANS_FUNC = "CryptMsgDllExportKeyTrans"
+CMSG_KEY_AGREE_ENCRYPT_FREE_PARA_FLAG = 0x00000001
+CMSG_KEY_AGREE_ENCRYPT_FREE_MATERIAL_FLAG = 0x00000002
+CMSG_KEY_AGREE_ENCRYPT_FREE_PUBKEY_ALG_FLAG = 0x00000004
+CMSG_KEY_AGREE_ENCRYPT_FREE_PUBKEY_PARA_FLAG = 0x00000008
+CMSG_KEY_AGREE_ENCRYPT_FREE_PUBKEY_BITS_FLAG = 0x00000010
+CMSG_OID_EXPORT_KEY_AGREE_FUNC = "CryptMsgDllExportKeyAgree"
+CMSG_MAIL_LIST_ENCRYPT_FREE_PARA_FLAG = 0x00000001
+CMSG_OID_EXPORT_MAIL_LIST_FUNC = "CryptMsgDllExportMailList"
+CMSG_OID_IMPORT_KEY_TRANS_FUNC = "CryptMsgDllImportKeyTrans"
+CMSG_OID_IMPORT_KEY_AGREE_FUNC = "CryptMsgDllImportKeyAgree"
+CMSG_OID_IMPORT_MAIL_LIST_FUNC = "CryptMsgDllImportMailList"
+
+# Certificate property id's used with CertGetCertificateContextProperty
+CERT_KEY_PROV_HANDLE_PROP_ID = 1
+CERT_KEY_PROV_INFO_PROP_ID = 2
+CERT_SHA1_HASH_PROP_ID = 3
+CERT_MD5_HASH_PROP_ID = 4
+CERT_HASH_PROP_ID = CERT_SHA1_HASH_PROP_ID
+CERT_KEY_CONTEXT_PROP_ID = 5
+CERT_KEY_SPEC_PROP_ID = 6
+CERT_IE30_RESERVED_PROP_ID = 7
+CERT_PUBKEY_HASH_RESERVED_PROP_ID = 8
+CERT_ENHKEY_USAGE_PROP_ID = 9
+CERT_CTL_USAGE_PROP_ID = CERT_ENHKEY_USAGE_PROP_ID
+CERT_NEXT_UPDATE_LOCATION_PROP_ID = 10
+CERT_FRIENDLY_NAME_PROP_ID = 11
+CERT_PVK_FILE_PROP_ID = 12
+CERT_DESCRIPTION_PROP_ID = 13
+CERT_ACCESS_STATE_PROP_ID = 14
+CERT_SIGNATURE_HASH_PROP_ID = 15
+CERT_SMART_CARD_DATA_PROP_ID = 16
+CERT_EFS_PROP_ID = 17
+CERT_FORTEZZA_DATA_PROP_ID = 18
+CERT_ARCHIVED_PROP_ID = 19
+CERT_KEY_IDENTIFIER_PROP_ID = 20
+CERT_AUTO_ENROLL_PROP_ID = 21
+CERT_PUBKEY_ALG_PARA_PROP_ID = 22
+CERT_CROSS_CERT_DIST_POINTS_PROP_ID = 23
+CERT_ISSUER_PUBLIC_KEY_MD5_HASH_PROP_ID = 24
+CERT_SUBJECT_PUBLIC_KEY_MD5_HASH_PROP_ID = 25
+CERT_ENROLLMENT_PROP_ID = 26
+CERT_DATE_STAMP_PROP_ID = 27
+CERT_ISSUER_SERIAL_NUMBER_MD5_HASH_PROP_ID = 28
+CERT_SUBJECT_NAME_MD5_HASH_PROP_ID = 29
+CERT_EXTENDED_ERROR_INFO_PROP_ID = 30
+CERT_RENEWAL_PROP_ID = 64
+CERT_ARCHIVED_KEY_HASH_PROP_ID = 65
+CERT_AUTO_ENROLL_RETRY_PROP_ID = 66
+CERT_AIA_URL_RETRIEVED_PROP_ID = 67
+CERT_AUTHORITY_INFO_ACCESS_PROP_ID = 68
+CERT_BACKED_UP_PROP_ID = 69
+CERT_OCSP_RESPONSE_PROP_ID = 70
+CERT_REQUEST_ORIGINATOR_PROP_ID = 71
+CERT_SOURCE_LOCATION_PROP_ID = 72
+CERT_SOURCE_URL_PROP_ID = 73
+CERT_NEW_KEY_PROP_ID = 74
+CERT_OCSP_CACHE_PREFIX_PROP_ID = 75
+CERT_SMART_CARD_ROOT_INFO_PROP_ID = 76
+CERT_NO_AUTO_EXPIRE_CHECK_PROP_ID = 77
+CERT_NCRYPT_KEY_HANDLE_PROP_ID = 78
+CERT_HCRYPTPROV_OR_NCRYPT_KEY_HANDLE_PROP_ID = 79
+CERT_SUBJECT_INFO_ACCESS_PROP_ID = 80
+CERT_CA_OCSP_AUTHORITY_INFO_ACCESS_PROP_ID = 81
+CERT_CA_DISABLE_CRL_PROP_ID = 82
+CERT_ROOT_PROGRAM_CERT_POLICIES_PROP_ID = 83
+CERT_ROOT_PROGRAM_NAME_CONSTRAINTS_PROP_ID = 84
+CERT_SUBJECT_OCSP_AUTHORITY_INFO_ACCESS_PROP_ID = 85
+CERT_SUBJECT_DISABLE_CRL_PROP_ID = 86
+CERT_CEP_PROP_ID = 87
+CERT_SIGN_HASH_CNG_ALG_PROP_ID = 89
+CERT_SCARD_PIN_ID_PROP_ID = 90
+CERT_SCARD_PIN_INFO_PROP_ID = 91
+CERT_FIRST_RESERVED_PROP_ID = 92
+CERT_LAST_RESERVED_PROP_ID = 0x00007FFF
+CERT_FIRST_USER_PROP_ID = 0x00008000
+CERT_LAST_USER_PROP_ID = 0x0000FFFF
+
+szOID_CERT_PROP_ID_PREFIX = "1.3.6.1.4.1.311.10.11."
+szOID_CERT_KEY_IDENTIFIER_PROP_ID = "1.3.6.1.4.1.311.10.11.20"
+szOID_CERT_ISSUER_SERIAL_NUMBER_MD5_HASH_PROP_ID = "1.3.6.1.4.1.311.10.11.28"
+szOID_CERT_SUBJECT_NAME_MD5_HASH_PROP_ID = "1.3.6.1.4.1.311.10.11.29"
+CERT_ACCESS_STATE_WRITE_PERSIST_FLAG = 0x1
+CERT_ACCESS_STATE_SYSTEM_STORE_FLAG = 0x2
+CERT_ACCESS_STATE_LM_SYSTEM_STORE_FLAG = 0x4
+CERT_SET_KEY_PROV_HANDLE_PROP_ID = 0x00000001
+CERT_SET_KEY_CONTEXT_PROP_ID = 0x00000001
+sz_CERT_STORE_PROV_MEMORY = "Memory"
+sz_CERT_STORE_PROV_FILENAME_W = "File"
+sz_CERT_STORE_PROV_FILENAME = sz_CERT_STORE_PROV_FILENAME_W
+sz_CERT_STORE_PROV_SYSTEM_W = "System"
+sz_CERT_STORE_PROV_SYSTEM = sz_CERT_STORE_PROV_SYSTEM_W
+sz_CERT_STORE_PROV_PKCS7 = "PKCS7"
+sz_CERT_STORE_PROV_SERIALIZED = "Serialized"
+sz_CERT_STORE_PROV_COLLECTION = "Collection"
+sz_CERT_STORE_PROV_SYSTEM_REGISTRY_W = "SystemRegistry"
+sz_CERT_STORE_PROV_SYSTEM_REGISTRY = sz_CERT_STORE_PROV_SYSTEM_REGISTRY_W
+sz_CERT_STORE_PROV_PHYSICAL_W = "Physical"
+sz_CERT_STORE_PROV_PHYSICAL = sz_CERT_STORE_PROV_PHYSICAL_W
+sz_CERT_STORE_PROV_SMART_CARD_W = "SmartCard"
+sz_CERT_STORE_PROV_SMART_CARD = sz_CERT_STORE_PROV_SMART_CARD_W
+sz_CERT_STORE_PROV_LDAP_W = "Ldap"
+sz_CERT_STORE_PROV_LDAP = sz_CERT_STORE_PROV_LDAP_W
+CERT_STORE_SIGNATURE_FLAG = 0x00000001
+CERT_STORE_TIME_VALIDITY_FLAG = 0x00000002
+CERT_STORE_REVOCATION_FLAG = 0x00000004
+CERT_STORE_NO_CRL_FLAG = 0x00010000
+CERT_STORE_NO_ISSUER_FLAG = 0x00020000
+CERT_STORE_BASE_CRL_FLAG = 0x00000100
+CERT_STORE_DELTA_CRL_FLAG = 0x00000200
+CERT_STORE_NO_CRYPT_RELEASE_FLAG = 0x00000001
+CERT_STORE_SET_LOCALIZED_NAME_FLAG = 0x00000002
+CERT_STORE_DEFER_CLOSE_UNTIL_LAST_FREE_FLAG = 0x00000004
+CERT_STORE_DELETE_FLAG = 0x00000010
+CERT_STORE_UNSAFE_PHYSICAL_FLAG = 0x00000020
+CERT_STORE_SHARE_STORE_FLAG = 0x00000040
+CERT_STORE_SHARE_CONTEXT_FLAG = 0x00000080
+CERT_STORE_MANIFOLD_FLAG = 0x00000100
+CERT_STORE_ENUM_ARCHIVED_FLAG = 0x00000200
+CERT_STORE_UPDATE_KEYID_FLAG = 0x00000400
+CERT_STORE_BACKUP_RESTORE_FLAG = 0x00000800
+CERT_STORE_READONLY_FLAG = 0x00008000
+CERT_STORE_OPEN_EXISTING_FLAG = 0x00004000
+CERT_STORE_CREATE_NEW_FLAG = 0x00002000
+CERT_STORE_MAXIMUM_ALLOWED_FLAG = 0x00001000
+CERT_SYSTEM_STORE_MASK = -65536
+CERT_SYSTEM_STORE_RELOCATE_FLAG = -2147483648
+CERT_SYSTEM_STORE_UNPROTECTED_FLAG = 0x40000000
+CERT_SYSTEM_STORE_LOCATION_MASK = 0x00FF0000
+CERT_SYSTEM_STORE_LOCATION_SHIFT = 16
+CERT_SYSTEM_STORE_CURRENT_USER_ID = 1
+CERT_SYSTEM_STORE_LOCAL_MACHINE_ID = 2
+CERT_SYSTEM_STORE_CURRENT_SERVICE_ID = 4
+CERT_SYSTEM_STORE_SERVICES_ID = 5
+CERT_SYSTEM_STORE_USERS_ID = 6
+CERT_SYSTEM_STORE_CURRENT_USER_GROUP_POLICY_ID = 7
+CERT_SYSTEM_STORE_LOCAL_MACHINE_GROUP_POLICY_ID = 8
+CERT_SYSTEM_STORE_LOCAL_MACHINE_ENTERPRISE_ID = 9
+CERT_SYSTEM_STORE_CURRENT_USER = (
+    CERT_SYSTEM_STORE_CURRENT_USER_ID << CERT_SYSTEM_STORE_LOCATION_SHIFT
+)
+CERT_SYSTEM_STORE_LOCAL_MACHINE = (
+    CERT_SYSTEM_STORE_LOCAL_MACHINE_ID << CERT_SYSTEM_STORE_LOCATION_SHIFT
+)
+CERT_SYSTEM_STORE_CURRENT_SERVICE = (
+    CERT_SYSTEM_STORE_CURRENT_SERVICE_ID << CERT_SYSTEM_STORE_LOCATION_SHIFT
+)
+CERT_SYSTEM_STORE_SERVICES = (
+    CERT_SYSTEM_STORE_SERVICES_ID << CERT_SYSTEM_STORE_LOCATION_SHIFT
+)
+CERT_SYSTEM_STORE_USERS = CERT_SYSTEM_STORE_USERS_ID << CERT_SYSTEM_STORE_LOCATION_SHIFT
+CERT_SYSTEM_STORE_CURRENT_USER_GROUP_POLICY = (
+    CERT_SYSTEM_STORE_CURRENT_USER_GROUP_POLICY_ID << CERT_SYSTEM_STORE_LOCATION_SHIFT
+)
+CERT_SYSTEM_STORE_LOCAL_MACHINE_GROUP_POLICY = (
+    CERT_SYSTEM_STORE_LOCAL_MACHINE_GROUP_POLICY_ID << CERT_SYSTEM_STORE_LOCATION_SHIFT
+)
+CERT_SYSTEM_STORE_LOCAL_MACHINE_ENTERPRISE = (
+    CERT_SYSTEM_STORE_LOCAL_MACHINE_ENTERPRISE_ID << CERT_SYSTEM_STORE_LOCATION_SHIFT
+)
+CERT_PROT_ROOT_DISABLE_CURRENT_USER_FLAG = 0x1
+CERT_PROT_ROOT_INHIBIT_ADD_AT_INIT_FLAG = 0x2
+CERT_PROT_ROOT_INHIBIT_PURGE_LM_FLAG = 0x4
+CERT_PROT_ROOT_DISABLE_LM_AUTH_FLAG = 0x8
+CERT_PROT_ROOT_ONLY_LM_GPT_FLAG = 0x8
+CERT_PROT_ROOT_DISABLE_NT_AUTH_REQUIRED_FLAG = 0x10
+CERT_PROT_ROOT_DISABLE_NOT_DEFINED_NAME_CONSTRAINT_FLAG = 0x20
+CERT_TRUST_PUB_ALLOW_TRUST_MASK = 0x00000003
+CERT_TRUST_PUB_ALLOW_END_USER_TRUST = 0x00000000
+CERT_TRUST_PUB_ALLOW_MACHINE_ADMIN_TRUST = 0x00000001
+CERT_TRUST_PUB_ALLOW_ENTERPRISE_ADMIN_TRUST = 0x00000002
+CERT_TRUST_PUB_CHECK_PUBLISHER_REV_FLAG = 0x00000100
+CERT_TRUST_PUB_CHECK_TIMESTAMP_REV_FLAG = 0x00000200
+
+CERT_AUTH_ROOT_AUTO_UPDATE_LOCAL_MACHINE_REGPATH = (
+    r"Software\Microsoft\SystemCertificates\AuthRoot\AutoUpdate"
+)
+CERT_AUTH_ROOT_AUTO_UPDATE_DISABLE_UNTRUSTED_ROOT_LOGGING_FLAG = 0x1
+CERT_AUTH_ROOT_AUTO_UPDATE_DISABLE_PARTIAL_CHAIN_LOGGING_FLAG = 0x2
+CERT_AUTH_ROOT_AUTO_UPDATE_ROOT_DIR_URL_VALUE_NAME = "RootDirUrl"
+CERT_AUTH_ROOT_AUTO_UPDATE_SYNC_DELTA_TIME_VALUE_NAME = "SyncDeltaTime"
+CERT_AUTH_ROOT_AUTO_UPDATE_FLAGS_VALUE_NAME = "Flags"
+CERT_AUTH_ROOT_CTL_FILENAME = "authroot.stl"
+CERT_AUTH_ROOT_CTL_FILENAME_A = "authroot.stl"
+CERT_AUTH_ROOT_CAB_FILENAME = "authrootstl.cab"
+CERT_AUTH_ROOT_SEQ_FILENAME = "authrootseq.txt"
+CERT_AUTH_ROOT_CERT_EXT = ".crt"
+
+CERT_GROUP_POLICY_SYSTEM_STORE_REGPATH = (
+    r"Software\Policies\Microsoft\SystemCertificates"
+)
+CERT_EFSBLOB_REGPATH = CERT_GROUP_POLICY_SYSTEM_STORE_REGPATH + r"\EFS"
+CERT_EFSBLOB_VALUE_NAME = "EFSBlob"
+CERT_PROT_ROOT_FLAGS_REGPATH = (
+    CERT_GROUP_POLICY_SYSTEM_STORE_REGPATH + r"\Root\ProtectedRoots"
+)
+CERT_PROT_ROOT_FLAGS_VALUE_NAME = "Flags"
+CERT_TRUST_PUB_SAFER_GROUP_POLICY_REGPATH = (
+    CERT_GROUP_POLICY_SYSTEM_STORE_REGPATH + r"\TrustedPublisher\Safer"
+)
+CERT_LOCAL_MACHINE_SYSTEM_STORE_REGPATH = r"Software\Microsoft\SystemCertificates"
+CERT_TRUST_PUB_SAFER_LOCAL_MACHINE_REGPATH = (
+    CERT_LOCAL_MACHINE_SYSTEM_STORE_REGPATH + r"\TrustedPublisher\Safer"
+)
+CERT_TRUST_PUB_AUTHENTICODE_FLAGS_VALUE_NAME = "AuthenticodeFlags"
+CERT_OCM_SUBCOMPONENTS_LOCAL_MACHINE_REGPATH = (
+    r"SOFTWARE\Microsoft\Windows\CurrentVersion\Setup\OC Manager\Subcomponents"
+)
+CERT_OCM_SUBCOMPONENTS_ROOT_AUTO_UPDATE_VALUE_NAME = r"RootAutoUpdate"
+CERT_DISABLE_ROOT_AUTO_UPDATE_REGPATH = (
+    CERT_GROUP_POLICY_SYSTEM_STORE_REGPATH + r"\AuthRoot"
+)
+CERT_DISABLE_ROOT_AUTO_UPDATE_VALUE_NAME = "DisableRootAutoUpdate"
+CERT_AUTH_ROOT_AUTO_UPDATE_LOCAL_MACHINE_REGPATH = (
+    CERT_LOCAL_MACHINE_SYSTEM_STORE_REGPATH + r"\AuthRoot\AutoUpdate"
+)
+
+CERT_REGISTRY_STORE_REMOTE_FLAG = 0x10000
+CERT_REGISTRY_STORE_SERIALIZED_FLAG = 0x20000
+CERT_REGISTRY_STORE_CLIENT_GPT_FLAG = -2147483648
+CERT_REGISTRY_STORE_LM_GPT_FLAG = 0x01000000
+CERT_REGISTRY_STORE_ROAMING_FLAG = 0x40000
+CERT_REGISTRY_STORE_MY_IE_DIRTY_FLAG = 0x80000
+CERT_IE_DIRTY_FLAGS_REGPATH = r"Software\Microsoft\Cryptography\IEDirtyFlags"
+
+CERT_FILE_STORE_COMMIT_ENABLE_FLAG = 0x10000
+CERT_LDAP_STORE_SIGN_FLAG = 0x10000
+CERT_LDAP_STORE_AREC_EXCLUSIVE_FLAG = 0x20000
+CERT_LDAP_STORE_OPENED_FLAG = 0x40000
+CERT_LDAP_STORE_UNBIND_FLAG = 0x80000
+CRYPT_OID_OPEN_STORE_PROV_FUNC = "CertDllOpenStoreProv"
+
+CERT_STORE_PROV_EXTERNAL_FLAG = 0x1
+CERT_STORE_PROV_DELETED_FLAG = 0x2
+CERT_STORE_PROV_NO_PERSIST_FLAG = 0x4
+CERT_STORE_PROV_SYSTEM_STORE_FLAG = 0x8
+CERT_STORE_PROV_LM_SYSTEM_STORE_FLAG = 0x10
+CERT_STORE_PROV_CLOSE_FUNC = 0
+CERT_STORE_PROV_READ_CERT_FUNC = 1
+CERT_STORE_PROV_WRITE_CERT_FUNC = 2
+CERT_STORE_PROV_DELETE_CERT_FUNC = 3
+CERT_STORE_PROV_SET_CERT_PROPERTY_FUNC = 4
+CERT_STORE_PROV_READ_CRL_FUNC = 5
+CERT_STORE_PROV_WRITE_CRL_FUNC = 6
+CERT_STORE_PROV_DELETE_CRL_FUNC = 7
+CERT_STORE_PROV_SET_CRL_PROPERTY_FUNC = 8
+CERT_STORE_PROV_READ_CTL_FUNC = 9
+CERT_STORE_PROV_WRITE_CTL_FUNC = 10
+CERT_STORE_PROV_DELETE_CTL_FUNC = 11
+CERT_STORE_PROV_SET_CTL_PROPERTY_FUNC = 12
+CERT_STORE_PROV_CONTROL_FUNC = 13
+CERT_STORE_PROV_FIND_CERT_FUNC = 14
+CERT_STORE_PROV_FREE_FIND_CERT_FUNC = 15
+CERT_STORE_PROV_GET_CERT_PROPERTY_FUNC = 16
+CERT_STORE_PROV_FIND_CRL_FUNC = 17
+CERT_STORE_PROV_FREE_FIND_CRL_FUNC = 18
+CERT_STORE_PROV_GET_CRL_PROPERTY_FUNC = 19
+CERT_STORE_PROV_FIND_CTL_FUNC = 20
+CERT_STORE_PROV_FREE_FIND_CTL_FUNC = 21
+CERT_STORE_PROV_GET_CTL_PROPERTY_FUNC = 22
+CERT_STORE_PROV_WRITE_ADD_FLAG = 0x1
+CERT_STORE_SAVE_AS_STORE = 1
+CERT_STORE_SAVE_AS_PKCS7 = 2
+CERT_STORE_SAVE_TO_FILE = 1
+CERT_STORE_SAVE_TO_MEMORY = 2
+CERT_STORE_SAVE_TO_FILENAME_A = 3
+CERT_STORE_SAVE_TO_FILENAME_W = 4
+CERT_STORE_SAVE_TO_FILENAME = CERT_STORE_SAVE_TO_FILENAME_W
+CERT_CLOSE_STORE_FORCE_FLAG = 0x00000001
+CERT_CLOSE_STORE_CHECK_FLAG = 0x00000002
+CERT_COMPARE_MASK = 0xFFFF
+CERT_COMPARE_SHIFT = 16
+CERT_COMPARE_ANY = 0
+CERT_COMPARE_SHA1_HASH = 1
+CERT_COMPARE_NAME = 2
+CERT_COMPARE_ATTR = 3
+CERT_COMPARE_MD5_HASH = 4
+CERT_COMPARE_PROPERTY = 5
+CERT_COMPARE_PUBLIC_KEY = 6
+CERT_COMPARE_HASH = CERT_COMPARE_SHA1_HASH
+CERT_COMPARE_NAME_STR_A = 7
+CERT_COMPARE_NAME_STR_W = 8
+CERT_COMPARE_KEY_SPEC = 9
+CERT_COMPARE_ENHKEY_USAGE = 10
+CERT_COMPARE_CTL_USAGE = CERT_COMPARE_ENHKEY_USAGE
+CERT_COMPARE_SUBJECT_CERT = 11
+CERT_COMPARE_ISSUER_OF = 12
+CERT_COMPARE_EXISTING = 13
+CERT_COMPARE_SIGNATURE_HASH = 14
+CERT_COMPARE_KEY_IDENTIFIER = 15
+CERT_COMPARE_CERT_ID = 16
+CERT_COMPARE_CROSS_CERT_DIST_POINTS = 17
+CERT_COMPARE_PUBKEY_MD5_HASH = 18
+CERT_FIND_ANY = CERT_COMPARE_ANY << CERT_COMPARE_SHIFT
+CERT_FIND_SHA1_HASH = CERT_COMPARE_SHA1_HASH << CERT_COMPARE_SHIFT
+CERT_FIND_MD5_HASH = CERT_COMPARE_MD5_HASH << CERT_COMPARE_SHIFT
+CERT_FIND_SIGNATURE_HASH = CERT_COMPARE_SIGNATURE_HASH << CERT_COMPARE_SHIFT
+CERT_FIND_KEY_IDENTIFIER = CERT_COMPARE_KEY_IDENTIFIER << CERT_COMPARE_SHIFT
+CERT_FIND_HASH = CERT_FIND_SHA1_HASH
+CERT_FIND_PROPERTY = CERT_COMPARE_PROPERTY << CERT_COMPARE_SHIFT
+CERT_FIND_PUBLIC_KEY = CERT_COMPARE_PUBLIC_KEY << CERT_COMPARE_SHIFT
+CERT_FIND_SUBJECT_NAME = (
+    CERT_COMPARE_NAME << CERT_COMPARE_SHIFT | CERT_INFO_SUBJECT_FLAG
+)
+CERT_FIND_SUBJECT_ATTR = (
+    CERT_COMPARE_ATTR << CERT_COMPARE_SHIFT | CERT_INFO_SUBJECT_FLAG
+)
+CERT_FIND_ISSUER_NAME = CERT_COMPARE_NAME << CERT_COMPARE_SHIFT | CERT_INFO_ISSUER_FLAG
+CERT_FIND_ISSUER_ATTR = CERT_COMPARE_ATTR << CERT_COMPARE_SHIFT | CERT_INFO_ISSUER_FLAG
+CERT_FIND_SUBJECT_STR_A = (
+    CERT_COMPARE_NAME_STR_A << CERT_COMPARE_SHIFT | CERT_INFO_SUBJECT_FLAG
+)
+CERT_FIND_SUBJECT_STR_W = (
+    CERT_COMPARE_NAME_STR_W << CERT_COMPARE_SHIFT | CERT_INFO_SUBJECT_FLAG
+)
+CERT_FIND_SUBJECT_STR = CERT_FIND_SUBJECT_STR_W
+CERT_FIND_ISSUER_STR_A = (
+    CERT_COMPARE_NAME_STR_A << CERT_COMPARE_SHIFT | CERT_INFO_ISSUER_FLAG
+)
+CERT_FIND_ISSUER_STR_W = (
+    CERT_COMPARE_NAME_STR_W << CERT_COMPARE_SHIFT | CERT_INFO_ISSUER_FLAG
+)
+CERT_FIND_ISSUER_STR = CERT_FIND_ISSUER_STR_W
+CERT_FIND_KEY_SPEC = CERT_COMPARE_KEY_SPEC << CERT_COMPARE_SHIFT
+CERT_FIND_ENHKEY_USAGE = CERT_COMPARE_ENHKEY_USAGE << CERT_COMPARE_SHIFT
+CERT_FIND_CTL_USAGE = CERT_FIND_ENHKEY_USAGE
+CERT_FIND_SUBJECT_CERT = CERT_COMPARE_SUBJECT_CERT << CERT_COMPARE_SHIFT
+CERT_FIND_ISSUER_OF = CERT_COMPARE_ISSUER_OF << CERT_COMPARE_SHIFT
+CERT_FIND_EXISTING = CERT_COMPARE_EXISTING << CERT_COMPARE_SHIFT
+CERT_FIND_CERT_ID = CERT_COMPARE_CERT_ID << CERT_COMPARE_SHIFT
+CERT_FIND_CROSS_CERT_DIST_POINTS = (
+    CERT_COMPARE_CROSS_CERT_DIST_POINTS << CERT_COMPARE_SHIFT
+)
+CERT_FIND_PUBKEY_MD5_HASH = CERT_COMPARE_PUBKEY_MD5_HASH << CERT_COMPARE_SHIFT
+CERT_FIND_OPTIONAL_ENHKEY_USAGE_FLAG = 0x1
+CERT_FIND_EXT_ONLY_ENHKEY_USAGE_FLAG = 0x2
+CERT_FIND_PROP_ONLY_ENHKEY_USAGE_FLAG = 0x4
+CERT_FIND_NO_ENHKEY_USAGE_FLAG = 0x8
+CERT_FIND_OR_ENHKEY_USAGE_FLAG = 0x10
+CERT_FIND_VALID_ENHKEY_USAGE_FLAG = 0x20
+CERT_FIND_OPTIONAL_CTL_USAGE_FLAG = CERT_FIND_OPTIONAL_ENHKEY_USAGE_FLAG
+CERT_FIND_EXT_ONLY_CTL_USAGE_FLAG = CERT_FIND_EXT_ONLY_ENHKEY_USAGE_FLAG
+CERT_FIND_PROP_ONLY_CTL_USAGE_FLAG = CERT_FIND_PROP_ONLY_ENHKEY_USAGE_FLAG
+CERT_FIND_NO_CTL_USAGE_FLAG = CERT_FIND_NO_ENHKEY_USAGE_FLAG
+CERT_FIND_OR_CTL_USAGE_FLAG = CERT_FIND_OR_ENHKEY_USAGE_FLAG
+CERT_FIND_VALID_CTL_USAGE_FLAG = CERT_FIND_VALID_ENHKEY_USAGE_FLAG
+CERT_SET_PROPERTY_IGNORE_PERSIST_ERROR_FLAG = -2147483648
+CERT_SET_PROPERTY_INHIBIT_PERSIST_FLAG = 0x40000000
+CTL_ENTRY_FROM_PROP_CHAIN_FLAG = 0x1
+CRL_FIND_ANY = 0
+CRL_FIND_ISSUED_BY = 1
+CRL_FIND_EXISTING = 2
+CRL_FIND_ISSUED_FOR = 3
+CRL_FIND_ISSUED_BY_AKI_FLAG = 0x1
+CRL_FIND_ISSUED_BY_SIGNATURE_FLAG = 0x2
+CRL_FIND_ISSUED_BY_DELTA_FLAG = 0x4
+CRL_FIND_ISSUED_BY_BASE_FLAG = 0x8
+CERT_STORE_ADD_NEW = 1
+CERT_STORE_ADD_USE_EXISTING = 2
+CERT_STORE_ADD_REPLACE_EXISTING = 3
+CERT_STORE_ADD_ALWAYS = 4
+CERT_STORE_ADD_REPLACE_EXISTING_INHERIT_PROPERTIES = 5
+CERT_STORE_ADD_NEWER = 6
+CERT_STORE_ADD_NEWER_INHERIT_PROPERTIES = 7
+CERT_STORE_CERTIFICATE_CONTEXT = 1
+CERT_STORE_CRL_CONTEXT = 2
+CERT_STORE_CTL_CONTEXT = 3
+
+CERT_STORE_ALL_CONTEXT_FLAG = -1
+CERT_STORE_CERTIFICATE_CONTEXT_FLAG = 1 << CERT_STORE_CERTIFICATE_CONTEXT
+CERT_STORE_CRL_CONTEXT_FLAG = 1 << CERT_STORE_CRL_CONTEXT
+CERT_STORE_CTL_CONTEXT_FLAG = 1 << CERT_STORE_CTL_CONTEXT
+CTL_ANY_SUBJECT_TYPE = 1
+CTL_CERT_SUBJECT_TYPE = 2
+CTL_FIND_ANY = 0
+CTL_FIND_SHA1_HASH = 1
+CTL_FIND_MD5_HASH = 2
+CTL_FIND_USAGE = 3
+CTL_FIND_SUBJECT = 4
+CTL_FIND_EXISTING = 5
+CTL_FIND_NO_LIST_ID_CBDATA = -1
+CTL_FIND_SAME_USAGE_FLAG = 0x1
+CERT_STORE_CTRL_RESYNC = 1
+CERT_STORE_CTRL_NOTIFY_CHANGE = 2
+CERT_STORE_CTRL_COMMIT = 3
+CERT_STORE_CTRL_AUTO_RESYNC = 4
+CERT_STORE_CTRL_CANCEL_NOTIFY = 5
+CERT_STORE_CTRL_INHIBIT_DUPLICATE_HANDLE_FLAG = 0x1
+CERT_STORE_CTRL_COMMIT_FORCE_FLAG = 0x1
+CERT_STORE_CTRL_COMMIT_CLEAR_FLAG = 0x2
+CERT_STORE_LOCALIZED_NAME_PROP_ID = 0x1000
+CERT_CREATE_CONTEXT_NOCOPY_FLAG = 0x1
+CERT_CREATE_CONTEXT_SORTED_FLAG = 0x2
+CERT_CREATE_CONTEXT_NO_HCRYPTMSG_FLAG = 0x4
+CERT_CREATE_CONTEXT_NO_ENTRY_FLAG = 0x8
+
+CERT_PHYSICAL_STORE_ADD_ENABLE_FLAG = 0x1
+CERT_PHYSICAL_STORE_OPEN_DISABLE_FLAG = 0x2
+CERT_PHYSICAL_STORE_REMOTE_OPEN_DISABLE_FLAG = 0x4
+CERT_PHYSICAL_STORE_INSERT_COMPUTER_NAME_ENABLE_FLAG = 0x8
+CERT_PHYSICAL_STORE_PREDEFINED_ENUM_FLAG = 0x1
+
+# Names of physical cert stores
+CERT_PHYSICAL_STORE_DEFAULT_NAME = ".Default"
+CERT_PHYSICAL_STORE_GROUP_POLICY_NAME = ".GroupPolicy"
+CERT_PHYSICAL_STORE_LOCAL_MACHINE_NAME = ".LocalMachine"
+CERT_PHYSICAL_STORE_DS_USER_CERTIFICATE_NAME = ".UserCertificate"
+CERT_PHYSICAL_STORE_LOCAL_MACHINE_GROUP_POLICY_NAME = ".LocalMachineGroupPolicy"
+CERT_PHYSICAL_STORE_ENTERPRISE_NAME = ".Enterprise"
+CERT_PHYSICAL_STORE_AUTH_ROOT_NAME = ".AuthRoot"
+CERT_PHYSICAL_STORE_SMART_CARD_NAME = ".SmartCard"
+
+CRYPT_OID_OPEN_SYSTEM_STORE_PROV_FUNC = "CertDllOpenSystemStoreProv"
+CRYPT_OID_REGISTER_SYSTEM_STORE_FUNC = "CertDllRegisterSystemStore"
+CRYPT_OID_UNREGISTER_SYSTEM_STORE_FUNC = "CertDllUnregisterSystemStore"
+CRYPT_OID_ENUM_SYSTEM_STORE_FUNC = "CertDllEnumSystemStore"
+CRYPT_OID_REGISTER_PHYSICAL_STORE_FUNC = "CertDllRegisterPhysicalStore"
+CRYPT_OID_UNREGISTER_PHYSICAL_STORE_FUNC = "CertDllUnregisterPhysicalStore"
+CRYPT_OID_ENUM_PHYSICAL_STORE_FUNC = "CertDllEnumPhysicalStore"
+CRYPT_OID_SYSTEM_STORE_LOCATION_VALUE_NAME = "SystemStoreLocation"
+
+CMSG_TRUSTED_SIGNER_FLAG = 0x1
+CMSG_SIGNER_ONLY_FLAG = 0x2
+CMSG_USE_SIGNER_INDEX_FLAG = 0x4
+CMSG_CMS_ENCAPSULATED_CTL_FLAG = 0x00008000
+CMSG_ENCODE_SORTED_CTL_FLAG = 0x1
+CMSG_ENCODE_HASHED_SUBJECT_IDENTIFIER_FLAG = 0x2
+CERT_VERIFY_INHIBIT_CTL_UPDATE_FLAG = 0x1
+CERT_VERIFY_TRUSTED_SIGNERS_FLAG = 0x2
+CERT_VERIFY_NO_TIME_CHECK_FLAG = 0x4
+CERT_VERIFY_ALLOW_MORE_USAGE_FLAG = 0x8
+CERT_VERIFY_UPDATED_CTL_FLAG = 0x1
+CERT_CONTEXT_REVOCATION_TYPE = 1
+CERT_VERIFY_REV_CHAIN_FLAG = 0x00000001
+CERT_VERIFY_CACHE_ONLY_BASED_REVOCATION = 0x00000002
+CERT_VERIFY_REV_ACCUMULATIVE_TIMEOUT_FLAG = 0x00000004
+CERT_UNICODE_IS_RDN_ATTRS_FLAG = 0x1
+CERT_CASE_INSENSITIVE_IS_RDN_ATTRS_FLAG = 0x2
+CRYPT_VERIFY_CERT_SIGN_SUBJECT_BLOB = 1
+CRYPT_VERIFY_CERT_SIGN_SUBJECT_CERT = 2
+CRYPT_VERIFY_CERT_SIGN_SUBJECT_CRL = 3
+CRYPT_VERIFY_CERT_SIGN_ISSUER_PUBKEY = 1
+CRYPT_VERIFY_CERT_SIGN_ISSUER_CERT = 2
+CRYPT_VERIFY_CERT_SIGN_ISSUER_CHAIN = 3
+CRYPT_VERIFY_CERT_SIGN_ISSUER_NULL = 4
+CRYPT_DEFAULT_CONTEXT_AUTO_RELEASE_FLAG = 0x00000001
+CRYPT_DEFAULT_CONTEXT_PROCESS_FLAG = 0x00000002
+CRYPT_DEFAULT_CONTEXT_CERT_SIGN_OID = 1
+CRYPT_DEFAULT_CONTEXT_MULTI_CERT_SIGN_OID = 2
+CRYPT_OID_EXPORT_PUBLIC_KEY_INFO_FUNC = "CryptDllExportPublicKeyInfoEx"
+CRYPT_OID_IMPORT_PUBLIC_KEY_INFO_FUNC = "CryptDllImportPublicKeyInfoEx"
+CRYPT_ACQUIRE_CACHE_FLAG = 0x00000001
+CRYPT_ACQUIRE_USE_PROV_INFO_FLAG = 0x00000002
+CRYPT_ACQUIRE_COMPARE_KEY_FLAG = 0x00000004
+CRYPT_ACQUIRE_SILENT_FLAG = 0x00000040
+CRYPT_FIND_USER_KEYSET_FLAG = 0x00000001
+CRYPT_FIND_MACHINE_KEYSET_FLAG = 0x00000002
+CRYPT_FIND_SILENT_KEYSET_FLAG = 0x00000040
+CRYPT_OID_IMPORT_PRIVATE_KEY_INFO_FUNC = "CryptDllImportPrivateKeyInfoEx"
+CRYPT_OID_EXPORT_PRIVATE_KEY_INFO_FUNC = "CryptDllExportPrivateKeyInfoEx"
+CRYPT_DELETE_KEYSET = CRYPT_DELETEKEYSET
+CERT_SIMPLE_NAME_STR = 1
+CERT_OID_NAME_STR = 2
+CERT_X500_NAME_STR = 3
+CERT_NAME_STR_SEMICOLON_FLAG = 0x40000000
+CERT_NAME_STR_NO_PLUS_FLAG = 0x20000000
+CERT_NAME_STR_NO_QUOTING_FLAG = 0x10000000
+CERT_NAME_STR_CRLF_FLAG = 0x08000000
+CERT_NAME_STR_COMMA_FLAG = 0x04000000
+CERT_NAME_STR_REVERSE_FLAG = 0x02000000
+CERT_NAME_STR_DISABLE_IE4_UTF8_FLAG = 0x00010000
+CERT_NAME_STR_ENABLE_T61_UNICODE_FLAG = 0x00020000
+CERT_NAME_STR_ENABLE_UTF8_UNICODE_FLAG = 0x00040000
+CERT_NAME_EMAIL_TYPE = 1
+CERT_NAME_RDN_TYPE = 2
+CERT_NAME_ATTR_TYPE = 3
+CERT_NAME_SIMPLE_DISPLAY_TYPE = 4
+CERT_NAME_FRIENDLY_DISPLAY_TYPE = 5
+CERT_NAME_DNS_TYPE = 6
+CERT_NAME_URL_TYPE = 7
+CERT_NAME_UPN_TYPE = 8
+CERT_NAME_ISSUER_FLAG = 0x1
+CERT_NAME_DISABLE_IE4_UTF8_FLAG = 0x00010000
+CRYPT_MESSAGE_BARE_CONTENT_OUT_FLAG = 0x00000001
+CRYPT_MESSAGE_ENCAPSULATED_CONTENT_OUT_FLAG = 0x00000002
+CRYPT_MESSAGE_KEYID_SIGNER_FLAG = 0x00000004
+CRYPT_MESSAGE_SILENT_KEYSET_FLAG = 0x00000040
+CRYPT_MESSAGE_KEYID_RECIPIENT_FLAG = 0x4
+CERT_QUERY_OBJECT_FILE = 0x00000001
+CERT_QUERY_OBJECT_BLOB = 0x00000002
+CERT_QUERY_CONTENT_CERT = 1
+CERT_QUERY_CONTENT_CTL = 2
+CERT_QUERY_CONTENT_CRL = 3
+CERT_QUERY_CONTENT_SERIALIZED_STORE = 4
+CERT_QUERY_CONTENT_SERIALIZED_CERT = 5
+CERT_QUERY_CONTENT_SERIALIZED_CTL = 6
+CERT_QUERY_CONTENT_SERIALIZED_CRL = 7
+CERT_QUERY_CONTENT_PKCS7_SIGNED = 8
+CERT_QUERY_CONTENT_PKCS7_UNSIGNED = 9
+CERT_QUERY_CONTENT_PKCS7_SIGNED_EMBED = 10
+CERT_QUERY_CONTENT_PKCS10 = 11
+CERT_QUERY_CONTENT_PFX = 12
+CERT_QUERY_CONTENT_CERT_PAIR = 13
+CERT_QUERY_CONTENT_FLAG_CERT = 1 << CERT_QUERY_CONTENT_CERT
+CERT_QUERY_CONTENT_FLAG_CTL = 1 << CERT_QUERY_CONTENT_CTL
+CERT_QUERY_CONTENT_FLAG_CRL = 1 << CERT_QUERY_CONTENT_CRL
+CERT_QUERY_CONTENT_FLAG_SERIALIZED_STORE = 1 << CERT_QUERY_CONTENT_SERIALIZED_STORE
+CERT_QUERY_CONTENT_FLAG_SERIALIZED_CERT = 1 << CERT_QUERY_CONTENT_SERIALIZED_CERT
+CERT_QUERY_CONTENT_FLAG_SERIALIZED_CTL = 1 << CERT_QUERY_CONTENT_SERIALIZED_CTL
+CERT_QUERY_CONTENT_FLAG_SERIALIZED_CRL = 1 << CERT_QUERY_CONTENT_SERIALIZED_CRL
+CERT_QUERY_CONTENT_FLAG_PKCS7_SIGNED = 1 << CERT_QUERY_CONTENT_PKCS7_SIGNED
+CERT_QUERY_CONTENT_FLAG_PKCS7_UNSIGNED = 1 << CERT_QUERY_CONTENT_PKCS7_UNSIGNED
+CERT_QUERY_CONTENT_FLAG_PKCS7_SIGNED_EMBED = 1 << CERT_QUERY_CONTENT_PKCS7_SIGNED_EMBED
+CERT_QUERY_CONTENT_FLAG_PKCS10 = 1 << CERT_QUERY_CONTENT_PKCS10
+CERT_QUERY_CONTENT_FLAG_PFX = 1 << CERT_QUERY_CONTENT_PFX
+CERT_QUERY_CONTENT_FLAG_CERT_PAIR = 1 << CERT_QUERY_CONTENT_CERT_PAIR
+CERT_QUERY_CONTENT_FLAG_ALL = (
+    CERT_QUERY_CONTENT_FLAG_CERT
+    | CERT_QUERY_CONTENT_FLAG_CTL
+    | CERT_QUERY_CONTENT_FLAG_CRL
+    | CERT_QUERY_CONTENT_FLAG_SERIALIZED_STORE
+    | CERT_QUERY_CONTENT_FLAG_SERIALIZED_CERT
+    | CERT_QUERY_CONTENT_FLAG_SERIALIZED_CTL
+    | CERT_QUERY_CONTENT_FLAG_SERIALIZED_CRL
+    | CERT_QUERY_CONTENT_FLAG_PKCS7_SIGNED
+    | CERT_QUERY_CONTENT_FLAG_PKCS7_UNSIGNED
+    | CERT_QUERY_CONTENT_FLAG_PKCS7_SIGNED_EMBED
+    | CERT_QUERY_CONTENT_FLAG_PKCS10
+    | CERT_QUERY_CONTENT_FLAG_PFX
+    | CERT_QUERY_CONTENT_FLAG_CERT_PAIR
+)
+CERT_QUERY_FORMAT_BINARY = 1
+CERT_QUERY_FORMAT_BASE64_ENCODED = 2
+CERT_QUERY_FORMAT_ASN_ASCII_HEX_ENCODED = 3
+CERT_QUERY_FORMAT_FLAG_BINARY = 1 << CERT_QUERY_FORMAT_BINARY
+CERT_QUERY_FORMAT_FLAG_BASE64_ENCODED = 1 << CERT_QUERY_FORMAT_BASE64_ENCODED
+CERT_QUERY_FORMAT_FLAG_ASN_ASCII_HEX_ENCODED = (
+    1 << CERT_QUERY_FORMAT_ASN_ASCII_HEX_ENCODED
+)
+CERT_QUERY_FORMAT_FLAG_ALL = (
+    CERT_QUERY_FORMAT_FLAG_BINARY
+    | CERT_QUERY_FORMAT_FLAG_BASE64_ENCODED
+    | CERT_QUERY_FORMAT_FLAG_ASN_ASCII_HEX_ENCODED
+)
+
+CREDENTIAL_OID_PASSWORD_CREDENTIALS_A = 1
+CREDENTIAL_OID_PASSWORD_CREDENTIALS_W = 2
+CREDENTIAL_OID_PASSWORD_CREDENTIALS = CREDENTIAL_OID_PASSWORD_CREDENTIALS_W
+
+SCHEME_OID_RETRIEVE_ENCODED_OBJECT_FUNC = "SchemeDllRetrieveEncodedObject"
+SCHEME_OID_RETRIEVE_ENCODED_OBJECTW_FUNC = "SchemeDllRetrieveEncodedObjectW"
+CONTEXT_OID_CREATE_OBJECT_CONTEXT_FUNC = "ContextDllCreateObjectContext"
+CONTEXT_OID_CERTIFICATE = 1
+CONTEXT_OID_CRL = 2
+CONTEXT_OID_CTL = 3
+CONTEXT_OID_PKCS7 = 4
+CONTEXT_OID_CAPI2_ANY = 5
+CONTEXT_OID_OCSP_RESP = 6
+
+CRYPT_RETRIEVE_MULTIPLE_OBJECTS = 0x00000001
+CRYPT_CACHE_ONLY_RETRIEVAL = 0x00000002
+CRYPT_WIRE_ONLY_RETRIEVAL = 0x00000004
+CRYPT_DONT_CACHE_RESULT = 0x00000008
+CRYPT_ASYNC_RETRIEVAL = 0x00000010
+CRYPT_STICKY_CACHE_RETRIEVAL = 0x00001000
+CRYPT_LDAP_SCOPE_BASE_ONLY_RETRIEVAL = 0x00002000
+CRYPT_OFFLINE_CHECK_RETRIEVAL = 0x00004000
+CRYPT_LDAP_INSERT_ENTRY_ATTRIBUTE = 0x00008000
+CRYPT_LDAP_SIGN_RETRIEVAL = 0x00010000
+CRYPT_NO_AUTH_RETRIEVAL = 0x00020000
+CRYPT_LDAP_AREC_EXCLUSIVE_RETRIEVAL = 0x00040000
+CRYPT_AIA_RETRIEVAL = 0x00080000
+CRYPT_VERIFY_CONTEXT_SIGNATURE = 0x00000020
+CRYPT_VERIFY_DATA_HASH = 0x00000040
+CRYPT_KEEP_TIME_VALID = 0x00000080
+CRYPT_DONT_VERIFY_SIGNATURE = 0x00000100
+CRYPT_DONT_CHECK_TIME_VALIDITY = 0x00000200
+CRYPT_CHECK_FRESHNESS_TIME_VALIDITY = 0x00000400
+CRYPT_ACCUMULATIVE_TIMEOUT = 0x00000800
+CRYPT_PARAM_ASYNC_RETRIEVAL_COMPLETION = 1
+CRYPT_PARAM_CANCEL_ASYNC_RETRIEVAL = 2
+CRYPT_GET_URL_FROM_PROPERTY = 0x00000001
+CRYPT_GET_URL_FROM_EXTENSION = 0x00000002
+CRYPT_GET_URL_FROM_UNAUTH_ATTRIBUTE = 0x00000004
+CRYPT_GET_URL_FROM_AUTH_ATTRIBUTE = 0x00000008
+URL_OID_GET_OBJECT_URL_FUNC = "UrlDllGetObjectUrl"
+TIME_VALID_OID_GET_OBJECT_FUNC = "TimeValidDllGetObject"
+TIME_VALID_OID_FLUSH_OBJECT_FUNC = "TimeValidDllFlushObject"
+
+TIME_VALID_OID_GET_CTL = 1
+TIME_VALID_OID_GET_CRL = 2
+TIME_VALID_OID_GET_CRL_FROM_CERT = 3
+TIME_VALID_OID_GET_FRESHEST_CRL_FROM_CERT = 4
+TIME_VALID_OID_GET_FRESHEST_CRL_FROM_CRL = 5
+
+TIME_VALID_OID_FLUSH_CTL = 1
+TIME_VALID_OID_FLUSH_CRL = 2
+TIME_VALID_OID_FLUSH_CRL_FROM_CERT = 3
+TIME_VALID_OID_FLUSH_FRESHEST_CRL_FROM_CERT = 4
+TIME_VALID_OID_FLUSH_FRESHEST_CRL_FROM_CRL = 5
+
+CRYPTPROTECT_PROMPT_ON_UNPROTECT = 0x1
+CRYPTPROTECT_PROMPT_ON_PROTECT = 0x2
+CRYPTPROTECT_PROMPT_RESERVED = 0x04
+CRYPTPROTECT_PROMPT_STRONG = 0x08
+CRYPTPROTECT_PROMPT_REQUIRE_STRONG = 0x10
+CRYPTPROTECT_UI_FORBIDDEN = 0x1
+CRYPTPROTECT_LOCAL_MACHINE = 0x4
+CRYPTPROTECT_CRED_SYNC = 0x8
+CRYPTPROTECT_AUDIT = 0x10
+CRYPTPROTECT_NO_RECOVERY = 0x20
+CRYPTPROTECT_VERIFY_PROTECTION = 0x40
+CRYPTPROTECT_CRED_REGENERATE = 0x80
+CRYPTPROTECT_FIRST_RESERVED_FLAGVAL = 0x0FFFFFFF
+CRYPTPROTECT_LAST_RESERVED_FLAGVAL = -1
+CRYPTPROTECTMEMORY_BLOCK_SIZE = 16
+CRYPTPROTECTMEMORY_SAME_PROCESS = 0x00
+CRYPTPROTECTMEMORY_CROSS_PROCESS = 0x01
+CRYPTPROTECTMEMORY_SAME_LOGON = 0x02
+CERT_CREATE_SELFSIGN_NO_SIGN = 1
+CERT_CREATE_SELFSIGN_NO_KEY_INFO = 2
+CRYPT_KEYID_MACHINE_FLAG = 0x00000020
+CRYPT_KEYID_ALLOC_FLAG = 0x00008000
+CRYPT_KEYID_DELETE_FLAG = 0x00000010
+CRYPT_KEYID_SET_NEW_FLAG = 0x00002000
+CERT_CHAIN_MAX_AIA_URL_COUNT_IN_CERT_DEFAULT = 5
+CERT_CHAIN_MAX_AIA_URL_RETRIEVAL_COUNT_PER_CHAIN_DEFAULT = 10
+CERT_CHAIN_MAX_AIA_URL_RETRIEVAL_BYTE_COUNT_DEFAULT = 100000
+CERT_CHAIN_MAX_AIA_URL_RETRIEVAL_CERT_COUNT_DEFAULT = 10
+CERT_CHAIN_CACHE_END_CERT = 0x00000001
+CERT_CHAIN_THREAD_STORE_SYNC = 0x00000002
+CERT_CHAIN_CACHE_ONLY_URL_RETRIEVAL = 0x00000004
+CERT_CHAIN_USE_LOCAL_MACHINE_STORE = 0x00000008
+CERT_CHAIN_ENABLE_CACHE_AUTO_UPDATE = 0x00000010
+CERT_CHAIN_ENABLE_SHARE_STORE = 0x00000020
+CERT_TRUST_NO_ERROR = 0x00000000
+CERT_TRUST_IS_NOT_TIME_VALID = 0x00000001
+CERT_TRUST_IS_NOT_TIME_NESTED = 0x00000002
+CERT_TRUST_IS_REVOKED = 0x00000004
+CERT_TRUST_IS_NOT_SIGNATURE_VALID = 0x00000008
+CERT_TRUST_IS_NOT_VALID_FOR_USAGE = 0x00000010
+CERT_TRUST_IS_UNTRUSTED_ROOT = 0x00000020
+CERT_TRUST_REVOCATION_STATUS_UNKNOWN = 0x00000040
+CERT_TRUST_IS_CYCLIC = 0x00000080
+CERT_TRUST_INVALID_EXTENSION = 0x00000100
+CERT_TRUST_INVALID_POLICY_CONSTRAINTS = 0x00000200
+CERT_TRUST_INVALID_BASIC_CONSTRAINTS = 0x00000400
+CERT_TRUST_INVALID_NAME_CONSTRAINTS = 0x00000800
+CERT_TRUST_HAS_NOT_SUPPORTED_NAME_CONSTRAINT = 0x00001000
+CERT_TRUST_HAS_NOT_DEFINED_NAME_CONSTRAINT = 0x00002000
+CERT_TRUST_HAS_NOT_PERMITTED_NAME_CONSTRAINT = 0x00004000
+CERT_TRUST_HAS_EXCLUDED_NAME_CONSTRAINT = 0x00008000
+CERT_TRUST_IS_OFFLINE_REVOCATION = 0x01000000
+CERT_TRUST_NO_ISSUANCE_CHAIN_POLICY = 0x02000000
+CERT_TRUST_IS_PARTIAL_CHAIN = 0x00010000
+CERT_TRUST_CTL_IS_NOT_TIME_VALID = 0x00020000
+CERT_TRUST_CTL_IS_NOT_SIGNATURE_VALID = 0x00040000
+CERT_TRUST_CTL_IS_NOT_VALID_FOR_USAGE = 0x00080000
+CERT_TRUST_HAS_EXACT_MATCH_ISSUER = 0x00000001
+CERT_TRUST_HAS_KEY_MATCH_ISSUER = 0x00000002
+CERT_TRUST_HAS_NAME_MATCH_ISSUER = 0x00000004
+CERT_TRUST_IS_SELF_SIGNED = 0x00000008
+CERT_TRUST_HAS_PREFERRED_ISSUER = 0x00000100
+CERT_TRUST_HAS_ISSUANCE_CHAIN_POLICY = 0x00000200
+CERT_TRUST_HAS_VALID_NAME_CONSTRAINTS = 0x00000400
+CERT_TRUST_IS_COMPLEX_CHAIN = 0x00010000
+USAGE_MATCH_TYPE_AND = 0x00000000
+USAGE_MATCH_TYPE_OR = 0x00000001
+CERT_CHAIN_REVOCATION_CHECK_END_CERT = 0x10000000
+CERT_CHAIN_REVOCATION_CHECK_CHAIN = 0x20000000
+CERT_CHAIN_REVOCATION_CHECK_CHAIN_EXCLUDE_ROOT = 0x40000000
+CERT_CHAIN_REVOCATION_CHECK_CACHE_ONLY = -2147483648
+CERT_CHAIN_REVOCATION_ACCUMULATIVE_TIMEOUT = 0x08000000
+CERT_CHAIN_DISABLE_PASS1_QUALITY_FILTERING = 0x00000040
+CERT_CHAIN_RETURN_LOWER_QUALITY_CONTEXTS = 0x00000080
+CERT_CHAIN_DISABLE_AUTH_ROOT_AUTO_UPDATE = 0x00000100
+CERT_CHAIN_TIMESTAMP_TIME = 0x00000200
+REVOCATION_OID_CRL_REVOCATION = 1
+CERT_CHAIN_FIND_BY_ISSUER = 1
+CERT_CHAIN_FIND_BY_ISSUER_COMPARE_KEY_FLAG = 0x0001
+CERT_CHAIN_FIND_BY_ISSUER_COMPLEX_CHAIN_FLAG = 0x0002
+CERT_CHAIN_FIND_BY_ISSUER_CACHE_ONLY_URL_FLAG = 0x0004
+CERT_CHAIN_FIND_BY_ISSUER_LOCAL_MACHINE_FLAG = 0x0008
+CERT_CHAIN_FIND_BY_ISSUER_NO_KEY_FLAG = 0x4000
+CERT_CHAIN_FIND_BY_ISSUER_CACHE_ONLY_FLAG = 0x8000
+CERT_CHAIN_POLICY_IGNORE_NOT_TIME_VALID_FLAG = 0x00000001
+CERT_CHAIN_POLICY_IGNORE_CTL_NOT_TIME_VALID_FLAG = 0x00000002
+CERT_CHAIN_POLICY_IGNORE_NOT_TIME_NESTED_FLAG = 0x00000004
+CERT_CHAIN_POLICY_IGNORE_INVALID_BASIC_CONSTRAINTS_FLAG = 0x00000008
+CERT_CHAIN_POLICY_IGNORE_ALL_NOT_TIME_VALID_FLAGS = (
+    CERT_CHAIN_POLICY_IGNORE_NOT_TIME_VALID_FLAG
+    | CERT_CHAIN_POLICY_IGNORE_CTL_NOT_TIME_VALID_FLAG
+    | CERT_CHAIN_POLICY_IGNORE_NOT_TIME_NESTED_FLAG
+)
+CERT_CHAIN_POLICY_ALLOW_UNKNOWN_CA_FLAG = 0x00000010
+CERT_CHAIN_POLICY_IGNORE_WRONG_USAGE_FLAG = 0x00000020
+CERT_CHAIN_POLICY_IGNORE_INVALID_NAME_FLAG = 0x00000040
+CERT_CHAIN_POLICY_IGNORE_INVALID_POLICY_FLAG = 0x00000080
+CERT_CHAIN_POLICY_IGNORE_END_REV_UNKNOWN_FLAG = 0x00000100
+CERT_CHAIN_POLICY_IGNORE_CTL_SIGNER_REV_UNKNOWN_FLAG = 0x00000200
+CERT_CHAIN_POLICY_IGNORE_CA_REV_UNKNOWN_FLAG = 0x00000400
+CERT_CHAIN_POLICY_IGNORE_ROOT_REV_UNKNOWN_FLAG = 0x00000800
+CERT_CHAIN_POLICY_IGNORE_ALL_REV_UNKNOWN_FLAGS = (
+    CERT_CHAIN_POLICY_IGNORE_END_REV_UNKNOWN_FLAG
+    | CERT_CHAIN_POLICY_IGNORE_CTL_SIGNER_REV_UNKNOWN_FLAG
+    | CERT_CHAIN_POLICY_IGNORE_CA_REV_UNKNOWN_FLAG
+    | CERT_CHAIN_POLICY_IGNORE_ROOT_REV_UNKNOWN_FLAG
+)
+CERT_CHAIN_POLICY_ALLOW_TESTROOT_FLAG = 0x00008000
+CERT_CHAIN_POLICY_TRUST_TESTROOT_FLAG = 0x00004000
+CRYPT_OID_VERIFY_CERTIFICATE_CHAIN_POLICY_FUNC = "CertDllVerifyCertificateChainPolicy"
+AUTHTYPE_CLIENT = 1
+AUTHTYPE_SERVER = 2
+BASIC_CONSTRAINTS_CERT_CHAIN_POLICY_CA_FLAG = -2147483648
+BASIC_CONSTRAINTS_CERT_CHAIN_POLICY_END_ENTITY_FLAG = 0x40000000
+MICROSOFT_ROOT_CERT_CHAIN_POLICY_ENABLE_TEST_ROOT_FLAG = 0x00010000
+CRYPT_STRING_BASE64HEADER = 0x00000000
+CRYPT_STRING_BASE64 = 0x00000001
+CRYPT_STRING_BINARY = 0x00000002
+CRYPT_STRING_BASE64REQUESTHEADER = 0x00000003
+CRYPT_STRING_HEX = 0x00000004
+CRYPT_STRING_HEXASCII = 0x00000005
+CRYPT_STRING_BASE64_ANY = 0x00000006
+CRYPT_STRING_ANY = 0x00000007
+CRYPT_STRING_HEX_ANY = 0x00000008
+CRYPT_STRING_BASE64X509CRLHEADER = 0x00000009
+CRYPT_STRING_HEXADDR = 0x0000000A
+CRYPT_STRING_HEXASCIIADDR = 0x0000000B
+CRYPT_STRING_NOCR = -2147483648
+CRYPT_USER_KEYSET = 0x00001000
+PKCS12_IMPORT_RESERVED_MASK = -65536
+REPORT_NO_PRIVATE_KEY = 0x0001
+REPORT_NOT_ABLE_TO_EXPORT_PRIVATE_KEY = 0x0002
+EXPORT_PRIVATE_KEYS = 0x0004
+PKCS12_EXPORT_RESERVED_MASK = -65536
+
+# Certificate store provider types used with CertOpenStore
+CERT_STORE_PROV_MSG = 1
+CERT_STORE_PROV_MEMORY = 2
+CERT_STORE_PROV_FILE = 3
+CERT_STORE_PROV_REG = 4
+CERT_STORE_PROV_PKCS7 = 5
+CERT_STORE_PROV_SERIALIZED = 6
+CERT_STORE_PROV_FILENAME = 8
+CERT_STORE_PROV_SYSTEM = 10
+CERT_STORE_PROV_COLLECTION = 11
+CERT_STORE_PROV_SYSTEM_REGISTRY = 13
+CERT_STORE_PROV_PHYSICAL = 14
+CERT_STORE_PROV_SMART_CARD = 15
+CERT_STORE_PROV_LDAP = 16
+
+URL_OID_CERTIFICATE_ISSUER = 1
+URL_OID_CERTIFICATE_CRL_DIST_POINT = 2
+URL_OID_CTL_ISSUER = 3
+URL_OID_CTL_NEXT_UPDATE = 4
+URL_OID_CRL_ISSUER = 5
+URL_OID_CERTIFICATE_FRESHEST_CRL = 6
+URL_OID_CRL_FRESHEST_CRL = 7
+URL_OID_CROSS_CERT_DIST_POINT = 8
+URL_OID_CERTIFICATE_OCSP = 9
+URL_OID_CERTIFICATE_OCSP_AND_CRL_DIST_POINT = 10
+URL_OID_CERTIFICATE_CRL_DIST_POINT_AND_OCSP = 11
+URL_OID_CROSS_CERT_SUBJECT_INFO_ACCESS = 12
+URL_OID_CERTIFICATE_ONLY_OCSP = 13
diff --git a/lib/win32/lib/win32evtlogutil.py b/lib/win32/lib/win32evtlogutil.py
new file mode 100644
index 00000000..78e231c9
--- /dev/null
+++ b/lib/win32/lib/win32evtlogutil.py
@@ -0,0 +1,229 @@
+"""Event Log Utilities - helper for win32evtlog.pyd
+"""
+
+import win32api
+import win32con
+import win32evtlog
+import winerror
+
+error = win32api.error  # The error the evtlog module raises.
+
+langid = win32api.MAKELANGID(win32con.LANG_NEUTRAL, win32con.SUBLANG_NEUTRAL)
+
+
+def AddSourceToRegistry(
+    appName,
+    msgDLL=None,
+    eventLogType="Application",
+    eventLogFlags=None,
+    categoryDLL=None,
+    categoryCount=0,
+):
+    """Add a source of messages to the event log.
+
+    Allows Python program to register a custom source of messages in the
+    registry.  You must also provide the DLL name that has the message table, so the
+    full message text appears in the event log.
+
+    Note that the win32evtlog.pyd file has a number of string entries with just "%1"
+    built in, so many Python programs can simply use this DLL.  Disadvantages are that
+    you do not get language translation, and the full text is stored in the event log,
+    blowing the size of the log up.
+    """
+
+    # When an application uses the RegisterEventSource or OpenEventLog
+    # function to get a handle of an event log, the event logging service
+    # searches for the specified source name in the registry. You can add a
+    # new source name to the registry by opening a new registry subkey
+    # under the Application key and adding registry values to the new
+    # subkey.
+
+    if msgDLL is None:
+        msgDLL = win32evtlog.__file__
+    # Create a new key for our application
+    hkey = win32api.RegCreateKey(
+        win32con.HKEY_LOCAL_MACHINE,
+        "SYSTEM\\CurrentControlSet\\Services\\EventLog\\%s\\%s"
+        % (eventLogType, appName),
+    )
+
+    # Add the Event-ID message-file name to the subkey.
+    win32api.RegSetValueEx(
+        hkey,
+        "EventMessageFile",  # value name \
+        0,  # reserved \
+        win32con.REG_EXPAND_SZ,  # value type \
+        msgDLL,
+    )
+
+    # Set the supported types flags and add it to the subkey.
+    if eventLogFlags is None:
+        eventLogFlags = (
+            win32evtlog.EVENTLOG_ERROR_TYPE
+            | win32evtlog.EVENTLOG_WARNING_TYPE
+            | win32evtlog.EVENTLOG_INFORMATION_TYPE
+        )
+    win32api.RegSetValueEx(
+        hkey,  # subkey handle \
+        "TypesSupported",  # value name \
+        0,  # reserved \
+        win32con.REG_DWORD,  # value type \
+        eventLogFlags,
+    )
+
+    if categoryCount > 0:
+        # Optionally, you can specify a message file that contains the categories
+        if categoryDLL is None:
+            categoryDLL = win32evtlog.__file__
+        win32api.RegSetValueEx(
+            hkey,  # subkey handle \
+            "CategoryMessageFile",  # value name \
+            0,  # reserved \
+            win32con.REG_EXPAND_SZ,  # value type \
+            categoryDLL,
+        )
+
+        win32api.RegSetValueEx(
+            hkey,  # subkey handle \
+            "CategoryCount",  # value name \
+            0,  # reserved \
+            win32con.REG_DWORD,  # value type \
+            categoryCount,
+        )
+    win32api.RegCloseKey(hkey)
+
+
+def RemoveSourceFromRegistry(appName, eventLogType="Application"):
+    """Removes a source of messages from the event log."""
+
+    # Delete our key
+    try:
+        win32api.RegDeleteKey(
+            win32con.HKEY_LOCAL_MACHINE,
+            "SYSTEM\\CurrentControlSet\\Services\\EventLog\\%s\\%s"
+            % (eventLogType, appName),
+        )
+    except win32api.error as exc:
+        if exc.winerror != winerror.ERROR_FILE_NOT_FOUND:
+            raise
+
+
+def ReportEvent(
+    appName,
+    eventID,
+    eventCategory=0,
+    eventType=win32evtlog.EVENTLOG_ERROR_TYPE,
+    strings=None,
+    data=None,
+    sid=None,
+):
+    """Report an event for a previously added event source."""
+    # Get a handle to the Application event log
+    hAppLog = win32evtlog.RegisterEventSource(None, appName)
+
+    # Now report the event, which will add this event to the event log */
+    win32evtlog.ReportEvent(
+        hAppLog,  # event-log handle \
+        eventType,
+        eventCategory,
+        eventID,
+        sid,
+        strings,
+        data,
+    )
+
+    win32evtlog.DeregisterEventSource(hAppLog)
+
+
+def FormatMessage(eventLogRecord, logType="Application"):
+    """Given a tuple from ReadEventLog, and optionally where the event
+    record came from, load the message, and process message inserts.
+
+    Note that this function may raise win32api.error.  See also the
+    function SafeFormatMessage which will return None if the message can
+    not be processed.
+    """
+
+    # From the event log source name, we know the name of the registry
+    # key to look under for the name of the message DLL that contains
+    # the messages we need to extract with FormatMessage. So first get
+    # the event log source name...
+    keyName = "SYSTEM\\CurrentControlSet\\Services\\EventLog\\%s\\%s" % (
+        logType,
+        eventLogRecord.SourceName,
+    )
+
+    # Now open this key and get the EventMessageFile value, which is
+    # the name of the message DLL.
+    handle = win32api.RegOpenKey(win32con.HKEY_LOCAL_MACHINE, keyName)
+    try:
+        dllNames = win32api.RegQueryValueEx(handle, "EventMessageFile")[0].split(";")
+        # Win2k etc appear to allow multiple DLL names
+        data = None
+        for dllName in dllNames:
+            try:
+                # Expand environment variable strings in the message DLL path name,
+                # in case any are there.
+                dllName = win32api.ExpandEnvironmentStrings(dllName)
+
+                dllHandle = win32api.LoadLibraryEx(
+                    dllName, 0, win32con.LOAD_LIBRARY_AS_DATAFILE
+                )
+                try:
+                    data = win32api.FormatMessageW(
+                        win32con.FORMAT_MESSAGE_FROM_HMODULE,
+                        dllHandle,
+                        eventLogRecord.EventID,
+                        langid,
+                        eventLogRecord.StringInserts,
+                    )
+                finally:
+                    win32api.FreeLibrary(dllHandle)
+            except win32api.error:
+                pass  # Not in this DLL - try the next
+            if data is not None:
+                break
+    finally:
+        win32api.RegCloseKey(handle)
+    return data or ""  # Don't want "None" ever being returned.
+
+
+def SafeFormatMessage(eventLogRecord, logType=None):
+    """As for FormatMessage, except returns an error message if
+    the message can not be processed.
+    """
+    if logType is None:
+        logType = "Application"
+    try:
+        return FormatMessage(eventLogRecord, logType)
+    except win32api.error:
+        if eventLogRecord.StringInserts is None:
+            desc = ""
+        else:
+            desc = ", ".join(eventLogRecord.StringInserts)
+        return (
+            "<The description for Event ID ( %d ) in Source ( %r ) could not be found. It contains the following insertion string(s):%r.>"
+            % (
+                winerror.HRESULT_CODE(eventLogRecord.EventID),
+                eventLogRecord.SourceName,
+                desc,
+            )
+        )
+
+
+def FeedEventLogRecords(
+    feeder, machineName=None, logName="Application", readFlags=None
+):
+    if readFlags is None:
+        readFlags = (
+            win32evtlog.EVENTLOG_BACKWARDS_READ | win32evtlog.EVENTLOG_SEQUENTIAL_READ
+        )
+    h = win32evtlog.OpenEventLog(machineName, logName)
+    try:
+        while 1:
+            objects = win32evtlog.ReadEventLog(h, readFlags, 0)
+            if not objects:
+                break
+            map(lambda item, feeder=feeder: feeder(*(item,)), objects)
+    finally:
+        win32evtlog.CloseEventLog(h)
diff --git a/lib/win32/lib/win32gui_struct.py b/lib/win32/lib/win32gui_struct.py
new file mode 100644
index 00000000..86623ae3
--- /dev/null
+++ b/lib/win32/lib/win32gui_struct.py
@@ -0,0 +1,999 @@
+# This is a work in progress - see Demos/win32gui_menu.py
+
+# win32gui_struct.py - helpers for working with various win32gui structures.
+# As win32gui is "light-weight", it does not define objects for all possible
+# win32 structures - in general, "buffer" objects are passed around - it is
+# the callers responsibility to pack the buffer in the correct format.
+#
+# This module defines some helpers for the commonly used structures.
+#
+# In general, each structure has 3 functions:
+#
+# buffer, extras = PackSTRUCTURE(items, ...)
+# item, ... = UnpackSTRUCTURE(buffer)
+# buffer, extras = EmtpySTRUCTURE(...)
+#
+# 'extras' is always items that must be held along with the buffer, as the
+# buffer refers to these object's memory.
+# For structures that support a 'mask', this mask is hidden from the user - if
+# 'None' is passed, the mask flag will not be set, or on return, None will
+# be returned for the value if the mask is not set.
+#
+# NOTE: I considered making these structures look like real classes, and
+# support 'attributes' etc - however, ctypes already has a good structure
+# mechanism - I think it makes more sense to support ctype structures
+# at the win32gui level, then there will be no need for this module at all.
+# XXX - the above makes sense in terms of what is built and passed to
+# win32gui (ie, the Pack* functions) - but doesn't make as much sense for
+# the Unpack* functions, where the aim is user convenience.
+
+import array
+import struct
+import sys
+
+import commctrl
+import pywintypes
+import win32con
+import win32gui
+
+is64bit = "64 bit" in sys.version
+
+try:
+    from collections import namedtuple
+
+    def _MakeResult(names_str, values):
+        names = names_str.split()
+        nt = namedtuple(names[0], names[1:])
+        return nt(*values)
+
+except ImportError:
+    # no namedtuple support - just return the values as a normal tuple.
+    def _MakeResult(names_str, values):
+        return values
+
+
+_nmhdr_fmt = "PPi"
+if is64bit:
+    # When the item past the NMHDR gets aligned (eg, when it is a struct)
+    # we need this many bytes padding.
+    _nmhdr_align_padding = "xxxx"
+else:
+    _nmhdr_align_padding = ""
+
+# Encode a string suitable for passing in a win32gui related structure
+# If win32gui is built with UNICODE defined (ie, py3k), then functions
+# like InsertMenuItem are actually calling InsertMenuItemW etc, so all
+# strings will need to be unicode.
+if win32gui.UNICODE:
+
+    def _make_text_buffer(text):
+        # XXX - at this stage win32gui.UNICODE is only True in py3k,
+        # and in py3k is makes sense to reject bytes.
+        if not isinstance(text, str):
+            raise TypeError("MENUITEMINFO text must be unicode")
+        data = (text + "\0").encode("utf-16le")
+        return array.array("b", data)
+
+else:
+
+    def _make_text_buffer(text):
+        if isinstance(text, str):
+            text = text.encode("mbcs")
+        return array.array("b", text + "\0")
+
+
+# make an 'empty' buffer, ready for filling with cch characters.
+def _make_empty_text_buffer(cch):
+    return _make_text_buffer("\0" * cch)
+
+
+if sys.version_info < (3, 0):
+
+    def _make_memory(ob):
+        return str(buffer(ob))
+
+    def _make_bytes(sval):
+        return sval
+
+else:
+
+    def _make_memory(ob):
+        return bytes(memoryview(ob))
+
+    def _make_bytes(sval):
+        return sval.encode("ascii")
+
+
+# Generic WM_NOTIFY unpacking
+def UnpackWMNOTIFY(lparam):
+    format = "PPi"
+    buf = win32gui.PyGetMemory(lparam, struct.calcsize(format))
+    return _MakeResult("WMNOTIFY hwndFrom idFrom code", struct.unpack(format, buf))
+
+
+def UnpackNMITEMACTIVATE(lparam):
+    format = _nmhdr_fmt + _nmhdr_align_padding
+    if is64bit:
+        # the struct module doesn't handle this correctly as some of the items
+        # are actually structs in structs, which get individually aligned.
+        format = format + "iiiiiiixxxxP"
+    else:
+        format = format + "iiiiiiiP"
+    buf = win32gui.PyMakeBuffer(struct.calcsize(format), lparam)
+    return _MakeResult(
+        "NMITEMACTIVATE hwndFrom idFrom code iItem iSubItem uNewState uOldState uChanged actionx actiony lParam",
+        struct.unpack(format, buf),
+    )
+
+
+# MENUITEMINFO struct
+# http://msdn.microsoft.com/library/default.asp?url=/library/en-us/winui/WinUI/WindowsUserInterface/Resources/Menus/MenuReference/MenuStructures/MENUITEMINFO.asp
+# We use the struct module to pack and unpack strings as MENUITEMINFO
+# structures.  We also have special handling for the 'fMask' item in that
+# structure to avoid the caller needing to explicitly check validity
+# (None is used if the mask excludes/should exclude the value)
+_menuiteminfo_fmt = "5i5PiP"
+
+
+def PackMENUITEMINFO(
+    fType=None,
+    fState=None,
+    wID=None,
+    hSubMenu=None,
+    hbmpChecked=None,
+    hbmpUnchecked=None,
+    dwItemData=None,
+    text=None,
+    hbmpItem=None,
+    dwTypeData=None,
+):
+    # 'extras' are objects the caller must keep a reference to (as their
+    # memory is used) for the lifetime of the INFO item.
+    extras = []
+    # ack - dwItemData and dwTypeData were confused for a while...
+    assert (
+        dwItemData is None or dwTypeData is None
+    ), "sorry - these were confused - you probably want dwItemData"
+    # if we are a long way past 209, then we can nuke the above...
+    if dwTypeData is not None:
+        import warnings
+
+        warnings.warn("PackMENUITEMINFO: please use dwItemData instead of dwTypeData")
+    if dwItemData is None:
+        dwItemData = dwTypeData or 0
+
+    fMask = 0
+    if fType is None:
+        fType = 0
+    else:
+        fMask |= win32con.MIIM_FTYPE
+    if fState is None:
+        fState = 0
+    else:
+        fMask |= win32con.MIIM_STATE
+    if wID is None:
+        wID = 0
+    else:
+        fMask |= win32con.MIIM_ID
+    if hSubMenu is None:
+        hSubMenu = 0
+    else:
+        fMask |= win32con.MIIM_SUBMENU
+    if hbmpChecked is None:
+        assert hbmpUnchecked is None, "neither or both checkmark bmps must be given"
+        hbmpChecked = hbmpUnchecked = 0
+    else:
+        assert hbmpUnchecked is not None, "neither or both checkmark bmps must be given"
+        fMask |= win32con.MIIM_CHECKMARKS
+    if dwItemData is None:
+        dwItemData = 0
+    else:
+        fMask |= win32con.MIIM_DATA
+    if hbmpItem is None:
+        hbmpItem = 0
+    else:
+        fMask |= win32con.MIIM_BITMAP
+    if text is not None:
+        fMask |= win32con.MIIM_STRING
+        str_buf = _make_text_buffer(text)
+        cch = len(text)
+        # We are taking address of strbuf - it must not die until windows
+        # has finished with our structure.
+        lptext = str_buf.buffer_info()[0]
+        extras.append(str_buf)
+    else:
+        lptext = 0
+        cch = 0
+    # Create the struct.
+    # 'P' format does not accept PyHANDLE's !
+    item = struct.pack(
+        _menuiteminfo_fmt,
+        struct.calcsize(_menuiteminfo_fmt),  # cbSize
+        fMask,
+        fType,
+        fState,
+        wID,
+        int(hSubMenu),
+        int(hbmpChecked),
+        int(hbmpUnchecked),
+        dwItemData,
+        lptext,
+        cch,
+        int(hbmpItem),
+    )
+    # Now copy the string to a writable buffer, so that the result
+    # could be passed to a 'Get' function
+    return array.array("b", item), extras
+
+
+def UnpackMENUITEMINFO(s):
+    (
+        cb,
+        fMask,
+        fType,
+        fState,
+        wID,
+        hSubMenu,
+        hbmpChecked,
+        hbmpUnchecked,
+        dwItemData,
+        lptext,
+        cch,
+        hbmpItem,
+    ) = struct.unpack(_menuiteminfo_fmt, s)
+    assert cb == len(s)
+    if fMask & win32con.MIIM_FTYPE == 0:
+        fType = None
+    if fMask & win32con.MIIM_STATE == 0:
+        fState = None
+    if fMask & win32con.MIIM_ID == 0:
+        wID = None
+    if fMask & win32con.MIIM_SUBMENU == 0:
+        hSubMenu = None
+    if fMask & win32con.MIIM_CHECKMARKS == 0:
+        hbmpChecked = hbmpUnchecked = None
+    if fMask & win32con.MIIM_DATA == 0:
+        dwItemData = None
+    if fMask & win32con.MIIM_BITMAP == 0:
+        hbmpItem = None
+    if fMask & win32con.MIIM_STRING:
+        text = win32gui.PyGetString(lptext, cch)
+    else:
+        text = None
+    return _MakeResult(
+        "MENUITEMINFO fType fState wID hSubMenu hbmpChecked "
+        "hbmpUnchecked dwItemData text hbmpItem",
+        (
+            fType,
+            fState,
+            wID,
+            hSubMenu,
+            hbmpChecked,
+            hbmpUnchecked,
+            dwItemData,
+            text,
+            hbmpItem,
+        ),
+    )
+
+
+def EmptyMENUITEMINFO(mask=None, text_buf_size=512):
+    # text_buf_size is number of *characters* - not necessarily no of bytes.
+    extra = []
+    if mask is None:
+        mask = (
+            win32con.MIIM_BITMAP
+            | win32con.MIIM_CHECKMARKS
+            | win32con.MIIM_DATA
+            | win32con.MIIM_FTYPE
+            | win32con.MIIM_ID
+            | win32con.MIIM_STATE
+            | win32con.MIIM_STRING
+            | win32con.MIIM_SUBMENU
+        )
+        # Note: No MIIM_TYPE - this screws win2k/98.
+
+    if mask & win32con.MIIM_STRING:
+        text_buffer = _make_empty_text_buffer(text_buf_size)
+        extra.append(text_buffer)
+        text_addr, _ = text_buffer.buffer_info()
+    else:
+        text_addr = text_buf_size = 0
+
+    # Now copy the string to a writable buffer, so that the result
+    # could be passed to a 'Get' function
+    buf = struct.pack(
+        _menuiteminfo_fmt,
+        struct.calcsize(_menuiteminfo_fmt),  # cbSize
+        mask,
+        0,  # fType,
+        0,  # fState,
+        0,  # wID,
+        0,  # hSubMenu,
+        0,  # hbmpChecked,
+        0,  # hbmpUnchecked,
+        0,  # dwItemData,
+        text_addr,
+        text_buf_size,
+        0,  # hbmpItem
+    )
+    return array.array("b", buf), extra
+
+
+# MENUINFO struct
+_menuinfo_fmt = "iiiiPiP"
+
+
+def PackMENUINFO(
+    dwStyle=None,
+    cyMax=None,
+    hbrBack=None,
+    dwContextHelpID=None,
+    dwMenuData=None,
+    fMask=0,
+):
+    if dwStyle is None:
+        dwStyle = 0
+    else:
+        fMask |= win32con.MIM_STYLE
+    if cyMax is None:
+        cyMax = 0
+    else:
+        fMask |= win32con.MIM_MAXHEIGHT
+    if hbrBack is None:
+        hbrBack = 0
+    else:
+        fMask |= win32con.MIM_BACKGROUND
+    if dwContextHelpID is None:
+        dwContextHelpID = 0
+    else:
+        fMask |= win32con.MIM_HELPID
+    if dwMenuData is None:
+        dwMenuData = 0
+    else:
+        fMask |= win32con.MIM_MENUDATA
+    # Create the struct.
+    item = struct.pack(
+        _menuinfo_fmt,
+        struct.calcsize(_menuinfo_fmt),  # cbSize
+        fMask,
+        dwStyle,
+        cyMax,
+        hbrBack,
+        dwContextHelpID,
+        dwMenuData,
+    )
+    return array.array("b", item)
+
+
+def UnpackMENUINFO(s):
+    (cb, fMask, dwStyle, cyMax, hbrBack, dwContextHelpID, dwMenuData) = struct.unpack(
+        _menuinfo_fmt, s
+    )
+    assert cb == len(s)
+    if fMask & win32con.MIM_STYLE == 0:
+        dwStyle = None
+    if fMask & win32con.MIM_MAXHEIGHT == 0:
+        cyMax = None
+    if fMask & win32con.MIM_BACKGROUND == 0:
+        hbrBack = None
+    if fMask & win32con.MIM_HELPID == 0:
+        dwContextHelpID = None
+    if fMask & win32con.MIM_MENUDATA == 0:
+        dwMenuData = None
+    return _MakeResult(
+        "MENUINFO dwStyle cyMax hbrBack dwContextHelpID dwMenuData",
+        (dwStyle, cyMax, hbrBack, dwContextHelpID, dwMenuData),
+    )
+
+
+def EmptyMENUINFO(mask=None):
+    if mask is None:
+        mask = (
+            win32con.MIM_STYLE
+            | win32con.MIM_MAXHEIGHT
+            | win32con.MIM_BACKGROUND
+            | win32con.MIM_HELPID
+            | win32con.MIM_MENUDATA
+        )
+
+    buf = struct.pack(
+        _menuinfo_fmt,
+        struct.calcsize(_menuinfo_fmt),  # cbSize
+        mask,
+        0,  # dwStyle
+        0,  # cyMax
+        0,  # hbrBack,
+        0,  # dwContextHelpID,
+        0,  # dwMenuData,
+    )
+    return array.array("b", buf)
+
+
+##########################################################################
+#
+# Tree View structure support - TVITEM, TVINSERTSTRUCT and TVDISPINFO
+#
+##########################################################################
+
+# XXX - Note that the following implementation of TreeView structures is ripped
+# XXX - from the SpamBayes project.  It may not quite work correctly yet - I
+# XXX - intend checking them later - but having them is better than not at all!
+
+_tvitem_fmt = "iPiiPiiiiP"
+
+
+# Helpers for the ugly win32 structure packing/unpacking
+# XXX - Note that functions using _GetMaskAndVal run 3x faster if they are
+# 'inlined' into the function - see PackLVITEM.  If the profiler points at
+# _GetMaskAndVal(), you should nuke it (patches welcome once they have been
+# tested)
+def _GetMaskAndVal(val, default, mask, flag):
+    if val is None:
+        return mask, default
+    else:
+        if flag is not None:
+            mask |= flag
+        return mask, val
+
+
+def PackTVINSERTSTRUCT(parent, insertAfter, tvitem):
+    tvitem_buf, extra = PackTVITEM(*tvitem)
+    tvitem_buf = tvitem_buf.tobytes()
+    format = "PP%ds" % len(tvitem_buf)
+    return struct.pack(format, parent, insertAfter, tvitem_buf), extra
+
+
+def PackTVITEM(hitem, state, stateMask, text, image, selimage, citems, param):
+    extra = []  # objects we must keep references to
+    mask = 0
+    mask, hitem = _GetMaskAndVal(hitem, 0, mask, commctrl.TVIF_HANDLE)
+    mask, state = _GetMaskAndVal(state, 0, mask, commctrl.TVIF_STATE)
+    if not mask & commctrl.TVIF_STATE:
+        stateMask = 0
+    mask, text = _GetMaskAndVal(text, None, mask, commctrl.TVIF_TEXT)
+    mask, image = _GetMaskAndVal(image, 0, mask, commctrl.TVIF_IMAGE)
+    mask, selimage = _GetMaskAndVal(selimage, 0, mask, commctrl.TVIF_SELECTEDIMAGE)
+    mask, citems = _GetMaskAndVal(citems, 0, mask, commctrl.TVIF_CHILDREN)
+    mask, param = _GetMaskAndVal(param, 0, mask, commctrl.TVIF_PARAM)
+    if text is None:
+        text_addr = text_len = 0
+    else:
+        text_buffer = _make_text_buffer(text)
+        text_len = len(text)
+        extra.append(text_buffer)
+        text_addr, _ = text_buffer.buffer_info()
+    buf = struct.pack(
+        _tvitem_fmt,
+        mask,
+        hitem,
+        state,
+        stateMask,
+        text_addr,
+        text_len,  # text
+        image,
+        selimage,
+        citems,
+        param,
+    )
+    return array.array("b", buf), extra
+
+
+# Make a new buffer suitable for querying hitem's attributes.
+def EmptyTVITEM(hitem, mask=None, text_buf_size=512):
+    extra = []  # objects we must keep references to
+    if mask is None:
+        mask = (
+            commctrl.TVIF_HANDLE
+            | commctrl.TVIF_STATE
+            | commctrl.TVIF_TEXT
+            | commctrl.TVIF_IMAGE
+            | commctrl.TVIF_SELECTEDIMAGE
+            | commctrl.TVIF_CHILDREN
+            | commctrl.TVIF_PARAM
+        )
+    if mask & commctrl.TVIF_TEXT:
+        text_buffer = _make_empty_text_buffer(text_buf_size)
+        extra.append(text_buffer)
+        text_addr, _ = text_buffer.buffer_info()
+    else:
+        text_addr = text_buf_size = 0
+    buf = struct.pack(
+        _tvitem_fmt, mask, hitem, 0, 0, text_addr, text_buf_size, 0, 0, 0, 0  # text
+    )
+    return array.array("b", buf), extra
+
+
+def UnpackTVITEM(buffer):
+    (
+        item_mask,
+        item_hItem,
+        item_state,
+        item_stateMask,
+        item_textptr,
+        item_cchText,
+        item_image,
+        item_selimage,
+        item_cChildren,
+        item_param,
+    ) = struct.unpack(_tvitem_fmt, buffer)
+    # ensure only items listed by the mask are valid (except we assume the
+    # handle is always valid - some notifications (eg, TVN_ENDLABELEDIT) set a
+    # mask that doesn't include the handle, but the docs explicity say it is.)
+    if not (item_mask & commctrl.TVIF_TEXT):
+        item_textptr = item_cchText = None
+    if not (item_mask & commctrl.TVIF_CHILDREN):
+        item_cChildren = None
+    if not (item_mask & commctrl.TVIF_IMAGE):
+        item_image = None
+    if not (item_mask & commctrl.TVIF_PARAM):
+        item_param = None
+    if not (item_mask & commctrl.TVIF_SELECTEDIMAGE):
+        item_selimage = None
+    if not (item_mask & commctrl.TVIF_STATE):
+        item_state = item_stateMask = None
+
+    if item_textptr:
+        text = win32gui.PyGetString(item_textptr)
+    else:
+        text = None
+    return _MakeResult(
+        "TVITEM item_hItem item_state item_stateMask "
+        "text item_image item_selimage item_cChildren item_param",
+        (
+            item_hItem,
+            item_state,
+            item_stateMask,
+            text,
+            item_image,
+            item_selimage,
+            item_cChildren,
+            item_param,
+        ),
+    )
+
+
+# Unpack the lparm from a "TVNOTIFY" message
+def UnpackTVNOTIFY(lparam):
+    item_size = struct.calcsize(_tvitem_fmt)
+    format = _nmhdr_fmt + _nmhdr_align_padding
+    if is64bit:
+        format = format + "ixxxx"
+    else:
+        format = format + "i"
+    format = format + "%ds%ds" % (item_size, item_size)
+    buf = win32gui.PyGetMemory(lparam, struct.calcsize(format))
+    hwndFrom, id, code, action, buf_old, buf_new = struct.unpack(format, buf)
+    item_old = UnpackTVITEM(buf_old)
+    item_new = UnpackTVITEM(buf_new)
+    return _MakeResult(
+        "TVNOTIFY hwndFrom id code action item_old item_new",
+        (hwndFrom, id, code, action, item_old, item_new),
+    )
+
+
+def UnpackTVDISPINFO(lparam):
+    item_size = struct.calcsize(_tvitem_fmt)
+    format = "PPi%ds" % (item_size,)
+    buf = win32gui.PyGetMemory(lparam, struct.calcsize(format))
+    hwndFrom, id, code, buf_item = struct.unpack(format, buf)
+    item = UnpackTVITEM(buf_item)
+    return _MakeResult("TVDISPINFO hwndFrom id code item", (hwndFrom, id, code, item))
+
+
+#
+# List view items
+_lvitem_fmt = "iiiiiPiiPi"
+
+
+def PackLVITEM(
+    item=None,
+    subItem=None,
+    state=None,
+    stateMask=None,
+    text=None,
+    image=None,
+    param=None,
+    indent=None,
+):
+    extra = []  # objects we must keep references to
+    mask = 0
+    # _GetMaskAndVal adds quite a bit of overhead to this function.
+    if item is None:
+        item = 0  # No mask for item
+    if subItem is None:
+        subItem = 0  # No mask for sibItem
+    if state is None:
+        state = 0
+        stateMask = 0
+    else:
+        mask |= commctrl.LVIF_STATE
+        if stateMask is None:
+            stateMask = state
+
+    if image is None:
+        image = 0
+    else:
+        mask |= commctrl.LVIF_IMAGE
+    if param is None:
+        param = 0
+    else:
+        mask |= commctrl.LVIF_PARAM
+    if indent is None:
+        indent = 0
+    else:
+        mask |= commctrl.LVIF_INDENT
+
+    if text is None:
+        text_addr = text_len = 0
+    else:
+        mask |= commctrl.LVIF_TEXT
+        text_buffer = _make_text_buffer(text)
+        text_len = len(text)
+        extra.append(text_buffer)
+        text_addr, _ = text_buffer.buffer_info()
+    buf = struct.pack(
+        _lvitem_fmt,
+        mask,
+        item,
+        subItem,
+        state,
+        stateMask,
+        text_addr,
+        text_len,  # text
+        image,
+        param,
+        indent,
+    )
+    return array.array("b", buf), extra
+
+
+def UnpackLVITEM(buffer):
+    (
+        item_mask,
+        item_item,
+        item_subItem,
+        item_state,
+        item_stateMask,
+        item_textptr,
+        item_cchText,
+        item_image,
+        item_param,
+        item_indent,
+    ) = struct.unpack(_lvitem_fmt, buffer)
+    # ensure only items listed by the mask are valid
+    if not (item_mask & commctrl.LVIF_TEXT):
+        item_textptr = item_cchText = None
+    if not (item_mask & commctrl.LVIF_IMAGE):
+        item_image = None
+    if not (item_mask & commctrl.LVIF_PARAM):
+        item_param = None
+    if not (item_mask & commctrl.LVIF_INDENT):
+        item_indent = None
+    if not (item_mask & commctrl.LVIF_STATE):
+        item_state = item_stateMask = None
+
+    if item_textptr:
+        text = win32gui.PyGetString(item_textptr)
+    else:
+        text = None
+    return _MakeResult(
+        "LVITEM item_item item_subItem item_state "
+        "item_stateMask text item_image item_param item_indent",
+        (
+            item_item,
+            item_subItem,
+            item_state,
+            item_stateMask,
+            text,
+            item_image,
+            item_param,
+            item_indent,
+        ),
+    )
+
+
+# Unpack an "LVNOTIFY" message
+def UnpackLVDISPINFO(lparam):
+    item_size = struct.calcsize(_lvitem_fmt)
+    format = _nmhdr_fmt + _nmhdr_align_padding + ("%ds" % (item_size,))
+    buf = win32gui.PyGetMemory(lparam, struct.calcsize(format))
+    hwndFrom, id, code, buf_item = struct.unpack(format, buf)
+    item = UnpackLVITEM(buf_item)
+    return _MakeResult("LVDISPINFO hwndFrom id code item", (hwndFrom, id, code, item))
+
+
+def UnpackLVNOTIFY(lparam):
+    format = _nmhdr_fmt + _nmhdr_align_padding + "7i"
+    if is64bit:
+        format = format + "xxxx"  # point needs padding.
+    format = format + "P"
+    buf = win32gui.PyGetMemory(lparam, struct.calcsize(format))
+    (
+        hwndFrom,
+        id,
+        code,
+        item,
+        subitem,
+        newstate,
+        oldstate,
+        changed,
+        pt_x,
+        pt_y,
+        lparam,
+    ) = struct.unpack(format, buf)
+    return _MakeResult(
+        "UnpackLVNOTIFY hwndFrom id code item subitem "
+        "newstate oldstate changed pt lparam",
+        (
+            hwndFrom,
+            id,
+            code,
+            item,
+            subitem,
+            newstate,
+            oldstate,
+            changed,
+            (pt_x, pt_y),
+            lparam,
+        ),
+    )
+
+
+# Make a new buffer suitable for querying an items attributes.
+def EmptyLVITEM(item, subitem, mask=None, text_buf_size=512):
+    extra = []  # objects we must keep references to
+    if mask is None:
+        mask = (
+            commctrl.LVIF_IMAGE
+            | commctrl.LVIF_INDENT
+            | commctrl.LVIF_TEXT
+            | commctrl.LVIF_PARAM
+            | commctrl.LVIF_STATE
+        )
+    if mask & commctrl.LVIF_TEXT:
+        text_buffer = _make_empty_text_buffer(text_buf_size)
+        extra.append(text_buffer)
+        text_addr, _ = text_buffer.buffer_info()
+    else:
+        text_addr = text_buf_size = 0
+    buf = struct.pack(
+        _lvitem_fmt,
+        mask,
+        item,
+        subitem,
+        0,
+        0,
+        text_addr,
+        text_buf_size,  # text
+        0,
+        0,
+        0,
+    )
+    return array.array("b", buf), extra
+
+
+# List view column structure
+_lvcolumn_fmt = "iiiPiiii"
+
+
+def PackLVCOLUMN(fmt=None, cx=None, text=None, subItem=None, image=None, order=None):
+    extra = []  # objects we must keep references to
+    mask = 0
+    mask, fmt = _GetMaskAndVal(fmt, 0, mask, commctrl.LVCF_FMT)
+    mask, cx = _GetMaskAndVal(cx, 0, mask, commctrl.LVCF_WIDTH)
+    mask, text = _GetMaskAndVal(text, None, mask, commctrl.LVCF_TEXT)
+    mask, subItem = _GetMaskAndVal(subItem, 0, mask, commctrl.LVCF_SUBITEM)
+    mask, image = _GetMaskAndVal(image, 0, mask, commctrl.LVCF_IMAGE)
+    mask, order = _GetMaskAndVal(order, 0, mask, commctrl.LVCF_ORDER)
+    if text is None:
+        text_addr = text_len = 0
+    else:
+        text_buffer = _make_text_buffer(text)
+        extra.append(text_buffer)
+        text_addr, _ = text_buffer.buffer_info()
+        text_len = len(text)
+    buf = struct.pack(
+        _lvcolumn_fmt, mask, fmt, cx, text_addr, text_len, subItem, image, order  # text
+    )
+    return array.array("b", buf), extra
+
+
+def UnpackLVCOLUMN(lparam):
+    mask, fmt, cx, text_addr, text_size, subItem, image, order = struct.unpack(
+        _lvcolumn_fmt, lparam
+    )
+    # ensure only items listed by the mask are valid
+    if not (mask & commctrl.LVCF_FMT):
+        fmt = None
+    if not (mask & commctrl.LVCF_WIDTH):
+        cx = None
+    if not (mask & commctrl.LVCF_TEXT):
+        text_addr = text_size = None
+    if not (mask & commctrl.LVCF_SUBITEM):
+        subItem = None
+    if not (mask & commctrl.LVCF_IMAGE):
+        image = None
+    if not (mask & commctrl.LVCF_ORDER):
+        order = None
+    if text_addr:
+        text = win32gui.PyGetString(text_addr)
+    else:
+        text = None
+    return _MakeResult(
+        "LVCOLUMN fmt cx text subItem image order",
+        (fmt, cx, text, subItem, image, order),
+    )
+
+
+# Make a new buffer suitable for querying an items attributes.
+def EmptyLVCOLUMN(mask=None, text_buf_size=512):
+    extra = []  # objects we must keep references to
+    if mask is None:
+        mask = (
+            commctrl.LVCF_FMT
+            | commctrl.LVCF_WIDTH
+            | commctrl.LVCF_TEXT
+            | commctrl.LVCF_SUBITEM
+            | commctrl.LVCF_IMAGE
+            | commctrl.LVCF_ORDER
+        )
+    if mask & commctrl.LVCF_TEXT:
+        text_buffer = _make_empty_text_buffer(text_buf_size)
+        extra.append(text_buffer)
+        text_addr, _ = text_buffer.buffer_info()
+    else:
+        text_addr = text_buf_size = 0
+    buf = struct.pack(
+        _lvcolumn_fmt, mask, 0, 0, text_addr, text_buf_size, 0, 0, 0  # text
+    )
+    return array.array("b", buf), extra
+
+
+# List view hit-test.
+def PackLVHITTEST(pt):
+    format = "iiiii"
+    buf = struct.pack(format, pt[0], pt[1], 0, 0, 0)
+    return array.array("b", buf), None
+
+
+def UnpackLVHITTEST(buf):
+    format = "iiiii"
+    x, y, flags, item, subitem = struct.unpack(format, buf)
+    return _MakeResult(
+        "LVHITTEST pt flags item subitem", ((x, y), flags, item, subitem)
+    )
+
+
+def PackHDITEM(
+    cxy=None, text=None, hbm=None, fmt=None, param=None, image=None, order=None
+):
+    extra = []  # objects we must keep references to
+    mask = 0
+    mask, cxy = _GetMaskAndVal(cxy, 0, mask, commctrl.HDI_HEIGHT)
+    mask, text = _GetMaskAndVal(text, None, mask, commctrl.LVCF_TEXT)
+    mask, hbm = _GetMaskAndVal(hbm, 0, mask, commctrl.HDI_BITMAP)
+    mask, fmt = _GetMaskAndVal(fmt, 0, mask, commctrl.HDI_FORMAT)
+    mask, param = _GetMaskAndVal(param, 0, mask, commctrl.HDI_LPARAM)
+    mask, image = _GetMaskAndVal(image, 0, mask, commctrl.HDI_IMAGE)
+    mask, order = _GetMaskAndVal(order, 0, mask, commctrl.HDI_ORDER)
+
+    if text is None:
+        text_addr = text_len = 0
+    else:
+        text_buffer = _make_text_buffer(text)
+        extra.append(text_buffer)
+        text_addr, _ = text_buffer.buffer_info()
+        text_len = len(text)
+
+    format = "iiPPiiPiiii"
+    buf = struct.pack(
+        format, mask, cxy, text_addr, hbm, text_len, fmt, param, image, order, 0, 0
+    )
+    return array.array("b", buf), extra
+
+
+# Device notification stuff
+
+
+# Generic function for packing a DEV_BROADCAST_* structure - generally used
+# by the other PackDEV_BROADCAST_* functions in this module.
+def PackDEV_BROADCAST(devicetype, rest_fmt, rest_data, extra_data=_make_bytes("")):
+    # It seems a requirement is 4 byte alignment, even for the 'BYTE data[1]'
+    # field (eg, that would make DEV_BROADCAST_HANDLE 41 bytes, but we must
+    # be 44.
+    extra_data += _make_bytes("\0" * (4 - len(extra_data) % 4))
+    format = "iii" + rest_fmt
+    full_size = struct.calcsize(format) + len(extra_data)
+    data = (full_size, devicetype, 0) + rest_data
+    return struct.pack(format, *data) + extra_data
+
+
+def PackDEV_BROADCAST_HANDLE(
+    handle,
+    hdevnotify=0,
+    guid=_make_bytes("\0" * 16),
+    name_offset=0,
+    data=_make_bytes("\0"),
+):
+    return PackDEV_BROADCAST(
+        win32con.DBT_DEVTYP_HANDLE,
+        "PP16sl",
+        (int(handle), int(hdevnotify), _make_memory(guid), name_offset),
+        data,
+    )
+
+
+def PackDEV_BROADCAST_VOLUME(unitmask, flags):
+    return PackDEV_BROADCAST(win32con.DBT_DEVTYP_VOLUME, "II", (unitmask, flags))
+
+
+def PackDEV_BROADCAST_DEVICEINTERFACE(classguid, name=""):
+    if win32gui.UNICODE:
+        # This really means "is py3k?" - so not accepting bytes is OK
+        if not isinstance(name, str):
+            raise TypeError("Must provide unicode for the name")
+        name = name.encode("utf-16le")
+    else:
+        # py2k was passed a unicode object - encode as mbcs.
+        if isinstance(name, str):
+            name = name.encode("mbcs")
+
+    # 16 bytes for the IID followed by \0 term'd string.
+    rest_fmt = "16s%ds" % len(name)
+    # _make_memory(iid) hoops necessary to get the raw IID bytes.
+    rest_data = (_make_memory(pywintypes.IID(classguid)), name)
+    return PackDEV_BROADCAST(win32con.DBT_DEVTYP_DEVICEINTERFACE, rest_fmt, rest_data)
+
+
+# An object returned by UnpackDEV_BROADCAST.
+class DEV_BROADCAST_INFO:
+    def __init__(self, devicetype, **kw):
+        self.devicetype = devicetype
+        self.__dict__.update(kw)
+
+    def __str__(self):
+        return "DEV_BROADCAST_INFO:" + str(self.__dict__)
+
+
+# Support for unpacking the 'lparam'
+def UnpackDEV_BROADCAST(lparam):
+    if lparam == 0:
+        return None
+    hdr_format = "iii"
+    hdr_size = struct.calcsize(hdr_format)
+    hdr_buf = win32gui.PyGetMemory(lparam, hdr_size)
+    size, devtype, reserved = struct.unpack("iii", hdr_buf)
+    # Due to x64 alignment issues, we need to use the full format string over
+    # the entire buffer.  ie, on x64:
+    # calcsize('iiiP') != calcsize('iii')+calcsize('P')
+    buf = win32gui.PyGetMemory(lparam, size)
+
+    extra = x = {}
+    if devtype == win32con.DBT_DEVTYP_HANDLE:
+        # 2 handles, a GUID, a LONG and possibly an array following...
+        fmt = hdr_format + "PP16sl"
+        (
+            _,
+            _,
+            _,
+            x["handle"],
+            x["hdevnotify"],
+            guid_bytes,
+            x["nameoffset"],
+        ) = struct.unpack(fmt, buf[: struct.calcsize(fmt)])
+        x["eventguid"] = pywintypes.IID(guid_bytes, True)
+    elif devtype == win32con.DBT_DEVTYP_DEVICEINTERFACE:
+        fmt = hdr_format + "16s"
+        _, _, _, guid_bytes = struct.unpack(fmt, buf[: struct.calcsize(fmt)])
+        x["classguid"] = pywintypes.IID(guid_bytes, True)
+        x["name"] = win32gui.PyGetString(lparam + struct.calcsize(fmt))
+    elif devtype == win32con.DBT_DEVTYP_VOLUME:
+        # int mask and flags
+        fmt = hdr_format + "II"
+        _, _, _, x["unitmask"], x["flags"] = struct.unpack(
+            fmt, buf[: struct.calcsize(fmt)]
+        )
+    else:
+        raise NotImplementedError("unknown device type %d" % (devtype,))
+    return DEV_BROADCAST_INFO(devtype, **extra)
diff --git a/lib/win32/lib/win32inetcon.py b/lib/win32/lib/win32inetcon.py
new file mode 100644
index 00000000..b6e8e672
--- /dev/null
+++ b/lib/win32/lib/win32inetcon.py
@@ -0,0 +1,1086 @@
+# Generated by h2py from \mssdk\include\WinInet.h
+
+INTERNET_INVALID_PORT_NUMBER = 0
+INTERNET_DEFAULT_PORT = 0
+INTERNET_DEFAULT_FTP_PORT = 21
+INTERNET_DEFAULT_GOPHER_PORT = 70
+INTERNET_DEFAULT_HTTP_PORT = 80
+INTERNET_DEFAULT_HTTPS_PORT = 443
+INTERNET_DEFAULT_SOCKS_PORT = 1080
+INTERNET_MAX_HOST_NAME_LENGTH = 256
+INTERNET_MAX_USER_NAME_LENGTH = 128
+INTERNET_MAX_PASSWORD_LENGTH = 128
+INTERNET_MAX_PORT_NUMBER_LENGTH = 5
+INTERNET_MAX_PORT_NUMBER_VALUE = 65535
+INTERNET_MAX_PATH_LENGTH = 2048
+INTERNET_MAX_SCHEME_LENGTH = 32
+INTERNET_KEEP_ALIVE_ENABLED = 1
+INTERNET_KEEP_ALIVE_DISABLED = 0
+INTERNET_REQFLAG_FROM_CACHE = 0x00000001
+INTERNET_REQFLAG_ASYNC = 0x00000002
+INTERNET_REQFLAG_VIA_PROXY = 0x00000004
+INTERNET_REQFLAG_NO_HEADERS = 0x00000008
+INTERNET_REQFLAG_PASSIVE = 0x00000010
+INTERNET_REQFLAG_CACHE_WRITE_DISABLED = 0x00000040
+INTERNET_REQFLAG_NET_TIMEOUT = 0x00000080
+INTERNET_FLAG_RELOAD = -2147483648
+INTERNET_FLAG_RAW_DATA = 0x40000000
+INTERNET_FLAG_EXISTING_CONNECT = 0x20000000
+INTERNET_FLAG_ASYNC = 0x10000000
+INTERNET_FLAG_PASSIVE = 0x08000000
+INTERNET_FLAG_NO_CACHE_WRITE = 0x04000000
+INTERNET_FLAG_DONT_CACHE = INTERNET_FLAG_NO_CACHE_WRITE
+INTERNET_FLAG_MAKE_PERSISTENT = 0x02000000
+INTERNET_FLAG_FROM_CACHE = 0x01000000
+INTERNET_FLAG_OFFLINE = INTERNET_FLAG_FROM_CACHE
+INTERNET_FLAG_SECURE = 0x00800000
+INTERNET_FLAG_KEEP_CONNECTION = 0x00400000
+INTERNET_FLAG_NO_AUTO_REDIRECT = 0x00200000
+INTERNET_FLAG_READ_PREFETCH = 0x00100000
+INTERNET_FLAG_NO_COOKIES = 0x00080000
+INTERNET_FLAG_NO_AUTH = 0x00040000
+INTERNET_FLAG_RESTRICTED_ZONE = 0x00020000
+INTERNET_FLAG_CACHE_IF_NET_FAIL = 0x00010000
+INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTP = 0x00008000
+INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTPS = 0x00004000
+INTERNET_FLAG_IGNORE_CERT_DATE_INVALID = 0x00002000
+INTERNET_FLAG_IGNORE_CERT_CN_INVALID = 0x00001000
+INTERNET_FLAG_RESYNCHRONIZE = 0x00000800
+INTERNET_FLAG_HYPERLINK = 0x00000400
+INTERNET_FLAG_NO_UI = 0x00000200
+INTERNET_FLAG_PRAGMA_NOCACHE = 0x00000100
+INTERNET_FLAG_CACHE_ASYNC = 0x00000080
+INTERNET_FLAG_FORMS_SUBMIT = 0x00000040
+INTERNET_FLAG_FWD_BACK = 0x00000020
+INTERNET_FLAG_NEED_FILE = 0x00000010
+INTERNET_FLAG_MUST_CACHE_REQUEST = INTERNET_FLAG_NEED_FILE
+SECURITY_INTERNET_MASK = (
+    INTERNET_FLAG_IGNORE_CERT_CN_INVALID
+    | INTERNET_FLAG_IGNORE_CERT_DATE_INVALID
+    | INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTPS
+    | INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTP
+)
+INTERNET_ERROR_MASK_INSERT_CDROM = 0x1
+INTERNET_ERROR_MASK_COMBINED_SEC_CERT = 0x2
+INTERNET_ERROR_MASK_NEED_MSN_SSPI_PKG = 0x4
+INTERNET_ERROR_MASK_LOGIN_FAILURE_DISPLAY_ENTITY_BODY = 0x8
+WININET_API_FLAG_ASYNC = 0x00000001
+WININET_API_FLAG_SYNC = 0x00000004
+WININET_API_FLAG_USE_CONTEXT = 0x00000008
+INTERNET_NO_CALLBACK = 0
+IDSI_FLAG_KEEP_ALIVE = 0x00000001
+IDSI_FLAG_SECURE = 0x00000002
+IDSI_FLAG_PROXY = 0x00000004
+IDSI_FLAG_TUNNEL = 0x00000008
+INTERNET_PER_CONN_FLAGS = 1
+INTERNET_PER_CONN_PROXY_SERVER = 2
+INTERNET_PER_CONN_PROXY_BYPASS = 3
+INTERNET_PER_CONN_AUTOCONFIG_URL = 4
+INTERNET_PER_CONN_AUTODISCOVERY_FLAGS = 5
+INTERNET_PER_CONN_AUTOCONFIG_SECONDARY_URL = 6
+INTERNET_PER_CONN_AUTOCONFIG_RELOAD_DELAY_MINS = 7
+INTERNET_PER_CONN_AUTOCONFIG_LAST_DETECT_TIME = 8
+INTERNET_PER_CONN_AUTOCONFIG_LAST_DETECT_URL = 9
+PROXY_TYPE_DIRECT = 0x00000001
+PROXY_TYPE_PROXY = 0x00000002
+PROXY_TYPE_AUTO_PROXY_URL = 0x00000004
+PROXY_TYPE_AUTO_DETECT = 0x00000008
+AUTO_PROXY_FLAG_USER_SET = 0x00000001
+AUTO_PROXY_FLAG_ALWAYS_DETECT = 0x00000002
+AUTO_PROXY_FLAG_DETECTION_RUN = 0x00000004
+AUTO_PROXY_FLAG_MIGRATED = 0x00000008
+AUTO_PROXY_FLAG_DONT_CACHE_PROXY_RESULT = 0x00000010
+AUTO_PROXY_FLAG_CACHE_INIT_RUN = 0x00000020
+AUTO_PROXY_FLAG_DETECTION_SUSPECT = 0x00000040
+ISO_FORCE_DISCONNECTED = 0x00000001
+INTERNET_RFC1123_FORMAT = 0
+INTERNET_RFC1123_BUFSIZE = 30
+ICU_ESCAPE = -2147483648
+ICU_ESCAPE_AUTHORITY = 0x00002000
+ICU_REJECT_USERPWD = 0x00004000
+ICU_USERNAME = 0x40000000
+ICU_NO_ENCODE = 0x20000000
+ICU_DECODE = 0x10000000
+ICU_NO_META = 0x08000000
+ICU_ENCODE_SPACES_ONLY = 0x04000000
+ICU_BROWSER_MODE = 0x02000000
+ICU_ENCODE_PERCENT = 0x00001000
+INTERNET_OPEN_TYPE_PRECONFIG = 0
+INTERNET_OPEN_TYPE_DIRECT = 1
+INTERNET_OPEN_TYPE_PROXY = 3
+INTERNET_OPEN_TYPE_PRECONFIG_WITH_NO_AUTOPROXY = 4
+PRE_CONFIG_INTERNET_ACCESS = INTERNET_OPEN_TYPE_PRECONFIG
+LOCAL_INTERNET_ACCESS = INTERNET_OPEN_TYPE_DIRECT
+CERN_PROXY_INTERNET_ACCESS = INTERNET_OPEN_TYPE_PROXY
+INTERNET_SERVICE_FTP = 1
+INTERNET_SERVICE_GOPHER = 2
+INTERNET_SERVICE_HTTP = 3
+IRF_ASYNC = WININET_API_FLAG_ASYNC
+IRF_SYNC = WININET_API_FLAG_SYNC
+IRF_USE_CONTEXT = WININET_API_FLAG_USE_CONTEXT
+IRF_NO_WAIT = 0x00000008
+ISO_GLOBAL = 0x00000001
+ISO_REGISTRY = 0x00000002
+ISO_VALID_FLAGS = ISO_GLOBAL | ISO_REGISTRY
+INTERNET_OPTION_CALLBACK = 1
+INTERNET_OPTION_CONNECT_TIMEOUT = 2
+INTERNET_OPTION_CONNECT_RETRIES = 3
+INTERNET_OPTION_CONNECT_BACKOFF = 4
+INTERNET_OPTION_SEND_TIMEOUT = 5
+INTERNET_OPTION_CONTROL_SEND_TIMEOUT = INTERNET_OPTION_SEND_TIMEOUT
+INTERNET_OPTION_RECEIVE_TIMEOUT = 6
+INTERNET_OPTION_CONTROL_RECEIVE_TIMEOUT = INTERNET_OPTION_RECEIVE_TIMEOUT
+INTERNET_OPTION_DATA_SEND_TIMEOUT = 7
+INTERNET_OPTION_DATA_RECEIVE_TIMEOUT = 8
+INTERNET_OPTION_HANDLE_TYPE = 9
+INTERNET_OPTION_LISTEN_TIMEOUT = 11
+INTERNET_OPTION_READ_BUFFER_SIZE = 12
+INTERNET_OPTION_WRITE_BUFFER_SIZE = 13
+INTERNET_OPTION_ASYNC_ID = 15
+INTERNET_OPTION_ASYNC_PRIORITY = 16
+INTERNET_OPTION_PARENT_HANDLE = 21
+INTERNET_OPTION_KEEP_CONNECTION = 22
+INTERNET_OPTION_REQUEST_FLAGS = 23
+INTERNET_OPTION_EXTENDED_ERROR = 24
+INTERNET_OPTION_OFFLINE_MODE = 26
+INTERNET_OPTION_CACHE_STREAM_HANDLE = 27
+INTERNET_OPTION_USERNAME = 28
+INTERNET_OPTION_PASSWORD = 29
+INTERNET_OPTION_ASYNC = 30
+INTERNET_OPTION_SECURITY_FLAGS = 31
+INTERNET_OPTION_SECURITY_CERTIFICATE_STRUCT = 32
+INTERNET_OPTION_DATAFILE_NAME = 33
+INTERNET_OPTION_URL = 34
+INTERNET_OPTION_SECURITY_CERTIFICATE = 35
+INTERNET_OPTION_SECURITY_KEY_BITNESS = 36
+INTERNET_OPTION_REFRESH = 37
+INTERNET_OPTION_PROXY = 38
+INTERNET_OPTION_SETTINGS_CHANGED = 39
+INTERNET_OPTION_VERSION = 40
+INTERNET_OPTION_USER_AGENT = 41
+INTERNET_OPTION_END_BROWSER_SESSION = 42
+INTERNET_OPTION_PROXY_USERNAME = 43
+INTERNET_OPTION_PROXY_PASSWORD = 44
+INTERNET_OPTION_CONTEXT_VALUE = 45
+INTERNET_OPTION_CONNECT_LIMIT = 46
+INTERNET_OPTION_SECURITY_SELECT_CLIENT_CERT = 47
+INTERNET_OPTION_POLICY = 48
+INTERNET_OPTION_DISCONNECTED_TIMEOUT = 49
+INTERNET_OPTION_CONNECTED_STATE = 50
+INTERNET_OPTION_IDLE_STATE = 51
+INTERNET_OPTION_OFFLINE_SEMANTICS = 52
+INTERNET_OPTION_SECONDARY_CACHE_KEY = 53
+INTERNET_OPTION_CALLBACK_FILTER = 54
+INTERNET_OPTION_CONNECT_TIME = 55
+INTERNET_OPTION_SEND_THROUGHPUT = 56
+INTERNET_OPTION_RECEIVE_THROUGHPUT = 57
+INTERNET_OPTION_REQUEST_PRIORITY = 58
+INTERNET_OPTION_HTTP_VERSION = 59
+INTERNET_OPTION_RESET_URLCACHE_SESSION = 60
+INTERNET_OPTION_ERROR_MASK = 62
+INTERNET_OPTION_FROM_CACHE_TIMEOUT = 63
+INTERNET_OPTION_BYPASS_EDITED_ENTRY = 64
+INTERNET_OPTION_DIAGNOSTIC_SOCKET_INFO = 67
+INTERNET_OPTION_CODEPAGE = 68
+INTERNET_OPTION_CACHE_TIMESTAMPS = 69
+INTERNET_OPTION_DISABLE_AUTODIAL = 70
+INTERNET_OPTION_MAX_CONNS_PER_SERVER = 73
+INTERNET_OPTION_MAX_CONNS_PER_1_0_SERVER = 74
+INTERNET_OPTION_PER_CONNECTION_OPTION = 75
+INTERNET_OPTION_DIGEST_AUTH_UNLOAD = 76
+INTERNET_OPTION_IGNORE_OFFLINE = 77
+INTERNET_OPTION_IDENTITY = 78
+INTERNET_OPTION_REMOVE_IDENTITY = 79
+INTERNET_OPTION_ALTER_IDENTITY = 80
+INTERNET_OPTION_SUPPRESS_BEHAVIOR = 81
+INTERNET_OPTION_AUTODIAL_MODE = 82
+INTERNET_OPTION_AUTODIAL_CONNECTION = 83
+INTERNET_OPTION_CLIENT_CERT_CONTEXT = 84
+INTERNET_OPTION_AUTH_FLAGS = 85
+INTERNET_OPTION_COOKIES_3RD_PARTY = 86
+INTERNET_OPTION_DISABLE_PASSPORT_AUTH = 87
+INTERNET_OPTION_SEND_UTF8_SERVERNAME_TO_PROXY = 88
+INTERNET_OPTION_EXEMPT_CONNECTION_LIMIT = 89
+INTERNET_OPTION_ENABLE_PASSPORT_AUTH = 90
+INTERNET_OPTION_HIBERNATE_INACTIVE_WORKER_THREADS = 91
+INTERNET_OPTION_ACTIVATE_WORKER_THREADS = 92
+INTERNET_OPTION_RESTORE_WORKER_THREAD_DEFAULTS = 93
+INTERNET_OPTION_SOCKET_SEND_BUFFER_LENGTH = 94
+INTERNET_OPTION_PROXY_SETTINGS_CHANGED = 95
+INTERNET_FIRST_OPTION = INTERNET_OPTION_CALLBACK
+INTERNET_LAST_OPTION = INTERNET_OPTION_PROXY_SETTINGS_CHANGED
+INTERNET_PRIORITY_FOREGROUND = 1000
+INTERNET_HANDLE_TYPE_INTERNET = 1
+INTERNET_HANDLE_TYPE_CONNECT_FTP = 2
+INTERNET_HANDLE_TYPE_CONNECT_GOPHER = 3
+INTERNET_HANDLE_TYPE_CONNECT_HTTP = 4
+INTERNET_HANDLE_TYPE_FTP_FIND = 5
+INTERNET_HANDLE_TYPE_FTP_FIND_HTML = 6
+INTERNET_HANDLE_TYPE_FTP_FILE = 7
+INTERNET_HANDLE_TYPE_FTP_FILE_HTML = 8
+INTERNET_HANDLE_TYPE_GOPHER_FIND = 9
+INTERNET_HANDLE_TYPE_GOPHER_FIND_HTML = 10
+INTERNET_HANDLE_TYPE_GOPHER_FILE = 11
+INTERNET_HANDLE_TYPE_GOPHER_FILE_HTML = 12
+INTERNET_HANDLE_TYPE_HTTP_REQUEST = 13
+INTERNET_HANDLE_TYPE_FILE_REQUEST = 14
+AUTH_FLAG_DISABLE_NEGOTIATE = 0x00000001
+AUTH_FLAG_ENABLE_NEGOTIATE = 0x00000002
+SECURITY_FLAG_SECURE = 0x00000001
+SECURITY_FLAG_STRENGTH_WEAK = 0x10000000
+SECURITY_FLAG_STRENGTH_MEDIUM = 0x40000000
+SECURITY_FLAG_STRENGTH_STRONG = 0x20000000
+SECURITY_FLAG_UNKNOWNBIT = -2147483648
+SECURITY_FLAG_FORTEZZA = 0x08000000
+SECURITY_FLAG_NORMALBITNESS = SECURITY_FLAG_STRENGTH_WEAK
+SECURITY_FLAG_SSL = 0x00000002
+SECURITY_FLAG_SSL3 = 0x00000004
+SECURITY_FLAG_PCT = 0x00000008
+SECURITY_FLAG_PCT4 = 0x00000010
+SECURITY_FLAG_IETFSSL4 = 0x00000020
+SECURITY_FLAG_40BIT = SECURITY_FLAG_STRENGTH_WEAK
+SECURITY_FLAG_128BIT = SECURITY_FLAG_STRENGTH_STRONG
+SECURITY_FLAG_56BIT = SECURITY_FLAG_STRENGTH_MEDIUM
+SECURITY_FLAG_IGNORE_REVOCATION = 0x00000080
+SECURITY_FLAG_IGNORE_UNKNOWN_CA = 0x00000100
+SECURITY_FLAG_IGNORE_WRONG_USAGE = 0x00000200
+SECURITY_FLAG_IGNORE_CERT_CN_INVALID = INTERNET_FLAG_IGNORE_CERT_CN_INVALID
+SECURITY_FLAG_IGNORE_CERT_DATE_INVALID = INTERNET_FLAG_IGNORE_CERT_DATE_INVALID
+SECURITY_FLAG_IGNORE_CERT_WRONG_USAGE = 0x00000200
+SECURITY_FLAG_IGNORE_REDIRECT_TO_HTTPS = INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTPS
+SECURITY_FLAG_IGNORE_REDIRECT_TO_HTTP = INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTP
+SECURITY_SET_MASK = (
+    SECURITY_FLAG_IGNORE_REVOCATION
+    | SECURITY_FLAG_IGNORE_UNKNOWN_CA
+    | SECURITY_FLAG_IGNORE_CERT_CN_INVALID
+    | SECURITY_FLAG_IGNORE_CERT_DATE_INVALID
+    | SECURITY_FLAG_IGNORE_WRONG_USAGE
+)
+AUTODIAL_MODE_NEVER = 1
+AUTODIAL_MODE_ALWAYS = 2
+AUTODIAL_MODE_NO_NETWORK_PRESENT = 4
+INTERNET_STATUS_RESOLVING_NAME = 10
+INTERNET_STATUS_NAME_RESOLVED = 11
+INTERNET_STATUS_CONNECTING_TO_SERVER = 20
+INTERNET_STATUS_CONNECTED_TO_SERVER = 21
+INTERNET_STATUS_SENDING_REQUEST = 30
+INTERNET_STATUS_REQUEST_SENT = 31
+INTERNET_STATUS_RECEIVING_RESPONSE = 40
+INTERNET_STATUS_RESPONSE_RECEIVED = 41
+INTERNET_STATUS_CTL_RESPONSE_RECEIVED = 42
+INTERNET_STATUS_PREFETCH = 43
+INTERNET_STATUS_CLOSING_CONNECTION = 50
+INTERNET_STATUS_CONNECTION_CLOSED = 51
+INTERNET_STATUS_HANDLE_CREATED = 60
+INTERNET_STATUS_HANDLE_CLOSING = 70
+INTERNET_STATUS_DETECTING_PROXY = 80
+INTERNET_STATUS_REQUEST_COMPLETE = 100
+INTERNET_STATUS_REDIRECT = 110
+INTERNET_STATUS_INTERMEDIATE_RESPONSE = 120
+INTERNET_STATUS_USER_INPUT_REQUIRED = 140
+INTERNET_STATUS_STATE_CHANGE = 200
+INTERNET_STATUS_COOKIE_SENT = 320
+INTERNET_STATUS_COOKIE_RECEIVED = 321
+INTERNET_STATUS_PRIVACY_IMPACTED = 324
+INTERNET_STATUS_P3P_HEADER = 325
+INTERNET_STATUS_P3P_POLICYREF = 326
+INTERNET_STATUS_COOKIE_HISTORY = 327
+INTERNET_STATE_CONNECTED = 0x00000001
+INTERNET_STATE_DISCONNECTED = 0x00000002
+INTERNET_STATE_DISCONNECTED_BY_USER = 0x00000010
+INTERNET_STATE_IDLE = 0x00000100
+INTERNET_STATE_BUSY = 0x00000200
+FTP_TRANSFER_TYPE_UNKNOWN = 0x00000000
+FTP_TRANSFER_TYPE_ASCII = 0x00000001
+FTP_TRANSFER_TYPE_BINARY = 0x00000002
+FTP_TRANSFER_TYPE_MASK = FTP_TRANSFER_TYPE_ASCII | FTP_TRANSFER_TYPE_BINARY
+MAX_GOPHER_DISPLAY_TEXT = 128
+MAX_GOPHER_SELECTOR_TEXT = 256
+MAX_GOPHER_HOST_NAME = INTERNET_MAX_HOST_NAME_LENGTH
+MAX_GOPHER_LOCATOR_LENGTH = (
+    1
+    + MAX_GOPHER_DISPLAY_TEXT
+    + 1
+    + MAX_GOPHER_SELECTOR_TEXT
+    + 1
+    + MAX_GOPHER_HOST_NAME
+    + 1
+    + INTERNET_MAX_PORT_NUMBER_LENGTH
+    + 1
+    + 1
+    + 2
+)
+GOPHER_TYPE_TEXT_FILE = 0x00000001
+GOPHER_TYPE_DIRECTORY = 0x00000002
+GOPHER_TYPE_CSO = 0x00000004
+GOPHER_TYPE_ERROR = 0x00000008
+GOPHER_TYPE_MAC_BINHEX = 0x00000010
+GOPHER_TYPE_DOS_ARCHIVE = 0x00000020
+GOPHER_TYPE_UNIX_UUENCODED = 0x00000040
+GOPHER_TYPE_INDEX_SERVER = 0x00000080
+GOPHER_TYPE_TELNET = 0x00000100
+GOPHER_TYPE_BINARY = 0x00000200
+GOPHER_TYPE_REDUNDANT = 0x00000400
+GOPHER_TYPE_TN3270 = 0x00000800
+GOPHER_TYPE_GIF = 0x00001000
+GOPHER_TYPE_IMAGE = 0x00002000
+GOPHER_TYPE_BITMAP = 0x00004000
+GOPHER_TYPE_MOVIE = 0x00008000
+GOPHER_TYPE_SOUND = 0x00010000
+GOPHER_TYPE_HTML = 0x00020000
+GOPHER_TYPE_PDF = 0x00040000
+GOPHER_TYPE_CALENDAR = 0x00080000
+GOPHER_TYPE_INLINE = 0x00100000
+GOPHER_TYPE_UNKNOWN = 0x20000000
+GOPHER_TYPE_ASK = 0x40000000
+GOPHER_TYPE_GOPHER_PLUS = -2147483648
+GOPHER_TYPE_FILE_MASK = (
+    GOPHER_TYPE_TEXT_FILE
+    | GOPHER_TYPE_MAC_BINHEX
+    | GOPHER_TYPE_DOS_ARCHIVE
+    | GOPHER_TYPE_UNIX_UUENCODED
+    | GOPHER_TYPE_BINARY
+    | GOPHER_TYPE_GIF
+    | GOPHER_TYPE_IMAGE
+    | GOPHER_TYPE_BITMAP
+    | GOPHER_TYPE_MOVIE
+    | GOPHER_TYPE_SOUND
+    | GOPHER_TYPE_HTML
+    | GOPHER_TYPE_PDF
+    | GOPHER_TYPE_CALENDAR
+    | GOPHER_TYPE_INLINE
+)
+MAX_GOPHER_CATEGORY_NAME = 128
+MAX_GOPHER_ATTRIBUTE_NAME = 128
+MIN_GOPHER_ATTRIBUTE_LENGTH = 256
+GOPHER_ATTRIBUTE_ID_BASE = -1412641792
+GOPHER_CATEGORY_ID_ALL = GOPHER_ATTRIBUTE_ID_BASE + 1
+GOPHER_CATEGORY_ID_INFO = GOPHER_ATTRIBUTE_ID_BASE + 2
+GOPHER_CATEGORY_ID_ADMIN = GOPHER_ATTRIBUTE_ID_BASE + 3
+GOPHER_CATEGORY_ID_VIEWS = GOPHER_ATTRIBUTE_ID_BASE + 4
+GOPHER_CATEGORY_ID_ABSTRACT = GOPHER_ATTRIBUTE_ID_BASE + 5
+GOPHER_CATEGORY_ID_VERONICA = GOPHER_ATTRIBUTE_ID_BASE + 6
+GOPHER_CATEGORY_ID_ASK = GOPHER_ATTRIBUTE_ID_BASE + 7
+GOPHER_CATEGORY_ID_UNKNOWN = GOPHER_ATTRIBUTE_ID_BASE + 8
+GOPHER_ATTRIBUTE_ID_ALL = GOPHER_ATTRIBUTE_ID_BASE + 9
+GOPHER_ATTRIBUTE_ID_ADMIN = GOPHER_ATTRIBUTE_ID_BASE + 10
+GOPHER_ATTRIBUTE_ID_MOD_DATE = GOPHER_ATTRIBUTE_ID_BASE + 11
+GOPHER_ATTRIBUTE_ID_TTL = GOPHER_ATTRIBUTE_ID_BASE + 12
+GOPHER_ATTRIBUTE_ID_SCORE = GOPHER_ATTRIBUTE_ID_BASE + 13
+GOPHER_ATTRIBUTE_ID_RANGE = GOPHER_ATTRIBUTE_ID_BASE + 14
+GOPHER_ATTRIBUTE_ID_SITE = GOPHER_ATTRIBUTE_ID_BASE + 15
+GOPHER_ATTRIBUTE_ID_ORG = GOPHER_ATTRIBUTE_ID_BASE + 16
+GOPHER_ATTRIBUTE_ID_LOCATION = GOPHER_ATTRIBUTE_ID_BASE + 17
+GOPHER_ATTRIBUTE_ID_GEOG = GOPHER_ATTRIBUTE_ID_BASE + 18
+GOPHER_ATTRIBUTE_ID_TIMEZONE = GOPHER_ATTRIBUTE_ID_BASE + 19
+GOPHER_ATTRIBUTE_ID_PROVIDER = GOPHER_ATTRIBUTE_ID_BASE + 20
+GOPHER_ATTRIBUTE_ID_VERSION = GOPHER_ATTRIBUTE_ID_BASE + 21
+GOPHER_ATTRIBUTE_ID_ABSTRACT = GOPHER_ATTRIBUTE_ID_BASE + 22
+GOPHER_ATTRIBUTE_ID_VIEW = GOPHER_ATTRIBUTE_ID_BASE + 23
+GOPHER_ATTRIBUTE_ID_TREEWALK = GOPHER_ATTRIBUTE_ID_BASE + 24
+GOPHER_ATTRIBUTE_ID_UNKNOWN = GOPHER_ATTRIBUTE_ID_BASE + 25
+HTTP_MAJOR_VERSION = 1
+HTTP_MINOR_VERSION = 0
+HTTP_VERSIONA = "HTTP/1.0"
+HTTP_VERSION = HTTP_VERSIONA
+HTTP_QUERY_MIME_VERSION = 0
+HTTP_QUERY_CONTENT_TYPE = 1
+HTTP_QUERY_CONTENT_TRANSFER_ENCODING = 2
+HTTP_QUERY_CONTENT_ID = 3
+HTTP_QUERY_CONTENT_DESCRIPTION = 4
+HTTP_QUERY_CONTENT_LENGTH = 5
+HTTP_QUERY_CONTENT_LANGUAGE = 6
+HTTP_QUERY_ALLOW = 7
+HTTP_QUERY_PUBLIC = 8
+HTTP_QUERY_DATE = 9
+HTTP_QUERY_EXPIRES = 10
+HTTP_QUERY_LAST_MODIFIED = 11
+HTTP_QUERY_MESSAGE_ID = 12
+HTTP_QUERY_URI = 13
+HTTP_QUERY_DERIVED_FROM = 14
+HTTP_QUERY_COST = 15
+HTTP_QUERY_LINK = 16
+HTTP_QUERY_PRAGMA = 17
+HTTP_QUERY_VERSION = 18
+HTTP_QUERY_STATUS_CODE = 19
+HTTP_QUERY_STATUS_TEXT = 20
+HTTP_QUERY_RAW_HEADERS = 21
+HTTP_QUERY_RAW_HEADERS_CRLF = 22
+HTTP_QUERY_CONNECTION = 23
+HTTP_QUERY_ACCEPT = 24
+HTTP_QUERY_ACCEPT_CHARSET = 25
+HTTP_QUERY_ACCEPT_ENCODING = 26
+HTTP_QUERY_ACCEPT_LANGUAGE = 27
+HTTP_QUERY_AUTHORIZATION = 28
+HTTP_QUERY_CONTENT_ENCODING = 29
+HTTP_QUERY_FORWARDED = 30
+HTTP_QUERY_FROM = 31
+HTTP_QUERY_IF_MODIFIED_SINCE = 32
+HTTP_QUERY_LOCATION = 33
+HTTP_QUERY_ORIG_URI = 34
+HTTP_QUERY_REFERER = 35
+HTTP_QUERY_RETRY_AFTER = 36
+HTTP_QUERY_SERVER = 37
+HTTP_QUERY_TITLE = 38
+HTTP_QUERY_USER_AGENT = 39
+HTTP_QUERY_WWW_AUTHENTICATE = 40
+HTTP_QUERY_PROXY_AUTHENTICATE = 41
+HTTP_QUERY_ACCEPT_RANGES = 42
+HTTP_QUERY_SET_COOKIE = 43
+HTTP_QUERY_COOKIE = 44
+HTTP_QUERY_REQUEST_METHOD = 45
+HTTP_QUERY_REFRESH = 46
+HTTP_QUERY_CONTENT_DISPOSITION = 47
+HTTP_QUERY_AGE = 48
+HTTP_QUERY_CACHE_CONTROL = 49
+HTTP_QUERY_CONTENT_BASE = 50
+HTTP_QUERY_CONTENT_LOCATION = 51
+HTTP_QUERY_CONTENT_MD5 = 52
+HTTP_QUERY_CONTENT_RANGE = 53
+HTTP_QUERY_ETAG = 54
+HTTP_QUERY_HOST = 55
+HTTP_QUERY_IF_MATCH = 56
+HTTP_QUERY_IF_NONE_MATCH = 57
+HTTP_QUERY_IF_RANGE = 58
+HTTP_QUERY_IF_UNMODIFIED_SINCE = 59
+HTTP_QUERY_MAX_FORWARDS = 60
+HTTP_QUERY_PROXY_AUTHORIZATION = 61
+HTTP_QUERY_RANGE = 62
+HTTP_QUERY_TRANSFER_ENCODING = 63
+HTTP_QUERY_UPGRADE = 64
+HTTP_QUERY_VARY = 65
+HTTP_QUERY_VIA = 66
+HTTP_QUERY_WARNING = 67
+HTTP_QUERY_EXPECT = 68
+HTTP_QUERY_PROXY_CONNECTION = 69
+HTTP_QUERY_UNLESS_MODIFIED_SINCE = 70
+HTTP_QUERY_ECHO_REQUEST = 71
+HTTP_QUERY_ECHO_REPLY = 72
+HTTP_QUERY_ECHO_HEADERS = 73
+HTTP_QUERY_ECHO_HEADERS_CRLF = 74
+HTTP_QUERY_PROXY_SUPPORT = 75
+HTTP_QUERY_AUTHENTICATION_INFO = 76
+HTTP_QUERY_PASSPORT_URLS = 77
+HTTP_QUERY_PASSPORT_CONFIG = 78
+HTTP_QUERY_MAX = 78
+HTTP_QUERY_CUSTOM = 65535
+HTTP_QUERY_FLAG_REQUEST_HEADERS = -2147483648
+HTTP_QUERY_FLAG_SYSTEMTIME = 0x40000000
+HTTP_QUERY_FLAG_NUMBER = 0x20000000
+HTTP_QUERY_FLAG_COALESCE = 0x10000000
+HTTP_QUERY_MODIFIER_FLAGS_MASK = (
+    HTTP_QUERY_FLAG_REQUEST_HEADERS
+    | HTTP_QUERY_FLAG_SYSTEMTIME
+    | HTTP_QUERY_FLAG_NUMBER
+    | HTTP_QUERY_FLAG_COALESCE
+)
+HTTP_QUERY_HEADER_MASK = ~HTTP_QUERY_MODIFIER_FLAGS_MASK
+HTTP_STATUS_CONTINUE = 100
+HTTP_STATUS_SWITCH_PROTOCOLS = 101
+HTTP_STATUS_OK = 200
+HTTP_STATUS_CREATED = 201
+HTTP_STATUS_ACCEPTED = 202
+HTTP_STATUS_PARTIAL = 203
+HTTP_STATUS_NO_CONTENT = 204
+HTTP_STATUS_RESET_CONTENT = 205
+HTTP_STATUS_PARTIAL_CONTENT = 206
+HTTP_STATUS_WEBDAV_MULTI_STATUS = 207
+HTTP_STATUS_AMBIGUOUS = 300
+HTTP_STATUS_MOVED = 301
+HTTP_STATUS_REDIRECT = 302
+HTTP_STATUS_REDIRECT_METHOD = 303
+HTTP_STATUS_NOT_MODIFIED = 304
+HTTP_STATUS_USE_PROXY = 305
+HTTP_STATUS_REDIRECT_KEEP_VERB = 307
+HTTP_STATUS_BAD_REQUEST = 400
+HTTP_STATUS_DENIED = 401
+HTTP_STATUS_PAYMENT_REQ = 402
+HTTP_STATUS_FORBIDDEN = 403
+HTTP_STATUS_NOT_FOUND = 404
+HTTP_STATUS_BAD_METHOD = 405
+HTTP_STATUS_NONE_ACCEPTABLE = 406
+HTTP_STATUS_PROXY_AUTH_REQ = 407
+HTTP_STATUS_REQUEST_TIMEOUT = 408
+HTTP_STATUS_CONFLICT = 409
+HTTP_STATUS_GONE = 410
+HTTP_STATUS_LENGTH_REQUIRED = 411
+HTTP_STATUS_PRECOND_FAILED = 412
+HTTP_STATUS_REQUEST_TOO_LARGE = 413
+HTTP_STATUS_URI_TOO_LONG = 414
+HTTP_STATUS_UNSUPPORTED_MEDIA = 415
+HTTP_STATUS_RETRY_WITH = 449
+HTTP_STATUS_SERVER_ERROR = 500
+HTTP_STATUS_NOT_SUPPORTED = 501
+HTTP_STATUS_BAD_GATEWAY = 502
+HTTP_STATUS_SERVICE_UNAVAIL = 503
+HTTP_STATUS_GATEWAY_TIMEOUT = 504
+HTTP_STATUS_VERSION_NOT_SUP = 505
+HTTP_STATUS_FIRST = HTTP_STATUS_CONTINUE
+HTTP_STATUS_LAST = HTTP_STATUS_VERSION_NOT_SUP
+HTTP_ADDREQ_INDEX_MASK = 0x0000FFFF
+HTTP_ADDREQ_FLAGS_MASK = -65536
+HTTP_ADDREQ_FLAG_ADD_IF_NEW = 0x10000000
+HTTP_ADDREQ_FLAG_ADD = 0x20000000
+HTTP_ADDREQ_FLAG_COALESCE_WITH_COMMA = 0x40000000
+HTTP_ADDREQ_FLAG_COALESCE_WITH_SEMICOLON = 0x01000000
+HTTP_ADDREQ_FLAG_COALESCE = HTTP_ADDREQ_FLAG_COALESCE_WITH_COMMA
+HTTP_ADDREQ_FLAG_REPLACE = -2147483648
+HSR_ASYNC = WININET_API_FLAG_ASYNC
+HSR_SYNC = WININET_API_FLAG_SYNC
+HSR_USE_CONTEXT = WININET_API_FLAG_USE_CONTEXT
+HSR_INITIATE = 0x00000008
+HSR_DOWNLOAD = 0x00000010
+HSR_CHUNKED = 0x00000020
+INTERNET_COOKIE_IS_SECURE = 0x01
+INTERNET_COOKIE_IS_SESSION = 0x02
+INTERNET_COOKIE_THIRD_PARTY = 0x10
+INTERNET_COOKIE_PROMPT_REQUIRED = 0x20
+INTERNET_COOKIE_EVALUATE_P3P = 0x40
+INTERNET_COOKIE_APPLY_P3P = 0x80
+INTERNET_COOKIE_P3P_ENABLED = 0x100
+INTERNET_COOKIE_IS_RESTRICTED = 0x200
+INTERNET_COOKIE_IE6 = 0x400
+INTERNET_COOKIE_IS_LEGACY = 0x800
+FLAG_ICC_FORCE_CONNECTION = 0x00000001
+FLAGS_ERROR_UI_FILTER_FOR_ERRORS = 0x01
+FLAGS_ERROR_UI_FLAGS_CHANGE_OPTIONS = 0x02
+FLAGS_ERROR_UI_FLAGS_GENERATE_DATA = 0x04
+FLAGS_ERROR_UI_FLAGS_NO_UI = 0x08
+FLAGS_ERROR_UI_SERIALIZE_DIALOGS = 0x10
+INTERNET_ERROR_BASE = 12000
+ERROR_INTERNET_OUT_OF_HANDLES = INTERNET_ERROR_BASE + 1
+ERROR_INTERNET_TIMEOUT = INTERNET_ERROR_BASE + 2
+ERROR_INTERNET_EXTENDED_ERROR = INTERNET_ERROR_BASE + 3
+ERROR_INTERNET_INTERNAL_ERROR = INTERNET_ERROR_BASE + 4
+ERROR_INTERNET_INVALID_URL = INTERNET_ERROR_BASE + 5
+ERROR_INTERNET_UNRECOGNIZED_SCHEME = INTERNET_ERROR_BASE + 6
+ERROR_INTERNET_NAME_NOT_RESOLVED = INTERNET_ERROR_BASE + 7
+ERROR_INTERNET_PROTOCOL_NOT_FOUND = INTERNET_ERROR_BASE + 8
+ERROR_INTERNET_INVALID_OPTION = INTERNET_ERROR_BASE + 9
+ERROR_INTERNET_BAD_OPTION_LENGTH = INTERNET_ERROR_BASE + 10
+ERROR_INTERNET_OPTION_NOT_SETTABLE = INTERNET_ERROR_BASE + 11
+ERROR_INTERNET_SHUTDOWN = INTERNET_ERROR_BASE + 12
+ERROR_INTERNET_INCORRECT_USER_NAME = INTERNET_ERROR_BASE + 13
+ERROR_INTERNET_INCORRECT_PASSWORD = INTERNET_ERROR_BASE + 14
+ERROR_INTERNET_LOGIN_FAILURE = INTERNET_ERROR_BASE + 15
+ERROR_INTERNET_INVALID_OPERATION = INTERNET_ERROR_BASE + 16
+ERROR_INTERNET_OPERATION_CANCELLED = INTERNET_ERROR_BASE + 17
+ERROR_INTERNET_INCORRECT_HANDLE_TYPE = INTERNET_ERROR_BASE + 18
+ERROR_INTERNET_INCORRECT_HANDLE_STATE = INTERNET_ERROR_BASE + 19
+ERROR_INTERNET_NOT_PROXY_REQUEST = INTERNET_ERROR_BASE + 20
+ERROR_INTERNET_REGISTRY_VALUE_NOT_FOUND = INTERNET_ERROR_BASE + 21
+ERROR_INTERNET_BAD_REGISTRY_PARAMETER = INTERNET_ERROR_BASE + 22
+ERROR_INTERNET_NO_DIRECT_ACCESS = INTERNET_ERROR_BASE + 23
+ERROR_INTERNET_NO_CONTEXT = INTERNET_ERROR_BASE + 24
+ERROR_INTERNET_NO_CALLBACK = INTERNET_ERROR_BASE + 25
+ERROR_INTERNET_REQUEST_PENDING = INTERNET_ERROR_BASE + 26
+ERROR_INTERNET_INCORRECT_FORMAT = INTERNET_ERROR_BASE + 27
+ERROR_INTERNET_ITEM_NOT_FOUND = INTERNET_ERROR_BASE + 28
+ERROR_INTERNET_CANNOT_CONNECT = INTERNET_ERROR_BASE + 29
+ERROR_INTERNET_CONNECTION_ABORTED = INTERNET_ERROR_BASE + 30
+ERROR_INTERNET_CONNECTION_RESET = INTERNET_ERROR_BASE + 31
+ERROR_INTERNET_FORCE_RETRY = INTERNET_ERROR_BASE + 32
+ERROR_INTERNET_INVALID_PROXY_REQUEST = INTERNET_ERROR_BASE + 33
+ERROR_INTERNET_NEED_UI = INTERNET_ERROR_BASE + 34
+ERROR_INTERNET_HANDLE_EXISTS = INTERNET_ERROR_BASE + 36
+ERROR_INTERNET_SEC_CERT_DATE_INVALID = INTERNET_ERROR_BASE + 37
+ERROR_INTERNET_SEC_CERT_CN_INVALID = INTERNET_ERROR_BASE + 38
+ERROR_INTERNET_HTTP_TO_HTTPS_ON_REDIR = INTERNET_ERROR_BASE + 39
+ERROR_INTERNET_HTTPS_TO_HTTP_ON_REDIR = INTERNET_ERROR_BASE + 40
+ERROR_INTERNET_MIXED_SECURITY = INTERNET_ERROR_BASE + 41
+ERROR_INTERNET_CHG_POST_IS_NON_SECURE = INTERNET_ERROR_BASE + 42
+ERROR_INTERNET_POST_IS_NON_SECURE = INTERNET_ERROR_BASE + 43
+ERROR_INTERNET_CLIENT_AUTH_CERT_NEEDED = INTERNET_ERROR_BASE + 44
+ERROR_INTERNET_INVALID_CA = INTERNET_ERROR_BASE + 45
+ERROR_INTERNET_CLIENT_AUTH_NOT_SETUP = INTERNET_ERROR_BASE + 46
+ERROR_INTERNET_ASYNC_THREAD_FAILED = INTERNET_ERROR_BASE + 47
+ERROR_INTERNET_REDIRECT_SCHEME_CHANGE = INTERNET_ERROR_BASE + 48
+ERROR_INTERNET_DIALOG_PENDING = INTERNET_ERROR_BASE + 49
+ERROR_INTERNET_RETRY_DIALOG = INTERNET_ERROR_BASE + 50
+ERROR_INTERNET_HTTPS_HTTP_SUBMIT_REDIR = INTERNET_ERROR_BASE + 52
+ERROR_INTERNET_INSERT_CDROM = INTERNET_ERROR_BASE + 53
+ERROR_INTERNET_FORTEZZA_LOGIN_NEEDED = INTERNET_ERROR_BASE + 54
+ERROR_INTERNET_SEC_CERT_ERRORS = INTERNET_ERROR_BASE + 55
+ERROR_INTERNET_SEC_CERT_NO_REV = INTERNET_ERROR_BASE + 56
+ERROR_INTERNET_SEC_CERT_REV_FAILED = INTERNET_ERROR_BASE + 57
+ERROR_FTP_TRANSFER_IN_PROGRESS = INTERNET_ERROR_BASE + 110
+ERROR_FTP_DROPPED = INTERNET_ERROR_BASE + 111
+ERROR_FTP_NO_PASSIVE_MODE = INTERNET_ERROR_BASE + 112
+ERROR_GOPHER_PROTOCOL_ERROR = INTERNET_ERROR_BASE + 130
+ERROR_GOPHER_NOT_FILE = INTERNET_ERROR_BASE + 131
+ERROR_GOPHER_DATA_ERROR = INTERNET_ERROR_BASE + 132
+ERROR_GOPHER_END_OF_DATA = INTERNET_ERROR_BASE + 133
+ERROR_GOPHER_INVALID_LOCATOR = INTERNET_ERROR_BASE + 134
+ERROR_GOPHER_INCORRECT_LOCATOR_TYPE = INTERNET_ERROR_BASE + 135
+ERROR_GOPHER_NOT_GOPHER_PLUS = INTERNET_ERROR_BASE + 136
+ERROR_GOPHER_ATTRIBUTE_NOT_FOUND = INTERNET_ERROR_BASE + 137
+ERROR_GOPHER_UNKNOWN_LOCATOR = INTERNET_ERROR_BASE + 138
+ERROR_HTTP_HEADER_NOT_FOUND = INTERNET_ERROR_BASE + 150
+ERROR_HTTP_DOWNLEVEL_SERVER = INTERNET_ERROR_BASE + 151
+ERROR_HTTP_INVALID_SERVER_RESPONSE = INTERNET_ERROR_BASE + 152
+ERROR_HTTP_INVALID_HEADER = INTERNET_ERROR_BASE + 153
+ERROR_HTTP_INVALID_QUERY_REQUEST = INTERNET_ERROR_BASE + 154
+ERROR_HTTP_HEADER_ALREADY_EXISTS = INTERNET_ERROR_BASE + 155
+ERROR_HTTP_REDIRECT_FAILED = INTERNET_ERROR_BASE + 156
+ERROR_HTTP_NOT_REDIRECTED = INTERNET_ERROR_BASE + 160
+ERROR_HTTP_COOKIE_NEEDS_CONFIRMATION = INTERNET_ERROR_BASE + 161
+ERROR_HTTP_COOKIE_DECLINED = INTERNET_ERROR_BASE + 162
+ERROR_HTTP_REDIRECT_NEEDS_CONFIRMATION = INTERNET_ERROR_BASE + 168
+ERROR_INTERNET_SECURITY_CHANNEL_ERROR = INTERNET_ERROR_BASE + 157
+ERROR_INTERNET_UNABLE_TO_CACHE_FILE = INTERNET_ERROR_BASE + 158
+ERROR_INTERNET_TCPIP_NOT_INSTALLED = INTERNET_ERROR_BASE + 159
+ERROR_INTERNET_DISCONNECTED = INTERNET_ERROR_BASE + 163
+ERROR_INTERNET_SERVER_UNREACHABLE = INTERNET_ERROR_BASE + 164
+ERROR_INTERNET_PROXY_SERVER_UNREACHABLE = INTERNET_ERROR_BASE + 165
+ERROR_INTERNET_BAD_AUTO_PROXY_SCRIPT = INTERNET_ERROR_BASE + 166
+ERROR_INTERNET_UNABLE_TO_DOWNLOAD_SCRIPT = INTERNET_ERROR_BASE + 167
+ERROR_INTERNET_SEC_INVALID_CERT = INTERNET_ERROR_BASE + 169
+ERROR_INTERNET_SEC_CERT_REVOKED = INTERNET_ERROR_BASE + 170
+ERROR_INTERNET_FAILED_DUETOSECURITYCHECK = INTERNET_ERROR_BASE + 171
+ERROR_INTERNET_NOT_INITIALIZED = INTERNET_ERROR_BASE + 172
+ERROR_INTERNET_NEED_MSN_SSPI_PKG = INTERNET_ERROR_BASE + 173
+ERROR_INTERNET_LOGIN_FAILURE_DISPLAY_ENTITY_BODY = INTERNET_ERROR_BASE + 174
+INTERNET_ERROR_LAST = ERROR_INTERNET_LOGIN_FAILURE_DISPLAY_ENTITY_BODY
+NORMAL_CACHE_ENTRY = 0x00000001
+STICKY_CACHE_ENTRY = 0x00000004
+EDITED_CACHE_ENTRY = 0x00000008
+TRACK_OFFLINE_CACHE_ENTRY = 0x00000010
+TRACK_ONLINE_CACHE_ENTRY = 0x00000020
+SPARSE_CACHE_ENTRY = 0x00010000
+COOKIE_CACHE_ENTRY = 0x00100000
+URLHISTORY_CACHE_ENTRY = 0x00200000
+URLCACHE_FIND_DEFAULT_FILTER = (
+    NORMAL_CACHE_ENTRY
+    | COOKIE_CACHE_ENTRY
+    | URLHISTORY_CACHE_ENTRY
+    | TRACK_OFFLINE_CACHE_ENTRY
+    | TRACK_ONLINE_CACHE_ENTRY
+    | STICKY_CACHE_ENTRY
+)
+CACHEGROUP_ATTRIBUTE_GET_ALL = -1
+CACHEGROUP_ATTRIBUTE_BASIC = 0x00000001
+CACHEGROUP_ATTRIBUTE_FLAG = 0x00000002
+CACHEGROUP_ATTRIBUTE_TYPE = 0x00000004
+CACHEGROUP_ATTRIBUTE_QUOTA = 0x00000008
+CACHEGROUP_ATTRIBUTE_GROUPNAME = 0x00000010
+CACHEGROUP_ATTRIBUTE_STORAGE = 0x00000020
+CACHEGROUP_FLAG_NONPURGEABLE = 0x00000001
+CACHEGROUP_FLAG_GIDONLY = 0x00000004
+CACHEGROUP_FLAG_FLUSHURL_ONDELETE = 0x00000002
+CACHEGROUP_SEARCH_ALL = 0x00000000
+CACHEGROUP_SEARCH_BYURL = 0x00000001
+CACHEGROUP_TYPE_INVALID = 0x00000001
+CACHEGROUP_READWRITE_MASK = (
+    CACHEGROUP_ATTRIBUTE_TYPE
+    | CACHEGROUP_ATTRIBUTE_QUOTA
+    | CACHEGROUP_ATTRIBUTE_GROUPNAME
+    | CACHEGROUP_ATTRIBUTE_STORAGE
+)
+GROUPNAME_MAX_LENGTH = 120
+GROUP_OWNER_STORAGE_SIZE = 4
+CACHE_ENTRY_ATTRIBUTE_FC = 0x00000004
+CACHE_ENTRY_HITRATE_FC = 0x00000010
+CACHE_ENTRY_MODTIME_FC = 0x00000040
+CACHE_ENTRY_EXPTIME_FC = 0x00000080
+CACHE_ENTRY_ACCTIME_FC = 0x00000100
+CACHE_ENTRY_SYNCTIME_FC = 0x00000200
+CACHE_ENTRY_HEADERINFO_FC = 0x00000400
+CACHE_ENTRY_EXEMPT_DELTA_FC = 0x00000800
+INTERNET_CACHE_GROUP_ADD = 0
+INTERNET_CACHE_GROUP_REMOVE = 1
+INTERNET_DIAL_FORCE_PROMPT = 0x2000
+INTERNET_DIAL_SHOW_OFFLINE = 0x4000
+INTERNET_DIAL_UNATTENDED = 0x8000
+INTERENT_GOONLINE_REFRESH = 0x00000001
+INTERENT_GOONLINE_MASK = 0x00000001
+INTERNET_AUTODIAL_FORCE_ONLINE = 1
+INTERNET_AUTODIAL_FORCE_UNATTENDED = 2
+INTERNET_AUTODIAL_FAILIFSECURITYCHECK = 4
+INTERNET_AUTODIAL_OVERRIDE_NET_PRESENT = 8
+INTERNET_AUTODIAL_FLAGS_MASK = (
+    INTERNET_AUTODIAL_FORCE_ONLINE
+    | INTERNET_AUTODIAL_FORCE_UNATTENDED
+    | INTERNET_AUTODIAL_FAILIFSECURITYCHECK
+    | INTERNET_AUTODIAL_OVERRIDE_NET_PRESENT
+)
+PROXY_AUTO_DETECT_TYPE_DHCP = 1
+PROXY_AUTO_DETECT_TYPE_DNS_A = 2
+INTERNET_CONNECTION_MODEM = 0x01
+INTERNET_CONNECTION_LAN = 0x02
+INTERNET_CONNECTION_PROXY = 0x04
+INTERNET_CONNECTION_MODEM_BUSY = 0x08
+INTERNET_RAS_INSTALLED = 0x10
+INTERNET_CONNECTION_OFFLINE = 0x20
+INTERNET_CONNECTION_CONFIGURED = 0x40
+INTERNET_CUSTOMDIAL_CONNECT = 0
+INTERNET_CUSTOMDIAL_UNATTENDED = 1
+INTERNET_CUSTOMDIAL_DISCONNECT = 2
+INTERNET_CUSTOMDIAL_SHOWOFFLINE = 4
+INTERNET_CUSTOMDIAL_SAFE_FOR_UNATTENDED = 1
+INTERNET_CUSTOMDIAL_WILL_SUPPLY_STATE = 2
+INTERNET_CUSTOMDIAL_CAN_HANGUP = 4
+INTERNET_DIALSTATE_DISCONNECTED = 1
+INTERNET_IDENTITY_FLAG_PRIVATE_CACHE = 0x01
+INTERNET_IDENTITY_FLAG_SHARED_CACHE = 0x02
+INTERNET_IDENTITY_FLAG_CLEAR_DATA = 0x04
+INTERNET_IDENTITY_FLAG_CLEAR_COOKIES = 0x08
+INTERNET_IDENTITY_FLAG_CLEAR_HISTORY = 0x10
+INTERNET_IDENTITY_FLAG_CLEAR_CONTENT = 0x20
+INTERNET_SUPPRESS_RESET_ALL = 0x00
+INTERNET_SUPPRESS_COOKIE_POLICY = 0x01
+INTERNET_SUPPRESS_COOKIE_POLICY_RESET = 0x02
+PRIVACY_TEMPLATE_NO_COOKIES = 0
+PRIVACY_TEMPLATE_HIGH = 1
+PRIVACY_TEMPLATE_MEDIUM_HIGH = 2
+PRIVACY_TEMPLATE_MEDIUM = 3
+PRIVACY_TEMPLATE_MEDIUM_LOW = 4
+PRIVACY_TEMPLATE_LOW = 5
+PRIVACY_TEMPLATE_CUSTOM = 100
+PRIVACY_TEMPLATE_ADVANCED = 101
+PRIVACY_TEMPLATE_MAX = PRIVACY_TEMPLATE_LOW
+PRIVACY_TYPE_FIRST_PARTY = 0
+PRIVACY_TYPE_THIRD_PARTY = 1
+
+# Generated by h2py from winhttp.h
+WINHTTP_FLAG_ASYNC = 0x10000000
+WINHTTP_FLAG_SECURE = 0x00800000
+WINHTTP_FLAG_ESCAPE_PERCENT = 0x00000004
+WINHTTP_FLAG_NULL_CODEPAGE = 0x00000008
+WINHTTP_FLAG_BYPASS_PROXY_CACHE = 0x00000100
+WINHTTP_FLAG_REFRESH = WINHTTP_FLAG_BYPASS_PROXY_CACHE
+WINHTTP_FLAG_ESCAPE_DISABLE = 0x00000040
+WINHTTP_FLAG_ESCAPE_DISABLE_QUERY = 0x00000080
+INTERNET_SCHEME_HTTP = 1
+INTERNET_SCHEME_HTTPS = 2
+WINHTTP_AUTOPROXY_AUTO_DETECT = 0x00000001
+WINHTTP_AUTOPROXY_CONFIG_URL = 0x00000002
+WINHTTP_AUTOPROXY_RUN_INPROCESS = 0x00010000
+WINHTTP_AUTOPROXY_RUN_OUTPROCESS_ONLY = 0x00020000
+WINHTTP_AUTO_DETECT_TYPE_DHCP = 0x00000001
+WINHTTP_AUTO_DETECT_TYPE_DNS_A = 0x00000002
+WINHTTP_TIME_FORMAT_BUFSIZE = 62
+WINHTTP_ACCESS_TYPE_DEFAULT_PROXY = 0
+WINHTTP_ACCESS_TYPE_NO_PROXY = 1
+WINHTTP_ACCESS_TYPE_NAMED_PROXY = 3
+WINHTTP_OPTION_CALLBACK = 1
+WINHTTP_OPTION_RESOLVE_TIMEOUT = 2
+WINHTTP_OPTION_CONNECT_TIMEOUT = 3
+WINHTTP_OPTION_CONNECT_RETRIES = 4
+WINHTTP_OPTION_SEND_TIMEOUT = 5
+WINHTTP_OPTION_RECEIVE_TIMEOUT = 6
+WINHTTP_OPTION_RECEIVE_RESPONSE_TIMEOUT = 7
+WINHTTP_OPTION_HANDLE_TYPE = 9
+WINHTTP_OPTION_READ_BUFFER_SIZE = 12
+WINHTTP_OPTION_WRITE_BUFFER_SIZE = 13
+WINHTTP_OPTION_PARENT_HANDLE = 21
+WINHTTP_OPTION_EXTENDED_ERROR = 24
+WINHTTP_OPTION_SECURITY_FLAGS = 31
+WINHTTP_OPTION_SECURITY_CERTIFICATE_STRUCT = 32
+WINHTTP_OPTION_URL = 34
+WINHTTP_OPTION_SECURITY_KEY_BITNESS = 36
+WINHTTP_OPTION_PROXY = 38
+WINHTTP_OPTION_USER_AGENT = 41
+WINHTTP_OPTION_CONTEXT_VALUE = 45
+WINHTTP_OPTION_CLIENT_CERT_CONTEXT = 47
+WINHTTP_OPTION_REQUEST_PRIORITY = 58
+WINHTTP_OPTION_HTTP_VERSION = 59
+WINHTTP_OPTION_DISABLE_FEATURE = 63
+WINHTTP_OPTION_CODEPAGE = 68
+WINHTTP_OPTION_MAX_CONNS_PER_SERVER = 73
+WINHTTP_OPTION_MAX_CONNS_PER_1_0_SERVER = 74
+WINHTTP_OPTION_AUTOLOGON_POLICY = 77
+WINHTTP_OPTION_SERVER_CERT_CONTEXT = 78
+WINHTTP_OPTION_ENABLE_FEATURE = 79
+WINHTTP_OPTION_WORKER_THREAD_COUNT = 80
+WINHTTP_OPTION_PASSPORT_COBRANDING_TEXT = 81
+WINHTTP_OPTION_PASSPORT_COBRANDING_URL = 82
+WINHTTP_OPTION_CONFIGURE_PASSPORT_AUTH = 83
+WINHTTP_OPTION_SECURE_PROTOCOLS = 84
+WINHTTP_OPTION_ENABLETRACING = 85
+WINHTTP_OPTION_PASSPORT_SIGN_OUT = 86
+WINHTTP_OPTION_PASSPORT_RETURN_URL = 87
+WINHTTP_OPTION_REDIRECT_POLICY = 88
+WINHTTP_OPTION_MAX_HTTP_AUTOMATIC_REDIRECTS = 89
+WINHTTP_OPTION_MAX_HTTP_STATUS_CONTINUE = 90
+WINHTTP_OPTION_MAX_RESPONSE_HEADER_SIZE = 91
+WINHTTP_OPTION_MAX_RESPONSE_DRAIN_SIZE = 92
+WINHTTP_OPTION_CONNECTION_INFO = 93
+WINHTTP_OPTION_CLIENT_CERT_ISSUER_LIST = 94
+WINHTTP_OPTION_SPN = 96
+WINHTTP_OPTION_GLOBAL_PROXY_CREDS = 97
+WINHTTP_OPTION_GLOBAL_SERVER_CREDS = 98
+WINHTTP_OPTION_UNLOAD_NOTIFY_EVENT = 99
+WINHTTP_OPTION_REJECT_USERPWD_IN_URL = 100
+WINHTTP_OPTION_USE_GLOBAL_SERVER_CREDENTIALS = 101
+WINHTTP_LAST_OPTION = WINHTTP_OPTION_USE_GLOBAL_SERVER_CREDENTIALS
+WINHTTP_OPTION_USERNAME = 0x1000
+WINHTTP_OPTION_PASSWORD = 0x1001
+WINHTTP_OPTION_PROXY_USERNAME = 0x1002
+WINHTTP_OPTION_PROXY_PASSWORD = 0x1003
+WINHTTP_CONNS_PER_SERVER_UNLIMITED = -1
+WINHTTP_AUTOLOGON_SECURITY_LEVEL_MEDIUM = 0
+WINHTTP_AUTOLOGON_SECURITY_LEVEL_LOW = 1
+WINHTTP_AUTOLOGON_SECURITY_LEVEL_HIGH = 2
+WINHTTP_AUTOLOGON_SECURITY_LEVEL_DEFAULT = WINHTTP_AUTOLOGON_SECURITY_LEVEL_MEDIUM
+WINHTTP_OPTION_REDIRECT_POLICY_NEVER = 0
+WINHTTP_OPTION_REDIRECT_POLICY_DISALLOW_HTTPS_TO_HTTP = 1
+WINHTTP_OPTION_REDIRECT_POLICY_ALWAYS = 2
+WINHTTP_OPTION_REDIRECT_POLICY_LAST = WINHTTP_OPTION_REDIRECT_POLICY_ALWAYS
+WINHTTP_OPTION_REDIRECT_POLICY_DEFAULT = (
+    WINHTTP_OPTION_REDIRECT_POLICY_DISALLOW_HTTPS_TO_HTTP
+)
+WINHTTP_DISABLE_PASSPORT_AUTH = 0x00000000
+WINHTTP_ENABLE_PASSPORT_AUTH = 0x10000000
+WINHTTP_DISABLE_PASSPORT_KEYRING = 0x20000000
+WINHTTP_ENABLE_PASSPORT_KEYRING = 0x40000000
+WINHTTP_DISABLE_COOKIES = 0x00000001
+WINHTTP_DISABLE_REDIRECTS = 0x00000002
+WINHTTP_DISABLE_AUTHENTICATION = 0x00000004
+WINHTTP_DISABLE_KEEP_ALIVE = 0x00000008
+WINHTTP_ENABLE_SSL_REVOCATION = 0x00000001
+WINHTTP_ENABLE_SSL_REVERT_IMPERSONATION = 0x00000002
+WINHTTP_DISABLE_SPN_SERVER_PORT = 0x00000000
+WINHTTP_ENABLE_SPN_SERVER_PORT = 0x00000001
+WINHTTP_OPTION_SPN_MASK = WINHTTP_ENABLE_SPN_SERVER_PORT
+WINHTTP_HANDLE_TYPE_SESSION = 1
+WINHTTP_HANDLE_TYPE_CONNECT = 2
+WINHTTP_HANDLE_TYPE_REQUEST = 3
+WINHTTP_AUTH_SCHEME_BASIC = 0x00000001
+WINHTTP_AUTH_SCHEME_NTLM = 0x00000002
+WINHTTP_AUTH_SCHEME_PASSPORT = 0x00000004
+WINHTTP_AUTH_SCHEME_DIGEST = 0x00000008
+WINHTTP_AUTH_SCHEME_NEGOTIATE = 0x00000010
+WINHTTP_AUTH_TARGET_SERVER = 0x00000000
+WINHTTP_AUTH_TARGET_PROXY = 0x00000001
+WINHTTP_CALLBACK_STATUS_FLAG_CERT_REV_FAILED = 0x00000001
+WINHTTP_CALLBACK_STATUS_FLAG_INVALID_CERT = 0x00000002
+WINHTTP_CALLBACK_STATUS_FLAG_CERT_REVOKED = 0x00000004
+WINHTTP_CALLBACK_STATUS_FLAG_INVALID_CA = 0x00000008
+WINHTTP_CALLBACK_STATUS_FLAG_CERT_CN_INVALID = 0x00000010
+WINHTTP_CALLBACK_STATUS_FLAG_CERT_DATE_INVALID = 0x00000020
+WINHTTP_CALLBACK_STATUS_FLAG_CERT_WRONG_USAGE = 0x00000040
+WINHTTP_CALLBACK_STATUS_FLAG_SECURITY_CHANNEL_ERROR = -2147483648
+WINHTTP_FLAG_SECURE_PROTOCOL_SSL2 = 0x00000008
+WINHTTP_FLAG_SECURE_PROTOCOL_SSL3 = 0x00000020
+WINHTTP_FLAG_SECURE_PROTOCOL_TLS1 = 0x00000080
+WINHTTP_FLAG_SECURE_PROTOCOL_ALL = (
+    WINHTTP_FLAG_SECURE_PROTOCOL_SSL2
+    | WINHTTP_FLAG_SECURE_PROTOCOL_SSL3
+    | WINHTTP_FLAG_SECURE_PROTOCOL_TLS1
+)
+WINHTTP_CALLBACK_STATUS_RESOLVING_NAME = 0x00000001
+WINHTTP_CALLBACK_STATUS_NAME_RESOLVED = 0x00000002
+WINHTTP_CALLBACK_STATUS_CONNECTING_TO_SERVER = 0x00000004
+WINHTTP_CALLBACK_STATUS_CONNECTED_TO_SERVER = 0x00000008
+WINHTTP_CALLBACK_STATUS_SENDING_REQUEST = 0x00000010
+WINHTTP_CALLBACK_STATUS_REQUEST_SENT = 0x00000020
+WINHTTP_CALLBACK_STATUS_RECEIVING_RESPONSE = 0x00000040
+WINHTTP_CALLBACK_STATUS_RESPONSE_RECEIVED = 0x00000080
+WINHTTP_CALLBACK_STATUS_CLOSING_CONNECTION = 0x00000100
+WINHTTP_CALLBACK_STATUS_CONNECTION_CLOSED = 0x00000200
+WINHTTP_CALLBACK_STATUS_HANDLE_CREATED = 0x00000400
+WINHTTP_CALLBACK_STATUS_HANDLE_CLOSING = 0x00000800
+WINHTTP_CALLBACK_STATUS_DETECTING_PROXY = 0x00001000
+WINHTTP_CALLBACK_STATUS_REDIRECT = 0x00004000
+WINHTTP_CALLBACK_STATUS_INTERMEDIATE_RESPONSE = 0x00008000
+WINHTTP_CALLBACK_STATUS_SECURE_FAILURE = 0x00010000
+WINHTTP_CALLBACK_STATUS_HEADERS_AVAILABLE = 0x00020000
+WINHTTP_CALLBACK_STATUS_DATA_AVAILABLE = 0x00040000
+WINHTTP_CALLBACK_STATUS_READ_COMPLETE = 0x00080000
+WINHTTP_CALLBACK_STATUS_WRITE_COMPLETE = 0x00100000
+WINHTTP_CALLBACK_STATUS_REQUEST_ERROR = 0x00200000
+WINHTTP_CALLBACK_STATUS_SENDREQUEST_COMPLETE = 0x00400000
+API_RECEIVE_RESPONSE = 1
+API_QUERY_DATA_AVAILABLE = 2
+API_READ_DATA = 3
+API_WRITE_DATA = 4
+API_SEND_REQUEST = 5
+WINHTTP_CALLBACK_FLAG_RESOLVE_NAME = (
+    WINHTTP_CALLBACK_STATUS_RESOLVING_NAME | WINHTTP_CALLBACK_STATUS_NAME_RESOLVED
+)
+WINHTTP_CALLBACK_FLAG_CONNECT_TO_SERVER = (
+    WINHTTP_CALLBACK_STATUS_CONNECTING_TO_SERVER
+    | WINHTTP_CALLBACK_STATUS_CONNECTED_TO_SERVER
+)
+WINHTTP_CALLBACK_FLAG_SEND_REQUEST = (
+    WINHTTP_CALLBACK_STATUS_SENDING_REQUEST | WINHTTP_CALLBACK_STATUS_REQUEST_SENT
+)
+WINHTTP_CALLBACK_FLAG_RECEIVE_RESPONSE = (
+    WINHTTP_CALLBACK_STATUS_RECEIVING_RESPONSE
+    | WINHTTP_CALLBACK_STATUS_RESPONSE_RECEIVED
+)
+WINHTTP_CALLBACK_FLAG_CLOSE_CONNECTION = (
+    WINHTTP_CALLBACK_STATUS_CLOSING_CONNECTION
+    | WINHTTP_CALLBACK_STATUS_CONNECTION_CLOSED
+)
+WINHTTP_CALLBACK_FLAG_HANDLES = (
+    WINHTTP_CALLBACK_STATUS_HANDLE_CREATED | WINHTTP_CALLBACK_STATUS_HANDLE_CLOSING
+)
+WINHTTP_CALLBACK_FLAG_DETECTING_PROXY = WINHTTP_CALLBACK_STATUS_DETECTING_PROXY
+WINHTTP_CALLBACK_FLAG_REDIRECT = WINHTTP_CALLBACK_STATUS_REDIRECT
+WINHTTP_CALLBACK_FLAG_INTERMEDIATE_RESPONSE = (
+    WINHTTP_CALLBACK_STATUS_INTERMEDIATE_RESPONSE
+)
+WINHTTP_CALLBACK_FLAG_SECURE_FAILURE = WINHTTP_CALLBACK_STATUS_SECURE_FAILURE
+WINHTTP_CALLBACK_FLAG_SENDREQUEST_COMPLETE = (
+    WINHTTP_CALLBACK_STATUS_SENDREQUEST_COMPLETE
+)
+WINHTTP_CALLBACK_FLAG_HEADERS_AVAILABLE = WINHTTP_CALLBACK_STATUS_HEADERS_AVAILABLE
+WINHTTP_CALLBACK_FLAG_DATA_AVAILABLE = WINHTTP_CALLBACK_STATUS_DATA_AVAILABLE
+WINHTTP_CALLBACK_FLAG_READ_COMPLETE = WINHTTP_CALLBACK_STATUS_READ_COMPLETE
+WINHTTP_CALLBACK_FLAG_WRITE_COMPLETE = WINHTTP_CALLBACK_STATUS_WRITE_COMPLETE
+WINHTTP_CALLBACK_FLAG_REQUEST_ERROR = WINHTTP_CALLBACK_STATUS_REQUEST_ERROR
+WINHTTP_CALLBACK_FLAG_ALL_COMPLETIONS = (
+    WINHTTP_CALLBACK_STATUS_SENDREQUEST_COMPLETE
+    | WINHTTP_CALLBACK_STATUS_HEADERS_AVAILABLE
+    | WINHTTP_CALLBACK_STATUS_DATA_AVAILABLE
+    | WINHTTP_CALLBACK_STATUS_READ_COMPLETE
+    | WINHTTP_CALLBACK_STATUS_WRITE_COMPLETE
+    | WINHTTP_CALLBACK_STATUS_REQUEST_ERROR
+)
+WINHTTP_CALLBACK_FLAG_ALL_NOTIFICATIONS = -1
+WINHTTP_QUERY_MIME_VERSION = 0
+WINHTTP_QUERY_CONTENT_TYPE = 1
+WINHTTP_QUERY_CONTENT_TRANSFER_ENCODING = 2
+WINHTTP_QUERY_CONTENT_ID = 3
+WINHTTP_QUERY_CONTENT_DESCRIPTION = 4
+WINHTTP_QUERY_CONTENT_LENGTH = 5
+WINHTTP_QUERY_CONTENT_LANGUAGE = 6
+WINHTTP_QUERY_ALLOW = 7
+WINHTTP_QUERY_PUBLIC = 8
+WINHTTP_QUERY_DATE = 9
+WINHTTP_QUERY_EXPIRES = 10
+WINHTTP_QUERY_LAST_MODIFIED = 11
+WINHTTP_QUERY_MESSAGE_ID = 12
+WINHTTP_QUERY_URI = 13
+WINHTTP_QUERY_DERIVED_FROM = 14
+WINHTTP_QUERY_COST = 15
+WINHTTP_QUERY_LINK = 16
+WINHTTP_QUERY_PRAGMA = 17
+WINHTTP_QUERY_VERSION = 18
+WINHTTP_QUERY_STATUS_CODE = 19
+WINHTTP_QUERY_STATUS_TEXT = 20
+WINHTTP_QUERY_RAW_HEADERS = 21
+WINHTTP_QUERY_RAW_HEADERS_CRLF = 22
+WINHTTP_QUERY_CONNECTION = 23
+WINHTTP_QUERY_ACCEPT = 24
+WINHTTP_QUERY_ACCEPT_CHARSET = 25
+WINHTTP_QUERY_ACCEPT_ENCODING = 26
+WINHTTP_QUERY_ACCEPT_LANGUAGE = 27
+WINHTTP_QUERY_AUTHORIZATION = 28
+WINHTTP_QUERY_CONTENT_ENCODING = 29
+WINHTTP_QUERY_FORWARDED = 30
+WINHTTP_QUERY_FROM = 31
+WINHTTP_QUERY_IF_MODIFIED_SINCE = 32
+WINHTTP_QUERY_LOCATION = 33
+WINHTTP_QUERY_ORIG_URI = 34
+WINHTTP_QUERY_REFERER = 35
+WINHTTP_QUERY_RETRY_AFTER = 36
+WINHTTP_QUERY_SERVER = 37
+WINHTTP_QUERY_TITLE = 38
+WINHTTP_QUERY_USER_AGENT = 39
+WINHTTP_QUERY_WWW_AUTHENTICATE = 40
+WINHTTP_QUERY_PROXY_AUTHENTICATE = 41
+WINHTTP_QUERY_ACCEPT_RANGES = 42
+WINHTTP_QUERY_SET_COOKIE = 43
+WINHTTP_QUERY_COOKIE = 44
+WINHTTP_QUERY_REQUEST_METHOD = 45
+WINHTTP_QUERY_REFRESH = 46
+WINHTTP_QUERY_CONTENT_DISPOSITION = 47
+WINHTTP_QUERY_AGE = 48
+WINHTTP_QUERY_CACHE_CONTROL = 49
+WINHTTP_QUERY_CONTENT_BASE = 50
+WINHTTP_QUERY_CONTENT_LOCATION = 51
+WINHTTP_QUERY_CONTENT_MD5 = 52
+WINHTTP_QUERY_CONTENT_RANGE = 53
+WINHTTP_QUERY_ETAG = 54
+WINHTTP_QUERY_HOST = 55
+WINHTTP_QUERY_IF_MATCH = 56
+WINHTTP_QUERY_IF_NONE_MATCH = 57
+WINHTTP_QUERY_IF_RANGE = 58
+WINHTTP_QUERY_IF_UNMODIFIED_SINCE = 59
+WINHTTP_QUERY_MAX_FORWARDS = 60
+WINHTTP_QUERY_PROXY_AUTHORIZATION = 61
+WINHTTP_QUERY_RANGE = 62
+WINHTTP_QUERY_TRANSFER_ENCODING = 63
+WINHTTP_QUERY_UPGRADE = 64
+WINHTTP_QUERY_VARY = 65
+WINHTTP_QUERY_VIA = 66
+WINHTTP_QUERY_WARNING = 67
+WINHTTP_QUERY_EXPECT = 68
+WINHTTP_QUERY_PROXY_CONNECTION = 69
+WINHTTP_QUERY_UNLESS_MODIFIED_SINCE = 70
+WINHTTP_QUERY_PROXY_SUPPORT = 75
+WINHTTP_QUERY_AUTHENTICATION_INFO = 76
+WINHTTP_QUERY_PASSPORT_URLS = 77
+WINHTTP_QUERY_PASSPORT_CONFIG = 78
+WINHTTP_QUERY_MAX = 78
+WINHTTP_QUERY_CUSTOM = 65535
+WINHTTP_QUERY_FLAG_REQUEST_HEADERS = -2147483648
+WINHTTP_QUERY_FLAG_SYSTEMTIME = 0x40000000
+WINHTTP_QUERY_FLAG_NUMBER = 0x20000000
+WINHTTP_ADDREQ_INDEX_MASK = 0x0000FFFF
+WINHTTP_ADDREQ_FLAGS_MASK = -65536
+WINHTTP_ADDREQ_FLAG_ADD_IF_NEW = 0x10000000
+WINHTTP_ADDREQ_FLAG_ADD = 0x20000000
+WINHTTP_ADDREQ_FLAG_COALESCE_WITH_COMMA = 0x40000000
+WINHTTP_ADDREQ_FLAG_COALESCE_WITH_SEMICOLON = 0x01000000
+WINHTTP_ADDREQ_FLAG_COALESCE = WINHTTP_ADDREQ_FLAG_COALESCE_WITH_COMMA
+WINHTTP_ADDREQ_FLAG_REPLACE = -2147483648
+WINHTTP_IGNORE_REQUEST_TOTAL_LENGTH = 0
+WINHTTP_ERROR_BASE = 12000
+ERROR_WINHTTP_OUT_OF_HANDLES = WINHTTP_ERROR_BASE + 1
+ERROR_WINHTTP_TIMEOUT = WINHTTP_ERROR_BASE + 2
+ERROR_WINHTTP_INTERNAL_ERROR = WINHTTP_ERROR_BASE + 4
+ERROR_WINHTTP_INVALID_URL = WINHTTP_ERROR_BASE + 5
+ERROR_WINHTTP_UNRECOGNIZED_SCHEME = WINHTTP_ERROR_BASE + 6
+ERROR_WINHTTP_NAME_NOT_RESOLVED = WINHTTP_ERROR_BASE + 7
+ERROR_WINHTTP_INVALID_OPTION = WINHTTP_ERROR_BASE + 9
+ERROR_WINHTTP_OPTION_NOT_SETTABLE = WINHTTP_ERROR_BASE + 11
+ERROR_WINHTTP_SHUTDOWN = WINHTTP_ERROR_BASE + 12
+ERROR_WINHTTP_LOGIN_FAILURE = WINHTTP_ERROR_BASE + 15
+ERROR_WINHTTP_OPERATION_CANCELLED = WINHTTP_ERROR_BASE + 17
+ERROR_WINHTTP_INCORRECT_HANDLE_TYPE = WINHTTP_ERROR_BASE + 18
+ERROR_WINHTTP_INCORRECT_HANDLE_STATE = WINHTTP_ERROR_BASE + 19
+ERROR_WINHTTP_CANNOT_CONNECT = WINHTTP_ERROR_BASE + 29
+ERROR_WINHTTP_CONNECTION_ERROR = WINHTTP_ERROR_BASE + 30
+ERROR_WINHTTP_RESEND_REQUEST = WINHTTP_ERROR_BASE + 32
+ERROR_WINHTTP_CLIENT_AUTH_CERT_NEEDED = WINHTTP_ERROR_BASE + 44
+ERROR_WINHTTP_CANNOT_CALL_BEFORE_OPEN = WINHTTP_ERROR_BASE + 100
+ERROR_WINHTTP_CANNOT_CALL_BEFORE_SEND = WINHTTP_ERROR_BASE + 101
+ERROR_WINHTTP_CANNOT_CALL_AFTER_SEND = WINHTTP_ERROR_BASE + 102
+ERROR_WINHTTP_CANNOT_CALL_AFTER_OPEN = WINHTTP_ERROR_BASE + 103
+ERROR_WINHTTP_HEADER_NOT_FOUND = WINHTTP_ERROR_BASE + 150
+ERROR_WINHTTP_INVALID_SERVER_RESPONSE = WINHTTP_ERROR_BASE + 152
+ERROR_WINHTTP_INVALID_HEADER = WINHTTP_ERROR_BASE + 153
+ERROR_WINHTTP_INVALID_QUERY_REQUEST = WINHTTP_ERROR_BASE + 154
+ERROR_WINHTTP_HEADER_ALREADY_EXISTS = WINHTTP_ERROR_BASE + 155
+ERROR_WINHTTP_REDIRECT_FAILED = WINHTTP_ERROR_BASE + 156
+ERROR_WINHTTP_AUTO_PROXY_SERVICE_ERROR = WINHTTP_ERROR_BASE + 178
+ERROR_WINHTTP_BAD_AUTO_PROXY_SCRIPT = WINHTTP_ERROR_BASE + 166
+ERROR_WINHTTP_UNABLE_TO_DOWNLOAD_SCRIPT = WINHTTP_ERROR_BASE + 167
+ERROR_WINHTTP_NOT_INITIALIZED = WINHTTP_ERROR_BASE + 172
+ERROR_WINHTTP_SECURE_FAILURE = WINHTTP_ERROR_BASE + 175
+ERROR_WINHTTP_SECURE_CERT_DATE_INVALID = WINHTTP_ERROR_BASE + 37
+ERROR_WINHTTP_SECURE_CERT_CN_INVALID = WINHTTP_ERROR_BASE + 38
+ERROR_WINHTTP_SECURE_INVALID_CA = WINHTTP_ERROR_BASE + 45
+ERROR_WINHTTP_SECURE_CERT_REV_FAILED = WINHTTP_ERROR_BASE + 57
+ERROR_WINHTTP_SECURE_CHANNEL_ERROR = WINHTTP_ERROR_BASE + 157
+ERROR_WINHTTP_SECURE_INVALID_CERT = WINHTTP_ERROR_BASE + 169
+ERROR_WINHTTP_SECURE_CERT_REVOKED = WINHTTP_ERROR_BASE + 170
+ERROR_WINHTTP_SECURE_CERT_WRONG_USAGE = WINHTTP_ERROR_BASE + 179
+ERROR_WINHTTP_AUTODETECTION_FAILED = WINHTTP_ERROR_BASE + 180
+ERROR_WINHTTP_HEADER_COUNT_EXCEEDED = WINHTTP_ERROR_BASE + 181
+ERROR_WINHTTP_HEADER_SIZE_OVERFLOW = WINHTTP_ERROR_BASE + 182
+ERROR_WINHTTP_CHUNKED_ENCODING_HEADER_SIZE_OVERFLOW = WINHTTP_ERROR_BASE + 183
+ERROR_WINHTTP_RESPONSE_DRAIN_OVERFLOW = WINHTTP_ERROR_BASE + 184
+ERROR_WINHTTP_CLIENT_CERT_NO_PRIVATE_KEY = WINHTTP_ERROR_BASE + 185
+ERROR_WINHTTP_CLIENT_CERT_NO_ACCESS_PRIVATE_KEY = WINHTTP_ERROR_BASE + 186
+WINHTTP_ERROR_LAST = WINHTTP_ERROR_BASE + 186
+
+WINHTTP_NO_PROXY_NAME = None
+WINHTTP_NO_PROXY_BYPASS = None
+WINHTTP_NO_REFERER = None
+WINHTTP_DEFAULT_ACCEPT_TYPES = None
+WINHTTP_NO_ADDITIONAL_HEADERS = None
+WINHTTP_NO_REQUEST_DATA = None
diff --git a/lib/win32/lib/win32netcon.py b/lib/win32/lib/win32netcon.py
new file mode 100644
index 00000000..63e97a14
--- /dev/null
+++ b/lib/win32/lib/win32netcon.py
@@ -0,0 +1,627 @@
+# Generated by h2py from lmaccess.h
+
+# Included from lmcons.h
+CNLEN = 15
+LM20_CNLEN = 15
+DNLEN = CNLEN
+LM20_DNLEN = LM20_CNLEN
+UNCLEN = CNLEN + 2
+LM20_UNCLEN = LM20_CNLEN + 2
+NNLEN = 80
+LM20_NNLEN = 12
+RMLEN = UNCLEN + 1 + NNLEN
+LM20_RMLEN = LM20_UNCLEN + 1 + LM20_NNLEN
+SNLEN = 80
+LM20_SNLEN = 15
+STXTLEN = 256
+LM20_STXTLEN = 63
+PATHLEN = 256
+LM20_PATHLEN = 256
+DEVLEN = 80
+LM20_DEVLEN = 8
+EVLEN = 16
+UNLEN = 256
+LM20_UNLEN = 20
+GNLEN = UNLEN
+LM20_GNLEN = LM20_UNLEN
+PWLEN = 256
+LM20_PWLEN = 14
+SHPWLEN = 8
+CLTYPE_LEN = 12
+MAXCOMMENTSZ = 256
+LM20_MAXCOMMENTSZ = 48
+QNLEN = NNLEN
+LM20_QNLEN = LM20_NNLEN
+ALERTSZ = 128
+NETBIOS_NAME_LEN = 16
+CRYPT_KEY_LEN = 7
+CRYPT_TXT_LEN = 8
+ENCRYPTED_PWLEN = 16
+SESSION_PWLEN = 24
+SESSION_CRYPT_KLEN = 21
+PARMNUM_ALL = 0
+PARM_ERROR_NONE = 0
+PARMNUM_BASE_INFOLEVEL = 1000
+NULL = 0
+PLATFORM_ID_DOS = 300
+PLATFORM_ID_OS2 = 400
+PLATFORM_ID_NT = 500
+PLATFORM_ID_OSF = 600
+PLATFORM_ID_VMS = 700
+MAX_LANMAN_MESSAGE_ID = 5799
+UF_SCRIPT = 1
+UF_ACCOUNTDISABLE = 2
+UF_HOMEDIR_REQUIRED = 8
+UF_LOCKOUT = 16
+UF_PASSWD_NOTREQD = 32
+UF_PASSWD_CANT_CHANGE = 64
+UF_TEMP_DUPLICATE_ACCOUNT = 256
+UF_NORMAL_ACCOUNT = 512
+UF_INTERDOMAIN_TRUST_ACCOUNT = 2048
+UF_WORKSTATION_TRUST_ACCOUNT = 4096
+UF_SERVER_TRUST_ACCOUNT = 8192
+UF_MACHINE_ACCOUNT_MASK = (
+    UF_INTERDOMAIN_TRUST_ACCOUNT
+    | UF_WORKSTATION_TRUST_ACCOUNT
+    | UF_SERVER_TRUST_ACCOUNT
+)
+UF_ACCOUNT_TYPE_MASK = (
+    UF_TEMP_DUPLICATE_ACCOUNT
+    | UF_NORMAL_ACCOUNT
+    | UF_INTERDOMAIN_TRUST_ACCOUNT
+    | UF_WORKSTATION_TRUST_ACCOUNT
+    | UF_SERVER_TRUST_ACCOUNT
+)
+UF_DONT_EXPIRE_PASSWD = 65536
+UF_MNS_LOGON_ACCOUNT = 131072
+UF_SETTABLE_BITS = (
+    UF_SCRIPT
+    | UF_ACCOUNTDISABLE
+    | UF_LOCKOUT
+    | UF_HOMEDIR_REQUIRED
+    | UF_PASSWD_NOTREQD
+    | UF_PASSWD_CANT_CHANGE
+    | UF_ACCOUNT_TYPE_MASK
+    | UF_DONT_EXPIRE_PASSWD
+    | UF_MNS_LOGON_ACCOUNT
+)
+FILTER_TEMP_DUPLICATE_ACCOUNT = 1
+FILTER_NORMAL_ACCOUNT = 2
+FILTER_INTERDOMAIN_TRUST_ACCOUNT = 8
+FILTER_WORKSTATION_TRUST_ACCOUNT = 16
+FILTER_SERVER_TRUST_ACCOUNT = 32
+LG_INCLUDE_INDIRECT = 1
+AF_OP_PRINT = 1
+AF_OP_COMM = 2
+AF_OP_SERVER = 4
+AF_OP_ACCOUNTS = 8
+AF_SETTABLE_BITS = AF_OP_PRINT | AF_OP_COMM | AF_OP_SERVER | AF_OP_ACCOUNTS
+UAS_ROLE_STANDALONE = 0
+UAS_ROLE_MEMBER = 1
+UAS_ROLE_BACKUP = 2
+UAS_ROLE_PRIMARY = 3
+USER_NAME_PARMNUM = 1
+USER_PASSWORD_PARMNUM = 3
+USER_PASSWORD_AGE_PARMNUM = 4
+USER_PRIV_PARMNUM = 5
+USER_HOME_DIR_PARMNUM = 6
+USER_COMMENT_PARMNUM = 7
+USER_FLAGS_PARMNUM = 8
+USER_SCRIPT_PATH_PARMNUM = 9
+USER_AUTH_FLAGS_PARMNUM = 10
+USER_FULL_NAME_PARMNUM = 11
+USER_USR_COMMENT_PARMNUM = 12
+USER_PARMS_PARMNUM = 13
+USER_WORKSTATIONS_PARMNUM = 14
+USER_LAST_LOGON_PARMNUM = 15
+USER_LAST_LOGOFF_PARMNUM = 16
+USER_ACCT_EXPIRES_PARMNUM = 17
+USER_MAX_STORAGE_PARMNUM = 18
+USER_UNITS_PER_WEEK_PARMNUM = 19
+USER_LOGON_HOURS_PARMNUM = 20
+USER_PAD_PW_COUNT_PARMNUM = 21
+USER_NUM_LOGONS_PARMNUM = 22
+USER_LOGON_SERVER_PARMNUM = 23
+USER_COUNTRY_CODE_PARMNUM = 24
+USER_CODE_PAGE_PARMNUM = 25
+USER_PRIMARY_GROUP_PARMNUM = 51
+USER_PROFILE = 52
+USER_PROFILE_PARMNUM = 52
+USER_HOME_DIR_DRIVE_PARMNUM = 53
+USER_NAME_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_NAME_PARMNUM
+USER_PASSWORD_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_PASSWORD_PARMNUM
+USER_PASSWORD_AGE_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_PASSWORD_AGE_PARMNUM
+USER_PRIV_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_PRIV_PARMNUM
+USER_HOME_DIR_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_HOME_DIR_PARMNUM
+USER_COMMENT_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_COMMENT_PARMNUM
+USER_FLAGS_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_FLAGS_PARMNUM
+USER_SCRIPT_PATH_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_SCRIPT_PATH_PARMNUM
+USER_AUTH_FLAGS_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_AUTH_FLAGS_PARMNUM
+USER_FULL_NAME_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_FULL_NAME_PARMNUM
+USER_USR_COMMENT_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_USR_COMMENT_PARMNUM
+USER_PARMS_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_PARMS_PARMNUM
+USER_WORKSTATIONS_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_WORKSTATIONS_PARMNUM
+USER_LAST_LOGON_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_LAST_LOGON_PARMNUM
+USER_LAST_LOGOFF_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_LAST_LOGOFF_PARMNUM
+USER_ACCT_EXPIRES_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_ACCT_EXPIRES_PARMNUM
+USER_MAX_STORAGE_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_MAX_STORAGE_PARMNUM
+USER_UNITS_PER_WEEK_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_UNITS_PER_WEEK_PARMNUM
+USER_LOGON_HOURS_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_LOGON_HOURS_PARMNUM
+USER_PAD_PW_COUNT_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_PAD_PW_COUNT_PARMNUM
+USER_NUM_LOGONS_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_NUM_LOGONS_PARMNUM
+USER_LOGON_SERVER_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_LOGON_SERVER_PARMNUM
+USER_COUNTRY_CODE_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_COUNTRY_CODE_PARMNUM
+USER_CODE_PAGE_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_CODE_PAGE_PARMNUM
+USER_PRIMARY_GROUP_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_PRIMARY_GROUP_PARMNUM
+USER_HOME_DIR_DRIVE_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_HOME_DIR_DRIVE_PARMNUM
+NULL_USERSETINFO_PASSWD = "              "
+UNITS_PER_DAY = 24
+UNITS_PER_WEEK = UNITS_PER_DAY * 7
+USER_PRIV_MASK = 3
+USER_PRIV_GUEST = 0
+USER_PRIV_USER = 1
+USER_PRIV_ADMIN = 2
+MAX_PASSWD_LEN = PWLEN
+DEF_MIN_PWLEN = 6
+DEF_PWUNIQUENESS = 5
+DEF_MAX_PWHIST = 8
+DEF_MAX_BADPW = 0
+VALIDATED_LOGON = 0
+PASSWORD_EXPIRED = 2
+NON_VALIDATED_LOGON = 3
+VALID_LOGOFF = 1
+MODALS_MIN_PASSWD_LEN_PARMNUM = 1
+MODALS_MAX_PASSWD_AGE_PARMNUM = 2
+MODALS_MIN_PASSWD_AGE_PARMNUM = 3
+MODALS_FORCE_LOGOFF_PARMNUM = 4
+MODALS_PASSWD_HIST_LEN_PARMNUM = 5
+MODALS_ROLE_PARMNUM = 6
+MODALS_PRIMARY_PARMNUM = 7
+MODALS_DOMAIN_NAME_PARMNUM = 8
+MODALS_DOMAIN_ID_PARMNUM = 9
+MODALS_LOCKOUT_DURATION_PARMNUM = 10
+MODALS_LOCKOUT_OBSERVATION_WINDOW_PARMNUM = 11
+MODALS_LOCKOUT_THRESHOLD_PARMNUM = 12
+MODALS_MIN_PASSWD_LEN_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + MODALS_MIN_PASSWD_LEN_PARMNUM
+MODALS_MAX_PASSWD_AGE_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + MODALS_MAX_PASSWD_AGE_PARMNUM
+MODALS_MIN_PASSWD_AGE_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + MODALS_MIN_PASSWD_AGE_PARMNUM
+MODALS_FORCE_LOGOFF_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + MODALS_FORCE_LOGOFF_PARMNUM
+MODALS_PASSWD_HIST_LEN_INFOLEVEL = (
+    PARMNUM_BASE_INFOLEVEL + MODALS_PASSWD_HIST_LEN_PARMNUM
+)
+MODALS_ROLE_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + MODALS_ROLE_PARMNUM
+MODALS_PRIMARY_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + MODALS_PRIMARY_PARMNUM
+MODALS_DOMAIN_NAME_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + MODALS_DOMAIN_NAME_PARMNUM
+MODALS_DOMAIN_ID_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + MODALS_DOMAIN_ID_PARMNUM
+GROUPIDMASK = 32768
+GROUP_ALL_PARMNUM = 0
+GROUP_NAME_PARMNUM = 1
+GROUP_COMMENT_PARMNUM = 2
+GROUP_ATTRIBUTES_PARMNUM = 3
+GROUP_ALL_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + GROUP_ALL_PARMNUM
+GROUP_NAME_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + GROUP_NAME_PARMNUM
+GROUP_COMMENT_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + GROUP_COMMENT_PARMNUM
+GROUP_ATTRIBUTES_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + GROUP_ATTRIBUTES_PARMNUM
+LOCALGROUP_NAME_PARMNUM = 1
+LOCALGROUP_COMMENT_PARMNUM = 2
+MAXPERMENTRIES = 64
+ACCESS_NONE = 0
+ACCESS_READ = 1
+ACCESS_WRITE = 2
+ACCESS_CREATE = 4
+ACCESS_EXEC = 8
+ACCESS_DELETE = 16
+ACCESS_ATRIB = 32
+ACCESS_PERM = 64
+ACCESS_GROUP = 32768
+ACCESS_AUDIT = 1
+ACCESS_SUCCESS_OPEN = 16
+ACCESS_SUCCESS_WRITE = 32
+ACCESS_SUCCESS_DELETE = 64
+ACCESS_SUCCESS_ACL = 128
+ACCESS_SUCCESS_MASK = 240
+ACCESS_FAIL_OPEN = 256
+ACCESS_FAIL_WRITE = 512
+ACCESS_FAIL_DELETE = 1024
+ACCESS_FAIL_ACL = 2048
+ACCESS_FAIL_MASK = 3840
+ACCESS_FAIL_SHIFT = 4
+ACCESS_RESOURCE_NAME_PARMNUM = 1
+ACCESS_ATTR_PARMNUM = 2
+ACCESS_COUNT_PARMNUM = 3
+ACCESS_ACCESS_LIST_PARMNUM = 4
+ACCESS_RESOURCE_NAME_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + ACCESS_RESOURCE_NAME_PARMNUM
+ACCESS_ATTR_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + ACCESS_ATTR_PARMNUM
+ACCESS_COUNT_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + ACCESS_COUNT_PARMNUM
+ACCESS_ACCESS_LIST_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + ACCESS_ACCESS_LIST_PARMNUM
+ACCESS_LETTERS = "RWCXDAP         "
+NETLOGON_CONTROL_QUERY = 1
+NETLOGON_CONTROL_REPLICATE = 2
+NETLOGON_CONTROL_SYNCHRONIZE = 3
+NETLOGON_CONTROL_PDC_REPLICATE = 4
+NETLOGON_CONTROL_REDISCOVER = 5
+NETLOGON_CONTROL_TC_QUERY = 6
+NETLOGON_CONTROL_TRANSPORT_NOTIFY = 7
+NETLOGON_CONTROL_FIND_USER = 8
+NETLOGON_CONTROL_UNLOAD_NETLOGON_DLL = 65531
+NETLOGON_CONTROL_BACKUP_CHANGE_LOG = 65532
+NETLOGON_CONTROL_TRUNCATE_LOG = 65533
+NETLOGON_CONTROL_SET_DBFLAG = 65534
+NETLOGON_CONTROL_BREAKPOINT = 65535
+NETLOGON_REPLICATION_NEEDED = 1
+NETLOGON_REPLICATION_IN_PROGRESS = 2
+NETLOGON_FULL_SYNC_REPLICATION = 4
+NETLOGON_REDO_NEEDED = 8
+
+######################
+# Manual stuff
+
+TEXT = lambda x: x
+
+MAX_PREFERRED_LENGTH = -1
+PARM_ERROR_UNKNOWN = -1
+MESSAGE_FILENAME = TEXT("NETMSG")
+OS2MSG_FILENAME = TEXT("BASE")
+HELP_MSG_FILENAME = TEXT("NETH")
+BACKUP_MSG_FILENAME = TEXT("BAK.MSG")
+TIMEQ_FOREVER = -1
+USER_MAXSTORAGE_UNLIMITED = -1
+USER_NO_LOGOFF = -1
+DEF_MAX_PWAGE = TIMEQ_FOREVER
+DEF_MIN_PWAGE = 0
+DEF_FORCE_LOGOFF = -1
+ONE_DAY = 1 * 24 * 3600
+GROUP_SPECIALGRP_USERS = "USERS"
+GROUP_SPECIALGRP_ADMINS = "ADMINS"
+GROUP_SPECIALGRP_GUESTS = "GUESTS"
+GROUP_SPECIALGRP_LOCAL = "LOCAL"
+ACCESS_ALL = (
+    ACCESS_READ
+    | ACCESS_WRITE
+    | ACCESS_CREATE
+    | ACCESS_EXEC
+    | ACCESS_DELETE
+    | ACCESS_ATRIB
+    | ACCESS_PERM
+)
+
+# From lmserver.h
+SV_PLATFORM_ID_OS2 = 400
+SV_PLATFORM_ID_NT = 500
+MAJOR_VERSION_MASK = 15
+SV_TYPE_WORKSTATION = 1
+SV_TYPE_SERVER = 2
+SV_TYPE_SQLSERVER = 4
+SV_TYPE_DOMAIN_CTRL = 8
+SV_TYPE_DOMAIN_BAKCTRL = 16
+SV_TYPE_TIME_SOURCE = 32
+SV_TYPE_AFP = 64
+SV_TYPE_NOVELL = 128
+SV_TYPE_DOMAIN_MEMBER = 256
+SV_TYPE_PRINTQ_SERVER = 512
+SV_TYPE_DIALIN_SERVER = 1024
+SV_TYPE_XENIX_SERVER = 2048
+SV_TYPE_SERVER_UNIX = SV_TYPE_XENIX_SERVER
+SV_TYPE_NT = 4096
+SV_TYPE_WFW = 8192
+SV_TYPE_SERVER_MFPN = 16384
+SV_TYPE_SERVER_NT = 32768
+SV_TYPE_POTENTIAL_BROWSER = 65536
+SV_TYPE_BACKUP_BROWSER = 131072
+SV_TYPE_MASTER_BROWSER = 262144
+SV_TYPE_DOMAIN_MASTER = 524288
+SV_TYPE_SERVER_OSF = 1048576
+SV_TYPE_SERVER_VMS = 2097152
+SV_TYPE_WINDOWS = 4194304
+SV_TYPE_DFS = 8388608
+SV_TYPE_CLUSTER_NT = 16777216
+SV_TYPE_DCE = 268435456
+SV_TYPE_ALTERNATE_XPORT = 536870912
+SV_TYPE_LOCAL_LIST_ONLY = 1073741824
+SV_TYPE_DOMAIN_ENUM = -2147483648
+SV_TYPE_ALL = -1
+SV_NODISC = -1
+SV_USERSECURITY = 1
+SV_SHARESECURITY = 0
+SV_HIDDEN = 1
+SV_VISIBLE = 0
+SV_PLATFORM_ID_PARMNUM = 101
+SV_NAME_PARMNUM = 102
+SV_VERSION_MAJOR_PARMNUM = 103
+SV_VERSION_MINOR_PARMNUM = 104
+SV_TYPE_PARMNUM = 105
+SV_COMMENT_PARMNUM = 5
+SV_USERS_PARMNUM = 107
+SV_DISC_PARMNUM = 10
+SV_HIDDEN_PARMNUM = 16
+SV_ANNOUNCE_PARMNUM = 17
+SV_ANNDELTA_PARMNUM = 18
+SV_USERPATH_PARMNUM = 112
+SV_ULIST_MTIME_PARMNUM = 401
+SV_GLIST_MTIME_PARMNUM = 402
+SV_ALIST_MTIME_PARMNUM = 403
+SV_ALERTS_PARMNUM = 11
+SV_SECURITY_PARMNUM = 405
+SV_NUMADMIN_PARMNUM = 406
+SV_LANMASK_PARMNUM = 407
+SV_GUESTACC_PARMNUM = 408
+SV_CHDEVQ_PARMNUM = 410
+SV_CHDEVJOBS_PARMNUM = 411
+SV_CONNECTIONS_PARMNUM = 412
+SV_SHARES_PARMNUM = 413
+SV_OPENFILES_PARMNUM = 414
+SV_SESSREQS_PARMNUM = 417
+SV_ACTIVELOCKS_PARMNUM = 419
+SV_NUMREQBUF_PARMNUM = 420
+SV_NUMBIGBUF_PARMNUM = 422
+SV_NUMFILETASKS_PARMNUM = 423
+SV_ALERTSCHED_PARMNUM = 37
+SV_ERRORALERT_PARMNUM = 38
+SV_LOGONALERT_PARMNUM = 39
+SV_ACCESSALERT_PARMNUM = 40
+SV_DISKALERT_PARMNUM = 41
+SV_NETIOALERT_PARMNUM = 42
+SV_MAXAUDITSZ_PARMNUM = 43
+SV_SRVHEURISTICS_PARMNUM = 431
+SV_SESSOPENS_PARMNUM = 501
+SV_SESSVCS_PARMNUM = 502
+SV_OPENSEARCH_PARMNUM = 503
+SV_SIZREQBUF_PARMNUM = 504
+SV_INITWORKITEMS_PARMNUM = 505
+SV_MAXWORKITEMS_PARMNUM = 506
+SV_RAWWORKITEMS_PARMNUM = 507
+SV_IRPSTACKSIZE_PARMNUM = 508
+SV_MAXRAWBUFLEN_PARMNUM = 509
+SV_SESSUSERS_PARMNUM = 510
+SV_SESSCONNS_PARMNUM = 511
+SV_MAXNONPAGEDMEMORYUSAGE_PARMNUM = 512
+SV_MAXPAGEDMEMORYUSAGE_PARMNUM = 513
+SV_ENABLESOFTCOMPAT_PARMNUM = 514
+SV_ENABLEFORCEDLOGOFF_PARMNUM = 515
+SV_TIMESOURCE_PARMNUM = 516
+SV_ACCEPTDOWNLEVELAPIS_PARMNUM = 517
+SV_LMANNOUNCE_PARMNUM = 518
+SV_DOMAIN_PARMNUM = 519
+SV_MAXCOPYREADLEN_PARMNUM = 520
+SV_MAXCOPYWRITELEN_PARMNUM = 521
+SV_MINKEEPSEARCH_PARMNUM = 522
+SV_MAXKEEPSEARCH_PARMNUM = 523
+SV_MINKEEPCOMPLSEARCH_PARMNUM = 524
+SV_MAXKEEPCOMPLSEARCH_PARMNUM = 525
+SV_THREADCOUNTADD_PARMNUM = 526
+SV_NUMBLOCKTHREADS_PARMNUM = 527
+SV_SCAVTIMEOUT_PARMNUM = 528
+SV_MINRCVQUEUE_PARMNUM = 529
+SV_MINFREEWORKITEMS_PARMNUM = 530
+SV_XACTMEMSIZE_PARMNUM = 531
+SV_THREADPRIORITY_PARMNUM = 532
+SV_MAXMPXCT_PARMNUM = 533
+SV_OPLOCKBREAKWAIT_PARMNUM = 534
+SV_OPLOCKBREAKRESPONSEWAIT_PARMNUM = 535
+SV_ENABLEOPLOCKS_PARMNUM = 536
+SV_ENABLEOPLOCKFORCECLOSE_PARMNUM = 537
+SV_ENABLEFCBOPENS_PARMNUM = 538
+SV_ENABLERAW_PARMNUM = 539
+SV_ENABLESHAREDNETDRIVES_PARMNUM = 540
+SV_MINFREECONNECTIONS_PARMNUM = 541
+SV_MAXFREECONNECTIONS_PARMNUM = 542
+SV_INITSESSTABLE_PARMNUM = 543
+SV_INITCONNTABLE_PARMNUM = 544
+SV_INITFILETABLE_PARMNUM = 545
+SV_INITSEARCHTABLE_PARMNUM = 546
+SV_ALERTSCHEDULE_PARMNUM = 547
+SV_ERRORTHRESHOLD_PARMNUM = 548
+SV_NETWORKERRORTHRESHOLD_PARMNUM = 549
+SV_DISKSPACETHRESHOLD_PARMNUM = 550
+SV_MAXLINKDELAY_PARMNUM = 552
+SV_MINLINKTHROUGHPUT_PARMNUM = 553
+SV_LINKINFOVALIDTIME_PARMNUM = 554
+SV_SCAVQOSINFOUPDATETIME_PARMNUM = 555
+SV_MAXWORKITEMIDLETIME_PARMNUM = 556
+SV_MAXRAWWORKITEMS_PARMNUM = 557
+SV_PRODUCTTYPE_PARMNUM = 560
+SV_SERVERSIZE_PARMNUM = 561
+SV_CONNECTIONLESSAUTODISC_PARMNUM = 562
+SV_SHARINGVIOLATIONRETRIES_PARMNUM = 563
+SV_SHARINGVIOLATIONDELAY_PARMNUM = 564
+SV_MAXGLOBALOPENSEARCH_PARMNUM = 565
+SV_REMOVEDUPLICATESEARCHES_PARMNUM = 566
+SV_LOCKVIOLATIONRETRIES_PARMNUM = 567
+SV_LOCKVIOLATIONOFFSET_PARMNUM = 568
+SV_LOCKVIOLATIONDELAY_PARMNUM = 569
+SV_MDLREADSWITCHOVER_PARMNUM = 570
+SV_CACHEDOPENLIMIT_PARMNUM = 571
+SV_CRITICALTHREADS_PARMNUM = 572
+SV_RESTRICTNULLSESSACCESS_PARMNUM = 573
+SV_ENABLEWFW311DIRECTIPX_PARMNUM = 574
+SV_OTHERQUEUEAFFINITY_PARMNUM = 575
+SV_QUEUESAMPLESECS_PARMNUM = 576
+SV_BALANCECOUNT_PARMNUM = 577
+SV_PREFERREDAFFINITY_PARMNUM = 578
+SV_MAXFREERFCBS_PARMNUM = 579
+SV_MAXFREEMFCBS_PARMNUM = 580
+SV_MAXFREELFCBS_PARMNUM = 581
+SV_MAXFREEPAGEDPOOLCHUNKS_PARMNUM = 582
+SV_MINPAGEDPOOLCHUNKSIZE_PARMNUM = 583
+SV_MAXPAGEDPOOLCHUNKSIZE_PARMNUM = 584
+SV_SENDSFROMPREFERREDPROCESSOR_PARMNUM = 585
+SV_MAXTHREADSPERQUEUE_PARMNUM = 586
+SV_CACHEDDIRECTORYLIMIT_PARMNUM = 587
+SV_MAXCOPYLENGTH_PARMNUM = 588
+SV_ENABLEBULKTRANSFER_PARMNUM = 589
+SV_ENABLECOMPRESSION_PARMNUM = 590
+SV_AUTOSHAREWKS_PARMNUM = 591
+SV_AUTOSHARESERVER_PARMNUM = 592
+SV_ENABLESECURITYSIGNATURE_PARMNUM = 593
+SV_REQUIRESECURITYSIGNATURE_PARMNUM = 594
+SV_MINCLIENTBUFFERSIZE_PARMNUM = 595
+SV_CONNECTIONNOSESSIONSTIMEOUT_PARMNUM = 596
+SVI1_NUM_ELEMENTS = 5
+SVI2_NUM_ELEMENTS = 40
+SVI3_NUM_ELEMENTS = 44
+SW_AUTOPROF_LOAD_MASK = 1
+SW_AUTOPROF_SAVE_MASK = 2
+SV_MAX_SRV_HEUR_LEN = 32
+SV_USERS_PER_LICENSE = 5
+SVTI2_REMAP_PIPE_NAMES = 2
+
+# Generated by h2py from lmshare.h
+SHARE_NETNAME_PARMNUM = 1
+SHARE_TYPE_PARMNUM = 3
+SHARE_REMARK_PARMNUM = 4
+SHARE_PERMISSIONS_PARMNUM = 5
+SHARE_MAX_USES_PARMNUM = 6
+SHARE_CURRENT_USES_PARMNUM = 7
+SHARE_PATH_PARMNUM = 8
+SHARE_PASSWD_PARMNUM = 9
+SHARE_FILE_SD_PARMNUM = 501
+SHI1_NUM_ELEMENTS = 4
+SHI2_NUM_ELEMENTS = 10
+STYPE_DISKTREE = 0
+STYPE_PRINTQ = 1
+STYPE_DEVICE = 2
+STYPE_IPC = 3
+STYPE_SPECIAL = -2147483648
+SHI1005_FLAGS_DFS = 1
+SHI1005_FLAGS_DFS_ROOT = 2
+COW_PERMACHINE = 4
+COW_PERUSER = 8
+CSC_CACHEABLE = 16
+CSC_NOFLOWOPS = 32
+CSC_AUTO_INWARD = 64
+CSC_AUTO_OUTWARD = 128
+SHI1005_VALID_FLAGS_SET = (
+    CSC_CACHEABLE
+    | CSC_NOFLOWOPS
+    | CSC_AUTO_INWARD
+    | CSC_AUTO_OUTWARD
+    | COW_PERMACHINE
+    | COW_PERUSER
+)
+SHI1007_VALID_FLAGS_SET = SHI1005_VALID_FLAGS_SET
+SESS_GUEST = 1
+SESS_NOENCRYPTION = 2
+SESI1_NUM_ELEMENTS = 8
+SESI2_NUM_ELEMENTS = 9
+PERM_FILE_READ = 1
+PERM_FILE_WRITE = 2
+PERM_FILE_CREATE = 4
+
+# Generated by h2py from d:\mssdk\include\winnetwk.h
+WNNC_NET_MSNET = 65536
+WNNC_NET_LANMAN = 131072
+WNNC_NET_NETWARE = 196608
+WNNC_NET_VINES = 262144
+WNNC_NET_10NET = 327680
+WNNC_NET_LOCUS = 393216
+WNNC_NET_SUN_PC_NFS = 458752
+WNNC_NET_LANSTEP = 524288
+WNNC_NET_9TILES = 589824
+WNNC_NET_LANTASTIC = 655360
+WNNC_NET_AS400 = 720896
+WNNC_NET_FTP_NFS = 786432
+WNNC_NET_PATHWORKS = 851968
+WNNC_NET_LIFENET = 917504
+WNNC_NET_POWERLAN = 983040
+WNNC_NET_BWNFS = 1048576
+WNNC_NET_COGENT = 1114112
+WNNC_NET_FARALLON = 1179648
+WNNC_NET_APPLETALK = 1245184
+WNNC_NET_INTERGRAPH = 1310720
+WNNC_NET_SYMFONET = 1376256
+WNNC_NET_CLEARCASE = 1441792
+WNNC_NET_FRONTIER = 1507328
+WNNC_NET_BMC = 1572864
+WNNC_NET_DCE = 1638400
+WNNC_NET_DECORB = 2097152
+WNNC_NET_PROTSTOR = 2162688
+WNNC_NET_FJ_REDIR = 2228224
+WNNC_NET_DISTINCT = 2293760
+WNNC_NET_TWINS = 2359296
+WNNC_NET_RDR2SAMPLE = 2424832
+RESOURCE_CONNECTED = 1
+RESOURCE_GLOBALNET = 2
+RESOURCE_REMEMBERED = 3
+RESOURCE_RECENT = 4
+RESOURCE_CONTEXT = 5
+RESOURCETYPE_ANY = 0
+RESOURCETYPE_DISK = 1
+RESOURCETYPE_PRINT = 2
+RESOURCETYPE_RESERVED = 8
+RESOURCETYPE_UNKNOWN = -1
+RESOURCEUSAGE_CONNECTABLE = 1
+RESOURCEUSAGE_CONTAINER = 2
+RESOURCEUSAGE_NOLOCALDEVICE = 4
+RESOURCEUSAGE_SIBLING = 8
+RESOURCEUSAGE_ATTACHED = 16
+RESOURCEUSAGE_ALL = (
+    RESOURCEUSAGE_CONNECTABLE | RESOURCEUSAGE_CONTAINER | RESOURCEUSAGE_ATTACHED
+)
+RESOURCEUSAGE_RESERVED = -2147483648
+RESOURCEDISPLAYTYPE_GENERIC = 0
+RESOURCEDISPLAYTYPE_DOMAIN = 1
+RESOURCEDISPLAYTYPE_SERVER = 2
+RESOURCEDISPLAYTYPE_SHARE = 3
+RESOURCEDISPLAYTYPE_FILE = 4
+RESOURCEDISPLAYTYPE_GROUP = 5
+RESOURCEDISPLAYTYPE_NETWORK = 6
+RESOURCEDISPLAYTYPE_ROOT = 7
+RESOURCEDISPLAYTYPE_SHAREADMIN = 8
+RESOURCEDISPLAYTYPE_DIRECTORY = 9
+RESOURCEDISPLAYTYPE_TREE = 10
+RESOURCEDISPLAYTYPE_NDSCONTAINER = 11
+NETPROPERTY_PERSISTENT = 1
+CONNECT_UPDATE_PROFILE = 1
+CONNECT_UPDATE_RECENT = 2
+CONNECT_TEMPORARY = 4
+CONNECT_INTERACTIVE = 8
+CONNECT_PROMPT = 16
+CONNECT_NEED_DRIVE = 32
+CONNECT_REFCOUNT = 64
+CONNECT_REDIRECT = 128
+CONNECT_LOCALDRIVE = 256
+CONNECT_CURRENT_MEDIA = 512
+CONNECT_DEFERRED = 1024
+CONNECT_RESERVED = -16777216
+CONNDLG_RO_PATH = 1
+CONNDLG_CONN_POINT = 2
+CONNDLG_USE_MRU = 4
+CONNDLG_HIDE_BOX = 8
+CONNDLG_PERSIST = 16
+CONNDLG_NOT_PERSIST = 32
+DISC_UPDATE_PROFILE = 1
+DISC_NO_FORCE = 64
+UNIVERSAL_NAME_INFO_LEVEL = 1
+REMOTE_NAME_INFO_LEVEL = 2
+WNFMT_MULTILINE = 1
+WNFMT_ABBREVIATED = 2
+WNFMT_INENUM = 16
+WNFMT_CONNECTION = 32
+NETINFO_DLL16 = 1
+NETINFO_DISKRED = 4
+NETINFO_PRINTERRED = 8
+RP_LOGON = 1
+RP_INIFILE = 2
+PP_DISPLAYERRORS = 1
+WNCON_FORNETCARD = 1
+WNCON_NOTROUTED = 2
+WNCON_SLOWLINK = 4
+WNCON_DYNAMIC = 8
+
+## NETSETUP_NAME_TYPE, used with NetValidateName
+NetSetupUnknown = 0
+NetSetupMachine = 1
+NetSetupWorkgroup = 2
+NetSetupDomain = 3
+NetSetupNonExistentDomain = 4
+NetSetupDnsMachine = 5
+
+## NETSETUP_JOIN_STATUS, use with NetGetJoinInformation
+NetSetupUnknownStatus = 0
+NetSetupUnjoined = 1
+NetSetupWorkgroupName = 2
+NetSetupDomainName = 3
+
+NetValidateAuthentication = 1
+NetValidatePasswordChange = 2
+NetValidatePasswordReset = 3
diff --git a/lib/win32/lib/win32pdhquery.py b/lib/win32/lib/win32pdhquery.py
new file mode 100644
index 00000000..a48db08a
--- /dev/null
+++ b/lib/win32/lib/win32pdhquery.py
@@ -0,0 +1,571 @@
+"""
+Performance Data Helper (PDH) Query Classes
+
+Wrapper classes for end-users and high-level access to the PDH query
+mechanisms.  PDH is a win32-specific mechanism for accessing the
+performance data made available by the system.  The Python for Windows
+PDH module does not implement the "Registry" interface, implementing
+the more straightforward Query-based mechanism.
+
+The basic idea of a PDH Query is an object which can query the system
+about the status of any number of "counters."  The counters are paths
+to a particular piece of performance data.  For instance, the path 
+'\\Memory\\Available Bytes' describes just about exactly what it says
+it does, the amount of free memory on the default computer expressed 
+in Bytes.  These paths can be considerably more complex than this, 
+but part of the point of this wrapper module is to hide that
+complexity from the end-user/programmer.
+
+EXAMPLE: A more complex Path
+	'\\\\RAISTLIN\\PhysicalDisk(_Total)\\Avg. Disk Bytes/Read'
+	Raistlin --> Computer Name
+	PhysicalDisk --> Object Name
+	_Total --> The particular Instance (in this case, all instances, i.e. all drives)
+	Avg. Disk Bytes/Read --> The piece of data being monitored.
+
+EXAMPLE: Collecting Data with a Query
+	As an example, the following code implements a logger which allows the
+	user to choose what counters they would like to log, and logs those
+	counters for 30 seconds, at two-second intervals.
+	
+	query = Query()
+	query.addcounterbybrowsing()
+	query.collectdatafor(30,2)
+	
+	The data is now stored in a list of lists as:
+	query.curresults
+	
+	The counters(paths) which were used to collect the data are:
+	query.curpaths
+	
+	You can use the win32pdh.ParseCounterPath(path) utility function
+	to turn the paths into more easily read values for your task, or
+	write the data to a file, or do whatever you want with it.
+
+OTHER NOTABLE METHODS:
+	query.collectdatawhile(period) # start a logging thread for collecting data
+	query.collectdatawhile_stop() # signal the logging thread to stop logging
+	query.collectdata() # run the query only once
+	query.addperfcounter(object, counter, machine=None) # add a standard performance counter
+	query.addinstcounter(object, counter,machine=None,objtype = 'Process',volatile=1,format = win32pdh.PDH_FMT_LONG) # add a possibly volatile counter
+
+### Known bugs and limitations ###
+Due to a problem with threading under the PythonWin interpreter, there
+will be no data logged if the PythonWin window is not the foreground
+application.  Workaround: scripts using threading should be run in the
+python.exe interpreter.
+
+The volatile-counter handlers are possibly buggy, they haven't been
+tested to any extent.  The wrapper Query makes it safe to pass invalid
+paths (a -1 will be returned, or the Query will be totally ignored,
+depending on the missing element), so you should be able to work around
+the error by including all possible paths and filtering out the -1's.
+
+There is no way I know of to stop a thread which is currently sleeping,
+so you have to wait until the thread in collectdatawhile is activated
+again.  This might become a problem in situations where the collection
+period is multiple minutes (or hours, or whatever).
+
+Should make the win32pdh.ParseCounter function available to the Query
+classes as a method or something similar, so that it can be accessed
+by programmes that have just picked up an instance from somewhere.
+
+Should explicitly mention where QueryErrors can be raised, and create a
+full test set to see if there are any uncaught win32api.error's still
+hanging around.
+
+When using the python.exe interpreter, the addcounterbybrowsing-
+generated browser window is often hidden behind other windows.  No known
+workaround other than Alt-tabing to reach the browser window.
+
+### Other References ###
+The win32pdhutil module (which should be in the %pythonroot%/win32/lib 
+directory) provides quick-and-dirty utilities for one-off access to
+variables from the PDH.  Almost everything in that module can be done
+with a Query object, but it provides task-oriented functions for a
+number of common one-off tasks.
+
+If you can access the MS Developers Network Library, you can find
+information about the PDH API as MS describes it.  For a background article,
+try:
+http://msdn.microsoft.com/library/en-us/dnperfmo/html/msdn_pdhlib.asp
+
+The reference guide for the PDH API was last spotted at:
+http://msdn.microsoft.com/library/en-us/perfmon/base/using_the_pdh_interface.asp
+
+
+In general the Python version of the API is just a wrapper around the
+Query-based version of this API (as far as I can see), so you can learn what
+you need to from there.  From what I understand, the MSDN Online 
+resources are available for the price of signing up for them.  I can't
+guarantee how long that's supposed to last. (Or anything for that
+matter).
+http://premium.microsoft.com/isapi/devonly/prodinfo/msdnprod/msdnlib.idc?theURL=/msdn/library/sdkdoc/perfdata_4982.htm
+
+The eventual plan is for my (Mike Fletcher's) Starship account to include
+a section on NT Administration, and the Query is the first project
+in this plan.  There should be an article describing the creation of
+a simple logger there, but the example above is 90% of the work of
+that project, so don't sweat it if you don't find anything there.
+(currently the account hasn't been set up).
+http://starship.skyport.net/crew/mcfletch/
+
+If you need to contact me immediately, (why I can't imagine), you can
+email me at mcfletch@golden.net, or just post your question to the
+Python newsgroup with a catchy subject line.
+news:comp.lang.python
+
+### Other Stuff ###
+The Query classes are by Mike Fletcher, with the working code
+being corruptions of Mark Hammonds win32pdhutil module.
+
+Use at your own risk, no warranties, no guarantees, no assurances,
+if you use it, you accept the risk of using it, etceteras.
+
+"""
+# Feb 12, 98 - MH added "rawaddcounter" so caller can get exception details.
+
+import _thread
+import copy
+import time
+
+import win32api
+import win32pdh
+
+
+class BaseQuery:
+    """
+    Provides wrapped access to the Performance Data Helper query
+    objects, generally you should use the child class Query
+    unless you have need of doing weird things :)
+
+    This class supports two major working paradigms.  In the first,
+    you open the query, and run it as many times as you need, closing
+    the query when you're done with it.  This is suitable for static
+    queries (ones where processes being monitored don't disappear).
+
+    In the second, you allow the query to be opened each time and
+    closed afterward.  This causes the base query object to be
+    destroyed after each call.  Suitable for dynamic queries (ones
+    which watch processes which might be closed while watching.)
+    """
+
+    def __init__(self, paths=None):
+        """
+        The PDH Query object is initialised with a single, optional
+        list argument, that must be properly formatted PDH Counter
+        paths.  Generally this list will only be provided by the class
+        when it is being unpickled (removed from storage).  Normal
+        use is to call the class with no arguments and use the various
+        addcounter functions (particularly, for end user's, the use of
+        addcounterbybrowsing is the most common approach)  You might
+        want to provide the list directly if you want to hard-code the
+        elements with which your query deals (and thereby avoid the
+        overhead of unpickling the class).
+        """
+        self.counters = []
+        if paths:
+            self.paths = paths
+        else:
+            self.paths = []
+        self._base = None
+        self.active = 0
+        self.curpaths = []
+
+    def addcounterbybrowsing(
+        self, flags=win32pdh.PERF_DETAIL_WIZARD, windowtitle="Python Browser"
+    ):
+        """
+        Adds possibly multiple paths to the paths attribute of the query,
+        does this by calling the standard counter browsing dialogue.  Within
+        this dialogue, find the counter you want to log, and click: Add,
+        repeat for every path you want to log, then click on close.  The
+        paths are appended to the non-volatile paths list for this class,
+        subclasses may create a function which parses the paths and decides
+        (via heuristics) whether to add the path to the volatile or non-volatile
+        path list.
+        e.g.:
+                query.addcounter()
+        """
+        win32pdh.BrowseCounters(None, 0, self.paths.append, flags, windowtitle)
+
+    def rawaddcounter(self, object, counter, instance=None, inum=-1, machine=None):
+        """
+        Adds a single counter path, without catching any exceptions.
+
+        See addcounter for details.
+        """
+        path = win32pdh.MakeCounterPath(
+            (machine, object, instance, None, inum, counter)
+        )
+        self.paths.append(path)
+
+    def addcounter(self, object, counter, instance=None, inum=-1, machine=None):
+        """
+        Adds a single counter path to the paths attribute.  Normally
+        this will be called by a child class' speciality functions,
+        rather than being called directly by the user. (Though it isn't
+        hard to call manually, since almost everything is given a default)
+        This method is only functional when the query is closed (or hasn't
+        yet been opened).  This is to prevent conflict in multi-threaded
+        query applications).
+        e.g.:
+                query.addcounter('Memory','Available Bytes')
+        """
+        if not self.active:
+            try:
+                self.rawaddcounter(object, counter, instance, inum, machine)
+                return 0
+            except win32api.error:
+                return -1
+        else:
+            return -1
+
+    def open(self):
+        """
+        Build the base query object for this wrapper,
+        then add all of the counters required for the query.
+        Raise a QueryError if we can't complete the functions.
+        If we are already open, then do nothing.
+        """
+        if not self.active:  # to prevent having multiple open queries
+            # curpaths are made accessible here because of the possibility of volatile paths
+            # which may be dynamically altered by subclasses.
+            self.curpaths = copy.copy(self.paths)
+            try:
+                base = win32pdh.OpenQuery()
+                for path in self.paths:
+                    try:
+                        self.counters.append(win32pdh.AddCounter(base, path))
+                    except win32api.error:  # we passed a bad path
+                        self.counters.append(0)
+                        pass
+                self._base = base
+                self.active = 1
+                return 0  # open succeeded
+            except:  # if we encounter any errors, kill the Query
+                try:
+                    self.killbase(base)
+                except NameError:  # failed in creating query
+                    pass
+                self.active = 0
+                self.curpaths = []
+                raise QueryError(self)
+        return 1  # already open
+
+    def killbase(self, base=None):
+        """
+        ### This is not a public method
+        Mission critical function to kill the win32pdh objects held
+        by this object.  User's should generally use the close method
+        instead of this method, in case a sub-class has overridden
+        close to provide some special functionality.
+        """
+        # Kill Pythonic references to the objects in this object's namespace
+        self._base = None
+        counters = self.counters
+        self.counters = []
+        # we don't kill the curpaths for convenience, this allows the
+        # user to close a query and still access the last paths
+        self.active = 0
+        # Now call the delete functions on all of the objects
+        try:
+            map(win32pdh.RemoveCounter, counters)
+        except:
+            pass
+        try:
+            win32pdh.CloseQuery(base)
+        except:
+            pass
+        del counters
+        del base
+
+    def close(self):
+        """
+        Makes certain that the underlying query object has been closed,
+        and that all counters have been removed from it.  This is
+        important for reference counting.
+        You should only need to call close if you have previously called
+        open.  The collectdata methods all can handle opening and
+        closing the query.  Calling close multiple times is acceptable.
+        """
+        try:
+            self.killbase(self._base)
+        except AttributeError:
+            self.killbase()
+
+    __del__ = close
+
+    def collectdata(self, format=win32pdh.PDH_FMT_LONG):
+        """
+        Returns the formatted current values for the Query
+        """
+        if self._base:  # we are currently open, don't change this
+            return self.collectdataslave(format)
+        else:  # need to open and then close the _base, should be used by one-offs and elements tracking application instances
+            self.open()  # will raise QueryError if couldn't open the query
+            temp = self.collectdataslave(format)
+            self.close()  # will always close
+            return temp
+
+    def collectdataslave(self, format=win32pdh.PDH_FMT_LONG):
+        """
+        ### Not a public method
+        Called only when the Query is known to be open, runs over
+        the whole set of counters, appending results to the temp,
+        returns the values as a list.
+        """
+        try:
+            win32pdh.CollectQueryData(self._base)
+            temp = []
+            for counter in self.counters:
+                ok = 0
+                try:
+                    if counter:
+                        temp.append(
+                            win32pdh.GetFormattedCounterValue(counter, format)[1]
+                        )
+                        ok = 1
+                except win32api.error:
+                    pass
+                if not ok:
+                    temp.append(-1)  # a better way to signal failure???
+            return temp
+        except (
+            win32api.error
+        ):  # will happen if, for instance, no counters are part of the query and we attempt to collect data for it.
+            return [-1] * len(self.counters)
+
+    # pickle functions
+    def __getinitargs__(self):
+        """
+        ### Not a public method
+        """
+        return (self.paths,)
+
+
+class Query(BaseQuery):
+    """
+    Performance Data Helper(PDH) Query object:
+
+    Provides a wrapper around the native PDH query object which
+    allows for query reuse, query storage, and general maintenance
+    functions (adding counter paths in various ways being the most
+    obvious ones).
+    """
+
+    def __init__(self, *args, **namedargs):
+        """
+        The PDH Query object is initialised with a single, optional
+        list argument, that must be properly formatted PDH Counter
+        paths.  Generally this list will only be provided by the class
+        when it is being unpickled (removed from storage).  Normal
+        use is to call the class with no arguments and use the various
+        addcounter functions (particularly, for end user's, the use of
+        addcounterbybrowsing is the most common approach)  You might
+        want to provide the list directly if you want to hard-code the
+        elements with which your query deals (and thereby avoid the
+        overhead of unpickling the class).
+        """
+        self.volatilecounters = []
+        BaseQuery.__init__(*(self,) + args, **namedargs)
+
+    def addperfcounter(self, object, counter, machine=None):
+        """
+        A "Performance Counter" is a stable, known, common counter,
+        such as Memory, or Processor.  The use of addperfcounter by
+        end-users is deprecated, since the use of
+        addcounterbybrowsing is considerably more flexible and general.
+        It is provided here to allow the easy development of scripts
+        which need to access variables so common we know them by name
+        (such as Memory|Available Bytes), and to provide symmetry with
+        the add inst counter method.
+        usage:
+                query.addperfcounter('Memory', 'Available Bytes')
+        It is just as easy to access addcounter directly, the following
+        has an identicle effect.
+                query.addcounter('Memory', 'Available Bytes')
+        """
+        BaseQuery.addcounter(self, object=object, counter=counter, machine=machine)
+
+    def addinstcounter(
+        self,
+        object,
+        counter,
+        machine=None,
+        objtype="Process",
+        volatile=1,
+        format=win32pdh.PDH_FMT_LONG,
+    ):
+        """
+        The purpose of using an instcounter is to track particular
+        instances of a counter object (e.g. a single processor, a single
+        running copy of a process).  For instance, to track all python.exe
+        instances, you would need merely to ask:
+                query.addinstcounter('python','Virtual Bytes')
+        You can find the names of the objects and their available counters
+        by doing an addcounterbybrowsing() call on a query object (or by
+        looking in performance monitor's add dialog.)
+
+        Beyond merely rearranging the call arguments to make more sense,
+        if the volatile flag is true, the instcounters also recalculate
+        the paths of the available instances on every call to open the
+        query.
+        """
+        if volatile:
+            self.volatilecounters.append((object, counter, machine, objtype, format))
+        else:
+            self.paths[len(self.paths) :] = self.getinstpaths(
+                object, counter, machine, objtype, format
+            )
+
+    def getinstpaths(
+        self,
+        object,
+        counter,
+        machine=None,
+        objtype="Process",
+        format=win32pdh.PDH_FMT_LONG,
+    ):
+        """
+        ### Not an end-user function
+        Calculate the paths for an instance object. Should alter
+        to allow processing for lists of object-counter pairs.
+        """
+        items, instances = win32pdh.EnumObjectItems(None, None, objtype, -1)
+        # find out how many instances of this element we have...
+        instances.sort()
+        try:
+            cur = instances.index(object)
+        except ValueError:
+            return []  # no instances of this object
+        temp = [object]
+        try:
+            while instances[cur + 1] == object:
+                temp.append(object)
+                cur = cur + 1
+        except IndexError:  # if we went over the end
+            pass
+        paths = []
+        for ind in range(len(temp)):
+            # can this raise an error?
+            paths.append(
+                win32pdh.MakeCounterPath(
+                    (machine, "Process", object, None, ind, counter)
+                )
+            )
+        return paths  # should also return the number of elements for naming purposes
+
+    def open(self, *args, **namedargs):
+        """
+        Explicitly open a query:
+        When you are needing to make multiple calls to the same query,
+        it is most efficient to open the query, run all of the calls,
+        then close the query, instead of having the collectdata method
+        automatically open and close the query each time it runs.
+        There are currently no arguments to open.
+        """
+        # do all the normal opening stuff, self._base is now the query object
+        BaseQuery.open(*(self,) + args, **namedargs)
+        # should rewrite getinstpaths to take a single tuple
+        paths = []
+        for tup in self.volatilecounters:
+            paths[len(paths) :] = self.getinstpaths(*tup)
+        for path in paths:
+            try:
+                self.counters.append(win32pdh.AddCounter(self._base, path))
+                self.curpaths.append(
+                    path
+                )  # if we fail on the line above, this path won't be in the table or the counters
+            except win32api.error:
+                pass  # again, what to do with a malformed path???
+
+    def collectdatafor(self, totalperiod, period=1):
+        """
+        Non-threaded collection of performance data:
+        This method allows you to specify the total period for which you would
+        like to run the Query, and the time interval between individual
+        runs.  The collected data is stored in query.curresults at the
+        _end_ of the run.  The pathnames for the query are stored in
+        query.curpaths.
+        e.g.:
+                query.collectdatafor(30,2)
+        Will collect data for 30seconds at 2 second intervals
+        """
+        tempresults = []
+        try:
+            self.open()
+            for ind in range(totalperiod / period):
+                tempresults.append(self.collectdata())
+                time.sleep(period)
+            self.curresults = tempresults
+        finally:
+            self.close()
+
+    def collectdatawhile(self, period=1):
+        """
+        Threaded collection of performance data:
+        This method sets up a simple semaphor system for signalling
+        when you would like to start and stop a threaded data collection
+        method.  The collection runs every period seconds until the
+        semaphor attribute is set to a non-true value (which normally
+        should be done by calling query.collectdatawhile_stop() .)
+        e.g.:
+                query.collectdatawhile(2)
+                # starts the query running, returns control to the caller immediately
+                # is collecting data every two seconds.
+                # do whatever you want to do while the thread runs, then call:
+                query.collectdatawhile_stop()
+                # when you want to deal with the data.  It is generally a good idea
+                # to sleep for period seconds yourself, since the query will not copy
+                # the required data until the next iteration:
+                time.sleep(2)
+                # now you can access the data from the attributes of the query
+                query.curresults
+                query.curpaths
+        """
+        self.collectdatawhile_active = 1
+        _thread.start_new_thread(self.collectdatawhile_slave, (period,))
+
+    def collectdatawhile_stop(self):
+        """
+        Signals the collectdatawhile slave thread to stop collecting data
+        on the next logging iteration.
+        """
+        self.collectdatawhile_active = 0
+
+    def collectdatawhile_slave(self, period):
+        """
+        ### Not a public function
+        Does the threaded work of collecting the data and storing it
+        in an attribute of the class.
+        """
+        tempresults = []
+        try:
+            self.open()  # also sets active, so can't be changed.
+            while self.collectdatawhile_active:
+                tempresults.append(self.collectdata())
+                time.sleep(period)
+            self.curresults = tempresults
+        finally:
+            self.close()
+
+    # pickle functions
+    def __getinitargs__(self):
+        return (self.paths,)
+
+    def __getstate__(self):
+        return self.volatilecounters
+
+    def __setstate__(self, volatilecounters):
+        self.volatilecounters = volatilecounters
+
+
+class QueryError:
+    def __init__(self, query):
+        self.query = query
+
+    def __repr__(self):
+        return "<Query Error in %s>" % repr(self.query)
+
+    __str__ = __repr__
diff --git a/lib/win32/lib/win32pdhutil.py b/lib/win32/lib/win32pdhutil.py
new file mode 100644
index 00000000..7795dd90
--- /dev/null
+++ b/lib/win32/lib/win32pdhutil.py
@@ -0,0 +1,210 @@
+"""Utilities for the win32 Performance Data Helper module
+
+Example:
+  To get a single bit of data:
+  >>> import win32pdhutil
+  >>> win32pdhutil.GetPerformanceAttributes("Memory", "Available Bytes")
+  6053888
+  >>> win32pdhutil.FindPerformanceAttributesByName("python", counter="Virtual Bytes")
+  [22278144]
+
+  First example returns data which is not associated with any specific instance.
+
+  The second example reads data for a specific instance - hence the list return -
+  it would return one result for each instance of Python running.
+
+  In general, it can be tricky finding exactly the "name" of the data you wish to query.
+  Although you can use <om win32pdh.EnumObjectItems>(None,None,(eg)"Memory", -1) to do this,
+  the easiest way is often to simply use PerfMon to find out the names.
+"""
+
+import time
+
+import win32pdh
+
+error = win32pdh.error
+
+# Handle some localization issues.
+# see http://support.microsoft.com/default.aspx?scid=http://support.microsoft.com:80/support/kb/articles/Q287/1/59.asp&NoWebContent=1
+# Build a map of english_counter_name: counter_id
+counter_english_map = {}
+
+
+def find_pdh_counter_localized_name(english_name, machine_name=None):
+    if not counter_english_map:
+        import win32api
+        import win32con
+
+        counter_reg_value = win32api.RegQueryValueEx(
+            win32con.HKEY_PERFORMANCE_DATA, "Counter 009"
+        )
+        counter_list = counter_reg_value[0]
+        for i in range(0, len(counter_list) - 1, 2):
+            try:
+                counter_id = int(counter_list[i])
+            except ValueError:
+                continue
+            counter_english_map[counter_list[i + 1].lower()] = counter_id
+    return win32pdh.LookupPerfNameByIndex(
+        machine_name, counter_english_map[english_name.lower()]
+    )
+
+
+def GetPerformanceAttributes(
+    object, counter, instance=None, inum=-1, format=win32pdh.PDH_FMT_LONG, machine=None
+):
+    # NOTE: Many counters require 2 samples to give accurate results,
+    # including "% Processor Time" (as by definition, at any instant, a
+    # thread's CPU usage is either 0 or 100).  To read counters like this,
+    # you should copy this function, but keep the counter open, and call
+    # CollectQueryData() each time you need to know.
+    # See http://support.microsoft.com/default.aspx?scid=kb;EN-US;q262938
+    # and http://msdn.microsoft.com/library/en-us/dnperfmo/html/perfmonpt2.asp
+    # My older explanation for this was that the "AddCounter" process forced
+    # the CPU to 100%, but the above makes more sense :)
+    path = win32pdh.MakeCounterPath((machine, object, instance, None, inum, counter))
+    hq = win32pdh.OpenQuery()
+    try:
+        hc = win32pdh.AddCounter(hq, path)
+        try:
+            win32pdh.CollectQueryData(hq)
+            type, val = win32pdh.GetFormattedCounterValue(hc, format)
+            return val
+        finally:
+            win32pdh.RemoveCounter(hc)
+    finally:
+        win32pdh.CloseQuery(hq)
+
+
+def FindPerformanceAttributesByName(
+    instanceName,
+    object=None,
+    counter=None,
+    format=win32pdh.PDH_FMT_LONG,
+    machine=None,
+    bRefresh=0,
+):
+    """Find performance attributes by (case insensitive) instance name.
+
+    Given a process name, return a list with the requested attributes.
+    Most useful for returning a tuple of PIDs given a process name.
+    """
+    if object is None:
+        object = find_pdh_counter_localized_name("Process", machine)
+    if counter is None:
+        counter = find_pdh_counter_localized_name("ID Process", machine)
+    if bRefresh:  # PDH docs say this is how you do a refresh.
+        win32pdh.EnumObjects(None, machine, 0, 1)
+    instanceName = instanceName.lower()
+    items, instances = win32pdh.EnumObjectItems(None, None, object, -1)
+    # Track multiple instances.
+    instance_dict = {}
+    for instance in instances:
+        try:
+            instance_dict[instance] = instance_dict[instance] + 1
+        except KeyError:
+            instance_dict[instance] = 0
+
+    ret = []
+    for instance, max_instances in instance_dict.items():
+        for inum in range(max_instances + 1):
+            if instance.lower() == instanceName:
+                ret.append(
+                    GetPerformanceAttributes(
+                        object, counter, instance, inum, format, machine
+                    )
+                )
+    return ret
+
+
+def ShowAllProcesses():
+    object = find_pdh_counter_localized_name("Process")
+    items, instances = win32pdh.EnumObjectItems(
+        None, None, object, win32pdh.PERF_DETAIL_WIZARD
+    )
+    # Need to track multiple instances of the same name.
+    instance_dict = {}
+    for instance in instances:
+        try:
+            instance_dict[instance] = instance_dict[instance] + 1
+        except KeyError:
+            instance_dict[instance] = 0
+
+    # Bit of a hack to get useful info.
+    items = [find_pdh_counter_localized_name("ID Process")] + items[:5]
+    print("Process Name", ",".join(items))
+    for instance, max_instances in instance_dict.items():
+        for inum in range(max_instances + 1):
+            hq = win32pdh.OpenQuery()
+            hcs = []
+            for item in items:
+                path = win32pdh.MakeCounterPath(
+                    (None, object, instance, None, inum, item)
+                )
+                hcs.append(win32pdh.AddCounter(hq, path))
+            win32pdh.CollectQueryData(hq)
+            # as per http://support.microsoft.com/default.aspx?scid=kb;EN-US;q262938, some "%" based
+            # counters need two collections
+            time.sleep(0.01)
+            win32pdh.CollectQueryData(hq)
+            print("%-15s\t" % (instance[:15]), end=" ")
+            for hc in hcs:
+                type, val = win32pdh.GetFormattedCounterValue(hc, win32pdh.PDH_FMT_LONG)
+                print("%5d" % (val), end=" ")
+                win32pdh.RemoveCounter(hc)
+            print()
+            win32pdh.CloseQuery(hq)
+
+
+# NOTE: This BrowseCallback doesn't seem to work on Vista for markh.
+# XXX - look at why!?
+# Some counters on Vista require elevation, and callback would previously
+# clear exceptions without printing them.
+def BrowseCallBackDemo(counters):
+    ## BrowseCounters can now return multiple counter paths
+    for counter in counters:
+        (
+            machine,
+            object,
+            instance,
+            parentInstance,
+            index,
+            counterName,
+        ) = win32pdh.ParseCounterPath(counter)
+
+        result = GetPerformanceAttributes(
+            object, counterName, instance, index, win32pdh.PDH_FMT_DOUBLE, machine
+        )
+        print("Value of '%s' is" % counter, result)
+        print(
+            "Added '%s' on object '%s' (machine %s), instance %s(%d)-parent of %s"
+            % (counterName, object, machine, instance, index, parentInstance)
+        )
+    return 0
+
+
+def browse(
+    callback=BrowseCallBackDemo,
+    title="Python Browser",
+    level=win32pdh.PERF_DETAIL_WIZARD,
+):
+    win32pdh.BrowseCounters(None, 0, callback, level, title, ReturnMultiple=True)
+
+
+if __name__ == "__main__":
+    ShowAllProcesses()
+    # Show how to get a couple of attributes by name.
+    counter = find_pdh_counter_localized_name("Virtual Bytes")
+    print(
+        "Virtual Bytes = ", FindPerformanceAttributesByName("python", counter=counter)
+    )
+    print(
+        "Available Bytes = ",
+        GetPerformanceAttributes(
+            find_pdh_counter_localized_name("Memory"),
+            find_pdh_counter_localized_name("Available Bytes"),
+        ),
+    )
+    # And a browser.
+    print("Browsing for counters...")
+    browse()
diff --git a/lib/win32/lib/win32rcparser.py b/lib/win32/lib/win32rcparser.py
new file mode 100644
index 00000000..effe1429
--- /dev/null
+++ b/lib/win32/lib/win32rcparser.py
@@ -0,0 +1,677 @@
+# Windows dialog .RC file parser, by Adam Walker.
+
+# This module was adapted from the spambayes project, and is Copyright
+# 2003/2004 The Python Software Foundation and is covered by the Python
+# Software Foundation license.
+"""
+This is a parser for Windows .rc files, which are text files which define
+dialogs and other Windows UI resources.
+"""
+__author__ = "Adam Walker"
+__version__ = "0.11"
+
+import os
+import pprint
+import shlex
+import stat
+import sys
+
+import commctrl
+import win32con
+
+_controlMap = {
+    "DEFPUSHBUTTON": 0x80,
+    "PUSHBUTTON": 0x80,
+    "Button": 0x80,
+    "GROUPBOX": 0x80,
+    "Static": 0x82,
+    "CTEXT": 0x82,
+    "RTEXT": 0x82,
+    "LTEXT": 0x82,
+    "LISTBOX": 0x83,
+    "SCROLLBAR": 0x84,
+    "COMBOBOX": 0x85,
+    "EDITTEXT": 0x81,
+    "ICON": 0x82,
+    "RICHEDIT": "RichEdit20A",
+}
+
+# These are "default styles" for certain controls - ie, Visual Studio assumes
+# the styles will be applied, and emits a "NOT {STYLE_NAME}" if it is to be
+# disabled.  These defaults have been determined by experimentation, so may
+# not be completely accurate (most notably, some styles and/or control-types
+# may be missing.
+_addDefaults = {
+    "EDITTEXT": win32con.WS_BORDER | win32con.WS_TABSTOP,
+    "GROUPBOX": win32con.BS_GROUPBOX,
+    "LTEXT": win32con.SS_LEFT,
+    "DEFPUSHBUTTON": win32con.BS_DEFPUSHBUTTON | win32con.WS_TABSTOP,
+    "PUSHBUTTON": win32con.WS_TABSTOP,
+    "CTEXT": win32con.SS_CENTER,
+    "RTEXT": win32con.SS_RIGHT,
+    "ICON": win32con.SS_ICON,
+    "LISTBOX": win32con.LBS_NOTIFY,
+}
+
+defaultControlStyle = win32con.WS_CHILD | win32con.WS_VISIBLE
+defaultControlStyleEx = 0
+
+
+class DialogDef:
+    name = ""
+    id = 0
+    style = 0
+    styleEx = None
+    caption = ""
+    font = "MS Sans Serif"
+    fontSize = 8
+    x = 0
+    y = 0
+    w = 0
+    h = 0
+    template = None
+
+    def __init__(self, n, i):
+        self.name = n
+        self.id = i
+        self.styles = []
+        self.stylesEx = []
+        self.controls = []
+        # print "dialog def for ",self.name, self.id
+
+    def createDialogTemplate(self):
+        t = None
+        self.template = [
+            [
+                self.caption,
+                (self.x, self.y, self.w, self.h),
+                self.style,
+                self.styleEx,
+                (self.fontSize, self.font),
+            ]
+        ]
+        # Add the controls
+        for control in self.controls:
+            self.template.append(control.createDialogTemplate())
+        return self.template
+
+
+class ControlDef:
+    id = ""
+    controlType = ""
+    subType = ""
+    idNum = 0
+    style = defaultControlStyle
+    styleEx = defaultControlStyleEx
+    label = ""
+    x = 0
+    y = 0
+    w = 0
+    h = 0
+
+    def __init__(self):
+        self.styles = []
+        self.stylesEx = []
+
+    def toString(self):
+        s = (
+            "<Control id:"
+            + self.id
+            + " controlType:"
+            + self.controlType
+            + " subType:"
+            + self.subType
+            + " idNum:"
+            + str(self.idNum)
+            + " style:"
+            + str(self.style)
+            + " styles:"
+            + str(self.styles)
+            + " label:"
+            + self.label
+            + " x:"
+            + str(self.x)
+            + " y:"
+            + str(self.y)
+            + " w:"
+            + str(self.w)
+            + " h:"
+            + str(self.h)
+            + ">"
+        )
+        return s
+
+    def createDialogTemplate(self):
+        ct = self.controlType
+        if "CONTROL" == ct:
+            ct = self.subType
+        if ct in _controlMap:
+            ct = _controlMap[ct]
+        t = [
+            ct,
+            self.label,
+            self.idNum,
+            (self.x, self.y, self.w, self.h),
+            self.style,
+            self.styleEx,
+        ]
+        # print t
+        return t
+
+
+class StringDef:
+    def __init__(self, id, idNum, value):
+        self.id = id
+        self.idNum = idNum
+        self.value = value
+
+    def __repr__(self):
+        return "StringDef(%r, %r, %r)" % (self.id, self.idNum, self.value)
+
+
+class RCParser:
+    next_id = 1001
+    dialogs = {}
+    _dialogs = {}
+    debugEnabled = False
+    token = ""
+
+    def __init__(self):
+        self.ungot = False
+        self.ids = {"IDC_STATIC": -1}
+        self.names = {-1: "IDC_STATIC"}
+        self.bitmaps = {}
+        self.stringTable = {}
+        self.icons = {}
+
+    def debug(self, *args):
+        if self.debugEnabled:
+            print(args)
+
+    def getToken(self):
+        if self.ungot:
+            self.ungot = False
+            self.debug("getToken returns (ungot):", self.token)
+            return self.token
+        self.token = self.lex.get_token()
+        self.debug("getToken returns:", self.token)
+        if self.token == "":
+            self.token = None
+        return self.token
+
+    def ungetToken(self):
+        self.ungot = True
+
+    def getCheckToken(self, expected):
+        tok = self.getToken()
+        assert tok == expected, "Expected token '%s', but got token '%s'!" % (
+            expected,
+            tok,
+        )
+        return tok
+
+    def getCommaToken(self):
+        return self.getCheckToken(",")
+
+    # Return the *current* token as a number, only consuming a token
+    # if it is the negative-sign.
+    def currentNumberToken(self):
+        mult = 1
+        if self.token == "-":
+            mult = -1
+            self.getToken()
+        return int(self.token) * mult
+
+    # Return the *current* token as a string literal (ie, self.token will be a
+    # quote.  consumes all tokens until the end of the string
+    def currentQuotedString(self):
+        # Handle quoted strings - pity shlex doesn't handle it.
+        assert self.token.startswith('"'), self.token
+        bits = [self.token]
+        while 1:
+            tok = self.getToken()
+            if not tok.startswith('"'):
+                self.ungetToken()
+                break
+            bits.append(tok)
+        sval = "".join(bits)[1:-1]  # Remove end quotes.
+        # Fixup quotes in the body, and all (some?) quoted characters back
+        # to their raw value.
+        for i, o in ('""', '"'), ("\\r", "\r"), ("\\n", "\n"), ("\\t", "\t"):
+            sval = sval.replace(i, o)
+        return sval
+
+    def load(self, rcstream):
+        """
+        RCParser.loadDialogs(rcFileName) -> None
+        Load the dialog information into the parser. Dialog Definations can then be accessed
+        using the "dialogs" dictionary member (name->DialogDef). The "ids" member contains the dictionary of id->name.
+        The "names" member contains the dictionary of name->id
+        """
+        self.open(rcstream)
+        self.getToken()
+        while self.token != None:
+            self.parse()
+            self.getToken()
+
+    def open(self, rcstream):
+        self.lex = shlex.shlex(rcstream)
+        self.lex.commenters = "//#"
+
+    def parseH(self, file):
+        lex = shlex.shlex(file)
+        lex.commenters = "//"
+        token = " "
+        while token is not None:
+            token = lex.get_token()
+            if token == "" or token is None:
+                token = None
+            else:
+                if token == "define":
+                    n = lex.get_token()
+                    i = int(lex.get_token())
+                    self.ids[n] = i
+                    if i in self.names:
+                        # Dupe ID really isn't a problem - most consumers
+                        # want to go from name->id, and this is OK.
+                        # It means you can't go from id->name though.
+                        pass
+                        # ignore AppStudio special ones
+                        # if not n.startswith("_APS_"):
+                        #    print "Duplicate id",i,"for",n,"is", self.names[i]
+                    else:
+                        self.names[i] = n
+                    if self.next_id <= i:
+                        self.next_id = i + 1
+
+    def parse(self):
+        noid_parsers = {
+            "STRINGTABLE": self.parse_stringtable,
+        }
+
+        id_parsers = {
+            "DIALOG": self.parse_dialog,
+            "DIALOGEX": self.parse_dialog,
+            #            "TEXTINCLUDE":      self.parse_textinclude,
+            "BITMAP": self.parse_bitmap,
+            "ICON": self.parse_icon,
+        }
+        deep = 0
+        base_token = self.token
+        rp = noid_parsers.get(base_token)
+        if rp is not None:
+            rp()
+        else:
+            # Not something we parse that isn't prefixed by an ID
+            # See if it is an ID prefixed item - if it is, our token
+            # is the resource ID.
+            resource_id = self.token
+            self.getToken()
+            if self.token is None:
+                return
+
+            if "BEGIN" == self.token:
+                # A 'BEGIN' for a structure we don't understand - skip to the
+                # matching 'END'
+                deep = 1
+                while deep != 0 and self.token is not None:
+                    self.getToken()
+                    self.debug("Zooming over", self.token)
+                    if "BEGIN" == self.token:
+                        deep += 1
+                    elif "END" == self.token:
+                        deep -= 1
+            else:
+                rp = id_parsers.get(self.token)
+                if rp is not None:
+                    self.debug("Dispatching '%s'" % (self.token,))
+                    rp(resource_id)
+                else:
+                    # We don't know what the resource type is, but we
+                    # have already consumed the next, which can cause problems,
+                    # so push it back.
+                    self.debug("Skipping top-level '%s'" % base_token)
+                    self.ungetToken()
+
+    def addId(self, id_name):
+        if id_name in self.ids:
+            id = self.ids[id_name]
+        else:
+            # IDOK, IDCANCEL etc are special - if a real resource has this value
+            for n in ["IDOK", "IDCANCEL", "IDYES", "IDNO", "IDABORT"]:
+                if id_name == n:
+                    v = getattr(win32con, n)
+                    self.ids[n] = v
+                    self.names[v] = n
+                    return v
+            id = self.next_id
+            self.next_id += 1
+            self.ids[id_name] = id
+            self.names[id] = id_name
+        return id
+
+    def lang(self):
+        while (
+            self.token[0:4] == "LANG"
+            or self.token[0:7] == "SUBLANG"
+            or self.token == ","
+        ):
+            self.getToken()
+
+    def parse_textinclude(self, res_id):
+        while self.getToken() != "BEGIN":
+            pass
+        while 1:
+            if self.token == "END":
+                break
+            s = self.getToken()
+
+    def parse_stringtable(self):
+        while self.getToken() != "BEGIN":
+            pass
+        while 1:
+            self.getToken()
+            if self.token == "END":
+                break
+            sid = self.token
+            self.getToken()
+            sd = StringDef(sid, self.addId(sid), self.currentQuotedString())
+            self.stringTable[sid] = sd
+
+    def parse_bitmap(self, name):
+        return self.parse_bitmap_or_icon(name, self.bitmaps)
+
+    def parse_icon(self, name):
+        return self.parse_bitmap_or_icon(name, self.icons)
+
+    def parse_bitmap_or_icon(self, name, dic):
+        self.getToken()
+        while not self.token.startswith('"'):
+            self.getToken()
+        bmf = self.token[1:-1]  # quotes
+        dic[name] = bmf
+
+    def parse_dialog(self, name):
+        dlg = DialogDef(name, self.addId(name))
+        assert len(dlg.controls) == 0
+        self._dialogs[name] = dlg
+        extras = []
+        self.getToken()
+        while not self.token.isdigit():
+            self.debug("extra", self.token)
+            extras.append(self.token)
+            self.getToken()
+        dlg.x = int(self.token)
+        self.getCommaToken()
+        self.getToken()  # number
+        dlg.y = int(self.token)
+        self.getCommaToken()
+        self.getToken()  # number
+        dlg.w = int(self.token)
+        self.getCommaToken()
+        self.getToken()  # number
+        dlg.h = int(self.token)
+        self.getToken()
+        while not (self.token == None or self.token == "" or self.token == "END"):
+            if self.token == "STYLE":
+                self.dialogStyle(dlg)
+            elif self.token == "EXSTYLE":
+                self.dialogExStyle(dlg)
+            elif self.token == "CAPTION":
+                self.dialogCaption(dlg)
+            elif self.token == "FONT":
+                self.dialogFont(dlg)
+            elif self.token == "BEGIN":
+                self.controls(dlg)
+            else:
+                break
+        self.dialogs[name] = dlg.createDialogTemplate()
+
+    def dialogStyle(self, dlg):
+        dlg.style, dlg.styles = self.styles([], win32con.DS_SETFONT)
+
+    def dialogExStyle(self, dlg):
+        self.getToken()
+        dlg.styleEx, dlg.stylesEx = self.styles([], 0)
+
+    def styles(self, defaults, defaultStyle):
+        list = defaults
+        style = defaultStyle
+
+        if "STYLE" == self.token:
+            self.getToken()
+        i = 0
+        Not = False
+        while (
+            (i % 2 == 1 and ("|" == self.token or "NOT" == self.token)) or (i % 2 == 0)
+        ) and not self.token == None:
+            Not = False
+            if "NOT" == self.token:
+                Not = True
+                self.getToken()
+            i += 1
+            if self.token != "|":
+                if self.token in win32con.__dict__:
+                    value = getattr(win32con, self.token)
+                else:
+                    if self.token in commctrl.__dict__:
+                        value = getattr(commctrl, self.token)
+                    else:
+                        value = 0
+                if Not:
+                    list.append("NOT " + self.token)
+                    self.debug("styles add Not", self.token, value)
+                    style &= ~value
+                else:
+                    list.append(self.token)
+                    self.debug("styles add", self.token, value)
+                    style |= value
+            self.getToken()
+        self.debug("style is ", style)
+
+        return style, list
+
+    def dialogCaption(self, dlg):
+        if "CAPTION" == self.token:
+            self.getToken()
+        self.token = self.token[1:-1]
+        self.debug("Caption is:", self.token)
+        dlg.caption = self.token
+        self.getToken()
+
+    def dialogFont(self, dlg):
+        if "FONT" == self.token:
+            self.getToken()
+        dlg.fontSize = int(self.token)
+        self.getCommaToken()
+        self.getToken()  # Font name
+        dlg.font = self.token[1:-1]  # it's quoted
+        self.getToken()
+        while "BEGIN" != self.token:
+            self.getToken()
+
+    def controls(self, dlg):
+        if self.token == "BEGIN":
+            self.getToken()
+        # All controls look vaguely like:
+        # TYPE [text, ] Control_id, l, t, r, b [, style]
+        # .rc parser documents all control types as:
+        # CHECKBOX, COMBOBOX, CONTROL, CTEXT, DEFPUSHBUTTON, EDITTEXT, GROUPBOX,
+        # ICON, LISTBOX, LTEXT, PUSHBUTTON, RADIOBUTTON, RTEXT, SCROLLBAR
+        without_text = ["EDITTEXT", "COMBOBOX", "LISTBOX", "SCROLLBAR"]
+        while self.token != "END":
+            control = ControlDef()
+            control.controlType = self.token
+            self.getToken()
+            if control.controlType not in without_text:
+                if self.token[0:1] == '"':
+                    control.label = self.currentQuotedString()
+                # Some funny controls, like icons and picture controls use
+                # the "window text" as extra resource ID (ie, the ID of the
+                # icon itself).  This may be either a literal, or an ID string.
+                elif self.token == "-" or self.token.isdigit():
+                    control.label = str(self.currentNumberToken())
+                else:
+                    # An ID - use the numeric equiv.
+                    control.label = str(self.addId(self.token))
+                self.getCommaToken()
+                self.getToken()
+            # Control IDs may be "names" or literal ints
+            if self.token == "-" or self.token.isdigit():
+                control.id = self.currentNumberToken()
+                control.idNum = control.id
+            else:
+                # name of an ID
+                control.id = self.token
+                control.idNum = self.addId(control.id)
+            self.getCommaToken()
+
+            if control.controlType == "CONTROL":
+                self.getToken()
+                control.subType = self.token[1:-1]
+                thisDefaultStyle = defaultControlStyle | _addDefaults.get(
+                    control.subType, 0
+                )
+                # Styles
+                self.getCommaToken()
+                self.getToken()
+                control.style, control.styles = self.styles([], thisDefaultStyle)
+            else:
+                thisDefaultStyle = defaultControlStyle | _addDefaults.get(
+                    control.controlType, 0
+                )
+                # incase no style is specified.
+                control.style = thisDefaultStyle
+            # Rect
+            control.x = int(self.getToken())
+            self.getCommaToken()
+            control.y = int(self.getToken())
+            self.getCommaToken()
+            control.w = int(self.getToken())
+            self.getCommaToken()
+            self.getToken()
+            control.h = int(self.token)
+            self.getToken()
+            if self.token == ",":
+                self.getToken()
+                control.style, control.styles = self.styles([], thisDefaultStyle)
+            if self.token == ",":
+                self.getToken()
+                control.styleEx, control.stylesEx = self.styles(
+                    [], defaultControlStyleEx
+                )
+            # print control.toString()
+            dlg.controls.append(control)
+
+
+def ParseStreams(rc_file, h_file):
+    rcp = RCParser()
+    if h_file:
+        rcp.parseH(h_file)
+    try:
+        rcp.load(rc_file)
+    except:
+        lex = getattr(rcp, "lex", None)
+        if lex:
+            print("ERROR parsing dialogs at line", lex.lineno)
+            print("Next 10 tokens are:")
+            for i in range(10):
+                print(lex.get_token(), end=" ")
+            print()
+        raise
+    return rcp
+
+
+def Parse(rc_name, h_name=None):
+    if h_name:
+        h_file = open(h_name, "r")
+    else:
+        # See if same basename as the .rc
+        h_name = rc_name[:-2] + "h"
+        try:
+            h_file = open(h_name, "r")
+        except IOError:
+            # See if MSVC default of 'resource.h' in the same dir.
+            h_name = os.path.join(os.path.dirname(rc_name), "resource.h")
+            try:
+                h_file = open(h_name, "r")
+            except IOError:
+                # .h files are optional anyway
+                h_file = None
+    rc_file = open(rc_name, "r")
+    try:
+        return ParseStreams(rc_file, h_file)
+    finally:
+        if h_file is not None:
+            h_file.close()
+        rc_file.close()
+    return rcp
+
+
+def GenerateFrozenResource(rc_name, output_name, h_name=None):
+    """Converts an .rc windows resource source file into a python source file
+    with the same basic public interface as the rest of this module.
+    Particularly useful for py2exe or other 'freeze' type solutions,
+    where a frozen .py file can be used inplace of a real .rc file.
+    """
+    rcp = Parse(rc_name, h_name)
+    in_stat = os.stat(rc_name)
+
+    out = open(output_name, "wt")
+    out.write("#%s\n" % output_name)
+    out.write("#This is a generated file. Please edit %s instead.\n" % rc_name)
+    out.write("__version__=%r\n" % __version__)
+    out.write(
+        "_rc_size_=%d\n_rc_mtime_=%d\n"
+        % (in_stat[stat.ST_SIZE], in_stat[stat.ST_MTIME])
+    )
+
+    out.write("class StringDef:\n")
+    out.write("\tdef __init__(self, id, idNum, value):\n")
+    out.write("\t\tself.id = id\n")
+    out.write("\t\tself.idNum = idNum\n")
+    out.write("\t\tself.value = value\n")
+    out.write("\tdef __repr__(self):\n")
+    out.write(
+        '\t\treturn "StringDef(%r, %r, %r)" % (self.id, self.idNum, self.value)\n'
+    )
+
+    out.write("class FakeParser:\n")
+
+    for name in "dialogs", "ids", "names", "bitmaps", "icons", "stringTable":
+        out.write("\t%s = \\\n" % (name,))
+        pprint.pprint(getattr(rcp, name), out)
+        out.write("\n")
+
+    out.write("def Parse(s):\n")
+    out.write("\treturn FakeParser()\n")
+    out.close()
+
+
+if __name__ == "__main__":
+    if len(sys.argv) <= 1:
+        print(__doc__)
+        print()
+        print("See test_win32rcparser.py, and the win32rcparser directory (both")
+        print("in the test suite) for an example of this module's usage.")
+    else:
+        import pprint
+
+        filename = sys.argv[1]
+        if "-v" in sys.argv:
+            RCParser.debugEnabled = 1
+        print("Dumping all resources in '%s'" % filename)
+        resources = Parse(filename)
+        for id, ddef in resources.dialogs.items():
+            print("Dialog %s (%d controls)" % (id, len(ddef)))
+            pprint.pprint(ddef)
+            print()
+        for id, sdef in resources.stringTable.items():
+            print("String %s=%r" % (id, sdef.value))
+            print()
+        for id, sdef in resources.bitmaps.items():
+            print("Bitmap %s=%r" % (id, sdef))
+            print()
+        for id, sdef in resources.icons.items():
+            print("Icon %s=%r" % (id, sdef))
+            print()
diff --git a/lib/win32/lib/win32serviceutil.py b/lib/win32/lib/win32serviceutil.py
new file mode 100644
index 00000000..fb187530
--- /dev/null
+++ b/lib/win32/lib/win32serviceutil.py
@@ -0,0 +1,1071 @@
+# General purpose service utilities, both for standard Python scripts,
+# and for for Python programs which run as services...
+#
+# Note that most utility functions here will raise win32api.error's
+# (which is win32service.error, pywintypes.error, etc)
+# when things go wrong - eg, not enough permissions to hit the
+# registry etc.
+
+import importlib
+import os
+import sys
+import warnings
+
+import pywintypes
+import win32api
+import win32con
+import win32service
+import winerror
+
+_d = "_d" if "_d.pyd" in importlib.machinery.EXTENSION_SUFFIXES else ""
+error = RuntimeError
+
+
+# Returns the full path to an executable for hosting a Python service - typically
+# 'pythonservice.exe'
+# * If you pass a param and it exists as a file, you'll get the abs path back
+# * Otherwise we'll use the param instead of 'pythonservice.exe', and we will
+#   look for it.
+def LocatePythonServiceExe(exe=None):
+    if not exe and hasattr(sys, "frozen"):
+        # If py2exe etc calls this with no exe, default is current exe,
+        # and all setup is their problem :)
+        return sys.executable
+
+    if exe and os.path.isfile(exe):
+        return win32api.GetFullPathName(exe)
+
+    # We are confused if we aren't now looking for our default. But if that
+    # exists as specified we assume it's good.
+    exe = f"pythonservice{_d}.exe"
+    if os.path.isfile(exe):
+        return win32api.GetFullPathName(exe)
+
+    # Now we are searching for the .exe
+    # We are going to want it here.
+    correct = os.path.join(sys.exec_prefix, exe)
+    # Even if that file already exists, we copy the one installed by pywin32
+    # in-case it was upgraded.
+    # pywin32 installed it next to win32service.pyd (but we can't run it from there)
+    maybe = os.path.join(os.path.dirname(win32service.__file__), exe)
+    if os.path.exists(maybe):
+        print(f"copying host exe '{maybe}' -> '{correct}'")
+        win32api.CopyFile(maybe, correct)
+
+    if not os.path.exists(correct):
+        raise error(f"Can't find '{correct}'")
+
+    # If pywintypes.dll isn't next to us, or at least next to pythonXX.dll,
+    # there's a good chance the service will not run. That's usually copied by
+    # `pywin32_postinstall`, but putting it next to the python DLL seems
+    # reasonable.
+    # (Unlike the .exe above, we don't unconditionally copy this, and possibly
+    # copy it to a different place. Doesn't seem a good reason for that!?)
+    python_dll = win32api.GetModuleFileName(sys.dllhandle)
+    pyw = f"pywintypes{sys.version_info[0]}{sys.version_info[1]}{_d}.dll"
+    correct_pyw = os.path.join(os.path.dirname(python_dll), pyw)
+
+    if not os.path.exists(correct_pyw):
+        print(f"copying helper dll '{pywintypes.__file__}' -> '{correct_pyw}'")
+        win32api.CopyFile(pywintypes.__file__, correct_pyw)
+
+    return correct
+
+
+def _GetServiceShortName(longName):
+    # looks up a services name
+    # from the display name
+    # Thanks to Andy McKay for this code.
+    access = (
+        win32con.KEY_READ | win32con.KEY_ENUMERATE_SUB_KEYS | win32con.KEY_QUERY_VALUE
+    )
+    hkey = win32api.RegOpenKey(
+        win32con.HKEY_LOCAL_MACHINE, "SYSTEM\\CurrentControlSet\\Services", 0, access
+    )
+    num = win32api.RegQueryInfoKey(hkey)[0]
+    longName = longName.lower()
+    # loop through number of subkeys
+    for x in range(0, num):
+        # find service name, open subkey
+        svc = win32api.RegEnumKey(hkey, x)
+        skey = win32api.RegOpenKey(hkey, svc, 0, access)
+        try:
+            # find display name
+            thisName = str(win32api.RegQueryValueEx(skey, "DisplayName")[0])
+            if thisName.lower() == longName:
+                return svc
+        except win32api.error:
+            # in case there is no key called DisplayName
+            pass
+    return None
+
+
+# Open a service given either it's long or short name.
+def SmartOpenService(hscm, name, access):
+    try:
+        return win32service.OpenService(hscm, name, access)
+    except win32api.error as details:
+        if details.winerror not in [
+            winerror.ERROR_SERVICE_DOES_NOT_EXIST,
+            winerror.ERROR_INVALID_NAME,
+        ]:
+            raise
+    name = win32service.GetServiceKeyName(hscm, name)
+    return win32service.OpenService(hscm, name, access)
+
+
+def LocateSpecificServiceExe(serviceName):
+    # Return the .exe name of any service.
+    hkey = win32api.RegOpenKey(
+        win32con.HKEY_LOCAL_MACHINE,
+        "SYSTEM\\CurrentControlSet\\Services\\%s" % (serviceName),
+        0,
+        win32con.KEY_ALL_ACCESS,
+    )
+    try:
+        return win32api.RegQueryValueEx(hkey, "ImagePath")[0]
+    finally:
+        hkey.Close()
+
+
+def InstallPerfmonForService(serviceName, iniName, dllName=None):
+    # If no DLL name, look it up in the INI file name
+    if not dllName:  # May be empty string!
+        dllName = win32api.GetProfileVal("Python", "dll", "", iniName)
+    # Still not found - look for the standard one in the same dir as win32service.pyd
+    if not dllName:
+        try:
+            tryName = os.path.join(
+                os.path.split(win32service.__file__)[0], "perfmondata.dll"
+            )
+            if os.path.isfile(tryName):
+                dllName = tryName
+        except AttributeError:
+            # Frozen app? - anyway, can't find it!
+            pass
+    if not dllName:
+        raise ValueError("The name of the performance DLL must be available")
+    dllName = win32api.GetFullPathName(dllName)
+    # Now setup all the required "Performance" entries.
+    hkey = win32api.RegOpenKey(
+        win32con.HKEY_LOCAL_MACHINE,
+        "SYSTEM\\CurrentControlSet\\Services\\%s" % (serviceName),
+        0,
+        win32con.KEY_ALL_ACCESS,
+    )
+    try:
+        subKey = win32api.RegCreateKey(hkey, "Performance")
+        try:
+            win32api.RegSetValueEx(subKey, "Library", 0, win32con.REG_SZ, dllName)
+            win32api.RegSetValueEx(
+                subKey, "Open", 0, win32con.REG_SZ, "OpenPerformanceData"
+            )
+            win32api.RegSetValueEx(
+                subKey, "Close", 0, win32con.REG_SZ, "ClosePerformanceData"
+            )
+            win32api.RegSetValueEx(
+                subKey, "Collect", 0, win32con.REG_SZ, "CollectPerformanceData"
+            )
+        finally:
+            win32api.RegCloseKey(subKey)
+    finally:
+        win32api.RegCloseKey(hkey)
+    # Now do the "Lodctr" thang...
+
+    try:
+        import perfmon
+
+        path, fname = os.path.split(iniName)
+        oldPath = os.getcwd()
+        if path:
+            os.chdir(path)
+        try:
+            perfmon.LoadPerfCounterTextStrings("python.exe " + fname)
+        finally:
+            os.chdir(oldPath)
+    except win32api.error as details:
+        print("The service was installed OK, but the performance monitor")
+        print("data could not be loaded.", details)
+
+
+def _GetCommandLine(exeName, exeArgs):
+    if exeArgs is not None:
+        return exeName + " " + exeArgs
+    else:
+        return exeName
+
+
+def InstallService(
+    pythonClassString,
+    serviceName,
+    displayName,
+    startType=None,
+    errorControl=None,
+    bRunInteractive=0,
+    serviceDeps=None,
+    userName=None,
+    password=None,
+    exeName=None,
+    perfMonIni=None,
+    perfMonDll=None,
+    exeArgs=None,
+    description=None,
+    delayedstart=None,
+):
+    # Handle the default arguments.
+    if startType is None:
+        startType = win32service.SERVICE_DEMAND_START
+    serviceType = win32service.SERVICE_WIN32_OWN_PROCESS
+    if bRunInteractive:
+        serviceType = serviceType | win32service.SERVICE_INTERACTIVE_PROCESS
+    if errorControl is None:
+        errorControl = win32service.SERVICE_ERROR_NORMAL
+
+    exeName = '"%s"' % LocatePythonServiceExe(exeName)
+    commandLine = _GetCommandLine(exeName, exeArgs)
+    hscm = win32service.OpenSCManager(None, None, win32service.SC_MANAGER_ALL_ACCESS)
+    try:
+        hs = win32service.CreateService(
+            hscm,
+            serviceName,
+            displayName,
+            win32service.SERVICE_ALL_ACCESS,  # desired access
+            serviceType,  # service type
+            startType,
+            errorControl,  # error control type
+            commandLine,
+            None,
+            0,
+            serviceDeps,
+            userName,
+            password,
+        )
+        if description is not None:
+            try:
+                win32service.ChangeServiceConfig2(
+                    hs, win32service.SERVICE_CONFIG_DESCRIPTION, description
+                )
+            except NotImplementedError:
+                pass  ## ChangeServiceConfig2 and description do not exist on NT
+        if delayedstart is not None:
+            try:
+                win32service.ChangeServiceConfig2(
+                    hs,
+                    win32service.SERVICE_CONFIG_DELAYED_AUTO_START_INFO,
+                    delayedstart,
+                )
+            except (win32service.error, NotImplementedError):
+                ## delayed start only exists on Vista and later - warn only when trying to set delayed to True
+                warnings.warn("Delayed Start not available on this system")
+        win32service.CloseServiceHandle(hs)
+    finally:
+        win32service.CloseServiceHandle(hscm)
+    InstallPythonClassString(pythonClassString, serviceName)
+    # If I have performance monitor info to install, do that.
+    if perfMonIni is not None:
+        InstallPerfmonForService(serviceName, perfMonIni, perfMonDll)
+
+
+def ChangeServiceConfig(
+    pythonClassString,
+    serviceName,
+    startType=None,
+    errorControl=None,
+    bRunInteractive=0,
+    serviceDeps=None,
+    userName=None,
+    password=None,
+    exeName=None,
+    displayName=None,
+    perfMonIni=None,
+    perfMonDll=None,
+    exeArgs=None,
+    description=None,
+    delayedstart=None,
+):
+    # Before doing anything, remove any perfmon counters.
+    try:
+        import perfmon
+
+        perfmon.UnloadPerfCounterTextStrings("python.exe " + serviceName)
+    except (ImportError, win32api.error):
+        pass
+
+    # The EXE location may have changed
+    exeName = '"%s"' % LocatePythonServiceExe(exeName)
+
+    # Handle the default arguments.
+    if startType is None:
+        startType = win32service.SERVICE_NO_CHANGE
+    if errorControl is None:
+        errorControl = win32service.SERVICE_NO_CHANGE
+
+    hscm = win32service.OpenSCManager(None, None, win32service.SC_MANAGER_ALL_ACCESS)
+    serviceType = win32service.SERVICE_WIN32_OWN_PROCESS
+    if bRunInteractive:
+        serviceType = serviceType | win32service.SERVICE_INTERACTIVE_PROCESS
+    commandLine = _GetCommandLine(exeName, exeArgs)
+    try:
+        hs = SmartOpenService(hscm, serviceName, win32service.SERVICE_ALL_ACCESS)
+        try:
+            win32service.ChangeServiceConfig(
+                hs,
+                serviceType,  # service type
+                startType,
+                errorControl,  # error control type
+                commandLine,
+                None,
+                0,
+                serviceDeps,
+                userName,
+                password,
+                displayName,
+            )
+            if description is not None:
+                try:
+                    win32service.ChangeServiceConfig2(
+                        hs, win32service.SERVICE_CONFIG_DESCRIPTION, description
+                    )
+                except NotImplementedError:
+                    pass  ## ChangeServiceConfig2 and description do not exist on NT
+            if delayedstart is not None:
+                try:
+                    win32service.ChangeServiceConfig2(
+                        hs,
+                        win32service.SERVICE_CONFIG_DELAYED_AUTO_START_INFO,
+                        delayedstart,
+                    )
+                except (win32service.error, NotImplementedError):
+                    ## Delayed start only exists on Vista and later.  On Nt, will raise NotImplementedError since ChangeServiceConfig2
+                    ## doensn't exist.  On Win2k and XP, will fail with ERROR_INVALID_LEVEL
+                    ## Warn only if trying to set delayed to True
+                    if delayedstart:
+                        warnings.warn("Delayed Start not available on this system")
+        finally:
+            win32service.CloseServiceHandle(hs)
+    finally:
+        win32service.CloseServiceHandle(hscm)
+    InstallPythonClassString(pythonClassString, serviceName)
+    # If I have performance monitor info to install, do that.
+    if perfMonIni is not None:
+        InstallPerfmonForService(serviceName, perfMonIni, perfMonDll)
+
+
+def InstallPythonClassString(pythonClassString, serviceName):
+    # Now setup our Python specific entries.
+    if pythonClassString:
+        key = win32api.RegCreateKey(
+            win32con.HKEY_LOCAL_MACHINE,
+            "System\\CurrentControlSet\\Services\\%s\\PythonClass" % serviceName,
+        )
+        try:
+            win32api.RegSetValue(key, None, win32con.REG_SZ, pythonClassString)
+        finally:
+            win32api.RegCloseKey(key)
+
+
+# Utility functions for Services, to allow persistant properties.
+def SetServiceCustomOption(serviceName, option, value):
+    try:
+        serviceName = serviceName._svc_name_
+    except AttributeError:
+        pass
+    key = win32api.RegCreateKey(
+        win32con.HKEY_LOCAL_MACHINE,
+        "System\\CurrentControlSet\\Services\\%s\\Parameters" % serviceName,
+    )
+    try:
+        if type(value) == type(0):
+            win32api.RegSetValueEx(key, option, 0, win32con.REG_DWORD, value)
+        else:
+            win32api.RegSetValueEx(key, option, 0, win32con.REG_SZ, value)
+    finally:
+        win32api.RegCloseKey(key)
+
+
+def GetServiceCustomOption(serviceName, option, defaultValue=None):
+    # First param may also be a service class/instance.
+    # This allows services to pass "self"
+    try:
+        serviceName = serviceName._svc_name_
+    except AttributeError:
+        pass
+    key = win32api.RegCreateKey(
+        win32con.HKEY_LOCAL_MACHINE,
+        "System\\CurrentControlSet\\Services\\%s\\Parameters" % serviceName,
+    )
+    try:
+        try:
+            return win32api.RegQueryValueEx(key, option)[0]
+        except win32api.error:  # No value.
+            return defaultValue
+    finally:
+        win32api.RegCloseKey(key)
+
+
+def RemoveService(serviceName):
+    try:
+        import perfmon
+
+        perfmon.UnloadPerfCounterTextStrings("python.exe " + serviceName)
+    except (ImportError, win32api.error):
+        pass
+
+    hscm = win32service.OpenSCManager(None, None, win32service.SC_MANAGER_ALL_ACCESS)
+    try:
+        hs = SmartOpenService(hscm, serviceName, win32service.SERVICE_ALL_ACCESS)
+        win32service.DeleteService(hs)
+        win32service.CloseServiceHandle(hs)
+    finally:
+        win32service.CloseServiceHandle(hscm)
+
+    import win32evtlogutil
+
+    try:
+        win32evtlogutil.RemoveSourceFromRegistry(serviceName)
+    except win32api.error:
+        pass
+
+
+def ControlService(serviceName, code, machine=None):
+    hscm = win32service.OpenSCManager(machine, None, win32service.SC_MANAGER_ALL_ACCESS)
+    try:
+        hs = SmartOpenService(hscm, serviceName, win32service.SERVICE_ALL_ACCESS)
+        try:
+            status = win32service.ControlService(hs, code)
+        finally:
+            win32service.CloseServiceHandle(hs)
+    finally:
+        win32service.CloseServiceHandle(hscm)
+    return status
+
+
+def __FindSvcDeps(findName):
+    if type(findName) is pywintypes.UnicodeType:
+        findName = str(findName)
+    dict = {}
+    k = win32api.RegOpenKey(
+        win32con.HKEY_LOCAL_MACHINE, "SYSTEM\\CurrentControlSet\\Services"
+    )
+    num = 0
+    while 1:
+        try:
+            svc = win32api.RegEnumKey(k, num)
+        except win32api.error:
+            break
+        num = num + 1
+        sk = win32api.RegOpenKey(k, svc)
+        try:
+            deps, typ = win32api.RegQueryValueEx(sk, "DependOnService")
+        except win32api.error:
+            deps = ()
+        for dep in deps:
+            dep = dep.lower()
+            dep_on = dict.get(dep, [])
+            dep_on.append(svc)
+            dict[dep] = dep_on
+
+    return __ResolveDeps(findName, dict)
+
+
+def __ResolveDeps(findName, dict):
+    items = dict.get(findName.lower(), [])
+    retList = []
+    for svc in items:
+        retList.insert(0, svc)
+        retList = __ResolveDeps(svc, dict) + retList
+    return retList
+
+
+def WaitForServiceStatus(serviceName, status, waitSecs, machine=None):
+    """Waits for the service to return the specified status.  You
+    should have already requested the service to enter that state"""
+    for i in range(waitSecs * 4):
+        now_status = QueryServiceStatus(serviceName, machine)[1]
+        if now_status == status:
+            break
+        win32api.Sleep(250)
+    else:
+        raise pywintypes.error(
+            winerror.ERROR_SERVICE_REQUEST_TIMEOUT,
+            "QueryServiceStatus",
+            win32api.FormatMessage(winerror.ERROR_SERVICE_REQUEST_TIMEOUT)[:-2],
+        )
+
+
+def __StopServiceWithTimeout(hs, waitSecs=30):
+    try:
+        status = win32service.ControlService(hs, win32service.SERVICE_CONTROL_STOP)
+    except pywintypes.error as exc:
+        if exc.winerror != winerror.ERROR_SERVICE_NOT_ACTIVE:
+            raise
+    for i in range(waitSecs):
+        status = win32service.QueryServiceStatus(hs)
+        if status[1] == win32service.SERVICE_STOPPED:
+            break
+        win32api.Sleep(1000)
+    else:
+        raise pywintypes.error(
+            winerror.ERROR_SERVICE_REQUEST_TIMEOUT,
+            "ControlService",
+            win32api.FormatMessage(winerror.ERROR_SERVICE_REQUEST_TIMEOUT)[:-2],
+        )
+
+
+def StopServiceWithDeps(serviceName, machine=None, waitSecs=30):
+    # Stop a service recursively looking for dependant services
+    hscm = win32service.OpenSCManager(machine, None, win32service.SC_MANAGER_ALL_ACCESS)
+    try:
+        deps = __FindSvcDeps(serviceName)
+        for dep in deps:
+            hs = win32service.OpenService(hscm, dep, win32service.SERVICE_ALL_ACCESS)
+            try:
+                __StopServiceWithTimeout(hs, waitSecs)
+            finally:
+                win32service.CloseServiceHandle(hs)
+        # Now my service!
+        hs = win32service.OpenService(
+            hscm, serviceName, win32service.SERVICE_ALL_ACCESS
+        )
+        try:
+            __StopServiceWithTimeout(hs, waitSecs)
+        finally:
+            win32service.CloseServiceHandle(hs)
+
+    finally:
+        win32service.CloseServiceHandle(hscm)
+
+
+def StopService(serviceName, machine=None):
+    return ControlService(serviceName, win32service.SERVICE_CONTROL_STOP, machine)
+
+
+def StartService(serviceName, args=None, machine=None):
+    hscm = win32service.OpenSCManager(machine, None, win32service.SC_MANAGER_ALL_ACCESS)
+    try:
+        hs = SmartOpenService(hscm, serviceName, win32service.SERVICE_ALL_ACCESS)
+        try:
+            win32service.StartService(hs, args)
+        finally:
+            win32service.CloseServiceHandle(hs)
+    finally:
+        win32service.CloseServiceHandle(hscm)
+
+
+def RestartService(serviceName, args=None, waitSeconds=30, machine=None):
+    "Stop the service, and then start it again (with some tolerance for allowing it to stop.)"
+    try:
+        StopService(serviceName, machine)
+    except pywintypes.error as exc:
+        # Allow only "service not running" error
+        if exc.winerror != winerror.ERROR_SERVICE_NOT_ACTIVE:
+            raise
+    # Give it a few goes, as the service may take time to stop
+    for i in range(waitSeconds):
+        try:
+            StartService(serviceName, args, machine)
+            break
+        except pywintypes.error as exc:
+            if exc.winerror != winerror.ERROR_SERVICE_ALREADY_RUNNING:
+                raise
+            win32api.Sleep(1000)
+    else:
+        print("Gave up waiting for the old service to stop!")
+
+
+def _DebugCtrlHandler(evt):
+    if evt in (win32con.CTRL_C_EVENT, win32con.CTRL_BREAK_EVENT):
+        assert g_debugService
+        print("Stopping debug service.")
+        g_debugService.SvcStop()
+        return True
+    return False
+
+
+def DebugService(cls, argv=[]):
+    # Run a service in "debug" mode.  Re-implements what pythonservice.exe
+    # does when it sees a "-debug" param.
+    # Currently only used by "frozen" (ie, py2exe) programs (but later may
+    # end up being used for all services should we ever remove
+    # pythonservice.exe)
+    import servicemanager
+
+    global g_debugService
+
+    print("Debugging service %s - press Ctrl+C to stop." % (cls._svc_name_,))
+    servicemanager.Debugging(True)
+    servicemanager.PrepareToHostSingle(cls)
+    g_debugService = cls(argv)
+    # Setup a ctrl+c handler to simulate a "stop"
+    win32api.SetConsoleCtrlHandler(_DebugCtrlHandler, True)
+    try:
+        g_debugService.SvcRun()
+    finally:
+        win32api.SetConsoleCtrlHandler(_DebugCtrlHandler, False)
+        servicemanager.Debugging(False)
+        g_debugService = None
+
+
+def GetServiceClassString(cls, argv=None):
+    if argv is None:
+        argv = sys.argv
+    import pickle
+
+    modName = pickle.whichmodule(cls, cls.__name__)
+    if modName == "__main__":
+        try:
+            fname = win32api.GetFullPathName(argv[0])
+            path = os.path.split(fname)[0]
+            # Eaaaahhhh - sometimes this will be a short filename, which causes
+            # problems with 1.5.1 and the silly filename case rule.
+            filelist = win32api.FindFiles(fname)
+            # win32api.FindFiles will not detect files in a zip or exe. If list is empty,
+            # skip the test and hope the file really exists.
+            if len(filelist) != 0:
+                # Get the long name
+                fname = os.path.join(path, filelist[0][8])
+        except win32api.error:
+            raise error(
+                "Could not resolve the path name '%s' to a full path" % (argv[0])
+            )
+        modName = os.path.splitext(fname)[0]
+    return modName + "." + cls.__name__
+
+
+def QueryServiceStatus(serviceName, machine=None):
+    hscm = win32service.OpenSCManager(machine, None, win32service.SC_MANAGER_CONNECT)
+    try:
+        hs = SmartOpenService(hscm, serviceName, win32service.SERVICE_QUERY_STATUS)
+        try:
+            status = win32service.QueryServiceStatus(hs)
+        finally:
+            win32service.CloseServiceHandle(hs)
+    finally:
+        win32service.CloseServiceHandle(hscm)
+    return status
+
+
+def usage():
+    try:
+        fname = os.path.split(sys.argv[0])[1]
+    except:
+        fname = sys.argv[0]
+    print(
+        "Usage: '%s [options] install|update|remove|start [...]|stop|restart [...]|debug [...]'"
+        % fname
+    )
+    print("Options for 'install' and 'update' commands only:")
+    print(" --username domain\\username : The Username the service is to run under")
+    print(" --password password : The password for the username")
+    print(
+        " --startup [manual|auto|disabled|delayed] : How the service starts, default = manual"
+    )
+    print(" --interactive : Allow the service to interact with the desktop.")
+    print(
+        " --perfmonini file: .ini file to use for registering performance monitor data"
+    )
+    print(" --perfmondll file: .dll file to use when querying the service for")
+    print("   performance data, default = perfmondata.dll")
+    print("Options for 'start' and 'stop' commands only:")
+    print(" --wait seconds: Wait for the service to actually start or stop.")
+    print("                 If you specify --wait with the 'stop' option, the service")
+    print("                 and all dependent services will be stopped, each waiting")
+    print("                 the specified period.")
+    sys.exit(1)
+
+
+def HandleCommandLine(
+    cls,
+    serviceClassString=None,
+    argv=None,
+    customInstallOptions="",
+    customOptionHandler=None,
+):
+    """Utility function allowing services to process the command line.
+
+    Allows standard commands such as 'start', 'stop', 'debug', 'install' etc.
+
+    Install supports 'standard' command line options prefixed with '--', such as
+    --username, --password, etc.  In addition,
+    the function allows custom command line options to be handled by the calling function.
+    """
+    err = 0
+
+    if argv is None:
+        argv = sys.argv
+
+    if len(argv) <= 1:
+        usage()
+
+    serviceName = cls._svc_name_
+    serviceDisplayName = cls._svc_display_name_
+    if serviceClassString is None:
+        serviceClassString = GetServiceClassString(cls)
+
+    # Pull apart the command line
+    import getopt
+
+    try:
+        opts, args = getopt.getopt(
+            argv[1:],
+            customInstallOptions,
+            [
+                "password=",
+                "username=",
+                "startup=",
+                "perfmonini=",
+                "perfmondll=",
+                "interactive",
+                "wait=",
+            ],
+        )
+    except getopt.error as details:
+        print(details)
+        usage()
+    userName = None
+    password = None
+    perfMonIni = perfMonDll = None
+    startup = None
+    delayedstart = None
+    interactive = None
+    waitSecs = 0
+    for opt, val in opts:
+        if opt == "--username":
+            userName = val
+        elif opt == "--password":
+            password = val
+        elif opt == "--perfmonini":
+            perfMonIni = val
+        elif opt == "--perfmondll":
+            perfMonDll = val
+        elif opt == "--interactive":
+            interactive = 1
+        elif opt == "--startup":
+            map = {
+                "manual": win32service.SERVICE_DEMAND_START,
+                "auto": win32service.SERVICE_AUTO_START,
+                "delayed": win32service.SERVICE_AUTO_START,  ## ChangeServiceConfig2 called later
+                "disabled": win32service.SERVICE_DISABLED,
+            }
+            try:
+                startup = map[val.lower()]
+            except KeyError:
+                print("'%s' is not a valid startup option" % val)
+            if val.lower() == "delayed":
+                delayedstart = True
+            elif val.lower() == "auto":
+                delayedstart = False
+            ## else no change
+        elif opt == "--wait":
+            try:
+                waitSecs = int(val)
+            except ValueError:
+                print("--wait must specify an integer number of seconds.")
+                usage()
+
+    arg = args[0]
+    knownArg = 0
+    # First we process all arguments which pass additional args on
+    if arg == "start":
+        knownArg = 1
+        print("Starting service %s" % (serviceName))
+        try:
+            StartService(serviceName, args[1:])
+            if waitSecs:
+                WaitForServiceStatus(
+                    serviceName, win32service.SERVICE_RUNNING, waitSecs
+                )
+        except win32service.error as exc:
+            print("Error starting service: %s" % exc.strerror)
+            err = exc.winerror
+
+    elif arg == "restart":
+        knownArg = 1
+        print("Restarting service %s" % (serviceName))
+        RestartService(serviceName, args[1:])
+        if waitSecs:
+            WaitForServiceStatus(serviceName, win32service.SERVICE_RUNNING, waitSecs)
+
+    elif arg == "debug":
+        knownArg = 1
+        if not hasattr(sys, "frozen"):
+            # non-frozen services use pythonservice.exe which handles a
+            # -debug option
+            svcArgs = " ".join(args[1:])
+            try:
+                exeName = LocateSpecificServiceExe(serviceName)
+            except win32api.error as exc:
+                if exc.winerror == winerror.ERROR_FILE_NOT_FOUND:
+                    print("The service does not appear to be installed.")
+                    print("Please install the service before debugging it.")
+                    sys.exit(1)
+                raise
+            try:
+                os.system("%s -debug %s %s" % (exeName, serviceName, svcArgs))
+            # ^C is used to kill the debug service.  Sometimes Python also gets
+            # interrupted - ignore it...
+            except KeyboardInterrupt:
+                pass
+        else:
+            # py2exe services don't use pythonservice - so we simulate
+            # debugging here.
+            DebugService(cls, args)
+
+    if not knownArg and len(args) != 1:
+        usage()  # the rest of the cmds don't take addn args
+
+    if arg == "install":
+        knownArg = 1
+        try:
+            serviceDeps = cls._svc_deps_
+        except AttributeError:
+            serviceDeps = None
+        try:
+            exeName = cls._exe_name_
+        except AttributeError:
+            exeName = None  # Default to PythonService.exe
+        try:
+            exeArgs = cls._exe_args_
+        except AttributeError:
+            exeArgs = None
+        try:
+            description = cls._svc_description_
+        except AttributeError:
+            description = None
+        print("Installing service %s" % (serviceName,))
+        # Note that we install the service before calling the custom option
+        # handler, so if the custom handler fails, we have an installed service (from NT's POV)
+        # but is unlikely to work, as the Python code controlling it failed.  Therefore
+        # we remove the service if the first bit works, but the second doesnt!
+        try:
+            InstallService(
+                serviceClassString,
+                serviceName,
+                serviceDisplayName,
+                serviceDeps=serviceDeps,
+                startType=startup,
+                bRunInteractive=interactive,
+                userName=userName,
+                password=password,
+                exeName=exeName,
+                perfMonIni=perfMonIni,
+                perfMonDll=perfMonDll,
+                exeArgs=exeArgs,
+                description=description,
+                delayedstart=delayedstart,
+            )
+            if customOptionHandler:
+                customOptionHandler(*(opts,))
+            print("Service installed")
+        except win32service.error as exc:
+            if exc.winerror == winerror.ERROR_SERVICE_EXISTS:
+                arg = "update"  # Fall through to the "update" param!
+            else:
+                print(
+                    "Error installing service: %s (%d)" % (exc.strerror, exc.winerror)
+                )
+                err = exc.winerror
+        except ValueError as msg:  # Can be raised by custom option handler.
+            print("Error installing service: %s" % str(msg))
+            err = -1
+            # xxx - maybe I should remove after _any_ failed install - however,
+            # xxx - it may be useful to help debug to leave the service as it failed.
+            # xxx - We really _must_ remove as per the comments above...
+            # As we failed here, remove the service, so the next installation
+            # attempt works.
+            try:
+                RemoveService(serviceName)
+            except win32api.error:
+                print("Warning - could not remove the partially installed service.")
+
+    if arg == "update":
+        knownArg = 1
+        try:
+            serviceDeps = cls._svc_deps_
+        except AttributeError:
+            serviceDeps = None
+        try:
+            exeName = cls._exe_name_
+        except AttributeError:
+            exeName = None  # Default to PythonService.exe
+        try:
+            exeArgs = cls._exe_args_
+        except AttributeError:
+            exeArgs = None
+        try:
+            description = cls._svc_description_
+        except AttributeError:
+            description = None
+        print("Changing service configuration")
+        try:
+            ChangeServiceConfig(
+                serviceClassString,
+                serviceName,
+                serviceDeps=serviceDeps,
+                startType=startup,
+                bRunInteractive=interactive,
+                userName=userName,
+                password=password,
+                exeName=exeName,
+                displayName=serviceDisplayName,
+                perfMonIni=perfMonIni,
+                perfMonDll=perfMonDll,
+                exeArgs=exeArgs,
+                description=description,
+                delayedstart=delayedstart,
+            )
+            if customOptionHandler:
+                customOptionHandler(*(opts,))
+            print("Service updated")
+        except win32service.error as exc:
+            print(
+                "Error changing service configuration: %s (%d)"
+                % (exc.strerror, exc.winerror)
+            )
+            err = exc.winerror
+
+    elif arg == "remove":
+        knownArg = 1
+        print("Removing service %s" % (serviceName))
+        try:
+            RemoveService(serviceName)
+            print("Service removed")
+        except win32service.error as exc:
+            print("Error removing service: %s (%d)" % (exc.strerror, exc.winerror))
+            err = exc.winerror
+    elif arg == "stop":
+        knownArg = 1
+        print("Stopping service %s" % (serviceName))
+        try:
+            if waitSecs:
+                StopServiceWithDeps(serviceName, waitSecs=waitSecs)
+            else:
+                StopService(serviceName)
+        except win32service.error as exc:
+            print("Error stopping service: %s (%d)" % (exc.strerror, exc.winerror))
+            err = exc.winerror
+    if not knownArg:
+        err = -1
+        print("Unknown command - '%s'" % arg)
+        usage()
+    return err
+
+
+#
+# Useful base class to build services from.
+#
+class ServiceFramework:
+    # Required Attributes:
+    # _svc_name_ = The service name
+    # _svc_display_name_ = The service display name
+
+    # Optional Attributes:
+    _svc_deps_ = None  # sequence of service names on which this depends
+    _exe_name_ = None  # Default to PythonService.exe
+    _exe_args_ = None  # Default to no arguments
+    _svc_description_ = (
+        None  # Only exists on Windows 2000 or later, ignored on windows NT
+    )
+
+    def __init__(self, args):
+        import servicemanager
+
+        self.ssh = servicemanager.RegisterServiceCtrlHandler(
+            args[0], self.ServiceCtrlHandlerEx, True
+        )
+        servicemanager.SetEventSourceName(self._svc_name_)
+        self.checkPoint = 0
+
+    def GetAcceptedControls(self):
+        # Setup the service controls we accept based on our attributes. Note
+        # that if you need to handle controls via SvcOther[Ex](), you must
+        # override this.
+        accepted = 0
+        if hasattr(self, "SvcStop"):
+            accepted = accepted | win32service.SERVICE_ACCEPT_STOP
+        if hasattr(self, "SvcPause") and hasattr(self, "SvcContinue"):
+            accepted = accepted | win32service.SERVICE_ACCEPT_PAUSE_CONTINUE
+        if hasattr(self, "SvcShutdown"):
+            accepted = accepted | win32service.SERVICE_ACCEPT_SHUTDOWN
+        return accepted
+
+    def ReportServiceStatus(
+        self, serviceStatus, waitHint=5000, win32ExitCode=0, svcExitCode=0
+    ):
+        if self.ssh is None:  # Debugging!
+            return
+        if serviceStatus == win32service.SERVICE_START_PENDING:
+            accepted = 0
+        else:
+            accepted = self.GetAcceptedControls()
+
+        if serviceStatus in [
+            win32service.SERVICE_RUNNING,
+            win32service.SERVICE_STOPPED,
+        ]:
+            checkPoint = 0
+        else:
+            self.checkPoint = self.checkPoint + 1
+            checkPoint = self.checkPoint
+
+        # Now report the status to the control manager
+        status = (
+            win32service.SERVICE_WIN32_OWN_PROCESS,
+            serviceStatus,
+            accepted,  # dwControlsAccepted,
+            win32ExitCode,  # dwWin32ExitCode;
+            svcExitCode,  # dwServiceSpecificExitCode;
+            checkPoint,  # dwCheckPoint;
+            waitHint,
+        )
+        win32service.SetServiceStatus(self.ssh, status)
+
+    def SvcInterrogate(self):
+        # Assume we are running, and everyone is happy.
+        self.ReportServiceStatus(win32service.SERVICE_RUNNING)
+
+    def SvcOther(self, control):
+        try:
+            print("Unknown control status - %d" % control)
+        except IOError:
+            # services may not have a valid stdout!
+            pass
+
+    def ServiceCtrlHandler(self, control):
+        return self.ServiceCtrlHandlerEx(control, 0, None)
+
+    # The 'Ex' functions, which take additional params
+    def SvcOtherEx(self, control, event_type, data):
+        # The default here is to call self.SvcOther as that is the old behaviour.
+        # If you want to take advantage of the extra data, override this method
+        return self.SvcOther(control)
+
+    def ServiceCtrlHandlerEx(self, control, event_type, data):
+        if control == win32service.SERVICE_CONTROL_STOP:
+            return self.SvcStop()
+        elif control == win32service.SERVICE_CONTROL_PAUSE:
+            return self.SvcPause()
+        elif control == win32service.SERVICE_CONTROL_CONTINUE:
+            return self.SvcContinue()
+        elif control == win32service.SERVICE_CONTROL_INTERROGATE:
+            return self.SvcInterrogate()
+        elif control == win32service.SERVICE_CONTROL_SHUTDOWN:
+            return self.SvcShutdown()
+        else:
+            return self.SvcOtherEx(control, event_type, data)
+
+    def SvcRun(self):
+        # This is the entry point the C framework calls when the Service is
+        # started. Your Service class should implement SvcDoRun().
+        # Or you can override this method for more control over the Service
+        # statuses reported to the SCM.
+
+        # If this method raises an exception, the C framework will detect this
+        # and report a SERVICE_STOPPED status with a non-zero error code.
+
+        self.ReportServiceStatus(win32service.SERVICE_RUNNING)
+        self.SvcDoRun()
+        # Once SvcDoRun terminates, the service has stopped.
+        # We tell the SCM the service is still stopping - the C framework
+        # will automatically tell the SCM it has stopped when this returns.
+        self.ReportServiceStatus(win32service.SERVICE_STOP_PENDING)
diff --git a/lib/win32/lib/win32timezone.py b/lib/win32/lib/win32timezone.py
new file mode 100644
index 00000000..569ea9b9
--- /dev/null
+++ b/lib/win32/lib/win32timezone.py
@@ -0,0 +1,1023 @@
+# -*- coding: UTF-8 -*-
+
+"""
+win32timezone:
+    Module for handling datetime.tzinfo time zones using the windows
+registry for time zone information.  The time zone names are dependent
+on the registry entries defined by the operating system.
+
+    This module may be tested using the doctest module.
+
+    Written by Jason R. Coombs (jaraco@jaraco.com).
+    Copyright © 2003-2012.
+    All Rights Reserved.
+
+    This module is licenced for use in Mark Hammond's pywin32
+library under the same terms as the pywin32 library.
+
+    To use this time zone module with the datetime module, simply pass
+the TimeZoneInfo object to the datetime constructor.  For example,
+
+>>> import win32timezone, datetime
+>>> assert 'Mountain Standard Time' in win32timezone.TimeZoneInfo.get_sorted_time_zone_names()
+>>> MST = win32timezone.TimeZoneInfo('Mountain Standard Time')
+>>> now = datetime.datetime.now(MST)
+
+    The now object is now a time-zone aware object, and daylight savings-
+aware methods may be called on it.
+
+>>> now.utcoffset() in (datetime.timedelta(-1, 61200), datetime.timedelta(-1, 64800))
+True
+
+(note that the result of utcoffset call will be different based on when now was
+generated, unless standard time is always used)
+
+>>> now = datetime.datetime.now(TimeZoneInfo('Mountain Standard Time', True))
+>>> now.utcoffset()
+datetime.timedelta(days=-1, seconds=61200)
+
+>>> aug2 = datetime.datetime(2003, 8, 2, tzinfo = MST)
+>>> tuple(aug2.utctimetuple())
+(2003, 8, 2, 6, 0, 0, 5, 214, 0)
+>>> nov2 = datetime.datetime(2003, 11, 25, tzinfo = MST)
+>>> tuple(nov2.utctimetuple())
+(2003, 11, 25, 7, 0, 0, 1, 329, 0)
+
+To convert from one timezone to another, just use the astimezone method.
+
+>>> aug2.isoformat()
+'2003-08-02T00:00:00-06:00'
+>>> aug2est = aug2.astimezone(win32timezone.TimeZoneInfo('Eastern Standard Time'))
+>>> aug2est.isoformat()
+'2003-08-02T02:00:00-04:00'
+
+calling the displayName member will return the display name as set in the
+registry.
+
+>>> est = win32timezone.TimeZoneInfo('Eastern Standard Time')
+>>> str(est.displayName)
+'(UTC-05:00) Eastern Time (US & Canada)'
+
+>>> gmt = win32timezone.TimeZoneInfo('GMT Standard Time', True)
+>>> str(gmt.displayName)
+'(UTC+00:00) Dublin, Edinburgh, Lisbon, London'
+
+To get the complete list of available time zone keys,
+>>> zones = win32timezone.TimeZoneInfo.get_all_time_zones()
+
+If you want to get them in an order that's sorted longitudinally
+>>> zones = win32timezone.TimeZoneInfo.get_sorted_time_zones()
+
+TimeZoneInfo now supports being pickled and comparison
+>>> import pickle
+>>> tz = win32timezone.TimeZoneInfo('China Standard Time')
+>>> tz == pickle.loads(pickle.dumps(tz))
+True
+
+It's possible to construct a TimeZoneInfo from a TimeZoneDescription
+including the currently-defined zone.
+>>> tz = win32timezone.TimeZoneInfo(TimeZoneDefinition.current())
+>>> tz == pickle.loads(pickle.dumps(tz))
+True
+
+>>> aest = win32timezone.TimeZoneInfo('AUS Eastern Standard Time')
+>>> est = win32timezone.TimeZoneInfo('E. Australia Standard Time')
+>>> dt = datetime.datetime(2006, 11, 11, 1, 0, 0, tzinfo = aest)
+>>> estdt = dt.astimezone(est)
+>>> estdt.strftime('%Y-%m-%d %H:%M:%S')
+'2006-11-11 00:00:00'
+
+>>> dt = datetime.datetime(2007, 1, 12, 1, 0, 0, tzinfo = aest)
+>>> estdt = dt.astimezone(est)
+>>> estdt.strftime('%Y-%m-%d %H:%M:%S')
+'2007-01-12 00:00:00'
+
+>>> dt = datetime.datetime(2007, 6, 13, 1, 0, 0, tzinfo = aest)
+>>> estdt = dt.astimezone(est)
+>>> estdt.strftime('%Y-%m-%d %H:%M:%S')
+'2007-06-13 01:00:00'
+
+Microsoft now has a patch for handling time zones in 2007 (see
+http://support.microsoft.com/gp/cp_dst)
+
+As a result, patched systems will give an incorrect result for
+dates prior to the designated year except for Vista and its
+successors, which have dynamic time zone support.
+>>> nov2_pre_change = datetime.datetime(2003, 11, 2, tzinfo = MST)
+>>> old_response = (2003, 11, 2, 7, 0, 0, 6, 306, 0)
+>>> incorrect_patch_response = (2003, 11, 2, 6, 0, 0, 6, 306, 0)
+>>> pre_response = nov2_pre_change.utctimetuple()
+>>> pre_response in (old_response, incorrect_patch_response)
+True
+
+Furthermore, unpatched systems pre-Vista will give an incorrect
+result for dates after 2007.
+>>> nov2_post_change = datetime.datetime(2007, 11, 2, tzinfo = MST)
+>>> incorrect_unpatched_response = (2007, 11, 2, 7, 0, 0, 4, 306, 0)
+>>> new_response = (2007, 11, 2, 6, 0, 0, 4, 306, 0)
+>>> post_response = nov2_post_change.utctimetuple()
+>>> post_response in (new_response, incorrect_unpatched_response)
+True
+
+
+There is a function you can call to get some capabilities of the time
+zone data.
+>>> caps = GetTZCapabilities()
+>>> isinstance(caps, dict)
+True
+>>> 'MissingTZPatch' in caps
+True
+>>> 'DynamicTZSupport' in caps
+True
+
+>>> both_dates_correct = (pre_response == old_response and post_response == new_response)
+>>> old_dates_wrong = (pre_response == incorrect_patch_response)
+>>> new_dates_wrong = (post_response == incorrect_unpatched_response)
+
+>>> caps['DynamicTZSupport'] == both_dates_correct
+True
+
+>>> (not caps['DynamicTZSupport'] and caps['MissingTZPatch']) == new_dates_wrong
+True
+
+>>> (not caps['DynamicTZSupport'] and not caps['MissingTZPatch']) == old_dates_wrong
+True
+
+This test helps ensure language support for unicode characters
+>>> x = TIME_ZONE_INFORMATION(0, u'français')
+
+
+Test conversion from one time zone to another at a DST boundary
+===============================================================
+
+>>> tz_hi = TimeZoneInfo('Hawaiian Standard Time')
+>>> tz_pac = TimeZoneInfo('Pacific Standard Time')
+>>> time_before = datetime.datetime(2011, 11, 5, 15, 59, 59, tzinfo=tz_hi)
+>>> tz_hi.utcoffset(time_before)
+datetime.timedelta(days=-1, seconds=50400)
+>>> tz_hi.dst(time_before)
+datetime.timedelta(0)
+
+Hawaii doesn't need dynamic TZ info
+>>> getattr(tz_hi, 'dynamicInfo', None)
+
+Here's a time that gave some trouble as reported in #3523104
+because one minute later, the equivalent UTC time changes from DST
+in the U.S.
+>>> dt_hi = datetime.datetime(2011, 11, 5, 15, 59, 59, 0, tzinfo=tz_hi)
+>>> dt_hi.timetuple()
+time.struct_time(tm_year=2011, tm_mon=11, tm_mday=5, tm_hour=15, tm_min=59, tm_sec=59, tm_wday=5, tm_yday=309, tm_isdst=0)
+>>> dt_hi.utctimetuple()
+time.struct_time(tm_year=2011, tm_mon=11, tm_mday=6, tm_hour=1, tm_min=59, tm_sec=59, tm_wday=6, tm_yday=310, tm_isdst=0)
+
+Convert the time to pacific time.
+>>> dt_pac = dt_hi.astimezone(tz_pac)
+>>> dt_pac.timetuple()
+time.struct_time(tm_year=2011, tm_mon=11, tm_mday=5, tm_hour=18, tm_min=59, tm_sec=59, tm_wday=5, tm_yday=309, tm_isdst=1)
+
+Notice that the UTC time is almost 2am.
+>>> dt_pac.utctimetuple()
+time.struct_time(tm_year=2011, tm_mon=11, tm_mday=6, tm_hour=1, tm_min=59, tm_sec=59, tm_wday=6, tm_yday=310, tm_isdst=0)
+
+Now do the same tests one minute later in Hawaii.
+>>> time_after = datetime.datetime(2011, 11, 5, 16, 0, 0, 0, tzinfo=tz_hi)
+>>> tz_hi.utcoffset(time_after)
+datetime.timedelta(days=-1, seconds=50400)
+>>> tz_hi.dst(time_before)
+datetime.timedelta(0)
+
+>>> dt_hi = datetime.datetime(2011, 11, 5, 16, 0, 0, 0, tzinfo=tz_hi)
+>>> print(dt_hi.timetuple())
+time.struct_time(tm_year=2011, tm_mon=11, tm_mday=5, tm_hour=16, tm_min=0, tm_sec=0, tm_wday=5, tm_yday=309, tm_isdst=0)
+>>> print(dt_hi.utctimetuple())
+time.struct_time(tm_year=2011, tm_mon=11, tm_mday=6, tm_hour=2, tm_min=0, tm_sec=0, tm_wday=6, tm_yday=310, tm_isdst=0)
+
+According to the docs, this is what astimezone does.
+>>> utc = (dt_hi - dt_hi.utcoffset()).replace(tzinfo=tz_pac)
+>>> utc
+datetime.datetime(2011, 11, 6, 2, 0, tzinfo=TimeZoneInfo('Pacific Standard Time'))
+>>> tz_pac.fromutc(utc) == dt_hi.astimezone(tz_pac)
+True
+>>> tz_pac.fromutc(utc)
+datetime.datetime(2011, 11, 5, 19, 0, tzinfo=TimeZoneInfo('Pacific Standard Time'))
+
+Make sure the converted time is correct.
+>>> dt_pac = dt_hi.astimezone(tz_pac)
+>>> dt_pac.timetuple()
+time.struct_time(tm_year=2011, tm_mon=11, tm_mday=5, tm_hour=19, tm_min=0, tm_sec=0, tm_wday=5, tm_yday=309, tm_isdst=1)
+>>> dt_pac.utctimetuple()
+time.struct_time(tm_year=2011, tm_mon=11, tm_mday=6, tm_hour=2, tm_min=0, tm_sec=0, tm_wday=6, tm_yday=310, tm_isdst=0)
+
+Check some internal methods
+>>> tz_pac._getStandardBias(datetime.datetime(2011, 1, 1))
+datetime.timedelta(seconds=28800)
+>>> tz_pac._getDaylightBias(datetime.datetime(2011, 1, 1))
+datetime.timedelta(seconds=25200)
+
+Test the offsets
+>>> offset = tz_pac.utcoffset(datetime.datetime(2011, 11, 6, 2, 0))
+>>> offset == datetime.timedelta(hours=-8)
+True
+>>> dst_offset = tz_pac.dst(datetime.datetime(2011, 11, 6, 2, 0) + offset)
+>>> dst_offset == datetime.timedelta(hours=1)
+True
+>>> (offset + dst_offset) == datetime.timedelta(hours=-7)
+True
+
+
+Test offsets that occur right at the DST changeover
+>>> datetime.datetime.utcfromtimestamp(1320570000).replace(
+...     tzinfo=TimeZoneInfo.utc()).astimezone(tz_pac)
+datetime.datetime(2011, 11, 6, 1, 0, tzinfo=TimeZoneInfo('Pacific Standard Time'))
+
+"""
+__author__ = "Jason R. Coombs <jaraco@jaraco.com>"
+
+import datetime
+import logging
+import operator
+import re
+import struct
+import winreg
+from itertools import count
+
+import win32api
+
+log = logging.getLogger(__file__)
+
+
+# A couple of objects for working with objects as if they were native C-type
+# structures.
+class _SimpleStruct(object):
+    _fields_ = None  # must be overridden by subclasses
+
+    def __init__(self, *args, **kw):
+        for i, (name, typ) in enumerate(self._fields_):
+            def_arg = None
+            if i < len(args):
+                def_arg = args[i]
+            if name in kw:
+                def_arg = kw[name]
+            if def_arg is not None:
+                if not isinstance(def_arg, tuple):
+                    def_arg = (def_arg,)
+            else:
+                def_arg = ()
+            if len(def_arg) == 1 and isinstance(def_arg[0], typ):
+                # already an object of this type.
+                # XXX - should copy.copy???
+                def_val = def_arg[0]
+            else:
+                def_val = typ(*def_arg)
+            setattr(self, name, def_val)
+
+    def field_names(self):
+        return [f[0] for f in self._fields_]
+
+    def __eq__(self, other):
+        if not hasattr(other, "_fields_"):
+            return False
+        if self._fields_ != other._fields_:
+            return False
+        for name, _ in self._fields_:
+            if getattr(self, name) != getattr(other, name):
+                return False
+        return True
+
+    def __ne__(self, other):
+        return not self.__eq__(other)
+
+
+class SYSTEMTIME(_SimpleStruct):
+    _fields_ = [
+        ("year", int),
+        ("month", int),
+        ("day_of_week", int),
+        ("day", int),
+        ("hour", int),
+        ("minute", int),
+        ("second", int),
+        ("millisecond", int),
+    ]
+
+
+class TIME_ZONE_INFORMATION(_SimpleStruct):
+    _fields_ = [
+        ("bias", int),
+        ("standard_name", str),
+        ("standard_start", SYSTEMTIME),
+        ("standard_bias", int),
+        ("daylight_name", str),
+        ("daylight_start", SYSTEMTIME),
+        ("daylight_bias", int),
+    ]
+
+
+class DYNAMIC_TIME_ZONE_INFORMATION(_SimpleStruct):
+    _fields_ = TIME_ZONE_INFORMATION._fields_ + [
+        ("key_name", str),
+        ("dynamic_daylight_time_disabled", bool),
+    ]
+
+
+class TimeZoneDefinition(DYNAMIC_TIME_ZONE_INFORMATION):
+    """
+    A time zone definition class based on the win32
+    DYNAMIC_TIME_ZONE_INFORMATION structure.
+
+    Describes a bias against UTC (bias), and two dates at which a separate
+    additional bias applies (standard_bias and daylight_bias).
+    """
+
+    def __init__(self, *args, **kwargs):
+        """
+        Try to construct a TimeZoneDefinition from
+        a) [DYNAMIC_]TIME_ZONE_INFORMATION args
+        b) another TimeZoneDefinition
+        c) a byte structure (using _from_bytes)
+        """
+        try:
+            super(TimeZoneDefinition, self).__init__(*args, **kwargs)
+            return
+        except (TypeError, ValueError):
+            pass
+
+        try:
+            self.__init_from_other(*args, **kwargs)
+            return
+        except TypeError:
+            pass
+
+        try:
+            self.__init_from_bytes(*args, **kwargs)
+            return
+        except TypeError:
+            pass
+
+        raise TypeError("Invalid arguments for %s" % self.__class__)
+
+    def __init_from_bytes(
+        self,
+        bytes,
+        standard_name="",
+        daylight_name="",
+        key_name="",
+        daylight_disabled=False,
+    ):
+        format = "3l8h8h"
+        components = struct.unpack(format, bytes)
+        bias, standard_bias, daylight_bias = components[:3]
+        standard_start = SYSTEMTIME(*components[3:11])
+        daylight_start = SYSTEMTIME(*components[11:19])
+        super(TimeZoneDefinition, self).__init__(
+            bias,
+            standard_name,
+            standard_start,
+            standard_bias,
+            daylight_name,
+            daylight_start,
+            daylight_bias,
+            key_name,
+            daylight_disabled,
+        )
+
+    def __init_from_other(self, other):
+        if not isinstance(other, TIME_ZONE_INFORMATION):
+            raise TypeError("Not a TIME_ZONE_INFORMATION")
+        for name in other.field_names():
+            # explicitly get the value from the underlying structure
+            value = super(TimeZoneDefinition, other).__getattribute__(other, name)
+            setattr(self, name, value)
+        # consider instead of the loop above just copying the memory directly
+        # size = max(ctypes.sizeof(DYNAMIC_TIME_ZONE_INFO), ctypes.sizeof(other))
+        # ctypes.memmove(ctypes.addressof(self), other, size)
+
+    def __getattribute__(self, attr):
+        value = super(TimeZoneDefinition, self).__getattribute__(attr)
+        if "bias" in attr:
+            value = datetime.timedelta(minutes=value)
+        return value
+
+    @classmethod
+    def current(class_):
+        "Windows Platform SDK GetTimeZoneInformation"
+        code, tzi = win32api.GetTimeZoneInformation(True)
+        return code, class_(*tzi)
+
+    def set(self):
+        tzi = tuple(getattr(self, n) for n, t in self._fields_)
+        win32api.SetTimeZoneInformation(tzi)
+
+    def copy(self):
+        # XXX - this is no longer a copy!
+        return self.__class__(self)
+
+    def locate_daylight_start(self, year):
+        return self._locate_day(year, self.daylight_start)
+
+    def locate_standard_start(self, year):
+        return self._locate_day(year, self.standard_start)
+
+    @staticmethod
+    def _locate_day(year, cutoff):
+        """
+        Takes a SYSTEMTIME object, such as retrieved from a TIME_ZONE_INFORMATION
+        structure or call to GetTimeZoneInformation and interprets it based on the given
+        year to identify the actual day.
+
+        This method is necessary because the SYSTEMTIME structure refers to a day by its
+        day of the week and week of the month (e.g. 4th saturday in March).
+
+        >>> SATURDAY = 6
+        >>> MARCH = 3
+        >>> st = SYSTEMTIME(2000, MARCH, SATURDAY, 4, 0, 0, 0, 0)
+
+        # according to my calendar, the 4th Saturday in March in 2009 was the 28th
+        >>> expected_date = datetime.datetime(2009, 3, 28)
+        >>> TimeZoneDefinition._locate_day(2009, st) == expected_date
+        True
+        """
+        # MS stores Sunday as 0, Python datetime stores Monday as zero
+        target_weekday = (cutoff.day_of_week + 6) % 7
+        # For SYSTEMTIMEs relating to time zone inforamtion, cutoff.day
+        #  is the week of the month
+        week_of_month = cutoff.day
+        # so the following is the first day of that week
+        day = (week_of_month - 1) * 7 + 1
+        result = datetime.datetime(
+            year,
+            cutoff.month,
+            day,
+            cutoff.hour,
+            cutoff.minute,
+            cutoff.second,
+            cutoff.millisecond,
+        )
+        # now the result is the correct week, but not necessarily the correct day of the week
+        days_to_go = (target_weekday - result.weekday()) % 7
+        result += datetime.timedelta(days_to_go)
+        # if we selected a day in the month following the target month,
+        #  move back a week or two.
+        # This is necessary because Microsoft defines the fifth week in a month
+        #  to be the last week in a month and adding the time delta might have
+        #  pushed the result into the next month.
+        while result.month == cutoff.month + 1:
+            result -= datetime.timedelta(weeks=1)
+        return result
+
+
+class TimeZoneInfo(datetime.tzinfo):
+    """
+    Main class for handling Windows time zones.
+    Usage:
+        TimeZoneInfo(<Time Zone Standard Name>, [<Fix Standard Time>])
+
+    If <Fix Standard Time> evaluates to True, daylight savings time is
+    calculated in the same way as standard time.
+
+    >>> tzi = TimeZoneInfo('Pacific Standard Time')
+    >>> march31 = datetime.datetime(2000,3,31)
+
+    We know that time zone definitions haven't changed from 2007
+    to 2012, so regardless of whether dynamic info is available,
+    there should be consistent results for these years.
+    >>> subsequent_years = [march31.replace(year=year)
+    ...     for year in range(2007, 2013)]
+    >>> offsets = set(tzi.utcoffset(year) for year in subsequent_years)
+    >>> len(offsets)
+    1
+    """
+
+    # this key works for WinNT+, but not for the Win95 line.
+    tzRegKey = r"SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones"
+
+    def __init__(self, param=None, fix_standard_time=False):
+        if isinstance(param, TimeZoneDefinition):
+            self._LoadFromTZI(param)
+        if isinstance(param, str):
+            self.timeZoneName = param
+            self._LoadInfoFromKey()
+        self.fixedStandardTime = fix_standard_time
+
+    def _FindTimeZoneKey(self):
+        """Find the registry key for the time zone name (self.timeZoneName)."""
+        # for multi-language compatability, match the time zone name in the
+        # "Std" key of the time zone key.
+        zoneNames = dict(self._get_indexed_time_zone_keys("Std"))
+        # Also match the time zone key name itself, to be compatible with
+        # English-based hard-coded time zones.
+        timeZoneName = zoneNames.get(self.timeZoneName, self.timeZoneName)
+        key = _RegKeyDict.open(winreg.HKEY_LOCAL_MACHINE, self.tzRegKey)
+        try:
+            result = key.subkey(timeZoneName)
+        except Exception:
+            raise ValueError("Timezone Name %s not found." % timeZoneName)
+        return result
+
+    def _LoadInfoFromKey(self):
+        """Loads the information from an opened time zone registry key
+        into relevant fields of this TZI object"""
+        key = self._FindTimeZoneKey()
+        self.displayName = key["Display"]
+        self.standardName = key["Std"]
+        self.daylightName = key["Dlt"]
+        self.staticInfo = TimeZoneDefinition(key["TZI"])
+        self._LoadDynamicInfoFromKey(key)
+
+    def _LoadFromTZI(self, tzi):
+        self.timeZoneName = tzi.standard_name
+        self.displayName = "Unknown"
+        self.standardName = tzi.standard_name
+        self.daylightName = tzi.daylight_name
+        self.staticInfo = tzi
+
+    def _LoadDynamicInfoFromKey(self, key):
+        """
+        >>> tzi = TimeZoneInfo('Central Standard Time')
+
+        Here's how the RangeMap is supposed to work:
+        >>> m = RangeMap(zip([2006,2007], 'BC'),
+        ...     sort_params = dict(reverse=True),
+        ...     key_match_comparator=operator.ge)
+        >>> m.get(2000, 'A')
+        'A'
+        >>> m[2006]
+        'B'
+        >>> m[2007]
+        'C'
+        >>> m[2008]
+        'C'
+
+        >>> m[RangeMap.last_item]
+        'B'
+
+        >>> m.get(2008, m[RangeMap.last_item])
+        'C'
+
+
+        Now test the dynamic info (but fallback to our simple RangeMap
+        on systems that don't have dynamicInfo).
+
+        >>> dinfo = getattr(tzi, 'dynamicInfo', m)
+        >>> 2007 in dinfo
+        True
+        >>> 2008 in dinfo
+        False
+        >>> dinfo[2007] == dinfo[2008] == dinfo[2012]
+        True
+        """
+        try:
+            info = key.subkey("Dynamic DST")
+        except WindowsError:
+            return
+        del info["FirstEntry"]
+        del info["LastEntry"]
+        years = map(int, list(info.keys()))
+        values = map(TimeZoneDefinition, list(info.values()))
+        # create a range mapping that searches by descending year and matches
+        # if the target year is greater or equal.
+        self.dynamicInfo = RangeMap(
+            zip(years, values),
+            sort_params=dict(reverse=True),
+            key_match_comparator=operator.ge,
+        )
+
+    def __repr__(self):
+        result = "%s(%s" % (self.__class__.__name__, repr(self.timeZoneName))
+        if self.fixedStandardTime:
+            result += ", True"
+        result += ")"
+        return result
+
+    def __str__(self):
+        return self.displayName
+
+    def tzname(self, dt):
+        winInfo = self.getWinInfo(dt)
+        if self.dst(dt) == winInfo.daylight_bias:
+            result = self.daylightName
+        elif self.dst(dt) == winInfo.standard_bias:
+            result = self.standardName
+        return result
+
+    def getWinInfo(self, targetYear):
+        """
+        Return the most relevant "info" for this time zone
+        in the target year.
+        """
+        if not hasattr(self, "dynamicInfo") or not self.dynamicInfo:
+            return self.staticInfo
+        # Find the greatest year entry in self.dynamicInfo which is for
+        #  a year greater than or equal to our targetYear. If not found,
+        #  default to the earliest year.
+        return self.dynamicInfo.get(targetYear, self.dynamicInfo[RangeMap.last_item])
+
+    def _getStandardBias(self, dt):
+        winInfo = self.getWinInfo(dt.year)
+        return winInfo.bias + winInfo.standard_bias
+
+    def _getDaylightBias(self, dt):
+        winInfo = self.getWinInfo(dt.year)
+        return winInfo.bias + winInfo.daylight_bias
+
+    def utcoffset(self, dt):
+        "Calculates the utcoffset according to the datetime.tzinfo spec"
+        if dt is None:
+            return
+        winInfo = self.getWinInfo(dt.year)
+        return -winInfo.bias + self.dst(dt)
+
+    def dst(self, dt):
+        """
+        Calculate the daylight savings offset according to the
+        datetime.tzinfo spec.
+        """
+        if dt is None:
+            return
+        winInfo = self.getWinInfo(dt.year)
+        if not self.fixedStandardTime and self._inDaylightSavings(dt):
+            result = winInfo.daylight_bias
+        else:
+            result = winInfo.standard_bias
+        return -result
+
+    def _inDaylightSavings(self, dt):
+        dt = dt.replace(tzinfo=None)
+        winInfo = self.getWinInfo(dt.year)
+        try:
+            dstStart = self.GetDSTStartTime(dt.year)
+            dstEnd = self.GetDSTEndTime(dt.year)
+
+            # at the end of DST, when clocks are moved back, there's a period
+            #  of daylight_bias where it's ambiguous whether we're in DST or
+            #  not.
+            dstEndAdj = dstEnd + winInfo.daylight_bias
+
+            # the same thing could theoretically happen at the start of DST
+            #  if there's a standard_bias (which I suspect is always 0).
+            dstStartAdj = dstStart + winInfo.standard_bias
+
+            if dstStart < dstEnd:
+                in_dst = dstStartAdj <= dt < dstEndAdj
+            else:
+                # in the southern hemisphere, daylight savings time
+                #  typically ends before it begins in a given year.
+                in_dst = not (dstEndAdj < dt <= dstStartAdj)
+        except ValueError:
+            # there was an error parsing the time zone, which is normal when a
+            #  start and end time are not specified.
+            in_dst = False
+
+        return in_dst
+
+    def GetDSTStartTime(self, year):
+        "Given a year, determines the time when daylight savings time starts"
+        return self.getWinInfo(year).locate_daylight_start(year)
+
+    def GetDSTEndTime(self, year):
+        "Given a year, determines the time when daylight savings ends."
+        return self.getWinInfo(year).locate_standard_start(year)
+
+    def __cmp__(self, other):
+        return cmp(self.__dict__, other.__dict__)
+
+    def __eq__(self, other):
+        return self.__dict__ == other.__dict__
+
+    def __ne__(self, other):
+        return self.__dict__ != other.__dict__
+
+    @classmethod
+    def local(class_):
+        """Returns the local time zone as defined by the operating system in the
+        registry.
+        >>> localTZ = TimeZoneInfo.local()
+        >>> now_local = datetime.datetime.now(localTZ)
+        >>> now_UTC = datetime.datetime.utcnow()
+        >>> (now_UTC - now_local) < datetime.timedelta(seconds = 5)
+        Traceback (most recent call last):
+        ...
+        TypeError: can't subtract offset-naive and offset-aware datetimes
+
+        >>> now_UTC = now_UTC.replace(tzinfo = TimeZoneInfo('GMT Standard Time', True))
+
+        Now one can compare the results of the two offset aware values
+        >>> (now_UTC - now_local) < datetime.timedelta(seconds = 5)
+        True
+        """
+        code, info = TimeZoneDefinition.current()
+        # code is 0 if daylight savings is disabled or not defined
+        #  code is 1 or 2 if daylight savings is enabled, 2 if currently active
+        fix_standard_time = not code
+        # note that although the given information is sufficient
+        # to construct a WinTZI object, it's
+        # not sufficient to represent the time zone in which
+        # the current user is operating due
+        # to dynamic time zones.
+        return class_(info, fix_standard_time)
+
+    @classmethod
+    def utc(class_):
+        """Returns a time-zone representing UTC.
+
+        Same as TimeZoneInfo('GMT Standard Time', True) but caches the result
+        for performance.
+
+        >>> isinstance(TimeZoneInfo.utc(), TimeZoneInfo)
+        True
+        """
+        if "_tzutc" not in class_.__dict__:
+            setattr(class_, "_tzutc", class_("GMT Standard Time", True))
+        return class_._tzutc
+
+    # helper methods for accessing the timezone info from the registry
+    @staticmethod
+    def _get_time_zone_key(subkey=None):
+        "Return the registry key that stores time zone details"
+        key = _RegKeyDict.open(winreg.HKEY_LOCAL_MACHINE, TimeZoneInfo.tzRegKey)
+        if subkey:
+            key = key.subkey(subkey)
+        return key
+
+    @staticmethod
+    def _get_time_zone_key_names():
+        "Returns the names of the (registry keys of the) time zones"
+        return TimeZoneInfo._get_time_zone_key().subkeys()
+
+    @staticmethod
+    def _get_indexed_time_zone_keys(index_key="Index"):
+        """
+        Get the names of the registry keys indexed by a value in that key,
+        ignoring any keys for which that value is empty or missing.
+        """
+        key_names = list(TimeZoneInfo._get_time_zone_key_names())
+
+        def get_index_value(key_name):
+            key = TimeZoneInfo._get_time_zone_key(key_name)
+            return key.get(index_key)
+
+        values = map(get_index_value, key_names)
+
+        return (
+            (value, key_name) for value, key_name in zip(values, key_names) if value
+        )
+
+    @staticmethod
+    def get_sorted_time_zone_names():
+        """
+        Return a list of time zone names that can
+        be used to initialize TimeZoneInfo instances.
+        """
+        tzs = TimeZoneInfo.get_sorted_time_zones()
+        return [tz.standardName for tz in tzs]
+
+    @staticmethod
+    def get_all_time_zones():
+        return [TimeZoneInfo(n) for n in TimeZoneInfo._get_time_zone_key_names()]
+
+    @staticmethod
+    def get_sorted_time_zones(key=None):
+        """
+        Return the time zones sorted by some key.
+        key must be a function that takes a TimeZoneInfo object and returns
+        a value suitable for sorting on.
+        The key defaults to the bias (descending), as is done in Windows
+        (see http://blogs.msdn.com/michkap/archive/2006/12/22/1350684.aspx)
+        """
+        key = key or (lambda tzi: -tzi.staticInfo.bias)
+        zones = TimeZoneInfo.get_all_time_zones()
+        zones.sort(key=key)
+        return zones
+
+
+class _RegKeyDict(dict):
+    def __init__(self, key):
+        dict.__init__(self)
+        self.key = key
+        self.__load_values()
+
+    @classmethod
+    def open(cls, *args, **kargs):
+        return _RegKeyDict(winreg.OpenKeyEx(*args, **kargs))
+
+    def subkey(self, name):
+        return _RegKeyDict(winreg.OpenKeyEx(self.key, name))
+
+    def __load_values(self):
+        pairs = [(n, v) for (n, v, t) in self._enumerate_reg_values(self.key)]
+        self.update(pairs)
+
+    def subkeys(self):
+        return self._enumerate_reg_keys(self.key)
+
+    @staticmethod
+    def _enumerate_reg_values(key):
+        return _RegKeyDict._enumerate_reg(key, winreg.EnumValue)
+
+    @staticmethod
+    def _enumerate_reg_keys(key):
+        return _RegKeyDict._enumerate_reg(key, winreg.EnumKey)
+
+    @staticmethod
+    def _enumerate_reg(key, func):
+        "Enumerates an open registry key as an iterable generator"
+        try:
+            for index in count():
+                yield func(key, index)
+        except WindowsError:
+            pass
+
+
+def utcnow():
+    """
+    Return the UTC time now with timezone awareness as enabled
+    by this module
+    >>> now = utcnow()
+    """
+    now = datetime.datetime.utcnow()
+    now = now.replace(tzinfo=TimeZoneInfo.utc())
+    return now
+
+
+def now():
+    """
+    Return the local time now with timezone awareness as enabled
+    by this module
+    >>> now_local = now()
+    """
+    return datetime.datetime.now(TimeZoneInfo.local())
+
+
+def GetTZCapabilities():
+    """
+    Run a few known tests to determine the capabilities of
+    the time zone database on this machine.
+    Note Dynamic Time Zone support is not available on any
+    platform at this time; this
+    is a limitation of this library, not the platform."""
+    tzi = TimeZoneInfo("Mountain Standard Time")
+    MissingTZPatch = datetime.datetime(2007, 11, 2, tzinfo=tzi).utctimetuple() != (
+        2007,
+        11,
+        2,
+        6,
+        0,
+        0,
+        4,
+        306,
+        0,
+    )
+    DynamicTZSupport = not MissingTZPatch and datetime.datetime(
+        2003, 11, 2, tzinfo=tzi
+    ).utctimetuple() == (2003, 11, 2, 7, 0, 0, 6, 306, 0)
+    del tzi
+    return locals()
+
+
+class DLLHandleCache(object):
+    def __init__(self):
+        self.__cache = {}
+
+    def __getitem__(self, filename):
+        key = filename.lower()
+        return self.__cache.setdefault(key, win32api.LoadLibrary(key))
+
+
+DLLCache = DLLHandleCache()
+
+
+def resolveMUITimeZone(spec):
+    """Resolve a multilingual user interface resource for the time zone name
+    >>> #some pre-amble for the doc-tests to be py2k and py3k aware)
+    >>> try: unicode and None
+    ... except NameError: unicode=str
+    ...
+    >>> import sys
+    >>> result = resolveMUITimeZone('@tzres.dll,-110')
+    >>> expectedResultType = [type(None),unicode][sys.getwindowsversion() >= (6,)]
+    >>> type(result) is expectedResultType
+    True
+
+    spec should be of the format @path,-stringID[;comment]
+    see http://msdn2.microsoft.com/en-us/library/ms725481.aspx for details
+    """
+    pattern = re.compile(r"@(?P<dllname>.*),-(?P<index>\d+)(?:;(?P<comment>.*))?")
+    matcher = pattern.match(spec)
+    assert matcher, "Could not parse MUI spec"
+
+    try:
+        handle = DLLCache[matcher.groupdict()["dllname"]]
+        result = win32api.LoadString(handle, int(matcher.groupdict()["index"]))
+    except win32api.error:
+        result = None
+    return result
+
+
+# from jaraco.util.dictlib 5.3.1
+class RangeMap(dict):
+    """
+    A dictionary-like object that uses the keys as bounds for a range.
+    Inclusion of the value for that range is determined by the
+    key_match_comparator, which defaults to less-than-or-equal.
+    A value is returned for a key if it is the first key that matches in
+    the sorted list of keys.
+
+    One may supply keyword parameters to be passed to the sort function used
+    to sort keys (i.e. cmp [python 2 only], keys, reverse) as sort_params.
+
+    Let's create a map that maps 1-3 -> 'a', 4-6 -> 'b'
+    >>> r = RangeMap({3: 'a', 6: 'b'})  # boy, that was easy
+    >>> r[1], r[2], r[3], r[4], r[5], r[6]
+    ('a', 'a', 'a', 'b', 'b', 'b')
+
+    Even float values should work so long as the comparison operator
+    supports it.
+    >>> r[4.5]
+    'b'
+
+    But you'll notice that the way rangemap is defined, it must be open-ended on one side.
+    >>> r[0]
+    'a'
+    >>> r[-1]
+    'a'
+
+    One can close the open-end of the RangeMap by using undefined_value
+    >>> r = RangeMap({0: RangeMap.undefined_value, 3: 'a', 6: 'b'})
+    >>> r[0]
+    Traceback (most recent call last):
+    ...
+    KeyError: 0
+
+    One can get the first or last elements in the range by using RangeMap.Item
+    >>> last_item = RangeMap.Item(-1)
+    >>> r[last_item]
+    'b'
+
+    .last_item is a shortcut for Item(-1)
+    >>> r[RangeMap.last_item]
+    'b'
+
+    Sometimes it's useful to find the bounds for a RangeMap
+    >>> r.bounds()
+    (0, 6)
+
+    RangeMap supports .get(key, default)
+    >>> r.get(0, 'not found')
+    'not found'
+
+    >>> r.get(7, 'not found')
+    'not found'
+
+    """
+
+    def __init__(self, source, sort_params={}, key_match_comparator=operator.le):
+        dict.__init__(self, source)
+        self.sort_params = sort_params
+        self.match = key_match_comparator
+
+    def __getitem__(self, item):
+        sorted_keys = sorted(list(self.keys()), **self.sort_params)
+        if isinstance(item, RangeMap.Item):
+            result = self.__getitem__(sorted_keys[item])
+        else:
+            key = self._find_first_match_(sorted_keys, item)
+            result = dict.__getitem__(self, key)
+            if result is RangeMap.undefined_value:
+                raise KeyError(key)
+        return result
+
+    def get(self, key, default=None):
+        """
+        Return the value for key if key is in the dictionary, else default.
+        If default is not given, it defaults to None, so that this method
+        never raises a KeyError.
+        """
+        try:
+            return self[key]
+        except KeyError:
+            return default
+
+    def _find_first_match_(self, keys, item):
+        def is_match(k):
+            return self.match(item, k)
+
+        matches = list(filter(is_match, keys))
+        if matches:
+            return matches[0]
+        raise KeyError(item)
+
+    def bounds(self):
+        sorted_keys = sorted(list(self.keys()), **self.sort_params)
+        return (
+            sorted_keys[RangeMap.first_item],
+            sorted_keys[RangeMap.last_item],
+        )
+
+    # some special values for the RangeMap
+    undefined_value = type(str("RangeValueUndefined"), (object,), {})()
+
+    class Item(int):
+        pass
+
+    first_item = Item(0)
+    last_item = Item(-1)
diff --git a/lib/win32/lib/win32traceutil.py b/lib/win32/lib/win32traceutil.py
new file mode 100644
index 00000000..0eb38423
--- /dev/null
+++ b/lib/win32/lib/win32traceutil.py
@@ -0,0 +1,59 @@
+# This is a helper for the win32trace module
+
+# If imported from a normal Python program, it sets up sys.stdout and sys.stderr
+# so output goes to the collector.
+
+# If run from the command line, it creates a collector loop.
+
+# Eg:
+# C:>start win32traceutil.py (or python.exe win32traceutil.py)
+# will start a process with a (pretty much) blank screen.
+#
+# then, switch to a DOS prompt, and type:
+# C:>python.exe
+# Python 1.4 etc...
+# >>> import win32traceutil
+# Redirecting output to win32trace remote collector
+# >>> print "Hello"
+# >>>
+# And the output will appear in the first collector process.
+
+# Note - the client or the collector can be started first.
+# There is a 0x20000 byte buffer.  If this gets full, it is reset, and new
+# output appended from the start.
+
+import win32trace
+
+
+def RunAsCollector():
+    import sys
+
+    try:
+        import win32api
+
+        win32api.SetConsoleTitle("Python Trace Collector")
+    except:
+        pass  # Oh well!
+    win32trace.InitRead()
+    print("Collecting Python Trace Output...")
+    try:
+        while 1:
+            # a short timeout means ctrl+c works next time we wake...
+            sys.stdout.write(win32trace.blockingread(500))
+    except KeyboardInterrupt:
+        print("Ctrl+C")
+
+
+def SetupForPrint():
+    win32trace.InitWrite()
+    try:  # Under certain servers, sys.stdout may be invalid.
+        print("Redirecting output to win32trace remote collector")
+    except:
+        pass
+    win32trace.setprint()  # this works in an rexec environment.
+
+
+if __name__ == "__main__":
+    RunAsCollector()
+else:
+    SetupForPrint()
diff --git a/lib/win32/lib/win32verstamp.py b/lib/win32/lib/win32verstamp.py
new file mode 100644
index 00000000..dea032b0
--- /dev/null
+++ b/lib/win32/lib/win32verstamp.py
@@ -0,0 +1,236 @@
+""" Stamp a Win32 binary with version information.
+"""
+
+import glob
+import optparse
+import os
+import struct
+import sys
+
+from win32api import BeginUpdateResource, EndUpdateResource, UpdateResource
+
+VS_FFI_SIGNATURE = -17890115  # 0xFEEF04BD
+VS_FFI_STRUCVERSION = 0x00010000
+VS_FFI_FILEFLAGSMASK = 0x0000003F
+VOS_NT_WINDOWS32 = 0x00040004
+
+null_byte = "\0".encode("ascii")  # str in py2k, bytes in py3k
+
+
+#
+# Set VS_FF_PRERELEASE and DEBUG if Debug
+#
+def file_flags(debug):
+    if debug:
+        return 3  # VS_FF_DEBUG | VS_FF_PRERELEASE
+    return 0
+
+
+def file_type(is_dll):
+    if is_dll:
+        return 2  # VFT_DLL
+    return 1  # VFT_APP
+
+
+def VS_FIXEDFILEINFO(maj, min, sub, build, debug=0, is_dll=1):
+    return struct.pack(
+        "lllllllllllll",
+        VS_FFI_SIGNATURE,  # dwSignature
+        VS_FFI_STRUCVERSION,  # dwStrucVersion
+        (maj << 16) | min,  # dwFileVersionMS
+        (sub << 16) | build,  # dwFileVersionLS
+        (maj << 16) | min,  # dwProductVersionMS
+        (sub << 16) | build,  # dwProductVersionLS
+        VS_FFI_FILEFLAGSMASK,  # dwFileFlagsMask
+        file_flags(debug),  # dwFileFlags
+        VOS_NT_WINDOWS32,  # dwFileOS
+        file_type(is_dll),  # dwFileType
+        0x00000000,  # dwFileSubtype
+        0x00000000,  # dwFileDateMS
+        0x00000000,  # dwFileDateLS
+    )
+
+
+def nullterm(s):
+    # get raw bytes for a NULL terminated unicode string.
+    if sys.version_info[:2] < (3, 7):
+        return (str(s) + "\0").encode("unicode-internal")
+    else:
+        return (str(s) + "\0").encode("utf-16le")
+
+
+def pad32(s, extra=2):
+    # extra is normally 2 to deal with wLength
+    l = 4 - ((len(s) + extra) & 3)
+    if l < 4:
+        return s + (null_byte * l)
+    return s
+
+
+def addlen(s):
+    return struct.pack("h", len(s) + 2) + s
+
+
+def String(key, value):
+    key = nullterm(key)
+    value = nullterm(value)
+    result = struct.pack("hh", len(value) // 2, 1)  # wValueLength, wType
+    result = result + key
+    result = pad32(result) + value
+    return addlen(result)
+
+
+def StringTable(key, data):
+    key = nullterm(key)
+    result = struct.pack("hh", 0, 1)  # wValueLength, wType
+    result = result + key
+    for k, v in data.items():
+        result = result + String(k, v)
+        result = pad32(result)
+    return addlen(result)
+
+
+def StringFileInfo(data):
+    result = struct.pack("hh", 0, 1)  # wValueLength, wType
+    result = result + nullterm("StringFileInfo")
+    #  result = pad32(result) + StringTable('040904b0', data)
+    result = pad32(result) + StringTable("040904E4", data)
+    return addlen(result)
+
+
+def Var(key, value):
+    result = struct.pack("hh", len(value), 0)  # wValueLength, wType
+    result = result + nullterm(key)
+    result = pad32(result) + value
+    return addlen(result)
+
+
+def VarFileInfo(data):
+    result = struct.pack("hh", 0, 1)  # wValueLength, wType
+    result = result + nullterm("VarFileInfo")
+    result = pad32(result)
+    for k, v in data.items():
+        result = result + Var(k, v)
+    return addlen(result)
+
+
+def VS_VERSION_INFO(maj, min, sub, build, sdata, vdata, debug=0, is_dll=1):
+    ffi = VS_FIXEDFILEINFO(maj, min, sub, build, debug, is_dll)
+    result = struct.pack("hh", len(ffi), 0)  # wValueLength, wType
+    result = result + nullterm("VS_VERSION_INFO")
+    result = pad32(result) + ffi
+    result = pad32(result) + StringFileInfo(sdata) + VarFileInfo(vdata)
+    return addlen(result)
+
+
+def stamp(pathname, options):
+    # For some reason, the API functions report success if the file is open
+    # but doesnt work!  Try and open the file for writing, just to see if it is
+    # likely the stamp will work!
+    try:
+        f = open(pathname, "a+b")
+        f.close()
+    except IOError as why:
+        print("WARNING: File %s could not be opened - %s" % (pathname, why))
+
+    ver = options.version
+    try:
+        bits = [int(i) for i in ver.split(".")]
+        vmaj, vmin, vsub, vbuild = bits
+    except (IndexError, TypeError, ValueError):
+        raise ValueError("--version must be a.b.c.d (all integers) - got %r" % ver)
+
+    ifn = options.internal_name
+    if not ifn:
+        ifn = os.path.basename(pathname)
+    ofn = options.original_filename
+    if ofn is None:
+        ofn = os.path.basename(pathname)
+
+    sdata = {
+        "Comments": options.comments,
+        "CompanyName": options.company,
+        "FileDescription": options.description,
+        "FileVersion": ver,
+        "InternalName": ifn,
+        "LegalCopyright": options.copyright,
+        "LegalTrademarks": options.trademarks,
+        "OriginalFilename": ofn,
+        "ProductName": options.product,
+        "ProductVersion": ver,
+    }
+    vdata = {
+        "Translation": struct.pack("hh", 0x409, 1252),
+    }
+    is_dll = options.dll
+    if is_dll is None:
+        is_dll = os.path.splitext(pathname)[1].lower() in ".dll .pyd".split()
+    is_debug = options.debug
+    if is_debug is None:
+        is_debug = os.path.splitext(pathname)[0].lower().endswith("_d")
+    # convert None to blank strings
+    for k, v in list(sdata.items()):
+        if v is None:
+            sdata[k] = ""
+    vs = VS_VERSION_INFO(vmaj, vmin, vsub, vbuild, sdata, vdata, is_debug, is_dll)
+
+    h = BeginUpdateResource(pathname, 0)
+    UpdateResource(h, 16, 1, vs)
+    EndUpdateResource(h, 0)
+
+    if options.verbose:
+        print("Stamped:", pathname)
+
+
+if __name__ == "__main__":
+    parser = optparse.OptionParser("%prog [options] filespec ...", description=__doc__)
+
+    parser.add_option(
+        "-q",
+        "--quiet",
+        action="store_false",
+        dest="verbose",
+        default=True,
+        help="don't print status messages to stdout",
+    )
+    parser.add_option(
+        "", "--version", default="0.0.0.0", help="The version number as m.n.s.b"
+    )
+    parser.add_option(
+        "",
+        "--dll",
+        help="""Stamp the file as a DLL.  Default is to look at the
+                            file extension for .dll or .pyd.""",
+    )
+    parser.add_option("", "--debug", help="""Stamp the file as a debug binary.""")
+    parser.add_option("", "--product", help="""The product name to embed.""")
+    parser.add_option("", "--company", help="""The company name to embed.""")
+    parser.add_option("", "--trademarks", help="The trademark string to embed.")
+    parser.add_option("", "--comments", help="The comments string to embed.")
+    parser.add_option(
+        "", "--copyright", help="""The copyright message string to embed."""
+    )
+    parser.add_option(
+        "", "--description", metavar="DESC", help="The description to embed."
+    )
+    parser.add_option(
+        "",
+        "--internal-name",
+        metavar="NAME",
+        help="""The internal filename to embed. If not specified
+                         the base filename is used.""",
+    )
+    parser.add_option(
+        "",
+        "--original-filename",
+        help="""The original filename to embed. If not specified
+                            the base filename is used.""",
+    )
+
+    options, args = parser.parse_args()
+    if not args:
+        parser.error("You must supply a file to stamp.  Use --help for details.")
+
+    for g in args:
+        for f in glob.glob(g):
+            stamp(f, options)
diff --git a/lib/win32/lib/winerror.py b/lib/win32/lib/winerror.py
new file mode 100644
index 00000000..d7697dbd
--- /dev/null
+++ b/lib/win32/lib/winerror.py
@@ -0,0 +1,3039 @@
+"""Error related constants for win32
+
+Generated by h2py from winerror.h
+"""
+# Few extras added manually...
+TRUST_E_PROVIDER_UNKNOWN = -2146762751
+TRUST_E_ACTION_UNKNOWN = -2146762750
+TRUST_E_SUBJECT_FORM_UNKNOWN = -2146762749
+TRUST_E_SUBJECT_NOT_TRUSTED = -2146762748
+# up to here...
+
+FACILITY_WINRM = 51
+FACILITY_WINDOWSUPDATE = 36
+FACILITY_WINDOWS_DEFENDER = 80
+FACILITY_WINDOWS_CE = 24
+FACILITY_WINDOWS = 8
+FACILITY_URT = 19
+FACILITY_UMI = 22
+FACILITY_TPM_SOFTWARE = 41
+FACILITY_TPM_SERVICES = 40
+FACILITY_SXS = 23
+FACILITY_STORAGE = 3
+FACILITY_STATE_MANAGEMENT = 34
+FACILITY_SSPI = 9
+FACILITY_SCARD = 16
+FACILITY_SHELL = 39
+FACILITY_SETUPAPI = 15
+FACILITY_SECURITY = 9
+FACILITY_RPC = 1
+FACILITY_PLA = 48
+FACILITY_WIN32 = 7
+FACILITY_CONTROL = 10
+FACILITY_NULL = 0
+FACILITY_NDIS = 52
+FACILITY_METADIRECTORY = 35
+FACILITY_MSMQ = 14
+FACILITY_MEDIASERVER = 13
+FACILITY_INTERNET = 12
+FACILITY_ITF = 4
+FACILITY_USERMODE_HYPERVISOR = 53
+FACILITY_HTTP = 25
+FACILITY_GRAPHICS = 38
+FACILITY_FWP = 50
+FACILITY_FVE = 49
+FACILITY_USERMODE_FILTER_MANAGER = 31
+FACILITY_DPLAY = 21
+FACILITY_DISPATCH = 2
+FACILITY_DIRECTORYSERVICE = 37
+FACILITY_CONFIGURATION = 33
+FACILITY_COMPLUS = 17
+FACILITY_USERMODE_COMMONLOG = 26
+FACILITY_CMI = 54
+FACILITY_CERT = 11
+FACILITY_BACKGROUNDCOPY = 32
+FACILITY_ACS = 20
+FACILITY_AAF = 18
+ERROR_SUCCESS = 0
+NO_ERROR = 0
+S_OK = 0
+S_FALSE = 1
+ERROR_INVALID_FUNCTION = 1
+ERROR_FILE_NOT_FOUND = 2
+ERROR_PATH_NOT_FOUND = 3
+ERROR_TOO_MANY_OPEN_FILES = 4
+ERROR_ACCESS_DENIED = 5
+ERROR_INVALID_HANDLE = 6
+ERROR_ARENA_TRASHED = 7
+ERROR_NOT_ENOUGH_MEMORY = 8
+ERROR_INVALID_BLOCK = 9
+ERROR_BAD_ENVIRONMENT = 10
+ERROR_BAD_FORMAT = 11
+ERROR_INVALID_ACCESS = 12
+ERROR_INVALID_DATA = 13
+ERROR_OUTOFMEMORY = 14
+ERROR_INVALID_DRIVE = 15
+ERROR_CURRENT_DIRECTORY = 16
+ERROR_NOT_SAME_DEVICE = 17
+ERROR_NO_MORE_FILES = 18
+ERROR_WRITE_PROTECT = 19
+ERROR_BAD_UNIT = 20
+ERROR_NOT_READY = 21
+ERROR_BAD_COMMAND = 22
+ERROR_CRC = 23
+ERROR_BAD_LENGTH = 24
+ERROR_SEEK = 25
+ERROR_NOT_DOS_DISK = 26
+ERROR_SECTOR_NOT_FOUND = 27
+ERROR_OUT_OF_PAPER = 28
+ERROR_WRITE_FAULT = 29
+ERROR_READ_FAULT = 30
+ERROR_GEN_FAILURE = 31
+ERROR_SHARING_VIOLATION = 32
+ERROR_LOCK_VIOLATION = 33
+ERROR_WRONG_DISK = 34
+ERROR_SHARING_BUFFER_EXCEEDED = 36
+ERROR_HANDLE_EOF = 38
+ERROR_HANDLE_DISK_FULL = 39
+ERROR_NOT_SUPPORTED = 50
+ERROR_REM_NOT_LIST = 51
+ERROR_DUP_NAME = 52
+ERROR_BAD_NETPATH = 53
+ERROR_NETWORK_BUSY = 54
+ERROR_DEV_NOT_EXIST = 55
+ERROR_TOO_MANY_CMDS = 56
+ERROR_ADAP_HDW_ERR = 57
+ERROR_BAD_NET_RESP = 58
+ERROR_UNEXP_NET_ERR = 59
+ERROR_BAD_REM_ADAP = 60
+ERROR_PRINTQ_FULL = 61
+ERROR_NO_SPOOL_SPACE = 62
+ERROR_PRINT_CANCELLED = 63
+ERROR_NETNAME_DELETED = 64
+ERROR_NETWORK_ACCESS_DENIED = 65
+ERROR_BAD_DEV_TYPE = 66
+ERROR_BAD_NET_NAME = 67
+ERROR_TOO_MANY_NAMES = 68
+ERROR_TOO_MANY_SESS = 69
+ERROR_SHARING_PAUSED = 70
+ERROR_REQ_NOT_ACCEP = 71
+ERROR_REDIR_PAUSED = 72
+ERROR_FILE_EXISTS = 80
+ERROR_CANNOT_MAKE = 82
+ERROR_FAIL_I24 = 83
+ERROR_OUT_OF_STRUCTURES = 84
+ERROR_ALREADY_ASSIGNED = 85
+ERROR_INVALID_PASSWORD = 86
+ERROR_INVALID_PARAMETER = 87
+ERROR_NET_WRITE_FAULT = 88
+ERROR_NO_PROC_SLOTS = 89
+ERROR_TOO_MANY_SEMAPHORES = 100
+ERROR_EXCL_SEM_ALREADY_OWNED = 101
+ERROR_SEM_IS_SET = 102
+ERROR_TOO_MANY_SEM_REQUESTS = 103
+ERROR_INVALID_AT_INTERRUPT_TIME = 104
+ERROR_SEM_OWNER_DIED = 105
+ERROR_SEM_USER_LIMIT = 106
+ERROR_DISK_CHANGE = 107
+ERROR_DRIVE_LOCKED = 108
+ERROR_BROKEN_PIPE = 109
+ERROR_OPEN_FAILED = 110
+ERROR_BUFFER_OVERFLOW = 111
+ERROR_DISK_FULL = 112
+ERROR_NO_MORE_SEARCH_HANDLES = 113
+ERROR_INVALID_TARGET_HANDLE = 114
+ERROR_INVALID_CATEGORY = 117
+ERROR_INVALID_VERIFY_SWITCH = 118
+ERROR_BAD_DRIVER_LEVEL = 119
+ERROR_CALL_NOT_IMPLEMENTED = 120
+ERROR_SEM_TIMEOUT = 121
+ERROR_INSUFFICIENT_BUFFER = 122
+ERROR_INVALID_NAME = 123
+ERROR_INVALID_LEVEL = 124
+ERROR_NO_VOLUME_LABEL = 125
+ERROR_MOD_NOT_FOUND = 126
+ERROR_PROC_NOT_FOUND = 127
+ERROR_WAIT_NO_CHILDREN = 128
+ERROR_CHILD_NOT_COMPLETE = 129
+ERROR_DIRECT_ACCESS_HANDLE = 130
+ERROR_NEGATIVE_SEEK = 131
+ERROR_SEEK_ON_DEVICE = 132
+ERROR_IS_JOIN_TARGET = 133
+ERROR_IS_JOINED = 134
+ERROR_IS_SUBSTED = 135
+ERROR_NOT_JOINED = 136
+ERROR_NOT_SUBSTED = 137
+ERROR_JOIN_TO_JOIN = 138
+ERROR_SUBST_TO_SUBST = 139
+ERROR_JOIN_TO_SUBST = 140
+ERROR_SUBST_TO_JOIN = 141
+ERROR_BUSY_DRIVE = 142
+ERROR_SAME_DRIVE = 143
+ERROR_DIR_NOT_ROOT = 144
+ERROR_DIR_NOT_EMPTY = 145
+ERROR_IS_SUBST_PATH = 146
+ERROR_IS_JOIN_PATH = 147
+ERROR_PATH_BUSY = 148
+ERROR_IS_SUBST_TARGET = 149
+ERROR_SYSTEM_TRACE = 150
+ERROR_INVALID_EVENT_COUNT = 151
+ERROR_TOO_MANY_MUXWAITERS = 152
+ERROR_INVALID_LIST_FORMAT = 153
+ERROR_LABEL_TOO_LONG = 154
+ERROR_TOO_MANY_TCBS = 155
+ERROR_SIGNAL_REFUSED = 156
+ERROR_DISCARDED = 157
+ERROR_NOT_LOCKED = 158
+ERROR_BAD_THREADID_ADDR = 159
+ERROR_BAD_ARGUMENTS = 160
+ERROR_BAD_PATHNAME = 161
+ERROR_SIGNAL_PENDING = 162
+ERROR_MAX_THRDS_REACHED = 164
+ERROR_LOCK_FAILED = 167
+ERROR_BUSY = 170
+ERROR_CANCEL_VIOLATION = 173
+ERROR_ATOMIC_LOCKS_NOT_SUPPORTED = 174
+ERROR_INVALID_SEGMENT_NUMBER = 180
+ERROR_INVALID_ORDINAL = 182
+ERROR_ALREADY_EXISTS = 183
+ERROR_INVALID_FLAG_NUMBER = 186
+ERROR_SEM_NOT_FOUND = 187
+ERROR_INVALID_STARTING_CODESEG = 188
+ERROR_INVALID_STACKSEG = 189
+ERROR_INVALID_MODULETYPE = 190
+ERROR_INVALID_EXE_SIGNATURE = 191
+ERROR_EXE_MARKED_INVALID = 192
+ERROR_BAD_EXE_FORMAT = 193
+ERROR_ITERATED_DATA_EXCEEDS_64k = 194
+ERROR_INVALID_MINALLOCSIZE = 195
+ERROR_DYNLINK_FROM_INVALID_RING = 196
+ERROR_IOPL_NOT_ENABLED = 197
+ERROR_INVALID_SEGDPL = 198
+ERROR_AUTODATASEG_EXCEEDS_64k = 199
+ERROR_RING2SEG_MUST_BE_MOVABLE = 200
+ERROR_RELOC_CHAIN_XEEDS_SEGLIM = 201
+ERROR_INFLOOP_IN_RELOC_CHAIN = 202
+ERROR_ENVVAR_NOT_FOUND = 203
+ERROR_NO_SIGNAL_SENT = 205
+ERROR_FILENAME_EXCED_RANGE = 206
+ERROR_RING2_STACK_IN_USE = 207
+ERROR_META_EXPANSION_TOO_LONG = 208
+ERROR_INVALID_SIGNAL_NUMBER = 209
+ERROR_THREAD_1_INACTIVE = 210
+ERROR_LOCKED = 212
+ERROR_TOO_MANY_MODULES = 214
+ERROR_NESTING_NOT_ALLOWED = 215
+ERROR_EXE_MACHINE_TYPE_MISMATCH = 216
+ERROR_EXE_CANNOT_MODIFY_SIGNED_BINARY = 217
+ERROR_EXE_CANNOT_MODIFY_STRONG_SIGNED_BINARY = 218
+ERROR_FILE_CHECKED_OUT = 220
+ERROR_CHECKOUT_REQUIRED = 221
+ERROR_BAD_FILE_TYPE = 222
+ERROR_FILE_TOO_LARGE = 223
+ERROR_FORMS_AUTH_REQUIRED = 224
+ERROR_VIRUS_INFECTED = 225
+ERROR_VIRUS_DELETED = 226
+ERROR_PIPE_LOCAL = 229
+ERROR_BAD_PIPE = 230
+ERROR_PIPE_BUSY = 231
+ERROR_NO_DATA = 232
+ERROR_PIPE_NOT_CONNECTED = 233
+ERROR_MORE_DATA = 234
+ERROR_VC_DISCONNECTED = 240
+ERROR_INVALID_EA_NAME = 254
+ERROR_EA_LIST_INCONSISTENT = 255
+WAIT_TIMEOUT = 258
+ERROR_NO_MORE_ITEMS = 259
+ERROR_CANNOT_COPY = 266
+ERROR_DIRECTORY = 267
+ERROR_EAS_DIDNT_FIT = 275
+ERROR_EA_FILE_CORRUPT = 276
+ERROR_EA_TABLE_FULL = 277
+ERROR_INVALID_EA_HANDLE = 278
+ERROR_EAS_NOT_SUPPORTED = 282
+ERROR_NOT_OWNER = 288
+ERROR_TOO_MANY_POSTS = 298
+ERROR_PARTIAL_COPY = 299
+ERROR_OPLOCK_NOT_GRANTED = 300
+ERROR_INVALID_OPLOCK_PROTOCOL = 301
+ERROR_DISK_TOO_FRAGMENTED = 302
+ERROR_DELETE_PENDING = 303
+ERROR_MR_MID_NOT_FOUND = 317
+ERROR_SCOPE_NOT_FOUND = 318
+ERROR_FAIL_NOACTION_REBOOT = 350
+ERROR_FAIL_SHUTDOWN = 351
+ERROR_FAIL_RESTART = 352
+ERROR_MAX_SESSIONS_REACHED = 353
+ERROR_THREAD_MODE_ALREADY_BACKGROUND = 400
+ERROR_THREAD_MODE_NOT_BACKGROUND = 401
+ERROR_PROCESS_MODE_ALREADY_BACKGROUND = 402
+ERROR_PROCESS_MODE_NOT_BACKGROUND = 403
+ERROR_INVALID_ADDRESS = 487
+ERROR_USER_PROFILE_LOAD = 500
+ERROR_ARITHMETIC_OVERFLOW = 534
+ERROR_PIPE_CONNECTED = 535
+ERROR_PIPE_LISTENING = 536
+ERROR_VERIFIER_STOP = 537
+ERROR_ABIOS_ERROR = 538
+ERROR_WX86_WARNING = 539
+ERROR_WX86_ERROR = 540
+ERROR_TIMER_NOT_CANCELED = 541
+ERROR_UNWIND = 542
+ERROR_BAD_STACK = 543
+ERROR_INVALID_UNWIND_TARGET = 544
+ERROR_INVALID_PORT_ATTRIBUTES = 545
+ERROR_PORT_MESSAGE_TOO_LONG = 546
+ERROR_INVALID_QUOTA_LOWER = 547
+ERROR_DEVICE_ALREADY_ATTACHED = 548
+ERROR_INSTRUCTION_MISALIGNMENT = 549
+ERROR_PROFILING_NOT_STARTED = 550
+ERROR_PROFILING_NOT_STOPPED = 551
+ERROR_COULD_NOT_INTERPRET = 552
+ERROR_PROFILING_AT_LIMIT = 553
+ERROR_CANT_WAIT = 554
+ERROR_CANT_TERMINATE_SELF = 555
+ERROR_UNEXPECTED_MM_CREATE_ERR = 556
+ERROR_UNEXPECTED_MM_MAP_ERROR = 557
+ERROR_UNEXPECTED_MM_EXTEND_ERR = 558
+ERROR_BAD_FUNCTION_TABLE = 559
+ERROR_NO_GUID_TRANSLATION = 560
+ERROR_INVALID_LDT_SIZE = 561
+ERROR_INVALID_LDT_OFFSET = 563
+ERROR_INVALID_LDT_DESCRIPTOR = 564
+ERROR_TOO_MANY_THREADS = 565
+ERROR_THREAD_NOT_IN_PROCESS = 566
+ERROR_PAGEFILE_QUOTA_EXCEEDED = 567
+ERROR_LOGON_SERVER_CONFLICT = 568
+ERROR_SYNCHRONIZATION_REQUIRED = 569
+ERROR_NET_OPEN_FAILED = 570
+ERROR_IO_PRIVILEGE_FAILED = 571
+ERROR_CONTROL_C_EXIT = 572
+ERROR_MISSING_SYSTEMFILE = 573
+ERROR_UNHANDLED_EXCEPTION = 574
+ERROR_APP_INIT_FAILURE = 575
+ERROR_PAGEFILE_CREATE_FAILED = 576
+ERROR_INVALID_IMAGE_HASH = 577
+ERROR_NO_PAGEFILE = 578
+ERROR_ILLEGAL_FLOAT_CONTEXT = 579
+ERROR_NO_EVENT_PAIR = 580
+ERROR_DOMAIN_CTRLR_CONFIG_ERROR = 581
+ERROR_ILLEGAL_CHARACTER = 582
+ERROR_UNDEFINED_CHARACTER = 583
+ERROR_FLOPPY_VOLUME = 584
+ERROR_BIOS_FAILED_TO_CONNECT_INTERRUPT = 585
+ERROR_BACKUP_CONTROLLER = 586
+ERROR_MUTANT_LIMIT_EXCEEDED = 587
+ERROR_FS_DRIVER_REQUIRED = 588
+ERROR_CANNOT_LOAD_REGISTRY_FILE = 589
+ERROR_DEBUG_ATTACH_FAILED = 590
+ERROR_SYSTEM_PROCESS_TERMINATED = 591
+ERROR_DATA_NOT_ACCEPTED = 592
+ERROR_VDM_HARD_ERROR = 593
+ERROR_DRIVER_CANCEL_TIMEOUT = 594
+ERROR_REPLY_MESSAGE_MISMATCH = 595
+ERROR_LOST_WRITEBEHIND_DATA = 596
+ERROR_CLIENT_SERVER_PARAMETERS_INVALID = 597
+ERROR_NOT_TINY_STREAM = 598
+ERROR_STACK_OVERFLOW_READ = 599
+ERROR_CONVERT_TO_LARGE = 600
+ERROR_FOUND_OUT_OF_SCOPE = 601
+ERROR_ALLOCATE_BUCKET = 602
+ERROR_MARSHALL_OVERFLOW = 603
+ERROR_INVALID_VARIANT = 604
+ERROR_BAD_COMPRESSION_BUFFER = 605
+ERROR_AUDIT_FAILED = 606
+ERROR_TIMER_RESOLUTION_NOT_SET = 607
+ERROR_INSUFFICIENT_LOGON_INFO = 608
+ERROR_BAD_DLL_ENTRYPOINT = 609
+ERROR_BAD_SERVICE_ENTRYPOINT = 610
+ERROR_IP_ADDRESS_CONFLICT1 = 611
+ERROR_IP_ADDRESS_CONFLICT2 = 612
+ERROR_REGISTRY_QUOTA_LIMIT = 613
+ERROR_NO_CALLBACK_ACTIVE = 614
+ERROR_PWD_TOO_SHORT = 615
+ERROR_PWD_TOO_RECENT = 616
+ERROR_PWD_HISTORY_CONFLICT = 617
+ERROR_UNSUPPORTED_COMPRESSION = 618
+ERROR_INVALID_HW_PROFILE = 619
+ERROR_INVALID_PLUGPLAY_DEVICE_PATH = 620
+ERROR_QUOTA_LIST_INCONSISTENT = 621
+ERROR_EVALUATION_EXPIRATION = 622
+ERROR_ILLEGAL_DLL_RELOCATION = 623
+ERROR_DLL_INIT_FAILED_LOGOFF = 624
+ERROR_VALIDATE_CONTINUE = 625
+ERROR_NO_MORE_MATCHES = 626
+ERROR_RANGE_LIST_CONFLICT = 627
+ERROR_SERVER_SID_MISMATCH = 628
+ERROR_CANT_ENABLE_DENY_ONLY = 629
+ERROR_FLOAT_MULTIPLE_FAULTS = 630
+ERROR_FLOAT_MULTIPLE_TRAPS = 631
+ERROR_NOINTERFACE = 632
+ERROR_DRIVER_FAILED_SLEEP = 633
+ERROR_CORRUPT_SYSTEM_FILE = 634
+ERROR_COMMITMENT_MINIMUM = 635
+ERROR_PNP_RESTART_ENUMERATION = 636
+ERROR_SYSTEM_IMAGE_BAD_SIGNATURE = 637
+ERROR_PNP_REBOOT_REQUIRED = 638
+ERROR_INSUFFICIENT_POWER = 639
+ERROR_MULTIPLE_FAULT_VIOLATION = 640
+ERROR_SYSTEM_SHUTDOWN = 641
+ERROR_PORT_NOT_SET = 642
+ERROR_DS_VERSION_CHECK_FAILURE = 643
+ERROR_RANGE_NOT_FOUND = 644
+ERROR_NOT_SAFE_MODE_DRIVER = 646
+ERROR_FAILED_DRIVER_ENTRY = 647
+ERROR_DEVICE_ENUMERATION_ERROR = 648
+ERROR_MOUNT_POINT_NOT_RESOLVED = 649
+ERROR_INVALID_DEVICE_OBJECT_PARAMETER = 650
+ERROR_MCA_OCCURED = 651
+ERROR_DRIVER_DATABASE_ERROR = 652
+ERROR_SYSTEM_HIVE_TOO_LARGE = 653
+ERROR_DRIVER_FAILED_PRIOR_UNLOAD = 654
+ERROR_VOLSNAP_PREPARE_HIBERNATE = 655
+ERROR_HIBERNATION_FAILURE = 656
+ERROR_FILE_SYSTEM_LIMITATION = 665
+ERROR_ASSERTION_FAILURE = 668
+ERROR_ACPI_ERROR = 669
+ERROR_WOW_ASSERTION = 670
+ERROR_PNP_BAD_MPS_TABLE = 671
+ERROR_PNP_TRANSLATION_FAILED = 672
+ERROR_PNP_IRQ_TRANSLATION_FAILED = 673
+ERROR_PNP_INVALID_ID = 674
+ERROR_WAKE_SYSTEM_DEBUGGER = 675
+ERROR_HANDLES_CLOSED = 676
+ERROR_EXTRANEOUS_INFORMATION = 677
+ERROR_RXACT_COMMIT_NECESSARY = 678
+ERROR_MEDIA_CHECK = 679
+ERROR_GUID_SUBSTITUTION_MADE = 680
+ERROR_STOPPED_ON_SYMLINK = 681
+ERROR_LONGJUMP = 682
+ERROR_PLUGPLAY_QUERY_VETOED = 683
+ERROR_UNWIND_CONSOLIDATE = 684
+ERROR_REGISTRY_HIVE_RECOVERED = 685
+ERROR_DLL_MIGHT_BE_INSECURE = 686
+ERROR_DLL_MIGHT_BE_INCOMPATIBLE = 687
+ERROR_DBG_EXCEPTION_NOT_HANDLED = 688
+ERROR_DBG_REPLY_LATER = 689
+ERROR_DBG_UNABLE_TO_PROVIDE_HANDLE = 690
+ERROR_DBG_TERMINATE_THREAD = 691
+ERROR_DBG_TERMINATE_PROCESS = 692
+ERROR_DBG_CONTROL_C = 693
+ERROR_DBG_PRINTEXCEPTION_C = 694
+ERROR_DBG_RIPEXCEPTION = 695
+ERROR_DBG_CONTROL_BREAK = 696
+ERROR_DBG_COMMAND_EXCEPTION = 697
+ERROR_OBJECT_NAME_EXISTS = 698
+ERROR_THREAD_WAS_SUSPENDED = 699
+ERROR_IMAGE_NOT_AT_BASE = 700
+ERROR_RXACT_STATE_CREATED = 701
+ERROR_SEGMENT_NOTIFICATION = 702
+ERROR_BAD_CURRENT_DIRECTORY = 703
+ERROR_FT_READ_RECOVERY_FROM_BACKUP = 704
+ERROR_FT_WRITE_RECOVERY = 705
+ERROR_IMAGE_MACHINE_TYPE_MISMATCH = 706
+ERROR_RECEIVE_PARTIAL = 707
+ERROR_RECEIVE_EXPEDITED = 708
+ERROR_RECEIVE_PARTIAL_EXPEDITED = 709
+ERROR_EVENT_DONE = 710
+ERROR_EVENT_PENDING = 711
+ERROR_CHECKING_FILE_SYSTEM = 712
+ERROR_FATAL_APP_EXIT = 713
+ERROR_PREDEFINED_HANDLE = 714
+ERROR_WAS_UNLOCKED = 715
+ERROR_SERVICE_NOTIFICATION = 716
+ERROR_WAS_LOCKED = 717
+ERROR_LOG_HARD_ERROR = 718
+ERROR_ALREADY_WIN32 = 719
+ERROR_IMAGE_MACHINE_TYPE_MISMATCH_EXE = 720
+ERROR_NO_YIELD_PERFORMED = 721
+ERROR_TIMER_RESUME_IGNORED = 722
+ERROR_ARBITRATION_UNHANDLED = 723
+ERROR_CARDBUS_NOT_SUPPORTED = 724
+ERROR_MP_PROCESSOR_MISMATCH = 725
+ERROR_HIBERNATED = 726
+ERROR_RESUME_HIBERNATION = 727
+ERROR_FIRMWARE_UPDATED = 728
+ERROR_DRIVERS_LEAKING_LOCKED_PAGES = 729
+ERROR_WAKE_SYSTEM = 730
+ERROR_WAIT_1 = 731
+ERROR_WAIT_2 = 732
+ERROR_WAIT_3 = 733
+ERROR_WAIT_63 = 734
+ERROR_ABANDONED_WAIT_0 = 735
+ERROR_ABANDONED_WAIT_63 = 736
+ERROR_USER_APC = 737
+ERROR_KERNEL_APC = 738
+ERROR_ALERTED = 739
+ERROR_ELEVATION_REQUIRED = 740
+ERROR_REPARSE = 741
+ERROR_OPLOCK_BREAK_IN_PROGRESS = 742
+ERROR_VOLUME_MOUNTED = 743
+ERROR_RXACT_COMMITTED = 744
+ERROR_NOTIFY_CLEANUP = 745
+ERROR_PRIMARY_TRANSPORT_CONNECT_FAILED = 746
+ERROR_PAGE_FAULT_TRANSITION = 747
+ERROR_PAGE_FAULT_DEMAND_ZERO = 748
+ERROR_PAGE_FAULT_COPY_ON_WRITE = 749
+ERROR_PAGE_FAULT_GUARD_PAGE = 750
+ERROR_PAGE_FAULT_PAGING_FILE = 751
+ERROR_CACHE_PAGE_LOCKED = 752
+ERROR_CRASH_DUMP = 753
+ERROR_BUFFER_ALL_ZEROS = 754
+ERROR_REPARSE_OBJECT = 755
+ERROR_RESOURCE_REQUIREMENTS_CHANGED = 756
+ERROR_TRANSLATION_COMPLETE = 757
+ERROR_NOTHING_TO_TERMINATE = 758
+ERROR_PROCESS_NOT_IN_JOB = 759
+ERROR_PROCESS_IN_JOB = 760
+ERROR_VOLSNAP_HIBERNATE_READY = 761
+ERROR_FSFILTER_OP_COMPLETED_SUCCESSFULLY = 762
+ERROR_INTERRUPT_VECTOR_ALREADY_CONNECTED = 763
+ERROR_INTERRUPT_STILL_CONNECTED = 764
+ERROR_WAIT_FOR_OPLOCK = 765
+ERROR_DBG_EXCEPTION_HANDLED = 766
+ERROR_DBG_CONTINUE = 767
+ERROR_CALLBACK_POP_STACK = 768
+ERROR_COMPRESSION_DISABLED = 769
+ERROR_CANTFETCHBACKWARDS = 770
+ERROR_CANTSCROLLBACKWARDS = 771
+ERROR_ROWSNOTRELEASED = 772
+ERROR_BAD_ACCESSOR_FLAGS = 773
+ERROR_ERRORS_ENCOUNTERED = 774
+ERROR_NOT_CAPABLE = 775
+ERROR_REQUEST_OUT_OF_SEQUENCE = 776
+ERROR_VERSION_PARSE_ERROR = 777
+ERROR_BADSTARTPOSITION = 778
+ERROR_MEMORY_HARDWARE = 779
+ERROR_DISK_REPAIR_DISABLED = 780
+ERROR_INSUFFICIENT_RESOURCE_FOR_SPECIFIED_SHARED_SECTION_SIZE = 781
+ERROR_SYSTEM_POWERSTATE_TRANSITION = 782
+ERROR_SYSTEM_POWERSTATE_COMPLEX_TRANSITION = 783
+ERROR_MCA_EXCEPTION = 784
+ERROR_ACCESS_AUDIT_BY_POLICY = 785
+ERROR_ACCESS_DISABLED_NO_SAFER_UI_BY_POLICY = 786
+ERROR_ABANDON_HIBERFILE = 787
+ERROR_LOST_WRITEBEHIND_DATA_NETWORK_DISCONNECTED = 788
+ERROR_LOST_WRITEBEHIND_DATA_NETWORK_SERVER_ERROR = 789
+ERROR_LOST_WRITEBEHIND_DATA_LOCAL_DISK_ERROR = 790
+ERROR_BAD_MCFG_TABLE = 791
+ERROR_EA_ACCESS_DENIED = 994
+ERROR_OPERATION_ABORTED = 995
+ERROR_IO_INCOMPLETE = 996
+ERROR_IO_PENDING = 997
+ERROR_NOACCESS = 998
+ERROR_SWAPERROR = 999
+ERROR_STACK_OVERFLOW = 1001
+ERROR_INVALID_MESSAGE = 1002
+ERROR_CAN_NOT_COMPLETE = 1003
+ERROR_INVALID_FLAGS = 1004
+ERROR_UNRECOGNIZED_VOLUME = 1005
+ERROR_FILE_INVALID = 1006
+ERROR_FULLSCREEN_MODE = 1007
+ERROR_NO_TOKEN = 1008
+ERROR_BADDB = 1009
+ERROR_BADKEY = 1010
+ERROR_CANTOPEN = 1011
+ERROR_CANTREAD = 1012
+ERROR_CANTWRITE = 1013
+ERROR_REGISTRY_RECOVERED = 1014
+ERROR_REGISTRY_CORRUPT = 1015
+ERROR_REGISTRY_IO_FAILED = 1016
+ERROR_NOT_REGISTRY_FILE = 1017
+ERROR_KEY_DELETED = 1018
+ERROR_NO_LOG_SPACE = 1019
+ERROR_KEY_HAS_CHILDREN = 1020
+ERROR_CHILD_MUST_BE_VOLATILE = 1021
+ERROR_NOTIFY_ENUM_DIR = 1022
+ERROR_DEPENDENT_SERVICES_RUNNING = 1051
+ERROR_INVALID_SERVICE_CONTROL = 1052
+ERROR_SERVICE_REQUEST_TIMEOUT = 1053
+ERROR_SERVICE_NO_THREAD = 1054
+ERROR_SERVICE_DATABASE_LOCKED = 1055
+ERROR_SERVICE_ALREADY_RUNNING = 1056
+ERROR_INVALID_SERVICE_ACCOUNT = 1057
+ERROR_SERVICE_DISABLED = 1058
+ERROR_CIRCULAR_DEPENDENCY = 1059
+ERROR_SERVICE_DOES_NOT_EXIST = 1060
+ERROR_SERVICE_CANNOT_ACCEPT_CTRL = 1061
+ERROR_SERVICE_NOT_ACTIVE = 1062
+ERROR_FAILED_SERVICE_CONTROLLER_CONNECT = 1063
+ERROR_EXCEPTION_IN_SERVICE = 1064
+ERROR_DATABASE_DOES_NOT_EXIST = 1065
+ERROR_SERVICE_SPECIFIC_ERROR = 1066
+ERROR_PROCESS_ABORTED = 1067
+ERROR_SERVICE_DEPENDENCY_FAIL = 1068
+ERROR_SERVICE_LOGON_FAILED = 1069
+ERROR_SERVICE_START_HANG = 1070
+ERROR_INVALID_SERVICE_LOCK = 1071
+ERROR_SERVICE_MARKED_FOR_DELETE = 1072
+ERROR_SERVICE_EXISTS = 1073
+ERROR_ALREADY_RUNNING_LKG = 1074
+ERROR_SERVICE_DEPENDENCY_DELETED = 1075
+ERROR_BOOT_ALREADY_ACCEPTED = 1076
+ERROR_SERVICE_NEVER_STARTED = 1077
+ERROR_DUPLICATE_SERVICE_NAME = 1078
+ERROR_DIFFERENT_SERVICE_ACCOUNT = 1079
+ERROR_CANNOT_DETECT_DRIVER_FAILURE = 1080
+ERROR_CANNOT_DETECT_PROCESS_ABORT = 1081
+ERROR_NO_RECOVERY_PROGRAM = 1082
+ERROR_SERVICE_NOT_IN_EXE = 1083
+ERROR_NOT_SAFEBOOT_SERVICE = 1084
+ERROR_END_OF_MEDIA = 1100
+ERROR_FILEMARK_DETECTED = 1101
+ERROR_BEGINNING_OF_MEDIA = 1102
+ERROR_SETMARK_DETECTED = 1103
+ERROR_NO_DATA_DETECTED = 1104
+ERROR_PARTITION_FAILURE = 1105
+ERROR_INVALID_BLOCK_LENGTH = 1106
+ERROR_DEVICE_NOT_PARTITIONED = 1107
+ERROR_UNABLE_TO_LOCK_MEDIA = 1108
+ERROR_UNABLE_TO_UNLOAD_MEDIA = 1109
+ERROR_MEDIA_CHANGED = 1110
+ERROR_BUS_RESET = 1111
+ERROR_NO_MEDIA_IN_DRIVE = 1112
+ERROR_NO_UNICODE_TRANSLATION = 1113
+ERROR_DLL_INIT_FAILED = 1114
+ERROR_SHUTDOWN_IN_PROGRESS = 1115
+ERROR_NO_SHUTDOWN_IN_PROGRESS = 1116
+ERROR_IO_DEVICE = 1117
+ERROR_SERIAL_NO_DEVICE = 1118
+ERROR_IRQ_BUSY = 1119
+ERROR_MORE_WRITES = 1120
+ERROR_COUNTER_TIMEOUT = 1121
+ERROR_FLOPPY_ID_MARK_NOT_FOUND = 1122
+ERROR_FLOPPY_WRONG_CYLINDER = 1123
+ERROR_FLOPPY_UNKNOWN_ERROR = 1124
+ERROR_FLOPPY_BAD_REGISTERS = 1125
+ERROR_DISK_RECALIBRATE_FAILED = 1126
+ERROR_DISK_OPERATION_FAILED = 1127
+ERROR_DISK_RESET_FAILED = 1128
+ERROR_EOM_OVERFLOW = 1129
+ERROR_NOT_ENOUGH_SERVER_MEMORY = 1130
+ERROR_POSSIBLE_DEADLOCK = 1131
+ERROR_MAPPED_ALIGNMENT = 1132
+ERROR_SET_POWER_STATE_VETOED = 1140
+ERROR_SET_POWER_STATE_FAILED = 1141
+ERROR_TOO_MANY_LINKS = 1142
+ERROR_OLD_WIN_VERSION = 1150
+ERROR_APP_WRONG_OS = 1151
+ERROR_SINGLE_INSTANCE_APP = 1152
+ERROR_RMODE_APP = 1153
+ERROR_INVALID_DLL = 1154
+ERROR_NO_ASSOCIATION = 1155
+ERROR_DDE_FAIL = 1156
+ERROR_DLL_NOT_FOUND = 1157
+ERROR_NO_MORE_USER_HANDLES = 1158
+ERROR_MESSAGE_SYNC_ONLY = 1159
+ERROR_SOURCE_ELEMENT_EMPTY = 1160
+ERROR_DESTINATION_ELEMENT_FULL = 1161
+ERROR_ILLEGAL_ELEMENT_ADDRESS = 1162
+ERROR_MAGAZINE_NOT_PRESENT = 1163
+ERROR_DEVICE_REINITIALIZATION_NEEDED = 1164
+ERROR_DEVICE_REQUIRES_CLEANING = 1165
+ERROR_DEVICE_DOOR_OPEN = 1166
+ERROR_DEVICE_NOT_CONNECTED = 1167
+ERROR_NOT_FOUND = 1168
+ERROR_NO_MATCH = 1169
+ERROR_SET_NOT_FOUND = 1170
+ERROR_POINT_NOT_FOUND = 1171
+ERROR_NO_TRACKING_SERVICE = 1172
+ERROR_NO_VOLUME_ID = 1173
+ERROR_CONNECTED_OTHER_PASSWORD = 2108
+ERROR_BAD_USERNAME = 2202
+ERROR_NOT_CONNECTED = 2250
+ERROR_OPEN_FILES = 2401
+ERROR_ACTIVE_CONNECTIONS = 2402
+ERROR_DEVICE_IN_USE = 2404
+ERROR_BAD_DEVICE = 1200
+ERROR_CONNECTION_UNAVAIL = 1201
+ERROR_DEVICE_ALREADY_REMEMBERED = 1202
+ERROR_NO_NET_OR_BAD_PATH = 1203
+ERROR_BAD_PROVIDER = 1204
+ERROR_CANNOT_OPEN_PROFILE = 1205
+ERROR_BAD_PROFILE = 1206
+ERROR_NOT_CONTAINER = 1207
+ERROR_EXTENDED_ERROR = 1208
+ERROR_INVALID_GROUPNAME = 1209
+ERROR_INVALID_COMPUTERNAME = 1210
+ERROR_INVALID_EVENTNAME = 1211
+ERROR_INVALID_DOMAINNAME = 1212
+ERROR_INVALID_SERVICENAME = 1213
+ERROR_INVALID_NETNAME = 1214
+ERROR_INVALID_SHARENAME = 1215
+ERROR_INVALID_PASSWORDNAME = 1216
+ERROR_INVALID_MESSAGENAME = 1217
+ERROR_INVALID_MESSAGEDEST = 1218
+ERROR_SESSION_CREDENTIAL_CONFLICT = 1219
+ERROR_REMOTE_SESSION_LIMIT_EXCEEDED = 1220
+ERROR_DUP_DOMAINNAME = 1221
+ERROR_NO_NETWORK = 1222
+ERROR_CANCELLED = 1223
+ERROR_USER_MAPPED_FILE = 1224
+ERROR_CONNECTION_REFUSED = 1225
+ERROR_GRACEFUL_DISCONNECT = 1226
+ERROR_ADDRESS_ALREADY_ASSOCIATED = 1227
+ERROR_ADDRESS_NOT_ASSOCIATED = 1228
+ERROR_CONNECTION_INVALID = 1229
+ERROR_CONNECTION_ACTIVE = 1230
+ERROR_NETWORK_UNREACHABLE = 1231
+ERROR_HOST_UNREACHABLE = 1232
+ERROR_PROTOCOL_UNREACHABLE = 1233
+ERROR_PORT_UNREACHABLE = 1234
+ERROR_REQUEST_ABORTED = 1235
+ERROR_CONNECTION_ABORTED = 1236
+ERROR_RETRY = 1237
+ERROR_CONNECTION_COUNT_LIMIT = 1238
+ERROR_LOGIN_TIME_RESTRICTION = 1239
+ERROR_LOGIN_WKSTA_RESTRICTION = 1240
+ERROR_INCORRECT_ADDRESS = 1241
+ERROR_ALREADY_REGISTERED = 1242
+ERROR_SERVICE_NOT_FOUND = 1243
+ERROR_NOT_AUTHENTICATED = 1244
+ERROR_NOT_LOGGED_ON = 1245
+ERROR_CONTINUE = 1246
+ERROR_ALREADY_INITIALIZED = 1247
+ERROR_NO_MORE_DEVICES = 1248
+ERROR_NO_SUCH_SITE = 1249
+ERROR_DOMAIN_CONTROLLER_EXISTS = 1250
+ERROR_DS_NOT_INSTALLED = 1251
+ERROR_NOT_ALL_ASSIGNED = 1300
+ERROR_SOME_NOT_MAPPED = 1301
+ERROR_NO_QUOTAS_FOR_ACCOUNT = 1302
+ERROR_LOCAL_USER_SESSION_KEY = 1303
+ERROR_NULL_LM_PASSWORD = 1304
+ERROR_UNKNOWN_REVISION = 1305
+ERROR_REVISION_MISMATCH = 1306
+ERROR_INVALID_OWNER = 1307
+ERROR_INVALID_PRIMARY_GROUP = 1308
+ERROR_NO_IMPERSONATION_TOKEN = 1309
+ERROR_CANT_DISABLE_MANDATORY = 1310
+ERROR_NO_LOGON_SERVERS = 1311
+ERROR_NO_SUCH_LOGON_SESSION = 1312
+ERROR_NO_SUCH_PRIVILEGE = 1313
+ERROR_PRIVILEGE_NOT_HELD = 1314
+ERROR_INVALID_ACCOUNT_NAME = 1315
+ERROR_USER_EXISTS = 1316
+ERROR_NO_SUCH_USER = 1317
+ERROR_GROUP_EXISTS = 1318
+ERROR_NO_SUCH_GROUP = 1319
+ERROR_MEMBER_IN_GROUP = 1320
+ERROR_MEMBER_NOT_IN_GROUP = 1321
+ERROR_LAST_ADMIN = 1322
+ERROR_WRONG_PASSWORD = 1323
+ERROR_ILL_FORMED_PASSWORD = 1324
+ERROR_PASSWORD_RESTRICTION = 1325
+ERROR_LOGON_FAILURE = 1326
+ERROR_ACCOUNT_RESTRICTION = 1327
+ERROR_INVALID_LOGON_HOURS = 1328
+ERROR_INVALID_WORKSTATION = 1329
+ERROR_PASSWORD_EXPIRED = 1330
+ERROR_ACCOUNT_DISABLED = 1331
+ERROR_NONE_MAPPED = 1332
+ERROR_TOO_MANY_LUIDS_REQUESTED = 1333
+ERROR_LUIDS_EXHAUSTED = 1334
+ERROR_INVALID_SUB_AUTHORITY = 1335
+ERROR_INVALID_ACL = 1336
+ERROR_INVALID_SID = 1337
+ERROR_INVALID_SECURITY_DESCR = 1338
+ERROR_BAD_INHERITANCE_ACL = 1340
+ERROR_SERVER_DISABLED = 1341
+ERROR_SERVER_NOT_DISABLED = 1342
+ERROR_INVALID_ID_AUTHORITY = 1343
+ERROR_ALLOTTED_SPACE_EXCEEDED = 1344
+ERROR_INVALID_GROUP_ATTRIBUTES = 1345
+ERROR_BAD_IMPERSONATION_LEVEL = 1346
+ERROR_CANT_OPEN_ANONYMOUS = 1347
+ERROR_BAD_VALIDATION_CLASS = 1348
+ERROR_BAD_TOKEN_TYPE = 1349
+ERROR_NO_SECURITY_ON_OBJECT = 1350
+ERROR_CANT_ACCESS_DOMAIN_INFO = 1351
+ERROR_INVALID_SERVER_STATE = 1352
+ERROR_INVALID_DOMAIN_STATE = 1353
+ERROR_INVALID_DOMAIN_ROLE = 1354
+ERROR_NO_SUCH_DOMAIN = 1355
+ERROR_DOMAIN_EXISTS = 1356
+ERROR_DOMAIN_LIMIT_EXCEEDED = 1357
+ERROR_INTERNAL_DB_CORRUPTION = 1358
+ERROR_INTERNAL_ERROR = 1359
+ERROR_GENERIC_NOT_MAPPED = 1360
+ERROR_BAD_DESCRIPTOR_FORMAT = 1361
+ERROR_NOT_LOGON_PROCESS = 1362
+ERROR_LOGON_SESSION_EXISTS = 1363
+ERROR_NO_SUCH_PACKAGE = 1364
+ERROR_BAD_LOGON_SESSION_STATE = 1365
+ERROR_LOGON_SESSION_COLLISION = 1366
+ERROR_INVALID_LOGON_TYPE = 1367
+ERROR_CANNOT_IMPERSONATE = 1368
+ERROR_RXACT_INVALID_STATE = 1369
+ERROR_RXACT_COMMIT_FAILURE = 1370
+ERROR_SPECIAL_ACCOUNT = 1371
+ERROR_SPECIAL_GROUP = 1372
+ERROR_SPECIAL_USER = 1373
+ERROR_MEMBERS_PRIMARY_GROUP = 1374
+ERROR_TOKEN_ALREADY_IN_USE = 1375
+ERROR_NO_SUCH_ALIAS = 1376
+ERROR_MEMBER_NOT_IN_ALIAS = 1377
+ERROR_MEMBER_IN_ALIAS = 1378
+ERROR_ALIAS_EXISTS = 1379
+ERROR_LOGON_NOT_GRANTED = 1380
+ERROR_TOO_MANY_SECRETS = 1381
+ERROR_SECRET_TOO_LONG = 1382
+ERROR_INTERNAL_DB_ERROR = 1383
+ERROR_TOO_MANY_CONTEXT_IDS = 1384
+ERROR_LOGON_TYPE_NOT_GRANTED = 1385
+ERROR_NT_CROSS_ENCRYPTION_REQUIRED = 1386
+ERROR_NO_SUCH_MEMBER = 1387
+ERROR_INVALID_MEMBER = 1388
+ERROR_TOO_MANY_SIDS = 1389
+ERROR_LM_CROSS_ENCRYPTION_REQUIRED = 1390
+ERROR_NO_INHERITANCE = 1391
+ERROR_FILE_CORRUPT = 1392
+ERROR_DISK_CORRUPT = 1393
+ERROR_NO_USER_SESSION_KEY = 1394
+ERROR_LICENSE_QUOTA_EXCEEDED = 1395
+ERROR_INVALID_WINDOW_HANDLE = 1400
+ERROR_INVALID_MENU_HANDLE = 1401
+ERROR_INVALID_CURSOR_HANDLE = 1402
+ERROR_INVALID_ACCEL_HANDLE = 1403
+ERROR_INVALID_HOOK_HANDLE = 1404
+ERROR_INVALID_DWP_HANDLE = 1405
+ERROR_TLW_WITH_WSCHILD = 1406
+ERROR_CANNOT_FIND_WND_CLASS = 1407
+ERROR_WINDOW_OF_OTHER_THREAD = 1408
+ERROR_HOTKEY_ALREADY_REGISTERED = 1409
+ERROR_CLASS_ALREADY_EXISTS = 1410
+ERROR_CLASS_DOES_NOT_EXIST = 1411
+ERROR_CLASS_HAS_WINDOWS = 1412
+ERROR_INVALID_INDEX = 1413
+ERROR_INVALID_ICON_HANDLE = 1414
+ERROR_PRIVATE_DIALOG_INDEX = 1415
+ERROR_LISTBOX_ID_NOT_FOUND = 1416
+ERROR_NO_WILDCARD_CHARACTERS = 1417
+ERROR_CLIPBOARD_NOT_OPEN = 1418
+ERROR_HOTKEY_NOT_REGISTERED = 1419
+ERROR_WINDOW_NOT_DIALOG = 1420
+ERROR_CONTROL_ID_NOT_FOUND = 1421
+ERROR_INVALID_COMBOBOX_MESSAGE = 1422
+ERROR_WINDOW_NOT_COMBOBOX = 1423
+ERROR_INVALID_EDIT_HEIGHT = 1424
+ERROR_DC_NOT_FOUND = 1425
+ERROR_INVALID_HOOK_FILTER = 1426
+ERROR_INVALID_FILTER_PROC = 1427
+ERROR_HOOK_NEEDS_HMOD = 1428
+ERROR_GLOBAL_ONLY_HOOK = 1429
+ERROR_JOURNAL_HOOK_SET = 1430
+ERROR_HOOK_NOT_INSTALLED = 1431
+ERROR_INVALID_LB_MESSAGE = 1432
+ERROR_SETCOUNT_ON_BAD_LB = 1433
+ERROR_LB_WITHOUT_TABSTOPS = 1434
+ERROR_DESTROY_OBJECT_OF_OTHER_THREAD = 1435
+ERROR_CHILD_WINDOW_MENU = 1436
+ERROR_NO_SYSTEM_MENU = 1437
+ERROR_INVALID_MSGBOX_STYLE = 1438
+ERROR_INVALID_SPI_VALUE = 1439
+ERROR_SCREEN_ALREADY_LOCKED = 1440
+ERROR_HWNDS_HAVE_DIFF_PARENT = 1441
+ERROR_NOT_CHILD_WINDOW = 1442
+ERROR_INVALID_GW_COMMAND = 1443
+ERROR_INVALID_THREAD_ID = 1444
+ERROR_NON_MDICHILD_WINDOW = 1445
+ERROR_POPUP_ALREADY_ACTIVE = 1446
+ERROR_NO_SCROLLBARS = 1447
+ERROR_INVALID_SCROLLBAR_RANGE = 1448
+ERROR_INVALID_SHOWWIN_COMMAND = 1449
+ERROR_NO_SYSTEM_RESOURCES = 1450
+ERROR_NONPAGED_SYSTEM_RESOURCES = 1451
+ERROR_PAGED_SYSTEM_RESOURCES = 1452
+ERROR_WORKING_SET_QUOTA = 1453
+ERROR_PAGEFILE_QUOTA = 1454
+ERROR_COMMITMENT_LIMIT = 1455
+ERROR_MENU_ITEM_NOT_FOUND = 1456
+ERROR_INVALID_KEYBOARD_HANDLE = 1457
+ERROR_HOOK_TYPE_NOT_ALLOWED = 1458
+ERROR_REQUIRES_INTERACTIVE_WINDOWSTATION = 1459
+ERROR_TIMEOUT = 1460
+ERROR_INVALID_MONITOR_HANDLE = 1461
+ERROR_INCORRECT_SIZE = 1462
+ERROR_SYMLINK_CLASS_DISABLED = 1463
+ERROR_SYMLINK_NOT_SUPPORTED = 1464
+ERROR_XML_PARSE_ERROR = 1465
+ERROR_XMLDSIG_ERROR = 1466
+ERROR_RESTART_APPLICATION = 1467
+ERROR_WRONG_COMPARTMENT = 1468
+ERROR_AUTHIP_FAILURE = 1469
+ERROR_EVENTLOG_FILE_CORRUPT = 1500
+ERROR_EVENTLOG_CANT_START = 1501
+ERROR_LOG_FILE_FULL = 1502
+ERROR_EVENTLOG_FILE_CHANGED = 1503
+ERROR_EVENTLOG_FILE_CORRUPT = 1500
+ERROR_EVENTLOG_CANT_START = 1501
+ERROR_LOG_FILE_FULL = 1502
+ERROR_INSTALL_SERVICE = 1601
+ERROR_INSTALL_USEREXIT = 1602
+ERROR_INSTALL_FAILURE = 1603
+ERROR_INSTALL_SUSPEND = 1604
+ERROR_UNKNOWN_PRODUCT = 1605
+ERROR_UNKNOWN_FEATURE = 1606
+ERROR_UNKNOWN_COMPONENT = 1607
+ERROR_UNKNOWN_PROPERTY = 1608
+ERROR_INVALID_HANDLE_STATE = 1609
+ERROR_BAD_CONFIGURATION = 1610
+ERROR_INDEX_ABSENT = 1611
+ERROR_INSTALL_SOURCE_ABSENT = 1612
+ERROR_BAD_DATABASE_VERSION = 1613
+ERROR_PRODUCT_UNINSTALLED = 1614
+ERROR_BAD_QUERY_SYNTAX = 1615
+ERROR_INVALID_FIELD = 1616
+ERROR_DEVICE_REMOVED = 1617
+ERROR_INSTALL_ALREADY_RUNNING = 1618
+ERROR_INSTALL_PACKAGE_OPEN_FAILED = 1619
+ERROR_INSTALL_PACKAGE_INVALID = 1620
+ERROR_INSTALL_UI_FAILURE = 1621
+ERROR_INSTALL_LOG_FAILURE = 1622
+ERROR_INSTALL_LANGUAGE_UNSUPPORTED = 1623
+ERROR_INSTALL_TRANSFORM_FAILURE = 1624
+ERROR_INSTALL_PACKAGE_REJECTED = 1625
+ERROR_FUNCTION_NOT_CALLED = 1626
+ERROR_FUNCTION_FAILED = 1627
+ERROR_INVALID_TABLE = 1628
+ERROR_DATATYPE_MISMATCH = 1629
+ERROR_UNSUPPORTED_TYPE = 1630
+ERROR_CREATE_FAILED = 1631
+ERROR_INSTALL_TEMP_UNWRITABLE = 1632
+ERROR_INSTALL_PLATFORM_UNSUPPORTED = 1633
+ERROR_INSTALL_NOTUSED = 1634
+ERROR_PATCH_PACKAGE_OPEN_FAILED = 1635
+ERROR_PATCH_PACKAGE_INVALID = 1636
+ERROR_PATCH_PACKAGE_UNSUPPORTED = 1637
+ERROR_PRODUCT_VERSION = 1638
+ERROR_INVALID_COMMAND_LINE = 1639
+ERROR_INSTALL_REMOTE_DISALLOWED = 1640
+ERROR_SUCCESS_REBOOT_INITIATED = 1641
+ERROR_PATCH_TARGET_NOT_FOUND = 1642
+ERROR_PATCH_PACKAGE_REJECTED = 1643
+ERROR_INSTALL_TRANSFORM_REJECTED = 1644
+ERROR_INSTALL_REMOTE_PROHIBITED = 1645
+ERROR_PATCH_REMOVAL_UNSUPPORTED = 1646
+ERROR_UNKNOWN_PATCH = 1647
+ERROR_PATCH_NO_SEQUENCE = 1648
+ERROR_PATCH_REMOVAL_DISALLOWED = 1649
+ERROR_INVALID_PATCH_XML = 1650
+ERROR_PATCH_MANAGED_ADVERTISED_PRODUCT = 1651
+ERROR_INSTALL_SERVICE_SAFEBOOT = 1652
+RPC_S_INVALID_STRING_BINDING = 1700
+RPC_S_WRONG_KIND_OF_BINDING = 1701
+RPC_S_INVALID_BINDING = 1702
+RPC_S_PROTSEQ_NOT_SUPPORTED = 1703
+RPC_S_INVALID_RPC_PROTSEQ = 1704
+RPC_S_INVALID_STRING_UUID = 1705
+RPC_S_INVALID_ENDPOINT_FORMAT = 1706
+RPC_S_INVALID_NET_ADDR = 1707
+RPC_S_NO_ENDPOINT_FOUND = 1708
+RPC_S_INVALID_TIMEOUT = 1709
+RPC_S_OBJECT_NOT_FOUND = 1710
+RPC_S_ALREADY_REGISTERED = 1711
+RPC_S_TYPE_ALREADY_REGISTERED = 1712
+RPC_S_ALREADY_LISTENING = 1713
+RPC_S_NO_PROTSEQS_REGISTERED = 1714
+RPC_S_NOT_LISTENING = 1715
+RPC_S_UNKNOWN_MGR_TYPE = 1716
+RPC_S_UNKNOWN_IF = 1717
+RPC_S_NO_BINDINGS = 1718
+RPC_S_NO_PROTSEQS = 1719
+RPC_S_CANT_CREATE_ENDPOINT = 1720
+RPC_S_OUT_OF_RESOURCES = 1721
+RPC_S_SERVER_UNAVAILABLE = 1722
+RPC_S_SERVER_TOO_BUSY = 1723
+RPC_S_INVALID_NETWORK_OPTIONS = 1724
+RPC_S_NO_CALL_ACTIVE = 1725
+RPC_S_CALL_FAILED = 1726
+RPC_S_CALL_FAILED_DNE = 1727
+RPC_S_PROTOCOL_ERROR = 1728
+RPC_S_PROXY_ACCESS_DENIED = 1729
+RPC_S_UNSUPPORTED_TRANS_SYN = 1730
+RPC_S_UNSUPPORTED_TYPE = 1732
+RPC_S_INVALID_TAG = 1733
+RPC_S_INVALID_BOUND = 1734
+RPC_S_NO_ENTRY_NAME = 1735
+RPC_S_INVALID_NAME_SYNTAX = 1736
+RPC_S_UNSUPPORTED_NAME_SYNTAX = 1737
+RPC_S_UUID_NO_ADDRESS = 1739
+RPC_S_DUPLICATE_ENDPOINT = 1740
+RPC_S_UNKNOWN_AUTHN_TYPE = 1741
+RPC_S_MAX_CALLS_TOO_SMALL = 1742
+RPC_S_STRING_TOO_LONG = 1743
+RPC_S_PROTSEQ_NOT_FOUND = 1744
+RPC_S_PROCNUM_OUT_OF_RANGE = 1745
+RPC_S_BINDING_HAS_NO_AUTH = 1746
+RPC_S_UNKNOWN_AUTHN_SERVICE = 1747
+RPC_S_UNKNOWN_AUTHN_LEVEL = 1748
+RPC_S_INVALID_AUTH_IDENTITY = 1749
+RPC_S_UNKNOWN_AUTHZ_SERVICE = 1750
+EPT_S_INVALID_ENTRY = 1751
+EPT_S_CANT_PERFORM_OP = 1752
+EPT_S_NOT_REGISTERED = 1753
+RPC_S_NOTHING_TO_EXPORT = 1754
+RPC_S_INCOMPLETE_NAME = 1755
+RPC_S_INVALID_VERS_OPTION = 1756
+RPC_S_NO_MORE_MEMBERS = 1757
+RPC_S_NOT_ALL_OBJS_UNEXPORTED = 1758
+RPC_S_INTERFACE_NOT_FOUND = 1759
+RPC_S_ENTRY_ALREADY_EXISTS = 1760
+RPC_S_ENTRY_NOT_FOUND = 1761
+RPC_S_NAME_SERVICE_UNAVAILABLE = 1762
+RPC_S_INVALID_NAF_ID = 1763
+RPC_S_CANNOT_SUPPORT = 1764
+RPC_S_NO_CONTEXT_AVAILABLE = 1765
+RPC_S_INTERNAL_ERROR = 1766
+RPC_S_ZERO_DIVIDE = 1767
+RPC_S_ADDRESS_ERROR = 1768
+RPC_S_FP_DIV_ZERO = 1769
+RPC_S_FP_UNDERFLOW = 1770
+RPC_S_FP_OVERFLOW = 1771
+RPC_X_NO_MORE_ENTRIES = 1772
+RPC_X_SS_CHAR_TRANS_OPEN_FAIL = 1773
+RPC_X_SS_CHAR_TRANS_SHORT_FILE = 1774
+RPC_X_SS_IN_NULL_CONTEXT = 1775
+RPC_X_SS_CONTEXT_DAMAGED = 1777
+RPC_X_SS_HANDLES_MISMATCH = 1778
+RPC_X_SS_CANNOT_GET_CALL_HANDLE = 1779
+RPC_X_NULL_REF_POINTER = 1780
+RPC_X_ENUM_VALUE_OUT_OF_RANGE = 1781
+RPC_X_BYTE_COUNT_TOO_SMALL = 1782
+RPC_X_BAD_STUB_DATA = 1783
+ERROR_INVALID_USER_BUFFER = 1784
+ERROR_UNRECOGNIZED_MEDIA = 1785
+ERROR_NO_TRUST_LSA_SECRET = 1786
+ERROR_NO_TRUST_SAM_ACCOUNT = 1787
+ERROR_TRUSTED_DOMAIN_FAILURE = 1788
+ERROR_TRUSTED_RELATIONSHIP_FAILURE = 1789
+ERROR_TRUST_FAILURE = 1790
+RPC_S_CALL_IN_PROGRESS = 1791
+ERROR_NETLOGON_NOT_STARTED = 1792
+ERROR_ACCOUNT_EXPIRED = 1793
+ERROR_REDIRECTOR_HAS_OPEN_HANDLES = 1794
+ERROR_PRINTER_DRIVER_ALREADY_INSTALLED = 1795
+ERROR_UNKNOWN_PORT = 1796
+ERROR_UNKNOWN_PRINTER_DRIVER = 1797
+ERROR_UNKNOWN_PRINTPROCESSOR = 1798
+ERROR_INVALID_SEPARATOR_FILE = 1799
+ERROR_INVALID_PRIORITY = 1800
+ERROR_INVALID_PRINTER_NAME = 1801
+ERROR_PRINTER_ALREADY_EXISTS = 1802
+ERROR_INVALID_PRINTER_COMMAND = 1803
+ERROR_INVALID_DATATYPE = 1804
+ERROR_INVALID_ENVIRONMENT = 1805
+RPC_S_NO_MORE_BINDINGS = 1806
+ERROR_NOLOGON_INTERDOMAIN_TRUST_ACCOUNT = 1807
+ERROR_NOLOGON_WORKSTATION_TRUST_ACCOUNT = 1808
+ERROR_NOLOGON_SERVER_TRUST_ACCOUNT = 1809
+ERROR_DOMAIN_TRUST_INCONSISTENT = 1810
+ERROR_SERVER_HAS_OPEN_HANDLES = 1811
+ERROR_RESOURCE_DATA_NOT_FOUND = 1812
+ERROR_RESOURCE_TYPE_NOT_FOUND = 1813
+ERROR_RESOURCE_NAME_NOT_FOUND = 1814
+ERROR_RESOURCE_LANG_NOT_FOUND = 1815
+ERROR_NOT_ENOUGH_QUOTA = 1816
+RPC_S_NO_INTERFACES = 1817
+RPC_S_CALL_CANCELLED = 1818
+RPC_S_BINDING_INCOMPLETE = 1819
+RPC_S_COMM_FAILURE = 1820
+RPC_S_UNSUPPORTED_AUTHN_LEVEL = 1821
+RPC_S_NO_PRINC_NAME = 1822
+RPC_S_NOT_RPC_ERROR = 1823
+RPC_S_UUID_LOCAL_ONLY = 1824
+RPC_S_SEC_PKG_ERROR = 1825
+RPC_S_NOT_CANCELLED = 1826
+RPC_X_INVALID_ES_ACTION = 1827
+RPC_X_WRONG_ES_VERSION = 1828
+RPC_X_WRONG_STUB_VERSION = 1829
+RPC_X_INVALID_PIPE_OBJECT = 1830
+RPC_X_WRONG_PIPE_ORDER = 1831
+RPC_X_WRONG_PIPE_VERSION = 1832
+RPC_S_GROUP_MEMBER_NOT_FOUND = 1898
+EPT_S_CANT_CREATE = 1899
+RPC_S_INVALID_OBJECT = 1900
+ERROR_INVALID_TIME = 1901
+ERROR_INVALID_FORM_NAME = 1902
+ERROR_INVALID_FORM_SIZE = 1903
+ERROR_ALREADY_WAITING = 1904
+ERROR_PRINTER_DELETED = 1905
+ERROR_INVALID_PRINTER_STATE = 1906
+ERROR_PASSWORD_MUST_CHANGE = 1907
+ERROR_DOMAIN_CONTROLLER_NOT_FOUND = 1908
+ERROR_ACCOUNT_LOCKED_OUT = 1909
+OR_INVALID_OXID = 1910
+OR_INVALID_OID = 1911
+OR_INVALID_SET = 1912
+RPC_S_SEND_INCOMPLETE = 1913
+RPC_S_INVALID_ASYNC_HANDLE = 1914
+RPC_S_INVALID_ASYNC_CALL = 1915
+RPC_X_PIPE_CLOSED = 1916
+RPC_X_PIPE_DISCIPLINE_ERROR = 1917
+RPC_X_PIPE_EMPTY = 1918
+ERROR_NO_SITENAME = 1919
+ERROR_CANT_ACCESS_FILE = 1920
+ERROR_CANT_RESOLVE_FILENAME = 1921
+RPC_S_ENTRY_TYPE_MISMATCH = 1922
+RPC_S_NOT_ALL_OBJS_EXPORTED = 1923
+RPC_S_INTERFACE_NOT_EXPORTED = 1924
+RPC_S_PROFILE_NOT_ADDED = 1925
+RPC_S_PRF_ELT_NOT_ADDED = 1926
+RPC_S_PRF_ELT_NOT_REMOVED = 1927
+RPC_S_GRP_ELT_NOT_ADDED = 1928
+RPC_S_GRP_ELT_NOT_REMOVED = 1929
+ERROR_KM_DRIVER_BLOCKED = 1930
+ERROR_CONTEXT_EXPIRED = 1931
+ERROR_PER_USER_TRUST_QUOTA_EXCEEDED = 1932
+ERROR_ALL_USER_TRUST_QUOTA_EXCEEDED = 1933
+ERROR_USER_DELETE_TRUST_QUOTA_EXCEEDED = 1934
+ERROR_AUTHENTICATION_FIREWALL_FAILED = 1935
+ERROR_REMOTE_PRINT_CONNECTIONS_BLOCKED = 1936
+ERROR_NTLM_BLOCKED = 1937
+ERROR_INVALID_PIXEL_FORMAT = 2000
+ERROR_BAD_DRIVER = 2001
+ERROR_INVALID_WINDOW_STYLE = 2002
+ERROR_METAFILE_NOT_SUPPORTED = 2003
+ERROR_TRANSFORM_NOT_SUPPORTED = 2004
+ERROR_CLIPPING_NOT_SUPPORTED = 2005
+ERROR_INVALID_CMM = 2010
+ERROR_INVALID_PROFILE = 2011
+ERROR_TAG_NOT_FOUND = 2012
+ERROR_TAG_NOT_PRESENT = 2013
+ERROR_DUPLICATE_TAG = 2014
+ERROR_PROFILE_NOT_ASSOCIATED_WITH_DEVICE = 2015
+ERROR_PROFILE_NOT_FOUND = 2016
+ERROR_INVALID_COLORSPACE = 2017
+ERROR_ICM_NOT_ENABLED = 2018
+ERROR_DELETING_ICM_XFORM = 2019
+ERROR_INVALID_TRANSFORM = 2020
+ERROR_COLORSPACE_MISMATCH = 2021
+ERROR_INVALID_COLORINDEX = 2022
+ERROR_PROFILE_DOES_NOT_MATCH_DEVICE = 2023
+ERROR_CONNECTED_OTHER_PASSWORD = 2108
+ERROR_CONNECTED_OTHER_PASSWORD_DEFAULT = 2109
+ERROR_BAD_USERNAME = 2202
+ERROR_NOT_CONNECTED = 2250
+ERROR_INVALID_CMM = 2300
+ERROR_INVALID_PROFILE = 2301
+ERROR_TAG_NOT_FOUND = 2302
+ERROR_TAG_NOT_PRESENT = 2303
+ERROR_DUPLICATE_TAG = 2304
+ERROR_PROFILE_NOT_ASSOCIATED_WITH_DEVICE = 2305
+ERROR_PROFILE_NOT_FOUND = 2306
+ERROR_INVALID_COLORSPACE = 2307
+ERROR_ICM_NOT_ENABLED = 2308
+ERROR_DELETING_ICM_XFORM = 2309
+ERROR_INVALID_TRANSFORM = 2310
+ERROR_OPEN_FILES = 2401
+ERROR_ACTIVE_CONNECTIONS = 2402
+ERROR_DEVICE_IN_USE = 2404
+ERROR_UNKNOWN_PRINT_MONITOR = 3000
+ERROR_PRINTER_DRIVER_IN_USE = 3001
+ERROR_SPOOL_FILE_NOT_FOUND = 3002
+ERROR_SPL_NO_STARTDOC = 3003
+ERROR_SPL_NO_ADDJOB = 3004
+ERROR_PRINT_PROCESSOR_ALREADY_INSTALLED = 3005
+ERROR_PRINT_MONITOR_ALREADY_INSTALLED = 3006
+ERROR_INVALID_PRINT_MONITOR = 3007
+ERROR_PRINT_MONITOR_IN_USE = 3008
+ERROR_PRINTER_HAS_JOBS_QUEUED = 3009
+ERROR_SUCCESS_REBOOT_REQUIRED = 3010
+ERROR_SUCCESS_RESTART_REQUIRED = 3011
+ERROR_PRINTER_NOT_FOUND = 3012
+ERROR_PRINTER_DRIVER_WARNED = 3013
+ERROR_PRINTER_DRIVER_BLOCKED = 3014
+ERROR_PRINTER_DRIVER_PACKAGE_IN_USE = 3015
+ERROR_CORE_DRIVER_PACKAGE_NOT_FOUND = 3016
+ERROR_FAIL_REBOOT_REQUIRED = 3017
+ERROR_FAIL_REBOOT_INITIATED = 3018
+ERROR_PRINTER_DRIVER_DOWNLOAD_NEEDED = 3019
+ERROR_PRINT_JOB_RESTART_REQUIRED = 3020
+ERROR_IO_REISSUE_AS_CACHED = 3950
+ERROR_WINS_INTERNAL = 4000
+ERROR_CAN_NOT_DEL_LOCAL_WINS = 4001
+ERROR_STATIC_INIT = 4002
+ERROR_INC_BACKUP = 4003
+ERROR_FULL_BACKUP = 4004
+ERROR_REC_NON_EXISTENT = 4005
+ERROR_RPL_NOT_ALLOWED = 4006
+ERROR_DHCP_ADDRESS_CONFLICT = 4100
+ERROR_WMI_GUID_NOT_FOUND = 4200
+ERROR_WMI_INSTANCE_NOT_FOUND = 4201
+ERROR_WMI_ITEMID_NOT_FOUND = 4202
+ERROR_WMI_TRY_AGAIN = 4203
+ERROR_WMI_DP_NOT_FOUND = 4204
+ERROR_WMI_UNRESOLVED_INSTANCE_REF = 4205
+ERROR_WMI_ALREADY_ENABLED = 4206
+ERROR_WMI_GUID_DISCONNECTED = 4207
+ERROR_WMI_SERVER_UNAVAILABLE = 4208
+ERROR_WMI_DP_FAILED = 4209
+ERROR_WMI_INVALID_MOF = 4210
+ERROR_WMI_INVALID_REGINFO = 4211
+ERROR_WMI_ALREADY_DISABLED = 4212
+ERROR_WMI_READ_ONLY = 4213
+ERROR_WMI_SET_FAILURE = 4214
+ERROR_INVALID_MEDIA = 4300
+ERROR_INVALID_LIBRARY = 4301
+ERROR_INVALID_MEDIA_POOL = 4302
+ERROR_DRIVE_MEDIA_MISMATCH = 4303
+ERROR_MEDIA_OFFLINE = 4304
+ERROR_LIBRARY_OFFLINE = 4305
+ERROR_EMPTY = 4306
+ERROR_NOT_EMPTY = 4307
+ERROR_MEDIA_UNAVAILABLE = 4308
+ERROR_RESOURCE_DISABLED = 4309
+ERROR_INVALID_CLEANER = 4310
+ERROR_UNABLE_TO_CLEAN = 4311
+ERROR_OBJECT_NOT_FOUND = 4312
+ERROR_DATABASE_FAILURE = 4313
+ERROR_DATABASE_FULL = 4314
+ERROR_MEDIA_INCOMPATIBLE = 4315
+ERROR_RESOURCE_NOT_PRESENT = 4316
+ERROR_INVALID_OPERATION = 4317
+ERROR_MEDIA_NOT_AVAILABLE = 4318
+ERROR_DEVICE_NOT_AVAILABLE = 4319
+ERROR_REQUEST_REFUSED = 4320
+ERROR_INVALID_DRIVE_OBJECT = 4321
+ERROR_LIBRARY_FULL = 4322
+ERROR_MEDIUM_NOT_ACCESSIBLE = 4323
+ERROR_UNABLE_TO_LOAD_MEDIUM = 4324
+ERROR_UNABLE_TO_INVENTORY_DRIVE = 4325
+ERROR_UNABLE_TO_INVENTORY_SLOT = 4326
+ERROR_UNABLE_TO_INVENTORY_TRANSPORT = 4327
+ERROR_TRANSPORT_FULL = 4328
+ERROR_CONTROLLING_IEPORT = 4329
+ERROR_UNABLE_TO_EJECT_MOUNTED_MEDIA = 4330
+ERROR_CLEANER_SLOT_SET = 4331
+ERROR_CLEANER_SLOT_NOT_SET = 4332
+ERROR_CLEANER_CARTRIDGE_SPENT = 4333
+ERROR_UNEXPECTED_OMID = 4334
+ERROR_CANT_DELETE_LAST_ITEM = 4335
+ERROR_MESSAGE_EXCEEDS_MAX_SIZE = 4336
+ERROR_VOLUME_CONTAINS_SYS_FILES = 4337
+ERROR_INDIGENOUS_TYPE = 4338
+ERROR_NO_SUPPORTING_DRIVES = 4339
+ERROR_CLEANER_CARTRIDGE_INSTALLED = 4340
+ERROR_IEPORT_FULL = 4341
+ERROR_FILE_OFFLINE = 4350
+ERROR_REMOTE_STORAGE_NOT_ACTIVE = 4351
+ERROR_REMOTE_STORAGE_MEDIA_ERROR = 4352
+ERROR_NOT_A_REPARSE_POINT = 4390
+ERROR_REPARSE_ATTRIBUTE_CONFLICT = 4391
+ERROR_INVALID_REPARSE_DATA = 4392
+ERROR_REPARSE_TAG_INVALID = 4393
+ERROR_REPARSE_TAG_MISMATCH = 4394
+ERROR_VOLUME_NOT_SIS_ENABLED = 4500
+ERROR_DEPENDENT_RESOURCE_EXISTS = 5001
+ERROR_DEPENDENCY_NOT_FOUND = 5002
+ERROR_DEPENDENCY_ALREADY_EXISTS = 5003
+ERROR_RESOURCE_NOT_ONLINE = 5004
+ERROR_HOST_NODE_NOT_AVAILABLE = 5005
+ERROR_RESOURCE_NOT_AVAILABLE = 5006
+ERROR_RESOURCE_NOT_FOUND = 5007
+ERROR_SHUTDOWN_CLUSTER = 5008
+ERROR_CANT_EVICT_ACTIVE_NODE = 5009
+ERROR_OBJECT_ALREADY_EXISTS = 5010
+ERROR_OBJECT_IN_LIST = 5011
+ERROR_GROUP_NOT_AVAILABLE = 5012
+ERROR_GROUP_NOT_FOUND = 5013
+ERROR_GROUP_NOT_ONLINE = 5014
+ERROR_HOST_NODE_NOT_RESOURCE_OWNER = 5015
+ERROR_HOST_NODE_NOT_GROUP_OWNER = 5016
+ERROR_RESMON_CREATE_FAILED = 5017
+ERROR_RESMON_ONLINE_FAILED = 5018
+ERROR_RESOURCE_ONLINE = 5019
+ERROR_QUORUM_RESOURCE = 5020
+ERROR_NOT_QUORUM_CAPABLE = 5021
+ERROR_CLUSTER_SHUTTING_DOWN = 5022
+ERROR_INVALID_STATE = 5023
+ERROR_RESOURCE_PROPERTIES_STORED = 5024
+ERROR_NOT_QUORUM_CLASS = 5025
+ERROR_CORE_RESOURCE = 5026
+ERROR_QUORUM_RESOURCE_ONLINE_FAILED = 5027
+ERROR_QUORUMLOG_OPEN_FAILED = 5028
+ERROR_CLUSTERLOG_CORRUPT = 5029
+ERROR_CLUSTERLOG_RECORD_EXCEEDS_MAXSIZE = 5030
+ERROR_CLUSTERLOG_EXCEEDS_MAXSIZE = 5031
+ERROR_CLUSTERLOG_CHKPOINT_NOT_FOUND = 5032
+ERROR_CLUSTERLOG_NOT_ENOUGH_SPACE = 5033
+ERROR_QUORUM_OWNER_ALIVE = 5034
+ERROR_NETWORK_NOT_AVAILABLE = 5035
+ERROR_NODE_NOT_AVAILABLE = 5036
+ERROR_ALL_NODES_NOT_AVAILABLE = 5037
+ERROR_RESOURCE_FAILED = 5038
+ERROR_CLUSTER_INVALID_NODE = 5039
+ERROR_CLUSTER_NODE_EXISTS = 5040
+ERROR_CLUSTER_JOIN_IN_PROGRESS = 5041
+ERROR_CLUSTER_NODE_NOT_FOUND = 5042
+ERROR_CLUSTER_LOCAL_NODE_NOT_FOUND = 5043
+ERROR_CLUSTER_NETWORK_EXISTS = 5044
+ERROR_CLUSTER_NETWORK_NOT_FOUND = 5045
+ERROR_CLUSTER_NETINTERFACE_EXISTS = 5046
+ERROR_CLUSTER_NETINTERFACE_NOT_FOUND = 5047
+ERROR_CLUSTER_INVALID_REQUEST = 5048
+ERROR_CLUSTER_INVALID_NETWORK_PROVIDER = 5049
+ERROR_CLUSTER_NODE_DOWN = 5050
+ERROR_CLUSTER_NODE_UNREACHABLE = 5051
+ERROR_CLUSTER_NODE_NOT_MEMBER = 5052
+ERROR_CLUSTER_JOIN_NOT_IN_PROGRESS = 5053
+ERROR_CLUSTER_INVALID_NETWORK = 5054
+ERROR_CLUSTER_NODE_UP = 5056
+ERROR_CLUSTER_IPADDR_IN_USE = 5057
+ERROR_CLUSTER_NODE_NOT_PAUSED = 5058
+ERROR_CLUSTER_NO_SECURITY_CONTEXT = 5059
+ERROR_CLUSTER_NETWORK_NOT_INTERNAL = 5060
+ERROR_CLUSTER_NODE_ALREADY_UP = 5061
+ERROR_CLUSTER_NODE_ALREADY_DOWN = 5062
+ERROR_CLUSTER_NETWORK_ALREADY_ONLINE = 5063
+ERROR_CLUSTER_NETWORK_ALREADY_OFFLINE = 5064
+ERROR_CLUSTER_NODE_ALREADY_MEMBER = 5065
+ERROR_CLUSTER_LAST_INTERNAL_NETWORK = 5066
+ERROR_CLUSTER_NETWORK_HAS_DEPENDENTS = 5067
+ERROR_INVALID_OPERATION_ON_QUORUM = 5068
+ERROR_DEPENDENCY_NOT_ALLOWED = 5069
+ERROR_CLUSTER_NODE_PAUSED = 5070
+ERROR_NODE_CANT_HOST_RESOURCE = 5071
+ERROR_CLUSTER_NODE_NOT_READY = 5072
+ERROR_CLUSTER_NODE_SHUTTING_DOWN = 5073
+ERROR_CLUSTER_JOIN_ABORTED = 5074
+ERROR_CLUSTER_INCOMPATIBLE_VERSIONS = 5075
+ERROR_CLUSTER_MAXNUM_OF_RESOURCES_EXCEEDED = 5076
+ERROR_CLUSTER_SYSTEM_CONFIG_CHANGED = 5077
+ERROR_CLUSTER_RESOURCE_TYPE_NOT_FOUND = 5078
+ERROR_CLUSTER_RESTYPE_NOT_SUPPORTED = 5079
+ERROR_CLUSTER_RESNAME_NOT_FOUND = 5080
+ERROR_CLUSTER_NO_RPC_PACKAGES_REGISTERED = 5081
+ERROR_CLUSTER_OWNER_NOT_IN_PREFLIST = 5082
+ERROR_CLUSTER_DATABASE_SEQMISMATCH = 5083
+ERROR_RESMON_INVALID_STATE = 5084
+ERROR_CLUSTER_GUM_NOT_LOCKER = 5085
+ERROR_QUORUM_DISK_NOT_FOUND = 5086
+ERROR_DATABASE_BACKUP_CORRUPT = 5087
+ERROR_CLUSTER_NODE_ALREADY_HAS_DFS_ROOT = 5088
+ERROR_RESOURCE_PROPERTY_UNCHANGEABLE = 5089
+ERROR_CLUSTER_MEMBERSHIP_INVALID_STATE = 5890
+ERROR_CLUSTER_QUORUMLOG_NOT_FOUND = 5891
+ERROR_CLUSTER_MEMBERSHIP_HALT = 5892
+ERROR_CLUSTER_INSTANCE_ID_MISMATCH = 5893
+ERROR_CLUSTER_NETWORK_NOT_FOUND_FOR_IP = 5894
+ERROR_CLUSTER_PROPERTY_DATA_TYPE_MISMATCH = 5895
+ERROR_CLUSTER_EVICT_WITHOUT_CLEANUP = 5896
+ERROR_CLUSTER_PARAMETER_MISMATCH = 5897
+ERROR_NODE_CANNOT_BE_CLUSTERED = 5898
+ERROR_CLUSTER_WRONG_OS_VERSION = 5899
+ERROR_CLUSTER_CANT_CREATE_DUP_CLUSTER_NAME = 5900
+ERROR_CLUSCFG_ALREADY_COMMITTED = 5901
+ERROR_CLUSCFG_ROLLBACK_FAILED = 5902
+ERROR_CLUSCFG_SYSTEM_DISK_DRIVE_LETTER_CONFLICT = 5903
+ERROR_CLUSTER_OLD_VERSION = 5904
+ERROR_CLUSTER_MISMATCHED_COMPUTER_ACCT_NAME = 5905
+ERROR_CLUSTER_NO_NET_ADAPTERS = 5906
+ERROR_CLUSTER_POISONED = 5907
+ERROR_CLUSTER_GROUP_MOVING = 5908
+ERROR_CLUSTER_RESOURCE_TYPE_BUSY = 5909
+ERROR_RESOURCE_CALL_TIMED_OUT = 5910
+ERROR_INVALID_CLUSTER_IPV6_ADDRESS = 5911
+ERROR_CLUSTER_INTERNAL_INVALID_FUNCTION = 5912
+ERROR_CLUSTER_PARAMETER_OUT_OF_BOUNDS = 5913
+ERROR_CLUSTER_PARTIAL_SEND = 5914
+ERROR_CLUSTER_REGISTRY_INVALID_FUNCTION = 5915
+ERROR_CLUSTER_INVALID_STRING_TERMINATION = 5916
+ERROR_CLUSTER_INVALID_STRING_FORMAT = 5917
+ERROR_CLUSTER_DATABASE_TRANSACTION_IN_PROGRESS = 5918
+ERROR_CLUSTER_DATABASE_TRANSACTION_NOT_IN_PROGRESS = 5919
+ERROR_CLUSTER_NULL_DATA = 5920
+ERROR_CLUSTER_PARTIAL_READ = 5921
+ERROR_CLUSTER_PARTIAL_WRITE = 5922
+ERROR_CLUSTER_CANT_DESERIALIZE_DATA = 5923
+ERROR_DEPENDENT_RESOURCE_PROPERTY_CONFLICT = 5924
+ERROR_CLUSTER_NO_QUORUM = 5925
+ERROR_CLUSTER_INVALID_IPV6_NETWORK = 5926
+ERROR_CLUSTER_INVALID_IPV6_TUNNEL_NETWORK = 5927
+ERROR_QUORUM_NOT_ALLOWED_IN_THIS_GROUP = 5928
+ERROR_DEPENDENCY_TREE_TOO_COMPLEX = 5929
+ERROR_EXCEPTION_IN_RESOURCE_CALL = 5930
+ERROR_CLUSTER_RHS_FAILED_INITIALIZATION = 5931
+ERROR_CLUSTER_NOT_INSTALLED = 5932
+ERROR_CLUSTER_RESOURCES_MUST_BE_ONLINE_ON_THE_SAME_NODE = 5933
+ERROR_ENCRYPTION_FAILED = 6000
+ERROR_DECRYPTION_FAILED = 6001
+ERROR_FILE_ENCRYPTED = 6002
+ERROR_NO_RECOVERY_POLICY = 6003
+ERROR_NO_EFS = 6004
+ERROR_WRONG_EFS = 6005
+ERROR_NO_USER_KEYS = 6006
+ERROR_FILE_NOT_ENCRYPTED = 6007
+ERROR_NOT_EXPORT_FORMAT = 6008
+ERROR_FILE_READ_ONLY = 6009
+ERROR_DIR_EFS_DISALLOWED = 6010
+ERROR_EFS_SERVER_NOT_TRUSTED = 6011
+ERROR_BAD_RECOVERY_POLICY = 6012
+ERROR_EFS_ALG_BLOB_TOO_BIG = 6013
+ERROR_VOLUME_NOT_SUPPORT_EFS = 6014
+ERROR_EFS_DISABLED = 6015
+ERROR_EFS_VERSION_NOT_SUPPORT = 6016
+ERROR_CS_ENCRYPTION_INVALID_SERVER_RESPONSE = 6017
+ERROR_CS_ENCRYPTION_UNSUPPORTED_SERVER = 6018
+ERROR_CS_ENCRYPTION_EXISTING_ENCRYPTED_FILE = 6019
+ERROR_CS_ENCRYPTION_NEW_ENCRYPTED_FILE = 6020
+ERROR_CS_ENCRYPTION_FILE_NOT_CSE = 6021
+ERROR_NO_BROWSER_SERVERS_FOUND = 6118
+ERROR_LOG_SECTOR_INVALID = 6600
+ERROR_LOG_SECTOR_PARITY_INVALID = 6601
+ERROR_LOG_SECTOR_REMAPPED = 6602
+ERROR_LOG_BLOCK_INCOMPLETE = 6603
+ERROR_LOG_INVALID_RANGE = 6604
+ERROR_LOG_BLOCKS_EXHAUSTED = 6605
+ERROR_LOG_READ_CONTEXT_INVALID = 6606
+ERROR_LOG_RESTART_INVALID = 6607
+ERROR_LOG_BLOCK_VERSION = 6608
+ERROR_LOG_BLOCK_INVALID = 6609
+ERROR_LOG_READ_MODE_INVALID = 6610
+ERROR_LOG_NO_RESTART = 6611
+ERROR_LOG_METADATA_CORRUPT = 6612
+ERROR_LOG_METADATA_INVALID = 6613
+ERROR_LOG_METADATA_INCONSISTENT = 6614
+ERROR_LOG_RESERVATION_INVALID = 6615
+ERROR_LOG_CANT_DELETE = 6616
+ERROR_LOG_CONTAINER_LIMIT_EXCEEDED = 6617
+ERROR_LOG_START_OF_LOG = 6618
+ERROR_LOG_POLICY_ALREADY_INSTALLED = 6619
+ERROR_LOG_POLICY_NOT_INSTALLED = 6620
+ERROR_LOG_POLICY_INVALID = 6621
+ERROR_LOG_POLICY_CONFLICT = 6622
+ERROR_LOG_PINNED_ARCHIVE_TAIL = 6623
+ERROR_LOG_RECORD_NONEXISTENT = 6624
+ERROR_LOG_RECORDS_RESERVED_INVALID = 6625
+ERROR_LOG_SPACE_RESERVED_INVALID = 6626
+ERROR_LOG_TAIL_INVALID = 6627
+ERROR_LOG_FULL = 6628
+ERROR_COULD_NOT_RESIZE_LOG = 6629
+ERROR_LOG_MULTIPLEXED = 6630
+ERROR_LOG_DEDICATED = 6631
+ERROR_LOG_ARCHIVE_NOT_IN_PROGRESS = 6632
+ERROR_LOG_ARCHIVE_IN_PROGRESS = 6633
+ERROR_LOG_EPHEMERAL = 6634
+ERROR_LOG_NOT_ENOUGH_CONTAINERS = 6635
+ERROR_LOG_CLIENT_ALREADY_REGISTERED = 6636
+ERROR_LOG_CLIENT_NOT_REGISTERED = 6637
+ERROR_LOG_FULL_HANDLER_IN_PROGRESS = 6638
+ERROR_LOG_CONTAINER_READ_FAILED = 6639
+ERROR_LOG_CONTAINER_WRITE_FAILED = 6640
+ERROR_LOG_CONTAINER_OPEN_FAILED = 6641
+ERROR_LOG_CONTAINER_STATE_INVALID = 6642
+ERROR_LOG_STATE_INVALID = 6643
+ERROR_LOG_PINNED = 6644
+ERROR_LOG_METADATA_FLUSH_FAILED = 6645
+ERROR_LOG_INCONSISTENT_SECURITY = 6646
+ERROR_LOG_APPENDED_FLUSH_FAILED = 6647
+ERROR_LOG_PINNED_RESERVATION = 6648
+ERROR_INVALID_TRANSACTION = 6700
+ERROR_TRANSACTION_NOT_ACTIVE = 6701
+ERROR_TRANSACTION_REQUEST_NOT_VALID = 6702
+ERROR_TRANSACTION_NOT_REQUESTED = 6703
+ERROR_TRANSACTION_ALREADY_ABORTED = 6704
+ERROR_TRANSACTION_ALREADY_COMMITTED = 6705
+ERROR_TM_INITIALIZATION_FAILED = 6706
+ERROR_RESOURCEMANAGER_READ_ONLY = 6707
+ERROR_TRANSACTION_NOT_JOINED = 6708
+ERROR_TRANSACTION_SUPERIOR_EXISTS = 6709
+ERROR_CRM_PROTOCOL_ALREADY_EXISTS = 6710
+ERROR_TRANSACTION_PROPAGATION_FAILED = 6711
+ERROR_CRM_PROTOCOL_NOT_FOUND = 6712
+ERROR_TRANSACTION_INVALID_MARSHALL_BUFFER = 6713
+ERROR_CURRENT_TRANSACTION_NOT_VALID = 6714
+ERROR_TRANSACTION_NOT_FOUND = 6715
+ERROR_RESOURCEMANAGER_NOT_FOUND = 6716
+ERROR_ENLISTMENT_NOT_FOUND = 6717
+ERROR_TRANSACTIONMANAGER_NOT_FOUND = 6718
+ERROR_TRANSACTIONMANAGER_NOT_ONLINE = 6719
+ERROR_TRANSACTIONMANAGER_RECOVERY_NAME_COLLISION = 6720
+ERROR_TRANSACTION_NOT_ROOT = 6721
+ERROR_TRANSACTION_OBJECT_EXPIRED = 6722
+ERROR_TRANSACTION_RESPONSE_NOT_ENLISTED = 6723
+ERROR_TRANSACTION_RECORD_TOO_LONG = 6724
+ERROR_IMPLICIT_TRANSACTION_NOT_SUPPORTED = 6725
+ERROR_TRANSACTION_INTEGRITY_VIOLATED = 6726
+ERROR_TRANSACTIONAL_CONFLICT = 6800
+ERROR_RM_NOT_ACTIVE = 6801
+ERROR_RM_METADATA_CORRUPT = 6802
+ERROR_DIRECTORY_NOT_RM = 6803
+ERROR_TRANSACTIONS_UNSUPPORTED_REMOTE = 6805
+ERROR_LOG_RESIZE_INVALID_SIZE = 6806
+ERROR_OBJECT_NO_LONGER_EXISTS = 6807
+ERROR_STREAM_MINIVERSION_NOT_FOUND = 6808
+ERROR_STREAM_MINIVERSION_NOT_VALID = 6809
+ERROR_MINIVERSION_INACCESSIBLE_FROM_SPECIFIED_TRANSACTION = 6810
+ERROR_CANT_OPEN_MINIVERSION_WITH_MODIFY_INTENT = 6811
+ERROR_CANT_CREATE_MORE_STREAM_MINIVERSIONS = 6812
+ERROR_REMOTE_FILE_VERSION_MISMATCH = 6814
+ERROR_HANDLE_NO_LONGER_VALID = 6815
+ERROR_NO_TXF_METADATA = 6816
+ERROR_LOG_CORRUPTION_DETECTED = 6817
+ERROR_CANT_RECOVER_WITH_HANDLE_OPEN = 6818
+ERROR_RM_DISCONNECTED = 6819
+ERROR_ENLISTMENT_NOT_SUPERIOR = 6820
+ERROR_RECOVERY_NOT_NEEDED = 6821
+ERROR_RM_ALREADY_STARTED = 6822
+ERROR_FILE_IDENTITY_NOT_PERSISTENT = 6823
+ERROR_CANT_BREAK_TRANSACTIONAL_DEPENDENCY = 6824
+ERROR_CANT_CROSS_RM_BOUNDARY = 6825
+ERROR_TXF_DIR_NOT_EMPTY = 6826
+ERROR_INDOUBT_TRANSACTIONS_EXIST = 6827
+ERROR_TM_VOLATILE = 6828
+ERROR_ROLLBACK_TIMER_EXPIRED = 6829
+ERROR_TXF_ATTRIBUTE_CORRUPT = 6830
+ERROR_EFS_NOT_ALLOWED_IN_TRANSACTION = 6831
+ERROR_TRANSACTIONAL_OPEN_NOT_ALLOWED = 6832
+ERROR_LOG_GROWTH_FAILED = 6833
+ERROR_TRANSACTED_MAPPING_UNSUPPORTED_REMOTE = 6834
+ERROR_TXF_METADATA_ALREADY_PRESENT = 6835
+ERROR_TRANSACTION_SCOPE_CALLBACKS_NOT_SET = 6836
+ERROR_TRANSACTION_REQUIRED_PROMOTION = 6837
+ERROR_CANNOT_EXECUTE_FILE_IN_TRANSACTION = 6838
+ERROR_TRANSACTIONS_NOT_FROZEN = 6839
+ERROR_TRANSACTION_FREEZE_IN_PROGRESS = 6840
+ERROR_NOT_SNAPSHOT_VOLUME = 6841
+ERROR_NO_SAVEPOINT_WITH_OPEN_FILES = 6842
+ERROR_DATA_LOST_REPAIR = 6843
+ERROR_SPARSE_NOT_ALLOWED_IN_TRANSACTION = 6844
+ERROR_TM_IDENTITY_MISMATCH = 6845
+ERROR_FLOATED_SECTION = 6846
+ERROR_CANNOT_ACCEPT_TRANSACTED_WORK = 6847
+ERROR_CANNOT_ABORT_TRANSACTIONS = 6848
+ERROR_BAD_CLUSTERS = 6849
+ERROR_COMPRESSION_NOT_ALLOWED_IN_TRANSACTION = 6850
+ERROR_VOLUME_DIRTY = 6851
+ERROR_NO_LINK_TRACKING_IN_TRANSACTION = 6852
+ERROR_OPERATION_NOT_SUPPORTED_IN_TRANSACTION = 6853
+ERROR_CTX_WINSTATION_NAME_INVALID = 7001
+ERROR_CTX_INVALID_PD = 7002
+ERROR_CTX_PD_NOT_FOUND = 7003
+ERROR_CTX_WD_NOT_FOUND = 7004
+ERROR_CTX_CANNOT_MAKE_EVENTLOG_ENTRY = 7005
+ERROR_CTX_SERVICE_NAME_COLLISION = 7006
+ERROR_CTX_CLOSE_PENDING = 7007
+ERROR_CTX_NO_OUTBUF = 7008
+ERROR_CTX_MODEM_INF_NOT_FOUND = 7009
+ERROR_CTX_INVALID_MODEMNAME = 7010
+ERROR_CTX_MODEM_RESPONSE_ERROR = 7011
+ERROR_CTX_MODEM_RESPONSE_TIMEOUT = 7012
+ERROR_CTX_MODEM_RESPONSE_NO_CARRIER = 7013
+ERROR_CTX_MODEM_RESPONSE_NO_DIALTONE = 7014
+ERROR_CTX_MODEM_RESPONSE_BUSY = 7015
+ERROR_CTX_MODEM_RESPONSE_VOICE = 7016
+ERROR_CTX_TD_ERROR = 7017
+ERROR_CTX_WINSTATION_NOT_FOUND = 7022
+ERROR_CTX_WINSTATION_ALREADY_EXISTS = 7023
+ERROR_CTX_WINSTATION_BUSY = 7024
+ERROR_CTX_BAD_VIDEO_MODE = 7025
+ERROR_CTX_GRAPHICS_INVALID = 7035
+ERROR_CTX_LOGON_DISABLED = 7037
+ERROR_CTX_NOT_CONSOLE = 7038
+ERROR_CTX_CLIENT_QUERY_TIMEOUT = 7040
+ERROR_CTX_CONSOLE_DISCONNECT = 7041
+ERROR_CTX_CONSOLE_CONNECT = 7042
+ERROR_CTX_SHADOW_DENIED = 7044
+ERROR_CTX_WINSTATION_ACCESS_DENIED = 7045
+ERROR_CTX_INVALID_WD = 7049
+ERROR_CTX_SHADOW_INVALID = 7050
+ERROR_CTX_SHADOW_DISABLED = 7051
+ERROR_CTX_CLIENT_LICENSE_IN_USE = 7052
+ERROR_CTX_CLIENT_LICENSE_NOT_SET = 7053
+ERROR_CTX_LICENSE_NOT_AVAILABLE = 7054
+ERROR_CTX_LICENSE_CLIENT_INVALID = 7055
+ERROR_CTX_LICENSE_EXPIRED = 7056
+ERROR_CTX_SHADOW_NOT_RUNNING = 7057
+ERROR_CTX_SHADOW_ENDED_BY_MODE_CHANGE = 7058
+ERROR_ACTIVATION_COUNT_EXCEEDED = 7059
+ERROR_CTX_WINSTATIONS_DISABLED = 7060
+ERROR_CTX_ENCRYPTION_LEVEL_REQUIRED = 7061
+ERROR_CTX_SESSION_IN_USE = 7062
+ERROR_CTX_NO_FORCE_LOGOFF = 7063
+ERROR_CTX_ACCOUNT_RESTRICTION = 7064
+ERROR_RDP_PROTOCOL_ERROR = 7065
+ERROR_CTX_CDM_CONNECT = 7066
+ERROR_CTX_CDM_DISCONNECT = 7067
+ERROR_CTX_SECURITY_LAYER_ERROR = 7068
+ERROR_TS_INCOMPATIBLE_SESSIONS = 7069
+FRS_ERR_INVALID_API_SEQUENCE = 8001
+FRS_ERR_STARTING_SERVICE = 8002
+FRS_ERR_STOPPING_SERVICE = 8003
+FRS_ERR_INTERNAL_API = 8004
+FRS_ERR_INTERNAL = 8005
+FRS_ERR_SERVICE_COMM = 8006
+FRS_ERR_INSUFFICIENT_PRIV = 8007
+FRS_ERR_AUTHENTICATION = 8008
+FRS_ERR_PARENT_INSUFFICIENT_PRIV = 8009
+FRS_ERR_PARENT_AUTHENTICATION = 8010
+FRS_ERR_CHILD_TO_PARENT_COMM = 8011
+FRS_ERR_PARENT_TO_CHILD_COMM = 8012
+FRS_ERR_SYSVOL_POPULATE = 8013
+FRS_ERR_SYSVOL_POPULATE_TIMEOUT = 8014
+FRS_ERR_SYSVOL_IS_BUSY = 8015
+FRS_ERR_SYSVOL_DEMOTE = 8016
+FRS_ERR_INVALID_SERVICE_PARAMETER = 8017
+DS_S_SUCCESS = NO_ERROR
+ERROR_DS_NOT_INSTALLED = 8200
+ERROR_DS_MEMBERSHIP_EVALUATED_LOCALLY = 8201
+ERROR_DS_NO_ATTRIBUTE_OR_VALUE = 8202
+ERROR_DS_INVALID_ATTRIBUTE_SYNTAX = 8203
+ERROR_DS_ATTRIBUTE_TYPE_UNDEFINED = 8204
+ERROR_DS_ATTRIBUTE_OR_VALUE_EXISTS = 8205
+ERROR_DS_BUSY = 8206
+ERROR_DS_UNAVAILABLE = 8207
+ERROR_DS_NO_RIDS_ALLOCATED = 8208
+ERROR_DS_NO_MORE_RIDS = 8209
+ERROR_DS_INCORRECT_ROLE_OWNER = 8210
+ERROR_DS_RIDMGR_INIT_ERROR = 8211
+ERROR_DS_OBJ_CLASS_VIOLATION = 8212
+ERROR_DS_CANT_ON_NON_LEAF = 8213
+ERROR_DS_CANT_ON_RDN = 8214
+ERROR_DS_CANT_MOD_OBJ_CLASS = 8215
+ERROR_DS_CROSS_DOM_MOVE_ERROR = 8216
+ERROR_DS_GC_NOT_AVAILABLE = 8217
+ERROR_SHARED_POLICY = 8218
+ERROR_POLICY_OBJECT_NOT_FOUND = 8219
+ERROR_POLICY_ONLY_IN_DS = 8220
+ERROR_PROMOTION_ACTIVE = 8221
+ERROR_NO_PROMOTION_ACTIVE = 8222
+ERROR_DS_OPERATIONS_ERROR = 8224
+ERROR_DS_PROTOCOL_ERROR = 8225
+ERROR_DS_TIMELIMIT_EXCEEDED = 8226
+ERROR_DS_SIZELIMIT_EXCEEDED = 8227
+ERROR_DS_ADMIN_LIMIT_EXCEEDED = 8228
+ERROR_DS_COMPARE_FALSE = 8229
+ERROR_DS_COMPARE_TRUE = 8230
+ERROR_DS_AUTH_METHOD_NOT_SUPPORTED = 8231
+ERROR_DS_STRONG_AUTH_REQUIRED = 8232
+ERROR_DS_INAPPROPRIATE_AUTH = 8233
+ERROR_DS_AUTH_UNKNOWN = 8234
+ERROR_DS_REFERRAL = 8235
+ERROR_DS_UNAVAILABLE_CRIT_EXTENSION = 8236
+ERROR_DS_CONFIDENTIALITY_REQUIRED = 8237
+ERROR_DS_INAPPROPRIATE_MATCHING = 8238
+ERROR_DS_CONSTRAINT_VIOLATION = 8239
+ERROR_DS_NO_SUCH_OBJECT = 8240
+ERROR_DS_ALIAS_PROBLEM = 8241
+ERROR_DS_INVALID_DN_SYNTAX = 8242
+ERROR_DS_IS_LEAF = 8243
+ERROR_DS_ALIAS_DEREF_PROBLEM = 8244
+ERROR_DS_UNWILLING_TO_PERFORM = 8245
+ERROR_DS_LOOP_DETECT = 8246
+ERROR_DS_NAMING_VIOLATION = 8247
+ERROR_DS_OBJECT_RESULTS_TOO_LARGE = 8248
+ERROR_DS_AFFECTS_MULTIPLE_DSAS = 8249
+ERROR_DS_SERVER_DOWN = 8250
+ERROR_DS_LOCAL_ERROR = 8251
+ERROR_DS_ENCODING_ERROR = 8252
+ERROR_DS_DECODING_ERROR = 8253
+ERROR_DS_FILTER_UNKNOWN = 8254
+ERROR_DS_PARAM_ERROR = 8255
+ERROR_DS_NOT_SUPPORTED = 8256
+ERROR_DS_NO_RESULTS_RETURNED = 8257
+ERROR_DS_CONTROL_NOT_FOUND = 8258
+ERROR_DS_CLIENT_LOOP = 8259
+ERROR_DS_REFERRAL_LIMIT_EXCEEDED = 8260
+ERROR_DS_SORT_CONTROL_MISSING = 8261
+ERROR_DS_OFFSET_RANGE_ERROR = 8262
+ERROR_DS_ROOT_MUST_BE_NC = 8301
+ERROR_DS_ADD_REPLICA_INHIBITED = 8302
+ERROR_DS_ATT_NOT_DEF_IN_SCHEMA = 8303
+ERROR_DS_MAX_OBJ_SIZE_EXCEEDED = 8304
+ERROR_DS_OBJ_STRING_NAME_EXISTS = 8305
+ERROR_DS_NO_RDN_DEFINED_IN_SCHEMA = 8306
+ERROR_DS_RDN_DOESNT_MATCH_SCHEMA = 8307
+ERROR_DS_NO_REQUESTED_ATTS_FOUND = 8308
+ERROR_DS_USER_BUFFER_TO_SMALL = 8309
+ERROR_DS_ATT_IS_NOT_ON_OBJ = 8310
+ERROR_DS_ILLEGAL_MOD_OPERATION = 8311
+ERROR_DS_OBJ_TOO_LARGE = 8312
+ERROR_DS_BAD_INSTANCE_TYPE = 8313
+ERROR_DS_MASTERDSA_REQUIRED = 8314
+ERROR_DS_OBJECT_CLASS_REQUIRED = 8315
+ERROR_DS_MISSING_REQUIRED_ATT = 8316
+ERROR_DS_ATT_NOT_DEF_FOR_CLASS = 8317
+ERROR_DS_ATT_ALREADY_EXISTS = 8318
+ERROR_DS_CANT_ADD_ATT_VALUES = 8320
+ERROR_DS_SINGLE_VALUE_CONSTRAINT = 8321
+ERROR_DS_RANGE_CONSTRAINT = 8322
+ERROR_DS_ATT_VAL_ALREADY_EXISTS = 8323
+ERROR_DS_CANT_REM_MISSING_ATT = 8324
+ERROR_DS_CANT_REM_MISSING_ATT_VAL = 8325
+ERROR_DS_ROOT_CANT_BE_SUBREF = 8326
+ERROR_DS_NO_CHAINING = 8327
+ERROR_DS_NO_CHAINED_EVAL = 8328
+ERROR_DS_NO_PARENT_OBJECT = 8329
+ERROR_DS_PARENT_IS_AN_ALIAS = 8330
+ERROR_DS_CANT_MIX_MASTER_AND_REPS = 8331
+ERROR_DS_CHILDREN_EXIST = 8332
+ERROR_DS_OBJ_NOT_FOUND = 8333
+ERROR_DS_ALIASED_OBJ_MISSING = 8334
+ERROR_DS_BAD_NAME_SYNTAX = 8335
+ERROR_DS_ALIAS_POINTS_TO_ALIAS = 8336
+ERROR_DS_CANT_DEREF_ALIAS = 8337
+ERROR_DS_OUT_OF_SCOPE = 8338
+ERROR_DS_OBJECT_BEING_REMOVED = 8339
+ERROR_DS_CANT_DELETE_DSA_OBJ = 8340
+ERROR_DS_GENERIC_ERROR = 8341
+ERROR_DS_DSA_MUST_BE_INT_MASTER = 8342
+ERROR_DS_CLASS_NOT_DSA = 8343
+ERROR_DS_INSUFF_ACCESS_RIGHTS = 8344
+ERROR_DS_ILLEGAL_SUPERIOR = 8345
+ERROR_DS_ATTRIBUTE_OWNED_BY_SAM = 8346
+ERROR_DS_NAME_TOO_MANY_PARTS = 8347
+ERROR_DS_NAME_TOO_LONG = 8348
+ERROR_DS_NAME_VALUE_TOO_LONG = 8349
+ERROR_DS_NAME_UNPARSEABLE = 8350
+ERROR_DS_NAME_TYPE_UNKNOWN = 8351
+ERROR_DS_NOT_AN_OBJECT = 8352
+ERROR_DS_SEC_DESC_TOO_SHORT = 8353
+ERROR_DS_SEC_DESC_INVALID = 8354
+ERROR_DS_NO_DELETED_NAME = 8355
+ERROR_DS_SUBREF_MUST_HAVE_PARENT = 8356
+ERROR_DS_NCNAME_MUST_BE_NC = 8357
+ERROR_DS_CANT_ADD_SYSTEM_ONLY = 8358
+ERROR_DS_CLASS_MUST_BE_CONCRETE = 8359
+ERROR_DS_INVALID_DMD = 8360
+ERROR_DS_OBJ_GUID_EXISTS = 8361
+ERROR_DS_NOT_ON_BACKLINK = 8362
+ERROR_DS_NO_CROSSREF_FOR_NC = 8363
+ERROR_DS_SHUTTING_DOWN = 8364
+ERROR_DS_UNKNOWN_OPERATION = 8365
+ERROR_DS_INVALID_ROLE_OWNER = 8366
+ERROR_DS_COULDNT_CONTACT_FSMO = 8367
+ERROR_DS_CROSS_NC_DN_RENAME = 8368
+ERROR_DS_CANT_MOD_SYSTEM_ONLY = 8369
+ERROR_DS_REPLICATOR_ONLY = 8370
+ERROR_DS_OBJ_CLASS_NOT_DEFINED = 8371
+ERROR_DS_OBJ_CLASS_NOT_SUBCLASS = 8372
+ERROR_DS_NAME_REFERENCE_INVALID = 8373
+ERROR_DS_CROSS_REF_EXISTS = 8374
+ERROR_DS_CANT_DEL_MASTER_CROSSREF = 8375
+ERROR_DS_SUBTREE_NOTIFY_NOT_NC_HEAD = 8376
+ERROR_DS_NOTIFY_FILTER_TOO_COMPLEX = 8377
+ERROR_DS_DUP_RDN = 8378
+ERROR_DS_DUP_OID = 8379
+ERROR_DS_DUP_MAPI_ID = 8380
+ERROR_DS_DUP_SCHEMA_ID_GUID = 8381
+ERROR_DS_DUP_LDAP_DISPLAY_NAME = 8382
+ERROR_DS_SEMANTIC_ATT_TEST = 8383
+ERROR_DS_SYNTAX_MISMATCH = 8384
+ERROR_DS_EXISTS_IN_MUST_HAVE = 8385
+ERROR_DS_EXISTS_IN_MAY_HAVE = 8386
+ERROR_DS_NONEXISTENT_MAY_HAVE = 8387
+ERROR_DS_NONEXISTENT_MUST_HAVE = 8388
+ERROR_DS_AUX_CLS_TEST_FAIL = 8389
+ERROR_DS_NONEXISTENT_POSS_SUP = 8390
+ERROR_DS_SUB_CLS_TEST_FAIL = 8391
+ERROR_DS_BAD_RDN_ATT_ID_SYNTAX = 8392
+ERROR_DS_EXISTS_IN_AUX_CLS = 8393
+ERROR_DS_EXISTS_IN_SUB_CLS = 8394
+ERROR_DS_EXISTS_IN_POSS_SUP = 8395
+ERROR_DS_RECALCSCHEMA_FAILED = 8396
+ERROR_DS_TREE_DELETE_NOT_FINISHED = 8397
+ERROR_DS_CANT_DELETE = 8398
+ERROR_DS_ATT_SCHEMA_REQ_ID = 8399
+ERROR_DS_BAD_ATT_SCHEMA_SYNTAX = 8400
+ERROR_DS_CANT_CACHE_ATT = 8401
+ERROR_DS_CANT_CACHE_CLASS = 8402
+ERROR_DS_CANT_REMOVE_ATT_CACHE = 8403
+ERROR_DS_CANT_REMOVE_CLASS_CACHE = 8404
+ERROR_DS_CANT_RETRIEVE_DN = 8405
+ERROR_DS_MISSING_SUPREF = 8406
+ERROR_DS_CANT_RETRIEVE_INSTANCE = 8407
+ERROR_DS_CODE_INCONSISTENCY = 8408
+ERROR_DS_DATABASE_ERROR = 8409
+ERROR_DS_GOVERNSID_MISSING = 8410
+ERROR_DS_MISSING_EXPECTED_ATT = 8411
+ERROR_DS_NCNAME_MISSING_CR_REF = 8412
+ERROR_DS_SECURITY_CHECKING_ERROR = 8413
+ERROR_DS_SCHEMA_NOT_LOADED = 8414
+ERROR_DS_SCHEMA_ALLOC_FAILED = 8415
+ERROR_DS_ATT_SCHEMA_REQ_SYNTAX = 8416
+ERROR_DS_GCVERIFY_ERROR = 8417
+ERROR_DS_DRA_SCHEMA_MISMATCH = 8418
+ERROR_DS_CANT_FIND_DSA_OBJ = 8419
+ERROR_DS_CANT_FIND_EXPECTED_NC = 8420
+ERROR_DS_CANT_FIND_NC_IN_CACHE = 8421
+ERROR_DS_CANT_RETRIEVE_CHILD = 8422
+ERROR_DS_SECURITY_ILLEGAL_MODIFY = 8423
+ERROR_DS_CANT_REPLACE_HIDDEN_REC = 8424
+ERROR_DS_BAD_HIERARCHY_FILE = 8425
+ERROR_DS_BUILD_HIERARCHY_TABLE_FAILED = 8426
+ERROR_DS_CONFIG_PARAM_MISSING = 8427
+ERROR_DS_COUNTING_AB_INDICES_FAILED = 8428
+ERROR_DS_HIERARCHY_TABLE_MALLOC_FAILED = 8429
+ERROR_DS_INTERNAL_FAILURE = 8430
+ERROR_DS_UNKNOWN_ERROR = 8431
+ERROR_DS_ROOT_REQUIRES_CLASS_TOP = 8432
+ERROR_DS_REFUSING_FSMO_ROLES = 8433
+ERROR_DS_MISSING_FSMO_SETTINGS = 8434
+ERROR_DS_UNABLE_TO_SURRENDER_ROLES = 8435
+ERROR_DS_DRA_GENERIC = 8436
+ERROR_DS_DRA_INVALID_PARAMETER = 8437
+ERROR_DS_DRA_BUSY = 8438
+ERROR_DS_DRA_BAD_DN = 8439
+ERROR_DS_DRA_BAD_NC = 8440
+ERROR_DS_DRA_DN_EXISTS = 8441
+ERROR_DS_DRA_INTERNAL_ERROR = 8442
+ERROR_DS_DRA_INCONSISTENT_DIT = 8443
+ERROR_DS_DRA_CONNECTION_FAILED = 8444
+ERROR_DS_DRA_BAD_INSTANCE_TYPE = 8445
+ERROR_DS_DRA_OUT_OF_MEM = 8446
+ERROR_DS_DRA_MAIL_PROBLEM = 8447
+ERROR_DS_DRA_REF_ALREADY_EXISTS = 8448
+ERROR_DS_DRA_REF_NOT_FOUND = 8449
+ERROR_DS_DRA_OBJ_IS_REP_SOURCE = 8450
+ERROR_DS_DRA_DB_ERROR = 8451
+ERROR_DS_DRA_NO_REPLICA = 8452
+ERROR_DS_DRA_ACCESS_DENIED = 8453
+ERROR_DS_DRA_NOT_SUPPORTED = 8454
+ERROR_DS_DRA_RPC_CANCELLED = 8455
+ERROR_DS_DRA_SOURCE_DISABLED = 8456
+ERROR_DS_DRA_SINK_DISABLED = 8457
+ERROR_DS_DRA_NAME_COLLISION = 8458
+ERROR_DS_DRA_SOURCE_REINSTALLED = 8459
+ERROR_DS_DRA_MISSING_PARENT = 8460
+ERROR_DS_DRA_PREEMPTED = 8461
+ERROR_DS_DRA_ABANDON_SYNC = 8462
+ERROR_DS_DRA_SHUTDOWN = 8463
+ERROR_DS_DRA_INCOMPATIBLE_PARTIAL_SET = 8464
+ERROR_DS_DRA_SOURCE_IS_PARTIAL_REPLICA = 8465
+ERROR_DS_DRA_EXTN_CONNECTION_FAILED = 8466
+ERROR_DS_INSTALL_SCHEMA_MISMATCH = 8467
+ERROR_DS_DUP_LINK_ID = 8468
+ERROR_DS_NAME_ERROR_RESOLVING = 8469
+ERROR_DS_NAME_ERROR_NOT_FOUND = 8470
+ERROR_DS_NAME_ERROR_NOT_UNIQUE = 8471
+ERROR_DS_NAME_ERROR_NO_MAPPING = 8472
+ERROR_DS_NAME_ERROR_DOMAIN_ONLY = 8473
+ERROR_DS_NAME_ERROR_NO_SYNTACTICAL_MAPPING = 8474
+ERROR_DS_CONSTRUCTED_ATT_MOD = 8475
+ERROR_DS_WRONG_OM_OBJ_CLASS = 8476
+ERROR_DS_DRA_REPL_PENDING = 8477
+ERROR_DS_DS_REQUIRED = 8478
+ERROR_DS_INVALID_LDAP_DISPLAY_NAME = 8479
+ERROR_DS_NON_BASE_SEARCH = 8480
+ERROR_DS_CANT_RETRIEVE_ATTS = 8481
+ERROR_DS_BACKLINK_WITHOUT_LINK = 8482
+ERROR_DS_EPOCH_MISMATCH = 8483
+ERROR_DS_SRC_NAME_MISMATCH = 8484
+ERROR_DS_SRC_AND_DST_NC_IDENTICAL = 8485
+ERROR_DS_DST_NC_MISMATCH = 8486
+ERROR_DS_NOT_AUTHORITIVE_FOR_DST_NC = 8487
+ERROR_DS_SRC_GUID_MISMATCH = 8488
+ERROR_DS_CANT_MOVE_DELETED_OBJECT = 8489
+ERROR_DS_PDC_OPERATION_IN_PROGRESS = 8490
+ERROR_DS_CROSS_DOMAIN_CLEANUP_REQD = 8491
+ERROR_DS_ILLEGAL_XDOM_MOVE_OPERATION = 8492
+ERROR_DS_CANT_WITH_ACCT_GROUP_MEMBERSHPS = 8493
+ERROR_DS_NC_MUST_HAVE_NC_PARENT = 8494
+ERROR_DS_CR_IMPOSSIBLE_TO_VALIDATE = 8495
+ERROR_DS_DST_DOMAIN_NOT_NATIVE = 8496
+ERROR_DS_MISSING_INFRASTRUCTURE_CONTAINER = 8497
+ERROR_DS_CANT_MOVE_ACCOUNT_GROUP = 8498
+ERROR_DS_CANT_MOVE_RESOURCE_GROUP = 8499
+ERROR_DS_INVALID_SEARCH_FLAG = 8500
+ERROR_DS_NO_TREE_DELETE_ABOVE_NC = 8501
+ERROR_DS_COULDNT_LOCK_TREE_FOR_DELETE = 8502
+ERROR_DS_COULDNT_IDENTIFY_OBJECTS_FOR_TREE_DELETE = 8503
+ERROR_DS_SAM_INIT_FAILURE = 8504
+ERROR_DS_SENSITIVE_GROUP_VIOLATION = 8505
+ERROR_DS_CANT_MOD_PRIMARYGROUPID = 8506
+ERROR_DS_ILLEGAL_BASE_SCHEMA_MOD = 8507
+ERROR_DS_NONSAFE_SCHEMA_CHANGE = 8508
+ERROR_DS_SCHEMA_UPDATE_DISALLOWED = 8509
+ERROR_DS_CANT_CREATE_UNDER_SCHEMA = 8510
+ERROR_DS_INSTALL_NO_SRC_SCH_VERSION = 8511
+ERROR_DS_INSTALL_NO_SCH_VERSION_IN_INIFILE = 8512
+ERROR_DS_INVALID_GROUP_TYPE = 8513
+ERROR_DS_NO_NEST_GLOBALGROUP_IN_MIXEDDOMAIN = 8514
+ERROR_DS_NO_NEST_LOCALGROUP_IN_MIXEDDOMAIN = 8515
+ERROR_DS_GLOBAL_CANT_HAVE_LOCAL_MEMBER = 8516
+ERROR_DS_GLOBAL_CANT_HAVE_UNIVERSAL_MEMBER = 8517
+ERROR_DS_UNIVERSAL_CANT_HAVE_LOCAL_MEMBER = 8518
+ERROR_DS_GLOBAL_CANT_HAVE_CROSSDOMAIN_MEMBER = 8519
+ERROR_DS_LOCAL_CANT_HAVE_CROSSDOMAIN_LOCAL_MEMBER = 8520
+ERROR_DS_HAVE_PRIMARY_MEMBERS = 8521
+ERROR_DS_STRING_SD_CONVERSION_FAILED = 8522
+ERROR_DS_NAMING_MASTER_GC = 8523
+ERROR_DS_DNS_LOOKUP_FAILURE = 8524
+ERROR_DS_COULDNT_UPDATE_SPNS = 8525
+ERROR_DS_CANT_RETRIEVE_SD = 8526
+ERROR_DS_KEY_NOT_UNIQUE = 8527
+ERROR_DS_WRONG_LINKED_ATT_SYNTAX = 8528
+ERROR_DS_SAM_NEED_BOOTKEY_PASSWORD = 8529
+ERROR_DS_SAM_NEED_BOOTKEY_FLOPPY = 8530
+ERROR_DS_CANT_START = 8531
+ERROR_DS_INIT_FAILURE = 8532
+ERROR_DS_NO_PKT_PRIVACY_ON_CONNECTION = 8533
+ERROR_DS_SOURCE_DOMAIN_IN_FOREST = 8534
+ERROR_DS_DESTINATION_DOMAIN_NOT_IN_FOREST = 8535
+ERROR_DS_DESTINATION_AUDITING_NOT_ENABLED = 8536
+ERROR_DS_CANT_FIND_DC_FOR_SRC_DOMAIN = 8537
+ERROR_DS_SRC_OBJ_NOT_GROUP_OR_USER = 8538
+ERROR_DS_SRC_SID_EXISTS_IN_FOREST = 8539
+ERROR_DS_SRC_AND_DST_OBJECT_CLASS_MISMATCH = 8540
+ERROR_SAM_INIT_FAILURE = 8541
+ERROR_DS_DRA_SCHEMA_INFO_SHIP = 8542
+ERROR_DS_DRA_SCHEMA_CONFLICT = 8543
+ERROR_DS_DRA_EARLIER_SCHEMA_CONFLICT = 8544
+ERROR_DS_DRA_OBJ_NC_MISMATCH = 8545
+ERROR_DS_NC_STILL_HAS_DSAS = 8546
+ERROR_DS_GC_REQUIRED = 8547
+ERROR_DS_LOCAL_MEMBER_OF_LOCAL_ONLY = 8548
+ERROR_DS_NO_FPO_IN_UNIVERSAL_GROUPS = 8549
+ERROR_DS_CANT_ADD_TO_GC = 8550
+ERROR_DS_NO_CHECKPOINT_WITH_PDC = 8551
+ERROR_DS_SOURCE_AUDITING_NOT_ENABLED = 8552
+ERROR_DS_CANT_CREATE_IN_NONDOMAIN_NC = 8553
+ERROR_DS_INVALID_NAME_FOR_SPN = 8554
+ERROR_DS_FILTER_USES_CONTRUCTED_ATTRS = 8555
+ERROR_DS_UNICODEPWD_NOT_IN_QUOTES = 8556
+ERROR_DS_MACHINE_ACCOUNT_QUOTA_EXCEEDED = 8557
+ERROR_DS_MUST_BE_RUN_ON_DST_DC = 8558
+ERROR_DS_SRC_DC_MUST_BE_SP4_OR_GREATER = 8559
+ERROR_DS_CANT_TREE_DELETE_CRITICAL_OBJ = 8560
+ERROR_DS_INIT_FAILURE_CONSOLE = 8561
+ERROR_DS_SAM_INIT_FAILURE_CONSOLE = 8562
+ERROR_DS_FOREST_VERSION_TOO_HIGH = 8563
+ERROR_DS_DOMAIN_VERSION_TOO_HIGH = 8564
+ERROR_DS_FOREST_VERSION_TOO_LOW = 8565
+ERROR_DS_DOMAIN_VERSION_TOO_LOW = 8566
+ERROR_DS_INCOMPATIBLE_VERSION = 8567
+ERROR_DS_LOW_DSA_VERSION = 8568
+ERROR_DS_NO_BEHAVIOR_VERSION_IN_MIXEDDOMAIN = 8569
+ERROR_DS_NOT_SUPPORTED_SORT_ORDER = 8570
+ERROR_DS_NAME_NOT_UNIQUE = 8571
+ERROR_DS_MACHINE_ACCOUNT_CREATED_PRENT4 = 8572
+ERROR_DS_OUT_OF_VERSION_STORE = 8573
+ERROR_DS_INCOMPATIBLE_CONTROLS_USED = 8574
+ERROR_DS_NO_REF_DOMAIN = 8575
+ERROR_DS_RESERVED_LINK_ID = 8576
+ERROR_DS_LINK_ID_NOT_AVAILABLE = 8577
+ERROR_DS_AG_CANT_HAVE_UNIVERSAL_MEMBER = 8578
+ERROR_DS_MODIFYDN_DISALLOWED_BY_INSTANCE_TYPE = 8579
+ERROR_DS_NO_OBJECT_MOVE_IN_SCHEMA_NC = 8580
+ERROR_DS_MODIFYDN_DISALLOWED_BY_FLAG = 8581
+ERROR_DS_MODIFYDN_WRONG_GRANDPARENT = 8582
+ERROR_DS_NAME_ERROR_TRUST_REFERRAL = 8583
+ERROR_NOT_SUPPORTED_ON_STANDARD_SERVER = 8584
+ERROR_DS_CANT_ACCESS_REMOTE_PART_OF_AD = 8585
+ERROR_DS_CR_IMPOSSIBLE_TO_VALIDATE_V2 = 8586
+ERROR_DS_THREAD_LIMIT_EXCEEDED = 8587
+ERROR_DS_NOT_CLOSEST = 8588
+ERROR_DS_CANT_DERIVE_SPN_WITHOUT_SERVER_REF = 8589
+ERROR_DS_SINGLE_USER_MODE_FAILED = 8590
+ERROR_DS_NTDSCRIPT_SYNTAX_ERROR = 8591
+ERROR_DS_NTDSCRIPT_PROCESS_ERROR = 8592
+ERROR_DS_DIFFERENT_REPL_EPOCHS = 8593
+ERROR_DS_DRS_EXTENSIONS_CHANGED = 8594
+ERROR_DS_REPLICA_SET_CHANGE_NOT_ALLOWED_ON_DISABLED_CR = 8595
+ERROR_DS_NO_MSDS_INTID = 8596
+ERROR_DS_DUP_MSDS_INTID = 8597
+ERROR_DS_EXISTS_IN_RDNATTID = 8598
+ERROR_DS_AUTHORIZATION_FAILED = 8599
+ERROR_DS_INVALID_SCRIPT = 8600
+ERROR_DS_REMOTE_CROSSREF_OP_FAILED = 8601
+ERROR_DS_CROSS_REF_BUSY = 8602
+ERROR_DS_CANT_DERIVE_SPN_FOR_DELETED_DOMAIN = 8603
+ERROR_DS_CANT_DEMOTE_WITH_WRITEABLE_NC = 8604
+ERROR_DS_DUPLICATE_ID_FOUND = 8605
+ERROR_DS_INSUFFICIENT_ATTR_TO_CREATE_OBJECT = 8606
+ERROR_DS_GROUP_CONVERSION_ERROR = 8607
+ERROR_DS_CANT_MOVE_APP_BASIC_GROUP = 8608
+ERROR_DS_CANT_MOVE_APP_QUERY_GROUP = 8609
+ERROR_DS_ROLE_NOT_VERIFIED = 8610
+ERROR_DS_WKO_CONTAINER_CANNOT_BE_SPECIAL = 8611
+ERROR_DS_DOMAIN_RENAME_IN_PROGRESS = 8612
+ERROR_DS_EXISTING_AD_CHILD_NC = 8613
+ERROR_DS_REPL_LIFETIME_EXCEEDED = 8614
+ERROR_DS_DISALLOWED_IN_SYSTEM_CONTAINER = 8615
+ERROR_DS_LDAP_SEND_QUEUE_FULL = 8616
+ERROR_DS_DRA_OUT_SCHEDULE_WINDOW = 8617
+ERROR_DS_POLICY_NOT_KNOWN = 8618
+ERROR_NO_SITE_SETTINGS_OBJECT = 8619
+ERROR_NO_SECRETS = 8620
+ERROR_NO_WRITABLE_DC_FOUND = 8621
+ERROR_DS_NO_SERVER_OBJECT = 8622
+ERROR_DS_NO_NTDSA_OBJECT = 8623
+ERROR_DS_NON_ASQ_SEARCH = 8624
+ERROR_DS_AUDIT_FAILURE = 8625
+ERROR_DS_INVALID_SEARCH_FLAG_SUBTREE = 8626
+ERROR_DS_INVALID_SEARCH_FLAG_TUPLE = 8627
+ERROR_DS_HIERARCHY_TABLE_TOO_DEEP = 8628
+
+SEVERITY_SUCCESS = 0
+SEVERITY_ERROR = 1
+
+
+def HRESULT_FROM_WIN32(scode):
+    return -2147024896 | (scode & 65535)
+
+
+def SUCCEEDED(Status):
+    return (Status) >= 0
+
+
+def FAILED(Status):
+    return Status < 0
+
+
+def HRESULT_CODE(hr):
+    return (hr) & 65535
+
+
+def SCODE_CODE(sc):
+    return (sc) & 65535
+
+
+def HRESULT_FACILITY(hr):
+    return ((hr) >> 16) & 8191
+
+
+def SCODE_FACILITY(sc):
+    return ((sc) >> 16) & 8191
+
+
+def HRESULT_SEVERITY(hr):
+    return ((hr) >> 31) & 1
+
+
+def SCODE_SEVERITY(sc):
+    return ((sc) >> 31) & 1
+
+
+FACILITY_NT_BIT = 268435456
+
+
+def HRESULT_FROM_NT(x):
+    return x | FACILITY_NT_BIT
+
+
+def GetScode(hr):
+    return hr
+
+
+def ResultFromScode(sc):
+    return sc
+
+
+NOERROR = 0
+E_UNEXPECTED = -2147418113
+E_NOTIMPL = -2147467263
+E_OUTOFMEMORY = -2147024882
+E_INVALIDARG = -2147024809
+E_NOINTERFACE = -2147467262
+E_POINTER = -2147467261
+E_HANDLE = -2147024890
+E_ABORT = -2147467260
+E_FAIL = -2147467259
+E_ACCESSDENIED = -2147024891
+win16_E_NOTIMPL = -2147483647
+win16_E_OUTOFMEMORY = -2147483646
+win16_E_INVALIDARG = -2147483645
+win16_E_NOINTERFACE = -2147483644
+win16_E_POINTER = -2147483643
+win16_E_HANDLE = -2147483642
+win16_E_ABORT = -2147483641
+win16_E_FAIL = -2147483640
+win16_E_ACCESSDENIED = -2147483639
+E_PENDING = -2147483638
+CO_E_INIT_TLS = -2147467258
+CO_E_INIT_SHARED_ALLOCATOR = -2147467257
+CO_E_INIT_MEMORY_ALLOCATOR = -2147467256
+CO_E_INIT_CLASS_CACHE = -2147467255
+CO_E_INIT_RPC_CHANNEL = -2147467254
+CO_E_INIT_TLS_SET_CHANNEL_CONTROL = -2147467253
+CO_E_INIT_TLS_CHANNEL_CONTROL = -2147467252
+CO_E_INIT_UNACCEPTED_USER_ALLOCATOR = -2147467251
+CO_E_INIT_SCM_MUTEX_EXISTS = -2147467250
+CO_E_INIT_SCM_FILE_MAPPING_EXISTS = -2147467249
+CO_E_INIT_SCM_MAP_VIEW_OF_FILE = -2147467248
+CO_E_INIT_SCM_EXEC_FAILURE = -2147467247
+CO_E_INIT_ONLY_SINGLE_THREADED = -2147467246
+CO_E_CANT_REMOTE = -2147467245
+CO_E_BAD_SERVER_NAME = -2147467244
+CO_E_WRONG_SERVER_IDENTITY = -2147467243
+CO_E_OLE1DDE_DISABLED = -2147467242
+CO_E_RUNAS_SYNTAX = -2147467241
+CO_E_CREATEPROCESS_FAILURE = -2147467240
+CO_E_RUNAS_CREATEPROCESS_FAILURE = -2147467239
+CO_E_RUNAS_LOGON_FAILURE = -2147467238
+CO_E_LAUNCH_PERMSSION_DENIED = -2147467237
+CO_E_START_SERVICE_FAILURE = -2147467236
+CO_E_REMOTE_COMMUNICATION_FAILURE = -2147467235
+CO_E_SERVER_START_TIMEOUT = -2147467234
+CO_E_CLSREG_INCONSISTENT = -2147467233
+CO_E_IIDREG_INCONSISTENT = -2147467232
+CO_E_NOT_SUPPORTED = -2147467231
+CO_E_RELOAD_DLL = -2147467230
+CO_E_MSI_ERROR = -2147467229
+
+OLE_E_FIRST = -2147221504
+OLE_E_LAST = -2147221249
+OLE_S_FIRST = 262144
+OLE_S_LAST = 262399
+
+OLE_E_OLEVERB = -2147221504
+OLE_E_ADVF = -2147221503
+OLE_E_ENUM_NOMORE = -2147221502
+OLE_E_ADVISENOTSUPPORTED = -2147221501
+OLE_E_NOCONNECTION = -2147221500
+OLE_E_NOTRUNNING = -2147221499
+OLE_E_NOCACHE = -2147221498
+OLE_E_BLANK = -2147221497
+OLE_E_CLASSDIFF = -2147221496
+OLE_E_CANT_GETMONIKER = -2147221495
+OLE_E_CANT_BINDTOSOURCE = -2147221494
+OLE_E_STATIC = -2147221493
+OLE_E_PROMPTSAVECANCELLED = -2147221492
+OLE_E_INVALIDRECT = -2147221491
+OLE_E_WRONGCOMPOBJ = -2147221490
+OLE_E_INVALIDHWND = -2147221489
+OLE_E_NOT_INPLACEACTIVE = -2147221488
+OLE_E_CANTCONVERT = -2147221487
+OLE_E_NOSTORAGE = -2147221486
+DV_E_FORMATETC = -2147221404
+DV_E_DVTARGETDEVICE = -2147221403
+DV_E_STGMEDIUM = -2147221402
+DV_E_STATDATA = -2147221401
+DV_E_LINDEX = -2147221400
+DV_E_TYMED = -2147221399
+DV_E_CLIPFORMAT = -2147221398
+DV_E_DVASPECT = -2147221397
+DV_E_DVTARGETDEVICE_SIZE = -2147221396
+DV_E_NOIVIEWOBJECT = -2147221395
+DRAGDROP_E_FIRST = -2147221248
+DRAGDROP_E_LAST = -2147221233
+DRAGDROP_S_FIRST = 262400
+DRAGDROP_S_LAST = 262415
+DRAGDROP_E_NOTREGISTERED = -2147221248
+DRAGDROP_E_ALREADYREGISTERED = -2147221247
+DRAGDROP_E_INVALIDHWND = -2147221246
+CLASSFACTORY_E_FIRST = -2147221232
+CLASSFACTORY_E_LAST = -2147221217
+CLASSFACTORY_S_FIRST = 262416
+CLASSFACTORY_S_LAST = 262431
+CLASS_E_NOAGGREGATION = -2147221232
+CLASS_E_CLASSNOTAVAILABLE = -2147221231
+CLASS_E_NOTLICENSED = -2147221230
+MARSHAL_E_FIRST = -2147221216
+MARSHAL_E_LAST = -2147221201
+MARSHAL_S_FIRST = 262432
+MARSHAL_S_LAST = 262447
+DATA_E_FIRST = -2147221200
+DATA_E_LAST = -2147221185
+DATA_S_FIRST = 262448
+DATA_S_LAST = 262463
+VIEW_E_FIRST = -2147221184
+VIEW_E_LAST = -2147221169
+VIEW_S_FIRST = 262464
+VIEW_S_LAST = 262479
+VIEW_E_DRAW = -2147221184
+REGDB_E_FIRST = -2147221168
+REGDB_E_LAST = -2147221153
+REGDB_S_FIRST = 262480
+REGDB_S_LAST = 262495
+REGDB_E_READREGDB = -2147221168
+REGDB_E_WRITEREGDB = -2147221167
+REGDB_E_KEYMISSING = -2147221166
+REGDB_E_INVALIDVALUE = -2147221165
+REGDB_E_CLASSNOTREG = -2147221164
+REGDB_E_IIDNOTREG = -2147221163
+CAT_E_FIRST = -2147221152
+CAT_E_LAST = -2147221151
+CAT_E_CATIDNOEXIST = -2147221152
+CAT_E_NODESCRIPTION = -2147221151
+CS_E_FIRST = -2147221148
+CS_E_LAST = -2147221144
+CS_E_PACKAGE_NOTFOUND = -2147221148
+CS_E_NOT_DELETABLE = -2147221147
+CS_E_CLASS_NOTFOUND = -2147221146
+CS_E_INVALID_VERSION = -2147221145
+CS_E_NO_CLASSSTORE = -2147221144
+CACHE_E_FIRST = -2147221136
+CACHE_E_LAST = -2147221121
+CACHE_S_FIRST = 262512
+CACHE_S_LAST = 262527
+CACHE_E_NOCACHE_UPDATED = -2147221136
+OLEOBJ_E_FIRST = -2147221120
+OLEOBJ_E_LAST = -2147221105
+OLEOBJ_S_FIRST = 262528
+OLEOBJ_S_LAST = 262543
+OLEOBJ_E_NOVERBS = -2147221120
+OLEOBJ_E_INVALIDVERB = -2147221119
+CLIENTSITE_E_FIRST = -2147221104
+CLIENTSITE_E_LAST = -2147221089
+CLIENTSITE_S_FIRST = 262544
+CLIENTSITE_S_LAST = 262559
+INPLACE_E_NOTUNDOABLE = -2147221088
+INPLACE_E_NOTOOLSPACE = -2147221087
+INPLACE_E_FIRST = -2147221088
+INPLACE_E_LAST = -2147221073
+INPLACE_S_FIRST = 262560
+INPLACE_S_LAST = 262575
+ENUM_E_FIRST = -2147221072
+ENUM_E_LAST = -2147221057
+ENUM_S_FIRST = 262576
+ENUM_S_LAST = 262591
+CONVERT10_E_FIRST = -2147221056
+CONVERT10_E_LAST = -2147221041
+CONVERT10_S_FIRST = 262592
+CONVERT10_S_LAST = 262607
+CONVERT10_E_OLESTREAM_GET = -2147221056
+CONVERT10_E_OLESTREAM_PUT = -2147221055
+CONVERT10_E_OLESTREAM_FMT = -2147221054
+CONVERT10_E_OLESTREAM_BITMAP_TO_DIB = -2147221053
+CONVERT10_E_STG_FMT = -2147221052
+CONVERT10_E_STG_NO_STD_STREAM = -2147221051
+CONVERT10_E_STG_DIB_TO_BITMAP = -2147221050
+CLIPBRD_E_FIRST = -2147221040
+CLIPBRD_E_LAST = -2147221025
+CLIPBRD_S_FIRST = 262608
+CLIPBRD_S_LAST = 262623
+CLIPBRD_E_CANT_OPEN = -2147221040
+CLIPBRD_E_CANT_EMPTY = -2147221039
+CLIPBRD_E_CANT_SET = -2147221038
+CLIPBRD_E_BAD_DATA = -2147221037
+CLIPBRD_E_CANT_CLOSE = -2147221036
+MK_E_FIRST = -2147221024
+MK_E_LAST = -2147221009
+MK_S_FIRST = 262624
+MK_S_LAST = 262639
+MK_E_CONNECTMANUALLY = -2147221024
+MK_E_EXCEEDEDDEADLINE = -2147221023
+MK_E_NEEDGENERIC = -2147221022
+MK_E_UNAVAILABLE = -2147221021
+MK_E_SYNTAX = -2147221020
+MK_E_NOOBJECT = -2147221019
+MK_E_INVALIDEXTENSION = -2147221018
+MK_E_INTERMEDIATEINTERFACENOTSUPPORTED = -2147221017
+MK_E_NOTBINDABLE = -2147221016
+MK_E_NOTBOUND = -2147221015
+MK_E_CANTOPENFILE = -2147221014
+MK_E_MUSTBOTHERUSER = -2147221013
+MK_E_NOINVERSE = -2147221012
+MK_E_NOSTORAGE = -2147221011
+MK_E_NOPREFIX = -2147221010
+MK_E_ENUMERATION_FAILED = -2147221009
+CO_E_FIRST = -2147221008
+CO_E_LAST = -2147220993
+CO_S_FIRST = 262640
+CO_S_LAST = 262655
+CO_E_NOTINITIALIZED = -2147221008
+CO_E_ALREADYINITIALIZED = -2147221007
+CO_E_CANTDETERMINECLASS = -2147221006
+CO_E_CLASSSTRING = -2147221005
+CO_E_IIDSTRING = -2147221004
+CO_E_APPNOTFOUND = -2147221003
+CO_E_APPSINGLEUSE = -2147221002
+CO_E_ERRORINAPP = -2147221001
+CO_E_DLLNOTFOUND = -2147221000
+CO_E_ERRORINDLL = -2147220999
+CO_E_WRONGOSFORAPP = -2147220998
+CO_E_OBJNOTREG = -2147220997
+CO_E_OBJISREG = -2147220996
+CO_E_OBJNOTCONNECTED = -2147220995
+CO_E_APPDIDNTREG = -2147220994
+CO_E_RELEASED = -2147220993
+CO_E_FAILEDTOIMPERSONATE = -2147220992
+CO_E_FAILEDTOGETSECCTX = -2147220991
+CO_E_FAILEDTOOPENTHREADTOKEN = -2147220990
+CO_E_FAILEDTOGETTOKENINFO = -2147220989
+CO_E_TRUSTEEDOESNTMATCHCLIENT = -2147220988
+CO_E_FAILEDTOQUERYCLIENTBLANKET = -2147220987
+CO_E_FAILEDTOSETDACL = -2147220986
+CO_E_ACCESSCHECKFAILED = -2147220985
+CO_E_NETACCESSAPIFAILED = -2147220984
+CO_E_WRONGTRUSTEENAMESYNTAX = -2147220983
+CO_E_INVALIDSID = -2147220982
+CO_E_CONVERSIONFAILED = -2147220981
+CO_E_NOMATCHINGSIDFOUND = -2147220980
+CO_E_LOOKUPACCSIDFAILED = -2147220979
+CO_E_NOMATCHINGNAMEFOUND = -2147220978
+CO_E_LOOKUPACCNAMEFAILED = -2147220977
+CO_E_SETSERLHNDLFAILED = -2147220976
+CO_E_FAILEDTOGETWINDIR = -2147220975
+CO_E_PATHTOOLONG = -2147220974
+CO_E_FAILEDTOGENUUID = -2147220973
+CO_E_FAILEDTOCREATEFILE = -2147220972
+CO_E_FAILEDTOCLOSEHANDLE = -2147220971
+CO_E_EXCEEDSYSACLLIMIT = -2147220970
+CO_E_ACESINWRONGORDER = -2147220969
+CO_E_INCOMPATIBLESTREAMVERSION = -2147220968
+CO_E_FAILEDTOOPENPROCESSTOKEN = -2147220967
+CO_E_DECODEFAILED = -2147220966
+CO_E_ACNOTINITIALIZED = -2147220965
+OLE_S_USEREG = 262144
+OLE_S_STATIC = 262145
+OLE_S_MAC_CLIPFORMAT = 262146
+DRAGDROP_S_DROP = 262400
+DRAGDROP_S_CANCEL = 262401
+DRAGDROP_S_USEDEFAULTCURSORS = 262402
+DATA_S_SAMEFORMATETC = 262448
+VIEW_S_ALREADY_FROZEN = 262464
+CACHE_S_FORMATETC_NOTSUPPORTED = 262512
+CACHE_S_SAMECACHE = 262513
+CACHE_S_SOMECACHES_NOTUPDATED = 262514
+OLEOBJ_S_INVALIDVERB = 262528
+OLEOBJ_S_CANNOT_DOVERB_NOW = 262529
+OLEOBJ_S_INVALIDHWND = 262530
+INPLACE_S_TRUNCATED = 262560
+CONVERT10_S_NO_PRESENTATION = 262592
+MK_S_REDUCED_TO_SELF = 262626
+MK_S_ME = 262628
+MK_S_HIM = 262629
+MK_S_US = 262630
+MK_S_MONIKERALREADYREGISTERED = 262631
+CO_E_CLASS_CREATE_FAILED = -2146959359
+CO_E_SCM_ERROR = -2146959358
+CO_E_SCM_RPC_FAILURE = -2146959357
+CO_E_BAD_PATH = -2146959356
+CO_E_SERVER_EXEC_FAILURE = -2146959355
+CO_E_OBJSRV_RPC_FAILURE = -2146959354
+MK_E_NO_NORMALIZED = -2146959353
+CO_E_SERVER_STOPPING = -2146959352
+MEM_E_INVALID_ROOT = -2146959351
+MEM_E_INVALID_LINK = -2146959344
+MEM_E_INVALID_SIZE = -2146959343
+CO_S_NOTALLINTERFACES = 524306
+DISP_E_UNKNOWNINTERFACE = -2147352575
+DISP_E_MEMBERNOTFOUND = -2147352573
+DISP_E_PARAMNOTFOUND = -2147352572
+DISP_E_TYPEMISMATCH = -2147352571
+DISP_E_UNKNOWNNAME = -2147352570
+DISP_E_NONAMEDARGS = -2147352569
+DISP_E_BADVARTYPE = -2147352568
+DISP_E_EXCEPTION = -2147352567
+DISP_E_OVERFLOW = -2147352566
+DISP_E_BADINDEX = -2147352565
+DISP_E_UNKNOWNLCID = -2147352564
+DISP_E_ARRAYISLOCKED = -2147352563
+DISP_E_BADPARAMCOUNT = -2147352562
+DISP_E_PARAMNOTOPTIONAL = -2147352561
+DISP_E_BADCALLEE = -2147352560
+DISP_E_NOTACOLLECTION = -2147352559
+DISP_E_DIVBYZERO = -2147352558
+TYPE_E_BUFFERTOOSMALL = -2147319786
+TYPE_E_FIELDNOTFOUND = -2147319785
+TYPE_E_INVDATAREAD = -2147319784
+TYPE_E_UNSUPFORMAT = -2147319783
+TYPE_E_REGISTRYACCESS = -2147319780
+TYPE_E_LIBNOTREGISTERED = -2147319779
+TYPE_E_UNDEFINEDTYPE = -2147319769
+TYPE_E_QUALIFIEDNAMEDISALLOWED = -2147319768
+TYPE_E_INVALIDSTATE = -2147319767
+TYPE_E_WRONGTYPEKIND = -2147319766
+TYPE_E_ELEMENTNOTFOUND = -2147319765
+TYPE_E_AMBIGUOUSNAME = -2147319764
+TYPE_E_NAMECONFLICT = -2147319763
+TYPE_E_UNKNOWNLCID = -2147319762
+TYPE_E_DLLFUNCTIONNOTFOUND = -2147319761
+TYPE_E_BADMODULEKIND = -2147317571
+TYPE_E_SIZETOOBIG = -2147317563
+TYPE_E_DUPLICATEID = -2147317562
+TYPE_E_INVALIDID = -2147317553
+TYPE_E_TYPEMISMATCH = -2147316576
+TYPE_E_OUTOFBOUNDS = -2147316575
+TYPE_E_IOERROR = -2147316574
+TYPE_E_CANTCREATETMPFILE = -2147316573
+TYPE_E_CANTLOADLIBRARY = -2147312566
+TYPE_E_INCONSISTENTPROPFUNCS = -2147312509
+TYPE_E_CIRCULARTYPE = -2147312508
+STG_E_INVALIDFUNCTION = -2147287039
+STG_E_FILENOTFOUND = -2147287038
+STG_E_PATHNOTFOUND = -2147287037
+STG_E_TOOMANYOPENFILES = -2147287036
+STG_E_ACCESSDENIED = -2147287035
+STG_E_INVALIDHANDLE = -2147287034
+STG_E_INSUFFICIENTMEMORY = -2147287032
+STG_E_INVALIDPOINTER = -2147287031
+STG_E_NOMOREFILES = -2147287022
+STG_E_DISKISWRITEPROTECTED = -2147287021
+STG_E_SEEKERROR = -2147287015
+STG_E_WRITEFAULT = -2147287011
+STG_E_READFAULT = -2147287010
+STG_E_SHAREVIOLATION = -2147287008
+STG_E_LOCKVIOLATION = -2147287007
+STG_E_FILEALREADYEXISTS = -2147286960
+STG_E_INVALIDPARAMETER = -2147286953
+STG_E_MEDIUMFULL = -2147286928
+STG_E_PROPSETMISMATCHED = -2147286800
+STG_E_ABNORMALAPIEXIT = -2147286790
+STG_E_INVALIDHEADER = -2147286789
+STG_E_INVALIDNAME = -2147286788
+STG_E_UNKNOWN = -2147286787
+STG_E_UNIMPLEMENTEDFUNCTION = -2147286786
+STG_E_INVALIDFLAG = -2147286785
+STG_E_INUSE = -2147286784
+STG_E_NOTCURRENT = -2147286783
+STG_E_REVERTED = -2147286782
+STG_E_CANTSAVE = -2147286781
+STG_E_OLDFORMAT = -2147286780
+STG_E_OLDDLL = -2147286779
+STG_E_SHAREREQUIRED = -2147286778
+STG_E_NOTFILEBASEDSTORAGE = -2147286777
+STG_E_EXTANTMARSHALLINGS = -2147286776
+STG_E_DOCFILECORRUPT = -2147286775
+STG_E_BADBASEADDRESS = -2147286768
+STG_E_INCOMPLETE = -2147286527
+STG_E_TERMINATED = -2147286526
+STG_S_CONVERTED = 197120
+STG_S_BLOCK = 197121
+STG_S_RETRYNOW = 197122
+STG_S_MONITORING = 197123
+STG_S_MULTIPLEOPENS = 197124
+STG_S_CONSOLIDATIONFAILED = 197125
+STG_S_CANNOTCONSOLIDATE = 197126
+RPC_E_CALL_REJECTED = -2147418111
+RPC_E_CALL_CANCELED = -2147418110
+RPC_E_CANTPOST_INSENDCALL = -2147418109
+RPC_E_CANTCALLOUT_INASYNCCALL = -2147418108
+RPC_E_CANTCALLOUT_INEXTERNALCALL = -2147418107
+RPC_E_CONNECTION_TERMINATED = -2147418106
+RPC_E_SERVER_DIED = -2147418105
+RPC_E_CLIENT_DIED = -2147418104
+RPC_E_INVALID_DATAPACKET = -2147418103
+RPC_E_CANTTRANSMIT_CALL = -2147418102
+RPC_E_CLIENT_CANTMARSHAL_DATA = -2147418101
+RPC_E_CLIENT_CANTUNMARSHAL_DATA = -2147418100
+RPC_E_SERVER_CANTMARSHAL_DATA = -2147418099
+RPC_E_SERVER_CANTUNMARSHAL_DATA = -2147418098
+RPC_E_INVALID_DATA = -2147418097
+RPC_E_INVALID_PARAMETER = -2147418096
+RPC_E_CANTCALLOUT_AGAIN = -2147418095
+RPC_E_SERVER_DIED_DNE = -2147418094
+RPC_E_SYS_CALL_FAILED = -2147417856
+RPC_E_OUT_OF_RESOURCES = -2147417855
+RPC_E_ATTEMPTED_MULTITHREAD = -2147417854
+RPC_E_NOT_REGISTERED = -2147417853
+RPC_E_FAULT = -2147417852
+RPC_E_SERVERFAULT = -2147417851
+RPC_E_CHANGED_MODE = -2147417850
+RPC_E_INVALIDMETHOD = -2147417849
+RPC_E_DISCONNECTED = -2147417848
+RPC_E_RETRY = -2147417847
+RPC_E_SERVERCALL_RETRYLATER = -2147417846
+RPC_E_SERVERCALL_REJECTED = -2147417845
+RPC_E_INVALID_CALLDATA = -2147417844
+RPC_E_CANTCALLOUT_ININPUTSYNCCALL = -2147417843
+RPC_E_WRONG_THREAD = -2147417842
+RPC_E_THREAD_NOT_INIT = -2147417841
+RPC_E_VERSION_MISMATCH = -2147417840
+RPC_E_INVALID_HEADER = -2147417839
+RPC_E_INVALID_EXTENSION = -2147417838
+RPC_E_INVALID_IPID = -2147417837
+RPC_E_INVALID_OBJECT = -2147417836
+RPC_S_CALLPENDING = -2147417835
+RPC_S_WAITONTIMER = -2147417834
+RPC_E_CALL_COMPLETE = -2147417833
+RPC_E_UNSECURE_CALL = -2147417832
+RPC_E_TOO_LATE = -2147417831
+RPC_E_NO_GOOD_SECURITY_PACKAGES = -2147417830
+RPC_E_ACCESS_DENIED = -2147417829
+RPC_E_REMOTE_DISABLED = -2147417828
+RPC_E_INVALID_OBJREF = -2147417827
+RPC_E_NO_CONTEXT = -2147417826
+RPC_E_TIMEOUT = -2147417825
+RPC_E_NO_SYNC = -2147417824
+RPC_E_UNEXPECTED = -2147352577
+NTE_BAD_UID = -2146893823
+NTE_BAD_HASH = -2146893822
+NTE_BAD_KEY = -2146893821
+NTE_BAD_LEN = -2146893820
+NTE_BAD_DATA = -2146893819
+NTE_BAD_SIGNATURE = -2146893818
+NTE_BAD_VER = -2146893817
+NTE_BAD_ALGID = -2146893816
+NTE_BAD_FLAGS = -2146893815
+NTE_BAD_TYPE = -2146893814
+NTE_BAD_KEY_STATE = -2146893813
+NTE_BAD_HASH_STATE = -2146893812
+NTE_NO_KEY = -2146893811
+NTE_NO_MEMORY = -2146893810
+NTE_EXISTS = -2146893809
+NTE_PERM = -2146893808
+NTE_NOT_FOUND = -2146893807
+NTE_DOUBLE_ENCRYPT = -2146893806
+NTE_BAD_PROVIDER = -2146893805
+NTE_BAD_PROV_TYPE = -2146893804
+NTE_BAD_PUBLIC_KEY = -2146893803
+NTE_BAD_KEYSET = -2146893802
+NTE_PROV_TYPE_NOT_DEF = -2146893801
+NTE_PROV_TYPE_ENTRY_BAD = -2146893800
+NTE_KEYSET_NOT_DEF = -2146893799
+NTE_KEYSET_ENTRY_BAD = -2146893798
+NTE_PROV_TYPE_NO_MATCH = -2146893797
+NTE_SIGNATURE_FILE_BAD = -2146893796
+NTE_PROVIDER_DLL_FAIL = -2146893795
+NTE_PROV_DLL_NOT_FOUND = -2146893794
+NTE_BAD_KEYSET_PARAM = -2146893793
+NTE_FAIL = -2146893792
+NTE_SYS_ERR = -2146893791
+CRYPT_E_MSG_ERROR = -2146889727
+CRYPT_E_UNKNOWN_ALGO = -2146889726
+CRYPT_E_OID_FORMAT = -2146889725
+CRYPT_E_INVALID_MSG_TYPE = -2146889724
+CRYPT_E_UNEXPECTED_ENCODING = -2146889723
+CRYPT_E_AUTH_ATTR_MISSING = -2146889722
+CRYPT_E_HASH_VALUE = -2146889721
+CRYPT_E_INVALID_INDEX = -2146889720
+CRYPT_E_ALREADY_DECRYPTED = -2146889719
+CRYPT_E_NOT_DECRYPTED = -2146889718
+CRYPT_E_RECIPIENT_NOT_FOUND = -2146889717
+CRYPT_E_CONTROL_TYPE = -2146889716
+CRYPT_E_ISSUER_SERIALNUMBER = -2146889715
+CRYPT_E_SIGNER_NOT_FOUND = -2146889714
+CRYPT_E_ATTRIBUTES_MISSING = -2146889713
+CRYPT_E_STREAM_MSG_NOT_READY = -2146889712
+CRYPT_E_STREAM_INSUFFICIENT_DATA = -2146889711
+CRYPT_E_BAD_LEN = -2146885631
+CRYPT_E_BAD_ENCODE = -2146885630
+CRYPT_E_FILE_ERROR = -2146885629
+CRYPT_E_NOT_FOUND = -2146885628
+CRYPT_E_EXISTS = -2146885627
+CRYPT_E_NO_PROVIDER = -2146885626
+CRYPT_E_SELF_SIGNED = -2146885625
+CRYPT_E_DELETED_PREV = -2146885624
+CRYPT_E_NO_MATCH = -2146885623
+CRYPT_E_UNEXPECTED_MSG_TYPE = -2146885622
+CRYPT_E_NO_KEY_PROPERTY = -2146885621
+CRYPT_E_NO_DECRYPT_CERT = -2146885620
+CRYPT_E_BAD_MSG = -2146885619
+CRYPT_E_NO_SIGNER = -2146885618
+CRYPT_E_PENDING_CLOSE = -2146885617
+CRYPT_E_REVOKED = -2146885616
+CRYPT_E_NO_REVOCATION_DLL = -2146885615
+CRYPT_E_NO_REVOCATION_CHECK = -2146885614
+CRYPT_E_REVOCATION_OFFLINE = -2146885613
+CRYPT_E_NOT_IN_REVOCATION_DATABASE = -2146885612
+CRYPT_E_INVALID_NUMERIC_STRING = -2146885600
+CRYPT_E_INVALID_PRINTABLE_STRING = -2146885599
+CRYPT_E_INVALID_IA5_STRING = -2146885598
+CRYPT_E_INVALID_X500_STRING = -2146885597
+CRYPT_E_NOT_CHAR_STRING = -2146885596
+CRYPT_E_FILERESIZED = -2146885595
+CRYPT_E_SECURITY_SETTINGS = -2146885594
+CRYPT_E_NO_VERIFY_USAGE_DLL = -2146885593
+CRYPT_E_NO_VERIFY_USAGE_CHECK = -2146885592
+CRYPT_E_VERIFY_USAGE_OFFLINE = -2146885591
+CRYPT_E_NOT_IN_CTL = -2146885590
+CRYPT_E_NO_TRUSTED_SIGNER = -2146885589
+CRYPT_E_OSS_ERROR = -2146881536
+CERTSRV_E_BAD_REQUESTSUBJECT = -2146877439
+CERTSRV_E_NO_REQUEST = -2146877438
+CERTSRV_E_BAD_REQUESTSTATUS = -2146877437
+CERTSRV_E_PROPERTY_EMPTY = -2146877436
+CERTDB_E_JET_ERROR = -2146873344
+TRUST_E_SYSTEM_ERROR = -2146869247
+TRUST_E_NO_SIGNER_CERT = -2146869246
+TRUST_E_COUNTER_SIGNER = -2146869245
+TRUST_E_CERT_SIGNATURE = -2146869244
+TRUST_E_TIME_STAMP = -2146869243
+TRUST_E_BAD_DIGEST = -2146869232
+TRUST_E_BASIC_CONSTRAINTS = -2146869223
+TRUST_E_FINANCIAL_CRITERIA = -2146869218
+NTE_OP_OK = 0
+TRUST_E_PROVIDER_UNKNOWN = -2146762751
+TRUST_E_ACTION_UNKNOWN = -2146762750
+TRUST_E_SUBJECT_FORM_UNKNOWN = -2146762749
+TRUST_E_SUBJECT_NOT_TRUSTED = -2146762748
+DIGSIG_E_ENCODE = -2146762747
+DIGSIG_E_DECODE = -2146762746
+DIGSIG_E_EXTENSIBILITY = -2146762745
+DIGSIG_E_CRYPTO = -2146762744
+PERSIST_E_SIZEDEFINITE = -2146762743
+PERSIST_E_SIZEINDEFINITE = -2146762742
+PERSIST_E_NOTSELFSIZING = -2146762741
+TRUST_E_NOSIGNATURE = -2146762496
+CERT_E_EXPIRED = -2146762495
+CERT_E_VALIDITYPERIODNESTING = -2146762494
+CERT_E_ROLE = -2146762493
+CERT_E_PATHLENCONST = -2146762492
+CERT_E_CRITICAL = -2146762491
+CERT_E_PURPOSE = -2146762490
+CERT_E_ISSUERCHAINING = -2146762489
+CERT_E_MALFORMED = -2146762488
+CERT_E_UNTRUSTEDROOT = -2146762487
+CERT_E_CHAINING = -2146762486
+TRUST_E_FAIL = -2146762485
+CERT_E_REVOKED = -2146762484
+CERT_E_UNTRUSTEDTESTROOT = -2146762483
+CERT_E_REVOCATION_FAILURE = -2146762482
+CERT_E_CN_NO_MATCH = -2146762481
+CERT_E_WRONG_USAGE = -2146762480
+SPAPI_E_EXPECTED_SECTION_NAME = -2146500608
+SPAPI_E_BAD_SECTION_NAME_LINE = -2146500607
+SPAPI_E_SECTION_NAME_TOO_LONG = -2146500606
+SPAPI_E_GENERAL_SYNTAX = -2146500605
+SPAPI_E_WRONG_INF_STYLE = -2146500352
+SPAPI_E_SECTION_NOT_FOUND = -2146500351
+SPAPI_E_LINE_NOT_FOUND = -2146500350
+SPAPI_E_NO_ASSOCIATED_CLASS = -2146500096
+SPAPI_E_CLASS_MISMATCH = -2146500095
+SPAPI_E_DUPLICATE_FOUND = -2146500094
+SPAPI_E_NO_DRIVER_SELECTED = -2146500093
+SPAPI_E_KEY_DOES_NOT_EXIST = -2146500092
+SPAPI_E_INVALID_DEVINST_NAME = -2146500091
+SPAPI_E_INVALID_CLASS = -2146500090
+SPAPI_E_DEVINST_ALREADY_EXISTS = -2146500089
+SPAPI_E_DEVINFO_NOT_REGISTERED = -2146500088
+SPAPI_E_INVALID_REG_PROPERTY = -2146500087
+SPAPI_E_NO_INF = -2146500086
+SPAPI_E_NO_SUCH_DEVINST = -2146500085
+SPAPI_E_CANT_LOAD_CLASS_ICON = -2146500084
+SPAPI_E_INVALID_CLASS_INSTALLER = -2146500083
+SPAPI_E_DI_DO_DEFAULT = -2146500082
+SPAPI_E_DI_NOFILECOPY = -2146500081
+SPAPI_E_INVALID_HWPROFILE = -2146500080
+SPAPI_E_NO_DEVICE_SELECTED = -2146500079
+SPAPI_E_DEVINFO_LIST_LOCKED = -2146500078
+SPAPI_E_DEVINFO_DATA_LOCKED = -2146500077
+SPAPI_E_DI_BAD_PATH = -2146500076
+SPAPI_E_NO_CLASSINSTALL_PARAMS = -2146500075
+SPAPI_E_FILEQUEUE_LOCKED = -2146500074
+SPAPI_E_BAD_SERVICE_INSTALLSECT = -2146500073
+SPAPI_E_NO_CLASS_DRIVER_LIST = -2146500072
+SPAPI_E_NO_ASSOCIATED_SERVICE = -2146500071
+SPAPI_E_NO_DEFAULT_DEVICE_INTERFACE = -2146500070
+SPAPI_E_DEVICE_INTERFACE_ACTIVE = -2146500069
+SPAPI_E_DEVICE_INTERFACE_REMOVED = -2146500068
+SPAPI_E_BAD_INTERFACE_INSTALLSECT = -2146500067
+SPAPI_E_NO_SUCH_INTERFACE_CLASS = -2146500066
+SPAPI_E_INVALID_REFERENCE_STRING = -2146500065
+SPAPI_E_INVALID_MACHINENAME = -2146500064
+SPAPI_E_REMOTE_COMM_FAILURE = -2146500063
+SPAPI_E_MACHINE_UNAVAILABLE = -2146500062
+SPAPI_E_NO_CONFIGMGR_SERVICES = -2146500061
+SPAPI_E_INVALID_PROPPAGE_PROVIDER = -2146500060
+SPAPI_E_NO_SUCH_DEVICE_INTERFACE = -2146500059
+SPAPI_E_DI_POSTPROCESSING_REQUIRED = -2146500058
+SPAPI_E_INVALID_COINSTALLER = -2146500057
+SPAPI_E_NO_COMPAT_DRIVERS = -2146500056
+SPAPI_E_NO_DEVICE_ICON = -2146500055
+SPAPI_E_INVALID_INF_LOGCONFIG = -2146500054
+SPAPI_E_DI_DONT_INSTALL = -2146500053
+SPAPI_E_INVALID_FILTER_DRIVER = -2146500052
+SPAPI_E_ERROR_NOT_INSTALLED = -2146496512
+
+# Directory storage
+ERROR_DS_NOT_INSTALLED = 8200
+ERROR_DS_MEMBERSHIP_EVALUATED_LOCALLY = 8201
+ERROR_DS_NO_ATTRIBUTE_OR_VALUE = 8202
+ERROR_DS_INVALID_ATTRIBUTE_SYNTAX = 8203
+ERROR_DS_ATTRIBUTE_TYPE_UNDEFINED = 8204
+ERROR_DS_ATTRIBUTE_OR_VALUE_EXISTS = 8205
+ERROR_DS_BUSY = 8206
+ERROR_DS_UNAVAILABLE = 8207
+ERROR_DS_NO_RIDS_ALLOCATED = 8208
+ERROR_DS_NO_MORE_RIDS = 8209
+ERROR_DS_INCORRECT_ROLE_OWNER = 8210
+ERROR_DS_RIDMGR_INIT_ERROR = 8211
+ERROR_DS_OBJ_CLASS_VIOLATION = 8212
+ERROR_DS_CANT_ON_NON_LEAF = 8213
+ERROR_DS_CANT_ON_RDN = 8214
+ERROR_DS_CANT_MOD_OBJ_CLASS = 8215
+ERROR_DS_CROSS_DOM_MOVE_ERROR = 8216
+ERROR_DS_GC_NOT_AVAILABLE = 8217
+ERROR_SHARED_POLICY = 8218
+ERROR_POLICY_OBJECT_NOT_FOUND = 8219
+ERROR_POLICY_ONLY_IN_DS = 8220
+ERROR_PROMOTION_ACTIVE = 8221
+ERROR_NO_PROMOTION_ACTIVE = 8222
+ERROR_DS_OPERATIONS_ERROR = 8224
+ERROR_DS_PROTOCOL_ERROR = 8225
+ERROR_DS_TIMELIMIT_EXCEEDED = 8226
+ERROR_DS_SIZELIMIT_EXCEEDED = 8227
+ERROR_DS_ADMIN_LIMIT_EXCEEDED = 8228
+ERROR_DS_COMPARE_FALSE = 8229
+ERROR_DS_COMPARE_TRUE = 8230
+ERROR_DS_AUTH_METHOD_NOT_SUPPORTED = 8231
+ERROR_DS_STRONG_AUTH_REQUIRED = 8232
+ERROR_DS_INAPPROPRIATE_AUTH = 8233
+ERROR_DS_AUTH_UNKNOWN = 8234
+ERROR_DS_REFERRAL = 8235
+ERROR_DS_UNAVAILABLE_CRIT_EXTENSION = 8236
+ERROR_DS_CONFIDENTIALITY_REQUIRED = 8237
+ERROR_DS_INAPPROPRIATE_MATCHING = 8238
+ERROR_DS_CONSTRAINT_VIOLATION = 8239
+ERROR_DS_NO_SUCH_OBJECT = 8240
+ERROR_DS_ALIAS_PROBLEM = 8241
+ERROR_DS_INVALID_DN_SYNTAX = 8242
+ERROR_DS_IS_LEAF = 8243
+ERROR_DS_ALIAS_DEREF_PROBLEM = 8244
+ERROR_DS_UNWILLING_TO_PERFORM = 8245
+ERROR_DS_LOOP_DETECT = 8246
+ERROR_DS_NAMING_VIOLATION = 8247
+ERROR_DS_OBJECT_RESULTS_TOO_LARGE = 8248
+ERROR_DS_AFFECTS_MULTIPLE_DSAS = 8249
+ERROR_DS_SERVER_DOWN = 8250
+ERROR_DS_LOCAL_ERROR = 8251
+ERROR_DS_ENCODING_ERROR = 8252
+ERROR_DS_DECODING_ERROR = 8253
+ERROR_DS_FILTER_UNKNOWN = 8254
+ERROR_DS_PARAM_ERROR = 8255
+ERROR_DS_NOT_SUPPORTED = 8256
+ERROR_DS_NO_RESULTS_RETURNED = 8257
+ERROR_DS_CONTROL_NOT_FOUND = 8258
+ERROR_DS_CLIENT_LOOP = 8259
+ERROR_DS_REFERRAL_LIMIT_EXCEEDED = 8260
+ERROR_DS_SORT_CONTROL_MISSING = 8261
+ERROR_DS_OFFSET_RANGE_ERROR = 8262
+ERROR_DS_ROOT_MUST_BE_NC = 8301
+ERROR_DS_ADD_REPLICA_INHIBITED = 8302
+ERROR_DS_ATT_NOT_DEF_IN_SCHEMA = 8303
+ERROR_DS_MAX_OBJ_SIZE_EXCEEDED = 8304
+ERROR_DS_OBJ_STRING_NAME_EXISTS = 8305
+ERROR_DS_NO_RDN_DEFINED_IN_SCHEMA = 8306
+ERROR_DS_RDN_DOESNT_MATCH_SCHEMA = 8307
+ERROR_DS_NO_REQUESTED_ATTS_FOUND = 8308
+ERROR_DS_USER_BUFFER_TO_SMALL = 8309
+ERROR_DS_ATT_IS_NOT_ON_OBJ = 8310
+ERROR_DS_ILLEGAL_MOD_OPERATION = 8311
+ERROR_DS_OBJ_TOO_LARGE = 8312
+ERROR_DS_BAD_INSTANCE_TYPE = 8313
+ERROR_DS_MASTERDSA_REQUIRED = 8314
+ERROR_DS_OBJECT_CLASS_REQUIRED = 8315
+ERROR_DS_MISSING_REQUIRED_ATT = 8316
+ERROR_DS_ATT_NOT_DEF_FOR_CLASS = 8317
+ERROR_DS_ATT_ALREADY_EXISTS = 8318
+ERROR_DS_CANT_ADD_ATT_VALUES = 8320
+ERROR_DS_SINGLE_VALUE_CONSTRAINT = 8321
+ERROR_DS_RANGE_CONSTRAINT = 8322
+ERROR_DS_ATT_VAL_ALREADY_EXISTS = 8323
+ERROR_DS_CANT_REM_MISSING_ATT = 8324
+ERROR_DS_CANT_REM_MISSING_ATT_VAL = 8325
+ERROR_DS_ROOT_CANT_BE_SUBREF = 8326
+ERROR_DS_NO_CHAINING = 8327
+ERROR_DS_NO_CHAINED_EVAL = 8328
+ERROR_DS_NO_PARENT_OBJECT = 8329
+ERROR_DS_PARENT_IS_AN_ALIAS = 8330
+ERROR_DS_CANT_MIX_MASTER_AND_REPS = 8331
+ERROR_DS_CHILDREN_EXIST = 8332
+ERROR_DS_OBJ_NOT_FOUND = 8333
+ERROR_DS_ALIASED_OBJ_MISSING = 8334
+ERROR_DS_BAD_NAME_SYNTAX = 8335
+ERROR_DS_ALIAS_POINTS_TO_ALIAS = 8336
+ERROR_DS_CANT_DEREF_ALIAS = 8337
+ERROR_DS_OUT_OF_SCOPE = 8338
+ERROR_DS_OBJECT_BEING_REMOVED = 8339
+ERROR_DS_CANT_DELETE_DSA_OBJ = 8340
+ERROR_DS_GENERIC_ERROR = 8341
+ERROR_DS_DSA_MUST_BE_INT_MASTER = 8342
+ERROR_DS_CLASS_NOT_DSA = 8343
+ERROR_DS_INSUFF_ACCESS_RIGHTS = 8344
+ERROR_DS_ILLEGAL_SUPERIOR = 8345
+ERROR_DS_ATTRIBUTE_OWNED_BY_SAM = 8346
+ERROR_DS_NAME_TOO_MANY_PARTS = 8347
+ERROR_DS_NAME_TOO_LONG = 8348
+ERROR_DS_NAME_VALUE_TOO_LONG = 8349
+ERROR_DS_NAME_UNPARSEABLE = 8350
+ERROR_DS_NAME_TYPE_UNKNOWN = 8351
+ERROR_DS_NOT_AN_OBJECT = 8352
+ERROR_DS_SEC_DESC_TOO_SHORT = 8353
+ERROR_DS_SEC_DESC_INVALID = 8354
+ERROR_DS_NO_DELETED_NAME = 8355
+ERROR_DS_SUBREF_MUST_HAVE_PARENT = 8356
+ERROR_DS_NCNAME_MUST_BE_NC = 8357
+ERROR_DS_CANT_ADD_SYSTEM_ONLY = 8358
+ERROR_DS_CLASS_MUST_BE_CONCRETE = 8359
+ERROR_DS_INVALID_DMD = 8360
+ERROR_DS_OBJ_GUID_EXISTS = 8361
+ERROR_DS_NOT_ON_BACKLINK = 8362
+ERROR_DS_NO_CROSSREF_FOR_NC = 8363
+ERROR_DS_SHUTTING_DOWN = 8364
+ERROR_DS_UNKNOWN_OPERATION = 8365
+ERROR_DS_INVALID_ROLE_OWNER = 8366
+ERROR_DS_COULDNT_CONTACT_FSMO = 8367
+ERROR_DS_CROSS_NC_DN_RENAME = 8368
+ERROR_DS_CANT_MOD_SYSTEM_ONLY = 8369
+ERROR_DS_REPLICATOR_ONLY = 8370
+ERROR_DS_OBJ_CLASS_NOT_DEFINED = 8371
+ERROR_DS_OBJ_CLASS_NOT_SUBCLASS = 8372
+ERROR_DS_NAME_REFERENCE_INVALID = 8373
+ERROR_DS_CROSS_REF_EXISTS = 8374
+ERROR_DS_CANT_DEL_MASTER_CROSSREF = 8375
+ERROR_DS_SUBTREE_NOTIFY_NOT_NC_HEAD = 8376
+ERROR_DS_NOTIFY_FILTER_TOO_COMPLEX = 8377
+ERROR_DS_DUP_RDN = 8378
+ERROR_DS_DUP_OID = 8379
+ERROR_DS_DUP_MAPI_ID = 8380
+ERROR_DS_DUP_SCHEMA_ID_GUID = 8381
+ERROR_DS_DUP_LDAP_DISPLAY_NAME = 8382
+ERROR_DS_SEMANTIC_ATT_TEST = 8383
+ERROR_DS_SYNTAX_MISMATCH = 8384
+ERROR_DS_EXISTS_IN_MUST_HAVE = 8385
+ERROR_DS_EXISTS_IN_MAY_HAVE = 8386
+ERROR_DS_NONEXISTENT_MAY_HAVE = 8387
+ERROR_DS_NONEXISTENT_MUST_HAVE = 8388
+ERROR_DS_AUX_CLS_TEST_FAIL = 8389
+ERROR_DS_NONEXISTENT_POSS_SUP = 8390
+ERROR_DS_SUB_CLS_TEST_FAIL = 8391
+ERROR_DS_BAD_RDN_ATT_ID_SYNTAX = 8392
+ERROR_DS_EXISTS_IN_AUX_CLS = 8393
+ERROR_DS_EXISTS_IN_SUB_CLS = 8394
+ERROR_DS_EXISTS_IN_POSS_SUP = 8395
+ERROR_DS_RECALCSCHEMA_FAILED = 8396
+ERROR_DS_TREE_DELETE_NOT_FINISHED = 8397
+ERROR_DS_CANT_DELETE = 8398
+ERROR_DS_ATT_SCHEMA_REQ_ID = 8399
+ERROR_DS_BAD_ATT_SCHEMA_SYNTAX = 8400
+ERROR_DS_CANT_CACHE_ATT = 8401
+ERROR_DS_CANT_CACHE_CLASS = 8402
+ERROR_DS_CANT_REMOVE_ATT_CACHE = 8403
+ERROR_DS_CANT_REMOVE_CLASS_CACHE = 8404
+ERROR_DS_CANT_RETRIEVE_DN = 8405
+ERROR_DS_MISSING_SUPREF = 8406
+ERROR_DS_CANT_RETRIEVE_INSTANCE = 8407
+ERROR_DS_CODE_INCONSISTENCY = 8408
+ERROR_DS_DATABASE_ERROR = 8409
+ERROR_DS_GOVERNSID_MISSING = 8410
+ERROR_DS_MISSING_EXPECTED_ATT = 8411
+ERROR_DS_NCNAME_MISSING_CR_REF = 8412
+ERROR_DS_SECURITY_CHECKING_ERROR = 8413
+ERROR_DS_SCHEMA_NOT_LOADED = 8414
+ERROR_DS_SCHEMA_ALLOC_FAILED = 8415
+ERROR_DS_ATT_SCHEMA_REQ_SYNTAX = 8416
+ERROR_DS_GCVERIFY_ERROR = 8417
+ERROR_DS_DRA_SCHEMA_MISMATCH = 8418
+ERROR_DS_CANT_FIND_DSA_OBJ = 8419
+ERROR_DS_CANT_FIND_EXPECTED_NC = 8420
+ERROR_DS_CANT_FIND_NC_IN_CACHE = 8421
+ERROR_DS_CANT_RETRIEVE_CHILD = 8422
+ERROR_DS_SECURITY_ILLEGAL_MODIFY = 8423
+ERROR_DS_CANT_REPLACE_HIDDEN_REC = 8424
+ERROR_DS_BAD_HIERARCHY_FILE = 8425
+ERROR_DS_BUILD_HIERARCHY_TABLE_FAILED = 8426
+ERROR_DS_CONFIG_PARAM_MISSING = 8427
+ERROR_DS_COUNTING_AB_INDICES_FAILED = 8428
+ERROR_DS_HIERARCHY_TABLE_MALLOC_FAILED = 8429
+ERROR_DS_INTERNAL_FAILURE = 8430
+ERROR_DS_UNKNOWN_ERROR = 8431
+ERROR_DS_ROOT_REQUIRES_CLASS_TOP = 8432
+ERROR_DS_REFUSING_FSMO_ROLES = 8433
+ERROR_DS_MISSING_FSMO_SETTINGS = 8434
+ERROR_DS_UNABLE_TO_SURRENDER_ROLES = 8435
+ERROR_DS_DRA_GENERIC = 8436
+ERROR_DS_DRA_INVALID_PARAMETER = 8437
+ERROR_DS_DRA_BUSY = 8438
+ERROR_DS_DRA_BAD_DN = 8439
+ERROR_DS_DRA_BAD_NC = 8440
+ERROR_DS_DRA_DN_EXISTS = 8441
+ERROR_DS_DRA_INTERNAL_ERROR = 8442
+ERROR_DS_DRA_INCONSISTENT_DIT = 8443
+ERROR_DS_DRA_CONNECTION_FAILED = 8444
+ERROR_DS_DRA_BAD_INSTANCE_TYPE = 8445
+ERROR_DS_DRA_OUT_OF_MEM = 8446
+ERROR_DS_DRA_MAIL_PROBLEM = 8447
+ERROR_DS_DRA_REF_ALREADY_EXISTS = 8448
+ERROR_DS_DRA_REF_NOT_FOUND = 8449
+ERROR_DS_DRA_OBJ_IS_REP_SOURCE = 8450
+ERROR_DS_DRA_DB_ERROR = 8451
+ERROR_DS_DRA_NO_REPLICA = 8452
+ERROR_DS_DRA_ACCESS_DENIED = 8453
+ERROR_DS_DRA_NOT_SUPPORTED = 8454
+ERROR_DS_DRA_RPC_CANCELLED = 8455
+ERROR_DS_DRA_SOURCE_DISABLED = 8456
+ERROR_DS_DRA_SINK_DISABLED = 8457
+ERROR_DS_DRA_NAME_COLLISION = 8458
+ERROR_DS_DRA_SOURCE_REINSTALLED = 8459
+ERROR_DS_DRA_MISSING_PARENT = 8460
+ERROR_DS_DRA_PREEMPTED = 8461
+ERROR_DS_DRA_ABANDON_SYNC = 8462
+ERROR_DS_DRA_SHUTDOWN = 8463
+ERROR_DS_DRA_INCOMPATIBLE_PARTIAL_SET = 8464
+ERROR_DS_DRA_SOURCE_IS_PARTIAL_REPLICA = 8465
+ERROR_DS_DRA_EXTN_CONNECTION_FAILED = 8466
+ERROR_DS_INSTALL_SCHEMA_MISMATCH = 8467
+ERROR_DS_DUP_LINK_ID = 8468
+ERROR_DS_NAME_ERROR_RESOLVING = 8469
+ERROR_DS_NAME_ERROR_NOT_FOUND = 8470
+ERROR_DS_NAME_ERROR_NOT_UNIQUE = 8471
+ERROR_DS_NAME_ERROR_NO_MAPPING = 8472
+ERROR_DS_NAME_ERROR_DOMAIN_ONLY = 8473
+ERROR_DS_NAME_ERROR_NO_SYNTACTICAL_MAPPING = 8474
+ERROR_DS_CONSTRUCTED_ATT_MOD = 8475
+ERROR_DS_WRONG_OM_OBJ_CLASS = 8476
+ERROR_DS_DRA_REPL_PENDING = 8477
+ERROR_DS_DS_REQUIRED = 8478
+ERROR_DS_INVALID_LDAP_DISPLAY_NAME = 8479
+ERROR_DS_NON_BASE_SEARCH = 8480
+ERROR_DS_CANT_RETRIEVE_ATTS = 8481
+ERROR_DS_BACKLINK_WITHOUT_LINK = 8482
+ERROR_DS_EPOCH_MISMATCH = 8483
+ERROR_DS_SRC_NAME_MISMATCH = 8484
+ERROR_DS_SRC_AND_DST_NC_IDENTICAL = 8485
+ERROR_DS_DST_NC_MISMATCH = 8486
+ERROR_DS_NOT_AUTHORITIVE_FOR_DST_NC = 8487
+ERROR_DS_SRC_GUID_MISMATCH = 8488
+ERROR_DS_CANT_MOVE_DELETED_OBJECT = 8489
+ERROR_DS_PDC_OPERATION_IN_PROGRESS = 8490
+ERROR_DS_CROSS_DOMAIN_CLEANUP_REQD = 8491
+ERROR_DS_ILLEGAL_XDOM_MOVE_OPERATION = 8492
+ERROR_DS_CANT_WITH_ACCT_GROUP_MEMBERSHPS = 8493
+ERROR_DS_NC_MUST_HAVE_NC_PARENT = 8494
+ERROR_DS_CR_IMPOSSIBLE_TO_VALIDATE = 8495
+ERROR_DS_DST_DOMAIN_NOT_NATIVE = 8496
+ERROR_DS_MISSING_INFRASTRUCTURE_CONTAINER = 8497
+ERROR_DS_CANT_MOVE_ACCOUNT_GROUP = 8498
+ERROR_DS_CANT_MOVE_RESOURCE_GROUP = 8499
+ERROR_DS_INVALID_SEARCH_FLAG = 8500
+ERROR_DS_NO_TREE_DELETE_ABOVE_NC = 8501
+ERROR_DS_COULDNT_LOCK_TREE_FOR_DELETE = 8502
+ERROR_DS_COULDNT_IDENTIFY_OBJECTS_FOR_TREE_DELETE = 8503
+ERROR_DS_SAM_INIT_FAILURE = 8504
+ERROR_DS_SENSITIVE_GROUP_VIOLATION = 8505
+ERROR_DS_CANT_MOD_PRIMARYGROUPID = 8506
+ERROR_DS_ILLEGAL_BASE_SCHEMA_MOD = 8507
+ERROR_DS_NONSAFE_SCHEMA_CHANGE = 8508
+ERROR_DS_SCHEMA_UPDATE_DISALLOWED = 8509
+ERROR_DS_CANT_CREATE_UNDER_SCHEMA = 8510
+ERROR_DS_INSTALL_NO_SRC_SCH_VERSION = 8511
+ERROR_DS_INSTALL_NO_SCH_VERSION_IN_INIFILE = 8512
+ERROR_DS_INVALID_GROUP_TYPE = 8513
+ERROR_DS_NO_NEST_GLOBALGROUP_IN_MIXEDDOMAIN = 8514
+ERROR_DS_NO_NEST_LOCALGROUP_IN_MIXEDDOMAIN = 8515
+ERROR_DS_GLOBAL_CANT_HAVE_LOCAL_MEMBER = 8516
+ERROR_DS_GLOBAL_CANT_HAVE_UNIVERSAL_MEMBER = 8517
+ERROR_DS_UNIVERSAL_CANT_HAVE_LOCAL_MEMBER = 8518
+ERROR_DS_GLOBAL_CANT_HAVE_CROSSDOMAIN_MEMBER = 8519
+ERROR_DS_LOCAL_CANT_HAVE_CROSSDOMAIN_LOCAL_MEMBER = 8520
+ERROR_DS_HAVE_PRIMARY_MEMBERS = 8521
+ERROR_DS_STRING_SD_CONVERSION_FAILED = 8522
+ERROR_DS_NAMING_MASTER_GC = 8523
+ERROR_DS_DNS_LOOKUP_FAILURE = 8524
+ERROR_DS_COULDNT_UPDATE_SPNS = 8525
+ERROR_DS_CANT_RETRIEVE_SD = 8526
+ERROR_DS_KEY_NOT_UNIQUE = 8527
+ERROR_DS_WRONG_LINKED_ATT_SYNTAX = 8528
+ERROR_DS_SAM_NEED_BOOTKEY_PASSWORD = 8529
+ERROR_DS_SAM_NEED_BOOTKEY_FLOPPY = 8530
+ERROR_DS_CANT_START = 8531
+ERROR_DS_INIT_FAILURE = 8532
+ERROR_DS_NO_PKT_PRIVACY_ON_CONNECTION = 8533
+ERROR_DS_SOURCE_DOMAIN_IN_FOREST = 8534
+ERROR_DS_DESTINATION_DOMAIN_NOT_IN_FOREST = 8535
+ERROR_DS_DESTINATION_AUDITING_NOT_ENABLED = 8536
+ERROR_DS_CANT_FIND_DC_FOR_SRC_DOMAIN = 8537
+ERROR_DS_SRC_OBJ_NOT_GROUP_OR_USER = 8538
+ERROR_DS_SRC_SID_EXISTS_IN_FOREST = 8539
+ERROR_DS_SRC_AND_DST_OBJECT_CLASS_MISMATCH = 8540
+ERROR_SAM_INIT_FAILURE = 8541
+ERROR_DS_DRA_SCHEMA_INFO_SHIP = 8542
+ERROR_DS_DRA_SCHEMA_CONFLICT = 8543
+ERROR_DS_DRA_EARLIER_SCHEMA_CONFLICT = 8544
+ERROR_DS_DRA_OBJ_NC_MISMATCH = 8545
+ERROR_DS_NC_STILL_HAS_DSAS = 8546
+ERROR_DS_GC_REQUIRED = 8547
+ERROR_DS_LOCAL_MEMBER_OF_LOCAL_ONLY = 8548
+ERROR_DS_NO_FPO_IN_UNIVERSAL_GROUPS = 8549
+ERROR_DS_CANT_ADD_TO_GC = 8550
+ERROR_DS_NO_CHECKPOINT_WITH_PDC = 8551
+ERROR_DS_SOURCE_AUDITING_NOT_ENABLED = 8552
+ERROR_DS_CANT_CREATE_IN_NONDOMAIN_NC = 8553
+ERROR_DS_INVALID_NAME_FOR_SPN = 8554
+ERROR_DS_FILTER_USES_CONTRUCTED_ATTRS = 8555
+ERROR_DS_UNICODEPWD_NOT_IN_QUOTES = 8556
+ERROR_DS_MACHINE_ACCOUNT_QUOTA_EXCEEDED = 8557
+ERROR_DS_MUST_BE_RUN_ON_DST_DC = 8558
+ERROR_DS_SRC_DC_MUST_BE_SP4_OR_GREATER = 8559
+ERROR_DS_CANT_TREE_DELETE_CRITICAL_OBJ = 8560
+ERROR_DS_INIT_FAILURE_CONSOLE = 8561
+ERROR_DS_SAM_INIT_FAILURE_CONSOLE = 8562
+ERROR_DS_FOREST_VERSION_TOO_HIGH = 8563
+ERROR_DS_DOMAIN_VERSION_TOO_HIGH = 8564
+ERROR_DS_FOREST_VERSION_TOO_LOW = 8565
+ERROR_DS_DOMAIN_VERSION_TOO_LOW = 8566
+ERROR_DS_INCOMPATIBLE_VERSION = 8567
+ERROR_DS_LOW_DSA_VERSION = 8568
+ERROR_DS_NO_BEHAVIOR_VERSION_IN_MIXEDDOMAIN = 8569
+ERROR_DS_NOT_SUPPORTED_SORT_ORDER = 8570
+ERROR_DS_NAME_NOT_UNIQUE = 8571
+ERROR_DS_MACHINE_ACCOUNT_CREATED_PRENT4 = 8572
+ERROR_DS_OUT_OF_VERSION_STORE = 8573
+ERROR_DS_INCOMPATIBLE_CONTROLS_USED = 8574
+ERROR_DS_NO_REF_DOMAIN = 8575
+ERROR_DS_RESERVED_LINK_ID = 8576
+ERROR_DS_LINK_ID_NOT_AVAILABLE = 8577
+ERROR_DS_AG_CANT_HAVE_UNIVERSAL_MEMBER = 8578
+ERROR_DS_MODIFYDN_DISALLOWED_BY_INSTANCE_TYPE = 8579
+ERROR_DS_NO_OBJECT_MOVE_IN_SCHEMA_NC = 8580
+ERROR_DS_MODIFYDN_DISALLOWED_BY_FLAG = 8581
+ERROR_DS_MODIFYDN_WRONG_GRANDPARENT = 8582
+ERROR_DS_NAME_ERROR_TRUST_REFERRAL = 8583
+ERROR_NOT_SUPPORTED_ON_STANDARD_SERVER = 8584
+ERROR_DS_CANT_ACCESS_REMOTE_PART_OF_AD = 8585
+ERROR_DS_CR_IMPOSSIBLE_TO_VALIDATE_V2 = 8586
+ERROR_DS_THREAD_LIMIT_EXCEEDED = 8587
+ERROR_DS_NOT_CLOSEST = 8588
+ERROR_DS_CANT_DERIVE_SPN_WITHOUT_SERVER_REF = 8589
+ERROR_DS_SINGLE_USER_MODE_FAILED = 8590
+ERROR_DS_NTDSCRIPT_SYNTAX_ERROR = 8591
+ERROR_DS_NTDSCRIPT_PROCESS_ERROR = 8592
+ERROR_DS_DIFFERENT_REPL_EPOCHS = 8593
+ERROR_DS_DRS_EXTENSIONS_CHANGED = 8594
+ERROR_DS_REPLICA_SET_CHANGE_NOT_ALLOWED_ON_DISABLED_CR = 8595
+ERROR_DS_NO_MSDS_INTID = 8596
+ERROR_DS_DUP_MSDS_INTID = 8597
+ERROR_DS_EXISTS_IN_RDNATTID = 8598
+ERROR_DS_AUTHORIZATION_FAILED = 8599
+ERROR_DS_INVALID_SCRIPT = 8600
+ERROR_DS_REMOTE_CROSSREF_OP_FAILED = 8601
+ERROR_DS_CROSS_REF_BUSY = 8602
+ERROR_DS_CANT_DERIVE_SPN_FOR_DELETED_DOMAIN = 8603
+ERROR_DS_CANT_DEMOTE_WITH_WRITEABLE_NC = 8604
+ERROR_DS_DUPLICATE_ID_FOUND = 8605
+ERROR_DS_INSUFFICIENT_ATTR_TO_CREATE_OBJECT = 8606
+ERROR_DS_GROUP_CONVERSION_ERROR = 8607
+ERROR_DS_CANT_MOVE_APP_BASIC_GROUP = 8608
+ERROR_DS_CANT_MOVE_APP_QUERY_GROUP = 8609
+ERROR_DS_ROLE_NOT_VERIFIED = 8610
+ERROR_DS_WKO_CONTAINER_CANNOT_BE_SPECIAL = 8611
+ERROR_DS_DOMAIN_RENAME_IN_PROGRESS = 8612
+ERROR_DS_EXISTING_AD_CHILD_NC = 8613
+ERROR_DS_REPL_LIFETIME_EXCEEDED = 8614
+ERROR_DS_DISALLOWED_IN_SYSTEM_CONTAINER = 8615
+ERROR_DS_LDAP_SEND_QUEUE_FULL = 8616
+ERROR_DS_DRA_OUT_SCHEDULE_WINDOW = 8617
+
+# Common dialog box error codes from cderr.h
+CDERR_DIALOGFAILURE = 65535
+CDERR_GENERALCODES = 0
+CDERR_STRUCTSIZE = 1
+CDERR_INITIALIZATION = 2
+CDERR_NOTEMPLATE = 3
+CDERR_NOHINSTANCE = 4
+CDERR_LOADSTRFAILURE = 5
+CDERR_FINDRESFAILURE = 6
+CDERR_LOADRESFAILURE = 7
+CDERR_LOCKRESFAILURE = 8
+CDERR_MEMALLOCFAILURE = 9
+CDERR_MEMLOCKFAILURE = 10
+CDERR_NOHOOK = 11
+CDERR_REGISTERMSGFAIL = 12
+PDERR_PRINTERCODES = 4096
+PDERR_SETUPFAILURE = 4097
+PDERR_PARSEFAILURE = 4098
+PDERR_RETDEFFAILURE = 4099
+PDERR_LOADDRVFAILURE = 4100
+PDERR_GETDEVMODEFAIL = 4101
+PDERR_INITFAILURE = 4102
+PDERR_NODEVICES = 4103
+PDERR_NODEFAULTPRN = 4104
+PDERR_DNDMMISMATCH = 4105
+PDERR_CREATEICFAILURE = 4106
+PDERR_PRINTERNOTFOUND = 4107
+PDERR_DEFAULTDIFFERENT = 4108
+CFERR_CHOOSEFONTCODES = 8192
+CFERR_NOFONTS = 8193
+CFERR_MAXLESSTHANMIN = 8194
+FNERR_FILENAMECODES = 12288
+FNERR_SUBCLASSFAILURE = 12289
+FNERR_INVALIDFILENAME = 12290
+FNERR_BUFFERTOOSMALL = 12291
+FRERR_FINDREPLACECODES = 16384
+FRERR_BUFFERLENGTHZERO = 16385
+CCERR_CHOOSECOLORCODES = 20480
diff --git a/lib/win32/lib/winioctlcon.py b/lib/win32/lib/winioctlcon.py
new file mode 100644
index 00000000..5c555947
--- /dev/null
+++ b/lib/win32/lib/winioctlcon.py
@@ -0,0 +1,1079 @@
+## flags, enums, guids used with DeviceIoControl from WinIoCtl.h
+
+import pywintypes
+from ntsecuritycon import FILE_READ_DATA, FILE_WRITE_DATA
+
+
+def CTL_CODE(DeviceType, Function, Method, Access):
+    return (DeviceType << 16) | (Access << 14) | (Function << 2) | Method
+
+
+def DEVICE_TYPE_FROM_CTL_CODE(ctrlCode):
+    return (ctrlCode & 0xFFFF0000) >> 16
+
+
+FILE_DEVICE_BEEP = 0x00000001
+FILE_DEVICE_CD_ROM = 0x00000002
+FILE_DEVICE_CD_ROM_FILE_SYSTEM = 0x00000003
+FILE_DEVICE_CONTROLLER = 0x00000004
+FILE_DEVICE_DATALINK = 0x00000005
+FILE_DEVICE_DFS = 0x00000006
+FILE_DEVICE_DISK = 0x00000007
+FILE_DEVICE_DISK_FILE_SYSTEM = 0x00000008
+FILE_DEVICE_FILE_SYSTEM = 0x00000009
+FILE_DEVICE_INPORT_PORT = 0x0000000A
+FILE_DEVICE_KEYBOARD = 0x0000000B
+FILE_DEVICE_MAILSLOT = 0x0000000C
+FILE_DEVICE_MIDI_IN = 0x0000000D
+FILE_DEVICE_MIDI_OUT = 0x0000000E
+FILE_DEVICE_MOUSE = 0x0000000F
+FILE_DEVICE_MULTI_UNC_PROVIDER = 0x00000010
+FILE_DEVICE_NAMED_PIPE = 0x00000011
+FILE_DEVICE_NETWORK = 0x00000012
+FILE_DEVICE_NETWORK_BROWSER = 0x00000013
+FILE_DEVICE_NETWORK_FILE_SYSTEM = 0x00000014
+FILE_DEVICE_NULL = 0x00000015
+FILE_DEVICE_PARALLEL_PORT = 0x00000016
+FILE_DEVICE_PHYSICAL_NETCARD = 0x00000017
+FILE_DEVICE_PRINTER = 0x00000018
+FILE_DEVICE_SCANNER = 0x00000019
+FILE_DEVICE_SERIAL_MOUSE_PORT = 0x0000001A
+FILE_DEVICE_SERIAL_PORT = 0x0000001B
+FILE_DEVICE_SCREEN = 0x0000001C
+FILE_DEVICE_SOUND = 0x0000001D
+FILE_DEVICE_STREAMS = 0x0000001E
+FILE_DEVICE_TAPE = 0x0000001F
+FILE_DEVICE_TAPE_FILE_SYSTEM = 0x00000020
+FILE_DEVICE_TRANSPORT = 0x00000021
+FILE_DEVICE_UNKNOWN = 0x00000022
+FILE_DEVICE_VIDEO = 0x00000023
+FILE_DEVICE_VIRTUAL_DISK = 0x00000024
+FILE_DEVICE_WAVE_IN = 0x00000025
+FILE_DEVICE_WAVE_OUT = 0x00000026
+FILE_DEVICE_8042_PORT = 0x00000027
+FILE_DEVICE_NETWORK_REDIRECTOR = 0x00000028
+FILE_DEVICE_BATTERY = 0x00000029
+FILE_DEVICE_BUS_EXTENDER = 0x0000002A
+FILE_DEVICE_MODEM = 0x0000002B
+FILE_DEVICE_VDM = 0x0000002C
+FILE_DEVICE_MASS_STORAGE = 0x0000002D
+FILE_DEVICE_SMB = 0x0000002E
+FILE_DEVICE_KS = 0x0000002F
+FILE_DEVICE_CHANGER = 0x00000030
+FILE_DEVICE_SMARTCARD = 0x00000031
+FILE_DEVICE_ACPI = 0x00000032
+FILE_DEVICE_DVD = 0x00000033
+FILE_DEVICE_FULLSCREEN_VIDEO = 0x00000034
+FILE_DEVICE_DFS_FILE_SYSTEM = 0x00000035
+FILE_DEVICE_DFS_VOLUME = 0x00000036
+FILE_DEVICE_SERENUM = 0x00000037
+FILE_DEVICE_TERMSRV = 0x00000038
+FILE_DEVICE_KSEC = 0x00000039
+FILE_DEVICE_FIPS = 0x0000003A
+FILE_DEVICE_INFINIBAND = 0x0000003B
+
+METHOD_BUFFERED = 0
+METHOD_IN_DIRECT = 1
+METHOD_OUT_DIRECT = 2
+METHOD_NEITHER = 3
+METHOD_DIRECT_TO_HARDWARE = METHOD_IN_DIRECT
+METHOD_DIRECT_FROM_HARDWARE = METHOD_OUT_DIRECT
+FILE_ANY_ACCESS = 0
+FILE_SPECIAL_ACCESS = FILE_ANY_ACCESS
+FILE_READ_ACCESS = 0x0001
+FILE_WRITE_ACCESS = 0x0002
+IOCTL_STORAGE_BASE = FILE_DEVICE_MASS_STORAGE
+RECOVERED_WRITES_VALID = 0x00000001
+UNRECOVERED_WRITES_VALID = 0x00000002
+RECOVERED_READS_VALID = 0x00000004
+UNRECOVERED_READS_VALID = 0x00000008
+WRITE_COMPRESSION_INFO_VALID = 0x00000010
+READ_COMPRESSION_INFO_VALID = 0x00000020
+TAPE_RETURN_STATISTICS = 0
+TAPE_RETURN_ENV_INFO = 1
+TAPE_RESET_STATISTICS = 2
+MEDIA_ERASEABLE = 0x00000001
+MEDIA_WRITE_ONCE = 0x00000002
+MEDIA_READ_ONLY = 0x00000004
+MEDIA_READ_WRITE = 0x00000008
+MEDIA_WRITE_PROTECTED = 0x00000100
+MEDIA_CURRENTLY_MOUNTED = 0x80000000
+IOCTL_DISK_BASE = FILE_DEVICE_DISK
+PARTITION_ENTRY_UNUSED = 0x00
+PARTITION_FAT_12 = 0x01
+PARTITION_XENIX_1 = 0x02
+PARTITION_XENIX_2 = 0x03
+PARTITION_FAT_16 = 0x04
+PARTITION_EXTENDED = 0x05
+PARTITION_HUGE = 0x06
+PARTITION_IFS = 0x07
+PARTITION_OS2BOOTMGR = 0x0A
+PARTITION_FAT32 = 0x0B
+PARTITION_FAT32_XINT13 = 0x0C
+PARTITION_XINT13 = 0x0E
+PARTITION_XINT13_EXTENDED = 0x0F
+PARTITION_PREP = 0x41
+PARTITION_LDM = 0x42
+PARTITION_UNIX = 0x63
+VALID_NTFT = 0xC0
+PARTITION_NTFT = 0x80
+
+GPT_ATTRIBUTE_PLATFORM_REQUIRED = 0x0000000000000001
+GPT_BASIC_DATA_ATTRIBUTE_NO_DRIVE_LETTER = 0x8000000000000000
+GPT_BASIC_DATA_ATTRIBUTE_HIDDEN = 0x4000000000000000
+GPT_BASIC_DATA_ATTRIBUTE_SHADOW_COPY = 0x2000000000000000
+GPT_BASIC_DATA_ATTRIBUTE_READ_ONLY = 0x1000000000000000
+
+HIST_NO_OF_BUCKETS = 24
+DISK_LOGGING_START = 0
+DISK_LOGGING_STOP = 1
+DISK_LOGGING_DUMP = 2
+DISK_BINNING = 3
+CAP_ATA_ID_CMD = 1
+CAP_ATAPI_ID_CMD = 2
+CAP_SMART_CMD = 4
+ATAPI_ID_CMD = 0xA1
+ID_CMD = 0xEC
+SMART_CMD = 0xB0
+SMART_CYL_LOW = 0x4F
+SMART_CYL_HI = 0xC2
+SMART_NO_ERROR = 0
+SMART_IDE_ERROR = 1
+SMART_INVALID_FLAG = 2
+SMART_INVALID_COMMAND = 3
+SMART_INVALID_BUFFER = 4
+SMART_INVALID_DRIVE = 5
+SMART_INVALID_IOCTL = 6
+SMART_ERROR_NO_MEM = 7
+SMART_INVALID_REGISTER = 8
+SMART_NOT_SUPPORTED = 9
+SMART_NO_IDE_DEVICE = 10
+SMART_OFFLINE_ROUTINE_OFFLINE = 0
+SMART_SHORT_SELFTEST_OFFLINE = 1
+SMART_EXTENDED_SELFTEST_OFFLINE = 2
+SMART_ABORT_OFFLINE_SELFTEST = 127
+SMART_SHORT_SELFTEST_CAPTIVE = 129
+SMART_EXTENDED_SELFTEST_CAPTIVE = 130
+READ_ATTRIBUTE_BUFFER_SIZE = 512
+IDENTIFY_BUFFER_SIZE = 512
+READ_THRESHOLD_BUFFER_SIZE = 512
+SMART_LOG_SECTOR_SIZE = 512
+READ_ATTRIBUTES = 0xD0
+READ_THRESHOLDS = 0xD1
+ENABLE_DISABLE_AUTOSAVE = 0xD2
+SAVE_ATTRIBUTE_VALUES = 0xD3
+EXECUTE_OFFLINE_DIAGS = 0xD4
+SMART_READ_LOG = 0xD5
+SMART_WRITE_LOG = 0xD6
+ENABLE_SMART = 0xD8
+DISABLE_SMART = 0xD9
+RETURN_SMART_STATUS = 0xDA
+ENABLE_DISABLE_AUTO_OFFLINE = 0xDB
+IOCTL_CHANGER_BASE = FILE_DEVICE_CHANGER
+MAX_VOLUME_ID_SIZE = 36
+MAX_VOLUME_TEMPLATE_SIZE = 40
+VENDOR_ID_LENGTH = 8
+PRODUCT_ID_LENGTH = 16
+REVISION_LENGTH = 4
+SERIAL_NUMBER_LENGTH = 32
+CHANGER_BAR_CODE_SCANNER_INSTALLED = 0x00000001
+CHANGER_INIT_ELEM_STAT_WITH_RANGE = 0x00000002
+CHANGER_CLOSE_IEPORT = 0x00000004
+CHANGER_OPEN_IEPORT = 0x00000008
+CHANGER_STATUS_NON_VOLATILE = 0x00000010
+CHANGER_EXCHANGE_MEDIA = 0x00000020
+CHANGER_CLEANER_SLOT = 0x00000040
+CHANGER_LOCK_UNLOCK = 0x00000080
+CHANGER_CARTRIDGE_MAGAZINE = 0x00000100
+CHANGER_MEDIUM_FLIP = 0x00000200
+CHANGER_POSITION_TO_ELEMENT = 0x00000400
+CHANGER_REPORT_IEPORT_STATE = 0x00000800
+CHANGER_STORAGE_DRIVE = 0x00001000
+CHANGER_STORAGE_IEPORT = 0x00002000
+CHANGER_STORAGE_SLOT = 0x00004000
+CHANGER_STORAGE_TRANSPORT = 0x00008000
+CHANGER_DRIVE_CLEANING_REQUIRED = 0x00010000
+CHANGER_PREDISMOUNT_EJECT_REQUIRED = 0x00020000
+CHANGER_CLEANER_ACCESS_NOT_VALID = 0x00040000
+CHANGER_PREMOUNT_EJECT_REQUIRED = 0x00080000
+CHANGER_VOLUME_IDENTIFICATION = 0x00100000
+CHANGER_VOLUME_SEARCH = 0x00200000
+CHANGER_VOLUME_ASSERT = 0x00400000
+CHANGER_VOLUME_REPLACE = 0x00800000
+CHANGER_VOLUME_UNDEFINE = 0x01000000
+CHANGER_SERIAL_NUMBER_VALID = 0x04000000
+CHANGER_DEVICE_REINITIALIZE_CAPABLE = 0x08000000
+CHANGER_KEYPAD_ENABLE_DISABLE = 0x10000000
+CHANGER_DRIVE_EMPTY_ON_DOOR_ACCESS = 0x20000000
+
+CHANGER_RESERVED_BIT = 0x80000000
+CHANGER_PREDISMOUNT_ALIGN_TO_SLOT = 0x80000001
+CHANGER_PREDISMOUNT_ALIGN_TO_DRIVE = 0x80000002
+CHANGER_CLEANER_AUTODISMOUNT = 0x80000004
+CHANGER_TRUE_EXCHANGE_CAPABLE = 0x80000008
+CHANGER_SLOTS_USE_TRAYS = 0x80000010
+CHANGER_RTN_MEDIA_TO_ORIGINAL_ADDR = 0x80000020
+CHANGER_CLEANER_OPS_NOT_SUPPORTED = 0x80000040
+CHANGER_IEPORT_USER_CONTROL_OPEN = 0x80000080
+CHANGER_IEPORT_USER_CONTROL_CLOSE = 0x80000100
+CHANGER_MOVE_EXTENDS_IEPORT = 0x80000200
+CHANGER_MOVE_RETRACTS_IEPORT = 0x80000400
+
+
+CHANGER_TO_TRANSPORT = 0x01
+CHANGER_TO_SLOT = 0x02
+CHANGER_TO_IEPORT = 0x04
+CHANGER_TO_DRIVE = 0x08
+LOCK_UNLOCK_IEPORT = 0x01
+LOCK_UNLOCK_DOOR = 0x02
+LOCK_UNLOCK_KEYPAD = 0x04
+LOCK_ELEMENT = 0
+UNLOCK_ELEMENT = 1
+EXTEND_IEPORT = 2
+RETRACT_IEPORT = 3
+ELEMENT_STATUS_FULL = 0x00000001
+ELEMENT_STATUS_IMPEXP = 0x00000002
+ELEMENT_STATUS_EXCEPT = 0x00000004
+ELEMENT_STATUS_ACCESS = 0x00000008
+ELEMENT_STATUS_EXENAB = 0x00000010
+ELEMENT_STATUS_INENAB = 0x00000020
+ELEMENT_STATUS_PRODUCT_DATA = 0x00000040
+ELEMENT_STATUS_LUN_VALID = 0x00001000
+ELEMENT_STATUS_ID_VALID = 0x00002000
+ELEMENT_STATUS_NOT_BUS = 0x00008000
+ELEMENT_STATUS_INVERT = 0x00400000
+ELEMENT_STATUS_SVALID = 0x00800000
+ELEMENT_STATUS_PVOLTAG = 0x10000000
+ELEMENT_STATUS_AVOLTAG = 0x20000000
+ERROR_LABEL_UNREADABLE = 0x00000001
+ERROR_LABEL_QUESTIONABLE = 0x00000002
+ERROR_SLOT_NOT_PRESENT = 0x00000004
+ERROR_DRIVE_NOT_INSTALLED = 0x00000008
+ERROR_TRAY_MALFUNCTION = 0x00000010
+ERROR_INIT_STATUS_NEEDED = 0x00000011
+ERROR_UNHANDLED_ERROR = 0xFFFFFFFF
+SEARCH_ALL = 0x0
+SEARCH_PRIMARY = 0x1
+SEARCH_ALTERNATE = 0x2
+SEARCH_ALL_NO_SEQ = 0x4
+SEARCH_PRI_NO_SEQ = 0x5
+SEARCH_ALT_NO_SEQ = 0x6
+ASSERT_PRIMARY = 0x8
+ASSERT_ALTERNATE = 0x9
+REPLACE_PRIMARY = 0xA
+REPLACE_ALTERNATE = 0xB
+UNDEFINE_PRIMARY = 0xC
+UNDEFINE_ALTERNATE = 0xD
+USN_PAGE_SIZE = 0x1000
+USN_REASON_DATA_OVERWRITE = 0x00000001
+USN_REASON_DATA_EXTEND = 0x00000002
+USN_REASON_DATA_TRUNCATION = 0x00000004
+USN_REASON_NAMED_DATA_OVERWRITE = 0x00000010
+USN_REASON_NAMED_DATA_EXTEND = 0x00000020
+USN_REASON_NAMED_DATA_TRUNCATION = 0x00000040
+USN_REASON_FILE_CREATE = 0x00000100
+USN_REASON_FILE_DELETE = 0x00000200
+USN_REASON_EA_CHANGE = 0x00000400
+USN_REASON_SECURITY_CHANGE = 0x00000800
+USN_REASON_RENAME_OLD_NAME = 0x00001000
+USN_REASON_RENAME_NEW_NAME = 0x00002000
+USN_REASON_INDEXABLE_CHANGE = 0x00004000
+USN_REASON_BASIC_INFO_CHANGE = 0x00008000
+USN_REASON_HARD_LINK_CHANGE = 0x00010000
+USN_REASON_COMPRESSION_CHANGE = 0x00020000
+USN_REASON_ENCRYPTION_CHANGE = 0x00040000
+USN_REASON_OBJECT_ID_CHANGE = 0x00080000
+USN_REASON_REPARSE_POINT_CHANGE = 0x00100000
+USN_REASON_STREAM_CHANGE = 0x00200000
+USN_REASON_TRANSACTED_CHANGE = 0x00400000
+USN_REASON_CLOSE = 0x80000000
+USN_DELETE_FLAG_DELETE = 0x00000001
+USN_DELETE_FLAG_NOTIFY = 0x00000002
+USN_DELETE_VALID_FLAGS = 0x00000003
+USN_SOURCE_DATA_MANAGEMENT = 0x00000001
+USN_SOURCE_AUXILIARY_DATA = 0x00000002
+USN_SOURCE_REPLICATION_MANAGEMENT = 0x00000004
+
+MARK_HANDLE_PROTECT_CLUSTERS = 1
+MARK_HANDLE_TXF_SYSTEM_LOG = 4
+MARK_HANDLE_NOT_TXF_SYSTEM_LOG = 8
+
+VOLUME_IS_DIRTY = 0x00000001
+VOLUME_UPGRADE_SCHEDULED = 0x00000002
+VOLUME_SESSION_OPEN = 4
+
+FILE_PREFETCH_TYPE_FOR_CREATE = 1
+FILE_PREFETCH_TYPE_FOR_DIRENUM = 2
+FILE_PREFETCH_TYPE_FOR_CREATE_EX = 3
+FILE_PREFETCH_TYPE_FOR_DIRENUM_EX = 4
+FILE_PREFETCH_TYPE_MAX = 4
+
+FILESYSTEM_STATISTICS_TYPE_NTFS = 1
+FILESYSTEM_STATISTICS_TYPE_FAT = 2
+FILE_SET_ENCRYPTION = 0x00000001
+FILE_CLEAR_ENCRYPTION = 0x00000002
+STREAM_SET_ENCRYPTION = 0x00000003
+STREAM_CLEAR_ENCRYPTION = 0x00000004
+MAXIMUM_ENCRYPTION_VALUE = 0x00000004
+ENCRYPTION_FORMAT_DEFAULT = 0x01
+COMPRESSION_FORMAT_SPARSE = 0x4000
+COPYFILE_SIS_LINK = 0x0001
+COPYFILE_SIS_REPLACE = 0x0002
+COPYFILE_SIS_FLAGS = 0x0003
+
+WMI_DISK_GEOMETRY_GUID = pywintypes.IID("{25007F51-57C2-11D1-A528-00A0C9062910}")
+GUID_DEVINTERFACE_CDROM = pywintypes.IID("{53F56308-B6BF-11D0-94F2-00A0C91EFB8B}")
+GUID_DEVINTERFACE_FLOPPY = pywintypes.IID("{53F56311-B6BF-11D0-94F2-00A0C91EFB8B}")
+GUID_DEVINTERFACE_SERENUM_BUS_ENUMERATOR = pywintypes.IID(
+    "{4D36E978-E325-11CE-BFC1-08002BE10318}"
+)
+GUID_DEVINTERFACE_COMPORT = pywintypes.IID("{86E0D1E0-8089-11D0-9CE4-08003E301F73}")
+GUID_DEVINTERFACE_DISK = pywintypes.IID("{53F56307-B6BF-11D0-94F2-00A0C91EFB8B}")
+GUID_DEVINTERFACE_STORAGEPORT = pywintypes.IID("{2ACCFE60-C130-11D2-B082-00A0C91EFB8B}")
+GUID_DEVINTERFACE_CDCHANGER = pywintypes.IID("{53F56312-B6BF-11D0-94F2-00A0C91EFB8B}")
+GUID_DEVINTERFACE_PARTITION = pywintypes.IID("{53F5630A-B6BF-11D0-94F2-00A0C91EFB8B}")
+GUID_DEVINTERFACE_VOLUME = pywintypes.IID("{53F5630D-B6BF-11D0-94F2-00A0C91EFB8B}")
+GUID_DEVINTERFACE_WRITEONCEDISK = pywintypes.IID(
+    "{53F5630C-B6BF-11D0-94F2-00A0C91EFB8B}"
+)
+GUID_DEVINTERFACE_TAPE = pywintypes.IID("{53F5630B-B6BF-11D0-94F2-00A0C91EFB8B}")
+GUID_DEVINTERFACE_MEDIUMCHANGER = pywintypes.IID(
+    "{53F56310-B6BF-11D0-94F2-00A0C91EFB8B}"
+)
+GUID_SERENUM_BUS_ENUMERATOR = GUID_DEVINTERFACE_SERENUM_BUS_ENUMERATOR
+GUID_CLASS_COMPORT = GUID_DEVINTERFACE_COMPORT
+
+DiskClassGuid = GUID_DEVINTERFACE_DISK
+CdRomClassGuid = GUID_DEVINTERFACE_CDROM
+PartitionClassGuid = GUID_DEVINTERFACE_PARTITION
+TapeClassGuid = GUID_DEVINTERFACE_TAPE
+WriteOnceDiskClassGuid = GUID_DEVINTERFACE_WRITEONCEDISK
+VolumeClassGuid = GUID_DEVINTERFACE_VOLUME
+MediumChangerClassGuid = GUID_DEVINTERFACE_MEDIUMCHANGER
+FloppyClassGuid = GUID_DEVINTERFACE_FLOPPY
+CdChangerClassGuid = GUID_DEVINTERFACE_CDCHANGER
+StoragePortClassGuid = GUID_DEVINTERFACE_STORAGEPORT
+
+
+IOCTL_STORAGE_CHECK_VERIFY = CTL_CODE(
+    IOCTL_STORAGE_BASE, 0x0200, METHOD_BUFFERED, FILE_READ_ACCESS
+)
+IOCTL_STORAGE_CHECK_VERIFY2 = CTL_CODE(
+    IOCTL_STORAGE_BASE, 0x0200, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+IOCTL_STORAGE_MEDIA_REMOVAL = CTL_CODE(
+    IOCTL_STORAGE_BASE, 0x0201, METHOD_BUFFERED, FILE_READ_ACCESS
+)
+IOCTL_STORAGE_EJECT_MEDIA = CTL_CODE(
+    IOCTL_STORAGE_BASE, 0x0202, METHOD_BUFFERED, FILE_READ_ACCESS
+)
+IOCTL_STORAGE_LOAD_MEDIA = CTL_CODE(
+    IOCTL_STORAGE_BASE, 0x0203, METHOD_BUFFERED, FILE_READ_ACCESS
+)
+IOCTL_STORAGE_LOAD_MEDIA2 = CTL_CODE(
+    IOCTL_STORAGE_BASE, 0x0203, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+IOCTL_STORAGE_RESERVE = CTL_CODE(
+    IOCTL_STORAGE_BASE, 0x0204, METHOD_BUFFERED, FILE_READ_ACCESS
+)
+IOCTL_STORAGE_RELEASE = CTL_CODE(
+    IOCTL_STORAGE_BASE, 0x0205, METHOD_BUFFERED, FILE_READ_ACCESS
+)
+IOCTL_STORAGE_FIND_NEW_DEVICES = CTL_CODE(
+    IOCTL_STORAGE_BASE, 0x0206, METHOD_BUFFERED, FILE_READ_ACCESS
+)
+IOCTL_STORAGE_EJECTION_CONTROL = CTL_CODE(
+    IOCTL_STORAGE_BASE, 0x0250, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+IOCTL_STORAGE_MCN_CONTROL = CTL_CODE(
+    IOCTL_STORAGE_BASE, 0x0251, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+IOCTL_STORAGE_GET_MEDIA_TYPES = CTL_CODE(
+    IOCTL_STORAGE_BASE, 0x0300, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+IOCTL_STORAGE_GET_MEDIA_TYPES_EX = CTL_CODE(
+    IOCTL_STORAGE_BASE, 0x0301, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+IOCTL_STORAGE_GET_MEDIA_SERIAL_NUMBER = CTL_CODE(
+    IOCTL_STORAGE_BASE, 0x0304, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+IOCTL_STORAGE_GET_HOTPLUG_INFO = CTL_CODE(
+    IOCTL_STORAGE_BASE, 0x0305, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+IOCTL_STORAGE_SET_HOTPLUG_INFO = CTL_CODE(
+    IOCTL_STORAGE_BASE, 0x0306, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS
+)
+IOCTL_STORAGE_RESET_BUS = CTL_CODE(
+    IOCTL_STORAGE_BASE, 0x0400, METHOD_BUFFERED, FILE_READ_ACCESS
+)
+IOCTL_STORAGE_RESET_DEVICE = CTL_CODE(
+    IOCTL_STORAGE_BASE, 0x0401, METHOD_BUFFERED, FILE_READ_ACCESS
+)
+IOCTL_STORAGE_BREAK_RESERVATION = CTL_CODE(
+    IOCTL_STORAGE_BASE, 0x0405, METHOD_BUFFERED, FILE_READ_ACCESS
+)
+IOCTL_STORAGE_GET_DEVICE_NUMBER = CTL_CODE(
+    IOCTL_STORAGE_BASE, 0x0420, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+IOCTL_STORAGE_PREDICT_FAILURE = CTL_CODE(
+    IOCTL_STORAGE_BASE, 0x0440, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+IOCTL_DISK_GET_DRIVE_GEOMETRY = CTL_CODE(
+    IOCTL_DISK_BASE, 0x0000, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+IOCTL_DISK_GET_PARTITION_INFO = CTL_CODE(
+    IOCTL_DISK_BASE, 0x0001, METHOD_BUFFERED, FILE_READ_ACCESS
+)
+IOCTL_DISK_SET_PARTITION_INFO = CTL_CODE(
+    IOCTL_DISK_BASE, 0x0002, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS
+)
+IOCTL_DISK_GET_DRIVE_LAYOUT = CTL_CODE(
+    IOCTL_DISK_BASE, 0x0003, METHOD_BUFFERED, FILE_READ_ACCESS
+)
+IOCTL_DISK_SET_DRIVE_LAYOUT = CTL_CODE(
+    IOCTL_DISK_BASE, 0x0004, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS
+)
+IOCTL_DISK_VERIFY = CTL_CODE(IOCTL_DISK_BASE, 0x0005, METHOD_BUFFERED, FILE_ANY_ACCESS)
+IOCTL_DISK_FORMAT_TRACKS = CTL_CODE(
+    IOCTL_DISK_BASE, 0x0006, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS
+)
+IOCTL_DISK_REASSIGN_BLOCKS = CTL_CODE(
+    IOCTL_DISK_BASE, 0x0007, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS
+)
+IOCTL_DISK_PERFORMANCE = CTL_CODE(
+    IOCTL_DISK_BASE, 0x0008, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+IOCTL_DISK_IS_WRITABLE = CTL_CODE(
+    IOCTL_DISK_BASE, 0x0009, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+IOCTL_DISK_LOGGING = CTL_CODE(IOCTL_DISK_BASE, 0x000A, METHOD_BUFFERED, FILE_ANY_ACCESS)
+IOCTL_DISK_FORMAT_TRACKS_EX = CTL_CODE(
+    IOCTL_DISK_BASE, 0x000B, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS
+)
+IOCTL_DISK_HISTOGRAM_STRUCTURE = CTL_CODE(
+    IOCTL_DISK_BASE, 0x000C, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+IOCTL_DISK_HISTOGRAM_DATA = CTL_CODE(
+    IOCTL_DISK_BASE, 0x000D, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+IOCTL_DISK_HISTOGRAM_RESET = CTL_CODE(
+    IOCTL_DISK_BASE, 0x000E, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+IOCTL_DISK_REQUEST_STRUCTURE = CTL_CODE(
+    IOCTL_DISK_BASE, 0x000F, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+IOCTL_DISK_REQUEST_DATA = CTL_CODE(
+    IOCTL_DISK_BASE, 0x0010, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+IOCTL_DISK_PERFORMANCE_OFF = CTL_CODE(
+    IOCTL_DISK_BASE, 0x0018, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+IOCTL_DISK_CONTROLLER_NUMBER = CTL_CODE(
+    IOCTL_DISK_BASE, 0x0011, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+SMART_GET_VERSION = CTL_CODE(IOCTL_DISK_BASE, 0x0020, METHOD_BUFFERED, FILE_READ_ACCESS)
+SMART_SEND_DRIVE_COMMAND = CTL_CODE(
+    IOCTL_DISK_BASE, 0x0021, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS
+)
+SMART_RCV_DRIVE_DATA = CTL_CODE(
+    IOCTL_DISK_BASE, 0x0022, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS
+)
+IOCTL_DISK_GET_PARTITION_INFO_EX = CTL_CODE(
+    IOCTL_DISK_BASE, 0x0012, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+IOCTL_DISK_SET_PARTITION_INFO_EX = CTL_CODE(
+    IOCTL_DISK_BASE, 0x0013, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS
+)
+IOCTL_DISK_GET_DRIVE_LAYOUT_EX = CTL_CODE(
+    IOCTL_DISK_BASE, 0x0014, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+IOCTL_DISK_SET_DRIVE_LAYOUT_EX = CTL_CODE(
+    IOCTL_DISK_BASE, 0x0015, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS
+)
+IOCTL_DISK_CREATE_DISK = CTL_CODE(
+    IOCTL_DISK_BASE, 0x0016, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS
+)
+IOCTL_DISK_GET_LENGTH_INFO = CTL_CODE(
+    IOCTL_DISK_BASE, 0x0017, METHOD_BUFFERED, FILE_READ_ACCESS
+)
+IOCTL_DISK_GET_DRIVE_GEOMETRY_EX = CTL_CODE(
+    IOCTL_DISK_BASE, 0x0028, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+IOCTL_DISK_REASSIGN_BLOCKS_EX = CTL_CODE(
+    IOCTL_DISK_BASE, 0x0029, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS
+)
+
+IOCTL_DISK_UPDATE_DRIVE_SIZE = CTL_CODE(
+    IOCTL_DISK_BASE, 0x0032, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS
+)
+IOCTL_DISK_GROW_PARTITION = CTL_CODE(
+    IOCTL_DISK_BASE, 0x0034, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS
+)
+IOCTL_DISK_GET_CACHE_INFORMATION = CTL_CODE(
+    IOCTL_DISK_BASE, 0x0035, METHOD_BUFFERED, FILE_READ_ACCESS
+)
+IOCTL_DISK_SET_CACHE_INFORMATION = CTL_CODE(
+    IOCTL_DISK_BASE, 0x0036, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS
+)
+
+OBSOLETE_IOCTL_STORAGE_RESET_BUS = CTL_CODE(
+    IOCTL_STORAGE_BASE, 0x0400, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS
+)
+OBSOLETE_IOCTL_STORAGE_RESET_DEVICE = CTL_CODE(
+    IOCTL_STORAGE_BASE, 0x0401, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS
+)
+## the original define no longer exists in winioctl.h
+OBSOLETE_DISK_GET_WRITE_CACHE_STATE = CTL_CODE(
+    IOCTL_DISK_BASE, 0x0037, METHOD_BUFFERED, FILE_READ_ACCESS
+)
+IOCTL_DISK_GET_WRITE_CACHE_STATE = OBSOLETE_DISK_GET_WRITE_CACHE_STATE
+
+
+IOCTL_DISK_DELETE_DRIVE_LAYOUT = CTL_CODE(
+    IOCTL_DISK_BASE, 0x0040, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS
+)
+IOCTL_DISK_UPDATE_PROPERTIES = CTL_CODE(
+    IOCTL_DISK_BASE, 0x0050, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+IOCTL_DISK_FORMAT_DRIVE = CTL_CODE(
+    IOCTL_DISK_BASE, 0x00F3, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS
+)
+IOCTL_DISK_SENSE_DEVICE = CTL_CODE(
+    IOCTL_DISK_BASE, 0x00F8, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+IOCTL_DISK_CHECK_VERIFY = CTL_CODE(
+    IOCTL_DISK_BASE, 0x0200, METHOD_BUFFERED, FILE_READ_ACCESS
+)
+IOCTL_DISK_MEDIA_REMOVAL = CTL_CODE(
+    IOCTL_DISK_BASE, 0x0201, METHOD_BUFFERED, FILE_READ_ACCESS
+)
+IOCTL_DISK_EJECT_MEDIA = CTL_CODE(
+    IOCTL_DISK_BASE, 0x0202, METHOD_BUFFERED, FILE_READ_ACCESS
+)
+IOCTL_DISK_LOAD_MEDIA = CTL_CODE(
+    IOCTL_DISK_BASE, 0x0203, METHOD_BUFFERED, FILE_READ_ACCESS
+)
+IOCTL_DISK_RESERVE = CTL_CODE(
+    IOCTL_DISK_BASE, 0x0204, METHOD_BUFFERED, FILE_READ_ACCESS
+)
+IOCTL_DISK_RELEASE = CTL_CODE(
+    IOCTL_DISK_BASE, 0x0205, METHOD_BUFFERED, FILE_READ_ACCESS
+)
+IOCTL_DISK_FIND_NEW_DEVICES = CTL_CODE(
+    IOCTL_DISK_BASE, 0x0206, METHOD_BUFFERED, FILE_READ_ACCESS
+)
+IOCTL_DISK_GET_MEDIA_TYPES = CTL_CODE(
+    IOCTL_DISK_BASE, 0x0300, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+
+DISK_HISTOGRAM_SIZE = 72
+HISTOGRAM_BUCKET_SIZE = 8
+
+IOCTL_CHANGER_GET_PARAMETERS = CTL_CODE(
+    IOCTL_CHANGER_BASE, 0x0000, METHOD_BUFFERED, FILE_READ_ACCESS
+)
+IOCTL_CHANGER_GET_STATUS = CTL_CODE(
+    IOCTL_CHANGER_BASE, 0x0001, METHOD_BUFFERED, FILE_READ_ACCESS
+)
+IOCTL_CHANGER_GET_PRODUCT_DATA = CTL_CODE(
+    IOCTL_CHANGER_BASE, 0x0002, METHOD_BUFFERED, FILE_READ_ACCESS
+)
+IOCTL_CHANGER_SET_ACCESS = CTL_CODE(
+    IOCTL_CHANGER_BASE, 0x0004, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS
+)
+IOCTL_CHANGER_GET_ELEMENT_STATUS = CTL_CODE(
+    IOCTL_CHANGER_BASE, 0x0005, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS
+)
+IOCTL_CHANGER_INITIALIZE_ELEMENT_STATUS = CTL_CODE(
+    IOCTL_CHANGER_BASE, 0x0006, METHOD_BUFFERED, FILE_READ_ACCESS
+)
+IOCTL_CHANGER_SET_POSITION = CTL_CODE(
+    IOCTL_CHANGER_BASE, 0x0007, METHOD_BUFFERED, FILE_READ_ACCESS
+)
+IOCTL_CHANGER_EXCHANGE_MEDIUM = CTL_CODE(
+    IOCTL_CHANGER_BASE, 0x0008, METHOD_BUFFERED, FILE_READ_ACCESS
+)
+IOCTL_CHANGER_MOVE_MEDIUM = CTL_CODE(
+    IOCTL_CHANGER_BASE, 0x0009, METHOD_BUFFERED, FILE_READ_ACCESS
+)
+IOCTL_CHANGER_REINITIALIZE_TRANSPORT = CTL_CODE(
+    IOCTL_CHANGER_BASE, 0x000A, METHOD_BUFFERED, FILE_READ_ACCESS
+)
+IOCTL_CHANGER_QUERY_VOLUME_TAGS = CTL_CODE(
+    IOCTL_CHANGER_BASE, 0x000B, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS
+)
+IOCTL_SERIAL_LSRMST_INSERT = CTL_CODE(
+    FILE_DEVICE_SERIAL_PORT, 31, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+IOCTL_SERENUM_EXPOSE_HARDWARE = CTL_CODE(
+    FILE_DEVICE_SERENUM, 128, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+IOCTL_SERENUM_REMOVE_HARDWARE = CTL_CODE(
+    FILE_DEVICE_SERENUM, 129, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+IOCTL_SERENUM_PORT_DESC = CTL_CODE(
+    FILE_DEVICE_SERENUM, 130, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+IOCTL_SERENUM_GET_PORT_NAME = CTL_CODE(
+    FILE_DEVICE_SERENUM, 131, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+
+## ??? can't find where FILE_DEVICE_AVIO is defined ???
+## IOCTL_AVIO_ALLOCATE_STREAM = CTL_CODE(FILE_DEVICE_AVIO, 1, METHOD_BUFFERED, FILE_SPECIAL_ACCESS)
+## IOCTL_AVIO_FREE_STREAM = CTL_CODE(FILE_DEVICE_AVIO, 2, METHOD_BUFFERED, FILE_SPECIAL_ACCESS)
+## IOCTL_AVIO_MODIFY_STREAM = CTL_CODE(FILE_DEVICE_AVIO, 3, METHOD_BUFFERED, FILE_SPECIAL_ACCESS)
+
+SERIAL_LSRMST_ESCAPE = 0x00
+SERIAL_LSRMST_LSR_DATA = 0x01
+SERIAL_LSRMST_LSR_NODATA = 0x02
+SERIAL_LSRMST_MST = 0x03
+SERIAL_IOC_FCR_FIFO_ENABLE = 0x00000001
+SERIAL_IOC_FCR_RCVR_RESET = 0x00000002
+SERIAL_IOC_FCR_XMIT_RESET = 0x00000004
+SERIAL_IOC_FCR_DMA_MODE = 0x00000008
+SERIAL_IOC_FCR_RES1 = 0x00000010
+SERIAL_IOC_FCR_RES2 = 0x00000020
+SERIAL_IOC_FCR_RCVR_TRIGGER_LSB = 0x00000040
+SERIAL_IOC_FCR_RCVR_TRIGGER_MSB = 0x00000080
+SERIAL_IOC_MCR_DTR = 0x00000001
+SERIAL_IOC_MCR_RTS = 0x00000002
+SERIAL_IOC_MCR_OUT1 = 0x00000004
+SERIAL_IOC_MCR_OUT2 = 0x00000008
+SERIAL_IOC_MCR_LOOP = 0x00000010
+FSCTL_REQUEST_OPLOCK_LEVEL_1 = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 0, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+FSCTL_REQUEST_OPLOCK_LEVEL_2 = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 1, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+FSCTL_REQUEST_BATCH_OPLOCK = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 2, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+FSCTL_OPLOCK_BREAK_ACKNOWLEDGE = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 3, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+FSCTL_OPBATCH_ACK_CLOSE_PENDING = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 4, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+FSCTL_OPLOCK_BREAK_NOTIFY = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 5, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+FSCTL_LOCK_VOLUME = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 6, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+FSCTL_UNLOCK_VOLUME = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 7, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+FSCTL_DISMOUNT_VOLUME = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 8, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+FSCTL_IS_VOLUME_MOUNTED = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 10, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+FSCTL_IS_PATHNAME_VALID = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 11, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+FSCTL_MARK_VOLUME_DIRTY = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 12, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+FSCTL_QUERY_RETRIEVAL_POINTERS = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 14, METHOD_NEITHER, FILE_ANY_ACCESS
+)
+FSCTL_GET_COMPRESSION = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 15, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+FSCTL_SET_COMPRESSION = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 16, METHOD_BUFFERED, FILE_READ_DATA | FILE_WRITE_DATA
+)
+FSCTL_MARK_AS_SYSTEM_HIVE = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 19, METHOD_NEITHER, FILE_ANY_ACCESS
+)
+FSCTL_OPLOCK_BREAK_ACK_NO_2 = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 20, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+FSCTL_INVALIDATE_VOLUMES = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 21, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+FSCTL_QUERY_FAT_BPB = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 22, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+FSCTL_REQUEST_FILTER_OPLOCK = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 23, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+FSCTL_FILESYSTEM_GET_STATISTICS = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 24, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+FSCTL_GET_NTFS_VOLUME_DATA = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 25, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+FSCTL_GET_NTFS_FILE_RECORD = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 26, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+FSCTL_GET_VOLUME_BITMAP = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 27, METHOD_NEITHER, FILE_ANY_ACCESS
+)
+FSCTL_GET_RETRIEVAL_POINTERS = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 28, METHOD_NEITHER, FILE_ANY_ACCESS
+)
+FSCTL_MOVE_FILE = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 29, METHOD_BUFFERED, FILE_SPECIAL_ACCESS
+)
+FSCTL_IS_VOLUME_DIRTY = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 30, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+FSCTL_ALLOW_EXTENDED_DASD_IO = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 32, METHOD_NEITHER, FILE_ANY_ACCESS
+)
+FSCTL_FIND_FILES_BY_SID = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 35, METHOD_NEITHER, FILE_ANY_ACCESS
+)
+FSCTL_SET_OBJECT_ID = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 38, METHOD_BUFFERED, FILE_SPECIAL_ACCESS
+)
+FSCTL_GET_OBJECT_ID = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 39, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+FSCTL_DELETE_OBJECT_ID = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 40, METHOD_BUFFERED, FILE_SPECIAL_ACCESS
+)
+FSCTL_SET_REPARSE_POINT = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 41, METHOD_BUFFERED, FILE_SPECIAL_ACCESS
+)
+FSCTL_GET_REPARSE_POINT = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 42, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+FSCTL_DELETE_REPARSE_POINT = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 43, METHOD_BUFFERED, FILE_SPECIAL_ACCESS
+)
+FSCTL_ENUM_USN_DATA = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 44, METHOD_NEITHER, FILE_ANY_ACCESS
+)
+FSCTL_SECURITY_ID_CHECK = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 45, METHOD_NEITHER, FILE_READ_DATA
+)
+FSCTL_READ_USN_JOURNAL = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 46, METHOD_NEITHER, FILE_ANY_ACCESS
+)
+FSCTL_SET_OBJECT_ID_EXTENDED = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 47, METHOD_BUFFERED, FILE_SPECIAL_ACCESS
+)
+FSCTL_CREATE_OR_GET_OBJECT_ID = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 48, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+FSCTL_SET_SPARSE = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 49, METHOD_BUFFERED, FILE_SPECIAL_ACCESS
+)
+FSCTL_SET_ZERO_DATA = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 50, METHOD_BUFFERED, FILE_WRITE_DATA
+)
+FSCTL_QUERY_ALLOCATED_RANGES = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 51, METHOD_NEITHER, FILE_READ_DATA
+)
+FSCTL_SET_ENCRYPTION = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 53, METHOD_NEITHER, FILE_ANY_ACCESS
+)
+FSCTL_ENCRYPTION_FSCTL_IO = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 54, METHOD_NEITHER, FILE_ANY_ACCESS
+)
+FSCTL_WRITE_RAW_ENCRYPTED = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 55, METHOD_NEITHER, FILE_SPECIAL_ACCESS
+)
+FSCTL_READ_RAW_ENCRYPTED = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 56, METHOD_NEITHER, FILE_SPECIAL_ACCESS
+)
+FSCTL_CREATE_USN_JOURNAL = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 57, METHOD_NEITHER, FILE_ANY_ACCESS
+)
+FSCTL_READ_FILE_USN_DATA = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 58, METHOD_NEITHER, FILE_ANY_ACCESS
+)
+FSCTL_WRITE_USN_CLOSE_RECORD = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 59, METHOD_NEITHER, FILE_ANY_ACCESS
+)
+FSCTL_EXTEND_VOLUME = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 60, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+FSCTL_QUERY_USN_JOURNAL = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 61, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+FSCTL_DELETE_USN_JOURNAL = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 62, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+FSCTL_MARK_HANDLE = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 63, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+FSCTL_SIS_COPYFILE = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 64, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+FSCTL_SIS_LINK_FILES = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 65, METHOD_BUFFERED, FILE_READ_DATA | FILE_WRITE_DATA
+)
+FSCTL_HSM_MSG = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 66, METHOD_BUFFERED, FILE_READ_DATA | FILE_WRITE_DATA
+)
+FSCTL_HSM_DATA = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 68, METHOD_NEITHER, FILE_READ_DATA | FILE_WRITE_DATA
+)
+FSCTL_RECALL_FILE = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 69, METHOD_NEITHER, FILE_ANY_ACCESS
+)
+FSCTL_READ_FROM_PLEX = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 71, METHOD_OUT_DIRECT, FILE_READ_DATA
+)
+FSCTL_FILE_PREFETCH = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 72, METHOD_BUFFERED, FILE_SPECIAL_ACCESS
+)
+FSCTL_MAKE_MEDIA_COMPATIBLE = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 76, METHOD_BUFFERED, FILE_WRITE_DATA
+)
+FSCTL_SET_DEFECT_MANAGEMENT = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 77, METHOD_BUFFERED, FILE_WRITE_DATA
+)
+FSCTL_QUERY_SPARING_INFO = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 78, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+FSCTL_QUERY_ON_DISK_VOLUME_INFO = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 79, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+FSCTL_SET_VOLUME_COMPRESSION_STATE = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 80, METHOD_BUFFERED, FILE_SPECIAL_ACCESS
+)
+FSCTL_TXFS_MODIFY_RM = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 81, METHOD_BUFFERED, FILE_WRITE_DATA
+)
+FSCTL_TXFS_QUERY_RM_INFORMATION = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 82, METHOD_BUFFERED, FILE_READ_DATA
+)
+FSCTL_TXFS_ROLLFORWARD_REDO = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 84, METHOD_BUFFERED, FILE_WRITE_DATA
+)
+FSCTL_TXFS_ROLLFORWARD_UNDO = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 85, METHOD_BUFFERED, FILE_WRITE_DATA
+)
+FSCTL_TXFS_START_RM = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 86, METHOD_BUFFERED, FILE_WRITE_DATA
+)
+FSCTL_TXFS_SHUTDOWN_RM = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 87, METHOD_BUFFERED, FILE_WRITE_DATA
+)
+FSCTL_TXFS_READ_BACKUP_INFORMATION = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 88, METHOD_BUFFERED, FILE_READ_DATA
+)
+FSCTL_TXFS_WRITE_BACKUP_INFORMATION = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 89, METHOD_BUFFERED, FILE_WRITE_DATA
+)
+FSCTL_TXFS_CREATE_SECONDARY_RM = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 90, METHOD_BUFFERED, FILE_WRITE_DATA
+)
+FSCTL_TXFS_GET_METADATA_INFO = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 91, METHOD_BUFFERED, FILE_READ_DATA
+)
+FSCTL_TXFS_GET_TRANSACTED_VERSION = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 92, METHOD_BUFFERED, FILE_READ_DATA
+)
+FSCTL_TXFS_CREATE_MINIVERSION = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 95, METHOD_BUFFERED, FILE_WRITE_DATA
+)
+FSCTL_TXFS_TRANSACTION_ACTIVE = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 99, METHOD_BUFFERED, FILE_READ_DATA
+)
+FSCTL_SET_ZERO_ON_DEALLOCATION = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 101, METHOD_BUFFERED, FILE_SPECIAL_ACCESS
+)
+FSCTL_SET_REPAIR = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 102, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+FSCTL_GET_REPAIR = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 103, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+FSCTL_WAIT_FOR_REPAIR = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 104, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+FSCTL_INITIATE_REPAIR = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 106, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+FSCTL_CSC_INTERNAL = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 107, METHOD_NEITHER, FILE_ANY_ACCESS
+)
+FSCTL_SHRINK_VOLUME = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 108, METHOD_BUFFERED, FILE_SPECIAL_ACCESS
+)
+FSCTL_SET_SHORT_NAME_BEHAVIOR = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 109, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+FSCTL_DFSR_SET_GHOST_HANDLE_STATE = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 110, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+FSCTL_TXFS_LIST_TRANSACTION_LOCKED_FILES = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 120, METHOD_BUFFERED, FILE_READ_DATA
+)
+FSCTL_TXFS_LIST_TRANSACTIONS = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 121, METHOD_BUFFERED, FILE_READ_DATA
+)
+FSCTL_QUERY_PAGEFILE_ENCRYPTION = CTL_CODE(
+    FILE_DEVICE_FILE_SYSTEM, 122, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+
+IOCTL_VOLUME_BASE = ord("V")
+IOCTL_VOLUME_GET_VOLUME_DISK_EXTENTS = CTL_CODE(
+    IOCTL_VOLUME_BASE, 0, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+IOCTL_VOLUME_ONLINE = CTL_CODE(
+    IOCTL_VOLUME_BASE, 2, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS
+)
+IOCTL_VOLUME_OFFLINE = CTL_CODE(
+    IOCTL_VOLUME_BASE, 3, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS
+)
+IOCTL_VOLUME_IS_CLUSTERED = CTL_CODE(
+    IOCTL_VOLUME_BASE, 12, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+IOCTL_VOLUME_GET_GPT_ATTRIBUTES = CTL_CODE(
+    IOCTL_VOLUME_BASE, 14, METHOD_BUFFERED, FILE_ANY_ACCESS
+)
+
+## enums
+## STORAGE_MEDIA_TYPE
+DDS_4mm = 32
+MiniQic = 33
+Travan = 34
+QIC = 35
+MP_8mm = 36
+AME_8mm = 37
+AIT1_8mm = 38
+DLT = 39
+NCTP = 40
+IBM_3480 = 41
+IBM_3490E = 42
+IBM_Magstar_3590 = 43
+IBM_Magstar_MP = 44
+STK_DATA_D3 = 45
+SONY_DTF = 46
+DV_6mm = 47
+DMI = 48
+SONY_D2 = 49
+CLEANER_CARTRIDGE = 50
+CD_ROM = 51
+CD_R = 52
+CD_RW = 53
+DVD_ROM = 54
+DVD_R = 55
+DVD_RW = 56
+MO_3_RW = 57
+MO_5_WO = 58
+MO_5_RW = 59
+MO_5_LIMDOW = 60
+PC_5_WO = 61
+PC_5_RW = 62
+PD_5_RW = 63
+ABL_5_WO = 64
+PINNACLE_APEX_5_RW = 65
+SONY_12_WO = 66
+PHILIPS_12_WO = 67
+HITACHI_12_WO = 68
+CYGNET_12_WO = 69
+KODAK_14_WO = 70
+MO_NFR_525 = 71
+NIKON_12_RW = 72
+IOMEGA_ZIP = 73
+IOMEGA_JAZ = 74
+SYQUEST_EZ135 = 75
+SYQUEST_EZFLYER = 76
+SYQUEST_SYJET = 77
+AVATAR_F2 = 78
+MP2_8mm = 79
+DST_S = 80
+DST_M = 81
+DST_L = 82
+VXATape_1 = 83
+VXATape_2 = 84
+STK_9840 = 85
+LTO_Ultrium = 86
+LTO_Accelis = 87
+DVD_RAM = 88
+AIT_8mm = 89
+ADR_1 = 90
+ADR_2 = 91
+STK_9940 = 92
+
+## STORAGE_BUS_TYPE
+BusTypeUnknown = 0
+BusTypeScsi = 1
+BusTypeAtapi = 2
+BusTypeAta = 3
+BusType1394 = 4
+BusTypeSsa = 5
+BusTypeFibre = 6
+BusTypeUsb = 7
+BusTypeRAID = 8
+BusTypeiScsi = 9
+BusTypeSas = 10
+BusTypeSata = 11
+BusTypeMaxReserved = 127
+
+## MEDIA_TYPE
+Unknown = 0
+F5_1Pt2_512 = 1
+F3_1Pt44_512 = 2
+F3_2Pt88_512 = 3
+F3_20Pt8_512 = 4
+F3_720_512 = 5
+F5_360_512 = 6
+F5_320_512 = 7
+F5_320_1024 = 8
+F5_180_512 = 9
+F5_160_512 = 10
+RemovableMedia = 11
+FixedMedia = 12
+F3_120M_512 = 13
+F3_640_512 = 14
+F5_640_512 = 15
+F5_720_512 = 16
+F3_1Pt2_512 = 17
+F3_1Pt23_1024 = 18
+F5_1Pt23_1024 = 19
+F3_128Mb_512 = 20
+F3_230Mb_512 = 21
+F8_256_128 = 22
+F3_200Mb_512 = 23
+F3_240M_512 = 24
+F3_32M_512 = 25
+
+## PARTITION_STYLE
+PARTITION_STYLE_MBR = 0
+PARTITION_STYLE_GPT = 1
+PARTITION_STYLE_RAW = 2
+
+## DETECTION_TYPE
+DetectNone = 0
+DetectInt13 = 1
+DetectExInt13 = 2
+
+## DISK_CACHE_RETENTION_PRIORITY
+EqualPriority = 0
+KeepPrefetchedData = 1
+KeepReadData = 2
+
+## DISK_WRITE_CACHE_STATE - ?????? this enum has disappeared from winioctl.h in windows 2003 SP1 sdk ??????
+DiskWriteCacheNormal = 0
+DiskWriteCacheForceDisable = 1
+DiskWriteCacheDisableNotSupported = 2
+
+## BIN_TYPES
+RequestSize = 0
+RequestLocation = 1
+
+## CHANGER_DEVICE_PROBLEM_TYPE
+DeviceProblemNone = 0
+DeviceProblemHardware = 1
+DeviceProblemCHMError = 2
+DeviceProblemDoorOpen = 3
+DeviceProblemCalibrationError = 4
+DeviceProblemTargetFailure = 5
+DeviceProblemCHMMoveError = 6
+DeviceProblemCHMZeroError = 7
+DeviceProblemCartridgeInsertError = 8
+DeviceProblemPositionError = 9
+DeviceProblemSensorError = 10
+DeviceProblemCartridgeEjectError = 11
+DeviceProblemGripperError = 12
+DeviceProblemDriveError = 13
diff --git a/lib/win32/lib/winnt.py b/lib/win32/lib/winnt.py
new file mode 100644
index 00000000..2848794a
--- /dev/null
+++ b/lib/win32/lib/winnt.py
@@ -0,0 +1,1371 @@
+# Generated by h2py from \mssdk\include\winnt.h
+
+APPLICATION_ERROR_MASK = 536870912
+ERROR_SEVERITY_SUCCESS = 0
+ERROR_SEVERITY_INFORMATIONAL = 1073741824
+ERROR_SEVERITY_WARNING = -2147483648
+ERROR_SEVERITY_ERROR = -1073741824
+MINCHAR = 128
+MAXCHAR = 127
+MINSHORT = 32768
+MAXSHORT = 32767
+MINLONG = -2147483648
+MAXLONG = 2147483647
+MAXBYTE = 255
+MAXWORD = 65535
+MAXDWORD = -1
+LANG_NEUTRAL = 0
+LANG_AFRIKAANS = 54
+LANG_ALBANIAN = 28
+LANG_ARABIC = 1
+LANG_BASQUE = 45
+LANG_BELARUSIAN = 35
+LANG_BULGARIAN = 2
+LANG_CATALAN = 3
+LANG_CHINESE = 4
+LANG_CROATIAN = 26
+LANG_CZECH = 5
+LANG_DANISH = 6
+LANG_DUTCH = 19
+LANG_ENGLISH = 9
+LANG_ESTONIAN = 37
+LANG_FAEROESE = 56
+LANG_FARSI = 41
+LANG_FINNISH = 11
+LANG_FRENCH = 12
+LANG_GERMAN = 7
+LANG_GREEK = 8
+LANG_HEBREW = 13
+LANG_HINDI = 57
+LANG_HUNGARIAN = 14
+LANG_ICELANDIC = 15
+LANG_INDONESIAN = 33
+LANG_ITALIAN = 16
+LANG_JAPANESE = 17
+LANG_KOREAN = 18
+LANG_LATVIAN = 38
+LANG_LITHUANIAN = 39
+LANG_MACEDONIAN = 47
+LANG_MALAY = 62
+LANG_NORWEGIAN = 20
+LANG_POLISH = 21
+LANG_PORTUGUESE = 22
+LANG_ROMANIAN = 24
+LANG_RUSSIAN = 25
+LANG_SERBIAN = 26
+LANG_SLOVAK = 27
+LANG_SLOVENIAN = 36
+LANG_SPANISH = 10
+LANG_SWAHILI = 65
+LANG_SWEDISH = 29
+LANG_THAI = 30
+LANG_TURKISH = 31
+LANG_UKRAINIAN = 34
+LANG_VIETNAMESE = 42
+SUBLANG_NEUTRAL = 0
+SUBLANG_DEFAULT = 1
+SUBLANG_SYS_DEFAULT = 2
+SUBLANG_ARABIC_SAUDI_ARABIA = 1
+SUBLANG_ARABIC_IRAQ = 2
+SUBLANG_ARABIC_EGYPT = 3
+SUBLANG_ARABIC_LIBYA = 4
+SUBLANG_ARABIC_ALGERIA = 5
+SUBLANG_ARABIC_MOROCCO = 6
+SUBLANG_ARABIC_TUNISIA = 7
+SUBLANG_ARABIC_OMAN = 8
+SUBLANG_ARABIC_YEMEN = 9
+SUBLANG_ARABIC_SYRIA = 10
+SUBLANG_ARABIC_JORDAN = 11
+SUBLANG_ARABIC_LEBANON = 12
+SUBLANG_ARABIC_KUWAIT = 13
+SUBLANG_ARABIC_UAE = 14
+SUBLANG_ARABIC_BAHRAIN = 15
+SUBLANG_ARABIC_QATAR = 16
+SUBLANG_CHINESE_TRADITIONAL = 1
+SUBLANG_CHINESE_SIMPLIFIED = 2
+SUBLANG_CHINESE_HONGKONG = 3
+SUBLANG_CHINESE_SINGAPORE = 4
+SUBLANG_CHINESE_MACAU = 5
+SUBLANG_DUTCH = 1
+SUBLANG_DUTCH_BELGIAN = 2
+SUBLANG_ENGLISH_US = 1
+SUBLANG_ENGLISH_UK = 2
+SUBLANG_ENGLISH_AUS = 3
+SUBLANG_ENGLISH_CAN = 4
+SUBLANG_ENGLISH_NZ = 5
+SUBLANG_ENGLISH_EIRE = 6
+SUBLANG_ENGLISH_SOUTH_AFRICA = 7
+SUBLANG_ENGLISH_JAMAICA = 8
+SUBLANG_ENGLISH_CARIBBEAN = 9
+SUBLANG_ENGLISH_BELIZE = 10
+SUBLANG_ENGLISH_TRINIDAD = 11
+SUBLANG_ENGLISH_ZIMBABWE = 12
+SUBLANG_ENGLISH_PHILIPPINES = 13
+SUBLANG_FRENCH = 1
+SUBLANG_FRENCH_BELGIAN = 2
+SUBLANG_FRENCH_CANADIAN = 3
+SUBLANG_FRENCH_SWISS = 4
+SUBLANG_FRENCH_LUXEMBOURG = 5
+SUBLANG_FRENCH_MONACO = 6
+SUBLANG_GERMAN = 1
+SUBLANG_GERMAN_SWISS = 2
+SUBLANG_GERMAN_AUSTRIAN = 3
+SUBLANG_GERMAN_LUXEMBOURG = 4
+SUBLANG_GERMAN_LIECHTENSTEIN = 5
+SUBLANG_ITALIAN = 1
+SUBLANG_ITALIAN_SWISS = 2
+SUBLANG_KOREAN = 1
+SUBLANG_KOREAN_JOHAB = 2
+SUBLANG_LITHUANIAN = 1
+SUBLANG_LITHUANIAN_CLASSIC = 2
+SUBLANG_MALAY_MALAYSIA = 1
+SUBLANG_MALAY_BRUNEI_DARUSSALAM = 2
+SUBLANG_NORWEGIAN_BOKMAL = 1
+SUBLANG_NORWEGIAN_NYNORSK = 2
+SUBLANG_PORTUGUESE = 2
+SUBLANG_PORTUGUESE_BRAZILIAN = 1
+SUBLANG_SERBIAN_LATIN = 2
+SUBLANG_SERBIAN_CYRILLIC = 3
+SUBLANG_SPANISH = 1
+SUBLANG_SPANISH_MEXICAN = 2
+SUBLANG_SPANISH_MODERN = 3
+SUBLANG_SPANISH_GUATEMALA = 4
+SUBLANG_SPANISH_COSTA_RICA = 5
+SUBLANG_SPANISH_PANAMA = 6
+SUBLANG_SPANISH_DOMINICAN_REPUBLIC = 7
+SUBLANG_SPANISH_VENEZUELA = 8
+SUBLANG_SPANISH_COLOMBIA = 9
+SUBLANG_SPANISH_PERU = 10
+SUBLANG_SPANISH_ARGENTINA = 11
+SUBLANG_SPANISH_ECUADOR = 12
+SUBLANG_SPANISH_CHILE = 13
+SUBLANG_SPANISH_URUGUAY = 14
+SUBLANG_SPANISH_PARAGUAY = 15
+SUBLANG_SPANISH_BOLIVIA = 16
+SUBLANG_SPANISH_EL_SALVADOR = 17
+SUBLANG_SPANISH_HONDURAS = 18
+SUBLANG_SPANISH_NICARAGUA = 19
+SUBLANG_SPANISH_PUERTO_RICO = 20
+SUBLANG_SWEDISH = 1
+SUBLANG_SWEDISH_FINLAND = 2
+SORT_DEFAULT = 0
+SORT_JAPANESE_XJIS = 0
+SORT_JAPANESE_UNICODE = 1
+SORT_CHINESE_BIG5 = 0
+SORT_CHINESE_PRCP = 0
+SORT_CHINESE_UNICODE = 1
+SORT_CHINESE_PRC = 2
+SORT_KOREAN_KSC = 0
+SORT_KOREAN_UNICODE = 1
+SORT_GERMAN_PHONE_BOOK = 1
+
+
+def PRIMARYLANGID(lgid):
+    return (WORD)(lgid) & 1023
+
+
+def SUBLANGID(lgid):
+    return (WORD)(lgid) >> 10
+
+
+NLS_VALID_LOCALE_MASK = 1048575
+
+
+def LANGIDFROMLCID(lcid):
+    return (WORD)(lcid)
+
+
+def SORTIDFROMLCID(lcid):
+    return (WORD)((((DWORD)(lcid)) & NLS_VALID_LOCALE_MASK) >> 16)
+
+
+def UNREFERENCED_PARAMETER(P):
+    return P
+
+
+def DBG_UNREFERENCED_PARAMETER(P):
+    return P
+
+
+def DBG_UNREFERENCED_LOCAL_VARIABLE(V):
+    return V
+
+
+def UNREFERENCED_PARAMETER(P):
+    return
+
+
+def DBG_UNREFERENCED_PARAMETER(P):
+    return
+
+
+def DBG_UNREFERENCED_LOCAL_VARIABLE(V):
+    return
+
+
+MAXIMUM_WAIT_OBJECTS = 64
+MAXIMUM_SUSPEND_COUNT = MAXCHAR
+
+EXCEPTION_NONCONTINUABLE = 1
+EXCEPTION_MAXIMUM_PARAMETERS = 15
+PROCESS_TERMINATE = 1
+PROCESS_CREATE_THREAD = 2
+PROCESS_VM_OPERATION = 8
+PROCESS_VM_READ = 16
+PROCESS_VM_WRITE = 32
+PROCESS_DUP_HANDLE = 64
+PROCESS_CREATE_PROCESS = 128
+PROCESS_SET_QUOTA = 256
+PROCESS_SET_INFORMATION = 512
+PROCESS_QUERY_INFORMATION = 1024
+PROCESS_SUSPEND_RESUME = 2048
+PROCESS_QUERY_LIMITED_INFORMATION = 4096
+PROCESS_SET_LIMITED_INFORMATION = 8192
+MAXIMUM_PROCESSORS = 32
+THREAD_TERMINATE = 1
+THREAD_SUSPEND_RESUME = 2
+THREAD_GET_CONTEXT = 8
+THREAD_SET_CONTEXT = 16
+THREAD_SET_INFORMATION = 32
+THREAD_QUERY_INFORMATION = 64
+THREAD_SET_THREAD_TOKEN = 128
+THREAD_IMPERSONATE = 256
+THREAD_DIRECT_IMPERSONATION = 512
+THREAD_SET_LIMITED_INFORMATION = 1024
+THREAD_QUERY_LIMITED_INFORMATION = 2048
+THREAD_RESUME = 4096
+JOB_OBJECT_ASSIGN_PROCESS = 1
+JOB_OBJECT_SET_ATTRIBUTES = 2
+JOB_OBJECT_QUERY = 4
+JOB_OBJECT_TERMINATE = 8
+TLS_MINIMUM_AVAILABLE = 64
+THREAD_BASE_PRIORITY_LOWRT = 15
+THREAD_BASE_PRIORITY_MAX = 2
+THREAD_BASE_PRIORITY_MIN = -2
+THREAD_BASE_PRIORITY_IDLE = -15
+JOB_OBJECT_LIMIT_WORKINGSET = 1
+JOB_OBJECT_LIMIT_PROCESS_TIME = 2
+JOB_OBJECT_LIMIT_JOB_TIME = 4
+JOB_OBJECT_LIMIT_ACTIVE_PROCESS = 8
+JOB_OBJECT_LIMIT_AFFINITY = 16
+JOB_OBJECT_LIMIT_PRIORITY_CLASS = 32
+JOB_OBJECT_LIMIT_VALID_FLAGS = 63
+EVENT_MODIFY_STATE = 2
+MUTANT_QUERY_STATE = 1
+SEMAPHORE_MODIFY_STATE = 2
+TIME_ZONE_ID_UNKNOWN = 0
+TIME_ZONE_ID_STANDARD = 1
+TIME_ZONE_ID_DAYLIGHT = 2
+PROCESSOR_INTEL_386 = 386
+PROCESSOR_INTEL_486 = 486
+PROCESSOR_INTEL_PENTIUM = 586
+PROCESSOR_MIPS_R4000 = 4000
+PROCESSOR_ALPHA_21064 = 21064
+PROCESSOR_HITACHI_SH3 = 10003
+PROCESSOR_HITACHI_SH3E = 10004
+PROCESSOR_HITACHI_SH4 = 10005
+PROCESSOR_MOTOROLA_821 = 821
+PROCESSOR_ARM_7TDMI = 70001
+PROCESSOR_ARCHITECTURE_INTEL = 0
+PROCESSOR_ARCHITECTURE_MIPS = 1
+PROCESSOR_ARCHITECTURE_ALPHA = 2
+PROCESSOR_ARCHITECTURE_PPC = 3
+PROCESSOR_ARCHITECTURE_SH = 4
+PROCESSOR_ARCHITECTURE_ARM = 5
+PROCESSOR_ARCHITECTURE_IA64 = 6
+PROCESSOR_ARCHITECTURE_ALPHA64 = 7
+PROCESSOR_ARCHITECTURE_MSIL = 8
+PROCESSOR_ARCHITECTURE_AMD64 = 9
+PROCESSOR_ARCHITECTURE_IA32_ON_WIN64 = 10
+PROCESSOR_ARCHITECTURE_UNKNOWN = 65535
+PF_FLOATING_POINT_PRECISION_ERRATA = 0
+PF_FLOATING_POINT_EMULATED = 1
+PF_COMPARE_EXCHANGE_DOUBLE = 2
+PF_MMX_INSTRUCTIONS_AVAILABLE = 3
+PF_PPC_MOVEMEM_64BIT_OK = 4
+PF_ALPHA_BYTE_INSTRUCTIONS = 5
+SECTION_QUERY = 1
+SECTION_MAP_WRITE = 2
+SECTION_MAP_READ = 4
+SECTION_MAP_EXECUTE = 8
+SECTION_EXTEND_SIZE = 16
+PAGE_NOACCESS = 1
+PAGE_READONLY = 2
+PAGE_READWRITE = 4
+PAGE_WRITECOPY = 8
+PAGE_EXECUTE = 16
+PAGE_EXECUTE_READ = 32
+PAGE_EXECUTE_READWRITE = 64
+PAGE_EXECUTE_WRITECOPY = 128
+PAGE_GUARD = 256
+PAGE_NOCACHE = 512
+MEM_COMMIT = 4096
+MEM_RESERVE = 8192
+MEM_DECOMMIT = 16384
+MEM_RELEASE = 32768
+MEM_FREE = 65536
+MEM_PRIVATE = 131072
+MEM_MAPPED = 262144
+MEM_RESET = 524288
+MEM_TOP_DOWN = 1048576
+MEM_4MB_PAGES = -2147483648
+SEC_FILE = 8388608
+SEC_IMAGE = 16777216
+SEC_VLM = 33554432
+SEC_RESERVE = 67108864
+SEC_COMMIT = 134217728
+SEC_NOCACHE = 268435456
+MEM_IMAGE = SEC_IMAGE
+FILE_READ_DATA = 1
+FILE_LIST_DIRECTORY = 1
+FILE_WRITE_DATA = 2
+FILE_ADD_FILE = 2
+FILE_APPEND_DATA = 4
+FILE_ADD_SUBDIRECTORY = 4
+FILE_CREATE_PIPE_INSTANCE = 4
+FILE_READ_EA = 8
+FILE_WRITE_EA = 16
+FILE_EXECUTE = 32
+FILE_TRAVERSE = 32
+FILE_DELETE_CHILD = 64
+FILE_READ_ATTRIBUTES = 128
+FILE_WRITE_ATTRIBUTES = 256
+FILE_SHARE_READ = 1
+FILE_SHARE_WRITE = 2
+FILE_SHARE_DELETE = 4
+FILE_ATTRIBUTE_READONLY = 1
+FILE_ATTRIBUTE_HIDDEN = 2
+FILE_ATTRIBUTE_SYSTEM = 4
+FILE_ATTRIBUTE_DIRECTORY = 16
+FILE_ATTRIBUTE_ARCHIVE = 32
+FILE_ATTRIBUTE_DEVICE = 64
+FILE_ATTRIBUTE_NORMAL = 128
+FILE_ATTRIBUTE_TEMPORARY = 256
+FILE_ATTRIBUTE_SPARSE_FILE = 512
+FILE_ATTRIBUTE_REPARSE_POINT = 1024
+FILE_ATTRIBUTE_COMPRESSED = 2048
+FILE_ATTRIBUTE_OFFLINE = 4096
+FILE_ATTRIBUTE_NOT_CONTENT_INDEXED = 8192
+FILE_ATTRIBUTE_ENCRYPTED = 16384
+FILE_ATTRIBUTE_VIRTUAL = 65536
+FILE_NOTIFY_CHANGE_FILE_NAME = 1
+FILE_NOTIFY_CHANGE_DIR_NAME = 2
+FILE_NOTIFY_CHANGE_ATTRIBUTES = 4
+FILE_NOTIFY_CHANGE_SIZE = 8
+FILE_NOTIFY_CHANGE_LAST_WRITE = 16
+FILE_NOTIFY_CHANGE_LAST_ACCESS = 32
+FILE_NOTIFY_CHANGE_CREATION = 64
+FILE_NOTIFY_CHANGE_SECURITY = 256
+FILE_ACTION_ADDED = 1
+FILE_ACTION_REMOVED = 2
+FILE_ACTION_MODIFIED = 3
+FILE_ACTION_RENAMED_OLD_NAME = 4
+FILE_ACTION_RENAMED_NEW_NAME = 5
+FILE_CASE_SENSITIVE_SEARCH = 1
+FILE_CASE_PRESERVED_NAMES = 2
+FILE_UNICODE_ON_DISK = 4
+FILE_PERSISTENT_ACLS = 8
+FILE_FILE_COMPRESSION = 16
+FILE_VOLUME_QUOTAS = 32
+FILE_SUPPORTS_SPARSE_FILES = 64
+FILE_SUPPORTS_REPARSE_POINTS = 128
+FILE_SUPPORTS_REMOTE_STORAGE = 256
+FILE_VOLUME_IS_COMPRESSED = 32768
+FILE_SUPPORTS_OBJECT_IDS = 65536
+FILE_SUPPORTS_ENCRYPTION = 131072
+
+MAXIMUM_REPARSE_DATA_BUFFER_SIZE = 16 * 1024
+IO_REPARSE_TAG_RESERVED_ZERO = 0
+IO_REPARSE_TAG_RESERVED_ONE = 1
+IO_REPARSE_TAG_SYMBOLIC_LINK = 2
+IO_REPARSE_TAG_NSS = 5
+IO_REPARSE_TAG_FILTER_MANAGER = -2147483637
+IO_REPARSE_TAG_DFS = -2147483638
+IO_REPARSE_TAG_SIS = -2147483641
+IO_REPARSE_TAG_MOUNT_POINT = -1610612733
+IO_REPARSE_TAG_HSM = -1073741820
+IO_REPARSE_TAG_NSSRECOVER = 8
+IO_REPARSE_TAG_RESERVED_MS_RANGE = 256
+IO_REPARSE_TAG_RESERVED_RANGE = IO_REPARSE_TAG_RESERVED_ONE
+IO_COMPLETION_MODIFY_STATE = 2
+
+DUPLICATE_CLOSE_SOURCE = 1
+DUPLICATE_SAME_ACCESS = 2
+DELETE = 65536
+READ_CONTROL = 131072
+WRITE_DAC = 262144
+WRITE_OWNER = 524288
+SYNCHRONIZE = 1048576
+STANDARD_RIGHTS_REQUIRED = 983040
+STANDARD_RIGHTS_READ = READ_CONTROL
+STANDARD_RIGHTS_WRITE = READ_CONTROL
+STANDARD_RIGHTS_EXECUTE = READ_CONTROL
+STANDARD_RIGHTS_ALL = 2031616
+SPECIFIC_RIGHTS_ALL = 65535
+IO_COMPLETION_ALL_ACCESS = STANDARD_RIGHTS_REQUIRED | SYNCHRONIZE | 0x3
+ACCESS_SYSTEM_SECURITY = 16777216
+MAXIMUM_ALLOWED = 33554432
+GENERIC_READ = -2147483648
+GENERIC_WRITE = 1073741824
+GENERIC_EXECUTE = 536870912
+GENERIC_ALL = 268435456
+
+# Included from pshpack4.h
+
+# Included from poppack.h
+SID_REVISION = 1
+SID_MAX_SUB_AUTHORITIES = 15
+SID_RECOMMENDED_SUB_AUTHORITIES = 1
+
+SidTypeUser = 1
+SidTypeGroup = 2
+SidTypeDomain = 3
+SidTypeAlias = 4
+SidTypeWellKnownGroup = 5
+SidTypeDeletedAccount = 6
+SidTypeInvalid = 7
+SidTypeUnknown = 8
+
+SECURITY_NULL_RID = 0
+SECURITY_WORLD_RID = 0
+SECURITY_LOCAL_RID = 0x00000000
+SECURITY_CREATOR_OWNER_RID = 0
+SECURITY_CREATOR_GROUP_RID = 1
+SECURITY_CREATOR_OWNER_SERVER_RID = 2
+SECURITY_CREATOR_GROUP_SERVER_RID = 3
+SECURITY_DIALUP_RID = 1
+SECURITY_NETWORK_RID = 2
+SECURITY_BATCH_RID = 3
+SECURITY_INTERACTIVE_RID = 4
+SECURITY_SERVICE_RID = 6
+SECURITY_ANONYMOUS_LOGON_RID = 7
+SECURITY_PROXY_RID = 8
+SECURITY_SERVER_LOGON_RID = 9
+SECURITY_PRINCIPAL_SELF_RID = 10
+SECURITY_AUTHENTICATED_USER_RID = 11
+SECURITY_LOGON_IDS_RID = 5
+SECURITY_LOGON_IDS_RID_COUNT = 3
+SECURITY_LOCAL_SYSTEM_RID = 18
+SECURITY_NT_NON_UNIQUE = 21
+SECURITY_BUILTIN_DOMAIN_RID = 32
+DOMAIN_USER_RID_ADMIN = 500
+DOMAIN_USER_RID_GUEST = 501
+DOMAIN_GROUP_RID_ADMINS = 512
+DOMAIN_GROUP_RID_USERS = 513
+DOMAIN_GROUP_RID_GUESTS = 514
+DOMAIN_ALIAS_RID_ADMINS = 544
+DOMAIN_ALIAS_RID_USERS = 545
+DOMAIN_ALIAS_RID_GUESTS = 546
+DOMAIN_ALIAS_RID_POWER_USERS = 547
+DOMAIN_ALIAS_RID_ACCOUNT_OPS = 548
+DOMAIN_ALIAS_RID_SYSTEM_OPS = 549
+DOMAIN_ALIAS_RID_PRINT_OPS = 550
+DOMAIN_ALIAS_RID_BACKUP_OPS = 551
+DOMAIN_ALIAS_RID_REPLICATOR = 552
+SE_GROUP_MANDATORY = 1
+SE_GROUP_ENABLED_BY_DEFAULT = 2
+SE_GROUP_ENABLED = 4
+SE_GROUP_OWNER = 8
+SE_GROUP_LOGON_ID = -1073741824
+ACL_REVISION = 2
+ACL_REVISION_DS = 4
+ACL_REVISION1 = 1
+ACL_REVISION2 = 2
+ACL_REVISION3 = 3
+ACL_REVISION4 = 4
+MAX_ACL_REVISION = ACL_REVISION4
+
+## ACE types
+ACCESS_MIN_MS_ACE_TYPE = 0
+ACCESS_ALLOWED_ACE_TYPE = 0
+ACCESS_DENIED_ACE_TYPE = 1
+SYSTEM_AUDIT_ACE_TYPE = 2
+SYSTEM_ALARM_ACE_TYPE = 3
+ACCESS_MAX_MS_V2_ACE_TYPE = 3
+ACCESS_ALLOWED_COMPOUND_ACE_TYPE = 4
+ACCESS_MAX_MS_V3_ACE_TYPE = 4
+ACCESS_MIN_MS_OBJECT_ACE_TYPE = 5
+ACCESS_ALLOWED_OBJECT_ACE_TYPE = 5
+ACCESS_DENIED_OBJECT_ACE_TYPE = 6
+SYSTEM_AUDIT_OBJECT_ACE_TYPE = 7
+SYSTEM_ALARM_OBJECT_ACE_TYPE = 8
+ACCESS_MAX_MS_OBJECT_ACE_TYPE = 8
+ACCESS_MAX_MS_V4_ACE_TYPE = 8
+ACCESS_MAX_MS_ACE_TYPE = 8
+ACCESS_ALLOWED_CALLBACK_ACE_TYPE = 9
+ACCESS_DENIED_CALLBACK_ACE_TYPE = 10
+ACCESS_ALLOWED_CALLBACK_OBJECT_ACE_TYPE = 11
+ACCESS_DENIED_CALLBACK_OBJECT_ACE_TYPE = 12
+SYSTEM_AUDIT_CALLBACK_ACE_TYPE = 13
+SYSTEM_ALARM_CALLBACK_ACE_TYPE = 14
+SYSTEM_AUDIT_CALLBACK_OBJECT_ACE_TYPE = 15
+SYSTEM_ALARM_CALLBACK_OBJECT_ACE_TYPE = 16
+SYSTEM_MANDATORY_LABEL_ACE_TYPE = 17
+ACCESS_MAX_MS_V5_ACE_TYPE = 17
+
+## ACE inheritance flags
+OBJECT_INHERIT_ACE = 1
+CONTAINER_INHERIT_ACE = 2
+NO_PROPAGATE_INHERIT_ACE = 4
+INHERIT_ONLY_ACE = 8
+INHERITED_ACE = 16
+VALID_INHERIT_FLAGS = 31
+
+
+SUCCESSFUL_ACCESS_ACE_FLAG = 64
+FAILED_ACCESS_ACE_FLAG = 128
+ACE_OBJECT_TYPE_PRESENT = 1
+ACE_INHERITED_OBJECT_TYPE_PRESENT = 2
+SECURITY_DESCRIPTOR_REVISION = 1
+SECURITY_DESCRIPTOR_REVISION1 = 1
+SECURITY_DESCRIPTOR_MIN_LENGTH = 20
+SE_OWNER_DEFAULTED = 1
+SE_GROUP_DEFAULTED = 2
+SE_DACL_PRESENT = 4
+SE_DACL_DEFAULTED = 8
+SE_SACL_PRESENT = 16
+SE_SACL_DEFAULTED = 32
+SE_DACL_AUTO_INHERIT_REQ = 256
+SE_SACL_AUTO_INHERIT_REQ = 512
+SE_DACL_AUTO_INHERITED = 1024
+SE_SACL_AUTO_INHERITED = 2048
+SE_DACL_PROTECTED = 4096
+SE_SACL_PROTECTED = 8192
+SE_SELF_RELATIVE = 32768
+ACCESS_OBJECT_GUID = 0
+ACCESS_PROPERTY_SET_GUID = 1
+ACCESS_PROPERTY_GUID = 2
+ACCESS_MAX_LEVEL = 4
+AUDIT_ALLOW_NO_PRIVILEGE = 1
+ACCESS_DS_SOURCE_A = "Directory Service"
+ACCESS_DS_OBJECT_TYPE_NAME_A = "Directory Service Object"
+SE_PRIVILEGE_ENABLED_BY_DEFAULT = 1
+SE_PRIVILEGE_ENABLED = 2
+SE_PRIVILEGE_USED_FOR_ACCESS = -2147483648
+PRIVILEGE_SET_ALL_NECESSARY = 1
+
+SE_CREATE_TOKEN_NAME = "SeCreateTokenPrivilege"
+SE_ASSIGNPRIMARYTOKEN_NAME = "SeAssignPrimaryTokenPrivilege"
+SE_LOCK_MEMORY_NAME = "SeLockMemoryPrivilege"
+SE_INCREASE_QUOTA_NAME = "SeIncreaseQuotaPrivilege"
+SE_UNSOLICITED_INPUT_NAME = "SeUnsolicitedInputPrivilege"
+SE_MACHINE_ACCOUNT_NAME = "SeMachineAccountPrivilege"
+SE_TCB_NAME = "SeTcbPrivilege"
+SE_SECURITY_NAME = "SeSecurityPrivilege"
+SE_TAKE_OWNERSHIP_NAME = "SeTakeOwnershipPrivilege"
+SE_LOAD_DRIVER_NAME = "SeLoadDriverPrivilege"
+SE_SYSTEM_PROFILE_NAME = "SeSystemProfilePrivilege"
+SE_SYSTEMTIME_NAME = "SeSystemtimePrivilege"
+SE_PROF_SINGLE_PROCESS_NAME = "SeProfileSingleProcessPrivilege"
+SE_INC_BASE_PRIORITY_NAME = "SeIncreaseBasePriorityPrivilege"
+SE_CREATE_PAGEFILE_NAME = "SeCreatePagefilePrivilege"
+SE_CREATE_PERMANENT_NAME = "SeCreatePermanentPrivilege"
+SE_BACKUP_NAME = "SeBackupPrivilege"
+SE_RESTORE_NAME = "SeRestorePrivilege"
+SE_SHUTDOWN_NAME = "SeShutdownPrivilege"
+SE_DEBUG_NAME = "SeDebugPrivilege"
+SE_AUDIT_NAME = "SeAuditPrivilege"
+SE_SYSTEM_ENVIRONMENT_NAME = "SeSystemEnvironmentPrivilege"
+SE_CHANGE_NOTIFY_NAME = "SeChangeNotifyPrivilege"
+SE_REMOTE_SHUTDOWN_NAME = "SeRemoteShutdownPrivilege"
+TOKEN_ASSIGN_PRIMARY = 1
+TOKEN_DUPLICATE = 2
+TOKEN_IMPERSONATE = 4
+TOKEN_QUERY = 8
+TOKEN_QUERY_SOURCE = 16
+TOKEN_ADJUST_PRIVILEGES = 32
+TOKEN_ADJUST_GROUPS = 64
+TOKEN_ADJUST_DEFAULT = 128
+TOKEN_ALL_ACCESS = (
+    STANDARD_RIGHTS_REQUIRED
+    | TOKEN_ASSIGN_PRIMARY
+    | TOKEN_DUPLICATE
+    | TOKEN_IMPERSONATE
+    | TOKEN_QUERY
+    | TOKEN_QUERY_SOURCE
+    | TOKEN_ADJUST_PRIVILEGES
+    | TOKEN_ADJUST_GROUPS
+    | TOKEN_ADJUST_DEFAULT
+)
+TOKEN_READ = STANDARD_RIGHTS_READ | TOKEN_QUERY
+TOKEN_WRITE = (
+    STANDARD_RIGHTS_WRITE
+    | TOKEN_ADJUST_PRIVILEGES
+    | TOKEN_ADJUST_GROUPS
+    | TOKEN_ADJUST_DEFAULT
+)
+TOKEN_EXECUTE = STANDARD_RIGHTS_EXECUTE
+TOKEN_SOURCE_LENGTH = 8
+
+# Token types
+TokenPrimary = 1
+TokenImpersonation = 2
+
+# TOKEN_INFORMATION_CLASS, used with Get/SetTokenInformation
+TokenUser = 1
+TokenGroups = 2
+TokenPrivileges = 3
+TokenOwner = 4
+TokenPrimaryGroup = 5
+TokenDefaultDacl = 6
+TokenSource = 7
+TokenType = 8
+TokenImpersonationLevel = 9
+TokenStatistics = 10
+TokenRestrictedSids = 11
+TokenSessionId = 12
+TokenGroupsAndPrivileges = 13
+TokenSessionReference = 14
+TokenSandBoxInert = 15
+TokenAuditPolicy = 16
+TokenOrigin = 17
+TokenElevationType = 18
+TokenLinkedToken = 19
+TokenElevation = 20
+TokenHasRestrictions = 21
+TokenAccessInformation = 22
+TokenVirtualizationAllowed = 23
+TokenVirtualizationEnabled = 24
+TokenIntegrityLevel = 25
+TokenUIAccess = 26
+TokenMandatoryPolicy = 27
+TokenLogonSid = 28
+
+OWNER_SECURITY_INFORMATION = 0x00000001
+GROUP_SECURITY_INFORMATION = 0x00000002
+DACL_SECURITY_INFORMATION = 0x00000004
+SACL_SECURITY_INFORMATION = 0x00000008
+LABEL_SECURITY_INFORMATION = 0x00000010
+
+IMAGE_DOS_SIGNATURE = 23117
+IMAGE_OS2_SIGNATURE = 17742
+IMAGE_OS2_SIGNATURE_LE = 17740
+IMAGE_VXD_SIGNATURE = 17740
+IMAGE_NT_SIGNATURE = 17744
+IMAGE_SIZEOF_FILE_HEADER = 20
+IMAGE_FILE_RELOCS_STRIPPED = 1
+IMAGE_FILE_EXECUTABLE_IMAGE = 2
+IMAGE_FILE_LINE_NUMS_STRIPPED = 4
+IMAGE_FILE_LOCAL_SYMS_STRIPPED = 8
+IMAGE_FILE_AGGRESIVE_WS_TRIM = 16
+IMAGE_FILE_LARGE_ADDRESS_AWARE = 32
+IMAGE_FILE_BYTES_REVERSED_LO = 128
+IMAGE_FILE_32BIT_MACHINE = 256
+IMAGE_FILE_DEBUG_STRIPPED = 512
+IMAGE_FILE_REMOVABLE_RUN_FROM_SWAP = 1024
+IMAGE_FILE_NET_RUN_FROM_SWAP = 2048
+IMAGE_FILE_SYSTEM = 4096
+IMAGE_FILE_DLL = 8192
+IMAGE_FILE_UP_SYSTEM_ONLY = 16384
+IMAGE_FILE_BYTES_REVERSED_HI = 32768
+IMAGE_FILE_MACHINE_UNKNOWN = 0
+IMAGE_FILE_MACHINE_I386 = 332
+IMAGE_FILE_MACHINE_R3000 = 354
+IMAGE_FILE_MACHINE_R4000 = 358
+IMAGE_FILE_MACHINE_R10000 = 360
+IMAGE_FILE_MACHINE_WCEMIPSV2 = 361
+IMAGE_FILE_MACHINE_ALPHA = 388
+IMAGE_FILE_MACHINE_POWERPC = 496
+IMAGE_FILE_MACHINE_SH3 = 418
+IMAGE_FILE_MACHINE_SH3E = 420
+IMAGE_FILE_MACHINE_SH4 = 422
+IMAGE_FILE_MACHINE_ARM = 448
+IMAGE_NUMBEROF_DIRECTORY_ENTRIES = 16
+IMAGE_SIZEOF_ROM_OPTIONAL_HEADER = 56
+IMAGE_SIZEOF_STD_OPTIONAL_HEADER = 28
+IMAGE_SIZEOF_NT_OPTIONAL_HEADER = 224
+IMAGE_NT_OPTIONAL_HDR_MAGIC = 267
+IMAGE_ROM_OPTIONAL_HDR_MAGIC = 263
+IMAGE_SUBSYSTEM_UNKNOWN = 0
+IMAGE_SUBSYSTEM_NATIVE = 1
+IMAGE_SUBSYSTEM_WINDOWS_GUI = 2
+IMAGE_SUBSYSTEM_WINDOWS_CUI = 3
+IMAGE_SUBSYSTEM_WINDOWS_CE_GUI = 4
+IMAGE_SUBSYSTEM_OS2_CUI = 5
+IMAGE_SUBSYSTEM_POSIX_CUI = 7
+IMAGE_SUBSYSTEM_RESERVED8 = 8
+IMAGE_DLLCHARACTERISTICS_WDM_DRIVER = 8192
+IMAGE_DIRECTORY_ENTRY_EXPORT = 0
+IMAGE_DIRECTORY_ENTRY_IMPORT = 1
+IMAGE_DIRECTORY_ENTRY_RESOURCE = 2
+IMAGE_DIRECTORY_ENTRY_EXCEPTION = 3
+IMAGE_DIRECTORY_ENTRY_SECURITY = 4
+IMAGE_DIRECTORY_ENTRY_BASERELOC = 5
+IMAGE_DIRECTORY_ENTRY_DEBUG = 6
+IMAGE_DIRECTORY_ENTRY_COPYRIGHT = 7
+IMAGE_DIRECTORY_ENTRY_GLOBALPTR = 8
+IMAGE_DIRECTORY_ENTRY_TLS = 9
+IMAGE_DIRECTORY_ENTRY_LOAD_CONFIG = 10
+IMAGE_DIRECTORY_ENTRY_BOUND_IMPORT = 11
+IMAGE_DIRECTORY_ENTRY_IAT = 12
+IMAGE_SIZEOF_SHORT_NAME = 8
+IMAGE_SIZEOF_SECTION_HEADER = 40
+IMAGE_SCN_TYPE_NO_PAD = 8
+IMAGE_SCN_CNT_CODE = 32
+IMAGE_SCN_CNT_INITIALIZED_DATA = 64
+IMAGE_SCN_CNT_UNINITIALIZED_DATA = 128
+IMAGE_SCN_LNK_OTHER = 256
+IMAGE_SCN_LNK_INFO = 512
+IMAGE_SCN_LNK_REMOVE = 2048
+IMAGE_SCN_LNK_COMDAT = 4096
+IMAGE_SCN_MEM_FARDATA = 32768
+IMAGE_SCN_MEM_PURGEABLE = 131072
+IMAGE_SCN_MEM_16BIT = 131072
+IMAGE_SCN_MEM_LOCKED = 262144
+IMAGE_SCN_MEM_PRELOAD = 524288
+IMAGE_SCN_ALIGN_1BYTES = 1048576
+IMAGE_SCN_ALIGN_2BYTES = 2097152
+IMAGE_SCN_ALIGN_4BYTES = 3145728
+IMAGE_SCN_ALIGN_8BYTES = 4194304
+IMAGE_SCN_ALIGN_16BYTES = 5242880
+IMAGE_SCN_ALIGN_32BYTES = 6291456
+IMAGE_SCN_ALIGN_64BYTES = 7340032
+IMAGE_SCN_LNK_NRELOC_OVFL = 16777216
+IMAGE_SCN_MEM_DISCARDABLE = 33554432
+IMAGE_SCN_MEM_NOT_CACHED = 67108864
+IMAGE_SCN_MEM_NOT_PAGED = 134217728
+IMAGE_SCN_MEM_SHARED = 268435456
+IMAGE_SCN_MEM_EXECUTE = 536870912
+IMAGE_SCN_MEM_READ = 1073741824
+IMAGE_SCN_MEM_WRITE = -2147483648
+IMAGE_SCN_SCALE_INDEX = 1
+IMAGE_SIZEOF_SYMBOL = 18
+IMAGE_SYM_TYPE_NULL = 0
+IMAGE_SYM_TYPE_VOID = 1
+IMAGE_SYM_TYPE_CHAR = 2
+IMAGE_SYM_TYPE_SHORT = 3
+IMAGE_SYM_TYPE_INT = 4
+IMAGE_SYM_TYPE_LONG = 5
+IMAGE_SYM_TYPE_FLOAT = 6
+IMAGE_SYM_TYPE_DOUBLE = 7
+IMAGE_SYM_TYPE_STRUCT = 8
+IMAGE_SYM_TYPE_UNION = 9
+IMAGE_SYM_TYPE_ENUM = 10
+IMAGE_SYM_TYPE_MOE = 11
+IMAGE_SYM_TYPE_BYTE = 12
+IMAGE_SYM_TYPE_WORD = 13
+IMAGE_SYM_TYPE_UINT = 14
+IMAGE_SYM_TYPE_DWORD = 15
+IMAGE_SYM_TYPE_PCODE = 32768
+IMAGE_SYM_DTYPE_NULL = 0
+IMAGE_SYM_DTYPE_POINTER = 1
+IMAGE_SYM_DTYPE_FUNCTION = 2
+IMAGE_SYM_DTYPE_ARRAY = 3
+IMAGE_SYM_CLASS_NULL = 0
+IMAGE_SYM_CLASS_AUTOMATIC = 1
+IMAGE_SYM_CLASS_EXTERNAL = 2
+IMAGE_SYM_CLASS_STATIC = 3
+IMAGE_SYM_CLASS_REGISTER = 4
+IMAGE_SYM_CLASS_EXTERNAL_DEF = 5
+IMAGE_SYM_CLASS_LABEL = 6
+IMAGE_SYM_CLASS_UNDEFINED_LABEL = 7
+IMAGE_SYM_CLASS_MEMBER_OF_STRUCT = 8
+IMAGE_SYM_CLASS_ARGUMENT = 9
+IMAGE_SYM_CLASS_STRUCT_TAG = 10
+IMAGE_SYM_CLASS_MEMBER_OF_UNION = 11
+IMAGE_SYM_CLASS_UNION_TAG = 12
+IMAGE_SYM_CLASS_TYPE_DEFINITION = 13
+IMAGE_SYM_CLASS_UNDEFINED_STATIC = 14
+IMAGE_SYM_CLASS_ENUM_TAG = 15
+IMAGE_SYM_CLASS_MEMBER_OF_ENUM = 16
+IMAGE_SYM_CLASS_REGISTER_PARAM = 17
+IMAGE_SYM_CLASS_BIT_FIELD = 18
+IMAGE_SYM_CLASS_FAR_EXTERNAL = 68
+IMAGE_SYM_CLASS_BLOCK = 100
+IMAGE_SYM_CLASS_FUNCTION = 101
+IMAGE_SYM_CLASS_END_OF_STRUCT = 102
+IMAGE_SYM_CLASS_FILE = 103
+IMAGE_SYM_CLASS_SECTION = 104
+IMAGE_SYM_CLASS_WEAK_EXTERNAL = 105
+N_BTMASK = 15
+N_TMASK = 48
+N_TMASK1 = 192
+N_TMASK2 = 240
+N_BTSHFT = 4
+N_TSHIFT = 2
+
+
+def BTYPE(x):
+    return (x) & N_BTMASK
+
+
+def ISPTR(x):
+    return ((x) & N_TMASK) == (IMAGE_SYM_DTYPE_POINTER << N_BTSHFT)
+
+
+def ISFCN(x):
+    return ((x) & N_TMASK) == (IMAGE_SYM_DTYPE_FUNCTION << N_BTSHFT)
+
+
+def ISARY(x):
+    return ((x) & N_TMASK) == (IMAGE_SYM_DTYPE_ARRAY << N_BTSHFT)
+
+
+def INCREF(x):
+    return (
+        (((x) & ~N_BTMASK) << N_TSHIFT)
+        | (IMAGE_SYM_DTYPE_POINTER << N_BTSHFT)
+        | ((x) & N_BTMASK)
+    )
+
+
+def DECREF(x):
+    return (((x) >> N_TSHIFT) & ~N_BTMASK) | ((x) & N_BTMASK)
+
+
+IMAGE_SIZEOF_AUX_SYMBOL = 18
+IMAGE_COMDAT_SELECT_NODUPLICATES = 1
+IMAGE_COMDAT_SELECT_ANY = 2
+IMAGE_COMDAT_SELECT_SAME_SIZE = 3
+IMAGE_COMDAT_SELECT_EXACT_MATCH = 4
+IMAGE_COMDAT_SELECT_ASSOCIATIVE = 5
+IMAGE_COMDAT_SELECT_LARGEST = 6
+IMAGE_COMDAT_SELECT_NEWEST = 7
+IMAGE_WEAK_EXTERN_SEARCH_NOLIBRARY = 1
+IMAGE_WEAK_EXTERN_SEARCH_LIBRARY = 2
+IMAGE_WEAK_EXTERN_SEARCH_ALIAS = 3
+IMAGE_SIZEOF_RELOCATION = 10
+IMAGE_REL_I386_ABSOLUTE = 0
+IMAGE_REL_I386_DIR16 = 1
+IMAGE_REL_I386_REL16 = 2
+IMAGE_REL_I386_DIR32 = 6
+IMAGE_REL_I386_DIR32NB = 7
+IMAGE_REL_I386_SEG12 = 9
+IMAGE_REL_I386_SECTION = 10
+IMAGE_REL_I386_SECREL = 11
+IMAGE_REL_I386_REL32 = 20
+IMAGE_REL_MIPS_ABSOLUTE = 0
+IMAGE_REL_MIPS_REFHALF = 1
+IMAGE_REL_MIPS_REFWORD = 2
+IMAGE_REL_MIPS_JMPADDR = 3
+IMAGE_REL_MIPS_REFHI = 4
+IMAGE_REL_MIPS_REFLO = 5
+IMAGE_REL_MIPS_GPREL = 6
+IMAGE_REL_MIPS_LITERAL = 7
+IMAGE_REL_MIPS_SECTION = 10
+IMAGE_REL_MIPS_SECREL = 11
+IMAGE_REL_MIPS_SECRELLO = 12
+IMAGE_REL_MIPS_SECRELHI = 13
+IMAGE_REL_MIPS_REFWORDNB = 34
+IMAGE_REL_MIPS_PAIR = 37
+IMAGE_REL_ALPHA_ABSOLUTE = 0
+IMAGE_REL_ALPHA_REFLONG = 1
+IMAGE_REL_ALPHA_REFQUAD = 2
+IMAGE_REL_ALPHA_GPREL32 = 3
+IMAGE_REL_ALPHA_LITERAL = 4
+IMAGE_REL_ALPHA_LITUSE = 5
+IMAGE_REL_ALPHA_GPDISP = 6
+IMAGE_REL_ALPHA_BRADDR = 7
+IMAGE_REL_ALPHA_HINT = 8
+IMAGE_REL_ALPHA_INLINE_REFLONG = 9
+IMAGE_REL_ALPHA_REFHI = 10
+IMAGE_REL_ALPHA_REFLO = 11
+IMAGE_REL_ALPHA_PAIR = 12
+IMAGE_REL_ALPHA_MATCH = 13
+IMAGE_REL_ALPHA_SECTION = 14
+IMAGE_REL_ALPHA_SECREL = 15
+IMAGE_REL_ALPHA_REFLONGNB = 16
+IMAGE_REL_ALPHA_SECRELLO = 17
+IMAGE_REL_ALPHA_SECRELHI = 18
+IMAGE_REL_PPC_ABSOLUTE = 0
+IMAGE_REL_PPC_ADDR64 = 1
+IMAGE_REL_PPC_ADDR32 = 2
+IMAGE_REL_PPC_ADDR24 = 3
+IMAGE_REL_PPC_ADDR16 = 4
+IMAGE_REL_PPC_ADDR14 = 5
+IMAGE_REL_PPC_REL24 = 6
+IMAGE_REL_PPC_REL14 = 7
+IMAGE_REL_PPC_TOCREL16 = 8
+IMAGE_REL_PPC_TOCREL14 = 9
+IMAGE_REL_PPC_ADDR32NB = 10
+IMAGE_REL_PPC_SECREL = 11
+IMAGE_REL_PPC_SECTION = 12
+IMAGE_REL_PPC_IFGLUE = 13
+IMAGE_REL_PPC_IMGLUE = 14
+IMAGE_REL_PPC_SECREL16 = 15
+IMAGE_REL_PPC_REFHI = 16
+IMAGE_REL_PPC_REFLO = 17
+IMAGE_REL_PPC_PAIR = 18
+IMAGE_REL_PPC_SECRELLO = 19
+IMAGE_REL_PPC_SECRELHI = 20
+IMAGE_REL_PPC_TYPEMASK = 255
+IMAGE_REL_PPC_NEG = 256
+IMAGE_REL_PPC_BRTAKEN = 512
+IMAGE_REL_PPC_BRNTAKEN = 1024
+IMAGE_REL_PPC_TOCDEFN = 2048
+IMAGE_REL_SH3_ABSOLUTE = 0
+IMAGE_REL_SH3_DIRECT16 = 1
+IMAGE_REL_SH3_DIRECT32 = 2
+IMAGE_REL_SH3_DIRECT8 = 3
+IMAGE_REL_SH3_DIRECT8_WORD = 4
+IMAGE_REL_SH3_DIRECT8_LONG = 5
+IMAGE_REL_SH3_DIRECT4 = 6
+IMAGE_REL_SH3_DIRECT4_WORD = 7
+IMAGE_REL_SH3_DIRECT4_LONG = 8
+IMAGE_REL_SH3_PCREL8_WORD = 9
+IMAGE_REL_SH3_PCREL8_LONG = 10
+IMAGE_REL_SH3_PCREL12_WORD = 11
+IMAGE_REL_SH3_STARTOF_SECTION = 12
+IMAGE_REL_SH3_SIZEOF_SECTION = 13
+IMAGE_REL_SH3_SECTION = 14
+IMAGE_REL_SH3_SECREL = 15
+IMAGE_REL_SH3_DIRECT32_NB = 16
+IMAGE_SIZEOF_LINENUMBER = 6
+IMAGE_SIZEOF_BASE_RELOCATION = 8
+IMAGE_REL_BASED_ABSOLUTE = 0
+IMAGE_REL_BASED_HIGH = 1
+IMAGE_REL_BASED_LOW = 2
+IMAGE_REL_BASED_HIGHLOW = 3
+IMAGE_REL_BASED_HIGHADJ = 4
+IMAGE_REL_BASED_MIPS_JMPADDR = 5
+IMAGE_REL_BASED_SECTION = 6
+IMAGE_REL_BASED_REL32 = 7
+IMAGE_ARCHIVE_START_SIZE = 8
+IMAGE_ARCHIVE_START = "!<arch>\n"
+IMAGE_ARCHIVE_END = "`\n"
+IMAGE_ARCHIVE_PAD = "\n"
+IMAGE_ARCHIVE_LINKER_MEMBER = "/               "
+IMAGE_SIZEOF_ARCHIVE_MEMBER_HDR = 60
+IMAGE_ORDINAL_FLAG = -2147483648
+
+
+def IMAGE_SNAP_BY_ORDINAL(Ordina):
+    return (Ordinal & IMAGE_ORDINAL_FLAG) != 0
+
+
+def IMAGE_ORDINAL(Ordina):
+    return Ordinal & 65535
+
+
+IMAGE_RESOURCE_NAME_IS_STRING = -2147483648
+IMAGE_RESOURCE_DATA_IS_DIRECTORY = -2147483648
+IMAGE_DEBUG_TYPE_UNKNOWN = 0
+IMAGE_DEBUG_TYPE_COFF = 1
+IMAGE_DEBUG_TYPE_CODEVIEW = 2
+IMAGE_DEBUG_TYPE_FPO = 3
+IMAGE_DEBUG_TYPE_MISC = 4
+IMAGE_DEBUG_TYPE_EXCEPTION = 5
+IMAGE_DEBUG_TYPE_FIXUP = 6
+IMAGE_DEBUG_TYPE_OMAP_TO_SRC = 7
+IMAGE_DEBUG_TYPE_OMAP_FROM_SRC = 8
+IMAGE_DEBUG_TYPE_BORLAND = 9
+FRAME_FPO = 0
+FRAME_TRAP = 1
+FRAME_TSS = 2
+FRAME_NONFPO = 3
+SIZEOF_RFPO_DATA = 16
+IMAGE_DEBUG_MISC_EXENAME = 1
+IMAGE_SEPARATE_DEBUG_SIGNATURE = 18756
+IMAGE_SEPARATE_DEBUG_FLAGS_MASK = 32768
+IMAGE_SEPARATE_DEBUG_MISMATCH = 32768
+
+# Included from string.h
+_NLSCMPERROR = 2147483647
+NULL = 0
+HEAP_NO_SERIALIZE = 1
+HEAP_GROWABLE = 2
+HEAP_GENERATE_EXCEPTIONS = 4
+HEAP_ZERO_MEMORY = 8
+HEAP_REALLOC_IN_PLACE_ONLY = 16
+HEAP_TAIL_CHECKING_ENABLED = 32
+HEAP_FREE_CHECKING_ENABLED = 64
+HEAP_DISABLE_COALESCE_ON_FREE = 128
+HEAP_CREATE_ALIGN_16 = 65536
+HEAP_CREATE_ENABLE_TRACING = 131072
+HEAP_MAXIMUM_TAG = 4095
+HEAP_PSEUDO_TAG_FLAG = 32768
+HEAP_TAG_SHIFT = 16
+IS_TEXT_UNICODE_ASCII16 = 1
+IS_TEXT_UNICODE_REVERSE_ASCII16 = 16
+IS_TEXT_UNICODE_STATISTICS = 2
+IS_TEXT_UNICODE_REVERSE_STATISTICS = 32
+IS_TEXT_UNICODE_CONTROLS = 4
+IS_TEXT_UNICODE_REVERSE_CONTROLS = 64
+IS_TEXT_UNICODE_SIGNATURE = 8
+IS_TEXT_UNICODE_REVERSE_SIGNATURE = 128
+IS_TEXT_UNICODE_ILLEGAL_CHARS = 256
+IS_TEXT_UNICODE_ODD_LENGTH = 512
+IS_TEXT_UNICODE_DBCS_LEADBYTE = 1024
+IS_TEXT_UNICODE_NULL_BYTES = 4096
+IS_TEXT_UNICODE_UNICODE_MASK = 15
+IS_TEXT_UNICODE_REVERSE_MASK = 240
+IS_TEXT_UNICODE_NOT_UNICODE_MASK = 3840
+IS_TEXT_UNICODE_NOT_ASCII_MASK = 61440
+COMPRESSION_FORMAT_NONE = 0
+COMPRESSION_FORMAT_DEFAULT = 1
+COMPRESSION_FORMAT_LZNT1 = 2
+COMPRESSION_ENGINE_STANDARD = 0
+COMPRESSION_ENGINE_MAXIMUM = 256
+MESSAGE_RESOURCE_UNICODE = 1
+RTL_CRITSECT_TYPE = 0
+RTL_RESOURCE_TYPE = 1
+SEF_DACL_AUTO_INHERIT = 1
+SEF_SACL_AUTO_INHERIT = 2
+SEF_DEFAULT_DESCRIPTOR_FOR_OBJECT = 4
+SEF_AVOID_PRIVILEGE_CHECK = 8
+DLL_PROCESS_ATTACH = 1
+DLL_THREAD_ATTACH = 2
+DLL_THREAD_DETACH = 3
+DLL_PROCESS_DETACH = 0
+EVENTLOG_SEQUENTIAL_READ = 0x0001
+EVENTLOG_SEEK_READ = 0x0002
+EVENTLOG_FORWARDS_READ = 0x0004
+EVENTLOG_BACKWARDS_READ = 0x0008
+EVENTLOG_SUCCESS = 0x0000
+EVENTLOG_ERROR_TYPE = 1
+EVENTLOG_WARNING_TYPE = 2
+EVENTLOG_INFORMATION_TYPE = 4
+EVENTLOG_AUDIT_SUCCESS = 8
+EVENTLOG_AUDIT_FAILURE = 16
+EVENTLOG_START_PAIRED_EVENT = 1
+EVENTLOG_END_PAIRED_EVENT = 2
+EVENTLOG_END_ALL_PAIRED_EVENTS = 4
+EVENTLOG_PAIRED_EVENT_ACTIVE = 8
+EVENTLOG_PAIRED_EVENT_INACTIVE = 16
+KEY_QUERY_VALUE = 1
+KEY_SET_VALUE = 2
+KEY_CREATE_SUB_KEY = 4
+KEY_ENUMERATE_SUB_KEYS = 8
+KEY_NOTIFY = 16
+KEY_CREATE_LINK = 32
+KEY_READ = (
+    STANDARD_RIGHTS_READ | KEY_QUERY_VALUE | KEY_ENUMERATE_SUB_KEYS | KEY_NOTIFY
+) & (~SYNCHRONIZE)
+KEY_WRITE = (STANDARD_RIGHTS_WRITE | KEY_SET_VALUE | KEY_CREATE_SUB_KEY) & (
+    ~SYNCHRONIZE
+)
+KEY_EXECUTE = (KEY_READ) & (~SYNCHRONIZE)
+KEY_ALL_ACCESS = (
+    STANDARD_RIGHTS_ALL
+    | KEY_QUERY_VALUE
+    | KEY_SET_VALUE
+    | KEY_CREATE_SUB_KEY
+    | KEY_ENUMERATE_SUB_KEYS
+    | KEY_NOTIFY
+    | KEY_CREATE_LINK
+) & (~SYNCHRONIZE)
+REG_OPTION_RESERVED = 0
+REG_OPTION_NON_VOLATILE = 0
+REG_OPTION_VOLATILE = 1
+REG_OPTION_CREATE_LINK = 2
+REG_OPTION_BACKUP_RESTORE = 4
+REG_OPTION_OPEN_LINK = 8
+REG_LEGAL_OPTION = (
+    REG_OPTION_RESERVED
+    | REG_OPTION_NON_VOLATILE
+    | REG_OPTION_VOLATILE
+    | REG_OPTION_CREATE_LINK
+    | REG_OPTION_BACKUP_RESTORE
+    | REG_OPTION_OPEN_LINK
+)
+
+## dispositions returned from RegCreateKeyEx
+REG_CREATED_NEW_KEY = 1
+REG_OPENED_EXISTING_KEY = 2
+
+## flags used with RegSaveKeyEx
+REG_STANDARD_FORMAT = 1
+REG_LATEST_FORMAT = 2
+REG_NO_COMPRESSION = 4
+
+## flags used with RegRestoreKey
+REG_WHOLE_HIVE_VOLATILE = 1
+REG_REFRESH_HIVE = 2
+REG_NO_LAZY_FLUSH = 4
+REG_FORCE_RESTORE = 8
+
+REG_NOTIFY_CHANGE_NAME = 1
+REG_NOTIFY_CHANGE_ATTRIBUTES = 2
+REG_NOTIFY_CHANGE_LAST_SET = 4
+REG_NOTIFY_CHANGE_SECURITY = 8
+REG_LEGAL_CHANGE_FILTER = (
+    REG_NOTIFY_CHANGE_NAME
+    | REG_NOTIFY_CHANGE_ATTRIBUTES
+    | REG_NOTIFY_CHANGE_LAST_SET
+    | REG_NOTIFY_CHANGE_SECURITY
+)
+REG_NONE = 0
+REG_SZ = 1
+REG_EXPAND_SZ = 2
+REG_BINARY = 3
+REG_DWORD = 4
+REG_DWORD_LITTLE_ENDIAN = 4
+REG_DWORD_BIG_ENDIAN = 5
+REG_LINK = 6
+REG_MULTI_SZ = 7
+REG_RESOURCE_LIST = 8
+REG_FULL_RESOURCE_DESCRIPTOR = 9
+REG_RESOURCE_REQUIREMENTS_LIST = 10
+SERVICE_KERNEL_DRIVER = 1
+SERVICE_FILE_SYSTEM_DRIVER = 2
+SERVICE_ADAPTER = 4
+SERVICE_RECOGNIZER_DRIVER = 8
+SERVICE_DRIVER = (
+    SERVICE_KERNEL_DRIVER | SERVICE_FILE_SYSTEM_DRIVER | SERVICE_RECOGNIZER_DRIVER
+)
+SERVICE_WIN32_OWN_PROCESS = 16
+SERVICE_WIN32_SHARE_PROCESS = 32
+SERVICE_WIN32 = SERVICE_WIN32_OWN_PROCESS | SERVICE_WIN32_SHARE_PROCESS
+SERVICE_INTERACTIVE_PROCESS = 256
+SERVICE_TYPE_ALL = (
+    SERVICE_WIN32 | SERVICE_ADAPTER | SERVICE_DRIVER | SERVICE_INTERACTIVE_PROCESS
+)
+SERVICE_BOOT_START = 0
+SERVICE_SYSTEM_START = 1
+SERVICE_AUTO_START = 2
+SERVICE_DEMAND_START = 3
+SERVICE_DISABLED = 4
+SERVICE_ERROR_IGNORE = 0
+SERVICE_ERROR_NORMAL = 1
+SERVICE_ERROR_SEVERE = 2
+SERVICE_ERROR_CRITICAL = 3
+TAPE_ERASE_SHORT = 0
+TAPE_ERASE_LONG = 1
+TAPE_LOAD = 0
+TAPE_UNLOAD = 1
+TAPE_TENSION = 2
+TAPE_LOCK = 3
+TAPE_UNLOCK = 4
+TAPE_FORMAT = 5
+TAPE_SETMARKS = 0
+TAPE_FILEMARKS = 1
+TAPE_SHORT_FILEMARKS = 2
+TAPE_LONG_FILEMARKS = 3
+TAPE_ABSOLUTE_POSITION = 0
+TAPE_LOGICAL_POSITION = 1
+TAPE_PSEUDO_LOGICAL_POSITION = 2
+TAPE_REWIND = 0
+TAPE_ABSOLUTE_BLOCK = 1
+TAPE_LOGICAL_BLOCK = 2
+TAPE_PSEUDO_LOGICAL_BLOCK = 3
+TAPE_SPACE_END_OF_DATA = 4
+TAPE_SPACE_RELATIVE_BLOCKS = 5
+TAPE_SPACE_FILEMARKS = 6
+TAPE_SPACE_SEQUENTIAL_FMKS = 7
+TAPE_SPACE_SETMARKS = 8
+TAPE_SPACE_SEQUENTIAL_SMKS = 9
+TAPE_DRIVE_FIXED = 1
+TAPE_DRIVE_SELECT = 2
+TAPE_DRIVE_INITIATOR = 4
+TAPE_DRIVE_ERASE_SHORT = 16
+TAPE_DRIVE_ERASE_LONG = 32
+TAPE_DRIVE_ERASE_BOP_ONLY = 64
+TAPE_DRIVE_ERASE_IMMEDIATE = 128
+TAPE_DRIVE_TAPE_CAPACITY = 256
+TAPE_DRIVE_TAPE_REMAINING = 512
+TAPE_DRIVE_FIXED_BLOCK = 1024
+TAPE_DRIVE_VARIABLE_BLOCK = 2048
+TAPE_DRIVE_WRITE_PROTECT = 4096
+TAPE_DRIVE_EOT_WZ_SIZE = 8192
+TAPE_DRIVE_ECC = 65536
+TAPE_DRIVE_COMPRESSION = 131072
+TAPE_DRIVE_PADDING = 262144
+TAPE_DRIVE_REPORT_SMKS = 524288
+TAPE_DRIVE_GET_ABSOLUTE_BLK = 1048576
+TAPE_DRIVE_GET_LOGICAL_BLK = 2097152
+TAPE_DRIVE_SET_EOT_WZ_SIZE = 4194304
+TAPE_DRIVE_EJECT_MEDIA = 16777216
+TAPE_DRIVE_RESERVED_BIT = -2147483648
+TAPE_DRIVE_LOAD_UNLOAD = -2147483647
+TAPE_DRIVE_TENSION = -2147483646
+TAPE_DRIVE_LOCK_UNLOCK = -2147483644
+TAPE_DRIVE_REWIND_IMMEDIATE = -2147483640
+TAPE_DRIVE_SET_BLOCK_SIZE = -2147483632
+TAPE_DRIVE_LOAD_UNLD_IMMED = -2147483616
+TAPE_DRIVE_TENSION_IMMED = -2147483584
+TAPE_DRIVE_LOCK_UNLK_IMMED = -2147483520
+TAPE_DRIVE_SET_ECC = -2147483392
+TAPE_DRIVE_SET_COMPRESSION = -2147483136
+TAPE_DRIVE_SET_PADDING = -2147482624
+TAPE_DRIVE_SET_REPORT_SMKS = -2147481600
+TAPE_DRIVE_ABSOLUTE_BLK = -2147479552
+TAPE_DRIVE_ABS_BLK_IMMED = -2147475456
+TAPE_DRIVE_LOGICAL_BLK = -2147467264
+TAPE_DRIVE_LOG_BLK_IMMED = -2147450880
+TAPE_DRIVE_END_OF_DATA = -2147418112
+TAPE_DRIVE_RELATIVE_BLKS = -2147352576
+TAPE_DRIVE_FILEMARKS = -2147221504
+TAPE_DRIVE_SEQUENTIAL_FMKS = -2146959360
+TAPE_DRIVE_SETMARKS = -2146435072
+TAPE_DRIVE_SEQUENTIAL_SMKS = -2145386496
+TAPE_DRIVE_REVERSE_POSITION = -2143289344
+TAPE_DRIVE_SPACE_IMMEDIATE = -2139095040
+TAPE_DRIVE_WRITE_SETMARKS = -2130706432
+TAPE_DRIVE_WRITE_FILEMARKS = -2113929216
+TAPE_DRIVE_WRITE_SHORT_FMKS = -2080374784
+TAPE_DRIVE_WRITE_LONG_FMKS = -2013265920
+TAPE_DRIVE_WRITE_MARK_IMMED = -1879048192
+TAPE_DRIVE_FORMAT = -1610612736
+TAPE_DRIVE_FORMAT_IMMEDIATE = -1073741824
+TAPE_DRIVE_HIGH_FEATURES = -2147483648
+TAPE_FIXED_PARTITIONS = 0
+TAPE_SELECT_PARTITIONS = 1
+TAPE_INITIATOR_PARTITIONS = 2
+
+TRANSACTIONMANAGER_QUERY_INFORMATION = 0x0001
+TRANSACTIONMANAGER_SET_INFORMATION = 0x0002
+TRANSACTIONMANAGER_RECOVER = 0x0004
+TRANSACTIONMANAGER_RENAME = 0x0008
+TRANSACTIONMANAGER_CREATE_RM = 0x0010
+TRANSACTIONMANAGER_BIND_TRANSACTION = 0x0020
+TRANSACTIONMANAGER_GENERIC_READ = (
+    STANDARD_RIGHTS_READ | TRANSACTIONMANAGER_QUERY_INFORMATION
+)
+TRANSACTIONMANAGER_GENERIC_WRITE = (
+    STANDARD_RIGHTS_WRITE
+    | TRANSACTIONMANAGER_SET_INFORMATION
+    | TRANSACTIONMANAGER_RECOVER
+    | TRANSACTIONMANAGER_RENAME
+    | TRANSACTIONMANAGER_CREATE_RM
+)
+TRANSACTIONMANAGER_GENERIC_EXECUTE = STANDARD_RIGHTS_EXECUTE
+TRANSACTIONMANAGER_ALL_ACCESS = (
+    STANDARD_RIGHTS_REQUIRED
+    | TRANSACTIONMANAGER_GENERIC_READ
+    | TRANSACTIONMANAGER_GENERIC_WRITE
+    | TRANSACTIONMANAGER_GENERIC_EXECUTE
+    | TRANSACTIONMANAGER_BIND_TRANSACTION
+)
+
+TRANSACTION_QUERY_INFORMATION = 0x0001
+TRANSACTION_SET_INFORMATION = 0x0002
+TRANSACTION_ENLIST = 0x0004
+TRANSACTION_COMMIT = 0x0008
+TRANSACTION_ROLLBACK = 0x0010
+TRANSACTION_PROPAGATE = 0x0020
+TRANSACTION_SAVEPOINT = 0x0040
+TRANSACTION_MARSHALL = TRANSACTION_QUERY_INFORMATION
+TRANSACTION_GENERIC_READ = (
+    STANDARD_RIGHTS_READ | TRANSACTION_QUERY_INFORMATION | SYNCHRONIZE
+)
+TRANSACTION_GENERIC_WRITE = (
+    STANDARD_RIGHTS_WRITE
+    | TRANSACTION_SET_INFORMATION
+    | TRANSACTION_COMMIT
+    | TRANSACTION_ENLIST
+    | TRANSACTION_ROLLBACK
+    | TRANSACTION_PROPAGATE
+    | TRANSACTION_SAVEPOINT
+    | SYNCHRONIZE
+)
+TRANSACTION_GENERIC_EXECUTE = (
+    STANDARD_RIGHTS_EXECUTE | TRANSACTION_COMMIT | TRANSACTION_ROLLBACK | SYNCHRONIZE
+)
+TRANSACTION_ALL_ACCESS = (
+    STANDARD_RIGHTS_REQUIRED
+    | TRANSACTION_GENERIC_READ
+    | TRANSACTION_GENERIC_WRITE
+    | TRANSACTION_GENERIC_EXECUTE
+)
+TRANSACTION_RESOURCE_MANAGER_RIGHTS = (
+    TRANSACTION_GENERIC_READ
+    | STANDARD_RIGHTS_WRITE
+    | TRANSACTION_SET_INFORMATION
+    | TRANSACTION_ENLIST
+    | TRANSACTION_ROLLBACK
+    | TRANSACTION_PROPAGATE
+    | SYNCHRONIZE
+)
+
+RESOURCEMANAGER_QUERY_INFORMATION = 0x0001
+RESOURCEMANAGER_SET_INFORMATION = 0x0002
+RESOURCEMANAGER_RECOVER = 0x0004
+RESOURCEMANAGER_ENLIST = 0x0008
+RESOURCEMANAGER_GET_NOTIFICATION = 0x0010
+RESOURCEMANAGER_REGISTER_PROTOCOL = 0x0020
+RESOURCEMANAGER_COMPLETE_PROPAGATION = 0x0040
+RESOURCEMANAGER_GENERIC_READ = (
+    STANDARD_RIGHTS_READ | RESOURCEMANAGER_QUERY_INFORMATION | SYNCHRONIZE
+)
+RESOURCEMANAGER_GENERIC_WRITE = (
+    STANDARD_RIGHTS_WRITE
+    | RESOURCEMANAGER_SET_INFORMATION
+    | RESOURCEMANAGER_RECOVER
+    | RESOURCEMANAGER_ENLIST
+    | RESOURCEMANAGER_GET_NOTIFICATION
+    | RESOURCEMANAGER_REGISTER_PROTOCOL
+    | RESOURCEMANAGER_COMPLETE_PROPAGATION
+    | SYNCHRONIZE
+)
+RESOURCEMANAGER_GENERIC_EXECUTE = (
+    STANDARD_RIGHTS_EXECUTE
+    | RESOURCEMANAGER_RECOVER
+    | RESOURCEMANAGER_ENLIST
+    | RESOURCEMANAGER_GET_NOTIFICATION
+    | RESOURCEMANAGER_COMPLETE_PROPAGATION
+    | SYNCHRONIZE
+)
+RESOURCEMANAGER_ALL_ACCESS = (
+    STANDARD_RIGHTS_REQUIRED
+    | RESOURCEMANAGER_GENERIC_READ
+    | RESOURCEMANAGER_GENERIC_WRITE
+    | RESOURCEMANAGER_GENERIC_EXECUTE
+)
+
+ENLISTMENT_QUERY_INFORMATION = 0x0001
+ENLISTMENT_SET_INFORMATION = 0x0002
+ENLISTMENT_RECOVER = 0x0004
+ENLISTMENT_SUBORDINATE_RIGHTS = 0x0008
+ENLISTMENT_SUPERIOR_RIGHTS = 0x0010
+ENLISTMENT_GENERIC_READ = STANDARD_RIGHTS_READ | ENLISTMENT_QUERY_INFORMATION
+ENLISTMENT_GENERIC_WRITE = (
+    STANDARD_RIGHTS_WRITE
+    | ENLISTMENT_SET_INFORMATION
+    | ENLISTMENT_RECOVER
+    | ENLISTMENT_SUBORDINATE_RIGHTS
+    | ENLISTMENT_SUPERIOR_RIGHTS
+)
+ENLISTMENT_GENERIC_EXECUTE = (
+    STANDARD_RIGHTS_EXECUTE
+    | ENLISTMENT_RECOVER
+    | ENLISTMENT_SUBORDINATE_RIGHTS
+    | ENLISTMENT_SUPERIOR_RIGHTS
+)
+ENLISTMENT_ALL_ACCESS = (
+    STANDARD_RIGHTS_REQUIRED
+    | ENLISTMENT_GENERIC_READ
+    | ENLISTMENT_GENERIC_WRITE
+    | ENLISTMENT_GENERIC_EXECUTE
+)
+
+
+## TRANSACTION_OUTCOME enum
+TransactionOutcomeUndetermined = 1
+TransactionOutcomeCommitted = 2
+TransactionOutcomeAborted = 3
+
+## TRANSACTION_STATE enum
+TransactionStateNormal = 1
+TransactionStateIndoubt = 2
+TransactionStateCommittedNotify = 3
+
+## TRANSACTION_INFORMATION_CLASS enum
+TransactionBasicInformation = 0
+TransactionPropertiesInformation = 1
+TransactionEnlistmentInformation = 2
+TransactionFullInformation = 3
+
+## TRANSACTIONMANAGER_INFORMATION_CLASS enum
+TransactionManagerBasicInformation = 0
+TransactionManagerLogInformation = 1
+TransactionManagerLogPathInformation = 2
+TransactionManagerOnlineProbeInformation = 3
+
+## RESOURCEMANAGER_INFORMATION_CLASS ENUM
+ResourceManagerBasicInformation = 0
+ResourceManagerCompletionInformation = 1
+ResourceManagerFullInformation = 2
+ResourceManagerNameInformation = 3
+
+## ENLISTMENT_INFORMATION_CLASS enum
+EnlistmentBasicInformation = 0
+EnlistmentRecoveryInformation = 1
+EnlistmentFullInformation = 2
+EnlistmentNameInformation = 3
+
+## KTMOBJECT_TYPE enum
+KTMOBJECT_TRANSACTION = 0
+KTMOBJECT_TRANSACTION_MANAGER = 1
+KTMOBJECT_RESOURCE_MANAGER = 2
+KTMOBJECT_ENLISTMENT = 3
+KTMOBJECT_INVALID = 4
diff --git a/lib/win32/lib/winperf.py b/lib/win32/lib/winperf.py
new file mode 100644
index 00000000..403f67c1
--- /dev/null
+++ b/lib/win32/lib/winperf.py
@@ -0,0 +1,236 @@
+# Generated by h2py from winperf.h
+PERF_DATA_VERSION = 1
+PERF_DATA_REVISION = 1
+PERF_NO_INSTANCES = -1
+PERF_SIZE_DWORD = 0x00000000
+PERF_SIZE_LARGE = 0x00000100
+PERF_SIZE_ZERO = 0x00000200
+PERF_SIZE_VARIABLE_LEN = 0x00000300
+PERF_TYPE_NUMBER = 0x00000000
+PERF_TYPE_COUNTER = 0x00000400
+PERF_TYPE_TEXT = 0x00000800
+PERF_TYPE_ZERO = 0x00000C00
+PERF_NUMBER_HEX = 0x00000000
+PERF_NUMBER_DECIMAL = 0x00010000
+PERF_NUMBER_DEC_1000 = 0x00020000
+PERF_COUNTER_VALUE = 0x00000000
+PERF_COUNTER_RATE = 0x00010000
+PERF_COUNTER_FRACTION = 0x00020000
+PERF_COUNTER_BASE = 0x00030000
+PERF_COUNTER_ELAPSED = 0x00040000
+PERF_COUNTER_QUEUELEN = 0x00050000
+PERF_COUNTER_HISTOGRAM = 0x00060000
+PERF_TEXT_UNICODE = 0x00000000
+PERF_TEXT_ASCII = 0x00010000
+PERF_TIMER_TICK = 0x00000000
+PERF_TIMER_100NS = 0x00100000
+PERF_OBJECT_TIMER = 0x00200000
+PERF_DELTA_COUNTER = 0x00400000
+PERF_DELTA_BASE = 0x00800000
+PERF_INVERSE_COUNTER = 0x01000000
+PERF_MULTI_COUNTER = 0x02000000
+PERF_DISPLAY_NO_SUFFIX = 0x00000000
+PERF_DISPLAY_PER_SEC = 0x10000000
+PERF_DISPLAY_PERCENT = 0x20000000
+PERF_DISPLAY_SECONDS = 0x30000000
+PERF_DISPLAY_NOSHOW = 0x40000000
+PERF_COUNTER_COUNTER = (
+    PERF_SIZE_DWORD
+    | PERF_TYPE_COUNTER
+    | PERF_COUNTER_RATE
+    | PERF_TIMER_TICK
+    | PERF_DELTA_COUNTER
+    | PERF_DISPLAY_PER_SEC
+)
+PERF_COUNTER_TIMER = (
+    PERF_SIZE_LARGE
+    | PERF_TYPE_COUNTER
+    | PERF_COUNTER_RATE
+    | PERF_TIMER_TICK
+    | PERF_DELTA_COUNTER
+    | PERF_DISPLAY_PERCENT
+)
+PERF_COUNTER_QUEUELEN_TYPE = (
+    PERF_SIZE_DWORD
+    | PERF_TYPE_COUNTER
+    | PERF_COUNTER_QUEUELEN
+    | PERF_TIMER_TICK
+    | PERF_DELTA_COUNTER
+    | PERF_DISPLAY_NO_SUFFIX
+)
+PERF_COUNTER_LARGE_QUEUELEN_TYPE = (
+    PERF_SIZE_LARGE
+    | PERF_TYPE_COUNTER
+    | PERF_COUNTER_QUEUELEN
+    | PERF_TIMER_TICK
+    | PERF_DELTA_COUNTER
+    | PERF_DISPLAY_NO_SUFFIX
+)
+PERF_COUNTER_BULK_COUNT = (
+    PERF_SIZE_LARGE
+    | PERF_TYPE_COUNTER
+    | PERF_COUNTER_RATE
+    | PERF_TIMER_TICK
+    | PERF_DELTA_COUNTER
+    | PERF_DISPLAY_PER_SEC
+)
+PERF_COUNTER_TEXT = (
+    PERF_SIZE_VARIABLE_LEN | PERF_TYPE_TEXT | PERF_TEXT_UNICODE | PERF_DISPLAY_NO_SUFFIX
+)
+PERF_COUNTER_RAWCOUNT = (
+    PERF_SIZE_DWORD | PERF_TYPE_NUMBER | PERF_NUMBER_DECIMAL | PERF_DISPLAY_NO_SUFFIX
+)
+PERF_COUNTER_LARGE_RAWCOUNT = (
+    PERF_SIZE_LARGE | PERF_TYPE_NUMBER | PERF_NUMBER_DECIMAL | PERF_DISPLAY_NO_SUFFIX
+)
+PERF_COUNTER_RAWCOUNT_HEX = (
+    PERF_SIZE_DWORD | PERF_TYPE_NUMBER | PERF_NUMBER_HEX | PERF_DISPLAY_NO_SUFFIX
+)
+PERF_COUNTER_LARGE_RAWCOUNT_HEX = (
+    PERF_SIZE_LARGE | PERF_TYPE_NUMBER | PERF_NUMBER_HEX | PERF_DISPLAY_NO_SUFFIX
+)
+PERF_SAMPLE_FRACTION = (
+    PERF_SIZE_DWORD
+    | PERF_TYPE_COUNTER
+    | PERF_COUNTER_FRACTION
+    | PERF_DELTA_COUNTER
+    | PERF_DELTA_BASE
+    | PERF_DISPLAY_PERCENT
+)
+PERF_SAMPLE_COUNTER = (
+    PERF_SIZE_DWORD
+    | PERF_TYPE_COUNTER
+    | PERF_COUNTER_RATE
+    | PERF_TIMER_TICK
+    | PERF_DELTA_COUNTER
+    | PERF_DISPLAY_NO_SUFFIX
+)
+PERF_COUNTER_NODATA = PERF_SIZE_ZERO | PERF_DISPLAY_NOSHOW
+PERF_COUNTER_TIMER_INV = (
+    PERF_SIZE_LARGE
+    | PERF_TYPE_COUNTER
+    | PERF_COUNTER_RATE
+    | PERF_TIMER_TICK
+    | PERF_DELTA_COUNTER
+    | PERF_INVERSE_COUNTER
+    | PERF_DISPLAY_PERCENT
+)
+PERF_SAMPLE_BASE = (
+    PERF_SIZE_DWORD
+    | PERF_TYPE_COUNTER
+    | PERF_COUNTER_BASE
+    | PERF_DISPLAY_NOSHOW
+    | 0x00000001
+)
+PERF_AVERAGE_TIMER = (
+    PERF_SIZE_DWORD | PERF_TYPE_COUNTER | PERF_COUNTER_FRACTION | PERF_DISPLAY_SECONDS
+)
+PERF_AVERAGE_BASE = (
+    PERF_SIZE_DWORD
+    | PERF_TYPE_COUNTER
+    | PERF_COUNTER_BASE
+    | PERF_DISPLAY_NOSHOW
+    | 0x00000002
+)
+PERF_AVERAGE_BULK = (
+    PERF_SIZE_LARGE | PERF_TYPE_COUNTER | PERF_COUNTER_FRACTION | PERF_DISPLAY_NOSHOW
+)
+PERF_100NSEC_TIMER = (
+    PERF_SIZE_LARGE
+    | PERF_TYPE_COUNTER
+    | PERF_COUNTER_RATE
+    | PERF_TIMER_100NS
+    | PERF_DELTA_COUNTER
+    | PERF_DISPLAY_PERCENT
+)
+PERF_100NSEC_TIMER_INV = (
+    PERF_SIZE_LARGE
+    | PERF_TYPE_COUNTER
+    | PERF_COUNTER_RATE
+    | PERF_TIMER_100NS
+    | PERF_DELTA_COUNTER
+    | PERF_INVERSE_COUNTER
+    | PERF_DISPLAY_PERCENT
+)
+PERF_COUNTER_MULTI_TIMER = (
+    PERF_SIZE_LARGE
+    | PERF_TYPE_COUNTER
+    | PERF_COUNTER_RATE
+    | PERF_DELTA_COUNTER
+    | PERF_TIMER_TICK
+    | PERF_MULTI_COUNTER
+    | PERF_DISPLAY_PERCENT
+)
+PERF_COUNTER_MULTI_TIMER_INV = (
+    PERF_SIZE_LARGE
+    | PERF_TYPE_COUNTER
+    | PERF_COUNTER_RATE
+    | PERF_DELTA_COUNTER
+    | PERF_MULTI_COUNTER
+    | PERF_TIMER_TICK
+    | PERF_INVERSE_COUNTER
+    | PERF_DISPLAY_PERCENT
+)
+PERF_COUNTER_MULTI_BASE = (
+    PERF_SIZE_LARGE
+    | PERF_TYPE_COUNTER
+    | PERF_COUNTER_BASE
+    | PERF_MULTI_COUNTER
+    | PERF_DISPLAY_NOSHOW
+)
+PERF_100NSEC_MULTI_TIMER = (
+    PERF_SIZE_LARGE
+    | PERF_TYPE_COUNTER
+    | PERF_DELTA_COUNTER
+    | PERF_COUNTER_RATE
+    | PERF_TIMER_100NS
+    | PERF_MULTI_COUNTER
+    | PERF_DISPLAY_PERCENT
+)
+PERF_100NSEC_MULTI_TIMER_INV = (
+    PERF_SIZE_LARGE
+    | PERF_TYPE_COUNTER
+    | PERF_DELTA_COUNTER
+    | PERF_COUNTER_RATE
+    | PERF_TIMER_100NS
+    | PERF_MULTI_COUNTER
+    | PERF_INVERSE_COUNTER
+    | PERF_DISPLAY_PERCENT
+)
+PERF_RAW_FRACTION = (
+    PERF_SIZE_DWORD | PERF_TYPE_COUNTER | PERF_COUNTER_FRACTION | PERF_DISPLAY_PERCENT
+)
+PERF_RAW_BASE = (
+    PERF_SIZE_DWORD
+    | PERF_TYPE_COUNTER
+    | PERF_COUNTER_BASE
+    | PERF_DISPLAY_NOSHOW
+    | 0x00000003
+)
+PERF_ELAPSED_TIME = (
+    PERF_SIZE_LARGE
+    | PERF_TYPE_COUNTER
+    | PERF_COUNTER_ELAPSED
+    | PERF_OBJECT_TIMER
+    | PERF_DISPLAY_SECONDS
+)
+PERF_COUNTER_HISTOGRAM_TYPE = -2147483648  # 0x80000000
+PERF_COUNTER_DELTA = (
+    PERF_SIZE_DWORD
+    | PERF_TYPE_COUNTER
+    | PERF_COUNTER_VALUE
+    | PERF_DELTA_COUNTER
+    | PERF_DISPLAY_NO_SUFFIX
+)
+PERF_COUNTER_LARGE_DELTA = (
+    PERF_SIZE_LARGE
+    | PERF_TYPE_COUNTER
+    | PERF_COUNTER_VALUE
+    | PERF_DELTA_COUNTER
+    | PERF_DISPLAY_NO_SUFFIX
+)
+PERF_DETAIL_NOVICE = 100
+PERF_DETAIL_ADVANCED = 200
+PERF_DETAIL_EXPERT = 300
+PERF_DETAIL_WIZARD = 400
+PERF_NO_UNIQUE_ID = -1
diff --git a/lib/win32/lib/winxptheme.py b/lib/win32/lib/winxptheme.py
new file mode 100644
index 00000000..3f61c3de
--- /dev/null
+++ b/lib/win32/lib/winxptheme.py
@@ -0,0 +1,7 @@
+"""A useful wrapper around the "_winxptheme" module.
+
+Originally used when we couldn't be sure Windows XP apis were going to
+be available. In 2022, it's safe to assume they are, so this is just a wrapper
+around _winxptheme.
+"""
+from _winxptheme import *
diff --git a/lib/win32/license.txt b/lib/win32/license.txt
new file mode 100644
index 00000000..fa340d74
--- /dev/null
+++ b/lib/win32/license.txt
@@ -0,0 +1,30 @@
+Unless stated in the specfic source file, this work is
+Copyright (c) 1994-2008, Mark Hammond 
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without 
+modification, are permitted provided that the following conditions 
+are met:
+
+Redistributions of source code must retain the above copyright notice, 
+this list of conditions and the following disclaimer.
+
+Redistributions in binary form must reproduce the above copyright 
+notice, this list of conditions and the following disclaimer in 
+the documentation and/or other materials provided with the distribution.
+
+Neither name of Mark Hammond nor the name of contributors may be used 
+to endorse or promote products derived from this software without 
+specific prior written permission. 
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS
+IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR
+CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 
diff --git a/lib/win32/scripts/ControlService.py b/lib/win32/scripts/ControlService.py
new file mode 100644
index 00000000..d2281add
--- /dev/null
+++ b/lib/win32/scripts/ControlService.py
@@ -0,0 +1,594 @@
+# ControlService.py
+#
+# A simple app which duplicates some of the functionality in the
+# Services applet of the control panel.
+#
+# Suggested enhancements (in no particular order):
+#
+# 1. When changing the service status, continue to query the status
+# of the service until the status change is complete.  Use this
+# information to put up some kind of a progress dialog like the CP
+# applet does.  Unlike the CP, allow canceling out in the event that
+# the status change hangs.
+# 2. When starting or stopping a service with dependencies, alert
+# the user about the dependent services, then start (or stop) all
+# dependent services as appropriate.
+# 3. Allow toggling between service view and device view
+# 4. Allow configuration of other service parameters such as startup
+# name and password.
+# 5. Allow connection to remote SCMs.  This is just a matter of
+# reconnecting to the SCM on the remote machine; the rest of the
+# code should still work the same.
+# 6. Either implement the startup parameters or get rid of the editbox.
+# 7. Either implement or get rid of "H/W Profiles".
+# 8. Either implement or get rid of "Help".
+# 9. Improve error handling.  Ideally, this would also include falling
+# back to lower levels of functionality for users with less rights.
+# Right now, we always try to get all the rights and fail when we can't
+
+
+import win32con
+import win32service
+import win32ui
+from pywin.mfc import dialog
+
+
+class StartupDlg(dialog.Dialog):
+    IDC_LABEL = 127
+    IDC_DEVICE = 128
+    IDC_BOOT = 129
+    IDC_SYSTEM = 130
+    IDC_AUTOMATIC = 131
+    IDC_MANUAL = 132
+    IDC_DISABLED = 133
+
+    def __init__(self, displayname, service):
+        dialog.Dialog.__init__(self, self.GetResource())
+        self.name = displayname
+        self.service = service
+
+    def __del__(self):
+        win32service.CloseServiceHandle(self.service)
+
+    def OnInitDialog(self):
+        cfg = win32service.QueryServiceConfig(self.service)
+        self.GetDlgItem(self.IDC_BOOT + cfg[1]).SetCheck(1)
+
+        status = win32service.QueryServiceStatus(self.service)
+        if (status[0] & win32service.SERVICE_KERNEL_DRIVER) or (
+            status[0] & win32service.SERVICE_FILE_SYSTEM_DRIVER
+        ):
+            # driver
+            self.GetDlgItem(self.IDC_LABEL).SetWindowText("Device:")
+        else:
+            # service
+            self.GetDlgItem(self.IDC_LABEL).SetWindowText("Service:")
+            self.GetDlgItem(self.IDC_BOOT).EnableWindow(0)
+            self.GetDlgItem(self.IDC_SYSTEM).EnableWindow(0)
+        self.GetDlgItem(self.IDC_DEVICE).SetWindowText(str(self.name))
+
+        return dialog.Dialog.OnInitDialog(self)
+
+    def OnOK(self):
+        self.BeginWaitCursor()
+        starttype = (
+            self.GetCheckedRadioButton(self.IDC_BOOT, self.IDC_DISABLED) - self.IDC_BOOT
+        )
+        try:
+            win32service.ChangeServiceConfig(
+                self.service,
+                win32service.SERVICE_NO_CHANGE,
+                starttype,
+                win32service.SERVICE_NO_CHANGE,
+                None,
+                None,
+                0,
+                None,
+                None,
+                None,
+                None,
+            )
+        except:
+            self.MessageBox(
+                "Unable to change startup configuration",
+                None,
+                win32con.MB_ICONEXCLAMATION,
+            )
+        self.EndWaitCursor()
+        return dialog.Dialog.OnOK(self)
+
+    def GetResource(self):
+        style = (
+            win32con.WS_POPUP
+            | win32con.DS_SETFONT
+            | win32con.WS_SYSMENU
+            | win32con.WS_CAPTION
+            | win32con.WS_VISIBLE
+            | win32con.DS_MODALFRAME
+        )
+        exstyle = None
+        t = [
+            ["Service Startup", (6, 18, 188, 107), style, exstyle, (8, "MS Shell Dlg")],
+        ]
+        t.append(
+            [
+                130,
+                "Device:",
+                self.IDC_LABEL,
+                (6, 7, 40, 8),
+                win32con.WS_VISIBLE | win32con.WS_CHILD | win32con.SS_LEFT,
+            ]
+        )
+        t.append(
+            [
+                130,
+                "",
+                self.IDC_DEVICE,
+                (48, 7, 134, 8),
+                win32con.WS_VISIBLE | win32con.WS_CHILD | win32con.SS_LEFT,
+            ]
+        )
+        t.append(
+            [
+                128,
+                "Startup Type",
+                -1,
+                (6, 21, 130, 80),
+                win32con.WS_VISIBLE
+                | win32con.WS_CHILD
+                | win32con.WS_GROUP
+                | win32con.BS_GROUPBOX,
+            ]
+        )
+        t.append(
+            [
+                128,
+                "&Boot",
+                self.IDC_BOOT,
+                (12, 33, 39, 10),
+                win32con.WS_VISIBLE
+                | win32con.WS_CHILD
+                | win32con.WS_TABSTOP
+                | win32con.BS_AUTORADIOBUTTON,
+            ]
+        )
+        t.append(
+            [
+                128,
+                "&System",
+                self.IDC_SYSTEM,
+                (12, 46, 39, 10),
+                win32con.WS_VISIBLE
+                | win32con.WS_CHILD
+                | win32con.WS_TABSTOP
+                | win32con.BS_AUTORADIOBUTTON,
+            ]
+        )
+        t.append(
+            [
+                128,
+                "&Automatic",
+                self.IDC_AUTOMATIC,
+                (12, 59, 118, 10),
+                win32con.WS_VISIBLE
+                | win32con.WS_CHILD
+                | win32con.WS_TABSTOP
+                | win32con.BS_AUTORADIOBUTTON,
+            ]
+        )
+        t.append(
+            [
+                128,
+                "&Manual",
+                self.IDC_MANUAL,
+                (12, 72, 118, 10),
+                win32con.WS_VISIBLE
+                | win32con.WS_CHILD
+                | win32con.WS_TABSTOP
+                | win32con.BS_AUTORADIOBUTTON,
+            ]
+        )
+        t.append(
+            [
+                128,
+                "&Disabled",
+                self.IDC_DISABLED,
+                (12, 85, 118, 10),
+                win32con.WS_VISIBLE
+                | win32con.WS_CHILD
+                | win32con.WS_TABSTOP
+                | win32con.BS_AUTORADIOBUTTON,
+            ]
+        )
+        t.append(
+            [
+                128,
+                "OK",
+                win32con.IDOK,
+                (142, 25, 40, 14),
+                win32con.WS_VISIBLE
+                | win32con.WS_CHILD
+                | win32con.WS_TABSTOP
+                | win32con.WS_GROUP
+                | win32con.BS_DEFPUSHBUTTON,
+            ]
+        )
+        t.append(
+            [
+                128,
+                "Cancel",
+                win32con.IDCANCEL,
+                (142, 43, 40, 14),
+                win32con.WS_VISIBLE
+                | win32con.WS_CHILD
+                | win32con.WS_TABSTOP
+                | win32con.BS_PUSHBUTTON,
+            ]
+        )
+        t.append(
+            [
+                128,
+                "&Help",
+                win32con.IDHELP,
+                (142, 61, 40, 14),
+                win32con.WS_VISIBLE
+                | win32con.WS_CHILD
+                | win32con.WS_TABSTOP
+                | win32con.BS_PUSHBUTTON,
+            ]
+        )
+        return t
+
+
+class ServiceDlg(dialog.Dialog):
+    IDC_LIST = 128
+    IDC_START = 129
+    IDC_STOP = 130
+    IDC_PAUSE = 131
+    IDC_CONTINUE = 132
+    IDC_STARTUP = 133
+    IDC_PROFILES = 134
+    IDC_PARAMS = 135
+
+    def __init__(self, machineName=""):
+        dialog.Dialog.__init__(self, self.GetResource())
+        self.HookCommand(self.OnListEvent, self.IDC_LIST)
+        self.HookCommand(self.OnStartCmd, self.IDC_START)
+        self.HookCommand(self.OnStopCmd, self.IDC_STOP)
+        self.HookCommand(self.OnPauseCmd, self.IDC_PAUSE)
+        self.HookCommand(self.OnContinueCmd, self.IDC_CONTINUE)
+        self.HookCommand(self.OnStartupCmd, self.IDC_STARTUP)
+        self.machineName = machineName
+        self.scm = win32service.OpenSCManager(
+            self.machineName, None, win32service.SC_MANAGER_ALL_ACCESS
+        )
+
+    def __del__(self):
+        win32service.CloseServiceHandle(self.scm)
+
+    def OnInitDialog(self):
+        self.listCtrl = self.GetDlgItem(self.IDC_LIST)
+        self.listCtrl.SetTabStops([158, 200])
+        if self.machineName:
+            self.SetWindowText("Services on %s" % self.machineName)
+        self.ReloadData()
+        return dialog.Dialog.OnInitDialog(self)
+
+    def ReloadData(self):
+        service = self.GetSelService()
+        self.listCtrl.SetRedraw(0)
+        self.listCtrl.ResetContent()
+        svcs = win32service.EnumServicesStatus(self.scm)
+        i = 0
+        self.data = []
+        for svc in svcs:
+            try:
+                status = (
+                    "Unknown",
+                    "Stopped",
+                    "Starting",
+                    "Stopping",
+                    "Running",
+                    "Continuing",
+                    "Pausing",
+                    "Paused",
+                )[svc[2][1]]
+            except:
+                status = "Unknown"
+            s = win32service.OpenService(
+                self.scm, svc[0], win32service.SERVICE_ALL_ACCESS
+            )
+            cfg = win32service.QueryServiceConfig(s)
+            try:
+                startup = ("Boot", "System", "Automatic", "Manual", "Disabled")[cfg[1]]
+            except:
+                startup = "Unknown"
+            win32service.CloseServiceHandle(s)
+
+            # svc[2][2] control buttons
+            pos = self.listCtrl.AddString(str(svc[1]) + "\t" + status + "\t" + startup)
+            self.listCtrl.SetItemData(pos, i)
+            self.data.append(
+                tuple(svc[2])
+                + (
+                    svc[1],
+                    svc[0],
+                )
+            )
+            i = i + 1
+
+            if service and service[1] == svc[0]:
+                self.listCtrl.SetCurSel(pos)
+        self.OnListEvent(self.IDC_LIST, win32con.LBN_SELCHANGE)
+        self.listCtrl.SetRedraw(1)
+
+    def OnListEvent(self, id, code):
+        if code == win32con.LBN_SELCHANGE or code == win32con.LBN_SELCANCEL:
+            pos = self.listCtrl.GetCurSel()
+            if pos >= 0:
+                data = self.data[self.listCtrl.GetItemData(pos)][2]
+                canstart = (
+                    self.data[self.listCtrl.GetItemData(pos)][1]
+                    == win32service.SERVICE_STOPPED
+                )
+            else:
+                data = 0
+                canstart = 0
+            self.GetDlgItem(self.IDC_START).EnableWindow(canstart)
+            self.GetDlgItem(self.IDC_STOP).EnableWindow(
+                data & win32service.SERVICE_ACCEPT_STOP
+            )
+            self.GetDlgItem(self.IDC_PAUSE).EnableWindow(
+                data & win32service.SERVICE_ACCEPT_PAUSE_CONTINUE
+            )
+            self.GetDlgItem(self.IDC_CONTINUE).EnableWindow(
+                data & win32service.SERVICE_ACCEPT_PAUSE_CONTINUE
+            )
+
+    def GetSelService(self):
+        pos = self.listCtrl.GetCurSel()
+        if pos < 0:
+            return None
+        pos = self.listCtrl.GetItemData(pos)
+        return self.data[pos][-2:]
+
+    def OnStartCmd(self, id, code):
+        service = self.GetSelService()
+        if not service:
+            return
+        s = win32service.OpenService(
+            self.scm, service[1], win32service.SERVICE_ALL_ACCESS
+        )
+        win32service.StartService(s, None)
+        win32service.CloseServiceHandle(s)
+        self.ReloadData()
+
+    def OnStopCmd(self, id, code):
+        service = self.GetSelService()
+        if not service:
+            return
+        s = win32service.OpenService(
+            self.scm, service[1], win32service.SERVICE_ALL_ACCESS
+        )
+        win32service.ControlService(s, win32service.SERVICE_CONTROL_STOP)
+        win32service.CloseServiceHandle(s)
+        self.ReloadData()
+
+    def OnPauseCmd(self, id, code):
+        service = self.GetSelService()
+        if not service:
+            return
+        s = win32service.OpenService(
+            self.scm, service[1], win32service.SERVICE_ALL_ACCESS
+        )
+        win32service.ControlService(s, win32service.SERVICE_CONTROL_PAUSE)
+        win32service.CloseServiceHandle(s)
+        self.ReloadData()
+
+    def OnContinueCmd(self, id, code):
+        service = self.GetSelService()
+        if not service:
+            return
+        s = win32service.OpenService(
+            self.scm, service[1], win32service.SERVICE_ALL_ACCESS
+        )
+        win32service.ControlService(s, win32service.SERVICE_CONTROL_CONTINUE)
+        win32service.CloseServiceHandle(s)
+        self.ReloadData()
+
+    def OnStartupCmd(self, id, code):
+        service = self.GetSelService()
+        if not service:
+            return
+        s = win32service.OpenService(
+            self.scm, service[1], win32service.SERVICE_ALL_ACCESS
+        )
+        if StartupDlg(service[0], s).DoModal() == win32con.IDOK:
+            self.ReloadData()
+
+    def GetResource(self):
+        style = (
+            win32con.WS_POPUP
+            | win32con.DS_SETFONT
+            | win32con.WS_SYSMENU
+            | win32con.WS_CAPTION
+            | win32con.WS_VISIBLE
+            | win32con.DS_MODALFRAME
+        )
+        exstyle = None
+        t = [
+            ["Services", (16, 16, 333, 157), style, exstyle, (8, "MS Shell Dlg")],
+        ]
+        t.append(
+            [
+                130,
+                "Ser&vice",
+                -1,
+                (6, 6, 70, 8),
+                win32con.WS_VISIBLE | win32con.WS_CHILD | win32con.SS_LEFT,
+            ]
+        )
+        t.append(
+            [
+                130,
+                "Status",
+                -1,
+                (164, 6, 42, 8),
+                win32con.WS_VISIBLE | win32con.WS_CHILD | win32con.SS_LEFT,
+            ]
+        )
+        t.append(
+            [
+                130,
+                "Startup",
+                -1,
+                (206, 6, 50, 8),
+                win32con.WS_VISIBLE | win32con.WS_CHILD | win32con.SS_LEFT,
+            ]
+        )
+        t.append(
+            [
+                131,
+                "",
+                self.IDC_LIST,
+                (6, 16, 255, 106),
+                win32con.LBS_USETABSTOPS
+                | win32con.LBS_SORT
+                | win32con.LBS_NOINTEGRALHEIGHT
+                | win32con.WS_BORDER
+                | win32con.WS_CHILD
+                | win32con.WS_VISIBLE
+                | win32con.WS_TABSTOP
+                | win32con.LBS_NOTIFY
+                | win32con.WS_VSCROLL,
+            ]
+        )
+        t.append(
+            [
+                128,
+                "Close",
+                win32con.IDOK,
+                (267, 6, 60, 14),
+                win32con.WS_VISIBLE
+                | win32con.WS_CHILD
+                | win32con.WS_GROUP
+                | win32con.WS_TABSTOP
+                | win32con.BS_DEFPUSHBUTTON,
+            ]
+        )
+        t.append(
+            [
+                128,
+                "&Start",
+                self.IDC_START,
+                (267, 27, 60, 14),
+                win32con.WS_VISIBLE
+                | win32con.WS_CHILD
+                | win32con.WS_TABSTOP
+                | win32con.BS_PUSHBUTTON,
+            ]
+        )
+        t.append(
+            [
+                128,
+                "S&top",
+                self.IDC_STOP,
+                (267, 44, 60, 14),
+                win32con.WS_VISIBLE
+                | win32con.WS_CHILD
+                | win32con.WS_TABSTOP
+                | win32con.BS_PUSHBUTTON,
+            ]
+        )
+        t.append(
+            [
+                128,
+                "&Pause",
+                self.IDC_PAUSE,
+                (267, 61, 60, 14),
+                win32con.WS_VISIBLE
+                | win32con.WS_CHILD
+                | win32con.WS_TABSTOP
+                | win32con.BS_PUSHBUTTON,
+            ]
+        )
+        t.append(
+            [
+                128,
+                "&Continue",
+                self.IDC_CONTINUE,
+                (267, 78, 60, 14),
+                win32con.WS_VISIBLE
+                | win32con.WS_CHILD
+                | win32con.WS_TABSTOP
+                | win32con.BS_PUSHBUTTON,
+            ]
+        )
+        t.append(
+            [
+                128,
+                "Sta&rtup...",
+                self.IDC_STARTUP,
+                (267, 99, 60, 14),
+                win32con.WS_VISIBLE
+                | win32con.WS_CHILD
+                | win32con.WS_TABSTOP
+                | win32con.BS_PUSHBUTTON,
+            ]
+        )
+        t.append(
+            [
+                128,
+                "H&W Profiles...",
+                self.IDC_PROFILES,
+                (267, 116, 60, 14),
+                win32con.WS_VISIBLE
+                | win32con.WS_CHILD
+                | win32con.WS_TABSTOP
+                | win32con.BS_PUSHBUTTON,
+            ]
+        )
+        t.append(
+            [
+                128,
+                "&Help",
+                win32con.IDHELP,
+                (267, 137, 60, 14),
+                win32con.WS_VISIBLE
+                | win32con.WS_CHILD
+                | win32con.WS_TABSTOP
+                | win32con.BS_PUSHBUTTON,
+            ]
+        )
+        t.append(
+            [
+                130,
+                "St&artup Parameters:",
+                -1,
+                (6, 128, 70, 8),
+                win32con.WS_VISIBLE | win32con.WS_CHILD | win32con.SS_LEFT,
+            ]
+        )
+        t.append(
+            [
+                129,
+                "",
+                self.IDC_PARAMS,
+                (6, 139, 247, 12),
+                win32con.WS_VISIBLE
+                | win32con.WS_CHILD
+                | win32con.WS_GROUP
+                | win32con.WS_BORDER
+                | win32con.ES_AUTOHSCROLL,
+            ]
+        )
+        return t
+
+
+if __name__ == "__main__":
+    import sys
+
+    machine = ""
+    if len(sys.argv) > 1:
+        machine = sys.argv[1]
+    ServiceDlg(machine).DoModal()
diff --git a/lib/win32/scripts/VersionStamp/BrandProject.py b/lib/win32/scripts/VersionStamp/BrandProject.py
new file mode 100644
index 00000000..cc78d8d9
--- /dev/null
+++ b/lib/win32/scripts/VersionStamp/BrandProject.py
@@ -0,0 +1,98 @@
+# BrandProject.py
+#
+# Brand a VSS project with a "build number", then optionally
+# stamp DLL/EXE files with version information.
+
+import os
+import string
+import sys
+
+import bulkstamp
+import vssutil
+import win32api
+
+
+def BrandProject(
+    vssProjectName,
+    descFile,
+    stampPath,
+    filesToSubstitute,
+    buildDesc=None,
+    auto=0,
+    bRebrand=0,
+):
+    # vssProjectName -- The name of the VSS project to brand.
+    # descFile -- A test file containing descriptions of the files in the release.
+    # stampPath -- The full path to where the files referenced in descFile can be found.
+    path = win32api.GetFullPathName(stampPath)
+
+    build = vssutil.MakeNewBuildNo(vssProjectName, buildDesc, auto, bRebrand)
+    if build is None:
+        print("Cancelled")
+        return
+
+    bulkstamp.scan(build, stampPath, descFile)
+    for infile, outfile in filesToSubstitute:
+        SubstituteVSSInFile(vssProjectName, infile, outfile)
+    return 1
+
+
+def usage(msg):
+    print(msg)
+    print(
+        """\
+%s Usage:
+%s [options] vssProject descFile stampPath
+
+Automatically brand a VSS project with an automatically incremented
+build number, and stamp DLL/EXE files with the build number.
+
+Checks that no files are checked out in the project, and finds the last
+build number, and suggests the next number.
+
+Options:
+-a     - Auto increment the build number, and brand (otherwise prompt
+         for the build number after looking for the previous)
+-r     - Restamp the files with the existing build number.
+-d     - A description for the VSS Label.
+-f infile=outfile - Substitute special VSS labels in the specified text
+                    file with the text extracted from VSS.
+"""
+        % (os.path.basename(sys.argv[0]), os.path.basename(sys.argv[0]))
+    )
+    sys.exit(1)
+
+
+if __name__ == "__main__":
+    try:
+        import getopt
+
+        opts, args = getopt.getopt(sys.argv[1:], "af:d:r")
+    except getopts.error as msg:
+        usage(msg)
+    bAuto = bRebrand = 0
+    stampFiles = []
+    desc = None
+    for opt, val in opts:
+        if opt == "-a":
+            bAuto = 1
+        if opt == "-f":
+            infile, outfile = string.split(val, "=", 2)
+            stampFiles.append((infile, outfile))
+        if opt == "-d":
+            desc = val
+        if opt == "-r":
+            bRebrand = 1
+    if len(args) < 3:
+        usage("You must specify the required arguments")
+    vssProjectName = "$\\" + args[0]
+    descFile = args[1]
+    path = args[2]
+    try:
+        os.stat(descFile)
+    except IOError:
+        usage("The description file '%s' can not be found" % (descFile))
+    if not os.path.isdir(path):
+        usage("The path to the files to stamp '%s' does not exist" % (path))
+
+    BrandProject(vssProjectName, descFile, path, stampFiles, desc, bAuto, bRebrand)
diff --git a/lib/win32/scripts/VersionStamp/bulkstamp.py b/lib/win32/scripts/VersionStamp/bulkstamp.py
new file mode 100644
index 00000000..44f2a63e
--- /dev/null
+++ b/lib/win32/scripts/VersionStamp/bulkstamp.py
@@ -0,0 +1,149 @@
+#
+# bulkstamp.py:
+#    Stamp versions on all files that can be found in a given tree.
+#
+# USAGE: python bulkstamp.py <version> <root directory> <descriptions>
+#
+# Example: python bulkstamp.py 103 ..\win32\Build\ desc.txt
+#
+# <version> corresponds to the build number. It will be concatenated with
+# the major and minor version numbers found in the description file.
+#
+# Description information is pulled from an input text file with lines of
+# the form:
+#
+#    <basename> <white space> <description>
+#
+# For example:
+#
+#    PyWinTypes.dll Common types for Python on Win32
+#    etc
+#
+# The product's name, major, and minor versions are specified as:
+#
+#    name <white space> <value>
+#    major <white space> <value>
+#    minor <white space> <value>
+#
+# The tags are case-sensitive.
+#
+# Any line beginning with "#" will be ignored. Empty lines are okay.
+#
+
+import fnmatch
+import os
+import sys
+
+import verstamp
+import win32api
+
+numStamped = 0
+
+g_patterns = [
+    "*.dll",
+    "*.pyd",
+    "*.exe",
+    "*.ocx",
+]
+
+
+def walk(arg, dirname, names):
+    global numStamped
+    vars, debug, descriptions = arg
+    for name in names:
+        for pat in g_patterns:
+            if fnmatch.fnmatch(name, pat):
+                # Handle the "_d" thing.
+                pathname = os.path.join(dirname, name)
+                base, ext = os.path.splitext(name)
+                if base[-2:] == "_d":
+                    name = base[:-2] + ext
+                is_dll = ext.lower() != ".exe"
+                if os.path.normcase(name) in descriptions:
+                    desc = descriptions[os.path.normcase(name)]
+                    try:
+                        verstamp.stamp(vars, pathname, desc, is_dll=is_dll)
+                        numStamped = numStamped + 1
+                    except win32api.error as exc:
+                        print(
+                            "Could not stamp",
+                            pathname,
+                            "Error",
+                            exc.winerror,
+                            "-",
+                            exc.strerror,
+                        )
+                else:
+                    print("WARNING: description not provided for:", name)
+                    # skip branding this - assume already branded or handled elsewhere
+
+
+#        print "Stamped", pathname
+
+
+def load_descriptions(fname, vars):
+    retvars = {}
+    descriptions = {}
+
+    lines = open(fname, "r").readlines()
+
+    for i in range(len(lines)):
+        line = lines[i].strip()
+        if line != "" and line[0] != "#":
+            idx1 = line.find(" ")
+            idx2 = line.find("\t")
+            if idx1 == -1 or idx2 < idx1:
+                idx1 = idx2
+            if idx1 == -1:
+                print("ERROR: bad syntax in description file at line %d." % (i + 1))
+                sys.exit(1)
+
+            key = line[:idx1]
+            val = line[idx1:].strip()
+            if key in vars:
+                retvars[key] = val
+            else:
+                descriptions[key] = val
+
+    if "product" not in retvars:
+        print("ERROR: description file is missing the product name.")
+        sys.exit(1)
+    if "major" not in retvars:
+        print("ERROR: description file is missing the major version number.")
+        sys.exit(1)
+    if "minor" not in retvars:
+        print("ERROR: description file is missing the minor version number.")
+        sys.exit(1)
+
+    return retvars, descriptions
+
+
+def scan(build, root, desc, **custom_vars):
+    global numStamped
+    numStamped = 0
+    try:
+        build = int(build)
+    except ValueError:
+        print("ERROR: build number is not a number: %s" % build)
+        sys.exit(1)
+
+    debug = 0  ### maybe fix this one day
+
+    varList = ["major", "minor", "sub", "company", "copyright", "trademarks", "product"]
+
+    vars, descriptions = load_descriptions(desc, varList)
+    vars["build"] = build
+    vars.update(custom_vars)
+
+    arg = vars, debug, descriptions
+    os.path.walk(root, walk, arg)
+
+    print("Stamped %d files." % (numStamped))
+
+
+if __name__ == "__main__":
+    if len(sys.argv) != 4:
+        print("ERROR: incorrect invocation. See script's header comments.")
+        sys.exit(1)
+
+    scan(*tuple(sys.argv[1:]))
diff --git a/lib/win32/scripts/VersionStamp/vssutil.py b/lib/win32/scripts/VersionStamp/vssutil.py
new file mode 100644
index 00000000..6679ebc9
--- /dev/null
+++ b/lib/win32/scripts/VersionStamp/vssutil.py
@@ -0,0 +1,204 @@
+import string
+import time
+import traceback
+
+import pythoncom
+import win32com.client
+import win32com.client.gencache
+import win32con
+
+constants = win32com.client.constants
+
+win32com.client.gencache.EnsureModule("{783CD4E0-9D54-11CF-B8EE-00608CC9A71F}", 0, 5, 0)
+
+error = "vssutil error"
+
+
+def GetSS():
+    ss = win32com.client.Dispatch("SourceSafe")
+    # SS seems a bit weird.  It defaults the arguments as empty strings, but
+    # then complains when they are used - so we pass "Missing"
+    ss.Open(pythoncom.Missing, pythoncom.Missing, pythoncom.Missing)
+    return ss
+
+
+def test(projectName):
+    ss = GetSS()
+    project = ss.VSSItem(projectName)
+
+    for item in project.GetVersions(constants.VSSFLAG_RECURSYES):
+        print(item.VSSItem.Name, item.VersionNumber, item.Action)
+
+
+# 	item=i.Versions[0].VSSItem
+# 	for h in i.Versions:
+# 		print `h.Comment`, h.Action, h.VSSItem.Name
+
+
+def SubstituteInString(inString, evalEnv):
+    substChar = "$"
+    fields = string.split(inString, substChar)
+    newFields = []
+    for i in range(len(fields)):
+        didSubst = 0
+        strVal = fields[i]
+        if i % 2 != 0:
+            try:
+                strVal = eval(strVal, evalEnv[0], evalEnv[1])
+                newFields.append(strVal)
+                didSubst = 1
+            except:
+                traceback.print_exc()
+                print("Could not substitute", strVal)
+        if not didSubst:
+            newFields.append(strVal)
+    return string.join(map(str, newFields), "")
+
+
+def SubstituteInFile(inName, outName, evalEnv):
+    inFile = open(inName, "r")
+    try:
+        outFile = open(outName, "w")
+        try:
+            while 1:
+                line = inFile.read()
+                if not line:
+                    break
+                outFile.write(SubstituteInString(line, evalEnv))
+        finally:
+            outFile.close()
+    finally:
+        inFile.close()
+
+
+def VssLog(project, linePrefix="", noLabels=5, maxItems=150):
+    lines = []
+    num = 0
+    labelNum = 0
+    for i in project.GetVersions(constants.VSSFLAG_RECURSYES):
+        num = num + 1
+        if num > maxItems:
+            break
+        commentDesc = itemDesc = ""
+        if i.Action[:5] == "Added":
+            continue
+        if len(i.Label):
+            labelNum = labelNum + 1
+            itemDesc = i.Action
+        else:
+            itemDesc = i.VSSItem.Name
+            if str(itemDesc[-4:]) == ".dsp":
+                continue
+        if i.Comment:
+            commentDesc = "\n%s\t%s" % (linePrefix, i.Comment)
+        lines.append(
+            "%s%s\t%s%s"
+            % (
+                linePrefix,
+                time.asctime(time.localtime(int(i.Date))),
+                itemDesc,
+                commentDesc,
+            )
+        )
+        if labelNum > noLabels:
+            break
+    return string.join(lines, "\n")
+
+
+def SubstituteVSSInFile(projectName, inName, outName):
+    import win32api
+
+    if win32api.GetFullPathName(inName) == win32api.GetFullPathName(outName):
+        raise RuntimeError("The input and output filenames can not be the same")
+    sourceSafe = GetSS()
+    project = sourceSafe.VSSItem(projectName)
+    # Find the last label
+    label = None
+    for version in project.Versions:
+        if version.Label:
+            break
+    else:
+        print("Couldnt find a label in the sourcesafe project!")
+        return
+    # Setup some local helpers for the conversion strings.
+    vss_label = version.Label
+    vss_date = time.asctime(time.localtime(int(version.Date)))
+    now = time.asctime(time.localtime(time.time()))
+    SubstituteInFile(inName, outName, (locals(), globals()))
+
+
+def CountCheckouts(item):
+    num = 0
+    if item.Type == constants.VSSITEM_PROJECT:
+        for sub in item.Items:
+            num = num + CountCheckouts(sub)
+    else:
+        if item.IsCheckedOut:
+            num = num + 1
+    return num
+
+
+def GetLastBuildNo(project):
+    i = GetSS().VSSItem(project)
+    # Find the last label
+    lab = None
+    for version in i.Versions:
+        lab = str(version.Label)
+        if lab:
+            return lab
+    return None
+
+
+def MakeNewBuildNo(project, buildDesc=None, auto=0, bRebrand=0):
+    if buildDesc is None:
+        buildDesc = "Created by Python"
+    ss = GetSS()
+    i = ss.VSSItem(project)
+    num = CountCheckouts(i)
+    if num > 0:
+        msg = (
+            "This project has %d items checked out\r\n\r\nDo you still want to continue?"
+            % num
+        )
+        import win32ui
+
+        if win32ui.MessageBox(msg, project, win32con.MB_YESNO) != win32con.IDYES:
+            return
+
+    oldBuild = buildNo = GetLastBuildNo(project)
+    if buildNo is None:
+        buildNo = "1"
+        oldBuild = "<None>"
+    else:
+        try:
+            buildNo = string.atoi(buildNo)
+            if not bRebrand:
+                buildNo = buildNo + 1
+            buildNo = str(buildNo)
+        except ValueError:
+            raise error("The previous label could not be incremented: %s" % (oldBuild))
+
+    if not auto:
+        from pywin.mfc import dialog
+
+        buildNo = dialog.GetSimpleInput(
+            "Enter new build number", buildNo, "%s - Prev: %s" % (project, oldBuild)
+        )
+        if buildNo is None:
+            return
+    i.Label(buildNo, "Build %s: %s" % (buildNo, buildDesc))
+    if auto:
+        print("Branded project %s with label %s" % (project, buildNo))
+    return buildNo
+
+
+if __name__ == "__main__":
+    # 	UpdateWiseExeName("PyWiseTest.wse", "PyWiseTest-10.exe")
+
+    # 	MakeVersion()
+    # 	test(tp)
+    # 	MakeNewBuildNo(tp)
+    tp = "\\Python\\Python Win32 Extensions"
+    SubstituteVSSInFile(
+        tp, "d:\\src\\pythonex\\win32\\win32.txt", "d:\\temp\\win32.txt"
+    )
diff --git a/lib/win32/scripts/backupEventLog.py b/lib/win32/scripts/backupEventLog.py
new file mode 100644
index 00000000..bc7d53fe
--- /dev/null
+++ b/lib/win32/scripts/backupEventLog.py
@@ -0,0 +1,46 @@
+# Generate a base file name
+import os
+import time
+
+import win32api
+import win32evtlog
+
+
+def BackupClearLog(logType):
+    datePrefix = time.strftime("%Y%m%d", time.localtime(time.time()))
+    fileExists = 1
+    retry = 0
+    while fileExists:
+        if retry == 0:
+            index = ""
+        else:
+            index = "-%d" % retry
+        try:
+            fname = os.path.join(
+                win32api.GetTempPath(),
+                "%s%s-%s" % (datePrefix, index, logType) + ".evt",
+            )
+            os.stat(fname)
+        except os.error:
+            fileExists = 0
+        retry = retry + 1
+    # OK - have unique file name.
+    try:
+        hlog = win32evtlog.OpenEventLog(None, logType)
+    except win32evtlogutil.error as details:
+        print("Could not open the event log", details)
+        return
+    try:
+        if win32evtlog.GetNumberOfEventLogRecords(hlog) == 0:
+            print("No records in event log %s - not backed up" % logType)
+            return
+        win32evtlog.ClearEventLog(hlog, fname)
+        print("Backed up %s log to %s" % (logType, fname))
+    finally:
+        win32evtlog.CloseEventLog(hlog)
+
+
+if __name__ == "__main__":
+    BackupClearLog("Application")
+    BackupClearLog("System")
+    BackupClearLog("Security")
diff --git a/lib/win32/scripts/ce/pysynch.py b/lib/win32/scripts/ce/pysynch.py
new file mode 100644
index 00000000..7a44e082
--- /dev/null
+++ b/lib/win32/scripts/ce/pysynch.py
@@ -0,0 +1,290 @@
+# Simple CE synchronisation utility with Python features.
+
+import fnmatch
+import getopt
+import os
+import string
+import sys
+
+import win32api
+import win32con
+import win32file
+import wincerapi
+
+
+class InvalidUsage(Exception):
+    pass
+
+
+def print_error(api_exc, msg):
+    hr, fn, errmsg = api_exc
+    print("%s - %s(%d)" % (msg, errmsg, hr))
+
+
+def GetFileAttributes(file, local=1):
+    if local:
+        return win32api.GetFileAttributes(file)
+    else:
+        return wincerapi.CeGetFileAttributes(file)
+
+
+def FindFiles(spec, local=1):
+    if local:
+        return win32api.FindFiles(spec)
+    else:
+        return wincerapi.CeFindFiles(spec)
+
+
+def isdir(name, local=1):
+    try:
+        attr = GetFileAttributes(name, local)
+        return attr & win32con.FILE_ATTRIBUTE_DIRECTORY
+    except win32api.error:
+        return 0
+
+
+def CopyFileToCe(src_name, dest_name, progress=None):
+    sh = win32file.CreateFile(
+        src_name, win32con.GENERIC_READ, 0, None, win32con.OPEN_EXISTING, 0, None
+    )
+    bytes = 0
+    try:
+        dh = wincerapi.CeCreateFile(
+            dest_name, win32con.GENERIC_WRITE, 0, None, win32con.OPEN_ALWAYS, 0, None
+        )
+        try:
+            while 1:
+                hr, data = win32file.ReadFile(sh, 2048)
+                if not data:
+                    break
+                wincerapi.CeWriteFile(dh, data)
+                bytes = bytes + len(data)
+                if progress is not None:
+                    progress(bytes)
+        finally:
+            pass
+            dh.Close()
+    finally:
+        sh.Close()
+    return bytes
+
+
+def BuildFileList(spec, local, recurse, filter, filter_args, recursed_path=""):
+    files = []
+    if isdir(spec, local):
+        path = spec
+        raw_spec = "*"
+    else:
+        path, raw_spec = os.path.split(spec)
+    if recurse:
+        # Need full scan, to get sub-direcetories.
+        infos = FindFiles(os.path.join(path, "*"), local)
+    else:
+        infos = FindFiles(os.path.join(path, raw_spec), local)
+    for info in infos:
+        src_name = str(info[8])
+        full_src_name = os.path.join(path, src_name)
+        if local:  # Can't do this for CE!
+            full_src_name = win32api.GetFullPathName(full_src_name)
+        if isdir(full_src_name, local):
+            if recurse and src_name not in [".", ".."]:
+                new_spec = os.path.join(full_src_name, raw_spec)
+                files = files + BuildFileList(
+                    new_spec,
+                    local,
+                    1,
+                    filter,
+                    filter_args,
+                    os.path.join(recursed_path, src_name),
+                )
+        if fnmatch.fnmatch(src_name, raw_spec):
+            rel_name = os.path.join(recursed_path, src_name)
+            filter_data = filter(full_src_name, rel_name, info, local, filter_args)
+            if filter_data is not None:
+                files.append((full_src_name, info, filter_data))
+    return files
+
+
+def _copyfilter(full_name, rel_name, info, local, bMaintainDir):
+    if isdir(full_name, local):
+        return
+    if bMaintainDir:
+        return rel_name
+    return os.path.split(rel_name)[1]
+
+
+import pywin.dialogs.status
+import win32ui
+
+
+class FileCopyProgressDialog(pywin.dialogs.status.CStatusProgressDialog):
+    def CopyProgress(self, bytes):
+        self.Set(bytes / 1024)
+
+
+def copy(args):
+    """copy src [src ...],  dest
+    Copy files to/from the CE device
+    """
+    bRecurse = bVerbose = 0
+    bMaintainDir = 1
+    try:
+        opts, args = getopt.getopt(args, "rv")
+    except getopt.error as details:
+        raise InvalidUsage(details)
+    for o, v in opts:
+        if o == "-r":
+            bRecuse = 1
+        elif o == "-v":
+            bVerbose = 1
+
+    if len(args) < 2:
+        raise InvalidUsage("Must specify a source and destination")
+
+    src = args[:-1]
+    dest = args[-1]
+    # See if WCE: leading anywhere indicates a direction.
+    if string.find(src[0], "WCE:") == 0:
+        bToDevice = 0
+    elif string.find(dest, "WCE:") == 0:
+        bToDevice = 1
+    else:
+        # Assume copy to device.
+        bToDevice = 1
+
+    if not isdir(dest, not bToDevice):
+        print("%s does not indicate a directory")
+
+    files = []  # List of FQ (from_name, to_name)
+    num_files = 0
+    num_bytes = 0
+    dialog = FileCopyProgressDialog("Copying files")
+    dialog.CreateWindow(win32ui.GetMainFrame())
+    if bToDevice:
+        for spec in src:
+            new = BuildFileList(spec, 1, bRecurse, _copyfilter, bMaintainDir)
+            if not new:
+                print("Warning: '%s' did not match any files" % (spec))
+            files = files + new
+
+        for full_src, src_info, dest_info in files:
+            dest_name = os.path.join(dest, dest_info)
+            size = src_info[5]
+            print("Size=", size)
+            if bVerbose:
+                print(full_src, "->", dest_name, "- ", end=" ")
+            dialog.SetText(dest_name)
+            dialog.Set(0, size / 1024)
+            bytes = CopyFileToCe(full_src, dest_name, dialog.CopyProgress)
+            num_bytes = num_bytes + bytes
+            if bVerbose:
+                print(bytes, "bytes")
+            num_files = num_files + 1
+    dialog.Close()
+    print("%d files copied (%d bytes)" % (num_files, num_bytes))
+
+
+def _dirfilter(*args):
+    return args[1]
+
+
+def dir(args):
+    """dir directory_name ...
+    Perform a directory listing on the remote device
+    """
+    bRecurse = 0
+    try:
+        opts, args = getopt.getopt(args, "r")
+    except getopt.error as details:
+        raise InvalidUsage(details)
+    for o, v in opts:
+        if o == "-r":
+            bRecurse = 1
+    for arg in args:
+        print("Directory of WCE:%s" % arg)
+        files = BuildFileList(arg, 0, bRecurse, _dirfilter, None)
+        total_size = 0
+        for full_name, info, rel_name in files:
+            date_str = info[3].Format("%d-%b-%Y %H:%M")
+            attr_string = "     "
+            if info[0] & win32con.FILE_ATTRIBUTE_DIRECTORY:
+                attr_string = "<DIR>"
+            print("%s  %s %10d %s" % (date_str, attr_string, info[5], rel_name))
+            total_size = total_size + info[5]
+        print(" " * 14 + "%3d files, %10d bytes" % (len(files), total_size))
+
+
+def run(args):
+    """run program [args]
+    Starts the specified program on the remote device.
+    """
+    prog_args = []
+    for arg in args:
+        if " " in arg:
+            prog_args.append('"' + arg + '"')
+        else:
+            prog_args.append(arg)
+    prog_args = string.join(prog_args, " ")
+    wincerapi.CeCreateProcess(prog_args, "", None, None, 0, 0, None, "", None)
+
+
+def delete(args):
+    """delete file, ...
+    Delete one or more remote files
+    """
+    for arg in args:
+        try:
+            wincerapi.CeDeleteFile(arg)
+            print("Deleted: %s" % arg)
+        except win32api.error as details:
+            print_error(details, "Error deleting '%s'" % arg)
+
+
+def DumpCommands():
+    print("%-10s - %s" % ("Command", "Description"))
+    print("%-10s - %s" % ("-------", "-----------"))
+    for name, item in list(globals().items()):
+        if type(item) == type(DumpCommands):
+            doc = getattr(item, "__doc__", "")
+            if doc:
+                lines = string.split(doc, "\n")
+                print("%-10s - %s" % (name, lines[0]))
+                for line in lines[1:]:
+                    if line:
+                        print(" " * 8, line)
+
+
+def main():
+    if len(sys.argv) < 2:
+        print("You must specify a command!")
+        DumpCommands()
+        return
+    command = sys.argv[1]
+    fn = globals().get(command)
+    if fn is None:
+        print("Unknown command:", command)
+        DumpCommands()
+        return
+
+    wincerapi.CeRapiInit()
+    try:
+        verinfo = wincerapi.CeGetVersionEx()
+        print(
+            "Connected to device, CE version %d.%d %s"
+            % (verinfo[0], verinfo[1], verinfo[4])
+        )
+        try:
+            fn(sys.argv[2:])
+        except InvalidUsage as msg:
+            print("Invalid syntax -", msg)
+            print(fn.__doc__)
+
+    finally:
+        try:
+            wincerapi.CeRapiUninit()
+        except win32api.error as details:
+            print_error(details, "Error disconnecting")
+
+
+if __name__ == "__main__":
+    main()
diff --git a/lib/win32/scripts/killProcName.py b/lib/win32/scripts/killProcName.py
new file mode 100644
index 00000000..c9b399ff
--- /dev/null
+++ b/lib/win32/scripts/killProcName.py
@@ -0,0 +1,62 @@
+# Kills a process by process name
+#
+# Uses the Performance Data Helper to locate the PID, then kills it.
+# Will only kill the process if there is only one process of that name
+# (eg, attempting to kill "Python.exe" will only work if there is only
+# one Python.exe running.  (Note that the current process does not
+# count - ie, if Python.exe is hosting this script, you can still kill
+# another Python.exe (as long as there is only one other Python.exe)
+
+# Really just a demo for the win32pdh(util) module, which allows you
+# to get all sorts of information about a running process and many
+# other aspects of your system.
+
+import sys
+
+import win32api
+import win32con
+import win32pdhutil
+
+
+def killProcName(procname):
+    # Change suggested by Dan Knierim, who found that this performed a
+    # "refresh", allowing us to kill processes created since this was run
+    # for the first time.
+    try:
+        win32pdhutil.GetPerformanceAttributes("Process", "ID Process", procname)
+    except:
+        pass
+
+    pids = win32pdhutil.FindPerformanceAttributesByName(procname)
+
+    # If _my_ pid in there, remove it!
+    try:
+        pids.remove(win32api.GetCurrentProcessId())
+    except ValueError:
+        pass
+
+    if len(pids) == 0:
+        result = "Can't find %s" % procname
+    elif len(pids) > 1:
+        result = "Found too many %s's - pids=`%s`" % (procname, pids)
+    else:
+        handle = win32api.OpenProcess(win32con.PROCESS_TERMINATE, 0, pids[0])
+        win32api.TerminateProcess(handle, 0)
+        win32api.CloseHandle(handle)
+        result = ""
+
+    return result
+
+
+if __name__ == "__main__":
+    if len(sys.argv) > 1:
+        for procname in sys.argv[1:]:
+            result = killProcName(procname)
+            if result:
+                print(result)
+                print("Dumping all processes...")
+                win32pdhutil.ShowAllProcesses()
+            else:
+                print("Killed %s" % procname)
+    else:
+        print("Usage: killProcName.py procname ...")
diff --git a/lib/win32/scripts/rasutil.py b/lib/win32/scripts/rasutil.py
new file mode 100644
index 00000000..e5a8922d
--- /dev/null
+++ b/lib/win32/scripts/rasutil.py
@@ -0,0 +1,97 @@
+# A demo of using the RAS API from Python
+import sys
+
+import win32ras
+
+
+# The error raised if we can not
+class ConnectionError(Exception):
+    pass
+
+
+def Connect(rasEntryName, numRetries=5):
+    """Make a connection to the specified RAS entry.
+
+    Returns a tuple of (bool, handle) on success.
+    - bool is 1 if a new connection was established, or 0 is a connection already existed.
+    - handle is a RAS HANDLE that can be passed to Disconnect() to end the connection.
+
+    Raises a ConnectionError if the connection could not be established.
+    """
+    assert numRetries > 0
+    for info in win32ras.EnumConnections():
+        if info[1].lower() == rasEntryName.lower():
+            print("Already connected to", rasEntryName)
+            return 0, info[0]
+
+    dial_params, have_pw = win32ras.GetEntryDialParams(None, rasEntryName)
+    if not have_pw:
+        print("Error: The password is not saved for this connection")
+        print(
+            "Please connect manually selecting the 'save password' option and try again"
+        )
+        sys.exit(1)
+
+    print("Connecting to", rasEntryName, "...")
+    retryCount = numRetries
+    while retryCount > 0:
+        rasHandle, errCode = win32ras.Dial(None, None, dial_params, None)
+        if win32ras.IsHandleValid(rasHandle):
+            bValid = 1
+            break
+        print("Retrying...")
+        win32api.Sleep(5000)
+        retryCount = retryCount - 1
+
+    if errCode:
+        raise ConnectionError(errCode, win32ras.GetErrorString(errCode))
+    return 1, rasHandle
+
+
+def Disconnect(handle):
+    if type(handle) == type(""):  # have they passed a connection name?
+        for info in win32ras.EnumConnections():
+            if info[1].lower() == handle.lower():
+                handle = info[0]
+                break
+        else:
+            raise ConnectionError(0, "Not connected to entry '%s'" % handle)
+
+    win32ras.HangUp(handle)
+
+
+usage = """rasutil.py - Utilities for using RAS
+
+Usage:
+  rasutil [-r retryCount] [-c rasname] [-d rasname]
+  
+  -r retryCount - Number of times to retry the RAS connection
+  -c rasname - Connect to the phonebook entry specified by rasname
+  -d rasname - Disconnect from the phonebook entry specified by rasname
+"""
+
+
+def Usage(why):
+    print(why)
+    print(usage)
+    sys.exit(1)
+
+
+if __name__ == "__main__":
+    import getopt
+
+    try:
+        opts, args = getopt.getopt(sys.argv[1:], "r:c:d:")
+    except getopt.error as why:
+        Usage(why)
+    retries = 5
+    if len(args) != 0:
+        Usage("Invalid argument")
+
+    for opt, val in opts:
+        if opt == "-c":
+            Connect(val, retries)
+        if opt == "-d":
+            Disconnect(val)
+        if opt == "-r":
+            retries = int(val)
diff --git a/lib/win32/scripts/regsetup.py b/lib/win32/scripts/regsetup.py
new file mode 100644
index 00000000..885698e1
--- /dev/null
+++ b/lib/win32/scripts/regsetup.py
@@ -0,0 +1,612 @@
+# A tool to setup the Python registry.
+
+
+class error(Exception):
+    pass
+
+
+import sys  # at least we can count on this!
+
+
+def FileExists(fname):
+    """Check if a file exists.  Returns true or false."""
+    import os
+
+    try:
+        os.stat(fname)
+        return 1
+    except os.error as details:
+        return 0
+
+
+def IsPackageDir(path, packageName, knownFileName):
+    """Given a path, a ni package name, and possibly a known file name in
+    the root of the package, see if this path is good.
+    """
+    import os
+
+    if knownFileName is None:
+        knownFileName = "."
+    return FileExists(os.path.join(os.path.join(path, packageName), knownFileName))
+
+
+def IsDebug():
+    """Return "_d" if we're running a debug version.
+
+    This is to be used within DLL names when locating them.
+    """
+    import importlib.machinery
+
+    return "_d" if "_d.pyd" in importlib.machinery.EXTENSION_SUFFIXES else ""
+
+
+def FindPackagePath(packageName, knownFileName, searchPaths):
+    """Find a package.
+
+    Given a ni style package name, check the package is registered.
+
+    First place looked is the registry for an existing entry.  Then
+    the searchPaths are searched.
+    """
+    import os
+
+    import regutil
+
+    pathLook = regutil.GetRegisteredNamedPath(packageName)
+    if pathLook and IsPackageDir(pathLook, packageName, knownFileName):
+        return pathLook, None  # The currently registered one is good.
+    # Search down the search paths.
+    for pathLook in searchPaths:
+        if IsPackageDir(pathLook, packageName, knownFileName):
+            # Found it
+            ret = os.path.abspath(pathLook)
+            return ret, ret
+    raise error("The package %s can not be located" % packageName)
+
+
+def FindHelpPath(helpFile, helpDesc, searchPaths):
+    # See if the current registry entry is OK
+    import os
+
+    import win32api
+    import win32con
+
+    try:
+        key = win32api.RegOpenKey(
+            win32con.HKEY_LOCAL_MACHINE,
+            "Software\\Microsoft\\Windows\\Help",
+            0,
+            win32con.KEY_ALL_ACCESS,
+        )
+        try:
+            try:
+                path = win32api.RegQueryValueEx(key, helpDesc)[0]
+                if FileExists(os.path.join(path, helpFile)):
+                    return os.path.abspath(path)
+            except win32api.error:
+                pass  # no registry entry.
+        finally:
+            key.Close()
+    except win32api.error:
+        pass
+    for pathLook in searchPaths:
+        if FileExists(os.path.join(pathLook, helpFile)):
+            return os.path.abspath(pathLook)
+        pathLook = os.path.join(pathLook, "Help")
+        if FileExists(os.path.join(pathLook, helpFile)):
+            return os.path.abspath(pathLook)
+    raise error("The help file %s can not be located" % helpFile)
+
+
+def FindAppPath(appName, knownFileName, searchPaths):
+    """Find an application.
+
+    First place looked is the registry for an existing entry.  Then
+    the searchPaths are searched.
+    """
+    # Look in the first path.
+    import os
+
+    import regutil
+
+    regPath = regutil.GetRegisteredNamedPath(appName)
+    if regPath:
+        pathLook = regPath.split(";")[0]
+    if regPath and FileExists(os.path.join(pathLook, knownFileName)):
+        return None  # The currently registered one is good.
+    # Search down the search paths.
+    for pathLook in searchPaths:
+        if FileExists(os.path.join(pathLook, knownFileName)):
+            # Found it
+            return os.path.abspath(pathLook)
+    raise error(
+        "The file %s can not be located for application %s" % (knownFileName, appName)
+    )
+
+
+def FindPythonExe(exeAlias, possibleRealNames, searchPaths):
+    """Find an exe.
+
+    Returns the full path to the .exe, and a boolean indicating if the current
+    registered entry is OK.  We don't trust the already registered version even
+    if it exists - it may be wrong (ie, for a different Python version)
+    """
+    import os
+    import sys
+
+    import regutil
+    import win32api
+
+    if possibleRealNames is None:
+        possibleRealNames = exeAlias
+    # Look first in Python's home.
+    found = os.path.join(sys.prefix, possibleRealNames)
+    if not FileExists(found):  # for developers
+        if "64 bit" in sys.version:
+            found = os.path.join(sys.prefix, "PCBuild", "amd64", possibleRealNames)
+        else:
+            found = os.path.join(sys.prefix, "PCBuild", possibleRealNames)
+    if not FileExists(found):
+        found = LocateFileName(possibleRealNames, searchPaths)
+
+    registered_ok = 0
+    try:
+        registered = win32api.RegQueryValue(
+            regutil.GetRootKey(), regutil.GetAppPathsKey() + "\\" + exeAlias
+        )
+        registered_ok = found == registered
+    except win32api.error:
+        pass
+    return found, registered_ok
+
+
+def QuotedFileName(fname):
+    """Given a filename, return a quoted version if necessary"""
+
+    import regutil
+
+    try:
+        fname.index(" ")  # Other chars forcing quote?
+        return '"%s"' % fname
+    except ValueError:
+        # No space in name.
+        return fname
+
+
+def LocateFileName(fileNamesString, searchPaths):
+    """Locate a file name, anywhere on the search path.
+
+    If the file can not be located, prompt the user to find it for us
+    (using a common OpenFile dialog)
+
+    Raises KeyboardInterrupt if the user cancels.
+    """
+    import os
+
+    import regutil
+
+    fileNames = fileNamesString.split(";")
+    for path in searchPaths:
+        for fileName in fileNames:
+            try:
+                retPath = os.path.join(path, fileName)
+                os.stat(retPath)
+                break
+            except os.error:
+                retPath = None
+        if retPath:
+            break
+    else:
+        fileName = fileNames[0]
+        try:
+            import win32con
+            import win32ui
+        except ImportError:
+            raise error(
+                "Need to locate the file %s, but the win32ui module is not available\nPlease run the program again, passing as a parameter the path to this file."
+                % fileName
+            )
+        # Display a common dialog to locate the file.
+        flags = win32con.OFN_FILEMUSTEXIST
+        ext = os.path.splitext(fileName)[1]
+        filter = "Files of requested type (*%s)|*%s||" % (ext, ext)
+        dlg = win32ui.CreateFileDialog(1, None, fileName, flags, filter, None)
+        dlg.SetOFNTitle("Locate " + fileName)
+        if dlg.DoModal() != win32con.IDOK:
+            raise KeyboardInterrupt("User cancelled the process")
+        retPath = dlg.GetPathName()
+    return os.path.abspath(retPath)
+
+
+def LocatePath(fileName, searchPaths):
+    """Like LocateFileName, but returns a directory only."""
+    import os
+
+    return os.path.abspath(os.path.split(LocateFileName(fileName, searchPaths))[0])
+
+
+def LocateOptionalPath(fileName, searchPaths):
+    """Like LocatePath, but returns None if the user cancels."""
+    try:
+        return LocatePath(fileName, searchPaths)
+    except KeyboardInterrupt:
+        return None
+
+
+def LocateOptionalFileName(fileName, searchPaths=None):
+    """Like LocateFileName, but returns None if the user cancels."""
+    try:
+        return LocateFileName(fileName, searchPaths)
+    except KeyboardInterrupt:
+        return None
+
+
+def LocatePythonCore(searchPaths):
+    """Locate and validate the core Python directories.  Returns a list
+    of paths that should be used as the core (ie, un-named) portion of
+    the Python path.
+    """
+    import os
+
+    import regutil
+
+    currentPath = regutil.GetRegisteredNamedPath(None)
+    if currentPath:
+        presearchPaths = currentPath.split(";")
+    else:
+        presearchPaths = [os.path.abspath(".")]
+    libPath = None
+    for path in presearchPaths:
+        if FileExists(os.path.join(path, "os.py")):
+            libPath = path
+            break
+    if libPath is None and searchPaths is not None:
+        libPath = LocatePath("os.py", searchPaths)
+    if libPath is None:
+        raise error("The core Python library could not be located.")
+
+    corePath = None
+    suffix = IsDebug()
+    for path in presearchPaths:
+        if FileExists(os.path.join(path, "unicodedata%s.pyd" % suffix)):
+            corePath = path
+            break
+    if corePath is None and searchPaths is not None:
+        corePath = LocatePath("unicodedata%s.pyd" % suffix, searchPaths)
+    if corePath is None:
+        raise error("The core Python path could not be located.")
+
+    installPath = os.path.abspath(os.path.join(libPath, ".."))
+    return installPath, [libPath, corePath]
+
+
+def FindRegisterPackage(packageName, knownFile, searchPaths, registryAppName=None):
+    """Find and Register a package.
+
+    Assumes the core registry setup correctly.
+
+    In addition, if the location located by the package is already
+    in the **core** path, then an entry is registered, but no path.
+    (no other paths are checked, as the application whose path was used
+    may later be uninstalled.  This should not happen with the core)
+    """
+
+    import regutil
+
+    if not packageName:
+        raise error("A package name must be supplied")
+    corePaths = regutil.GetRegisteredNamedPath(None).split(";")
+    if not searchPaths:
+        searchPaths = corePaths
+    registryAppName = registryAppName or packageName
+    try:
+        pathLook, pathAdd = FindPackagePath(packageName, knownFile, searchPaths)
+        if pathAdd is not None:
+            if pathAdd in corePaths:
+                pathAdd = ""
+            regutil.RegisterNamedPath(registryAppName, pathAdd)
+        return pathLook
+    except error as details:
+        print(
+            "*** The %s package could not be registered - %s" % (packageName, details)
+        )
+        print(
+            "*** Please ensure you have passed the correct paths on the command line."
+        )
+        print(
+            "*** - For packages, you should pass a path to the packages parent directory,"
+        )
+        print("*** - and not the package directory itself...")
+
+
+def FindRegisterApp(appName, knownFiles, searchPaths):
+    """Find and Register a package.
+
+    Assumes the core registry setup correctly.
+
+    """
+
+    import regutil
+
+    if type(knownFiles) == type(""):
+        knownFiles = [knownFiles]
+    paths = []
+    try:
+        for knownFile in knownFiles:
+            pathLook = FindAppPath(appName, knownFile, searchPaths)
+            if pathLook:
+                paths.append(pathLook)
+    except error as details:
+        print("*** ", details)
+        return
+
+    regutil.RegisterNamedPath(appName, ";".join(paths))
+
+
+def FindRegisterPythonExe(exeAlias, searchPaths, actualFileNames=None):
+    """Find and Register a Python exe (not necessarily *the* python.exe)
+
+    Assumes the core registry setup correctly.
+    """
+
+    import regutil
+
+    fname, ok = FindPythonExe(exeAlias, actualFileNames, searchPaths)
+    if not ok:
+        regutil.RegisterPythonExe(fname, exeAlias)
+    return fname
+
+
+def FindRegisterHelpFile(helpFile, searchPaths, helpDesc=None):
+    import regutil
+
+    try:
+        pathLook = FindHelpPath(helpFile, helpDesc, searchPaths)
+    except error as details:
+        print("*** ", details)
+        return
+    #       print "%s found at %s" % (helpFile, pathLook)
+    regutil.RegisterHelpFile(helpFile, pathLook, helpDesc)
+
+
+def SetupCore(searchPaths):
+    """Setup the core Python information in the registry.
+
+    This function makes no assumptions about the current state of sys.path.
+
+    After this function has completed, you should have access to the standard
+    Python library, and the standard Win32 extensions
+    """
+
+    import sys
+
+    for path in searchPaths:
+        sys.path.append(path)
+
+    import os
+
+    import regutil
+    import win32api
+    import win32con
+
+    installPath, corePaths = LocatePythonCore(searchPaths)
+    # Register the core Pythonpath.
+    print(corePaths)
+    regutil.RegisterNamedPath(None, ";".join(corePaths))
+
+    # Register the install path.
+    hKey = win32api.RegCreateKey(regutil.GetRootKey(), regutil.BuildDefaultPythonKey())
+    try:
+        # Core Paths.
+        win32api.RegSetValue(hKey, "InstallPath", win32con.REG_SZ, installPath)
+    finally:
+        win32api.RegCloseKey(hKey)
+
+    # Register the win32 core paths.
+    win32paths = (
+        os.path.abspath(os.path.split(win32api.__file__)[0])
+        + ";"
+        + os.path.abspath(
+            os.path.split(LocateFileName("win32con.py;win32con.pyc", sys.path))[0]
+        )
+    )
+
+    # Python has builtin support for finding a "DLLs" directory, but
+    # not a PCBuild.  Having it in the core paths means it is ignored when
+    # an EXE not in the Python dir is hosting us - so we add it as a named
+    # value
+    check = os.path.join(sys.prefix, "PCBuild")
+    if "64 bit" in sys.version:
+        check = os.path.join(check, "amd64")
+    if os.path.isdir(check):
+        regutil.RegisterNamedPath("PCBuild", check)
+
+
+def RegisterShellInfo(searchPaths):
+    """Registers key parts of the Python installation with the Windows Shell.
+
+    Assumes a valid, minimal Python installation exists
+    (ie, SetupCore() has been previously successfully run)
+    """
+    import regutil
+    import win32con
+
+    suffix = IsDebug()
+    # Set up a pointer to the .exe's
+    exePath = FindRegisterPythonExe("Python%s.exe" % suffix, searchPaths)
+    regutil.SetRegistryDefaultValue(".py", "Python.File", win32con.HKEY_CLASSES_ROOT)
+    regutil.RegisterShellCommand("Open", QuotedFileName(exePath) + ' "%1" %*', "&Run")
+    regutil.SetRegistryDefaultValue(
+        "Python.File\\DefaultIcon", "%s,0" % exePath, win32con.HKEY_CLASSES_ROOT
+    )
+
+    FindRegisterHelpFile("Python.hlp", searchPaths, "Main Python Documentation")
+    FindRegisterHelpFile("ActivePython.chm", searchPaths, "Main Python Documentation")
+
+    # We consider the win32 core, as it contains all the win32 api type
+    # stuff we need.
+
+
+#       FindRegisterApp("win32", ["win32con.pyc", "win32api%s.pyd" % suffix], searchPaths)
+
+usage = (
+    """\
+regsetup.py - Setup/maintain the registry for Python apps.
+
+Run without options, (but possibly search paths) to repair a totally broken
+python registry setup.  This should allow other options to work.
+
+Usage:   %s [options ...] paths ...
+-p packageName  -- Find and register a package.  Looks in the paths for
+                   a sub-directory with the name of the package, and
+                   adds a path entry for the package.
+-a appName      -- Unconditionally add an application name to the path.
+                   A new path entry is create with the app name, and the
+                   paths specified are added to the registry.
+-c              -- Add the specified paths to the core Pythonpath.
+                   If a path appears on the core path, and a package also
+                   needs that same path, the package will not bother
+                   registering it.  Therefore, By adding paths to the
+                   core path, you can avoid packages re-registering the same path.
+-m filename     -- Find and register the specific file name as a module.
+                   Do not include a path on the filename!
+--shell         -- Register everything with the Win95/NT shell.
+--upackage name -- Unregister the package
+--uapp name     -- Unregister the app (identical to --upackage)
+--umodule name  -- Unregister the module
+
+--description   -- Print a description of the usage.
+--examples      -- Print examples of usage.
+"""
+    % sys.argv[0]
+)
+
+description = """\
+If no options are processed, the program attempts to validate and set
+the standard Python path to the point where the standard library is
+available.  This can be handy if you move Python to a new drive/sub-directory,
+in which case most of the options would fail (as they need at least string.py,
+os.py etc to function.)
+Running without options should repair Python well enough to run with
+the other options.
+
+paths are search paths that the program will use to seek out a file.
+For example, when registering the core Python, you may wish to
+provide paths to non-standard places to look for the Python help files,
+library files, etc.
+
+See also the "regcheck.py" utility which will check and dump the contents
+of the registry.
+"""
+
+examples = """\
+Examples:
+"regsetup c:\\wierd\\spot\\1 c:\\wierd\\spot\\2"
+Attempts to setup the core Python.  Looks in some standard places,
+as well as the 2 wierd spots to locate the core Python files (eg, Python.exe,
+python14.dll, the standard library and Win32 Extensions.
+
+"regsetup -a myappname . .\subdir"
+Registers a new Pythonpath entry named myappname, with "C:\\I\\AM\\HERE" and
+"C:\\I\\AM\\HERE\subdir" added to the path (ie, all args are converted to
+absolute paths)
+
+"regsetup -c c:\\my\\python\\files"
+Unconditionally add "c:\\my\\python\\files" to the 'core' Python path.
+
+"regsetup -m some.pyd \\windows\\system"
+Register the module some.pyd in \\windows\\system as a registered
+module.  This will allow some.pyd to be imported, even though the
+windows system directory is not (usually!) on the Python Path.
+
+"regsetup --umodule some"
+Unregister the module "some".  This means normal import rules then apply
+for that module.
+"""
+
+if __name__ == "__main__":
+    if len(sys.argv) > 1 and sys.argv[1] in ["/?", "-?", "-help", "-h"]:
+        print(usage)
+    elif len(sys.argv) == 1 or not sys.argv[1][0] in ["/", "-"]:
+        # No args, or useful args.
+        searchPath = sys.path[:]
+        for arg in sys.argv[1:]:
+            searchPath.append(arg)
+        # Good chance we are being run from the "regsetup.py" directory.
+        # Typically this will be "\somewhere\win32\Scripts" and the
+        # "somewhere" and "..\Lib" should also be searched.
+        searchPath.append("..\\Build")
+        searchPath.append("..\\Lib")
+        searchPath.append("..")
+        searchPath.append("..\\..")
+
+        # for developers:
+        # also search somewhere\lib, ..\build, and ..\..\build
+        searchPath.append("..\\..\\lib")
+        searchPath.append("..\\build")
+        if "64 bit" in sys.version:
+            searchPath.append("..\\..\\pcbuild\\amd64")
+        else:
+            searchPath.append("..\\..\\pcbuild")
+
+        print("Attempting to setup/repair the Python core")
+
+        SetupCore(searchPath)
+        RegisterShellInfo(searchPath)
+        FindRegisterHelpFile("PyWin32.chm", searchPath, "Pythonwin Reference")
+        # Check the registry.
+        print("Registration complete - checking the registry...")
+        import regcheck
+
+        regcheck.CheckRegistry()
+    else:
+        searchPaths = []
+        import getopt
+
+        opts, args = getopt.getopt(
+            sys.argv[1:],
+            "p:a:m:c",
+            ["shell", "upackage=", "uapp=", "umodule=", "description", "examples"],
+        )
+        for arg in args:
+            searchPaths.append(arg)
+        for o, a in opts:
+            if o == "--description":
+                print(description)
+            if o == "--examples":
+                print(examples)
+            if o == "--shell":
+                print("Registering the Python core.")
+                RegisterShellInfo(searchPaths)
+            if o == "-p":
+                print("Registering package", a)
+                FindRegisterPackage(a, None, searchPaths)
+            if o in ["--upackage", "--uapp"]:
+                import regutil
+
+                print("Unregistering application/package", a)
+                regutil.UnregisterNamedPath(a)
+            if o == "-a":
+                import regutil
+
+                path = ";".join(searchPaths)
+                print("Registering application", a, "to path", path)
+                regutil.RegisterNamedPath(a, path)
+            if o == "-c":
+                if not len(searchPaths):
+                    raise error("-c option must provide at least one additional path")
+                import regutil
+                import win32api
+
+                currentPaths = regutil.GetRegisteredNamedPath(None).split(";")
+                oldLen = len(currentPaths)
+                for newPath in searchPaths:
+                    if newPath not in currentPaths:
+                        currentPaths.append(newPath)
+                if len(currentPaths) != oldLen:
+                    print(
+                        "Registering %d new core paths" % (len(currentPaths) - oldLen)
+                    )
+                    regutil.RegisterNamedPath(None, ";".join(currentPaths))
+                else:
+                    print("All specified paths are already registered.")
diff --git a/lib/win32/scripts/setup_d.py b/lib/win32/scripts/setup_d.py
new file mode 100644
index 00000000..babd8359
--- /dev/null
+++ b/lib/win32/scripts/setup_d.py
@@ -0,0 +1,110 @@
+# Install and register pythonxx_d.dll, pywintypesxx_d.dll and pythoncomxx_d.dll
+#
+# Assumes the _d files can be found in the same directory as this script
+# or in the cwd.
+
+import os
+import shutil
+import sys
+import winreg
+
+import win32api
+
+
+def usage_and_die(rc):
+    print()
+    print("This script is designed to copy and register the Python debug")
+    print("binaries.  It looks for pythonxx_d.dll, pythoncomxx_d.dll etc,")
+    print("and installs them to work correctly with Python debug builds.")
+    print()
+    print("You will generally find this script in the. zip file that")
+    print("included these _d files.  Please run this script from")
+    print("that directory")
+    sys.exit(rc)
+
+
+if win32api.__file__.find("_d") > 0:
+    print("This scripts appears to be running a DEBUG version of Python.")
+    print("Please run it using a normal release build (python.exe)")
+    usage_and_die(1)
+
+try:
+    import pythoncom
+except ImportError as details:
+    print("Could not import the release version of pythoncom")
+    print("The error details are: %s" % (details,))
+    print("Please correct this error and rerun the script")
+    usage_and_die(2)
+
+try:
+    import pywintypes
+except ImportError as details:
+    print("Could not import the release version of pywintypes")
+    print("The error details are: %s" % (details,))
+    print("Please correct this error and rerun the script")
+    usage_and_die(2)
+
+
+def _docopy(src, dest):
+    orig_src = src
+    if not os.path.isfile(src):
+        src = os.path.join(os.path.split(sys.argv[0])[0], src)
+        print(
+            "Can not find %s or %s to copy"
+            % (os.path.abspath(orig_src), os.path.abspath(src))
+        )
+        return 0
+    try:
+        shutil.copy(src, dest)
+        print("Copied %s -> %s" % (src, dest))
+        return 1
+    except:
+        print("Error copying '%s' -> '%s'" % (src, dest))
+        print(str(sys.exc_info[1]))
+        usage_and_die(3)
+
+
+def _doregister(mod_name, dll_name):
+    assert os.path.isfile(dll_name), "Shouldn't get here if the file doesn't exist!"
+    try:
+        key = winreg.OpenKey(
+            winreg.HKEY_LOCAL_MACHINE,
+            "Software\\Python\\PythonCore\\%s\\Modules\\%s" % (sys.winver, mod_name),
+        )
+    except winreg.error:
+        try:
+            key = winreg.OpenKey(
+                winreg.HKEY_LOCAL_MACHINE,
+                "Software\\Python\\PythonCore\\%s\\Modules\\%s"
+                % (sys.winver, mod_name),
+            )
+        except winreg.error:
+            print(
+                "Could not find the existing '%s' module registered in the registry"
+                % (mod_name,)
+            )
+            usage_and_die(4)
+    # Create the debug key.
+    sub_key = winreg.CreateKey(key, "Debug")
+    winreg.SetValue(sub_key, None, winreg.REG_SZ, dll_name)
+    print("Registered '%s' in the registry" % (dll_name,))
+
+
+def _domodule(mod_name, release_mod_filename):
+    path, fname = os.path.split(release_mod_filename)
+    base, ext = os.path.splitext(fname)
+    new_fname = base + "_d" + ext
+    if _docopy(new_fname, path):
+        _doregister(mod_name, os.path.abspath(os.path.join(path, new_fname)))
+
+
+# First the main Python DLL.
+path, fname = path, fname = os.path.split(win32api.GetModuleFileName(sys.dllhandle))
+base, ext = os.path.splitext(fname)
+_docopy(base + "_d" + ext, path)
+
+# Then pythoncom and pywintypes.
+_domodule("pythoncom", pythoncom.__file__)
+_domodule("pywintypes", pywintypes.__file__)
+
+print("System _d files were setup.")
diff --git a/lib/win32/test/handles.py b/lib/win32/test/handles.py
new file mode 100644
index 00000000..ad607353
--- /dev/null
+++ b/lib/win32/test/handles.py
@@ -0,0 +1,171 @@
+import sys
+import unittest
+
+import pywintypes
+import win32api
+
+
+# A class that will never die vie refcounting, but will die via GC.
+class Cycle:
+    def __init__(self, handle):
+        self.cycle = self
+        self.handle = handle
+
+
+class PyHandleTestCase(unittest.TestCase):
+    def testCleanup1(self):
+        # We used to clobber all outstanding exceptions.
+        def f1(invalidate):
+            import win32event
+
+            h = win32event.CreateEvent(None, 0, 0, None)
+            if invalidate:
+                win32api.CloseHandle(int(h))
+            1 / 0
+            # If we invalidated, then the object destruction code will attempt
+            # to close an invalid handle.  We don't wan't an exception in
+            # this case
+
+        def f2(invalidate):
+            """This function should throw an IOError."""
+            try:
+                f1(invalidate)
+            except ZeroDivisionError as exc:
+                raise IOError("raise 2")
+
+        self.assertRaises(IOError, f2, False)
+        # Now do it again, but so the auto object destruction
+        # actually fails.
+        self.assertRaises(IOError, f2, True)
+
+    def testCleanup2(self):
+        # Cause an exception during object destruction.
+        # The worst this does is cause an ".XXX undetected error (why=3)"
+        # So avoiding that is the goal
+        import win32event
+
+        h = win32event.CreateEvent(None, 0, 0, None)
+        # Close the handle underneath the object.
+        win32api.CloseHandle(int(h))
+        # Object destructor runs with the implicit close failing
+        h = None
+
+    def testCleanup3(self):
+        # And again with a class - no __del__
+        import win32event
+
+        class Test:
+            def __init__(self):
+                self.h = win32event.CreateEvent(None, 0, 0, None)
+                win32api.CloseHandle(int(self.h))
+
+        t = Test()
+        t = None
+
+    def testCleanupGood(self):
+        # And check that normal error semantics *do* work.
+        import win32event
+
+        h = win32event.CreateEvent(None, 0, 0, None)
+        win32api.CloseHandle(int(h))
+        self.assertRaises(win32api.error, h.Close)
+        # A following Close is documented as working
+        h.Close()
+
+    def testInvalid(self):
+        h = pywintypes.HANDLE(-2)
+        try:
+            h.Close()
+            # Ideally, we'd:
+            #     self.assertRaises(win32api.error, h.Close)
+            # and everywhere markh has tried, that would pass - but not on
+            # github automation, where the .Close apparently works fine.
+            # (same for -1. Using 0 appears to work fine everywhere)
+            # There still seems value in testing it though, so we just accept
+            # either working or failing.
+        except win32api.error:
+            pass
+
+    def testOtherHandle(self):
+        h = pywintypes.HANDLE(1)
+        h2 = pywintypes.HANDLE(h)
+        self.assertEqual(h, h2)
+        # but the above doesn't really test everything - we want a way to
+        # pass the handle directly into PyWinLong_AsVoidPtr.  One way to
+        # to that is to abuse win32api.GetProcAddress() - the 2nd param
+        # is passed to PyWinLong_AsVoidPtr() if its not a string.
+        # passing a handle value of '1' should work - there is something
+        # at that ordinal
+        win32api.GetProcAddress(sys.dllhandle, h)
+
+    def testHandleInDict(self):
+        h = pywintypes.HANDLE(1)
+        d = dict(foo=h)
+        self.assertEqual(d["foo"], h)
+
+    def testHandleInDictThenInt(self):
+        h = pywintypes.HANDLE(1)
+        d = dict(foo=h)
+        self.assertEqual(d["foo"], 1)
+
+    def testHandleCompareNone(self):
+        h = pywintypes.HANDLE(1)
+        self.assertNotEqual(h, None)
+        self.assertNotEqual(None, h)
+        # ensure we use both __eq__ and __ne__ ops
+        self.assertFalse(h == None)
+        self.assertTrue(h != None)
+
+    def testHandleCompareInt(self):
+        h = pywintypes.HANDLE(1)
+        self.assertNotEqual(h, 0)
+        self.assertEqual(h, 1)
+        # ensure we use both __eq__ and __ne__ ops
+        self.assertTrue(h == 1)
+        self.assertTrue(1 == h)
+        self.assertFalse(h != 1)
+        self.assertFalse(1 != h)
+        self.assertFalse(h == 0)
+        self.assertFalse(0 == h)
+        self.assertTrue(h != 0)
+        self.assertTrue(0 != h)
+
+    def testHandleNonZero(self):
+        h = pywintypes.HANDLE(0)
+        self.assertFalse(h)
+
+        h = pywintypes.HANDLE(1)
+        self.assertTrue(h)
+
+    def testLong(self):
+        # sys.maxint+1 should always be a 'valid' handle, treated as an
+        # unsigned int, even though it is a long. Although pywin32 should not
+        # directly create such longs, using struct.unpack() with a P format
+        # may well return them. eg:
+        # >>> struct.unpack("P", struct.pack("P", -1))
+        # (4294967295L,)
+        try:
+            big = sys.maxsize
+        except AttributeError:
+            big = sys.maxint
+        pywintypes.HANDLE(big + 1)
+
+    def testGC(self):
+        # This used to provoke:
+        # Fatal Python error: unexpected exception during garbage collection
+        def make():
+            h = pywintypes.HANDLE(-2)
+            c = Cycle(h)
+
+        import gc
+
+        make()
+        gc.collect()
+
+    def testTypes(self):
+        self.assertRaises(TypeError, pywintypes.HANDLE, "foo")
+        self.assertRaises(TypeError, pywintypes.HANDLE, ())
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/lib/win32/test/test_clipboard.py b/lib/win32/test/test_clipboard.py
new file mode 100644
index 00000000..843435b6
--- /dev/null
+++ b/lib/win32/test/test_clipboard.py
@@ -0,0 +1,127 @@
+# General test module for win32api - please add some :)
+import array
+import os
+import sys
+import unittest
+
+import pywintypes
+import win32con
+import win32gui
+from pywin32_testutil import str2bytes
+from win32clipboard import *
+
+custom_format_name = "PythonClipboardTestFormat"
+
+
+class CrashingTestCase(unittest.TestCase):
+    def test_722082(self):
+        class crasher(object):
+            pass
+
+        obj = crasher()
+        OpenClipboard()
+        try:
+            EmptyClipboard()
+            # This used to crash - now correctly raises type error.
+            self.assertRaises(TypeError, SetClipboardData, 0, obj)
+        finally:
+            CloseClipboard()
+
+
+class TestBitmap(unittest.TestCase):
+    def setUp(self):
+        self.bmp_handle = None
+        try:
+            this_file = __file__
+        except NameError:
+            this_file = sys.argv[0]
+        this_dir = os.path.dirname(this_file)
+        self.bmp_name = os.path.join(
+            os.path.abspath(this_dir), "..", "Demos", "images", "smiley.bmp"
+        )
+        self.assertTrue(os.path.isfile(self.bmp_name), self.bmp_name)
+        flags = win32con.LR_DEFAULTSIZE | win32con.LR_LOADFROMFILE
+        self.bmp_handle = win32gui.LoadImage(
+            0, self.bmp_name, win32con.IMAGE_BITMAP, 0, 0, flags
+        )
+        self.assertTrue(self.bmp_handle, "Failed to get a bitmap handle")
+
+    def tearDown(self):
+        if self.bmp_handle:
+            win32gui.DeleteObject(self.bmp_handle)
+
+    def test_bitmap_roundtrip(self):
+        OpenClipboard()
+        try:
+            SetClipboardData(win32con.CF_BITMAP, self.bmp_handle)
+            got_handle = GetClipboardDataHandle(win32con.CF_BITMAP)
+            self.assertEqual(got_handle, self.bmp_handle)
+        finally:
+            CloseClipboard()
+
+
+class TestStrings(unittest.TestCase):
+    def setUp(self):
+        OpenClipboard()
+
+    def tearDown(self):
+        CloseClipboard()
+
+    def test_unicode(self):
+        val = "test-\a9har"
+        SetClipboardData(win32con.CF_UNICODETEXT, val)
+        self.assertEqual(GetClipboardData(win32con.CF_UNICODETEXT), val)
+
+    def test_unicode_text(self):
+        val = "test-val"
+        SetClipboardText(val)
+        # GetClipboardData doesn't to auto string conversions - so on py3k,
+        # CF_TEXT returns bytes.
+        expected = str2bytes(val)
+        self.assertEqual(GetClipboardData(win32con.CF_TEXT), expected)
+        SetClipboardText(val, win32con.CF_UNICODETEXT)
+        self.assertEqual(GetClipboardData(win32con.CF_UNICODETEXT), val)
+
+    def test_string(self):
+        val = str2bytes("test")
+        SetClipboardData(win32con.CF_TEXT, val)
+        self.assertEqual(GetClipboardData(win32con.CF_TEXT), val)
+
+
+class TestGlobalMemory(unittest.TestCase):
+    def setUp(self):
+        OpenClipboard()
+
+    def tearDown(self):
+        CloseClipboard()
+
+    def test_mem(self):
+        val = str2bytes("test")
+        expected = str2bytes("test\0")
+        SetClipboardData(win32con.CF_TEXT, val)
+        # Get the raw data - this will include the '\0'
+        raw_data = GetGlobalMemory(GetClipboardDataHandle(win32con.CF_TEXT))
+        self.assertEqual(expected, raw_data)
+
+    def test_bad_mem(self):
+        self.assertRaises(pywintypes.error, GetGlobalMemory, 0)
+        self.assertRaises(pywintypes.error, GetGlobalMemory, -1)
+        if sys.getwindowsversion()[0] <= 5:
+            # For some reason, the value '1' dies from a 64bit process, but
+            # "works" (ie, gives the correct exception) from a 32bit process.
+            # just silently skip this value on Vista.
+            self.assertRaises(pywintypes.error, GetGlobalMemory, 1)
+
+    def test_custom_mem(self):
+        test_data = str2bytes("hello\x00\xff")
+        test_buffer = array.array("b", test_data)
+        cf = RegisterClipboardFormat(custom_format_name)
+        self.assertEqual(custom_format_name, GetClipboardFormatName(cf))
+        SetClipboardData(cf, test_buffer)
+        hglobal = GetClipboardDataHandle(cf)
+        data = GetGlobalMemory(hglobal)
+        self.assertEqual(data, test_data)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/lib/win32/test/test_exceptions.py b/lib/win32/test/test_exceptions.py
new file mode 100644
index 00000000..33101107
--- /dev/null
+++ b/lib/win32/test/test_exceptions.py
@@ -0,0 +1,223 @@
+"""Test pywin32's error semantics"""
+import sys
+import unittest
+
+import pythoncom
+import pywintypes
+import win32api
+import win32file
+import winerror
+
+
+class TestBase(unittest.TestCase):
+    def _testExceptionIndex(self, exc, index, expected):
+        # check the exception itself can be indexed if not py3k
+        if sys.version_info < (3,):
+            self.assertEqual(exc[index], expected)
+        # and that exception.args can is the same.
+        self.assertEqual(exc.args[index], expected)
+
+
+class TestAPISimple(TestBase):
+    def _getInvalidHandleException(self):
+        try:
+            win32api.CloseHandle(1)
+        except win32api.error as exc:
+            return exc
+        self.fail("Didn't get invalid-handle exception.")
+
+    def testSimple(self):
+        self.assertRaises(pywintypes.error, win32api.CloseHandle, 1)
+
+    def testErrnoIndex(self):
+        exc = self._getInvalidHandleException()
+        self._testExceptionIndex(exc, 0, winerror.ERROR_INVALID_HANDLE)
+
+    def testFuncIndex(self):
+        exc = self._getInvalidHandleException()
+        self._testExceptionIndex(exc, 1, "CloseHandle")
+
+    def testMessageIndex(self):
+        exc = self._getInvalidHandleException()
+        expected = win32api.FormatMessage(winerror.ERROR_INVALID_HANDLE).rstrip()
+        self._testExceptionIndex(exc, 2, expected)
+
+    def testUnpack(self):
+        try:
+            win32api.CloseHandle(1)
+            self.fail("expected exception!")
+        except win32api.error as exc:
+            self.assertEqual(exc.winerror, winerror.ERROR_INVALID_HANDLE)
+            self.assertEqual(exc.funcname, "CloseHandle")
+            expected_msg = win32api.FormatMessage(
+                winerror.ERROR_INVALID_HANDLE
+            ).rstrip()
+            self.assertEqual(exc.strerror, expected_msg)
+
+    def testAsStr(self):
+        exc = self._getInvalidHandleException()
+        err_msg = win32api.FormatMessage(winerror.ERROR_INVALID_HANDLE).rstrip()
+        # early on the result actually *was* a tuple - it must always look like one
+        err_tuple = (winerror.ERROR_INVALID_HANDLE, "CloseHandle", err_msg)
+        self.assertEqual(str(exc), str(err_tuple))
+
+    def testAsTuple(self):
+        exc = self._getInvalidHandleException()
+        err_msg = win32api.FormatMessage(winerror.ERROR_INVALID_HANDLE).rstrip()
+        # early on the result actually *was* a tuple - it must be able to be one
+        err_tuple = (winerror.ERROR_INVALID_HANDLE, "CloseHandle", err_msg)
+        if sys.version_info < (3,):
+            self.assertEqual(tuple(exc), err_tuple)
+        else:
+            self.assertEqual(exc.args, err_tuple)
+
+    def testClassName(self):
+        exc = self._getInvalidHandleException()
+        # The error class has always been named 'error'.  That's not ideal :(
+        self.assertEqual(exc.__class__.__name__, "error")
+
+    def testIdentity(self):
+        exc = self._getInvalidHandleException()
+        self.assertTrue(exc.__class__ is pywintypes.error)
+
+    def testBaseClass(self):
+        self.assertEqual(pywintypes.error.__bases__, (Exception,))
+
+    def testAttributes(self):
+        exc = self._getInvalidHandleException()
+        err_msg = win32api.FormatMessage(winerror.ERROR_INVALID_HANDLE).rstrip()
+        self.assertEqual(exc.winerror, winerror.ERROR_INVALID_HANDLE)
+        self.assertEqual(exc.strerror, err_msg)
+        self.assertEqual(exc.funcname, "CloseHandle")
+
+    # some tests for 'insane' args.
+    def testStrangeArgsNone(self):
+        try:
+            raise pywintypes.error()
+            self.fail("Expected exception")
+        except pywintypes.error as exc:
+            self.assertEqual(exc.args, ())
+            self.assertEqual(exc.winerror, None)
+            self.assertEqual(exc.funcname, None)
+            self.assertEqual(exc.strerror, None)
+
+    def testStrangeArgsNotEnough(self):
+        try:
+            raise pywintypes.error("foo")
+            self.fail("Expected exception")
+        except pywintypes.error as exc:
+            assert exc.args[0] == "foo"
+            # 'winerror' always args[0]
+            self.assertEqual(exc.winerror, "foo")
+            self.assertEqual(exc.funcname, None)
+            self.assertEqual(exc.strerror, None)
+
+    def testStrangeArgsTooMany(self):
+        try:
+            raise pywintypes.error("foo", "bar", "you", "never", "kn", 0)
+            self.fail("Expected exception")
+        except pywintypes.error as exc:
+            self.assertEqual(exc.args[0], "foo")
+            self.assertEqual(exc.args[-1], 0)
+            self.assertEqual(exc.winerror, "foo")
+            self.assertEqual(exc.funcname, "bar")
+            self.assertEqual(exc.strerror, "you")
+
+
+class TestCOMSimple(TestBase):
+    def _getException(self):
+        try:
+            pythoncom.StgOpenStorage("foo", None, 0)
+        except pythoncom.com_error as exc:
+            return exc
+        self.fail("Didn't get storage exception.")
+
+    def testIs(self):
+        self.assertTrue(pythoncom.com_error is pywintypes.com_error)
+
+    def testSimple(self):
+        self.assertRaises(pythoncom.com_error, pythoncom.StgOpenStorage, "foo", None, 0)
+
+    def testErrnoIndex(self):
+        exc = self._getException()
+        self._testExceptionIndex(exc, 0, winerror.STG_E_INVALIDFLAG)
+
+    def testMessageIndex(self):
+        exc = self._getException()
+        expected = win32api.FormatMessage(winerror.STG_E_INVALIDFLAG).rstrip()
+        self._testExceptionIndex(exc, 1, expected)
+
+    def testAsStr(self):
+        exc = self._getException()
+        err_msg = win32api.FormatMessage(winerror.STG_E_INVALIDFLAG).rstrip()
+        # early on the result actually *was* a tuple - it must always look like one
+        err_tuple = (winerror.STG_E_INVALIDFLAG, err_msg, None, None)
+        self.assertEqual(str(exc), str(err_tuple))
+
+    def testAsTuple(self):
+        exc = self._getException()
+        err_msg = win32api.FormatMessage(winerror.STG_E_INVALIDFLAG).rstrip()
+        # early on the result actually *was* a tuple - it must be able to be one
+        err_tuple = (winerror.STG_E_INVALIDFLAG, err_msg, None, None)
+        if sys.version_info < (3,):
+            self.assertEqual(tuple(exc), err_tuple)
+        else:
+            self.assertEqual(exc.args, err_tuple)
+
+    def testClassName(self):
+        exc = self._getException()
+        self.assertEqual(exc.__class__.__name__, "com_error")
+
+    def testIdentity(self):
+        exc = self._getException()
+        self.assertTrue(exc.__class__ is pywintypes.com_error)
+
+    def testBaseClass(self):
+        exc = self._getException()
+        self.assertEqual(pywintypes.com_error.__bases__, (Exception,))
+
+    def testAttributes(self):
+        exc = self._getException()
+        err_msg = win32api.FormatMessage(winerror.STG_E_INVALIDFLAG).rstrip()
+        self.assertEqual(exc.hresult, winerror.STG_E_INVALIDFLAG)
+        self.assertEqual(exc.strerror, err_msg)
+        self.assertEqual(exc.argerror, None)
+        self.assertEqual(exc.excepinfo, None)
+
+    def testStrangeArgsNone(self):
+        try:
+            raise pywintypes.com_error()
+            self.fail("Expected exception")
+        except pywintypes.com_error as exc:
+            self.assertEqual(exc.args, ())
+            self.assertEqual(exc.hresult, None)
+            self.assertEqual(exc.strerror, None)
+            self.assertEqual(exc.argerror, None)
+            self.assertEqual(exc.excepinfo, None)
+
+    def testStrangeArgsNotEnough(self):
+        try:
+            raise pywintypes.com_error("foo")
+            self.fail("Expected exception")
+        except pywintypes.com_error as exc:
+            self.assertEqual(exc.args[0], "foo")
+            self.assertEqual(exc.hresult, "foo")
+            self.assertEqual(exc.strerror, None)
+            self.assertEqual(exc.excepinfo, None)
+            self.assertEqual(exc.argerror, None)
+
+    def testStrangeArgsTooMany(self):
+        try:
+            raise pywintypes.com_error("foo", "bar", "you", "never", "kn", 0)
+            self.fail("Expected exception")
+        except pywintypes.com_error as exc:
+            self.assertEqual(exc.args[0], "foo")
+            self.assertEqual(exc.args[-1], 0)
+            self.assertEqual(exc.hresult, "foo")
+            self.assertEqual(exc.strerror, "bar")
+            self.assertEqual(exc.excepinfo, "you")
+            self.assertEqual(exc.argerror, "never")
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/lib/win32/test/test_odbc.py b/lib/win32/test/test_odbc.py
new file mode 100644
index 00000000..ef2b4516
--- /dev/null
+++ b/lib/win32/test/test_odbc.py
@@ -0,0 +1,267 @@
+# odbc test suite kindly contributed by Frank Millman.
+import os
+import sys
+import tempfile
+import unittest
+
+import odbc
+import pythoncom
+from pywin32_testutil import TestSkipped, str2bytes, str2memory
+from win32com.client import constants
+
+# We use the DAO ODBC driver
+from win32com.client.gencache import EnsureDispatch
+
+
+class TestStuff(unittest.TestCase):
+    def setUp(self):
+        self.tablename = "pywin32test_users"
+        self.db_filename = None
+        self.conn = self.cur = None
+        try:
+            # Test any database if a connection string is supplied...
+            conn_str = os.environ["TEST_ODBC_CONNECTION_STRING"]
+        except KeyError:
+            # Create a local MSAccess DB for testing.
+            self.db_filename = tempfile.NamedTemporaryFile().name + ".mdb"
+
+            # Create a brand-new database - what is the story with these?
+            for suffix in (".36", ".35", ".30"):
+                try:
+                    dbe = EnsureDispatch("DAO.DBEngine" + suffix)
+                    break
+                except pythoncom.com_error:
+                    pass
+            else:
+                raise TestSkipped("Can't find a DB engine")
+
+            workspace = dbe.Workspaces(0)
+
+            newdb = workspace.CreateDatabase(
+                self.db_filename, constants.dbLangGeneral, constants.dbEncrypt
+            )
+
+            newdb.Close()
+
+            conn_str = "Driver={Microsoft Access Driver (*.mdb)};dbq=%s;Uid=;Pwd=;" % (
+                self.db_filename,
+            )
+        ## print 'Connection string:', conn_str
+        self.conn = odbc.odbc(conn_str)
+        # And we expect a 'users' table for these tests.
+        self.cur = self.conn.cursor()
+        ## self.cur.setoutputsize(1000)
+        try:
+            self.cur.execute("""drop table %s""" % self.tablename)
+        except (odbc.error, odbc.progError):
+            pass
+
+        ## This needs to be adjusted for sql server syntax for unicode fields
+        ##  - memo -> TEXT
+        ##  - varchar -> nvarchar
+        self.assertEqual(
+            self.cur.execute(
+                """create table %s (
+                    userid varchar(25),
+                    username varchar(25),
+                    bitfield bit,
+                    intfield integer,
+                    floatfield float,
+                    datefield datetime,
+                    rawfield varbinary(100),
+                    longtextfield memo,
+                    longbinaryfield image
+            )"""
+                % self.tablename
+            ),
+            -1,
+        )
+
+    def tearDown(self):
+        if self.cur is not None:
+            try:
+                self.cur.execute("""drop table %s""" % self.tablename)
+            except (odbc.error, odbc.progError) as why:
+                print("Failed to delete test table %s" % self.tablename, why)
+
+            self.cur.close()
+            self.cur = None
+        if self.conn is not None:
+            self.conn.close()
+            self.conn = None
+        if self.db_filename is not None:
+            try:
+                os.unlink(self.db_filename)
+            except OSError:
+                pass
+
+    def test_insert_select(self, userid="Frank", username="Frank Millman"):
+        self.assertEqual(
+            self.cur.execute(
+                "insert into %s (userid, username) \
+            values (?,?)"
+                % self.tablename,
+                [userid, username],
+            ),
+            1,
+        )
+        self.assertEqual(
+            self.cur.execute(
+                "select * from %s \
+            where userid = ?"
+                % self.tablename,
+                [userid.lower()],
+            ),
+            0,
+        )
+        self.assertEqual(
+            self.cur.execute(
+                "select * from %s \
+            where username = ?"
+                % self.tablename,
+                [username.lower()],
+            ),
+            0,
+        )
+
+    def test_insert_select_unicode(self, userid="Frank", username="Frank Millman"):
+        self.assertEqual(
+            self.cur.execute(
+                "insert into %s (userid, username)\
+            values (?,?)"
+                % self.tablename,
+                [userid, username],
+            ),
+            1,
+        )
+        self.assertEqual(
+            self.cur.execute(
+                "select * from %s \
+            where userid = ?"
+                % self.tablename,
+                [userid.lower()],
+            ),
+            0,
+        )
+        self.assertEqual(
+            self.cur.execute(
+                "select * from %s \
+            where username = ?"
+                % self.tablename,
+                [username.lower()],
+            ),
+            0,
+        )
+
+    def test_insert_select_unicode_ext(self):
+        userid = "t-\xe0\xf2"
+        username = "test-\xe0\xf2 name"
+        self.test_insert_select_unicode(userid, username)
+
+    def _test_val(self, fieldName, value):
+        for x in range(100):
+            self.cur.execute("delete from %s where userid='Frank'" % self.tablename)
+            self.assertEqual(
+                self.cur.execute(
+                    "insert into %s (userid, %s) values (?,?)"
+                    % (self.tablename, fieldName),
+                    ["Frank", value],
+                ),
+                1,
+            )
+            self.cur.execute(
+                "select %s from %s where userid = ?" % (fieldName, self.tablename),
+                ["Frank"],
+            )
+            rows = self.cur.fetchmany()
+            self.assertEqual(1, len(rows))
+            row = rows[0]
+            self.assertEqual(row[0], value)
+
+    def testBit(self):
+        self._test_val("bitfield", 1)
+        self._test_val("bitfield", 0)
+
+    def testInt(self):
+        self._test_val("intfield", 1)
+        self._test_val("intfield", 0)
+        try:
+            big = sys.maxsize
+        except AttributeError:
+            big = sys.maxint
+        self._test_val("intfield", big)
+
+    def testFloat(self):
+        self._test_val("floatfield", 1.01)
+        self._test_val("floatfield", 0)
+
+    def testVarchar(
+        self,
+    ):
+        self._test_val("username", "foo")
+
+    def testLongVarchar(self):
+        """Test a long text field in excess of internal cursor data size (65536)"""
+        self._test_val("longtextfield", "abc" * 70000)
+
+    def testLongBinary(self):
+        """Test a long raw field in excess of internal cursor data size (65536)"""
+        self._test_val("longbinaryfield", str2memory("\0\1\2" * 70000))
+
+    def testRaw(self):
+        ## Test binary data
+        self._test_val("rawfield", str2memory("\1\2\3\4\0\5\6\7\8"))
+
+    def test_widechar(self):
+        """Test a unicode character that would be mangled if bound as plain character.
+        For example, previously the below was returned as ascii 'a'
+        """
+        self._test_val("username", "\u0101")
+
+    def testDates(self):
+        import datetime
+
+        for v in ((1900, 12, 25, 23, 39, 59),):
+            d = datetime.datetime(*v)
+            self._test_val("datefield", d)
+
+    def test_set_nonzero_length(self):
+        self.assertEqual(
+            self.cur.execute(
+                "insert into %s (userid,username) " "values (?,?)" % self.tablename,
+                ["Frank", "Frank Millman"],
+            ),
+            1,
+        )
+        self.assertEqual(
+            self.cur.execute("update %s set username = ?" % self.tablename, ["Frank"]),
+            1,
+        )
+        self.assertEqual(self.cur.execute("select * from %s" % self.tablename), 0)
+        self.assertEqual(len(self.cur.fetchone()[1]), 5)
+
+    def test_set_zero_length(self):
+        self.assertEqual(
+            self.cur.execute(
+                "insert into %s (userid,username) " "values (?,?)" % self.tablename,
+                [str2bytes("Frank"), ""],
+            ),
+            1,
+        )
+        self.assertEqual(self.cur.execute("select * from %s" % self.tablename), 0)
+        self.assertEqual(len(self.cur.fetchone()[1]), 0)
+
+    def test_set_zero_length_unicode(self):
+        self.assertEqual(
+            self.cur.execute(
+                "insert into %s (userid,username) " "values (?,?)" % self.tablename,
+                ["Frank", ""],
+            ),
+            1,
+        )
+        self.assertEqual(self.cur.execute("select * from %s" % self.tablename), 0)
+        self.assertEqual(len(self.cur.fetchone()[1]), 0)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/lib/win32/test/test_pywintypes.py b/lib/win32/test/test_pywintypes.py
new file mode 100644
index 00000000..bbd9d882
--- /dev/null
+++ b/lib/win32/test/test_pywintypes.py
@@ -0,0 +1,116 @@
+import datetime
+import operator
+import sys
+import time
+import unittest
+
+import pywintypes
+from pywin32_testutil import ob2memory, str2bytes
+
+
+class TestCase(unittest.TestCase):
+    def testPyTimeFormat(self):
+        struct_current = time.localtime()
+        pytime_current = pywintypes.Time(struct_current)
+        # try and test all the standard parts of the format
+        # Note we used to include '%Z' testing, but that was pretty useless as
+        # it always returned the local timezone.
+        format_strings = "%a %A %b %B %c %d %H %I %j %m %M %p %S %U %w %W %x %X %y %Y"
+        for fmt in format_strings.split():
+            v1 = pytime_current.Format(fmt)
+            v2 = time.strftime(fmt, struct_current)
+            self.assertEqual(v1, v2, "format %s failed - %r != %r" % (fmt, v1, v2))
+
+    def testPyTimePrint(self):
+        # This used to crash with an invalid, or too early time.
+        # We don't really want to check that it does cause a ValueError
+        # (as hopefully this wont be true forever).  So either working, or
+        # ValueError is OK.
+        try:
+            t = pywintypes.Time(-2)
+            t.Format()
+        except ValueError:
+            return
+
+    def testTimeInDict(self):
+        d = {}
+        d["t1"] = pywintypes.Time(1)
+        self.assertEqual(d["t1"], pywintypes.Time(1))
+
+    def testPyTimeCompare(self):
+        t1 = pywintypes.Time(100)
+        t1_2 = pywintypes.Time(100)
+        t2 = pywintypes.Time(101)
+
+        self.assertEqual(t1, t1_2)
+        self.assertTrue(t1 <= t1_2)
+        self.assertTrue(t1_2 >= t1)
+
+        self.assertNotEqual(t1, t2)
+        self.assertTrue(t1 < t2)
+        self.assertTrue(t2 > t1)
+
+    def testPyTimeCompareOther(self):
+        t1 = pywintypes.Time(100)
+        t2 = None
+        self.assertNotEqual(t1, t2)
+
+    def testTimeTuple(self):
+        now = datetime.datetime.now()  # has usec...
+        # timetuple() lost usec - pt must be <=...
+        pt = pywintypes.Time(now.timetuple())
+        # *sob* - only if we have a datetime object can we compare like this.
+        if isinstance(pt, datetime.datetime):
+            self.assertTrue(pt <= now)
+
+    def testTimeTuplems(self):
+        now = datetime.datetime.now()  # has usec...
+        tt = now.timetuple() + (now.microsecond // 1000,)
+        pt = pywintypes.Time(tt)
+        # we can't compare if using the old type, as it loses all sub-second res.
+        if isinstance(pt, datetime.datetime):
+            # but even with datetime, we lose sub-millisecond.
+            expectedDelta = datetime.timedelta(milliseconds=1)
+            self.assertTrue(-expectedDelta < (now - pt) < expectedDelta)
+
+    def testPyTimeFromTime(self):
+        t1 = pywintypes.Time(time.time())
+        self.assertTrue(pywintypes.Time(t1) is t1)
+
+    def testPyTimeTooLarge(self):
+        MAX_TIMESTAMP = 0x7FFFFFFFFFFFFFFF  # used by some API function to mean "never"
+        ts = pywintypes.TimeStamp(MAX_TIMESTAMP)
+        self.assertEqual(ts, datetime.datetime.max)
+
+    def testGUID(self):
+        s = "{00020400-0000-0000-C000-000000000046}"
+        iid = pywintypes.IID(s)
+        iid2 = pywintypes.IID(ob2memory(iid), True)
+        self.assertEqual(iid, iid2)
+        self.assertRaises(
+            ValueError, pywintypes.IID, str2bytes("00"), True
+        )  # too short
+        self.assertRaises(TypeError, pywintypes.IID, 0, True)  # no buffer
+
+    def testGUIDRichCmp(self):
+        s = "{00020400-0000-0000-C000-000000000046}"
+        iid = pywintypes.IID(s)
+        self.assertFalse(s == None)
+        self.assertFalse(None == s)
+        self.assertTrue(s != None)
+        self.assertTrue(None != s)
+        if sys.version_info > (3, 0):
+            self.assertRaises(TypeError, operator.gt, None, s)
+            self.assertRaises(TypeError, operator.gt, s, None)
+            self.assertRaises(TypeError, operator.lt, None, s)
+            self.assertRaises(TypeError, operator.lt, s, None)
+
+    def testGUIDInDict(self):
+        s = "{00020400-0000-0000-C000-000000000046}"
+        iid = pywintypes.IID(s)
+        d = dict(item=iid)
+        self.assertEqual(d["item"], iid)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/lib/win32/test/test_security.py b/lib/win32/test/test_security.py
new file mode 100644
index 00000000..42a82a13
--- /dev/null
+++ b/lib/win32/test/test_security.py
@@ -0,0 +1,166 @@
+# Tests for the win32security module.
+import unittest
+
+import ntsecuritycon
+import pywintypes
+import win32api
+import win32con
+import win32security
+import winerror
+from pywin32_testutil import TestSkipped, ob2memory, testmain
+
+
+class SecurityTests(unittest.TestCase):
+    def setUp(self):
+        self.pwr_sid = win32security.LookupAccountName("", "Power Users")[0]
+        try:
+            self.admin_sid = win32security.LookupAccountName("", "Administrator")[0]
+        except pywintypes.error as exc:
+            # in automation we see:
+            # pywintypes.error: (1332, 'LookupAccountName', 'No mapping between account names and security IDs was done.')
+            if exc.winerror != winerror.ERROR_NONE_MAPPED:
+                raise
+            self.admin_sid = None
+
+    def tearDown(self):
+        pass
+
+    def testEqual(self):
+        if self.admin_sid is None:
+            raise TestSkipped("No 'Administrator' account is available")
+        self.assertEqual(
+            win32security.LookupAccountName("", "Administrator")[0],
+            win32security.LookupAccountName("", "Administrator")[0],
+        )
+
+    def testNESID(self):
+        self.assertTrue(self.pwr_sid == self.pwr_sid)
+        if self.admin_sid:
+            self.assertTrue(self.pwr_sid != self.admin_sid)
+
+    def testNEOther(self):
+        self.assertTrue(self.pwr_sid != None)
+        self.assertTrue(None != self.pwr_sid)
+        self.assertFalse(self.pwr_sid == None)
+        self.assertFalse(None == self.pwr_sid)
+        self.assertNotEqual(None, self.pwr_sid)
+
+    def testSIDInDict(self):
+        d = dict(foo=self.pwr_sid)
+        self.assertEqual(d["foo"], self.pwr_sid)
+
+    def testBuffer(self):
+        if self.admin_sid is None:
+            raise TestSkipped("No 'Administrator' account is available")
+        self.assertEqual(
+            ob2memory(win32security.LookupAccountName("", "Administrator")[0]),
+            ob2memory(win32security.LookupAccountName("", "Administrator")[0]),
+        )
+
+    def testMemory(self):
+        pwr_sid = self.pwr_sid
+        admin_sid = self.admin_sid
+        sd1 = win32security.SECURITY_DESCRIPTOR()
+        sd2 = win32security.SECURITY_DESCRIPTOR()
+        sd3 = win32security.SECURITY_DESCRIPTOR()
+        dacl = win32security.ACL()
+        dacl.AddAccessAllowedAce(
+            win32security.ACL_REVISION, win32con.GENERIC_READ, pwr_sid
+        )
+        if admin_sid is not None:
+            dacl.AddAccessAllowedAce(
+                win32security.ACL_REVISION, win32con.GENERIC_ALL, admin_sid
+            )
+        sd4 = win32security.SECURITY_DESCRIPTOR()
+        sacl = win32security.ACL()
+        if admin_sid is not None:
+            sacl.AddAuditAccessAce(
+                win32security.ACL_REVISION, win32con.DELETE, admin_sid, 1, 1
+            )
+        sacl.AddAuditAccessAce(
+            win32security.ACL_REVISION, win32con.GENERIC_ALL, pwr_sid, 1, 1
+        )
+        for x in range(0, 200000):
+            if admin_sid is not None:
+                sd1.SetSecurityDescriptorOwner(admin_sid, 0)
+            sd2.SetSecurityDescriptorGroup(pwr_sid, 0)
+            sd3.SetSecurityDescriptorDacl(1, dacl, 0)
+            sd4.SetSecurityDescriptorSacl(1, sacl, 0)
+
+
+class DomainTests(unittest.TestCase):
+    def setUp(self):
+        self.ds_handle = None
+        try:
+            # saving the handle means the other test itself should bind faster.
+            self.ds_handle = win32security.DsBind()
+        except win32security.error as exc:
+            if exc.winerror != winerror.ERROR_NO_SUCH_DOMAIN:
+                raise
+            raise TestSkipped(exc)
+
+    def tearDown(self):
+        if self.ds_handle is not None:
+            self.ds_handle.close()
+
+
+class TestDS(DomainTests):
+    def testDsGetDcName(self):
+        # Not sure what we can actually test here!  At least calling it
+        # does something :)
+        win32security.DsGetDcName()
+
+    def testDsListServerInfo(self):
+        # again, not checking much, just exercising the code.
+        h = win32security.DsBind()
+        for status, ignore, site in win32security.DsListSites(h):
+            for status, ignore, server in win32security.DsListServersInSite(h, site):
+                info = win32security.DsListInfoForServer(h, server)
+            for status, ignore, domain in win32security.DsListDomainsInSite(h, site):
+                pass
+
+    def testDsCrackNames(self):
+        h = win32security.DsBind()
+        fmt_offered = ntsecuritycon.DS_FQDN_1779_NAME
+        name = win32api.GetUserNameEx(fmt_offered)
+        result = win32security.DsCrackNames(h, 0, fmt_offered, fmt_offered, (name,))
+        self.assertEqual(name, result[0][2])
+
+    def testDsCrackNamesSyntax(self):
+        # Do a syntax check only - that allows us to avoid binding.
+        # But must use DS_CANONICAL_NAME (or _EX)
+        expected = win32api.GetUserNameEx(win32api.NameCanonical)
+        fmt_offered = ntsecuritycon.DS_FQDN_1779_NAME
+        name = win32api.GetUserNameEx(fmt_offered)
+        result = win32security.DsCrackNames(
+            None,
+            ntsecuritycon.DS_NAME_FLAG_SYNTACTICAL_ONLY,
+            fmt_offered,
+            ntsecuritycon.DS_CANONICAL_NAME,
+            (name,),
+        )
+        self.assertEqual(expected, result[0][2])
+
+
+class TestTranslate(DomainTests):
+    def _testTranslate(self, fmt_from, fmt_to):
+        name = win32api.GetUserNameEx(fmt_from)
+        expected = win32api.GetUserNameEx(fmt_to)
+        got = win32security.TranslateName(name, fmt_from, fmt_to)
+        self.assertEqual(got, expected)
+
+    def testTranslate1(self):
+        self._testTranslate(win32api.NameFullyQualifiedDN, win32api.NameSamCompatible)
+
+    def testTranslate2(self):
+        self._testTranslate(win32api.NameSamCompatible, win32api.NameFullyQualifiedDN)
+
+    def testTranslate3(self):
+        self._testTranslate(win32api.NameFullyQualifiedDN, win32api.NameUniqueId)
+
+    def testTranslate4(self):
+        self._testTranslate(win32api.NameUniqueId, win32api.NameFullyQualifiedDN)
+
+
+if __name__ == "__main__":
+    testmain()
diff --git a/lib/win32/test/test_sspi.py b/lib/win32/test/test_sspi.py
new file mode 100644
index 00000000..5d349d4d
--- /dev/null
+++ b/lib/win32/test/test_sspi.py
@@ -0,0 +1,231 @@
+# Some tests of the win32security sspi functions.
+# Stolen from Roger's original test_sspi.c, a version of which is in "Demos"
+# See also the other SSPI demos.
+import re
+import unittest
+
+import sspi
+import sspicon
+import win32api
+import win32security
+from pywin32_testutil import TestSkipped, str2bytes, testmain
+
+
+# It is quite likely that the Kerberos tests will fail due to not being
+# installed.  The NTLM tests do *not* get the same behaviour as they should
+# always be there.
+def applyHandlingSkips(func, *args):
+    try:
+        return func(*args)
+    except win32api.error as exc:
+        if exc.winerror in [
+            sspicon.SEC_E_NO_CREDENTIALS,
+            sspicon.SEC_E_NO_AUTHENTICATING_AUTHORITY,
+        ]:
+            raise TestSkipped(exc)
+        raise
+
+
+class TestSSPI(unittest.TestCase):
+    def assertRaisesHRESULT(self, hr, func, *args):
+        try:
+            return func(*args)
+            raise RuntimeError("expecting %s failure" % (hr,))
+        except win32security.error as exc:
+            self.assertEqual(exc.winerror, hr)
+
+    def _doAuth(self, pkg_name):
+        sspiclient = sspi.ClientAuth(pkg_name, targetspn=win32api.GetUserName())
+        sspiserver = sspi.ServerAuth(pkg_name)
+
+        sec_buffer = None
+        err = 1
+        while err != 0:
+            err, sec_buffer = sspiclient.authorize(sec_buffer)
+            err, sec_buffer = sspiserver.authorize(sec_buffer)
+        return sspiclient, sspiserver
+
+    def _doTestImpersonate(self, pkg_name):
+        # Just for the sake of code exercising!
+        sspiclient, sspiserver = self._doAuth(pkg_name)
+        sspiserver.ctxt.ImpersonateSecurityContext()
+        sspiserver.ctxt.RevertSecurityContext()
+
+    def testImpersonateKerberos(self):
+        applyHandlingSkips(self._doTestImpersonate, "Kerberos")
+
+    def testImpersonateNTLM(self):
+        self._doTestImpersonate("NTLM")
+
+    def _doTestEncrypt(self, pkg_name):
+        sspiclient, sspiserver = self._doAuth(pkg_name)
+
+        pkg_size_info = sspiclient.ctxt.QueryContextAttributes(
+            sspicon.SECPKG_ATTR_SIZES
+        )
+        msg = str2bytes("some data to be encrypted ......")
+
+        trailersize = pkg_size_info["SecurityTrailer"]
+        encbuf = win32security.PySecBufferDescType()
+        encbuf.append(win32security.PySecBufferType(len(msg), sspicon.SECBUFFER_DATA))
+        encbuf.append(
+            win32security.PySecBufferType(trailersize, sspicon.SECBUFFER_TOKEN)
+        )
+        encbuf[0].Buffer = msg
+        sspiclient.ctxt.EncryptMessage(0, encbuf, 1)
+        sspiserver.ctxt.DecryptMessage(encbuf, 1)
+        self.assertEqual(msg, encbuf[0].Buffer)
+        # and test the higher-level functions
+        data_in = str2bytes("hello")
+        data, sig = sspiclient.encrypt(data_in)
+        self.assertEqual(sspiserver.decrypt(data, sig), data_in)
+
+        data, sig = sspiserver.encrypt(data_in)
+        self.assertEqual(sspiclient.decrypt(data, sig), data_in)
+
+    def _doTestEncryptStream(self, pkg_name):
+        # Test out the SSPI/GSSAPI interop wrapping examples at
+        # https://docs.microsoft.com/en-us/windows/win32/secauthn/sspi-kerberos-interoperability-with-gssapi
+
+        sspiclient, sspiserver = self._doAuth(pkg_name)
+
+        pkg_size_info = sspiclient.ctxt.QueryContextAttributes(
+            sspicon.SECPKG_ATTR_SIZES
+        )
+        msg = str2bytes("some data to be encrypted ......")
+
+        trailersize = pkg_size_info["SecurityTrailer"]
+        blocksize = pkg_size_info["BlockSize"]
+        encbuf = win32security.PySecBufferDescType()
+        encbuf.append(
+            win32security.PySecBufferType(trailersize, sspicon.SECBUFFER_TOKEN)
+        )
+        encbuf.append(win32security.PySecBufferType(len(msg), sspicon.SECBUFFER_DATA))
+        encbuf.append(
+            win32security.PySecBufferType(blocksize, sspicon.SECBUFFER_PADDING)
+        )
+        encbuf[1].Buffer = msg
+        sspiclient.ctxt.EncryptMessage(0, encbuf, 1)
+
+        encmsg = encbuf[0].Buffer + encbuf[1].Buffer + encbuf[2].Buffer
+        decbuf = win32security.PySecBufferDescType()
+        decbuf.append(
+            win32security.PySecBufferType(len(encmsg), sspicon.SECBUFFER_STREAM)
+        )
+        decbuf.append(win32security.PySecBufferType(0, sspicon.SECBUFFER_DATA))
+        decbuf[0].Buffer = encmsg
+
+        sspiserver.ctxt.DecryptMessage(decbuf, 1)
+        self.assertEqual(msg, decbuf[1].Buffer)
+
+    def testEncryptNTLM(self):
+        self._doTestEncrypt("NTLM")
+
+    def testEncryptStreamNTLM(self):
+        self._doTestEncryptStream("NTLM")
+
+    def testEncryptKerberos(self):
+        applyHandlingSkips(self._doTestEncrypt, "Kerberos")
+
+    def testEncryptStreamKerberos(self):
+        applyHandlingSkips(self._doTestEncryptStream, "Kerberos")
+
+    def _doTestSign(self, pkg_name):
+        sspiclient, sspiserver = self._doAuth(pkg_name)
+
+        pkg_size_info = sspiclient.ctxt.QueryContextAttributes(
+            sspicon.SECPKG_ATTR_SIZES
+        )
+        msg = str2bytes("some data to be encrypted ......")
+
+        sigsize = pkg_size_info["MaxSignature"]
+        sigbuf = win32security.PySecBufferDescType()
+        sigbuf.append(win32security.PySecBufferType(len(msg), sspicon.SECBUFFER_DATA))
+        sigbuf.append(win32security.PySecBufferType(sigsize, sspicon.SECBUFFER_TOKEN))
+        sigbuf[0].Buffer = msg
+        sspiclient.ctxt.MakeSignature(0, sigbuf, 0)
+        sspiserver.ctxt.VerifySignature(sigbuf, 0)
+        # and test the higher-level functions
+        sspiclient.next_seq_num = 1
+        sspiserver.next_seq_num = 1
+        data = str2bytes("hello")
+        key = sspiclient.sign(data)
+        sspiserver.verify(data, key)
+        key = sspiclient.sign(data)
+        self.assertRaisesHRESULT(
+            sspicon.SEC_E_MESSAGE_ALTERED, sspiserver.verify, data + data, key
+        )
+
+        # and the other way
+        key = sspiserver.sign(data)
+        sspiclient.verify(data, key)
+        key = sspiserver.sign(data)
+        self.assertRaisesHRESULT(
+            sspicon.SEC_E_MESSAGE_ALTERED, sspiclient.verify, data + data, key
+        )
+
+    def testSignNTLM(self):
+        self._doTestSign("NTLM")
+
+    def testSignKerberos(self):
+        applyHandlingSkips(self._doTestSign, "Kerberos")
+
+    def _testSequenceSign(self):
+        # Only Kerberos supports sequence detection.
+        sspiclient, sspiserver = self._doAuth("Kerberos")
+        key = sspiclient.sign(b"hello")
+        sspiclient.sign(b"hello")
+        self.assertRaisesHRESULT(
+            sspicon.SEC_E_OUT_OF_SEQUENCE, sspiserver.verify, b"hello", key
+        )
+
+    def testSequenceSign(self):
+        applyHandlingSkips(self._testSequenceSign)
+
+    def _testSequenceEncrypt(self):
+        # Only Kerberos supports sequence detection.
+        sspiclient, sspiserver = self._doAuth("Kerberos")
+        blob, key = sspiclient.encrypt(b"hello")
+        blob, key = sspiclient.encrypt(b"hello")
+        self.assertRaisesHRESULT(
+            sspicon.SEC_E_OUT_OF_SEQUENCE, sspiserver.decrypt, blob, key
+        )
+
+    def testSequenceEncrypt(self):
+        applyHandlingSkips(self._testSequenceEncrypt)
+
+    def testSecBufferRepr(self):
+        desc = win32security.PySecBufferDescType()
+        assert re.match(
+            "PySecBufferDesc\(ulVersion: 0 \| cBuffers: 0 \| pBuffers: 0x[\da-fA-F]{8,16}\)",
+            repr(desc),
+        )
+
+        buffer1 = win32security.PySecBufferType(0, sspicon.SECBUFFER_TOKEN)
+        assert re.match(
+            "PySecBuffer\(cbBuffer: 0 \| BufferType: 2 \| pvBuffer: 0x[\da-fA-F]{8,16}\)",
+            repr(buffer1),
+        )
+        "PySecBuffer(cbBuffer: 0 | BufferType: 2 | pvBuffer: 0x000001B8CC6D8020)"
+        desc.append(buffer1)
+
+        assert re.match(
+            "PySecBufferDesc\(ulVersion: 0 \| cBuffers: 1 \| pBuffers: 0x[\da-fA-F]{8,16}\)",
+            repr(desc),
+        )
+
+        buffer2 = win32security.PySecBufferType(4, sspicon.SECBUFFER_DATA)
+        assert re.match(
+            "PySecBuffer\(cbBuffer: 4 \| BufferType: 1 \| pvBuffer: 0x[\da-fA-F]{8,16}\)",
+            repr(buffer2),
+        )
+        desc.append(buffer2)
+
+        assert re.match(
+            "PySecBufferDesc\(ulVersion: 0 \| cBuffers: 2 \| pBuffers: 0x[\da-fA-F]{8,16}\)",
+            repr(desc),
+        )
+
+
+if __name__ == "__main__":
+    testmain()
diff --git a/lib/win32/test/test_win32api.py b/lib/win32/test/test_win32api.py
new file mode 100644
index 00000000..58ac1597
--- /dev/null
+++ b/lib/win32/test/test_win32api.py
@@ -0,0 +1,268 @@
+# General test module for win32api - please add some :)
+
+import datetime
+import os
+import sys
+import tempfile
+import unittest
+
+import win32api
+import win32con
+import win32event
+import winerror
+from pywin32_testutil import TestSkipped, str2bytes
+
+
+class CurrentUserTestCase(unittest.TestCase):
+    def testGetCurrentUser(self):
+        domain = win32api.GetDomainName()
+        if domain == "NT AUTHORITY":
+            # Running as a service account, so the comparison will fail
+            raise TestSkipped("running as service account")
+        name = "%s\\%s" % (domain, win32api.GetUserName())
+        self.assertEqual(name, win32api.GetUserNameEx(win32api.NameSamCompatible))
+
+
+class TestTime(unittest.TestCase):
+    def testTimezone(self):
+        # GetTimeZoneInformation
+        rc, tzinfo = win32api.GetTimeZoneInformation()
+        if rc == win32con.TIME_ZONE_ID_DAYLIGHT:
+            tz_str = tzinfo[4]
+            tz_time = tzinfo[5]
+        else:
+            tz_str = tzinfo[1]
+            tz_time = tzinfo[2]
+        # for the sake of code exercise but don't output
+        tz_str.encode()
+        if not isinstance(tz_time, datetime.datetime) and not isinstance(
+            tz_time, tuple
+        ):
+            tz_time.Format()
+
+    def TestDateFormat(self):
+        DATE_LONGDATE = 2
+        date_flags = DATE_LONGDATE
+        win32api.GetDateFormat(0, date_flags, None)
+        win32api.GetDateFormat(0, date_flags, 0)
+        win32api.GetDateFormat(0, date_flags, datetime.datetime.now())
+        win32api.GetDateFormat(0, date_flags, time.time())
+
+    def TestTimeFormat(self):
+        win32api.GetTimeFormat(0, 0, None)
+        win32api.GetTimeFormat(0, 0, 0)
+        win32api.GetTimeFormat(0, 0, datetime.datetime.now())
+        win32api.GetTimeFormat(0, 0, time.time())
+
+
+class Registry(unittest.TestCase):
+    key_name = r"PythonTestHarness\Whatever"
+
+    def test1(self):
+        # This used to leave a stale exception behind.
+        def reg_operation():
+            hkey = win32api.RegCreateKey(win32con.HKEY_CURRENT_USER, self.key_name)
+            x = 3 / 0  # or a statement like: raise 'error'
+
+        # do the test
+        try:
+            try:
+                try:
+                    reg_operation()
+                except:
+                    1 / 0  # Force exception
+            finally:
+                win32api.RegDeleteKey(win32con.HKEY_CURRENT_USER, self.key_name)
+        except ZeroDivisionError:
+            pass
+
+    def testValues(self):
+        key_name = r"PythonTestHarness\win32api"
+        ## tuples containing value name, value type, data
+        values = (
+            (None, win32con.REG_SZ, "This is default unnamed value"),
+            ("REG_SZ", win32con.REG_SZ, "REG_SZ text data"),
+            ("REG_EXPAND_SZ", win32con.REG_EXPAND_SZ, "%systemdir%"),
+            ## REG_MULTI_SZ value needs to be a list since strings are returned as a list
+            (
+                "REG_MULTI_SZ",
+                win32con.REG_MULTI_SZ,
+                ["string 1", "string 2", "string 3", "string 4"],
+            ),
+            ("REG_MULTI_SZ_empty", win32con.REG_MULTI_SZ, []),
+            ("REG_DWORD", win32con.REG_DWORD, 666),
+            ("REG_QWORD_INT", win32con.REG_QWORD, 99),
+            ("REG_QWORD", win32con.REG_QWORD, 2**33),
+            (
+                "REG_BINARY",
+                win32con.REG_BINARY,
+                str2bytes("\x00\x01\x02\x03\x04\x05\x06\x07\x08\x01\x00"),
+            ),
+        )
+
+        hkey = win32api.RegCreateKey(win32con.HKEY_CURRENT_USER, key_name)
+        for value_name, reg_type, data in values:
+            win32api.RegSetValueEx(hkey, value_name, None, reg_type, data)
+
+        for value_name, orig_type, orig_data in values:
+            data, typ = win32api.RegQueryValueEx(hkey, value_name)
+            self.assertEqual(typ, orig_type)
+            self.assertEqual(data, orig_data)
+
+    def testNotifyChange(self):
+        def change():
+            hkey = win32api.RegCreateKey(win32con.HKEY_CURRENT_USER, self.key_name)
+            try:
+                win32api.RegSetValue(hkey, None, win32con.REG_SZ, "foo")
+            finally:
+                win32api.RegDeleteKey(win32con.HKEY_CURRENT_USER, self.key_name)
+
+        evt = win32event.CreateEvent(None, 0, 0, None)
+        ## REG_NOTIFY_CHANGE_LAST_SET - values
+        ## REG_CHANGE_NOTIFY_NAME - keys
+        ## REG_NOTIFY_CHANGE_SECURITY - security descriptor
+        ## REG_NOTIFY_CHANGE_ATTRIBUTES
+        win32api.RegNotifyChangeKeyValue(
+            win32con.HKEY_CURRENT_USER,
+            1,
+            win32api.REG_NOTIFY_CHANGE_LAST_SET,
+            evt,
+            True,
+        )
+        ret_code = win32event.WaitForSingleObject(evt, 0)
+        # Should be no change.
+        self.assertTrue(ret_code == win32con.WAIT_TIMEOUT)
+        change()
+        # Our event should now be in a signalled state.
+        ret_code = win32event.WaitForSingleObject(evt, 0)
+        self.assertTrue(ret_code == win32con.WAIT_OBJECT_0)
+
+
+class FileNames(unittest.TestCase):
+    def testShortLongPathNames(self):
+        try:
+            me = __file__
+        except NameError:
+            me = sys.argv[0]
+        fname = os.path.abspath(me).lower()
+        short_name = win32api.GetShortPathName(fname).lower()
+        long_name = win32api.GetLongPathName(short_name).lower()
+        self.assertTrue(
+            long_name == fname,
+            "Expected long name ('%s') to be original name ('%s')" % (long_name, fname),
+        )
+        self.assertEqual(long_name, win32api.GetLongPathNameW(short_name).lower())
+        long_name = win32api.GetLongPathNameW(short_name).lower()
+        self.assertTrue(
+            type(long_name) == str,
+            "GetLongPathNameW returned type '%s'" % (type(long_name),),
+        )
+        self.assertTrue(
+            long_name == fname,
+            "Expected long name ('%s') to be original name ('%s')" % (long_name, fname),
+        )
+
+    def testShortUnicodeNames(self):
+        try:
+            me = __file__
+        except NameError:
+            me = sys.argv[0]
+        fname = os.path.abspath(me).lower()
+        # passing unicode should cause GetShortPathNameW to be called.
+        short_name = win32api.GetShortPathName(str(fname)).lower()
+        self.assertTrue(isinstance(short_name, str))
+        long_name = win32api.GetLongPathName(short_name).lower()
+        self.assertTrue(
+            long_name == fname,
+            "Expected long name ('%s') to be original name ('%s')" % (long_name, fname),
+        )
+        self.assertEqual(long_name, win32api.GetLongPathNameW(short_name).lower())
+        long_name = win32api.GetLongPathNameW(short_name).lower()
+        self.assertTrue(
+            type(long_name) == str,
+            "GetLongPathNameW returned type '%s'" % (type(long_name),),
+        )
+        self.assertTrue(
+            long_name == fname,
+            "Expected long name ('%s') to be original name ('%s')" % (long_name, fname),
+        )
+
+    def testLongLongPathNames(self):
+        # We need filename where the FQN is > 256 - simplest way is to create a
+        # 250 character directory in the cwd (except - cwd may be on a drive
+        # not supporting \\\\?\\ (eg, network share) - so use temp.
+        import win32file
+
+        basename = "a" * 250
+        # but we need to ensure we use the 'long' version of the
+        # temp dir for later comparison.
+        long_temp_dir = win32api.GetLongPathNameW(tempfile.gettempdir())
+        fname = "\\\\?\\" + os.path.join(long_temp_dir, basename)
+        try:
+            win32file.CreateDirectoryW(fname, None)
+        except win32api.error as details:
+            if details.winerror != winerror.ERROR_ALREADY_EXISTS:
+                raise
+        try:
+            # GetFileAttributes automatically calls GetFileAttributesW when
+            # passed unicode
+            try:
+                attr = win32api.GetFileAttributes(fname)
+            except win32api.error as details:
+                if details.winerror != winerror.ERROR_FILENAME_EXCED_RANGE:
+                    raise
+
+            attr = win32api.GetFileAttributes(str(fname))
+            self.assertTrue(attr & win32con.FILE_ATTRIBUTE_DIRECTORY, attr)
+
+            long_name = win32api.GetLongPathNameW(fname)
+            self.assertEqual(long_name.lower(), fname.lower())
+        finally:
+            win32file.RemoveDirectory(fname)
+
+
+class FormatMessage(unittest.TestCase):
+    def test_FromString(self):
+        msg = "Hello %1, how are you %2?"
+        inserts = ["Mark", "today"]
+        result = win32api.FormatMessage(
+            win32con.FORMAT_MESSAGE_FROM_STRING,
+            msg,  # source
+            0,  # ID
+            0,  # LangID
+            inserts,
+        )
+        self.assertEqual(result, "Hello Mark, how are you today?")
+
+
+class Misc(unittest.TestCase):
+    def test_last_error(self):
+        for x in (0, 1, -1, winerror.TRUST_E_PROVIDER_UNKNOWN):
+            win32api.SetLastError(x)
+            self.assertEqual(x, win32api.GetLastError())
+
+    def testVkKeyScan(self):
+        # hopefully ' ' doesn't depend on the locale!
+        self.assertEqual(win32api.VkKeyScan(" "), 32)
+
+    def testVkKeyScanEx(self):
+        # hopefully ' ' doesn't depend on the locale!
+        self.assertEqual(win32api.VkKeyScanEx(" ", 0), 32)
+
+    def testGetSystemPowerStatus(self):
+        # Dummy
+        sps = win32api.GetSystemPowerStatus()
+        self.assertIsInstance(sps, dict)
+        test_keys = (
+            "ACLineStatus",
+            "BatteryFlag",
+            "BatteryLifePercent",
+            "SystemStatusFlag",
+            "BatteryLifeTime",
+            "BatteryFullLifeTime",
+        )
+        self.assertEqual(set(test_keys), set(sps.keys()))
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/lib/win32/test/test_win32crypt.py b/lib/win32/test/test_win32crypt.py
new file mode 100644
index 00000000..4d1fa712
--- /dev/null
+++ b/lib/win32/test/test_win32crypt.py
@@ -0,0 +1,129 @@
+# Test module for win32crypt
+
+import contextlib
+import unittest
+from typing import Any, Iterator
+
+import win32crypt
+from pywin32_testutil import TestSkipped, find_test_fixture, testmain
+from win32cryptcon import *
+
+
+class Crypt(unittest.TestCase):
+    def testSimple(self):
+        data = b"My test data"
+        entropy = None
+        desc = "My description"
+        flags = 0
+        ps = None
+        blob = win32crypt.CryptProtectData(data, desc, entropy, None, ps, flags)
+        got_desc, got_data = win32crypt.CryptUnprotectData(
+            blob, entropy, None, ps, flags
+        )
+        self.assertEqual(data, got_data)
+        self.assertEqual(desc, got_desc)
+
+    def testEntropy(self):
+        data = b"My test data"
+        entropy = b"My test entropy"
+        desc = "My description"
+        flags = 0
+        ps = None
+        blob = win32crypt.CryptProtectData(data, desc, entropy, None, ps, flags)
+        got_desc, got_data = win32crypt.CryptUnprotectData(
+            blob, entropy, None, ps, flags
+        )
+        self.assertEqual(data, got_data)
+        self.assertEqual(desc, got_desc)
+
+
+# via https://github.com/mhammond/pywin32/issues/1859
+_LOCAL_MACHINE = "LocalMachine"
+_CURRENT_USER = "CurrentUser"
+
+
+@contextlib.contextmanager
+def open_windows_certstore(store_name: str, store_location: str) -> Iterator[Any]:
+    """Open a windows certificate store
+
+    :param store_name: store name
+    :param store_location: store location
+    :return: handle to cert store
+    """
+    handle = None
+    try:
+        handle = win32crypt.CertOpenStore(
+            CERT_STORE_PROV_SYSTEM,
+            0,
+            None,
+            CERT_SYSTEM_STORE_LOCAL_MACHINE
+            if store_location == _LOCAL_MACHINE
+            else CERT_SYSTEM_STORE_CURRENT_USER,
+            store_name,
+        )
+        yield handle
+    finally:
+        if handle is not None:
+            handle.CertCloseStore()
+
+
+class TestCerts(unittest.TestCase):
+    def readCertFile(self, file_name):
+        with open(find_test_fixture(file_name), "rb") as f:
+            buf = bytearray(f.read())
+            return win32crypt.CryptQueryObject(
+                CERT_QUERY_OBJECT_BLOB,
+                buf,
+                CERT_QUERY_CONTENT_FLAG_CERT,
+                CERT_QUERY_FORMAT_FLAG_ALL,
+                0,
+            )
+
+    def testReadCertFiles(self):
+        # readCertFile has Python read the file and load it as a blob.
+        # win32crypt can read the file directly - let's check that works too
+        # (ideally we'd compare the 2 approaches etc, but the objects don't support
+        # equality checks etc, so this will do for now.)
+        # No need to do this for different filenames!
+        filename = "win32crypt_testcert_base64.cer"
+        cert = win32crypt.CryptQueryObject(
+            CERT_QUERY_OBJECT_FILE,
+            find_test_fixture(filename),
+            CERT_QUERY_CONTENT_FLAG_CERT,
+            CERT_QUERY_FORMAT_FLAG_ALL,
+            0,
+        )
+        self.assertEqual(cert["FormatType"], CERT_QUERY_FORMAT_BASE64_ENCODED)
+        self.assertEqual(cert["ContentType"], CERT_QUERY_CONTENT_CERT)
+
+    def checkCertFile(self, filename, expected_format):
+        cert = self.readCertFile(filename)
+        self.assertEqual(cert["FormatType"], expected_format)
+        self.assertEqual(cert["ContentType"], CERT_QUERY_CONTENT_CERT)
+
+        with open_windows_certstore(_CURRENT_USER, "Temp") as store:
+            context = store.CertAddCertificateContextToStore(
+                cert["Context"], CERT_STORE_ADD_REPLACE_EXISTING
+            )
+            # Getting 2 certs here - main thing is we get 1!
+            self.assertTrue(len(store.CertEnumCertificatesInStore()))
+            self.assertFalse(len(store.CertEnumCTLsInStore()))
+            context.CertFreeCertificateContext()
+            try:
+                context.CertFreeCertificateContext()
+            except ValueError:
+                pass
+            else:
+                raise RuntimeError("should not be able to close the context twice")
+
+    def testCertBase64(self):
+        self.checkCertFile(
+            "win32crypt_testcert_base64.cer", CERT_QUERY_FORMAT_BASE64_ENCODED
+        )
+
+    def testCertBinary(self):
+        self.checkCertFile("win32crypt_testcert_bin.cer", CERT_QUERY_FORMAT_BINARY)
+
+
+if __name__ == "__main__":
+    testmain()
diff --git a/lib/win32/test/test_win32event.py b/lib/win32/test/test_win32event.py
new file mode 100644
index 00000000..9e6efa3f
--- /dev/null
+++ b/lib/win32/test/test_win32event.py
@@ -0,0 +1,119 @@
+import unittest
+
+import pywintypes
+import win32event
+
+
+class TestWaitableTimer(unittest.TestCase):
+    def testWaitableFire(self):
+        h = win32event.CreateWaitableTimer(None, 0, None)
+        dt = -160  # 160 ns.
+        win32event.SetWaitableTimer(h, dt, 0, None, None, 0)
+        rc = win32event.WaitForSingleObject(h, 1000)
+        self.assertEqual(rc, win32event.WAIT_OBJECT_0)
+
+    def testCreateWaitableTimerEx(self):
+        h = win32event.CreateWaitableTimerEx(
+            None,
+            None,
+            win32event.CREATE_WAITABLE_TIMER_HIGH_RESOLUTION,
+            win32event.TIMER_ALL_ACCESS,
+        )
+        dt = -160  # 160 ns.
+        win32event.SetWaitableTimer(h, dt, 0, None, None, 0)
+        rc = win32event.WaitForSingleObject(h, 1000)
+        self.assertEqual(rc, win32event.WAIT_OBJECT_0)
+
+    def testWaitableTrigger(self):
+        h = win32event.CreateWaitableTimer(None, 0, None)
+        # for the sake of this, pass a long that doesn't fit in an int.
+        dt = -2000000000
+        win32event.SetWaitableTimer(h, dt, 0, None, None, 0)
+        rc = win32event.WaitForSingleObject(h, 10)  # 10 ms.
+        self.assertEqual(rc, win32event.WAIT_TIMEOUT)
+
+    def testWaitableError(self):
+        h = win32event.CreateWaitableTimer(None, 0, None)
+        h.close()
+        self.assertRaises(
+            pywintypes.error, win32event.SetWaitableTimer, h, -42, 0, None, None, 0
+        )
+
+
+class TestWaitFunctions(unittest.TestCase):
+    def testMsgWaitForMultipleObjects(self):
+        # this function used to segfault when called with an empty list
+        res = win32event.MsgWaitForMultipleObjects([], 0, 0, 0)
+        self.assertEqual(res, win32event.WAIT_TIMEOUT)
+
+    def testMsgWaitForMultipleObjects2(self):
+        # test with non-empty list
+        event = win32event.CreateEvent(None, 0, 0, None)
+        res = win32event.MsgWaitForMultipleObjects([event], 0, 0, 0)
+        self.assertEqual(res, win32event.WAIT_TIMEOUT)
+
+    def testMsgWaitForMultipleObjectsEx(self):
+        # this function used to segfault when called with an empty list
+        res = win32event.MsgWaitForMultipleObjectsEx([], 0, 0, 0)
+        self.assertEqual(res, win32event.WAIT_TIMEOUT)
+
+    def testMsgWaitForMultipleObjectsEx2(self):
+        # test with non-empty list
+        event = win32event.CreateEvent(None, 0, 0, None)
+        res = win32event.MsgWaitForMultipleObjectsEx([event], 0, 0, 0)
+        self.assertEqual(res, win32event.WAIT_TIMEOUT)
+
+
+class TestEvent(unittest.TestCase):
+    def assertSignaled(self, event):
+        self.assertEqual(
+            win32event.WaitForSingleObject(event, 0), win32event.WAIT_OBJECT_0
+        )
+
+    def assertNotSignaled(self, event):
+        self.assertEqual(
+            win32event.WaitForSingleObject(event, 0), win32event.WAIT_TIMEOUT
+        )
+
+    def testCreateEvent(self):
+        event = win32event.CreateEvent(None, False, False, None)
+        self.assertNotSignaled(event)
+        event = win32event.CreateEvent(None, False, True, None)
+        self.assertSignaled(event)
+        self.assertNotSignaled(event)
+        event = win32event.CreateEvent(None, True, True, None)
+        self.assertSignaled(event)
+        self.assertSignaled(event)
+
+    def testSetEvent(self):
+        event = win32event.CreateEvent(None, True, False, None)
+        self.assertNotSignaled(event)
+        res = win32event.SetEvent(event)
+        self.assertEqual(res, None)
+        self.assertSignaled(event)
+        event.close()
+        self.assertRaises(pywintypes.error, win32event.SetEvent, event)
+
+    def testResetEvent(self):
+        event = win32event.CreateEvent(None, True, True, None)
+        self.assertSignaled(event)
+        res = win32event.ResetEvent(event)
+        self.assertEqual(res, None)
+        self.assertNotSignaled(event)
+        event.close()
+        self.assertRaises(pywintypes.error, win32event.ResetEvent, event)
+
+
+class TestMutex(unittest.TestCase):
+    def testReleaseMutex(self):
+        mutex = win32event.CreateMutex(None, True, None)
+        res = win32event.ReleaseMutex(mutex)
+        self.assertEqual(res, None)
+        res = win32event.WaitForSingleObject(mutex, 0)
+        self.assertEqual(res, win32event.WAIT_OBJECT_0)
+        mutex.close()
+        self.assertRaises(pywintypes.error, win32event.ReleaseMutex, mutex)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/lib/win32/test/test_win32file.py b/lib/win32/test/test_win32file.py
new file mode 100644
index 00000000..da998032
--- /dev/null
+++ b/lib/win32/test/test_win32file.py
@@ -0,0 +1,1085 @@
+import datetime
+import os
+import random
+import shutil
+import socket
+import tempfile
+import threading
+import time
+import unittest
+
+import ntsecuritycon
+import pywintypes
+import win32api
+import win32con
+import win32event
+import win32file
+import win32pipe
+import win32timezone
+import winerror
+from pywin32_testutil import TestSkipped, str2bytes, testmain
+
+try:
+    set
+except NameError:
+    from sets import Set as set
+
+
+class TestReadBuffer(unittest.TestCase):
+    def testLen(self):
+        buffer = win32file.AllocateReadBuffer(1)
+        self.assertEqual(len(buffer), 1)
+
+    def testSimpleIndex(self):
+        buffer = win32file.AllocateReadBuffer(1)
+        buffer[0] = 0xFF
+        self.assertEqual(buffer[0], 0xFF)
+
+    def testSimpleSlice(self):
+        buffer = win32file.AllocateReadBuffer(2)
+        val = str2bytes("\0\0")
+        buffer[:2] = val
+        self.assertEqual(buffer[0:2], val)
+
+
+class TestSimpleOps(unittest.TestCase):
+    def testSimpleFiles(self):
+        fd, filename = tempfile.mkstemp()
+        os.close(fd)
+        os.unlink(filename)
+        handle = win32file.CreateFile(
+            filename, win32file.GENERIC_WRITE, 0, None, win32con.CREATE_NEW, 0, None
+        )
+        test_data = str2bytes("Hello\0there")
+        try:
+            win32file.WriteFile(handle, test_data)
+            handle.Close()
+            # Try and open for read
+            handle = win32file.CreateFile(
+                filename,
+                win32file.GENERIC_READ,
+                0,
+                None,
+                win32con.OPEN_EXISTING,
+                0,
+                None,
+            )
+            rc, data = win32file.ReadFile(handle, 1024)
+            self.assertEqual(data, test_data)
+        finally:
+            handle.Close()
+            try:
+                os.unlink(filename)
+            except os.error:
+                pass
+
+    # A simple test using normal read/write operations.
+    def testMoreFiles(self):
+        # Create a file in the %TEMP% directory.
+        testName = os.path.join(win32api.GetTempPath(), "win32filetest.dat")
+        desiredAccess = win32file.GENERIC_READ | win32file.GENERIC_WRITE
+        # Set a flag to delete the file automatically when it is closed.
+        fileFlags = win32file.FILE_FLAG_DELETE_ON_CLOSE
+        h = win32file.CreateFile(
+            testName,
+            desiredAccess,
+            win32file.FILE_SHARE_READ,
+            None,
+            win32file.CREATE_ALWAYS,
+            fileFlags,
+            0,
+        )
+
+        # Write a known number of bytes to the file.
+        data = str2bytes("z") * 1025
+
+        win32file.WriteFile(h, data)
+
+        self.assertTrue(
+            win32file.GetFileSize(h) == len(data),
+            "WARNING: Written file does not have the same size as the length of the data in it!",
+        )
+
+        # Ensure we can read the data back.
+        win32file.SetFilePointer(h, 0, win32file.FILE_BEGIN)
+        hr, read_data = win32file.ReadFile(
+            h, len(data) + 10
+        )  # + 10 to get anything extra
+        self.assertTrue(hr == 0, "Readfile returned %d" % hr)
+
+        self.assertTrue(read_data == data, "Read data is not what we wrote!")
+
+        # Now truncate the file at 1/2 its existing size.
+        newSize = len(data) // 2
+        win32file.SetFilePointer(h, newSize, win32file.FILE_BEGIN)
+        win32file.SetEndOfFile(h)
+        self.assertEqual(win32file.GetFileSize(h), newSize)
+
+        # GetFileAttributesEx/GetFileAttributesExW tests.
+        self.assertEqual(
+            win32file.GetFileAttributesEx(testName),
+            win32file.GetFileAttributesExW(testName),
+        )
+
+        attr, ct, at, wt, size = win32file.GetFileAttributesEx(testName)
+        self.assertTrue(
+            size == newSize,
+            "Expected GetFileAttributesEx to return the same size as GetFileSize()",
+        )
+        self.assertTrue(
+            attr == win32file.GetFileAttributes(testName),
+            "Expected GetFileAttributesEx to return the same attributes as GetFileAttributes",
+        )
+
+        h = None  # Close the file by removing the last reference to the handle!
+
+        self.assertTrue(
+            not os.path.isfile(testName), "After closing the file, it still exists!"
+        )
+
+    def testFilePointer(self):
+        # via [ 979270 ] SetFilePointer fails with negative offset
+
+        # Create a file in the %TEMP% directory.
+        filename = os.path.join(win32api.GetTempPath(), "win32filetest.dat")
+
+        f = win32file.CreateFile(
+            filename,
+            win32file.GENERIC_READ | win32file.GENERIC_WRITE,
+            0,
+            None,
+            win32file.CREATE_ALWAYS,
+            win32file.FILE_ATTRIBUTE_NORMAL,
+            0,
+        )
+        try:
+            # Write some data
+            data = str2bytes("Some data")
+            (res, written) = win32file.WriteFile(f, data)
+
+            self.assertFalse(res)
+            self.assertEqual(written, len(data))
+
+            # Move at the beginning and read the data
+            win32file.SetFilePointer(f, 0, win32file.FILE_BEGIN)
+            (res, s) = win32file.ReadFile(f, len(data))
+
+            self.assertFalse(res)
+            self.assertEqual(s, data)
+
+            # Move at the end and read the data
+            win32file.SetFilePointer(f, -len(data), win32file.FILE_END)
+            (res, s) = win32file.ReadFile(f, len(data))
+
+            self.assertFalse(res)
+            self.assertEqual(s, data)
+        finally:
+            f.Close()
+            os.unlink(filename)
+
+    def testFileTimesTimezones(self):
+        filename = tempfile.mktemp("-testFileTimes")
+        # now() is always returning a timestamp with microseconds but the
+        # file APIs all have zero microseconds, so some comparisons fail.
+        now_utc = win32timezone.utcnow().replace(microsecond=0)
+        now_local = now_utc.astimezone(win32timezone.TimeZoneInfo.local())
+        h = win32file.CreateFile(
+            filename,
+            win32file.GENERIC_READ | win32file.GENERIC_WRITE,
+            0,
+            None,
+            win32file.CREATE_ALWAYS,
+            0,
+            0,
+        )
+        try:
+            win32file.SetFileTime(h, now_utc, now_utc, now_utc)
+            ct, at, wt = win32file.GetFileTime(h)
+            self.assertEqual(now_local, ct)
+            self.assertEqual(now_local, at)
+            self.assertEqual(now_local, wt)
+            # and the reverse - set local, check against utc
+            win32file.SetFileTime(h, now_local, now_local, now_local)
+            ct, at, wt = win32file.GetFileTime(h)
+            self.assertEqual(now_utc, ct)
+            self.assertEqual(now_utc, at)
+            self.assertEqual(now_utc, wt)
+        finally:
+            h.close()
+            os.unlink(filename)
+
+    def testFileTimes(self):
+        from win32timezone import TimeZoneInfo
+
+        # now() is always returning a timestamp with microseconds but the
+        # file APIs all have zero microseconds, so some comparisons fail.
+        now = datetime.datetime.now(tz=TimeZoneInfo.utc()).replace(microsecond=0)
+        nowish = now + datetime.timedelta(seconds=1)
+        later = now + datetime.timedelta(seconds=120)
+
+        filename = tempfile.mktemp("-testFileTimes")
+        # Windows docs the 'last time' isn't valid until the last write
+        # handle is closed - so create the file, then re-open it to check.
+        open(filename, "w").close()
+        f = win32file.CreateFile(
+            filename,
+            win32file.GENERIC_READ | win32file.GENERIC_WRITE,
+            0,
+            None,
+            win32con.OPEN_EXISTING,
+            0,
+            None,
+        )
+        try:
+            ct, at, wt = win32file.GetFileTime(f)
+            self.assertTrue(
+                ct >= now,
+                "File was created in the past - now=%s, created=%s" % (now, ct),
+            )
+            self.assertTrue(now <= ct <= nowish, (now, ct))
+            self.assertTrue(
+                wt >= now,
+                "File was written-to in the past now=%s, written=%s" % (now, wt),
+            )
+            self.assertTrue(now <= wt <= nowish, (now, wt))
+
+            # Now set the times.
+            win32file.SetFileTime(f, later, later, later, UTCTimes=True)
+            # Get them back.
+            ct, at, wt = win32file.GetFileTime(f)
+            # XXX - the builtin PyTime type appears to be out by a dst offset.
+            # just ignore that type here...
+            self.assertEqual(ct, later)
+            self.assertEqual(at, later)
+            self.assertEqual(wt, later)
+
+        finally:
+            f.Close()
+            os.unlink(filename)
+
+
+class TestGetFileInfoByHandleEx(unittest.TestCase):
+    __handle = __filename = None
+
+    def setUp(self):
+        fd, self.__filename = tempfile.mkstemp()
+        os.close(fd)
+
+    def tearDown(self):
+        if self.__handle is not None:
+            self.__handle.Close()
+        if self.__filename is not None:
+            try:
+                os.unlink(self.__filename)
+            except OSError:
+                pass
+        self.__handle = self.__filename = None
+
+    def testFileBasicInfo(self):
+        attr = win32file.GetFileAttributes(self.__filename)
+        f = win32file.CreateFile(
+            self.__filename,
+            win32file.GENERIC_READ,
+            0,
+            None,
+            win32con.OPEN_EXISTING,
+            0,
+            None,
+        )
+        self.__handle = f
+        ct, at, wt = win32file.GetFileTime(f)
+
+        # bug #752: this throws ERROR_BAD_LENGTH (24) in x86 binaries of build 221
+        basic_info = win32file.GetFileInformationByHandleEx(f, win32file.FileBasicInfo)
+
+        self.assertEqual(ct, basic_info["CreationTime"])
+        self.assertEqual(at, basic_info["LastAccessTime"])
+        self.assertEqual(wt, basic_info["LastWriteTime"])
+        self.assertEqual(attr, basic_info["FileAttributes"])
+
+
+class TestOverlapped(unittest.TestCase):
+    def testSimpleOverlapped(self):
+        # Create a file in the %TEMP% directory.
+        import win32event
+
+        testName = os.path.join(win32api.GetTempPath(), "win32filetest.dat")
+        desiredAccess = win32file.GENERIC_WRITE
+        overlapped = pywintypes.OVERLAPPED()
+        evt = win32event.CreateEvent(None, 0, 0, None)
+        overlapped.hEvent = evt
+        # Create the file and write shit-loads of data to it.
+        h = win32file.CreateFile(
+            testName, desiredAccess, 0, None, win32file.CREATE_ALWAYS, 0, 0
+        )
+        chunk_data = str2bytes("z") * 0x8000
+        num_loops = 512
+        expected_size = num_loops * len(chunk_data)
+        for i in range(num_loops):
+            win32file.WriteFile(h, chunk_data, overlapped)
+            win32event.WaitForSingleObject(overlapped.hEvent, win32event.INFINITE)
+            overlapped.Offset = overlapped.Offset + len(chunk_data)
+        h.Close()
+        # Now read the data back overlapped
+        overlapped = pywintypes.OVERLAPPED()
+        evt = win32event.CreateEvent(None, 0, 0, None)
+        overlapped.hEvent = evt
+        desiredAccess = win32file.GENERIC_READ
+        h = win32file.CreateFile(
+            testName, desiredAccess, 0, None, win32file.OPEN_EXISTING, 0, 0
+        )
+        buffer = win32file.AllocateReadBuffer(0xFFFF)
+        while 1:
+            try:
+                hr, data = win32file.ReadFile(h, buffer, overlapped)
+                win32event.WaitForSingleObject(overlapped.hEvent, win32event.INFINITE)
+                overlapped.Offset = overlapped.Offset + len(data)
+                if not data is buffer:
+                    self.fail(
+                        "Unexpected result from ReadFile - should be the same buffer we passed it"
+                    )
+            except win32api.error:
+                break
+        h.Close()
+
+    def testCompletionPortsMultiple(self):
+        # Mainly checking that we can "associate" an existing handle.  This
+        # failed in build 203.
+        ioport = win32file.CreateIoCompletionPort(
+            win32file.INVALID_HANDLE_VALUE, 0, 0, 0
+        )
+        socks = []
+        for PORT in range(9123, 9125):
+            sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+            sock.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
+            sock.bind(("", PORT))
+            sock.listen(1)
+            socks.append(sock)
+            new = win32file.CreateIoCompletionPort(sock.fileno(), ioport, PORT, 0)
+            assert new is ioport
+        for s in socks:
+            s.close()
+        hv = int(ioport)
+        ioport = new = None
+        # The handle itself should be closed now (unless we leak references!)
+        # Check that.
+        try:
+            win32file.CloseHandle(hv)
+            raise RuntimeError("Expected close to fail!")
+        except win32file.error as details:
+            self.assertEqual(details.winerror, winerror.ERROR_INVALID_HANDLE)
+
+    def testCompletionPortsQueued(self):
+        class Foo:
+            pass
+
+        io_req_port = win32file.CreateIoCompletionPort(-1, None, 0, 0)
+        overlapped = pywintypes.OVERLAPPED()
+        overlapped.object = Foo()
+        win32file.PostQueuedCompletionStatus(io_req_port, 0, 99, overlapped)
+        errCode, bytes, key, overlapped = win32file.GetQueuedCompletionStatus(
+            io_req_port, win32event.INFINITE
+        )
+        self.assertEqual(errCode, 0)
+        self.assertTrue(isinstance(overlapped.object, Foo))
+
+    def _IOCPServerThread(self, handle, port, drop_overlapped_reference):
+        overlapped = pywintypes.OVERLAPPED()
+        win32pipe.ConnectNamedPipe(handle, overlapped)
+        if drop_overlapped_reference:
+            # Be naughty - the overlapped object is now dead, but
+            # GetQueuedCompletionStatus will still find it.  Our check of
+            # reference counting should catch that error.
+            overlapped = None
+            # even if we fail, be sure to close the handle; prevents hangs
+            # on Vista 64...
+            try:
+                self.assertRaises(
+                    RuntimeError, win32file.GetQueuedCompletionStatus, port, -1
+                )
+            finally:
+                handle.Close()
+            return
+
+        result = win32file.GetQueuedCompletionStatus(port, -1)
+        ol2 = result[-1]
+        self.assertTrue(ol2 is overlapped)
+        data = win32file.ReadFile(handle, 512)[1]
+        win32file.WriteFile(handle, data)
+
+    def testCompletionPortsNonQueued(self, test_overlapped_death=0):
+        # In 204 we had a reference count bug when OVERLAPPED objects were
+        # associated with a completion port other than via
+        # PostQueuedCompletionStatus.  This test is based on the reproduction
+        # reported with that bug.
+        # Create the pipe.
+        BUFSIZE = 512
+        pipe_name = r"\\.\pipe\pywin32_test_pipe"
+        handle = win32pipe.CreateNamedPipe(
+            pipe_name,
+            win32pipe.PIPE_ACCESS_DUPLEX | win32file.FILE_FLAG_OVERLAPPED,
+            win32pipe.PIPE_TYPE_MESSAGE
+            | win32pipe.PIPE_READMODE_MESSAGE
+            | win32pipe.PIPE_WAIT,
+            1,
+            BUFSIZE,
+            BUFSIZE,
+            win32pipe.NMPWAIT_WAIT_FOREVER,
+            None,
+        )
+        # Create an IOCP and associate it with the handle.
+        port = win32file.CreateIoCompletionPort(-1, 0, 0, 0)
+        win32file.CreateIoCompletionPort(handle, port, 1, 0)
+
+        t = threading.Thread(
+            target=self._IOCPServerThread, args=(handle, port, test_overlapped_death)
+        )
+        t.setDaemon(True)  # avoid hanging entire test suite on failure.
+        t.start()
+        try:
+            time.sleep(0.1)  # let thread do its thing.
+            try:
+                win32pipe.CallNamedPipe(
+                    r"\\.\pipe\pywin32_test_pipe", str2bytes("Hello there"), BUFSIZE, 0
+                )
+            except win32pipe.error:
+                # Testing for overlapped death causes this
+                if not test_overlapped_death:
+                    raise
+        finally:
+            if not test_overlapped_death:
+                handle.Close()
+            t.join(3)
+            self.assertFalse(t.is_alive(), "thread didn't finish")
+
+    def testCompletionPortsNonQueuedBadReference(self):
+        self.testCompletionPortsNonQueued(True)
+
+    def testHashable(self):
+        overlapped = pywintypes.OVERLAPPED()
+        d = {}
+        d[overlapped] = "hello"
+        self.assertEqual(d[overlapped], "hello")
+
+    def testComparable(self):
+        overlapped = pywintypes.OVERLAPPED()
+        self.assertEqual(overlapped, overlapped)
+        # ensure we explicitly test the operators.
+        self.assertTrue(overlapped == overlapped)
+        self.assertFalse(overlapped != overlapped)
+
+    def testComparable2(self):
+        # 2 overlapped objects compare equal if their contents are the same.
+        overlapped1 = pywintypes.OVERLAPPED()
+        overlapped2 = pywintypes.OVERLAPPED()
+        self.assertEqual(overlapped1, overlapped2)
+        # ensure we explicitly test the operators.
+        self.assertTrue(overlapped1 == overlapped2)
+        self.assertFalse(overlapped1 != overlapped2)
+        # now change something in one of them - should no longer be equal.
+        overlapped1.hEvent = 1
+        self.assertNotEqual(overlapped1, overlapped2)
+        # ensure we explicitly test the operators.
+        self.assertFalse(overlapped1 == overlapped2)
+        self.assertTrue(overlapped1 != overlapped2)
+
+
+class TestSocketExtensions(unittest.TestCase):
+    def acceptWorker(self, port, running_event, stopped_event):
+        listener = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+        listener.bind(("", port))
+        listener.listen(200)
+
+        # create accept socket
+        accepter = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+        # An overlapped
+        overlapped = pywintypes.OVERLAPPED()
+        overlapped.hEvent = win32event.CreateEvent(None, 0, 0, None)
+        # accept the connection.
+        # We used to allow strings etc to be passed here, and they would be
+        # modified!  Obviously this is evil :)
+        buffer = " " * 1024  # EVIL - SHOULD NOT BE ALLOWED.
+        self.assertRaises(
+            TypeError, win32file.AcceptEx, listener, accepter, buffer, overlapped
+        )
+
+        # This is the correct way to allocate the buffer...
+        buffer = win32file.AllocateReadBuffer(1024)
+        rc = win32file.AcceptEx(listener, accepter, buffer, overlapped)
+        self.assertEqual(rc, winerror.ERROR_IO_PENDING)
+        # Set the event to say we are all ready
+        running_event.set()
+        # and wait for the connection.
+        rc = win32event.WaitForSingleObject(overlapped.hEvent, 2000)
+        if rc == win32event.WAIT_TIMEOUT:
+            self.fail("timed out waiting for a connection")
+        nbytes = win32file.GetOverlappedResult(listener.fileno(), overlapped, False)
+        # fam, loc, rem = win32file.GetAcceptExSockaddrs(accepter, buffer)
+        accepter.send(buffer[:nbytes])
+        # NOT set in a finally - this means *successfully* stopped!
+        stopped_event.set()
+
+    def testAcceptEx(self):
+        port = 4680
+        running = threading.Event()
+        stopped = threading.Event()
+        t = threading.Thread(target=self.acceptWorker, args=(port, running, stopped))
+        t.start()
+        running.wait(2)
+        if not running.isSet():
+            self.fail("AcceptEx Worker thread failed to start")
+        s = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+        s.connect(("127.0.0.1", port))
+        win32file.WSASend(s, str2bytes("hello"), None)
+        overlapped = pywintypes.OVERLAPPED()
+        overlapped.hEvent = win32event.CreateEvent(None, 0, 0, None)
+        # Like above - WSARecv used to allow strings as the receive buffer!!
+        buffer = " " * 10
+        self.assertRaises(TypeError, win32file.WSARecv, s, buffer, overlapped)
+        # This one should work :)
+        buffer = win32file.AllocateReadBuffer(10)
+        win32file.WSARecv(s, buffer, overlapped)
+        nbytes = win32file.GetOverlappedResult(s.fileno(), overlapped, True)
+        got = buffer[:nbytes]
+        self.assertEqual(got, str2bytes("hello"))
+        # thread should have stopped
+        stopped.wait(2)
+        if not stopped.isSet():
+            self.fail("AcceptEx Worker thread failed to successfully stop")
+
+
+class TestFindFiles(unittest.TestCase):
+    def testIter(self):
+        dir = os.path.join(os.getcwd(), "*")
+        files = win32file.FindFilesW(dir)
+        set1 = set()
+        set1.update(files)
+        set2 = set()
+        for file in win32file.FindFilesIterator(dir):
+            set2.add(file)
+        assert len(set2) > 5, "This directory has less than 5 files!?"
+        self.assertEqual(set1, set2)
+
+    def testBadDir(self):
+        dir = os.path.join(os.getcwd(), "a dir that doesnt exist", "*")
+        self.assertRaises(win32file.error, win32file.FindFilesIterator, dir)
+
+    def testEmptySpec(self):
+        spec = os.path.join(os.getcwd(), "*.foo_bar")
+        num = 0
+        for i in win32file.FindFilesIterator(spec):
+            num += 1
+        self.assertEqual(0, num)
+
+    def testEmptyDir(self):
+        test_path = os.path.join(win32api.GetTempPath(), "win32file_test_directory")
+        try:
+            # Note: previously used shutil.rmtree, but when looking for
+            # reference count leaks, that function showed leaks!  os.rmdir
+            # doesn't have that problem.
+            os.rmdir(test_path)
+        except os.error:
+            pass
+        os.mkdir(test_path)
+        try:
+            num = 0
+            for i in win32file.FindFilesIterator(os.path.join(test_path, "*")):
+                num += 1
+            # Expecting "." and ".." only
+            self.assertEqual(2, num)
+        finally:
+            os.rmdir(test_path)
+
+
+class TestDirectoryChanges(unittest.TestCase):
+    num_test_dirs = 1
+
+    def setUp(self):
+        self.watcher_threads = []
+        self.watcher_thread_changes = []
+        self.dir_names = []
+        self.dir_handles = []
+        for i in range(self.num_test_dirs):
+            td = tempfile.mktemp("-test-directory-changes-%d" % i)
+            os.mkdir(td)
+            self.dir_names.append(td)
+            hdir = win32file.CreateFile(
+                td,
+                ntsecuritycon.FILE_LIST_DIRECTORY,
+                win32con.FILE_SHARE_READ,
+                None,  # security desc
+                win32con.OPEN_EXISTING,
+                win32con.FILE_FLAG_BACKUP_SEMANTICS | win32con.FILE_FLAG_OVERLAPPED,
+                None,
+            )
+            self.dir_handles.append(hdir)
+
+            changes = []
+            t = threading.Thread(
+                target=self._watcherThreadOverlapped, args=(td, hdir, changes)
+            )
+            t.start()
+            self.watcher_threads.append(t)
+            self.watcher_thread_changes.append(changes)
+
+    def _watcherThread(self, dn, dh, changes):
+        # A synchronous version:
+        # XXX - not used - I was having a whole lot of problems trying to
+        # get this to work.  Specifically:
+        # * ReadDirectoryChangesW without an OVERLAPPED blocks infinitely.
+        # * If another thread attempts to close the handle while
+        #   ReadDirectoryChangesW is waiting on it, the ::CloseHandle() method
+        #   blocks (which has nothing to do with the GIL - it is correctly
+        #   managed)
+        # Which ends up with no way to kill the thread!
+        flags = win32con.FILE_NOTIFY_CHANGE_FILE_NAME
+        while 1:
+            try:
+                print("waiting", dh)
+                changes = win32file.ReadDirectoryChangesW(
+                    dh, 8192, False, flags  # sub-tree
+                )
+                print("got", changes)
+            except:
+                raise
+            changes.extend(changes)
+
+    def _watcherThreadOverlapped(self, dn, dh, changes):
+        flags = win32con.FILE_NOTIFY_CHANGE_FILE_NAME
+        buf = win32file.AllocateReadBuffer(8192)
+        overlapped = pywintypes.OVERLAPPED()
+        overlapped.hEvent = win32event.CreateEvent(None, 0, 0, None)
+        while 1:
+            win32file.ReadDirectoryChangesW(
+                dh, buf, False, flags, overlapped  # sub-tree
+            )
+            # Wait for our event, or for 5 seconds.
+            rc = win32event.WaitForSingleObject(overlapped.hEvent, 5000)
+            if rc == win32event.WAIT_OBJECT_0:
+                # got some data!  Must use GetOverlappedResult to find out
+                # how much is valid!  0 generally means the handle has
+                # been closed.  Blocking is OK here, as the event has
+                # already been set.
+                nbytes = win32file.GetOverlappedResult(dh, overlapped, True)
+                if nbytes:
+                    bits = win32file.FILE_NOTIFY_INFORMATION(buf, nbytes)
+                    changes.extend(bits)
+                else:
+                    # This is "normal" exit - our 'tearDown' closes the
+                    # handle.
+                    # print "looks like dir handle was closed!"
+                    return
+            else:
+                print("ERROR: Watcher thread timed-out!")
+                return  # kill the thread!
+
+    def tearDown(self):
+        # be careful about raising errors at teardown!
+        for h in self.dir_handles:
+            # See comments in _watcherThread above - this appears to
+            # deadlock if a synchronous ReadDirectoryChangesW is waiting...
+            # (No such problems with an asynch ReadDirectoryChangesW)
+            h.Close()
+        for dn in self.dir_names:
+            try:
+                shutil.rmtree(dn)
+            except OSError:
+                print("FAILED to remove directory", dn)
+
+        for t in self.watcher_threads:
+            # closing dir handle should have killed threads!
+            t.join(5)
+            if t.is_alive():
+                print("FAILED to wait for thread termination")
+
+    def stablize(self):
+        time.sleep(0.5)
+
+    def testSimple(self):
+        self.stablize()
+        for dn in self.dir_names:
+            fn = os.path.join(dn, "test_file")
+            open(fn, "w").close()
+
+        self.stablize()
+        changes = self.watcher_thread_changes[0]
+        self.assertEqual(changes, [(1, "test_file")])
+
+    def testSmall(self):
+        self.stablize()
+        for dn in self.dir_names:
+            fn = os.path.join(dn, "x")
+            open(fn, "w").close()
+
+        self.stablize()
+        changes = self.watcher_thread_changes[0]
+        self.assertEqual(changes, [(1, "x")])
+
+
+class TestEncrypt(unittest.TestCase):
+    def testEncrypt(self):
+        fname = tempfile.mktemp("win32file_test")
+        f = open(fname, "wb")
+        f.write(str2bytes("hello"))
+        f.close()
+        f = None
+        try:
+            try:
+                win32file.EncryptFile(fname)
+            except win32file.error as details:
+                if details.winerror != winerror.ERROR_ACCESS_DENIED:
+                    raise
+                print("It appears this is not NTFS - cant encrypt/decrypt")
+            win32file.DecryptFile(fname)
+        finally:
+            if f is not None:
+                f.close()
+            os.unlink(fname)
+
+
+class TestConnect(unittest.TestCase):
+    def connect_thread_runner(self, expect_payload, giveup_event):
+        # As Windows 2000 doesn't do ConnectEx, we need to use a non-blocking
+        # accept, as our test connection may never come.  May as well use
+        # AcceptEx for this...
+        listener = socket.socket()
+        self.addr = ("localhost", random.randint(10000, 64000))
+        listener.bind(self.addr)
+        listener.listen(1)
+
+        # create accept socket
+        accepter = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+        # An overlapped
+        overlapped = pywintypes.OVERLAPPED()
+        overlapped.hEvent = win32event.CreateEvent(None, 0, 0, None)
+        # accept the connection.
+        if expect_payload:
+            buf_size = 1024
+        else:
+            # when we don't expect data we must be careful to only pass the
+            # exact number of bytes for the endpoint data...
+            buf_size = win32file.CalculateSocketEndPointSize(listener)
+
+        buffer = win32file.AllocateReadBuffer(buf_size)
+        win32file.AcceptEx(listener, accepter, buffer, overlapped)
+        # wait for the connection or our test to fail.
+        events = giveup_event, overlapped.hEvent
+        rc = win32event.WaitForMultipleObjects(events, False, 2000)
+        if rc == win32event.WAIT_TIMEOUT:
+            self.fail("timed out waiting for a connection")
+        if rc == win32event.WAIT_OBJECT_0:
+            # Our main thread running the test failed and will never connect.
+            return
+        # must be a connection.
+        nbytes = win32file.GetOverlappedResult(listener.fileno(), overlapped, False)
+        if expect_payload:
+            self.request = buffer[:nbytes]
+        accepter.send(str2bytes("some expected response"))
+
+    def test_connect_with_payload(self):
+        giveup_event = win32event.CreateEvent(None, 0, 0, None)
+        t = threading.Thread(
+            target=self.connect_thread_runner, args=(True, giveup_event)
+        )
+        t.start()
+        time.sleep(0.1)
+        s2 = socket.socket()
+        ol = pywintypes.OVERLAPPED()
+        s2.bind(("0.0.0.0", 0))  # connectex requires the socket be bound beforehand
+        try:
+            win32file.ConnectEx(s2, self.addr, ol, str2bytes("some expected request"))
+        except win32file.error as exc:
+            win32event.SetEvent(giveup_event)
+            if exc.winerror == 10022:  # WSAEINVAL
+                raise TestSkipped("ConnectEx is not available on this platform")
+            raise  # some error error we don't expect.
+        # We occasionally see ERROR_CONNECTION_REFUSED in automation
+        try:
+            win32file.GetOverlappedResult(s2.fileno(), ol, 1)
+        except win32file.error as exc:
+            win32event.SetEvent(giveup_event)
+            if exc.winerror == winerror.ERROR_CONNECTION_REFUSED:
+                raise TestSkipped("Assuming ERROR_CONNECTION_REFUSED is transient")
+            raise
+        ol = pywintypes.OVERLAPPED()
+        buff = win32file.AllocateReadBuffer(1024)
+        win32file.WSARecv(s2, buff, ol, 0)
+        length = win32file.GetOverlappedResult(s2.fileno(), ol, 1)
+        self.response = buff[:length]
+        self.assertEqual(self.response, str2bytes("some expected response"))
+        self.assertEqual(self.request, str2bytes("some expected request"))
+        t.join(5)
+        self.assertFalse(t.is_alive(), "worker thread didn't terminate")
+
+    def test_connect_without_payload(self):
+        giveup_event = win32event.CreateEvent(None, 0, 0, None)
+        t = threading.Thread(
+            target=self.connect_thread_runner, args=(False, giveup_event)
+        )
+        t.start()
+        time.sleep(0.1)
+        s2 = socket.socket()
+        ol = pywintypes.OVERLAPPED()
+        s2.bind(("0.0.0.0", 0))  # connectex requires the socket be bound beforehand
+        try:
+            win32file.ConnectEx(s2, self.addr, ol)
+        except win32file.error as exc:
+            win32event.SetEvent(giveup_event)
+            if exc.winerror == 10022:  # WSAEINVAL
+                raise TestSkipped("ConnectEx is not available on this platform")
+            raise  # some error error we don't expect.
+        # We occasionally see ERROR_CONNECTION_REFUSED in automation
+        try:
+            win32file.GetOverlappedResult(s2.fileno(), ol, 1)
+        except win32file.error as exc:
+            win32event.SetEvent(giveup_event)
+            if exc.winerror == winerror.ERROR_CONNECTION_REFUSED:
+                raise TestSkipped("Assuming ERROR_CONNECTION_REFUSED is transient")
+            raise
+
+        ol = pywintypes.OVERLAPPED()
+        buff = win32file.AllocateReadBuffer(1024)
+        win32file.WSARecv(s2, buff, ol, 0)
+        length = win32file.GetOverlappedResult(s2.fileno(), ol, 1)
+        self.response = buff[:length]
+        self.assertEqual(self.response, str2bytes("some expected response"))
+        t.join(5)
+        self.assertFalse(t.is_alive(), "worker thread didn't terminate")
+
+
+class TestTransmit(unittest.TestCase):
+    def test_transmit(self):
+        import binascii
+
+        bytes = os.urandom(1024 * 1024)
+        val = binascii.hexlify(bytes)
+        val_length = len(val)
+        f = tempfile.TemporaryFile()
+        f.write(val)
+
+        def runner():
+            s1 = socket.socket()
+            # binding fails occasionally on github CI with:
+            # OSError: [WinError 10013] An attempt was made to access a socket in a way forbidden by its access permissions
+            # which probably just means the random port is already in use, so
+            # let that happen a few times.
+            for i in range(5):
+                self.addr = ("localhost", random.randint(10000, 64000))
+                try:
+                    s1.bind(self.addr)
+                    break
+                except os.error as exc:
+                    if exc.winerror != 10013:
+                        raise
+                    print("Failed to use port", self.addr, "trying another random one")
+            else:
+                raise RuntimeError("Failed to find an available port to bind to.")
+            s1.listen(1)
+            cli, addr = s1.accept()
+            buf = 1
+            self.request = []
+            while buf:
+                buf = cli.recv(1024 * 100)
+                self.request.append(buf)
+
+        th = threading.Thread(target=runner)
+        th.start()
+        time.sleep(0.5)
+        s2 = socket.socket()
+        s2.connect(self.addr)
+
+        length = 0
+        aaa = str2bytes("[AAA]")
+        bbb = str2bytes("[BBB]")
+        ccc = str2bytes("[CCC]")
+        ddd = str2bytes("[DDD]")
+        empty = str2bytes("")
+        ol = pywintypes.OVERLAPPED()
+        f.seek(0)
+        win32file.TransmitFile(
+            s2, win32file._get_osfhandle(f.fileno()), val_length, 0, ol, 0
+        )
+        length += win32file.GetOverlappedResult(s2.fileno(), ol, 1)
+
+        ol = pywintypes.OVERLAPPED()
+        f.seek(0)
+        win32file.TransmitFile(
+            s2, win32file._get_osfhandle(f.fileno()), val_length, 0, ol, 0, aaa, bbb
+        )
+        length += win32file.GetOverlappedResult(s2.fileno(), ol, 1)
+
+        ol = pywintypes.OVERLAPPED()
+        f.seek(0)
+        win32file.TransmitFile(
+            s2, win32file._get_osfhandle(f.fileno()), val_length, 0, ol, 0, empty, empty
+        )
+        length += win32file.GetOverlappedResult(s2.fileno(), ol, 1)
+
+        ol = pywintypes.OVERLAPPED()
+        f.seek(0)
+        win32file.TransmitFile(
+            s2, win32file._get_osfhandle(f.fileno()), val_length, 0, ol, 0, None, ccc
+        )
+        length += win32file.GetOverlappedResult(s2.fileno(), ol, 1)
+
+        ol = pywintypes.OVERLAPPED()
+        f.seek(0)
+        win32file.TransmitFile(
+            s2, win32file._get_osfhandle(f.fileno()), val_length, 0, ol, 0, ddd
+        )
+        length += win32file.GetOverlappedResult(s2.fileno(), ol, 1)
+
+        s2.close()
+        th.join()
+        buf = str2bytes("").join(self.request)
+        self.assertEqual(length, len(buf))
+        expected = val + aaa + val + bbb + val + val + ccc + ddd + val
+        self.assertEqual(type(expected), type(buf))
+        self.assertEqual(expected, buf)
+
+
+class TestWSAEnumNetworkEvents(unittest.TestCase):
+    def test_basics(self):
+        s = socket.socket()
+        e = win32event.CreateEvent(None, 1, 0, None)
+        win32file.WSAEventSelect(s, e, 0)
+        self.assertEqual(win32file.WSAEnumNetworkEvents(s), {})
+        self.assertEqual(win32file.WSAEnumNetworkEvents(s, e), {})
+        self.assertRaises(TypeError, win32file.WSAEnumNetworkEvents, s, e, 3)
+        self.assertRaises(TypeError, win32file.WSAEnumNetworkEvents, s, "spam")
+        self.assertRaises(TypeError, win32file.WSAEnumNetworkEvents, "spam", e)
+        self.assertRaises(TypeError, win32file.WSAEnumNetworkEvents, "spam")
+        f = open("NUL")
+        h = win32file._get_osfhandle(f.fileno())
+        self.assertRaises(win32file.error, win32file.WSAEnumNetworkEvents, h)
+        self.assertRaises(win32file.error, win32file.WSAEnumNetworkEvents, s, h)
+        try:
+            win32file.WSAEnumNetworkEvents(h)
+        except win32file.error as e:
+            self.assertEqual(e.winerror, win32file.WSAENOTSOCK)
+        try:
+            win32file.WSAEnumNetworkEvents(s, h)
+        except win32file.error as e:
+            # According to the docs it would seem reasonable that
+            # this would fail with WSAEINVAL, but it doesn't.
+            self.assertEqual(e.winerror, win32file.WSAENOTSOCK)
+
+    def test_functional(self):
+        # This is not really a unit test, but it does exercise the code
+        # quite well and can serve as an example of WSAEventSelect and
+        # WSAEnumNetworkEvents usage.
+        port = socket.socket()
+        port.setblocking(0)
+        port_event = win32event.CreateEvent(None, 0, 0, None)
+        win32file.WSAEventSelect(
+            port, port_event, win32file.FD_ACCEPT | win32file.FD_CLOSE
+        )
+        port.bind(("127.0.0.1", 0))
+        port.listen(10)
+
+        client = socket.socket()
+        client.setblocking(0)
+        client_event = win32event.CreateEvent(None, 0, 0, None)
+        win32file.WSAEventSelect(
+            client,
+            client_event,
+            win32file.FD_CONNECT
+            | win32file.FD_READ
+            | win32file.FD_WRITE
+            | win32file.FD_CLOSE,
+        )
+        err = client.connect_ex(port.getsockname())
+        self.assertEqual(err, win32file.WSAEWOULDBLOCK)
+
+        res = win32event.WaitForSingleObject(port_event, 1000)
+        self.assertEqual(res, win32event.WAIT_OBJECT_0)
+        events = win32file.WSAEnumNetworkEvents(port, port_event)
+        self.assertEqual(events, {win32file.FD_ACCEPT: 0})
+
+        server, addr = port.accept()
+        server.setblocking(0)
+        server_event = win32event.CreateEvent(None, 1, 0, None)
+        win32file.WSAEventSelect(
+            server,
+            server_event,
+            win32file.FD_READ | win32file.FD_WRITE | win32file.FD_CLOSE,
+        )
+        res = win32event.WaitForSingleObject(server_event, 1000)
+        self.assertEqual(res, win32event.WAIT_OBJECT_0)
+        events = win32file.WSAEnumNetworkEvents(server, server_event)
+        self.assertEqual(events, {win32file.FD_WRITE: 0})
+
+        res = win32event.WaitForSingleObject(client_event, 1000)
+        self.assertEqual(res, win32event.WAIT_OBJECT_0)
+        events = win32file.WSAEnumNetworkEvents(client, client_event)
+        self.assertEqual(events, {win32file.FD_CONNECT: 0, win32file.FD_WRITE: 0})
+        sent = 0
+        data = str2bytes("x") * 16 * 1024
+        while sent < 16 * 1024 * 1024:
+            try:
+                sent += client.send(data)
+            except socket.error as e:
+                if e.args[0] == win32file.WSAEINTR:
+                    continue
+                elif e.args[0] in (win32file.WSAEWOULDBLOCK, win32file.WSAENOBUFS):
+                    break
+                else:
+                    raise
+        else:
+            self.fail("could not find socket buffer limit")
+
+        events = win32file.WSAEnumNetworkEvents(client)
+        self.assertEqual(events, {})
+
+        res = win32event.WaitForSingleObject(server_event, 1000)
+        self.assertEqual(res, win32event.WAIT_OBJECT_0)
+        events = win32file.WSAEnumNetworkEvents(server, server_event)
+        self.assertEqual(events, {win32file.FD_READ: 0})
+
+        received = 0
+        while received < sent:
+            try:
+                received += len(server.recv(16 * 1024))
+            except socket.error as e:
+                if e.args[0] in [win32file.WSAEINTR, win32file.WSAEWOULDBLOCK]:
+                    continue
+                else:
+                    raise
+
+        self.assertEqual(received, sent)
+        events = win32file.WSAEnumNetworkEvents(server)
+        self.assertEqual(events, {})
+
+        res = win32event.WaitForSingleObject(client_event, 1000)
+        self.assertEqual(res, win32event.WAIT_OBJECT_0)
+        events = win32file.WSAEnumNetworkEvents(client, client_event)
+        self.assertEqual(events, {win32file.FD_WRITE: 0})
+
+        client.shutdown(socket.SHUT_WR)
+        res = win32event.WaitForSingleObject(server_event, 1000)
+        self.assertEqual(res, win32event.WAIT_OBJECT_0)
+        # strange timing issues...
+        for i in range(5):
+            events = win32file.WSAEnumNetworkEvents(server, server_event)
+            if events:
+                break
+            win32api.Sleep(100)
+        else:
+            raise AssertionError("failed to get events")
+        self.assertEqual(events, {win32file.FD_CLOSE: 0})
+        events = win32file.WSAEnumNetworkEvents(client)
+        self.assertEqual(events, {})
+
+        server.close()
+        res = win32event.WaitForSingleObject(client_event, 1000)
+        self.assertEqual(res, win32event.WAIT_OBJECT_0)
+        events = win32file.WSAEnumNetworkEvents(client, client_event)
+        self.assertEqual(events, {win32file.FD_CLOSE: 0})
+
+        client.close()
+        events = win32file.WSAEnumNetworkEvents(port)
+        self.assertEqual(events, {})
+
+
+if __name__ == "__main__":
+    testmain()
diff --git a/lib/win32/test/test_win32gui.py b/lib/win32/test/test_win32gui.py
new file mode 100644
index 00000000..ad96bd43
--- /dev/null
+++ b/lib/win32/test/test_win32gui.py
@@ -0,0 +1,65 @@
+# tests for win32gui
+import array
+import operator
+import unittest
+
+import pywin32_testutil
+import win32gui
+
+
+class TestPyGetString(unittest.TestCase):
+    def test_get_string(self):
+        # test invalid addresses cause a ValueError rather than crash!
+        self.assertRaises(ValueError, win32gui.PyGetString, 0)
+        self.assertRaises(ValueError, win32gui.PyGetString, 1)
+        self.assertRaises(ValueError, win32gui.PyGetString, 1, 1)
+
+
+class TestPyGetMemory(unittest.TestCase):
+    def test_ob(self):
+        # Check the PyGetMemory result and a bytes string can be compared
+        test_data = b"\0\1\2\3\4\5\6"
+        c = array.array("b", test_data)
+        addr, buflen = c.buffer_info()
+        got = win32gui.PyGetMemory(addr, buflen)
+        self.assertEqual(len(got), len(test_data))
+        self.assertEqual(bytes(got), test_data)
+
+    def test_memory_index(self):
+        # Check we can index into the buffer object returned by PyGetMemory
+        test_data = b"\0\1\2\3\4\5\6"
+        c = array.array("b", test_data)
+        addr, buflen = c.buffer_info()
+        got = win32gui.PyGetMemory(addr, buflen)
+        self.assertEqual(got[0], 0)
+
+    def test_memory_slice(self):
+        # Check we can slice the buffer object returned by PyGetMemory
+        test_data = b"\0\1\2\3\4\5\6"
+        c = array.array("b", test_data)
+        addr, buflen = c.buffer_info()
+        got = win32gui.PyGetMemory(addr, buflen)
+        self.assertEqual(list(got[0:3]), [0, 1, 2])
+
+    def test_real_view(self):
+        # Do the PyGetMemory, then change the original memory, then ensure
+        # the initial object we fetched sees the new value.
+        test_data = b"\0\1\2\3\4\5\6"
+        c = array.array("b", test_data)
+        addr, buflen = c.buffer_info()
+        got = win32gui.PyGetMemory(addr, buflen)
+        self.assertEqual(got[0], 0)
+        c[0] = 1
+        self.assertEqual(got[0], 1)
+
+    def test_memory_not_writable(self):
+        # Check the buffer object fetched by PyGetMemory isn't writable.
+        test_data = b"\0\1\2\3\4\5\6"
+        c = array.array("b", test_data)
+        addr, buflen = c.buffer_info()
+        got = win32gui.PyGetMemory(addr, buflen)
+        self.assertRaises(TypeError, operator.setitem, got, 0, 1)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/lib/win32/test/test_win32guistruct.py b/lib/win32/test/test_win32guistruct.py
new file mode 100644
index 00000000..063cea3a
--- /dev/null
+++ b/lib/win32/test/test_win32guistruct.py
@@ -0,0 +1,330 @@
+import array
+import unittest
+
+import pythoncom
+import win32con
+import win32gui
+import win32gui_struct
+
+
+class TestBase(unittest.TestCase):
+    def assertDictEquals(self, d, **kw):
+        checked = dict()
+        for n, v in kw.items():
+            self.assertEqual(v, d[n], "'%s' doesn't match: %r != %r" % (n, v, d[n]))
+            checked[n] = True
+        checked_keys = list(checked.keys())
+        passed_keys = list(kw.keys())
+        checked_keys.sort()
+        passed_keys.sort()
+        self.assertEqual(checked_keys, passed_keys)
+
+
+class TestMenuItemInfo(TestBase):
+    def _testPackUnpack(self, text):
+        vals = dict(
+            fType=win32con.MFT_MENUBARBREAK,
+            fState=win32con.MFS_CHECKED,
+            wID=123,
+            hSubMenu=1234,
+            hbmpChecked=12345,
+            hbmpUnchecked=123456,
+            dwItemData=1234567,
+            text=text,
+            hbmpItem=321,
+        )
+        mii, extras = win32gui_struct.PackMENUITEMINFO(**vals)
+        (
+            fType,
+            fState,
+            wID,
+            hSubMenu,
+            hbmpChecked,
+            hbmpUnchecked,
+            dwItemData,
+            text,
+            hbmpItem,
+        ) = win32gui_struct.UnpackMENUITEMINFO(mii)
+        self.assertDictEquals(
+            vals,
+            fType=fType,
+            fState=fState,
+            wID=wID,
+            hSubMenu=hSubMenu,
+            hbmpChecked=hbmpChecked,
+            hbmpUnchecked=hbmpUnchecked,
+            dwItemData=dwItemData,
+            text=text,
+            hbmpItem=hbmpItem,
+        )
+
+    def testPackUnpack(self):
+        self._testPackUnpack("Hello")
+
+    def testPackUnpackNone(self):
+        self._testPackUnpack(None)
+
+    def testEmptyMenuItemInfo(self):
+        mii, extra = win32gui_struct.EmptyMENUITEMINFO()
+        (
+            fType,
+            fState,
+            wID,
+            hSubMenu,
+            hbmpChecked,
+            hbmpUnchecked,
+            dwItemData,
+            text,
+            hbmpItem,
+        ) = win32gui_struct.UnpackMENUITEMINFO(mii)
+        self.assertEqual(fType, 0)
+        self.assertEqual(fState, 0)
+        self.assertEqual(wID, 0)
+        self.assertEqual(hSubMenu, 0)
+        self.assertEqual(hbmpChecked, 0)
+        self.assertEqual(hbmpUnchecked, 0)
+        self.assertEqual(dwItemData, 0)
+        self.assertEqual(hbmpItem, 0)
+        # it's not clear if UnpackMENUITEMINFO() should ignore cch, instead
+        # assuming it is a buffer size rather than 'current length' - but it
+        # never has (and this gives us every \0 in the string), and actually
+        # helps us test the unicode/str semantics.
+        self.assertEqual(text, "\0" * len(text))
+
+
+class TestMenuInfo(TestBase):
+    def testPackUnpack(self):
+        vals = dict(dwStyle=1, cyMax=2, hbrBack=3, dwContextHelpID=4, dwMenuData=5)
+
+        mi = win32gui_struct.PackMENUINFO(**vals)
+        (
+            dwStyle,
+            cyMax,
+            hbrBack,
+            dwContextHelpID,
+            dwMenuData,
+        ) = win32gui_struct.UnpackMENUINFO(mi)
+
+        self.assertDictEquals(
+            vals,
+            dwStyle=dwStyle,
+            cyMax=cyMax,
+            hbrBack=hbrBack,
+            dwContextHelpID=dwContextHelpID,
+            dwMenuData=dwMenuData,
+        )
+
+    def testEmptyMenuItemInfo(self):
+        mi = win32gui_struct.EmptyMENUINFO()
+        (
+            dwStyle,
+            cyMax,
+            hbrBack,
+            dwContextHelpID,
+            dwMenuData,
+        ) = win32gui_struct.UnpackMENUINFO(mi)
+        self.assertEqual(dwStyle, 0)
+        self.assertEqual(cyMax, 0)
+        self.assertEqual(hbrBack, 0)
+        self.assertEqual(dwContextHelpID, 0)
+        self.assertEqual(dwMenuData, 0)
+
+
+class TestTreeViewItem(TestBase):
+    def _testPackUnpack(self, text):
+        vals = dict(
+            hitem=1,
+            state=2,
+            stateMask=3,
+            text=text,
+            image=4,
+            selimage=5,
+            citems=6,
+            param=7,
+        )
+
+        ti, extra = win32gui_struct.PackTVITEM(**vals)
+        (
+            hitem,
+            state,
+            stateMask,
+            text,
+            image,
+            selimage,
+            citems,
+            param,
+        ) = win32gui_struct.UnpackTVITEM(ti)
+
+        self.assertDictEquals(
+            vals,
+            hitem=hitem,
+            state=state,
+            stateMask=stateMask,
+            text=text,
+            image=image,
+            selimage=selimage,
+            citems=citems,
+            param=param,
+        )
+
+    def testPackUnpack(self):
+        self._testPackUnpack("Hello")
+
+    def testPackUnpackNone(self):
+        self._testPackUnpack(None)
+
+    def testEmpty(self):
+        ti, extras = win32gui_struct.EmptyTVITEM(0)
+        (
+            hitem,
+            state,
+            stateMask,
+            text,
+            image,
+            selimage,
+            citems,
+            param,
+        ) = win32gui_struct.UnpackTVITEM(ti)
+        self.assertEqual(hitem, 0)
+        self.assertEqual(state, 0)
+        self.assertEqual(stateMask, 0)
+        self.assertEqual(text, "")
+        self.assertEqual(image, 0)
+        self.assertEqual(selimage, 0)
+        self.assertEqual(citems, 0)
+        self.assertEqual(param, 0)
+
+
+class TestListViewItem(TestBase):
+    def _testPackUnpack(self, text):
+        vals = dict(
+            item=None,
+            subItem=None,
+            state=1,
+            stateMask=2,
+            text=text,
+            image=3,
+            param=4,
+            indent=5,
+        )
+
+        ti, extra = win32gui_struct.PackLVITEM(**vals)
+        (
+            item,
+            subItem,
+            state,
+            stateMask,
+            text,
+            image,
+            param,
+            indent,
+        ) = win32gui_struct.UnpackLVITEM(ti)
+
+        # patch expected values.
+        vals["item"] = 0
+        vals["subItem"] = 0
+        self.assertDictEquals(
+            vals,
+            item=item,
+            subItem=subItem,
+            state=state,
+            stateMask=stateMask,
+            text=text,
+            image=image,
+            param=param,
+            indent=indent,
+        )
+
+    def testPackUnpack(self):
+        self._testPackUnpack("Hello")
+
+    def testPackUnpackNone(self):
+        self._testPackUnpack(None)
+
+    def testEmpty(self):
+        ti, extras = win32gui_struct.EmptyLVITEM(1, 2)
+        (
+            item,
+            subItem,
+            state,
+            stateMask,
+            text,
+            image,
+            param,
+            indent,
+        ) = win32gui_struct.UnpackLVITEM(ti)
+        self.assertEqual(item, 1)
+        self.assertEqual(subItem, 2)
+        self.assertEqual(state, 0)
+        self.assertEqual(stateMask, 0)
+        self.assertEqual(text, "")
+        self.assertEqual(image, 0)
+        self.assertEqual(param, 0)
+        self.assertEqual(indent, 0)
+
+
+class TestLVColumn(TestBase):
+    def _testPackUnpack(self, text):
+        vals = dict(fmt=1, cx=2, text=text, subItem=3, image=4, order=5)
+
+        ti, extra = win32gui_struct.PackLVCOLUMN(**vals)
+        fmt, cx, text, subItem, image, order = win32gui_struct.UnpackLVCOLUMN(ti)
+
+        self.assertDictEquals(
+            vals, fmt=fmt, cx=cx, text=text, subItem=subItem, image=image, order=order
+        )
+
+    def testPackUnpack(self):
+        self._testPackUnpack("Hello")
+
+    def testPackUnpackNone(self):
+        self._testPackUnpack(None)
+
+    def testEmpty(self):
+        ti, extras = win32gui_struct.EmptyLVCOLUMN()
+        fmt, cx, text, subItem, image, order = win32gui_struct.UnpackLVCOLUMN(ti)
+        self.assertEqual(fmt, 0)
+        self.assertEqual(cx, 0)
+        self.assertEqual(text, "")
+        self.assertEqual(subItem, 0)
+        self.assertEqual(image, 0)
+        self.assertEqual(order, 0)
+
+
+class TestDEV_BROADCAST_HANDLE(TestBase):
+    def testPackUnpack(self):
+        s = win32gui_struct.PackDEV_BROADCAST_HANDLE(123)
+        c = array.array("b", s)
+        got = win32gui_struct.UnpackDEV_BROADCAST(c.buffer_info()[0])
+        self.assertEqual(got.handle, 123)
+
+    def testGUID(self):
+        s = win32gui_struct.PackDEV_BROADCAST_HANDLE(123, guid=pythoncom.IID_IUnknown)
+        c = array.array("b", s)
+        got = win32gui_struct.UnpackDEV_BROADCAST(c.buffer_info()[0])
+        self.assertEqual(got.handle, 123)
+        self.assertEqual(got.eventguid, pythoncom.IID_IUnknown)
+
+
+class TestDEV_BROADCAST_DEVICEINTERFACE(TestBase):
+    def testPackUnpack(self):
+        s = win32gui_struct.PackDEV_BROADCAST_DEVICEINTERFACE(
+            pythoncom.IID_IUnknown, "hello"
+        )
+        c = array.array("b", s)
+        got = win32gui_struct.UnpackDEV_BROADCAST(c.buffer_info()[0])
+        self.assertEqual(got.classguid, pythoncom.IID_IUnknown)
+        self.assertEqual(got.name, "hello")
+
+
+class TestDEV_BROADCAST_VOLUME(TestBase):
+    def testPackUnpack(self):
+        s = win32gui_struct.PackDEV_BROADCAST_VOLUME(123, 456)
+        c = array.array("b", s)
+        got = win32gui_struct.UnpackDEV_BROADCAST(c.buffer_info()[0])
+        self.assertEqual(got.unitmask, 123)
+        self.assertEqual(got.flags, 456)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/lib/win32/test/test_win32inet.py b/lib/win32/test/test_win32inet.py
new file mode 100644
index 00000000..044ef8e6
--- /dev/null
+++ b/lib/win32/test/test_win32inet.py
@@ -0,0 +1,93 @@
+import unittest
+
+import winerror
+from pywin32_testutil import str2bytes  # py3k-friendly helper
+from pywin32_testutil import TestSkipped, testmain
+from win32inet import *
+from win32inetcon import *
+
+
+class CookieTests(unittest.TestCase):
+    def testCookies(self):
+        data = "TestData=Test"
+        InternetSetCookie("http://www.python.org", None, data)
+        got = InternetGetCookie("http://www.python.org", None)
+        # handle that there might already be cookies for the domain.
+        bits = map(lambda x: x.strip(), got.split(";"))
+        self.assertTrue(data in bits)
+
+    def testCookiesEmpty(self):
+        try:
+            InternetGetCookie("http://site-with-no-cookie.python.org", None)
+            self.fail("expected win32 exception")
+        except error as exc:
+            self.assertEqual(exc.winerror, winerror.ERROR_NO_MORE_ITEMS)
+
+
+class UrlTests(unittest.TestCase):
+    def testSimpleCanonicalize(self):
+        ret = InternetCanonicalizeUrl("foo bar")
+        self.assertEqual(ret, "foo%20bar")
+
+    def testLongCanonicalize(self):
+        # a 4k URL causes the underlying API to request a bigger buffer"
+        big = "x" * 2048
+        ret = InternetCanonicalizeUrl(big + " " + big)
+        self.assertEqual(ret, big + "%20" + big)
+
+
+class TestNetwork(unittest.TestCase):
+    def setUp(self):
+        self.hi = InternetOpen("test", INTERNET_OPEN_TYPE_DIRECT, None, None, 0)
+
+    def tearDown(self):
+        self.hi.Close()
+
+    def testPythonDotOrg(self):
+        hdl = InternetOpenUrl(
+            self.hi, "http://www.python.org", None, INTERNET_FLAG_EXISTING_CONNECT
+        )
+        chunks = []
+        while 1:
+            chunk = InternetReadFile(hdl, 1024)
+            if not chunk:
+                break
+            chunks.append(chunk)
+        data = str2bytes("").join(chunks)
+        assert data.find(str2bytes("Python")) > 0, repr(
+            data
+        )  # This must appear somewhere on the main page!
+
+    def testFtpCommand(self):
+        # ftp.python.org doesn't exist.  ftp.gnu.org is what Python's urllib
+        # test code uses.
+        # (As of 2020 it doesn't! Unsurprisingly, it's difficult to find a good
+        # test server. This test sometimes works, but often doesn't - so handle
+        # failure here as a "skip")
+        try:
+            hcon = InternetConnect(
+                self.hi,
+                "ftp.gnu.org",
+                INTERNET_INVALID_PORT_NUMBER,
+                None,
+                None,  # username/password
+                INTERNET_SERVICE_FTP,
+                0,
+                0,
+            )
+            try:
+                hftp = FtpCommand(hcon, True, FTP_TRANSFER_TYPE_ASCII, "NLST", 0)
+                try:
+                    print("Connected - response info is", InternetGetLastResponseInfo())
+                    got = InternetReadFile(hftp, 2048)
+                    print("Read", len(got), "bytes")
+                finally:
+                    hftp.Close()
+            finally:
+                hcon.Close()
+        except error as e:
+            raise TestSkipped(e)
+
+
+if __name__ == "__main__":
+    testmain()
diff --git a/lib/win32/test/test_win32net.py b/lib/win32/test/test_win32net.py
new file mode 100644
index 00000000..93071963
--- /dev/null
+++ b/lib/win32/test/test_win32net.py
@@ -0,0 +1,24 @@
+import unittest
+
+import win32net
+import win32netcon
+
+
+class TestCase(unittest.TestCase):
+    def testGroupsGoodResume(self, server=None):
+        res = 0
+        level = 0  # setting it to 1 will provide more detailed info
+        while True:
+            (user_list, total, res) = win32net.NetGroupEnum(server, level, res)
+            for i in user_list:
+                pass
+            if not res:
+                break
+
+    def testGroupsBadResume(self, server=None):
+        res = 1  # Can't pass this first time round.
+        self.assertRaises(win32net.error, win32net.NetGroupEnum, server, 0, res)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/lib/win32/test/test_win32pipe.py b/lib/win32/test/test_win32pipe.py
new file mode 100644
index 00000000..cbe647dd
--- /dev/null
+++ b/lib/win32/test/test_win32pipe.py
@@ -0,0 +1,153 @@
+import threading
+import time
+import unittest
+
+import pywintypes
+import win32con
+import win32event
+import win32file
+import win32pipe
+import winerror
+from pywin32_testutil import str2bytes  # py3k-friendly helper
+
+
+class PipeTests(unittest.TestCase):
+    pipename = "\\\\.\\pipe\\python_test_pipe"
+
+    def _serverThread(self, pipe_handle, event, wait_time):
+        # just do one connection and terminate.
+        hr = win32pipe.ConnectNamedPipe(pipe_handle)
+        self.assertTrue(
+            hr in (0, winerror.ERROR_PIPE_CONNECTED), "Got error code 0x%x" % (hr,)
+        )
+        hr, got = win32file.ReadFile(pipe_handle, 100)
+        self.assertEqual(got, str2bytes("foo\0bar"))
+        time.sleep(wait_time)
+        win32file.WriteFile(pipe_handle, str2bytes("bar\0foo"))
+        pipe_handle.Close()
+        event.set()
+
+    def startPipeServer(self, event, wait_time=0):
+        openMode = win32pipe.PIPE_ACCESS_DUPLEX
+        pipeMode = win32pipe.PIPE_TYPE_MESSAGE | win32pipe.PIPE_WAIT
+
+        sa = pywintypes.SECURITY_ATTRIBUTES()
+        sa.SetSecurityDescriptorDacl(1, None, 0)
+
+        pipe_handle = win32pipe.CreateNamedPipe(
+            self.pipename,
+            openMode,
+            pipeMode,
+            win32pipe.PIPE_UNLIMITED_INSTANCES,
+            0,
+            0,
+            2000,
+            sa,
+        )
+
+        threading.Thread(
+            target=self._serverThread, args=(pipe_handle, event, wait_time)
+        ).start()
+
+    def testCallNamedPipe(self):
+        event = threading.Event()
+        self.startPipeServer(event)
+
+        got = win32pipe.CallNamedPipe(
+            self.pipename, str2bytes("foo\0bar"), 1024, win32pipe.NMPWAIT_WAIT_FOREVER
+        )
+        self.assertEqual(got, str2bytes("bar\0foo"))
+        event.wait(5)
+        self.assertTrue(event.isSet(), "Pipe server thread didn't terminate")
+
+    def testTransactNamedPipeBlocking(self):
+        event = threading.Event()
+        self.startPipeServer(event)
+        open_mode = win32con.GENERIC_READ | win32con.GENERIC_WRITE
+
+        hpipe = win32file.CreateFile(
+            self.pipename,
+            open_mode,
+            0,  # no sharing
+            None,  # default security
+            win32con.OPEN_EXISTING,
+            0,  # win32con.FILE_FLAG_OVERLAPPED,
+            None,
+        )
+
+        # set to message mode.
+        win32pipe.SetNamedPipeHandleState(
+            hpipe, win32pipe.PIPE_READMODE_MESSAGE, None, None
+        )
+
+        hr, got = win32pipe.TransactNamedPipe(hpipe, str2bytes("foo\0bar"), 1024, None)
+        self.assertEqual(got, str2bytes("bar\0foo"))
+        event.wait(5)
+        self.assertTrue(event.isSet(), "Pipe server thread didn't terminate")
+
+    def testTransactNamedPipeBlockingBuffer(self):
+        # Like testTransactNamedPipeBlocking, but a pre-allocated buffer is
+        # passed (not really that useful, but it exercises the code path)
+        event = threading.Event()
+        self.startPipeServer(event)
+        open_mode = win32con.GENERIC_READ | win32con.GENERIC_WRITE
+
+        hpipe = win32file.CreateFile(
+            self.pipename,
+            open_mode,
+            0,  # no sharing
+            None,  # default security
+            win32con.OPEN_EXISTING,
+            0,  # win32con.FILE_FLAG_OVERLAPPED,
+            None,
+        )
+
+        # set to message mode.
+        win32pipe.SetNamedPipeHandleState(
+            hpipe, win32pipe.PIPE_READMODE_MESSAGE, None, None
+        )
+
+        buffer = win32file.AllocateReadBuffer(1024)
+        hr, got = win32pipe.TransactNamedPipe(
+            hpipe, str2bytes("foo\0bar"), buffer, None
+        )
+        self.assertEqual(got, str2bytes("bar\0foo"))
+        event.wait(5)
+        self.assertTrue(event.isSet(), "Pipe server thread didn't terminate")
+
+    def testTransactNamedPipeAsync(self):
+        event = threading.Event()
+        overlapped = pywintypes.OVERLAPPED()
+        overlapped.hEvent = win32event.CreateEvent(None, 0, 0, None)
+        self.startPipeServer(event, 0.5)
+        open_mode = win32con.GENERIC_READ | win32con.GENERIC_WRITE
+
+        hpipe = win32file.CreateFile(
+            self.pipename,
+            open_mode,
+            0,  # no sharing
+            None,  # default security
+            win32con.OPEN_EXISTING,
+            win32con.FILE_FLAG_OVERLAPPED,
+            None,
+        )
+
+        # set to message mode.
+        win32pipe.SetNamedPipeHandleState(
+            hpipe, win32pipe.PIPE_READMODE_MESSAGE, None, None
+        )
+
+        buffer = win32file.AllocateReadBuffer(1024)
+        hr, got = win32pipe.TransactNamedPipe(
+            hpipe, str2bytes("foo\0bar"), buffer, overlapped
+        )
+        self.assertEqual(hr, winerror.ERROR_IO_PENDING)
+        nbytes = win32file.GetOverlappedResult(hpipe, overlapped, True)
+        got = buffer[:nbytes]
+        self.assertEqual(got, str2bytes("bar\0foo"))
+        event.wait(5)
+        self.assertTrue(event.isSet(), "Pipe server thread didn't terminate")
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/lib/win32/test/test_win32print.py b/lib/win32/test/test_win32print.py
new file mode 100644
index 00000000..71fd2c03
--- /dev/null
+++ b/lib/win32/test/test_win32print.py
@@ -0,0 +1,24 @@
+# Tests (scarce) for win32print module
+
+import unittest
+
+import win32print as wprn
+
+
+class Win32PrintTestCase(unittest.TestCase):
+    def setUp(self):
+        self.printer_idx = 0
+        self.printer_levels_all = list(range(1, 10))
+        self.local_printers = wprn.EnumPrinters(wprn.PRINTER_ENUM_LOCAL, None, 1)
+
+    def test_printer_levels_read_dummy(self):
+        if not self.local_printers:
+            print("Test didn't run (no local printers)!")
+            return
+        ph = wprn.OpenPrinter(self.local_printers[self.printer_idx][2])
+        for level in self.printer_levels_all:
+            wprn.GetPrinter(ph, level)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/lib/win32/test/test_win32profile.py b/lib/win32/test/test_win32profile.py
new file mode 100644
index 00000000..84dc83bc
--- /dev/null
+++ b/lib/win32/test/test_win32profile.py
@@ -0,0 +1,18 @@
+"""Test win32profile"""
+import os
+import unittest
+
+import win32profile
+
+
+class Tester(unittest.TestCase):
+    def test_environment(self):
+        os.environ["FOO"] = "bar=baz"
+        env = win32profile.GetEnvironmentStrings()
+        assert "FOO" in env
+        assert env["FOO"] == "bar=baz"
+        assert os.environ["FOO"] == "bar=baz"
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/lib/win32/test/test_win32rcparser.py b/lib/win32/test/test_win32rcparser.py
new file mode 100644
index 00000000..6eae6884
--- /dev/null
+++ b/lib/win32/test/test_win32rcparser.py
@@ -0,0 +1,70 @@
+import os
+import tempfile
+import unittest
+
+import win32con
+import win32rcparser
+
+
+class TestParser(unittest.TestCase):
+    def setUp(self):
+        rc_file = os.path.join(os.path.dirname(__file__), "win32rcparser", "test.rc")
+        self.resources = win32rcparser.Parse(rc_file)
+
+    def testStrings(self):
+        for sid, expected in (
+            ("IDS_TEST_STRING4", "Test 'single quoted' string"),
+            ("IDS_TEST_STRING1", 'Test "quoted" string'),
+            ("IDS_TEST_STRING3", 'String with single " quote'),
+            ("IDS_TEST_STRING2", "Test string"),
+        ):
+            got = self.resources.stringTable[sid].value
+            self.assertEqual(got, expected)
+
+    def testStandardIds(self):
+        for idc in "IDOK IDCANCEL".split():
+            correct = getattr(win32con, idc)
+            self.assertEqual(self.resources.names[correct], idc)
+            self.assertEqual(self.resources.ids[idc], correct)
+
+    def testTabStop(self):
+        d = self.resources.dialogs["IDD_TEST_DIALOG2"]
+        tabstop_names = ["IDC_EDIT1", "IDOK"]  # should have WS_TABSTOP
+        tabstop_ids = [self.resources.ids[name] for name in tabstop_names]
+        notabstop_names = ["IDC_EDIT2"]  # should have WS_TABSTOP
+        notabstop_ids = [self.resources.ids[name] for name in notabstop_names]
+        num_ok = 0
+        for cdef in d[1:]:  # skip dlgdef
+            # print cdef
+            cid = cdef[2]
+            style = cdef[-2]
+            styleex = cdef[-1]
+            if cid in tabstop_ids:
+                self.assertEqual(style & win32con.WS_TABSTOP, win32con.WS_TABSTOP)
+                num_ok += 1
+            elif cid in notabstop_ids:
+                self.assertEqual(style & win32con.WS_TABSTOP, 0)
+                num_ok += 1
+        self.assertEqual(num_ok, len(tabstop_ids) + len(notabstop_ids))
+
+
+class TestGenerated(TestParser):
+    def setUp(self):
+        # don't call base!
+        rc_file = os.path.join(os.path.dirname(__file__), "win32rcparser", "test.rc")
+        py_file = tempfile.mktemp("test_win32rcparser.py")
+        try:
+            win32rcparser.GenerateFrozenResource(rc_file, py_file)
+            py_source = open(py_file).read()
+        finally:
+            if os.path.isfile(py_file):
+                os.unlink(py_file)
+
+        # poor-man's import :)
+        globs = {}
+        exec(py_source, globs, globs)
+        self.resources = globs["FakeParser"]()
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/lib/win32/test/test_win32timezone.py b/lib/win32/test/test_win32timezone.py
new file mode 100644
index 00000000..6dba51ed
--- /dev/null
+++ b/lib/win32/test/test_win32timezone.py
@@ -0,0 +1,27 @@
+# Test module for win32timezone
+
+import doctest
+import sys
+import unittest
+
+import win32timezone
+
+
+class Win32TimeZoneTest(unittest.TestCase):
+    def testWin32TZ(self):
+        # On 3.7 and later, the repr() for datetime objects changed to use kwargs - eg,
+        # eg, `datetime.timedelta(0, 10800)` is now `datetime.timedelta(seconds=10800)`.
+        # So we just skip the tests on 3.5 and 3.6
+        if sys.version_info < (3, 7):
+            from pywin32_testutil import TestSkipped
+
+            raise TestSkipped(
+                "The repr() for datetime objects makes this test fail in 3.5 and 3.6"
+            )
+
+        failed, total = doctest.testmod(win32timezone, verbose=False)
+        self.assertFalse(failed)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/lib/win32/test/test_win32trace.py b/lib/win32/test/test_win32trace.py
new file mode 100644
index 00000000..8b241cbb
--- /dev/null
+++ b/lib/win32/test/test_win32trace.py
@@ -0,0 +1,369 @@
+import os
+import sys
+import threading
+import time
+import unittest
+
+import win32trace
+from pywin32_testutil import TestSkipped
+
+if __name__ == "__main__":
+    this_file = sys.argv[0]
+else:
+    this_file = __file__
+
+
+def SkipIfCI():
+    # This test often fails in CI, probably when it is being run multiple times
+    # (ie, for different Python versions)
+    # Github actions always have a `CI` variable.
+    if "CI" in os.environ:
+        raise TestSkipped("We skip this test on CI")
+
+
+def CheckNoOtherReaders():
+    win32trace.write("Hi")
+    time.sleep(0.05)
+    if win32trace.read() != "Hi":
+        # Reset everything so following tests still fail with this error!
+        win32trace.TermRead()
+        win32trace.TermWrite()
+        raise RuntimeError(
+            "An existing win32trace reader appears to be "
+            "running - please stop this process and try again"
+        )
+
+
+class TestInitOps(unittest.TestCase):
+    def setUp(self):
+        SkipIfCI()
+        # clear old data
+        win32trace.InitRead()
+        win32trace.read()
+        win32trace.TermRead()
+
+    def tearDown(self):
+        try:
+            win32trace.TermRead()
+        except win32trace.error:
+            pass
+        try:
+            win32trace.TermWrite()
+        except win32trace.error:
+            pass
+
+    def testInitTermRead(self):
+        self.assertRaises(win32trace.error, win32trace.read)
+        win32trace.InitRead()
+        result = win32trace.read()
+        self.assertEqual(result, "")
+        win32trace.TermRead()
+        self.assertRaises(win32trace.error, win32trace.read)
+
+        win32trace.InitRead()
+        self.assertRaises(win32trace.error, win32trace.InitRead)
+        win32trace.InitWrite()
+        self.assertRaises(win32trace.error, win32trace.InitWrite)
+        win32trace.TermWrite()
+        win32trace.TermRead()
+
+    def testInitTermWrite(self):
+        self.assertRaises(win32trace.error, win32trace.write, "Hei")
+        win32trace.InitWrite()
+        win32trace.write("Johan Galtung")
+        win32trace.TermWrite()
+        self.assertRaises(win32trace.error, win32trace.write, "Hei")
+
+    def testTermSematics(self):
+        win32trace.InitWrite()
+        win32trace.write("Ta da")
+
+        # if we both Write and Read are terminated at the same time,
+        # we lose the data as the win32 object is closed.  Note that
+        # if another writer is running, we do *not* lose the data - so
+        # test for either the correct data or an empty string
+        win32trace.TermWrite()
+        win32trace.InitRead()
+        self.assertTrue(win32trace.read() in ("Ta da", ""))
+        win32trace.TermRead()
+
+        # we keep the data because we init read before terminating write
+        win32trace.InitWrite()
+        win32trace.write("Ta da")
+        win32trace.InitRead()
+        win32trace.TermWrite()
+        self.assertEqual("Ta da", win32trace.read())
+        win32trace.TermRead()
+
+
+class BasicSetupTearDown(unittest.TestCase):
+    def setUp(self):
+        SkipIfCI()
+        win32trace.InitRead()
+        # If any other writers are running (even if not actively writing),
+        # terminating the module will *not* close the handle, meaning old data
+        # will remain. This can cause other tests to fail.
+        win32trace.read()
+        win32trace.InitWrite()
+
+    def tearDown(self):
+        win32trace.TermWrite()
+        win32trace.TermRead()
+
+
+class TestModuleOps(BasicSetupTearDown):
+    def testRoundTrip(self):
+        win32trace.write("Syver Enstad")
+        syverEnstad = win32trace.read()
+        self.assertEqual("Syver Enstad", syverEnstad)
+
+    def testRoundTripUnicode(self):
+        win32trace.write("\xa9opyright Syver Enstad")
+        syverEnstad = win32trace.read()
+        # str objects are always returned in py2k (latin-1 encoding was used
+        # on unicode objects)
+        self.assertEqual("\xa9opyright Syver Enstad", syverEnstad)
+
+    def testBlockingRead(self):
+        win32trace.write("Syver Enstad")
+        self.assertEqual("Syver Enstad", win32trace.blockingread())
+
+    def testBlockingReadUnicode(self):
+        win32trace.write("\xa9opyright Syver Enstad")
+        # str objects are always returned in py2k (latin-1 encoding was used
+        # on unicode objects)
+        self.assertEqual("\xa9opyright Syver Enstad", win32trace.blockingread())
+
+    def testFlush(self):
+        win32trace.flush()
+
+
+class TestTraceObjectOps(BasicSetupTearDown):
+    def testInit(self):
+        win32trace.TermRead()
+        win32trace.TermWrite()
+        traceObject = win32trace.GetTracer()
+        self.assertRaises(win32trace.error, traceObject.read)
+        self.assertRaises(win32trace.error, traceObject.write, "")
+        win32trace.InitRead()
+        win32trace.InitWrite()
+        self.assertEqual("", traceObject.read())
+        traceObject.write("Syver")
+
+    def testFlush(self):
+        traceObject = win32trace.GetTracer()
+        traceObject.flush()
+
+    def testIsatty(self):
+        tracer = win32trace.GetTracer()
+        assert tracer.isatty() == False
+
+    def testRoundTrip(self):
+        traceObject = win32trace.GetTracer()
+        traceObject.write("Syver Enstad")
+        self.assertEqual("Syver Enstad", traceObject.read())
+
+
+class WriterThread(threading.Thread):
+    def run(self):
+        self.writeCount = 0
+        for each in range(self.BucketCount):
+            win32trace.write(str(each))
+        self.writeCount = self.BucketCount
+
+    def verifyWritten(self):
+        return self.writeCount == self.BucketCount
+
+
+class TestMultipleThreadsWriting(unittest.TestCase):
+    # FullBucket is the thread count
+    FullBucket = 50
+    BucketCount = 9  # buckets must be a single digit number (ie. less than 10)
+
+    def setUp(self):
+        SkipIfCI()
+        WriterThread.BucketCount = self.BucketCount
+        win32trace.InitRead()
+        win32trace.read()  # clear any old data.
+        win32trace.InitWrite()
+        CheckNoOtherReaders()
+        self.threads = [WriterThread() for each in range(self.FullBucket)]
+        self.buckets = list(range(self.BucketCount))
+        for each in self.buckets:
+            self.buckets[each] = 0
+
+    def tearDown(self):
+        win32trace.TermRead()
+        win32trace.TermWrite()
+
+    def areBucketsFull(self):
+        bucketsAreFull = True
+        for each in self.buckets:
+            assert each <= self.FullBucket, each
+            if each != self.FullBucket:
+                bucketsAreFull = False
+                break
+        return bucketsAreFull
+
+    def read(self):
+        while 1:
+            readString = win32trace.blockingread()
+            for ch in readString:
+                integer = int(ch)
+                count = self.buckets[integer]
+                assert count != -1
+                self.buckets[integer] = count + 1
+                if self.buckets[integer] == self.FullBucket:
+                    if self.areBucketsFull():
+                        return
+
+    def testThreads(self):
+        for each in self.threads:
+            each.start()
+        self.read()
+        for each in self.threads:
+            each.join()
+        for each in self.threads:
+            assert each.verifyWritten()
+        assert self.areBucketsFull()
+
+
+class TestHugeChunks(unittest.TestCase):
+    # BiggestChunk is the size where we stop stressing the writer
+    BiggestChunk = 2**16  # 256k should do it.
+
+    def setUp(self):
+        SkipIfCI()
+        win32trace.InitRead()
+        win32trace.read()  # clear any old data
+        win32trace.InitWrite()
+
+    def testHugeChunks(self):
+        data = "*" * 1023 + "\n"
+        while len(data) <= self.BiggestChunk:
+            win32trace.write(data)
+            data = data + data
+        # If we made it here, we passed.
+
+    def tearDown(self):
+        win32trace.TermRead()
+        win32trace.TermWrite()
+
+
+import win32event
+import win32process
+
+
+class TraceWriteProcess:
+    def __init__(self, threadCount):
+        self.exitCode = -1
+        self.threadCount = threadCount
+
+    def start(self):
+        procHandle, threadHandle, procId, threadId = win32process.CreateProcess(
+            None,  # appName
+            'python.exe "%s" /run_test_process %s %s'
+            % (this_file, self.BucketCount, self.threadCount),
+            None,  # process security
+            None,  # thread security
+            0,  # inherit handles
+            win32process.NORMAL_PRIORITY_CLASS,
+            None,  # new environment
+            None,  # Current directory
+            win32process.STARTUPINFO(),  # startup info
+        )
+        self.processHandle = procHandle
+
+    def join(self):
+        win32event.WaitForSingleObject(self.processHandle, win32event.INFINITE)
+        self.exitCode = win32process.GetExitCodeProcess(self.processHandle)
+
+    def verifyWritten(self):
+        return self.exitCode == 0
+
+
+class TestOutofProcess(unittest.TestCase):
+    BucketCount = 9
+    FullBucket = 50
+
+    def setUp(self):
+        SkipIfCI()
+        win32trace.InitRead()
+        TraceWriteProcess.BucketCount = self.BucketCount
+        self.setUpWriters()
+        self.buckets = list(range(self.BucketCount))
+        for each in self.buckets:
+            self.buckets[each] = 0
+
+    def tearDown(self):
+        win32trace.TermRead()
+
+    def setUpWriters(self):
+        self.processes = []
+        # 5 processes, quot threads in each process
+        quot, remainder = divmod(self.FullBucket, 5)
+        for each in range(5):
+            self.processes.append(TraceWriteProcess(quot))
+        if remainder:
+            self.processes.append(TraceWriteProcess(remainder))
+
+    def areBucketsFull(self):
+        bucketsAreFull = True
+        for each in self.buckets:
+            assert each <= self.FullBucket, each
+            if each != self.FullBucket:
+                bucketsAreFull = False
+                break
+        return bucketsAreFull
+
+    def read(self):
+        while 1:
+            readString = win32trace.blockingread()
+            for ch in readString:
+                integer = int(ch)
+                count = self.buckets[integer]
+                assert count != -1
+                self.buckets[integer] = count + 1
+                if self.buckets[integer] == self.FullBucket:
+                    if self.areBucketsFull():
+                        return
+
+    def testProcesses(self):
+        for each in self.processes:
+            each.start()
+        self.read()
+        for each in self.processes:
+            each.join()
+        for each in self.processes:
+            assert each.verifyWritten()
+        assert self.areBucketsFull()
+
+
+def _RunAsTestProcess():
+    # Run as an external process by the main tests.
+    WriterThread.BucketCount = int(sys.argv[2])
+    threadCount = int(sys.argv[3])
+    threads = [WriterThread() for each in range(threadCount)]
+    win32trace.InitWrite()
+    for t in threads:
+        t.start()
+    for t in threads:
+        t.join()
+    for t in threads:
+        if not t.verifyWritten():
+            sys.exit(-1)
+
+
+if __name__ == "__main__":
+    if sys.argv[1:2] == ["/run_test_process"]:
+        _RunAsTestProcess()
+        sys.exit(0)
+    # If some other win32traceutil reader is running, these tests fail
+    # badly (as the other reader sometimes sees the output!)
+    win32trace.InitRead()
+    win32trace.InitWrite()
+    CheckNoOtherReaders()
+    # reset state so test env is back to normal
+    win32trace.TermRead()
+    win32trace.TermWrite()
+    unittest.main()
diff --git a/lib/win32/test/test_win32wnet.py b/lib/win32/test/test_win32wnet.py
new file mode 100644
index 00000000..04ad8a4d
--- /dev/null
+++ b/lib/win32/test/test_win32wnet.py
@@ -0,0 +1,175 @@
+import unittest
+
+import netbios
+import win32api
+import win32wnet
+from pywin32_testutil import str2bytes
+
+RESOURCE_CONNECTED = 0x00000001
+RESOURCE_GLOBALNET = 0x00000002
+RESOURCE_REMEMBERED = 0x00000003
+RESOURCE_RECENT = 0x00000004
+RESOURCE_CONTEXT = 0x00000005
+RESOURCETYPE_ANY = 0x00000000
+RESOURCETYPE_DISK = 0x00000001
+RESOURCETYPE_PRINT = 0x00000002
+RESOURCETYPE_RESERVED = 0x00000008
+RESOURCETYPE_UNKNOWN = 0xFFFFFFFF
+RESOURCEUSAGE_CONNECTABLE = 0x00000001
+RESOURCEUSAGE_CONTAINER = 0x00000002
+RESOURCEDISPLAYTYPE_GENERIC = 0x00000000
+RESOURCEDISPLAYTYPE_DOMAIN = 0x00000001
+RESOURCEDISPLAYTYPE_SERVER = 0x00000002
+RESOURCEDISPLAYTYPE_SHARE = 0x00000003
+
+
+NETRESOURCE_attributes = [
+    ("dwScope", int),
+    ("dwType", int),
+    ("dwDisplayType", int),
+    ("dwUsage", int),
+    ("lpLocalName", str),
+    ("lpRemoteName", str),
+    ("lpComment", str),
+    ("lpProvider", str),
+]
+
+NCB_attributes = [
+    ("Command", int),
+    ("Retcode", int),
+    ("Lsn", int),
+    ("Num", int),
+    #    ("Bufflen", int), - read-only
+    ("Callname", str),
+    ("Name", str),
+    ("Rto", int),
+    ("Sto", int),
+    ("Lana_num", int),
+    ("Cmd_cplt", int),
+    ("Event", int),
+    ("Post", int),
+]
+
+
+class TestCase(unittest.TestCase):
+    def testGetUser(self):
+        self.assertEqual(win32api.GetUserName(), win32wnet.WNetGetUser())
+
+    def _checkItemAttributes(self, item, attrs):
+        for attr, typ in attrs:
+            val = getattr(item, attr)
+            if typ is int:
+                self.assertTrue(
+                    type(val) in (int,), "Attr %r has value %r" % (attr, val)
+                )
+                new_val = val + 1
+            elif typ is str:
+                if val is not None:
+                    # on py2k, must be string or unicode.  py3k must be string or bytes.
+                    self.assertTrue(
+                        type(val) in (str, str), "Attr %r has value %r" % (attr, val)
+                    )
+                    new_val = val + " new value"
+                else:
+                    new_val = "new value"
+            else:
+                self.fail("Don't know what %s is" % (typ,))
+            # set the attribute just to make sure we can.
+            setattr(item, attr, new_val)
+
+    def testNETRESOURCE(self):
+        nr = win32wnet.NETRESOURCE()
+        self._checkItemAttributes(nr, NETRESOURCE_attributes)
+
+    def testWNetEnumResource(self):
+        handle = win32wnet.WNetOpenEnum(RESOURCE_GLOBALNET, RESOURCETYPE_ANY, 0, None)
+        try:
+            while 1:
+                items = win32wnet.WNetEnumResource(handle, 0)
+                if len(items) == 0:
+                    break
+                for item in items:
+                    self._checkItemAttributes(item, NETRESOURCE_attributes)
+        finally:
+            handle.Close()
+
+    def testNCB(self):
+        ncb = win32wnet.NCB()
+        self._checkItemAttributes(ncb, NCB_attributes)
+
+    def testNetbios(self):
+        # taken from the demo code in netbios.py
+        ncb = win32wnet.NCB()
+        ncb.Command = netbios.NCBENUM
+        la_enum = netbios.LANA_ENUM()
+        ncb.Buffer = la_enum
+        rc = win32wnet.Netbios(ncb)
+        self.assertEqual(rc, 0)
+        for i in range(la_enum.length):
+            ncb.Reset()
+            ncb.Command = netbios.NCBRESET
+            ncb.Lana_num = netbios.byte_to_int(la_enum.lana[i])
+            rc = Netbios(ncb)
+            self.assertEqual(rc, 0)
+            ncb.Reset()
+            ncb.Command = netbios.NCBASTAT
+            ncb.Lana_num = byte_to_int(la_enum.lana[i])
+            ncb.Callname = str2bytes("*               ")  # ensure bytes on py2x and 3k
+            adapter = netbios.ADAPTER_STATUS()
+            ncb.Buffer = adapter
+            Netbios(ncb)
+            # expect 6 bytes in the mac address.
+            self.assertTrue(len(adapter.adapter_address), 6)
+
+    def iterConnectableShares(self):
+        nr = win32wnet.NETRESOURCE()
+        nr.dwScope = RESOURCE_GLOBALNET
+        nr.dwUsage = RESOURCEUSAGE_CONTAINER
+        nr.lpRemoteName = "\\\\" + win32api.GetComputerName()
+
+        handle = win32wnet.WNetOpenEnum(RESOURCE_GLOBALNET, RESOURCETYPE_ANY, 0, nr)
+        while 1:
+            items = win32wnet.WNetEnumResource(handle, 0)
+            if len(items) == 0:
+                break
+            for item in items:
+                if item.dwDisplayType == RESOURCEDISPLAYTYPE_SHARE:
+                    yield item
+
+    def findUnusedDriveLetter(self):
+        existing = [
+            x[0].lower() for x in win32api.GetLogicalDriveStrings().split("\0") if x
+        ]
+        handle = win32wnet.WNetOpenEnum(RESOURCE_REMEMBERED, RESOURCETYPE_DISK, 0, None)
+        try:
+            while 1:
+                items = win32wnet.WNetEnumResource(handle, 0)
+                if len(items) == 0:
+                    break
+                xtra = [i.lpLocalName[0].lower() for i in items if i.lpLocalName]
+                existing.extend(xtra)
+        finally:
+            handle.Close()
+        for maybe in "defghijklmnopqrstuvwxyz":
+            if maybe not in existing:
+                return maybe
+        self.fail("All drive mappings are taken?")
+
+    def testAddConnection(self):
+        localName = self.findUnusedDriveLetter() + ":"
+        for share in self.iterConnectableShares():
+            share.lpLocalName = localName
+            win32wnet.WNetAddConnection2(share)
+            win32wnet.WNetCancelConnection2(localName, 0, 0)
+            break
+
+    def testAddConnectionOld(self):
+        localName = self.findUnusedDriveLetter() + ":"
+        for share in self.iterConnectableShares():
+            win32wnet.WNetAddConnection2(share.dwType, localName, share.lpRemoteName)
+            win32wnet.WNetCancelConnection2(localName, 0, 0)
+            break
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/lib/win32/test/testall.py b/lib/win32/test/testall.py
new file mode 100644
index 00000000..d3df2630
--- /dev/null
+++ b/lib/win32/test/testall.py
@@ -0,0 +1,230 @@
+import os
+import re
+import sys
+import traceback
+import unittest
+
+import pywin32_testutil
+
+# A list of demos that depend on user-interface of *any* kind.  Tests listed
+# here are not suitable for unattended testing.
+ui_demos = """GetSaveFileName print_desktop win32cred_demo win32gui_demo
+              win32gui_dialog win32gui_menu win32gui_taskbar
+              win32rcparser_demo winprocess win32console_demo
+              win32clipboard_bitmapdemo
+              win32gui_devicenotify
+              NetValidatePasswordPolicy""".split()
+# Other demos known as 'bad' (or at least highly unlikely to work)
+# cerapi: no CE module is built (CE via pywin32 appears dead)
+# desktopmanager: hangs (well, hangs for 60secs or so...)
+# EvtSubscribe_*: must be run together:
+# SystemParametersInfo: a couple of the params cause markh to hang, and there's
+# no great reason to adjust (twice!) all those system settings!
+bad_demos = """cerapi desktopmanager win32comport_demo
+               EvtSubscribe_pull EvtSubscribe_push
+               SystemParametersInfo
+            """.split()
+
+argvs = {
+    "rastest": ("-l",),
+}
+
+no_user_interaction = True
+
+# re to pull apart an exception line into the exception type and the args.
+re_exception = re.compile("([a-zA-Z0-9_.]*): (.*)$")
+
+
+def find_exception_in_output(data):
+    have_traceback = False
+    for line in data.splitlines():
+        line = line.decode("ascii")  # not sure what the correct encoding is...
+        if line.startswith("Traceback ("):
+            have_traceback = True
+            continue
+        if line.startswith(" "):
+            continue
+        if have_traceback:
+            # first line not starting with a space since the traceback.
+            # must be the exception!
+            m = re_exception.match(line)
+            if m:
+                exc_type, args = m.groups()
+                # get hacky - get the *real* exception object from the name.
+                bits = exc_type.split(".", 1)
+                if len(bits) > 1:
+                    mod = __import__(bits[0])
+                    exc = getattr(mod, bits[1])
+                else:
+                    # probably builtin
+                    exc = eval(bits[0])
+            else:
+                # hrm - probably just an exception with no args
+                try:
+                    exc = eval(line.strip())
+                    args = "()"
+                except:
+                    return None
+            # try and turn the args into real args.
+            try:
+                args = eval(args)
+            except:
+                pass
+            if not isinstance(args, tuple):
+                args = (args,)
+            # try and instantiate the exception.
+            try:
+                ret = exc(*args)
+            except:
+                ret = None
+            return ret
+        # apparently not - keep looking...
+        have_traceback = False
+
+
+class TestRunner:
+    def __init__(self, argv):
+        self.argv = argv
+        self.__name__ = "Test Runner for cmdline {}".format(argv)
+
+    def __call__(self):
+        import subprocess
+
+        p = subprocess.Popen(
+            self.argv, stdout=subprocess.PIPE, stderr=subprocess.STDOUT
+        )
+        output, _ = p.communicate()
+        rc = p.returncode
+
+        if rc:
+            base = os.path.basename(self.argv[1])
+            # See if we can detect and reconstruct an exception in the output.
+            reconstituted = find_exception_in_output(output)
+            if reconstituted is not None:
+                raise reconstituted
+            raise AssertionError(
+                "%s failed with exit code %s.  Output is:\n%s" % (base, rc, output)
+            )
+
+
+def get_demo_tests():
+    import win32api
+
+    ret = []
+    demo_dir = os.path.abspath(os.path.join(os.path.dirname(__file__), "..", "Demos"))
+    assert os.path.isdir(demo_dir), demo_dir
+    for name in os.listdir(demo_dir):
+        base, ext = os.path.splitext(name)
+        if base in ui_demos and no_user_interaction:
+            continue
+        # Skip any other files than .py and bad tests in any case
+        if ext != ".py" or base in bad_demos:
+            continue
+        argv = (sys.executable, os.path.join(demo_dir, base + ".py")) + argvs.get(
+            base, ()
+        )
+        ret.append(
+            unittest.FunctionTestCase(
+                TestRunner(argv), description="win32/demos/" + name
+            )
+        )
+    return ret
+
+
+def import_all():
+    # Some hacks for import order - dde depends on win32ui
+    try:
+        import win32ui
+    except ImportError:
+        pass  # 'what-ev-a....'
+
+    import win32api
+
+    dir = os.path.dirname(win32api.__file__)
+    num = 0
+    is_debug = os.path.basename(win32api.__file__).endswith("_d")
+    for name in os.listdir(dir):
+        base, ext = os.path.splitext(name)
+        # handle `modname.cp310-win_amd64.pyd` etc
+        base = base.split(".")[0]
+        if (
+            (ext == ".pyd")
+            and name != "_winxptheme.pyd"
+            and (
+                is_debug
+                and base.endswith("_d")
+                or not is_debug
+                and not base.endswith("_d")
+            )
+        ):
+            try:
+                __import__(base)
+            except:
+                print("FAILED to import", name)
+                raise
+            num += 1
+
+
+def suite():
+    # Loop over all .py files here, except me :)
+    try:
+        me = __file__
+    except NameError:
+        me = sys.argv[0]
+    me = os.path.abspath(me)
+    files = os.listdir(os.path.dirname(me))
+    suite = unittest.TestSuite()
+    suite.addTest(unittest.FunctionTestCase(import_all))
+    for file in files:
+        base, ext = os.path.splitext(file)
+        if ext == ".py" and os.path.basename(me) != file:
+            try:
+                mod = __import__(base)
+            except:
+                print("FAILED to import test module %r" % base)
+                traceback.print_exc()
+                continue
+            if hasattr(mod, "suite"):
+                test = mod.suite()
+            else:
+                test = unittest.defaultTestLoader.loadTestsFromModule(mod)
+            suite.addTest(test)
+    for test in get_demo_tests():
+        suite.addTest(test)
+    return suite
+
+
+class CustomLoader(pywin32_testutil.TestLoader):
+    def loadTestsFromModule(self, module):
+        return self.fixupTestsForLeakTests(suite())
+
+
+if __name__ == "__main__":
+    import argparse
+
+    parser = argparse.ArgumentParser(description="Test runner for PyWin32/win32")
+    parser.add_argument(
+        "-no-user-interaction",
+        default=False,
+        action="store_true",
+        help="(This is now the default - use `-user-interaction` to include them)",
+    )
+
+    parser.add_argument(
+        "-user-interaction",
+        action="store_true",
+        help="Include tests which require user interaction",
+    )
+
+    parsed_args, remains = parser.parse_known_args()
+
+    if parsed_args.no_user_interaction:
+        print(
+            "Note: -no-user-interaction is now the default, run with `-user-interaction` to include them."
+        )
+
+    no_user_interaction = not parsed_args.user_interaction
+
+    sys.argv = [sys.argv[0]] + remains
+
+    pywin32_testutil.testmain(testLoader=CustomLoader())
diff --git a/lib/win32/test/win32rcparser/python.bmp b/lib/win32/test/win32rcparser/python.bmp
new file mode 100644
index 0000000000000000000000000000000000000000..f674769727da6c39c007001d43f89e1b5ca88f89
GIT binary patch
literal 778
zcmaKqJ5B>J5QYa#6Q}SQ=qN3@b4ky2sP_mdXhIW9?tFz%>;X8;v{dGw8Sg_YgyZMu
ze>{)P>zj9^?H%(A#`72t^rZabQI|iai3pvh$rjAm(mc;t<)Uk+-ere@pCCCO8q2+0
zP*`sU<5o++Uin}ywN`v<3XO4VH6`>EIP{g_EG_!7u#^qSEbrnC*g}G{!-&I&2Lp(l
zqFa~~2N5w+U}Lw=DzvakY;QNbnB+wZS=i47evk=VZh2fK0f%sgP+~cKW<b9PH5R&3
zZh;|GV`HZa<svVtu`sT+lFx(~SB4t30^wfgp+ohuACARV60eO~*)xZdRM_wQica93
zv9gp=t1UND7*pKki?16=%eUz|-_Lhv9~V?}>-=^8c4qiL6WgN>*^DBuwjG&RY~t8_
JbPk9A+AsNib7BAh

literal 0
HcmV?d00001

diff --git a/lib/win32/test/win32rcparser/python.ico b/lib/win32/test/win32rcparser/python.ico
new file mode 100644
index 0000000000000000000000000000000000000000..f714eea446e4b6bd28f9e0f1c8f75f6c81fba9c6
GIT binary patch
literal 766
zcmaJ<J5Izf5Pe=FBD_dYA-YXTX~|tGI*vifH7s#~ZJ~<f&R19pAAmC;N=nKtq8;AE
z3Cf}slRSIgn~yzF0K=zkuc7v}0&ck95iM~~7@TnhB4ej5GRR1bb>m8xh$y8nAma-W
z^$0#H>2kty>X)hwIrlE-S<5+vz&A`n&h*v18|y+>sjix$aZle8p4@4^r5n6eZnc>@
zG>`3+P&u~b2-=|v7s{bGs2nePG0P+8gx8LOTO>dQCQJqF(DmA(7NnHmI`9r7=bX7`
z!W?&ubNbFr2j~zfBlk1694)bC>aTGXW{#1EPUo#Q3jUW;)Gsjwb=$3Xc0uvBe*c&M
z&1daA>)3`jT()1f=0DJg9L%!}boam$VF^QEz=~*YKd>1d<JBR4Hd4Hma%rTT6Dvs6
a-{}a3+)!s88u`YCeMR=>7=z`x4<bL`9-Qj{

literal 0
HcmV?d00001

diff --git a/lib/win32/test/win32rcparser/test.h b/lib/win32/test/win32rcparser/test.h
new file mode 100644
index 00000000..0d19cefe
--- /dev/null
+++ b/lib/win32/test/win32rcparser/test.h
@@ -0,0 +1,46 @@
+//{{NO_DEPENDENCIES}}
+// Microsoft Developer Studio generated include file.
+// Used by test.rc
+//
+#define IDS_TEST_STRING1 51
+#define IDS_TEST_STRING2 52
+#define IDS_TEST_STRING3 53
+#define IDS_TEST_STRING4 54
+#define IDS_TEST_STRING5 55
+#define IDS_TEST_STRING6 56
+#define IDS_TEST_STRING7 57
+#define IDD_TEST_DIALOG1 101
+#define IDD_TEST_DIALOG2 102
+#define IDB_PYTHON 103
+#define IDI_PYTHON 105
+#define IDD_TEST_DIALOG3 105
+#define IDC_EDIT1 1000
+#define IDC_CHECK1 1001
+#define IDC_EDIT2 1001
+#define IDC_COMBO1 1002
+#define IDC_SPIN1 1003
+#define IDC_PROGRESS1 1004
+#define IDC_SLIDER1 1005
+#define IDC_LIST1 1006
+#define IDC_TREE1 1007
+#define IDC_TAB1 1008
+#define IDC_ANIMATE1 1009
+#define IDC_RICHEDIT1 1010
+#define IDC_DATETIMEPICKER1 1011
+#define IDC_MONTHCALENDAR1 1012
+#define IDC_SCROLLBAR1 1013
+#define IDC_SCROLLBAR2 1014
+#define IDC_LIST2 1015
+#define IDC_HELLO 1016
+#define IDC_HELLO2 1017
+
+// Next default values for new objects
+//
+#ifdef APSTUDIO_INVOKED
+#ifndef APSTUDIO_READONLY_SYMBOLS
+#define _APS_NEXT_RESOURCE_VALUE 107
+#define _APS_NEXT_COMMAND_VALUE 40002
+#define _APS_NEXT_CONTROL_VALUE 1018
+#define _APS_NEXT_SYMED_VALUE 101
+#endif
+#endif
diff --git a/lib/win32/test/win32rcparser/test.rc b/lib/win32/test/win32rcparser/test.rc
new file mode 100644
index 00000000..9e4c7080
--- /dev/null
+++ b/lib/win32/test/win32rcparser/test.rc
@@ -0,0 +1,216 @@
+//Microsoft Developer Studio generated resource script.
+//
+#include "test.h"
+
+#define APSTUDIO_READONLY_SYMBOLS
+/////////////////////////////////////////////////////////////////////////////
+//
+// Generated from the TEXTINCLUDE 2 resource.
+//
+#include "afxres.h"
+
+/////////////////////////////////////////////////////////////////////////////
+#undef APSTUDIO_READONLY_SYMBOLS
+
+/////////////////////////////////////////////////////////////////////////////
+// English (Australia) resources
+
+#if !defined(AFX_RESOURCE_DLL) || defined(AFX_TARG_ENA)
+#ifdef _WIN32
+LANGUAGE LANG_ENGLISH, SUBLANG_ENGLISH_AUS
+#pragma code_page(1252)
+#endif //_WIN32
+
+#ifdef APSTUDIO_INVOKED
+/////////////////////////////////////////////////////////////////////////////
+//
+// TEXTINCLUDE
+//
+
+1 TEXTINCLUDE DISCARDABLE 
+BEGIN
+    "test.h\0"
+END
+
+2 TEXTINCLUDE DISCARDABLE 
+BEGIN
+    "#include ""afxres.h""\r\n"
+    "\0"
+END
+
+3 TEXTINCLUDE DISCARDABLE 
+BEGIN
+    "\r\n"
+    "\0"
+END
+
+#endif    // APSTUDIO_INVOKED
+
+
+/////////////////////////////////////////////////////////////////////////////
+//
+// Dialog
+//
+
+IDD_TEST_DIALOG1 DIALOG DISCARDABLE  0, 0, 186, 95
+STYLE DS_MODALFRAME | WS_POPUP | WS_CAPTION | WS_SYSMENU
+CAPTION "Test Dialog"
+FONT 8, "MS Sans Serif"
+BEGIN
+    DEFPUSHBUTTON   "OK",IDOK,129,7,50,14
+    PUSHBUTTON      "Cancel",IDCANCEL,129,24,50,14
+    ICON            IDI_PYTHON,IDC_STATIC,142,47,21,20
+    LTEXT           "An icon",IDC_STATIC,140,70,34,9
+END
+
+IDD_TEST_DIALOG2 DIALOG DISCARDABLE  0, 0, 186, 95
+STYLE DS_MODALFRAME | WS_POPUP | WS_CAPTION | WS_SYSMENU
+CAPTION "Test Dialog"
+FONT 8, "MS Sans Serif"
+BEGIN
+    DEFPUSHBUTTON   "OK",IDOK,129,7,50,14
+    PUSHBUTTON      "Cancel",IDCANCEL,129,24,50,14,NOT WS_TABSTOP
+    CONTROL         103,IDC_STATIC,"Static",SS_BITMAP,139,49,32,32
+    LTEXT           "A bitmap",IDC_STATIC,135,72,34,9
+    EDITTEXT        IDC_EDIT1,59,7,59,14,ES_AUTOHSCROLL
+    EDITTEXT        IDC_EDIT2,59,31,60,15,ES_AUTOHSCROLL | NOT WS_TABSTOP
+    LTEXT           "Tabstop",IDC_STATIC,7,9,43,10
+    LTEXT           "Not Tabstop",IDC_STATIC,7,33,43,10
+END
+
+IDD_TEST_DIALOG3 DIALOGEX 0, 0, 232, 310
+STYLE DS_MODALFRAME | WS_POPUP | WS_CAPTION | WS_SYSMENU
+CAPTION "Dialog"
+FONT 8, "MS Sans Serif", 0, 0, 0x1
+BEGIN
+    GROUPBOX        "Frame",IDC_STATIC,7,7,218,41
+    LTEXT           "Left Static",IDC_STATIC,16,17,73,11
+    EDITTEXT        IDC_EDIT1,103,15,112,12,ES_AUTOHSCROLL
+    LTEXT           "Right Static",IDC_STATIC,16,30,73,11,0,WS_EX_RIGHT
+    CONTROL         "",IDC_RICHEDIT1,"RICHEDIT",ES_AUTOHSCROLL | WS_BORDER | 
+                    WS_TABSTOP,103,31,113,14
+    CONTROL         "Check1",IDC_CHECK1,"Button",BS_AUTOCHECKBOX | 
+                    WS_TABSTOP,7,52,68,12
+    COMBOBOX        IDC_COMBO1,85,52,82,35,CBS_DROPDOWNLIST | CBS_SORT | 
+                    WS_VSCROLL | WS_TABSTOP
+    CONTROL         "Spin1",IDC_SPIN1,"msctls_updown32",UDS_ARROWKEYS,7,71,
+                    14,22
+    CONTROL         "Progress1",IDC_PROGRESS1,"msctls_progress32",WS_BORDER,
+                    39,72,153,13
+    SCROLLBAR       IDC_SCROLLBAR2,207,55,13,57,SBS_VERT
+    CONTROL         "Slider1",IDC_SLIDER1,"msctls_trackbar32",TBS_BOTH | 
+                    TBS_NOTICKS | WS_TABSTOP,35,91,159,7
+    SCROLLBAR       IDC_SCROLLBAR1,37,102,155,11
+    CONTROL         "Tab1",IDC_TAB1,"SysTabControl32",0x0,7,120,217,43
+    CONTROL         "Animate1",IDC_ANIMATE1,"SysAnimate32",WS_BORDER | 
+                    WS_TABSTOP,7,171,46,42
+    CONTROL         "List1",IDC_LIST1,"SysListView32",WS_BORDER | WS_TABSTOP,
+                    63,171,53,43
+    CONTROL         "Tree1",IDC_TREE1,"SysTreeView32",WS_BORDER | WS_TABSTOP,
+                    126,171,50,43
+    CONTROL         "MonthCalendar1",IDC_MONTHCALENDAR1,"SysMonthCal32",
+                    MCS_NOTODAY | WS_TABSTOP,7,219,140,84
+    CONTROL         "DateTimePicker1",IDC_DATETIMEPICKER1,"SysDateTimePick32",
+                    DTS_RIGHTALIGN | WS_TABSTOP,174,221,51,15
+    DEFPUSHBUTTON   "OK",IDOK,175,289,50,14
+    PUSHBUTTON      "Hello",IDC_HELLO,175,271,50,14
+    PUSHBUTTON      "Hello",IDC_HELLO2,175,240,50,26,BS_ICON
+    LISTBOX         IDC_LIST2,184,171,40,45,LBS_SORT | LBS_NOINTEGRALHEIGHT | 
+                    WS_VSCROLL | WS_TABSTOP
+END
+
+
+/////////////////////////////////////////////////////////////////////////////
+//
+// DESIGNINFO
+//
+
+#ifdef APSTUDIO_INVOKED
+GUIDELINES DESIGNINFO DISCARDABLE 
+BEGIN
+    IDD_TEST_DIALOG1, DIALOG
+    BEGIN
+        LEFTMARGIN, 7
+        RIGHTMARGIN, 179
+        TOPMARGIN, 7
+        BOTTOMMARGIN, 88
+    END
+
+    IDD_TEST_DIALOG2, DIALOG
+    BEGIN
+        LEFTMARGIN, 7
+        RIGHTMARGIN, 179
+        TOPMARGIN, 7
+        BOTTOMMARGIN, 88
+    END
+
+    IDD_TEST_DIALOG3, DIALOG
+    BEGIN
+        LEFTMARGIN, 7
+        RIGHTMARGIN, 225
+        TOPMARGIN, 7
+        BOTTOMMARGIN, 303
+    END
+END
+#endif    // APSTUDIO_INVOKED
+
+
+/////////////////////////////////////////////////////////////////////////////
+//
+// Icon
+//
+
+// Icon with lowest ID value placed first to ensure application icon
+// remains consistent on all systems.
+IDI_PYTHON              ICON    DISCARDABLE     "python.ico"
+
+/////////////////////////////////////////////////////////////////////////////
+//
+// Bitmap
+//
+
+IDB_PYTHON              BITMAP  DISCARDABLE     "python.bmp"
+
+/////////////////////////////////////////////////////////////////////////////
+//
+// Dialog Info
+//
+
+IDD_TEST_DIALOG3 DLGINIT
+BEGIN
+    IDC_COMBO1, 0x403, 6, 0
+0x7449, 0x6d65, 0x0031, 
+    IDC_COMBO1, 0x403, 6, 0
+0x7449, 0x6d65, 0x0032, 
+    0
+END
+
+
+/////////////////////////////////////////////////////////////////////////////
+//
+// String Table
+//
+
+STRINGTABLE DISCARDABLE 
+BEGIN
+    IDS_TEST_STRING1        "Test ""quoted"" string"
+    IDS_TEST_STRING2        "Test string"
+    IDS_TEST_STRING3        "String with single "" quote"
+    IDS_TEST_STRING4        "Test 'single quoted' string"
+END
+
+#endif    // English (Australia) resources
+/////////////////////////////////////////////////////////////////////////////
+
+
+
+#ifndef APSTUDIO_INVOKED
+/////////////////////////////////////////////////////////////////////////////
+//
+// Generated from the TEXTINCLUDE 3 resource.
+//
+
+
+/////////////////////////////////////////////////////////////////////////////
+#endif    // not APSTUDIO_INVOKED
+
diff --git a/lib/win32com/HTML/GeneratedSupport.html b/lib/win32com/HTML/GeneratedSupport.html
new file mode 100644
index 00000000..b6fa50f7
--- /dev/null
+++ b/lib/win32com/HTML/GeneratedSupport.html
@@ -0,0 +1,104 @@
+<HTML>
+<HEAD>
+<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=windows-1252">
+<META NAME="Generator" CONTENT="Microsoft Word 97">
+<TITLE>Generated Python COM Support</TITLE>
+<META NAME="Version" CONTENT="8.0.3410">
+<META NAME="Date" CONTENT="10/11/96">
+<META NAME="Template" CONTENT="D:\Program Files\Microsoft Office\Office\html.dot">
+</HEAD>
+<BODY TEXT="#000000" LINK="#0000ff" VLINK="#800080" BGCOLOR="#ffffff">
+
+<P><IMG SRC="image/pycom_blowing.gif" WIDTH=549 HEIGHT=99 ALT="Python and COM - Blowing the others away"></P>
+<H1>Generated Python COM Support</H1>
+<P>This file describes how the Python COM extensions support "generated files". The information contained here is for expert Python users, and people who need to take advantage of the advanced features of the support. More general information is available in the <A HREF="QuickStartClientCom.html">Quick Start to Client Side COM</A> documentation.</P>
+<H2>Introduction</H2>
+<P>Generated Python COM support means that a .py file exists behind a particular COM object. This .py file is created by a generation process from a COM type library.</P>
+<P>This documentation talks about the process of the creation of the .py files.</P>
+<H2>Design Goals</H2>
+<P>The main design goal is that the Python programmer need not know much about the type library they wish to work with. They need not know the name of a specific Python module to use a type library. COM uses an IID, version and LCID to identify a type library. Therefore, the Python programmer only need know this information to obtain a Python module.</P>
+<H2>How to generate support files</H2>
+<P>Support files can be generated either "off-line" by the makepy utility, or in custom Python code.</P>
+<P>Using makepy is in many ways far simpler - you simply pick the type library and you are ready to go! The <A HREF="QuickStartClientCom.html">Quick Start to Client Side COM</A> documentation describes this process.</P>
+<P>Often however, you will want to use code to ensure the type library has been processed. This document describes that process.</P>
+<H2>Usage</H2>
+<P>The win32com.client.gencache module implements all functionality. As described above, if you wish to generate support from code, you need to know the IID, version and LCID of the type library.</P>
+<P>The following functions are defined. The best examples of their usage is probably in the Pythonwin OCX Demos, and the COM Test Suite (particularly testMSOffice.py)</P>
+<P>Note that the gencache.py file supports being run from the command line, and provides some utilities for managing the cache. Run the file to see usage options.</P>
+<H2>Using makepy to help with the runtime generation</H2>
+<P>makepy supports a "-i" option, to print information about a type library.  When you select a type library, makepy will print out 2 lines of code that you cant paste into your application.  This will then allow your module to generate the makepy .py file at runtime, but will only take you a few seconds!</P>
+<H2>win32com.client.gencache functions</H2>
+<H3>def MakeModuleForTypelib(typelibCLSID, lcid, major, minor, progressInstance = None):</H3>
+<P>Generate support for a type library.</P>
+<P>Given the IID, LCID and version information for a type library, generate and import the necessary support files.</P>
+<B><P>Returns</P>
+</B><P>The Python module. No exceptions are caught.</P>
+<B><P>Params</P>
+</B><I><P>typelibCLSID</I><BR>
+IID of the type library.</P>
+<I><P>major</I><BR>
+Integer major version.</P>
+<I><P>minor</I><BR>
+Integer minor version.</P>
+<I><P>lcid</I><BR>
+Integer LCID for the library.</P>
+<I><P>progressInstance</I><BR>
+A class instance to use as the progress indicator, or None to use the default GUI one.&nbsp;</P>
+<H3>def EnsureModule(typelibCLSID, lcid, major, minor, progressInstance = None):</H3>
+<P>Ensure Python support is loaded for a type library, generating if necessary.</P>
+<P>Given the IID, LCID and version information for a type library, check and if necessary generate, then import the necessary support files.</P>
+<P>Returns:</P>
+<P>The Python module. No exceptions are caught during the generate process.</P>
+<B><P>Params</P>
+</B><I><P>typelibCLSID</I><BR>
+IID of the type library.</P>
+<I><P>major</I><BR>
+Integer major version.</P>
+<I><P>minor</I><BR>
+Integer minor version.</P>
+<I><P>lcid</I><BR>
+Integer LCID for the library.</P>
+<I><P>progressInstance</I><BR>
+A class instance to use as the progress indicator, or None to use the default GUI one.&nbsp;</P>
+<P>&nbsp;</P>
+<H3>def GetClassForProgID(<I>progid</I>):</H3>
+<P>Get a Python class for a Program ID</P>
+<P>Given a Program ID, return a Python class which wraps the COM object</P>
+<B><P>Returns</P>
+</B><P>The Python class, or None if no module is available.</P>
+<B><P>Params</P>
+</B><I><P>progid<BR>
+</I>A COM ProgramID or IID (eg, "Word.Application")</P>
+<P>&nbsp;</P>
+<H3>def GetModuleForProgID(progid):</H3>
+<P>Get a Python module for a Program ID</P>
+<P>Given a Program ID, return a Python module which contains the class which wraps the COM object.</P>
+<B><P>Returns</P>
+</B><P>The Python module, or None if no module is available.</P>
+<B><P>Params:</P>
+</B><I><P>progid <BR>
+</I>A COM ProgramID or IID (eg, "Word.Application")</P>
+<P>&nbsp;</P>
+<H3>def GetModuleForCLSID(clsid):</H3>
+<P>Get a Python module for a CLSID</P>
+<P>Given a CLSID, return a Python module which contains the class which wraps the COM object.</P>
+<B><P>Returns</P>
+</B><P>The Python module, or None if no module is available.</P>
+<B><P>Params</P>
+</B><I><P>progid<BR>
+</I>A COM CLSID (ie, not the description)</P>
+<P>&nbsp;</P>
+<H3>def GetModuleForTypelib(typelibCLSID, lcid, major, minor):</H3>
+<P>Get a Python module for a type library ID</P>
+<B><P>Returns</P>
+</B><P>An imported Python module, else None</P>
+<B><P>Params</B>:</P>
+<I><P>typelibCLSID</I><BR>
+IID of the type library.</P>
+<I><P>major</I><BR>
+Integer major version.</P>
+<I><P>minor</I><BR>
+Integer minor version</P>
+<I><P>lcid</I><BR>
+Integer LCID for the library.</P></BODY>
+</HTML>
diff --git a/lib/win32com/HTML/PythonCOM.html b/lib/win32com/HTML/PythonCOM.html
new file mode 100644
index 00000000..ed48a897
--- /dev/null
+++ b/lib/win32com/HTML/PythonCOM.html
@@ -0,0 +1,90 @@
+<HTML>
+<HEAD>
+<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=windows-1252">
+<META NAME="Generator" CONTENT="Microsoft Word 97">
+<TITLE>Untitled</TITLE>
+<META NAME="Template" CONTENT="D:\Program Files\Microsoft Office\Office\html.dot">
+</HEAD>
+<BODY LINK="#0000ff" VLINK="#800080">
+
+<H1><IMG SRC="image/pycom_blowing.gif" WIDTH=549 HEIGHT=99 ALT="Python and COM - Blowing the others away"></H1>
+<H1>Python and COM - Implementation Details </H1>
+<H2>Introduction </H2>
+<P>This document describes the technical implementation of the COM support in Python. It is primarily concerned with the underlying C++ interface to COM, although general Python issues are touched. </P>
+<P>This document is targeted at people who wish to maintain/enhance the standard COM support (typically by writing extension modules). For information on using Python and COM from a Python programmers perspective, please see the <A HREF="docindex.html">documentation index</A>. </P>
+<H2>General COM Support. </H2>
+<P>COM support in Python can be broken into 2 general areas - C++ support, and Python support. C++ support exists in the core PythonCOM module (plus any PythonCOM extension modules). Python support exists in the .py files that accompany the core module. </P>
+<H2>Naming Conventions </H2>
+<P>The naming conventions used by Python code will be: </P>
+
+<UL>
+<LI>The Python "New Import" (ni) module will be used, allowing packages, or nested modules. </LI>
+<LI>The package name will be "win32com". </LI>
+<LI>The core module name will be "pythoncom" (ie, "win32com.pythoncom") </LI></UL>
+
+<P>The rest of the naming conventions are yet to be worked out. </P>
+<H2>Core COM support. </H2>
+<P>This section is involved with the core C++ support in "pythoncom". </P>
+<P>The organisation of PythonCOM support falls into 3 discrete areas. </P>
+<H3>COM Client Support </H3>
+<P>This is the ability to manipulate other COM objects via their exposed interface. This includes use of IDispatch (eg using Python to start Microsoft Word, open a file, and print it.) but also all client side IUnknown derived objects fall into this category, including ITypeLib and IConnectionPoint support. </P>
+<H3>COM Server Support </H3>
+<P>This is ability for Python to create COM Servers, which can be manipulated by another COM client. This includes server side IDispatch (eg, Visual Basic starting a Python interpreter, and asking it to evaluate some code) but also all supported server side IUnknown derived classes. </P>
+<H3>Python/COM type and value conversion </H3>
+<P>This is internal code used by the above areas to managed the conversion to and from Python/COM types and values. This includes code to convert an arbitrary Python object into a COM variant, manages return types, and a few other helpers. </P>
+<H2>COM Structures and Python Types </H2>
+<P>OLE supports many C level structures for the COM API, which must be mapped to Python. </P>
+<H3>VARIANT </H3>
+<P>Variants are never exposed as such to Python programs. The internal framework always converts all variants to and from Python types. In some cases, type descriptions may be used, which force specific mappings, although in general the automatic conversion works fine. </P>
+<H3>TYPEDESC </H3>
+<P>A tuple, containing the elements of the C union. This union will be correctly decoded by the support code. </P>
+<H3>ELEMDESC </H3>
+<P>A tuple of TYPEDESC and PARAMDESC objects. </P>
+<H3>FUNCDESC </H3>
+<P>A funcdesc is a large and unwieldy tuple. Documentation to be supplied. </P>
+<H3>IID/CLSID </H3>
+<P>A native IID in Python is a special type, defined in pythoncom. Whenever a CLSID/IID is required, typically either an object, a tuple of type "iii(iiiiiiii)" or string can be used. </P>
+<P>Helper functions are available to convert to and from IID/CLSID and strings. </P>
+<H2>COM Framework </H2>
+<P>Both client and server side support have a specific framework in place to assist in supporting the widest possible set of interfaces. The framework allows external extension DLLs to be written, which extend the interfaces available to the Python user. </P>
+<P>This allows the core PythonCOM module to support a wide set of common interfaces, and other extensions to support anything obscure. </P>
+<H3>Client Framework </H3>
+<H4>QueryInterface and Types </H4>
+<P>When the only support required by Python is IDispatch, everything is simple - every object returned from QueryInterface is a PyIDispatch object. But this does not extend to other types, such as ITypeLib, IConnectionPoint etc., which are required for full COM support. </P>
+<P>For example, consider the following C++ psuedo-code: </P>
+<CODE><P>IConnectionPoint *conPt;<BR>
+someIDispatch-&gt;QueryInterface(IID_IConnectionPoint, (void **)&amp;conPt);<BR>
+// Note the IID_ and type of the * could be anything!</CODE> </P>
+<P>This cast, and knowledge of a specific IID_* to type must be simulated in Python. </P>
+<P>Python/COM will therefore maintain a map of UID's to Python type objects. Whenever QueryInterface is called, Python will lookup this map, to determine if the object type is supported. If the object is supported, then an object of that type will be returned. If the object is not supported, then a PyIUnknown object will be returned. </P>
+<P>Note that PyIDispatch will be supported by the core engine. Therefore: </P>
+<CODE><P>&gt;&gt;&gt; disp=someobj.QueryInterface(win32com.IID_Dispatch) </P>
+</CODE><P>will return a PyIDispatch object, whereas </P>
+<CODE><P>&gt;&gt;&gt; unk=someobj.QueryInterface(SomeUnknownIID) # returns PyIUnknown<BR>
+&gt;&gt;&gt; disp=unk.QueryInterface(win32com.IID_Dispatch) <BR>
+&gt;&gt;&gt; unk.Release() # Clean up now, rather than waiting for unk death.</CODE> </P>
+<P>Is needed to convert to an IDispatch object. </P>
+<H4>Core Support </H4>
+<P>The core COM support module will support the IUnknown, IDispatch, ITypeInfo, ITypeLib and IConnectionPointContainer and IConnectionPoint interfaces. This implies the core COM module supports 6 different OLE client object types, mapped to the 6 IID_*'s representing the objects. (The IConnection* objects allow for Python to repsond to COM events) </P>
+<P>A psuedo-inheritance scheme is used. The Python types are all derived from the Python IUnknown type (PyIUnknown). Therefore all IUnknown methods are automatically available to all types, just as it should be. The PyIUnknown type manages all object reference counts and destruction. </P>
+<H4>Extensibility </H4>
+<P>To provide the above functionality, a Python map is provided, which maps from a GUID to a Python type object. </P>
+<P>The advantage of this scheme is an external extension modules can hook into the core support. For example, imagine the following code: </P>
+<CODE><P>&gt;&gt;&gt; import myextracom # external .pyd supporting some interface.<BR>
+# myextracom.pyd will do the equivilent of</CODE> </P>
+<CODE><P># pythoncom.mapSupportedTypes(myextracom.IID_Extra, myextracom.ExtraType) <BR>
+&gt;&gt;&gt; someobj.QueryInterface(myextracom.IID_Extra)</CODE> </P>
+<P>Would correctly return an object defined in the extension module. </P>
+<H3>Server Framework </H3>
+<H4>General Framework </H4>
+<P>A server framework has been put in place which provides the following features: </P>
+<P>All Interfaces provide VTBL support - this means that the Servers exposed by Python are callable from C++ and other compiled languages. </P>
+<P>Supports full "inproc" servers. This means that no external .EXE is needed making Python COM servers available in almost all cases. </P>
+<P>An extensible model which allows for extension modules to provide server support for interfaces defined in that module. A map is provided which maps from a GUID to a function pointer which creates the interface. </P>
+<H3>Python and Variant Types Conversion </H3>
+<P>In general, Python and COM are both "type-less". COM is type-less via the VARIANT object, which supports many types, and Python is type-less due to its object model. </P>
+<P>There are a number of areas where Python and OLE clash. </P>
+<H4>Parameters and conversions. </H4>
+<P>For simple calls, there are 2 helpers available which will convert to and from PyObjects and VARIANTS. The call to convert a Python object to a VARIANT is simple in that it returns a VARIANT of the most appropriate type for the Python object - ie, the type of the Python object determines the resulting VARIANT type. </P>
+<P>There are also more complex conversion routines available, wrapped in a C++ helper class. Typically, these helpers are used whenever a specific variant type is known (eg, when an ITypeInfo is available for the object being used). In this case, all efforts are made to convert the Python type to the requested variant type - ie, in this situation, the VARIANT type determines how the Python object is coerced. In addition, this code supports the use of "ByRef" and pointer paramaters, providing and freeing any buffers necessary for the call. </P></BODY>
+</HTML>
diff --git a/lib/win32com/HTML/QuickStartClientCom.html b/lib/win32com/HTML/QuickStartClientCom.html
new file mode 100644
index 00000000..f3a02742
--- /dev/null
+++ b/lib/win32com/HTML/QuickStartClientCom.html
@@ -0,0 +1,82 @@
+<HTML>
+<HEAD>
+<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=windows-1252">
+<META NAME="Generator" CONTENT="Microsoft Word 97">
+<TITLE>Quick Start to Client side COM and Python</TITLE>
+<META NAME="Template" CONTENT="D:\Program Files\Microsoft Office\Office\html.dot">
+</HEAD>
+<BODY LINK="#0000ff" VLINK="#800080">
+
+<H1>Quick Start to Client side COM and Python</H1>
+<H2>Introduction</H2>
+<P>This documents how to quickly start using COM from Python. It is not a thorough discussion of the COM system, or of the concepts introduced by COM.</P>
+<P>Other good information on COM can be found in various conference tutorials - please see <A HREF="http://starship.python.net/crew/mhammond/conferences">the collection of Mark's conference tutorials</A></P>
+<P>For information on implementing COM objects using Python, please see <A HREF="http://www.python.org/windows/win32com/QuickStartServerCom.html">a Quick Start to Server side COM and Python</A></P>
+<P>In this document we discuss the following topics:</P>
+
+<UL>
+<LI><A HREF="#Using">Using a COM object from Python</A> </LI>
+<LI><A HREF="#WhatObjects">How do I know which objects are available?</A> </LI>
+<LI><A HREF="#StaticDispatch">Static Dispatch/Type Safe objects (using the new improved makepy.py)</A></LI>
+<LI><A HREF="#UsingComConstants">Using COM Constants with makepy.</A></LI></UL>
+
+<H2>Quick Start</H2>
+<H3><A NAME="Using">To use a COM object from Python</A></H3>
+<CODE><P>import win32com.client<BR>
+o = win32com.client.Dispatch("Object.Name")<BR>
+o.Method()<BR>
+o.property = "New Value"<BR>
+print o.property</P>
+</CODE><P>Example</P>
+<CODE><P>o = win32com.client.Dispatch("Excel.Application")<BR>
+o.Visible = 1<BR>
+o.Workbooks.Add() # for office 97 � 95 a bit different!<BR>
+o.Cells(1,1).Value = "Hello"</CODE> </P>
+<P>And we will see the word "Hello" appear in the top cell. </P>
+<H3><A NAME="WhatObjects">How do I know which methods and properties are available?</A></H3>
+<P>Good question. This is hard! You need to use the documentation with the products, or possibly a COM browser. Note however that COM browsers typically rely on these objects registering themselves in certain ways, and many objects to not do this. You are just expected to know.</P>
+<H4>The Python COM browser</H4>
+<P>PythonCOM comes with a basic COM browser that may show you the information you need. Note that this package requires Pythonwin (ie, the MFC GUI environment) to be installed for this to work.</P>
+<P>There are far better COM browsers available - I tend to use the one that comes with MSVC, or this one!</P>
+<P>To run the browser, simply select it from the Pythonwin <I>Tools</I> menu, or double-click on the file <I>win32com\client\combrowse.py</I></P>
+<H2><A NAME="StaticDispatch">Static Dispatch (or Type Safe) objects</A></H2>
+<P>In the above examples, if we printed the '<CODE>repr(o)</CODE>' object above, it would have resulted in</P>
+<CODE><P>&lt;COMObject Excel.Application&gt;</P>
+</CODE><P>This reflects that the object is a generic COM object that Python has no special knowledge of (other than the name you used to create it!). This is known as a "dynamic dispatch" object, as all knowledge is built dynamically. The win32com package also has the concept of <I>static dispatch</I> objects, which gives Python up-front knowledge about the objects that it is working with (including arguments, argument types, etc)</P>
+<P>In a nutshell, Static Dispatch involves the generation of a .py file that contains support for the specific object. For more overview information, please see the documentation references above.</P>
+<P>The generation and management of the .py files is somewhat automatic, and involves one of 2 steps:</P>
+
+<UL>
+<LI>Using <I>makepy.py</I> to select a COM library. This process is very similar to Visual Basic, where you select from a list of all objects installed on your system, and once selected the objects are magically useable. </LI></UL>
+
+<P>or</P>
+
+<UL>
+<LI>Use explicit code to check for, and possibly generate, support at run-time. This is very powerful, as it allows the developer to avoid ensuring the user has selected the appropriate type library. This option is extremely powerful for OCX users, as it allows Python code to sub-class an OCX control, but the actual sub-class can be generated at run-time.  Use <I>makepy.py</I> with a </I>-i</I> option to see how to include this support in your Python code.</LI></UL>
+
+<P>The <I>win32com.client.gencache</I> module manages these generated files. This module has <A HREF="GeneratedSupport.html">some documentation of its own</A>, but you probably don't need to know the gory details!</P>
+<H3>How do I get at the generated module?</H3>
+<P>You will notice that the generated file name is long and cryptic - obviously not designed for humans to work with! So how do you get at the module object for the generated code?</P>
+<P>Hopefully, the answer is <I>you shouldn't need to</I>.  All generated file support is generally available directly via <I>win32com.client.Dispatch</I> and <I>win32com.client.constants</I>.  But should you ever really need the Python module object, the win32com.client.gencache module has functions specifically for this. The functions GetModuleForCLSID and GetModuleForProgID both return Python module objects that you can use in your code. See the docstrings in the gencache code for more details.</P>
+<H3>To generate Python Sources supporting a COM object</H3>
+<H4>Example using Microsoft Office 97.</H4>
+<P>Either:</P>
+
+<UL>
+<LI>Run '<CODE>win32com\client\makepy.py</CODE>' (eg, run it from the command window, or double-click on it) and a list will be presented. Select the Type Library '<CODE>Microsoft Word 8.0 Object Library</CODE>' </LI>
+<LI>From a command prompt, run the command '<CODE>makepy.py "Microsoft Word 8.0 Object Library"</CODE>' (include the double quotes). This simply avoids the selection process. </LI>
+<LI>If you desire, you can also use explicit code to generate it just before you need to use it at runtime.  Run <CODE>'makepy.py -i "Microsoft Word 8.0 Object Library"</CODE>' (include the double quotes) to see how to do this.</LI></UL>
+
+<P>And that is it! Nothing more needed. No special import statements needed! Now, you simply need say</P>
+<CODE><P>&gt;&gt;&gt; import win32com.client</P>
+<P>&gt;&gt;&gt; w=win32com.client.Dispatch("Word.Application")</P>
+<P>&gt;&gt;&gt; w.Visible=1</P>
+<P>&gt;&gt;&gt; w</P>
+<P>&lt;win32com.gen_py.Microsoft Word 8.0 Object Library._Application&gt;</P>
+</CODE><P>Note that now Python knows the explicit type of the object.</P>
+<H3><A NAME="UsingComConstants">Using COM Constants</A></H3>
+<P>Makepy automatically installs all generated constants from a type library in an object called <I>win32com.clients.constants</I>.  You do not need to do anything special to make these constants work, other than create the object itself (ie, in the example above, the constants relating to <I>Word</I> would automatically be available after the <CODE>w=win32com.client.Dispatch("Word.Application</CODE>") statement<CODE>.</P>
+</CODE><P>For example, immediately after executing the code above, you could execute the following:</P>
+<CODE><P>&gt;&gt;&gt; w.WindowState = win32com.client.constants.wdWindowStateMinimize</P>
+</CODE><P>and Word will Minimize.</P></BODY>
+</HTML>
diff --git a/lib/win32com/HTML/QuickStartServerCom.html b/lib/win32com/HTML/QuickStartServerCom.html
new file mode 100644
index 00000000..b956daaf
--- /dev/null
+++ b/lib/win32com/HTML/QuickStartServerCom.html
@@ -0,0 +1,195 @@
+<HTML>
+<HEAD>
+<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=windows-1252">
+<META NAME="Generator" CONTENT="Microsoft Word 97">
+<TITLE>Quick Start to Server Side COM and Python</TITLE>
+<META NAME="Version" CONTENT="8.0.3410">
+<META NAME="Date" CONTENT="10/11/96">
+<META NAME="Template" CONTENT="D:\Program Files\Microsoft Office\Office\html.dot">
+</HEAD>
+<BODY TEXT="#000000" LINK="#0000ff" VLINK="#800080" BGCOLOR="#ffffff">
+
+<H1>Quick Start to Server side COM and Python</H1>
+<H2>Introduction</H2>
+<P>This documents how to quickly start implementing COM objects in Python. It is not a thorough discussion of the COM system, or of the concepts introduced by COM.</P>
+<P>For more details information on Python and COM, please see the <A HREF="http://www.python.org/windows/win32com/COMTutorial/index.htm">COM Tutorial given by Greg Stein and Mark Hammond at SPAM 6 (HTML format)</A> or download the same tutorial <A HREF="http://www.python.org/windows/win32com/COMTutorial.ppt">in PowerPoint format.</A></P>
+<P>For information on using external COM objects from Python, please see <A HREF="QuickStartClientCom.html">a Quick Start to Client side COM and Python</A>.</P>
+<P>In this document we discuss the <A HREF="#core">core functionality</A>, <A HREF="#Registering">registering the server</A>, <A HREF="#testing">testing the class</A>, <A HREF="#debugging">debugging the class</A>, <A HREF="#Exception">exception handling</A> and <A HREF="#Policies">server policies</A> (phew!)</P>
+<H2><A NAME="core">Implement the core functionality</A></H2>
+<H3><A NAME="Using">Implement a stand-alone Python class with your functionality</A></H3>
+<CODE><P>class HelloWorld:</P><DIR>
+<DIR>
+
+<P>def __init__(self):</P><DIR>
+<DIR>
+
+<P>self.softspace = 1</P>
+<P>self.noCalls = 0</P></DIR>
+</DIR>
+
+<P>def Hello(self, who):</P><DIR>
+<DIR>
+
+<P>self.noCalls = self.noCalls + 1</P>
+<P># insert "softspace" number of spaces</P>
+<P>return "Hello" + " " * self.softspace + who</P></DIR>
+</DIR>
+</DIR>
+</DIR>
+
+</CODE><P>This is obviously a very simple server. In particular, custom error handling would be needed for a production class server. In addition, there are some contrived properties just for demonstration purposes.</P>
+<H3>Make Unicode concessions</H3>
+<P>At this stage, Python and Unicode don�t really work well together. All strings which come from COM will actually be Unicode objects rather than string objects.</P>
+<P>To make this code work in a COM environment, the last line of the "Hello" method must become:</P><DIR>
+<DIR>
+<DIR>
+<DIR>
+
+<CODE><P>return "Hello" + " " * self.softspace + str(who)</P></DIR>
+</DIR>
+</DIR>
+</DIR>
+
+</CODE><P>Note the conversion of the "who" to "str(who)". This forces the Unicode object into a native Python string object.</P>
+<P>For details on how to debug COM Servers to find this sort of error, please see <A HREF="#debugging">debugging the class</A></P>
+<H3>Annotate the class with win32com specific attributes</H3>
+<P>This is not a complete list of names, simply a list of properties used by this sample.</P>
+<TABLE CELLSPACING=0 BORDER=0 CELLPADDING=7 WIDTH=637>
+<TR><TD WIDTH="34%" VALIGN="TOP">
+<P><B>Property Name</B></TD>
+<TD WIDTH="66%" VALIGN="TOP">
+<B><P>Description</B></TD>
+</TR>
+<TR><TD WIDTH="34%" VALIGN="TOP">
+<P>_public_methods_</TD>
+<TD WIDTH="66%" VALIGN="TOP">
+<P>List of all method names exposed to remote COM clients</TD>
+</TR>
+<TR><TD WIDTH="34%" VALIGN="TOP">
+<P>_public_attrs_</TD>
+<TD WIDTH="66%" VALIGN="TOP">
+<P>List of all attribute names exposed to remote COM clients</TD>
+</TR>
+<TR><TD WIDTH="34%" VALIGN="TOP" HEIGHT=5>
+<P>_readonly_attrs_</TD>
+<TD WIDTH="66%" VALIGN="TOP" HEIGHT=5>
+<P>List of all attributes which can be accessed, but not set.</TD>
+</TR>
+</TABLE>
+
+<P>We change the class header to become:</P>
+<CODE><P>class HelloWorld:</P><DIR>
+<DIR>
+
+<P>_public_methods_ = ['Hello']</P>
+<P>_public_attrs_ = ['softspace', 'noCalls']</P>
+<P>_readonly_attrs_ = ['noCalls']</P>
+<P>def __init__(self):</P>
+<P>[Same from here�]</P></DIR>
+</DIR>
+
+</CODE><H3><A NAME="Registering">Registering and assigning a CLSID for the object</A></H3>
+<P>COM requires that all objects use a unique CLSID and be registered under a "user friendly" name. This documents the process.</P>
+<H4>Generating the CLSID</H4>
+<P>Microsoft Visual C++ comes with various tools for generating CLSID's, which are quite suitable. Alternatively, the pythoncom module exports the function CreateGuid() to generate these identifiers.</P>
+<CODE><P>&gt;&gt;&gt; import pythoncom<BR>
+&gt;&gt;&gt; print pythoncom.CreateGuid()<BR>
+{7CC9F362-486D-11D1-BB48-0000E838A65F}</P>
+</CODE><P>Obviously the GUID that you get will be different than that displayed here.</P>
+<H4>Preparing for registration of the Class</H4>
+<P>The win32com package allows yet more annotations to be applied to a class, allowing registration to be effected with 2 lines in your source file. The registration annotations used by this sample are:</P>
+<TABLE CELLSPACING=0 BORDER=0 CELLPADDING=7 WIDTH=636>
+<TR><TD WIDTH="34%" VALIGN="TOP">
+<P><B>Property Name</B></TD>
+<TD WIDTH="66%" VALIGN="TOP">
+<B><P>Description</B></TD>
+</TR>
+<TR><TD WIDTH="34%" VALIGN="TOP">
+<P>_reg_clsid_</TD>
+<TD WIDTH="66%" VALIGN="TOP">
+<P>The CLSID of the COM object</TD>
+</TR>
+<TR><TD WIDTH="34%" VALIGN="TOP">
+<P>_reg_progid_</TD>
+<TD WIDTH="66%" VALIGN="TOP">
+<P>The "program ID", or Name, of the COM Server. This is the name the user usually uses to instantiate the object</TD>
+</TR>
+<TR><TD WIDTH="34%" VALIGN="TOP" HEIGHT=5>
+<P>_reg_desc_</TD>
+<TD WIDTH="66%" VALIGN="TOP" HEIGHT=5>
+<P>Optional: The description of the COM Server. Used primarily for COM browsers.  If not specified, the _reg_progid_ is used as the description.</TD>
+</TR>
+<TR><TD WIDTH="34%" VALIGN="TOP" HEIGHT=5>
+<P>_reg_class_spec_</TD>
+<TD WIDTH="66%" VALIGN="TOP" HEIGHT=5>
+<P>Optional: A string which represents how Python can create the class instance. The string is of format<BR>
+[package.subpackage.]module.class</P>
+<P>The portion up to the class name must be valid for Python to "import", and the class portion must be a valid attribute in the specified class.</P>
+<P>This is optional from build 124 of Pythoncom., and has been removed from this sample.</TD>
+</TR>
+<TR><TD WIDTH="34%" VALIGN="TOP" HEIGHT=5>
+<P>_reg_remove_keys_</TD>
+<TD WIDTH="66%" VALIGN="TOP" HEIGHT=5>
+<P>Optional: A list of tuples of extra registry keys to be removed when uninstalling the server. Each tuple is of format ("key", root), where key is a string, and root is one of the win32con.HKEY_* constants (this item is optional, defaulting to HKEY_CLASSES_ROOT)</TD>
+</TR>
+</TABLE>
+
+<P>Note there are quite a few other keys available. Also note that these annotations are <I>not</I> required - they just make registration simple. Helper functions in the module <CODE>win32com.server.register</CODE> allow you to explicitly specify each of these attributes without attaching them to the class.</P>
+<P>The header of our class now becomes:</P>
+<CODE><P>class HelloWorld:</P><DIR>
+<DIR>
+
+<P>_reg_clsid_ = "{7CC9F362-486D-11D1-BB48-0000E838A65F}"</P>
+<P>_reg_desc_ = "Python Test COM Server"</P>
+<P>_reg_progid_ = "Python.TestServer"</P>
+<P>_public_methods_ = ['Hello']</P>
+<P>[same from here]</P></DIR>
+</DIR>
+
+</CODE><H4>Registering the Class</H4>
+<P>The idiom that most Python COM Servers use is that they register themselves when run as a script (ie, when executed from the command line.) Thus the standard "<CODE>if __name__=='__main___':</CODE>" technique works well.</P>
+<P>win32com.server.register contains a number of helper functions. The easiest to use is "<CODE>UseCommandLine</CODE>".</P>
+<P>Registration becomes as simple as:</P>
+<CODE><P>if __name__=='__main__':<BR>
+&#9;# ni only for 1.4!<BR>
+&#9;import ni, win32com.server.register <BR>
+&#9;win32com.server.register.UseCommandLine(HelloWorld)</P>
+</CODE><P>Running the script will register our test server.</P>
+<H2><A NAME="testing">Testing our Class</A></H2>
+<P>For the purposes of this demonstration, we will test the class using Visual Basic. This code should run under any version of Visual Basic, including VBA found in Microsoft Office. Any COM compliant package could be used alternatively. VB has been used just to prove there is no "smoke and mirrors. For information on how to test the server using Python, please see the <A HREF="QuickStartClientCom.html">Quick Start to Client side COM</A> documentation.</P>
+<P>This is not a tutorial in VB. The code is just presented! Run it, and it will work!</P>
+<H2><A NAME="debugging">Debugging the COM Server</A></H2>
+<P>When things go wrong in COM Servers, there is often nowhere useful for the Python traceback to go, even if such a traceback is generated.</P>
+<P>Rather than discuss how it works, I will just present the procedure to debug your server:</P>
+<B><P>To register a debug version of your class</B>, run the script (as above) but pass in a "<CODE>--debug</CODE>" parameter. Eg, for the server above, use the command line "<CODE>testcomserver.py --debug</CODE>".</P>
+<B><P>To see the debug output generated</B> (and any print statements you may choose to add!) you can simply select the "Remote Debug Trace Collector" from the Pythonwin Tools menu, or run the script "win32traceutil.py" from Windows Explorer or a Command Prompt.</P>
+<H2><A NAME="Exception">Exception Handling </A></H2>
+<P>Servers need to be able to provide exception information to their client. In some cases, it may be a simple return code (such as E_NOTIMPLEMENTED), but often it can contain much richer information, describing the error on detail, and even a help file and topic where more information can be found. </P>
+<P>We use Python class based exceptions to provide this information. The COM framework will examine the exception, and look for certain known attributes. These attributes will be copied across to the COM exception, and passed back to the client. </P>
+<P>The following attributes are supported, and correspond to the equivalent entry in the COM Exception structure:<BR>
+<CODE>scode, code, description, source, helpfile and helpcontext</P>
+</CODE><P>To make working with exceptions easier, there is a helper module "win32com.server.exception.py", which defines a single class. An example of its usage would be: </P>
+<CODE><P>raise COMException(desc="Must be a string",scode=winerror.E_INVALIDARG,helpfile="myhelp.hlp",...)</CODE> </P>
+<P>(Note the <CODE>COMException class supports (and translates) "desc" as a shortcut for "description", but the framework requires "description")</P>
+</CODE><H2><A NAME="Policies">Server Policies</A></H2>
+<P>This is information about how it all hangs together. The casual COM author need not know this. </P>
+<P>Whenever a Python Server needs to be created, the C++ framework first instantiates a "policy" object. This "policy" object is the gatekeeper for the COM Server - it is responsible for creating the underlying Python object that is the server (ie, your object), and also for translating the underlying COM requests for the object. </P>
+<P>This policy object handles all of the underlying COM functionality. For example, COM requires all methods and properties to have unique numeric ID's associated with them. The policy object manages the creation of these ID's for the underlying Python methods and attributes. Similarly, when the client whishes to call a method with ID 123, the policy object translates this back to the actual method, and makes the call. </P>
+<P>It should be noted that the operation of the "policy" object could be dictated by the Python object - the policy object has many defaults, but the actual Python class can always dictate its operation. </P>
+<H3>Default Policy attributes </H3>
+<P>The default policy object has a few special attributes that define who the object is exposed to COM. The example above shows the _public_methods attribute, but this section describes all such attributes in detail. </P>
+<H5>_public_methods_ </H5>
+<P>Required list of strings, containing the names of all methods to be exposed to COM. It is possible this will be enhanced in the future (eg, possibly '*' will be recognised to say all methods, or some other ideas�) </P>
+<H5>_public_attrs_ </H5>
+<P>Optional list of strings containing all attribute names to be exposed, both for reading and writing. The attribute names must be valid instance variables. </P>
+<H5>_readonly_attrs_ </H5>
+<P>Optional list of strings defining the name of attributes exposed read-only. </P>
+<H5>_com_interfaces_ </H5>
+<P>Optional list of IIDs exposed by this object. If this attribute is missing, IID_IDispatch is assumed (ie, if not supplied, the COM object will be created as a normal Automation object.</P>
+<P>and actual instance attributes: </P>
+<P>_dynamic_ : optional method </P>
+<P>_value_ : optional attribute </P>
+<P>_query_interface_ : optional method </P>
+<P>_NewEnum : optional method </P>
+<P>_Evaluate : optional method </P></BODY>
+</HTML>
diff --git a/lib/win32com/HTML/docindex.html b/lib/win32com/HTML/docindex.html
new file mode 100644
index 00000000..fff74de8
--- /dev/null
+++ b/lib/win32com/HTML/docindex.html
@@ -0,0 +1,22 @@
+<HTML>
+<HEAD>
+<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=windows-1252">
+<META NAME="Generator" CONTENT="Microsoft Word 97">
+<TITLE>win32com Documentation Index</TITLE>
+<META NAME="Template" CONTENT="D:\Program Files\Microsoft Office\Office\html.dot">
+</HEAD>
+<BODY LINK="#0000ff" VLINK="#800080">
+
+<H1><IMG SRC="image/pycom_blowing.gif" WIDTH=549 HEIGHT=99 ALT="Python and COM - Blowing the others away"></H1>
+<H1>PythonCOM Documentation Index</H1>
+<P>The following documentation is available</P>
+<P><A HREF="QuickStartClientCom.html">A Quick Start to Client Side COM</A> (including makepy)</P>
+<P><A HREF="QuickStartServerCom.html">A Quick Start to Server Side COM</A></P>
+<P><A HREF="GeneratedSupport.html">Information on generated Python files (ie, what makepy generates)</A></P>
+<P><A HREF="variant.html">An advanced VARIANT object which can give more control over parameter types</A></P>
+<P><A HREF="package.html">A brief description of the win32com package structure</A></P>
+<P><A HREF="PythonCOM.html">Python COM Implementation documentation</A></P>
+<P><A HREF="misc.html">Misc stuff I don�t know where to put anywhere else</A></P>
+<H3>ActiveX Scripting</H3>
+<P><A HREF="../../win32comext/axscript/demos/client/ie/demo.htm">ActiveX Scripting Demos</A></P></BODY>
+</HTML>
diff --git a/lib/win32com/HTML/image/BTN_HomePage.gif b/lib/win32com/HTML/image/BTN_HomePage.gif
new file mode 100644
index 0000000000000000000000000000000000000000..5767fa0f96e5de4af525ae1846df1bb633b8f5ab
GIT binary patch
literal 211
zcmZ?wbhEHb^kNWZSoELa|NsAI&YW>^abZ9Oia%Kx85sUE=zxSlY8{woaO}GC&)}3~
zGw<WHJ?+nLE$dzIwDi$ZHmBWjOdrmb<le84eO~i^`+)~p?uTYrElXJ`;j}RA;0kWF
z&ynjR!a_686xrRAn>gE1sdstEs|deknL!7$W%f0_p0=az{QKYk1EVXNBTHJ^lbSkO
zs-2sZvco3ySoP<pdF96DWY3ys<y73SJR^3N_T0Qx3kv(X?IyN%t>3a}>-GRn25SI#
C6I&7h

literal 0
HcmV?d00001

diff --git a/lib/win32com/HTML/image/BTN_ManualTop.gif b/lib/win32com/HTML/image/BTN_ManualTop.gif
new file mode 100644
index 0000000000000000000000000000000000000000..4200880a26eedc3e0c545ddef7a099fe71c9a8c6
GIT binary patch
literal 215
zcmZ?wbhEHb^kNWZSoELa|NsAI&YW>^abZ9Oia%Kx85sUE=zxSlY8{y8aO}GC&)}3~
zGcWV&o}WLai5J}xjZ1K!HT}URU54`|x%Vq{PgK7DFE+hloAFw&`8^({QBr~Prg(ZR
z^{YIv=3BVS#y<O%UVBnY{r#6^%ye0P{at2h#<6Md3*Xk9fB*Y`Lql0bOKN&+M`U|v
zkE6bEdr*o)LV{h%gt8p}0@aME^F3U`3?{}en(MW2`HD)$+S1;rX)(>4wlCebWA}Pa
G25SJ-f?Hq!

literal 0
HcmV?d00001

diff --git a/lib/win32com/HTML/image/BTN_NextPage.gif b/lib/win32com/HTML/image/BTN_NextPage.gif
new file mode 100644
index 0000000000000000000000000000000000000000..3d055fea0ecae9b27417820e2f8bdc1febf84b61
GIT binary patch
literal 218
zcmZ?wbhEHbbY~D|SoELa|NsAI&YW>^abZ9Oia%Kx85sUE=zxSlY8{y8bL_hF&*0R{
zroCk>Ys=ryW^apR<6F_0=yZD>(}r^;x%VsNj#Rz>Z!O(l7BsPM@x+&tKV6C0qFCT{
z)ic~T)weS%tbF}V(ZeF5`gbCyABpUaWt#EE`}@5|{yXZ<zyJNep`o~>r6jqv!>+xv
zCo!oxLf$G<HNK!fT2W@|?5P=f899scr;B&z%w3qiFhzAzlukfVPsj#?iWysWSuEeZ
JkBO7P8UP@bTay3)

literal 0
HcmV?d00001

diff --git a/lib/win32com/HTML/image/BTN_PrevPage.gif b/lib/win32com/HTML/image/BTN_PrevPage.gif
new file mode 100644
index 0000000000000000000000000000000000000000..955eae6c307d6559694540c8e288969f1ed0bd90
GIT binary patch
literal 216
zcmZ?wbhEHbbY~D|SoELa|NsAI&YW>^abZ9Oia%Kx85sUE=zxSlY8{y8a_qYE&*0R{
zrmafPPaprfK%8fhMcI7Uy4M*+jSL4$a_?8HJHA=>&4C3I!Y^NmTYipvX2`TC-B~#v
zYuT1x;_Ve#S~S!7jqBo8#pyAj!MSl$W9}BN&se*;?8%<G^Y4HEZzwKnE=_7_Pi&G&
z?dUCv?9t4Ln-tbo<({cGDL;Ld=G@8MU50MaX&Nh5&GA&QXzRA`b51bWuzAO}B|G;p
IaWYr~03X3y`2YX_

literal 0
HcmV?d00001

diff --git a/lib/win32com/HTML/image/blank.gif b/lib/win32com/HTML/image/blank.gif
new file mode 100644
index 0000000000000000000000000000000000000000..a58ecfec72dd68f9c3d9a9ecba35c05db442bc8d
GIT binary patch
literal 864
zcmZ?wbhEHbbY~D|`2L^az<~n{qhK@yMrsHs{$ybU`CSJ@fbxU`hb;pmhm6OD1qYis
zgtcN$Y*=`>T|n7uj>pDDN4q7Av+kVOxcGR#f^(OQ=cXkmCu;<+iaEJy>FMbP$*1O2
J8Y(bY0|3G!By<1(

literal 0
HcmV?d00001

diff --git a/lib/win32com/HTML/image/pycom_blowing.gif b/lib/win32com/HTML/image/pycom_blowing.gif
new file mode 100644
index 0000000000000000000000000000000000000000..0d65a2928962860cf8b675b5192a43b165f31350
GIT binary patch
literal 20926
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
Ab^rhX

literal 0
HcmV?d00001

diff --git a/lib/win32com/HTML/image/pythoncom.gif b/lib/win32com/HTML/image/pythoncom.gif
new file mode 100644
index 0000000000000000000000000000000000000000..6b5020a1d7de11d55f66cf6713bde897898e1f8e
GIT binary patch
literal 5767
zcmeH}*H=>ux5f8PA))Vt79c=K=%R)yDB=#Ggrc+np=p3nZAcSPF`<WYNa!GHKtxnj
zKu{3%gla@Rf(5alK@brepdPRt?)mPx_kXw#cfPF0xz-%xH|BD4ceS&RNC16+72tn_
z#bO}{A`l2963N8Ggi58_+1bG`%wRBle0*3e7MsnEi;GK4OiWKt=W@A)g@povptiPF
zBoei@wzjvo_w@9L#bSv>GB!3gIXNknO6TY27Z(@T{#*a+^Z)bz6ZpTCfc|$B2mmC&
z{6A~`hY1+F2GFrYM!Tp#2diQhCTVXREPyB;4UCSa;bMYSLT(Qa=9ZD@MZZkgwER+&
zjed|ln?71Y^-YsVMZE3D)GSHBZ7FhC*;-KnqAt&HK{NqQJZq5y3KS2!-t{5P<`l^~
zJI+fl@5U-=Z(xdGeW%9)wB69*)_w{DG}g;Z*RrI&=uZElR0*dTAh0SDxt1}}Mg~Gn
zHHP3*DbDE^Q2cAhxE&0HmTruRTzU3jTZ1AauSbOg%IRvQsme|d6kzsKe1;NjVP2n-
z-TS!`l1+cFKAN%k+XgWuMBrJ1`RQ!L9T$0cUM!%0ER%0eVzGNnkPGtbQr6Za@Z!{h
z_9LwiKASnnPIYl;Gc^lAN1HbuHHUwZ=C6^}NW19AKE{XuIg~3XgNh%6eeveAv_lTU
z;YwJW<-^P8Y?rDtu-GdRXi6lt9u^-k0+4b}wqPD;A`qY`ieqrGa6KgDB2yP5N|h91
zcrsc(qFsOzVHV8NSA;;cdPCv3jN8qFjjqbJvb;>pxQU-Yhea)qMaNT5fU3+zo=lV@
zY6fZG>KZAd_4Nsa2`=Kig4_8iFk8Wq$zvb{PscE~&?Iq`YFNe?iu^QMP(!j0<{ig;
zpPWVcEf3>S@<v1bWuSTDn^v+#JJBm6%bDA#nX#5AX0XYR7Ti7`&~(~I&X}Mzfp+e^
zi~3>~w-Wn%WgJ<%Z<dCd3IBWc99~f?40TVplI%WcGuxkPL6+}lK<1D7+w@IgS`6An
zT#oufH)S2j!&`r1D3e0RFobzlC7?lMf;~k}f(uTr2zT|q<v*BW)X=AB=^>Ef{3hB#
ztLvHDf^OS5#_OgUr&1$W{sE%K(V*YQaJy)Ze!X0kcT-<glZJ337l<o3$Abiz(am)o
zwATC~_&RbgT#ZsDlHe|H4FQ0{!)df3SvC9MhvT1Yxd?}ffX_}7XbjjbyH_v|l-;;H
z7Mb;+Er>>F&?F2dzrC>X^6<*q$CX#=;SifmNA6plE;PQl`nn`^wqHhDGPOEe8FT_)
zqQs!`Q1zZt0O|Dm*rnGRJ*mJ0xxGJq5xSxOtc=R!Ph5lbVC|nDe+CeRbuRs*g3hYQ
z-&=NHE|B)$AnA~LcNXppbtvM?LA?7HKi}Z^$}*>tFB83_VuS*-G_7ntf3}vb?r^dT
ztx(c+rWduz-qz`#1tV=|LLrCy2?L_{07sp+V}GdPk)ltey_)Vw@eGJjm73Vol~DR|
zTx`$Wrtuu{g?+a+cmDpIhLY~0jjA^&<6%&4byqJ$K5-}RGZ)|JeNIBY&R^VMpwt?H
zH9_MsJ)Y~Z-+_{~+yKXAxH-#!Kj90B05L4HpHdRcc)6l21^;bEq6AY!08l;~_3vrR
z7C*?{tSbZiZJT)wzyY96<^mP>@DT$s>DnY5Wuk?V0G0%npXTg@Jl&_99{^W1IXRy}
zWsp`*;NvWr2#Y#jQ7t6ZR4^iP#pyBvo_t9`nIN~&KrL^5LF*2?;T&eg$koAv>%B>Y
zF>i!|sX(u#xcXnhb!D5}Kx;p;UaJ^XkOIxY;|Eozfs(%%cDcC<W`moXce!R8h2=|;
zQcIZrve~i7!IS^`P_&b)>5aD+n%$=o3N_K<QD~2}Zo8$J>W(f)y-?)+5WZZe;l8HJ
zF)iKF^RN_rNw1bu_=wb~<sz=d+>B7N%F?HC|5i9B(AITDkj*9b!Y>9o`J|(S3IQ5L
zzg;<rH&|$jbF~BN%<-kpY9{ZTx&p^0z-aSwoRCjU0`=84)~?^m#8A2Z_TeO?E)+}8
z4|&w!WMu3y73A+fAvjUgnuuM3{Y?eqH}#h&w1tFkBOVi-^{M-H+MfkK8J)Ot?c0UK
z((_?cMPtVt60_Y*VI&#q?Iq_T`PYheVLVyuTi%iv73MpeHc$Bbb+qq(3P-CJ->tJG
zW%sDSNQY~Jii`WqTySm9FJ~X!hPiCC;N8n1)p8^|AXL0S;`n!h>(*}O0X>HB6Y3!J
zTn%k1FVcFO|I;2lU%hEcffl*)<vJoGmMo5{&c%-oqlp_zUKA~u>MssI-O-G|b-iWV
za(K&u(!k4JjGwOMB>iwUGVKS9u@iwx+qqzD=F21+x&ErfS4velc9V{!2NJb_BudTc
zbH%0#4gf+qy<KKr`v!)?jaUAIit@-DO}S{?FPo-bXulYe>m#z2mk=;!Quqb_VVR;k
zo7?5a`=pe6I;Zhv@8o&X<8%4Nw;~IT6;u9f`@KTJ%(o<O%WioZ&1GU(0;zL07q9I+
z;?Q_}uiASvx710bZml^+jfjvx?6b)<kbx1qa1~ReYv&P<Bjk?_nGkkyZhQ)^bv6GX
zREzn@Smy9c&%6kk<rz3BgJ<Kj-23XRML>8cAVLlBh6Y@0zM6aAXj>rr<w?$VF~j4u
zM7^gK$8W`0%T20w*<1YS(&qB;9*}KaJ5Z~<Tgwh_GBaaNz>%n&H0((sb8r_rjt1-2
z#|pbdh|mm@r&3%J959w150~j>>{0t2sh__`IBIK)P5Y*C<@|9*nOxk2>-RgCYfoVN
zRi%;T6G&gA7c;2iQ!LFqv3YsYp7LupY71^l&%npY!z!(W_8*=C{WK<t>cl<P<@aof
z+`U;_fqUh9#<12F=R)R*T?^dP!JT1{{<*a_W5XvmHecMZ@fA|iO1u};eSFT+ps(5b
z?5N6~!n=3s)$M!Y@%t>oy}2RZmAJNO%MS^E<Rjh8mYtf8z1R|c*qf-#?ol3CcG}8$
z@!<T7lixno!1{4_$4}#_GUBso9U2}<o|%9Bnbh2Sii4c-1)}_GSVd~TEuD=eBVJ!X
z2fF`kQOvAuw_j=jC&|IPqWac(msY>bb(y-ZghnFi^nSj<l!7oIQO?wmj`2jq*Yur|
z=2u_P9=e+wX`PQ9$td<Bg}mV#A+}|F%?Z1^Tlwt|2IsThghL<s)vN;8(!IhHB*!Sd
zyM`Ki_kCi-bH2qsBgZxlsByV_87UI4IR=xLV_gJ*QsI4!xB-+4OWTBL4H<G|^YU!x
zKrKN7hT6W1|G-C|{|1PRc8HD9-axUxV~~omU}p$-=OWD3)N!X~4Yqv?xct>YovJ&L
z3Td#3VS#`HC24bw*(Fq}LF;-oDhPbzDUJR6OJplrYRbdjVG}OabD5e{U0E139C7Ix
z2vD5P$;yWsT-8fgQo&jyHx{HR05FRh@%R7&pn1^^(xHM7Y_k>V8fXLJ7J(hBx!6Uv
zUDFX76AWH;vd9N~qYULcz|epL@k!vVGZqv>0t*W&aRKjiz}wCyq9Uqf7*rM)Y_iOd
z=YbiM<o>{;^tB}$6{%mwV92|2qty9-E%~1FcJ6Ap4>ce`#CPk-DoOPZdz_qK!L-5^
z5uhSQH$M<tR8vUyYz3)RX&F&_wl5p>%!l7xEf&x35+V-vvr0zNORzKQ*hFv1WXWIY
zCB(#nfYp*mtkQ|}(#hJ=XFa7a=EK>by)>OQ90y_(Roxzz&QIDYCvvuT0=7Xc^S2@I
zYH>OwP_bQ&Fb-;SL7M|AwjB|#Yw<(~R0P0##*pSB@xcLskeTxnJd#tz+iqDp&rrb#
ztb{?P)K&;y$|^b?g!`8_3V!G+qz5>lxJ5|N0VxRW?ba?H5Lg@lm3+MJg62=xEXqvY
z=5(Cm674~U;2boSYZULYR|eOzg2QjZH5+QOR*A$ayU9)alW?Jy{F3s#;Ev?V8>g%K
zUzhg`|3Np!-D#;*7N(GBl~v7ZZyr~_L2JfX;I-rIW)1jA{e-yY3iuRRb`cnSV~?T(
zp>IRYEo`jkDo@N<H==Re)7r>b$o=*%uiNRe)8G{b2qhXM+;$lEFR!}oA_oia+kw-0
zlpG6CoK1+o>=o|3cjis?Tx$LMR#@4$+Bn&ytyj-1-aT-FnAugyMW$6B%y>esm$Z6K
z&SYymp$t6Icz`Rnw6-I6HgM=n)x~YcOrgYl^#+%?23}k<txj=`#`m%<HeK4=(dc+a
z6}%y_(_YNOEryU{PUt5dq6oLnH9{^}!?I5I62GX@x1b8JVU$wR*SPm*`7x4yh;pMj
zBGFwDboi9MU6~u|$loRd1G3yrTEK?&?%wO45+ta!x*(#mps^<aP=W(gra^T89H|O5
z8x2xwEH3z4+gQft)%1FPs$-}Gnz$WM8+kIWaqH7wXwe$bwuka>X(scbJ84EWwfnbE
zK)=3<E-*|ywVcHdfi9KGunGLOoQ!brkc=g8BHltbo)q5#8E~{7EyY|#o(PV1Sz0+o
zz#VV#wJ}S@jjIFnT5}L#9xsG;kKnHkxI?(T0c#<?1}lVjG-}E-XwtUk)T|(OHoCUJ
zI84128v#Py+9wk7nzLJ;pVh_|kpn9aU9ZOFT-6ImZnm)1RgzlRGZ>TA=k$Tt_1Fy+
z^@Tqufy-5Ol5yL!IL{<mD@woH!3Yo!f%iuN6VB1OQ$VxKg|UzXa}TcJ*Ns}|0C{N+
zQbgAg9Oy3x<hf3_zGYZjC3ni$a;AA`YwIUg^u|iu)nyUfgBzR!E`1BAMnq%BQ+yEK
z3T~v_>?~Y+J1Q8kF4W;Q`spP`W<^AsUv;xN7<Ir-#0(5^wAv>DFD2G_Yk0&vvXX?;
zTipgk%?mat8v;(?T~$@t8(X8awsh!QWnxe~l#@%hNjYEDqeB_rK{q%$ZVP<;?pu4!
ztv8mBvgklX0hbJg)^C%3E`uz2dnPSfgBrp5+5Ll@kh)Z#(pk1$F7y3#&O)}Mvy*`q
z{&N5Lj!!=_$Pa=(F%A97Q$Wt;T9)DSdfcvWR2Dim5urNM56E=vp$(8oTh2L4q7jQ4
zcG;Un9^0Qfb?*nwVhGM*vn~POLm$oUt60upUEZ^MU7GWkfWkgqYZIVr;tVCu+F`&O
z>0@*FJ#=-MI&vGjl<9iy*5yZC8xW1IZ>PCv)jUK*yT{|x$|68kdR<No$nUQAdF@+u
zew(Hhr+<l1*1Pezr;xO^Tl-m56z8C8<=2+=#@FR|m;0NdzRq5oN=r6QHY|7+qSD@{
z2r|riA^tNhSs|+o)a4hfQ@n-uChH-Iz*ML>P`|*w(Gh9ohU^5TohBZwmLU0j)8Fw&
zL!mdvYX11DzAtXWHhi)c-P<(4?wlLse#UIe?sZ^!i)!PU^-scOON^pUxq1l`K3i-P
zBO3f~X%X3Vd(VSHN(JtN@l9HPZe&}Nvk5q{ZTySDvEZ91cA89B-nZSVd)=Tr6Gt3O
z%nqiQ9qc--=6e$qcV=zYMUz0ChU=^N5#;polc|G43@E7nxI!&{R<d(sCTGX5q5j76
z9+txateZ&g@cddcJM_9+xC7+g3oQH$iu$EJlKtnwr+nvR14I)}L*BzOZ)D0i$&m$$
z$>z8(XJnzq*WdB#Y?pUtH9OYvs#YA%%^199-b5@)5REq+^mnwJ0eWVGFZP{YS8{9B
z5=U%r=?;S2<6#ZoOD+lB9tcU27nE{Wb8887hcj~M7oN}_ZRe)`_50!b^rqp8l+3Fe
zP58wcBE9aP`&)wg;-5&aEOi7v0`B{lS=%*j51}g5QLRQ!V#hDHbX<~Y6nW)eC#Ihq
zRKY*wX-r?&E`MR78u8b_-;@E`5oz`n6t8X0imUiYXSeljB$%bbjs^?T*G>gn4sYDO
zph4~d>(`pC+@FJq>s*b_K#5m!@+!otXXulr><dH{g5a3ikv`PYVGqM2+p3yBG9MNe
zG2fp7TZ1W3p}EP{tbU6l4t?2@2q5x^5aX1v6bgCJFWfQPxmd;2ZI8sk6D}PkM#h^y
z$Ok%~6+Lgu$ifc=g2jq7?ftRiYP|8v1!MS$VeazzCn=9@STu!jDEYaH0&Ng%za}&8
z&sOYRt^4;*(6n{JvzTK&=R4Tar=~`WOS(sMrcSMMQEk<j<#Sj}%Pca?Q`A|vJW}^y
z{0HLMa^@BiR`2P90mI4tdB_5lML>|Y1tAJ5;9q;cMI92=D#cUQ`{n%}eTM1SqrCQ|
zPmVW&X@^ur0A?(^=Z5;tyPWPLI339H@X&LN5X1@cDyrjT7Ohb}x_N^eIUx9Ebz_tr
z;aI4VEM)U$yg2`@0TorCvz&(&7aX3f30Y-owjZpC50MwVQZNLNiNGP3JjmkM`m1%_
zgVQo%lg?4^A8mx0Zv%4RgI}qy2)wB5h><`RQ%!vJ>xwh6_vGmS>FczDY<+%zWqxdU
zU8H`2(bYfy#5H^U!!&yb3YYf8pAL)-R)@q^3B5*|@JT4*{y_GO-ln|8@x$+*r2lh6
zKkXf;2^AP*gHy9}Q3q`5mtI5Dpp}qc$1>&~5BNziwvPr0Vlc?vzmP-7^xRQ^kC>Tl
zu+v)%_+fT_^E>mSJKvGd-sV>%P>?gV|GX3Jj7d)EZ``@iqJ$#_!S_-Y+FmY{-O*ZE
vSm=DYV7t&)>G;0qW$8CU1n$tg-hbZTnw&8}e;CSIU<ZDX+zbRkV9S32P26e+

literal 0
HcmV?d00001

diff --git a/lib/win32com/HTML/image/www_icon.gif b/lib/win32com/HTML/image/www_icon.gif
new file mode 100644
index 0000000000000000000000000000000000000000..4239d2c3111ddbdf914bde329ee6e11e65038676
GIT binary patch
literal 275
zcmZ?wbhEHb)L_tHIK%(~`}XZ)n8EP;`Ev$_|6l<Sq4<-9k%57cK?lSEsbyfkA+hVu
zKZ8@AtM^*GKD#^KL8EQHvQS1>SL%v=`X?C;6z`Za=9tuQ@4U_D{9Cfn^znvEn`L|V
z%|Cak#BQSIi=ZH0ro}6DmzYZ|IK^VZ*XuWX`JK<VedA}}F8L8LFKPDM%E}~OlZukI
zI<1Ump4R;G3GEa6(|Qyp&FGxP%ruRwZ|3Ahd2<W%QdcZrQMY=|Qo)q96Q*ol?IgUh
zHZ#(^ymsBZ>6TjVfd>yA4vUC9u5daqNPoT0MbGovk_^}Pn4aa2y>wTW;eq87-6zkU
XtM)#5_xjDpPoKYh{r3GMCxbNr)TwuZ

literal 0
HcmV?d00001

diff --git a/lib/win32com/HTML/index.html b/lib/win32com/HTML/index.html
new file mode 100644
index 00000000..2ab0176a
--- /dev/null
+++ b/lib/win32com/HTML/index.html
@@ -0,0 +1,31 @@
+<HTML>
+<HEAD>
+<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=windows-1252">
+<META NAME="Generator" CONTENT="Microsoft Word 97">
+<TITLE>win32com</TITLE>
+<META NAME="Template" CONTENT="C:\Program Files\Microsoft Office\Office\html.dot">
+</HEAD>
+<BODY TEXT="#000000" LINK="#0000ff" VLINK="#0000ff">
+<DIR>
+
+<P><!-- Enclose the entire page in UL, so bullets don't indent. --></P>
+<H1><IMG SRC="image/pycom_blowing.gif" WIDTH=549 HEIGHT=99></H1>
+<H2>Python and COM</H2>
+<H3>Introduction</H3>
+<P>Python has an excellent interface to COM (also known variously as OLE2, ActiveX, etc).</P>
+<P>The Python COM package can be used to interface to almost any COM program (such as the MS-Office suite), write servers that can be hosted by any COM client (such as Visual Basic or C++), and has even been used to provide the core ActiveX Scripting Support. </P>
+
+
+<UL>
+<LI>Note that win32com is now released in the win32all installation package. The <A HREF="../win32all/win32all.exe">installation EXE can be downloaded</A>, or you <A HREF="../win32all/">can jump to the win32all readme</A> for more details. </LI>
+<LI>Here is the <A HREF="win32com_src.zip">win32com source code</A> in a zip file. </LI></UL>
+</DIR>
+<DIR>
+
+<H3>Documentation</H3>
+<P><A HREF="ActiveXScripting.html">Preliminary Active Scripting and Debugging documentation</A> is available.</P>
+<P>2 Quick-Start guides have been provided, which also contain other links. See the <A HREF="QuickStartClientCom.html">Quick Start for Client side COM</A> and the <A HREF="QuickStartServerCom.html">Quick Start for Server side COM</A> </P>
+</P></DIR>
+</DIR>
+</BODY>
+</HTML>
diff --git a/lib/win32com/HTML/misc.html b/lib/win32com/HTML/misc.html
new file mode 100644
index 00000000..4374d221
--- /dev/null
+++ b/lib/win32com/HTML/misc.html
@@ -0,0 +1,18 @@
+<HTML>
+<HEAD>
+<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=windows-1252">
+<META NAME="Generator" CONTENT="Microsoft Word 97">
+<TITLE>Misc win32com Stuff</TITLE>
+<META NAME="Version" CONTENT="8.0.3410">
+<META NAME="Date" CONTENT="10/11/96">
+<META NAME="Template" CONTENT="D:\Program Files\Microsoft Office\Office\HTML.DOT">
+</HEAD>
+<BODY TEXT="#000000" BGCOLOR="#ffffff">
+
+<H1>Misc stuff I don�t know where to put anywhere else</H1>
+<H4>Client Side Dispatch</H4>
+<P>Using win32com.client.Dispatch automatically invokes all the win32com client side "smarts", including automatic usage of generated .py files etc.</P>
+<P>If you wish to avoid that, and use truly "dynamic" objects (ie, there is generated .py support available, but you wish to avoid it), you can use win32com.client.dynamic.Dispatch</P>
+<B><P>_print_details_() method</B><BR>
+If win32com.client.dynamic.Dispatch is used, the objects have a _print_details_() method available, which prints all relevant knowledge about an object (for example, all methods and properties). For objects that do not expose runtime type information, _print_details_ may not list anything.</P></BODY>
+</HTML>
diff --git a/lib/win32com/HTML/package.html b/lib/win32com/HTML/package.html
new file mode 100644
index 00000000..e98f0875
--- /dev/null
+++ b/lib/win32com/HTML/package.html
@@ -0,0 +1,37 @@
+<HTML>
+<HEAD>
+<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=windows-1252">
+<META NAME="Generator" CONTENT="Microsoft Word 97">
+<TITLE>The win32com package</TITLE>
+<META NAME="Template" CONTENT="D:\Program Files\Microsoft Office\Office\html.dot">
+</HEAD>
+<BODY LINK="#0000ff" VLINK="#800080">
+
+<H1><IMG SRC="image/pycom_blowing.gif" WIDTH=549 HEIGHT=99 ALT="Python and COM - Blowing the others away"></H1>
+<H1>The win32com package </H1>
+<FONT SIZE=2><P>This document describes the win32com package in general terms.</FONT> </P>
+<FONT SIZE=2><P>The COM support can be thought of as existing in 2 main portions - the C++ support code (the core PythonCOM module), and helper code, implemented in Python. The total package is known as "win32com".</FONT> </P>
+<FONT SIZE=2><P>The win32com support is stand-alone. It does not require Pythonwin.</FONT> </P>
+<H2>The win32com package </H2>
+<FONT SIZE=2><P>To facilitate an orderly framework, the Python "ni" module has been used, and the entire package is known as "win32com". As is normal for such packages, win32com itself does not provide any functionality. Some of the modules are described below:</FONT> </P>
+
+<UL>
+<B><FONT SIZE=2><LI>win32com.pythoncom - core C++ support</B>. <BR>
+This module is rarely used directly by programmers - instead the other "helper" module are used, which themselves draw on the core pythoncom services.</FONT> </LI>
+<B><FONT SIZE=2><LI>win32com.client package<BR>
+</B>Support for COM clients used by Python. Some of the modules in this package allow for dynamic usage of COM clients, a module for generating .py files for certain COM servers, etc.</FONT> </LI>
+<B><FONT SIZE=2><LI>win32com.server package<BR>
+</B>Support for COM servers written in Python. The modules in this package provide most of the underlying framework for magically turning Python classes into COM servers, exposing the correct public methods, registering your server in the registry, etc. </LI>
+<B><LI>win32com.axscript<BR>
+</B>ActiveX Scripting implementation for Python.</FONT> </LI>
+<B><FONT SIZE=2><LI>win32com.axdebug<BR>
+</B>Active Debugging implementation for Python</FONT> </LI>
+<B><FONT SIZE=2><LI>win32com.mapi<BR>
+</B>Utilities for working with MAPI and the Microsoft Exchange Server</LI></UL>
+
+</FONT><P>&nbsp;</P>
+<H2>The pythoncom module </H2>
+<FONT SIZE=2><P>The pythoncom module is the underlying C++ support for all COM related objects. In general, Python programmers will not use this module directly, but use win32com helper classes and functions. </P>
+<P>This module exposes a C++ like interface to COM - there are objects implemented in pythoncom that have methods "QueryInterface()", "Invoke()", just like the C++ API. If you are using COM in C++, you would not call a method directly, you would use pObject-&gt;Invoke( �, MethodId, argArray�). Similarly, if you are using pythoncom directly, you must also use the Invoke method to call an object's exposed method.</FONT> </P>
+<FONT SIZE=2><P>There are some Python wrappers for hiding this raw interface, meaning you should almost never need to use the pythoncom module directly. These helpers translate a "natural" looking interface (eg, obj.SomeMethod()) into the underlying Invoke call.</P></FONT></BODY>
+</HTML>
diff --git a/lib/win32com/HTML/variant.html b/lib/win32com/HTML/variant.html
new file mode 100644
index 00000000..2631203e
--- /dev/null
+++ b/lib/win32com/HTML/variant.html
@@ -0,0 +1,162 @@
+<HTML>
+<HEAD>
+    <TITLE>win32com.client.VARIANT</TITLE>
+</HEAD>
+<BODY>
+
+<H2>Introduction</H2>
+<p>
+win32com attempts to provide a seamless COM interface and hide many COM 
+implementation details, including the use of COM VARIANT structures.  This 
+means that in most cases, you just call a COM object using normal Python 
+objects as parameters and get back normal Python objects as results.
+</p>
+
+<p>
+However, in some cases this doesn't work very well, particularly when using
+"dynamic" (aka late-bound) objects, or when using "makepy" (aka early-bound)
+objects which only declare a parameter is a VARIANT.
+</p>
+
+<p>
+The <code>win32com.client.VARIANT</code> object is designed to overcome these 
+problems.
+</p>
+
+<h2>Drawbacks</h2>
+The primary issue with this approach is that the programmer must learn more 
+about COM VARIANTs than otherwise - they need to know concepts such as 
+variants being <em>byref</em>, holding arrays, or that some may hold 32bit 
+unsigned integers while others hold 64bit signed ints, and they need to 
+understand this in the context of a single method call.  In short, this is
+a relatively advanced feature.  The good news though is that use of these
+objects should never cause your program to hard-crash - the worst you should
+expect are Python or COM exceptions being thrown.
+
+<h2>The VARIANT object</h2>
+
+The VARIANT object lives in <code>win32com.client</code>.  The constructor 
+takes 2 parameters - the 'variant type' and the value.  The 'variant type' is 
+an integer and can be one or more of the <code>pythoncom.VT_*</code> values,
+possibly or'd together.
+
+<p>For example, to create a VARIANT object which defines a byref array of 
+32bit integers, you could use:
+
+<pre>
+>>> from win32com.client import VARIANT
+>>> import pythoncom
+>>> v = VARIANT(pythoncom.VT_BYREF | pythoncom.VT_ARRAY | pythoncom.VT_I4,
+...             [1,2,3,4])
+>>> v
+win32com.client.VARIANT(24579, [1, 2, 3, 4])
+>>>
+</pre>
+
+This variable can then be used whereever a COM VARIANT is expected.
+
+<h2>Example usage with dynamic objects.</h2>
+
+For this example we will use the COM object used for win32com testing, 
+<code>PyCOMTest.PyCOMTest</code>.  This object defines a method which is
+defined in IDL as:
+<pre>
+HRESULT DoubleInOutString([in,out] BSTR *str);
+</pre>
+
+As you can see, it takes a single string parameter which is also used as
+an "out" parameter - the single parameter will be updated after the call.
+The implementation of the method simply "doubles" the string.
+
+<p>If the object has a type-library, this method works fine with makepy
+generated support.  For example:
+
+<pre>
+>>> from win32com.client.gencache import EnsureDispatch
+>>> ob = EnsureDispatch("PyCOMTest.PyCOMTest")
+>>> ob.DoubleInOutString("Hello")
+u'HelloHello'
+>>>
+</pre>
+
+However, if makepy support is not available the method does not work as
+expected.  For the next example we will use <code>DumbDispatch</code> to
+simulate the object not having a type-library.
+
+<pre>
+>>> import win32com.client.dynamic
+>>> ob = win32com.client.dynamic.DumbDispatch("PyCOMTest.PyCOMTest")
+>>> ob.DoubleInOutString("Hello")
+>>>
+</pre>
+
+As you can see, no result came back from the function.  This is because
+win32com has no type information available to use, so doesn't know the
+parameter should be passed as a <code>byref</code> parameter.  To work
+around this, we can use the <code>VARIANT</code> object.
+
+<p>The following example explicitly creates a VARIANT object with a
+variant type of a byref string and a value 'Hello'.  After making the
+call with this VARIANT the value is updated.
+
+<pre>
+>>> import win32com.client.dynamic
+>>> from win32com.client import VARIANT
+>>> import pythoncom
+>>> ob = win32com.client.dynamic.DumbDispatch("PyCOMTest.PyCOMTest")
+>>> variant = VARIANT(pythoncom.VT_BYREF | pythoncom.VT_BSTR, "Hello")
+>>> variant.value # check the value before the call.
+'Hello'
+>>> ob.DoubleInOutString(variant)
+>>> variant.value
+u'HelloHello'
+>>>
+</pre>
+
+<h2>Usage with generated objects</h2>
+
+In most cases, objects with makepy support (ie, 'generated' objects) don't 
+need to use the VARIANT object - the type information means win32com can guess
+the right thing to pass.  However, in some cases the VARIANT object can still
+be useful.
+
+Imagine a poorly specified object with IDL like:
+
+<pre>
+HRESULT DoSomething([in] VARIANT value);
+</pre>
+
+But also imagine that the object has a limitation that if the parameter is an 
+integer, it must be a 32bit unsigned value - any other integer representation
+will fail.
+
+<p>If you just pass a regular Python integer to this function, it will 
+generally be passed as a 32bit signed integer and given the limitation above,
+will fail.  The VARIANT object allows you to work around the limitation - just
+create a variant object <code>VARIANT(pythoncom.VT_UI4, int_value)</code> and 
+pass that - the function will then be called with the explicit type you 
+specified and will succeed.
+
+<p>Note that you can not use a VARIANT object to override the types described
+in a type library.  If a makepy generated class specifies that a VT_UI2 is 
+expected, attempting to pass a VARIANT object will fail.  In this case you 
+would need to hack around the problem.  For example, imagine <code>ob</code>
+was a COM object which a method called <code>foo</code> and you wanted to 
+override the type declaration for <code>foo</code> by passing a VARIANT.
+You could do something like:
+
+<pre>
+>>> import win32com.client.dynamic
+>>> from win32com.client import VARIANT
+>>> import pythoncom
+>>> dumbob = win32com.client.dynamic.DumbDispatch(ob)
+>>> variant = VARIANT(pythoncom.VT_BYREF | pythoncom.VT_BSTR, "Hello")
+>>> dumbob.foo(variant)
+</pre>
+
+The code above converts the makepy supported <code>ob</code> into a
+'dumb' (ie, non-makepy supported) version of the object, which will then
+allow you to use VARIANT objects for the problematic methods.
+
+</BODY>
+</HTML>
diff --git a/lib/win32com/License.txt b/lib/win32com/License.txt
new file mode 100644
index 00000000..6c1884e9
--- /dev/null
+++ b/lib/win32com/License.txt
@@ -0,0 +1,30 @@
+Unless stated in the specfic source file, this work is
+Copyright (c) 1996-2008, Greg Stein and Mark Hammond.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without 
+modification, are permitted provided that the following conditions 
+are met:
+
+Redistributions of source code must retain the above copyright notice, 
+this list of conditions and the following disclaimer.
+
+Redistributions in binary form must reproduce the above copyright 
+notice, this list of conditions and the following disclaimer in 
+the documentation and/or other materials provided with the distribution.
+
+Neither names of Greg Stein, Mark Hammond nor the name of contributors may be used 
+to endorse or promote products derived from this software without 
+specific prior written permission. 
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS
+IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR
+CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 
diff --git a/lib/win32com/__init__.py b/lib/win32com/__init__.py
new file mode 100644
index 00000000..4832d9e1
--- /dev/null
+++ b/lib/win32com/__init__.py
@@ -0,0 +1,132 @@
+#
+# Initialization for the win32com package
+#
+
+import os
+import sys
+
+import pythoncom
+import win32api
+
+# flag if we are in a "frozen" build.
+_frozen = getattr(sys, "frozen", 1 == 0)
+# pythoncom dumbly defaults this to zero - we believe sys.frozen over it.
+if _frozen and not getattr(pythoncom, "frozen", 0):
+    pythoncom.frozen = sys.frozen
+
+# Add support for an external "COM Extensions" path.
+#  Concept is that you can register a seperate path to be used for
+#  COM extensions, outside of the win32com directory.  These modules, however,
+#  look identical to win32com built-in modules.
+#  This is the technique that we use for the "standard" COM extensions.
+#  eg "win32com.mapi" or "win32com.axscript" both work, even though they do not
+#  live under the main win32com directory.
+__gen_path__ = ""
+__build_path__ = None
+### TODO - Load _all_ \\Extensions subkeys - for now, we only read the default
+### Modules will work if loaded into "win32comext" path.
+
+
+def SetupEnvironment():
+    HKEY_LOCAL_MACHINE = -2147483646  # Avoid pulling in win32con for just these...
+    KEY_QUERY_VALUE = 0x1
+    # Open the root key once, as this is quite slow on NT.
+    try:
+        keyName = "SOFTWARE\\Python\\PythonCore\\%s\\PythonPath\\win32com" % sys.winver
+        key = win32api.RegOpenKey(HKEY_LOCAL_MACHINE, keyName, 0, KEY_QUERY_VALUE)
+    except (win32api.error, AttributeError):
+        key = None
+
+    try:
+        found = 0
+        if key is not None:
+            try:
+                __path__.append(win32api.RegQueryValue(key, "Extensions"))
+                found = 1
+            except win32api.error:
+                # Nothing registered
+                pass
+        if not found:
+            try:
+                __path__.append(
+                    win32api.GetFullPathName(__path__[0] + "\\..\\win32comext")
+                )
+            except win32api.error:
+                # Give up in disgust!
+                pass
+
+        # For the sake of developers, we also look up a "BuildPath" key
+        # If extension modules add support, we can load their .pyd's from a completely
+        # different directory (see the comments below)
+        try:
+            if key is not None:
+                global __build_path__
+                __build_path__ = win32api.RegQueryValue(key, "BuildPath")
+                __path__.append(__build_path__)
+        except win32api.error:
+            # __build_path__ neednt be defined.
+            pass
+        global __gen_path__
+        if key is not None:
+            try:
+                __gen_path__ = win32api.RegQueryValue(key, "GenPath")
+            except win32api.error:
+                pass
+    finally:
+        if key is not None:
+            key.Close()
+
+
+# A Helper for developers.  A sub-package's __init__ can call this help function,
+# which allows the .pyd files for the extension to live in a special "Build" directory
+# (which the win32com developers do!)
+def __PackageSupportBuildPath__(package_path):
+    # See if we have a special directory for the binaries (for developers)
+    if not _frozen and __build_path__:
+        package_path.append(__build_path__)
+
+
+if not _frozen:
+    SetupEnvironment()
+
+# If we don't have a special __gen_path__, see if we have a gen_py as a
+# normal module and use that (ie, "win32com.gen_py" may already exist as
+# a package.
+if not __gen_path__:
+    try:
+        import win32com.gen_py
+
+        # hrmph - 3.3 throws: TypeError: '_NamespacePath' object does not support indexing
+        # attempting to get __path__[0] - but I can't quickly repro this stand-alone.
+        # Work around it by using an iterator.
+        __gen_path__ = next(iter(sys.modules["win32com.gen_py"].__path__))
+    except ImportError:
+        # If a win32com\gen_py directory already exists, then we use it
+        # (gencache doesn't insist it have an __init__, but our __import__
+        # above does!
+        __gen_path__ = os.path.abspath(os.path.join(__path__[0], "gen_py"))
+        if not os.path.isdir(__gen_path__):
+            # We used to dynamically create a directory under win32com -
+            # but this sucks.  If the dir doesn't already exist, we we
+            # create a version specific directory under the user temp
+            # directory.
+            __gen_path__ = os.path.join(
+                win32api.GetTempPath(),
+                "gen_py",
+                "%d.%d" % (sys.version_info[0], sys.version_info[1]),
+            )
+
+# we must have a __gen_path__, but may not have a gen_py module -
+# set that up.
+if "win32com.gen_py" not in sys.modules:
+    # Create a "win32com.gen_py", but with a custom __path__
+    import types
+
+    gen_py = types.ModuleType("win32com.gen_py")
+    gen_py.__path__ = [__gen_path__]
+    sys.modules[gen_py.__name__] = gen_py
+    del types
+gen_py = sys.modules["win32com.gen_py"]
+
+# get rid of these for module users
+del os, sys, win32api, pythoncom
diff --git a/lib/win32com/client/CLSIDToClass.py b/lib/win32com/client/CLSIDToClass.py
new file mode 100644
index 00000000..fde32743
--- /dev/null
+++ b/lib/win32com/client/CLSIDToClass.py
@@ -0,0 +1,57 @@
+"""Manages a dictionary of CLSID strings to Python classes.
+
+Primary use of this module is to allow modules generated by
+makepy.py to share classes.  @makepy@ automatically generates code
+which interacts with this module.  You should never need to reference
+this module directly.
+
+This module only provides support for modules which have been previously
+been imported.  The gencache module provides some support for loading modules
+on demand - once done, this module supports it...
+
+As an example, the MSACCESS.TLB type library makes reference to the
+CLSID of the Database object, as defined in DAO3032.DLL.  This
+allows code using the MSAccess wrapper to natively use Databases.
+
+This obviously applies to all cooperating objects, not just DAO and
+Access.
+"""
+mapCLSIDToClass = {}
+
+
+def RegisterCLSID(clsid, pythonClass):
+    """Register a class that wraps a CLSID
+
+    This function allows a CLSID to be globally associated with a class.
+    Certain module will automatically convert an IDispatch object to an
+    instance of the associated class.
+    """
+
+    mapCLSIDToClass[str(clsid)] = pythonClass
+
+
+def RegisterCLSIDsFromDict(dict):
+    """Register a dictionary of CLSID's and classes.
+
+    This module performs the same function as @RegisterCLSID@, but for
+    an entire dictionary of associations.
+
+    Typically called by makepy generated modules at import time.
+    """
+    mapCLSIDToClass.update(dict)
+
+
+def GetClass(clsid):
+    """Given a CLSID, return the globally associated class.
+
+    clsid -- a string CLSID representation to check.
+    """
+    return mapCLSIDToClass[clsid]
+
+
+def HasClass(clsid):
+    """Determines if the CLSID has an associated class.
+
+    clsid -- the string CLSID to check
+    """
+    return clsid in mapCLSIDToClass
diff --git a/lib/win32com/client/__init__.py b/lib/win32com/client/__init__.py
new file mode 100644
index 00000000..91b4b303
--- /dev/null
+++ b/lib/win32com/client/__init__.py
@@ -0,0 +1,714 @@
+# This module exists to create the "best" dispatch object for a given
+# object.  If "makepy" support for a given object is detected, it is
+# used, otherwise a dynamic dispatch object.
+
+# Note that if the unknown dispatch object then returns a known
+# dispatch object, the known class will be used.  This contrasts
+# with dynamic.Dispatch behaviour, where dynamic objects are always used.
+
+import sys
+
+import pythoncom
+import pywintypes
+
+from . import dynamic, gencache
+
+_PyIDispatchType = pythoncom.TypeIIDs[pythoncom.IID_IDispatch]
+
+
+def __WrapDispatch(
+    dispatch,
+    userName=None,
+    resultCLSID=None,
+    typeinfo=None,
+    UnicodeToString=None,
+    clsctx=pythoncom.CLSCTX_SERVER,
+    WrapperClass=None,
+):
+    """
+    Helper function to return a makepy generated class for a CLSID if it exists,
+    otherwise cope by using CDispatch.
+    """
+    assert UnicodeToString is None, "this is deprecated and will go away"
+    if resultCLSID is None:
+        try:
+            typeinfo = dispatch.GetTypeInfo()
+            if (
+                typeinfo is not None
+            ):  # Some objects return NULL, some raise exceptions...
+                resultCLSID = str(typeinfo.GetTypeAttr()[0])
+        except (pythoncom.com_error, AttributeError):
+            pass
+    if resultCLSID is not None:
+        from . import gencache
+
+        # Attempt to load generated module support
+        # This may load the module, and make it available
+        klass = gencache.GetClassForCLSID(resultCLSID)
+        if klass is not None:
+            return klass(dispatch)
+
+    # Return a "dynamic" object - best we can do!
+    if WrapperClass is None:
+        WrapperClass = CDispatch
+    return dynamic.Dispatch(dispatch, userName, WrapperClass, typeinfo, clsctx=clsctx)
+
+
+def GetObject(Pathname=None, Class=None, clsctx=None):
+    """
+    Mimic VB's GetObject() function.
+
+    ob = GetObject(Class = "ProgID") or GetObject(Class = clsid) will
+    connect to an already running instance of the COM object.
+
+    ob = GetObject(r"c:\blah\blah\foo.xls") (aka the COM moniker syntax)
+    will return a ready to use Python wrapping of the required COM object.
+
+    Note: You must specifiy one or the other of these arguments. I know
+    this isn't pretty, but it is what VB does. Blech. If you don't
+    I'll throw ValueError at you. :)
+
+    This will most likely throw pythoncom.com_error if anything fails.
+    """
+    if clsctx is None:
+        clsctx = pythoncom.CLSCTX_ALL
+
+    if (Pathname is None and Class is None) or (
+        Pathname is not None and Class is not None
+    ):
+        raise ValueError(
+            "You must specify a value for Pathname or Class, but not both."
+        )
+
+    if Class is not None:
+        return GetActiveObject(Class, clsctx)
+    else:
+        return Moniker(Pathname, clsctx)
+
+
+def GetActiveObject(Class, clsctx=pythoncom.CLSCTX_ALL):
+    """
+    Python friendly version of GetObject's ProgID/CLSID functionality.
+    """
+    resultCLSID = pywintypes.IID(Class)
+    dispatch = pythoncom.GetActiveObject(resultCLSID)
+    dispatch = dispatch.QueryInterface(pythoncom.IID_IDispatch)
+    return __WrapDispatch(dispatch, Class, resultCLSID=resultCLSID, clsctx=clsctx)
+
+
+def Moniker(Pathname, clsctx=pythoncom.CLSCTX_ALL):
+    """
+    Python friendly version of GetObject's moniker functionality.
+    """
+    moniker, i, bindCtx = pythoncom.MkParseDisplayName(Pathname)
+    dispatch = moniker.BindToObject(bindCtx, None, pythoncom.IID_IDispatch)
+    return __WrapDispatch(dispatch, Pathname, clsctx=clsctx)
+
+
+def Dispatch(
+    dispatch,
+    userName=None,
+    resultCLSID=None,
+    typeinfo=None,
+    UnicodeToString=None,
+    clsctx=pythoncom.CLSCTX_SERVER,
+):
+    """Creates a Dispatch based COM object."""
+    assert UnicodeToString is None, "this is deprecated and will go away"
+    dispatch, userName = dynamic._GetGoodDispatchAndUserName(dispatch, userName, clsctx)
+    return __WrapDispatch(dispatch, userName, resultCLSID, typeinfo, clsctx=clsctx)
+
+
+def DispatchEx(
+    clsid,
+    machine=None,
+    userName=None,
+    resultCLSID=None,
+    typeinfo=None,
+    UnicodeToString=None,
+    clsctx=None,
+):
+    """Creates a Dispatch based COM object on a specific machine."""
+    assert UnicodeToString is None, "this is deprecated and will go away"
+    # If InProc is registered, DCOM will use it regardless of the machine name
+    # (and regardless of the DCOM config for the object.)  So unless the user
+    # specifies otherwise, we exclude inproc apps when a remote machine is used.
+    if clsctx is None:
+        clsctx = pythoncom.CLSCTX_SERVER
+        if machine is not None:
+            clsctx = clsctx & ~pythoncom.CLSCTX_INPROC
+    if machine is None:
+        serverInfo = None
+    else:
+        serverInfo = (machine,)
+    if userName is None:
+        userName = clsid
+    dispatch = pythoncom.CoCreateInstanceEx(
+        clsid, None, clsctx, serverInfo, (pythoncom.IID_IDispatch,)
+    )[0]
+    return Dispatch(dispatch, userName, resultCLSID, typeinfo, clsctx=clsctx)
+
+
+class CDispatch(dynamic.CDispatch):
+    """
+    The dynamic class used as a last resort.
+    The purpose of this overriding of dynamic.CDispatch is to perpetuate the policy
+    of using the makepy generated wrapper Python class instead of dynamic.CDispatch
+    if/when possible.
+    """
+
+    def _wrap_dispatch_(
+        self, ob, userName=None, returnCLSID=None, UnicodeToString=None
+    ):
+        assert UnicodeToString is None, "this is deprecated and will go away"
+        return Dispatch(ob, userName, returnCLSID, None)
+
+    def __dir__(self):
+        return dynamic.CDispatch.__dir__(self)
+
+
+def CastTo(ob, target, typelib=None):
+    """'Cast' a COM object to another interface"""
+    # todo - should support target being an IID
+    mod = None
+    if (
+        typelib is not None
+    ):  # caller specified target typelib (TypelibSpec). See e.g. selecttlb.EnumTlbs().
+        mod = gencache.MakeModuleForTypelib(
+            typelib.clsid, typelib.lcid, int(typelib.major, 16), int(typelib.minor, 16)
+        )
+        if not hasattr(mod, target):
+            raise ValueError(
+                "The interface name '%s' does not appear in the "
+                "specified library %r" % (target, typelib.ver_desc)
+            )
+
+    elif hasattr(target, "index"):  # string like
+        # for now, we assume makepy for this to work.
+        if "CLSID" not in ob.__class__.__dict__:
+            # Eeek - no makepy support - try and build it.
+            ob = gencache.EnsureDispatch(ob)
+        if "CLSID" not in ob.__class__.__dict__:
+            raise ValueError("Must be a makepy-able object for this to work")
+        clsid = ob.CLSID
+        # Lots of hoops to support "demand-build" - ie, generating
+        # code for an interface first time it is used.  We assume the
+        # interface name exists in the same library as the object.
+        # This is generally the case - only referenced typelibs may be
+        # a problem, and we can handle that later.  Maybe <wink>
+        # So get the generated module for the library itself, then
+        # find the interface CLSID there.
+        mod = gencache.GetModuleForCLSID(clsid)
+        # Get the 'root' module.
+        mod = gencache.GetModuleForTypelib(
+            mod.CLSID, mod.LCID, mod.MajorVersion, mod.MinorVersion
+        )
+        # Find the CLSID of the target
+        target_clsid = mod.NamesToIIDMap.get(target)
+        if target_clsid is None:
+            raise ValueError(
+                "The interface name '%s' does not appear in the "
+                "same library as object '%r'" % (target, ob)
+            )
+        mod = gencache.GetModuleForCLSID(target_clsid)
+    if mod is not None:
+        target_class = getattr(mod, target)
+        # resolve coclass to interface
+        target_class = getattr(target_class, "default_interface", target_class)
+        return target_class(ob)  # auto QI magic happens
+    raise ValueError
+
+
+class Constants:
+    """A container for generated COM constants."""
+
+    def __init__(self):
+        self.__dicts__ = []  # A list of dictionaries
+
+    def __getattr__(self, a):
+        for d in self.__dicts__:
+            if a in d:
+                return d[a]
+        raise AttributeError(a)
+
+
+# And create an instance.
+constants = Constants()
+
+
+# A helpers for DispatchWithEvents - this becomes __setattr__ for the
+# temporary class.
+def _event_setattr_(self, attr, val):
+    try:
+        # Does the COM object have an attribute of this name?
+        self.__class__.__bases__[0].__setattr__(self, attr, val)
+    except AttributeError:
+        # Otherwise just stash it away in the instance.
+        self.__dict__[attr] = val
+
+
+# An instance of this "proxy" is created to break the COM circular references
+# that exist (ie, when we connect to the COM events, COM keeps a reference
+# to the object.  Thus, the Event connection must be manually broken before
+# our object can die.  This solves the problem by manually breaking the connection
+# to the real object as the proxy dies.
+class EventsProxy:
+    def __init__(self, ob):
+        self.__dict__["_obj_"] = ob
+
+    def __del__(self):
+        try:
+            # If there is a COM error on disconnection we should
+            # just ignore it - object probably already shut down...
+            self._obj_.close()
+        except pythoncom.com_error:
+            pass
+
+    def __getattr__(self, attr):
+        return getattr(self._obj_, attr)
+
+    def __setattr__(self, attr, val):
+        setattr(self._obj_, attr, val)
+
+
+def DispatchWithEvents(clsid, user_event_class):
+    """Create a COM object that can fire events to a user defined class.
+    clsid -- The ProgID or CLSID of the object to create.
+    user_event_class -- A Python class object that responds to the events.
+
+    This requires makepy support for the COM object being created.  If
+    this support does not exist it will be automatically generated by
+    this function.  If the object does not support makepy, a TypeError
+    exception will be raised.
+
+    The result is a class instance that both represents the COM object
+    and handles events from the COM object.
+
+    It is important to note that the returned instance is not a direct
+    instance of the user_event_class, but an instance of a temporary
+    class object that derives from three classes:
+    * The makepy generated class for the COM object
+    * The makepy generated class for the COM events
+    * The user_event_class as passed to this function.
+
+    If this is not suitable, see the getevents function for an alternative
+    technique of handling events.
+
+    Object Lifetimes:  Whenever the object returned from this function is
+    cleaned-up by Python, the events will be disconnected from
+    the COM object.  This is almost always what should happen,
+    but see the documentation for getevents() for more details.
+
+    Example:
+
+    >>> class IEEvents:
+    ...    def OnVisible(self, visible):
+    ...       print "Visible changed:", visible
+    ...
+    >>> ie = DispatchWithEvents("InternetExplorer.Application", IEEvents)
+    >>> ie.Visible = 1
+    Visible changed: 1
+    >>>
+    """
+    # Create/Get the object.
+    disp = Dispatch(clsid)
+    if not disp.__class__.__dict__.get(
+        "CLSID"
+    ):  # Eeek - no makepy support - try and build it.
+        try:
+            ti = disp._oleobj_.GetTypeInfo()
+            disp_clsid = ti.GetTypeAttr()[0]
+            tlb, index = ti.GetContainingTypeLib()
+            tla = tlb.GetLibAttr()
+            gencache.EnsureModule(tla[0], tla[1], tla[3], tla[4], bValidateFile=0)
+            # Get the class from the module.
+            disp_class = gencache.GetClassForProgID(str(disp_clsid))
+        except pythoncom.com_error:
+            raise TypeError(
+                "This COM object can not automate the makepy process - please run makepy manually for this object"
+            )
+    else:
+        disp_class = disp.__class__
+    # If the clsid was an object, get the clsid
+    clsid = disp_class.CLSID
+    # Create a new class that derives from 3 classes - the dispatch class, the event sink class and the user class.
+    # XXX - we are still "classic style" classes in py2x, so we need can't yet
+    # use 'type()' everywhere - revisit soon, as py2x will move to new-style too...
+    try:
+        from types import ClassType as new_type
+    except ImportError:
+        new_type = type  # py3k
+    events_class = getevents(clsid)
+    if events_class is None:
+        raise ValueError("This COM object does not support events.")
+    result_class = new_type(
+        "COMEventClass",
+        (disp_class, events_class, user_event_class),
+        {"__setattr__": _event_setattr_},
+    )
+    instance = result_class(
+        disp._oleobj_
+    )  # This only calls the first base class __init__.
+    events_class.__init__(instance, instance)
+    if hasattr(user_event_class, "__init__"):
+        user_event_class.__init__(instance)
+    return EventsProxy(instance)
+
+
+def WithEvents(disp, user_event_class):
+    """Similar to DispatchWithEvents - except that the returned
+    object is *not* also usable as the original Dispatch object - that is
+    the returned object is not dispatchable.
+
+    The difference is best summarised by example.
+
+    >>> class IEEvents:
+    ...    def OnVisible(self, visible):
+    ...       print "Visible changed:", visible
+    ...
+    >>> ie = Dispatch("InternetExplorer.Application")
+    >>> ie_events = WithEvents(ie, IEEvents)
+    >>> ie.Visible = 1
+    Visible changed: 1
+
+    Compare with the code sample for DispatchWithEvents, where you get a
+    single object that is both the interface and the event handler.  Note that
+    the event handler instance will *not* be able to use 'self.' to refer to
+    IE's methods and properties.
+
+    This is mainly useful where using DispatchWithEvents causes
+    circular reference problems that the simple proxy doesn't deal with
+    """
+    disp = Dispatch(disp)
+    if not disp.__class__.__dict__.get(
+        "CLSID"
+    ):  # Eeek - no makepy support - try and build it.
+        try:
+            ti = disp._oleobj_.GetTypeInfo()
+            disp_clsid = ti.GetTypeAttr()[0]
+            tlb, index = ti.GetContainingTypeLib()
+            tla = tlb.GetLibAttr()
+            gencache.EnsureModule(tla[0], tla[1], tla[3], tla[4], bValidateFile=0)
+            # Get the class from the module.
+            disp_class = gencache.GetClassForProgID(str(disp_clsid))
+        except pythoncom.com_error:
+            raise TypeError(
+                "This COM object can not automate the makepy process - please run makepy manually for this object"
+            )
+    else:
+        disp_class = disp.__class__
+    # Get the clsid
+    clsid = disp_class.CLSID
+    # Create a new class that derives from 2 classes - the event sink
+    # class and the user class.
+    try:
+        from types import ClassType as new_type
+    except ImportError:
+        new_type = type  # py3k
+    events_class = getevents(clsid)
+    if events_class is None:
+        raise ValueError("This COM object does not support events.")
+    result_class = new_type("COMEventClass", (events_class, user_event_class), {})
+    instance = result_class(disp)  # This only calls the first base class __init__.
+    if hasattr(user_event_class, "__init__"):
+        user_event_class.__init__(instance)
+    return instance
+
+
+def getevents(clsid):
+    """Determine the default outgoing interface for a class, given
+    either a clsid or progid. It returns a class - you can
+    conveniently derive your own handler from this class and implement
+    the appropriate methods.
+
+    This method relies on the classes produced by makepy. You must use
+    either makepy or the gencache module to ensure that the
+    appropriate support classes have been generated for the com server
+    that you will be handling events from.
+
+    Beware of COM circular references.  When the Events class is connected
+    to the COM object, the COM object itself keeps a reference to the Python
+    events class.  Thus, neither the Events instance or the COM object will
+    ever die by themselves.  The 'close' method on the events instance
+    must be called to break this chain and allow standard Python collection
+    rules to manage object lifetimes.  Note that DispatchWithEvents() does
+    work around this problem by the use of a proxy object, but if you use
+    the getevents() function yourself, you must make your own arrangements
+    to manage this circular reference issue.
+
+    Beware of creating Python circular references: this will happen if your
+    handler has a reference to an object that has a reference back to
+    the event source. Call the 'close' method to break the chain.
+
+    Example:
+
+    >>>win32com.client.gencache.EnsureModule('{EAB22AC0-30C1-11CF-A7EB-0000C05BAE0B}',0,1,1)
+    <module 'win32com.gen_py.....
+    >>>
+    >>> class InternetExplorerEvents(win32com.client.getevents("InternetExplorer.Application.1")):
+    ...    def OnVisible(self, Visible):
+    ...        print "Visibility changed: ", Visible
+    ...
+    >>>
+    >>> ie=win32com.client.Dispatch("InternetExplorer.Application.1")
+    >>> events=InternetExplorerEvents(ie)
+    >>> ie.Visible=1
+    Visibility changed:  1
+    >>>
+    """
+
+    # find clsid given progid or clsid
+    clsid = str(pywintypes.IID(clsid))
+    # return default outgoing interface for that class
+    klass = gencache.GetClassForCLSID(clsid)
+    try:
+        return klass.default_source
+    except AttributeError:
+        # See if we have a coclass for the interfaces.
+        try:
+            return gencache.GetClassForCLSID(klass.coclass_clsid).default_source
+        except AttributeError:
+            return None
+
+
+# A Record object, as used by the COM struct support
+def Record(name, object):
+    """Creates a new record object, given the name of the record,
+    and an object from the same type library.
+
+    Example usage would be:
+      app = win32com.client.Dispatch("Some.Application")
+      point = win32com.client.Record("SomeAppPoint", app)
+      point.x = 0
+      point.y = 0
+      app.MoveTo(point)
+    """
+    # XXX - to do - probably should allow "object" to already be a module object.
+    from . import gencache
+
+    object = gencache.EnsureDispatch(object)
+    module = sys.modules[object.__class__.__module__]
+    # to allow us to work correctly with "demand generated" code,
+    # we must use the typelib CLSID to obtain the module
+    # (otherwise we get the sub-module for the object, which
+    # does not hold the records)
+    # thus, package may be module, or may be module's parent if demand generated.
+    package = gencache.GetModuleForTypelib(
+        module.CLSID, module.LCID, module.MajorVersion, module.MinorVersion
+    )
+    try:
+        struct_guid = package.RecordMap[name]
+    except KeyError:
+        raise ValueError(
+            "The structure '%s' is not defined in module '%s'" % (name, package)
+        )
+    return pythoncom.GetRecordFromGuids(
+        module.CLSID, module.MajorVersion, module.MinorVersion, module.LCID, struct_guid
+    )
+
+
+############################################
+# The base of all makepy generated classes
+############################################
+class DispatchBaseClass:
+    def __init__(self, oobj=None):
+        if oobj is None:
+            oobj = pythoncom.new(self.CLSID)
+        elif isinstance(oobj, DispatchBaseClass):
+            try:
+                oobj = oobj._oleobj_.QueryInterface(
+                    self.CLSID, pythoncom.IID_IDispatch
+                )  # Must be a valid COM instance
+            except pythoncom.com_error as details:
+                import winerror
+
+                # Some stupid objects fail here, even tho it is _already_ IDispatch!!??
+                # Eg, Lotus notes.
+                # So just let it use the existing object if E_NOINTERFACE
+                if details.hresult != winerror.E_NOINTERFACE:
+                    raise
+                oobj = oobj._oleobj_
+        self.__dict__["_oleobj_"] = oobj  # so we dont call __setattr__
+
+    def __dir__(self):
+        lst = (
+            list(self.__dict__.keys())
+            + dir(self.__class__)
+            + list(self._prop_map_get_.keys())
+            + list(self._prop_map_put_.keys())
+        )
+        try:
+            lst += [p.Name for p in self.Properties_]
+        except AttributeError:
+            pass
+        return list(set(lst))
+
+    # Provide a prettier name than the CLSID
+    def __repr__(self):
+        # Need to get the docstring for the module for this class.
+        try:
+            mod_doc = sys.modules[self.__class__.__module__].__doc__
+            if mod_doc:
+                mod_name = "win32com.gen_py." + mod_doc
+            else:
+                mod_name = sys.modules[self.__class__.__module__].__name__
+        except KeyError:
+            mod_name = "win32com.gen_py.unknown"
+        return "<%s.%s instance at 0x%s>" % (
+            mod_name,
+            self.__class__.__name__,
+            id(self),
+        )
+
+    # Delegate comparison to the oleobjs, as they know how to do identity.
+    def __eq__(self, other):
+        other = getattr(other, "_oleobj_", other)
+        return self._oleobj_ == other
+
+    def __ne__(self, other):
+        other = getattr(other, "_oleobj_", other)
+        return self._oleobj_ != other
+
+    def _ApplyTypes_(self, dispid, wFlags, retType, argTypes, user, resultCLSID, *args):
+        return self._get_good_object_(
+            self._oleobj_.InvokeTypes(dispid, 0, wFlags, retType, argTypes, *args),
+            user,
+            resultCLSID,
+        )
+
+    def __getattr__(self, attr):
+        args = self._prop_map_get_.get(attr)
+        if args is None:
+            raise AttributeError(
+                "'%s' object has no attribute '%s'" % (repr(self), attr)
+            )
+        return self._ApplyTypes_(*args)
+
+    def __setattr__(self, attr, value):
+        if attr in self.__dict__:
+            self.__dict__[attr] = value
+            return
+        try:
+            args, defArgs = self._prop_map_put_[attr]
+        except KeyError:
+            raise AttributeError(
+                "'%s' object has no attribute '%s'" % (repr(self), attr)
+            )
+        self._oleobj_.Invoke(*(args + (value,) + defArgs))
+
+    def _get_good_single_object_(self, obj, obUserName=None, resultCLSID=None):
+        return _get_good_single_object_(obj, obUserName, resultCLSID)
+
+    def _get_good_object_(self, obj, obUserName=None, resultCLSID=None):
+        return _get_good_object_(obj, obUserName, resultCLSID)
+
+
+# XXX - These should be consolidated with dynamic.py versions.
+def _get_good_single_object_(obj, obUserName=None, resultCLSID=None):
+    if _PyIDispatchType == type(obj):
+        return Dispatch(obj, obUserName, resultCLSID)
+    return obj
+
+
+def _get_good_object_(obj, obUserName=None, resultCLSID=None):
+    if obj is None:
+        return None
+    elif isinstance(obj, tuple):
+        obUserNameTuple = (obUserName,) * len(obj)
+        resultCLSIDTuple = (resultCLSID,) * len(obj)
+        return tuple(map(_get_good_object_, obj, obUserNameTuple, resultCLSIDTuple))
+    else:
+        return _get_good_single_object_(obj, obUserName, resultCLSID)
+
+
+class CoClassBaseClass:
+    def __init__(self, oobj=None):
+        if oobj is None:
+            oobj = pythoncom.new(self.CLSID)
+        dispobj = self.__dict__["_dispobj_"] = self.default_interface(oobj)
+        # See comments below re the special methods.
+        for maybe in [
+            "__call__",
+            "__str__",
+            "__int__",
+            "__iter__",
+            "__len__",
+            "__nonzero__",
+        ]:
+            if hasattr(dispobj, maybe):
+                setattr(self, maybe, getattr(self, "__maybe" + maybe))
+
+    def __repr__(self):
+        return "<win32com.gen_py.%s.%s>" % (__doc__, self.__class__.__name__)
+
+    def __getattr__(self, attr):
+        d = self.__dict__["_dispobj_"]
+        if d is not None:
+            return getattr(d, attr)
+        raise AttributeError(attr)
+
+    def __setattr__(self, attr, value):
+        if attr in self.__dict__:
+            self.__dict__[attr] = value
+            return
+        try:
+            d = self.__dict__["_dispobj_"]
+            if d is not None:
+                d.__setattr__(attr, value)
+                return
+        except AttributeError:
+            pass
+        self.__dict__[attr] = value
+
+        # Special methods don't use __getattr__ etc, so explicitly delegate here.
+        # Note however, that not all are safe to let bubble up - things like
+        # `bool(ob)` will break if the object defines __int__ but then raises an
+        # attribute error - eg, see #1753.
+        # It depends on what the wrapped COM object actually defines whether these
+        # will exist on the underlying object, so __init__ explicitly checks if they
+        # do and if so, wires them up.
+
+    def __maybe__call__(self, *args, **kwargs):
+        return self.__dict__["_dispobj_"].__call__(*args, **kwargs)
+
+    def __maybe__str__(self, *args):
+        return self.__dict__["_dispobj_"].__str__(*args)
+
+    def __maybe__int__(self, *args):
+        return self.__dict__["_dispobj_"].__int__(*args)
+
+    def __maybe__iter__(self):
+        return self.__dict__["_dispobj_"].__iter__()
+
+    def __maybe__len__(self):
+        return self.__dict__["_dispobj_"].__len__()
+
+    def __maybe__nonzero__(self):
+        return self.__dict__["_dispobj_"].__nonzero__()
+
+
+# A very simple VARIANT class.  Only to be used with poorly-implemented COM
+# objects.  If an object accepts an arg which is a simple "VARIANT", but still
+# is very pickly about the actual variant type (eg, isn't happy with a VT_I4,
+# which it would get from a Python integer), you can use this to force a
+# particular VT.
+class VARIANT(object):
+    def __init__(self, vt, value):
+        self.varianttype = vt
+        self._value = value
+
+    # 'value' is a property so when set by pythoncom it gets any magic wrapping
+    # which normally happens for result objects
+    def _get_value(self):
+        return self._value
+
+    def _set_value(self, newval):
+        self._value = _get_good_object_(newval)
+
+    def _del_value(self):
+        del self._value
+
+    value = property(_get_value, _set_value, _del_value)
+
+    def __repr__(self):
+        return "win32com.client.VARIANT(%r, %r)" % (self.varianttype, self._value)
diff --git a/lib/win32com/client/build.py b/lib/win32com/client/build.py
new file mode 100644
index 00000000..ce4e2e4a
--- /dev/null
+++ b/lib/win32com/client/build.py
@@ -0,0 +1,789 @@
+"""Contains knowledge to build a COM object definition.
+
+This module is used by both the @dynamic@ and @makepy@ modules to build
+all knowledge of a COM object.
+
+This module contains classes which contain the actual knowledge of the object.
+This include parameter and return type information, the COM dispid and CLSID, etc.
+
+Other modules may use this information to generate .py files, use the information
+dynamically, or possibly even generate .html documentation for objects.
+"""
+
+#
+# NOTES: DispatchItem and MapEntry used by dynamic.py.
+#        the rest is used by makepy.py
+#
+#        OleItem, DispatchItem, MapEntry, BuildCallList() is used by makepy
+
+import datetime
+import string
+import sys
+from keyword import iskeyword
+
+import pythoncom
+import winerror
+from pywintypes import TimeType
+
+
+# It isn't really clear what the quoting rules are in a C/IDL string and
+# literals like a quote char and backslashes makes life a little painful to
+# always render the string perfectly - so just punt and fall-back to a repr()
+def _makeDocString(s):
+    if sys.version_info < (3,):
+        s = s.encode("mbcs")
+    return repr(s)
+
+
+error = "PythonCOM.Client.Build error"
+
+
+class NotSupportedException(Exception):
+    pass  # Raised when we cant support a param type.
+
+
+DropIndirection = "DropIndirection"
+
+NoTranslateTypes = [
+    pythoncom.VT_BOOL,
+    pythoncom.VT_CLSID,
+    pythoncom.VT_CY,
+    pythoncom.VT_DATE,
+    pythoncom.VT_DECIMAL,
+    pythoncom.VT_EMPTY,
+    pythoncom.VT_ERROR,
+    pythoncom.VT_FILETIME,
+    pythoncom.VT_HRESULT,
+    pythoncom.VT_I1,
+    pythoncom.VT_I2,
+    pythoncom.VT_I4,
+    pythoncom.VT_I8,
+    pythoncom.VT_INT,
+    pythoncom.VT_NULL,
+    pythoncom.VT_R4,
+    pythoncom.VT_R8,
+    pythoncom.VT_NULL,
+    pythoncom.VT_STREAM,
+    pythoncom.VT_UI1,
+    pythoncom.VT_UI2,
+    pythoncom.VT_UI4,
+    pythoncom.VT_UI8,
+    pythoncom.VT_UINT,
+    pythoncom.VT_VOID,
+]
+
+NoTranslateMap = {}
+for v in NoTranslateTypes:
+    NoTranslateMap[v] = None
+
+
+class MapEntry:
+    "Simple holder for named attibutes - items in a map."
+
+    def __init__(
+        self,
+        desc_or_id,
+        names=None,
+        doc=None,
+        resultCLSID=pythoncom.IID_NULL,
+        resultDoc=None,
+        hidden=0,
+    ):
+        if type(desc_or_id) == type(0):
+            self.dispid = desc_or_id
+            self.desc = None
+        else:
+            self.dispid = desc_or_id[0]
+            self.desc = desc_or_id
+
+        self.names = names
+        self.doc = doc
+        self.resultCLSID = resultCLSID
+        self.resultDocumentation = resultDoc
+        self.wasProperty = (
+            0  # Have I been transformed into a function so I can pass args?
+        )
+        self.hidden = hidden
+
+    def __repr__(self):
+        return (
+            "MapEntry(dispid={s.dispid}, desc={s.desc}, names={s.names}, doc={s.doc!r}, "
+            "resultCLSID={s.resultCLSID}, resultDocumentation={s.resultDocumentation}, "
+            "wasProperty={s.wasProperty}, hidden={s.hidden}"
+        ).format(s=self)
+
+    def GetResultCLSID(self):
+        rc = self.resultCLSID
+        if rc == pythoncom.IID_NULL:
+            return None
+        return rc
+
+    # Return a string, suitable for output - either "'{...}'" or "None"
+    def GetResultCLSIDStr(self):
+        rc = self.GetResultCLSID()
+        if rc is None:
+            return "None"
+        return repr(
+            str(rc)
+        )  # Convert the IID object to a string, then to a string in a string.
+
+    def GetResultName(self):
+        if self.resultDocumentation is None:
+            return None
+        return self.resultDocumentation[0]
+
+
+class OleItem:
+    typename = "OleItem"
+
+    def __init__(self, doc=None):
+        self.doc = doc
+        if self.doc:
+            self.python_name = MakePublicAttributeName(self.doc[0])
+        else:
+            self.python_name = None
+        self.bWritten = 0
+        self.bIsDispatch = 0
+        self.bIsSink = 0
+        self.clsid = None
+        self.co_class = None
+
+
+class DispatchItem(OleItem):
+    typename = "DispatchItem"
+
+    def __init__(self, typeinfo=None, attr=None, doc=None, bForUser=1):
+        OleItem.__init__(self, doc)
+        self.propMap = {}
+        self.propMapGet = {}
+        self.propMapPut = {}
+        self.mapFuncs = {}
+        self.defaultDispatchName = None
+        self.hidden = 0
+
+        if typeinfo:
+            self.Build(typeinfo, attr, bForUser)
+
+    def _propMapPutCheck_(self, key, item):
+        ins, outs, opts = self.CountInOutOptArgs(item.desc[2])
+        if ins > 1:  # if a Put property takes more than 1 arg:
+            if opts + 1 == ins or ins == item.desc[6] + 1:
+                newKey = "Set" + key
+                deleteExisting = 0  # This one is still OK
+            else:
+                deleteExisting = 1  # No good to us
+                if key in self.mapFuncs or key in self.propMapGet:
+                    newKey = "Set" + key
+                else:
+                    newKey = key
+            item.wasProperty = 1
+            self.mapFuncs[newKey] = item
+            if deleteExisting:
+                del self.propMapPut[key]
+
+    def _propMapGetCheck_(self, key, item):
+        ins, outs, opts = self.CountInOutOptArgs(item.desc[2])
+        if ins > 0:  # if a Get property takes _any_ in args:
+            if item.desc[6] == ins or ins == opts:
+                newKey = "Get" + key
+                deleteExisting = 0  # This one is still OK
+            else:
+                deleteExisting = 1  # No good to us
+                if key in self.mapFuncs:
+                    newKey = "Get" + key
+                else:
+                    newKey = key
+            item.wasProperty = 1
+            self.mapFuncs[newKey] = item
+            if deleteExisting:
+                del self.propMapGet[key]
+
+    def _AddFunc_(self, typeinfo, fdesc, bForUser):
+        assert fdesc.desckind == pythoncom.DESCKIND_FUNCDESC
+        id = fdesc.memid
+        funcflags = fdesc.wFuncFlags
+        try:
+            names = typeinfo.GetNames(id)
+            name = names[0]
+        except pythoncom.ole_error:
+            name = ""
+            names = None
+
+        doc = None
+        try:
+            if bForUser:
+                doc = typeinfo.GetDocumentation(id)
+        except pythoncom.ole_error:
+            pass
+
+        if id == 0 and name:
+            self.defaultDispatchName = name
+
+        invkind = fdesc.invkind
+
+        # We need to translate any Alias', Enums, structs etc in result and args
+        typerepr, flag, defval = fdesc.rettype
+        # 		sys.stderr.write("%s result - %s -> " % (name, typerepr))
+        typerepr, resultCLSID, resultDoc = _ResolveType(typerepr, typeinfo)
+        # 		sys.stderr.write("%s\n" % (typerepr,))
+        fdesc.rettype = typerepr, flag, defval, resultCLSID
+        # Translate any Alias or Enums in argument list.
+        argList = []
+        for argDesc in fdesc.args:
+            typerepr, flag, defval = argDesc
+            # 			sys.stderr.write("%s arg - %s -> " % (name, typerepr))
+            arg_type, arg_clsid, arg_doc = _ResolveType(typerepr, typeinfo)
+            argDesc = arg_type, flag, defval, arg_clsid
+            # 			sys.stderr.write("%s\n" % (argDesc[0],))
+            argList.append(argDesc)
+        fdesc.args = tuple(argList)
+
+        hidden = (funcflags & pythoncom.FUNCFLAG_FHIDDEN) != 0
+        if invkind == pythoncom.INVOKE_PROPERTYGET:
+            map = self.propMapGet
+        # This is not the best solution, but I dont think there is
+        # one without specific "set" syntax.
+        # If there is a single PUT or PUTREF, it will function as a property.
+        # If there are both, then the PUT remains a property, and the PUTREF
+        # gets transformed into a function.
+        # (in vb, PUT=="obj=other_obj", PUTREF="set obj=other_obj
+        elif invkind in (pythoncom.INVOKE_PROPERTYPUT, pythoncom.INVOKE_PROPERTYPUTREF):
+            # Special case
+            existing = self.propMapPut.get(name, None)
+            if existing is not None:
+                if existing.desc[4] == pythoncom.INVOKE_PROPERTYPUT:  # Keep this one
+                    map = self.mapFuncs
+                    name = "Set" + name
+                else:  # Existing becomes a func.
+                    existing.wasProperty = 1
+                    self.mapFuncs["Set" + name] = existing
+                    map = self.propMapPut  # existing gets overwritten below.
+            else:
+                map = self.propMapPut  # first time weve seen it.
+
+        elif invkind == pythoncom.INVOKE_FUNC:
+            map = self.mapFuncs
+        else:
+            map = None
+        if not map is None:
+            # 				if map.has_key(name):
+            # 					sys.stderr.write("Warning - overwriting existing method/attribute %s\n" % name)
+            map[name] = MapEntry(fdesc, names, doc, resultCLSID, resultDoc, hidden)
+            # any methods that can't be reached via DISPATCH we return None
+            # for, so dynamic dispatch doesnt see it.
+            if fdesc.funckind != pythoncom.FUNC_DISPATCH:
+                return None
+            return (name, map)
+        return None
+
+    def _AddVar_(self, typeinfo, vardesc, bForUser):
+        ### need pythoncom.VARFLAG_FRESTRICTED ...
+        ### then check it
+        assert vardesc.desckind == pythoncom.DESCKIND_VARDESC
+
+        if vardesc.varkind == pythoncom.VAR_DISPATCH:
+            id = vardesc.memid
+            names = typeinfo.GetNames(id)
+            # Translate any Alias or Enums in result.
+            typerepr, flags, defval = vardesc.elemdescVar
+            typerepr, resultCLSID, resultDoc = _ResolveType(typerepr, typeinfo)
+            vardesc.elemdescVar = typerepr, flags, defval
+            doc = None
+            try:
+                if bForUser:
+                    doc = typeinfo.GetDocumentation(id)
+            except pythoncom.ole_error:
+                pass
+
+            # handle the enumerator specially
+            map = self.propMap
+            # Check if the element is hidden.
+            hidden = (vardesc.wVarFlags & 0x40) != 0  # VARFLAG_FHIDDEN
+            map[names[0]] = MapEntry(
+                vardesc, names, doc, resultCLSID, resultDoc, hidden
+            )
+            return (names[0], map)
+        else:
+            return None
+
+    def Build(self, typeinfo, attr, bForUser=1):
+        self.clsid = attr[0]
+        self.bIsDispatch = (attr.wTypeFlags & pythoncom.TYPEFLAG_FDISPATCHABLE) != 0
+        if typeinfo is None:
+            return
+        # Loop over all methods
+        for j in range(attr[6]):
+            fdesc = typeinfo.GetFuncDesc(j)
+            self._AddFunc_(typeinfo, fdesc, bForUser)
+
+        # Loop over all variables (ie, properties)
+        for j in range(attr[7]):
+            fdesc = typeinfo.GetVarDesc(j)
+            self._AddVar_(typeinfo, fdesc, bForUser)
+
+        # Now post-process the maps.  For any "Get" or "Set" properties
+        # that have arguments, we must turn them into methods.  If a method
+        # of the same name already exists, change the name.
+        for key, item in list(self.propMapGet.items()):
+            self._propMapGetCheck_(key, item)
+
+        for key, item in list(self.propMapPut.items()):
+            self._propMapPutCheck_(key, item)
+
+    def CountInOutOptArgs(self, argTuple):
+        "Return tuple counting in/outs/OPTS.  Sum of result may not be len(argTuple), as some args may be in/out."
+        ins = out = opts = 0
+        for argCheck in argTuple:
+            inOut = argCheck[1]
+            if inOut == 0:
+                ins = ins + 1
+                out = out + 1
+            else:
+                if inOut & pythoncom.PARAMFLAG_FIN:
+                    ins = ins + 1
+                if inOut & pythoncom.PARAMFLAG_FOPT:
+                    opts = opts + 1
+                if inOut & pythoncom.PARAMFLAG_FOUT:
+                    out = out + 1
+        return ins, out, opts
+
+    def MakeFuncMethod(self, entry, name, bMakeClass=1):
+        # If we have a type description, and not varargs...
+        if entry.desc is not None and (len(entry.desc) < 6 or entry.desc[6] != -1):
+            return self.MakeDispatchFuncMethod(entry, name, bMakeClass)
+        else:
+            return self.MakeVarArgsFuncMethod(entry, name, bMakeClass)
+
+    def MakeDispatchFuncMethod(self, entry, name, bMakeClass=1):
+        fdesc = entry.desc
+        doc = entry.doc
+        names = entry.names
+        ret = []
+        if bMakeClass:
+            linePrefix = "\t"
+            defNamedOptArg = "defaultNamedOptArg"
+            defNamedNotOptArg = "defaultNamedNotOptArg"
+            defUnnamedArg = "defaultUnnamedArg"
+        else:
+            linePrefix = ""
+            defNamedOptArg = "pythoncom.Missing"
+            defNamedNotOptArg = "pythoncom.Missing"
+            defUnnamedArg = "pythoncom.Missing"
+        defOutArg = "pythoncom.Missing"
+        id = fdesc[0]
+
+        s = (
+            linePrefix
+            + "def "
+            + name
+            + "(self"
+            + BuildCallList(
+                fdesc,
+                names,
+                defNamedOptArg,
+                defNamedNotOptArg,
+                defUnnamedArg,
+                defOutArg,
+            )
+            + "):"
+        )
+        ret.append(s)
+        if doc and doc[1]:
+            ret.append(linePrefix + "\t" + _makeDocString(doc[1]))
+
+        resclsid = entry.GetResultCLSID()
+        if resclsid:
+            resclsid = "'%s'" % resclsid
+        else:
+            resclsid = "None"
+        # Strip the default values from the arg desc
+        retDesc = fdesc[8][:2]
+        argsDesc = tuple([what[:2] for what in fdesc[2]])
+        # The runtime translation of the return types is expensive, so when we know the
+        # return type of the function, there is no need to check the type at runtime.
+        # To qualify, this function must return a "simple" type, and have no byref args.
+        # Check if we have byrefs or anything in the args which mean we still need a translate.
+        param_flags = [what[1] for what in fdesc[2]]
+        bad_params = [
+            flag
+            for flag in param_flags
+            if flag & (pythoncom.PARAMFLAG_FOUT | pythoncom.PARAMFLAG_FRETVAL) != 0
+        ]
+        s = None
+        if len(bad_params) == 0 and len(retDesc) == 2 and retDesc[1] == 0:
+            rd = retDesc[0]
+            if rd in NoTranslateMap:
+                s = "%s\treturn self._oleobj_.InvokeTypes(%d, LCID, %s, %s, %s%s)" % (
+                    linePrefix,
+                    id,
+                    fdesc[4],
+                    retDesc,
+                    argsDesc,
+                    _BuildArgList(fdesc, names),
+                )
+            elif rd in [pythoncom.VT_DISPATCH, pythoncom.VT_UNKNOWN]:
+                s = "%s\tret = self._oleobj_.InvokeTypes(%d, LCID, %s, %s, %s%s)\n" % (
+                    linePrefix,
+                    id,
+                    fdesc[4],
+                    retDesc,
+                    repr(argsDesc),
+                    _BuildArgList(fdesc, names),
+                )
+                s = s + "%s\tif ret is not None:\n" % (linePrefix,)
+                if rd == pythoncom.VT_UNKNOWN:
+                    s = s + "%s\t\t# See if this IUnknown is really an IDispatch\n" % (
+                        linePrefix,
+                    )
+                    s = s + "%s\t\ttry:\n" % (linePrefix,)
+                    s = (
+                        s
+                        + "%s\t\t\tret = ret.QueryInterface(pythoncom.IID_IDispatch)\n"
+                        % (linePrefix,)
+                    )
+                    s = s + "%s\t\texcept pythoncom.error:\n" % (linePrefix,)
+                    s = s + "%s\t\t\treturn ret\n" % (linePrefix,)
+                s = s + "%s\t\tret = Dispatch(ret, %s, %s)\n" % (
+                    linePrefix,
+                    repr(name),
+                    resclsid,
+                )
+                s = s + "%s\treturn ret" % (linePrefix)
+            elif rd == pythoncom.VT_BSTR:
+                s = "%s\t# Result is a Unicode object\n" % (linePrefix,)
+                s = (
+                    s
+                    + "%s\treturn self._oleobj_.InvokeTypes(%d, LCID, %s, %s, %s%s)"
+                    % (
+                        linePrefix,
+                        id,
+                        fdesc[4],
+                        retDesc,
+                        repr(argsDesc),
+                        _BuildArgList(fdesc, names),
+                    )
+                )
+            # else s remains None
+        if s is None:
+            s = "%s\treturn self._ApplyTypes_(%d, %s, %s, %s, %s, %s%s)" % (
+                linePrefix,
+                id,
+                fdesc[4],
+                retDesc,
+                argsDesc,
+                repr(name),
+                resclsid,
+                _BuildArgList(fdesc, names),
+            )
+
+        ret.append(s)
+        ret.append("")
+        return ret
+
+    def MakeVarArgsFuncMethod(self, entry, name, bMakeClass=1):
+        fdesc = entry.desc
+        names = entry.names
+        doc = entry.doc
+        ret = []
+        argPrefix = "self"
+        if bMakeClass:
+            linePrefix = "\t"
+        else:
+            linePrefix = ""
+        ret.append(linePrefix + "def " + name + "(" + argPrefix + ", *args):")
+        if doc and doc[1]:
+            ret.append(linePrefix + "\t" + _makeDocString(doc[1]))
+        if fdesc:
+            invoketype = fdesc[4]
+        else:
+            invoketype = pythoncom.DISPATCH_METHOD
+        s = linePrefix + "\treturn self._get_good_object_(self._oleobj_.Invoke(*(("
+        ret.append(
+            s + str(entry.dispid) + ",0,%d,1)+args)),'%s')" % (invoketype, names[0])
+        )
+        ret.append("")
+        return ret
+
+
+# Note - "DispatchItem" poorly named - need a new intermediate class.
+class VTableItem(DispatchItem):
+    def Build(self, typeinfo, attr, bForUser=1):
+        DispatchItem.Build(self, typeinfo, attr, bForUser)
+        assert typeinfo is not None, "Cant build vtables without type info!"
+
+        meth_list = (
+            list(self.mapFuncs.values())
+            + list(self.propMapGet.values())
+            + list(self.propMapPut.values())
+        )
+        meth_list.sort(key=lambda m: m.desc[7])
+
+        # Now turn this list into the run-time representation
+        # (ready for immediate use or writing to gencache)
+        self.vtableFuncs = []
+        for entry in meth_list:
+            self.vtableFuncs.append((entry.names, entry.dispid, entry.desc))
+
+
+# A Lazy dispatch item - builds an item on request using info from
+# an ITypeComp.  The dynamic module makes the called to build each item,
+# and also holds the references to the typeinfo and typecomp.
+class LazyDispatchItem(DispatchItem):
+    typename = "LazyDispatchItem"
+
+    def __init__(self, attr, doc):
+        self.clsid = attr[0]
+        DispatchItem.__init__(self, None, attr, doc, 0)
+
+
+typeSubstMap = {
+    pythoncom.VT_INT: pythoncom.VT_I4,
+    pythoncom.VT_UINT: pythoncom.VT_UI4,
+    pythoncom.VT_HRESULT: pythoncom.VT_I4,
+}
+
+
+def _ResolveType(typerepr, itypeinfo):
+    # Resolve VT_USERDEFINED (often aliases or typed IDispatches)
+
+    if type(typerepr) == tuple:
+        indir_vt, subrepr = typerepr
+        if indir_vt == pythoncom.VT_PTR:
+            # If it is a VT_PTR to a VT_USERDEFINED that is an IDispatch/IUnknown,
+            # then it resolves to simply the object.
+            # Otherwise, it becomes a ByRef of the resolved type
+            # We need to drop an indirection level on pointer to user defined interfaces.
+            # eg, (VT_PTR, (VT_USERDEFINED, somehandle)) needs to become VT_DISPATCH
+            # only when "somehandle" is an object.
+            # but (VT_PTR, (VT_USERDEFINED, otherhandle)) doesnt get the indirection dropped.
+            was_user = type(subrepr) == tuple and subrepr[0] == pythoncom.VT_USERDEFINED
+            subrepr, sub_clsid, sub_doc = _ResolveType(subrepr, itypeinfo)
+            if was_user and subrepr in [
+                pythoncom.VT_DISPATCH,
+                pythoncom.VT_UNKNOWN,
+                pythoncom.VT_RECORD,
+            ]:
+                # Drop the VT_PTR indirection
+                return subrepr, sub_clsid, sub_doc
+            # Change PTR indirection to byref
+            return subrepr | pythoncom.VT_BYREF, sub_clsid, sub_doc
+        if indir_vt == pythoncom.VT_SAFEARRAY:
+            # resolve the array element, and convert to VT_ARRAY
+            subrepr, sub_clsid, sub_doc = _ResolveType(subrepr, itypeinfo)
+            return pythoncom.VT_ARRAY | subrepr, sub_clsid, sub_doc
+        if indir_vt == pythoncom.VT_CARRAY:  # runtime has no support for this yet.
+            # resolve the array element, and convert to VT_CARRAY
+            # sheesh - return _something_
+            return pythoncom.VT_CARRAY, None, None
+        if indir_vt == pythoncom.VT_USERDEFINED:
+            try:
+                resultTypeInfo = itypeinfo.GetRefTypeInfo(subrepr)
+            except pythoncom.com_error as details:
+                if details.hresult in [
+                    winerror.TYPE_E_CANTLOADLIBRARY,
+                    winerror.TYPE_E_LIBNOTREGISTERED,
+                ]:
+                    # an unregistered interface
+                    return pythoncom.VT_UNKNOWN, None, None
+                raise
+
+            resultAttr = resultTypeInfo.GetTypeAttr()
+            typeKind = resultAttr.typekind
+            if typeKind == pythoncom.TKIND_ALIAS:
+                tdesc = resultAttr.tdescAlias
+                return _ResolveType(tdesc, resultTypeInfo)
+            elif typeKind in [pythoncom.TKIND_ENUM, pythoncom.TKIND_MODULE]:
+                # For now, assume Long
+                return pythoncom.VT_I4, None, None
+
+            elif typeKind == pythoncom.TKIND_DISPATCH:
+                clsid = resultTypeInfo.GetTypeAttr()[0]
+                retdoc = resultTypeInfo.GetDocumentation(-1)
+                return pythoncom.VT_DISPATCH, clsid, retdoc
+
+            elif typeKind in [pythoncom.TKIND_INTERFACE, pythoncom.TKIND_COCLASS]:
+                # XXX - should probably get default interface for CO_CLASS???
+                clsid = resultTypeInfo.GetTypeAttr()[0]
+                retdoc = resultTypeInfo.GetDocumentation(-1)
+                return pythoncom.VT_UNKNOWN, clsid, retdoc
+
+            elif typeKind == pythoncom.TKIND_RECORD:
+                return pythoncom.VT_RECORD, None, None
+            raise NotSupportedException("Can not resolve alias or user-defined type")
+    return typeSubstMap.get(typerepr, typerepr), None, None
+
+
+def _BuildArgList(fdesc, names):
+    "Builds list of args to the underlying Invoke method."
+    # Word has TypeInfo for Insert() method, but says "no args"
+    numArgs = max(fdesc[6], len(fdesc[2]))
+    names = list(names)
+    while None in names:
+        i = names.index(None)
+        names[i] = "arg%d" % (i,)
+    # We've seen 'source safe' libraries offer the name of 'ret' params in
+    # 'names' - although we can't reproduce this, it would be insane to offer
+    # more args than we have arg infos for - hence the upper limit on names...
+    names = list(map(MakePublicAttributeName, names[1 : (numArgs + 1)]))
+    name_num = 0
+    while len(names) < numArgs:
+        names.append("arg%d" % (len(names),))
+    # As per BuildCallList(), avoid huge lines.
+    # Hack a "\n" at the end of every 5th name - "strides" would be handy
+    # here but don't exist in 2.2
+    for i in range(0, len(names), 5):
+        names[i] = names[i] + "\n\t\t\t"
+    return "," + ", ".join(names)
+
+
+valid_identifier_chars = string.ascii_letters + string.digits + "_"
+
+
+def demunge_leading_underscores(className):
+    i = 0
+    while className[i] == "_":
+        i += 1
+    assert i >= 2, "Should only be here with names starting with '__'"
+    return className[i - 1 :] + className[: i - 1]
+
+
+# Given a "public name" (eg, the name of a class, function, etc)
+# make sure it is a legal (and reasonable!) Python name.
+def MakePublicAttributeName(className, is_global=False):
+    # Given a class attribute that needs to be public, convert it to a
+    # reasonable name.
+    # Also need to be careful that the munging doesnt
+    # create duplicates - eg, just removing a leading "_" is likely to cause
+    # a clash.
+    # if is_global is True, then the name is a global variable that may
+    # overwrite a builtin - eg, "None"
+    if className[:2] == "__":
+        return demunge_leading_underscores(className)
+    elif className == "None":
+        # assign to None is evil (and SyntaxError in 2.4, even though
+        # iskeyword says False there) - note that if it was a global
+        # it would get picked up below
+        className = "NONE"
+    elif iskeyword(className):
+        # most keywords are lower case (except True, False etc in py3k)
+        ret = className.capitalize()
+        # but those which aren't get forced upper.
+        if ret == className:
+            ret = ret.upper()
+        return ret
+    elif is_global and hasattr(__builtins__, className):
+        # builtins may be mixed case.  If capitalizing it doesn't change it,
+        # force to all uppercase (eg, "None", "True" become "NONE", "TRUE"
+        ret = className.capitalize()
+        if ret == className:  # didn't change - force all uppercase.
+            ret = ret.upper()
+        return ret
+    # Strip non printable chars
+    return "".join([char for char in className if char in valid_identifier_chars])
+
+
+# Given a default value passed by a type library, return a string with
+# an appropriate repr() for the type.
+# Takes a raw ELEMDESC and returns a repr string, or None
+# (NOTE: The string itself may be '"None"', which is valid, and different to None.
+# XXX - To do: Dates are probably screwed, but can they come in?
+def MakeDefaultArgRepr(defArgVal):
+    try:
+        inOut = defArgVal[1]
+    except IndexError:
+        # something strange - assume is in param.
+        inOut = pythoncom.PARAMFLAG_FIN
+
+    if inOut & pythoncom.PARAMFLAG_FHASDEFAULT:
+        # times need special handling...
+        val = defArgVal[2]
+        if isinstance(val, datetime.datetime):
+            # VARIANT <-> SYSTEMTIME conversions always lose any sub-second
+            # resolution, so just use a 'timetuple' here.
+            return repr(tuple(val.utctimetuple()))
+        if type(val) is TimeType:
+            # must be the 'old' pywintypes time object...
+            year = val.year
+            month = val.month
+            day = val.day
+            hour = val.hour
+            minute = val.minute
+            second = val.second
+            msec = val.msec
+            return (
+                "pywintypes.Time((%(year)d, %(month)d, %(day)d, %(hour)d, %(minute)d, %(second)d,0,0,0,%(msec)d))"
+                % locals()
+            )
+        return repr(val)
+    return None
+
+
+def BuildCallList(
+    fdesc,
+    names,
+    defNamedOptArg,
+    defNamedNotOptArg,
+    defUnnamedArg,
+    defOutArg,
+    is_comment=False,
+):
+    "Builds a Python declaration for a method."
+    # Names[0] is the func name - param names are from 1.
+    numArgs = len(fdesc[2])
+    numOptArgs = fdesc[6]
+    strval = ""
+    if numOptArgs == -1:  # Special value that says "var args after here"
+        firstOptArg = numArgs
+        numArgs = numArgs - 1
+    else:
+        firstOptArg = numArgs - numOptArgs
+    for arg in range(numArgs):
+        try:
+            argName = names[arg + 1]
+            namedArg = argName is not None
+        except IndexError:
+            namedArg = 0
+        if not namedArg:
+            argName = "arg%d" % (arg)
+        thisdesc = fdesc[2][arg]
+        # See if the IDL specified a default value
+        defArgVal = MakeDefaultArgRepr(thisdesc)
+        if defArgVal is None:
+            # Out params always get their special default
+            if (
+                thisdesc[1] & (pythoncom.PARAMFLAG_FOUT | pythoncom.PARAMFLAG_FIN)
+                == pythoncom.PARAMFLAG_FOUT
+            ):
+                defArgVal = defOutArg
+            else:
+                # Unnamed arg - always allow default values.
+                if namedArg:
+                    # Is a named argument
+                    if arg >= firstOptArg:
+                        defArgVal = defNamedOptArg
+                    else:
+                        defArgVal = defNamedNotOptArg
+                else:
+                    defArgVal = defUnnamedArg
+
+        argName = MakePublicAttributeName(argName)
+        # insanely long lines with an 'encoding' flag crashes python 2.4.0
+        # keep 5 args per line
+        # This may still fail if the arg names are insane, but that seems
+        # unlikely.  See also _BuildArgList()
+        if (arg + 1) % 5 == 0:
+            strval = strval + "\n"
+            if is_comment:
+                strval = strval + "#"
+            strval = strval + "\t\t\t"
+        strval = strval + ", " + argName
+        if defArgVal:
+            strval = strval + "=" + defArgVal
+    if numOptArgs == -1:
+        strval = strval + ", *" + names[-1]
+
+    return strval
+
+
+if __name__ == "__main__":
+    print("Use 'makepy.py' to generate Python code - this module is just a helper")
diff --git a/lib/win32com/client/combrowse.py b/lib/win32com/client/combrowse.py
new file mode 100644
index 00000000..10eeaedf
--- /dev/null
+++ b/lib/win32com/client/combrowse.py
@@ -0,0 +1,619 @@
+"""A utility for browsing COM objects.
+
+ Usage:
+
+  Command Prompt
+
+    Use the command *"python.exe combrowse.py"*.  This will display
+    display a fairly small, modal dialog.
+
+  Pythonwin
+
+    Use the "Run Script" menu item, and this will create the browser in an
+    MDI window.  This window can be fully resized.
+
+ Details
+
+   This module allows browsing of registered Type Libraries, COM categories,
+   and running COM objects.  The display is similar to the Pythonwin object
+   browser, and displays the objects in a hierarchical window.
+
+   Note that this module requires the win32ui (ie, Pythonwin) distribution to
+   work.
+
+"""
+import sys
+
+import pythoncom
+import win32api
+import win32con
+import win32ui
+from pywin.tools import browser
+from win32com.client import util
+
+
+class HLIRoot(browser.HLIPythonObject):
+    def __init__(self, title):
+        super().__init__(name=title)
+
+    def GetSubList(self):
+        return [
+            HLIHeadingCategory(),
+            HLI_IEnumMoniker(
+                pythoncom.GetRunningObjectTable().EnumRunning(), "Running Objects"
+            ),
+            HLIHeadingRegisterdTypeLibs(),
+        ]
+
+    def __cmp__(self, other):
+        return cmp(self.name, other.name)
+
+
+class HLICOM(browser.HLIPythonObject):
+    def GetText(self):
+        return self.name
+
+    def CalculateIsExpandable(self):
+        return 1
+
+
+class HLICLSID(HLICOM):
+    def __init__(self, myobject, name=None):
+        if type(myobject) == type(""):
+            myobject = pythoncom.MakeIID(myobject)
+        if name is None:
+            try:
+                name = pythoncom.ProgIDFromCLSID(myobject)
+            except pythoncom.com_error:
+                name = str(myobject)
+            name = "IID: " + name
+        HLICOM.__init__(self, myobject, name)
+
+    def CalculateIsExpandable(self):
+        return 0
+
+    def GetSubList(self):
+        return []
+
+
+class HLI_Interface(HLICOM):
+    pass
+
+
+class HLI_Enum(HLI_Interface):
+    def GetBitmapColumn(self):
+        return 0  # Always a folder.
+
+    def CalculateIsExpandable(self):
+        if self.myobject is not None:
+            rc = len(self.myobject.Next(1)) > 0
+            self.myobject.Reset()
+        else:
+            rc = 0
+        return rc
+
+    pass
+
+
+class HLI_IEnumMoniker(HLI_Enum):
+    def GetSubList(self):
+        ctx = pythoncom.CreateBindCtx()
+        ret = []
+        for mon in util.Enumerator(self.myobject):
+            ret.append(HLI_IMoniker(mon, mon.GetDisplayName(ctx, None)))
+        return ret
+
+
+class HLI_IMoniker(HLI_Interface):
+    def GetSubList(self):
+        ret = []
+        ret.append(browser.MakeHLI(self.myobject.Hash(), "Hash Value"))
+        subenum = self.myobject.Enum(1)
+        ret.append(HLI_IEnumMoniker(subenum, "Sub Monikers"))
+        return ret
+
+
+class HLIHeadingCategory(HLICOM):
+    "A tree heading for registered categories"
+
+    def GetText(self):
+        return "Registered Categories"
+
+    def GetSubList(self):
+        catinf = pythoncom.CoCreateInstance(
+            pythoncom.CLSID_StdComponentCategoriesMgr,
+            None,
+            pythoncom.CLSCTX_INPROC,
+            pythoncom.IID_ICatInformation,
+        )
+        enum = util.Enumerator(catinf.EnumCategories())
+        ret = []
+        try:
+            for catid, lcid, desc in enum:
+                ret.append(HLICategory((catid, lcid, desc)))
+        except pythoncom.com_error:
+            # Registered categories occasionally seem to give spurious errors.
+            pass  # Use what we already have.
+        return ret
+
+
+class HLICategory(HLICOM):
+    "An actual Registered Category"
+
+    def GetText(self):
+        desc = self.myobject[2]
+        if not desc:
+            desc = "(unnamed category)"
+        return desc
+
+    def GetSubList(self):
+        win32ui.DoWaitCursor(1)
+        catid, lcid, desc = self.myobject
+        catinf = pythoncom.CoCreateInstance(
+            pythoncom.CLSID_StdComponentCategoriesMgr,
+            None,
+            pythoncom.CLSCTX_INPROC,
+            pythoncom.IID_ICatInformation,
+        )
+        ret = []
+        for clsid in util.Enumerator(catinf.EnumClassesOfCategories((catid,), ())):
+            ret.append(HLICLSID(clsid))
+        win32ui.DoWaitCursor(0)
+
+        return ret
+
+
+class HLIHelpFile(HLICOM):
+    def CalculateIsExpandable(self):
+        return 0
+
+    def GetText(self):
+        import os
+
+        fname, ctx = self.myobject
+        base = os.path.split(fname)[1]
+        return "Help reference in %s" % (base)
+
+    def TakeDefaultAction(self):
+        fname, ctx = self.myobject
+        if ctx:
+            cmd = win32con.HELP_CONTEXT
+        else:
+            cmd = win32con.HELP_FINDER
+        win32api.WinHelp(win32ui.GetMainFrame().GetSafeHwnd(), fname, cmd, ctx)
+
+    def GetBitmapColumn(self):
+        return 6
+
+
+class HLIRegisteredTypeLibrary(HLICOM):
+    def GetSubList(self):
+        import os
+
+        clsidstr, versionStr = self.myobject
+        collected = []
+        helpPath = ""
+        key = win32api.RegOpenKey(
+            win32con.HKEY_CLASSES_ROOT, "TypeLib\\%s\\%s" % (clsidstr, versionStr)
+        )
+        win32ui.DoWaitCursor(1)
+        try:
+            num = 0
+            while 1:
+                try:
+                    subKey = win32api.RegEnumKey(key, num)
+                except win32api.error:
+                    break
+                hSubKey = win32api.RegOpenKey(key, subKey)
+                try:
+                    value, typ = win32api.RegQueryValueEx(hSubKey, None)
+                    if typ == win32con.REG_EXPAND_SZ:
+                        value = win32api.ExpandEnvironmentStrings(value)
+                except win32api.error:
+                    value = ""
+                if subKey == "HELPDIR":
+                    helpPath = value
+                elif subKey == "Flags":
+                    flags = value
+                else:
+                    try:
+                        lcid = int(subKey)
+                        lcidkey = win32api.RegOpenKey(key, subKey)
+                        # Enumerate the platforms
+                        lcidnum = 0
+                        while 1:
+                            try:
+                                platform = win32api.RegEnumKey(lcidkey, lcidnum)
+                            except win32api.error:
+                                break
+                            try:
+                                hplatform = win32api.RegOpenKey(lcidkey, platform)
+                                fname, typ = win32api.RegQueryValueEx(hplatform, None)
+                                if typ == win32con.REG_EXPAND_SZ:
+                                    fname = win32api.ExpandEnvironmentStrings(fname)
+                            except win32api.error:
+                                fname = ""
+                            collected.append((lcid, platform, fname))
+                            lcidnum = lcidnum + 1
+                        win32api.RegCloseKey(lcidkey)
+                    except ValueError:
+                        pass
+                num = num + 1
+        finally:
+            win32ui.DoWaitCursor(0)
+            win32api.RegCloseKey(key)
+        # Now, loop over my collected objects, adding a TypeLib and a HelpFile
+        ret = []
+        #               if helpPath: ret.append(browser.MakeHLI(helpPath, "Help Path"))
+        ret.append(HLICLSID(clsidstr))
+        for lcid, platform, fname in collected:
+            extraDescs = []
+            if platform != "win32":
+                extraDescs.append(platform)
+            if lcid:
+                extraDescs.append("locale=%s" % lcid)
+            extraDesc = ""
+            if extraDescs:
+                extraDesc = " (%s)" % ", ".join(extraDescs)
+            ret.append(HLITypeLib(fname, "Type Library" + extraDesc))
+        ret.sort()
+        return ret
+
+
+class HLITypeLibEntry(HLICOM):
+    def GetText(self):
+        tlb, index = self.myobject
+        name, doc, ctx, helpFile = tlb.GetDocumentation(index)
+        try:
+            typedesc = HLITypeKinds[tlb.GetTypeInfoType(index)][1]
+        except KeyError:
+            typedesc = "Unknown!"
+        return name + " - " + typedesc
+
+    def GetSubList(self):
+        tlb, index = self.myobject
+        name, doc, ctx, helpFile = tlb.GetDocumentation(index)
+        ret = []
+        if doc:
+            ret.append(browser.HLIDocString(doc, "Doc"))
+        if helpFile:
+            ret.append(HLIHelpFile((helpFile, ctx)))
+        return ret
+
+
+class HLICoClass(HLITypeLibEntry):
+    def GetSubList(self):
+        ret = HLITypeLibEntry.GetSubList(self)
+        tlb, index = self.myobject
+        typeinfo = tlb.GetTypeInfo(index)
+        attr = typeinfo.GetTypeAttr()
+        for j in range(attr[8]):
+            flags = typeinfo.GetImplTypeFlags(j)
+            refType = typeinfo.GetRefTypeInfo(typeinfo.GetRefTypeOfImplType(j))
+            refAttr = refType.GetTypeAttr()
+            ret.append(
+                browser.MakeHLI(refAttr[0], "Name=%s, Flags = %d" % (refAttr[0], flags))
+            )
+        return ret
+
+
+class HLITypeLibMethod(HLITypeLibEntry):
+    def __init__(self, ob, name=None):
+        self.entry_type = "Method"
+        HLITypeLibEntry.__init__(self, ob, name)
+
+    def GetSubList(self):
+        ret = HLITypeLibEntry.GetSubList(self)
+        tlb, index = self.myobject
+        typeinfo = tlb.GetTypeInfo(index)
+        attr = typeinfo.GetTypeAttr()
+        for i in range(attr[7]):
+            ret.append(HLITypeLibProperty((typeinfo, i)))
+        for i in range(attr[6]):
+            ret.append(HLITypeLibFunction((typeinfo, i)))
+        return ret
+
+
+class HLITypeLibEnum(HLITypeLibEntry):
+    def __init__(self, myitem):
+        typelib, index = myitem
+        typeinfo = typelib.GetTypeInfo(index)
+        self.id = typeinfo.GetVarDesc(index)[0]
+        name = typeinfo.GetNames(self.id)[0]
+        HLITypeLibEntry.__init__(self, myitem, name)
+
+    def GetText(self):
+        return self.name + " - Enum/Module"
+
+    def GetSubList(self):
+        ret = []
+        typelib, index = self.myobject
+        typeinfo = typelib.GetTypeInfo(index)
+        attr = typeinfo.GetTypeAttr()
+        for j in range(attr[7]):
+            vdesc = typeinfo.GetVarDesc(j)
+            name = typeinfo.GetNames(vdesc[0])[0]
+            ret.append(browser.MakeHLI(vdesc[1], name))
+        return ret
+
+
+class HLITypeLibProperty(HLICOM):
+    def __init__(self, myitem):
+        typeinfo, index = myitem
+        self.id = typeinfo.GetVarDesc(index)[0]
+        name = typeinfo.GetNames(self.id)[0]
+        HLICOM.__init__(self, myitem, name)
+
+    def GetText(self):
+        return self.name + " - Property"
+
+    def GetSubList(self):
+        ret = []
+        typeinfo, index = self.myobject
+        names = typeinfo.GetNames(self.id)
+        if len(names) > 1:
+            ret.append(browser.MakeHLI(names[1:], "Named Params"))
+        vd = typeinfo.GetVarDesc(index)
+        ret.append(browser.MakeHLI(self.id, "Dispatch ID"))
+        ret.append(browser.MakeHLI(vd[1], "Value"))
+        ret.append(browser.MakeHLI(vd[2], "Elem Desc"))
+        ret.append(browser.MakeHLI(vd[3], "Var Flags"))
+        ret.append(browser.MakeHLI(vd[4], "Var Kind"))
+        return ret
+
+
+class HLITypeLibFunction(HLICOM):
+    funckinds = {
+        pythoncom.FUNC_VIRTUAL: "Virtual",
+        pythoncom.FUNC_PUREVIRTUAL: "Pure Virtual",
+        pythoncom.FUNC_STATIC: "Static",
+        pythoncom.FUNC_DISPATCH: "Dispatch",
+    }
+    invokekinds = {
+        pythoncom.INVOKE_FUNC: "Function",
+        pythoncom.INVOKE_PROPERTYGET: "Property Get",
+        pythoncom.INVOKE_PROPERTYPUT: "Property Put",
+        pythoncom.INVOKE_PROPERTYPUTREF: "Property Put by reference",
+    }
+    funcflags = [
+        (pythoncom.FUNCFLAG_FRESTRICTED, "Restricted"),
+        (pythoncom.FUNCFLAG_FSOURCE, "Source"),
+        (pythoncom.FUNCFLAG_FBINDABLE, "Bindable"),
+        (pythoncom.FUNCFLAG_FREQUESTEDIT, "Request Edit"),
+        (pythoncom.FUNCFLAG_FDISPLAYBIND, "Display Bind"),
+        (pythoncom.FUNCFLAG_FDEFAULTBIND, "Default Bind"),
+        (pythoncom.FUNCFLAG_FHIDDEN, "Hidden"),
+        (pythoncom.FUNCFLAG_FUSESGETLASTERROR, "Uses GetLastError"),
+    ]
+
+    vartypes = {
+        pythoncom.VT_EMPTY: "Empty",
+        pythoncom.VT_NULL: "NULL",
+        pythoncom.VT_I2: "Integer 2",
+        pythoncom.VT_I4: "Integer 4",
+        pythoncom.VT_R4: "Real 4",
+        pythoncom.VT_R8: "Real 8",
+        pythoncom.VT_CY: "CY",
+        pythoncom.VT_DATE: "Date",
+        pythoncom.VT_BSTR: "String",
+        pythoncom.VT_DISPATCH: "IDispatch",
+        pythoncom.VT_ERROR: "Error",
+        pythoncom.VT_BOOL: "BOOL",
+        pythoncom.VT_VARIANT: "Variant",
+        pythoncom.VT_UNKNOWN: "IUnknown",
+        pythoncom.VT_DECIMAL: "Decimal",
+        pythoncom.VT_I1: "Integer 1",
+        pythoncom.VT_UI1: "Unsigned integer 1",
+        pythoncom.VT_UI2: "Unsigned integer 2",
+        pythoncom.VT_UI4: "Unsigned integer 4",
+        pythoncom.VT_I8: "Integer 8",
+        pythoncom.VT_UI8: "Unsigned integer 8",
+        pythoncom.VT_INT: "Integer",
+        pythoncom.VT_UINT: "Unsigned integer",
+        pythoncom.VT_VOID: "Void",
+        pythoncom.VT_HRESULT: "HRESULT",
+        pythoncom.VT_PTR: "Pointer",
+        pythoncom.VT_SAFEARRAY: "SafeArray",
+        pythoncom.VT_CARRAY: "C Array",
+        pythoncom.VT_USERDEFINED: "User Defined",
+        pythoncom.VT_LPSTR: "Pointer to string",
+        pythoncom.VT_LPWSTR: "Pointer to Wide String",
+        pythoncom.VT_FILETIME: "File time",
+        pythoncom.VT_BLOB: "Blob",
+        pythoncom.VT_STREAM: "IStream",
+        pythoncom.VT_STORAGE: "IStorage",
+        pythoncom.VT_STORED_OBJECT: "Stored object",
+        pythoncom.VT_STREAMED_OBJECT: "Streamed object",
+        pythoncom.VT_BLOB_OBJECT: "Blob object",
+        pythoncom.VT_CF: "CF",
+        pythoncom.VT_CLSID: "CLSID",
+    }
+
+    type_flags = [
+        (pythoncom.VT_VECTOR, "Vector"),
+        (pythoncom.VT_ARRAY, "Array"),
+        (pythoncom.VT_BYREF, "ByRef"),
+        (pythoncom.VT_RESERVED, "Reserved"),
+    ]
+
+    def __init__(self, myitem):
+        typeinfo, index = myitem
+        self.id = typeinfo.GetFuncDesc(index)[0]
+        name = typeinfo.GetNames(self.id)[0]
+        HLICOM.__init__(self, myitem, name)
+
+    def GetText(self):
+        return self.name + " - Function"
+
+    def MakeReturnTypeName(self, typ):
+        justtyp = typ & pythoncom.VT_TYPEMASK
+        try:
+            typname = self.vartypes[justtyp]
+        except KeyError:
+            typname = "?Bad type?"
+        for flag, desc in self.type_flags:
+            if flag & typ:
+                typname = "%s(%s)" % (desc, typname)
+        return typname
+
+    def MakeReturnType(self, returnTypeDesc):
+        if type(returnTypeDesc) == type(()):
+            first = returnTypeDesc[0]
+            result = self.MakeReturnType(first)
+            if first != pythoncom.VT_USERDEFINED:
+                result = result + " " + self.MakeReturnType(returnTypeDesc[1])
+            return result
+        else:
+            return self.MakeReturnTypeName(returnTypeDesc)
+
+    def GetSubList(self):
+        ret = []
+        typeinfo, index = self.myobject
+        names = typeinfo.GetNames(self.id)
+        ret.append(browser.MakeHLI(self.id, "Dispatch ID"))
+        if len(names) > 1:
+            ret.append(browser.MakeHLI(", ".join(names[1:]), "Named Params"))
+        fd = typeinfo.GetFuncDesc(index)
+        if fd[1]:
+            ret.append(browser.MakeHLI(fd[1], "Possible result values"))
+        if fd[8]:
+            typ, flags, default = fd[8]
+            val = self.MakeReturnType(typ)
+            if flags:
+                val = "%s (Flags=%d, default=%s)" % (val, flags, default)
+            ret.append(browser.MakeHLI(val, "Return Type"))
+
+        for argDesc in fd[2]:
+            typ, flags, default = argDesc
+            val = self.MakeReturnType(typ)
+            if flags:
+                val = "%s (Flags=%d)" % (val, flags)
+            if default is not None:
+                val = "%s (Default=%s)" % (val, default)
+            ret.append(browser.MakeHLI(val, "Argument"))
+
+        try:
+            fkind = self.funckinds[fd[3]]
+        except KeyError:
+            fkind = "Unknown"
+        ret.append(browser.MakeHLI(fkind, "Function Kind"))
+        try:
+            ikind = self.invokekinds[fd[4]]
+        except KeyError:
+            ikind = "Unknown"
+        ret.append(browser.MakeHLI(ikind, "Invoke Kind"))
+        # 5 = call conv
+        # 5 = offset vtbl
+        ret.append(browser.MakeHLI(fd[6], "Number Optional Params"))
+        flagDescs = []
+        for flag, desc in self.funcflags:
+            if flag & fd[9]:
+                flagDescs.append(desc)
+        if flagDescs:
+            ret.append(browser.MakeHLI(", ".join(flagDescs), "Function Flags"))
+        return ret
+
+
+HLITypeKinds = {
+    pythoncom.TKIND_ENUM: (HLITypeLibEnum, "Enumeration"),
+    pythoncom.TKIND_RECORD: (HLITypeLibEntry, "Record"),
+    pythoncom.TKIND_MODULE: (HLITypeLibEnum, "Module"),
+    pythoncom.TKIND_INTERFACE: (HLITypeLibMethod, "Interface"),
+    pythoncom.TKIND_DISPATCH: (HLITypeLibMethod, "Dispatch"),
+    pythoncom.TKIND_COCLASS: (HLICoClass, "CoClass"),
+    pythoncom.TKIND_ALIAS: (HLITypeLibEntry, "Alias"),
+    pythoncom.TKIND_UNION: (HLITypeLibEntry, "Union"),
+}
+
+
+class HLITypeLib(HLICOM):
+    def GetSubList(self):
+        ret = []
+        ret.append(browser.MakeHLI(self.myobject, "Filename"))
+        try:
+            tlb = pythoncom.LoadTypeLib(self.myobject)
+        except pythoncom.com_error:
+            return [browser.MakeHLI("%s can not be loaded" % self.myobject)]
+
+        for i in range(tlb.GetTypeInfoCount()):
+            try:
+                ret.append(HLITypeKinds[tlb.GetTypeInfoType(i)][0]((tlb, i)))
+            except pythoncom.com_error:
+                ret.append(browser.MakeHLI("The type info can not be loaded!"))
+        ret.sort()
+        return ret
+
+
+class HLIHeadingRegisterdTypeLibs(HLICOM):
+    "A tree heading for registered type libraries"
+
+    def GetText(self):
+        return "Registered Type Libraries"
+
+    def GetSubList(self):
+        # Explicit lookup in the registry.
+        ret = []
+        key = win32api.RegOpenKey(win32con.HKEY_CLASSES_ROOT, "TypeLib")
+        win32ui.DoWaitCursor(1)
+        try:
+            num = 0
+            while 1:
+                try:
+                    keyName = win32api.RegEnumKey(key, num)
+                except win32api.error:
+                    break
+                # Enumerate all version info
+                subKey = win32api.RegOpenKey(key, keyName)
+                name = None
+                try:
+                    subNum = 0
+                    bestVersion = 0.0
+                    while 1:
+                        try:
+                            versionStr = win32api.RegEnumKey(subKey, subNum)
+                        except win32api.error:
+                            break
+                        try:
+                            versionFlt = float(versionStr)
+                        except ValueError:
+                            versionFlt = 0  # ????
+                        if versionFlt > bestVersion:
+                            bestVersion = versionFlt
+                            name = win32api.RegQueryValue(subKey, versionStr)
+                        subNum = subNum + 1
+                finally:
+                    win32api.RegCloseKey(subKey)
+                if name is not None:
+                    ret.append(HLIRegisteredTypeLibrary((keyName, versionStr), name))
+                num = num + 1
+        finally:
+            win32api.RegCloseKey(key)
+            win32ui.DoWaitCursor(0)
+        ret.sort()
+        return ret
+
+
+def main(modal=True, mdi=False):
+    from pywin.tools import hierlist
+
+    root = HLIRoot("COM Browser")
+    if mdi and "pywin.framework.app" in sys.modules:
+        # do it in a MDI window
+        browser.MakeTemplate()
+        browser.template.OpenObject(root)
+    else:
+        dlg = browser.dynamic_browser(root)
+        if modal:
+            dlg.DoModal()
+        else:
+            dlg.CreateWindow()
+            dlg.ShowWindow()
+
+
+if __name__ == "__main__":
+    main(modal=win32api.GetConsoleTitle())
+
+    ni = pythoncom._GetInterfaceCount()
+    ng = pythoncom._GetGatewayCount()
+    if ni or ng:
+        print("Warning - exiting with %d/%d objects alive" % (ni, ng))
diff --git a/lib/win32com/client/connect.py b/lib/win32com/client/connect.py
new file mode 100644
index 00000000..24788204
--- /dev/null
+++ b/lib/win32com/client/connect.py
@@ -0,0 +1,48 @@
+"""Utilities for working with Connections"""
+import pythoncom
+import win32com.server.util
+
+
+class SimpleConnection:
+    "A simple, single connection object"
+
+    def __init__(self, coInstance=None, eventInstance=None, eventCLSID=None, debug=0):
+        self.cp = None
+        self.cookie = None
+        self.debug = debug
+        if not coInstance is None:
+            self.Connect(coInstance, eventInstance, eventCLSID)
+
+    def __del__(self):
+        try:
+            self.Disconnect()
+        except pythoncom.error:
+            # Ignore disconnection as we are torn down.
+            pass
+
+    def _wrap(self, obj):
+        useDispatcher = None
+        if self.debug:
+            from win32com.server import dispatcher
+
+            useDispatcher = dispatcher.DefaultDebugDispatcher
+        return win32com.server.util.wrap(obj, useDispatcher=useDispatcher)
+
+    def Connect(self, coInstance, eventInstance, eventCLSID=None):
+        try:
+            oleobj = coInstance._oleobj_
+        except AttributeError:
+            oleobj = coInstance
+        cpc = oleobj.QueryInterface(pythoncom.IID_IConnectionPointContainer)
+        if eventCLSID is None:
+            eventCLSID = eventInstance.CLSID
+        comEventInstance = self._wrap(eventInstance)
+        self.cp = cpc.FindConnectionPoint(eventCLSID)
+        self.cookie = self.cp.Advise(comEventInstance)
+
+    def Disconnect(self):
+        if not self.cp is None:
+            if self.cookie:
+                self.cp.Unadvise(self.cookie)
+                self.cookie = None
+            self.cp = None
diff --git a/lib/win32com/client/dynamic.py b/lib/win32com/client/dynamic.py
new file mode 100644
index 00000000..449ad928
--- /dev/null
+++ b/lib/win32com/client/dynamic.py
@@ -0,0 +1,708 @@
+"""Support for dynamic COM client support.
+
+Introduction
+ Dynamic COM client support is the ability to use a COM server without
+ prior knowledge of the server.  This can be used to talk to almost all
+ COM servers, including much of MS Office.
+
+ In general, you should not use this module directly - see below.
+
+Example
+ >>> import win32com.client
+ >>> xl = win32com.client.Dispatch("Excel.Application")
+ # The line above invokes the functionality of this class.
+ # xl is now an object we can use to talk to Excel.
+ >>> xl.Visible = 1 # The Excel window becomes visible.
+
+"""
+import traceback
+import types
+
+import pythoncom  # Needed as code we eval() references it.
+import win32com.client
+import winerror
+from pywintypes import IIDType
+
+from . import build
+
+debugging = 0  # General debugging
+debugging_attr = 0  # Debugging dynamic attribute lookups.
+
+LCID = 0x0
+
+# These errors generally mean the property or method exists,
+# but can't be used in this context - eg, property instead of a method, etc.
+# Used to determine if we have a real error or not.
+ERRORS_BAD_CONTEXT = [
+    winerror.DISP_E_MEMBERNOTFOUND,
+    winerror.DISP_E_BADPARAMCOUNT,
+    winerror.DISP_E_PARAMNOTOPTIONAL,
+    winerror.DISP_E_TYPEMISMATCH,
+    winerror.E_INVALIDARG,
+]
+
+ALL_INVOKE_TYPES = [
+    pythoncom.INVOKE_PROPERTYGET,
+    pythoncom.INVOKE_PROPERTYPUT,
+    pythoncom.INVOKE_PROPERTYPUTREF,
+    pythoncom.INVOKE_FUNC,
+]
+
+
+def debug_print(*args):
+    if debugging:
+        for arg in args:
+            print(arg, end=" ")
+        print()
+
+
+def debug_attr_print(*args):
+    if debugging_attr:
+        for arg in args:
+            print(arg, end=" ")
+        print()
+
+
+def MakeMethod(func, inst, cls):
+    return types.MethodType(func, inst)
+
+
+# get the type objects for IDispatch and IUnknown
+PyIDispatchType = pythoncom.TypeIIDs[pythoncom.IID_IDispatch]
+PyIUnknownType = pythoncom.TypeIIDs[pythoncom.IID_IUnknown]
+
+_GoodDispatchTypes = (str, IIDType)
+_defaultDispatchItem = build.DispatchItem
+
+
+def _GetGoodDispatch(IDispatch, clsctx=pythoncom.CLSCTX_SERVER):
+    # quick return for most common case
+    if isinstance(IDispatch, PyIDispatchType):
+        return IDispatch
+    if isinstance(IDispatch, _GoodDispatchTypes):
+        try:
+            IDispatch = pythoncom.connect(IDispatch)
+        except pythoncom.ole_error:
+            IDispatch = pythoncom.CoCreateInstance(
+                IDispatch, None, clsctx, pythoncom.IID_IDispatch
+            )
+    else:
+        # may already be a wrapped class.
+        IDispatch = getattr(IDispatch, "_oleobj_", IDispatch)
+    return IDispatch
+
+
+def _GetGoodDispatchAndUserName(IDispatch, userName, clsctx):
+    # Get a dispatch object, and a 'user name' (ie, the name as
+    # displayed to the user in repr() etc.
+    if userName is None:
+        if isinstance(IDispatch, str):
+            userName = IDispatch
+        ## ??? else userName remains None ???
+    else:
+        userName = str(userName)
+    return (_GetGoodDispatch(IDispatch, clsctx), userName)
+
+
+def _GetDescInvokeType(entry, invoke_type):
+    # determine the wFlags argument passed as input to IDispatch::Invoke
+    # Only ever called by __getattr__ and __setattr__ from dynamic objects!
+    # * `entry` is a MapEntry with whatever typeinfo we have about the property we are getting/setting.
+    # * `invoke_type` is either INVOKE_PROPERTYGET | INVOKE_PROPERTYSET and really just
+    #   means "called by __getattr__" or "called by __setattr__"
+    if not entry or not entry.desc:
+        return invoke_type
+
+    if entry.desc.desckind == pythoncom.DESCKIND_VARDESC:
+        return invoke_type
+
+    # So it's a FUNCDESC - just use what it specifies.
+    return entry.desc.invkind
+
+
+def Dispatch(
+    IDispatch,
+    userName=None,
+    createClass=None,
+    typeinfo=None,
+    UnicodeToString=None,
+    clsctx=pythoncom.CLSCTX_SERVER,
+):
+    assert UnicodeToString is None, "this is deprecated and will go away"
+    IDispatch, userName = _GetGoodDispatchAndUserName(IDispatch, userName, clsctx)
+    if createClass is None:
+        createClass = CDispatch
+    lazydata = None
+    try:
+        if typeinfo is None:
+            typeinfo = IDispatch.GetTypeInfo()
+        if typeinfo is not None:
+            try:
+                # try for a typecomp
+                typecomp = typeinfo.GetTypeComp()
+                lazydata = typeinfo, typecomp
+            except pythoncom.com_error:
+                pass
+    except pythoncom.com_error:
+        typeinfo = None
+    olerepr = MakeOleRepr(IDispatch, typeinfo, lazydata)
+    return createClass(IDispatch, olerepr, userName, lazydata=lazydata)
+
+
+def MakeOleRepr(IDispatch, typeinfo, typecomp):
+    olerepr = None
+    if typeinfo is not None:
+        try:
+            attr = typeinfo.GetTypeAttr()
+            # If the type info is a special DUAL interface, magically turn it into
+            # a DISPATCH typeinfo.
+            if (
+                attr[5] == pythoncom.TKIND_INTERFACE
+                and attr[11] & pythoncom.TYPEFLAG_FDUAL
+            ):
+                # Get corresponding Disp interface;
+                # -1 is a special value which does this for us.
+                href = typeinfo.GetRefTypeOfImplType(-1)
+                typeinfo = typeinfo.GetRefTypeInfo(href)
+                attr = typeinfo.GetTypeAttr()
+            if typecomp is None:
+                olerepr = build.DispatchItem(typeinfo, attr, None, 0)
+            else:
+                olerepr = build.LazyDispatchItem(attr, None)
+        except pythoncom.ole_error:
+            pass
+    if olerepr is None:
+        olerepr = build.DispatchItem()
+    return olerepr
+
+
+def DumbDispatch(
+    IDispatch,
+    userName=None,
+    createClass=None,
+    UnicodeToString=None,
+    clsctx=pythoncom.CLSCTX_SERVER,
+):
+    "Dispatch with no type info"
+    assert UnicodeToString is None, "this is deprecated and will go away"
+    IDispatch, userName = _GetGoodDispatchAndUserName(IDispatch, userName, clsctx)
+    if createClass is None:
+        createClass = CDispatch
+    return createClass(IDispatch, build.DispatchItem(), userName)
+
+
+class CDispatch:
+    def __init__(
+        self, IDispatch, olerepr, userName=None, UnicodeToString=None, lazydata=None
+    ):
+        assert UnicodeToString is None, "this is deprecated and will go away"
+        if userName is None:
+            userName = "<unknown>"
+        self.__dict__["_oleobj_"] = IDispatch
+        self.__dict__["_username_"] = userName
+        self.__dict__["_olerepr_"] = olerepr
+        self.__dict__["_mapCachedItems_"] = {}
+        self.__dict__["_builtMethods_"] = {}
+        self.__dict__["_enum_"] = None
+        self.__dict__["_unicode_to_string_"] = None
+        self.__dict__["_lazydata_"] = lazydata
+
+    def __call__(self, *args):
+        "Provide 'default dispatch' COM functionality - allow instance to be called"
+        if self._olerepr_.defaultDispatchName:
+            invkind, dispid = self._find_dispatch_type_(
+                self._olerepr_.defaultDispatchName
+            )
+        else:
+            invkind, dispid = (
+                pythoncom.DISPATCH_METHOD | pythoncom.DISPATCH_PROPERTYGET,
+                pythoncom.DISPID_VALUE,
+            )
+        if invkind is not None:
+            allArgs = (dispid, LCID, invkind, 1) + args
+            return self._get_good_object_(
+                self._oleobj_.Invoke(*allArgs), self._olerepr_.defaultDispatchName, None
+            )
+        raise TypeError("This dispatch object does not define a default method")
+
+    def __bool__(self):
+        return True  # ie "if object:" should always be "true" - without this, __len__ is tried.
+        # _Possibly_ want to defer to __len__ if available, but Im not sure this is
+        # desirable???
+
+    def __repr__(self):
+        return "<COMObject %s>" % (self._username_)
+
+    def __str__(self):
+        # __str__ is used when the user does "print object", so we gracefully
+        # fall back to the __repr__ if the object has no default method.
+        try:
+            return str(self.__call__())
+        except pythoncom.com_error as details:
+            if details.hresult not in ERRORS_BAD_CONTEXT:
+                raise
+            return self.__repr__()
+
+    def __dir__(self):
+        lst = list(self.__dict__.keys()) + dir(self.__class__) + self._dir_ole_()
+        try:
+            lst += [p.Name for p in self.Properties_]
+        except AttributeError:
+            pass
+        return list(set(lst))
+
+    def _dir_ole_(self):
+        items_dict = {}
+        for iTI in range(0, self._oleobj_.GetTypeInfoCount()):
+            typeInfo = self._oleobj_.GetTypeInfo(iTI)
+            self._UpdateWithITypeInfo_(items_dict, typeInfo)
+        return list(items_dict.keys())
+
+    def _UpdateWithITypeInfo_(self, items_dict, typeInfo):
+        typeInfos = [typeInfo]
+        # suppress IDispatch and IUnknown methods
+        inspectedIIDs = {pythoncom.IID_IDispatch: None}
+
+        while len(typeInfos) > 0:
+            typeInfo = typeInfos.pop()
+            typeAttr = typeInfo.GetTypeAttr()
+
+            if typeAttr.iid not in inspectedIIDs:
+                inspectedIIDs[typeAttr.iid] = None
+                for iFun in range(0, typeAttr.cFuncs):
+                    funDesc = typeInfo.GetFuncDesc(iFun)
+                    funName = typeInfo.GetNames(funDesc.memid)[0]
+                    if funName not in items_dict:
+                        items_dict[funName] = None
+
+                # Inspect the type info of all implemented types
+                # E.g. IShellDispatch5 implements IShellDispatch4 which implements IShellDispatch3 ...
+                for iImplType in range(0, typeAttr.cImplTypes):
+                    iRefType = typeInfo.GetRefTypeOfImplType(iImplType)
+                    refTypeInfo = typeInfo.GetRefTypeInfo(iRefType)
+                    typeInfos.append(refTypeInfo)
+
+    # Delegate comparison to the oleobjs, as they know how to do identity.
+    def __eq__(self, other):
+        other = getattr(other, "_oleobj_", other)
+        return self._oleobj_ == other
+
+    def __ne__(self, other):
+        other = getattr(other, "_oleobj_", other)
+        return self._oleobj_ != other
+
+    def __int__(self):
+        return int(self.__call__())
+
+    def __len__(self):
+        invkind, dispid = self._find_dispatch_type_("Count")
+        if invkind:
+            return self._oleobj_.Invoke(dispid, LCID, invkind, 1)
+        raise TypeError("This dispatch object does not define a Count method")
+
+    def _NewEnum(self):
+        try:
+            invkind = pythoncom.DISPATCH_METHOD | pythoncom.DISPATCH_PROPERTYGET
+            enum = self._oleobj_.InvokeTypes(
+                pythoncom.DISPID_NEWENUM, LCID, invkind, (13, 10), ()
+            )
+        except pythoncom.com_error:
+            return None  # no enumerator for this object.
+        from . import util
+
+        return util.WrapEnum(enum, None)
+
+    def __getitem__(self, index):  # syver modified
+        # Improved __getitem__ courtesy Syver Enstad
+        # Must check _NewEnum before Item, to ensure b/w compat.
+        if isinstance(index, int):
+            if self.__dict__["_enum_"] is None:
+                self.__dict__["_enum_"] = self._NewEnum()
+            if self.__dict__["_enum_"] is not None:
+                return self._get_good_object_(self._enum_.__getitem__(index))
+        # See if we have an "Item" method/property we can use (goes hand in hand with Count() above!)
+        invkind, dispid = self._find_dispatch_type_("Item")
+        if invkind is not None:
+            return self._get_good_object_(
+                self._oleobj_.Invoke(dispid, LCID, invkind, 1, index)
+            )
+        raise TypeError("This object does not support enumeration")
+
+    def __setitem__(self, index, *args):
+        # XXX - todo - We should support calling Item() here too!
+        # 		print "__setitem__ with", index, args
+        if self._olerepr_.defaultDispatchName:
+            invkind, dispid = self._find_dispatch_type_(
+                self._olerepr_.defaultDispatchName
+            )
+        else:
+            invkind, dispid = (
+                pythoncom.DISPATCH_PROPERTYPUT | pythoncom.DISPATCH_PROPERTYPUTREF,
+                pythoncom.DISPID_VALUE,
+            )
+        if invkind is not None:
+            allArgs = (dispid, LCID, invkind, 0, index) + args
+            return self._get_good_object_(
+                self._oleobj_.Invoke(*allArgs), self._olerepr_.defaultDispatchName, None
+            )
+        raise TypeError("This dispatch object does not define a default method")
+
+    def _find_dispatch_type_(self, methodName):
+        if methodName in self._olerepr_.mapFuncs:
+            item = self._olerepr_.mapFuncs[methodName]
+            return item.desc[4], item.dispid
+
+        if methodName in self._olerepr_.propMapGet:
+            item = self._olerepr_.propMapGet[methodName]
+            return item.desc[4], item.dispid
+
+        try:
+            dispid = self._oleobj_.GetIDsOfNames(0, methodName)
+        except:  ### what error?
+            return None, None
+        return pythoncom.DISPATCH_METHOD | pythoncom.DISPATCH_PROPERTYGET, dispid
+
+    def _ApplyTypes_(self, dispid, wFlags, retType, argTypes, user, resultCLSID, *args):
+        result = self._oleobj_.InvokeTypes(
+            *(dispid, LCID, wFlags, retType, argTypes) + args
+        )
+        return self._get_good_object_(result, user, resultCLSID)
+
+    def _wrap_dispatch_(
+        self, ob, userName=None, returnCLSID=None, UnicodeToString=None
+    ):
+        # Given a dispatch object, wrap it in a class
+        assert UnicodeToString is None, "this is deprecated and will go away"
+        return Dispatch(ob, userName)
+
+    def _get_good_single_object_(self, ob, userName=None, ReturnCLSID=None):
+        if isinstance(ob, PyIDispatchType):
+            # make a new instance of (probably this) class.
+            return self._wrap_dispatch_(ob, userName, ReturnCLSID)
+        if isinstance(ob, PyIUnknownType):
+            try:
+                ob = ob.QueryInterface(pythoncom.IID_IDispatch)
+            except pythoncom.com_error:
+                # It is an IUnknown, but not an IDispatch, so just let it through.
+                return ob
+            return self._wrap_dispatch_(ob, userName, ReturnCLSID)
+        return ob
+
+    def _get_good_object_(self, ob, userName=None, ReturnCLSID=None):
+        """Given an object (usually the retval from a method), make it a good object to return.
+        Basically checks if it is a COM object, and wraps it up.
+        Also handles the fact that a retval may be a tuple of retvals"""
+        if ob is None:  # Quick exit!
+            return None
+        elif isinstance(ob, tuple):
+            return tuple(
+                map(
+                    lambda o, s=self, oun=userName, rc=ReturnCLSID: s._get_good_single_object_(
+                        o, oun, rc
+                    ),
+                    ob,
+                )
+            )
+        else:
+            return self._get_good_single_object_(ob)
+
+    def _make_method_(self, name):
+        "Make a method object - Assumes in olerepr funcmap"
+        methodName = build.MakePublicAttributeName(name)  # translate keywords etc.
+        methodCodeList = self._olerepr_.MakeFuncMethod(
+            self._olerepr_.mapFuncs[name], methodName, 0
+        )
+        methodCode = "\n".join(methodCodeList)
+        try:
+            # 			print "Method code for %s is:\n" % self._username_, methodCode
+            # 			self._print_details_()
+            codeObject = compile(methodCode, "<COMObject %s>" % self._username_, "exec")
+            # Exec the code object
+            tempNameSpace = {}
+            # "Dispatch" in the exec'd code is win32com.client.Dispatch, not ours.
+            globNameSpace = globals().copy()
+            globNameSpace["Dispatch"] = win32com.client.Dispatch
+            exec(
+                codeObject, globNameSpace, tempNameSpace
+            )  # self.__dict__, self.__dict__
+            name = methodName
+            # Save the function in map.
+            fn = self._builtMethods_[name] = tempNameSpace[name]
+            newMeth = MakeMethod(fn, self, self.__class__)
+            return newMeth
+        except:
+            debug_print("Error building OLE definition for code ", methodCode)
+            traceback.print_exc()
+        return None
+
+    def _Release_(self):
+        """Cleanup object - like a close - to force cleanup when you dont
+        want to rely on Python's reference counting."""
+        for childCont in self._mapCachedItems_.values():
+            childCont._Release_()
+        self._mapCachedItems_ = {}
+        if self._oleobj_:
+            self._oleobj_.Release()
+            self.__dict__["_oleobj_"] = None
+        if self._olerepr_:
+            self.__dict__["_olerepr_"] = None
+        self._enum_ = None
+
+    def _proc_(self, name, *args):
+        """Call the named method as a procedure, rather than function.
+        Mainly used by Word.Basic, which whinges about such things."""
+        try:
+            item = self._olerepr_.mapFuncs[name]
+            dispId = item.dispid
+            return self._get_good_object_(
+                self._oleobj_.Invoke(*(dispId, LCID, item.desc[4], 0) + (args))
+            )
+        except KeyError:
+            raise AttributeError(name)
+
+    def _print_details_(self):
+        "Debug routine - dumps what it knows about an object."
+        print("AxDispatch container", self._username_)
+        try:
+            print("Methods:")
+            for method in self._olerepr_.mapFuncs.keys():
+                print("\t", method)
+            print("Props:")
+            for prop, entry in self._olerepr_.propMap.items():
+                print("\t%s = 0x%x - %s" % (prop, entry.dispid, repr(entry)))
+            print("Get Props:")
+            for prop, entry in self._olerepr_.propMapGet.items():
+                print("\t%s = 0x%x - %s" % (prop, entry.dispid, repr(entry)))
+            print("Put Props:")
+            for prop, entry in self._olerepr_.propMapPut.items():
+                print("\t%s = 0x%x - %s" % (prop, entry.dispid, repr(entry)))
+        except:
+            traceback.print_exc()
+
+    def __LazyMap__(self, attr):
+        try:
+            if self._LazyAddAttr_(attr):
+                debug_attr_print(
+                    "%s.__LazyMap__(%s) added something" % (self._username_, attr)
+                )
+                return 1
+        except AttributeError:
+            return 0
+
+    # Using the typecomp, lazily create a new attribute definition.
+    def _LazyAddAttr_(self, attr):
+        if self._lazydata_ is None:
+            return 0
+        res = 0
+        typeinfo, typecomp = self._lazydata_
+        olerepr = self._olerepr_
+        # We need to explicitly check each invoke type individually - simply
+        # specifying '0' will bind to "any member", which may not be the one
+        # we are actually after (ie, we may be after prop_get, but returned
+        # the info for the prop_put.)
+        for i in ALL_INVOKE_TYPES:
+            try:
+                x, t = typecomp.Bind(attr, i)
+                # Support 'Get' and 'Set' properties - see
+                # bug 1587023
+                if x == 0 and attr[:3] in ("Set", "Get"):
+                    x, t = typecomp.Bind(attr[3:], i)
+                if x == pythoncom.DESCKIND_FUNCDESC:  # it's a FUNCDESC
+                    r = olerepr._AddFunc_(typeinfo, t, 0)
+                elif x == pythoncom.DESCKIND_VARDESC:  # it's a VARDESC
+                    r = olerepr._AddVar_(typeinfo, t, 0)
+                else:  # not found or TYPEDESC/IMPLICITAPP
+                    r = None
+                if not r is None:
+                    key, map = r[0], r[1]
+                    item = map[key]
+                    if map == olerepr.propMapPut:
+                        olerepr._propMapPutCheck_(key, item)
+                    elif map == olerepr.propMapGet:
+                        olerepr._propMapGetCheck_(key, item)
+                    res = 1
+            except:
+                pass
+        return res
+
+    def _FlagAsMethod(self, *methodNames):
+        """Flag these attribute names as being methods.
+        Some objects do not correctly differentiate methods and
+        properties, leading to problems when calling these methods.
+
+        Specifically, trying to say: ob.SomeFunc()
+        may yield an exception "None object is not callable"
+        In this case, an attempt to fetch the *property* has worked
+        and returned None, rather than indicating it is really a method.
+        Calling: ob._FlagAsMethod("SomeFunc")
+        should then allow this to work.
+        """
+        for name in methodNames:
+            details = build.MapEntry(self.__AttrToID__(name), (name,))
+            self._olerepr_.mapFuncs[name] = details
+
+    def __AttrToID__(self, attr):
+        debug_attr_print(
+            "Calling GetIDsOfNames for property %s in Dispatch container %s"
+            % (attr, self._username_)
+        )
+        return self._oleobj_.GetIDsOfNames(0, attr)
+
+    def __getattr__(self, attr):
+        if attr == "__iter__":
+            # We can't handle this as a normal method, as if the attribute
+            # exists, then it must return an iterable object.
+            try:
+                invkind = pythoncom.DISPATCH_METHOD | pythoncom.DISPATCH_PROPERTYGET
+                enum = self._oleobj_.InvokeTypes(
+                    pythoncom.DISPID_NEWENUM, LCID, invkind, (13, 10), ()
+                )
+            except pythoncom.com_error:
+                raise AttributeError("This object can not function as an iterator")
+
+            # We must return a callable object.
+            class Factory:
+                def __init__(self, ob):
+                    self.ob = ob
+
+                def __call__(self):
+                    import win32com.client.util
+
+                    return win32com.client.util.Iterator(self.ob)
+
+            return Factory(enum)
+
+        if attr.startswith("_") and attr.endswith("_"):  # Fast-track.
+            raise AttributeError(attr)
+        # If a known method, create new instance and return.
+        try:
+            return MakeMethod(self._builtMethods_[attr], self, self.__class__)
+        except KeyError:
+            pass
+        # XXX - Note that we current are case sensitive in the method.
+        # debug_attr_print("GetAttr called for %s on DispatchContainer %s" % (attr,self._username_))
+        # First check if it is in the method map.  Note that an actual method
+        # must not yet exist, (otherwise we would not be here).  This
+        # means we create the actual method object - which also means
+        # this code will never be asked for that method name again.
+        if attr in self._olerepr_.mapFuncs:
+            return self._make_method_(attr)
+
+        # Delegate to property maps/cached items
+        retEntry = None
+        if self._olerepr_ and self._oleobj_:
+            # first check general property map, then specific "put" map.
+            retEntry = self._olerepr_.propMap.get(attr)
+            if retEntry is None:
+                retEntry = self._olerepr_.propMapGet.get(attr)
+            # Not found so far - See what COM says.
+            if retEntry is None:
+                try:
+                    if self.__LazyMap__(attr):
+                        if attr in self._olerepr_.mapFuncs:
+                            return self._make_method_(attr)
+                        retEntry = self._olerepr_.propMap.get(attr)
+                        if retEntry is None:
+                            retEntry = self._olerepr_.propMapGet.get(attr)
+                    if retEntry is None:
+                        retEntry = build.MapEntry(self.__AttrToID__(attr), (attr,))
+                except pythoncom.ole_error:
+                    pass  # No prop by that name - retEntry remains None.
+
+        if retEntry is not None:  # see if in my cache
+            try:
+                ret = self._mapCachedItems_[retEntry.dispid]
+                debug_attr_print("Cached items has attribute!", ret)
+                return ret
+            except (KeyError, AttributeError):
+                debug_attr_print("Attribute %s not in cache" % attr)
+
+        # If we are still here, and have a retEntry, get the OLE item
+        if retEntry is not None:
+            invoke_type = _GetDescInvokeType(retEntry, pythoncom.INVOKE_PROPERTYGET)
+            debug_attr_print(
+                "Getting property Id 0x%x from OLE object" % retEntry.dispid
+            )
+            try:
+                ret = self._oleobj_.Invoke(retEntry.dispid, 0, invoke_type, 1)
+            except pythoncom.com_error as details:
+                if details.hresult in ERRORS_BAD_CONTEXT:
+                    # May be a method.
+                    self._olerepr_.mapFuncs[attr] = retEntry
+                    return self._make_method_(attr)
+                raise
+            debug_attr_print("OLE returned ", ret)
+            return self._get_good_object_(ret)
+
+        # no where else to look.
+        raise AttributeError("%s.%s" % (self._username_, attr))
+
+    def __setattr__(self, attr, value):
+        if (
+            attr in self.__dict__
+        ):  # Fast-track - if already in our dict, just make the assignment.
+            # XXX - should maybe check method map - if someone assigns to a method,
+            # it could mean something special (not sure what, tho!)
+            self.__dict__[attr] = value
+            return
+        # Allow property assignment.
+        debug_attr_print(
+            "SetAttr called for %s.%s=%s on DispatchContainer"
+            % (self._username_, attr, repr(value))
+        )
+
+        if self._olerepr_:
+            # Check the "general" property map.
+            if attr in self._olerepr_.propMap:
+                entry = self._olerepr_.propMap[attr]
+                invoke_type = _GetDescInvokeType(entry, pythoncom.INVOKE_PROPERTYPUT)
+                self._oleobj_.Invoke(entry.dispid, 0, invoke_type, 0, value)
+                return
+            # Check the specific "put" map.
+            if attr in self._olerepr_.propMapPut:
+                entry = self._olerepr_.propMapPut[attr]
+                invoke_type = _GetDescInvokeType(entry, pythoncom.INVOKE_PROPERTYPUT)
+                self._oleobj_.Invoke(entry.dispid, 0, invoke_type, 0, value)
+                return
+
+        # Try the OLE Object
+        if self._oleobj_:
+            if self.__LazyMap__(attr):
+                # Check the "general" property map.
+                if attr in self._olerepr_.propMap:
+                    entry = self._olerepr_.propMap[attr]
+                    invoke_type = _GetDescInvokeType(
+                        entry, pythoncom.INVOKE_PROPERTYPUT
+                    )
+                    self._oleobj_.Invoke(entry.dispid, 0, invoke_type, 0, value)
+                    return
+                # Check the specific "put" map.
+                if attr in self._olerepr_.propMapPut:
+                    entry = self._olerepr_.propMapPut[attr]
+                    invoke_type = _GetDescInvokeType(
+                        entry, pythoncom.INVOKE_PROPERTYPUT
+                    )
+                    self._oleobj_.Invoke(entry.dispid, 0, invoke_type, 0, value)
+                    return
+            try:
+                entry = build.MapEntry(self.__AttrToID__(attr), (attr,))
+            except pythoncom.com_error:
+                # No attribute of that name
+                entry = None
+            if entry is not None:
+                try:
+                    invoke_type = _GetDescInvokeType(
+                        entry, pythoncom.INVOKE_PROPERTYPUT
+                    )
+                    self._oleobj_.Invoke(entry.dispid, 0, invoke_type, 0, value)
+                    self._olerepr_.propMap[attr] = entry
+                    debug_attr_print(
+                        "__setattr__ property %s (id=0x%x) in Dispatch container %s"
+                        % (attr, entry.dispid, self._username_)
+                    )
+                    return
+                except pythoncom.com_error:
+                    pass
+        raise AttributeError(
+            "Property '%s.%s' can not be set." % (self._username_, attr)
+        )
diff --git a/lib/win32com/client/gencache.py b/lib/win32com/client/gencache.py
new file mode 100644
index 00000000..99e9c6cb
--- /dev/null
+++ b/lib/win32com/client/gencache.py
@@ -0,0 +1,799 @@
+"""Manages the cache of generated Python code.
+
+Description
+  This file manages the cache of generated Python code.  When run from the
+  command line, it also provides a number of options for managing that cache.
+
+Implementation
+  Each typelib is generated into a filename of format "{guid}x{lcid}x{major}x{minor}.py"
+
+  An external persistant dictionary maps from all known IIDs in all known type libraries
+  to the type library itself.
+
+  Thus, whenever Python code knows the IID of an object, it can find the IID, LCID and version of
+  the type library which supports it.  Given this information, it can find the Python module
+  with the support.
+
+  If necessary, this support can be generated on the fly.
+
+Hacks, to do, etc
+  Currently just uses a pickled dictionary, but should used some sort of indexed file.
+  Maybe an OLE2 compound file, or a bsddb file?
+"""
+import glob
+import os
+import sys
+from importlib import reload
+
+import pythoncom
+import pywintypes
+import win32com
+import win32com.client
+
+from . import CLSIDToClass
+
+bForDemandDefault = 0  # Default value of bForDemand - toggle this to change the world - see also makepy.py
+
+# The global dictionary
+clsidToTypelib = {}
+
+# If we have a different version of the typelib generated, this
+# maps the "requested version" to the "generated version".
+versionRedirectMap = {}
+
+# There is no reason we *must* be readonly in a .zip, but we are now,
+# Rather than check for ".zip" or other tricks, PEP302 defines
+# a "__loader__" attribute, so we use that.
+# (Later, it may become necessary to check if the __loader__ can update files,
+# as a .zip loader potentially could - but punt all that until a need arises)
+is_readonly = is_zip = hasattr(win32com, "__loader__") and hasattr(
+    win32com.__loader__, "archive"
+)
+
+# A dictionary of ITypeLibrary objects for demand generation explicitly handed to us
+# Keyed by usual clsid, lcid, major, minor
+demandGeneratedTypeLibraries = {}
+
+import pickle as pickle
+
+
+def __init__():
+    # Initialize the module.  Called once explicitly at module import below.
+    try:
+        _LoadDicts()
+    except IOError:
+        Rebuild()
+
+
+pickleVersion = 1
+
+
+def _SaveDicts():
+    if is_readonly:
+        raise RuntimeError(
+            "Trying to write to a readonly gencache ('%s')!" % win32com.__gen_path__
+        )
+    f = open(os.path.join(GetGeneratePath(), "dicts.dat"), "wb")
+    try:
+        p = pickle.Pickler(f)
+        p.dump(pickleVersion)
+        p.dump(clsidToTypelib)
+    finally:
+        f.close()
+
+
+def _LoadDicts():
+    # Load the dictionary from a .zip file if that is where we live.
+    if is_zip:
+        import io as io
+
+        loader = win32com.__loader__
+        arc_path = loader.archive
+        dicts_path = os.path.join(win32com.__gen_path__, "dicts.dat")
+        if dicts_path.startswith(arc_path):
+            dicts_path = dicts_path[len(arc_path) + 1 :]
+        else:
+            # Hm. See below.
+            return
+        try:
+            data = loader.get_data(dicts_path)
+        except AttributeError:
+            # The __loader__ has no get_data method.  See below.
+            return
+        except IOError:
+            # Our gencache is in a .zip file (and almost certainly readonly)
+            # but no dicts file.  That actually needn't be fatal for a frozen
+            # application.  Assuming they call "EnsureModule" with the same
+            # typelib IDs they have been frozen with, that EnsureModule will
+            # correctly re-build the dicts on the fly.  However, objects that
+            # rely on the gencache but have not done an EnsureModule will
+            # fail (but their apps are likely to fail running from source
+            # with a clean gencache anyway, as then they would be getting
+            # Dynamic objects until the cache is built - so the best answer
+            # for these apps is to call EnsureModule, rather than freezing
+            # the dict)
+            return
+        f = io.BytesIO(data)
+    else:
+        # NOTE: IOError on file open must be caught by caller.
+        f = open(os.path.join(win32com.__gen_path__, "dicts.dat"), "rb")
+    try:
+        p = pickle.Unpickler(f)
+        version = p.load()
+        global clsidToTypelib
+        clsidToTypelib = p.load()
+        versionRedirectMap.clear()
+    finally:
+        f.close()
+
+
+def GetGeneratedFileName(clsid, lcid, major, minor):
+    """Given the clsid, lcid, major and  minor for a type lib, return
+    the file name (no extension) providing this support.
+    """
+    return str(clsid).upper()[1:-1] + "x%sx%sx%s" % (lcid, major, minor)
+
+
+def SplitGeneratedFileName(fname):
+    """Reverse of GetGeneratedFileName()"""
+    return tuple(fname.split("x", 4))
+
+
+def GetGeneratePath():
+    """Returns the name of the path to generate to.
+    Checks the directory is OK.
+    """
+    assert not is_readonly, "Why do you want the genpath for a readonly store?"
+    try:
+        os.makedirs(win32com.__gen_path__)
+        # os.mkdir(win32com.__gen_path__)
+    except os.error:
+        pass
+    try:
+        fname = os.path.join(win32com.__gen_path__, "__init__.py")
+        os.stat(fname)
+    except os.error:
+        f = open(fname, "w")
+        f.write(
+            "# Generated file - this directory may be deleted to reset the COM cache...\n"
+        )
+        f.write("import win32com\n")
+        f.write(
+            "if __path__[:-1] != win32com.__gen_path__: __path__.append(win32com.__gen_path__)\n"
+        )
+        f.close()
+
+    return win32com.__gen_path__
+
+
+#
+# The helpers for win32com.client.Dispatch and OCX clients.
+#
+def GetClassForProgID(progid):
+    """Get a Python class for a Program ID
+
+    Given a Program ID, return a Python class which wraps the COM object
+
+    Returns the Python class, or None if no module is available.
+
+    Params
+    progid -- A COM ProgramID or IID (eg, "Word.Application")
+    """
+    clsid = pywintypes.IID(progid)  # This auto-converts named to IDs.
+    return GetClassForCLSID(clsid)
+
+
+def GetClassForCLSID(clsid):
+    """Get a Python class for a CLSID
+
+    Given a CLSID, return a Python class which wraps the COM object
+
+    Returns the Python class, or None if no module is available.
+
+    Params
+    clsid -- A COM CLSID (or string repr of one)
+    """
+    # first, take a short-cut - we may already have generated support ready-to-roll.
+    clsid = str(clsid)
+    if CLSIDToClass.HasClass(clsid):
+        return CLSIDToClass.GetClass(clsid)
+    mod = GetModuleForCLSID(clsid)
+    if mod is None:
+        return None
+    try:
+        return CLSIDToClass.GetClass(clsid)
+    except KeyError:
+        return None
+
+
+def GetModuleForProgID(progid):
+    """Get a Python module for a Program ID
+
+    Given a Program ID, return a Python module which contains the
+    class which wraps the COM object.
+
+    Returns the Python module, or None if no module is available.
+
+    Params
+    progid -- A COM ProgramID or IID (eg, "Word.Application")
+    """
+    try:
+        iid = pywintypes.IID(progid)
+    except pywintypes.com_error:
+        return None
+    return GetModuleForCLSID(iid)
+
+
+def GetModuleForCLSID(clsid):
+    """Get a Python module for a CLSID
+
+    Given a CLSID, return a Python module which contains the
+    class which wraps the COM object.
+
+    Returns the Python module, or None if no module is available.
+
+    Params
+    progid -- A COM CLSID (ie, not the description)
+    """
+    clsid_str = str(clsid)
+    try:
+        typelibCLSID, lcid, major, minor = clsidToTypelib[clsid_str]
+    except KeyError:
+        return None
+
+    try:
+        mod = GetModuleForTypelib(typelibCLSID, lcid, major, minor)
+    except ImportError:
+        mod = None
+    if mod is not None:
+        sub_mod = mod.CLSIDToPackageMap.get(clsid_str)
+        if sub_mod is None:
+            sub_mod = mod.VTablesToPackageMap.get(clsid_str)
+        if sub_mod is not None:
+            sub_mod_name = mod.__name__ + "." + sub_mod
+            try:
+                __import__(sub_mod_name)
+            except ImportError:
+                info = typelibCLSID, lcid, major, minor
+                # Force the generation.  If this typelibrary has explicitly been added,
+                # use it (it may not be registered, causing a lookup by clsid to fail)
+                if info in demandGeneratedTypeLibraries:
+                    info = demandGeneratedTypeLibraries[info]
+                from . import makepy
+
+                makepy.GenerateChildFromTypeLibSpec(sub_mod, info)
+                # Generate does an import...
+            mod = sys.modules[sub_mod_name]
+    return mod
+
+
+def GetModuleForTypelib(typelibCLSID, lcid, major, minor):
+    """Get a Python module for a type library ID
+
+    Given the CLSID of a typelibrary, return an imported Python module,
+    else None
+
+    Params
+    typelibCLSID -- IID of the type library.
+    major -- Integer major version.
+    minor -- Integer minor version
+    lcid -- Integer LCID for the library.
+    """
+    modName = GetGeneratedFileName(typelibCLSID, lcid, major, minor)
+    mod = _GetModule(modName)
+    # If the import worked, it doesn't mean we have actually added this
+    # module to our cache though - check that here.
+    if "_in_gencache_" not in mod.__dict__:
+        AddModuleToCache(typelibCLSID, lcid, major, minor)
+        assert "_in_gencache_" in mod.__dict__
+    return mod
+
+
+def MakeModuleForTypelib(
+    typelibCLSID,
+    lcid,
+    major,
+    minor,
+    progressInstance=None,
+    bForDemand=bForDemandDefault,
+    bBuildHidden=1,
+):
+    """Generate support for a type library.
+
+    Given the IID, LCID and version information for a type library, generate
+    and import the necessary support files.
+
+    Returns the Python module.  No exceptions are caught.
+
+    Params
+    typelibCLSID -- IID of the type library.
+    major -- Integer major version.
+    minor -- Integer minor version.
+    lcid -- Integer LCID for the library.
+    progressInstance -- Instance to use as progress indicator, or None to
+                        use the GUI progress bar.
+    """
+    from . import makepy
+
+    makepy.GenerateFromTypeLibSpec(
+        (typelibCLSID, lcid, major, minor),
+        progressInstance=progressInstance,
+        bForDemand=bForDemand,
+        bBuildHidden=bBuildHidden,
+    )
+    return GetModuleForTypelib(typelibCLSID, lcid, major, minor)
+
+
+def MakeModuleForTypelibInterface(
+    typelib_ob, progressInstance=None, bForDemand=bForDemandDefault, bBuildHidden=1
+):
+    """Generate support for a type library.
+
+    Given a PyITypeLib interface generate and import the necessary support files.  This is useful
+    for getting makepy support for a typelibrary that is not registered - the caller can locate
+    and load the type library itself, rather than relying on COM to find it.
+
+    Returns the Python module.
+
+    Params
+    typelib_ob -- The type library itself
+    progressInstance -- Instance to use as progress indicator, or None to
+                        use the GUI progress bar.
+    """
+    from . import makepy
+
+    try:
+        makepy.GenerateFromTypeLibSpec(
+            typelib_ob,
+            progressInstance=progressInstance,
+            bForDemand=bForDemandDefault,
+            bBuildHidden=bBuildHidden,
+        )
+    except pywintypes.com_error:
+        return None
+    tla = typelib_ob.GetLibAttr()
+    guid = tla[0]
+    lcid = tla[1]
+    major = tla[3]
+    minor = tla[4]
+    return GetModuleForTypelib(guid, lcid, major, minor)
+
+
+def EnsureModuleForTypelibInterface(
+    typelib_ob, progressInstance=None, bForDemand=bForDemandDefault, bBuildHidden=1
+):
+    """Check we have support for a type library, generating if not.
+
+    Given a PyITypeLib interface generate and import the necessary
+    support files if necessary. This is useful for getting makepy support
+    for a typelibrary that is not registered - the caller can locate and
+    load the type library itself, rather than relying on COM to find it.
+
+    Returns the Python module.
+
+    Params
+    typelib_ob -- The type library itself
+    progressInstance -- Instance to use as progress indicator, or None to
+                        use the GUI progress bar.
+    """
+    tla = typelib_ob.GetLibAttr()
+    guid = tla[0]
+    lcid = tla[1]
+    major = tla[3]
+    minor = tla[4]
+
+    # If demand generated, save the typelib interface away for later use
+    if bForDemand:
+        demandGeneratedTypeLibraries[(str(guid), lcid, major, minor)] = typelib_ob
+
+    try:
+        return GetModuleForTypelib(guid, lcid, major, minor)
+    except ImportError:
+        pass
+    # Generate it.
+    return MakeModuleForTypelibInterface(
+        typelib_ob, progressInstance, bForDemand, bBuildHidden
+    )
+
+
+def ForgetAboutTypelibInterface(typelib_ob):
+    """Drop any references to a typelib previously added with EnsureModuleForTypelibInterface and forDemand"""
+    tla = typelib_ob.GetLibAttr()
+    guid = tla[0]
+    lcid = tla[1]
+    major = tla[3]
+    minor = tla[4]
+    info = str(guid), lcid, major, minor
+    try:
+        del demandGeneratedTypeLibraries[info]
+    except KeyError:
+        # Not worth raising an exception - maybe they dont know we only remember for demand generated, etc.
+        print(
+            "ForgetAboutTypelibInterface:: Warning - type library with info %s is not being remembered!"
+            % (info,)
+        )
+    # and drop any version redirects to it
+    for key, val in list(versionRedirectMap.items()):
+        if val == info:
+            del versionRedirectMap[key]
+
+
+def EnsureModule(
+    typelibCLSID,
+    lcid,
+    major,
+    minor,
+    progressInstance=None,
+    bValidateFile=not is_readonly,
+    bForDemand=bForDemandDefault,
+    bBuildHidden=1,
+):
+    """Ensure Python support is loaded for a type library, generating if necessary.
+
+    Given the IID, LCID and version information for a type library, check and if
+    necessary (re)generate, then import the necessary support files. If we regenerate the file, there
+    is no way to totally snuff out all instances of the old module in Python, and thus we will regenerate the file more than necessary,
+    unless makepy/genpy is modified accordingly.
+
+
+    Returns the Python module.  No exceptions are caught during the generate process.
+
+    Params
+    typelibCLSID -- IID of the type library.
+    major -- Integer major version.
+    minor -- Integer minor version
+    lcid -- Integer LCID for the library.
+    progressInstance -- Instance to use as progress indicator, or None to
+                        use the GUI progress bar.
+    bValidateFile -- Whether or not to perform cache validation or not
+    bForDemand -- Should a complete generation happen now, or on demand?
+    bBuildHidden -- Should hidden members/attributes etc be generated?
+    """
+    bReloadNeeded = 0
+    try:
+        try:
+            module = GetModuleForTypelib(typelibCLSID, lcid, major, minor)
+        except ImportError:
+            # If we get an ImportError
+            # We may still find a valid cache file under a different MinorVersion #
+            # (which windows will search out for us)
+            # print "Loading reg typelib", typelibCLSID, major, minor, lcid
+            module = None
+            try:
+                tlbAttr = pythoncom.LoadRegTypeLib(
+                    typelibCLSID, major, minor, lcid
+                ).GetLibAttr()
+                # if the above line doesn't throw a pythoncom.com_error, check if
+                # it is actually a different lib than we requested, and if so, suck it in
+                if tlbAttr[1] != lcid or tlbAttr[4] != minor:
+                    # print "Trying 2nd minor #", tlbAttr[1], tlbAttr[3], tlbAttr[4]
+                    try:
+                        module = GetModuleForTypelib(
+                            typelibCLSID, tlbAttr[1], tlbAttr[3], tlbAttr[4]
+                        )
+                    except ImportError:
+                        # We don't have a module, but we do have a better minor
+                        # version - remember that.
+                        minor = tlbAttr[4]
+                # else module remains None
+            except pythoncom.com_error:
+                # couldn't load any typelib - mod remains None
+                pass
+        if module is not None and bValidateFile:
+            assert not is_readonly, "Can't validate in a read-only gencache"
+            try:
+                typLibPath = pythoncom.QueryPathOfRegTypeLib(
+                    typelibCLSID, major, minor, lcid
+                )
+                # windows seems to add an extra \0 (via the underlying BSTR)
+                # The mainwin toolkit does not add this erroneous \0
+                if typLibPath[-1] == "\0":
+                    typLibPath = typLibPath[:-1]
+                suf = getattr(os.path, "supports_unicode_filenames", 0)
+                if not suf:
+                    # can't pass unicode filenames directly - convert
+                    try:
+                        typLibPath = typLibPath.encode(sys.getfilesystemencoding())
+                    except AttributeError:  # no sys.getfilesystemencoding
+                        typLibPath = str(typLibPath)
+                tlbAttributes = pythoncom.LoadRegTypeLib(
+                    typelibCLSID, major, minor, lcid
+                ).GetLibAttr()
+            except pythoncom.com_error:
+                # We have a module, but no type lib - we should still
+                # run with what we have though - the typelib may not be
+                # deployed here.
+                bValidateFile = 0
+        if module is not None and bValidateFile:
+            assert not is_readonly, "Can't validate in a read-only gencache"
+            filePathPrefix = "%s\\%s" % (
+                GetGeneratePath(),
+                GetGeneratedFileName(typelibCLSID, lcid, major, minor),
+            )
+            filePath = filePathPrefix + ".py"
+            filePathPyc = filePathPrefix + ".py"
+            if __debug__:
+                filePathPyc = filePathPyc + "c"
+            else:
+                filePathPyc = filePathPyc + "o"
+            # Verify that type library is up to date.
+            # If we have a differing MinorVersion or genpy has bumped versions, update the file
+            from . import genpy
+
+            if (
+                module.MinorVersion != tlbAttributes[4]
+                or genpy.makepy_version != module.makepy_version
+            ):
+                # print "Version skew: %d, %d" % (module.MinorVersion, tlbAttributes[4])
+                # try to erase the bad file from the cache
+                try:
+                    os.unlink(filePath)
+                except os.error:
+                    pass
+                try:
+                    os.unlink(filePathPyc)
+                except os.error:
+                    pass
+                if os.path.isdir(filePathPrefix):
+                    import shutil
+
+                    shutil.rmtree(filePathPrefix)
+                minor = tlbAttributes[4]
+                module = None
+                bReloadNeeded = 1
+            else:
+                minor = module.MinorVersion
+                filePathPrefix = "%s\\%s" % (
+                    GetGeneratePath(),
+                    GetGeneratedFileName(typelibCLSID, lcid, major, minor),
+                )
+                filePath = filePathPrefix + ".py"
+                filePathPyc = filePathPrefix + ".pyc"
+                # print "Trying py stat: ", filePath
+                fModTimeSet = 0
+                try:
+                    pyModTime = os.stat(filePath)[8]
+                    fModTimeSet = 1
+                except os.error as e:
+                    # If .py file fails, try .pyc file
+                    # print "Trying pyc stat", filePathPyc
+                    try:
+                        pyModTime = os.stat(filePathPyc)[8]
+                        fModTimeSet = 1
+                    except os.error as e:
+                        pass
+                # print "Trying stat typelib", pyModTime
+                # print str(typLibPath)
+                typLibModTime = os.stat(typLibPath)[8]
+                if fModTimeSet and (typLibModTime > pyModTime):
+                    bReloadNeeded = 1
+                    module = None
+    except (ImportError, os.error):
+        module = None
+    if module is None:
+        # We need to build an item.  If we are in a read-only cache, we
+        # can't/don't want to do this - so before giving up, check for
+        # a different minor version in our cache - according to COM, this is OK
+        if is_readonly:
+            key = str(typelibCLSID), lcid, major, minor
+            # If we have been asked before, get last result.
+            try:
+                return versionRedirectMap[key]
+            except KeyError:
+                pass
+            # Find other candidates.
+            items = []
+            for desc in GetGeneratedInfos():
+                if key[0] == desc[0] and key[1] == desc[1] and key[2] == desc[2]:
+                    items.append(desc)
+            if items:
+                # Items are all identical, except for last tuple element
+                # We want the latest minor version we have - so just sort and grab last
+                items.sort()
+                new_minor = items[-1][3]
+                ret = GetModuleForTypelib(typelibCLSID, lcid, major, new_minor)
+            else:
+                ret = None
+            # remember and return
+            versionRedirectMap[key] = ret
+            return ret
+        # print "Rebuilding: ", major, minor
+        module = MakeModuleForTypelib(
+            typelibCLSID,
+            lcid,
+            major,
+            minor,
+            progressInstance,
+            bForDemand=bForDemand,
+            bBuildHidden=bBuildHidden,
+        )
+        # If we replaced something, reload it
+        if bReloadNeeded:
+            module = reload(module)
+            AddModuleToCache(typelibCLSID, lcid, major, minor)
+    return module
+
+
+def EnsureDispatch(
+    prog_id, bForDemand=1
+):  # New fn, so we default the new demand feature to on!
+    """Given a COM prog_id, return an object that is using makepy support, building if necessary"""
+    disp = win32com.client.Dispatch(prog_id)
+    if not disp.__dict__.get("CLSID"):  # Eeek - no makepy support - try and build it.
+        try:
+            ti = disp._oleobj_.GetTypeInfo()
+            disp_clsid = ti.GetTypeAttr()[0]
+            tlb, index = ti.GetContainingTypeLib()
+            tla = tlb.GetLibAttr()
+            mod = EnsureModule(tla[0], tla[1], tla[3], tla[4], bForDemand=bForDemand)
+            GetModuleForCLSID(disp_clsid)
+            # Get the class from the module.
+            from . import CLSIDToClass
+
+            disp_class = CLSIDToClass.GetClass(str(disp_clsid))
+            disp = disp_class(disp._oleobj_)
+        except pythoncom.com_error:
+            raise TypeError(
+                "This COM object can not automate the makepy process - please run makepy manually for this object"
+            )
+    return disp
+
+
+def AddModuleToCache(
+    typelibclsid, lcid, major, minor, verbose=1, bFlushNow=not is_readonly
+):
+    """Add a newly generated file to the cache dictionary."""
+    fname = GetGeneratedFileName(typelibclsid, lcid, major, minor)
+    mod = _GetModule(fname)
+    # if mod._in_gencache_ is already true, then we are reloading this
+    # module - this doesn't mean anything special though!
+    mod._in_gencache_ = 1
+    info = str(typelibclsid), lcid, major, minor
+    dict_modified = False
+
+    def SetTypelibForAllClsids(dict):
+        nonlocal dict_modified
+        for clsid, cls in dict.items():
+            if clsidToTypelib.get(clsid) != info:
+                clsidToTypelib[clsid] = info
+                dict_modified = True
+
+    SetTypelibForAllClsids(mod.CLSIDToClassMap)
+    SetTypelibForAllClsids(mod.CLSIDToPackageMap)
+    SetTypelibForAllClsids(mod.VTablesToClassMap)
+    SetTypelibForAllClsids(mod.VTablesToPackageMap)
+
+    # If this lib was previously redirected, drop it
+    if info in versionRedirectMap:
+        del versionRedirectMap[info]
+    if bFlushNow and dict_modified:
+        _SaveDicts()
+
+
+def GetGeneratedInfos():
+    zip_pos = win32com.__gen_path__.find(".zip\\")
+    if zip_pos >= 0:
+        import zipfile
+
+        zip_file = win32com.__gen_path__[: zip_pos + 4]
+        zip_path = win32com.__gen_path__[zip_pos + 5 :].replace("\\", "/")
+        zf = zipfile.ZipFile(zip_file)
+        infos = {}
+        for n in zf.namelist():
+            if not n.startswith(zip_path):
+                continue
+            base = n[len(zip_path) + 1 :].split("/")[0]
+            try:
+                iid, lcid, major, minor = base.split("x")
+                lcid = int(lcid)
+                major = int(major)
+                minor = int(minor)
+                iid = pywintypes.IID("{" + iid + "}")
+            except ValueError:
+                continue
+            except pywintypes.com_error:
+                # invalid IID
+                continue
+            infos[(iid, lcid, major, minor)] = 1
+        zf.close()
+        return list(infos.keys())
+    else:
+        # on the file system
+        files = glob.glob(win32com.__gen_path__ + "\\*")
+        ret = []
+        for file in files:
+            if not os.path.isdir(file) and not os.path.splitext(file)[1] == ".py":
+                continue
+            name = os.path.splitext(os.path.split(file)[1])[0]
+            try:
+                iid, lcid, major, minor = name.split("x")
+                iid = pywintypes.IID("{" + iid + "}")
+                lcid = int(lcid)
+                major = int(major)
+                minor = int(minor)
+            except ValueError:
+                continue
+            except pywintypes.com_error:
+                # invalid IID
+                continue
+            ret.append((iid, lcid, major, minor))
+        return ret
+
+
+def _GetModule(fname):
+    """Given the name of a module in the gen_py directory, import and return it."""
+    mod_name = "win32com.gen_py.%s" % fname
+    mod = __import__(mod_name)
+    return sys.modules[mod_name]
+
+
+def Rebuild(verbose=1):
+    """Rebuild the cache indexes from the file system."""
+    clsidToTypelib.clear()
+    infos = GetGeneratedInfos()
+    if verbose and len(infos):  # Dont bother reporting this when directory is empty!
+        print("Rebuilding cache of generated files for COM support...")
+    for info in infos:
+        iid, lcid, major, minor = info
+        if verbose:
+            print("Checking", GetGeneratedFileName(*info))
+        try:
+            AddModuleToCache(iid, lcid, major, minor, verbose, 0)
+        except:
+            print(
+                "Could not add module %s - %s: %s"
+                % (info, sys.exc_info()[0], sys.exc_info()[1])
+            )
+    if verbose and len(infos):  # Dont bother reporting this when directory is empty!
+        print("Done.")
+    _SaveDicts()
+
+
+def _Dump():
+    print("Cache is in directory", win32com.__gen_path__)
+    # Build a unique dir
+    d = {}
+    for clsid, (typelibCLSID, lcid, major, minor) in clsidToTypelib.items():
+        d[typelibCLSID, lcid, major, minor] = None
+    for typelibCLSID, lcid, major, minor in d.keys():
+        mod = GetModuleForTypelib(typelibCLSID, lcid, major, minor)
+        print("%s - %s" % (mod.__doc__, typelibCLSID))
+
+
+# Boot up
+__init__()
+
+
+def usage():
+    usageString = """\
+	  Usage: gencache [-q] [-d] [-r]
+
+			 -q         - Quiet
+			 -d         - Dump the cache (typelibrary description and filename).
+			 -r         - Rebuild the cache dictionary from the existing .py files
+	"""
+    print(usageString)
+    sys.exit(1)
+
+
+if __name__ == "__main__":
+    import getopt
+
+    try:
+        opts, args = getopt.getopt(sys.argv[1:], "qrd")
+    except getopt.error as message:
+        print(message)
+        usage()
+
+    # we only have options - complain about real args, or none at all!
+    if len(sys.argv) == 1 or args:
+        print(usage())
+
+    verbose = 1
+    for opt, val in opts:
+        if opt == "-d":  # Dump
+            _Dump()
+        if opt == "-r":
+            Rebuild(verbose)
+        if opt == "-q":
+            verbose = 0
diff --git a/lib/win32com/client/genpy.py b/lib/win32com/client/genpy.py
new file mode 100644
index 00000000..3eba075f
--- /dev/null
+++ b/lib/win32com/client/genpy.py
@@ -0,0 +1,1411 @@
+"""genpy.py - The worker for makepy.  See makepy.py for more details
+
+This code was moved simply to speed Python in normal circumstances.  As the makepy.py
+is normally run from the command line, it reparses the code each time.  Now makepy
+is nothing more than the command line handler and public interface.
+
+The makepy command line etc handling is also getting large enough in its own right!
+"""
+
+# NOTE - now supports a "demand" mechanism - the top-level is a package, and
+# each class etc can be made individually.
+# This should eventually become the default.
+# Then the old non-package technique should be removed.
+# There should be no b/w compat issues, and will just help clean the code.
+# This will be done once the new "demand" mechanism gets a good workout.
+import os
+import sys
+import time
+
+import pythoncom
+import win32com
+
+from . import build
+
+error = "makepy.error"
+makepy_version = "0.5.01"  # Written to generated file.
+
+GEN_FULL = "full"
+GEN_DEMAND_BASE = "demand(base)"
+GEN_DEMAND_CHILD = "demand(child)"
+
+# This map is used purely for the users benefit -it shows the
+# raw, underlying type of Alias/Enums, etc.  The COM implementation
+# does not use this map at runtime - all Alias/Enum have already
+# been translated.
+mapVTToTypeString = {
+    pythoncom.VT_I2: "types.IntType",
+    pythoncom.VT_I4: "types.IntType",
+    pythoncom.VT_R4: "types.FloatType",
+    pythoncom.VT_R8: "types.FloatType",
+    pythoncom.VT_BSTR: "types.StringType",
+    pythoncom.VT_BOOL: "types.IntType",
+    pythoncom.VT_VARIANT: "types.TypeType",
+    pythoncom.VT_I1: "types.IntType",
+    pythoncom.VT_UI1: "types.IntType",
+    pythoncom.VT_UI2: "types.IntType",
+    pythoncom.VT_UI4: "types.IntType",
+    pythoncom.VT_I8: "types.LongType",
+    pythoncom.VT_UI8: "types.LongType",
+    pythoncom.VT_INT: "types.IntType",
+    pythoncom.VT_DATE: "pythoncom.PyTimeType",
+    pythoncom.VT_UINT: "types.IntType",
+}
+
+
+# Given a propget function's arg desc, return the default parameters for all
+# params bar the first.  Eg, then Python does a:
+# object.Property = "foo"
+# Python can only pass the "foo" value.  If the property has
+# multiple args, and the rest have default values, this allows
+# Python to correctly pass those defaults.
+def MakeDefaultArgsForPropertyPut(argsDesc):
+    ret = []
+    for desc in argsDesc[1:]:
+        default = build.MakeDefaultArgRepr(desc)
+        if default is None:
+            break
+        ret.append(default)
+    return tuple(ret)
+
+
+def MakeMapLineEntry(dispid, wFlags, retType, argTypes, user, resultCLSID):
+    # Strip the default value
+    argTypes = tuple([what[:2] for what in argTypes])
+    return '(%s, %d, %s, %s, "%s", %s)' % (
+        dispid,
+        wFlags,
+        retType[:2],
+        argTypes,
+        user,
+        resultCLSID,
+    )
+
+
+def MakeEventMethodName(eventName):
+    if eventName[:2] == "On":
+        return eventName
+    else:
+        return "On" + eventName
+
+
+def WriteSinkEventMap(obj, stream):
+    print("\t_dispid_to_func_ = {", file=stream)
+    for name, entry in (
+        list(obj.propMapGet.items())
+        + list(obj.propMapPut.items())
+        + list(obj.mapFuncs.items())
+    ):
+        fdesc = entry.desc
+        print(
+            '\t\t%9d : "%s",' % (fdesc.memid, MakeEventMethodName(entry.names[0])),
+            file=stream,
+        )
+    print("\t\t}", file=stream)
+
+
+# MI is used to join my writable helpers, and the OLE
+# classes.
+class WritableItem:
+    # __cmp__ used for sorting in py2x...
+    def __cmp__(self, other):
+        "Compare for sorting"
+        ret = cmp(self.order, other.order)
+        if ret == 0 and self.doc:
+            ret = cmp(self.doc[0], other.doc[0])
+        return ret
+
+    # ... but not used in py3k - __lt__ minimum needed there
+    def __lt__(self, other):  # py3k variant
+        if self.order == other.order:
+            return self.doc < other.doc
+        return self.order < other.order
+
+    def __repr__(self):
+        return "OleItem: doc=%s, order=%d" % (repr(self.doc), self.order)
+
+
+class RecordItem(build.OleItem, WritableItem):
+    order = 9
+    typename = "RECORD"
+
+    def __init__(self, typeInfo, typeAttr, doc=None, bForUser=1):
+        ##    sys.stderr.write("Record %s: size %s\n" % (doc,typeAttr.cbSizeInstance))
+        ##    sys.stderr.write(" cVars = %s\n" % (typeAttr.cVars,))
+        ##    for i in range(typeAttr.cVars):
+        ##        vdesc = typeInfo.GetVarDesc(i)
+        ##        sys.stderr.write(" Var %d has value %s, type %d, desc=%s\n" % (i, vdesc.value, vdesc.varkind, vdesc.elemdescVar))
+        ##        sys.stderr.write(" Doc is %s\n" % (typeInfo.GetDocumentation(vdesc.memid),))
+
+        build.OleItem.__init__(self, doc)
+        self.clsid = typeAttr[0]
+
+    def WriteClass(self, generator):
+        pass
+
+
+# Given an enum, write all aliases for it.
+# (no longer necessary for new style code, but still used for old code.
+def WriteAliasesForItem(item, aliasItems, stream):
+    for alias in aliasItems.values():
+        if item.doc and alias.aliasDoc and (alias.aliasDoc[0] == item.doc[0]):
+            alias.WriteAliasItem(aliasItems, stream)
+
+
+class AliasItem(build.OleItem, WritableItem):
+    order = 2
+    typename = "ALIAS"
+
+    def __init__(self, typeinfo, attr, doc=None, bForUser=1):
+        build.OleItem.__init__(self, doc)
+
+        ai = attr[14]
+        self.attr = attr
+        if type(ai) == type(()) and type(ai[1]) == type(
+            0
+        ):  # XXX - This is a hack - why tuples?  Need to resolve?
+            href = ai[1]
+            alinfo = typeinfo.GetRefTypeInfo(href)
+            self.aliasDoc = alinfo.GetDocumentation(-1)
+            self.aliasAttr = alinfo.GetTypeAttr()
+        else:
+            self.aliasDoc = None
+            self.aliasAttr = None
+
+    def WriteAliasItem(self, aliasDict, stream):
+        # we could have been written as part of an alias dependency
+        if self.bWritten:
+            return
+
+        if self.aliasDoc:
+            depName = self.aliasDoc[0]
+            if depName in aliasDict:
+                aliasDict[depName].WriteAliasItem(aliasDict, stream)
+            print(self.doc[0] + " = " + depName, file=stream)
+        else:
+            ai = self.attr[14]
+            if type(ai) == type(0):
+                try:
+                    typeStr = mapVTToTypeString[ai]
+                    print("# %s=%s" % (self.doc[0], typeStr), file=stream)
+                except KeyError:
+                    print(
+                        self.doc[0] + " = None # Can't convert alias info " + str(ai),
+                        file=stream,
+                    )
+        print(file=stream)
+        self.bWritten = 1
+
+
+class EnumerationItem(build.OleItem, WritableItem):
+    order = 1
+    typename = "ENUMERATION"
+
+    def __init__(self, typeinfo, attr, doc=None, bForUser=1):
+        build.OleItem.__init__(self, doc)
+
+        self.clsid = attr[0]
+        self.mapVars = {}
+        typeFlags = attr[11]
+        self.hidden = (
+            typeFlags & pythoncom.TYPEFLAG_FHIDDEN
+            or typeFlags & pythoncom.TYPEFLAG_FRESTRICTED
+        )
+
+        for j in range(attr[7]):
+            vdesc = typeinfo.GetVarDesc(j)
+            name = typeinfo.GetNames(vdesc[0])[0]
+            self.mapVars[name] = build.MapEntry(vdesc)
+
+    ##  def WriteEnumerationHeaders(self, aliasItems, stream):
+    ##    enumName = self.doc[0]
+    ##    print >> stream "%s=constants # Compatibility with previous versions." % (enumName)
+    ##    WriteAliasesForItem(self, aliasItems)
+
+    def WriteEnumerationItems(self, stream):
+        num = 0
+        enumName = self.doc[0]
+        # Write in name alpha order
+        names = list(self.mapVars.keys())
+        names.sort()
+        for name in names:
+            entry = self.mapVars[name]
+            vdesc = entry.desc
+            if vdesc[4] == pythoncom.VAR_CONST:
+                val = vdesc[1]
+
+                use = repr(val)
+                # Make sure the repr of the value is valid python syntax
+                # still could cause an error on import if it contains a module or type name
+                # not available in the global namespace
+                try:
+                    compile(use, "<makepy>", "eval")
+                except SyntaxError:
+                    # At least add the repr as a string, so it can be investigated further
+                    # Sanitize it, in case the repr contains its own quotes.  (??? line breaks too ???)
+                    use = use.replace('"', "'")
+                    use = (
+                        '"'
+                        + use
+                        + '"'
+                        + " # This VARIANT type cannot be converted automatically"
+                    )
+                print(
+                    "\t%-30s=%-10s # from enum %s"
+                    % (build.MakePublicAttributeName(name, True), use, enumName),
+                    file=stream,
+                )
+                num += 1
+        return num
+
+
+class VTableItem(build.VTableItem, WritableItem):
+    order = 4
+
+    def WriteClass(self, generator):
+        self.WriteVTableMap(generator)
+        self.bWritten = 1
+
+    def WriteVTableMap(self, generator):
+        stream = generator.file
+        print(
+            "%s_vtables_dispatch_ = %d" % (self.python_name, self.bIsDispatch),
+            file=stream,
+        )
+        print("%s_vtables_ = [" % (self.python_name,), file=stream)
+        for v in self.vtableFuncs:
+            names, dispid, desc = v
+            assert desc.desckind == pythoncom.DESCKIND_FUNCDESC
+            arg_reprs = []
+            # more hoops so we don't generate huge lines.
+            item_num = 0
+            print("\t((", end=" ", file=stream)
+            for name in names:
+                print(repr(name), ",", end=" ", file=stream)
+                item_num = item_num + 1
+                if item_num % 5 == 0:
+                    print("\n\t\t\t", end=" ", file=stream)
+            print(
+                "), %d, (%r, %r, [" % (dispid, desc.memid, desc.scodeArray),
+                end=" ",
+                file=stream,
+            )
+            for arg in desc.args:
+                item_num = item_num + 1
+                if item_num % 5 == 0:
+                    print("\n\t\t\t", end=" ", file=stream)
+                defval = build.MakeDefaultArgRepr(arg)
+                if arg[3] is None:
+                    arg3_repr = None
+                else:
+                    arg3_repr = repr(arg[3])
+                print(
+                    repr((arg[0], arg[1], defval, arg3_repr)), ",", end=" ", file=stream
+                )
+            print("],", end=" ", file=stream)
+            print(repr(desc.funckind), ",", end=" ", file=stream)
+            print(repr(desc.invkind), ",", end=" ", file=stream)
+            print(repr(desc.callconv), ",", end=" ", file=stream)
+            print(repr(desc.cParamsOpt), ",", end=" ", file=stream)
+            print(repr(desc.oVft), ",", end=" ", file=stream)
+            print(repr(desc.rettype), ",", end=" ", file=stream)
+            print(repr(desc.wFuncFlags), ",", end=" ", file=stream)
+            print(")),", file=stream)
+        print("]", file=stream)
+        print(file=stream)
+
+
+class DispatchItem(build.DispatchItem, WritableItem):
+    order = 3
+
+    def __init__(self, typeinfo, attr, doc=None):
+        build.DispatchItem.__init__(self, typeinfo, attr, doc)
+        self.type_attr = attr
+        self.coclass_clsid = None
+
+    def WriteClass(self, generator):
+        if (
+            not self.bIsDispatch
+            and not self.type_attr.typekind == pythoncom.TKIND_DISPATCH
+        ):
+            return
+        # This is pretty screwey - now we have vtable support we
+        # should probably rethink this (ie, maybe write both sides for sinks, etc)
+        if self.bIsSink:
+            self.WriteEventSinkClassHeader(generator)
+            self.WriteCallbackClassBody(generator)
+        else:
+            self.WriteClassHeader(generator)
+            self.WriteClassBody(generator)
+        print(file=generator.file)
+        self.bWritten = 1
+
+    def WriteClassHeader(self, generator):
+        generator.checkWriteDispatchBaseClass()
+        doc = self.doc
+        stream = generator.file
+        print("class " + self.python_name + "(DispatchBaseClass):", file=stream)
+        if doc[1]:
+            print("\t" + build._makeDocString(doc[1]), file=stream)
+        try:
+            progId = pythoncom.ProgIDFromCLSID(self.clsid)
+            print(
+                "\t# This class is creatable by the name '%s'" % (progId), file=stream
+            )
+        except pythoncom.com_error:
+            pass
+        print("\tCLSID = " + repr(self.clsid), file=stream)
+        if self.coclass_clsid is None:
+            print("\tcoclass_clsid = None", file=stream)
+        else:
+            print("\tcoclass_clsid = " + repr(self.coclass_clsid), file=stream)
+        print(file=stream)
+        self.bWritten = 1
+
+    def WriteEventSinkClassHeader(self, generator):
+        generator.checkWriteEventBaseClass()
+        doc = self.doc
+        stream = generator.file
+        print("class " + self.python_name + ":", file=stream)
+        if doc[1]:
+            print("\t" + build._makeDocString(doc[1]), file=stream)
+        try:
+            progId = pythoncom.ProgIDFromCLSID(self.clsid)
+            print(
+                "\t# This class is creatable by the name '%s'" % (progId), file=stream
+            )
+        except pythoncom.com_error:
+            pass
+        print("\tCLSID = CLSID_Sink = " + repr(self.clsid), file=stream)
+        if self.coclass_clsid is None:
+            print("\tcoclass_clsid = None", file=stream)
+        else:
+            print("\tcoclass_clsid = " + repr(self.coclass_clsid), file=stream)
+        print("\t_public_methods_ = [] # For COM Server support", file=stream)
+        WriteSinkEventMap(self, stream)
+        print(file=stream)
+        print("\tdef __init__(self, oobj = None):", file=stream)
+        print("\t\tif oobj is None:", file=stream)
+        print("\t\t\tself._olecp = None", file=stream)
+        print("\t\telse:", file=stream)
+        print("\t\t\timport win32com.server.util", file=stream)
+        print(
+            "\t\t\tfrom win32com.server.policy import EventHandlerPolicy", file=stream
+        )
+        print(
+            "\t\t\tcpc=oobj._oleobj_.QueryInterface(pythoncom.IID_IConnectionPointContainer)",
+            file=stream,
+        )
+        print("\t\t\tcp=cpc.FindConnectionPoint(self.CLSID_Sink)", file=stream)
+        print(
+            "\t\t\tcookie=cp.Advise(win32com.server.util.wrap(self, usePolicy=EventHandlerPolicy))",
+            file=stream,
+        )
+        print("\t\t\tself._olecp,self._olecp_cookie = cp,cookie", file=stream)
+        print("\tdef __del__(self):", file=stream)
+        print("\t\ttry:", file=stream)
+        print("\t\t\tself.close()", file=stream)
+        print("\t\texcept pythoncom.com_error:", file=stream)
+        print("\t\t\tpass", file=stream)
+        print("\tdef close(self):", file=stream)
+        print("\t\tif self._olecp is not None:", file=stream)
+        print(
+            "\t\t\tcp,cookie,self._olecp,self._olecp_cookie = self._olecp,self._olecp_cookie,None,None",
+            file=stream,
+        )
+        print("\t\t\tcp.Unadvise(cookie)", file=stream)
+        print("\tdef _query_interface_(self, iid):", file=stream)
+        print("\t\timport win32com.server.util", file=stream)
+        print(
+            "\t\tif iid==self.CLSID_Sink: return win32com.server.util.wrap(self)",
+            file=stream,
+        )
+        print(file=stream)
+        self.bWritten = 1
+
+    def WriteCallbackClassBody(self, generator):
+        stream = generator.file
+        print("\t# Event Handlers", file=stream)
+        print(
+            "\t# If you create handlers, they should have the following prototypes:",
+            file=stream,
+        )
+        for name, entry in (
+            list(self.propMapGet.items())
+            + list(self.propMapPut.items())
+            + list(self.mapFuncs.items())
+        ):
+            fdesc = entry.desc
+            methName = MakeEventMethodName(entry.names[0])
+            print(
+                "#\tdef "
+                + methName
+                + "(self"
+                + build.BuildCallList(
+                    fdesc,
+                    entry.names,
+                    "defaultNamedOptArg",
+                    "defaultNamedNotOptArg",
+                    "defaultUnnamedArg",
+                    "pythoncom.Missing",
+                    is_comment=True,
+                )
+                + "):",
+                file=stream,
+            )
+            if entry.doc and entry.doc[1]:
+                print("#\t\t" + build._makeDocString(entry.doc[1]), file=stream)
+        print(file=stream)
+        self.bWritten = 1
+
+    def WriteClassBody(self, generator):
+        stream = generator.file
+        # Write in alpha order.
+        names = list(self.mapFuncs.keys())
+        names.sort()
+        specialItems = {
+            "count": None,
+            "item": None,
+            "value": None,
+            "_newenum": None,
+        }  # If found, will end up with (entry, invoke_tupe)
+        itemCount = None
+        for name in names:
+            entry = self.mapFuncs[name]
+            assert entry.desc.desckind == pythoncom.DESCKIND_FUNCDESC
+            # skip [restricted] methods, unless it is the
+            # enumerator (which, being part of the "system",
+            # we know about and can use)
+            dispid = entry.desc.memid
+            if (
+                entry.desc.wFuncFlags & pythoncom.FUNCFLAG_FRESTRICTED
+                and dispid != pythoncom.DISPID_NEWENUM
+            ):
+                continue
+            # If not accessible via IDispatch, then we can't use it here.
+            if entry.desc.funckind != pythoncom.FUNC_DISPATCH:
+                continue
+            if dispid == pythoncom.DISPID_VALUE:
+                lkey = "value"
+            elif dispid == pythoncom.DISPID_NEWENUM:
+                specialItems["_newenum"] = (entry, entry.desc.invkind, None)
+                continue  # Dont build this one now!
+            else:
+                lkey = name.lower()
+            if (
+                lkey in specialItems and specialItems[lkey] is None
+            ):  # remember if a special one.
+                specialItems[lkey] = (entry, entry.desc.invkind, None)
+            if generator.bBuildHidden or not entry.hidden:
+                if entry.GetResultName():
+                    print("\t# Result is of type " + entry.GetResultName(), file=stream)
+                if entry.wasProperty:
+                    print(
+                        "\t# The method %s is actually a property, but must be used as a method to correctly pass the arguments"
+                        % name,
+                        file=stream,
+                    )
+                ret = self.MakeFuncMethod(entry, build.MakePublicAttributeName(name))
+                for line in ret:
+                    print(line, file=stream)
+        print("\t_prop_map_get_ = {", file=stream)
+        names = list(self.propMap.keys())
+        names.sort()
+        for key in names:
+            entry = self.propMap[key]
+            if generator.bBuildHidden or not entry.hidden:
+                resultName = entry.GetResultName()
+                if resultName:
+                    print(
+                        "\t\t# Property '%s' is an object of type '%s'"
+                        % (key, resultName),
+                        file=stream,
+                    )
+                lkey = key.lower()
+                details = entry.desc
+                resultDesc = details[2]
+                argDesc = ()
+                mapEntry = MakeMapLineEntry(
+                    details.memid,
+                    pythoncom.DISPATCH_PROPERTYGET,
+                    resultDesc,
+                    argDesc,
+                    key,
+                    entry.GetResultCLSIDStr(),
+                )
+
+                if details.memid == pythoncom.DISPID_VALUE:
+                    lkey = "value"
+                elif details.memid == pythoncom.DISPID_NEWENUM:
+                    lkey = "_newenum"
+                else:
+                    lkey = key.lower()
+                if (
+                    lkey in specialItems and specialItems[lkey] is None
+                ):  # remember if a special one.
+                    specialItems[lkey] = (
+                        entry,
+                        pythoncom.DISPATCH_PROPERTYGET,
+                        mapEntry,
+                    )
+                    # All special methods, except _newenum, are written
+                    # "normally".  This is a mess!
+                    if details.memid == pythoncom.DISPID_NEWENUM:
+                        continue
+
+                print(
+                    '\t\t"%s": %s,' % (build.MakePublicAttributeName(key), mapEntry),
+                    file=stream,
+                )
+        names = list(self.propMapGet.keys())
+        names.sort()
+        for key in names:
+            entry = self.propMapGet[key]
+            if generator.bBuildHidden or not entry.hidden:
+                if entry.GetResultName():
+                    print(
+                        "\t\t# Method '%s' returns object of type '%s'"
+                        % (key, entry.GetResultName()),
+                        file=stream,
+                    )
+                details = entry.desc
+                assert details.desckind == pythoncom.DESCKIND_FUNCDESC
+                lkey = key.lower()
+                argDesc = details[2]
+                resultDesc = details[8]
+                mapEntry = MakeMapLineEntry(
+                    details[0],
+                    pythoncom.DISPATCH_PROPERTYGET,
+                    resultDesc,
+                    argDesc,
+                    key,
+                    entry.GetResultCLSIDStr(),
+                )
+                if details.memid == pythoncom.DISPID_VALUE:
+                    lkey = "value"
+                elif details.memid == pythoncom.DISPID_NEWENUM:
+                    lkey = "_newenum"
+                else:
+                    lkey = key.lower()
+                if (
+                    lkey in specialItems and specialItems[lkey] is None
+                ):  # remember if a special one.
+                    specialItems[lkey] = (
+                        entry,
+                        pythoncom.DISPATCH_PROPERTYGET,
+                        mapEntry,
+                    )
+                    # All special methods, except _newenum, are written
+                    # "normally".  This is a mess!
+                    if details.memid == pythoncom.DISPID_NEWENUM:
+                        continue
+                print(
+                    '\t\t"%s": %s,' % (build.MakePublicAttributeName(key), mapEntry),
+                    file=stream,
+                )
+
+        print("\t}", file=stream)
+
+        print("\t_prop_map_put_ = {", file=stream)
+        # These are "Invoke" args
+        names = list(self.propMap.keys())
+        names.sort()
+        for key in names:
+            entry = self.propMap[key]
+            if generator.bBuildHidden or not entry.hidden:
+                lkey = key.lower()
+                details = entry.desc
+                # If default arg is None, write an empty tuple
+                defArgDesc = build.MakeDefaultArgRepr(details[2])
+                if defArgDesc is None:
+                    defArgDesc = ""
+                else:
+                    defArgDesc = defArgDesc + ","
+                print(
+                    '\t\t"%s" : ((%s, LCID, %d, 0),(%s)),'
+                    % (
+                        build.MakePublicAttributeName(key),
+                        details[0],
+                        pythoncom.DISPATCH_PROPERTYPUT,
+                        defArgDesc,
+                    ),
+                    file=stream,
+                )
+
+        names = list(self.propMapPut.keys())
+        names.sort()
+        for key in names:
+            entry = self.propMapPut[key]
+            if generator.bBuildHidden or not entry.hidden:
+                details = entry.desc
+                defArgDesc = MakeDefaultArgsForPropertyPut(details[2])
+                print(
+                    '\t\t"%s": ((%s, LCID, %d, 0),%s),'
+                    % (
+                        build.MakePublicAttributeName(key),
+                        details[0],
+                        details[4],
+                        defArgDesc,
+                    ),
+                    file=stream,
+                )
+        print("\t}", file=stream)
+
+        if specialItems["value"]:
+            entry, invoketype, propArgs = specialItems["value"]
+            if propArgs is None:
+                typename = "method"
+                ret = self.MakeFuncMethod(entry, "__call__")
+            else:
+                typename = "property"
+                ret = [
+                    "\tdef __call__(self):\n\t\treturn self._ApplyTypes_(*%s)"
+                    % propArgs
+                ]
+            print(
+                "\t# Default %s for this class is '%s'" % (typename, entry.names[0]),
+                file=stream,
+            )
+            for line in ret:
+                print(line, file=stream)
+            print("\tdef __str__(self, *args):", file=stream)
+            print("\t\treturn str(self.__call__(*args))", file=stream)
+            print("\tdef __int__(self, *args):", file=stream)
+            print("\t\treturn int(self.__call__(*args))", file=stream)
+
+        # _NewEnum (DISPID_NEWENUM) does not appear in typelib for many office objects,
+        # but it can still be retrieved at runtime, so  always create __iter__.
+        # Also, some of those same objects use 1-based indexing, causing the old-style
+        # __getitem__ iteration to fail for index 0 where the dynamic iteration succeeds.
+        if specialItems["_newenum"]:
+            enumEntry, invoketype, propArgs = specialItems["_newenum"]
+            assert enumEntry.desc.desckind == pythoncom.DESCKIND_FUNCDESC
+            invkind = enumEntry.desc.invkind
+            # ??? Wouldn't this be the resultCLSID for the iterator itself, rather than the resultCLSID
+            #  for the result of each Next() call, which is what it's used for ???
+            resultCLSID = enumEntry.GetResultCLSIDStr()
+        else:
+            invkind = pythoncom.DISPATCH_METHOD | pythoncom.DISPATCH_PROPERTYGET
+            resultCLSID = "None"
+        # If we dont have a good CLSID for the enum result, assume it is the same as the Item() method.
+        if resultCLSID == "None" and "Item" in self.mapFuncs:
+            resultCLSID = self.mapFuncs["Item"].GetResultCLSIDStr()
+        print("\tdef __iter__(self):", file=stream)
+        print('\t\t"Return a Python iterator for this object"', file=stream)
+        print("\t\ttry:", file=stream)
+        print(
+            "\t\t\tob = self._oleobj_.InvokeTypes(%d,LCID,%d,(13, 10),())"
+            % (pythoncom.DISPID_NEWENUM, invkind),
+            file=stream,
+        )
+        print("\t\texcept pythoncom.error:", file=stream)
+        print(
+            '\t\t\traise TypeError("This object does not support enumeration")',
+            file=stream,
+        )
+        # Iterator is wrapped as PyIEnumVariant, and each result of __next__ is Dispatch'ed if necessary
+        print(
+            "\t\treturn win32com.client.util.Iterator(ob, %s)" % resultCLSID,
+            file=stream,
+        )
+
+        if specialItems["item"]:
+            entry, invoketype, propArgs = specialItems["item"]
+            resultCLSID = entry.GetResultCLSIDStr()
+            print(
+                "\t#This class has Item property/method which allows indexed access with the object[key] syntax.",
+                file=stream,
+            )
+            print(
+                "\t#Some objects will accept a string or other type of key in addition to integers.",
+                file=stream,
+            )
+            print(
+                "\t#Note that many Office objects do not use zero-based indexing.",
+                file=stream,
+            )
+            print("\tdef __getitem__(self, key):", file=stream)
+            print(
+                '\t\treturn self._get_good_object_(self._oleobj_.Invoke(*(%d, LCID, %d, 1, key)), "Item", %s)'
+                % (entry.desc.memid, invoketype, resultCLSID),
+                file=stream,
+            )
+
+        if specialItems["count"]:
+            entry, invoketype, propArgs = specialItems["count"]
+            if propArgs is None:
+                typename = "method"
+                ret = self.MakeFuncMethod(entry, "__len__")
+            else:
+                typename = "property"
+                ret = [
+                    "\tdef __len__(self):\n\t\treturn self._ApplyTypes_(*%s)" % propArgs
+                ]
+            print(
+                "\t#This class has Count() %s - allow len(ob) to provide this"
+                % (typename),
+                file=stream,
+            )
+            for line in ret:
+                print(line, file=stream)
+            # Also include a __nonzero__
+            print(
+                "\t#This class has a __len__ - this is needed so 'if object:' always returns TRUE.",
+                file=stream,
+            )
+            print("\tdef __nonzero__(self):", file=stream)
+            print("\t\treturn True", file=stream)
+
+
+class CoClassItem(build.OleItem, WritableItem):
+    order = 5
+    typename = "COCLASS"
+
+    def __init__(self, typeinfo, attr, doc=None, sources=[], interfaces=[], bForUser=1):
+        build.OleItem.__init__(self, doc)
+        self.clsid = attr[0]
+        self.sources = sources
+        self.interfaces = interfaces
+        self.bIsDispatch = 1  # Pretend it is so it is written to the class map.
+
+    def WriteClass(self, generator):
+        generator.checkWriteCoClassBaseClass()
+        doc = self.doc
+        stream = generator.file
+        if generator.generate_type == GEN_DEMAND_CHILD:
+            # Some special imports we must setup.
+            referenced_items = []
+            for ref, flag in self.sources:
+                referenced_items.append(ref)
+            for ref, flag in self.interfaces:
+                referenced_items.append(ref)
+            print("import sys", file=stream)
+            for ref in referenced_items:
+                print(
+                    "__import__('%s.%s')" % (generator.base_mod_name, ref.python_name),
+                    file=stream,
+                )
+                print(
+                    "%s = sys.modules['%s.%s'].%s"
+                    % (
+                        ref.python_name,
+                        generator.base_mod_name,
+                        ref.python_name,
+                        ref.python_name,
+                    ),
+                    file=stream,
+                )
+                # And pretend we have written it - the name is now available as if we had!
+                ref.bWritten = 1
+        try:
+            progId = pythoncom.ProgIDFromCLSID(self.clsid)
+            print("# This CoClass is known by the name '%s'" % (progId), file=stream)
+        except pythoncom.com_error:
+            pass
+        print(
+            "class %s(CoClassBaseClass): # A CoClass" % (self.python_name), file=stream
+        )
+        if doc and doc[1]:
+            print("\t# " + doc[1], file=stream)
+        print("\tCLSID = %r" % (self.clsid,), file=stream)
+        print("\tcoclass_sources = [", file=stream)
+        defItem = None
+        for item, flag in self.sources:
+            if flag & pythoncom.IMPLTYPEFLAG_FDEFAULT:
+                defItem = item
+            # If we have written a Python class, reference the name -
+            # otherwise just the IID.
+            if item.bWritten:
+                key = item.python_name
+            else:
+                key = repr(str(item.clsid))  # really the iid.
+            print("\t\t%s," % (key), file=stream)
+        print("\t]", file=stream)
+        if defItem:
+            if defItem.bWritten:
+                defName = defItem.python_name
+            else:
+                defName = repr(str(defItem.clsid))  # really the iid.
+            print("\tdefault_source = %s" % (defName,), file=stream)
+        print("\tcoclass_interfaces = [", file=stream)
+        defItem = None
+        for item, flag in self.interfaces:
+            if flag & pythoncom.IMPLTYPEFLAG_FDEFAULT:  # and dual:
+                defItem = item
+            # If we have written a class, reference its name, otherwise the IID
+            if item.bWritten:
+                key = item.python_name
+            else:
+                key = repr(str(item.clsid))  # really the iid.
+            print("\t\t%s," % (key,), file=stream)
+        print("\t]", file=stream)
+        if defItem:
+            if defItem.bWritten:
+                defName = defItem.python_name
+            else:
+                defName = repr(str(defItem.clsid))  # really the iid.
+            print("\tdefault_interface = %s" % (defName,), file=stream)
+        self.bWritten = 1
+        print(file=stream)
+
+
+class GeneratorProgress:
+    def __init__(self):
+        pass
+
+    def Starting(self, tlb_desc):
+        """Called when the process starts."""
+        self.tlb_desc = tlb_desc
+
+    def Finished(self):
+        """Called when the process is complete."""
+
+    def SetDescription(self, desc, maxticks=None):
+        """We are entering a major step.  If maxticks, then this
+        is how many ticks we expect to make until finished
+        """
+
+    def Tick(self, desc=None):
+        """Minor progress step.  Can provide new description if necessary"""
+
+    def VerboseProgress(self, desc):
+        """Verbose/Debugging output."""
+
+    def LogWarning(self, desc):
+        """If a warning is generated"""
+
+    def LogBeginGenerate(self, filename):
+        pass
+
+    def Close(self):
+        pass
+
+
+class Generator:
+    def __init__(
+        self,
+        typelib,
+        sourceFilename,
+        progressObject,
+        bBuildHidden=1,
+        bUnicodeToString=None,
+    ):
+        assert bUnicodeToString is None, "this is deprecated and will go away"
+        self.bHaveWrittenDispatchBaseClass = 0
+        self.bHaveWrittenCoClassBaseClass = 0
+        self.bHaveWrittenEventBaseClass = 0
+        self.typelib = typelib
+        self.sourceFilename = sourceFilename
+        self.bBuildHidden = bBuildHidden
+        self.progress = progressObject
+        # These 2 are later additions and most of the code still 'print's...
+        self.file = None
+
+    def CollectOleItemInfosFromType(self):
+        ret = []
+        for i in range(self.typelib.GetTypeInfoCount()):
+            info = self.typelib.GetTypeInfo(i)
+            infotype = self.typelib.GetTypeInfoType(i)
+            doc = self.typelib.GetDocumentation(i)
+            attr = info.GetTypeAttr()
+            ret.append((info, infotype, doc, attr))
+        return ret
+
+    def _Build_CoClass(self, type_info_tuple):
+        info, infotype, doc, attr = type_info_tuple
+        # find the source and dispinterfaces for the coclass
+        child_infos = []
+        for j in range(attr[8]):
+            flags = info.GetImplTypeFlags(j)
+            try:
+                refType = info.GetRefTypeInfo(info.GetRefTypeOfImplType(j))
+            except pythoncom.com_error:
+                # Can't load a dependent typelib?
+                continue
+            refAttr = refType.GetTypeAttr()
+            child_infos.append(
+                (
+                    info,
+                    refAttr.typekind,
+                    refType,
+                    refType.GetDocumentation(-1),
+                    refAttr,
+                    flags,
+                )
+            )
+
+        # Done generating children - now the CoClass itself.
+        newItem = CoClassItem(info, attr, doc)
+        return newItem, child_infos
+
+    def _Build_CoClassChildren(self, coclass, coclass_info, oleItems, vtableItems):
+        sources = {}
+        interfaces = {}
+        for info, info_type, refType, doc, refAttr, flags in coclass_info:
+            #          sys.stderr.write("Attr typeflags for coclass referenced object %s=%d (%d), typekind=%d\n" % (name, refAttr.wTypeFlags, refAttr.wTypeFlags & pythoncom.TYPEFLAG_FDUAL,refAttr.typekind))
+            if refAttr.typekind == pythoncom.TKIND_DISPATCH or (
+                refAttr.typekind == pythoncom.TKIND_INTERFACE
+                and refAttr[11] & pythoncom.TYPEFLAG_FDISPATCHABLE
+            ):
+                clsid = refAttr[0]
+                if clsid in oleItems:
+                    dispItem = oleItems[clsid]
+                else:
+                    dispItem = DispatchItem(refType, refAttr, doc)
+                    oleItems[dispItem.clsid] = dispItem
+                dispItem.coclass_clsid = coclass.clsid
+                if flags & pythoncom.IMPLTYPEFLAG_FSOURCE:
+                    dispItem.bIsSink = 1
+                    sources[dispItem.clsid] = (dispItem, flags)
+                else:
+                    interfaces[dispItem.clsid] = (dispItem, flags)
+                # If dual interface, make do that too.
+                if clsid not in vtableItems and refAttr[11] & pythoncom.TYPEFLAG_FDUAL:
+                    refType = refType.GetRefTypeInfo(refType.GetRefTypeOfImplType(-1))
+                    refAttr = refType.GetTypeAttr()
+                    assert (
+                        refAttr.typekind == pythoncom.TKIND_INTERFACE
+                    ), "must be interface bynow!"
+                    vtableItem = VTableItem(refType, refAttr, doc)
+                    vtableItems[clsid] = vtableItem
+        coclass.sources = list(sources.values())
+        coclass.interfaces = list(interfaces.values())
+
+    def _Build_Interface(self, type_info_tuple):
+        info, infotype, doc, attr = type_info_tuple
+        oleItem = vtableItem = None
+        if infotype == pythoncom.TKIND_DISPATCH or (
+            infotype == pythoncom.TKIND_INTERFACE
+            and attr[11] & pythoncom.TYPEFLAG_FDISPATCHABLE
+        ):
+            oleItem = DispatchItem(info, attr, doc)
+            # If this DISPATCH interface dual, then build that too.
+            if attr.wTypeFlags & pythoncom.TYPEFLAG_FDUAL:
+                # Get the vtable interface
+                refhtype = info.GetRefTypeOfImplType(-1)
+                info = info.GetRefTypeInfo(refhtype)
+                attr = info.GetTypeAttr()
+                infotype = pythoncom.TKIND_INTERFACE
+            else:
+                infotype = None
+        assert infotype in [
+            None,
+            pythoncom.TKIND_INTERFACE,
+        ], "Must be a real interface at this point"
+        if infotype == pythoncom.TKIND_INTERFACE:
+            vtableItem = VTableItem(info, attr, doc)
+        return oleItem, vtableItem
+
+    def BuildOleItemsFromType(self):
+        assert (
+            self.bBuildHidden
+        ), "This code doesnt look at the hidden flag - I thought everyone set it true!?!?!"
+        oleItems = {}
+        enumItems = {}
+        recordItems = {}
+        vtableItems = {}
+
+        for type_info_tuple in self.CollectOleItemInfosFromType():
+            info, infotype, doc, attr = type_info_tuple
+            clsid = attr[0]
+            if infotype == pythoncom.TKIND_ENUM or infotype == pythoncom.TKIND_MODULE:
+                newItem = EnumerationItem(info, attr, doc)
+                enumItems[newItem.doc[0]] = newItem
+            # We never hide interfaces (MSAccess, for example, nominates interfaces as
+            # hidden, assuming that you only ever use them via the CoClass)
+            elif infotype in [pythoncom.TKIND_DISPATCH, pythoncom.TKIND_INTERFACE]:
+                if clsid not in oleItems:
+                    oleItem, vtableItem = self._Build_Interface(type_info_tuple)
+                    oleItems[clsid] = oleItem  # Even "None" goes in here.
+                    if vtableItem is not None:
+                        vtableItems[clsid] = vtableItem
+            elif (
+                infotype == pythoncom.TKIND_RECORD or infotype == pythoncom.TKIND_UNION
+            ):
+                newItem = RecordItem(info, attr, doc)
+                recordItems[newItem.clsid] = newItem
+            elif infotype == pythoncom.TKIND_ALIAS:
+                # We dont care about alias' - handled intrinsicly.
+                continue
+            elif infotype == pythoncom.TKIND_COCLASS:
+                newItem, child_infos = self._Build_CoClass(type_info_tuple)
+                self._Build_CoClassChildren(newItem, child_infos, oleItems, vtableItems)
+                oleItems[newItem.clsid] = newItem
+            else:
+                self.progress.LogWarning("Unknown TKIND found: %d" % infotype)
+
+        return oleItems, enumItems, recordItems, vtableItems
+
+    def open_writer(self, filename, encoding="mbcs"):
+        # A place to put code to open a file with the appropriate encoding.
+        # Does *not* set self.file - just opens and returns a file.
+        # Actually returns a handle to a temp file - finish_writer then deletes
+        # the filename asked for and puts everything back in place.  This
+        # is so errors don't leave a 1/2 generated file around causing bizarre
+        # errors later, and so that multiple processes writing the same file
+        # don't step on each others' toes.
+        # Could be a classmethod one day...
+        temp_filename = self.get_temp_filename(filename)
+        return open(temp_filename, "wt", encoding=encoding)
+
+    def finish_writer(self, filename, f, worked):
+        f.close()
+        try:
+            os.unlink(filename)
+        except os.error:
+            pass
+        temp_filename = self.get_temp_filename(filename)
+        if worked:
+            try:
+                os.rename(temp_filename, filename)
+            except os.error:
+                # If we are really unlucky, another process may have written the
+                # file in between our calls to os.unlink and os.rename. So try
+                # again, but only once.
+                # There are still some race conditions, but they seem difficult to
+                # fix, and they probably occur much less frequently:
+                # * The os.rename failure could occur more than once if more than
+                #   two processes are involved.
+                # * In between os.unlink and os.rename, another process could try
+                #   to import the module, having seen that it already exists.
+                # * If another process starts a COM server while we are still
+                #   generating __init__.py, that process sees that the folder
+                #   already exists and assumes that __init__.py is already there
+                #   as well.
+                try:
+                    os.unlink(filename)
+                except os.error:
+                    pass
+                os.rename(temp_filename, filename)
+        else:
+            os.unlink(temp_filename)
+
+    def get_temp_filename(self, filename):
+        return "%s.%d.temp" % (filename, os.getpid())
+
+    def generate(self, file, is_for_demand=0):
+        if is_for_demand:
+            self.generate_type = GEN_DEMAND_BASE
+        else:
+            self.generate_type = GEN_FULL
+        self.file = file
+        self.do_generate()
+        self.file = None
+        self.progress.Finished()
+
+    def do_gen_file_header(self):
+        la = self.typelib.GetLibAttr()
+        moduleDoc = self.typelib.GetDocumentation(-1)
+        docDesc = ""
+        if moduleDoc[1]:
+            docDesc = moduleDoc[1]
+
+        # Reset all the 'per file' state
+        self.bHaveWrittenDispatchBaseClass = 0
+        self.bHaveWrittenCoClassBaseClass = 0
+        self.bHaveWrittenEventBaseClass = 0
+        # You must provide a file correctly configured for writing unicode.
+        # We assert this is it may indicate somewhere in pywin32 that needs
+        # upgrading.
+        assert self.file.encoding, self.file
+        encoding = self.file.encoding  # or "mbcs"
+
+        print("# -*- coding: %s -*-" % (encoding,), file=self.file)
+        print("# Created by makepy.py version %s" % (makepy_version,), file=self.file)
+        print(
+            "# By python version %s" % (sys.version.replace("\n", "-"),), file=self.file
+        )
+        if self.sourceFilename:
+            print(
+                "# From type library '%s'" % (os.path.split(self.sourceFilename)[1],),
+                file=self.file,
+            )
+        print("# On %s" % time.ctime(time.time()), file=self.file)
+
+        print(build._makeDocString(docDesc), file=self.file)
+
+        print("makepy_version =", repr(makepy_version), file=self.file)
+        print("python_version = 0x%x" % (sys.hexversion,), file=self.file)
+        print(file=self.file)
+        print(
+            "import win32com.client.CLSIDToClass, pythoncom, pywintypes", file=self.file
+        )
+        print("import win32com.client.util", file=self.file)
+        print("from pywintypes import IID", file=self.file)
+        print("from win32com.client import Dispatch", file=self.file)
+        print(file=self.file)
+        print(
+            "# The following 3 lines may need tweaking for the particular server",
+            file=self.file,
+        )
+        print(
+            "# Candidates are pythoncom.Missing, .Empty and .ArgNotFound",
+            file=self.file,
+        )
+        print("defaultNamedOptArg=pythoncom.Empty", file=self.file)
+        print("defaultNamedNotOptArg=pythoncom.Empty", file=self.file)
+        print("defaultUnnamedArg=pythoncom.Empty", file=self.file)
+        print(file=self.file)
+        print("CLSID = " + repr(la[0]), file=self.file)
+        print("MajorVersion = " + str(la[3]), file=self.file)
+        print("MinorVersion = " + str(la[4]), file=self.file)
+        print("LibraryFlags = " + str(la[5]), file=self.file)
+        print("LCID = " + hex(la[1]), file=self.file)
+        print(file=self.file)
+
+    def do_generate(self):
+        moduleDoc = self.typelib.GetDocumentation(-1)
+        stream = self.file
+        docDesc = ""
+        if moduleDoc[1]:
+            docDesc = moduleDoc[1]
+        self.progress.Starting(docDesc)
+        self.progress.SetDescription("Building definitions from type library...")
+
+        self.do_gen_file_header()
+
+        oleItems, enumItems, recordItems, vtableItems = self.BuildOleItemsFromType()
+
+        self.progress.SetDescription(
+            "Generating...", len(oleItems) + len(enumItems) + len(vtableItems)
+        )
+
+        # Generate the constants and their support.
+        if enumItems:
+            print("class constants:", file=stream)
+            items = list(enumItems.values())
+            items.sort()
+            num_written = 0
+            for oleitem in items:
+                num_written += oleitem.WriteEnumerationItems(stream)
+                self.progress.Tick()
+            if not num_written:
+                print("\tpass", file=stream)
+            print(file=stream)
+
+        if self.generate_type == GEN_FULL:
+            items = [l for l in oleItems.values() if l is not None]
+            items.sort()
+            for oleitem in items:
+                self.progress.Tick()
+                oleitem.WriteClass(self)
+
+            items = list(vtableItems.values())
+            items.sort()
+            for oleitem in items:
+                self.progress.Tick()
+                oleitem.WriteClass(self)
+        else:
+            self.progress.Tick(len(oleItems) + len(vtableItems))
+
+        print("RecordMap = {", file=stream)
+        for record in recordItems.values():
+            if record.clsid == pythoncom.IID_NULL:
+                print(
+                    "\t###%s: %s, # Record disabled because it doesn't have a non-null GUID"
+                    % (repr(record.doc[0]), repr(str(record.clsid))),
+                    file=stream,
+                )
+            else:
+                print(
+                    "\t%s: %s," % (repr(record.doc[0]), repr(str(record.clsid))),
+                    file=stream,
+                )
+        print("}", file=stream)
+        print(file=stream)
+
+        # Write out _all_ my generated CLSID's in the map
+        if self.generate_type == GEN_FULL:
+            print("CLSIDToClassMap = {", file=stream)
+            for item in oleItems.values():
+                if item is not None and item.bWritten:
+                    print(
+                        "\t'%s' : %s," % (str(item.clsid), item.python_name),
+                        file=stream,
+                    )
+            print("}", file=stream)
+            print("CLSIDToPackageMap = {}", file=stream)
+            print(
+                "win32com.client.CLSIDToClass.RegisterCLSIDsFromDict( CLSIDToClassMap )",
+                file=stream,
+            )
+            print("VTablesToPackageMap = {}", file=stream)
+            print("VTablesToClassMap = {", file=stream)
+            for item in vtableItems.values():
+                print("\t'%s' : '%s'," % (item.clsid, item.python_name), file=stream)
+            print("}", file=stream)
+            print(file=stream)
+
+        else:
+            print("CLSIDToClassMap = {}", file=stream)
+            print("CLSIDToPackageMap = {", file=stream)
+            for item in oleItems.values():
+                if item is not None:
+                    print(
+                        "\t'%s' : %s," % (str(item.clsid), repr(item.python_name)),
+                        file=stream,
+                    )
+            print("}", file=stream)
+            print("VTablesToClassMap = {}", file=stream)
+            print("VTablesToPackageMap = {", file=stream)
+            for item in vtableItems.values():
+                print("\t'%s' : '%s'," % (item.clsid, item.python_name), file=stream)
+            print("}", file=stream)
+            print(file=stream)
+
+        print(file=stream)
+        # Bit of a hack - build a temp map of iteItems + vtableItems - coClasses
+        map = {}
+        for item in oleItems.values():
+            if item is not None and not isinstance(item, CoClassItem):
+                map[item.python_name] = item.clsid
+        for item in vtableItems.values():  # No nones or CoClasses in this map
+            map[item.python_name] = item.clsid
+
+        print("NamesToIIDMap = {", file=stream)
+        for name, iid in map.items():
+            print("\t'%s' : '%s'," % (name, iid), file=stream)
+        print("}", file=stream)
+        print(file=stream)
+
+        if enumItems:
+            print(
+                "win32com.client.constants.__dicts__.append(constants.__dict__)",
+                file=stream,
+            )
+        print(file=stream)
+
+    def generate_child(self, child, dir):
+        "Generate a single child.  May force a few children to be built as we generate deps"
+        self.generate_type = GEN_DEMAND_CHILD
+
+        la = self.typelib.GetLibAttr()
+        lcid = la[1]
+        clsid = la[0]
+        major = la[3]
+        minor = la[4]
+        self.base_mod_name = (
+            "win32com.gen_py." + str(clsid)[1:-1] + "x%sx%sx%s" % (lcid, major, minor)
+        )
+        try:
+            # Process the type library's CoClass objects, looking for the
+            # specified name, or where a child has the specified name.
+            # This ensures that all interesting things (including event interfaces)
+            # are generated correctly.
+            oleItems = {}
+            vtableItems = {}
+            infos = self.CollectOleItemInfosFromType()
+            found = 0
+            for type_info_tuple in infos:
+                info, infotype, doc, attr = type_info_tuple
+                if infotype == pythoncom.TKIND_COCLASS:
+                    coClassItem, child_infos = self._Build_CoClass(type_info_tuple)
+                    found = build.MakePublicAttributeName(doc[0]) == child
+                    if not found:
+                        # OK, check the child interfaces
+                        for (
+                            info,
+                            info_type,
+                            refType,
+                            doc,
+                            refAttr,
+                            flags,
+                        ) in child_infos:
+                            if build.MakePublicAttributeName(doc[0]) == child:
+                                found = 1
+                                break
+                    if found:
+                        oleItems[coClassItem.clsid] = coClassItem
+                        self._Build_CoClassChildren(
+                            coClassItem, child_infos, oleItems, vtableItems
+                        )
+                        break
+            if not found:
+                # Doesn't appear in a class defn - look in the interface objects for it
+                for type_info_tuple in infos:
+                    info, infotype, doc, attr = type_info_tuple
+                    if infotype in [
+                        pythoncom.TKIND_INTERFACE,
+                        pythoncom.TKIND_DISPATCH,
+                    ]:
+                        if build.MakePublicAttributeName(doc[0]) == child:
+                            found = 1
+                            oleItem, vtableItem = self._Build_Interface(type_info_tuple)
+                            oleItems[clsid] = oleItem  # Even "None" goes in here.
+                            if vtableItem is not None:
+                                vtableItems[clsid] = vtableItem
+
+            assert (
+                found
+            ), "Cant find the '%s' interface in the CoClasses, or the interfaces" % (
+                child,
+            )
+            # Make a map of iid: dispitem, vtableitem)
+            items = {}
+            for key, value in oleItems.items():
+                items[key] = (value, None)
+            for key, value in vtableItems.items():
+                existing = items.get(key, None)
+                if existing is not None:
+                    new_val = existing[0], value
+                else:
+                    new_val = None, value
+                items[key] = new_val
+
+            self.progress.SetDescription("Generating...", len(items))
+            for oleitem, vtableitem in items.values():
+                an_item = oleitem or vtableitem
+                assert not self.file, "already have a file?"
+                # like makepy.py, we gen to a .temp file so failure doesn't
+                # leave a 1/2 generated mess.
+                out_name = os.path.join(dir, an_item.python_name) + ".py"
+                worked = False
+                self.file = self.open_writer(out_name)
+                try:
+                    if oleitem is not None:
+                        self.do_gen_child_item(oleitem)
+                    if vtableitem is not None:
+                        self.do_gen_child_item(vtableitem)
+                    self.progress.Tick()
+                    worked = True
+                finally:
+                    self.finish_writer(out_name, self.file, worked)
+                    self.file = None
+        finally:
+            self.progress.Finished()
+
+    def do_gen_child_item(self, oleitem):
+        moduleDoc = self.typelib.GetDocumentation(-1)
+        docDesc = ""
+        if moduleDoc[1]:
+            docDesc = moduleDoc[1]
+        self.progress.Starting(docDesc)
+        self.progress.SetDescription("Building definitions from type library...")
+        self.do_gen_file_header()
+        oleitem.WriteClass(self)
+        if oleitem.bWritten:
+            print(
+                'win32com.client.CLSIDToClass.RegisterCLSID( "%s", %s )'
+                % (oleitem.clsid, oleitem.python_name),
+                file=self.file,
+            )
+
+    def checkWriteDispatchBaseClass(self):
+        if not self.bHaveWrittenDispatchBaseClass:
+            print("from win32com.client import DispatchBaseClass", file=self.file)
+            self.bHaveWrittenDispatchBaseClass = 1
+
+    def checkWriteCoClassBaseClass(self):
+        if not self.bHaveWrittenCoClassBaseClass:
+            print("from win32com.client import CoClassBaseClass", file=self.file)
+            self.bHaveWrittenCoClassBaseClass = 1
+
+    def checkWriteEventBaseClass(self):
+        # Not a base class as such...
+        if not self.bHaveWrittenEventBaseClass:
+            # Nothing to do any more!
+            self.bHaveWrittenEventBaseClass = 1
+
+
+if __name__ == "__main__":
+    print("This is a worker module.  Please use makepy to generate Python files.")
diff --git a/lib/win32com/client/makepy.py b/lib/win32com/client/makepy.py
new file mode 100644
index 00000000..041f18a4
--- /dev/null
+++ b/lib/win32com/client/makepy.py
@@ -0,0 +1,459 @@
+# Originally written by Curt Hagenlocher, and various bits
+# and pieces by Mark Hammond (and now Greg Stein has had
+# a go too :-)
+
+# Note that the main worker code has been moved to genpy.py
+# As this is normally run from the command line, it reparses the code each time.
+# Now this is nothing more than the command line handler and public interface.
+
+# XXX - TO DO
+# XXX - Greg and Mark have some ideas for a revamp - just no
+#       time - if you want to help, contact us for details.
+#       Main idea is to drop the classes exported and move to a more
+#       traditional data driven model.
+
+"""Generate a .py file from an OLE TypeLibrary file.
+
+
+ This module is concerned only with the actual writing of
+ a .py file.  It draws on the @build@ module, which builds
+ the knowledge of a COM interface.
+
+"""
+usageHelp = """ \
+
+Usage:
+
+  makepy.py [-i] [-v|q] [-h] [-u] [-o output_file] [-d] [typelib, ...]
+
+  -i    -- Show information for the specified typelib.
+
+  -v    -- Verbose output.
+
+  -q    -- Quiet output.
+
+  -h    -- Do not generate hidden methods.
+
+  -u    -- Python 1.5 and earlier: Do NOT convert all Unicode objects to
+           strings.
+
+           Python 1.6 and later: Convert all Unicode objects to strings.
+
+  -o    -- Create output in a specified output file.  If the path leading
+           to the file does not exist, any missing directories will be
+           created.
+           NOTE: -o cannot be used with -d.  This will generate an error.
+
+  -d    -- Generate the base code now and the class code on demand.
+           Recommended for large type libraries.
+
+  typelib -- A TLB, DLL, OCX or anything containing COM type information.
+             If a typelib is not specified, a window containing a textbox
+             will open from which you can select a registered type
+             library.
+
+Examples:
+
+  makepy.py -d
+
+    Presents a list of registered type libraries from which you can make
+    a selection.
+
+  makepy.py -d "Microsoft Excel 8.0 Object Library"
+
+    Generate support for the type library with the specified description
+    (in this case, the MS Excel object model).
+
+"""
+
+import importlib
+import os
+import sys
+
+import pythoncom
+from win32com.client import Dispatch, gencache, genpy, selecttlb
+
+bForDemandDefault = 0  # Default value of bForDemand - toggle this to change the world - see also gencache.py
+
+error = "makepy.error"
+
+
+def usage():
+    sys.stderr.write(usageHelp)
+    sys.exit(2)
+
+
+def ShowInfo(spec):
+    if not spec:
+        tlbSpec = selecttlb.SelectTlb(excludeFlags=selecttlb.FLAG_HIDDEN)
+        if tlbSpec is None:
+            return
+        try:
+            tlb = pythoncom.LoadRegTypeLib(
+                tlbSpec.clsid, tlbSpec.major, tlbSpec.minor, tlbSpec.lcid
+            )
+        except pythoncom.com_error:  # May be badly registered.
+            sys.stderr.write(
+                "Warning - could not load registered typelib '%s'\n" % (tlbSpec.clsid)
+            )
+            tlb = None
+
+        infos = [(tlb, tlbSpec)]
+    else:
+        infos = GetTypeLibsForSpec(spec)
+    for tlb, tlbSpec in infos:
+        desc = tlbSpec.desc
+        if desc is None:
+            if tlb is None:
+                desc = "<Could not load typelib %s>" % (tlbSpec.dll)
+            else:
+                desc = tlb.GetDocumentation(-1)[0]
+        print(desc)
+        print(
+            " %s, lcid=%s, major=%s, minor=%s"
+            % (tlbSpec.clsid, tlbSpec.lcid, tlbSpec.major, tlbSpec.minor)
+        )
+        print(" >>> # Use these commands in Python code to auto generate .py support")
+        print(" >>> from win32com.client import gencache")
+        print(
+            " >>> gencache.EnsureModule('%s', %s, %s, %s)"
+            % (tlbSpec.clsid, tlbSpec.lcid, tlbSpec.major, tlbSpec.minor)
+        )
+
+
+class SimpleProgress(genpy.GeneratorProgress):
+    """A simple progress class prints its output to stderr"""
+
+    def __init__(self, verboseLevel):
+        self.verboseLevel = verboseLevel
+
+    def Close(self):
+        pass
+
+    def Finished(self):
+        if self.verboseLevel > 1:
+            sys.stderr.write("Generation complete..\n")
+
+    def SetDescription(self, desc, maxticks=None):
+        if self.verboseLevel:
+            sys.stderr.write(desc + "\n")
+
+    def Tick(self, desc=None):
+        pass
+
+    def VerboseProgress(self, desc, verboseLevel=2):
+        if self.verboseLevel >= verboseLevel:
+            sys.stderr.write(desc + "\n")
+
+    def LogBeginGenerate(self, filename):
+        self.VerboseProgress("Generating to %s" % filename, 1)
+
+    def LogWarning(self, desc):
+        self.VerboseProgress("WARNING: " + desc, 1)
+
+
+class GUIProgress(SimpleProgress):
+    def __init__(self, verboseLevel):
+        # Import some modules we need to we can trap failure now.
+        import pywin  # nopycln: import
+        import win32ui
+
+        SimpleProgress.__init__(self, verboseLevel)
+        self.dialog = None
+
+    def Close(self):
+        if self.dialog is not None:
+            self.dialog.Close()
+            self.dialog = None
+
+    def Starting(self, tlb_desc):
+        SimpleProgress.Starting(self, tlb_desc)
+        if self.dialog is None:
+            from pywin.dialogs import status
+
+            self.dialog = status.ThreadedStatusProgressDialog(tlb_desc)
+        else:
+            self.dialog.SetTitle(tlb_desc)
+
+    def SetDescription(self, desc, maxticks=None):
+        self.dialog.SetText(desc)
+        if maxticks:
+            self.dialog.SetMaxTicks(maxticks)
+
+    def Tick(self, desc=None):
+        self.dialog.Tick()
+        if desc is not None:
+            self.dialog.SetText(desc)
+
+
+def GetTypeLibsForSpec(arg):
+    """Given an argument on the command line (either a file name, library
+    description, or ProgID of an object) return a list of actual typelibs
+    to use."""
+    typelibs = []
+    try:
+        try:
+            tlb = pythoncom.LoadTypeLib(arg)
+            spec = selecttlb.TypelibSpec(None, 0, 0, 0)
+            spec.FromTypelib(tlb, arg)
+            typelibs.append((tlb, spec))
+        except pythoncom.com_error:
+            # See if it is a description
+            tlbs = selecttlb.FindTlbsWithDescription(arg)
+            if len(tlbs) == 0:
+                # Maybe it is the name of a COM object?
+                try:
+                    ob = Dispatch(arg)
+                    # and if so, it must support typelib info
+                    tlb, index = ob._oleobj_.GetTypeInfo().GetContainingTypeLib()
+                    spec = selecttlb.TypelibSpec(None, 0, 0, 0)
+                    spec.FromTypelib(tlb)
+                    tlbs.append(spec)
+                except pythoncom.com_error:
+                    pass
+            if len(tlbs) == 0:
+                print("Could not locate a type library matching '%s'" % (arg))
+            for spec in tlbs:
+                # Version numbers not always reliable if enumerated from registry.
+                # (as some libs use hex, other's dont.  Both examples from MS, of course.)
+                if spec.dll is None:
+                    tlb = pythoncom.LoadRegTypeLib(
+                        spec.clsid, spec.major, spec.minor, spec.lcid
+                    )
+                else:
+                    tlb = pythoncom.LoadTypeLib(spec.dll)
+
+                # We have a typelib, but it may not be exactly what we specified
+                # (due to automatic version matching of COM).  So we query what we really have!
+                attr = tlb.GetLibAttr()
+                spec.major = attr[3]
+                spec.minor = attr[4]
+                spec.lcid = attr[1]
+                typelibs.append((tlb, spec))
+        return typelibs
+    except pythoncom.com_error:
+        t, v, tb = sys.exc_info()
+        sys.stderr.write("Unable to load type library from '%s' - %s\n" % (arg, v))
+        tb = None  # Storing tb in a local is a cycle!
+        sys.exit(1)
+
+
+def GenerateFromTypeLibSpec(
+    typelibInfo,
+    file=None,
+    verboseLevel=None,
+    progressInstance=None,
+    bUnicodeToString=None,
+    bForDemand=bForDemandDefault,
+    bBuildHidden=1,
+):
+    assert bUnicodeToString is None, "this is deprecated and will go away"
+    if verboseLevel is None:
+        verboseLevel = 0  # By default, we use no gui and no verbose level!
+
+    if bForDemand and file is not None:
+        raise RuntimeError(
+            "You can only perform a demand-build when the output goes to the gen_py directory"
+        )
+    if isinstance(typelibInfo, tuple):
+        # Tuple
+        typelibCLSID, lcid, major, minor = typelibInfo
+        tlb = pythoncom.LoadRegTypeLib(typelibCLSID, major, minor, lcid)
+        spec = selecttlb.TypelibSpec(typelibCLSID, lcid, major, minor)
+        spec.FromTypelib(tlb, str(typelibCLSID))
+        typelibs = [(tlb, spec)]
+    elif isinstance(typelibInfo, selecttlb.TypelibSpec):
+        if typelibInfo.dll is None:
+            # Version numbers not always reliable if enumerated from registry.
+            tlb = pythoncom.LoadRegTypeLib(
+                typelibInfo.clsid,
+                typelibInfo.major,
+                typelibInfo.minor,
+                typelibInfo.lcid,
+            )
+        else:
+            tlb = pythoncom.LoadTypeLib(typelibInfo.dll)
+        typelibs = [(tlb, typelibInfo)]
+    elif hasattr(typelibInfo, "GetLibAttr"):
+        # A real typelib object!
+        # Could also use isinstance(typelibInfo, PyITypeLib) instead, but PyITypeLib is not directly exposed by pythoncom.
+        # 	pythoncom.TypeIIDs[pythoncom.IID_ITypeLib] seems to work
+        tla = typelibInfo.GetLibAttr()
+        guid = tla[0]
+        lcid = tla[1]
+        major = tla[3]
+        minor = tla[4]
+        spec = selecttlb.TypelibSpec(guid, lcid, major, minor)
+        typelibs = [(typelibInfo, spec)]
+    else:
+        typelibs = GetTypeLibsForSpec(typelibInfo)
+
+    if progressInstance is None:
+        progressInstance = SimpleProgress(verboseLevel)
+    progress = progressInstance
+
+    bToGenDir = file is None
+
+    for typelib, info in typelibs:
+        gen = genpy.Generator(typelib, info.dll, progress, bBuildHidden=bBuildHidden)
+
+        if file is None:
+            this_name = gencache.GetGeneratedFileName(
+                info.clsid, info.lcid, info.major, info.minor
+            )
+            full_name = os.path.join(gencache.GetGeneratePath(), this_name)
+            if bForDemand:
+                try:
+                    os.unlink(full_name + ".py")
+                except os.error:
+                    pass
+                try:
+                    os.unlink(full_name + ".pyc")
+                except os.error:
+                    pass
+                try:
+                    os.unlink(full_name + ".pyo")
+                except os.error:
+                    pass
+                if not os.path.isdir(full_name):
+                    os.mkdir(full_name)
+                outputName = os.path.join(full_name, "__init__.py")
+            else:
+                outputName = full_name + ".py"
+            fileUse = gen.open_writer(outputName)
+            progress.LogBeginGenerate(outputName)
+        else:
+            fileUse = file
+
+        worked = False
+        try:
+            gen.generate(fileUse, bForDemand)
+            worked = True
+        finally:
+            if file is None:
+                gen.finish_writer(outputName, fileUse, worked)
+        importlib.invalidate_caches()
+        if bToGenDir:
+            progress.SetDescription("Importing module")
+            gencache.AddModuleToCache(info.clsid, info.lcid, info.major, info.minor)
+
+    progress.Close()
+
+
+def GenerateChildFromTypeLibSpec(
+    child, typelibInfo, verboseLevel=None, progressInstance=None, bUnicodeToString=None
+):
+    assert bUnicodeToString is None, "this is deprecated and will go away"
+    if verboseLevel is None:
+        verboseLevel = (
+            0  # By default, we use no gui, and no verbose level for the children.
+        )
+    if type(typelibInfo) == type(()):
+        typelibCLSID, lcid, major, minor = typelibInfo
+        tlb = pythoncom.LoadRegTypeLib(typelibCLSID, major, minor, lcid)
+    else:
+        tlb = typelibInfo
+        tla = typelibInfo.GetLibAttr()
+        typelibCLSID = tla[0]
+        lcid = tla[1]
+        major = tla[3]
+        minor = tla[4]
+    spec = selecttlb.TypelibSpec(typelibCLSID, lcid, major, minor)
+    spec.FromTypelib(tlb, str(typelibCLSID))
+    typelibs = [(tlb, spec)]
+
+    if progressInstance is None:
+        progressInstance = SimpleProgress(verboseLevel)
+    progress = progressInstance
+
+    for typelib, info in typelibs:
+        dir_name = gencache.GetGeneratedFileName(
+            info.clsid, info.lcid, info.major, info.minor
+        )
+        dir_path_name = os.path.join(gencache.GetGeneratePath(), dir_name)
+        progress.LogBeginGenerate(dir_path_name)
+
+        gen = genpy.Generator(typelib, info.dll, progress)
+        gen.generate_child(child, dir_path_name)
+        progress.SetDescription("Importing module")
+        importlib.invalidate_caches()
+        __import__("win32com.gen_py." + dir_name + "." + child)
+    progress.Close()
+
+
+def main():
+    import getopt
+
+    hiddenSpec = 1
+    outputName = None
+    verboseLevel = 1
+    doit = 1
+    bForDemand = bForDemandDefault
+    try:
+        opts, args = getopt.getopt(sys.argv[1:], "vo:huiqd")
+        for o, v in opts:
+            if o == "-h":
+                hiddenSpec = 0
+            elif o == "-o":
+                outputName = v
+            elif o == "-v":
+                verboseLevel = verboseLevel + 1
+            elif o == "-q":
+                verboseLevel = verboseLevel - 1
+            elif o == "-i":
+                if len(args) == 0:
+                    ShowInfo(None)
+                else:
+                    for arg in args:
+                        ShowInfo(arg)
+                doit = 0
+            elif o == "-d":
+                bForDemand = not bForDemand
+
+    except (getopt.error, error) as msg:
+        sys.stderr.write(str(msg) + "\n")
+        usage()
+
+    if bForDemand and outputName is not None:
+        sys.stderr.write("Can not use -d and -o together\n")
+        usage()
+
+    if not doit:
+        return 0
+    if len(args) == 0:
+        rc = selecttlb.SelectTlb()
+        if rc is None:
+            sys.exit(1)
+        args = [rc]
+
+    if outputName is not None:
+        path = os.path.dirname(outputName)
+        if path != "" and not os.path.exists(path):
+            os.makedirs(path)
+        if sys.version_info > (3, 0):
+            f = open(outputName, "wt", encoding="mbcs")
+        else:
+            import codecs  # not available in py3k.
+
+            f = codecs.open(outputName, "w", "mbcs")
+    else:
+        f = None
+
+    for arg in args:
+        GenerateFromTypeLibSpec(
+            arg,
+            f,
+            verboseLevel=verboseLevel,
+            bForDemand=bForDemand,
+            bBuildHidden=hiddenSpec,
+        )
+
+    if f:
+        f.close()
+
+
+if __name__ == "__main__":
+    rc = main()
+    if rc:
+        sys.exit(rc)
+    sys.exit(0)
diff --git a/lib/win32com/client/selecttlb.py b/lib/win32com/client/selecttlb.py
new file mode 100644
index 00000000..bb21a429
--- /dev/null
+++ b/lib/win32com/client/selecttlb.py
@@ -0,0 +1,183 @@
+"""Utilities for selecting and enumerating the Type Libraries installed on the system
+"""
+
+import pythoncom
+import win32api
+import win32con
+
+
+class TypelibSpec:
+    def __init__(self, clsid, lcid, major, minor, flags=0):
+        self.clsid = str(clsid)
+        self.lcid = int(lcid)
+        # We avoid assuming 'major' or 'minor' are integers - when
+        # read from the registry there is some confusion about if
+        # they are base 10 or base 16 (they *should* be base 16, but
+        # how they are written is beyond our control.)
+        self.major = major
+        self.minor = minor
+        self.dll = None
+        self.desc = None
+        self.ver_desc = None
+        self.flags = flags
+
+    # For the SelectList
+    def __getitem__(self, item):
+        if item == 0:
+            return self.ver_desc
+        raise IndexError("Cant index me!")
+
+    def __lt__(self, other):  # rich-cmp/py3k-friendly version
+        me = (
+            (self.ver_desc or "").lower(),
+            (self.desc or "").lower(),
+            self.major,
+            self.minor,
+        )
+        them = (
+            (other.ver_desc or "").lower(),
+            (other.desc or "").lower(),
+            other.major,
+            other.minor,
+        )
+        return me < them
+
+    def __eq__(self, other):  # rich-cmp/py3k-friendly version
+        return (
+            (self.ver_desc or "").lower() == (other.ver_desc or "").lower()
+            and (self.desc or "").lower() == (other.desc or "").lower()
+            and self.major == other.major
+            and self.minor == other.minor
+        )
+
+    def Resolve(self):
+        if self.dll is None:
+            return 0
+        tlb = pythoncom.LoadTypeLib(self.dll)
+        self.FromTypelib(tlb, None)
+        return 1
+
+    def FromTypelib(self, typelib, dllName=None):
+        la = typelib.GetLibAttr()
+        self.clsid = str(la[0])
+        self.lcid = la[1]
+        self.major = la[3]
+        self.minor = la[4]
+        if dllName:
+            self.dll = dllName
+
+
+def EnumKeys(root):
+    index = 0
+    ret = []
+    while 1:
+        try:
+            item = win32api.RegEnumKey(root, index)
+        except win32api.error:
+            break
+        try:
+            # Note this doesn't handle REG_EXPAND_SZ, but the implementation
+            # here doesn't need to - that is handled as the data is read.
+            val = win32api.RegQueryValue(root, item)
+        except win32api.error:
+            val = ""  # code using this assumes a string.
+
+        ret.append((item, val))
+        index = index + 1
+    return ret
+
+
+FLAG_RESTRICTED = 1
+FLAG_CONTROL = 2
+FLAG_HIDDEN = 4
+
+
+def EnumTlbs(excludeFlags=0):
+    """Return a list of TypelibSpec objects, one for each registered library."""
+    key = win32api.RegOpenKey(win32con.HKEY_CLASSES_ROOT, "Typelib")
+    iids = EnumKeys(key)
+    results = []
+    for iid, crap in iids:
+        try:
+            key2 = win32api.RegOpenKey(key, str(iid))
+        except win32api.error:
+            # A few good reasons for this, including "access denied".
+            continue
+        for version, tlbdesc in EnumKeys(key2):
+            major_minor = version.split(".", 1)
+            if len(major_minor) < 2:
+                major_minor.append("0")
+            # For some reason, this code used to assume the values were hex.
+            # This seems to not be true - particularly for CDO 1.21
+            # *sigh* - it appears there are no rules here at all, so when we need
+            # to know the info, we must load the tlb by filename and request it.
+            # The Resolve() method on the TypelibSpec does this.
+            # For this reason, keep the version numbers as strings - that
+            # way we can't be wrong!  Let code that really needs an int to work
+            # out what to do.  FWIW, http://support.microsoft.com/kb/816970 is
+            # pretty clear that they *should* be hex.
+            major = major_minor[0]
+            minor = major_minor[1]
+            key3 = win32api.RegOpenKey(key2, str(version))
+            try:
+                # The "FLAGS" are at this point
+                flags = int(win32api.RegQueryValue(key3, "FLAGS"))
+            except (win32api.error, ValueError):
+                flags = 0
+            if flags & excludeFlags == 0:
+                for lcid, crap in EnumKeys(key3):
+                    try:
+                        lcid = int(lcid)
+                    except ValueError:  # not an LCID entry
+                        continue
+                    # Check for both "{lcid}\win32" and "{lcid}\win64" keys.
+                    try:
+                        key4 = win32api.RegOpenKey(key3, "%s\\win32" % (lcid,))
+                    except win32api.error:
+                        try:
+                            key4 = win32api.RegOpenKey(key3, "%s\\win64" % (lcid,))
+                        except win32api.error:
+                            continue
+                    try:
+                        dll, typ = win32api.RegQueryValueEx(key4, None)
+                        if typ == win32con.REG_EXPAND_SZ:
+                            dll = win32api.ExpandEnvironmentStrings(dll)
+                    except win32api.error:
+                        dll = None
+                    spec = TypelibSpec(iid, lcid, major, minor, flags)
+                    spec.dll = dll
+                    spec.desc = tlbdesc
+                    spec.ver_desc = tlbdesc + " (" + version + ")"
+                    results.append(spec)
+    return results
+
+
+def FindTlbsWithDescription(desc):
+    """Find all installed type libraries with the specified description"""
+    ret = []
+    items = EnumTlbs()
+    for item in items:
+        if item.desc == desc:
+            ret.append(item)
+    return ret
+
+
+def SelectTlb(title="Select Library", excludeFlags=0):
+    """Display a list of all the type libraries, and select one.   Returns None if cancelled"""
+    import pywin.dialogs.list
+
+    items = EnumTlbs(excludeFlags)
+    # fixup versions - we assume hex (see __init__ above)
+    for i in items:
+        i.major = int(i.major, 16)
+        i.minor = int(i.minor, 16)
+    items.sort()
+    rc = pywin.dialogs.list.SelectFromLists(title, items, ["Type Library"])
+    if rc is None:
+        return None
+    return items[rc]
+
+
+# Test code.
+if __name__ == "__main__":
+    print(SelectTlb().__dict__)
diff --git a/lib/win32com/client/tlbrowse.py b/lib/win32com/client/tlbrowse.py
new file mode 100644
index 00000000..acc00281
--- /dev/null
+++ b/lib/win32com/client/tlbrowse.py
@@ -0,0 +1,279 @@
+import commctrl
+import pythoncom
+import win32api
+import win32con
+import win32ui
+from pywin.mfc import dialog
+
+
+class TLBrowserException(Exception):
+    "TypeLib browser internal error"
+
+
+error = TLBrowserException
+
+FRAMEDLG_STD = win32con.WS_CAPTION | win32con.WS_SYSMENU
+SS_STD = win32con.WS_CHILD | win32con.WS_VISIBLE
+BS_STD = SS_STD | win32con.WS_TABSTOP
+ES_STD = BS_STD | win32con.WS_BORDER
+LBS_STD = (
+    ES_STD | win32con.LBS_NOTIFY | win32con.LBS_NOINTEGRALHEIGHT | win32con.WS_VSCROLL
+)
+CBS_STD = ES_STD | win32con.CBS_NOINTEGRALHEIGHT | win32con.WS_VSCROLL
+
+typekindmap = {
+    pythoncom.TKIND_ENUM: "Enumeration",
+    pythoncom.TKIND_RECORD: "Record",
+    pythoncom.TKIND_MODULE: "Module",
+    pythoncom.TKIND_INTERFACE: "Interface",
+    pythoncom.TKIND_DISPATCH: "Dispatch",
+    pythoncom.TKIND_COCLASS: "CoClass",
+    pythoncom.TKIND_ALIAS: "Alias",
+    pythoncom.TKIND_UNION: "Union",
+}
+
+TypeBrowseDialog_Parent = dialog.Dialog
+
+
+class TypeBrowseDialog(TypeBrowseDialog_Parent):
+    "Browse a type library"
+
+    IDC_TYPELIST = 1000
+    IDC_MEMBERLIST = 1001
+    IDC_PARAMLIST = 1002
+    IDC_LISTVIEW = 1003
+
+    def __init__(self, typefile=None):
+        TypeBrowseDialog_Parent.__init__(self, self.GetTemplate())
+        try:
+            if typefile:
+                self.tlb = pythoncom.LoadTypeLib(typefile)
+            else:
+                self.tlb = None
+        except pythoncom.ole_error:
+            self.MessageBox("The file does not contain type information")
+            self.tlb = None
+        self.HookCommand(self.CmdTypeListbox, self.IDC_TYPELIST)
+        self.HookCommand(self.CmdMemberListbox, self.IDC_MEMBERLIST)
+
+    def OnAttachedObjectDeath(self):
+        self.tlb = None
+        self.typeinfo = None
+        self.attr = None
+        return TypeBrowseDialog_Parent.OnAttachedObjectDeath(self)
+
+    def _SetupMenu(self):
+        menu = win32ui.CreateMenu()
+        flags = win32con.MF_STRING | win32con.MF_ENABLED
+        menu.AppendMenu(flags, win32ui.ID_FILE_OPEN, "&Open...")
+        menu.AppendMenu(flags, win32con.IDCANCEL, "&Close")
+        mainMenu = win32ui.CreateMenu()
+        mainMenu.AppendMenu(flags | win32con.MF_POPUP, menu.GetHandle(), "&File")
+        self.SetMenu(mainMenu)
+        self.HookCommand(self.OnFileOpen, win32ui.ID_FILE_OPEN)
+
+    def OnFileOpen(self, id, code):
+        openFlags = win32con.OFN_OVERWRITEPROMPT | win32con.OFN_FILEMUSTEXIST
+        fspec = "Type Libraries (*.tlb, *.olb)|*.tlb;*.olb|OCX Files (*.ocx)|*.ocx|DLL's (*.dll)|*.dll|All Files (*.*)|*.*||"
+        dlg = win32ui.CreateFileDialog(1, None, None, openFlags, fspec)
+        if dlg.DoModal() == win32con.IDOK:
+            try:
+                self.tlb = pythoncom.LoadTypeLib(dlg.GetPathName())
+            except pythoncom.ole_error:
+                self.MessageBox("The file does not contain type information")
+                self.tlb = None
+            self._SetupTLB()
+
+    def OnInitDialog(self):
+        self._SetupMenu()
+        self.typelb = self.GetDlgItem(self.IDC_TYPELIST)
+        self.memberlb = self.GetDlgItem(self.IDC_MEMBERLIST)
+        self.paramlb = self.GetDlgItem(self.IDC_PARAMLIST)
+        self.listview = self.GetDlgItem(self.IDC_LISTVIEW)
+
+        # Setup the listview columns
+        itemDetails = (commctrl.LVCFMT_LEFT, 100, "Item", 0)
+        self.listview.InsertColumn(0, itemDetails)
+        itemDetails = (commctrl.LVCFMT_LEFT, 1024, "Details", 0)
+        self.listview.InsertColumn(1, itemDetails)
+
+        if self.tlb is None:
+            self.OnFileOpen(None, None)
+        else:
+            self._SetupTLB()
+        return TypeBrowseDialog_Parent.OnInitDialog(self)
+
+    def _SetupTLB(self):
+        self.typelb.ResetContent()
+        self.memberlb.ResetContent()
+        self.paramlb.ResetContent()
+        self.typeinfo = None
+        self.attr = None
+        if self.tlb is None:
+            return
+        n = self.tlb.GetTypeInfoCount()
+        for i in range(n):
+            self.typelb.AddString(self.tlb.GetDocumentation(i)[0])
+
+    def _SetListviewTextItems(self, items):
+        self.listview.DeleteAllItems()
+        index = -1
+        for item in items:
+            index = self.listview.InsertItem(index + 1, item[0])
+            data = item[1]
+            if data is None:
+                data = ""
+            self.listview.SetItemText(index, 1, data)
+
+    def SetupAllInfoTypes(self):
+        infos = self._GetMainInfoTypes() + self._GetMethodInfoTypes()
+        self._SetListviewTextItems(infos)
+
+    def _GetMainInfoTypes(self):
+        pos = self.typelb.GetCurSel()
+        if pos < 0:
+            return []
+        docinfo = self.tlb.GetDocumentation(pos)
+        infos = [("GUID", str(self.attr[0]))]
+        infos.append(("Help File", docinfo[3]))
+        infos.append(("Help Context", str(docinfo[2])))
+        try:
+            infos.append(("Type Kind", typekindmap[self.tlb.GetTypeInfoType(pos)]))
+        except:
+            pass
+
+        info = self.tlb.GetTypeInfo(pos)
+        attr = info.GetTypeAttr()
+        infos.append(("Attributes", str(attr)))
+
+        for j in range(attr[8]):
+            flags = info.GetImplTypeFlags(j)
+            refInfo = info.GetRefTypeInfo(info.GetRefTypeOfImplType(j))
+            doc = refInfo.GetDocumentation(-1)
+            attr = refInfo.GetTypeAttr()
+            typeKind = attr[5]
+            typeFlags = attr[11]
+
+            desc = doc[0]
+            desc = desc + ", Flags=0x%x, typeKind=0x%x, typeFlags=0x%x" % (
+                flags,
+                typeKind,
+                typeFlags,
+            )
+            if flags & pythoncom.IMPLTYPEFLAG_FSOURCE:
+                desc = desc + "(Source)"
+            infos.append(("Implements", desc))
+
+        return infos
+
+    def _GetMethodInfoTypes(self):
+        pos = self.memberlb.GetCurSel()
+        if pos < 0:
+            return []
+
+        realPos, isMethod = self._GetRealMemberPos(pos)
+        ret = []
+        if isMethod:
+            funcDesc = self.typeinfo.GetFuncDesc(realPos)
+            id = funcDesc[0]
+            ret.append(("Func Desc", str(funcDesc)))
+        else:
+            id = self.typeinfo.GetVarDesc(realPos)[0]
+
+        docinfo = self.typeinfo.GetDocumentation(id)
+        ret.append(("Help String", docinfo[1]))
+        ret.append(("Help Context", str(docinfo[2])))
+        return ret
+
+    def CmdTypeListbox(self, id, code):
+        if code == win32con.LBN_SELCHANGE:
+            pos = self.typelb.GetCurSel()
+            if pos >= 0:
+                self.memberlb.ResetContent()
+                self.typeinfo = self.tlb.GetTypeInfo(pos)
+                self.attr = self.typeinfo.GetTypeAttr()
+                for i in range(self.attr[7]):
+                    id = self.typeinfo.GetVarDesc(i)[0]
+                    self.memberlb.AddString(self.typeinfo.GetNames(id)[0])
+                for i in range(self.attr[6]):
+                    id = self.typeinfo.GetFuncDesc(i)[0]
+                    self.memberlb.AddString(self.typeinfo.GetNames(id)[0])
+                self.SetupAllInfoTypes()
+            return 1
+
+    def _GetRealMemberPos(self, pos):
+        pos = self.memberlb.GetCurSel()
+        if pos >= self.attr[7]:
+            return pos - self.attr[7], 1
+        elif pos >= 0:
+            return pos, 0
+        else:
+            raise error("The position is not valid")
+
+    def CmdMemberListbox(self, id, code):
+        if code == win32con.LBN_SELCHANGE:
+            self.paramlb.ResetContent()
+            pos = self.memberlb.GetCurSel()
+            realPos, isMethod = self._GetRealMemberPos(pos)
+            if isMethod:
+                id = self.typeinfo.GetFuncDesc(realPos)[0]
+                names = self.typeinfo.GetNames(id)
+                for i in range(len(names)):
+                    if i > 0:
+                        self.paramlb.AddString(names[i])
+            self.SetupAllInfoTypes()
+            return 1
+
+    def GetTemplate(self):
+        "Return the template used to create this dialog"
+
+        w = 272  # Dialog width
+        h = 192  # Dialog height
+        style = (
+            FRAMEDLG_STD
+            | win32con.WS_VISIBLE
+            | win32con.DS_SETFONT
+            | win32con.WS_MINIMIZEBOX
+        )
+        template = [
+            ["Type Library Browser", (0, 0, w, h), style, None, (8, "Helv")],
+        ]
+        template.append([130, "&Type", -1, (10, 10, 62, 9), SS_STD | win32con.SS_LEFT])
+        template.append([131, None, self.IDC_TYPELIST, (10, 20, 80, 80), LBS_STD])
+        template.append(
+            [130, "&Members", -1, (100, 10, 62, 9), SS_STD | win32con.SS_LEFT]
+        )
+        template.append([131, None, self.IDC_MEMBERLIST, (100, 20, 80, 80), LBS_STD])
+        template.append(
+            [130, "&Parameters", -1, (190, 10, 62, 9), SS_STD | win32con.SS_LEFT]
+        )
+        template.append([131, None, self.IDC_PARAMLIST, (190, 20, 75, 80), LBS_STD])
+
+        lvStyle = (
+            SS_STD
+            | commctrl.LVS_REPORT
+            | commctrl.LVS_AUTOARRANGE
+            | commctrl.LVS_ALIGNLEFT
+            | win32con.WS_BORDER
+            | win32con.WS_TABSTOP
+        )
+        template.append(
+            ["SysListView32", "", self.IDC_LISTVIEW, (10, 110, 255, 65), lvStyle]
+        )
+
+        return template
+
+
+if __name__ == "__main__":
+    import sys
+
+    fname = None
+    try:
+        fname = sys.argv[1]
+    except:
+        pass
+    dlg = TypeBrowseDialog(fname)
+    if win32api.GetConsoleTitle():  # empty string w/o console
+        dlg.DoModal()
+    else:
+        dlg.CreateWindow(win32ui.GetMainFrame())
diff --git a/lib/win32com/client/util.py b/lib/win32com/client/util.py
new file mode 100644
index 00000000..c5762951
--- /dev/null
+++ b/lib/win32com/client/util.py
@@ -0,0 +1,102 @@
+"""General client side utilities.
+
+This module contains utility functions, used primarily by advanced COM
+programmers, or other COM modules.
+"""
+import pythoncom
+from win32com.client import Dispatch, _get_good_object_
+
+PyIDispatchType = pythoncom.TypeIIDs[pythoncom.IID_IDispatch]
+
+
+def WrapEnum(ob, resultCLSID=None):
+    """Wrap an object in a VARIANT enumerator.
+
+    All VT_DISPATCHs returned by the enumerator are converted to wrapper objects
+    (which may be either a class instance, or a dynamic.Dispatch type object).
+
+    """
+    if type(ob) != pythoncom.TypeIIDs[pythoncom.IID_IEnumVARIANT]:
+        ob = ob.QueryInterface(pythoncom.IID_IEnumVARIANT)
+    return EnumVARIANT(ob, resultCLSID)
+
+
+class Enumerator:
+    """A class that provides indexed access into an Enumerator
+
+    By wrapping a PyIEnum* object in this class, you can perform
+    natural looping and indexing into the Enumerator.
+
+    Looping is very efficient, but it should be noted that although random
+    access is supported, the underlying object is still an enumerator, so
+    this will force many reset-and-seek operations to find the requested index.
+
+    """
+
+    def __init__(self, enum):
+        self._oleobj_ = enum  # a PyIEnumVARIANT
+        self.index = -1
+
+    def __getitem__(self, index):
+        return self.__GetIndex(index)
+
+    def __call__(self, index):
+        return self.__GetIndex(index)
+
+    def __GetIndex(self, index):
+        if type(index) != type(0):
+            raise TypeError("Only integer indexes are supported for enumerators")
+        # NOTE
+        # In this context, self.index is users purely as a flag to say
+        # "am I still in sequence".  The user may call Next() or Reset() if they
+        # so choose, in which case self.index will not be correct (although we
+        # still want to stay in sequence)
+        if index != self.index + 1:
+            # Index requested out of sequence.
+            self._oleobj_.Reset()
+            if index:
+                self._oleobj_.Skip(
+                    index
+                )  # if asked for item 1, must skip 1, Python always zero based.
+        self.index = index
+        result = self._oleobj_.Next(1)
+        if len(result):
+            return self._make_retval_(result[0])
+        raise IndexError("list index out of range")
+
+    def Next(self, count=1):
+        ret = self._oleobj_.Next(count)
+        realRets = []
+        for r in ret:
+            realRets.append(self._make_retval_(r))
+        return tuple(realRets)  # Convert back to tuple.
+
+    def Reset(self):
+        return self._oleobj_.Reset()
+
+    def Clone(self):
+        return self.__class__(self._oleobj_.Clone(), self.resultCLSID)
+
+    def _make_retval_(self, result):
+        return result
+
+
+class EnumVARIANT(Enumerator):
+    def __init__(self, enum, resultCLSID=None):
+        self.resultCLSID = resultCLSID
+        Enumerator.__init__(self, enum)
+
+    def _make_retval_(self, result):
+        return _get_good_object_(result, resultCLSID=self.resultCLSID)
+
+
+class Iterator:
+    def __init__(self, enum, resultCLSID=None):
+        self.resultCLSID = resultCLSID
+        self._iter_ = iter(enum.QueryInterface(pythoncom.IID_IEnumVARIANT))
+
+    def __iter__(self):
+        return self
+
+    def __next__(self):
+        return _get_good_object_(next(self._iter_), resultCLSID=self.resultCLSID)
diff --git a/lib/win32com/demos/__init__.py b/lib/win32com/demos/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/lib/win32com/demos/connect.py b/lib/win32com/demos/connect.py
new file mode 100644
index 00000000..ed7f51c9
--- /dev/null
+++ b/lib/win32com/demos/connect.py
@@ -0,0 +1,100 @@
+# Implements _both_ a connectable client, and a connectable server.
+#
+# Note that we cheat just a little - the Server in this demo is not created
+# via Normal COM - this means we can avoid registering the server.
+# However, the server _is_ accessed as a COM object - just the creation
+# is cheated on - so this is still working as a fully-fledged server.
+
+import pythoncom
+import win32com.server.connect
+import win32com.server.util
+from pywin32_testutil import str2bytes
+from win32com.server.exception import Exception
+
+# This is the IID of the Events interface both Client and Server support.
+IID_IConnectDemoEvents = pythoncom.MakeIID("{A4988850-49C3-11d0-AE5D-52342E000000}")
+
+# The server which implements
+# Create a connectable class, that has a single public method
+# 'DoIt', which echos to a single sink 'DoneIt'
+
+
+class ConnectableServer(win32com.server.connect.ConnectableServer):
+    _public_methods_ = [
+        "DoIt"
+    ] + win32com.server.connect.ConnectableServer._public_methods_
+    _connect_interfaces_ = [IID_IConnectDemoEvents]
+
+    # The single public method that the client can call on us
+    # (ie, as a normal COM server, this exposes just this single method.
+    def DoIt(self, arg):
+        # Simply broadcast a notification.
+        self._BroadcastNotify(self.NotifyDoneIt, (arg,))
+
+    def NotifyDoneIt(self, interface, arg):
+        interface.Invoke(1000, 0, pythoncom.DISPATCH_METHOD, 1, arg)
+
+
+# Here is the client side of the connection world.
+# Define a COM object which implements the methods defined by the
+# IConnectDemoEvents interface.
+class ConnectableClient:
+    # This is another cheat - I _know_ the server defines the "DoneIt" event
+    # as DISPID==1000 - I also know from the implementation details of COM
+    # that the first method in _public_methods_ gets 1000.
+    # Normally some explicit DISPID->Method mapping is required.
+    _public_methods_ = ["OnDoneIt"]
+
+    def __init__(self):
+        self.last_event_arg = None
+
+    # A client must implement QI, and respond to a query for the Event interface.
+    # In addition, it must provide a COM object (which server.util.wrap) does.
+    def _query_interface_(self, iid):
+        import win32com.server.util
+
+        # Note that this seems like a necessary hack.  I am responding to IID_IConnectDemoEvents
+        # but only creating an IDispatch gateway object.
+        if iid == IID_IConnectDemoEvents:
+            return win32com.server.util.wrap(self)
+
+    # And here is our event method which gets called.
+    def OnDoneIt(self, arg):
+        self.last_event_arg = arg
+
+
+def CheckEvent(server, client, val, verbose):
+    client.last_event_arg = None
+    server.DoIt(val)
+    if client.last_event_arg != val:
+        raise RuntimeError("Sent %r, but got back %r" % (val, client.last_event_arg))
+    if verbose:
+        print("Sent and received %r" % val)
+
+
+# A simple test script for all this.
+# In the real world, it is likely that the code controlling the server
+# will be in the same class as that getting the notifications.
+def test(verbose=0):
+    import win32com.client.connect
+    import win32com.client.dynamic
+    import win32com.server.policy
+
+    server = win32com.client.dynamic.Dispatch(
+        win32com.server.util.wrap(ConnectableServer())
+    )
+    connection = win32com.client.connect.SimpleConnection()
+    client = ConnectableClient()
+    connection.Connect(server, client, IID_IConnectDemoEvents)
+    CheckEvent(server, client, "Hello", verbose)
+    CheckEvent(server, client, str2bytes("Here is a null>\x00<"), verbose)
+    CheckEvent(server, client, "Here is a null>\x00<", verbose)
+    val = "test-\xe0\xf2"  # 2 extended characters.
+    CheckEvent(server, client, val, verbose)
+    if verbose:
+        print("Everything seemed to work!")
+    # Aggressive memory leak checking (ie, do nothing!) :-)  All should cleanup OK???
+
+
+if __name__ == "__main__":
+    test(1)
diff --git a/lib/win32com/demos/dump_clipboard.py b/lib/win32com/demos/dump_clipboard.py
new file mode 100644
index 00000000..534d540a
--- /dev/null
+++ b/lib/win32com/demos/dump_clipboard.py
@@ -0,0 +1,74 @@
+import pythoncom
+import win32con
+
+formats = """CF_TEXT CF_BITMAP CF_METAFILEPICT CF_SYLK CF_DIF CF_TIFF
+            CF_OEMTEXT CF_DIB CF_PALETTE CF_PENDATA CF_RIFF CF_WAVE
+            CF_UNICODETEXT CF_ENHMETAFILE CF_HDROP CF_LOCALE CF_MAX
+            CF_OWNERDISPLAY CF_DSPTEXT CF_DSPBITMAP CF_DSPMETAFILEPICT
+            CF_DSPENHMETAFILE""".split()
+format_name_map = {}
+for f in formats:
+    val = getattr(win32con, f)
+    format_name_map[val] = f
+
+tymeds = [attr for attr in pythoncom.__dict__.keys() if attr.startswith("TYMED_")]
+
+
+def DumpClipboard():
+    do = pythoncom.OleGetClipboard()
+    print("Dumping all clipboard formats...")
+    for fe in do.EnumFormatEtc():
+        fmt, td, aspect, index, tymed = fe
+        tymeds_this = [
+            getattr(pythoncom, t) for t in tymeds if tymed & getattr(pythoncom, t)
+        ]
+        print("Clipboard format", format_name_map.get(fmt, str(fmt)))
+        for t_this in tymeds_this:
+            # As we are enumerating there should be no need to call
+            # QueryGetData, but we do anyway!
+            fetc_query = fmt, td, aspect, index, t_this
+            try:
+                do.QueryGetData(fetc_query)
+            except pythoncom.com_error:
+                print("Eeek - QGD indicated failure for tymed", t_this)
+            # now actually get it.
+            try:
+                medium = do.GetData(fetc_query)
+            except pythoncom.com_error as exc:
+                print("Failed to get the clipboard data:", exc)
+                continue
+            if medium.tymed == pythoncom.TYMED_GDI:
+                data = "GDI handle %d" % medium.data
+            elif medium.tymed == pythoncom.TYMED_MFPICT:
+                data = "METAFILE handle %d" % medium.data
+            elif medium.tymed == pythoncom.TYMED_ENHMF:
+                data = "ENHMETAFILE handle %d" % medium.data
+            elif medium.tymed == pythoncom.TYMED_HGLOBAL:
+                data = "%d bytes via HGLOBAL" % len(medium.data)
+            elif medium.tymed == pythoncom.TYMED_FILE:
+                data = "filename '%s'" % data
+            elif medium.tymed == pythoncom.TYMED_ISTREAM:
+                stream = medium.data
+                stream.Seek(0, 0)
+                bytes = 0
+                while 1:
+                    chunk = stream.Read(4096)
+                    if not chunk:
+                        break
+                    bytes += len(chunk)
+                data = "%d bytes via IStream" % bytes
+            elif medium.tymed == pythoncom.TYMED_ISTORAGE:
+                data = "a IStorage"
+            else:
+                data = "*** unknown tymed!"
+            print(" -> got", data)
+    do = None
+
+
+if __name__ == "__main__":
+    DumpClipboard()
+    if pythoncom._GetInterfaceCount() + pythoncom._GetGatewayCount():
+        print(
+            "XXX - Leaving with %d/%d COM objects alive"
+            % (pythoncom._GetInterfaceCount(), pythoncom._GetGatewayCount())
+        )
diff --git a/lib/win32com/demos/eventsApartmentThreaded.py b/lib/win32com/demos/eventsApartmentThreaded.py
new file mode 100644
index 00000000..ae8e70fa
--- /dev/null
+++ b/lib/win32com/demos/eventsApartmentThreaded.py
@@ -0,0 +1,98 @@
+# A sample originally provided by Richard Bell, and modified by Mark Hammond.
+
+# This sample demonstrates how to use COM events in an aparment-threaded
+# world.  In this world, COM itself ensures that all calls to and events
+# from an object happen on the same thread that created the object, even
+# if they originated from different threads.  For this cross-thread
+# marshalling to work, this main thread *must* run a "message-loop" (ie,
+# a loop fetching and dispatching Windows messages).  Without such message
+# processing, dead-locks can occur.
+
+# See also eventsFreeThreaded.py for how to do this in a free-threaded
+# world where these marshalling considerations do not exist.
+
+# NOTE: This example uses Internet Explorer, but it should not be considerd
+# a "best-practices" for writing against IE events, but for working with
+# events in general. For example:
+# * The first OnDocumentComplete event is not a reliable indicator that the
+#   URL has completed loading
+# * As we are demonstrating the most efficient way of handling events, when
+#   running this sample you will see an IE Windows briefly appear, but
+#   vanish without ever being repainted.
+
+import time
+
+# sys.coinit_flags not set, so pythoncom initializes apartment-threaded.
+import pythoncom
+import win32api
+import win32com.client
+import win32event
+
+
+class ExplorerEvents:
+    def __init__(self):
+        self.event = win32event.CreateEvent(None, 0, 0, None)
+
+    def OnDocumentComplete(self, pDisp=pythoncom.Empty, URL=pythoncom.Empty):
+        thread = win32api.GetCurrentThreadId()
+        print("OnDocumentComplete event processed on thread %d" % thread)
+        # Set the event our main thread is waiting on.
+        win32event.SetEvent(self.event)
+
+    def OnQuit(self):
+        thread = win32api.GetCurrentThreadId()
+        print("OnQuit event processed on thread %d" % thread)
+        win32event.SetEvent(self.event)
+
+
+def WaitWhileProcessingMessages(event, timeout=2):
+    start = time.perf_counter()
+    while True:
+        # Wake 4 times a second - we can't just specify the
+        # full timeout here, as then it would reset for every
+        # message we process.
+        rc = win32event.MsgWaitForMultipleObjects(
+            (event,), 0, 250, win32event.QS_ALLEVENTS
+        )
+        if rc == win32event.WAIT_OBJECT_0:
+            # event signalled - stop now!
+            return True
+        if (time.perf_counter() - start) > timeout:
+            # Timeout expired.
+            return False
+        # must be a message.
+        pythoncom.PumpWaitingMessages()
+
+
+def TestExplorerEvents():
+    iexplore = win32com.client.DispatchWithEvents(
+        "InternetExplorer.Application", ExplorerEvents
+    )
+
+    thread = win32api.GetCurrentThreadId()
+    print("TestExplorerEvents created IE object on thread %d" % thread)
+
+    iexplore.Visible = 1
+    try:
+        iexplore.Navigate(win32api.GetFullPathName("..\\readme.html"))
+    except pythoncom.com_error as details:
+        print("Warning - could not open the test HTML file", details)
+
+    # Wait for the event to be signalled while pumping messages.
+    if not WaitWhileProcessingMessages(iexplore.event):
+        print("Document load event FAILED to fire!!!")
+
+    iexplore.Quit()
+    #
+    # Give IE a chance to shutdown, else it can get upset on fast machines.
+    # Note, Quit generates events.  Although this test does NOT catch them
+    # it is NECESSARY to pump messages here instead of a sleep so that the Quit
+    # happens properly!
+    if not WaitWhileProcessingMessages(iexplore.event):
+        print("OnQuit event FAILED to fire!!!")
+
+    iexplore = None
+
+
+if __name__ == "__main__":
+    TestExplorerEvents()
diff --git a/lib/win32com/demos/eventsFreeThreaded.py b/lib/win32com/demos/eventsFreeThreaded.py
new file mode 100644
index 00000000..2fc04d82
--- /dev/null
+++ b/lib/win32com/demos/eventsFreeThreaded.py
@@ -0,0 +1,92 @@
+# A sample originally provided by Richard Bell, and modified by Mark Hammond.
+
+# This sample demonstrates how to use COM events in a free-threaded world.
+# In this world, there is no need to marshall calls across threads, so
+# no message loops are needed at all.  This means regular cross-thread
+# sychronization can be used.  In this sample we just wait on win32 event
+# objects.
+
+# See also ieEventsApartmentThreaded.py for how to do this in an
+# aparment-threaded world, where thread-marshalling complicates things.
+
+# NOTE: This example uses Internet Explorer, but it should not be considerd
+# a "best-practices" for writing against IE events, but for working with
+# events in general. For example:
+# * The first OnDocumentComplete event is not a reliable indicator that the
+#   URL has completed loading
+# * As we are demonstrating the most efficient way of handling events, when
+#   running this sample you will see an IE Windows briefly appear, but
+#   vanish without ever being repainted.
+
+import sys
+
+sys.coinit_flags = 0  # specify free threading
+
+
+import pythoncom
+import win32api
+import win32com.client
+import win32event
+
+
+# The print statements indicate that COM has actually started another thread
+# and will deliver the events to that thread (ie, the events do not actually
+# fire on our main thread.
+class ExplorerEvents:
+    def __init__(self):
+        # We reuse this event for all events.
+        self.event = win32event.CreateEvent(None, 0, 0, None)
+
+    def OnDocumentComplete(self, pDisp=pythoncom.Empty, URL=pythoncom.Empty):
+        #
+        # Caution:  Since the main thread and events thread(s) are different
+        # it may be necessary to serialize access to shared data.  Because
+        # this is a simple test case, that is not required here.  Your
+        # situation may be different.   Caveat programmer.
+        #
+        thread = win32api.GetCurrentThreadId()
+        print("OnDocumentComplete event processed on thread %d" % thread)
+        # Set the event our main thread is waiting on.
+        win32event.SetEvent(self.event)
+
+    def OnQuit(self):
+        thread = win32api.GetCurrentThreadId()
+        print("OnQuit event processed on thread %d" % thread)
+        win32event.SetEvent(self.event)
+
+
+def TestExplorerEvents():
+    iexplore = win32com.client.DispatchWithEvents(
+        "InternetExplorer.Application", ExplorerEvents
+    )
+
+    thread = win32api.GetCurrentThreadId()
+    print("TestExplorerEvents created IE object on thread %d" % thread)
+
+    iexplore.Visible = 1
+    try:
+        iexplore.Navigate(win32api.GetFullPathName("..\\readme.html"))
+    except pythoncom.com_error as details:
+        print("Warning - could not open the test HTML file", details)
+
+    # In this free-threaded example, we can simply wait until an event has
+    # been set - we will give it 2 seconds before giving up.
+    rc = win32event.WaitForSingleObject(iexplore.event, 2000)
+    if rc != win32event.WAIT_OBJECT_0:
+        print("Document load event FAILED to fire!!!")
+
+    iexplore.Quit()
+    # Now we can do the same thing to wait for exit!
+    # Although Quit generates events, in this free-threaded world we
+    # do *not* need to run any message pumps.
+
+    rc = win32event.WaitForSingleObject(iexplore.event, 2000)
+    if rc != win32event.WAIT_OBJECT_0:
+        print("OnQuit event FAILED to fire!!!")
+
+    iexplore = None
+    print("Finished the IE event sample!")
+
+
+if __name__ == "__main__":
+    TestExplorerEvents()
diff --git a/lib/win32com/demos/excelAddin.py b/lib/win32com/demos/excelAddin.py
new file mode 100644
index 00000000..96f6cff8
--- /dev/null
+++ b/lib/win32com/demos/excelAddin.py
@@ -0,0 +1,170 @@
+# A demo plugin for Microsoft Excel
+#
+# This addin simply adds a new button to the main Excel toolbar,
+# and displays a message box when clicked.  Thus, it demonstrates
+# how to plug in to Excel itself, and hook Excel events.
+#
+#
+# To register the addin, simply execute:
+#   excelAddin.py
+# This will install the COM server, and write the necessary
+# AddIn key to Excel
+#
+# To unregister completely:
+#   excelAddin.py --unregister
+#
+# To debug, execute:
+#   excelAddin.py --debug
+#
+# Then open Pythonwin, and select "Tools->Trace Collector Debugging Tool"
+# Restart excel, and you should see some output generated.
+#
+# NOTE: If the AddIn fails with an error, Excel will re-register
+# the addin to not automatically load next time Excel starts.  To
+# correct this, simply re-register the addin (see above)
+#
+# Author <ekoome@yahoo.com> Eric Koome
+# Copyright (c) 2003 Wavecom Inc.  All rights reserved
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions
+# are met:
+#
+# 1. Redistributions of source code must retain the above copyright
+#    notice, this list of conditions and the following disclaimer.
+#
+# THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
+# WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+# OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+# DISCLAIMED.  IN NO EVENT SHALL ERIC KOOME OR
+# ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+# USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+# ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+# OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+# OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+# SUCH DAMAGE.
+
+import sys
+
+import pythoncom
+from win32com import universal
+from win32com.client import Dispatch, DispatchWithEvents, constants, gencache
+from win32com.server.exception import COMException
+
+# Support for COM objects we use.
+gencache.EnsureModule(
+    "{00020813-0000-0000-C000-000000000046}", 0, 1, 3, bForDemand=True
+)  # Excel 9
+gencache.EnsureModule(
+    "{2DF8D04C-5BFA-101B-BDE5-00AA0044DE52}", 0, 2, 1, bForDemand=True
+)  # Office 9
+
+# The TLB defining the interfaces we implement
+universal.RegisterInterfaces(
+    "{AC0714F2-3D04-11D1-AE7D-00A0C90F26F4}", 0, 1, 0, ["_IDTExtensibility2"]
+)
+
+
+class ButtonEvent:
+    def OnClick(self, button, cancel):
+        import win32con  # Possible, but not necessary, to use a Pythonwin GUI
+        import win32ui
+
+        win32ui.MessageBox("Hello from Python", "Python Test", win32con.MB_OKCANCEL)
+        return cancel
+
+
+class ExcelAddin:
+    _com_interfaces_ = ["_IDTExtensibility2"]
+    _public_methods_ = []
+    _reg_clsctx_ = pythoncom.CLSCTX_INPROC_SERVER
+    _reg_clsid_ = "{C5482ECA-F559-45A0-B078-B2036E6F011A}"
+    _reg_progid_ = "Python.Test.ExcelAddin"
+    _reg_policy_spec_ = "win32com.server.policy.EventHandlerPolicy"
+
+    def __init__(self):
+        self.appHostApp = None
+
+    def OnConnection(self, application, connectMode, addin, custom):
+        print("OnConnection", application, connectMode, addin, custom)
+        try:
+            self.appHostApp = application
+            cbcMyBar = self.appHostApp.CommandBars.Add(
+                Name="PythonBar",
+                Position=constants.msoBarTop,
+                MenuBar=constants.msoBarTypeNormal,
+                Temporary=True,
+            )
+            btnMyButton = cbcMyBar.Controls.Add(
+                Type=constants.msoControlButton, Parameter="Greetings"
+            )
+            btnMyButton = self.toolbarButton = DispatchWithEvents(
+                btnMyButton, ButtonEvent
+            )
+            btnMyButton.Style = constants.msoButtonCaption
+            btnMyButton.BeginGroup = True
+            btnMyButton.Caption = "&Python"
+            btnMyButton.TooltipText = "Python rules the World"
+            btnMyButton.Width = "34"
+            cbcMyBar.Visible = True
+        except pythoncom.com_error as xxx_todo_changeme:
+            (hr, msg, exc, arg) = xxx_todo_changeme.args
+            print("The Excel call failed with code %d: %s" % (hr, msg))
+            if exc is None:
+                print("There is no extended error information")
+            else:
+                wcode, source, text, helpFile, helpId, scode = exc
+                print("The source of the error is", source)
+                print("The error message is", text)
+                print("More info can be found in %s (id=%d)" % (helpFile, helpId))
+
+    def OnDisconnection(self, mode, custom):
+        print("OnDisconnection")
+        self.appHostApp.CommandBars("PythonBar").Delete
+        self.appHostApp = None
+
+    def OnAddInsUpdate(self, custom):
+        print("OnAddInsUpdate", custom)
+
+    def OnStartupComplete(self, custom):
+        print("OnStartupComplete", custom)
+
+    def OnBeginShutdown(self, custom):
+        print("OnBeginShutdown", custom)
+
+
+def RegisterAddin(klass):
+    import winreg
+
+    key = winreg.CreateKey(
+        winreg.HKEY_CURRENT_USER, "Software\\Microsoft\\Office\\Excel\\Addins"
+    )
+    subkey = winreg.CreateKey(key, klass._reg_progid_)
+    winreg.SetValueEx(subkey, "CommandLineSafe", 0, winreg.REG_DWORD, 0)
+    winreg.SetValueEx(subkey, "LoadBehavior", 0, winreg.REG_DWORD, 3)
+    winreg.SetValueEx(subkey, "Description", 0, winreg.REG_SZ, "Excel Addin")
+    winreg.SetValueEx(subkey, "FriendlyName", 0, winreg.REG_SZ, "A Simple Excel Addin")
+
+
+def UnregisterAddin(klass):
+    import winreg
+
+    try:
+        winreg.DeleteKey(
+            winreg.HKEY_CURRENT_USER,
+            "Software\\Microsoft\\Office\\Excel\\Addins\\" + klass._reg_progid_,
+        )
+    except WindowsError:
+        pass
+
+
+if __name__ == "__main__":
+    import win32com.server.register
+
+    win32com.server.register.UseCommandLine(ExcelAddin)
+    if "--unregister" in sys.argv:
+        UnregisterAddin(ExcelAddin)
+    else:
+        RegisterAddin(ExcelAddin)
diff --git a/lib/win32com/demos/excelRTDServer.py b/lib/win32com/demos/excelRTDServer.py
new file mode 100644
index 00000000..c50e1ac7
--- /dev/null
+++ b/lib/win32com/demos/excelRTDServer.py
@@ -0,0 +1,434 @@
+"""Excel IRTDServer implementation.
+
+This module is a functional example of how to implement the IRTDServer interface
+in python, using the pywin32 extensions. Further details, about this interface
+and it can be found at:
+     http://msdn.microsoft.com/library/default.asp?url=/library/en-us/dnexcl2k2/html/odc_xlrtdfaq.asp
+"""
+
+# Copyright (c) 2003-2004 by Chris Nilsson <chris@slort.org>
+#
+# By obtaining, using, and/or copying this software and/or its
+# associated documentation, you agree that you have read, understood,
+# and will comply with the following terms and conditions:
+#
+# Permission to use, copy, modify, and distribute this software and
+# its associated documentation for any purpose and without fee is
+# hereby granted, provided that the above copyright notice appears in
+# all copies, and that both that copyright notice and this permission
+# notice appear in supporting documentation, and that the name of
+# Christopher Nilsson (the author) not be used in advertising or publicity
+# pertaining to distribution of the software without specific, written
+# prior permission.
+#
+# THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD
+# TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANT-
+# ABILITY AND FITNESS.  IN NO EVENT SHALL THE AUTHOR
+# BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY
+# DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
+# WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS
+# ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
+# OF THIS SOFTWARE.
+
+import datetime  # For the example classes...
+import threading
+
+import pythoncom
+import win32com.client
+from win32com import universal
+from win32com.client import gencache
+from win32com.server.exception import COMException
+
+# Typelib info for version 10 - aka Excel XP.
+# This is the minimum version of excel that we can work with as this is when
+# Microsoft introduced these interfaces.
+EXCEL_TLB_GUID = "{00020813-0000-0000-C000-000000000046}"
+EXCEL_TLB_LCID = 0
+EXCEL_TLB_MAJOR = 1
+EXCEL_TLB_MINOR = 4
+
+# Import the excel typelib to make sure we've got early-binding going on.
+# The "ByRef" parameters we use later won't work without this.
+gencache.EnsureModule(EXCEL_TLB_GUID, EXCEL_TLB_LCID, EXCEL_TLB_MAJOR, EXCEL_TLB_MINOR)
+
+# Tell pywin to import these extra interfaces.
+# --
+# QUESTION: Why? The interfaces seem to descend from IDispatch, so
+# I'd have thought, for example, calling callback.UpdateNotify() (on the
+# IRTDUpdateEvent callback excel gives us) would work without molestation.
+# But the callback needs to be cast to a "real" IRTDUpdateEvent type. Hmm...
+# This is where my small knowledge of the pywin framework / COM gets hazy.
+# --
+# Again, we feed in the Excel typelib as the source of these interfaces.
+universal.RegisterInterfaces(
+    EXCEL_TLB_GUID,
+    EXCEL_TLB_LCID,
+    EXCEL_TLB_MAJOR,
+    EXCEL_TLB_MINOR,
+    ["IRtdServer", "IRTDUpdateEvent"],
+)
+
+
+class ExcelRTDServer(object):
+    """Base RTDServer class.
+
+    Provides most of the features needed to implement the IRtdServer interface.
+    Manages topic adding, removal, and packing up the values for excel.
+
+    Shouldn't be instanciated directly.
+
+    Instead, descendant classes should override the CreateTopic() method.
+    Topic objects only need to provide a GetValue() function to play nice here.
+    The values given need to be atomic (eg. string, int, float... etc).
+
+    Also note: nothing has been done within this class to ensure that we get
+    time to check our topics for updates. I've left that up to the subclass
+    since the ways, and needs, of refreshing your topics will vary greatly. For
+    example, the sample implementation uses a timer thread to wake itself up.
+    Whichever way you choose to do it, your class needs to be able to wake up
+    occaisionally, since excel will never call your class without being asked to
+    first.
+
+    Excel will communicate with our object in this order:
+      1. Excel instanciates our object and calls ServerStart, providing us with
+         an IRTDUpdateEvent callback object.
+      2. Excel calls ConnectData when it wants to subscribe to a new "topic".
+      3. When we have new data to provide, we call the UpdateNotify method of the
+         callback object we were given.
+      4. Excel calls our RefreshData method, and receives a 2d SafeArray (row-major)
+         containing the Topic ids in the 1st dim, and the topic values in the
+         2nd dim.
+      5. When not needed anymore, Excel will call our DisconnectData to
+         unsubscribe from a topic.
+      6. When there are no more topics left, Excel will call our ServerTerminate
+         method to kill us.
+
+    Throughout, at undetermined periods, Excel will call our Heartbeat
+    method to see if we're still alive. It must return a non-zero value, or
+    we'll be killed.
+
+    NOTE: By default, excel will at most call RefreshData once every 2 seconds.
+          This is a setting that needs to be changed excel-side. To change this,
+          you can set the throttle interval like this in the excel VBA object model:
+            Application.RTD.ThrottleInterval = 1000 ' milliseconds
+    """
+
+    _com_interfaces_ = ["IRtdServer"]
+    _public_methods_ = [
+        "ConnectData",
+        "DisconnectData",
+        "Heartbeat",
+        "RefreshData",
+        "ServerStart",
+        "ServerTerminate",
+    ]
+    _reg_clsctx_ = pythoncom.CLSCTX_INPROC_SERVER
+    # _reg_clsid_ = "# subclass must provide this class attribute"
+    # _reg_desc_ = "# subclass should provide this description"
+    # _reg_progid_ = "# subclass must provide this class attribute"
+
+    ALIVE = 1
+    NOT_ALIVE = 0
+
+    def __init__(self):
+        """Constructor"""
+        super(ExcelRTDServer, self).__init__()
+        self.IsAlive = self.ALIVE
+        self.__callback = None
+        self.topics = {}
+
+    def SignalExcel(self):
+        """Use the callback we were given to tell excel new data is available."""
+        if self.__callback is None:
+            raise COMException(desc="Callback excel provided is Null")
+        self.__callback.UpdateNotify()
+
+    def ConnectData(self, TopicID, Strings, GetNewValues):
+        """Creates a new topic out of the Strings excel gives us."""
+        try:
+            self.topics[TopicID] = self.CreateTopic(Strings)
+        except Exception as why:
+            raise COMException(desc=str(why))
+        GetNewValues = True
+        result = self.topics[TopicID]
+        if result is None:
+            result = "# %s: Waiting for update" % self.__class__.__name__
+        else:
+            result = result.GetValue()
+
+        # fire out internal event...
+        self.OnConnectData(TopicID)
+
+        # GetNewValues as per interface is ByRef, so we need to pass it back too.
+        return result, GetNewValues
+
+    def DisconnectData(self, TopicID):
+        """Deletes the given topic."""
+        self.OnDisconnectData(TopicID)
+
+        if TopicID in self.topics:
+            self.topics[TopicID] = None
+            del self.topics[TopicID]
+
+    def Heartbeat(self):
+        """Called by excel to see if we're still here."""
+        return self.IsAlive
+
+    def RefreshData(self, TopicCount):
+        """Packs up the topic values. Called by excel when it's ready for an update.
+
+        Needs to:
+          * Return the current number of topics, via the "ByRef" TopicCount
+          * Return a 2d SafeArray of the topic data.
+            - 1st dim: topic numbers
+            - 2nd dim: topic values
+
+        We could do some caching, instead of repacking everytime...
+        But this works for demonstration purposes."""
+        TopicCount = len(self.topics)
+        self.OnRefreshData()
+
+        # Grow the lists, so we don't need a heap of calls to append()
+        results = [[None] * TopicCount, [None] * TopicCount]
+
+        # Excel expects a 2-dimensional array. The first dim contains the
+        # topic numbers, and the second contains the values for the topics.
+        # In true VBA style (yuck), we need to pack the array in row-major format,
+        # which looks like:
+        #   ( (topic_num1, topic_num2, ..., topic_numN), \
+        #     (topic_val1, topic_val2, ..., topic_valN) )
+        for idx, topicdata in enumerate(self.topics.items()):
+            topicNum, topic = topicdata
+            results[0][idx] = topicNum
+            results[1][idx] = topic.GetValue()
+
+        # TopicCount is meant to be passed to us ByRef, so return it as well, as per
+        # the way pywin32 handles ByRef arguments.
+        return tuple(results), TopicCount
+
+    def ServerStart(self, CallbackObject):
+        """Excel has just created us... We take its callback for later, and set up shop."""
+        self.IsAlive = self.ALIVE
+
+        if CallbackObject is None:
+            raise COMException(desc="Excel did not provide a callback")
+
+        # Need to "cast" the raw PyIDispatch object to the IRTDUpdateEvent interface
+        IRTDUpdateEventKlass = win32com.client.CLSIDToClass.GetClass(
+            "{A43788C1-D91B-11D3-8F39-00C04F3651B8}"
+        )
+        self.__callback = IRTDUpdateEventKlass(CallbackObject)
+
+        self.OnServerStart()
+
+        return self.IsAlive
+
+    def ServerTerminate(self):
+        """Called when excel no longer wants us."""
+        self.IsAlive = self.NOT_ALIVE  # On next heartbeat, excel will free us
+        self.OnServerTerminate()
+
+    def CreateTopic(self, TopicStrings=None):
+        """Topic factory method. Subclass must override.
+
+        Topic objects need to provide:
+          * GetValue() method which returns an atomic value.
+
+        Will raise NotImplemented if not overridden.
+        """
+        raise NotImplemented("Subclass must implement")
+
+    # Overridable class events...
+    def OnConnectData(self, TopicID):
+        """Called when a new topic has been created, at excel's request."""
+        pass
+
+    def OnDisconnectData(self, TopicID):
+        """Called when a topic is about to be deleted, at excel's request."""
+        pass
+
+    def OnRefreshData(self):
+        """Called when excel has requested all current topic data."""
+        pass
+
+    def OnServerStart(self):
+        """Called when excel has instanciated us."""
+        pass
+
+    def OnServerTerminate(self):
+        """Called when excel is about to destroy us."""
+        pass
+
+
+class RTDTopic(object):
+    """Base RTD Topic.
+    Only method required by our RTDServer implementation is GetValue().
+    The others are more for convenience."""
+
+    def __init__(self, TopicStrings):
+        super(RTDTopic, self).__init__()
+        self.TopicStrings = TopicStrings
+        self.__currentValue = None
+        self.__dirty = False
+
+    def Update(self, sender):
+        """Called by the RTD Server.
+        Gives us a chance to check if our topic data needs to be
+        changed (eg. check a file, quiz a database, etc)."""
+        raise NotImplemented("subclass must implement")
+
+    def Reset(self):
+        """Call when this topic isn't considered "dirty" anymore."""
+        self.__dirty = False
+
+    def GetValue(self):
+        return self.__currentValue
+
+    def SetValue(self, value):
+        self.__dirty = True
+        self.__currentValue = value
+
+    def HasChanged(self):
+        return self.__dirty
+
+
+# -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
+
+######################################
+# Example classes
+######################################
+
+
+class TimeServer(ExcelRTDServer):
+    """Example Time RTD server.
+
+    Sends time updates back to excel.
+
+    example of use, in an excel sheet:
+      =RTD("Python.RTD.TimeServer","","seconds","5")
+
+    This will cause a timestamp string to fill the cell, and update its value
+    every 5 seconds (or as close as possible depending on how busy excel is).
+
+    The empty string parameter denotes the com server is running on the local
+    machine. Otherwise, put in the hostname to look on. For more info
+    on this, lookup the Excel help for its "RTD" worksheet function.
+
+    Obviously, you'd want to wrap this kind of thing in a friendlier VBA
+    function.
+
+    Also, remember that the RTD function accepts a maximum of 28 arguments!
+    If you want to pass more, you may need to concatenate arguments into one
+    string, and have your topic parse them appropriately.
+    """
+
+    # win32com.server setup attributes...
+    # Never copy the _reg_clsid_ value in your own classes!
+    _reg_clsid_ = "{EA7F2CF1-11A2-45E4-B2D5-68E240DB8CB1}"
+    _reg_progid_ = "Python.RTD.TimeServer"
+    _reg_desc_ = "Python class implementing Excel IRTDServer -- feeds time"
+
+    # other class attributes...
+    INTERVAL = 0.5  # secs. Threaded timer will wake us up at this interval.
+
+    def __init__(self):
+        super(TimeServer, self).__init__()
+
+        # Simply timer thread to ensure we get to update our topics, and
+        # tell excel about any changes. This is a pretty basic and dirty way to
+        # do this. Ideally, there should be some sort of waitable (eg. either win32
+        # event, socket data event...) and be kicked off by that event triggering.
+        # As soon as we set up shop here, we _must_ return control back to excel.
+        # (ie. we can't block and do our own thing...)
+        self.ticker = threading.Timer(self.INTERVAL, self.Update)
+
+    def OnServerStart(self):
+        self.ticker.start()
+
+    def OnServerTerminate(self):
+        if not self.ticker.finished.isSet():
+            self.ticker.cancel()  # Cancel our wake-up thread. Excel has killed us.
+
+    def Update(self):
+        # Get our wake-up thread ready...
+        self.ticker = threading.Timer(self.INTERVAL, self.Update)
+        try:
+            # Check if any of our topics have new info to pass on
+            if len(self.topics):
+                refresh = False
+                for topic in self.topics.values():
+                    topic.Update(self)
+                    if topic.HasChanged():
+                        refresh = True
+                    topic.Reset()
+
+                if refresh:
+                    self.SignalExcel()
+        finally:
+            self.ticker.start()  # Make sure we get to run again
+
+    def CreateTopic(self, TopicStrings=None):
+        """Topic factory. Builds a TimeTopic object out of the given TopicStrings."""
+        return TimeTopic(TopicStrings)
+
+
+class TimeTopic(RTDTopic):
+    """Example topic for example RTD server.
+
+    Will accept some simple commands to alter how long to delay value updates.
+
+    Commands:
+      * seconds, delay_in_seconds
+      * minutes, delay_in_minutes
+      * hours, delay_in_hours
+    """
+
+    def __init__(self, TopicStrings):
+        super(TimeTopic, self).__init__(TopicStrings)
+        try:
+            self.cmd, self.delay = self.TopicStrings
+        except Exception as E:
+            # We could simply return a "# ERROR" type string as the
+            # topic value, but explosions like this should be able to get handled by
+            # the VBA-side "On Error" stuff.
+            raise ValueError("Invalid topic strings: %s" % str(TopicStrings))
+
+        # self.cmd = str(self.cmd)
+        self.delay = float(self.delay)
+
+        # setup our initial value
+        self.checkpoint = self.timestamp()
+        self.SetValue(str(self.checkpoint))
+
+    def timestamp(self):
+        return datetime.datetime.now()
+
+    def Update(self, sender):
+        now = self.timestamp()
+        delta = now - self.checkpoint
+        refresh = False
+        if self.cmd == "seconds":
+            if delta.seconds >= self.delay:
+                refresh = True
+        elif self.cmd == "minutes":
+            if delta.minutes >= self.delay:
+                refresh = True
+        elif self.cmd == "hours":
+            if delta.hours >= self.delay:
+                refresh = True
+        else:
+            self.SetValue("#Unknown command: " + self.cmd)
+
+        if refresh:
+            self.SetValue(str(now))
+            self.checkpoint = now
+
+
+if __name__ == "__main__":
+    import win32com.server.register
+
+    # Register/Unregister TimeServer example
+    # eg. at the command line: excelrtd.py --register
+    # Then type in an excel cell something like:
+    # =RTD("Python.RTD.TimeServer","","seconds","5")
+    win32com.server.register.UseCommandLine(TimeServer)
diff --git a/lib/win32com/demos/iebutton.py b/lib/win32com/demos/iebutton.py
new file mode 100644
index 00000000..bc3ce99b
--- /dev/null
+++ b/lib/win32com/demos/iebutton.py
@@ -0,0 +1,217 @@
+# -*- coding: latin-1 -*-
+
+# PyWin32 Internet Explorer Button
+#
+# written by Leonard Ritter (paniq@gmx.net)
+# and Robert F�rtsch (info@robert-foertsch.com)
+
+
+"""
+This sample implements a simple IE Button COM server
+with access to the IWebBrowser2 interface.
+
+To demonstrate:
+* Execute this script to register the server.
+* Open Pythonwin's Tools -> Trace Collector Debugging Tool, so you can
+  see the output of 'print' statements in this demo.
+* Open a new IE instance.  The toolbar should have a new "scissors" icon,
+  with tooltip text "IE Button" - this is our new button - click it.
+* Switch back to the Pythonwin window - you should see:
+   IOleCommandTarget::Exec called.
+  This is the button being clicked.  Extending this to do something more
+  useful is left as an exercise.
+
+Contribtions to this sample to make it a little "friendlier" welcome!
+"""
+
+# imports section
+
+import pythoncom
+import win32api
+import win32com
+import win32com.server.register
+from win32com import universal
+from win32com.client import Dispatch, DispatchWithEvents, constants, gencache, getevents
+
+# This demo uses 'print' - use win32traceutil to see it if we have no
+# console.
+try:
+    win32api.GetConsoleTitle()
+except win32api.error:
+    import win32traceutil
+
+import array
+
+from win32com.axcontrol import axcontrol
+
+# ensure we know the ms internet controls typelib so we have access to IWebBrowser2 later on
+win32com.client.gencache.EnsureModule("{EAB22AC0-30C1-11CF-A7EB-0000C05BAE0B}", 0, 1, 1)
+
+
+#
+IObjectWithSite_methods = ["SetSite", "GetSite"]
+IOleCommandTarget_methods = ["Exec", "QueryStatus"]
+
+_iebutton_methods_ = IOleCommandTarget_methods + IObjectWithSite_methods
+_iebutton_com_interfaces_ = [
+    axcontrol.IID_IOleCommandTarget,
+    axcontrol.IID_IObjectWithSite,  # IObjectWithSite
+]
+
+
+class Stub:
+    """
+    this class serves as a method stub,
+    outputting debug info whenever the object
+    is being called.
+    """
+
+    def __init__(self, name):
+        self.name = name
+
+    def __call__(self, *args):
+        print("STUB: ", self.name, args)
+
+
+class IEButton:
+    """
+    The actual COM server class
+    """
+
+    _com_interfaces_ = _iebutton_com_interfaces_
+    _public_methods_ = _iebutton_methods_
+    _reg_clsctx_ = pythoncom.CLSCTX_INPROC_SERVER
+    _button_text_ = "IE Button"
+    _tool_tip_ = "An example implementation for an IE Button."
+    _icon_ = ""
+    _hot_icon_ = ""
+
+    def __init__(self):
+        # put stubs for non-implemented methods
+        for method in self._public_methods_:
+            if not hasattr(self, method):
+                print("providing default stub for %s" % method)
+                setattr(self, method, Stub(method))
+
+    def QueryStatus(self, pguidCmdGroup, prgCmds, cmdtextf):
+        # 'cmdtextf' is the 'cmdtextf' element from the OLECMDTEXT structure,
+        # or None if a NULL pointer was passed.
+        result = []
+        for id, flags in prgCmds:
+            flags |= axcontrol.OLECMDF_SUPPORTED | axcontrol.OLECMDF_ENABLED
+            result.append((id, flags))
+        if cmdtextf is None:
+            cmdtext = None  # must return None if nothing requested.
+        # IE never seems to want any text - this code is here for
+        # demo purposes only
+        elif cmdtextf == axcontrol.OLECMDTEXTF_NAME:
+            cmdtext = "IEButton Name"
+        else:
+            cmdtext = "IEButton State"
+        return result, cmdtext
+
+    def Exec(self, pguidCmdGroup, nCmdID, nCmdExecOpt, pvaIn):
+        print(pguidCmdGroup, nCmdID, nCmdExecOpt, pvaIn)
+        print("IOleCommandTarget::Exec called.")
+        # self.webbrowser.ShowBrowserBar(GUID_IETOOLBAR, not is_ietoolbar_visible())
+
+    def SetSite(self, unknown):
+        if unknown:
+            # first get a command target
+            cmdtarget = unknown.QueryInterface(axcontrol.IID_IOleCommandTarget)
+            # then travel over to a service provider
+            serviceprovider = cmdtarget.QueryInterface(pythoncom.IID_IServiceProvider)
+            # finally ask for the internet explorer application, returned as a dispatch object
+            self.webbrowser = win32com.client.Dispatch(
+                serviceprovider.QueryService(
+                    "{0002DF05-0000-0000-C000-000000000046}", pythoncom.IID_IDispatch
+                )
+            )
+        else:
+            # lose all references
+            self.webbrowser = None
+
+    def GetClassID(self):
+        return self._reg_clsid_
+
+
+def register(classobj):
+    import winreg
+
+    subKeyCLSID = (
+        "SOFTWARE\\Microsoft\\Internet Explorer\\Extensions\\%38s"
+        % classobj._reg_clsid_
+    )
+    try:
+        hKey = winreg.CreateKey(winreg.HKEY_LOCAL_MACHINE, subKeyCLSID)
+        subKey = winreg.SetValueEx(
+            hKey, "ButtonText", 0, winreg.REG_SZ, classobj._button_text_
+        )
+        winreg.SetValueEx(
+            hKey, "ClsidExtension", 0, winreg.REG_SZ, classobj._reg_clsid_
+        )  # reg value for calling COM object
+        winreg.SetValueEx(
+            hKey, "CLSID", 0, winreg.REG_SZ, "{1FBA04EE-3024-11D2-8F1F-0000F87ABD16}"
+        )  # CLSID for button that sends command to COM object
+        winreg.SetValueEx(hKey, "Default Visible", 0, winreg.REG_SZ, "Yes")
+        winreg.SetValueEx(hKey, "ToolTip", 0, winreg.REG_SZ, classobj._tool_tip_)
+        winreg.SetValueEx(hKey, "Icon", 0, winreg.REG_SZ, classobj._icon_)
+        winreg.SetValueEx(hKey, "HotIcon", 0, winreg.REG_SZ, classobj._hot_icon_)
+    except WindowsError:
+        print("Couldn't set standard toolbar reg keys.")
+    else:
+        print("Set standard toolbar reg keys.")
+
+
+def unregister(classobj):
+    import winreg
+
+    subKeyCLSID = (
+        "SOFTWARE\\Microsoft\\Internet Explorer\\Extensions\\%38s"
+        % classobj._reg_clsid_
+    )
+    try:
+        hKey = winreg.CreateKey(winreg.HKEY_LOCAL_MACHINE, subKeyCLSID)
+        subKey = winreg.DeleteValue(hKey, "ButtonText")
+        winreg.DeleteValue(hKey, "ClsidExtension")  # for calling COM object
+        winreg.DeleteValue(hKey, "CLSID")
+        winreg.DeleteValue(hKey, "Default Visible")
+        winreg.DeleteValue(hKey, "ToolTip")
+        winreg.DeleteValue(hKey, "Icon")
+        winreg.DeleteValue(hKey, "HotIcon")
+        winreg.DeleteKey(winreg.HKEY_LOCAL_MACHINE, subKeyCLSID)
+    except WindowsError:
+        print("Couldn't delete Standard toolbar regkey.")
+    else:
+        print("Deleted Standard toolbar regkey.")
+
+
+#
+# test implementation
+#
+
+
+class PyWin32InternetExplorerButton(IEButton):
+    _reg_clsid_ = "{104B66A9-9E68-49D1-A3F5-94754BE9E0E6}"
+    _reg_progid_ = "PyWin32.IEButton"
+    _reg_desc_ = "Test Button"
+    _button_text_ = "IE Button"
+    _tool_tip_ = "An example implementation for an IE Button."
+    _icon_ = ""
+    _hot_icon_ = _icon_
+
+
+def DllRegisterServer():
+    register(PyWin32InternetExplorerButton)
+
+
+def DllUnregisterServer():
+    unregister(PyWin32InternetExplorerButton)
+
+
+if __name__ == "__main__":
+    win32com.server.register.UseCommandLine(
+        PyWin32InternetExplorerButton,
+        finalize_register=DllRegisterServer,
+        finalize_unregister=DllUnregisterServer,
+    )
diff --git a/lib/win32com/demos/ietoolbar.py b/lib/win32com/demos/ietoolbar.py
new file mode 100644
index 00000000..084db3c1
--- /dev/null
+++ b/lib/win32com/demos/ietoolbar.py
@@ -0,0 +1,376 @@
+# -*- coding: latin-1 -*-
+
+# PyWin32 Internet Explorer Toolbar
+#
+# written by Leonard Ritter (paniq@gmx.net)
+# and Robert F�rtsch (info@robert-foertsch.com)
+
+
+"""
+This sample implements a simple IE Toolbar COM server
+supporting Windows XP styles and access to
+the IWebBrowser2 interface.
+
+It also demonstrates how to hijack the parent window
+to catch WM_COMMAND messages.
+"""
+
+# imports section
+import sys
+import winreg
+
+import pythoncom
+import win32com
+from win32com import universal
+from win32com.axcontrol import axcontrol
+from win32com.client import Dispatch, DispatchWithEvents, constants, gencache, getevents
+from win32com.shell import shell
+from win32com.shell.shellcon import *
+
+try:
+    # try to get styles (winxp)
+    import winxpgui as win32gui
+except:
+    # import default module (win2k and lower)
+    import win32gui
+
+import array
+import struct
+
+import commctrl
+import win32con
+import win32ui
+
+# ensure we know the ms internet controls typelib so we have access to IWebBrowser2 later on
+win32com.client.gencache.EnsureModule("{EAB22AC0-30C1-11CF-A7EB-0000C05BAE0B}", 0, 1, 1)
+
+#
+IDeskBand_methods = ["GetBandInfo"]
+IDockingWindow_methods = ["ShowDW", "CloseDW", "ResizeBorderDW"]
+IOleWindow_methods = ["GetWindow", "ContextSensitiveHelp"]
+IInputObject_methods = ["UIActivateIO", "HasFocusIO", "TranslateAcceleratorIO"]
+IObjectWithSite_methods = ["SetSite", "GetSite"]
+IPersistStream_methods = ["GetClassID", "IsDirty", "Load", "Save", "GetSizeMax"]
+
+_ietoolbar_methods_ = (
+    IDeskBand_methods
+    + IDockingWindow_methods
+    + IOleWindow_methods
+    + IInputObject_methods
+    + IObjectWithSite_methods
+    + IPersistStream_methods
+)
+_ietoolbar_com_interfaces_ = [
+    shell.IID_IDeskBand,  # IDeskBand
+    axcontrol.IID_IObjectWithSite,  # IObjectWithSite
+    pythoncom.IID_IPersistStream,
+    axcontrol.IID_IOleCommandTarget,
+]
+
+
+class WIN32STRUCT:
+    def __init__(self, **kw):
+        full_fmt = ""
+        for name, fmt, default in self._struct_items_:
+            self.__dict__[name] = None
+            if fmt == "z":
+                full_fmt += "pi"
+            else:
+                full_fmt += fmt
+        for name, val in kw.items():
+            self.__dict__[name] = val
+
+    def __setattr__(self, attr, val):
+        if not attr.startswith("_") and attr not in self.__dict__:
+            raise AttributeError(attr)
+        self.__dict__[attr] = val
+
+    def toparam(self):
+        self._buffs = []
+        full_fmt = ""
+        vals = []
+        for name, fmt, default in self._struct_items_:
+            val = self.__dict__[name]
+            if fmt == "z":
+                fmt = "Pi"
+                if val is None:
+                    vals.append(0)
+                    vals.append(0)
+                else:
+                    str_buf = array.array("c", val + "\0")
+                    vals.append(str_buf.buffer_info()[0])
+                    vals.append(len(val))
+                    self._buffs.append(str_buf)  # keep alive during the call.
+            else:
+                if val is None:
+                    val = default
+                vals.append(val)
+            full_fmt += fmt
+        return struct.pack(*(full_fmt,) + tuple(vals))
+
+
+class TBBUTTON(WIN32STRUCT):
+    _struct_items_ = [
+        ("iBitmap", "i", 0),
+        ("idCommand", "i", 0),
+        ("fsState", "B", 0),
+        ("fsStyle", "B", 0),
+        ("bReserved", "H", 0),
+        ("dwData", "I", 0),
+        ("iString", "z", None),
+    ]
+
+
+class Stub:
+    """
+    this class serves as a method stub,
+    outputting debug info whenever the object
+    is being called.
+    """
+
+    def __init__(self, name):
+        self.name = name
+
+    def __call__(self, *args):
+        print("STUB: ", self.name, args)
+
+
+class IEToolbarCtrl:
+    """
+    a tiny wrapper for our winapi-based
+    toolbar control implementation.
+    """
+
+    def __init__(self, hwndparent):
+        styles = (
+            win32con.WS_CHILD
+            | win32con.WS_VISIBLE
+            | win32con.WS_CLIPSIBLINGS
+            | win32con.WS_CLIPCHILDREN
+            | commctrl.TBSTYLE_LIST
+            | commctrl.TBSTYLE_FLAT
+            | commctrl.TBSTYLE_TRANSPARENT
+            | commctrl.CCS_TOP
+            | commctrl.CCS_NODIVIDER
+            | commctrl.CCS_NORESIZE
+            | commctrl.CCS_NOPARENTALIGN
+        )
+        self.hwnd = win32gui.CreateWindow(
+            "ToolbarWindow32",
+            None,
+            styles,
+            0,
+            0,
+            100,
+            100,
+            hwndparent,
+            0,
+            win32gui.dllhandle,
+            None,
+        )
+        win32gui.SendMessage(self.hwnd, commctrl.TB_BUTTONSTRUCTSIZE, 20, 0)
+
+    def ShowWindow(self, mode):
+        win32gui.ShowWindow(self.hwnd, mode)
+
+    def AddButtons(self, *buttons):
+        tbbuttons = ""
+        for button in buttons:
+            tbbuttons += button.toparam()
+        return win32gui.SendMessage(
+            self.hwnd, commctrl.TB_ADDBUTTONS, len(buttons), tbbuttons
+        )
+
+    def GetSafeHwnd(self):
+        return self.hwnd
+
+
+class IEToolbar:
+    """
+    The actual COM server class
+    """
+
+    _com_interfaces_ = _ietoolbar_com_interfaces_
+    _public_methods_ = _ietoolbar_methods_
+    _reg_clsctx_ = pythoncom.CLSCTX_INPROC_SERVER
+    # if you copy and modify this example, be sure to change the clsid below
+    _reg_clsid_ = "{F21202A2-959A-4149-B1C3-68B9013F3335}"
+    _reg_progid_ = "PyWin32.IEToolbar"
+    _reg_desc_ = "PyWin32 IE Toolbar"
+
+    def __init__(self):
+        # put stubs for non-implemented methods
+        for method in self._public_methods_:
+            if not hasattr(self, method):
+                print("providing default stub for %s" % method)
+                setattr(self, method, Stub(method))
+
+    def GetWindow(self):
+        return self.toolbar.GetSafeHwnd()
+
+    def Load(self, stream):
+        # called when the toolbar is loaded
+        pass
+
+    def Save(self, pStream, fClearDirty):
+        # called when the toolbar shall save its information
+        pass
+
+    def CloseDW(self, dwReserved):
+        del self.toolbar
+
+    def ShowDW(self, bShow):
+        if bShow:
+            self.toolbar.ShowWindow(win32con.SW_SHOW)
+        else:
+            self.toolbar.ShowWindow(win32con.SW_HIDE)
+
+    def on_first_button(self):
+        print("first!")
+        self.webbrowser.Navigate2("http://starship.python.net/crew/mhammond/")
+
+    def on_second_button(self):
+        print("second!")
+
+    def on_third_button(self):
+        print("third!")
+
+    def toolbar_command_handler(self, args):
+        hwnd, message, wparam, lparam, time, point = args
+        if lparam == self.toolbar.GetSafeHwnd():
+            self._command_map[wparam]()
+
+    def SetSite(self, unknown):
+        if unknown:
+            # retrieve the parent window interface for this site
+            olewindow = unknown.QueryInterface(pythoncom.IID_IOleWindow)
+            # ask the window for its handle
+            hwndparent = olewindow.GetWindow()
+
+            # first get a command target
+            cmdtarget = unknown.QueryInterface(axcontrol.IID_IOleCommandTarget)
+            # then travel over to a service provider
+            serviceprovider = cmdtarget.QueryInterface(pythoncom.IID_IServiceProvider)
+            # finally ask for the internet explorer application, returned as a dispatch object
+            self.webbrowser = win32com.client.Dispatch(
+                serviceprovider.QueryService(
+                    "{0002DF05-0000-0000-C000-000000000046}", pythoncom.IID_IDispatch
+                )
+            )
+
+            # now create and set up the toolbar
+            self.toolbar = IEToolbarCtrl(hwndparent)
+
+            buttons = [
+                ("Visit PyWin32 Homepage", self.on_first_button),
+                ("Another Button", self.on_second_button),
+                ("Yet Another Button", self.on_third_button),
+            ]
+
+            self._command_map = {}
+            # wrap our parent window so we can hook message handlers
+            window = win32ui.CreateWindowFromHandle(hwndparent)
+
+            # add the buttons
+            for i in range(len(buttons)):
+                button = TBBUTTON()
+                name, func = buttons[i]
+                id = 0x4444 + i
+                button.iBitmap = -2
+                button.idCommand = id
+                button.fsState = commctrl.TBSTATE_ENABLED
+                button.fsStyle = commctrl.TBSTYLE_BUTTON
+                button.iString = name
+                self._command_map[0x4444 + i] = func
+                self.toolbar.AddButtons(button)
+                window.HookMessage(self.toolbar_command_handler, win32con.WM_COMMAND)
+        else:
+            # lose all references
+            self.webbrowser = None
+
+    def GetClassID(self):
+        return self._reg_clsid_
+
+    def GetBandInfo(self, dwBandId, dwViewMode, dwMask):
+        ptMinSize = (0, 24)
+        ptMaxSize = (2000, 24)
+        ptIntegral = (0, 0)
+        ptActual = (2000, 24)
+        wszTitle = "PyWin32 IE Toolbar"
+        dwModeFlags = DBIMF_VARIABLEHEIGHT
+        crBkgnd = 0
+        return (
+            ptMinSize,
+            ptMaxSize,
+            ptIntegral,
+            ptActual,
+            wszTitle,
+            dwModeFlags,
+            crBkgnd,
+        )
+
+
+# used for HKLM install
+def DllInstall(bInstall, cmdLine):
+    comclass = IEToolbar
+
+
+# register plugin
+def DllRegisterServer():
+    comclass = IEToolbar
+
+    # register toolbar with IE
+    try:
+        print("Trying to register Toolbar.\n")
+        hkey = winreg.CreateKey(
+            winreg.HKEY_LOCAL_MACHINE, "SOFTWARE\\Microsoft\\Internet Explorer\\Toolbar"
+        )
+        subKey = winreg.SetValueEx(
+            hkey, comclass._reg_clsid_, 0, winreg.REG_BINARY, "\0"
+        )
+    except WindowsError:
+        print(
+            "Couldn't set registry value.\nhkey: %d\tCLSID: %s\n"
+            % (hkey, comclass._reg_clsid_)
+        )
+    else:
+        print(
+            "Set registry value.\nhkey: %d\tCLSID: %s\n" % (hkey, comclass._reg_clsid_)
+        )
+    # TODO: implement reg settings for standard toolbar button
+
+
+# unregister plugin
+def DllUnregisterServer():
+    comclass = IEToolbar
+
+    # unregister toolbar from internet explorer
+    try:
+        print("Trying to unregister Toolbar.\n")
+        hkey = winreg.CreateKey(
+            winreg.HKEY_LOCAL_MACHINE, "SOFTWARE\\Microsoft\\Internet Explorer\\Toolbar"
+        )
+        winreg.DeleteValue(hkey, comclass._reg_clsid_)
+    except WindowsError:
+        print(
+            "Couldn't delete registry value.\nhkey: %d\tCLSID: %s\n"
+            % (hkey, comclass._reg_clsid_)
+        )
+    else:
+        print("Deleting reg key succeeded.\n")
+
+
+# entry point
+if __name__ == "__main__":
+    import win32com.server.register
+
+    win32com.server.register.UseCommandLine(IEToolbar)
+
+    # parse actual command line option
+    if "--unregister" in sys.argv:
+        DllUnregisterServer()
+    else:
+        DllRegisterServer()
+else:
+    # import trace utility for remote debugging
+    import win32traceutil
diff --git a/lib/win32com/demos/outlookAddin.py b/lib/win32com/demos/outlookAddin.py
new file mode 100644
index 00000000..9433596d
--- /dev/null
+++ b/lib/win32com/demos/outlookAddin.py
@@ -0,0 +1,138 @@
+# A demo plugin for Microsoft Outlook (NOT Outlook Express)
+#
+# This addin simply adds a new button to the main Outlook toolbar,
+# and displays a message box when clicked.  Thus, it demonstrates
+# how to plug in to Outlook itself, and hook outlook events.
+#
+# Additionally, each time a new message arrives in the Inbox, a message
+# is printed with the subject of the message.
+#
+# To register the addin, simply execute:
+#   outlookAddin.py
+# This will install the COM server, and write the necessary
+# AddIn key to Outlook
+#
+# To unregister completely:
+#   outlookAddin.py --unregister
+#
+# To debug, execute:
+#   outlookAddin.py --debug
+#
+# Then open Pythonwin, and select "Tools->Trace Collector Debugging Tool"
+# Restart Outlook, and you should see some output generated.
+#
+# NOTE: If the AddIn fails with an error, Outlook will re-register
+# the addin to not automatically load next time Outlook starts.  To
+# correct this, simply re-register the addin (see above)
+
+import sys
+
+import pythoncom
+from win32com import universal
+from win32com.client import DispatchWithEvents, constants, gencache
+from win32com.server.exception import COMException
+
+# Support for COM objects we use.
+gencache.EnsureModule(
+    "{00062FFF-0000-0000-C000-000000000046}", 0, 9, 0, bForDemand=True
+)  # Outlook 9
+gencache.EnsureModule(
+    "{2DF8D04C-5BFA-101B-BDE5-00AA0044DE52}", 0, 2, 1, bForDemand=True
+)  # Office 9
+
+# The TLB defining the interfaces we implement
+universal.RegisterInterfaces(
+    "{AC0714F2-3D04-11D1-AE7D-00A0C90F26F4}", 0, 1, 0, ["_IDTExtensibility2"]
+)
+
+
+class ButtonEvent:
+    def OnClick(self, button, cancel):
+        import win32ui  # Possible, but not necessary, to use a Pythonwin GUI
+
+        win32ui.MessageBox("Hello from Python")
+        return cancel
+
+
+class FolderEvent:
+    def OnItemAdd(self, item):
+        try:
+            print("An item was added to the inbox with subject:", item.Subject)
+        except AttributeError:
+            print(
+                "An item was added to the inbox, but it has no subject! - ", repr(item)
+            )
+
+
+class OutlookAddin:
+    _com_interfaces_ = ["_IDTExtensibility2"]
+    _public_methods_ = []
+    _reg_clsctx_ = pythoncom.CLSCTX_INPROC_SERVER
+    _reg_clsid_ = "{0F47D9F3-598B-4d24-B7E3-92AC15ED27E2}"
+    _reg_progid_ = "Python.Test.OutlookAddin"
+    _reg_policy_spec_ = "win32com.server.policy.EventHandlerPolicy"
+
+    def OnConnection(self, application, connectMode, addin, custom):
+        print("OnConnection", application, connectMode, addin, custom)
+        # ActiveExplorer may be none when started without a UI (eg, WinCE synchronisation)
+        activeExplorer = application.ActiveExplorer()
+        if activeExplorer is not None:
+            bars = activeExplorer.CommandBars
+            toolbar = bars.Item("Standard")
+            item = toolbar.Controls.Add(Type=constants.msoControlButton, Temporary=True)
+            # Hook events for the item
+            item = self.toolbarButton = DispatchWithEvents(item, ButtonEvent)
+            item.Caption = "Python"
+            item.TooltipText = "Click for Python"
+            item.Enabled = True
+
+        # And now, for the sake of demonstration, setup a hook for all new messages
+        inbox = application.Session.GetDefaultFolder(constants.olFolderInbox)
+        self.inboxItems = DispatchWithEvents(inbox.Items, FolderEvent)
+
+    def OnDisconnection(self, mode, custom):
+        print("OnDisconnection")
+
+    def OnAddInsUpdate(self, custom):
+        print("OnAddInsUpdate", custom)
+
+    def OnStartupComplete(self, custom):
+        print("OnStartupComplete", custom)
+
+    def OnBeginShutdown(self, custom):
+        print("OnBeginShutdown", custom)
+
+
+def RegisterAddin(klass):
+    import winreg
+
+    key = winreg.CreateKey(
+        winreg.HKEY_CURRENT_USER, "Software\\Microsoft\\Office\\Outlook\\Addins"
+    )
+    subkey = winreg.CreateKey(key, klass._reg_progid_)
+    winreg.SetValueEx(subkey, "CommandLineSafe", 0, winreg.REG_DWORD, 0)
+    winreg.SetValueEx(subkey, "LoadBehavior", 0, winreg.REG_DWORD, 3)
+    winreg.SetValueEx(subkey, "Description", 0, winreg.REG_SZ, klass._reg_progid_)
+    winreg.SetValueEx(subkey, "FriendlyName", 0, winreg.REG_SZ, klass._reg_progid_)
+
+
+def UnregisterAddin(klass):
+    import winreg
+
+    try:
+        winreg.DeleteKey(
+            winreg.HKEY_CURRENT_USER,
+            "Software\\Microsoft\\Office\\Outlook\\Addins\\" + klass._reg_progid_,
+        )
+    except WindowsError:
+        pass
+
+
+if __name__ == "__main__":
+    import win32com.server.register
+
+    win32com.server.register.UseCommandLine(OutlookAddin)
+    if "--unregister" in sys.argv:
+        UnregisterAddin(OutlookAddin)
+    else:
+        RegisterAddin(OutlookAddin)
diff --git a/lib/win32com/demos/trybag.py b/lib/win32com/demos/trybag.py
new file mode 100644
index 00000000..3d3918b6
--- /dev/null
+++ b/lib/win32com/demos/trybag.py
@@ -0,0 +1,77 @@
+import pythoncom
+from win32com.server import exception, util
+
+VT_EMPTY = pythoncom.VT_EMPTY
+
+
+class Bag:
+    _public_methods_ = ["Read", "Write"]
+    _com_interfaces_ = [pythoncom.IID_IPropertyBag]
+
+    def __init__(self):
+        self.data = {}
+
+    def Read(self, propName, varType, errorLog):
+        print("read: name=", propName, "type=", varType)
+        if propName not in self.data:
+            if errorLog:
+                hr = 0x80070057
+                exc = pythoncom.com_error(0, "Bag.Read", "no such item", None, 0, hr)
+                errorLog.AddError(propName, exc)
+            raise exception.Exception(scode=hr)
+        return self.data[propName]
+
+    def Write(self, propName, value):
+        print("write: name=", propName, "value=", value)
+        self.data[propName] = value
+
+
+class Target:
+    _public_methods_ = ["GetClassID", "InitNew", "Load", "Save"]
+    _com_interfaces_ = [pythoncom.IID_IPersist, pythoncom.IID_IPersistPropertyBag]
+
+    def GetClassID(self):
+        raise exception.Exception(scode=0x80004005)  # E_FAIL
+
+    def InitNew(self):
+        pass
+
+    def Load(self, bag, log):
+        print(bag.Read("prop1", VT_EMPTY, log))
+        print(bag.Read("prop2", VT_EMPTY, log))
+        try:
+            print(bag.Read("prop3", VT_EMPTY, log))
+        except exception.Exception:
+            pass
+
+    def Save(self, bag, clearDirty, saveAllProps):
+        bag.Write("prop1", "prop1.hello")
+        bag.Write("prop2", "prop2.there")
+
+
+class Log:
+    _public_methods_ = ["AddError"]
+    _com_interfaces_ = [pythoncom.IID_IErrorLog]
+
+    def AddError(self, propName, excepInfo):
+        print("error: propName=", propName, "error=", excepInfo)
+
+
+def test():
+    bag = Bag()
+    target = Target()
+    log = Log()
+
+    target.Save(bag, 1, 1)
+    target.Load(bag, log)
+
+    comBag = util.wrap(bag, pythoncom.IID_IPropertyBag)
+    comTarget = util.wrap(target, pythoncom.IID_IPersistPropertyBag)
+    comLog = util.wrap(log, pythoncom.IID_IErrorLog)
+
+    comTarget.Save(comBag, 1, 1)
+    comTarget.Load(comBag, comLog)
+
+
+if __name__ == "__main__":
+    test()
diff --git a/lib/win32com/include/PythonCOM.h b/lib/win32com/include/PythonCOM.h
new file mode 100644
index 00000000..e7599717
--- /dev/null
+++ b/lib/win32com/include/PythonCOM.h
@@ -0,0 +1,766 @@
+/* PythonCOM.h
+
+ Main header for Python COM support.
+
+ This file is involved mainly with client side COM support for
+ Python.
+
+ Most COM work put together by Greg Stein and Mark Hammond, with a
+ few others starting to come out of the closet.
+
+
+ --------------------------------------------------------------------
+ Thread State Rules
+ ------------------
+ These rules apply to PythonCOM in general, and not just to
+ the client side.
+
+ The rules are quite simple, but it is critical they be followed.
+ In general, errors here will be picked up quite quickly, as Python
+ will raise a Fatal Error.  However, the Release() issue in particular
+ may keep a number of problems well hidden.
+
+ Interfaces:
+ -----------
+ Before making ANY call out to COM, you MUST release the Python lock.
+ This is true to ANY call whatsoever, including the COM call in question,
+ but also any calls to "->Release();"
+
+ This is normally achieved with the calls
+ PY_INTERFACE_PRECALL and PY_INTERFACE_POSTCALL, which release
+ and acquire the Python lock.
+
+ Gateways:
+ ---------
+ Before doing anything related to Python, gateways MUST acquire the
+ Python lock, and must release it before returning.
+
+ This is normally achieved with PY_GATEWAY_METHOD at the top of a
+ gateway method.  This macro resolves to a class, which automatically does
+ the right thing.
+
+ Release:
+ --------
+ As mentioned above for Interfaces, EVERY call to Release() must be done
+ with the Python lock released.  This is expanded here.
+
+ This is very important, but an error may not be noticed.  The problem will
+ only be seen when the Release() is on a Python object and the Release() is the
+ final one for the object.  In this case, the Python object will attempt to
+ acquire the Python lock before destroying itself, and Python will raise a
+ fatal error.
+
+ In many many cases, you will not notice this error, but someday, someone will
+ implement the other side in Python, and suddenly FatalErrors will start
+ appearing.  Make sure you get this right.
+
+ Eg, this code is correct:
+   PY_INTERFACE_PRECALL;
+   pSomeObj->SomeFunction(pSomeOtherObject);
+   pSomeOtherObject->Release();
+   PY_INTERFACE_POSTCALL;
+
+ However, this code is WRONG, but will RARELY FAIL.
+   PY_INTERFACE_PRECALL;
+   pSomeObj->SomeFunction(pSomeOtherObject);
+   PY_INTERFACE_POSTCALL;
+   pSomeOtherObject->Release();
+--------------------------------------------------------------------
+*/
+#ifndef __PYTHONCOM_H__
+#define __PYTHONCOM_H__
+
+// #define _DEBUG_LIFETIMES // Trace COM object lifetimes.
+
+#ifdef FREEZE_PYTHONCOM
+/* The pythoncom module is being included in a frozen .EXE/.DLL */
+#define PYCOM_EXPORT
+#else
+#ifdef BUILD_PYTHONCOM
+/* We are building pythoncomxx.dll */
+#define PYCOM_EXPORT __declspec(dllexport)
+#else
+/* This module uses pythoncomxx.dll */
+#define PYCOM_EXPORT __declspec(dllimport)
+#ifndef _DEBUG
+#pragma comment(lib, "pythoncom.lib")
+#else
+#pragma comment(lib, "pythoncom_d.lib")
+#endif
+#endif
+#endif
+
+#ifdef MS_WINCE
+// List of interfaces not supported by CE.
+#define NO_PYCOM_IDISPATCHEX
+#define NO_PYCOM_IPROVIDECLASSINFO
+#define NO_PYCOM_IENUMGUID
+#define NO_PYCOM_IENUMCATEGORYINFO
+#define NO_PYCOM_ICATINFORMATION
+#define NO_PYCOM_ICATREGISTER
+#define NO_PYCOM_ISERVICEPROVIDER
+#define NO_PYCOM_IPROPERTYSTORAGE
+#define NO_PYCOM_IPROPERTYSETSTORAGE
+#define NO_PYCOM_ENUMSTATPROPSTG
+
+#include "ocidl.h"
+#include "oleauto.h"
+
+#endif  // MS_WINCE
+
+#ifdef __MINGW32__
+// Special Mingw32 considerations.
+#define NO_PYCOM_ENUMSTATPROPSTG
+#define __try try
+#define __except catch
+#include <olectl.h>
+
+#endif  // __MINGW32__
+
+#include <PyWinTypes.h>  // Standard Win32 Types
+
+#ifndef NO_PYCOM_IDISPATCHEX
+#include <dispex.h>  // New header for IDispatchEx interface.
+#endif               // NO_PYCOM_IDISPATCHEX
+
+#if defined(MAINWIN)
+// Mainwin seems to have 1/2 the VT_RECORD infrastructure in place
+#if !defined(VT_RECORD)
+#define VT_RECORD 36
+#define V_RECORDINFO(X) ((X)->brecVal.pRecInfo)
+#define V_RECORD(X) ((X)->brecVal.pvRecord)
+#else
+#pragma message(                                       \
+    "MAINWIN appears to have grown correct VT_RECORD " \
+    "support. Please update PythonCOM.h accordingly")
+#endif  // VT_RECORD
+#endif  // MAINWIN
+
+class PyIUnknown;
+// To make life interesting/complicated, I use C++ classes for
+// all Python objects.  The main advantage is that I can derive
+// a PyIDispatch object from a PyIUnknown, etc.  This provides a
+// clean C++ interface, and "automatically" provides all base
+// Python methods to "derived" Python types.
+//
+// Main disadvantage is that any extension DLLs will need to include
+// these headers, and link with this .lib
+//
+// Base class for (most of) the type objects.
+
+class PYCOM_EXPORT PyComTypeObject : public PyTypeObject {
+   public:
+    PyComTypeObject(const char *name, PyComTypeObject *pBaseType, Py_ssize_t typeSize, struct PyMethodDef *methodList,
+                    PyIUnknown *(*thector)(IUnknown *));
+    ~PyComTypeObject();
+
+    // is the given object an interface type object? (e.g. PyIUnknown)
+    static BOOL is_interface_type(PyObject *ob);
+
+   public:
+    PyIUnknown *(*ctor)(IUnknown *);
+};
+
+// A type used for interfaces that can automatically provide enumerators
+// (ie, they themselves aren't enumerable, but do have a suitable default
+// method that returns a PyIEnum object
+class PYCOM_EXPORT PyComEnumProviderTypeObject : public PyComTypeObject {
+   public:
+    PyComEnumProviderTypeObject(const char *name, PyComTypeObject *pBaseType, Py_ssize_t typeSize,
+                                struct PyMethodDef *methodList, PyIUnknown *(*thector)(IUnknown *),
+                                const char *enum_method_name);
+    static PyObject *iter(PyObject *self);
+    const char *enum_method_name;
+};
+
+// A type used for PyIEnum interfaces
+class PYCOM_EXPORT PyComEnumTypeObject : public PyComTypeObject {
+   public:
+    static PyObject *iter(PyObject *self);
+    static PyObject *iternext(PyObject *self);
+    PyComEnumTypeObject(const char *name, PyComTypeObject *pBaseType, Py_ssize_t typeSize, struct PyMethodDef *methodList,
+                        PyIUnknown *(*thector)(IUnknown *));
+};
+
+// Very very base class - not COM specific - Should exist in the
+// Python core somewhere, IMO.
+class PYCOM_EXPORT PyIBase : public PyObject {
+   public:
+    // virtuals for Python support
+    virtual PyObject *getattr(char *name);
+    virtual int setattr(char *name, PyObject *v);
+    virtual PyObject *repr();
+    virtual int compare(PyObject *other)
+    {
+        if (this == other)
+            return 0;
+        if (this < other)
+            return -1;
+        return 1;
+    }
+    // These iter are a little special, in that returning NULL means
+    // use the implementation in the type
+    virtual PyObject *iter() { return NULL; }
+    virtual PyObject *iternext() { return NULL; }
+
+   protected:
+    PyIBase();
+    virtual ~PyIBase();
+
+   public:
+    static BOOL is_object(PyObject *, PyComTypeObject *which);
+    BOOL is_object(PyComTypeObject *which);
+    static void dealloc(PyObject *ob);
+    static PyObject *repr(PyObject *ob);
+    static PyObject *getattro(PyObject *self, PyObject *name);
+    static int setattro(PyObject *op, PyObject *obname, PyObject *v);
+    static int cmp(PyObject *ob1, PyObject *ob2);
+    static PyObject *richcmp(PyObject *ob1, PyObject *ob2, int op);
+};
+
+/* Special Type objects */
+extern PYCOM_EXPORT PyTypeObject PyOleEmptyType;        // equivalent to VT_EMPTY
+extern PYCOM_EXPORT PyTypeObject PyOleMissingType;      // special Python handling.
+extern PYCOM_EXPORT PyTypeObject PyOleArgNotFoundType;  // special VT_ERROR value
+extern PYCOM_EXPORT PyTypeObject PyOleNothingType;      // special VT_ERROR value
+
+// ALL of these set an appropriate Python error on bad return.
+
+// Given a Python object that is a registered COM type, return a given
+// interface pointer on its underlying object, with a new reference added.
+PYCOM_EXPORT BOOL PyCom_InterfaceFromPyObject(PyObject *ob, REFIID iid, LPVOID *ppv, BOOL bNoneOK = TRUE);
+
+// As above, but allows instance with "_oleobj_" attribute.
+PYCOM_EXPORT BOOL PyCom_InterfaceFromPyInstanceOrObject(PyObject *ob, REFIID iid, LPVOID *ppv, BOOL bNoneOK = TRUE);
+
+// Release an arbitary COM pointer.
+// NOTE: the PRECALL/POSTCALL stuff is probably not strictly necessary
+// since the PyGILSTATE stuff has been in place (and even then, it only
+// mattered when it was the last Release() on a Python implemented object)
+#define PYCOM_RELEASE(pUnk)        \
+    {                              \
+        if (pUnk) {                \
+            PY_INTERFACE_PRECALL;  \
+            (pUnk)->Release();     \
+            PY_INTERFACE_POSTCALL; \
+        }                          \
+    }
+
+// Given an IUnknown and an Interface ID, create and return an object
+// of the appropriate type. eg IID_Unknown->PyIUnknown,
+// IID_IDispatch->PyIDispatch, etc.
+// Uses a map that external extension DLLs can populate with their IID/type.
+// Under the principal of least surprise, this will return Py_None is punk is NULL.
+//  Otherwise, a valid PyI*, but with NULL m_obj (and therefore totally useless)
+//  object would be created.
+// BOOL bAddRef indicates if a COM reference count should be added to the IUnknown.
+//  This depends purely on the context in which it is called.  If the IUnknown is obtained
+//  from a function that creates a new ref (eg, CoCreateInstance()) then you should use
+//  FALSE.  If you receive the pointer as (eg) a param to a gateway function, then
+//  you normally need to pass TRUE, as this is truly a new reference.
+//  *** ALWAYS take the time to get this right. ***
+PYCOM_EXPORT PyObject *PyCom_PyObjectFromIUnknown(IUnknown *punk, REFIID riid, BOOL bAddRef = FALSE);
+
+// VARIANT <-> PyObject conversion utilities.
+PYCOM_EXPORT BOOL PyCom_VariantFromPyObject(PyObject *obj, VARIANT *var);
+PYCOM_EXPORT PyObject *PyCom_PyObjectFromVariant(const VARIANT *var);
+
+// PROPVARIANT
+PYCOM_EXPORT PyObject *PyObject_FromPROPVARIANT(PROPVARIANT *pVar);
+PYCOM_EXPORT PyObject *PyObject_FromPROPVARIANTs(PROPVARIANT *pVars, ULONG cVars);
+PYCOM_EXPORT BOOL PyObject_AsPROPVARIANT(PyObject *ob, PROPVARIANT *pVar);
+
+// Other conversion helpers...
+PYCOM_EXPORT PyObject *PyCom_PyObjectFromSTATSTG(STATSTG *pStat);
+PYCOM_EXPORT BOOL PyCom_PyObjectAsSTATSTG(PyObject *ob, STATSTG *pStat, DWORD flags = 0);
+PYCOM_EXPORT BOOL PyCom_SAFEARRAYFromPyObject(PyObject *obj, SAFEARRAY **ppSA, VARENUM vt = VT_VARIANT);
+PYCOM_EXPORT PyObject *PyCom_PyObjectFromSAFEARRAY(SAFEARRAY *psa, VARENUM vt = VT_VARIANT);
+#ifndef NO_PYCOM_STGOPTIONS
+PYCOM_EXPORT BOOL PyCom_PyObjectAsSTGOPTIONS(PyObject *obstgoptions, STGOPTIONS **ppstgoptions, TmpWCHAR *tmpw_shelve);
+#endif
+PYCOM_EXPORT PyObject *PyCom_PyObjectFromSTATPROPSETSTG(STATPROPSETSTG *pStat);
+PYCOM_EXPORT BOOL PyCom_PyObjectAsSTATPROPSETSTG(PyObject *, STATPROPSETSTG *);
+
+// Currency support.
+PYCOM_EXPORT PyObject *PyObject_FromCurrency(CURRENCY &cy);
+PYCOM_EXPORT BOOL PyObject_AsCurrency(PyObject *ob, CURRENCY *pcy);
+
+// OLEMENUGROUPWIDTHS are used by axcontrol, shell, etc
+PYCOM_EXPORT BOOL PyObject_AsOLEMENUGROUPWIDTHS(PyObject *oblpMenuWidths, OLEMENUGROUPWIDTHS *pWidths);
+PYCOM_EXPORT PyObject *PyObject_FromOLEMENUGROUPWIDTHS(const OLEMENUGROUPWIDTHS *pWidths);
+
+/* Functions for Initializing COM, and also letting the core know about it!
+ */
+PYCOM_EXPORT HRESULT PyCom_CoInitializeEx(LPVOID reserved, DWORD dwInit);
+PYCOM_EXPORT HRESULT PyCom_CoInitialize(LPVOID reserved);
+PYCOM_EXPORT void PyCom_CoUninitialize();
+
+///////////////////////////////////////////////////////////////////
+// Error related functions
+
+// Client related functions - generally called by interfaces before
+// they return NULL back to Python to indicate the error.
+// All these functions return NULL so interfaces can generally
+// just "return PyCom_BuildPyException(hr, punk, IID_IWhatever)"
+
+// Uses the HRESULT, and IErrorInfo interfaces if available to
+// create and set a pythoncom.com_error.
+PYCOM_EXPORT PyObject *PyCom_BuildPyException(HRESULT hr, IUnknown *pUnk = NULL, REFIID iid = IID_NULL);
+
+// Uses the HRESULT and an EXCEPINFO structure to create and
+// set a pythoncom.com_error.
+PYCOM_EXPORT PyObject *PyCom_BuildPyExceptionFromEXCEPINFO(HRESULT hr, EXCEPINFO *pexcepInfo, UINT nArgErr = (UINT)-1);
+
+// Sets a pythoncom.internal_error - no one should ever see these!
+PYCOM_EXPORT PyObject *PyCom_BuildInternalPyException(char *msg);
+
+// Log an error to a Python logger object if one can be found, or
+// to stderr if no log available.
+// If logProvider is not NULL, we will call a "_GetLogger_()" method on it.
+// If logProvider is NULL, we attempt to fetch "win32com.logger".
+// If they do not exist, return None, or raise an error fetching them
+// (or even writing to them once fetched), the message still goes to stderr.
+// NOTE: By default, win32com does *not* provide a logger, so default is that
+// all errors are written to stdout.
+// This will *not* write a record if a COM Server error is current.
+PYCOM_EXPORT void PyCom_LoggerNonServerException(PyObject *logProvider, const WCHAR *fmt, ...);
+
+// Write an error record, including exception.  This will write an error
+// record even if a COM server error is current.
+PYCOM_EXPORT void PyCom_LoggerException(PyObject *logProvider, const WCHAR *fmt, ...);
+
+// Write a warning record - in general this does *not* mean a call failed, but
+// still is something in the programmers control that they should change.
+// XXX - if an exception is pending when this is called, the traceback will
+// also be written.  This is undesirable and will be changed should this
+// start being a problem.
+PYCOM_EXPORT void PyCom_LoggerWarning(PyObject *logProvider, const WCHAR *fmt, ...);
+
+// Server related error functions
+// These are supplied so that any Python errors we detect can be
+// converted into COM error information.  The HRESULT returned should
+// be returned by the COM function, and these functions also set the
+// IErrorInfo interfaces, so the caller can extract more detailed
+// information about the Python exception.
+
+// Set a COM exception, logging the exception if not an explicitly raised 'server' exception
+PYCOM_EXPORT HRESULT PyCom_SetAndLogCOMErrorFromPyException(const char *methodName, REFIID riid /* = IID_NULL */);
+PYCOM_EXPORT HRESULT PyCom_SetAndLogCOMErrorFromPyExceptionEx(PyObject *provider, const char *methodName,
+                                                              REFIID riid /* = IID_NULL */);
+
+// Used in gateways to SetErrorInfo() with a simple HRESULT, then return it.
+// The description is generally only useful for debugging purposes,
+// and if you are debugging via a server that supports IErrorInfo (like Python :-)
+// NOTE: this function is usuable from outside the Python context
+PYCOM_EXPORT HRESULT PyCom_SetCOMErrorFromSimple(HRESULT hr, REFIID riid = IID_NULL, const WCHAR *description = NULL);
+
+// Used in gateways to check if an IEnum*'s Next() or Clone() method worked.
+PYCOM_EXPORT HRESULT PyCom_CheckIEnumNextResult(HRESULT hr, REFIID riid);
+
+// Used in gateways when an enumerator expected a sequence but didn't get it.
+PYCOM_EXPORT HRESULT PyCom_HandleIEnumNoSequence(REFIID riid);
+
+// Used in gateways to SetErrorInfo() the current Python exception, and
+// (assuming not a server error explicitly raised) also logs an error
+// to stdout/win32com.logger.
+// NOTE: this function assumes GIL held
+PYCOM_EXPORT HRESULT PyCom_SetCOMErrorFromPyException(REFIID riid = IID_NULL);
+
+// A couple of EXCEPINFO helpers - could be private to IDispatch
+// if it wasnt for the AXScript support (and ITypeInfo if we get around to that :-)
+// These functions do not set any error states to either Python or
+// COM - they simply convert to/from PyObjects and EXCEPINFOs
+
+// Use the current Python exception to fill an EXCEPINFO structure.
+PYCOM_EXPORT void PyCom_ExcepInfoFromPyException(EXCEPINFO *pExcepInfo);
+
+// Fill in an EXCEPINFO structure from a Python instance or tuple object.
+// (ie, similar to the above, except the Python exception object is specified,
+// rather than using the "current"
+PYCOM_EXPORT BOOL PyCom_ExcepInfoFromPyObject(PyObject *obExcepInfo, EXCEPINFO *pexcepInfo, HRESULT *phresult = NULL);
+
+// Create a Python object holding the exception information.  The exception
+// information is *not* freed by this function.  Python exceptions are
+// raised and NULL is returned if an error occurs.
+PYCOM_EXPORT PyObject *PyCom_PyObjectFromExcepInfo(const EXCEPINFO *pexcepInfo);
+
+///////////////////////////////////////////////////////////////////
+//
+// External C++ helpers - these helpers are for other DLLs which
+// may need similar functionality, but dont want to duplicate all
+
+// This helper is for an application that has an IDispatch, and COM arguments
+// and wants to call a Python function.  It is assumed the caller can map the IDispatch
+// to a Python object, so the Python handler is passed.
+// Args:
+//   handler : A Python callable object.
+//   dispparms : the COM arguments.
+//   pVarResult : The variant for the return value of the Python call.
+//   pexcepinfo : Exception info the helper may fill out.
+//   puArgErr : Argument error the helper may fill out on exception
+//   addnArgs : Any additional arguments to the Python function.  May be NULL.
+// If addnArgs is NULL, then it is assumed the Python call should be native -
+// ie, the COM args are packed as normal Python args to the call.
+// If addnArgs is NOT NULL, it is assumed the Python function itself is
+// a helper.  This Python function will be called with 2 arguments - both
+// tuples - first one is the COM args, second is the addn args.
+PYCOM_EXPORT BOOL PyCom_MakeOlePythonCall(PyObject *handler, DISPPARAMS FAR *params, VARIANT FAR *pVarResult,
+                                          EXCEPINFO FAR *pexcepinfo, UINT FAR *puArgErr, PyObject *addnlArgs);
+
+/////////////////////////////////////////////////////////////////////////////
+// Various special purpose singletons
+class PYCOM_EXPORT PyOleEmpty : public PyObject {
+   public:
+    PyOleEmpty();
+};
+
+class PYCOM_EXPORT PyOleMissing : public PyObject {
+   public:
+    PyOleMissing();
+};
+
+class PYCOM_EXPORT PyOleArgNotFound : public PyObject {
+   public:
+    PyOleArgNotFound();
+};
+
+class PYCOM_EXPORT PyOleNothing : public PyObject {
+   public:
+    PyOleNothing();
+};
+
+// We need to dynamically create C++ Python objects
+// These helpers allow each type object to create it.
+#define MAKE_PYCOM_CTOR(classname) \
+    static PyIUnknown *PyObConstruct(IUnknown *pInitObj) { return new classname(pInitObj); }
+#define MAKE_PYCOM_CTOR_ERRORINFO(classname, iid)                                                       \
+    static PyIUnknown *PyObConstruct(IUnknown *pInitObj) { return new classname(pInitObj); }            \
+    static PyObject *SetPythonCOMError(PyObject *self, HRESULT hr)                                      \
+    {                                                                                                   \
+        return PyCom_BuildPyException(hr, GetI(self), iid);                                             \
+    }
+#define GET_PYCOM_CTOR(classname) classname::PyObConstruct
+
+// Macros that interfaces should use.  PY_INTERFACE_METHOD at the top of the method
+// The other 2 wrap directly around the underlying method call.
+#define PY_INTERFACE_METHOD
+// Identical to Py_BEGIN_ALLOW_THREADS except no { !!!
+#define PY_INTERFACE_PRECALL PyThreadState *_save = PyEval_SaveThread();
+#define PY_INTERFACE_POSTCALL PyEval_RestoreThread(_save);
+
+/////////////////////////////////////////////////////////////////////////////
+// class PyIUnknown
+class PYCOM_EXPORT PyIUnknown : public PyIBase {
+   public:
+    MAKE_PYCOM_CTOR(PyIUnknown);
+    virtual PyObject *repr();
+    virtual int compare(PyObject *other);
+
+    static IUnknown *GetI(PyObject *self);
+    IUnknown *m_obj;
+    static char *szErrMsgObjectReleased;
+    static void SafeRelease(PyIUnknown *ob);
+    static PyComTypeObject type;
+
+    // The Python methods
+    static PyObject *QueryInterface(PyObject *self, PyObject *args);
+    static PyObject *SafeRelease(PyObject *self, PyObject *args);
+
+   protected:
+    PyIUnknown(IUnknown *punk);
+    ~PyIUnknown();
+};
+
+/////////////////////////////////////////////////////////////////////////////
+// class PyIDispatch
+
+class PYCOM_EXPORT PyIDispatch : public PyIUnknown {
+   public:
+    MAKE_PYCOM_CTOR(PyIDispatch);
+    static IDispatch *GetI(PyObject *self);
+    static PyComTypeObject type;
+
+    // The Python methods
+    static PyObject *Invoke(PyObject *self, PyObject *args);
+    static PyObject *InvokeTypes(PyObject *self, PyObject *args);
+    static PyObject *GetIDsOfNames(PyObject *self, PyObject *args);
+    static PyObject *GetTypeInfo(PyObject *self, PyObject *args);
+    static PyObject *GetTypeInfoCount(PyObject *self, PyObject *args);
+
+   protected:
+    PyIDispatch(IUnknown *pdisp);
+    ~PyIDispatch();
+};
+
+#ifndef NO_PYCOM_IDISPATCHEX
+/////////////////////////////////////////////////////////////////////////////
+// class PyIDispatchEx
+
+class PYCOM_EXPORT PyIDispatchEx : public PyIDispatch {
+   public:
+    MAKE_PYCOM_CTOR_ERRORINFO(PyIDispatchEx, IID_IDispatchEx);
+    static IDispatchEx *GetI(PyObject *self);
+    static PyComTypeObject type;
+
+    // The Python methods
+    static PyObject *GetDispID(PyObject *self, PyObject *args);
+    static PyObject *InvokeEx(PyObject *self, PyObject *args);
+    static PyObject *DeleteMemberByName(PyObject *self, PyObject *args);
+    static PyObject *DeleteMemberByDispID(PyObject *self, PyObject *args);
+    static PyObject *GetMemberProperties(PyObject *self, PyObject *args);
+    static PyObject *GetMemberName(PyObject *self, PyObject *args);
+    static PyObject *GetNextDispID(PyObject *self, PyObject *args);
+
+   protected:
+    PyIDispatchEx(IUnknown *pdisp);
+    ~PyIDispatchEx();
+};
+#endif  // NO_PYCOM_IDISPATCHEX
+
+/////////////////////////////////////////////////////////////////////////////
+// class PyIClassFactory
+
+class PYCOM_EXPORT PyIClassFactory : public PyIUnknown {
+   public:
+    MAKE_PYCOM_CTOR(PyIClassFactory);
+    static IClassFactory *GetI(PyObject *self);
+    static PyComTypeObject type;
+
+    // The Python methods
+    static PyObject *CreateInstance(PyObject *self, PyObject *args);
+    static PyObject *LockServer(PyObject *self, PyObject *args);
+
+   protected:
+    PyIClassFactory(IUnknown *pdisp);
+    ~PyIClassFactory();
+};
+
+#ifndef NO_PYCOM_IPROVIDECLASSINFO
+
+/////////////////////////////////////////////////////////////////////////////
+// class PyIProvideTypeInfo
+
+class PYCOM_EXPORT PyIProvideClassInfo : public PyIUnknown {
+   public:
+    MAKE_PYCOM_CTOR(PyIProvideClassInfo);
+    static IProvideClassInfo *GetI(PyObject *self);
+    static PyComTypeObject type;
+
+    // The Python methods
+    static PyObject *GetClassInfo(PyObject *self, PyObject *args);
+
+   protected:
+    PyIProvideClassInfo(IUnknown *pdisp);
+    ~PyIProvideClassInfo();
+};
+
+class PYCOM_EXPORT PyIProvideClassInfo2 : public PyIProvideClassInfo {
+   public:
+    MAKE_PYCOM_CTOR(PyIProvideClassInfo2);
+    static IProvideClassInfo2 *GetI(PyObject *self);
+    static PyComTypeObject type;
+
+    // The Python methods
+    static PyObject *GetGUID(PyObject *self, PyObject *args);
+
+   protected:
+    PyIProvideClassInfo2(IUnknown *pdisp);
+    ~PyIProvideClassInfo2();
+};
+#endif  // NO_PYCOM_IPROVIDECLASSINFO
+
+/////////////////////////////////////////////////////////////////////////////
+// class PyITypeInfo
+class PYCOM_EXPORT PyITypeInfo : public PyIUnknown {
+   public:
+    MAKE_PYCOM_CTOR(PyITypeInfo);
+    static PyComTypeObject type;
+    static ITypeInfo *GetI(PyObject *self);
+
+    PyObject *GetContainingTypeLib();
+    PyObject *GetDocumentation(MEMBERID);
+    PyObject *GetRefTypeInfo(HREFTYPE href);
+    PyObject *GetRefTypeOfImplType(int index);
+    PyObject *GetFuncDesc(int pos);
+    PyObject *GetIDsOfNames(OLECHAR FAR *FAR *, int);
+    PyObject *GetNames(MEMBERID);
+    PyObject *GetTypeAttr();
+    PyObject *GetVarDesc(int pos);
+    PyObject *GetImplTypeFlags(int index);
+    PyObject *GetTypeComp();
+
+   protected:
+    PyITypeInfo(IUnknown *);
+    ~PyITypeInfo();
+};
+
+/////////////////////////////////////////////////////////////////////////////
+// class PyITypeComp
+class PYCOM_EXPORT PyITypeComp : public PyIUnknown {
+   public:
+    MAKE_PYCOM_CTOR(PyITypeComp);
+    static PyComTypeObject type;
+    static ITypeComp *GetI(PyObject *self);
+
+    PyObject *Bind(OLECHAR *szName, unsigned short wflags);
+    PyObject *BindType(OLECHAR *szName);
+
+   protected:
+    PyITypeComp(IUnknown *);
+    ~PyITypeComp();
+};
+
+/////////////////////////////////////////////////////////////////////////////
+// class CPyTypeLib
+
+class PYCOM_EXPORT PyITypeLib : public PyIUnknown {
+   public:
+    MAKE_PYCOM_CTOR(PyITypeLib);
+    static PyComTypeObject type;
+    static ITypeLib *GetI(PyObject *self);
+
+    PyObject *GetLibAttr();
+    PyObject *GetDocumentation(int pos);
+    PyObject *GetTypeInfo(int pos);
+    PyObject *GetTypeInfoCount();
+    PyObject *GetTypeInfoOfGuid(REFGUID guid);
+    PyObject *GetTypeInfoType(int pos);
+    PyObject *GetTypeComp();
+
+   protected:
+    PyITypeLib(IUnknown *);
+    ~PyITypeLib();
+};
+
+/////////////////////////////////////////////////////////////////////////////
+// class PyIConnectionPoint
+
+class PYCOM_EXPORT PyIConnectionPoint : public PyIUnknown {
+   public:
+    MAKE_PYCOM_CTOR_ERRORINFO(PyIConnectionPoint, IID_IConnectionPoint);
+    static PyComTypeObject type;
+    static IConnectionPoint *GetI(PyObject *self);
+
+    static PyObject *GetConnectionInterface(PyObject *self, PyObject *args);
+    static PyObject *GetConnectionPointContainer(PyObject *self, PyObject *args);
+    static PyObject *Advise(PyObject *self, PyObject *args);
+    static PyObject *Unadvise(PyObject *self, PyObject *args);
+    static PyObject *EnumConnections(PyObject *self, PyObject *args);
+
+   protected:
+    PyIConnectionPoint(IUnknown *);
+    ~PyIConnectionPoint();
+};
+
+class PYCOM_EXPORT PyIConnectionPointContainer : public PyIUnknown {
+   public:
+    MAKE_PYCOM_CTOR_ERRORINFO(PyIConnectionPointContainer, IID_IConnectionPointContainer);
+    static PyComTypeObject type;
+    static IConnectionPointContainer *GetI(PyObject *self);
+
+    static PyObject *EnumConnectionPoints(PyObject *self, PyObject *args);
+    static PyObject *FindConnectionPoint(PyObject *self, PyObject *args);
+
+   protected:
+    PyIConnectionPointContainer(IUnknown *);
+    ~PyIConnectionPointContainer();
+};
+
+/////////////////////////////////////////////////////////////////////////////
+// class PythonOleArgHelper
+//
+// A PythonOleArgHelper is used primarily to help out Python helpers
+// which need to convert from a Python object when the specific OLE
+// type is known - eg, when a TypeInfo is available.
+//
+// The type of conversion determines who owns what buffers etc.  I wish BYREF didnt exist :-)
+typedef enum {
+    // We dont know what sort of conversion it is yet.
+    POAH_CONVERT_UNKNOWN,
+    // A PyObject is given, we convert to a VARIANT, make the COM call, then BYREFs back to a PyObject
+    // ie, this is typically a "normal" COM call, where Python initiates the call
+    POAH_CONVERT_FROM_PYOBJECT,
+    // A VARIANT is given, we convert to a PyObject, make the Python call, then BYREFs back to a VARIANT.
+    // ie, this is typically handling a COM event, where COM itself initiates the call.
+    POAH_CONVERT_FROM_VARIANT,
+} POAH_CONVERT_DIRECTION;
+
+class PYCOM_EXPORT PythonOleArgHelper {
+   public:
+    PythonOleArgHelper();
+    ~PythonOleArgHelper();
+    BOOL ParseTypeInformation(PyObject *reqdObjectTuple);
+
+    // Using this call with reqdObject != NULL will check the existing
+    // VT_ of the variant.  If not VT_EMPTY, then the result will be coerced to
+    // that type.  This contrasts with PyCom_PyObjectToVariant which just
+    // uses the Python type to determine the variant type.
+    BOOL MakeObjToVariant(PyObject *obj, VARIANT *var, PyObject *reqdObjectTuple = NULL);
+    PyObject *MakeVariantToObj(VARIANT *var);
+
+    VARTYPE m_reqdType;
+    BOOL m_bParsedTypeInfo;
+    BOOL m_bIsOut;
+    POAH_CONVERT_DIRECTION m_convertDirection;
+    PyObject *m_pyVariant;  // if non-null, a win32com.client.VARIANT
+    union {
+        void *m_pValueHolder;
+        short m_sBuf;
+        long m_lBuf;
+        LONGLONG m_llBuf;
+        VARIANT_BOOL m_boolBuf;
+        double m_dBuf;
+        float m_fBuf;
+        IDispatch *m_dispBuf;
+        IUnknown *m_unkBuf;
+        SAFEARRAY *m_arrayBuf;
+        VARIANT *m_varBuf;
+        DATE m_dateBuf;
+        CY m_cyBuf;
+    };
+};
+
+/////////////////////////////////////////////////////////////////////////////
+// global functions and variables
+PYCOM_EXPORT BOOL MakePythonArgumentTuples(PyObject **pArgs, PythonOleArgHelper **ppHelpers, PyObject **pNamedArgs,
+                                           PythonOleArgHelper **ppNamedHelpers, DISPPARAMS FAR *params);
+
+// Convert a Python object to a BSTR - allow embedded NULLs, None, etc.
+PYCOM_EXPORT BOOL PyCom_BstrFromPyObject(PyObject *stringObject, BSTR *pResult, BOOL bNoneOK = FALSE);
+
+// MakeBstrToObj - convert a BSTR into a Python string.
+//
+// ONLY USE THIS FOR TRUE BSTR's - Use the fn below for OLECHAR *'s.
+// NOTE - does not use standard macros, so NULLs get through!
+PYCOM_EXPORT PyObject *MakeBstrToObj(const BSTR bstr);
+
+// Size info is available (eg, a fn returns a string and also fills in a size variable)
+PYCOM_EXPORT PyObject *MakeOLECHARToObj(const OLECHAR *str, int numChars);
+
+// No size info avail.
+PYCOM_EXPORT PyObject *MakeOLECHARToObj(const OLECHAR *str);
+
+PYCOM_EXPORT void PyCom_LogF(const WCHAR *fmt, ...);
+
+// Generic conversion from python sequence to VT_VECTOR array
+// Resulting array must be freed with CoTaskMemFree
+template <typename arraytype>
+BOOL SeqToVector(PyObject *ob, arraytype **pA, ULONG *pcount, BOOL (*converter)(PyObject *, arraytype *))
+{
+    TmpPyObject seq = PyWinSequence_Tuple(ob, pcount);
+    if (seq == NULL)
+        return FALSE;
+    *pA = (arraytype *)CoTaskMemAlloc(*pcount * sizeof(arraytype));
+    if (*pA == NULL) {
+        PyErr_NoMemory();
+        return FALSE;
+    }
+    for (ULONG i = 0; i < *pcount; i++) {
+        PyObject *item = PyTuple_GET_ITEM((PyObject *)seq, i);
+        if (!(*converter)(item, &(*pA)[i]))
+            return FALSE;
+    }
+    return TRUE;
+}
+
+#endif  // __PYTHONCOM_H__
diff --git a/lib/win32com/include/PythonCOMRegister.h b/lib/win32com/include/PythonCOMRegister.h
new file mode 100644
index 00000000..ab960f53
--- /dev/null
+++ b/lib/win32com/include/PythonCOMRegister.h
@@ -0,0 +1,84 @@
+// Support for PythonCOM and its extensions to register the interfaces,
+// gateways and IIDs it supports.
+//
+// The module can simply declare an array of type PyCom_InterfaceSupportInfo, then
+// use the macros to populate it.
+//
+// See Register.cpp and AXScript.cpp for examples on its use.
+
+#ifndef __PYTHONCOMREGISTER_H__
+#define __PYTHONCOMREGISTER_H__
+
+#include "PythonCOMServer.h"  // Need defns in this file...
+
+typedef struct {
+    const GUID *pGUID;             // The supported IID - required
+    const char *interfaceName;     // Name of the interface - required
+    const char *iidName;           // Name of the IID that goes into the dict. - required
+    PyTypeObject *pTypeOb;         // the type object for client PyI* side - NULL for server only support.
+    pfnPyGatewayConstructor ctor;  // Gateway (PyG*) interface constructor - NULL for client only support
+
+} PyCom_InterfaceSupportInfo;
+
+#define PYCOM_INTERFACE_IID_ONLY(ifc)                   \
+    {                                                   \
+        &IID_I##ifc, "I" #ifc, "IID_I" #ifc, NULL, NULL \
+    }
+#define PYCOM_INTERFACE_CLSID_ONLY(ifc)                        \
+    {                                                          \
+        &CLSID_##ifc, "CLSID_" #ifc, "CLSID_" #ifc, NULL, NULL \
+    }
+#define PYCOM_INTERFACE_CATID_ONLY(ifc)                        \
+    {                                                          \
+        &CATID_##ifc, "CATID_" #ifc, "CATID_" #ifc, NULL, NULL \
+    }
+#define PYCOM_INTERFACE_CLIENT_ONLY(ifc)                           \
+    {                                                              \
+        &IID_I##ifc, "I" #ifc, "IID_I" #ifc, &PyI##ifc::type, NULL \
+    }
+#define PYCOM_INTERFACE_SERVER_ONLY(ifc)                                        \
+    {                                                                           \
+        &IID_I##ifc, "I" #ifc, "IID_I" #ifc, NULL, GET_PYGATEWAY_CTOR(PyG##ifc) \
+    }
+#define PYCOM_INTERFACE_FULL(ifc)                                                          \
+    {                                                                                      \
+        &IID_I##ifc, "I" #ifc, "IID_I" #ifc, &PyI##ifc::type, GET_PYGATEWAY_CTOR(PyG##ifc) \
+    }
+
+// Versions that use __uuidof() to get the IID, which seems to avoid the need
+// to link with a lib holding the IIDs.  Note that almost all extensions
+// build with __uuidof() being the default; the build failed at 'shell' - so
+// we could consider making this the default and making the 'explicit' version
+// above the special case.
+#define PYCOM_INTERFACE_IID_ONLY_UUIDOF(ifc)                  \
+    {                                                         \
+        &__uuidof(I##ifc), "I" #ifc, "IID_I" #ifc, NULL, NULL \
+    }
+#define PYCOM_INTERFACE_CLIENT_ONLY_UUIDOF(ifc)                          \
+    {                                                                    \
+        &__uuidof(I##ifc), "I" #ifc, "IID_I" #ifc, &PyI##ifc::type, NULL \
+    }
+#define PYCOM_INTERFACE_SERVER_ONLY_UUIDOF(ifc)                                       \
+    {                                                                                 \
+        &__uuidof(I##ifc), "I" #ifc, "IID_I" #ifc, NULL, GET_PYGATEWAY_CTOR(PyG##ifc) \
+    }
+#define PYCOM_INTERFACE_FULL_UUIDOF(ifc)                                                         \
+    {                                                                                            \
+        &__uuidof(I##ifc), "I" #ifc, "IID_I" #ifc, &PyI##ifc::type, GET_PYGATEWAY_CTOR(PyG##ifc) \
+    }
+
+// Prototypes for the register functions
+
+// Register a PythonCOM extension module
+PYCOM_EXPORT int PyCom_RegisterExtensionSupport(PyObject *dict, const PyCom_InterfaceSupportInfo *pInterfaces,
+                                                int numEntries);
+
+// THESE SHOULD NO LONGER BE USED.  Instead, use the functions above passing an
+// array of PyCom_InterfaceSupportInfo objects.
+
+PYCOM_EXPORT int PyCom_RegisterClientType(PyTypeObject *typeOb, const GUID *guid);
+
+HRESULT PYCOM_EXPORT PyCom_RegisterGatewayObject(REFIID iid, pfnPyGatewayConstructor ctor, const char *interfaceName);
+PYCOM_EXPORT int PyCom_IsGatewayRegistered(REFIID iid);
+
+#endif /* __PYTHONCOMREGISTER_H__ */
diff --git a/lib/win32com/include/PythonCOMServer.h b/lib/win32com/include/PythonCOMServer.h
new file mode 100644
index 00000000..d263b3ad
--- /dev/null
+++ b/lib/win32com/include/PythonCOMServer.h
@@ -0,0 +1,176 @@
+#ifndef __PYTHONCOMSERVER_H__
+#define __PYTHONCOMSERVER_H__
+
+// PythonCOMServer.h :Server side COM support
+
+#include <Python.h>
+
+#define DLLAcquireGlobalLock PyWin_AcquireGlobalLock
+#define DLLReleaseGlobalLock PyWin_ReleaseGlobalLock
+
+void PYCOM_EXPORT PyCom_DLLAddRef(void);
+void PYCOM_EXPORT PyCom_DLLReleaseRef(void);
+
+// Use this macro at the start of all gateway methods.
+#define PY_GATEWAY_METHOD CEnterLeavePython _celp
+
+class PyGatewayBase;
+// Gateway constructors.
+// Each gateway must be able to be created from a "gateway constructor".  This
+// is simply a function that takes a Python instance as as argument, and returns
+// a gateway object of the correct type.  The MAKE_PYGATEWAY_CTOR is a helper that
+// will embed such a constructor in the class - however, this is not necessary -
+// _any_ function of the correct signature can be used.
+
+typedef HRESULT (*pfnPyGatewayConstructor)(PyObject *PythonInstance, PyGatewayBase *, void **ppResult, REFIID iid);
+HRESULT PyCom_MakeRegisteredGatewayObject(REFIID iid, PyObject *instance, PyGatewayBase *base, void **ppv);
+
+// A version of the above which support classes being derived from
+// other than IUnknown
+#define PYGATEWAY_MAKE_SUPPORT2(classname, IInterface, theIID, gatewaybaseclass)                                 \
+   public:                                                                                                       \
+    static HRESULT PyGatewayConstruct(PyObject *pPyInstance, PyGatewayBase *unkBase, void **ppResult,            \
+                                                 REFIID iid)                                                     \
+    {                                                                                                            \
+        if (ppResult == NULL)                                                                                    \
+            return E_INVALIDARG;                                                                                 \
+        classname *newob = new classname(pPyInstance);                                                           \
+        newob->m_pBaseObject = unkBase;                                                                          \
+        if (unkBase)                                                                                             \
+            unkBase->AddRef();                                                                                   \
+        *ppResult = newob->ThisAsIID(iid);                                                                       \
+        return *ppResult ? S_OK : E_OUTOFMEMORY;                                                                 \
+    }                                                                                                            \
+                                                                                                                 \
+   protected:                                                                                                    \
+    virtual IID GetIID(void) { return theIID; }                                                                  \
+    virtual void *ThisAsIID(IID iid)                                                                             \
+    {                                                                                                            \
+        if (this == NULL)                                                                                        \
+            return NULL;                                                                                         \
+        if (iid == theIID)                                                                                       \
+            return (IInterface *)this;                                                                           \
+        else                                                                                                     \
+            return gatewaybaseclass::ThisAsIID(iid);                                                             \
+    }                                                                                                            \
+    STDMETHOD_(ULONG, AddRef)(void) { return gatewaybaseclass::AddRef(); }                                       \
+    STDMETHOD_(ULONG, Release)(void) { return gatewaybaseclass::Release(); }                                     \
+    STDMETHOD(QueryInterface)(REFIID iid, void **obj) { return gatewaybaseclass::QueryInterface(iid, obj); };
+
+// This is the "old" version to use, or use it if you derive
+// directly from PyGatewayBase
+#define PYGATEWAY_MAKE_SUPPORT(classname, IInterface, theIID) \
+    PYGATEWAY_MAKE_SUPPORT2(classname, IInterface, theIID, PyGatewayBase)
+
+#define GET_PYGATEWAY_CTOR(classname) classname::PyGatewayConstruct
+
+#ifdef _MSC_VER
+// Disable an OK warning...
+#pragma warning(disable : 4275)
+// warning C4275: non dll-interface struct 'IDispatch' used as base for dll-interface class 'PyGatewayBase'
+#endif  // _MSC_VER
+
+// Helper interface for fetching a Python object from a gateway
+
+extern const GUID IID_IInternalUnwrapPythonObject;
+
+interface IInternalUnwrapPythonObject : public IUnknown
+{
+   public:
+    STDMETHOD(Unwrap)(PyObject * *ppPyObject) = 0;
+};
+
+/////////////////////////////////////////////////////////////////////////////
+// PyGatewayBase
+//
+// Base class for all gateways.
+//
+class PYCOM_EXPORT PyGatewayBase :
+#ifndef NO_PYCOM_IDISPATCHEX
+    public IDispatchEx,  // IDispatch comes along for the ride!
+#else
+    public IDispatch,  // No IDispatchEx - must explicitely use IDispatch
+#endif
+    public ISupportErrorInfo,
+    public IInternalUnwrapPythonObject {
+   protected:
+    PyGatewayBase(PyObject *instance);
+    virtual ~PyGatewayBase();
+
+    // Invoke the Python method (via the policy object)
+    STDMETHOD(InvokeViaPolicy)(const char *szMethodName, PyObject **ppResult = NULL, const char *szFormat = NULL, ...);
+
+   public:
+    // IUnknown
+    STDMETHOD_(ULONG, AddRef)(void);
+    STDMETHOD_(ULONG, Release)(void);
+    STDMETHOD(QueryInterface)(REFIID iid, void **obj);
+
+    // IDispatch
+    STDMETHOD(GetTypeInfoCount)(UINT FAR *pctInfo);
+    STDMETHOD(GetTypeInfo)(UINT itinfo, LCID lcid, ITypeInfo FAR *FAR *pptInfo);
+    STDMETHOD(GetIDsOfNames)(REFIID refiid, OLECHAR FAR *FAR *rgszNames, UINT cNames, LCID lcid, DISPID FAR *rgdispid);
+    STDMETHOD(Invoke)
+    (DISPID dispid, REFIID riid, LCID lcid, WORD wFlags, DISPPARAMS FAR *params, VARIANT FAR *pVarResult,
+     EXCEPINFO FAR *pexcepinfo, UINT FAR *puArgErr);
+
+    // IDispatchEx
+#ifndef NO_PYCOM_IDISPATCHEX
+    STDMETHOD(GetDispID)(BSTR bstrName, DWORD grfdex, DISPID *pid);
+    STDMETHOD(InvokeEx)
+    (DISPID id, LCID lcid, WORD wFlags, DISPPARAMS *pdp, VARIANT *pvarRes, EXCEPINFO *pei, IServiceProvider *pspCaller);
+    STDMETHOD(DeleteMemberByName)(BSTR bstr, DWORD grfdex);
+    STDMETHOD(DeleteMemberByDispID)(DISPID id);
+    STDMETHOD(GetMemberProperties)(DISPID id, DWORD grfdexFetch, DWORD *pgrfdex);
+    STDMETHOD(GetMemberName)(DISPID id, BSTR *pbstrName);
+    STDMETHOD(GetNextDispID)(DWORD grfdex, DISPID id, DISPID *pid);
+    STDMETHOD(GetNameSpaceParent)(IUnknown **ppunk);
+#endif  // NO_PYCOM_IDISPATCHEX
+    // ISupportErrorInfo
+    STDMETHOD(InterfaceSupportsErrorInfo)(REFIID riid);
+
+    // IInternalUnwrapPythonObject
+    STDMETHOD(Unwrap)(PyObject **ppPyObject);
+
+    // Basically just PYGATEWAY_MAKE_SUPPORT(PyGatewayBase, IDispatch, IID_IDispatch);
+    // but with special handling as its the base class.
+    static HRESULT PyGatewayConstruct(PyObject *pPyInstance, PyGatewayBase *gatewayBase, void **ppResult,
+                                                     REFIID iid)
+    {
+        if (ppResult == NULL)
+            return E_INVALIDARG;
+        PyGatewayBase *obNew = new PyGatewayBase(pPyInstance);
+        obNew->m_pBaseObject = gatewayBase;
+        if (gatewayBase)
+            gatewayBase->AddRef();
+        *ppResult = (IDispatch *)obNew;
+        return *ppResult ? S_OK : E_OUTOFMEMORY;
+    }
+    // Currently this is used only for ISupportErrorInfo,
+    // so hopefully this will never be called in this base class.
+    // (however, this is not a rule, so we wont assert or anything!)
+    virtual IID GetIID(void) { return IID_IUnknown; }
+    virtual void *ThisAsIID(IID iid);
+    // End of PYGATEWAY_MAKE_SUPPORT
+    PyObject *m_pPyObject;
+    PyGatewayBase *m_pBaseObject;
+
+   private:
+    LONG m_cRef;
+};
+
+#ifdef _MSC_VER
+#pragma warning(default : 4275)
+#endif  // _MSC_VER
+
+// B/W compat hack for gateways.
+#define PyCom_HandlePythonFailureToCOM() \
+    PyCom_SetAndLogCOMErrorFromPyExceptionEx(this->m_pPyObject, "<unknown>", GetIID())
+
+// F/W compat hack for gateways!  Must be careful about updating
+// PyGatewayBase vtable, so a slightly older pythoncomXX.dll will work
+// with slightly later extensions.  So use a #define.
+#define MAKE_PYCOM_GATEWAY_FAILURE_CODE(method_name) \
+    PyCom_SetAndLogCOMErrorFromPyExceptionEx(this->m_pPyObject, method_name, GetIID())
+
+#endif /* __PYTHONCOMSERVER_H__ */
diff --git a/lib/win32com/makegw/__init__.py b/lib/win32com/makegw/__init__.py
new file mode 100644
index 00000000..6178c97c
--- /dev/null
+++ b/lib/win32com/makegw/__init__.py
@@ -0,0 +1 @@
+# indicates a python package.
diff --git a/lib/win32com/makegw/makegw.py b/lib/win32com/makegw/makegw.py
new file mode 100644
index 00000000..8d2e83d6
--- /dev/null
+++ b/lib/win32com/makegw/makegw.py
@@ -0,0 +1,560 @@
+"""Utility functions for writing out gateway C++ files
+
+  This module will generate a C++/Python binding for a specific COM
+  interface.
+  
+  At this stage, no command line interface exists.  You must start Python, 
+  import this module,  change to the directory where the generated code should
+  be written, and run the public function.
+  
+  This module is capable of generating both 'Interfaces' (ie, Python
+  client side support for the interface) and 'Gateways' (ie, Python
+  server side support for the interface).  Many COM interfaces are useful
+  both as Client and Server.  Other interfaces, however, really only make
+  sense to implement one side or the other.  For example, it would be pointless
+  for Python to implement Server side for 'IRunningObjectTable', unless we were
+  implementing core COM for an operating system in Python (hey - now there's an idea!)
+  
+  Most COM interface code is totally boiler-plate - it consists of
+  converting arguments, dispatching the call to Python, and processing
+  any result values.
+  
+  This module automates the generation of such code.  It has the ability to
+  parse a .H file generated by the MIDL tool (ie, almost all COM .h files)
+  and build almost totally complete C++ code.
+  
+  The module understands some of the well known data types, and how to
+  convert them.  There are only a couple of places where hand-editing is
+  necessary, as detailed below:
+
+  unsupported types -- If a type is not known, the generator will
+  pretty much ignore it, but write a comment to the generated code.  You
+  may want to add custom support for this type.  In some cases, C++ compile errors
+  will result.  These are intentional - generating code to remove these errors would
+  imply a false sense of security that the generator has done the right thing.
+
+  other return policies -- By default, Python never sees the return SCODE from
+  a COM function.  The interface usually returns None if OK, else a COM exception
+  if "FAILED(scode)" is TRUE.  You may need to change this if:
+  * EXCEPINFO is passed to the COM function.  This is not detected and handled
+  * For some reason Python should always see the result SCODE, even if it
+    did fail or succeed.  For example, some functions return a BOOLEAN result
+    in the SCODE, meaning Python should always see it.
+  * FAILED(scode) for the interface still has valid data to return (by default,
+    the code generated does not process the return values, and raise an exception
+    to Python/COM
+  
+"""
+
+import re
+
+from . import makegwparse
+
+
+def make_framework_support(
+    header_file_name, interface_name, bMakeInterface=1, bMakeGateway=1
+):
+    """Generate C++ code for a Python Interface and Gateway
+
+    header_file_name -- The full path to the .H file which defines the interface.
+    interface_name -- The name of the interface to search for, and to generate.
+    bMakeInterface = 1 -- Should interface (ie, client) support be generated.
+    bMakeGatewayInterface = 1 -- Should gateway (ie, server) support be generated.
+
+    This method will write a .cpp and .h file into the current directory,
+    (using the name of the interface to build the file name.
+
+    """
+    fin = open(header_file_name)
+    try:
+        interface = makegwparse.parse_interface_info(interface_name, fin)
+    finally:
+        fin.close()
+
+    if bMakeInterface and bMakeGateway:
+        desc = "Interface and Gateway"
+    elif bMakeInterface and not bMakeGateway:
+        desc = "Interface"
+    else:
+        desc = "Gateway"
+    if interface.name[:5] == "IEnum":  # IEnum - use my really simple template-based one
+        import win32com.makegw.makegwenum
+
+        ifc_cpp_writer = win32com.makegw.makegwenum._write_enumifc_cpp
+        gw_cpp_writer = win32com.makegw.makegwenum._write_enumgw_cpp
+    else:  # Use my harder working ones.
+        ifc_cpp_writer = _write_ifc_cpp
+        gw_cpp_writer = _write_gw_cpp
+
+    fout = open("Py%s.cpp" % interface.name, "w")
+    try:
+        fout.write(
+            """\
+// This file implements the %s %s for Python.
+// Generated by makegw.py
+
+#include "shell_pch.h"
+"""
+            % (interface.name, desc)
+        )
+        #    if bMakeGateway:
+        #      fout.write('#include "PythonCOMServer.h"\n')
+        #    if interface.base not in ["IUnknown", "IDispatch"]:
+        #      fout.write('#include "Py%s.h"\n' % interface.base)
+        fout.write(
+            '#include "Py%s.h"\n\n// @doc - This file contains autoduck documentation\n'
+            % interface.name
+        )
+        if bMakeInterface:
+            ifc_cpp_writer(fout, interface)
+        if bMakeGateway:
+            gw_cpp_writer(fout, interface)
+    finally:
+        fout.close()
+    fout = open("Py%s.h" % interface.name, "w")
+    try:
+        fout.write(
+            """\
+// This file declares the %s %s for Python.
+// Generated by makegw.py
+"""
+            % (interface.name, desc)
+        )
+
+        if bMakeInterface:
+            _write_ifc_h(fout, interface)
+        if bMakeGateway:
+            _write_gw_h(fout, interface)
+    finally:
+        fout.close()
+
+
+###########################################################################
+#
+# INTERNAL FUNCTIONS
+#
+#
+
+
+def _write_ifc_h(f, interface):
+    f.write(
+        """\
+// ---------------------------------------------------
+//
+// Interface Declaration
+
+class Py%s : public Py%s
+{
+public:
+	MAKE_PYCOM_CTOR(Py%s);
+	static %s *GetI(PyObject *self);
+	static PyComTypeObject type;
+
+	// The Python methods
+"""
+        % (interface.name, interface.base, interface.name, interface.name)
+    )
+    for method in interface.methods:
+        f.write(
+            "\tstatic PyObject *%s(PyObject *self, PyObject *args);\n" % method.name
+        )
+    f.write(
+        """\
+
+protected:
+	Py%s(IUnknown *pdisp);
+	~Py%s();
+};
+"""
+        % (interface.name, interface.name)
+    )
+
+
+def _write_ifc_cpp(f, interface):
+    name = interface.name
+    f.write(
+        """\
+// ---------------------------------------------------
+//
+// Interface Implementation
+
+Py%(name)s::Py%(name)s(IUnknown *pdisp):
+	Py%(base)s(pdisp)
+{
+	ob_type = &type;
+}
+
+Py%(name)s::~Py%(name)s()
+{
+}
+
+/* static */ %(name)s *Py%(name)s::GetI(PyObject *self)
+{
+	return (%(name)s *)Py%(base)s::GetI(self);
+}
+
+"""
+        % (interface.__dict__)
+    )
+
+    ptr = re.sub("[a-z]", "", interface.name)
+    strdict = {"interfacename": interface.name, "ptr": ptr}
+    for method in interface.methods:
+        strdict["method"] = method.name
+        f.write(
+            """\
+// @pymethod |Py%(interfacename)s|%(method)s|Description of %(method)s.
+PyObject *Py%(interfacename)s::%(method)s(PyObject *self, PyObject *args)
+{
+	%(interfacename)s *p%(ptr)s = GetI(self);
+	if ( p%(ptr)s == NULL )
+		return NULL;
+"""
+            % strdict
+        )
+        argsParseTuple = (
+            argsCOM
+        ) = (
+            formatChars
+        ) = codePost = codePobjects = codeCobjects = cleanup = cleanup_gil = ""
+        needConversion = 0
+        #    if method.name=="Stat": import win32dbg;win32dbg.brk()
+        for arg in method.args:
+            try:
+                argCvt = makegwparse.make_arg_converter(arg)
+                if arg.HasAttribute("in"):
+                    val = argCvt.GetFormatChar()
+                    if val:
+                        f.write("\t" + argCvt.GetAutoduckString() + "\n")
+                        formatChars = formatChars + val
+                        argsParseTuple = (
+                            argsParseTuple + ", " + argCvt.GetParseTupleArg()
+                        )
+                        codePobjects = (
+                            codePobjects + argCvt.DeclareParseArgTupleInputConverter()
+                        )
+                        codePost = codePost + argCvt.GetParsePostCode()
+                        needConversion = needConversion or argCvt.NeedUSES_CONVERSION()
+                        cleanup = cleanup + argCvt.GetInterfaceArgCleanup()
+                        cleanup_gil = cleanup_gil + argCvt.GetInterfaceArgCleanupGIL()
+                comArgName, comArgDeclString = argCvt.GetInterfaceCppObjectInfo()
+                if comArgDeclString:  # If we should declare a variable
+                    codeCobjects = codeCobjects + "\t%s;\n" % (comArgDeclString)
+                argsCOM = argsCOM + ", " + comArgName
+            except makegwparse.error_not_supported as why:
+                f.write(
+                    '// *** The input argument %s of type "%s" was not processed ***\n//     Please check the conversion function is appropriate and exists!\n'
+                    % (arg.name, arg.raw_type)
+                )
+
+                f.write(
+                    "\t%s %s;\n\tPyObject *ob%s;\n" % (arg.type, arg.name, arg.name)
+                )
+                f.write(
+                    "\t// @pyparm <o Py%s>|%s||Description for %s\n"
+                    % (arg.type, arg.name, arg.name)
+                )
+                codePost = (
+                    codePost
+                    + "\tif (bPythonIsHappy && !PyObject_As%s( ob%s, &%s )) bPythonIsHappy = FALSE;\n"
+                    % (arg.type, arg.name, arg.name)
+                )
+
+                formatChars = formatChars + "O"
+                argsParseTuple = argsParseTuple + ", &ob%s" % (arg.name)
+
+                argsCOM = argsCOM + ", " + arg.name
+                cleanup = cleanup + "\tPyObject_Free%s(%s);\n" % (arg.type, arg.name)
+
+        if needConversion:
+            f.write("\tUSES_CONVERSION;\n")
+        f.write(codePobjects)
+        f.write(codeCobjects)
+        f.write(
+            '\tif ( !PyArg_ParseTuple(args, "%s:%s"%s) )\n\t\treturn NULL;\n'
+            % (formatChars, method.name, argsParseTuple)
+        )
+        if codePost:
+            f.write("\tBOOL bPythonIsHappy = TRUE;\n")
+            f.write(codePost)
+            f.write("\tif (!bPythonIsHappy) return NULL;\n")
+        strdict["argsCOM"] = argsCOM[1:]
+        strdict["cleanup"] = cleanup
+        strdict["cleanup_gil"] = cleanup_gil
+        f.write(
+            """	HRESULT hr;
+	PY_INTERFACE_PRECALL;
+	hr = p%(ptr)s->%(method)s(%(argsCOM)s );
+%(cleanup)s
+	PY_INTERFACE_POSTCALL;
+%(cleanup_gil)s
+	if ( FAILED(hr) )
+		return PyCom_BuildPyException(hr, p%(ptr)s, IID_%(interfacename)s );
+"""
+            % strdict
+        )
+        codePre = codePost = formatChars = codeVarsPass = codeDecl = ""
+        for arg in method.args:
+            if not arg.HasAttribute("out"):
+                continue
+            try:
+                argCvt = makegwparse.make_arg_converter(arg)
+                formatChar = argCvt.GetFormatChar()
+                if formatChar:
+                    formatChars = formatChars + formatChar
+                    codePre = codePre + argCvt.GetBuildForInterfacePreCode()
+                    codePost = codePost + argCvt.GetBuildForInterfacePostCode()
+                    codeVarsPass = codeVarsPass + ", " + argCvt.GetBuildValueArg()
+                    codeDecl = codeDecl + argCvt.DeclareParseArgTupleInputConverter()
+            except makegwparse.error_not_supported as why:
+                f.write(
+                    '// *** The output argument %s of type "%s" was not processed ***\n//     %s\n'
+                    % (arg.name, arg.raw_type, why)
+                )
+                continue
+        if formatChars:
+            f.write(
+                '%s\n%s\tPyObject *pyretval = Py_BuildValue("%s"%s);\n%s\treturn pyretval;'
+                % (codeDecl, codePre, formatChars, codeVarsPass, codePost)
+            )
+        else:
+            f.write("\tPy_INCREF(Py_None);\n\treturn Py_None;\n")
+        f.write("\n}\n\n")
+
+    f.write("// @object Py%s|Description of the interface\n" % (name))
+    f.write("static struct PyMethodDef Py%s_methods[] =\n{\n" % name)
+    for method in interface.methods:
+        f.write(
+            '\t{ "%s", Py%s::%s, 1 }, // @pymeth %s|Description of %s\n'
+            % (method.name, interface.name, method.name, method.name, method.name)
+        )
+
+    interfacebase = interface.base
+    f.write(
+        """\
+	{ NULL }
+};
+
+PyComTypeObject Py%(name)s::type("Py%(name)s",
+		&Py%(interfacebase)s::type,
+		sizeof(Py%(name)s),
+		Py%(name)s_methods,
+		GET_PYCOM_CTOR(Py%(name)s));
+"""
+        % locals()
+    )
+
+
+def _write_gw_h(f, interface):
+    if interface.name[0] == "I":
+        gname = "PyG" + interface.name[1:]
+    else:
+        gname = "PyG" + interface.name
+    name = interface.name
+    if interface.base == "IUnknown" or interface.base == "IDispatch":
+        base_name = "PyGatewayBase"
+    else:
+        if interface.base[0] == "I":
+            base_name = "PyG" + interface.base[1:]
+        else:
+            base_name = "PyG" + interface.base
+    f.write(
+        """\
+// ---------------------------------------------------
+//
+// Gateway Declaration
+
+class %s : public %s, public %s
+{
+protected:
+	%s(PyObject *instance) : %s(instance) { ; }
+	PYGATEWAY_MAKE_SUPPORT2(%s, %s, IID_%s, %s)
+
+"""
+        % (gname, base_name, name, gname, base_name, gname, name, name, base_name)
+    )
+    if interface.base != "IUnknown":
+        f.write(
+            "\t// %s\n\t// *** Manually add %s method decls here\n\n"
+            % (interface.base, interface.base)
+        )
+    else:
+        f.write("\n\n")
+
+    f.write("\t// %s\n" % name)
+
+    for method in interface.methods:
+        f.write("\tSTDMETHOD(%s)(\n" % method.name)
+        if method.args:
+            for arg in method.args[:-1]:
+                f.write("\t\t%s,\n" % (arg.GetRawDeclaration()))
+            arg = method.args[-1]
+            f.write("\t\t%s);\n\n" % (arg.GetRawDeclaration()))
+        else:
+            f.write("\t\tvoid);\n\n")
+
+    f.write("};\n")
+    f.close()
+
+
+def _write_gw_cpp(f, interface):
+    if interface.name[0] == "I":
+        gname = "PyG" + interface.name[1:]
+    else:
+        gname = "PyG" + interface.name
+    name = interface.name
+    if interface.base == "IUnknown" or interface.base == "IDispatch":
+        base_name = "PyGatewayBase"
+    else:
+        if interface.base[0] == "I":
+            base_name = "PyG" + interface.base[1:]
+        else:
+            base_name = "PyG" + interface.base
+    f.write(
+        """\
+// ---------------------------------------------------
+//
+// Gateway Implementation
+"""
+        % {"name": name, "gname": gname, "base_name": base_name}
+    )
+
+    for method in interface.methods:
+        f.write(
+            """\
+STDMETHODIMP %s::%s(
+"""
+            % (gname, method.name)
+        )
+
+        if method.args:
+            for arg in method.args[:-1]:
+                inoutstr = "][".join(arg.inout)
+                f.write("\t\t/* [%s] */ %s,\n" % (inoutstr, arg.GetRawDeclaration()))
+
+            arg = method.args[-1]
+            inoutstr = "][".join(arg.inout)
+            f.write("\t\t/* [%s] */ %s)\n" % (inoutstr, arg.GetRawDeclaration()))
+        else:
+            f.write("\t\tvoid)\n")
+
+        f.write("{\n\tPY_GATEWAY_METHOD;\n")
+        cout = 0
+        codePre = codePost = codeVars = ""
+        argStr = ""
+        needConversion = 0
+        formatChars = ""
+        if method.args:
+            for arg in method.args:
+                if arg.HasAttribute("out"):
+                    cout = cout + 1
+                    if arg.indirectionLevel == 2:
+                        f.write("\tif (%s==NULL) return E_POINTER;\n" % arg.name)
+                if arg.HasAttribute("in"):
+                    try:
+                        argCvt = makegwparse.make_arg_converter(arg)
+                        argCvt.SetGatewayMode()
+                        formatchar = argCvt.GetFormatChar()
+                        needConversion = needConversion or argCvt.NeedUSES_CONVERSION()
+
+                        if formatchar:
+                            formatChars = formatChars + formatchar
+                            codeVars = (
+                                codeVars + argCvt.DeclareParseArgTupleInputConverter()
+                            )
+                            argStr = argStr + ", " + argCvt.GetBuildValueArg()
+                        codePre = codePre + argCvt.GetBuildForGatewayPreCode()
+                        codePost = codePost + argCvt.GetBuildForGatewayPostCode()
+                    except makegwparse.error_not_supported as why:
+                        f.write(
+                            '// *** The input argument %s of type "%s" was not processed ***\n//   - Please ensure this conversion function exists, and is appropriate\n//   - %s\n'
+                            % (arg.name, arg.raw_type, why)
+                        )
+                        f.write(
+                            "\tPyObject *ob%s = PyObject_From%s(%s);\n"
+                            % (arg.name, arg.type, arg.name)
+                        )
+                        f.write(
+                            '\tif (ob%s==NULL) return MAKE_PYCOM_GATEWAY_FAILURE_CODE("%s");\n'
+                            % (arg.name, method.name)
+                        )
+                        codePost = codePost + "\tPy_DECREF(ob%s);\n" % arg.name
+                        formatChars = formatChars + "O"
+                        argStr = argStr + ", ob%s" % (arg.name)
+
+        if needConversion:
+            f.write("\tUSES_CONVERSION;\n")
+        f.write(codeVars)
+        f.write(codePre)
+        if cout:
+            f.write("\tPyObject *result;\n")
+            resStr = "&result"
+        else:
+            resStr = "NULL"
+
+        if formatChars:
+            fullArgStr = '%s, "%s"%s' % (resStr, formatChars, argStr)
+        else:
+            fullArgStr = resStr
+
+        f.write('\tHRESULT hr=InvokeViaPolicy("%s", %s);\n' % (method.name, fullArgStr))
+        f.write(codePost)
+        if cout:
+            f.write("\tif (FAILED(hr)) return hr;\n")
+            f.write(
+                "\t// Process the Python results, and convert back to the real params\n"
+            )
+            # process the output arguments.
+            formatChars = codePobjects = codePost = argsParseTuple = ""
+            needConversion = 0
+            for arg in method.args:
+                if not arg.HasAttribute("out"):
+                    continue
+                try:
+                    argCvt = makegwparse.make_arg_converter(arg)
+                    argCvt.SetGatewayMode()
+                    val = argCvt.GetFormatChar()
+                    if val:
+                        formatChars = formatChars + val
+                        argsParseTuple = (
+                            argsParseTuple + ", " + argCvt.GetParseTupleArg()
+                        )
+                        codePobjects = (
+                            codePobjects + argCvt.DeclareParseArgTupleInputConverter()
+                        )
+                        codePost = codePost + argCvt.GetParsePostCode()
+                        needConversion = needConversion or argCvt.NeedUSES_CONVERSION()
+                except makegwparse.error_not_supported as why:
+                    f.write(
+                        '// *** The output argument %s of type "%s" was not processed ***\n//     %s\n'
+                        % (arg.name, arg.raw_type, why)
+                    )
+
+            if formatChars:  # If I have any to actually process.
+                if len(formatChars) == 1:
+                    parseFn = "PyArg_Parse"
+                else:
+                    parseFn = "PyArg_ParseTuple"
+                if codePobjects:
+                    f.write(codePobjects)
+                f.write(
+                    '\tif (!%s(result, "%s" %s))\n\t\treturn MAKE_PYCOM_GATEWAY_FAILURE_CODE("%s");\n'
+                    % (parseFn, formatChars, argsParseTuple, method.name)
+                )
+            if codePost:
+                f.write("\tBOOL bPythonIsHappy = TRUE;\n")
+                f.write(codePost)
+                f.write(
+                    '\tif (!bPythonIsHappy) hr = MAKE_PYCOM_GATEWAY_FAILURE_CODE("%s");\n'
+                    % method.name
+                )
+            f.write("\tPy_DECREF(result);\n")
+        f.write("\treturn hr;\n}\n\n")
+
+
+def test():
+    # 	make_framework_support("d:\\msdev\\include\\objidl.h", "ILockBytes")
+    make_framework_support("d:\\msdev\\include\\objidl.h", "IStorage")
+
+
+# 	make_framework_support("d:\\msdev\\include\\objidl.h", "IEnumSTATSTG")
diff --git a/lib/win32com/makegw/makegwenum.py b/lib/win32com/makegw/makegwenum.py
new file mode 100644
index 00000000..39c9b2d1
--- /dev/null
+++ b/lib/win32com/makegw/makegwenum.py
@@ -0,0 +1,331 @@
+"""Utility file for generating PyIEnum support.
+
+This is almost a 'template' file.  It simplay contains almost full
+C++ source code for PyIEnum* support, and the Python code simply
+substitutes the appropriate interface name.
+
+This module is notmally not used directly - the @makegw@ module
+automatically calls this.
+"""
+#
+# INTERNAL FUNCTIONS
+#
+#
+import string
+
+
+def is_interface_enum(enumtype):
+    return not (enumtype[0] in string.uppercase and enumtype[2] in string.uppercase)
+
+
+def _write_enumifc_cpp(f, interface):
+    enumtype = interface.name[5:]
+    if is_interface_enum(enumtype):
+        # Assume an interface.
+        enum_interface = "I" + enumtype[:-1]
+        converter = (
+            "PyObject *ob = PyCom_PyObjectFromIUnknown(rgVar[i], IID_%(enum_interface)s, FALSE);"
+            % locals()
+        )
+        arraydeclare = (
+            "%(enum_interface)s **rgVar = new %(enum_interface)s *[celt];" % locals()
+        )
+    else:
+        # Enum of a simple structure
+        converter = (
+            "PyObject *ob = PyCom_PyObjectFrom%(enumtype)s(&rgVar[i]);" % locals()
+        )
+        arraydeclare = "%(enumtype)s *rgVar = new %(enumtype)s[celt];" % locals()
+
+    f.write(
+        """
+// ---------------------------------------------------
+//
+// Interface Implementation
+
+PyIEnum%(enumtype)s::PyIEnum%(enumtype)s(IUnknown *pdisp):
+	PyIUnknown(pdisp)
+{
+	ob_type = &type;
+}
+
+PyIEnum%(enumtype)s::~PyIEnum%(enumtype)s()
+{
+}
+
+/* static */ IEnum%(enumtype)s *PyIEnum%(enumtype)s::GetI(PyObject *self)
+{
+	return (IEnum%(enumtype)s *)PyIUnknown::GetI(self);
+}
+
+// @pymethod object|PyIEnum%(enumtype)s|Next|Retrieves a specified number of items in the enumeration sequence.
+PyObject *PyIEnum%(enumtype)s::Next(PyObject *self, PyObject *args)
+{
+	long celt = 1;
+	// @pyparm int|num|1|Number of items to retrieve.
+	if ( !PyArg_ParseTuple(args, "|l:Next", &celt) )
+		return NULL;
+
+	IEnum%(enumtype)s *pIE%(enumtype)s = GetI(self);
+	if ( pIE%(enumtype)s == NULL )
+		return NULL;
+
+	%(arraydeclare)s
+	if ( rgVar == NULL ) {
+		PyErr_SetString(PyExc_MemoryError, "allocating result %(enumtype)ss");
+		return NULL;
+	}
+
+	int i;
+/*	for ( i = celt; i--; )
+		// *** possibly init each structure element???
+*/
+
+	ULONG celtFetched = 0;
+	PY_INTERFACE_PRECALL;
+	HRESULT hr = pIE%(enumtype)s->Next(celt, rgVar, &celtFetched);
+	PY_INTERFACE_POSTCALL;
+	if (  HRESULT_CODE(hr) != ERROR_NO_MORE_ITEMS && FAILED(hr) )
+	{
+		delete [] rgVar;
+		return PyCom_BuildPyException(hr,pIE%(enumtype)s, IID_IE%(enumtype)s);
+	}
+
+	PyObject *result = PyTuple_New(celtFetched);
+	if ( result != NULL )
+	{
+		for ( i = celtFetched; i--; )
+		{
+			%(converter)s
+			if ( ob == NULL )
+			{
+				Py_DECREF(result);
+				result = NULL;
+				break;
+			}
+			PyTuple_SET_ITEM(result, i, ob);
+		}
+	}
+
+/*	for ( i = celtFetched; i--; )
+		// *** possibly cleanup each structure element???
+*/
+	delete [] rgVar;
+	return result;
+}
+
+// @pymethod |PyIEnum%(enumtype)s|Skip|Skips over the next specified elementes.
+PyObject *PyIEnum%(enumtype)s::Skip(PyObject *self, PyObject *args)
+{
+	long celt;
+	if ( !PyArg_ParseTuple(args, "l:Skip", &celt) )
+		return NULL;
+
+	IEnum%(enumtype)s *pIE%(enumtype)s = GetI(self);
+	if ( pIE%(enumtype)s == NULL )
+		return NULL;
+
+	PY_INTERFACE_PRECALL;
+	HRESULT hr = pIE%(enumtype)s->Skip(celt);
+	PY_INTERFACE_POSTCALL;
+	if ( FAILED(hr) )
+		return PyCom_BuildPyException(hr, pIE%(enumtype)s, IID_IE%(enumtype)s);
+
+	Py_INCREF(Py_None);
+	return Py_None;
+}
+
+// @pymethod |PyIEnum%(enumtype)s|Reset|Resets the enumeration sequence to the beginning.
+PyObject *PyIEnum%(enumtype)s::Reset(PyObject *self, PyObject *args)
+{
+	if ( !PyArg_ParseTuple(args, ":Reset") )
+		return NULL;
+
+	IEnum%(enumtype)s *pIE%(enumtype)s = GetI(self);
+	if ( pIE%(enumtype)s == NULL )
+		return NULL;
+
+	PY_INTERFACE_PRECALL;
+	HRESULT hr = pIE%(enumtype)s->Reset();
+	PY_INTERFACE_POSTCALL;
+	if ( FAILED(hr) )
+		return PyCom_BuildPyException(hr, pIE%(enumtype)s, IID_IE%(enumtype)s);
+
+	Py_INCREF(Py_None);
+	return Py_None;
+}
+
+// @pymethod <o PyIEnum%(enumtype)s>|PyIEnum%(enumtype)s|Clone|Creates another enumerator that contains the same enumeration state as the current one
+PyObject *PyIEnum%(enumtype)s::Clone(PyObject *self, PyObject *args)
+{
+	if ( !PyArg_ParseTuple(args, ":Clone") )
+		return NULL;
+
+	IEnum%(enumtype)s *pIE%(enumtype)s = GetI(self);
+	if ( pIE%(enumtype)s == NULL )
+		return NULL;
+
+	IEnum%(enumtype)s *pClone;
+	PY_INTERFACE_PRECALL;
+	HRESULT hr = pIE%(enumtype)s->Clone(&pClone);
+	PY_INTERFACE_POSTCALL;
+	if ( FAILED(hr) )
+		return PyCom_BuildPyException(hr, pIE%(enumtype)s, IID_IE%(enumtype)s);
+
+	return PyCom_PyObjectFromIUnknown(pClone, IID_IEnum%(enumtype)s, FALSE);
+}
+
+// @object PyIEnum%(enumtype)s|A Python interface to IEnum%(enumtype)s
+static struct PyMethodDef PyIEnum%(enumtype)s_methods[] =
+{
+	{ "Next", PyIEnum%(enumtype)s::Next, 1 },    // @pymeth Next|Retrieves a specified number of items in the enumeration sequence.
+	{ "Skip", PyIEnum%(enumtype)s::Skip, 1 },	// @pymeth Skip|Skips over the next specified elementes.
+	{ "Reset", PyIEnum%(enumtype)s::Reset, 1 },	// @pymeth Reset|Resets the enumeration sequence to the beginning.
+	{ "Clone", PyIEnum%(enumtype)s::Clone, 1 },	// @pymeth Clone|Creates another enumerator that contains the same enumeration state as the current one.
+	{ NULL }
+};
+
+PyComEnumTypeObject PyIEnum%(enumtype)s::type("PyIEnum%(enumtype)s",
+		&PyIUnknown::type,
+		sizeof(PyIEnum%(enumtype)s),
+		PyIEnum%(enumtype)s_methods,
+		GET_PYCOM_CTOR(PyIEnum%(enumtype)s));
+"""
+        % locals()
+    )
+
+
+def _write_enumgw_cpp(f, interface):
+    enumtype = interface.name[5:]
+    if is_interface_enum(enumtype):
+        # Assume an interface.
+        enum_interface = "I" + enumtype[:-1]
+        converter = (
+            "if ( !PyCom_InterfaceFromPyObject(ob, IID_%(enum_interface)s, (void **)&rgVar[i], FALSE) )"
+            % locals()
+        )
+        argdeclare = "%(enum_interface)s __RPC_FAR * __RPC_FAR *rgVar" % locals()
+    else:
+        argdeclare = "%(enumtype)s __RPC_FAR *rgVar" % locals()
+        converter = "if ( !PyCom_PyObjectAs%(enumtype)s(ob, &rgVar[i]) )" % locals()
+    f.write(
+        """
+// ---------------------------------------------------
+//
+// Gateway Implementation
+
+// Std delegation
+STDMETHODIMP_(ULONG) PyGEnum%(enumtype)s::AddRef(void) {return PyGatewayBase::AddRef();}
+STDMETHODIMP_(ULONG) PyGEnum%(enumtype)s::Release(void) {return PyGatewayBase::Release();}
+STDMETHODIMP PyGEnum%(enumtype)s::QueryInterface(REFIID iid, void ** obj) {return PyGatewayBase::QueryInterface(iid, obj);}
+STDMETHODIMP PyGEnum%(enumtype)s::GetTypeInfoCount(UINT FAR* pctInfo) {return PyGatewayBase::GetTypeInfoCount(pctInfo);}
+STDMETHODIMP PyGEnum%(enumtype)s::GetTypeInfo(UINT itinfo, LCID lcid, ITypeInfo FAR* FAR* pptInfo) {return PyGatewayBase::GetTypeInfo(itinfo, lcid, pptInfo);}
+STDMETHODIMP PyGEnum%(enumtype)s::GetIDsOfNames(REFIID refiid, OLECHAR FAR* FAR* rgszNames, UINT cNames, LCID lcid, DISPID FAR* rgdispid) {return PyGatewayBase::GetIDsOfNames( refiid, rgszNames, cNames, lcid, rgdispid);}
+STDMETHODIMP PyGEnum%(enumtype)s::Invoke(DISPID dispid, REFIID riid, LCID lcid, WORD wFlags, DISPPARAMS FAR* params, VARIANT FAR* pVarResult, EXCEPINFO FAR* pexcepinfo, UINT FAR* puArgErr) {return PyGatewayBase::Invoke( dispid, riid, lcid, wFlags, params, pVarResult, pexcepinfo, puArgErr);}
+
+STDMETHODIMP PyGEnum%(enumtype)s::Next( 
+            /* [in] */ ULONG celt,
+            /* [length_is][size_is][out] */ %(argdeclare)s,
+            /* [out] */ ULONG __RPC_FAR *pCeltFetched)
+{
+	PY_GATEWAY_METHOD;
+	PyObject *result;
+	HRESULT hr = InvokeViaPolicy("Next", &result, "i", celt);
+	if ( FAILED(hr) )
+		return hr;
+
+	if ( !PySequence_Check(result) )
+		goto error;
+	int len;
+	len = PyObject_Length(result);
+	if ( len == -1 )
+		goto error;
+	if ( len > (int)celt)
+		len = celt;
+
+	if ( pCeltFetched )
+		*pCeltFetched = len;
+
+	int i;
+	for ( i = 0; i < len; ++i )
+	{
+		PyObject *ob = PySequence_GetItem(result, i);
+		if ( ob == NULL )
+			goto error;
+
+		%(converter)s
+		{
+			Py_DECREF(result);
+			return PyCom_SetCOMErrorFromPyException(IID_IEnum%(enumtype)s);
+		}
+	}
+
+	Py_DECREF(result);
+
+	return len < (int)celt ? S_FALSE : S_OK;
+
+  error:
+	PyErr_Clear();	// just in case
+	Py_DECREF(result);
+	return PyCom_HandleIEnumNoSequence(IID_IEnum%(enumtype)s);
+}
+
+STDMETHODIMP PyGEnum%(enumtype)s::Skip( 
+            /* [in] */ ULONG celt)
+{
+	PY_GATEWAY_METHOD;
+	return InvokeViaPolicy("Skip", NULL, "i", celt);
+}
+
+STDMETHODIMP PyGEnum%(enumtype)s::Reset(void)
+{
+	PY_GATEWAY_METHOD;
+	return InvokeViaPolicy("Reset");
+}
+
+STDMETHODIMP PyGEnum%(enumtype)s::Clone( 
+            /* [out] */ IEnum%(enumtype)s __RPC_FAR *__RPC_FAR *ppEnum)
+{
+	PY_GATEWAY_METHOD;
+	PyObject * result;
+	HRESULT hr = InvokeViaPolicy("Clone", &result);
+	if ( FAILED(hr) )
+		return hr;
+
+	/*
+	** Make sure we have the right kind of object: we should have some kind
+	** of IUnknown subclass wrapped into a PyIUnknown instance.
+	*/
+	if ( !PyIBase::is_object(result, &PyIUnknown::type) )
+	{
+		/* the wrong kind of object was returned to us */
+		Py_DECREF(result);
+		return PyCom_SetCOMErrorFromSimple(E_FAIL, IID_IEnum%(enumtype)s);
+	}
+
+	/*
+	** Get the IUnknown out of the thing. note that the Python ob maintains
+	** a reference, so we don't have to explicitly AddRef() here.
+	*/
+	IUnknown *punk = ((PyIUnknown *)result)->m_obj;
+	if ( !punk )
+	{
+		/* damn. the object was released. */
+		Py_DECREF(result);
+		return PyCom_SetCOMErrorFromSimple(E_FAIL, IID_IEnum%(enumtype)s);
+	}
+
+	/*
+	** Get the interface we want. note it is returned with a refcount.
+	** This QI is actually going to instantiate a PyGEnum%(enumtype)s.
+	*/
+	hr = punk->QueryInterface(IID_IEnum%(enumtype)s, (LPVOID *)ppEnum);
+
+	/* done with the result; this DECREF is also for <punk> */
+	Py_DECREF(result);
+
+	return PyCom_CheckIEnumNextResult(hr, IID_IEnum%(enumtype)s);
+}
+"""
+        % locals()
+    )
diff --git a/lib/win32com/makegw/makegwparse.py b/lib/win32com/makegw/makegwparse.py
new file mode 100644
index 00000000..59512f48
--- /dev/null
+++ b/lib/win32com/makegw/makegwparse.py
@@ -0,0 +1,1008 @@
+"""Utilities for makegw - Parse a header file to build an interface
+
+ This module contains the core code for parsing a header file describing a
+ COM interface, and building it into an "Interface" structure.
+
+ Each Interface has methods, and each method has arguments.
+
+ Each argument knows how to use Py_BuildValue or Py_ParseTuple to
+ exchange itself with Python.
+ 
+ See the @win32com.makegw@ module for information in building a COM
+ interface
+"""
+import re
+import traceback
+
+
+class error_not_found(Exception):
+    def __init__(self, msg="The requested item could not be found"):
+        super(error_not_found, self).__init__(msg)
+
+
+class error_not_supported(Exception):
+    def __init__(self, msg="The required functionality is not supported"):
+        super(error_not_supported, self).__init__(msg)
+
+
+VERBOSE = 0
+DEBUG = 0
+
+## NOTE : For interfaces as params to work correctly, you must
+## make sure any PythonCOM extensions which expose the interface are loaded
+## before generating.
+
+
+class ArgFormatter:
+    """An instance for a specific type of argument.	 Knows how to convert itself"""
+
+    def __init__(self, arg, builtinIndirection, declaredIndirection=0):
+        # print 'init:', arg.name, builtinIndirection, declaredIndirection, arg.indirectionLevel
+        self.arg = arg
+        self.builtinIndirection = builtinIndirection
+        self.declaredIndirection = declaredIndirection
+        self.gatewayMode = 0
+
+    def _IndirectPrefix(self, indirectionFrom, indirectionTo):
+        """Given the indirection level I was declared at (0=Normal, 1=*, 2=**)
+        return a string prefix so I can pass to a function with the
+        required indirection (where the default is the indirection of the method's param.
+
+        eg, assuming my arg has indirection level of 2, if this function was passed 1
+        it would return "&", so that a variable declared with indirection of 1
+        can be prefixed with this to turn it into the indirection level required of 2
+        """
+        dif = indirectionFrom - indirectionTo
+        if dif == 0:
+            return ""
+        elif dif == -1:
+            return "&"
+        elif dif == 1:
+            return "*"
+        else:
+            return "?? (%d)" % (dif,)
+            raise error_not_supported("Can't indirect this far - please fix me :-)")
+
+    def GetIndirectedArgName(self, indirectFrom, indirectionTo):
+        # print 'get:',self.arg.name, indirectFrom,self._GetDeclaredIndirection() + self.builtinIndirection, indirectionTo, self.arg.indirectionLevel
+
+        if indirectFrom is None:
+            ### ACK! this does not account for [in][out] variables.
+            ### when this method is called, we need to know which
+            indirectFrom = self._GetDeclaredIndirection() + self.builtinIndirection
+
+        return self._IndirectPrefix(indirectFrom, indirectionTo) + self.arg.name
+
+    def GetBuildValueArg(self):
+        "Get the argument to be passes to Py_BuildValue"
+        return self.arg.name
+
+    def GetParseTupleArg(self):
+        "Get the argument to be passed to PyArg_ParseTuple"
+        if self.gatewayMode:
+            # use whatever they were declared with
+            return self.GetIndirectedArgName(None, 1)
+        # local declarations have just their builtin indirection
+        return self.GetIndirectedArgName(self.builtinIndirection, 1)
+
+    def GetInterfaceCppObjectInfo(self):
+        """Provide information about the C++ object used.
+
+        Simple variables (such as integers) can declare their type (eg an integer)
+        and use it as the target of both PyArg_ParseTuple and the COM function itself.
+
+        More complex types require a PyObject * declared as the target of PyArg_ParseTuple,
+        then some conversion routine to the C++ object which is actually passed to COM.
+
+        This method provides the name, and optionally the type of that C++ variable.
+        If the type if provided, the caller will likely generate a variable declaration.
+        The name must always be returned.
+
+        Result is a tuple of (variableName, [DeclareType|None|""])
+        """
+
+        # the first return element is the variable to be passed as
+        # 	 an argument to an interface method. the variable was
+        # 	 declared with only its builtin indirection level. when
+        # 	 we pass it, we'll need to pass in whatever amount of
+        # 	 indirection was applied (plus the builtin amount)
+        # the second return element is the variable declaration; it
+        # 	 should simply be builtin indirection
+        return self.GetIndirectedArgName(
+            self.builtinIndirection, self.arg.indirectionLevel + self.builtinIndirection
+        ), "%s %s" % (self.GetUnconstType(), self.arg.name)
+
+    def GetInterfaceArgCleanup(self):
+        "Return cleanup code for C++ args passed to the interface method."
+        if DEBUG:
+            return "/* GetInterfaceArgCleanup output goes here: %s */\n" % self.arg.name
+        else:
+            return ""
+
+    def GetInterfaceArgCleanupGIL(self):
+        """Return cleanup code for C++ args passed to the interface
+        method that must be executed with the GIL held"""
+        if DEBUG:
+            return (
+                "/* GetInterfaceArgCleanup (GIL held) output goes here: %s */\n"
+                % self.arg.name
+            )
+        else:
+            return ""
+
+    def GetUnconstType(self):
+        return self.arg.unc_type
+
+    def SetGatewayMode(self):
+        self.gatewayMode = 1
+
+    def _GetDeclaredIndirection(self):
+        return self.arg.indirectionLevel
+        print("declared:", self.arg.name, self.gatewayMode)
+        if self.gatewayMode:
+            return self.arg.indirectionLevel
+        else:
+            return self.declaredIndirection
+
+    def DeclareParseArgTupleInputConverter(self):
+        "Declare the variable used as the PyArg_ParseTuple param for a gateway"
+        # Only declare it??
+        # if self.arg.indirectionLevel==0:
+        # 	return "\t%s %s;\n" % (self.arg.type, self.arg.name)
+        # else:
+        if DEBUG:
+            return (
+                "/* Declare ParseArgTupleInputConverter goes here: %s */\n"
+                % self.arg.name
+            )
+        else:
+            return ""
+
+    def GetParsePostCode(self):
+        "Get a string of C++ code to be executed after (ie, to finalise) the PyArg_ParseTuple conversion"
+        if DEBUG:
+            return "/* GetParsePostCode code goes here: %s */\n" % self.arg.name
+        else:
+            return ""
+
+    def GetBuildForInterfacePreCode(self):
+        "Get a string of C++ code to be executed before (ie, to initialise) the Py_BuildValue conversion for Interfaces"
+        if DEBUG:
+            return "/* GetBuildForInterfacePreCode goes here: %s */\n" % self.arg.name
+        else:
+            return ""
+
+    def GetBuildForGatewayPreCode(self):
+        "Get a string of C++ code to be executed before (ie, to initialise) the Py_BuildValue conversion for Gateways"
+        s = self.GetBuildForInterfacePreCode()  # Usually the same
+        if DEBUG:
+            if s[:4] == "/* G":
+                s = "/* GetBuildForGatewayPreCode goes here: %s */\n" % self.arg.name
+        return s
+
+    def GetBuildForInterfacePostCode(self):
+        "Get a string of C++ code to be executed after (ie, to finalise) the Py_BuildValue conversion for Interfaces"
+        if DEBUG:
+            return "/* GetBuildForInterfacePostCode goes here: %s */\n" % self.arg.name
+        return ""
+
+    def GetBuildForGatewayPostCode(self):
+        "Get a string of C++ code to be executed after (ie, to finalise) the Py_BuildValue conversion for Gateways"
+        s = self.GetBuildForInterfacePostCode()  # Usually the same
+        if DEBUG:
+            if s[:4] == "/* G":
+                s = "/* GetBuildForGatewayPostCode goes here: %s */\n" % self.arg.name
+        return s
+
+    def GetAutoduckString(self):
+        return "// @pyparm %s|%s||Description for %s" % (
+            self._GetPythonTypeDesc(),
+            self.arg.name,
+            self.arg.name,
+        )
+
+    def _GetPythonTypeDesc(self):
+        "Returns a string with the description of the type.	 Used for doco purposes"
+        return None
+
+    def NeedUSES_CONVERSION(self):
+        "Determines if this arg forces a USES_CONVERSION macro"
+        return 0
+
+
+# Special formatter for floats since they're smaller than Python floats.
+class ArgFormatterFloat(ArgFormatter):
+    def GetFormatChar(self):
+        return "f"
+
+    def DeclareParseArgTupleInputConverter(self):
+        # Declare a double variable
+        return "\tdouble dbl%s;\n" % self.arg.name
+
+    def GetParseTupleArg(self):
+        return "&dbl" + self.arg.name
+
+    def _GetPythonTypeDesc(self):
+        return "float"
+
+    def GetBuildValueArg(self):
+        return "&dbl" + self.arg.name
+
+    def GetBuildForInterfacePreCode(self):
+        return "\tdbl" + self.arg.name + " = " + self.arg.name + ";\n"
+
+    def GetBuildForGatewayPreCode(self):
+        return (
+            "\tdbl%s = " % self.arg.name
+            + self._IndirectPrefix(self._GetDeclaredIndirection(), 0)
+            + self.arg.name
+            + ";\n"
+        )
+
+    def GetParsePostCode(self):
+        s = "\t"
+        if self.gatewayMode:
+            s = s + self._IndirectPrefix(self._GetDeclaredIndirection(), 0)
+        s = s + self.arg.name
+        s = s + " = (float)dbl%s;\n" % self.arg.name
+        return s
+
+
+# Special formatter for Shorts because they're
+# a different size than Python ints!
+class ArgFormatterShort(ArgFormatter):
+    def GetFormatChar(self):
+        return "i"
+
+    def DeclareParseArgTupleInputConverter(self):
+        # Declare a double variable
+        return "\tINT i%s;\n" % self.arg.name
+
+    def GetParseTupleArg(self):
+        return "&i" + self.arg.name
+
+    def _GetPythonTypeDesc(self):
+        return "int"
+
+    def GetBuildValueArg(self):
+        return "&i" + self.arg.name
+
+    def GetBuildForInterfacePreCode(self):
+        return "\ti" + self.arg.name + " = " + self.arg.name + ";\n"
+
+    def GetBuildForGatewayPreCode(self):
+        return (
+            "\ti%s = " % self.arg.name
+            + self._IndirectPrefix(self._GetDeclaredIndirection(), 0)
+            + self.arg.name
+            + ";\n"
+        )
+
+    def GetParsePostCode(self):
+        s = "\t"
+        if self.gatewayMode:
+            s = s + self._IndirectPrefix(self._GetDeclaredIndirection(), 0)
+        s = s + self.arg.name
+        s = s + " = i%s;\n" % self.arg.name
+        return s
+
+
+# for types which are 64bits on AMD64 - eg, HWND
+class ArgFormatterLONG_PTR(ArgFormatter):
+    def GetFormatChar(self):
+        return "O"
+
+    def DeclareParseArgTupleInputConverter(self):
+        # Declare a PyObject variable
+        return "\tPyObject *ob%s;\n" % self.arg.name
+
+    def GetParseTupleArg(self):
+        return "&ob" + self.arg.name
+
+    def _GetPythonTypeDesc(self):
+        return "int/long"
+
+    def GetBuildValueArg(self):
+        return "ob" + self.arg.name
+
+    def GetBuildForInterfacePostCode(self):
+        return "\tPy_XDECREF(ob%s);\n" % self.arg.name
+
+    def GetParsePostCode(self):
+        return (
+            "\tif (bPythonIsHappy && !PyWinLong_AsULONG_PTR(ob%s, (ULONG_PTR *)%s)) bPythonIsHappy = FALSE;\n"
+            % (self.arg.name, self.GetIndirectedArgName(None, 2))
+        )
+
+    def GetBuildForInterfacePreCode(self):
+        notdirected = self.GetIndirectedArgName(None, 1)
+        return "\tob%s = PyWinObject_FromULONG_PTR(%s);\n" % (
+            self.arg.name,
+            notdirected,
+        )
+
+    def GetBuildForGatewayPostCode(self):
+        return "\tPy_XDECREF(ob%s);\n" % self.arg.name
+
+
+class ArgFormatterPythonCOM(ArgFormatter):
+    """An arg formatter for types exposed in the PythonCOM module"""
+
+    def GetFormatChar(self):
+        return "O"
+
+    # def GetInterfaceCppObjectInfo(self):
+    # 	return ArgFormatter.GetInterfaceCppObjectInfo(self)[0], \
+    # 		"%s %s%s" % (self.arg.unc_type, "*" * self._GetDeclaredIndirection(), self.arg.name)
+    def DeclareParseArgTupleInputConverter(self):
+        # Declare a PyObject variable
+        return "\tPyObject *ob%s;\n" % self.arg.name
+
+    def GetParseTupleArg(self):
+        return "&ob" + self.arg.name
+
+    def _GetPythonTypeDesc(self):
+        return "<o Py%s>" % self.arg.type
+
+    def GetBuildValueArg(self):
+        return "ob" + self.arg.name
+
+    def GetBuildForInterfacePostCode(self):
+        return "\tPy_XDECREF(ob%s);\n" % self.arg.name
+
+
+class ArgFormatterBSTR(ArgFormatterPythonCOM):
+    def _GetPythonTypeDesc(self):
+        return "<o unicode>"
+
+    def GetParsePostCode(self):
+        return (
+            "\tif (bPythonIsHappy && !PyWinObject_AsBstr(ob%s, %s)) bPythonIsHappy = FALSE;\n"
+            % (self.arg.name, self.GetIndirectedArgName(None, 2))
+        )
+
+    def GetBuildForInterfacePreCode(self):
+        notdirected = self.GetIndirectedArgName(None, 1)
+        return "\tob%s = MakeBstrToObj(%s);\n" % (self.arg.name, notdirected)
+
+    def GetBuildForInterfacePostCode(self):
+        return "\tSysFreeString(%s);\n" % (
+            self.arg.name,
+        ) + ArgFormatterPythonCOM.GetBuildForInterfacePostCode(self)
+
+    def GetBuildForGatewayPostCode(self):
+        return "\tPy_XDECREF(ob%s);\n" % self.arg.name
+
+
+class ArgFormatterOLECHAR(ArgFormatterPythonCOM):
+    def _GetPythonTypeDesc(self):
+        return "<o unicode>"
+
+    def GetUnconstType(self):
+        if self.arg.type[:3] == "LPC":
+            return self.arg.type[:2] + self.arg.type[3:]
+        else:
+            return self.arg.unc_type
+
+    def GetParsePostCode(self):
+        return (
+            "\tif (bPythonIsHappy && !PyWinObject_AsBstr(ob%s, %s)) bPythonIsHappy = FALSE;\n"
+            % (self.arg.name, self.GetIndirectedArgName(None, 2))
+        )
+
+    def GetInterfaceArgCleanup(self):
+        return "\tSysFreeString(%s);\n" % self.GetIndirectedArgName(None, 1)
+
+    def GetBuildForInterfacePreCode(self):
+        # the variable was declared with just its builtin indirection
+        notdirected = self.GetIndirectedArgName(self.builtinIndirection, 1)
+        return "\tob%s = MakeOLECHARToObj(%s);\n" % (self.arg.name, notdirected)
+
+    def GetBuildForInterfacePostCode(self):
+        # memory returned into an OLECHAR should be freed
+        return "\tCoTaskMemFree(%s);\n" % (
+            self.arg.name,
+        ) + ArgFormatterPythonCOM.GetBuildForInterfacePostCode(self)
+
+    def GetBuildForGatewayPostCode(self):
+        return "\tPy_XDECREF(ob%s);\n" % self.arg.name
+
+
+class ArgFormatterTCHAR(ArgFormatterPythonCOM):
+    def _GetPythonTypeDesc(self):
+        return "string/<o unicode>"
+
+    def GetUnconstType(self):
+        if self.arg.type[:3] == "LPC":
+            return self.arg.type[:2] + self.arg.type[3:]
+        else:
+            return self.arg.unc_type
+
+    def GetParsePostCode(self):
+        return (
+            "\tif (bPythonIsHappy && !PyWinObject_AsTCHAR(ob%s, %s)) bPythonIsHappy = FALSE;\n"
+            % (self.arg.name, self.GetIndirectedArgName(None, 2))
+        )
+
+    def GetInterfaceArgCleanup(self):
+        return "\tPyWinObject_FreeTCHAR(%s);\n" % self.GetIndirectedArgName(None, 1)
+
+    def GetBuildForInterfacePreCode(self):
+        # the variable was declared with just its builtin indirection
+        notdirected = self.GetIndirectedArgName(self.builtinIndirection, 1)
+        return "\tob%s = PyWinObject_FromTCHAR(%s);\n" % (self.arg.name, notdirected)
+
+    def GetBuildForInterfacePostCode(self):
+        return "// ??? - TCHAR post code\n"
+
+    def GetBuildForGatewayPostCode(self):
+        return "\tPy_XDECREF(ob%s);\n" % self.arg.name
+
+
+class ArgFormatterIID(ArgFormatterPythonCOM):
+    def _GetPythonTypeDesc(self):
+        return "<o PyIID>"
+
+    def GetParsePostCode(self):
+        return "\tif (!PyWinObject_AsIID(ob%s, &%s)) bPythonIsHappy = FALSE;\n" % (
+            self.arg.name,
+            self.arg.name,
+        )
+
+    def GetBuildForInterfacePreCode(self):
+        # 		notdirected = self.GetIndirectedArgName(self.arg.indirectionLevel, 0)
+        notdirected = self.GetIndirectedArgName(None, 0)
+        return "\tob%s = PyWinObject_FromIID(%s);\n" % (self.arg.name, notdirected)
+
+    def GetInterfaceCppObjectInfo(self):
+        return self.arg.name, "IID %s" % (self.arg.name)
+
+
+class ArgFormatterTime(ArgFormatterPythonCOM):
+    def __init__(self, arg, builtinIndirection, declaredIndirection=0):
+        # we don't want to declare LPSYSTEMTIME / LPFILETIME objects
+        if arg.indirectionLevel == 0 and arg.unc_type[:2] == "LP":
+            arg.unc_type = arg.unc_type[2:]
+            # reduce the builtin and increment the declaration
+            arg.indirectionLevel = arg.indirectionLevel + 1
+            builtinIndirection = 0
+        ArgFormatterPythonCOM.__init__(
+            self, arg, builtinIndirection, declaredIndirection
+        )
+
+    def _GetPythonTypeDesc(self):
+        return "<o PyDateTime>"
+
+    def GetParsePostCode(self):
+        # variable was declared with only the builtinIndirection
+        ### NOTE: this is an [in] ... so use only builtin
+        return (
+            '\tif (!PyTime_Check(ob%s)) {\n\t\tPyErr_SetString(PyExc_TypeError, "The argument must be a PyTime object");\n\t\tbPythonIsHappy = FALSE;\n\t}\n\tif (!((PyTime *)ob%s)->GetTime(%s)) bPythonIsHappy = FALSE;\n'
+            % (
+                self.arg.name,
+                self.arg.name,
+                self.GetIndirectedArgName(self.builtinIndirection, 1),
+            )
+        )
+
+    def GetBuildForInterfacePreCode(self):
+        ### use just the builtinIndirection again...
+        notdirected = self.GetIndirectedArgName(self.builtinIndirection, 0)
+        return "\tob%s = new PyTime(%s);\n" % (self.arg.name, notdirected)
+
+    def GetBuildForInterfacePostCode(self):
+        ### hack to determine if we need to free stuff
+        ret = ""
+        if self.builtinIndirection + self.arg.indirectionLevel > 1:
+            # memory returned into an OLECHAR should be freed
+            ret = "\tCoTaskMemFree(%s);\n" % self.arg.name
+        return ret + ArgFormatterPythonCOM.GetBuildForInterfacePostCode(self)
+
+
+class ArgFormatterSTATSTG(ArgFormatterPythonCOM):
+    def _GetPythonTypeDesc(self):
+        return "<o STATSTG>"
+
+    def GetParsePostCode(self):
+        return (
+            "\tif (!PyCom_PyObjectAsSTATSTG(ob%s, %s, 0/*flags*/)) bPythonIsHappy = FALSE;\n"
+            % (self.arg.name, self.GetIndirectedArgName(None, 1))
+        )
+
+    def GetBuildForInterfacePreCode(self):
+        notdirected = self.GetIndirectedArgName(None, 1)
+        return (
+            "\tob%s = PyCom_PyObjectFromSTATSTG(%s);\n\t// STATSTG doco says our responsibility to free\n\tif ((%s).pwcsName) CoTaskMemFree((%s).pwcsName);\n"
+            % (
+                self.arg.name,
+                self.GetIndirectedArgName(None, 1),
+                notdirected,
+                notdirected,
+            )
+        )
+
+
+class ArgFormatterGeneric(ArgFormatterPythonCOM):
+    def _GetPythonTypeDesc(self):
+        return "<o %s>" % self.arg.type
+
+    def GetParsePostCode(self):
+        return "\tif (!PyObject_As%s(ob%s, &%s) bPythonIsHappy = FALSE;\n" % (
+            self.arg.type,
+            self.arg.name,
+            self.GetIndirectedArgName(None, 1),
+        )
+
+    def GetInterfaceArgCleanup(self):
+        return "\tPyObject_Free%s(%s);\n" % (self.arg.type, self.arg.name)
+
+    def GetBuildForInterfacePreCode(self):
+        notdirected = self.GetIndirectedArgName(None, 1)
+        return "\tob%s = PyObject_From%s(%s);\n" % (
+            self.arg.name,
+            self.arg.type,
+            self.GetIndirectedArgName(None, 1),
+        )
+
+
+class ArgFormatterIDLIST(ArgFormatterPythonCOM):
+    def _GetPythonTypeDesc(self):
+        return "<o PyIDL>"
+
+    def GetParsePostCode(self):
+        return (
+            "\tif (bPythonIsHappy && !PyObject_AsPIDL(ob%s, &%s)) bPythonIsHappy = FALSE;\n"
+            % (self.arg.name, self.GetIndirectedArgName(None, 1))
+        )
+
+    def GetInterfaceArgCleanup(self):
+        return "\tPyObject_FreePIDL(%s);\n" % (self.arg.name,)
+
+    def GetBuildForInterfacePreCode(self):
+        notdirected = self.GetIndirectedArgName(None, 1)
+        return "\tob%s = PyObject_FromPIDL(%s);\n" % (
+            self.arg.name,
+            self.GetIndirectedArgName(None, 1),
+        )
+
+
+class ArgFormatterHANDLE(ArgFormatterPythonCOM):
+    def _GetPythonTypeDesc(self):
+        return "<o PyHANDLE>"
+
+    def GetParsePostCode(self):
+        return (
+            "\tif (!PyWinObject_AsHANDLE(ob%s, &%s, FALSE) bPythonIsHappy = FALSE;\n"
+            % (self.arg.name, self.GetIndirectedArgName(None, 1))
+        )
+
+    def GetBuildForInterfacePreCode(self):
+        notdirected = self.GetIndirectedArgName(None, 1)
+        return "\tob%s = PyWinObject_FromHANDLE(%s);\n" % (
+            self.arg.name,
+            self.GetIndirectedArgName(None, 0),
+        )
+
+
+class ArgFormatterLARGE_INTEGER(ArgFormatterPythonCOM):
+    def GetKeyName(self):
+        return "LARGE_INTEGER"
+
+    def _GetPythonTypeDesc(self):
+        return "<o %s>" % self.GetKeyName()
+
+    def GetParsePostCode(self):
+        return "\tif (!PyWinObject_As%s(ob%s, %s)) bPythonIsHappy = FALSE;\n" % (
+            self.GetKeyName(),
+            self.arg.name,
+            self.GetIndirectedArgName(None, 1),
+        )
+
+    def GetBuildForInterfacePreCode(self):
+        notdirected = self.GetIndirectedArgName(None, 0)
+        return "\tob%s = PyWinObject_From%s(%s);\n" % (
+            self.arg.name,
+            self.GetKeyName(),
+            notdirected,
+        )
+
+
+class ArgFormatterULARGE_INTEGER(ArgFormatterLARGE_INTEGER):
+    def GetKeyName(self):
+        return "ULARGE_INTEGER"
+
+
+class ArgFormatterInterface(ArgFormatterPythonCOM):
+    def GetInterfaceCppObjectInfo(self):
+        return self.GetIndirectedArgName(1, self.arg.indirectionLevel), "%s * %s" % (
+            self.GetUnconstType(),
+            self.arg.name,
+        )
+
+    def GetParsePostCode(self):
+        # This gets called for out params in gateway mode
+        if self.gatewayMode:
+            sArg = self.GetIndirectedArgName(None, 2)
+        else:
+            # vs. in params for interface mode.
+            sArg = self.GetIndirectedArgName(1, 2)
+        return (
+            "\tif (bPythonIsHappy && !PyCom_InterfaceFromPyInstanceOrObject(ob%s, IID_%s, (void **)%s, TRUE /* bNoneOK */))\n\t\t bPythonIsHappy = FALSE;\n"
+            % (self.arg.name, self.arg.type, sArg)
+        )
+
+    def GetBuildForInterfacePreCode(self):
+        return "\tob%s = PyCom_PyObjectFromIUnknown(%s, IID_%s, FALSE);\n" % (
+            self.arg.name,
+            self.arg.name,
+            self.arg.type,
+        )
+
+    def GetBuildForGatewayPreCode(self):
+        sPrefix = self._IndirectPrefix(self._GetDeclaredIndirection(), 1)
+        return "\tob%s = PyCom_PyObjectFromIUnknown(%s%s, IID_%s, TRUE);\n" % (
+            self.arg.name,
+            sPrefix,
+            self.arg.name,
+            self.arg.type,
+        )
+
+    def GetInterfaceArgCleanup(self):
+        return "\tif (%s) %s->Release();\n" % (self.arg.name, self.arg.name)
+
+
+class ArgFormatterVARIANT(ArgFormatterPythonCOM):
+    def GetParsePostCode(self):
+        return (
+            "\tif ( !PyCom_VariantFromPyObject(ob%s, %s) )\n\t\tbPythonIsHappy = FALSE;\n"
+            % (self.arg.name, self.GetIndirectedArgName(None, 1))
+        )
+
+    def GetBuildForGatewayPreCode(self):
+        notdirected = self.GetIndirectedArgName(None, 1)
+        return "\tob%s = PyCom_PyObjectFromVariant(%s);\n" % (
+            self.arg.name,
+            notdirected,
+        )
+
+    def GetBuildForGatewayPostCode(self):
+        return "\tPy_XDECREF(ob%s);\n" % self.arg.name
+
+        # Key :		, Python Type Description, ParseTuple format char
+
+
+ConvertSimpleTypes = {
+    "BOOL": ("BOOL", "int", "i"),
+    "UINT": ("UINT", "int", "i"),
+    "BYTE": ("BYTE", "int", "i"),
+    "INT": ("INT", "int", "i"),
+    "DWORD": ("DWORD", "int", "l"),
+    "HRESULT": ("HRESULT", "int", "l"),
+    "ULONG": ("ULONG", "int", "l"),
+    "LONG": ("LONG", "int", "l"),
+    "int": ("int", "int", "i"),
+    "long": ("long", "int", "l"),
+    "DISPID": ("DISPID", "long", "l"),
+    "APPBREAKFLAGS": ("int", "int", "i"),
+    "BREAKRESUMEACTION": ("int", "int", "i"),
+    "ERRORRESUMEACTION": ("int", "int", "i"),
+    "BREAKREASON": ("int", "int", "i"),
+    "BREAKPOINT_STATE": ("int", "int", "i"),
+    "BREAKRESUME_ACTION": ("int", "int", "i"),
+    "SOURCE_TEXT_ATTR": ("int", "int", "i"),
+    "TEXT_DOC_ATTR": ("int", "int", "i"),
+    "QUERYOPTION": ("int", "int", "i"),
+    "PARSEACTION": ("int", "int", "i"),
+}
+
+
+class ArgFormatterSimple(ArgFormatter):
+    """An arg formatter for simple integer etc types"""
+
+    def GetFormatChar(self):
+        return ConvertSimpleTypes[self.arg.type][2]
+
+    def _GetPythonTypeDesc(self):
+        return ConvertSimpleTypes[self.arg.type][1]
+
+
+AllConverters = {
+    "const OLECHAR": (ArgFormatterOLECHAR, 0, 1),
+    "WCHAR": (ArgFormatterOLECHAR, 0, 1),
+    "OLECHAR": (ArgFormatterOLECHAR, 0, 1),
+    "LPCOLESTR": (ArgFormatterOLECHAR, 1, 1),
+    "LPOLESTR": (ArgFormatterOLECHAR, 1, 1),
+    "LPCWSTR": (ArgFormatterOLECHAR, 1, 1),
+    "LPWSTR": (ArgFormatterOLECHAR, 1, 1),
+    "LPCSTR": (ArgFormatterOLECHAR, 1, 1),
+    "LPTSTR": (ArgFormatterTCHAR, 1, 1),
+    "LPCTSTR": (ArgFormatterTCHAR, 1, 1),
+    "HANDLE": (ArgFormatterHANDLE, 0),
+    "BSTR": (ArgFormatterBSTR, 1, 0),
+    "const IID": (ArgFormatterIID, 0),
+    "CLSID": (ArgFormatterIID, 0),
+    "IID": (ArgFormatterIID, 0),
+    "GUID": (ArgFormatterIID, 0),
+    "const GUID": (ArgFormatterIID, 0),
+    "const IID": (ArgFormatterIID, 0),
+    "REFCLSID": (ArgFormatterIID, 0),
+    "REFIID": (ArgFormatterIID, 0),
+    "REFGUID": (ArgFormatterIID, 0),
+    "const FILETIME": (ArgFormatterTime, 0),
+    "const SYSTEMTIME": (ArgFormatterTime, 0),
+    "const LPSYSTEMTIME": (ArgFormatterTime, 1, 1),
+    "LPSYSTEMTIME": (ArgFormatterTime, 1, 1),
+    "FILETIME": (ArgFormatterTime, 0),
+    "SYSTEMTIME": (ArgFormatterTime, 0),
+    "STATSTG": (ArgFormatterSTATSTG, 0),
+    "LARGE_INTEGER": (ArgFormatterLARGE_INTEGER, 0),
+    "ULARGE_INTEGER": (ArgFormatterULARGE_INTEGER, 0),
+    "VARIANT": (ArgFormatterVARIANT, 0),
+    "float": (ArgFormatterFloat, 0),
+    "single": (ArgFormatterFloat, 0),
+    "short": (ArgFormatterShort, 0),
+    "WORD": (ArgFormatterShort, 0),
+    "VARIANT_BOOL": (ArgFormatterShort, 0),
+    "HWND": (ArgFormatterLONG_PTR, 1),
+    "HMENU": (ArgFormatterLONG_PTR, 1),
+    "HOLEMENU": (ArgFormatterLONG_PTR, 1),
+    "HICON": (ArgFormatterLONG_PTR, 1),
+    "HDC": (ArgFormatterLONG_PTR, 1),
+    "LPARAM": (ArgFormatterLONG_PTR, 1),
+    "WPARAM": (ArgFormatterLONG_PTR, 1),
+    "LRESULT": (ArgFormatterLONG_PTR, 1),
+    "UINT": (ArgFormatterShort, 0),
+    "SVSIF": (ArgFormatterShort, 0),
+    "Control": (ArgFormatterInterface, 0, 1),
+    "DataObject": (ArgFormatterInterface, 0, 1),
+    "_PropertyBag": (ArgFormatterInterface, 0, 1),
+    "AsyncProp": (ArgFormatterInterface, 0, 1),
+    "DataSource": (ArgFormatterInterface, 0, 1),
+    "DataFormat": (ArgFormatterInterface, 0, 1),
+    "void **": (ArgFormatterInterface, 2, 2),
+    "ITEMIDLIST": (ArgFormatterIDLIST, 0, 0),
+    "LPITEMIDLIST": (ArgFormatterIDLIST, 0, 1),
+    "LPCITEMIDLIST": (ArgFormatterIDLIST, 0, 1),
+    "const ITEMIDLIST": (ArgFormatterIDLIST, 0, 1),
+}
+
+# Auto-add all the simple types
+for key in ConvertSimpleTypes.keys():
+    AllConverters[key] = ArgFormatterSimple, 0
+
+
+def make_arg_converter(arg):
+    try:
+        clz = AllConverters[arg.type][0]
+        bin = AllConverters[arg.type][1]
+        decl = 0
+        if len(AllConverters[arg.type]) > 2:
+            decl = AllConverters[arg.type][2]
+        return clz(arg, bin, decl)
+    except KeyError:
+        if arg.type[0] == "I":
+            return ArgFormatterInterface(arg, 0, 1)
+
+        raise error_not_supported(
+            "The type '%s' (%s) is unknown." % (arg.type, arg.name)
+        )
+
+
+#############################################################
+#
+# The instances that represent the args, methods and interface
+class Argument:
+    """A representation of an argument to a COM method
+
+    This class contains information about a specific argument to a method.
+    In addition, methods exist so that an argument knows how to convert itself
+    to/from Python arguments.
+    """
+
+    # 									  in,out					  type			  name			 [	]
+    # 								   --------------				--------	  ------------		------
+    regex = re.compile(r"/\* \[([^\]]*.*?)] \*/[ \t](.*[* ]+)(\w+)(\[ *])?[\),]")
+
+    def __init__(self, good_interface_names):
+        self.good_interface_names = good_interface_names
+        self.inout = self.name = self.type = None
+        self.const = 0
+        self.arrayDecl = 0
+
+    def BuildFromFile(self, file):
+        """Parse and build my data from a file
+
+        Reads the next line in the file, and matches it as an argument
+        description.  If not a valid argument line, an error_not_found exception
+        is raised.
+        """
+        line = file.readline()
+        mo = self.regex.search(line)
+        if not mo:
+            raise error_not_found
+        self.name = mo.group(3)
+        self.inout = mo.group(1).split("][")
+        typ = mo.group(2).strip()
+        self.raw_type = typ
+        self.indirectionLevel = 0
+        if mo.group(4):  # Has "[ ]" decl
+            self.arrayDecl = 1
+            try:
+                pos = typ.rindex("__RPC_FAR")
+                self.indirectionLevel = self.indirectionLevel + 1
+                typ = typ[:pos].strip()
+            except ValueError:
+                pass
+
+        typ = typ.replace("__RPC_FAR", "")
+        while 1:
+            try:
+                pos = typ.rindex("*")
+                self.indirectionLevel = self.indirectionLevel + 1
+                typ = typ[:pos].strip()
+            except ValueError:
+                break
+        self.type = typ
+        if self.type[:6] == "const ":
+            self.unc_type = self.type[6:]
+        else:
+            self.unc_type = self.type
+
+        if VERBOSE:
+            print(
+                "	   Arg %s of type %s%s (%s)"
+                % (self.name, self.type, "*" * self.indirectionLevel, self.inout)
+            )
+
+    def HasAttribute(self, typ):
+        """Determines if the argument has the specific attribute.
+
+        Argument attributes are specified in the header file, such as
+        "[in][out][retval]" etc.  You can pass a specific string (eg "out")
+        to find if this attribute was specified for the argument
+        """
+        return typ in self.inout
+
+    def GetRawDeclaration(self):
+        ret = "%s %s" % (self.raw_type, self.name)
+        if self.arrayDecl:
+            ret = ret + "[]"
+        return ret
+
+
+class Method:
+    """A representation of a C++ method on a COM interface
+
+    This class contains information about a specific method, as well as
+    a list of all @Argument@s
+    """
+
+    # 										 options	 ret type callconv	 name
+    # 								   ----------------- -------- -------- --------
+    regex = re.compile(r"virtual (/\*.*?\*/ )?(.*?) (.*?) (.*?)\(\w?")
+
+    def __init__(self, good_interface_names):
+        self.good_interface_names = good_interface_names
+        self.name = self.result = self.callconv = None
+        self.args = []
+
+    def BuildFromFile(self, file):
+        """Parse and build my data from a file
+
+        Reads the next line in the file, and matches it as a method
+        description.  If not a valid method line, an error_not_found exception
+        is raised.
+        """
+        line = file.readline()
+        mo = self.regex.search(line)
+        if not mo:
+            raise error_not_found
+        self.name = mo.group(4)
+        self.result = mo.group(2)
+        if self.result != "HRESULT":
+            if self.result == "DWORD":  # DWORD is for old old stuff?
+                print(
+                    "Warning: Old style interface detected - compilation errors likely!"
+                )
+            else:
+                print(
+                    "Method %s - Only HRESULT return types are supported." % self.name
+                )
+            # 				raise error_not_supported,		if VERBOSE:
+            print("	 Method %s %s(" % (self.result, self.name))
+        while 1:
+            arg = Argument(self.good_interface_names)
+            try:
+                arg.BuildFromFile(file)
+                self.args.append(arg)
+            except error_not_found:
+                break
+
+
+class Interface:
+    """A representation of a C++ COM Interface
+
+    This class contains information about a specific interface, as well as
+    a list of all @Method@s
+    """
+
+    # 									  name				 base
+    # 									 --------		   --------
+    regex = re.compile("(interface|) ([^ ]*) : public (.*)$")
+
+    def __init__(self, mo):
+        self.methods = []
+        self.name = mo.group(2)
+        self.base = mo.group(3)
+        if VERBOSE:
+            print("Interface %s : public %s" % (self.name, self.base))
+
+    def BuildMethods(self, file):
+        """Build all sub-methods for this interface"""
+        # skip the next 2 lines.
+        file.readline()
+        file.readline()
+        while 1:
+            try:
+                method = Method([self.name])
+                method.BuildFromFile(file)
+                self.methods.append(method)
+            except error_not_found:
+                break
+
+
+def find_interface(interfaceName, file):
+    """Find and return an interface in a file
+
+    Given an interface name and file, search for the specified interface.
+
+    Upon return, the interface itself has been built,
+    but not the methods.
+    """
+    interface = None
+    line = file.readline()
+    while line:
+        mo = Interface.regex.search(line)
+        if mo:
+            name = mo.group(2)
+            print(name)
+            AllConverters[name] = (ArgFormatterInterface, 0, 1)
+            if name == interfaceName:
+                interface = Interface(mo)
+                interface.BuildMethods(file)
+        line = file.readline()
+    if interface:
+        return interface
+    raise error_not_found
+
+
+def parse_interface_info(interfaceName, file):
+    """Find, parse and return an interface in a file
+
+    Given an interface name and file, search for the specified interface.
+
+    Upon return, the interface itself is fully built,
+    """
+    try:
+        return find_interface(interfaceName, file)
+    except re.error:
+        traceback.print_exc()
+        print("The interface could not be built, as the regular expression failed!")
+
+
+def test():
+    f = open("d:\\msdev\\include\\objidl.h")
+    try:
+        parse_interface_info("IPersistStream", f)
+    finally:
+        f.close()
+
+
+def test_regex(r, text):
+    res = r.search(text, 0)
+    if res == -1:
+        print("** Not found")
+    else:
+        print(
+            "%d\n%s\n%s\n%s\n%s" % (res, r.group(1), r.group(2), r.group(3), r.group(4))
+        )
diff --git a/lib/win32com/olectl.py b/lib/win32com/olectl.py
new file mode 100644
index 00000000..50ec6f74
--- /dev/null
+++ b/lib/win32com/olectl.py
@@ -0,0 +1,70 @@
+"""Constants used by COM Controls
+
+  Hand created version of OLECTL.H constants.
+"""
+
+import winerror
+
+FACILITY_CONTROL = 0xA
+
+
+def MAKE_SCODE(sev, fac, code):
+    return int((int(-sev) << 31) | ((fac) << 16) | ((code)))
+
+
+def STD_CTL_SCODE(n):
+    return MAKE_SCODE(winerror.SEVERITY_ERROR, FACILITY_CONTROL, n)
+
+
+CTL_E_ILLEGALFUNCTIONCALL = STD_CTL_SCODE(5)
+CTL_E_OVERFLOW = STD_CTL_SCODE(6)
+CTL_E_OUTOFMEMORY = STD_CTL_SCODE(7)
+CTL_E_DIVISIONBYZERO = STD_CTL_SCODE(11)
+CTL_E_OUTOFSTRINGSPACE = STD_CTL_SCODE(14)
+CTL_E_OUTOFSTACKSPACE = STD_CTL_SCODE(28)
+CTL_E_BADFILENAMEORNUMBER = STD_CTL_SCODE(52)
+CTL_E_FILENOTFOUND = STD_CTL_SCODE(53)
+CTL_E_BADFILEMODE = STD_CTL_SCODE(54)
+CTL_E_FILEALREADYOPEN = STD_CTL_SCODE(55)
+CTL_E_DEVICEIOERROR = STD_CTL_SCODE(57)
+CTL_E_FILEALREADYEXISTS = STD_CTL_SCODE(58)
+CTL_E_BADRECORDLENGTH = STD_CTL_SCODE(59)
+CTL_E_DISKFULL = STD_CTL_SCODE(61)
+CTL_E_BADRECORDNUMBER = STD_CTL_SCODE(63)
+CTL_E_BADFILENAME = STD_CTL_SCODE(64)
+CTL_E_TOOMANYFILES = STD_CTL_SCODE(67)
+CTL_E_DEVICEUNAVAILABLE = STD_CTL_SCODE(68)
+CTL_E_PERMISSIONDENIED = STD_CTL_SCODE(70)
+CTL_E_DISKNOTREADY = STD_CTL_SCODE(71)
+CTL_E_PATHFILEACCESSERROR = STD_CTL_SCODE(75)
+CTL_E_PATHNOTFOUND = STD_CTL_SCODE(76)
+CTL_E_INVALIDPATTERNSTRING = STD_CTL_SCODE(93)
+CTL_E_INVALIDUSEOFNULL = STD_CTL_SCODE(94)
+CTL_E_INVALIDFILEFORMAT = STD_CTL_SCODE(321)
+CTL_E_INVALIDPROPERTYVALUE = STD_CTL_SCODE(380)
+CTL_E_INVALIDPROPERTYARRAYINDEX = STD_CTL_SCODE(381)
+CTL_E_SETNOTSUPPORTEDATRUNTIME = STD_CTL_SCODE(382)
+CTL_E_SETNOTSUPPORTED = STD_CTL_SCODE(383)
+CTL_E_NEEDPROPERTYARRAYINDEX = STD_CTL_SCODE(385)
+CTL_E_SETNOTPERMITTED = STD_CTL_SCODE(387)
+CTL_E_GETNOTSUPPORTEDATRUNTIME = STD_CTL_SCODE(393)
+CTL_E_GETNOTSUPPORTED = STD_CTL_SCODE(394)
+CTL_E_PROPERTYNOTFOUND = STD_CTL_SCODE(422)
+CTL_E_INVALIDCLIPBOARDFORMAT = STD_CTL_SCODE(460)
+CTL_E_INVALIDPICTURE = STD_CTL_SCODE(481)
+CTL_E_PRINTERERROR = STD_CTL_SCODE(482)
+CTL_E_CANTSAVEFILETOTEMP = STD_CTL_SCODE(735)
+CTL_E_SEARCHTEXTNOTFOUND = STD_CTL_SCODE(744)
+CTL_E_REPLACEMENTSTOOLONG = STD_CTL_SCODE(746)
+
+CONNECT_E_FIRST = MAKE_SCODE(winerror.SEVERITY_ERROR, winerror.FACILITY_ITF, 0x0200)
+CONNECT_E_LAST = MAKE_SCODE(winerror.SEVERITY_ERROR, winerror.FACILITY_ITF, 0x020F)
+CONNECT_S_FIRST = MAKE_SCODE(winerror.SEVERITY_SUCCESS, winerror.FACILITY_ITF, 0x0200)
+CONNECT_S_LAST = MAKE_SCODE(winerror.SEVERITY_SUCCESS, winerror.FACILITY_ITF, 0x020F)
+
+CONNECT_E_NOCONNECTION = CONNECT_E_FIRST + 0
+CONNECT_E_ADVISELIMIT = CONNECT_E_FIRST + 1
+CONNECT_E_CANNOTCONNECT = CONNECT_E_FIRST + 2
+CONNECT_E_OVERRIDDEN = CONNECT_E_FIRST + 3
+
+CLASS_E_NOTLICENSED = winerror.CLASSFACTORY_E_FIRST + 2
diff --git a/lib/win32com/readme.html b/lib/win32com/readme.html
new file mode 100644
index 00000000..3df75340
--- /dev/null
+++ b/lib/win32com/readme.html
@@ -0,0 +1,87 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <title>win32com Readme</title>
+</head>
+<body>
+ 
+<p><img width="551" height="99" id="_x0000_i1025"
+ src="html%5Cimage%5Cpycom_blowing.gif"
+ alt="Python and COM - Blowing the others away"> </p>
+    
+<h1>Python COM Extensions Readme </h1>
+    
+<p>This is the readme for win32com. Please check out the <a
+ href="html/docindex.html">win32com documentation index</a></p>
+    
+<p>The <a href="test/.">win32com/test directory</a> contains some interesting
+ scripts (and a new <a href="test/readme.txt">readme.txt</a>). Although these
+ are used for testing, they do show a variety of COM techniques.</p>
+
+<h3>VARIANT objects</h3>
+<p>win32com.client now has explicit VARIANT objects which can be used in
+situations where you need more control over the argument types passed when
+calling COM methods.  See the <a href="html/variant.html">documentation on
+this object</a>
+
+<a name="currency"><h3>Important Currency changes</h3></a>
+<p>
+In all builds prior to 204, a COM currency value was returned as a tuple of
+integers.  Working with 2 integers to represent a currency object was a poor
+choice, but the alternative was never clear.  Now Python ships with the
+<a href="http://www.python.org/dev/doc/devel/lib/module-decimal.html">decimal</a>
+module, the alternative has arrived!
+</p>
+<p>
+Up until build 212, code could set <code>pythoncom.__future_currency__ = True</code>
+to force use of the decimal module, with a warning issued otherwise.  In 
+builds 213 and later, the decimal module is unconditionally used when
+pythoncon returns you a currency value.
+</p>
+
+<h3>Recent Changes</h3>
+
+<h4>Lots of internal changes on the road to py3k</h4>
+
+<h4>win32com.axcontrol and win2con.internet</h4>
+Many more interfaces for hosting AX controls and the interfaces
+used by Internet Explorer.
+
+<h4>win32com.shell</h4>
+The shell interfaces have undergone a number of enhancements and changes.
+A couple of methods have changed signature between the first build with shell support (200) and later builds.  
+SHGetFileInfo was broken in its result handling, so had to be changed - this 
+is the only function used by the samples that changed, but others not used by the samples also have changed.
+These shell interfaces are now generally stable.
+<h4>New win32com.taskscheduler module</h4>
+Roger Upole has contributed an interface to the Windows task scheduler.  This is actually very neat, and it allows
+Python to edit the task list as shown by Windows Control Panel.  Property page suppport may even appear later,
+now that the win32 library has the new win32rcparser module.
+<h4>ActiveX Scripting </h4>
+    
+<p>Python only supports "trusted" execution hosts - thus, it will no longer work
+as an engine inside IE (Python itself no longer has a restricted execution environment).  
+Python continues to work fine as an Active Scripting Engine in all other
+applications, including Windows Scripting Host, and ASP.
+
+<p>There is also support for Python as an ActiveX Scripting Host.</p>
+    
+<p>Active Debugging seems to be fully functional.</p>
+
+<h4>Older stuff</h4>
+<ul>
+</li>
+  <li>Unexpected exceptions in Python COM objects will generally now dump
+the exception and traceback to stdout. &nbsp;This is useful for debugging
+and testing - it means that in some cases there will be no need to register
+an object with <span style="font-style: italic;">--debug</span> to see these
+tracebacks. &nbsp;Note that COM objects used by server processes (such as
+ASP) generally have no valid stdout, so will still need to use <span
+ style="font-style: italic;">--debug</span> as usual.<br>
+  </li>
+   <li>universal gateway support has been improved - we can now work as an
+Outlook Addin<br>
+  </li>
+  
+</body>
+</html>
diff --git a/lib/win32com/server/__init__.py b/lib/win32com/server/__init__.py
new file mode 100644
index 00000000..3348fc9f
--- /dev/null
+++ b/lib/win32com/server/__init__.py
@@ -0,0 +1 @@
+# Empty __init__ file to designate a sub-package.
diff --git a/lib/win32com/server/connect.py b/lib/win32com/server/connect.py
new file mode 100644
index 00000000..5c9a2dfe
--- /dev/null
+++ b/lib/win32com/server/connect.py
@@ -0,0 +1,84 @@
+"""Utilities for Server Side connections.
+
+  A collection of helpers for server side connection points.
+"""
+import pythoncom
+import win32com.server.util
+import winerror
+from win32com import olectl
+
+from .exception import Exception
+
+# Methods implemented by the interfaces.
+IConnectionPointContainer_methods = ["EnumConnectionPoints", "FindConnectionPoint"]
+IConnectionPoint_methods = [
+    "EnumConnections",
+    "Unadvise",
+    "Advise",
+    "GetConnectionPointContainer",
+    "GetConnectionInterface",
+]
+
+
+class ConnectableServer:
+    _public_methods_ = IConnectionPointContainer_methods + IConnectionPoint_methods
+    _com_interfaces_ = [
+        pythoncom.IID_IConnectionPoint,
+        pythoncom.IID_IConnectionPointContainer,
+    ]
+
+    # Clients must set _connect_interfaces_ = [...]
+    def __init__(self):
+        self.cookieNo = 0
+        self.connections = {}
+
+    # IConnectionPoint interfaces
+    def EnumConnections(self):
+        raise Exception(winerror.E_NOTIMPL)
+
+    def GetConnectionInterface(self):
+        raise Exception(winerror.E_NOTIMPL)
+
+    def GetConnectionPointContainer(self):
+        return win32com.server.util.wrap(self)
+
+    def Advise(self, pUnk):
+        # Creates a connection to the client.  Simply allocate a new cookie,
+        # find the clients interface, and store it in a dictionary.
+        try:
+            interface = pUnk.QueryInterface(
+                self._connect_interfaces_[0], pythoncom.IID_IDispatch
+            )
+        except pythoncom.com_error:
+            raise Exception(scode=olectl.CONNECT_E_NOCONNECTION)
+        self.cookieNo = self.cookieNo + 1
+        self.connections[self.cookieNo] = interface
+        return self.cookieNo
+
+    def Unadvise(self, cookie):
+        # Destroy a connection - simply delete interface from the map.
+        try:
+            del self.connections[cookie]
+        except KeyError:
+            raise Exception(scode=winerror.E_UNEXPECTED)
+
+    # IConnectionPointContainer interfaces
+    def EnumConnectionPoints(self):
+        raise Exception(winerror.E_NOTIMPL)
+
+    def FindConnectionPoint(self, iid):
+        # Find a connection we support.  Only support the single event interface.
+        if iid in self._connect_interfaces_:
+            return win32com.server.util.wrap(self)
+
+    def _BroadcastNotify(self, broadcaster, extraArgs):
+        # Broadcasts a notification to all connections.
+        # Ignores clients that fail.
+        for interface in self.connections.values():
+            try:
+                broadcaster(*(interface,) + extraArgs)
+            except pythoncom.com_error as details:
+                self._OnNotifyFail(interface, details)
+
+    def _OnNotifyFail(self, interface, details):
+        print("Ignoring COM error to connection - %s" % (repr(details)))
diff --git a/lib/win32com/server/dispatcher.py b/lib/win32com/server/dispatcher.py
new file mode 100644
index 00000000..ac983125
--- /dev/null
+++ b/lib/win32com/server/dispatcher.py
@@ -0,0 +1,291 @@
+"""Dispatcher
+
+Please see policy.py for a discussion on dispatchers and policies
+"""
+import traceback
+from sys import exc_info
+
+import pythoncom
+import win32api
+import win32com
+
+#
+from win32com.server.exception import IsCOMServerException
+from win32com.util import IIDToInterfaceName
+
+
+class DispatcherBase:
+    """The base class for all Dispatchers.
+
+    This dispatcher supports wrapping all operations in exception handlers,
+    and all the necessary delegation to the policy.
+
+    This base class supports the printing of "unexpected" exceptions.  Note, however,
+    that exactly where the output of print goes may not be useful!  A derived class may
+    provide additional semantics for this.
+    """
+
+    def __init__(self, policyClass, object):
+        self.policy = policyClass(object)
+        # The logger we should dump to.  If None, we should send to the
+        # default location (typically 'print')
+        self.logger = getattr(win32com, "logger", None)
+
+    # Note the "return self._HandleException_()" is purely to stop pychecker
+    # complaining - _HandleException_ will itself raise an exception for the
+    # pythoncom framework, so the result will never be seen.
+    def _CreateInstance_(self, clsid, reqIID):
+        try:
+            self.policy._CreateInstance_(clsid, reqIID)
+            return pythoncom.WrapObject(self, reqIID)
+        except:
+            return self._HandleException_()
+
+    def _QueryInterface_(self, iid):
+        try:
+            return self.policy._QueryInterface_(iid)
+        except:
+            return self._HandleException_()
+
+    def _Invoke_(self, dispid, lcid, wFlags, args):
+        try:
+            return self.policy._Invoke_(dispid, lcid, wFlags, args)
+        except:
+            return self._HandleException_()
+
+    def _GetIDsOfNames_(self, names, lcid):
+        try:
+            return self.policy._GetIDsOfNames_(names, lcid)
+        except:
+            return self._HandleException_()
+
+    def _GetTypeInfo_(self, index, lcid):
+        try:
+            return self.policy._GetTypeInfo_(index, lcid)
+        except:
+            return self._HandleException_()
+
+    def _GetTypeInfoCount_(self):
+        try:
+            return self.policy._GetTypeInfoCount_()
+        except:
+            return self._HandleException_()
+
+    def _GetDispID_(self, name, fdex):
+        try:
+            return self.policy._GetDispID_(name, fdex)
+        except:
+            return self._HandleException_()
+
+    def _InvokeEx_(self, dispid, lcid, wFlags, args, kwargs, serviceProvider):
+        try:
+            return self.policy._InvokeEx_(
+                dispid, lcid, wFlags, args, kwargs, serviceProvider
+            )
+        except:
+            return self._HandleException_()
+
+    def _DeleteMemberByName_(self, name, fdex):
+        try:
+            return self.policy._DeleteMemberByName_(name, fdex)
+        except:
+            return self._HandleException_()
+
+    def _DeleteMemberByDispID_(self, id):
+        try:
+            return self.policy._DeleteMemberByDispID_(id)
+        except:
+            return self._HandleException_()
+
+    def _GetMemberProperties_(self, id, fdex):
+        try:
+            return self.policy._GetMemberProperties_(id, fdex)
+        except:
+            return self._HandleException_()
+
+    def _GetMemberName_(self, dispid):
+        try:
+            return self.policy._GetMemberName_(dispid)
+        except:
+            return self._HandleException_()
+
+    def _GetNextDispID_(self, fdex, flags):
+        try:
+            return self.policy._GetNextDispID_(fdex, flags)
+        except:
+            return self._HandleException_()
+
+    def _GetNameSpaceParent_(self):
+        try:
+            return self.policy._GetNameSpaceParent_()
+        except:
+            return self._HandleException_()
+
+    def _HandleException_(self):
+        """Called whenever an exception is raised.
+
+        Default behaviour is to print the exception.
+        """
+        # If not a COM exception, print it for the developer.
+        if not IsCOMServerException():
+            if self.logger is not None:
+                self.logger.exception("pythoncom server error")
+            else:
+                traceback.print_exc()
+        # But still raise it for the framework.
+        raise
+
+    def _trace_(self, *args):
+        if self.logger is not None:
+            record = " ".join(map(str, args))
+            self.logger.debug(record)
+        else:
+            for arg in args[:-1]:
+                print(arg, end=" ")
+            print(args[-1])
+
+
+class DispatcherTrace(DispatcherBase):
+    """A dispatcher, which causes a 'print' line for each COM function called."""
+
+    def _QueryInterface_(self, iid):
+        rc = DispatcherBase._QueryInterface_(self, iid)
+        if not rc:
+            self._trace_(
+                "in %s._QueryInterface_ with unsupported IID %s (%s)"
+                % (repr(self.policy._obj_), IIDToInterfaceName(iid), iid)
+            )
+        return rc
+
+    def _GetIDsOfNames_(self, names, lcid):
+        self._trace_("in _GetIDsOfNames_ with '%s' and '%d'\n" % (names, lcid))
+        return DispatcherBase._GetIDsOfNames_(self, names, lcid)
+
+    def _GetTypeInfo_(self, index, lcid):
+        self._trace_("in _GetTypeInfo_ with index=%d, lcid=%d\n" % (index, lcid))
+        return DispatcherBase._GetTypeInfo_(self, index, lcid)
+
+    def _GetTypeInfoCount_(self):
+        self._trace_("in _GetTypeInfoCount_\n")
+        return DispatcherBase._GetTypeInfoCount_(self)
+
+    def _Invoke_(self, dispid, lcid, wFlags, args):
+        self._trace_("in _Invoke_ with", dispid, lcid, wFlags, args)
+        return DispatcherBase._Invoke_(self, dispid, lcid, wFlags, args)
+
+    def _GetDispID_(self, name, fdex):
+        self._trace_("in _GetDispID_ with", name, fdex)
+        return DispatcherBase._GetDispID_(self, name, fdex)
+
+    def _InvokeEx_(self, dispid, lcid, wFlags, args, kwargs, serviceProvider):
+        self._trace_(
+            "in %r._InvokeEx_-%s%r [%x,%s,%r]"
+            % (self.policy._obj_, dispid, args, wFlags, lcid, serviceProvider)
+        )
+        return DispatcherBase._InvokeEx_(
+            self, dispid, lcid, wFlags, args, kwargs, serviceProvider
+        )
+
+    def _DeleteMemberByName_(self, name, fdex):
+        self._trace_("in _DeleteMemberByName_ with", name, fdex)
+        return DispatcherBase._DeleteMemberByName_(self, name, fdex)
+
+    def _DeleteMemberByDispID_(self, id):
+        self._trace_("in _DeleteMemberByDispID_ with", id)
+        return DispatcherBase._DeleteMemberByDispID_(self, id)
+
+    def _GetMemberProperties_(self, id, fdex):
+        self._trace_("in _GetMemberProperties_ with", id, fdex)
+        return DispatcherBase._GetMemberProperties_(self, id, fdex)
+
+    def _GetMemberName_(self, dispid):
+        self._trace_("in _GetMemberName_ with", dispid)
+        return DispatcherBase._GetMemberName_(self, dispid)
+
+    def _GetNextDispID_(self, fdex, flags):
+        self._trace_("in _GetNextDispID_ with", fdex, flags)
+        return DispatcherBase._GetNextDispID_(self, fdex, flags)
+
+    def _GetNameSpaceParent_(self):
+        self._trace_("in _GetNameSpaceParent_")
+        return DispatcherBase._GetNameSpaceParent_(self)
+
+
+class DispatcherWin32trace(DispatcherTrace):
+    """A tracing dispatcher that sends its output to the win32trace remote collector."""
+
+    def __init__(self, policyClass, object):
+        DispatcherTrace.__init__(self, policyClass, object)
+        if self.logger is None:
+            # If we have no logger, setup our output.
+            import win32traceutil  # Sets up everything.
+        self._trace_(
+            "Object with win32trace dispatcher created (object=%s)" % repr(object)
+        )
+
+
+class DispatcherOutputDebugString(DispatcherTrace):
+    """A tracing dispatcher that sends its output to win32api.OutputDebugString"""
+
+    def _trace_(self, *args):
+        for arg in args[:-1]:
+            win32api.OutputDebugString(str(arg) + " ")
+        win32api.OutputDebugString(str(args[-1]) + "\n")
+
+
+class DispatcherWin32dbg(DispatcherBase):
+    """A source-level debugger dispatcher
+
+    A dispatcher which invokes the debugger as an object is instantiated, or
+    when an unexpected exception occurs.
+
+    Requires Pythonwin.
+    """
+
+    def __init__(self, policyClass, ob):
+        # No one uses this, and it just causes py2exe to drag all of
+        # pythonwin in.
+        # import pywin.debugger
+        pywin.debugger.brk()
+        print("The DispatcherWin32dbg dispatcher is deprecated!")
+        print("Please let me know if this is a problem.")
+        print("Uncomment the relevant lines in dispatcher.py to re-enable")
+        # DEBUGGER Note - You can either:
+        # * Hit Run and wait for a (non Exception class) exception to occur!
+        # * Set a breakpoint and hit run.
+        # * Step into the object creation (a few steps away!)
+        DispatcherBase.__init__(self, policyClass, ob)
+
+    def _HandleException_(self):
+        """Invoke the debugger post mortem capability"""
+        # Save details away.
+        typ, val, tb = exc_info()
+        # import pywin.debugger, pywin.debugger.dbgcon
+        debug = 0
+        try:
+            raise typ(val)
+        except Exception:  # AARG - What is this Exception???
+            # Use some inside knowledge to borrow a Debugger option which dictates if we
+            # stop at "expected" exceptions.
+            debug = pywin.debugger.GetDebugger().get_option(
+                pywin.debugger.dbgcon.OPT_STOP_EXCEPTIONS
+            )
+        except:
+            debug = 1
+        if debug:
+            try:
+                pywin.debugger.post_mortem(tb, typ, val)  # The original exception
+            except:
+                traceback.print_exc()
+
+        # But still raise it.
+        del tb
+        raise
+
+
+try:
+    import win32trace
+
+    DefaultDebugDispatcher = DispatcherWin32trace
+except ImportError:  # no win32trace module - just use a print based one.
+    DefaultDebugDispatcher = DispatcherTrace
diff --git a/lib/win32com/server/exception.py b/lib/win32com/server/exception.py
new file mode 100644
index 00000000..e7f4d080
--- /dev/null
+++ b/lib/win32com/server/exception.py
@@ -0,0 +1,105 @@
+"""Exception Handling
+
+ Exceptions
+
+	 To better support COM exceptions, the framework allows for an instance to be
+	 raised.  This instance may have a certain number of known attributes, which are
+	 translated into COM exception details.
+	
+	 This means, for example, that Python could raise a COM exception that includes details
+	 on a Help file and location, and a description for the user.
+	
+	 This module provides a class which provides the necessary attributes.
+
+"""
+import sys
+
+import pythoncom
+
+
+# Note that we derive from com_error, which derives from exceptions.Exception
+# Also note that we dont support "self.args", as we dont support tuple-unpacking
+class COMException(pythoncom.com_error):
+    """An Exception object that is understood by the framework.
+
+    If the framework is presented with an exception of type class,
+    it looks for certain known attributes on this class to provide rich
+    error information to the caller.
+
+    It should be noted that the framework supports providing this error
+    information via COM Exceptions, or via the ISupportErrorInfo interface.
+
+    By using this class, you automatically provide rich error information to the
+    server.
+    """
+
+    def __init__(
+        self,
+        description=None,
+        scode=None,
+        source=None,
+        helpfile=None,
+        helpContext=None,
+        desc=None,
+        hresult=None,
+    ):
+        """Initialize an exception
+        **Params**
+
+        description -- A string description for the exception.
+        scode -- An integer scode to be returned to the server, if necessary.
+        The pythoncom framework defaults this to be DISP_E_EXCEPTION if not specified otherwise.
+        source -- A string which identifies the source of the error.
+        helpfile -- A string which points to a help file which contains details on the error.
+        helpContext -- An integer context in the help file.
+        desc -- A short-cut for description.
+        hresult -- A short-cut for scode.
+        """
+
+        # convert a WIN32 error into an HRESULT
+        scode = scode or hresult
+        if scode and scode != 1:  # We dont want S_FALSE mapped!
+            if scode >= -32768 and scode < 32768:
+                # this is HRESULT_FROM_WIN32()
+                scode = -2147024896 | (scode & 0x0000FFFF)
+        self.scode = scode
+
+        self.description = description or desc
+        if scode == 1 and not self.description:
+            self.description = "S_FALSE"
+        elif scode and not self.description:
+            self.description = pythoncom.GetScodeString(scode)
+
+        self.source = source
+        self.helpfile = helpfile
+        self.helpcontext = helpContext
+
+        # todo - fill in the exception value
+        pythoncom.com_error.__init__(self, scode, self.description, None, -1)
+
+    def __repr__(self):
+        return "<COM Exception - scode=%s, desc=%s>" % (self.scode, self.description)
+
+
+# Old name for the COMException class.
+# Do NOT use the name Exception, as it is now a built-in
+# COMException is the new, official name.
+Exception = COMException
+
+
+def IsCOMException(t=None):
+    if t is None:
+        t = sys.exc_info()[0]
+    try:
+        return issubclass(t, pythoncom.com_error)
+    except TypeError:  # 1.5 in -X mode?
+        return t is pythoncon.com_error
+
+
+def IsCOMServerException(t=None):
+    if t is None:
+        t = sys.exc_info()[0]
+    try:
+        return issubclass(t, COMException)
+    except TypeError:  # String exception
+        return 0
diff --git a/lib/win32com/server/factory.py b/lib/win32com/server/factory.py
new file mode 100644
index 00000000..7298f799
--- /dev/null
+++ b/lib/win32com/server/factory.py
@@ -0,0 +1,26 @@
+# Class factory utilities.
+import pythoncom
+
+
+def RegisterClassFactories(clsids, flags=None, clsctx=None):
+    """Given a list of CLSID, create and register class factories.
+
+    Returns a list, which should be passed to RevokeClassFactories
+    """
+    if flags is None:
+        flags = pythoncom.REGCLS_MULTIPLEUSE | pythoncom.REGCLS_SUSPENDED
+    if clsctx is None:
+        clsctx = pythoncom.CLSCTX_LOCAL_SERVER
+    ret = []
+    for clsid in clsids:
+        # Some server append '-Embedding' etc
+        if clsid[0] not in ["-", "/"]:
+            factory = pythoncom.MakePyFactory(clsid)
+            regId = pythoncom.CoRegisterClassObject(clsid, factory, clsctx, flags)
+            ret.append((factory, regId))
+    return ret
+
+
+def RevokeClassFactories(infos):
+    for factory, revokeId in infos:
+        pythoncom.CoRevokeClassObject(revokeId)
diff --git a/lib/win32com/server/localserver.py b/lib/win32com/server/localserver.py
new file mode 100644
index 00000000..21eeafeb
--- /dev/null
+++ b/lib/win32com/server/localserver.py
@@ -0,0 +1,53 @@
+# LocalServer .EXE support for Python.
+#
+# This is designed to be used as a _script_ file by pythonw.exe
+#
+# In some cases, you could also use Python.exe, which will create
+# a console window useful for debugging.
+#
+# NOTE: When NOT running in any sort of debugging mode,
+# 'print' statements may fail, as sys.stdout is not valid!!!
+
+#
+# Usage:
+#  wpython.exe LocalServer.py clsid [, clsid]
+import sys
+
+sys.coinit_flags = 2
+import pythoncom
+import win32api
+from win32com.server import factory
+
+usage = """\
+Invalid command line arguments
+
+This program provides LocalServer COM support
+for Python COM objects.
+
+It is typically run automatically by COM, passing as arguments
+The ProgID or CLSID of the Python Server(s) to be hosted
+"""
+
+
+def serve(clsids):
+    infos = factory.RegisterClassFactories(clsids)
+
+    pythoncom.EnableQuitMessage(win32api.GetCurrentThreadId())
+    pythoncom.CoResumeClassObjects()
+
+    pythoncom.PumpMessages()
+
+    factory.RevokeClassFactories(infos)
+
+    pythoncom.CoUninitialize()
+
+
+def main():
+    if len(sys.argv) == 1:
+        win32api.MessageBox(0, usage, "Python COM Server")
+        sys.exit(1)
+    serve(sys.argv[1:])
+
+
+if __name__ == "__main__":
+    main()
diff --git a/lib/win32com/server/policy.py b/lib/win32com/server/policy.py
new file mode 100644
index 00000000..8105e180
--- /dev/null
+++ b/lib/win32com/server/policy.py
@@ -0,0 +1,829 @@
+"""Policies 
+
+Note that Dispatchers are now implemented in "dispatcher.py", but
+are still documented here.
+
+Policies
+
+ A policy is an object which manages the interaction between a public 
+ Python object, and COM .  In simple terms, the policy object is the 
+ object which is actually called by COM, and it invokes the requested 
+ method, fetches/sets the requested property, etc.  See the 
+ @win32com.server.policy.CreateInstance@ method for a description of
+ how a policy is specified or created.
+
+ Exactly how a policy determines which underlying object method/property 
+ is obtained is up to the policy.  A few policies are provided, but you 
+ can build your own.  See each policy class for a description of how it 
+ implements its policy.
+
+ There is a policy that allows the object to specify exactly which 
+ methods and properties will be exposed.  There is also a policy that 
+ will dynamically expose all Python methods and properties - even those 
+ added after the object has been instantiated.
+
+Dispatchers
+
+ A Dispatcher is a level in front of a Policy.  A dispatcher is the 
+ thing which actually receives the COM calls, and passes them to the 
+ policy object (which in turn somehow does something with the wrapped 
+ object).
+
+ It is important to note that a policy does not need to have a dispatcher.
+ A dispatcher has the same interface as a policy, and simply steps in its 
+ place, delegating to the real policy.  The primary use for a Dispatcher 
+ is to support debugging when necessary, but without imposing overheads 
+ when not (ie, by not using a dispatcher at all).
+
+ There are a few dispatchers provided - "tracing" dispatchers which simply 
+ prints calls and args (including a variation which uses 
+ win32api.OutputDebugString), and a "debugger" dispatcher, which can 
+ invoke the debugger when necessary.
+
+Error Handling
+
+ It is important to realise that the caller of these interfaces may
+ not be Python.  Therefore, general Python exceptions and tracebacks aren't 
+ much use.
+
+ In general, there is an Exception class that should be raised, to allow 
+ the framework to extract rich COM type error information.
+
+ The general rule is that the **only** exception returned from Python COM 
+ Server code should be an Exception instance.  Any other Python exception 
+ should be considered an implementation bug in the server (if not, it 
+ should be handled, and an appropriate Exception instance raised).  Any 
+ other exception is considered "unexpected", and a dispatcher may take 
+ special action (see Dispatchers above)
+
+ Occasionally, the implementation will raise the policy.error error.  
+ This usually means there is a problem in the implementation that the 
+ Python programmer should fix.
+
+ For example, if policy is asked to wrap an object which it can not 
+ support (because, eg, it does not provide _public_methods_ or _dynamic_) 
+ then policy.error will be raised, indicating it is a Python programmers 
+ problem, rather than a COM error.
+ 
+"""
+__author__ = "Greg Stein and Mark Hammond"
+
+import sys
+import types
+
+import pythoncom
+import pywintypes
+import win32api
+import win32con
+import winerror
+
+# Import a few important constants to speed lookups.
+from pythoncom import (
+    DISPATCH_METHOD,
+    DISPATCH_PROPERTYGET,
+    DISPATCH_PROPERTYPUT,
+    DISPATCH_PROPERTYPUTREF,
+    DISPID_COLLECT,
+    DISPID_CONSTRUCTOR,
+    DISPID_DESTRUCTOR,
+    DISPID_EVALUATE,
+    DISPID_NEWENUM,
+    DISPID_PROPERTYPUT,
+    DISPID_STARTENUM,
+    DISPID_UNKNOWN,
+    DISPID_VALUE,
+)
+
+S_OK = 0
+
+# Few more globals to speed things.
+IDispatchType = pythoncom.TypeIIDs[pythoncom.IID_IDispatch]
+IUnknownType = pythoncom.TypeIIDs[pythoncom.IID_IUnknown]
+
+from .exception import COMException
+
+error = __name__ + " error"
+
+regSpec = "CLSID\\%s\\PythonCOM"
+regPolicy = "CLSID\\%s\\PythonCOMPolicy"
+regDispatcher = "CLSID\\%s\\PythonCOMDispatcher"
+regAddnPath = "CLSID\\%s\\PythonCOMPath"
+
+
+def CreateInstance(clsid, reqIID):
+    """Create a new instance of the specified IID
+
+    The COM framework **always** calls this function to create a new
+    instance for the specified CLSID.  This function looks up the
+    registry for the name of a policy, creates the policy, and asks the
+    policy to create the specified object by calling the _CreateInstance_ method.
+
+    Exactly how the policy creates the instance is up to the policy.  See the
+    specific policy documentation for more details.
+    """
+    # First see is sys.path should have something on it.
+    try:
+        addnPaths = win32api.RegQueryValue(
+            win32con.HKEY_CLASSES_ROOT, regAddnPath % clsid
+        ).split(";")
+        for newPath in addnPaths:
+            if newPath not in sys.path:
+                sys.path.insert(0, newPath)
+    except win32api.error:
+        pass
+    try:
+        policy = win32api.RegQueryValue(win32con.HKEY_CLASSES_ROOT, regPolicy % clsid)
+        policy = resolve_func(policy)
+    except win32api.error:
+        policy = DefaultPolicy
+
+    try:
+        dispatcher = win32api.RegQueryValue(
+            win32con.HKEY_CLASSES_ROOT, regDispatcher % clsid
+        )
+        if dispatcher:
+            dispatcher = resolve_func(dispatcher)
+    except win32api.error:
+        dispatcher = None
+
+    if dispatcher:
+        retObj = dispatcher(policy, None)
+    else:
+        retObj = policy(None)
+    return retObj._CreateInstance_(clsid, reqIID)
+
+
+class BasicWrapPolicy:
+    """The base class of policies.
+
+    Normally not used directly (use a child class, instead)
+
+    This policy assumes we are wrapping another object
+    as the COM server.  This supports the delegation of the core COM entry points
+    to either the wrapped object, or to a child class.
+
+    This policy supports the following special attributes on the wrapped object
+
+    _query_interface_ -- A handler which can respond to the COM 'QueryInterface' call.
+    _com_interfaces_ -- An optional list of IIDs which the interface will assume are
+        valid for the object.
+    _invoke_ -- A handler which can respond to the COM 'Invoke' call.  If this attribute
+        is not provided, then the default policy implementation is used.  If this attribute
+        does exist, it is responsible for providing all required functionality - ie, the
+        policy _invoke_ method is not invoked at all (and nor are you able to call it!)
+    _getidsofnames_ -- A handler which can respond to the COM 'GetIDsOfNames' call.  If this attribute
+        is not provided, then the default policy implementation is used.  If this attribute
+        does exist, it is responsible for providing all required functionality - ie, the
+        policy _getidsofnames_ method is not invoked at all (and nor are you able to call it!)
+
+    IDispatchEx functionality:
+
+    _invokeex_ -- Very similar to _invoke_, except slightly different arguments are used.
+        And the result is just the _real_ result (rather than the (hresult, argErr, realResult)
+        tuple that _invoke_ uses.
+        This is the new, prefered handler (the default _invoke_ handler simply called _invokeex_)
+    _getdispid_ -- Very similar to _getidsofnames_, except slightly different arguments are used,
+        and only 1 property at a time can be fetched (which is all we support in getidsofnames anyway!)
+        This is the new, prefered handler (the default _invoke_ handler simply called _invokeex_)
+    _getnextdispid_- uses self._name_to_dispid_ to enumerate the DISPIDs
+    """
+
+    def __init__(self, object):
+        """Initialise the policy object
+
+        Params:
+
+        object -- The object to wrap.  May be None *iff* @BasicWrapPolicy._CreateInstance_@ will be
+        called immediately after this to setup a brand new object
+        """
+        if object is not None:
+            self._wrap_(object)
+
+    def _CreateInstance_(self, clsid, reqIID):
+        """Creates a new instance of a **wrapped** object
+
+        This method looks up a "@win32com.server.policy.regSpec@" % clsid entry
+        in the registry (using @DefaultPolicy@)
+        """
+        try:
+            classSpec = win32api.RegQueryValue(
+                win32con.HKEY_CLASSES_ROOT, regSpec % clsid
+            )
+        except win32api.error:
+            raise error(
+                "The object is not correctly registered - %s key can not be read"
+                % (regSpec % clsid)
+            )
+        myob = call_func(classSpec)
+        self._wrap_(myob)
+        try:
+            return pythoncom.WrapObject(self, reqIID)
+        except pythoncom.com_error as xxx_todo_changeme:
+            (hr, desc, exc, arg) = xxx_todo_changeme.args
+            from win32com.util import IIDToInterfaceName
+
+            desc = (
+                "The object '%r' was created, but does not support the "
+                "interface '%s'(%s): %s"
+                % (myob, IIDToInterfaceName(reqIID), reqIID, desc)
+            )
+            raise pythoncom.com_error(hr, desc, exc, arg)
+
+    def _wrap_(self, object):
+        """Wraps up the specified object.
+
+        This function keeps a reference to the passed
+        object, and may interogate it to determine how to respond to COM requests, etc.
+        """
+        # We "clobber" certain of our own methods with ones
+        # provided by the wrapped object, iff they exist.
+        self._name_to_dispid_ = {}
+        ob = self._obj_ = object
+        if hasattr(ob, "_query_interface_"):
+            self._query_interface_ = ob._query_interface_
+
+        if hasattr(ob, "_invoke_"):
+            self._invoke_ = ob._invoke_
+
+        if hasattr(ob, "_invokeex_"):
+            self._invokeex_ = ob._invokeex_
+
+        if hasattr(ob, "_getidsofnames_"):
+            self._getidsofnames_ = ob._getidsofnames_
+
+        if hasattr(ob, "_getdispid_"):
+            self._getdispid_ = ob._getdispid_
+
+        # Allow for override of certain special attributes.
+        if hasattr(ob, "_com_interfaces_"):
+            self._com_interfaces_ = []
+            # Allow interfaces to be specified by name.
+            for i in ob._com_interfaces_:
+                if type(i) != pywintypes.IIDType:
+                    # Prolly a string!
+                    if i[0] != "{":
+                        i = pythoncom.InterfaceNames[i]
+                    else:
+                        i = pythoncom.MakeIID(i)
+                self._com_interfaces_.append(i)
+        else:
+            self._com_interfaces_ = []
+
+    # "QueryInterface" handling.
+    def _QueryInterface_(self, iid):
+        """The main COM entry-point for QueryInterface.
+
+        This checks the _com_interfaces_ attribute and if the interface is not specified
+        there, it calls the derived helper _query_interface_
+        """
+        if iid in self._com_interfaces_:
+            return 1
+        return self._query_interface_(iid)
+
+    def _query_interface_(self, iid):
+        """Called if the object does not provide the requested interface in _com_interfaces_,
+        and does not provide a _query_interface_ handler.
+
+        Returns a result to the COM framework indicating the interface is not supported.
+        """
+        return 0
+
+    # "Invoke" handling.
+    def _Invoke_(self, dispid, lcid, wFlags, args):
+        """The main COM entry-point for Invoke.
+
+        This calls the _invoke_ helper.
+        """
+        # Translate a possible string dispid to real dispid.
+        if type(dispid) == type(""):
+            try:
+                dispid = self._name_to_dispid_[dispid.lower()]
+            except KeyError:
+                raise COMException(
+                    scode=winerror.DISP_E_MEMBERNOTFOUND, desc="Member not found"
+                )
+        return self._invoke_(dispid, lcid, wFlags, args)
+
+    def _invoke_(self, dispid, lcid, wFlags, args):
+        # Delegates to the _invokeex_ implementation.  This allows
+        # a custom policy to define _invokeex_, and automatically get _invoke_ too.
+        return S_OK, -1, self._invokeex_(dispid, lcid, wFlags, args, None, None)
+
+    # "GetIDsOfNames" handling.
+    def _GetIDsOfNames_(self, names, lcid):
+        """The main COM entry-point for GetIDsOfNames.
+
+        This checks the validity of the arguments, and calls the _getidsofnames_ helper.
+        """
+        if len(names) > 1:
+            raise COMException(
+                scode=winerror.DISP_E_INVALID,
+                desc="Cannot support member argument names",
+            )
+        return self._getidsofnames_(names, lcid)
+
+    def _getidsofnames_(self, names, lcid):
+        ### note: lcid is being ignored...
+        return (self._getdispid_(names[0], 0),)
+
+    # IDispatchEx support for policies.  Most of the IDispathEx functionality
+    # by default will raise E_NOTIMPL.  Thus it is not necessary for derived
+    # policies to explicitely implement all this functionality just to not implement it!
+
+    def _GetDispID_(self, name, fdex):
+        return self._getdispid_(name, fdex)
+
+    def _getdispid_(self, name, fdex):
+        try:
+            ### TODO - look at the fdex flags!!!
+            return self._name_to_dispid_[name.lower()]
+        except KeyError:
+            raise COMException(scode=winerror.DISP_E_UNKNOWNNAME)
+
+    # "InvokeEx" handling.
+    def _InvokeEx_(self, dispid, lcid, wFlags, args, kwargs, serviceProvider):
+        """The main COM entry-point for InvokeEx.
+
+        This calls the _invokeex_ helper.
+        """
+        # Translate a possible string dispid to real dispid.
+        if type(dispid) == type(""):
+            try:
+                dispid = self._name_to_dispid_[dispid.lower()]
+            except KeyError:
+                raise COMException(
+                    scode=winerror.DISP_E_MEMBERNOTFOUND, desc="Member not found"
+                )
+        return self._invokeex_(dispid, lcid, wFlags, args, kwargs, serviceProvider)
+
+    def _invokeex_(self, dispid, lcid, wFlags, args, kwargs, serviceProvider):
+        """A stub for _invokeex_ - should never be called.
+
+        Simply raises an exception.
+        """
+        # Base classes should override this method (and not call the base)
+        raise error("This class does not provide _invokeex_ semantics")
+
+    def _DeleteMemberByName_(self, name, fdex):
+        return self._deletememberbyname_(name, fdex)
+
+    def _deletememberbyname_(self, name, fdex):
+        raise COMException(scode=winerror.E_NOTIMPL)
+
+    def _DeleteMemberByDispID_(self, id):
+        return self._deletememberbydispid(id)
+
+    def _deletememberbydispid_(self, id):
+        raise COMException(scode=winerror.E_NOTIMPL)
+
+    def _GetMemberProperties_(self, id, fdex):
+        return self._getmemberproperties_(id, fdex)
+
+    def _getmemberproperties_(self, id, fdex):
+        raise COMException(scode=winerror.E_NOTIMPL)
+
+    def _GetMemberName_(self, dispid):
+        return self._getmembername_(dispid)
+
+    def _getmembername_(self, dispid):
+        raise COMException(scode=winerror.E_NOTIMPL)
+
+    def _GetNextDispID_(self, fdex, dispid):
+        return self._getnextdispid_(fdex, dispid)
+
+    def _getnextdispid_(self, fdex, dispid):
+        ids = list(self._name_to_dispid_.values())
+        ids.sort()
+        if DISPID_STARTENUM in ids:
+            ids.remove(DISPID_STARTENUM)
+        if dispid == DISPID_STARTENUM:
+            return ids[0]
+        else:
+            try:
+                return ids[ids.index(dispid) + 1]
+            except ValueError:  # dispid not in list?
+                raise COMException(scode=winerror.E_UNEXPECTED)
+            except IndexError:  # No more items
+                raise COMException(scode=winerror.S_FALSE)
+
+    def _GetNameSpaceParent_(self):
+        return self._getnamespaceparent()
+
+    def _getnamespaceparent_(self):
+        raise COMException(scode=winerror.E_NOTIMPL)
+
+
+class MappedWrapPolicy(BasicWrapPolicy):
+    """Wraps an object using maps to do its magic
+
+    This policy wraps up a Python object, using a number of maps
+    which translate from a Dispatch ID and flags, into an object to call/getattr, etc.
+
+    It is the responsibility of derived classes to determine exactly how the
+    maps are filled (ie, the derived classes determine the map filling policy.
+
+    This policy supports the following special attributes on the wrapped object
+
+    _dispid_to_func_/_dispid_to_get_/_dispid_to_put_ -- These are dictionaries
+      (keyed by integer dispid, values are string attribute names) which the COM
+      implementation uses when it is processing COM requests.  Note that the implementation
+      uses this dictionary for its own purposes - not a copy - which means the contents of
+      these dictionaries will change as the object is used.
+
+    """
+
+    def _wrap_(self, object):
+        BasicWrapPolicy._wrap_(self, object)
+        ob = self._obj_
+        if hasattr(ob, "_dispid_to_func_"):
+            self._dispid_to_func_ = ob._dispid_to_func_
+        else:
+            self._dispid_to_func_ = {}
+        if hasattr(ob, "_dispid_to_get_"):
+            self._dispid_to_get_ = ob._dispid_to_get_
+        else:
+            self._dispid_to_get_ = {}
+        if hasattr(ob, "_dispid_to_put_"):
+            self._dispid_to_put_ = ob._dispid_to_put_
+        else:
+            self._dispid_to_put_ = {}
+
+    def _getmembername_(self, dispid):
+        if dispid in self._dispid_to_func_:
+            return self._dispid_to_func_[dispid]
+        elif dispid in self._dispid_to_get_:
+            return self._dispid_to_get_[dispid]
+        elif dispid in self._dispid_to_put_:
+            return self._dispid_to_put_[dispid]
+        else:
+            raise COMException(scode=winerror.DISP_E_MEMBERNOTFOUND)
+
+
+class DesignatedWrapPolicy(MappedWrapPolicy):
+    """A policy which uses a mapping to link functions and dispid
+
+     A MappedWrappedPolicy which allows the wrapped object to specify, via certain
+     special named attributes, exactly which methods and properties are exposed.
+
+     All a wrapped object need do is provide the special attributes, and the policy
+     will handle everything else.
+
+     Attributes:
+
+     _public_methods_ -- Required, unless a typelib GUID is given -- A list
+                  of strings, which must be the names of methods the object
+                  provides.  These methods will be exposed and callable
+                  from other COM hosts.
+     _public_attrs_ A list of strings, which must be the names of attributes on the object.
+                  These attributes will be exposed and readable and possibly writeable from other COM hosts.
+     _readonly_attrs_ -- A list of strings, which must also appear in _public_attrs.  These
+                  attributes will be readable, but not writable, by other COM hosts.
+     _value_ -- A method that will be called if the COM host requests the "default" method
+                  (ie, calls Invoke with dispid==DISPID_VALUE)
+     _NewEnum -- A method that will be called if the COM host requests an enumerator on the
+                  object (ie, calls Invoke with dispid==DISPID_NEWENUM.)
+                  It is the responsibility of the method to ensure the returned
+                  object conforms to the required Enum interface.
+
+    _typelib_guid_ -- The GUID of the typelibrary with interface definitions we use.
+    _typelib_version_ -- A tuple of (major, minor) with a default of 1,1
+    _typelib_lcid_ -- The LCID of the typelib, default = LOCALE_USER_DEFAULT
+
+     _Evaluate -- Dunno what this means, except the host has called Invoke with dispid==DISPID_EVALUATE!
+                  See the COM documentation for details.
+    """
+
+    def _wrap_(self, ob):
+        # If we have nominated universal interfaces to support, load them now
+        tlb_guid = getattr(ob, "_typelib_guid_", None)
+        if tlb_guid is not None:
+            tlb_major, tlb_minor = getattr(ob, "_typelib_version_", (1, 0))
+            tlb_lcid = getattr(ob, "_typelib_lcid_", 0)
+            from win32com import universal
+
+            # XXX - what if the user wants to implement interfaces from multiple
+            # typelibs?
+            # Filter out all 'normal' IIDs (ie, IID objects and strings starting with {
+            interfaces = [
+                i
+                for i in getattr(ob, "_com_interfaces_", [])
+                if type(i) != pywintypes.IIDType and not i.startswith("{")
+            ]
+            universal_data = universal.RegisterInterfaces(
+                tlb_guid, tlb_lcid, tlb_major, tlb_minor, interfaces
+            )
+        else:
+            universal_data = []
+        MappedWrapPolicy._wrap_(self, ob)
+        if not hasattr(ob, "_public_methods_") and not hasattr(ob, "_typelib_guid_"):
+            raise error(
+                "Object does not support DesignatedWrapPolicy, as it does not have either _public_methods_ or _typelib_guid_ attributes."
+            )
+
+        # Copy existing _dispid_to_func_ entries to _name_to_dispid_
+        for dispid, name in self._dispid_to_func_.items():
+            self._name_to_dispid_[name.lower()] = dispid
+        for dispid, name in self._dispid_to_get_.items():
+            self._name_to_dispid_[name.lower()] = dispid
+        for dispid, name in self._dispid_to_put_.items():
+            self._name_to_dispid_[name.lower()] = dispid
+
+        # Patch up the universal stuff.
+        for dispid, invkind, name in universal_data:
+            self._name_to_dispid_[name.lower()] = dispid
+            if invkind == DISPATCH_METHOD:
+                self._dispid_to_func_[dispid] = name
+            elif invkind in (DISPATCH_PROPERTYPUT, DISPATCH_PROPERTYPUTREF):
+                self._dispid_to_put_[dispid] = name
+            elif invkind == DISPATCH_PROPERTYGET:
+                self._dispid_to_get_[dispid] = name
+            else:
+                raise ValueError("unexpected invkind: %d (%s)" % (invkind, name))
+
+        # look for reserved methods
+        if hasattr(ob, "_value_"):
+            self._dispid_to_get_[DISPID_VALUE] = "_value_"
+            self._dispid_to_put_[DISPID_PROPERTYPUT] = "_value_"
+        if hasattr(ob, "_NewEnum"):
+            self._name_to_dispid_["_newenum"] = DISPID_NEWENUM
+            self._dispid_to_func_[DISPID_NEWENUM] = "_NewEnum"
+        if hasattr(ob, "_Evaluate"):
+            self._name_to_dispid_["_evaluate"] = DISPID_EVALUATE
+            self._dispid_to_func_[DISPID_EVALUATE] = "_Evaluate"
+
+        next_dispid = self._allocnextdispid(999)
+        # note: funcs have precedence over attrs (install attrs first)
+        if hasattr(ob, "_public_attrs_"):
+            if hasattr(ob, "_readonly_attrs_"):
+                readonly = ob._readonly_attrs_
+            else:
+                readonly = []
+            for name in ob._public_attrs_:
+                dispid = self._name_to_dispid_.get(name.lower())
+                if dispid is None:
+                    dispid = next_dispid
+                    self._name_to_dispid_[name.lower()] = dispid
+                    next_dispid = self._allocnextdispid(next_dispid)
+                self._dispid_to_get_[dispid] = name
+                if name not in readonly:
+                    self._dispid_to_put_[dispid] = name
+        for name in getattr(ob, "_public_methods_", []):
+            dispid = self._name_to_dispid_.get(name.lower())
+            if dispid is None:
+                dispid = next_dispid
+                self._name_to_dispid_[name.lower()] = dispid
+                next_dispid = self._allocnextdispid(next_dispid)
+            self._dispid_to_func_[dispid] = name
+        self._typeinfos_ = None  # load these on demand.
+
+    def _build_typeinfos_(self):
+        # Can only ever be one for now.
+        tlb_guid = getattr(self._obj_, "_typelib_guid_", None)
+        if tlb_guid is None:
+            return []
+        tlb_major, tlb_minor = getattr(self._obj_, "_typelib_version_", (1, 0))
+        tlb = pythoncom.LoadRegTypeLib(tlb_guid, tlb_major, tlb_minor)
+        typecomp = tlb.GetTypeComp()
+        # Not 100% sure what semantics we should use for the default interface.
+        # Look for the first name in _com_interfaces_ that exists in the typelib.
+        for iname in self._obj_._com_interfaces_:
+            try:
+                type_info, type_comp = typecomp.BindType(iname)
+                if type_info is not None:
+                    return [type_info]
+            except pythoncom.com_error:
+                pass
+        return []
+
+    def _GetTypeInfoCount_(self):
+        if self._typeinfos_ is None:
+            self._typeinfos_ = self._build_typeinfos_()
+        return len(self._typeinfos_)
+
+    def _GetTypeInfo_(self, index, lcid):
+        if self._typeinfos_ is None:
+            self._typeinfos_ = self._build_typeinfos_()
+        if index < 0 or index >= len(self._typeinfos_):
+            raise COMException(scode=winerror.DISP_E_BADINDEX)
+        return 0, self._typeinfos_[index]
+
+    def _allocnextdispid(self, last_dispid):
+        while 1:
+            last_dispid = last_dispid + 1
+            if (
+                last_dispid not in self._dispid_to_func_
+                and last_dispid not in self._dispid_to_get_
+                and last_dispid not in self._dispid_to_put_
+            ):
+                return last_dispid
+
+    def _invokeex_(self, dispid, lcid, wFlags, args, kwArgs, serviceProvider):
+        ### note: lcid is being ignored...
+
+        if wFlags & DISPATCH_METHOD:
+            try:
+                funcname = self._dispid_to_func_[dispid]
+            except KeyError:
+                if not wFlags & DISPATCH_PROPERTYGET:
+                    raise COMException(
+                        scode=winerror.DISP_E_MEMBERNOTFOUND
+                    )  # not found
+            else:
+                try:
+                    func = getattr(self._obj_, funcname)
+                except AttributeError:
+                    # May have a dispid, but that doesnt mean we have the function!
+                    raise COMException(scode=winerror.DISP_E_MEMBERNOTFOUND)
+                # Should check callable here
+                try:
+                    return func(*args)
+                except TypeError as v:
+                    # Particularly nasty is "wrong number of args" type error
+                    # This helps you see what 'func' and 'args' actually is
+                    if str(v).find("arguments") >= 0:
+                        print(
+                            "** TypeError %s calling function %r(%r)" % (v, func, args)
+                        )
+                    raise
+
+        if wFlags & DISPATCH_PROPERTYGET:
+            try:
+                name = self._dispid_to_get_[dispid]
+            except KeyError:
+                raise COMException(scode=winerror.DISP_E_MEMBERNOTFOUND)  # not found
+            retob = getattr(self._obj_, name)
+            if type(retob) == types.MethodType:  # a method as a property - call it.
+                retob = retob(*args)
+            return retob
+
+        if wFlags & (DISPATCH_PROPERTYPUT | DISPATCH_PROPERTYPUTREF):  ### correct?
+            try:
+                name = self._dispid_to_put_[dispid]
+            except KeyError:
+                raise COMException(scode=winerror.DISP_E_MEMBERNOTFOUND)  # read-only
+            # If we have a method of that name (ie, a property get function), and
+            # we have an equiv. property set function, use that instead.
+            if (
+                type(getattr(self._obj_, name, None)) == types.MethodType
+                and type(getattr(self._obj_, "Set" + name, None)) == types.MethodType
+            ):
+                fn = getattr(self._obj_, "Set" + name)
+                fn(*args)
+            else:
+                # just set the attribute
+                setattr(self._obj_, name, args[0])
+            return
+
+        raise COMException(scode=winerror.E_INVALIDARG, desc="invalid wFlags")
+
+
+class EventHandlerPolicy(DesignatedWrapPolicy):
+    """The default policy used by event handlers in the win32com.client package.
+
+    In addition to the base policy, this provides argument conversion semantics for
+    params
+      * dispatch params are converted to dispatch objects.
+      * Unicode objects are converted to strings (1.5.2 and earlier)
+
+    NOTE: Later, we may allow the object to override this process??
+    """
+
+    def _transform_args_(self, args, kwArgs, dispid, lcid, wFlags, serviceProvider):
+        ret = []
+        for arg in args:
+            arg_type = type(arg)
+            if arg_type == IDispatchType:
+                import win32com.client
+
+                arg = win32com.client.Dispatch(arg)
+            elif arg_type == IUnknownType:
+                try:
+                    import win32com.client
+
+                    arg = win32com.client.Dispatch(
+                        arg.QueryInterface(pythoncom.IID_IDispatch)
+                    )
+                except pythoncom.error:
+                    pass  # Keep it as IUnknown
+            ret.append(arg)
+        return tuple(ret), kwArgs
+
+    def _invokeex_(self, dispid, lcid, wFlags, args, kwArgs, serviceProvider):
+        # transform the args.
+        args, kwArgs = self._transform_args_(
+            args, kwArgs, dispid, lcid, wFlags, serviceProvider
+        )
+        return DesignatedWrapPolicy._invokeex_(
+            self, dispid, lcid, wFlags, args, kwArgs, serviceProvider
+        )
+
+
+class DynamicPolicy(BasicWrapPolicy):
+    """A policy which dynamically (ie, at run-time) determines public interfaces.
+
+    A dynamic policy is used to dynamically dispatch methods and properties to the
+    wrapped object.  The list of objects and properties does not need to be known in
+    advance, and methods or properties added to the wrapped object after construction
+    are also handled.
+
+    The wrapped object must provide the following attributes:
+
+    _dynamic_ -- A method that will be called whenever an invoke on the object
+           is called.  The method is called with the name of the underlying method/property
+           (ie, the mapping of dispid to/from name has been resolved.)  This name property
+           may also be '_value_' to indicate the default, and '_NewEnum' to indicate a new
+           enumerator is requested.
+
+    """
+
+    def _wrap_(self, object):
+        BasicWrapPolicy._wrap_(self, object)
+        if not hasattr(self._obj_, "_dynamic_"):
+            raise error("Object does not support Dynamic COM Policy")
+        self._next_dynamic_ = self._min_dynamic_ = 1000
+        self._dyn_dispid_to_name_ = {
+            DISPID_VALUE: "_value_",
+            DISPID_NEWENUM: "_NewEnum",
+        }
+
+    def _getdispid_(self, name, fdex):
+        # TODO - Look at fdex flags.
+        lname = name.lower()
+        try:
+            return self._name_to_dispid_[lname]
+        except KeyError:
+            dispid = self._next_dynamic_ = self._next_dynamic_ + 1
+            self._name_to_dispid_[lname] = dispid
+            self._dyn_dispid_to_name_[dispid] = name  # Keep case in this map...
+            return dispid
+
+    def _invoke_(self, dispid, lcid, wFlags, args):
+        return S_OK, -1, self._invokeex_(dispid, lcid, wFlags, args, None, None)
+
+    def _invokeex_(self, dispid, lcid, wFlags, args, kwargs, serviceProvider):
+        ### note: lcid is being ignored...
+        ### note: kwargs is being ignored...
+        ### note: serviceProvider is being ignored...
+        ### there might be assigned DISPID values to properties, too...
+        try:
+            name = self._dyn_dispid_to_name_[dispid]
+        except KeyError:
+            raise COMException(
+                scode=winerror.DISP_E_MEMBERNOTFOUND, desc="Member not found"
+            )
+        return self._obj_._dynamic_(name, lcid, wFlags, args)
+
+
+DefaultPolicy = DesignatedWrapPolicy
+
+
+def resolve_func(spec):
+    """Resolve a function by name
+
+    Given a function specified by 'module.function', return a callable object
+    (ie, the function itself)
+    """
+    try:
+        idx = spec.rindex(".")
+        mname = spec[:idx]
+        fname = spec[idx + 1 :]
+        # Dont attempt to optimize by looking in sys.modules,
+        # as another thread may also be performing the import - this
+        # way we take advantage of the built-in import lock.
+        module = _import_module(mname)
+        return getattr(module, fname)
+    except ValueError:  # No "." in name - assume in this module
+        return globals()[spec]
+
+
+def call_func(spec, *args):
+    """Call a function specified by name.
+
+    Call a function specified by 'module.function' and return the result.
+    """
+
+    return resolve_func(spec)(*args)
+
+
+def _import_module(mname):
+    """Import a module just like the 'import' statement.
+
+    Having this function is much nicer for importing arbitrary modules than
+    using the 'exec' keyword.  It is more efficient and obvious to the reader.
+    """
+    __import__(mname)
+    # Eeek - result of _import_ is "win32com" - not "win32com.a.b.c"
+    # Get the full module from sys.modules
+    return sys.modules[mname]
+
+
+#######
+#
+# Temporary hacks until all old code moves.
+#
+# These have been moved to a new source file, but some code may
+# still reference them here.  These will end up being removed.
+try:
+    from .dispatcher import DispatcherTrace, DispatcherWin32trace
+except ImportError:  # Quite likely a frozen executable that doesnt need dispatchers
+    pass
diff --git a/lib/win32com/server/register.py b/lib/win32com/server/register.py
new file mode 100644
index 00000000..ae513c75
--- /dev/null
+++ b/lib/win32com/server/register.py
@@ -0,0 +1,672 @@
+"""Utilities for registering objects.
+
+This module contains utility functions to register Python objects as
+valid COM Servers.  The RegisterServer function provides all information
+necessary to allow the COM framework to respond to a request for a COM object,
+construct the necessary Python object, and dispatch COM events.
+
+"""
+import os
+import sys
+
+import pythoncom
+import win32api
+import win32con
+import winerror
+
+CATID_PythonCOMServer = "{B3EF80D0-68E2-11D0-A689-00C04FD658FF}"
+
+
+def _set_subkeys(keyName, valueDict, base=win32con.HKEY_CLASSES_ROOT):
+    hkey = win32api.RegCreateKey(base, keyName)
+    try:
+        for key, value in valueDict.items():
+            win32api.RegSetValueEx(hkey, key, None, win32con.REG_SZ, value)
+    finally:
+        win32api.RegCloseKey(hkey)
+
+
+def _set_string(path, value, base=win32con.HKEY_CLASSES_ROOT):
+    "Set a string value in the registry."
+
+    win32api.RegSetValue(base, path, win32con.REG_SZ, value)
+
+
+def _get_string(path, base=win32con.HKEY_CLASSES_ROOT):
+    "Get a string value from the registry."
+
+    try:
+        return win32api.RegQueryValue(base, path)
+    except win32api.error:
+        return None
+
+
+def _remove_key(path, base=win32con.HKEY_CLASSES_ROOT):
+    "Remove a string from the registry."
+
+    try:
+        win32api.RegDeleteKey(base, path)
+    except win32api.error as xxx_todo_changeme1:
+        (code, fn, msg) = xxx_todo_changeme1.args
+        if code != winerror.ERROR_FILE_NOT_FOUND:
+            raise win32api.error(code, fn, msg)
+
+
+def recurse_delete_key(path, base=win32con.HKEY_CLASSES_ROOT):
+    """Recursively delete registry keys.
+
+    This is needed since you can't blast a key when subkeys exist.
+    """
+    try:
+        h = win32api.RegOpenKey(base, path)
+    except win32api.error as xxx_todo_changeme2:
+        (code, fn, msg) = xxx_todo_changeme2.args
+        if code != winerror.ERROR_FILE_NOT_FOUND:
+            raise win32api.error(code, fn, msg)
+    else:
+        # parent key found and opened successfully. do some work, making sure
+        # to always close the thing (error or no).
+        try:
+            # remove all of the subkeys
+            while 1:
+                try:
+                    subkeyname = win32api.RegEnumKey(h, 0)
+                except win32api.error as xxx_todo_changeme:
+                    (code, fn, msg) = xxx_todo_changeme.args
+                    if code != winerror.ERROR_NO_MORE_ITEMS:
+                        raise win32api.error(code, fn, msg)
+                    break
+                recurse_delete_key(path + "\\" + subkeyname, base)
+
+            # remove the parent key
+            _remove_key(path, base)
+        finally:
+            win32api.RegCloseKey(h)
+
+
+def _cat_registrar():
+    return pythoncom.CoCreateInstance(
+        pythoncom.CLSID_StdComponentCategoriesMgr,
+        None,
+        pythoncom.CLSCTX_INPROC_SERVER,
+        pythoncom.IID_ICatRegister,
+    )
+
+
+def _find_localserver_exe(mustfind):
+    if not sys.platform.startswith("win32"):
+        return sys.executable
+    if pythoncom.__file__.find("_d") < 0:
+        exeBaseName = "pythonw.exe"
+    else:
+        exeBaseName = "pythonw_d.exe"
+    # First see if in the same directory as this .EXE
+    exeName = os.path.join(os.path.split(sys.executable)[0], exeBaseName)
+    if not os.path.exists(exeName):
+        # See if in our sys.prefix directory
+        exeName = os.path.join(sys.prefix, exeBaseName)
+    if not os.path.exists(exeName):
+        # See if in our sys.prefix/pcbuild directory (for developers)
+        if "64 bit" in sys.version:
+            exeName = os.path.join(sys.prefix, "PCbuild", "amd64", exeBaseName)
+        else:
+            exeName = os.path.join(sys.prefix, "PCbuild", exeBaseName)
+    if not os.path.exists(exeName):
+        # See if the registry has some info.
+        try:
+            key = "SOFTWARE\\Python\\PythonCore\\%s\\InstallPath" % sys.winver
+            path = win32api.RegQueryValue(win32con.HKEY_LOCAL_MACHINE, key)
+            exeName = os.path.join(path, exeBaseName)
+        except (AttributeError, win32api.error):
+            pass
+    if not os.path.exists(exeName):
+        if mustfind:
+            raise RuntimeError("Can not locate the program '%s'" % exeBaseName)
+        return None
+    return exeName
+
+
+def _find_localserver_module():
+    import win32com.server
+
+    path = win32com.server.__path__[0]
+    baseName = "localserver"
+    pyfile = os.path.join(path, baseName + ".py")
+    try:
+        os.stat(pyfile)
+    except os.error:
+        # See if we have a compiled extension
+        if __debug__:
+            ext = ".pyc"
+        else:
+            ext = ".pyo"
+        pyfile = os.path.join(path, baseName + ext)
+        try:
+            os.stat(pyfile)
+        except os.error:
+            raise RuntimeError(
+                "Can not locate the Python module 'win32com.server.%s'" % baseName
+            )
+    return pyfile
+
+
+def RegisterServer(
+    clsid,
+    pythonInstString=None,
+    desc=None,
+    progID=None,
+    verProgID=None,
+    defIcon=None,
+    threadingModel="both",
+    policy=None,
+    catids=[],
+    other={},
+    addPyComCat=None,
+    dispatcher=None,
+    clsctx=None,
+    addnPath=None,
+):
+    """Registers a Python object as a COM Server.  This enters almost all necessary
+    information in the system registry, allowing COM to use the object.
+
+    clsid -- The (unique) CLSID of the server.
+    pythonInstString -- A string holding the instance name that will be created
+                  whenever COM requests a new object.
+    desc -- The description of the COM object.
+    progID -- The user name of this object (eg, Word.Document)
+    verProgId -- The user name of this version's implementation (eg Word.6.Document)
+    defIcon -- The default icon for the object.
+    threadingModel -- The threading model this object supports.
+    policy -- The policy to use when creating this object.
+    catids -- A list of category ID's this object belongs in.
+    other -- A dictionary of extra items to be registered.
+    addPyComCat -- A flag indicating if the object should be added to the list
+             of Python servers installed on the machine.  If None (the default)
+             then it will be registered when running from python source, but
+             not registered if running in a frozen environment.
+    dispatcher -- The dispatcher to use when creating this object.
+    clsctx -- One of the CLSCTX_* constants.
+    addnPath -- An additional path the COM framework will add to sys.path
+                before attempting to create the object.
+    """
+
+    ### backwards-compat check
+    ### Certain policies do not require a "class name", just the policy itself.
+    if not pythonInstString and not policy:
+        raise TypeError(
+            "You must specify either the Python Class or Python Policy which implement the COM object."
+        )
+
+    keyNameRoot = "CLSID\\%s" % str(clsid)
+    _set_string(keyNameRoot, desc)
+
+    # Also register as an "Application" so DCOM etc all see us.
+    _set_string("AppID\\%s" % clsid, progID)
+    # Depending on contexts requested, register the specified server type.
+    # Set default clsctx.
+    if not clsctx:
+        clsctx = pythoncom.CLSCTX_INPROC_SERVER | pythoncom.CLSCTX_LOCAL_SERVER
+    # And if we are frozen, ignore the ones that don't make sense in this
+    # context.
+    if pythoncom.frozen:
+        assert (
+            sys.frozen
+        ), "pythoncom is frozen, but sys.frozen is not set - don't know the context!"
+        if sys.frozen == "dll":
+            clsctx = clsctx & pythoncom.CLSCTX_INPROC_SERVER
+        else:
+            clsctx = clsctx & pythoncom.CLSCTX_LOCAL_SERVER
+    # Now setup based on the clsctx left over.
+    if clsctx & pythoncom.CLSCTX_INPROC_SERVER:
+        # get the module to use for registration.
+        # nod to Gordon's installer - if sys.frozen and sys.frozendllhandle
+        # exist, then we are being registered via a DLL - use this DLL as the
+        # file name.
+        if pythoncom.frozen:
+            if hasattr(sys, "frozendllhandle"):
+                dllName = win32api.GetModuleFileName(sys.frozendllhandle)
+            else:
+                raise RuntimeError(
+                    "We appear to have a frozen DLL, but I don't know the DLL to use"
+                )
+        else:
+            # Normal case - running from .py file, so register pythoncom's DLL.
+            # Although now we prefer a 'loader' DLL if it exists to avoid some
+            # manifest issues (the 'loader' DLL has a manifest, but pythoncom does not)
+            pythoncom_dir = os.path.dirname(pythoncom.__file__)
+            suffix = "_d" if "_d" in pythoncom.__file__ else ""
+            # Always register with the full path to the DLLs.
+            loadername = os.path.join(
+                pythoncom_dir,
+                "pythoncomloader%d%d%s.dll"
+                % (sys.version_info[0], sys.version_info[1], suffix),
+            )
+            dllName = loadername if os.path.isfile(loadername) else pythoncom.__file__
+
+        _set_subkeys(
+            keyNameRoot + "\\InprocServer32",
+            {
+                None: dllName,
+                "ThreadingModel": threadingModel,
+            },
+        )
+    else:  # Remove any old InProcServer32 registrations
+        _remove_key(keyNameRoot + "\\InprocServer32")
+
+    if clsctx & pythoncom.CLSCTX_LOCAL_SERVER:
+        if pythoncom.frozen:
+            # If we are frozen, we write "{exe} /Automate", just
+            # like "normal" .EXEs do
+            exeName = win32api.GetShortPathName(sys.executable)
+            command = "%s /Automate" % (exeName,)
+        else:
+            # Running from .py sources - we need to write
+            # 'python.exe win32com\server\localserver.py {clsid}"
+            exeName = _find_localserver_exe(1)
+            exeName = win32api.GetShortPathName(exeName)
+            pyfile = _find_localserver_module()
+            command = '%s "%s" %s' % (exeName, pyfile, str(clsid))
+        _set_string(keyNameRoot + "\\LocalServer32", command)
+    else:  # Remove any old LocalServer32 registrations
+        _remove_key(keyNameRoot + "\\LocalServer32")
+
+    if pythonInstString:
+        _set_string(keyNameRoot + "\\PythonCOM", pythonInstString)
+    else:
+        _remove_key(keyNameRoot + "\\PythonCOM")
+    if policy:
+        _set_string(keyNameRoot + "\\PythonCOMPolicy", policy)
+    else:
+        _remove_key(keyNameRoot + "\\PythonCOMPolicy")
+
+    if dispatcher:
+        _set_string(keyNameRoot + "\\PythonCOMDispatcher", dispatcher)
+    else:
+        _remove_key(keyNameRoot + "\\PythonCOMDispatcher")
+
+    if defIcon:
+        _set_string(keyNameRoot + "\\DefaultIcon", defIcon)
+    else:
+        _remove_key(keyNameRoot + "\\DefaultIcon")
+
+    if addnPath:
+        _set_string(keyNameRoot + "\\PythonCOMPath", addnPath)
+    else:
+        _remove_key(keyNameRoot + "\\PythonCOMPath")
+
+    if addPyComCat is None:
+        addPyComCat = pythoncom.frozen == 0
+    if addPyComCat:
+        catids = catids + [CATID_PythonCOMServer]
+
+    # Set up the implemented categories
+    if catids:
+        regCat = _cat_registrar()
+        regCat.RegisterClassImplCategories(clsid, catids)
+
+    # set up any other reg values they might have
+    if other:
+        for key, value in other.items():
+            _set_string(keyNameRoot + "\\" + key, value)
+
+    if progID:
+        # set the progID as the most specific that was given to us
+        if verProgID:
+            _set_string(keyNameRoot + "\\ProgID", verProgID)
+        else:
+            _set_string(keyNameRoot + "\\ProgID", progID)
+
+        # Set up the root entries - version independent.
+        if desc:
+            _set_string(progID, desc)
+        _set_string(progID + "\\CLSID", str(clsid))
+
+        # Set up the root entries - version dependent.
+        if verProgID:
+            # point from independent to the current version
+            _set_string(progID + "\\CurVer", verProgID)
+
+            # point to the version-independent one
+            _set_string(keyNameRoot + "\\VersionIndependentProgID", progID)
+
+            # set up the versioned progID
+            if desc:
+                _set_string(verProgID, desc)
+            _set_string(verProgID + "\\CLSID", str(clsid))
+
+
+def GetUnregisterServerKeys(clsid, progID=None, verProgID=None, customKeys=None):
+    """Given a server, return a list of of ("key", root), which are keys recursively
+    and uncondtionally deleted at unregister or uninstall time.
+    """
+    # remove the main CLSID registration
+    ret = [("CLSID\\%s" % str(clsid), win32con.HKEY_CLASSES_ROOT)]
+    # remove the versioned ProgID registration
+    if verProgID:
+        ret.append((verProgID, win32con.HKEY_CLASSES_ROOT))
+    # blow away the independent ProgID. we can't leave it since we just
+    # torched the class.
+    ### could potentially check the CLSID... ?
+    if progID:
+        ret.append((progID, win32con.HKEY_CLASSES_ROOT))
+    # The DCOM config tool may write settings to the AppID key for our CLSID
+    ret.append(("AppID\\%s" % str(clsid), win32con.HKEY_CLASSES_ROOT))
+    # Any custom keys?
+    if customKeys:
+        ret = ret + customKeys
+
+    return ret
+
+
+def UnregisterServer(clsid, progID=None, verProgID=None, customKeys=None):
+    """Unregisters a Python COM server."""
+
+    for args in GetUnregisterServerKeys(clsid, progID, verProgID, customKeys):
+        recurse_delete_key(*args)
+
+    ### it might be nice at some point to "roll back" the independent ProgID
+    ### to an earlier version if one exists, and just blowing away the
+    ### specified version of the ProgID (and its corresponding CLSID)
+    ### another time, though...
+
+    ### NOTE: ATL simply blows away the above three keys without the
+    ### potential checks that I describe.  Assuming that defines the
+    ### "standard" then we have no additional changes necessary.
+
+
+def GetRegisteredServerOption(clsid, optionName):
+    """Given a CLSID for a server and option name, return the option value"""
+    keyNameRoot = "CLSID\\%s\\%s" % (str(clsid), str(optionName))
+    return _get_string(keyNameRoot)
+
+
+def _get(ob, attr, default=None):
+    try:
+        return getattr(ob, attr)
+    except AttributeError:
+        pass
+    # look down sub-classes
+    try:
+        bases = ob.__bases__
+    except AttributeError:
+        # ob is not a class - no probs.
+        return default
+    for base in bases:
+        val = _get(base, attr, None)
+        if val is not None:
+            return val
+    return default
+
+
+def RegisterClasses(*classes, **flags):
+    quiet = "quiet" in flags and flags["quiet"]
+    debugging = "debug" in flags and flags["debug"]
+    for cls in classes:
+        clsid = cls._reg_clsid_
+        progID = _get(cls, "_reg_progid_")
+        desc = _get(cls, "_reg_desc_", progID)
+        spec = _get(cls, "_reg_class_spec_")
+        verProgID = _get(cls, "_reg_verprogid_")
+        defIcon = _get(cls, "_reg_icon_")
+        threadingModel = _get(cls, "_reg_threading_", "both")
+        catids = _get(cls, "_reg_catids_", [])
+        options = _get(cls, "_reg_options_", {})
+        policySpec = _get(cls, "_reg_policy_spec_")
+        clsctx = _get(cls, "_reg_clsctx_")
+        tlb_filename = _get(cls, "_reg_typelib_filename_")
+        # default to being a COM category only when not frozen.
+        addPyComCat = not _get(cls, "_reg_disable_pycomcat_", pythoncom.frozen != 0)
+        addnPath = None
+        if debugging:
+            # If the class has a debugging dispatcher specified, use it, otherwise
+            # use our default dispatcher.
+            dispatcherSpec = _get(cls, "_reg_debug_dispatcher_spec_")
+            if dispatcherSpec is None:
+                dispatcherSpec = "win32com.server.dispatcher.DefaultDebugDispatcher"
+            # And remember the debugging flag as servers may wish to use it at runtime.
+            debuggingDesc = "(for debugging)"
+            options["Debugging"] = "1"
+        else:
+            dispatcherSpec = _get(cls, "_reg_dispatcher_spec_")
+            debuggingDesc = ""
+            options["Debugging"] = "0"
+
+        if spec is None:
+            moduleName = cls.__module__
+            if moduleName == "__main__":
+                # Use argv[0] to determine the module name.
+                try:
+                    # Use the win32api to find the case-sensitive name
+                    moduleName = os.path.splitext(
+                        win32api.FindFiles(sys.argv[0])[0][8]
+                    )[0]
+                except (IndexError, win32api.error):
+                    # Can't find the script file - the user must explicitely set the _reg_... attribute.
+                    raise TypeError(
+                        "Can't locate the script hosting the COM object - please set _reg_class_spec_ in your object"
+                    )
+
+            spec = moduleName + "." + cls.__name__
+            # Frozen apps don't need their directory on sys.path
+            if not pythoncom.frozen:
+                scriptDir = os.path.split(sys.argv[0])[0]
+                if not scriptDir:
+                    scriptDir = "."
+                addnPath = win32api.GetFullPathName(scriptDir)
+
+        RegisterServer(
+            clsid,
+            spec,
+            desc,
+            progID,
+            verProgID,
+            defIcon,
+            threadingModel,
+            policySpec,
+            catids,
+            options,
+            addPyComCat,
+            dispatcherSpec,
+            clsctx,
+            addnPath,
+        )
+        if not quiet:
+            print("Registered:", progID or spec, debuggingDesc)
+        # Register the typelibrary
+        if tlb_filename:
+            tlb_filename = os.path.abspath(tlb_filename)
+            typelib = pythoncom.LoadTypeLib(tlb_filename)
+            pythoncom.RegisterTypeLib(typelib, tlb_filename)
+            if not quiet:
+                print("Registered type library:", tlb_filename)
+    extra = flags.get("finalize_register")
+    if extra:
+        extra()
+
+
+def UnregisterClasses(*classes, **flags):
+    quiet = "quiet" in flags and flags["quiet"]
+    for cls in classes:
+        clsid = cls._reg_clsid_
+        progID = _get(cls, "_reg_progid_")
+        verProgID = _get(cls, "_reg_verprogid_")
+        customKeys = _get(cls, "_reg_remove_keys_")
+        unregister_typelib = _get(cls, "_reg_typelib_filename_") is not None
+
+        UnregisterServer(clsid, progID, verProgID, customKeys)
+        if not quiet:
+            print("Unregistered:", progID or str(clsid))
+        if unregister_typelib:
+            tlb_guid = _get(cls, "_typelib_guid_")
+            if tlb_guid is None:
+                # I guess I could load the typelib, but they need the GUID anyway.
+                print("Have typelib filename, but no GUID - can't unregister")
+            else:
+                major, minor = _get(cls, "_typelib_version_", (1, 0))
+                lcid = _get(cls, "_typelib_lcid_", 0)
+                try:
+                    pythoncom.UnRegisterTypeLib(tlb_guid, major, minor, lcid)
+                    if not quiet:
+                        print("Unregistered type library")
+                except pythoncom.com_error:
+                    pass
+
+    extra = flags.get("finalize_unregister")
+    if extra:
+        extra()
+
+
+#
+# Unregister info is for installers or external uninstallers.
+# The WISE installer, for example firstly registers the COM server,
+# then queries for the Unregister info, appending it to its
+# install log.  Uninstalling the package will the uninstall the server
+def UnregisterInfoClasses(*classes, **flags):
+    ret = []
+    for cls in classes:
+        clsid = cls._reg_clsid_
+        progID = _get(cls, "_reg_progid_")
+        verProgID = _get(cls, "_reg_verprogid_")
+        customKeys = _get(cls, "_reg_remove_keys_")
+
+        ret = ret + GetUnregisterServerKeys(clsid, progID, verProgID, customKeys)
+    return ret
+
+
+# Attempt to 're-execute' our current process with elevation.
+def ReExecuteElevated(flags):
+    import tempfile
+
+    import win32event  # we've already checked we are running XP above
+    import win32process
+    import winxpgui
+    from win32com.shell import shellcon
+    from win32com.shell.shell import ShellExecuteEx
+
+    if not flags["quiet"]:
+        print("Requesting elevation and retrying...")
+    new_params = " ".join(['"' + a + '"' for a in sys.argv])
+    # If we aren't already in unattended mode, we want our sub-process to
+    # be.
+    if not flags["unattended"]:
+        new_params += " --unattended"
+    # specifying the parent means the dialog is centered over our window,
+    # which is a good usability clue.
+    # hwnd is unlikely on the command-line, but flags may come from elsewhere
+    hwnd = flags.get("hwnd", None)
+    if hwnd is None:
+        try:
+            hwnd = winxpgui.GetConsoleWindow()
+        except winxpgui.error:
+            hwnd = 0
+    # Redirect output so we give the user some clue what went wrong.  This
+    # also means we need to use COMSPEC.  However, the "current directory"
+    # appears to end up ignored - so we execute things via a temp batch file.
+    tempbase = tempfile.mktemp("pycomserverreg")
+    outfile = tempbase + ".out"
+    batfile = tempbase + ".bat"
+
+    # If registering from pythonwin, need to run python console instead since
+    #  pythonwin will just open script for editting
+    current_exe = os.path.split(sys.executable)[1].lower()
+    exe_to_run = None
+    if current_exe == "pythonwin.exe":
+        exe_to_run = os.path.join(sys.prefix, "python.exe")
+    elif current_exe == "pythonwin_d.exe":
+        exe_to_run = os.path.join(sys.prefix, "python_d.exe")
+    if not exe_to_run or not os.path.exists(exe_to_run):
+        exe_to_run = sys.executable
+
+    try:
+        batf = open(batfile, "w")
+        try:
+            cwd = os.getcwd()
+            print("@echo off", file=batf)
+            # nothing is 'inherited' by the elevated process, including the
+            # environment.  I wonder if we need to set more?
+            print("set PYTHONPATH=%s" % os.environ.get("PYTHONPATH", ""), file=batf)
+            # may be on a different drive - select that before attempting to CD.
+            print(os.path.splitdrive(cwd)[0], file=batf)
+            print('cd "%s"' % os.getcwd(), file=batf)
+            print(
+                '%s %s > "%s" 2>&1'
+                % (win32api.GetShortPathName(exe_to_run), new_params, outfile),
+                file=batf,
+            )
+        finally:
+            batf.close()
+        executable = os.environ.get("COMSPEC", "cmd.exe")
+        rc = ShellExecuteEx(
+            hwnd=hwnd,
+            fMask=shellcon.SEE_MASK_NOCLOSEPROCESS,
+            lpVerb="runas",
+            lpFile=executable,
+            lpParameters='/C "%s"' % batfile,
+            nShow=win32con.SW_SHOW,
+        )
+        hproc = rc["hProcess"]
+        win32event.WaitForSingleObject(hproc, win32event.INFINITE)
+        exit_code = win32process.GetExitCodeProcess(hproc)
+        outf = open(outfile)
+        try:
+            output = outf.read()
+        finally:
+            outf.close()
+
+        if exit_code:
+            # Even if quiet you get to see this message.
+            print("Error: registration failed (exit code %s)." % exit_code)
+        # if we are quiet then the output if likely to already be nearly
+        # empty, so always print it.
+        print(output, end=" ")
+    finally:
+        for f in (outfile, batfile):
+            try:
+                os.unlink(f)
+            except os.error as exc:
+                print("Failed to remove tempfile '%s': %s" % (f, exc))
+
+
+def UseCommandLine(*classes, **flags):
+    unregisterInfo = "--unregister_info" in sys.argv
+    unregister = "--unregister" in sys.argv
+    flags["quiet"] = flags.get("quiet", 0) or "--quiet" in sys.argv
+    flags["debug"] = flags.get("debug", 0) or "--debug" in sys.argv
+    flags["unattended"] = flags.get("unattended", 0) or "--unattended" in sys.argv
+    if unregisterInfo:
+        return UnregisterInfoClasses(*classes, **flags)
+    try:
+        if unregister:
+            UnregisterClasses(*classes, **flags)
+        else:
+            RegisterClasses(*classes, **flags)
+    except win32api.error as exc:
+        # If we are on xp+ and have "access denied", retry using
+        # ShellExecuteEx with 'runas' verb to force elevation (vista) and/or
+        # admin login dialog (vista/xp)
+        if (
+            flags["unattended"]
+            or exc.winerror != winerror.ERROR_ACCESS_DENIED
+            or sys.getwindowsversion()[0] < 5
+        ):
+            raise
+        ReExecuteElevated(flags)
+
+
+def RegisterPyComCategory():
+    """Register the Python COM Server component category."""
+    regCat = _cat_registrar()
+    regCat.RegisterCategories([(CATID_PythonCOMServer, 0x0409, "Python COM Server")])
+
+
+if not pythoncom.frozen:
+    try:
+        win32api.RegQueryValue(
+            win32con.HKEY_CLASSES_ROOT,
+            "Component Categories\\%s" % CATID_PythonCOMServer,
+        )
+    except win32api.error:
+        try:
+            RegisterPyComCategory()
+        except pythoncom.error:  # Error with the COM category manager - oh well.
+            pass
diff --git a/lib/win32com/server/util.py b/lib/win32com/server/util.py
new file mode 100644
index 00000000..c46dd375
--- /dev/null
+++ b/lib/win32com/server/util.py
@@ -0,0 +1,229 @@
+""" General Server side utilities 
+"""
+import pythoncom
+import winerror
+
+from . import policy
+from .exception import COMException
+
+
+def wrap(ob, iid=None, usePolicy=None, useDispatcher=None):
+    """Wraps an object in a PyGDispatch gateway.
+
+    Returns a client side PyI{iid} interface.
+
+    Interface and gateway support must exist for the specified IID, as
+    the QueryInterface() method is used.
+
+    """
+    if usePolicy is None:
+        usePolicy = policy.DefaultPolicy
+    if useDispatcher == 1:  # True will also work here.
+        import win32com.server.dispatcher
+
+        useDispatcher = win32com.server.dispatcher.DefaultDebugDispatcher
+    if useDispatcher is None or useDispatcher == 0:
+        ob = usePolicy(ob)
+    else:
+        ob = useDispatcher(usePolicy, ob)
+
+    # get a PyIDispatch, which interfaces to PyGDispatch
+    ob = pythoncom.WrapObject(ob)
+    if iid is not None:
+        ob = ob.QueryInterface(iid)  # Ask the PyIDispatch if it supports it?
+    return ob
+
+
+def unwrap(ob):
+    """Unwraps an interface.
+
+    Given an interface which wraps up a Gateway, return the object behind
+    the gateway.
+    """
+    ob = pythoncom.UnwrapObject(ob)
+    # see if the object is a dispatcher
+    if hasattr(ob, "policy"):
+        ob = ob.policy
+    return ob._obj_
+
+
+class ListEnumerator:
+    """A class to expose a Python sequence as an EnumVARIANT.
+
+    Create an instance of this class passing a sequence (list, tuple, or
+    any sequence protocol supporting object) and it will automatically
+    support the EnumVARIANT interface for the object.
+
+    See also the @NewEnum@ function, which can be used to turn the
+    instance into an actual COM server.
+    """
+
+    _public_methods_ = ["Next", "Skip", "Reset", "Clone"]
+
+    def __init__(self, data, index=0, iid=pythoncom.IID_IEnumVARIANT):
+        self._list_ = data
+        self.index = index
+        self._iid_ = iid
+
+    def _query_interface_(self, iid):
+        if iid == self._iid_:
+            return 1
+
+    def Next(self, count):
+        result = self._list_[self.index : self.index + count]
+        self.Skip(count)
+        return result
+
+    def Skip(self, count):
+        end = self.index + count
+        if end > len(self._list_):
+            end = len(self._list_)
+        self.index = end
+
+    def Reset(self):
+        self.index = 0
+
+    def Clone(self):
+        return self._wrap(self.__class__(self._list_, self.index))
+
+    def _wrap(self, ob):
+        return wrap(ob)
+
+
+class ListEnumeratorGateway(ListEnumerator):
+    """A List Enumerator which wraps a sequence's items in gateways.
+
+    If a sequence contains items (objects) that have not been wrapped for
+    return through the COM layers, then a ListEnumeratorGateway can be
+    used to wrap those items before returning them (from the Next() method).
+
+    See also the @ListEnumerator@ class and the @NewEnum@ function.
+    """
+
+    def Next(self, count):
+        result = self._list_[self.index : self.index + count]
+        self.Skip(count)
+        return map(self._wrap, result)
+
+
+def NewEnum(
+    seq,
+    cls=ListEnumerator,
+    iid=pythoncom.IID_IEnumVARIANT,
+    usePolicy=None,
+    useDispatcher=None,
+):
+    """Creates a new enumerator COM server.
+
+    This function creates a new COM Server that implements the
+    IID_IEnumVARIANT interface.
+
+    A COM server that can enumerate the passed in sequence will be
+    created, then wrapped up for return through the COM framework.
+    Optionally, a custom COM server for enumeration can be passed
+    (the default is @ListEnumerator@), and the specific IEnum
+    interface can be specified.
+    """
+    ob = cls(seq, iid=iid)
+    return wrap(ob, iid, usePolicy=usePolicy, useDispatcher=useDispatcher)
+
+
+class Collection:
+    "A collection of VARIANT values."
+
+    _public_methods_ = ["Item", "Count", "Add", "Remove", "Insert"]
+
+    def __init__(self, data=None, readOnly=0):
+        if data is None:
+            data = []
+        self.data = data
+
+        # disable Add/Remove if read-only. note that we adjust _public_methods_
+        # on this instance only.
+        if readOnly:
+            self._public_methods_ = ["Item", "Count"]
+
+    # This method is also used as the "default" method.
+    # Thus "print ob" will cause this to be called with zero
+    # params.  Handle this slightly more elegantly here.
+    # Ideally the  policy should handle this.
+    def Item(self, *args):
+        if len(args) != 1:
+            raise COMException(scode=winerror.DISP_E_BADPARAMCOUNT)
+
+        try:
+            return self.data[args[0]]
+        except IndexError as desc:
+            raise COMException(scode=winerror.DISP_E_BADINDEX, desc=str(desc))
+
+    _value_ = Item
+
+    def Count(self):
+        return len(self.data)
+
+    def Add(self, value):
+        self.data.append(value)
+
+    def Remove(self, index):
+        try:
+            del self.data[index]
+        except IndexError as desc:
+            raise COMException(scode=winerror.DISP_E_BADINDEX, desc=str(desc))
+
+    def Insert(self, index, value):
+        try:
+            index = int(index)
+        except (ValueError, TypeError):
+            raise COMException(scode=winerror.DISP_E_TYPEMISMATCH)
+        self.data.insert(index, value)
+
+    def _NewEnum(self):
+        return NewEnum(self.data)
+
+
+def NewCollection(seq, cls=Collection):
+    """Creates a new COM collection object
+
+    This function creates a new COM Server that implements the
+    common collection protocols, including enumeration. (_NewEnum)
+
+    A COM server that can enumerate the passed in sequence will be
+    created, then wrapped up for return through the COM framework.
+    Optionally, a custom COM server for enumeration can be passed
+    (the default is @Collection@).
+    """
+    return pythoncom.WrapObject(
+        policy.DefaultPolicy(cls(seq)), pythoncom.IID_IDispatch, pythoncom.IID_IDispatch
+    )
+
+
+class FileStream:
+    _public_methods_ = ["Read", "Write", "Clone", "CopyTo", "Seek"]
+    _com_interfaces_ = [pythoncom.IID_IStream]
+
+    def __init__(self, file):
+        self.file = file
+
+    def Read(self, amount):
+        return self.file.read(amount)
+
+    def Write(self, data):
+        self.file.write(data)
+        return len(data)
+
+    def Clone(self):
+        return self._wrap(self.__class__(self.file))
+
+    def CopyTo(self, dest, cb):
+        data = self.file.read(cb)
+        cbread = len(data)
+        dest.Write(data)  ## ??? Write does not currently return the length ???
+        return cbread, cbread
+
+    def Seek(self, offset, origin):
+        # how convient that the 'origin' values are the same as the CRT :)
+        self.file.seek(offset, origin)
+        return self.file.tell()
+
+    def _wrap(self, ob):
+        return wrap(ob)
diff --git a/lib/win32com/servers/PythonTools.py b/lib/win32com/servers/PythonTools.py
new file mode 100644
index 00000000..7f8f4d76
--- /dev/null
+++ b/lib/win32com/servers/PythonTools.py
@@ -0,0 +1,47 @@
+import sys
+import time
+
+
+class Tools:
+    _public_methods_ = ["reload", "adddir", "echo", "sleep"]
+
+    def reload(self, module):
+        if module in sys.modules:
+            from importlib import reload
+
+            reload(sys.modules[module])
+            return "reload succeeded."
+        return "no reload performed."
+
+    def adddir(self, dir):
+        if type(dir) == type(""):
+            sys.path.append(dir)
+        return str(sys.path)
+
+    def echo(self, arg):
+        return repr(arg)
+
+    def sleep(self, t):
+        time.sleep(t)
+
+
+if __name__ == "__main__":
+    from win32com.server.register import RegisterServer, UnregisterServer
+
+    clsid = "{06ce7630-1d81-11d0-ae37-c2fa70000000}"
+    progid = "Python.Tools"
+    verprogid = "Python.Tools.1"
+    if "--unregister" in sys.argv:
+        print("Unregistering...")
+        UnregisterServer(clsid, progid, verprogid)
+        print("Unregistered OK")
+    else:
+        print("Registering COM server...")
+        RegisterServer(
+            clsid,
+            "win32com.servers.PythonTools.Tools",
+            "Python Tools",
+            progid,
+            verprogid,
+        )
+        print("Class registered.")
diff --git a/lib/win32com/servers/__init__.py b/lib/win32com/servers/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/lib/win32com/servers/dictionary.py b/lib/win32com/servers/dictionary.py
new file mode 100644
index 00000000..28596b81
--- /dev/null
+++ b/lib/win32com/servers/dictionary.py
@@ -0,0 +1,137 @@
+"""Python.Dictionary COM Server.
+
+This module implements a simple COM server that acts much like a Python
+dictionary or as a standard string-keyed VB Collection.  The keys of
+the dictionary are strings and are case-insensitive.
+
+It uses a highly customized policy to fine-tune the behavior exposed to
+the COM client.
+
+The object exposes the following properties:
+
+    int Count                       (readonly)
+    VARIANT Item(BSTR key)          (propget for Item)
+    Item(BSTR key, VARIANT value)   (propput for Item)
+
+    Note that 'Item' is the default property, so the following forms of
+    VB code are acceptable:
+
+        set ob = CreateObject("Python.Dictionary")
+        ob("hello") = "there"
+        ob.Item("hi") = ob("HELLO")
+
+All keys are defined, returning VT_NULL (None) if a value has not been
+stored.  To delete a key, simply assign VT_NULL to the key.
+
+The object responds to the _NewEnum method by returning an enumerator over
+the dictionary's keys. This allows for the following type of VB code:
+
+    for each name in ob
+        debug.print name, ob(name)
+    next
+"""
+
+
+import pythoncom
+import pywintypes
+import winerror
+from pythoncom import DISPATCH_METHOD, DISPATCH_PROPERTYGET
+from win32com.server import policy, util
+from win32com.server.exception import COMException
+from winerror import S_OK
+
+
+class DictionaryPolicy(policy.BasicWrapPolicy):
+    ### BasicWrapPolicy looks for this
+    _com_interfaces_ = []
+
+    ### BasicWrapPolicy looks for this
+    _name_to_dispid_ = {
+        "item": pythoncom.DISPID_VALUE,
+        "_newenum": pythoncom.DISPID_NEWENUM,
+        "count": 1,
+    }
+
+    ### Auto-Registration process looks for these...
+    _reg_desc_ = "Python Dictionary"
+    _reg_clsid_ = "{39b61048-c755-11d0-86fa-00c04fc2e03e}"
+    _reg_progid_ = "Python.Dictionary"
+    _reg_verprogid_ = "Python.Dictionary.1"
+    _reg_policy_spec_ = "win32com.servers.dictionary.DictionaryPolicy"
+
+    def _CreateInstance_(self, clsid, reqIID):
+        self._wrap_({})
+        return pythoncom.WrapObject(self, reqIID)
+
+    def _wrap_(self, ob):
+        self._obj_ = ob  # ob should be a dictionary
+
+    def _invokeex_(self, dispid, lcid, wFlags, args, kwargs, serviceProvider):
+        if dispid == 0:  # item
+            l = len(args)
+            if l < 1:
+                raise COMException(
+                    desc="not enough parameters", scode=winerror.DISP_E_BADPARAMCOUNT
+                )
+
+            key = args[0]
+            if type(key) not in [str, str]:
+                ### the nArgErr thing should be 0-based, not reversed... sigh
+                raise COMException(
+                    desc="Key must be a string", scode=winerror.DISP_E_TYPEMISMATCH
+                )
+
+            key = key.lower()
+
+            if wFlags & (DISPATCH_METHOD | DISPATCH_PROPERTYGET):
+                if l > 1:
+                    raise COMException(scode=winerror.DISP_E_BADPARAMCOUNT)
+                try:
+                    return self._obj_[key]
+                except KeyError:
+                    return None  # unknown keys return None (VT_NULL)
+
+            if l != 2:
+                raise COMException(scode=winerror.DISP_E_BADPARAMCOUNT)
+            if args[1] is None:
+                # delete a key when None is assigned to it
+                try:
+                    del self._obj_[key]
+                except KeyError:
+                    pass
+            else:
+                self._obj_[key] = args[1]
+            return S_OK
+
+        if dispid == 1:  # count
+            if not wFlags & DISPATCH_PROPERTYGET:
+                raise COMException(scode=winerror.DISP_E_MEMBERNOTFOUND)  # not found
+            if len(args) != 0:
+                raise COMException(scode=winerror.DISP_E_BADPARAMCOUNT)
+            return len(self._obj_)
+
+        if dispid == pythoncom.DISPID_NEWENUM:
+            return util.NewEnum(list(self._obj_.keys()))
+
+        raise COMException(scode=winerror.DISP_E_MEMBERNOTFOUND)
+
+    def _getidsofnames_(self, names, lcid):
+        ### this is a copy of MappedWrapPolicy._getidsofnames_ ...
+
+        name = names[0].lower()
+        try:
+            return (self._name_to_dispid_[name],)
+        except KeyError:
+            raise COMException(
+                scode=winerror.DISP_E_MEMBERNOTFOUND, desc="Member not found"
+            )
+
+
+def Register():
+    from win32com.server.register import UseCommandLine
+
+    return UseCommandLine(DictionaryPolicy)
+
+
+if __name__ == "__main__":
+    Register()
diff --git a/lib/win32com/servers/interp.py b/lib/win32com/servers/interp.py
new file mode 100644
index 00000000..b15cede7
--- /dev/null
+++ b/lib/win32com/servers/interp.py
@@ -0,0 +1,55 @@
+"""Python.Interpreter COM Server
+
+  This module implements a very very simple COM server which
+  exposes the Python interpreter.
+
+  This is designed more as a demonstration than a full blown COM server.
+  General functionality and Error handling are both limited.
+
+  To use this object, ensure it is registered by running this module
+  from Python.exe.  Then, from Visual Basic, use "CreateObject('Python.Interpreter')",
+  and call its methods!
+"""
+
+import winerror
+from win32com.server.exception import Exception
+
+
+# Expose the Python interpreter.
+class Interpreter:
+    """The interpreter object exposed via COM"""
+
+    _public_methods_ = ["Exec", "Eval"]
+    # All registration stuff to support fully automatic register/unregister
+    _reg_verprogid_ = "Python.Interpreter.2"
+    _reg_progid_ = "Python.Interpreter"
+    _reg_desc_ = "Python Interpreter"
+    _reg_clsid_ = "{30BD3490-2632-11cf-AD5B-524153480001}"
+    _reg_class_spec_ = "win32com.servers.interp.Interpreter"
+
+    def __init__(self):
+        self.dict = {}
+
+    def Eval(self, exp):
+        """Evaluate an expression."""
+        if type(exp) != str:
+            raise Exception(desc="Must be a string", scode=winerror.DISP_E_TYPEMISMATCH)
+
+        return eval(str(exp), self.dict)
+
+    def Exec(self, exp):
+        """Execute a statement."""
+        if type(exp) != str:
+            raise Exception(desc="Must be a string", scode=winerror.DISP_E_TYPEMISMATCH)
+        exec(str(exp), self.dict)
+
+
+def Register():
+    import win32com.server.register
+
+    return win32com.server.register.UseCommandLine(Interpreter)
+
+
+if __name__ == "__main__":
+    print("Registering COM server...")
+    Register()
diff --git a/lib/win32com/servers/perfmon.py b/lib/win32com/servers/perfmon.py
new file mode 100644
index 00000000..861c6940
--- /dev/null
+++ b/lib/win32com/servers/perfmon.py
@@ -0,0 +1,34 @@
+"""A COM Server which exposes the NT Performance monitor in a very rudimentary way
+
+Usage from VB:
+	set ob = CreateObject("Python.PerfmonQuery")
+	freeBytes = ob.Query("Memory", "Available Bytes")
+"""
+import pythoncom
+import win32pdhutil
+import winerror
+from win32com.server import exception, register
+
+
+class PerfMonQuery:
+    _reg_verprogid_ = "Python.PerfmonQuery.1"
+    _reg_progid_ = "Python.PerfmonQuery"
+    _reg_desc_ = "Python Performance Monitor query object"
+    _reg_clsid_ = "{64cef7a0-8ece-11d1-a65a-00aa00125a98}"
+    _reg_class_spec_ = "win32com.servers.perfmon.PerfMonQuery"
+    _public_methods_ = ["Query"]
+
+    def Query(self, object, counter, instance=None, machine=None):
+        try:
+            return win32pdhutil.GetPerformanceAttributes(
+                object, counter, instance, machine=machine
+            )
+        except win32pdhutil.error as exc:
+            raise exception.Exception(desc=exc.strerror)
+        except TypeError as desc:
+            raise exception.Exception(desc=desc, scode=winerror.DISP_E_TYPEMISMATCH)
+
+
+if __name__ == "__main__":
+    print("Registering COM server...")
+    register.UseCommandLine(PerfMonQuery)
diff --git a/lib/win32com/servers/test_pycomtest.py b/lib/win32com/servers/test_pycomtest.py
new file mode 100644
index 00000000..da606efa
--- /dev/null
+++ b/lib/win32com/servers/test_pycomtest.py
@@ -0,0 +1,182 @@
+# This is part of the Python test suite.
+# The object is registered when you first run the test suite.
+# (and hopefully unregistered once done ;-)
+
+import pythoncom
+import winerror
+
+# Ensure the vtables in the tlb are known.
+from win32com import universal
+from win32com.client import constants, gencache
+from win32com.server.exception import COMException
+from win32com.server.util import wrap
+
+pythoncom.__future_currency__ = True
+# We use the constants from the module, so must insist on a gencache.
+# Otherwise, use of gencache is not necessary (tho still advised)
+gencache.EnsureModule("{6BCDCB60-5605-11D0-AE5F-CADD4C000000}", 0, 1, 1)
+
+
+class PyCOMTest:
+    _typelib_guid_ = "{6BCDCB60-5605-11D0-AE5F-CADD4C000000}"
+    _typelib_version = 1, 0
+    _com_interfaces_ = ["IPyCOMTest"]
+    _reg_clsid_ = "{e743d9cd-cb03-4b04-b516-11d3a81c1597}"
+    _reg_progid_ = "Python.Test.PyCOMTest"
+
+    def DoubleString(self, str):
+        return str * 2
+
+    def DoubleInOutString(self, str):
+        return str * 2
+
+    def Fire(self, nID):
+        raise COMException(hresult=winerror.E_NOTIMPL)
+
+    def GetLastVarArgs(self):
+        raise COMException(hresult=winerror.E_NOTIMPL)
+
+    def GetMultipleInterfaces(self, outinterface1, outinterface2):
+        raise COMException(hresult=winerror.E_NOTIMPL)
+
+    def GetSafeArrays(self, attrs, attrs2, ints):
+        raise COMException(hresult=winerror.E_NOTIMPL)
+
+    def GetSetDispatch(self, indisp):
+        raise COMException(hresult=winerror.E_NOTIMPL)
+
+    # Result is of type IPyCOMTest
+    def GetSetInterface(self, ininterface):
+        return wrap(self)
+
+    def GetSetVariant(self, indisp):
+        return indisp
+
+    def TestByRefVariant(self, v):
+        return v * 2
+
+    def TestByRefString(self, v):
+        return v * 2
+
+    # Result is of type IPyCOMTest
+    def GetSetInterfaceArray(self, ininterface):
+        raise COMException(hresult=winerror.E_NOTIMPL)
+
+    def GetSetUnknown(self, inunk):
+        raise COMException(hresult=winerror.E_NOTIMPL)
+
+    # Result is of type ISimpleCounter
+    def GetSimpleCounter(self):
+        raise COMException(hresult=winerror.E_NOTIMPL)
+
+    def GetSimpleSafeArray(self, ints):
+        raise COMException(hresult=winerror.E_NOTIMPL)
+
+    def GetStruct(self):
+        raise COMException(hresult=winerror.E_NOTIMPL)
+
+    def SetIntSafeArray(self, ints):
+        return len(ints)
+
+    def SetLongLongSafeArray(self, ints):
+        return len(ints)
+
+    def SetULongLongSafeArray(self, ints):
+        return len(ints)
+
+    def SetBinSafeArray(self, buf):
+        return len(buf)
+
+    def SetVarArgs(self, *args):
+        raise COMException(hresult=winerror.E_NOTIMPL)
+
+    def SetVariantSafeArray(self, vars):
+        raise COMException(hresult=winerror.E_NOTIMPL)
+
+    def Start(self):
+        raise COMException(hresult=winerror.E_NOTIMPL)
+
+    def Stop(self, nID):
+        raise COMException(hresult=winerror.E_NOTIMPL)
+
+    def StopAll(self):
+        raise COMException(hresult=winerror.E_NOTIMPL)
+
+    def TakeByRefDispatch(self, inout):
+        raise COMException(hresult=winerror.E_NOTIMPL)
+
+    def TakeByRefTypedDispatch(self, inout):
+        raise COMException(hresult=winerror.E_NOTIMPL)
+
+    def Test(self, key, inval):
+        return not inval
+
+    def Test2(self, inval):
+        return inval
+
+    def Test3(self, inval):
+        raise COMException(hresult=winerror.E_NOTIMPL)
+
+    def Test4(self, inval):
+        raise COMException(hresult=winerror.E_NOTIMPL)
+
+    def Test5(self, inout):
+        if inout == constants.TestAttr1:
+            return constants.TestAttr1_1
+        elif inout == constants.TestAttr1_1:
+            return constants.TestAttr1
+        else:
+            return -1
+
+    def Test6(self, inval):
+        return inval
+
+    def TestInOut(self, fval, bval, lval):
+        return winerror.S_OK, fval * 2, not bval, lval * 2
+
+    def TestOptionals(self, strArg="def", sval=0, lval=1, dval=3.1400001049041748):
+        raise COMException(hresult=winerror.E_NOTIMPL)
+
+    def TestOptionals2(self, dval, strval="", sval=1):
+        raise COMException(hresult=winerror.E_NOTIMPL)
+
+    def CheckVariantSafeArray(self, data):
+        return 1
+
+    def LongProp(self):
+        return self.longval
+
+    def SetLongProp(self, val):
+        self.longval = val
+
+    def ULongProp(self):
+        return self.ulongval
+
+    def SetULongProp(self, val):
+        self.ulongval = val
+
+    def IntProp(self):
+        return self.intval
+
+    def SetIntProp(self, val):
+        self.intval = val
+
+
+class PyCOMTestMI(PyCOMTest):
+    _typelib_guid_ = "{6BCDCB60-5605-11D0-AE5F-CADD4C000000}"
+    _typelib_version = 1, 0
+    # Interfaces with a interface name, a real IID, and an IID as a string
+    _com_interfaces_ = [
+        "IPyCOMTest",
+        pythoncom.IID_IStream,
+        str(pythoncom.IID_IStorage),
+    ]
+    _reg_clsid_ = "{F506E9A1-FB46-4238-A597-FA4EB69787CA}"
+    _reg_progid_ = "Python.Test.PyCOMTestMI"
+
+
+if __name__ == "__main__":
+    import win32com.server.register
+
+    win32com.server.register.UseCommandLine(PyCOMTest)
+    win32com.server.register.UseCommandLine(PyCOMTestMI)
diff --git a/lib/win32com/storagecon.py b/lib/win32com/storagecon.py
new file mode 100644
index 00000000..3ed52902
--- /dev/null
+++ b/lib/win32com/storagecon.py
@@ -0,0 +1,142 @@
+"""Constants related to IStorage and related interfaces
+
+This file was generated by h2py from d:\msdev\include\objbase.h
+then hand edited, a few extra constants added, etc.
+"""
+
+STGC_DEFAULT = 0
+STGC_OVERWRITE = 1
+STGC_ONLYIFCURRENT = 2
+STGC_DANGEROUSLYCOMMITMERELYTODISKCACHE = 4
+STGC_CONSOLIDATE = 8
+
+STGTY_STORAGE = 1
+STGTY_STREAM = 2
+STGTY_LOCKBYTES = 3
+STGTY_PROPERTY = 4
+STREAM_SEEK_SET = 0
+STREAM_SEEK_CUR = 1
+STREAM_SEEK_END = 2
+
+LOCK_WRITE = 1
+LOCK_EXCLUSIVE = 2
+LOCK_ONLYONCE = 4
+
+# Generated as from here.
+
+CWCSTORAGENAME = 32
+STGM_DIRECT = 0x00000000
+STGM_TRANSACTED = 0x00010000
+STGM_SIMPLE = 0x08000000
+STGM_READ = 0x00000000
+STGM_WRITE = 0x00000001
+STGM_READWRITE = 0x00000002
+STGM_SHARE_DENY_NONE = 0x00000040
+STGM_SHARE_DENY_READ = 0x00000030
+STGM_SHARE_DENY_WRITE = 0x00000020
+STGM_SHARE_EXCLUSIVE = 0x00000010
+STGM_PRIORITY = 0x00040000
+STGM_DELETEONRELEASE = 0x04000000
+STGM_NOSCRATCH = 0x00100000
+STGM_CREATE = 0x00001000
+STGM_CONVERT = 0x00020000
+STGM_FAILIFTHERE = 0x00000000
+STGM_NOSNAPSHOT = 0x00200000
+ASYNC_MODE_COMPATIBILITY = 0x00000001
+ASYNC_MODE_DEFAULT = 0x00000000
+STGTY_REPEAT = 0x00000100
+STG_TOEND = 0xFFFFFFFF
+STG_LAYOUT_SEQUENTIAL = 0x00000000
+STG_LAYOUT_INTERLEAVED = 0x00000001
+
+## access rights used with COM server ACL's
+COM_RIGHTS_EXECUTE = 1
+COM_RIGHTS_EXECUTE_LOCAL = 2
+COM_RIGHTS_EXECUTE_REMOTE = 4
+COM_RIGHTS_ACTIVATE_LOCAL = 8
+COM_RIGHTS_ACTIVATE_REMOTE = 16
+
+STGFMT_DOCUMENT = 0
+STGFMT_STORAGE = 0
+STGFMT_NATIVE = 1
+STGFMT_FILE = 3
+STGFMT_ANY = 4
+STGFMT_DOCFILE = 5
+
+PID_DICTIONARY = 0
+PID_CODEPAGE = 1
+PID_FIRST_USABLE = 2
+PID_FIRST_NAME_DEFAULT = 4095
+
+PID_LOCALE = -2147483648
+PID_MODIFY_TIME = -2147483647
+PID_SECURITY = -2147483646
+PID_BEHAVIOR = -2147483645
+PID_ILLEGAL = -1
+PID_MIN_READONLY = -2147483648
+PID_MAX_READONLY = -1073741825
+
+## DiscardableInformation
+PIDDI_THUMBNAIL = 0x00000002
+
+## SummaryInformation
+PIDSI_TITLE = 2
+PIDSI_SUBJECT = 3
+PIDSI_AUTHOR = 4
+PIDSI_KEYWORDS = 5
+PIDSI_COMMENTS = 6
+PIDSI_TEMPLATE = 7
+PIDSI_LASTAUTHOR = 8
+PIDSI_REVNUMBER = 9
+PIDSI_EDITTIME = 10
+PIDSI_LASTPRINTED = 11
+PIDSI_CREATE_DTM = 12
+PIDSI_LASTSAVE_DTM = 13
+PIDSI_PAGECOUNT = 14
+PIDSI_WORDCOUNT = 15
+PIDSI_CHARCOUNT = 16
+PIDSI_THUMBNAIL = 17
+PIDSI_APPNAME = 18
+PIDSI_DOC_SECURITY = 19
+
+## DocSummaryInformation
+PIDDSI_CATEGORY = 2
+PIDDSI_PRESFORMAT = 3
+PIDDSI_BYTECOUNT = 4
+PIDDSI_LINECOUNT = 5
+PIDDSI_PARCOUNT = 6
+PIDDSI_SLIDECOUNT = 7
+PIDDSI_NOTECOUNT = 8
+PIDDSI_HIDDENCOUNT = 9
+PIDDSI_MMCLIPCOUNT = 10
+PIDDSI_SCALE = 11
+PIDDSI_HEADINGPAIR = 12
+PIDDSI_DOCPARTS = 13
+PIDDSI_MANAGER = 14
+PIDDSI_COMPANY = 15
+PIDDSI_LINKSDIRTY = 16
+
+
+## MediaFileSummaryInfo
+PIDMSI_EDITOR = 2
+PIDMSI_SUPPLIER = 3
+PIDMSI_SOURCE = 4
+PIDMSI_SEQUENCE_NO = 5
+PIDMSI_PROJECT = 6
+PIDMSI_STATUS = 7
+PIDMSI_OWNER = 8
+PIDMSI_RATING = 9
+PIDMSI_PRODUCTION = 10
+PIDMSI_COPYRIGHT = 11
+
+## PROPSETFLAG enum
+PROPSETFLAG_DEFAULT = 0
+PROPSETFLAG_NONSIMPLE = 1
+PROPSETFLAG_ANSI = 2
+PROPSETFLAG_UNBUFFERED = 4
+PROPSETFLAG_CASE_SENSITIVE = 8
+
+## STGMOVE enum
+STGMOVE_MOVE = 0
+STGMOVE_COPY = 1
+STGMOVE_SHALLOWCOPY = 2
diff --git a/lib/win32com/test/GenTestScripts.py b/lib/win32com/test/GenTestScripts.py
new file mode 100644
index 00000000..73bb2641
--- /dev/null
+++ b/lib/win32com/test/GenTestScripts.py
@@ -0,0 +1,95 @@
+#
+# Generate scripts needed for serious testing!
+#
+import os
+import sys
+
+import pythoncom
+import win32com
+import win32com.client.makepy
+import win32com.test
+
+genList = [
+    ("msword8", "{00020905-0000-0000-C000-000000000046}", 1033, 8, 0),
+]
+
+genDir = "Generated4Test"
+
+
+def GetGenPath():
+    import win32api
+
+    return os.path.join(win32api.GetFullPathName(win32com.test.__path__[0]), genDir)
+
+
+def GenerateFromRegistered(fname, *loadArgs):
+    #       tlb = apply(pythoncom.LoadRegTypeLib, loadArgs)
+    genPath = GetGenPath()
+    try:
+        os.stat(genPath)
+    except os.error:
+        os.mkdir(genPath)
+    # Ensure an __init__ exists.
+    open(os.path.join(genPath, "__init__.py"), "w").close()
+    print(fname, ": generating -", end=" ")
+    f = open(os.path.join(genPath, fname + ".py"), "w")
+    win32com.client.makepy.GenerateFromTypeLibSpec(
+        loadArgs, f, bQuiet=1, bGUIProgress=1
+    )
+    f.close()
+    print("compiling -", end=" ")
+    fullModName = "win32com.test.%s.%s" % (genDir, fname)
+    exec("import " + fullModName)
+    # Inject the generated module as a top level module.
+    sys.modules[fname] = sys.modules[fullModName]
+    print("done")
+
+
+def GenerateAll():
+    for args in genList:
+        try:
+            GenerateFromRegistered(*args)
+        except KeyboardInterrupt:
+            print("** Interrupted ***")
+            break
+        except pythoncom.com_error:
+            print("** Could not generate test code for ", args[0])
+
+
+def CleanAll():
+    print("Cleaning generated test scripts...")
+    try:  # Clear exceptions!
+        1 / 0
+    except:
+        pass
+    genPath = GetGenPath()
+    for args in genList:
+        try:
+            name = args[0] + ".py"
+            os.unlink(os.path.join(genPath, name))
+        except os.error as details:
+            if type(details) == type(()) and details[0] != 2:
+                print("Could not deleted generated", name, details)
+        try:
+            name = args[0] + ".pyc"
+            os.unlink(os.path.join(genPath, name))
+        except os.error as details:
+            if type(details) == type(()) and details[0] != 2:
+                print("Could not deleted generated", name, details)
+        try:
+            os.unlink(os.path.join(genPath, "__init__.py"))
+        except:
+            pass
+        try:
+            os.unlink(os.path.join(genPath, "__init__.pyc"))
+        except:
+            pass
+    try:
+        os.rmdir(genPath)
+    except os.error as details:
+        print("Could not delete test directory -", details)
+
+
+if __name__ == "__main__":
+    GenerateAll()
+    CleanAll()
diff --git a/lib/win32com/test/Testpys.sct b/lib/win32com/test/Testpys.sct
new file mode 100644
index 00000000..dd9b4e00
--- /dev/null
+++ b/lib/win32com/test/Testpys.sct
@@ -0,0 +1,64 @@
+<scriptlet>
+
+<Registration
+  Description="TestPys"
+  ProgID="TestPys.Scriptlet"
+  Version="1"
+  ClassID="{2eeb6080-cd58-11d1-b81e-00a0240b2fef}">
+
+  <SCRIPT LANGUAGE="VBScript">      
+	Function Register()
+		Msgbox "Scriptlet 'Test' registered."      
+	End Function
+    
+	Function Unregister()
+		Msgbox "Scriptlet 'Test' unregistered."      
+	End Function
+   </SCRIPT>
+</Registration>
+
+<implements id=Automation type=Automation>
+  <property name=PyProp1>
+    <get/>
+    <put/>
+  </property>
+  <property name=PyProp2>
+    <get/>
+    <put/>
+  </property>
+  <method name=PyMethod1>
+  </method>
+
+  <method name=PyMethod2>
+  </method>
+</implements>
+
+<script language=python>
+
+PyProp1 = "PyScript Property1";
+PyProp2 = "PyScript Property2";
+
+def get_PyProp1():
+  return PyProp1
+
+def put_PyProp1(newValue):
+  global PyProp1
+  PyProp1 = newValue
+
+def get_PyProp2():
+  return PyProp2
+
+def put_PyProp2(newValue):
+  global PyProp2
+  PyProp2 = newValue
+
+def PyMethod1():
+  return "PyMethod1 called"
+
+def PyMethod2():
+  return "PyMethod2 called"
+
+</script>
+
+</scriptlet>
+
diff --git a/lib/win32com/test/__init__.py b/lib/win32com/test/__init__.py
new file mode 100644
index 00000000..cb6d7f47
--- /dev/null
+++ b/lib/win32com/test/__init__.py
@@ -0,0 +1 @@
+# Empty file to designate a Python package
diff --git a/lib/win32com/test/daodump.py b/lib/win32com/test/daodump.py
new file mode 100644
index 00000000..c222087a
--- /dev/null
+++ b/lib/win32com/test/daodump.py
@@ -0,0 +1,90 @@
+# import dao3032
+# No longer imported here - callers responsibility to load
+#
+import win32com.client
+
+
+def DumpDB(db, bDeep=1):
+    # MUST be a DB object.
+    DumpTables(db, bDeep)
+    DumpRelations(db, bDeep)
+    DumpAllContainers(db, bDeep)
+
+
+def DumpTables(db, bDeep=1):
+    for tab in db.TableDefs:
+        tab = db.TableDefs(tab.Name)  # Redundant lookup for testing purposes.
+        print(
+            "Table %s - Fields: %d, Attributes:%d"
+            % (tab.Name, len(tab.Fields), tab.Attributes)
+        )
+        if bDeep:
+            DumpFields(tab.Fields)
+
+
+def DumpFields(fields):
+    for field in fields:
+        print(
+            "  %s, size=%d, reqd=%d, type=%d, defVal=%s"
+            % (
+                field.Name,
+                field.Size,
+                field.Required,
+                field.Type,
+                str(field.DefaultValue),
+            )
+        )
+
+
+def DumpRelations(db, bDeep=1):
+    for relation in db.Relations:
+        print(
+            "Relation %s - %s->%s"
+            % (relation.Name, relation.Table, relation.ForeignTable)
+        )
+
+
+#### This dont work.  TLB says it is a Fields collection, but apparently not!
+####            if bDeep: DumpFields(relation.Fields)
+
+
+def DumpAllContainers(db, bDeep=1):
+    for cont in db.Containers:
+        print("Container %s - %d documents" % (cont.Name, len(cont.Documents)))
+        if bDeep:
+            DumpContainerDocuments(cont)
+
+
+def DumpContainerDocuments(container):
+    for doc in container.Documents:
+        import time
+
+        timeStr = time.ctime(int(doc.LastUpdated))
+        print("  %s - updated %s (" % (doc.Name, timeStr), end=" ")
+        print(doc.LastUpdated, ")")  # test the _print_ method?
+
+
+def TestEngine(engine):
+    import sys
+
+    if len(sys.argv) > 1:
+        dbName = sys.argv[1]
+    else:
+        dbName = "e:\\temp\\TestPython.mdb"
+    db = engine.OpenDatabase(dbName)
+    DumpDB(db)
+
+
+def test():
+    for progid in ("DAO.DBEngine.36", "DAO.DBEngine.35", "DAO.DBEngine.30"):
+        try:
+            ob = win32com.client.gencache.EnsureDispatch(progid)
+        except pythoncom.com_error:
+            print(progid, "does not seem to be installed")
+        else:
+            TestEngine(ob)
+            break
+
+
+if __name__ == "__main__":
+    test()
diff --git a/lib/win32com/test/errorSemantics.py b/lib/win32com/test/errorSemantics.py
new file mode 100644
index 00000000..49ebae2f
--- /dev/null
+++ b/lib/win32com/test/errorSemantics.py
@@ -0,0 +1,259 @@
+# errorSemantics.py
+
+# Test the Python error handling semantics.  Specifically:
+#
+# * When a Python COM object is called via IDispatch, the nominated
+#   scode is placed in the exception tuple, and the HRESULT is
+#   DISP_E_EXCEPTION
+# * When the same interface is called via IWhatever, the
+#   nominated  scode is returned directly (with the scode also
+#   reflected in the exception tuple)
+# * In all cases, the description etc end up in the exception tuple
+# * "Normal" Python exceptions resolve to an E_FAIL "internal error"
+
+import pythoncom
+import winerror
+from win32com.client import Dispatch
+from win32com.server.exception import COMException
+from win32com.server.util import wrap
+from win32com.test.util import CaptureWriter
+
+
+class error(Exception):
+    def __init__(self, msg, com_exception=None):
+        Exception.__init__(self, msg, str(com_exception))
+
+
+# Our COM server.
+class TestServer:
+    _public_methods_ = ["Clone", "Commit", "LockRegion", "Read"]
+    _com_interfaces_ = [pythoncom.IID_IStream]
+
+    def Clone(self):
+        raise COMException("Not today", scode=winerror.E_UNEXPECTED)
+
+    def Commit(self, flags):
+        # Testing unicode: 1F600   '😀'; GRINNING FACE
+        # Use the 'name' just for fun!
+        if flags == 0:
+            # A non com-specific exception.
+            raise Exception("\N{GRINNING FACE}")
+        # An explicit com_error, which is a bit of an edge-case, but might happen if
+        # a COM server itself calls another COM object and it fails.
+        excepinfo = (
+            winerror.E_UNEXPECTED,
+            "source",
+            "\N{GRINNING FACE}",
+            "helpfile",
+            1,
+            winerror.E_FAIL,
+        )
+        raise pythoncom.com_error(winerror.E_UNEXPECTED, "desc", excepinfo, None)
+
+
+def test():
+    # Call via a native interface.
+    com_server = wrap(TestServer(), pythoncom.IID_IStream)
+    try:
+        com_server.Clone()
+        raise error("Expecting this call to fail!")
+    except pythoncom.com_error as com_exc:
+        if com_exc.hresult != winerror.E_UNEXPECTED:
+            raise error(
+                "Calling the object natively did not yield the correct scode", com_exc
+            )
+        exc = com_exc.excepinfo
+        if not exc or exc[-1] != winerror.E_UNEXPECTED:
+            raise error(
+                "The scode element of the exception tuple did not yield the correct scode",
+                com_exc,
+            )
+        if exc[2] != "Not today":
+            raise error(
+                "The description in the exception tuple did not yield the correct string",
+                com_exc,
+            )
+    cap = CaptureWriter()
+    try:
+        cap.capture()
+        try:
+            com_server.Commit(0)
+        finally:
+            cap.release()
+        raise error("Expecting this call to fail!")
+    except pythoncom.com_error as com_exc:
+        if com_exc.hresult != winerror.E_FAIL:
+            raise error("The hresult was not E_FAIL for an internal error", com_exc)
+        if com_exc.excepinfo[1] != "Python COM Server Internal Error":
+            raise error(
+                "The description in the exception tuple did not yield the correct string",
+                com_exc,
+            )
+    # Check we saw a traceback in stderr
+    if cap.get_captured().find("Traceback") < 0:
+        raise error("Could not find a traceback in stderr: %r" % (cap.get_captured(),))
+
+    # Now do it all again, but using IDispatch
+    com_server = Dispatch(wrap(TestServer()))
+    try:
+        com_server.Clone()
+        raise error("Expecting this call to fail!")
+    except pythoncom.com_error as com_exc:
+        if com_exc.hresult != winerror.DISP_E_EXCEPTION:
+            raise error(
+                "Calling the object via IDispatch did not yield the correct scode",
+                com_exc,
+            )
+        exc = com_exc.excepinfo
+        if not exc or exc[-1] != winerror.E_UNEXPECTED:
+            raise error(
+                "The scode element of the exception tuple did not yield the correct scode",
+                com_exc,
+            )
+        if exc[2] != "Not today":
+            raise error(
+                "The description in the exception tuple did not yield the correct string",
+                com_exc,
+            )
+
+    cap.clear()
+    try:
+        cap.capture()
+        try:
+            com_server.Commit(0)
+        finally:
+            cap.release()
+        raise error("Expecting this call to fail!")
+    except pythoncom.com_error as com_exc:
+        if com_exc.hresult != winerror.DISP_E_EXCEPTION:
+            raise error(
+                "Calling the object via IDispatch did not yield the correct scode",
+                com_exc,
+            )
+        exc = com_exc.excepinfo
+        if not exc or exc[-1] != winerror.E_FAIL:
+            raise error(
+                "The scode element of the exception tuple did not yield the correct scode",
+                com_exc,
+            )
+        if exc[1] != "Python COM Server Internal Error":
+            raise error(
+                "The description in the exception tuple did not yield the correct string",
+                com_exc,
+            )
+    # Check we saw a traceback in stderr
+    if cap.get_captured().find("Traceback") < 0:
+        raise error("Could not find a traceback in stderr: %r" % (cap.get_captured(),))
+
+    # And an explicit com_error
+    cap.clear()
+    try:
+        cap.capture()
+        try:
+            com_server.Commit(1)
+        finally:
+            cap.release()
+        raise error("Expecting this call to fail!")
+    except pythoncom.com_error as com_exc:
+        if com_exc.hresult != winerror.DISP_E_EXCEPTION:
+            raise error(
+                "Calling the object via IDispatch did not yield the correct scode",
+                com_exc,
+            )
+        exc = com_exc.excepinfo
+        if not exc or exc[-1] != winerror.E_FAIL:
+            raise error(
+                "The scode element of the exception tuple did not yield the correct scode",
+                com_exc,
+            )
+        if exc[1] != "source":
+            raise error(
+                "The source in the exception tuple did not yield the correct string",
+                com_exc,
+            )
+        if exc[2] != "\U0001F600":
+            raise error(
+                "The description in the exception tuple did not yield the correct string",
+                com_exc,
+            )
+        if exc[3] != "helpfile":
+            raise error(
+                "The helpfile in the exception tuple did not yield the correct string",
+                com_exc,
+            )
+        if exc[4] != 1:
+            raise error(
+                "The help context in the exception tuple did not yield the correct string",
+                com_exc,
+            )
+
+
+try:
+    import logging
+except ImportError:
+    logging = None
+if logging is not None:
+    import win32com
+
+    class TestLogHandler(logging.Handler):
+        def __init__(self):
+            self.reset()
+            logging.Handler.__init__(self)
+
+        def reset(self):
+            self.num_emits = 0
+            self.last_record = None
+
+        def emit(self, record):
+            self.num_emits += 1
+            self.last_record = self.format(record)
+            return
+            print("--- record start")
+            print(self.last_record)
+            print("--- record end")
+
+    def testLogger():
+        assert not hasattr(win32com, "logger")
+        handler = TestLogHandler()
+        formatter = logging.Formatter("%(message)s")
+        handler.setFormatter(formatter)
+        log = logging.getLogger("win32com_test")
+        log.addHandler(handler)
+        win32com.logger = log
+        # Now throw some exceptions!
+        # Native interfaces
+        com_server = wrap(TestServer(), pythoncom.IID_IStream)
+        try:
+            com_server.Commit(0)
+            raise RuntimeError("should have failed")
+        except pythoncom.error as exc:
+            # `excepinfo` is a tuple with elt 2 being the traceback we captured.
+            message = exc.excepinfo[2]
+            assert message.endswith("Exception: \U0001F600\n")
+        assert handler.num_emits == 1, handler.num_emits
+        assert handler.last_record.startswith(
+            "pythoncom error: Unexpected exception in gateway method 'Commit'"
+        )
+        handler.reset()
+
+        # IDispatch
+        com_server = Dispatch(wrap(TestServer()))
+        try:
+            com_server.Commit(0)
+            raise RuntimeError("should have failed")
+        except pythoncom.error as exc:
+            # `excepinfo` is a tuple with elt 2 being the traceback we captured.
+            message = exc.excepinfo[2]
+            assert message.endswith("Exception: \U0001F600\n")
+        assert handler.num_emits == 1, handler.num_emits
+        handler.reset()
+
+
+if __name__ == "__main__":
+    test()
+    if logging is not None:
+        testLogger()
+    from win32com.test.util import CheckClean
+
+    CheckClean()
+    print("error semantic tests worked")
diff --git a/lib/win32com/test/pippo.idl b/lib/win32com/test/pippo.idl
new file mode 100644
index 00000000..4222684c
--- /dev/null
+++ b/lib/win32com/test/pippo.idl
@@ -0,0 +1,66 @@
+// TestServer.idl : IDL source for TestServer.dll
+//
+
+// This file will be processed by the MIDL tool to
+// produce the type library (TestServer.tlb) and marshalling code.
+
+import "oaidl.idl";
+import "ocidl.idl";
+	[
+		object,
+		uuid(50086EE8-F535-464B-806E-365ADBB727CF),
+		dual,
+		helpstring("ITestServerApp Interface"),
+		pointer_default(unique)
+	]
+	interface ITestServerApp : IDispatch
+	{
+		[id(1), helpstring("method Test1")] HRESULT Test1([out, retval] ITestServerApp **pVal);
+		[id(2), helpstring("method Test2")] HRESULT Test2([out, retval] VARIANT *pVar);
+		[propget, id(3), helpstring("property MyProp1")] HRESULT MyProp1([out, retval] long *pVal);
+	};
+	[
+		object,
+		uuid(618DB2A3-D5BD-4850-B66A-828727EB37E5),
+		dual,
+		helpstring("IPippo Interface"),
+		pointer_default(unique)
+	]
+	interface IPippo : IDispatch
+	{		
+		[id(1), helpstring("method Method1")] HRESULT Method1([out, retval] IPippo **val);
+		[propget, id(2), helpstring("property MyProp1")] HRESULT MyProp1([out, retval] long *pVal);
+		[id(3), helpstring("method Method2")] HRESULT Method2([in] long in1, [in, out] long *inout1,
+		                                                      [out, retval] long *val);
+		[id(4), helpstring("method Method3")] HRESULT Method3([in] VARIANT in1,
+		                                                      [out, retval] VARIANT *val);
+	};
+
+[
+	uuid(7783054E-9A20-4584-8C62-6ED2A08F6AC6),
+	version(1.0),
+	helpstring("TestServer 1.0 Type Library")
+]
+library TESTSERVERLib
+{
+	importlib("stdole32.tlb");
+	importlib("stdole2.tlb");
+	importlib("msado15.dll");
+
+	[
+		uuid(49E44E89-5A72-4456-B1D5-68268A19E798),
+		helpstring("TestServerApp Class")
+	]
+	coclass TestServerApp
+	{
+		[default] interface ITestServerApp;
+	};
+	[
+		uuid(1F0F75D6-BD63-41B9-9F88-2D9D2E1AA5C3),
+		helpstring("Pippo Class")
+	]
+	coclass Pippo
+	{
+		[default] interface IPippo;
+	};
+};
diff --git a/lib/win32com/test/pippo_server.py b/lib/win32com/test/pippo_server.py
new file mode 100644
index 00000000..edcd9168
--- /dev/null
+++ b/lib/win32com/test/pippo_server.py
@@ -0,0 +1,97 @@
+# A little test server, complete with typelib, we can use for testing.
+# Originally submitted with bug:
+# [ 753154 ] memory leak wrapping object having _typelib_guid_ attribute
+# but modified by mhammond for use as part of the test suite.
+import os
+import sys
+
+import pythoncom
+import win32com
+import winerror
+from win32com.server.util import wrap
+
+
+class CPippo:
+    #
+    # COM declarations
+    #
+    _reg_clsid_ = "{1F0F75D6-BD63-41B9-9F88-2D9D2E1AA5C3}"
+    _reg_desc_ = "Pippo Python test object"
+    _reg_progid_ = "Python.Test.Pippo"
+    # _reg_clsctx_ = pythoncom.CLSCTX_LOCAL_SERVER
+    ###
+    ### Link to typelib
+    _typelib_guid_ = "{7783054E-9A20-4584-8C62-6ED2A08F6AC6}"
+    _typelib_version_ = 1, 0
+    _com_interfaces_ = ["IPippo"]
+
+    def __init__(self):
+        self.MyProp1 = 10
+
+    def Method1(self):
+        return wrap(CPippo())
+
+    def Method2(self, in1, inout1):
+        return in1, inout1 * 2
+
+    def Method3(self, in1):
+        # in1 will be a tuple, not a list.
+        # Yet, we are not allowed to return a tuple, but need to convert it to a list first. (Bug?)
+        return list(in1)
+
+
+def BuildTypelib():
+    from distutils.dep_util import newer
+
+    this_dir = os.path.dirname(__file__)
+    idl = os.path.abspath(os.path.join(this_dir, "pippo.idl"))
+    tlb = os.path.splitext(idl)[0] + ".tlb"
+    if newer(idl, tlb):
+        print("Compiling %s" % (idl,))
+        rc = os.system('midl "%s"' % (idl,))
+        if rc:
+            raise RuntimeError("Compiling MIDL failed!")
+        # Can't work out how to prevent MIDL from generating the stubs.
+        # just nuke them
+        for fname in "dlldata.c pippo_i.c pippo_p.c pippo.h".split():
+            os.remove(os.path.join(this_dir, fname))
+
+    print("Registering %s" % (tlb,))
+    tli = pythoncom.LoadTypeLib(tlb)
+    pythoncom.RegisterTypeLib(tli, tlb)
+
+
+def UnregisterTypelib():
+    k = CPippo
+    try:
+        pythoncom.UnRegisterTypeLib(
+            k._typelib_guid_,
+            k._typelib_version_[0],
+            k._typelib_version_[1],
+            0,
+            pythoncom.SYS_WIN32,
+        )
+        print("Unregistered typelib")
+    except pythoncom.error as details:
+        if details[0] == winerror.TYPE_E_REGISTRYACCESS:
+            pass
+        else:
+            raise
+
+
+def main(argv=None):
+    if argv is None:
+        argv = sys.argv[1:]
+    if "--unregister" in argv:
+        # Unregister the type-libraries.
+        UnregisterTypelib()
+    else:
+        # Build and register the type-libraries.
+        BuildTypelib()
+    import win32com.server.register
+
+    win32com.server.register.UseCommandLine(CPippo)
+
+
+if __name__ == "__main__":
+    main(sys.argv)
diff --git a/lib/win32com/test/policySemantics.py b/lib/win32com/test/policySemantics.py
new file mode 100644
index 00000000..746522f7
--- /dev/null
+++ b/lib/win32com/test/policySemantics.py
@@ -0,0 +1,116 @@
+import unittest
+
+import pythoncom
+import win32com.client
+import win32com.server.util
+import win32com.test.util
+import winerror
+
+
+class Error(Exception):
+    pass
+
+
+# An object representing a list of numbers
+class PythonSemanticClass:
+    _public_methods_ = ["In"]  # DISPIDs are allocated.
+    _dispid_to_func_ = {10: "Add", 11: "Remove"}  # DISPIDs specified by the object.
+
+    def __init__(self):
+        self.list = []
+
+    def _NewEnum(self):
+        return win32com.server.util.NewEnum(self.list)
+
+    def _value_(self):
+        # should return an array.
+        return self.list
+
+    def _Evaluate(self):
+        # return the sum
+        return sum(self.list)
+
+    def In(self, value):
+        return value in self.list
+
+    def Add(self, value):
+        self.list.append(value)
+
+    def Remove(self, value):
+        self.list.remove(value)
+
+
+def DispExTest(ob):
+    if not __debug__:
+        print("WARNING: Tests dressed up as assertions are being skipped!")
+    assert ob.GetDispID("Add", 0) == 10, "Policy did not honour the dispid"
+    # Not impl
+    #       assert ob.GetMemberName(10, 0)=="add", "Policy did not give me the correct function for the dispid"
+    assert ob.GetDispID("Remove", 0) == 11, "Policy did not honour the dispid"
+    assert ob.GetDispID("In", 0) == 1000, "Allocated dispid unexpected value"
+    assert (
+        ob.GetDispID("_NewEnum", 0) == pythoncom.DISPID_NEWENUM
+    ), "_NewEnum() got unexpected DISPID"
+    dispids = []
+    dispid = -1
+    while 1:
+        try:
+            dispid = ob.GetNextDispID(0, dispid)
+            dispids.append(dispid)
+        except pythoncom.com_error as xxx_todo_changeme:
+            (hr, desc, exc, arg) = xxx_todo_changeme.args
+            assert hr == winerror.S_FALSE, "Bad result at end of enum"
+            break
+    dispids.sort()
+    if dispids != [pythoncom.DISPID_EVALUATE, pythoncom.DISPID_NEWENUM, 10, 11, 1000]:
+        raise Error("Got back the wrong dispids: %s" % dispids)
+
+
+def SemanticTest(ob):
+    # First just check our object "generally" as expected.
+    ob.Add(1)
+    ob.Add(2)
+    ob.Add(3)
+    # invoke _value_
+    if ob() != (1, 2, 3):
+        raise Error("Bad result - got %s" % (repr(ob())))
+
+    dispob = ob._oleobj_
+
+    rc = dispob.Invoke(
+        pythoncom.DISPID_EVALUATE,
+        0,
+        pythoncom.DISPATCH_METHOD | pythoncom.DISPATCH_PROPERTYGET,
+        1,
+    )
+    if rc != 6:
+        raise Error("Evaluate returned %d" % rc)
+
+
+class Tester(win32com.test.util.TestCase):
+    def setUp(self):
+        debug = 0
+        import win32com.server.dispatcher
+
+        if debug:
+            dispatcher = win32com.server.dispatcher.DefaultDebugDispatcher
+        else:
+            dispatcher = None
+        disp = win32com.server.util.wrap(
+            PythonSemanticClass(), useDispatcher=dispatcher
+        )
+        self.ob = win32com.client.Dispatch(disp)
+
+    def tearDown(self):
+        self.ob = None
+
+    def testSemantics(self):
+        SemanticTest(self.ob)
+
+    def testIDispatchEx(self):
+        dispexob = self.ob._oleobj_.QueryInterface(pythoncom.IID_IDispatchEx)
+        DispExTest(dispexob)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/lib/win32com/test/readme.txt b/lib/win32com/test/readme.txt
new file mode 100644
index 00000000..02edbd55
--- /dev/null
+++ b/lib/win32com/test/readme.txt
@@ -0,0 +1,18 @@
+COM Test Suite Readme
+---------------------
+
+Running the test suite:
+-----------------------
+* Open a command prompt
+* Change to the "win32com\test" directory.
+* run "testall.py".  This will perform level 1 testing.
+  You may specify 1, 2, or 3 on the command line ("testutil 3")
+  to execute more tests.
+
+In general, this should just run the best it can, utilizing what is available
+on the machine.  It is likely some tests will refuse to run due to objects not
+being locally available - this is normal.
+
+The win32com source tree has source code to a C++ and VB component used purely
+for testing.  You may like to build and register these, particularly if you 
+are doing anything related to argument/result handling.
diff --git a/lib/win32com/test/testADOEvents.py b/lib/win32com/test/testADOEvents.py
new file mode 100644
index 00000000..c79b2f7e
--- /dev/null
+++ b/lib/win32com/test/testADOEvents.py
@@ -0,0 +1,100 @@
+import os
+import time
+
+import pythoncom
+from win32com.client import Dispatch, DispatchWithEvents, constants
+
+finished = 0  # Flag for the wait loop from (3) to test
+
+
+class ADOEvents:  # event handler class
+    def OnWillConnect(self, str, user, pw, opt, sts, cn):
+        # Must have this event, as if it is not handled, ADO assumes the
+        # operation is cancelled, and raises an error (Operation cancelled
+        # by the user)
+        pass
+
+    def OnConnectComplete(self, error, status, connection):
+        # Assume no errors, until we have the basic stuff
+        # working. Now, "connection" should be an open
+        # connection to my data source
+        # Do the "something" from (2). For now, just
+        # print the connection data source
+        print("connection is", connection)
+        print("Connected to", connection.Properties("Data Source"))
+        # OK, our work is done. Let the main loop know
+        global finished
+        finished = 1
+
+    def OnCommitTransComplete(self, pError, adStatus, pConnection):
+        pass
+
+    def OnInfoMessage(self, pError, adStatus, pConnection):
+        pass
+
+    def OnDisconnect(self, adStatus, pConnection):
+        pass
+
+    def OnBeginTransComplete(self, TransactionLevel, pError, adStatus, pConnection):
+        pass
+
+    def OnRollbackTransComplete(self, pError, adStatus, pConnection):
+        pass
+
+    def OnExecuteComplete(
+        self, RecordsAffected, pError, adStatus, pCommand, pRecordset, pConnection
+    ):
+        pass
+
+    def OnWillExecute(
+        self,
+        Source,
+        CursorType,
+        LockType,
+        Options,
+        adStatus,
+        pCommand,
+        pRecordset,
+        pConnection,
+    ):
+        pass
+
+
+def TestConnection(dbname):
+    # Create the ADO connection object, and link the event
+    # handlers into it
+    c = DispatchWithEvents("ADODB.Connection", ADOEvents)
+
+    # Initiate the asynchronous open
+    dsn = "Driver={Microsoft Access Driver (*.mdb)};Dbq=%s" % dbname
+    user = "system"
+    pw = "manager"
+    c.Open(dsn, user, pw, constants.adAsyncConnect)
+
+    # Sit in a loop, until our event handler (above) sets the
+    # "finished" flag or we time out.
+    end_time = time.clock() + 10
+    while time.clock() < end_time:
+        # Pump messages so that COM gets a look in
+        pythoncom.PumpWaitingMessages()
+    if not finished:
+        print("XXX - Failed to connect!")
+
+
+def Test():
+    from . import testAccess
+
+    try:
+        testAccess.GenerateSupport()
+    except pythoncom.com_error:
+        print("*** Can not import the MSAccess type libraries - tests skipped")
+        return
+    dbname = testAccess.CreateTestAccessDatabase()
+    try:
+        TestConnection(dbname)
+    finally:
+        os.unlink(dbname)
+
+
+if __name__ == "__main__":
+    Test()
diff --git a/lib/win32com/test/testAXScript.py b/lib/win32com/test/testAXScript.py
new file mode 100644
index 00000000..c37a5aff
--- /dev/null
+++ b/lib/win32com/test/testAXScript.py
@@ -0,0 +1,43 @@
+# Test AXScripting the best we can in an automated fashion...
+import os
+import sys
+
+import win32api
+import win32com.axscript
+import win32com.axscript.client
+import win32com.test.util
+
+verbose = "-v" in sys.argv
+
+
+class AXScript(win32com.test.util.TestCase):
+    def setUp(self):
+        file = win32api.GetFullPathName(
+            os.path.join(win32com.axscript.client.__path__[0], "pyscript.py")
+        )
+        from win32com.test.util import RegisterPythonServer
+
+        self.verbose = verbose
+        RegisterPythonServer(file, "python", verbose=self.verbose)
+
+    def testHost(self):
+        file = win32api.GetFullPathName(
+            os.path.join(win32com.axscript.__path__[0], "test\\testHost.py")
+        )
+        cmd = '%s "%s"' % (win32api.GetModuleFileName(0), file)
+        if verbose:
+            print("Testing Python Scripting host")
+        win32com.test.util.ExecuteShellCommand(cmd, self)
+
+    def testCScript(self):
+        file = win32api.GetFullPathName(
+            os.path.join(win32com.axscript.__path__[0], "Demos\\Client\\wsh\\test.pys")
+        )
+        cmd = 'cscript.exe "%s"' % (file)
+        if verbose:
+            print("Testing Windows Scripting host with Python script")
+        win32com.test.util.ExecuteShellCommand(cmd, self)
+
+
+if __name__ == "__main__":
+    win32com.test.util.testmain()
diff --git a/lib/win32com/test/testAccess.py b/lib/win32com/test/testAccess.py
new file mode 100644
index 00000000..e6fce872
--- /dev/null
+++ b/lib/win32com/test/testAccess.py
@@ -0,0 +1,187 @@
+#
+# This assumes that you have MSAccess and DAO installed.
+#  You need to run makepy.py over "msaccess.tlb" and
+#  "dao3032.dll", and ensure the generated files are on the
+#  path.
+
+# You can run this with no args, and a test database will be generated.
+# You can optionally pass a dbname on the command line, in which case it will be dumped.
+
+import os
+import sys
+
+import pythoncom
+import win32api
+from win32com.client import Dispatch, constants, gencache
+
+
+def CreateTestAccessDatabase(dbname=None):
+    # Creates a test access database - returns the filename.
+    if dbname is None:
+        dbname = os.path.join(win32api.GetTempPath(), "COMTestSuiteTempDatabase.mdb")
+
+    access = Dispatch("Access.Application")
+    dbEngine = access.DBEngine
+    workspace = dbEngine.Workspaces(0)
+
+    try:
+        os.unlink(dbname)
+    except os.error:
+        print(
+            "WARNING - Unable to delete old test database - expect a COM exception RSN!"
+        )
+
+    newdb = workspace.CreateDatabase(
+        dbname, constants.dbLangGeneral, constants.dbEncrypt
+    )
+
+    # Create one test table.
+    table = newdb.CreateTableDef("Test Table 1")
+    table.Fields.Append(table.CreateField("First Name", constants.dbText))
+    table.Fields.Append(table.CreateField("Last Name", constants.dbText))
+
+    index = table.CreateIndex("UniqueIndex")
+    index.Fields.Append(index.CreateField("First Name"))
+    index.Fields.Append(index.CreateField("Last Name"))
+    index.Unique = -1
+    table.Indexes.Append(index)
+
+    newdb.TableDefs.Append(table)
+
+    # Create a second test table.
+    table = newdb.CreateTableDef("Test Table 2")
+    table.Fields.Append(table.CreateField("First Name", constants.dbText))
+    table.Fields.Append(table.CreateField("Last Name", constants.dbText))
+
+    newdb.TableDefs.Append(table)
+
+    # Create a relationship between them
+    relation = newdb.CreateRelation("TestRelationship")
+    relation.Table = "Test Table 1"
+    relation.ForeignTable = "Test Table 2"
+
+    field = relation.CreateField("First Name")
+    field.ForeignName = "First Name"
+    relation.Fields.Append(field)
+
+    field = relation.CreateField("Last Name")
+    field.ForeignName = "Last Name"
+    relation.Fields.Append(field)
+
+    relation.Attributes = (
+        constants.dbRelationDeleteCascade + constants.dbRelationUpdateCascade
+    )
+
+    newdb.Relations.Append(relation)
+
+    # Finally we can add some data to the table.
+    tab1 = newdb.OpenRecordset("Test Table 1")
+    tab1.AddNew()
+    tab1.Fields("First Name").Value = "Mark"
+    tab1.Fields("Last Name").Value = "Hammond"
+    tab1.Update()
+
+    tab1.MoveFirst()
+    # We do a simple bookmark test which tests our optimized VT_SAFEARRAY|VT_UI1 support.
+    # The bookmark will be a buffer object - remember it for later.
+    bk = tab1.Bookmark
+
+    # Add a second record.
+    tab1.AddNew()
+    tab1.Fields("First Name").Value = "Second"
+    tab1.Fields("Last Name").Value = "Person"
+    tab1.Update()
+
+    # Reset the bookmark to the one we saved.
+    # But first check the test is actually doing something!
+    tab1.MoveLast()
+    if tab1.Fields("First Name").Value != "Second":
+        raise RuntimeError("Unexpected record is last - makes bookmark test pointless!")
+
+    tab1.Bookmark = bk
+    if tab1.Bookmark != bk:
+        raise RuntimeError("The bookmark data is not the same")
+
+    if tab1.Fields("First Name").Value != "Mark":
+        raise RuntimeError("The bookmark did not reset the record pointer correctly")
+
+    return dbname
+
+
+def DoDumpAccessInfo(dbname):
+    from . import daodump
+
+    a = forms = None
+    try:
+        sys.stderr.write("Creating Access Application...\n")
+        a = Dispatch("Access.Application")
+        print("Opening database %s" % dbname)
+        a.OpenCurrentDatabase(dbname)
+        db = a.CurrentDb()
+        daodump.DumpDB(db, 1)
+        forms = a.Forms
+        print("There are %d forms open." % (len(forms)))
+        # Uncommenting these lines means Access remains open.
+        #               for form in forms:
+        #                       print " %s" % form.Name
+        reports = a.Reports
+        print("There are %d reports open" % (len(reports)))
+    finally:
+        if not a is None:
+            sys.stderr.write("Closing database\n")
+            try:
+                a.CloseCurrentDatabase()
+            except pythoncom.com_error:
+                pass
+
+
+# Generate all the support we can.
+def GenerateSupport():
+    # dao
+    gencache.EnsureModule("{00025E01-0000-0000-C000-000000000046}", 0, 4, 0)
+    # Access
+    #       gencache.EnsureModule("{4AFFC9A0-5F99-101B-AF4E-00AA003F0F07}", 0, 8, 0)
+    gencache.EnsureDispatch("Access.Application")
+
+
+def DumpAccessInfo(dbname):
+    amod = gencache.GetModuleForProgID("Access.Application")
+    dmod = gencache.GetModuleForProgID("DAO.DBEngine.35")
+    if amod is None and dmod is None:
+        DoDumpAccessInfo(dbname)
+        # Now generate all the support we can.
+        GenerateSupport()
+    else:
+        sys.stderr.write(
+            "testAccess not doing dynamic test, as generated code already exists\n"
+        )
+    # Now a generated version.
+    DoDumpAccessInfo(dbname)
+
+
+def test(dbname=None):
+    if dbname is None:
+        # We need makepy support to create a database (just for the constants!)
+        try:
+            GenerateSupport()
+        except pythoncom.com_error:
+            print("*** Can not import the MSAccess type libraries - tests skipped")
+            return
+        dbname = CreateTestAccessDatabase()
+        print("A test database at '%s' was created" % dbname)
+
+    DumpAccessInfo(dbname)
+
+
+if __name__ == "__main__":
+    import sys
+
+    from .util import CheckClean
+
+    dbname = None
+    if len(sys.argv) > 1:
+        dbname = sys.argv[1]
+
+    test(dbname)
+
+    CheckClean()
diff --git a/lib/win32com/test/testArrays.py b/lib/win32com/test/testArrays.py
new file mode 100644
index 00000000..f395a413
--- /dev/null
+++ b/lib/win32com/test/testArrays.py
@@ -0,0 +1,99 @@
+# Originally contributed by Stefan Schukat as part of this arbitrary-sized
+# arrays patch.
+
+from win32com.client import gencache
+from win32com.test import util
+
+ZeroD = 0
+OneDEmpty = []
+OneD = [1, 2, 3]
+TwoD = [[1, 2, 3], [1, 2, 3], [1, 2, 3]]
+
+TwoD1 = [[[1, 2, 3, 5], [1, 2, 3], [1, 2, 3]], [[1, 2, 3], [1, 2, 3], [1, 2, 3]]]
+
+OneD1 = [[[1, 2, 3], [1, 2, 3], [1, 2, 3]], [[1, 2, 3], [1, 2, 3]]]
+
+OneD2 = [
+    [1, 2, 3],
+    [1, 2, 3, 4, 5],
+    [[1, 2, 3, 4, 5], [1, 2, 3, 4, 5], [1, 2, 3, 4, 5]],
+]
+
+
+ThreeD = [[[1, 2, 3], [1, 2, 3], [1, 2, 3]], [[1, 2, 3], [1, 2, 3], [1, 2, 3]]]
+
+FourD = [
+    [
+        [[1, 2, 3], [1, 2, 3], [1, 2, 3]],
+        [[1, 2, 3], [1, 2, 3], [1, 2, 3]],
+        [[1, 2, 3], [1, 2, 3], [1, 2, 3]],
+    ],
+    [
+        [[1, 2, 3], [1, 2, 3], [1, 2, 3]],
+        [[1, 2, 3], [1, 2, 3], [1, 2, 3]],
+        [[1, 2, 3], [1, 2, 3], [1, 2, 3]],
+    ],
+]
+
+LargeD = [
+    [[list(range(10))] * 10],
+] * 512
+
+
+def _normalize_array(a):
+    if type(a) != type(()):
+        return a
+    ret = []
+    for i in a:
+        ret.append(_normalize_array(i))
+    return ret
+
+
+class ArrayTest(util.TestCase):
+    def setUp(self):
+        self.arr = gencache.EnsureDispatch("PyCOMTest.ArrayTest")
+
+    def tearDown(self):
+        self.arr = None
+
+    def _doTest(self, array):
+        self.arr.Array = array
+        self.assertEqual(_normalize_array(self.arr.Array), array)
+
+    def testZeroD(self):
+        self._doTest(ZeroD)
+
+    def testOneDEmpty(self):
+        self._doTest(OneDEmpty)
+
+    def testOneD(self):
+        self._doTest(OneD)
+
+    def testTwoD(self):
+        self._doTest(TwoD)
+
+    def testThreeD(self):
+        self._doTest(ThreeD)
+
+    def testFourD(self):
+        self._doTest(FourD)
+
+    def testTwoD1(self):
+        self._doTest(TwoD1)
+
+    def testOneD1(self):
+        self._doTest(OneD1)
+
+    def testOneD2(self):
+        self._doTest(OneD2)
+
+    def testLargeD(self):
+        self._doTest(LargeD)
+
+
+if __name__ == "__main__":
+    try:
+        util.testmain()
+    except SystemExit as rc:
+        if not rc:
+            raise
diff --git a/lib/win32com/test/testClipboard.py b/lib/win32com/test/testClipboard.py
new file mode 100644
index 00000000..60df8668
--- /dev/null
+++ b/lib/win32com/test/testClipboard.py
@@ -0,0 +1,170 @@
+# testClipboard.py
+import unittest
+
+import pythoncom
+import win32clipboard
+import win32con
+import winerror
+from win32com.server.exception import COMException
+from win32com.server.util import NewEnum, wrap
+
+IDataObject_Methods = """GetData GetDataHere QueryGetData
+                         GetCanonicalFormatEtc SetData EnumFormatEtc
+                         DAdvise DUnadvise EnumDAdvise""".split()
+
+# A COM object implementing IDataObject used for basic testing.
+num_do_objects = 0
+
+
+def WrapCOMObject(ob, iid=None):
+    return wrap(ob, iid=iid, useDispatcher=0)
+
+
+class TestDataObject:
+    _com_interfaces_ = [pythoncom.IID_IDataObject]
+    _public_methods_ = IDataObject_Methods
+
+    def __init__(self, bytesval):
+        global num_do_objects
+        num_do_objects += 1
+        self.bytesval = bytesval
+        self.supported_fe = []
+        for cf in (win32con.CF_TEXT, win32con.CF_UNICODETEXT):
+            fe = cf, None, pythoncom.DVASPECT_CONTENT, -1, pythoncom.TYMED_HGLOBAL
+            self.supported_fe.append(fe)
+
+    def __del__(self):
+        global num_do_objects
+        num_do_objects -= 1
+
+    def _query_interface_(self, iid):
+        if iid == pythoncom.IID_IEnumFORMATETC:
+            return NewEnum(self.supported_fe, iid=iid)
+
+    def GetData(self, fe):
+        ret_stg = None
+        cf, target, aspect, index, tymed = fe
+        if aspect & pythoncom.DVASPECT_CONTENT and tymed == pythoncom.TYMED_HGLOBAL:
+            if cf == win32con.CF_TEXT:
+                ret_stg = pythoncom.STGMEDIUM()
+                ret_stg.set(pythoncom.TYMED_HGLOBAL, self.bytesval)
+            elif cf == win32con.CF_UNICODETEXT:
+                ret_stg = pythoncom.STGMEDIUM()
+                ret_stg.set(pythoncom.TYMED_HGLOBAL, self.bytesval.decode("latin1"))
+
+        if ret_stg is None:
+            raise COMException(hresult=winerror.E_NOTIMPL)
+        return ret_stg
+
+    def GetDataHere(self, fe):
+        raise COMException(hresult=winerror.E_NOTIMPL)
+
+    def QueryGetData(self, fe):
+        cf, target, aspect, index, tymed = fe
+        if aspect & pythoncom.DVASPECT_CONTENT == 0:
+            raise COMException(hresult=winerror.DV_E_DVASPECT)
+        if tymed != pythoncom.TYMED_HGLOBAL:
+            raise COMException(hresult=winerror.DV_E_TYMED)
+        return None  # should check better
+
+    def GetCanonicalFormatEtc(self, fe):
+        RaiseCOMException(winerror.DATA_S_SAMEFORMATETC)
+        # return fe
+
+    def SetData(self, fe, medium):
+        raise COMException(hresult=winerror.E_NOTIMPL)
+
+    def EnumFormatEtc(self, direction):
+        if direction != pythoncom.DATADIR_GET:
+            raise COMException(hresult=winerror.E_NOTIMPL)
+        return NewEnum(self.supported_fe, iid=pythoncom.IID_IEnumFORMATETC)
+
+    def DAdvise(self, fe, flags, sink):
+        raise COMException(hresult=winerror.E_NOTIMPL)
+
+    def DUnadvise(self, connection):
+        raise COMException(hresult=winerror.E_NOTIMPL)
+
+    def EnumDAdvise(self):
+        raise COMException(hresult=winerror.E_NOTIMPL)
+
+
+class ClipboardTester(unittest.TestCase):
+    def setUp(self):
+        pythoncom.OleInitialize()
+
+    def tearDown(self):
+        try:
+            pythoncom.OleFlushClipboard()
+        except pythoncom.com_error:
+            # We never set anything!
+            pass
+
+    def testIsCurrentClipboard(self):
+        do = TestDataObject(b"Hello from Python")
+        do = WrapCOMObject(do, iid=pythoncom.IID_IDataObject)
+        pythoncom.OleSetClipboard(do)
+        self.assertTrue(pythoncom.OleIsCurrentClipboard(do))
+
+    def testComToWin32(self):
+        # Set the data via our DataObject
+        do = TestDataObject(b"Hello from Python")
+        do = WrapCOMObject(do, iid=pythoncom.IID_IDataObject)
+        pythoncom.OleSetClipboard(do)
+        # Then get it back via the standard win32 clipboard functions.
+        win32clipboard.OpenClipboard()
+        got = win32clipboard.GetClipboardData(win32con.CF_TEXT)
+        # CF_TEXT gives bytes.
+        expected = b"Hello from Python"
+        self.assertEqual(got, expected)
+        # Now check unicode
+        got = win32clipboard.GetClipboardData(win32con.CF_UNICODETEXT)
+        self.assertEqual(got, "Hello from Python")
+        win32clipboard.CloseClipboard()
+
+    def testWin32ToCom(self):
+        # Set the data via the std win32 clipboard functions.
+        val = b"Hello again!"  # always bytes
+        win32clipboard.OpenClipboard()
+        win32clipboard.SetClipboardData(win32con.CF_TEXT, val)
+        win32clipboard.CloseClipboard()
+        # and get it via an IDataObject provided by COM
+        do = pythoncom.OleGetClipboard()
+        cf = (
+            win32con.CF_TEXT,
+            None,
+            pythoncom.DVASPECT_CONTENT,
+            -1,
+            pythoncom.TYMED_HGLOBAL,
+        )
+        stg = do.GetData(cf)
+        got = stg.data
+        # The data we get back has the \0, as our STGMEDIUM has no way of
+        # knowing if it meant to be a string, or a binary buffer, so
+        # it must return it too.
+        self.assertTrue(got, b"Hello again!\0")
+
+    def testDataObjectFlush(self):
+        do = TestDataObject(b"Hello from Python")
+        do = WrapCOMObject(do, iid=pythoncom.IID_IDataObject)
+        pythoncom.OleSetClipboard(do)
+        self.assertEqual(num_do_objects, 1)
+
+        do = None  # clear my ref!
+        pythoncom.OleFlushClipboard()
+        self.assertEqual(num_do_objects, 0)
+
+    def testDataObjectReset(self):
+        do = TestDataObject(b"Hello from Python")
+        do = WrapCOMObject(do)
+        pythoncom.OleSetClipboard(do)
+        do = None  # clear my ref!
+        self.assertEqual(num_do_objects, 1)
+        pythoncom.OleSetClipboard(None)
+        self.assertEqual(num_do_objects, 0)
+
+
+if __name__ == "__main__":
+    from win32com.test import util
+
+    util.testmain()
diff --git a/lib/win32com/test/testCollections.py b/lib/win32com/test/testCollections.py
new file mode 100644
index 00000000..954697e0
--- /dev/null
+++ b/lib/win32com/test/testCollections.py
@@ -0,0 +1,166 @@
+# testCollections.py
+#
+# This code tests both the client and server side of collections
+# and enumerators.
+#
+# Also has the side effect of testing some of the PythonCOM error semantics.
+import sys
+
+import pythoncom
+import pywintypes
+import win32com.client
+import win32com.server.util
+import win32com.test.util
+import winerror
+
+L = pywintypes.Unicode
+
+import unittest
+
+error = "collection test error"
+
+
+def MakeEmptyEnum():
+    # create the Python enumerator object as a real COM object
+    o = win32com.server.util.wrap(win32com.server.util.Collection())
+    return win32com.client.Dispatch(o)
+
+
+def MakeTestEnum():
+    # create a sub-collection, just to make sure it works :-)
+    sub = win32com.server.util.wrap(
+        win32com.server.util.Collection(["Sub1", 2, "Sub3"])
+    )
+    # create the Python enumerator object as a real COM object
+    o = win32com.server.util.wrap(win32com.server.util.Collection([1, "Two", 3, sub]))
+    return win32com.client.Dispatch(o)
+
+
+def TestEnumAgainst(o, check):
+    for i in range(len(check)):
+        if o(i) != check[i]:
+            raise error(
+                "Using default method gave the incorrect value - %s/%s"
+                % (repr(o(i)), repr(check[i]))
+            )
+
+    for i in range(len(check)):
+        if o.Item(i) != check[i]:
+            raise error(
+                "Using Item method gave the incorrect value - %s/%s"
+                % (repr(o(i)), repr(check[i]))
+            )
+
+    # First try looping.
+    cmp = []
+    for s in o:
+        cmp.append(s)
+
+    if cmp[: len(check)] != check:
+        raise error(
+            "Result after looping isnt correct - %s/%s"
+            % (repr(cmp[: len(check)]), repr(check))
+        )
+
+    for i in range(len(check)):
+        if o[i] != check[i]:
+            raise error("Using indexing gave the incorrect value")
+
+
+def TestEnum(quiet=None):
+    if quiet is None:
+        quiet = not "-v" in sys.argv
+    if not quiet:
+        print("Simple enum test")
+    o = MakeTestEnum()
+    check = [1, "Two", 3]
+    TestEnumAgainst(o, check)
+
+    if not quiet:
+        print("sub-collection test")
+    sub = o[3]
+    TestEnumAgainst(sub, ["Sub1", 2, "Sub3"])
+
+    # Remove the sublist for this test!
+    o.Remove(o.Count() - 1)
+
+    if not quiet:
+        print("Remove item test")
+    del check[1]
+    o.Remove(1)
+    TestEnumAgainst(o, check)
+
+    if not quiet:
+        print("Add item test")
+    o.Add("New Item")
+    check.append("New Item")
+    TestEnumAgainst(o, check)
+
+    if not quiet:
+        print("Insert item test")
+    o.Insert(2, -1)
+    check.insert(2, -1)
+    TestEnumAgainst(o, check)
+
+    ### This does not work!
+    #       if not quiet: print "Indexed replace item test"
+    #       o[2] = 'Replaced Item'
+    #       check[2] = 'Replaced Item'
+    #       TestEnumAgainst(o, check)
+
+    try:
+        o()
+        raise error("default method with no args worked when it shouldnt have!")
+    except pythoncom.com_error as exc:
+        if exc.hresult != winerror.DISP_E_BADPARAMCOUNT:
+            raise error("Expected DISP_E_BADPARAMCOUNT - got %s" % (exc,))
+
+    try:
+        o.Insert("foo", 2)
+        raise error("Insert worked when it shouldnt have!")
+    except pythoncom.com_error as exc:
+        if exc.hresult != winerror.DISP_E_TYPEMISMATCH:
+            raise error("Expected DISP_E_TYPEMISMATCH - got %s" % (exc,))
+
+    # Remove the sublist for this test!
+    try:
+        o.Remove(o.Count())
+        raise error("Remove worked when it shouldnt have!")
+    except pythoncom.com_error as exc:
+        if exc.hresult != winerror.DISP_E_BADINDEX:
+            raise error("Expected DISP_E_BADINDEX - got %s" % (exc,))
+
+    # Test an empty collection
+    if not quiet:
+        print("Empty collection test")
+    o = MakeEmptyEnum()
+    for item in o:
+        raise error("Empty list performed an iteration")
+
+    try:
+        ob = o[1]
+        raise error("Empty list could be indexed")
+    except IndexError:
+        pass
+
+    try:
+        ob = o[0]
+        raise error("Empty list could be indexed")
+    except IndexError:
+        pass
+
+    try:
+        ob = o(0)
+        raise error("Empty list could be indexed")
+    except pythoncom.com_error as exc:
+        if exc.hresult != winerror.DISP_E_BADINDEX:
+            raise error("Expected DISP_E_BADINDEX - got %s" % (exc,))
+
+
+class TestCase(win32com.test.util.TestCase):
+    def testEnum(self):
+        TestEnum()
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/lib/win32com/test/testConversionErrors.py b/lib/win32com/test/testConversionErrors.py
new file mode 100644
index 00000000..a4b755e6
--- /dev/null
+++ b/lib/win32com/test/testConversionErrors.py
@@ -0,0 +1,39 @@
+import unittest
+
+import win32com.client
+import win32com.server.util
+import win32com.test.util
+
+
+class Tester:
+    _public_methods_ = ["TestValue"]
+
+    def TestValue(self, v):
+        pass
+
+
+def test_ob():
+    return win32com.client.Dispatch(win32com.server.util.wrap(Tester()))
+
+
+class TestException(Exception):
+    pass
+
+
+# The object we try and pass - pywin32 will call __float__ as a last resort.
+class BadConversions:
+    def __float__(self):
+        raise TestException()
+
+
+class TestCase(win32com.test.util.TestCase):
+    def test_float(self):
+        try:
+            test_ob().TestValue(BadConversions())
+            raise Exception("Should not have worked")
+        except Exception as e:
+            assert isinstance(e, TestException)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/lib/win32com/test/testDCOM.py b/lib/win32com/test/testDCOM.py
new file mode 100644
index 00000000..9f5a334e
--- /dev/null
+++ b/lib/win32com/test/testDCOM.py
@@ -0,0 +1,50 @@
+# testDCOM
+usage = """\
+testDCOM.py - Simple DCOM test
+Usage: testDCOM.py serverName
+
+Attempts to start the Python.Interpreter object on the named machine,
+and checks that the object is indeed running remotely.
+
+Requires the named server be configured to run DCOM (using dcomcnfg.exe),
+and the Python.Interpreter object installed and registered on that machine.
+
+The Python.Interpreter object must be installed on the local machine,
+but no special DCOM configuration should be necessary.
+"""
+import string
+import sys
+
+# NOTE: If you configured the object locally using dcomcnfg, you could
+# simple use Dispatch rather than DispatchEx.
+import pythoncom
+import win32api
+import win32com.client
+
+
+def test(serverName):
+    if string.lower(serverName) == string.lower(win32api.GetComputerName()):
+        print("You must specify a remote server name, not the local machine!")
+        return
+
+    # Hack to overcome a DCOM limitation.  As the Python.Interpreter object
+    # is probably installed locally as an InProc object, DCOM seems to ignore
+    # all settings, and use the local object.
+    clsctx = pythoncom.CLSCTX_SERVER & ~pythoncom.CLSCTX_INPROC_SERVER
+    ob = win32com.client.DispatchEx("Python.Interpreter", serverName, clsctx=clsctx)
+    ob.Exec("import win32api")
+    actualName = ob.Eval("win32api.GetComputerName()")
+    if string.lower(serverName) != string.lower(actualName):
+        print(
+            "Error: The object created on server '%s' reported its name as '%s'"
+            % (serverName, actualName)
+        )
+    else:
+        print("Object created and tested OK on server '%s'" % serverName)
+
+
+if __name__ == "__main__":
+    if len(sys.argv) == 2:
+        test(sys.argv[1])
+    else:
+        print(usage)
diff --git a/lib/win32com/test/testDates.py b/lib/win32com/test/testDates.py
new file mode 100644
index 00000000..00406dda
--- /dev/null
+++ b/lib/win32com/test/testDates.py
@@ -0,0 +1,74 @@
+import unittest
+from datetime import datetime
+
+import pywintypes
+import win32com.client
+import win32com.server.util
+import win32com.test.util
+from win32timezone import TimeZoneInfo
+
+
+# A COM object so we can pass dates to and from the COM boundary.
+class Tester:
+    _public_methods_ = ["TestDate"]
+
+    def TestDate(self, d):
+        assert isinstance(d, datetime)
+        return d
+
+
+def test_ob():
+    return win32com.client.Dispatch(win32com.server.util.wrap(Tester()))
+
+
+class TestCase(win32com.test.util.TestCase):
+    def check(self, d, expected=None):
+        if not issubclass(pywintypes.TimeType, datetime):
+            self.skipTest("this is testing pywintypes and datetime")
+        got = test_ob().TestDate(d)
+        self.assertEqual(got, expected or d)
+
+    def testUTC(self):
+        self.check(
+            datetime(
+                year=2000,
+                month=12,
+                day=25,
+                microsecond=500000,
+                tzinfo=TimeZoneInfo.utc(),
+            )
+        )
+
+    def testLocal(self):
+        self.check(
+            datetime(
+                year=2000,
+                month=12,
+                day=25,
+                microsecond=500000,
+                tzinfo=TimeZoneInfo.local(),
+            )
+        )
+
+    def testMSTruncated(self):
+        # milliseconds are kept but microseconds are lost after rounding.
+        self.check(
+            datetime(
+                year=2000,
+                month=12,
+                day=25,
+                microsecond=500500,
+                tzinfo=TimeZoneInfo.utc(),
+            ),
+            datetime(
+                year=2000,
+                month=12,
+                day=25,
+                microsecond=500000,
+                tzinfo=TimeZoneInfo.utc(),
+            ),
+        )
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/lib/win32com/test/testDictionary.py b/lib/win32com/test/testDictionary.py
new file mode 100644
index 00000000..869cc186
--- /dev/null
+++ b/lib/win32com/test/testDictionary.py
@@ -0,0 +1,99 @@
+# testDictionary.py
+#
+import sys
+import unittest
+
+import pythoncom
+import pywintypes
+import win32com.client
+import win32com.server.util
+import win32com.test.util
+import win32timezone
+import winerror
+
+
+def MakeTestDictionary():
+    return win32com.client.Dispatch("Python.Dictionary")
+
+
+def TestDictAgainst(dict, check):
+    for key, value in list(check.items()):
+        if dict(key) != value:
+            raise Exception(
+                "Indexing for '%s' gave the incorrect value - %s/%s"
+                % (repr(key), repr(dict[key]), repr(check[key]))
+            )
+
+
+# Ensure we have the correct version registered.
+def Register(quiet):
+    import win32com.servers.dictionary
+    from win32com.test.util import RegisterPythonServer
+
+    RegisterPythonServer(win32com.servers.dictionary.__file__, "Python.Dictionary")
+
+
+def TestDict(quiet=None):
+    if quiet is None:
+        quiet = not "-v" in sys.argv
+    Register(quiet)
+
+    if not quiet:
+        print("Simple enum test")
+    dict = MakeTestDictionary()
+    checkDict = {}
+    TestDictAgainst(dict, checkDict)
+
+    dict["NewKey"] = "NewValue"
+    checkDict["NewKey"] = "NewValue"
+    TestDictAgainst(dict, checkDict)
+
+    dict["NewKey"] = None
+    del checkDict["NewKey"]
+    TestDictAgainst(dict, checkDict)
+
+    now = win32timezone.now()
+    # We want to keep the milliseconds but discard microseconds as they
+    # don't survive the conversion.
+    now = now.replace(microsecond=round(now.microsecond / 1000) * 1000)
+    dict["Now"] = now
+    checkDict["Now"] = now
+    TestDictAgainst(dict, checkDict)
+
+    if not quiet:
+        print("Failure tests")
+    try:
+        dict()
+        raise Exception("default method with no args worked when it shouldnt have!")
+    except pythoncom.com_error as xxx_todo_changeme:
+        (hr, desc, exc, argErr) = xxx_todo_changeme.args
+        if hr != winerror.DISP_E_BADPARAMCOUNT:
+            raise Exception("Expected DISP_E_BADPARAMCOUNT - got %d (%s)" % (hr, desc))
+
+    try:
+        dict("hi", "there")
+        raise Exception("multiple args worked when it shouldnt have!")
+    except pythoncom.com_error as xxx_todo_changeme1:
+        (hr, desc, exc, argErr) = xxx_todo_changeme1.args
+        if hr != winerror.DISP_E_BADPARAMCOUNT:
+            raise Exception("Expected DISP_E_BADPARAMCOUNT - got %d (%s)" % (hr, desc))
+
+    try:
+        dict(0)
+        raise Exception("int key worked when it shouldnt have!")
+    except pythoncom.com_error as xxx_todo_changeme2:
+        (hr, desc, exc, argErr) = xxx_todo_changeme2.args
+        if hr != winerror.DISP_E_TYPEMISMATCH:
+            raise Exception("Expected DISP_E_TYPEMISMATCH - got %d (%s)" % (hr, desc))
+
+    if not quiet:
+        print("Python.Dictionary tests complete.")
+
+
+class TestCase(win32com.test.util.TestCase):
+    def testDict(self):
+        TestDict()
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/lib/win32com/test/testDictionary.vbs b/lib/win32com/test/testDictionary.vbs
new file mode 100644
index 00000000..ca1dc08e
--- /dev/null
+++ b/lib/win32com/test/testDictionary.vbs
@@ -0,0 +1,26 @@
+' Test Pyhon.Dictionary using VBScript - this uses
+' IDispatchEx, so is an interesting test.
+
+set ob = CreateObject("Python.Dictionary")
+ob("hello") = "there"
+' Our keys are case insensitive.
+ob.Item("hi") = ob("HELLO")
+
+dim ok
+ok = true
+
+if ob("hello") <> "there" then
+    WScript.Echo "**** The dictionary value was wrong!!"
+    ok = false
+end if
+
+if ob("hi") <> "there" then
+        WScript.Echo "**** The other dictionary value was wrong!!"
+        ok = false
+end if
+
+if ok then
+    WScript.Echo "VBScript has successfully tested Python.Dictionary"
+end if
+
+
diff --git a/lib/win32com/test/testDynamic.py b/lib/win32com/test/testDynamic.py
new file mode 100644
index 00000000..2fd91972
--- /dev/null
+++ b/lib/win32com/test/testDynamic.py
@@ -0,0 +1,89 @@
+# Test dynamic policy, and running object table.
+
+import pythoncom
+import winerror
+from win32com.server.exception import Exception
+
+error = "testDynamic error"
+
+iid = pythoncom.MakeIID("{b48969a0-784b-11d0-ae71-d23f56000000}")
+
+
+class VeryPermissive:
+    def _dynamic_(self, name, lcid, wFlags, args):
+        if wFlags & pythoncom.DISPATCH_METHOD:
+            return getattr(self, name)(*args)
+
+        if wFlags & pythoncom.DISPATCH_PROPERTYGET:
+            try:
+                # to avoid problems with byref param handling, tuple results are converted to lists.
+                ret = self.__dict__[name]
+                if type(ret) == type(()):
+                    ret = list(ret)
+                return ret
+            except KeyError:  # Probably a method request.
+                raise Exception(scode=winerror.DISP_E_MEMBERNOTFOUND)
+
+        if wFlags & (
+            pythoncom.DISPATCH_PROPERTYPUT | pythoncom.DISPATCH_PROPERTYPUTREF
+        ):
+            setattr(self, name, args[0])
+            return
+
+        raise Exception(scode=winerror.E_INVALIDARG, desc="invalid wFlags")
+
+    def write(self, *args):
+        if len(args) == 0:
+            raise Exception(
+                scode=winerror.DISP_E_BADPARAMCOUNT
+            )  # Probably call as PROPGET.
+
+        for arg in args[:-1]:
+            print(str(arg), end=" ")
+        print(str(args[-1]))
+
+
+def Test():
+    import win32com.server.policy
+    import win32com.server.util
+
+    #       import win32dbg;win32dbg.brk()
+    ob = win32com.server.util.wrap(
+        VeryPermissive(), usePolicy=win32com.server.policy.DynamicPolicy
+    )
+    try:
+        handle = pythoncom.RegisterActiveObject(ob, iid, 0)
+    except pythoncom.com_error as details:
+        print("Warning - could not register the object in the ROT:", details)
+        handle = None
+    try:
+        import win32com.client.dynamic
+
+        client = win32com.client.dynamic.Dispatch(iid)
+        client.ANewAttr = "Hello"
+        if client.ANewAttr != "Hello":
+            raise error("Could not set dynamic property")
+
+        v = ["Hello", "From", "Python", 1.4]
+        client.TestSequence = v
+        if v != list(client.TestSequence):
+            raise error(
+                "Dynamic sequences not working! %r/%r"
+                % (repr(v), repr(client.testSequence))
+            )
+
+        client.write("This", "output", "has", "come", "via", "testDynamic.py")
+        # Check our new "_FlagAsMethod" works (kinda!)
+        client._FlagAsMethod("NotReallyAMethod")
+        if not callable(client.NotReallyAMethod):
+            raise error("Method I flagged as callable isn't!")
+
+        client = None
+    finally:
+        if handle is not None:
+            pythoncom.RevokeActiveObject(handle)
+    print("Test worked!")
+
+
+if __name__ == "__main__":
+    Test()
diff --git a/lib/win32com/test/testExchange.py b/lib/win32com/test/testExchange.py
new file mode 100644
index 00000000..b41a4472
--- /dev/null
+++ b/lib/win32com/test/testExchange.py
@@ -0,0 +1,126 @@
+# TestExchange = Exchange Server Dump
+# Note that this code uses "CDO", which is unlikely to get the best choice.
+# You should use the Outlook object model, or
+# the win32com.mapi examples for a low-level interface.
+
+import os
+
+import pythoncom
+from win32com.client import constants, gencache
+
+ammodule = None  # was the generated module!
+
+
+def GetDefaultProfileName():
+    import win32api
+    import win32con
+
+    try:
+        key = win32api.RegOpenKey(
+            win32con.HKEY_CURRENT_USER,
+            "Software\\Microsoft\\Windows NT\\CurrentVersion\\Windows Messaging Subsystem\\Profiles",
+        )
+        try:
+            return win32api.RegQueryValueEx(key, "DefaultProfile")[0]
+        finally:
+            key.Close()
+    except win32api.error:
+        return None
+
+
+#
+# Recursive dump of folders.
+#
+def DumpFolder(folder, indent=0):
+    print(" " * indent, folder.Name)
+    folders = folder.Folders
+    folder = folders.GetFirst()
+    while folder:
+        DumpFolder(folder, indent + 1)
+        folder = folders.GetNext()
+
+
+def DumpFolders(session):
+    try:
+        infostores = session.InfoStores
+    except AttributeError:
+        # later outlook?
+        store = session.DefaultStore
+        folder = store.GetRootFolder()
+        DumpFolder(folder)
+        return
+
+    print(infostores)
+    print("There are %d infostores" % infostores.Count)
+    for i in range(infostores.Count):
+        infostore = infostores[i + 1]
+        print("Infostore = ", infostore.Name)
+        try:
+            folder = infostore.RootFolder
+        except pythoncom.com_error as details:
+            hr, msg, exc, arg = details
+            # -2147221219 == MAPI_E_FAILONEPROVIDER - a single provider temporarily not available.
+            if exc and exc[-1] == -2147221219:
+                print("This info store is currently not available")
+                continue
+        DumpFolder(folder)
+
+
+# Build a dictionary of property tags, so I can reverse look-up
+#
+PropTagsById = {}
+if ammodule:
+    for name, val in ammodule.constants.__dict__.items():
+        PropTagsById[val] = name
+
+
+def TestAddress(session):
+    #       entry = session.GetAddressEntry("Skip")
+    #       print entry
+    pass
+
+
+def TestUser(session):
+    ae = session.CurrentUser
+    fields = getattr(ae, "Fields", [])
+    print("User has %d fields" % len(fields))
+    for f in range(len(fields)):
+        field = fields[f + 1]
+        try:
+            id = PropTagsById[field.ID]
+        except KeyError:
+            id = field.ID
+        print("%s/%s=%s" % (field.Name, id, field.Value))
+
+
+def test():
+    import win32com.client
+
+    oldcwd = os.getcwd()
+    try:
+        session = gencache.EnsureDispatch("MAPI.Session")
+        try:
+            session.Logon(GetDefaultProfileName())
+        except pythoncom.com_error as details:
+            print("Could not log on to MAPI:", details)
+            return
+    except pythoncom.error:
+        # no mapi.session - let's try outlook
+        app = gencache.EnsureDispatch("Outlook.Application")
+        session = app.Session
+
+    try:
+        TestUser(session)
+        TestAddress(session)
+        DumpFolders(session)
+    finally:
+        session.Logoff()
+        # It appears Exchange will change the cwd on us :(
+        os.chdir(oldcwd)
+
+
+if __name__ == "__main__":
+    from .util import CheckClean
+
+    test()
+    CheckClean()
diff --git a/lib/win32com/test/testExplorer.py b/lib/win32com/test/testExplorer.py
new file mode 100644
index 00000000..bca66358
--- /dev/null
+++ b/lib/win32com/test/testExplorer.py
@@ -0,0 +1,145 @@
+# testExplorer -
+
+import os
+import time
+
+import pythoncom
+import win32api
+import win32com.client.dynamic
+import win32con
+import win32gui
+import winerror
+from win32com.client import Dispatch
+from win32com.test.util import CheckClean
+
+bVisibleEventFired = 0
+
+# These are errors we might see when this is run in automation (eg, on github)
+# Not sure exactly what -2125463506 is, but google shows it's a common error
+# possibly related to how IE is configured WRT site permissions etc.
+HRESULTS_IN_AUTOMATION = [-2125463506, winerror.MK_E_UNAVAILABLE]
+
+
+class ExplorerEvents:
+    def OnVisible(self, visible):
+        global bVisibleEventFired
+        bVisibleEventFired = 1
+
+
+def TestExplorerEvents():
+    global bVisibleEventFired
+    try:
+        iexplore = win32com.client.DispatchWithEvents(
+            "InternetExplorer.Application", ExplorerEvents
+        )
+    except pythoncom.com_error as exc:
+        # In automation we see this error trying to connect to events
+        # It's a little surprising that the non-event tests seem to work, but
+        # whatever...
+        if exc.hresult not in HRESULTS_IN_AUTOMATION:
+            raise
+        print("IE events appear to not be available, so skipping this test")
+        return
+
+    iexplore.Visible = 1
+    if not bVisibleEventFired:
+        raise RuntimeError("The IE event did not appear to fire!")
+    iexplore.Quit()
+    iexplore = None
+
+    bVisibleEventFired = 0
+    ie = win32com.client.Dispatch("InternetExplorer.Application")
+    ie_events = win32com.client.DispatchWithEvents(ie, ExplorerEvents)
+    ie.Visible = 1
+    if not bVisibleEventFired:
+        raise RuntimeError("The IE event did not appear to fire!")
+    ie.Quit()
+    ie = None
+    print("IE Event tests worked.")
+
+
+def TestObjectFromWindow():
+    # Check we can use ObjectFromLresult to get the COM object from the
+    # HWND - see KB Q249232
+    # Locating the HWND is different than the KB says...
+    hwnd = win32gui.FindWindow("IEFrame", None)
+    for child_class in [
+        "TabWindowClass",
+        "Shell DocObject View",
+        "Internet Explorer_Server",
+    ]:
+        hwnd = win32gui.FindWindowEx(hwnd, 0, child_class, None)
+        # ack - not working for markh on vista with IE8 (or maybe it is the
+        # lack of the 'accessibility' components mentioned in Q249232)
+        # either way - not working!
+        return
+    # But here is the point - once you have an 'Internet Explorer_Server',
+    # you can send a message and use ObjectFromLresult to get it back.
+    msg = win32gui.RegisterWindowMessage("WM_HTML_GETOBJECT")
+    rc, result = win32gui.SendMessageTimeout(
+        hwnd, msg, 0, 0, win32con.SMTO_ABORTIFHUNG, 1000
+    )
+    ob = pythoncom.ObjectFromLresult(result, pythoncom.IID_IDispatch, 0)
+    doc = Dispatch(ob)
+    # just to prove it works, set the background color of the document.
+    for color in "red green blue orange white".split():
+        doc.bgColor = color
+        time.sleep(0.2)
+
+
+def TestExplorer(iexplore):
+    if not iexplore.Visible:
+        iexplore.Visible = -1
+    filename = os.path.join(os.path.dirname(__file__), "..\\readme.html")
+    iexplore.Navigate(win32api.GetFullPathName(filename))
+    win32api.Sleep(1000)
+    TestObjectFromWindow()
+    win32api.Sleep(3000)
+    try:
+        iexplore.Quit()
+    except (AttributeError, pythoncom.com_error):
+        # User got sick of waiting :)
+        pass
+
+
+def TestAll():
+    try:
+        try:
+            try:
+                iexplore = win32com.client.dynamic.Dispatch(
+                    "InternetExplorer.Application"
+                )
+            except pythoncom.com_error as exc:
+                if exc.hresult not in HRESULTS_IN_AUTOMATION:
+                    raise
+                print("IE appears to not be available, so skipping this test")
+                return
+
+            TestExplorer(iexplore)
+
+            win32api.Sleep(1000)
+            iexplore = None
+
+            # Test IE events.
+            TestExplorerEvents()
+            # Give IE a chance to shutdown, else it can get upset on fast machines.
+            time.sleep(2)
+
+            # Note that the TextExplorerEvents will force makepy - hence
+            # this gencache is really no longer needed.
+
+            from win32com.client import gencache
+
+            gencache.EnsureModule("{EAB22AC0-30C1-11CF-A7EB-0000C05BAE0B}", 0, 1, 1)
+            iexplore = win32com.client.Dispatch("InternetExplorer.Application")
+            TestExplorer(iexplore)
+        except pythoncom.com_error as exc:
+            if exc.hresult != winerror.RPC_E_DISCONNECTED:  # user closed the app!
+                raise
+    finally:
+        iexplore = None
+
+
+if __name__ == "__main__":
+    TestAll()
+    CheckClean()
diff --git a/lib/win32com/test/testGIT.py b/lib/win32com/test/testGIT.py
new file mode 100644
index 00000000..2ec6bc44
--- /dev/null
+++ b/lib/win32com/test/testGIT.py
@@ -0,0 +1,145 @@
+"""Testing pasing object between multiple COM threads
+
+Uses standard COM marshalling to pass objects between threads.  Even 
+though Python generally seems to work when you just pass COM objects
+between threads, it shouldnt.
+
+This shows the "correct" way to do it.
+
+It shows that although we create new threads to use the Python.Interpreter,
+COM marshalls back all calls to that object to the main Python thread,
+which must be running a message loop (as this sample does).
+
+When this test is run in "free threaded" mode (at this stage, you must 
+manually mark the COM objects as "ThreadingModel=Free", or run from a 
+service which has marked itself as free-threaded), then no marshalling
+is done, and the Python.Interpreter object start doing the "expected" thing
+- ie, it reports being on the same thread as its caller!
+
+Python.exe needs a good way to mark itself as FreeThreaded - at the moment
+this is a pain in the but!
+
+"""
+
+import _thread
+import traceback
+
+import pythoncom
+import win32api
+import win32com.client
+import win32event
+
+
+def TestInterp(interp):
+    if interp.Eval("1+1") != 2:
+        raise ValueError("The interpreter returned the wrong result.")
+    try:
+        interp.Eval(1 + 1)
+        raise ValueError("The interpreter did not raise an exception")
+    except pythoncom.com_error as details:
+        import winerror
+
+        if details[0] != winerror.DISP_E_TYPEMISMATCH:
+            raise ValueError(
+                "The interpreter exception was not winerror.DISP_E_TYPEMISMATCH."
+            )
+
+
+def TestInterpInThread(stopEvent, cookie):
+    try:
+        DoTestInterpInThread(cookie)
+    finally:
+        win32event.SetEvent(stopEvent)
+
+
+def CreateGIT():
+    return pythoncom.CoCreateInstance(
+        pythoncom.CLSID_StdGlobalInterfaceTable,
+        None,
+        pythoncom.CLSCTX_INPROC,
+        pythoncom.IID_IGlobalInterfaceTable,
+    )
+
+
+def DoTestInterpInThread(cookie):
+    try:
+        pythoncom.CoInitialize()
+        myThread = win32api.GetCurrentThreadId()
+        GIT = CreateGIT()
+
+        interp = GIT.GetInterfaceFromGlobal(cookie, pythoncom.IID_IDispatch)
+        interp = win32com.client.Dispatch(interp)
+
+        TestInterp(interp)
+        interp.Exec("import win32api")
+        print(
+            "The test thread id is %d, Python.Interpreter's thread ID is %d"
+            % (myThread, interp.Eval("win32api.GetCurrentThreadId()"))
+        )
+        interp = None
+        pythoncom.CoUninitialize()
+    except:
+        traceback.print_exc()
+
+
+def BeginThreadsSimpleMarshal(numThreads, cookie):
+    """Creates multiple threads using simple (but slower) marshalling.
+
+    Single interpreter object, but a new stream is created per thread.
+
+    Returns the handles the threads will set when complete.
+    """
+    ret = []
+    for i in range(numThreads):
+        hEvent = win32event.CreateEvent(None, 0, 0, None)
+        _thread.start_new(TestInterpInThread, (hEvent, cookie))
+        ret.append(hEvent)
+    return ret
+
+
+def test(fn):
+    print("The main thread is %d" % (win32api.GetCurrentThreadId()))
+    GIT = CreateGIT()
+    interp = win32com.client.Dispatch("Python.Interpreter")
+    cookie = GIT.RegisterInterfaceInGlobal(interp._oleobj_, pythoncom.IID_IDispatch)
+
+    events = fn(4, cookie)
+    numFinished = 0
+    while 1:
+        try:
+            rc = win32event.MsgWaitForMultipleObjects(
+                events, 0, 2000, win32event.QS_ALLINPUT
+            )
+            if rc >= win32event.WAIT_OBJECT_0 and rc < win32event.WAIT_OBJECT_0 + len(
+                events
+            ):
+                numFinished = numFinished + 1
+                if numFinished >= len(events):
+                    break
+            elif rc == win32event.WAIT_OBJECT_0 + len(events):  # a message
+                # This is critical - whole apartment model demo will hang.
+                pythoncom.PumpWaitingMessages()
+            else:  # Timeout
+                print(
+                    "Waiting for thread to stop with interfaces=%d, gateways=%d"
+                    % (pythoncom._GetInterfaceCount(), pythoncom._GetGatewayCount())
+                )
+        except KeyboardInterrupt:
+            break
+    GIT.RevokeInterfaceFromGlobal(cookie)
+    del interp
+    del GIT
+
+
+if __name__ == "__main__":
+    test(BeginThreadsSimpleMarshal)
+    win32api.Sleep(500)
+    # Doing CoUninit here stop Pythoncom.dll hanging when DLLMain shuts-down the process
+    pythoncom.CoUninitialize()
+    if pythoncom._GetInterfaceCount() != 0 or pythoncom._GetGatewayCount() != 0:
+        print(
+            "Done with interfaces=%d, gateways=%d"
+            % (pythoncom._GetInterfaceCount(), pythoncom._GetGatewayCount())
+        )
+    else:
+        print("Done.")
diff --git a/lib/win32com/test/testGatewayAddresses.py b/lib/win32com/test/testGatewayAddresses.py
new file mode 100644
index 00000000..d4899169
--- /dev/null
+++ b/lib/win32com/test/testGatewayAddresses.py
@@ -0,0 +1,149 @@
+# The purpose of this test is to ensure that the gateways objects
+# do the right thing WRT COM rules about object identity etc.
+
+# Also includes a basic test that we support inheritance correctly in
+# gateway interfaces.
+
+# For our test, we create an object of type IID_IPersistStorage
+# This interface derives from IPersist.
+# Therefore, QI's for IID_IDispatch, IID_IUnknown, IID_IPersist and
+# IID_IPersistStorage should all return the same gateway object.
+#
+# In addition, the interface should only need to declare itself as
+# using the IPersistStorage interface, and as the gateway derives
+# from IPersist, it should automatically be available without declaration.
+#
+# We also create an object of type IID_I??, and perform a QI for it.
+# We then jump through a number of hoops, ensuring that the objects
+# returned by the QIs follow all the rules.
+#
+# Here is Gregs summary of the rules:
+# 1) the set of supported interfaces is static and unchanging
+# 2) symmetric: if you QI an interface for that interface, it succeeds
+# 3) reflexive: if you QI against A for B, the new pointer must succeed
+#   for a QI for A
+# 4) transitive: if you QI for B, then QI that for C, then QI'ing A for C
+#   must succeed
+#
+#
+# Note that 1) Requires cooperation of the Python programmer.  The rule to keep is:
+# "whenever you return an _object_ from _query_interface_(), you must return the
+# same object each time for a given IID.  Note that you must return the same
+# _wrapped_ object
+# you
+# The rest are tested here.
+
+
+import pythoncom
+from win32com.server.util import wrap
+
+from .util import CheckClean
+
+numErrors = 0
+
+
+# Check that the 2 objects both have identical COM pointers.
+def CheckSameCOMObject(ob1, ob2):
+    addr1 = repr(ob1).split()[6][:-1]
+    addr2 = repr(ob2).split()[6][:-1]
+    return addr1 == addr2
+
+
+# Check that the objects conform to COM identity rules.
+def CheckObjectIdentity(ob1, ob2):
+    u1 = ob1.QueryInterface(pythoncom.IID_IUnknown)
+    u2 = ob2.QueryInterface(pythoncom.IID_IUnknown)
+    return CheckSameCOMObject(u1, u2)
+
+
+def FailObjectIdentity(ob1, ob2, when):
+    if not CheckObjectIdentity(ob1, ob2):
+        global numErrors
+        numErrors = numErrors + 1
+        print(when, "are not identical (%s, %s)" % (repr(ob1), repr(ob2)))
+
+
+class Dummy:
+    _public_methods_ = []  # We never attempt to make a call on this object.
+    _com_interfaces_ = [pythoncom.IID_IPersistStorage]
+
+
+class Dummy2:
+    _public_methods_ = []  # We never attempt to make a call on this object.
+    _com_interfaces_ = [
+        pythoncom.IID_IPersistStorage,
+        pythoncom.IID_IExternalConnection,
+    ]
+
+
+class DeletgatedDummy:
+    _public_methods_ = []
+
+
+class Dummy3:
+    _public_methods_ = []  # We never attempt to make a call on this object.
+    _com_interfaces_ = [pythoncom.IID_IPersistStorage]
+
+    def _query_interface_(self, iid):
+        if iid == pythoncom.IID_IExternalConnection:
+            # This will NEVER work - can only wrap the object once!
+            return wrap(DelegatedDummy())
+
+
+def TestGatewayInheritance():
+    # By default, wrap() creates and discards a temporary object.
+    # This is not necessary, but just the current implementation of wrap.
+    # As the object is correctly discarded, it doesnt affect this test.
+    o = wrap(Dummy(), pythoncom.IID_IPersistStorage)
+    o2 = o.QueryInterface(pythoncom.IID_IUnknown)
+    FailObjectIdentity(o, o2, "IID_IPersistStorage->IID_IUnknown")
+
+    o3 = o2.QueryInterface(pythoncom.IID_IDispatch)
+
+    FailObjectIdentity(o2, o3, "IID_IUnknown->IID_IDispatch")
+    FailObjectIdentity(o, o3, "IID_IPersistStorage->IID_IDispatch")
+
+    o4 = o3.QueryInterface(pythoncom.IID_IPersistStorage)
+    FailObjectIdentity(o, o4, "IID_IPersistStorage->IID_IPersistStorage(2)")
+    FailObjectIdentity(o2, o4, "IID_IUnknown->IID_IPersistStorage(2)")
+    FailObjectIdentity(o3, o4, "IID_IDispatch->IID_IPersistStorage(2)")
+
+    o5 = o4.QueryInterface(pythoncom.IID_IPersist)
+    FailObjectIdentity(o, o5, "IID_IPersistStorage->IID_IPersist")
+    FailObjectIdentity(o2, o5, "IID_IUnknown->IID_IPersist")
+    FailObjectIdentity(o3, o5, "IID_IDispatch->IID_IPersist")
+    FailObjectIdentity(o4, o5, "IID_IPersistStorage(2)->IID_IPersist")
+
+
+def TestMultiInterface():
+    o = wrap(Dummy2(), pythoncom.IID_IPersistStorage)
+    o2 = o.QueryInterface(pythoncom.IID_IExternalConnection)
+
+    FailObjectIdentity(o, o2, "IID_IPersistStorage->IID_IExternalConnection")
+
+    # Make the same QI again, to make sure it is stable.
+    o22 = o.QueryInterface(pythoncom.IID_IExternalConnection)
+    FailObjectIdentity(o, o22, "IID_IPersistStorage->IID_IExternalConnection")
+    FailObjectIdentity(
+        o2, o22, "IID_IPersistStorage->IID_IExternalConnection (stability)"
+    )
+
+    o3 = o2.QueryInterface(pythoncom.IID_IPersistStorage)
+    FailObjectIdentity(o2, o3, "IID_IExternalConnection->IID_IPersistStorage")
+    FailObjectIdentity(
+        o, o3, "IID_IPersistStorage->IID_IExternalConnection->IID_IPersistStorage"
+    )
+
+
+def test():
+    TestGatewayInheritance()
+    TestMultiInterface()
+    if numErrors == 0:
+        print("Worked ok")
+    else:
+        print("There were", numErrors, "errors.")
+
+
+if __name__ == "__main__":
+    test()
+    CheckClean()
diff --git a/lib/win32com/test/testInterp.vbs b/lib/win32com/test/testInterp.vbs
new file mode 100644
index 00000000..f34d17a9
--- /dev/null
+++ b/lib/win32com/test/testInterp.vbs
@@ -0,0 +1,12 @@
+set o = CreateObject("Python.Interpreter")
+if o.Eval("1+1") <> 2 Then
+	WScript.Echo "Eval('1+1') failed"
+	bFailed = True
+end if
+
+if bFailed then
+	WScript.Echo "*********** VBScript tests failed *********"
+else
+	WScript.Echo "VBScript test worked OK"
+end if
+
diff --git a/lib/win32com/test/testIterators.py b/lib/win32com/test/testIterators.py
new file mode 100644
index 00000000..b75a78df
--- /dev/null
+++ b/lib/win32com/test/testIterators.py
@@ -0,0 +1,140 @@
+# Some raw iter tests.  Some "high-level" iterator tests can be found in
+# testvb.py and testOutlook.py
+import sys
+import unittest
+
+import pythoncom
+import win32com.server.util
+import win32com.test.util
+from win32com.client import Dispatch
+from win32com.client.gencache import EnsureDispatch
+
+
+class _BaseTestCase(win32com.test.util.TestCase):
+    def test_enumvariant_vb(self):
+        ob, iter = self.iter_factory()
+        got = []
+        for v in iter:
+            got.append(v)
+        self.assertEqual(got, self.expected_data)
+
+    def test_yield(self):
+        ob, i = self.iter_factory()
+        got = []
+        for v in iter(i):
+            got.append(v)
+        self.assertEqual(got, self.expected_data)
+
+    def _do_test_nonenum(self, object):
+        try:
+            for i in object:
+                pass
+            self.fail("Could iterate over a non-iterable object")
+        except TypeError:
+            pass  # this is expected.
+        self.assertRaises(TypeError, iter, object)
+        self.assertRaises(AttributeError, getattr, object, "next")
+
+    def test_nonenum_wrapper(self):
+        # Check our raw PyIDispatch
+        ob = self.object._oleobj_
+        try:
+            for i in ob:
+                pass
+            self.fail("Could iterate over a non-iterable object")
+        except TypeError:
+            pass  # this is expected.
+        self.assertRaises(TypeError, iter, ob)
+        self.assertRaises(AttributeError, getattr, ob, "next")
+
+        # And our Dispatch wrapper
+        ob = self.object
+        try:
+            for i in ob:
+                pass
+            self.fail("Could iterate over a non-iterable object")
+        except TypeError:
+            pass  # this is expected.
+        # Note that as our object may be dynamic, we *do* have a __getitem__
+        # method, meaning we *can* call iter() on the object.  In this case
+        # actual iteration is what fails.
+        # So either the 'iter(); will raise a type error, or an attempt to
+        # fetch it
+        try:
+            next(iter(ob))
+            self.fail("Expected a TypeError fetching this iterator")
+        except TypeError:
+            pass
+        # And it should never have a 'next' method
+        self.assertRaises(AttributeError, getattr, ob, "next")
+
+
+class VBTestCase(_BaseTestCase):
+    def setUp(self):
+        def factory():
+            # Our VB test harness exposes a property with IEnumVariant.
+            ob = self.object.EnumerableCollectionProperty
+            for i in self.expected_data:
+                ob.Add(i)
+            # Get the raw IEnumVARIANT.
+            invkind = pythoncom.DISPATCH_METHOD | pythoncom.DISPATCH_PROPERTYGET
+            iter = ob._oleobj_.InvokeTypes(
+                pythoncom.DISPID_NEWENUM, 0, invkind, (13, 10), ()
+            )
+            return ob, iter.QueryInterface(pythoncom.IID_IEnumVARIANT)
+
+        # We *need* generated dispatch semantics, so dynamic __getitem__ etc
+        # don't get in the way of our tests.
+        self.object = EnsureDispatch("PyCOMVBTest.Tester")
+        self.expected_data = [1, "Two", "3"]
+        self.iter_factory = factory
+
+    def tearDown(self):
+        self.object = None
+
+
+# Test our client semantics, but using a wrapped Python list object.
+# This has the effect of re-using our client specific tests, but in this
+# case is exercising the server side.
+class SomeObject:
+    _public_methods_ = ["GetCollection"]
+
+    def __init__(self, data):
+        self.data = data
+
+    def GetCollection(self):
+        return win32com.server.util.NewCollection(self.data)
+
+
+class WrappedPythonCOMServerTestCase(_BaseTestCase):
+    def setUp(self):
+        def factory():
+            ob = self.object.GetCollection()
+            flags = pythoncom.DISPATCH_METHOD | pythoncom.DISPATCH_PROPERTYGET
+            enum = ob._oleobj_.Invoke(pythoncom.DISPID_NEWENUM, 0, flags, 1)
+            return ob, enum.QueryInterface(pythoncom.IID_IEnumVARIANT)
+
+        self.expected_data = [1, "Two", 3]
+        sv = win32com.server.util.wrap(SomeObject(self.expected_data))
+        self.object = Dispatch(sv)
+        self.iter_factory = factory
+
+    def tearDown(self):
+        self.object = None
+
+
+def suite():
+    # We dont want our base class run
+    suite = unittest.TestSuite()
+    for item in list(globals().values()):
+        if (
+            type(item) == type(unittest.TestCase)
+            and issubclass(item, unittest.TestCase)
+            and item != _BaseTestCase
+        ):
+            suite.addTest(unittest.makeSuite(item))
+    return suite
+
+
+if __name__ == "__main__":
+    unittest.main(argv=sys.argv + ["suite"])
diff --git a/lib/win32com/test/testMSOffice.py b/lib/win32com/test/testMSOffice.py
new file mode 100644
index 00000000..f4893dfd
--- /dev/null
+++ b/lib/win32com/test/testMSOffice.py
@@ -0,0 +1,209 @@
+# Test MSOffice
+#
+# Main purpose of test is to ensure that Dynamic COM objects
+# work as expected.
+
+# Assumes Word and Excel installed on your machine.
+
+import traceback
+
+import pythoncom
+import win32api
+import win32com
+import win32com.client.dynamic
+from pywintypes import Unicode
+from win32com.client import gencache
+from win32com.test.util import CheckClean
+
+error = "MSOffice test error"
+
+
+# Test a few of the MSOffice components.
+def TestWord():
+    # Try and load the object exposed by Word 8
+    # Office 97 - _totally_ different object model!
+    try:
+        # NOTE - using "client.Dispatch" would return an msword8.py instance!
+        print("Starting Word 8 for dynamic test")
+        word = win32com.client.dynamic.Dispatch("Word.Application")
+        TestWord8(word)
+
+        word = None
+        # Now we will test Dispatch without the new "lazy" capabilities
+        print("Starting Word 8 for non-lazy dynamic test")
+        dispatch = win32com.client.dynamic._GetGoodDispatch("Word.Application")
+        typeinfo = dispatch.GetTypeInfo()
+        attr = typeinfo.GetTypeAttr()
+        olerepr = win32com.client.build.DispatchItem(typeinfo, attr, None, 0)
+        word = win32com.client.dynamic.CDispatch(dispatch, olerepr)
+        dispatch = typeinfo = attr = olerepr = None
+        TestWord8(word)
+
+    except pythoncom.com_error:
+        print("Starting Word 7 for dynamic test")
+        word = win32com.client.Dispatch("Word.Basic")
+        TestWord7(word)
+
+    except Exception as e:
+        print("Word dynamic tests failed", e)
+        traceback.print_exc()
+
+    print("Starting MSWord for generated test")
+    try:
+        from win32com.client import gencache
+
+        word = gencache.EnsureDispatch("Word.Application.8")
+        TestWord8(word)
+    except Exception as e:
+        print("Word generated tests failed", e)
+        traceback.print_exc()
+
+
+def TestWord7(word):
+    word.FileNew()
+    # If not shown, show the app.
+    if not word.AppShow():
+        word._proc_("AppShow")
+
+    for i in range(12):
+        word.FormatFont(Color=i + 1, Points=i + 12)
+        word.Insert("Hello from Python %d\n" % i)
+
+    word.FileClose(2)
+
+
+def TestWord8(word):
+    word.Visible = 1
+    doc = word.Documents.Add()
+    wrange = doc.Range()
+    for i in range(10):
+        wrange.InsertAfter("Hello from Python %d\n" % i)
+    paras = doc.Paragraphs
+    for i in range(len(paras)):
+        # *sob* - in Word 2019, `p = paras(i+1)` seems to work to get a para
+        # but `p.Font` then blows up.
+        #        p = paras[i]()
+        p = paras(i + 1)
+        p.Font.ColorIndex = i + 1
+        p.Font.Size = 12 + (4 * i)
+    # XXX - note that
+    # for para in paras:
+    #       para().Font...
+    # doesnt seem to work - no error, just doesnt work
+    # Should check if it works for VB!
+    doc.Close(SaveChanges=0)
+    word.Quit()
+    win32api.Sleep(1000)  # Wait for word to close, else we
+    # may get OA error.
+
+
+def TestWord8OldStyle():
+    try:
+        import win32com.test.Generated4Test.msword8
+    except ImportError:
+        print("Can not do old style test")
+
+
+def TextExcel(xl):
+    xl.Visible = 0
+    if xl.Visible:
+        raise error("Visible property is true.")
+    xl.Visible = 1
+    if not xl.Visible:
+        raise error("Visible property not true.")
+
+    if int(xl.Version[0]) >= 8:
+        xl.Workbooks.Add()
+    else:
+        xl.Workbooks().Add()
+
+    xl.Range("A1:C1").Value = (1, 2, 3)
+    xl.Range("A2:C2").Value = ("x", "y", "z")
+    xl.Range("A3:C3").Value = ("3", "2", "1")
+
+    for i in range(20):
+        xl.Cells(i + 1, i + 1).Value = "Hi %d" % i
+
+    if xl.Range("A1").Value != "Hi 0":
+        raise error("Single cell range failed")
+
+    if xl.Range("A1:B1").Value != ((Unicode("Hi 0"), 2),):
+        raise error("flat-horizontal cell range failed")
+
+    if xl.Range("A1:A2").Value != ((Unicode("Hi 0"),), (Unicode("x"),)):
+        raise error("flat-vertical cell range failed")
+
+    if xl.Range("A1:C3").Value != (
+        (Unicode("Hi 0"), 2, 3),
+        (Unicode("x"), Unicode("Hi 1"), Unicode("z")),
+        (3, 2, Unicode("Hi 2")),
+    ):
+        raise error("square cell range failed")
+
+    xl.Range("A1:C3").Value = ((3, 2, 1), ("x", "y", "z"), (1, 2, 3))
+
+    if xl.Range("A1:C3").Value != (
+        (3, 2, 1),
+        (Unicode("x"), Unicode("y"), Unicode("z")),
+        (1, 2, 3),
+    ):
+        raise error("Range was not what I set it to!")
+
+    # test dates out with Excel
+    xl.Cells(5, 1).Value = "Excel time"
+    xl.Cells(5, 2).Formula = "=Now()"
+
+    import time
+
+    xl.Cells(6, 1).Value = "Python time"
+    xl.Cells(6, 2).Value = pythoncom.MakeTime(time.time())
+    xl.Cells(6, 2).NumberFormat = "d/mm/yy h:mm"
+    xl.Columns("A:B").EntireColumn.AutoFit()
+
+    xl.Workbooks(1).Close(0)
+    xl.Quit()
+
+
+def TestAll():
+    TestWord()
+
+    try:
+        print("Starting Excel for Dynamic test...")
+        xl = win32com.client.dynamic.Dispatch("Excel.Application")
+        TextExcel(xl)
+    except Exception as e:
+        worked = False
+        print("Excel tests failed", e)
+        traceback.print_exc()
+
+    try:
+        print("Starting Excel 8 for generated excel8.py test...")
+        mod = gencache.EnsureModule(
+            "{00020813-0000-0000-C000-000000000046}", 0, 1, 2, bForDemand=1
+        )
+        xl = win32com.client.Dispatch("Excel.Application")
+        TextExcel(xl)
+    except ImportError:
+        print("Could not import the generated Excel 97 wrapper")
+    except Exception as e:
+        print("Generated Excel tests failed", e)
+        traceback.print_exc()
+
+    try:
+        import xl5en32
+
+        mod = gencache.EnsureModule("{00020813-0000-0000-C000-000000000046}", 9, 1, 0)
+        xl = win32com.client.Dispatch("Excel.Application.5")
+        print("Starting Excel 95 for makepy test...")
+        TextExcel(xl)
+    except ImportError:
+        print("Could not import the generated Excel 95 wrapper")
+    except Exception as e:
+        print("Excel 95 tests failed", e)
+        traceback.print_exc()
+
+
+if __name__ == "__main__":
+    TestAll()
+    CheckClean()
+    pythoncom.CoUninitialize()
diff --git a/lib/win32com/test/testMSOfficeEvents.py b/lib/win32com/test/testMSOfficeEvents.py
new file mode 100644
index 00000000..c173c3ef
--- /dev/null
+++ b/lib/win32com/test/testMSOfficeEvents.py
@@ -0,0 +1,136 @@
+# OfficeEvents - test/demonstrate events with Word and Excel.
+import msvcrt
+import sys
+import threading
+import time
+import types
+
+import pythoncom
+from win32com.client import Dispatch, DispatchWithEvents
+
+stopEvent = threading.Event()
+
+
+def TestExcel():
+    class ExcelEvents:
+        def OnNewWorkbook(self, wb):
+            if type(wb) != types.InstanceType:
+                raise RuntimeError(
+                    "The transformer doesnt appear to have translated this for us!"
+                )
+            self.seen_events["OnNewWorkbook"] = None
+
+        def OnWindowActivate(self, wb, wn):
+            if type(wb) != types.InstanceType or type(wn) != types.InstanceType:
+                raise RuntimeError(
+                    "The transformer doesnt appear to have translated this for us!"
+                )
+            self.seen_events["OnWindowActivate"] = None
+
+        def OnWindowDeactivate(self, wb, wn):
+            self.seen_events["OnWindowDeactivate"] = None
+
+        def OnSheetDeactivate(self, sh):
+            self.seen_events["OnSheetDeactivate"] = None
+
+        def OnSheetBeforeDoubleClick(self, Sh, Target, Cancel):
+            if Target.Column % 2 == 0:
+                print("You can double-click there...")
+            else:
+                print("You can not double-click there...")
+                # This function is a void, so the result ends up in
+                # the only ByRef - Cancel.
+                return 1
+
+    class WorkbookEvents:
+        def OnActivate(self):
+            print("workbook OnActivate")
+
+        def OnBeforeRightClick(self, Target, Cancel):
+            print("It's a Worksheet Event")
+
+    e = DispatchWithEvents("Excel.Application", ExcelEvents)
+    e.seen_events = {}
+    e.Visible = 1
+    book = e.Workbooks.Add()
+    book = DispatchWithEvents(book, WorkbookEvents)
+    print("Have book", book)
+    #    sheet = e.Worksheets(1)
+    #    sheet = DispatchWithEvents(sheet, WorksheetEvents)
+
+    print("Double-click in a few of the Excel cells...")
+    print("Press any key when finished with Excel, or wait 10 seconds...")
+    if not _WaitForFinish(e, 10):
+        e.Quit()
+    if not _CheckSeenEvents(e, ["OnNewWorkbook", "OnWindowActivate"]):
+        sys.exit(1)
+
+
+def TestWord():
+    class WordEvents:
+        def OnDocumentChange(self):
+            self.seen_events["OnDocumentChange"] = None
+
+        def OnWindowActivate(self, doc, wn):
+            self.seen_events["OnWindowActivate"] = None
+
+        def OnQuit(self):
+            self.seen_events["OnQuit"] = None
+            stopEvent.set()
+
+    w = DispatchWithEvents("Word.Application", WordEvents)
+    w.seen_events = {}
+    w.Visible = 1
+    w.Documents.Add()
+    print("Press any key when finished with Word, or wait 10 seconds...")
+    if not _WaitForFinish(w, 10):
+        w.Quit()
+    if not _CheckSeenEvents(w, ["OnDocumentChange", "OnWindowActivate"]):
+        sys.exit(1)
+
+
+def _WaitForFinish(ob, timeout):
+    end = time.time() + timeout
+    while 1:
+        if msvcrt.kbhit():
+            msvcrt.getch()
+            break
+        pythoncom.PumpWaitingMessages()
+        stopEvent.wait(0.2)
+        if stopEvent.isSet():
+            stopEvent.clear()
+            break
+        try:
+            if not ob.Visible:
+                # Gone invisible - we need to pretend we timed
+                # out, so the app is quit.
+                return 0
+        except pythoncom.com_error:
+            # Excel is busy (eg, editing the cell) - ignore
+            pass
+        if time.time() > end:
+            return 0
+    return 1
+
+
+def _CheckSeenEvents(o, events):
+    rc = 1
+    for e in events:
+        if e not in o.seen_events:
+            print("ERROR: Expected event did not trigger", e)
+            rc = 0
+    return rc
+
+
+def test():
+    import sys
+
+    if "noword" not in sys.argv[1:]:
+        TestWord()
+    if "noexcel" not in sys.argv[1:]:
+        TestExcel()
+    print("Word and Excel event tests passed.")
+
+
+if __name__ == "__main__":
+    test()
diff --git a/lib/win32com/test/testMarshal.py b/lib/win32com/test/testMarshal.py
new file mode 100644
index 00000000..c57d445f
--- /dev/null
+++ b/lib/win32com/test/testMarshal.py
@@ -0,0 +1,160 @@
+"""Testing pasing object between multiple COM threads
+
+Uses standard COM marshalling to pass objects between threads.  Even
+though Python generally seems to work when you just pass COM objects
+between threads, it shouldnt.
+
+This shows the "correct" way to do it.
+
+It shows that although we create new threads to use the Python.Interpreter,
+COM marshalls back all calls to that object to the main Python thread,
+which must be running a message loop (as this sample does).
+
+When this test is run in "free threaded" mode (at this stage, you must
+manually mark the COM objects as "ThreadingModel=Free", or run from a
+service which has marked itself as free-threaded), then no marshalling
+is done, and the Python.Interpreter object start doing the "expected" thing
+- ie, it reports being on the same thread as its caller!
+
+Python.exe needs a good way to mark itself as FreeThreaded - at the moment
+this is a pain in the but!
+
+"""
+
+import threading
+import unittest
+
+import pythoncom
+import win32api
+import win32com.client
+import win32event
+
+from .testServers import InterpCase
+
+freeThreaded = 1
+
+
+class ThreadInterpCase(InterpCase):
+    def _testInterpInThread(self, stopEvent, interp):
+        try:
+            self._doTestInThread(interp)
+        finally:
+            win32event.SetEvent(stopEvent)
+
+    def _doTestInThread(self, interp):
+        pythoncom.CoInitialize()
+        myThread = win32api.GetCurrentThreadId()
+
+        if freeThreaded:
+            interp = pythoncom.CoGetInterfaceAndReleaseStream(
+                interp, pythoncom.IID_IDispatch
+            )
+            interp = win32com.client.Dispatch(interp)
+
+        interp.Exec("import win32api")
+        # print "The test thread id is %d, Python.Interpreter's thread ID is %d" % (myThread, interp.Eval("win32api.GetCurrentThreadId()"))
+        pythoncom.CoUninitialize()
+
+    def BeginThreadsSimpleMarshal(self, numThreads):
+        """Creates multiple threads using simple (but slower) marshalling.
+
+        Single interpreter object, but a new stream is created per thread.
+
+        Returns the handles the threads will set when complete.
+        """
+        interp = win32com.client.Dispatch("Python.Interpreter")
+        events = []
+        threads = []
+        for i in range(numThreads):
+            hEvent = win32event.CreateEvent(None, 0, 0, None)
+            events.append(hEvent)
+            interpStream = pythoncom.CoMarshalInterThreadInterfaceInStream(
+                pythoncom.IID_IDispatch, interp._oleobj_
+            )
+            t = threading.Thread(
+                target=self._testInterpInThread, args=(hEvent, interpStream)
+            )
+            t.setDaemon(1)  # so errors dont cause shutdown hang
+            t.start()
+            threads.append(t)
+        interp = None
+        return threads, events
+
+    #
+    # NOTE - this doesnt quite work - Im not even sure it should, but Greg reckons
+    # you should be able to avoid the marshal per thread!
+    # I think that refers to CoMarshalInterface though...
+    def BeginThreadsFastMarshal(self, numThreads):
+        """Creates multiple threads using fast (but complex) marshalling.
+
+        The marshal stream is created once, and each thread uses the same stream
+
+        Returns the handles the threads will set when complete.
+        """
+        interp = win32com.client.Dispatch("Python.Interpreter")
+        if freeThreaded:
+            interp = pythoncom.CoMarshalInterThreadInterfaceInStream(
+                pythoncom.IID_IDispatch, interp._oleobj_
+            )
+        events = []
+        threads = []
+        for i in range(numThreads):
+            hEvent = win32event.CreateEvent(None, 0, 0, None)
+            t = threading.Thread(target=self._testInterpInThread, args=(hEvent, interp))
+            t.setDaemon(1)  # so errors dont cause shutdown hang
+            t.start()
+            events.append(hEvent)
+            threads.append(t)
+        return threads, events
+
+    def _DoTestMarshal(self, fn, bCoWait=0):
+        # print "The main thread is %d" % (win32api.GetCurrentThreadId())
+        threads, events = fn(2)
+        numFinished = 0
+        while 1:
+            try:
+                if bCoWait:
+                    rc = pythoncom.CoWaitForMultipleHandles(0, 2000, events)
+                else:
+                    # Specifying "bWaitAll" here will wait for messages *and* all events
+                    # (which is pretty useless)
+                    rc = win32event.MsgWaitForMultipleObjects(
+                        events, 0, 2000, win32event.QS_ALLINPUT
+                    )
+                if (
+                    rc >= win32event.WAIT_OBJECT_0
+                    and rc < win32event.WAIT_OBJECT_0 + len(events)
+                ):
+                    numFinished = numFinished + 1
+                    if numFinished >= len(events):
+                        break
+                elif rc == win32event.WAIT_OBJECT_0 + len(events):  # a message
+                    # This is critical - whole apartment model demo will hang.
+                    pythoncom.PumpWaitingMessages()
+                else:  # Timeout
+                    print(
+                        "Waiting for thread to stop with interfaces=%d, gateways=%d"
+                        % (pythoncom._GetInterfaceCount(), pythoncom._GetGatewayCount())
+                    )
+            except KeyboardInterrupt:
+                break
+        for t in threads:
+            t.join(2)
+            self.assertFalse(t.is_alive(), "thread failed to stop!?")
+        threads = None  # threads hold references to args
+        # Seems to be a leak here I can't locate :(
+        # self.assertEqual(pythoncom._GetInterfaceCount(), 0)
+        # self.assertEqual(pythoncom._GetGatewayCount(), 0)
+
+    def testSimpleMarshal(self):
+        self._DoTestMarshal(self.BeginThreadsSimpleMarshal)
+
+    def testSimpleMarshalCoWait(self):
+        self._DoTestMarshal(self.BeginThreadsSimpleMarshal, 1)
+
+
+#    def testFastMarshal(self):
+#        self._DoTestMarshal(self.BeginThreadsFastMarshal)
+
+if __name__ == "__main__":
+    unittest.main("testMarshal")
diff --git a/lib/win32com/test/testNetscape.py b/lib/win32com/test/testNetscape.py
new file mode 100644
index 00000000..471de802
--- /dev/null
+++ b/lib/win32com/test/testNetscape.py
@@ -0,0 +1,27 @@
+## AHH - I cant make this work!!!
+
+# But this is the general idea.
+
+import sys
+
+import netscape
+
+error = "Netscape Test Error"
+
+if __name__ == "__main__":
+    n = netscape.CNetworkCX()
+    rc = n.Open("http://d|/temp/apyext.html", 0, None, 0, None)
+    if not rc:
+        raise error("Open method of Netscape failed")
+    while 1:
+        num, str = n.Read(None, 0)
+        print("Got ", num, str)
+        if num == 0:
+            break  # used to be continue - no idea!!
+        if num == -1:
+            break
+    #               sys.stdout.write(str)
+    n.Close()
+    print("Done!")
+    del n
+    sys.last_type = sys.last_value = sys.last_traceback = None
diff --git a/lib/win32com/test/testPersist.py b/lib/win32com/test/testPersist.py
new file mode 100644
index 00000000..066f4029
--- /dev/null
+++ b/lib/win32com/test/testPersist.py
@@ -0,0 +1,231 @@
+import os
+
+import pythoncom
+import pywintypes
+import win32api
+import win32com
+import win32com.client
+import win32com.client.dynamic
+import win32com.server.util
+import win32ui
+from pywin32_testutil import str2bytes
+from pywintypes import Unicode
+from win32com import storagecon
+from win32com.axcontrol import axcontrol
+from win32com.test.util import CheckClean
+
+S_OK = 0
+
+
+import win32timezone
+
+now = win32timezone.now()
+
+
+class LockBytes:
+    _public_methods_ = [
+        "ReadAt",
+        "WriteAt",
+        "Flush",
+        "SetSize",
+        "LockRegion",
+        "UnlockRegion",
+        "Stat",
+    ]
+    _com_interfaces_ = [pythoncom.IID_ILockBytes]
+
+    def __init__(self, data=""):
+        self.data = str2bytes(data)
+        self.ctime = now
+        self.mtime = now
+        self.atime = now
+
+    def ReadAt(self, offset, cb):
+        print("ReadAt")
+        result = self.data[offset : offset + cb]
+        return result
+
+    def WriteAt(self, offset, data):
+        print("WriteAt " + str(offset))
+        print("len " + str(len(data)))
+        print("data:")
+        # print data
+        if len(self.data) >= offset:
+            newdata = self.data[0:offset] + data
+        print(len(newdata))
+        if len(self.data) >= offset + len(data):
+            newdata = newdata + self.data[offset + len(data) :]
+        print(len(newdata))
+        self.data = newdata
+        return len(data)
+
+    def Flush(self, whatsthis=0):
+        print("Flush" + str(whatsthis))
+        fname = os.path.join(win32api.GetTempPath(), "persist.doc")
+        open(fname, "wb").write(self.data)
+        return S_OK
+
+    def SetSize(self, size):
+        print("Set Size" + str(size))
+        if size > len(self.data):
+            self.data = self.data + str2bytes("\000" * (size - len(self.data)))
+        else:
+            self.data = self.data[0:size]
+        return S_OK
+
+    def LockRegion(self, offset, size, locktype):
+        print("LockRegion")
+
+    def UnlockRegion(self, offset, size, locktype):
+        print("UnlockRegion")
+
+    def Stat(self, statflag):
+        print("returning Stat " + str(statflag))
+        return (
+            "PyMemBytes",
+            storagecon.STGTY_LOCKBYTES,
+            len(self.data),
+            self.mtime,
+            self.ctime,
+            self.atime,
+            storagecon.STGM_DIRECT | storagecon.STGM_READWRITE | storagecon.STGM_CREATE,
+            storagecon.STGM_SHARE_EXCLUSIVE,
+            "{00020905-0000-0000-C000-000000000046}",
+            0,  # statebits ?
+            0,
+        )
+
+
+class OleClientSite:
+    _public_methods_ = [
+        "SaveObject",
+        "GetMoniker",
+        "GetContainer",
+        "ShowObject",
+        "OnShowWindow",
+        "RequestNewObjectLayout",
+    ]
+    _com_interfaces_ = [axcontrol.IID_IOleClientSite]
+
+    def __init__(self, data=""):
+        self.IPersistStorage = None
+        self.IStorage = None
+
+    def SetIPersistStorage(self, IPersistStorage):
+        self.IPersistStorage = IPersistStorage
+
+    def SetIStorage(self, IStorage):
+        self.IStorage = IStorage
+
+    def SaveObject(self):
+        print("SaveObject")
+        if self.IPersistStorage != None and self.IStorage != None:
+            self.IPersistStorage.Save(self.IStorage, 1)
+            self.IStorage.Commit(0)
+        return S_OK
+
+    def GetMoniker(self, dwAssign, dwWhichMoniker):
+        print("GetMoniker " + str(dwAssign) + " " + str(dwWhichMoniker))
+
+    def GetContainer(self):
+        print("GetContainer")
+
+    def ShowObject(self):
+        print("ShowObject")
+
+    def OnShowWindow(self, fShow):
+        print("ShowObject" + str(fShow))
+
+    def RequestNewObjectLayout(self):
+        print("RequestNewObjectLayout")
+
+
+def test():
+    # create a LockBytes object and
+    # wrap it as a COM object
+    #       import win32com.server.dispatcher
+    lbcom = win32com.server.util.wrap(
+        LockBytes(), pythoncom.IID_ILockBytes
+    )  # , useDispatcher=win32com.server.dispatcher.DispatcherWin32trace)
+
+    # create a structured storage on the ILockBytes object
+    stcom = pythoncom.StgCreateDocfileOnILockBytes(
+        lbcom,
+        storagecon.STGM_DIRECT
+        | storagecon.STGM_CREATE
+        | storagecon.STGM_READWRITE
+        | storagecon.STGM_SHARE_EXCLUSIVE,
+        0,
+    )
+
+    # create our ClientSite
+    ocs = OleClientSite()
+    # wrap it as a COM object
+    ocscom = win32com.server.util.wrap(ocs, axcontrol.IID_IOleClientSite)
+
+    # create a Word OLE Document, connect it to our site and our storage
+    oocom = axcontrol.OleCreate(
+        "{00020906-0000-0000-C000-000000000046}",
+        axcontrol.IID_IOleObject,
+        0,
+        (0,),
+        ocscom,
+        stcom,
+    )
+
+    mf = win32ui.GetMainFrame()
+    hwnd = mf.GetSafeHwnd()
+
+    # Set the host and document name
+    # for unknown reason document name becomes hostname, and document name
+    # is not set, debugged it, but don't know where the problem is?
+    oocom.SetHostNames("OTPython", "This is Cool")
+
+    # activate the OLE document
+    oocom.DoVerb(-1, ocscom, 0, hwnd, mf.GetWindowRect())
+
+    # set the hostnames again
+    oocom.SetHostNames("OTPython2", "ThisisCool2")
+
+    # get IDispatch of Word
+    doc = win32com.client.Dispatch(oocom.QueryInterface(pythoncom.IID_IDispatch))
+
+    # get IPersistStorage of Word
+    dpcom = oocom.QueryInterface(pythoncom.IID_IPersistStorage)
+
+    # let our ClientSite know the interfaces
+    ocs.SetIPersistStorage(dpcom)
+    ocs.SetIStorage(stcom)
+
+    # use IDispatch to do the Office Word test
+    # pasted from TestOffice.py
+
+    wrange = doc.Range()
+    for i in range(10):
+        wrange.InsertAfter("Hello from Python %d\n" % i)
+    paras = doc.Paragraphs
+    for i in range(len(paras)):
+        paras[i]().Font.ColorIndex = i + 1
+        paras[i]().Font.Size = 12 + (4 * i)
+    # XXX - note that
+    # for para in paras:
+    #       para().Font...
+    # doesnt seem to work - no error, just doesnt work
+    # Should check if it works for VB!
+
+    dpcom.Save(stcom, 0)
+    dpcom.HandsOffStorage()
+    #       oocom.Close(axcontrol.OLECLOSE_NOSAVE) # or OLECLOSE_SAVEIFDIRTY, but it fails???
+
+    # Save the ILockBytes data to "persist2.doc"
+    lbcom.Flush()
+
+    # exiting Winword will automatically update the ILockBytes data
+    # and flush it to "%TEMP%\persist.doc"
+    doc.Application.Quit()
+
+
+if __name__ == "__main__":
+    test()
+    pythoncom.CoUninitialize()
+    CheckClean()
diff --git a/lib/win32com/test/testPippo.py b/lib/win32com/test/testPippo.py
new file mode 100644
index 00000000..a1a762c2
--- /dev/null
+++ b/lib/win32com/test/testPippo.py
@@ -0,0 +1,82 @@
+import sys
+import unittest
+
+import pythoncom
+from win32com.client import Dispatch
+from win32com.client.gencache import EnsureDispatch
+
+
+class PippoTester(unittest.TestCase):
+    def setUp(self):
+        from win32com.test import pippo_server
+        from win32com.test.util import RegisterPythonServer
+
+        RegisterPythonServer(pippo_server.__file__, "Python.Test.Pippo")
+        # create it.
+        self.object = Dispatch("Python.Test.Pippo")
+
+    def testLeaks(self):
+        try:
+            gtrc = sys.gettotalrefcount
+        except AttributeError:
+            print("Please run this with python_d for leak tests")
+            gtrc = lambda: 0
+        # note creating self.object() should have consumed our "one time" leaks
+        self.object.Method1()
+        start = gtrc()
+        for i in range(1000):
+            object = Dispatch("Python.Test.Pippo")
+            object.Method1()
+        object = None
+        end = gtrc()
+        if end - start > 5:
+            self.fail("We lost %d references!" % (end - start,))
+
+    def testResults(self):
+        rc, out1 = self.object.Method2(123, 111)
+        self.assertEqual(rc, 123)
+        self.assertEqual(out1, 222)
+
+    def testPythonArrays(self):
+        self._testArray([-3, -2, -1, 0, 1, 2, 3])
+        self._testArray([-3.14, -2, -0.1, 0.0, 1.1, 2.5, 3])
+
+    def testNumpyArrays(self):
+        try:
+            import numpy
+        except:
+            print("Numpy test not possible because numpy module failed to import")
+            return
+        self._testArray(numpy.array([-3, -2, -1, 0, 1, 2, 3]))
+        self._testArray(numpy.array([-3.14, -2, -0.1, 0.0, 1.1, 2.5, 3]))
+
+    def testByteArrays(self):
+        if "bytes" in dir(__builtins__):
+            # Use eval to avoid compilation error in Python 2.
+            self._testArray(eval("b'abcdef'"))
+            self._testArray(eval("bytearray(b'abcdef')"))
+
+    def _testArray(self, inArray):
+        outArray = self.object.Method3(inArray)
+        self.assertEqual(list(outArray), list(inArray))
+
+    def testLeaksGencache(self):
+        try:
+            gtrc = sys.gettotalrefcount
+        except AttributeError:
+            print("Please run this with python_d for leak tests")
+            gtrc = lambda: 0
+        # note creating self.object() should have consumed our "one time" leaks
+        object = EnsureDispatch("Python.Test.Pippo")
+        start = gtrc()
+        for i in range(1000):
+            object = EnsureDispatch("Python.Test.Pippo")
+            object.Method1()
+        object = None
+        end = gtrc()
+        if end - start > 10:
+            self.fail("We lost %d references!" % (end - start,))
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/lib/win32com/test/testPyComTest.py b/lib/win32com/test/testPyComTest.py
new file mode 100644
index 00000000..aec0a6f5
--- /dev/null
+++ b/lib/win32com/test/testPyComTest.py
@@ -0,0 +1,835 @@
+# NOTE - Still seems to be a leak here somewhere
+# gateway count doesnt hit zero.  Hence the print statements!
+
+import sys
+
+sys.coinit_flags = 0  # Must be free-threaded!
+import datetime
+import decimal
+import os
+import time
+
+import pythoncom
+import pywintypes
+import win32api
+import win32com
+import win32com.client.connect
+import win32timezone
+import winerror
+from pywin32_testutil import str2memory
+from win32com.client import VARIANT, CastTo, DispatchBaseClass, constants
+from win32com.test.util import CheckClean, RegisterPythonServer
+
+importMsg = "**** PyCOMTest is not installed ***\n  PyCOMTest is a Python test specific COM client and server.\n  It is likely this server is not installed on this machine\n  To install the server, you must get the win32com sources\n  and build it using MS Visual C++"
+
+error = Exception
+
+# This test uses a Python implemented COM server - ensure correctly registered.
+RegisterPythonServer(
+    os.path.join(os.path.dirname(__file__), "..", "servers", "test_pycomtest.py"),
+    "Python.Test.PyCOMTest",
+)
+
+from win32com.client import gencache
+
+try:
+    gencache.EnsureModule("{6BCDCB60-5605-11D0-AE5F-CADD4C000000}", 0, 1, 1)
+except pythoncom.com_error:
+    print("The PyCOMTest module can not be located or generated.")
+    print(importMsg)
+    raise RuntimeError(importMsg)
+
+# We had a bg where RegisterInterfaces would fail if gencache had
+# already been run - exercise that here
+from win32com import universal
+
+universal.RegisterInterfaces("{6BCDCB60-5605-11D0-AE5F-CADD4C000000}", 0, 1, 1)
+
+verbose = 0
+
+
+def check_get_set(func, arg):
+    got = func(arg)
+    if got != arg:
+        raise error("%s failed - expected %r, got %r" % (func, arg, got))
+
+
+def check_get_set_raises(exc, func, arg):
+    try:
+        got = func(arg)
+    except exc as e:
+        pass  # what we expect!
+    else:
+        raise error(
+            "%s with arg %r didn't raise %s - returned %r" % (func, arg, exc, got)
+        )
+
+
+def progress(*args):
+    if verbose:
+        for arg in args:
+            print(arg, end=" ")
+        print()
+
+
+def TestApplyResult(fn, args, result):
+    try:
+        fnName = str(fn).split()[1]
+    except:
+        fnName = str(fn)
+    progress("Testing ", fnName)
+    pref = "function " + fnName
+    rc = fn(*args)
+    if rc != result:
+        raise error("%s failed - result not %r but %r" % (pref, result, rc))
+
+
+def TestConstant(constName, pyConst):
+    try:
+        comConst = getattr(constants, constName)
+    except:
+        raise error("Constant %s missing" % (constName,))
+    if comConst != pyConst:
+        raise error(
+            "Constant value wrong for %s - got %s, wanted %s"
+            % (constName, comConst, pyConst)
+        )
+
+
+# Simple handler class.  This demo only fires one event.
+class RandomEventHandler:
+    def _Init(self):
+        self.fireds = {}
+
+    def OnFire(self, no):
+        try:
+            self.fireds[no] = self.fireds[no] + 1
+        except KeyError:
+            self.fireds[no] = 0
+
+    def OnFireWithNamedParams(self, no, a_bool, out1, out2):
+        # This test exists mainly to help with an old bug, where named
+        # params would come in reverse.
+        Missing = pythoncom.Missing
+        if no is not Missing:
+            # We know our impl called 'OnFire' with the same ID
+            assert no in self.fireds
+            assert no + 1 == out1, "expecting 'out1' param to be ID+1"
+            assert no + 2 == out2, "expecting 'out2' param to be ID+2"
+        # The middle must be a boolean.
+        assert a_bool is Missing or type(a_bool) == bool, "middle param not a bool"
+        return out1 + 2, out2 + 2
+
+    def _DumpFireds(self):
+        if not self.fireds:
+            print("ERROR: Nothing was received!")
+        for firedId, no in self.fireds.items():
+            progress("ID %d fired %d times" % (firedId, no))
+
+
+# A simple handler class that derives from object (ie, a "new style class") -
+# only relevant for Python 2.x (ie, the 2 classes should be identical in 3.x)
+class NewStyleRandomEventHandler(object):
+    def _Init(self):
+        self.fireds = {}
+
+    def OnFire(self, no):
+        try:
+            self.fireds[no] = self.fireds[no] + 1
+        except KeyError:
+            self.fireds[no] = 0
+
+    def OnFireWithNamedParams(self, no, a_bool, out1, out2):
+        # This test exists mainly to help with an old bug, where named
+        # params would come in reverse.
+        Missing = pythoncom.Missing
+        if no is not Missing:
+            # We know our impl called 'OnFire' with the same ID
+            assert no in self.fireds
+            assert no + 1 == out1, "expecting 'out1' param to be ID+1"
+            assert no + 2 == out2, "expecting 'out2' param to be ID+2"
+        # The middle must be a boolean.
+        assert a_bool is Missing or type(a_bool) == bool, "middle param not a bool"
+        return out1 + 2, out2 + 2
+
+    def _DumpFireds(self):
+        if not self.fireds:
+            print("ERROR: Nothing was received!")
+        for firedId, no in self.fireds.items():
+            progress("ID %d fired %d times" % (firedId, no))
+
+
+# Test everything which can be tested using both the "dynamic" and "generated"
+# COM objects (or when there are very subtle differences)
+def TestCommon(o, is_generated):
+    progress("Getting counter")
+    counter = o.GetSimpleCounter()
+    TestCounter(counter, is_generated)
+
+    progress("Checking default args")
+    rc = o.TestOptionals()
+    if rc[:-1] != ("def", 0, 1) or abs(rc[-1] - 3.14) > 0.01:
+        print(rc)
+        raise error("Did not get the optional values correctly")
+    rc = o.TestOptionals("Hi", 2, 3, 1.1)
+    if rc[:-1] != ("Hi", 2, 3) or abs(rc[-1] - 1.1) > 0.01:
+        print(rc)
+        raise error("Did not get the specified optional values correctly")
+    rc = o.TestOptionals2(0)
+    if rc != (0, "", 1):
+        print(rc)
+        raise error("Did not get the optional2 values correctly")
+    rc = o.TestOptionals2(1.1, "Hi", 2)
+    if rc[1:] != ("Hi", 2) or abs(rc[0] - 1.1) > 0.01:
+        print(rc)
+        raise error("Did not get the specified optional2 values correctly")
+
+    progress("Checking getting/passing IUnknown")
+    check_get_set(o.GetSetUnknown, o)
+    progress("Checking getting/passing IDispatch")
+    # This might be called with either the interface or the CoClass - but these
+    # functions always return from the interface.
+    expected_class = o.__class__
+    # CoClass instances have `default_interface`
+    expected_class = getattr(expected_class, "default_interface", expected_class)
+    if not isinstance(o.GetSetDispatch(o), expected_class):
+        raise error("GetSetDispatch failed: %r" % (o.GetSetDispatch(o),))
+    progress("Checking getting/passing IDispatch of known type")
+    expected_class = o.__class__
+    expected_class = getattr(expected_class, "default_interface", expected_class)
+    if o.GetSetInterface(o).__class__ != expected_class:
+        raise error("GetSetDispatch failed")
+
+    progress("Checking misc args")
+    check_get_set(o.GetSetVariant, 4)
+    check_get_set(o.GetSetVariant, "foo")
+    check_get_set(o.GetSetVariant, o)
+
+    # signed/unsigned.
+    check_get_set(o.GetSetInt, 0)
+    check_get_set(o.GetSetInt, -1)
+    check_get_set(o.GetSetInt, 1)
+
+    check_get_set(o.GetSetUnsignedInt, 0)
+    check_get_set(o.GetSetUnsignedInt, 1)
+    check_get_set(o.GetSetUnsignedInt, 0x80000000)
+    if o.GetSetUnsignedInt(-1) != 0xFFFFFFFF:
+        # -1 is a special case - we accept a negative int (silently converting to
+        # unsigned) but when getting it back we convert it to a long.
+        raise error("unsigned -1 failed")
+
+    check_get_set(o.GetSetLong, 0)
+    check_get_set(o.GetSetLong, -1)
+    check_get_set(o.GetSetLong, 1)
+
+    check_get_set(o.GetSetUnsignedLong, 0)
+    check_get_set(o.GetSetUnsignedLong, 1)
+    check_get_set(o.GetSetUnsignedLong, 0x80000000)
+    # -1 is a special case - see above.
+    if o.GetSetUnsignedLong(-1) != 0xFFFFFFFF:
+        raise error("unsigned -1 failed")
+
+    # We want to explicitly test > 32 bits.  py3k has no 'maxint' and
+    # 'maxsize+1' is no good on 64bit platforms as its 65 bits!
+    big = 2147483647  # sys.maxint on py2k
+    for l in big, big + 1, 1 << 65:
+        check_get_set(o.GetSetVariant, l)
+
+    progress("Checking structs")
+    r = o.GetStruct()
+    assert r.int_value == 99 and str(r.str_value) == "Hello from C++"
+    assert o.DoubleString("foo") == "foofoo"
+
+    progress("Checking var args")
+    o.SetVarArgs("Hi", "There", "From", "Python", 1)
+    if o.GetLastVarArgs() != ("Hi", "There", "From", "Python", 1):
+        raise error("VarArgs failed -" + str(o.GetLastVarArgs()))
+
+    progress("Checking arrays")
+    l = []
+    TestApplyResult(o.SetVariantSafeArray, (l,), len(l))
+    l = [1, 2, 3, 4]
+    TestApplyResult(o.SetVariantSafeArray, (l,), len(l))
+    TestApplyResult(
+        o.CheckVariantSafeArray,
+        (
+            (
+                1,
+                2,
+                3,
+                4,
+            ),
+        ),
+        1,
+    )
+
+    # and binary
+    TestApplyResult(o.SetBinSafeArray, (str2memory("foo\0bar"),), 7)
+
+    progress("Checking properties")
+    o.LongProp = 3
+    if o.LongProp != 3 or o.IntProp != 3:
+        raise error("Property value wrong - got %d/%d" % (o.LongProp, o.IntProp))
+    o.LongProp = o.IntProp = -3
+    if o.LongProp != -3 or o.IntProp != -3:
+        raise error("Property value wrong - got %d/%d" % (o.LongProp, o.IntProp))
+    # This number fits in an unsigned long.  Attempting to set it to a normal
+    # long will involve overflow, which is to be expected. But we do
+    # expect it to work in a property explicitly a VT_UI4.
+    check = 3 * 10**9
+    o.ULongProp = check
+    if o.ULongProp != check:
+        raise error(
+            "Property value wrong - got %d (expected %d)" % (o.ULongProp, check)
+        )
+
+    TestApplyResult(o.Test, ("Unused", 99), 1)  # A bool function
+    TestApplyResult(o.Test, ("Unused", -1), 1)  # A bool function
+    TestApplyResult(o.Test, ("Unused", 1 == 1), 1)  # A bool function
+    TestApplyResult(o.Test, ("Unused", 0), 0)
+    TestApplyResult(o.Test, ("Unused", 1 == 0), 0)
+
+    assert o.DoubleString("foo") == "foofoo"
+
+    TestConstant("ULongTest1", 0xFFFFFFFF)
+    TestConstant("ULongTest2", 0x7FFFFFFF)
+    TestConstant("LongTest1", -0x7FFFFFFF)
+    TestConstant("LongTest2", 0x7FFFFFFF)
+    TestConstant("UCharTest", 255)
+    TestConstant("CharTest", -1)
+    # 'Hello World', but the 'r' is the "Registered" sign (\xae)
+    TestConstant("StringTest", "Hello Wo\xaeld")
+
+    progress("Checking dates and times")
+    # For now *all* times passed must be tz-aware.
+    now = win32timezone.now()
+    # but conversion to and from a VARIANT loses sub-second...
+    now = now.replace(microsecond=0)
+    later = now + datetime.timedelta(seconds=1)
+    TestApplyResult(o.EarliestDate, (now, later), now)
+
+    # The below used to fail with `ValueError: microsecond must be in 0..999999` - see #1655
+    # https://planetcalc.com/7027/ says that float is: Sun, 25 Mar 1951 7:23:49 am
+    assert o.MakeDate(18712.308206013888) == datetime.datetime.fromisoformat(
+        "1951-03-25 07:23:49+00:00"
+    )
+
+    progress("Checking currency")
+    # currency.
+    pythoncom.__future_currency__ = 1
+    if o.CurrencyProp != 0:
+        raise error("Expecting 0, got %r" % (o.CurrencyProp,))
+    for val in ("1234.5678", "1234.56", "1234"):
+        o.CurrencyProp = decimal.Decimal(val)
+        if o.CurrencyProp != decimal.Decimal(val):
+            raise error("%s got %r" % (val, o.CurrencyProp))
+    v1 = decimal.Decimal("1234.5678")
+    TestApplyResult(o.DoubleCurrency, (v1,), v1 * 2)
+
+    v2 = decimal.Decimal("9012.3456")
+    TestApplyResult(o.AddCurrencies, (v1, v2), v1 + v2)
+
+    TestTrickyTypesWithVariants(o, is_generated)
+    progress("Checking win32com.client.VARIANT")
+    TestPyVariant(o, is_generated)
+
+
+def TestTrickyTypesWithVariants(o, is_generated):
+    # Test tricky stuff with type handling and generally only works with
+    # "generated" support but can be worked around using VARIANT.
+    if is_generated:
+        got = o.TestByRefVariant(2)
+    else:
+        v = VARIANT(pythoncom.VT_BYREF | pythoncom.VT_VARIANT, 2)
+        o.TestByRefVariant(v)
+        got = v.value
+    if got != 4:
+        raise error("TestByRefVariant failed")
+
+    if is_generated:
+        got = o.TestByRefString("Foo")
+    else:
+        v = VARIANT(pythoncom.VT_BYREF | pythoncom.VT_BSTR, "Foo")
+        o.TestByRefString(v)
+        got = v.value
+    if got != "FooFoo":
+        raise error("TestByRefString failed")
+
+    # check we can pass ints as a VT_UI1
+    vals = [1, 2, 3, 4]
+    if is_generated:
+        arg = vals
+    else:
+        arg = VARIANT(pythoncom.VT_ARRAY | pythoncom.VT_UI1, vals)
+    TestApplyResult(o.SetBinSafeArray, (arg,), len(vals))
+
+    # safearrays of doubles and floats
+    vals = [0, 1.1, 2.2, 3.3]
+    if is_generated:
+        arg = vals
+    else:
+        arg = VARIANT(pythoncom.VT_ARRAY | pythoncom.VT_R8, vals)
+    TestApplyResult(o.SetDoubleSafeArray, (arg,), len(vals))
+
+    if is_generated:
+        arg = vals
+    else:
+        arg = VARIANT(pythoncom.VT_ARRAY | pythoncom.VT_R4, vals)
+    TestApplyResult(o.SetFloatSafeArray, (arg,), len(vals))
+
+    vals = [1.1, 2.2, 3.3, 4.4]
+    expected = (1.1 * 2, 2.2 * 2, 3.3 * 2, 4.4 * 2)
+    if is_generated:
+        TestApplyResult(o.ChangeDoubleSafeArray, (vals,), expected)
+    else:
+        arg = VARIANT(pythoncom.VT_BYREF | pythoncom.VT_ARRAY | pythoncom.VT_R8, vals)
+        o.ChangeDoubleSafeArray(arg)
+        if arg.value != expected:
+            raise error("ChangeDoubleSafeArray got the wrong value")
+
+    if is_generated:
+        got = o.DoubleInOutString("foo")
+    else:
+        v = VARIANT(pythoncom.VT_BYREF | pythoncom.VT_BSTR, "foo")
+        o.DoubleInOutString(v)
+        got = v.value
+    assert got == "foofoo", got
+
+    val = decimal.Decimal("1234.5678")
+    if is_generated:
+        got = o.DoubleCurrencyByVal(val)
+    else:
+        v = VARIANT(pythoncom.VT_BYREF | pythoncom.VT_CY, val)
+        o.DoubleCurrencyByVal(v)
+        got = v.value
+    assert got == val * 2
+
+
+def TestDynamic():
+    progress("Testing Dynamic")
+    import win32com.client.dynamic
+
+    o = win32com.client.dynamic.DumbDispatch("PyCOMTest.PyCOMTest")
+    TestCommon(o, False)
+
+    counter = win32com.client.dynamic.DumbDispatch("PyCOMTest.SimpleCounter")
+    TestCounter(counter, False)
+
+    # Dynamic doesn't know this should be an int, so we get a COM
+    # TypeMismatch error.
+    try:
+        check_get_set_raises(ValueError, o.GetSetInt, "foo")
+        raise error("no exception raised")
+    except pythoncom.com_error as exc:
+        if exc.hresult != winerror.DISP_E_TYPEMISMATCH:
+            raise
+
+    arg1 = VARIANT(pythoncom.VT_R4 | pythoncom.VT_BYREF, 2.0)
+    arg2 = VARIANT(pythoncom.VT_BOOL | pythoncom.VT_BYREF, True)
+    arg3 = VARIANT(pythoncom.VT_I4 | pythoncom.VT_BYREF, 4)
+    o.TestInOut(arg1, arg2, arg3)
+    assert arg1.value == 4.0, arg1
+    assert arg2.value == False
+    assert arg3.value == 8
+
+    # damn - props with params don't work for dynamic objects :(
+    # o.SetParamProp(0, 1)
+    # if o.ParamProp(0) != 1:
+    #    raise RuntimeError, o.paramProp(0)
+
+
+def TestGenerated():
+    # Create an instance of the server.
+    from win32com.client.gencache import EnsureDispatch
+
+    o = EnsureDispatch("PyCOMTest.PyCOMTest")
+    TestCommon(o, True)
+
+    counter = EnsureDispatch("PyCOMTest.SimpleCounter")
+    TestCounter(counter, True)
+
+    # This dance lets us get a CoClass even though it's not explicitly registered.
+    # This is `CoPyComTest`
+    from win32com.client.CLSIDToClass import GetClass
+
+    coclass_o = GetClass("{8EE0C520-5605-11D0-AE5F-CADD4C000000}")()
+    TestCommon(coclass_o, True)
+
+    # Test the regression reported in #1753
+    assert bool(coclass_o)
+
+    # This is `CoSimpleCounter` and the counter tests should work.
+    coclass = GetClass("{B88DD310-BAE8-11D0-AE86-76F2C1000000}")()
+    TestCounter(coclass, True)
+
+    # XXX - this is failing in dynamic tests, but should work fine.
+    i1, i2 = o.GetMultipleInterfaces()
+    if not isinstance(i1, DispatchBaseClass) or not isinstance(i2, DispatchBaseClass):
+        # Yay - is now an instance returned!
+        raise error(
+            "GetMultipleInterfaces did not return instances - got '%s', '%s'" % (i1, i2)
+        )
+    del i1
+    del i2
+
+    # Generated knows to only pass a 32bit int, so should fail.
+    check_get_set_raises(OverflowError, o.GetSetInt, 0x80000000)
+    check_get_set_raises(OverflowError, o.GetSetLong, 0x80000000)
+
+    # Generated knows this should be an int, so raises ValueError
+    check_get_set_raises(ValueError, o.GetSetInt, "foo")
+    check_get_set_raises(ValueError, o.GetSetLong, "foo")
+
+    # Pass some non-sequence objects to our array decoder, and watch it fail.
+    try:
+        o.SetVariantSafeArray("foo")
+        raise error("Expected a type error")
+    except TypeError:
+        pass
+    try:
+        o.SetVariantSafeArray(666)
+        raise error("Expected a type error")
+    except TypeError:
+        pass
+
+    o.GetSimpleSafeArray(None)
+    TestApplyResult(o.GetSimpleSafeArray, (None,), tuple(range(10)))
+    resultCheck = tuple(range(5)), tuple(range(10)), tuple(range(20))
+    TestApplyResult(o.GetSafeArrays, (None, None, None), resultCheck)
+
+    l = []
+    TestApplyResult(o.SetIntSafeArray, (l,), len(l))
+    l = [1, 2, 3, 4]
+    TestApplyResult(o.SetIntSafeArray, (l,), len(l))
+    ll = [1, 2, 3, 0x100000000]
+    TestApplyResult(o.SetLongLongSafeArray, (ll,), len(ll))
+    TestApplyResult(o.SetULongLongSafeArray, (ll,), len(ll))
+
+    # Tell the server to do what it does!
+    TestApplyResult(o.Test2, (constants.Attr2,), constants.Attr2)
+    TestApplyResult(o.Test3, (constants.Attr2,), constants.Attr2)
+    TestApplyResult(o.Test4, (constants.Attr2,), constants.Attr2)
+    TestApplyResult(o.Test5, (constants.Attr2,), constants.Attr2)
+
+    TestApplyResult(o.Test6, (constants.WideAttr1,), constants.WideAttr1)
+    TestApplyResult(o.Test6, (constants.WideAttr2,), constants.WideAttr2)
+    TestApplyResult(o.Test6, (constants.WideAttr3,), constants.WideAttr3)
+    TestApplyResult(o.Test6, (constants.WideAttr4,), constants.WideAttr4)
+    TestApplyResult(o.Test6, (constants.WideAttr5,), constants.WideAttr5)
+
+    TestApplyResult(o.TestInOut, (2.0, True, 4), (4.0, False, 8))
+
+    o.SetParamProp(0, 1)
+    if o.ParamProp(0) != 1:
+        raise RuntimeError(o.paramProp(0))
+
+    # Make sure CastTo works - even though it is only casting it to itself!
+    o2 = CastTo(o, "IPyCOMTest")
+    if o != o2:
+        raise error("CastTo should have returned the same object")
+
+    # Do the connection point thing...
+    # Create a connection object.
+    progress("Testing connection points")
+    o2 = win32com.client.DispatchWithEvents(o, RandomEventHandler)
+    TestEvents(o2, o2)
+    o2 = win32com.client.DispatchWithEvents(o, NewStyleRandomEventHandler)
+    TestEvents(o2, o2)
+    # and a plain "WithEvents".
+    handler = win32com.client.WithEvents(o, RandomEventHandler)
+    TestEvents(o, handler)
+    handler = win32com.client.WithEvents(o, NewStyleRandomEventHandler)
+    TestEvents(o, handler)
+    progress("Finished generated .py test.")
+
+
+def TestEvents(o, handler):
+    sessions = []
+    handler._Init()
+    try:
+        for i in range(3):
+            session = o.Start()
+            sessions.append(session)
+        time.sleep(0.5)
+    finally:
+        # Stop the servers
+        for session in sessions:
+            o.Stop(session)
+        handler._DumpFireds()
+        handler.close()
+
+
+def _TestPyVariant(o, is_generated, val, checker=None):
+    if is_generated:
+        vt, got = o.GetVariantAndType(val)
+    else:
+        # Gotta supply all 3 args with the last 2 being explicit variants to
+        # get the byref behaviour.
+        var_vt = VARIANT(pythoncom.VT_UI2 | pythoncom.VT_BYREF, 0)
+        var_result = VARIANT(pythoncom.VT_VARIANT | pythoncom.VT_BYREF, 0)
+        o.GetVariantAndType(val, var_vt, var_result)
+        vt = var_vt.value
+        got = var_result.value
+    if checker is not None:
+        checker(got)
+        return
+    # default checking.
+    assert vt == val.varianttype, (vt, val.varianttype)
+    # Handle our safe-array test - if the passed value is a list of variants,
+    # compare against the actual values.
+    if type(val.value) in (tuple, list):
+        check = [v.value if isinstance(v, VARIANT) else v for v in val.value]
+        # pythoncom always returns arrays as tuples.
+        got = list(got)
+    else:
+        check = val.value
+    assert type(check) == type(got), (type(check), type(got))
+    assert check == got, (check, got)
+
+
+def _TestPyVariantFails(o, is_generated, val, exc):
+    try:
+        _TestPyVariant(o, is_generated, val)
+        raise error("Setting %r didn't raise %s" % (val, exc))
+    except exc:
+        pass
+
+
+def TestPyVariant(o, is_generated):
+    _TestPyVariant(o, is_generated, VARIANT(pythoncom.VT_UI1, 1))
+    _TestPyVariant(
+        o, is_generated, VARIANT(pythoncom.VT_ARRAY | pythoncom.VT_UI4, [1, 2, 3])
+    )
+    _TestPyVariant(o, is_generated, VARIANT(pythoncom.VT_BSTR, "hello"))
+    _TestPyVariant(
+        o,
+        is_generated,
+        VARIANT(pythoncom.VT_ARRAY | pythoncom.VT_BSTR, ["hello", "there"]),
+    )
+
+    def check_dispatch(got):
+        assert isinstance(got._oleobj_, pythoncom.TypeIIDs[pythoncom.IID_IDispatch])
+
+    _TestPyVariant(o, is_generated, VARIANT(pythoncom.VT_DISPATCH, o), check_dispatch)
+    _TestPyVariant(
+        o, is_generated, VARIANT(pythoncom.VT_ARRAY | pythoncom.VT_DISPATCH, [o])
+    )
+    # an array of variants each with a specific type.
+    v = VARIANT(
+        pythoncom.VT_ARRAY | pythoncom.VT_VARIANT,
+        [
+            VARIANT(pythoncom.VT_UI4, 1),
+            VARIANT(pythoncom.VT_UI4, 2),
+            VARIANT(pythoncom.VT_UI4, 3),
+        ],
+    )
+    _TestPyVariant(o, is_generated, v)
+
+    # and failures
+    _TestPyVariantFails(o, is_generated, VARIANT(pythoncom.VT_UI1, "foo"), ValueError)
+
+
+def TestCounter(counter, bIsGenerated):
+    # Test random access into container
+    progress("Testing counter", repr(counter))
+    import random
+
+    for i in range(50):
+        num = int(random.random() * len(counter))
+        try:
+            # XXX - this appears broken by commit 08a14d4deb374eaa06378509cf44078ad467b9dc -
+            # We shouldn't need to do generated differently than dynamic.
+            if bIsGenerated:
+                ret = counter.Item(num + 1)
+            else:
+                ret = counter[num]
+            if ret != num + 1:
+                raise error(
+                    "Random access into element %d failed - return was %s"
+                    % (num, repr(ret))
+                )
+        except IndexError:
+            raise error("** IndexError accessing collection element %d" % num)
+
+    num = 0
+    if bIsGenerated:
+        counter.SetTestProperty(1)
+        counter.TestProperty = 1  # Note this has a second, default arg.
+        counter.SetTestProperty(1, 2)
+        if counter.TestPropertyWithDef != 0:
+            raise error("Unexpected property set value!")
+        if counter.TestPropertyNoDef(1) != 1:
+            raise error("Unexpected property set value!")
+    else:
+        pass
+        # counter.TestProperty = 1
+
+    counter.LBound = 1
+    counter.UBound = 10
+    if counter.LBound != 1 or counter.UBound != 10:
+        print("** Error - counter did not keep its properties")
+
+    if bIsGenerated:
+        bounds = counter.GetBounds()
+        if bounds[0] != 1 or bounds[1] != 10:
+            raise error("** Error - counter did not give the same properties back")
+        counter.SetBounds(bounds[0], bounds[1])
+
+    for item in counter:
+        num = num + 1
+    if num != len(counter):
+        raise error("*** Length of counter and loop iterations dont match ***")
+    if num != 10:
+        raise error("*** Unexpected number of loop iterations ***")
+
+    try:
+        counter = iter(counter)._iter_.Clone()  # Test Clone() and enum directly
+    except AttributeError:
+        # *sob* - sometimes this is a real iterator and sometimes not :/
+        progress("Finished testing counter (but skipped the iterator stuff")
+        return
+    counter.Reset()
+    num = 0
+    for item in counter:
+        num = num + 1
+    if num != 10:
+        raise error("*** Unexpected number of loop iterations - got %d ***" % num)
+    progress("Finished testing counter")
+
+
+def TestLocalVTable(ob):
+    # Python doesn't fully implement this interface.
+    if ob.DoubleString("foo") != "foofoo":
+        raise error("couldn't foofoo")
+
+
+###############################
+##
+## Some vtable tests of the interface
+##
+def TestVTable(clsctx=pythoncom.CLSCTX_ALL):
+    # Any vtable interfaces marked as dual *should* be able to be
+    # correctly implemented as IDispatch.
+    ob = win32com.client.Dispatch("Python.Test.PyCOMTest")
+    TestLocalVTable(ob)
+    # Now test it via vtable - use some C++ code to help here as Python can't do it directly yet.
+    tester = win32com.client.Dispatch("PyCOMTest.PyCOMTest")
+    testee = pythoncom.CoCreateInstance(
+        "Python.Test.PyCOMTest", None, clsctx, pythoncom.IID_IUnknown
+    )
+    # check we fail gracefully with None passed.
+    try:
+        tester.TestMyInterface(None)
+    except pythoncom.com_error as details:
+        pass
+    # and a real object.
+    tester.TestMyInterface(testee)
+
+
+def TestVTable2():
+    # We once crashed creating our object with the native interface as
+    # the first IID specified.  We must do it _after_ the tests, so that
+    # Python has already had the gateway registered from last run.
+    ob = win32com.client.Dispatch("Python.Test.PyCOMTest")
+    iid = pythoncom.InterfaceNames["IPyCOMTest"]
+    clsid = "Python.Test.PyCOMTest"
+    clsctx = pythoncom.CLSCTX_SERVER
+    try:
+        testee = pythoncom.CoCreateInstance(clsid, None, clsctx, iid)
+    except TypeError:
+        # Python can't actually _use_ this interface yet, so this is
+        # "expected".  Any COM error is not.
+        pass
+
+
+def TestVTableMI():
+    clsctx = pythoncom.CLSCTX_SERVER
+    ob = pythoncom.CoCreateInstance(
+        "Python.Test.PyCOMTestMI", None, clsctx, pythoncom.IID_IUnknown
+    )
+    # This inherits from IStream.
+    ob.QueryInterface(pythoncom.IID_IStream)
+    # This implements IStorage, specifying the IID as a string
+    ob.QueryInterface(pythoncom.IID_IStorage)
+    # IDispatch should always work
+    ob.QueryInterface(pythoncom.IID_IDispatch)
+
+    iid = pythoncom.InterfaceNames["IPyCOMTest"]
+    try:
+        ob.QueryInterface(iid)
+    except TypeError:
+        # Python can't actually _use_ this interface yet, so this is
+        # "expected".  Any COM error is not.
+        pass
+
+
+def TestQueryInterface(long_lived_server=0, iterations=5):
+    tester = win32com.client.Dispatch("PyCOMTest.PyCOMTest")
+    if long_lived_server:
+        # Create a local server
+        t0 = win32com.client.Dispatch(
+            "Python.Test.PyCOMTest", clsctx=pythoncom.CLSCTX_LOCAL_SERVER
+        )
+    # Request custom interfaces a number of times
+    prompt = [
+        "Testing QueryInterface without long-lived local-server #%d of %d...",
+        "Testing QueryInterface with long-lived local-server #%d of %d...",
+    ]
+
+    for i in range(iterations):
+        progress(prompt[long_lived_server != 0] % (i + 1, iterations))
+        tester.TestQueryInterface()
+
+
+class Tester(win32com.test.util.TestCase):
+    def testVTableInProc(self):
+        # We used to crash running this the second time - do it a few times
+        for i in range(3):
+            progress("Testing VTables in-process #%d..." % (i + 1))
+            TestVTable(pythoncom.CLSCTX_INPROC_SERVER)
+
+    def testVTableLocalServer(self):
+        for i in range(3):
+            progress("Testing VTables out-of-process #%d..." % (i + 1))
+            TestVTable(pythoncom.CLSCTX_LOCAL_SERVER)
+
+    def testVTable2(self):
+        for i in range(3):
+            TestVTable2()
+
+    def testVTableMI(self):
+        for i in range(3):
+            TestVTableMI()
+
+    def testMultiQueryInterface(self):
+        TestQueryInterface(0, 6)
+        # When we use the custom interface in the presence of a long-lived
+        # local server, i.e. a local server that is already running when
+        # we request an instance of our COM object, and remains afterwards,
+        # then after repeated requests to create an instance of our object
+        # the custom interface disappears -- i.e. QueryInterface fails with
+        # E_NOINTERFACE. Set the upper range of the following test to 2 to
+        # pass this test, i.e. TestQueryInterface(1,2)
+        TestQueryInterface(1, 6)
+
+    def testDynamic(self):
+        TestDynamic()
+
+    def testGenerated(self):
+        TestGenerated()
+
+
+if __name__ == "__main__":
+    # XXX - todo - Complete hack to crank threading support.
+    # Should NOT be necessary
+    def NullThreadFunc():
+        pass
+
+    import _thread
+
+    _thread.start_new(NullThreadFunc, ())
+
+    if "-v" in sys.argv:
+        verbose = 1
+
+    win32com.test.util.testmain()
diff --git a/lib/win32com/test/testPyScriptlet.js b/lib/win32com/test/testPyScriptlet.js
new file mode 100644
index 00000000..fd9822b9
--- /dev/null
+++ b/lib/win32com/test/testPyScriptlet.js
@@ -0,0 +1,33 @@
+function print(msg)
+{
+  WScript.Echo(msg) ;
+}
+
+function check(condition, msg)
+{
+  if (!condition) {
+    print("***** testPyScriptlet.js failed *****");
+    print(msg);
+  }
+}
+
+var thisScriptEngine = ScriptEngine() ;
+
+var majorVersion = ScriptEngineMajorVersion() ;
+var minorVersion = ScriptEngineMinorVersion() ;
+var buildVersion = ScriptEngineBuildVersion() ;
+
+WScript.Echo(thisScriptEngine + " Version " + majorVersion + "." + minorVersion + " Build " + buildVersion) ;
+
+var scriptlet = new  ActiveXObject("TestPys.Scriptlet") ;
+
+check(scriptlet.PyProp1=="PyScript Property1", "PyProp1 wasn't correct initial value");
+scriptlet.PyProp1 = "New Value";
+check(scriptlet.PyProp1=="New Value", "PyProp1 wasn't correct new value");
+
+check(scriptlet.PyProp2=="PyScript Property2", "PyProp2 wasn't correct initial value");
+scriptlet.PyProp2 = "Another New Value";
+check(scriptlet.PyProp2=="Another New Value", "PyProp2 wasn't correct new value");
+
+check(scriptlet.PyMethod1()=="PyMethod1 called", "Method1 wrong value");
+check(scriptlet.PyMethod2()=="PyMethod2 called", "Method2 wrong value");
diff --git a/lib/win32com/test/testROT.py b/lib/win32com/test/testROT.py
new file mode 100644
index 00000000..5a4ccbcc
--- /dev/null
+++ b/lib/win32com/test/testROT.py
@@ -0,0 +1,29 @@
+import unittest
+
+import pythoncom
+import win32com.test.util
+import winerror
+
+
+class TestROT(win32com.test.util.TestCase):
+    def testit(self):
+        ctx = pythoncom.CreateBindCtx()
+        rot = pythoncom.GetRunningObjectTable()
+        num = 0
+        for mk in rot:
+            name = mk.GetDisplayName(ctx, None)
+            num += 1
+            # Monikers themselves can iterate their contents (sometimes :)
+            try:
+                for sub in mk:
+                    num += 1
+            except pythoncom.com_error as exc:
+                if exc.hresult != winerror.E_NOTIMPL:
+                    raise
+
+        # if num < 2:
+        #    print "Only", num, "objects in the ROT - this is unusual"
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/lib/win32com/test/testServers.py b/lib/win32com/test/testServers.py
new file mode 100644
index 00000000..f25009bf
--- /dev/null
+++ b/lib/win32com/test/testServers.py
@@ -0,0 +1,52 @@
+import unittest
+
+import pythoncom
+import win32com.client.dynamic
+import win32com.test.util
+import winerror
+
+
+def TestConnections():
+    import win32com.demos.connect
+
+    win32com.demos.connect.test()
+
+
+class InterpCase(win32com.test.util.TestCase):
+    def setUp(self):
+        # Ensure the correct version registered.
+        from win32com.servers import interp
+        from win32com.test.util import RegisterPythonServer
+
+        RegisterPythonServer(interp.__file__, "Python.Interpreter")
+
+    def _testInterp(self, interp):
+        self.assertEqual(interp.Eval("1+1"), 2)
+        win32com.test.util.assertRaisesCOM_HRESULT(
+            self, winerror.DISP_E_TYPEMISMATCH, interp.Eval, 2
+        )
+
+    def testInproc(self):
+        interp = win32com.client.dynamic.Dispatch(
+            "Python.Interpreter", clsctx=pythoncom.CLSCTX_INPROC
+        )
+        self._testInterp(interp)
+
+    def testLocalServer(self):
+        interp = win32com.client.dynamic.Dispatch(
+            "Python.Interpreter", clsctx=pythoncom.CLSCTX_LOCAL_SERVER
+        )
+        self._testInterp(interp)
+
+    def testAny(self):
+        interp = win32com.client.dynamic.Dispatch("Python.Interpreter")
+        self._testInterp(interp)
+
+
+class ConnectionsTestCase(win32com.test.util.TestCase):
+    def testConnections(self):
+        TestConnections()
+
+
+if __name__ == "__main__":
+    unittest.main("testServers")
diff --git a/lib/win32com/test/testShell.py b/lib/win32com/test/testShell.py
new file mode 100644
index 00000000..b312a9dc
--- /dev/null
+++ b/lib/win32com/test/testShell.py
@@ -0,0 +1,281 @@
+import datetime
+import os
+import struct
+import sys
+
+import win32timezone
+
+try:
+    sys_maxsize = sys.maxsize  # 2.6 and later - maxsize != maxint on 64bits
+except AttributeError:
+    sys_maxsize = sys.maxint
+
+import pythoncom
+import pywintypes
+import win32com.test.util
+import win32con
+from pywin32_testutil import str2bytes
+from win32com.shell import shell
+from win32com.shell.shellcon import *
+from win32com.storagecon import *
+
+
+class ShellTester(win32com.test.util.TestCase):
+    def testShellLink(self):
+        desktop = str(shell.SHGetSpecialFolderPath(0, CSIDL_DESKTOP))
+        num = 0
+        shellLink = pythoncom.CoCreateInstance(
+            shell.CLSID_ShellLink,
+            None,
+            pythoncom.CLSCTX_INPROC_SERVER,
+            shell.IID_IShellLink,
+        )
+        persistFile = shellLink.QueryInterface(pythoncom.IID_IPersistFile)
+        names = [os.path.join(desktop, n) for n in os.listdir(desktop)]
+        programs = str(shell.SHGetSpecialFolderPath(0, CSIDL_PROGRAMS))
+        names.extend([os.path.join(programs, n) for n in os.listdir(programs)])
+        for name in names:
+            try:
+                persistFile.Load(name, STGM_READ)
+            except pythoncom.com_error:
+                continue
+            # Resolve is slow - avoid it for our tests.
+            # shellLink.Resolve(0, shell.SLR_ANY_MATCH | shell.SLR_NO_UI)
+            fname, findData = shellLink.GetPath(0)
+            unc = shellLink.GetPath(shell.SLGP_UNCPRIORITY)[0]
+            num += 1
+        if num == 0:
+            # This isn't a fatal error, but is unlikely.
+            print(
+                "Could not find any links on your desktop or programs dir, which is unusual"
+            )
+
+    def testShellFolder(self):
+        sf = shell.SHGetDesktopFolder()
+        names_1 = []
+        for i in sf:  # Magically calls EnumObjects
+            name = sf.GetDisplayNameOf(i, SHGDN_NORMAL)
+            names_1.append(name)
+
+        # And get the enumerator manually
+        enum = sf.EnumObjects(
+            0, SHCONTF_FOLDERS | SHCONTF_NONFOLDERS | SHCONTF_INCLUDEHIDDEN
+        )
+        names_2 = []
+        for i in enum:
+            name = sf.GetDisplayNameOf(i, SHGDN_NORMAL)
+            names_2.append(name)
+        names_1.sort()
+        names_2.sort()
+        self.assertEqual(names_1, names_2)
+
+
+class PIDLTester(win32com.test.util.TestCase):
+    def _rtPIDL(self, pidl):
+        pidl_str = shell.PIDLAsString(pidl)
+        pidl_rt = shell.StringAsPIDL(pidl_str)
+        self.assertEqual(pidl_rt, pidl)
+        pidl_str_rt = shell.PIDLAsString(pidl_rt)
+        self.assertEqual(pidl_str_rt, pidl_str)
+
+    def _rtCIDA(self, parent, kids):
+        cida = parent, kids
+        cida_str = shell.CIDAAsString(cida)
+        cida_rt = shell.StringAsCIDA(cida_str)
+        self.assertEqual(cida, cida_rt)
+        cida_str_rt = shell.CIDAAsString(cida_rt)
+        self.assertEqual(cida_str_rt, cida_str)
+
+    def testPIDL(self):
+        # A PIDL of "\1" is:   cb    pidl   cb
+        expect = str2bytes("\03\00" "\1" "\0\0")
+        self.assertEqual(shell.PIDLAsString([str2bytes("\1")]), expect)
+        self._rtPIDL([str2bytes("\0")])
+        self._rtPIDL([str2bytes("\1"), str2bytes("\2"), str2bytes("\3")])
+        self._rtPIDL([str2bytes("\0") * 2048] * 2048)
+        # PIDL must be a list
+        self.assertRaises(TypeError, shell.PIDLAsString, "foo")
+
+    def testCIDA(self):
+        self._rtCIDA([str2bytes("\0")], [[str2bytes("\0")]])
+        self._rtCIDA([str2bytes("\1")], [[str2bytes("\2")]])
+        self._rtCIDA(
+            [str2bytes("\0")], [[str2bytes("\0")], [str2bytes("\1")], [str2bytes("\2")]]
+        )
+
+    def testBadShortPIDL(self):
+        # A too-short child element:   cb    pidl   cb
+        pidl = str2bytes("\01\00" "\1")
+        self.assertRaises(ValueError, shell.StringAsPIDL, pidl)
+
+        # ack - tried to test too long PIDLs, but a len of 0xFFFF may not
+        # always fail.
+
+
+class FILEGROUPDESCRIPTORTester(win32com.test.util.TestCase):
+    def _getTestTimes(self):
+        if issubclass(pywintypes.TimeType, datetime.datetime):
+            ctime = win32timezone.now()
+            # FILETIME only has ms precision...
+            ctime = ctime.replace(microsecond=ctime.microsecond // 1000 * 1000)
+            atime = ctime + datetime.timedelta(seconds=1)
+            wtime = atime + datetime.timedelta(seconds=1)
+        else:
+            ctime = pywintypes.Time(11)
+            atime = pywintypes.Time(12)
+            wtime = pywintypes.Time(13)
+        return ctime, atime, wtime
+
+    def _testRT(self, fd):
+        fgd_string = shell.FILEGROUPDESCRIPTORAsString([fd])
+        fd2 = shell.StringAsFILEGROUPDESCRIPTOR(fgd_string)[0]
+
+        fd = fd.copy()
+        fd2 = fd2.copy()
+
+        # The returned objects *always* have dwFlags and cFileName.
+        if "dwFlags" not in fd:
+            del fd2["dwFlags"]
+        if "cFileName" not in fd:
+            self.assertEqual(fd2["cFileName"], "")
+            del fd2["cFileName"]
+
+        self.assertEqual(fd, fd2)
+
+    def _testSimple(self, make_unicode):
+        fgd = shell.FILEGROUPDESCRIPTORAsString([], make_unicode)
+        header = struct.pack("i", 0)
+        self.assertEqual(header, fgd[: len(header)])
+        self._testRT(dict())
+        d = dict()
+        fgd = shell.FILEGROUPDESCRIPTORAsString([d], make_unicode)
+        header = struct.pack("i", 1)
+        self.assertEqual(header, fgd[: len(header)])
+        self._testRT(d)
+
+    def testSimpleBytes(self):
+        self._testSimple(False)
+
+    def testSimpleUnicode(self):
+        self._testSimple(True)
+
+    def testComplex(self):
+        clsid = pythoncom.MakeIID("{CD637886-DB8B-4b04-98B5-25731E1495BE}")
+        ctime, atime, wtime = self._getTestTimes()
+        d = dict(
+            cFileName="foo.txt",
+            clsid=clsid,
+            sizel=(1, 2),
+            pointl=(3, 4),
+            dwFileAttributes=win32con.FILE_ATTRIBUTE_NORMAL,
+            ftCreationTime=ctime,
+            ftLastAccessTime=atime,
+            ftLastWriteTime=wtime,
+            nFileSize=sys_maxsize + 1,
+        )
+        self._testRT(d)
+
+    def testUnicode(self):
+        # exercise a bug fixed in build 210 - multiple unicode objects failed.
+        ctime, atime, wtime = self._getTestTimes()
+        d = [
+            dict(
+                cFileName="foo.txt",
+                sizel=(1, 2),
+                pointl=(3, 4),
+                dwFileAttributes=win32con.FILE_ATTRIBUTE_NORMAL,
+                ftCreationTime=ctime,
+                ftLastAccessTime=atime,
+                ftLastWriteTime=wtime,
+                nFileSize=sys_maxsize + 1,
+            ),
+            dict(
+                cFileName="foo2.txt",
+                sizel=(1, 2),
+                pointl=(3, 4),
+                dwFileAttributes=win32con.FILE_ATTRIBUTE_NORMAL,
+                ftCreationTime=ctime,
+                ftLastAccessTime=atime,
+                ftLastWriteTime=wtime,
+                nFileSize=sys_maxsize + 1,
+            ),
+            dict(
+                cFileName="foo\xa9.txt",
+                sizel=(1, 2),
+                pointl=(3, 4),
+                dwFileAttributes=win32con.FILE_ATTRIBUTE_NORMAL,
+                ftCreationTime=ctime,
+                ftLastAccessTime=atime,
+                ftLastWriteTime=wtime,
+                nFileSize=sys_maxsize + 1,
+            ),
+        ]
+        s = shell.FILEGROUPDESCRIPTORAsString(d, 1)
+        d2 = shell.StringAsFILEGROUPDESCRIPTOR(s)
+        # clobber 'dwFlags' - they are not expected to be identical
+        for t in d2:
+            del t["dwFlags"]
+        self.assertEqual(d, d2)
+
+
+class FileOperationTester(win32com.test.util.TestCase):
+    def setUp(self):
+        import tempfile
+
+        self.src_name = os.path.join(tempfile.gettempdir(), "pywin32_testshell")
+        self.dest_name = os.path.join(tempfile.gettempdir(), "pywin32_testshell_dest")
+        self.test_data = str2bytes("Hello from\0Python")
+        f = open(self.src_name, "wb")
+        f.write(self.test_data)
+        f.close()
+        try:
+            os.unlink(self.dest_name)
+        except os.error:
+            pass
+
+    def tearDown(self):
+        for fname in (self.src_name, self.dest_name):
+            if os.path.isfile(fname):
+                os.unlink(fname)
+
+    def testCopy(self):
+        s = (0, FO_COPY, self.src_name, self.dest_name)  # hwnd,  # operation
+
+        rc, aborted = shell.SHFileOperation(s)
+        self.assertTrue(not aborted)
+        self.assertEqual(0, rc)
+        self.assertTrue(os.path.isfile(self.src_name))
+        self.assertTrue(os.path.isfile(self.dest_name))
+
+    def testRename(self):
+        s = (0, FO_RENAME, self.src_name, self.dest_name)  # hwnd,  # operation
+        rc, aborted = shell.SHFileOperation(s)
+        self.assertTrue(not aborted)
+        self.assertEqual(0, rc)
+        self.assertTrue(os.path.isfile(self.dest_name))
+        self.assertTrue(not os.path.isfile(self.src_name))
+
+    def testMove(self):
+        s = (0, FO_MOVE, self.src_name, self.dest_name)  # hwnd,  # operation
+        rc, aborted = shell.SHFileOperation(s)
+        self.assertTrue(not aborted)
+        self.assertEqual(0, rc)
+        self.assertTrue(os.path.isfile(self.dest_name))
+        self.assertTrue(not os.path.isfile(self.src_name))
+
+    def testDelete(self):
+        s = (
+            0,  # hwnd,
+            FO_DELETE,  # operation
+            self.src_name,
+            None,
+            FOF_NOCONFIRMATION,
+        )
+        rc, aborted = shell.SHFileOperation(s)
+        self.assertTrue(not aborted)
+        self.assertEqual(0, rc)
+        self.assertTrue(not os.path.isfile(self.src_name))
+
+
+if __name__ == "__main__":
+    win32com.test.util.testmain()
diff --git a/lib/win32com/test/testStorage.py b/lib/win32com/test/testStorage.py
new file mode 100644
index 00000000..5b7e25de
--- /dev/null
+++ b/lib/win32com/test/testStorage.py
@@ -0,0 +1,88 @@
+import unittest
+
+import pythoncom
+import win32api
+import win32com.test.util
+from win32com import storagecon
+
+
+class TestEnum(win32com.test.util.TestCase):
+    def testit(self):
+        fname, tmp = win32api.GetTempFileName(win32api.GetTempPath(), "stg")
+        m = storagecon.STGM_READWRITE | storagecon.STGM_SHARE_EXCLUSIVE
+        ##  file, mode, format, attrs (always 0), IID (IStorage or IPropertySetStorage, storage options(only used with STGFMT_DOCFILE)
+        pss = pythoncom.StgOpenStorageEx(
+            fname, m, storagecon.STGFMT_FILE, 0, pythoncom.IID_IPropertySetStorage
+        )
+        ###                               {"Version":2,"reserved":0,"SectorSize":512,"TemplateFile":u'somefilename'})
+
+        ## FMTID_SummaryInformation FMTID_DocSummaryInformation FMTID_UserDefinedProperties
+        psuser = pss.Create(
+            pythoncom.FMTID_UserDefinedProperties,
+            pythoncom.IID_IPropertySetStorage,
+            storagecon.PROPSETFLAG_DEFAULT,
+            storagecon.STGM_READWRITE
+            | storagecon.STGM_CREATE
+            | storagecon.STGM_SHARE_EXCLUSIVE,
+        )  ## its very picky about flag combinations!
+        psuser.WriteMultiple((3, 4), ("hey", "bubba"))
+        psuser.WritePropertyNames((3, 4), ("property3", "property4"))
+        expected_summaries = []
+        expected_summaries.append(("property3", 3, pythoncom.VT_BSTR))
+        expected_summaries.append(("property4", 4, pythoncom.VT_BSTR))
+        psuser = None
+
+        pssum = pss.Create(
+            pythoncom.FMTID_SummaryInformation,
+            pythoncom.IID_IPropertySetStorage,
+            storagecon.PROPSETFLAG_DEFAULT,
+            storagecon.STGM_READWRITE
+            | storagecon.STGM_CREATE
+            | storagecon.STGM_SHARE_EXCLUSIVE,
+        )
+        pssum.WriteMultiple(
+            (storagecon.PIDSI_AUTHOR, storagecon.PIDSI_COMMENTS), ("me", "comment")
+        )
+
+        pssum = None
+        pss = None  ## doesn't seem to be a close or release method, and you can't even reopen it from the same process until previous object is gone
+
+        pssread = pythoncom.StgOpenStorageEx(
+            fname,
+            storagecon.STGM_READ | storagecon.STGM_SHARE_EXCLUSIVE,
+            storagecon.STGFMT_FILE,
+            0,
+            pythoncom.IID_IPropertySetStorage,
+        )
+        found_summaries = []
+        for psstat in pssread:
+            ps = pssread.Open(
+                psstat[0], storagecon.STGM_READ | storagecon.STGM_SHARE_EXCLUSIVE
+            )
+            for p in ps:
+                p_val = ps.ReadMultiple((p[1],))[0]
+                if (p[1] == storagecon.PIDSI_AUTHOR and p_val == "me") or (
+                    p[1] == storagecon.PIDSI_COMMENTS and p_val == "comment"
+                ):
+                    pass
+                else:
+                    self.fail("Uxexpected property %s/%s" % (p, p_val))
+            ps = None
+            ## FMTID_UserDefinedProperties can't exist without FMTID_DocSummaryInformation, and isn't returned independently from Enum
+            ## also can't be open at same time
+            if psstat[0] == pythoncom.FMTID_DocSummaryInformation:
+                ps = pssread.Open(
+                    pythoncom.FMTID_UserDefinedProperties,
+                    storagecon.STGM_READ | storagecon.STGM_SHARE_EXCLUSIVE,
+                )
+                for p in ps:
+                    found_summaries.append(p)
+                ps = None
+        psread = None
+        expected_summaries.sort()
+        found_summaries.sort()
+        self.assertEqual(expected_summaries, found_summaries)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/lib/win32com/test/testStreams.py b/lib/win32com/test/testStreams.py
new file mode 100644
index 00000000..3beb47c7
--- /dev/null
+++ b/lib/win32com/test/testStreams.py
@@ -0,0 +1,148 @@
+import unittest
+
+import pythoncom
+import win32com.server.util
+import win32com.test.util
+from pywin32_testutil import str2bytes
+
+
+class Persists:
+    _public_methods_ = [
+        "GetClassID",
+        "IsDirty",
+        "Load",
+        "Save",
+        "GetSizeMax",
+        "InitNew",
+    ]
+    _com_interfaces_ = [pythoncom.IID_IPersistStreamInit]
+
+    def __init__(self):
+        self.data = str2bytes("abcdefg")
+        self.dirty = 1
+
+    def GetClassID(self):
+        return pythoncom.IID_NULL
+
+    def IsDirty(self):
+        return self.dirty
+
+    def Load(self, stream):
+        self.data = stream.Read(26)
+
+    def Save(self, stream, clearDirty):
+        stream.Write(self.data)
+        if clearDirty:
+            self.dirty = 0
+
+    def GetSizeMax(self):
+        return 1024
+
+    def InitNew(self):
+        pass
+
+
+class Stream:
+    _public_methods_ = ["Read", "Write", "Seek"]
+    _com_interfaces_ = [pythoncom.IID_IStream]
+
+    def __init__(self, data):
+        self.data = data
+        self.index = 0
+
+    def Read(self, amount):
+        result = self.data[self.index : self.index + amount]
+        self.index = self.index + amount
+        return result
+
+    def Write(self, data):
+        self.data = data
+        self.index = 0
+        return len(data)
+
+    def Seek(self, dist, origin):
+        if origin == pythoncom.STREAM_SEEK_SET:
+            self.index = dist
+        elif origin == pythoncom.STREAM_SEEK_CUR:
+            self.index = self.index + dist
+        elif origin == pythoncom.STREAM_SEEK_END:
+            self.index = len(self.data) + dist
+        else:
+            raise ValueError("Unknown Seek type: " + str(origin))
+        if self.index < 0:
+            self.index = 0
+        else:
+            self.index = min(self.index, len(self.data))
+        return self.index
+
+
+class BadStream(Stream):
+    """PyGStream::Read could formerly overflow buffer if the python implementation
+    returned more data than requested.
+    """
+
+    def Read(self, amount):
+        return str2bytes("x") * (amount + 1)
+
+
+class StreamTest(win32com.test.util.TestCase):
+    def _readWrite(self, data, write_stream, read_stream=None):
+        if read_stream is None:
+            read_stream = write_stream
+        write_stream.Write(data)
+        read_stream.Seek(0, pythoncom.STREAM_SEEK_SET)
+        got = read_stream.Read(len(data))
+        self.assertEqual(data, got)
+        read_stream.Seek(1, pythoncom.STREAM_SEEK_SET)
+        got = read_stream.Read(len(data) - 2)
+        self.assertEqual(data[1:-1], got)
+
+    def testit(self):
+        mydata = str2bytes("abcdefghijklmnopqrstuvwxyz")
+
+        # First test the objects just as Python objects...
+        s = Stream(mydata)
+        p = Persists()
+
+        p.Load(s)
+        p.Save(s, 0)
+        self.assertEqual(s.data, mydata)
+
+        # Wrap the Python objects as COM objects, and make the calls as if
+        # they were non-Python COM objects.
+        s2 = win32com.server.util.wrap(s, pythoncom.IID_IStream)
+        p2 = win32com.server.util.wrap(p, pythoncom.IID_IPersistStreamInit)
+
+        self._readWrite(mydata, s, s)
+        self._readWrite(mydata, s, s2)
+        self._readWrite(mydata, s2, s)
+        self._readWrite(mydata, s2, s2)
+
+        self._readWrite(str2bytes("string with\0a NULL"), s2, s2)
+        # reset the stream
+        s.Write(mydata)
+        p2.Load(s2)
+        p2.Save(s2, 0)
+        self.assertEqual(s.data, mydata)
+
+    def testseek(self):
+        s = Stream(str2bytes("yo"))
+        s = win32com.server.util.wrap(s, pythoncom.IID_IStream)
+        # we used to die in py3k passing a value > 32bits
+        s.Seek(0x100000000, pythoncom.STREAM_SEEK_SET)
+
+    def testerrors(self):
+        # setup a test logger to capture tracebacks etc.
+        records, old_log = win32com.test.util.setup_test_logger()
+        ## check for buffer overflow in Read method
+        badstream = BadStream("Check for buffer overflow")
+        badstream2 = win32com.server.util.wrap(badstream, pythoncom.IID_IStream)
+        self.assertRaises(pythoncom.com_error, badstream2.Read, 10)
+        win32com.test.util.restore_test_logger(old_log)
+        # there's 1 error here
+        self.assertEqual(len(records), 1)
+        self.assertTrue(records[0].msg.startswith("pythoncom error"))
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/lib/win32com/test/testWMI.py b/lib/win32com/test/testWMI.py
new file mode 100644
index 00000000..5829b48e
--- /dev/null
+++ b/lib/win32com/test/testWMI.py
@@ -0,0 +1,18 @@
+import unittest
+
+import win32com.test.util
+from win32com.client import GetObject
+
+
+class Simple(win32com.test.util.TestCase):
+    def testit(self):
+        cses = GetObject("WinMgMts:").InstancesOf("Win32_Process")
+        vals = []
+        for cs in cses:
+            val = cs.Properties_("Caption").Value
+            vals.append(val)
+        self.assertFalse(len(vals) < 5, "We only found %d processes!" % len(vals))
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/lib/win32com/test/testall.py b/lib/win32com/test/testall.py
new file mode 100644
index 00000000..6da07407
--- /dev/null
+++ b/lib/win32com/test/testall.py
@@ -0,0 +1,321 @@
+import getopt
+import os
+import re
+import sys
+import traceback
+import unittest
+
+try:
+    this_file = __file__
+except NameError:
+    this_file = sys.argv[0]
+
+win32com_src_dir = os.path.abspath(os.path.join(this_file, "../.."))
+
+import win32com
+
+# We'd prefer the win32com namespace to be the parent of __file__ - ie, our source-tree,
+# rather than the version installed - otherwise every .py change needs a full install to
+# test!
+# We can't patch win32comext as most of them have a .pyd in their root :(
+# This clearly ins't ideal or perfect :)
+win32com.__path__[0] = win32com_src_dir
+
+import pythoncom
+import win32com.client
+from win32com.test.util import (
+    CapturingFunctionTestCase,
+    CheckClean,
+    RegisterPythonServer,
+    ShellTestCase,
+    TestCase,
+    TestLoader,
+    TestRunner,
+)
+
+verbosity = 1  # default unittest verbosity.
+
+
+def GenerateAndRunOldStyle():
+    from . import GenTestScripts
+
+    GenTestScripts.GenerateAll()
+    try:
+        pass  #
+    finally:
+        GenTestScripts.CleanAll()
+
+
+def CleanGenerated():
+    import shutil
+
+    import win32com
+
+    if os.path.isdir(win32com.__gen_path__):
+        if verbosity > 1:
+            print("Deleting files from %s" % (win32com.__gen_path__))
+        shutil.rmtree(win32com.__gen_path__)
+    import win32com.client.gencache
+
+    win32com.client.gencache.__init__()  # Reset
+
+
+def RemoveRefCountOutput(data):
+    while 1:
+        last_line_pos = data.rfind("\n")
+        if not re.match("\[\d+ refs\]", data[last_line_pos + 1 :]):
+            break
+        if last_line_pos < 0:
+            # All the output
+            return ""
+        data = data[:last_line_pos]
+
+    return data
+
+
+def ExecuteSilentlyIfOK(cmd, testcase):
+    f = os.popen(cmd)
+    data = f.read().strip()
+    rc = f.close()
+    if rc:
+        print(data)
+        testcase.fail("Executing '%s' failed (%d)" % (cmd, rc))
+    # for "_d" builds, strip the '[xxx refs]' line
+    return RemoveRefCountOutput(data)
+
+
+class PyCOMTest(TestCase):
+    no_leak_tests = True  # done by the test itself
+
+    def testit(self):
+        # Check that the item is registered, so we get the correct
+        # 'skipped' behaviour (and recorded as such) rather than either
+        # error or silence due to non-registration.
+        RegisterPythonServer(
+            os.path.join(
+                os.path.dirname(__file__), "..", "servers", "test_pycomtest.py"
+            ),
+            "Python.Test.PyCOMTest",
+        )
+
+        # Execute testPyComTest in its own process so it can play
+        # with the Python thread state
+        fname = os.path.join(os.path.dirname(this_file), "testPyComTest.py")
+        cmd = '%s "%s" -q 2>&1' % (sys.executable, fname)
+        data = ExecuteSilentlyIfOK(cmd, self)
+
+
+class PippoTest(TestCase):
+    def testit(self):
+        # Check we are registered before spawning the process.
+        from win32com.test import pippo_server
+
+        RegisterPythonServer(pippo_server.__file__, "Python.Test.Pippo")
+
+        python = sys.executable
+        fname = os.path.join(os.path.dirname(this_file), "testPippo.py")
+        cmd = '%s "%s" 2>&1' % (python, fname)
+        ExecuteSilentlyIfOK(cmd, self)
+
+
+# This is a list of "win32com.test.???" module names, optionally with a
+# function in that module if the module isn't unitest based...
+unittest_modules = [
+    # Level 1 tests - fast and few dependencies - good for CI!
+    """testIterators testvbscript_regexp testStorage
+          testStreams testWMI policySemantics testShell testROT
+          testxslt testCollections
+          errorSemantics.test testArrays
+          testClipboard
+          testConversionErrors
+        """.split(),
+    # Level 2 tests - wants our demo COM objects registered.
+    # (these are strange; on github CI they get further than expected when
+    # our objects are not installed, so fail to quietly fail with "can't
+    # register" like they do locally. So really just a nod to CI)
+    """
+        testAXScript testDictionary testServers testvb testMarshal
+        """.split(),
+    # Level 3 tests - Requires Office or other non-free stuff.
+    """testMSOffice.TestAll testMSOfficeEvents.test testAccess.test
+           testExplorer.TestAll testExchange.test
+        """.split(),
+    # Level 4 tests - we try and run `makepy` over every typelib installed!
+    """testmakepy.TestAll
+        """.split(),
+]
+
+# A list of other unittest modules we use - these are fully qualified module
+# names and the module is assumed to be unittest based.
+unittest_other_modules = [
+    # Level 1 tests.
+    """win32com.directsound.test.ds_test
+        """.split(),
+    # Level 2 tests.
+    [],
+    # Level 3 tests.
+    [],
+    # Level 4 tests.
+    [],
+]
+
+
+output_checked_programs = [
+    # Level 1 tests.
+    [],
+    # Level 2 tests.
+    [
+        ("cscript.exe /nologo //E:vbscript testInterp.vbs", "VBScript test worked OK"),
+        (
+            "cscript.exe /nologo //E:vbscript testDictionary.vbs",
+            "VBScript has successfully tested Python.Dictionary",
+        ),
+    ],
+    # Level 3 tests
+    [],
+    # Level 4 tests.
+    [],
+]
+
+custom_test_cases = [
+    # Level 1 tests.
+    [],
+    # Level 2 tests.
+    [
+        PyCOMTest,
+        PippoTest,
+    ],
+    # Level 3 tests
+    [],
+    # Level 4 tests.
+    [],
+]
+
+
+def get_test_mod_and_func(test_name, import_failures):
+    if test_name.find(".") > 0:
+        mod_name, func_name = test_name.split(".")
+    else:
+        mod_name = test_name
+        func_name = None
+    fq_mod_name = "win32com.test." + mod_name
+    try:
+        __import__(fq_mod_name)
+        mod = sys.modules[fq_mod_name]
+    except:
+        import_failures.append((mod_name, sys.exc_info()[:2]))
+        return None, None
+    func = None if func_name is None else getattr(mod, func_name)
+    return mod, func
+
+
+# Return a test suite all loaded with the tests we want to run
+def make_test_suite(test_level=1):
+    suite = unittest.TestSuite()
+    import_failures = []
+    loader = TestLoader()
+    for i in range(testLevel):
+        for mod_name in unittest_modules[i]:
+            mod, func = get_test_mod_and_func(mod_name, import_failures)
+            if mod is None:
+                raise Exception("no such module '{}'".format(mod_name))
+            if func is not None:
+                test = CapturingFunctionTestCase(func, description=mod_name)
+            else:
+                if hasattr(mod, "suite"):
+                    test = mod.suite()
+                else:
+                    test = loader.loadTestsFromModule(mod)
+            assert test.countTestCases() > 0, "No tests loaded from %r" % mod
+            suite.addTest(test)
+        for cmd, output in output_checked_programs[i]:
+            suite.addTest(ShellTestCase(cmd, output))
+
+        for test_class in custom_test_cases[i]:
+            suite.addTest(unittest.defaultTestLoader.loadTestsFromTestCase(test_class))
+    # other "normal" unittest modules.
+    for i in range(testLevel):
+        for mod_name in unittest_other_modules[i]:
+            try:
+                __import__(mod_name)
+            except:
+                import_failures.append((mod_name, sys.exc_info()[:2]))
+                continue
+
+            mod = sys.modules[mod_name]
+            if hasattr(mod, "suite"):
+                test = mod.suite()
+            else:
+                test = loader.loadTestsFromModule(mod)
+            assert test.countTestCases() > 0, "No tests loaded from %r" % mod
+            suite.addTest(test)
+
+    return suite, import_failures
+
+
+def usage(why):
+    print(why)
+    print()
+    print("win32com test suite")
+    print("usage: testall [-v] test_level")
+    print("  where test_level is an integer 1-3.  Level 1 tests are quick,")
+    print("  level 2 tests invoke Word, IE etc, level 3 take ages!")
+    sys.exit(1)
+
+
+if __name__ == "__main__":
+    try:
+        opts, args = getopt.getopt(sys.argv[1:], "v")
+    except getopt.error as why:
+        usage(why)
+    for opt, val in opts:
+        if opt == "-v":
+            verbosity += 1
+    testLevel = 2  # default to quick test with local objects
+    test_names = []
+    for arg in args:
+        try:
+            testLevel = int(arg)
+            if testLevel < 0 or testLevel > 4:
+                raise ValueError("Only levels 1-4 are supported")
+        except ValueError:
+            test_names.append(arg)
+    if test_names:
+        usage("Test names are not supported yet")
+    CleanGenerated()
+
+    suite, import_failures = make_test_suite(testLevel)
+    if verbosity:
+        if hasattr(sys, "gettotalrefcount"):
+            print("This is a debug build - memory leak tests will also be run.")
+            print("These tests may take *many* minutes to run - be patient!")
+            print("(running from python.exe will avoid these leak tests)")
+        print(
+            "Executing level %d tests - %d test cases will be run"
+            % (testLevel, suite.countTestCases())
+        )
+        if verbosity == 1 and suite.countTestCases() < 70:
+            # A little row of markers so the dots show how close to finished
+            print("|" * suite.countTestCases())
+    testRunner = TestRunner(verbosity=verbosity)
+    testResult = testRunner.run(suite)
+    if import_failures:
+        testResult.stream.writeln(
+            "*** The following test modules could not be imported ***"
+        )
+        for mod_name, (exc_type, exc_val) in import_failures:
+            desc = "\n".join(traceback.format_exception_only(exc_type, exc_val))
+            testResult.stream.write("%s: %s" % (mod_name, desc))
+        testResult.stream.writeln(
+            "*** %d test(s) could not be run ***" % len(import_failures)
+        )
+
+    # re-print unit-test error here so it is noticed
+    if not testResult.wasSuccessful():
+        print("*" * 20, "- unittest tests FAILED")
+
+    CheckClean()
+    pythoncom.CoUninitialize()
+    CleanGenerated()
+    if not testResult.wasSuccessful():
+        sys.exit(1)
diff --git a/lib/win32com/test/testmakepy.py b/lib/win32com/test/testmakepy.py
new file mode 100644
index 00000000..2eeb8818
--- /dev/null
+++ b/lib/win32com/test/testmakepy.py
@@ -0,0 +1,55 @@
+# Test makepy - try and run it over every OCX in the windows system directory.
+
+import sys
+import traceback
+
+import pythoncom
+import win32api
+import win32com.test.util
+import winerror
+from win32com.client import gencache, makepy, selecttlb
+
+
+def TestBuildAll(verbose=1):
+    num = 0
+    tlbInfos = selecttlb.EnumTlbs()
+    for info in tlbInfos:
+        if verbose:
+            print("%s (%s)" % (info.desc, info.dll))
+        try:
+            makepy.GenerateFromTypeLibSpec(info)
+            #          sys.stderr.write("Attr typeflags for coclass referenced object %s=%d (%d), typekind=%d\n" % (name, refAttr.wTypeFlags, refAttr.wTypeFlags & pythoncom.TYPEFLAG_FDUAL,refAttr.typekind))
+            num += 1
+        except pythoncom.com_error as details:
+            # Ignore these 2 errors, as the are very common and can obscure
+            # useful warnings.
+            if details.hresult not in [
+                winerror.TYPE_E_CANTLOADLIBRARY,
+                winerror.TYPE_E_LIBNOTREGISTERED,
+            ]:
+                print("** COM error on", info.desc)
+                print(details)
+        except KeyboardInterrupt:
+            print("Interrupted!")
+            raise KeyboardInterrupt
+        except:
+            print("Failed:", info.desc)
+            traceback.print_exc()
+        if makepy.bForDemandDefault:
+            # This only builds enums etc by default - build each
+            # interface manually
+            tinfo = (info.clsid, info.lcid, info.major, info.minor)
+            mod = gencache.EnsureModule(info.clsid, info.lcid, info.major, info.minor)
+            for name in mod.NamesToIIDMap.keys():
+                makepy.GenerateChildFromTypeLibSpec(name, tinfo)
+    return num
+
+
+def TestAll(verbose=0):
+    num = TestBuildAll(verbose)
+    print("Generated and imported", num, "modules")
+    win32com.test.util.CheckClean()
+
+
+if __name__ == "__main__":
+    TestAll("-q" not in sys.argv)
diff --git a/lib/win32com/test/testvb.py b/lib/win32com/test/testvb.py
new file mode 100644
index 00000000..5a3d2f73
--- /dev/null
+++ b/lib/win32com/test/testvb.py
@@ -0,0 +1,594 @@
+# Test code for a VB Program.
+#
+# This requires the PythonCOM VB Test Harness.
+#
+
+import sys
+import traceback
+
+import pythoncom
+import win32com.client
+import win32com.client.dynamic
+import win32com.client.gencache
+import winerror
+from pywin32_testutil import str2memory
+from win32com.server.util import NewCollection, wrap
+from win32com.test import util
+
+# for debugging
+useDispatcher = None
+##  import win32com.server.dispatcher
+##  useDispatcher = win32com.server.dispatcher.DefaultDebugDispatcher
+
+error = RuntimeError
+
+
+# Set up a COM object that VB will do some callbacks on.  This is used
+# to test byref params for gateway IDispatch.
+class TestObject:
+    _public_methods_ = [
+        "CallbackVoidOneByRef",
+        "CallbackResultOneByRef",
+        "CallbackVoidTwoByRef",
+        "CallbackString",
+        "CallbackResultOneByRefButReturnNone",
+        "CallbackVoidOneByRefButReturnNone",
+        "CallbackArrayResult",
+        "CallbackArrayResultOneArrayByRef",
+        "CallbackArrayResultWrongSize",
+    ]
+
+    def CallbackVoidOneByRef(self, intVal):
+        return intVal + 1
+
+    def CallbackResultOneByRef(self, intVal):
+        return intVal, intVal + 1
+
+    def CallbackVoidTwoByRef(self, int1, int2):
+        return int1 + int2, int1 - int2
+
+    def CallbackString(self, strVal):
+        return 0, strVal + " has visited Python"
+
+    def CallbackArrayResult(self, arrayVal):
+        ret = []
+        for i in arrayVal:
+            ret.append(i + 1)
+        # returning as a list forces it be processed as a single result
+        # (rather than a tuple, where it may be interpreted as
+        # multiple results for byref unpacking)
+        return ret
+
+    def CallbackArrayResultWrongSize(self, arrayVal):
+        return list(arrayVal[:-1])
+
+    def CallbackArrayResultOneArrayByRef(self, arrayVal):
+        ret = []
+        for i in arrayVal:
+            ret.append(i + 1)
+        # See above for list processing.
+        return list(arrayVal), ret
+
+    def CallbackResultOneByRefButReturnNone(self, intVal):
+        return
+
+    def CallbackVoidOneByRefButReturnNone(self, intVal):
+        return
+
+
+def TestVB(vbtest, bUseGenerated):
+    vbtest.LongProperty = -1
+    if vbtest.LongProperty != -1:
+        raise error("Could not set the long property correctly.")
+    vbtest.IntProperty = 10
+    if vbtest.IntProperty != 10:
+        raise error("Could not set the integer property correctly.")
+    vbtest.VariantProperty = 10
+    if vbtest.VariantProperty != 10:
+        raise error("Could not set the variant integer property correctly.")
+    vbtest.VariantProperty = str2memory("raw\0data")
+    if vbtest.VariantProperty != str2memory("raw\0data"):
+        raise error("Could not set the variant buffer property correctly.")
+    vbtest.StringProperty = "Hello from Python"
+    if vbtest.StringProperty != "Hello from Python":
+        raise error("Could not set the string property correctly.")
+    vbtest.VariantProperty = "Hello from Python"
+    if vbtest.VariantProperty != "Hello from Python":
+        raise error("Could not set the variant string property correctly.")
+    vbtest.VariantProperty = (1.0, 2.0, 3.0)
+    if vbtest.VariantProperty != (1.0, 2.0, 3.0):
+        raise error(
+            "Could not set the variant property to an array of floats correctly - '%s'."
+            % (vbtest.VariantProperty,)
+        )
+
+    TestArrays(vbtest, bUseGenerated)
+    TestStructs(vbtest)
+    TestCollections(vbtest)
+
+    assert vbtest.TakeByValObject(vbtest) == vbtest
+
+    # Python doesnt support PUTREF properties without a typeref
+    # (although we could)
+    if bUseGenerated:
+        ob = vbtest.TakeByRefObject(vbtest)
+        assert ob[0] == vbtest and ob[1] == vbtest
+
+        # A property that only has PUTREF defined.
+        vbtest.VariantPutref = vbtest
+        if vbtest.VariantPutref._oleobj_ != vbtest._oleobj_:
+            raise error("Could not set the VariantPutref property correctly.")
+        # Cant test further types for this VariantPutref, as only
+        # COM objects can be stored ByRef.
+
+        # A "set" type property - only works for generated.
+        # VB recognizes a collection via a few "private" interfaces that we
+        # could later build support in for.
+        #               vbtest.CollectionProperty = NewCollection((1,2,"3", "Four"))
+        #               if vbtest.CollectionProperty != (1,2,"3", "Four"):
+        #                       raise error("Could not set the Collection property correctly - got back " + str(vbtest.CollectionProperty))
+
+        # These are sub's that have a single byref param
+        # Result should be just the byref.
+        if vbtest.IncrementIntegerParam(1) != 2:
+            raise error("Could not pass an integer byref")
+
+        # Sigh - we cant have *both* "ommited byref" and optional args
+        # We really have to opt that args nominated as optional work as optional
+        # rather than simply all byrefs working as optional.
+        #               if vbtest.IncrementIntegerParam() != 1:
+        #                       raise error("Could not pass an omitted integer byref")
+
+        if vbtest.IncrementVariantParam(1) != 2:
+            raise error(
+                "Could not pass an int VARIANT byref:"
+                + str(vbtest.IncrementVariantParam(1))
+            )
+
+        if vbtest.IncrementVariantParam(1.5) != 2.5:
+            raise error("Could not pass a float VARIANT byref")
+
+        # Can't test IncrementVariantParam with the param omitted as it
+        # it not declared in the VB code as "Optional"
+        callback_ob = wrap(TestObject(), useDispatcher=useDispatcher)
+        vbtest.DoSomeCallbacks(callback_ob)
+
+    ret = vbtest.PassIntByVal(1)
+    if ret != 2:
+        raise error("Could not increment the integer - " + str(ret))
+
+    TestVBInterface(vbtest)
+    # Python doesnt support byrefs without some sort of generated support.
+    if bUseGenerated:
+        # This is a VB function that takes a single byref
+        # Hence 2 return values - function and byref.
+        ret = vbtest.PassIntByRef(1)
+        if ret != (1, 2):
+            raise error("Could not increment the integer - " + str(ret))
+        # Check you can leave a byref arg blank.
+
+
+# see above
+#               ret = vbtest.PassIntByRef()
+#               if ret != (0,1):
+#                       raise error("Could not increment the integer with default arg- "+str(ret))
+
+
+def _DoTestCollection(vbtest, col_name, expected):
+    # It sucks that some objects allow "Count()", but others "Count"
+    def _getcount(ob):
+        r = getattr(ob, "Count")
+        if type(r) != type(0):
+            return r()
+        return r
+
+    c = getattr(vbtest, col_name)
+    check = []
+    for item in c:
+        check.append(item)
+    if check != list(expected):
+        raise error(
+            "Collection %s didn't have %r (had %r)" % (col_name, expected, check)
+        )
+    # Just looping over the collection again works (ie, is restartable)
+    check = []
+    for item in c:
+        check.append(item)
+    if check != list(expected):
+        raise error(
+            "Collection 2nd time around %s didn't have %r (had %r)"
+            % (col_name, expected, check)
+        )
+    # Check we can get it via iter()
+    i = iter(getattr(vbtest, col_name))
+    check = []
+    for item in i:
+        check.append(item)
+    if check != list(expected):
+        raise error(
+            "Collection iterator %s didn't have %r 2nd time around (had %r)"
+            % (col_name, expected, check)
+        )
+    # but an iterator is not restartable
+    check = []
+    for item in i:
+        check.append(item)
+    if check != []:
+        raise error(
+            "2nd time around Collection iterator %s wasn't empty (had %r)"
+            % (col_name, check)
+        )
+
+    # Check len()==Count()
+    c = getattr(vbtest, col_name)
+    if len(c) != _getcount(c):
+        raise error(
+            "Collection %s __len__(%r) wasn't==Count(%r)"
+            % (col_name, len(c), _getcount(c))
+        )
+    # Check we can do it with zero based indexing.
+    c = getattr(vbtest, col_name)
+    check = []
+    for i in range(_getcount(c)):
+        check.append(c[i])
+    if check != list(expected):
+        raise error(
+            "Collection %s didn't have %r (had %r)" % (col_name, expected, check)
+        )
+
+    # Check we can do it with our old "Skip/Next" methods.
+    c = getattr(vbtest, col_name)._NewEnum()
+    check = []
+    while 1:
+        n = c.Next()
+        if not n:
+            break
+        check.append(n[0])
+    if check != list(expected):
+        raise error(
+            "Collection %s didn't have %r (had %r)" % (col_name, expected, check)
+        )
+
+
+def TestCollections(vbtest):
+    _DoTestCollection(vbtest, "CollectionProperty", [1, "Two", "3"])
+    # zero based indexing works for simple VB collections.
+    if vbtest.CollectionProperty[0] != 1:
+        raise error("The CollectionProperty[0] element was not the default value")
+
+    _DoTestCollection(vbtest, "EnumerableCollectionProperty", [])
+    vbtest.EnumerableCollectionProperty.Add(1)
+    vbtest.EnumerableCollectionProperty.Add("Two")
+    vbtest.EnumerableCollectionProperty.Add("3")
+    _DoTestCollection(vbtest, "EnumerableCollectionProperty", [1, "Two", "3"])
+
+
+def _DoTestArray(vbtest, data, expected_exception=None):
+    try:
+        vbtest.ArrayProperty = data
+        if expected_exception is not None:
+            raise error("Expected '%s'" % expected_exception)
+    except expected_exception:
+        return
+    got = vbtest.ArrayProperty
+    if got != data:
+        raise error(
+            "Could not set the array data correctly - got %r, expected %r" % (got, data)
+        )
+
+
+def TestArrays(vbtest, bUseGenerated):
+    # Try and use a safe array (note that the VB code has this declared as a VARIANT
+    # and I cant work out how to force it to use native arrays!
+    # (NOTE Python will convert incoming arrays to tuples, so we pass a tuple, even tho
+    # a list works fine - just makes it easier for us to compare the result!
+    # Empty array
+    _DoTestArray(vbtest, ())
+    # Empty child array
+    _DoTestArray(vbtest, ((), ()))
+    # ints
+    _DoTestArray(vbtest, tuple(range(1, 100)))
+    # Floats
+    _DoTestArray(vbtest, (1.0, 2.0, 3.0))
+    # Strings.
+    _DoTestArray(vbtest, tuple("Hello from Python".split()))
+    # Date and Time?
+    # COM objects.
+    _DoTestArray(vbtest, (vbtest, vbtest))
+    # Mixed
+    _DoTestArray(vbtest, (1, 2.0, "3"))
+    # Array alements containing other arrays
+    _DoTestArray(vbtest, (1, (vbtest, vbtest), ("3", "4")))
+    # Multi-dimensional
+    _DoTestArray(vbtest, (((1, 2, 3), (4, 5, 6))))
+    _DoTestArray(vbtest, (((vbtest, vbtest, vbtest), (vbtest, vbtest, vbtest))))
+    # Another dimension!
+    arrayData = (((1, 2), (3, 4), (5, 6)), ((7, 8), (9, 10), (11, 12)))
+    arrayData = (
+        ((vbtest, vbtest), (vbtest, vbtest), (vbtest, vbtest)),
+        ((vbtest, vbtest), (vbtest, vbtest), (vbtest, vbtest)),
+    )
+    _DoTestArray(vbtest, arrayData)
+
+    # Check that when a '__getitem__ that fails' object is the first item
+    # in the structure, we don't mistake it for a sequence.
+    _DoTestArray(vbtest, (vbtest, 2.0, "3"))
+    _DoTestArray(vbtest, (1, 2.0, vbtest))
+
+    # Pass arbitrarily sized arrays - these used to fail, but thanks to
+    # Stefan Schukat, they now work!
+    expected_exception = None
+    arrayData = (((1, 2, 1), (3, 4), (5, 6)), ((7, 8), (9, 10), (11, 12)))
+    _DoTestArray(vbtest, arrayData, expected_exception)
+    arrayData = (((vbtest, vbtest),), ((vbtest,),))
+    _DoTestArray(vbtest, arrayData, expected_exception)
+    # Pass bad data - last item wrong size
+    arrayData = (((1, 2), (3, 4), (5, 6, 8)), ((7, 8), (9, 10), (11, 12)))
+    _DoTestArray(vbtest, arrayData, expected_exception)
+
+    # byref safearray results with incorrect size.
+    callback_ob = wrap(TestObject(), useDispatcher=useDispatcher)
+    print("** Expecting a 'ValueError' exception to be printed next:")
+    try:
+        vbtest.DoCallbackSafeArraySizeFail(callback_ob)
+    except pythoncom.com_error as exc:
+        assert (
+            exc.excepinfo[1] == "Python COM Server Internal Error"
+        ), "Didnt get the correct exception - '%s'" % (exc,)
+
+    if bUseGenerated:
+        # This one is a bit strange!  The array param is "ByRef", as VB insists.
+        # The function itself also _returns_ the arram param.
+        # Therefore, Python sees _2_ result values - one for the result,
+        # and one for the byref.
+        testData = "Mark was here".split()
+        resultData, byRefParam = vbtest.PassSAFEARRAY(testData)
+        if testData != list(resultData):
+            raise error(
+                "The safe array data was not what we expected - got " + str(resultData)
+            )
+        if testData != list(byRefParam):
+            raise error(
+                "The safe array data was not what we expected - got " + str(byRefParam)
+            )
+        testData = [1.0, 2.0, 3.0]
+        resultData, byRefParam = vbtest.PassSAFEARRAYVariant(testData)
+        assert testData == list(byRefParam)
+        assert testData == list(resultData)
+        testData = ["hi", "from", "Python"]
+        resultData, byRefParam = vbtest.PassSAFEARRAYVariant(testData)
+        assert testData == list(byRefParam), "Expected '%s', got '%s'" % (
+            testData,
+            list(byRefParam),
+        )
+        assert testData == list(resultData), "Expected '%s', got '%s'" % (
+            testData,
+            list(resultData),
+        )
+        # This time, instead of an explicit str() for 1.5, we just
+        # pass Unicode, so the result should compare equal
+        testData = [1, 2.0, "3"]
+        resultData, byRefParam = vbtest.PassSAFEARRAYVariant(testData)
+        assert testData == list(byRefParam)
+        assert testData == list(resultData)
+    print("Array tests passed")
+
+
+def TestStructs(vbtest):
+    try:
+        vbtest.IntProperty = "One"
+        raise error("Should have failed by now")
+    except pythoncom.com_error as exc:
+        if exc.hresult != winerror.DISP_E_TYPEMISMATCH:
+            raise error("Expected DISP_E_TYPEMISMATCH")
+
+    s = vbtest.StructProperty
+    if s.int_val != 99 or str(s.str_val) != "hello":
+        raise error("The struct value was not correct")
+    s.str_val = "Hi from Python"
+    s.int_val = 11
+    if s.int_val != 11 or str(s.str_val) != "Hi from Python":
+        raise error("The struct value didnt persist!")
+
+    if s.sub_val.int_val != 66 or str(s.sub_val.str_val) != "sub hello":
+        raise error("The sub-struct value was not correct")
+    sub = s.sub_val
+    sub.int_val = 22
+    if sub.int_val != 22:
+        print(sub.int_val)
+        raise error("The sub-struct value didnt persist!")
+
+    if s.sub_val.int_val != 22:
+        print(s.sub_val.int_val)
+        raise error("The sub-struct value (re-fetched) didnt persist!")
+
+    if (
+        s.sub_val.array_val[0].int_val != 0
+        or str(s.sub_val.array_val[0].str_val) != "zero"
+    ):
+        print(s.sub_val.array_val[0].int_val)
+        raise error("The array element wasnt correct")
+    s.sub_val.array_val[0].int_val = 99
+    s.sub_val.array_val[1].int_val = 66
+    if s.sub_val.array_val[0].int_val != 99 or s.sub_val.array_val[1].int_val != 66:
+        print(s.sub_val.array_val[0].int_val)
+        raise error("The array element didnt persist.")
+    # Now pass the struct back to VB
+    vbtest.StructProperty = s
+    # And get it back again
+    s = vbtest.StructProperty
+    if s.int_val != 11 or str(s.str_val) != "Hi from Python":
+        raise error("After sending to VB, the struct value didnt persist!")
+    if s.sub_val.array_val[0].int_val != 99:
+        raise error("After sending to VB, the struct array value didnt persist!")
+
+    # Now do some object equality tests.
+    assert s == s
+    assert s != None
+    if sys.version_info > (3, 0):
+        try:
+            s < None
+            raise error("Expected type error")
+        except TypeError:
+            pass
+        try:
+            None < s
+            raise error("Expected type error")
+        except TypeError:
+            pass
+    assert s != s.sub_val
+    import copy
+
+    s2 = copy.copy(s)
+    assert s is not s2
+    assert s == s2
+    s2.int_val = 123
+    assert s != s2
+    # Make sure everything works with functions
+    s2 = vbtest.GetStructFunc()
+    assert s == s2
+    vbtest.SetStructSub(s2)
+
+    # Create a new structure, and set its elements.
+    s = win32com.client.Record("VBStruct", vbtest)
+    assert s.int_val == 0, "new struct inst initialized correctly!"
+    s.int_val = -1
+    vbtest.SetStructSub(s)
+    assert vbtest.GetStructFunc().int_val == -1, "new struct didnt make the round trip!"
+    # Finally, test stand-alone structure arrays.
+    s_array = vbtest.StructArrayProperty
+    assert s_array is None, "Expected None from the uninitialized VB array"
+    vbtest.MakeStructArrayProperty(3)
+    s_array = vbtest.StructArrayProperty
+    assert len(s_array) == 3
+    for i in range(len(s_array)):
+        assert s_array[i].int_val == i
+        assert s_array[i].sub_val.int_val == i
+        assert s_array[i].sub_val.array_val[0].int_val == i
+        assert s_array[i].sub_val.array_val[1].int_val == i + 1
+        assert s_array[i].sub_val.array_val[2].int_val == i + 2
+
+    # Some error type checks.
+    try:
+        s.bad_attribute
+        raise RuntimeError("Could get a bad attribute")
+    except AttributeError:
+        pass
+    m = s.__members__
+    assert (
+        m[0] == "int_val"
+        and m[1] == "str_val"
+        and m[2] == "ob_val"
+        and m[3] == "sub_val"
+    ), m
+
+    # Test attribute errors.
+    try:
+        s.foo
+        raise RuntimeError("Expected attribute error")
+    except AttributeError as exc:
+        assert "foo" in str(exc), exc
+
+    # test repr - it uses repr() of the sub-objects, so check it matches.
+    expected = "com_struct(int_val=%r, str_val=%r, ob_val=%r, sub_val=%r)" % (
+        s.int_val,
+        s.str_val,
+        s.ob_val,
+        s.sub_val,
+    )
+    if repr(s) != expected:
+        print("Expected repr:", expected)
+        print("Actual repr  :", repr(s))
+        raise RuntimeError("repr() of record object failed")
+
+    print("Struct/Record tests passed")
+
+
+def TestVBInterface(ob):
+    t = ob.GetInterfaceTester(2)
+    if t.getn() != 2:
+        raise error("Initial value wrong")
+    t.setn(3)
+    if t.getn() != 3:
+        raise error("New value wrong")
+
+
+def TestObjectSemantics(ob):
+    # a convenient place to test some of our equality semantics
+    assert ob == ob._oleobj_
+    assert not ob != ob._oleobj_
+    # same test again, but lhs and rhs reversed.
+    assert ob._oleobj_ == ob
+    assert not ob._oleobj_ != ob
+    # same tests but against different pointers.  COM identity rules should
+    # still ensure all works
+    assert ob._oleobj_ == ob._oleobj_.QueryInterface(pythoncom.IID_IUnknown)
+    assert not ob._oleobj_ != ob._oleobj_.QueryInterface(pythoncom.IID_IUnknown)
+
+    assert ob._oleobj_ != None
+    assert None != ob._oleobj_
+    assert ob != None
+    assert None != ob
+    if sys.version_info > (3, 0):
+        try:
+            ob < None
+            raise error("Expected type error")
+        except TypeError:
+            pass
+        try:
+            None < ob
+            raise error("Expected type error")
+        except TypeError:
+            pass
+
+    assert ob._oleobj_.QueryInterface(pythoncom.IID_IUnknown) == ob._oleobj_
+    assert not ob._oleobj_.QueryInterface(pythoncom.IID_IUnknown) != ob._oleobj_
+
+    assert ob._oleobj_ == ob._oleobj_.QueryInterface(pythoncom.IID_IDispatch)
+    assert not ob._oleobj_ != ob._oleobj_.QueryInterface(pythoncom.IID_IDispatch)
+
+    assert ob._oleobj_.QueryInterface(pythoncom.IID_IDispatch) == ob._oleobj_
+    assert not ob._oleobj_.QueryInterface(pythoncom.IID_IDispatch) != ob._oleobj_
+
+    print("Object semantic tests passed")
+
+
+def DoTestAll():
+    o = win32com.client.Dispatch("PyCOMVBTest.Tester")
+    TestObjectSemantics(o)
+    TestVB(o, 1)
+
+    o = win32com.client.dynamic.DumbDispatch("PyCOMVBTest.Tester")
+    TestObjectSemantics(o)
+    TestVB(o, 0)
+
+
+def TestAll():
+    # Import the type library for the test module.  Let the 'invalid clsid'
+    # exception filter up, where the test runner will treat it as 'skipped'
+    win32com.client.gencache.EnsureDispatch("PyCOMVBTest.Tester")
+
+    if not __debug__:
+        raise RuntimeError("This must be run in debug mode - we use assert!")
+    try:
+        DoTestAll()
+        print("All tests appear to have worked!")
+    except:
+        # ?????
+        print("TestAll() failed!!")
+        traceback.print_exc()
+        raise
+
+
+# Make this test run under our test suite to leak tests etc work
+def suite():
+    import unittest
+
+    test = util.CapturingFunctionTestCase(TestAll, description="VB tests")
+    suite = unittest.TestSuite()
+    suite.addTest(test)
+    return suite
+
+
+if __name__ == "__main__":
+    util.testmain()
diff --git a/lib/win32com/test/testvbscript_regexp.py b/lib/win32com/test/testvbscript_regexp.py
new file mode 100644
index 00000000..a22f0bea
--- /dev/null
+++ b/lib/win32com/test/testvbscript_regexp.py
@@ -0,0 +1,40 @@
+import unittest
+
+import win32com.test.util
+from win32com.client.dynamic import DumbDispatch
+from win32com.client.gencache import EnsureDispatch
+
+
+class RegexTest(win32com.test.util.TestCase):
+    def _CheckMatches(self, match, expected):
+        found = []
+        for imatch in match:
+            found.append(imatch.FirstIndex)
+        self.assertEqual(list(found), list(expected))
+
+    def _TestVBScriptRegex(self, re):
+        StringToSearch = "Python python pYthon Python"
+        re.Pattern = "Python"
+        re.Global = True
+
+        re.IgnoreCase = True
+        match = re.Execute(StringToSearch)
+        expected = 0, 7, 14, 21
+        self._CheckMatches(match, expected)
+
+        re.IgnoreCase = False
+        match = re.Execute(StringToSearch)
+        expected = 0, 21
+        self._CheckMatches(match, expected)
+
+    def testDynamic(self):
+        re = DumbDispatch("VBScript.Regexp")
+        self._TestVBScriptRegex(re)
+
+    def testGenerated(self):
+        re = EnsureDispatch("VBScript.Regexp")
+        self._TestVBScriptRegex(re)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/lib/win32com/test/testxslt.js b/lib/win32com/test/testxslt.js
new file mode 100644
index 00000000..347401c2
--- /dev/null
+++ b/lib/win32com/test/testxslt.js
@@ -0,0 +1,12 @@
+//Args:  input-file style-file output-file
+var xml  = WScript.CreateObject("Microsoft.XMLDOM");          //input
+xml.validateOnParse=false;
+xml.load(WScript.Arguments(0));
+var xsl  = WScript.CreateObject("Microsoft.XMLDOM");          //style
+xsl.validateOnParse=false;
+xsl.load(WScript.Arguments(1));
+var out = WScript.CreateObject("Scripting.FileSystemObject"); //output
+var replace = true; var unicode = false; //output file properties
+var hdl = out.CreateTextFile( WScript.Arguments(2), replace, unicode )
+hdl.write( xml.transformNode( xsl.documentElement ));
+//eof
diff --git a/lib/win32com/test/testxslt.py b/lib/win32com/test/testxslt.py
new file mode 100644
index 00000000..caaa2ec5
--- /dev/null
+++ b/lib/win32com/test/testxslt.py
@@ -0,0 +1,34 @@
+import os
+import tempfile
+import unittest
+
+import win32com.test.util
+
+expected_output = "The jscript test worked.\nThe Python test worked"
+
+
+class XSLT(win32com.test.util.TestCase):
+    def testAll(self):
+        output_name = tempfile.mktemp("-pycom-test")
+        cmd = (
+            "cscript //nologo testxslt.js doesnt_matter.xml testxslt.xsl " + output_name
+        )
+        win32com.test.util.ExecuteShellCommand(cmd, self)
+        try:
+            f = open(output_name)
+            try:
+                got = f.read()
+                if got != expected_output:
+                    print("ERROR: XSLT expected output of %r" % (expected_output,))
+                    print("but got %r" % (got,))
+            finally:
+                f.close()
+        finally:
+            try:
+                os.unlink(output_name)
+            except os.error:
+                pass
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/lib/win32com/test/testxslt.xsl b/lib/win32com/test/testxslt.xsl
new file mode 100644
index 00000000..9ab5c0f9
--- /dev/null
+++ b/lib/win32com/test/testxslt.xsl
@@ -0,0 +1,55 @@
+<!-- include in the xsl:stylesheet element:
+     (a) the version attribute as usual
+     (b) the XSLT namespace declaration as usual
+     (c) the MSXSL namespace declaration
+     (d) a namespace declaration to identify your functions
+     (e) the 'extension-element-prefixes' attribute to give the
+         namespace prefixes that indicate extension elements
+         (i.e. 'msxsl')
+     (f) the 'exclude-result-prefixes' attribute to indicate the
+         namespaces that aren't supposed to be part of the result
+         tree (i.e. 'foo') -->
+<xsl:stylesheet version="1.0"
+                xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+                xmlns:msxsl="urn:schemas-microsoft-com:xslt"
+                xmlns:foo="http://www.pythoncom-test.com/foo"
+                xmlns:bar="http://www.pythoncom-test.com/bar"
+                extension-element-prefixes="msxsl"
+                exclude-result-prefixes="foo bar">
+
+<!-- do whatever output you want - you can use full XSLT functionality
+     -->
+<xsl:output method="html" />
+
+<!-- define the Javascript functions that you want to include within
+     a msxsl:script element.
+     - language indicates the scripting language
+     - implements-prefix gives the namespace prefix that you declared
+       for your function (i.e. foo) -->
+<msxsl:script language="javascript"
+              implements-prefix="foo">
+   function worked() {
+      return "The jscript test worked";
+    }
+</msxsl:script>
+
+<!-- ditto for Python, using the 'bar' namespace
+-->
+<msxsl:script language="python"
+              implements-prefix="bar">
+def worked():
+  return "The Python test worked"
+</msxsl:script>
+
+<xsl:template match="/">
+<!-- The output template.  Keep whitespace down as our test matches text exactly -->
+<!-- call your functions using the prefix that you've used (i.e.
+     foo) anywhere you can normally use an XPath function, but
+     make sure it's returning the right kind of object -->
+<xsl:value-of select="foo:worked()" />.
+<xsl:value-of select="bar:worked()" />
+
+</xsl:template>
+
+</xsl:stylesheet>
+
diff --git a/lib/win32com/test/util.py b/lib/win32com/test/util.py
new file mode 100644
index 00000000..691be851
--- /dev/null
+++ b/lib/win32com/test/util.py
@@ -0,0 +1,265 @@
+import gc
+import logging
+import os
+import sys
+import tempfile
+import unittest
+import winreg
+
+import pythoncom
+import pywin32_testutil
+import pywintypes
+import win32api
+import win32com
+import winerror
+from pythoncom import _GetGatewayCount, _GetInterfaceCount
+from pywin32_testutil import LeakTestCase, TestLoader, TestResult, TestRunner
+
+
+def CheckClean():
+    # Ensure no lingering exceptions - Python should have zero outstanding
+    # COM objects
+    try:
+        sys.exc_clear()
+    except AttributeError:
+        pass  # py3k
+    c = _GetInterfaceCount()
+    if c:
+        print("Warning - %d com interface objects still alive" % c)
+    c = _GetGatewayCount()
+    if c:
+        print("Warning - %d com gateway objects still alive" % c)
+
+
+def RegisterPythonServer(filename, progids=None, verbose=0):
+    if progids:
+        if isinstance(progids, str):
+            progids = [progids]
+        # we know the CLSIDs we need, but we might not be an admin user
+        # and otherwise unable to register them.  So as long as the progids
+        # exist and the DLL points at our version, assume it already is.
+        why_not = None
+        for progid in progids:
+            try:
+                clsid = pywintypes.IID(progid)
+            except pythoncom.com_error:
+                # not registered.
+                break
+            try:
+                HKCR = winreg.HKEY_CLASSES_ROOT
+                hk = winreg.OpenKey(HKCR, "CLSID\\%s" % clsid)
+                dll = winreg.QueryValue(hk, "InprocServer32")
+            except WindowsError:
+                # no CLSID or InProcServer32 - not registered
+                break
+            ok_files = [
+                os.path.basename(pythoncom.__file__),
+                "pythoncomloader%d%d.dll" % (sys.version_info[0], sys.version_info[1]),
+            ]
+            if os.path.basename(dll) not in ok_files:
+                why_not = "%r is registered against a different Python version (%s)" % (
+                    progid,
+                    dll,
+                )
+                break
+        else:
+            # print "Skipping registration of '%s' - already registered" % filename
+            return
+    # needs registration - see if its likely!
+    try:
+        from win32com.shell.shell import IsUserAnAdmin
+    except ImportError:
+        print("Can't import win32com.shell - no idea if you are an admin or not?")
+        is_admin = False
+    else:
+        try:
+            is_admin = IsUserAnAdmin()
+        except pythoncom.com_error:
+            # old, less-secure OS - assume *is* admin.
+            is_admin = True
+    if not is_admin:
+        msg = (
+            "%r isn't registered, but I'm not an administrator who can register it."
+            % progids[0]
+        )
+        if why_not:
+            msg += "\n(registration check failed as %s)" % why_not
+        # throw a normal "class not registered" exception - we don't report
+        # them the same way as "real" errors.
+        raise pythoncom.com_error(winerror.CO_E_CLASSSTRING, msg, None, -1)
+    # so theoretically we are able to register it.
+    cmd = '%s "%s" --unattended > nul 2>&1' % (win32api.GetModuleFileName(0), filename)
+    if verbose:
+        print("Registering engine", filename)
+    #       print cmd
+    rc = os.system(cmd)
+    if rc:
+        print("Registration command was:")
+        print(cmd)
+        raise RuntimeError("Registration of engine '%s' failed" % filename)
+
+
+def ExecuteShellCommand(
+    cmd,
+    testcase,
+    expected_output=None,  # Set to '' to check for nothing
+    tracebacks_ok=0,  # OK if the output contains a t/b?
+):
+    output_name = tempfile.mktemp("win32com_test")
+    cmd = cmd + ' > "%s" 2>&1' % output_name
+    rc = os.system(cmd)
+    output = open(output_name, "r").read().strip()
+    os.remove(output_name)
+
+    class Failed(Exception):
+        pass
+
+    try:
+        if rc:
+            raise Failed("exit code was " + str(rc))
+        if expected_output is not None and output != expected_output:
+            raise Failed("Expected output %r (got %r)" % (expected_output, output))
+        if not tracebacks_ok and output.find("Traceback (most recent call last)") >= 0:
+            raise Failed("traceback in program output")
+        return output
+    except Failed as why:
+        print("Failed to exec command '%r'" % cmd)
+        print("Failed as", why)
+        print("** start of program output **")
+        print(output)
+        print("** end of program output **")
+        testcase.fail("Executing '%s' failed as %s" % (cmd, why))
+
+
+def assertRaisesCOM_HRESULT(testcase, hresult, func, *args, **kw):
+    try:
+        func(*args, **kw)
+    except pythoncom.com_error as details:
+        if details.hresult == hresult:
+            return
+    testcase.fail("Excepected COM exception with HRESULT 0x%x" % hresult)
+
+
+class CaptureWriter:
+    def __init__(self):
+        self.old_err = self.old_out = None
+        self.clear()
+
+    def capture(self):
+        self.clear()
+        self.old_out = sys.stdout
+        self.old_err = sys.stderr
+        sys.stdout = sys.stderr = self
+
+    def release(self):
+        if self.old_out:
+            sys.stdout = self.old_out
+            self.old_out = None
+        if self.old_err:
+            sys.stderr = self.old_err
+            self.old_err = None
+
+    def clear(self):
+        self.captured = []
+
+    def write(self, msg):
+        self.captured.append(msg)
+
+    def get_captured(self):
+        return "".join(self.captured)
+
+    def get_num_lines_captured(self):
+        return len("".join(self.captured).split("\n"))
+
+
+# Utilities to set the win32com logger to something what just captures
+# records written and doesn't print them.
+class LogHandler(logging.Handler):
+    def __init__(self):
+        self.emitted = []
+        logging.Handler.__init__(self)
+
+    def emit(self, record):
+        self.emitted.append(record)
+
+
+_win32com_logger = None
+
+
+def setup_test_logger():
+    old_log = getattr(win32com, "logger", None)
+    global _win32com_logger
+    if _win32com_logger is None:
+        _win32com_logger = logging.Logger("test")
+        handler = LogHandler()
+        _win32com_logger.addHandler(handler)
+
+    win32com.logger = _win32com_logger
+    handler = _win32com_logger.handlers[0]
+    handler.emitted = []
+    return handler.emitted, old_log
+
+
+def restore_test_logger(prev_logger):
+    assert prev_logger is None, "who needs this?"
+    if prev_logger is None:
+        del win32com.logger
+    else:
+        win32com.logger = prev_logger
+
+
+# We used to override some of this (and may later!)
+TestCase = unittest.TestCase
+
+
+def CapturingFunctionTestCase(*args, **kw):
+    real_test = _CapturingFunctionTestCase(*args, **kw)
+    return LeakTestCase(real_test)
+
+
+class _CapturingFunctionTestCase(unittest.FunctionTestCase):  # , TestCaseMixin):
+    def __call__(self, result=None):
+        if result is None:
+            result = self.defaultTestResult()
+        writer = CaptureWriter()
+        # self._preTest()
+        writer.capture()
+        try:
+            unittest.FunctionTestCase.__call__(self, result)
+            if getattr(self, "do_leak_tests", 0) and hasattr(sys, "gettotalrefcount"):
+                self.run_leak_tests(result)
+        finally:
+            writer.release()
+            # self._postTest(result)
+        output = writer.get_captured()
+        self.checkOutput(output, result)
+        if result.showAll:
+            print(output)
+
+    def checkOutput(self, output, result):
+        if output.find("Traceback") >= 0:
+            msg = "Test output contained a traceback\n---\n%s\n---" % output
+            result.errors.append((self, msg))
+
+
+class ShellTestCase(unittest.TestCase):
+    def __init__(self, cmd, expected_output):
+        self.__cmd = cmd
+        self.__eo = expected_output
+        unittest.TestCase.__init__(self)
+
+    def runTest(self):
+        ExecuteShellCommand(self.__cmd, self, self.__eo)
+
+    def __str__(self):
+        max = 30
+        if len(self.__cmd) > max:
+            cmd_repr = self.__cmd[:max] + "..."
+        else:
+            cmd_repr = self.__cmd
+        return "exec: " + cmd_repr
+
+
+def testmain(*args, **kw):
+    pywin32_testutil.testmain(*args, **kw)
+    CheckClean()
diff --git a/lib/win32com/universal.py b/lib/win32com/universal.py
new file mode 100644
index 00000000..7c2944ed
--- /dev/null
+++ b/lib/win32com/universal.py
@@ -0,0 +1,226 @@
+# Code that packs and unpacks the Univgw structures.
+
+# See if we have a special directory for the binaries (for developers)
+
+import pythoncom
+from win32com.client import gencache
+
+com_error = pythoncom.com_error
+_univgw = pythoncom._univgw
+
+
+def RegisterInterfaces(typelibGUID, lcid, major, minor, interface_names=None):
+    ret = []  # return a list of (dispid, funcname for our policy's benefit
+    # First see if we have makepy support.  If so, we can probably satisfy the request without loading the typelib.
+    try:
+        mod = gencache.GetModuleForTypelib(typelibGUID, lcid, major, minor)
+    except ImportError:
+        mod = None
+    if mod is None:
+        import win32com.client.build
+
+        # Load up the typelib and build (but don't cache) it now
+        tlb = pythoncom.LoadRegTypeLib(typelibGUID, major, minor, lcid)
+        typecomp_lib = tlb.GetTypeComp()
+        if interface_names is None:
+            interface_names = []
+            for i in range(tlb.GetTypeInfoCount()):
+                info = tlb.GetTypeInfo(i)
+                doc = tlb.GetDocumentation(i)
+                attr = info.GetTypeAttr()
+                if attr.typekind == pythoncom.TKIND_INTERFACE or (
+                    attr.typekind == pythoncom.TKIND_DISPATCH
+                    and attr.wTypeFlags & pythoncom.TYPEFLAG_FDUAL
+                ):
+                    interface_names.append(doc[0])
+        for name in interface_names:
+            type_info, type_comp = typecomp_lib.BindType(
+                name,
+            )
+            # Not sure why we don't get an exception here - BindType's C
+            # impl looks correct..
+            if type_info is None:
+                raise ValueError("The interface '%s' can not be located" % (name,))
+            # If we got back a Dispatch interface, convert to the real interface.
+            attr = type_info.GetTypeAttr()
+            if attr.typekind == pythoncom.TKIND_DISPATCH:
+                refhtype = type_info.GetRefTypeOfImplType(-1)
+                type_info = type_info.GetRefTypeInfo(refhtype)
+                attr = type_info.GetTypeAttr()
+            item = win32com.client.build.VTableItem(
+                type_info, attr, type_info.GetDocumentation(-1)
+            )
+            _doCreateVTable(
+                item.clsid, item.python_name, item.bIsDispatch, item.vtableFuncs
+            )
+            for info in item.vtableFuncs:
+                names, dispid, desc = info
+                invkind = desc[4]
+                ret.append((dispid, invkind, names[0]))
+    else:
+        # Cool - can used cached info.
+        if not interface_names:
+            interface_names = list(mod.VTablesToClassMap.values())
+        for name in interface_names:
+            try:
+                iid = mod.NamesToIIDMap[name]
+            except KeyError:
+                raise ValueError(
+                    "Interface '%s' does not exist in this cached typelib" % (name,)
+                )
+            #            print "Processing interface", name
+            sub_mod = gencache.GetModuleForCLSID(iid)
+            is_dispatch = getattr(sub_mod, name + "_vtables_dispatch_", None)
+            method_defs = getattr(sub_mod, name + "_vtables_", None)
+            if is_dispatch is None or method_defs is None:
+                raise ValueError("Interface '%s' is IDispatch only" % (name,))
+
+            # And create the univgw defn
+            _doCreateVTable(iid, name, is_dispatch, method_defs)
+            for info in method_defs:
+                names, dispid, desc = info
+                invkind = desc[4]
+                ret.append((dispid, invkind, names[0]))
+    return ret
+
+
+def _doCreateVTable(iid, interface_name, is_dispatch, method_defs):
+    defn = Definition(iid, is_dispatch, method_defs)
+    vtbl = _univgw.CreateVTable(defn, is_dispatch)
+    _univgw.RegisterVTable(vtbl, iid, interface_name)
+
+
+def _CalcTypeSize(typeTuple):
+    t = typeTuple[0]
+    if t & (pythoncom.VT_BYREF | pythoncom.VT_ARRAY):
+        # Its a pointer.
+        cb = _univgw.SizeOfVT(pythoncom.VT_PTR)[1]
+    elif t == pythoncom.VT_RECORD:
+        # Just because a type library uses records doesn't mean the user
+        # is trying to.  We need to better place to warn about this, but it
+        # isn't here.
+        # try:
+        #    import warnings
+        #    warnings.warn("warning: records are known to not work for vtable interfaces")
+        # except ImportError:
+        #    print "warning: records are known to not work for vtable interfaces"
+        cb = _univgw.SizeOfVT(pythoncom.VT_PTR)[1]
+        # cb = typeInfo.GetTypeAttr().cbSizeInstance
+    else:
+        cb = _univgw.SizeOfVT(t)[1]
+    return cb
+
+
+class Arg:
+    def __init__(self, arg_info, name=None):
+        self.name = name
+        self.vt, self.inOut, self.default, self.clsid = arg_info
+        self.size = _CalcTypeSize(arg_info)
+        # Offset from the beginning of the arguments of the stack.
+        self.offset = 0
+
+
+class Method:
+    def __init__(self, method_info, isEventSink=0):
+        all_names, dispid, desc = method_info
+        name = all_names[0]
+        names = all_names[1:]
+        invkind = desc[4]
+        arg_defs = desc[2]
+        ret_def = desc[8]
+
+        self.dispid = dispid
+        self.invkind = invkind
+        # We dont use this ATM.
+        #        self.ret = Arg(ret_def)
+        if isEventSink and name[:2] != "On":
+            name = "On%s" % name
+        self.name = name
+        cbArgs = 0
+        self.args = []
+        for argDesc in arg_defs:
+            arg = Arg(argDesc)
+            arg.offset = cbArgs
+            cbArgs = cbArgs + arg.size
+            self.args.append(arg)
+        self.cbArgs = cbArgs
+        self._gw_in_args = self._GenerateInArgTuple()
+        self._gw_out_args = self._GenerateOutArgTuple()
+
+    def _GenerateInArgTuple(self):
+        # Given a method, generate the in argument tuple
+        l = []
+        for arg in self.args:
+            if arg.inOut & pythoncom.PARAMFLAG_FIN or arg.inOut == 0:
+                l.append((arg.vt, arg.offset, arg.size))
+        return tuple(l)
+
+    def _GenerateOutArgTuple(self):
+        # Given a method, generate the out argument tuple
+        l = []
+        for arg in self.args:
+            if (
+                arg.inOut & pythoncom.PARAMFLAG_FOUT
+                or arg.inOut & pythoncom.PARAMFLAG_FRETVAL
+                or arg.inOut == 0
+            ):
+                l.append((arg.vt, arg.offset, arg.size, arg.clsid))
+        return tuple(l)
+
+
+class Definition:
+    def __init__(self, iid, is_dispatch, method_defs):
+        self._iid = iid
+        self._methods = []
+        self._is_dispatch = is_dispatch
+        for info in method_defs:
+            entry = Method(info)
+            self._methods.append(entry)
+
+    def iid(self):
+        return self._iid
+
+    def vtbl_argsizes(self):
+        return [m.cbArgs for m in self._methods]
+
+    def vtbl_argcounts(self):
+        return [len(m.args) for m in self._methods]
+
+    def dispatch(
+        self,
+        ob,
+        index,
+        argPtr,
+        ReadFromInTuple=_univgw.ReadFromInTuple,
+        WriteFromOutTuple=_univgw.WriteFromOutTuple,
+    ):
+        "Dispatch a call to an interface method."
+        meth = self._methods[index]
+        # Infer S_OK if they don't return anything bizarre.
+        hr = 0
+        args = ReadFromInTuple(meth._gw_in_args, argPtr)
+        # If ob is a dispatcher, ensure a policy
+        ob = getattr(ob, "policy", ob)
+        # Ensure the correct dispid is setup
+        ob._dispid_to_func_[meth.dispid] = meth.name
+        retVal = ob._InvokeEx_(meth.dispid, 0, meth.invkind, args, None, None)
+        # None is an allowed return value stating that
+        # the code doesn't want to touch any output arguments.
+        if type(retVal) == tuple:  # Like pythoncom, we special case a tuple.
+            # However, if they want to return a specific HRESULT,
+            # then they have to return all of the out arguments
+            # AND the HRESULT.
+            if len(retVal) == len(meth._gw_out_args) + 1:
+                hr = retVal[0]
+                retVal = retVal[1:]
+            else:
+                raise TypeError(
+                    "Expected %s return values, got: %s"
+                    % (len(meth._gw_out_args) + 1, len(retVal))
+                )
+        else:
+            retVal = [retVal]
+            retVal.extend([None] * (len(meth._gw_out_args) - 1))
+            retVal = tuple(retVal)
+        WriteFromOutTuple(retVal, meth._gw_out_args, argPtr)
+        return hr
diff --git a/lib/win32com/util.py b/lib/win32com/util.py
new file mode 100644
index 00000000..767e34a7
--- /dev/null
+++ b/lib/win32com/util.py
@@ -0,0 +1,34 @@
+"""General utility functions common to client and server.
+
+  This module contains a collection of general purpose utility functions.
+"""
+import pythoncom
+import win32api
+import win32con
+
+
+def IIDToInterfaceName(iid):
+    """Converts an IID to a string interface name.
+
+    Used primarily for debugging purposes, this allows a cryptic IID to
+    be converted to a useful string name.  This will firstly look for interfaces
+    known (ie, registered) by pythoncom.  If not known, it will look in the
+    registry for a registered interface.
+
+    iid -- An IID object.
+
+    Result -- Always a string - either an interface name, or '<Unregistered interface>'
+    """
+    try:
+        return pythoncom.ServerInterfaces[iid]
+    except KeyError:
+        try:
+            try:
+                return win32api.RegQueryValue(
+                    win32con.HKEY_CLASSES_ROOT, "Interface\\%s" % iid
+                )
+            except win32api.error:
+                pass
+        except ImportError:
+            pass
+        return str(iid)
diff --git a/lib/win32comext/adsi/__init__.py b/lib/win32comext/adsi/__init__.py
new file mode 100644
index 00000000..ab95196f
--- /dev/null
+++ b/lib/win32comext/adsi/__init__.py
@@ -0,0 +1,122 @@
+import win32com
+import win32com.client
+
+if type(__path__) == type(""):
+    # For freeze to work!
+    import sys
+
+    try:
+        import adsi
+
+        sys.modules["win32com.adsi.adsi"] = adsi
+    except ImportError:
+        pass
+else:
+    # See if we have a special directory for the binaries (for developers)
+    win32com.__PackageSupportBuildPath__(__path__)
+
+
+# Some helpers
+# We want to _look_ like the ADSI module, but provide some additional
+# helpers.
+
+# Of specific note - most of the interfaces supported by ADSI
+# derive from IDispatch - thus, you get the custome methods from the
+# interface, as well as via IDispatch.
+import pythoncom
+
+from .adsi import *
+
+LCID = 0
+
+IDispatchType = pythoncom.TypeIIDs[pythoncom.IID_IDispatch]
+IADsContainerType = pythoncom.TypeIIDs[adsi.IID_IADsContainer]
+
+
+def _get_good_ret(
+    ob,
+    # Named arguments used internally
+    resultCLSID=None,
+):
+    assert resultCLSID is None, "Now have type info for ADSI objects - fix me!"
+    # See if the object supports IDispatch
+    if hasattr(ob, "Invoke"):
+        import win32com.client.dynamic
+
+        name = "Dispatch wrapper around %r" % ob
+        return win32com.client.dynamic.Dispatch(ob, name, ADSIDispatch)
+    return ob
+
+
+class ADSIEnumerator:
+    def __init__(self, ob):
+        # Query the object for the container interface.
+        self._cont_ = ob.QueryInterface(IID_IADsContainer)
+        self._oleobj_ = ADsBuildEnumerator(self._cont_)  # a PyIADsEnumVARIANT
+        self.index = -1
+
+    def __getitem__(self, index):
+        return self.__GetIndex(index)
+
+    def __call__(self, index):
+        return self.__GetIndex(index)
+
+    def __GetIndex(self, index):
+        if type(index) != type(0):
+            raise TypeError("Only integer indexes are supported for enumerators")
+        if index != self.index + 1:
+            # Index requested out of sequence.
+            raise ValueError("You must index this object sequentially")
+        self.index = index
+        result = ADsEnumerateNext(self._oleobj_, 1)
+        if len(result):
+            return _get_good_ret(result[0])
+        # Failed - reset for next time around.
+        self.index = -1
+        self._oleobj_ = ADsBuildEnumerator(self._cont_)  # a PyIADsEnumVARIANT
+        raise IndexError("list index out of range")
+
+
+class ADSIDispatch(win32com.client.CDispatch):
+    def _wrap_dispatch_(
+        self, ob, userName=None, returnCLSID=None, UnicodeToString=None
+    ):
+        assert UnicodeToString is None, "this is deprectated and will be removed"
+        if not userName:
+            userName = "ADSI-object"
+        olerepr = win32com.client.dynamic.MakeOleRepr(ob, None, None)
+        return ADSIDispatch(ob, olerepr, userName)
+
+    def _NewEnum(self):
+        try:
+            return ADSIEnumerator(self)
+        except pythoncom.com_error:
+            # doesnt support it - let our base try!
+            return win32com.client.CDispatch._NewEnum(self)
+
+    def __getattr__(self, attr):
+        try:
+            return getattr(self._oleobj_, attr)
+        except AttributeError:
+            return win32com.client.CDispatch.__getattr__(self, attr)
+
+    def QueryInterface(self, iid):
+        ret = self._oleobj_.QueryInterface(iid)
+        return _get_good_ret(ret)
+
+
+# We override the global methods to do the right thing.
+_ADsGetObject = ADsGetObject  # The one in the .pyd
+
+
+def ADsGetObject(path, iid=pythoncom.IID_IDispatch):
+    ret = _ADsGetObject(path, iid)
+    return _get_good_ret(ret)
+
+
+_ADsOpenObject = ADsOpenObject
+
+
+def ADsOpenObject(path, username, password, reserved=0, iid=pythoncom.IID_IDispatch):
+    ret = _ADsOpenObject(path, username, password, reserved, iid)
+    return _get_good_ret(ret)
diff --git a/lib/win32comext/adsi/adsi.pyd b/lib/win32comext/adsi/adsi.pyd
new file mode 100644
index 0000000000000000000000000000000000000000..31006a516148760710baa300318a9af1dccaa226
GIT binary patch
literal 97792
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
XDG$A0i+<N&B<0Zv`tR|-VGI0!QGmn`

literal 0
HcmV?d00001

diff --git a/lib/win32comext/adsi/adsicon.py b/lib/win32comext/adsi/adsicon.py
new file mode 100644
index 00000000..9944aefa
--- /dev/null
+++ b/lib/win32comext/adsi/adsicon.py
@@ -0,0 +1,340 @@
+ADS_ATTR_CLEAR = 1
+ADS_ATTR_UPDATE = 2
+ADS_ATTR_APPEND = 3
+ADS_ATTR_DELETE = 4
+ADS_EXT_MINEXTDISPID = 1
+ADS_EXT_MAXEXTDISPID = 16777215
+ADS_EXT_INITCREDENTIALS = 1
+ADS_EXT_INITIALIZE_COMPLETE = 2
+
+ADS_SEARCHPREF_ASYNCHRONOUS = 0
+ADS_SEARCHPREF_DEREF_ALIASES = 1
+ADS_SEARCHPREF_SIZE_LIMIT = 2
+ADS_SEARCHPREF_TIME_LIMIT = 3
+ADS_SEARCHPREF_ATTRIBTYPES_ONLY = 4
+ADS_SEARCHPREF_SEARCH_SCOPE = 5
+ADS_SEARCHPREF_TIMEOUT = 6
+ADS_SEARCHPREF_PAGESIZE = 7
+ADS_SEARCHPREF_PAGED_TIME_LIMIT = 8
+ADS_SEARCHPREF_CHASE_REFERRALS = 9
+ADS_SEARCHPREF_SORT_ON = 10
+ADS_SEARCHPREF_CACHE_RESULTS = 11
+ADS_SEARCHPREF_DIRSYNC = 12
+ADS_SEARCHPREF_TOMBSTONE = 13
+
+ADS_SCOPE_BASE = 0
+ADS_SCOPE_ONELEVEL = 1
+ADS_SCOPE_SUBTREE = 2
+
+ADS_SECURE_AUTHENTICATION = 0x1
+ADS_USE_ENCRYPTION = 0x2
+ADS_USE_SSL = 0x2
+ADS_READONLY_SERVER = 0x4
+ADS_PROMPT_CREDENTIALS = 0x8
+ADS_NO_AUTHENTICATION = 0x10
+ADS_FAST_BIND = 0x20
+ADS_USE_SIGNING = 0x40
+ADS_USE_SEALING = 0x80
+ADS_USE_DELEGATION = 0x100
+ADS_SERVER_BIND = 0x200
+
+ADSTYPE_INVALID = 0
+ADSTYPE_DN_STRING = ADSTYPE_INVALID + 1
+ADSTYPE_CASE_EXACT_STRING = ADSTYPE_DN_STRING + 1
+ADSTYPE_CASE_IGNORE_STRING = ADSTYPE_CASE_EXACT_STRING + 1
+ADSTYPE_PRINTABLE_STRING = ADSTYPE_CASE_IGNORE_STRING + 1
+ADSTYPE_NUMERIC_STRING = ADSTYPE_PRINTABLE_STRING + 1
+ADSTYPE_BOOLEAN = ADSTYPE_NUMERIC_STRING + 1
+ADSTYPE_INTEGER = ADSTYPE_BOOLEAN + 1
+ADSTYPE_OCTET_STRING = ADSTYPE_INTEGER + 1
+ADSTYPE_UTC_TIME = ADSTYPE_OCTET_STRING + 1
+ADSTYPE_LARGE_INTEGER = ADSTYPE_UTC_TIME + 1
+ADSTYPE_PROV_SPECIFIC = ADSTYPE_LARGE_INTEGER + 1
+ADSTYPE_OBJECT_CLASS = ADSTYPE_PROV_SPECIFIC + 1
+ADSTYPE_CASEIGNORE_LIST = ADSTYPE_OBJECT_CLASS + 1
+ADSTYPE_OCTET_LIST = ADSTYPE_CASEIGNORE_LIST + 1
+ADSTYPE_PATH = ADSTYPE_OCTET_LIST + 1
+ADSTYPE_POSTALADDRESS = ADSTYPE_PATH + 1
+ADSTYPE_TIMESTAMP = ADSTYPE_POSTALADDRESS + 1
+ADSTYPE_BACKLINK = ADSTYPE_TIMESTAMP + 1
+ADSTYPE_TYPEDNAME = ADSTYPE_BACKLINK + 1
+ADSTYPE_HOLD = ADSTYPE_TYPEDNAME + 1
+ADSTYPE_NETADDRESS = ADSTYPE_HOLD + 1
+ADSTYPE_REPLICAPOINTER = ADSTYPE_NETADDRESS + 1
+ADSTYPE_FAXNUMBER = ADSTYPE_REPLICAPOINTER + 1
+ADSTYPE_EMAIL = ADSTYPE_FAXNUMBER + 1
+ADSTYPE_NT_SECURITY_DESCRIPTOR = ADSTYPE_EMAIL + 1
+ADSTYPE_UNKNOWN = ADSTYPE_NT_SECURITY_DESCRIPTOR + 1
+ADSTYPE_DN_WITH_BINARY = ADSTYPE_UNKNOWN + 1
+ADSTYPE_DN_WITH_STRING = ADSTYPE_DN_WITH_BINARY + 1
+
+ADS_PROPERTY_CLEAR = 1
+ADS_PROPERTY_UPDATE = 2
+ADS_PROPERTY_APPEND = 3
+ADS_PROPERTY_DELETE = 4
+ADS_SYSTEMFLAG_DISALLOW_DELETE = -2147483648
+ADS_SYSTEMFLAG_CONFIG_ALLOW_RENAME = 0x40000000
+ADS_SYSTEMFLAG_CONFIG_ALLOW_MOVE = 0x20000000
+ADS_SYSTEMFLAG_CONFIG_ALLOW_LIMITED_MOVE = 0x10000000
+ADS_SYSTEMFLAG_DOMAIN_DISALLOW_RENAME = -2147483648
+ADS_SYSTEMFLAG_DOMAIN_DISALLOW_MOVE = 0x4000000
+ADS_SYSTEMFLAG_CR_NTDS_NC = 0x1
+ADS_SYSTEMFLAG_CR_NTDS_DOMAIN = 0x2
+ADS_SYSTEMFLAG_ATTR_NOT_REPLICATED = 0x1
+ADS_SYSTEMFLAG_ATTR_IS_CONSTRUCTED = 0x4
+ADS_GROUP_TYPE_GLOBAL_GROUP = 0x2
+ADS_GROUP_TYPE_DOMAIN_LOCAL_GROUP = 0x4
+ADS_GROUP_TYPE_LOCAL_GROUP = 0x4
+ADS_GROUP_TYPE_UNIVERSAL_GROUP = 0x8
+ADS_GROUP_TYPE_SECURITY_ENABLED = -2147483648
+ADS_UF_SCRIPT = 0x1
+ADS_UF_ACCOUNTDISABLE = 0x2
+ADS_UF_HOMEDIR_REQUIRED = 0x8
+ADS_UF_LOCKOUT = 0x10
+ADS_UF_PASSWD_NOTREQD = 0x20
+ADS_UF_PASSWD_CANT_CHANGE = 0x40
+ADS_UF_ENCRYPTED_TEXT_PASSWORD_ALLOWED = 0x80
+ADS_UF_TEMP_DUPLICATE_ACCOUNT = 0x100
+ADS_UF_NORMAL_ACCOUNT = 0x200
+ADS_UF_INTERDOMAIN_TRUST_ACCOUNT = 0x800
+ADS_UF_WORKSTATION_TRUST_ACCOUNT = 0x1000
+ADS_UF_SERVER_TRUST_ACCOUNT = 0x2000
+ADS_UF_DONT_EXPIRE_PASSWD = 0x10000
+ADS_UF_MNS_LOGON_ACCOUNT = 0x20000
+ADS_UF_SMARTCARD_REQUIRED = 0x40000
+ADS_UF_TRUSTED_FOR_DELEGATION = 0x80000
+ADS_UF_NOT_DELEGATED = 0x100000
+ADS_UF_USE_DES_KEY_ONLY = 0x200000
+ADS_UF_DONT_REQUIRE_PREAUTH = 0x400000
+ADS_UF_PASSWORD_EXPIRED = 0x800000
+ADS_UF_TRUSTED_TO_AUTHENTICATE_FOR_DELEGATION = 0x1000000
+ADS_RIGHT_DELETE = 0x10000
+ADS_RIGHT_READ_CONTROL = 0x20000
+ADS_RIGHT_WRITE_DAC = 0x40000
+ADS_RIGHT_WRITE_OWNER = 0x80000
+ADS_RIGHT_SYNCHRONIZE = 0x100000
+ADS_RIGHT_ACCESS_SYSTEM_SECURITY = 0x1000000
+ADS_RIGHT_GENERIC_READ = -2147483648
+ADS_RIGHT_GENERIC_WRITE = 0x40000000
+ADS_RIGHT_GENERIC_EXECUTE = 0x20000000
+ADS_RIGHT_GENERIC_ALL = 0x10000000
+ADS_RIGHT_DS_CREATE_CHILD = 0x1
+ADS_RIGHT_DS_DELETE_CHILD = 0x2
+ADS_RIGHT_ACTRL_DS_LIST = 0x4
+ADS_RIGHT_DS_SELF = 0x8
+ADS_RIGHT_DS_READ_PROP = 0x10
+ADS_RIGHT_DS_WRITE_PROP = 0x20
+ADS_RIGHT_DS_DELETE_TREE = 0x40
+ADS_RIGHT_DS_LIST_OBJECT = 0x80
+ADS_RIGHT_DS_CONTROL_ACCESS = 0x100
+ADS_ACETYPE_ACCESS_ALLOWED = 0
+ADS_ACETYPE_ACCESS_DENIED = 0x1
+ADS_ACETYPE_SYSTEM_AUDIT = 0x2
+ADS_ACETYPE_ACCESS_ALLOWED_OBJECT = 0x5
+ADS_ACETYPE_ACCESS_DENIED_OBJECT = 0x6
+ADS_ACETYPE_SYSTEM_AUDIT_OBJECT = 0x7
+ADS_ACETYPE_SYSTEM_ALARM_OBJECT = 0x8
+ADS_ACETYPE_ACCESS_ALLOWED_CALLBACK = 0x9
+ADS_ACETYPE_ACCESS_DENIED_CALLBACK = 0xA
+ADS_ACETYPE_ACCESS_ALLOWED_CALLBACK_OBJECT = 0xB
+ADS_ACETYPE_ACCESS_DENIED_CALLBACK_OBJECT = 0xC
+ADS_ACETYPE_SYSTEM_AUDIT_CALLBACK = 0xD
+ADS_ACETYPE_SYSTEM_ALARM_CALLBACK = 0xE
+ADS_ACETYPE_SYSTEM_AUDIT_CALLBACK_OBJECT = 0xF
+ADS_ACETYPE_SYSTEM_ALARM_CALLBACK_OBJECT = 0x10
+ADS_ACEFLAG_INHERIT_ACE = 0x2
+ADS_ACEFLAG_NO_PROPAGATE_INHERIT_ACE = 0x4
+ADS_ACEFLAG_INHERIT_ONLY_ACE = 0x8
+ADS_ACEFLAG_INHERITED_ACE = 0x10
+ADS_ACEFLAG_VALID_INHERIT_FLAGS = 0x1F
+ADS_ACEFLAG_SUCCESSFUL_ACCESS = 0x40
+ADS_ACEFLAG_FAILED_ACCESS = 0x80
+ADS_FLAG_OBJECT_TYPE_PRESENT = 0x1
+ADS_FLAG_INHERITED_OBJECT_TYPE_PRESENT = 0x2
+ADS_SD_CONTROL_SE_OWNER_DEFAULTED = 0x1
+ADS_SD_CONTROL_SE_GROUP_DEFAULTED = 0x2
+ADS_SD_CONTROL_SE_DACL_PRESENT = 0x4
+ADS_SD_CONTROL_SE_DACL_DEFAULTED = 0x8
+ADS_SD_CONTROL_SE_SACL_PRESENT = 0x10
+ADS_SD_CONTROL_SE_SACL_DEFAULTED = 0x20
+ADS_SD_CONTROL_SE_DACL_AUTO_INHERIT_REQ = 0x100
+ADS_SD_CONTROL_SE_SACL_AUTO_INHERIT_REQ = 0x200
+ADS_SD_CONTROL_SE_DACL_AUTO_INHERITED = 0x400
+ADS_SD_CONTROL_SE_SACL_AUTO_INHERITED = 0x800
+ADS_SD_CONTROL_SE_DACL_PROTECTED = 0x1000
+ADS_SD_CONTROL_SE_SACL_PROTECTED = 0x2000
+ADS_SD_CONTROL_SE_SELF_RELATIVE = 0x8000
+ADS_SD_REVISION_DS = 4
+ADS_NAME_TYPE_1779 = 1
+ADS_NAME_TYPE_CANONICAL = 2
+ADS_NAME_TYPE_NT4 = 3
+ADS_NAME_TYPE_DISPLAY = 4
+ADS_NAME_TYPE_DOMAIN_SIMPLE = 5
+ADS_NAME_TYPE_ENTERPRISE_SIMPLE = 6
+ADS_NAME_TYPE_GUID = 7
+ADS_NAME_TYPE_UNKNOWN = 8
+ADS_NAME_TYPE_USER_PRINCIPAL_NAME = 9
+ADS_NAME_TYPE_CANONICAL_EX = 10
+ADS_NAME_TYPE_SERVICE_PRINCIPAL_NAME = 11
+ADS_NAME_TYPE_SID_OR_SID_HISTORY_NAME = 12
+ADS_NAME_INITTYPE_DOMAIN = 1
+ADS_NAME_INITTYPE_SERVER = 2
+ADS_NAME_INITTYPE_GC = 3
+ADS_OPTION_SERVERNAME = 0
+ADS_OPTION_REFERRALS = ADS_OPTION_SERVERNAME + 1
+ADS_OPTION_PAGE_SIZE = ADS_OPTION_REFERRALS + 1
+ADS_OPTION_SECURITY_MASK = ADS_OPTION_PAGE_SIZE + 1
+ADS_OPTION_MUTUAL_AUTH_STATUS = ADS_OPTION_SECURITY_MASK + 1
+ADS_OPTION_QUOTA = ADS_OPTION_MUTUAL_AUTH_STATUS + 1
+ADS_OPTION_PASSWORD_PORTNUMBER = ADS_OPTION_QUOTA + 1
+ADS_OPTION_PASSWORD_METHOD = ADS_OPTION_PASSWORD_PORTNUMBER + 1
+ADS_SECURITY_INFO_OWNER = 0x1
+ADS_SECURITY_INFO_GROUP = 0x2
+ADS_SECURITY_INFO_DACL = 0x4
+ADS_SECURITY_INFO_SACL = 0x8
+ADS_SETTYPE_FULL = 1
+ADS_SETTYPE_PROVIDER = 2
+ADS_SETTYPE_SERVER = 3
+ADS_SETTYPE_DN = 4
+ADS_FORMAT_WINDOWS = 1
+ADS_FORMAT_WINDOWS_NO_SERVER = 2
+ADS_FORMAT_WINDOWS_DN = 3
+ADS_FORMAT_WINDOWS_PARENT = 4
+ADS_FORMAT_X500 = 5
+ADS_FORMAT_X500_NO_SERVER = 6
+ADS_FORMAT_X500_DN = 7
+ADS_FORMAT_X500_PARENT = 8
+ADS_FORMAT_SERVER = 9
+ADS_FORMAT_PROVIDER = 10
+ADS_FORMAT_LEAF = 11
+ADS_DISPLAY_FULL = 1
+ADS_DISPLAY_VALUE_ONLY = 2
+ADS_ESCAPEDMODE_DEFAULT = 1
+ADS_ESCAPEDMODE_ON = 2
+ADS_ESCAPEDMODE_OFF = 3
+ADS_ESCAPEDMODE_OFF_EX = 4
+ADS_PATH_FILE = 1
+ADS_PATH_FILESHARE = 2
+ADS_PATH_REGISTRY = 3
+ADS_SD_FORMAT_IID = 1
+ADS_SD_FORMAT_RAW = 2
+ADS_SD_FORMAT_HEXSTRING = 3
+
+
+# Generated by h2py from AdsErr.h
+def _HRESULT_TYPEDEF_(_sc):
+    return _sc
+
+
+E_ADS_BAD_PATHNAME = _HRESULT_TYPEDEF_((-2147463168))
+E_ADS_INVALID_DOMAIN_OBJECT = _HRESULT_TYPEDEF_((-2147463167))
+E_ADS_INVALID_USER_OBJECT = _HRESULT_TYPEDEF_((-2147463166))
+E_ADS_INVALID_COMPUTER_OBJECT = _HRESULT_TYPEDEF_((-2147463165))
+E_ADS_UNKNOWN_OBJECT = _HRESULT_TYPEDEF_((-2147463164))
+E_ADS_PROPERTY_NOT_SET = _HRESULT_TYPEDEF_((-2147463163))
+E_ADS_PROPERTY_NOT_SUPPORTED = _HRESULT_TYPEDEF_((-2147463162))
+E_ADS_PROPERTY_INVALID = _HRESULT_TYPEDEF_((-2147463161))
+E_ADS_BAD_PARAMETER = _HRESULT_TYPEDEF_((-2147463160))
+E_ADS_OBJECT_UNBOUND = _HRESULT_TYPEDEF_((-2147463159))
+E_ADS_PROPERTY_NOT_MODIFIED = _HRESULT_TYPEDEF_((-2147463158))
+E_ADS_PROPERTY_MODIFIED = _HRESULT_TYPEDEF_((-2147463157))
+E_ADS_CANT_CONVERT_DATATYPE = _HRESULT_TYPEDEF_((-2147463156))
+E_ADS_PROPERTY_NOT_FOUND = _HRESULT_TYPEDEF_((-2147463155))
+E_ADS_OBJECT_EXISTS = _HRESULT_TYPEDEF_((-2147463154))
+E_ADS_SCHEMA_VIOLATION = _HRESULT_TYPEDEF_((-2147463153))
+E_ADS_COLUMN_NOT_SET = _HRESULT_TYPEDEF_((-2147463152))
+S_ADS_ERRORSOCCURRED = _HRESULT_TYPEDEF_(0x00005011)
+S_ADS_NOMORE_ROWS = _HRESULT_TYPEDEF_(0x00005012)
+S_ADS_NOMORE_COLUMNS = _HRESULT_TYPEDEF_(0x00005013)
+E_ADS_INVALID_FILTER = _HRESULT_TYPEDEF_((-2147463148))
+
+# ADS_DEREFENUM enum
+ADS_DEREF_NEVER = 0
+ADS_DEREF_SEARCHING = 1
+ADS_DEREF_FINDING = 2
+ADS_DEREF_ALWAYS = 3
+
+# ADS_PREFERENCES_ENUM
+ADSIPROP_ASYNCHRONOUS = 0
+ADSIPROP_DEREF_ALIASES = 0x1
+ADSIPROP_SIZE_LIMIT = 0x2
+ADSIPROP_TIME_LIMIT = 0x3
+ADSIPROP_ATTRIBTYPES_ONLY = 0x4
+ADSIPROP_SEARCH_SCOPE = 0x5
+ADSIPROP_TIMEOUT = 0x6
+ADSIPROP_PAGESIZE = 0x7
+ADSIPROP_PAGED_TIME_LIMIT = 0x8
+ADSIPROP_CHASE_REFERRALS = 0x9
+ADSIPROP_SORT_ON = 0xA
+ADSIPROP_CACHE_RESULTS = 0xB
+ADSIPROP_ADSIFLAG = 0xC
+
+# ADSI_DIALECT_ENUM
+ADSI_DIALECT_LDAP = 0
+ADSI_DIALECT_SQL = 0x1
+
+# ADS_CHASE_REFERRALS_ENUM
+ADS_CHASE_REFERRALS_NEVER = 0
+ADS_CHASE_REFERRALS_SUBORDINATE = 0x20
+ADS_CHASE_REFERRALS_EXTERNAL = 0x40
+ADS_CHASE_REFERRALS_ALWAYS = (
+    ADS_CHASE_REFERRALS_SUBORDINATE | ADS_CHASE_REFERRALS_EXTERNAL
+)
+
+# Generated by h2py from ObjSel.h
+DSOP_SCOPE_TYPE_TARGET_COMPUTER = 0x00000001
+DSOP_SCOPE_TYPE_UPLEVEL_JOINED_DOMAIN = 0x00000002
+DSOP_SCOPE_TYPE_DOWNLEVEL_JOINED_DOMAIN = 0x00000004
+DSOP_SCOPE_TYPE_ENTERPRISE_DOMAIN = 0x00000008
+DSOP_SCOPE_TYPE_GLOBAL_CATALOG = 0x00000010
+DSOP_SCOPE_TYPE_EXTERNAL_UPLEVEL_DOMAIN = 0x00000020
+DSOP_SCOPE_TYPE_EXTERNAL_DOWNLEVEL_DOMAIN = 0x00000040
+DSOP_SCOPE_TYPE_WORKGROUP = 0x00000080
+DSOP_SCOPE_TYPE_USER_ENTERED_UPLEVEL_SCOPE = 0x00000100
+DSOP_SCOPE_TYPE_USER_ENTERED_DOWNLEVEL_SCOPE = 0x00000200
+DSOP_SCOPE_FLAG_STARTING_SCOPE = 0x00000001
+DSOP_SCOPE_FLAG_WANT_PROVIDER_WINNT = 0x00000002
+DSOP_SCOPE_FLAG_WANT_PROVIDER_LDAP = 0x00000004
+DSOP_SCOPE_FLAG_WANT_PROVIDER_GC = 0x00000008
+DSOP_SCOPE_FLAG_WANT_SID_PATH = 0x00000010
+DSOP_SCOPE_FLAG_WANT_DOWNLEVEL_BUILTIN_PATH = 0x00000020
+DSOP_SCOPE_FLAG_DEFAULT_FILTER_USERS = 0x00000040
+DSOP_SCOPE_FLAG_DEFAULT_FILTER_GROUPS = 0x00000080
+DSOP_SCOPE_FLAG_DEFAULT_FILTER_COMPUTERS = 0x00000100
+DSOP_SCOPE_FLAG_DEFAULT_FILTER_CONTACTS = 0x00000200
+DSOP_FILTER_INCLUDE_ADVANCED_VIEW = 0x00000001
+DSOP_FILTER_USERS = 0x00000002
+DSOP_FILTER_BUILTIN_GROUPS = 0x00000004
+DSOP_FILTER_WELL_KNOWN_PRINCIPALS = 0x00000008
+DSOP_FILTER_UNIVERSAL_GROUPS_DL = 0x00000010
+DSOP_FILTER_UNIVERSAL_GROUPS_SE = 0x00000020
+DSOP_FILTER_GLOBAL_GROUPS_DL = 0x00000040
+DSOP_FILTER_GLOBAL_GROUPS_SE = 0x00000080
+DSOP_FILTER_DOMAIN_LOCAL_GROUPS_DL = 0x00000100
+DSOP_FILTER_DOMAIN_LOCAL_GROUPS_SE = 0x00000200
+DSOP_FILTER_CONTACTS = 0x00000400
+DSOP_FILTER_COMPUTERS = 0x00000800
+DSOP_DOWNLEVEL_FILTER_USERS = -2147483647
+DSOP_DOWNLEVEL_FILTER_LOCAL_GROUPS = -2147483646
+DSOP_DOWNLEVEL_FILTER_GLOBAL_GROUPS = -2147483644
+DSOP_DOWNLEVEL_FILTER_COMPUTERS = -2147483640
+DSOP_DOWNLEVEL_FILTER_WORLD = -2147483632
+DSOP_DOWNLEVEL_FILTER_AUTHENTICATED_USER = -2147483616
+DSOP_DOWNLEVEL_FILTER_ANONYMOUS = -2147483584
+DSOP_DOWNLEVEL_FILTER_BATCH = -2147483520
+DSOP_DOWNLEVEL_FILTER_CREATOR_OWNER = -2147483392
+DSOP_DOWNLEVEL_FILTER_CREATOR_GROUP = -2147483136
+DSOP_DOWNLEVEL_FILTER_DIALUP = -2147482624
+DSOP_DOWNLEVEL_FILTER_INTERACTIVE = -2147481600
+DSOP_DOWNLEVEL_FILTER_NETWORK = -2147479552
+DSOP_DOWNLEVEL_FILTER_SERVICE = -2147475456
+DSOP_DOWNLEVEL_FILTER_SYSTEM = -2147467264
+DSOP_DOWNLEVEL_FILTER_EXCLUDE_BUILTIN_GROUPS = -2147450880
+DSOP_DOWNLEVEL_FILTER_TERMINAL_SERVER = -2147418112
+DSOP_DOWNLEVEL_FILTER_ALL_WELLKNOWN_SIDS = -2147352576
+DSOP_DOWNLEVEL_FILTER_LOCAL_SERVICE = -2147221504
+DSOP_DOWNLEVEL_FILTER_NETWORK_SERVICE = -2146959360
+DSOP_DOWNLEVEL_FILTER_REMOTE_LOGON = -2146435072
+DSOP_FLAG_MULTISELECT = 0x00000001
+DSOP_FLAG_SKIP_TARGET_COMPUTER_DC_CHECK = 0x00000002
+CFSTR_DSOP_DS_SELECTION_LIST = "CFSTR_DSOP_DS_SELECTION_LIST"
diff --git a/lib/win32comext/adsi/demos/objectPicker.py b/lib/win32comext/adsi/demos/objectPicker.py
new file mode 100644
index 00000000..5df42459
--- /dev/null
+++ b/lib/win32comext/adsi/demos/objectPicker.py
@@ -0,0 +1,68 @@
+# A demo for the IDsObjectPicker interface.
+import pythoncom
+import win32clipboard
+from win32com.adsi import adsi
+from win32com.adsi.adsicon import *
+
+cf_objectpicker = win32clipboard.RegisterClipboardFormat(CFSTR_DSOP_DS_SELECTION_LIST)
+
+
+def main():
+    hwnd = 0
+
+    # Create an instance of the object picker.
+    picker = pythoncom.CoCreateInstance(
+        adsi.CLSID_DsObjectPicker,
+        None,
+        pythoncom.CLSCTX_INPROC_SERVER,
+        adsi.IID_IDsObjectPicker,
+    )
+
+    # Create our scope init info.
+    siis = adsi.DSOP_SCOPE_INIT_INFOs(1)
+    sii = siis[0]
+
+    # Combine multiple scope types in a single array entry.
+
+    sii.type = (
+        DSOP_SCOPE_TYPE_UPLEVEL_JOINED_DOMAIN | DSOP_SCOPE_TYPE_DOWNLEVEL_JOINED_DOMAIN
+    )
+
+    # Set uplevel and downlevel filters to include only computer objects.
+    # Uplevel filters apply to both mixed and native modes.
+    # Notice that the uplevel and downlevel flags are different.
+
+    sii.filterFlags.uplevel.bothModes = DSOP_FILTER_COMPUTERS
+    sii.filterFlags.downlevel = DSOP_DOWNLEVEL_FILTER_COMPUTERS
+
+    # Initialize the interface.
+    picker.Initialize(
+        None,  # Target is the local computer.
+        siis,  # scope infos
+        DSOP_FLAG_MULTISELECT,  # options
+        ("objectGUID", "displayName"),
+    )  # attributes to fetch
+
+    do = picker.InvokeDialog(hwnd)
+    # Extract the data from the IDataObject.
+    format_etc = (
+        cf_objectpicker,
+        None,
+        pythoncom.DVASPECT_CONTENT,
+        -1,
+        pythoncom.TYMED_HGLOBAL,
+    )
+    medium = do.GetData(format_etc)
+    data = adsi.StringAsDS_SELECTION_LIST(medium.data)
+    for item in data:
+        name, klass, adspath, upn, attrs, flags = item
+        print("Item", name)
+        print(" Class:", klass)
+        print(" AdsPath:", adspath)
+        print(" UPN:", upn)
+        print(" Attrs:", attrs)
+        print(" Flags:", flags)
+
+
+if __name__ == "__main__":
+    main()
diff --git a/lib/win32comext/adsi/demos/scp.py b/lib/win32comext/adsi/demos/scp.py
new file mode 100644
index 00000000..d1a4ca05
--- /dev/null
+++ b/lib/win32comext/adsi/demos/scp.py
@@ -0,0 +1,565 @@
+"""A re-implementation of the MS DirectoryService samples related to services.
+
+* Adds and removes an ActiveDirectory "Service Connection Point",
+  including managing the security on the object.
+* Creates and registers Service Principal Names.
+* Changes the username for a domain user.
+
+Some of these functions are likely to become move to a module - but there
+is also a little command-line-interface to try these functions out.
+
+For example:
+
+scp.py --account-name=domain\\user --service-class=PythonScpTest \\
+       --keyword=foo --keyword=bar --binding-string=bind_info \\
+       ScpCreate SpnCreate SpnRegister
+
+would:
+* Attempt to delete a Service Connection Point for the service class
+  'PythonScpTest'
+* Attempt to create a Service Connection Point for that class, with 2
+  keywords and a binding string of 'bind_info'
+* Create a Service Principal Name for the service and register it
+
+to undo those changes, you could execute:
+
+scp.py --account-name=domain\\user --service-class=PythonScpTest \\
+       SpnCreate SpnUnregister ScpDelete
+
+which will:
+* Create a SPN
+* Unregister that SPN from the Active Directory.
+* Delete the Service Connection Point
+
+Executing with --test will create and remove one of everything.
+"""
+
+import optparse
+import textwrap
+import traceback
+
+import ntsecuritycon as dscon
+import win32api
+import win32con
+import win32security
+import winerror
+from win32com.adsi import adsi
+from win32com.adsi.adsicon import *
+from win32com.client import Dispatch
+
+verbose = 1
+g_createdSCP = None
+g_createdSPNs = []
+g_createdSPNLast = None
+
+import logging
+
+logger = logging  # use logging module global methods for now.
+
+# still a bit confused about log(n, ...) vs logger.info/debug()
+
+
+# Returns distinguished name of SCP.
+def ScpCreate(
+    service_binding_info,
+    service_class_name,  # Service class string to store in SCP.
+    account_name=None,  # Logon account that needs access to SCP.
+    container_name=None,
+    keywords=None,
+    object_class="serviceConnectionPoint",
+    dns_name_type="A",
+    dn=None,
+    dns_name=None,
+):
+    container_name = container_name or service_class_name
+    if not dns_name:
+        # Get the DNS name of the local computer
+        dns_name = win32api.GetComputerNameEx(win32con.ComputerNameDnsFullyQualified)
+    # Get the distinguished name of the computer object for the local computer
+    if dn is None:
+        dn = win32api.GetComputerObjectName(win32con.NameFullyQualifiedDN)
+
+    # Compose the ADSpath and bind to the computer object for the local computer
+    comp = adsi.ADsGetObject("LDAP://" + dn, adsi.IID_IDirectoryObject)
+
+    # Publish the SCP as a child of the computer object
+    keywords = keywords or []
+    # Fill in the attribute values to be stored in the SCP.
+    attrs = [
+        ("cn", ADS_ATTR_UPDATE, ADSTYPE_CASE_IGNORE_STRING, (container_name,)),
+        ("objectClass", ADS_ATTR_UPDATE, ADSTYPE_CASE_IGNORE_STRING, (object_class,)),
+        ("keywords", ADS_ATTR_UPDATE, ADSTYPE_CASE_IGNORE_STRING, keywords),
+        ("serviceDnsName", ADS_ATTR_UPDATE, ADSTYPE_CASE_IGNORE_STRING, (dns_name,)),
+        (
+            "serviceDnsNameType",
+            ADS_ATTR_UPDATE,
+            ADSTYPE_CASE_IGNORE_STRING,
+            (dns_name_type,),
+        ),
+        (
+            "serviceClassName",
+            ADS_ATTR_UPDATE,
+            ADSTYPE_CASE_IGNORE_STRING,
+            (service_class_name,),
+        ),
+        (
+            "serviceBindingInformation",
+            ADS_ATTR_UPDATE,
+            ADSTYPE_CASE_IGNORE_STRING,
+            (service_binding_info,),
+        ),
+    ]
+    new = comp.CreateDSObject("cn=" + container_name, attrs)
+    logger.info("New connection point is at %s", container_name)
+    # Wrap in a usable IDispatch object.
+    new = Dispatch(new)
+    # And allow access to the SCP for the specified account name
+    AllowAccessToScpProperties(account_name, new)
+    return new
+
+
+def ScpDelete(container_name, dn=None):
+    if dn is None:
+        dn = win32api.GetComputerObjectName(win32con.NameFullyQualifiedDN)
+    logger.debug("Removing connection point '%s' from %s", container_name, dn)
+
+    # Compose the ADSpath and bind to the computer object for the local computer
+    comp = adsi.ADsGetObject("LDAP://" + dn, adsi.IID_IDirectoryObject)
+    comp.DeleteDSObject("cn=" + container_name)
+    logger.info("Deleted service connection point '%s'", container_name)
+
+
+# This function is described in detail in the MSDN article titled
+# "Enabling Service Account to Access SCP Properties"
+# From that article:
+# The following sample code sets a pair of ACEs on a service connection point
+# (SCP) object. The ACEs grant read/write access to the user or computer account
+# under which the service instance will be running. Your service installation
+# program calls this code to ensure that the service will be allowed to update
+# its properties at run time. If you don't set ACEs like these, your service
+# will get access-denied errors if it tries to modify the SCP's properties.
+#
+# The code uses the IADsSecurityDescriptor, IADsAccessControlList, and
+# IADsAccessControlEntry interfaces to do the following:
+# * Get the SCP object's security descriptor.
+# * Set ACEs in the DACL of the security descriptor.
+# * Set the security descriptor back on the SCP object.
+
+
+def AllowAccessToScpProperties(
+    accountSAM,  # Service account to allow access.
+    scpObject,  # The IADs SCP object.
+    schemaIDGUIDs=(  # Attributes to allow write-access to.
+        "{28630eb8-41d5-11d1-a9c1-0000f80367c1}",  # serviceDNSName
+        "{b7b1311c-b82e-11d0-afee-0000f80367c1}",  # serviceBindingInformation
+    ),
+):
+    # If no service account is specified, service runs under LocalSystem.
+    # So allow access to the computer account of the service's host.
+    if accountSAM:
+        trustee = accountSAM
+    else:
+        # Get the SAM account name of the computer object for the server.
+        trustee = win32api.GetComputerObjectName(win32con.NameSamCompatible)
+
+    # Get the nTSecurityDescriptor attribute
+    attribute = "nTSecurityDescriptor"
+    sd = getattr(scpObject, attribute)
+    acl = sd.DiscretionaryAcl
+
+    for sguid in schemaIDGUIDs:
+        ace = Dispatch(adsi.CLSID_AccessControlEntry)
+
+        # Set the properties of the ACE.
+        # Allow read and write access to the property.
+        ace.AccessMask = ADS_RIGHT_DS_READ_PROP | ADS_RIGHT_DS_WRITE_PROP
+
+        # Set the trustee, which is either the service account or the
+        # host computer account.
+        ace.Trustee = trustee
+
+        # Set the ACE type.
+        ace.AceType = ADS_ACETYPE_ACCESS_ALLOWED_OBJECT
+
+        # Set AceFlags to zero because ACE is not inheritable.
+        ace.AceFlags = 0
+
+        # Set Flags to indicate an ACE that protects a specified object.
+        ace.Flags = ADS_FLAG_OBJECT_TYPE_PRESENT
+
+        # Set ObjectType to the schemaIDGUID of the attribute.
+        ace.ObjectType = sguid
+
+        # Add the ACEs to the DACL.
+        acl.AddAce(ace)
+
+    # Write the modified DACL back to the security descriptor.
+    sd.DiscretionaryAcl = acl
+    # Write the ntSecurityDescriptor property to the property cache.
+    setattr(scpObject, attribute, sd)
+    # SetInfo updates the SCP object in the directory.
+    scpObject.SetInfo()
+    logger.info("Set security on object for account '%s'" % (trustee,))
+
+
+# Service Principal Names functions from the same sample.
+# The example calls the DsWriteAccountSpn function, which stores the SPNs in
+# Microsoft Active Directory under the servicePrincipalName attribute of the
+# account object specified by the serviceAcctDN parameter. The account object
+# corresponds to the logon account specified in the CreateService call for this
+# service instance. If the logon account is a domain user account,
+# serviceAcctDN must be the distinguished name of the account object in
+# Active Directory for that user account. If the service's logon account is the
+# LocalSystem account, serviceAcctDN must be the distinguished name of the
+# computer account object for the host computer on which the service is
+# installed. win32api.TranslateNames and win32security.DsCrackNames can
+# be used to convert a domain\account format name to a distinguished name.
+def SpnRegister(
+    serviceAcctDN,  # DN of the service's logon account
+    spns,  # List of SPNs to register
+    operation,  # Add, replace, or delete SPNs
+):
+    assert type(spns) not in [str, str] and hasattr(spns, "__iter__"), (
+        "spns must be a sequence of strings (got %r)" % spns
+    )
+    # Bind to a domain controller.
+    # Get the domain for the current user.
+    samName = win32api.GetUserNameEx(win32api.NameSamCompatible)
+    samName = samName.split("\\", 1)[0]
+
+    if not serviceAcctDN:
+        # Get the SAM account name of the computer object for the server.
+        serviceAcctDN = win32api.GetComputerObjectName(win32con.NameFullyQualifiedDN)
+    logger.debug("SpnRegister using DN '%s'", serviceAcctDN)
+
+    # Get the name of a domain controller in that domain.
+    info = win32security.DsGetDcName(
+        domainName=samName,
+        flags=dscon.DS_IS_FLAT_NAME
+        | dscon.DS_RETURN_DNS_NAME
+        | dscon.DS_DIRECTORY_SERVICE_REQUIRED,
+    )
+    # Bind to the domain controller.
+    handle = win32security.DsBind(info["DomainControllerName"])
+
+    # Write the SPNs to the service account or computer account.
+    logger.debug("DsWriteAccountSpn with spns %s")
+    win32security.DsWriteAccountSpn(
+        handle,  # handle to the directory
+        operation,  # Add or remove SPN from account's existing SPNs
+        serviceAcctDN,  # DN of service account or computer account
+        spns,
+    )  # names
+
+    # Unbind the DS in any case (but Python would do it anyway)
+    handle.Close()
+
+
+def UserChangePassword(username_dn, new_password):
+    # set the password on the account.
+    # Use the distinguished name to bind to the account object.
+    accountPath = "LDAP://" + username_dn
+    user = adsi.ADsGetObject(accountPath, adsi.IID_IADsUser)
+
+    # Set the password on the account.
+    user.SetPassword(new_password)
+
+
+# functions related to the command-line interface
+def log(level, msg, *args):
+    if verbose >= level:
+        print(msg % args)
+
+
+class _NoDefault:
+    pass
+
+
+def _get_option(po, opt_name, default=_NoDefault):
+    parser, options = po
+    ret = getattr(options, opt_name, default)
+    if not ret and default is _NoDefault:
+        parser.error("The '%s' option must be specified for this operation" % opt_name)
+    if not ret:
+        ret = default
+    return ret
+
+
+def _option_error(po, why):
+    parser = po[0]
+    parser.error(why)
+
+
+def do_ScpCreate(po):
+    """Create a Service Connection Point"""
+    global g_createdSCP
+    scp = ScpCreate(
+        _get_option(po, "binding_string"),
+        _get_option(po, "service_class"),
+        _get_option(po, "account_name_sam", None),
+        keywords=_get_option(po, "keywords", None),
+    )
+    g_createdSCP = scp
+    return scp.distinguishedName
+
+
+def do_ScpDelete(po):
+    """Delete a Service Connection Point"""
+    sc = _get_option(po, "service_class")
+    try:
+        ScpDelete(sc)
+    except adsi.error as details:
+        if details[0] != winerror.ERROR_DS_OBJ_NOT_FOUND:
+            raise
+        log(2, "ScpDelete ignoring ERROR_DS_OBJ_NOT_FOUND for service-class '%s'", sc)
+    return sc
+
+
+def do_SpnCreate(po):
+    """Create a Service Principal Name"""
+    # The 'service name' is the dn of our scp.
+    if g_createdSCP is None:
+        # Could accept an arg to avoid this?
+        _option_error(po, "ScpCreate must have been specified before SpnCreate")
+    # Create a Service Principal Name"
+    spns = win32security.DsGetSpn(
+        dscon.DS_SPN_SERVICE,
+        _get_option(po, "service_class"),
+        g_createdSCP.distinguishedName,
+        _get_option(po, "port", 0),
+        None,
+        None,
+    )
+    spn = spns[0]
+    log(2, "Created SPN: %s", spn)
+    global g_createdSPNLast
+    g_createdSPNLast = spn
+    g_createdSPNs.append(spn)
+    return spn
+
+
+def do_SpnRegister(po):
+    """Register a previously created Service Principal Name"""
+    if not g_createdSPNLast:
+        _option_error(po, "SpnCreate must appear before SpnRegister")
+
+    SpnRegister(
+        _get_option(po, "account_name_dn", None),
+        (g_createdSPNLast,),
+        dscon.DS_SPN_ADD_SPN_OP,
+    )
+    return g_createdSPNLast
+
+
+def do_SpnUnregister(po):
+    """Unregister a previously created Service Principal Name"""
+    if not g_createdSPNLast:
+        _option_error(po, "SpnCreate must appear before SpnUnregister")
+    SpnRegister(
+        _get_option(po, "account_name_dn", None),
+        (g_createdSPNLast,),
+        dscon.DS_SPN_DELETE_SPN_OP,
+    )
+    return g_createdSPNLast
+
+
+def do_UserChangePassword(po):
+    """Change the password for a specified user"""
+    UserChangePassword(_get_option(po, "account_name_dn"), _get_option(po, "password"))
+    return "Password changed OK"
+
+
+handlers = (
+    ("ScpCreate", do_ScpCreate),
+    ("ScpDelete", do_ScpDelete),
+    ("SpnCreate", do_SpnCreate),
+    ("SpnRegister", do_SpnRegister),
+    ("SpnUnregister", do_SpnUnregister),
+    ("UserChangePassword", do_UserChangePassword),
+)
+
+
+class HelpFormatter(optparse.IndentedHelpFormatter):
+    def format_description(self, description):
+        return description
+
+
+def main():
+    global verbose
+    _handlers_dict = {}
+
+    arg_descs = []
+    for arg, func in handlers:
+        this_desc = "\n".join(textwrap.wrap(func.__doc__, subsequent_indent=" " * 8))
+        arg_descs.append("  %s: %s" % (arg, this_desc))
+        _handlers_dict[arg.lower()] = func
+
+    description = __doc__ + "\ncommands:\n" + "\n".join(arg_descs) + "\n"
+
+    parser = optparse.OptionParser(
+        usage="%prog [options] command ...",
+        description=description,
+        formatter=HelpFormatter(),
+    )
+
+    parser.add_option(
+        "-v",
+        action="count",
+        dest="verbose",
+        default=1,
+        help="increase the verbosity of status messages",
+    )
+
+    parser.add_option(
+        "-q", "--quiet", action="store_true", help="Don't print any status messages"
+    )
+
+    parser.add_option(
+        "-t",
+        "--test",
+        action="store_true",
+        help="Execute a mini-test suite, providing defaults for most options and args",
+    ),
+
+    parser.add_option(
+        "",
+        "--show-tracebacks",
+        action="store_true",
+        help="Show the tracebacks for any exceptions",
+    )
+
+    parser.add_option("", "--service-class", help="The service class name to use")
+
+    parser.add_option(
+        "", "--port", default=0, help="The port number to associate with the SPN"
+    )
+
+    parser.add_option(
+        "", "--binding-string", help="The binding string to use for SCP creation"
+    )
+
+    parser.add_option(
+        "", "--account-name", help="The account name to use (default is LocalSystem)"
+    )
+
+    parser.add_option("", "--password", help="The password to set.")
+
+    parser.add_option(
+        "",
+        "--keyword",
+        action="append",
+        dest="keywords",
+        help="""A keyword to add to the SCP.  May be specified
+                              multiple times""",
+    )
+
+    parser.add_option(
+        "",
+        "--log-level",
+        help="""The log-level to use - may be a number or a logging
+                             module constant""",
+        default=str(logging.WARNING),
+    )
+
+    options, args = parser.parse_args()
+    po = (parser, options)
+    # fixup misc
+    try:
+        options.port = int(options.port)
+    except (TypeError, ValueError):
+        parser.error("--port must be numeric")
+    # fixup log-level
+    try:
+        log_level = int(options.log_level)
+    except (TypeError, ValueError):
+        try:
+            log_level = int(getattr(logging, options.log_level.upper()))
+        except (ValueError, TypeError, AttributeError):
+            parser.error("Invalid --log-level value")
+    try:
+        sl = logger.setLevel
+        # logger is a real logger
+    except AttributeError:
+        # logger is logging module
+        sl = logging.getLogger().setLevel
+    sl(log_level)
+    # Check -q/-v
+    if options.quiet and options.verbose:
+        parser.error("Can't specify --quiet and --verbose")
+    if options.quiet:
+        options.verbose -= 1
+    verbose = options.verbose
+    # --test
+    if options.test:
+        if args:
+            parser.error("Can't specify args with --test")
+
+        args = "ScpDelete ScpCreate SpnCreate SpnRegister SpnUnregister ScpDelete"
+        log(1, "--test - pretending args are:\n %s", args)
+        args = args.split()
+        if not options.service_class:
+            options.service_class = "PythonScpTest"
+            log(2, "--test: --service-class=%s", options.service_class)
+        if not options.keywords:
+            options.keywords = "Python Powered".split()
+            log(2, "--test: --keyword=%s", options.keywords)
+        if not options.binding_string:
+            options.binding_string = "test binding string"
+            log(2, "--test: --binding-string=%s", options.binding_string)
+
+    # check args
+    if not args:
+        parser.error("No command specified (use --help for valid commands)")
+    for arg in args:
+        if arg.lower() not in _handlers_dict:
+            parser.error("Invalid command '%s' (use --help for valid commands)" % arg)
+
+    # Patch up account-name.
+    if options.account_name:
+        log(2, "Translating account name '%s'", options.account_name)
+        options.account_name_sam = win32security.TranslateName(
+            options.account_name, win32api.NameUnknown, win32api.NameSamCompatible
+        )
+        log(2, "NameSamCompatible is '%s'", options.account_name_sam)
+        options.account_name_dn = win32security.TranslateName(
+            options.account_name, win32api.NameUnknown, win32api.NameFullyQualifiedDN
+        )
+        log(2, "NameFullyQualifiedDNis '%s'", options.account_name_dn)
+
+    # do it.
+    for arg in args:
+        handler = _handlers_dict[arg.lower()]  # already been validated
+        if handler is None:
+            parser.error("Invalid command '%s'" % arg)
+        err_msg = None
+        try:
+            try:
+                log(2, "Executing '%s'...", arg)
+                result = handler(po)
+                log(1, "%s: %s", arg, result)
+            except:
+                if options.show_tracebacks:
+                    print("--show-tracebacks specified - dumping exception")
+                    traceback.print_exc()
+                raise
+        except adsi.error as xxx_todo_changeme:
+            (hr, desc, exc, argerr) = xxx_todo_changeme.args
+            if exc:
+                extra_desc = exc[2]
+            else:
+                extra_desc = ""
+            err_msg = desc
+            if extra_desc:
+                err_msg += "\n\t" + extra_desc
+        except win32api.error as xxx_todo_changeme1:
+            (hr, func, msg) = xxx_todo_changeme1.args
+            err_msg = msg
+        if err_msg:
+            log(1, "Command '%s' failed: %s", arg, err_msg)
+
+
+if __name__ == "__main__":
+    try:
+        main()
+    except KeyboardInterrupt:
+        print("*** Interrupted")
diff --git a/lib/win32comext/adsi/demos/search.py b/lib/win32comext/adsi/demos/search.py
new file mode 100644
index 00000000..22c6a258
--- /dev/null
+++ b/lib/win32comext/adsi/demos/search.py
@@ -0,0 +1,152 @@
+import pythoncom
+import pywintypes
+import win32security
+from win32com.adsi import adsi, adsicon
+from win32com.adsi.adsicon import *
+
+options = None  # set to optparse options object
+
+ADsTypeNameMap = {}
+
+
+def getADsTypeName(type_val):
+    # convert integer type to the 'typename' as known in the headerfiles.
+    if not ADsTypeNameMap:
+        for n, v in adsicon.__dict__.items():
+            if n.startswith("ADSTYPE_"):
+                ADsTypeNameMap[v] = n
+    return ADsTypeNameMap.get(type_val, hex(type_val))
+
+
+def _guid_from_buffer(b):
+    return pywintypes.IID(b, True)
+
+
+def _sid_from_buffer(b):
+    return str(pywintypes.SID(b))
+
+
+_null_converter = lambda x: x
+
+converters = {
+    "objectGUID": _guid_from_buffer,
+    "objectSid": _sid_from_buffer,
+    "instanceType": getADsTypeName,
+}
+
+
+def log(level, msg, *args):
+    if options.verbose >= level:
+        print("log:", msg % args)
+
+
+def getGC():
+    cont = adsi.ADsOpenObject(
+        "GC:", options.user, options.password, 0, adsi.IID_IADsContainer
+    )
+    enum = adsi.ADsBuildEnumerator(cont)
+    # Only 1 child of the global catalog.
+    for e in enum:
+        gc = e.QueryInterface(adsi.IID_IDirectorySearch)
+        return gc
+    return None
+
+
+def print_attribute(col_data):
+    prop_name, prop_type, values = col_data
+    if values is not None:
+        log(2, "property '%s' has type '%s'", prop_name, getADsTypeName(prop_type))
+        value = [converters.get(prop_name, _null_converter)(v[0]) for v in values]
+        if len(value) == 1:
+            value = value[0]
+        print(" %s=%r" % (prop_name, value))
+    else:
+        print(" %s is None" % (prop_name,))
+
+
+def search():
+    gc = getGC()
+    if gc is None:
+        log(0, "Can't find the global catalog")
+        return
+
+    prefs = [(ADS_SEARCHPREF_SEARCH_SCOPE, (ADS_SCOPE_SUBTREE,))]
+    hr, statuses = gc.SetSearchPreference(prefs)
+    log(3, "SetSearchPreference returned %d/%r", hr, statuses)
+
+    if options.attributes:
+        attributes = options.attributes.split(",")
+    else:
+        attributes = None
+
+    h = gc.ExecuteSearch(options.filter, attributes)
+    hr = gc.GetNextRow(h)
+    while hr != S_ADS_NOMORE_ROWS:
+        print("-- new row --")
+        if attributes is None:
+            # Loop over all columns returned
+            while 1:
+                col_name = gc.GetNextColumnName(h)
+                if col_name is None:
+                    break
+                data = gc.GetColumn(h, col_name)
+                print_attribute(data)
+        else:
+            # loop over attributes specified.
+            for a in attributes:
+                try:
+                    data = gc.GetColumn(h, a)
+                    print_attribute(data)
+                except adsi.error as details:
+                    if details[0] != E_ADS_COLUMN_NOT_SET:
+                        raise
+                    print_attribute((a, None, None))
+        hr = gc.GetNextRow(h)
+    gc.CloseSearchHandle(h)
+
+
+def main():
+    global options
+    from optparse import OptionParser
+
+    parser = OptionParser()
+    parser.add_option(
+        "-f", "--file", dest="filename", help="write report to FILE", metavar="FILE"
+    )
+    parser.add_option(
+        "-v",
+        "--verbose",
+        action="count",
+        default=1,
+        help="increase verbosity of output",
+    )
+    parser.add_option(
+        "-q", "--quiet", action="store_true", help="suppress output messages"
+    )
+
+    parser.add_option("-U", "--user", help="specify the username used to connect")
+    parser.add_option("-P", "--password", help="specify the password used to connect")
+    parser.add_option(
+        "",
+        "--filter",
+        default="(&(objectCategory=person)(objectClass=User))",
+        help="specify the search filter",
+    )
+    parser.add_option(
+        "", "--attributes", help="comma sep'd list of attribute names to print"
+    )
+
+    options, args = parser.parse_args()
+    if options.quiet:
+        if options.verbose != 1:
+            parser.error("Can not use '--verbose' and '--quiet'")
+        options.verbose = 0
+
+    if args:
+        parser.error("You need not specify args")
+
+    search()
+
+
+if __name__ == "__main__":
+    main()
diff --git a/lib/win32comext/adsi/demos/test.py b/lib/win32comext/adsi/demos/test.py
new file mode 100644
index 00000000..a1dba34d
--- /dev/null
+++ b/lib/win32comext/adsi/demos/test.py
@@ -0,0 +1,273 @@
+import string
+import sys
+
+import pythoncom
+import win32api
+from win32com.adsi import *
+
+verbose_level = 0
+
+server = ""  # Must have trailing /
+local_name = win32api.GetComputerName()
+
+
+def DumpRoot():
+    "Dumps the root DSE"
+    path = "LDAP://%srootDSE" % server
+    rootdse = ADsGetObject(path)
+
+    for item in rootdse.Get("SupportedLDAPVersion"):
+        print("%s supports ldap version %s" % (path, item))
+
+    attributes = ["CurrentTime", "defaultNamingContext"]
+    for attr in attributes:
+        val = rootdse.Get(attr)
+        print(" %s=%s" % (attr, val))
+
+
+###############################################
+#
+# Code taken from article titled:
+# Reading attributeSchema and classSchema Objects
+def _DumpClass(child):
+    attrs = "Abstract lDAPDisplayName schemaIDGUID schemaNamingContext attributeSyntax oMSyntax"
+    _DumpTheseAttributes(child, string.split(attrs))
+
+
+def _DumpAttribute(child):
+    attrs = "lDAPDisplayName schemaIDGUID adminDescription adminDisplayName rDNAttID defaultHidingValue defaultObjectCategory systemOnly defaultSecurityDescriptor"
+    _DumpTheseAttributes(child, string.split(attrs))
+
+
+def _DumpTheseAttributes(child, attrs):
+    for attr in attrs:
+        try:
+            val = child.Get(attr)
+        except pythoncom.com_error as details:
+            continue
+            # ###
+            (hr, msg, exc, arg) = details
+            if exc and exc[2]:
+                msg = exc[2]
+            val = "<Error: %s>" % (msg,)
+        if verbose_level >= 2:
+            print(" %s: %s=%s" % (child.Class, attr, val))
+
+
+def DumpSchema():
+    "Dumps the default DSE schema"
+    # Bind to rootDSE to get the schemaNamingContext property.
+    path = "LDAP://%srootDSE" % server
+    rootdse = ADsGetObject(path)
+    name = rootdse.Get("schemaNamingContext")
+
+    # Bind to the actual schema container.
+    path = "LDAP://" + server + name
+    print("Binding to", path)
+    ob = ADsGetObject(path)
+    nclasses = nattr = nsub = nunk = 0
+
+    # Enumerate the attribute and class objects in the schema container.
+    for child in ob:
+        # Find out if this is a class, attribute, or subSchema object.
+        class_name = child.Class
+        if class_name == "classSchema":
+            _DumpClass(child)
+            nclasses = nclasses + 1
+        elif class_name == "attributeSchema":
+            _DumpAttribute(child)
+            nattr = nattr + 1
+        elif class_name == "subSchema":
+            nsub = nsub + 1
+        else:
+            print("Unknown class:", class_name)
+            nunk = nunk + 1
+    if verbose_level:
+        print("Processed", nclasses, "classes")
+        print("Processed", nattr, "attributes")
+        print("Processed", nsub, "sub-schema's")
+        print("Processed", nunk, "unknown types")
+
+
+def _DumpObject(ob, level=0):
+    prefix = "  " * level
+    print("%s%s object: %s" % (prefix, ob.Class, ob.Name))
+    # Do the directory object thing
+    try:
+        dir_ob = ADsGetObject(ob.ADsPath, IID_IDirectoryObject)
+    except pythoncom.com_error:
+        dir_ob = None
+    if dir_ob is not None:
+        info = dir_ob.GetObjectInformation()
+        print("%s RDN='%s', ObjectDN='%s'" % (prefix, info.RDN, info.ObjectDN))
+        # Create a list of names to fetch
+        names = ["distinguishedName"]
+        attrs = dir_ob.GetObjectAttributes(names)
+        for attr in attrs:
+            for val, typ in attr.Values:
+                print("%s Attribute '%s' = %s" % (prefix, attr.AttrName, val))
+
+    for child in ob:
+        _DumpObject(child, level + 1)
+
+
+def DumpAllObjects():
+    "Recursively dump the entire directory!"
+    path = "LDAP://%srootDSE" % server
+    rootdse = ADsGetObject(path)
+    name = rootdse.Get("defaultNamingContext")
+
+    # Bind to the actual schema container.
+    path = "LDAP://" + server + name
+    print("Binding to", path)
+    ob = ADsGetObject(path)
+
+    # Enumerate the attribute and class objects in the schema container.
+    _DumpObject(ob)
+
+
+##########################################################
+#
+# Code taken from article:
+# Example Code for Enumerating Schema Classes, Attributes, and Syntaxes
+
+# Fill a map with VT_ datatypes, to give us better names:
+vt_map = {}
+for name, val in pythoncom.__dict__.items():
+    if name[:3] == "VT_":
+        vt_map[val] = name
+
+
+def DumpSchema2():
+    "Dumps the schema using an alternative technique"
+    path = "LDAP://%sschema" % (server,)
+    schema = ADsGetObject(path, IID_IADsContainer)
+    nclass = nprop = nsyntax = 0
+    for item in schema:
+        item_class = string.lower(item.Class)
+        if item_class == "class":
+            items = []
+            if item.Abstract:
+                items.append("Abstract")
+            if item.Auxiliary:
+                items.append("Auxiliary")
+            # 			if item.Structural: items.append("Structural")
+            desc = string.join(items, ", ")
+            import win32com.util
+
+            iid_name = win32com.util.IIDToInterfaceName(item.PrimaryInterface)
+            if verbose_level >= 2:
+                print(
+                    "Class: Name=%s, Flags=%s, Primary Interface=%s"
+                    % (item.Name, desc, iid_name)
+                )
+            nclass = nclass + 1
+        elif item_class == "property":
+            if item.MultiValued:
+                val_type = "Multi-Valued"
+            else:
+                val_type = "Single-Valued"
+            if verbose_level >= 2:
+                print("Property: Name=%s, %s" % (item.Name, val_type))
+            nprop = nprop + 1
+        elif item_class == "syntax":
+            data_type = vt_map.get(item.OleAutoDataType, "<unknown type>")
+            if verbose_level >= 2:
+                print("Syntax: Name=%s, Datatype = %s" % (item.Name, data_type))
+            nsyntax = nsyntax + 1
+    if verbose_level >= 1:
+        print("Processed", nclass, "classes")
+        print("Processed", nprop, "properties")
+        print("Processed", nsyntax, "syntax items")
+
+
+def DumpGC():
+    "Dumps the GC: object (whatever that is!)"
+    ob = ADsGetObject("GC:", IID_IADsContainer)
+    for sub_ob in ob:
+        print("GC ob: %s (%s)" % (sub_ob.Name, sub_ob.ADsPath))
+
+
+def DumpLocalUsers():
+    "Dumps the local machine users"
+    path = "WinNT://%s,computer" % (local_name,)
+    ob = ADsGetObject(path, IID_IADsContainer)
+    ob.put_Filter(["User", "Group"])
+    for sub_ob in ob:
+        print("User/Group: %s (%s)" % (sub_ob.Name, sub_ob.ADsPath))
+
+
+def DumpLocalGroups():
+    "Dumps the local machine groups"
+    path = "WinNT://%s,computer" % (local_name,)
+    ob = ADsGetObject(path, IID_IADsContainer)
+
+    ob.put_Filter(["Group"])
+    for sub_ob in ob:
+        print("Group: %s (%s)" % (sub_ob.Name, sub_ob.ADsPath))
+        # get the members
+        members = sub_ob.Members()
+        for member in members:
+            print("  Group member: %s (%s)" % (member.Name, member.ADsPath))
+
+
+def usage(tests):
+    import os
+
+    print("Usage: %s [-s server ] [-v] [Test ...]" % os.path.basename(sys.argv[0]))
+    print("  -v : Verbose - print more information")
+    print("  -s : server - execute the tests against the named server")
+    print("where Test is one of:")
+    for t in tests:
+        print(t.__name__, ":", t.__doc__)
+    print()
+    print("If not tests are specified, all tests are run")
+    sys.exit(1)
+
+
+def main():
+    import getopt
+    import traceback
+
+    tests = []
+    for ob in globals().values():
+        if type(ob) == type(main) and ob.__doc__:
+            tests.append(ob)
+    opts, args = getopt.getopt(sys.argv[1:], "s:hv")
+    for opt, val in opts:
+        if opt == "-s":
+            if val[-1] not in "\\/":
+                val = val + "/"
+            global server
+            server = val
+        if opt == "-h":
+            usage(tests)
+        if opt == "-v":
+            global verbose_level
+            verbose_level = verbose_level + 1
+
+    if len(args) == 0:
+        print("Running all tests - use '-h' to see command-line options...")
+        dotests = tests
+    else:
+        dotests = []
+        for arg in args:
+            for t in tests:
+                if t.__name__ == arg:
+                    dotests.append(t)
+                    break
+            else:
+                print("Test '%s' unknown - skipping" % arg)
+    if not len(dotests):
+        print("Nothing to do!")
+        usage(tests)
+    for test in dotests:
+        try:
+            test()
+        except:
+            print("Test %s failed" % test.__name__)
+            traceback.print_exc()
+
+
+if __name__ == "__main__":
+    main()
diff --git a/lib/win32comext/authorization/__init__.py b/lib/win32comext/authorization/__init__.py
new file mode 100644
index 00000000..3a893267
--- /dev/null
+++ b/lib/win32comext/authorization/__init__.py
@@ -0,0 +1,6 @@
+# This is a python package
+# __PackageSupportBuildPath__ not needed for distutil based builds,
+# but not everyone is there yet.
+import win32com
+
+win32com.__PackageSupportBuildPath__(__path__)
diff --git a/lib/win32comext/authorization/authorization.pyd b/lib/win32comext/authorization/authorization.pyd
new file mode 100644
index 0000000000000000000000000000000000000000..4c473bd0baf49054bdcf5e64324cf0bc383a3c9b
GIT binary patch
literal 29696
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
J_WTz#@E_GUC+h$J

literal 0
HcmV?d00001

diff --git a/lib/win32comext/authorization/demos/EditSecurity.py b/lib/win32comext/authorization/demos/EditSecurity.py
new file mode 100644
index 00000000..d961bc0d
--- /dev/null
+++ b/lib/win32comext/authorization/demos/EditSecurity.py
@@ -0,0 +1,255 @@
+import os
+
+import ntsecuritycon
+import pythoncom
+import win32api
+import win32com.server.policy
+import win32con
+import win32security
+from ntsecuritycon import (
+    CONTAINER_INHERIT_ACE,
+    FILE_ALL_ACCESS,
+    FILE_APPEND_DATA,
+    FILE_GENERIC_EXECUTE,
+    FILE_GENERIC_READ,
+    FILE_GENERIC_WRITE,
+    FILE_READ_ATTRIBUTES,
+    FILE_READ_DATA,
+    FILE_READ_EA,
+    FILE_WRITE_ATTRIBUTES,
+    FILE_WRITE_DATA,
+    FILE_WRITE_EA,
+    INHERIT_ONLY_ACE,
+    OBJECT_INHERIT_ACE,
+    PSPCB_SI_INITDIALOG,
+    READ_CONTROL,
+    SI_ACCESS_CONTAINER,
+    SI_ACCESS_GENERAL,
+    SI_ACCESS_PROPERTY,
+    SI_ACCESS_SPECIFIC,
+    SI_ADVANCED,
+    SI_CONTAINER,
+    SI_EDIT_ALL,
+    SI_EDIT_AUDITS,
+    SI_EDIT_PROPERTIES,
+    SI_PAGE_ADVPERM,
+    SI_PAGE_AUDIT,
+    SI_PAGE_OWNER,
+    SI_PAGE_PERM,
+    SI_PAGE_TITLE,
+    SI_RESET,
+    STANDARD_RIGHTS_EXECUTE,
+    STANDARD_RIGHTS_READ,
+    STANDARD_RIGHTS_WRITE,
+    SYNCHRONIZE,
+    WRITE_DAC,
+    WRITE_OWNER,
+)
+from pythoncom import IID_NULL
+from win32com.authorization import authorization
+from win32com.shell.shellcon import (  # # Msg parameter to PropertySheetPageCallback
+    PSPCB_CREATE,
+    PSPCB_RELEASE,
+)
+from win32security import CONTAINER_INHERIT_ACE, INHERIT_ONLY_ACE, OBJECT_INHERIT_ACE
+
+
+class SecurityInformation(win32com.server.policy.DesignatedWrapPolicy):
+    _com_interfaces_ = [authorization.IID_ISecurityInformation]
+    _public_methods_ = [
+        "GetObjectInformation",
+        "GetSecurity",
+        "SetSecurity",
+        "GetAccessRights",
+        "GetInheritTypes",
+        "MapGeneric",
+        "PropertySheetPageCallback",
+    ]
+
+    def __init__(self, FileName):
+        self.FileName = FileName
+        self._wrap_(self)
+
+    def GetObjectInformation(self):
+        """Identifies object whose security will be modified, and determines options available
+        to the end user"""
+        flags = SI_ADVANCED | SI_EDIT_ALL | SI_PAGE_TITLE | SI_RESET
+        if os.path.isdir(self.FileName):
+            flags |= SI_CONTAINER
+        hinstance = 0  ## handle to module containing string resources
+        servername = ""  ## name of authenticating server if not local machine
+        objectname = os.path.split(self.FileName)[1]
+        pagetitle = "Python ACL Editor"
+        if os.path.isdir(self.FileName):
+            pagetitle += " (dir)"
+        else:
+            pagetitle += " (file)"
+        objecttype = IID_NULL
+        return flags, hinstance, servername, objectname, pagetitle, objecttype
+
+    def GetSecurity(self, requestedinfo, bdefault):
+        """Requests the existing permissions for object"""
+        if bdefault:
+            ## This is invoked if the 'Default' button is pressed (only present if SI_RESET is passed
+            ## with the flags in GetObjectInfo). Passing an empty SD with a NULL Dacl
+            ##  should cause inherited ACL from parent dir or default dacl from user's token to be used
+            return win32security.SECURITY_DESCRIPTOR()
+        else:
+            ## GetFileSecurity sometimes fails to return flags indicating that an ACE is inherited
+            return win32security.GetNamedSecurityInfo(
+                self.FileName, win32security.SE_FILE_OBJECT, requestedinfo
+            )
+
+    def SetSecurity(self, requestedinfo, sd):
+        """Applies permissions to the object"""
+        owner = sd.GetSecurityDescriptorOwner()
+        group = sd.GetSecurityDescriptorGroup()
+        dacl = sd.GetSecurityDescriptorDacl()
+        sacl = sd.GetSecurityDescriptorSacl()
+        win32security.SetNamedSecurityInfo(
+            self.FileName,
+            win32security.SE_FILE_OBJECT,
+            requestedinfo,
+            owner,
+            group,
+            dacl,
+            sacl,
+        )
+        ## should also handle recursive operations here
+
+    def GetAccessRights(self, objecttype, flags):
+        """Returns a tuple of (AccessRights, DefaultAccess), where AccessRights is a sequence of tuples representing
+        SI_ACCESS structs, containing (guid, access mask, Name, flags). DefaultAccess indicates which of the
+        AccessRights will be used initially when a new ACE is added (zero based).
+        Flags can contain SI_ACCESS_SPECIFIC,SI_ACCESS_GENERAL,SI_ACCESS_CONTAINER,SI_ACCESS_PROPERTY,
+              CONTAINER_INHERIT_ACE,INHERIT_ONLY_ACE,OBJECT_INHERIT_ACE
+        """
+        ## input flags: SI_ADVANCED,SI_EDIT_AUDITS,SI_EDIT_PROPERTIES indicating which property sheet is requesting the rights
+        if (objecttype is not None) and (objecttype != IID_NULL):
+            ## Should not be true for file objects.  Usually only used with DS objects that support security for
+            ## their properties
+            raise NotImplementedError("Object type is not supported")
+
+        if os.path.isdir(self.FileName):
+            file_append_data_desc = "Create subfolders"
+            file_write_data_desc = "Create Files"
+        else:
+            file_append_data_desc = "Append data"
+            file_write_data_desc = "Write data"
+
+        accessrights = [
+            (
+                IID_NULL,
+                FILE_GENERIC_READ,
+                "Generic read",
+                SI_ACCESS_GENERAL
+                | SI_ACCESS_SPECIFIC
+                | OBJECT_INHERIT_ACE
+                | CONTAINER_INHERIT_ACE,
+            ),
+            (
+                IID_NULL,
+                FILE_GENERIC_WRITE,
+                "Generic write",
+                SI_ACCESS_GENERAL
+                | SI_ACCESS_SPECIFIC
+                | OBJECT_INHERIT_ACE
+                | CONTAINER_INHERIT_ACE,
+            ),
+            (
+                IID_NULL,
+                win32con.DELETE,
+                "Delete",
+                SI_ACCESS_SPECIFIC | OBJECT_INHERIT_ACE | CONTAINER_INHERIT_ACE,
+            ),
+            (
+                IID_NULL,
+                WRITE_OWNER,
+                "Change owner",
+                SI_ACCESS_SPECIFIC | OBJECT_INHERIT_ACE | CONTAINER_INHERIT_ACE,
+            ),
+            (
+                IID_NULL,
+                READ_CONTROL,
+                "Read Permissions",
+                SI_ACCESS_SPECIFIC | OBJECT_INHERIT_ACE | CONTAINER_INHERIT_ACE,
+            ),
+            (
+                IID_NULL,
+                WRITE_DAC,
+                "Change permissions",
+                SI_ACCESS_SPECIFIC | OBJECT_INHERIT_ACE | CONTAINER_INHERIT_ACE,
+            ),
+            (
+                IID_NULL,
+                FILE_APPEND_DATA,
+                file_append_data_desc,
+                SI_ACCESS_SPECIFIC | OBJECT_INHERIT_ACE | CONTAINER_INHERIT_ACE,
+            ),
+            (
+                IID_NULL,
+                FILE_WRITE_DATA,
+                file_write_data_desc,
+                SI_ACCESS_SPECIFIC | OBJECT_INHERIT_ACE | CONTAINER_INHERIT_ACE,
+            ),
+        ]
+        return (accessrights, 0)
+
+    def MapGeneric(self, guid, aceflags, mask):
+        """Converts generic access rights to specific rights.  This implementation uses standard file system rights,
+        but you can map them any way that suits your application.
+        """
+        return win32security.MapGenericMask(
+            mask,
+            (
+                FILE_GENERIC_READ,
+                FILE_GENERIC_WRITE,
+                FILE_GENERIC_EXECUTE,
+                FILE_ALL_ACCESS,
+            ),
+        )
+
+    def GetInheritTypes(self):
+        """Specifies which types of ACE inheritance are supported.
+        Returns a sequence of tuples representing SI_INHERIT_TYPE structs, containing
+        (object type guid, inheritance flags, display name).  Guid is usually only used with
+        Directory Service objects.
+        """
+        return (
+            (IID_NULL, 0, "Only current object"),
+            (IID_NULL, OBJECT_INHERIT_ACE, "Files inherit permissions"),
+            (IID_NULL, CONTAINER_INHERIT_ACE, "Sub Folders inherit permissions"),
+            (
+                IID_NULL,
+                CONTAINER_INHERIT_ACE | OBJECT_INHERIT_ACE,
+                "Files and subfolders",
+            ),
+        )
+
+    def PropertySheetPageCallback(self, hwnd, msg, pagetype):
+        """Invoked each time a property sheet page is created or destroyed."""
+        ## page types from SI_PAGE_TYPE enum: SI_PAGE_PERM SI_PAGE_ADVPERM SI_PAGE_AUDIT SI_PAGE_OWNER
+        ## msg: PSPCB_CREATE, PSPCB_RELEASE, PSPCB_SI_INITDIALOG
+        return None
+
+    def EditSecurity(self, owner_hwnd=0):
+        """Creates an ACL editor dialog based on parameters returned by interface methods"""
+        isi = pythoncom.WrapObject(
+            self, authorization.IID_ISecurityInformation, pythoncom.IID_IUnknown
+        )
+        authorization.EditSecurity(owner_hwnd, isi)
+
+
+## folder permissions
+temp_dir = win32api.GetTempPath()
+dir_name = win32api.GetTempFileName(temp_dir, "isi")[0]
+print(dir_name)
+os.remove(dir_name)
+os.mkdir(dir_name)
+si = SecurityInformation(dir_name)
+si.EditSecurity()
+
+## file permissions
+fname = win32api.GetTempFileName(dir_name, "isi")[0]
+si = SecurityInformation(fname)
+si.EditSecurity()
diff --git a/lib/win32comext/authorization/demos/EditServiceSecurity.py b/lib/win32comext/authorization/demos/EditServiceSecurity.py
new file mode 100644
index 00000000..86d60414
--- /dev/null
+++ b/lib/win32comext/authorization/demos/EditServiceSecurity.py
@@ -0,0 +1,242 @@
+"""
+Implements a permissions editor for services.
+Service can be specified as plain name for local machine,
+or as a remote service of the form \\machinename\service
+"""
+
+import os
+
+import ntsecuritycon
+import pythoncom
+import win32api
+import win32com.server.policy
+import win32con
+import win32security
+import win32service
+from win32com.authorization import authorization
+
+SERVICE_GENERIC_EXECUTE = (
+    win32service.SERVICE_START
+    | win32service.SERVICE_STOP
+    | win32service.SERVICE_PAUSE_CONTINUE
+    | win32service.SERVICE_USER_DEFINED_CONTROL
+)
+SERVICE_GENERIC_READ = (
+    win32service.SERVICE_QUERY_CONFIG
+    | win32service.SERVICE_QUERY_STATUS
+    | win32service.SERVICE_INTERROGATE
+    | win32service.SERVICE_ENUMERATE_DEPENDENTS
+)
+SERVICE_GENERIC_WRITE = win32service.SERVICE_CHANGE_CONFIG
+
+from ntsecuritycon import (
+    CONTAINER_INHERIT_ACE,
+    INHERIT_ONLY_ACE,
+    OBJECT_INHERIT_ACE,
+    PSPCB_SI_INITDIALOG,
+    READ_CONTROL,
+    SI_ACCESS_CONTAINER,
+    SI_ACCESS_GENERAL,
+    SI_ACCESS_PROPERTY,
+    SI_ACCESS_SPECIFIC,
+    SI_ADVANCED,
+    SI_CONTAINER,
+    SI_EDIT_ALL,
+    SI_EDIT_AUDITS,
+    SI_EDIT_PROPERTIES,
+    SI_PAGE_ADVPERM,
+    SI_PAGE_AUDIT,
+    SI_PAGE_OWNER,
+    SI_PAGE_PERM,
+    SI_PAGE_TITLE,
+    SI_RESET,
+    STANDARD_RIGHTS_EXECUTE,
+    STANDARD_RIGHTS_READ,
+    STANDARD_RIGHTS_WRITE,
+    WRITE_DAC,
+    WRITE_OWNER,
+)
+from pythoncom import IID_NULL
+from win32com.shell.shellcon import (  # # Msg parameter to PropertySheetPageCallback
+    PSPCB_CREATE,
+    PSPCB_RELEASE,
+)
+from win32security import CONTAINER_INHERIT_ACE, INHERIT_ONLY_ACE, OBJECT_INHERIT_ACE
+
+
+class ServiceSecurity(win32com.server.policy.DesignatedWrapPolicy):
+    _com_interfaces_ = [authorization.IID_ISecurityInformation]
+    _public_methods_ = [
+        "GetObjectInformation",
+        "GetSecurity",
+        "SetSecurity",
+        "GetAccessRights",
+        "GetInheritTypes",
+        "MapGeneric",
+        "PropertySheetPageCallback",
+    ]
+
+    def __init__(self, ServiceName):
+        self.ServiceName = ServiceName
+        self._wrap_(self)
+
+    def GetObjectInformation(self):
+        """Identifies object whose security will be modified, and determines options available
+        to the end user"""
+        flags = SI_ADVANCED | SI_EDIT_ALL | SI_PAGE_TITLE | SI_RESET
+        hinstance = 0  ## handle to module containing string resources
+        servername = ""  ## name of authenticating server if not local machine
+
+        ## service name can contain remote machine name of the form \\Server\ServiceName
+        objectname = os.path.split(self.ServiceName)[1]
+        pagetitle = "Service Permissions for " + self.ServiceName
+        objecttype = IID_NULL
+        return flags, hinstance, servername, objectname, pagetitle, objecttype
+
+    def GetSecurity(self, requestedinfo, bdefault):
+        """Requests the existing permissions for object"""
+        if bdefault:
+            return win32security.SECURITY_DESCRIPTOR()
+        else:
+            return win32security.GetNamedSecurityInfo(
+                self.ServiceName, win32security.SE_SERVICE, requestedinfo
+            )
+
+    def SetSecurity(self, requestedinfo, sd):
+        """Applies permissions to the object"""
+        owner = sd.GetSecurityDescriptorOwner()
+        group = sd.GetSecurityDescriptorGroup()
+        dacl = sd.GetSecurityDescriptorDacl()
+        sacl = sd.GetSecurityDescriptorSacl()
+        win32security.SetNamedSecurityInfo(
+            self.ServiceName,
+            win32security.SE_SERVICE,
+            requestedinfo,
+            owner,
+            group,
+            dacl,
+            sacl,
+        )
+
+    def GetAccessRights(self, objecttype, flags):
+        """Returns a tuple of (AccessRights, DefaultAccess), where AccessRights is a sequence of tuples representing
+        SI_ACCESS structs, containing (guid, access mask, Name, flags). DefaultAccess indicates which of the
+        AccessRights will be used initially when a new ACE is added (zero based).
+        Flags can contain SI_ACCESS_SPECIFIC,SI_ACCESS_GENERAL,SI_ACCESS_CONTAINER,SI_ACCESS_PROPERTY,
+              CONTAINER_INHERIT_ACE,INHERIT_ONLY_ACE,OBJECT_INHERIT_ACE
+        """
+        ## input flags: SI_ADVANCED,SI_EDIT_AUDITS,SI_EDIT_PROPERTIES indicating which property sheet is requesting the rights
+        if (objecttype is not None) and (objecttype != IID_NULL):
+            ## Not relevent for services
+            raise NotImplementedError("Object type is not supported")
+
+        ## ???? for some reason, the DACL for a service will not retain ACCESS_SYSTEM_SECURITY in an ACE ????
+        ## (IID_NULL, win32con.ACCESS_SYSTEM_SECURITY, 'View/change audit settings', SI_ACCESS_SPECIFIC),
+
+        accessrights = [
+            (
+                IID_NULL,
+                win32service.SERVICE_ALL_ACCESS,
+                "Full control",
+                SI_ACCESS_GENERAL,
+            ),
+            (IID_NULL, SERVICE_GENERIC_READ, "Generic read", SI_ACCESS_GENERAL),
+            (IID_NULL, SERVICE_GENERIC_WRITE, "Generic write", SI_ACCESS_GENERAL),
+            (
+                IID_NULL,
+                SERVICE_GENERIC_EXECUTE,
+                "Start/Stop/Pause service",
+                SI_ACCESS_GENERAL,
+            ),
+            (IID_NULL, READ_CONTROL, "Read Permissions", SI_ACCESS_GENERAL),
+            (IID_NULL, WRITE_DAC, "Change permissions", SI_ACCESS_GENERAL),
+            (IID_NULL, WRITE_OWNER, "Change owner", SI_ACCESS_GENERAL),
+            (IID_NULL, win32con.DELETE, "Delete service", SI_ACCESS_GENERAL),
+            (IID_NULL, win32service.SERVICE_START, "Start service", SI_ACCESS_SPECIFIC),
+            (IID_NULL, win32service.SERVICE_STOP, "Stop service", SI_ACCESS_SPECIFIC),
+            (
+                IID_NULL,
+                win32service.SERVICE_PAUSE_CONTINUE,
+                "Pause/unpause service",
+                SI_ACCESS_SPECIFIC,
+            ),
+            (
+                IID_NULL,
+                win32service.SERVICE_USER_DEFINED_CONTROL,
+                "Execute user defined operations",
+                SI_ACCESS_SPECIFIC,
+            ),
+            (
+                IID_NULL,
+                win32service.SERVICE_QUERY_CONFIG,
+                "Read configuration",
+                SI_ACCESS_SPECIFIC,
+            ),
+            (
+                IID_NULL,
+                win32service.SERVICE_CHANGE_CONFIG,
+                "Change configuration",
+                SI_ACCESS_SPECIFIC,
+            ),
+            (
+                IID_NULL,
+                win32service.SERVICE_ENUMERATE_DEPENDENTS,
+                "List dependent services",
+                SI_ACCESS_SPECIFIC,
+            ),
+            (
+                IID_NULL,
+                win32service.SERVICE_QUERY_STATUS,
+                "Query status",
+                SI_ACCESS_SPECIFIC,
+            ),
+            (
+                IID_NULL,
+                win32service.SERVICE_INTERROGATE,
+                "Query status (immediate)",
+                SI_ACCESS_SPECIFIC,
+            ),
+        ]
+        return (accessrights, 0)
+
+    def MapGeneric(self, guid, aceflags, mask):
+        """Converts generic access rights to specific rights."""
+        return win32security.MapGenericMask(
+            mask,
+            (
+                SERVICE_GENERIC_READ,
+                SERVICE_GENERIC_WRITE,
+                SERVICE_GENERIC_EXECUTE,
+                win32service.SERVICE_ALL_ACCESS,
+            ),
+        )
+
+    def GetInheritTypes(self):
+        """Specifies which types of ACE inheritance are supported.
+        Services don't use any inheritance
+        """
+        return ((IID_NULL, 0, "Only current object"),)
+
+    def PropertySheetPageCallback(self, hwnd, msg, pagetype):
+        """Invoked each time a property sheet page is created or destroyed."""
+        ## page types from SI_PAGE_TYPE enum: SI_PAGE_PERM SI_PAGE_ADVPERM SI_PAGE_AUDIT SI_PAGE_OWNER
+        ## msg: PSPCB_CREATE, PSPCB_RELEASE, PSPCB_SI_INITDIALOG
+        return None
+
+    def EditSecurity(self, owner_hwnd=0):
+        """Creates an ACL editor dialog based on parameters returned by interface methods"""
+        isi = pythoncom.WrapObject(
+            self, authorization.IID_ISecurityInformation, pythoncom.IID_IUnknown
+        )
+        authorization.EditSecurity(owner_hwnd, isi)
+
+
+if __name__ == "__main__":
+    # Find the first service on local machine and edit its permissions
+    scm = win32service.OpenSCManager(
+        None, None, win32service.SC_MANAGER_ENUMERATE_SERVICE
+    )
+    svcs = win32service.EnumServicesStatus(scm)
+    win32service.CloseServiceHandle(scm)
+    si = ServiceSecurity(svcs[0][0])
+    si.EditSecurity()
diff --git a/lib/win32comext/axcontrol/__init__.py b/lib/win32comext/axcontrol/__init__.py
new file mode 100644
index 00000000..8d5db8b9
--- /dev/null
+++ b/lib/win32comext/axcontrol/__init__.py
@@ -0,0 +1,4 @@
+# See if we have a special directory for the binaries (for developers)
+import win32com
+
+win32com.__PackageSupportBuildPath__(__path__)
diff --git a/lib/win32comext/axcontrol/axcontrol.pyd b/lib/win32comext/axcontrol/axcontrol.pyd
new file mode 100644
index 0000000000000000000000000000000000000000..40cb13efb8d20aab01709722d253e1391db7d154
GIT binary patch
literal 143872
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
XS;@6%E1fn<&^q$OfBW-))dK$wa>5hi

literal 0
HcmV?d00001

diff --git a/lib/win32comext/axdebug/__init__.py b/lib/win32comext/axdebug/__init__.py
new file mode 100644
index 00000000..8d5db8b9
--- /dev/null
+++ b/lib/win32comext/axdebug/__init__.py
@@ -0,0 +1,4 @@
+# See if we have a special directory for the binaries (for developers)
+import win32com
+
+win32com.__PackageSupportBuildPath__(__path__)
diff --git a/lib/win32comext/axdebug/adb.py b/lib/win32comext/axdebug/adb.py
new file mode 100644
index 00000000..812c23e6
--- /dev/null
+++ b/lib/win32comext/axdebug/adb.py
@@ -0,0 +1,480 @@
+"""The glue between the Python debugger interface and the Active Debugger interface
+"""
+import _thread
+import bdb
+import os
+import sys
+import traceback
+
+import pythoncom
+import win32api
+import win32com.client.connect
+from win32com.axdebug.util import _wrap, _wrap_remove, trace
+from win32com.server.util import unwrap
+
+from . import axdebug, gateways, stackframe
+
+
+def fnull(*args):
+    pass
+
+
+try:
+    os.environ["DEBUG_AXDEBUG"]
+    debugging = 1
+except KeyError:
+    debugging = 0
+
+traceenter = fnull  # trace enter of functions
+tracev = fnull  # verbose trace
+
+if debugging:
+    traceenter = trace  # trace enter of functions
+    tracev = trace  # verbose trace
+
+
+class OutputReflector:
+    def __init__(self, file, writefunc):
+        self.writefunc = writefunc
+        self.file = file
+
+    def __getattr__(self, name):
+        return getattr(self.file, name)
+
+    def write(self, message):
+        self.writefunc(message)
+        self.file.write(message)
+
+
+def _dumpf(frame):
+    if frame is None:
+        return "<None>"
+    else:
+        addn = "(with trace!)"
+        if frame.f_trace is None:
+            addn = " **No Trace Set **"
+        return "Frame at %d, file %s, line: %d%s" % (
+            id(frame),
+            frame.f_code.co_filename,
+            frame.f_lineno,
+            addn,
+        )
+
+
+g_adb = None
+
+
+def OnSetBreakPoint(codeContext, breakPointState, lineNo):
+    try:
+        fileName = codeContext.codeContainer.GetFileName()
+        # inject the code into linecache.
+        import linecache
+
+        linecache.cache[fileName] = 0, 0, codeContext.codeContainer.GetText(), fileName
+        g_adb._OnSetBreakPoint(fileName, codeContext, breakPointState, lineNo + 1)
+    except:
+        traceback.print_exc()
+
+
+class Adb(bdb.Bdb, gateways.RemoteDebugApplicationEvents):
+    def __init__(self):
+        self.debugApplication = None
+        self.debuggingThread = None
+        self.debuggingThreadStateHandle = None
+        self.stackSnifferCookie = self.stackSniffer = None
+        self.codeContainerProvider = None
+        self.debuggingThread = None
+        self.breakFlags = None
+        self.breakReason = None
+        self.appDebugger = None
+        self.appEventConnection = None
+        self.logicalbotframe = None  # Anything at this level or below does not exist!
+        self.currentframe = None  # The frame we are currently in.
+        self.recursiveData = []  # Data saved for each reentery on this thread.
+        bdb.Bdb.__init__(self)
+        self._threadprotectlock = _thread.allocate_lock()
+        self.reset()
+
+    def canonic(self, fname):
+        if fname[0] == "<":
+            return fname
+        return bdb.Bdb.canonic(self, fname)
+
+    def reset(self):
+        traceenter("adb.reset")
+        bdb.Bdb.reset(self)
+
+    def __xxxxx__set_break(self, filename, lineno, cond=None):
+        # As per standard one, except no linecache checking!
+        if filename not in self.breaks:
+            self.breaks[filename] = []
+        list = self.breaks[filename]
+        if lineno in list:
+            return "There is already a breakpoint there!"
+        list.append(lineno)
+        if cond is not None:
+            self.cbreaks[filename, lineno] = cond
+
+    def stop_here(self, frame):
+        traceenter("stop_here", _dumpf(frame), _dumpf(self.stopframe))
+        # As per bdb.stop_here, except for logicalbotframe
+        ##              if self.stopframe is None:
+        ##                      return 1
+        if frame is self.stopframe:
+            return 1
+
+        tracev("stop_here said 'No'!")
+        return 0
+
+    def break_here(self, frame):
+        traceenter("break_here", self.breakFlags, _dumpf(frame))
+        self.breakReason = None
+        if self.breakFlags == axdebug.APPBREAKFLAG_DEBUGGER_HALT:
+            self.breakReason = axdebug.BREAKREASON_DEBUGGER_HALT
+        elif self.breakFlags == axdebug.APPBREAKFLAG_DEBUGGER_BLOCK:
+            self.breakReason = axdebug.BREAKREASON_DEBUGGER_BLOCK
+        elif self.breakFlags == axdebug.APPBREAKFLAG_STEP:
+            self.breakReason = axdebug.BREAKREASON_STEP
+        else:
+            print("Calling base 'break_here' with", self.breaks)
+            if bdb.Bdb.break_here(self, frame):
+                self.breakReason = axdebug.BREAKREASON_BREAKPOINT
+        return self.breakReason is not None
+
+    def break_anywhere(self, frame):
+        traceenter("break_anywhere", _dumpf(frame))
+        if self.breakFlags == axdebug.APPBREAKFLAG_DEBUGGER_HALT:
+            self.breakReason = axdebug.BREAKREASON_DEBUGGER_HALT
+            return 1
+        rc = bdb.Bdb.break_anywhere(self, frame)
+        tracev("break_anywhere", _dumpf(frame), "returning", rc)
+        return rc
+
+    def dispatch_return(self, frame, arg):
+        traceenter("dispatch_return", _dumpf(frame), arg)
+        if self.logicalbotframe is frame:
+            # We dont want to debug parent frames.
+            tracev("dispatch_return resetting sys.trace")
+            sys.settrace(None)
+            return
+        #                       self.bSetTrace = 0
+        self.currentframe = frame.f_back
+        return bdb.Bdb.dispatch_return(self, frame, arg)
+
+    def dispatch_line(self, frame):
+        traceenter("dispatch_line", _dumpf(frame), _dumpf(self.botframe))
+        #               trace("logbotframe is", _dumpf(self.logicalbotframe), "botframe is", self.botframe)
+        if frame is self.logicalbotframe:
+            trace("dispatch_line", _dumpf(frame), "for bottom frame returing tracer")
+            # The next code executed in the frame above may be a builtin (eg, apply())
+            # in which sys.trace needs to be set.
+            sys.settrace(self.trace_dispatch)
+            # And return the tracer incase we are about to execute Python code,
+            # in which case sys tracer is ignored!
+            return self.trace_dispatch
+
+        if self.codeContainerProvider.FromFileName(frame.f_code.co_filename) is None:
+            trace(
+                "dispatch_line has no document for", _dumpf(frame), "- skipping trace!"
+            )
+            return None
+        self.currentframe = (
+            frame  # So the stack sniffer knows our most recent, debuggable code.
+        )
+        return bdb.Bdb.dispatch_line(self, frame)
+
+    def dispatch_call(self, frame, arg):
+        traceenter("dispatch_call", _dumpf(frame))
+        frame.f_locals["__axstack_address__"] = axdebug.GetStackAddress()
+        if frame is self.botframe:
+            trace("dispatch_call is self.botframe - returning tracer")
+            return self.trace_dispatch
+        # Not our bottom frame.  If we have a document for it,
+        # then trace it, otherwise run at full speed.
+        if self.codeContainerProvider.FromFileName(frame.f_code.co_filename) is None:
+            trace(
+                "dispatch_call has no document for", _dumpf(frame), "- skipping trace!"
+            )
+            ##                      sys.settrace(None)
+            return None
+        return self.trace_dispatch
+
+    #               rc =  bdb.Bdb.dispatch_call(self, frame, arg)
+    #               trace("dispatch_call", _dumpf(frame),"returned",rc)
+    #               return rc
+
+    def trace_dispatch(self, frame, event, arg):
+        traceenter("trace_dispatch", _dumpf(frame), event, arg)
+        if self.debugApplication is None:
+            trace("trace_dispatch has no application!")
+            return  # None
+        return bdb.Bdb.trace_dispatch(self, frame, event, arg)
+
+    #
+    # The user functions do bugger all!
+    #
+    #       def user_call(self, frame, argument_list):
+    #               traceenter("user_call",_dumpf(frame))
+
+    def user_line(self, frame):
+        traceenter("user_line", _dumpf(frame))
+        # Traces at line zero
+        if frame.f_lineno != 0:
+            breakReason = self.breakReason
+            if breakReason is None:
+                breakReason = axdebug.BREAKREASON_STEP
+            self._HandleBreakPoint(frame, None, breakReason)
+
+    def user_return(self, frame, return_value):
+        #               traceenter("user_return",_dumpf(frame),return_value)
+        bdb.Bdb.user_return(self, frame, return_value)
+
+    def user_exception(self, frame, exc_info):
+        #               traceenter("user_exception")
+        bdb.Bdb.user_exception(self, frame, exc_info)
+
+    def _HandleBreakPoint(self, frame, tb, reason):
+        traceenter(
+            "Calling HandleBreakPoint with reason", reason, "at frame", _dumpf(frame)
+        )
+        traceenter(" Current frame is", _dumpf(self.currentframe))
+        try:
+            resumeAction = self.debugApplication.HandleBreakPoint(reason)
+            tracev("HandleBreakPoint returned with ", resumeAction)
+        except pythoncom.com_error as details:
+            # Eeek - the debugger is dead, or something serious is happening.
+            # Assume we should continue
+            resumeAction = axdebug.BREAKRESUMEACTION_CONTINUE
+            trace("HandleBreakPoint FAILED with", details)
+
+        self.stack = []
+        self.curindex = 0
+        if resumeAction == axdebug.BREAKRESUMEACTION_ABORT:
+            self.set_quit()
+        elif resumeAction == axdebug.BREAKRESUMEACTION_CONTINUE:
+            tracev("resume action is continue")
+            self.set_continue()
+        elif resumeAction == axdebug.BREAKRESUMEACTION_STEP_INTO:
+            tracev("resume action is step")
+            self.set_step()
+        elif resumeAction == axdebug.BREAKRESUMEACTION_STEP_OVER:
+            tracev("resume action is next")
+            self.set_next(frame)
+        elif resumeAction == axdebug.BREAKRESUMEACTION_STEP_OUT:
+            tracev("resume action is stop out")
+            self.set_return(frame)
+        else:
+            raise ValueError("unknown resume action flags")
+        self.breakReason = None
+
+    def set_trace(self):
+        self.breakReason = axdebug.BREAKREASON_LANGUAGE_INITIATED
+        bdb.Bdb.set_trace(self)
+
+    def CloseApp(self):
+        traceenter("ClosingApp")
+        self.reset()
+        self.logicalbotframe = None
+        if self.stackSnifferCookie is not None:
+            try:
+                self.debugApplication.RemoveStackFrameSniffer(self.stackSnifferCookie)
+
+            except pythoncom.com_error:
+                trace(
+                    "*** Could not RemoveStackFrameSniffer %d"
+                    % (self.stackSnifferCookie)
+                )
+        if self.stackSniffer:
+            _wrap_remove(self.stackSniffer)
+        self.stackSnifferCookie = self.stackSniffer = None
+
+        if self.appEventConnection is not None:
+            self.appEventConnection.Disconnect()
+            self.appEventConnection = None
+        self.debugApplication = None
+        self.appDebugger = None
+        if self.codeContainerProvider is not None:
+            self.codeContainerProvider.Close()
+            self.codeContainerProvider = None
+
+    def AttachApp(self, debugApplication, codeContainerProvider):
+        #               traceenter("AttachApp", debugApplication, codeContainerProvider)
+        self.codeContainerProvider = codeContainerProvider
+        self.debugApplication = debugApplication
+        self.stackSniffer = _wrap(
+            stackframe.DebugStackFrameSniffer(self), axdebug.IID_IDebugStackFrameSniffer
+        )
+        self.stackSnifferCookie = debugApplication.AddStackFrameSniffer(
+            self.stackSniffer
+        )
+        #               trace("StackFrameSniffer added (%d)" % self.stackSnifferCookie)
+
+        # Connect to the application events.
+        self.appEventConnection = win32com.client.connect.SimpleConnection(
+            self.debugApplication, self, axdebug.IID_IRemoteDebugApplicationEvents
+        )
+
+    def ResetAXDebugging(self):
+        traceenter("ResetAXDebugging", self, "with refcount", len(self.recursiveData))
+        if win32api.GetCurrentThreadId() != self.debuggingThread:
+            trace("ResetAXDebugging called on other thread")
+            return
+
+        if len(self.recursiveData) == 0:
+            #                       print "ResetAXDebugging called for final time."
+            self.logicalbotframe = None
+            self.debuggingThread = None
+            self.currentframe = None
+            self.debuggingThreadStateHandle = None
+            return
+
+        (
+            self.logbotframe,
+            self.stopframe,
+            self.currentframe,
+            self.debuggingThreadStateHandle,
+        ) = self.recursiveData[0]
+        self.recursiveData = self.recursiveData[1:]
+
+    def SetupAXDebugging(self, baseFrame=None, userFrame=None):
+        """Get ready for potential debugging.  Must be called on the thread
+        that is being debugged.
+        """
+        # userFrame is for non AXScript debugging.  This is the first frame of the
+        # users code.
+        if userFrame is None:
+            userFrame = baseFrame
+        else:
+            # We have missed the "dispatch_call" function, so set this up now!
+            userFrame.f_locals["__axstack_address__"] = axdebug.GetStackAddress()
+
+        traceenter("SetupAXDebugging", self)
+        self._threadprotectlock.acquire()
+        try:
+            thisThread = win32api.GetCurrentThreadId()
+            if self.debuggingThread is None:
+                self.debuggingThread = thisThread
+            else:
+                if self.debuggingThread != thisThread:
+                    trace("SetupAXDebugging called on other thread - ignored!")
+                    return
+                # push our context.
+                self.recursiveData.insert(
+                    0,
+                    (
+                        self.logicalbotframe,
+                        self.stopframe,
+                        self.currentframe,
+                        self.debuggingThreadStateHandle,
+                    ),
+                )
+        finally:
+            self._threadprotectlock.release()
+
+        trace("SetupAXDebugging has base frame as", _dumpf(baseFrame))
+        self.botframe = baseFrame
+        self.stopframe = userFrame
+        self.logicalbotframe = baseFrame
+        self.currentframe = None
+        self.debuggingThreadStateHandle = axdebug.GetThreadStateHandle()
+
+        self._BreakFlagsChanged()
+
+    # RemoteDebugApplicationEvents
+    def OnConnectDebugger(self, appDebugger):
+        traceenter("OnConnectDebugger", appDebugger)
+        self.appDebugger = appDebugger
+        # Reflect output to appDebugger
+        writefunc = lambda s: appDebugger.onDebugOutput(s)
+        sys.stdout = OutputReflector(sys.stdout, writefunc)
+        sys.stderr = OutputReflector(sys.stderr, writefunc)
+
+    def OnDisconnectDebugger(self):
+        traceenter("OnDisconnectDebugger")
+        # Stop reflecting output
+        if isinstance(sys.stdout, OutputReflector):
+            sys.stdout = sys.stdout.file
+        if isinstance(sys.stderr, OutputReflector):
+            sys.stderr = sys.stderr.file
+        self.appDebugger = None
+        self.set_quit()
+
+    def OnSetName(self, name):
+        traceenter("OnSetName", name)
+
+    def OnDebugOutput(self, string):
+        traceenter("OnDebugOutput", string)
+
+    def OnClose(self):
+        traceenter("OnClose")
+
+    def OnEnterBreakPoint(self, rdat):
+        traceenter("OnEnterBreakPoint", rdat)
+
+    def OnLeaveBreakPoint(self, rdat):
+        traceenter("OnLeaveBreakPoint", rdat)
+
+    def OnCreateThread(self, rdat):
+        traceenter("OnCreateThread", rdat)
+
+    def OnDestroyThread(self, rdat):
+        traceenter("OnDestroyThread", rdat)
+
+    def OnBreakFlagChange(self, abf, rdat):
+        traceenter("Debugger OnBreakFlagChange", abf, rdat)
+        self.breakFlags = abf
+        self._BreakFlagsChanged()
+
+    def _BreakFlagsChanged(self):
+        traceenter(
+            "_BreakFlagsChanged to %s with our thread = %s, and debugging thread = %s"
+            % (self.breakFlags, self.debuggingThread, win32api.GetCurrentThreadId())
+        )
+        trace("_BreakFlagsChanged has breaks", self.breaks)
+        # If a request comes on our debugging thread, then do it now!
+        #               if self.debuggingThread!=win32api.GetCurrentThreadId():
+        #                       return
+
+        if len(self.breaks) or self.breakFlags:
+            if self.logicalbotframe:
+                trace("BreakFlagsChange with bot frame", _dumpf(self.logicalbotframe))
+                # We have frames not to be debugged (eg, Scripting engine frames
+                # (sys.settrace will be set when out logicalbotframe is hit -
+                #  this may not be the right thing to do, as it may not cause the
+                #  immediate break we desire.)
+                self.logicalbotframe.f_trace = self.trace_dispatch
+            else:
+                trace("BreakFlagsChanged, but no bottom frame")
+                if self.stopframe is not None:
+                    self.stopframe.f_trace = self.trace_dispatch
+            # If we have the thread-state for the thread being debugged, then
+            # we dynamically set its trace function - it is possible that the thread
+            # being debugged is in a blocked call (eg, a message box) and we
+            # want to hit the debugger the instant we return
+        if (
+            self.debuggingThreadStateHandle is not None
+            and self.breakFlags
+            and self.debuggingThread != win32api.GetCurrentThreadId()
+        ):
+            axdebug.SetThreadStateTrace(
+                self.debuggingThreadStateHandle, self.trace_dispatch
+            )
+
+    def _OnSetBreakPoint(self, key, codeContext, bps, lineNo):
+        traceenter("_OnSetBreakPoint", self, key, codeContext, bps, lineNo)
+        if bps == axdebug.BREAKPOINT_ENABLED:
+            problem = self.set_break(key, lineNo)
+            if problem:
+                print("*** set_break failed -", problem)
+            trace("_OnSetBreakPoint just set BP and has breaks", self.breaks)
+        else:
+            self.clear_break(key, lineNo)
+        self._BreakFlagsChanged()
+        trace("_OnSetBreakPoint leaving with breaks", self.breaks)
+
+
+def Debugger():
+    global g_adb
+    if g_adb is None:
+        g_adb = Adb()
+    return g_adb
diff --git a/lib/win32comext/axdebug/axdebug.pyd b/lib/win32comext/axdebug/axdebug.pyd
new file mode 100644
index 0000000000000000000000000000000000000000..9a8481903aa303776feca6d1925f57320ae0e80d
GIT binary patch
literal 285184
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
J%YTP|{~Ju!s!9L=

literal 0
HcmV?d00001

diff --git a/lib/win32comext/axdebug/codecontainer.py b/lib/win32comext/axdebug/codecontainer.py
new file mode 100644
index 00000000..a7a2e245
--- /dev/null
+++ b/lib/win32comext/axdebug/codecontainer.py
@@ -0,0 +1,278 @@
+"""A utility class for a code container.
+
+A code container is a class which holds source code for a debugger.  It knows how
+to color the text, and also how to translate lines into offsets, and back.
+"""
+
+import sys
+import tokenize
+
+import win32api
+import winerror
+from win32com.axdebug import axdebug
+from win32com.server.exception import Exception
+
+from . import contexts
+from .util import RaiseNotImpl, _wrap
+
+_keywords = {}  # set of Python keywords
+for name in """
+ and assert break class continue def del elif else except exec
+ finally for from global if import in is lambda not
+ or pass print raise return try while
+ """.split():
+    _keywords[name] = 1
+
+
+class SourceCodeContainer:
+    def __init__(
+        self,
+        text,
+        fileName="<Remove Me!>",
+        sourceContext=0,
+        startLineNumber=0,
+        site=None,
+        debugDocument=None,
+    ):
+        self.sourceContext = sourceContext  # The source context added by a smart host.
+        self.text = text
+        if text:
+            self._buildlines()
+        self.nextLineNo = 0
+        self.fileName = fileName
+        self.codeContexts = {}
+        self.site = site
+        self.startLineNumber = startLineNumber
+        self.debugDocument = None
+
+    def _Close(self):
+        self.text = self.lines = self.lineOffsets = None
+        self.codeContexts = None
+        self.debugDocument = None
+        self.site = None
+        self.sourceContext = None
+
+    def GetText(self):
+        return self.text
+
+    def GetName(self, dnt):
+        assert 0, "You must subclass this"
+
+    def GetFileName(self):
+        return self.fileName
+
+    def GetPositionOfLine(self, cLineNumber):
+        self.GetText()  # Prime us.
+        try:
+            return self.lineOffsets[cLineNumber]
+        except IndexError:
+            raise Exception(scode=winerror.S_FALSE)
+
+    def GetLineOfPosition(self, charPos):
+        self.GetText()  # Prime us.
+        lastOffset = 0
+        lineNo = 0
+        for lineOffset in self.lineOffsets[1:]:
+            if lineOffset > charPos:
+                break
+            lastOffset = lineOffset
+            lineNo = lineNo + 1
+        else:  # for not broken.
+            #                       print "Cant find", charPos, "in", self.lineOffsets
+            raise Exception(scode=winerror.S_FALSE)
+        #               print "GLOP ret=",lineNo,       (charPos-lastOffset)
+        return lineNo, (charPos - lastOffset)
+
+    def GetNextLine(self):
+        if self.nextLineNo >= len(self.lines):
+            self.nextLineNo = 0  # auto-reset.
+            return ""
+        rc = self.lines[self.nextLineNo]
+        self.nextLineNo = self.nextLineNo + 1
+        return rc
+
+    def GetLine(self, num):
+        self.GetText()  # Prime us.
+        return self.lines[num]
+
+    def GetNumChars(self):
+        return len(self.GetText())
+
+    def GetNumLines(self):
+        self.GetText()  # Prime us.
+        return len(self.lines)
+
+    def _buildline(self, pos):
+        i = self.text.find("\n", pos)
+        if i < 0:
+            newpos = len(self.text)
+        else:
+            newpos = i + 1
+        r = self.text[pos:newpos]
+        return r, newpos
+
+    def _buildlines(self):
+        self.lines = []
+        self.lineOffsets = [0]
+        line, pos = self._buildline(0)
+        while line:
+            self.lines.append(line)
+            self.lineOffsets.append(pos)
+            line, pos = self._buildline(pos)
+
+    def _ProcessToken(self, type, token, spos, epos, line):
+        srow, scol = spos
+        erow, ecol = epos
+        self.GetText()  # Prime us.
+        linenum = srow - 1  # Lines zero based for us too.
+        realCharPos = self.lineOffsets[linenum] + scol
+        numskipped = realCharPos - self.lastPos
+        if numskipped == 0:
+            pass
+        elif numskipped == 1:
+            self.attrs.append(axdebug.SOURCETEXT_ATTR_COMMENT)
+        else:
+            self.attrs.append((axdebug.SOURCETEXT_ATTR_COMMENT, numskipped))
+        kwSize = len(token)
+        self.lastPos = realCharPos + kwSize
+        attr = 0
+
+        if type == tokenize.NAME:
+            if token in _keywords:
+                attr = axdebug.SOURCETEXT_ATTR_KEYWORD
+        elif type == tokenize.STRING:
+            attr = axdebug.SOURCETEXT_ATTR_STRING
+        elif type == tokenize.NUMBER:
+            attr = axdebug.SOURCETEXT_ATTR_NUMBER
+        elif type == tokenize.OP:
+            attr = axdebug.SOURCETEXT_ATTR_OPERATOR
+        elif type == tokenize.COMMENT:
+            attr = axdebug.SOURCETEXT_ATTR_COMMENT
+        # else attr remains zero...
+        if kwSize == 0:
+            pass
+        elif kwSize == 1:
+            self.attrs.append(attr)
+        else:
+            self.attrs.append((attr, kwSize))
+
+    def GetSyntaxColorAttributes(self):
+        self.lastPos = 0
+        self.attrs = []
+        try:
+            tokenize.tokenize(self.GetNextLine, self._ProcessToken)
+        except tokenize.TokenError:
+            pass  # Ignore - will cause all subsequent text to be commented.
+        numAtEnd = len(self.GetText()) - self.lastPos
+        if numAtEnd:
+            self.attrs.append((axdebug.SOURCETEXT_ATTR_COMMENT, numAtEnd))
+        return self.attrs
+
+    # We also provide and manage DebugDocumentContext objects
+    def _MakeDebugCodeContext(self, lineNo, charPos, len):
+        return _wrap(
+            contexts.DebugCodeContext(lineNo, charPos, len, self, self.site),
+            axdebug.IID_IDebugCodeContext,
+        )
+
+    # Make a context at the given position.  It should take up the entire context.
+    def _MakeContextAtPosition(self, charPos):
+        lineNo, offset = self.GetLineOfPosition(charPos)
+        try:
+            endPos = self.GetPositionOfLine(lineNo + 1)
+        except:
+            endPos = charPos
+        codecontext = self._MakeDebugCodeContext(lineNo, charPos, endPos - charPos)
+        return codecontext
+
+    # Returns a DebugCodeContext.  debugDocument can be None for smart hosts.
+    def GetCodeContextAtPosition(self, charPos):
+        #               trace("GetContextOfPos", charPos, maxChars)
+        # Convert to line number.
+        lineNo, offset = self.GetLineOfPosition(charPos)
+        charPos = self.GetPositionOfLine(lineNo)
+        try:
+            cc = self.codeContexts[charPos]
+        #                       trace(" GetContextOfPos using existing")
+        except KeyError:
+            cc = self._MakeContextAtPosition(charPos)
+            self.codeContexts[charPos] = cc
+        return cc
+
+
+class SourceModuleContainer(SourceCodeContainer):
+    def __init__(self, module):
+        self.module = module
+        if hasattr(module, "__file__"):
+            fname = self.module.__file__
+            # Check for .pyc or .pyo or even .pys!
+            if fname[-1] in ["O", "o", "C", "c", "S", "s"]:
+                fname = fname[:-1]
+            try:
+                fname = win32api.GetFullPathName(fname)
+            except win32api.error:
+                pass
+        else:
+            if module.__name__ == "__main__" and len(sys.argv) > 0:
+                fname = sys.argv[0]
+            else:
+                fname = "<Unknown!>"
+        SourceCodeContainer.__init__(self, None, fname)
+
+    def GetText(self):
+        if self.text is None:
+            fname = self.GetFileName()
+            if fname:
+                try:
+                    self.text = open(fname, "r").read()
+                except IOError as details:
+                    self.text = "# Exception opening file\n# %s" % (repr(details))
+            else:
+                self.text = "# No file available for module '%s'" % (self.module)
+            self._buildlines()
+        return self.text
+
+    def GetName(self, dnt):
+        name = self.module.__name__
+        try:
+            fname = win32api.GetFullPathName(self.module.__file__)
+        except win32api.error:
+            fname = self.module.__file__
+        except AttributeError:
+            fname = name
+        if dnt == axdebug.DOCUMENTNAMETYPE_APPNODE:
+            return name.split(".")[-1]
+        elif dnt == axdebug.DOCUMENTNAMETYPE_TITLE:
+            return fname
+        elif dnt == axdebug.DOCUMENTNAMETYPE_FILE_TAIL:
+            return os.path.split(fname)[1]
+        elif dnt == axdebug.DOCUMENTNAMETYPE_URL:
+            return "file:%s" % fname
+        else:
+            raise Exception(scode=winerror.E_UNEXPECTED)
+
+
+if __name__ == "__main__":
+    import sys
+
+    sys.path.append(".")
+    import ttest
+
+    sc = SourceModuleContainer(ttest)
+    #       sc = SourceCodeContainer(open(sys.argv[1], "rb").read(), sys.argv[1])
+    attrs = sc.GetSyntaxColorAttributes()
+    attrlen = 0
+    for attr in attrs:
+        if type(attr) == type(()):
+            attrlen = attrlen + attr[1]
+        else:
+            attrlen = attrlen + 1
+    text = sc.GetText()
+    if attrlen != len(text):
+        print("Lengths dont match!!! (%d/%d)" % (attrlen, len(text)))
+
+    #       print "Attributes:"
+    #       print attrs
+    print("GetLineOfPos=", sc.GetLineOfPosition(0))
+    print("GetLineOfPos=", sc.GetLineOfPosition(4))
+    print("GetLineOfPos=", sc.GetLineOfPosition(10))
diff --git a/lib/win32comext/axdebug/contexts.py b/lib/win32comext/axdebug/contexts.py
new file mode 100644
index 00000000..85816639
--- /dev/null
+++ b/lib/win32comext/axdebug/contexts.py
@@ -0,0 +1,62 @@
+""" A module for managing the AXDebug I*Contexts
+
+"""
+import pythoncom
+import win32com.server.util
+
+from . import adb, axdebug, gateways
+
+# Utility function for wrapping object created by this module.
+from .util import _wrap, _wrap_remove, trace
+
+
+class DebugCodeContext(gateways.DebugCodeContext, gateways.DebugDocumentContext):
+    # NOTE: We also implement the IDebugDocumentContext interface for Simple Hosts.
+    # Thus, debugDocument may be NULL when we have smart hosts - but in that case, we
+    # wont be called upon to provide it.
+    _public_methods_ = (
+        gateways.DebugCodeContext._public_methods_
+        + gateways.DebugDocumentContext._public_methods_
+    )
+    _com_interfaces_ = (
+        gateways.DebugCodeContext._com_interfaces_
+        + gateways.DebugDocumentContext._com_interfaces_
+    )
+
+    def __init__(self, lineNo, charPos, len, codeContainer, debugSite):
+        self.debugSite = debugSite
+        self.offset = charPos
+        self.length = len
+        self.breakPointState = 0
+        self.lineno = lineNo
+        gateways.DebugCodeContext.__init__(self)
+        self.codeContainer = codeContainer
+
+    def _Close(self):
+        self.debugSite = None
+
+    def GetDocumentContext(self):
+        if self.debugSite is not None:
+            # We have a smart host - let him give it to us.
+            return self.debugSite.GetDocumentContextFromPosition(
+                self.codeContainer.sourceContext, self.offset, self.length
+            )
+        else:
+            # Simple host - Fine - Ill do it myself!
+            return _wrap(self, axdebug.IID_IDebugDocumentContext)
+
+    def SetBreakPoint(self, bps):
+        self.breakPointState = bps
+        adb.OnSetBreakPoint(self, bps, self.lineno)
+
+    # The DebugDocumentContext methods for simple hosts.
+    def GetDocument(self):
+        return self.codeContainer.debugDocument
+
+    def EnumCodeContexts(self):
+        return _wrap(EnumDebugCodeContexts([self]), axdebug.IID_IEnumDebugCodeContexts)
+
+
+class EnumDebugCodeContexts(gateways.EnumDebugCodeContexts):
+    def _wrap(self, obj):
+        return _wrap(obj, axdebug.IID_IDebugCodeContext)
diff --git a/lib/win32comext/axdebug/debugger.py b/lib/win32comext/axdebug/debugger.py
new file mode 100644
index 00000000..3157586b
--- /dev/null
+++ b/lib/win32comext/axdebug/debugger.py
@@ -0,0 +1,250 @@
+import os
+import string
+import sys
+
+import pythoncom
+import win32api
+from win32com.axdebug import (
+    adb,
+    axdebug,
+    codecontainer,
+    contexts,
+    documents,
+    expressions,
+    gateways,
+)
+from win32com.axdebug.util import _wrap, _wrap_remove, trace
+from win32com.axscript import axscript
+
+currentDebugger = None
+
+
+class ModuleTreeNode:
+    """Helper class for building a module tree"""
+
+    def __init__(self, module):
+        modName = module.__name__
+        self.moduleName = modName
+        self.module = module
+        self.realNode = None
+        self.cont = codecontainer.SourceModuleContainer(module)
+
+    def __repr__(self):
+        return "<ModuleTreeNode wrapping %s>" % (self.module)
+
+    def Attach(self, parentRealNode):
+        self.realNode.Attach(parentRealNode)
+
+    def Close(self):
+        self.module = None
+        self.cont = None
+        self.realNode = None
+
+
+def BuildModule(module, built_nodes, rootNode, create_node_fn, create_node_args):
+    if module:
+        keep = module.__name__
+        keep = keep and (built_nodes.get(module) is None)
+        if keep and hasattr(module, "__file__"):
+            keep = string.lower(os.path.splitext(module.__file__)[1]) not in [
+                ".pyd",
+                ".dll",
+            ]
+    #               keep = keep and module.__name__=='__main__'
+    if module and keep:
+        #        print "keeping", module.__name__
+        node = ModuleTreeNode(module)
+        built_nodes[module] = node
+        realNode = create_node_fn(*(node,) + create_node_args)
+        node.realNode = realNode
+
+        # Split into parent nodes.
+        parts = string.split(module.__name__, ".")
+        if parts[-1][:8] == "__init__":
+            parts = parts[:-1]
+        parent = string.join(parts[:-1], ".")
+        parentNode = rootNode
+        if parent:
+            parentModule = sys.modules[parent]
+            BuildModule(
+                parentModule, built_nodes, rootNode, create_node_fn, create_node_args
+            )
+            if parentModule in built_nodes:
+                parentNode = built_nodes[parentModule].realNode
+        node.Attach(parentNode)
+
+
+def RefreshAllModules(builtItems, rootNode, create_node, create_node_args):
+    for module in list(sys.modules.values()):
+        BuildModule(module, builtItems, rootNode, create_node, create_node_args)
+
+
+# realNode = pdm.CreateDebugDocumentHelper(None) # DebugDocumentHelper node?
+# app.CreateApplicationNode() # doc provider node.
+
+
+class CodeContainerProvider(documents.CodeContainerProvider):
+    def __init__(self, axdebugger):
+        self.axdebugger = axdebugger
+        documents.CodeContainerProvider.__init__(self)
+        self.currentNumModules = len(sys.modules)
+        self.nodes = {}
+        self.axdebugger.RefreshAllModules(self.nodes, self)
+
+    def FromFileName(self, fname):
+        ### It appears we cant add modules during a debug session!
+        #               if self.currentNumModules != len(sys.modules):
+        #                       self.axdebugger.RefreshAllModules(self.nodes, self)
+        #                       self.currentNumModules = len(sys.modules)
+        #               for key in self.ccsAndNodes.keys():
+        #                       print "File:", key
+        return documents.CodeContainerProvider.FromFileName(self, fname)
+
+    def Close(self):
+        documents.CodeContainerProvider.Close(self)
+        self.axdebugger = None
+        print("Closing %d nodes" % (len(self.nodes)))
+        for node in self.nodes.values():
+            node.Close()
+        self.nodes = {}
+
+
+class OriginalInterfaceMaker:
+    def MakeInterfaces(self, pdm):
+        app = self.pdm.CreateApplication()
+        self.cookie = pdm.AddApplication(app)
+        root = app.GetRootNode()
+        return app, root
+
+    def CloseInterfaces(self, pdm):
+        pdm.RemoveApplication(self.cookie)
+
+
+class SimpleHostStyleInterfaceMaker:
+    def MakeInterfaces(self, pdm):
+        app = pdm.GetDefaultApplication()
+        root = app.GetRootNode()
+        return app, root
+
+    def CloseInterfaces(self, pdm):
+        pass
+
+
+class AXDebugger:
+    def __init__(self, interfaceMaker=None, processName=None):
+        if processName is None:
+            processName = "Python Process"
+        if interfaceMaker is None:
+            interfaceMaker = SimpleHostStyleInterfaceMaker()
+
+        self.pydebugger = adb.Debugger()
+
+        self.pdm = pythoncom.CoCreateInstance(
+            axdebug.CLSID_ProcessDebugManager,
+            None,
+            pythoncom.CLSCTX_ALL,
+            axdebug.IID_IProcessDebugManager,
+        )
+
+        self.app, self.root = interfaceMaker.MakeInterfaces(self.pdm)
+        self.app.SetName(processName)
+        self.interfaceMaker = interfaceMaker
+
+        expressionProvider = _wrap(
+            expressions.ProvideExpressionContexts(),
+            axdebug.IID_IProvideExpressionContexts,
+        )
+        self.expressionCookie = self.app.AddGlobalExpressionContextProvider(
+            expressionProvider
+        )
+
+        contProvider = CodeContainerProvider(self)
+        self.pydebugger.AttachApp(self.app, contProvider)
+
+    def Break(self):
+        # Get the frame we start debugging from - this is the frame 1 level up
+        try:
+            1 + ""
+        except:
+            frame = sys.exc_info()[2].tb_frame.f_back
+
+        # Get/create the debugger, and tell it to break.
+        self.app.StartDebugSession()
+        #               self.app.CauseBreak()
+
+        self.pydebugger.SetupAXDebugging(None, frame)
+        self.pydebugger.set_trace()
+
+    def Close(self):
+        self.pydebugger.ResetAXDebugging()
+        self.interfaceMaker.CloseInterfaces(self.pdm)
+        self.pydebugger.CloseApp()
+        self.app.RemoveGlobalExpressionContextProvider(self.expressionCookie)
+        self.expressionCookie = None
+
+        self.pdm = None
+        self.app = None
+        self.pydebugger = None
+        self.root = None
+
+    def RefreshAllModules(self, nodes, containerProvider):
+        RefreshAllModules(
+            nodes, self.root, self.CreateApplicationNode, (containerProvider,)
+        )
+
+    def CreateApplicationNode(self, node, containerProvider):
+        realNode = self.app.CreateApplicationNode()
+
+        document = documents.DebugDocumentText(node.cont)
+        document = _wrap(document, axdebug.IID_IDebugDocument)
+
+        node.cont.debugDocument = document
+
+        provider = documents.DebugDocumentProvider(document)
+        provider = _wrap(provider, axdebug.IID_IDebugDocumentProvider)
+        realNode.SetDocumentProvider(provider)
+
+        containerProvider.AddCodeContainer(node.cont, realNode)
+        return realNode
+
+
+def _GetCurrentDebugger():
+    global currentDebugger
+    if currentDebugger is None:
+        currentDebugger = AXDebugger()
+    return currentDebugger
+
+
+def Break():
+    _GetCurrentDebugger().Break()
+
+
+brk = Break
+set_trace = Break
+
+
+def dosomethingelse():
+    a = 2
+    b = "Hi there"
+
+
+def dosomething():
+    a = 1
+    b = 2
+    dosomethingelse()
+
+
+def test():
+    Break()
+    input("Waiting...")
+    dosomething()
+    print("Done")
+
+
+if __name__ == "__main__":
+    print("About to test the debugging interfaces!")
+    test()
+    print(
+        " %d/%d com objects still alive"
+        % (pythoncom._GetInterfaceCount(), pythoncom._GetGatewayCount())
+    )
diff --git a/lib/win32comext/axdebug/documents.py b/lib/win32comext/axdebug/documents.py
new file mode 100644
index 00000000..d039cf40
--- /dev/null
+++ b/lib/win32comext/axdebug/documents.py
@@ -0,0 +1,140 @@
+""" Management of documents for AXDebugging.
+"""
+
+
+import pythoncom
+import win32api
+from win32com.server.exception import Exception
+from win32com.server.util import unwrap
+
+from . import axdebug, codecontainer, contexts, gateways
+from .util import RaiseNotImpl, _wrap, _wrap_remove, trace
+
+# def trace(*args):
+#       pass
+
+
+def GetGoodFileName(fname):
+    if fname[0] != "<":
+        return win32api.GetFullPathName(fname)
+    return fname
+
+
+class DebugDocumentProvider(gateways.DebugDocumentProvider):
+    def __init__(self, doc):
+        self.doc = doc
+
+    def GetName(self, dnt):
+        return self.doc.GetName(dnt)
+
+    def GetDocumentClassId(self):
+        return self.doc.GetDocumentClassId()
+
+    def GetDocument(self):
+        return self.doc
+
+
+class DebugDocumentText(
+    gateways.DebugDocumentInfo, gateways.DebugDocumentText, gateways.DebugDocument
+):
+    _com_interfaces_ = (
+        gateways.DebugDocumentInfo._com_interfaces_
+        + gateways.DebugDocumentText._com_interfaces_
+        + gateways.DebugDocument._com_interfaces_
+    )
+    _public_methods_ = (
+        gateways.DebugDocumentInfo._public_methods_
+        + gateways.DebugDocumentText._public_methods_
+        + gateways.DebugDocument._public_methods_
+    )
+
+    # A class which implements a DebugDocumentText, using the functionality
+    # provided by a codeContainer
+    def __init__(self, codeContainer):
+        gateways.DebugDocumentText.__init__(self)
+        gateways.DebugDocumentInfo.__init__(self)
+        gateways.DebugDocument.__init__(self)
+        self.codeContainer = codeContainer
+
+    def _Close(self):
+        self.docContexts = None
+        #               self.codeContainer._Close()
+        self.codeContainer = None
+
+    # IDebugDocumentInfo
+    def GetName(self, dnt):
+        return self.codeContainer.GetName(dnt)
+
+    def GetDocumentClassId(self):
+        return "{DF630910-1C1D-11d0-AE36-8C0F5E000000}"
+
+    # IDebugDocument has no methods!
+    #
+
+    # IDebugDocumentText methods.
+    # def GetDocumentAttributes
+    def GetSize(self):
+        #               trace("GetSize")
+        return self.codeContainer.GetNumLines(), self.codeContainer.GetNumChars()
+
+    def GetPositionOfLine(self, cLineNumber):
+        return self.codeContainer.GetPositionOfLine(cLineNumber)
+
+    def GetLineOfPosition(self, charPos):
+        return self.codeContainer.GetLineOfPosition(charPos)
+
+    def GetText(self, charPos, maxChars, wantAttr):
+        # Get all the attributes, else the tokenizer will get upset.
+        # XXX - not yet!
+        #               trace("GetText", charPos, maxChars, wantAttr)
+        cont = self.codeContainer
+        attr = cont.GetSyntaxColorAttributes()
+        return cont.GetText(), attr
+
+    def GetPositionOfContext(self, context):
+        trace("GetPositionOfContext", context)
+        context = unwrap(context)
+        return context.offset, context.length
+
+    # Return a DebugDocumentContext.
+    def GetContextOfPosition(self, charPos, maxChars):
+        # Make one
+        doc = _wrap(self, axdebug.IID_IDebugDocument)
+        rc = self.codeContainer.GetCodeContextAtPosition(charPos)
+        return rc.QueryInterface(axdebug.IID_IDebugDocumentContext)
+
+
+class CodeContainerProvider:
+    """An abstract Python class which provides code containers!
+
+    Given a Python file name (as the debugger knows it by) this will
+    return a CodeContainer interface suitable for use.
+
+    This provides a simple base imlpementation that simply supports
+    a dictionary of nodes and providers.
+    """
+
+    def __init__(self):
+        self.ccsAndNodes = {}
+
+    def AddCodeContainer(self, cc, node=None):
+        fname = GetGoodFileName(cc.fileName)
+        self.ccsAndNodes[fname] = cc, node
+
+    def FromFileName(self, fname):
+        cc, node = self.ccsAndNodes.get(GetGoodFileName(fname), (None, None))
+        #               if cc is None:
+        #                       print "FromFileName for %s returning None" % fname
+        return cc
+
+    def Close(self):
+        for cc, node in self.ccsAndNodes.values():
+            try:
+                # Must close the node before closing the provider
+                # as node may make calls on provider (eg Reset breakpoints etc)
+                if node is not None:
+                    node.Close()
+                cc._Close()
+            except pythoncom.com_error:
+                pass
+        self.ccsAndNodes = {}
diff --git a/lib/win32comext/axdebug/dump.py b/lib/win32comext/axdebug/dump.py
new file mode 100644
index 00000000..26ee51e0
--- /dev/null
+++ b/lib/win32comext/axdebug/dump.py
@@ -0,0 +1,61 @@
+import traceback
+
+import pythoncom
+from win32com.axdebug import axdebug
+from win32com.client.util import Enumerator
+
+
+def DumpDebugApplicationNode(node, level=0):
+    # Recursive dump of a DebugApplicationNode
+    spacer = " " * level
+    for desc, attr in [
+        ("Node Name", axdebug.DOCUMENTNAMETYPE_APPNODE),
+        ("Title", axdebug.DOCUMENTNAMETYPE_TITLE),
+        ("Filename", axdebug.DOCUMENTNAMETYPE_FILE_TAIL),
+        ("URL", axdebug.DOCUMENTNAMETYPE_URL),
+    ]:
+        try:
+            info = node.GetName(attr)
+        except pythoncom.com_error:
+            info = "<N/A>"
+        print("%s%s: %s" % (spacer, desc, info))
+    try:
+        doc = node.GetDocument()
+    except pythoncom.com_error:
+        doc = None
+    if doc:
+        doctext = doc.QueryInterface(axdebug.IID_IDebugDocumentText)
+        numLines, numChars = doctext.GetSize()
+        #                       text, attr = doctext.GetText(0, 20, 1)
+        text, attr = doctext.GetText(0, numChars, 1)
+        print(
+            "%sText is %s, %d bytes long" % (spacer, repr(text[:40] + "..."), len(text))
+        )
+    else:
+        print("%s%s" % (spacer, "<No document available>"))
+
+    for child in Enumerator(node.EnumChildren()):
+        DumpDebugApplicationNode(child, level + 1)
+
+
+def dumpall():
+    dm = pythoncom.CoCreateInstance(
+        axdebug.CLSID_MachineDebugManager,
+        None,
+        pythoncom.CLSCTX_ALL,
+        axdebug.IID_IMachineDebugManager,
+    )
+    e = Enumerator(dm.EnumApplications())
+    for app in e:
+        print("Application: %s" % app.GetName())
+        node = (
+            app.GetRootNode()
+        )  # of type PyIDebugApplicationNode->PyIDebugDocumentProvider->PyIDebugDocumentInfo
+        DumpDebugApplicationNode(node)
+
+
+if __name__ == "__main__":
+    try:
+        dumpall()
+    except:
+        traceback.print_exc()
diff --git a/lib/win32comext/axdebug/expressions.py b/lib/win32comext/axdebug/expressions.py
new file mode 100644
index 00000000..28c7b904
--- /dev/null
+++ b/lib/win32comext/axdebug/expressions.py
@@ -0,0 +1,214 @@
+import io
+import string
+import sys
+import traceback
+from pprint import pprint
+
+import winerror
+from win32com.server.exception import COMException
+
+from . import axdebug, gateways
+from .util import RaiseNotImpl, _wrap, _wrap_remove
+
+
+# Given an object, return a nice string
+def MakeNiceString(ob):
+    stream = io.StringIO()
+    pprint(ob, stream)
+    return string.strip(stream.getvalue())
+
+
+class ProvideExpressionContexts(gateways.ProvideExpressionContexts):
+    pass
+
+
+class ExpressionContext(gateways.DebugExpressionContext):
+    def __init__(self, frame):
+        self.frame = frame
+
+    def ParseLanguageText(self, code, radix, delim, flags):
+        return _wrap(
+            Expression(self.frame, code, radix, delim, flags),
+            axdebug.IID_IDebugExpression,
+        )
+
+    def GetLanguageInfo(self):
+        #               print "GetLanguageInfo"
+        return "Python", "{DF630910-1C1D-11d0-AE36-8C0F5E000000}"
+
+
+class Expression(gateways.DebugExpression):
+    def __init__(self, frame, code, radix, delim, flags):
+        self.callback = None
+        self.frame = frame
+        self.code = code
+        self.radix = radix
+        self.delim = delim
+        self.flags = flags
+        self.isComplete = 0
+        self.result = None
+        self.hresult = winerror.E_UNEXPECTED
+
+    def Start(self, callback):
+        try:
+            try:
+                try:
+                    self.result = eval(
+                        self.code, self.frame.f_globals, self.frame.f_locals
+                    )
+                except SyntaxError:
+                    exec(self.code, self.frame.f_globals, self.frame.f_locals)
+                    self.result = ""
+                self.hresult = 0
+            except:
+                l = traceback.format_exception_only(
+                    sys.exc_info()[0], sys.exc_info()[1]
+                )
+                # l is a list of strings with trailing "\n"
+                self.result = string.join(map(lambda s: s[:-1], l), "\n")
+                self.hresult = winerror.E_FAIL
+        finally:
+            self.isComplete = 1
+            callback.onComplete()
+
+    def Abort(self):
+        print("** ABORT **")
+
+    def QueryIsComplete(self):
+        return self.isComplete
+
+    def GetResultAsString(self):
+        #               print "GetStrAsResult returning", self.result
+        return self.hresult, MakeNiceString(self.result)
+
+    def GetResultAsDebugProperty(self):
+        result = _wrap(
+            DebugProperty(self.code, self.result, None, self.hresult),
+            axdebug.IID_IDebugProperty,
+        )
+        return self.hresult, result
+
+
+def MakeEnumDebugProperty(object, dwFieldSpec, nRadix, iid, stackFrame=None):
+    name_vals = []
+    if hasattr(object, "items") and hasattr(object, "keys"):  # If it is a dict.
+        name_vals = iter(object.items())
+        dictionary = object
+    elif hasattr(object, "__dict__"):  # object with dictionary, module
+        name_vals = iter(object.__dict__.items())
+        dictionary = object.__dict__
+    infos = []
+    for name, val in name_vals:
+        infos.append(
+            GetPropertyInfo(name, val, dwFieldSpec, nRadix, 0, dictionary, stackFrame)
+        )
+    return _wrap(EnumDebugPropertyInfo(infos), axdebug.IID_IEnumDebugPropertyInfo)
+
+
+def GetPropertyInfo(
+    obname, obvalue, dwFieldSpec, nRadix, hresult=0, dictionary=None, stackFrame=None
+):
+    # returns a tuple
+    name = typ = value = fullname = attrib = dbgprop = None
+    if dwFieldSpec & axdebug.DBGPROP_INFO_VALUE:
+        value = MakeNiceString(obvalue)
+    if dwFieldSpec & axdebug.DBGPROP_INFO_NAME:
+        name = obname
+    if dwFieldSpec & axdebug.DBGPROP_INFO_TYPE:
+        if hresult:
+            typ = "Error"
+        else:
+            try:
+                typ = type(obvalue).__name__
+            except AttributeError:
+                typ = str(type(obvalue))
+    if dwFieldSpec & axdebug.DBGPROP_INFO_FULLNAME:
+        fullname = obname
+    if dwFieldSpec & axdebug.DBGPROP_INFO_ATTRIBUTES:
+        if hasattr(obvalue, "has_key") or hasattr(
+            obvalue, "__dict__"
+        ):  # If it is a dict or object
+            attrib = axdebug.DBGPROP_ATTRIB_VALUE_IS_EXPANDABLE
+        else:
+            attrib = 0
+    if dwFieldSpec & axdebug.DBGPROP_INFO_DEBUGPROP:
+        dbgprop = _wrap(
+            DebugProperty(name, obvalue, None, hresult, dictionary, stackFrame),
+            axdebug.IID_IDebugProperty,
+        )
+    return name, typ, value, fullname, attrib, dbgprop
+
+
+from win32com.server.util import ListEnumeratorGateway
+
+
+class EnumDebugPropertyInfo(ListEnumeratorGateway):
+    """A class to expose a Python sequence as an EnumDebugCodeContexts
+
+    Create an instance of this class passing a sequence (list, tuple, or
+    any sequence protocol supporting object) and it will automatically
+    support the EnumDebugCodeContexts interface for the object.
+
+    """
+
+    _public_methods_ = ListEnumeratorGateway._public_methods_ + ["GetCount"]
+    _com_interfaces_ = [axdebug.IID_IEnumDebugPropertyInfo]
+
+    def GetCount(self):
+        return len(self._list_)
+
+    def _wrap(self, ob):
+        return ob
+
+
+class DebugProperty:
+    _com_interfaces_ = [axdebug.IID_IDebugProperty]
+    _public_methods_ = [
+        "GetPropertyInfo",
+        "GetExtendedInfo",
+        "SetValueAsString",
+        "EnumMembers",
+        "GetParent",
+    ]
+
+    def __init__(
+        self, name, value, parent=None, hresult=0, dictionary=None, stackFrame=None
+    ):
+        self.name = name
+        self.value = value
+        self.parent = parent
+        self.hresult = hresult
+        self.dictionary = dictionary
+        self.stackFrame = stackFrame
+
+    def GetPropertyInfo(self, dwFieldSpec, nRadix):
+        return GetPropertyInfo(
+            self.name,
+            self.value,
+            dwFieldSpec,
+            nRadix,
+            self.hresult,
+            dictionary,
+            stackFrame,
+        )
+
+    def GetExtendedInfo(self):  ### Note - not in the framework.
+        RaiseNotImpl("DebugProperty::GetExtendedInfo")
+
+    def SetValueAsString(self, value, radix):
+        if self.stackFrame and self.dictionary:
+            self.dictionary[self.name] = eval(
+                value, self.stackFrame.f_globals, self.stackFrame.f_locals
+            )
+        else:
+            RaiseNotImpl("DebugProperty::SetValueAsString")
+
+    def EnumMembers(self, dwFieldSpec, nRadix, iid):
+        # Returns IEnumDebugPropertyInfo
+        return MakeEnumDebugProperty(
+            self.value, dwFieldSpec, nRadix, iid, self.stackFrame
+        )
+
+    def GetParent(self):
+        # return IDebugProperty
+        RaiseNotImpl("DebugProperty::GetParent")
diff --git a/lib/win32comext/axdebug/gateways.py b/lib/win32comext/axdebug/gateways.py
new file mode 100644
index 00000000..d87e85b3
--- /dev/null
+++ b/lib/win32comext/axdebug/gateways.py
@@ -0,0 +1,583 @@
+# Classes which describe interfaces.
+
+import pythoncom
+import win32com.server.connect
+import winerror
+from win32com.axdebug import axdebug
+from win32com.axdebug.util import RaiseNotImpl, _wrap
+from win32com.server.exception import Exception
+from win32com.server.util import ListEnumeratorGateway
+
+
+class EnumDebugCodeContexts(ListEnumeratorGateway):
+    """A class to expose a Python sequence as an EnumDebugCodeContexts
+
+    Create an instance of this class passing a sequence (list, tuple, or
+    any sequence protocol supporting object) and it will automatically
+    support the EnumDebugCodeContexts interface for the object.
+
+    """
+
+    _com_interfaces_ = [axdebug.IID_IEnumDebugCodeContexts]
+
+
+class EnumDebugStackFrames(ListEnumeratorGateway):
+    """A class to expose a Python sequence as an EnumDebugStackFrames
+
+    Create an instance of this class passing a sequence (list, tuple, or
+    any sequence protocol supporting object) and it will automatically
+    support the EnumDebugStackFrames interface for the object.
+
+    """
+
+    _com_interfaces_ = [axdebug.IID_IEnumDebugStackFrames]
+
+
+class EnumDebugApplicationNodes(ListEnumeratorGateway):
+    """A class to expose a Python sequence as an EnumDebugStackFrames
+
+    Create an instance of this class passing a sequence (list, tuple, or
+    any sequence protocol supporting object) and it will automatically
+    support the EnumDebugApplicationNodes interface for the object.
+
+    """
+
+    _com_interfaces_ = [axdebug.IID_IEnumDebugApplicationNodes]
+
+
+class EnumRemoteDebugApplications(ListEnumeratorGateway):
+    _com_interfaces_ = [axdebug.IID_IEnumRemoteDebugApplications]
+
+
+class EnumRemoteDebugApplicationThreads(ListEnumeratorGateway):
+    _com_interfaces_ = [axdebug.IID_IEnumRemoteDebugApplicationThreads]
+
+
+class DebugDocumentInfo:
+    _public_methods_ = ["GetName", "GetDocumentClassId"]
+    _com_interfaces_ = [axdebug.IID_IDebugDocumentInfo]
+
+    def __init__(self):
+        pass
+
+    def GetName(self, dnt):
+        """Get the one of the name of the document
+        dnt -- int DOCUMENTNAMETYPE
+        """
+        RaiseNotImpl("GetName")
+
+    def GetDocumentClassId(self):
+        """
+        Result must be an IID object (or string representing one).
+        """
+        RaiseNotImpl("GetDocumentClassId")
+
+
+class DebugDocumentProvider(DebugDocumentInfo):
+    _public_methods_ = DebugDocumentInfo._public_methods_ + ["GetDocument"]
+    _com_interfaces_ = DebugDocumentInfo._com_interfaces_ + [
+        axdebug.IID_IDebugDocumentProvider
+    ]
+
+    def GetDocument(self):
+        RaiseNotImpl("GetDocument")
+
+
+class DebugApplicationNode(DebugDocumentProvider):
+    """Provides the functionality of IDebugDocumentProvider, plus a context within a project tree."""
+
+    _public_methods_ = (
+        """EnumChildren GetParent SetDocumentProvider
+                    Close Attach Detach""".split()
+        + DebugDocumentProvider._public_methods_
+    )
+    _com_interfaces_ = [
+        axdebug.IID_IDebugDocumentProvider
+    ] + DebugDocumentProvider._com_interfaces_
+
+    def __init__(self):
+        DebugDocumentProvider.__init__(self)
+
+    def EnumChildren(self):
+        # Result is type PyIEnumDebugApplicationNodes
+        RaiseNotImpl("EnumChildren")
+
+    def GetParent(self):
+        # result is type PyIDebugApplicationNode
+        RaiseNotImpl("GetParent")
+
+    def SetDocumentProvider(self, pddp):  # PyIDebugDocumentProvider pddp
+        # void result.
+        RaiseNotImpl("SetDocumentProvider")
+
+    def Close(self):
+        # void result.
+        RaiseNotImpl("Close")
+
+    def Attach(self, parent):  # PyIDebugApplicationNode
+        # void result.
+        RaiseNotImpl("Attach")
+
+    def Detach(self):
+        # void result.
+        RaiseNotImpl("Detach")
+
+
+class DebugApplicationNodeEvents:
+    """Event interface for DebugApplicationNode object."""
+
+    _public_methods_ = "onAddChild onRemoveChild onDetach".split()
+    _com_interfaces_ = [axdebug.IID_IDebugApplicationNodeEvents]
+
+    def __init__(self):
+        pass
+
+    def onAddChild(self, child):  # PyIDebugApplicationNode
+        # void result.
+        RaiseNotImpl("onAddChild")
+
+    def onRemoveChild(self, child):  # PyIDebugApplicationNode
+        # void result.
+        RaiseNotImpl("onRemoveChild")
+
+    def onDetach(self):
+        # void result.
+        RaiseNotImpl("onDetach")
+
+    def onAttach(self, parent):  # PyIDebugApplicationNode
+        # void result.
+        RaiseNotImpl("onAttach")
+
+
+class DebugDocument(DebugDocumentInfo):
+    """The base interface to all debug documents."""
+
+    _public_methods_ = DebugDocumentInfo._public_methods_
+    _com_interfaces_ = [axdebug.IID_IDebugDocument] + DebugDocumentInfo._com_interfaces_
+
+
+class DebugDocumentText(DebugDocument):
+    """The interface to a text only debug document."""
+
+    _com_interfaces_ = [axdebug.IID_IDebugDocumentText] + DebugDocument._com_interfaces_
+    _public_methods_ = [
+        "GetDocumentAttributes",
+        "GetSize",
+        "GetPositionOfLine",
+        "GetLineOfPosition",
+        "GetText",
+        "GetPositionOfContext",
+        "GetContextOfPosition",
+    ] + DebugDocument._public_methods_
+
+    def __init__(self):
+        pass
+
+    # IDebugDocumentText
+    def GetDocumentAttributes(self):
+        # Result is int (TEXT_DOC_ATTR)
+        RaiseNotImpl("GetDocumentAttributes")
+
+    def GetSize(self):
+        # Result is (numLines, numChars)
+        RaiseNotImpl("GetSize")
+
+    def GetPositionOfLine(self, cLineNumber):
+        # Result is int char position
+        RaiseNotImpl("GetPositionOfLine")
+
+    def GetLineOfPosition(self, charPos):
+        # Result is int, int (lineNo, offset)
+        RaiseNotImpl("GetLineOfPosition")
+
+    def GetText(self, charPos, maxChars, wantAttr):
+        """Params
+        charPos -- integer
+        maxChars -- integer
+        wantAttr -- Should the function compute attributes.
+
+        Return value must be (string, attribtues).  attributes may be
+        None if(not wantAttr)
+        """
+        RaiseNotImpl("GetText")
+
+    def GetPositionOfContext(self, debugDocumentContext):
+        """Params
+        debugDocumentContext -- a PyIDebugDocumentContext object.
+
+        Return value must be (charPos, numChars)
+        """
+        RaiseNotImpl("GetPositionOfContext")
+
+    def GetContextOfPosition(self, charPos, maxChars):
+        """Params are integers.
+        Return value must be PyIDebugDocumentContext object
+        """
+        print(self)
+        RaiseNotImpl("GetContextOfPosition")
+
+
+class DebugDocumentTextExternalAuthor:
+    """Allow external editors to edit file-based debugger documents, and to notify the document when the source file has been changed."""
+
+    _public_methods_ = ["GetPathName", "GetFileName", "NotifyChanged"]
+    _com_interfaces_ = [axdebug.IID_IDebugDocumentTextExternalAuthor]
+
+    def __init__(self):
+        pass
+
+    def GetPathName(self):
+        """Return the full path (including file name) to the document's source file.
+
+        Result must be (filename, fIsOriginal), where
+        - if fIsOriginalPath is TRUE if the path refers to the original file for the document.
+        - if fIsOriginalPath is FALSE if the path refers to a newly created temporary file.
+
+        raise Exception(winerror.E_FAIL) if no source file can be created/determined.
+        """
+        RaiseNotImpl("GetPathName")
+
+    def GetFileName(self):
+        """Return just the name of the document, with no path information.  (Used for "Save As...")
+
+        Result is a string
+        """
+        RaiseNotImpl("GetFileName")
+
+    def NotifyChanged(self):
+        """Notify the host that the document's source file has been saved and
+        that its contents should be refreshed.
+        """
+        RaiseNotImpl("NotifyChanged")
+
+
+class DebugDocumentTextEvents:
+    _public_methods_ = """onDestroy onInsertText onRemoveText
+              onReplaceText onUpdateTextAttributes
+              onUpdateDocumentAttributes""".split()
+    _com_interfaces_ = [axdebug.IID_IDebugDocumentTextEvents]
+
+    def __init__(self):
+        pass
+
+    def onDestroy(self):
+        # Result is void.
+        RaiseNotImpl("onDestroy")
+
+    def onInsertText(self, cCharacterPosition, cNumToInsert):
+        # Result is void.
+        RaiseNotImpl("onInsertText")
+
+    def onRemoveText(self, cCharacterPosition, cNumToRemove):
+        # Result is void.
+        RaiseNotImpl("onRemoveText")
+
+    def onReplaceText(self, cCharacterPosition, cNumToReplace):
+        # Result is void.
+        RaiseNotImpl("onReplaceText")
+
+    def onUpdateTextAttributes(self, cCharacterPosition, cNumToUpdate):
+        # Result is void.
+        RaiseNotImpl("onUpdateTextAttributes")
+
+    def onUpdateDocumentAttributes(self, textdocattr):  # TEXT_DOC_ATTR
+        # Result is void.
+        RaiseNotImpl("onUpdateDocumentAttributes")
+
+
+class DebugDocumentContext:
+    _public_methods_ = ["GetDocument", "EnumCodeContexts"]
+    _com_interfaces_ = [axdebug.IID_IDebugDocumentContext]
+
+    def __init__(self):
+        pass
+
+    def GetDocument(self):
+        """Return value must be a PyIDebugDocument object"""
+        RaiseNotImpl("GetDocument")
+
+    def EnumCodeContexts(self):
+        """Return value must be a PyIEnumDebugCodeContexts object"""
+        RaiseNotImpl("EnumCodeContexts")
+
+
+class DebugCodeContext:
+    _public_methods_ = ["GetDocumentContext", "SetBreakPoint"]
+    _com_interfaces_ = [axdebug.IID_IDebugCodeContext]
+
+    def __init__(self):
+        pass
+
+    def GetDocumentContext(self):
+        """Return value must be a PyIDebugDocumentContext object"""
+        RaiseNotImpl("GetDocumentContext")
+
+    def SetBreakPoint(self, bps):
+        """bps -- an integer with flags."""
+        RaiseNotImpl("SetBreakPoint")
+
+
+class DebugStackFrame:
+    """Abstraction representing a logical stack frame on the stack of a thread."""
+
+    _public_methods_ = [
+        "GetCodeContext",
+        "GetDescriptionString",
+        "GetLanguageString",
+        "GetThread",
+        "GetDebugProperty",
+    ]
+    _com_interfaces_ = [axdebug.IID_IDebugStackFrame]
+
+    def __init__(self):
+        pass
+
+    def GetCodeContext(self):
+        """Returns the current code context associated with the stack frame.
+
+        Return value must be a IDebugCodeContext object
+        """
+        RaiseNotImpl("GetCodeContext")
+
+    def GetDescriptionString(self, fLong):
+        """Returns a textual description of the stack frame.
+
+        fLong -- A flag indicating if the long name is requested.
+        """
+        RaiseNotImpl("GetDescriptionString")
+
+    def GetLanguageString(self):
+        """Returns a short or long textual description of the language.
+
+        fLong -- A flag indicating if the long name is requested.
+        """
+        RaiseNotImpl("GetLanguageString")
+
+    def GetThread(self):
+        """Returns the thread associated with this stack frame.
+
+        Result must be a IDebugApplicationThread
+        """
+        RaiseNotImpl("GetThread")
+
+    def GetDebugProperty(self):
+        RaiseNotImpl("GetDebugProperty")
+
+
+class DebugDocumentHost:
+    """The interface from the IDebugDocumentHelper back to
+    the smart host or language engine.  This interface
+    exposes host specific functionality such as syntax coloring.
+    """
+
+    _public_methods_ = [
+        "GetDeferredText",
+        "GetScriptTextAttributes",
+        "OnCreateDocumentContext",
+        "GetPathName",
+        "GetFileName",
+        "NotifyChanged",
+    ]
+    _com_interfaces_ = [axdebug.IID_IDebugDocumentHost]
+
+    def __init__(self):
+        pass
+
+    def GetDeferredText(self, dwTextStartCookie, maxChars, bWantAttr):
+        RaiseNotImpl("GetDeferredText")
+
+    def GetScriptTextAttributes(self, codeText, delimterText, flags):
+        # Result must be an attribute sequence of same "length" as the code.
+        RaiseNotImpl("GetScriptTextAttributes")
+
+    def OnCreateDocumentContext(self):
+        # Result must be a PyIUnknown
+        RaiseNotImpl("OnCreateDocumentContext")
+
+    def GetPathName(self):
+        # Result must be (string, int) where the int is a BOOL
+        # - TRUE if the path refers to the original file for the document.
+        # - FALSE if the path refers to a newly created temporary file.
+        # - raise Exception(scode=E_FAIL) if no source file can be created/determined.
+        RaiseNotImpl("GetPathName")
+
+    def GetFileName(self):
+        # Result is a string with just the name of the document, no path information.
+        RaiseNotImpl("GetFileName")
+
+    def NotifyChanged(self):
+        RaiseNotImpl("NotifyChanged")
+
+
+# Additional gateway related functions.
+
+
+class DebugDocumentTextConnectServer:
+    _public_methods_ = (
+        win32com.server.connect.IConnectionPointContainer_methods
+        + win32com.server.connect.IConnectionPoint_methods
+    )
+    _com_interfaces_ = [
+        pythoncom.IID_IConnectionPoint,
+        pythoncom.IID_IConnectionPointContainer,
+    ]
+
+    # IConnectionPoint interfaces
+    def __init__(self):
+        self.cookieNo = -1
+        self.connections = {}
+
+    def EnumConnections(self):
+        RaiseNotImpl("EnumConnections")
+
+    def GetConnectionInterface(self):
+        RaiseNotImpl("GetConnectionInterface")
+
+    def GetConnectionPointContainer(self):
+        return _wrap(self)
+
+    def Advise(self, pUnk):
+        # Creates a connection to the client.  Simply allocate a new cookie,
+        # find the clients interface, and store it in a dictionary.
+        interface = pUnk.QueryInterface(axdebug.IID_IDebugDocumentTextEvents, 1)
+        self.cookieNo = self.cookieNo + 1
+        self.connections[self.cookieNo] = interface
+        return self.cookieNo
+
+    def Unadvise(self, cookie):
+        # Destroy a connection - simply delete interface from the map.
+        try:
+            del self.connections[cookie]
+        except KeyError:
+            return Exception(scode=winerror.E_UNEXPECTED)
+
+    # IConnectionPointContainer interfaces
+    def EnumConnectionPoints(self):
+        RaiseNotImpl("EnumConnectionPoints")
+
+    def FindConnectionPoint(self, iid):
+        # Find a connection we support.  Only support the single event interface.
+        if iid == axdebug.IID_IDebugDocumentTextEvents:
+            return _wrap(self)
+        raise Exception(scode=winerror.E_NOINTERFACE)  # ??
+
+
+class RemoteDebugApplicationEvents:
+    _public_methods_ = [
+        "OnConnectDebugger",
+        "OnDisconnectDebugger",
+        "OnSetName",
+        "OnDebugOutput",
+        "OnClose",
+        "OnEnterBreakPoint",
+        "OnLeaveBreakPoint",
+        "OnCreateThread",
+        "OnDestroyThread",
+        "OnBreakFlagChange",
+    ]
+    _com_interfaces_ = [axdebug.IID_IRemoteDebugApplicationEvents]
+
+    def OnConnectDebugger(self, appDebugger):
+        """appDebugger -- a PyIApplicationDebugger"""
+        RaiseNotImpl("OnConnectDebugger")
+
+    def OnDisconnectDebugger(self):
+        RaiseNotImpl("OnDisconnectDebugger")
+
+    def OnSetName(self, name):
+        RaiseNotImpl("OnSetName")
+
+    def OnDebugOutput(self, string):
+        RaiseNotImpl("OnDebugOutput")
+
+    def OnClose(self):
+        RaiseNotImpl("OnClose")
+
+    def OnEnterBreakPoint(self, rdat):
+        """rdat -- PyIRemoteDebugApplicationThread"""
+        RaiseNotImpl("OnEnterBreakPoint")
+
+    def OnLeaveBreakPoint(self, rdat):
+        """rdat -- PyIRemoteDebugApplicationThread"""
+        RaiseNotImpl("OnLeaveBreakPoint")
+
+    def OnCreateThread(self, rdat):
+        """rdat -- PyIRemoteDebugApplicationThread"""
+        RaiseNotImpl("OnCreateThread")
+
+    def OnDestroyThread(self, rdat):
+        """rdat -- PyIRemoteDebugApplicationThread"""
+        RaiseNotImpl("OnDestroyThread")
+
+    def OnBreakFlagChange(self, abf, rdat):
+        """abf -- int - one of the axdebug.APPBREAKFLAGS constants
+        rdat -- PyIRemoteDebugApplicationThread
+        RaiseNotImpl("OnBreakFlagChange")
+        """
+
+
+class DebugExpressionContext:
+    _public_methods_ = ["ParseLanguageText", "GetLanguageInfo"]
+    _com_interfaces_ = [axdebug.IID_IDebugExpressionContext]
+
+    def __init__(self):
+        pass
+
+    def ParseLanguageText(self, code, radix, delim, flags):
+        """
+        result is IDebugExpression
+        """
+        RaiseNotImpl("ParseLanguageText")
+
+    def GetLanguageInfo(self):
+        """
+        result is (string langName, iid langId)
+        """
+        RaiseNotImpl("GetLanguageInfo")
+
+
+class DebugExpression:
+    _public_methods_ = [
+        "Start",
+        "Abort",
+        "QueryIsComplete",
+        "GetResultAsString",
+        "GetResultAsDebugProperty",
+    ]
+    _com_interfaces_ = [axdebug.IID_IDebugExpression]
+
+    def Start(self, callback):
+        """
+        callback -- an IDebugExpressionCallback
+
+        result - void
+        """
+        RaiseNotImpl("Start")
+
+    def Abort(self):
+        """
+        no params
+        result -- void
+        """
+        RaiseNotImpl("Abort")
+
+    def QueryIsComplete(self):
+        """
+        no params
+        result -- void
+        """
+        RaiseNotImpl("QueryIsComplete")
+
+    def GetResultAsString(self):
+        RaiseNotImpl("GetResultAsString")
+
+    def GetResultAsDebugProperty(self):
+        RaiseNotImpl("GetResultAsDebugProperty")
+
+
+class ProvideExpressionContexts:
+    _public_methods_ = ["EnumExpressionContexts"]
+    _com_interfaces_ = [axdebug.IID_IProvideExpressionContexts]
+
+    def EnumExpressionContexts(self):
+        RaiseNotImpl("EnumExpressionContexts")
diff --git a/lib/win32comext/axdebug/stackframe.py b/lib/win32comext/axdebug/stackframe.py
new file mode 100644
index 00000000..edc3fe8c
--- /dev/null
+++ b/lib/win32comext/axdebug/stackframe.py
@@ -0,0 +1,179 @@
+"""Support for stack-frames.
+
+Provides Implements a nearly complete wrapper for a stack frame.
+"""
+
+import pythoncom
+from win32com.server.exception import COMException
+
+from . import axdebug, expressions, gateways
+from .util import RaiseNotImpl, _wrap, trace
+
+# def trace(*args):
+#       pass
+
+
+class EnumDebugStackFrames(gateways.EnumDebugStackFrames):
+    """A class that given a debugger object, can return an enumerator
+    of DebugStackFrame objects.
+    """
+
+    def __init__(self, debugger):
+        infos = []
+        frame = debugger.currentframe
+        #               print "Stack check"
+        while frame:
+            #                       print " Checking frame", frame.f_code.co_filename, frame.f_lineno-1, frame.f_trace,
+            # Get a DebugCodeContext for the stack frame.  If we fail, then it
+            # is not debuggable, and therefore not worth displaying.
+            cc = debugger.codeContainerProvider.FromFileName(frame.f_code.co_filename)
+            if cc is not None:
+                try:
+                    address = frame.f_locals["__axstack_address__"]
+                except KeyError:
+                    #                                       print "Couldnt find stack address for",frame.f_code.co_filename, frame.f_lineno-1
+                    # Use this one, even tho it is wrong :-(
+                    address = axdebug.GetStackAddress()
+                frameInfo = (
+                    DebugStackFrame(frame, frame.f_lineno - 1, cc),
+                    address,
+                    address + 1,
+                    0,
+                    None,
+                )
+                infos.append(frameInfo)
+            #                               print "- Kept!"
+            #                       else:
+            #                               print "- rejected"
+            frame = frame.f_back
+
+        gateways.EnumDebugStackFrames.__init__(self, infos, 0)
+
+    #       def __del__(self):
+    #               print "EnumDebugStackFrames dieing"
+
+    def Next(self, count):
+        return gateways.EnumDebugStackFrames.Next(self, count)
+
+    #       def _query_interface_(self, iid):
+    #               from win32com.util import IIDToInterfaceName
+    #               print "EnumDebugStackFrames QI with %s (%s)" % (IIDToInterfaceName(iid), str(iid))
+    #               return 0
+    def _wrap(self, obj):
+        # This enum returns a tuple, with 2 com objects in it.
+        obFrame, min, lim, fFinal, obFinal = obj
+        obFrame = _wrap(obFrame, axdebug.IID_IDebugStackFrame)
+        if obFinal:
+            obFinal = _wrap(obFinal, pythoncom.IID_IUnknown)
+        return obFrame, min, lim, fFinal, obFinal
+
+
+class DebugStackFrame(gateways.DebugStackFrame):
+    def __init__(self, frame, lineno, codeContainer):
+        self.frame = frame
+        self.lineno = lineno
+        self.codeContainer = codeContainer
+        self.expressionContext = None
+
+    #       def __del__(self):
+    #               print "DSF dieing"
+    def _query_interface_(self, iid):
+        if iid == axdebug.IID_IDebugExpressionContext:
+            if self.expressionContext is None:
+                self.expressionContext = _wrap(
+                    expressions.ExpressionContext(self.frame),
+                    axdebug.IID_IDebugExpressionContext,
+                )
+            return self.expressionContext
+        #               from win32com.util import IIDToInterfaceName
+        #               print "DebugStackFrame QI with %s (%s)" % (IIDToInterfaceName(iid), str(iid))
+        return 0
+
+    #
+    # The following need implementation
+    def GetThread(self):
+        """Returns the thread associated with this stack frame.
+
+        Result must be a IDebugApplicationThread
+        """
+        RaiseNotImpl("GetThread")
+
+    def GetCodeContext(self):
+        offset = self.codeContainer.GetPositionOfLine(self.lineno)
+        return self.codeContainer.GetCodeContextAtPosition(offset)
+
+    #
+    # The following are usefully implemented
+    def GetDescriptionString(self, fLong):
+        filename = self.frame.f_code.co_filename
+        s = ""
+        if 0:  # fLong:
+            s = s + filename
+        if self.frame.f_code.co_name:
+            s = s + self.frame.f_code.co_name
+        else:
+            s = s + "<lambda>"
+        return s
+
+    def GetLanguageString(self, fLong):
+        if fLong:
+            return "Python ActiveX Scripting Engine"
+        else:
+            return "Python"
+
+    def GetDebugProperty(self):
+        return _wrap(StackFrameDebugProperty(self.frame), axdebug.IID_IDebugProperty)
+
+
+class DebugStackFrameSniffer:
+    _public_methods_ = ["EnumStackFrames"]
+    _com_interfaces_ = [axdebug.IID_IDebugStackFrameSniffer]
+
+    def __init__(self, debugger):
+        self.debugger = debugger
+        trace("DebugStackFrameSniffer instantiated")
+
+    #       def __del__(self):
+    #               print "DSFS dieing"
+    def EnumStackFrames(self):
+        trace("DebugStackFrameSniffer.EnumStackFrames called")
+        return _wrap(
+            EnumDebugStackFrames(self.debugger), axdebug.IID_IEnumDebugStackFrames
+        )
+
+
+# A DebugProperty for a stack frame.
+class StackFrameDebugProperty:
+    _com_interfaces_ = [axdebug.IID_IDebugProperty]
+    _public_methods_ = [
+        "GetPropertyInfo",
+        "GetExtendedInfo",
+        "SetValueAsString",
+        "EnumMembers",
+        "GetParent",
+    ]
+
+    def __init__(self, frame):
+        self.frame = frame
+
+    def GetPropertyInfo(self, dwFieldSpec, nRadix):
+        RaiseNotImpl("StackFrameDebugProperty::GetPropertyInfo")
+
+    def GetExtendedInfo(self):  ### Note - not in the framework.
+        RaiseNotImpl("StackFrameDebugProperty::GetExtendedInfo")
+
+    def SetValueAsString(self, value, radix):
+        #
+        RaiseNotImpl("DebugProperty::SetValueAsString")
+
+    def EnumMembers(self, dwFieldSpec, nRadix, iid):
+        print("EnumMembers", dwFieldSpec, nRadix, iid)
+        from . import expressions
+
+        return expressions.MakeEnumDebugProperty(
+            self.frame.f_locals, dwFieldSpec, nRadix, iid, self.frame
+        )
+
+    def GetParent(self):
+        # return IDebugProperty
+        RaiseNotImpl("DebugProperty::GetParent")
diff --git a/lib/win32comext/axdebug/util.py b/lib/win32comext/axdebug/util.py
new file mode 100644
index 00000000..c3d4f733
--- /dev/null
+++ b/lib/win32comext/axdebug/util.py
@@ -0,0 +1,141 @@
+# Utility function for wrapping objects.  Centralising allows me to turn
+# debugging on and off for the entire package in a single spot.
+
+import os
+import sys
+
+import win32api
+import win32com.server.util
+import winerror
+from win32com.server.exception import Exception
+
+try:
+    os.environ["DEBUG_AXDEBUG"]
+    debugging = 1
+except KeyError:
+    debugging = 0
+
+
+def trace(*args):
+    if not debugging:
+        return
+    print(str(win32api.GetCurrentThreadId()) + ":", end=" ")
+    for arg in args:
+        print(arg, end=" ")
+    print()
+
+
+# The AXDebugging implementation assumes that the returned COM pointers are in
+# some cases identical.  Eg, from a C++ perspective:
+# p->GetSomeInterface( &p1 );
+# p->GetSomeInterface( &p2 );
+# p1==p2
+# By default, this is _not_ true for Python.
+# (Now this is only true for Document objects, and Python
+# now does ensure this.
+
+all_wrapped = {}
+
+
+def _wrap_nodebug(object, iid):
+    return win32com.server.util.wrap(object, iid)
+
+
+def _wrap_debug(object, iid):
+    import win32com.server.policy
+
+    dispatcher = win32com.server.policy.DispatcherWin32trace
+    return win32com.server.util.wrap(object, iid, useDispatcher=dispatcher)
+
+
+if debugging:
+    _wrap = _wrap_debug
+else:
+    _wrap = _wrap_nodebug
+
+
+def _wrap_remove(object, iid=None):
+    # Old - no longer used or necessary!
+    return
+
+
+def _dump_wrapped():
+    from win32com.server.util import unwrap
+
+    print("Wrapped items:")
+    for key, items in all_wrapped.items():
+        print(key, end=" ")
+        try:
+            ob = unwrap(key)
+            print(ob, sys.getrefcount(ob))
+        except:
+            print("<error>")
+
+
+def RaiseNotImpl(who=None):
+    if who is not None:
+        print("********* Function %s Raising E_NOTIMPL  ************" % (who))
+
+    # Print a sort-of "traceback", dumping all the frames leading to here.
+    try:
+        1 / 0
+    except:
+        frame = sys.exc_info()[2].tb_frame
+    while frame:
+        print("File: %s, Line: %d" % (frame.f_code.co_filename, frame.f_lineno))
+        frame = frame.f_back
+
+    # and raise the exception for COM
+    raise Exception(scode=winerror.E_NOTIMPL)
+
+
+import win32com.server.policy
+
+
+class Dispatcher(win32com.server.policy.DispatcherWin32trace):
+    def __init__(self, policyClass, object):
+        win32com.server.policy.DispatcherTrace.__init__(self, policyClass, object)
+        import win32traceutil  # Sets up everything.
+
+    #               print "Object with win32trace dispatcher created (object=%s)" % `object`
+
+    def _QueryInterface_(self, iid):
+        rc = win32com.server.policy.DispatcherBase._QueryInterface_(self, iid)
+        #               if not rc:
+        #                       self._trace_("in _QueryInterface_ with unsupported IID %s (%s)\n" % (IIDToInterfaceName(iid),iid))
+        return rc
+
+    def _Invoke_(self, dispid, lcid, wFlags, args):
+        print(
+            "In Invoke with",
+            dispid,
+            lcid,
+            wFlags,
+            args,
+            "with object",
+            self.policy._obj_,
+        )
+        try:
+            rc = win32com.server.policy.DispatcherBase._Invoke_(
+                self, dispid, lcid, wFlags, args
+            )
+            #                       print "Invoke of", dispid, "returning", rc
+            return rc
+        except Exception:
+            t, v, tb = sys.exc_info()
+            tb = None  # A cycle
+            scode = v.scode
+            try:
+                desc = " (" + str(v.description) + ")"
+            except AttributeError:
+                desc = ""
+            print(
+                "*** Invoke of %s raised COM exception 0x%x%s" % (dispid, scode, desc)
+            )
+        except:
+            print("*** Invoke of %s failed:" % dispid)
+            typ, val, tb = sys.exc_info()
+            import traceback
+
+            traceback.print_exception(typ, val, tb)
+            raise
diff --git a/lib/win32comext/axscript/Demos/client/asp/CreateObject.asp b/lib/win32comext/axscript/Demos/client/asp/CreateObject.asp
new file mode 100644
index 00000000..5338c0a0
--- /dev/null
+++ b/lib/win32comext/axscript/Demos/client/asp/CreateObject.asp
@@ -0,0 +1,19 @@
+<HTML>
+
+<SCRIPT Language="Python" RUNAT=Server>
+
+# Just for the sake of the demo, our Python script engine
+# will create a Python.Interpreter COM object, and call that.
+
+# This is completely useless, as the Python Script Engine is
+# completely normal Python, and ASP does not impose retrictions, so
+# there is nothing the COM object can do that we can not do natively.
+
+o = Server.CreateObject("Python.Interpreter")
+
+Response.Write("Python says 1+1=" + str(o.Eval("1+1")))
+
+</SCRIPT>
+
+</HTML>
+
diff --git a/lib/win32comext/axscript/Demos/client/asp/caps.asp b/lib/win32comext/axscript/Demos/client/asp/caps.asp
new file mode 100644
index 00000000..6b0342aa
--- /dev/null
+++ b/lib/win32comext/axscript/Demos/client/asp/caps.asp
@@ -0,0 +1,52 @@
+<%@ Language=Python %>
+<HTML>
+
+<HEAD>
+
+<BODY BACKGROUND="/samples/images/backgrnd.gif">
+
+<TITLE>Python test</TITLE>
+
+</HEAD>
+
+<BODY BGCOLOR="FFFFFF">
+
+<SCRIPT Language="Python" RUNAT=Server>
+# NOTE that the <% tags below execute _before_ these tags!
+Response.Write("Hello from Python<P>")
+Response.Write("Browser is "+bc.browser)
+import win32api # Should be no problem using win32api in ASP pages.
+Response.Write("<p>Win32 username is "+win32api.GetUserName())
+</SCRIPT>
+
+<BODY BGCOLOR="FFFFFF">
+
+<% 
+import sys
+print sys.path
+from win32com.axscript.asputil import *
+print "Hello"
+print "There"
+print "How are you"
+%>
+
+<%bc = Server.CreateObject("MSWC.BrowserType")%>
+<BODY BGCOLOR="FFFFFF">
+<table border=1> 
+<tr><td>Browser</td><td> <%=bc.browser %> 
+<tr><td>Version</td><td> <%=bc.version %> </td></TR> 
+<tr><td>Frames</td><td> 
+<%Response.Write( iif(bc.frames, "TRUE", "FALSE")) %></td></TR> 
+<tr><td>Tables</td><td> 
+<%Response.Write( iif (bc.tables, "TRUE", "FALSE")) %></td></TR> 
+<tr><td>BackgroundSounds</td><td> 
+<%Response.Write( iif(bc.BackgroundSounds, "TRUE", "FALSE"))%></td></TR> 
+<tr><td>VBScript</td><td> 
+<%Response.Write( iif(bc.vbscript, "TRUE", "FALSE"))%></td></TR> 
+<tr><td>JavaScript</td><td> 
+<%Response.Write( iif(bc.javascript, "TRUE", "FALSE"))%></td></TR> 
+
+</table> 
+
+</body>
+</html>
diff --git a/lib/win32comext/axscript/Demos/client/asp/interrupt/test.asp b/lib/win32comext/axscript/Demos/client/asp/interrupt/test.asp
new file mode 100644
index 00000000..ee77703f
--- /dev/null
+++ b/lib/win32comext/axscript/Demos/client/asp/interrupt/test.asp
@@ -0,0 +1,4 @@
+<%@ language=python%>
+<html>
+<%Response.Redirect("test1.html")%>
+</html>
diff --git a/lib/win32comext/axscript/Demos/client/asp/interrupt/test.html b/lib/win32comext/axscript/Demos/client/asp/interrupt/test.html
new file mode 100644
index 00000000..0b7f0559
--- /dev/null
+++ b/lib/win32comext/axscript/Demos/client/asp/interrupt/test.html
@@ -0,0 +1,10 @@
+<html>
+<head>
+<body>
+GOT There
+<script language=javascript>
+location.href ="http://192.168.0.1/Python/interrupt/test.asp"
+</script>
+</body>
+</head>
+</html>
diff --git a/lib/win32comext/axscript/Demos/client/asp/interrupt/test1.asp b/lib/win32comext/axscript/Demos/client/asp/interrupt/test1.asp
new file mode 100644
index 00000000..a936dd99
--- /dev/null
+++ b/lib/win32comext/axscript/Demos/client/asp/interrupt/test1.asp
@@ -0,0 +1,6 @@
+<%@ language =Python%>
+<html>
+<head>
+<%Response.Redirect("test.html")%>
+</head>
+</html>
diff --git a/lib/win32comext/axscript/Demos/client/asp/interrupt/test1.html b/lib/win32comext/axscript/Demos/client/asp/interrupt/test1.html
new file mode 100644
index 00000000..6f1d9b2f
--- /dev/null
+++ b/lib/win32comext/axscript/Demos/client/asp/interrupt/test1.html
@@ -0,0 +1,11 @@
+<html>
+<head>
+<body>
+GOT HERE
+<script language=javascript>
+location.href ="http://192.168.0.1/Python/interrupt/test1.asp"
+</script>
+</body>
+</head>
+</html>
+
diff --git a/lib/win32comext/axscript/Demos/client/asp/tut1.asp b/lib/win32comext/axscript/Demos/client/asp/tut1.asp
new file mode 100644
index 00000000..dcbb047c
--- /dev/null
+++ b/lib/win32comext/axscript/Demos/client/asp/tut1.asp
@@ -0,0 +1,11 @@
+<HTML>
+
+<SCRIPT Language="Python" RUNAT=Server>
+
+for i in range(3,8):
+  Response.Write("<FONT SIZE=%d>Hello World!!<BR>" % i)
+
+</SCRIPT>
+
+</HTML>
+
diff --git a/lib/win32comext/axscript/Demos/client/ie/MarqueeText1.htm b/lib/win32comext/axscript/Demos/client/ie/MarqueeText1.htm
new file mode 100644
index 00000000..85a676f8
--- /dev/null
+++ b/lib/win32comext/axscript/Demos/client/ie/MarqueeText1.htm
@@ -0,0 +1,25 @@
+<HTML>
+<HEAD>
+<base target="text">
+<TITLE> Internet Workshop </TITLE>
+</HEAD>
+<BODY leftmargin=8 bgcolor="#FFFFFF" VLINK="#666666" LINK="#FF0000">
+<FONT FACE="ARIAL,HELVETICA" SIZE="2">
+
+<P>
+<BR>
+<P><FONT FACE="ARIAL,HELVETICA" SIZE="5"><B>Python AX Script Engine</B></FONT>
+<BR>Demo using the Marquee Control
+<BR>Mark Hammond.
+
+<P>This is really quite a boring demo, as the Marquee control does everything.  However, there is Python code behind the buttons that change the speed.  This code is all of 2 lines per button!!!
+
+<P>For more information on Python as an ActiveX scripting language, see
+
+<P><B>Python</B>
+<BR><A HREF="http://www.python.org">http://www.python.org</A>
+
+</FONT>
+</BODY>
+</HTML>
+
diff --git a/lib/win32comext/axscript/Demos/client/ie/calc.htm b/lib/win32comext/axscript/Demos/client/ie/calc.htm
new file mode 100644
index 00000000..7c7fb48d
--- /dev/null
+++ b/lib/win32comext/axscript/Demos/client/ie/calc.htm
@@ -0,0 +1,116 @@
+<HTML>
+<HEAD><TITLE>Python Script sample:  Calculator</TITLE></HEAD>
+<BODY><FONT FACE=ARIAL SIZE=3> <!-- global default -->
+<SCRIPT LANGUAGE="Python">
+# globals
+Accum = 0.0	  # Previous number (operand) awaiting operation
+FlagNewNum = 1    # Flag to indicate a new number (operand) is being entered
+NullOp = lambda x,y: y
+PendingOp = NullOp# Pending operation waiting for completion of second operand
+numberButNames = ['Zero','One','Two','Three','Four','Five','Six','Seven','Eight','Nine']
+
+def NumPressed(Num):
+	print "NumPressed", Num
+	global FlagNewNum
+	if FlagNewNum:
+		ax.document.Keypad.ReadOut.Value = Num
+		FlagNewNum = None
+	else:
+		if ax.document.Keypad.ReadOut.Value == "0":
+			ax.document.Keypad.ReadOut.Value = str(Num)
+		else:
+			ax.document.Keypad.ReadOut.Value= ax.document.Keypad.ReadOut.Value + str(Num)
+
+# Dynamically create handlers for all the decimal buttons.
+# (ie, this will dynamically create "One_OnClick()"... etc handlers
+for i in range(len(numberButNames)):
+	exec "def %s_OnClick():\tNumPressed(%d)\n" % (numberButNames[i],i)
+
+def Decimal_OnClick():
+	global curReadOut, FlagNewNum
+	curReadOut = ax.document.Keypad.ReadOut.Value
+	if FlagNewNum:
+		curReadOut = "0."
+		FlagNewNum = None
+	else:
+		if not ("." in curReadOut):
+			curReadOut = curReadOut + "."
+	ax.document.Keypad.ReadOut.Value = curReadOut
+
+import sys, string
+
+def Operation(Op, fn):
+	global FlagNewNum, PendingOp, Accum
+	ReadOut = ax.document.Keypad.ReadOut.Value
+	print "Operation", Op, ReadOut, PendingOp, Accum
+	if FlagNewNum:
+		# User is hitting op keys repeatedly, so don't do anything
+		PendingOp = NullOp
+	else:
+		FlagNewNum = 1
+		Accum = PendingOp( Accum, string.atof(ReadOut) )
+	ax.document.Keypad.ReadOut.Value = str(Accum)
+	PendingOp = fn
+
+def ClearEntry_OnClick():
+	# Remove current number and reset state
+	global FlagNewNum
+	ax.document.Keypad.ReadOut.Value = "0"
+	FlagNewNum = 1
+
+def Clear_OnClick():
+	global Accum, PendingOp
+	Accum = 0
+	PendingOp = NullOp
+	ClearEntry_OnClick()
+
+def Neg_OnClick():
+	ax.document.Keypad.ReadOut.Value = str(-string.atof(ax.document.Keypad.ReadOut.Value))
+</SCRIPT>
+
+
+<form action="" Name="Keypad">
+<TABLE>
+<B>
+<TABLE BORDER=2 WIDTH=50 HEIGHT=60 CELLPADDING=1 CELLSPACING=5>
+<CAPTION ALIGN=top> <b>Calculator</b><p> </CAPTION>
+<TR>
+ <TD COLSPAN=3 ALIGN=MIDDLE><INPUT NAME="ReadOut" TYPE="Text" SIZE=24 VALUE="0" WIDTH=100%></TD>
+ <TD></TD>
+ <TD><INPUT NAME="Clear" TYPE="Button" VALUE="  C  " ></TD>
+ <TD><INPUT NAME="ClearEntry" TYPE="Button" VALUE="  CE " ></TD>
+</TR>
+<TR>
+ <TD><INPUT NAME="Seven" TYPE="Button" VALUE="  7  " ></TD>
+ <TD><INPUT NAME="Eight" TYPE="Button" VALUE="  8  " ></TD>
+ <TD><INPUT NAME="Nine" TYPE="Button" VALUE="  9  " ></TD>
+ <TD></TD>
+ <TD><INPUT NAME="Neg" TYPE="Button" VALUE=" +/- " ></TD>
+ <TD><INPUT NAME="Percent" TYPE="Button" VALUE="  % " OnClick="Operation('%', lambda x,y: x*y/100.0)"></TD>
+</TR>
+
+<TR>
+ <TD><INPUT NAME="Four" TYPE="Button" VALUE="  4  " ></TD>
+ <TD><INPUT NAME="Five" TYPE="Button" VALUE="  5  " ></TD>
+ <TD><INPUT NAME="Six" TYPE="Button" VALUE="  6  " ></TD>
+ <TD></TD>
+ <TD ALIGN=MIDDLE><INPUT NAME="Plus" TYPE="Button" VALUE="  +  " OnClick="Operation('+', lambda x,y: x+y)"></TD>
+ <TD ALIGN=MIDDLE><INPUT NAME="Minus" TYPE="Button" VALUE="   -   " OnClick="Operation('-', lambda x,y: x-y)"></TD>
+</TR>
+<TR>
+ <TD><INPUT NAME="One" TYPE="Button" VALUE="  1  " ></TD>
+ <TD><INPUT NAME="Two" TYPE="Button" VALUE="  2  " ></TD>
+ <TD><INPUT NAME="Three" TYPE="Button" VALUE="  3  " ></TD>
+ <TD></TD>
+ <TD ALIGN=MIDDLE><INPUT NAME="Multiply" TYPE="Button" VALUE="  *  " OnClick="Operation('*', lambda x,y: x*y)" ></TD>
+ <TD ALIGN=MIDDLE><INPUT NAME="Divide" TYPE="Button" VALUE="   /   " OnClick="Operation('/', lambda x,y: x/y)" ></TD>
+</TR>
+<TR>
+ <TD><INPUT NAME="Zero" TYPE="Button" VALUE="  0  " ></TD>
+ <TD><INPUT NAME="Decimal" TYPE="Button" VALUE="   .  " ></TD>
+ <TD COLSPAN=3></TD>
+ <TD><INPUT NAME="Equals" TYPE="Button" VALUE="  =  " OnClick="Operation('=', lambda x,y: x)"></TD>
+</TR></TABLE></TABLE></B>
+</FORM>
+</FONT></BODY></HTML>
+
diff --git a/lib/win32comext/axscript/Demos/client/ie/dbgtest.htm b/lib/win32comext/axscript/Demos/client/ie/dbgtest.htm
new file mode 100644
index 00000000..7ee9468d
--- /dev/null
+++ b/lib/win32comext/axscript/Demos/client/ie/dbgtest.htm
@@ -0,0 +1,16 @@
+<HTML>
+<BODY>
+
+<SCRIPT>
+b="Hello There, how are you"
+</SCRIPT>
+
+<SCRIPT LANGUAGE="Python">
+print "Hello"
+a="Hi there"
+document.write("Hello<P>")
+alert("Hi there")
+</SCRIPT>
+
+</BODY>
+</HTML>
diff --git a/lib/win32comext/axscript/Demos/client/ie/demo.htm b/lib/win32comext/axscript/Demos/client/ie/demo.htm
new file mode 100644
index 00000000..a828bac2
--- /dev/null
+++ b/lib/win32comext/axscript/Demos/client/ie/demo.htm
@@ -0,0 +1,26 @@
+<HTML>
+<HEAD>
+<TITLE>Python AXScript Demos</TITLE>
+</HEAD>
+
+
+<SCRIPT LANGUAGE="Python">
+def Window_OnLoad():
+	pass
+#	import win32traceutil
+#	print "Frames are", ax.window.frames._print_details_()
+#	print "Frame 0 href = ", ax.frames.Item(0).location.href
+
+def Name_OnLoad():
+	print "Frame loading"
+
+</SCRIPT>
+
+<FRAMESET FRAMEBORDER=1 COLS = "250, *">
+	<FRAME SRC="demo_menu.htm">
+	<FRAME SRC="demo_check.htm" NAME="Body">
+</FRAMESET>
+
+
+</HTML>
+
diff --git a/lib/win32comext/axscript/Demos/client/ie/demo_check.htm b/lib/win32comext/axscript/Demos/client/ie/demo_check.htm
new file mode 100644
index 00000000..f0e09f9d
--- /dev/null
+++ b/lib/win32comext/axscript/Demos/client/ie/demo_check.htm
@@ -0,0 +1,42 @@
+<HTML>
+<H1>Engine Registration</H1>
+
+<BODY>
+
+<p>The Python ActiveX Scripting Engine is not currently registered.<p>
+
+<p>Due to a <a href="http://starship.python.net/crew/mhammond/win32/PrivacyProblem.html">privacy
+concern</a> discovered in the engine, the use of Python inside IE has been disabled.</p>
+
+Before any of the supplied demos will work, the engine must be successfully registered.
+
+<P>To install a version of the engine, that does work with IE, you can execute the Python program 
+<CODE>win32com\axscript\client\pyscript_rexec.py</CODE> must be run.  You can either do this manually, or follow the instructions below.</p>
+
+<H2>Register the engine now!</H2>
+
+<p>If you have read about the <a href="http://starship.python.net/crew/mhammond/win32/PrivacyProblem.html">privacy
+concern</a> and still wish to register the engine, just follow the process outlined below:</p>
+<OL>
+  <LI>Click on the link below
+  <LI><B>A dialog will be presented asking if the file should be opened or saved to disk.  Select "Open it".</B>
+  <LI>A Console program will briefly open, while the server is registered.
+</OL>
+
+<P><A HREF="..\..\..\client\pyscript_rexec.py">Register the engine now</A>
+
+<H2>Checking the registration</H2>
+After the registration is complete, simply hit the Reload button.  If the 
+registration was successful, the page will change to the Python/AvtiveX Demo Page.
+
+
+<SCRIPT LANGUAGE="Python">
+try:
+	window.open("demo_intro.htm", "Body")
+except:
+	history.back()
+</SCRIPT>
+</BODY></HTML>
+
+
+
diff --git a/lib/win32comext/axscript/Demos/client/ie/demo_intro.htm b/lib/win32comext/axscript/Demos/client/ie/demo_intro.htm
new file mode 100644
index 00000000..b8c811d8
--- /dev/null
+++ b/lib/win32comext/axscript/Demos/client/ie/demo_intro.htm
@@ -0,0 +1,38 @@
+<HTML>
+<BODY>
+
+<H1>
+  <MARQUEE NAME="Marquee1" DIRECTION=LEFT BEHAVIOR=SCROLL SCROLLAMOUNT=10 SCROLLDELAY=200
+  >Python ActiveX Scripting Demonstation
+  </MARQUEE> 
+</H1>
+
+<p>Congratulations on installing the Python ActiveX Scripting Engine</p>
+
+<p>Be warned that there is a <a href="http://starship.python.net/crew/mhammond/win32/PrivacyProblem.html">privacy
+concern</a> with this engine.  Please read this information, including how to disable the feature.</p>
+
+
+<H3>Object model</H3>
+<P>Except as described below, the object module exposed should be similar to that exposed
+by Visual Basic, etc.  Due to the nature of ActiveX Scripting, the details for each
+host are different, but Python should work "correctly".
+
+<P>The object model exposed via Python for MSIE is not as seamless as VB.  The biggest limitation is 
+the concept of a "local" namespace.  For example, in VB, you can
+code <code>text="Hi there"</code>, but in Python, you must code 
+<code>MyForm.ThisButton.Text="Hi There"</code>.  See the <A HREF="foo2.htm">foo2</A> sample 
+for futher details.
+
+<H3>Known bugs and problems</H3>
+<UL>
+<LI><P>This release seems to have broken Aaron's mouse-trace sample.  No idea why, and Im supposed to be looking into it.
+<LI><P>Builtin objects such as MARQUEE are giving me grief.  Objects accessed via forms are generally
+no problem.
+<LI><P>If you are trying to use Python with the Windows Scripting Host, note that
+.pys files are not correct registered - you will need to explicitely
+specify either cscript.exe or wscript.exe on the command line.
+</UL>
+
+</BODY></HTML>
+
diff --git a/lib/win32comext/axscript/Demos/client/ie/demo_menu.htm b/lib/win32comext/axscript/Demos/client/ie/demo_menu.htm
new file mode 100644
index 00000000..ba23a434
--- /dev/null
+++ b/lib/win32comext/axscript/Demos/client/ie/demo_menu.htm
@@ -0,0 +1,16 @@
+<HTML>
+<BODY>
+<H1>Scripting Demos</H1>
+<P>An <A HREF="demo_check.htm" TARGET=Body>Introduction</A> to the 
+scripting engine.
+
+<P>The <A HREF="calc.htm" TARGET=Body>Calculator Demo</A> is a very 
+cool sample written by Aaron Watters.
+
+<P><A HREF="mouseTrack.htm" TARGET=Body>Mouse track</A> is another of 
+Aaron's samples, and shows how fast the Python engine is!
+
+<P>The <A HREF="foo2.htm" TARGET=Body>foo2 sample</A> is mainly used 
+for debugging and testing, but does show some forms in action.
+
+
diff --git a/lib/win32comext/axscript/Demos/client/ie/docwrite.htm b/lib/win32comext/axscript/Demos/client/ie/docwrite.htm
new file mode 100644
index 00000000..c95b7902
--- /dev/null
+++ b/lib/win32comext/axscript/Demos/client/ie/docwrite.htm
@@ -0,0 +1,25 @@
+<HTML>
+<BODY>
+A page generated by Python
+
+<SCRIPT LANGUAGE="XXXVBScript">
+document.open()
+document.writeLn "<P>Hello from VBScript"
+document.close()
+</SCRIPT>
+
+<SCRIPT LANGUAGE="Python">
+ax.document.write("<P>Hello from Python")
+ax.document.close()
+ax.document.open()
+ax.document.write("<P>Hello again from Python")
+ax.document.close()
+
+def Window_OnLoad():
+	pass
+#	ax.document.write("<P>Hello from Load from Python")
+#	ax.document.close()
+</SCRIPT>
+
+</BODY>
+</HTML>
diff --git a/lib/win32comext/axscript/Demos/client/ie/foo2.htm b/lib/win32comext/axscript/Demos/client/ie/foo2.htm
new file mode 100644
index 00000000..d5e0c4a6
--- /dev/null
+++ b/lib/win32comext/axscript/Demos/client/ie/foo2.htm
@@ -0,0 +1,105 @@
+<HTML>
+<BODY>
+
+<SCRIPT>
+b="Hello"
+</SCRIPT>
+
+<SCRIPT LANGUAGE="Python">
+import win32traceutil
+import sys
+print "Hello"
+a="Hi there"
+print "Location is", document.location
+document.write("Hello", " from version ", 2, " of the Python AXScript Engine","<P>")
+document.writeln("This is Python", sys.version)
+
+</SCRIPT>
+
+<P>The caption on the first button is set by the Window Load code.  Clicking
+that button changes the text in the first edit box.
+
+<P>The second button changes its own text when clicked.
+
+<P>The fourth button calls a global function, defined in the global 'script' scope,
+rather than the 'MyForm' scope.
+
+<FORM NAME="MyForm" METHOD="GET">
+   <SCRIPT LANGUAGE="Python">
+print "Hello from in the form"
+   </SCRIPT>
+   <INPUT NAME="Button1" TYPE="Button" OnClick="MyForm.Text1.value='Hi'" LANGUAGE="Python">
+   <INPUT TYPE="TEXT" SIZE=25 NAME="Text1">
+   <INPUT NAME="Button2" TYPE="Button" VALUE="Click for 'Hi'" OnClick="a='Howdy'; MyForm.Button2.value='Hi'" LANGUAGE="Python">
+   <INPUT NAME="Button3" TYPE="Button" VALUE="Click for URL" OnClick="MyForm.Text2.value=document.location" LANGUAGE="Python">
+   <INPUT TYPE="TEXT" SIZE=25 NAME="Text2">
+   <INPUT NAME="Button4" TYPE="Button" VALUE="Call global fn" OnClick="foo1()" LANGUAGE="Python">
+   <INPUT NAME="Button5" TYPE="Button" VALUE="Script for... Test">
+<script for="Button5" event="onClick" language="Python">
+print "HelloThere";
+window.alert("Hello")
+def ATest():
+	print "Hello from ATEst"
+
+ATest()
+</script>
+   <INPUT NAME="Button6" TYPE="Button" VALUE="Set Other" OnClick="Form2.Text1.Value='Hi from other'" LANGUAGE="Python">
+
+</FORM><BR>
+<P>
+And here is a second form
+<P>
+<FORM NAME="Form2" METHOD="GET">
+   <INPUT NAME="Button1" TYPE="Button" OnClick="Form2.Text1.Value='Hi'" LANGUAGE="Python">
+   <INPUT NAME="Button2" TYPE="Button" VALUE="Set Other" OnClick="MyForm.Text1.Value='Hi from other'" LANGUAGE="Python">
+   <INPUT TYPE="TEXT" SIZE=25 NAME="Text1">
+   <INPUT NAME="ButRExec" TYPE="Button" VALUE="RExec fail" OnClick="import win32api;win32api.MessageBox(0,'Oops')" LANGUAGE="Python">
+   <INPUT NAME="ButRExec2" TYPE="Button" VALUE="RExec fail 2" OnClick="import sys,win32traceutil;print sys.modules;from win32com.client import dynamic;import win32com.client.dynamic, pythoncom, win32com.client;o=win32com.client.Dispatch('Word.Application')" LANGUAGE="Python">
+   <INPUT NAME="ButVB" TYPE="Button" VALUE="VBScript Button" OnClick='alert("Hi from VBScript")'>
+   <INPUT NAME="ButCallChain" TYPE="Button" VALUE="Multi-Language call" OnClick='CallPython()'>
+</FORM><BR>
+
+<SCRIPT LANGUAGE="VBScript">
+function CallPython()
+	alert("Hello from VB - Im about to call Python!")
+	PythonGlobalFunction()
+end function
+</SCRIPT>
+
+<SCRIPT LANGUAGE="JScript">
+function JScriptFunction()
+{
+  alert("Hello from JScript");
+}
+</SCRIPT>
+
+<SCRIPT LANGUAGE="Python">
+x=13
+
+def foo1():
+   y = 14
+   for name, item in globals().items():
+        print name, `item`
+   alert ("Hello from AXCode")
+   print "Y is ",y
+
+def PythonGlobalFunction():
+	window.alert("Hello from Python - Im about to call JScript!")
+	window.JScriptFunction()
+
+def Window_OnLoad():
+	print "X is", x
+	print "a is", a
+#	print "------ GLOBALS ----------"
+#	for n,v in globals().items():
+#		print n,'=',v
+	print "MyForm is", MyForm
+	print "MyForm is repr", `MyForm`
+	print "MyForm.Button1 is", `MyForm.Button1`
+	MyForm.Button1.Value = "Python Rules!"
+	Form2.Button1.value = "Form2!"
+	MyForm.Text1.value = document.location
+</SCRIPT>
+
+</BODY>
+</HTML>
diff --git a/lib/win32comext/axscript/Demos/client/ie/form.htm b/lib/win32comext/axscript/Demos/client/ie/form.htm
new file mode 100644
index 00000000..97a239f3
--- /dev/null
+++ b/lib/win32comext/axscript/Demos/client/ie/form.htm
@@ -0,0 +1,25 @@
+<HTML>
+<BODY>
+
+<FORM NAME="TestForm" METHOD="POST" >
+   <INPUT TYPE="TEXT" SIZE=25 NAME="Name">Name<br>
+   <INPUT TYPE="TEXT" SIZE=25 NAME="Address">Address<br>
+   <INPUT TYPE=SUBMIT
+</FORM>
+
+<SCRIPT LANGUAGE="Python" for="TestForm" Event="onSubmit">
+return Validate()
+</SCRIPT>
+
+<SCRIPT LANGUAGE="Python">
+
+def Validate():
+	if not TestForm.Name.Value or not TestForm.Address.Value:
+		ax.alert("You must enter a name and address.")
+		return 1
+	return 0
+
+</SCRIPT>
+
+</BODY>
+</HTML>
diff --git a/lib/win32comext/axscript/Demos/client/ie/marqueeDemo.htm b/lib/win32comext/axscript/Demos/client/ie/marqueeDemo.htm
new file mode 100644
index 00000000..33847c1d
--- /dev/null
+++ b/lib/win32comext/axscript/Demos/client/ie/marqueeDemo.htm
@@ -0,0 +1,60 @@
+<HTML>
+<HEAD>
+<base target="text">
+<TITLE> Internet Workshop </TITLE>
+</HEAD>
+<BODY leftmargin=8 bgcolor="#FFFFFF" VLINK="#666666" LINK="#FF0000">
+<FONT FACE="ARIAL,HELVETICA" SIZE="2">
+
+<P>
+<BR>
+<P><FONT FACE="ARIAL,HELVETICA" SIZE="5"><B>Marquee Demo</B></FONT>
+
+<P>
+
+
+<OBJECT 
+	ID="Marquee1" 
+ 	CLASSID="CLSID:1A4DA620-6217-11CF-BE62-0080C72EDD2D"
+	CODEBASE="/workshop/activex/gallery/ms/marquee/other/marquee.ocx#Version=4,70,0,1112"
+	TYPE="application/x-oleobject"
+	WIDTH=100% 
+	HEIGHT=80
+>
+	<PARAM NAME="szURL" VALUE="marqueeText1.htm">
+	<PARAM NAME="ScrollPixelsX" VALUE="0">
+    	<PARAM NAME="ScrollPixelsY" VALUE="-5">
+    	<PARAM NAME="ScrollDelay" VALUE="100">
+    	<PARAM NAME="Whitespace" VALUE="0">
+</OBJECT>
+
+<br> <br>
+
+<INPUT TYPE="Button" NAME="btnFaster" VALUE="Faster">
+<INPUT TYPE="Button" NAME="btnNormal" VALUE="Normal">
+<INPUT TYPE="Button" NAME="btnSlower" VALUE="Slower">
+
+<SCRIPT Language="Python">
+
+def btnFaster_Onclick():
+	ax.Marquee1.ScrollDelay = 0
+
+def btnNormal_Onclick():
+	ax.Marquee1.ScrollDelay = 50
+
+def btnSlower_Onclick():
+	ax.Marquee1.ScrollDelay = 300
+
+</SCRIPT> 
+
+
+<P>&nbsp;
+<HR>
+<B>Notes:</B>
+<P>
+
+
+</FONT>
+</BODY>
+</HTML>
+
diff --git a/lib/win32comext/axscript/Demos/client/ie/mousetrack.htm b/lib/win32comext/axscript/Demos/client/ie/mousetrack.htm
new file mode 100644
index 00000000..d307a4a6
--- /dev/null
+++ b/lib/win32comext/axscript/Demos/client/ie/mousetrack.htm
@@ -0,0 +1,83 @@
+<HTML>
+
+<HEAD><TITLE>Python Scripting sample:  Mouse tracking</TITLE></HEAD>
+<BODY BGCOLOR="#FFFFFF" TOPMARGIN=8>
+<FONT SIZE=5>
+<TABLE Border=0><TR VALIGN=MIDDLE><TD>
+<A ID="Image"> <IMG 
+SRC="file:..\..\..\..\..\win32com\html\image\pycom_blowing.gif" 
+ALT="Clickable Map Image" HEIGHT=113 WIDTH=624 BORDER=0></A>
+
+</TD></TR>
+ <TR><TD>&nbsp;</TD></TR>
+ <TR VALIGN=MIDDLE><TD VALIGN=MIDDLE ALIGN=CENTER><FONT SIZE=5><INPUT 
+TYPE="text" NAME="TxtLinkDescription" SIZE=50></FONT></TD></TR></TABLE>
+</FONT>
+
+<P>
+A mouse tracking demo.  Move the mouse over the image above...
+
+<SCRIPT Language="Python">
+<!-- 
+# Remember the last location clicked
+#print "here we go", 1
+mx = my = 0
+
+# class for rectangle testing
+class rect:
+   def __init__(self, lowx, lowy, upx, upy, desc, url):
+       self.lowx, self.lowy, self.upx, self.upy, self.desc, self.url = \
+         lowx, lowy, upx, upy, desc, url
+   def inside(self, x, y):
+#       print (x,y), "inside", self.desc,
+       result = self.lowx <= x <= self.upx and self.lowy <= y <= self.upy
+#       print result
+       return result
+   def mouse_move(self):
+#       print "move", self.desc
+       ax.TxtLinkDescription.Value = coords + " - " + self.desc
+   def onclick(self):
+#       print "click", self.desc
+       ax.TxtLinkDescription.Value = coords +" click! " + `self.url`
+       if self.url: ax.location = self.url
+
+blows = "Blows away "
+rects =[rect(12,48,59,101,blows+"Visual Basic", ""),
+	rect(107,0,172,58,blows+"Internet Explorer", ""),
+	rect(193,0,261,56,blows+"Microsoft Access", ""),
+	rect(332,43,392,93,blows+"Microsoft Word", ""),
+	rect(457,52,521,99,blows+"Microsoft Excel", ""),
+	rect(537,12,613,85,"Python blows them all away!", "http://www.python.org"),
+]
+
+default = rect(0,0,0,0,"Click on an icon","")
+
+def Image_MouseMove(s, b, x, y):
+    global mx, my, coords
+    coords =`(x,y)`
+#    print coords,
+    mx, my = x, y
+    for r in rects:
+        if r.inside(x,y):
+#           print r.desc
+           r.mouse_move()
+           break
+    else:
+#        print default.desc
+        default.mouse_move()
+
+def Image_OnClick():
+    for r in rects:
+        if r.inside(mx,my):
+           r.onclick()
+           break
+-->
+</SCRIPT>
+
+<P>
+
+</FONT>
+
+</BODY>
+</HTML>
+
diff --git a/lib/win32comext/axscript/Demos/client/ie/pycom_blowing.gif b/lib/win32comext/axscript/Demos/client/ie/pycom_blowing.gif
new file mode 100644
index 0000000000000000000000000000000000000000..0d65a2928962860cf8b675b5192a43b165f31350
GIT binary patch
literal 20926
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
Ab^rhX

literal 0
HcmV?d00001

diff --git a/lib/win32comext/axscript/Demos/client/wsh/blank.pys b/lib/win32comext/axscript/Demos/client/wsh/blank.pys
new file mode 100644
index 00000000..e69de29b
diff --git a/lib/win32comext/axscript/Demos/client/wsh/excel.pys b/lib/win32comext/axscript/Demos/client/wsh/excel.pys
new file mode 100644
index 00000000..9c8fe751
--- /dev/null
+++ b/lib/win32comext/axscript/Demos/client/wsh/excel.pys
@@ -0,0 +1,34 @@
+#app=WScript.Application
+#app._print_details_() # Use this to see what Python knows about a COM object.
+
+g_index = 1
+# A procedure, using a global.
+def Show(desc, value = None):
+	global g_index # Need global for g_index, as I locally assign.
+	# No global needed to "xl" object, as only referenced.
+	# Also note "xl" is assigned later in the script - ie, Python is very late bound.
+	xl.Cells(g_index, 1).Value = desc
+	if value: xl.Cells(g_index, 2).Value = value
+	g_index = g_index + 1
+
+xl = WScript.CreateObject("Excel.Application")
+import sys
+
+xl.Visible = 1
+#xl.Workbooks().Add() # Excel versions before 98
+xl.Workbooks.Add()
+
+# Show the WScript properties.
+Show("Application Friendly Name", WScript.Name)
+Show("Application Version", WScript.Version)
+Show("Application Context: Fully Qualified Name", WScript.FullName)
+Show("Application Context: Path Only", WScript.Path)
+Show("State of Interactive Mode", WScript.Interactive)
+
+Show("All script arguments:")
+args = WScript.Arguments
+
+for i in range(0,args.Count()):
+	Show("Arg %d" % i, args(i))
+
+
diff --git a/lib/win32comext/axscript/Demos/client/wsh/registry.pys b/lib/win32comext/axscript/Demos/client/wsh/registry.pys
new file mode 100644
index 00000000..2d9d1e77
--- /dev/null
+++ b/lib/win32comext/axscript/Demos/client/wsh/registry.pys
@@ -0,0 +1,45 @@
+""" Windows Script Host Sample Script
+' Ported to Python
+'
+' ------------------------------------------------------------------------
+'               Copyright (C) 1996 Microsoft Corporation
+'
+' You have a royalty-free right to use, modify, reproduce and distribute
+' the Sample Application Files (and/or any modified version) in any way
+' you find useful, provided that you agree that Microsoft has no warranty,
+' obligations or liability for any Sample Application Files.
+' ------------------------------------------------------------------------
+'
+' This sample demonstrates how to write/delete from the registry. 
+"""
+
+WshShell = WScript.CreateObject("WScript.Shell")
+
+WshShell.Popup("This script shows how to use registry related methods.", 2)
+
+WshShell.Popup("Create key HKCU\\Foo with value 'Top level key'")
+WshShell.RegWrite("HKCU\\Foo\\", "Top level key")
+
+WshShell.Popup("Create key HKCU\\Foo\\Bar with value 'Second level key'")
+WshShell.RegWrite( "HKCU\\Foo\\Bar\\", "Second level key")
+
+WshShell.Popup ("Set value HKCU\\Foo\\Value to REG_SZ 1")
+WshShell.RegWrite( "HKCU\\Foo\\Value", 1)
+
+WshShell.Popup ("Set value HKCU\\Foo\\Bar to REG_DWORD 2")
+WshShell.RegWrite ("HKCU\\Foo\\Bar", 2, "REG_DWORD")
+
+WshShell.Popup ("Set value HKCU\\Foo\\Bar to REG_EXPAND_SZ '3'")
+WshShell.RegWrite ("HKCU\\Foo\\Bar\\Baz", "%SystemRoot%\\Foo")
+
+WshShell.Popup ("Delete value HKCU\\Foo\\Bar\\Baz")
+WshShell.RegDelete ("HKCU\\Foo\\Bar\\Baz")
+
+WshShell.Popup ("Delete key HKCU\\Foo\\Bar")
+WshShell.RegDelete ("HKCU\\Foo\\Bar\\")
+
+WshShell.Popup ("Delete key HKCU\\Foo")
+WshShell.RegDelete ("HKCU\\Foo\\")
+
+WScript.Echo ("Done")
+
diff --git a/lib/win32comext/axscript/Demos/client/wsh/test.pys b/lib/win32comext/axscript/Demos/client/wsh/test.pys
new file mode 100644
index 00000000..4038321e
--- /dev/null
+++ b/lib/win32comext/axscript/Demos/client/wsh/test.pys
@@ -0,0 +1,15 @@
+# Testall - test core AX support.
+
+# Test "Restricted Execution" (ie, IObjectSafety).
+# This will fail if in a "restricted execution" environment, but
+# will silenty do nothing of not restricted.  This same line in an MSIE
+# script would cause an exception.
+print("Importing win32api...")
+import win32api
+if 1==1:
+	print("Hi")
+
+WScript.Echo("Hello from WScript")
+
+#fail
+
diff --git a/lib/win32comext/axscript/__init__.py b/lib/win32comext/axscript/__init__.py
new file mode 100644
index 00000000..8d5db8b9
--- /dev/null
+++ b/lib/win32comext/axscript/__init__.py
@@ -0,0 +1,4 @@
+# See if we have a special directory for the binaries (for developers)
+import win32com
+
+win32com.__PackageSupportBuildPath__(__path__)
diff --git a/lib/win32comext/axscript/asputil.py b/lib/win32comext/axscript/asputil.py
new file mode 100644
index 00000000..b61c3537
--- /dev/null
+++ b/lib/win32comext/axscript/asputil.py
@@ -0,0 +1,13 @@
+"""A utility module for ASP (Active Server Pages on MS Internet Info Server.
+
+Contains:
+	iif -- A utility function to avoid using "if" statements in ASP <% tags
+
+"""
+
+
+def iif(cond, t, f):
+    if cond:
+        return t
+    else:
+        return f
diff --git a/lib/win32comext/axscript/axscript.pyd b/lib/win32comext/axscript/axscript.pyd
new file mode 100644
index 0000000000000000000000000000000000000000..a29615a5f4f88f1ea911cc9cc16c0c211953935b
GIT binary patch
literal 93184
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
HbG-f!>`YfX

literal 0
HcmV?d00001

diff --git a/lib/win32comext/axscript/client/__init__.py b/lib/win32comext/axscript/client/__init__.py
new file mode 100644
index 00000000..7858ad6b
--- /dev/null
+++ b/lib/win32comext/axscript/client/__init__.py
@@ -0,0 +1 @@
+# This is a Python package
diff --git a/lib/win32comext/axscript/client/debug.py b/lib/win32comext/axscript/client/debug.py
new file mode 100644
index 00000000..2e305f0b
--- /dev/null
+++ b/lib/win32comext/axscript/client/debug.py
@@ -0,0 +1,240 @@
+import os
+import sys
+
+import pythoncom
+import win32api
+import win32com.client.connect
+import win32com.server.util
+import winerror
+from win32com.axdebug import adb, axdebug, contexts, documents, gateways, stackframe
+from win32com.axdebug.codecontainer import SourceCodeContainer
+from win32com.axdebug.util import _wrap, _wrap_remove
+from win32com.client.util import Enumerator
+from win32com.server.exception import COMException
+from win32com.util import IIDToInterfaceName
+
+from .framework import trace
+
+try:
+    os.environ["DEBUG_AXDEBUG"]
+    debuggingTrace = 1  # Should we print "trace" output?
+except KeyError:
+    debuggingTrace = 0
+
+
+def trace(*args):
+    """A function used instead of "print" for debugging output."""
+    if not debuggingTrace:
+        return
+    print(win32api.GetCurrentThreadId(), end=" ")
+    for arg in args:
+        print(arg, end=" ")
+    print()
+
+
+# Note that the DebugManager is not a COM gateway class for the
+# debugger - but it does create and manage them.
+class DebugManager:
+    _debugger_interfaces_ = [axdebug.IID_IActiveScriptDebug]
+
+    def __init__(self, scriptEngine):
+        self.scriptEngine = scriptEngine
+        self.adb = adb.Debugger()
+        self.rootNode = None
+        self.debugApplication = None
+        self.ccProvider = documents.CodeContainerProvider()
+        try:
+            self.scriptSiteDebug = scriptEngine.GetScriptSite(
+                axdebug.IID_IActiveScriptSiteDebug
+            )
+        except pythoncom.com_error:
+            # No debugger interface (ie, dumb host).  Do the extra work.
+            trace("Scripting site has no debugger interface")
+            self.scriptSiteDebug = None
+        # Get the debug application object.
+        self.debugApplication = None
+        if self.scriptSiteDebug is not None:
+            # Spec says that we should test for this, and if it fails revert to
+            # PDM application.
+            try:
+                self.debugApplication = self.scriptSiteDebug.GetApplication()
+                self.rootNode = self.scriptSiteDebug.GetRootApplicationNode()
+            except pythoncom.com_error:
+                self.debugApplication = None
+
+        if self.debugApplication is None:
+            # Try to get/create the default one
+            # NOTE - Dont catch exceptions here - let the parent do it,
+            # so it knows debug support is available.
+            pdm = pythoncom.CoCreateInstance(
+                axdebug.CLSID_ProcessDebugManager,
+                None,
+                pythoncom.CLSCTX_ALL,
+                axdebug.IID_IProcessDebugManager,
+            )
+            self.debugApplication = pdm.GetDefaultApplication()
+            self.rootNode = self.debugApplication.GetRootNode()
+
+        assert (
+            self.debugApplication is not None
+        ), "Need to have a DebugApplication object by now!"
+        self.activeScriptDebug = None
+
+        if self.debugApplication is not None:
+            self.adb.AttachApp(self.debugApplication, self.ccProvider)
+        self.codeContainers = {}
+        self.activeScriptDebug = _wrap(
+            ActiveScriptDebug(self, self.codeContainers), axdebug.IID_IActiveScriptDebug
+        )
+
+    def Close(self):
+        # Called by the language engine when it receives a close request
+        if self.activeScriptDebug is not None:
+            _wrap_remove(self.activeScriptDebug)
+            self.activeScriptDebug = None
+        self.scriptEngine = None
+        self.rootNode = None
+        self.debugApplication = None
+        self.scriptSiteDebug = None
+        if self.ccProvider is not None:
+            self.ccProvider.Close()
+            self.ccProvider = None
+        self.codeContainers = {}
+        if self.adb:
+            self.adb.CloseApp()
+            self.adb = None
+
+    # 		print "Close complete"
+
+    def IsAnyHost(self):
+        "Do we have _any_ debugging interfaces installed?"
+        return self.debugApplication is not None
+
+    def IsSimpleHost(self):
+        return self.scriptSiteDebug is None
+
+    def HandleRuntimeError(self):
+        """Called by the engine when a runtime error occurs.  If we have a debugger,
+        we let it know.
+
+        The result is a boolean which indicates if the error handler should call
+        IActiveScriptSite::OnScriptError()
+        """
+        # 		if self.IsAnyHost:
+        # 			site = _wrap(self, axdebug.IID_IActiveScriptSite)
+        # 			breakResume, errorResume, fCallOnError = self.debugApplication(activeScriptErrorDebug, site)
+        # Do something with these!
+        # 		else:
+        trace("HandleRuntimeError")
+        fCallOnError = 1
+        return fCallOnError
+
+    def _query_interface_for_debugger_(self, iid):
+        if iid in self._debugger_interfaces_:
+            return self.activeScriptDebug
+        trace("DebugManager QI - unknown IID", iid)
+        return 0
+
+    def OnEnterScript(self):
+        trace("OnEnterScript")
+        try:
+            1 / 0
+        except:
+            # Bit of a hack - reach into engine.
+            baseFrame = sys.exc_info()[2].tb_frame.f_back
+        self.adb.SetupAXDebugging(baseFrame)
+
+    def OnLeaveScript(self):
+        trace("OnLeaveScript")
+        self.adb.ResetAXDebugging()
+
+    def AddScriptBlock(self, codeBlock):
+        # If we dont have debugging support, dont bother.
+        cc = DebugCodeBlockContainer(codeBlock, self.scriptSiteDebug)
+        if self.IsSimpleHost():
+            document = documents.DebugDocumentText(cc)
+            document = _wrap(document, axdebug.IID_IDebugDocument)
+            provider = documents.DebugDocumentProvider(document)
+            provider = _wrap(provider, axdebug.IID_IDebugDocumentProvider)
+            cc.debugDocument = document
+            newNode = self.debugApplication.CreateApplicationNode()
+            newNode.SetDocumentProvider(provider)
+            newNode.Attach(self.rootNode)
+        else:
+            newNode = None  # Managed by smart host.
+            self.codeContainers[cc.sourceContext] = cc
+        self.ccProvider.AddCodeContainer(cc, newNode)
+
+
+class DebugCodeBlockContainer(SourceCodeContainer):
+    def __init__(self, codeBlock, site):
+        self.codeBlock = codeBlock
+        SourceCodeContainer.__init__(
+            self,
+            codeBlock.codeText,
+            codeBlock.GetFileName(),
+            codeBlock.sourceContextCookie,
+            codeBlock.startLineNumber,
+            site,
+        )
+
+    def GetName(self, dnt):
+        if dnt == axdebug.DOCUMENTNAMETYPE_APPNODE:
+            return self.codeBlock.GetDisplayName()
+        elif dnt == axdebug.DOCUMENTNAMETYPE_TITLE:
+            return self.codeBlock.GetDisplayName()
+        # 		elif dnt==axdebug.DOCUMENTNAMETYPE_FILE_TAIL:
+        # 		elif dnt==axdebug.DOCUMENTNAMETYPE_URL:
+        else:
+            raise COMException(scode=winerror.S_FALSE)
+
+
+class EnumDebugCodeContexts(gateways.EnumDebugCodeContexts):
+    def _wrap(self, ob):
+        return ob
+
+
+class ActiveScriptDebug:
+    """The class which implements the IActiveScriptDebug interface for the Active Script engine.
+
+    Only ever used by smart hosts.
+    """
+
+    _public_methods_ = [
+        "GetScriptTextAttributes",
+        "GetScriptletTextAttributes",
+        "EnumCodeContextsOfPosition",
+    ]
+    _com_interfaces_ = [axdebug.IID_IActiveScriptDebug]
+
+    def __init__(self, debugMgr, codeContainers):
+        self.debugMgr = debugMgr
+        self.scriptSiteDebug = debugMgr.scriptSiteDebug
+        self.codeContainers = codeContainers
+
+    def _Close(self):
+        self.debugMgr = None
+        self.scriptSiteDebug = None
+        self.codeContainers = {}
+
+    def _query_interface_(self, iid):
+        trace("DebuggerQI with", iid)
+        return _wrap(self.debugMgr.scriptEngine, iid)
+
+    def GetScriptTextAttributes(self, code, delim, flags):
+        container = SourceCodeContainer(code, "<Temp Code Block>")
+        return container.GetSyntaxColorAttributes()
+
+    def GetScriptletTextAttributes(self, code, delim, flags):
+        trace("GetScriptletTextAttributes", code, delim, flags)
+        container = SourceCodeContainer(code, "<Temp Code Block>")
+        return container.GetSyntaxColorAttributes()
+
+    def EnumCodeContextsOfPosition(self, context, charOffset, numChars):
+        trace("EnumCodeContextsOfPosition", context, charOffset, numChars)
+        try:
+            context = self.codeContainers[context].GetCodeContextAtPosition(charOffset)
+        except KeyError:
+            raise COMException(scode=winerror.E_UNEXPECTED)
+        enum = EnumDebugCodeContexts([context])
+        return _wrap(enum, axdebug.IID_IEnumDebugCodeContexts)
diff --git a/lib/win32comext/axscript/client/error.py b/lib/win32comext/axscript/client/error.py
new file mode 100644
index 00000000..1dfa54fa
--- /dev/null
+++ b/lib/win32comext/axscript/client/error.py
@@ -0,0 +1,273 @@
+"""Exception and error handling.
+
+ This contains the core exceptions that the implementations should raise
+ as well as the IActiveScriptError interface code.
+ 
+"""
+
+import re
+import sys
+import traceback
+
+import pythoncom
+import win32com.server.exception
+import win32com.server.util
+import winerror
+from win32com.axscript import axscript
+
+debugging = 0
+
+
+def FormatForAX(text):
+    """Format a string suitable for an AX Host"""
+    # Replace all " with ', so it works OK in HTML (ie, ASP)
+    return ExpandTabs(AddCR(text))
+
+
+def ExpandTabs(text):
+    return re.sub("\t", "    ", text)
+
+
+def AddCR(text):
+    return re.sub("\n", "\r\n", text)
+
+
+class IActiveScriptError:
+    """An implementation of IActiveScriptError
+
+    The ActiveX Scripting host calls this client whenever we report
+    an exception to it.  This interface provides the exception details
+    for the host to report to the user.
+    """
+
+    _com_interfaces_ = [axscript.IID_IActiveScriptError]
+    _public_methods_ = ["GetSourceLineText", "GetSourcePosition", "GetExceptionInfo"]
+
+    def _query_interface_(self, iid):
+        print("IActiveScriptError QI - unknown IID", iid)
+        return 0
+
+    def _SetExceptionInfo(self, exc):
+        self.exception = exc
+
+    def GetSourceLineText(self):
+        return self.exception.linetext
+
+    def GetSourcePosition(self):
+        ctx = self.exception.sourceContext
+        # Zero based in the debugger (but our columns are too!)
+        return (
+            ctx,
+            self.exception.lineno + self.exception.startLineNo - 1,
+            self.exception.colno,
+        )
+
+    def GetExceptionInfo(self):
+        return self.exception
+
+
+class AXScriptException(win32com.server.exception.COMException):
+    """A class used as a COM exception.
+
+    Note this has attributes which conform to the standard attributes
+    for COM exceptions, plus a few others specific to our IActiveScriptError
+    object.
+    """
+
+    def __init__(self, site, codeBlock, exc_type, exc_value, exc_traceback):
+        # set properties base class shares via base ctor...
+        win32com.server.exception.COMException.__init__(
+            self,
+            description="Unknown Exception",
+            scode=winerror.DISP_E_EXCEPTION,
+            source="Python ActiveX Scripting Engine",
+        )
+
+        # And my other values...
+        if codeBlock is None:
+            self.sourceContext = 0
+            self.startLineNo = 0
+        else:
+            self.sourceContext = codeBlock.sourceContextCookie
+            self.startLineNo = codeBlock.startLineNumber
+        self.linetext = ""
+
+        self.__BuildFromException(site, exc_type, exc_value, exc_traceback)
+
+    def __BuildFromException(self, site, type, value, tb):
+        if debugging:
+            import linecache
+
+            linecache.clearcache()
+        try:
+            if issubclass(type, SyntaxError):
+                self._BuildFromSyntaxError(site, value, tb)
+            else:
+                self._BuildFromOther(site, type, value, tb)
+        except:  # Error extracting traceback info!!!
+            traceback.print_exc()
+            # re-raise.
+            raise
+
+    def _BuildFromSyntaxError(self, site, exc, tb):
+        value = exc.args
+        # All syntax errors should have a message as element 0
+        try:
+            msg = value[0]
+        except:
+            msg = "Unknown Error (%s)" % (value,)
+        try:
+            (filename, lineno, offset, line) = value[1]
+            # Some of these may be None, which upsets us!
+            if offset is None:
+                offset = 0
+            if line is None:
+                line = ""
+        except:
+            msg = "Unknown"
+            lineno = 0
+            offset = 0
+            line = "Unknown"
+        self.description = FormatForAX(msg)
+        self.lineno = lineno
+        self.colno = offset - 1
+        self.linetext = ExpandTabs(line.rstrip())
+
+    def _BuildFromOther(self, site, exc_type, value, tb):
+        self.colno = -1
+        self.lineno = 0
+        if debugging:  # Full traceback if debugging.
+            list = traceback.format_exception(exc_type, value, tb)
+            self.description = ExpandTabs("".join(list))
+            return
+        # Run down the traceback list, looking for the first "<Script..>"
+        # Hide traceback above this.  In addition, keep going down
+        # looking for a "_*_" attribute, and below hide these also.
+        hide_names = [
+            "r_import",
+            "r_reload",
+            "r_open",
+        ]  # hide from these functions down in the traceback.
+        depth = None
+        tb_top = tb
+        while tb_top:
+            filename, lineno, name, line = self.ExtractTracebackInfo(tb_top, site)
+            if filename[:7] == "<Script":
+                break
+            tb_top = tb_top.tb_next
+        format_items = []
+        if tb_top:  # found one.
+            depth = 0
+            tb_look = tb_top
+            # Look down for our bottom
+            while tb_look:
+                filename, lineno, name, line = self.ExtractTracebackInfo(tb_look, site)
+                if name in hide_names:
+                    break
+                # We can report a line-number, but not a filename.  Therefore,
+                # we return the last line-number we find in one of our script
+                # blocks.
+                if filename.startswith("<Script"):
+                    self.lineno = lineno
+                    self.linetext = line
+                format_items.append((filename, lineno, name, line))
+                depth = depth + 1
+                tb_look = tb_look.tb_next
+        else:
+            depth = None
+            tb_top = tb
+
+        bits = ["Traceback (most recent call last):\n"]
+        bits.extend(traceback.format_list(format_items))
+        if exc_type == pythoncom.com_error:
+            desc = "%s (0x%x)" % (value.strerror, value.hresult)
+            if (
+                value.hresult == winerror.DISP_E_EXCEPTION
+                and value.excepinfo
+                and value.excepinfo[2]
+            ):
+                desc = value.excepinfo[2]
+            bits.append("COM Error: " + desc)
+        else:
+            bits.extend(traceback.format_exception_only(exc_type, value))
+
+        # XXX - this utf8 encoding seems bogus.  From well before py3k,
+        # we had the comment:
+        # > all items in the list are utf8 courtesy of Python magically
+        # > converting unicode to utf8 before compilation.
+        # but that is likely just confusion from early unicode days;
+        # Python isn't doing it, pywin32 probably was, so 'mbcs' would
+        # be the default encoding.  We should never hit this these days
+        # anyway, but on py3k, we *never* will, and str objects there
+        # don't have a decode method...
+        if sys.version_info < (3,):
+            for i in range(len(bits)):
+                if type(bits[i]) is str:
+                    # assert type(bits[i]) is str, type(bits[i])
+                    bits[i] = bits[i].decode("utf8")
+
+        self.description = ExpandTabs("".join(bits))
+        # Clear tracebacks etc.
+        tb = tb_top = tb_look = None
+
+    def ExtractTracebackInfo(self, tb, site):
+        import linecache
+
+        f = tb.tb_frame
+        lineno = tb.tb_lineno
+        co = f.f_code
+        filename = co.co_filename
+        name = co.co_name
+        line = linecache.getline(filename, lineno)
+        if not line:
+            try:
+                codeBlock = site.scriptCodeBlocks[filename]
+            except KeyError:
+                codeBlock = None
+            if codeBlock:
+                # Note: 'line' will now be unicode.
+                line = codeBlock.GetLineNo(lineno)
+        if line:
+            line = line.strip()
+        else:
+            line = None
+        return filename, lineno, name, line
+
+    def __repr__(self):
+        return "AXScriptException Object with description:" + self.description
+
+
+def ProcessAXScriptException(scriptingSite, debugManager, exceptionInstance):
+    """General function to handle any exception in AX code
+
+    This function creates an instance of our IActiveScriptError interface, and
+    gives it to the host, along with out exception class.  The host will
+    likely call back on the IActiveScriptError interface to get the source text
+    and other information not normally in COM exceptions.
+    """
+    # 	traceback.print_exc()
+    instance = IActiveScriptError()
+    instance._SetExceptionInfo(exceptionInstance)
+    gateway = win32com.server.util.wrap(instance, axscript.IID_IActiveScriptError)
+    if debugManager:
+        fCallOnError = debugManager.HandleRuntimeError()
+        if not fCallOnError:
+            return None
+
+    try:
+        result = scriptingSite.OnScriptError(gateway)
+    except pythoncom.com_error as details:
+        print("**OnScriptError failed:", details)
+        print("Exception description:'%s'" % (repr(exceptionInstance.description)))
+        print("Exception text:'%s'" % (repr(exceptionInstance.linetext)))
+        result = winerror.S_FALSE
+
+    if result == winerror.S_OK:
+        # If the above  returns NOERROR, it is assumed the error has been
+        # correctly registered and the value SCRIPT_E_REPORTED is returned.
+        ret = win32com.server.exception.COMException(scode=axscript.SCRIPT_E_REPORTED)
+        return ret
+    else:
+        # The error is taken to be unreported and is propagated up the call stack
+        # via the IDispatch::Invoke's EXCEPINFO parameter (hr returned is DISP_E_EXCEPTION.
+        return exceptionInstance
diff --git a/lib/win32comext/axscript/client/framework.py b/lib/win32comext/axscript/client/framework.py
new file mode 100644
index 00000000..d7b56a7c
--- /dev/null
+++ b/lib/win32comext/axscript/client/framework.py
@@ -0,0 +1,1270 @@
+"""AXScript Client Framework
+
+  This module provides a core framework for an ActiveX Scripting client.
+  Derived classes actually implement the AX Client itself, including the
+  scoping rules, etc.
+
+  There are classes defined for the engine itself, and for ScriptItems
+"""
+import re
+import sys
+
+import pythoncom  # Need simple connection point support
+import win32api
+import win32com.client.connect
+import win32com.server.util
+import winerror
+from win32com.axscript import axscript
+
+
+def RemoveCR(text):
+    # No longer just "RemoveCR" - should be renamed to
+    # FixNewlines, or something.  Idea is to fix arbitary newlines into
+    # something Python can compile...
+    return re.sub("(\r\n)|\r|(\n\r)", "\n", text)
+
+
+SCRIPTTEXT_FORCEEXECUTION = -2147483648  # 0x80000000
+SCRIPTTEXT_ISEXPRESSION = 0x00000020
+SCRIPTTEXT_ISPERSISTENT = 0x00000040
+
+from win32com.server.exception import Exception, IsCOMServerException
+
+from . import error  # ax.client.error
+
+state_map = {
+    axscript.SCRIPTSTATE_UNINITIALIZED: "SCRIPTSTATE_UNINITIALIZED",
+    axscript.SCRIPTSTATE_INITIALIZED: "SCRIPTSTATE_INITIALIZED",
+    axscript.SCRIPTSTATE_STARTED: "SCRIPTSTATE_STARTED",
+    axscript.SCRIPTSTATE_CONNECTED: "SCRIPTSTATE_CONNECTED",
+    axscript.SCRIPTSTATE_DISCONNECTED: "SCRIPTSTATE_DISCONNECTED",
+    axscript.SCRIPTSTATE_CLOSED: "SCRIPTSTATE_CLOSED",
+}
+
+
+def profile(fn, *args):
+    import profile
+
+    prof = profile.Profile()
+    try:
+        # roll on 1.6 :-)
+        # 		return prof.runcall(fn, *args)
+        return prof.runcall(*(fn,) + args)
+    finally:
+        import pstats
+
+        # Damn - really want to send this to Excel!
+        #      width, list = pstats.Stats(prof).strip_dirs().get_print_list([])
+        pstats.Stats(prof).strip_dirs().sort_stats("time").print_stats()
+
+
+class SafeOutput:
+    softspace = 1
+
+    def __init__(self, redir=None):
+        if redir is None:
+            redir = sys.stdout
+        self.redir = redir
+
+    def write(self, message):
+        try:
+            self.redir.write(message)
+        except:
+            win32api.OutputDebugString(message)
+
+    def flush(self):
+        pass
+
+    def close(self):
+        pass
+
+
+# Make sure we have a valid sys.stdout/stderr, otherwise out
+# print and trace statements may raise an exception
+def MakeValidSysOuts():
+    if not isinstance(sys.stdout, SafeOutput):
+        sys.stdout = sys.stderr = SafeOutput()
+        # and for the sake of working around something I can't understand...
+        # prevent keyboard interrupts from killing IIS
+        import signal
+
+        def noOp(a, b):
+            # it would be nice to get to the bottom of this, so a warning to
+            # the debug console can't hurt.
+            print("WARNING: Ignoring keyboard interrupt from ActiveScripting engine")
+
+        # If someone else has already redirected, then assume they know what they are doing!
+        if signal.getsignal(signal.SIGINT) == signal.default_int_handler:
+            try:
+                signal.signal(signal.SIGINT, noOp)
+            except ValueError:
+                # Not the main thread - can't do much.
+                pass
+
+
+def trace(*args):
+    """A function used instead of "print" for debugging output."""
+    for arg in args:
+        print(arg, end=" ")
+    print()
+
+
+def RaiseAssert(scode, desc):
+    """A debugging function that raises an exception considered an "Assertion"."""
+    print("**************** ASSERTION FAILED *******************")
+    print(desc)
+    raise Exception(desc, scode)
+
+
+class AXScriptCodeBlock:
+    """An object which represents a chunk of code in an AX Script"""
+
+    def __init__(self, name, codeText, sourceContextCookie, startLineNumber, flags):
+        self.name = name
+        self.codeText = codeText
+        self.codeObject = None
+        self.sourceContextCookie = sourceContextCookie
+        self.startLineNumber = startLineNumber
+        self.flags = flags
+        self.beenExecuted = 0
+
+    def GetFileName(self):
+        # Gets the "file name" for Python - uses <...> so Python doesnt think
+        # it is a real file.
+        return "<%s>" % self.name
+
+    def GetDisplayName(self):
+        return self.name
+
+    def GetLineNo(self, no):
+        pos = -1
+        for i in range(no - 1):
+            pos = self.codeText.find("\n", pos + 1)
+            if pos == -1:
+                pos = len(self.codeText)
+        epos = self.codeText.find("\n", pos + 1)
+        if epos == -1:
+            epos = len(self.codeText)
+        return self.codeText[pos + 1 : epos].strip()
+
+
+class Event:
+    """A single event for a ActiveX named object."""
+
+    def __init__(self):
+        self.name = "<None>"
+
+    def __repr__(self):
+        return "<%s at %d: %s>" % (self.__class__.__name__, id(self), self.name)
+
+    def Reset(self):
+        pass
+
+    def Close(self):
+        pass
+
+    def Build(self, typeinfo, funcdesc):
+        self.dispid = funcdesc[0]
+        self.name = typeinfo.GetNames(self.dispid)[0]
+
+
+# 		print "Event.Build() - Event Name is ", self.name
+
+
+class EventSink:
+    """A set of events against an item.  Note this is a COM client for connection points."""
+
+    _public_methods_ = []
+
+    def __init__(self, myItem, coDispatch):
+        self.events = {}
+        self.connection = None
+        self.coDispatch = coDispatch
+        self.myScriptItem = myItem
+        self.myInvokeMethod = myItem.GetEngine().ProcessScriptItemEvent
+        self.iid = None
+
+    def Reset(self):
+        self.Disconnect()
+
+    def Close(self):
+        self.iid = None
+        self.myScriptItem = None
+        self.myInvokeMethod = None
+        self.coDispatch = None
+        for event in self.events.values():
+            event.Reset()
+        self.events = {}
+        self.Disconnect()
+
+    # COM Connection point methods.
+    def _query_interface_(self, iid):
+        if iid == self.iid:
+            return win32com.server.util.wrap(self)
+
+    def _invoke_(self, dispid, lcid, wFlags, args):
+        try:
+            event = self.events[dispid]
+        except:
+            raise Exception(scode=winerror.DISP_E_MEMBERNOTFOUND)
+        # print "Invoke for ", event, "on", self.myScriptItem, " - calling",  self.myInvokeMethod
+        return self.myInvokeMethod(self.myScriptItem, event, lcid, wFlags, args)
+
+    def GetSourceTypeInfo(self, typeinfo):
+        """Gets the typeinfo for the Source Events for the passed typeinfo"""
+        attr = typeinfo.GetTypeAttr()
+        cFuncs = attr[6]
+        typeKind = attr[5]
+        if typeKind not in [pythoncom.TKIND_COCLASS, pythoncom.TKIND_INTERFACE]:
+            RaiseAssert(
+                winerror.E_UNEXPECTED, "The typeKind of the object is unexpected"
+            )
+        cImplType = attr[8]
+        for i in range(cImplType):
+            # Look for the [source, default] interface on the coclass
+            # that isn't marked as restricted.
+            flags = typeinfo.GetImplTypeFlags(i)
+            flagsNeeded = (
+                pythoncom.IMPLTYPEFLAG_FDEFAULT | pythoncom.IMPLTYPEFLAG_FSOURCE
+            )
+            if (flags & (flagsNeeded | pythoncom.IMPLTYPEFLAG_FRESTRICTED)) == (
+                flagsNeeded
+            ):
+                # Get the handle to the implemented interface.
+                href = typeinfo.GetRefTypeOfImplType(i)
+                return typeinfo.GetRefTypeInfo(href)
+
+    def BuildEvents(self):
+        # See if it is an extender object.
+        try:
+            mainTypeInfo = self.coDispatch.QueryInterface(
+                axscript.IID_IProvideMultipleClassInfo
+            )
+            isMulti = 1
+            numTypeInfos = mainTypeInfo.GetMultiTypeInfoCount()
+        except pythoncom.com_error:
+            isMulti = 0
+            numTypeInfos = 1
+            try:
+                mainTypeInfo = self.coDispatch.QueryInterface(
+                    pythoncom.IID_IProvideClassInfo
+                )
+            except pythoncom.com_error:
+                numTypeInfos = 0
+        # Create an event handler for the item.
+        for item in range(numTypeInfos):
+            if isMulti:
+                typeinfo, flags = mainTypeInfo.GetInfoOfIndex(
+                    item, axscript.MULTICLASSINFO_GETTYPEINFO
+                )
+            else:
+                typeinfo = mainTypeInfo.GetClassInfo()
+            sourceType = self.GetSourceTypeInfo(typeinfo)
+            cFuncs = 0
+            if sourceType:
+                attr = sourceType.GetTypeAttr()
+                self.iid = attr[0]
+                cFuncs = attr[6]
+                for i in range(cFuncs):
+                    funcdesc = sourceType.GetFuncDesc(i)
+                    event = Event()
+                    event.Build(sourceType, funcdesc)
+                    self.events[event.dispid] = event
+
+    def Connect(self):
+        if self.connection is not None or self.iid is None:
+            return
+        # 		trace("Connect for sink item", self.myScriptItem.name, "with IID",str(self.iid))
+        self.connection = win32com.client.connect.SimpleConnection(
+            self.coDispatch, self, self.iid
+        )
+
+    def Disconnect(self):
+        if self.connection:
+            try:
+                self.connection.Disconnect()
+            except pythoncom.com_error:
+                pass  # Ignore disconnection errors.
+            self.connection = None
+
+
+class ScriptItem:
+    """An item (or subitem) that is exposed to the ActiveX script"""
+
+    def __init__(self, parentItem, name, dispatch, flags):
+        self.parentItem = parentItem
+        self.dispatch = dispatch
+        self.name = name
+        self.flags = flags
+        self.eventSink = None
+        self.subItems = {}
+        self.createdConnections = 0
+        self.isRegistered = 0
+
+    # 		trace("Creating ScriptItem", name, "of parent", parentItem,"with dispatch", dispatch)
+
+    def __repr__(self):
+        flagsDesc = ""
+        if self.flags is not None and self.flags & axscript.SCRIPTITEM_GLOBALMEMBERS:
+            flagsDesc = "/Global"
+        return "<%s at %d: %s%s>" % (
+            self.__class__.__name__,
+            id(self),
+            self.name,
+            flagsDesc,
+        )
+
+    def _dump_(self, level):
+        flagDescs = []
+        if self.flags is not None and self.flags & axscript.SCRIPTITEM_GLOBALMEMBERS:
+            flagDescs.append("GLOBAL!")
+        if self.flags is None or self.flags & axscript.SCRIPTITEM_ISVISIBLE == 0:
+            flagDescs.append("NOT VISIBLE")
+        if self.flags is not None and self.flags & axscript.SCRIPTITEM_ISSOURCE:
+            flagDescs.append("EVENT SINK")
+        if self.flags is not None and self.flags & axscript.SCRIPTITEM_CODEONLY:
+            flagDescs.append("CODE ONLY")
+        print(" " * level, "Name=", self.name, ", flags=", "/".join(flagDescs), self)
+        for subItem in self.subItems.values():
+            subItem._dump_(level + 1)
+
+    def Reset(self):
+        self.Disconnect()
+        if self.eventSink:
+            self.eventSink.Reset()
+        self.isRegistered = 0
+        for subItem in self.subItems.values():
+            subItem.Reset()
+
+    def Close(self):
+        self.Reset()
+        self.dispatch = None
+        self.parentItem = None
+        if self.eventSink:
+            self.eventSink.Close()
+            self.eventSink = None
+        for subItem in self.subItems.values():
+            subItem.Close()
+        self.subItems = []
+        self.createdConnections = 0
+
+    def Register(self):
+        if self.isRegistered:
+            return
+        # Get the type info to use to build this item.
+        # 		if not self.dispatch:
+        # 			id = self.parentItem.dispatch.GetIDsOfNames(self.name)
+        # 			print "DispID of me is", id
+        # 			result = self.parentItem.dispatch.Invoke(id, 0, pythoncom.DISPATCH_PROPERTYGET,1)
+        # 			if type(result)==pythoncom.TypeIIDs[pythoncom.IID_IDispatch]:
+        # 				self.dispatch = result
+        # 			else:
+        # 				print "*** No dispatch"
+        # 				return
+        # 			print "**** Made dispatch"
+        self.isRegistered = 1
+        # Register the sub-items.
+        for item in self.subItems.values():
+            if not item.isRegistered:
+                item.Register()
+
+    def IsGlobal(self):
+        return self.flags & axscript.SCRIPTITEM_GLOBALMEMBERS
+
+    def IsVisible(self):
+        return (
+            self.flags & (axscript.SCRIPTITEM_ISVISIBLE | axscript.SCRIPTITEM_ISSOURCE)
+        ) != 0
+
+    def GetEngine(self):
+        item = self
+        while item.parentItem.__class__ == self.__class__:
+            item = item.parentItem
+        return item.parentItem
+
+    def _GetFullItemName(self):
+        ret = self.name
+        if self.parentItem:
+            try:
+                ret = self.parentItem._GetFullItemName() + "." + ret
+            except AttributeError:
+                pass
+        return ret
+
+    def GetSubItemClass(self):
+        return self.__class__
+
+    def GetSubItem(self, name):
+        return self.subItems[name.lower()]
+
+    def GetCreateSubItem(self, parentItem, name, dispatch, flags):
+        keyName = name.lower()
+        try:
+            rc = self.subItems[keyName]
+            # No changes allowed to existing flags.
+            if not rc.flags is None and not flags is None and rc.flags != flags:
+                raise Exception(scode=winerror.E_INVALIDARG)
+            # Existing item must not have a dispatch.
+            if not rc.dispatch is None and not dispatch is None:
+                raise Exception(scode=winerror.E_INVALIDARG)
+            rc.flags = flags  # Setup the real flags.
+            rc.dispatch = dispatch
+        except KeyError:
+            rc = self.subItems[keyName] = self.GetSubItemClass()(
+                parentItem, name, dispatch, flags
+            )
+        return rc
+
+    # 		if self.dispatch is None:
+    # 			RaiseAssert(winerror.E_UNEXPECTED, "??")
+
+    def CreateConnections(self):
+        # Create (but do not connect to) the connection points.
+        if self.createdConnections:
+            return
+        self.createdConnections = 1
+        # Nothing to do unless this is an event source
+        # This flags means self, _and_ children, are connectable.
+        if self.flags & axscript.SCRIPTITEM_ISSOURCE:
+            self.BuildEvents()
+            self.FindBuildSubItemEvents()
+
+    def Connect(self):
+        # Connect to the already created connection points.
+        if self.eventSink:
+            self.eventSink.Connect()
+        for subItem in self.subItems.values():
+            subItem.Connect()
+
+    def Disconnect(self):
+        # Disconnect from the connection points.
+        if self.eventSink:
+            self.eventSink.Disconnect()
+        for subItem in self.subItems.values():
+            subItem.Disconnect()
+
+    def BuildEvents(self):
+        if self.eventSink is not None or self.dispatch is None:
+            RaiseAssert(
+                winerror.E_UNEXPECTED,
+                "Item already has built events, or no dispatch available?",
+            )
+
+        # 		trace("BuildEvents for named item", self._GetFullItemName())
+        self.eventSink = EventSink(self, self.dispatch)
+        self.eventSink.BuildEvents()
+
+    def FindBuildSubItemEvents(self):
+        # Called during connection to event source.  Seeks out and connects to
+        # all children.  As per the AX spec, this is not recursive
+        # (ie, children sub-items are not seeked)
+        try:
+            multiTypeInfo = self.dispatch.QueryInterface(
+                axscript.IID_IProvideMultipleClassInfo
+            )
+            numTypeInfos = multiTypeInfo.GetMultiTypeInfoCount()
+        except pythoncom.com_error:
+            return
+        for item in range(numTypeInfos):
+            typeinfo, flags = multiTypeInfo.GetInfoOfIndex(
+                item, axscript.MULTICLASSINFO_GETTYPEINFO
+            )
+            defaultType = self.GetDefaultSourceTypeInfo(typeinfo)
+            index = 0
+            while 1:
+                try:
+                    fdesc = defaultType.GetFuncDesc(index)
+                except pythoncom.com_error:
+                    break  # No more funcs
+                index = index + 1
+                dispid = fdesc[0]
+                funckind = fdesc[3]
+                invkind = fdesc[4]
+                elemdesc = fdesc[8]
+                funcflags = fdesc[9]
+                try:
+                    isSubObject = (
+                        not (funcflags & pythoncom.FUNCFLAG_FRESTRICTED)
+                        and funckind == pythoncom.FUNC_DISPATCH
+                        and invkind == pythoncom.INVOKE_PROPERTYGET
+                        and elemdesc[0][0] == pythoncom.VT_PTR
+                        and elemdesc[0][1][0] == pythoncom.VT_USERDEFINED
+                    )
+                except:
+                    isSubObject = 0
+                if isSubObject:
+                    try:
+                        # We found a sub-object.
+                        names = typeinfo.GetNames(dispid)
+                        result = self.dispatch.Invoke(
+                            dispid, 0x0, pythoncom.DISPATCH_PROPERTYGET, 1
+                        )
+                        # IE has an interesting problem - there are lots of synonyms for the same object.  Eg
+                        # in a simple form, "window.top", "window.window", "window.parent", "window.self"
+                        # all refer to the same object.  Our event implementation code does not differentiate
+                        # eg, "window_onload" will fire for *all* objects named "window".  Thus,
+                        # "window" and "window.window" will fire the same event handler :(
+                        # One option would be to check if the sub-object is indeed the
+                        # parent object - however, this would stop "top_onload" from firing,
+                        # as no event handler for "top" would work.
+                        # I think we simply need to connect to a *single* event handler.
+                        # As use in IE is deprecated, I am not solving this now.
+                        if type(result) == pythoncom.TypeIIDs[pythoncom.IID_IDispatch]:
+                            name = names[0]
+                            subObj = self.GetCreateSubItem(
+                                self, name, result, axscript.SCRIPTITEM_ISVISIBLE
+                            )
+                            # print "subobj", name, "flags are", subObj.flags, "mydisp=", self.dispatch, "result disp=", result, "compare=", self.dispatch==result
+                            subObj.BuildEvents()
+                            subObj.Register()
+                    except pythoncom.com_error:
+                        pass
+
+    def GetDefaultSourceTypeInfo(self, typeinfo):
+        """Gets the typeinfo for the Default Dispatch for the passed typeinfo"""
+        attr = typeinfo.GetTypeAttr()
+        cFuncs = attr[6]
+        typeKind = attr[5]
+        if typeKind not in [pythoncom.TKIND_COCLASS, pythoncom.TKIND_INTERFACE]:
+            RaiseAssert(
+                winerror.E_UNEXPECTED, "The typeKind of the object is unexpected"
+            )
+        cImplType = attr[8]
+        for i in range(cImplType):
+            # Look for the [source, default] interface on the coclass
+            # that isn't marked as restricted.
+            flags = typeinfo.GetImplTypeFlags(i)
+            if (
+                flags
+                & (
+                    pythoncom.IMPLTYPEFLAG_FDEFAULT
+                    | pythoncom.IMPLTYPEFLAG_FSOURCE
+                    | pythoncom.IMPLTYPEFLAG_FRESTRICTED
+                )
+            ) == pythoncom.IMPLTYPEFLAG_FDEFAULT:
+                # Get the handle to the implemented interface.
+                href = typeinfo.GetRefTypeOfImplType(i)
+                defTypeInfo = typeinfo.GetRefTypeInfo(href)
+                attr = defTypeInfo.GetTypeAttr()
+                typeKind = attr[5]
+                typeFlags = attr[11]
+                if (
+                    typeKind == pythoncom.TKIND_INTERFACE
+                    and typeFlags & pythoncom.TYPEFLAG_FDUAL
+                ):
+                    # Get corresponding Disp interface
+                    # -1 is a special value which does this for us.
+                    href = typeinfo.GetRefTypeOfImplType(-1)
+                    return defTypeInfo.GetRefTypeInfo(href)
+                else:
+                    return defTypeInfo
+
+
+IActiveScriptMethods = [
+    "SetScriptSite",
+    "GetScriptSite",
+    "SetScriptState",
+    "GetScriptState",
+    "Close",
+    "AddNamedItem",
+    "AddTypeLib",
+    "GetScriptDispatch",
+    "GetCurrentScriptThreadID",
+    "GetScriptThreadID",
+    "GetScriptThreadState",
+    "InterruptScriptThread",
+    "Clone",
+]
+IActiveScriptParseMethods = ["InitNew", "AddScriptlet", "ParseScriptText"]
+IObjectSafetyMethods = ["GetInterfaceSafetyOptions", "SetInterfaceSafetyOptions"]
+
+# ActiveScriptParseProcedure is a new interface with IIS4/IE4.
+IActiveScriptParseProcedureMethods = ["ParseProcedureText"]
+
+
+class COMScript:
+    """An ActiveX Scripting engine base class.
+
+    This class implements the required COM interfaces for ActiveX scripting.
+    """
+
+    _public_methods_ = (
+        IActiveScriptMethods
+        + IActiveScriptParseMethods
+        + IObjectSafetyMethods
+        + IActiveScriptParseProcedureMethods
+    )
+    _com_interfaces_ = [
+        axscript.IID_IActiveScript,
+        axscript.IID_IActiveScriptParse,
+        axscript.IID_IObjectSafety,
+    ]  # , axscript.IID_IActiveScriptParseProcedure]
+
+    def __init__(self):
+        # Make sure we can print/trace wihout an exception!
+        MakeValidSysOuts()
+        # 		trace("AXScriptEngine object created", self)
+        self.baseThreadId = -1
+        self.debugManager = None
+        self.threadState = axscript.SCRIPTTHREADSTATE_NOTINSCRIPT
+        self.scriptState = axscript.SCRIPTSTATE_UNINITIALIZED
+        self.scriptSite = None
+        self.safetyOptions = 0
+        self.lcid = 0
+        self.subItems = {}
+        self.scriptCodeBlocks = {}
+
+    def _query_interface_(self, iid):
+        if self.debugManager:
+            return self.debugManager._query_interface_for_debugger_(iid)
+        # 		trace("ScriptEngine QI - unknown IID", iid)
+        return 0
+
+    # IActiveScriptParse
+    def InitNew(self):
+        if self.scriptSite is not None:
+            self.SetScriptState(axscript.SCRIPTSTATE_INITIALIZED)
+
+    def AddScriptlet(
+        self,
+        defaultName,
+        code,
+        itemName,
+        subItemName,
+        eventName,
+        delimiter,
+        sourceContextCookie,
+        startLineNumber,
+    ):
+        # 		trace ("AddScriptlet", defaultName, code, itemName, subItemName, eventName, delimiter, sourceContextCookie, startLineNumber)
+        self.DoAddScriptlet(
+            defaultName,
+            code,
+            itemName,
+            subItemName,
+            eventName,
+            delimiter,
+            sourceContextCookie,
+            startLineNumber,
+        )
+
+    def ParseScriptText(
+        self,
+        code,
+        itemName,
+        context,
+        delimiter,
+        sourceContextCookie,
+        startLineNumber,
+        flags,
+        bWantResult,
+    ):
+        # 		trace ("ParseScriptText", code[:20],"...", itemName, context, delimiter, sourceContextCookie, startLineNumber, flags, bWantResult)
+        if (
+            bWantResult
+            or self.scriptState == axscript.SCRIPTSTATE_STARTED
+            or self.scriptState == axscript.SCRIPTSTATE_CONNECTED
+            or self.scriptState == axscript.SCRIPTSTATE_DISCONNECTED
+        ):
+            flags = flags | SCRIPTTEXT_FORCEEXECUTION
+        else:
+            flags = flags & (~SCRIPTTEXT_FORCEEXECUTION)
+
+        if flags & SCRIPTTEXT_FORCEEXECUTION:
+            # About to execute the code.
+            self.RegisterNewNamedItems()
+        return self.DoParseScriptText(
+            code, sourceContextCookie, startLineNumber, bWantResult, flags
+        )
+
+    #
+    # IActiveScriptParseProcedure
+    def ParseProcedureText(
+        self,
+        code,
+        formalParams,
+        procName,
+        itemName,
+        unkContext,
+        delimiter,
+        contextCookie,
+        startingLineNumber,
+        flags,
+    ):
+        trace(
+            "ParseProcedureText",
+            code,
+            formalParams,
+            procName,
+            itemName,
+            unkContext,
+            delimiter,
+            contextCookie,
+            startingLineNumber,
+            flags,
+        )
+        # NOTE - this is never called, as we have disabled this interface.
+        # Problem is, once enabled all even code comes via here, rather than AddScriptlet.
+        # However, the "procName" is always an empty string - ie, itemName is the object whose event we are handling,
+        # but no idea what the specific event is!?
+        # Problem is disabling this block is that AddScriptlet is _not_ passed
+        # <SCRIPT for="whatever" event="onClick" language="Python">
+        # (but even for those blocks, the "onClick" information is still missing!?!?!?)
+
+        # 		self.DoAddScriptlet(None, code, itemName, subItemName, eventName, delimiter,sourceContextCookie, startLineNumber)
+        return None
+
+    #
+    # IActiveScript
+    def SetScriptSite(self, site):
+        # We should still work with an existing site (or so MSXML believes :)
+        self.scriptSite = site
+        if self.debugManager is not None:
+            self.debugManager.Close()
+        import traceback
+
+        try:
+            import win32com.axdebug.axdebug  # see if the core exists.
+
+            from . import debug
+
+            self.debugManager = debug.DebugManager(self)
+        except pythoncom.com_error:
+            # COM errors will occur if the debugger interface has never been
+            # seen on the target system
+            trace("Debugging interfaces not available - debugging is disabled..")
+            self.debugManager = None
+        except ImportError:
+            trace(
+                "Debugging extensions (axdebug) module does not exist - debugging is disabled.."
+            )
+            self.debugManager = None
+        except:
+            traceback.print_exc()
+            trace(
+                "*** Debugger Manager could not initialize - %s: %s"
+                % (sys.exc_info()[0], sys.exc_info()[1])
+            )
+            self.debugManager = None
+
+        try:
+            self.lcid = site.GetLCID()
+        except pythoncom.com_error:
+            self.lcid = win32api.GetUserDefaultLCID()
+        self.Reset()
+
+    def GetScriptSite(self, iid):
+        if self.scriptSite is None:
+            raise Exception(scode=winerror.S_FALSE)
+        return self.scriptSite.QueryInterface(iid)
+
+    def SetScriptState(self, state):
+        # print "SetScriptState with %s - currentstate = %s" % (state_map.get(state),state_map.get(self.scriptState))
+        if state == self.scriptState:
+            return
+        # If closed, allow no other state transitions
+        if self.scriptState == axscript.SCRIPTSTATE_CLOSED:
+            raise Exception(scode=winerror.E_INVALIDARG)
+
+        if state == axscript.SCRIPTSTATE_INITIALIZED:
+            # Re-initialize - shutdown then reset.
+            if self.scriptState in [
+                axscript.SCRIPTSTATE_CONNECTED,
+                axscript.SCRIPTSTATE_STARTED,
+            ]:
+                self.Stop()
+        elif state == axscript.SCRIPTSTATE_STARTED:
+            if self.scriptState == axscript.SCRIPTSTATE_CONNECTED:
+                self.Disconnect()
+            if self.scriptState == axscript.SCRIPTSTATE_DISCONNECTED:
+                self.Reset()
+            self.Run()
+            self.ChangeScriptState(axscript.SCRIPTSTATE_STARTED)
+        elif state == axscript.SCRIPTSTATE_CONNECTED:
+            if self.scriptState in [
+                axscript.SCRIPTSTATE_UNINITIALIZED,
+                axscript.SCRIPTSTATE_INITIALIZED,
+            ]:
+                self.ChangeScriptState(
+                    axscript.SCRIPTSTATE_STARTED
+                )  # report transition through started
+                self.Run()
+            if self.scriptState == axscript.SCRIPTSTATE_STARTED:
+                self.Connect()
+                self.ChangeScriptState(state)
+        elif state == axscript.SCRIPTSTATE_DISCONNECTED:
+            if self.scriptState == axscript.SCRIPTSTATE_CONNECTED:
+                self.Disconnect()
+        elif state == axscript.SCRIPTSTATE_CLOSED:
+            self.Close()
+        elif state == axscript.SCRIPTSTATE_UNINITIALIZED:
+            if self.scriptState == axscript.SCRIPTSTATE_STARTED:
+                self.Stop()
+            if self.scriptState == axscript.SCRIPTSTATE_CONNECTED:
+                self.Disconnect()
+            if self.scriptState == axscript.SCRIPTSTATE_DISCONNECTED:
+                self.Reset()
+            self.ChangeScriptState(state)
+        else:
+            raise Exception(scode=winerror.E_INVALIDARG)
+
+    def GetScriptState(self):
+        return self.scriptState
+
+    def Close(self):
+        # 		trace("Close")
+        if self.scriptState in [
+            axscript.SCRIPTSTATE_CONNECTED,
+            axscript.SCRIPTSTATE_DISCONNECTED,
+        ]:
+            self.Stop()
+        if self.scriptState in [
+            axscript.SCRIPTSTATE_CONNECTED,
+            axscript.SCRIPTSTATE_DISCONNECTED,
+            axscript.SCRIPTSTATE_INITIALIZED,
+            axscript.SCRIPTSTATE_STARTED,
+        ]:
+            pass  # engine.close??
+        if self.scriptState in [
+            axscript.SCRIPTSTATE_UNINITIALIZED,
+            axscript.SCRIPTSTATE_CONNECTED,
+            axscript.SCRIPTSTATE_DISCONNECTED,
+            axscript.SCRIPTSTATE_INITIALIZED,
+            axscript.SCRIPTSTATE_STARTED,
+        ]:
+            self.ChangeScriptState(axscript.SCRIPTSTATE_CLOSED)
+            # Completely reset all named items (including persistent)
+            for item in self.subItems.values():
+                item.Close()
+            self.subItems = {}
+            self.baseThreadId = -1
+        if self.debugManager:
+            self.debugManager.Close()
+            self.debugManager = None
+        self.scriptSite = None
+        self.scriptCodeBlocks = {}
+        self.persistLoaded = 0
+
+    def AddNamedItem(self, name, flags):
+        if self.scriptSite is None:
+            raise Exception(scode=winerror.E_INVALIDARG)
+        try:
+            unknown = self.scriptSite.GetItemInfo(name, axscript.SCRIPTINFO_IUNKNOWN)[0]
+            dispatch = unknown.QueryInterface(pythoncom.IID_IDispatch)
+        except pythoncom.com_error:
+            raise Exception(
+                scode=winerror.E_NOINTERFACE,
+                desc="Object has no dispatch interface available.",
+            )
+        newItem = self.subItems[name] = self.GetNamedItemClass()(
+            self, name, dispatch, flags
+        )
+        if newItem.IsGlobal():
+            newItem.CreateConnections()
+
+    def GetScriptDispatch(self, name):
+        # Base classes should override.
+        raise Exception(scode=winerror.E_NOTIMPL)
+
+    def GetCurrentScriptThreadID(self):
+        return self.baseThreadId
+
+    def GetScriptThreadID(self, win32ThreadId):
+        if self.baseThreadId == -1:
+            raise Exception(scode=winerror.E_UNEXPECTED)
+        if self.baseThreadId != win32ThreadId:
+            raise Exception(scode=winerror.E_INVALIDARG)
+        return self.baseThreadId
+
+    def GetScriptThreadState(self, scriptThreadId):
+        if self.baseThreadId == -1:
+            raise Exception(scode=winerror.E_UNEXPECTED)
+        if scriptThreadId != self.baseThreadId:
+            raise Exception(scode=winerror.E_INVALIDARG)
+        return self.threadState
+
+    def AddTypeLib(self, uuid, major, minor, flags):
+        # Get the win32com gencache to register this library.
+        from win32com.client import gencache
+
+        gencache.EnsureModule(uuid, self.lcid, major, minor, bForDemand=1)
+
+    # This is never called by the C++ framework - it does magic.
+    # See PyGActiveScript.cpp
+    # def InterruptScriptThread(self, stidThread, exc_info, flags):
+    # 	raise Exception("Not Implemented", scode=winerror.E_NOTIMPL)
+
+    def Clone(self):
+        raise Exception("Not Implemented", scode=winerror.E_NOTIMPL)
+
+    #
+    # IObjectSafety
+
+    # Note that IE seems to insist we say we support all the flags, even tho
+    # we dont accept them all.  If unknown flags come in, they are ignored, and never
+    # reflected in GetInterfaceSafetyOptions and the QIs obviously fail, but still IE
+    # allows our engine to initialize.
+    def SetInterfaceSafetyOptions(self, iid, optionsMask, enabledOptions):
+        # 		trace ("SetInterfaceSafetyOptions", iid, optionsMask, enabledOptions)
+        if optionsMask & enabledOptions == 0:
+            return
+
+        # See comments above.
+        # 		if (optionsMask & enabledOptions & \
+        # 			~(axscript.INTERFACESAFE_FOR_UNTRUSTED_DATA | axscript.INTERFACESAFE_FOR_UNTRUSTED_CALLER)):
+        # 			# request for options we don't understand
+        # 			RaiseAssert(scode=winerror.E_FAIL, desc="Unknown safety options")
+
+        if iid in [
+            pythoncom.IID_IPersist,
+            pythoncom.IID_IPersistStream,
+            pythoncom.IID_IPersistStreamInit,
+            axscript.IID_IActiveScript,
+            axscript.IID_IActiveScriptParse,
+        ]:
+            supported = self._GetSupportedInterfaceSafetyOptions()
+            self.safetyOptions = supported & optionsMask & enabledOptions
+        else:
+            raise Exception(scode=winerror.E_NOINTERFACE)
+
+    def _GetSupportedInterfaceSafetyOptions(self):
+        return 0
+
+    def GetInterfaceSafetyOptions(self, iid):
+        if iid in [
+            pythoncom.IID_IPersist,
+            pythoncom.IID_IPersistStream,
+            pythoncom.IID_IPersistStreamInit,
+            axscript.IID_IActiveScript,
+            axscript.IID_IActiveScriptParse,
+        ]:
+            supported = self._GetSupportedInterfaceSafetyOptions()
+            return supported, self.safetyOptions
+        else:
+            raise Exception(scode=winerror.E_NOINTERFACE)
+
+    #
+    # Other helpers.
+    def ExecutePendingScripts(self):
+        self.RegisterNewNamedItems()
+        self.DoExecutePendingScripts()
+
+    def ProcessScriptItemEvent(self, item, event, lcid, wFlags, args):
+        # 		trace("ProcessScriptItemEvent", item, event, lcid, wFlags, args)
+        self.RegisterNewNamedItems()
+        return self.DoProcessScriptItemEvent(item, event, lcid, wFlags, args)
+
+    def _DumpNamedItems_(self):
+        for item in self.subItems.values():
+            item._dump_(0)
+
+    def ResetNamedItems(self):
+        # Due to the way we work, we re-create persistent ones.
+        existing = self.subItems
+        self.subItems = {}
+        for name, item in existing.items():
+            item.Close()
+            if item.flags & axscript.SCRIPTITEM_ISPERSISTENT:
+                self.AddNamedItem(item.name, item.flags)
+
+    def GetCurrentSafetyOptions(self):
+        return self.safetyOptions
+
+    def ProcessNewNamedItemsConnections(self):
+        # Process all sub-items.
+        for item in self.subItems.values():
+            if not item.createdConnections:  # Fast-track!
+                item.CreateConnections()
+
+    def RegisterNewNamedItems(self):
+        # Register all sub-items.
+        for item in self.subItems.values():
+            if not item.isRegistered:  # Fast-track!
+                self.RegisterNamedItem(item)
+
+    def RegisterNamedItem(self, item):
+        item.Register()
+
+    def CheckConnectedOrDisconnected(self):
+        if self.scriptState in [
+            axscript.SCRIPTSTATE_CONNECTED,
+            axscript.SCRIPTSTATE_DISCONNECTED,
+        ]:
+            return
+        RaiseAssert(
+            winerror.E_UNEXPECTED,
+            "Not connected or disconnected - %d" % self.scriptState,
+        )
+
+    def Connect(self):
+        self.ProcessNewNamedItemsConnections()
+        self.RegisterNewNamedItems()
+        self.ConnectEventHandlers()
+
+    def Run(self):
+        # 		trace("AXScript running...")
+        if (
+            self.scriptState != axscript.SCRIPTSTATE_INITIALIZED
+            and self.scriptState != axscript.SCRIPTSTATE_STARTED
+        ):
+            raise Exception(scode=winerror.E_UNEXPECTED)
+        # 		self._DumpNamedItems_()
+        self.ExecutePendingScripts()
+        self.DoRun()
+
+    def Stop(self):
+        # Stop all executing scripts, and disconnect.
+        if self.scriptState == axscript.SCRIPTSTATE_CONNECTED:
+            self.Disconnect()
+        # Reset back to initialized.
+        self.Reset()
+
+    def Disconnect(self):
+        self.CheckConnectedOrDisconnected()
+        try:
+            self.DisconnectEventHandlers()
+        except pythoncom.com_error:
+            # Ignore errors when disconnecting.
+            pass
+
+        self.ChangeScriptState(axscript.SCRIPTSTATE_DISCONNECTED)
+
+    def ConnectEventHandlers(self):
+        # 		trace ("Connecting to event handlers")
+        for item in self.subItems.values():
+            item.Connect()
+        self.ChangeScriptState(axscript.SCRIPTSTATE_CONNECTED)
+
+    def DisconnectEventHandlers(self):
+        # 		trace ("Disconnecting from event handlers")
+        for item in self.subItems.values():
+            item.Disconnect()
+
+    def Reset(self):
+        # Keeping persistent engine state, reset back an initialized state
+        self.ResetNamedItems()
+        self.ChangeScriptState(axscript.SCRIPTSTATE_INITIALIZED)
+
+    def ChangeScriptState(self, state):
+        # print "  ChangeScriptState with %s - currentstate = %s" % (state_map.get(state),state_map.get(self.scriptState))
+        self.DisableInterrupts()
+        try:
+            self.scriptState = state
+            try:
+                if self.scriptSite:
+                    self.scriptSite.OnStateChange(state)
+            except pythoncom.com_error as xxx_todo_changeme:
+                (hr, desc, exc, arg) = xxx_todo_changeme.args
+                # Ignore all errors here - E_NOTIMPL likely from scriptlets.
+        finally:
+            self.EnableInterrupts()
+
+    # This stack frame is debugged - therefore we do as little as possible in it.
+    def _ApplyInScriptedSection(self, fn, args):
+        if self.debugManager:
+            self.debugManager.OnEnterScript()
+            if self.debugManager.adb.appDebugger:
+                return self.debugManager.adb.runcall(fn, *args)
+            else:
+                return fn(*args)
+        else:
+            return fn(*args)
+
+    def ApplyInScriptedSection(self, codeBlock, fn, args):
+        self.BeginScriptedSection()
+        try:
+            try:
+                # 				print "ApplyInSS", codeBlock, fn, args
+                return self._ApplyInScriptedSection(fn, args)
+            finally:
+                if self.debugManager:
+                    self.debugManager.OnLeaveScript()
+                self.EndScriptedSection()
+        except:
+            self.HandleException(codeBlock)
+
+    # This stack frame is debugged - therefore we do as little as possible in it.
+    def _CompileInScriptedSection(self, code, name, type):
+        if self.debugManager:
+            self.debugManager.OnEnterScript()
+        return compile(code, name, type)
+
+    def CompileInScriptedSection(self, codeBlock, type, realCode=None):
+        if codeBlock.codeObject is not None:  # already compiled
+            return 1
+        if realCode is None:
+            code = codeBlock.codeText
+        else:
+            code = realCode
+        name = codeBlock.GetFileName()
+        self.BeginScriptedSection()
+        try:
+            try:
+                codeObject = self._CompileInScriptedSection(RemoveCR(code), name, type)
+                codeBlock.codeObject = codeObject
+                return 1
+            finally:
+                if self.debugManager:
+                    self.debugManager.OnLeaveScript()
+                self.EndScriptedSection()
+        except:
+            self.HandleException(codeBlock)
+
+    # This stack frame is debugged - therefore we do as little as possible in it.
+    def _ExecInScriptedSection(self, codeObject, globals, locals=None):
+        if self.debugManager:
+            self.debugManager.OnEnterScript()
+            if self.debugManager.adb.appDebugger:
+                return self.debugManager.adb.run(codeObject, globals, locals)
+            else:
+                exec(codeObject, globals, locals)
+        else:
+            exec(codeObject, globals, locals)
+
+    def ExecInScriptedSection(self, codeBlock, globals, locals=None):
+        if locals is None:
+            locals = globals
+        assert (
+            not codeBlock.beenExecuted
+        ), "This code block should not have been executed"
+        codeBlock.beenExecuted = 1
+        self.BeginScriptedSection()
+        try:
+            try:
+                self._ExecInScriptedSection(codeBlock.codeObject, globals, locals)
+            finally:
+                if self.debugManager:
+                    self.debugManager.OnLeaveScript()
+                self.EndScriptedSection()
+        except:
+            self.HandleException(codeBlock)
+
+    def _EvalInScriptedSection(self, codeBlock, globals, locals=None):
+        if self.debugManager:
+            self.debugManager.OnEnterScript()
+            if self.debugManager.adb.appDebugger:
+                return self.debugManager.adb.runeval(codeBlock, globals, locals)
+            else:
+                return eval(codeBlock, globals, locals)
+        else:
+            return eval(codeBlock, globals, locals)
+
+    def EvalInScriptedSection(self, codeBlock, globals, locals=None):
+        if locals is None:
+            locals = globals
+        assert (
+            not codeBlock.beenExecuted
+        ), "This code block should not have been executed"
+        codeBlock.beenExecuted = 1
+        self.BeginScriptedSection()
+        try:
+            try:
+                return self._EvalInScriptedSection(
+                    codeBlock.codeObject, globals, locals
+                )
+            finally:
+                if self.debugManager:
+                    self.debugManager.OnLeaveScript()
+                self.EndScriptedSection()
+        except:
+            self.HandleException(codeBlock)
+
+    def HandleException(self, codeBlock):
+        # NOTE - Never returns - raises a ComException
+        exc_type, exc_value, exc_traceback = sys.exc_info()
+        # If a SERVER exception, re-raise it.  If a client side COM error, it is
+        # likely to have originated from the script code itself, and therefore
+        # needs to be reported like any other exception.
+        if IsCOMServerException(exc_type):
+            # Ensure the traceback doesnt cause a cycle.
+            exc_traceback = None
+            raise
+        # It could be an error by another script.
+        if (
+            issubclass(pythoncom.com_error, exc_type)
+            and exc_value.hresult == axscript.SCRIPT_E_REPORTED
+        ):
+            # Ensure the traceback doesnt cause a cycle.
+            exc_traceback = None
+            raise Exception(scode=exc_value.hresult)
+
+        exception = error.AXScriptException(
+            self, codeBlock, exc_type, exc_value, exc_traceback
+        )
+
+        # Ensure the traceback doesnt cause a cycle.
+        exc_traceback = None
+        result_exception = error.ProcessAXScriptException(
+            self.scriptSite, self.debugManager, exception
+        )
+        if result_exception is not None:
+            try:
+                self.scriptSite.OnScriptTerminate(None, result_exception)
+            except pythoncom.com_error:
+                pass  # Ignore errors telling engine we stopped.
+            # reset ourselves to 'connected' so further events continue to fire.
+            self.SetScriptState(axscript.SCRIPTSTATE_CONNECTED)
+            raise result_exception
+        # I think that in some cases this should just return - but the code
+        # that could return None above is disabled, so it never happens.
+        RaiseAssert(
+            winerror.E_UNEXPECTED, "Don't have an exception to raise to the caller!"
+        )
+
+    def BeginScriptedSection(self):
+        if self.scriptSite is None:
+            raise Exception(scode=winerror.E_UNEXPECTED)
+        self.scriptSite.OnEnterScript()
+
+    def EndScriptedSection(self):
+        if self.scriptSite is None:
+            raise Exception(scode=winerror.E_UNEXPECTED)
+        self.scriptSite.OnLeaveScript()
+
+    def DisableInterrupts(self):
+        pass
+
+    def EnableInterrupts(self):
+        pass
+
+    def GetNamedItem(self, name):
+        try:
+            return self.subItems[name]
+        except KeyError:
+            raise Exception(scode=winerror.E_INVALIDARG)
+
+    def GetNamedItemClass(self):
+        return ScriptItem
+
+    def _AddScriptCodeBlock(self, codeBlock):
+        self.scriptCodeBlocks[codeBlock.GetFileName()] = codeBlock
+        if self.debugManager:
+            self.debugManager.AddScriptBlock(codeBlock)
+
+
+if __name__ == "__main__":
+    print("This is a framework class - please use pyscript.py etc")
+
+
+def dumptypeinfo(typeinfo):
+    return
+    attr = typeinfo.GetTypeAttr()
+    # Loop over all methods
+    print("Methods")
+    for j in range(attr[6]):
+        fdesc = list(typeinfo.GetFuncDesc(j))
+        id = fdesc[0]
+        try:
+            names = typeinfo.GetNames(id)
+        except pythoncom.ole_error:
+            names = None
+        doc = typeinfo.GetDocumentation(id)
+
+        print(" ", names, "has attr", fdesc)
+
+    # Loop over all variables (ie, properties)
+    print("Variables")
+    for j in range(attr[7]):
+        fdesc = list(typeinfo.GetVarDesc(j))
+        names = typeinfo.GetNames(id)
+        print(" ", names, "has attr", fdesc)
diff --git a/lib/win32comext/axscript/client/pydumper.py b/lib/win32comext/axscript/client/pydumper.py
new file mode 100644
index 00000000..3d0725ae
--- /dev/null
+++ b/lib/win32comext/axscript/client/pydumper.py
@@ -0,0 +1,77 @@
+# pydumper.py
+#
+# This is being worked on - it does not yet work at all, in ay way
+# shape or form :-)
+#
+# A new script engine, derived from the standard scripting engine,
+# which dumps information.
+
+# This generally can be used to grab all sorts of useful details about
+# an engine - expose bugs in it or Python, dump the object model, etc.
+
+# As it is derived from the standard engine, it fully supports Python
+# as a scripting language - meaning the dumps produced can be quite dynamic,
+# and based on the script code you execute.
+
+from win32com.axscript import axscript
+
+from . import pyscript
+from .pyscript import SCRIPTTEXT_FORCEEXECUTION, Exception, RaiseAssert, trace
+
+PyDump_CLSID = "{ac527e60-c693-11d0-9c25-00aa00125a98}"
+
+
+class AXScriptAttribute(pyscript.AXScriptAttribute):
+    pass
+
+
+class NamedScriptAttribute(pyscript.NamedScriptAttribute):
+    pass
+
+
+class PyScript(pyscript.PyScript):
+    pass
+
+
+def Register():
+    import sys
+
+    if "-d" in sys.argv:
+        dispatcher = "DispatcherWin32trace"
+        debug_desc = " (" + dispatcher + ")"
+        debug_option = "Yes"
+    else:
+        dispatcher = None
+        debug_desc = ""
+        debug_option = ""
+
+    categories = [axscript.CATID_ActiveScript, axscript.CATID_ActiveScriptParse]
+    clsid = PyDump_CLSID
+    lcid = 0x0409  # // english
+    policy = None  # "win32com.axscript.client.axspolicy.AXScriptPolicy"
+
+    print("Registering COM server%s..." % debug_desc)
+    from win32com.server.register import RegisterServer
+
+    languageName = "PyDump"
+    verProgId = "Python.Dumper.1"
+    RegisterServer(
+        clsid=clsid,
+        pythonInstString="win32com.axscript.client.pyscript.PyDumper",
+        className="Python Debugging/Dumping ActiveX Scripting Engine",
+        progID=languageName,
+        verProgID=verProgId,
+        catids=categories,
+        policy=policy,
+        dispatcher=dispatcher,
+    )
+
+    CreateRegKey(languageName + "\\OLEScript")
+    # Basic Registration for wsh.
+    win32com.server.register._set_string(".pysDump", "pysDumpFile")
+    win32com.server.register._set_string("pysDumpFile\\ScriptEngine", languageName)
+    print("Dumping Server registered.")
+
+
+if __name__ == "__main__":
+    Register()
diff --git a/lib/win32comext/axscript/client/pyscript.py b/lib/win32comext/axscript/client/pyscript.py
new file mode 100644
index 00000000..d2b21b58
--- /dev/null
+++ b/lib/win32comext/axscript/client/pyscript.py
@@ -0,0 +1,443 @@
+"""Python ActiveX Scripting Implementation
+
+This module implements the Python ActiveX Scripting client.
+
+To register the implementation, simply "run" this Python program - ie
+either double-click on it, or run "python.exe pyscript.py" from the
+command line.
+"""
+
+import re
+
+import pythoncom
+import win32api
+import win32com
+import win32com.client.dynamic
+import win32com.server.register
+import winerror
+from win32com.axscript import axscript
+from win32com.axscript.client import framework, scriptdispatch
+from win32com.axscript.client.framework import (
+    SCRIPTTEXT_FORCEEXECUTION,
+    SCRIPTTEXT_ISEXPRESSION,
+    SCRIPTTEXT_ISPERSISTENT,
+    Exception,
+    RaiseAssert,
+    trace,
+)
+
+PyScript_CLSID = "{DF630910-1C1D-11d0-AE36-8C0F5E000000}"
+
+debugging_attr = 0
+
+
+def debug_attr_print(*args):
+    if debugging_attr:
+        trace(*args)
+
+
+def ExpandTabs(text):
+    return re.sub("\t", "    ", text)
+
+
+def AddCR(text):
+    return re.sub("\n", "\r\n", text)
+
+
+class AXScriptCodeBlock(framework.AXScriptCodeBlock):
+    def GetDisplayName(self):
+        return "PyScript - " + framework.AXScriptCodeBlock.GetDisplayName(self)
+
+
+# There is only ever _one_ ax object - it exists in the global namespace
+# for all script items.
+# It performs a search from all global/visible objects
+# down.
+# This means that if 2 sub-objects of the same name are used
+# then only one is ever reachable using the ax shortcut.
+class AXScriptAttribute:
+    "An attribute in a scripts namespace."
+
+    def __init__(self, engine):
+        self.__dict__["_scriptEngine_"] = engine
+
+    def __getattr__(self, attr):
+        if attr[1] == "_" and attr[:-1] == "_":
+            raise AttributeError(attr)
+        rc = self._FindAttribute_(attr)
+        if rc is None:
+            raise AttributeError(attr)
+        return rc
+
+    def _Close_(self):
+        self.__dict__["_scriptEngine_"] = None
+
+    def _DoFindAttribute_(self, obj, attr):
+        try:
+            return obj.subItems[attr.lower()].attributeObject
+        except KeyError:
+            pass
+        # Check out the sub-items
+        for item in obj.subItems.values():
+            try:
+                return self._DoFindAttribute_(item, attr)
+            except AttributeError:
+                pass
+        raise AttributeError(attr)
+
+    def _FindAttribute_(self, attr):
+        for item in self._scriptEngine_.subItems.values():
+            try:
+                return self._DoFindAttribute_(item, attr)
+            except AttributeError:
+                pass
+        # All else fails, see if it is a global
+        # (mainly b/w compat)
+        return getattr(self._scriptEngine_.globalNameSpaceModule, attr)
+
+
+# 		raise AttributeError(attr)
+
+
+class NamedScriptAttribute:
+    "An explicitely named object in an objects namespace"
+
+    # Each named object holds a reference to one of these.
+    # Whenever a sub-item appears in a namespace, it is really one of these
+    # objects.  Has a circular reference back to the item itself, which is
+    # closed via _Close_()
+    def __init__(self, scriptItem):
+        self.__dict__["_scriptItem_"] = scriptItem
+
+    def __repr__(self):
+        return "<NamedItemAttribute" + repr(self._scriptItem_) + ">"
+
+    def __getattr__(self, attr):
+        # If a known subitem, return it.
+        try:
+            return self._scriptItem_.subItems[attr.lower()].attributeObject
+        except KeyError:
+            # Otherwise see if the dispatch can give it to us
+            if self._scriptItem_.dispatchContainer:
+                return getattr(self._scriptItem_.dispatchContainer, attr)
+        raise AttributeError(attr)
+
+    def __setattr__(self, attr, value):
+        # XXX - todo - if a known item, then should call its default
+        # dispatch method.
+        attr = attr.lower()
+        if self._scriptItem_.dispatchContainer:
+            try:
+                return setattr(self._scriptItem_.dispatchContainer, attr, value)
+            except AttributeError:
+                pass
+        raise AttributeError(attr)
+
+    def _Close_(self):
+        self.__dict__["_scriptItem_"] = None
+
+
+class ScriptItem(framework.ScriptItem):
+    def __init__(self, parentItem, name, dispatch, flags):
+        framework.ScriptItem.__init__(self, parentItem, name, dispatch, flags)
+        self.scriptlets = {}
+        self.attributeObject = None
+
+    def Reset(self):
+        framework.ScriptItem.Reset(self)
+        if self.attributeObject:
+            self.attributeObject._Close_()
+        self.attributeObject = None
+
+    def Close(self):
+        framework.ScriptItem.Close(self)  # calls reset.
+        self.dispatchContainer = None
+        self.scriptlets = {}
+
+    def Register(self):
+        framework.ScriptItem.Register(self)
+        self.attributeObject = NamedScriptAttribute(self)
+        if self.dispatch:
+            # Need to avoid the new Python "lazy" dispatch behaviour.
+            try:
+                engine = self.GetEngine()
+                olerepr = clsid = None
+                typeinfo = self.dispatch.GetTypeInfo()
+                clsid = typeinfo.GetTypeAttr()[0]
+                try:
+                    olerepr = engine.mapKnownCOMTypes[clsid]
+                except KeyError:
+                    pass
+            except pythoncom.com_error:
+                typeinfo = None
+            if olerepr is None:
+                olerepr = win32com.client.dynamic.MakeOleRepr(
+                    self.dispatch, typeinfo, None
+                )
+                if clsid is not None:
+                    engine.mapKnownCOMTypes[clsid] = olerepr
+            self.dispatchContainer = win32com.client.dynamic.CDispatch(
+                self.dispatch, olerepr, self.name
+            )
+
+
+# 			self.dispatchContainer = win32com.client.dynamic.Dispatch(self.dispatch, userName = self.name)
+# 			self.dispatchContainer = win32com.client.dynamic.DumbDispatch(self.dispatch, userName = self.name)
+
+# 	def Connect(self):
+# 		framework.ScriptItem.Connect(self)
+# 	def Disconnect(self):
+# 		framework.ScriptItem.Disconnect(self)
+
+
+class PyScript(framework.COMScript):
+    # Setup the auto-registration stuff...
+    _reg_verprogid_ = "Python.AXScript.2"
+    _reg_progid_ = "Python"
+    # 	_reg_policy_spec_ = default
+    _reg_catids_ = [axscript.CATID_ActiveScript, axscript.CATID_ActiveScriptParse]
+    _reg_desc_ = "Python ActiveX Scripting Engine"
+    _reg_clsid_ = PyScript_CLSID
+    _reg_class_spec_ = "win32com.axscript.client.pyscript.PyScript"
+    _reg_remove_keys_ = [(".pys",), ("pysFile",)]
+    _reg_threading_ = "both"
+
+    def __init__(self):
+        framework.COMScript.__init__(self)
+        self.globalNameSpaceModule = None
+        self.codeBlocks = []
+        self.scriptDispatch = None
+
+    def InitNew(self):
+        framework.COMScript.InitNew(self)
+        import imp
+
+        self.scriptDispatch = None
+        self.globalNameSpaceModule = imp.new_module("__ax_main__")
+        self.globalNameSpaceModule.__dict__["ax"] = AXScriptAttribute(self)
+
+        self.codeBlocks = []
+        self.persistedCodeBlocks = []
+        self.mapKnownCOMTypes = {}  # Map of known CLSID to typereprs
+        self.codeBlockCounter = 0
+
+    def Stop(self):
+        # Flag every pending script as already done
+        for b in self.codeBlocks:
+            b.beenExecuted = 1
+        return framework.COMScript.Stop(self)
+
+    def Reset(self):
+        # Reset all code-blocks that are persistent, and discard the rest
+        oldCodeBlocks = self.codeBlocks[:]
+        self.codeBlocks = []
+        for b in oldCodeBlocks:
+            if b.flags & SCRIPTTEXT_ISPERSISTENT:
+                b.beenExecuted = 0
+                self.codeBlocks.append(b)
+        return framework.COMScript.Reset(self)
+
+    def _GetNextCodeBlockNumber(self):
+        self.codeBlockCounter = self.codeBlockCounter + 1
+        return self.codeBlockCounter
+
+    def RegisterNamedItem(self, item):
+        wasReg = item.isRegistered
+        framework.COMScript.RegisterNamedItem(self, item)
+        if not wasReg:
+            # Insert into our namespace.
+            # Add every item by name
+            if item.IsVisible():
+                self.globalNameSpaceModule.__dict__[item.name] = item.attributeObject
+            if item.IsGlobal():
+                # Global items means sub-items are also added...
+                for subitem in item.subItems.values():
+                    self.globalNameSpaceModule.__dict__[
+                        subitem.name
+                    ] = subitem.attributeObject
+                # Also add all methods
+                for name, entry in item.dispatchContainer._olerepr_.mapFuncs.items():
+                    if not entry.hidden:
+                        self.globalNameSpaceModule.__dict__[name] = getattr(
+                            item.dispatchContainer, name
+                        )
+
+    def DoExecutePendingScripts(self):
+        try:
+            globs = self.globalNameSpaceModule.__dict__
+            for codeBlock in self.codeBlocks:
+                if not codeBlock.beenExecuted:
+                    if self.CompileInScriptedSection(codeBlock, "exec"):
+                        self.ExecInScriptedSection(codeBlock, globs)
+        finally:
+            pass
+
+    def DoRun(self):
+        pass
+
+    def Close(self):
+        self.ResetNamespace()
+        self.globalNameSpaceModule = None
+        self.codeBlocks = []
+        self.scriptDispatch = None
+        framework.COMScript.Close(self)
+
+    def GetScriptDispatch(self, name):
+        # 		trace("GetScriptDispatch with", name)
+        # 		if name is not None: return None
+        if self.scriptDispatch is None:
+            self.scriptDispatch = scriptdispatch.MakeScriptDispatch(
+                self, self.globalNameSpaceModule
+            )
+        return self.scriptDispatch
+
+    def MakeEventMethodName(self, subItemName, eventName):
+        return (
+            subItemName[0].upper()
+            + subItemName[1:]
+            + "_"
+            + eventName[0].upper()
+            + eventName[1:]
+        )
+
+    def DoAddScriptlet(
+        self,
+        defaultName,
+        code,
+        itemName,
+        subItemName,
+        eventName,
+        delimiter,
+        sourceContextCookie,
+        startLineNumber,
+    ):
+        # Just store the code away - compile when called.  (JIT :-)
+        item = self.GetNamedItem(itemName)
+        if (
+            itemName == subItemName
+        ):  # Explicit handlers - eg <SCRIPT LANGUAGE="Python" for="TestForm" Event="onSubmit">
+            subItem = item
+        else:
+            subItem = item.GetCreateSubItem(item, subItemName, None, None)
+        funcName = self.MakeEventMethodName(subItemName, eventName)
+
+        codeBlock = AXScriptCodeBlock(
+            "Script Event %s" % funcName, code, sourceContextCookie, startLineNumber, 0
+        )
+        self._AddScriptCodeBlock(codeBlock)
+        subItem.scriptlets[funcName] = codeBlock
+
+    def DoProcessScriptItemEvent(self, item, event, lcid, wFlags, args):
+        # 		trace("ScriptItemEvent", self, item, event, event.name, lcid, wFlags, args)
+        funcName = self.MakeEventMethodName(item.name, event.name)
+        codeBlock = function = None
+        try:
+            function = item.scriptlets[funcName]
+            if type(function) == type(self):  # ie, is a CodeBlock instance
+                codeBlock = function
+                function = None
+        except KeyError:
+            pass
+        if codeBlock is not None:
+            realCode = "def %s():\n" % funcName
+            for line in framework.RemoveCR(codeBlock.codeText).split("\n"):
+                realCode = realCode + "\t" + line + "\n"
+            realCode = realCode + "\n"
+            if not self.CompileInScriptedSection(codeBlock, "exec", realCode):
+                return
+            dict = {}
+            self.ExecInScriptedSection(
+                codeBlock, self.globalNameSpaceModule.__dict__, dict
+            )
+            function = dict[funcName]
+            # cache back in scriptlets as a function.
+            item.scriptlets[funcName] = function
+        if function is None:
+            # still no function - see if in the global namespace.
+            try:
+                function = self.globalNameSpaceModule.__dict__[funcName]
+            except KeyError:
+                # Not there _exactly_ - do case ins search.
+                funcNameLook = funcName.lower()
+                for attr in self.globalNameSpaceModule.__dict__.keys():
+                    if funcNameLook == attr.lower():
+                        function = self.globalNameSpaceModule.__dict__[attr]
+                        # cache back in scriptlets, to avoid this overhead next time
+                        item.scriptlets[funcName] = function
+
+        if function is None:
+            raise Exception(scode=winerror.DISP_E_MEMBERNOTFOUND)
+        return self.ApplyInScriptedSection(codeBlock, function, args)
+
+    def DoParseScriptText(
+        self, code, sourceContextCookie, startLineNumber, bWantResult, flags
+    ):
+        code = framework.RemoveCR(code) + "\n"
+        if flags & SCRIPTTEXT_ISEXPRESSION:
+            name = "Script Expression"
+            exec_type = "eval"
+        else:
+            name = "Script Block"
+            exec_type = "exec"
+        num = self._GetNextCodeBlockNumber()
+        if num == 1:
+            num = ""
+        name = "%s %s" % (name, num)
+        codeBlock = AXScriptCodeBlock(
+            name, code, sourceContextCookie, startLineNumber, flags
+        )
+        self._AddScriptCodeBlock(codeBlock)
+        globs = self.globalNameSpaceModule.__dict__
+        if bWantResult:  # always immediate.
+            if self.CompileInScriptedSection(codeBlock, exec_type):
+                if flags & SCRIPTTEXT_ISEXPRESSION:
+                    return self.EvalInScriptedSection(codeBlock, globs)
+                else:
+                    return self.ExecInScriptedSection(codeBlock, globs)
+
+            # else compile failed, but user chose to keep running...
+        else:
+            if flags & SCRIPTTEXT_FORCEEXECUTION:
+                if self.CompileInScriptedSection(codeBlock, exec_type):
+                    self.ExecInScriptedSection(codeBlock, globs)
+            else:
+                self.codeBlocks.append(codeBlock)
+
+    def GetNamedItemClass(self):
+        return ScriptItem
+
+    def ResetNamespace(self):
+        if self.globalNameSpaceModule is not None:
+            try:
+                self.globalNameSpaceModule.ax._Reset_()
+            except AttributeError:
+                pass  # ???
+            globalNameSpaceModule = None
+
+
+def DllRegisterServer():
+    klass = PyScript
+    win32com.server.register._set_subkeys(
+        klass._reg_progid_ + "\\OLEScript", {}
+    )  # Just a CreateKey
+    # Basic Registration for wsh.
+    win32com.server.register._set_string(".pys", "pysFile")
+    win32com.server.register._set_string("pysFile\\ScriptEngine", klass._reg_progid_)
+    guid_wsh_shellex = "{60254CA5-953B-11CF-8C96-00AA00B8708C}"
+    win32com.server.register._set_string(
+        "pysFile\\ShellEx\\DropHandler", guid_wsh_shellex
+    )
+    win32com.server.register._set_string(
+        "pysFile\\ShellEx\\PropertySheetHandlers\\WSHProps", guid_wsh_shellex
+    )
+
+
+def Register(klass=PyScript):
+    ret = win32com.server.register.UseCommandLine(
+        klass, finalize_register=DllRegisterServer
+    )
+    return ret
+
+
+if __name__ == "__main__":
+    Register()
diff --git a/lib/win32comext/axscript/client/pyscript_rexec.py b/lib/win32comext/axscript/client/pyscript_rexec.py
new file mode 100644
index 00000000..a07b5a16
--- /dev/null
+++ b/lib/win32comext/axscript/client/pyscript_rexec.py
@@ -0,0 +1,49 @@
+# A version of the ActiveScripting engine that enables rexec support
+# This version supports hosting by IE - however, due to Python's
+# rexec module being neither completely trusted nor private, it is
+# *not* enabled by default.
+# As of Python 2.2, rexec is simply not available - thus, if you use this,
+# a HTML page can do almost *anything* at all on your machine.
+
+# You almost certainly do NOT want to use thus!
+
+import pythoncom
+from win32com.axscript import axscript
+
+from . import pyscript
+
+INTERFACE_USES_DISPEX = 0x00000004  # Object knows to use IDispatchEx
+INTERFACE_USES_SECURITY_MANAGER = (
+    0x00000008  # Object knows to use IInternetHostSecurityManager
+)
+
+
+class PyScriptRExec(pyscript.PyScript):
+    # Setup the auto-registration stuff...
+    _reg_verprogid_ = "Python.AXScript-rexec.2"
+    _reg_progid_ = "Python"  # Same ProgID as the standard engine.
+    # 	_reg_policy_spec_ = default
+    _reg_catids_ = [axscript.CATID_ActiveScript, axscript.CATID_ActiveScriptParse]
+    _reg_desc_ = "Python ActiveX Scripting Engine (with rexec support)"
+    _reg_clsid_ = "{69c2454b-efa2-455b-988c-c3651c4a2f69}"
+    _reg_class_spec_ = "win32com.axscript.client.pyscript_rexec.PyScriptRExec"
+    _reg_remove_keys_ = [(".pys",), ("pysFile",)]
+    _reg_threading_ = "Apartment"
+
+    def _GetSupportedInterfaceSafetyOptions(self):
+        # print "**** calling", pyscript.PyScript._GetSupportedInterfaceSafetyOptions, "**->", pyscript.PyScript._GetSupportedInterfaceSafetyOptions(self)
+        return (
+            INTERFACE_USES_DISPEX
+            | INTERFACE_USES_SECURITY_MANAGER
+            | axscript.INTERFACESAFE_FOR_UNTRUSTED_DATA
+            | axscript.INTERFACESAFE_FOR_UNTRUSTED_CALLER
+        )
+
+
+if __name__ == "__main__":
+    print("WARNING: By registering this engine, you are giving remote HTML code")
+    print("the ability to execute *any* code on your system.")
+    print()
+    print("You almost certainly do NOT want to do this.")
+    print("You have been warned, and are doing this at your own (significant) risk")
+    pyscript.Register(PyScriptRExec)
diff --git a/lib/win32comext/axscript/client/scriptdispatch.py b/lib/win32comext/axscript/client/scriptdispatch.py
new file mode 100644
index 00000000..525326e7
--- /dev/null
+++ b/lib/win32comext/axscript/client/scriptdispatch.py
@@ -0,0 +1,115 @@
+"""dynamic dispatch objects for AX Script.
+
+ This is an IDispatch object that a scripting host may use to
+ query and invoke methods on the main script.  Not may hosts use
+ this yet, so it is not well tested!
+"""
+
+import types
+
+import pythoncom
+import win32com.server.policy
+import win32com.server.util
+import winerror
+from win32com.axscript import axscript
+from win32com.client import Dispatch
+from win32com.server.exception import COMException
+
+debugging = 0
+
+PyIDispatchType = pythoncom.TypeIIDs[pythoncom.IID_IDispatch]
+
+
+def _is_callable(obj):
+    return type(obj) in [types.FunctionType, types.MethodType]
+    # ignore hasattr(obj, "__call__") as this means all COM objects!
+
+
+class ScriptDispatch:
+    _public_methods_ = []
+
+    def __init__(self, engine, scriptNamespace):
+        self.engine = engine
+        self.scriptNamespace = scriptNamespace
+
+    def _dynamic_(self, name, lcid, wFlags, args):
+        # Ensure any newly added items are available.
+        self.engine.RegisterNewNamedItems()
+        self.engine.ProcessNewNamedItemsConnections()
+        if wFlags & pythoncom.INVOKE_FUNC:
+            # attempt to call a function
+            try:
+                func = getattr(self.scriptNamespace, name)
+                if not _is_callable(func):
+                    raise AttributeError(name)  # Not a function.
+                realArgs = []
+                for arg in args:
+                    if type(arg) == PyIDispatchType:
+                        realArgs.append(Dispatch(arg))
+                    else:
+                        realArgs.append(arg)
+                # xxx - todo - work out what code block to pass???
+                return self.engine.ApplyInScriptedSection(None, func, tuple(realArgs))
+
+            except AttributeError:
+                if not wFlags & pythoncom.DISPATCH_PROPERTYGET:
+                    raise COMException(scode=winerror.DISP_E_MEMBERNOTFOUND)
+        if wFlags & pythoncom.DISPATCH_PROPERTYGET:
+            # attempt to get a property
+            try:
+                ret = getattr(self.scriptNamespace, name)
+                if _is_callable(ret):
+                    raise AttributeError(name)  # Not a property.
+            except AttributeError:
+                raise COMException(scode=winerror.DISP_E_MEMBERNOTFOUND)
+            except COMException as instance:
+                raise
+            except:
+                ret = self.engine.HandleException()
+            return ret
+
+        raise COMException(scode=winerror.DISP_E_MEMBERNOTFOUND)
+
+
+class StrictDynamicPolicy(win32com.server.policy.DynamicPolicy):
+    def _wrap_(self, object):
+        win32com.server.policy.DynamicPolicy._wrap_(self, object)
+        if hasattr(self._obj_, "scriptNamespace"):
+            for name in dir(self._obj_.scriptNamespace):
+                self._dyn_dispid_to_name_[self._getdispid_(name, 0)] = name
+
+    def _getmembername_(self, dispid):
+        try:
+            return str(self._dyn_dispid_to_name_[dispid])
+        except KeyError:
+            raise COMException(scode=winerror.DISP_E_UNKNOWNNAME, desc="Name not found")
+
+    def _getdispid_(self, name, fdex):
+        try:
+            func = getattr(self._obj_.scriptNamespace, str(name))
+        except AttributeError:
+            raise COMException(scode=winerror.DISP_E_MEMBERNOTFOUND)
+        # 		if not _is_callable(func):
+        return win32com.server.policy.DynamicPolicy._getdispid_(self, name, fdex)
+
+
+def _wrap_debug(obj):
+    return win32com.server.util.wrap(
+        obj,
+        usePolicy=StrictDynamicPolicy,
+        useDispatcher=win32com.server.policy.DispatcherWin32trace,
+    )
+
+
+def _wrap_nodebug(obj):
+    return win32com.server.util.wrap(obj, usePolicy=StrictDynamicPolicy)
+
+
+if debugging:
+    _wrap = _wrap_debug
+else:
+    _wrap = _wrap_nodebug
+
+
+def MakeScriptDispatch(engine, namespace):
+    return _wrap(ScriptDispatch(engine, namespace))
diff --git a/lib/win32comext/axscript/server/__init__.py b/lib/win32comext/axscript/server/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/lib/win32comext/axscript/server/axsite.py b/lib/win32comext/axscript/server/axsite.py
new file mode 100644
index 00000000..d07ed120
--- /dev/null
+++ b/lib/win32comext/axscript/server/axsite.py
@@ -0,0 +1,145 @@
+import pythoncom
+import win32com.axscript.axscript
+import winerror
+from win32com.axscript import axscript
+from win32com.server import exception, util
+
+
+class AXEngine:
+    def __init__(self, site, engine):
+        self.eScript = self.eParse = self.eSafety = None
+        if type(engine) == type(""):
+            engine = pythoncom.CoCreateInstance(
+                engine, None, pythoncom.CLSCTX_SERVER, pythoncom.IID_IUnknown
+            )
+
+        self.eScript = engine.QueryInterface(axscript.IID_IActiveScript)
+        self.eParse = engine.QueryInterface(axscript.IID_IActiveScriptParse)
+        self.eSafety = engine.QueryInterface(axscript.IID_IObjectSafety)
+
+        self.eScript.SetScriptSite(site)
+        self.eParse.InitNew()
+
+    def __del__(self):
+        self.Close()
+
+    def GetScriptDispatch(self, name=None):
+        return self.eScript.GetScriptDispatch(name)
+
+    def AddNamedItem(self, item, flags):
+        return self.eScript.AddNamedItem(item, flags)
+
+    # Some helpers.
+    def AddCode(self, code, flags=0):
+        self.eParse.ParseScriptText(code, None, None, None, 0, 0, flags)
+
+    def EvalCode(self, code):
+        return self.eParse.ParseScriptText(
+            code, None, None, None, 0, 0, axscript.SCRIPTTEXT_ISEXPRESSION
+        )
+
+    def Start(self):
+        # Should maybe check state?
+        # Do I need to transition through?
+        self.eScript.SetScriptState(axscript.SCRIPTSTATE_STARTED)
+
+    #    self.eScript.SetScriptState(axscript.SCRIPTSTATE_CONNECTED)
+
+    def Close(self):
+        if self.eScript:
+            self.eScript.Close()
+        self.eScript = self.eParse = self.eSafety = None
+
+    def SetScriptState(self, state):
+        self.eScript.SetScriptState(state)
+
+
+IActiveScriptSite_methods = [
+    "GetLCID",
+    "GetItemInfo",
+    "GetDocVersionString",
+    "OnScriptTerminate",
+    "OnStateChange",
+    "OnScriptError",
+    "OnEnterScript",
+    "OnLeaveScript",
+]
+
+
+class AXSite:
+    """An Active Scripting site.  A Site can have exactly one engine."""
+
+    _public_methods_ = IActiveScriptSite_methods
+    _com_interfaces_ = [axscript.IID_IActiveScriptSite]
+
+    def __init__(self, objModel={}, engine=None, lcid=0):
+        self.lcid = lcid
+        self.objModel = {}
+        for name, object in objModel.items():
+            # Gregs code did string.lower this - I think that is callers job if he wants!
+            self.objModel[name] = object
+
+        self.engine = None
+        if engine:
+            self._AddEngine(engine)
+
+    def AddEngine(self, engine):
+        """Adds a new engine to the site.
+        engine can be a string, or a fully wrapped engine object.
+        """
+        if type(engine) == type(""):
+            newEngine = AXEngine(util.wrap(self), engine)
+        else:
+            newEngine = engine
+        self.engine = newEngine
+        flags = (
+            axscript.SCRIPTITEM_ISVISIBLE
+            | axscript.SCRIPTITEM_NOCODE
+            | axscript.SCRIPTITEM_GLOBALMEMBERS
+            | axscript.SCRIPTITEM_ISPERSISTENT
+        )
+        for name in self.objModel.keys():
+            newEngine.AddNamedItem(name, flags)
+            newEngine.SetScriptState(axscript.SCRIPTSTATE_INITIALIZED)
+        return newEngine
+
+    # B/W compat
+    _AddEngine = AddEngine
+
+    def _Close(self):
+        self.engine.Close()
+        self.objModel = {}
+
+    def GetLCID(self):
+        return self.lcid
+
+    def GetItemInfo(self, name, returnMask):
+        if name not in self.objModel:
+            raise exception.Exception(
+                scode=winerror.TYPE_E_ELEMENTNOTFOUND, desc="item not found"
+            )
+
+        ### for now, we don't have any type information
+
+        if returnMask & axscript.SCRIPTINFO_IUNKNOWN:
+            return (self.objModel[name], None)
+
+        return (None, None)
+
+    def GetDocVersionString(self):
+        return "Python AXHost version 1.0"
+
+    def OnScriptTerminate(self, result, excepInfo):
+        pass
+
+    def OnStateChange(self, state):
+        pass
+
+    def OnScriptError(self, errorInterface):
+        return winerror.S_FALSE
+
+    def OnEnterScript(self):
+        pass
+
+    def OnLeaveScript(self):
+        pass
diff --git a/lib/win32comext/axscript/server/error.py b/lib/win32comext/axscript/server/error.py
new file mode 100644
index 00000000..82491a6e
--- /dev/null
+++ b/lib/win32comext/axscript/server/error.py
@@ -0,0 +1,16 @@
+"""Exception instance for AXScript servers.
+
+This module implements an exception instance that is raised by the core 
+server scripting support.
+
+When a script error occurs, it wraps the COM object that describes the
+exception in a Python instance, which can then be raised and caught.
+"""
+
+
+class Exception:
+    def __init__(self, activeScriptError):
+        self.activeScriptError = activeScriptError
+
+    def __getattr__(self, attr):
+        return getattr(self.activeScriptError, attr)
diff --git a/lib/win32comext/axscript/test/debugTest.pys b/lib/win32comext/axscript/test/debugTest.pys
new file mode 100644
index 00000000..4e133abe
--- /dev/null
+++ b/lib/win32comext/axscript/test/debugTest.pys
@@ -0,0 +1,17 @@
+def Function(i):
+	Test.Echo(i)
+
+print(dir())
+
+a=1
+b=a
+c=b # And here is a comment
+d="A string"
+print(a)
+Test.echo("Hello from Python")
+for i in range(2):
+	Function(i)
+a = """\
+A multi-line string!
+"""
+
diff --git a/lib/win32comext/axscript/test/debugTest.vbs b/lib/win32comext/axscript/test/debugTest.vbs
new file mode 100644
index 00000000..58f4a222
--- /dev/null
+++ b/lib/win32comext/axscript/test/debugTest.vbs
@@ -0,0 +1,7 @@
+a=1
+b=a
+Test.Echo "Hello from VBScript"
+' Here is a comment
+for i = 1 to 10
+  
+next
diff --git a/lib/win32comext/axscript/test/leakTest.py b/lib/win32comext/axscript/test/leakTest.py
new file mode 100644
index 00000000..d8ccac57
--- /dev/null
+++ b/lib/win32comext/axscript/test/leakTest.py
@@ -0,0 +1,188 @@
+import sys
+
+import pythoncom
+import win32com.server.policy
+from win32com.axscript import axscript
+from win32com.axscript.server import axsite
+from win32com.axscript.server.error import Exception
+from win32com.server import connect, util
+
+
+class MySite(axsite.AXSite):
+    def OnScriptError(self, error):
+        exc = error.GetExceptionInfo()
+        context, line, char = error.GetSourcePosition()
+        print(" >Exception:", exc[1])
+        try:
+            st = error.GetSourceLineText()
+        except pythoncom.com_error:
+            st = None
+        if st is None:
+            st = ""
+        text = st + "\n" + (" " * (char - 1)) + "^" + "\n" + exc[2]
+        for line in text.splitlines():
+            print("  >" + line)
+
+
+class MyCollection(util.Collection):
+    def _NewEnum(self):
+        print("Making new Enumerator")
+        return util.Collection._NewEnum(self)
+
+
+class Test:
+    _public_methods_ = ["echo"]
+    _public_attrs_ = ["collection", "verbose"]
+
+    def __init__(self):
+        self.verbose = 0
+        self.collection = util.wrap(MyCollection([1, "Two", 3]))
+        self.last = ""
+
+    #    self._connect_server_ = TestConnectServer(self)
+
+    def echo(self, *args):
+        self.last = "".join(map(str, args))
+        if self.verbose:
+            for arg in args:
+                print(arg, end=" ")
+            print()
+
+
+#    self._connect_server_.Broadcast(last)
+
+
+#### Connections currently wont work, as there is no way for the engine to
+#### know what events we support.  We need typeinfo support.
+
+IID_ITestEvents = pythoncom.MakeIID("{8EB72F90-0D44-11d1-9C4B-00AA00125A98}")
+
+
+class TestConnectServer(connect.ConnectableServer):
+    _connect_interfaces_ = [IID_ITestEvents]
+
+    # The single public method that the client can call on us
+    # (ie, as a normal COM server, this exposes just this single method.
+    def __init__(self, object):
+        self.object = object
+
+    def Broadcast(self, arg):
+        # Simply broadcast a notification.
+        self._BroadcastNotify(self.NotifyDoneIt, (arg,))
+
+    def NotifyDoneIt(self, interface, arg):
+        interface.Invoke(1000, 0, pythoncom.DISPATCH_METHOD, 1, arg)
+
+
+VBScript = """\
+prop = "Property Value"
+
+sub hello(arg1)
+   test.echo arg1
+end sub
+  
+sub testcollection
+   test.verbose = 1
+   for each item in test.collection
+     test.echo "Collection item is", item
+   next
+end sub
+"""
+if sys.version_info < (3,):
+    PyScript = """print "PyScript is being parsed..."\n"""
+else:
+    PyScript = """print("PyScript is being parsed...")\n"""
+PyScript += """\
+prop = "Property Value"
+def hello(arg1):
+   test.echo(arg1)
+   pass
+   
+def testcollection():
+   test.verbose = 1
+#   test.collection[1] = "New one"
+   for item in test.collection:
+     test.echo("Collection item is", item)
+   pass
+"""
+
+ErrScript = """\
+bad code for everyone!
+"""
+
+
+def TestEngine(engineName, code, bShouldWork=1):
+    echoer = Test()
+    model = {
+        "test": util.wrap(echoer),
+    }
+
+    site = MySite(model)
+    engine = site._AddEngine(engineName)
+    engine.AddCode(code, axscript.SCRIPTTEXT_ISPERSISTENT)
+    try:
+        engine.Start()
+    finally:
+        if not bShouldWork:
+            engine.Close()
+            return
+    doTestEngine(engine, echoer)
+    # re-transition the engine back to the UNINITIALIZED state, a-la ASP.
+    engine.eScript.SetScriptState(axscript.SCRIPTSTATE_UNINITIALIZED)
+    engine.eScript.SetScriptSite(util.wrap(site))
+    print("restarting")
+    engine.Start()
+    # all done!
+    engine.Close()
+
+
+def doTestEngine(engine, echoer):
+    # Now call into the scripts IDispatch
+    from win32com.client.dynamic import Dispatch
+
+    ob = Dispatch(engine.GetScriptDispatch())
+    try:
+        ob.hello("Goober")
+    except pythoncom.com_error as exc:
+        print("***** Calling 'hello' failed", exc)
+        return
+    if echoer.last != "Goober":
+        print("***** Function call didnt set value correctly", repr(echoer.last))
+
+    if str(ob.prop) != "Property Value":
+        print("***** Property Value not correct - ", repr(ob.prop))
+
+    ob.testcollection()
+
+    # Now make sure my engines can evaluate stuff.
+    result = engine.eParse.ParseScriptText(
+        "1+1", None, None, None, 0, 0, axscript.SCRIPTTEXT_ISEXPRESSION
+    )
+    if result != 2:
+        print("Engine could not evaluate '1+1' - said the result was", result)
+
+
+def dotestall():
+    for i in range(10):
+        TestEngine("Python", PyScript)
+        print(sys.gettotalrefcount())
+
+
+##  print "Testing Exceptions"
+##  try:
+##    TestEngine("Python", ErrScript, 0)
+##  except pythoncom.com_error:
+##    pass
+
+
+def testall():
+    dotestall()
+    pythoncom.CoUninitialize()
+    print(
+        "AXScript Host worked correctly - %d/%d COM objects left alive."
+        % (pythoncom._GetInterfaceCount(), pythoncom._GetGatewayCount())
+    )
+
+
+if __name__ == "__main__":
+    testall()
diff --git a/lib/win32comext/axscript/test/testHost.py b/lib/win32comext/axscript/test/testHost.py
new file mode 100644
index 00000000..8ef8bcc0
--- /dev/null
+++ b/lib/win32comext/axscript/test/testHost.py
@@ -0,0 +1,257 @@
+import sys
+import unittest
+
+import pythoncom
+import win32com.server.policy
+import win32com.test.util
+from win32com.axscript import axscript
+from win32com.axscript.server import axsite
+from win32com.axscript.server.error import Exception
+from win32com.client.dynamic import Dispatch
+from win32com.server import connect, util
+from win32com.server.exception import COMException
+
+verbose = "-v" in sys.argv
+
+
+class MySite(axsite.AXSite):
+    def __init__(self, *args):
+        self.exception_seen = None
+        axsite.AXSite.__init__(self, *args)
+
+    def OnScriptError(self, error):
+        self.exception_seen = exc = error.GetExceptionInfo()
+        context, line, char = error.GetSourcePosition()
+        if not verbose:
+            return
+        print(" >Exception:", exc[1])
+        try:
+            st = error.GetSourceLineText()
+        except pythoncom.com_error:
+            st = None
+        if st is None:
+            st = ""
+        text = st + "\n" + (" " * (char - 1)) + "^" + "\n" + exc[2]
+        for line in text.splitlines():
+            print("  >" + line)
+
+
+class MyCollection(util.Collection):
+    def _NewEnum(self):
+        return util.Collection._NewEnum(self)
+
+
+class Test:
+    _public_methods_ = ["echo", "fail"]
+    _public_attrs_ = ["collection"]
+
+    def __init__(self):
+        self.verbose = verbose
+        self.collection = util.wrap(MyCollection([1, "Two", 3]))
+        self.last = ""
+        self.fail_called = 0
+
+    #    self._connect_server_ = TestConnectServer(self)
+
+    def echo(self, *args):
+        self.last = "".join([str(s) for s in args])
+        if self.verbose:
+            for arg in args:
+                print(arg, end=" ")
+            print()
+
+    def fail(self, *args):
+        print("**** fail() called ***")
+        for arg in args:
+            print(arg, end=" ")
+        print()
+        self.fail_called = 1
+
+
+#    self._connect_server_.Broadcast(last)
+
+
+#### Connections currently wont work, as there is no way for the engine to
+#### know what events we support.  We need typeinfo support.
+
+IID_ITestEvents = pythoncom.MakeIID("{8EB72F90-0D44-11d1-9C4B-00AA00125A98}")
+
+
+class TestConnectServer(connect.ConnectableServer):
+    _connect_interfaces_ = [IID_ITestEvents]
+
+    # The single public method that the client can call on us
+    # (ie, as a normal COM server, this exposes just this single method.
+    def __init__(self, object):
+        self.object = object
+
+    def Broadcast(self, arg):
+        # Simply broadcast a notification.
+        self._BroadcastNotify(self.NotifyDoneIt, (arg,))
+
+    def NotifyDoneIt(self, interface, arg):
+        interface.Invoke(1000, 0, pythoncom.DISPATCH_METHOD, 1, arg)
+
+
+VBScript = """\
+prop = "Property Value"
+
+sub hello(arg1)
+   test.echo arg1
+end sub
+  
+sub testcollection
+   if test.collection.Item(0) <> 1 then
+     test.fail("Index 0 was wrong")
+   end if
+   if test.collection.Item(1) <> "Two" then
+     test.fail("Index 1 was wrong")
+   end if
+   if test.collection.Item(2) <> 3 then
+     test.fail("Index 2 was wrong")
+   end if
+   num = 0
+   for each item in test.collection
+     num = num + 1
+   next
+   if num <> 3 then
+     test.fail("Collection didn't have 3 items")
+   end if
+end sub
+"""
+PyScript = """\
+# A unicode \xa9omment.
+prop = "Property Value"
+def hello(arg1):
+   test.echo(arg1)
+   
+def testcollection():
+#   test.collection[1] = "New one"
+   got = []
+   for item in test.collection:
+     got.append(item)
+   if got != [1, "Two", 3]:
+     test.fail("Didn't get the collection")
+   pass
+"""
+
+# XXX - needs py3k work!  Throwing a bytes string with an extended char
+# doesn't make much sense, but py2x allows it.  What it gets upset with
+# is a real unicode arg - which is the only thing py3k allows!
+PyScript_Exc = """\
+def hello(arg1):
+  raise RuntimeError("exc with extended \xa9har")
+"""
+
+ErrScript = """\
+bad code for everyone!
+"""
+
+state_map = {
+    axscript.SCRIPTSTATE_UNINITIALIZED: "SCRIPTSTATE_UNINITIALIZED",
+    axscript.SCRIPTSTATE_INITIALIZED: "SCRIPTSTATE_INITIALIZED",
+    axscript.SCRIPTSTATE_STARTED: "SCRIPTSTATE_STARTED",
+    axscript.SCRIPTSTATE_CONNECTED: "SCRIPTSTATE_CONNECTED",
+    axscript.SCRIPTSTATE_DISCONNECTED: "SCRIPTSTATE_DISCONNECTED",
+    axscript.SCRIPTSTATE_CLOSED: "SCRIPTSTATE_CLOSED",
+}
+
+
+def _CheckEngineState(engine, name, state):
+    got = engine.engine.eScript.GetScriptState()
+    if got != state:
+        got_name = state_map.get(got, str(got))
+        state_name = state_map.get(state, str(state))
+        raise RuntimeError(
+            "Warning - engine %s has state %s, but expected %s"
+            % (name, got_name, state_name)
+        )
+
+
+class EngineTester(win32com.test.util.TestCase):
+    def _TestEngine(self, engineName, code, expected_exc=None):
+        echoer = Test()
+        model = {
+            "test": util.wrap(echoer),
+        }
+        site = MySite(model)
+        engine = site._AddEngine(engineName)
+        try:
+            _CheckEngineState(site, engineName, axscript.SCRIPTSTATE_INITIALIZED)
+            engine.AddCode(code)
+            engine.Start()
+            _CheckEngineState(site, engineName, axscript.SCRIPTSTATE_STARTED)
+            self.assertTrue(not echoer.fail_called, "Fail should not have been called")
+            # Now call into the scripts IDispatch
+            ob = Dispatch(engine.GetScriptDispatch())
+            try:
+                ob.hello("Goober")
+                self.assertTrue(
+                    expected_exc is None,
+                    "Expected %r, but no exception seen" % (expected_exc,),
+                )
+            except pythoncom.com_error:
+                if expected_exc is None:
+                    self.fail(
+                        "Unexpected failure from script code: %s"
+                        % (site.exception_seen,)
+                    )
+                if expected_exc not in site.exception_seen[2]:
+                    self.fail(
+                        "Could not find %r in %r"
+                        % (expected_exc, site.exception_seen[2])
+                    )
+                return
+            self.assertEqual(echoer.last, "Goober")
+
+            self.assertEqual(str(ob.prop), "Property Value")
+            ob.testcollection()
+            self.assertTrue(not echoer.fail_called, "Fail should not have been called")
+
+            # Now make sure my engines can evaluate stuff.
+            result = engine.eParse.ParseScriptText(
+                "1+1", None, None, None, 0, 0, axscript.SCRIPTTEXT_ISEXPRESSION
+            )
+            self.assertEqual(result, 2)
+            # re-initialize to make sure it transitions back to initialized again.
+            engine.SetScriptState(axscript.SCRIPTSTATE_INITIALIZED)
+            _CheckEngineState(site, engineName, axscript.SCRIPTSTATE_INITIALIZED)
+            engine.Start()
+            _CheckEngineState(site, engineName, axscript.SCRIPTSTATE_STARTED)
+
+            # Transition back to initialized, then through connected too.
+            engine.SetScriptState(axscript.SCRIPTSTATE_INITIALIZED)
+            _CheckEngineState(site, engineName, axscript.SCRIPTSTATE_INITIALIZED)
+            engine.SetScriptState(axscript.SCRIPTSTATE_CONNECTED)
+            _CheckEngineState(site, engineName, axscript.SCRIPTSTATE_CONNECTED)
+            engine.SetScriptState(axscript.SCRIPTSTATE_INITIALIZED)
+            _CheckEngineState(site, engineName, axscript.SCRIPTSTATE_INITIALIZED)
+
+            engine.SetScriptState(axscript.SCRIPTSTATE_CONNECTED)
+            _CheckEngineState(site, engineName, axscript.SCRIPTSTATE_CONNECTED)
+            engine.SetScriptState(axscript.SCRIPTSTATE_DISCONNECTED)
+            _CheckEngineState(site, engineName, axscript.SCRIPTSTATE_DISCONNECTED)
+        finally:
+            engine.Close()
+            engine = None
+            site = None
+
+    def testVB(self):
+        self._TestEngine("VBScript", VBScript)
+
+    def testPython(self):
+        self._TestEngine("Python", PyScript)
+
+    def testPythonUnicodeError(self):
+        self._TestEngine("Python", PyScript)
+
+    def testVBExceptions(self):
+        self.assertRaises(pythoncom.com_error, self._TestEngine, "VBScript", ErrScript)
+
+    def testPythonExceptions(self):
+        expected = "RuntimeError: exc with extended \xa9har"
+        self._TestEngine("Python", PyScript_Exc, expected)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/lib/win32comext/axscript/test/testHost4Dbg.py b/lib/win32comext/axscript/test/testHost4Dbg.py
new file mode 100644
index 00000000..3bfafd67
--- /dev/null
+++ b/lib/win32comext/axscript/test/testHost4Dbg.py
@@ -0,0 +1,88 @@
+import os
+import sys
+import traceback
+
+import pythoncom
+import win32ui
+from win32com.axscript import axscript
+from win32com.axscript.server import axsite
+from win32com.axscript.server.error import Exception
+from win32com.server import util
+
+version = "0.0.1"
+
+
+class MySite(axsite.AXSite):
+    def OnScriptError(self, error):
+        print("An error occurred in the Script Code")
+        exc = error.GetExceptionInfo()
+        try:
+            text = error.GetSourceLineText()
+        except:
+            text = "<unknown>"
+        context, line, char = error.GetSourcePosition()
+        print(
+            "Exception: %s (line %d)\n%s\n%s^\n%s"
+            % (exc[1], line, text, " " * (char - 1), exc[2])
+        )
+
+
+class ObjectModel:
+    _public_methods_ = ["echo", "msgbox"]
+
+    def echo(self, *args):
+        print("".join(map(str, args)))
+
+    def msgbox(self, *args):
+        msg = "".join(map(str, args))
+        win32ui.MessageBox(msg)
+
+
+def TestEngine():
+    model = {"Test": util.wrap(ObjectModel())}
+    scriptDir = "."
+    site = MySite(model)
+    pyEngine = site._AddEngine("Python")
+    #  pyEngine2 = site._AddEngine("Python")
+    vbEngine = site._AddEngine("VBScript")
+    #  forthEngine = site._AddEngine("ForthScript")
+    try:
+        #    code = open(os.path.join(scriptDir, "debugTest.4ths"),"rb").read()
+        #    forthEngine.AddCode(code)
+        code = open(os.path.join(scriptDir, "debugTest.pys"), "rb").read()
+        pyEngine.AddCode(code)
+        code = open(os.path.join(scriptDir, "debugTest.vbs"), "rb").read()
+        vbEngine.AddCode(code)
+        #    code = open(os.path.join(scriptDir, "debugTestFail.pys"),"rb").read()
+        #    pyEngine2.AddCode(code)
+
+        #    from win32com.axdebug import axdebug
+        #    sessionProvider=pythoncom.CoCreateInstance(axdebug.CLSID_DefaultDebugSessionProvider,None,pythoncom.CLSCTX_ALL, axdebug.IID_IDebugSessionProvider)
+        #    sessionProvider.StartDebugSession(None)
+
+        input("Press enter to continue")
+        #   forthEngine.Start()
+        pyEngine.Start()  # Actually run the Python code
+        vbEngine.Start()  # Actually run the VB code
+    except pythoncom.com_error as details:
+        print("Script failed: %s (0x%x)" % (details[1], details[0]))
+    # Now run the code expected to fail!
+    #  try:
+    #    pyEngine2.Start() # Actually run the Python code that fails!
+    #    print "Script code worked when it should have failed."
+    #  except pythoncom.com_error:
+    #    pass
+
+    site._Close()
+
+
+if __name__ == "__main__":
+    import win32com.axdebug.util
+
+    try:
+        TestEngine()
+    except:
+        traceback.print_exc()
+    win32com.axdebug.util._dump_wrapped()
+    sys.exc_type = sys.exc_value = sys.exc_traceback = None
+    print(pythoncom._GetInterfaceCount(), "com objects still alive")
diff --git a/lib/win32comext/bits/__init__.py b/lib/win32comext/bits/__init__.py
new file mode 100644
index 00000000..3a893267
--- /dev/null
+++ b/lib/win32comext/bits/__init__.py
@@ -0,0 +1,6 @@
+# This is a python package
+# __PackageSupportBuildPath__ not needed for distutil based builds,
+# but not everyone is there yet.
+import win32com
+
+win32com.__PackageSupportBuildPath__(__path__)
diff --git a/lib/win32comext/bits/bits.pyd b/lib/win32comext/bits/bits.pyd
new file mode 100644
index 0000000000000000000000000000000000000000..5108e7b8cd187c05d919a40e82be7b0f38834195
GIT binary patch
literal 62976
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
QgScKuRW$#%e;a|n0rQvF@Bjb+

literal 0
HcmV?d00001

diff --git a/lib/win32comext/bits/test/show_all_jobs.py b/lib/win32comext/bits/test/show_all_jobs.py
new file mode 100644
index 00000000..8ce230ce
--- /dev/null
+++ b/lib/win32comext/bits/test/show_all_jobs.py
@@ -0,0 +1,52 @@
+# Dump lots of info about BITS jobs.
+import pythoncom
+from win32com.bits import bits
+
+states = dict(
+    [
+        (val, (name[13:]))
+        for name, val in vars(bits).items()
+        if name.startswith("BG_JOB_STATE_")
+    ]
+)
+
+job_types = dict(
+    [
+        (val, (name[12:]))
+        for name, val in vars(bits).items()
+        if name.startswith("BG_JOB_TYPE_")
+    ]
+)
+
+bcm = pythoncom.CoCreateInstance(
+    bits.CLSID_BackgroundCopyManager,
+    None,
+    pythoncom.CLSCTX_LOCAL_SERVER,
+    bits.IID_IBackgroundCopyManager,
+)
+
+try:
+    enum = bcm.EnumJobs(bits.BG_JOB_ENUM_ALL_USERS)
+except pythoncom.error:
+    print("Failed to get jobs for all users - trying for current user")
+    enum = bcm.EnumJobs(0)
+
+for job in enum:
+    print("Job:", job.GetDisplayName())
+    print("Description:", job.GetDescription())
+    print("Id:", job.GetId())
+    print("State:", states.get(job.GetState()))
+    print("Type:", job_types.get(job.GetType()))
+    print("Owner:", job.GetOwner())
+    print("Errors:", job.GetErrorCount())
+    print("Created/Modified/Finished times:", [str(t) for t in job.GetTimes()])
+    bytes_tot, bytes_xf, files_tot, files_xf = job.GetProgress()
+    print("Bytes: %d complete of %d total" % (bytes_xf, bytes_tot))
+    print("Files: %d complete of %d total" % (files_xf, files_tot))
+    for f in job.EnumFiles():
+        bytes, total, done = f.GetProgress()
+        print("  Remote:", f.GetRemoteName())
+        print("  Local:", f.GetLocalName())
+        print("  Progress: %d of %d bytes - completed=%s)" % (bytes, total, done))
+        print()
+    print()
diff --git a/lib/win32comext/bits/test/test_bits.py b/lib/win32comext/bits/test/test_bits.py
new file mode 100644
index 00000000..94bcbe4b
--- /dev/null
+++ b/lib/win32comext/bits/test/test_bits.py
@@ -0,0 +1,121 @@
+import os
+import tempfile
+
+import pythoncom
+import win32api
+import win32event
+from win32com.bits import bits
+from win32com.server.util import wrap
+
+TIMEOUT = 200  # ms
+StopEvent = win32event.CreateEvent(None, 0, 0, None)
+
+job_name = "bits-pywin32-test"
+states = dict(
+    [
+        (val, (name[13:]))
+        for name, val in vars(bits).items()
+        if name.startswith("BG_JOB_STATE_")
+    ]
+)
+
+bcm = pythoncom.CoCreateInstance(
+    bits.CLSID_BackgroundCopyManager,
+    None,
+    pythoncom.CLSCTX_LOCAL_SERVER,
+    bits.IID_IBackgroundCopyManager,
+)
+
+
+class BackgroundJobCallback:
+    _com_interfaces_ = [bits.IID_IBackgroundCopyCallback]
+    _public_methods_ = ["JobTransferred", "JobError", "JobModification"]
+
+    def JobTransferred(self, job):
+        print("Job Transferred", job)
+        job.Complete()
+        win32event.SetEvent(StopEvent)  # exit msg pump
+
+    def JobError(self, job, error):
+        print("Job Error", job, error)
+        f = error.GetFile()
+        print("While downloading", f.GetRemoteName())
+        print("To", f.GetLocalName())
+        print("The following error happened:")
+        self._print_error(error)
+        if f.GetRemoteName().endswith("missing-favicon.ico"):
+            print("Changing to point to correct file")
+            f2 = f.QueryInterface(bits.IID_IBackgroundCopyFile2)
+            favicon = "http://www.python.org/favicon.ico"
+            print("Changing RemoteName from", f2.GetRemoteName(), "to", favicon)
+            f2.SetRemoteName(favicon)
+            job.Resume()
+        else:
+            job.Cancel()
+
+    def _print_error(self, err):
+        ctx, hresult = err.GetError()
+        try:
+            hresult_msg = win32api.FormatMessage(hresult)
+        except win32api.error:
+            hresult_msg = ""
+        print("Context=0x%x, hresult=0x%x (%s)" % (ctx, hresult, hresult_msg))
+        print(err.GetErrorDescription())
+
+    def JobModification(self, job, reserved):
+        state = job.GetState()
+        print("Job Modification", job.GetDisplayName(), states.get(state))
+        # Need to catch TRANSIENT_ERROR here, as JobError doesn't get
+        # called (apparently) when the error is transient.
+        if state == bits.BG_JOB_STATE_TRANSIENT_ERROR:
+            print("Error details:")
+            err = job.GetError()
+            self._print_error(err)
+
+
+job = bcm.CreateJob(job_name, bits.BG_JOB_TYPE_DOWNLOAD)
+
+job.SetNotifyInterface(wrap(BackgroundJobCallback()))
+job.SetNotifyFlags(
+    bits.BG_NOTIFY_JOB_TRANSFERRED
+    | bits.BG_NOTIFY_JOB_ERROR
+    | bits.BG_NOTIFY_JOB_MODIFICATION
+)
+
+
+# The idea here is to intentionally make one of the files fail to be
+# downloaded. Then the JobError notification will be triggered, where
+# we do fix the failing file by calling SetRemoteName to a valid URL
+# and call Resume() on the job, making the job finish successfully.
+#
+# Note to self: A domain that cannot be resolved will cause
+# TRANSIENT_ERROR instead of ERROR, and the JobError notification will
+# not be triggered! This can bite you during testing depending on how
+# your DNS is configured. For example, if you use OpenDNS.org's DNS
+# servers, an invalid hostname will *always* be resolved (they
+# redirect you to a search page), so be careful when testing.
+job.AddFile(
+    "http://www.python.org/favicon.ico",
+    os.path.join(tempfile.gettempdir(), "bits-favicon.ico"),
+)
+job.AddFile(
+    "http://www.python.org/missing-favicon.ico",
+    os.path.join(tempfile.gettempdir(), "bits-missing-favicon.ico"),
+)
+
+for f in job.EnumFiles():
+    print("Downloading", f.GetRemoteName())
+    print("To", f.GetLocalName())
+
+job.Resume()
+
+while True:
+    rc = win32event.MsgWaitForMultipleObjects(
+        (StopEvent,), 0, TIMEOUT, win32event.QS_ALLEVENTS
+    )
+
+    if rc == win32event.WAIT_OBJECT_0:
+        break
+    elif rc == win32event.WAIT_OBJECT_0 + 1:
+        if pythoncom.PumpWaitingMessages():
+            break  # wm_quit
diff --git a/lib/win32comext/directsound/__init__.py b/lib/win32comext/directsound/__init__.py
new file mode 100644
index 00000000..8d5db8b9
--- /dev/null
+++ b/lib/win32comext/directsound/__init__.py
@@ -0,0 +1,4 @@
+# See if we have a special directory for the binaries (for developers)
+import win32com
+
+win32com.__PackageSupportBuildPath__(__path__)
diff --git a/lib/win32comext/directsound/directsound.pyd b/lib/win32comext/directsound/directsound.pyd
new file mode 100644
index 0000000000000000000000000000000000000000..81342354c221e45a590b8f6df75c3d83cccb7d16
GIT binary patch
literal 76288
zcmd>ncUV(P(034mC}M~jdx;8)9mRq@p&q2#yJGL<BG?NEmKbC26?^X$Y(Z3P2-v&W
zuHj<$iuIcBH+#+@;at7<zVG+f_k8hT_sq`j?9A-!?CzXmaF=;9TbWE|hd;AfCOe9p
zej1kkb5hbqCM#Sav9Ro5fz*meZGuuOwi`HTlzL>uhyfA3hN=7X8a{kPq`G%Mbwt!~
z^`PNupU}4IVI%tXtL@}e&_y6!C*}5+A)60x7yo)cblpA-aN}!7c8p;8fgNL6zJEs_
zmLJ+N5cyUCKP7eljzNImr5$1Ul+*(|1_PdwdSu5?<U=+e*<PB}Keb~3%MUaB)@uh@
z-eyprfz-ED(lB3{tnYMt+3Yvv`--@?vPx>le1*%&hNDDK)S^MSc4jrAp$`5!pG;=Y
ziY&QoB(S7p{PM}d0q~8)?C&sNviFNj)(LGKzRF~8sd1Q%tQ!rO#zywN02K&7kerEr
z9WrIIc4FC2@^Iii8KVL+S|-aRdcXM9j_fx!61Wz_kPyoxyC4Uy*iS8!h1ZVg+bgn{
zOg2%EqG<fh#$N>ftbQ7BU7N2a>*NN6GZ-n2{D)N~Txw)8W9^ZAMJ6L;l@$bn49@DO
zA$k#`BKn|==>)oAyjA*Hy?#SSpd#srsh?!1^0#_kDE<HH$LZx-43naxk<-afIoQZh
z&<O>A5&(Hn@zw%1GKEs!n$NoMSsy+d%4bo?k}u<j=I?$J=_v{d6zm-tg*|{l=qR5h
z@!3T_yM_!D(0*TT`w?h{g7YW<8-oBbemWImWNi4XAfFZGv$A~VicI9ES1!F%C<VQ-
zJiP=!ynIf)e0<i0&-(D$P(F)7Cel;p(o+-`<x}wT0VetQEQ!x9^4T?HynGoWMg5FG
zGw@?V0m%o5mk;v-WNi4XAfFZGv$A~Vij3zc_N8Z#UhYaF8RX@Q5G5ZMH_o8?<2WlS
zgPPg|HH?}wIJGE`4uMyjRYO<{r<a3)h&|((^|Y-_M&rlRyFn}&<ZDVI6X*>-#ftQd
z9?f3Rn^Pf|UKyU=PLbZiJoKjV^nO&a(7VdhTUmto6X-ou=hC~xS~v|A>3Qd&*MO&Y
zvWA7;EF<IZk~O{B@C1Uq6L@+xMS36FSj+o-1ZzB}zJ;Dw5-U1Z)QZ2!m2>IU;OV`D
z|7ZH!AkZ^to!P+9WWW#lbmR0FF&+yxVue)|Lr2q$QTZ{@v1i<pdBJtvT-2ub!JwqS
zP3&r*`VDsIN`Hydc{`X@SKxI$jF_YfrMI)rTg~Z{Q@ovv(IDv2mXQ+r11*P+=oNLo
zFzTk|7Q&t&+{&786bLJv^Mf8y)`vRl0@YTO-9cI1Q!0<|G-G5*uBnq6jiVGE7mkt}
z<#YuZ8|cAg3)UNJ9U{wfdZ#j|1nD<!AYKcYRUfdB2*Pu*NzQrNLIh1)#yjLEBKkX=
zPD}Fhjdb3{ppUXv(u2LO*6dy8Eb<%VJsFL=L<8C|t7d?V!r4}#^mo>KJCo|%b^cIP
zN{T<POsTY&FP~;s!t0h&ZrX*&f{A3VS(AcfvSglLRse2IgHQ(cNNqe{oY^KXf3ekU
zqVjWQ*D~M*7^3IIiG}ujp`|-3`)Rd_?C1K>y!NAEswex|A4py2+K;XEFwa3N(SAx|
zq}`xK&lK;HY})CaIsy$w;fjLkN=Ld$mRc6il$CyAU(~y)v87|r6b(<)Ade;8!+2rC
zW>sO3g_)t}k_zWgXN5A*?Y+X;U;Q2>o?Pq{XIW$o-dJC@A_iy*=sSXo^Jdjow4KLz
ziZwbTcgt3R(TzihWe6-^L01-*B__+yza%o*(lFU!s2ru_QfL<-<86<oAzazDd}Op7
zZ?yf1ra|>WG};z`MWZ!vCCS$H8fT6%q!nzK=vdirEYTC~w=iqZ&)>i6Uw(_65)&qs
zt^{G24UxW`h57sy^is5<f-6x6Y<BELqkqwEBVN060*Jhii+iqiSAnxU+7(6~qe3$u
z`fZZSoVyism^(rhD`Tbkp$~A*Yt!}6$}$BASBIbDP>xW!5Ssw@W|ckaCX!LXYE0#b
z+1!aFbR+nOpR~OQPn_HKF-J74=Ap<XvtLdZnXA+<0hlvz(E9gg)m(Dsu#{F9`?hTC
z&zp?lY{IqUnwE11I;tR-;!o2?maT<y45X6A-VTv9;p#Nh+@N|VT8#tXqh|b=r{VOG
zqRKb}W|+?3Er@2>O-`RCsQ~wIeIW06xL>X(iRi|xI)i%F>j_pRj4=6w_5QfB_=ANu
zWRJpnG8wIC%g4KYOhPsO-0`QuUl{(ve?I#$z83$A`A@x>8e2M|^`*LXM=I(lcYP7&
zzM7^!>(DtAod#+E^Bp^fqVvFTtU%!;2RUfo4#nYP{!m<h;s^YE{n;v`sVuBND^Ur9
zvS>Zg!}>D{usD_fY5nO#M8x?Uf=2(MFTqf)^ka}$U^Fc2PktifY>NelmLP?5ptC|5
z3T=@3{oMgW8==q!4TFCe;4r2F6ozAkVk%*?GFKbFTAyfKvL4_FE3Qw>EU-RZKv|x7
z@elU3i|ng!|Gf64rg35R<;6(lt~b}1tb%=&M=OiItZm6kKd>L7X8PhoJTXFKKeMa}
z-RNg+Kd=jD>fg#P$iIvBFb|b~wjc2%ilRN}Q3>|&awpM&J@f(mU+m!nf+M;1(1O^?
zoj=x2%1S<i{1j_rHU89$#-Hq(Hv)_+6G<G`pYJzFPgzdTlQ^DK0B%fQyeYTxbHChg
z?CATG{l*f$(8`|p^^*3hPoN=;KWbR}7Y%jHk3Z`=cl<|L4;#fy{$aoIq7R6${l){j
zvMk=#J6WD7D}9RljSF5RGjA`J{RSH!alf$!WdCJF6!seviCCWf#w_rjXGLWDjrxpb
z^eeBPmt~2AlI%DB>iw(zhBw)UxZlV@HK=^b4w4K;c?Ga&l>c$R@c}`UT>D(Z+QUNO
zWq-2Y7(m^z{YH1X`fvM<1=IoCZ)niyU$iUiH_B_NjrD$`CbXAFyJWqV%>?v&v6sl4
zk*+Mp@gMgar_t)a?l+d8Ztk987i`;lDl-H8^?sv^b=%*lt@S(<rxdf_U+p(4kbuH|
z<LL^baNZQwDR;kN4FB7Hqa2NwxZg+z9##{xl3K!QmI40X?l=0PE%E&8_2B(B@(1lu
z&)OfTW$2vwgL*BAja+|V%j{8D4+^7|mA}Mzi!(j%{3dFqtQNV1Xgx^$i$H<U*`Cbw
zplVpQ^S`VI(Wv~h^<W@T6xV|Zs01atKsu(xwt&T{_fPwS%8V`Hd|I2>`uFwV&3Ed=
zvL1ZuLDKwh*Mq;B|9w5kLRlU={M&k9wST+AufOA1o6j^)Jvsd~cIfKPv?4#b9prTR
zF$#7RI@9^%NS0!~{EFvw{T;Ka8sBCXYh#Nx=@h=Rb}nRJmi}=*M^#b>PM$cOUw}4p
zl5HZL63Gm(D>jv3obijLunz>;YODhrY?7Cvg*efK9HqZmmr{QvY5u9{5T${CDV+`C
z9%lq`@0wLw)aUeXX(C1i8GK-xur`A#Vk=w!x|6*}cJnZEjVHROqbhKXo4cVbvN&gG
z=i=sZ!K?~EdsJ!6878{8nN@9o4bt0l`dgg-3MPcs9ENS&CH-f!Y6KB8kE;!o!Ko6X
zUkr_5Zu%hT-s7?<wJGt^%_W>p3j-muhMmC<cSA9A*gJ8Roo*32SD)BW+~rchJ#>e8
zIuu=T`p*zb5jPJdL53g~VuKgZpgOpPYE1_<upUAEt4W|vW>o|+X^iZ_#ZGkTB#SCz
zR?X`ITCk2zpcdt5R?QS)v#K8m1nCtREFZlOb%3)JsA$ct!4H#p0(D^?SC+}#f%U3J
z4<vIpobqGOxHAc_cjX1w@M4}Nkl`$%vMVNUhmP6~{Ak|g^zT3l%#EaEEG25QYB*zy
z4XHm#K9<BDi9vm}nYuwlVm3N}l+|EQci!_|k7SOuDr!AqwVc8kPjIX)altbjPD7&Y
z(X$5@Es&+tY(;H?4O1{#jzRS;h7>F36^mnKH<yuSRSQPxbFjX65NVpYL5Q|($pHNo
zt+`D}(ps8X6-GSW8&?5y(BKpc9?YtbKk1o2$|pAl*N_%^h8@z%(b|@lR<k{)8wu}f
zMC66+NaR<XALOf<_S7&Kv&sh@1To`R#2tkgkf5Tdqk$M_vY&V=#}smB=RHn0(Z$o`
zL*1htIM6_c4L%Tfh12;VTBk-kw)gPE`Nj`t8$X<D{BWl63&UTySycxWf-yx59h{*7
zevW`0W-o!%sd-#gW-psJkrLjbh|~`bI6XQi!8iz})?yeSul`*26IO;we5u7~a_0x=
zL)`Wt#ZQY!ABY+P`pg_Ab!O(^ZdNVC6{j!34&}GaZO|EG>mXGS%~-+M>MXF8dq{<I
zabm5hgw56;Sj>qfO9)lM&skQVrYQ?LT-hk_^NQ^PA{&}jwx|)LhYM~;F)>66$f4kh
zaaG=$t8Hj(Rwbi|w^d<h3WL)iPC%SMZ<6h*wLd2PG_dd!LRLy0K~Mb|=}tUT4KTlO
zMNH|_V0@@UJaGa~v#6G+DPPvGj+7^8>S;%jA*QM81m@8cKZbu>zr;}KJv5;BsbxLU
z-{EJ*wuVGG?|Nn+@eT5GWZGEIQvB7hX)3vF|MPWCw4mJmAN)K|V=B=|@#YEWXq}tM
zXz)Q(h>#~BZQ)N(;XBm!Vm#QGRr8q!0@dV1awA}NtPl?B7%t{%a#CnLbR%975p!gc
zvHh|*j=B7SvWcu&2g;3pMtOS&Mue2y6{}=d)Paz=((+e=zOD4h))Ni-M(1D1jbfzP
z0>Z&0?yV<l^94~X3Ql<}j%^~~&yKPl&!e&*ZtlTK%&J|iek7c1+mc7sM0wi1sC@c#
zZkm}hgqGwKKIb_-mUh&(;dJ?g!+|I)@hkCPaUdxAuf0Uipz5`b32IhtZBNW8;+9c4
z^IuGn%zwqvogORyMVkWAe}$tR{1*<eN<U|vpE|{l-5oHi#sDGpTO|dvUr3#ae(QBS
zDaRAM{ZIWCvlr|00w!fVNDCX3A&_sJDBt;ZBwu7l-t6~#kd$o7B5MAUwZWbv8I_>=
zAU!rL9i4qWF8CU>MIb8H9XH5NYvFC8lQXU&LXifi8lY}gO+s^VOs(RUW=wfu|7R%`
zrwYq0_Rjq6bJlyVe|reMur8f=*5ThO<LYnzP4p!#sG8_Y_A#YCMUluE^B25-d)AgH
z|Eqs%kJf_!_p<hHjPzL0V0!}IsX6VX%8gq&M7kij+m<>osDhXT*b~$MoQDsysuSaZ
z_tPX&>}hA-HI5W)WCV2}ic_8SSxhPpT;qA%O5|l>t}%f?(KTB1OPyoyOaqRDGpok2
z?wPLHrbmNbNk*EjscUIemx2;6AkAfi{81JOh(IX`7(v|_R0mL#9fVo|mIycoMM2o-
zX*{lC(-#nHgz@t$QtL25#M#t^C}PXi)N5U-rXb?;*3?VxI(d^oCZa_?W<Q&VDYlJ`
z^apb-7;`Y$R5XAj9%j{3MoC<+7eJ|Kz!pavYgURe1#Cu99+|*Om%OY5=CblLdsbQa
z=?s3(tzo^HRn2*Rd_9abApCd)pbTmfhQMn1ZmkwL>`AReWi0?Lv&v4&VM0DgWL7l`
zqn>WlMj?~8`1dIBxJqNJH=0#70ihgba2HpJHoO`bO39k$Sv4$ER-*3)Bt5V1c2@JF
zAmgnQ2%-O`SpRVqq%Q$+eTW%igSUe=;eu#!R96)38nc6Hpe<GYgHY-(*AA`_D4P1u
z^uL(N!ff1ne=?bMa1^b<AND6iN4h^5C~)=%)e<@D&Kk}IRVioQ#EONp`UK|TjMt$=
ze;-*Zeh$Juihw-2HLJ=|r_5eGSdCnJooBJv)>KDiEOQl&dJc-DjBO9e!`Mm!EsQaK
z+IQ&4>0jc66pmx7{;qD)Gu@<2PB+Pf_zmlxPDYBj<<z&qH<N705Nskhf}@G=GcZ1k
zbw2>K!F42>e%4L$MD|uU347!bj0LoSrRd9>Ra=5#e8HI@@>$>h8H`Rx$614~JCSs!
zb=Ba@jtV&R_<{`jF}LkRyGLvZx=<(gu=>!cN6z{+qlm;_<q}OS#-0i9*`qrQI2Zyn
zMPEL8Ur&8|cdc!D)AYzdv+5D+A05#$7o-n<OBFbM`_JG*&DOdFY!5&qk&U|WcF%%H
zcGaep1i_tmLvgmAy1@NFv+4w)^}(On9lCVWAs-0n>keJuk%nLs)mVud`u3ha6uu08
z%h{%z=An{V)%HL0LJ@)PsEsi%%uYL=U?%Iw54v9{Kf@Rh6u_2&{Zt~T;+OL`ib==p
zk8Wb-tROKU^=dQ*_gHTa;OcMdtwxv|SE!n3f)~&j_sc*rj|uYLCz81N_x1KUtCq{p
zbdet?>WJ}E8CQSf2ZP64cnhi~^3$5}^Atrt;pbW4f8wV-S_}S-^kXmbGYQRkeiq{D
zZ~VZt7(ctIn#j)`%pZ*R&-rQh-}pJpsxkevw(_@g7->^0#+0X7^#fNDe>QI>O%0x{
z64q?>W^Iq7D36+8QzJpe%BA%p(Be6M>d#z%&R=2H2barVkDu_zrY_Il7^*0$?IEV3
zSylEY{G|uv;V+56f8lQ$$-u8y*6YD^*2h*5z@TD1IEgEX{=&uz%DYRoMCQ7)hEqUQ
zsyq+k#<Cu`5GZ91D*WYnwFVme{Ji?5DlY@vBJ7@zzdj)H2Kg1RllQ!O{0o)*Jq{~+
zgxvF>S+$&}F^g#AIj@doH2&*(wH4z5r%L{r3dwo39S7><VI0w$^t{@YNtS2lk;@;X
zd%Kim0p%Hth=lT2e@2;<Oy|`dsKfN@I-kG#iM>+%Q-f&%j{bIDt+9yAZZU}d^1SN6
z*r4<3l5a!<Uj8pu|Nrv5S~5@kdBt_mwvIn1F+u+pe||ro7=Gr*Y&cK+c`M4S;?Ea&
z9>w_cRbVCYXE(vr-w-h|{=A;iUxdbF>O%ZE*p&qTTl~2p8uAgXnz;H~{P|zwu@4zf
zKZ(Z<TTK1Ie7^fKIVm1n?Fr9=B_7+8)pANl9ky8S!394*!(kr(9FH9`l++kSk{ct%
zc<gRQ>EGh9M&e0~$2x)s#JfR9+B1Lr_HY4n{B}o($Hrh2{y&b#9z>sFJOi;a+M~?J
z9+BzjHZ~ZvZ<|f!ES{leR}_yuSeYv2#$%^39SZSS+L#FOSgij5q%jP&U>|AJff&Q6
zj&9AWNI}*Ao7gMO&|mt)GU)5){xGW&iIO*dmx|it4>5`J`oo|cD)~?TP{-4lMKtpG
zLkC9VKl?+*1H4v-Hwft^Udx9S!l1w5Lh26#nPk8AhYLv-P#*I$%71uKcb7zexDs`E
ze;C7G{SW<NnYlE)(?Il>{_r#Fk^JFw(h&K>SFHa3r9ZU3|8NEbCHB6~zyvj`Oxj=D
z`x%(NmA$vWPoQA$@o1N8@5un9_Fhu3_ea!$XzxwXtyvWZerSUKukD@Ur;_+xCc3eT
z-zA9hIZ*ex@w@jGPzw%3!*0OVWV*)*!Im}t$M{`Iq9exdhA=TsposTV*t%MtJNzHV
z?_62$x%>C>BJ05##yZXueQ@>5{qkh0Cho1?!EYhnXT=%YKk?@Y7u5Xc^8|^LC*GxF
zO&D)~i+4R>eQjyUxU5FYn+EP9?H)Q2<6TpMglTWUJYb7T7r>&*7-QI%py(IzF7br2
zin<Ub44p+1YQa|?LfCqLY$1xr&T_vK$U2e44-OGi{C<|=OZ_1RbNvs{0H%^BzC_PS
z{BwNCOsz!b>M@mUlu9YYm+m*Go^D&kmlmM0CBAeScxVyvrST}w6JOfLn&$Cpyf30u
zBHs-({>gqlWDY6rGYIkf^}?to-LG@Pq^%BIu2AJz!!#60H6F{j%8e{V638@e;q52<
zHL&nU_XpeP1^svDSwrk&6r(G~Z`y<jTrHvsqN*#SnOW8NCtSU1Mg()YdPra%uJXoj
zMtbB>{3hzQF6z22DjoY*);rm}A`bgE7_e_TI6&m(It!~Hd~+Lo7iLaiE2u-CLpfcP
zNf(8<OH`&V3L@-9xjs0ZVm=7sVbl>WxlZ94ef!%ia)V$V+sROD2p5*94Q?7}NZ_|-
z)dnIiI-L+^_#Bv{VOZtDqFS+MMpD=YK@y6Y;5^b4{OS-0!h%x(Opb#=X4e8PlkR{G
zL_i1oG^&H!L55&-F_M7TNpEFQfv7&7%>}1GRs#{6?YO}H7^yxOP7WTj1VTTVLg>fD
zhknw)aVKz$_fAkTs|P)et=jwF+E9Gv1gc_KDeCi9d`P_)HK!*yX6isv&YtgvR1&cT
zGyC=a2UM{C;m<>K>vdKWbd`J*gDO)jHnL^@=li1zrASA4_eZ-x4GwNM=_v30&DT`&
zpY}(Ccp8I=MxOoAOh)6s?vJW79<Ynq2Z8>!KXPG(7>|3nknWFaFv;?G66^C~I?YDf
zA9eg0<%^A}yWIWJ1k}M8;N;kgzv2gk%`Z+j)Ww+=X`IaPP>=XH#GQaX2x$g51kt+y
z-#jr6iJ7HG4PoYEN7Q3K=bPA#(~rXbVFGU3=0t{a`Va@RDvhsOa#Ty)$Bb+Oe;-U7
zHuiUjf_*=rjY-l|y8v5+N)MtcZhkr-_^GqSb0VmRDVm?XijtjAbYl9U6bgu>y}-oW
zM;({|nzr;DQzwsm9PTIUR=GsOT+FJ;#2scTn1W-NYYXpbh+{Yk%o|i!V5xXM5PcJV
z1n``GHjjrYMv^MRf^>adI3N8}rU8^{f>7!i1O;JUzG}p4LlJw(#?qKC=X7x{Gr<OI
zGWN5LVs@}q4Nl)0%4!82?Z~A7Yl49#(NqlT^X8~Cz<^KBIfW*Po?<yrhFpK9K6{#3
zF=uc-0zPX`mP92*1=_&tdAS1g&G6tyC<wR7C5(eL@VN2Z5k)juirGo5XbgCmLIb9V
z+sg`Q&`R^|N-APkQ5m|6!~Pot<nw5ZFnEe-Q(3_k!~q)0WLjPR06c}^!1aNJrg2G`
zc8L0#RbEW1kzLGq7UgU}>^X;k*c9i0rmqyU!ysYST4*DIWHj9=P1FUo8x}F0VL=zw
zcM26{rfz>hEBcKLiLshC5Tyb7%ce!Fu~RDez<ByW-)z&e39yGTh_-k^Fd9ve9)n1h
zgLMf58wB&Ao9CT+b_LI(MR1V5EE>YROO0ADvSd~{6Y)N9EXP^*v1Xfzal$~cQQ|(m
z2-2Iyfhq`&Fi@QS1C5js%wr!v&#D(Fz1cf{jCMB=&BvX&ON`M06!BwJjunj%#^{wI
zt`I8-2A8Axb{M126c(p3dc()ZUlOluj2^OrRI{oxDr<H2KO3Vps7;o?A9ZP*&S9J|
zMxPY3gIHg@z-HAFVhY<Fb+G;nTs$o*1@J5zSYzSeJwVf7<cFWas!)ur0t=?o+zLVu
zSrI&M4n&3R^M2H)MF*uAW?>Y5^**2@8s)ABcv2)qix>Eaa%mv&m<he{X@>$R&H51&
z-ap2Uvjg9EA{Ds5fi88nKdnm+Bv1V)1>O1xKnv8T-tyA^Mg3C$R6j_6KS0;jAwV~(
zBsr>ZOs8#0Aj}86I^j(#4|9NS!g>4|@pn}JDcBHb3^sVvF|#UD<vR}=EP6#Y>mKoh
z@o=LZf;#Vmb_=?Yc2<EI8rd~MO?RqU4sZI!f=XmDdTfd_t2VP*krO!sZgrbgdw^qu
zOCA$7JmI0usseSfu45g?;&hH!$Qf5O$RO{EZal6M{tgPW8z-pIlgYOTqd-1aLl5AA
z!g;f*D!RccJaY;%_GHkNOuE9#X_x?yPdB5$9sHKk+{T$bNfCsHD)HFoO(l`Tqk^3N
zpi4A5z(9nvhsGr96&`%lvbO;P^jX3B&seE2?6^-@k5~sYoe%--hW4@q_;{#C4ur7Z
zo`OehA|07{DI|#!L(_xM%u?Io3ODZ9om{i(Ayk1O2*T5OcuonmfjUM8Lg8sl-jh7O
zW&i=d@pwa9JjM%fJ&%KYm_V48y+IjETt1I`MC?AWbjysM{e*`Sd=*Su+Y^sfCgZ$d
zc{PvTLa7-?V(|P#cB02^D_KP1NIO`a9)T!zXK+eoGZ2A_nsum%?Nq-2i~BUJ4(+_b
zOj$0rjtw@U#P0$iXx)ViCG+o@jDfFZg^vIpcF?wyXa^b627FsQ7{i*gWjZ(c$$VIT
z60H5F`QRT*oIiGFgF*A*DTd%z^I>X7syrLa(R|n})MWFaBId&=P{CW<{Crp<)QYBB
z{G3<`{NLxqgIc+BVn4CL&k28Y#m|YeD9mooM?mW;7zN3kD2lEyC+yG_%?TYgP6l~S
zCPDu`FHROFl0TalqJpLNQXfmUS+yIZk6~u^@}5}&3loU;vWFFsy{!IDcUxgEb`Vss
zmkYomPQmK@#9n#>@lW>R1w8DfatBdI>!c0-$zIreXEPk@F_ato8Ec-p5RTj*Y1d|O
z8gh-eQ`IJR>A0?l%LgoTKPFbl9}ZtRVlg}_XXC5t$d0jaP=&#YmVfOT&-uc-m^*Ms
zJJ!!p)(CqpbfhXRqLm_gIYZMT1awgm{T`ZQt;aL81CK5wqOXbQt_<zWqvay{ponh9
z&}tt21Ea`TTP&i>F|>w9e-hE7Mf8t?Bp6;nBi7!E=#C=#5s!vsKxc_)PZ4e8(U1)2
zCnCC(h+fB|AsNv3MD*91g4|OXnk}CO)pZelPek{zMxPbY$3?UcL+9fKJ1L@9i)dGd
z7Ic0@L{Apc_SVGris+sq`b7a!i$Hvvh}MYc^9(I;zFtIE6w%wPTQ3yR`9$<AhPLH7
zj}y^PYY1u?!q5WeQ6l<`hz<gpcE1MIZz681h;wI61-^QVXq|{wGITz^<E|olu!w$-
zfyy=Vb|N}ZL|<cQp>?o`t|_7qGPJ;U3lZ%kq8BqX60(IxBKmc8LFmy8Ef~4Gh)xsH
z9T{59x2`Cn_ljswhSu=t(jt1kh%Uv@(LCBwL`R6|ulcR!fSrhLE28i5Xix{|auHo$
zL?7qTpbqqp7-X~&Qi<r*JepqeG^jp_=$vYT+>-@#K0<#M(YHi&PXR592KtMLJ}RO$
z3~j>;_FhCU7ts|NIv<bD7SZEHbUua_?C`#b?kb|6+LKy@0ZkRr%|!GWh87&<IT2k>
zL~pW2pAykO+yuGtg)k5=$g_4-L_ZSI0~op(k4_NLMiI?1^g$lIUqr7H(bX8bFOS|K
zqNj@Jf()&3vL&5w6w!S|bT(w-Cs@3QqYoD_SDgl&_UPN&So{pC<s#ZmMDNXQY7lXS
zMBF0Q)VV6NlgT3b6<|g=%9`>B5q(8OcgUsON5t(HaZOlLVW8TH=!GJ>3`66%rU1{r
zB05q;e@8>@Q8lluh9bJXh<?D(HaxnHh;AsNPg<khM05!ey_TT`3#=%jKUWcij<#-H
zT14Lw(Y+WNoRhYTis(cU?FBSHP>v#QjfktlniiCebwJb4(ZZ~pBBJv%v|N^-=G8k9
z9WJ6xm=t84V`l>WhltjS=nD)zl}Fzb(UnB>c82cDqwkAoTM?~i=&L+BRYX5?6?8I`
zp_lOJb0Yezhz@4xgFO0_h~6xsYcq6t9(`0q&k)fHhCa!o_lf9%BKj>xN_+G^kKQh#
z14MKNL(4VH8*LEL)kXAvhOWoAUL>L&Mf5_3?#S!hAfjKo2y#a<w6l#J4asy7ohqW+
zGxS)V_!JSnTSPZx=zKhDBSrLF5nY0zdnws~4ieELMf7JIk~^L!-djYs7SVSYx-idq
zR}o!LMAJ<j?NL9zbvqGVR79_2=<_@}SVaF>S&(}oLvQENEkyJU5#61kZFs>NiRi;3
zx&_eK+`c|en_Ew@OE<oBSpt<-5=-%cFREMV7?l<hOTWulDMkEn9v12T&X+dCk;|;g
z6id_jQsXHqy(pF@q7)nV!Qg@7dj{23oa4=^dLn)Wk1q&rc>FSkFT&#^C!_5g(BN^i
z87`+1(@tb>;NBZW9K{FloVI}T18&I)5jT<HP71i{z?D8F;zlyudI48B@5?dlt`Z9~
z;RtJXeWpeqt~Xig#?tC6EyhxNmU5tEcJ0m5zAWv}(vd73&(eu3oy^i`mTqV1s*2Qh
zGfTI!bURBAvh*-ZkFqq8rN>!%lBGtLo@VJ~mR@108>8&S()z5VHoI1{v<ORIvh)f|
z(^-0zrQcclkfoU{eZtaWEam0m`Hx^Fyu2OQH7{=yc3qRD<yq>?(tIralkxLAOK-FE
zB1=gw@hob|`}bE=h?CI|C+}^$@fx}_mz3n({}ZC#Q8vk3(go+NSq{`P_x?t<0vj&V
zqvGt~T9mHu;F^LJFZie&7yHc|X>WStgl47!g^^}8q7?Ty@C_8xEd@^M=TX%yYbP28
z_0cxdDvtO#6bm*Ka=`1LC4+3wvjV(!StvT#V0R(7>G{a=T75tvu4zVuqgJnVuubBc
zrbpNZ#3s3AKMv3*C3_eVlDwSN3k0bj1h1+d4elb7^>1twRgOa!oNZE!Cw(h5s&Im1
zK0<IMqipxuB-caBew^OU)g4Np`&h(dQ}76ZD&`_MJ?D@u=fFrY593=-vCrwxbD;IQ
z9)(NYlK0wVe-h<0LsqoSZ)ybvWS26%0F2uOMinczt7pv4Z%P2L*M>Ev{yZ+2n%l@^
zaYp`r8hxHi&=u;%8KbCC5z|E;$ZtA}i|m(H?M(+zV%m*FD5UoM^Bv;-BOw-tk4U}6
z!wLE<Qzyn|RPoqvHc`qT{W%J#r6Sa4R!vpYJjTn>hy#YP*-8O01P<vo4@Hi$USp%k
z^i-6W6=6fCKhIJb2K5b)rrO{IaXGo^1FK43F5~4?0>P>|;DWa)#bNm#G@f>W1@06+
z$us3^0h<aILXv^@f(DA2&hS71=<6&lv;UZ7`JfC>E4q1KG?nS^L=A}jVl!s2={F1l
zM#Bwn@40}>5F)HaTQEmlcObYfgClE0%O3p|Bjg!vh{yBh4~i-Ba;Sh$URFUyAmsq-
zAUh}jaz-YzVH(G)lnHY5Ybs7gPh(dyNS`EFpj^8WlW8p1$0-sQaMyJyv%MJ8nAu~`
zqr5$8OGdQ|s&QIzM2lcBBKfxIxMXu6$WZ7arz_?X&@>~mq`p<5pr%O?1@&H-1wl=X
z5tuWl-LfBH{H9%HmQpNsyo+oS*-Sy$r9JX|%uGuP-{hHf$J7<7^|%VXIL6(J%FoSE
zRe>lpwq1of(ap=CL^kVAq+Q(As6wU=MFCtgg(4FLhK&h6A+~u=GMp>|yixg0IYlrq
za1r#9L?((&cThlmaS9*AWKZ+GkdB()rdEo$i>ScqGf@9L3bM8V6zw01GIO79moa|2
zZDuY5aaV(!-dDoy)nu`MgS-)y&^NGba!%Xevxg;VET(@$V}x*-SeLU76kv3-JWwpq
zpLR8}aqJ&9k#3X}kNt|Ke9VdFv}rv;ZrO6vC}fJmMl#yu0Nn8>8;5(41tX-jIEjHJ
zF?ogghM;hsTea_l@ZSFgQxV)P!}N|jPmC=G2eWR^L_}V5#3r`+y3;6BOoK_uQsnai
zfSSzo43*-Hk)fup&VcMGsf7gQGq@aOPF<0i;+4#ltC?c>>T2Md@c3(GfgcZiio6+!
z!sp2}^~@N=9PpxvGe@;FeTEzqoQw68;dTR@ls98D62^Njks7d<-fe^QPQyV=YtAss
zn}Zb7k<~q53P@Ys{!PeF{1?JmbDrpj$osf!W_{7i|4Jf;rwH%iYM?%RR>6E;Cw~Tn
zY06hYGwRspvrv#Ps*!0SBr_EUrzQiESl0-YlP%T(uO3%5v(iifxXQU*=3eYm8`EOc
z)+cAL=b4y+F`qXN-}=K>G&-q+befX7FpLl9AU+68?(i#y2vbMVSQQS^Qz(4>8eJH?
z%(zQD#us-VGDDyzc#ML$Y2j`ITy`<Ds%shencKLPfwygN!w#j;n*J74W{L+x7SvK}
zR4I5&9)-J>Q4K+~9&^6b>@PSEy7#*{$#jmtK}YX3(aKs_tb^xBN<)F>NO`Q;HcFG*
zV{NM*Bk>rSyq3Un0YfJny7!P>Oss2Gtpf?3hirR~dxYh0bd1Gl@XsjIxas9t!Mxb^
zY`}3h(sck@0+)3Pb3z<jOJF-d|C!d7cbG`<{IT#cLHZQB5rZ!$P<%S~&PCP`h==xq
z|Ipu|+a*J27eS$%F1Wz=ycl>sv4EY7<{o>rz7v(<c^SC8m!1hFpjX__L>Vo&?D4Qv
zJeKX`WrVHVf%$TH0~8Mv$*W;lIlNzr+a~zf1ilxI3J|Xd73<`&Y}-n=$8_=;z@*5#
zqlCImk$1!ujdzN?mvD6yn;{uD#7Hx+Gqp^yv!R({Dc3vo+C+qd?9^f*?l(F4h=pjl
zEC?K$X^3ObcnW)t1R`v*C+g&BE(>D131aqR3u>eTL~_@kXL5Ey_of)IM{>G>d#w@I
zkkd_&GlTfUcfhDvCtr!9MT$HIDKFauT=B9^6Rt#dNw!HS!ydpL>y8b;-viNCFwe1D
zauBS(q^_Ndvt%rc{6b1hY6K<^fsW}uNhJ)%Dq_lNFlzElPNPgG&%ya3MSdSC&*V*9
z5tI1D3nv@xOrLrQlSMgT9&#vU#f3)~1ZfUF1Sz{R>g0#f&RU$^fFTaXxR?zZtEq7|
zwNsnvMOZbpYm9tUB`TvEpynj~1vt|vG^8gh!vgenMowpUF&j7goNl#(R4p*)_yHu}
zFMhTMH#v1!B{}`E&*+10V_^@KhOmiQ)r-nutM$0pzAm1?(M?rw6&8g3FjVP|=|Y9!
z1YlFh$l|#TMy{Lql^r&3@ZKc*NDz7}!_Wt)HxDxl&$Oej^57QcJ6c%LUt>#u1F64o
zOMmC6KRi}r-QQI-GpEFw^G)0b@iaYqu<t~0vAvwZvfKrtW1Z#nNt~{=L+%<(-#I-E
z&D;pUT80ly=^WX^Lk7-4q0DERfyDrAO+eDUHE~fEX=bu=eEZlSKg%wOJmy8Nf8c44
z`zh@jJne(OpuN*Vd;UMrrf<0Zo$s^)U|8f9KG7im2)h%+X9{6DK=}iqJT}Q8Yb{z)
z-3wM_dZFx)RoNI;M*DQOJ4cJ9gw=mR2XLeyWom~i{HLa9O9MkP?R`(X8s<)O@8hz)
zhe)HXl!o))Xbk-~8VV_m%MMaL+<rzQ_9aIKr8ZR}S7A`)*MVtPFdqbHUo7D1Q4`=t
z<l=wh@#7rGPU8L1OyR4Ad0oy*CJb~BJz?p_qi`gsvxm{+f?~aoKFQbPo{#>LHs<Z{
z$bLh$G4K5Q4Uh8CU)8_$xS%z7+xR-3SFG2@ydN~YUx3ce#n<s7=-BDMkmrI2D-;#R
z#X6l@3yXJs+tRFPZp0^2BHfyY+vk%-R%||!veNRsU%q26pdRDG;R{OikJ#IgG^&^n
zzV8eNr;R;t<D-+){qpSmD4U0iqqGb1F>v3SzMWWwct!6%dRlGm#J&}YPYaAH=<Aq-
zw%ySrMP37p5Op7&lN&A-i7$#NV(0S(MNx2!)(2g=LOia_sBx%KcGM`4w@K%co~Sv;
zbPiIf$q%Y4B{xZq>Zq4LTmwgW-XTSviVIsJAisnwZBDW}(lhqFIz@gEpqwH0<LW4C
zrTbLA?bGyjR7pn3C9_#(lvAwJLSQwzayn#Wf^LZ7U`?mzww&2BApAbz@?{TWWBEi>
z!f`e^)^!?Os4SV;XnW4E(?x?V8W;1@h#v7J9DWs_j%^V<m7V@lYBlymi0KTr{y5X%
z`C9GKbUV1)UXY!C+_oAjbNbaLkmU@EZv%;a1M{$Ewu3T8HWNLbA(LTQC5zX?XS59_
zLXh7hnslM2O~_3mpr3Z0kg(e@PB)FZAx2oC_UJO|mF**@&BUeYBE%3|U?mC1>Jmmr
zTjcF%D9x(<poyI%Eqb6w8x6c<u2=+(V9}vY>5NLfY0Rn~xWt~Y5RPRI2F})WlI95>
z*iENiV$P7xy5kHK^OD#guE4jC!E2z&n<@}wR#Ds`2T#}7u-iTT6~5pKZK(y#ry<BO
zpD1F2iNrn(rzQrV{w4{0%)}weo$JFPW^!IQqgJ$>QH#eW#DPNL(N3`mpK&3Jw8JTr
zKVeef0&4)M;b9%u71#g@{aAdQz7+ghOw&H2hGj;Tjh#@^E~>b`t=cd(^Xt&x@gU@A
zRm@kJW;wnk#C)6>CNy<oqXld1>0oNZUz_$K=f5kAZ}8wr9sC(o?T3>d<Tr;Qt8tO5
zaT+n3F*cX!+^A~I;}Y}W@+WA)ZfZ5K&c2~fIzcegiRxmFGpO{a9#F#=P$QjddU_1l
zmnS3w2X%o*`7T_WRiSi{V%s+I`x&f*^Jp8&uF@e!(~F8F&^Ya@lZY#Wss_X1JZy{(
zXlfi?8b!;f$RIDpFjmaxw)r#^70_B}qeh#)e4FPCBet;;3g<O8&bc%W<fYL7!m5b|
zoxtU5fP|!w7XdaV>}84~3&I*%e7iSIKPD_`*dXuC2%e|0N`ffo6-!A_Y<bx{HK@A4
zhItLZ9WcAowCBJ2pyp!xm4w8>CC#eiw2bS0@u0J>GoFJ3q&ISP>3RWwZ3tHL@OXlK
zA$u@lm6>YJ1J@qD&YVXQmq7Qf=zoXeD$~haO>+gdr_SvU-z!)S?6G?5AJtlpTjgBS
z<fuq1E*j?HLT$wbooB&OE*F1dRsAnqBzRc5LI?!ACb^bafdAyUPjJ`r>I5=o$@b{*
zgne%FAsU!v6h1Y-106BPD(Kwcgy%<Sew7A-&9}OMvp6^#3`PT7V;%@O=$T$XAzZA3
zi|Kd%BA-Y{{>3QzWnu47&OeffG}j=@F2d<;Y2d-a$U?+nvIE!jQA8HM`2fH89HM1j
z8_Jd8+ZL0wt^bR*i05NrH@gP0v<FMWS<099W!L>#I*_G<Svr)Z!&y3#r4cNRWGOw?
zV0InLQhLn5?D~>jFJb9SmR@A(ahC38X*5e0ur!XPJRKvu=IfV*w#}~PS^Alklm5-F
z-`VwHmePsC?3&0@p8iR8&C?mruFoJv*!i;bPxQyZdM%<U7X$PeCMQ^c)yUI+*jEo9
zcvl<y6i-xM(B{bOg7g`YMYVd3LvWukyHB@+Y%{n%=YuL|1oTO6r7wnO8}Xl|aCoHC
z+abrt##RyOs5p!~HuEi_>_Hyr=0evj8xv0Be2fIg<AKijE+eMlSmAYp0DWgL^gfuL
zIL!iEI9deITkGC-rlGJXy|0~1|D4;5Pv0^|?Wfy5wnm?6-gc3QDyIeO&$0hFAl1Y_
za?JLvxxr+spb`F`5jI>mkitufKg<0IbEa5kom=5uFS7X{V&P-h|1I-JB26T`7UOA(
z!c-8v0(6;+cjNIIQ~Q6!yPF#P9G^>H^>chK{g0S|zwY1NbmQlEwaEXWpW_Ak?xw~6
zh==_Dh==_Di1#!#_(#0EN%fC-Pt(We|0KW0bmJfKo~A=T#|!$=m=;^(IRky)QI>Tu
zgN2%YHs1Ym>(het2X+u17h*iIkuoY4CFzr}c;p(%tY8frxvT`5D^|s7(-xG>6NWVx
z!B=*GLGYCk{37~#%q?s=X^S3Ya2l6IuTc1o)VIg6JUHAG0R0gqcl1pAsKy6ixMtS~
zY<wAf;UI&1i*V<|3~nRBSw|S`CBoydT%&zG!2j?61R<j70D~X7Y?jj=8^36lBI%u<
zFFAw%6pnr&0z6U3=Lz{vA-^c(4~6`_kQWx(R}%92Le2?!Zy_Hm<a304tB|wKk-YrD
zU)>gRvD~=;&)*NB{zw7dE#w=8e7cbPIr8=Cf3>5ZM#$ZST%>D~^#7-Te_N1mClhm_
z!8`%pD&&WS{IZbW6!IrR-cZOt3wflF7ZmccLf%QpMZUrW{zZ7K4bP979e8E3`a<4H
z$U6!7Kp`J5<a304yO19j@+(4qU&vny`F9~NF7#I#yF>c932+M`uP>DQ33(?Wj}Y?d
zLcUDMcM7>t$gc?b6CuwL@(u$1okG4!$Y%@rU?F!9_~f~h$(G>1rJ|ov$bUy*f_`g+
ze6*0a5OSH2-<9+A_6qq-A@3&SZbJTAq|4r?L4QK-DdeSvTqe|Kog=A|kEh>7$ma-o
zjv&Wf0sb!JrG<V%g#5TrenqG+(k&S&izdoqE*sCoYDq5E$N%xk>W2yWJR#2%a(5+<
zA1UNUA$Kmqmxl}aULlti<;!#F{|_&AwIA2N>5z-w2?56k9ZED$i5gI&>EV%kd<}oB
zFK}*g=MNhq=fw=Qxu)D*OcuU$Z!zV137lE@$SsX`nsRR+nR?IZ)CNmhyEnTRc1^kJ
zhs+py$Ng-43D3?4CZ#FYKa_2kC3tj*zE^Ch$CfL~O%+k!@p*XWhs_7PYgq6r!aA=y
z(KtgnyA|Kw*yDHAs-{<!33br_(m%TT-MQ{>>Yb)sc-+UgZ9ADPMnbRUWt+x_;x>jR
zHrO5$aWsBqbpDEaQ+4UeJr1(?3$Cffr*(?%_;Prfa*=jxW!t2}Rb?S|clQrUSFXDO
z{*FF6R&?j_XUnHJ1gw}7`Sg^_;m7XNYdAL8m9Ct#neV@l`^F!g$N6jb53W2W;l;Lc
z(Om}Eue9P1|BLLyVXI#GZ+{njcW#YtwoB&hDDz|0)1c!Kx3aQURE)Bb;PXk~dH(kk
z-nD}KLA?Ak&+OOzX$9L#>iZq{&MeUu^@I8P-=`EB<!=R-uTZLWjZol|A-{dKt&{zm
z8B6s8+=j0oC(++D37lDYZQx|5bmdBWw71=Gv_;vZK|>B^D0huV`_n5!9E!%R(>B-<
zdOYTns>6H7R(GfLn0?B$q}7UPo1Zk9-KSe6uQHyCa^7l}Ofz@gAO5Iz3+;v<^2y48
z6~B$Nt^4luq8?f62L4g>u{K&+C}8Nud3&|fy1RHcuH>`Vwdj_(oN-5{zyDG<F6@Wb
z5p|7xeU~@t<E{*^-Ma1S;5l}#)%qu<x7$9h#+fGD1G#N;YksJ{t)ScMPx)@7l=~}W
zQ}?%lBf80bkJf2<wc%n<&8kIZGi!IN*ydp25y>;FjchgNwL{$Znl2vN<NfO{n`|3$
zAmpW@XN`(;dL|T)8vUuS&+NAL#iwX4FRy5HY_|1${*Y~>h7`MWsmA15Y4@fMNIk1L
zb$@N?ZmE8K9@*V_?X@pfyU($Ua_NS#eOIpEUcy_yC~*6a206jo-@UH1dhxt<HxmN(
zEIe+Sw#%cd%6U{iXWuHm%YT2qZt{uJe@yN1YFB}TQhv(=KHe&~)A7=izrMW--_}pN
zc4k=ramp)8&OP}t*QVA<zg-E9XFWK3(A<Cfoo{UyFV!Uayc)i`-ycUiEdG5&tC8{k
zb6rjw7LK^<fA{E>ZGNfWe75QH?HTmYukxk?XXXqXc$zyI73%JDa^{vnErJGq+E`38
zquuq^<2LmgP&}d3bi2&k!7KaUHI0bwzwG#_dtE~EuM1A}yr*xt|NMunugeN|`SWq`
zmX6_d-!0Ag!~b;=nRZ_Hz?Ea#_Ds|l^9tMau(jv0Gl9#?{E^n^WRLS_o_G$}Wb$gY
zZ*ZpO#h|F+TUS2q^!w4Aka_94-Szf&x>@+#)96LVZnrv?=~Q>|n{$00*Bjh;MZkW|
ze3xy5e~cVG;BdsK@3nTk_MWj+l@(W^=EbdRXII`;@Rc_9&!s0_YR*+>)=Q1?82iCz
zMx&829}E>n-b>1<c6a(&ZtcDIhbL6<x%*}PnF-%-5AxYN!6SQYm!0vORby8_n>;yS
z=FHYz<ZmnYtu}1uqAQ~|Yopip>62LT;AGd4>yHe2e%f!7U5zCduez>_{<vk?C!6iu
zDuqvjn$?~g1J*rq&FJ3H|IiN8h6!C`X2?s}OkMoVFWAsP<F)Uq)0@XrjNu*RX}-&C
zZw#+jF`w7Ts?XPsEOVDz=rkd%#KC}h3tsn0G5uCm8<(B)%C1R^=FeZu_3Na3={NIu
z*CiL8g{E&(UJ7{9;ajWKp3VOp8}Xz}DcA2i92!;+TJ%SWGKFvW?U?mj(-YD5tAl6l
ze|+`e&gfyuC+e3TGP$<Tw)DP--!z&N_i^#QjjmH~`$rd9t!=n;`V(WP0+~fmUum^-
z%#X{jYQNr8xj^j0-kbJl<EKAee=hOr-HUCP{5~a39=d(hrP!9+3SN&}mR>aEQ!D?i
zZ4RF>?Xuk(aG-0qYP+6<tahy7T2(PVMpu4m=!w_ueYQSa)7h@@DE|#_xY4T~v<NxW
zKkQ32&)(6-A<LJ9?Rx3Ipy>$hjNm)jZTs7A8EV+7nO}I_$H2Ih=L0;pcJm#+)_45`
z{~_gUE;M}MY+k;va{i!g8QtpH-_jm5*fn`k^;D72rFHe{(I#DmI`NbHTso%G%&EC9
zCBb;e@7C@9D?WvO2|2XBOTD4%Hx61m@mTjP&#RiH0im-BukEY2R4elK;1<mS5BzB4
zS2;D!ennzzjC0mqZpNTuyN4x}DA@YW!{ZZ5%7c$z{`9<5_~}lbiDkX!l#bzc>Yg^y
z+r50Yeqwz7J-cpc_Ks=WWY?=QU(dX~I_1cZ4Z$%bo_>3Err*?}Rs5r)m-g^I;1F?5
z*6jV~%{TURdT{!x|JqY;MqcjLxnEkdUZcL=8|M|<A)rCdsoo!2*K6DE<Wv`KNs|9z
z$4Doc-KcyWb6VMH7lc2((}w%r@RMiQ@yyEM0ZZ<B?AX(}!AlAJYR>ECx;Hg4wYqbM
zx)-RnBuD}Wx7@uqD)aaj-`Tngy~?^imPufnzpmRgO(|PBbVu0?kFllB9NW_S{lJPj
zgER@7xX9uwpEN7xdH+~e$v!@_+Gi}SH__Kv_|ZlCSAA#s=&D|s@TKs9?h?3%&yM&a
zZa=n#9yk%$_s@Xv%@TM^ScM*b&WD@$@8~4U$Uo^!NeNsk<;^$E>e{Zs>!ua@Yg%OD
zISHJy;Lo6CubR&E+4{w6`h^J}w@ct1E3;qSPFuV<bW5|ny_PmycwPcuXk$|&xZ5Os
zz|1H0>$hF7{;ZGjxbL*vPrRqgUl%@?HKem=gvZILPJY^L;h~KJu8&Na)oQ!`T(Q<Z
zbM(bdoG2C5Xw8&?4L3bK6}<1hD%-Q{z&;YVZ~BH;X-h}<_uW=$o5RrStG^xy^9dQ(
zYktVlcU=<}&W%~OcVV@m+}sM>@pG~VRlT;`UtB-ByU|ofv(BSpr+`|WcFD86m%Fb>
z3R$__=RwoapVrqc+v&^>-BRB<HCC<K;Zt}>r&|jGUAna9Hja$xK6dxxQn6g636~Fy
z3yxVE8>y;!a-z0cu}2@&k3v?oS`~ZkR*8(Nbsh}7vQZflH>1&_XGObz9cO<srG(p{
z;MMtBuV_0t{hYQ;zTW~;Dh8j7j8}Mc?^L6%+WwFFh2Mp)9G30e*+b(dfvfo+K3nKf
zQX@ZI>4(YP>Q0N5z;SV19@P4+%Vh8Q)$cjZ9y_C638#!l**6~e&KSR<{)3EeQ=j@y
zn7c5!AU9)n&iLf?ky9rO^60wS<Qcr(Z_T7{6R&=GH^AXVov$IGyVnKJa$Mh3-7Meo
zB5ubEhQ_?SR;`O6ru%|9Nh_LduNrb7zs>GO?!Q&LeY(KR_WQ1T9lz^TzeDSN_YTi)
zwrJsqs$RQhWNrBI(jjAekq(<&a?W{e^d7Y|y{|Der9p&`VX!f1j?0=oBNK+#kia!Z
z>~MEcZ(8rO#OBlcrmgGm8@0K?r~c~b(D<_tUKe_Is(aR-cLQxRZuxC`+dH~Q@#1f^
zJJXhysFdx$yjCxLsWBJwZ%K5S6z8bm;tG|??`>4{l)&LOZw@T46SdAS`r8<Hn+lcN
zea?~D-rTXx_ef}f!=TcdLsQ@18dG|1s@JqezP<%xSDNZRs^k#6s;p1^IHzZ6vQ-o0
zQ7iGio2em3HV0o_<zC=72^_KM?$BO62Ko9f-L>?7tuha0N?@J)C|RcN<14R?Hr?+z
zznFIIYqvU63cah$9eSMA#MIO8(BTCxQ}%^F_ubuoOv~9fF23CIrhul_i^QNckLEjs
zY`v6Rwe0lIFBW(6pWd~o@lwmxLnbwr?R8w)oLhEbQ1$Tev{N<W?*G*{_I}8sw4^EF
z56edP`@XY+`?j-zYdyn4j7yIh?;k$8aG8DC;5E<eeX?ZdyT|A=6MNK}>9=ceQ5TO6
z{Q^~+uPs`>^=zx%HJ;thso!u)bI+rmnU}`}t!dF=<GYDxq9t%lhbKPGD@CY$w!K>A
z`?dLPcL`i~?ecyf_qHspU0<c8&9a9{?h?4}%+~XpyN}%+uw{i}@4DyfWfIt?X-ZX}
z4okbWIvSXAV#}&gY6)EN^@2H9rVozrJ(a0GUCuUDBZ0N|hKwuh<b2bA{f$po?{2El
zy7ZClq0bjo@jq0zl5gh$wMv;rw|{qJ*>r7!&mUj=`{cWGXaAmoi(hZ`pBtuCIYf`z
z*Lg*Y?l-bzftyd5>ziBm<AN0}5=$Iiq*<SFqtCeC<3DJlcWvo%aCgv*4X-a99JuYV
zs%4c)8^1pfm=?J0{ize(T*}QFKDO#XAMXYE3%qc=e{x&l({VK_?|Kxx@Sfa!V)FM*
zoUfu;OJi_Q!u!gT9}es@`gYxJt?PekUOfIUW&G^<rgxh6mDAc)zs>C{_E1&QEU#U6
z!NAhXN395%yZlIn<*N^TEgD=pY>!tppS2lVE6%PmM{WP5$m=mz12u>5KL1*}<FJpt
zhct=Z_$b3~>gUWg_0y}}^sF<0TQPorp#F37X(vlP4Ef^ny~g?;Hr&*r&GB)c4XcBH
zPaUPcwLfrccuM;{FDAdY4M@B>!n0=3tb5%m9;jz<H7q>X(^Os&xT0BD!@WC}cdM?C
zd(eGWYo8TQ8mDUe%^eytq<49{G(+gBlnWEPDk{(Syy8-LVX~M1iG7iwfon47EFHMD
z!}Wq!lzW@dd2-9h*sm+9#spZ-mkTEsJiGWqeQr(8lx?e@7wA7tf_IN;n{O`8hbz)?
zzKI{+U|;pe<vw0WQ=UrU&zDV>pL_k+fvd`G#c|$AnC|&?l2i7)QdL6_-hB1`^_h)9
z0UKQhx<pM4UZ4njI{3hj^3Q{n+k2lLq+NHu^37$JM;(fj^fz4s$4JhnQzh`9PRnJ-
zoFcf`7Q@_IMDIQvE5W<(e1j2AS8m&m^J}k@3x{Mi40e5bMR_X8L003jZONe$c!UIw
zFVQ9PT4cKN@DIqZ=y<oyhvGLY-MpgQewOsPe8W>OhnYQ#{qDW3{+5#V&*lCPY8}|r
zc*^lsM;FX1?0sm>u_;4(EN^>rd_cn3h8qf1J7p94!;>rfsddPj%W>{ob_NYqUv}uI
zne=Di!R<9{JPbBfoaYox4102`)%4<NrN>`)eld2$`X~8!XNGK0Txs{Q%c9iAC&u6W
z9Mhv!Oq+<O<u4R@eg1TttwE)mdd;r+!D;Hk(lgsk&zSO~&{fUeb&mFfXGE<zI_3ix
zJ#Yd(1L0{i`dq)@vCCS_TTnAXv$EzN13xw%5c_D(RsFrN1tIHC__Uju@ye@;ciNnu
zzWU%3+YH@XtZCucPI)3Qr+3Yeb=|HVK2zdT{EuzTjPrijc}0(%>JgMN=I-FZ#RL00
zeejNc`nq@Y!^az&%%0|V&grS|k?`xU-wi$B+PqlguIBTOw2JQUcCC-?uzuR|bzklN
z7NuR{n(ELlXW_;1L6=_bxLe$7W9^|~orm2o*V03Kx=h)t%0(aP{5<QTMgn_DVCSiS
z-Bos+AGr4Er>^6lj61ce_wR2$#l(1>n1A7>-L@_{3z}bibNf+*-)7rLwJvbivYHE9
zym7qVI&^kg%VqEOukJoCNcpB*Y6!RFd4aS&^Q%`JSHb3uOfyU~W6!B?Et6Mw)V(TH
z<j<y~wCn0MJ7}L)ukLR>mc2>2aosC1xK{oawU_)kFyHqX?N@|*FWxR|Rc`f@q0!Bk
zoa%fwT{)`;?8UW9QmKUO)D?|paWndTZ1z{fhnit$E0rC$tZV27UDf5o?z=g+oHr%&
zuioJyvmZR%Qn`P>Lrqi8Dzo~p3ye=R6+8F(POaKA_jZYlDDFFBQpoG&iJ|GnLO0*M
z2uN4XTn&3Zc4Tmp1U@Z+lO^!uxJ{0SM_Ssu7y0u+!IzjHhe6M{yhZfaGt=V?>B>bW
z=s#K8Nai^`+J1;7zM+ZQZr(cH0!LSPHfiDNbfs<w<dtiyMK7DaFs)&Ra%CCf@96IS
zcC(redY_@3=?Hp=cdaV!_Sv-cs&d_X)Q|lmCnBy}=JnQyw_E{?_=}y}xYb*G0w#Y0
z_=#!n+oe|U;a;DYt_!!|<IQ%ppDhFYn6Iy?QDony?itFtX=FbuLms}&8liiXp<KOJ
z7Vc2>w?tW;A(}2NGL(lk;BVcR!R~t;XS(l2{AvpyzY4D^iN7rzmM8wU=v({EI(f&C
z10Eg5>-=WVj9&hsUHIL!-1v{W-q;1!aAv;o@p<4et1_+O_$nK|Tf^a-+7#_&MKAna
zO%H20T9(+fqDz``Luv4jcwtic-Gi(5w~VKzUZrC-USK>A^5Z#Xjorsy+*Req{JehD
zLmb|(b+xn)@790gs45mXv-$6F+x^m%F(VM8R;z}u3n(@7!%fThdiP%#mQ^%EsoM^E
z81G7t2F$pe2zU@rf2^cG*-YoYlNMXr+o;?Yex7ZC!<+8dd&?t3xh)3cb!%VbI7$1=
zJNIkGTk)Gu(%vhngwHMy3%@=R*j7^iPrp?c&tA(=9_a#mXmg;5ucW@81eQtK_mc42
zzCqadSi~PU-GltL13piZ@NfJSS)<+jH08EbjK{#~Pow32t1E3yQ!Xhai%w}9GF9`V
zMbZ29(v_>ep?yK`OIiu+es*6$U;hl{mUS}OXWJd$>q=ntu<VS=Sf5uf<=e~7bRAf8
zwWYtz9$5{?OtbVCKCqnP&dfCBsu0wdd-Vw4@`umBOBVRy`>LT&iaC033Yd6(_VKB{
z)i(!Tu3en-iyMFV#FvFn8zdHdQnvN7iav|n%RM~O-&A0D>pc%nck0hAj!ZtRx?X!-
z{xuzrRE*0E+2uTaewV*?74UrJv#!XTXThtN{O+&Wx5?%Ai);Jc>$)v?pZQ|-5(dA_
z^M2pj>D~tU?fa{9#^IVx!v<u`J3ewzW9_!Yla9we9tp0S5mRAj%SOIy3Qe9+s7_$}
z;%?(>^(ge+ch!rIg?prCU5L+W*RJ2aE6N3Bq2Hka5x;fw+cR@<nlfGuxL3!WBL|<W
zGT;DU7amrhUSwmt0s0Q*<&WNTu#7c4&*ez1nuz~y*~;sCz65suY^t+qf4XwZ3?9EO
zwdUyJchZ%Kjmdsr4Tx6{`dIR+1+KKP?m;IjSf&}vm9m1vKb9<7b3Vq8<`c%>So}`@
zJ(-sA&~!-XJYWg>o5c4QuX{Px8b5M;m&8->zpIjXd1R;W=loc2kuP(>Up8hdI6ipO
z8SD1(_3Hg@-Cpb4=Gmq>8Om8p`1={MD{tRh*RQ;|)xwJ#&Iay^zj>$o(nS?z9%Ezs
zXl4biJ}@=5;FRpT^RnWf@2cVGJ>%{=ue7L#oz9hO8JXB+t(X4M*<f4O=BLZ_n0nWJ
z;4Sai?v7n<SL?7om>c2NqfsZH^%46#pL{MjxUjwd_qM(22PQ<#(N@f!(ro>mq-UQl
zo#0jss=uj+lTO<({XkOIrq|wc{RZ6_Jt*C_=ANi8tyjElHUAHL+v&@$c&6UX*Sd@g
z?#GZn$NiWq5;#o)k9u9n$*+}DE8Tv(uEG8Ly1p;^WLx-(5!|V!Z8iE~Wsl9Zd-Kfo
zP&w_a=5gmLR$QP+m$Z+Rw4dj-u&tr@Rpo94-+x%cR>Q2}@a|0`t>O3yKeDaiJw@9u
zuj;-caPjbzhy$OZ?dvXS8{7GiiklPC_)2*8`|<T8u!jV8UOS}Eq(T|W#rv^8y&qX|
z@1F{8zgvd#<R{qYskv{`51#Jy!Vms>C)ta(S{G%*ezhiCRnoh4pQCmb8SA$5>dFHd
z${BX>j|=ymxN!Tu!|6u2zx0L2zi69r#lE2h9xtgsK>|;dz>_5KWC{HE;^`4%k6%^p
z*^K$>a{KV7Y7J{Ok7*n*&EajgAyI!Vb*VGAMBil0&v2d}R|#B20<YV#r0?Ed7JBO?
za8*hD=gWQH>HIA9Bd+zFK49%t<&5gQK77V*D>&vn^izn3eI>A)gkI54^Q)iQcvX4q
z5$b!~yB)8XRpouSh5kATENx$@!zH`t^(^(3H@Bv?8VG*M^ZlPr-IBIWc2&9khM<q#
zkA4h)mZ98!g@>p4eRTWF{;G2Sc#L<Yx=X^VRw>spD^0oSrrSNcB$@2^=c%RjEw3t%
zL=u0+lkS@Clp9l46TCNV*^j@>i;FyZK5dj~?hWnq!?zAj^FN$6;aI~mM+y|w9`v15
z%>CAZmS4+OJebgWZL1w)?=9bdY`~nT8>!FwyV->9t3CPU<ChCN4NQ36;$rpsLHa|J
z3pFowB<$<<S%HdTiC**TcAmUvd+l8*f4rXcMSk7q(0rMr)4NNHSF9RXxVb#uXZ3=6
zg_}nyreDk+o>1k$rjVI+>U>PhtoYz#z^D`NiaqmMHEwC;=zAKY-eLBFgwaESHZ|Nd
zZ<^=mRM~HfYpht4rrgmO_W#>651$=Vo8QI#P!aASfqP2eU<v%#$J}7z&@|=THZqMz
zgGC$sBzSGh_c_x?Tku{ISR;YGC9sbK_Lab)lK#RZ@K(PE&Rxe?`rjsjH6^t+)2;AY
z3G5|-qlZ7f)?loKp0@;_DbYuaq<-eSsvDiH+CP@SPb9GVsC#iQtNIlsaQN<NoXH9w
zzj;#IMi+5DDJzRUU+C)u<Jt1Bwi+#PA4&b_efEDgonVp2*x}R@MVtjrlE9}WaIyq$
zCDDIt2^`%f@_Fd~H05f#U%sVu9Zl7%yDMP-A;Mk~SSx|!_1m^SKbxk+<LgYm_}7)2
z>|2zcYrpFxaCmZ`S(BDq<c}Y$T$XquLpjxm`93J(x6F!)DUVNC;Kvd;zDM^dO>S85
z-Y<*$s^{W-hiAu)W6LCKB=Tt`u$Kh(mcY{a=PSWW=aaO3W`W;bJ42shyy>w7ekOsR
zOW^RLZFIA?TiW-Mz`cL>>1>VfBZ1=%2dx-Z`I>UhYOJ3FeRfZi!0yrGPBr1y2X9~A
zz3;1rOJ#K>a5U)Ewu+a<NZ_dwI9385KX<ER2dn;1NZ@Ga>+MwcJ-Cf!BIl0U5Hl`D
z0vkU)esOiCC4QHgZ`g(pR{T7cz)vLbpAz_^1b!-kpGn}i5?DPoqJ6V#mhpHm!GDmz
z;Wf&Qh`(W}-%A3Il)%vvI7R|bmB6tQSY5VVQI9zmeN~jel_YRw3G5<)T_tc830zeI
zyGh_`61chqt|5WN$D54&g&$t&VOJt-!<WlMSO9Y~;W^A)JYL3OKO>*{;W1kFGxC|A
z@cd?OeLUyQenvj?6Q1YH#p7Xa_A~OCA3kKjenvj?!&|THXXG=#Vtk(49`9hWpOMe}
z=sh#~8CfdxtHS5Ga8(H`K2|5z7aj}EtuH=iDdH;#3KL<q1g<QBT_kWJL7`%Md@Yat
zM7Xd7rZ0=p&&X1lpR)v3O5h?AxTpkHN#NoVSc)$t!At9xli({$;F=P+h6Ju9f!!o<
zH3{5A0&66&%!yvpx9H1O0=rA<*OkEaBrqp|10`^f1P+nFttIfR{Y&;8Of2nucop^o
z^~>d#wR!3|f9@6K>ZgDMkG8gv!1*L_=Jpel)iG&G-CEQisCRxWfuBg=iVkzX^|dME
z9QO+MH)^L8tt5eMCG_niu*^HGzv5(RXZ<ns=U!-sjRejofo&zQodlLkV0#IiUjjQw
z-~tl3pagc5z=b5RlLRg-ffW+iSpq91a1jYyR06x(<+VrImceUhW~3^2anNV8Rfp%<
zn|E5n>Sr^KS;O(gy)vv}<Ipzutl_Y+<ua{d=Vckstl^Q$QzmP8Z=idQH7xUY`;iAe
z{%z&EH>F`O;1Bj`BZ2KR^U8C(-}fuG`)4Q(vvIz(+uN~Z<8vEU&&*K9W?_GH`rP%%
zrPT_CwD9^~Zgs?!$MTCElf&Nc`+Q_W@G666m3(hqT#_n07@~+tSDs9PeLg8r=VsXZ
z{x)O#w%XVD^;Wzy?PC0Pa<UBP-GirT|2ipuU&;Nrl4ZMI|BCbX+A-)~{?WbP`w_+h
zyWes#HH$|zpO_fiu6&<}jbqc5$3H=yBL}K~T64AS#74z}rw3*?nKpW1=b>*eW$IJ?
z{f^D5($xFym&k<iEiNV>{JquG)*aV;@z5#yN&0KMy7b$emRGs8OV4kS1wJm+UxGg^
zk!OGeKTra9C=<ag9&lB;Z!6-zwIkP`AABWX`Ut?!d026D{pz)!16pl5-MWlJ*ERpA
zy>Ee!s<{52ga83~1O*E|@T#Cu0hfS?h_ai_hO8#pb$0{NVmHg~O|oUPyY6mCVtvF%
zTk79O+S*^K^^uT3QUw#WDpl09VoR-$XsONL+M2)8n*U$a_@=F`zweouyL<QMMri-k
z{@PD3OwO4(XU?2Cb7t<$+&gz~sCxC{-TA+HVMgC1*dzahkKQOh@Y<hlKF)S`_`8ns
zu3xMT8{{W``^J0qp=Fg1y&Kx}!GdEwtp@s&27SM5pc|ieo>z6`OZQE9+WC#;uitrK
z+I_K~8uAxi_Ku}`aLNVS=lv-6hILP`ddfgIK5xBr{4+OSornGMvuS_g{1=SRU++EV
z;^%(%=D>{muHp3E7u@<i_m4hWYi(b1V^waUue`yaZ`2SsKEI6{=$9GdJ0orGBk}y=
ziA#k)B@FbWA^yT`?|eOe%iGTTXWetc)2}?fGG(AQ8sZxb@g_t3s<*34-6MD&^%(k3
zXQI2=KyNX`FE_;h_~?ssM`m1az5j$A*Y*72l~<m;@<{ix>0h#Kd#3z>$G>@m`gqGV
zdzJl=zf;J+FY;gB(u!K!6DL1)l6B?Y?>O&!#%urm_2mx@?b`Rz!^0E4VvyhQof}X2
z>s!B^@tr4G!7Enx)}_B}yy&tgCzL(#$Yp=={(SyTH(mOb?-lP}<a*@&+i$L$d*_K3
z&u`r~=<Ip&6=mM(^<Q;tfAWNamzu7+cHHw1crUqS)9P<N^unG0`;%v$C|Xj!u43uR
zvag>r|ITlh-@fMxL-|)4;@3B~Hk^p}<y(&v&+o4?(2u+O-9Marb+Y9C;h$f5!_SWQ
z*4+8YGIclj*NFEOetX51%TCvgKi7Y8r8mC+#Tnlj5Bs$IuJ@wnel!1;NaBJU8Xhb^
z!?owE%{!iYyS3F{{H@bpe&W2>Kf3LMN5T)(S6y4#bJY*dzi-3SU%%+nhMjXew_o_c
z^TW@-vF@&)Bxc?6*UNv}U-szsBi1$4KK<u##|!tlo@%jQ^P9)t7`!Rv+x_M*%MO%(
zTDCKMd;N~$H}5(y^X|)b#7-*R(e$lH@3<<wIyGU{`78HSJ03k{v+{r5-1^jvpO5?M
z&$i8R-qPYO{P1fVrlh?0EsVw&+uDEj>!01+S9sewlb(O}iw|2$pV-*?@gr*W^^@JD
zzk2iZj~usN`@wxJw=Zt$-BA7h-48zKyeTq1Tv#5wt3Ri^ea6;Li|>w1cxBvo*2en3
zcFD(s1uM$$U-DMXzGwfmz4_+JU*7iUZddoDxl5j%^wL$^diNiAp?0h78{e<3zBF<4
z!!JL1#=y-}9M13m>fKE%Pm0|5ZmjtmN8Wy>_4Yfz(75tydt>{THlAI5@y}g-7oPd*
zJKz2Nop;}M?4_^e^p;+K*QsZ$Dk?Ai<2L{AZ#*)u;+}hgQ&RUiR!j_j=zZcL>|fCH
z;JJVPU-^dkWJCN2Lwt%MKGhH}FvMpV;zt_dHGh5Pbjy!loPlrIbA9I2+G3~OwYB*E
zBhG$p&eOSl`+wf{g<q|Hzv98(+g@Gy-uY$Mp0^{qfBvr0hyU{9kymeVpIvxE!PQGP
zpL^lMtqV5zxAw0;@rsgDpWHREqWz1V=X~*pZ@+Oz&2_~;sd(J}=nq}9UVUys;A_9!
za>s{>*DJ57+TUJx^SKi&+b7v)Ox-u*oA|PdGUc|~p%;d}_Kj9N&)JvH&bOS9G>#8A
zs+)Bcye7`O%&g5m_cCx=4nJ2DKV860lCLHv`1VOy72ObxHANM*IjF`{;TXP`Ag<R1
z-(WPGe|;dN1R{}GFd&#)CEsxdxtuSN2(&0swMmJn(YjPU30_g+Ew<a-URetB)vHQu
z{g>5XN(m>GXe^}!6nBeck`&@ir^$?=rqW2DF3I>`B~>3tDap7R4A-_O>l<rp)x<(6
zH5iBo)`uhER9H<eVl32D%*n+qDK!aM-tgs6pcWETnQ?&<jw<UV8T?gI)OLd}5r`%s
z))PpnQUwmYyimyI5)z>D{2RiN7?+{M)r68%gRy96fdVC)>chc$B@{>nsJ<yFHKB%-
zR7|IY(x5iP5-ng?ql&X6oPdG6vBqdfXuo1bRU9%@k`Y96sG&tlS-7r#Axf)_B^m<J
zpsEDo@km&-6LCeA#-xfOkY!^a(g-xBgw&LpXuwBxc+shFgQ_Id%NkK!NP(QsDjB)e
zW;NKDQWq(uU`@tqQ%!+{X2qn!eFSn~&16e5r8dYqEl68RX$nUo%6e7VsG_R%&>xXt
zfYgk}lz1W*RFlbYw2o@2sU-@l4<thR!gMklASOjZlaW{xY_CboG_WFA>H{0O4Zs>g
z4~WD9p-d|z$<{Dh0<9*ROqVI3M8XZ>6miS;Q>fwLUF2WxNT9_YZ*-wj^=cp_orV0q
zs<hPM!EMQov@!iY&7^aF@N@r9)1*)UXGo2v!nK+M>b;#BI2;W|8bhk^qhLZsuZ2AW
zyi<<ys_YU)8T$S~Jy~?FOdnaK_%a^V(3s?=w;0NcC&CQ@G_lB>ln%o?g)Uh%BD^u&
z(Ab~^VE=|dGslzYq)9&PG{NZPWTLN!5nJD)z_ecHB@Tauvyx{^$8FUt5^t()hJQ8$
zQoKUmRH8AMYD|l0A$yQ-G{GIH>yY1rnY(|+XH2VE8AHbbJ6zRJKWbfF_e=Lav!3i#
zQ$jy#ucVsd+DIkjz?3bY`<bp@ie~nJf}iVhl)5|>HlL#!ZJ$ihK)~w_|Kr2%Sbj%D
zefyKYQJSwM&IM$~xsbXsjL}8!X?$F*2uHnIlX?RU@rY_1D@hS>i6-S7yx%Cv#&|rI
zp#Fr$<O7r_<J6>*?&x9&C2tX3Q*$L=Is6GVRRo$3rF_k$4tx1-;RIrUrdtcYDjOTt
zV-!L|W;bFoQ|m0>;zME}(iCV((jc~&H#Q{k`js_Rgqz{8wn#)PCetqDtf^Qk5K*G(
zGNqMZRCqMq0wA&>+zd-&RMu=O%f}suG?iQt484>s%H1)E4v8vcDdA0FFbPUMc)v4{
zG1{Or*GY~=ibqA$CEz+3HA8Bwwl=BM(y)#JEYhOHg2BebqU?HR6(Q`IU0-d0$kZ4v
z53NQ!$!F>Y(Fd0+t20_OR}Ax!gsPe}kWf4Qw?s__6Jb8n(xx3S0&f)>iL^G!>RuY7
z=oO0;Thw%Lfdk;q$?xrGI{nQZvj`9q8R-ex6c|)75(YK~!jZuGh#1T=vpW(Jkdqf<
z&x00`WNZQT*kG(79!Q9BR6n^OhZIi5Jt;Fm(^?IlNV)VQiM)}g)#HxKb&SCNp%!iK
z2@jTznx4X73Ir=>x5H=$8q5A^!<#5|$oALQKCKts3qL38XSe_7Zhvxeqy4i7f%G`G
zq(nD{Q9kW5X`gh{ELm8h#A8WJ<zrC{b9%oqG?A_xg9{uU`HD79Eh)i-B5RzJ718Wq
ztf)!()c+SKm_{_BR&v(7Ak$a>mRe`*Pm1Zr=XAS_rEsXpNB0g4U}}T5HlnJ~{4X=x
zgPLNg6llN%IYlwKP>IPKMS9*W?m5X+3}cNl)~KA(*HG+O<%+RVtc^w$N%u-V&f8;{
z6W7TB`H<=p2_))NOkS~0L(axnBksPm?4ueUv`n&-**dXIt~Jw>0q~i$|KGG|l%t-u
z@Q@3~bQdu-w3wpPgqntg%)L@9Q1znHgBFe0SQj-yH*_|#LIC{@t2Nvbh+;O8l}pkF
zjCQe5X5M004|%hVVqy>7!Y?KlQCK?TRz+*+AZ81Jy7ZErq6v%zx;%~1aB2Y-II3LE
zVL%_fI4y*ZxLNAfs0{(*LiM!t#4JI}t3WUqON97sPFtzNN|+vtdzRDy-B_e)<_>Z<
zO2(lN$y3qGd5UIsF$Jbo#HbZCZYP$k^()^tpqlZG63pc^A>;;uXbbK%2`tCGSe?S5
zBP~)hEJ*bR(u~TNE@{uvri!Bql{ZABhiJXSr|4LK@s2KMB=BomU+6b>sHSH7I)W*)
z(%|b1o>8ncGV?IAb%tUWb65)vms*K_M@3b6iO0Fd;ZX|1(Gcx<@ckIfd9jb6TjtsW
zalZ7EqEV&H)Q8#&y(b#Nnx8KQl|W-C98+o=qe1EeVyd)WB?rI`Md&o@^<o`Q%Ttpv
z689%wny{?w5Zq3>b^O?NN;74Qh4O^G(lquzXFV&8E2jG^R{VX-TJA@OvOj1yELgc+
z^b1zrI{JD2q4*OC_@}xP-KY8fgLcpGrq{-_w)cz0z1*V^`<Zqu(xPfaX2`5JgEBp{
z(A4^Frq?odg=>Wq17<i7ffK`KSrNotVQNWxEQYZc_kxXTxw=usmtsv5i5~*(m=UE^
zFO3kw8<1{G)HOC>uvQkQw<~BWf#H+3Z!-RDmKWLCiq+5}5ZBDYwCD;utv-Tcb4T)F
z3<+#d6PN|mhU+LZF7TTrGhRIt3hHN)%9vK1yG4HsWGuc<?vvLD_&W(_21I<Cgo=d6
zNEn|d=w!Ex8nF-R#0St5wE?+p!|N?PB3%!Cl+$UZ*C;JR_0&a~E7K9VfX`?L{pJz1
zZ&o=jgP)}36n%DkuJB-5g*l+mo-r-T+p{r|fJ?aLl%BItyBd?jD`*aZv5)^1l7w3t
zIfY*uQ&)IXu{g3xzy*Z8SA^vzI**IVOJO<Ye0*f*`<@NqB(?&vUtgPuH7MdifGD0x
zevyV8R3A(@X*VMXRmtD<QBHRUqLfa6$JfLn=o3O9()Cf{mpTd59y;-Y&L#0WON@zh
zoh0Pb#TYaCn5YNcSM>gz?zU_M?<vqLZu|a5zpgnW<JY23XWbt@dpxk~1_WtuGZ{q6
z)?1c=^!OkCKD`T8h<u;v-zNIOA5(!u3O+`E(GFoV|5||sMq@-w-?X(J9&IEWBiJ2D
z(H;ubi7wGDS^V+1N>lilX$Dg}WSWr`yz%$hLs=!;k;akA7(HqbkCe1tE61JBriwbz
z-?Uvbo7SmD>=i48n9<RL6)eK&#z1Mw)9{2SRj;I)@E`*ZkdiCX%YVM#*c6T~DN-C8
z>9&HKT_}RSlx+vDFm*?^=kKh)wM^9i3JieynIyl(L9Ra0fu$AQC8<jr`NdpNcrodt
z&nLZBpPiYNMfr5;WAYozGUOXooY?6nF36XUXOYIIVcH~HP&qwwv*!HSok2f}P#&kV
z#BWUF>AH&O+;kMbM$^m4wCZU28coli85KtJYcvynt!PqrlwLAlnkU2`(ehOh=eH>h
zu}~xY8utTCTN)#nJjo|bx|(AfUf%6#E=QMW3%}drtgv}5u5eYl%+kF+hsVJw+5F3k
zojx=E#mh8;<hQ#jea^}%SC!X;XGNKEGfOEUM$^ac@c5jiPDhDM*3!KWNGj23D&?os
zHBF7_nx@8dO;h-xyWDoMzue_=J1bX{UwVBuUzOKS$&@0lOuD#dl)LCFnA}e#za}Bg
zU+%JB=r8rSD%N_OK8L-^<8^sRK2LYRE*^)FCFFSR<^D=~rdFPbqj_A&d@+?nbVs$l
zyvmCesEl*TvJJIzmy}evN*tP~60eMxIcy~!N4d>Mxk;W(FL8Qp#pRU5FX+b?CsJry
zK`oss>$LNFb3Rn2%;qUsYx4*Z8XwZVu2SEqbi2<}z67nS@lm|g<G85GQE5jtv(nwR
z%B=VrS9w*1)Ks6}?eaQ(PFH263%)}_baK4V_QH!xUG^$(R{H94SFx?!B;DadOL@>d
zn$)7Kd=*tb2liTh6}D<v&S$H%YxNd84t|>5R@mHb>B49?x5IX!!{et0aF@9%HGVB!
z^t}w<MO8L#AC0bgHdh1oNT)+hS5>9#DVg-u4p)W4=ed|3Q<FV4{&ae!4H?%8ac1<j
z&JyllQtxy=RGGI=y17INnqI}abmBBghcB;oR&obN`=NRL<&IJ@kjS_lhIe?7RmPE_
zOzUT&`DLM?YjIu};@Y!$UT``tRYCtZEV?!Q?4}(O{MtZ(e7-7=913*lSsh-cdwl7U
zM3Z0auJpS~OT7-C*XMFmYKhnH!Vl!}3wWi=zsBkDRoTj&m!NaG&}ziv@Ob<-yWQdS
zmN+WYBce<%NB_crTB7lld*EFduFwxijDGwiImNaTv7(p!h<hECC8Bq)u5xN}vd6ZJ
z9wOc6a(OX4$?=Kg((vv<udKAKu{m|=CEn$J>eLwG(*8;OrPY!(J>-b`taem7JT$CG
z{hXC+P>mA1EX<hhws~w7q@BiJ>9Va}?QyJ5n@`HAbcy}C44;$ytJEfYt(NX8zQAGk
zVf-l7dX&)1<tuY|(3#6@UK)zi<+-YSuF?ueh07y{8(AJPl{?lr$}1g?5?*y7hm1|`
zqLo)wX>2ONS5@h)a=Tp~YFTl?uXJxmP=4JeCf7%_4ZZFob~e-bvNDo?>JuoQo?z)S
z%5vl17W2`eUkNxOp~WKJ^OJ0>P4eZxB={5w2Nq}Zxo;Kp<&y4}uy0v5pCb9{CB0R`
z_>ycsi{#rZ={qGXI4hfv^t|z%xgmmd;=qrvbQs}fO3Bcs0H29~?-Q|G4K(^;75XK#
z9?*IuZMi&;MWn-d6%>rtpX3i+C)+{7QDy#v^chu-OvoD+`WWfMQojS5p4SV$vNO%=
zWz7GNitEjjUzo#|zs4BeX&v(-ez%TZqr)i^$<Qu(QI>Ek0?E~187};e&#5`A4|KdE
zJLX0Fdvx?c9Zs1@hIZ-8CAs=5!-evYr|@-9DU5ODBHgN^R|7YeO<75nCR<-Vm#>qp
z@letr^7KF+-r*hd8V5?hjy?o@EFDM)$t0cW((6Ix=&!Od+KK&M&xId8*@yBGj8`G@
zYjx3=6F217cqo4x@@xVfd$psk*+_3k7^^%jgQj;r67=O7_15^wer|(KL?gYdx^&Ww
zc<Iv1C4Kc*zCrgx(V6m7n^+8aDLoHivo5_JdYHA}u#SiF&Hlro*-LN#osexsKI|!u
zx`<|0f8sa0Nbfx+awxrDmq%azFv_R~4SR#5E~1&0PyG68GvbG0^Vz4F%d2@qFHQJ?
zmO^=mj=j23*YF{ht7RlREZ50t2Yx7eyT{ObL??^N(A$;r5FLALV_u|Bv!vtGLoBy7
zw^d_44)<?L!*7AGmoS;LT+Y}+IN`_@jM1dq<1O+2F1O?Im**Z;@kFv?=gH3ST~xk(
z#kyo7xGvtpHv-qKZwyC5>#$E4Uxb8(friksr3-`c7Ch>YE?jcXI*%Gr14(tAZmVWd
zJhYw)X6$qs2%n3v+U_eSecW)0MJcs8H7^t<n)@i&u~tiKh*H`}3;Hsk;A@D^vsic?
z`cVgw)|{@3h_{3&A8W<@f#iqj!T!9nC<*fkRtUJrVhPsP;eK{K0>$kf-@IzOjd%)>
zMhiKaRz+#`*?gB!T0ASw$@4a6r*Xd4tTZ?0+mxNg`P#D5e4KA{b{gkvM_LWe*DXp=
zy`aczvJN~x&mKsoRyX1?`<mJmy>*x*LHP&av4e-^1s{yp<jzYViDACOEP$e{c^hMq
zR6_`HnoFk0wxZ0-FTXsr9_C~{Z)&=vg7cg<UWdM{v`cs$cIwl7g0DX-P4MkO+5t>b
z7d4Bz_8)*hkUl&<uNf%o`=e|xRq*8hi81;ub=mHGBV!-ZXr3$6mQcO}NYnYpQc9!W
zpX#FWgwHIaG**E7+82-}%}sNGRwVN{%#@F@tvM$h=R5YT=(B^<khVU_<II}FKAD6#
zohzX>JIIxTgZrl~&0~4R7z-xnvB^s(u*pRe;yL)eA)bbxT%J&rYssQ%X}Y{Kba|J-
zTJ!e9{}<xVa)i8TG!!gy<IjY7?6%yK@>q_L;Z8$Cc|zVqt_#Uak-RJM=Q@PkX>o|k
zyN#Wco6bKumv}8QZpoQGflUuhWYbZf=|xAx4_7_2>|oG2i*^V$Dtilcx(I*PA>>VK
zBOCSof7oa<$?L$MZiL)v1D~gjMz#Oj)c*Lh1R;0Y2<bA9;n%9N+da##=FFuwn~FA@
z!loyVi0?zYFNgmMyXLdWo(b_8Qzx*gpifOq8k!iNP(!}aMrC~uf9~RC6?_G5R>pob
zF84U()yg{}j~%ge5<8-3B0jB@$EK$yvhkq_Y~)nr#X#MMtS8be3h8WAI>rJWUsgNo
z{5~t4d}BRhM!T$h2jw~N=R$<sX%^^eYL_`Wx!nK3UVkP2T*vdRM748^av7T={fu}v
zgH&?|(ND?l%VX5NZvlQV8(}-L=<A-H4%_JXW*GVvm0N&;vTzRmoPdx!%}w^7$JXc0
zrnb}Uud7d%oeozz>9w?gO}{@sKCxzk`>>TUMmy%ci#kumpQ8{k9vx~st^|9%1Ai{$
z`Aplf2BaF5=-KT!R{t>T6J5w&xC4J4AUV_8{+2$`dLDl07GXEC>ir@+9n&5iAHQFi
z`1^wQpvPJGb1p*ew7x^NQwZ$!4fvDf`AqG!38b2vh@NeyoH6`8ZpFL-;dW%v*DE_6
z^DP~pnZL95QKw1xGaUir>|ytJ?#oBA=`TuOmOd!^lEpZtw2?mF!=JmjJ|l-}<2_)n
ze*u4f&GVVsct1!r?-Ct0K4vmICN+s26Ut}D_$IPraBn@P=;)!GiR0MBE#u<37T9(E
z6gK~Z2~62HksZ4?pH1IAiA@eoX5)R+Sf3LE!Uc>?`GD*{1(U!Dcp(MjE%+Gt82H#I
zK8!!Qe43wWwipY}Ibi}T2o<n`rPEl!{ZryKnA`6{xtBnN!l!`z0wH%=0hT5cUSYFx
zb4xR0)r{Gb*=*=C+c$~LUYgHl7tI_wa;P9qW8EjnRyh7cR01J)@<;{L%iER<kCOK(
z%sFWObmI72HXinAb2Iih!c4HA2p)ahOvf7VaUH`zVpPU7tI%<NZf<2pM?St8%Ifzp
z_BKMREK48PkB3}W(pTO)jB~w7<ZmZ2R*d>$y2&2EMEpFJu}h%{!JJ&|Euc=ud}(=_
zTn*05XEWh5GvPBcVUw9f1)2FJl~t^hb+EXUIb&8nn+0E-1slwQ%vnV<hDcxB64@Zu
zb*t;}bM4TVuDgLhsEbQI-J&0fc?IRg-JiV!zG?N?x0ZSLA$|(tTV?!A;45@=il3{a
zYqHZ&)@RZ&=qpR7vttrR56z4pRioMVGUQzwX6#3hPmt&H<hn=AU-NTVKG|tT4x6!F
zXRk>)Y!b!!eRL|DoWR^YKab@n^5WxaFmKn|K!f`G?V+Yo9j=vS66A9Ly5Ejx(~rd5
zdSWh{m~&LdA7+h5n>@m1<?Lh=$WQcT8ryej9_DkC*wiB2vnS=UNkyo;kw>3jhf~{<
zf6_&e`=td?%Rgr_n*$%21K*ni-<tzJnNu`ti1_KcJu2YP0Ri=Ya}ha!bOmcZ{Z)Vn
zt;^`r_V;E3-`v2Hvi@j$$$CDwEK|?eC)4T;Wf2dSzHAfH&2-UZ&|WQF`f@%n(MO}d
z26^0G$U|@t@mCOr5Zb(qy$6WFIP)gVqBu4>@J1G1F!t+`iL39=^jBQD*rnguD%QJN
z+BDj^N7|lGv=r>?<>at|Ymlt_4d&~|VeN}Oli|N)_|Bh*{V4dGqATNN^n*gkQ*`p4
zLmw!FygfR;*N`><K8ubo55IZ59DHtF+B~FHBW<TH?GmK*BhBo>9gD73Y8Qg}66Q!K
zz<+-C`ai#WEj;2szk4n0@UQZ_*Nz;#!HvUg8}O?6S{y=(HDS+>((o3&T9=@+5Hh(6
zZ;&i0S`>;z=&b>IuR-7&a@{R1{v{m$YBj1R!a?M=rBVs@g$aIli=VzWAx`^X<i)7!
zNF@At>lR7$+Hk|D+@SH?M~mEQlSjq(Yw$WEW@3wTkiR+Trxy$$CzfE7ArbH9`rUy<
zQuWc>w~U=5xz^C<VgwuZUrCn|mA}2rzCO;~QWXscV<FXVOIG<xmoxSe>4sD2elNbL
z;j71svLW^uB$daab^cPkNKXj+P~(yZ0wg0l1?l|!Ddfqju~VfU9vnHvCu*c7PL$0R
z^;fD*Y;igty}6HNa+(S|IPp+`9V4aSq$$3vBZQop&P9re@@&x%7g3m|;UEd#dBzfh
zWWr)-pOpCe&~~a9URn0@9QSFpv?X~R%QHG~ojwM=g1;5&w}nDD=mEh=963v|$59qE
z^1J9G2sq4#?IiH7c9zpw4%IK8TwoOnzLIbd<%vpZ7Wy<JncNT@;3aKHH!=_VbB05_
zgj|I6f>s|79j#}qQ_ErFubQ(2;%OZm(Imc_!o=g0CFcmAy^^hRx9HD}ka?`uB~|_u
z5OMy`YPI1<*;lQyWOG`r7ddP;s}1j3rt}i5R_i6~`&@1~D*J;iS!TnFIu5J#Vp|zr
zf2;Cqq7lLWYGh$|81vxOW77;(etNTtmxJGng;wDx+0*8Ba;Km?#xhDSpb}<|S&M2=
zQzT31IffOklclZ3x1j=&q+ghn>j(jRvh^p2#5+s$7N?0u#s0OV(N9L_k+sgM0U0?{
zX|y4pk5L09wRU_gXBEY*n5)STf?2IaYuqh3?L>7E%|H#ww&ko!s&L9wf|!f(Jk4sY
zLPJuslw=i3`u$hVsyZ|7EJn%+=3-cP@u(uXlfXK8!uAG*IMwYarjplKto{o~Fgh7O
zf?T53TCMJ7)R?GBreegCiCHf}*=OaT?I7EqK7B>zr<p7D&!Fl`XeKZ^pw6_Ai~rSS
zkoQGVmrN-Y<m==mXN!7dC{CgnRl<6ltwK+BX0?cy`(-98<x2Mil=|(QRYCqOj_iii
znkS35D`!<gjq^rKw>U9o$%Mk~IjeB=A`!(C(Ch{`GO{}b=Rvr>53Z!9blQWwqr3HJ
z??Vj}Ijgb{Fqzm#6V8oVWVIk0yDDduH&Cm}anz8h8dX`dn1&s;K=XrQdX~)Zk>aa(
zqq-pXv`kaz+<@fRH8~!&4nwe-a5SgXXcEVW<#|rt>9b4-FNWu4`Jm)=Mr&hME4h^%
zebLCW<NhkolZx2oc@KQL0IkGcp|tW?Y(rzbRGwXS;E+7V_t%NCCY(q$1|n5ai~+dM
z^pCHKinB8zObA3}OT!VU%-GfAF)WTrR&wE>+F3pEtu}V&cpv|s9Bx`}nZ#}!=S<2-
zEK!P+p}38>apno9cGy=zD^b@s*43#AE$wBJ%a2ht#;NLS*)^0RZk%QOm=9i(_T+I#
zaA&@EXU80i)IM>vUd|AkuS*qk4J5Mnd0G7HbUw^1Y)MpIC5+9_DG4X(>9k-j53f()
z6F7EEdy*_RE^|uOOSjlEn&aSI@=8a!HnYPUjedJ`b7>;bpbDiEOBp*EsmWBx4?Xc|
zBv=X0_QB^*imwO;{h}#g`x7N+`n!z&U@VR{JZV&V2nQ?^u@<bzsX(Y3Yf85yW5<G@
z&ncoQe_9qh&MXxr2oE}+;iDcH<r$kVOQV~EKa9rk%hLRGP>ZoOc25-!OjI})FSYm=
zi#dTlO{AcX^z8_IKCYh4VGUyH$W}3bQmyyba%c0?ba*!S_?caJh(8*@ytK(5NYrh_
z!$5}8wNuI(NsVp{Ct^`LRgCBTSsa)uH)GF%zh1!DO6JELocBY&q-dx5$)55vh8js^
znhRYLDL<MBg4pp|%#V*F1~(uJ64}v671%OSIyEasc&;nqeie19#phiZt7Dlq55&U@
z8<Gpr0T-f-h4@Nfd|_nq!o>?M!d?b?LQH%0EGwyn@M;TVUt?(fU_+cSLoOs^U7*jT
zZ87{)p|+Rw?4`<!wR=DPv}nt#3%_@U*iWLpvojT`p4?lL`y*+c%XW(QR<-n*X^KGH
zlHO|IqrEo$)h6kE2EOC;Ouz>uedv+wauoyL-y1d7$5_7mQBkh3KF0F<Bwu`&;FtSN
z^a@kf)hg*(iJuWM>Swg~&c{S~gA!`(Vzf7wIITphmQdp}*0)vC2Mv6RLB|nEU;c!U
ztI3;Z;B!m5(x1&&XyCI-db5EKkFc|@&5}N7;KTND_Vr^?Ud>Ok%Uzny#abnO=*et8
zETpq8jgRfl=3AM?h5b!QuQ%{n4ScPVzQ@2<V&K!{4IB8%41DY<SzigY_9!2Nui3!o
z9)oYQfzM~)>yz|?pJv;o+Q3&R=`{wvbq2mxNgp)u)fo8L&qR465^D9uq$2Ao*dzF|
z5<eqyu>PhzE#w);17m+1kbIv}lqtzrzOjEE?(xX|i^FT5_%lMD@~nVbyBO_bk#x6#
z&sg6YNjEi?Nn)WqkK?Y)E?;A{N;;nB^6^m9Poq~$dd)@V^kzxNGg{O9w@P~79CLcR
zCjTgNdXJ<lCz;dxB)#A`b9%p|x6d-C4`})4n$tBqj0KJM()gCk`?PUfw@5uSzRwNj
z<sFuytYe%zIxNEf0Yb)XA2~m<8p@2%7JgtzKJ3vEV>ySZeF|p$bI(uxt%e$_eR|~l
zZL@)4;MmWneMZ&eFttzLze)QP$osjmecF%z*KQwW*1t#pvC4Uj)!@iO%IDKQH76R%
zIZXYh{oka0s^z@U*nj#?HrUP3e*duOVQL@i(f?Zgr(Mpchvo^p8*VpjkEHj{H>WGl
ziS)ix%;{y4j`!|O=g0k$K2&H<KUjOWz98}yEHKZnm5+DdP0P1FFVfo<n$v3}-Mz@1
z-XrNlW6(AG_MK^-pAE?JE#`DZ(v`*L^p%p%ip=RXlHNWB{R&C9E-}yFCha>g27OrO
z??1~tKa=_0%gpJsC4FcN`f^E+pKYGsC+P*t&FOJT?;C@DF#popujX8H`O9Av>DHCz
zbj|<pj=ib>9jtuKzX#-Z-;DiJlOMO5%h&uHrwC2U*ZjMn*qpA_zkLk4=AW&0^ZY~7
zJ~bugbj|;m!<?@9U)vb;gV}HJmqISyJvXiY!SWmJJr@6<{I15ZgtV_t*U%x}52_y)
z`f2hPt+K7bZ+7|l!x<}{QCY2=WX6|%j&u+{E{}c#%#TMue(@V%S{5_8>8DI6+l-!m
zTnx=j=$Yr+=Jc$W0C?rb=F@$nO&G$YJd&s56Q6>UW;4^zz%L)$euka1<xBqTVh*7k
z@kKmMFRkAHEZ9GTv8hKgrr_*Y0pO(w!y`B=0=NUA;61z>4EPs>2#$~7)ge}a(EI^-
z0G~#nGq(eP^YJiZFK`RsO$bB4+W>bX3=<FFQL}Ic54aU@9l|HTu{Xu$9gX+)_aiUh
zAVLA~A;3zUqjdv!1GXbn11DIF4a6GY*sow)5!!(F0q#TC3>^Cl?Djd}rF6iPjsXO2
z0qjQDMd^T3kA?og3jiw-27tQ(A4C`gJ_Ps)!am}`W@Hp$Kkzu<69@-@_X8e(JoLwL
zO$G1*gekz?fHxt`1l|Yu41xl@U@pF$gHQ;(9kA>KJTE1Fz{e3%!21CU6nwXm_yO-n
zz;6UItY6ry6B+v<a0SqZunRcW8*Iu+ur;LvUWKq1cq`!Z2t&XJ02iJN{efEmFG2VK
zcn#nk2%iA&2Ydw~|83Y1@O(VLDFAK-Y(TIAj|281lmW-Qkv%jYdH}~9k#(E`KLL*U
zAp5_k!cTzf&s@?O&3=Sk#1FU!VJ~okFCpv)j=3PKKMnc-j{|;;kPrW)j{<xPVJ7f?
zz@yKA4S_3wRS4C<@ts@t1VRn*0R9DG6L8EA*>;3>;QDirbZ)YFA>JEDI>A<i0pJ90
zMi>T;xgoPJLR$mJJdphw!Gb=5IUn0`CZ1;l$NY}9Szr_31dm+|n*hhWjeUqv0~~WS
zwizJ;9P=?&v;<`W$J~qk0^xe#m}jwv&Vmf!m{YOU%fJg9^C$LegzdmFS7LQ%LucTa
z7qRin(eA)82Vz?h27qI}!-~&ATM`f8PZ36d4*-r|0lnS@KVS@@5O^GL2Z9@TKj6A^
z(FVXV?_tYU!Y6@aj>B5c!<ic3`ZI%c#&G5Nkd1VLB?!a733?FNd*BCr31K$yA;4Ly
zU@PGGo-Ml?!A(4Xk0CSz$9#uHtgr*{IA9L~o%bWSzy=7M;8KKs-~@{i27%KT6UG%o
z2jH03u<s%$@57FOn5VD>zzJ5B;9N3r%uU#P2qnNV4`G`S+`uvCU>C23Er=iRPJ|Tj
zcEFDit|0z0#?C_64jkX6Wp^R`kaz%pi|`8Y5x{$#=xf0BXW-}z-T%7~Hu*rnx(dhu
zPB4y854;U<CqgUme!zVQn}E}SwV9Qm16Ke`5H<tHa}IWg3*`fE2fW1%9f0f4tI;{O
zj}ep)1@v45`vJ!@4)&l2vViN)oY7gdQ@v<+q!YXrp&dA#F?q?4I#J#L#vFux;H`kW
z5OxFK4LFDp{|NP2kMRK^4|o^gAVL{%f^Q*MfsX*r4niJqf(sGqfm;CE5EcL@*pJ`_
zPH-<mHE@E*hhP`r3gA5m^MG#$EKy+x=tHm`VG7a-eiPw1;I{%khp-nsBY+cYF<t}5
z@3^v62+iPe1GXa+ek|Zab*L-ScLJ`gM_qvvYzRYN@Z1Xc0zwV&y@2^&hTj4w_%gyK
z;I9C_gU||m1n|ZUuoZBE-;bbN;I{)#YCye#PXW9V;dbD3R%tK7Zs2rI$P$Gufx7{(
zMd$;L--~6(#84OD#{qr`VF);Wcb08I*a^G~a5ut!-~{&}d;pxq(O#Ef90uMGctjF1
z4nPOMQiLhMeSq5#W&+;@_=ObO2zWi<HiYHCS2i;CZ3HXuX8_OMh<w181MWj815R*a
z6Z#tPrGPGk5b$ciTM;6_2@W7M6Mr+_QE7o4fad}F5pD%e=R;pb=mO3z$2mfTO~4hv
zQxMvKTL3E%tovarzy^de;Bmm45H<mC1KfcSdJA?0d=?=Bd;st*gzdmb0H=Nh^>`cO
z4B$e99^e+h3Iz8%2!IU;g(Hv;coV|xcOf5e2f{AkeSps*STSA=0KSDV`+dj<oO%W7
z0-O%GE=1UizDx&6=?rHx{F5M^kNgBUK|1fa>mvc_tmEvD#hFJsm#6?I_zprfaQ&6X
zBRTy2l-Y1cji#mNAi-jiPJ9^NShX8x3&){dL<ZnXk-CO?@g>1E7*svLoXmyq2l)Xj
zSt)S39?N^@uk^OjB!<kaC`W@B{`rM3ny_4nYaoP#9LP(t1Pik$-sLI<j4&0FqpX&}
zeVLW>SnwX2g`I=26grSbHEbU8+QHL+e=7J>3~tNn0aI}JBwNAG#J@U7Od++At!Il^
zkn^939Q7=~bH<P}1im<HVNG0%C3JgdCqcR<KMvj~=#@MV1{Hao&UrMQOQ1y(B~V@B
zC^L+*&}rqh6emG)()C*d-UPTaJWHV6IS5No$7O(MBW6V_=5Sl2IDZu7M|4_*kUs%R
z5T)VmNz{?*vWV9ug#0)mj(_FgsN*@wT2xQcu#Q_wC@1QX;q!qb07)t=6ac;f(zUCM
z>*SI$sMSa(%?1>s)<Azdh;A0Vp_#+nkP`!MBd>$rzHaEb7BZr+2(`y@Zoh1PqZQ3;
zSc1Gc@LZ~gre(&va9@F6ViW_F+Bk{21hU$0Qr^Bix2>cEpTn)LmdO9aIBUh&gqjR>
z4tI`p9_VCU1zoedl&-=qOV{!)Ygbv9yQ{jZri=AaoiUzuS9jNU$Ge-mTe~-P_jLDl
z@9ZAv9_$|K2C*OG4Zz^NL-!8fJ96)Vds%OOZ$U5iIN?7S=Q?(F^mpv(80Z-680r}A
zsNWLb(!8a0%cd=DTQ+ZL-_qRK+PSH-t#fl{duLB)UuSbyYuBc(wyw=x?Oi=xeO=bx
zvR-#@b#HxdytlcxwYRNzb8mZZPw&p&{@y*k1HD7N!@VQD2YT6%&|_!&K>J{OO-FM_
zYsaRJwhsC(6G+V3UejLRzNx*fy{~;|dqIb#V|hn)M-908xNZkJ*cN3=;g+&3ZmuEe
z*1u)Xmf<ZUTM9a7cP{U=cGh&(b6xv7cXkeT4#95u+-77g(wj8i(>2gF(xq&*ZY|qd
zzqNg9|JFTQhqsPwE!bw=R<o^s+oo-8+xoT*Z5!Uky7Rl0?!s<scUgB0>`S(7hjshA
z_rS8l-K;0Sr@ANJWBI{>9~9i(eD}cJoA2qnC%%384)>0Ndk10b>fXLyrsS|)s9!T`
z=0+Xzc`dA{N6nUcZfB~+5bD7?^E;K!Le!&-*M#g&Ht+A;gSrg!+9;@x742WsRnOa@
z9X0Alorb!GQKv#)s~TRf9$vE{)QxS+-==IUME%Nm4O>yi_H8}9j%D3$)NK<yX0SWI
dr?982r@p7HXJ^lF&+H$#e*m@rbNv%6@ZUD+?92cF

literal 0
HcmV?d00001

diff --git a/lib/win32comext/directsound/test/__init__.py b/lib/win32comext/directsound/test/__init__.py
new file mode 100644
index 00000000..447e0d44
--- /dev/null
+++ b/lib/win32comext/directsound/test/__init__.py
@@ -0,0 +1 @@
+# This is a Python package, imported by the win32com test suite.
diff --git a/lib/win32comext/directsound/test/ds_record.py b/lib/win32comext/directsound/test/ds_record.py
new file mode 100644
index 00000000..13c4d645
--- /dev/null
+++ b/lib/win32comext/directsound/test/ds_record.py
@@ -0,0 +1,60 @@
+import os
+import struct
+
+import pywintypes
+import win32api
+import win32com.directsound.directsound as ds
+import win32event
+
+
+def wav_header_pack(wfx, datasize):
+    return struct.pack(
+        "<4sl4s4slhhllhh4sl",
+        "RIFF",
+        36 + datasize,
+        "WAVE",
+        "fmt ",
+        16,
+        wfx.wFormatTag,
+        wfx.nChannels,
+        wfx.nSamplesPerSec,
+        wfx.nAvgBytesPerSec,
+        wfx.nBlockAlign,
+        wfx.wBitsPerSample,
+        "data",
+        datasize,
+    )
+
+
+d = ds.DirectSoundCaptureCreate(None, None)
+
+sdesc = ds.DSCBUFFERDESC()
+sdesc.dwBufferBytes = 352800  # 2 seconds
+sdesc.lpwfxFormat = pywintypes.WAVEFORMATEX()
+sdesc.lpwfxFormat.wFormatTag = pywintypes.WAVE_FORMAT_PCM
+sdesc.lpwfxFormat.nChannels = 2
+sdesc.lpwfxFormat.nSamplesPerSec = 44100
+sdesc.lpwfxFormat.nAvgBytesPerSec = 176400
+sdesc.lpwfxFormat.nBlockAlign = 4
+sdesc.lpwfxFormat.wBitsPerSample = 16
+
+print(sdesc)
+print(d)
+buffer = d.CreateCaptureBuffer(sdesc)
+
+event = win32event.CreateEvent(None, 0, 0, None)
+notify = buffer.QueryInterface(ds.IID_IDirectSoundNotify)
+
+notify.SetNotificationPositions((ds.DSBPN_OFFSETSTOP, event))
+
+buffer.Start(0)
+
+win32event.WaitForSingleObject(event, -1)
+
+data = buffer.Update(0, 352800)
+
+fname = os.path.join(win32api.GetTempPath(), "test_directsound_record.wav")
+f = open(fname, "wb")
+f.write(wav_header_pack(sdesc.lpwfxFormat, 352800))
+f.write(data)
+f.close()
diff --git a/lib/win32comext/directsound/test/ds_test.py b/lib/win32comext/directsound/test/ds_test.py
new file mode 100644
index 00000000..84259ee2
--- /dev/null
+++ b/lib/win32comext/directsound/test/ds_test.py
@@ -0,0 +1,402 @@
+import os
+import struct
+import sys
+import unittest
+
+import pythoncom
+import pywintypes
+import win32api
+import win32com.directsound.directsound as ds
+import win32event
+from pywin32_testutil import TestSkipped, find_test_fixture
+
+# next two lines are for for debugging:
+# import win32com
+# import directsound as ds
+
+WAV_FORMAT_PCM = 1
+WAV_HEADER_SIZE = struct.calcsize("<4sl4s4slhhllhh4sl")
+
+
+def wav_header_unpack(data):
+    (
+        riff,
+        riffsize,
+        wave,
+        fmt,
+        fmtsize,
+        format,
+        nchannels,
+        samplespersecond,
+        datarate,
+        blockalign,
+        bitspersample,
+        data,
+        datalength,
+    ) = struct.unpack("<4sl4s4slhhllhh4sl", data)
+
+    if riff != b"RIFF":
+        raise ValueError("invalid wav header")
+
+    if fmtsize != 16 or fmt != b"fmt " or data != b"data":
+        # fmt chuck is not first chunk, directly followed by data chuck
+        # It is nowhere required that they are, it is just very common
+        raise ValueError("cannot understand wav header")
+
+    wfx = pywintypes.WAVEFORMATEX()
+    wfx.wFormatTag = format
+    wfx.nChannels = nchannels
+    wfx.nSamplesPerSec = samplespersecond
+    wfx.nAvgBytesPerSec = datarate
+    wfx.nBlockAlign = blockalign
+    wfx.wBitsPerSample = bitspersample
+
+    return wfx, datalength
+
+
+def wav_header_pack(wfx, datasize):
+    return struct.pack(
+        "<4sl4s4slhhllhh4sl",
+        b"RIFF",
+        36 + datasize,
+        b"WAVE",
+        b"fmt ",
+        16,
+        wfx.wFormatTag,
+        wfx.nChannels,
+        wfx.nSamplesPerSec,
+        wfx.nAvgBytesPerSec,
+        wfx.nBlockAlign,
+        wfx.wBitsPerSample,
+        b"data",
+        datasize,
+    )
+
+
+class WAVEFORMATTest(unittest.TestCase):
+    def test_1_Type(self):
+        "WAVEFORMATEX type"
+        w = pywintypes.WAVEFORMATEX()
+        self.assertTrue(type(w) == pywintypes.WAVEFORMATEXType)
+
+    def test_2_Attr(self):
+        "WAVEFORMATEX attribute access"
+        # A wav header for a soundfile from a CD should look like this...
+        w = pywintypes.WAVEFORMATEX()
+        w.wFormatTag = pywintypes.WAVE_FORMAT_PCM
+        w.nChannels = 2
+        w.nSamplesPerSec = 44100
+        w.nAvgBytesPerSec = 176400
+        w.nBlockAlign = 4
+        w.wBitsPerSample = 16
+
+        self.assertTrue(w.wFormatTag == 1)
+        self.assertTrue(w.nChannels == 2)
+        self.assertTrue(w.nSamplesPerSec == 44100)
+        self.assertTrue(w.nAvgBytesPerSec == 176400)
+        self.assertTrue(w.nBlockAlign == 4)
+        self.assertTrue(w.wBitsPerSample == 16)
+
+
+class DSCAPSTest(unittest.TestCase):
+    def test_1_Type(self):
+        "DSCAPS type"
+        c = ds.DSCAPS()
+        self.assertTrue(type(c) == ds.DSCAPSType)
+
+    def test_2_Attr(self):
+        "DSCAPS attribute access"
+        c = ds.DSCAPS()
+        c.dwFlags = 1
+        c.dwMinSecondarySampleRate = 2
+        c.dwMaxSecondarySampleRate = 3
+        c.dwPrimaryBuffers = 4
+        c.dwMaxHwMixingAllBuffers = 5
+        c.dwMaxHwMixingStaticBuffers = 6
+        c.dwMaxHwMixingStreamingBuffers = 7
+        c.dwFreeHwMixingAllBuffers = 8
+        c.dwFreeHwMixingStaticBuffers = 9
+        c.dwFreeHwMixingStreamingBuffers = 10
+        c.dwMaxHw3DAllBuffers = 11
+        c.dwMaxHw3DStaticBuffers = 12
+        c.dwMaxHw3DStreamingBuffers = 13
+        c.dwFreeHw3DAllBuffers = 14
+        c.dwFreeHw3DStaticBuffers = 15
+        c.dwFreeHw3DStreamingBuffers = 16
+        c.dwTotalHwMemBytes = 17
+        c.dwFreeHwMemBytes = 18
+        c.dwMaxContigFreeHwMemBytes = 19
+        c.dwUnlockTransferRateHwBuffers = 20
+        c.dwPlayCpuOverheadSwBuffers = 21
+
+        self.assertTrue(c.dwFlags == 1)
+        self.assertTrue(c.dwMinSecondarySampleRate == 2)
+        self.assertTrue(c.dwMaxSecondarySampleRate == 3)
+        self.assertTrue(c.dwPrimaryBuffers == 4)
+        self.assertTrue(c.dwMaxHwMixingAllBuffers == 5)
+        self.assertTrue(c.dwMaxHwMixingStaticBuffers == 6)
+        self.assertTrue(c.dwMaxHwMixingStreamingBuffers == 7)
+        self.assertTrue(c.dwFreeHwMixingAllBuffers == 8)
+        self.assertTrue(c.dwFreeHwMixingStaticBuffers == 9)
+        self.assertTrue(c.dwFreeHwMixingStreamingBuffers == 10)
+        self.assertTrue(c.dwMaxHw3DAllBuffers == 11)
+        self.assertTrue(c.dwMaxHw3DStaticBuffers == 12)
+        self.assertTrue(c.dwMaxHw3DStreamingBuffers == 13)
+        self.assertTrue(c.dwFreeHw3DAllBuffers == 14)
+        self.assertTrue(c.dwFreeHw3DStaticBuffers == 15)
+        self.assertTrue(c.dwFreeHw3DStreamingBuffers == 16)
+        self.assertTrue(c.dwTotalHwMemBytes == 17)
+        self.assertTrue(c.dwFreeHwMemBytes == 18)
+        self.assertTrue(c.dwMaxContigFreeHwMemBytes == 19)
+        self.assertTrue(c.dwUnlockTransferRateHwBuffers == 20)
+        self.assertTrue(c.dwPlayCpuOverheadSwBuffers == 21)
+
+
+class DSBCAPSTest(unittest.TestCase):
+    def test_1_Type(self):
+        "DSBCAPS type"
+        c = ds.DSBCAPS()
+        self.assertTrue(type(c) == ds.DSBCAPSType)
+
+    def test_2_Attr(self):
+        "DSBCAPS attribute access"
+        c = ds.DSBCAPS()
+        c.dwFlags = 1
+        c.dwBufferBytes = 2
+        c.dwUnlockTransferRate = 3
+        c.dwPlayCpuOverhead = 4
+
+        self.assertTrue(c.dwFlags == 1)
+        self.assertTrue(c.dwBufferBytes == 2)
+        self.assertTrue(c.dwUnlockTransferRate == 3)
+        self.assertTrue(c.dwPlayCpuOverhead == 4)
+
+
+class DSCCAPSTest(unittest.TestCase):
+    def test_1_Type(self):
+        "DSCCAPS type"
+        c = ds.DSCCAPS()
+        self.assertTrue(type(c) == ds.DSCCAPSType)
+
+    def test_2_Attr(self):
+        "DSCCAPS attribute access"
+        c = ds.DSCCAPS()
+        c.dwFlags = 1
+        c.dwFormats = 2
+        c.dwChannels = 4
+
+        self.assertTrue(c.dwFlags == 1)
+        self.assertTrue(c.dwFormats == 2)
+        self.assertTrue(c.dwChannels == 4)
+
+
+class DSCBCAPSTest(unittest.TestCase):
+    def test_1_Type(self):
+        "DSCBCAPS type"
+        c = ds.DSCBCAPS()
+        self.assertTrue(type(c) == ds.DSCBCAPSType)
+
+    def test_2_Attr(self):
+        "DSCBCAPS attribute access"
+        c = ds.DSCBCAPS()
+        c.dwFlags = 1
+        c.dwBufferBytes = 2
+
+        self.assertTrue(c.dwFlags == 1)
+        self.assertTrue(c.dwBufferBytes == 2)
+
+
+class DSBUFFERDESCTest(unittest.TestCase):
+    def test_1_Type(self):
+        "DSBUFFERDESC type"
+        c = ds.DSBUFFERDESC()
+        self.assertTrue(type(c) == ds.DSBUFFERDESCType)
+
+    def test_2_Attr(self):
+        "DSBUFFERDESC attribute access"
+        c = ds.DSBUFFERDESC()
+        c.dwFlags = 1
+        c.dwBufferBytes = 2
+        c.lpwfxFormat = pywintypes.WAVEFORMATEX()
+        c.lpwfxFormat.wFormatTag = pywintypes.WAVE_FORMAT_PCM
+        c.lpwfxFormat.nChannels = 2
+        c.lpwfxFormat.nSamplesPerSec = 44100
+        c.lpwfxFormat.nAvgBytesPerSec = 176400
+        c.lpwfxFormat.nBlockAlign = 4
+        c.lpwfxFormat.wBitsPerSample = 16
+
+        self.assertTrue(c.dwFlags == 1)
+        self.assertTrue(c.dwBufferBytes == 2)
+        self.assertTrue(c.lpwfxFormat.wFormatTag == 1)
+        self.assertTrue(c.lpwfxFormat.nChannels == 2)
+        self.assertTrue(c.lpwfxFormat.nSamplesPerSec == 44100)
+        self.assertTrue(c.lpwfxFormat.nAvgBytesPerSec == 176400)
+        self.assertTrue(c.lpwfxFormat.nBlockAlign == 4)
+        self.assertTrue(c.lpwfxFormat.wBitsPerSample == 16)
+
+    def invalid_format(self, c):
+        c.lpwfxFormat = 17
+
+    def test_3_invalid_format(self):
+        "DSBUFFERDESC invalid lpwfxFormat assignment"
+        c = ds.DSBUFFERDESC()
+        self.assertRaises(ValueError, self.invalid_format, c)
+
+
+class DSCBUFFERDESCTest(unittest.TestCase):
+    def test_1_Type(self):
+        "DSCBUFFERDESC type"
+        c = ds.DSCBUFFERDESC()
+        self.assertTrue(type(c) == ds.DSCBUFFERDESCType)
+
+    def test_2_Attr(self):
+        "DSCBUFFERDESC attribute access"
+        c = ds.DSCBUFFERDESC()
+        c.dwFlags = 1
+        c.dwBufferBytes = 2
+        c.lpwfxFormat = pywintypes.WAVEFORMATEX()
+        c.lpwfxFormat.wFormatTag = pywintypes.WAVE_FORMAT_PCM
+        c.lpwfxFormat.nChannels = 2
+        c.lpwfxFormat.nSamplesPerSec = 44100
+        c.lpwfxFormat.nAvgBytesPerSec = 176400
+        c.lpwfxFormat.nBlockAlign = 4
+        c.lpwfxFormat.wBitsPerSample = 16
+
+        self.assertTrue(c.dwFlags == 1)
+        self.assertTrue(c.dwBufferBytes == 2)
+        self.assertTrue(c.lpwfxFormat.wFormatTag == 1)
+        self.assertTrue(c.lpwfxFormat.nChannels == 2)
+        self.assertTrue(c.lpwfxFormat.nSamplesPerSec == 44100)
+        self.assertTrue(c.lpwfxFormat.nAvgBytesPerSec == 176400)
+        self.assertTrue(c.lpwfxFormat.nBlockAlign == 4)
+        self.assertTrue(c.lpwfxFormat.wBitsPerSample == 16)
+
+    def invalid_format(self, c):
+        c.lpwfxFormat = 17
+
+    def test_3_invalid_format(self):
+        "DSCBUFFERDESC invalid lpwfxFormat assignment"
+        c = ds.DSCBUFFERDESC()
+        self.assertRaises(ValueError, self.invalid_format, c)
+
+
+class DirectSoundTest(unittest.TestCase):
+    # basic tests - mostly just exercise the functions
+    def testEnumerate(self):
+        """DirectSoundEnumerate() sanity tests"""
+
+        devices = ds.DirectSoundEnumerate()
+        # this might fail on machines without a sound card
+        self.assertTrue(len(devices))
+        # if we have an entry, it must be a tuple of size 3
+        self.assertTrue(len(devices[0]) == 3)
+
+    def testCreate(self):
+        """DirectSoundCreate()"""
+        try:
+            d = ds.DirectSoundCreate(None, None)
+        except pythoncom.com_error as exc:
+            if exc.hresult != ds.DSERR_NODRIVER:
+                raise
+            raise TestSkipped(exc)
+
+    def testPlay(self):
+        """Mesdames et Messieurs, la cour de Devin Dazzle"""
+        # relative to 'testall.py' in the win32com test suite.
+        extra = os.path.join(
+            os.path.dirname(sys.argv[0]), "../../win32comext/directsound/test"
+        )
+
+        fname = find_test_fixture("01-Intro.wav", extra)
+
+        with open(fname, "rb") as f:
+            hdr = f.read(WAV_HEADER_SIZE)
+            wfx, size = wav_header_unpack(hdr)
+
+            try:
+                d = ds.DirectSoundCreate(None, None)
+            except pythoncom.com_error as exc:
+                if exc.hresult != ds.DSERR_NODRIVER:
+                    raise
+                raise TestSkipped(exc)
+            d.SetCooperativeLevel(None, ds.DSSCL_PRIORITY)
+
+            sdesc = ds.DSBUFFERDESC()
+            sdesc.dwFlags = ds.DSBCAPS_STICKYFOCUS | ds.DSBCAPS_CTRLPOSITIONNOTIFY
+            sdesc.dwBufferBytes = size
+            sdesc.lpwfxFormat = wfx
+
+            buffer = d.CreateSoundBuffer(sdesc, None)
+
+            event = win32event.CreateEvent(None, 0, 0, None)
+            notify = buffer.QueryInterface(ds.IID_IDirectSoundNotify)
+
+            notify.SetNotificationPositions((ds.DSBPN_OFFSETSTOP, event))
+
+            buffer.Update(0, f.read(size))
+
+            buffer.Play(0)
+
+            win32event.WaitForSingleObject(event, -1)
+
+
+class DirectSoundCaptureTest(unittest.TestCase):
+    # basic tests - mostly just exercise the functions
+    def testEnumerate(self):
+        """DirectSoundCaptureEnumerate() sanity tests"""
+
+        devices = ds.DirectSoundCaptureEnumerate()
+        # this might fail on machines without a sound card
+        self.assertTrue(len(devices))
+        # if we have an entry, it must be a tuple of size 3
+        self.assertTrue(len(devices[0]) == 3)
+
+    def testCreate(self):
+        """DirectSoundCreate()"""
+        try:
+            d = ds.DirectSoundCaptureCreate(None, None)
+        except pythoncom.com_error as exc:
+            if exc.hresult != ds.DSERR_NODRIVER:
+                raise
+            raise TestSkipped(exc)
+
+    def testRecord(self):
+        try:
+            d = ds.DirectSoundCaptureCreate(None, None)
+        except pythoncom.com_error as exc:
+            if exc.hresult != ds.DSERR_NODRIVER:
+                raise
+            raise TestSkipped(exc)
+
+        sdesc = ds.DSCBUFFERDESC()
+        sdesc.dwBufferBytes = 352800  # 2 seconds
+        sdesc.lpwfxFormat = pywintypes.WAVEFORMATEX()
+        sdesc.lpwfxFormat.wFormatTag = pywintypes.WAVE_FORMAT_PCM
+        sdesc.lpwfxFormat.nChannels = 2
+        sdesc.lpwfxFormat.nSamplesPerSec = 44100
+        sdesc.lpwfxFormat.nAvgBytesPerSec = 176400
+        sdesc.lpwfxFormat.nBlockAlign = 4
+        sdesc.lpwfxFormat.wBitsPerSample = 16
+
+        buffer = d.CreateCaptureBuffer(sdesc)
+
+        event = win32event.CreateEvent(None, 0, 0, None)
+        notify = buffer.QueryInterface(ds.IID_IDirectSoundNotify)
+
+        notify.SetNotificationPositions((ds.DSBPN_OFFSETSTOP, event))
+
+        buffer.Start(0)
+
+        win32event.WaitForSingleObject(event, -1)
+        event.Close()
+
+        data = buffer.Update(0, 352800)
+        fname = os.path.join(win32api.GetTempPath(), "test_directsound_record.wav")
+        f = open(fname, "wb")
+        f.write(wav_header_pack(sdesc.lpwfxFormat, 352800))
+        f.write(data)
+        f.close()
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/lib/win32comext/ifilter/__init__.py b/lib/win32comext/ifilter/__init__.py
new file mode 100644
index 00000000..cc577a23
--- /dev/null
+++ b/lib/win32comext/ifilter/__init__.py
@@ -0,0 +1 @@
+# empty file to designate as a package.
diff --git a/lib/win32comext/ifilter/demo/filterDemo.py b/lib/win32comext/ifilter/demo/filterDemo.py
new file mode 100644
index 00000000..30742d8a
--- /dev/null
+++ b/lib/win32comext/ifilter/demo/filterDemo.py
@@ -0,0 +1,300 @@
+import pythoncom
+import pywintypes
+from win32com import storagecon
+from win32com.ifilter import ifilter
+from win32com.ifilter.ifiltercon import *
+
+
+class FileParser:
+    # Property IDs for the Storage Property Set
+    PIDS_BODY = 0x00000013
+
+    # property IDs for HTML Storage Property Set
+    PIDH_DESCRIPTION = "DESCRIPTION"
+    PIDH_HREF = "A.HREF"
+    PIDH_IMGSRC = "IMG.SRC"
+
+    # conversion map to convert ifilter properties to more user friendly names
+    propertyToName = {
+        PSGUID_STORAGE: {PIDS_BODY: "body"},
+        PSGUID_SUMMARYINFORMATION: {
+            PIDSI_TITLE: "title",
+            PIDSI_SUBJECT: "description",
+            PIDSI_AUTHOR: "author",
+            PIDSI_KEYWORDS: "keywords",
+            PIDSI_COMMENTS: "comments",
+        },
+        PSGUID_HTMLINFORMATION: {PIDH_DESCRIPTION: "description"},
+        PSGUID_HTML2_INFORMATION: {PIDH_HREF: "href", PIDH_IMGSRC: "img"},
+    }
+
+    def __init__(self, verbose=False):
+        self.f = None
+        self.stg = None
+        self.verbose = verbose
+
+    def Close(self):
+        self.f = None
+        self.stg = None
+
+    def Parse(self, fileName, maxErrors=10):
+        properties = {}
+
+        try:
+            self._bind_to_filter(fileName)
+            try:
+                flags = self.f.Init(
+                    IFILTER_INIT_APPLY_INDEX_ATTRIBUTES
+                    | IFILTER_INIT_APPLY_OTHER_ATTRIBUTES
+                )
+                if flags == IFILTER_FLAGS_OLE_PROPERTIES and self.stg is not None:
+                    self._trace("filter requires to get properities via ole")
+                    self._get_properties(properties)
+
+                errCnt = 0
+                while True:
+                    try:
+                        # each chunk returns a tuple with the following:-
+                        # idChunk       = The chunk identifier. each chunk has a unique identifier
+                        # breakType     = The type of break that separates the previous chunk from the current chunk. Values are:-
+                        #                 CHUNK_NO_BREAK=0,CHUNK_EOW=1,CHUNK_EOS= 2,CHUNK_EOP= 3,CHUNK_EOC= 4
+                        # flags         = Flags indicate whether this chunk contains a text-type or a value-type property
+                        #                 locale = The language and sublanguage associated with a chunk of text
+                        # attr          = A tuple containing the property to be applied to the chunk. Tuple is (propertyset GUID, property ID)
+                        #                 Property ID can be a number or string
+                        # idChunkSource = The ID of the source of a chunk. The value of the idChunkSource member depends on the nature of the chunk
+                        # startSource   = The offset from which the source text for a derived chunk starts in the source chunk
+                        # lenSource     = The length in characters of the source text from which the current chunk was derived.
+                        #                 A zero value signifies character-by-character correspondence between the source text and the derived text.
+
+                        (
+                            idChunk,
+                            breakType,
+                            flags,
+                            locale,
+                            attr,
+                            idChunkSource,
+                            startSource,
+                            lenSource,
+                        ) = self.f.GetChunk()
+                        self._trace(
+                            "Chunk details:",
+                            idChunk,
+                            breakType,
+                            flags,
+                            locale,
+                            attr,
+                            idChunkSource,
+                            startSource,
+                            lenSource,
+                        )
+
+                        # attempt to map each property to a more user friendly name. If we don't know what it is just return
+                        # the set guid and property id. (note: the id can be a number or a string.
+                        propSet = self.propertyToName.get(attr[0])
+                        if propSet:
+                            propName = propSet.get(attr[1], "%s:%s" % attr)
+                        else:
+                            propName = "%s:%s" % attr
+
+                    except pythoncom.com_error as e:
+                        if e[0] == FILTER_E_END_OF_CHUNKS:
+                            # we have read all the chunks
+                            break
+                        elif e[0] in [
+                            FILTER_E_EMBEDDING_UNAVAILABLE,
+                            FILTER_E_LINK_UNAVAILABLE,
+                        ]:
+                            # the next chunk can't be read. Also keep track of the number of times we
+                            # fail as some filters (ie. the Msoft office ones can get stuck here)
+                            errCnt += 1
+                            if errCnt > maxErrors:
+                                raise
+                            else:
+                                continue
+                        elif e[0] == FILTER_E_ACCESS:
+                            self._trace("Access denied")
+                            raise
+                        elif e[0] == FILTER_E_PASSWORD:
+                            self._trace("Password required")
+                            raise
+                        else:
+                            # any other type of error really can't be recovered from
+                            raise
+
+                    # reset consecutive errors (some filters may get stuck in a lopp if embedding or link failures occurs
+                    errCnt = 0
+
+                    if flags == CHUNK_TEXT:
+                        # its a text segment - get all available text for this chunk.
+                        body_chunks = properties.setdefault(propName, [])
+                        self._get_text(body_chunks)
+                    elif flags == CHUNK_VALUE:
+                        # its a data segment - get the value
+                        properties[propName] = self.f.GetValue()
+                    else:
+                        self._trace("Unknown flag returned by GetChunk:", flags)
+            finally:
+                self.Close()
+
+        except pythoncom.com_error as e:
+            self._trace("ERROR processing file", e)
+            raise
+
+        return properties
+
+    def _bind_to_filter(self, fileName):
+        """
+        See if the file is a structured storage file or a normal file
+        and then return an ifilter interface by calling the appropriate bind/load function
+        """
+        if pythoncom.StgIsStorageFile(fileName):
+            self.stg = pythoncom.StgOpenStorage(
+                fileName, None, storagecon.STGM_READ | storagecon.STGM_SHARE_DENY_WRITE
+            )
+            try:
+                self.f = ifilter.BindIFilterFromStorage(self.stg)
+            except pythoncom.com_error as e:
+                if (
+                    e[0] == -2147467262
+                ):  # 0x80004002: # no interface, try the load interface (this happens for some MSoft files)
+                    self.f = ifilter.LoadIFilter(fileName)
+                else:
+                    raise
+        else:
+            self.f = ifilter.LoadIFilter(fileName)
+            self.stg = None
+
+    def _get_text(self, body_chunks):
+        """
+        Gets all the text for a particular chunk. We need to keep calling get text till all the
+        segments for this chunk are retrieved
+        """
+        while True:
+            try:
+                body_chunks.append(self.f.GetText())
+            except pythoncom.com_error as e:
+                if e[0] in [
+                    FILTER_E_NO_MORE_TEXT,
+                    FILTER_E_NO_MORE_TEXT,
+                    FILTER_E_NO_TEXT,
+                ]:
+                    break
+                else:
+                    raise  # not one of the values we were expecting
+
+    def _get_properties(self, properties):
+        """
+        Use OLE property sets to get base properties
+        """
+        try:
+            pss = self.stg.QueryInterface(pythoncom.IID_IPropertySetStorage)
+        except pythoncom.com_error as e:
+            self._trace("No Property information could be retrieved", e)
+            return
+
+        ps = pss.Open(PSGUID_SUMMARYINFORMATION)
+
+        props = (
+            PIDSI_TITLE,
+            PIDSI_SUBJECT,
+            PIDSI_AUTHOR,
+            PIDSI_KEYWORDS,
+            PIDSI_COMMENTS,
+        )
+
+        title, subject, author, keywords, comments = ps.ReadMultiple(props)
+        if title is not None:
+            properties["title"] = title
+        if subject is not None:
+            properties["description"] = subject
+        if author is not None:
+            properties["author"] = author
+        if keywords is not None:
+            properties["keywords"] = keywords
+        if comments is not None:
+            properties["comments"] = comments
+
+    def _trace(self, *args):
+        if self.verbose:
+            ret = " ".join([str(arg) for arg in args])
+            try:
+                print(ret)
+            except IOError:
+                pass
+
+
+def _usage():
+    import os
+
+    print("Usage: %s filename [verbose [dumpbody]]" % (os.path.basename(sys.argv[0]),))
+    print()
+    print("Where:-")
+    print("filename = name of the file to extract text & properties from")
+    print("verbose = 1=debug output, 0=no debug output (default=0)")
+    print("dumpbody = 1=print text content, 0=don't print content (default=1)")
+    print()
+    print("e.g. to dump a word file called spam.doc go:- filterDemo.py spam.doc")
+    print()
+    print("by default .htm, .txt, .doc, .dot, .xls, .xlt, .ppt are supported")
+    print("you can filter .pdf's by downloading adobes ifilter component. ")
+    print(
+        "(currently found at http://download.adobe.com/pub/adobe/acrobat/win/all/ifilter50.exe)."
+    )
+    print("ifilters for other filetypes are also available.")
+    print()
+    print(
+        "This extension is only supported on win2000 & winXP - because thats the only"
+    )
+    print("place the ifilter stuff is supported. For more info on the API check out ")
+    print("MSDN under ifilters")
+
+
+if __name__ == "__main__":
+    import operator
+    import sys
+
+    fName = ""
+    verbose = False
+    bDumpBody = True
+
+    if len(sys.argv) < 2:
+        _usage()
+        sys.exit(1)
+
+    try:
+        fName = sys.argv[1]
+        verbose = sys.argv[2] != "0"
+        bDumpBody = sys.argv[3] != "0"
+    except:
+        pass
+
+    p = FileParser(verbose)
+    propMap = p.Parse(fName)
+
+    if bDumpBody:
+        print("Body")
+        ch = " ".join(propMap.get("body", []))
+        try:
+            print(ch)
+        except UnicodeError:
+            print(ch.encode("iso8859-1", "ignore"))
+
+    print("Properties")
+    for propName, propValue in propMap.items():
+        print(propName, ":", end=" ")
+        if propName == "body":
+            print(
+                "<%s length: %d>"
+                % (
+                    propName,
+                    reduce(operator.add, [len(p) for p in propValue]),
+                )
+            )
+        elif type(propValue) == type([]):
+            print()
+            for pv in propValue:
+                print(pv)
+        else:
+            print(propValue)
+        print()
diff --git a/lib/win32comext/ifilter/ifilter.pyd b/lib/win32comext/ifilter/ifilter.pyd
new file mode 100644
index 0000000000000000000000000000000000000000..52390f6f13d191e04f37a88c04a2c79715a330ae
GIT binary patch
literal 30720
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

literal 0
HcmV?d00001

diff --git a/lib/win32comext/ifilter/ifiltercon.py b/lib/win32comext/ifilter/ifiltercon.py
new file mode 100644
index 00000000..f29d536e
--- /dev/null
+++ b/lib/win32comext/ifilter/ifiltercon.py
@@ -0,0 +1,110 @@
+# manual stuff
+from pywintypes import IID
+
+PSGUID_STORAGE = IID("{B725F130-47EF-101A-A5F1-02608C9EEBAC}")
+PSGUID_SUMMARYINFORMATION = IID("{F29F85E0-4FF9-1068-AB91-08002B27B3D9}")
+PSGUID_HTMLINFORMATION = IID("{D1B5D3F0-C0B3-11CF-9A92-00A0C908DBF1}")
+PSGUID_HTML2_INFORMATION = IID("{C82BF597-B831-11D0-B733-00AA00A1EBD2}")
+
+IFILTER_INIT_CANON_PARAGRAPHS = 1
+IFILTER_INIT_HARD_LINE_BREAKS = 2
+IFILTER_INIT_CANON_HYPHENS = 4
+IFILTER_INIT_CANON_SPACES = 8
+IFILTER_INIT_APPLY_INDEX_ATTRIBUTES = 16
+IFILTER_INIT_APPLY_CRAWL_ATTRIBUTES = 256
+IFILTER_INIT_APPLY_OTHER_ATTRIBUTES = 32
+IFILTER_INIT_INDEXING_ONLY = 64
+IFILTER_INIT_SEARCH_LINKS = 128
+IFILTER_INIT_FILTER_OWNED_VALUE_OK = 512
+
+IFILTER_FLAGS_OLE_PROPERTIES = 1
+
+CHUNK_TEXT = 0x1
+CHUNK_VALUE = 0x2
+CHUNK_NO_BREAK = 0
+CHUNK_EOW = 1
+CHUNK_EOS = 2
+CHUNK_EOP = 3
+CHUNK_EOC = 4
+
+NOT_AN_ERROR = 0x00080000
+FILTER_E_END_OF_CHUNKS = -2147215616
+FILTER_E_NO_MORE_TEXT = -2147215615
+FILTER_E_NO_MORE_VALUES = -2147215614
+FILTER_E_ACCESS = -2147215613
+FILTER_W_MONIKER_CLIPPED = 0x00041704
+FILTER_E_NO_TEXT = -2147215611
+FILTER_E_NO_VALUES = -2147215610
+FILTER_E_EMBEDDING_UNAVAILABLE = -2147215609
+FILTER_E_LINK_UNAVAILABLE = -2147215608
+FILTER_S_LAST_TEXT = 0x00041709
+FILTER_S_LAST_VALUES = 0x0004170A
+FILTER_E_PASSWORD = -2147215605
+FILTER_E_UNKNOWNFORMAT = -2147215604
+
+# Generated by h2py from PropIdl.h
+PROPSETFLAG_DEFAULT = 0
+PROPSETFLAG_NONSIMPLE = 1
+PROPSETFLAG_ANSI = 2
+PROPSETFLAG_UNBUFFERED = 4
+PROPSETFLAG_CASE_SENSITIVE = 8
+PROPSET_BEHAVIOR_CASE_SENSITIVE = 1
+PID_DICTIONARY = 0
+PID_CODEPAGE = 0x1
+PID_FIRST_USABLE = 0x2
+PID_FIRST_NAME_DEFAULT = 0xFFF
+PID_LOCALE = -2147483648
+PID_MODIFY_TIME = -2147483647
+PID_SECURITY = -2147483646
+PID_BEHAVIOR = -2147483645
+PID_ILLEGAL = -1
+PID_MIN_READONLY = -2147483648
+PID_MAX_READONLY = -1073741825
+PIDDI_THUMBNAIL = 0x00000002
+PIDSI_TITLE = 0x00000002
+PIDSI_SUBJECT = 0x00000003
+PIDSI_AUTHOR = 0x00000004
+PIDSI_KEYWORDS = 0x00000005
+PIDSI_COMMENTS = 0x00000006
+PIDSI_TEMPLATE = 0x00000007
+PIDSI_LASTAUTHOR = 0x00000008
+PIDSI_REVNUMBER = 0x00000009
+PIDSI_EDITTIME = 0x0000000A
+PIDSI_LASTPRINTED = 0x0000000B
+PIDSI_CREATE_DTM = 0x0000000C
+PIDSI_LASTSAVE_DTM = 0x0000000D
+PIDSI_PAGECOUNT = 0x0000000E
+PIDSI_WORDCOUNT = 0x0000000F
+PIDSI_CHARCOUNT = 0x00000010
+PIDSI_THUMBNAIL = 0x00000011
+PIDSI_APPNAME = 0x00000012
+PIDSI_DOC_SECURITY = 0x00000013
+PIDDSI_CATEGORY = 0x00000002
+PIDDSI_PRESFORMAT = 0x00000003
+PIDDSI_BYTECOUNT = 0x00000004
+PIDDSI_LINECOUNT = 0x00000005
+PIDDSI_PARCOUNT = 0x00000006
+PIDDSI_SLIDECOUNT = 0x00000007
+PIDDSI_NOTECOUNT = 0x00000008
+PIDDSI_HIDDENCOUNT = 0x00000009
+PIDDSI_MMCLIPCOUNT = 0x0000000A
+PIDDSI_SCALE = 0x0000000B
+PIDDSI_HEADINGPAIR = 0x0000000C
+PIDDSI_DOCPARTS = 0x0000000D
+PIDDSI_MANAGER = 0x0000000E
+PIDDSI_COMPANY = 0x0000000F
+PIDDSI_LINKSDIRTY = 0x00000010
+PIDMSI_EDITOR = 0x00000002
+PIDMSI_SUPPLIER = 0x00000003
+PIDMSI_SOURCE = 0x00000004
+PIDMSI_SEQUENCE_NO = 0x00000005
+PIDMSI_PROJECT = 0x00000006
+PIDMSI_STATUS = 0x00000007
+PIDMSI_OWNER = 0x00000008
+PIDMSI_RATING = 0x00000009
+PIDMSI_PRODUCTION = 0x0000000A
+PIDMSI_COPYRIGHT = 0x0000000B
+PRSPEC_INVALID = -1
+PRSPEC_LPWSTR = 0
+PRSPEC_PROPID = 1
+CCH_MAX_PROPSTG_NAME = 31
diff --git a/lib/win32comext/internet/__init__.py b/lib/win32comext/internet/__init__.py
new file mode 100644
index 00000000..8d5db8b9
--- /dev/null
+++ b/lib/win32comext/internet/__init__.py
@@ -0,0 +1,4 @@
+# See if we have a special directory for the binaries (for developers)
+import win32com
+
+win32com.__PackageSupportBuildPath__(__path__)
diff --git a/lib/win32comext/internet/inetcon.py b/lib/win32comext/internet/inetcon.py
new file mode 100644
index 00000000..413eccf6
--- /dev/null
+++ b/lib/win32comext/internet/inetcon.py
@@ -0,0 +1,261 @@
+INET_E_USE_DEFAULT_PROTOCOLHANDLER = -2146697199  # _HRESULT_TYPEDEF_(0x800C0011L)
+INET_E_USE_DEFAULT_SETTING = -2146697198  # _HRESULT_TYPEDEF_(0x800C0012L)
+INET_E_DEFAULT_ACTION = INET_E_USE_DEFAULT_PROTOCOLHANDLER
+INET_E_QUERYOPTION_UNKNOWN = -2146697197  # _HRESULT_TYPEDEF_(0x800C0013L)
+INET_E_REDIRECTING = -2146697196  # _HRESULT_TYPEDEF_(0x800C0014L)
+
+INET_E_INVALID_URL = -2146697214  # _HRESULT_TYPEDEF_(0x800C0002L)
+INET_E_NO_SESSION = -2146697213  # _HRESULT_TYPEDEF_(0x800C0003L)
+INET_E_CANNOT_CONNECT = -2146697212  # _HRESULT_TYPEDEF_(0x800C0004L)
+INET_E_RESOURCE_NOT_FOUND = -2146697211  # _HRESULT_TYPEDEF_(0x800C0005L)
+INET_E_OBJECT_NOT_FOUND = -2146697210  # _HRESULT_TYPEDEF_(0x800C0006L)
+INET_E_DATA_NOT_AVAILABLE = -2146697209  # _HRESULT_TYPEDEF_(0x800C0007L)
+INET_E_DOWNLOAD_FAILURE = -2146697208  # _HRESULT_TYPEDEF_(0x800C0008L)
+INET_E_AUTHENTICATION_REQUIRED = -2146697207  # _HRESULT_TYPEDEF_(0x800C0009L)
+INET_E_NO_VALID_MEDIA = -2146697206  # _HRESULT_TYPEDEF_(0x800C000AL)
+INET_E_CONNECTION_TIMEOUT = -2146697205  # _HRESULT_TYPEDEF_(0x800C000BL)
+INET_E_INVALID_REQUEST = -2146697204  # _HRESULT_TYPEDEF_(0x800C000CL)
+INET_E_UNKNOWN_PROTOCOL = -2146697203  # _HRESULT_TYPEDEF_(0x800C000DL)
+INET_E_SECURITY_PROBLEM = -2146697202  # _HRESULT_TYPEDEF_(0x800C000EL)
+INET_E_CANNOT_LOAD_DATA = -2146697201  # _HRESULT_TYPEDEF_(0x800C000FL)
+INET_E_CANNOT_INSTANTIATE_OBJECT = -2146697200  # _HRESULT_TYPEDEF_(0x800C0010L)
+INET_E_INVALID_CERTIFICATE = -2146697191  # _HRESULT_TYPEDEF_(0x800C0019L)
+INET_E_REDIRECT_FAILED = -2146697196  # _HRESULT_TYPEDEF_(0x800C0014L)
+INET_E_REDIRECT_TO_DIR = -2146697195  # _HRESULT_TYPEDEF_(0x800C0015L)
+INET_E_CANNOT_LOCK_REQUEST = -2146697194  # _HRESULT_TYPEDEF_(0x800C0016L)
+INET_E_USE_EXTEND_BINDING = -2146697193  # _HRESULT_TYPEDEF_(0x800C0017L)
+INET_E_TERMINATED_BIND = -2146697192  # _HRESULT_TYPEDEF_(0x800C0018L)
+INET_E_CODE_DOWNLOAD_DECLINED = -2146696960  # _HRESULT_TYPEDEF_(0x800C0100L)
+INET_E_RESULT_DISPATCHED = -2146696704  # _HRESULT_TYPEDEF_(0x800C0200L)
+INET_E_CANNOT_REPLACE_SFP_FILE = -2146696448  # _HRESULT_TYPEDEF_(0x800C0300L)
+INET_E_CODE_INSTALL_SUPPRESSED = -2146696192  # _HRESULT_TYPEDEF_(0x800C0400L)
+INET_E_CODE_INSTALL_BLOCKED_BY_HASH_POLICY = (
+    -2146695936
+)  # _HRESULT_TYPEDEF_(0x800C0500L)
+
+# Generated by h2py from UrlMon.h
+MKSYS_URLMONIKER = 6
+URL_MK_LEGACY = 0
+URL_MK_UNIFORM = 1
+URL_MK_NO_CANONICALIZE = 2
+FIEF_FLAG_FORCE_JITUI = 0x1
+FIEF_FLAG_PEEK = 0x2
+FIEF_FLAG_SKIP_INSTALLED_VERSION_CHECK = 0x4
+FMFD_DEFAULT = 0x00000000
+FMFD_URLASFILENAME = 0x00000001
+FMFD_ENABLEMIMESNIFFING = 0x00000002
+FMFD_IGNOREMIMETEXTPLAIN = 0x00000004
+URLMON_OPTION_USERAGENT = 0x10000001
+URLMON_OPTION_USERAGENT_REFRESH = 0x10000002
+URLMON_OPTION_URL_ENCODING = 0x10000004
+URLMON_OPTION_USE_BINDSTRINGCREDS = 0x10000008
+URLMON_OPTION_USE_BROWSERAPPSDOCUMENTS = 0x10000010
+CF_NULL = 0
+Uri_CREATE_ALLOW_RELATIVE = 0x00000001
+Uri_CREATE_ALLOW_IMPLICIT_WILDCARD_SCHEME = 0x00000002
+Uri_CREATE_ALLOW_IMPLICIT_FILE_SCHEME = 0x00000004
+Uri_CREATE_NOFRAG = 0x00000008
+Uri_CREATE_NO_CANONICALIZE = 0x00000010
+Uri_CREATE_CANONICALIZE = 0x00000100
+Uri_CREATE_FILE_USE_DOS_PATH = 0x00000020
+Uri_CREATE_DECODE_EXTRA_INFO = 0x00000040
+Uri_CREATE_NO_DECODE_EXTRA_INFO = 0x00000080
+Uri_CREATE_CRACK_UNKNOWN_SCHEMES = 0x00000200
+Uri_CREATE_NO_CRACK_UNKNOWN_SCHEMES = 0x00000400
+Uri_CREATE_PRE_PROCESS_HTML_URI = 0x00000800
+Uri_CREATE_NO_PRE_PROCESS_HTML_URI = 0x00001000
+Uri_CREATE_IE_SETTINGS = 0x00002000
+Uri_CREATE_NO_IE_SETTINGS = 0x00004000
+Uri_CREATE_NO_ENCODE_FORBIDDEN_CHARACTERS = 0x00008000
+Uri_DISPLAY_NO_FRAGMENT = 0x00000001
+Uri_PUNYCODE_IDN_HOST = 0x00000002
+Uri_DISPLAY_IDN_HOST = 0x00000004
+Uri_ENCODING_USER_INFO_AND_PATH_IS_PERCENT_ENCODED_UTF8 = 0x00000001
+Uri_ENCODING_USER_INFO_AND_PATH_IS_CP = 0x00000002
+Uri_ENCODING_HOST_IS_IDN = 0x00000004
+Uri_ENCODING_HOST_IS_PERCENT_ENCODED_UTF8 = 0x00000008
+Uri_ENCODING_HOST_IS_PERCENT_ENCODED_CP = 0x00000010
+Uri_ENCODING_QUERY_AND_FRAGMENT_IS_PERCENT_ENCODED_UTF8 = 0x00000020
+Uri_ENCODING_QUERY_AND_FRAGMENT_IS_CP = 0x00000040
+Uri_ENCODING_RFC = (
+    Uri_ENCODING_USER_INFO_AND_PATH_IS_PERCENT_ENCODED_UTF8
+    | Uri_ENCODING_HOST_IS_PERCENT_ENCODED_UTF8
+    | Uri_ENCODING_QUERY_AND_FRAGMENT_IS_PERCENT_ENCODED_UTF8
+)
+UriBuilder_USE_ORIGINAL_FLAGS = 0x00000001
+WININETINFO_OPTION_LOCK_HANDLE = 65534
+URLOSTRM_USECACHEDCOPY_ONLY = 0x1
+URLOSTRM_USECACHEDCOPY = 0x2
+URLOSTRM_GETNEWESTVERSION = 0x3
+SET_FEATURE_ON_THREAD = 0x00000001
+SET_FEATURE_ON_PROCESS = 0x00000002
+SET_FEATURE_IN_REGISTRY = 0x00000004
+SET_FEATURE_ON_THREAD_LOCALMACHINE = 0x00000008
+SET_FEATURE_ON_THREAD_INTRANET = 0x00000010
+SET_FEATURE_ON_THREAD_TRUSTED = 0x00000020
+SET_FEATURE_ON_THREAD_INTERNET = 0x00000040
+SET_FEATURE_ON_THREAD_RESTRICTED = 0x00000080
+GET_FEATURE_FROM_THREAD = 0x00000001
+GET_FEATURE_FROM_PROCESS = 0x00000002
+GET_FEATURE_FROM_REGISTRY = 0x00000004
+GET_FEATURE_FROM_THREAD_LOCALMACHINE = 0x00000008
+GET_FEATURE_FROM_THREAD_INTRANET = 0x00000010
+GET_FEATURE_FROM_THREAD_TRUSTED = 0x00000020
+GET_FEATURE_FROM_THREAD_INTERNET = 0x00000040
+GET_FEATURE_FROM_THREAD_RESTRICTED = 0x00000080
+PROTOCOLFLAG_NO_PICS_CHECK = 0x00000001
+MUTZ_NOSAVEDFILECHECK = 0x00000001
+MUTZ_ISFILE = 0x00000002
+MUTZ_ACCEPT_WILDCARD_SCHEME = 0x00000080
+MUTZ_ENFORCERESTRICTED = 0x00000100
+MUTZ_RESERVED = 0x00000200
+MUTZ_REQUIRESAVEDFILECHECK = 0x00000400
+MUTZ_DONT_UNESCAPE = 0x00000800
+MUTZ_DONT_USE_CACHE = 0x00001000
+MUTZ_FORCE_INTRANET_FLAGS = 0x00002000
+MUTZ_IGNORE_ZONE_MAPPINGS = 0x00004000
+MAX_SIZE_SECURITY_ID = 512
+URLACTION_MIN = 0x00001000
+URLACTION_DOWNLOAD_MIN = 0x00001000
+URLACTION_DOWNLOAD_SIGNED_ACTIVEX = 0x00001001
+URLACTION_DOWNLOAD_UNSIGNED_ACTIVEX = 0x00001004
+URLACTION_DOWNLOAD_CURR_MAX = 0x00001004
+URLACTION_DOWNLOAD_MAX = 0x000011FF
+URLACTION_ACTIVEX_MIN = 0x00001200
+URLACTION_ACTIVEX_RUN = 0x00001200
+URLPOLICY_ACTIVEX_CHECK_LIST = 0x00010000
+URLACTION_ACTIVEX_OVERRIDE_OBJECT_SAFETY = 0x00001201
+URLACTION_ACTIVEX_OVERRIDE_DATA_SAFETY = 0x00001202
+URLACTION_ACTIVEX_OVERRIDE_SCRIPT_SAFETY = 0x00001203
+URLACTION_SCRIPT_OVERRIDE_SAFETY = 0x00001401
+URLACTION_ACTIVEX_CONFIRM_NOOBJECTSAFETY = 0x00001204
+URLACTION_ACTIVEX_TREATASUNTRUSTED = 0x00001205
+URLACTION_ACTIVEX_NO_WEBOC_SCRIPT = 0x00001206
+URLACTION_ACTIVEX_OVERRIDE_REPURPOSEDETECTION = 0x00001207
+URLACTION_ACTIVEX_OVERRIDE_OPTIN = 0x00001208
+URLACTION_ACTIVEX_SCRIPTLET_RUN = 0x00001209
+URLACTION_ACTIVEX_DYNSRC_VIDEO_AND_ANIMATION = 0x0000120A
+URLACTION_ACTIVEX_CURR_MAX = 0x0000120A
+URLACTION_ACTIVEX_MAX = 0x000013FF
+URLACTION_SCRIPT_MIN = 0x00001400
+URLACTION_SCRIPT_RUN = 0x00001400
+URLACTION_SCRIPT_JAVA_USE = 0x00001402
+URLACTION_SCRIPT_SAFE_ACTIVEX = 0x00001405
+URLACTION_CROSS_DOMAIN_DATA = 0x00001406
+URLACTION_SCRIPT_PASTE = 0x00001407
+URLACTION_ALLOW_XDOMAIN_SUBFRAME_RESIZE = 0x00001408
+URLACTION_SCRIPT_CURR_MAX = 0x00001408
+URLACTION_SCRIPT_MAX = 0x000015FF
+URLACTION_HTML_MIN = 0x00001600
+URLACTION_HTML_SUBMIT_FORMS = 0x00001601
+URLACTION_HTML_SUBMIT_FORMS_FROM = 0x00001602
+URLACTION_HTML_SUBMIT_FORMS_TO = 0x00001603
+URLACTION_HTML_FONT_DOWNLOAD = 0x00001604
+URLACTION_HTML_JAVA_RUN = 0x00001605
+URLACTION_HTML_USERDATA_SAVE = 0x00001606
+URLACTION_HTML_SUBFRAME_NAVIGATE = 0x00001607
+URLACTION_HTML_META_REFRESH = 0x00001608
+URLACTION_HTML_MIXED_CONTENT = 0x00001609
+URLACTION_HTML_INCLUDE_FILE_PATH = 0x0000160A
+URLACTION_HTML_MAX = 0x000017FF
+URLACTION_SHELL_MIN = 0x00001800
+URLACTION_SHELL_INSTALL_DTITEMS = 0x00001800
+URLACTION_SHELL_MOVE_OR_COPY = 0x00001802
+URLACTION_SHELL_FILE_DOWNLOAD = 0x00001803
+URLACTION_SHELL_VERB = 0x00001804
+URLACTION_SHELL_WEBVIEW_VERB = 0x00001805
+URLACTION_SHELL_SHELLEXECUTE = 0x00001806
+URLACTION_SHELL_EXECUTE_HIGHRISK = 0x00001806
+URLACTION_SHELL_EXECUTE_MODRISK = 0x00001807
+URLACTION_SHELL_EXECUTE_LOWRISK = 0x00001808
+URLACTION_SHELL_POPUPMGR = 0x00001809
+URLACTION_SHELL_RTF_OBJECTS_LOAD = 0x0000180A
+URLACTION_SHELL_ENHANCED_DRAGDROP_SECURITY = 0x0000180B
+URLACTION_SHELL_EXTENSIONSECURITY = 0x0000180C
+URLACTION_SHELL_SECURE_DRAGSOURCE = 0x0000180D
+URLACTION_SHELL_CURR_MAX = 0x0000180D
+URLACTION_SHELL_MAX = 0x000019FF
+URLACTION_NETWORK_MIN = 0x00001A00
+URLACTION_CREDENTIALS_USE = 0x00001A00
+URLPOLICY_CREDENTIALS_SILENT_LOGON_OK = 0x00000000
+URLPOLICY_CREDENTIALS_MUST_PROMPT_USER = 0x00010000
+URLPOLICY_CREDENTIALS_CONDITIONAL_PROMPT = 0x00020000
+URLPOLICY_CREDENTIALS_ANONYMOUS_ONLY = 0x00030000
+URLACTION_AUTHENTICATE_CLIENT = 0x00001A01
+URLPOLICY_AUTHENTICATE_CLEARTEXT_OK = 0x00000000
+URLPOLICY_AUTHENTICATE_CHALLENGE_RESPONSE = 0x00010000
+URLPOLICY_AUTHENTICATE_MUTUAL_ONLY = 0x00030000
+URLACTION_COOKIES = 0x00001A02
+URLACTION_COOKIES_SESSION = 0x00001A03
+URLACTION_CLIENT_CERT_PROMPT = 0x00001A04
+URLACTION_COOKIES_THIRD_PARTY = 0x00001A05
+URLACTION_COOKIES_SESSION_THIRD_PARTY = 0x00001A06
+URLACTION_COOKIES_ENABLED = 0x00001A10
+URLACTION_NETWORK_CURR_MAX = 0x00001A10
+URLACTION_NETWORK_MAX = 0x00001BFF
+URLACTION_JAVA_MIN = 0x00001C00
+URLACTION_JAVA_PERMISSIONS = 0x00001C00
+URLPOLICY_JAVA_PROHIBIT = 0x00000000
+URLPOLICY_JAVA_HIGH = 0x00010000
+URLPOLICY_JAVA_MEDIUM = 0x00020000
+URLPOLICY_JAVA_LOW = 0x00030000
+URLPOLICY_JAVA_CUSTOM = 0x00800000
+URLACTION_JAVA_CURR_MAX = 0x00001C00
+URLACTION_JAVA_MAX = 0x00001CFF
+URLACTION_INFODELIVERY_MIN = 0x00001D00
+URLACTION_INFODELIVERY_NO_ADDING_CHANNELS = 0x00001D00
+URLACTION_INFODELIVERY_NO_EDITING_CHANNELS = 0x00001D01
+URLACTION_INFODELIVERY_NO_REMOVING_CHANNELS = 0x00001D02
+URLACTION_INFODELIVERY_NO_ADDING_SUBSCRIPTIONS = 0x00001D03
+URLACTION_INFODELIVERY_NO_EDITING_SUBSCRIPTIONS = 0x00001D04
+URLACTION_INFODELIVERY_NO_REMOVING_SUBSCRIPTIONS = 0x00001D05
+URLACTION_INFODELIVERY_NO_CHANNEL_LOGGING = 0x00001D06
+URLACTION_INFODELIVERY_CURR_MAX = 0x00001D06
+URLACTION_INFODELIVERY_MAX = 0x00001DFF
+URLACTION_CHANNEL_SOFTDIST_MIN = 0x00001E00
+URLACTION_CHANNEL_SOFTDIST_PERMISSIONS = 0x00001E05
+URLPOLICY_CHANNEL_SOFTDIST_PROHIBIT = 0x00010000
+URLPOLICY_CHANNEL_SOFTDIST_PRECACHE = 0x00020000
+URLPOLICY_CHANNEL_SOFTDIST_AUTOINSTALL = 0x00030000
+URLACTION_CHANNEL_SOFTDIST_MAX = 0x00001EFF
+URLACTION_BEHAVIOR_MIN = 0x00002000
+URLACTION_BEHAVIOR_RUN = 0x00002000
+URLPOLICY_BEHAVIOR_CHECK_LIST = 0x00010000
+URLACTION_FEATURE_MIN = 0x00002100
+URLACTION_FEATURE_MIME_SNIFFING = 0x00002100
+URLACTION_FEATURE_ZONE_ELEVATION = 0x00002101
+URLACTION_FEATURE_WINDOW_RESTRICTIONS = 0x00002102
+URLACTION_FEATURE_SCRIPT_STATUS_BAR = 0x00002103
+URLACTION_FEATURE_FORCE_ADDR_AND_STATUS = 0x00002104
+URLACTION_FEATURE_BLOCK_INPUT_PROMPTS = 0x00002105
+URLACTION_AUTOMATIC_DOWNLOAD_UI_MIN = 0x00002200
+URLACTION_AUTOMATIC_DOWNLOAD_UI = 0x00002200
+URLACTION_AUTOMATIC_ACTIVEX_UI = 0x00002201
+URLACTION_ALLOW_RESTRICTEDPROTOCOLS = 0x00002300
+URLACTION_ALLOW_APEVALUATION = 0x00002301
+URLACTION_WINDOWS_BROWSER_APPLICATIONS = 0x00002400
+URLACTION_XPS_DOCUMENTS = 0x00002401
+URLACTION_LOOSE_XAML = 0x00002402
+URLACTION_LOWRIGHTS = 0x00002500
+URLACTION_WINFX_SETUP = 0x00002600
+URLPOLICY_ALLOW = 0x00
+URLPOLICY_QUERY = 0x01
+URLPOLICY_DISALLOW = 0x03
+URLPOLICY_NOTIFY_ON_ALLOW = 0x10
+URLPOLICY_NOTIFY_ON_DISALLOW = 0x20
+URLPOLICY_LOG_ON_ALLOW = 0x40
+URLPOLICY_LOG_ON_DISALLOW = 0x80
+URLPOLICY_MASK_PERMISSIONS = 0x0F
+URLPOLICY_DONTCHECKDLGBOX = 0x100
+URLZONE_ESC_FLAG = 0x100
+SECURITY_IE_STATE_GREEN = 0x00000000
+SECURITY_IE_STATE_RED = 0x00000001
+SOFTDIST_FLAG_USAGE_EMAIL = 0x00000001
+SOFTDIST_FLAG_USAGE_PRECACHE = 0x00000002
+SOFTDIST_FLAG_USAGE_AUTOINSTALL = 0x00000004
+SOFTDIST_FLAG_DELETE_SUBSCRIPTION = 0x00000008
+SOFTDIST_ADSTATE_NONE = 0x00000000
+SOFTDIST_ADSTATE_AVAILABLE = 0x00000001
+SOFTDIST_ADSTATE_DOWNLOADED = 0x00000002
+SOFTDIST_ADSTATE_INSTALLED = 0x00000003
+CONFIRMSAFETYACTION_LOADOBJECT = 0x00000001
diff --git a/lib/win32comext/internet/internet.pyd b/lib/win32comext/internet/internet.pyd
new file mode 100644
index 0000000000000000000000000000000000000000..b46d2db833f25193091c43ca12fbc75f543ea289
GIT binary patch
literal 93696
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

literal 0
HcmV?d00001

diff --git a/lib/win32comext/mapi/__init__.py b/lib/win32comext/mapi/__init__.py
new file mode 100644
index 00000000..3933e212
--- /dev/null
+++ b/lib/win32comext/mapi/__init__.py
@@ -0,0 +1,27 @@
+if type(__path__) == type(""):
+    # For freeze to work!
+    import sys
+
+    try:
+        import mapi
+
+        sys.modules["win32com.mapi.mapi"] = mapi
+    except ImportError:
+        pass
+    try:
+        import exchange
+
+        sys.modules["win32com.mapi.exchange"] = exchange
+    except ImportError:
+        pass
+    try:
+        import exchdapi
+
+        sys.modules["win32com.mapi.exchdapi"] = exchdapi
+    except ImportError:
+        pass
+else:
+    import win32com
+
+    # See if we have a special directory for the binaries (for developers)
+    win32com.__PackageSupportBuildPath__(__path__)
diff --git a/lib/win32comext/mapi/demos/mapisend.py b/lib/win32comext/mapi/demos/mapisend.py
new file mode 100644
index 00000000..9f94361a
--- /dev/null
+++ b/lib/win32comext/mapi/demos/mapisend.py
@@ -0,0 +1,98 @@
+#!/usr/bin/env python
+
+"""module to send mail with Extended MAPI using the pywin32 mapi wrappers..."""
+
+# this was based on Jason Hattingh's C++ code at http://www.codeproject.com/internet/mapadmin.asp
+# written by David Fraser <davidf at sjsoft.com> and Stephen Emslie <stephene at sjsoft.com>
+# you can test this by changing the variables at the bottom and running from the command line
+
+from win32com.mapi import mapi, mapitags
+
+
+def SendEMAPIMail(
+    Subject="", Message="", SendTo=None, SendCC=None, SendBCC=None, MAPIProfile=None
+):
+    """Sends an email to the recipient using the extended MAPI interface
+    Subject and Message are strings
+    Send{To,CC,BCC} are comma-separated address lists
+    MAPIProfile is the name of the MAPI profile"""
+
+    # initialize and log on
+    mapi.MAPIInitialize(None)
+    session = mapi.MAPILogonEx(
+        0, MAPIProfile, None, mapi.MAPI_EXTENDED | mapi.MAPI_USE_DEFAULT
+    )
+    messagestorestable = session.GetMsgStoresTable(0)
+    messagestorestable.SetColumns(
+        (mapitags.PR_ENTRYID, mapitags.PR_DISPLAY_NAME_A, mapitags.PR_DEFAULT_STORE), 0
+    )
+
+    while True:
+        rows = messagestorestable.QueryRows(1, 0)
+        # if this is the last row then stop
+        if len(rows) != 1:
+            break
+        row = rows[0]
+        # if this is the default store then stop
+        if (mapitags.PR_DEFAULT_STORE, True) in row:
+            break
+
+    # unpack the row and open the message store
+    (eid_tag, eid), (name_tag, name), (def_store_tag, def_store) = row
+    msgstore = session.OpenMsgStore(
+        0, eid, None, mapi.MDB_NO_DIALOG | mapi.MAPI_BEST_ACCESS
+    )
+
+    # get the outbox
+    hr, props = msgstore.GetProps((mapitags.PR_IPM_OUTBOX_ENTRYID), 0)
+    (tag, eid) = props[0]
+    # check for errors
+    if mapitags.PROP_TYPE(tag) == mapitags.PT_ERROR:
+        raise TypeError("got PT_ERROR instead of PT_BINARY: %s" % eid)
+    outboxfolder = msgstore.OpenEntry(eid, None, mapi.MAPI_BEST_ACCESS)
+
+    # create the message and the addrlist
+    message = outboxfolder.CreateMessage(None, 0)
+    # note: you can use the resolveaddress functions for this. but you may get headaches
+    pal = []
+
+    def makeentry(recipient, recipienttype):
+        return (
+            (mapitags.PR_RECIPIENT_TYPE, recipienttype),
+            (mapitags.PR_SEND_RICH_INFO, False),
+            (mapitags.PR_DISPLAY_TYPE, 0),
+            (mapitags.PR_OBJECT_TYPE, 6),
+            (mapitags.PR_EMAIL_ADDRESS_A, recipient),
+            (mapitags.PR_ADDRTYPE_A, "SMTP"),
+            (mapitags.PR_DISPLAY_NAME_A, recipient),
+        )
+
+    if SendTo:
+        pal.extend(
+            [makeentry(recipient, mapi.MAPI_TO) for recipient in SendTo.split(",")]
+        )
+    if SendCC:
+        pal.extend(
+            [makeentry(recipient, mapi.MAPI_CC) for recipient in SendCC.split(",")]
+        )
+    if SendBCC:
+        pal.extend(
+            [makeentry(recipient, mapi.MAPI_BCC) for recipient in SendBCC.split(",")]
+        )
+
+    # add the resolved recipients to the message
+    message.ModifyRecipients(mapi.MODRECIP_ADD, pal)
+    message.SetProps([(mapitags.PR_BODY_A, Message), (mapitags.PR_SUBJECT_A, Subject)])
+
+    # save changes and submit
+    outboxfolder.SaveChanges(0)
+    message.SubmitMessage(0)
+
+
+if __name__ == "__main__":
+    MAPIProfile = ""
+    # Change this to a valid email address to test
+    SendTo = "an.invalid at address"
+    SendMessage = "testing one two three"
+    SendSubject = "Testing Extended MAPI!!"
+    SendEMAPIMail(SendSubject, SendMessage, SendTo, MAPIProfile=MAPIProfile)
diff --git a/lib/win32comext/mapi/emsabtags.py b/lib/win32comext/mapi/emsabtags.py
new file mode 100644
index 00000000..65e93df1
--- /dev/null
+++ b/lib/win32comext/mapi/emsabtags.py
@@ -0,0 +1,874 @@
+# Converted "manually" from EMSABTAG.H
+from .mapitags import (
+    PROP_TAG,
+    PT_APPTIME,
+    PT_BINARY,
+    PT_BOOLEAN,
+    PT_CLSID,
+    PT_CURRENCY,
+    PT_DOUBLE,
+    PT_ERROR,
+    PT_FLOAT,
+    PT_I2,
+    PT_I4,
+    PT_I8,
+    PT_LONG,
+    PT_LONGLONG,
+    PT_MV_APPTIME,
+    PT_MV_BINARY,
+    PT_MV_CLSID,
+    PT_MV_CURRENCY,
+    PT_MV_DOUBLE,
+    PT_MV_FLOAT,
+    PT_MV_I2,
+    PT_MV_I4,
+    PT_MV_I8,
+    PT_MV_LONG,
+    PT_MV_LONGLONG,
+    PT_MV_R4,
+    PT_MV_R8,
+    PT_MV_SHORT,
+    PT_MV_STRING8,
+    PT_MV_SYSTIME,
+    PT_MV_TSTRING,
+    PT_MV_UNICODE,
+    PT_NULL,
+    PT_OBJECT,
+    PT_R4,
+    PT_SHORT,
+    PT_STRING8,
+    PT_SYSTIME,
+    PT_TSTRING,
+    PT_UNICODE,
+    PT_UNSPECIFIED,
+)
+
+AB_SHOW_PHANTOMS = 2
+AB_SHOW_OTHERS = 4
+
+# Flags for ulFlag on ResolveNames
+EMS_AB_ADDRESS_LOOKUP = 1
+
+
+# Constructed, but externally visible.
+PR_EMS_AB_SERVER = PROP_TAG(PT_TSTRING, 65534)
+PR_EMS_AB_SERVER_A = PROP_TAG(PT_STRING8, 65534)
+PR_EMS_AB_SERVER_W = PROP_TAG(PT_UNICODE, 65534)
+PR_EMS_AB_CONTAINERID = PROP_TAG(PT_LONG, 65533)
+PR_EMS_AB_DOS_ENTRYID = PR_EMS_AB_CONTAINERID
+PR_EMS_AB_PARENT_ENTRYID = PROP_TAG(PT_BINARY, 65532)
+PR_EMS_AB_IS_MASTER = PROP_TAG(PT_BOOLEAN, 65531)
+PR_EMS_AB_OBJECT_OID = PROP_TAG(PT_BINARY, 65530)
+PR_EMS_AB_HIERARCHY_PATH = PROP_TAG(PT_TSTRING, 65529)
+PR_EMS_AB_HIERARCHY_PATH_A = PROP_TAG(PT_STRING8, 65529)
+PR_EMS_AB_HIERARCHY_PATH_W = PROP_TAG(PT_UNICODE, 65529)
+PR_EMS_AB_CHILD_RDNS = PROP_TAG(PT_MV_STRING8, 65528)
+
+MIN_EMS_AB_CONSTRUCTED_PROP_ID = 65528
+
+PR_EMS_AB_OTHER_RECIPS = PROP_TAG(PT_OBJECT, 61440)
+
+# Prop tags defined in the schema.
+PR_EMS_AB_DISPLAY_NAME_PRINTABLE = PROP_TAG(PT_TSTRING, 14847)
+PR_EMS_AB_DISPLAY_NAME_PRINTABLE_A = PROP_TAG(PT_STRING8, 14847)
+PR_EMS_AB_DISPLAY_NAME_PRINTABLE_W = PROP_TAG(PT_UNICODE, 14847)
+
+PR_EMS_AB_ACCESS_CATEGORY = PROP_TAG(PT_LONG, 32836)
+PR_EMS_AB_ACTIVATION_SCHEDULE = PROP_TAG(PT_BINARY, 32837)
+PR_EMS_AB_ACTIVATION_STYLE = PROP_TAG(PT_LONG, 32838)
+PR_EMS_AB_ADDRESS_ENTRY_DISPLAY_TABLE = PROP_TAG(PT_BINARY, 32791)
+PR_EMS_AB_ADDRESS_ENTRY_DISPLAY_TABLE_MSDOS = PROP_TAG(PT_BINARY, 32839)
+PR_EMS_AB_ADDRESS_SYNTAX = PROP_TAG(PT_BINARY, 32792)
+PR_EMS_AB_ADDRESS_TYPE = PROP_TAG(PT_TSTRING, 32840)
+PR_EMS_AB_ADDRESS_TYPE_A = PROP_TAG(PT_STRING8, 32840)
+PR_EMS_AB_ADDRESS_TYPE_W = PROP_TAG(PT_UNICODE, 32840)
+PR_EMS_AB_ADMD = PROP_TAG(PT_TSTRING, 32841)
+PR_EMS_AB_ADMD_A = PROP_TAG(PT_STRING8, 32841)
+PR_EMS_AB_ADMD_W = PROP_TAG(PT_UNICODE, 32841)
+PR_EMS_AB_ADMIN_DESCRIPTION = PROP_TAG(PT_TSTRING, 32842)
+PR_EMS_AB_ADMIN_DESCRIPTION_A = PROP_TAG(PT_STRING8, 32842)
+PR_EMS_AB_ADMIN_DESCRIPTION_W = PROP_TAG(PT_UNICODE, 32842)
+PR_EMS_AB_ADMIN_DISPLAY_NAME = PROP_TAG(PT_TSTRING, 32843)
+PR_EMS_AB_ADMIN_DISPLAY_NAME_A = PROP_TAG(PT_STRING8, 32843)
+PR_EMS_AB_ADMIN_DISPLAY_NAME_W = PROP_TAG(PT_UNICODE, 32843)
+PR_EMS_AB_ADMIN_EXTENSION_DLL = PROP_TAG(PT_TSTRING, 32844)
+PR_EMS_AB_ADMIN_EXTENSION_DLL_A = PROP_TAG(PT_STRING8, 32844)
+PR_EMS_AB_ADMIN_EXTENSION_DLL_W = PROP_TAG(PT_UNICODE, 32844)
+PR_EMS_AB_ALIASED_OBJECT_NAME = PROP_TAG(PT_TSTRING, 32845)
+PR_EMS_AB_ALIASED_OBJECT_NAME_A = PROP_TAG(PT_STRING8, 32845)
+PR_EMS_AB_ALIASED_OBJECT_NAME_W = PROP_TAG(PT_UNICODE, 32845)
+PR_EMS_AB_ALIASED_OBJECT_NAME_O = PROP_TAG(PT_OBJECT, 32845)
+PR_EMS_AB_ALIASED_OBJECT_NAME_T = PROP_TAG(PT_TSTRING, 32845)
+PR_EMS_AB_ALT_RECIPIENT = PROP_TAG(PT_TSTRING, 32846)
+PR_EMS_AB_ALT_RECIPIENT_A = PROP_TAG(PT_STRING8, 32846)
+PR_EMS_AB_ALT_RECIPIENT_W = PROP_TAG(PT_UNICODE, 32846)
+PR_EMS_AB_ALT_RECIPIENT_O = PROP_TAG(PT_OBJECT, 32846)
+PR_EMS_AB_ALT_RECIPIENT_T = PROP_TAG(PT_TSTRING, 32846)
+PR_EMS_AB_ALT_RECIPIENT_BL = PROP_TAG(PT_MV_TSTRING, 32847)
+PR_EMS_AB_ALT_RECIPIENT_BL_A = PROP_TAG(PT_MV_STRING8, 32847)
+PR_EMS_AB_ALT_RECIPIENT_BL_W = PROP_TAG(PT_MV_UNICODE, 32847)
+PR_EMS_AB_ALT_RECIPIENT_BL_O = PROP_TAG(PT_OBJECT, 32847)
+PR_EMS_AB_ALT_RECIPIENT_BL_T = PROP_TAG(PT_MV_TSTRING, 32847)
+PR_EMS_AB_ANCESTOR_ID = PROP_TAG(PT_BINARY, 32848)
+PR_EMS_AB_ASSOC_NT_ACCOUNT = PROP_TAG(PT_BINARY, 32807)
+PR_EMS_AB_ASSOC_REMOTE_DXA = PROP_TAG(PT_MV_TSTRING, 32849)
+PR_EMS_AB_ASSOC_REMOTE_DXA_A = PROP_TAG(PT_MV_STRING8, 32849)
+PR_EMS_AB_ASSOC_REMOTE_DXA_W = PROP_TAG(PT_MV_UNICODE, 32849)
+PR_EMS_AB_ASSOC_REMOTE_DXA_O = PROP_TAG(PT_OBJECT, 32849)
+PR_EMS_AB_ASSOC_REMOTE_DXA_T = PROP_TAG(PT_MV_TSTRING, 32849)
+PR_EMS_AB_ASSOCIATION_LIFETIME = PROP_TAG(PT_LONG, 32850)
+PR_EMS_AB_AUTH_ORIG_BL = PROP_TAG(PT_MV_TSTRING, 32851)
+PR_EMS_AB_AUTH_ORIG_BL_A = PROP_TAG(PT_MV_STRING8, 32851)
+PR_EMS_AB_AUTH_ORIG_BL_W = PROP_TAG(PT_MV_UNICODE, 32851)
+PR_EMS_AB_AUTH_ORIG_BL_O = PROP_TAG(PT_OBJECT, 32851)
+PR_EMS_AB_AUTH_ORIG_BL_T = PROP_TAG(PT_MV_TSTRING, 32851)
+PR_EMS_AB_AUTHORITY_REVOCATION_LIST = PROP_TAG(PT_MV_BINARY, 32806)
+PR_EMS_AB_AUTHORIZED_DOMAIN = PROP_TAG(PT_TSTRING, 32852)
+PR_EMS_AB_AUTHORIZED_DOMAIN_A = PROP_TAG(PT_STRING8, 32852)
+PR_EMS_AB_AUTHORIZED_DOMAIN_W = PROP_TAG(PT_UNICODE, 32852)
+PR_EMS_AB_AUTHORIZED_PASSWORD = PROP_TAG(PT_BINARY, 32853)
+PR_EMS_AB_AUTHORIZED_USER = PROP_TAG(PT_TSTRING, 32854)
+PR_EMS_AB_AUTHORIZED_USER_A = PROP_TAG(PT_STRING8, 32854)
+PR_EMS_AB_AUTHORIZED_USER_W = PROP_TAG(PT_UNICODE, 32854)
+PR_EMS_AB_AUTOREPLY = PROP_TAG(PT_BOOLEAN, 32779)
+PR_EMS_AB_AUTOREPLY_MESSAGE = PROP_TAG(PT_TSTRING, 32778)
+PR_EMS_AB_AUTOREPLY_MESSAGE_A = PROP_TAG(PT_STRING8, 32778)
+PR_EMS_AB_AUTOREPLY_MESSAGE_W = PROP_TAG(PT_UNICODE, 32778)
+PR_EMS_AB_AUTOREPLY_SUBJECT = PROP_TAG(PT_TSTRING, 32830)
+PR_EMS_AB_AUTOREPLY_SUBJECT_A = PROP_TAG(PT_STRING8, 32830)
+PR_EMS_AB_AUTOREPLY_SUBJECT_W = PROP_TAG(PT_UNICODE, 32830)
+PR_EMS_AB_BRIDGEHEAD_SERVERS = PROP_TAG(PT_MV_TSTRING, 33140)
+PR_EMS_AB_BRIDGEHEAD_SERVERS_A = PROP_TAG(PT_MV_STRING8, 33140)
+PR_EMS_AB_BRIDGEHEAD_SERVERS_W = PROP_TAG(PT_MV_UNICODE, 33140)
+PR_EMS_AB_BRIDGEHEAD_SERVERS_O = PROP_TAG(PT_OBJECT, 33140)
+PR_EMS_AB_BRIDGEHEAD_SERVERS_T = PROP_TAG(PT_MV_TSTRING, 33140)
+PR_EMS_AB_BUSINESS_CATEGORY = PROP_TAG(PT_MV_TSTRING, 32855)
+PR_EMS_AB_BUSINESS_CATEGORY_A = PROP_TAG(PT_MV_STRING8, 32855)
+PR_EMS_AB_BUSINESS_CATEGORY_W = PROP_TAG(PT_MV_UNICODE, 32855)
+PR_EMS_AB_BUSINESS_ROLES = PROP_TAG(PT_BINARY, 32803)
+PR_EMS_AB_CA_CERTIFICATE = PROP_TAG(PT_MV_BINARY, 32771)
+PR_EMS_AB_CAN_CREATE_PF = PROP_TAG(PT_MV_TSTRING, 32856)
+PR_EMS_AB_CAN_CREATE_PF_A = PROP_TAG(PT_MV_STRING8, 32856)
+PR_EMS_AB_CAN_CREATE_PF_W = PROP_TAG(PT_MV_UNICODE, 32856)
+PR_EMS_AB_CAN_CREATE_PF_O = PROP_TAG(PT_OBJECT, 32856)
+PR_EMS_AB_CAN_CREATE_PF_T = PROP_TAG(PT_MV_TSTRING, 32856)
+PR_EMS_AB_CAN_CREATE_PF_BL = PROP_TAG(PT_MV_TSTRING, 32857)
+PR_EMS_AB_CAN_CREATE_PF_BL_A = PROP_TAG(PT_MV_STRING8, 32857)
+PR_EMS_AB_CAN_CREATE_PF_BL_W = PROP_TAG(PT_MV_UNICODE, 32857)
+PR_EMS_AB_CAN_CREATE_PF_BL_O = PROP_TAG(PT_OBJECT, 32857)
+PR_EMS_AB_CAN_CREATE_PF_BL_T = PROP_TAG(PT_MV_TSTRING, 32857)
+PR_EMS_AB_CAN_CREATE_PF_DL = PROP_TAG(PT_MV_TSTRING, 32858)
+PR_EMS_AB_CAN_CREATE_PF_DL_A = PROP_TAG(PT_MV_STRING8, 32858)
+PR_EMS_AB_CAN_CREATE_PF_DL_W = PROP_TAG(PT_MV_UNICODE, 32858)
+PR_EMS_AB_CAN_CREATE_PF_DL_O = PROP_TAG(PT_OBJECT, 32858)
+PR_EMS_AB_CAN_CREATE_PF_DL_T = PROP_TAG(PT_MV_TSTRING, 32858)
+PR_EMS_AB_CAN_CREATE_PF_DL_BL = PROP_TAG(PT_MV_TSTRING, 32859)
+PR_EMS_AB_CAN_CREATE_PF_DL_BL_A = PROP_TAG(PT_MV_STRING8, 32859)
+PR_EMS_AB_CAN_CREATE_PF_DL_BL_W = PROP_TAG(PT_MV_UNICODE, 32859)
+PR_EMS_AB_CAN_CREATE_PF_DL_BL_O = PROP_TAG(PT_OBJECT, 32859)
+PR_EMS_AB_CAN_CREATE_PF_DL_BL_T = PROP_TAG(PT_MV_TSTRING, 32859)
+PR_EMS_AB_CAN_NOT_CREATE_PF = PROP_TAG(PT_MV_TSTRING, 32860)
+PR_EMS_AB_CAN_NOT_CREATE_PF_A = PROP_TAG(PT_MV_STRING8, 32860)
+PR_EMS_AB_CAN_NOT_CREATE_PF_W = PROP_TAG(PT_MV_UNICODE, 32860)
+PR_EMS_AB_CAN_NOT_CREATE_PF_O = PROP_TAG(PT_OBJECT, 32860)
+PR_EMS_AB_CAN_NOT_CREATE_PF_T = PROP_TAG(PT_MV_TSTRING, 32860)
+PR_EMS_AB_CAN_NOT_CREATE_PF_BL = PROP_TAG(PT_MV_TSTRING, 32861)
+PR_EMS_AB_CAN_NOT_CREATE_PF_BL_A = PROP_TAG(PT_MV_STRING8, 32861)
+PR_EMS_AB_CAN_NOT_CREATE_PF_BL_W = PROP_TAG(PT_MV_UNICODE, 32861)
+PR_EMS_AB_CAN_NOT_CREATE_PF_BL_O = PROP_TAG(PT_OBJECT, 32861)
+PR_EMS_AB_CAN_NOT_CREATE_PF_BL_T = PROP_TAG(PT_MV_TSTRING, 32861)
+PR_EMS_AB_CAN_NOT_CREATE_PF_DL = PROP_TAG(PT_MV_TSTRING, 32862)
+PR_EMS_AB_CAN_NOT_CREATE_PF_DL_A = PROP_TAG(PT_MV_STRING8, 32862)
+PR_EMS_AB_CAN_NOT_CREATE_PF_DL_W = PROP_TAG(PT_MV_UNICODE, 32862)
+PR_EMS_AB_CAN_NOT_CREATE_PF_DL_O = PROP_TAG(PT_OBJECT, 32862)
+PR_EMS_AB_CAN_NOT_CREATE_PF_DL_T = PROP_TAG(PT_MV_TSTRING, 32862)
+PR_EMS_AB_CAN_NOT_CREATE_PF_DL_BL = PROP_TAG(PT_MV_TSTRING, 32863)
+PR_EMS_AB_CAN_NOT_CREATE_PF_DL_BL_A = PROP_TAG(PT_MV_STRING8, 32863)
+PR_EMS_AB_CAN_NOT_CREATE_PF_DL_BL_W = PROP_TAG(PT_MV_UNICODE, 32863)
+PR_EMS_AB_CAN_NOT_CREATE_PF_DL_BL_O = PROP_TAG(PT_OBJECT, 32863)
+PR_EMS_AB_CAN_NOT_CREATE_PF_DL_BL_T = PROP_TAG(PT_MV_TSTRING, 32863)
+PR_EMS_AB_CAN_PRESERVE_DNS = PROP_TAG(PT_BOOLEAN, 32864)
+PR_EMS_AB_CERTIFICATE_REVOCATION_LIST = PROP_TAG(PT_BINARY, 32790)
+PR_EMS_AB_CLOCK_ALERT_OFFSET = PROP_TAG(PT_LONG, 32865)
+PR_EMS_AB_CLOCK_ALERT_REPAIR = PROP_TAG(PT_BOOLEAN, 32866)
+PR_EMS_AB_CLOCK_WARNING_OFFSET = PROP_TAG(PT_LONG, 32867)
+PR_EMS_AB_CLOCK_WARNING_REPAIR = PROP_TAG(PT_BOOLEAN, 32868)
+PR_EMS_AB_COMPUTER_NAME = PROP_TAG(PT_TSTRING, 32869)
+PR_EMS_AB_COMPUTER_NAME_A = PROP_TAG(PT_STRING8, 32869)
+PR_EMS_AB_COMPUTER_NAME_W = PROP_TAG(PT_UNICODE, 32869)
+PR_EMS_AB_CONNECTED_DOMAINS = PROP_TAG(PT_MV_TSTRING, 32870)
+PR_EMS_AB_CONNECTED_DOMAINS_A = PROP_TAG(PT_MV_STRING8, 32870)
+PR_EMS_AB_CONNECTED_DOMAINS_W = PROP_TAG(PT_MV_UNICODE, 32870)
+PR_EMS_AB_CONTAINER_INFO = PROP_TAG(PT_LONG, 32871)
+PR_EMS_AB_COST = PROP_TAG(PT_LONG, 32872)
+PR_EMS_AB_COUNTRY_NAME = PROP_TAG(PT_TSTRING, 32873)
+PR_EMS_AB_COUNTRY_NAME_A = PROP_TAG(PT_STRING8, 32873)
+PR_EMS_AB_COUNTRY_NAME_W = PROP_TAG(PT_UNICODE, 32873)
+PR_EMS_AB_CROSS_CERTIFICATE_PAIR = PROP_TAG(PT_MV_BINARY, 32805)
+PR_EMS_AB_DELIV_CONT_LENGTH = PROP_TAG(PT_LONG, 32874)
+PR_EMS_AB_DELIV_EITS = PROP_TAG(PT_MV_BINARY, 32875)
+PR_EMS_AB_DELIV_EXT_CONT_TYPES = PROP_TAG(PT_MV_BINARY, 32876)
+PR_EMS_AB_DELIVER_AND_REDIRECT = PROP_TAG(PT_BOOLEAN, 32877)
+PR_EMS_AB_DELIVERY_MECHANISM = PROP_TAG(PT_LONG, 32878)
+PR_EMS_AB_DESCRIPTION = PROP_TAG(PT_MV_TSTRING, 32879)
+PR_EMS_AB_DESCRIPTION_A = PROP_TAG(PT_MV_STRING8, 32879)
+PR_EMS_AB_DESCRIPTION_W = PROP_TAG(PT_MV_UNICODE, 32879)
+PR_EMS_AB_DESTINATION_INDICATOR = PROP_TAG(PT_MV_TSTRING, 32880)
+PR_EMS_AB_DESTINATION_INDICATOR_A = PROP_TAG(PT_MV_STRING8, 32880)
+PR_EMS_AB_DESTINATION_INDICATOR_W = PROP_TAG(PT_MV_UNICODE, 32880)
+PR_EMS_AB_DIAGNOSTIC_REG_KEY = PROP_TAG(PT_TSTRING, 32881)
+PR_EMS_AB_DIAGNOSTIC_REG_KEY_A = PROP_TAG(PT_STRING8, 32881)
+PR_EMS_AB_DIAGNOSTIC_REG_KEY_W = PROP_TAG(PT_UNICODE, 32881)
+PR_EMS_AB_DISPLAY_NAME_OVERRIDE = PROP_TAG(PT_BOOLEAN, 32769)
+PR_EMS_AB_DL_MEM_REJECT_PERMS_BL = PROP_TAG(PT_MV_TSTRING, 32882)
+PR_EMS_AB_DL_MEM_REJECT_PERMS_BL_A = PROP_TAG(PT_MV_STRING8, 32882)
+PR_EMS_AB_DL_MEM_REJECT_PERMS_BL_W = PROP_TAG(PT_MV_UNICODE, 32882)
+PR_EMS_AB_DL_MEM_REJECT_PERMS_BL_O = PROP_TAG(PT_OBJECT, 32882)
+PR_EMS_AB_DL_MEM_REJECT_PERMS_BL_T = PROP_TAG(PT_MV_TSTRING, 32882)
+PR_EMS_AB_DL_MEM_SUBMIT_PERMS_BL = PROP_TAG(PT_MV_TSTRING, 32883)
+PR_EMS_AB_DL_MEM_SUBMIT_PERMS_BL_A = PROP_TAG(PT_MV_STRING8, 32883)
+PR_EMS_AB_DL_MEM_SUBMIT_PERMS_BL_W = PROP_TAG(PT_MV_UNICODE, 32883)
+PR_EMS_AB_DL_MEM_SUBMIT_PERMS_BL_O = PROP_TAG(PT_OBJECT, 32883)
+PR_EMS_AB_DL_MEM_SUBMIT_PERMS_BL_T = PROP_TAG(PT_MV_TSTRING, 32883)
+PR_EMS_AB_DL_MEMBER_RULE = PROP_TAG(PT_MV_BINARY, 32884)
+PR_EMS_AB_DOMAIN_DEF_ALT_RECIP = PROP_TAG(PT_TSTRING, 32885)
+PR_EMS_AB_DOMAIN_DEF_ALT_RECIP_A = PROP_TAG(PT_STRING8, 32885)
+PR_EMS_AB_DOMAIN_DEF_ALT_RECIP_W = PROP_TAG(PT_UNICODE, 32885)
+PR_EMS_AB_DOMAIN_DEF_ALT_RECIP_O = PROP_TAG(PT_OBJECT, 32885)
+PR_EMS_AB_DOMAIN_DEF_ALT_RECIP_T = PROP_TAG(PT_TSTRING, 32885)
+PR_EMS_AB_DOMAIN_NAME = PROP_TAG(PT_TSTRING, 32886)
+PR_EMS_AB_DOMAIN_NAME_A = PROP_TAG(PT_STRING8, 32886)
+PR_EMS_AB_DOMAIN_NAME_W = PROP_TAG(PT_UNICODE, 32886)
+PR_EMS_AB_DSA_SIGNATURE = PROP_TAG(PT_BINARY, 32887)
+PR_EMS_AB_DXA_ADMIN_COPY = PROP_TAG(PT_BOOLEAN, 32888)
+PR_EMS_AB_DXA_ADMIN_FORWARD = PROP_TAG(PT_BOOLEAN, 32889)
+PR_EMS_AB_DXA_ADMIN_UPDATE = PROP_TAG(PT_LONG, 32890)
+PR_EMS_AB_DXA_APPEND_REQCN = PROP_TAG(PT_BOOLEAN, 32891)
+PR_EMS_AB_DXA_CONF_CONTAINER_LIST = PROP_TAG(PT_MV_TSTRING, 32892)
+PR_EMS_AB_DXA_CONF_CONTAINER_LIST_A = PROP_TAG(PT_MV_STRING8, 32892)
+PR_EMS_AB_DXA_CONF_CONTAINER_LIST_W = PROP_TAG(PT_MV_UNICODE, 32892)
+PR_EMS_AB_DXA_CONF_CONTAINER_LIST_O = PROP_TAG(PT_OBJECT, 32892)
+PR_EMS_AB_DXA_CONF_CONTAINER_LIST_T = PROP_TAG(PT_MV_TSTRING, 32892)
+PR_EMS_AB_DXA_CONF_REQ_TIME = PROP_TAG(PT_SYSTIME, 32893)
+PR_EMS_AB_DXA_CONF_SEQ = PROP_TAG(PT_TSTRING, 32894)
+PR_EMS_AB_DXA_CONF_SEQ_A = PROP_TAG(PT_STRING8, 32894)
+PR_EMS_AB_DXA_CONF_SEQ_W = PROP_TAG(PT_UNICODE, 32894)
+PR_EMS_AB_DXA_CONF_SEQ_USN = PROP_TAG(PT_LONG, 32895)
+PR_EMS_AB_DXA_EXCHANGE_OPTIONS = PROP_TAG(PT_LONG, 32896)
+PR_EMS_AB_DXA_EXPORT_NOW = PROP_TAG(PT_BOOLEAN, 32897)
+PR_EMS_AB_DXA_FLAGS = PROP_TAG(PT_LONG, 32898)
+PR_EMS_AB_DXA_IMP_SEQ = PROP_TAG(PT_TSTRING, 32899)
+PR_EMS_AB_DXA_IMP_SEQ_A = PROP_TAG(PT_STRING8, 32899)
+PR_EMS_AB_DXA_IMP_SEQ_W = PROP_TAG(PT_UNICODE, 32899)
+PR_EMS_AB_DXA_IMP_SEQ_TIME = PROP_TAG(PT_SYSTIME, 32900)
+PR_EMS_AB_DXA_IMP_SEQ_USN = PROP_TAG(PT_LONG, 32901)
+PR_EMS_AB_DXA_IMPORT_NOW = PROP_TAG(PT_BOOLEAN, 32902)
+PR_EMS_AB_DXA_IN_TEMPLATE_MAP = PROP_TAG(PT_MV_TSTRING, 32903)
+PR_EMS_AB_DXA_IN_TEMPLATE_MAP_A = PROP_TAG(PT_MV_STRING8, 32903)
+PR_EMS_AB_DXA_IN_TEMPLATE_MAP_W = PROP_TAG(PT_MV_UNICODE, 32903)
+PR_EMS_AB_DXA_LOCAL_ADMIN = PROP_TAG(PT_TSTRING, 32904)
+PR_EMS_AB_DXA_LOCAL_ADMIN_A = PROP_TAG(PT_STRING8, 32904)
+PR_EMS_AB_DXA_LOCAL_ADMIN_W = PROP_TAG(PT_UNICODE, 32904)
+PR_EMS_AB_DXA_LOCAL_ADMIN_O = PROP_TAG(PT_OBJECT, 32904)
+PR_EMS_AB_DXA_LOCAL_ADMIN_T = PROP_TAG(PT_TSTRING, 32904)
+PR_EMS_AB_DXA_LOGGING_LEVEL = PROP_TAG(PT_LONG, 32905)
+PR_EMS_AB_DXA_NATIVE_ADDRESS_TYPE = PROP_TAG(PT_TSTRING, 32906)
+PR_EMS_AB_DXA_NATIVE_ADDRESS_TYPE_A = PROP_TAG(PT_STRING8, 32906)
+PR_EMS_AB_DXA_NATIVE_ADDRESS_TYPE_W = PROP_TAG(PT_UNICODE, 32906)
+PR_EMS_AB_DXA_OUT_TEMPLATE_MAP = PROP_TAG(PT_MV_TSTRING, 32907)
+PR_EMS_AB_DXA_OUT_TEMPLATE_MAP_A = PROP_TAG(PT_MV_STRING8, 32907)
+PR_EMS_AB_DXA_OUT_TEMPLATE_MAP_W = PROP_TAG(PT_MV_UNICODE, 32907)
+PR_EMS_AB_DXA_PASSWORD = PROP_TAG(PT_TSTRING, 32908)
+PR_EMS_AB_DXA_PASSWORD_A = PROP_TAG(PT_STRING8, 32908)
+PR_EMS_AB_DXA_PASSWORD_W = PROP_TAG(PT_UNICODE, 32908)
+PR_EMS_AB_DXA_PREV_EXCHANGE_OPTIONS = PROP_TAG(PT_LONG, 32909)
+PR_EMS_AB_DXA_PREV_EXPORT_NATIVE_ONLY = PROP_TAG(PT_BOOLEAN, 32910)
+PR_EMS_AB_DXA_PREV_IN_EXCHANGE_SENSITIVITY = PROP_TAG(PT_LONG, 32911)
+PR_EMS_AB_DXA_PREV_REMOTE_ENTRIES = PROP_TAG(PT_TSTRING, 32912)
+PR_EMS_AB_DXA_PREV_REMOTE_ENTRIES_A = PROP_TAG(PT_STRING8, 32912)
+PR_EMS_AB_DXA_PREV_REMOTE_ENTRIES_W = PROP_TAG(PT_UNICODE, 32912)
+PR_EMS_AB_DXA_PREV_REMOTE_ENTRIES_O = PROP_TAG(PT_OBJECT, 32912)
+PR_EMS_AB_DXA_PREV_REMOTE_ENTRIES_T = PROP_TAG(PT_TSTRING, 32912)
+PR_EMS_AB_DXA_PREV_REPLICATION_SENSITIVITY = PROP_TAG(PT_LONG, 32913)
+PR_EMS_AB_DXA_PREV_TEMPLATE_OPTIONS = PROP_TAG(PT_LONG, 32914)
+PR_EMS_AB_DXA_PREV_TYPES = PROP_TAG(PT_LONG, 32915)
+PR_EMS_AB_DXA_RECIPIENT_CP = PROP_TAG(PT_TSTRING, 32916)
+PR_EMS_AB_DXA_RECIPIENT_CP_A = PROP_TAG(PT_STRING8, 32916)
+PR_EMS_AB_DXA_RECIPIENT_CP_W = PROP_TAG(PT_UNICODE, 32916)
+PR_EMS_AB_DXA_REMOTE_CLIENT = PROP_TAG(PT_TSTRING, 32917)
+PR_EMS_AB_DXA_REMOTE_CLIENT_A = PROP_TAG(PT_STRING8, 32917)
+PR_EMS_AB_DXA_REMOTE_CLIENT_W = PROP_TAG(PT_UNICODE, 32917)
+PR_EMS_AB_DXA_REMOTE_CLIENT_O = PROP_TAG(PT_OBJECT, 32917)
+PR_EMS_AB_DXA_REMOTE_CLIENT_T = PROP_TAG(PT_TSTRING, 32917)
+PR_EMS_AB_DXA_REQ_SEQ = PROP_TAG(PT_TSTRING, 32918)
+PR_EMS_AB_DXA_REQ_SEQ_A = PROP_TAG(PT_STRING8, 32918)
+PR_EMS_AB_DXA_REQ_SEQ_W = PROP_TAG(PT_UNICODE, 32918)
+PR_EMS_AB_DXA_REQ_SEQ_TIME = PROP_TAG(PT_SYSTIME, 32919)
+PR_EMS_AB_DXA_REQ_SEQ_USN = PROP_TAG(PT_LONG, 32920)
+PR_EMS_AB_DXA_REQNAME = PROP_TAG(PT_TSTRING, 32921)
+PR_EMS_AB_DXA_REQNAME_A = PROP_TAG(PT_STRING8, 32921)
+PR_EMS_AB_DXA_REQNAME_W = PROP_TAG(PT_UNICODE, 32921)
+PR_EMS_AB_DXA_SVR_SEQ = PROP_TAG(PT_TSTRING, 32922)
+PR_EMS_AB_DXA_SVR_SEQ_A = PROP_TAG(PT_STRING8, 32922)
+PR_EMS_AB_DXA_SVR_SEQ_W = PROP_TAG(PT_UNICODE, 32922)
+PR_EMS_AB_DXA_SVR_SEQ_TIME = PROP_TAG(PT_SYSTIME, 32923)
+PR_EMS_AB_DXA_SVR_SEQ_USN = PROP_TAG(PT_LONG, 32924)
+PR_EMS_AB_DXA_TASK = PROP_TAG(PT_LONG, 32925)
+PR_EMS_AB_DXA_TEMPLATE_OPTIONS = PROP_TAG(PT_LONG, 32926)
+PR_EMS_AB_DXA_TEMPLATE_TIMESTAMP = PROP_TAG(PT_SYSTIME, 32927)
+PR_EMS_AB_DXA_TYPES = PROP_TAG(PT_LONG, 32928)
+PR_EMS_AB_DXA_UNCONF_CONTAINER_LIST = PROP_TAG(PT_MV_TSTRING, 32929)
+PR_EMS_AB_DXA_UNCONF_CONTAINER_LIST_A = PROP_TAG(PT_MV_STRING8, 32929)
+PR_EMS_AB_DXA_UNCONF_CONTAINER_LIST_W = PROP_TAG(PT_MV_UNICODE, 32929)
+PR_EMS_AB_DXA_UNCONF_CONTAINER_LIST_O = PROP_TAG(PT_OBJECT, 32929)
+PR_EMS_AB_DXA_UNCONF_CONTAINER_LIST_T = PROP_TAG(PT_MV_TSTRING, 32929)
+PR_EMS_AB_ENABLED_PROTOCOLS = PROP_TAG(PT_LONG, 33151)
+PR_EMS_AB_ENCAPSULATION_METHOD = PROP_TAG(PT_LONG, 32930)
+PR_EMS_AB_ENCRYPT = PROP_TAG(PT_BOOLEAN, 32931)
+PR_EMS_AB_ENCRYPT_ALG_LIST_NA = PROP_TAG(PT_MV_TSTRING, 32832)
+PR_EMS_AB_ENCRYPT_ALG_LIST_NA_A = PROP_TAG(PT_MV_STRING8, 32832)
+PR_EMS_AB_ENCRYPT_ALG_LIST_NA_W = PROP_TAG(PT_MV_UNICODE, 32832)
+PR_EMS_AB_ENCRYPT_ALG_LIST_OTHER = PROP_TAG(PT_MV_TSTRING, 32833)
+PR_EMS_AB_ENCRYPT_ALG_LIST_OTHER_A = PROP_TAG(PT_MV_STRING8, 32833)
+PR_EMS_AB_ENCRYPT_ALG_LIST_OTHER_W = PROP_TAG(PT_MV_UNICODE, 32833)
+PR_EMS_AB_ENCRYPT_ALG_SELECTED_NA = PROP_TAG(PT_TSTRING, 32835)
+PR_EMS_AB_ENCRYPT_ALG_SELECTED_NA_A = PROP_TAG(PT_STRING8, 32835)
+PR_EMS_AB_ENCRYPT_ALG_SELECTED_NA_W = PROP_TAG(PT_UNICODE, 32835)
+PR_EMS_AB_ENCRYPT_ALG_SELECTED_OTHER = PROP_TAG(PT_TSTRING, 32829)
+PR_EMS_AB_ENCRYPT_ALG_SELECTED_OTHER_A = PROP_TAG(PT_STRING8, 32829)
+PR_EMS_AB_ENCRYPT_ALG_SELECTED_OTHER_W = PROP_TAG(PT_UNICODE, 32829)
+PR_EMS_AB_EXPAND_DLS_LOCALLY = PROP_TAG(PT_BOOLEAN, 32932)
+PR_EMS_AB_EXPIRATION_TIME = PROP_TAG(PT_SYSTIME, 32808)
+PR_EMS_AB_EXPORT_CONTAINERS = PROP_TAG(PT_MV_TSTRING, 32933)
+PR_EMS_AB_EXPORT_CONTAINERS_A = PROP_TAG(PT_MV_STRING8, 32933)
+PR_EMS_AB_EXPORT_CONTAINERS_W = PROP_TAG(PT_MV_UNICODE, 32933)
+PR_EMS_AB_EXPORT_CONTAINERS_O = PROP_TAG(PT_OBJECT, 32933)
+PR_EMS_AB_EXPORT_CONTAINERS_T = PROP_TAG(PT_MV_TSTRING, 32933)
+PR_EMS_AB_EXPORT_CUSTOM_RECIPIENTS = PROP_TAG(PT_BOOLEAN, 32934)
+PR_EMS_AB_EXTENDED_CHARS_ALLOWED = PROP_TAG(PT_BOOLEAN, 32935)
+PR_EMS_AB_EXTENSION_ATTRIBUTE_1 = PROP_TAG(PT_TSTRING, 32813)
+PR_EMS_AB_EXTENSION_ATTRIBUTE_1_A = PROP_TAG(PT_STRING8, 32813)
+PR_EMS_AB_EXTENSION_ATTRIBUTE_1_W = PROP_TAG(PT_UNICODE, 32813)
+PR_EMS_AB_EXTENSION_ATTRIBUTE_10 = PROP_TAG(PT_TSTRING, 32822)
+PR_EMS_AB_EXTENSION_ATTRIBUTE_10_A = PROP_TAG(PT_STRING8, 32822)
+PR_EMS_AB_EXTENSION_ATTRIBUTE_10_W = PROP_TAG(PT_UNICODE, 32822)
+PR_EMS_AB_EXTENSION_ATTRIBUTE_2 = PROP_TAG(PT_TSTRING, 32814)
+PR_EMS_AB_EXTENSION_ATTRIBUTE_2_A = PROP_TAG(PT_STRING8, 32814)
+PR_EMS_AB_EXTENSION_ATTRIBUTE_2_W = PROP_TAG(PT_UNICODE, 32814)
+PR_EMS_AB_EXTENSION_ATTRIBUTE_3 = PROP_TAG(PT_TSTRING, 32815)
+PR_EMS_AB_EXTENSION_ATTRIBUTE_3_A = PROP_TAG(PT_STRING8, 32815)
+PR_EMS_AB_EXTENSION_ATTRIBUTE_3_W = PROP_TAG(PT_UNICODE, 32815)
+PR_EMS_AB_EXTENSION_ATTRIBUTE_4 = PROP_TAG(PT_TSTRING, 32816)
+PR_EMS_AB_EXTENSION_ATTRIBUTE_4_A = PROP_TAG(PT_STRING8, 32816)
+PR_EMS_AB_EXTENSION_ATTRIBUTE_4_W = PROP_TAG(PT_UNICODE, 32816)
+PR_EMS_AB_EXTENSION_ATTRIBUTE_5 = PROP_TAG(PT_TSTRING, 32817)
+PR_EMS_AB_EXTENSION_ATTRIBUTE_5_A = PROP_TAG(PT_STRING8, 32817)
+PR_EMS_AB_EXTENSION_ATTRIBUTE_5_W = PROP_TAG(PT_UNICODE, 32817)
+PR_EMS_AB_EXTENSION_ATTRIBUTE_6 = PROP_TAG(PT_TSTRING, 32818)
+PR_EMS_AB_EXTENSION_ATTRIBUTE_6_A = PROP_TAG(PT_STRING8, 32818)
+PR_EMS_AB_EXTENSION_ATTRIBUTE_6_W = PROP_TAG(PT_UNICODE, 32818)
+PR_EMS_AB_EXTENSION_ATTRIBUTE_7 = PROP_TAG(PT_TSTRING, 32819)
+PR_EMS_AB_EXTENSION_ATTRIBUTE_7_A = PROP_TAG(PT_STRING8, 32819)
+PR_EMS_AB_EXTENSION_ATTRIBUTE_7_W = PROP_TAG(PT_UNICODE, 32819)
+PR_EMS_AB_EXTENSION_ATTRIBUTE_8 = PROP_TAG(PT_TSTRING, 32820)
+PR_EMS_AB_EXTENSION_ATTRIBUTE_8_A = PROP_TAG(PT_STRING8, 32820)
+PR_EMS_AB_EXTENSION_ATTRIBUTE_8_W = PROP_TAG(PT_UNICODE, 32820)
+PR_EMS_AB_EXTENSION_ATTRIBUTE_9 = PROP_TAG(PT_TSTRING, 32821)
+PR_EMS_AB_EXTENSION_ATTRIBUTE_9_A = PROP_TAG(PT_STRING8, 32821)
+PR_EMS_AB_EXTENSION_ATTRIBUTE_9_W = PROP_TAG(PT_UNICODE, 32821)
+PR_EMS_AB_EXTENSION_DATA = PROP_TAG(PT_MV_BINARY, 32936)
+PR_EMS_AB_EXTENSION_NAME = PROP_TAG(PT_MV_TSTRING, 32937)
+PR_EMS_AB_EXTENSION_NAME_A = PROP_TAG(PT_MV_STRING8, 32937)
+PR_EMS_AB_EXTENSION_NAME_W = PROP_TAG(PT_MV_UNICODE, 32937)
+PR_EMS_AB_EXTENSION_NAME_INHERITED = PROP_TAG(PT_MV_TSTRING, 32938)
+PR_EMS_AB_EXTENSION_NAME_INHERITED_A = PROP_TAG(PT_MV_STRING8, 32938)
+PR_EMS_AB_EXTENSION_NAME_INHERITED_W = PROP_TAG(PT_MV_UNICODE, 32938)
+PR_EMS_AB_FACSIMILE_TELEPHONE_NUMBER = PROP_TAG(PT_MV_BINARY, 32939)
+PR_EMS_AB_FILE_VERSION = PROP_TAG(PT_BINARY, 32940)
+PR_EMS_AB_FILTER_LOCAL_ADDRESSES = PROP_TAG(PT_BOOLEAN, 32941)
+PR_EMS_AB_FOLDER_PATHNAME = PROP_TAG(PT_TSTRING, 32772)
+PR_EMS_AB_FOLDER_PATHNAME_A = PROP_TAG(PT_STRING8, 32772)
+PR_EMS_AB_FOLDER_PATHNAME_W = PROP_TAG(PT_UNICODE, 32772)
+PR_EMS_AB_FOLDERS_CONTAINER = PROP_TAG(PT_TSTRING, 32942)
+PR_EMS_AB_FOLDERS_CONTAINER_A = PROP_TAG(PT_STRING8, 32942)
+PR_EMS_AB_FOLDERS_CONTAINER_W = PROP_TAG(PT_UNICODE, 32942)
+PR_EMS_AB_FOLDERS_CONTAINER_O = PROP_TAG(PT_OBJECT, 32942)
+PR_EMS_AB_FOLDERS_CONTAINER_T = PROP_TAG(PT_TSTRING, 32942)
+PR_EMS_AB_GARBAGE_COLL_PERIOD = PROP_TAG(PT_LONG, 32943)
+PR_EMS_AB_GATEWAY_LOCAL_CRED = PROP_TAG(PT_TSTRING, 32944)
+PR_EMS_AB_GATEWAY_LOCAL_CRED_A = PROP_TAG(PT_STRING8, 32944)
+PR_EMS_AB_GATEWAY_LOCAL_CRED_W = PROP_TAG(PT_UNICODE, 32944)
+PR_EMS_AB_GATEWAY_LOCAL_DESIG = PROP_TAG(PT_TSTRING, 32945)
+PR_EMS_AB_GATEWAY_LOCAL_DESIG_A = PROP_TAG(PT_STRING8, 32945)
+PR_EMS_AB_GATEWAY_LOCAL_DESIG_W = PROP_TAG(PT_UNICODE, 32945)
+PR_EMS_AB_GATEWAY_PROXY = PROP_TAG(PT_MV_TSTRING, 32946)
+PR_EMS_AB_GATEWAY_PROXY_A = PROP_TAG(PT_MV_STRING8, 32946)
+PR_EMS_AB_GATEWAY_PROXY_W = PROP_TAG(PT_MV_UNICODE, 32946)
+PR_EMS_AB_GATEWAY_ROUTING_TREE = PROP_TAG(PT_BINARY, 32947)
+PR_EMS_AB_GWART_LAST_MODIFIED = PROP_TAG(PT_SYSTIME, 32948)
+PR_EMS_AB_HAS_FULL_REPLICA_NCS = PROP_TAG(PT_MV_TSTRING, 32949)
+PR_EMS_AB_HAS_FULL_REPLICA_NCS_A = PROP_TAG(PT_MV_STRING8, 32949)
+PR_EMS_AB_HAS_FULL_REPLICA_NCS_W = PROP_TAG(PT_MV_UNICODE, 32949)
+PR_EMS_AB_HAS_FULL_REPLICA_NCS_O = PROP_TAG(PT_OBJECT, 32949)
+PR_EMS_AB_HAS_FULL_REPLICA_NCS_T = PROP_TAG(PT_MV_TSTRING, 32949)
+PR_EMS_AB_HAS_MASTER_NCS = PROP_TAG(PT_MV_TSTRING, 32950)
+PR_EMS_AB_HAS_MASTER_NCS_A = PROP_TAG(PT_MV_STRING8, 32950)
+PR_EMS_AB_HAS_MASTER_NCS_W = PROP_TAG(PT_MV_UNICODE, 32950)
+PR_EMS_AB_HAS_MASTER_NCS_O = PROP_TAG(PT_OBJECT, 32950)
+PR_EMS_AB_HAS_MASTER_NCS_T = PROP_TAG(PT_MV_TSTRING, 32950)
+PR_EMS_AB_HELP_DATA16 = PROP_TAG(PT_BINARY, 32826)
+PR_EMS_AB_HELP_DATA32 = PROP_TAG(PT_BINARY, 32784)
+PR_EMS_AB_HELP_FILE_NAME = PROP_TAG(PT_TSTRING, 32827)
+PR_EMS_AB_HELP_FILE_NAME_A = PROP_TAG(PT_STRING8, 32827)
+PR_EMS_AB_HELP_FILE_NAME_W = PROP_TAG(PT_UNICODE, 32827)
+PR_EMS_AB_HEURISTICS = PROP_TAG(PT_LONG, 32951)
+PR_EMS_AB_HIDE_DL_MEMBERSHIP = PROP_TAG(PT_BOOLEAN, 32952)
+PR_EMS_AB_HIDE_FROM_ADDRESS_BOOK = PROP_TAG(PT_BOOLEAN, 32953)
+PR_EMS_AB_HOME_MDB = PROP_TAG(PT_TSTRING, 32774)
+PR_EMS_AB_HOME_MDB_A = PROP_TAG(PT_STRING8, 32774)
+PR_EMS_AB_HOME_MDB_W = PROP_TAG(PT_UNICODE, 32774)
+PR_EMS_AB_HOME_MDB_O = PROP_TAG(PT_OBJECT, 32774)
+PR_EMS_AB_HOME_MDB_T = PROP_TAG(PT_TSTRING, 32774)
+PR_EMS_AB_HOME_MDB_BL = PROP_TAG(PT_MV_TSTRING, 32788)
+PR_EMS_AB_HOME_MDB_BL_A = PROP_TAG(PT_MV_STRING8, 32788)
+PR_EMS_AB_HOME_MDB_BL_W = PROP_TAG(PT_MV_UNICODE, 32788)
+PR_EMS_AB_HOME_MDB_BL_O = PROP_TAG(PT_OBJECT, 32788)
+PR_EMS_AB_HOME_MDB_BL_T = PROP_TAG(PT_MV_TSTRING, 32788)
+PR_EMS_AB_HOME_MTA = PROP_TAG(PT_TSTRING, 32775)
+PR_EMS_AB_HOME_MTA_A = PROP_TAG(PT_STRING8, 32775)
+PR_EMS_AB_HOME_MTA_W = PROP_TAG(PT_UNICODE, 32775)
+PR_EMS_AB_HOME_MTA_O = PROP_TAG(PT_OBJECT, 32775)
+PR_EMS_AB_HOME_MTA_T = PROP_TAG(PT_TSTRING, 32775)
+PR_EMS_AB_HOME_PUBLIC_SERVER = PROP_TAG(PT_TSTRING, 32831)
+PR_EMS_AB_HOME_PUBLIC_SERVER_A = PROP_TAG(PT_STRING8, 32831)
+PR_EMS_AB_HOME_PUBLIC_SERVER_W = PROP_TAG(PT_UNICODE, 32831)
+PR_EMS_AB_HOME_PUBLIC_SERVER_O = PROP_TAG(PT_OBJECT, 32831)
+PR_EMS_AB_HOME_PUBLIC_SERVER_T = PROP_TAG(PT_TSTRING, 32831)
+PR_EMS_AB_IMPORT_CONTAINER = PROP_TAG(PT_TSTRING, 32954)
+PR_EMS_AB_IMPORT_CONTAINER_A = PROP_TAG(PT_STRING8, 32954)
+PR_EMS_AB_IMPORT_CONTAINER_W = PROP_TAG(PT_UNICODE, 32954)
+PR_EMS_AB_IMPORT_CONTAINER_O = PROP_TAG(PT_OBJECT, 32954)
+PR_EMS_AB_IMPORT_CONTAINER_T = PROP_TAG(PT_TSTRING, 32954)
+PR_EMS_AB_IMPORT_SENSITIVITY = PROP_TAG(PT_LONG, 32955)
+PR_EMS_AB_IMPORTED_FROM = PROP_TAG(PT_TSTRING, 32834)
+PR_EMS_AB_IMPORTED_FROM_A = PROP_TAG(PT_STRING8, 32834)
+PR_EMS_AB_IMPORTED_FROM_W = PROP_TAG(PT_UNICODE, 32834)
+PR_EMS_AB_INBOUND_SITES = PROP_TAG(PT_MV_TSTRING, 32956)
+PR_EMS_AB_INBOUND_SITES_A = PROP_TAG(PT_MV_STRING8, 32956)
+PR_EMS_AB_INBOUND_SITES_W = PROP_TAG(PT_MV_UNICODE, 32956)
+PR_EMS_AB_INBOUND_SITES_O = PROP_TAG(PT_OBJECT, 32956)
+PR_EMS_AB_INBOUND_SITES_T = PROP_TAG(PT_MV_TSTRING, 32956)
+PR_EMS_AB_INSTANCE_TYPE = PROP_TAG(PT_LONG, 32957)
+PR_EMS_AB_INTERNATIONAL_ISDN_NUMBER = PROP_TAG(PT_MV_TSTRING, 32958)
+PR_EMS_AB_INTERNATIONAL_ISDN_NUMBER_A = PROP_TAG(PT_MV_STRING8, 32958)
+PR_EMS_AB_INTERNATIONAL_ISDN_NUMBER_W = PROP_TAG(PT_MV_UNICODE, 32958)
+PR_EMS_AB_INVOCATION_ID = PROP_TAG(PT_BINARY, 32959)
+PR_EMS_AB_IS_DELETED = PROP_TAG(PT_BOOLEAN, 32960)
+PR_EMS_AB_IS_MEMBER_OF_DL = PROP_TAG(PT_OBJECT, 32776)
+PR_EMS_AB_IS_MEMBER_OF_DL_A = PROP_TAG(PT_MV_STRING8, 32776)
+PR_EMS_AB_IS_MEMBER_OF_DL_W = PROP_TAG(PT_MV_UNICODE, 32776)
+PR_EMS_AB_IS_MEMBER_OF_DL_O = PROP_TAG(PT_OBJECT, 32776)
+PR_EMS_AB_IS_MEMBER_OF_DL_T = PROP_TAG(PT_MV_TSTRING, 32776)
+PR_EMS_AB_IS_SINGLE_VALUED = PROP_TAG(PT_BOOLEAN, 32961)
+PR_EMS_AB_KCC_STATUS = PROP_TAG(PT_MV_BINARY, 32962)
+PR_EMS_AB_KM_SERVER = PROP_TAG(PT_TSTRING, 32781)
+PR_EMS_AB_KM_SERVER_A = PROP_TAG(PT_STRING8, 32781)
+PR_EMS_AB_KM_SERVER_W = PROP_TAG(PT_UNICODE, 32781)
+PR_EMS_AB_KM_SERVER_O = PROP_TAG(PT_OBJECT, 32781)
+PR_EMS_AB_KM_SERVER_T = PROP_TAG(PT_TSTRING, 32781)
+PR_EMS_AB_KNOWLEDGE_INFORMATION = PROP_TAG(PT_MV_TSTRING, 32963)
+PR_EMS_AB_KNOWLEDGE_INFORMATION_A = PROP_TAG(PT_MV_STRING8, 32963)
+PR_EMS_AB_KNOWLEDGE_INFORMATION_W = PROP_TAG(PT_MV_UNICODE, 32963)
+PR_EMS_AB_LANGUAGE = PROP_TAG(PT_LONG, 33144)
+PR_EMS_AB_LDAP_DISPLAY_NAME = PROP_TAG(PT_MV_TSTRING, 33137)
+PR_EMS_AB_LDAP_DISPLAY_NAME_A = PROP_TAG(PT_MV_STRING8, 33137)
+PR_EMS_AB_LDAP_DISPLAY_NAME_W = PROP_TAG(PT_MV_UNICODE, 33137)
+PR_EMS_AB_LINE_WRAP = PROP_TAG(PT_LONG, 32964)
+PR_EMS_AB_LINK_ID = PROP_TAG(PT_LONG, 32965)
+PR_EMS_AB_LOCAL_BRIDGE_HEAD = PROP_TAG(PT_TSTRING, 32966)
+PR_EMS_AB_LOCAL_BRIDGE_HEAD_A = PROP_TAG(PT_STRING8, 32966)
+PR_EMS_AB_LOCAL_BRIDGE_HEAD_W = PROP_TAG(PT_UNICODE, 32966)
+PR_EMS_AB_LOCAL_BRIDGE_HEAD_ADDRESS = PROP_TAG(PT_TSTRING, 32967)
+PR_EMS_AB_LOCAL_BRIDGE_HEAD_ADDRESS_A = PROP_TAG(PT_STRING8, 32967)
+PR_EMS_AB_LOCAL_BRIDGE_HEAD_ADDRESS_W = PROP_TAG(PT_UNICODE, 32967)
+PR_EMS_AB_LOCAL_INITIAL_TURN = PROP_TAG(PT_BOOLEAN, 32968)
+PR_EMS_AB_LOCAL_SCOPE = PROP_TAG(PT_MV_TSTRING, 32969)
+PR_EMS_AB_LOCAL_SCOPE_A = PROP_TAG(PT_MV_STRING8, 32969)
+PR_EMS_AB_LOCAL_SCOPE_W = PROP_TAG(PT_MV_UNICODE, 32969)
+PR_EMS_AB_LOCAL_SCOPE_O = PROP_TAG(PT_OBJECT, 32969)
+PR_EMS_AB_LOCAL_SCOPE_T = PROP_TAG(PT_MV_TSTRING, 32969)
+PR_EMS_AB_LOG_FILENAME = PROP_TAG(PT_TSTRING, 32970)
+PR_EMS_AB_LOG_FILENAME_A = PROP_TAG(PT_STRING8, 32970)
+PR_EMS_AB_LOG_FILENAME_W = PROP_TAG(PT_UNICODE, 32970)
+PR_EMS_AB_LOG_ROLLOVER_INTERVAL = PROP_TAG(PT_LONG, 32971)
+PR_EMS_AB_MAINTAIN_AUTOREPLY_HISTORY = PROP_TAG(PT_BOOLEAN, 32972)
+PR_EMS_AB_MANAGER = PROP_TAG(PT_OBJECT, 32773)
+PR_EMS_AB_MANAGER_A = PROP_TAG(PT_STRING8, 32773)
+PR_EMS_AB_MANAGER_W = PROP_TAG(PT_UNICODE, 32773)
+PR_EMS_AB_MANAGER_O = PROP_TAG(PT_OBJECT, 32773)
+PR_EMS_AB_MANAGER_T = PROP_TAG(PT_TSTRING, 32773)
+PR_EMS_AB_MAPI_DISPLAY_TYPE = PROP_TAG(PT_LONG, 32973)
+PR_EMS_AB_MAPI_ID = PROP_TAG(PT_LONG, 32974)
+PR_EMS_AB_MAXIMUM_OBJECT_ID = PROP_TAG(PT_BINARY, 33129)
+PR_EMS_AB_MDB_BACKOFF_INTERVAL = PROP_TAG(PT_LONG, 32975)
+PR_EMS_AB_MDB_MSG_TIME_OUT_PERIOD = PROP_TAG(PT_LONG, 32976)
+PR_EMS_AB_MDB_OVER_QUOTA_LIMIT = PROP_TAG(PT_LONG, 32977)
+PR_EMS_AB_MDB_STORAGE_QUOTA = PROP_TAG(PT_LONG, 32978)
+PR_EMS_AB_MDB_UNREAD_LIMIT = PROP_TAG(PT_LONG, 32979)
+PR_EMS_AB_MDB_USE_DEFAULTS = PROP_TAG(PT_BOOLEAN, 32980)
+PR_EMS_AB_MEMBER = PROP_TAG(PT_OBJECT, 32777)
+PR_EMS_AB_MEMBER_A = PROP_TAG(PT_MV_STRING8, 32777)
+PR_EMS_AB_MEMBER_W = PROP_TAG(PT_MV_UNICODE, 32777)
+PR_EMS_AB_MEMBER_O = PROP_TAG(PT_OBJECT, 32777)
+PR_EMS_AB_MEMBER_T = PROP_TAG(PT_MV_TSTRING, 32777)
+PR_EMS_AB_MESSAGE_TRACKING_ENABLED = PROP_TAG(PT_BOOLEAN, 32981)
+PR_EMS_AB_MONITOR_CLOCK = PROP_TAG(PT_BOOLEAN, 32982)
+PR_EMS_AB_MONITOR_SERVERS = PROP_TAG(PT_BOOLEAN, 32983)
+PR_EMS_AB_MONITOR_SERVICES = PROP_TAG(PT_BOOLEAN, 32984)
+PR_EMS_AB_MONITORED_CONFIGURATIONS = PROP_TAG(PT_MV_TSTRING, 32985)
+PR_EMS_AB_MONITORED_CONFIGURATIONS_A = PROP_TAG(PT_MV_STRING8, 32985)
+PR_EMS_AB_MONITORED_CONFIGURATIONS_W = PROP_TAG(PT_MV_UNICODE, 32985)
+PR_EMS_AB_MONITORED_CONFIGURATIONS_O = PROP_TAG(PT_OBJECT, 32985)
+PR_EMS_AB_MONITORED_CONFIGURATIONS_T = PROP_TAG(PT_MV_TSTRING, 32985)
+PR_EMS_AB_MONITORED_SERVERS = PROP_TAG(PT_MV_TSTRING, 32986)
+PR_EMS_AB_MONITORED_SERVERS_A = PROP_TAG(PT_MV_STRING8, 32986)
+PR_EMS_AB_MONITORED_SERVERS_W = PROP_TAG(PT_MV_UNICODE, 32986)
+PR_EMS_AB_MONITORED_SERVERS_O = PROP_TAG(PT_OBJECT, 32986)
+PR_EMS_AB_MONITORED_SERVERS_T = PROP_TAG(PT_MV_TSTRING, 32986)
+PR_EMS_AB_MONITORED_SERVICES = PROP_TAG(PT_MV_TSTRING, 32987)
+PR_EMS_AB_MONITORED_SERVICES_A = PROP_TAG(PT_MV_STRING8, 32987)
+PR_EMS_AB_MONITORED_SERVICES_W = PROP_TAG(PT_MV_UNICODE, 32987)
+PR_EMS_AB_MONITORING_ALERT_DELAY = PROP_TAG(PT_LONG, 32988)
+PR_EMS_AB_MONITORING_ALERT_UNITS = PROP_TAG(PT_LONG, 32989)
+PR_EMS_AB_MONITORING_AVAILABILITY_STYLE = PROP_TAG(PT_LONG, 32990)
+PR_EMS_AB_MONITORING_AVAILABILITY_WINDOW = PROP_TAG(PT_BINARY, 32991)
+PR_EMS_AB_MONITORING_CACHED_VIA_MAIL = PROP_TAG(PT_MV_TSTRING, 32992)
+PR_EMS_AB_MONITORING_CACHED_VIA_MAIL_A = PROP_TAG(PT_MV_STRING8, 32992)
+PR_EMS_AB_MONITORING_CACHED_VIA_MAIL_W = PROP_TAG(PT_MV_UNICODE, 32992)
+PR_EMS_AB_MONITORING_CACHED_VIA_MAIL_O = PROP_TAG(PT_OBJECT, 32992)
+PR_EMS_AB_MONITORING_CACHED_VIA_MAIL_T = PROP_TAG(PT_MV_TSTRING, 32992)
+PR_EMS_AB_MONITORING_CACHED_VIA_RPC = PROP_TAG(PT_MV_TSTRING, 32993)
+PR_EMS_AB_MONITORING_CACHED_VIA_RPC_A = PROP_TAG(PT_MV_STRING8, 32993)
+PR_EMS_AB_MONITORING_CACHED_VIA_RPC_W = PROP_TAG(PT_MV_UNICODE, 32993)
+PR_EMS_AB_MONITORING_CACHED_VIA_RPC_O = PROP_TAG(PT_OBJECT, 32993)
+PR_EMS_AB_MONITORING_CACHED_VIA_RPC_T = PROP_TAG(PT_MV_TSTRING, 32993)
+PR_EMS_AB_MONITORING_ESCALATION_PROCEDURE = PROP_TAG(PT_MV_BINARY, 32994)
+PR_EMS_AB_MONITORING_HOTSITE_POLL_INTERVAL = PROP_TAG(PT_LONG, 32995)
+PR_EMS_AB_MONITORING_HOTSITE_POLL_UNITS = PROP_TAG(PT_LONG, 32996)
+PR_EMS_AB_MONITORING_MAIL_UPDATE_INTERVAL = PROP_TAG(PT_LONG, 32997)
+PR_EMS_AB_MONITORING_MAIL_UPDATE_UNITS = PROP_TAG(PT_LONG, 32998)
+PR_EMS_AB_MONITORING_NORMAL_POLL_INTERVAL = PROP_TAG(PT_LONG, 32999)
+PR_EMS_AB_MONITORING_NORMAL_POLL_UNITS = PROP_TAG(PT_LONG, 33000)
+PR_EMS_AB_MONITORING_RECIPIENTS = PROP_TAG(PT_MV_TSTRING, 33001)
+PR_EMS_AB_MONITORING_RECIPIENTS_A = PROP_TAG(PT_MV_STRING8, 33001)
+PR_EMS_AB_MONITORING_RECIPIENTS_W = PROP_TAG(PT_MV_UNICODE, 33001)
+PR_EMS_AB_MONITORING_RECIPIENTS_O = PROP_TAG(PT_OBJECT, 33001)
+PR_EMS_AB_MONITORING_RECIPIENTS_T = PROP_TAG(PT_MV_TSTRING, 33001)
+PR_EMS_AB_MONITORING_RECIPIENTS_NDR = PROP_TAG(PT_MV_TSTRING, 33002)
+PR_EMS_AB_MONITORING_RECIPIENTS_NDR_A = PROP_TAG(PT_MV_STRING8, 33002)
+PR_EMS_AB_MONITORING_RECIPIENTS_NDR_W = PROP_TAG(PT_MV_UNICODE, 33002)
+PR_EMS_AB_MONITORING_RECIPIENTS_NDR_O = PROP_TAG(PT_OBJECT, 33002)
+PR_EMS_AB_MONITORING_RECIPIENTS_NDR_T = PROP_TAG(PT_MV_TSTRING, 33002)
+PR_EMS_AB_MONITORING_RPC_UPDATE_INTERVAL = PROP_TAG(PT_LONG, 33003)
+PR_EMS_AB_MONITORING_RPC_UPDATE_UNITS = PROP_TAG(PT_LONG, 33004)
+PR_EMS_AB_MONITORING_WARNING_DELAY = PROP_TAG(PT_LONG, 33005)
+PR_EMS_AB_MONITORING_WARNING_UNITS = PROP_TAG(PT_LONG, 33006)
+PR_EMS_AB_MTA_LOCAL_CRED = PROP_TAG(PT_TSTRING, 33007)
+PR_EMS_AB_MTA_LOCAL_CRED_A = PROP_TAG(PT_STRING8, 33007)
+PR_EMS_AB_MTA_LOCAL_CRED_W = PROP_TAG(PT_UNICODE, 33007)
+PR_EMS_AB_MTA_LOCAL_DESIG = PROP_TAG(PT_TSTRING, 33008)
+PR_EMS_AB_MTA_LOCAL_DESIG_A = PROP_TAG(PT_STRING8, 33008)
+PR_EMS_AB_MTA_LOCAL_DESIG_W = PROP_TAG(PT_UNICODE, 33008)
+PR_EMS_AB_N_ADDRESS = PROP_TAG(PT_BINARY, 33009)
+PR_EMS_AB_N_ADDRESS_TYPE = PROP_TAG(PT_LONG, 33010)
+PR_EMS_AB_NETWORK_ADDRESS = PROP_TAG(PT_MV_TSTRING, 33136)
+PR_EMS_AB_NETWORK_ADDRESS_A = PROP_TAG(PT_MV_STRING8, 33136)
+PR_EMS_AB_NETWORK_ADDRESS_W = PROP_TAG(PT_MV_UNICODE, 33136)
+PR_EMS_AB_NNTP_CHARACTER_SET = PROP_TAG(PT_TSTRING, 33149)
+PR_EMS_AB_NNTP_CHARACTER_SET_A = PROP_TAG(PT_STRING8, 33149)
+PR_EMS_AB_NNTP_CHARACTER_SET_W = PROP_TAG(PT_UNICODE, 33149)
+PR_EMS_AB_NNTP_CONTENT_FORMAT = PROP_TAG(PT_TSTRING, 33142)
+PR_EMS_AB_NNTP_CONTENT_FORMAT_A = PROP_TAG(PT_STRING8, 33142)
+PR_EMS_AB_NNTP_CONTENT_FORMAT_W = PROP_TAG(PT_UNICODE, 33142)
+PR_EMS_AB_NT_MACHINE_NAME = PROP_TAG(PT_TSTRING, 33011)
+PR_EMS_AB_NT_MACHINE_NAME_A = PROP_TAG(PT_STRING8, 33011)
+PR_EMS_AB_NT_MACHINE_NAME_W = PROP_TAG(PT_UNICODE, 33011)
+PR_EMS_AB_NT_SECURITY_DESCRIPTOR = PROP_TAG(PT_BINARY, 32787)
+PR_EMS_AB_NUM_OF_OPEN_RETRIES = PROP_TAG(PT_LONG, 33012)
+PR_EMS_AB_NUM_OF_TRANSFER_RETRIES = PROP_TAG(PT_LONG, 33013)
+PR_EMS_AB_OBJ_DIST_NAME = PROP_TAG(PT_TSTRING, 32828)
+PR_EMS_AB_OBJ_DIST_NAME_A = PROP_TAG(PT_STRING8, 32828)
+PR_EMS_AB_OBJ_DIST_NAME_W = PROP_TAG(PT_UNICODE, 32828)
+PR_EMS_AB_OBJ_DIST_NAME_O = PROP_TAG(PT_OBJECT, 32828)
+PR_EMS_AB_OBJ_DIST_NAME_T = PROP_TAG(PT_TSTRING, 32828)
+PR_EMS_AB_OBJECT_CLASS_CATEGORY = PROP_TAG(PT_LONG, 33014)
+PR_EMS_AB_OBJECT_VERSION = PROP_TAG(PT_LONG, 33015)
+PR_EMS_AB_OFF_LINE_AB_CONTAINERS = PROP_TAG(PT_MV_TSTRING, 33016)
+PR_EMS_AB_OFF_LINE_AB_CONTAINERS_A = PROP_TAG(PT_MV_STRING8, 33016)
+PR_EMS_AB_OFF_LINE_AB_CONTAINERS_W = PROP_TAG(PT_MV_UNICODE, 33016)
+PR_EMS_AB_OFF_LINE_AB_CONTAINERS_O = PROP_TAG(PT_OBJECT, 33016)
+PR_EMS_AB_OFF_LINE_AB_CONTAINERS_T = PROP_TAG(PT_MV_TSTRING, 33016)
+PR_EMS_AB_OFF_LINE_AB_SCHEDULE = PROP_TAG(PT_BINARY, 33017)
+PR_EMS_AB_OFF_LINE_AB_SERVER = PROP_TAG(PT_TSTRING, 33018)
+PR_EMS_AB_OFF_LINE_AB_SERVER_A = PROP_TAG(PT_STRING8, 33018)
+PR_EMS_AB_OFF_LINE_AB_SERVER_W = PROP_TAG(PT_UNICODE, 33018)
+PR_EMS_AB_OFF_LINE_AB_SERVER_O = PROP_TAG(PT_OBJECT, 33018)
+PR_EMS_AB_OFF_LINE_AB_SERVER_T = PROP_TAG(PT_TSTRING, 33018)
+PR_EMS_AB_OFF_LINE_AB_STYLE = PROP_TAG(PT_LONG, 33019)
+PR_EMS_AB_OID_TYPE = PROP_TAG(PT_LONG, 33020)
+PR_EMS_AB_OM_OBJECT_CLASS = PROP_TAG(PT_BINARY, 33021)
+PR_EMS_AB_OM_SYNTAX = PROP_TAG(PT_LONG, 33022)
+PR_EMS_AB_OOF_REPLY_TO_ORIGINATOR = PROP_TAG(PT_BOOLEAN, 33023)
+PR_EMS_AB_OPEN_RETRY_INTERVAL = PROP_TAG(PT_LONG, 33024)
+PR_EMS_AB_ORGANIZATION_NAME = PROP_TAG(PT_MV_TSTRING, 33025)
+PR_EMS_AB_ORGANIZATION_NAME_A = PROP_TAG(PT_MV_STRING8, 33025)
+PR_EMS_AB_ORGANIZATION_NAME_W = PROP_TAG(PT_MV_UNICODE, 33025)
+PR_EMS_AB_ORGANIZATIONAL_UNIT_NAME = PROP_TAG(PT_MV_TSTRING, 33026)
+PR_EMS_AB_ORGANIZATIONAL_UNIT_NAME_A = PROP_TAG(PT_MV_STRING8, 33026)
+PR_EMS_AB_ORGANIZATIONAL_UNIT_NAME_W = PROP_TAG(PT_MV_UNICODE, 33026)
+PR_EMS_AB_ORIGINAL_DISPLAY_TABLE = PROP_TAG(PT_BINARY, 33027)
+PR_EMS_AB_ORIGINAL_DISPLAY_TABLE_MSDOS = PROP_TAG(PT_BINARY, 33028)
+PR_EMS_AB_OUTBOUND_SITES = PROP_TAG(PT_MV_TSTRING, 33029)
+PR_EMS_AB_OUTBOUND_SITES_A = PROP_TAG(PT_MV_STRING8, 33029)
+PR_EMS_AB_OUTBOUND_SITES_W = PROP_TAG(PT_MV_UNICODE, 33029)
+PR_EMS_AB_OUTBOUND_SITES_O = PROP_TAG(PT_OBJECT, 33029)
+PR_EMS_AB_OUTBOUND_SITES_T = PROP_TAG(PT_MV_TSTRING, 33029)
+PR_EMS_AB_OWNER = PROP_TAG(PT_TSTRING, 32780)
+PR_EMS_AB_OWNER_A = PROP_TAG(PT_STRING8, 32780)
+PR_EMS_AB_OWNER_W = PROP_TAG(PT_UNICODE, 32780)
+PR_EMS_AB_OWNER_O = PROP_TAG(PT_OBJECT, 32780)
+PR_EMS_AB_OWNER_T = PROP_TAG(PT_TSTRING, 32780)
+PR_EMS_AB_OWNER_BL = PROP_TAG(PT_TSTRING, 32804)
+PR_EMS_AB_OWNER_BL_A = PROP_TAG(PT_STRING8, 32804)
+PR_EMS_AB_OWNER_BL_W = PROP_TAG(PT_UNICODE, 32804)
+PR_EMS_AB_OWNER_BL_O = PROP_TAG(PT_OBJECT, 32804)
+PR_EMS_AB_OWNER_BL_T = PROP_TAG(PT_TSTRING, 32804)
+PR_EMS_AB_P_SELECTOR = PROP_TAG(PT_BINARY, 33030)
+PR_EMS_AB_P_SELECTOR_INBOUND = PROP_TAG(PT_BINARY, 33031)
+PR_EMS_AB_PER_MSG_DIALOG_DISPLAY_TABLE = PROP_TAG(PT_BINARY, 33032)
+PR_EMS_AB_PER_RECIP_DIALOG_DISPLAY_TABLE = PROP_TAG(PT_BINARY, 33033)
+PR_EMS_AB_PERIOD_REP_SYNC_TIMES = PROP_TAG(PT_BINARY, 33034)
+PR_EMS_AB_PERIOD_REPL_STAGGER = PROP_TAG(PT_LONG, 33035)
+PR_EMS_AB_PF_CONTACTS = PROP_TAG(PT_MV_TSTRING, 32824)
+PR_EMS_AB_PF_CONTACTS_A = PROP_TAG(PT_MV_STRING8, 32824)
+PR_EMS_AB_PF_CONTACTS_W = PROP_TAG(PT_MV_UNICODE, 32824)
+PR_EMS_AB_PF_CONTACTS_O = PROP_TAG(PT_OBJECT, 32824)
+PR_EMS_AB_PF_CONTACTS_T = PROP_TAG(PT_MV_TSTRING, 32824)
+PR_EMS_AB_POP_CHARACTER_SET = PROP_TAG(PT_TSTRING, 33145)
+PR_EMS_AB_POP_CHARACTER_SET_A = PROP_TAG(PT_STRING8, 33145)
+PR_EMS_AB_POP_CHARACTER_SET_W = PROP_TAG(PT_UNICODE, 33145)
+PR_EMS_AB_POP_CONTENT_FORMAT = PROP_TAG(PT_TSTRING, 33143)
+PR_EMS_AB_POP_CONTENT_FORMAT_A = PROP_TAG(PT_STRING8, 33143)
+PR_EMS_AB_POP_CONTENT_FORMAT_W = PROP_TAG(PT_UNICODE, 33143)
+PR_EMS_AB_POSTAL_ADDRESS = PROP_TAG(PT_MV_BINARY, 33036)
+PR_EMS_AB_PREFERRED_DELIVERY_METHOD = PROP_TAG(PT_MV_LONG, 33037)
+PR_EMS_AB_PRMD = PROP_TAG(PT_TSTRING, 33038)
+PR_EMS_AB_PRMD_A = PROP_TAG(PT_STRING8, 33038)
+PR_EMS_AB_PRMD_W = PROP_TAG(PT_UNICODE, 33038)
+PR_EMS_AB_PROXY_ADDRESSES = PROP_TAG(PT_MV_TSTRING, 32783)
+PR_EMS_AB_PROXY_ADDRESSES_A = PROP_TAG(PT_MV_STRING8, 32783)
+PR_EMS_AB_PROXY_ADDRESSES_W = PROP_TAG(PT_MV_UNICODE, 32783)
+PR_EMS_AB_PROXY_GENERATOR_DLL = PROP_TAG(PT_TSTRING, 33039)
+PR_EMS_AB_PROXY_GENERATOR_DLL_A = PROP_TAG(PT_STRING8, 33039)
+PR_EMS_AB_PROXY_GENERATOR_DLL_W = PROP_TAG(PT_UNICODE, 33039)
+PR_EMS_AB_PUBLIC_DELEGATES = PROP_TAG(PT_OBJECT, 32789)
+PR_EMS_AB_PUBLIC_DELEGATES_A = PROP_TAG(PT_MV_STRING8, 32789)
+PR_EMS_AB_PUBLIC_DELEGATES_W = PROP_TAG(PT_MV_UNICODE, 32789)
+PR_EMS_AB_PUBLIC_DELEGATES_O = PROP_TAG(PT_OBJECT, 32789)
+PR_EMS_AB_PUBLIC_DELEGATES_T = PROP_TAG(PT_MV_TSTRING, 32789)
+PR_EMS_AB_PUBLIC_DELEGATES_BL = PROP_TAG(PT_MV_TSTRING, 33040)
+PR_EMS_AB_PUBLIC_DELEGATES_BL_A = PROP_TAG(PT_MV_STRING8, 33040)
+PR_EMS_AB_PUBLIC_DELEGATES_BL_W = PROP_TAG(PT_MV_UNICODE, 33040)
+PR_EMS_AB_PUBLIC_DELEGATES_BL_O = PROP_TAG(PT_OBJECT, 33040)
+PR_EMS_AB_PUBLIC_DELEGATES_BL_T = PROP_TAG(PT_MV_TSTRING, 33040)
+PR_EMS_AB_QUOTA_NOTIFICATION_SCHEDULE = PROP_TAG(PT_BINARY, 33041)
+PR_EMS_AB_QUOTA_NOTIFICATION_STYLE = PROP_TAG(PT_LONG, 33042)
+PR_EMS_AB_RANGE_LOWER = PROP_TAG(PT_LONG, 33043)
+PR_EMS_AB_RANGE_UPPER = PROP_TAG(PT_LONG, 33044)
+PR_EMS_AB_RAS_CALLBACK_NUMBER = PROP_TAG(PT_TSTRING, 33045)
+PR_EMS_AB_RAS_CALLBACK_NUMBER_A = PROP_TAG(PT_STRING8, 33045)
+PR_EMS_AB_RAS_CALLBACK_NUMBER_W = PROP_TAG(PT_UNICODE, 33045)
+PR_EMS_AB_RAS_PHONE_NUMBER = PROP_TAG(PT_TSTRING, 33046)
+PR_EMS_AB_RAS_PHONE_NUMBER_A = PROP_TAG(PT_STRING8, 33046)
+PR_EMS_AB_RAS_PHONE_NUMBER_W = PROP_TAG(PT_UNICODE, 33046)
+PR_EMS_AB_RAS_PHONEBOOK_ENTRY_NAME = PROP_TAG(PT_TSTRING, 33047)
+PR_EMS_AB_RAS_PHONEBOOK_ENTRY_NAME_A = PROP_TAG(PT_STRING8, 33047)
+PR_EMS_AB_RAS_PHONEBOOK_ENTRY_NAME_W = PROP_TAG(PT_UNICODE, 33047)
+PR_EMS_AB_RAS_REMOTE_SRVR_NAME = PROP_TAG(PT_TSTRING, 33048)
+PR_EMS_AB_RAS_REMOTE_SRVR_NAME_A = PROP_TAG(PT_STRING8, 33048)
+PR_EMS_AB_RAS_REMOTE_SRVR_NAME_W = PROP_TAG(PT_UNICODE, 33048)
+PR_EMS_AB_REGISTERED_ADDRESS = PROP_TAG(PT_MV_BINARY, 33049)
+PR_EMS_AB_REMOTE_BRIDGE_HEAD = PROP_TAG(PT_TSTRING, 33050)
+PR_EMS_AB_REMOTE_BRIDGE_HEAD_A = PROP_TAG(PT_STRING8, 33050)
+PR_EMS_AB_REMOTE_BRIDGE_HEAD_W = PROP_TAG(PT_UNICODE, 33050)
+PR_EMS_AB_REMOTE_BRIDGE_HEAD_ADDRESS = PROP_TAG(PT_TSTRING, 33051)
+PR_EMS_AB_REMOTE_BRIDGE_HEAD_ADDRESS_A = PROP_TAG(PT_STRING8, 33051)
+PR_EMS_AB_REMOTE_BRIDGE_HEAD_ADDRESS_W = PROP_TAG(PT_UNICODE, 33051)
+PR_EMS_AB_REMOTE_OUT_BH_SERVER = PROP_TAG(PT_TSTRING, 33052)
+PR_EMS_AB_REMOTE_OUT_BH_SERVER_A = PROP_TAG(PT_STRING8, 33052)
+PR_EMS_AB_REMOTE_OUT_BH_SERVER_W = PROP_TAG(PT_UNICODE, 33052)
+PR_EMS_AB_REMOTE_OUT_BH_SERVER_O = PROP_TAG(PT_OBJECT, 33052)
+PR_EMS_AB_REMOTE_OUT_BH_SERVER_T = PROP_TAG(PT_TSTRING, 33052)
+PR_EMS_AB_REMOTE_SITE = PROP_TAG(PT_TSTRING, 33053)
+PR_EMS_AB_REMOTE_SITE_A = PROP_TAG(PT_STRING8, 33053)
+PR_EMS_AB_REMOTE_SITE_W = PROP_TAG(PT_UNICODE, 33053)
+PR_EMS_AB_REMOTE_SITE_O = PROP_TAG(PT_OBJECT, 33053)
+PR_EMS_AB_REMOTE_SITE_T = PROP_TAG(PT_TSTRING, 33053)
+PR_EMS_AB_REPLICATION_MAIL_MSG_SIZE = PROP_TAG(PT_LONG, 33128)
+PR_EMS_AB_REPLICATION_SENSITIVITY = PROP_TAG(PT_LONG, 33054)
+PR_EMS_AB_REPLICATION_STAGGER = PROP_TAG(PT_LONG, 33055)
+PR_EMS_AB_REPORT_TO_ORIGINATOR = PROP_TAG(PT_BOOLEAN, 33056)
+PR_EMS_AB_REPORT_TO_OWNER = PROP_TAG(PT_BOOLEAN, 33057)
+PR_EMS_AB_REPORTS = PROP_TAG(PT_OBJECT, 32782)
+PR_EMS_AB_REPORTS_A = PROP_TAG(PT_MV_STRING8, 32782)
+PR_EMS_AB_REPORTS_W = PROP_TAG(PT_MV_UNICODE, 32782)
+PR_EMS_AB_REPORTS_O = PROP_TAG(PT_OBJECT, 32782)
+PR_EMS_AB_REPORTS_T = PROP_TAG(PT_MV_TSTRING, 32782)
+PR_EMS_AB_REQ_SEQ = PROP_TAG(PT_LONG, 33058)
+PR_EMS_AB_RESPONSIBLE_LOCAL_DXA = PROP_TAG(PT_TSTRING, 33059)
+PR_EMS_AB_RESPONSIBLE_LOCAL_DXA_A = PROP_TAG(PT_STRING8, 33059)
+PR_EMS_AB_RESPONSIBLE_LOCAL_DXA_W = PROP_TAG(PT_UNICODE, 33059)
+PR_EMS_AB_RESPONSIBLE_LOCAL_DXA_O = PROP_TAG(PT_OBJECT, 33059)
+PR_EMS_AB_RESPONSIBLE_LOCAL_DXA_T = PROP_TAG(PT_TSTRING, 33059)
+PR_EMS_AB_RID_SERVER = PROP_TAG(PT_TSTRING, 33060)
+PR_EMS_AB_RID_SERVER_A = PROP_TAG(PT_STRING8, 33060)
+PR_EMS_AB_RID_SERVER_W = PROP_TAG(PT_UNICODE, 33060)
+PR_EMS_AB_RID_SERVER_O = PROP_TAG(PT_OBJECT, 33060)
+PR_EMS_AB_RID_SERVER_T = PROP_TAG(PT_TSTRING, 33060)
+PR_EMS_AB_ROLE_OCCUPANT = PROP_TAG(PT_MV_TSTRING, 33061)
+PR_EMS_AB_ROLE_OCCUPANT_A = PROP_TAG(PT_MV_STRING8, 33061)
+PR_EMS_AB_ROLE_OCCUPANT_W = PROP_TAG(PT_MV_UNICODE, 33061)
+PR_EMS_AB_ROLE_OCCUPANT_O = PROP_TAG(PT_OBJECT, 33061)
+PR_EMS_AB_ROLE_OCCUPANT_T = PROP_TAG(PT_MV_TSTRING, 33061)
+PR_EMS_AB_ROUTING_LIST = PROP_TAG(PT_MV_TSTRING, 33062)
+PR_EMS_AB_ROUTING_LIST_A = PROP_TAG(PT_MV_STRING8, 33062)
+PR_EMS_AB_ROUTING_LIST_W = PROP_TAG(PT_MV_UNICODE, 33062)
+PR_EMS_AB_RTS_CHECKPOINT_SIZE = PROP_TAG(PT_LONG, 33063)
+PR_EMS_AB_RTS_RECOVERY_TIMEOUT = PROP_TAG(PT_LONG, 33064)
+PR_EMS_AB_RTS_WINDOW_SIZE = PROP_TAG(PT_LONG, 33065)
+PR_EMS_AB_RUNS_ON = PROP_TAG(PT_MV_TSTRING, 33066)
+PR_EMS_AB_RUNS_ON_A = PROP_TAG(PT_MV_STRING8, 33066)
+PR_EMS_AB_RUNS_ON_W = PROP_TAG(PT_MV_UNICODE, 33066)
+PR_EMS_AB_RUNS_ON_O = PROP_TAG(PT_OBJECT, 33066)
+PR_EMS_AB_RUNS_ON_T = PROP_TAG(PT_MV_TSTRING, 33066)
+PR_EMS_AB_S_SELECTOR = PROP_TAG(PT_BINARY, 33067)
+PR_EMS_AB_S_SELECTOR_INBOUND = PROP_TAG(PT_BINARY, 33068)
+PR_EMS_AB_SCHEMA_FLAGS = PROP_TAG(PT_LONG, 33139)
+PR_EMS_AB_SCHEMA_VERSION = PROP_TAG(PT_MV_LONG, 33148)
+PR_EMS_AB_SEARCH_FLAGS = PROP_TAG(PT_LONG, 33069)
+PR_EMS_AB_SEARCH_GUIDE = PROP_TAG(PT_MV_BINARY, 33070)
+PR_EMS_AB_SECURITY_PROTOCOL = PROP_TAG(PT_MV_BINARY, 32823)
+PR_EMS_AB_SEE_ALSO = PROP_TAG(PT_MV_TSTRING, 33071)
+PR_EMS_AB_SEE_ALSO_A = PROP_TAG(PT_MV_STRING8, 33071)
+PR_EMS_AB_SEE_ALSO_W = PROP_TAG(PT_MV_UNICODE, 33071)
+PR_EMS_AB_SEE_ALSO_O = PROP_TAG(PT_OBJECT, 33071)
+PR_EMS_AB_SEE_ALSO_T = PROP_TAG(PT_MV_TSTRING, 33071)
+PR_EMS_AB_SERIAL_NUMBER = PROP_TAG(PT_MV_TSTRING, 33072)
+PR_EMS_AB_SERIAL_NUMBER_A = PROP_TAG(PT_MV_STRING8, 33072)
+PR_EMS_AB_SERIAL_NUMBER_W = PROP_TAG(PT_MV_UNICODE, 33072)
+PR_EMS_AB_SERVICE_ACTION_FIRST = PROP_TAG(PT_LONG, 33073)
+PR_EMS_AB_SERVICE_ACTION_OTHER = PROP_TAG(PT_LONG, 33074)
+PR_EMS_AB_SERVICE_ACTION_SECOND = PROP_TAG(PT_LONG, 33075)
+PR_EMS_AB_SERVICE_RESTART_DELAY = PROP_TAG(PT_LONG, 33076)
+PR_EMS_AB_SERVICE_RESTART_MESSAGE = PROP_TAG(PT_TSTRING, 33077)
+PR_EMS_AB_SERVICE_RESTART_MESSAGE_A = PROP_TAG(PT_STRING8, 33077)
+PR_EMS_AB_SERVICE_RESTART_MESSAGE_W = PROP_TAG(PT_UNICODE, 33077)
+PR_EMS_AB_SESSION_DISCONNECT_TIMER = PROP_TAG(PT_LONG, 33078)
+PR_EMS_AB_SITE_AFFINITY = PROP_TAG(PT_MV_TSTRING, 33079)
+PR_EMS_AB_SITE_AFFINITY_A = PROP_TAG(PT_MV_STRING8, 33079)
+PR_EMS_AB_SITE_AFFINITY_W = PROP_TAG(PT_MV_UNICODE, 33079)
+PR_EMS_AB_SITE_FOLDER_GUID = PROP_TAG(PT_BINARY, 33126)
+PR_EMS_AB_SITE_FOLDER_SERVER = PROP_TAG(PT_TSTRING, 33127)
+PR_EMS_AB_SITE_FOLDER_SERVER_A = PROP_TAG(PT_STRING8, 33127)
+PR_EMS_AB_SITE_FOLDER_SERVER_W = PROP_TAG(PT_UNICODE, 33127)
+PR_EMS_AB_SITE_FOLDER_SERVER_O = PROP_TAG(PT_OBJECT, 33127)
+PR_EMS_AB_SITE_FOLDER_SERVER_T = PROP_TAG(PT_TSTRING, 33127)
+PR_EMS_AB_SITE_PROXY_SPACE = PROP_TAG(PT_MV_TSTRING, 33080)
+PR_EMS_AB_SITE_PROXY_SPACE_A = PROP_TAG(PT_MV_STRING8, 33080)
+PR_EMS_AB_SITE_PROXY_SPACE_W = PROP_TAG(PT_MV_UNICODE, 33080)
+PR_EMS_AB_SPACE_LAST_COMPUTED = PROP_TAG(PT_SYSTIME, 33081)
+PR_EMS_AB_STREET_ADDRESS = PROP_TAG(PT_TSTRING, 33082)
+PR_EMS_AB_STREET_ADDRESS_A = PROP_TAG(PT_STRING8, 33082)
+PR_EMS_AB_STREET_ADDRESS_W = PROP_TAG(PT_UNICODE, 33082)
+PR_EMS_AB_SUB_REFS = PROP_TAG(PT_MV_TSTRING, 33083)
+PR_EMS_AB_SUB_REFS_A = PROP_TAG(PT_MV_STRING8, 33083)
+PR_EMS_AB_SUB_REFS_W = PROP_TAG(PT_MV_UNICODE, 33083)
+PR_EMS_AB_SUB_REFS_O = PROP_TAG(PT_OBJECT, 33083)
+PR_EMS_AB_SUB_REFS_T = PROP_TAG(PT_MV_TSTRING, 33083)
+PR_EMS_AB_SUB_SITE = PROP_TAG(PT_TSTRING, 33147)
+PR_EMS_AB_SUB_SITE_A = PROP_TAG(PT_STRING8, 33147)
+PR_EMS_AB_SUB_SITE_W = PROP_TAG(PT_UNICODE, 33147)
+PR_EMS_AB_SUBMISSION_CONT_LENGTH = PROP_TAG(PT_LONG, 33084)
+PR_EMS_AB_SUPPORTED_APPLICATION_CONTEXT = PROP_TAG(PT_MV_BINARY, 33085)
+PR_EMS_AB_SUPPORTING_STACK = PROP_TAG(PT_MV_TSTRING, 33086)
+PR_EMS_AB_SUPPORTING_STACK_A = PROP_TAG(PT_MV_STRING8, 33086)
+PR_EMS_AB_SUPPORTING_STACK_W = PROP_TAG(PT_MV_UNICODE, 33086)
+PR_EMS_AB_SUPPORTING_STACK_O = PROP_TAG(PT_OBJECT, 33086)
+PR_EMS_AB_SUPPORTING_STACK_T = PROP_TAG(PT_MV_TSTRING, 33086)
+PR_EMS_AB_SUPPORTING_STACK_BL = PROP_TAG(PT_MV_TSTRING, 33087)
+PR_EMS_AB_SUPPORTING_STACK_BL_A = PROP_TAG(PT_MV_STRING8, 33087)
+PR_EMS_AB_SUPPORTING_STACK_BL_W = PROP_TAG(PT_MV_UNICODE, 33087)
+PR_EMS_AB_SUPPORTING_STACK_BL_O = PROP_TAG(PT_OBJECT, 33087)
+PR_EMS_AB_SUPPORTING_STACK_BL_T = PROP_TAG(PT_MV_TSTRING, 33087)
+PR_EMS_AB_T_SELECTOR = PROP_TAG(PT_BINARY, 33088)
+PR_EMS_AB_T_SELECTOR_INBOUND = PROP_TAG(PT_BINARY, 33089)
+PR_EMS_AB_TARGET_ADDRESS = PROP_TAG(PT_TSTRING, 32785)
+PR_EMS_AB_TARGET_ADDRESS_A = PROP_TAG(PT_STRING8, 32785)
+PR_EMS_AB_TARGET_ADDRESS_W = PROP_TAG(PT_UNICODE, 32785)
+PR_EMS_AB_TARGET_MTAS = PROP_TAG(PT_MV_TSTRING, 33090)
+PR_EMS_AB_TARGET_MTAS_A = PROP_TAG(PT_MV_STRING8, 33090)
+PR_EMS_AB_TARGET_MTAS_W = PROP_TAG(PT_MV_UNICODE, 33090)
+PR_EMS_AB_TELEPHONE_NUMBER = PROP_TAG(PT_MV_TSTRING, 32786)
+PR_EMS_AB_TELEPHONE_NUMBER_A = PROP_TAG(PT_MV_STRING8, 32786)
+PR_EMS_AB_TELEPHONE_NUMBER_W = PROP_TAG(PT_MV_UNICODE, 32786)
+PR_EMS_AB_TELETEX_TERMINAL_IDENTIFIER = PROP_TAG(PT_MV_BINARY, 33091)
+PR_EMS_AB_TEMP_ASSOC_THRESHOLD = PROP_TAG(PT_LONG, 33092)
+PR_EMS_AB_TOMBSTONE_LIFETIME = PROP_TAG(PT_LONG, 33093)
+PR_EMS_AB_TRACKING_LOG_PATH_NAME = PROP_TAG(PT_TSTRING, 33094)
+PR_EMS_AB_TRACKING_LOG_PATH_NAME_A = PROP_TAG(PT_STRING8, 33094)
+PR_EMS_AB_TRACKING_LOG_PATH_NAME_W = PROP_TAG(PT_UNICODE, 33094)
+PR_EMS_AB_TRANS_RETRY_MINS = PROP_TAG(PT_LONG, 33095)
+PR_EMS_AB_TRANS_TIMEOUT_MINS = PROP_TAG(PT_LONG, 33096)
+PR_EMS_AB_TRANSFER_RETRY_INTERVAL = PROP_TAG(PT_LONG, 33097)
+PR_EMS_AB_TRANSFER_TIMEOUT_NON_URGENT = PROP_TAG(PT_LONG, 33098)
+PR_EMS_AB_TRANSFER_TIMEOUT_NORMAL = PROP_TAG(PT_LONG, 33099)
+PR_EMS_AB_TRANSFER_TIMEOUT_URGENT = PROP_TAG(PT_LONG, 33100)
+PR_EMS_AB_TRANSLATION_TABLE_USED = PROP_TAG(PT_LONG, 33101)
+PR_EMS_AB_TRANSPORT_EXPEDITED_DATA = PROP_TAG(PT_BOOLEAN, 33102)
+PR_EMS_AB_TRUST_LEVEL = PROP_TAG(PT_LONG, 33103)
+PR_EMS_AB_TURN_REQUEST_THRESHOLD = PROP_TAG(PT_LONG, 33104)
+PR_EMS_AB_TWO_WAY_ALTERNATE_FACILITY = PROP_TAG(PT_BOOLEAN, 33105)
+PR_EMS_AB_UNAUTH_ORIG_BL = PROP_TAG(PT_MV_TSTRING, 33106)
+PR_EMS_AB_UNAUTH_ORIG_BL_A = PROP_TAG(PT_MV_STRING8, 33106)
+PR_EMS_AB_UNAUTH_ORIG_BL_W = PROP_TAG(PT_MV_UNICODE, 33106)
+PR_EMS_AB_UNAUTH_ORIG_BL_O = PROP_TAG(PT_OBJECT, 33106)
+PR_EMS_AB_UNAUTH_ORIG_BL_T = PROP_TAG(PT_MV_TSTRING, 33106)
+PR_EMS_AB_USE_SERVER_VALUES = PROP_TAG(PT_BOOLEAN, 33150)
+PR_EMS_AB_USER_PASSWORD = PROP_TAG(PT_MV_BINARY, 33107)
+PR_EMS_AB_USN_CHANGED = PROP_TAG(PT_LONG, 32809)
+PR_EMS_AB_USN_CREATED = PROP_TAG(PT_LONG, 33108)
+PR_EMS_AB_USN_DSA_LAST_OBJ_REMOVED = PROP_TAG(PT_LONG, 33109)
+PR_EMS_AB_USN_INTERSITE = PROP_TAG(PT_LONG, 33146)
+PR_EMS_AB_USN_LAST_OBJ_REM = PROP_TAG(PT_LONG, 33110)
+PR_EMS_AB_USN_SOURCE = PROP_TAG(PT_LONG, 33111)
+PR_EMS_AB_WWW_HOME_PAGE = PROP_TAG(PT_TSTRING, 33141)
+PR_EMS_AB_WWW_HOME_PAGE_A = PROP_TAG(PT_STRING8, 33141)
+PR_EMS_AB_WWW_HOME_PAGE_W = PROP_TAG(PT_UNICODE, 33141)
+PR_EMS_AB_X121_ADDRESS = PROP_TAG(PT_MV_TSTRING, 33112)
+PR_EMS_AB_X121_ADDRESS_A = PROP_TAG(PT_MV_STRING8, 33112)
+PR_EMS_AB_X121_ADDRESS_W = PROP_TAG(PT_MV_UNICODE, 33112)
+PR_EMS_AB_X25_CALL_USER_DATA_INCOMING = PROP_TAG(PT_BINARY, 33113)
+PR_EMS_AB_X25_CALL_USER_DATA_OUTGOING = PROP_TAG(PT_BINARY, 33114)
+PR_EMS_AB_X25_FACILITIES_DATA_INCOMING = PROP_TAG(PT_BINARY, 33115)
+PR_EMS_AB_X25_FACILITIES_DATA_OUTGOING = PROP_TAG(PT_BINARY, 33116)
+PR_EMS_AB_X25_LEASED_LINE_PORT = PROP_TAG(PT_BINARY, 33117)
+PR_EMS_AB_X25_LEASED_OR_SWITCHED = PROP_TAG(PT_BOOLEAN, 33118)
+PR_EMS_AB_X25_REMOTE_MTA_PHONE = PROP_TAG(PT_TSTRING, 33119)
+PR_EMS_AB_X25_REMOTE_MTA_PHONE_A = PROP_TAG(PT_STRING8, 33119)
+PR_EMS_AB_X25_REMOTE_MTA_PHONE_W = PROP_TAG(PT_UNICODE, 33119)
+PR_EMS_AB_X400_ATTACHMENT_TYPE = PROP_TAG(PT_BINARY, 33120)
+PR_EMS_AB_X400_SELECTOR_SYNTAX = PROP_TAG(PT_LONG, 33121)
+PR_EMS_AB_X500_ACCESS_CONTROL_LIST = PROP_TAG(PT_BINARY, 33122)
+PR_EMS_AB_XMIT_TIMEOUT_NON_URGENT = PROP_TAG(PT_LONG, 33123)
+PR_EMS_AB_XMIT_TIMEOUT_NORMAL = PROP_TAG(PT_LONG, 33124)
+PR_EMS_AB_XMIT_TIMEOUT_URGENT = PROP_TAG(PT_LONG, 33125)
diff --git a/lib/win32comext/mapi/exchange.pyd b/lib/win32comext/mapi/exchange.pyd
new file mode 100644
index 0000000000000000000000000000000000000000..15272f147ef540f56f00f2513f85b422eaacb768
GIT binary patch
literal 88064
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%0A8Y5K=mshd%!c$!k1&m1-f6*|=B!}py=h}v#Z
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
W5~M{_X_c+crZe0BUjMgi;C}(0&%et6

literal 0
HcmV?d00001

diff --git a/lib/win32comext/mapi/mapi.pyd b/lib/win32comext/mapi/mapi.pyd
new file mode 100644
index 0000000000000000000000000000000000000000..e372d4bf9b7a146fbb3e02f18cf668464f6e1a93
GIT binary patch
literal 196608
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
YOL+Fq*_%)Ox9pWS=>Plgze5fDUk%P&T>t<8

literal 0
HcmV?d00001

diff --git a/lib/win32comext/mapi/mapitags.py b/lib/win32comext/mapi/mapitags.py
new file mode 100644
index 00000000..e6e9667e
--- /dev/null
+++ b/lib/win32comext/mapi/mapitags.py
@@ -0,0 +1,1025 @@
+MV_FLAG = 4096  # Multi-value flag
+
+PT_UNSPECIFIED = 0
+PT_NULL = 1
+PT_I2 = 2
+PT_LONG = 3
+PT_R4 = 4
+PT_DOUBLE = 5
+PT_CURRENCY = 6
+PT_APPTIME = 7
+PT_ERROR = 10
+PT_BOOLEAN = 11
+PT_OBJECT = 13
+PT_I8 = 20
+PT_STRING8 = 30
+PT_UNICODE = 31
+PT_SYSTIME = 64
+PT_CLSID = 72
+PT_BINARY = 258
+
+PT_SHORT = PT_I2
+PT_I4 = PT_LONG
+PT_FLOAT = PT_R4
+PT_R8 = PT_DOUBLE
+PT_LONGLONG = PT_I8
+
+PT_MV_I2 = MV_FLAG | PT_I2
+PT_MV_LONG = MV_FLAG | PT_LONG
+PT_MV_R4 = MV_FLAG | PT_R4
+PT_MV_DOUBLE = MV_FLAG | PT_DOUBLE
+PT_MV_CURRENCY = MV_FLAG | PT_CURRENCY
+PT_MV_APPTIME = MV_FLAG | PT_APPTIME
+PT_MV_SYSTIME = MV_FLAG | PT_SYSTIME
+PT_MV_STRING8 = MV_FLAG | PT_STRING8
+PT_MV_BINARY = MV_FLAG | PT_BINARY
+PT_MV_UNICODE = MV_FLAG | PT_UNICODE
+PT_MV_CLSID = MV_FLAG | PT_CLSID
+PT_MV_I8 = MV_FLAG | PT_I8
+
+PT_MV_SHORT = PT_MV_I2
+PT_MV_I4 = PT_MV_LONG
+PT_MV_FLOAT = PT_MV_R4
+PT_MV_R8 = PT_MV_DOUBLE
+PT_MV_LONGLONG = PT_MV_I8
+
+PT_TSTRING = PT_UNICODE  # ???
+PT_MV_TSTRING = MV_FLAG | PT_UNICODE
+
+
+PROP_TYPE_MASK = 65535  # Mask for Property type
+
+
+def PROP_TYPE(ulPropTag):
+    return ulPropTag & PROP_TYPE_MASK
+
+
+def PROP_ID(ulPropTag):
+    return ulPropTag >> 16
+
+
+def PROP_TAG(ulPropType, ulPropID):
+    return (ulPropID << 16) | (ulPropType)
+
+
+PROP_ID_NULL = 0
+PROP_ID_INVALID = 65535
+PR_NULL = PROP_TAG(PT_NULL, PROP_ID_NULL)
+
+
+PR_ACKNOWLEDGEMENT_MODE = PROP_TAG(PT_LONG, 1)
+PR_ACKNOWLEDGEMENT_MODE = PROP_TAG(PT_LONG, 1)
+PR_ALTERNATE_RECIPIENT_ALLOWED = PROP_TAG(PT_BOOLEAN, 2)
+PR_AUTHORIZING_USERS = PROP_TAG(PT_BINARY, 3)
+PR_AUTO_FORWARD_COMMENT = PROP_TAG(PT_TSTRING, 4)
+PR_AUTO_FORWARD_COMMENT_W = PROP_TAG(PT_UNICODE, 4)
+PR_AUTO_FORWARD_COMMENT_W = PROP_TAG(PT_UNICODE, 4)
+PR_AUTO_FORWARD_COMMENT_A = PROP_TAG(PT_STRING8, 4)
+PR_AUTO_FORWARDED = PROP_TAG(PT_BOOLEAN, 5)
+PR_CONTENT_CONFIDENTIALITY_ALGORITHM_ID = PROP_TAG(PT_BINARY, 6)
+PR_CONTENT_CORRELATOR = PROP_TAG(PT_BINARY, 7)
+PR_CONTENT_IDENTIFIER = PROP_TAG(PT_TSTRING, 8)
+PR_CONTENT_IDENTIFIER_W = PROP_TAG(PT_UNICODE, 8)
+PR_CONTENT_IDENTIFIER_A = PROP_TAG(PT_STRING8, 8)
+PR_CONTENT_LENGTH = PROP_TAG(PT_LONG, 9)
+PR_CONTENT_RETURN_REQUESTED = PROP_TAG(PT_BOOLEAN, 10)
+PR_CONVERSATION_KEY = PROP_TAG(PT_BINARY, 11)
+PR_CONVERSION_EITS = PROP_TAG(PT_BINARY, 12)
+PR_CONVERSION_WITH_LOSS_PROHIBITED = PROP_TAG(PT_BOOLEAN, 13)
+PR_CONVERTED_EITS = PROP_TAG(PT_BINARY, 14)
+PR_DEFERRED_DELIVERY_TIME = PROP_TAG(PT_SYSTIME, 15)
+PR_DELIVER_TIME = PROP_TAG(PT_SYSTIME, 16)
+PR_DISCARD_REASON = PROP_TAG(PT_LONG, 17)
+PR_DISCLOSURE_OF_RECIPIENTS = PROP_TAG(PT_BOOLEAN, 18)
+PR_DL_EXPANSION_HISTORY = PROP_TAG(PT_BINARY, 19)
+PR_DL_EXPANSION_PROHIBITED = PROP_TAG(PT_BOOLEAN, 20)
+PR_EXPIRY_TIME = PROP_TAG(PT_SYSTIME, 21)
+PR_IMPLICIT_CONVERSION_PROHIBITED = PROP_TAG(PT_BOOLEAN, 22)
+PR_IMPORTANCE = PROP_TAG(PT_LONG, 23)
+PR_IPM_ID = PROP_TAG(PT_BINARY, 24)
+PR_LATEST_DELIVERY_TIME = PROP_TAG(PT_SYSTIME, 25)
+PR_MESSAGE_CLASS = PROP_TAG(PT_TSTRING, 26)
+PR_MESSAGE_CLASS_W = PROP_TAG(PT_UNICODE, 26)
+PR_MESSAGE_CLASS_A = PROP_TAG(PT_STRING8, 26)
+PR_MESSAGE_DELIVERY_ID = PROP_TAG(PT_BINARY, 27)
+PR_MESSAGE_SECURITY_LABEL = PROP_TAG(PT_BINARY, 30)
+PR_OBSOLETED_IPMS = PROP_TAG(PT_BINARY, 31)
+PR_ORIGINALLY_INTENDED_RECIPIENT_NAME = PROP_TAG(PT_BINARY, 32)
+PR_ORIGINAL_EITS = PROP_TAG(PT_BINARY, 33)
+PR_ORIGINATOR_CERTIFICATE = PROP_TAG(PT_BINARY, 34)
+PR_ORIGINATOR_DELIVERY_REPORT_REQUESTED = PROP_TAG(PT_BOOLEAN, 35)
+PR_ORIGINATOR_RETURN_ADDRESS = PROP_TAG(PT_BINARY, 36)
+PR_PARENT_KEY = PROP_TAG(PT_BINARY, 37)
+PR_PRIORITY = PROP_TAG(PT_LONG, 38)
+PR_ORIGIN_CHECK = PROP_TAG(PT_BINARY, 39)
+PR_PROOF_OF_SUBMISSION_REQUESTED = PROP_TAG(PT_BOOLEAN, 40)
+PR_READ_RECEIPT_REQUESTED = PROP_TAG(PT_BOOLEAN, 41)
+PR_RECEIPT_TIME = PROP_TAG(PT_SYSTIME, 42)
+PR_RECIPIENT_REASSIGNMENT_PROHIBITED = PROP_TAG(PT_BOOLEAN, 43)
+PR_REDIRECTION_HISTORY = PROP_TAG(PT_BINARY, 44)
+PR_RELATED_IPMS = PROP_TAG(PT_BINARY, 45)
+PR_ORIGINAL_SENSITIVITY = PROP_TAG(PT_LONG, 46)
+PR_LANGUAGES = PROP_TAG(PT_TSTRING, 47)
+PR_LANGUAGES_W = PROP_TAG(PT_UNICODE, 47)
+PR_LANGUAGES_A = PROP_TAG(PT_STRING8, 47)
+PR_REPLY_TIME = PROP_TAG(PT_SYSTIME, 48)
+PR_REPORT_TAG = PROP_TAG(PT_BINARY, 49)
+PR_REPORT_TIME = PROP_TAG(PT_SYSTIME, 50)
+PR_RETURNED_IPM = PROP_TAG(PT_BOOLEAN, 51)
+PR_SECURITY = PROP_TAG(PT_LONG, 52)
+PR_INCOMPLETE_COPY = PROP_TAG(PT_BOOLEAN, 53)
+PR_SENSITIVITY = PROP_TAG(PT_LONG, 54)
+PR_SUBJECT = PROP_TAG(PT_TSTRING, 55)
+PR_SUBJECT_W = PROP_TAG(PT_UNICODE, 55)
+PR_SUBJECT_A = PROP_TAG(PT_STRING8, 55)
+PR_SUBJECT_IPM = PROP_TAG(PT_BINARY, 56)
+PR_CLIENT_SUBMIT_TIME = PROP_TAG(PT_SYSTIME, 57)
+PR_REPORT_NAME = PROP_TAG(PT_TSTRING, 58)
+PR_REPORT_NAME_W = PROP_TAG(PT_UNICODE, 58)
+PR_REPORT_NAME_A = PROP_TAG(PT_STRING8, 58)
+PR_SENT_REPRESENTING_SEARCH_KEY = PROP_TAG(PT_BINARY, 59)
+PR_X400_CONTENT_TYPE = PROP_TAG(PT_BINARY, 60)
+PR_SUBJECT_PREFIX = PROP_TAG(PT_TSTRING, 61)
+PR_SUBJECT_PREFIX_W = PROP_TAG(PT_UNICODE, 61)
+PR_SUBJECT_PREFIX_A = PROP_TAG(PT_STRING8, 61)
+PR_NON_RECEIPT_REASON = PROP_TAG(PT_LONG, 62)
+PR_RECEIVED_BY_ENTRYID = PROP_TAG(PT_BINARY, 63)
+PR_RECEIVED_BY_NAME = PROP_TAG(PT_TSTRING, 64)
+PR_RECEIVED_BY_NAME_W = PROP_TAG(PT_UNICODE, 64)
+PR_RECEIVED_BY_NAME_A = PROP_TAG(PT_STRING8, 64)
+PR_SENT_REPRESENTING_ENTRYID = PROP_TAG(PT_BINARY, 65)
+PR_SENT_REPRESENTING_NAME = PROP_TAG(PT_TSTRING, 66)
+PR_SENT_REPRESENTING_NAME_W = PROP_TAG(PT_UNICODE, 66)
+PR_SENT_REPRESENTING_NAME_A = PROP_TAG(PT_STRING8, 66)
+PR_RCVD_REPRESENTING_ENTRYID = PROP_TAG(PT_BINARY, 67)
+PR_RCVD_REPRESENTING_NAME = PROP_TAG(PT_TSTRING, 68)
+PR_RCVD_REPRESENTING_NAME_W = PROP_TAG(PT_UNICODE, 68)
+PR_RCVD_REPRESENTING_NAME_A = PROP_TAG(PT_STRING8, 68)
+PR_REPORT_ENTRYID = PROP_TAG(PT_BINARY, 69)
+PR_READ_RECEIPT_ENTRYID = PROP_TAG(PT_BINARY, 70)
+PR_MESSAGE_SUBMISSION_ID = PROP_TAG(PT_BINARY, 71)
+PR_PROVIDER_SUBMIT_TIME = PROP_TAG(PT_SYSTIME, 72)
+PR_ORIGINAL_SUBJECT = PROP_TAG(PT_TSTRING, 73)
+PR_ORIGINAL_SUBJECT_W = PROP_TAG(PT_UNICODE, 73)
+PR_ORIGINAL_SUBJECT_A = PROP_TAG(PT_STRING8, 73)
+PR_DISC_VAL = PROP_TAG(PT_BOOLEAN, 74)
+PR_ORIG_MESSAGE_CLASS = PROP_TAG(PT_TSTRING, 75)
+PR_ORIG_MESSAGE_CLASS_W = PROP_TAG(PT_UNICODE, 75)
+PR_ORIG_MESSAGE_CLASS_A = PROP_TAG(PT_STRING8, 75)
+PR_ORIGINAL_AUTHOR_ENTRYID = PROP_TAG(PT_BINARY, 76)
+PR_ORIGINAL_AUTHOR_NAME = PROP_TAG(PT_TSTRING, 77)
+PR_ORIGINAL_AUTHOR_NAME_W = PROP_TAG(PT_UNICODE, 77)
+PR_ORIGINAL_AUTHOR_NAME_A = PROP_TAG(PT_STRING8, 77)
+PR_ORIGINAL_SUBMIT_TIME = PROP_TAG(PT_SYSTIME, 78)
+PR_REPLY_RECIPIENT_ENTRIES = PROP_TAG(PT_BINARY, 79)
+PR_REPLY_RECIPIENT_NAMES = PROP_TAG(PT_TSTRING, 80)
+PR_REPLY_RECIPIENT_NAMES_W = PROP_TAG(PT_UNICODE, 80)
+PR_REPLY_RECIPIENT_NAMES_A = PROP_TAG(PT_STRING8, 80)
+PR_RECEIVED_BY_SEARCH_KEY = PROP_TAG(PT_BINARY, 81)
+PR_RCVD_REPRESENTING_SEARCH_KEY = PROP_TAG(PT_BINARY, 82)
+PR_READ_RECEIPT_SEARCH_KEY = PROP_TAG(PT_BINARY, 83)
+PR_REPORT_SEARCH_KEY = PROP_TAG(PT_BINARY, 84)
+PR_ORIGINAL_DELIVERY_TIME = PROP_TAG(PT_SYSTIME, 85)
+PR_ORIGINAL_AUTHOR_SEARCH_KEY = PROP_TAG(PT_BINARY, 86)
+PR_MESSAGE_TO_ME = PROP_TAG(PT_BOOLEAN, 87)
+PR_MESSAGE_CC_ME = PROP_TAG(PT_BOOLEAN, 88)
+PR_MESSAGE_RECIP_ME = PROP_TAG(PT_BOOLEAN, 89)
+PR_ORIGINAL_SENDER_NAME = PROP_TAG(PT_TSTRING, 90)
+PR_ORIGINAL_SENDER_NAME_W = PROP_TAG(PT_UNICODE, 90)
+PR_ORIGINAL_SENDER_NAME_A = PROP_TAG(PT_STRING8, 90)
+PR_ORIGINAL_SENDER_ENTRYID = PROP_TAG(PT_BINARY, 91)
+PR_ORIGINAL_SENDER_SEARCH_KEY = PROP_TAG(PT_BINARY, 92)
+PR_ORIGINAL_SENT_REPRESENTING_NAME = PROP_TAG(PT_TSTRING, 93)
+PR_ORIGINAL_SENT_REPRESENTING_NAME_W = PROP_TAG(PT_UNICODE, 93)
+PR_ORIGINAL_SENT_REPRESENTING_NAME_A = PROP_TAG(PT_STRING8, 93)
+PR_ORIGINAL_SENT_REPRESENTING_ENTRYID = PROP_TAG(PT_BINARY, 94)
+PR_ORIGINAL_SENT_REPRESENTING_SEARCH_KEY = PROP_TAG(PT_BINARY, 95)
+PR_START_DATE = PROP_TAG(PT_SYSTIME, 96)
+PR_END_DATE = PROP_TAG(PT_SYSTIME, 97)
+PR_OWNER_APPT_ID = PROP_TAG(PT_LONG, 98)
+PR_RESPONSE_REQUESTED = PROP_TAG(PT_BOOLEAN, 99)
+PR_SENT_REPRESENTING_ADDRTYPE = PROP_TAG(PT_TSTRING, 100)
+PR_SENT_REPRESENTING_ADDRTYPE_W = PROP_TAG(PT_UNICODE, 100)
+PR_SENT_REPRESENTING_ADDRTYPE_A = PROP_TAG(PT_STRING8, 100)
+PR_SENT_REPRESENTING_EMAIL_ADDRESS = PROP_TAG(PT_TSTRING, 101)
+PR_SENT_REPRESENTING_EMAIL_ADDRESS_W = PROP_TAG(PT_UNICODE, 101)
+PR_SENT_REPRESENTING_EMAIL_ADDRESS_A = PROP_TAG(PT_STRING8, 101)
+PR_ORIGINAL_SENDER_ADDRTYPE = PROP_TAG(PT_TSTRING, 102)
+PR_ORIGINAL_SENDER_ADDRTYPE_W = PROP_TAG(PT_UNICODE, 102)
+PR_ORIGINAL_SENDER_ADDRTYPE_A = PROP_TAG(PT_STRING8, 102)
+PR_ORIGINAL_SENDER_EMAIL_ADDRESS = PROP_TAG(PT_TSTRING, 103)
+PR_ORIGINAL_SENDER_EMAIL_ADDRESS_W = PROP_TAG(PT_UNICODE, 103)
+PR_ORIGINAL_SENDER_EMAIL_ADDRESS_A = PROP_TAG(PT_STRING8, 103)
+PR_ORIGINAL_SENT_REPRESENTING_ADDRTYPE = PROP_TAG(PT_TSTRING, 104)
+PR_ORIGINAL_SENT_REPRESENTING_ADDRTYPE_W = PROP_TAG(PT_UNICODE, 104)
+PR_ORIGINAL_SENT_REPRESENTING_ADDRTYPE_A = PROP_TAG(PT_STRING8, 104)
+PR_ORIGINAL_SENT_REPRESENTING_EMAIL_ADDRESS = PROP_TAG(PT_TSTRING, 105)
+PR_ORIGINAL_SENT_REPRESENTING_EMAIL_ADDRESS_W = PROP_TAG(PT_UNICODE, 105)
+PR_ORIGINAL_SENT_REPRESENTING_EMAIL_ADDRESS_A = PROP_TAG(PT_STRING8, 105)
+PR_CONVERSATION_TOPIC = PROP_TAG(PT_TSTRING, 112)
+PR_CONVERSATION_TOPIC_W = PROP_TAG(PT_UNICODE, 112)
+PR_CONVERSATION_TOPIC_A = PROP_TAG(PT_STRING8, 112)
+PR_CONVERSATION_INDEX = PROP_TAG(PT_BINARY, 113)
+PR_ORIGINAL_DISPLAY_BCC = PROP_TAG(PT_TSTRING, 114)
+PR_ORIGINAL_DISPLAY_BCC_W = PROP_TAG(PT_UNICODE, 114)
+PR_ORIGINAL_DISPLAY_BCC_A = PROP_TAG(PT_STRING8, 114)
+PR_ORIGINAL_DISPLAY_CC = PROP_TAG(PT_TSTRING, 115)
+PR_ORIGINAL_DISPLAY_CC_W = PROP_TAG(PT_UNICODE, 115)
+PR_ORIGINAL_DISPLAY_CC_A = PROP_TAG(PT_STRING8, 115)
+PR_ORIGINAL_DISPLAY_TO = PROP_TAG(PT_TSTRING, 116)
+PR_ORIGINAL_DISPLAY_TO_W = PROP_TAG(PT_UNICODE, 116)
+PR_ORIGINAL_DISPLAY_TO_A = PROP_TAG(PT_STRING8, 116)
+PR_RECEIVED_BY_ADDRTYPE = PROP_TAG(PT_TSTRING, 117)
+PR_RECEIVED_BY_ADDRTYPE_W = PROP_TAG(PT_UNICODE, 117)
+PR_RECEIVED_BY_ADDRTYPE_A = PROP_TAG(PT_STRING8, 117)
+PR_RECEIVED_BY_EMAIL_ADDRESS = PROP_TAG(PT_TSTRING, 118)
+PR_RECEIVED_BY_EMAIL_ADDRESS_W = PROP_TAG(PT_UNICODE, 118)
+PR_RECEIVED_BY_EMAIL_ADDRESS_A = PROP_TAG(PT_STRING8, 118)
+PR_RCVD_REPRESENTING_ADDRTYPE = PROP_TAG(PT_TSTRING, 119)
+PR_RCVD_REPRESENTING_ADDRTYPE_W = PROP_TAG(PT_UNICODE, 119)
+PR_RCVD_REPRESENTING_ADDRTYPE_A = PROP_TAG(PT_STRING8, 119)
+PR_RCVD_REPRESENTING_EMAIL_ADDRESS = PROP_TAG(PT_TSTRING, 120)
+PR_RCVD_REPRESENTING_EMAIL_ADDRESS_W = PROP_TAG(PT_UNICODE, 120)
+PR_RCVD_REPRESENTING_EMAIL_ADDRESS_A = PROP_TAG(PT_STRING8, 120)
+PR_ORIGINAL_AUTHOR_ADDRTYPE = PROP_TAG(PT_TSTRING, 121)
+PR_ORIGINAL_AUTHOR_ADDRTYPE_W = PROP_TAG(PT_UNICODE, 121)
+PR_ORIGINAL_AUTHOR_ADDRTYPE_A = PROP_TAG(PT_STRING8, 121)
+PR_ORIGINAL_AUTHOR_EMAIL_ADDRESS = PROP_TAG(PT_TSTRING, 122)
+PR_ORIGINAL_AUTHOR_EMAIL_ADDRESS_W = PROP_TAG(PT_UNICODE, 122)
+PR_ORIGINAL_AUTHOR_EMAIL_ADDRESS_A = PROP_TAG(PT_STRING8, 122)
+PR_ORIGINALLY_INTENDED_RECIP_ADDRTYPE = PROP_TAG(PT_TSTRING, 123)
+PR_ORIGINALLY_INTENDED_RECIP_ADDRTYPE_W = PROP_TAG(PT_UNICODE, 123)
+PR_ORIGINALLY_INTENDED_RECIP_ADDRTYPE_A = PROP_TAG(PT_STRING8, 123)
+PR_ORIGINALLY_INTENDED_RECIP_EMAIL_ADDRESS = PROP_TAG(PT_TSTRING, 124)
+PR_ORIGINALLY_INTENDED_RECIP_EMAIL_ADDRESS_W = PROP_TAG(PT_UNICODE, 124)
+PR_ORIGINALLY_INTENDED_RECIP_EMAIL_ADDRESS_A = PROP_TAG(PT_STRING8, 124)
+PR_TRANSPORT_MESSAGE_HEADERS = PROP_TAG(PT_TSTRING, 125)
+PR_TRANSPORT_MESSAGE_HEADERS_W = PROP_TAG(PT_UNICODE, 125)
+PR_TRANSPORT_MESSAGE_HEADERS_A = PROP_TAG(PT_STRING8, 125)
+PR_DELEGATION = PROP_TAG(PT_BINARY, 126)
+PR_TNEF_CORRELATION_KEY = PROP_TAG(PT_BINARY, 127)
+PR_BODY = PROP_TAG(PT_TSTRING, 4096)
+PR_BODY_W = PROP_TAG(PT_UNICODE, 4096)
+PR_BODY_A = PROP_TAG(PT_STRING8, 4096)
+PR_BODY_HTML = PROP_TAG(PT_TSTRING, 4115)
+PR_BODY_HTML_W = PROP_TAG(PT_UNICODE, 4115)
+PR_BODY_HTML_A = PROP_TAG(PT_STRING8, 4115)
+PR_REPORT_TEXT = PROP_TAG(PT_TSTRING, 4097)
+PR_REPORT_TEXT_W = PROP_TAG(PT_UNICODE, 4097)
+PR_REPORT_TEXT_A = PROP_TAG(PT_STRING8, 4097)
+PR_ORIGINATOR_AND_DL_EXPANSION_HISTORY = PROP_TAG(PT_BINARY, 4098)
+PR_REPORTING_DL_NAME = PROP_TAG(PT_BINARY, 4099)
+PR_REPORTING_MTA_CERTIFICATE = PROP_TAG(PT_BINARY, 4100)
+PR_RTF_SYNC_BODY_CRC = PROP_TAG(PT_LONG, 4102)
+PR_RTF_SYNC_BODY_COUNT = PROP_TAG(PT_LONG, 4103)
+PR_RTF_SYNC_BODY_TAG = PROP_TAG(PT_TSTRING, 4104)
+PR_RTF_SYNC_BODY_TAG_W = PROP_TAG(PT_UNICODE, 4104)
+PR_RTF_SYNC_BODY_TAG_A = PROP_TAG(PT_STRING8, 4104)
+PR_RTF_COMPRESSED = PROP_TAG(PT_BINARY, 4105)
+PR_RTF_SYNC_PREFIX_COUNT = PROP_TAG(PT_LONG, 4112)
+PR_RTF_SYNC_TRAILING_COUNT = PROP_TAG(PT_LONG, 4113)
+PR_ORIGINALLY_INTENDED_RECIP_ENTRYID = PROP_TAG(PT_BINARY, 4114)
+PR_CONTENT_INTEGRITY_CHECK = PROP_TAG(PT_BINARY, 3072)
+PR_EXPLICIT_CONVERSION = PROP_TAG(PT_LONG, 3073)
+PR_IPM_RETURN_REQUESTED = PROP_TAG(PT_BOOLEAN, 3074)
+PR_MESSAGE_TOKEN = PROP_TAG(PT_BINARY, 3075)
+PR_NDR_REASON_CODE = PROP_TAG(PT_LONG, 3076)
+PR_NDR_DIAG_CODE = PROP_TAG(PT_LONG, 3077)
+PR_NON_RECEIPT_NOTIFICATION_REQUESTED = PROP_TAG(PT_BOOLEAN, 3078)
+PR_DELIVERY_POINT = PROP_TAG(PT_LONG, 3079)
+PR_ORIGINATOR_NON_DELIVERY_REPORT_REQUESTED = PROP_TAG(PT_BOOLEAN, 3080)
+PR_ORIGINATOR_REQUESTED_ALTERNATE_RECIPIENT = PROP_TAG(PT_BINARY, 3081)
+PR_PHYSICAL_DELIVERY_BUREAU_FAX_DELIVERY = PROP_TAG(PT_BOOLEAN, 3082)
+PR_PHYSICAL_DELIVERY_MODE = PROP_TAG(PT_LONG, 3083)
+PR_PHYSICAL_DELIVERY_REPORT_REQUEST = PROP_TAG(PT_LONG, 3084)
+PR_PHYSICAL_FORWARDING_ADDRESS = PROP_TAG(PT_BINARY, 3085)
+PR_PHYSICAL_FORWARDING_ADDRESS_REQUESTED = PROP_TAG(PT_BOOLEAN, 3086)
+PR_PHYSICAL_FORWARDING_PROHIBITED = PROP_TAG(PT_BOOLEAN, 3087)
+PR_PHYSICAL_RENDITION_ATTRIBUTES = PROP_TAG(PT_BINARY, 3088)
+PR_PROOF_OF_DELIVERY = PROP_TAG(PT_BINARY, 3089)
+PR_PROOF_OF_DELIVERY_REQUESTED = PROP_TAG(PT_BOOLEAN, 3090)
+PR_RECIPIENT_CERTIFICATE = PROP_TAG(PT_BINARY, 3091)
+PR_RECIPIENT_NUMBER_FOR_ADVICE = PROP_TAG(PT_TSTRING, 3092)
+PR_RECIPIENT_NUMBER_FOR_ADVICE_W = PROP_TAG(PT_UNICODE, 3092)
+PR_RECIPIENT_NUMBER_FOR_ADVICE_A = PROP_TAG(PT_STRING8, 3092)
+PR_RECIPIENT_TYPE = PROP_TAG(PT_LONG, 3093)
+PR_REGISTERED_MAIL_TYPE = PROP_TAG(PT_LONG, 3094)
+PR_REPLY_REQUESTED = PROP_TAG(PT_BOOLEAN, 3095)
+PR_REQUESTED_DELIVERY_METHOD = PROP_TAG(PT_LONG, 3096)
+PR_SENDER_ENTRYID = PROP_TAG(PT_BINARY, 3097)
+PR_SENDER_NAME = PROP_TAG(PT_TSTRING, 3098)
+PR_SENDER_NAME_W = PROP_TAG(PT_UNICODE, 3098)
+PR_SENDER_NAME_A = PROP_TAG(PT_STRING8, 3098)
+PR_SUPPLEMENTARY_INFO = PROP_TAG(PT_TSTRING, 3099)
+PR_SUPPLEMENTARY_INFO_W = PROP_TAG(PT_UNICODE, 3099)
+PR_SUPPLEMENTARY_INFO_A = PROP_TAG(PT_STRING8, 3099)
+PR_TYPE_OF_MTS_USER = PROP_TAG(PT_LONG, 3100)
+PR_SENDER_SEARCH_KEY = PROP_TAG(PT_BINARY, 3101)
+PR_SENDER_ADDRTYPE = PROP_TAG(PT_TSTRING, 3102)
+PR_SENDER_ADDRTYPE_W = PROP_TAG(PT_UNICODE, 3102)
+PR_SENDER_ADDRTYPE_A = PROP_TAG(PT_STRING8, 3102)
+PR_SENDER_EMAIL_ADDRESS = PROP_TAG(PT_TSTRING, 3103)
+PR_SENDER_EMAIL_ADDRESS_W = PROP_TAG(PT_UNICODE, 3103)
+PR_SENDER_EMAIL_ADDRESS_A = PROP_TAG(PT_STRING8, 3103)
+PR_CURRENT_VERSION = PROP_TAG(PT_I8, 3584)
+PR_DELETE_AFTER_SUBMIT = PROP_TAG(PT_BOOLEAN, 3585)
+PR_DISPLAY_BCC = PROP_TAG(PT_TSTRING, 3586)
+PR_DISPLAY_BCC_W = PROP_TAG(PT_UNICODE, 3586)
+PR_DISPLAY_BCC_A = PROP_TAG(PT_STRING8, 3586)
+PR_DISPLAY_CC = PROP_TAG(PT_TSTRING, 3587)
+PR_DISPLAY_CC_W = PROP_TAG(PT_UNICODE, 3587)
+PR_DISPLAY_CC_A = PROP_TAG(PT_STRING8, 3587)
+PR_DISPLAY_TO = PROP_TAG(PT_TSTRING, 3588)
+PR_DISPLAY_TO_W = PROP_TAG(PT_UNICODE, 3588)
+PR_DISPLAY_TO_A = PROP_TAG(PT_STRING8, 3588)
+PR_PARENT_DISPLAY = PROP_TAG(PT_TSTRING, 3589)
+PR_PARENT_DISPLAY_W = PROP_TAG(PT_UNICODE, 3589)
+PR_PARENT_DISPLAY_A = PROP_TAG(PT_STRING8, 3589)
+PR_MESSAGE_DELIVERY_TIME = PROP_TAG(PT_SYSTIME, 3590)
+PR_MESSAGE_FLAGS = PROP_TAG(PT_LONG, 3591)
+PR_MESSAGE_SIZE = PROP_TAG(PT_LONG, 3592)
+PR_PARENT_ENTRYID = PROP_TAG(PT_BINARY, 3593)
+PR_SENTMAIL_ENTRYID = PROP_TAG(PT_BINARY, 3594)
+PR_CORRELATE = PROP_TAG(PT_BOOLEAN, 3596)
+PR_CORRELATE_MTSID = PROP_TAG(PT_BINARY, 3597)
+PR_DISCRETE_VALUES = PROP_TAG(PT_BOOLEAN, 3598)
+PR_RESPONSIBILITY = PROP_TAG(PT_BOOLEAN, 3599)
+PR_SPOOLER_STATUS = PROP_TAG(PT_LONG, 3600)
+PR_TRANSPORT_STATUS = PROP_TAG(PT_LONG, 3601)
+PR_MESSAGE_RECIPIENTS = PROP_TAG(PT_OBJECT, 3602)
+PR_MESSAGE_ATTACHMENTS = PROP_TAG(PT_OBJECT, 3603)
+PR_SUBMIT_FLAGS = PROP_TAG(PT_LONG, 3604)
+PR_RECIPIENT_STATUS = PROP_TAG(PT_LONG, 3605)
+PR_TRANSPORT_KEY = PROP_TAG(PT_LONG, 3606)
+PR_MSG_STATUS = PROP_TAG(PT_LONG, 3607)
+PR_MESSAGE_DOWNLOAD_TIME = PROP_TAG(PT_LONG, 3608)
+PR_CREATION_VERSION = PROP_TAG(PT_I8, 3609)
+PR_MODIFY_VERSION = PROP_TAG(PT_I8, 3610)
+PR_HASATTACH = PROP_TAG(PT_BOOLEAN, 3611)
+PR_BODY_CRC = PROP_TAG(PT_LONG, 3612)
+PR_NORMALIZED_SUBJECT = PROP_TAG(PT_TSTRING, 3613)
+PR_NORMALIZED_SUBJECT_W = PROP_TAG(PT_UNICODE, 3613)
+PR_NORMALIZED_SUBJECT_A = PROP_TAG(PT_STRING8, 3613)
+PR_RTF_IN_SYNC = PROP_TAG(PT_BOOLEAN, 3615)
+PR_ATTACH_SIZE = PROP_TAG(PT_LONG, 3616)
+PR_ATTACH_NUM = PROP_TAG(PT_LONG, 3617)
+PR_PREPROCESS = PROP_TAG(PT_BOOLEAN, 3618)
+PR_ORIGINATING_MTA_CERTIFICATE = PROP_TAG(PT_BINARY, 3621)
+PR_PROOF_OF_SUBMISSION = PROP_TAG(PT_BINARY, 3622)
+PR_ENTRYID = PROP_TAG(PT_BINARY, 4095)
+PR_OBJECT_TYPE = PROP_TAG(PT_LONG, 4094)
+PR_ICON = PROP_TAG(PT_BINARY, 4093)
+PR_MINI_ICON = PROP_TAG(PT_BINARY, 4092)
+PR_STORE_ENTRYID = PROP_TAG(PT_BINARY, 4091)
+PR_STORE_RECORD_KEY = PROP_TAG(PT_BINARY, 4090)
+PR_RECORD_KEY = PROP_TAG(PT_BINARY, 4089)
+PR_MAPPING_SIGNATURE = PROP_TAG(PT_BINARY, 4088)
+PR_ACCESS_LEVEL = PROP_TAG(PT_LONG, 4087)
+PR_INSTANCE_KEY = PROP_TAG(PT_BINARY, 4086)
+PR_ROW_TYPE = PROP_TAG(PT_LONG, 4085)
+PR_ACCESS = PROP_TAG(PT_LONG, 4084)
+PR_ROWID = PROP_TAG(PT_LONG, 12288)
+PR_DISPLAY_NAME = PROP_TAG(PT_TSTRING, 12289)
+PR_DISPLAY_NAME_W = PROP_TAG(PT_UNICODE, 12289)
+PR_DISPLAY_NAME_A = PROP_TAG(PT_STRING8, 12289)
+PR_ADDRTYPE = PROP_TAG(PT_TSTRING, 12290)
+PR_ADDRTYPE_W = PROP_TAG(PT_UNICODE, 12290)
+PR_ADDRTYPE_A = PROP_TAG(PT_STRING8, 12290)
+PR_EMAIL_ADDRESS = PROP_TAG(PT_TSTRING, 12291)
+PR_EMAIL_ADDRESS_W = PROP_TAG(PT_UNICODE, 12291)
+PR_EMAIL_ADDRESS_A = PROP_TAG(PT_STRING8, 12291)
+PR_COMMENT = PROP_TAG(PT_TSTRING, 12292)
+PR_COMMENT_W = PROP_TAG(PT_UNICODE, 12292)
+PR_COMMENT_A = PROP_TAG(PT_STRING8, 12292)
+PR_DEPTH = PROP_TAG(PT_LONG, 12293)
+PR_PROVIDER_DISPLAY = PROP_TAG(PT_TSTRING, 12294)
+PR_PROVIDER_DISPLAY_W = PROP_TAG(PT_UNICODE, 12294)
+PR_PROVIDER_DISPLAY_A = PROP_TAG(PT_STRING8, 12294)
+PR_CREATION_TIME = PROP_TAG(PT_SYSTIME, 12295)
+PR_LAST_MODIFICATION_TIME = PROP_TAG(PT_SYSTIME, 12296)
+PR_RESOURCE_FLAGS = PROP_TAG(PT_LONG, 12297)
+PR_PROVIDER_DLL_NAME = PROP_TAG(PT_TSTRING, 12298)
+PR_PROVIDER_DLL_NAME_W = PROP_TAG(PT_UNICODE, 12298)
+PR_PROVIDER_DLL_NAME_A = PROP_TAG(PT_STRING8, 12298)
+PR_SEARCH_KEY = PROP_TAG(PT_BINARY, 12299)
+PR_PROVIDER_UID = PROP_TAG(PT_BINARY, 12300)
+PR_PROVIDER_ORDINAL = PROP_TAG(PT_LONG, 12301)
+PR_FORM_VERSION = PROP_TAG(PT_TSTRING, 13057)
+PR_FORM_VERSION_W = PROP_TAG(PT_UNICODE, 13057)
+PR_FORM_VERSION_A = PROP_TAG(PT_STRING8, 13057)
+PR_FORM_CLSID = PROP_TAG(PT_CLSID, 13058)
+PR_FORM_CONTACT_NAME = PROP_TAG(PT_TSTRING, 13059)
+PR_FORM_CONTACT_NAME_W = PROP_TAG(PT_UNICODE, 13059)
+PR_FORM_CONTACT_NAME_A = PROP_TAG(PT_STRING8, 13059)
+PR_FORM_CATEGORY = PROP_TAG(PT_TSTRING, 13060)
+PR_FORM_CATEGORY_W = PROP_TAG(PT_UNICODE, 13060)
+PR_FORM_CATEGORY_A = PROP_TAG(PT_STRING8, 13060)
+PR_FORM_CATEGORY_SUB = PROP_TAG(PT_TSTRING, 13061)
+PR_FORM_CATEGORY_SUB_W = PROP_TAG(PT_UNICODE, 13061)
+PR_FORM_CATEGORY_SUB_A = PROP_TAG(PT_STRING8, 13061)
+PR_FORM_HOST_MAP = PROP_TAG(PT_MV_LONG, 13062)
+PR_FORM_HIDDEN = PROP_TAG(PT_BOOLEAN, 13063)
+PR_FORM_DESIGNER_NAME = PROP_TAG(PT_TSTRING, 13064)
+PR_FORM_DESIGNER_NAME_W = PROP_TAG(PT_UNICODE, 13064)
+PR_FORM_DESIGNER_NAME_A = PROP_TAG(PT_STRING8, 13064)
+PR_FORM_DESIGNER_GUID = PROP_TAG(PT_CLSID, 13065)
+PR_FORM_MESSAGE_BEHAVIOR = PROP_TAG(PT_LONG, 13066)
+PR_DEFAULT_STORE = PROP_TAG(PT_BOOLEAN, 13312)
+PR_STORE_SUPPORT_MASK = PROP_TAG(PT_LONG, 13325)
+PR_STORE_STATE = PROP_TAG(PT_LONG, 13326)
+PR_IPM_SUBTREE_SEARCH_KEY = PROP_TAG(PT_BINARY, 13328)
+PR_IPM_OUTBOX_SEARCH_KEY = PROP_TAG(PT_BINARY, 13329)
+PR_IPM_WASTEBASKET_SEARCH_KEY = PROP_TAG(PT_BINARY, 13330)
+PR_IPM_SENTMAIL_SEARCH_KEY = PROP_TAG(PT_BINARY, 13331)
+PR_MDB_PROVIDER = PROP_TAG(PT_BINARY, 13332)
+PR_RECEIVE_FOLDER_SETTINGS = PROP_TAG(PT_OBJECT, 13333)
+PR_VALID_FOLDER_MASK = PROP_TAG(PT_LONG, 13791)
+PR_IPM_SUBTREE_ENTRYID = PROP_TAG(PT_BINARY, 13792)
+PR_IPM_OUTBOX_ENTRYID = PROP_TAG(PT_BINARY, 13794)
+PR_IPM_WASTEBASKET_ENTRYID = PROP_TAG(PT_BINARY, 13795)
+PR_IPM_SENTMAIL_ENTRYID = PROP_TAG(PT_BINARY, 13796)
+PR_VIEWS_ENTRYID = PROP_TAG(PT_BINARY, 13797)
+PR_COMMON_VIEWS_ENTRYID = PROP_TAG(PT_BINARY, 13798)
+PR_FINDER_ENTRYID = PROP_TAG(PT_BINARY, 13799)
+PR_CONTAINER_FLAGS = PROP_TAG(PT_LONG, 13824)
+PR_FOLDER_TYPE = PROP_TAG(PT_LONG, 13825)
+PR_CONTENT_COUNT = PROP_TAG(PT_LONG, 13826)
+PR_CONTENT_UNREAD = PROP_TAG(PT_LONG, 13827)
+PR_CREATE_TEMPLATES = PROP_TAG(PT_OBJECT, 13828)
+PR_DETAILS_TABLE = PROP_TAG(PT_OBJECT, 13829)
+PR_SEARCH = PROP_TAG(PT_OBJECT, 13831)
+PR_SELECTABLE = PROP_TAG(PT_BOOLEAN, 13833)
+PR_SUBFOLDERS = PROP_TAG(PT_BOOLEAN, 13834)
+PR_STATUS = PROP_TAG(PT_LONG, 13835)
+PR_ANR = PROP_TAG(PT_TSTRING, 13836)
+PR_ANR_W = PROP_TAG(PT_UNICODE, 13836)
+PR_ANR_A = PROP_TAG(PT_STRING8, 13836)
+PR_CONTENTS_SORT_ORDER = PROP_TAG(PT_MV_LONG, 13837)
+PR_CONTAINER_HIERARCHY = PROP_TAG(PT_OBJECT, 13838)
+PR_CONTAINER_CONTENTS = PROP_TAG(PT_OBJECT, 13839)
+PR_FOLDER_ASSOCIATED_CONTENTS = PROP_TAG(PT_OBJECT, 13840)
+PR_DEF_CREATE_DL = PROP_TAG(PT_BINARY, 13841)
+PR_DEF_CREATE_MAILUSER = PROP_TAG(PT_BINARY, 13842)
+PR_CONTAINER_CLASS = PROP_TAG(PT_TSTRING, 13843)
+PR_CONTAINER_CLASS_W = PROP_TAG(PT_UNICODE, 13843)
+PR_CONTAINER_CLASS_A = PROP_TAG(PT_STRING8, 13843)
+PR_CONTAINER_MODIFY_VERSION = PROP_TAG(PT_I8, 13844)
+PR_AB_PROVIDER_ID = PROP_TAG(PT_BINARY, 13845)
+PR_DEFAULT_VIEW_ENTRYID = PROP_TAG(PT_BINARY, 13846)
+PR_ASSOC_CONTENT_COUNT = PROP_TAG(PT_LONG, 13847)
+PR_ATTACHMENT_X400_PARAMETERS = PROP_TAG(PT_BINARY, 14080)
+PR_ATTACH_DATA_OBJ = PROP_TAG(PT_OBJECT, 14081)
+PR_ATTACH_DATA_BIN = PROP_TAG(PT_BINARY, 14081)
+PR_ATTACH_ENCODING = PROP_TAG(PT_BINARY, 14082)
+PR_ATTACH_EXTENSION = PROP_TAG(PT_TSTRING, 14083)
+PR_ATTACH_EXTENSION_W = PROP_TAG(PT_UNICODE, 14083)
+PR_ATTACH_EXTENSION_A = PROP_TAG(PT_STRING8, 14083)
+PR_ATTACH_FILENAME = PROP_TAG(PT_TSTRING, 14084)
+PR_ATTACH_FILENAME_W = PROP_TAG(PT_UNICODE, 14084)
+PR_ATTACH_FILENAME_A = PROP_TAG(PT_STRING8, 14084)
+PR_ATTACH_METHOD = PROP_TAG(PT_LONG, 14085)
+PR_ATTACH_LONG_FILENAME = PROP_TAG(PT_TSTRING, 14087)
+PR_ATTACH_LONG_FILENAME_W = PROP_TAG(PT_UNICODE, 14087)
+PR_ATTACH_LONG_FILENAME_A = PROP_TAG(PT_STRING8, 14087)
+PR_ATTACH_PATHNAME = PROP_TAG(PT_TSTRING, 14088)
+PR_ATTACH_PATHNAME_W = PROP_TAG(PT_UNICODE, 14088)
+PR_ATTACH_PATHNAME_A = PROP_TAG(PT_STRING8, 14088)
+PR_ATTACH_RENDERING = PROP_TAG(PT_BINARY, 14089)
+PR_ATTACH_TAG = PROP_TAG(PT_BINARY, 14090)
+PR_RENDERING_POSITION = PROP_TAG(PT_LONG, 14091)
+PR_ATTACH_TRANSPORT_NAME = PROP_TAG(PT_TSTRING, 14092)
+PR_ATTACH_TRANSPORT_NAME_W = PROP_TAG(PT_UNICODE, 14092)
+PR_ATTACH_TRANSPORT_NAME_A = PROP_TAG(PT_STRING8, 14092)
+PR_ATTACH_LONG_PATHNAME = PROP_TAG(PT_TSTRING, 14093)
+PR_ATTACH_LONG_PATHNAME_W = PROP_TAG(PT_UNICODE, 14093)
+PR_ATTACH_LONG_PATHNAME_A = PROP_TAG(PT_STRING8, 14093)
+PR_ATTACH_MIME_TAG = PROP_TAG(PT_TSTRING, 14094)
+PR_ATTACH_MIME_TAG_W = PROP_TAG(PT_UNICODE, 14094)
+PR_ATTACH_MIME_TAG_A = PROP_TAG(PT_STRING8, 14094)
+PR_ATTACH_ADDITIONAL_INFO = PROP_TAG(PT_BINARY, 14095)
+PR_DISPLAY_TYPE = PROP_TAG(PT_LONG, 14592)
+PR_TEMPLATEID = PROP_TAG(PT_BINARY, 14594)
+PR_PRIMARY_CAPABILITY = PROP_TAG(PT_BINARY, 14596)
+PR_7BIT_DISPLAY_NAME = PROP_TAG(PT_STRING8, 14847)
+PR_ACCOUNT = PROP_TAG(PT_TSTRING, 14848)
+PR_ACCOUNT_W = PROP_TAG(PT_UNICODE, 14848)
+PR_ACCOUNT_A = PROP_TAG(PT_STRING8, 14848)
+PR_ALTERNATE_RECIPIENT = PROP_TAG(PT_BINARY, 14849)
+PR_CALLBACK_TELEPHONE_NUMBER = PROP_TAG(PT_TSTRING, 14850)
+PR_CALLBACK_TELEPHONE_NUMBER_W = PROP_TAG(PT_UNICODE, 14850)
+PR_CALLBACK_TELEPHONE_NUMBER_A = PROP_TAG(PT_STRING8, 14850)
+PR_CONVERSION_PROHIBITED = PROP_TAG(PT_BOOLEAN, 14851)
+PR_DISCLOSE_RECIPIENTS = PROP_TAG(PT_BOOLEAN, 14852)
+PR_GENERATION = PROP_TAG(PT_TSTRING, 14853)
+PR_GENERATION_W = PROP_TAG(PT_UNICODE, 14853)
+PR_GENERATION_A = PROP_TAG(PT_STRING8, 14853)
+PR_GIVEN_NAME = PROP_TAG(PT_TSTRING, 14854)
+PR_GIVEN_NAME_W = PROP_TAG(PT_UNICODE, 14854)
+PR_GIVEN_NAME_A = PROP_TAG(PT_STRING8, 14854)
+PR_GOVERNMENT_ID_NUMBER = PROP_TAG(PT_TSTRING, 14855)
+PR_GOVERNMENT_ID_NUMBER_W = PROP_TAG(PT_UNICODE, 14855)
+PR_GOVERNMENT_ID_NUMBER_A = PROP_TAG(PT_STRING8, 14855)
+PR_BUSINESS_TELEPHONE_NUMBER = PROP_TAG(PT_TSTRING, 14856)
+PR_BUSINESS_TELEPHONE_NUMBER_W = PROP_TAG(PT_UNICODE, 14856)
+PR_BUSINESS_TELEPHONE_NUMBER_A = PROP_TAG(PT_STRING8, 14856)
+PR_OFFICE_TELEPHONE_NUMBER = PR_BUSINESS_TELEPHONE_NUMBER
+PR_OFFICE_TELEPHONE_NUMBER_W = PR_BUSINESS_TELEPHONE_NUMBER_W
+PR_OFFICE_TELEPHONE_NUMBER_A = PR_BUSINESS_TELEPHONE_NUMBER_A
+PR_HOME_TELEPHONE_NUMBER = PROP_TAG(PT_TSTRING, 14857)
+PR_HOME_TELEPHONE_NUMBER_W = PROP_TAG(PT_UNICODE, 14857)
+PR_HOME_TELEPHONE_NUMBER_A = PROP_TAG(PT_STRING8, 14857)
+PR_INITIALS = PROP_TAG(PT_TSTRING, 14858)
+PR_INITIALS_W = PROP_TAG(PT_UNICODE, 14858)
+PR_INITIALS_A = PROP_TAG(PT_STRING8, 14858)
+PR_KEYWORD = PROP_TAG(PT_TSTRING, 14859)
+PR_KEYWORD_W = PROP_TAG(PT_UNICODE, 14859)
+PR_KEYWORD_A = PROP_TAG(PT_STRING8, 14859)
+PR_LANGUAGE = PROP_TAG(PT_TSTRING, 14860)
+PR_LANGUAGE_W = PROP_TAG(PT_UNICODE, 14860)
+PR_LANGUAGE_A = PROP_TAG(PT_STRING8, 14860)
+PR_LOCATION = PROP_TAG(PT_TSTRING, 14861)
+PR_LOCATION_W = PROP_TAG(PT_UNICODE, 14861)
+PR_LOCATION_A = PROP_TAG(PT_STRING8, 14861)
+PR_MAIL_PERMISSION = PROP_TAG(PT_BOOLEAN, 14862)
+PR_MHS_COMMON_NAME = PROP_TAG(PT_TSTRING, 14863)
+PR_MHS_COMMON_NAME_W = PROP_TAG(PT_UNICODE, 14863)
+PR_MHS_COMMON_NAME_A = PROP_TAG(PT_STRING8, 14863)
+PR_ORGANIZATIONAL_ID_NUMBER = PROP_TAG(PT_TSTRING, 14864)
+PR_ORGANIZATIONAL_ID_NUMBER_W = PROP_TAG(PT_UNICODE, 14864)
+PR_ORGANIZATIONAL_ID_NUMBER_A = PROP_TAG(PT_STRING8, 14864)
+PR_SURNAME = PROP_TAG(PT_TSTRING, 14865)
+PR_SURNAME_W = PROP_TAG(PT_UNICODE, 14865)
+PR_SURNAME_A = PROP_TAG(PT_STRING8, 14865)
+PR_ORIGINAL_ENTRYID = PROP_TAG(PT_BINARY, 14866)
+PR_ORIGINAL_DISPLAY_NAME = PROP_TAG(PT_TSTRING, 14867)
+PR_ORIGINAL_DISPLAY_NAME_W = PROP_TAG(PT_UNICODE, 14867)
+PR_ORIGINAL_DISPLAY_NAME_A = PROP_TAG(PT_STRING8, 14867)
+PR_ORIGINAL_SEARCH_KEY = PROP_TAG(PT_BINARY, 14868)
+PR_POSTAL_ADDRESS = PROP_TAG(PT_TSTRING, 14869)
+PR_POSTAL_ADDRESS_W = PROP_TAG(PT_UNICODE, 14869)
+PR_POSTAL_ADDRESS_A = PROP_TAG(PT_STRING8, 14869)
+PR_COMPANY_NAME = PROP_TAG(PT_TSTRING, 14870)
+PR_COMPANY_NAME_W = PROP_TAG(PT_UNICODE, 14870)
+PR_COMPANY_NAME_A = PROP_TAG(PT_STRING8, 14870)
+PR_TITLE = PROP_TAG(PT_TSTRING, 14871)
+PR_TITLE_W = PROP_TAG(PT_UNICODE, 14871)
+PR_TITLE_A = PROP_TAG(PT_STRING8, 14871)
+PR_DEPARTMENT_NAME = PROP_TAG(PT_TSTRING, 14872)
+PR_DEPARTMENT_NAME_W = PROP_TAG(PT_UNICODE, 14872)
+PR_DEPARTMENT_NAME_A = PROP_TAG(PT_STRING8, 14872)
+PR_OFFICE_LOCATION = PROP_TAG(PT_TSTRING, 14873)
+PR_OFFICE_LOCATION_W = PROP_TAG(PT_UNICODE, 14873)
+PR_OFFICE_LOCATION_A = PROP_TAG(PT_STRING8, 14873)
+PR_PRIMARY_TELEPHONE_NUMBER = PROP_TAG(PT_TSTRING, 14874)
+PR_PRIMARY_TELEPHONE_NUMBER_W = PROP_TAG(PT_UNICODE, 14874)
+PR_PRIMARY_TELEPHONE_NUMBER_A = PROP_TAG(PT_STRING8, 14874)
+PR_BUSINESS2_TELEPHONE_NUMBER = PROP_TAG(PT_TSTRING, 14875)
+PR_BUSINESS2_TELEPHONE_NUMBER_W = PROP_TAG(PT_UNICODE, 14875)
+PR_BUSINESS2_TELEPHONE_NUMBER_A = PROP_TAG(PT_STRING8, 14875)
+PR_OFFICE2_TELEPHONE_NUMBER = PR_BUSINESS2_TELEPHONE_NUMBER
+PR_OFFICE2_TELEPHONE_NUMBER_W = PR_BUSINESS2_TELEPHONE_NUMBER_W
+PR_OFFICE2_TELEPHONE_NUMBER_A = PR_BUSINESS2_TELEPHONE_NUMBER_A
+PR_MOBILE_TELEPHONE_NUMBER = PROP_TAG(PT_TSTRING, 14876)
+PR_MOBILE_TELEPHONE_NUMBER_W = PROP_TAG(PT_UNICODE, 14876)
+PR_MOBILE_TELEPHONE_NUMBER_A = PROP_TAG(PT_STRING8, 14876)
+PR_CELLULAR_TELEPHONE_NUMBER = PR_MOBILE_TELEPHONE_NUMBER
+PR_CELLULAR_TELEPHONE_NUMBER_W = PR_MOBILE_TELEPHONE_NUMBER_W
+PR_CELLULAR_TELEPHONE_NUMBER_A = PR_MOBILE_TELEPHONE_NUMBER_A
+PR_RADIO_TELEPHONE_NUMBER = PROP_TAG(PT_TSTRING, 14877)
+PR_RADIO_TELEPHONE_NUMBER_W = PROP_TAG(PT_UNICODE, 14877)
+PR_RADIO_TELEPHONE_NUMBER_A = PROP_TAG(PT_STRING8, 14877)
+PR_CAR_TELEPHONE_NUMBER = PROP_TAG(PT_TSTRING, 14878)
+PR_CAR_TELEPHONE_NUMBER_W = PROP_TAG(PT_UNICODE, 14878)
+PR_CAR_TELEPHONE_NUMBER_A = PROP_TAG(PT_STRING8, 14878)
+PR_OTHER_TELEPHONE_NUMBER = PROP_TAG(PT_TSTRING, 14879)
+PR_OTHER_TELEPHONE_NUMBER_W = PROP_TAG(PT_UNICODE, 14879)
+PR_OTHER_TELEPHONE_NUMBER_A = PROP_TAG(PT_STRING8, 14879)
+PR_TRANSMITABLE_DISPLAY_NAME = PROP_TAG(PT_TSTRING, 14880)
+PR_TRANSMITABLE_DISPLAY_NAME_W = PROP_TAG(PT_UNICODE, 14880)
+PR_TRANSMITABLE_DISPLAY_NAME_A = PROP_TAG(PT_STRING8, 14880)
+PR_PAGER_TELEPHONE_NUMBER = PROP_TAG(PT_TSTRING, 14881)
+PR_PAGER_TELEPHONE_NUMBER_W = PROP_TAG(PT_UNICODE, 14881)
+PR_PAGER_TELEPHONE_NUMBER_A = PROP_TAG(PT_STRING8, 14881)
+PR_BEEPER_TELEPHONE_NUMBER = PR_PAGER_TELEPHONE_NUMBER
+PR_BEEPER_TELEPHONE_NUMBER_W = PR_PAGER_TELEPHONE_NUMBER_W
+PR_BEEPER_TELEPHONE_NUMBER_A = PR_PAGER_TELEPHONE_NUMBER_A
+PR_USER_CERTIFICATE = PROP_TAG(PT_BINARY, 14882)
+PR_PRIMARY_FAX_NUMBER = PROP_TAG(PT_TSTRING, 14883)
+PR_PRIMARY_FAX_NUMBER_W = PROP_TAG(PT_UNICODE, 14883)
+PR_PRIMARY_FAX_NUMBER_A = PROP_TAG(PT_STRING8, 14883)
+PR_BUSINESS_FAX_NUMBER = PROP_TAG(PT_TSTRING, 14884)
+PR_BUSINESS_FAX_NUMBER_W = PROP_TAG(PT_UNICODE, 14884)
+PR_BUSINESS_FAX_NUMBER_A = PROP_TAG(PT_STRING8, 14884)
+PR_HOME_FAX_NUMBER = PROP_TAG(PT_TSTRING, 14885)
+PR_HOME_FAX_NUMBER_W = PROP_TAG(PT_UNICODE, 14885)
+PR_HOME_FAX_NUMBER_A = PROP_TAG(PT_STRING8, 14885)
+PR_COUNTRY = PROP_TAG(PT_TSTRING, 14886)
+PR_COUNTRY_W = PROP_TAG(PT_UNICODE, 14886)
+PR_COUNTRY_A = PROP_TAG(PT_STRING8, 14886)
+PR_BUSINESS_ADDRESS_COUNTRY = PR_COUNTRY
+PR_BUSINESS_ADDRESS_COUNTRY_W = PR_COUNTRY_W
+PR_BUSINESS_ADDRESS_COUNTRY_A = PR_COUNTRY_A
+PR_LOCALITY = PROP_TAG(PT_TSTRING, 14887)
+PR_LOCALITY_W = PROP_TAG(PT_UNICODE, 14887)
+PR_LOCALITY_A = PROP_TAG(PT_STRING8, 14887)
+PR_BUSINESS_ADDRESS_CITY = PR_LOCALITY
+PR_BUSINESS_ADDRESS_CITY_W = PR_LOCALITY_W
+PR_BUSINESS_ADDRESS_CITY_A = PR_LOCALITY_A
+PR_STATE_OR_PROVINCE = PROP_TAG(PT_TSTRING, 14888)
+PR_STATE_OR_PROVINCE_W = PROP_TAG(PT_UNICODE, 14888)
+PR_STATE_OR_PROVINCE_A = PROP_TAG(PT_STRING8, 14888)
+PR_BUSINESS_ADDRESS_STATE_OR_PROVINCE = PR_STATE_OR_PROVINCE
+PR_BUSINESS_ADDRESS_STATE_OR_PROVINCE_W = PR_STATE_OR_PROVINCE_W
+PR_BUSINESS_ADDRESS_STATE_OR_PROVINCE_A = PR_STATE_OR_PROVINCE_A
+PR_STREET_ADDRESS = PROP_TAG(PT_TSTRING, 14889)
+PR_STREET_ADDRESS_W = PROP_TAG(PT_UNICODE, 14889)
+PR_STREET_ADDRESS_A = PROP_TAG(PT_STRING8, 14889)
+PR_BUSINESS_ADDRESS_STREET = PR_STREET_ADDRESS
+PR_BUSINESS_ADDRESS_STREET_W = PR_STREET_ADDRESS_W
+PR_BUSINESS_ADDRESS_STREET_A = PR_STREET_ADDRESS_A
+PR_POSTAL_CODE = PROP_TAG(PT_TSTRING, 14890)
+PR_POSTAL_CODE_W = PROP_TAG(PT_UNICODE, 14890)
+PR_POSTAL_CODE_A = PROP_TAG(PT_STRING8, 14890)
+PR_BUSINESS_ADDRESS_POSTAL_CODE = PR_POSTAL_CODE
+PR_BUSINESS_ADDRESS_POSTAL_CODE_W = PR_POSTAL_CODE_W
+PR_BUSINESS_ADDRESS_POSTAL_CODE_A = PR_POSTAL_CODE_A
+PR_POST_OFFICE_BOX = PROP_TAG(PT_TSTRING, 14891)
+PR_POST_OFFICE_BOX_W = PROP_TAG(PT_UNICODE, 14891)
+PR_POST_OFFICE_BOX_A = PROP_TAG(PT_STRING8, 14891)
+PR_BUSINESS_ADDRESS_POST_OFFICE_BOX = PR_POST_OFFICE_BOX
+PR_BUSINESS_ADDRESS_POST_OFFICE_BOX_W = PR_POST_OFFICE_BOX_W
+PR_BUSINESS_ADDRESS_POST_OFFICE_BOX_A = PR_POST_OFFICE_BOX_A
+PR_TELEX_NUMBER = PROP_TAG(PT_TSTRING, 14892)
+PR_TELEX_NUMBER_W = PROP_TAG(PT_UNICODE, 14892)
+PR_TELEX_NUMBER_A = PROP_TAG(PT_STRING8, 14892)
+PR_ISDN_NUMBER = PROP_TAG(PT_TSTRING, 14893)
+PR_ISDN_NUMBER_W = PROP_TAG(PT_UNICODE, 14893)
+PR_ISDN_NUMBER_A = PROP_TAG(PT_STRING8, 14893)
+PR_ASSISTANT_TELEPHONE_NUMBER = PROP_TAG(PT_TSTRING, 14894)
+PR_ASSISTANT_TELEPHONE_NUMBER_W = PROP_TAG(PT_UNICODE, 14894)
+PR_ASSISTANT_TELEPHONE_NUMBER_A = PROP_TAG(PT_STRING8, 14894)
+PR_HOME2_TELEPHONE_NUMBER = PROP_TAG(PT_TSTRING, 14895)
+PR_HOME2_TELEPHONE_NUMBER_W = PROP_TAG(PT_UNICODE, 14895)
+PR_HOME2_TELEPHONE_NUMBER_A = PROP_TAG(PT_STRING8, 14895)
+PR_ASSISTANT = PROP_TAG(PT_TSTRING, 14896)
+PR_ASSISTANT_W = PROP_TAG(PT_UNICODE, 14896)
+PR_ASSISTANT_A = PROP_TAG(PT_STRING8, 14896)
+PR_SEND_RICH_INFO = PROP_TAG(PT_BOOLEAN, 14912)
+PR_WEDDING_ANNIVERSARY = PROP_TAG(PT_SYSTIME, 14913)
+PR_BIRTHDAY = PROP_TAG(PT_SYSTIME, 14914)
+PR_HOBBIES = PROP_TAG(PT_TSTRING, 14915)
+PR_HOBBIES_W = PROP_TAG(PT_UNICODE, 14915)
+PR_HOBBIES_A = PROP_TAG(PT_STRING8, 14915)
+PR_MIDDLE_NAME = PROP_TAG(PT_TSTRING, 14916)
+PR_MIDDLE_NAME_W = PROP_TAG(PT_UNICODE, 14916)
+PR_MIDDLE_NAME_A = PROP_TAG(PT_STRING8, 14916)
+PR_DISPLAY_NAME_PREFIX = PROP_TAG(PT_TSTRING, 14917)
+PR_DISPLAY_NAME_PREFIX_W = PROP_TAG(PT_UNICODE, 14917)
+PR_DISPLAY_NAME_PREFIX_A = PROP_TAG(PT_STRING8, 14917)
+PR_PROFESSION = PROP_TAG(PT_TSTRING, 14918)
+PR_PROFESSION_W = PROP_TAG(PT_UNICODE, 14918)
+PR_PROFESSION_A = PROP_TAG(PT_STRING8, 14918)
+PR_PREFERRED_BY_NAME = PROP_TAG(PT_TSTRING, 14919)
+PR_PREFERRED_BY_NAME_W = PROP_TAG(PT_UNICODE, 14919)
+PR_PREFERRED_BY_NAME_A = PROP_TAG(PT_STRING8, 14919)
+PR_SPOUSE_NAME = PROP_TAG(PT_TSTRING, 14920)
+PR_SPOUSE_NAME_W = PROP_TAG(PT_UNICODE, 14920)
+PR_SPOUSE_NAME_A = PROP_TAG(PT_STRING8, 14920)
+PR_COMPUTER_NETWORK_NAME = PROP_TAG(PT_TSTRING, 14921)
+PR_COMPUTER_NETWORK_NAME_W = PROP_TAG(PT_UNICODE, 14921)
+PR_COMPUTER_NETWORK_NAME_A = PROP_TAG(PT_STRING8, 14921)
+PR_CUSTOMER_ID = PROP_TAG(PT_TSTRING, 14922)
+PR_CUSTOMER_ID_W = PROP_TAG(PT_UNICODE, 14922)
+PR_CUSTOMER_ID_A = PROP_TAG(PT_STRING8, 14922)
+PR_TTYTDD_PHONE_NUMBER = PROP_TAG(PT_TSTRING, 14923)
+PR_TTYTDD_PHONE_NUMBER_W = PROP_TAG(PT_UNICODE, 14923)
+PR_TTYTDD_PHONE_NUMBER_A = PROP_TAG(PT_STRING8, 14923)
+PR_FTP_SITE = PROP_TAG(PT_TSTRING, 14924)
+PR_FTP_SITE_W = PROP_TAG(PT_UNICODE, 14924)
+PR_FTP_SITE_A = PROP_TAG(PT_STRING8, 14924)
+PR_GENDER = PROP_TAG(PT_SHORT, 14925)
+PR_MANAGER_NAME = PROP_TAG(PT_TSTRING, 14926)
+PR_MANAGER_NAME_W = PROP_TAG(PT_UNICODE, 14926)
+PR_MANAGER_NAME_A = PROP_TAG(PT_STRING8, 14926)
+PR_NICKNAME = PROP_TAG(PT_TSTRING, 14927)
+PR_NICKNAME_W = PROP_TAG(PT_UNICODE, 14927)
+PR_NICKNAME_A = PROP_TAG(PT_STRING8, 14927)
+PR_PERSONAL_HOME_PAGE = PROP_TAG(PT_TSTRING, 14928)
+PR_PERSONAL_HOME_PAGE_W = PROP_TAG(PT_UNICODE, 14928)
+PR_PERSONAL_HOME_PAGE_A = PROP_TAG(PT_STRING8, 14928)
+PR_BUSINESS_HOME_PAGE = PROP_TAG(PT_TSTRING, 14929)
+PR_BUSINESS_HOME_PAGE_W = PROP_TAG(PT_UNICODE, 14929)
+PR_BUSINESS_HOME_PAGE_A = PROP_TAG(PT_STRING8, 14929)
+PR_CONTACT_VERSION = PROP_TAG(PT_CLSID, 14930)
+PR_CONTACT_ENTRYIDS = PROP_TAG(PT_MV_BINARY, 14931)
+PR_CONTACT_ADDRTYPES = PROP_TAG(PT_MV_TSTRING, 14932)
+PR_CONTACT_ADDRTYPES_W = PROP_TAG(PT_MV_UNICODE, 14932)
+PR_CONTACT_ADDRTYPES_A = PROP_TAG(PT_MV_STRING8, 14932)
+PR_CONTACT_DEFAULT_ADDRESS_INDEX = PROP_TAG(PT_LONG, 14933)
+PR_CONTACT_EMAIL_ADDRESSES = PROP_TAG(PT_MV_TSTRING, 14934)
+PR_CONTACT_EMAIL_ADDRESSES_W = PROP_TAG(PT_MV_UNICODE, 14934)
+PR_CONTACT_EMAIL_ADDRESSES_A = PROP_TAG(PT_MV_STRING8, 14934)
+PR_COMPANY_MAIN_PHONE_NUMBER = PROP_TAG(PT_TSTRING, 14935)
+PR_COMPANY_MAIN_PHONE_NUMBER_W = PROP_TAG(PT_UNICODE, 14935)
+PR_COMPANY_MAIN_PHONE_NUMBER_A = PROP_TAG(PT_STRING8, 14935)
+PR_CHILDRENS_NAMES = PROP_TAG(PT_MV_TSTRING, 14936)
+PR_CHILDRENS_NAMES_W = PROP_TAG(PT_MV_UNICODE, 14936)
+PR_CHILDRENS_NAMES_A = PROP_TAG(PT_MV_STRING8, 14936)
+PR_HOME_ADDRESS_CITY = PROP_TAG(PT_TSTRING, 14937)
+PR_HOME_ADDRESS_CITY_W = PROP_TAG(PT_UNICODE, 14937)
+PR_HOME_ADDRESS_CITY_A = PROP_TAG(PT_STRING8, 14937)
+PR_HOME_ADDRESS_COUNTRY = PROP_TAG(PT_TSTRING, 14938)
+PR_HOME_ADDRESS_COUNTRY_W = PROP_TAG(PT_UNICODE, 14938)
+PR_HOME_ADDRESS_COUNTRY_A = PROP_TAG(PT_STRING8, 14938)
+PR_HOME_ADDRESS_POSTAL_CODE = PROP_TAG(PT_TSTRING, 14939)
+PR_HOME_ADDRESS_POSTAL_CODE_W = PROP_TAG(PT_UNICODE, 14939)
+PR_HOME_ADDRESS_POSTAL_CODE_A = PROP_TAG(PT_STRING8, 14939)
+PR_HOME_ADDRESS_STATE_OR_PROVINCE = PROP_TAG(PT_TSTRING, 14940)
+PR_HOME_ADDRESS_STATE_OR_PROVINCE_W = PROP_TAG(PT_UNICODE, 14940)
+PR_HOME_ADDRESS_STATE_OR_PROVINCE_A = PROP_TAG(PT_STRING8, 14940)
+PR_HOME_ADDRESS_STREET = PROP_TAG(PT_TSTRING, 14941)
+PR_HOME_ADDRESS_STREET_W = PROP_TAG(PT_UNICODE, 14941)
+PR_HOME_ADDRESS_STREET_A = PROP_TAG(PT_STRING8, 14941)
+PR_HOME_ADDRESS_POST_OFFICE_BOX = PROP_TAG(PT_TSTRING, 14942)
+PR_HOME_ADDRESS_POST_OFFICE_BOX_W = PROP_TAG(PT_UNICODE, 14942)
+PR_HOME_ADDRESS_POST_OFFICE_BOX_A = PROP_TAG(PT_STRING8, 14942)
+PR_OTHER_ADDRESS_CITY = PROP_TAG(PT_TSTRING, 14943)
+PR_OTHER_ADDRESS_CITY_W = PROP_TAG(PT_UNICODE, 14943)
+PR_OTHER_ADDRESS_CITY_A = PROP_TAG(PT_STRING8, 14943)
+PR_OTHER_ADDRESS_COUNTRY = PROP_TAG(PT_TSTRING, 14944)
+PR_OTHER_ADDRESS_COUNTRY_W = PROP_TAG(PT_UNICODE, 14944)
+PR_OTHER_ADDRESS_COUNTRY_A = PROP_TAG(PT_STRING8, 14944)
+PR_OTHER_ADDRESS_POSTAL_CODE = PROP_TAG(PT_TSTRING, 14945)
+PR_OTHER_ADDRESS_POSTAL_CODE_W = PROP_TAG(PT_UNICODE, 14945)
+PR_OTHER_ADDRESS_POSTAL_CODE_A = PROP_TAG(PT_STRING8, 14945)
+PR_OTHER_ADDRESS_STATE_OR_PROVINCE = PROP_TAG(PT_TSTRING, 14946)
+PR_OTHER_ADDRESS_STATE_OR_PROVINCE_W = PROP_TAG(PT_UNICODE, 14946)
+PR_OTHER_ADDRESS_STATE_OR_PROVINCE_A = PROP_TAG(PT_STRING8, 14946)
+PR_OTHER_ADDRESS_STREET = PROP_TAG(PT_TSTRING, 14947)
+PR_OTHER_ADDRESS_STREET_W = PROP_TAG(PT_UNICODE, 14947)
+PR_OTHER_ADDRESS_STREET_A = PROP_TAG(PT_STRING8, 14947)
+PR_OTHER_ADDRESS_POST_OFFICE_BOX = PROP_TAG(PT_TSTRING, 14948)
+PR_OTHER_ADDRESS_POST_OFFICE_BOX_W = PROP_TAG(PT_UNICODE, 14948)
+PR_OTHER_ADDRESS_POST_OFFICE_BOX_A = PROP_TAG(PT_STRING8, 14948)
+PR_STORE_PROVIDERS = PROP_TAG(PT_BINARY, 15616)
+PR_AB_PROVIDERS = PROP_TAG(PT_BINARY, 15617)
+PR_TRANSPORT_PROVIDERS = PROP_TAG(PT_BINARY, 15618)
+PR_DEFAULT_PROFILE = PROP_TAG(PT_BOOLEAN, 15620)
+PR_AB_SEARCH_PATH = PROP_TAG(PT_MV_BINARY, 15621)
+PR_AB_DEFAULT_DIR = PROP_TAG(PT_BINARY, 15622)
+PR_AB_DEFAULT_PAB = PROP_TAG(PT_BINARY, 15623)
+PR_FILTERING_HOOKS = PROP_TAG(PT_BINARY, 15624)
+PR_SERVICE_NAME = PROP_TAG(PT_TSTRING, 15625)
+PR_SERVICE_NAME_W = PROP_TAG(PT_UNICODE, 15625)
+PR_SERVICE_NAME_A = PROP_TAG(PT_STRING8, 15625)
+PR_SERVICE_DLL_NAME = PROP_TAG(PT_TSTRING, 15626)
+PR_SERVICE_DLL_NAME_W = PROP_TAG(PT_UNICODE, 15626)
+PR_SERVICE_DLL_NAME_A = PROP_TAG(PT_STRING8, 15626)
+PR_SERVICE_ENTRY_NAME = PROP_TAG(PT_STRING8, 15627)
+PR_SERVICE_UID = PROP_TAG(PT_BINARY, 15628)
+PR_SERVICE_EXTRA_UIDS = PROP_TAG(PT_BINARY, 15629)
+PR_SERVICES = PROP_TAG(PT_BINARY, 15630)
+PR_SERVICE_SUPPORT_FILES = PROP_TAG(PT_MV_TSTRING, 15631)
+PR_SERVICE_SUPPORT_FILES_W = PROP_TAG(PT_MV_UNICODE, 15631)
+PR_SERVICE_SUPPORT_FILES_A = PROP_TAG(PT_MV_STRING8, 15631)
+PR_SERVICE_DELETE_FILES = PROP_TAG(PT_MV_TSTRING, 15632)
+PR_SERVICE_DELETE_FILES_W = PROP_TAG(PT_MV_UNICODE, 15632)
+PR_SERVICE_DELETE_FILES_A = PROP_TAG(PT_MV_STRING8, 15632)
+PR_AB_SEARCH_PATH_UPDATE = PROP_TAG(PT_BINARY, 15633)
+PR_PROFILE_NAME = PROP_TAG(PT_TSTRING, 15634)
+PR_PROFILE_NAME_A = PROP_TAG(PT_STRING8, 15634)
+PR_PROFILE_NAME_W = PROP_TAG(PT_UNICODE, 15634)
+PR_IDENTITY_DISPLAY = PROP_TAG(PT_TSTRING, 15872)
+PR_IDENTITY_DISPLAY_W = PROP_TAG(PT_UNICODE, 15872)
+PR_IDENTITY_DISPLAY_A = PROP_TAG(PT_STRING8, 15872)
+PR_IDENTITY_ENTRYID = PROP_TAG(PT_BINARY, 15873)
+PR_RESOURCE_METHODS = PROP_TAG(PT_LONG, 15874)
+PR_RESOURCE_TYPE = PROP_TAG(PT_LONG, 15875)
+PR_STATUS_CODE = PROP_TAG(PT_LONG, 15876)
+PR_IDENTITY_SEARCH_KEY = PROP_TAG(PT_BINARY, 15877)
+PR_OWN_STORE_ENTRYID = PROP_TAG(PT_BINARY, 15878)
+PR_RESOURCE_PATH = PROP_TAG(PT_TSTRING, 15879)
+PR_RESOURCE_PATH_W = PROP_TAG(PT_UNICODE, 15879)
+PR_RESOURCE_PATH_A = PROP_TAG(PT_STRING8, 15879)
+PR_STATUS_STRING = PROP_TAG(PT_TSTRING, 15880)
+PR_STATUS_STRING_W = PROP_TAG(PT_UNICODE, 15880)
+PR_STATUS_STRING_A = PROP_TAG(PT_STRING8, 15880)
+PR_X400_DEFERRED_DELIVERY_CANCEL = PROP_TAG(PT_BOOLEAN, 15881)
+PR_HEADER_FOLDER_ENTRYID = PROP_TAG(PT_BINARY, 15882)
+PR_REMOTE_PROGRESS = PROP_TAG(PT_LONG, 15883)
+PR_REMOTE_PROGRESS_TEXT = PROP_TAG(PT_TSTRING, 15884)
+PR_REMOTE_PROGRESS_TEXT_W = PROP_TAG(PT_UNICODE, 15884)
+PR_REMOTE_PROGRESS_TEXT_A = PROP_TAG(PT_STRING8, 15884)
+PR_REMOTE_VALIDATE_OK = PROP_TAG(PT_BOOLEAN, 15885)
+PR_CONTROL_FLAGS = PROP_TAG(PT_LONG, 16128)
+PR_CONTROL_STRUCTURE = PROP_TAG(PT_BINARY, 16129)
+PR_CONTROL_TYPE = PROP_TAG(PT_LONG, 16130)
+PR_DELTAX = PROP_TAG(PT_LONG, 16131)
+PR_DELTAY = PROP_TAG(PT_LONG, 16132)
+PR_XPOS = PROP_TAG(PT_LONG, 16133)
+PR_YPOS = PROP_TAG(PT_LONG, 16134)
+PR_CONTROL_ID = PROP_TAG(PT_BINARY, 16135)
+PR_INITIAL_DETAILS_PANE = PROP_TAG(PT_LONG, 16136)
+
+PROP_ID_SECURE_MIN = 26608
+PROP_ID_SECURE_MAX = 26623
+
+# From EDKMDB.H
+pidExchangeXmitReservedMin = 16352
+pidExchangeNonXmitReservedMin = 26080
+pidProfileMin = 26112
+pidStoreMin = 26136
+pidFolderMin = 26168
+pidMessageReadOnlyMin = 26176
+pidMessageWriteableMin = 26200
+pidAttachReadOnlyMin = 26220
+pidSpecialMin = 26224
+pidAdminMin = 26256
+pidSecureProfileMin = PROP_ID_SECURE_MIN
+
+PR_PROFILE_VERSION = PROP_TAG(PT_LONG, pidProfileMin + 0)
+PR_PROFILE_CONFIG_FLAGS = PROP_TAG(PT_LONG, pidProfileMin + 1)
+PR_PROFILE_HOME_SERVER = PROP_TAG(PT_STRING8, pidProfileMin + 2)
+PR_PROFILE_HOME_SERVER_DN = PROP_TAG(PT_STRING8, pidProfileMin + 18)
+PR_PROFILE_HOME_SERVER_ADDRS = PROP_TAG(PT_MV_STRING8, pidProfileMin + 19)
+PR_PROFILE_USER = PROP_TAG(PT_STRING8, pidProfileMin + 3)
+PR_PROFILE_CONNECT_FLAGS = PROP_TAG(PT_LONG, pidProfileMin + 4)
+PR_PROFILE_TRANSPORT_FLAGS = PROP_TAG(PT_LONG, pidProfileMin + 5)
+PR_PROFILE_UI_STATE = PROP_TAG(PT_LONG, pidProfileMin + 6)
+PR_PROFILE_UNRESOLVED_NAME = PROP_TAG(PT_STRING8, pidProfileMin + 7)
+PR_PROFILE_UNRESOLVED_SERVER = PROP_TAG(PT_STRING8, pidProfileMin + 8)
+PR_PROFILE_BINDING_ORDER = PROP_TAG(PT_STRING8, pidProfileMin + 9)
+PR_PROFILE_MAX_RESTRICT = PROP_TAG(PT_LONG, pidProfileMin + 13)
+PR_PROFILE_AB_FILES_PATH = PROP_TAG(PT_STRING8, pidProfileMin + 14)
+PR_PROFILE_OFFLINE_STORE_PATH = PROP_TAG(PT_STRING8, pidProfileMin + 16)
+PR_PROFILE_OFFLINE_INFO = PROP_TAG(PT_BINARY, pidProfileMin + 17)
+PR_PROFILE_ADDR_INFO = PROP_TAG(PT_BINARY, pidSpecialMin + 23)
+PR_PROFILE_OPTIONS_DATA = PROP_TAG(PT_BINARY, pidSpecialMin + 25)
+PR_PROFILE_SECURE_MAILBOX = PROP_TAG(PT_BINARY, pidSecureProfileMin + 0)
+PR_DISABLE_WINSOCK = PROP_TAG(PT_LONG, pidProfileMin + 24)
+PR_OST_ENCRYPTION = PROP_TAG(PT_LONG, 26370)
+PR_PROFILE_OPEN_FLAGS = PROP_TAG(PT_LONG, pidProfileMin + 9)
+PR_PROFILE_TYPE = PROP_TAG(PT_LONG, pidProfileMin + 10)
+PR_PROFILE_MAILBOX = PROP_TAG(PT_STRING8, pidProfileMin + 11)
+PR_PROFILE_SERVER = PROP_TAG(PT_STRING8, pidProfileMin + 12)
+PR_PROFILE_SERVER_DN = PROP_TAG(PT_STRING8, pidProfileMin + 20)
+PR_PROFILE_FAVFLD_DISPLAY_NAME = PROP_TAG(PT_STRING8, pidProfileMin + 15)
+PR_PROFILE_FAVFLD_COMMENT = PROP_TAG(PT_STRING8, pidProfileMin + 21)
+PR_PROFILE_ALLPUB_DISPLAY_NAME = PROP_TAG(PT_STRING8, pidProfileMin + 22)
+PR_PROFILE_ALLPUB_COMMENT = PROP_TAG(PT_STRING8, pidProfileMin + 23)
+
+OSTF_NO_ENCRYPTION = -2147483648
+OSTF_COMPRESSABLE_ENCRYPTION = 1073741824
+OSTF_BEST_ENCRYPTION = 536870912
+
+
+PR_NON_IPM_SUBTREE_ENTRYID = PROP_TAG(PT_BINARY, pidStoreMin + 8)
+PR_EFORMS_REGISTRY_ENTRYID = PROP_TAG(PT_BINARY, pidStoreMin + 9)
+PR_SPLUS_FREE_BUSY_ENTRYID = PROP_TAG(PT_BINARY, pidStoreMin + 10)
+PR_OFFLINE_ADDRBOOK_ENTRYID = PROP_TAG(PT_BINARY, pidStoreMin + 11)
+PR_EFORMS_FOR_LOCALE_ENTRYID = PROP_TAG(PT_BINARY, pidStoreMin + 12)
+PR_FREE_BUSY_FOR_LOCAL_SITE_ENTRYID = PROP_TAG(PT_BINARY, pidStoreMin + 13)
+PR_ADDRBOOK_FOR_LOCAL_SITE_ENTRYID = PROP_TAG(PT_BINARY, pidStoreMin + 14)
+PR_OFFLINE_MESSAGE_ENTRYID = PROP_TAG(PT_BINARY, pidStoreMin + 15)
+PR_IPM_FAVORITES_ENTRYID = PROP_TAG(PT_BINARY, pidStoreMin + 24)
+PR_IPM_PUBLIC_FOLDERS_ENTRYID = PROP_TAG(PT_BINARY, pidStoreMin + 25)
+PR_GW_MTSIN_ENTRYID = PROP_TAG(PT_BINARY, pidStoreMin + 16)
+PR_GW_MTSOUT_ENTRYID = PROP_TAG(PT_BINARY, pidStoreMin + 17)
+PR_TRANSFER_ENABLED = PROP_TAG(PT_BOOLEAN, pidStoreMin + 18)
+PR_TEST_LINE_SPEED = PROP_TAG(PT_BINARY, pidStoreMin + 19)
+PR_HIERARCHY_SYNCHRONIZER = PROP_TAG(PT_OBJECT, pidStoreMin + 20)
+PR_CONTENTS_SYNCHRONIZER = PROP_TAG(PT_OBJECT, pidStoreMin + 21)
+PR_COLLECTOR = PROP_TAG(PT_OBJECT, pidStoreMin + 22)
+PR_FAST_TRANSFER = PROP_TAG(PT_OBJECT, pidStoreMin + 23)
+PR_STORE_OFFLINE = PROP_TAG(PT_BOOLEAN, pidStoreMin + 26)
+PR_IN_TRANSIT = PROP_TAG(PT_BOOLEAN, pidStoreMin)
+PR_REPLICATION_STYLE = PROP_TAG(PT_LONG, pidAdminMin)
+PR_REPLICATION_SCHEDULE = PROP_TAG(PT_BINARY, pidAdminMin + 1)
+PR_REPLICATION_MESSAGE_PRIORITY = PROP_TAG(PT_LONG, pidAdminMin + 2)
+PR_OVERALL_MSG_AGE_LIMIT = PROP_TAG(PT_LONG, pidAdminMin + 3)
+PR_REPLICATION_ALWAYS_INTERVAL = PROP_TAG(PT_LONG, pidAdminMin + 4)
+PR_REPLICATION_MSG_SIZE = PROP_TAG(PT_LONG, pidAdminMin + 5)
+STYLE_ALWAYS_INTERVAL_DEFAULT = 15
+REPLICATION_MESSAGE_SIZE_LIMIT_DEFAULT = 100
+STYLE_NEVER = 0
+STYLE_NORMAL = 1
+STYLE_ALWAYS = 2
+STYLE_DEFAULT = -1
+PR_SOURCE_KEY = PROP_TAG(PT_BINARY, pidExchangeNonXmitReservedMin + 0)
+PR_PARENT_SOURCE_KEY = PROP_TAG(PT_BINARY, pidExchangeNonXmitReservedMin + 1)
+PR_CHANGE_KEY = PROP_TAG(PT_BINARY, pidExchangeNonXmitReservedMin + 2)
+PR_PREDECESSOR_CHANGE_LIST = PROP_TAG(PT_BINARY, pidExchangeNonXmitReservedMin + 3)
+PR_FOLDER_CHILD_COUNT = PROP_TAG(PT_LONG, pidFolderMin)
+PR_RIGHTS = PROP_TAG(PT_LONG, pidFolderMin + 1)
+PR_ACL_TABLE = PROP_TAG(PT_OBJECT, pidExchangeXmitReservedMin)
+PR_RULES_TABLE = PROP_TAG(PT_OBJECT, pidExchangeXmitReservedMin + 1)
+PR_HAS_RULES = PROP_TAG(PT_BOOLEAN, pidFolderMin + 2)
+PR_ADDRESS_BOOK_ENTRYID = PROP_TAG(PT_BINARY, pidFolderMin + 3)
+PR_ACL_DATA = PROP_TAG(PT_BINARY, pidExchangeXmitReservedMin)
+PR_RULES_DATA = PROP_TAG(PT_BINARY, pidExchangeXmitReservedMin + 1)
+PR_FOLDER_DESIGN_FLAGS = PROP_TAG(PT_LONG, pidExchangeXmitReservedMin + 2)
+PR_DESIGN_IN_PROGRESS = PROP_TAG(PT_BOOLEAN, pidExchangeXmitReservedMin + 4)
+PR_SECURE_ORIGINATION = PROP_TAG(PT_BOOLEAN, pidExchangeXmitReservedMin + 5)
+PR_PUBLISH_IN_ADDRESS_BOOK = PROP_TAG(PT_BOOLEAN, pidExchangeXmitReservedMin + 6)
+PR_RESOLVE_METHOD = PROP_TAG(PT_LONG, pidExchangeXmitReservedMin + 7)
+PR_ADDRESS_BOOK_DISPLAY_NAME = PROP_TAG(PT_TSTRING, pidExchangeXmitReservedMin + 8)
+PR_EFORMS_LOCALE_ID = PROP_TAG(PT_LONG, pidExchangeXmitReservedMin + 9)
+PR_REPLICA_LIST = PROP_TAG(PT_BINARY, pidAdminMin + 8)
+PR_OVERALL_AGE_LIMIT = PROP_TAG(PT_LONG, pidAdminMin + 9)
+RESOLVE_METHOD_DEFAULT = 0
+RESOLVE_METHOD_LAST_WRITER_WINS = 1
+RESOLVE_METHOD_NO_CONFLICT_NOTIFICATION = 2
+PR_PUBLIC_FOLDER_ENTRYID = PROP_TAG(PT_BINARY, pidFolderMin + 4)
+PR_HAS_NAMED_PROPERTIES = PROP_TAG(PT_BOOLEAN, pidMessageReadOnlyMin + 10)
+PR_CREATOR_NAME = PROP_TAG(PT_TSTRING, pidExchangeXmitReservedMin + 24)
+PR_CREATOR_ENTRYID = PROP_TAG(PT_BINARY, pidExchangeXmitReservedMin + 25)
+PR_LAST_MODIFIER_NAME = PROP_TAG(PT_TSTRING, pidExchangeXmitReservedMin + 26)
+PR_LAST_MODIFIER_ENTRYID = PROP_TAG(PT_BINARY, pidExchangeXmitReservedMin + 27)
+PR_HAS_DAMS = PROP_TAG(PT_BOOLEAN, pidExchangeXmitReservedMin + 10)
+PR_RULE_TRIGGER_HISTORY = PROP_TAG(PT_BINARY, pidExchangeXmitReservedMin + 18)
+PR_MOVE_TO_STORE_ENTRYID = PROP_TAG(PT_BINARY, pidExchangeXmitReservedMin + 19)
+PR_MOVE_TO_FOLDER_ENTRYID = PROP_TAG(PT_BINARY, pidExchangeXmitReservedMin + 20)
+PR_REPLICA_SERVER = PROP_TAG(PT_TSTRING, pidMessageReadOnlyMin + 4)
+PR_DEFERRED_SEND_NUMBER = PROP_TAG(PT_LONG, pidExchangeXmitReservedMin + 11)
+PR_DEFERRED_SEND_UNITS = PROP_TAG(PT_LONG, pidExchangeXmitReservedMin + 12)
+PR_EXPIRY_NUMBER = PROP_TAG(PT_LONG, pidExchangeXmitReservedMin + 13)
+PR_EXPIRY_UNITS = PROP_TAG(PT_LONG, pidExchangeXmitReservedMin + 14)
+PR_DEFERRED_SEND_TIME = PROP_TAG(PT_SYSTIME, pidExchangeXmitReservedMin + 15)
+PR_GW_ADMIN_OPERATIONS = PROP_TAG(PT_LONG, pidMessageWriteableMin)
+PR_P1_CONTENT = PROP_TAG(PT_BINARY, 4352)
+PR_P1_CONTENT_TYPE = PROP_TAG(PT_BINARY, 4353)
+PR_CLIENT_ACTIONS = PROP_TAG(PT_BINARY, pidMessageReadOnlyMin + 5)
+PR_DAM_ORIGINAL_ENTRYID = PROP_TAG(PT_BINARY, pidMessageReadOnlyMin + 6)
+PR_DAM_BACK_PATCHED = PROP_TAG(PT_BOOLEAN, pidMessageReadOnlyMin + 7)
+PR_RULE_ERROR = PROP_TAG(PT_LONG, pidMessageReadOnlyMin + 8)
+PR_RULE_ACTION_TYPE = PROP_TAG(PT_LONG, pidMessageReadOnlyMin + 9)
+PR_RULE_ACTION_NUMBER = PROP_TAG(PT_LONG, pidMessageReadOnlyMin + 16)
+PR_RULE_FOLDER_ENTRYID = PROP_TAG(PT_BINARY, pidMessageReadOnlyMin + 17)
+PR_CONFLICT_ENTRYID = PROP_TAG(PT_BINARY, pidExchangeXmitReservedMin + 16)
+PR_MESSAGE_LOCALE_ID = PROP_TAG(PT_LONG, pidExchangeXmitReservedMin + 17)
+PR_STORAGE_QUOTA_LIMIT = PROP_TAG(PT_LONG, pidExchangeXmitReservedMin + 21)
+PR_EXCESS_STORAGE_USED = PROP_TAG(PT_LONG, pidExchangeXmitReservedMin + 22)
+PR_SVR_GENERATING_QUOTA_MSG = PROP_TAG(PT_TSTRING, pidExchangeXmitReservedMin + 23)
+PR_DELEGATED_BY_RULE = PROP_TAG(PT_BOOLEAN, pidExchangeXmitReservedMin + 3)
+MSGSTATUS_IN_CONFLICT = 2048
+PR_IN_CONFLICT = PROP_TAG(PT_BOOLEAN, pidAttachReadOnlyMin)
+PR_LONGTERM_ENTRYID_FROM_TABLE = PROP_TAG(PT_BINARY, pidSpecialMin)
+PR_ORIGINATOR_NAME = PROP_TAG(PT_TSTRING, pidMessageWriteableMin + 3)
+PR_ORIGINATOR_ADDR = PROP_TAG(PT_TSTRING, pidMessageWriteableMin + 4)
+PR_ORIGINATOR_ADDRTYPE = PROP_TAG(PT_TSTRING, pidMessageWriteableMin + 5)
+PR_ORIGINATOR_ENTRYID = PROP_TAG(PT_BINARY, pidMessageWriteableMin + 6)
+PR_ARRIVAL_TIME = PROP_TAG(PT_SYSTIME, pidMessageWriteableMin + 7)
+PR_TRACE_INFO = PROP_TAG(PT_BINARY, pidMessageWriteableMin + 8)
+PR_INTERNAL_TRACE_INFO = PROP_TAG(PT_BINARY, pidMessageWriteableMin + 18)
+PR_SUBJECT_TRACE_INFO = PROP_TAG(PT_BINARY, pidMessageWriteableMin + 9)
+PR_RECIPIENT_NUMBER = PROP_TAG(PT_LONG, pidMessageWriteableMin + 10)
+PR_MTS_SUBJECT_ID = PROP_TAG(PT_BINARY, pidMessageWriteableMin + 11)
+PR_REPORT_DESTINATION_NAME = PROP_TAG(PT_TSTRING, pidMessageWriteableMin + 12)
+PR_REPORT_DESTINATION_ENTRYID = PROP_TAG(PT_BINARY, pidMessageWriteableMin + 13)
+PR_CONTENT_SEARCH_KEY = PROP_TAG(PT_BINARY, pidMessageWriteableMin + 14)
+PR_FOREIGN_ID = PROP_TAG(PT_BINARY, pidMessageWriteableMin + 15)
+PR_FOREIGN_REPORT_ID = PROP_TAG(PT_BINARY, pidMessageWriteableMin + 16)
+PR_FOREIGN_SUBJECT_ID = PROP_TAG(PT_BINARY, pidMessageWriteableMin + 17)
+PR_MTS_ID = PR_MESSAGE_SUBMISSION_ID
+PR_MTS_REPORT_ID = PR_MESSAGE_SUBMISSION_ID
+
+PR_FOLDER_FLAGS = PROP_TAG(PT_LONG, pidAdminMin + 24)
+PR_LAST_ACCESS_TIME = PROP_TAG(PT_SYSTIME, pidAdminMin + 25)
+PR_RESTRICTION_COUNT = PROP_TAG(PT_LONG, pidAdminMin + 26)
+PR_CATEG_COUNT = PROP_TAG(PT_LONG, pidAdminMin + 27)
+PR_CACHED_COLUMN_COUNT = PROP_TAG(PT_LONG, pidAdminMin + 28)
+PR_NORMAL_MSG_W_ATTACH_COUNT = PROP_TAG(PT_LONG, pidAdminMin + 29)
+PR_ASSOC_MSG_W_ATTACH_COUNT = PROP_TAG(PT_LONG, pidAdminMin + 30)
+PR_RECIPIENT_ON_NORMAL_MSG_COUNT = PROP_TAG(PT_LONG, pidAdminMin + 31)
+PR_RECIPIENT_ON_ASSOC_MSG_COUNT = PROP_TAG(PT_LONG, pidAdminMin + 32)
+PR_ATTACH_ON_NORMAL_MSG_COUNT = PROP_TAG(PT_LONG, pidAdminMin + 33)
+PR_ATTACH_ON_ASSOC_MSG_COUNT = PROP_TAG(PT_LONG, pidAdminMin + 34)
+PR_NORMAL_MESSAGE_SIZE = PROP_TAG(PT_LONG, pidAdminMin + 35)
+PR_NORMAL_MESSAGE_SIZE_EXTENDED = PROP_TAG(PT_I8, pidAdminMin + 35)
+PR_ASSOC_MESSAGE_SIZE = PROP_TAG(PT_LONG, pidAdminMin + 36)
+PR_ASSOC_MESSAGE_SIZE_EXTENDED = PROP_TAG(PT_I8, pidAdminMin + 36)
+PR_FOLDER_PATHNAME = PROP_TAG(PT_TSTRING, pidAdminMin + 37)
+PR_OWNER_COUNT = PROP_TAG(PT_LONG, pidAdminMin + 38)
+PR_CONTACT_COUNT = PROP_TAG(PT_LONG, pidAdminMin + 39)
+
+PR_MESSAGE_SIZE_EXTENDED = PROP_TAG(PT_I8, PROP_ID(PR_MESSAGE_SIZE))
+
+PR_USERFIELDS = PROP_TAG(PT_BINARY, 0x36E3)
+
+# IExchangeManageStoreEx::CreateStoreEntryID2
+PR_FORCE_USE_ENTRYID_SERVER = PROP_TAG(PT_BOOLEAN, 0x7CFE)
+PR_PROFILE_MDB_DN = PROP_TAG(PT_STRING8, 0x7CFF)
+
+# MSPST.h
+PST_EXTERN_PROPID_BASE = 0x6700
+PR_PST_PATH = PROP_TAG(PT_STRING8, PST_EXTERN_PROPID_BASE + 0)
+PR_PST_PATH_W = PROP_TAG(PT_UNICODE, PST_EXTERN_PROPID_BASE + 0)
+PR_PST_PATH_A = PROP_TAG(PT_STRING8, PST_EXTERN_PROPID_BASE + 0)
+PR_PST_REMEMBER_PW = PROP_TAG(PT_BOOLEAN, PST_EXTERN_PROPID_BASE + 1)
+PR_PST_ENCRYPTION = PROP_TAG(PT_LONG, PST_EXTERN_PROPID_BASE + 2)
+PR_PST_PW_SZ_OLD = PROP_TAG(PT_STRING8, PST_EXTERN_PROPID_BASE + 3)
+PR_PST_PW_SZ_OLD_W = PROP_TAG(PT_UNICODE, PST_EXTERN_PROPID_BASE + 3)
+PR_PST_PW_SZ_OLD_A = PROP_TAG(PT_STRING8, PST_EXTERN_PROPID_BASE + 3)
+PR_PST_PW_SZ_NEW = PROP_TAG(PT_STRING8, PST_EXTERN_PROPID_BASE + 4)
+PR_PST_PW_SZ_NEW_W = PROP_TAG(PT_UNICODE, PST_EXTERN_PROPID_BASE + 4)
+PR_PST_PW_SZ_NEW_A = PROP_TAG(PT_STRING8, PST_EXTERN_PROPID_BASE + 4)
diff --git a/lib/win32comext/mapi/mapiutil.py b/lib/win32comext/mapi/mapiutil.py
new file mode 100644
index 00000000..ab89e6ad
--- /dev/null
+++ b/lib/win32comext/mapi/mapiutil.py
@@ -0,0 +1,217 @@
+# General utilities for MAPI and MAPI objects.
+# We used to use these old names from the 'types' module...
+TupleType = tuple
+ListType = list
+IntType = int
+import pythoncom
+from pywintypes import TimeType
+
+from . import mapi, mapitags
+
+prTable = {}
+
+
+def GetPropTagName(pt):
+    if not prTable:
+        for name, value in mapitags.__dict__.items():
+            if name[:3] == "PR_":
+                # Store both the full ID (including type) and just the ID.
+                # This is so PR_FOO_A and PR_FOO_W are still differentiated,
+                # but should we get a PT_FOO with PT_ERROR set, we fallback
+                # to the ID.
+
+                # String types should have 3 definitions in mapitags.py
+                # PR_BODY	= PROP_TAG( PT_TSTRING,	4096)
+                # PR_BODY_W	= PROP_TAG( PT_UNICODE, 4096)
+                # PR_BODY_A	= PROP_TAG( PT_STRING8, 4096)
+                # The following change ensures a lookup using only the the
+                # property id returns the conditional default.
+
+                # PT_TSTRING is a conditional assignment for either PT_UNICODE or
+                # PT_STRING8 and should not be returned during a lookup.
+
+                if (
+                    mapitags.PROP_TYPE(value) == mapitags.PT_UNICODE
+                    or mapitags.PROP_TYPE(value) == mapitags.PT_STRING8
+                ):
+                    if name[-2:] == "_A" or name[-2:] == "_W":
+                        prTable[value] = name
+                    else:
+                        prTable[mapitags.PROP_ID(value)] = name
+
+                else:
+                    prTable[value] = name
+                    prTable[mapitags.PROP_ID(value)] = name
+
+    try:
+        try:
+            return prTable[pt]
+        except KeyError:
+            # Can't find it exactly - see if the raw ID exists.
+            return prTable[mapitags.PROP_ID(pt)]
+    except KeyError:
+        # god-damn bullshit hex() warnings: I don't see a way to get the
+        # old behaviour without a warning!!
+        ret = hex(int(pt))
+        # -0x8000000L -> 0x80000000
+        if ret[0] == "-":
+            ret = ret[1:]
+        if ret[-1] == "L":
+            ret = ret[:-1]
+        return ret
+
+
+mapiErrorTable = {}
+
+
+def GetScodeString(hr):
+    if not mapiErrorTable:
+        for name, value in mapi.__dict__.items():
+            if name[:7] in ["MAPI_E_", "MAPI_W_"]:
+                mapiErrorTable[value] = name
+    return mapiErrorTable.get(hr, pythoncom.GetScodeString(hr))
+
+
+ptTable = {}
+
+
+def GetMapiTypeName(propType, rawType=True):
+    """Given a mapi type flag, return a string description of the type"""
+    if not ptTable:
+        for name, value in mapitags.__dict__.items():
+            if name[:3] == "PT_":
+                # PT_TSTRING is a conditional assignment
+                # for either PT_UNICODE or PT_STRING8 and
+                # should not be returned during a lookup.
+                if name in ["PT_TSTRING", "PT_MV_TSTRING"]:
+                    continue
+                ptTable[value] = name
+
+    if rawType:
+        propType = propType & ~mapitags.MV_FLAG
+    return ptTable.get(propType, str(hex(propType)))
+
+
+def GetProperties(obj, propList):
+    """Given a MAPI object and a list of properties, return a list of property values.
+
+    Allows a single property to be passed, and the result is a single object.
+
+    Each request property can be an integer or a string.  Of a string, it is
+    automatically converted to an integer via the GetIdsFromNames function.
+
+    If the property fetch fails, the result is None.
+    """
+    bRetList = 1
+    if type(propList) not in [TupleType, ListType]:
+        bRetList = 0
+        propList = (propList,)
+    realPropList = []
+    rc = []
+    for prop in propList:
+        if type(prop) != IntType:  # Integer
+            props = ((mapi.PS_PUBLIC_STRINGS, prop),)
+            propIds = obj.GetIDsFromNames(props, 0)
+            prop = mapitags.PROP_TAG(
+                mapitags.PT_UNSPECIFIED, mapitags.PROP_ID(propIds[0])
+            )
+        realPropList.append(prop)
+
+    hr, data = obj.GetProps(realPropList, 0)
+    if hr != 0:
+        data = None
+        return None
+    if bRetList:
+        return [v[1] for v in data]
+    else:
+        return data[0][1]
+
+
+def GetAllProperties(obj, make_tag_names=True):
+    tags = obj.GetPropList(0)
+    hr, data = obj.GetProps(tags)
+    ret = []
+    for tag, val in data:
+        if make_tag_names:
+            hr, tags, array = obj.GetNamesFromIDs((tag,))
+            if type(array[0][1]) == type(""):
+                name = array[0][1]
+            else:
+                name = GetPropTagName(tag)
+        else:
+            name = tag
+        ret.append((name, val))
+    return ret
+
+
+_MapiTypeMap = {
+    type(0.0): mapitags.PT_DOUBLE,
+    type(0): mapitags.PT_I4,
+    type("".encode("ascii")): mapitags.PT_STRING8,  # bytes
+    type(""): mapitags.PT_UNICODE,  # str
+    type(None): mapitags.PT_UNSPECIFIED,
+    # In Python 2.2.2, bool isn't a distinct type (type(1==1) is type(0)).
+    # (markh thinks the above is trying to say that in 2020, we probably *do*
+    # want bool in this map? :)
+}
+
+
+def SetPropertyValue(obj, prop, val):
+    if type(prop) != IntType:
+        props = ((mapi.PS_PUBLIC_STRINGS, prop),)
+        propIds = obj.GetIDsFromNames(props, mapi.MAPI_CREATE)
+        if val == (1 == 1) or val == (1 == 0):
+            type_tag = mapitags.PT_BOOLEAN
+        else:
+            type_tag = _MapiTypeMap.get(type(val))
+            if type_tag is None:
+                raise ValueError(
+                    "Don't know what to do with '%r' ('%s')" % (val, type(val))
+                )
+        prop = mapitags.PROP_TAG(type_tag, mapitags.PROP_ID(propIds[0]))
+    if val is None:
+        # Delete the property
+        obj.DeleteProps((prop,))
+    else:
+        obj.SetProps(((prop, val),))
+
+
+def SetProperties(msg, propDict):
+    """Given a Python dictionary, set the objects properties.
+
+    If the dictionary key is a string, then a property ID is queried
+    otherwise the ID is assumed native.
+
+    Coded for maximum efficiency wrt server calls - ie, maximum of
+    2 calls made to the object, regardless of the dictionary contents
+    (only 1 if dictionary full of int keys)
+    """
+
+    newProps = []
+    # First pass over the properties we should get IDs for.
+    for key, val in propDict.items():
+        if type(key) == str:
+            newProps.append((mapi.PS_PUBLIC_STRINGS, key))
+    # Query for the new IDs
+    if newProps:
+        newIds = msg.GetIDsFromNames(newProps, mapi.MAPI_CREATE)
+    newIdNo = 0
+    newProps = []
+    for key, val in propDict.items():
+        if type(key) == str:
+            type_val = type(val)
+            if type_val == str:
+                tagType = mapitags.PT_UNICODE
+            elif type_val == IntType:
+                tagType = mapitags.PT_I4
+            elif type_val == TimeType:
+                tagType = mapitags.PT_SYSTIME
+            else:
+                raise ValueError(
+                    "The type of object %s(%s) can not be written"
+                    % (repr(val), type_val)
+                )
+            key = mapitags.PROP_TAG(tagType, mapitags.PROP_ID(newIds[newIdNo]))
+            newIdNo = newIdNo + 1
+        newProps.append((key, val))
+    msg.SetProps(newProps)
diff --git a/lib/win32comext/propsys/__init__.py b/lib/win32comext/propsys/__init__.py
new file mode 100644
index 00000000..7e28f9b6
--- /dev/null
+++ b/lib/win32comext/propsys/__init__.py
@@ -0,0 +1 @@
+# this is a python package
diff --git a/lib/win32comext/propsys/propsys.pyd b/lib/win32comext/propsys/propsys.pyd
new file mode 100644
index 0000000000000000000000000000000000000000..7a5f62e08680b2f6a48d0280b134decac12d3d2a
GIT binary patch
literal 138752
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

literal 0
HcmV?d00001

diff --git a/lib/win32comext/propsys/pscon.py b/lib/win32comext/propsys/pscon.py
new file mode 100644
index 00000000..5aac4045
--- /dev/null
+++ b/lib/win32comext/propsys/pscon.py
@@ -0,0 +1,838 @@
+# hand generated from propsys.h
+
+## PROPENUMTYPE, used with IPropertyEnumType
+PET_DISCRETEVALUE = 0
+PET_RANGEDVALUE = 1
+PET_DEFAULTVALUE = 2
+PET_ENDRANGE = 3
+
+PDTF_DEFAULT = 0
+PDTF_MULTIPLEVALUES = 0x1
+PDTF_ISINNATE = 0x2
+PDTF_ISGROUP = 0x4
+PDTF_CANGROUPBY = 0x8
+PDTF_CANSTACKBY = 0x10
+PDTF_ISTREEPROPERTY = 0x20
+PDTF_INCLUDEINFULLTEXTQUERY = 0x40
+PDTF_ISVIEWABLE = 0x80
+PDTF_ISQUERYABLE = 0x100
+PDTF_ISSYSTEMPROPERTY = 0x80000000
+PDTF_MASK_ALL = 0x800001FF
+
+PDVF_DEFAULT = 0
+PDVF_CENTERALIGN = 0x1
+PDVF_RIGHTALIGN = 0x2
+PDVF_BEGINNEWGROUP = 0x4
+PDVF_FILLAREA = 0x8
+PDVF_SORTDESCENDING = 0x10
+PDVF_SHOWONLYIFPRESENT = 0x20
+PDVF_SHOWBYDEFAULT = 0x40
+PDVF_SHOWINPRIMARYLIST = 0x80
+PDVF_SHOWINSECONDARYLIST = 0x100
+PDVF_HIDELABEL = 0x200
+PDVF_HIDDEN = 0x800
+PDVF_CANWRAP = 0x1000
+PDVF_MASK_ALL = 0x1BFF
+
+PDDT_STRING = 0
+PDDT_NUMBER = 1
+PDDT_BOOLEAN = 2
+PDDT_DATETIME = 3
+PDDT_ENUMERATED = 4
+
+PDGR_DISCRETE = 0
+PDGR_ALPHANUMERIC = 1
+PDGR_SIZE = 2
+PDGR_DYNAMIC = 3
+PDGR_DATE = 4
+PDGR_PERCENT = 5
+PDGR_ENUMERATED = 6
+
+## PROPDESC_FORMAT_FLAGS
+PDFF_DEFAULT = 0
+PDFF_PREFIXNAME = 0x1
+PDFF_FILENAME = 0x2
+PDFF_ALWAYSKB = 0x4
+PDFF_RESERVED_RIGHTTOLEFT = 0x8
+PDFF_SHORTTIME = 0x10
+PDFF_LONGTIME = 0x20
+PDFF_HIDETIME = 0x40
+PDFF_SHORTDATE = 0x80
+PDFF_LONGDATE = 0x100
+PDFF_HIDEDATE = 0x200
+PDFF_RELATIVEDATE = 0x400
+PDFF_USEEDITINVITATION = 0x800
+PDFF_READONLY = 0x1000
+PDFF_NOAUTOREADINGORDER = 0x2000
+
+PDSD_GENERAL = 0
+PDSD_A_Z = 1
+PDSD_LOWEST_HIGHEST = 2
+PDSD_SMALLEST_BIGGEST = 3
+PDSD_OLDEST_NEWEST = 4
+
+PDRDT_GENERAL = 0
+PDRDT_DATE = 1
+PDRDT_SIZE = 2
+PDRDT_COUNT = 3
+PDRDT_REVISION = 4
+PDRDT_LENGTH = 5
+PDRDT_DURATION = 6
+PDRDT_SPEED = 7
+PDRDT_RATE = 8
+PDRDT_RATING = 9
+PDRDT_PRIORITY = 10
+
+PDAT_DEFAULT = 0
+PDAT_FIRST = 1
+PDAT_SUM = 2
+PDAT_AVERAGE = 3
+PDAT_DATERANGE = 4
+PDAT_UNION = 5
+PDAT_MAX = 6
+PDAT_MIN = 7
+
+PDCOT_NONE = 0
+PDCOT_STRING = 1
+PDCOT_SIZE = 2
+PDCOT_DATETIME = 3
+PDCOT_BOOLEAN = 4
+PDCOT_NUMBER = 5
+
+PDSIF_DEFAULT = 0
+PDSIF_ININVERTEDINDEX = 0x1
+PDSIF_ISCOLUMN = 0x2
+PDSIF_ISCOLUMNSPARSE = 0x4
+PDCIT_NONE = 0
+PDCIT_ONDISK = 1
+PDCIT_INMEMORY = 2
+
+## PROPDESC_ENUMFILTER, used with IPropertySystem::EnumeratePropertyDescriptions
+PDEF_ALL = 0
+PDEF_SYSTEM = 1
+PDEF_NONSYSTEM = 2
+PDEF_VIEWABLE = 3
+PDEF_QUERYABLE = 4
+PDEF_INFULLTEXTQUERY = 5
+PDEF_COLUMN = 6
+
+## PSC_STATE, used with IPropertyStoreCache
+PSC_NORMAL = 0
+PSC_NOTINSOURCE = 1
+PSC_DIRTY = 2
+
+## CONDITION_OPERATION
+COP_IMPLICIT = 0
+COP_EQUAL = 1
+COP_NOTEQUAL = 2
+COP_LESSTHAN = 3
+COP_GREATERTHAN = 4
+COP_LESSTHANOREQUAL = 5
+COP_GREATERTHANOREQUAL = 6
+COP_VALUE_STARTSWITH = 7
+COP_VALUE_ENDSWITH = 8
+COP_VALUE_CONTAINS = 9
+COP_VALUE_NOTCONTAINS = 10
+COP_DOSWILDCARDS = 11
+COP_WORD_EQUAL = 12
+COP_WORD_STARTSWITH = 13
+COP_APPLICATION_SPECIFIC = 14
+
+## PERSIST_SPROPSTORE_FLAGS, used with IPersistSerializedPropStorage
+FPSPS_READONLY = 1
+
+PKEY_PIDSTR_MAX = 10  # will take care of any long integer value
+# define GUIDSTRING_MAX      (1 + 8 + 1 + 4 + 1 + 4 + 1 + 4 + 1 + 12 + 1 + 1)  // "{12345678-1234-1234-1234-123456789012}"
+GUIDSTRING_MAX = 1 + 8 + 1 + 4 + 1 + 4 + 1 + 4 + 1 + 12 + 1 + 1  # hrm ???
+# define PKEYSTR_MAX         (GUIDSTRING_MAX + 1 + PKEY_PIDSTR_MAX)
+PKEYSTR_MAX = GUIDSTRING_MAX + 1 + PKEY_PIDSTR_MAX
+
+## Property keys from propkey.h
+from pywintypes import IID
+
+PKEY_Audio_ChannelCount = (IID("{64440490-4C8B-11D1-8B70-080036B11A03}"), 7)
+PKEY_Audio_Compression = (IID("{64440490-4C8B-11D1-8B70-080036B11A03}"), 10)
+PKEY_Audio_EncodingBitrate = (IID("{64440490-4C8B-11D1-8B70-080036B11A03}"), 4)
+PKEY_Audio_Format = (IID("{64440490-4C8B-11D1-8B70-080036B11A03}"), 2)
+PKEY_Audio_IsVariableBitRate = (IID("{E6822FEE-8C17-4D62-823C-8E9CFCBD1D5C}"), 100)
+PKEY_Audio_PeakValue = (IID("{2579E5D0-1116-4084-BD9A-9B4F7CB4DF5E}"), 100)
+PKEY_Audio_SampleRate = (IID("{64440490-4C8B-11D1-8B70-080036B11A03}"), 5)
+PKEY_Audio_SampleSize = (IID("{64440490-4C8B-11D1-8B70-080036B11A03}"), 6)
+PKEY_Audio_StreamName = (IID("{64440490-4C8B-11D1-8B70-080036B11A03}"), 9)
+PKEY_Audio_StreamNumber = (IID("{64440490-4C8B-11D1-8B70-080036B11A03}"), 8)
+PKEY_Calendar_Duration = (IID("{293CA35A-09AA-4DD2-B180-1FE245728A52}"), 100)
+PKEY_Calendar_IsOnline = (IID("{BFEE9149-E3E2-49A7-A862-C05988145CEC}"), 100)
+PKEY_Calendar_IsRecurring = (IID("{315B9C8D-80A9-4EF9-AE16-8E746DA51D70}"), 100)
+PKEY_Calendar_Location = (IID("{F6272D18-CECC-40B1-B26A-3911717AA7BD}"), 100)
+PKEY_Calendar_OptionalAttendeeAddresses = (
+    IID("{D55BAE5A-3892-417A-A649-C6AC5AAAEAB3}"),
+    100,
+)
+PKEY_Calendar_OptionalAttendeeNames = (
+    IID("{09429607-582D-437F-84C3-DE93A2B24C3C}"),
+    100,
+)
+PKEY_Calendar_OrganizerAddress = (IID("{744C8242-4DF5-456C-AB9E-014EFB9021E3}"), 100)
+PKEY_Calendar_OrganizerName = (IID("{AAA660F9-9865-458E-B484-01BC7FE3973E}"), 100)
+PKEY_Calendar_ReminderTime = (IID("{72FC5BA4-24F9-4011-9F3F-ADD27AFAD818}"), 100)
+PKEY_Calendar_RequiredAttendeeAddresses = (
+    IID("{0BA7D6C3-568D-4159-AB91-781A91FB71E5}"),
+    100,
+)
+PKEY_Calendar_RequiredAttendeeNames = (
+    IID("{B33AF30B-F552-4584-936C-CB93E5CDA29F}"),
+    100,
+)
+PKEY_Calendar_Resources = (IID("{00F58A38-C54B-4C40-8696-97235980EAE1}"), 100)
+PKEY_Calendar_ShowTimeAs = (IID("{5BF396D4-5EB2-466F-BDE9-2FB3F2361D6E}"), 100)
+PKEY_Calendar_ShowTimeAsText = (IID("{53DA57CF-62C0-45C4-81DE-7610BCEFD7F5}"), 100)
+PKEY_Communication_AccountName = (IID("{E3E0584C-B788-4A5A-BB20-7F5A44C9ACDD}"), 9)
+PKEY_Communication_Suffix = (IID("{807B653A-9E91-43EF-8F97-11CE04EE20C5}"), 100)
+PKEY_Communication_TaskStatus = (IID("{BE1A72C6-9A1D-46B7-AFE7-AFAF8CEF4999}"), 100)
+PKEY_Communication_TaskStatusText = (IID("{A6744477-C237-475B-A075-54F34498292A}"), 100)
+PKEY_Computer_DecoratedFreeSpace = (IID("{9B174B35-40FF-11D2-A27E-00C04FC30871}"), 7)
+PKEY_Contact_Anniversary = (IID("{9AD5BADB-CEA7-4470-A03D-B84E51B9949E}"), 100)
+PKEY_Contact_AssistantName = (IID("{CD102C9C-5540-4A88-A6F6-64E4981C8CD1}"), 100)
+PKEY_Contact_AssistantTelephone = (IID("{9A93244D-A7AD-4FF8-9B99-45EE4CC09AF6}"), 100)
+PKEY_Contact_Birthday = (IID("{176DC63C-2688-4E89-8143-A347800F25E9}"), 47)
+PKEY_Contact_BusinessAddress = (IID("{730FB6DD-CF7C-426B-A03F-BD166CC9EE24}"), 100)
+PKEY_Contact_BusinessAddressCity = (IID("{402B5934-EC5A-48C3-93E6-85E86A2D934E}"), 100)
+PKEY_Contact_BusinessAddressCountry = (
+    IID("{B0B87314-FCF6-4FEB-8DFF-A50DA6AF561C}"),
+    100,
+)
+PKEY_Contact_BusinessAddressPostalCode = (
+    IID("{E1D4A09E-D758-4CD1-B6EC-34A8B5A73F80}"),
+    100,
+)
+PKEY_Contact_BusinessAddressPostOfficeBox = (
+    IID("{BC4E71CE-17F9-48D5-BEE9-021DF0EA5409}"),
+    100,
+)
+PKEY_Contact_BusinessAddressState = (IID("{446F787F-10C4-41CB-A6C4-4D0343551597}"), 100)
+PKEY_Contact_BusinessAddressStreet = (
+    IID("{DDD1460F-C0BF-4553-8CE4-10433C908FB0}"),
+    100,
+)
+PKEY_Contact_BusinessFaxNumber = (IID("{91EFF6F3-2E27-42CA-933E-7C999FBE310B}"), 100)
+PKEY_Contact_BusinessHomePage = (IID("{56310920-2491-4919-99CE-EADB06FAFDB2}"), 100)
+PKEY_Contact_BusinessTelephone = (IID("{6A15E5A0-0A1E-4CD7-BB8C-D2F1B0C929BC}"), 100)
+PKEY_Contact_CallbackTelephone = (IID("{BF53D1C3-49E0-4F7F-8567-5A821D8AC542}"), 100)
+PKEY_Contact_CarTelephone = (IID("{8FDC6DEA-B929-412B-BA90-397A257465FE}"), 100)
+PKEY_Contact_Children = (IID("{D4729704-8EF1-43EF-9024-2BD381187FD5}"), 100)
+PKEY_Contact_CompanyMainTelephone = (IID("{8589E481-6040-473D-B171-7FA89C2708ED}"), 100)
+PKEY_Contact_Department = (IID("{FC9F7306-FF8F-4D49-9FB6-3FFE5C0951EC}"), 100)
+PKEY_Contact_EmailAddress = (IID("{F8FA7FA3-D12B-4785-8A4E-691A94F7A3E7}"), 100)
+PKEY_Contact_EmailAddress2 = (IID("{38965063-EDC8-4268-8491-B7723172CF29}"), 100)
+PKEY_Contact_EmailAddress3 = (IID("{644D37B4-E1B3-4BAD-B099-7E7C04966ACA}"), 100)
+PKEY_Contact_EmailAddresses = (IID("{84D8F337-981D-44B3-9615-C7596DBA17E3}"), 100)
+PKEY_Contact_EmailName = (IID("{CC6F4F24-6083-4BD4-8754-674D0DE87AB8}"), 100)
+PKEY_Contact_FileAsName = (IID("{F1A24AA7-9CA7-40F6-89EC-97DEF9FFE8DB}"), 100)
+PKEY_Contact_FirstName = (IID("{14977844-6B49-4AAD-A714-A4513BF60460}"), 100)
+PKEY_Contact_FullName = (IID("{635E9051-50A5-4BA2-B9DB-4ED056C77296}"), 100)
+PKEY_Contact_Gender = (IID("{3C8CEE58-D4F0-4CF9-B756-4E5D24447BCD}"), 100)
+PKEY_Contact_Hobbies = (IID("{5DC2253F-5E11-4ADF-9CFE-910DD01E3E70}"), 100)
+PKEY_Contact_HomeAddress = (IID("{98F98354-617A-46B8-8560-5B1B64BF1F89}"), 100)
+PKEY_Contact_HomeAddressCity = (IID("{176DC63C-2688-4E89-8143-A347800F25E9}"), 65)
+PKEY_Contact_HomeAddressCountry = (IID("{08A65AA1-F4C9-43DD-9DDF-A33D8E7EAD85}"), 100)
+PKEY_Contact_HomeAddressPostalCode = (
+    IID("{8AFCC170-8A46-4B53-9EEE-90BAE7151E62}"),
+    100,
+)
+PKEY_Contact_HomeAddressPostOfficeBox = (
+    IID("{7B9F6399-0A3F-4B12-89BD-4ADC51C918AF}"),
+    100,
+)
+PKEY_Contact_HomeAddressState = (IID("{C89A23D0-7D6D-4EB8-87D4-776A82D493E5}"), 100)
+PKEY_Contact_HomeAddressStreet = (IID("{0ADEF160-DB3F-4308-9A21-06237B16FA2A}"), 100)
+PKEY_Contact_HomeFaxNumber = (IID("{660E04D6-81AB-4977-A09F-82313113AB26}"), 100)
+PKEY_Contact_HomeTelephone = (IID("{176DC63C-2688-4E89-8143-A347800F25E9}"), 20)
+PKEY_Contact_IMAddress = (IID("{D68DBD8A-3374-4B81-9972-3EC30682DB3D}"), 100)
+PKEY_Contact_Initials = (IID("{F3D8F40D-50CB-44A2-9718-40CB9119495D}"), 100)
+PKEY_Contact_JA_CompanyNamePhonetic = (IID("{897B3694-FE9E-43E6-8066-260F590C0100}"), 2)
+PKEY_Contact_JA_FirstNamePhonetic = (IID("{897B3694-FE9E-43E6-8066-260F590C0100}"), 3)
+PKEY_Contact_JA_LastNamePhonetic = (IID("{897B3694-FE9E-43E6-8066-260F590C0100}"), 4)
+PKEY_Contact_JobTitle = (IID("{176DC63C-2688-4E89-8143-A347800F25E9}"), 6)
+PKEY_Contact_Label = (IID("{97B0AD89-DF49-49CC-834E-660974FD755B}"), 100)
+PKEY_Contact_LastName = (IID("{8F367200-C270-457C-B1D4-E07C5BCD90C7}"), 100)
+PKEY_Contact_MailingAddress = (IID("{C0AC206A-827E-4650-95AE-77E2BB74FCC9}"), 100)
+PKEY_Contact_MiddleName = (IID("{176DC63C-2688-4E89-8143-A347800F25E9}"), 71)
+PKEY_Contact_MobileTelephone = (IID("{176DC63C-2688-4E89-8143-A347800F25E9}"), 35)
+PKEY_Contact_NickName = (IID("{176DC63C-2688-4E89-8143-A347800F25E9}"), 74)
+PKEY_Contact_OfficeLocation = (IID("{176DC63C-2688-4E89-8143-A347800F25E9}"), 7)
+PKEY_Contact_OtherAddress = (IID("{508161FA-313B-43D5-83A1-C1ACCF68622C}"), 100)
+PKEY_Contact_OtherAddressCity = (IID("{6E682923-7F7B-4F0C-A337-CFCA296687BF}"), 100)
+PKEY_Contact_OtherAddressCountry = (IID("{8F167568-0AAE-4322-8ED9-6055B7B0E398}"), 100)
+PKEY_Contact_OtherAddressPostalCode = (
+    IID("{95C656C1-2ABF-4148-9ED3-9EC602E3B7CD}"),
+    100,
+)
+PKEY_Contact_OtherAddressPostOfficeBox = (
+    IID("{8B26EA41-058F-43F6-AECC-4035681CE977}"),
+    100,
+)
+PKEY_Contact_OtherAddressState = (IID("{71B377D6-E570-425F-A170-809FAE73E54E}"), 100)
+PKEY_Contact_OtherAddressStreet = (IID("{FF962609-B7D6-4999-862D-95180D529AEA}"), 100)
+PKEY_Contact_PagerTelephone = (IID("{D6304E01-F8F5-4F45-8B15-D024A6296789}"), 100)
+PKEY_Contact_PersonalTitle = (IID("{176DC63C-2688-4E89-8143-A347800F25E9}"), 69)
+PKEY_Contact_PrimaryAddressCity = (IID("{C8EA94F0-A9E3-4969-A94B-9C62A95324E0}"), 100)
+PKEY_Contact_PrimaryAddressCountry = (
+    IID("{E53D799D-0F3F-466E-B2FF-74634A3CB7A4}"),
+    100,
+)
+PKEY_Contact_PrimaryAddressPostalCode = (
+    IID("{18BBD425-ECFD-46EF-B612-7B4A6034EDA0}"),
+    100,
+)
+PKEY_Contact_PrimaryAddressPostOfficeBox = (
+    IID("{DE5EF3C7-46E1-484E-9999-62C5308394C1}"),
+    100,
+)
+PKEY_Contact_PrimaryAddressState = (IID("{F1176DFE-7138-4640-8B4C-AE375DC70A6D}"), 100)
+PKEY_Contact_PrimaryAddressStreet = (IID("{63C25B20-96BE-488F-8788-C09C407AD812}"), 100)
+PKEY_Contact_PrimaryEmailAddress = (IID("{176DC63C-2688-4E89-8143-A347800F25E9}"), 48)
+PKEY_Contact_PrimaryTelephone = (IID("{176DC63C-2688-4E89-8143-A347800F25E9}"), 25)
+PKEY_Contact_Profession = (IID("{7268AF55-1CE4-4F6E-A41F-B6E4EF10E4A9}"), 100)
+PKEY_Contact_SpouseName = (IID("{9D2408B6-3167-422B-82B0-F583B7A7CFE3}"), 100)
+PKEY_Contact_Suffix = (IID("{176DC63C-2688-4E89-8143-A347800F25E9}"), 73)
+PKEY_Contact_TelexNumber = (IID("{C554493C-C1F7-40C1-A76C-EF8C0614003E}"), 100)
+PKEY_Contact_TTYTDDTelephone = (IID("{AAF16BAC-2B55-45E6-9F6D-415EB94910DF}"), 100)
+PKEY_Contact_WebPage = (IID("{E3E0584C-B788-4A5A-BB20-7F5A44C9ACDD}"), 18)
+PKEY_AcquisitionID = (IID("{65A98875-3C80-40AB-ABBC-EFDAF77DBEE2}"), 100)
+PKEY_ApplicationName = (IID("{F29F85E0-4FF9-1068-AB91-08002B27B3D9}"), 18)
+PKEY_Author = (IID("{F29F85E0-4FF9-1068-AB91-08002B27B3D9}"), 4)
+PKEY_Capacity = (IID("{9B174B35-40FF-11D2-A27E-00C04FC30871}"), 3)
+PKEY_Category = (IID("{D5CDD502-2E9C-101B-9397-08002B2CF9AE}"), 2)
+PKEY_Comment = (IID("{F29F85E0-4FF9-1068-AB91-08002B27B3D9}"), 6)
+PKEY_Company = (IID("{D5CDD502-2E9C-101B-9397-08002B2CF9AE}"), 15)
+PKEY_ComputerName = (IID("{28636AA6-953D-11D2-B5D6-00C04FD918D0}"), 5)
+PKEY_ContainedItems = (IID("{28636AA6-953D-11D2-B5D6-00C04FD918D0}"), 29)
+PKEY_ContentStatus = (IID("{D5CDD502-2E9C-101B-9397-08002B2CF9AE}"), 27)
+PKEY_ContentType = (IID("{D5CDD502-2E9C-101B-9397-08002B2CF9AE}"), 26)
+PKEY_Copyright = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 11)
+PKEY_DateAccessed = (IID("{B725F130-47EF-101A-A5F1-02608C9EEBAC}"), 16)
+PKEY_DateAcquired = (IID("{2CBAA8F5-D81F-47CA-B17A-F8D822300131}"), 100)
+PKEY_DateArchived = (IID("{43F8D7B7-A444-4F87-9383-52271C9B915C}"), 100)
+PKEY_DateCompleted = (IID("{72FAB781-ACDA-43E5-B155-B2434F85E678}"), 100)
+PKEY_DateCreated = (IID("{B725F130-47EF-101A-A5F1-02608C9EEBAC}"), 15)
+PKEY_DateImported = (IID("{14B81DA1-0135-4D31-96D9-6CBFC9671A99}"), 18258)
+PKEY_DateModified = (IID("{B725F130-47EF-101A-A5F1-02608C9EEBAC}"), 14)
+PKEY_DueDate = (IID("{3F8472B5-E0AF-4DB2-8071-C53FE76AE7CE}"), 100)
+PKEY_EndDate = (IID("{C75FAA05-96FD-49E7-9CB4-9F601082D553}"), 100)
+PKEY_FileAllocationSize = (IID("{B725F130-47EF-101A-A5F1-02608C9EEBAC}"), 18)
+PKEY_FileAttributes = (IID("{B725F130-47EF-101A-A5F1-02608C9EEBAC}"), 13)
+PKEY_FileCount = (IID("{28636AA6-953D-11D2-B5D6-00C04FD918D0}"), 12)
+PKEY_FileDescription = (IID("{0CEF7D53-FA64-11D1-A203-0000F81FEDEE}"), 3)
+PKEY_FileExtension = (IID("{E4F10A3C-49E6-405D-8288-A23BD4EEAA6C}"), 100)
+PKEY_FileFRN = (IID("{B725F130-47EF-101A-A5F1-02608C9EEBAC}"), 21)
+PKEY_FileName = (IID("{41CF5AE0-F75A-4806-BD87-59C7D9248EB9}"), 100)
+PKEY_FileOwner = (IID("{9B174B34-40FF-11D2-A27E-00C04FC30871}"), 4)
+PKEY_FileVersion = (IID("{0CEF7D53-FA64-11D1-A203-0000F81FEDEE}"), 4)
+PKEY_FindData = (IID("{28636AA6-953D-11D2-B5D6-00C04FD918D0}"), 0)
+PKEY_FlagColor = (IID("{67DF94DE-0CA7-4D6F-B792-053A3E4F03CF}"), 100)
+PKEY_FlagColorText = (IID("{45EAE747-8E2A-40AE-8CBF-CA52ABA6152A}"), 100)
+PKEY_FlagStatus = (IID("{E3E0584C-B788-4A5A-BB20-7F5A44C9ACDD}"), 12)
+PKEY_FlagStatusText = (IID("{DC54FD2E-189D-4871-AA01-08C2F57A4ABC}"), 100)
+PKEY_FreeSpace = (IID("{9B174B35-40FF-11D2-A27E-00C04FC30871}"), 2)
+PKEY_Identity = (IID("{A26F4AFC-7346-4299-BE47-EB1AE613139F}"), 100)
+PKEY_Importance = (IID("{E3E0584C-B788-4A5A-BB20-7F5A44C9ACDD}"), 11)
+PKEY_ImportanceText = (IID("{A3B29791-7713-4E1D-BB40-17DB85F01831}"), 100)
+PKEY_IsAttachment = (IID("{F23F425C-71A1-4FA8-922F-678EA4A60408}"), 100)
+PKEY_IsDeleted = (IID("{5CDA5FC8-33EE-4FF3-9094-AE7BD8868C4D}"), 100)
+PKEY_IsFlagged = (IID("{5DA84765-E3FF-4278-86B0-A27967FBDD03}"), 100)
+PKEY_IsFlaggedComplete = (IID("{A6F360D2-55F9-48DE-B909-620E090A647C}"), 100)
+PKEY_IsIncomplete = (IID("{346C8BD1-2E6A-4C45-89A4-61B78E8E700F}"), 100)
+PKEY_IsRead = (IID("{E3E0584C-B788-4A5A-BB20-7F5A44C9ACDD}"), 10)
+PKEY_IsSendToTarget = (IID("{28636AA6-953D-11D2-B5D6-00C04FD918D0}"), 33)
+PKEY_IsShared = (IID("{EF884C5B-2BFE-41BB-AAE5-76EEDF4F9902}"), 100)
+PKEY_ItemAuthors = (IID("{D0A04F0A-462A-48A4-BB2F-3706E88DBD7D}"), 100)
+PKEY_ItemDate = (IID("{F7DB74B4-4287-4103-AFBA-F1B13DCD75CF}"), 100)
+PKEY_ItemFolderNameDisplay = (IID("{B725F130-47EF-101A-A5F1-02608C9EEBAC}"), 2)
+PKEY_ItemFolderPathDisplay = (IID("{E3E0584C-B788-4A5A-BB20-7F5A44C9ACDD}"), 6)
+PKEY_ItemFolderPathDisplayNarrow = (IID("{DABD30ED-0043-4789-A7F8-D013A4736622}"), 100)
+PKEY_ItemName = (IID("{6B8DA074-3B5C-43BC-886F-0A2CDCE00B6F}"), 100)
+PKEY_ItemNameDisplay = (IID("{B725F130-47EF-101A-A5F1-02608C9EEBAC}"), 10)
+PKEY_ItemNamePrefix = (IID("{D7313FF1-A77A-401C-8C99-3DBDD68ADD36}"), 100)
+PKEY_ItemParticipants = (IID("{D4D0AA16-9948-41A4-AA85-D97FF9646993}"), 100)
+PKEY_ItemPathDisplay = (IID("{E3E0584C-B788-4A5A-BB20-7F5A44C9ACDD}"), 7)
+PKEY_ItemPathDisplayNarrow = (IID("{28636AA6-953D-11D2-B5D6-00C04FD918D0}"), 8)
+PKEY_ItemType = (IID("{28636AA6-953D-11D2-B5D6-00C04FD918D0}"), 11)
+PKEY_ItemTypeText = (IID("{B725F130-47EF-101A-A5F1-02608C9EEBAC}"), 4)
+PKEY_ItemUrl = (IID("{49691C90-7E17-101A-A91C-08002B2ECDA9}"), 9)
+PKEY_Keywords = (IID("{F29F85E0-4FF9-1068-AB91-08002B27B3D9}"), 5)
+PKEY_Kind = (IID("{1E3EE840-BC2B-476C-8237-2ACD1A839B22}"), 3)
+PKEY_KindText = (IID("{F04BEF95-C585-4197-A2B7-DF46FDC9EE6D}"), 100)
+PKEY_Language = (IID("{D5CDD502-2E9C-101B-9397-08002B2CF9AE}"), 28)
+PKEY_MileageInformation = (IID("{FDF84370-031A-4ADD-9E91-0D775F1C6605}"), 100)
+PKEY_MIMEType = (IID("{0B63E350-9CCC-11D0-BCDB-00805FCCCE04}"), 5)
+PKEY_Null = (IID("{00000000-0000-0000-0000-000000000000}"), 0)
+PKEY_OfflineAvailability = (IID("{A94688B6-7D9F-4570-A648-E3DFC0AB2B3F}"), 100)
+PKEY_OfflineStatus = (IID("{6D24888F-4718-4BDA-AFED-EA0FB4386CD8}"), 100)
+PKEY_OriginalFileName = (IID("{0CEF7D53-FA64-11D1-A203-0000F81FEDEE}"), 6)
+PKEY_ParentalRating = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 21)
+PKEY_ParentalRatingReason = (IID("{10984E0A-F9F2-4321-B7EF-BAF195AF4319}"), 100)
+PKEY_ParentalRatingsOrganization = (IID("{A7FE0840-1344-46F0-8D37-52ED712A4BF9}"), 100)
+PKEY_ParsingBindContext = (IID("{DFB9A04D-362F-4CA3-B30B-0254B17B5B84}"), 100)
+PKEY_ParsingName = (IID("{28636AA6-953D-11D2-B5D6-00C04FD918D0}"), 24)
+PKEY_ParsingPath = (IID("{28636AA6-953D-11D2-B5D6-00C04FD918D0}"), 30)
+PKEY_PerceivedType = (IID("{28636AA6-953D-11D2-B5D6-00C04FD918D0}"), 9)
+PKEY_PercentFull = (IID("{9B174B35-40FF-11D2-A27E-00C04FC30871}"), 5)
+PKEY_Priority = (IID("{9C1FCF74-2D97-41BA-B4AE-CB2E3661A6E4}"), 5)
+PKEY_PriorityText = (IID("{D98BE98B-B86B-4095-BF52-9D23B2E0A752}"), 100)
+PKEY_Project = (IID("{39A7F922-477C-48DE-8BC8-B28441E342E3}"), 100)
+PKEY_ProviderItemID = (IID("{F21D9941-81F0-471A-ADEE-4E74B49217ED}"), 100)
+PKEY_Rating = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 9)
+PKEY_RatingText = (IID("{90197CA7-FD8F-4E8C-9DA3-B57E1E609295}"), 100)
+PKEY_Sensitivity = (IID("{F8D3F6AC-4874-42CB-BE59-AB454B30716A}"), 100)
+PKEY_SensitivityText = (IID("{D0C7F054-3F72-4725-8527-129A577CB269}"), 100)
+PKEY_SFGAOFlags = (IID("{28636AA6-953D-11D2-B5D6-00C04FD918D0}"), 25)
+PKEY_SharedWith = (IID("{EF884C5B-2BFE-41BB-AAE5-76EEDF4F9902}"), 200)
+PKEY_ShareUserRating = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 12)
+PKEY_Shell_OmitFromView = (IID("{DE35258C-C695-4CBC-B982-38B0AD24CED0}"), 2)
+PKEY_SimpleRating = (IID("{A09F084E-AD41-489F-8076-AA5BE3082BCA}"), 100)
+PKEY_Size = (IID("{B725F130-47EF-101A-A5F1-02608C9EEBAC}"), 12)
+PKEY_SoftwareUsed = (IID("{14B81DA1-0135-4D31-96D9-6CBFC9671A99}"), 305)
+PKEY_SourceItem = (IID("{668CDFA5-7A1B-4323-AE4B-E527393A1D81}"), 100)
+PKEY_StartDate = (IID("{48FD6EC8-8A12-4CDF-A03E-4EC5A511EDDE}"), 100)
+PKEY_Status = (IID("{000214A1-0000-0000-C000-000000000046}"), 9)
+PKEY_Subject = (IID("{F29F85E0-4FF9-1068-AB91-08002B27B3D9}"), 3)
+PKEY_Thumbnail = (IID("{F29F85E0-4FF9-1068-AB91-08002B27B3D9}"), 17)
+PKEY_ThumbnailCacheId = (IID("{446D16B1-8DAD-4870-A748-402EA43D788C}"), 100)
+PKEY_ThumbnailStream = (IID("{F29F85E0-4FF9-1068-AB91-08002B27B3D9}"), 27)
+PKEY_Title = (IID("{F29F85E0-4FF9-1068-AB91-08002B27B3D9}"), 2)
+PKEY_TotalFileSize = (IID("{28636AA6-953D-11D2-B5D6-00C04FD918D0}"), 14)
+PKEY_Trademarks = (IID("{0CEF7D53-FA64-11D1-A203-0000F81FEDEE}"), 9)
+PKEY_Document_ByteCount = (IID("{D5CDD502-2E9C-101B-9397-08002B2CF9AE}"), 4)
+PKEY_Document_CharacterCount = (IID("{F29F85E0-4FF9-1068-AB91-08002B27B3D9}"), 16)
+PKEY_Document_ClientID = (IID("{276D7BB0-5B34-4FB0-AA4B-158ED12A1809}"), 100)
+PKEY_Document_Contributor = (IID("{F334115E-DA1B-4509-9B3D-119504DC7ABB}"), 100)
+PKEY_Document_DateCreated = (IID("{F29F85E0-4FF9-1068-AB91-08002B27B3D9}"), 12)
+PKEY_Document_DatePrinted = (IID("{F29F85E0-4FF9-1068-AB91-08002B27B3D9}"), 11)
+PKEY_Document_DateSaved = (IID("{F29F85E0-4FF9-1068-AB91-08002B27B3D9}"), 13)
+PKEY_Document_Division = (IID("{1E005EE6-BF27-428B-B01C-79676ACD2870}"), 100)
+PKEY_Document_DocumentID = (IID("{E08805C8-E395-40DF-80D2-54F0D6C43154}"), 100)
+PKEY_Document_HiddenSlideCount = (IID("{D5CDD502-2E9C-101B-9397-08002B2CF9AE}"), 9)
+PKEY_Document_LastAuthor = (IID("{F29F85E0-4FF9-1068-AB91-08002B27B3D9}"), 8)
+PKEY_Document_LineCount = (IID("{D5CDD502-2E9C-101B-9397-08002B2CF9AE}"), 5)
+PKEY_Document_Manager = (IID("{D5CDD502-2E9C-101B-9397-08002B2CF9AE}"), 14)
+PKEY_Document_MultimediaClipCount = (IID("{D5CDD502-2E9C-101B-9397-08002B2CF9AE}"), 10)
+PKEY_Document_NoteCount = (IID("{D5CDD502-2E9C-101B-9397-08002B2CF9AE}"), 8)
+PKEY_Document_PageCount = (IID("{F29F85E0-4FF9-1068-AB91-08002B27B3D9}"), 14)
+PKEY_Document_ParagraphCount = (IID("{D5CDD502-2E9C-101B-9397-08002B2CF9AE}"), 6)
+PKEY_Document_PresentationFormat = (IID("{D5CDD502-2E9C-101B-9397-08002B2CF9AE}"), 3)
+PKEY_Document_RevisionNumber = (IID("{F29F85E0-4FF9-1068-AB91-08002B27B3D9}"), 9)
+PKEY_Document_Security = (IID("{F29F85E0-4FF9-1068-AB91-08002B27B3D9}"), 19)
+PKEY_Document_SlideCount = (IID("{D5CDD502-2E9C-101B-9397-08002B2CF9AE}"), 7)
+PKEY_Document_Template = (IID("{F29F85E0-4FF9-1068-AB91-08002B27B3D9}"), 7)
+PKEY_Document_TotalEditingTime = (IID("{F29F85E0-4FF9-1068-AB91-08002B27B3D9}"), 10)
+PKEY_Document_Version = (IID("{D5CDD502-2E9C-101B-9397-08002B2CF9AE}"), 29)
+PKEY_Document_WordCount = (IID("{F29F85E0-4FF9-1068-AB91-08002B27B3D9}"), 15)
+PKEY_DRM_DatePlayExpires = (IID("{AEAC19E4-89AE-4508-B9B7-BB867ABEE2ED}"), 6)
+PKEY_DRM_DatePlayStarts = (IID("{AEAC19E4-89AE-4508-B9B7-BB867ABEE2ED}"), 5)
+PKEY_DRM_Description = (IID("{AEAC19E4-89AE-4508-B9B7-BB867ABEE2ED}"), 3)
+PKEY_DRM_IsProtected = (IID("{AEAC19E4-89AE-4508-B9B7-BB867ABEE2ED}"), 2)
+PKEY_DRM_PlayCount = (IID("{AEAC19E4-89AE-4508-B9B7-BB867ABEE2ED}"), 4)
+PKEY_GPS_Altitude = (IID("{827EDB4F-5B73-44A7-891D-FDFFABEA35CA}"), 100)
+PKEY_GPS_AltitudeDenominator = (IID("{78342DCB-E358-4145-AE9A-6BFE4E0F9F51}"), 100)
+PKEY_GPS_AltitudeNumerator = (IID("{2DAD1EB7-816D-40D3-9EC3-C9773BE2AADE}"), 100)
+PKEY_GPS_AltitudeRef = (IID("{46AC629D-75EA-4515-867F-6DC4321C5844}"), 100)
+PKEY_GPS_AreaInformation = (IID("{972E333E-AC7E-49F1-8ADF-A70D07A9BCAB}"), 100)
+PKEY_GPS_Date = (IID("{3602C812-0F3B-45F0-85AD-603468D69423}"), 100)
+PKEY_GPS_DestBearing = (IID("{C66D4B3C-E888-47CC-B99F-9DCA3EE34DEA}"), 100)
+PKEY_GPS_DestBearingDenominator = (IID("{7ABCF4F8-7C3F-4988-AC91-8D2C2E97ECA5}"), 100)
+PKEY_GPS_DestBearingNumerator = (IID("{BA3B1DA9-86EE-4B5D-A2A4-A271A429F0CF}"), 100)
+PKEY_GPS_DestBearingRef = (IID("{9AB84393-2A0F-4B75-BB22-7279786977CB}"), 100)
+PKEY_GPS_DestDistance = (IID("{A93EAE04-6804-4F24-AC81-09B266452118}"), 100)
+PKEY_GPS_DestDistanceDenominator = (IID("{9BC2C99B-AC71-4127-9D1C-2596D0D7DCB7}"), 100)
+PKEY_GPS_DestDistanceNumerator = (IID("{2BDA47DA-08C6-4FE1-80BC-A72FC517C5D0}"), 100)
+PKEY_GPS_DestDistanceRef = (IID("{ED4DF2D3-8695-450B-856F-F5C1C53ACB66}"), 100)
+PKEY_GPS_DestLatitude = (IID("{9D1D7CC5-5C39-451C-86B3-928E2D18CC47}"), 100)
+PKEY_GPS_DestLatitudeDenominator = (IID("{3A372292-7FCA-49A7-99D5-E47BB2D4E7AB}"), 100)
+PKEY_GPS_DestLatitudeNumerator = (IID("{ECF4B6F6-D5A6-433C-BB92-4076650FC890}"), 100)
+PKEY_GPS_DestLatitudeRef = (IID("{CEA820B9-CE61-4885-A128-005D9087C192}"), 100)
+PKEY_GPS_DestLongitude = (IID("{47A96261-CB4C-4807-8AD3-40B9D9DBC6BC}"), 100)
+PKEY_GPS_DestLongitudeDenominator = (IID("{425D69E5-48AD-4900-8D80-6EB6B8D0AC86}"), 100)
+PKEY_GPS_DestLongitudeNumerator = (IID("{A3250282-FB6D-48D5-9A89-DBCACE75CCCF}"), 100)
+PKEY_GPS_DestLongitudeRef = (IID("{182C1EA6-7C1C-4083-AB4B-AC6C9F4ED128}"), 100)
+PKEY_GPS_Differential = (IID("{AAF4EE25-BD3B-4DD7-BFC4-47F77BB00F6D}"), 100)
+PKEY_GPS_DOP = (IID("{0CF8FB02-1837-42F1-A697-A7017AA289B9}"), 100)
+PKEY_GPS_DOPDenominator = (IID("{A0BE94C5-50BA-487B-BD35-0654BE8881ED}"), 100)
+PKEY_GPS_DOPNumerator = (IID("{47166B16-364F-4AA0-9F31-E2AB3DF449C3}"), 100)
+PKEY_GPS_ImgDirection = (IID("{16473C91-D017-4ED9-BA4D-B6BAA55DBCF8}"), 100)
+PKEY_GPS_ImgDirectionDenominator = (IID("{10B24595-41A2-4E20-93C2-5761C1395F32}"), 100)
+PKEY_GPS_ImgDirectionNumerator = (IID("{DC5877C7-225F-45F7-BAC7-E81334B6130A}"), 100)
+PKEY_GPS_ImgDirectionRef = (IID("{A4AAA5B7-1AD0-445F-811A-0F8F6E67F6B5}"), 100)
+PKEY_GPS_Latitude = (IID("{8727CFFF-4868-4EC6-AD5B-81B98521D1AB}"), 100)
+PKEY_GPS_LatitudeDenominator = (IID("{16E634EE-2BFF-497B-BD8A-4341AD39EEB9}"), 100)
+PKEY_GPS_LatitudeNumerator = (IID("{7DDAAAD1-CCC8-41AE-B750-B2CB8031AEA2}"), 100)
+PKEY_GPS_LatitudeRef = (IID("{029C0252-5B86-46C7-ACA0-2769FFC8E3D4}"), 100)
+PKEY_GPS_Longitude = (IID("{C4C4DBB2-B593-466B-BBDA-D03D27D5E43A}"), 100)
+PKEY_GPS_LongitudeDenominator = (IID("{BE6E176C-4534-4D2C-ACE5-31DEDAC1606B}"), 100)
+PKEY_GPS_LongitudeNumerator = (IID("{02B0F689-A914-4E45-821D-1DDA452ED2C4}"), 100)
+PKEY_GPS_LongitudeRef = (IID("{33DCF22B-28D5-464C-8035-1EE9EFD25278}"), 100)
+PKEY_GPS_MapDatum = (IID("{2CA2DAE6-EDDC-407D-BEF1-773942ABFA95}"), 100)
+PKEY_GPS_MeasureMode = (IID("{A015ED5D-AAEA-4D58-8A86-3C586920EA0B}"), 100)
+PKEY_GPS_ProcessingMethod = (IID("{59D49E61-840F-4AA9-A939-E2099B7F6399}"), 100)
+PKEY_GPS_Satellites = (IID("{467EE575-1F25-4557-AD4E-B8B58B0D9C15}"), 100)
+PKEY_GPS_Speed = (IID("{DA5D0862-6E76-4E1B-BABD-70021BD25494}"), 100)
+PKEY_GPS_SpeedDenominator = (IID("{7D122D5A-AE5E-4335-8841-D71E7CE72F53}"), 100)
+PKEY_GPS_SpeedNumerator = (IID("{ACC9CE3D-C213-4942-8B48-6D0820F21C6D}"), 100)
+PKEY_GPS_SpeedRef = (IID("{ECF7F4C9-544F-4D6D-9D98-8AD79ADAF453}"), 100)
+PKEY_GPS_Status = (IID("{125491F4-818F-46B2-91B5-D537753617B2}"), 100)
+PKEY_GPS_Track = (IID("{76C09943-7C33-49E3-9E7E-CDBA872CFADA}"), 100)
+PKEY_GPS_TrackDenominator = (IID("{C8D1920C-01F6-40C0-AC86-2F3A4AD00770}"), 100)
+PKEY_GPS_TrackNumerator = (IID("{702926F4-44A6-43E1-AE71-45627116893B}"), 100)
+PKEY_GPS_TrackRef = (IID("{35DBE6FE-44C3-4400-AAAE-D2C799C407E8}"), 100)
+PKEY_GPS_VersionID = (IID("{22704DA4-C6B2-4A99-8E56-F16DF8C92599}"), 100)
+PKEY_Image_BitDepth = (IID("{6444048F-4C8B-11D1-8B70-080036B11A03}"), 7)
+PKEY_Image_ColorSpace = (IID("{14B81DA1-0135-4D31-96D9-6CBFC9671A99}"), 40961)
+PKEY_Image_CompressedBitsPerPixel = (IID("{364B6FA9-37AB-482A-BE2B-AE02F60D4318}"), 100)
+PKEY_Image_CompressedBitsPerPixelDenominator = (
+    IID("{1F8844E1-24AD-4508-9DFD-5326A415CE02}"),
+    100,
+)
+PKEY_Image_CompressedBitsPerPixelNumerator = (
+    IID("{D21A7148-D32C-4624-8900-277210F79C0F}"),
+    100,
+)
+PKEY_Image_Compression = (IID("{14B81DA1-0135-4D31-96D9-6CBFC9671A99}"), 259)
+PKEY_Image_CompressionText = (IID("{3F08E66F-2F44-4BB9-A682-AC35D2562322}"), 100)
+PKEY_Image_Dimensions = (IID("{6444048F-4C8B-11D1-8B70-080036B11A03}"), 13)
+PKEY_Image_HorizontalResolution = (IID("{6444048F-4C8B-11D1-8B70-080036B11A03}"), 5)
+PKEY_Image_HorizontalSize = (IID("{6444048F-4C8B-11D1-8B70-080036B11A03}"), 3)
+PKEY_Image_ImageID = (IID("{10DABE05-32AA-4C29-BF1A-63E2D220587F}"), 100)
+PKEY_Image_ResolutionUnit = (IID("{19B51FA6-1F92-4A5C-AB48-7DF0ABD67444}"), 100)
+PKEY_Image_VerticalResolution = (IID("{6444048F-4C8B-11D1-8B70-080036B11A03}"), 6)
+PKEY_Image_VerticalSize = (IID("{6444048F-4C8B-11D1-8B70-080036B11A03}"), 4)
+PKEY_Journal_Contacts = (IID("{DEA7C82C-1D89-4A66-9427-A4E3DEBABCB1}"), 100)
+PKEY_Journal_EntryType = (IID("{95BEB1FC-326D-4644-B396-CD3ED90E6DDF}"), 100)
+PKEY_Link_Comment = (IID("{B9B4B3FC-2B51-4A42-B5D8-324146AFCF25}"), 5)
+PKEY_Link_DateVisited = (IID("{5CBF2787-48CF-4208-B90E-EE5E5D420294}"), 23)
+PKEY_Link_Description = (IID("{5CBF2787-48CF-4208-B90E-EE5E5D420294}"), 21)
+PKEY_Link_Status = (IID("{B9B4B3FC-2B51-4A42-B5D8-324146AFCF25}"), 3)
+PKEY_Link_TargetExtension = (IID("{7A7D76F4-B630-4BD7-95FF-37CC51A975C9}"), 2)
+PKEY_Link_TargetParsingPath = (IID("{B9B4B3FC-2B51-4A42-B5D8-324146AFCF25}"), 2)
+PKEY_Link_TargetSFGAOFlags = (IID("{B9B4B3FC-2B51-4A42-B5D8-324146AFCF25}"), 8)
+PKEY_Media_AuthorUrl = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 32)
+PKEY_Media_AverageLevel = (IID("{09EDD5B6-B301-43C5-9990-D00302EFFD46}"), 100)
+PKEY_Media_ClassPrimaryID = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 13)
+PKEY_Media_ClassSecondaryID = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 14)
+PKEY_Media_CollectionGroupID = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 24)
+PKEY_Media_CollectionID = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 25)
+PKEY_Media_ContentDistributor = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 18)
+PKEY_Media_ContentID = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 26)
+PKEY_Media_CreatorApplication = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 27)
+PKEY_Media_CreatorApplicationVersion = (
+    IID("{64440492-4C8B-11D1-8B70-080036B11A03}"),
+    28,
+)
+PKEY_Media_DateEncoded = (IID("{2E4B640D-5019-46D8-8881-55414CC5CAA0}"), 100)
+PKEY_Media_DateReleased = (IID("{DE41CC29-6971-4290-B472-F59F2E2F31E2}"), 100)
+PKEY_Media_Duration = (IID("{64440490-4C8B-11D1-8B70-080036B11A03}"), 3)
+PKEY_Media_DVDID = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 15)
+PKEY_Media_EncodedBy = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 36)
+PKEY_Media_EncodingSettings = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 37)
+PKEY_Media_FrameCount = (IID("{6444048F-4C8B-11D1-8B70-080036B11A03}"), 12)
+PKEY_Media_MCDI = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 16)
+PKEY_Media_MetadataContentProvider = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 17)
+PKEY_Media_Producer = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 22)
+PKEY_Media_PromotionUrl = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 33)
+PKEY_Media_ProtectionType = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 38)
+PKEY_Media_ProviderRating = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 39)
+PKEY_Media_ProviderStyle = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 40)
+PKEY_Media_Publisher = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 30)
+PKEY_Media_SubscriptionContentId = (IID("{9AEBAE7A-9644-487D-A92C-657585ED751A}"), 100)
+PKEY_Media_SubTitle = (IID("{56A3372E-CE9C-11D2-9F0E-006097C686F6}"), 38)
+PKEY_Media_UniqueFileIdentifier = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 35)
+PKEY_Media_UserNoAutoInfo = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 41)
+PKEY_Media_UserWebUrl = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 34)
+PKEY_Media_Writer = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 23)
+PKEY_Media_Year = (IID("{56A3372E-CE9C-11D2-9F0E-006097C686F6}"), 5)
+PKEY_Message_AttachmentContents = (IID("{3143BF7C-80A8-4854-8880-E2E40189BDD0}"), 100)
+PKEY_Message_AttachmentNames = (IID("{E3E0584C-B788-4A5A-BB20-7F5A44C9ACDD}"), 21)
+PKEY_Message_BccAddress = (IID("{E3E0584C-B788-4A5A-BB20-7F5A44C9ACDD}"), 2)
+PKEY_Message_BccName = (IID("{E3E0584C-B788-4A5A-BB20-7F5A44C9ACDD}"), 3)
+PKEY_Message_CcAddress = (IID("{E3E0584C-B788-4A5A-BB20-7F5A44C9ACDD}"), 4)
+PKEY_Message_CcName = (IID("{E3E0584C-B788-4A5A-BB20-7F5A44C9ACDD}"), 5)
+PKEY_Message_ConversationID = (IID("{DC8F80BD-AF1E-4289-85B6-3DFC1B493992}"), 100)
+PKEY_Message_ConversationIndex = (IID("{DC8F80BD-AF1E-4289-85B6-3DFC1B493992}"), 101)
+PKEY_Message_DateReceived = (IID("{E3E0584C-B788-4A5A-BB20-7F5A44C9ACDD}"), 20)
+PKEY_Message_DateSent = (IID("{E3E0584C-B788-4A5A-BB20-7F5A44C9ACDD}"), 19)
+PKEY_Message_FromAddress = (IID("{E3E0584C-B788-4A5A-BB20-7F5A44C9ACDD}"), 13)
+PKEY_Message_FromName = (IID("{E3E0584C-B788-4A5A-BB20-7F5A44C9ACDD}"), 14)
+PKEY_Message_HasAttachments = (IID("{9C1FCF74-2D97-41BA-B4AE-CB2E3661A6E4}"), 8)
+PKEY_Message_IsFwdOrReply = (IID("{9A9BC088-4F6D-469E-9919-E705412040F9}"), 100)
+PKEY_Message_MessageClass = (IID("{CD9ED458-08CE-418F-A70E-F912C7BB9C5C}"), 103)
+PKEY_Message_SenderAddress = (IID("{0BE1C8E7-1981-4676-AE14-FDD78F05A6E7}"), 100)
+PKEY_Message_SenderName = (IID("{0DA41CFA-D224-4A18-AE2F-596158DB4B3A}"), 100)
+PKEY_Message_Store = (IID("{E3E0584C-B788-4A5A-BB20-7F5A44C9ACDD}"), 15)
+PKEY_Message_ToAddress = (IID("{E3E0584C-B788-4A5A-BB20-7F5A44C9ACDD}"), 16)
+PKEY_Message_ToDoTitle = (IID("{BCCC8A3C-8CEF-42E5-9B1C-C69079398BC7}"), 100)
+PKEY_Message_ToName = (IID("{E3E0584C-B788-4A5A-BB20-7F5A44C9ACDD}"), 17)
+PKEY_Music_AlbumArtist = (IID("{56A3372E-CE9C-11D2-9F0E-006097C686F6}"), 13)
+PKEY_Music_AlbumTitle = (IID("{56A3372E-CE9C-11D2-9F0E-006097C686F6}"), 4)
+PKEY_Music_Artist = (IID("{56A3372E-CE9C-11D2-9F0E-006097C686F6}"), 2)
+PKEY_Music_BeatsPerMinute = (IID("{56A3372E-CE9C-11D2-9F0E-006097C686F6}"), 35)
+PKEY_Music_Composer = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 19)
+PKEY_Music_Conductor = (IID("{56A3372E-CE9C-11D2-9F0E-006097C686F6}"), 36)
+PKEY_Music_ContentGroupDescription = (IID("{56A3372E-CE9C-11D2-9F0E-006097C686F6}"), 33)
+PKEY_Music_Genre = (IID("{56A3372E-CE9C-11D2-9F0E-006097C686F6}"), 11)
+PKEY_Music_InitialKey = (IID("{56A3372E-CE9C-11D2-9F0E-006097C686F6}"), 34)
+PKEY_Music_Lyrics = (IID("{56A3372E-CE9C-11D2-9F0E-006097C686F6}"), 12)
+PKEY_Music_Mood = (IID("{56A3372E-CE9C-11D2-9F0E-006097C686F6}"), 39)
+PKEY_Music_PartOfSet = (IID("{56A3372E-CE9C-11D2-9F0E-006097C686F6}"), 37)
+PKEY_Music_Period = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 31)
+PKEY_Music_SynchronizedLyrics = (IID("{6B223B6A-162E-4AA9-B39F-05D678FC6D77}"), 100)
+PKEY_Music_TrackNumber = (IID("{56A3372E-CE9C-11D2-9F0E-006097C686F6}"), 7)
+PKEY_Note_Color = (IID("{4776CAFA-BCE4-4CB1-A23E-265E76D8EB11}"), 100)
+PKEY_Note_ColorText = (IID("{46B4E8DE-CDB2-440D-885C-1658EB65B914}"), 100)
+PKEY_Photo_Aperture = (IID("{14B81DA1-0135-4D31-96D9-6CBFC9671A99}"), 37378)
+PKEY_Photo_ApertureDenominator = (IID("{E1A9A38B-6685-46BD-875E-570DC7AD7320}"), 100)
+PKEY_Photo_ApertureNumerator = (IID("{0337ECEC-39FB-4581-A0BD-4C4CC51E9914}"), 100)
+PKEY_Photo_Brightness = (IID("{1A701BF6-478C-4361-83AB-3701BB053C58}"), 100)
+PKEY_Photo_BrightnessDenominator = (IID("{6EBE6946-2321-440A-90F0-C043EFD32476}"), 100)
+PKEY_Photo_BrightnessNumerator = (IID("{9E7D118F-B314-45A0-8CFB-D654B917C9E9}"), 100)
+PKEY_Photo_CameraManufacturer = (IID("{14B81DA1-0135-4D31-96D9-6CBFC9671A99}"), 271)
+PKEY_Photo_CameraModel = (IID("{14B81DA1-0135-4D31-96D9-6CBFC9671A99}"), 272)
+PKEY_Photo_CameraSerialNumber = (IID("{14B81DA1-0135-4D31-96D9-6CBFC9671A99}"), 273)
+PKEY_Photo_Contrast = (IID("{2A785BA9-8D23-4DED-82E6-60A350C86A10}"), 100)
+PKEY_Photo_ContrastText = (IID("{59DDE9F2-5253-40EA-9A8B-479E96C6249A}"), 100)
+PKEY_Photo_DateTaken = (IID("{14B81DA1-0135-4D31-96D9-6CBFC9671A99}"), 36867)
+PKEY_Photo_DigitalZoom = (IID("{F85BF840-A925-4BC2-B0C4-8E36B598679E}"), 100)
+PKEY_Photo_DigitalZoomDenominator = (IID("{745BAF0E-E5C1-4CFB-8A1B-D031A0A52393}"), 100)
+PKEY_Photo_DigitalZoomNumerator = (IID("{16CBB924-6500-473B-A5BE-F1599BCBE413}"), 100)
+PKEY_Photo_Event = (IID("{14B81DA1-0135-4D31-96D9-6CBFC9671A99}"), 18248)
+PKEY_Photo_EXIFVersion = (IID("{D35F743A-EB2E-47F2-A286-844132CB1427}"), 100)
+PKEY_Photo_ExposureBias = (IID("{14B81DA1-0135-4D31-96D9-6CBFC9671A99}"), 37380)
+PKEY_Photo_ExposureBiasDenominator = (
+    IID("{AB205E50-04B7-461C-A18C-2F233836E627}"),
+    100,
+)
+PKEY_Photo_ExposureBiasNumerator = (IID("{738BF284-1D87-420B-92CF-5834BF6EF9ED}"), 100)
+PKEY_Photo_ExposureIndex = (IID("{967B5AF8-995A-46ED-9E11-35B3C5B9782D}"), 100)
+PKEY_Photo_ExposureIndexDenominator = (
+    IID("{93112F89-C28B-492F-8A9D-4BE2062CEE8A}"),
+    100,
+)
+PKEY_Photo_ExposureIndexNumerator = (IID("{CDEDCF30-8919-44DF-8F4C-4EB2FFDB8D89}"), 100)
+PKEY_Photo_ExposureProgram = (IID("{14B81DA1-0135-4D31-96D9-6CBFC9671A99}"), 34850)
+PKEY_Photo_ExposureProgramText = (IID("{FEC690B7-5F30-4646-AE47-4CAAFBA884A3}"), 100)
+PKEY_Photo_ExposureTime = (IID("{14B81DA1-0135-4D31-96D9-6CBFC9671A99}"), 33434)
+PKEY_Photo_ExposureTimeDenominator = (
+    IID("{55E98597-AD16-42E0-B624-21599A199838}"),
+    100,
+)
+PKEY_Photo_ExposureTimeNumerator = (IID("{257E44E2-9031-4323-AC38-85C552871B2E}"), 100)
+PKEY_Photo_Flash = (IID("{14B81DA1-0135-4D31-96D9-6CBFC9671A99}"), 37385)
+PKEY_Photo_FlashEnergy = (IID("{14B81DA1-0135-4D31-96D9-6CBFC9671A99}"), 41483)
+PKEY_Photo_FlashEnergyDenominator = (IID("{D7B61C70-6323-49CD-A5FC-C84277162C97}"), 100)
+PKEY_Photo_FlashEnergyNumerator = (IID("{FCAD3D3D-0858-400F-AAA3-2F66CCE2A6BC}"), 100)
+PKEY_Photo_FlashManufacturer = (IID("{AABAF6C9-E0C5-4719-8585-57B103E584FE}"), 100)
+PKEY_Photo_FlashModel = (IID("{FE83BB35-4D1A-42E2-916B-06F3E1AF719E}"), 100)
+PKEY_Photo_FlashText = (IID("{6B8B68F6-200B-47EA-8D25-D8050F57339F}"), 100)
+PKEY_Photo_FNumber = (IID("{14B81DA1-0135-4D31-96D9-6CBFC9671A99}"), 33437)
+PKEY_Photo_FNumberDenominator = (IID("{E92A2496-223B-4463-A4E3-30EABBA79D80}"), 100)
+PKEY_Photo_FNumberNumerator = (IID("{1B97738A-FDFC-462F-9D93-1957E08BE90C}"), 100)
+PKEY_Photo_FocalLength = (IID("{14B81DA1-0135-4D31-96D9-6CBFC9671A99}"), 37386)
+PKEY_Photo_FocalLengthDenominator = (IID("{305BC615-DCA1-44A5-9FD4-10C0BA79412E}"), 100)
+PKEY_Photo_FocalLengthInFilm = (IID("{A0E74609-B84D-4F49-B860-462BD9971F98}"), 100)
+PKEY_Photo_FocalLengthNumerator = (IID("{776B6B3B-1E3D-4B0C-9A0E-8FBAF2A8492A}"), 100)
+PKEY_Photo_FocalPlaneXResolution = (IID("{CFC08D97-C6F7-4484-89DD-EBEF4356FE76}"), 100)
+PKEY_Photo_FocalPlaneXResolutionDenominator = (
+    IID("{0933F3F5-4786-4F46-A8E8-D64DD37FA521}"),
+    100,
+)
+PKEY_Photo_FocalPlaneXResolutionNumerator = (
+    IID("{DCCB10AF-B4E2-4B88-95F9-031B4D5AB490}"),
+    100,
+)
+PKEY_Photo_FocalPlaneYResolution = (IID("{4FFFE4D0-914F-4AC4-8D6F-C9C61DE169B1}"), 100)
+PKEY_Photo_FocalPlaneYResolutionDenominator = (
+    IID("{1D6179A6-A876-4031-B013-3347B2B64DC8}"),
+    100,
+)
+PKEY_Photo_FocalPlaneYResolutionNumerator = (
+    IID("{A2E541C5-4440-4BA8-867E-75CFC06828CD}"),
+    100,
+)
+PKEY_Photo_GainControl = (IID("{FA304789-00C7-4D80-904A-1E4DCC7265AA}"), 100)
+PKEY_Photo_GainControlDenominator = (IID("{42864DFD-9DA4-4F77-BDED-4AAD7B256735}"), 100)
+PKEY_Photo_GainControlNumerator = (IID("{8E8ECF7C-B7B8-4EB8-A63F-0EE715C96F9E}"), 100)
+PKEY_Photo_GainControlText = (IID("{C06238B2-0BF9-4279-A723-25856715CB9D}"), 100)
+PKEY_Photo_ISOSpeed = (IID("{14B81DA1-0135-4D31-96D9-6CBFC9671A99}"), 34855)
+PKEY_Photo_LensManufacturer = (IID("{E6DDCAF7-29C5-4F0A-9A68-D19412EC7090}"), 100)
+PKEY_Photo_LensModel = (IID("{E1277516-2B5F-4869-89B1-2E585BD38B7A}"), 100)
+PKEY_Photo_LightSource = (IID("{14B81DA1-0135-4D31-96D9-6CBFC9671A99}"), 37384)
+PKEY_Photo_MakerNote = (IID("{FA303353-B659-4052-85E9-BCAC79549B84}"), 100)
+PKEY_Photo_MakerNoteOffset = (IID("{813F4124-34E6-4D17-AB3E-6B1F3C2247A1}"), 100)
+PKEY_Photo_MaxAperture = (IID("{08F6D7C2-E3F2-44FC-AF1E-5AA5C81A2D3E}"), 100)
+PKEY_Photo_MaxApertureDenominator = (IID("{C77724D4-601F-46C5-9B89-C53F93BCEB77}"), 100)
+PKEY_Photo_MaxApertureNumerator = (IID("{C107E191-A459-44C5-9AE6-B952AD4B906D}"), 100)
+PKEY_Photo_MeteringMode = (IID("{14B81DA1-0135-4D31-96D9-6CBFC9671A99}"), 37383)
+PKEY_Photo_MeteringModeText = (IID("{F628FD8C-7BA8-465A-A65B-C5AA79263A9E}"), 100)
+PKEY_Photo_Orientation = (IID("{14B81DA1-0135-4D31-96D9-6CBFC9671A99}"), 274)
+PKEY_Photo_OrientationText = (IID("{A9EA193C-C511-498A-A06B-58E2776DCC28}"), 100)
+PKEY_Photo_PhotometricInterpretation = (
+    IID("{341796F1-1DF9-4B1C-A564-91BDEFA43877}"),
+    100,
+)
+PKEY_Photo_PhotometricInterpretationText = (
+    IID("{821437D6-9EAB-4765-A589-3B1CBBD22A61}"),
+    100,
+)
+PKEY_Photo_ProgramMode = (IID("{6D217F6D-3F6A-4825-B470-5F03CA2FBE9B}"), 100)
+PKEY_Photo_ProgramModeText = (IID("{7FE3AA27-2648-42F3-89B0-454E5CB150C3}"), 100)
+PKEY_Photo_RelatedSoundFile = (IID("{318A6B45-087F-4DC2-B8CC-05359551FC9E}"), 100)
+PKEY_Photo_Saturation = (IID("{49237325-A95A-4F67-B211-816B2D45D2E0}"), 100)
+PKEY_Photo_SaturationText = (IID("{61478C08-B600-4A84-BBE4-E99C45F0A072}"), 100)
+PKEY_Photo_Sharpness = (IID("{FC6976DB-8349-4970-AE97-B3C5316A08F0}"), 100)
+PKEY_Photo_SharpnessText = (IID("{51EC3F47-DD50-421D-8769-334F50424B1E}"), 100)
+PKEY_Photo_ShutterSpeed = (IID("{14B81DA1-0135-4D31-96D9-6CBFC9671A99}"), 37377)
+PKEY_Photo_ShutterSpeedDenominator = (
+    IID("{E13D8975-81C7-4948-AE3F-37CAE11E8FF7}"),
+    100,
+)
+PKEY_Photo_ShutterSpeedNumerator = (IID("{16EA4042-D6F4-4BCA-8349-7C78D30FB333}"), 100)
+PKEY_Photo_SubjectDistance = (IID("{14B81DA1-0135-4D31-96D9-6CBFC9671A99}"), 37382)
+PKEY_Photo_SubjectDistanceDenominator = (
+    IID("{0C840A88-B043-466D-9766-D4B26DA3FA77}"),
+    100,
+)
+PKEY_Photo_SubjectDistanceNumerator = (
+    IID("{8AF4961C-F526-43E5-AA81-DB768219178D}"),
+    100,
+)
+PKEY_Photo_TranscodedForSync = (IID("{9A8EBB75-6458-4E82-BACB-35C0095B03BB}"), 100)
+PKEY_Photo_WhiteBalance = (IID("{EE3D3D8A-5381-4CFA-B13B-AAF66B5F4EC9}"), 100)
+PKEY_Photo_WhiteBalanceText = (IID("{6336B95E-C7A7-426D-86FD-7AE3D39C84B4}"), 100)
+PKEY_PropGroup_Advanced = (IID("{900A403B-097B-4B95-8AE2-071FDAEEB118}"), 100)
+PKEY_PropGroup_Audio = (IID("{2804D469-788F-48AA-8570-71B9C187E138}"), 100)
+PKEY_PropGroup_Calendar = (IID("{9973D2B5-BFD8-438A-BA94-5349B293181A}"), 100)
+PKEY_PropGroup_Camera = (IID("{DE00DE32-547E-4981-AD4B-542F2E9007D8}"), 100)
+PKEY_PropGroup_Contact = (IID("{DF975FD3-250A-4004-858F-34E29A3E37AA}"), 100)
+PKEY_PropGroup_Content = (IID("{D0DAB0BA-368A-4050-A882-6C010FD19A4F}"), 100)
+PKEY_PropGroup_Description = (IID("{8969B275-9475-4E00-A887-FF93B8B41E44}"), 100)
+PKEY_PropGroup_FileSystem = (IID("{E3A7D2C1-80FC-4B40-8F34-30EA111BDC2E}"), 100)
+PKEY_PropGroup_General = (IID("{CC301630-B192-4C22-B372-9F4C6D338E07}"), 100)
+PKEY_PropGroup_GPS = (IID("{F3713ADA-90E3-4E11-AAE5-FDC17685B9BE}"), 100)
+PKEY_PropGroup_Image = (IID("{E3690A87-0FA8-4A2A-9A9F-FCE8827055AC}"), 100)
+PKEY_PropGroup_Media = (IID("{61872CF7-6B5E-4B4B-AC2D-59DA84459248}"), 100)
+PKEY_PropGroup_MediaAdvanced = (IID("{8859A284-DE7E-4642-99BA-D431D044B1EC}"), 100)
+PKEY_PropGroup_Message = (IID("{7FD7259D-16B4-4135-9F97-7C96ECD2FA9E}"), 100)
+PKEY_PropGroup_Music = (IID("{68DD6094-7216-40F1-A029-43FE7127043F}"), 100)
+PKEY_PropGroup_Origin = (IID("{2598D2FB-5569-4367-95DF-5CD3A177E1A5}"), 100)
+PKEY_PropGroup_PhotoAdvanced = (IID("{0CB2BF5A-9EE7-4A86-8222-F01E07FDADAF}"), 100)
+PKEY_PropGroup_RecordedTV = (IID("{E7B33238-6584-4170-A5C0-AC25EFD9DA56}"), 100)
+PKEY_PropGroup_Video = (IID("{BEBE0920-7671-4C54-A3EB-49FDDFC191EE}"), 100)
+PKEY_PropList_ConflictPrompt = (IID("{C9944A21-A406-48FE-8225-AEC7E24C211B}"), 11)
+PKEY_PropList_ExtendedTileInfo = (IID("{C9944A21-A406-48FE-8225-AEC7E24C211B}"), 9)
+PKEY_PropList_FileOperationPrompt = (IID("{C9944A21-A406-48FE-8225-AEC7E24C211B}"), 10)
+PKEY_PropList_FullDetails = (IID("{C9944A21-A406-48FE-8225-AEC7E24C211B}"), 2)
+PKEY_PropList_InfoTip = (IID("{C9944A21-A406-48FE-8225-AEC7E24C211B}"), 4)
+PKEY_PropList_NonPersonal = (IID("{49D1091F-082E-493F-B23F-D2308AA9668C}"), 100)
+PKEY_PropList_PreviewDetails = (IID("{C9944A21-A406-48FE-8225-AEC7E24C211B}"), 8)
+PKEY_PropList_PreviewTitle = (IID("{C9944A21-A406-48FE-8225-AEC7E24C211B}"), 6)
+PKEY_PropList_QuickTip = (IID("{C9944A21-A406-48FE-8225-AEC7E24C211B}"), 5)
+PKEY_PropList_TileInfo = (IID("{C9944A21-A406-48FE-8225-AEC7E24C211B}"), 3)
+PKEY_PropList_XPDetailsPanel = (IID("{F2275480-F782-4291-BD94-F13693513AEC}"), 0)
+PKEY_RecordedTV_ChannelNumber = (IID("{6D748DE2-8D38-4CC3-AC60-F009B057C557}"), 7)
+PKEY_RecordedTV_Credits = (IID("{6D748DE2-8D38-4CC3-AC60-F009B057C557}"), 4)
+PKEY_RecordedTV_DateContentExpires = (IID("{6D748DE2-8D38-4CC3-AC60-F009B057C557}"), 15)
+PKEY_RecordedTV_EpisodeName = (IID("{6D748DE2-8D38-4CC3-AC60-F009B057C557}"), 2)
+PKEY_RecordedTV_IsATSCContent = (IID("{6D748DE2-8D38-4CC3-AC60-F009B057C557}"), 16)
+PKEY_RecordedTV_IsClosedCaptioningAvailable = (
+    IID("{6D748DE2-8D38-4CC3-AC60-F009B057C557}"),
+    12,
+)
+PKEY_RecordedTV_IsDTVContent = (IID("{6D748DE2-8D38-4CC3-AC60-F009B057C557}"), 17)
+PKEY_RecordedTV_IsHDContent = (IID("{6D748DE2-8D38-4CC3-AC60-F009B057C557}"), 18)
+PKEY_RecordedTV_IsRepeatBroadcast = (IID("{6D748DE2-8D38-4CC3-AC60-F009B057C557}"), 13)
+PKEY_RecordedTV_IsSAP = (IID("{6D748DE2-8D38-4CC3-AC60-F009B057C557}"), 14)
+PKEY_RecordedTV_NetworkAffiliation = (
+    IID("{2C53C813-FB63-4E22-A1AB-0B331CA1E273}"),
+    100,
+)
+PKEY_RecordedTV_OriginalBroadcastDate = (
+    IID("{4684FE97-8765-4842-9C13-F006447B178C}"),
+    100,
+)
+PKEY_RecordedTV_ProgramDescription = (IID("{6D748DE2-8D38-4CC3-AC60-F009B057C557}"), 3)
+PKEY_RecordedTV_RecordingTime = (IID("{A5477F61-7A82-4ECA-9DDE-98B69B2479B3}"), 100)
+PKEY_RecordedTV_StationCallSign = (IID("{6D748DE2-8D38-4CC3-AC60-F009B057C557}"), 5)
+PKEY_RecordedTV_StationName = (IID("{1B5439E7-EBA1-4AF8-BDD7-7AF1D4549493}"), 100)
+PKEY_Search_AutoSummary = (IID("{560C36C0-503A-11CF-BAA1-00004C752A9A}"), 2)
+PKEY_Search_ContainerHash = (IID("{BCEEE283-35DF-4D53-826A-F36A3EEFC6BE}"), 100)
+PKEY_Search_Contents = (IID("{B725F130-47EF-101A-A5F1-02608C9EEBAC}"), 19)
+PKEY_Search_EntryID = (IID("{49691C90-7E17-101A-A91C-08002B2ECDA9}"), 5)
+PKEY_Search_GatherTime = (IID("{0B63E350-9CCC-11D0-BCDB-00805FCCCE04}"), 8)
+PKEY_Search_IsClosedDirectory = (IID("{0B63E343-9CCC-11D0-BCDB-00805FCCCE04}"), 23)
+PKEY_Search_IsFullyContained = (IID("{0B63E343-9CCC-11D0-BCDB-00805FCCCE04}"), 24)
+PKEY_Search_QueryFocusedSummary = (IID("{560C36C0-503A-11CF-BAA1-00004C752A9A}"), 3)
+PKEY_Search_Rank = (IID("{49691C90-7E17-101A-A91C-08002B2ECDA9}"), 3)
+PKEY_Search_Store = (IID("{A06992B3-8CAF-4ED7-A547-B259E32AC9FC}"), 100)
+PKEY_Search_UrlToIndex = (IID("{0B63E343-9CCC-11D0-BCDB-00805FCCCE04}"), 2)
+PKEY_Search_UrlToIndexWithModificationTime = (
+    IID("{0B63E343-9CCC-11D0-BCDB-00805FCCCE04}"),
+    12,
+)
+PKEY_DescriptionID = (IID("{28636AA6-953D-11D2-B5D6-00C04FD918D0}"), 2)
+PKEY_Link_TargetSFGAOFlagsStrings = (IID("{D6942081-D53B-443D-AD47-5E059D9CD27A}"), 3)
+PKEY_Link_TargetUrl = (IID("{5CBF2787-48CF-4208-B90E-EE5E5D420294}"), 2)
+PKEY_Shell_SFGAOFlagsStrings = (IID("{D6942081-D53B-443D-AD47-5E059D9CD27A}"), 2)
+PKEY_Software_DateLastUsed = (IID("{841E4F90-FF59-4D16-8947-E81BBFFAB36D}"), 16)
+PKEY_Software_ProductName = (IID("{0CEF7D53-FA64-11D1-A203-0000F81FEDEE}"), 7)
+PKEY_Sync_Comments = (IID("{7BD5533E-AF15-44DB-B8C8-BD6624E1D032}"), 13)
+PKEY_Sync_ConflictDescription = (IID("{CE50C159-2FB8-41FD-BE68-D3E042E274BC}"), 4)
+PKEY_Sync_ConflictFirstLocation = (IID("{CE50C159-2FB8-41FD-BE68-D3E042E274BC}"), 6)
+PKEY_Sync_ConflictSecondLocation = (IID("{CE50C159-2FB8-41FD-BE68-D3E042E274BC}"), 7)
+PKEY_Sync_HandlerCollectionID = (IID("{7BD5533E-AF15-44DB-B8C8-BD6624E1D032}"), 2)
+PKEY_Sync_HandlerID = (IID("{7BD5533E-AF15-44DB-B8C8-BD6624E1D032}"), 3)
+PKEY_Sync_HandlerName = (IID("{CE50C159-2FB8-41FD-BE68-D3E042E274BC}"), 2)
+PKEY_Sync_HandlerType = (IID("{7BD5533E-AF15-44DB-B8C8-BD6624E1D032}"), 8)
+PKEY_Sync_HandlerTypeLabel = (IID("{7BD5533E-AF15-44DB-B8C8-BD6624E1D032}"), 9)
+PKEY_Sync_ItemID = (IID("{7BD5533E-AF15-44DB-B8C8-BD6624E1D032}"), 6)
+PKEY_Sync_ItemName = (IID("{CE50C159-2FB8-41FD-BE68-D3E042E274BC}"), 3)
+PKEY_Task_BillingInformation = (IID("{D37D52C6-261C-4303-82B3-08B926AC6F12}"), 100)
+PKEY_Task_CompletionStatus = (IID("{084D8A0A-E6D5-40DE-BF1F-C8820E7C877C}"), 100)
+PKEY_Task_Owner = (IID("{08C7CC5F-60F2-4494-AD75-55E3E0B5ADD0}"), 100)
+PKEY_Video_Compression = (IID("{64440491-4C8B-11D1-8B70-080036B11A03}"), 10)
+PKEY_Video_Director = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 20)
+PKEY_Video_EncodingBitrate = (IID("{64440491-4C8B-11D1-8B70-080036B11A03}"), 8)
+PKEY_Video_FourCC = (IID("{64440491-4C8B-11D1-8B70-080036B11A03}"), 44)
+PKEY_Video_FrameHeight = (IID("{64440491-4C8B-11D1-8B70-080036B11A03}"), 4)
+PKEY_Video_FrameRate = (IID("{64440491-4C8B-11D1-8B70-080036B11A03}"), 6)
+PKEY_Video_FrameWidth = (IID("{64440491-4C8B-11D1-8B70-080036B11A03}"), 3)
+PKEY_Video_HorizontalAspectRatio = (IID("{64440491-4C8B-11D1-8B70-080036B11A03}"), 42)
+PKEY_Video_SampleSize = (IID("{64440491-4C8B-11D1-8B70-080036B11A03}"), 9)
+PKEY_Video_StreamName = (IID("{64440491-4C8B-11D1-8B70-080036B11A03}"), 2)
+PKEY_Video_StreamNumber = (IID("{64440491-4C8B-11D1-8B70-080036B11A03}"), 11)
+PKEY_Video_TotalBitrate = (IID("{64440491-4C8B-11D1-8B70-080036B11A03}"), 43)
+PKEY_Video_VerticalAspectRatio = (IID("{64440491-4C8B-11D1-8B70-080036B11A03}"), 45)
+PKEY_Volume_FileSystem = (IID("{9B174B35-40FF-11D2-A27E-00C04FC30871}"), 4)
+PKEY_Volume_IsMappedDrive = (IID("{149C0B69-2C2D-48FC-808F-D318D78C4636}"), 2)
+PKEY_Volume_IsRoot = (IID("{9B174B35-40FF-11D2-A27E-00C04FC30871}"), 10)
+
+PKEY_AppUserModel_RelaunchCommand = (IID("{9F4C2855-9F79-4B39-A8D0-E1D42DE1D5F3}"), 2)
+PKEY_AppUserModel_RelaunchIconResource = (
+    IID("{9F4C2855-9F79-4B39-A8D0-E1D42DE1D5F3}"),
+    3,
+)
+PKEY_AppUserModel_RelaunchDisplayNameResource = (
+    IID("{9F4C2855-9F79-4B39-A8D0-E1D42DE1D5F3}"),
+    4,
+)
+PKEY_AppUserModel_ID = (IID("{9F4C2855-9F79-4B39-A8D0-E1D42DE1D5F3}"), 5)
+PKEY_AppUserModel_IsDestListSeparator = (
+    IID("{9F4C2855-9F79-4B39-A8D0-E1D42DE1D5F3}"),
+    6,
+)
+PKEY_AppUserModel_ExcludeFromShowInNewInstall = (
+    IID("{9F4C2855-9F79-4B39-A8D0-E1D42DE1D5F3}"),
+    8,
+)
+PKEY_AppUserModel_PreventPinning = (IID("{9F4C2855-9F79-4B39-A8D0-E1D42DE1D5F3}"), 9)
+
+# PKA_FLAGS, used with IPropertyChange
+PKA_SET = 0
+PKA_APPEND = 1
+PKA_DELETE = 2
diff --git a/lib/win32comext/propsys/test/testpropsys.py b/lib/win32comext/propsys/test/testpropsys.py
new file mode 100644
index 00000000..356d3e67
--- /dev/null
+++ b/lib/win32comext/propsys/test/testpropsys.py
@@ -0,0 +1,5 @@
+from win32com.propsys import propsys, pscon
+
+print("propsys was imported (sorry - that is the extent of the tests,")
+print("but see the shell folder_view demo, which uses this module)")
+# that's all folks!
diff --git a/lib/win32comext/shell/__init__.py b/lib/win32comext/shell/__init__.py
new file mode 100644
index 00000000..8d5db8b9
--- /dev/null
+++ b/lib/win32comext/shell/__init__.py
@@ -0,0 +1,4 @@
+# See if we have a special directory for the binaries (for developers)
+import win32com
+
+win32com.__PackageSupportBuildPath__(__path__)
diff --git a/lib/win32comext/shell/demos/IActiveDesktop.py b/lib/win32comext/shell/demos/IActiveDesktop.py
new file mode 100644
index 00000000..c60ef3c8
--- /dev/null
+++ b/lib/win32comext/shell/demos/IActiveDesktop.py
@@ -0,0 +1,83 @@
+import time
+
+import pythoncom
+from win32com.shell import shell, shellcon
+
+website = "https://github.com/mhammond/pywin32/"
+iad = pythoncom.CoCreateInstance(
+    shell.CLSID_ActiveDesktop,
+    None,
+    pythoncom.CLSCTX_INPROC_SERVER,
+    shell.IID_IActiveDesktop,
+)
+opts = iad.GetDesktopItemOptions()
+if not (opts["ActiveDesktop"] and opts["EnableComponents"]):
+    print("Warning: Enabling Active Desktop")
+    opts["ActiveDesktop"] = True
+    opts["EnableComponents"] = True
+    iad.SetDesktopItemOptions(opts)
+    iad.ApplyChanges(0xFFFF)
+    iad = None
+    ## apparently takes a short while for it to become active
+    time.sleep(2)
+    iad = pythoncom.CoCreateInstance(
+        shell.CLSID_ActiveDesktop,
+        None,
+        pythoncom.CLSCTX_INPROC_SERVER,
+        shell.IID_IActiveDesktop,
+    )
+
+cnt = iad.GetDesktopItemCount()
+print("Count:", cnt)
+for i in range(cnt):
+    print(iad.GetDesktopItem(i))
+
+component = {
+    "ID": cnt + 1,
+    "ComponentType": shellcon.COMP_TYPE_WEBSITE,
+    "CurItemState": shellcon.IS_NORMAL,
+    "SubscribedURL": website,
+    "Source": website,
+    "FriendlyName": "Pywin32 on SF",
+    "Checked": True,  ## this controls whether item is currently displayed
+    "NoScroll": False,
+    "Dirty": False,
+    "Pos": {
+        "Top": 69,
+        "Left": 69,
+        "Height": 400,
+        "Width": 400,
+        "zIndex": 1002,
+        "CanResize": True,
+        "CanResizeX": True,
+        "CanResizeY": True,
+        "PreferredLeftPercent": 0,
+        "PreferredTopPercent": 0,
+    },
+    "Original": {
+        "Top": 33,
+        "Left": 304,
+        "Height": 362,
+        "Width": 372,
+        "ItemState": shellcon.IS_NORMAL,
+    },
+    "Restored": {
+        "Top": 33,
+        "Left": 304,
+        "Height": 362,
+        "Width": 372,
+        "ItemState": shellcon.IS_NORMAL,
+    },
+}
+
+
+try:
+    existing_item = iad.GetDesktopItemBySource(website)
+except pythoncom.com_error:
+    pass
+else:
+    iad.RemoveDesktopItem(existing_item)
+    iad.ApplyChanges(0xFFFF)
+
+iad.AddDesktopItem(component)
+iad.ApplyChanges(0xFFFF)  ## need to check which AD_APPLY constants are actually needed
diff --git a/lib/win32comext/shell/demos/IFileOperationProgressSink.py b/lib/win32comext/shell/demos/IFileOperationProgressSink.py
new file mode 100644
index 00000000..de117ad0
--- /dev/null
+++ b/lib/win32comext/shell/demos/IFileOperationProgressSink.py
@@ -0,0 +1,181 @@
+# Sample implementation of IFileOperationProgressSink that just prints
+# some basic info
+
+import pythoncom
+from win32com.server.policy import DesignatedWrapPolicy
+from win32com.shell import shell, shellcon
+
+tsf_flags = list(
+    (k, v) for k, v in list(shellcon.__dict__.items()) if k.startswith("TSF_")
+)
+
+
+def decode_flags(flags):
+    if flags == 0:
+        return "TSF_NORMAL"
+    flag_txt = ""
+    for k, v in tsf_flags:
+        if flags & v:
+            if flag_txt:
+                flag_txt = flag_txt + "|" + k
+            else:
+                flag_txt = k
+    return flag_txt
+
+
+class FileOperationProgressSink(DesignatedWrapPolicy):
+    _com_interfaces_ = [shell.IID_IFileOperationProgressSink]
+    _public_methods_ = [
+        "StartOperations",
+        "FinishOperations",
+        "PreRenameItem",
+        "PostRenameItem",
+        "PreMoveItem",
+        "PostMoveItem",
+        "PreCopyItem",
+        "PostCopyItem",
+        "PreDeleteItem",
+        "PostDeleteItem",
+        "PreNewItem",
+        "PostNewItem",
+        "UpdateProgress",
+        "ResetTimer",
+        "PauseTimer",
+        "ResumeTimer",
+    ]
+
+    def __init__(self):
+        self._wrap_(self)
+
+    def StartOperations(self):
+        print("StartOperations")
+
+    def FinishOperations(self, Result):
+        print("FinishOperations: HRESULT ", Result)
+
+    def PreRenameItem(self, Flags, Item, NewName):
+        print(
+            "PreRenameItem: Renaming "
+            + Item.GetDisplayName(shellcon.SHGDN_FORPARSING)
+            + " to "
+            + NewName
+        )
+
+    def PostRenameItem(self, Flags, Item, NewName, hrRename, NewlyCreated):
+        if NewlyCreated is not None:
+            newfile = NewlyCreated.GetDisplayName(shellcon.SHGDN_FORPARSING)
+        else:
+            newfile = "not renamed, HRESULT " + str(hrRename)
+        print(
+            "PostRenameItem: renamed "
+            + Item.GetDisplayName(shellcon.SHGDN_FORPARSING)
+            + " to "
+            + newfile
+        )
+
+    def PreMoveItem(self, Flags, Item, DestinationFolder, NewName):
+        print(
+            "PreMoveItem: Moving "
+            + Item.GetDisplayName(shellcon.SHGDN_FORPARSING)
+            + " to "
+            + DestinationFolder.GetDisplayName(shellcon.SHGDN_FORPARSING)
+            + "\\"
+            + str(NewName)
+        )
+
+    def PostMoveItem(
+        self, Flags, Item, DestinationFolder, NewName, hrMove, NewlyCreated
+    ):
+        if NewlyCreated is not None:
+            newfile = NewlyCreated.GetDisplayName(shellcon.SHGDN_FORPARSING)
+        else:
+            newfile = "not copied, HRESULT " + str(hrMove)
+        print(
+            "PostMoveItem: Moved "
+            + Item.GetDisplayName(shellcon.SHGDN_FORPARSING)
+            + " to "
+            + newfile
+        )
+
+    def PreCopyItem(self, Flags, Item, DestinationFolder, NewName):
+        if not NewName:
+            NewName = ""
+        print(
+            "PreCopyItem: Copying "
+            + Item.GetDisplayName(shellcon.SHGDN_FORPARSING)
+            + " to "
+            + DestinationFolder.GetDisplayName(shellcon.SHGDN_FORPARSING)
+            + "\\"
+            + NewName
+        )
+        print("Flags: ", decode_flags(Flags))
+
+    def PostCopyItem(
+        self, Flags, Item, DestinationFolder, NewName, hrCopy, NewlyCreated
+    ):
+        if NewlyCreated is not None:
+            newfile = NewlyCreated.GetDisplayName(shellcon.SHGDN_FORPARSING)
+        else:
+            newfile = "not copied, HRESULT " + str(hrCopy)
+        print(
+            "PostCopyItem: Copied "
+            + Item.GetDisplayName(shellcon.SHGDN_FORPARSING)
+            + " to "
+            + newfile
+        )
+        print("Flags: ", decode_flags(Flags))
+
+    def PreDeleteItem(self, Flags, Item):
+        print(
+            "PreDeleteItem: Deleting " + Item.GetDisplayName(shellcon.SHGDN_FORPARSING)
+        )
+
+    def PostDeleteItem(self, Flags, Item, hrDelete, NewlyCreated):
+        print(
+            "PostDeleteItem: Deleted " + Item.GetDisplayName(shellcon.SHGDN_FORPARSING)
+        )
+        if NewlyCreated:
+            print(
+                "	Moved to recycle bin - "
+                + NewlyCreated.GetDisplayName(shellcon.SHGDN_FORPARSING)
+            )
+
+    def PreNewItem(self, Flags, DestinationFolder, NewName):
+        print(
+            "PreNewItem: Creating "
+            + DestinationFolder.GetDisplayName(shellcon.SHGDN_FORPARSING)
+            + "\\"
+            + NewName
+        )
+
+    def PostNewItem(
+        self,
+        Flags,
+        DestinationFolder,
+        NewName,
+        TemplateName,
+        FileAttributes,
+        hrNew,
+        NewItem,
+    ):
+        print(
+            "PostNewItem: Created " + NewItem.GetDisplayName(shellcon.SHGDN_FORPARSING)
+        )
+
+    def UpdateProgress(self, WorkTotal, WorkSoFar):
+        print("UpdateProgress: ", WorkSoFar, WorkTotal)
+
+    def ResetTimer(self):
+        print("ResetTimer")
+
+    def PauseTimer(self):
+        print("PauseTimer")
+
+    def ResumeTimer(self):
+        print("ResumeTimer")
+
+
+def CreateSink():
+    return pythoncom.WrapObject(
+        FileOperationProgressSink(), shell.IID_IFileOperationProgressSink
+    )
diff --git a/lib/win32comext/shell/demos/IShellLinkDataList.py b/lib/win32comext/shell/demos/IShellLinkDataList.py
new file mode 100644
index 00000000..4327dc70
--- /dev/null
+++ b/lib/win32comext/shell/demos/IShellLinkDataList.py
@@ -0,0 +1,67 @@
+import os
+import sys
+
+import pythoncom
+import win32api
+from win32com.shell import shell, shellcon
+
+temp_dir = win32api.GetTempPath()
+linkname = win32api.GetTempFileName(temp_dir, "cmd")[0]
+os.remove(linkname)
+linkname += ".lnk"
+print("Link name:", linkname)
+ish = pythoncom.CoCreateInstance(
+    shell.CLSID_ShellLink, None, pythoncom.CLSCTX_INPROC_SERVER, shell.IID_IShellLink
+)
+ish.SetPath(os.environ["cOMSPEC"])
+ish.SetWorkingDirectory(os.path.split(sys.executable)[0])
+ish.SetDescription("shortcut made by python")
+
+console_props = {
+    "Signature": shellcon.NT_CONSOLE_PROPS_SIG,
+    "InsertMode": True,
+    "FullScreen": False,  ## True looks like "DOS Mode" from win98!
+    "FontFamily": 54,
+    "CursorSize": 75,  ## pct of character size
+    "ScreenBufferSize": (152, 256),
+    "AutoPosition": False,
+    "FontSize": (4, 5),
+    "FaceName": "",
+    "HistoryBufferSize": 32,
+    "InputBufferSize": 0,
+    "QuickEdit": True,
+    "Font": 0,  ## 0 should always be present, use win32console.GetNumberOfConsoleFonts() to find how many available
+    "FillAttribute": 7,
+    "PopupFillAttribute": 245,
+    "WindowSize": (128, 32),
+    "WindowOrigin": (0, 0),
+    "FontWeight": 400,
+    "HistoryNoDup": False,
+    "NumberOfHistoryBuffers": 32,
+    ## ColorTable copied from a 'normal' console shortcut, with some obvious changes
+    ## These do not appear to be documented.  From experimentation, [0] is background, [7] is foreground text
+    "ColorTable": (
+        255,
+        8388608,
+        32768,
+        8421376,
+        128,
+        8388736,
+        32896,
+        12582912,
+        8421504,
+        16711680,
+        65280,
+        16776960,
+        255,
+        16711935,
+        65535,
+        16777215,
+    ),
+}
+
+ishdl = ish.QueryInterface(shell.IID_IShellLinkDataList)
+ishdl.AddDataBlock(console_props)
+ipf = ish.QueryInterface(pythoncom.IID_IPersistFile)
+ipf.Save(linkname, 1)
+os.startfile(linkname)
diff --git a/lib/win32comext/shell/demos/ITransferAdviseSink.py b/lib/win32comext/shell/demos/ITransferAdviseSink.py
new file mode 100644
index 00000000..0eafeb9e
--- /dev/null
+++ b/lib/win32comext/shell/demos/ITransferAdviseSink.py
@@ -0,0 +1,107 @@
+# ITransferAdviseSink implementation template
+
+import pythoncom
+from win32com.server.policy import DesignatedWrapPolicy
+from win32com.shell import shell, shellcon
+
+tsf_flags = list(
+    (k, v) for k, v in list(shellcon.__dict__.items()) if k.startswith("TSF_")
+)
+
+
+def decode_flags(flags):
+    if flags == 0:
+        return "TSF_NORMAL"
+    flag_txt = ""
+    for k, v in tsf_flags:
+        if flags & v:
+            if flag_txt:
+                flag_txt = flag_txt + "|" + k
+            else:
+                flag_txt = k
+    return flag_txt
+
+
+TRANSFER_ADVISE_STATES = {}
+for k, v in list(shellcon.__dict__.items()):
+    if k.startswith("TS_"):
+        TRANSFER_ADVISE_STATES[v] = k
+
+
+def decode_flags(flags):
+    if flags == 0:
+        return "TSF_NORMAL"
+    flag_txt = ""
+    for k, v in tsf_flags:
+        if flags & v:
+            if flag_txt:
+                flag_txt = flag_txt + "|" + k
+            else:
+                flag_txt = k
+    return flag_txt
+
+
+class TransferAdviseSink(DesignatedWrapPolicy):
+    _com_interfaces_ = [shell.IID_ITransferAdviseSink]
+    _public_methods_ = [
+        "UpdateProgress",
+        "UpdateTransferState",
+        "ConfirmOverwrite",
+        "ConfirmEncryptionLoss",
+        "FileFailure",
+        "SubStreamFailure",
+        "PropertyFailure",
+    ]
+
+    def __init__(self):
+        self._wrap_(self)
+
+    def UpdateProgress(
+        self,
+        SizeCurrent,
+        SizeTotal,
+        FilesCurrent,
+        FilesTotal,
+        FoldersCurrent,
+        FoldersTotal,
+    ):
+        print("UpdateProgress - processed so far:")
+        print("\t %s out of %s bytes" % (SizeCurrent, SizeTotal))
+        print("\t %s out of %s files" % (FilesCurrent, FilesTotal))
+        print("\t %s out of %s folders" % (FoldersCurrent, FoldersTotal))
+
+    def UpdateTransferState(self, State):
+        print(
+            "Current state: ",
+            TRANSFER_ADVISE_STATES.get(State, "??? Unknown state %s ???" % State),
+        )
+
+    def ConfirmOverwrite(self, Source, DestParent, Name):
+        print(
+            "ConfirmOverwrite: ",
+            Source.GetDisplayName(shellcon.SHGDN_FORPARSING),
+            DestParent.GetDisplayName(shellcon.SHGDN_FORPARSING),
+            Name,
+        )
+
+    def ConfirmEncryptionLoss(self, Source):
+        print(
+            "ConfirmEncryptionLoss:", Source.GetDisplayName(shellcon.SHGDN_FORPARSING)
+        )
+
+    def FileFailure(self, Item, ItemName, Error):
+        print("FileFailure:", Item.GetDisplayName(shellcon.SHGDN_FORPARSING), ItemName)
+
+    def SubStreamFailure(self, Item, StreamName, Error):
+        print("SubStreamFailure:\n")
+
+    def PropertyFailure(self, Item, key, Error):
+        print("PropertyFailure:\n")
+
+
+def CreateSink():
+    return pythoncom.WrapObject(
+        TransferAdviseSink(),
+        shell.IID_ITransferAdviseSink,
+        shell.IID_ITransferAdviseSink,
+    )
diff --git a/lib/win32comext/shell/demos/IUniformResourceLocator.py b/lib/win32comext/shell/demos/IUniformResourceLocator.py
new file mode 100644
index 00000000..5a48efcb
--- /dev/null
+++ b/lib/win32comext/shell/demos/IUniformResourceLocator.py
@@ -0,0 +1,56 @@
+import os
+
+import pythoncom
+import win32api
+from win32com.shell import shell, shellcon
+
+
+class InternetShortcut:
+    def __init__(self):
+        self._base = pythoncom.CoCreateInstance(
+            shell.CLSID_InternetShortcut,
+            None,
+            pythoncom.CLSCTX_INPROC_SERVER,
+            shell.IID_IUniformResourceLocator,
+        )
+
+    def load(self, filename):
+        # Get an IPersist interface
+        # which allows save/restore of object to/from files
+        self._base.QueryInterface(pythoncom.IID_IPersistFile).Load(filename)
+
+    def save(self, filename):
+        self._base.QueryInterface(pythoncom.IID_IPersistFile).Save(filename, 1)
+
+    def __getattr__(self, name):
+        if name != "_base":
+            return getattr(self._base, name)
+
+
+temp_dir = win32api.GetTempPath()
+linkname = win32api.GetTempFileName(temp_dir, "ish")[0]
+print("Link:", linkname)
+os.remove(linkname)
+linkname += ".url"
+
+ish = InternetShortcut()
+ish.SetURL("https://github.com/mhammond/pywin32")
+ish.save(linkname)
+
+## IUniformResourceLocator also give access to IPropertySetStorage
+pss = ish.QueryInterface(pythoncom.IID_IPropertySetStorage)
+ps = pss.Open(shell.FMTID_InternetSite)
+property_ids = [
+    (k, v) for k, v in shellcon.__dict__.items() if k.startswith("PID_INTSITE_")
+]
+for pname, pval in property_ids:
+    print(pname, ps.ReadMultiple((pval,))[0])
+
+ps = pss.Open(shell.FMTID_Intshcut)
+property_ids = [(k, v) for k, v in shellcon.__dict__.items() if k.startswith("PID_IS_")]
+for pname, pval in property_ids:
+    print(pname, ps.ReadMultiple((pval,))[0])
+
+new_sh = InternetShortcut()
+new_sh.load(linkname)
+new_sh.InvokeCommand("Open")
diff --git a/lib/win32comext/shell/demos/browse_for_folder.py b/lib/win32comext/shell/demos/browse_for_folder.py
new file mode 100644
index 00000000..dfa1e054
--- /dev/null
+++ b/lib/win32comext/shell/demos/browse_for_folder.py
@@ -0,0 +1,45 @@
+# A couple of samples using SHBrowseForFolder
+
+import os
+
+import win32gui
+from win32com.shell import shell, shellcon
+
+
+# A callback procedure - called by SHBrowseForFolder
+def BrowseCallbackProc(hwnd, msg, lp, data):
+    if msg == shellcon.BFFM_INITIALIZED:
+        win32gui.SendMessage(hwnd, shellcon.BFFM_SETSELECTION, 1, data)
+    elif msg == shellcon.BFFM_SELCHANGED:
+        # Set the status text of the
+        # For this message, 'lp' is the address of the PIDL.
+        pidl = shell.AddressAsPIDL(lp)
+        try:
+            path = shell.SHGetPathFromIDList(pidl)
+            win32gui.SendMessage(hwnd, shellcon.BFFM_SETSTATUSTEXT, 0, path)
+        except shell.error:
+            # No path for this PIDL
+            pass
+
+
+if __name__ == "__main__":
+    # Demonstrate a dialog with the cwd selected as the default - this
+    # must be done via a callback function.
+    flags = shellcon.BIF_STATUSTEXT
+    shell.SHBrowseForFolder(
+        0,  # parent HWND
+        None,  # root PIDL.
+        "Default of %s" % os.getcwd(),  # title
+        flags,  # flags
+        BrowseCallbackProc,  # callback function
+        os.getcwd(),  # 'data' param for the callback
+    )
+    # Browse from this directory down only.
+    # Get the PIDL for the cwd.
+    desktop = shell.SHGetDesktopFolder()
+    cb, pidl, extra = desktop.ParseDisplayName(0, None, os.getcwd())
+    shell.SHBrowseForFolder(
+        0,  # parent HWND
+        pidl,  # root PIDL.
+        "From %s down only" % os.getcwd(),  # title
+    )
diff --git a/lib/win32comext/shell/demos/create_link.py b/lib/win32comext/shell/demos/create_link.py
new file mode 100644
index 00000000..906454c5
--- /dev/null
+++ b/lib/win32comext/shell/demos/create_link.py
@@ -0,0 +1,73 @@
+# link.py
+# From a demo by Mark Hammond, corrupted by Mike Fletcher
+# (and re-corrupted by Mark Hammond :-)
+import os
+
+import pythoncom
+from win32com.shell import shell
+
+
+class PyShortcut:
+    def __init__(self):
+        self._base = pythoncom.CoCreateInstance(
+            shell.CLSID_ShellLink,
+            None,
+            pythoncom.CLSCTX_INPROC_SERVER,
+            shell.IID_IShellLink,
+        )
+
+    def load(self, filename):
+        # Get an IPersist interface
+        # which allows save/restore of object to/from files
+        self._base.QueryInterface(pythoncom.IID_IPersistFile).Load(filename)
+
+    def save(self, filename):
+        self._base.QueryInterface(pythoncom.IID_IPersistFile).Save(filename, 0)
+
+    def __getattr__(self, name):
+        if name != "_base":
+            return getattr(self._base, name)
+
+
+if __name__ == "__main__":
+    import sys
+
+    if len(sys.argv) < 2:
+        print(
+            "Usage: %s LinkFile [path [, args[, description[, working_dir]]]]\n\nIf LinkFile does not exist, it will be created using the other args"
+        )
+        sys.exit(1)
+    file = sys.argv[1]
+    shortcut = PyShortcut()
+    if os.path.exists(file):
+        # load and dump info from file...
+        shortcut.load(file)
+        # now print data...
+        print(
+            "Shortcut in file %s to file:\n\t%s\nArguments:\n\t%s\nDescription:\n\t%s\nWorking Directory:\n\t%s\nItemIDs:\n\t<skipped>"
+            % (
+                file,
+                shortcut.GetPath(shell.SLGP_SHORTPATH)[0],
+                shortcut.GetArguments(),
+                shortcut.GetDescription(),
+                shortcut.GetWorkingDirectory(),
+                # shortcut.GetIDList(),
+            )
+        )
+    else:
+        if len(sys.argv) < 3:
+            print(
+                "Link file does not exist\nYou must supply the path, args, description and working_dir as args"
+            )
+            sys.exit(1)
+        # create the shortcut using rest of args...
+        data = map(
+            None,
+            sys.argv[2:],
+            ("SetPath", "SetArguments", "SetDescription", "SetWorkingDirectory"),
+        )
+        for value, function in data:
+            if value and function:
+                # call function on each non-null value
+                getattr(shortcut, function)(value)
+        shortcut.save(file)
diff --git a/lib/win32comext/shell/demos/dump_link.py b/lib/win32comext/shell/demos/dump_link.py
new file mode 100644
index 00000000..b9b31b33
--- /dev/null
+++ b/lib/win32comext/shell/demos/dump_link.py
@@ -0,0 +1,58 @@
+# dump_link.py - dumps information about shell shortcuts
+#
+import glob
+import os
+import sys
+
+import pythoncom
+from win32com.shell import shell, shellcon
+from win32com.storagecon import *
+
+
+def DumpLink(fname):
+    shellLink = pythoncom.CoCreateInstance(
+        shell.CLSID_ShellLink,
+        None,
+        pythoncom.CLSCTX_INPROC_SERVER,
+        shell.IID_IShellLink,
+    )
+    persistFile = shellLink.QueryInterface(pythoncom.IID_IPersistFile)
+    persistFile.Load(fname, STGM_READ)
+    shellLink.Resolve(0, shell.SLR_ANY_MATCH | shell.SLR_NO_UI)
+    fname, findData = shellLink.GetPath(0)
+    print("Filename:", fname, ", UNC=", shellLink.GetPath(shell.SLGP_UNCPRIORITY)[0])
+    print("Description:", shellLink.GetDescription())
+    print("Working Directory:", shellLink.GetWorkingDirectory())
+    print("Icon:", shellLink.GetIconLocation())
+
+
+def FavDumper(nothing, path, names):
+    # called by os.path.walk
+    for name in names:
+        print(name, end=" ")
+        try:
+            DumpLink(name)
+        except pythoncom.com_error:
+            print(" - not a link")
+
+
+def DumpFavorites():
+    favfold = str(shell.SHGetSpecialFolderPath(0, shellcon.CSIDL_FAVORITES))
+    print("Your favourites are at", favfold)
+    os.path.walk(favfold, FavDumper, None)
+
+
+if __name__ == "__main__":
+    if len(sys.argv) > 1:
+        for fspec in sys.argv[1:]:
+            files = glob.glob(fspec)
+            if files:
+                for file in files:
+                    print(file)
+                    DumpLink(file)
+                    print()
+            else:
+                print("Can not find", fspec)
+    else:
+        print("Dumping your favorites folder!")
+        DumpFavorites()
diff --git a/lib/win32comext/shell/demos/explorer_browser.py b/lib/win32comext/shell/demos/explorer_browser.py
new file mode 100644
index 00000000..dbbd76b1
--- /dev/null
+++ b/lib/win32comext/shell/demos/explorer_browser.py
@@ -0,0 +1,143 @@
+# A sample of using Vista's IExplorerBrowser interfaces...
+# Currently doesn't quite work:
+# * CPU sits at 100% while running.
+
+import sys
+
+import pythoncom
+import win32api
+import win32con
+import win32gui
+from win32com.server.util import unwrap, wrap
+from win32com.shell import shell, shellcon
+
+# event handler for the browser.
+IExplorerBrowserEvents_Methods = """OnNavigationComplete OnNavigationFailed 
+                                    OnNavigationPending OnViewCreated""".split()
+
+
+class EventHandler:
+    _com_interfaces_ = [shell.IID_IExplorerBrowserEvents]
+    _public_methods_ = IExplorerBrowserEvents_Methods
+
+    def OnNavigationComplete(self, pidl):
+        print("OnNavComplete", pidl)
+
+    def OnNavigationFailed(self, pidl):
+        print("OnNavigationFailed", pidl)
+
+    def OnNavigationPending(self, pidl):
+        print("OnNavigationPending", pidl)
+
+    def OnViewCreated(self, view):
+        print("OnViewCreated", view)
+        # And if our demo view has been registered, it may well
+        # be that view!
+        try:
+            pyview = unwrap(view)
+            print("and look - its a Python implemented view!", pyview)
+        except ValueError:
+            pass
+
+
+class MainWindow:
+    def __init__(self):
+        message_map = {
+            win32con.WM_DESTROY: self.OnDestroy,
+            win32con.WM_COMMAND: self.OnCommand,
+            win32con.WM_SIZE: self.OnSize,
+        }
+        # Register the Window class.
+        wc = win32gui.WNDCLASS()
+        hinst = wc.hInstance = win32api.GetModuleHandle(None)
+        wc.lpszClassName = "test_explorer_browser"
+        wc.lpfnWndProc = message_map  # could also specify a wndproc.
+        classAtom = win32gui.RegisterClass(wc)
+        # Create the Window.
+        style = win32con.WS_OVERLAPPEDWINDOW | win32con.WS_VISIBLE
+        self.hwnd = win32gui.CreateWindow(
+            classAtom,
+            "Python IExplorerBrowser demo",
+            style,
+            0,
+            0,
+            win32con.CW_USEDEFAULT,
+            win32con.CW_USEDEFAULT,
+            0,
+            0,
+            hinst,
+            None,
+        )
+        eb = pythoncom.CoCreateInstance(
+            shellcon.CLSID_ExplorerBrowser,
+            None,
+            pythoncom.CLSCTX_ALL,
+            shell.IID_IExplorerBrowser,
+        )
+        # as per MSDN docs, hook up events early
+        self.event_cookie = eb.Advise(wrap(EventHandler()))
+
+        eb.SetOptions(shellcon.EBO_SHOWFRAMES)
+        rect = win32gui.GetClientRect(self.hwnd)
+        # Set the flags such that the folders autoarrange and non web view is presented
+        flags = (shellcon.FVM_LIST, shellcon.FWF_AUTOARRANGE | shellcon.FWF_NOWEBVIEW)
+        eb.Initialize(self.hwnd, rect, (0, shellcon.FVM_DETAILS))
+        if len(sys.argv) == 2:
+            # If an arg was specified, ask the desktop parse it.
+            # You can pass anything explorer accepts as its '/e' argument -
+            # eg, "::{guid}\::{guid}" etc.
+            # "::{20D04FE0-3AEA-1069-A2D8-08002B30309D}" is "My Computer"
+            pidl = shell.SHGetDesktopFolder().ParseDisplayName(0, None, sys.argv[1])[1]
+        else:
+            # And start browsing at the root of the namespace.
+            pidl = []
+        eb.BrowseToIDList(pidl, shellcon.SBSP_ABSOLUTE)
+        # and for some reason the "Folder" view in the navigator pane doesn't
+        # magically synchronize itself - so let's do that ourself.
+        # Get the tree control.
+        sp = eb.QueryInterface(pythoncom.IID_IServiceProvider)
+        try:
+            tree = sp.QueryService(
+                shell.IID_INameSpaceTreeControl, shell.IID_INameSpaceTreeControl
+            )
+        except pythoncom.com_error as exc:
+            # this should really only fail if no "nav" frame exists...
+            print(
+                "Strange - failed to get the tree control even though "
+                "we asked for a EBO_SHOWFRAMES"
+            )
+            print(exc)
+        else:
+            # get the IShellItem for the selection.
+            si = shell.SHCreateItemFromIDList(pidl, shell.IID_IShellItem)
+            # set it to selected.
+            tree.SetItemState(si, shellcon.NSTCIS_SELECTED, shellcon.NSTCIS_SELECTED)
+
+        # eb.FillFromObject(None, shellcon.EBF_NODROPTARGET);
+        # eb.SetEmptyText("No known folders yet...");
+        self.eb = eb
+
+    def OnCommand(self, hwnd, msg, wparam, lparam):
+        pass
+
+    def OnDestroy(self, hwnd, msg, wparam, lparam):
+        print("tearing down ExplorerBrowser...")
+        self.eb.Unadvise(self.event_cookie)
+        self.eb.Destroy()
+        self.eb = None
+        print("shutting down app...")
+        win32gui.PostQuitMessage(0)
+
+    def OnSize(self, hwnd, msg, wparam, lparam):
+        x = win32api.LOWORD(lparam)
+        y = win32api.HIWORD(lparam)
+        self.eb.SetRect(None, (0, 0, x, y))
+
+
+def main():
+    w = MainWindow()
+    win32gui.PumpMessages()
+
+
+if __name__ == "__main__":
+    main()
diff --git a/lib/win32comext/shell/demos/servers/column_provider.py b/lib/win32comext/shell/demos/servers/column_provider.py
new file mode 100644
index 00000000..6c8625a4
--- /dev/null
+++ b/lib/win32comext/shell/demos/servers/column_provider.py
@@ -0,0 +1,126 @@
+# A sample shell column provider
+# Mainly ported from MSDN article:
+#  Using Shell Column Handlers for Detailed File Information,
+#  Raymond Chen, Microsoft Corporation, February 2000
+#
+# To demostrate:
+# * Execute this script to register the namespace.
+# * Open Windows Explorer
+# * Right-click an explorer column header - select "More"
+# * Locate column 'pyc size' or 'pyo size', and add it to the view.
+# This handler is providing that column data.
+import os
+import stat
+
+import commctrl
+import pythoncom
+from pywintypes import IID
+from win32com.server.util import wrap
+from win32com.shell import shell, shellcon
+
+IPersist_Methods = ["GetClassID"]
+IColumnProvider_Methods = IPersist_Methods + [
+    "Initialize",
+    "GetColumnInfo",
+    "GetItemData",
+]
+
+
+class ColumnProvider:
+    _reg_progid_ = "Python.ShellExtension.ColumnProvider"
+    _reg_desc_ = "Python Sample Shell Extension (Column Provider)"
+    _reg_clsid_ = IID("{0F14101A-E05E-4070-BD54-83DFA58C3D68}")
+    _com_interfaces_ = [
+        pythoncom.IID_IPersist,
+        shell.IID_IColumnProvider,
+    ]
+    _public_methods_ = IColumnProvider_Methods
+
+    # IPersist
+    def GetClassID(self):
+        return self._reg_clsid_
+
+    # IColumnProvider
+    def Initialize(self, colInit):
+        flags, reserved, name = colInit
+        print("ColumnProvider initializing for file", name)
+
+    def GetColumnInfo(self, index):
+        # We support exactly 2 columns - 'pyc size' and 'pyo size'
+        if index in [0, 1]:
+            # As per the MSDN sample, use our CLSID as the fmtid
+            if index == 0:
+                ext = ".pyc"
+            else:
+                ext = ".pyo"
+            title = ext + " size"
+            description = "Size of compiled %s file" % ext
+            col_id = (self._reg_clsid_, index)  # fmtid  # pid
+            col_info = (
+                col_id,  # scid
+                pythoncom.VT_I4,  # vt
+                commctrl.LVCFMT_RIGHT,  # fmt
+                20,  # cChars
+                shellcon.SHCOLSTATE_TYPE_INT
+                | shellcon.SHCOLSTATE_SECONDARYUI,  # csFlags
+                title,
+                description,
+            )
+            return col_info
+        return None  # Indicate no more columns.
+
+    def GetItemData(self, colid, colData):
+        fmt_id, pid = colid
+        fmt_id == self._reg_clsid_
+        flags, attr, reserved, ext, name = colData
+        if ext.lower() not in [".py", ".pyw"]:
+            return None
+        if pid == 0:
+            ext = ".pyc"
+        else:
+            ext = ".pyo"
+        check_file = os.path.splitext(name)[0] + ext
+        try:
+            st = os.stat(check_file)
+            return st[stat.ST_SIZE]
+        except OSError:
+            # No file
+            return None
+
+
+def DllRegisterServer():
+    import winreg
+
+    # Special ColumnProvider key
+    key = winreg.CreateKey(
+        winreg.HKEY_CLASSES_ROOT,
+        "Folder\\ShellEx\\ColumnHandlers\\" + str(ColumnProvider._reg_clsid_),
+    )
+    winreg.SetValueEx(key, None, 0, winreg.REG_SZ, ColumnProvider._reg_desc_)
+    print(ColumnProvider._reg_desc_, "registration complete.")
+
+
+def DllUnregisterServer():
+    import winreg
+
+    try:
+        key = winreg.DeleteKey(
+            winreg.HKEY_CLASSES_ROOT,
+            "Folder\\ShellEx\\ColumnHandlers\\" + str(ColumnProvider._reg_clsid_),
+        )
+    except WindowsError as details:
+        import errno
+
+        if details.errno != errno.ENOENT:
+            raise
+    print(ColumnProvider._reg_desc_, "unregistration complete.")
+
+
+if __name__ == "__main__":
+    from win32com.server import register
+
+    register.UseCommandLine(
+        ColumnProvider,
+        finalize_register=DllRegisterServer,
+        finalize_unregister=DllUnregisterServer,
+    )
diff --git a/lib/win32comext/shell/demos/servers/context_menu.py b/lib/win32comext/shell/demos/servers/context_menu.py
new file mode 100644
index 00000000..b92109d7
--- /dev/null
+++ b/lib/win32comext/shell/demos/servers/context_menu.py
@@ -0,0 +1,122 @@
+# A sample context menu handler.
+# Adds a 'Hello from Python' menu entry to .py files.  When clicked, a
+# simple message box is displayed.
+#
+# To demostrate:
+# * Execute this script to register the context menu.
+# * Open Windows Explorer, and browse to a directory with a .py file.
+# * Right-Click on a .py file - locate and click on 'Hello from Python' on
+#   the context menu.
+
+import pythoncom
+import win32con
+import win32gui
+from win32com.shell import shell, shellcon
+
+
+class ShellExtension:
+    _reg_progid_ = "Python.ShellExtension.ContextMenu"
+    _reg_desc_ = "Python Sample Shell Extension (context menu)"
+    _reg_clsid_ = "{CED0336C-C9EE-4a7f-8D7F-C660393C381F}"
+    _com_interfaces_ = [shell.IID_IShellExtInit, shell.IID_IContextMenu]
+    _public_methods_ = shellcon.IContextMenu_Methods + shellcon.IShellExtInit_Methods
+
+    def Initialize(self, folder, dataobj, hkey):
+        print("Init", folder, dataobj, hkey)
+        self.dataobj = dataobj
+
+    def QueryContextMenu(self, hMenu, indexMenu, idCmdFirst, idCmdLast, uFlags):
+        print("QCM", hMenu, indexMenu, idCmdFirst, idCmdLast, uFlags)
+        # Query the items clicked on
+        format_etc = win32con.CF_HDROP, None, 1, -1, pythoncom.TYMED_HGLOBAL
+        sm = self.dataobj.GetData(format_etc)
+        num_files = shell.DragQueryFile(sm.data_handle, -1)
+        if num_files > 1:
+            msg = "&Hello from Python (with %d files selected)" % num_files
+        else:
+            fname = shell.DragQueryFile(sm.data_handle, 0)
+            msg = "&Hello from Python (with '%s' selected)" % fname
+        idCmd = idCmdFirst
+        items = ["First Python content menu item"]
+        if (
+            uFlags & 0x000F
+        ) == shellcon.CMF_NORMAL:  # Check == here, since CMF_NORMAL=0
+            print("CMF_NORMAL...")
+            items.append(msg)
+        elif uFlags & shellcon.CMF_VERBSONLY:
+            print("CMF_VERBSONLY...")
+            items.append(msg + " - shortcut")
+        elif uFlags & shellcon.CMF_EXPLORE:
+            print("CMF_EXPLORE...")
+            items.append(msg + " - normal file, right-click in Explorer")
+        elif uFlags & CMF_DEFAULTONLY:
+            print("CMF_DEFAULTONLY...\r\n")
+        else:
+            print("** unknown flags", uFlags)
+        win32gui.InsertMenu(
+            hMenu, indexMenu, win32con.MF_SEPARATOR | win32con.MF_BYPOSITION, 0, None
+        )
+        indexMenu += 1
+        for item in items:
+            win32gui.InsertMenu(
+                hMenu,
+                indexMenu,
+                win32con.MF_STRING | win32con.MF_BYPOSITION,
+                idCmd,
+                item,
+            )
+            indexMenu += 1
+            idCmd += 1
+
+        win32gui.InsertMenu(
+            hMenu, indexMenu, win32con.MF_SEPARATOR | win32con.MF_BYPOSITION, 0, None
+        )
+        indexMenu += 1
+        return idCmd - idCmdFirst  # Must return number of menu items we added.
+
+    def InvokeCommand(self, ci):
+        mask, hwnd, verb, params, dir, nShow, hotkey, hicon = ci
+        win32gui.MessageBox(hwnd, "Hello", "Wow", win32con.MB_OK)
+
+    def GetCommandString(self, cmd, typ):
+        # If GetCommandString returns the same string for all items then
+        # the shell seems to ignore all but one.  This is even true in
+        # Win7 etc where there is no status bar (and hence this string seems
+        # ignored)
+        return "Hello from Python (cmd=%d)!!" % (cmd,)
+
+
+def DllRegisterServer():
+    import winreg
+
+    key = winreg.CreateKey(winreg.HKEY_CLASSES_ROOT, "Python.File\\shellex")
+    subkey = winreg.CreateKey(key, "ContextMenuHandlers")
+    subkey2 = winreg.CreateKey(subkey, "PythonSample")
+    winreg.SetValueEx(subkey2, None, 0, winreg.REG_SZ, ShellExtension._reg_clsid_)
+    print(ShellExtension._reg_desc_, "registration complete.")
+
+
+def DllUnregisterServer():
+    import winreg
+
+    try:
+        key = winreg.DeleteKey(
+            winreg.HKEY_CLASSES_ROOT,
+            "Python.File\\shellex\\ContextMenuHandlers\\PythonSample",
+        )
+    except WindowsError as details:
+        import errno
+
+        if details.errno != errno.ENOENT:
+            raise
+    print(ShellExtension._reg_desc_, "unregistration complete.")
+
+
+if __name__ == "__main__":
+    from win32com.server import register
+
+    register.UseCommandLine(
+        ShellExtension,
+        finalize_register=DllRegisterServer,
+        finalize_unregister=DllUnregisterServer,
+    )
diff --git a/lib/win32comext/shell/demos/servers/copy_hook.py b/lib/win32comext/shell/demos/servers/copy_hook.py
new file mode 100644
index 00000000..e5871fd8
--- /dev/null
+++ b/lib/win32comext/shell/demos/servers/copy_hook.py
@@ -0,0 +1,84 @@
+# A sample shell copy hook.
+
+# To demostrate:
+# * Execute this script to register the context menu.
+# * Open Windows Explorer
+# * Attempt to move or copy a directory.
+# * Note our hook's dialog is displayed.
+
+import pythoncom
+import win32con
+import win32gui
+from win32com.shell import shell, shellcon
+
+
+# Our shell extension.
+class ShellExtension:
+    _reg_progid_ = "Python.ShellExtension.CopyHook"
+    _reg_desc_ = "Python Sample Shell Extension (copy hook)"
+    _reg_clsid_ = "{1845b6ba-2bbd-4197-b930-46d8651497c1}"
+    _com_interfaces_ = [shell.IID_ICopyHook]
+    _public_methods_ = ["CopyCallBack"]
+
+    def CopyCallBack(self, hwnd, func, flags, srcName, srcAttr, destName, destAttr):
+        # This function should return:
+        # IDYES Allows the operation.
+        # IDNO Prevents the operation on this folder but continues with any other operations that have been approved (for example, a batch copy operation).
+        # IDCANCEL Prevents the current operation and cancels any pending operations.
+        print("CopyCallBack", hwnd, func, flags, srcName, srcAttr, destName, destAttr)
+        return win32gui.MessageBox(
+            hwnd, "Allow operation?", "CopyHook", win32con.MB_YESNO
+        )
+
+
+def DllRegisterServer():
+    import winreg
+
+    key = winreg.CreateKey(
+        winreg.HKEY_CLASSES_ROOT,
+        "directory\\shellex\\CopyHookHandlers\\" + ShellExtension._reg_desc_,
+    )
+    winreg.SetValueEx(key, None, 0, winreg.REG_SZ, ShellExtension._reg_clsid_)
+    key = winreg.CreateKey(
+        winreg.HKEY_CLASSES_ROOT,
+        "*\\shellex\\CopyHookHandlers\\" + ShellExtension._reg_desc_,
+    )
+    winreg.SetValueEx(key, None, 0, winreg.REG_SZ, ShellExtension._reg_clsid_)
+    print(ShellExtension._reg_desc_, "registration complete.")
+
+
+def DllUnregisterServer():
+    import winreg
+
+    try:
+        key = winreg.DeleteKey(
+            winreg.HKEY_CLASSES_ROOT,
+            "directory\\shellex\\CopyHookHandlers\\" + ShellExtension._reg_desc_,
+        )
+    except WindowsError as details:
+        import errno
+
+        if details.errno != errno.ENOENT:
+            raise
+    try:
+        key = winreg.DeleteKey(
+            winreg.HKEY_CLASSES_ROOT,
+            "*\\shellex\\CopyHookHandlers\\" + ShellExtension._reg_desc_,
+        )
+    except WindowsError as details:
+        import errno
+
+        if details.errno != errno.ENOENT:
+            raise
+    print(ShellExtension._reg_desc_, "unregistration complete.")
+
+
+if __name__ == "__main__":
+    from win32com.server import register
+
+    register.UseCommandLine(
+        ShellExtension,
+        finalize_register=DllRegisterServer,
+        finalize_unregister=DllUnregisterServer,
+    )
+#!/usr/bin/env python
diff --git a/lib/win32comext/shell/demos/servers/empty_volume_cache.py b/lib/win32comext/shell/demos/servers/empty_volume_cache.py
new file mode 100644
index 00000000..a257ac17
--- /dev/null
+++ b/lib/win32comext/shell/demos/servers/empty_volume_cache.py
@@ -0,0 +1,188 @@
+# A sample implementation of IEmptyVolumeCache - see
+# http://msdn2.microsoft.com/en-us/library/aa969271.aspx for an overview.
+#
+# * Execute this script to register the handler
+# * Start the "disk cleanup" tool - look for "pywin32 compiled files"
+import os
+import stat
+import sys
+
+import pythoncom
+import win32gui
+import winerror
+from win32com.server.exception import COMException
+from win32com.shell import shell, shellcon
+
+# Our shell extension.
+IEmptyVolumeCache_Methods = (
+    "Initialize GetSpaceUsed Purge ShowProperties Deactivate".split()
+)
+IEmptyVolumeCache2_Methods = "InitializeEx".split()
+
+ico = os.path.join(sys.prefix, "py.ico")
+if not os.path.isfile(ico):
+    ico = os.path.join(sys.prefix, "PC", "py.ico")
+if not os.path.isfile(ico):
+    ico = None
+    print("Can't find python.ico - no icon will be installed")
+
+
+class EmptyVolumeCache:
+    _reg_progid_ = "Python.ShellExtension.EmptyVolumeCache"
+    _reg_desc_ = "Python Sample Shell Extension (disk cleanup)"
+    _reg_clsid_ = "{EADD0777-2968-4c72-A999-2BF5F756259C}"
+    _reg_icon_ = ico
+    _com_interfaces_ = [shell.IID_IEmptyVolumeCache, shell.IID_IEmptyVolumeCache2]
+    _public_methods_ = IEmptyVolumeCache_Methods + IEmptyVolumeCache2_Methods
+
+    def Initialize(self, hkey, volume, flags):
+        # This should never be called, except on win98.
+        print("Unless we are on 98, Initialize call is unexpected!")
+        raise COMException(hresult=winerror.E_NOTIMPL)
+
+    def InitializeEx(self, hkey, volume, key_name, flags):
+        # Must return a tuple of:
+        # (display_name, description, button_name, flags)
+        print("InitializeEx called with", hkey, volume, key_name, flags)
+        self.volume = volume
+        if flags & shellcon.EVCF_SETTINGSMODE:
+            print("We are being run on a schedule")
+            # In this case, "because there is no opportunity for user
+            # feedback, only those files that are extremely safe to clean up
+            # should be touched. You should ignore the initialization
+            # method's pcwszVolume parameter and clean unneeded files
+            # regardless of what drive they are on."
+            self.volume = None  # flag as 'any disk will do'
+        elif flags & shellcon.EVCF_OUTOFDISKSPACE:
+            # In this case, "the handler should be aggressive about deleting
+            # files, even if it results in a performance loss. However, the
+            # handler obviously should not delete files that would cause an
+            # application to fail or the user to lose data."
+            print("We are being run as we are out of disk-space")
+        else:
+            # This case is not documented - we are guessing :)
+            print("We are being run because the user asked")
+
+        # For the sake of demo etc, we tell the shell to only show us when
+        # there are > 0 bytes available.  Our GetSpaceUsed will check the
+        # volume, so will return 0 when we are on a different disk
+        flags = shellcon.EVCF_DONTSHOWIFZERO | shellcon.EVCF_ENABLEBYDEFAULT
+
+        return (
+            "pywin32 compiled files",
+            "Removes all .pyc and .pyo files in the pywin32 directories",
+            "click me!",
+            flags,
+        )
+
+    def _GetDirectories(self):
+        root_dir = os.path.abspath(os.path.dirname(os.path.dirname(win32gui.__file__)))
+        if self.volume is not None and not root_dir.lower().startswith(
+            self.volume.lower()
+        ):
+            return []
+        return [
+            os.path.join(root_dir, p)
+            for p in ("win32", "win32com", "win32comext", "isapi")
+        ]
+
+    def _WalkCallback(self, arg, directory, files):
+        # callback function for os.path.walk - no need to be member, but its
+        # close to the callers :)
+        callback, total_list = arg
+        for file in files:
+            fqn = os.path.join(directory, file).lower()
+            if file.endswith(".pyc") or file.endswith(".pyo"):
+                # See below - total_list == None means delete files,
+                # otherwise it is a list where the result is stored. Its a
+                # list simply due to the way os.walk works - only [0] is
+                # referenced
+                if total_list is None:
+                    print("Deleting file", fqn)
+                    # Should do callback.PurgeProcess - left as an exercise :)
+                    os.remove(fqn)
+                else:
+                    total_list[0] += os.stat(fqn)[stat.ST_SIZE]
+                    # and callback to the tool
+                    if callback:
+                        # for the sake of seeing the progress bar do its thing,
+                        # we take longer than we need to...
+                        # ACK - for some bizarre reason this screws up the XP
+                        # cleanup manager - clues welcome!! :)
+                        ## print "Looking in", directory, ", but waiting a while..."
+                        ## time.sleep(3)
+                        # now do it
+                        used = total_list[0]
+                        callback.ScanProgress(used, 0, "Looking at " + fqn)
+
+    def GetSpaceUsed(self, callback):
+        total = [0]  # See _WalkCallback above
+        try:
+            for d in self._GetDirectories():
+                os.path.walk(d, self._WalkCallback, (callback, total))
+                print("After looking in", d, "we have", total[0], "bytes")
+        except pythoncom.error as exc:
+            # This will be raised by the callback when the user selects 'cancel'.
+            if exc.hresult != winerror.E_ABORT:
+                raise  # that's the documented error code!
+            print("User cancelled the operation")
+        return total[0]
+
+    def Purge(self, amt_to_free, callback):
+        print("Purging", amt_to_free, "bytes...")
+        # we ignore amt_to_free - it is generally what we returned for
+        # GetSpaceUsed
+        try:
+            for d in self._GetDirectories():
+                os.path.walk(d, self._WalkCallback, (callback, None))
+        except pythoncom.error as exc:
+            # This will be raised by the callback when the user selects 'cancel'.
+            if exc.hresult != winerror.E_ABORT:
+                raise  # that's the documented error code!
+            print("User cancelled the operation")
+
+    def ShowProperties(self, hwnd):
+        raise COMException(hresult=winerror.E_NOTIMPL)
+
+    def Deactivate(self):
+        print("Deactivate called")
+        return 0
+
+
+def DllRegisterServer():
+    # Also need to register specially in:
+    # HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Explorer\VolumeCaches
+    # See link at top of file.
+    import winreg
+
+    kn = r"Software\Microsoft\Windows\CurrentVersion\Explorer\VolumeCaches\%s" % (
+        EmptyVolumeCache._reg_desc_,
+    )
+    key = winreg.CreateKey(winreg.HKEY_LOCAL_MACHINE, kn)
+    winreg.SetValueEx(key, None, 0, winreg.REG_SZ, EmptyVolumeCache._reg_clsid_)
+
+
+def DllUnregisterServer():
+    import winreg
+
+    kn = r"Software\Microsoft\Windows\CurrentVersion\Explorer\VolumeCaches\%s" % (
+        EmptyVolumeCache._reg_desc_,
+    )
+    try:
+        key = winreg.DeleteKey(winreg.HKEY_LOCAL_MACHINE, kn)
+    except WindowsError as details:
+        import errno
+
+        if details.errno != errno.ENOENT:
+            raise
+    print(EmptyVolumeCache._reg_desc_, "unregistration complete.")
+
+
+if __name__ == "__main__":
+    from win32com.server import register
+
+    register.UseCommandLine(
+        EmptyVolumeCache,
+        finalize_register=DllRegisterServer,
+        finalize_unregister=DllUnregisterServer,
+    )
diff --git a/lib/win32comext/shell/demos/servers/folder_view.py b/lib/win32comext/shell/demos/servers/folder_view.py
new file mode 100644
index 00000000..383270df
--- /dev/null
+++ b/lib/win32comext/shell/demos/servers/folder_view.py
@@ -0,0 +1,862 @@
+# This is a port of the Vista SDK "FolderView" sample, and associated
+# notes at http://shellrevealed.com/blogs/shellblog/archive/2007/03/15/Shell-Namespace-Extension_3A00_-Creating-and-Using-the-System-Folder-View-Object.aspx
+# A key difference to shell_view.py is that this version uses the default
+# IShellView provided by the shell (via SHCreateShellFolderView) rather
+# than our own.
+# XXX - sadly, it doesn't work quite like the original sample.  Oh well,
+# another day...
+import os
+import pickle
+import random
+import sys
+
+import commctrl
+import pythoncom
+import win32api
+import win32con
+import winerror
+import winxpgui as win32gui  # the needs vista, let alone xp!
+from win32com.axcontrol import axcontrol  # IObjectWithSite
+from win32com.propsys import propsys
+from win32com.server.exception import COMException
+from win32com.server.util import NewEnum as _NewEnum, wrap as _wrap
+from win32com.shell import shell, shellcon
+from win32com.util import IIDToInterfaceName
+
+GUID = pythoncom.MakeIID
+
+# If set, output spews to the win32traceutil collector...
+debug = 0
+
+
+# wrap a python object in a COM pointer
+def wrap(ob, iid=None):
+    return _wrap(ob, iid, useDispatcher=(debug > 0))
+
+
+def NewEnum(seq, iid):
+    return _NewEnum(seq, iid=iid, useDispatcher=(debug > 0))
+
+
+# The sample makes heavy use of "string ids" (ie, integer IDs defined in .h
+# files, loaded at runtime from a (presumably localized) DLL.  We cheat.
+_sids = {}  # strings, indexed bystring_id,
+
+
+def LoadString(sid):
+    return _sids[sid]
+
+
+# fn to create a unique string ID
+_last_ids = 0
+
+
+def _make_ids(s):
+    global _last_ids
+    _last_ids += 1
+    _sids[_last_ids] = s
+    return _last_ids
+
+
+# These strings are what the user sees and would be localized.
+# XXX - its possible that the shell might persist these values, so
+# this scheme wouldn't really be suitable in a real ap.
+IDS_UNSPECIFIED = _make_ids("unspecified")
+IDS_SMALL = _make_ids("small")
+IDS_MEDIUM = _make_ids("medium")
+IDS_LARGE = _make_ids("large")
+IDS_CIRCLE = _make_ids("circle")
+IDS_TRIANGLE = _make_ids("triangle")
+IDS_RECTANGLE = _make_ids("rectangle")
+IDS_POLYGON = _make_ids("polygon")
+IDS_DISPLAY = _make_ids("Display")
+IDS_DISPLAY_TT = _make_ids("Display the item.")
+IDS_SETTINGS = _make_ids("Settings")
+IDS_SETTING1 = _make_ids("Setting 1")
+IDS_SETTING2 = _make_ids("Setting 2")
+IDS_SETTING3 = _make_ids("Setting 3")
+IDS_SETTINGS_TT = _make_ids("Modify settings.")
+IDS_SETTING1_TT = _make_ids("Modify setting 1.")
+IDS_SETTING2_TT = _make_ids("Modify setting 2.")
+IDS_SETTING3_TT = _make_ids("Modify setting 3.")
+IDS_LESSTHAN5 = _make_ids("Less Than 5")
+IDS_5ORGREATER = _make_ids("Five or Greater")
+del _make_ids, _last_ids
+
+# Other misc resource stuff
+IDI_ICON1 = 100
+IDI_SETTINGS = 101
+
+# The sample defines a number of "category ids".  Each one gets
+# its own GUID.
+CAT_GUID_NAME = GUID("{de094c9d-c65a-11dc-ba21-005056c00008}")
+CAT_GUID_SIZE = GUID("{de094c9e-c65a-11dc-ba21-005056c00008}")
+CAT_GUID_SIDES = GUID("{de094c9f-c65a-11dc-ba21-005056c00008}")
+CAT_GUID_LEVEL = GUID("{de094ca0-c65a-11dc-ba21-005056c00008}")
+# The next category guid is NOT based on a column (see
+# ViewCategoryProvider::EnumCategories()...)
+CAT_GUID_VALUE = "{de094ca1-c65a-11dc-ba21-005056c00008}"
+
+GUID_Display = GUID("{4d6c2fdd-c689-11dc-ba21-005056c00008}")
+GUID_Settings = GUID("{4d6c2fde-c689-11dc-ba21-005056c00008}")
+GUID_Setting1 = GUID("{4d6c2fdf-c689-11dc-ba21-005056c00008}")
+GUID_Setting2 = GUID("{4d6c2fe0-c689-11dc-ba21-005056c00008}")
+GUID_Setting3 = GUID("{4d6c2fe1-c689-11dc-ba21-005056c00008}")
+
+# Hrm - not sure what to do about the std keys.
+# Probably need a simple parser for propkey.h
+PKEY_ItemNameDisplay = ("{B725F130-47EF-101A-A5F1-02608C9EEBAC}", 10)
+PKEY_PropList_PreviewDetails = ("{C9944A21-A406-48FE-8225-AEC7E24C211B}", 8)
+
+# Not sure what the "3" here refers to - docs say PID_FIRST_USABLE (2) be
+# used.  Presumably it is the 'propID' value in the .propdesc file!
+# note that the following GUIDs are also references in the .propdesc file
+PID_SOMETHING = 3
+# These are our 'private' PKEYs
+# Col 2, name="Sample.AreaSize"
+PKEY_Sample_AreaSize = ("{d6f5e341-c65c-11dc-ba21-005056c00008}", PID_SOMETHING)
+# Col 3, name="Sample.NumberOfSides"
+PKEY_Sample_NumberOfSides = ("{d6f5e342-c65c-11dc-ba21-005056c00008}", PID_SOMETHING)
+# Col 4, name="Sample.DirectoryLevel"
+PKEY_Sample_DirectoryLevel = ("{d6f5e343-c65c-11dc-ba21-005056c00008}", PID_SOMETHING)
+
+
+# We construct a PIDL from a pickle of a dict - turn it back into a
+# dict (we should *never* be called with a PIDL that the last elt is not
+# ours, so it is safe to assume we created it (assume->"ass" = "u" + "me" :)
+def pidl_to_item(pidl):
+    # Note that only the *last* elt in the PIDL is certainly ours,
+    # but it contains everything we need encoded as a dict.
+    return pickle.loads(pidl[-1])
+
+
+# Start of msdn sample port...
+# make_item_enum replaces the sample's entire EnumIDList.cpp :)
+def make_item_enum(level, flags):
+    pidls = []
+    nums = """zero one two three four five size seven eight nine ten""".split()
+    for i, name in enumerate(nums):
+        size = random.randint(0, 255)
+        sides = 1
+        while sides in [1, 2]:
+            sides = random.randint(0, 5)
+        is_folder = (i % 2) != 0
+        # check the flags say to include it.
+        # (This seems strange; if you ask the same folder for, but appear
+        skip = False
+        if not (flags & shellcon.SHCONTF_STORAGE):
+            if is_folder:
+                skip = not (flags & shellcon.SHCONTF_FOLDERS)
+            else:
+                skip = not (flags & shellcon.SHCONTF_NONFOLDERS)
+        if not skip:
+            data = dict(
+                name=name, size=size, sides=sides, level=level, is_folder=is_folder
+            )
+            pidls.append([pickle.dumps(data)])
+    return NewEnum(pidls, shell.IID_IEnumIDList)
+
+
+# start of Utils.cpp port
+def DisplayItem(shell_item_array, hwnd_parent=0):
+    # Get the first ShellItem and display its name
+    if shell_item_array is None:
+        msg = "You must select something!"
+    else:
+        si = shell_item_array.GetItemAt(0)
+        name = si.GetDisplayName(shellcon.SIGDN_NORMALDISPLAY)
+        msg = "%d items selected, first is %r" % (shell_item_array.GetCount(), name)
+    win32gui.MessageBox(hwnd_parent, msg, "Hello", win32con.MB_OK)
+
+
+# end of Utils.cpp port
+
+
+# start of sample's FVCommands.cpp port
+class Command:
+    def __init__(self, guid, ids, ids_tt, idi, flags, callback, children):
+        self.guid = guid
+        self.ids = ids
+        self.ids_tt = ids_tt
+        self.idi = idi
+        self.flags = flags
+        self.callback = callback
+        self.children = children
+        assert not children or isinstance(children[0], Command)
+
+    def tuple(self):
+        return (
+            self.guid,
+            self.ids,
+            self.ids_tt,
+            self.idi,
+            self.flags,
+            self.callback,
+            self.children,
+        )
+
+
+# command callbacks - called back directly by us - see ExplorerCommand.Invoke
+def onDisplay(items, bindctx):
+    DisplayItem(items)
+
+
+def onSetting1(items, bindctx):
+    win32gui.MessageBox(0, LoadString(IDS_SETTING1), "Hello", win32con.MB_OK)
+
+
+def onSetting2(items, bindctx):
+    win32gui.MessageBox(0, LoadString(IDS_SETTING2), "Hello", win32con.MB_OK)
+
+
+def onSetting3(items, bindctx):
+    win32gui.MessageBox(0, LoadString(IDS_SETTING3), "Hello", win32con.MB_OK)
+
+
+taskSettings = [
+    Command(
+        GUID_Setting1, IDS_SETTING1, IDS_SETTING1_TT, IDI_SETTINGS, 0, onSetting1, None
+    ),
+    Command(
+        GUID_Setting2, IDS_SETTING2, IDS_SETTING2_TT, IDI_SETTINGS, 0, onSetting2, None
+    ),
+    Command(
+        GUID_Setting3, IDS_SETTING3, IDS_SETTING3_TT, IDI_SETTINGS, 0, onSetting3, None
+    ),
+]
+
+tasks = [
+    Command(GUID_Display, IDS_DISPLAY, IDS_DISPLAY_TT, IDI_ICON1, 0, onDisplay, None),
+    Command(
+        GUID_Settings,
+        IDS_SETTINGS,
+        IDS_SETTINGS_TT,
+        IDI_SETTINGS,
+        shellcon.ECF_HASSUBCOMMANDS,
+        None,
+        taskSettings,
+    ),
+]
+
+
+class ExplorerCommandProvider:
+    _com_interfaces_ = [shell.IID_IExplorerCommandProvider]
+    _public_methods_ = shellcon.IExplorerCommandProvider_Methods
+
+    def GetCommands(self, site, iid):
+        items = [wrap(ExplorerCommand(t)) for t in tasks]
+        return NewEnum(items, shell.IID_IEnumExplorerCommand)
+
+
+class ExplorerCommand:
+    _com_interfaces_ = [shell.IID_IExplorerCommand]
+    _public_methods_ = shellcon.IExplorerCommand_Methods
+
+    def __init__(self, cmd):
+        self.cmd = cmd
+
+    # The sample also appears to ignore the pidl args!?
+    def GetTitle(self, pidl):
+        return LoadString(self.cmd.ids)
+
+    def GetToolTip(self, pidl):
+        return LoadString(self.cmd.ids_tt)
+
+    def GetIcon(self, pidl):
+        # Return a string of the usual "dll,resource_id" format
+        # todo - just return any ".ico that comes with python" + ",0" :)
+        raise COMException(hresult=winerror.E_NOTIMPL)
+
+    def GetState(self, shell_items, slow_ok):
+        return shellcon.ECS_ENABLED
+
+    def GetFlags(self):
+        return self.cmd.flags
+
+    def GetCanonicalName(self):
+        return self.cmd.guid
+
+    def Invoke(self, items, bind_ctx):
+        # If no function defined - just return S_OK
+        if self.cmd.callback:
+            self.cmd.callback(items, bind_ctx)
+        else:
+            print("No callback for command ", LoadString(self.cmd.ids))
+
+    def EnumSubCommands(self):
+        if not self.cmd.children:
+            return None
+        items = [wrap(ExplorerCommand(c)) for c in self.cmd.children]
+        return NewEnum(items, shell.IID_IEnumExplorerCommand)
+
+
+# end of sample's FVCommands.cpp port
+
+
+# start of sample's Category.cpp port
+class FolderViewCategorizer:
+    _com_interfaces_ = [shell.IID_ICategorizer]
+    _public_methods_ = shellcon.ICategorizer_Methods
+
+    description = None  # subclasses should set their own
+
+    def __init__(self, shell_folder):
+        self.sf = shell_folder
+
+    #  Determines the relative order of two items in their item identifier lists.
+    def CompareCategory(self, flags, cat1, cat2):
+        return cat1 - cat2
+
+    #  Retrieves the name of a categorizer, such as "Group By Device
+    #  Type", that can be displayed in the user interface.
+    def GetDescription(self, cch):
+        return self.description
+
+    # Retrieves information about a category, such as the default
+    # display and the text to display in the user interface.
+    def GetCategoryInfo(self, catid):
+        # Note: this isn't always appropriate!  See overrides below
+        return 0, str(catid)  # ????
+
+
+class FolderViewCategorizer_Name(FolderViewCategorizer):
+    description = "Alphabetical"
+
+    def GetCategory(self, pidls):
+        ret = []
+        for pidl in pidls:
+            val = self.sf.GetDetailsEx(pidl, PKEY_ItemNameDisplay)
+            ret.append(val)
+        return ret
+
+
+class FolderViewCategorizer_Size(FolderViewCategorizer):
+    description = "Group By Size"
+
+    def GetCategory(self, pidls):
+        ret = []
+        for pidl in pidls:
+            # Why don't we just get the size of the PIDL?
+            val = self.sf.GetDetailsEx(pidl, PKEY_Sample_AreaSize)
+            val = int(val)  # it probably came in a VT_BSTR variant
+            if val < 255 // 3:
+                cid = IDS_SMALL
+            elif val < 2 * 255 // 3:
+                cid = IDS_MEDIUM
+            else:
+                cid = IDS_LARGE
+            ret.append(cid)
+        return ret
+
+    def GetCategoryInfo(self, catid):
+        return 0, LoadString(catid)
+
+
+class FolderViewCategorizer_Sides(FolderViewCategorizer):
+    description = "Group By Sides"
+
+    def GetCategory(self, pidls):
+        ret = []
+        for pidl in pidls:
+            val = self.sf.GetDetailsEx(pidl, PKEY_ItemNameDisplay)
+            if val == 0:
+                cid = IDS_CIRCLE
+            elif val == 3:
+                cid = IDS_TRIANGLE
+            elif val == 4:
+                cid = IDS_RECTANGLE
+            elif val == 5:
+                cid = IDS_POLYGON
+            else:
+                cid = IDS_UNSPECIFIED
+            ret.append(cid)
+        return ret
+
+    def GetCategoryInfo(self, catid):
+        return 0, LoadString(catid)
+
+
+class FolderViewCategorizer_Value(FolderViewCategorizer):
+    description = "Group By Value"
+
+    def GetCategory(self, pidls):
+        ret = []
+        for pidl in pidls:
+            val = self.sf.GetDetailsEx(pidl, PKEY_ItemNameDisplay)
+            if val in "one two three four".split():
+                ret.append(IDS_LESSTHAN5)
+            else:
+                ret.append(IDS_5ORGREATER)
+        return ret
+
+    def GetCategoryInfo(self, catid):
+        return 0, LoadString(catid)
+
+
+class FolderViewCategorizer_Level(FolderViewCategorizer):
+    description = "Group By Value"
+
+    def GetCategory(self, pidls):
+        return [
+            self.sf.GetDetailsEx(pidl, PKEY_Sample_DirectoryLevel) for pidl in pidls
+        ]
+
+
+class ViewCategoryProvider:
+    _com_interfaces_ = [shell.IID_ICategoryProvider]
+    _public_methods_ = shellcon.ICategoryProvider_Methods
+
+    def __init__(self, shell_folder):
+        self.shell_folder = shell_folder
+
+    def CanCategorizeOnSCID(self, pkey):
+        return pkey in [
+            PKEY_ItemNameDisplay,
+            PKEY_Sample_AreaSize,
+            PKEY_Sample_NumberOfSides,
+            PKEY_Sample_DirectoryLevel,
+        ]
+
+    #  Creates a category object.
+    def CreateCategory(self, guid, iid):
+        if iid == shell.IID_ICategorizer:
+            if guid == CAT_GUID_NAME:
+                klass = FolderViewCategorizer_Name
+            elif guid == CAT_GUID_SIDES:
+                klass = FolderViewCategorizer_Sides
+            elif guid == CAT_GUID_SIZE:
+                klass = FolderViewCategorizer_Size
+            elif guid == CAT_GUID_VALUE:
+                klass = FolderViewCategorizer_Value
+            elif guid == CAT_GUID_LEVEL:
+                klass = FolderViewCategorizer_Level
+            else:
+                raise COMException(hresult=winerror.E_INVALIDARG)
+            return wrap(klass(self.shell_folder))
+        raise COMException(hresult=winerror.E_NOINTERFACE)
+
+    #  Retrieves the enumerator for the categories.
+    def EnumCategories(self):
+        # These are additional categories beyond the columns
+        seq = [CAT_GUID_VALUE]
+        return NewEnum(seq, pythoncom.IID_IEnumGUID)
+
+    #  Retrieves a globally unique identifier (GUID) that represents
+    #  the categorizer to use for the specified Shell column.
+    def GetCategoryForSCID(self, scid):
+        if scid == PKEY_ItemNameDisplay:
+            guid = CAT_GUID_NAME
+        elif scid == PKEY_Sample_AreaSize:
+            guid = CAT_GUID_SIZE
+        elif scid == PKEY_Sample_NumberOfSides:
+            guid = CAT_GUID_SIDES
+        elif scid == PKEY_Sample_DirectoryLevel:
+            guid = CAT_GUID_LEVEL
+        elif scid == pythoncom.IID_NULL:
+            # This can be called with a NULL
+            # format ID. This will happen if you have a category,
+            # not based on a column, that gets stored in the
+            # property bag. When a return is made to this item,
+            # it will call this function with a NULL format id.
+            guid = CAT_GUID_VALUE
+        else:
+            raise COMException(hresult=winerror.E_INVALIDARG)
+        return guid
+
+    #  Retrieves the name of the specified category. This is where
+    #  additional categories that appear under the column
+    #  related categories in the UI, get their display names.
+    def GetCategoryName(self, guid, cch):
+        if guid == CAT_GUID_VALUE:
+            return "Value"
+        raise COMException(hresult=winerror.E_FAIL)
+
+    #  Enables the folder to override the default grouping.
+    def GetDefaultCategory(self):
+        return CAT_GUID_LEVEL, (pythoncom.IID_NULL, 0)
+
+
+# end of sample's Category.cpp port
+
+# start of sample's ContextMenu.cpp port
+MENUVERB_DISPLAY = 0
+
+folderViewImplContextMenuIDs = [
+    (
+        "display",
+        MENUVERB_DISPLAY,
+        0,
+    ),
+]
+
+
+class ContextMenu:
+    _reg_progid_ = "Python.ShellFolderSample.ContextMenu"
+    _reg_desc_ = "Python FolderView Context Menu"
+    _reg_clsid_ = "{fed40039-021f-4011-87c5-6188b9979764}"
+    _com_interfaces_ = [
+        shell.IID_IShellExtInit,
+        shell.IID_IContextMenu,
+        axcontrol.IID_IObjectWithSite,
+    ]
+    _public_methods_ = (
+        shellcon.IContextMenu_Methods
+        + shellcon.IShellExtInit_Methods
+        + ["GetSite", "SetSite"]
+    )
+    _context_menu_type_ = "PythonFolderViewSampleType"
+
+    def __init__(self):
+        self.site = None
+        self.dataobj = None
+
+    def Initialize(self, folder, dataobj, hkey):
+        self.dataobj = dataobj
+
+    def QueryContextMenu(self, hMenu, indexMenu, idCmdFirst, idCmdLast, uFlags):
+        s = LoadString(IDS_DISPLAY)
+        win32gui.InsertMenu(
+            hMenu, indexMenu, win32con.MF_BYPOSITION, idCmdFirst + MENUVERB_DISPLAY, s
+        )
+        indexMenu += 1
+        # other verbs could go here...
+
+        # indicate that we added one verb.
+        return 1
+
+    def InvokeCommand(self, ci):
+        mask, hwnd, verb, params, dir, nShow, hotkey, hicon = ci
+        # this seems very convuluted, but its what the sample does :)
+        for verb_name, verb_id, flag in folderViewImplContextMenuIDs:
+            if isinstance(verb, int):
+                matches = verb == verb_id
+            else:
+                matches = verb == verb_name
+            if matches:
+                break
+        else:
+            assert False, ci  # failed to find our ID
+        if verb_id == MENUVERB_DISPLAY:
+            sia = shell.SHCreateShellItemArrayFromDataObject(self.dataobj)
+            DisplayItem(hwnd, sia)
+        else:
+            assert False, ci  # Got some verb we weren't expecting?
+
+    def GetCommandString(self, cmd, typ):
+        raise COMException(hresult=winerror.E_NOTIMPL)
+
+    def SetSite(self, site):
+        self.site = site
+
+    def GetSite(self, iid):
+        return self.site
+
+
+# end of sample's ContextMenu.cpp port
+
+
+# start of sample's ShellFolder.cpp port
+class ShellFolder:
+    _com_interfaces_ = [
+        shell.IID_IBrowserFrameOptions,
+        pythoncom.IID_IPersist,
+        shell.IID_IPersistFolder,
+        shell.IID_IPersistFolder2,
+        shell.IID_IShellFolder,
+        shell.IID_IShellFolder2,
+    ]
+
+    _public_methods_ = (
+        shellcon.IBrowserFrame_Methods
+        + shellcon.IPersistFolder2_Methods
+        + shellcon.IShellFolder2_Methods
+    )
+
+    _reg_progid_ = "Python.ShellFolderSample.Folder2"
+    _reg_desc_ = "Python FolderView sample"
+    _reg_clsid_ = "{bb8c24ad-6aaa-4cec-ac5e-c429d5f57627}"
+
+    max_levels = 5
+
+    def __init__(self, level=0):
+        self.current_level = level
+        self.pidl = None  # set when Initialize is called
+
+    def ParseDisplayName(self, hwnd, reserved, displayName, attr):
+        # print "ParseDisplayName", displayName
+        raise COMException(hresult=winerror.E_NOTIMPL)
+
+    def EnumObjects(self, hwndOwner, flags):
+        if self.current_level >= self.max_levels:
+            return None
+        return make_item_enum(self.current_level + 1, flags)
+
+    def BindToObject(self, pidl, bc, iid):
+        tail = pidl_to_item(pidl)
+        # assert tail['is_folder'], "BindToObject should only be called on folders?"
+        # *sob*
+        # No point creating object just to have QI fail.
+        if iid not in ShellFolder._com_interfaces_:
+            raise COMException(hresult=winerror.E_NOTIMPL)
+        child = ShellFolder(self.current_level + 1)
+        # hrmph - not sure what multiple PIDLs here mean?
+        #        assert len(pidl)==1, pidl # expecting just relative child PIDL
+        child.Initialize(self.pidl + pidl)
+        return wrap(child, iid)
+
+    def BindToStorage(self, pidl, bc, iid):
+        return self.BindToObject(pidl, bc, iid)
+
+    def CompareIDs(self, param, id1, id2):
+        return 0  # XXX - todo - implement this!
+
+    def CreateViewObject(self, hwnd, iid):
+        if iid == shell.IID_IShellView:
+            com_folder = wrap(self)
+            return shell.SHCreateShellFolderView(com_folder)
+        elif iid == shell.IID_ICategoryProvider:
+            return wrap(ViewCategoryProvider(self))
+        elif iid == shell.IID_IContextMenu:
+            ws = wrap(self)
+            dcm = (hwnd, None, self.pidl, ws, None)
+            return shell.SHCreateDefaultContextMenu(dcm, iid)
+        elif iid == shell.IID_IExplorerCommandProvider:
+            return wrap(ExplorerCommandProvider())
+        else:
+            raise COMException(hresult=winerror.E_NOINTERFACE)
+
+    def GetAttributesOf(self, pidls, attrFlags):
+        assert len(pidls) == 1, "sample only expects 1 too!"
+        assert len(pidls[0]) == 1, "expect relative pidls!"
+        item = pidl_to_item(pidls[0])
+        flags = 0
+        if item["is_folder"]:
+            flags |= shellcon.SFGAO_FOLDER
+        if item["level"] < self.max_levels:
+            flags |= shellcon.SFGAO_HASSUBFOLDER
+        return flags
+
+    #  Retrieves an OLE interface that can be used to carry out
+    #  actions on the specified file objects or folders.
+    def GetUIObjectOf(self, hwndOwner, pidls, iid, inout):
+        assert len(pidls) == 1, "oops - arent expecting more than one!"
+        assert len(pidls[0]) == 1, "assuming relative pidls!"
+        item = pidl_to_item(pidls[0])
+        if iid == shell.IID_IContextMenu:
+            ws = wrap(self)
+            dcm = (hwndOwner, None, self.pidl, ws, pidls)
+            return shell.SHCreateDefaultContextMenu(dcm, iid)
+        elif iid == shell.IID_IExtractIconW:
+            dxi = shell.SHCreateDefaultExtractIcon()
+            # dxi is IDefaultExtractIconInit
+            if item["is_folder"]:
+                dxi.SetNormalIcon("shell32.dll", 4)
+            else:
+                dxi.SetNormalIcon("shell32.dll", 1)
+            # just return the dxi - let Python QI for IID_IExtractIconW
+            return dxi
+
+        elif iid == pythoncom.IID_IDataObject:
+            return shell.SHCreateDataObject(self.pidl, pidls, None, iid)
+
+        elif iid == shell.IID_IQueryAssociations:
+            elts = []
+            if item["is_folder"]:
+                elts.append((shellcon.ASSOCCLASS_FOLDER, None, None))
+            elts.append(
+                (shellcon.ASSOCCLASS_PROGID_STR, None, ContextMenu._context_menu_type_)
+            )
+            return shell.AssocCreateForClasses(elts, iid)
+
+        raise COMException(hresult=winerror.E_NOINTERFACE)
+
+    #  Retrieves the display name for the specified file object or subfolder.
+    def GetDisplayNameOf(self, pidl, flags):
+        item = pidl_to_item(pidl)
+        if flags & shellcon.SHGDN_FORPARSING:
+            if flags & shellcon.SHGDN_INFOLDER:
+                return item["name"]
+            else:
+                if flags & shellcon.SHGDN_FORADDRESSBAR:
+                    sigdn = shellcon.SIGDN_DESKTOPABSOLUTEEDITING
+                else:
+                    sigdn = shellcon.SIGDN_DESKTOPABSOLUTEPARSING
+                parent = shell.SHGetNameFromIDList(self.pidl, sigdn)
+                return parent + "\\" + item["name"]
+        else:
+            return item["name"]
+
+    def SetNameOf(self, hwndOwner, pidl, new_name, flags):
+        raise COMException(hresult=winerror.E_NOTIMPL)
+
+    def GetClassID(self):
+        return self._reg_clsid_
+
+    #  IPersistFolder method
+    def Initialize(self, pidl):
+        self.pidl = pidl
+
+    #  IShellFolder2 methods
+    def EnumSearches(self):
+        raise COMException(hresult=winerror.E_NOINTERFACE)
+
+    #  Retrieves the default sorting and display columns.
+    def GetDefaultColumn(self, dwres):
+        # result is (sort, display)
+        return 0, 0
+
+    #  Retrieves the default state for a specified column.
+    def GetDefaultColumnState(self, iCol):
+        if iCol < 3:
+            return shellcon.SHCOLSTATE_ONBYDEFAULT | shellcon.SHCOLSTATE_TYPE_STR
+        raise COMException(hresult=winerror.E_INVALIDARG)
+
+    #  Requests the GUID of the default search object for the folder.
+    def GetDefaultSearchGUID(self):
+        raise COMException(hresult=winerror.E_NOTIMPL)
+
+    #  Helper function for getting the display name for a column.
+    def _GetColumnDisplayName(self, pidl, pkey):
+        item = pidl_to_item(pidl)
+        is_folder = item["is_folder"]
+        if pkey == PKEY_ItemNameDisplay:
+            val = item["name"]
+        elif pkey == PKEY_Sample_AreaSize and not is_folder:
+            val = "%d Sq. Ft." % item["size"]
+        elif pkey == PKEY_Sample_NumberOfSides and not is_folder:
+            val = str(item["sides"])  # not sure why str()
+        elif pkey == PKEY_Sample_DirectoryLevel:
+            val = str(item["level"])
+        else:
+            val = ""
+        return val
+
+    #  Retrieves detailed information, identified by a
+    #  property set ID (FMTID) and property ID (PID),
+    #  on an item in a Shell folder.
+    def GetDetailsEx(self, pidl, pkey):
+        item = pidl_to_item(pidl)
+        is_folder = item["is_folder"]
+        if not is_folder and pkey == PKEY_PropList_PreviewDetails:
+            return "prop:Sample.AreaSize;Sample.NumberOfSides;Sample.DirectoryLevel"
+        return self._GetColumnDisplayName(pidl, pkey)
+
+    #  Retrieves detailed information, identified by a
+    #  column index, on an item in a Shell folder.
+    def GetDetailsOf(self, pidl, iCol):
+        key = self.MapColumnToSCID(iCol)
+        if pidl is None:
+            data = [
+                (commctrl.LVCFMT_LEFT, "Name"),
+                (commctrl.LVCFMT_CENTER, "Size"),
+                (commctrl.LVCFMT_CENTER, "Sides"),
+                (commctrl.LVCFMT_CENTER, "Level"),
+            ]
+            if iCol >= len(data):
+                raise COMException(hresult=winerror.E_FAIL)
+            fmt, val = data[iCol]
+        else:
+            fmt = 0  # ?
+            val = self._GetColumnDisplayName(pidl, key)
+        cxChar = 24
+        return fmt, cxChar, val
+
+    #  Converts a column name to the appropriate
+    #  property set ID (FMTID) and property ID (PID).
+    def MapColumnToSCID(self, iCol):
+        data = [
+            PKEY_ItemNameDisplay,
+            PKEY_Sample_AreaSize,
+            PKEY_Sample_NumberOfSides,
+            PKEY_Sample_DirectoryLevel,
+        ]
+        if iCol >= len(data):
+            raise COMException(hresult=winerror.E_FAIL)
+        return data[iCol]
+
+    #  IPersistFolder2 methods
+    #  Retrieves the PIDLIST_ABSOLUTE for the folder object.
+    def GetCurFolder(self):
+        # The docs say this is OK, but I suspect its a problem in this case :)
+        # assert self.pidl, "haven't been initialized?"
+        return self.pidl
+
+
+# end of sample's ShellFolder.cpp port
+
+
+def get_schema_fname():
+    me = win32api.GetFullPathName(__file__)
+    sc = os.path.splitext(me)[0] + ".propdesc"
+    assert os.path.isfile(sc), sc
+    return sc
+
+
+def DllRegisterServer():
+    import winreg
+
+    if sys.getwindowsversion()[0] < 6:
+        print("This sample only works on Vista")
+        sys.exit(1)
+
+    key = winreg.CreateKey(
+        winreg.HKEY_LOCAL_MACHINE,
+        "SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\"
+        "Explorer\\Desktop\\Namespace\\" + ShellFolder._reg_clsid_,
+    )
+    winreg.SetValueEx(key, None, 0, winreg.REG_SZ, ShellFolder._reg_desc_)
+    # And special shell keys under our CLSID
+    key = winreg.CreateKey(
+        winreg.HKEY_CLASSES_ROOT, "CLSID\\" + ShellFolder._reg_clsid_ + "\\ShellFolder"
+    )
+    # 'Attributes' is an int stored as a binary! use struct
+    attr = (
+        shellcon.SFGAO_FOLDER | shellcon.SFGAO_HASSUBFOLDER | shellcon.SFGAO_BROWSABLE
+    )
+    import struct
+
+    s = struct.pack("i", attr)
+    winreg.SetValueEx(key, "Attributes", 0, winreg.REG_BINARY, s)
+    # register the context menu handler under the FolderViewSampleType type.
+    keypath = "%s\\shellex\\ContextMenuHandlers\\%s" % (
+        ContextMenu._context_menu_type_,
+        ContextMenu._reg_desc_,
+    )
+    key = winreg.CreateKey(winreg.HKEY_CLASSES_ROOT, keypath)
+    winreg.SetValueEx(key, None, 0, winreg.REG_SZ, ContextMenu._reg_clsid_)
+    propsys.PSRegisterPropertySchema(get_schema_fname())
+    print(ShellFolder._reg_desc_, "registration complete.")
+
+
+def DllUnregisterServer():
+    import winreg
+
+    paths = [
+        "SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Explorer\\Desktop\\Namespace\\"
+        + ShellFolder._reg_clsid_,
+        "%s\\shellex\\ContextMenuHandlers\\%s"
+        % (ContextMenu._context_menu_type_, ContextMenu._reg_desc_),
+    ]
+    for path in paths:
+        try:
+            winreg.DeleteKey(winreg.HKEY_LOCAL_MACHINE, path)
+        except WindowsError as details:
+            import errno
+
+            if details.errno != errno.ENOENT:
+                print("FAILED to remove %s: %s" % (path, details))
+
+    propsys.PSUnregisterPropertySchema(get_schema_fname())
+    print(ShellFolder._reg_desc_, "unregistration complete.")
+
+
+if __name__ == "__main__":
+    from win32com.server import register
+
+    register.UseCommandLine(
+        ShellFolder,
+        ContextMenu,
+        debug=debug,
+        finalize_register=DllRegisterServer,
+        finalize_unregister=DllUnregisterServer,
+    )
diff --git a/lib/win32comext/shell/demos/servers/icon_handler.py b/lib/win32comext/shell/demos/servers/icon_handler.py
new file mode 100644
index 00000000..57aa3611
--- /dev/null
+++ b/lib/win32comext/shell/demos/servers/icon_handler.py
@@ -0,0 +1,82 @@
+# A sample icon handler.  Sets the icon for Python files to a random
+# ICO file.  ICO files are found in the Python directory - generally there will
+# be 3 icons found.
+#
+# To demostrate:
+# * Execute this script to register the context menu.
+# * Open Windows Explorer, and browse to a directory with a .py file.
+# * Note the pretty, random selection of icons!
+# Use glob to locate ico files, and random.choice to pick one.
+import glob
+import os
+import random
+import sys
+
+import pythoncom
+import win32gui
+import winerror
+from win32com.shell import shell, shellcon
+
+ico_files = glob.glob(os.path.join(sys.prefix, "*.ico"))
+if not ico_files:
+    ico_files = glob.glob(os.path.join(sys.prefix, "PC", "*.ico"))
+if not ico_files:
+    print("WARNING: Can't find any icon files")
+
+# Our shell extension.
+IExtractIcon_Methods = "Extract GetIconLocation".split()
+IPersistFile_Methods = "IsDirty Load Save SaveCompleted GetCurFile".split()
+
+
+class ShellExtension:
+    _reg_progid_ = "Python.ShellExtension.IconHandler"
+    _reg_desc_ = "Python Sample Shell Extension (icon handler)"
+    _reg_clsid_ = "{a97e32d7-3b78-448c-b341-418120ea9227}"
+    _com_interfaces_ = [shell.IID_IExtractIcon, pythoncom.IID_IPersistFile]
+    _public_methods_ = IExtractIcon_Methods + IPersistFile_Methods
+
+    def Load(self, filename, mode):
+        self.filename = filename
+        self.mode = mode
+
+    def GetIconLocation(self, flags):
+        # note - returning a single int will set the HRESULT (eg, S_FALSE,
+        # E_PENDING - see MS docs for details.
+        return random.choice(ico_files), 0, 0
+
+    def Extract(self, fname, index, size):
+        return winerror.S_FALSE
+
+
+def DllRegisterServer():
+    import winreg
+
+    key = winreg.CreateKey(winreg.HKEY_CLASSES_ROOT, "Python.File\\shellex")
+    subkey = winreg.CreateKey(key, "IconHandler")
+    winreg.SetValueEx(subkey, None, 0, winreg.REG_SZ, ShellExtension._reg_clsid_)
+    print(ShellExtension._reg_desc_, "registration complete.")
+
+
+def DllUnregisterServer():
+    import winreg
+
+    try:
+        key = winreg.DeleteKey(
+            winreg.HKEY_CLASSES_ROOT, "Python.File\\shellex\\IconHandler"
+        )
+    except WindowsError as details:
+        import errno
+
+        if details.errno != errno.ENOENT:
+            raise
+    print(ShellExtension._reg_desc_, "unregistration complete.")
+
+
+if __name__ == "__main__":
+    from win32com.server import register
+
+    register.UseCommandLine(
+        ShellExtension,
+        finalize_register=DllRegisterServer,
+        finalize_unregister=DllUnregisterServer,
+    )
diff --git a/lib/win32comext/shell/demos/servers/shell_view.py b/lib/win32comext/shell/demos/servers/shell_view.py
new file mode 100644
index 00000000..7d8bc51b
--- /dev/null
+++ b/lib/win32comext/shell/demos/servers/shell_view.py
@@ -0,0 +1,972 @@
+# A sample shell namespace view
+
+# To demostrate:
+# * Execute this script to register the namespace.
+# * Open Windows Explorer, and locate the new "Python Path Shell Browser"
+#   folder off "My Computer"
+# * Browse this tree - .py files are shown expandable, with classes and
+#   methods selectable.  Selecting a Python file, or a class/method, will
+#   display the file using Scintilla.
+# Known problems:
+# * Classes and methods don't have icons - this is a demo, so we keep it small
+#   See icon_handler.py for examples of how to work with icons.
+#
+#
+# Notes on PIDLs
+# PIDLS are complicated, but fairly well documented in MSDN.  If you need to
+# do much with these shell extensions, you must understand their concept.
+# Here is a short-course, as it applies to this sample:
+# A PIDL identifies an item, much in the same way that a filename does
+# (however, the shell is not limited to displaying "files").
+# An "ItemID" is a single string, each being an item in the hierarchy.
+# A "PIDL" is a list of these strings.
+# All shell etc functions work with PIDLs, so even in the case where
+# an ItemID is conceptually used, a 1-item list is always used.
+# Conceptually, think of:
+#    pidl = pathname.split("\\") # pidl is a list of "parent" items.
+#    # each item is a string 'item id', but these are ever used directly
+# As there is no concept of passing a single item, to open a file using only
+# a relative filename, conceptually you would say:
+#   open_file([filename]) # Pass a single-itemed relative "PIDL"
+# and continuing the analogy, a "listdir" type function would return a list
+# of single-itemed lists - each list containing the relative PIDL of the child.
+#
+# Each PIDL entry is a binary string, and may contain any character.  For
+# PIDLs not created by you, they can not be interpreted - they are just
+# blobs.  PIDLs created by you (ie, children of your IShellFolder) can
+# store and interpret the string however makes most sense for your application.
+# (but within PIDL rules - they must be persistable, etc)
+# There is no reason that pickled strings, for example, couldn't be used
+# as an EntryID.
+# This application takes a simple approach - each PIDL is a string of form
+# "directory\0directory_name", "file\0file_name" or
+# "object\0file_name\0class_name[.method_name"
+# The first string in each example is literal (ie, the word 'directory',
+# 'file' or 'object', and every other string is variable.  We use '\0' as
+# a field sep just 'cos we can (and 'cos it can't possibly conflict with the
+# string content)
+
+import _thread
+import os
+import pyclbr
+import sys
+
+import commctrl
+import pythoncom
+import win32api
+import win32con
+import win32gui
+import win32gui_struct
+import winerror
+from pywin.scintilla import scintillacon
+from win32com.server.exception import COMException
+from win32com.server.util import NewEnum, wrap
+from win32com.shell import shell, shellcon
+from win32com.util import IIDToInterfaceName
+
+# Set this to 1 to cause debug version to be registered and used.  A debug
+# version will spew output to win32traceutil.
+debug = 0
+if debug:
+    import win32traceutil
+
+# markh is toying with an implementation that allows auto reload of a module
+# if this attribute exists.
+com_auto_reload = True
+
+
+# Helper function to get a system IShellFolder interface, and the PIDL within
+# that folder for an existing file/directory.
+def GetFolderAndPIDLForPath(filename):
+    desktop = shell.SHGetDesktopFolder()
+    info = desktop.ParseDisplayName(0, None, os.path.abspath(filename))
+    cchEaten, pidl, attr = info
+    # We must walk the ID list, looking for one child at a time.
+    folder = desktop
+    while len(pidl) > 1:
+        this = pidl.pop(0)
+        folder = folder.BindToObject([this], None, shell.IID_IShellFolder)
+    # We are left with the pidl for the specific item.  Leave it as
+    # a list, so it remains a valid PIDL.
+    return folder, pidl
+
+
+# A cache of pyclbr module objects, so we only parse a given filename once.
+clbr_modules = {}  # Indexed by path, item is dict as returned from pyclbr
+
+
+def get_clbr_for_file(path):
+    try:
+        objects = clbr_modules[path]
+    except KeyError:
+        dir, filename = os.path.split(path)
+        base, ext = os.path.splitext(filename)
+        objects = pyclbr.readmodule_ex(base, [dir])
+        clbr_modules[path] = objects
+    return objects
+
+
+# Our COM interfaces.
+
+
+# Base class for a shell folder.
+# All child classes use a simple PIDL of the form:
+#  "object_type\0object_name[\0extra ...]"
+class ShellFolderBase:
+    _com_interfaces_ = [
+        shell.IID_IBrowserFrameOptions,
+        pythoncom.IID_IPersist,
+        shell.IID_IPersistFolder,
+        shell.IID_IShellFolder,
+    ]
+
+    _public_methods_ = (
+        shellcon.IBrowserFrame_Methods
+        + shellcon.IPersistFolder_Methods
+        + shellcon.IShellFolder_Methods
+    )
+
+    def GetFrameOptions(self, mask):
+        # print "GetFrameOptions", self, mask
+        return 0
+
+    def ParseDisplayName(self, hwnd, reserved, displayName, attr):
+        print("ParseDisplayName", displayName)
+        # return cchEaten, pidl, attr
+
+    def BindToStorage(self, pidl, bc, iid):
+        print("BTS", iid, IIDToInterfaceName(iid))
+
+    def BindToObject(self, pidl, bc, iid):
+        # We may be passed a set of relative PIDLs here - ie
+        # [pidl_of_dir, pidl_of_child_dir, pidl_of_file, pidl_of_function]
+        # But each of our PIDLs keeps the fully qualified name anyway - so
+        # just jump directly to the last.
+        final_pidl = pidl[-1]
+        typ, extra = final_pidl.split("\0", 1)
+        if typ == "directory":
+            klass = ShellFolderDirectory
+        elif typ == "file":
+            klass = ShellFolderFile
+        elif typ == "object":
+            klass = ShellFolderObject
+        else:
+            raise RuntimeError("What is " + repr(typ))
+        ret = wrap(klass(extra), iid, useDispatcher=(debug > 0))
+        return ret
+
+
+# A ShellFolder for an object with CHILDREN on the file system
+# Note that this means our "File" folder is *not* a 'FileSystem' folder,
+# as it's children (functions and classes) are not on the file system.
+#
+class ShellFolderFileSystem(ShellFolderBase):
+    def _GetFolderAndPIDLForPIDL(self, my_idl):
+        typ, name = my_idl[0].split("\0")
+        return GetFolderAndPIDLForPath(name)
+
+    # Interface methods
+    def CompareIDs(self, param, id1, id2):
+        if id1 < id2:
+            return -1
+        if id1 == id2:
+            return 0
+        return 1
+
+    def GetUIObjectOf(self, hwndOwner, pidls, iid, inout):
+        # delegate to the shell.
+        assert len(pidls) == 1, "oops - arent expecting more than one!"
+        pidl = pidls[0]
+        folder, child_pidl = self._GetFolderAndPIDLForPIDL(pidl)
+        try:
+            inout, ret = folder.GetUIObjectOf(hwndOwner, [child_pidl], iid, inout, iid)
+        except pythoncom.com_error as exc:
+            raise COMException(hresult=exc.hresult)
+        return inout, ret
+        # return object of IID
+
+    def GetDisplayNameOf(self, pidl, flags):
+        # delegate to the shell.
+        folder, child_pidl = self._GetFolderAndPIDLForPIDL(pidl)
+        ret = folder.GetDisplayNameOf(child_pidl, flags)
+        return ret
+
+    def GetAttributesOf(self, pidls, attrFlags):
+        ret_flags = -1
+        for pidl in pidls:
+            pidl = pidl[0]  # ??
+            typ, name = pidl.split("\0")
+            flags = shellcon.SHGFI_ATTRIBUTES
+            rc, info = shell.SHGetFileInfo(name, 0, flags)
+            hIcon, iIcon, dwAttr, name, typeName = info
+            # All our items, even files, have sub-items
+            extras = (
+                shellcon.SFGAO_HASSUBFOLDER
+                | shellcon.SFGAO_FOLDER
+                | shellcon.SFGAO_FILESYSANCESTOR
+                | shellcon.SFGAO_BROWSABLE
+            )
+            ret_flags &= dwAttr | extras
+        return ret_flags
+
+
+class ShellFolderDirectory(ShellFolderFileSystem):
+    def __init__(self, path):
+        self.path = os.path.abspath(path)
+
+    def CreateViewObject(self, hwnd, iid):
+        # delegate to the shell.
+        folder, child_pidl = GetFolderAndPIDLForPath(self.path)
+        return folder.CreateViewObject(hwnd, iid)
+
+    def EnumObjects(self, hwndOwner, flags):
+        pidls = []
+        for fname in os.listdir(self.path):
+            fqn = os.path.join(self.path, fname)
+            if os.path.isdir(fqn):
+                type_name = "directory"
+                type_class = ShellFolderDirectory
+            else:
+                base, ext = os.path.splitext(fname)
+                if ext in [".py", ".pyw"]:
+                    type_class = ShellFolderFile
+                    type_name = "file"
+                else:
+                    type_class = None
+            if type_class is not None:
+                pidls.append([type_name + "\0" + fqn])
+        return NewEnum(pidls, iid=shell.IID_IEnumIDList, useDispatcher=(debug > 0))
+
+    def GetDisplayNameOf(self, pidl, flags):
+        final_pidl = pidl[-1]
+        full_fname = final_pidl.split("\0")[-1]
+        return os.path.split(full_fname)[-1]
+
+    def GetAttributesOf(self, pidls, attrFlags):
+        return (
+            shellcon.SFGAO_HASSUBFOLDER
+            | shellcon.SFGAO_FOLDER
+            | shellcon.SFGAO_FILESYSANCESTOR
+            | shellcon.SFGAO_BROWSABLE
+        )
+
+
+# As per comments above, even though this manages a file, it is *not* a
+# ShellFolderFileSystem, as the children are not on the file system.
+class ShellFolderFile(ShellFolderBase):
+    def __init__(self, path):
+        self.path = os.path.abspath(path)
+
+    def EnumObjects(self, hwndOwner, flags):
+        objects = get_clbr_for_file(self.path)
+        pidls = []
+        for name, ob in objects.items():
+            pidls.append(["object\0" + self.path + "\0" + name])
+        return NewEnum(pidls, iid=shell.IID_IEnumIDList, useDispatcher=(debug > 0))
+
+    def GetAttributesOf(self, pidls, attrFlags):
+        ret_flags = -1
+        for pidl in pidls:
+            assert len(pidl) == 1, "Expecting relative pidls"
+            pidl = pidl[0]
+            typ, filename, obname = pidl.split("\0")
+            obs = get_clbr_for_file(filename)
+            ob = obs[obname]
+            flags = (
+                shellcon.SFGAO_BROWSABLE
+                | shellcon.SFGAO_FOLDER
+                | shellcon.SFGAO_FILESYSANCESTOR
+            )
+            if hasattr(ob, "methods"):
+                flags |= shellcon.SFGAO_HASSUBFOLDER
+            ret_flags &= flags
+        return ret_flags
+
+    def GetDisplayNameOf(self, pidl, flags):
+        assert len(pidl) == 1, "Expecting relative PIDL"
+        typ, fname, obname = pidl[0].split("\0")
+        fqname = os.path.splitext(fname)[0] + "." + obname
+        if flags & shellcon.SHGDN_INFOLDER:
+            ret = obname
+        else:  # SHGDN_NORMAL is the default
+            ret = fqname
+        # No need to look at the SHGDN_FOR* modifiers.
+        return ret
+
+    def CreateViewObject(self, hwnd, iid):
+        return wrap(ScintillaShellView(hwnd, self.path), iid, useDispatcher=debug > 0)
+
+
+# A ShellFolder for our Python objects
+class ShellFolderObject(ShellFolderBase):
+    def __init__(self, details):
+        self.path, details = details.split("\0")
+        if details.find(".") > 0:
+            self.class_name, self.method_name = details.split(".")
+        else:
+            self.class_name = details
+            self.method_name = None
+
+    def CreateViewObject(self, hwnd, iid):
+        mod_objects = get_clbr_for_file(self.path)
+        object = mod_objects[self.class_name]
+        if self.method_name is None:
+            lineno = object.lineno
+        else:
+            lineno = object.methods[self.method_name]
+            return wrap(
+                ScintillaShellView(hwnd, self.path, lineno),
+                iid,
+                useDispatcher=debug > 0,
+            )
+
+    def EnumObjects(self, hwndOwner, flags):
+        assert self.method_name is None, "Should not be enuming methods!"
+        mod_objects = get_clbr_for_file(self.path)
+        my_objects = mod_objects[self.class_name]
+        pidls = []
+        for func_name, lineno in my_objects.methods.items():
+            pidl = ["object\0" + self.path + "\0" + self.class_name + "." + func_name]
+            pidls.append(pidl)
+        return NewEnum(pidls, iid=shell.IID_IEnumIDList, useDispatcher=(debug > 0))
+
+    def GetDisplayNameOf(self, pidl, flags):
+        assert len(pidl) == 1, "Expecting relative PIDL"
+        typ, fname, obname = pidl[0].split("\0")
+        class_name, method_name = obname.split(".")
+        fqname = os.path.splitext(fname)[0] + "." + obname
+        if flags & shellcon.SHGDN_INFOLDER:
+            ret = method_name
+        else:  # SHGDN_NORMAL is the default
+            ret = fqname
+        # No need to look at the SHGDN_FOR* modifiers.
+        return ret
+
+    def GetAttributesOf(self, pidls, attrFlags):
+        ret_flags = -1
+        for pidl in pidls:
+            assert len(pidl) == 1, "Expecting relative pidls"
+            flags = (
+                shellcon.SFGAO_BROWSABLE
+                | shellcon.SFGAO_FOLDER
+                | shellcon.SFGAO_FILESYSANCESTOR
+            )
+            ret_flags &= flags
+        return ret_flags
+
+
+# The "Root" folder of our namespace.  As all children are directories,
+# it is derived from ShellFolderFileSystem
+# This is the only COM object actually registered and externally created.
+class ShellFolderRoot(ShellFolderFileSystem):
+    _reg_progid_ = "Python.ShellExtension.Folder"
+    _reg_desc_ = "Python Path Shell Browser"
+    _reg_clsid_ = "{f6287035-3074-4cb5-a8a6-d3c80e206944}"
+
+    def GetClassID(self):
+        return self._reg_clsid_
+
+    def Initialize(self, pidl):
+        # This is the PIDL of us, as created by the shell.  This is our
+        # top-level ID.  All other items under us have PIDLs defined
+        # by us - see the notes at the top of the file.
+        # print "Initialize called with pidl", repr(pidl)
+        self.pidl = pidl
+
+    def CreateViewObject(self, hwnd, iid):
+        return wrap(FileSystemView(self, hwnd), iid, useDispatcher=debug > 0)
+
+    def EnumObjects(self, hwndOwner, flags):
+        items = [["directory\0" + p] for p in sys.path if os.path.isdir(p)]
+        return NewEnum(items, iid=shell.IID_IEnumIDList, useDispatcher=(debug > 0))
+
+    def GetDisplayNameOf(self, pidl, flags):
+        ## return full path for sys.path dirs, since they don't appear under a parent folder
+        final_pidl = pidl[-1]
+        display_name = final_pidl.split("\0")[-1]
+        return display_name
+
+
+# Simple shell view implementations
+
+
+# Uses a builtin listview control to display simple lists of directories
+# or filenames.
+class FileSystemView:
+    _public_methods_ = shellcon.IShellView_Methods
+    _com_interfaces_ = [
+        pythoncom.IID_IOleWindow,
+        shell.IID_IShellView,
+    ]
+
+    def __init__(self, folder, hwnd):
+        self.hwnd_parent = hwnd  # provided by explorer.
+        self.hwnd = None  # intermediate window for catching command notifications.
+        self.hwnd_child = None  # our ListView
+        self.activate_state = None
+        self.hmenu = None
+        self.browser = None
+        self.folder = folder
+        self.children = None
+
+    # IOleWindow
+    def GetWindow(self):
+        return self.hwnd
+
+    def ContextSensitiveHelp(self, enter_mode):
+        raise COMException(hresult=winerror.E_NOTIMPL)
+
+    # IShellView
+    def CreateViewWindow(self, prev, settings, browser, rect):
+        print("FileSystemView.CreateViewWindow", prev, settings, browser, rect)
+        self.cur_foldersettings = settings
+        self.browser = browser
+        self._CreateMainWindow(prev, settings, browser, rect)
+        self._CreateChildWindow(prev)
+
+        # This isn't part of the sample, but the most convenient place to
+        # test/demonstrate how you can get an IShellBrowser from a HWND
+        # (but ONLY when you are in the same process as the IShellBrowser!)
+        # Obviously it is not necessary here - we already have the browser!
+        browser_ad = win32gui.SendMessage(self.hwnd_parent, win32con.WM_USER + 7, 0, 0)
+        browser_ob = pythoncom.ObjectFromAddress(browser_ad, shell.IID_IShellBrowser)
+        assert browser == browser_ob
+        # and make a call on the object to prove it doesn't die :)
+        assert browser.QueryActiveShellView() == browser_ob.QueryActiveShellView()
+
+    def _CreateMainWindow(self, prev, settings, browser, rect):
+        # Creates a parent window that hosts the view window.  This window
+        # gets the control notifications etc sent from the child.
+        style = win32con.WS_CHILD | win32con.WS_VISIBLE  #
+        wclass_name = "ShellViewDemo_DefView"
+        # Register the Window class.
+        wc = win32gui.WNDCLASS()
+        wc.hInstance = win32gui.dllhandle
+        wc.lpszClassName = wclass_name
+        wc.style = win32con.CS_VREDRAW | win32con.CS_HREDRAW
+        try:
+            win32gui.RegisterClass(wc)
+        except win32gui.error as details:
+            # Should only happen when this module is reloaded
+            if details[0] != winerror.ERROR_CLASS_ALREADY_EXISTS:
+                raise
+
+        message_map = {
+            win32con.WM_DESTROY: self.OnDestroy,
+            win32con.WM_COMMAND: self.OnCommand,
+            win32con.WM_NOTIFY: self.OnNotify,
+            win32con.WM_CONTEXTMENU: self.OnContextMenu,
+            win32con.WM_SIZE: self.OnSize,
+        }
+
+        self.hwnd = win32gui.CreateWindow(
+            wclass_name,
+            "",
+            style,
+            rect[0],
+            rect[1],
+            rect[2] - rect[0],
+            rect[3] - rect[1],
+            self.hwnd_parent,
+            0,
+            win32gui.dllhandle,
+            None,
+        )
+        win32gui.SetWindowLong(self.hwnd, win32con.GWL_WNDPROC, message_map)
+        print("View 's hwnd is", self.hwnd)
+        return self.hwnd
+
+    def _CreateChildWindow(self, prev):
+        # Creates the list view window.
+        assert self.hwnd_child is None, "already have a window"
+        assert self.cur_foldersettings is not None, "no settings"
+        style = (
+            win32con.WS_CHILD
+            | win32con.WS_VISIBLE
+            | win32con.WS_BORDER
+            | commctrl.LVS_SHAREIMAGELISTS
+            | commctrl.LVS_EDITLABELS
+        )
+
+        view_mode, view_flags = self.cur_foldersettings
+        if view_mode == shellcon.FVM_ICON:
+            style |= commctrl.LVS_ICON | commctrl.LVS_AUTOARRANGE
+        elif view_mode == shellcon.FVM_SMALLICON:
+            style |= commctrl.LVS_SMALLICON | commctrl.LVS_AUTOARRANGE
+        elif view_mode == shellcon.FVM_LIST:
+            style |= commctrl.LVS_LIST | commctrl.LVS_AUTOARRANGE
+        elif view_mode == shellcon.FVM_DETAILS:
+            style |= commctrl.LVS_REPORT | commctrl.LVS_AUTOARRANGE
+        else:
+            # XP 'thumbnails' etc
+            view_mode = shellcon.FVM_DETAILS
+            # Default to 'report'
+            style |= commctrl.LVS_REPORT | commctrl.LVS_AUTOARRANGE
+
+        for f_flag, l_flag in [
+            (shellcon.FWF_SINGLESEL, commctrl.LVS_SINGLESEL),
+            (shellcon.FWF_ALIGNLEFT, commctrl.LVS_ALIGNLEFT),
+            (shellcon.FWF_SHOWSELALWAYS, commctrl.LVS_SHOWSELALWAYS),
+        ]:
+            if view_flags & f_flag:
+                style |= l_flag
+
+        self.hwnd_child = win32gui.CreateWindowEx(
+            win32con.WS_EX_CLIENTEDGE,
+            "SysListView32",
+            None,
+            style,
+            0,
+            0,
+            0,
+            0,
+            self.hwnd,
+            1000,
+            0,
+            None,
+        )
+
+        cr = win32gui.GetClientRect(self.hwnd)
+        win32gui.MoveWindow(self.hwnd_child, 0, 0, cr[2] - cr[0], cr[3] - cr[1], True)
+
+        # Setup the columns for the view.
+        lvc, extras = win32gui_struct.PackLVCOLUMN(
+            fmt=commctrl.LVCFMT_LEFT, subItem=1, text="Name", cx=300
+        )
+        win32gui.SendMessage(self.hwnd_child, commctrl.LVM_INSERTCOLUMN, 0, lvc)
+
+        lvc, extras = win32gui_struct.PackLVCOLUMN(
+            fmt=commctrl.LVCFMT_RIGHT, subItem=1, text="Exists", cx=50
+        )
+        win32gui.SendMessage(self.hwnd_child, commctrl.LVM_INSERTCOLUMN, 1, lvc)
+        # and fill it with the content
+        self.Refresh()
+
+    def GetCurrentInfo(self):
+        return self.cur_foldersettings
+
+    def UIActivate(self, activate_state):
+        print("OnActivate")
+
+    def _OnActivate(self, activate_state):
+        if self.activate_state == activate_state:
+            return
+        self._OnDeactivate()  # restore menu's first, if necessary.
+        if activate_state != shellcon.SVUIA_DEACTIVATE:
+            assert self.hmenu is None, "Should have destroyed it!"
+            self.hmenu = win32gui.CreateMenu()
+            widths = 0, 0, 0, 0, 0, 0
+            # Ask explorer to add its standard items.
+            self.browser.InsertMenusSB(self.hmenu, widths)
+            # Merge with these standard items
+            self._MergeMenus(activate_state)
+            self.browser.SetMenuSB(self.hmenu, 0, self.hwnd)
+        self.activate_state = activate_state
+
+    def _OnDeactivate(self):
+        if self.browser is not None and self.hmenu is not None:
+            self.browser.SetMenuSB(0, 0, 0)
+            self.browser.RemoveMenusSB(self.hmenu)
+            win32gui.DestroyMenu(self.hmenu)
+            self.hmenu = None
+        self.hsubmenus = None
+        self.activate_state = shellcon.SVUIA_DEACTIVATE
+
+    def _MergeMenus(self, activate_state):
+        # Merge the operations we support into the top-level menus.
+        # NOTE: This function it *not* called each time the selection changes.
+        # SVUIA_ACTIVATE_FOCUS really means "have a selection?"
+        have_sel = activate_state == shellcon.SVUIA_ACTIVATE_FOCUS
+        # only do "file" menu here, and only 1 item on it!
+        mid = shellcon.FCIDM_MENU_FILE
+        # Get the hmenu for the menu
+        buf, extras = win32gui_struct.EmptyMENUITEMINFO(win32con.MIIM_SUBMENU)
+        win32gui.GetMenuItemInfo(self.hmenu, mid, False, buf)
+        data = win32gui_struct.UnpackMENUITEMINFO(buf)
+        submenu = data[3]
+        print("Do someting with the file menu!")
+
+    def Refresh(self):
+        stateMask = commctrl.LVIS_SELECTED | commctrl.LVIS_DROPHILITED
+        state = 0
+        self.children = []
+        # Enumerate and store the child PIDLs
+        for cid in self.folder.EnumObjects(self.hwnd, 0):
+            self.children.append(cid)
+
+        for row_index, data in enumerate(self.children):
+            assert len(data) == 1, "expecting just a child PIDL"
+            typ, path = data[0].split("\0")
+            desc = os.path.exists(path) and "Yes" or "No"
+            prop_vals = (path, desc)
+            # first col
+            data, extras = win32gui_struct.PackLVITEM(
+                item=row_index,
+                subItem=0,
+                text=prop_vals[0],
+                state=state,
+                stateMask=stateMask,
+            )
+            win32gui.SendMessage(
+                self.hwnd_child, commctrl.LVM_INSERTITEM, row_index, data
+            )
+            # rest of the cols.
+            col_index = 1
+            for prop_val in prop_vals[1:]:
+                data, extras = win32gui_struct.PackLVITEM(
+                    item=row_index, subItem=col_index, text=prop_val
+                )
+
+                win32gui.SendMessage(self.hwnd_child, commctrl.LVM_SETITEM, 0, data)
+                col_index += 1
+
+    def SelectItem(self, pidl, flag):
+        # For the sake of brevity, we don't implement this yet.
+        # You would need to locate the index of the item in the shell-view
+        # with that PIDL, then ask the list-view to select it.
+        print("Please implement SelectItem for PIDL", pidl)
+
+    def GetItemObject(self, item_num, iid):
+        raise COMException(hresult=winerror.E_NOTIMPL)
+
+    def TranslateAccelerator(self, msg):
+        return winerror.S_FALSE
+
+    def DestroyViewWindow(self):
+        win32gui.DestroyWindow(self.hwnd)
+        self.hwnd = None
+        print("Destroyed view window")
+
+    # Message handlers.
+    def OnDestroy(self, hwnd, msg, wparam, lparam):
+        print("OnDestory")
+
+    def OnCommand(self, hwnd, msg, wparam, lparam):
+        print("OnCommand")
+
+    def OnNotify(self, hwnd, msg, wparam, lparam):
+        hwndFrom, idFrom, code = win32gui_struct.UnpackWMNOTIFY(lparam)
+        # print "OnNotify code=0x%x (0x%x, 0x%x)" % (code, wparam, lparam)
+        if code == commctrl.NM_SETFOCUS:
+            # Control got focus - Explorer may not know - tell it
+            if self.browser is not None:
+                self.browser.OnViewWindowActive(None)
+            # And do our menu thang
+            self._OnActivate(shellcon.SVUIA_ACTIVATE_FOCUS)
+        elif code == commctrl.NM_KILLFOCUS:
+            self._OnDeactivate()
+        elif code == commctrl.NM_DBLCLK:
+            # This DblClick implementation leaves a little to be desired :)
+            # It demonstrates some useful concepts, such as asking the
+            # folder for its context-menu and invoking a command from it.
+            # However, as our folder delegates IContextMenu to the shell
+            # itself, the end result is that the folder is opened in
+            # its "normal" place in Windows explorer rather than inside
+            # our shell-extension.
+            # Determine the selected items.
+            sel = []
+            n = -1
+            while 1:
+                n = win32gui.SendMessage(
+                    self.hwnd_child, commctrl.LVM_GETNEXTITEM, n, commctrl.LVNI_SELECTED
+                )
+                if n == -1:
+                    break
+                sel.append(self.children[n][-1:])
+            print("Selection is", sel)
+            hmenu = win32gui.CreateMenu()
+            try:
+                # Get the IContextMenu for the items.
+                inout, cm = self.folder.GetUIObjectOf(
+                    self.hwnd_parent, sel, shell.IID_IContextMenu, 0
+                )
+
+                # As per 'Q179911', we need to determine if the default operation
+                # should be 'open' or 'explore'
+                flags = shellcon.CMF_DEFAULTONLY
+                try:
+                    self.browser.GetControlWindow(shellcon.FCW_TREE)
+                    flags |= shellcon.CMF_EXPLORE
+                except pythoncom.com_error:
+                    pass
+                # *sob* - delegating to the shell does work - but lands us
+                # in the original location.  Q179911 also shows that
+                # ShellExecuteEx should work - but I can't make it work as
+                # described (XP: function call succeeds, but another thread
+                # shows a dialog with text of E_INVALID_PARAM, and new
+                # Explorer window opens with desktop view. Vista: function
+                # call succeeds, but no window created at all.
+                # On Vista, I'd love to get an IExplorerBrowser interface
+                # from the shell, but a QI fails, and although the
+                # IShellBrowser does appear to support IServiceProvider, I
+                # still can't get it
+                if 0:
+                    id_cmd_first = 1  # TrackPopupMenu makes it hard to use 0
+                    cm.QueryContextMenu(hmenu, 0, id_cmd_first, -1, flags)
+                    # Find the default item in the returned menu.
+                    cmd = win32gui.GetMenuDefaultItem(hmenu, False, 0)
+                    if cmd == -1:
+                        print("Oops: _doDefaultActionFor found no default menu")
+                    else:
+                        ci = (
+                            0,
+                            self.hwnd_parent,
+                            cmd - id_cmd_first,
+                            None,
+                            None,
+                            0,
+                            0,
+                            0,
+                        )
+                        cm.InvokeCommand(ci)
+                else:
+                    rv = shell.ShellExecuteEx(
+                        hwnd=self.hwnd_parent,
+                        nShow=win32con.SW_NORMAL,
+                        lpClass="folder",
+                        lpVerb="explore",
+                        lpIDList=sel[0],
+                    )
+                    print("ShellExecuteEx returned", rv)
+            finally:
+                win32gui.DestroyMenu(hmenu)
+
+    def OnContextMenu(self, hwnd, msg, wparam, lparam):
+        # Get the selected items.
+        pidls = []
+        n = -1
+        while 1:
+            n = win32gui.SendMessage(
+                self.hwnd_child, commctrl.LVM_GETNEXTITEM, n, commctrl.LVNI_SELECTED
+            )
+            if n == -1:
+                break
+            pidls.append(self.children[n][-1:])
+
+        spt = win32api.GetCursorPos()
+        if not pidls:
+            print("Ignoring background click")
+            return
+        # Get the IContextMenu for the items.
+        inout, cm = self.folder.GetUIObjectOf(
+            self.hwnd_parent, pidls, shell.IID_IContextMenu, 0
+        )
+        hmenu = win32gui.CreatePopupMenu()
+        sel = None
+        # As per 'Q179911', we need to determine if the default operation
+        # should be 'open' or 'explore'
+        try:
+            flags = 0
+            try:
+                self.browser.GetControlWindow(shellcon.FCW_TREE)
+                flags |= shellcon.CMF_EXPLORE
+            except pythoncom.com_error:
+                pass
+            id_cmd_first = 1  # TrackPopupMenu makes it hard to use 0
+            cm.QueryContextMenu(hmenu, 0, id_cmd_first, -1, flags)
+            tpm_flags = (
+                win32con.TPM_LEFTALIGN
+                | win32con.TPM_RETURNCMD
+                | win32con.TPM_RIGHTBUTTON
+            )
+            sel = win32gui.TrackPopupMenu(
+                hmenu, tpm_flags, spt[0], spt[1], 0, self.hwnd, None
+            )
+            print("TrackPopupMenu returned", sel)
+        finally:
+            win32gui.DestroyMenu(hmenu)
+        if sel:
+            ci = 0, self.hwnd_parent, sel - id_cmd_first, None, None, 0, 0, 0
+            cm.InvokeCommand(ci)
+
+    def OnSize(self, hwnd, msg, wparam, lparam):
+        # print "OnSize", self.hwnd_child, win32api.LOWORD(lparam), win32api.HIWORD(lparam)
+        if self.hwnd_child is not None:
+            x = win32api.LOWORD(lparam)
+            y = win32api.HIWORD(lparam)
+            win32gui.MoveWindow(self.hwnd_child, 0, 0, x, y, False)
+
+
+# This uses scintilla to display a filename, and optionally jump to a line
+# number.
+class ScintillaShellView:
+    _public_methods_ = shellcon.IShellView_Methods
+    _com_interfaces_ = [
+        pythoncom.IID_IOleWindow,
+        shell.IID_IShellView,
+    ]
+
+    def __init__(self, hwnd, filename, lineno=None):
+        self.filename = filename
+        self.lineno = lineno
+        self.hwnd_parent = hwnd
+        self.hwnd = None
+
+    def _SendSci(self, msg, wparam=0, lparam=0):
+        return win32gui.SendMessage(self.hwnd, msg, wparam, lparam)
+
+    # IShellView
+    def CreateViewWindow(self, prev, settings, browser, rect):
+        print("ScintillaShellView.CreateViewWindow", prev, settings, browser, rect)
+        # Make sure scintilla.dll is loaded.  If not, find it on sys.path
+        # (which it generally is for Pythonwin)
+        try:
+            win32api.GetModuleHandle("Scintilla.dll")
+        except win32api.error:
+            for p in sys.path:
+                fname = os.path.join(p, "Scintilla.dll")
+                if not os.path.isfile(fname):
+                    fname = os.path.join(p, "Build", "Scintilla.dll")
+                if os.path.isfile(fname):
+                    win32api.LoadLibrary(fname)
+                    break
+            else:
+                raise RuntimeError("Can't find scintilla!")
+
+        style = (
+            win32con.WS_CHILD
+            | win32con.WS_VSCROLL
+            | win32con.WS_HSCROLL
+            | win32con.WS_CLIPCHILDREN
+            | win32con.WS_VISIBLE
+        )
+        self.hwnd = win32gui.CreateWindow(
+            "Scintilla",
+            "Scintilla",
+            style,
+            rect[0],
+            rect[1],
+            rect[2] - rect[0],
+            rect[3] - rect[1],
+            self.hwnd_parent,
+            1000,
+            0,
+            None,
+        )
+
+        message_map = {
+            win32con.WM_SIZE: self.OnSize,
+        }
+        #        win32gui.SetWindowLong(self.hwnd, win32con.GWL_WNDPROC, message_map)
+
+        file_data = file(self.filename, "U").read()
+
+        self._SetupLexer()
+        self._SendSci(scintillacon.SCI_ADDTEXT, len(file_data), file_data)
+        if self.lineno != None:
+            self._SendSci(scintillacon.SCI_GOTOLINE, self.lineno)
+        print("Scintilla's hwnd is", self.hwnd)
+
+    def _SetupLexer(self):
+        h = self.hwnd
+        styles = [
+            ((0, 0, 200, 0, 0x808080), None, scintillacon.SCE_P_DEFAULT),
+            ((0, 2, 200, 0, 0x008000), None, scintillacon.SCE_P_COMMENTLINE),
+            ((0, 2, 200, 0, 0x808080), None, scintillacon.SCE_P_COMMENTBLOCK),
+            ((0, 0, 200, 0, 0x808000), None, scintillacon.SCE_P_NUMBER),
+            ((0, 0, 200, 0, 0x008080), None, scintillacon.SCE_P_STRING),
+            ((0, 0, 200, 0, 0x008080), None, scintillacon.SCE_P_CHARACTER),
+            ((0, 0, 200, 0, 0x008080), None, scintillacon.SCE_P_TRIPLE),
+            ((0, 0, 200, 0, 0x008080), None, scintillacon.SCE_P_TRIPLEDOUBLE),
+            ((0, 0, 200, 0, 0x000000), 0x008080, scintillacon.SCE_P_STRINGEOL),
+            ((0, 1, 200, 0, 0x800000), None, scintillacon.SCE_P_WORD),
+            ((0, 1, 200, 0, 0xFF0000), None, scintillacon.SCE_P_CLASSNAME),
+            ((0, 1, 200, 0, 0x808000), None, scintillacon.SCE_P_DEFNAME),
+            ((0, 0, 200, 0, 0x000000), None, scintillacon.SCE_P_OPERATOR),
+            ((0, 0, 200, 0, 0x000000), None, scintillacon.SCE_P_IDENTIFIER),
+        ]
+        self._SendSci(scintillacon.SCI_SETLEXER, scintillacon.SCLEX_PYTHON, 0)
+        self._SendSci(scintillacon.SCI_SETSTYLEBITS, 5)
+        baseFormat = (-402653169, 0, 200, 0, 0, 0, 49, "Courier New")
+        for f, bg, stylenum in styles:
+            self._SendSci(scintillacon.SCI_STYLESETFORE, stylenum, f[4])
+            self._SendSci(scintillacon.SCI_STYLESETFONT, stylenum, baseFormat[7])
+            if f[1] & 1:
+                self._SendSci(scintillacon.SCI_STYLESETBOLD, stylenum, 1)
+            else:
+                self._SendSci(scintillacon.SCI_STYLESETBOLD, stylenum, 0)
+            if f[1] & 2:
+                self._SendSci(scintillacon.SCI_STYLESETITALIC, stylenum, 1)
+            else:
+                self._SendSci(scintillacon.SCI_STYLESETITALIC, stylenum, 0)
+            self._SendSci(
+                scintillacon.SCI_STYLESETSIZE, stylenum, int(baseFormat[2] / 20)
+            )
+            if bg is not None:
+                self._SendSci(scintillacon.SCI_STYLESETBACK, stylenum, bg)
+            self._SendSci(
+                scintillacon.SCI_STYLESETEOLFILLED, stylenum, 1
+            )  # Only needed for unclosed strings.
+
+    # IOleWindow
+    def GetWindow(self):
+        return self.hwnd
+
+    def UIActivate(self, activate_state):
+        print("OnActivate")
+
+    def DestroyViewWindow(self):
+        win32gui.DestroyWindow(self.hwnd)
+        self.hwnd = None
+        print("Destroyed scintilla window")
+
+    def TranslateAccelerator(self, msg):
+        return winerror.S_FALSE
+
+    def OnSize(self, hwnd, msg, wparam, lparam):
+        x = win32api.LOWORD(lparam)
+        y = win32api.HIWORD(lparam)
+        win32gui.MoveWindow(self.hwnd, 0, 0, x, y, False)
+
+
+def DllRegisterServer():
+    import winreg
+
+    key = winreg.CreateKey(
+        winreg.HKEY_LOCAL_MACHINE,
+        "SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\"
+        "Explorer\\Desktop\\Namespace\\" + ShellFolderRoot._reg_clsid_,
+    )
+    winreg.SetValueEx(key, None, 0, winreg.REG_SZ, ShellFolderRoot._reg_desc_)
+    # And special shell keys under our CLSID
+    key = winreg.CreateKey(
+        winreg.HKEY_CLASSES_ROOT,
+        "CLSID\\" + ShellFolderRoot._reg_clsid_ + "\\ShellFolder",
+    )
+    # 'Attributes' is an int stored as a binary! use struct
+    attr = (
+        shellcon.SFGAO_FOLDER | shellcon.SFGAO_HASSUBFOLDER | shellcon.SFGAO_BROWSABLE
+    )
+    import struct
+
+    s = struct.pack("i", attr)
+    winreg.SetValueEx(key, "Attributes", 0, winreg.REG_BINARY, s)
+    print(ShellFolderRoot._reg_desc_, "registration complete.")
+
+
+def DllUnregisterServer():
+    import winreg
+
+    try:
+        key = winreg.DeleteKey(
+            winreg.HKEY_LOCAL_MACHINE,
+            "SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\"
+            "Explorer\\Desktop\\Namespace\\" + ShellFolderRoot._reg_clsid_,
+        )
+    except WindowsError as details:
+        import errno
+
+        if details.errno != errno.ENOENT:
+            raise
+    print(ShellFolderRoot._reg_desc_, "unregistration complete.")
+
+
+if __name__ == "__main__":
+    from win32com.server import register
+
+    register.UseCommandLine(
+        ShellFolderRoot,
+        debug=debug,
+        finalize_register=DllRegisterServer,
+        finalize_unregister=DllUnregisterServer,
+    )
diff --git a/lib/win32comext/shell/demos/shellexecuteex.py b/lib/win32comext/shell/demos/shellexecuteex.py
new file mode 100644
index 00000000..6111841b
--- /dev/null
+++ b/lib/win32comext/shell/demos/shellexecuteex.py
@@ -0,0 +1,19 @@
+import win32con
+from win32com.shell import shell, shellcon
+
+
+def ExplorePIDL():
+    pidl = shell.SHGetSpecialFolderLocation(0, shellcon.CSIDL_DESKTOP)
+    print("The desktop is at", shell.SHGetPathFromIDList(pidl))
+    shell.ShellExecuteEx(
+        fMask=shellcon.SEE_MASK_NOCLOSEPROCESS,
+        nShow=win32con.SW_NORMAL,
+        lpClass="folder",
+        lpVerb="explore",
+        lpIDList=pidl,
+    )
+    print("Done!")
+
+
+if __name__ == "__main__":
+    ExplorePIDL()
diff --git a/lib/win32comext/shell/demos/viewstate.py b/lib/win32comext/shell/demos/viewstate.py
new file mode 100644
index 00000000..e3b7fc15
--- /dev/null
+++ b/lib/win32comext/shell/demos/viewstate.py
@@ -0,0 +1,68 @@
+"""
+Demonstrates how to propagate a folder's view state to all its subfolders
+The format of the ColInfo stream is apparently undocumented, but
+it can be read raw from one folder and copied to another's view state.
+"""
+
+import os
+import sys
+
+import pythoncom
+from win32com.shell import shell, shellcon
+
+template_folder = os.path.split(sys.executable)[0]
+print("Template folder:", template_folder)
+template_pidl = shell.SHILCreateFromPath(template_folder, 0)[0]
+template_pb = shell.SHGetViewStatePropertyBag(
+    template_pidl,
+    "Shell",
+    shellcon.SHGVSPB_FOLDERNODEFAULTS,
+    pythoncom.IID_IPropertyBag,
+)
+
+# Column info has to be read as a stream
+# This may blow up if folder has never been opened in Explorer and has no ColInfo yet
+template_iunk = template_pb.Read("ColInfo", pythoncom.VT_UNKNOWN)
+template_stream = template_iunk.QueryInterface(pythoncom.IID_IStream)
+streamsize = template_stream.Stat()[2]
+template_colinfo = template_stream.Read(streamsize)
+
+
+def update_colinfo(not_used, dir_name, fnames):
+    for fname in fnames:
+        full_fname = os.path.join(dir_name, fname)
+        if os.path.isdir(full_fname):
+            print(full_fname)
+            pidl = shell.SHILCreateFromPath(full_fname, 0)[0]
+            pb = shell.SHGetViewStatePropertyBag(
+                pidl,
+                "Shell",
+                shellcon.SHGVSPB_FOLDERNODEFAULTS,
+                pythoncom.IID_IPropertyBag,
+            )
+            ## not all folders already have column info, and we're replacing it anyway
+            pb.Write("ColInfo", template_stream)
+            iunk = pb.Read("ColInfo", pythoncom.VT_UNKNOWN)
+            s = iunk.QueryInterface(pythoncom.IID_IStream)
+            s.Write(template_colinfo)
+            s = None
+            ## attribute names read from registry, can't find any way to enumerate IPropertyBag
+            for attr in (
+                "Address",
+                "Buttons",
+                "Col",
+                "Vid",
+                "WFlags",
+                "FFlags",
+                "Sort",
+                "SortDir",
+                "ShowCmd",
+                "FolderType",
+                "Mode",
+                "Rev",
+            ):
+                pb.Write(attr, template_pb.Read(attr))
+            pb = None
+
+
+os.path.walk(template_folder, update_colinfo, None)
diff --git a/lib/win32comext/shell/demos/walk_shell_folders.py b/lib/win32comext/shell/demos/walk_shell_folders.py
new file mode 100644
index 00000000..592350c8
--- /dev/null
+++ b/lib/win32comext/shell/demos/walk_shell_folders.py
@@ -0,0 +1,24 @@
+# A little sample that walks from the desktop into child
+# items.
+from win32com.shell import shell, shellcon
+
+
+def walk(folder, depth=2, indent=""):
+    try:
+        pidls = folder.EnumObjects(0, shellcon.SHCONTF_FOLDERS)
+    except shell.error:
+        # no items
+        return
+    for pidl in pidls:
+        dn = folder.GetDisplayNameOf(pidl, shellcon.SHGDN_NORMAL)
+        print(indent, dn)
+        if depth:
+            try:
+                child = folder.BindToObject(pidl, None, shell.IID_IShellFolder)
+            except shell.error:
+                pass
+            else:
+                walk(child, depth - 1, indent + " ")
+
+
+walk(shell.SHGetDesktopFolder())
diff --git a/lib/win32comext/shell/shell.pyd b/lib/win32comext/shell/shell.pyd
new file mode 100644
index 0000000000000000000000000000000000000000..fe2352d91f2421c5042bd7b38936d86d5d37e1eb
GIT binary patch
literal 528896
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%0DgQ9byPpv<Aepa=VqU#OvmjcUaPK
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

literal 0
HcmV?d00001

diff --git a/lib/win32comext/shell/shellcon.py b/lib/win32comext/shell/shellcon.py
new file mode 100644
index 00000000..769adf73
--- /dev/null
+++ b/lib/win32comext/shell/shellcon.py
@@ -0,0 +1,1597 @@
+# Generated by h2py from \mssdk\include\shlobj.h and shellapi.h
+WM_USER = 1024
+DROPEFFECT_NONE = 0
+DROPEFFECT_COPY = 1
+DROPEFFECT_MOVE = 2
+DROPEFFECT_LINK = 4
+DROPEFFECT_SCROLL = -2147483648
+
+FO_MOVE = 1
+FO_COPY = 2
+FO_DELETE = 3
+FO_RENAME = 4
+
+## File operation flags used with shell.SHFileOperation
+FOF_MULTIDESTFILES = 1
+FOF_CONFIRMMOUSE = 2
+FOF_SILENT = 4
+FOF_RENAMEONCOLLISION = 8
+FOF_NOCONFIRMATION = 16
+FOF_WANTMAPPINGHANDLE = 32
+FOF_ALLOWUNDO = 64
+FOF_FILESONLY = 128
+FOF_SIMPLEPROGRESS = 256
+FOF_NOCONFIRMMKDIR = 512
+FOF_NOERRORUI = 1024
+FOF_NOCOPYSECURITYATTRIBS = 2048
+FOF_NORECURSION = 4096
+FOF_NO_CONNECTED_ELEMENTS = 8192
+FOF_WANTNUKEWARNING = 16384
+FOF_NORECURSEREPARSE = 32768
+FOF_NO_UI = FOF_SILENT | FOF_NOCONFIRMATION | FOF_NOERRORUI | FOF_NOCONFIRMMKDIR
+
+## Extended file operation flags, used with IFileOperation
+FOFX_NOSKIPJUNCTIONS = 0x00010000
+FOFX_PREFERHARDLINK = 0x00020000
+FOFX_SHOWELEVATIONPROMPT = 0x00040000
+FOFX_EARLYFAILURE = 0x00100000
+FOFX_PRESERVEFILEEXTENSIONS = 0x00200000
+FOFX_KEEPNEWERFILE = 0x00400000
+FOFX_NOCOPYHOOKS = 0x00800000
+FOFX_NOMINIMIZEBOX = 0x01000000
+FOFX_MOVEACLSACROSSVOLUMES = 0x02000000
+FOFX_DONTDISPLAYSOURCEPATH = 0x04000000
+FOFX_DONTDISPLAYDESTPATH = 0x08000000
+FOFX_REQUIREELEVATION = 0x10000000
+FOFX_COPYASDOWNLOAD = 0x40000000
+FOFX_DONTDISPLAYLOCATIONS = 0x80000000
+
+PO_DELETE = 19
+PO_RENAME = 20
+PO_PORTCHANGE = 32
+PO_REN_PORT = 52
+SE_ERR_FNF = 2
+SE_ERR_PNF = 3
+SE_ERR_ACCESSDENIED = 5
+SE_ERR_OOM = 8
+SE_ERR_DLLNOTFOUND = 32
+SE_ERR_SHARE = 26
+SE_ERR_ASSOCINCOMPLETE = 27
+SE_ERR_DDETIMEOUT = 28
+SE_ERR_DDEFAIL = 29
+SE_ERR_DDEBUSY = 30
+SE_ERR_NOASSOC = 31
+SEE_MASK_CLASSNAME = 1
+SEE_MASK_CLASSKEY = 3
+SEE_MASK_IDLIST = 4
+SEE_MASK_INVOKEIDLIST = 12
+SEE_MASK_ICON = 16
+SEE_MASK_HOTKEY = 32
+SEE_MASK_NOCLOSEPROCESS = 64
+SEE_MASK_CONNECTNETDRV = 128
+SEE_MASK_FLAG_DDEWAIT = 256
+SEE_MASK_DOENVSUBST = 512
+SEE_MASK_FLAG_NO_UI = 1024
+SEE_MASK_UNICODE = 16384
+SEE_MASK_NO_CONSOLE = 32768
+SEE_MASK_ASYNCOK = 1048576
+SEE_MASK_HMONITOR = 2097152
+SHERB_NOCONFIRMATION = 1
+SHERB_NOPROGRESSUI = 2
+SHERB_NOSOUND = 4
+NIM_ADD = 0
+NIM_MODIFY = 1
+NIM_DELETE = 2
+NIF_MESSAGE = 1
+NIF_ICON = 2
+NIF_TIP = 4
+SHGFI_ICON = 256
+SHGFI_DISPLAYNAME = 512
+SHGFI_TYPENAME = 1024
+SHGFI_ATTRIBUTES = 2048
+SHGFI_ICONLOCATION = 4096
+SHGFI_EXETYPE = 8192
+SHGFI_SYSICONINDEX = 16384
+SHGFI_LINKOVERLAY = 32768
+SHGFI_SELECTED = 65536
+SHGFI_ATTR_SPECIFIED = 131072
+SHGFI_LARGEICON = 0
+SHGFI_SMALLICON = 1
+SHGFI_OPENICON = 2
+SHGFI_SHELLICONSIZE = 4
+SHGFI_PIDL = 8
+SHGFI_USEFILEATTRIBUTES = 16
+SHGNLI_PIDL = 1
+SHGNLI_PREFIXNAME = 2
+SHGNLI_NOUNIQUE = 4
+PRINTACTION_OPEN = 0
+PRINTACTION_PROPERTIES = 1
+PRINTACTION_NETINSTALL = 2
+PRINTACTION_NETINSTALLLINK = 3
+PRINTACTION_TESTPAGE = 4
+PRINTACTION_OPENNETPRN = 5
+PRINTACTION_DOCUMENTDEFAULTS = 6
+PRINTACTION_SERVERPROPERTIES = 7
+
+# Flags used with IContextMenu.QueryContextMenu
+CMF_NORMAL = 0
+CMF_DEFAULTONLY = 1
+CMF_VERBSONLY = 2
+CMF_EXPLORE = 4
+CMF_NOVERBS = 8
+CMF_CANRENAME = 16
+CMF_NODEFAULT = 32
+CMF_INCLUDESTATIC = 64
+CMF_ITEMMENU = 128
+CMF_EXTENDEDVERBS = 256
+CMF_DISABLEDVERBS = 512
+CMF_ASYNCVERBSTATE = 1024
+CMF_OPTIMIZEFORINVOKE = 2048
+CMF_SYNCCASCADEMENU = 4096
+CMF_DONOTPICKDEFAULT = 8192
+CMF_RESERVED = 0xFFFF0000
+
+GCS_VERBA = 0
+GCS_HELPTEXTA = 1
+GCS_VALIDATEA = 2
+GCS_VERBW = 4
+GCS_HELPTEXTW = 5
+GCS_VALIDATEW = 6
+GCS_UNICODE = 4
+GCS_VERB = GCS_VERBA
+GCS_HELPTEXT = GCS_HELPTEXTA
+GCS_VALIDATE = GCS_VALIDATEA
+CMDSTR_NEWFOLDERA = "NewFolder"
+CMDSTR_VIEWLISTA = "ViewList"
+CMDSTR_VIEWDETAILSA = "ViewDetails"
+CMDSTR_NEWFOLDER = CMDSTR_NEWFOLDERA
+CMDSTR_VIEWLIST = CMDSTR_VIEWLISTA
+CMDSTR_VIEWDETAILS = CMDSTR_VIEWDETAILSA
+CMIC_MASK_HOTKEY = SEE_MASK_HOTKEY
+CMIC_MASK_ICON = SEE_MASK_ICON
+CMIC_MASK_FLAG_NO_UI = SEE_MASK_FLAG_NO_UI
+CMIC_MASK_UNICODE = SEE_MASK_UNICODE
+CMIC_MASK_NO_CONSOLE = SEE_MASK_NO_CONSOLE
+CMIC_MASK_ASYNCOK = SEE_MASK_ASYNCOK
+CMIC_MASK_PTINVOKE = 536870912
+GIL_OPENICON = 1
+GIL_FORSHELL = 2
+GIL_ASYNC = 32
+GIL_DEFAULTICON = 64
+GIL_FORSHORTCUT = 128
+GIL_CHECKSHIELD = 512
+GIL_SIMULATEDOC = 1
+GIL_PERINSTANCE = 2
+GIL_PERCLASS = 4
+GIL_NOTFILENAME = 8
+GIL_DONTCACHE = 16
+GIL_SHIELD = 512
+GIL_FORCENOSHIELD = 1024
+ISIOI_ICONFILE = 1
+ISIOI_ICONINDEX = 2
+ISIOI_SYSIMAGELISTINDEX = 4
+FVSIF_RECT = 1
+FVSIF_PINNED = 2
+FVSIF_NEWFAILED = 134217728
+FVSIF_NEWFILE = -2147483648
+FVSIF_CANVIEWIT = 1073741824
+FCIDM_SHVIEWFIRST = 0
+FCIDM_SHVIEWLAST = 32767
+FCIDM_BROWSERFIRST = 40960
+FCIDM_BROWSERLAST = 48896
+FCIDM_GLOBALFIRST = 32768
+FCIDM_GLOBALLAST = 40959
+FCIDM_MENU_FILE = FCIDM_GLOBALFIRST + 0
+FCIDM_MENU_EDIT = FCIDM_GLOBALFIRST + 64
+FCIDM_MENU_VIEW = FCIDM_GLOBALFIRST + 128
+FCIDM_MENU_VIEW_SEP_OPTIONS = FCIDM_GLOBALFIRST + 129
+FCIDM_MENU_TOOLS = FCIDM_GLOBALFIRST + 192
+FCIDM_MENU_TOOLS_SEP_GOTO = FCIDM_GLOBALFIRST + 193
+FCIDM_MENU_HELP = FCIDM_GLOBALFIRST + 256
+FCIDM_MENU_FIND = FCIDM_GLOBALFIRST + 320
+FCIDM_MENU_EXPLORE = FCIDM_GLOBALFIRST + 336
+FCIDM_MENU_FAVORITES = FCIDM_GLOBALFIRST + 368
+FCIDM_TOOLBAR = FCIDM_BROWSERFIRST + 0
+FCIDM_STATUS = FCIDM_BROWSERFIRST + 1
+IDC_OFFLINE_HAND = 103
+SBSP_DEFBROWSER = 0
+SBSP_SAMEBROWSER = 1
+SBSP_NEWBROWSER = 2
+SBSP_DEFMODE = 0
+SBSP_OPENMODE = 16
+SBSP_EXPLOREMODE = 32
+SBSP_ABSOLUTE = 0
+SBSP_RELATIVE = 4096
+SBSP_PARENT = 8192
+SBSP_NAVIGATEBACK = 16384
+SBSP_NAVIGATEFORWARD = 32768
+SBSP_ALLOW_AUTONAVIGATE = 65536
+SBSP_INITIATEDBYHLINKFRAME = -2147483648
+SBSP_REDIRECT = 1073741824
+SBSP_WRITENOHISTORY = 134217728
+SBSP_NOAUTOSELECT = 67108864
+FCW_STATUS = 1
+FCW_TOOLBAR = 2
+FCW_TREE = 3
+FCW_INTERNETBAR = 6
+FCW_PROGRESS = 8
+FCT_MERGE = 1
+FCT_CONFIGABLE = 2
+FCT_ADDTOEND = 4
+CDBOSC_SETFOCUS = 0
+CDBOSC_KILLFOCUS = 1
+CDBOSC_SELCHANGE = 2
+CDBOSC_RENAME = 3
+SVSI_DESELECT = 0
+SVSI_SELECT = 1
+SVSI_EDIT = 3
+SVSI_DESELECTOTHERS = 4
+SVSI_ENSUREVISIBLE = 8
+SVSI_FOCUSED = 16
+SVSI_TRANSLATEPT = 32
+SVGIO_BACKGROUND = 0
+SVGIO_SELECTION = 1
+SVGIO_ALLVIEW = 2
+SVGIO_CHECKED = (0x3,)
+SVGIO_TYPE_MASK = (0xF,)
+SVGIO_FLAG_VIEWORDER = -2147483648  # 0x80000000
+STRRET_WSTR = 0
+STRRET_OFFSET = 1
+STRRET_CSTR = 2
+CSIDL_DESKTOP = 0
+CSIDL_INTERNET = 1
+CSIDL_PROGRAMS = 2
+CSIDL_CONTROLS = 3
+CSIDL_PRINTERS = 4
+CSIDL_PERSONAL = 5
+CSIDL_FAVORITES = 6
+CSIDL_STARTUP = 7
+CSIDL_RECENT = 8
+CSIDL_SENDTO = 9
+CSIDL_BITBUCKET = 10
+CSIDL_STARTMENU = 11
+CSIDL_MYDOCUMENTS = 12
+CSIDL_MYMUSIC = 13
+CSIDL_MYVIDEO = 14
+CSIDL_DESKTOPDIRECTORY = 16
+CSIDL_DRIVES = 17
+CSIDL_NETWORK = 18
+CSIDL_NETHOOD = 19
+CSIDL_FONTS = 20
+CSIDL_TEMPLATES = 21
+CSIDL_COMMON_STARTMENU = 22
+CSIDL_COMMON_PROGRAMS = 23
+CSIDL_COMMON_STARTUP = 24
+CSIDL_COMMON_DESKTOPDIRECTORY = 25
+CSIDL_APPDATA = 26
+CSIDL_PRINTHOOD = 27
+CSIDL_LOCAL_APPDATA = 28
+CSIDL_ALTSTARTUP = 29
+CSIDL_COMMON_ALTSTARTUP = 30
+CSIDL_COMMON_FAVORITES = 31
+CSIDL_INTERNET_CACHE = 32
+CSIDL_COOKIES = 33
+CSIDL_HISTORY = 34
+CSIDL_COMMON_APPDATA = 35
+CSIDL_WINDOWS = 36
+CSIDL_SYSTEM = 37
+CSIDL_PROGRAM_FILES = 38
+CSIDL_MYPICTURES = 39
+CSIDL_PROFILE = 40
+CSIDL_SYSTEMX86 = 41
+CSIDL_PROGRAM_FILESX86 = 42
+CSIDL_PROGRAM_FILES_COMMON = 43
+CSIDL_PROGRAM_FILES_COMMONX86 = 44
+CSIDL_COMMON_TEMPLATES = 45
+CSIDL_COMMON_DOCUMENTS = 46
+CSIDL_COMMON_ADMINTOOLS = 47
+CSIDL_ADMINTOOLS = 48
+CSIDL_CONNECTIONS = 49
+CSIDL_COMMON_MUSIC = 53
+CSIDL_COMMON_PICTURES = 54
+CSIDL_COMMON_VIDEO = 55
+CSIDL_RESOURCES = 56
+CSIDL_RESOURCES_LOCALIZED = 57
+CSIDL_COMMON_OEM_LINKS = 58
+CSIDL_CDBURN_AREA = 59
+# 60 unused
+CSIDL_COMPUTERSNEARME = 61
+
+BIF_RETURNONLYFSDIRS = 1
+BIF_DONTGOBELOWDOMAIN = 2
+BIF_STATUSTEXT = 4
+BIF_RETURNFSANCESTORS = 8
+BIF_EDITBOX = 16
+BIF_VALIDATE = 32
+BIF_BROWSEFORCOMPUTER = 4096
+BIF_BROWSEFORPRINTER = 8192
+BIF_BROWSEINCLUDEFILES = 16384
+BFFM_INITIALIZED = 1
+BFFM_SELCHANGED = 2
+BFFM_VALIDATEFAILEDA = 3
+BFFM_VALIDATEFAILEDW = 4
+BFFM_SETSTATUSTEXTA = WM_USER + 100
+BFFM_ENABLEOK = WM_USER + 101
+BFFM_SETSELECTIONA = WM_USER + 102
+BFFM_SETSELECTIONW = WM_USER + 103
+BFFM_SETSTATUSTEXTW = WM_USER + 104
+BFFM_SETSTATUSTEXT = BFFM_SETSTATUSTEXTA
+BFFM_SETSELECTION = BFFM_SETSELECTIONA
+BFFM_VALIDATEFAILED = BFFM_VALIDATEFAILEDA
+SFGAO_CANCOPY = DROPEFFECT_COPY
+SFGAO_CANMOVE = DROPEFFECT_MOVE
+SFGAO_CANLINK = DROPEFFECT_LINK
+SFGAO_CANRENAME = 16
+SFGAO_CANDELETE = 32
+SFGAO_HASPROPSHEET = 64
+SFGAO_DROPTARGET = 256
+SFGAO_CAPABILITYMASK = 375
+SFGAO_LINK = 65536
+SFGAO_SHARE = 131072
+SFGAO_READONLY = 262144
+SFGAO_GHOSTED = 524288
+SFGAO_HIDDEN = 524288
+SFGAO_DISPLAYATTRMASK = 983040
+SFGAO_FILESYSANCESTOR = 268435456
+SFGAO_FOLDER = 536870912
+SFGAO_FILESYSTEM = 1073741824
+SFGAO_HASSUBFOLDER = -2147483648
+SFGAO_CONTENTSMASK = -2147483648
+SFGAO_VALIDATE = 16777216
+SFGAO_REMOVABLE = 33554432
+SFGAO_COMPRESSED = 67108864
+SFGAO_BROWSABLE = 134217728
+SFGAO_NONENUMERATED = 1048576
+SFGAO_NEWCONTENT = 2097152
+SFGAO_STORAGE = 8
+DWFRF_NORMAL = 0
+DWFRF_DELETECONFIGDATA = 1
+DWFAF_HIDDEN = 1
+CFSTR_SHELLIDLIST = "Shell IDList Array"
+CFSTR_SHELLIDLISTOFFSET = "Shell Object Offsets"
+CFSTR_NETRESOURCES = "Net Resource"
+CFSTR_FILEDESCRIPTORA = "FileGroupDescriptor"
+CFSTR_FILEDESCRIPTORW = "FileGroupDescriptorW"
+CFSTR_FILECONTENTS = "FileContents"
+CFSTR_FILENAMEA = "FileName"
+CFSTR_FILENAMEW = "FileNameW"
+CFSTR_PRINTERGROUP = "PrinterFriendlyName"
+CFSTR_FILENAMEMAPA = "FileNameMap"
+CFSTR_FILENAMEMAPW = "FileNameMapW"
+CFSTR_SHELLURL = "UniformResourceLocator"
+CFSTR_INETURLA = CFSTR_SHELLURL
+CFSTR_INETURLW = "UniformResourceLocatorW"
+CFSTR_PREFERREDDROPEFFECT = "Preferred DropEffect"
+CFSTR_PERFORMEDDROPEFFECT = "Performed DropEffect"
+CFSTR_PASTESUCCEEDED = "Paste Succeeded"
+CFSTR_INDRAGLOOP = "InShellDragLoop"
+CFSTR_DRAGCONTEXT = "DragContext"
+CFSTR_MOUNTEDVOLUME = "MountedVolume"
+CFSTR_PERSISTEDDATAOBJECT = "PersistedDataObject"
+CFSTR_TARGETCLSID = "TargetCLSID"
+CFSTR_LOGICALPERFORMEDDROPEFFECT = "Logical Performed DropEffect"
+CFSTR_AUTOPLAY_SHELLIDLISTS = "Autoplay Enumerated IDList Array"
+CFSTR_FILEDESCRIPTOR = CFSTR_FILEDESCRIPTORA
+CFSTR_FILENAME = CFSTR_FILENAMEA
+CFSTR_FILENAMEMAP = CFSTR_FILENAMEMAPA
+DVASPECT_SHORTNAME = 2
+SHCNE_RENAMEITEM = 1
+SHCNE_CREATE = 2
+SHCNE_DELETE = 4
+SHCNE_MKDIR = 8
+SHCNE_RMDIR = 16
+SHCNE_MEDIAINSERTED = 32
+SHCNE_MEDIAREMOVED = 64
+SHCNE_DRIVEREMOVED = 128
+SHCNE_DRIVEADD = 256
+SHCNE_NETSHARE = 512
+SHCNE_NETUNSHARE = 1024
+SHCNE_ATTRIBUTES = 2048
+SHCNE_UPDATEDIR = 4096
+SHCNE_UPDATEITEM = 8192
+SHCNE_SERVERDISCONNECT = 16384
+SHCNE_UPDATEIMAGE = 32768
+SHCNE_DRIVEADDGUI = 65536
+SHCNE_RENAMEFOLDER = 131072
+SHCNE_FREESPACE = 262144
+SHCNE_EXTENDED_EVENT = 67108864
+SHCNE_ASSOCCHANGED = 134217728
+SHCNE_DISKEVENTS = 145439
+SHCNE_GLOBALEVENTS = 201687520
+SHCNE_ALLEVENTS = 2147483647
+SHCNE_INTERRUPT = -2147483648
+SHCNEE_ORDERCHANGED = 2
+SHCNF_IDLIST = 0
+SHCNF_PATHA = 1
+SHCNF_PRINTERA = 2
+SHCNF_DWORD = 3
+SHCNF_PATHW = 5
+SHCNF_PRINTERW = 6
+SHCNF_TYPE = 255
+SHCNF_FLUSH = 4096
+SHCNF_FLUSHNOWAIT = 8192
+SHCNF_PATH = SHCNF_PATHA
+SHCNF_PRINTER = SHCNF_PRINTERA
+QIF_CACHED = 1
+QIF_DONTEXPANDFOLDER = 2
+
+# SHARD enum for SHAddToRecentDocs
+SHARD_PIDL = 1
+SHARD_PATHA = 2
+SHARD_PATHW = 3
+SHARD_APPIDINFO = 4
+SHARD_APPIDINFOIDLIST = 5
+SHARD_LINK = 6
+SHARD_APPIDINFOLINK = 7
+SHARD_SHELLITEM = 8
+## SHARD_PATH = SHARD_PATHW
+SHARD_PATH = SHARD_PATHA
+
+SHGDFIL_FINDDATA = 1
+SHGDFIL_NETRESOURCE = 2
+SHGDFIL_DESCRIPTIONID = 3
+SHDID_ROOT_REGITEM = 1
+SHDID_FS_FILE = 2
+SHDID_FS_DIRECTORY = 3
+SHDID_FS_OTHER = 4
+SHDID_COMPUTER_DRIVE35 = 5
+SHDID_COMPUTER_DRIVE525 = 6
+SHDID_COMPUTER_REMOVABLE = 7
+SHDID_COMPUTER_FIXED = 8
+SHDID_COMPUTER_NETDRIVE = 9
+SHDID_COMPUTER_CDROM = 10
+SHDID_COMPUTER_RAMDISK = 11
+SHDID_COMPUTER_OTHER = 12
+SHDID_NET_DOMAIN = 13
+SHDID_NET_SERVER = 14
+SHDID_NET_SHARE = 15
+SHDID_NET_RESTOFNET = 16
+SHDID_NET_OTHER = 17
+PID_IS_URL = 2
+PID_IS_NAME = 4
+PID_IS_WORKINGDIR = 5
+PID_IS_HOTKEY = 6
+PID_IS_SHOWCMD = 7
+PID_IS_ICONINDEX = 8
+PID_IS_ICONFILE = 9
+PID_IS_WHATSNEW = 10
+PID_IS_AUTHOR = 11
+PID_IS_DESCRIPTION = 12
+PID_IS_COMMENT = 13
+PID_INTSITE_WHATSNEW = 2
+PID_INTSITE_AUTHOR = 3
+PID_INTSITE_LASTVISIT = 4
+PID_INTSITE_LASTMOD = 5
+PID_INTSITE_VISITCOUNT = 6
+PID_INTSITE_DESCRIPTION = 7
+PID_INTSITE_COMMENT = 8
+PID_INTSITE_FLAGS = 9
+PID_INTSITE_CONTENTLEN = 10
+PID_INTSITE_CONTENTCODE = 11
+PID_INTSITE_RECURSE = 12
+PID_INTSITE_WATCH = 13
+PID_INTSITE_SUBSCRIPTION = 14
+PID_INTSITE_URL = 15
+PID_INTSITE_TITLE = 16
+PID_INTSITE_CODEPAGE = 18
+PID_INTSITE_TRACKING = 19
+PIDISF_RECENTLYCHANGED = 1
+PIDISF_CACHEDSTICKY = 2
+PIDISF_CACHEIMAGES = 16
+PIDISF_FOLLOWALLLINKS = 32
+PIDISM_GLOBAL = 0
+PIDISM_WATCH = 1
+PIDISM_DONTWATCH = 2
+SSF_SHOWALLOBJECTS = 1
+SSF_SHOWEXTENSIONS = 2
+SSF_SHOWCOMPCOLOR = 8
+SSF_SHOWSYSFILES = 32
+SSF_DOUBLECLICKINWEBVIEW = 128
+SSF_SHOWATTRIBCOL = 256
+SSF_DESKTOPHTML = 512
+SSF_WIN95CLASSIC = 1024
+SSF_DONTPRETTYPATH = 2048
+SSF_SHOWINFOTIP = 8192
+SSF_MAPNETDRVBUTTON = 4096
+SSF_NOCONFIRMRECYCLE = 32768
+SSF_HIDEICONS = 16384
+
+ABM_NEW = 0
+ABM_REMOVE = 1
+ABM_QUERYPOS = 2
+ABM_SETPOS = 3
+ABM_GETSTATE = 4
+ABM_GETTASKBARPOS = 5
+ABM_ACTIVATE = 6
+ABM_GETAUTOHIDEBAR = 7
+ABM_SETAUTOHIDEBAR = 8
+ABM_WINDOWPOSCHANGED = 9
+ABN_STATECHANGE = 0
+ABN_POSCHANGED = 1
+ABN_FULLSCREENAPP = 2
+ABN_WINDOWARRANGE = 3
+ABS_AUTOHIDE = 1
+ABS_ALWAYSONTOP = 2
+ABE_LEFT = 0
+ABE_TOP = 1
+ABE_RIGHT = 2
+ABE_BOTTOM = 3
+
+
+def EIRESID(x):
+    return -1 * (int)(x)
+
+
+# Some manually added ones
+
+SHCONTF_FOLDERS = 32  # for shell browser
+SHCONTF_NONFOLDERS = 64  # for default view
+SHCONTF_INCLUDEHIDDEN = 128  # for hidden/system objects
+SHCONTF_INIT_ON_FIRST_NEXT = 256
+SHCONTF_NETPRINTERSRCH = 512
+SHCONTF_SHAREABLE = 1024
+SHCONTF_STORAGE = 2048
+
+SHGDN_NORMAL = 0  # default (display purpose)
+SHGDN_INFOLDER = 1  # displayed under a folder (relative)
+SHGDN_FOREDITING = 4096  # for in-place editing
+SHGDN_INCLUDE_NONFILESYS = 8192  # if not set, display names for shell name space items that are not in the file system will fail.
+SHGDN_FORADDRESSBAR = 16384  # for displaying in the address (drives dropdown) bar
+SHGDN_FORPARSING = 32768  # for ParseDisplayName or path
+
+BFO_NONE = 0
+BFO_BROWSER_PERSIST_SETTINGS = 1
+BFO_RENAME_FOLDER_OPTIONS_TOINTERNET = 2
+BFO_BOTH_OPTIONS = 4
+BIF_PREFER_INTERNET_SHORTCUT = 8
+BFO_BROWSE_NO_IN_NEW_PROCESS = 16
+BFO_ENABLE_HYPERLINK_TRACKING = 32
+BFO_USE_IE_OFFLINE_SUPPORT = 64
+BFO_SUBSTITUE_INTERNET_START_PAGE = 128
+BFO_USE_IE_LOGOBANDING = 256
+BFO_ADD_IE_TOCAPTIONBAR = 512
+BFO_USE_DIALUP_REF = 1024
+BFO_USE_IE_TOOLBAR = 2048
+BFO_NO_PARENT_FOLDER_SUPPORT = 4096
+BFO_NO_REOPEN_NEXT_RESTART = 8192
+BFO_GO_HOME_PAGE = 16384
+BFO_PREFER_IEPROCESS = 32768
+BFO_SHOW_NAVIGATION_CANCELLED = 65536
+BFO_QUERY_ALL = -1
+# From ShlGuid.h
+PID_FINDDATA = 0
+PID_NETRESOURCE = 1
+PID_DESCRIPTIONID = 2
+PID_WHICHFOLDER = 3
+PID_NETWORKLOCATION = 4
+PID_COMPUTERNAME = 5
+PID_DISPLACED_FROM = 2
+PID_DISPLACED_DATE = 3
+PID_SYNC_COPY_IN = 2
+PID_MISC_STATUS = 2
+PID_MISC_ACCESSCOUNT = 3
+PID_MISC_OWNER = 4
+PID_HTMLINFOTIPFILE = 5
+PID_MISC_PICS = 6
+PID_DISPLAY_PROPERTIES = 0
+PID_INTROTEXT = 1
+PIDSI_ARTIST = 2
+PIDSI_SONGTITLE = 3
+PIDSI_ALBUM = 4
+PIDSI_YEAR = 5
+PIDSI_COMMENT = 6
+PIDSI_TRACK = 7
+PIDSI_GENRE = 11
+PIDSI_LYRICS = 12
+PIDDRSI_PROTECTED = 2
+PIDDRSI_DESCRIPTION = 3
+PIDDRSI_PLAYCOUNT = 4
+PIDDRSI_PLAYSTARTS = 5
+PIDDRSI_PLAYEXPIRES = 6
+PIDVSI_STREAM_NAME = 2
+PIDVSI_FRAME_WIDTH = 3
+PIDVSI_FRAME_HEIGHT = 4
+PIDVSI_TIMELENGTH = 7
+PIDVSI_FRAME_COUNT = 5
+PIDVSI_FRAME_RATE = 6
+PIDVSI_DATA_RATE = 8
+PIDVSI_SAMPLE_SIZE = 9
+PIDVSI_COMPRESSION = 10
+PIDVSI_STREAM_NUMBER = 11
+PIDASI_FORMAT = 2
+PIDASI_TIMELENGTH = 3
+PIDASI_AVG_DATA_RATE = 4
+PIDASI_SAMPLE_RATE = 5
+PIDASI_SAMPLE_SIZE = 6
+PIDASI_CHANNEL_COUNT = 7
+PIDASI_STREAM_NUMBER = 8
+PIDASI_STREAM_NAME = 9
+PIDASI_COMPRESSION = 10
+PID_CONTROLPANEL_CATEGORY = 2
+PID_VOLUME_FREE = 2
+PID_VOLUME_CAPACITY = 3
+PID_VOLUME_FILESYSTEM = 4
+PID_SHARE_CSC_STATUS = 2
+PID_LINK_TARGET = 2
+PID_QUERY_RANK = 2
+# From PropIdl.h
+PROPSETFLAG_DEFAULT = 0
+PROPSETFLAG_NONSIMPLE = 1
+PROPSETFLAG_ANSI = 2
+PROPSETFLAG_UNBUFFERED = 4
+PROPSETFLAG_CASE_SENSITIVE = 8
+PROPSET_BEHAVIOR_CASE_SENSITIVE = 1
+PID_DICTIONARY = 0
+PID_CODEPAGE = 1
+PID_FIRST_USABLE = 2
+PID_FIRST_NAME_DEFAULT = 4095
+PID_LOCALE = -2147483648
+PID_MODIFY_TIME = -2147483647
+PID_SECURITY = -2147483646
+PID_BEHAVIOR = -2147483645
+PID_ILLEGAL = -1
+PID_MIN_READONLY = -2147483648
+PID_MAX_READONLY = -1073741825
+PIDDI_THUMBNAIL = 2
+PIDSI_TITLE = 2
+PIDSI_SUBJECT = 3
+PIDSI_AUTHOR = 4
+PIDSI_KEYWORDS = 5
+PIDSI_COMMENTS = 6
+PIDSI_TEMPLATE = 7
+PIDSI_LASTAUTHOR = 8
+PIDSI_REVNUMBER = 9
+PIDSI_EDITTIME = 10
+PIDSI_LASTPRINTED = 11
+PIDSI_CREATE_DTM = 12
+PIDSI_LASTSAVE_DTM = 13
+PIDSI_PAGECOUNT = 14
+PIDSI_WORDCOUNT = 15
+PIDSI_CHARCOUNT = 16
+PIDSI_THUMBNAIL = 17
+PIDSI_APPNAME = 18
+PIDSI_DOC_SECURITY = 19
+PIDDSI_CATEGORY = 2
+PIDDSI_PRESFORMAT = 3
+PIDDSI_BYTECOUNT = 4
+PIDDSI_LINECOUNT = 5
+PIDDSI_PARCOUNT = 6
+PIDDSI_SLIDECOUNT = 7
+PIDDSI_NOTECOUNT = 8
+PIDDSI_HIDDENCOUNT = 9
+PIDDSI_MMCLIPCOUNT = 10
+PIDDSI_SCALE = 11
+PIDDSI_HEADINGPAIR = 12
+PIDDSI_DOCPARTS = 13
+PIDDSI_MANAGER = 14
+PIDDSI_COMPANY = 15
+PIDDSI_LINKSDIRTY = 16
+PIDMSI_EDITOR = 2
+PIDMSI_SUPPLIER = 3
+PIDMSI_SOURCE = 4
+PIDMSI_SEQUENCE_NO = 5
+PIDMSI_PROJECT = 6
+PIDMSI_STATUS = 7
+PIDMSI_OWNER = 8
+PIDMSI_RATING = 9
+PIDMSI_PRODUCTION = 10
+PIDMSI_COPYRIGHT = 11
+PRSPEC_INVALID = -1
+PRSPEC_LPWSTR = 0
+PRSPEC_PROPID = 1
+# From ShObjIdl.h
+SHCIDS_ALLFIELDS = -2147483648
+SHCIDS_CANONICALONLY = 268435456
+SHCIDS_BITMASK = -65536
+SHCIDS_COLUMNMASK = 65535
+SFGAO_CANMONIKER = 4194304
+SFGAO_HASSTORAGE = 4194304
+SFGAO_STREAM = 4194304
+SFGAO_STORAGEANCESTOR = 8388608
+SFGAO_STORAGECAPMASK = 1891958792
+
+MAXPROPPAGES = 100
+PSP_DEFAULT = 0
+PSP_DLGINDIRECT = 1
+PSP_USEHICON = 2
+PSP_USEICONID = 4
+PSP_USETITLE = 8
+PSP_RTLREADING = 16
+PSP_HASHELP = 32
+PSP_USEREFPARENT = 64
+PSP_USECALLBACK = 128
+PSP_PREMATURE = 1024
+PSP_HIDEHEADER = 2048
+PSP_USEHEADERTITLE = 4096
+PSP_USEHEADERSUBTITLE = 8192
+PSP_USEFUSIONCONTEXT = 16384
+PSPCB_ADDREF = 0
+PSPCB_RELEASE = 1
+PSPCB_CREATE = 2
+
+PSH_DEFAULT = 0
+PSH_PROPTITLE = 1
+PSH_USEHICON = 2
+PSH_USEICONID = 4
+PSH_PROPSHEETPAGE = 8
+PSH_WIZARDHASFINISH = 16
+PSH_WIZARD = 32
+PSH_USEPSTARTPAGE = 64
+PSH_NOAPPLYNOW = 128
+PSH_USECALLBACK = 256
+PSH_HASHELP = 512
+PSH_MODELESS = 1024
+PSH_RTLREADING = 2048
+PSH_WIZARDCONTEXTHELP = 4096
+PSH_WIZARD97 = 16777216
+PSH_WATERMARK = 32768
+PSH_USEHBMWATERMARK = 65536
+PSH_USEHPLWATERMARK = 131072
+PSH_STRETCHWATERMARK = 262144
+PSH_HEADER = 524288
+PSH_USEHBMHEADER = 1048576
+PSH_USEPAGELANG = 2097152
+PSH_WIZARD_LITE = 4194304
+PSH_NOCONTEXTHELP = 33554432
+
+PSCB_INITIALIZED = 1
+PSCB_PRECREATE = 2
+PSCB_BUTTONPRESSED = 3
+PSNRET_NOERROR = 0
+PSNRET_INVALID = 1
+PSNRET_INVALID_NOCHANGEPAGE = 2
+PSNRET_MESSAGEHANDLED = 3
+
+PSWIZB_BACK = 1
+PSWIZB_NEXT = 2
+PSWIZB_FINISH = 4
+PSWIZB_DISABLEDFINISH = 8
+PSBTN_BACK = 0
+PSBTN_NEXT = 1
+PSBTN_FINISH = 2
+PSBTN_OK = 3
+PSBTN_APPLYNOW = 4
+PSBTN_CANCEL = 5
+PSBTN_HELP = 6
+PSBTN_MAX = 6
+
+ID_PSRESTARTWINDOWS = 2
+ID_PSREBOOTSYSTEM = ID_PSRESTARTWINDOWS | 1
+WIZ_CXDLG = 276
+WIZ_CYDLG = 140
+WIZ_CXBMP = 80
+WIZ_BODYX = 92
+WIZ_BODYCX = 184
+PROP_SM_CXDLG = 212
+PROP_SM_CYDLG = 188
+PROP_MED_CXDLG = 227
+PROP_MED_CYDLG = 215
+PROP_LG_CXDLG = 252
+PROP_LG_CYDLG = 218
+ISOLATION_AWARE_USE_STATIC_LIBRARY = 0
+ISOLATION_AWARE_BUILD_STATIC_LIBRARY = 0
+
+SHCOLSTATE_TYPE_STR = 1
+SHCOLSTATE_TYPE_INT = 2
+SHCOLSTATE_TYPE_DATE = 3
+SHCOLSTATE_TYPEMASK = 15
+SHCOLSTATE_ONBYDEFAULT = 16
+SHCOLSTATE_SLOW = 32
+SHCOLSTATE_EXTENDED = 64
+SHCOLSTATE_SECONDARYUI = 128
+SHCOLSTATE_HIDDEN = 256
+SHCOLSTATE_PREFER_VARCMP = 512
+
+FWF_AUTOARRANGE = 1
+FWF_ABBREVIATEDNAMES = 2
+FWF_SNAPTOGRID = 4
+FWF_OWNERDATA = 8
+FWF_BESTFITWINDOW = 16
+FWF_DESKTOP = 32
+FWF_SINGLESEL = 64
+FWF_NOSUBFOLDERS = 128
+FWF_TRANSPARENT = 256
+FWF_NOCLIENTEDGE = 512
+FWF_NOSCROLL = 1024
+FWF_ALIGNLEFT = 2048
+FWF_NOICONS = 4096
+FWF_SHOWSELALWAYS = 8192
+FWF_NOVISIBLE = 16384
+FWF_SINGLECLICKACTIVATE = 32768
+FWF_NOWEBVIEW = 65536
+FWF_HIDEFILENAMES = 131072
+FWF_CHECKSELECT = 262144
+
+FVM_FIRST = 1
+FVM_ICON = 1
+FVM_SMALLICON = 2
+FVM_LIST = 3
+FVM_DETAILS = 4
+FVM_THUMBNAIL = 5
+FVM_TILE = 6
+FVM_THUMBSTRIP = 7
+
+SVUIA_DEACTIVATE = 0
+SVUIA_ACTIVATE_NOFOCUS = 1
+SVUIA_ACTIVATE_FOCUS = 2
+SVUIA_INPLACEACTIVATE = 3
+
+# SHChangeNotifyRegister flags
+SHCNRF_InterruptLevel = 1
+SHCNRF_ShellLevel = 2
+SHCNRF_RecursiveInterrupt = 4096
+SHCNRF_NewDelivery = 32768
+
+FD_CLSID = 0x0001
+FD_SIZEPOINT = 0x0002
+FD_ATTRIBUTES = 0x0004
+FD_CREATETIME = 0x0008
+FD_ACCESSTIME = 0x0010
+FD_WRITESTIME = 0x0020
+FD_FILESIZE = 0x0040
+FD_PROGRESSUI = 0x4000
+FD_LINKUI = 0x8000
+
+# shlwapi stuff
+ASSOCF_INIT_NOREMAPCLSID = 0x00000001  #  do not remap clsids to progids
+ASSOCF_INIT_BYEXENAME = 0x00000002  # executable is being passed in
+ASSOCF_OPEN_BYEXENAME = 0x00000002  # executable is being passed in
+ASSOCF_INIT_DEFAULTTOSTAR = 0x00000004  # treat "*" as the BaseClass
+ASSOCF_INIT_DEFAULTTOFOLDER = 0x00000008  # treat "Folder" as the BaseClass
+ASSOCF_NOUSERSETTINGS = 0x00000010  #  dont use HKCU
+ASSOCF_NOTRUNCATE = 0x00000020  # dont truncate the return string
+ASSOCF_VERIFY = 0x00000040  #  verify data is accurate (DISK HITS)
+ASSOCF_REMAPRUNDLL = 0x00000080  # actually gets info about rundlls target if applicable
+ASSOCF_NOFIXUPS = 0x00000100  # attempt to fix errors if found
+ASSOCF_IGNOREBASECLASS = 0x00000200  # dont recurse into the baseclass
+
+ASSOCSTR_COMMAND = 1  # shell\verb\command string
+ASSOCSTR_EXECUTABLE = 2  # the executable part of command string
+ASSOCSTR_FRIENDLYDOCNAME = 3  # friendly name of the document type
+ASSOCSTR_FRIENDLYAPPNAME = 4  # friendly name of executable
+ASSOCSTR_NOOPEN = 5  # noopen value
+ASSOCSTR_SHELLNEWVALUE = 6  # query values under the shellnew key
+ASSOCSTR_DDECOMMAND = 7  # template for DDE commands
+ASSOCSTR_DDEIFEXEC = 8  # DDECOMMAND to use if just create a process
+ASSOCSTR_DDEAPPLICATION = 9  # Application name in DDE broadcast
+ASSOCSTR_DDETOPIC = 10  # Topic Name in DDE broadcast
+ASSOCSTR_INFOTIP = (
+    11  # info tip for an item, or list of properties to create info tip from
+)
+ASSOCSTR_QUICKTIP = 12  # same as ASSOCSTR_INFOTIP, except, this list contains only quickly retrievable properties
+ASSOCSTR_TILEINFO = (
+    13  # similar to ASSOCSTR_INFOTIP - lists important properties for tileview
+)
+ASSOCSTR_CONTENTTYPE = 14  # MIME Content type
+ASSOCSTR_DEFAULTICON = 15  # Default icon source
+ASSOCSTR_SHELLEXTENSION = (
+    16  # Guid string pointing to the Shellex\Shellextensionhandler value.
+)
+
+ASSOCKEY_SHELLEXECCLASS = 1  # the key that should be passed to ShellExec(hkeyClass)
+ASSOCKEY_APP = 2  # the "Application" key for the association
+ASSOCKEY_CLASS = 3  # the progid or class key
+ASSOCKEY_BASECLASS = 4  # the BaseClass key
+
+ASSOCDATA_MSIDESCRIPTOR = 1  # Component Descriptor to pass to MSI APIs
+ASSOCDATA_NOACTIVATEHANDLER = 2  # restrict attempts to activate window
+ASSOCDATA_QUERYCLASSSTORE = 3  # should check with the NT Class Store
+ASSOCDATA_HASPERUSERASSOC = 4  # defaults to user specified association
+ASSOCDATA_EDITFLAGS = 5  # Edit flags.
+ASSOCDATA_VALUE = 6  # use pszExtra as the Value name
+
+# flags used with SHGetViewStatePropertyBag
+SHGVSPB_PERUSER = 1
+SHGVSPB_ALLUSERS = 2
+SHGVSPB_PERFOLDER = 4
+SHGVSPB_ALLFOLDERS = 8
+SHGVSPB_INHERIT = 16
+SHGVSPB_ROAM = 32
+SHGVSPB_NOAUTODEFAULTS = 0x80000000
+SHGVSPB_FOLDER = SHGVSPB_PERUSER | SHGVSPB_PERFOLDER
+SHGVSPB_FOLDERNODEFAULTS = SHGVSPB_PERUSER | SHGVSPB_PERFOLDER | SHGVSPB_NOAUTODEFAULTS
+SHGVSPB_USERDEFAULTS = SHGVSPB_PERUSER | SHGVSPB_ALLFOLDERS
+SHGVSPB_GLOBALDEAFAULTS = SHGVSPB_ALLUSERS | SHGVSPB_ALLFOLDERS
+
+# IDeskband and related
+DBIM_MINSIZE = 0x0001
+DBIM_MAXSIZE = 0x0002
+DBIM_INTEGRAL = 0x0004
+DBIM_ACTUAL = 0x0008
+DBIM_TITLE = 0x0010
+DBIM_MODEFLAGS = 0x0020
+DBIM_BKCOLOR = 0x0040
+
+DBIMF_NORMAL = 0x0000
+DBIMF_VARIABLEHEIGHT = 0x0008
+DBIMF_DEBOSSED = 0x0020
+DBIMF_BKCOLOR = 0x0040
+
+DBIF_VIEWMODE_NORMAL = 0x0000
+DBIF_VIEWMODE_VERTICAL = 0x0001
+DBIF_VIEWMODE_FLOATING = 0x0002
+DBIF_VIEWMODE_TRANSPARENT = 0x0004
+
+# Message types used with SHShellFolderView_Message
+SFVM_REARRANGE = 1
+SFVM_ADDOBJECT = 3
+SFVM_REMOVEOBJECT = 6
+SFVM_UPDATEOBJECT = 7
+SFVM_GETSELECTEDOBJECTS = 9
+SFVM_SETITEMPOS = 14
+SFVM_SETCLIPBOARD = 16
+SFVM_SETPOINTS = 23
+
+# SHELL_LINK_DATA_FLAGS enum, used with IShellLinkDatalist
+SLDF_HAS_ID_LIST = 1
+SLDF_HAS_LINK_INFO = 2
+SLDF_HAS_NAME = 4
+SLDF_HAS_RELPATH = 8
+SLDF_HAS_WORKINGDIR = 16
+SLDF_HAS_ARGS = 32
+SLDF_HAS_ICONLOCATION = 64
+SLDF_UNICODE = 128
+SLDF_FORCE_NO_LINKINFO = 256
+SLDF_HAS_EXP_SZ = 512
+SLDF_RUN_IN_SEPARATE = 1024
+SLDF_HAS_LOGO3ID = 2048
+SLDF_HAS_DARWINID = 4096
+SLDF_RUNAS_USER = 8192
+SLDF_NO_PIDL_ALIAS = 32768
+SLDF_FORCE_UNCNAME = 65536
+SLDF_HAS_EXP_ICON_SZ = 16384
+SLDF_RUN_WITH_SHIMLAYER = 131072
+SLDF_RESERVED = 2147483648
+
+# IShellLinkDataList data block signatures
+EXP_SPECIAL_FOLDER_SIG = 2684354565
+NT_CONSOLE_PROPS_SIG = 2684354562
+NT_FE_CONSOLE_PROPS_SIG = 2684354564
+EXP_DARWIN_ID_SIG = 2684354566
+EXP_LOGO3_ID_SIG = 2684354567
+EXP_SZ_ICON_SIG = 2684354567
+EXP_SZ_LINK_SIG = 2684354561
+
+# IURL_SETURL_FLAGS enum, used with PyIUniformResourceLocator.SetURL
+IURL_SETURL_FL_GUESS_PROTOCOL = 1
+IURL_SETURL_FL_USE_DEFAULT_PROTOCOL = 2
+
+# IURL_INVOKECOMMAND_FLAGS enum, used with PyIUniformResourceLocator.InvokeCommand
+IURL_INVOKECOMMAND_FL_ALLOW_UI = 1
+IURL_INVOKECOMMAND_FL_USE_DEFAULT_VERB = 2
+IURL_INVOKECOMMAND_FL_DDEWAIT = 4
+
+## constants used with IActiveDesktop
+# COMPONENT.ComponentType
+COMP_TYPE_HTMLDOC = 0
+COMP_TYPE_PICTURE = 1
+COMP_TYPE_WEBSITE = 2
+COMP_TYPE_CONTROL = 3
+COMP_TYPE_CFHTML = 4
+COMP_TYPE_MAX = 4
+# COMPONENT.CurItemState
+IS_NORMAL = 1
+IS_FULLSCREEN = 2
+IS_SPLIT = 4
+IS_VALIDSIZESTATEBITS = IS_NORMAL | IS_SPLIT | IS_FULLSCREEN
+IS_VALIDSTATEBITS = IS_NORMAL | IS_SPLIT | IS_FULLSCREEN | 0x80000000 | 0x40000000
+# IActiveDesktop.ApplyChanges Flags
+AD_APPLY_SAVE = 1
+AD_APPLY_HTMLGEN = 2
+AD_APPLY_REFRESH = 4
+AD_APPLY_ALL = AD_APPLY_SAVE | AD_APPLY_HTMLGEN | AD_APPLY_REFRESH
+AD_APPLY_FORCE = 8
+AD_APPLY_BUFFERED_REFRESH = 16
+AD_APPLY_DYNAMICREFRESH = 32
+# Wallpaper styles used with GetWallpaper and SetWallpaper
+WPSTYLE_CENTER = 0
+WPSTYLE_TILE = 1
+WPSTYLE_STRETCH = 2
+WPSTYLE_MAX = 3
+# ModifyDesktopItem flags
+COMP_ELEM_TYPE = 0x00000001
+COMP_ELEM_CHECKED = 0x00000002
+COMP_ELEM_DIRTY = 0x00000004
+COMP_ELEM_NOSCROLL = 0x00000008
+COMP_ELEM_POS_LEFT = 0x00000010
+COMP_ELEM_POS_TOP = 0x00000020
+COMP_ELEM_SIZE_WIDTH = 0x00000040
+COMP_ELEM_SIZE_HEIGHT = 0x00000080
+COMP_ELEM_POS_ZINDEX = 0x00000100
+COMP_ELEM_SOURCE = 0x00000200
+COMP_ELEM_FRIENDLYNAME = 0x00000400
+COMP_ELEM_SUBSCRIBEDURL = 0x00000800
+COMP_ELEM_ORIGINAL_CSI = 0x00001000
+COMP_ELEM_RESTORED_CSI = 0x00002000
+COMP_ELEM_CURITEMSTATE = 0x00004000
+COMP_ELEM_ALL = (
+    COMP_ELEM_TYPE
+    | COMP_ELEM_CHECKED
+    | COMP_ELEM_DIRTY
+    | COMP_ELEM_NOSCROLL
+    | COMP_ELEM_POS_LEFT
+    | COMP_ELEM_SIZE_WIDTH
+    | COMP_ELEM_SIZE_HEIGHT
+    | COMP_ELEM_POS_ZINDEX
+    | COMP_ELEM_SOURCE
+    | COMP_ELEM_FRIENDLYNAME
+    | COMP_ELEM_POS_TOP
+    | COMP_ELEM_SUBSCRIBEDURL
+    | COMP_ELEM_ORIGINAL_CSI
+    | COMP_ELEM_RESTORED_CSI
+    | COMP_ELEM_CURITEMSTATE
+)
+
+DTI_ADDUI_DEFAULT = 0
+DTI_ADDUI_DISPSUBWIZARD = 1
+DTI_ADDUI_POSITIONITEM = 2
+ADDURL_SILENT = 0x0001
+COMPONENT_TOP = 0x3FFFFFFF
+COMPONENT_DEFAULT_LEFT = 0xFFFF
+COMPONENT_DEFAULT_TOP = 0xFFFF
+
+SSM_CLEAR = 0
+SSM_SET = 1
+SSM_REFRESH = 2
+SSM_UPDATE = 4
+
+SCHEME_DISPLAY = 0x0001
+SCHEME_EDIT = 0x0002
+SCHEME_LOCAL = 0x0004
+SCHEME_GLOBAL = 0x0008
+SCHEME_REFRESH = 0x0010
+SCHEME_UPDATE = 0x0020
+SCHEME_DONOTUSE = 0x0040
+SCHEME_CREATE = 0x0080
+
+GADOF_DIRTY = 1
+
+# From EmptyVC.h
+EVCF_HASSETTINGS = 0x0001
+EVCF_ENABLEBYDEFAULT = 0x0002
+EVCF_REMOVEFROMLIST = 0x0004
+EVCF_ENABLEBYDEFAULT_AUTO = 0x0008
+EVCF_DONTSHOWIFZERO = 0x0010
+EVCF_SETTINGSMODE = 0x0020
+EVCF_OUTOFDISKSPACE = 0x0040
+EVCCBF_LASTNOTIFICATION = 0x0001
+
+# ShObjIdl.h IExplorer* related
+EBO_NONE = 0
+EBO_NAVIGATEONCE = 0x1
+EBO_SHOWFRAMES = 0x2
+EBO_ALWAYSNAVIGATE = 0x4
+EBO_NOTRAVELLOG = 0x8
+EBO_NOWRAPPERWINDOW = 0x10
+EBF_NONE = 0
+EBF_SELECTFROMDATAOBJECT = 0x100
+EBF_NODROPTARGET = 0x200
+ECS_ENABLED = 0
+ECS_DISABLED = 0x1
+ECS_HIDDEN = 0x2
+ECS_CHECKBOX = 0x4
+ECS_CHECKED = 0x8
+
+ECF_HASSUBCOMMANDS = 0x1
+ECF_HASSPLITBUTTON = 0x2
+ECF_HIDELABEL = 0x4
+ECF_ISSEPARATOR = 0x8
+ECF_HASLUASHIELD = 0x10
+
+SIATTRIBFLAGS_AND = 0x1
+SIATTRIBFLAGS_OR = 0x2
+SIATTRIBFLAGS_APPCOMPAT = 0x3
+SIATTRIBFLAGS_MASK = 0x3
+
+SIGDN_NORMALDISPLAY = 0
+SIGDN_PARENTRELATIVEPARSING = -2147385343  ## 0x80018001
+SIGDN_DESKTOPABSOLUTEPARSING = -2147319808  ## 0x80028000
+SIGDN_PARENTRELATIVEEDITING = -2147282943  ## 0x80031001
+SIGDN_DESKTOPABSOLUTEEDITING = -2147172352  ## 0x8004c000
+SIGDN_FILESYSPATH = -2147123200  ## 0x80058000
+SIGDN_URL = -2147057664  ## 0x80068000
+SIGDN_PARENTRELATIVEFORADDRESSBAR = -2146975743  ## 0x8007c001,
+SIGDN_PARENTRELATIVE = -2146959359  ## 0x80080001
+
+SICHINT_DISPLAY = (0,)
+SICHINT_ALLFIELDS = -2147483648  ## 0x80000000
+SICHINT_CANONICAL = 0x10000000
+
+ASSOCCLASS_SHELL_KEY = 0
+ASSOCCLASS_PROGID_KEY = 1  # hkeyClass
+ASSOCCLASS_PROGID_STR = 2  # pszClass (HKCR\pszClass)
+ASSOCCLASS_CLSID_KEY = 3  # hkeyClass
+ASSOCCLASS_CLSID_STR = 4  #  pszClass (HKCR\CLSID\pszClass)
+ASSOCCLASS_APP_KEY = 5  # hkeyClass
+ASSOCCLASS_APP_STR = 6  # pszClass (HKCR\Applications\PathFindFileName(pszClass))
+ASSOCCLASS_SYSTEM_STR = 7  # pszClass
+ASSOCCLASS_FOLDER = 8  # none
+ASSOCCLASS_STAR = 9  # none
+
+NSTCS_HASEXPANDOS = 0x1
+NSTCS_HASLINES = 0x2
+NSTCS_SINGLECLICKEXPAND = 0x4
+NSTCS_FULLROWSELECT = 0x8
+NSTCS_SPRINGEXPAND = 0x10
+NSTCS_HORIZONTALSCROLL = 0x20
+NSTCS_ROOTHASEXPANDO = 0x40
+NSTCS_SHOWSELECTIONALWAYS = 0x80
+NSTCS_NOINFOTIP = 0x200
+NSTCS_EVENHEIGHT = 0x400
+NSTCS_NOREPLACEOPEN = 0x800
+NSTCS_DISABLEDRAGDROP = 0x1000
+NSTCS_NOORDERSTREAM = 0x2000
+NSTCS_RICHTOOLTIP = 0x4000
+NSTCS_BORDER = 0x8000
+NSTCS_NOEDITLABELS = 0x10000
+NSTCS_TABSTOP = 0x20000
+NSTCS_FAVORITESMODE = 0x80000
+NSTCS_AUTOHSCROLL = 0x100000
+NSTCS_FADEINOUTEXPANDOS = 0x200000
+NSTCS_EMPTYTEXT = 0x400000
+NSTCS_CHECKBOXES = 0x800000
+NSTCS_PARTIALCHECKBOXES = 0x1000000
+NSTCS_EXCLUSIONCHECKBOXES = 0x2000000
+NSTCS_DIMMEDCHECKBOXES = 0x4000000
+NSTCS_NOINDENTCHECKS = 0x8000000
+NSTCS_ALLOWJUNCTIONS = 0x10000000
+NSTCS_SHOWTABSBUTTON = 0x20000000
+NSTCS_SHOWDELETEBUTTON = 0x40000000
+NSTCS_SHOWREFRESHBUTTON = -2147483648  # 0x80000000
+
+NSTCRS_VISIBLE = 0
+NSTCRS_HIDDEN = 0x1
+NSTCRS_EXPANDED = 0x2
+NSTCIS_NONE = 0
+NSTCIS_SELECTED = 0x1
+NSTCIS_EXPANDED = 0x2
+NSTCIS_BOLD = 0x4
+NSTCIS_DISABLED = 0x8
+NSTCGNI_NEXT = 0
+NSTCGNI_NEXTVISIBLE = 0x1
+NSTCGNI_PREV = 0x2
+NSTCGNI_PREVVISIBLE = 0x3
+NSTCGNI_PARENT = 0x4
+NSTCGNI_CHILD = 0x5
+NSTCGNI_FIRSTVISIBLE = 0x6
+NSTCGNI_LASTVISIBLE = 0x7
+
+CLSID_ExplorerBrowser = "{71f96385-ddd6-48d3-a0c1-ae06e8b055fb}"
+
+# Names of the methods of many shell interfaces; used by implementation of
+# the interfaces.
+IBrowserFrame_Methods = ["GetFrameOptions"]
+ICategorizer_Methods = [
+    "GetDescription",
+    "GetCategory",
+    "GetCategoryInfo",
+    "CompareCategory",
+]
+ICategoryProvider_Methods = [
+    "CanCategorizeOnSCID",
+    "GetDefaultCategory",
+    "GetCategoryForSCID",
+    "EnumCategories",
+    "GetCategoryName",
+    "CreateCategory",
+]
+IContextMenu_Methods = ["QueryContextMenu", "InvokeCommand", "GetCommandString"]
+IExplorerCommand_Methods = [
+    "GetTitle",
+    "GetIcon",
+    "GetToolTip",
+    "GetCanonicalName",
+    "GetState",
+    "Invoke",
+    "GetFlags",
+    "EnumSubCommands",
+]
+IExplorerCommandProvider_Methods = ["GetCommand", "GetCommands"]
+IOleWindow_Methods = [
+    "GetWindow",
+    "ContextSensitiveHelp",
+]  # XXX - this should be somewhere in win32com
+IPersist_Methods = ["GetClassID"]
+IPersistFolder_Methods = IPersist_Methods + ["Initialize"]
+IPersistFolder2_Methods = IPersistFolder_Methods + ["GetCurFolder"]
+IShellExtInit_Methods = ["Initialize"]
+IShellView_Methods = IOleWindow_Methods + [
+    "TranslateAccelerator",
+    "EnableModeless",
+    "UIActivate",
+    "Refresh",
+    "CreateViewWindow",
+    "DestroyViewWindow",
+    "GetCurrentInfo",
+    "AddPropertySheetPages",
+    "SaveViewState",
+    "SelectItem",
+    "GetItemObject",
+]
+
+IShellFolder_Methods = [
+    "ParseDisplayName",
+    "EnumObjects",
+    "BindToObject",
+    "BindToStorage",
+    "CompareIDs",
+    "CreateViewObject",
+    "GetAttributesOf",
+    "GetUIObjectOf",
+    "GetDisplayNameOf",
+    "SetNameOf",
+]
+IShellFolder2_Methods = IShellFolder_Methods + [
+    "GetDefaultSearchGUID",
+    "EnumSearches",
+    "GetDefaultColumn",
+    "GetDefaultColumnState",
+    "GetDetailsEx",
+    "GetDetailsOf",
+    "MapColumnToSCID",
+]
+
+## enum GETPROPERTYSTOREFLAGS, used with IShellItem2 methods
+GPS_DEFAULT = 0
+GPS_HANDLERPROPERTIESONLY = 0x1
+GPS_READWRITE = 0x2
+GPS_TEMPORARY = 0x4
+GPS_FASTPROPERTIESONLY = 0x8
+GPS_OPENSLOWITEM = 0x10
+GPS_DELAYCREATION = 0x20
+GPS_BESTEFFORT = 0x40
+GPS_MASK_VALID = 0x7F
+
+## Bind context parameter names, used with IBindCtx::RegisterObjectParam
+STR_AVOID_DRIVE_RESTRICTION_POLICY = "Avoid Drive Restriction Policy"
+STR_BIND_DELEGATE_CREATE_OBJECT = "Delegate Object Creation"
+STR_BIND_FOLDERS_READ_ONLY = "Folders As Read Only"
+STR_BIND_FOLDER_ENUM_MODE = "Folder Enum Mode"
+STR_BIND_FORCE_FOLDER_SHORTCUT_RESOLVE = "Force Folder Shortcut Resolve"
+STR_DONT_PARSE_RELATIVE = "Don't Parse Relative"
+STR_DONT_RESOLVE_LINK = "Don't Resolve Link"
+## STR_ENUM_ITEMS_FLAGS
+STR_FILE_SYS_BIND_DATA = "File System Bind Data"
+STR_GET_ASYNC_HANDLER = "GetAsyncHandler"
+STR_GPS_BESTEFFORT = "GPS_BESTEFFORT"
+STR_GPS_DELAYCREATION = "GPS_DELAYCREATION"
+STR_GPS_FASTPROPERTIESONLY = "GPS_FASTPROPERTIESONLY"
+STR_GPS_HANDLERPROPERTIESONLY = "GPS_HANDLERPROPERTIESONLY"
+STR_GPS_NO_OPLOCK = "GPS_NO_OPLOCK"
+STR_GPS_OPENSLOWITEM = "GPS_OPENSLOWITEM"
+STR_IFILTER_FORCE_TEXT_FILTER_FALLBACK = "Always bind persistent handlers"
+STR_IFILTER_LOAD_DEFINED_FILTER = "Only bind registered persistent handlers"
+STR_INTERNAL_NAVIGATE = "Internal Navigation"
+STR_INTERNETFOLDER_PARSE_ONLY_URLMON_BINDABLE = "Validate URL"
+STR_ITEM_CACHE_CONTEXT = "ItemCacheContext"
+STR_NO_VALIDATE_FILENAME_CHARS = "NoValidateFilenameChars"
+STR_PARSE_ALLOW_INTERNET_SHELL_FOLDERS = "Allow binding to Internet shell folder handlers and negate STR_PARSE_PREFER_WEB_BROWSING"
+STR_PARSE_AND_CREATE_ITEM = "ParseAndCreateItem"
+STR_PARSE_DONT_REQUIRE_VALIDATED_URLS = "Do not require validated URLs"
+STR_PARSE_EXPLICIT_ASSOCIATION_SUCCESSFUL = "ExplicitAssociationSuccessful"
+STR_PARSE_PARTIAL_IDLIST = "ParseOriginalItem"
+STR_PARSE_PREFER_FOLDER_BROWSING = "Parse Prefer Folder Browsing"
+STR_PARSE_PREFER_WEB_BROWSING = "Do not bind to Internet shell folder handlers"
+STR_PARSE_PROPERTYSTORE = "DelegateNamedProperties"
+STR_PARSE_SHELL_PROTOCOL_TO_FILE_OBJECTS = "Parse Shell Protocol To File Objects"
+STR_PARSE_SHOW_NET_DIAGNOSTICS_UI = "Show network diagnostics UI"
+STR_PARSE_SKIP_NET_CACHE = "Skip Net Resource Cache"
+STR_PARSE_TRANSLATE_ALIASES = "Parse Translate Aliases"
+STR_PARSE_WITH_EXPLICIT_ASSOCAPP = "ExplicitAssociationApp"
+STR_PARSE_WITH_EXPLICIT_PROGID = "ExplicitProgid"
+STR_PARSE_WITH_PROPERTIES = "ParseWithProperties"
+## STR_PROPERTYBAG_PARAM
+STR_SKIP_BINDING_CLSID = "Skip Binding CLSID"
+STR_TRACK_CLSID = "Track the CLSID"
+
+## KF_REDIRECTION_CAPABILITIES enum
+KF_REDIRECTION_CAPABILITIES_ALLOW_ALL = 0x000000FF
+KF_REDIRECTION_CAPABILITIES_REDIRECTABLE = 0x00000001
+KF_REDIRECTION_CAPABILITIES_DENY_ALL = 0x000FFF00
+KF_REDIRECTION_CAPABILITIES_DENY_POLICY_REDIRECTED = 0x00000100
+KF_REDIRECTION_CAPABILITIES_DENY_POLICY = 0x00000200
+KF_REDIRECTION_CAPABILITIES_DENY_PERMISSIONS = 0x00000400
+
+## KF_REDIRECT_FLAGS enum
+KF_REDIRECT_USER_EXCLUSIVE = 0x00000001
+KF_REDIRECT_COPY_SOURCE_DACL = 0x00000002
+KF_REDIRECT_OWNER_USER = 0x00000004
+KF_REDIRECT_SET_OWNER_EXPLICIT = 0x00000008
+KF_REDIRECT_CHECK_ONLY = 0x00000010
+KF_REDIRECT_WITH_UI = 0x00000020
+KF_REDIRECT_UNPIN = 0x00000040
+KF_REDIRECT_PIN = 0x00000080
+KF_REDIRECT_COPY_CONTENTS = 0x00000200
+KF_REDIRECT_DEL_SOURCE_CONTENTS = 0x00000400
+KF_REDIRECT_EXCLUDE_ALL_KNOWN_SUBFOLDERS = 0x00000800
+
+## KF_CATEGORY enum
+KF_CATEGORY_VIRTUAL = 0x00000001
+KF_CATEGORY_FIXED = 0x00000002
+KF_CATEGORY_COMMON = 0x00000003
+KF_CATEGORY_PERUSER = 0x00000004
+
+## FFFP_MODE enum
+FFFP_EXACTMATCH = 0
+FFFP_NEARESTPARENTMATCH = 1
+
+## APPDOCLISTTYPE, used with IApplicationDocumentLists.GetList
+ADLT_RECENT = 0
+ADLT_FREQUENT = 1
+
+## KNOWNDESTCATEGORY used with ICustomDestinationList.AppendKnownCategory
+KDC_FREQUENT = 1
+KDC_RECENT = 2
+
+## LIBRARYFOLDERFILTER used with IShellLibrary.GetFolders
+LFF_FORCEFILESYSTEM = 1
+LFF_STORAGEITEMS = 2
+LFF_ALLITEMS = 3
+
+## DEFAULTSAVEFOLDERTYPE used with IShellLibrary.Get/SetDefaultSaveFolder
+DSFT_DETECT = 1
+DSFT_PRIVATE = 2
+DSFT_PUBLIC = 3
+
+## LIBRARYOPTIONFLAGS used with IShellLibrary.Get/SetOptions
+LOF_DEFAULT = 0
+LOF_PINNEDTONAVPANE = 1
+LOF_MASK_ALL = 1
+
+## LIBRARYSAVEFLAGS Used with PyIShellLibrary.Save
+LSF_FAILIFTHERE = 0
+LSF_OVERRIDEEXISTING = 1
+LSF_MAKEUNIQUENAME = 2
+
+## TRANSFER_SOURCE_FLAGS, used with IFileOperationProgressSink
+TSF_NORMAL = 0
+TSF_FAIL_EXIST = 0
+TSF_RENAME_EXIST = 0x1
+TSF_OVERWRITE_EXIST = 0x2
+TSF_ALLOW_DECRYPTION = 0x4
+TSF_NO_SECURITY = 0x8
+TSF_COPY_CREATION_TIME = 0x10
+TSF_COPY_WRITE_TIME = 0x20
+TSF_USE_FULL_ACCESS = 0x40
+TSF_DELETE_RECYCLE_IF_POSSIBLE = 0x80
+TSF_COPY_HARD_LINK = 0x100
+TSF_COPY_LOCALIZED_NAME = 0x200
+TSF_MOVE_AS_COPY_DELETE = 0x400
+TSF_SUSPEND_SHELLEVENTS = 0x800
+
+## TRANSFER_ADVISE_STATE, used with ITransferAdviseSink
+TS_NONE = 0
+TS_PERFORMING = 1
+TS_PREPARING = 2
+TS_INDETERMINATE = 4
+
+## Success HRESULTs returned by ITransfer* interface operations
+COPYENGINE_S_YES = 0x00270001
+COPYENGINE_S_NOT_HANDLED = 0x00270003
+COPYENGINE_S_USER_RETRY = 0x00270004
+COPYENGINE_S_USER_IGNORED = 0x00270005
+COPYENGINE_S_MERGE = 0x00270006
+COPYENGINE_S_DONT_PROCESS_CHILDREN = 0x00270008
+COPYENGINE_S_ALREADY_DONE = 0x0027000A
+COPYENGINE_S_PENDING = 0x0027000B
+COPYENGINE_S_KEEP_BOTH = 0x0027000C
+COPYENGINE_S_CLOSE_PROGRAM = 0x0027000D
+COPYENGINE_S_COLLISIONRESOLVED = 0x0027000E
+
+## Error HRESULTS
+COPYENGINE_E_USER_CANCELLED = 0x80270000
+COPYENGINE_E_CANCELLED = 0x80270001
+COPYENGINE_E_REQUIRES_ELEVATION = 0x80270002
+COPYENGINE_E_SAME_FILE = 0x80270003
+COPYENGINE_E_DIFF_DIR = 0x80270004
+COPYENGINE_E_MANY_SRC_1_DEST = 0x80270005
+COPYENGINE_E_DEST_SUBTREE = 0x80270009
+COPYENGINE_E_DEST_SAME_TREE = 0x8027000A
+COPYENGINE_E_FLD_IS_FILE_DEST = 0x8027000B
+COPYENGINE_E_FILE_IS_FLD_DEST = 0x8027000C
+COPYENGINE_E_FILE_TOO_LARGE = 0x8027000D
+COPYENGINE_E_REMOVABLE_FULL = 0x8027000E
+COPYENGINE_E_DEST_IS_RO_CD = 0x8027000F
+COPYENGINE_E_DEST_IS_RW_CD = 0x80270010
+COPYENGINE_E_DEST_IS_R_CD = 0x80270011
+COPYENGINE_E_DEST_IS_RO_DVD = 0x80270012
+COPYENGINE_E_DEST_IS_RW_DVD = 0x80270013
+COPYENGINE_E_DEST_IS_R_DVD = 0x80270014
+COPYENGINE_E_SRC_IS_RO_CD = 0x80270015
+COPYENGINE_E_SRC_IS_RW_CD = 0x80270016
+COPYENGINE_E_SRC_IS_R_CD = 0x80270017
+COPYENGINE_E_SRC_IS_RO_DVD = 0x80270018
+COPYENGINE_E_SRC_IS_RW_DVD = 0x80270019
+COPYENGINE_E_SRC_IS_R_DVD = 0x8027001A
+COPYENGINE_E_INVALID_FILES_SRC = 0x8027001B
+COPYENGINE_E_INVALID_FILES_DEST = 0x8027001C
+COPYENGINE_E_PATH_TOO_DEEP_SRC = 0x8027001D
+COPYENGINE_E_PATH_TOO_DEEP_DEST = 0x8027001E
+COPYENGINE_E_ROOT_DIR_SRC = 0x8027001F
+COPYENGINE_E_ROOT_DIR_DEST = 0x80270020
+COPYENGINE_E_ACCESS_DENIED_SRC = 0x80270021
+COPYENGINE_E_ACCESS_DENIED_DEST = 0x80270022
+COPYENGINE_E_PATH_NOT_FOUND_SRC = 0x80270023
+COPYENGINE_E_PATH_NOT_FOUND_DEST = 0x80270024
+COPYENGINE_E_NET_DISCONNECT_SRC = 0x80270025
+COPYENGINE_E_NET_DISCONNECT_DEST = 0x80270026
+COPYENGINE_E_SHARING_VIOLATION_SRC = 0x80270027
+COPYENGINE_E_SHARING_VIOLATION_DEST = 0x80270028
+COPYENGINE_E_ALREADY_EXISTS_NORMAL = 0x80270029
+COPYENGINE_E_ALREADY_EXISTS_READONLY = 0x8027002A
+COPYENGINE_E_ALREADY_EXISTS_SYSTEM = 0x8027002B
+COPYENGINE_E_ALREADY_EXISTS_FOLDER = 0x8027002C
+COPYENGINE_E_STREAM_LOSS = 0x8027002D
+COPYENGINE_E_EA_LOSS = 0x8027002E
+COPYENGINE_E_PROPERTY_LOSS = 0x8027002F
+COPYENGINE_E_PROPERTIES_LOSS = 0x80270030
+COPYENGINE_E_ENCRYPTION_LOSS = 0x80270031
+COPYENGINE_E_DISK_FULL = 0x80270032
+COPYENGINE_E_DISK_FULL_CLEAN = 0x80270033
+COPYENGINE_E_EA_NOT_SUPPORTED = 0x80270034
+COPYENGINE_E_CANT_REACH_SOURCE = 0x80270035
+COPYENGINE_E_RECYCLE_UNKNOWN_ERROR = 0x80270035
+COPYENGINE_E_RECYCLE_FORCE_NUKE = 0x80270036
+COPYENGINE_E_RECYCLE_SIZE_TOO_BIG = 0x80270037
+COPYENGINE_E_RECYCLE_PATH_TOO_LONG = 0x80270038
+COPYENGINE_E_RECYCLE_BIN_NOT_FOUND = 0x8027003A
+COPYENGINE_E_NEWFILE_NAME_TOO_LONG = 0x8027003B
+COPYENGINE_E_NEWFOLDER_NAME_TOO_LONG = 0x8027003C
+COPYENGINE_E_DIR_NOT_EMPTY = 0x8027003D
+COPYENGINE_E_FAT_MAX_IN_ROOT = 0x8027003E
+COPYENGINE_E_ACCESSDENIED_READONLY = 0x8027003F
+COPYENGINE_E_REDIRECTED_TO_WEBPAGE = 0x80270040
+COPYENGINE_E_SERVER_BAD_FILE_TYPE = 0x80270041
+
+FOLDERID_NetworkFolder = "{D20BEEC4-5CA8-4905-AE3B-BF251EA09B53}"
+FOLDERID_ComputerFolder = "{0AC0837C-BBF8-452A-850D-79D08E667CA7}"
+FOLDERID_InternetFolder = "{4D9F7874-4E0C-4904-967B-40B0D20C3E4B}"
+FOLDERID_ControlPanelFolder = "{82A74AEB-AEB4-465C-A014-D097EE346D63}"
+FOLDERID_PrintersFolder = "{76FC4E2D-D6AD-4519-A663-37BD56068185}"
+FOLDERID_SyncManagerFolder = "{43668BF8-C14E-49B2-97C9-747784D784B7}"
+FOLDERID_SyncSetupFolder = "{0F214138-B1D3-4a90-BBA9-27CBC0C5389A}"
+FOLDERID_ConflictFolder = "{4bfefb45-347d-4006-a5be-ac0cb0567192}"
+FOLDERID_SyncResultsFolder = "{289a9a43-be44-4057-a41b-587a76d7e7f9}"
+FOLDERID_RecycleBinFolder = "{B7534046-3ECB-4C18-BE4E-64CD4CB7D6AC}"
+FOLDERID_ConnectionsFolder = "{6F0CD92B-2E97-45D1-88FF-B0D186B8DEDD}"
+FOLDERID_Fonts = "{FD228CB7-AE11-4AE3-864C-16F3910AB8FE}"
+FOLDERID_Desktop = "{B4BFCC3A-DB2C-424C-B029-7FE99A87C641}"
+FOLDERID_Startup = "{B97D20BB-F46A-4C97-BA10-5E3608430854}"
+FOLDERID_Programs = "{A77F5D77-2E2B-44C3-A6A2-ABA601054A51}"
+FOLDERID_StartMenu = "{625B53C3-AB48-4EC1-BA1F-A1EF4146FC19}"
+FOLDERID_Recent = "{AE50C081-EBD2-438A-8655-8A092E34987A}"
+FOLDERID_SendTo = "{8983036C-27C0-404B-8F08-102D10DCFD74}"
+FOLDERID_Documents = "{FDD39AD0-238F-46AF-ADB4-6C85480369C7}"
+FOLDERID_Favorites = "{1777F761-68AD-4D8A-87BD-30B759FA33DD}"
+FOLDERID_NetHood = "{C5ABBF53-E17F-4121-8900-86626FC2C973}"
+FOLDERID_PrintHood = "{9274BD8D-CFD1-41C3-B35E-B13F55A758F4}"
+FOLDERID_Templates = "{A63293E8-664E-48DB-A079-DF759E0509F7}"
+FOLDERID_CommonStartup = "{82A5EA35-D9CD-47C5-9629-E15D2F714E6E}"
+FOLDERID_CommonPrograms = "{0139D44E-6AFE-49F2-8690-3DAFCAE6FFB8}"
+FOLDERID_CommonStartMenu = "{A4115719-D62E-491D-AA7C-E74B8BE3B067}"
+FOLDERID_PublicDesktop = "{C4AA340D-F20F-4863-AFEF-F87EF2E6BA25}"
+FOLDERID_ProgramData = "{62AB5D82-FDC1-4DC3-A9DD-070D1D495D97}"
+FOLDERID_CommonTemplates = "{B94237E7-57AC-4347-9151-B08C6C32D1F7}"
+FOLDERID_PublicDocuments = "{ED4824AF-DCE4-45A8-81E2-FC7965083634}"
+FOLDERID_RoamingAppData = "{3EB685DB-65F9-4CF6-A03A-E3EF65729F3D}"
+FOLDERID_LocalAppData = "{F1B32785-6FBA-4FCF-9D55-7B8E7F157091}"
+FOLDERID_LocalAppDataLow = "{A520A1A4-1780-4FF6-BD18-167343C5AF16}"
+FOLDERID_InternetCache = "{352481E8-33BE-4251-BA85-6007CAEDCF9D}"
+FOLDERID_Cookies = "{2B0F765D-C0E9-4171-908E-08A611B84FF6}"
+FOLDERID_History = "{D9DC8A3B-B784-432E-A781-5A1130A75963}"
+FOLDERID_System = "{1AC14E77-02E7-4E5D-B744-2EB1AE5198B7}"
+FOLDERID_SystemX86 = "{D65231B0-B2F1-4857-A4CE-A8E7C6EA7D27}"
+FOLDERID_Windows = "{F38BF404-1D43-42F2-9305-67DE0B28FC23}"
+FOLDERID_Profile = "{5E6C858F-0E22-4760-9AFE-EA3317B67173}"
+FOLDERID_Pictures = "{33E28130-4E1E-4676-835A-98395C3BC3BB}"
+FOLDERID_ProgramFilesX86 = "{7C5A40EF-A0FB-4BFC-874A-C0F2E0B9FA8E}"
+FOLDERID_ProgramFilesCommonX86 = "{DE974D24-D9C6-4D3E-BF91-F4455120B917}"
+FOLDERID_ProgramFilesX64 = "{6D809377-6AF0-444b-8957-A3773F02200E}"
+FOLDERID_ProgramFilesCommonX64 = "{6365D5A7-0F0D-45e5-87F6-0DA56B6A4F7D}"
+FOLDERID_ProgramFiles = "{905e63b6-c1bf-494e-b29c-65b732d3d21a}"
+FOLDERID_ProgramFilesCommon = "{F7F1ED05-9F6D-47A2-AAAE-29D317C6F066}"
+FOLDERID_UserProgramFiles = "{5cd7aee2-2219-4a67-b85d-6c9ce15660cb}"
+FOLDERID_UserProgramFilesCommon = "{bcbd3057-ca5c-4622-b42d-bc56db0ae516}"
+FOLDERID_AdminTools = "{724EF170-A42D-4FEF-9F26-B60E846FBA4F}"
+FOLDERID_CommonAdminTools = "{D0384E7D-BAC3-4797-8F14-CBA229B392B5}"
+FOLDERID_Music = "{4BD8D571-6D19-48D3-BE97-422220080E43}"
+FOLDERID_Videos = "{18989B1D-99B5-455B-841C-AB7C74E4DDFC}"
+FOLDERID_Ringtones = "{C870044B-F49E-4126-A9C3-B52A1FF411E8}"
+FOLDERID_PublicPictures = "{B6EBFB86-6907-413C-9AF7-4FC2ABF07CC5}"
+FOLDERID_PublicMusic = "{3214FAB5-9757-4298-BB61-92A9DEAA44FF}"
+FOLDERID_PublicVideos = "{2400183A-6185-49FB-A2D8-4A392A602BA3}"
+FOLDERID_PublicRingtones = "{E555AB60-153B-4D17-9F04-A5FE99FC15EC}"
+FOLDERID_ResourceDir = "{8AD10C31-2ADB-4296-A8F7-E4701232C972}"
+FOLDERID_LocalizedResourcesDir = "{2A00375E-224C-49DE-B8D1-440DF7EF3DDC}"
+FOLDERID_CommonOEMLinks = "{C1BAE2D0-10DF-4334-BEDD-7AA20B227A9D}"
+FOLDERID_CDBurning = "{9E52AB10-F80D-49DF-ACB8-4330F5687855}"
+FOLDERID_UserProfiles = "{0762D272-C50A-4BB0-A382-697DCD729B80}"
+FOLDERID_Playlists = "{DE92C1C7-837F-4F69-A3BB-86E631204A23}"
+FOLDERID_SamplePlaylists = "{15CA69B3-30EE-49C1-ACE1-6B5EC372AFB5}"
+FOLDERID_SampleMusic = "{B250C668-F57D-4EE1-A63C-290EE7D1AA1F}"
+FOLDERID_SamplePictures = "{C4900540-2379-4C75-844B-64E6FAF8716B}"
+FOLDERID_SampleVideos = "{859EAD94-2E85-48AD-A71A-0969CB56A6CD}"
+FOLDERID_PhotoAlbums = "{69D2CF90-FC33-4FB7-9A0C-EBB0F0FCB43C}"
+FOLDERID_Public = "{DFDF76A2-C82A-4D63-906A-5644AC457385}"
+FOLDERID_ChangeRemovePrograms = "{df7266ac-9274-4867-8d55-3bd661de872d}"
+FOLDERID_AppUpdates = "{a305ce99-f527-492b-8b1a-7e76fa98d6e4}"
+FOLDERID_AddNewPrograms = "{de61d971-5ebc-4f02-a3a9-6c82895e5c04}"
+FOLDERID_Downloads = "{374DE290-123F-4565-9164-39C4925E467B}"
+FOLDERID_PublicDownloads = "{3D644C9B-1FB8-4f30-9B45-F670235F79C0}"
+FOLDERID_SavedSearches = "{7d1d3a04-debb-4115-95cf-2f29da2920da}"
+FOLDERID_QuickLaunch = "{52a4f021-7b75-48a9-9f6b-4b87a210bc8f}"
+FOLDERID_Contacts = "{56784854-C6CB-462b-8169-88E350ACB882}"
+FOLDERID_SidebarParts = "{A75D362E-50FC-4fb7-AC2C-A8BEAA314493}"
+FOLDERID_SidebarDefaultParts = "{7B396E54-9EC5-4300-BE0A-2482EBAE1A26}"
+FOLDERID_PublicGameTasks = "{DEBF2536-E1A8-4c59-B6A2-414586476AEA}"
+FOLDERID_GameTasks = "{054FAE61-4DD8-4787-80B6-090220C4B700}"
+FOLDERID_SavedGames = "{4C5C32FF-BB9D-43b0-B5B4-2D72E54EAAA4}"
+FOLDERID_Games = "{CAC52C1A-B53D-4edc-92D7-6B2E8AC19434}"
+FOLDERID_SEARCH_MAPI = "{98ec0e18-2098-4d44-8644-66979315a281}"
+FOLDERID_SEARCH_CSC = "{ee32e446-31ca-4aba-814f-a5ebd2fd6d5e}"
+FOLDERID_Links = "{bfb9d5e0-c6a9-404c-b2b2-ae6db6af4968}"
+FOLDERID_UsersFiles = "{f3ce0f7c-4901-4acc-8648-d5d44b04ef8f}"
+FOLDERID_UsersLibraries = "{A302545D-DEFF-464b-ABE8-61C8648D939B}"
+FOLDERID_SearchHome = "{190337d1-b8ca-4121-a639-6d472d16972a}"
+FOLDERID_OriginalImages = "{2C36C0AA-5812-4b87-BFD0-4CD0DFB19B39}"
+FOLDERID_DocumentsLibrary = "{7b0db17d-9cd2-4a93-9733-46cc89022e7c}"
+FOLDERID_MusicLibrary = "{2112AB0A-C86A-4ffe-A368-0DE96E47012E}"
+FOLDERID_PicturesLibrary = "{A990AE9F-A03B-4e80-94BC-9912D7504104}"
+FOLDERID_VideosLibrary = "{491E922F-5643-4af4-A7EB-4E7A138D8174}"
+FOLDERID_RecordedTVLibrary = "{1A6FDBA2-F42D-4358-A798-B74D745926C5}"
+FOLDERID_HomeGroup = "{52528A6B-B9E3-4add-B60D-588C2DBA842D}"
+FOLDERID_HomeGroupCurrentUser = "{9B74B6A3-0DFD-4f11-9E78-5F7800F2E772}"
+FOLDERID_DeviceMetadataStore = "{5CE4A5E9-E4EB-479D-B89F-130C02886155}"
+FOLDERID_Libraries = "{1B3EA5DC-B587-4786-B4EF-BD1DC332AEAE}"
+FOLDERID_PublicLibraries = "{48daf80b-e6cf-4f4e-b800-0e69d84ee384}"
+FOLDERID_UserPinned = "{9e3995ab-1f9c-4f13-b827-48b24b6c7174}"
+FOLDERID_ImplicitAppShortcuts = "{bcb5256f-79f6-4cee-b725-dc34e402fd46}"
+FOLDERID_AccountPictures = "{008ca0b1-55b4-4c56-b8a8-4de4b299d3be}"
+FOLDERID_PublicUserTiles = "{0482af6c-08f1-4c34-8c90-e17ec98b1e17}"
+FOLDERID_AppsFolder = "{1e87508d-89c2-42f0-8a7e-645a0f50ca58}"
+FOLDERID_StartMenuAllPrograms = "{F26305EF-6948-40B9-B255-81453D09C785}"
+FOLDERID_CommonStartMenuPlaces = "{A440879F-87A0-4F7D-B700-0207B966194A}"
+FOLDERID_ApplicationShortcuts = "{A3918781-E5F2-4890-B3D9-A7E54332328C}"
+FOLDERID_RoamingTiles = "{00BCFC5A-ED94-4e48-96A1-3F6217F21990}"
+FOLDERID_RoamedTileImages = "{AAA8D5A5-F1D6-4259-BAA8-78E7EF60835E}"
+FOLDERID_Screenshots = "{b7bede81-df94-4682-a7d8-57a52620b86f}"
+FOLDERID_CameraRoll = "{AB5FB87B-7CE2-4F83-915D-550846C9537B}"
+FOLDERID_SkyDrive = "{A52BBA46-E9E1-435f-B3D9-28DAA648C0F6}"
+FOLDERID_OneDrive = "{A52BBA46-E9E1-435f-B3D9-28DAA648C0F6}"
+FOLDERID_SkyDriveDocuments = "{24D89E24-2F19-4534-9DDE-6A6671FBB8FE}"
+FOLDERID_SkyDrivePictures = "{339719B5-8C47-4894-94C2-D8F77ADD44A6}"
+FOLDERID_SkyDriveMusic = "{C3F2459E-80D6-45DC-BFEF-1F769F2BE730}"
+FOLDERID_SkyDriveCameraRoll = "{767E6811-49CB-4273-87C2-20F355E1085B}"
+FOLDERID_SearchHistory = "{0D4C3DB6-03A3-462F-A0E6-08924C41B5D4}"
+FOLDERID_SearchTemplates = "{7E636BFE-DFA9-4D5E-B456-D7B39851D8A9}"
+FOLDERID_CameraRollLibrary = "{2B20DF75-1EDA-4039-8097-38798227D5B7}"
+FOLDERID_SavedPictures = "{3B193882-D3AD-4eab-965A-69829D1FB59F}"
+FOLDERID_SavedPicturesLibrary = "{E25B5812-BE88-4bd9-94B0-29233477B6C3}"
+FOLDERID_RetailDemo = "{12D4C69E-24AD-4923-BE19-31321C43A767}"
+FOLDERID_Device = "{1C2AC1DC-4358-4B6C-9733-AF21156576F0}"
+FOLDERID_DevelopmentFiles = "{DBE8E08E-3053-4BBC-B183-2A7B2B191E59}"
+FOLDERID_Objects3D = "{31C0DD25-9439-4F12-BF41-7FF4EDA38722}"
+FOLDERID_AppCaptures = "{EDC0FE71-98D8-4F4A-B920-C8DC133CB165}"
+FOLDERID_LocalDocuments = "{f42ee2d3-909f-4907-8871-4c22fc0bf756}"
+FOLDERID_LocalPictures = "{0ddd015d-b06c-45d5-8c4c-f59713854639 }"
+FOLDERID_LocalVideos = "{35286a68-3c57-41a1-bbb1-0eae73d76c95}"
+FOLDERID_LocalMusic = "{a0c69a99-21c8-4671-8703-7934162fcf1d}"
+FOLDERID_LocalDownloads = "{7d83ee9b-2244-4e70-b1f5-5393042af1e4}"
+FOLDERID_RecordedCalls = "{2f8b40c2-83ed-48ee-b383-a1f157ec6f9a}"
+
+KF_FLAG_DEFAULT = 0x00000000
+KF_FLAG_FORCE_APP_DATA_REDIRECTION = 0x00080000
+KF_FLAG_RETURN_FILTER_REDIRECTION_TARGET = 0x00040000
+KF_FLAG_FORCE_PACKAGE_REDIRECTION = 0x00020000
+KF_FLAG_NO_PACKAGE_REDIRECTION = 0x00010000
+KF_FLAG_FORCE_APPCONTAINER_REDIRECTION = 0x00020000
+KF_FLAG_NO_APPCONTAINER_REDIRECTION = 0x00010000
+KF_FLAG_CREATE = 0x00008000
+KF_FLAG_DONT_VERIFY = 0x00004000
+KF_FLAG_DONT_UNEXPAND = 0x00002000
+KF_FLAG_NO_ALIAS = 0x00001000
+KF_FLAG_INIT = 0x00000800
+KF_FLAG_DEFAULT_PATH = 0x00000400
+KF_FLAG_NOT_PARENT_RELATIVE = 0x00000200
+KF_FLAG_SIMPLE_IDLIST = 0x00000100
+KF_FLAG_ALIAS_ONLY = 0x80000000
diff --git a/lib/win32comext/shell/test/testSHFileOperation.py b/lib/win32comext/shell/test/testSHFileOperation.py
new file mode 100644
index 00000000..8a896882
--- /dev/null
+++ b/lib/win32comext/shell/test/testSHFileOperation.py
@@ -0,0 +1,75 @@
+import os
+
+import win32api
+from win32com.shell import shell, shellcon
+
+
+def testSHFileOperation(file_cnt):
+    temp_dir = os.environ["temp"]
+    orig_fnames = [
+        win32api.GetTempFileName(temp_dir, "sfo")[0] for x in range(file_cnt)
+    ]
+    new_fnames = [
+        os.path.join(temp_dir, "copy of " + os.path.split(orig_fnames[x])[1])
+        for x in range(file_cnt)
+    ]
+
+    pFrom = "\0".join(orig_fnames)
+    pTo = "\0".join(new_fnames)
+
+    shell.SHFileOperation(
+        (
+            0,
+            shellcon.FO_MOVE,
+            pFrom,
+            pTo,
+            shellcon.FOF_MULTIDESTFILES | shellcon.FOF_NOCONFIRMATION,
+        )
+    )
+    for fname in orig_fnames:
+        assert not os.path.isfile(fname)
+
+    for fname in new_fnames:
+        assert os.path.isfile(fname)
+        shell.SHFileOperation(
+            (
+                0,
+                shellcon.FO_DELETE,
+                fname,
+                None,
+                shellcon.FOF_NOCONFIRMATION | shellcon.FOF_NOERRORUI,
+            )
+        )
+
+
+def testSHNAMEMAPPINGS(file_cnt):
+    ## attemps to move a set of files to names that already exist, and generated filenames should be returned
+    ##   as a sequence of 2-tuples created from SHNAMEMAPPINGS handle
+    temp_dir = os.environ["temp"]
+    orig_fnames = [
+        win32api.GetTempFileName(temp_dir, "sfo")[0] for x in range(file_cnt)
+    ]
+    new_fnames = [win32api.GetTempFileName(temp_dir, "sfo")[0] for x in range(file_cnt)]
+    pFrom = "\0".join(orig_fnames)
+    pTo = "\0".join(new_fnames)
+    rc, banyaborted, NameMappings = shell.SHFileOperation(
+        (
+            0,
+            shellcon.FO_MOVE,
+            pFrom,
+            pTo,
+            shellcon.FOF_MULTIDESTFILES
+            | shellcon.FOF_NOCONFIRMATION
+            | shellcon.FOF_RENAMEONCOLLISION
+            | shellcon.FOF_WANTMAPPINGHANDLE,
+        )
+    )
+
+    for old_fname, new_fname in NameMappings:
+        print("Old:", old_fname, "New:", new_fname)
+    assert len(NameMappings) == file_cnt
+
+
+testSHFileOperation(10)
+testSHFileOperation(1)
+testSHNAMEMAPPINGS(5)
diff --git a/lib/win32comext/shell/test/testShellFolder.py b/lib/win32comext/shell/test/testShellFolder.py
new file mode 100644
index 00000000..0517af58
--- /dev/null
+++ b/lib/win32comext/shell/test/testShellFolder.py
@@ -0,0 +1,21 @@
+from win32com.shell import shell
+from win32com.shell.shellcon import *
+
+sf = shell.SHGetDesktopFolder()
+print("Shell Folder is", sf)
+
+names = []
+for i in sf:  # Magically calls EnumObjects
+    name = sf.GetDisplayNameOf(i, SHGDN_NORMAL)
+    names.append(name)
+
+# And get the enumerator manually
+enum = sf.EnumObjects(0, SHCONTF_FOLDERS | SHCONTF_NONFOLDERS | SHCONTF_INCLUDEHIDDEN)
+num = 0
+for i in enum:
+    num += 1
+if num != len(names):
+    print("Should have got the same number of names!?")
+print("Found", len(names), "items on the desktop")
+for name in names:
+    print(name)
diff --git a/lib/win32comext/shell/test/testShellItem.py b/lib/win32comext/shell/test/testShellItem.py
new file mode 100644
index 00000000..592a3647
--- /dev/null
+++ b/lib/win32comext/shell/test/testShellItem.py
@@ -0,0 +1,69 @@
+# Test IShellItem and related interfaces
+import unittest
+
+from win32com.shell import knownfolders, shell, shellcon
+
+
+class TestShellItem(unittest.TestCase):
+    def assertShellItemsEqual(self, i1, i2):
+        n1 = i1.GetDisplayName(shellcon.SHGDN_FORPARSING)
+        n2 = i2.GetDisplayName(shellcon.SHGDN_FORPARSING)
+        self.assertEqual(n1, n2)
+
+    def test_idlist_roundtrip(self):
+        pidl = shell.SHGetSpecialFolderLocation(0, shellcon.CSIDL_DESKTOP)
+        item = shell.SHCreateItemFromIDList(pidl, shell.IID_IShellItem)
+        pidl_back = shell.SHGetIDListFromObject(item)
+        self.assertEqual(pidl, pidl_back)
+
+    def test_parsing_name(self):
+        sf = shell.SHGetDesktopFolder()
+        flags = shellcon.SHCONTF_FOLDERS | shellcon.SHCONTF_NONFOLDERS
+        children = sf.EnumObjects(0, flags)
+        child_pidl = next(children)
+        name = sf.GetDisplayNameOf(child_pidl, shellcon.SHGDN_FORPARSING)
+
+        item = shell.SHCreateItemFromParsingName(name, None, shell.IID_IShellItem)
+        # test the name we get from the item is the same as from the folder.
+        self.assertEqual(name, item.GetDisplayName(shellcon.SHGDN_FORPARSING))
+
+    def test_parsing_relative(self):
+        desktop_pidl = shell.SHGetSpecialFolderLocation(0, shellcon.CSIDL_DESKTOP)
+        desktop_item = shell.SHCreateItemFromIDList(desktop_pidl, shell.IID_IShellItem)
+
+        sf = shell.SHGetDesktopFolder()
+        flags = shellcon.SHCONTF_FOLDERS | shellcon.SHCONTF_NONFOLDERS
+        children = sf.EnumObjects(0, flags)
+        child_pidl = next(children)
+        name_flags = shellcon.SHGDN_FORPARSING | shellcon.SHGDN_INFOLDER
+        name = sf.GetDisplayNameOf(child_pidl, name_flags)
+
+        item = shell.SHCreateItemFromRelativeName(
+            desktop_item, name, None, shell.IID_IShellItem
+        )
+        # test the name we get from the item is the same as from the folder.
+        self.assertEqual(name, item.GetDisplayName(name_flags))
+
+    def test_create_in_known_folder(self):
+        item = shell.SHCreateItemInKnownFolder(
+            knownfolders.FOLDERID_Desktop, 0, None, shell.IID_IShellItem
+        )
+        # this will do for now :)
+
+    def test_create_item_with_parent(self):
+        desktop_pidl = shell.SHGetSpecialFolderLocation(0, shellcon.CSIDL_DESKTOP)
+        desktop_item = shell.SHCreateItemFromIDList(desktop_pidl, shell.IID_IShellItem)
+
+        sf = shell.SHGetDesktopFolder()
+        flags = shellcon.SHCONTF_FOLDERS | shellcon.SHCONTF_NONFOLDERS
+        children = sf.EnumObjects(0, flags)
+        child_pidl = next(children)
+        item1 = shell.SHCreateItemWithParent(
+            desktop_pidl, None, child_pidl, shell.IID_IShellItem
+        )
+        item2 = shell.SHCreateItemWithParent(None, sf, child_pidl, shell.IID_IShellItem)
+        self.assertShellItemsEqual(item1, item2)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/lib/win32comext/taskscheduler/__init__.py b/lib/win32comext/taskscheduler/__init__.py
new file mode 100644
index 00000000..3a893267
--- /dev/null
+++ b/lib/win32comext/taskscheduler/__init__.py
@@ -0,0 +1,6 @@
+# This is a python package
+# __PackageSupportBuildPath__ not needed for distutil based builds,
+# but not everyone is there yet.
+import win32com
+
+win32com.__PackageSupportBuildPath__(__path__)
diff --git a/lib/win32comext/taskscheduler/taskscheduler.pyd b/lib/win32comext/taskscheduler/taskscheduler.pyd
new file mode 100644
index 0000000000000000000000000000000000000000..0896d0119bc04ad09dd12c38e1a01bd11987a36d
GIT binary patch
literal 53248
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

literal 0
HcmV?d00001

diff --git a/lib/win32comext/taskscheduler/test/test_addtask.py b/lib/win32comext/taskscheduler/test/test_addtask.py
new file mode 100644
index 00000000..a7b0959d
--- /dev/null
+++ b/lib/win32comext/taskscheduler/test/test_addtask.py
@@ -0,0 +1,66 @@
+import os
+import sys
+import time
+
+import pythoncom
+import win32api
+from win32com.taskscheduler import taskscheduler
+
+task_name = "test_addtask.job"
+ts = pythoncom.CoCreateInstance(
+    taskscheduler.CLSID_CTaskScheduler,
+    None,
+    pythoncom.CLSCTX_INPROC_SERVER,
+    taskscheduler.IID_ITaskScheduler,
+)
+tasks = ts.Enum()
+for task in tasks:
+    print(task)
+if task_name in tasks:
+    print("Deleting existing task " + task_name)
+    ts.Delete(task_name)
+
+t = ts.NewWorkItem(task_name)
+t.SetComment("rude comments")
+t.SetApplicationName(sys.executable)
+t.SetPriority(taskscheduler.REALTIME_PRIORITY_CLASS)
+t.SetParameters(
+    "-c\"import win32ui,time;win32ui.MessageBox('hey bubba I am running');\""
+)
+t.SetWorkingDirectory(os.path.dirname(sys.executable))
+t.SetCreator("test_addtask.py")
+t.SetMaxRunTime(20000)  # milliseconds
+t.SetFlags(
+    taskscheduler.TASK_FLAG_INTERACTIVE | taskscheduler.TASK_FLAG_RUN_ONLY_IF_LOGGED_ON
+)
+##               |taskscheduler.TASK_FLAG_DELETE_WHEN_DONE)  #task self destructs when no more future run times
+t.SetAccountInformation(win32api.GetUserName(), None)
+## None is only valid for local system acct or if task flags contain TASK_FLAG_RUN_ONLY_IF_LOGGED_ON
+t.SetWorkItemData("some binary garbage")
+
+run_time = time.localtime(time.time() + 60)
+tr_ind, tr = t.CreateTrigger()
+tt = tr.GetTrigger()
+
+## flags default to TASK_TRIGGER_FLAG_DISABLED (4)
+tt.Flags = taskscheduler.TASK_TRIGGER_FLAG_KILL_AT_DURATION_END
+tt.BeginYear = int(time.strftime("%Y", run_time))
+tt.BeginMonth = int(time.strftime("%m", run_time))
+tt.BeginDay = int(time.strftime("%d", run_time))
+tt.StartMinute = int(time.strftime("%M", run_time))
+tt.StartHour = int(time.strftime("%H", run_time))
+tt.MinutesInterval = 1
+tt.MinutesDuration = 5
+
+tt.TriggerType = taskscheduler.TASK_TIME_TRIGGER_MONTHLYDATE
+# months can contain multiples in a bitmask, use 1<<(month_nbr-1)
+tt.MonthlyDate_Months = 1 << (
+    int(time.strftime("%m", run_time)) - 1
+)  ## corresponds to TASK_JANUARY..TASK_DECEMBER constants
+# days too
+tt.MonthlyDate_Days = 1 << (int(time.strftime("%d", run_time)) - 1)
+tr.SetTrigger(tt)
+print(t.GetTriggerString(tr_ind))
+
+pf = t.QueryInterface(pythoncom.IID_IPersistFile)
+pf.Save(None, 1)
diff --git a/lib/win32comext/taskscheduler/test/test_addtask_1.py b/lib/win32comext/taskscheduler/test/test_addtask_1.py
new file mode 100644
index 00000000..29c9e08d
--- /dev/null
+++ b/lib/win32comext/taskscheduler/test/test_addtask_1.py
@@ -0,0 +1,69 @@
+import time
+
+import pythoncom
+import win32api
+from win32com.taskscheduler import taskscheduler
+
+test_task_name = "test_addtask_1.job"
+
+ts = pythoncom.CoCreateInstance(
+    taskscheduler.CLSID_CTaskScheduler,
+    None,
+    pythoncom.CLSCTX_INPROC_SERVER,
+    taskscheduler.IID_ITaskScheduler,
+)
+
+tasks = ts.Enum()
+for task in tasks:
+    print(task)
+if test_task_name in tasks:
+    print("Deleting existing task " + test_task_name)
+    ts.Delete(test_task_name)
+
+new_task = pythoncom.CoCreateInstance(
+    taskscheduler.CLSID_CTask,
+    None,
+    pythoncom.CLSCTX_INPROC_SERVER,
+    taskscheduler.IID_ITask,
+)
+ts.AddWorkItem(test_task_name, new_task)  ## task object is modified in place
+
+new_task.SetFlags(
+    taskscheduler.TASK_FLAG_INTERACTIVE | taskscheduler.TASK_FLAG_RUN_ONLY_IF_LOGGED_ON
+)
+new_task.SetIdleWait(1, 10000)
+new_task.SetComment("test task with idle trigger")
+new_task.SetApplicationName("c:\\python23\\python.exe")
+new_task.SetPriority(taskscheduler.REALTIME_PRIORITY_CLASS)
+new_task.SetParameters(
+    "-c\"import win32ui,time;win32ui.MessageBox('why aint you doing no work ?');\""
+)
+new_task.SetWorkingDirectory("c:\\python23")
+new_task.SetCreator("test_addtask_1.py")
+new_task.SetAccountInformation(win32api.GetUserName(), None)
+## None is only valid for local system acct or if Flags contain TASK_FLAG_RUN_ONLY_IF_LOGGED_ON
+
+
+run_time = time.localtime(time.time() + 30)
+end_time = time.localtime(time.time() + 60 * 60 * 24)
+
+tr_ind, tr = new_task.CreateTrigger()
+tt = tr.GetTrigger()
+tt.TriggerType = taskscheduler.TASK_EVENT_TRIGGER_ON_IDLE
+tt.Flags = taskscheduler.TASK_TRIGGER_FLAG_HAS_END_DATE
+
+tt.BeginYear = int(time.strftime("%Y", run_time))
+tt.BeginMonth = int(time.strftime("%m", run_time))
+tt.BeginDay = int(time.strftime("%d", run_time))
+tt.StartMinute = int(time.strftime("%M", run_time))
+tt.StartHour = int(time.strftime("%H", run_time))
+
+tt.EndYear = int(time.strftime("%Y", end_time))
+tt.EndMonth = int(time.strftime("%m", end_time))
+tt.EndDay = int(time.strftime("%d", end_time))
+
+tr.SetTrigger(tt)
+print(new_task.GetTriggerString(tr_ind))
+
+pf = new_task.QueryInterface(pythoncom.IID_IPersistFile)
+pf.Save(None, 1)
diff --git a/lib/win32comext/taskscheduler/test/test_addtask_2.py b/lib/win32comext/taskscheduler/test/test_addtask_2.py
new file mode 100644
index 00000000..4663bea4
--- /dev/null
+++ b/lib/win32comext/taskscheduler/test/test_addtask_2.py
@@ -0,0 +1,51 @@
+import time
+
+import pythoncom
+import win32api
+from win32com.taskscheduler import taskscheduler
+
+task_name = "test_addtask_2.job"
+ts = pythoncom.CoCreateInstance(
+    taskscheduler.CLSID_CTaskScheduler,
+    None,
+    pythoncom.CLSCTX_INPROC_SERVER,
+    taskscheduler.IID_ITaskScheduler,
+)
+tasks = ts.Enum()
+for task in tasks:
+    print(task)
+if task_name in tasks:
+    print("Deleting existing task " + task_name)
+    ts.Delete(task_name)
+
+t = ts.NewWorkItem(task_name)
+t.SetComment("Test a task running as local system acct")
+t.SetApplicationName("c:\\python23\\python.exe")
+t.SetPriority(taskscheduler.REALTIME_PRIORITY_CLASS)
+t.SetParameters("test_localsystem.py")
+t.SetWorkingDirectory("c:\\python23")
+t.SetCreator("test_addtask_2.py")
+t.SetMaxRunTime(20000)  # milliseconds
+t.SetFlags(taskscheduler.TASK_FLAG_DELETE_WHEN_DONE)
+t.SetAccountInformation(
+    "", None
+)  ## empty string for account name means to use local system
+## None is only valid for local system acct or if task flags contain TASK_FLAG_RUN_ONLY_IF_LOGGED_ON
+
+run_time = time.localtime(time.time() + 60)
+tr_ind, tr = t.CreateTrigger()
+
+tt = tr.GetTrigger()
+tt.Flags = 0  ## flags for a new trigger default to TASK_TRIGGER_FLAG_DISABLED (4), make sure to clear them if not using any
+tt.TriggerType = taskscheduler.TASK_TIME_TRIGGER_ONCE
+tt.BeginYear = int(time.strftime("%Y", run_time))
+tt.BeginMonth = int(time.strftime("%m", run_time))
+tt.BeginDay = int(time.strftime("%d", run_time))
+tt.StartMinute = int(time.strftime("%M", run_time))
+tt.StartHour = int(time.strftime("%H", run_time))
+
+tr.SetTrigger(tt)
+print(t.GetTriggerString(tr_ind))
+
+pf = t.QueryInterface(pythoncom.IID_IPersistFile)
+pf.Save(None, 1)
diff --git a/lib/win32comext/taskscheduler/test/test_localsystem.py b/lib/win32comext/taskscheduler/test/test_localsystem.py
new file mode 100644
index 00000000..9209d3af
--- /dev/null
+++ b/lib/win32comext/taskscheduler/test/test_localsystem.py
@@ -0,0 +1,3 @@
+f = open("test_localsystem.txt", "w")
+f.write("I have run\n")
+f.close()
diff --git a/lib/zc/lockfile/__init__.py b/lib/zc/lockfile/__init__.py
index b541fa2d..f93917b0 100644
--- a/lib/zc/lockfile/__init__.py
+++ b/lib/zc/lockfile/__init__.py
@@ -11,18 +11,18 @@
 # FOR A PARTICULAR PURPOSE
 #
 ##############################################################################
-
-import os
-import errno
 import logging
+import os
+
+
 logger = logging.getLogger("zc.lockfile")
 
-__metaclass__ = type
 
 class LockError(Exception):
     """Couldn't get a lock
     """
 
+
 try:
     import fcntl
 except ImportError:
@@ -31,6 +31,7 @@ except ImportError:
     except ImportError:
         def _lock_file(file):
             raise TypeError('No file-locking support on this platform')
+
         def _unlock_file(file):
             raise TypeError('No file-locking support on this platform')
 
@@ -40,14 +41,14 @@ except ImportError:
             # Lock just the first byte
             try:
                 msvcrt.locking(file.fileno(), msvcrt.LK_NBLCK, 1)
-            except IOError:
+            except OSError:
                 raise LockError("Couldn't lock %r" % file.name)
 
         def _unlock_file(file):
             try:
                 file.seek(0)
                 msvcrt.locking(file.fileno(), msvcrt.LK_UNLCK, 1)
-            except IOError:
+            except OSError:
                 raise LockError("Couldn't unlock %r" % file.name)
 
 else:
@@ -57,14 +58,16 @@ else:
     def _lock_file(file):
         try:
             fcntl.flock(file.fileno(), _flags)
-        except IOError:
+        except OSError:
             raise LockError("Couldn't lock %r" % file.name)
 
     def _unlock_file(file):
         fcntl.flock(file.fileno(), fcntl.LOCK_UN)
 
+
 class LazyHostName:
     """Avoid importing socket and calling gethostname() unnecessarily"""
+
     def __str__(self):
         import socket
         return socket.gethostname()
@@ -79,7 +82,7 @@ class SimpleLockFile:
         try:
             # Try to open for writing without truncation:
             fp = open(path, 'r+')
-        except IOError:
+        except OSError:
             # If the file doesn't exist, we'll get an IO error, try a+
             # Note that there may be a race here. Multiple processes
             # could fail on the r+ open and open the file a+, but only
@@ -89,7 +92,7 @@ class SimpleLockFile:
         try:
             _lock_file(fp)
             self._fp = fp
-        except:
+        except BaseException:
             fp.close()
             raise
 
@@ -114,7 +117,7 @@ class LockFile(SimpleLockFile):
 
     def __init__(self, path, content_template='{pid}'):
         self._content_template = content_template
-        super(LockFile, self).__init__(path)
+        super().__init__(path)
 
     def _on_lock(self):
         content = self._content_template.format(
diff --git a/lib/zc/lockfile/tests.py b/lib/zc/lockfile/tests.py
index 4c890539..ae9ffca5 100644
--- a/lib/zc/lockfile/tests.py
+++ b/lib/zc/lockfile/tests.py
@@ -11,23 +11,22 @@
 # FOR A PARTICULAR PURPOSE.
 #
 ##############################################################################
-import os, re, sys, unittest, doctest
-import zc.lockfile, time, threading
-from zope.testing import renormalizing, setupstack
+import doctest
+import os
 import tempfile
-try:
-    from unittest.mock import Mock, patch
-except ImportError:
-    from mock import Mock, patch
+import threading
+import time
+import unittest
+from unittest.mock import Mock
+from unittest.mock import patch
+
+from zope.testing import setupstack
+
+import zc.lockfile
 
-checker = renormalizing.RENormalizing([
-    # Python 3 adds module path to error class name.
-    (re.compile("zc\.lockfile\.LockError:"),
-     r"LockError:"),
-    ])
 
 def inc():
-    while 1:
+    while True:
         try:
             lock = zc.lockfile.LockFile('f.lock')
         except zc.lockfile.LockError:
@@ -43,6 +42,7 @@ def inc():
     f.close()
     lock.close()
 
+
 def many_threads_read_and_write():
     r"""
     >>> with open('f', 'w+b') as file:
@@ -72,6 +72,7 @@ def many_threads_read_and_write():
 
     """
 
+
 def pid_in_lockfile():
     r"""
     >>> import os, zc.lockfile
@@ -88,7 +89,7 @@ def pid_in_lockfile():
     >>> lock = zc.lockfile.LockFile("f.lock")
     Traceback (most recent call last):
       ...
-    LockError: Couldn't lock 'f.lock'
+    zc.lockfile.LockError: Couldn't lock 'f.lock'
 
     >>> f = open("f.lock")
     >>> _ = f.seek(1)
@@ -107,7 +108,8 @@ def hostname_in_lockfile():
 
     >>> import zc.lockfile
     >>> with patch('socket.gethostname', Mock(return_value='myhostname')):
-    ...     lock = zc.lockfile.LockFile("f.lock", content_template='{hostname}')
+    ...     lock = zc.lockfile.LockFile(
+    ...         "f.lock", content_template='{hostname}')
     >>> f = open("f.lock")
     >>> _ = f.seek(1)
     >>> f.read().rstrip()
@@ -119,7 +121,7 @@ def hostname_in_lockfile():
     >>> lock = zc.lockfile.LockFile("f.lock", content_template='{hostname}')
     Traceback (most recent call last):
       ...
-    LockError: Couldn't lock 'f.lock'
+    zc.lockfile.LockError: Couldn't lock 'f.lock'
 
     >>> f = open("f.lock")
     >>> _ = f.seek(1)
@@ -131,7 +133,7 @@ def hostname_in_lockfile():
     """
 
 
-class TestLogger(object):
+class TestLogger:
     def __init__(self):
         self.log_entries = []
 
@@ -141,6 +143,7 @@ class TestLogger(object):
 
 class LockFileLogEntryTestCase(unittest.TestCase):
     """Tests for logging in case of lock failure"""
+
     def setUp(self):
         self.here = os.getcwd()
         self.tmp = tempfile.mkdtemp(prefix='zc.lockfile-test-')
@@ -154,8 +157,8 @@ class LockFileLogEntryTestCase(unittest.TestCase):
         # PID and hostname are parsed and logged from lock file on failure
         with patch('os.getpid', Mock(return_value=123)):
             with patch('socket.gethostname', Mock(return_value='myhostname')):
-                lock = zc.lockfile.LockFile('f.lock',
-                                            content_template='{pid}/{hostname}')
+                lock = zc.lockfile.LockFile(
+                    'f.lock', content_template='{pid}/{hostname}')
                 with open('f.lock') as f:
                     self.assertEqual(' 123/myhostname\n', f.read())
 
@@ -191,11 +194,10 @@ class LockFileLogEntryTestCase(unittest.TestCase):
 def test_suite():
     suite = unittest.TestSuite()
     suite.addTest(doctest.DocFileSuite(
-        'README.txt', checker=checker,
+        'README.txt',
         setUp=setupstack.setUpDirectory, tearDown=setupstack.tearDown))
     suite.addTest(doctest.DocTestSuite(
-        setUp=setupstack.setUpDirectory, tearDown=setupstack.tearDown,
-        checker=checker))
+        setUp=setupstack.setUpDirectory, tearDown=setupstack.tearDown))
     # Add unittest test cases from this module
     suite.addTest(unittest.defaultTestLoader.loadTestsFromName(__name__))
     return suite
diff --git a/requirements.txt b/requirements.txt
index 64458e26..21a7ee6f 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -7,7 +7,7 @@ beautifulsoup4==4.12.2
 bleach==6.1.0
 certifi==2024.2.2
 cheroot==10.0.0
-cherrypy==18.8.0
+cherrypy==18.9.0
 cloudinary==1.34.0
 distro==1.9.0
 dnspython==2.6.1

From a0170a6f3d2c9dc8d48deac38c2d5badf105d336 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sun, 24 Mar 2024 15:26:22 -0700
Subject: [PATCH 540/743] Bump beautifulsoup4 from 4.12.2 to 4.12.3 (#2267)

* Bump beautifulsoup4 from 4.12.2 to 4.12.3

Bumps [beautifulsoup4](https://www.crummy.com/software/BeautifulSoup/bs4/) from 4.12.2 to 4.12.3.

---
updated-dependencies:
- dependency-name: beautifulsoup4
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

* Update beautifulsoup4==4.12.3

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/bs4/__init__.py                           |   4 +-
 lib/bs4/builder/__init__.py                   |  13 +-
 lib/bs4/builder/_html5lib.py                  |   4 +-
 lib/bs4/builder/_htmlparser.py                |   2 +-
 lib/bs4/builder/_lxml.py                      |   4 +-
 lib/bs4/element.py                            |   7 +-
 lib/bs4/formatter.py                          |   4 +-
 lib/bs4/tests/__init__.py                     |   2 +-
 ...mized-bs4_fuzzer-4670634698080256.testcase |   1 +
 ...mized-bs4_fuzzer-5000587759190016.testcase | Bin 0 -> 15347 bytes
 ...mized-bs4_fuzzer-5270998950477824.testcase | Bin 0 -> 12 bytes
 ...mized-bs4_fuzzer-5375146639360000.testcase |   1 +
 ...mized-bs4_fuzzer-5492400320282624.testcase | Bin 0 -> 11502 bytes
 ...mized-bs4_fuzzer-6306874195312640.testcase |   1 +
 ...a2b26f13537b68d3794b0478a4090ee4a.testcase | Bin 0 -> 103 bytes
 lib/bs4/tests/test_fuzz.py                    |  95 ++++++++++-
 lib/bs4/tests/test_tag.py                     |  13 ++
 lib/soupsieve/__init__.py                     |  25 ++-
 lib/soupsieve/__meta__.py                     |  18 +-
 lib/soupsieve/css_match.py                    |  26 +--
 lib/soupsieve/css_parser.py                   | 156 ++++++++----------
 lib/soupsieve/css_types.py                    |  45 +++--
 lib/soupsieve/pretty.py                       |   9 +-
 lib/soupsieve/util.py                         |   4 +-
 requirements.txt                              |   2 +-
 25 files changed, 263 insertions(+), 173 deletions(-)
 create mode 100644 lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-4670634698080256.testcase
 create mode 100644 lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-5000587759190016.testcase
 create mode 100644 lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-5270998950477824.testcase
 create mode 100644 lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-5375146639360000.testcase
 create mode 100644 lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-5492400320282624.testcase
 create mode 100644 lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-6306874195312640.testcase
 create mode 100644 lib/bs4/tests/fuzz/crash-ffbdfa8a2b26f13537b68d3794b0478a4090ee4a.testcase

diff --git a/lib/bs4/__init__.py b/lib/bs4/__init__.py
index 3d2ab09a..d8ad5e1d 100644
--- a/lib/bs4/__init__.py
+++ b/lib/bs4/__init__.py
@@ -15,8 +15,8 @@ documentation: http://www.crummy.com/software/BeautifulSoup/bs4/doc/
 """
 
 __author__ = "Leonard Richardson (leonardr@segfault.org)"
-__version__ = "4.12.2"
-__copyright__ = "Copyright (c) 2004-2023 Leonard Richardson"
+__version__ = "4.12.3"
+__copyright__ = "Copyright (c) 2004-2024 Leonard Richardson"
 # Use of this source code is governed by the MIT license.
 __license__ = "MIT"
 
diff --git a/lib/bs4/builder/__init__.py b/lib/bs4/builder/__init__.py
index 2e397458..ffb31fc2 100644
--- a/lib/bs4/builder/__init__.py
+++ b/lib/bs4/builder/__init__.py
@@ -514,15 +514,19 @@ class DetectsXMLParsedAsHTML(object):
     XML_PREFIX_B = b'<?xml'
     
     @classmethod
-    def warn_if_markup_looks_like_xml(cls, markup):
+    def warn_if_markup_looks_like_xml(cls, markup, stacklevel=3):
         """Perform a check on some markup to see if it looks like XML
         that's not XHTML. If so, issue a warning.
 
         This is much less reliable than doing the check while parsing,
         but some of the tree builders can't do that.
 
+        :param stacklevel: The stacklevel of the code calling this
+        function.
+
         :return: True if the markup looks like non-XHTML XML, False
         otherwise.
+
         """
         if isinstance(markup, bytes):
             prefix = cls.XML_PREFIX_B
@@ -535,15 +539,16 @@ class DetectsXMLParsedAsHTML(object):
             and markup.startswith(prefix)
             and not looks_like_html.search(markup[:500])
         ):
-            cls._warn()
+            cls._warn(stacklevel=stacklevel+2)
             return True
         return False
 
     @classmethod
-    def _warn(cls):
+    def _warn(cls, stacklevel=5):
         """Issue a warning about XML being parsed as HTML."""
         warnings.warn(
-            XMLParsedAsHTMLWarning.MESSAGE, XMLParsedAsHTMLWarning
+            XMLParsedAsHTMLWarning.MESSAGE, XMLParsedAsHTMLWarning,
+            stacklevel=stacklevel
         )
         
     def _initialize_xml_detector(self):
diff --git a/lib/bs4/builder/_html5lib.py b/lib/bs4/builder/_html5lib.py
index dac21732..7c46a851 100644
--- a/lib/bs4/builder/_html5lib.py
+++ b/lib/bs4/builder/_html5lib.py
@@ -77,7 +77,9 @@ class HTML5TreeBuilder(HTMLTreeBuilder):
 
         # html5lib only parses HTML, so if it's given XML that's worth
         # noting.
-        DetectsXMLParsedAsHTML.warn_if_markup_looks_like_xml(markup)
+        DetectsXMLParsedAsHTML.warn_if_markup_looks_like_xml(
+            markup, stacklevel=3
+        )
 
         yield (markup, None, None, False)
 
diff --git a/lib/bs4/builder/_htmlparser.py b/lib/bs4/builder/_htmlparser.py
index e065096b..3cc187f8 100644
--- a/lib/bs4/builder/_htmlparser.py
+++ b/lib/bs4/builder/_htmlparser.py
@@ -378,10 +378,10 @@ class HTMLParserTreeBuilder(HTMLTreeBuilder):
         parser.soup = self.soup
         try:
             parser.feed(markup)
+            parser.close()
         except AssertionError as e:
             # html.parser raises AssertionError in rare cases to
             # indicate a fatal problem with the markup, especially
             # when there's an error in the doctype declaration.
             raise ParserRejectedMarkup(e)
-        parser.close()
         parser.already_closed_empty_element = []
diff --git a/lib/bs4/builder/_lxml.py b/lib/bs4/builder/_lxml.py
index 971c81e5..4f7cf746 100644
--- a/lib/bs4/builder/_lxml.py
+++ b/lib/bs4/builder/_lxml.py
@@ -179,7 +179,9 @@ class LXMLTreeBuilderForXML(TreeBuilder):
             self.processing_instruction_class = ProcessingInstruction
             # We're in HTML mode, so if we're given XML, that's worth
             # noting.
-            DetectsXMLParsedAsHTML.warn_if_markup_looks_like_xml(markup)
+            DetectsXMLParsedAsHTML.warn_if_markup_looks_like_xml(
+                markup, stacklevel=3
+            )
         else:
             self.processing_instruction_class = XMLProcessingInstruction
 
diff --git a/lib/bs4/element.py b/lib/bs4/element.py
index 9c73957c..0aefe734 100644
--- a/lib/bs4/element.py
+++ b/lib/bs4/element.py
@@ -1356,7 +1356,7 @@ class Tag(PageElement):
         This is the first step in the deepcopy process.
         """
         clone = type(self)(
-            None, self.builder, self.name, self.namespace,
+            None, None, self.name, self.namespace,
             self.prefix, self.attrs, is_xml=self._is_xml,
             sourceline=self.sourceline, sourcepos=self.sourcepos,
             can_be_empty_element=self.can_be_empty_element,
@@ -1845,6 +1845,11 @@ class Tag(PageElement):
         return space_before + s + space_after
 
     def _format_tag(self, eventual_encoding, formatter, opening):
+        if self.hidden:
+            # A hidden tag is invisible, although its contents
+            # are visible.
+            return ''
+
         # A tag starts with the < character (see below).
 
         # Then the / character, if this is a closing tag.
diff --git a/lib/bs4/formatter.py b/lib/bs4/formatter.py
index c821318d..9fa1b57c 100644
--- a/lib/bs4/formatter.py
+++ b/lib/bs4/formatter.py
@@ -51,7 +51,7 @@ class Formatter(EntitySubstitution):
             void_element_close_prefix='/', cdata_containing_tags=None,
             empty_attributes_are_booleans=False, indent=1,
     ):
-        """Constructor.
+        r"""Constructor.
 
         :param language: This should be Formatter.XML if you are formatting
            XML markup and Formatter.HTML if you are formatting HTML markup.
@@ -76,7 +76,7 @@ class Formatter(EntitySubstitution):
             negative, or "" will only insert newlines. Using a
             positive integer indent indents that many spaces per
             level. If indent is a string (such as "\t"), that string
-            is used to indent each level. The default behavior to
+            is used to indent each level. The default behavior is to
             indent one space per level.
         """
         self.language = language
diff --git a/lib/bs4/tests/__init__.py b/lib/bs4/tests/__init__.py
index dbb1593e..325affef 100644
--- a/lib/bs4/tests/__init__.py
+++ b/lib/bs4/tests/__init__.py
@@ -1105,7 +1105,7 @@ class XMLTreeBuilderSmokeTest(TreeBuilderSmokeTest):
         doc = """<?xml version="1.0" encoding="utf-8"?>
 <Document xmlns="http://example.com/ns0"
     xmlns:ns1="http://example.com/ns1"
-    xmlns:ns2="http://example.com/ns2"
+    xmlns:ns2="http://example.com/ns2">
     <ns1:tag>foo</ns1:tag>
     <ns1:tag>bar</ns1:tag>
     <ns2:tag key="value">baz</ns2:tag>
diff --git a/lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-4670634698080256.testcase b/lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-4670634698080256.testcase
new file mode 100644
index 00000000..4828f8a4
--- /dev/null
+++ b/lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-4670634698080256.testcase
@@ -0,0 +1 @@
+ ��      � <css
\ No newline at end of file
diff --git a/lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-5000587759190016.testcase b/lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-5000587759190016.testcase
new file mode 100644
index 0000000000000000000000000000000000000000..8a585ce9270e58b125922297f2d099298adac822
GIT binary patch
literal 15347
zcmeHOKW`H;6u+P#aRU+(18Xxd6l%E*Nl7L5s!A+KhygMnL5ETmLX<?PJyte0CL%rt
z-=T;FF(ENB@(ma&AtcP%XW#k$IriN-Z5rQDRTtmAzkcucp5K8Leqs6#I&Q)f4-I_O
zIvDI99UuDJZ~Pa?_l#cXYCv&3a@U3~o<MgULdR*i7*2k=T}T-UnIcQvU=5t``{84f
zd+p$Pvc40(C$YXK+yl`&?!oUK2>BVgZv$er@K!|sD^YeJSDOAWa&ttPlG6X?Atl{}
z^qDpjS}5Y|WIWoTq(csczd4*??66BhVoGhy6y1ZDBgWIhQ~nf$4?LB=<Nb%}>5tQo
zxX3XIMJ!OhCjE@@G@nnHL!!ULItAw?J4Na|Tz{fnYNoHpCUhroxQ^Xm|6~3AZ`jNU
z_1CN>Z8L2Ov5UvVto$ukPyf~8Z<hX~6#b3d_z%!{-yeAB1`9NMyM1qO&l7UOogAGQ
zl^=NtpQuazviVP&{%GvGqoG@0m>|ZG_z+Cw)}rtPVgJ$Y!^aQq_qB2x+d@%#VL&Ee
zscL#D6CO7NUrf^%e&SnKww(HyG#lR3!%5nHqKHLiq!Uq%XT(ATAI~R!c+#u~ktD)W
z#Z-lH42O%htTt3XpZZq_8E}9wb>zG-$Bf4}bwbGBM0e%#VflQ3>E%3$>n4SKSi0u<
zER%m$TsEp5i<T@}qHPTUEhcv7Ebk;C(4r;nDn&K*$l#AfOJ$o^7d%^Aw8TSNy1<xS
zG0dr8SS+*@!#|GTOrj-jJWfkHA62Nz@@R$kR3mm;GhIx2cS`krqFAWZ@Xr$?%~;qI
z)@Lkjo?OMOmU0=rxa{CdLrf1mK$<6$@>fAh3ZBVWkB$KNF37662`3#lv#vffpN$8m
zN~NsW&nsp9m$XI|Y?vkxR-@e#J2vfv={I9yD{8L>?bJ5jl{m^X>DgR>Pz4nzY55>9
zaJF$P4nM{r0N0v8sLEMw1+^QiLKN+(xQwxB!0bXrBv?Z{w${rqtoY4t<kH9HrRXnT
zlO}m&(S@HfY0e&L#UYME1nK^>O&Vk2ajs38ITfhY1|%rRV$pMf6PhuP>A~gb(by@6
zIYN?5j_g2E=LC?WXmn7m$gyJwVL_x)6E>WMna*0~7+ng6=am8TKe^U~eF_~XCRZkW
z#PW{M(|AZY!jT)*wowa!XyA7C+-+hS<O0pzCgh6E7!NxvFeZ~0IT>%aO@_kcpK7$)
zCWCD<@Kz>oC}@WX+hj0SGTJ5s9fT9I*)juIwVk>gO$LI&wIfvqDdYl5f{7)#xCTIF
z2SI2-qp#%56T}6sGt3_+us`Vd;ONzB-y@~Ll>LlA@XZVW@(&<po)i<m6QeRGDnY2v
z9OvIPm9G~S{BAYR@Bf;dq<)&MJwy4!@-P^w7NWDeR<#Pb!q4#9a1xy1MF!`$SwDuh
vw*VOhZ}-}FH@CJr!dFs#+J9^A-1d;;d}$CT0HEce@u9!JB7DdTdLH@@>R0YF

literal 0
HcmV?d00001

diff --git a/lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-5270998950477824.testcase b/lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-5270998950477824.testcase
new file mode 100644
index 0000000000000000000000000000000000000000..fd411427d765e9b17e1e6a015485a70632bb9554
GIT binary patch
literal 12
TcmY$eDbjbbRX@cb^ZOhC75W5K

literal 0
HcmV?d00001

diff --git a/lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-5375146639360000.testcase b/lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-5375146639360000.testcase
new file mode 100644
index 00000000..6248b2c5
--- /dev/null
+++ b/lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-5375146639360000.testcase
@@ -0,0 +1 @@
+�                 ><applet></applet><applet></applet><apple|><applet><applet><appl��><applet><applet></applet></applet></applet></applet><applet></applet><apple>t<applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet>et><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><azplet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><plet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet><applet></applet></applet></applet></applet></appt></applet></applet></applet></applet></applet></applet></applet></applet></applet></applet></applet></applet></applet></applet></applet></applet></applet></applet><<meta charset=utf-8>
\ No newline at end of file
diff --git a/lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-5492400320282624.testcase b/lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-5492400320282624.testcase
new file mode 100644
index 0000000000000000000000000000000000000000..107da539fc15bd1664e35287ace9feda21cb5820
GIT binary patch
literal 11502
zcmeHNy>HV%6gOf+VqhSEDxuawNKi#?;xtXg#SCTdK!q3y#cd3AnkG&P3ldWY7XAYy
zCT0f2N_Q3{#Kh8pfq{iTAiQ_)?sEPrNt;$FI=4Ds&hO(s-o1P8XBP^E%c~a(bbUIR
z>pt6&8VYYetR1|1@3DT}-suHUu57m=zZDhNUbKCCoqp6en~h@8f`8Us?*#40@z@;v
zvWixx>qm8ug?`kSZAMZ199wmM)@|Fljl~QWU$J;93#i=Gnw~*BlHQ#|0?zbH*5<R>
zb%|;A>ykT1x$T5V0o|~j6!-jKFyP&Q0fx?{e_SD_qO!^BSE=P1b3*t-8C14p{iSNc
z2V3ItzI+T%ukbpRx(HH0EkaF-OQ}&>bS_;QQIeM5QcmbNA;V7VgCSi+Ka`)}b4~+u
zIOf`Y|F-|bcGS`*xVc><+HeK=DuR7kbb;M|VG*n$UVC7lv5TH2TY-e=Ct3={xQ+R4
zwyZppvo(W_ZxdtZ*><ik>Zz`2*oa8?n9GW;CglX<eyGQ0PVKU2(q=ZcJE6ydZqRz-
zKi4X+#RR9H9Nw~eZzUm#=pSmbb0pkiQRDH}dCLk~?Y(F=g0shC-To$UihEbyu@QcJ
z#JeJqRPwH<1s8ZVPMalAk^s*r@<vyj);Zhp`+QVdq15-i0J`}H#w9$_0fSZPKDa>x
z<}63=pqMsNj5^<?yO*3bMLgPcgJ%_kAx2&0v1cD7OW~vSh8Qvi$-9+R2>H-eT8Y@E
zP=-sP&U&-KBcEQhQFN;n4^K@xO-DQbCK=e7a4zp`HQ}5I=Oz-?nQ%^KGA3<_C5<L+
z$<OrkJbRks+d)PQtd4uVGR*-lhFnt?-I}yVH=eB2=)}{WDYS}sHe+%g%tRn<<(X>=
zlRW%*ktfj|g`Fl))G`RHqfkU^=K$nAEVm4Oss1xm@?`cmF%gp;&h|LjDKbyFFvm(o
zWHM`)cSw5|y>6c;zMKmSo<Xv}tt^ylWw%;gE-x&*wMx~6e|M=;U0ABPrKM`ETq;!-
zs|q&|GI1m5xKX+e3WSm&=)i)-gdow2A&KlWW~Xn2RIR&6_((BPUW{|F3kBYB0$c4K
zKpqxA9?$^}q-)vbq@~&=-6le32<gfQ&p^gQ<1p~z_^70T7jak1-7W9RyBx`P>Rv`l
zPeWS<Ud);&^2X`_$#&hb1<O9avSg>%fLuIZqeLOxJve;>FPgW-2pF5U#T0&+x5X53
zjQLv8ye*brDwwY#Fm>Y}L;QzdMc~-Z@auB}FN(+qLgC{?R>|o0jGKi4oeBP!uvKWO
zmx{C@5I3Jxz--`-k(ePz3Jtudax^kV11};Vc?{4p4le@a3||N1H!?MkT}(oo#aihv
D9d3o5

literal 0
HcmV?d00001

diff --git a/lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-6306874195312640.testcase b/lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-6306874195312640.testcase
new file mode 100644
index 00000000..b60a250c
--- /dev/null
+++ b/lib/bs4/tests/fuzz/clusterfuzz-testcase-minimized-bs4_fuzzer-6306874195312640.testcase
@@ -0,0 +1 @@
+-      ��  <math><select><mi><select><select>t
\ No newline at end of file
diff --git a/lib/bs4/tests/fuzz/crash-ffbdfa8a2b26f13537b68d3794b0478a4090ee4a.testcase b/lib/bs4/tests/fuzz/crash-ffbdfa8a2b26f13537b68d3794b0478a4090ee4a.testcase
new file mode 100644
index 0000000000000000000000000000000000000000..885711554056588a381fd9a251d48ce76a916a59
GIT binary patch
literal 103
zcma!IT*$!C&%p3|?)u|48N3V(Hi{|v$wno$1*wb-3(;hvkz^S9^*|aEj@#ts@G|Jx
OROIF`00A~ppfmtd#~j4~

literal 0
HcmV?d00001

diff --git a/lib/bs4/tests/test_fuzz.py b/lib/bs4/tests/test_fuzz.py
index f778539a..f29802d4 100644
--- a/lib/bs4/tests/test_fuzz.py
+++ b/lib/bs4/tests/test_fuzz.py
@@ -14,30 +14,75 @@ from bs4 import (
     BeautifulSoup,
     ParserRejectedMarkup,
 )
+try:
+    from soupsieve.util import SelectorSyntaxError
+    import lxml
+    import html5lib
+    fully_fuzzable = True
+except ImportError:
+    fully_fuzzable = False
+    
 
+@pytest.mark.skipif(not fully_fuzzable, reason="Prerequisites for fuzz tests are not installed.")
 class TestFuzz(object):
 
     # Test case markup files from fuzzers are given this extension so
     # they can be included in builds.
     TESTCASE_SUFFIX = ".testcase"
 
+    # Copied 20230512 from
+    # https://github.com/google/oss-fuzz/blob/4ac6a645a197a695fe76532251feb5067076b3f3/projects/bs4/bs4_fuzzer.py
+    #
+    # Copying the code lets us precisely duplicate the behavior of
+    # oss-fuzz.  The downside is that this code changes over time, so
+    # multiple copies of the code must be kept around to run against
+    # older tests. I'm not sure what to do about this, but I may
+    # retire old tests after a time.
+    def fuzz_test_with_css(self, filename):
+        data = self.__markup(filename)
+        parsers = ['lxml-xml', 'html5lib', 'html.parser', 'lxml']
+        try:
+            idx = int(data[0]) % len(parsers)
+        except ValueError:
+            return
+
+        css_selector, data = data[1:10], data[10:]
+
+        try:
+            soup = BeautifulSoup(data[1:], features=parsers[idx])
+        except ParserRejectedMarkup:
+            return
+        except ValueError:
+            return
+
+        list(soup.find_all(True))
+        try:
+            soup.css.select(css_selector.decode('utf-8', 'replace'))
+        except SelectorSyntaxError:
+            return
+        soup.prettify()
+    
     # This class of error has been fixed by catching a less helpful
     # exception from html.parser and raising ParserRejectedMarkup
     # instead.
     @pytest.mark.parametrize(
         "filename", [
             "clusterfuzz-testcase-minimized-bs4_fuzzer-5703933063462912",
+            "crash-ffbdfa8a2b26f13537b68d3794b0478a4090ee4a",
         ]
     )
     def test_rejected_markup(self, filename):
         markup = self.__markup(filename)
         with pytest.raises(ParserRejectedMarkup):
             BeautifulSoup(markup, 'html.parser')
-
+            
     # This class of error has to do with very deeply nested documents
     # which overflow the Python call stack when the tree is converted
     # to a string. This is an issue with Beautiful Soup which was fixed
     # as part of [bug=1471755].
+    #
+    # These test cases are in the older format that doesn't specify
+    # which parser to use or give a CSS selector.
     @pytest.mark.parametrize(
         "filename", [
             "clusterfuzz-testcase-minimized-bs4_fuzzer-5984173902397440",
@@ -46,18 +91,44 @@ class TestFuzz(object):
             "clusterfuzz-testcase-minimized-bs4_fuzzer-6450958476902400",
         ]
     )
-    def test_deeply_nested_document(self, filename):
+    def test_deeply_nested_document_without_css(self, filename):
         # Parsing the document and encoding it back to a string is
         # sufficient to demonstrate that the overflow problem has
         # been fixed.
         markup = self.__markup(filename)
         BeautifulSoup(markup, 'html.parser').encode()
 
+    # This class of error has to do with very deeply nested documents
+    # which overflow the Python call stack when the tree is converted
+    # to a string. This is an issue with Beautiful Soup which was fixed
+    # as part of [bug=1471755].
+    @pytest.mark.parametrize(
+        "filename", [
+            "clusterfuzz-testcase-minimized-bs4_fuzzer-5000587759190016",
+            "clusterfuzz-testcase-minimized-bs4_fuzzer-5375146639360000",
+            "clusterfuzz-testcase-minimized-bs4_fuzzer-5492400320282624",
+        ]
+    )
+    def test_deeply_nested_document(self, filename): 
+       self.fuzz_test_with_css(filename)
+        
+    @pytest.mark.parametrize(
+        "filename", [
+            "clusterfuzz-testcase-minimized-bs4_fuzzer-4670634698080256",
+            "clusterfuzz-testcase-minimized-bs4_fuzzer-5270998950477824",
+        ]
+    )
+    def test_soupsieve_errors(self, filename):
+        self.fuzz_test_with_css(filename)
+        
     # This class of error represents problems with html5lib's parser,
     # not Beautiful Soup. I use
     # https://github.com/html5lib/html5lib-python/issues/568 to notify
     # the html5lib developers of these issues.
-    @pytest.mark.skip("html5lib problems")
+    #
+    # These test cases are in the older format that doesn't specify
+    # which parser to use or give a CSS selector.
+    @pytest.mark.skip(reason="html5lib-specific problems")
     @pytest.mark.parametrize(
         "filename", [
             # b"""ÿ<!DOCTyPEV PUBLIC'''Ð'"""
@@ -68,7 +139,7 @@ class TestFuzz(object):
 
             # b'-<math><sElect><mi><sElect><sElect>'
             "clusterfuzz-testcase-minimized-bs4_fuzzer-5843991618256896",
-
+           
             # b'ñ<table><svg><html>'
             "clusterfuzz-testcase-minimized-bs4_fuzzer-6241471367348224",
 
@@ -79,10 +150,24 @@ class TestFuzz(object):
             "crash-0d306a50c8ed8bcd0785b67000fcd5dea1d33f08"
         ]
     )
-    def test_html5lib_parse_errors(self, filename):
+    def test_html5lib_parse_errors_without_css(self, filename):
         markup = self.__markup(filename)
         print(BeautifulSoup(markup, 'html5lib').encode())
 
+    # This class of error represents problems with html5lib's parser,
+    # not Beautiful Soup. I use
+    # https://github.com/html5lib/html5lib-python/issues/568 to notify
+    # the html5lib developers of these issues.
+    @pytest.mark.skip(reason="html5lib-specific problems")
+    @pytest.mark.parametrize(
+        "filename", [
+            # b'-      \xff\xff  <math>\x10<select><mi><select><select>t'
+            "clusterfuzz-testcase-minimized-bs4_fuzzer-6306874195312640",
+        ]
+    )
+    def test_html5lib_parse_errors(self, filename):
+        self.fuzz_test_with_css(filename)
+        
     def __markup(self, filename):
         if not filename.endswith(self.TESTCASE_SUFFIX):
             filename += self.TESTCASE_SUFFIX
diff --git a/lib/bs4/tests/test_tag.py b/lib/bs4/tests/test_tag.py
index 88cc202d..c48f3345 100644
--- a/lib/bs4/tests/test_tag.py
+++ b/lib/bs4/tests/test_tag.py
@@ -219,3 +219,16 @@ class TestMultiValuedAttributes(SoupTest):
         )
         assert soup.a['class'] == 'foo'
         assert soup.a['id'] == ['bar']
+
+    def test_hidden_tag_is_invisible(self):
+        # Setting .hidden on a tag makes it invisible in output, but
+        # leaves its contents visible.
+        #
+        # This is not a documented or supported feature of Beautiful
+        # Soup (e.g. NavigableString doesn't support .hidden even
+        # though it could), but some people use it and it's not
+        # hurting anything to verify that it keeps working.
+        #
+        soup = self.soup('<div id="1"><span id="2">a string</span></div>')
+        soup.span.hidden = True
+        assert '<div id="1">a string</div>' == str(soup.div)
diff --git a/lib/soupsieve/__init__.py b/lib/soupsieve/__init__.py
index 06403633..8173fd40 100644
--- a/lib/soupsieve/__init__.py
+++ b/lib/soupsieve/__init__.py
@@ -78,13 +78,13 @@ def purge() -> None:
 
 def closest(
     select: str,
-    tag: 'bs4.Tag',
+    tag: bs4.Tag,
     namespaces: dict[str, str] | None = None,
     flags: int = 0,
     *,
     custom: dict[str, str] | None = None,
     **kwargs: Any
-) -> 'bs4.Tag':
+) -> bs4.Tag:
     """Match closest ancestor."""
 
     return compile(select, namespaces, flags, **kwargs).closest(tag)
@@ -92,7 +92,7 @@ def closest(
 
 def match(
     select: str,
-    tag: 'bs4.Tag',
+    tag: bs4.Tag,
     namespaces: dict[str, str] | None = None,
     flags: int = 0,
     *,
@@ -106,13 +106,13 @@ def match(
 
 def filter(  # noqa: A001
     select: str,
-    iterable: Iterable['bs4.Tag'],
+    iterable: Iterable[bs4.Tag],
     namespaces: dict[str, str] | None = None,
     flags: int = 0,
     *,
     custom: dict[str, str] | None = None,
     **kwargs: Any
-) -> list['bs4.Tag']:
+) -> list[bs4.Tag]:
     """Filter list of nodes."""
 
     return compile(select, namespaces, flags, **kwargs).filter(iterable)
@@ -120,13 +120,13 @@ def filter(  # noqa: A001
 
 def select_one(
     select: str,
-    tag: 'bs4.Tag',
+    tag: bs4.Tag,
     namespaces: dict[str, str] | None = None,
     flags: int = 0,
     *,
     custom: dict[str, str] | None = None,
     **kwargs: Any
-) -> 'bs4.Tag':
+) -> bs4.Tag:
     """Select a single tag."""
 
     return compile(select, namespaces, flags, **kwargs).select_one(tag)
@@ -134,14 +134,14 @@ def select_one(
 
 def select(
     select: str,
-    tag: 'bs4.Tag',
+    tag: bs4.Tag,
     namespaces: dict[str, str] | None = None,
     limit: int = 0,
     flags: int = 0,
     *,
     custom: dict[str, str] | None = None,
     **kwargs: Any
-) -> list['bs4.Tag']:
+) -> list[bs4.Tag]:
     """Select the specified tags."""
 
     return compile(select, namespaces, flags, **kwargs).select(tag, limit)
@@ -149,18 +149,17 @@ def select(
 
 def iselect(
     select: str,
-    tag: 'bs4.Tag',
+    tag: bs4.Tag,
     namespaces: dict[str, str] | None = None,
     limit: int = 0,
     flags: int = 0,
     *,
     custom: dict[str, str] | None = None,
     **kwargs: Any
-) -> Iterator['bs4.Tag']:
+) -> Iterator[bs4.Tag]:
     """Iterate the specified tags."""
 
-    for el in compile(select, namespaces, flags, **kwargs).iselect(tag, limit):
-        yield el
+    yield from compile(select, namespaces, flags, **kwargs).iselect(tag, limit)
 
 
 def escape(ident: str) -> str:
diff --git a/lib/soupsieve/__meta__.py b/lib/soupsieve/__meta__.py
index 6f35e152..4dcec73f 100644
--- a/lib/soupsieve/__meta__.py
+++ b/lib/soupsieve/__meta__.py
@@ -93,7 +93,7 @@ class Version(namedtuple("Version", ["major", "minor", "micro", "release", "pre"
                 raise ValueError("All version parts except 'release' should be integers.")
 
         if release not in REL_MAP:
-            raise ValueError("'{}' is not a valid release type.".format(release))
+            raise ValueError(f"'{release}' is not a valid release type.")
 
         # Ensure valid pre-release (we do not allow implicit pre-releases).
         if ".dev-candidate" < release < "final":
@@ -118,7 +118,7 @@ class Version(namedtuple("Version", ["major", "minor", "micro", "release", "pre"
             elif dev:
                 raise ValueError("Version is not a development release.")
 
-        return super(Version, cls).__new__(cls, major, minor, micro, release, pre, post, dev)
+        return super().__new__(cls, major, minor, micro, release, pre, post, dev)
 
     def _is_pre(self) -> bool:
         """Is prerelease."""
@@ -145,15 +145,15 @@ class Version(namedtuple("Version", ["major", "minor", "micro", "release", "pre"
 
         # Assemble major, minor, micro version and append `pre`, `post`, or `dev` if needed..
         if self.micro == 0:
-            ver = "{}.{}".format(self.major, self.minor)
+            ver = f"{self.major}.{self.minor}"
         else:
-            ver = "{}.{}.{}".format(self.major, self.minor, self.micro)
+            ver = f"{self.major}.{self.minor}.{self.micro}"
         if self._is_pre():
-            ver += '{}{}'.format(REL_MAP[self.release], self.pre)
+            ver += f'{REL_MAP[self.release]}{self.pre}'
         if self._is_post():
-            ver += ".post{}".format(self.post)
+            ver += f".post{self.post}"
         if self._is_dev():
-            ver += ".dev{}".format(self.dev)
+            ver += f".dev{self.dev}"
 
         return ver
 
@@ -164,7 +164,7 @@ def parse_version(ver: str) -> Version:
     m = RE_VER.match(ver)
 
     if m is None:
-        raise ValueError("'{}' is not a valid version".format(ver))
+        raise ValueError(f"'{ver}' is not a valid version")
 
     # Handle major, minor, micro
     major = int(m.group('major'))
@@ -193,5 +193,5 @@ def parse_version(ver: str) -> Version:
     return Version(major, minor, micro, release, pre, post, dev)
 
 
-__version_info__ = Version(2, 4, 1, "final")
+__version_info__ = Version(2, 5, 0, "final")
 __version__ = __version_info__._get_canonical()
diff --git a/lib/soupsieve/css_match.py b/lib/soupsieve/css_match.py
index 168e4be6..0b0ecfa9 100644
--- a/lib/soupsieve/css_match.py
+++ b/lib/soupsieve/css_match.py
@@ -85,7 +85,7 @@ class _DocumentNav:
 
         # Fail on unexpected types.
         if not cls.is_tag(tag):
-            raise TypeError("Expected a BeautifulSoup 'Tag', but instead received type {}".format(type(tag)))
+            raise TypeError(f"Expected a BeautifulSoup 'Tag', but instead received type {type(tag)}")
 
     @staticmethod
     def is_doc(obj: bs4.Tag) -> bool:
@@ -165,8 +165,7 @@ class _DocumentNav:
     def get_contents(self, el: bs4.Tag, no_iframe: bool = False) -> Iterator[bs4.PageElement]:
         """Get contents or contents in reverse."""
         if not no_iframe or not self.is_iframe(el):
-            for content in el.contents:
-                yield content
+            yield from el.contents
 
     def get_children(
         self,
@@ -283,7 +282,7 @@ class _DocumentNav:
         like we do in the case of `is_html_tag`.
         """
 
-        ns = getattr(el, 'namespace') if el else None
+        ns = getattr(el, 'namespace') if el else None  # noqa: B009
         return bool(ns and ns == NS_XHTML)
 
     @staticmethod
@@ -394,7 +393,7 @@ class Inputs:
     def validate_week(year: int, week: int) -> bool:
         """Validate week."""
 
-        max_week = datetime.strptime("{}-{}-{}".format(12, 31, year), "%m-%d-%Y").isocalendar()[1]
+        max_week = datetime.strptime(f"{12}-{31}-{year}", "%m-%d-%Y").isocalendar()[1]
         if max_week == 1:
             max_week = 53
         return 1 <= week <= max_week
@@ -1272,11 +1271,7 @@ class CSSMatch(_DocumentNav):
         # Auto handling for text inputs
         if ((is_input and itype in ('text', 'search', 'tel', 'url', 'email')) or is_textarea) and direction == 0:
             if is_textarea:
-                temp = []
-                for node in self.get_contents(el, no_iframe=True):
-                    if self.is_content_string(node):
-                        temp.append(node)
-                value = ''.join(temp)
+                value = ''.join(node for node in self.get_contents(el, no_iframe=True) if self.is_content_string(node))
             else:
                 value = cast(str, self.get_attribute_by_name(el, 'value', ''))
             if value:
@@ -1571,17 +1566,14 @@ class SoupSieve(ct.Immutable):
     def iselect(self, tag: bs4.Tag, limit: int = 0) -> Iterator[bs4.Tag]:
         """Iterate the specified tags."""
 
-        for el in CSSMatch(self.selectors, tag, self.namespaces, self.flags).select(limit):
-            yield el
+        yield from CSSMatch(self.selectors, tag, self.namespaces, self.flags).select(limit)
 
     def __repr__(self) -> str:  # pragma: no cover
         """Representation."""
 
-        return "SoupSieve(pattern={!r}, namespaces={!r}, custom={!r}, flags={!r})".format(
-            self.pattern,
-            self.namespaces,
-            self.custom,
-            self.flags
+        return (
+            f"SoupSieve(pattern={self.pattern!r}, namespaces={self.namespaces!r}, "
+            f"custom={self.custom!r}, flags={self.flags!r})"
         )
 
     __str__ = __repr__
diff --git a/lib/soupsieve/css_parser.py b/lib/soupsieve/css_parser.py
index 10ac6f21..14cf54a2 100644
--- a/lib/soupsieve/css_parser.py
+++ b/lib/soupsieve/css_parser.py
@@ -92,94 +92,79 @@ PSEUDO_SUPPORTED = PSEUDO_SIMPLE | PSEUDO_SIMPLE_NO_MATCH | PSEUDO_COMPLEX | PSE
 # Sub-patterns parts
 # Whitespace
 NEWLINE = r'(?:\r\n|(?!\r\n)[\n\f\r])'
-WS = r'(?:[ \t]|{})'.format(NEWLINE)
+WS = fr'(?:[ \t]|{NEWLINE})'
 # Comments
 COMMENTS = r'(?:/\*[^*]*\*+(?:[^/*][^*]*\*+)*/)'
 # Whitespace with comments included
-WSC = r'(?:{ws}|{comments})'.format(ws=WS, comments=COMMENTS)
+WSC = fr'(?:{WS}|{COMMENTS})'
 # CSS escapes
-CSS_ESCAPES = r'(?:\\(?:[a-f0-9]{{1,6}}{ws}?|[^\r\n\f]|$))'.format(ws=WS)
-CSS_STRING_ESCAPES = r'(?:\\(?:[a-f0-9]{{1,6}}{ws}?|[^\r\n\f]|$|{nl}))'.format(ws=WS, nl=NEWLINE)
+CSS_ESCAPES = fr'(?:\\(?:[a-f0-9]{{1,6}}{WS}?|[^\r\n\f]|$))'
+CSS_STRING_ESCAPES = fr'(?:\\(?:[a-f0-9]{{1,6}}{WS}?|[^\r\n\f]|$|{NEWLINE}))'
 # CSS Identifier
-IDENTIFIER = r'''
-(?:(?:-?(?:[^\x00-\x2f\x30-\x40\x5B-\x5E\x60\x7B-\x9f]|{esc})+|--)
-(?:[^\x00-\x2c\x2e\x2f\x3A-\x40\x5B-\x5E\x60\x7B-\x9f]|{esc})*)
-'''.format(esc=CSS_ESCAPES)
+IDENTIFIER = fr'''
+(?:(?:-?(?:[^\x00-\x2f\x30-\x40\x5B-\x5E\x60\x7B-\x9f]|{CSS_ESCAPES})+|--)
+(?:[^\x00-\x2c\x2e\x2f\x3A-\x40\x5B-\x5E\x60\x7B-\x9f]|{CSS_ESCAPES})*)
+'''
 # `nth` content
-NTH = r'(?:[-+])?(?:[0-9]+n?|n)(?:(?<=n){ws}*(?:[-+]){ws}*(?:[0-9]+))?'.format(ws=WSC)
+NTH = fr'(?:[-+])?(?:[0-9]+n?|n)(?:(?<=n){WSC}*(?:[-+]){WSC}*(?:[0-9]+))?'
 # Value: quoted string or identifier
-VALUE = r'''
-(?:"(?:\\(?:.|{nl})|[^\\"\r\n\f]+)*?"|'(?:\\(?:.|{nl})|[^\\'\r\n\f]+)*?'|{ident}+)
-'''.format(nl=NEWLINE, ident=IDENTIFIER)
+VALUE = fr'''(?:"(?:\\(?:.|{NEWLINE})|[^\\"\r\n\f]+)*?"|'(?:\\(?:.|{NEWLINE})|[^\\'\r\n\f]+)*?'|{IDENTIFIER}+)'''
 # Attribute value comparison. `!=` is handled special as it is non-standard.
-ATTR = r'''
-(?:{ws}*(?P<cmp>[!~^|*$]?=){ws}*(?P<value>{value})(?:{ws}*(?P<case>[is]))?)?{ws}*\]
-'''.format(ws=WSC, value=VALUE)
+ATTR = fr'(?:{WSC}*(?P<cmp>[!~^|*$]?=){WSC}*(?P<value>{VALUE})(?:{WSC}*(?P<case>[is]))?)?{WSC}*\]'
 
 # Selector patterns
 # IDs (`#id`)
-PAT_ID = r'\#{ident}'.format(ident=IDENTIFIER)
+PAT_ID = fr'\#{IDENTIFIER}'
 # Classes (`.class`)
-PAT_CLASS = r'\.{ident}'.format(ident=IDENTIFIER)
+PAT_CLASS = fr'\.{IDENTIFIER}'
 # Prefix:Tag (`prefix|tag`)
-PAT_TAG = r'(?P<tag_ns>(?:{ident}|\*)?\|)?(?P<tag_name>{ident}|\*)'.format(ident=IDENTIFIER)
+PAT_TAG = fr'(?P<tag_ns>(?:{IDENTIFIER}|\*)?\|)?(?P<tag_name>{IDENTIFIER}|\*)'
 # Attributes (`[attr]`, `[attr=value]`, etc.)
-PAT_ATTR = r'''
-\[{ws}*(?P<attr_ns>(?:{ident}|\*)?\|)?(?P<attr_name>{ident}){attr}
-'''.format(ws=WSC, ident=IDENTIFIER, attr=ATTR)
+PAT_ATTR = fr'\[{WSC}*(?P<attr_ns>(?:{IDENTIFIER}|\*)?\|)?(?P<attr_name>{IDENTIFIER}){ATTR}'
 # Pseudo class (`:pseudo-class`, `:pseudo-class(`)
-PAT_PSEUDO_CLASS = r'(?P<name>:{ident})(?P<open>\({ws}*)?'.format(ws=WSC, ident=IDENTIFIER)
+PAT_PSEUDO_CLASS = fr'(?P<name>:{IDENTIFIER})(?P<open>\({WSC}*)?'
 # Pseudo class special patterns. Matches `:pseudo-class(` for special case pseudo classes.
-PAT_PSEUDO_CLASS_SPECIAL = r'(?P<name>:{ident})(?P<open>\({ws}*)'.format(ws=WSC, ident=IDENTIFIER)
+PAT_PSEUDO_CLASS_SPECIAL = fr'(?P<name>:{IDENTIFIER})(?P<open>\({WSC}*)'
 # Custom pseudo class (`:--custom-pseudo`)
-PAT_PSEUDO_CLASS_CUSTOM = r'(?P<name>:(?=--){ident})'.format(ident=IDENTIFIER)
+PAT_PSEUDO_CLASS_CUSTOM = fr'(?P<name>:(?=--){IDENTIFIER})'
 # Closing pseudo group (`)`)
-PAT_PSEUDO_CLOSE = r'{ws}*\)'.format(ws=WSC)
+PAT_PSEUDO_CLOSE = fr'{WSC}*\)'
 # Pseudo element (`::pseudo-element`)
-PAT_PSEUDO_ELEMENT = r':{}'.format(PAT_PSEUDO_CLASS)
+PAT_PSEUDO_ELEMENT = fr':{PAT_PSEUDO_CLASS}'
 # At rule (`@page`, etc.) (not supported)
-PAT_AT_RULE = r'@P{ident}'.format(ident=IDENTIFIER)
+PAT_AT_RULE = fr'@P{IDENTIFIER}'
 # Pseudo class `nth-child` (`:nth-child(an+b [of S]?)`, `:first-child`, etc.)
-PAT_PSEUDO_NTH_CHILD = r'''
-(?P<pseudo_nth_child>{name}
-(?P<nth_child>{nth}|even|odd))(?:{wsc}*\)|(?P<of>{comments}*{ws}{wsc}*of{comments}*{ws}{wsc}*))
-'''.format(name=PAT_PSEUDO_CLASS_SPECIAL, wsc=WSC, comments=COMMENTS, ws=WS, nth=NTH)
+PAT_PSEUDO_NTH_CHILD = fr'''
+(?P<pseudo_nth_child>{PAT_PSEUDO_CLASS_SPECIAL}
+(?P<nth_child>{NTH}|even|odd))(?:{WSC}*\)|(?P<of>{COMMENTS}*{WS}{WSC}*of{COMMENTS}*{WS}{WSC}*))
+'''
 # Pseudo class `nth-of-type` (`:nth-of-type(an+b)`, `:first-of-type`, etc.)
-PAT_PSEUDO_NTH_TYPE = r'''
-(?P<pseudo_nth_type>{name}
-(?P<nth_type>{nth}|even|odd)){ws}*\)
-'''.format(name=PAT_PSEUDO_CLASS_SPECIAL, ws=WSC, nth=NTH)
+PAT_PSEUDO_NTH_TYPE = fr'''
+(?P<pseudo_nth_type>{PAT_PSEUDO_CLASS_SPECIAL}
+(?P<nth_type>{NTH}|even|odd)){WSC}*\)
+'''
 # Pseudo class language (`:lang("*-de", en)`)
-PAT_PSEUDO_LANG = r'{name}(?P<values>{value}(?:{ws}*,{ws}*{value})*){ws}*\)'.format(
-    name=PAT_PSEUDO_CLASS_SPECIAL, ws=WSC, value=VALUE
-)
+PAT_PSEUDO_LANG = fr'{PAT_PSEUDO_CLASS_SPECIAL}(?P<values>{VALUE}(?:{WSC}*,{WSC}*{VALUE})*){WSC}*\)'
 # Pseudo class direction (`:dir(ltr)`)
-PAT_PSEUDO_DIR = r'{name}(?P<dir>ltr|rtl){ws}*\)'.format(name=PAT_PSEUDO_CLASS_SPECIAL, ws=WSC)
+PAT_PSEUDO_DIR = fr'{PAT_PSEUDO_CLASS_SPECIAL}(?P<dir>ltr|rtl){WSC}*\)'
 # Combining characters (`>`, `~`, ` `, `+`, `,`)
-PAT_COMBINE = r'{wsc}*?(?P<relation>[,+>~]|{ws}(?![,+>~])){wsc}*'.format(ws=WS, wsc=WSC)
+PAT_COMBINE = fr'{WSC}*?(?P<relation>[,+>~]|{WS}(?![,+>~])){WSC}*'
 # Extra: Contains (`:contains(text)`)
-PAT_PSEUDO_CONTAINS = r'{name}(?P<values>{value}(?:{ws}*,{ws}*{value})*){ws}*\)'.format(
-    name=PAT_PSEUDO_CLASS_SPECIAL, ws=WSC, value=VALUE
-)
+PAT_PSEUDO_CONTAINS = fr'{PAT_PSEUDO_CLASS_SPECIAL}(?P<values>{VALUE}(?:{WSC}*,{WSC}*{VALUE})*){WSC}*\)'
 
 # Regular expressions
 # CSS escape pattern
-RE_CSS_ESC = re.compile(r'(?:(\\[a-f0-9]{{1,6}}{ws}?)|(\\[^\r\n\f])|(\\$))'.format(ws=WSC), re.I)
-RE_CSS_STR_ESC = re.compile(
-    r'(?:(\\[a-f0-9]{{1,6}}{ws}?)|(\\[^\r\n\f])|(\\$)|(\\{nl}))'.format(ws=WS, nl=NEWLINE), re.I
-)
+RE_CSS_ESC = re.compile(fr'(?:(\\[a-f0-9]{{1,6}}{WSC}?)|(\\[^\r\n\f])|(\\$))', re.I)
+RE_CSS_STR_ESC = re.compile(fr'(?:(\\[a-f0-9]{{1,6}}{WS}?)|(\\[^\r\n\f])|(\\$)|(\\{NEWLINE}))', re.I)
 # Pattern to break up `nth` specifiers
-RE_NTH = re.compile(
-    r'(?P<s1>[-+])?(?P<a>[0-9]+n?|n)(?:(?<=n){ws}*(?P<s2>[-+]){ws}*(?P<b>[0-9]+))?'.format(ws=WSC),
-    re.I
-)
+RE_NTH = re.compile(fr'(?P<s1>[-+])?(?P<a>[0-9]+n?|n)(?:(?<=n){WSC}*(?P<s2>[-+]){WSC}*(?P<b>[0-9]+))?', re.I)
 # Pattern to iterate multiple values.
-RE_VALUES = re.compile(r'(?:(?P<value>{value})|(?P<split>{ws}*,{ws}*))'.format(ws=WSC, value=VALUE), re.X)
+RE_VALUES = re.compile(fr'(?:(?P<value>{VALUE})|(?P<split>{WSC}*,{WSC}*))', re.X)
 # Whitespace checks
 RE_WS = re.compile(WS)
-RE_WS_BEGIN = re.compile('^{}*'.format(WSC))
-RE_WS_END = re.compile('{}*$'.format(WSC))
-RE_CUSTOM = re.compile(r'^{}$'.format(PAT_PSEUDO_CLASS_CUSTOM), re.X)
+RE_WS_BEGIN = re.compile(fr'^{WSC}*')
+RE_WS_END = re.compile(fr'{WSC}*$')
+RE_CUSTOM = re.compile(fr'^{PAT_PSEUDO_CLASS_CUSTOM}$', re.X)
 
 # Constants
 # List split token
@@ -241,9 +226,9 @@ def process_custom(custom: ct.CustomSelectors | None) -> dict[str, str | ct.Sele
         for key, value in custom.items():
             name = util.lower(key)
             if RE_CUSTOM.match(name) is None:
-                raise SelectorSyntaxError("The name '{}' is not a valid custom pseudo-class name".format(name))
+                raise SelectorSyntaxError(f"The name '{name}' is not a valid custom pseudo-class name")
             if name in custom_selectors:
-                raise KeyError("The custom selector '{}' has already been registered".format(name))
+                raise KeyError(f"The custom selector '{name}' has already been registered")
             custom_selectors[css_unescape(name)] = value
     return custom_selectors
 
@@ -283,23 +268,23 @@ def escape(ident: str) -> str:
     start_dash = length > 0 and ident[0] == '-'
     if length == 1 and start_dash:
         # Need to escape identifier that is a single `-` with no other characters
-        string.append('\\{}'.format(ident))
+        string.append(f'\\{ident}')
     else:
         for index, c in enumerate(ident):
             codepoint = ord(c)
             if codepoint == 0x00:
                 string.append('\ufffd')
             elif (0x01 <= codepoint <= 0x1F) or codepoint == 0x7F:
-                string.append('\\{:x} '.format(codepoint))
+                string.append(f'\\{codepoint:x} ')
             elif (index == 0 or (start_dash and index == 1)) and (0x30 <= codepoint <= 0x39):
-                string.append('\\{:x} '.format(codepoint))
+                string.append(f'\\{codepoint:x} ')
             elif (
                 codepoint in (0x2D, 0x5F) or codepoint >= 0x80 or (0x30 <= codepoint <= 0x39) or
                 (0x30 <= codepoint <= 0x39) or (0x41 <= codepoint <= 0x5A) or (0x61 <= codepoint <= 0x7A)
             ):
                 string.append(c)
             else:
-                string.append('\\{}'.format(c))
+                string.append(f'\\{c}')
     return ''.join(string)
 
 
@@ -419,11 +404,10 @@ class _Selector:
         """String representation."""
 
         return (
-            '_Selector(tag={!r}, ids={!r}, classes={!r}, attributes={!r}, nth={!r}, selectors={!r}, '
-            'relations={!r}, rel_type={!r}, contains={!r}, lang={!r}, flags={!r}, no_match={!r})'
-        ).format(
-            self.tag, self.ids, self.classes, self.attributes, self.nth, self.selectors,
-            self.relations, self.rel_type, self.contains, self.lang, self.flags, self.no_match
+            f'_Selector(tag={self.tag!r}, ids={self.ids!r}, classes={self.classes!r}, attributes={self.attributes!r}, '
+            f'nth={self.nth!r}, selectors={self.selectors!r}, relations={self.relations!r}, '
+            f'rel_type={self.rel_type!r}, contains={self.contains!r}, lang={self.lang!r}, flags={self.flags!r}, '
+            f'no_match={self.no_match!r})'
         )
 
     __repr__ = __str__
@@ -563,7 +547,7 @@ class CSSParser:
         selector = self.custom.get(pseudo)
         if selector is None:
             raise SelectorSyntaxError(
-                "Undefined custom selector '{}' found at position {}".format(pseudo, m.end(0)),
+                f"Undefined custom selector '{pseudo}' found at position {m.end(0)}",
                 self.pattern,
                 m.end(0)
             )
@@ -663,13 +647,13 @@ class CSSParser:
             has_selector = True
         elif pseudo in PSEUDO_SUPPORTED:
             raise SelectorSyntaxError(
-                "Invalid syntax for pseudo class '{}'".format(pseudo),
+                f"Invalid syntax for pseudo class '{pseudo}'",
                 self.pattern,
                 m.start(0)
             )
         else:
             raise NotImplementedError(
-                "'{}' pseudo-class is not implemented at this time".format(pseudo)
+                f"'{pseudo}' pseudo-class is not implemented at this time"
             )
 
         return has_selector, is_html
@@ -793,7 +777,7 @@ class CSSParser:
                 # multiple non-whitespace combinators. So if the current combinator is not a whitespace,
                 # then we've hit the multiple combinator case, so we should fail.
                 raise SelectorSyntaxError(
-                    'The multiple combinators at position {}'.format(index),
+                    f'The multiple combinators at position {index}',
                     self.pattern,
                     index
                 )
@@ -824,7 +808,7 @@ class CSSParser:
         if not has_selector:
             if not is_forgive or combinator != COMMA_COMBINATOR:
                 raise SelectorSyntaxError(
-                    "The combinator '{}' at position {}, must have a selector before it".format(combinator, index),
+                    f"The combinator '{combinator}' at position {index}, must have a selector before it",
                     self.pattern,
                     index
                 )
@@ -869,7 +853,7 @@ class CSSParser:
 
         pseudo = util.lower(css_unescape(m.group('name')))
         if pseudo == ":contains":
-            warnings.warn(
+            warnings.warn(  # noqa: B028
                 "The pseudo class ':contains' is deprecated, ':-soup-contains' should be used moving forward.",
                 FutureWarning
             )
@@ -982,13 +966,13 @@ class CSSParser:
 
                 # Handle parts
                 if key == "at_rule":
-                    raise NotImplementedError("At-rules found at position {}".format(m.start(0)))
+                    raise NotImplementedError(f"At-rules found at position {m.start(0)}")
                 elif key == 'pseudo_class_custom':
                     has_selector = self.parse_pseudo_class_custom(sel, m, has_selector)
                 elif key == 'pseudo_class':
                     has_selector, is_html = self.parse_pseudo_class(sel, m, has_selector, iselector, is_html)
                 elif key == 'pseudo_element':
-                    raise NotImplementedError("Pseudo-element found at position {}".format(m.start(0)))
+                    raise NotImplementedError(f"Pseudo-element found at position {m.start(0)}")
                 elif key == 'pseudo_contains':
                     has_selector = self.parse_pseudo_contains(sel, m, has_selector)
                 elif key in ('pseudo_nth_type', 'pseudo_nth_child'):
@@ -1003,7 +987,7 @@ class CSSParser:
                     if not has_selector:
                         if not is_forgive:
                             raise SelectorSyntaxError(
-                                "Expected a selector at position {}".format(m.start(0)),
+                                f"Expected a selector at position {m.start(0)}",
                                 self.pattern,
                                 m.start(0)
                             )
@@ -1013,7 +997,7 @@ class CSSParser:
                         break
                     else:
                         raise SelectorSyntaxError(
-                            "Unmatched pseudo-class close at position {}".format(m.start(0)),
+                            f"Unmatched pseudo-class close at position {m.start(0)}",
                             self.pattern,
                             m.start(0)
                         )
@@ -1031,7 +1015,7 @@ class CSSParser:
                 elif key == 'tag':
                     if has_selector:
                         raise SelectorSyntaxError(
-                            "Tag name found at position {} instead of at the start".format(m.start(0)),
+                            f"Tag name found at position {m.start(0)} instead of at the start",
                             self.pattern,
                             m.start(0)
                         )
@@ -1046,7 +1030,7 @@ class CSSParser:
         # Handle selectors that are not closed
         if is_open and not closed:
             raise SelectorSyntaxError(
-                "Unclosed pseudo-class at position {}".format(index),
+                f"Unclosed pseudo-class at position {index}",
                 self.pattern,
                 index
             )
@@ -1076,7 +1060,7 @@ class CSSParser:
             # We will always need to finish a selector when `:has()` is used as it leads with combining.
             # May apply to others as well.
             raise SelectorSyntaxError(
-                'Expected a selector at position {}'.format(index),
+                f'Expected a selector at position {index}',
                 self.pattern,
                 index
             )
@@ -1108,7 +1092,7 @@ class CSSParser:
         end = (m.start(0) - 1) if m else (len(pattern) - 1)
 
         if self.debug:  # pragma: no cover
-            print('## PARSING: {!r}'.format(pattern))
+            print(f'## PARSING: {pattern!r}')
         while index <= end:
             m = None
             for v in self.css_tokens:
@@ -1116,7 +1100,7 @@ class CSSParser:
                 if m:
                     name = v.get_name()
                     if self.debug:  # pragma: no cover
-                        print("TOKEN: '{}' --> {!r} at position {}".format(name, m.group(0), m.start(0)))
+                        print(f"TOKEN: '{name}' --> {m.group(0)!r} at position {m.start(0)}")
                     index = m.end(0)
                     yield name, m
                     break
@@ -1126,15 +1110,15 @@ class CSSParser:
                 # throw an exception mentioning that the known selector type is in error;
                 # otherwise, report the invalid character.
                 if c == '[':
-                    msg = "Malformed attribute selector at position {}".format(index)
+                    msg = f"Malformed attribute selector at position {index}"
                 elif c == '.':
-                    msg = "Malformed class selector at position {}".format(index)
+                    msg = f"Malformed class selector at position {index}"
                 elif c == '#':
-                    msg = "Malformed id selector at position {}".format(index)
+                    msg = f"Malformed id selector at position {index}"
                 elif c == ':':
-                    msg = "Malformed pseudo-class selector at position {}".format(index)
+                    msg = f"Malformed pseudo-class selector at position {index}"
                 else:
-                    msg = "Invalid character {!r} position {}".format(c, index)
+                    msg = f"Invalid character {c!r} position {index}"
                 raise SelectorSyntaxError(msg, self.pattern, index)
         if self.debug:  # pragma: no cover
             print('## END PARSING')
diff --git a/lib/soupsieve/css_types.py b/lib/soupsieve/css_types.py
index c263bb04..71a6519b 100644
--- a/lib/soupsieve/css_types.py
+++ b/lib/soupsieve/css_types.py
@@ -45,11 +45,11 @@ class Immutable:
         for k, v in kwargs.items():
             temp.append(type(v))
             temp.append(v)
-            super(Immutable, self).__setattr__(k, v)
-        super(Immutable, self).__setattr__('_hash', hash(tuple(temp)))
+            super().__setattr__(k, v)
+        super().__setattr__('_hash', hash(tuple(temp)))
 
     @classmethod
-    def __base__(cls) -> "type[Immutable]":
+    def __base__(cls) -> type[Immutable]:
         """Get base class."""
 
         return cls
@@ -59,7 +59,7 @@ class Immutable:
 
         return (
             isinstance(other, self.__base__()) and
-            all([getattr(other, key) == getattr(self, key) for key in self.__slots__ if key != '_hash'])
+            all(getattr(other, key) == getattr(self, key) for key in self.__slots__ if key != '_hash')
         )
 
     def __ne__(self, other: Any) -> bool:
@@ -67,7 +67,7 @@ class Immutable:
 
         return (
             not isinstance(other, self.__base__()) or
-            any([getattr(other, key) != getattr(self, key) for key in self.__slots__ if key != '_hash'])
+            any(getattr(other, key) != getattr(self, key) for key in self.__slots__ if key != '_hash')
         )
 
     def __hash__(self) -> int:
@@ -78,14 +78,13 @@ class Immutable:
     def __setattr__(self, name: str, value: Any) -> None:
         """Prevent mutability."""
 
-        raise AttributeError("'{}' is immutable".format(self.__class__.__name__))
+        raise AttributeError(f"'{self.__class__.__name__}' is immutable")
 
     def __repr__(self) -> str:  # pragma: no cover
         """Representation."""
 
-        return "{}({})".format(
-            self.__class__.__name__, ', '.join(["{}={!r}".format(k, getattr(self, k)) for k in self.__slots__[:-1]])
-        )
+        r = ', '.join([f"{k}={getattr(self, k)!r}" for k in self.__slots__[:-1]])
+        return f"{self.__class__.__name__}({r})"
 
     __str__ = __repr__
 
@@ -112,10 +111,10 @@ class ImmutableDict(Mapping[Any, Any]):
         """Validate arguments."""
 
         if isinstance(arg, dict):
-            if not all([isinstance(v, Hashable) for v in arg.values()]):
-                raise TypeError('{} values must be hashable'.format(self.__class__.__name__))
-        elif not all([isinstance(k, Hashable) and isinstance(v, Hashable) for k, v in arg]):
-            raise TypeError('{} values must be hashable'.format(self.__class__.__name__))
+            if not all(isinstance(v, Hashable) for v in arg.values()):
+                raise TypeError(f'{self.__class__.__name__} values must be hashable')
+        elif not all(isinstance(k, Hashable) and isinstance(v, Hashable) for k, v in arg):
+            raise TypeError(f'{self.__class__.__name__} values must be hashable')
 
     def __iter__(self) -> Iterator[Any]:
         """Iterator."""
@@ -140,7 +139,7 @@ class ImmutableDict(Mapping[Any, Any]):
     def __repr__(self) -> str:  # pragma: no cover
         """Representation."""
 
-        return "{!r}".format(self._d)
+        return f"{self._d!r}"
 
     __str__ = __repr__
 
@@ -157,10 +156,10 @@ class Namespaces(ImmutableDict):
         """Validate arguments."""
 
         if isinstance(arg, dict):
-            if not all([isinstance(v, str) for v in arg.values()]):
-                raise TypeError('{} values must be hashable'.format(self.__class__.__name__))
-        elif not all([isinstance(k, str) and isinstance(v, str) for k, v in arg]):
-            raise TypeError('{} keys and values must be Unicode strings'.format(self.__class__.__name__))
+            if not all(isinstance(v, str) for v in arg.values()):
+                raise TypeError(f'{self.__class__.__name__} values must be hashable')
+        elif not all(isinstance(k, str) and isinstance(v, str) for k, v in arg):
+            raise TypeError(f'{self.__class__.__name__} keys and values must be Unicode strings')
 
 
 class CustomSelectors(ImmutableDict):
@@ -175,10 +174,10 @@ class CustomSelectors(ImmutableDict):
         """Validate arguments."""
 
         if isinstance(arg, dict):
-            if not all([isinstance(v, str) for v in arg.values()]):
-                raise TypeError('{} values must be hashable'.format(self.__class__.__name__))
-        elif not all([isinstance(k, str) and isinstance(v, str) for k, v in arg]):
-            raise TypeError('{} keys and values must be Unicode strings'.format(self.__class__.__name__))
+            if not all(isinstance(v, str) for v in arg.values()):
+                raise TypeError(f'{self.__class__.__name__} values must be hashable')
+        elif not all(isinstance(k, str) and isinstance(v, str) for k, v in arg):
+            raise TypeError(f'{self.__class__.__name__} keys and values must be Unicode strings')
 
 
 class Selector(Immutable):
@@ -367,7 +366,7 @@ class SelectorList(Immutable):
         """Initialize."""
 
         super().__init__(
-            selectors=tuple(selectors) if selectors is not None else tuple(),
+            selectors=tuple(selectors) if selectors is not None else (),
             is_not=is_not,
             is_html=is_html
         )
diff --git a/lib/soupsieve/pretty.py b/lib/soupsieve/pretty.py
index f848d5e2..193db05e 100644
--- a/lib/soupsieve/pretty.py
+++ b/lib/soupsieve/pretty.py
@@ -10,7 +10,7 @@ The format and various output types is fairly known (though it
 hasn't been tested extensively to make sure we aren't missing corners).
 
 Example:
-
+-------
 ```
 >>> import soupsieve as sv
 >>> sv.compile('this > that.class[name=value]').selectors.pretty()
@@ -64,6 +64,7 @@ SelectorList(
     is_not=False,
     is_html=False)
 ```
+
 """
 from __future__ import annotations
 import re
@@ -123,16 +124,16 @@ def pretty(obj: Any) -> str:  # pragma: no cover
                 index = m.end(0)
                 if name in ('class', 'lstrt', 'dstrt', 'tstrt'):
                     indent += 4
-                    output.append('{}\n{}'.format(m.group(0), " " * indent))
+                    output.append(f'{m.group(0)}\n{" " * indent}')
                 elif name in ('param', 'int', 'kword', 'sqstr', 'dqstr', 'empty'):
                     output.append(m.group(0))
                 elif name in ('lend', 'dend', 'tend'):
                     indent -= 4
                     output.append(m.group(0))
                 elif name in ('sep',):
-                    output.append('{}\n{}'.format(m.group(1), " " * indent))
+                    output.append(f'{m.group(1)}\n{" " * indent}')
                 elif name in ('dsep',):
-                    output.append('{} '.format(m.group(1)))
+                    output.append(f'{m.group(1)} ')
                 break
 
     return ''.join(output)
diff --git a/lib/soupsieve/util.py b/lib/soupsieve/util.py
index 9f91233b..9b2e64df 100644
--- a/lib/soupsieve/util.py
+++ b/lib/soupsieve/util.py
@@ -37,7 +37,7 @@ class SelectorSyntaxError(Exception):
         if pattern is not None and index is not None:
             # Format pattern to show line and column position
             self.context, self.line, self.col = get_pattern_context(pattern, index)
-            msg = '{}\n  line {}:\n{}'.format(msg, self.line, self.context)
+            msg = f'{msg}\n  line {self.line}:\n{self.context}'
 
         super().__init__(msg)
 
@@ -105,7 +105,7 @@ def get_pattern_context(pattern: str, index: int) -> tuple[str, int, int]:
             # we will render the output with just `\n`. We will still log the column
             # correctly though.
             text.append('\n')
-        text.append('{}{}'.format(indent, linetext))
+        text.append(f'{indent}{linetext}')
         if offset is not None:
             text.append('\n')
             text.append(' ' * (col + offset) + '^')
diff --git a/requirements.txt b/requirements.txt
index 21a7ee6f..0b009ea7 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -3,7 +3,7 @@ arrow==1.3.0
 backports.csv==1.0.7
 backports.functools-lru-cache==2.0.0
 backports.zoneinfo==0.2.1;python_version<"3.9"
-beautifulsoup4==4.12.2
+beautifulsoup4==4.12.3
 bleach==6.1.0
 certifi==2024.2.2
 cheroot==10.0.0

From 4398dfa821225217ffc8dd2916ce0d8c623ea360 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sun, 24 Mar 2024 15:26:46 -0700
Subject: [PATCH 541/743] Bump packaging from 23.1 to 24.0 (#2274)

* Bump packaging from 23.1 to 24.0

Bumps [packaging](https://github.com/pypa/packaging) from 23.1 to 24.0.
- [Release notes](https://github.com/pypa/packaging/releases)
- [Changelog](https://github.com/pypa/packaging/blob/main/CHANGELOG.rst)
- [Commits](https://github.com/pypa/packaging/compare/23.1...24.0)

---
updated-dependencies:
- dependency-name: packaging
  dependency-type: direct:production
  update-type: version-update:semver-major
...

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

* Update packaging==24.0

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/packaging/__init__.py     |   4 +-
 lib/packaging/_manylinux.py   |  74 +++---
 lib/packaging/_musllinux.py   |  19 +-
 lib/packaging/_parser.py      |  13 +-
 lib/packaging/metadata.py     | 439 +++++++++++++++++++++++++++++++++-
 lib/packaging/requirements.py |  45 ++--
 lib/packaging/specifiers.py   |  63 ++---
 lib/packaging/tags.py         |  63 +++--
 lib/packaging/utils.py        |  39 ++-
 lib/packaging/version.py      |  63 +++--
 requirements.txt              |   2 +-
 11 files changed, 663 insertions(+), 161 deletions(-)

diff --git a/lib/packaging/__init__.py b/lib/packaging/__init__.py
index 13cadc7f..e7c0aa12 100644
--- a/lib/packaging/__init__.py
+++ b/lib/packaging/__init__.py
@@ -6,10 +6,10 @@ __title__ = "packaging"
 __summary__ = "Core utilities for Python packages"
 __uri__ = "https://github.com/pypa/packaging"
 
-__version__ = "23.1"
+__version__ = "24.0"
 
 __author__ = "Donald Stufft and individual contributors"
 __email__ = "donald@stufft.io"
 
 __license__ = "BSD-2-Clause or Apache-2.0"
-__copyright__ = "2014-2019 %s" % __author__
+__copyright__ = "2014 %s" % __author__
diff --git a/lib/packaging/_manylinux.py b/lib/packaging/_manylinux.py
index 449c655b..ad62505f 100644
--- a/lib/packaging/_manylinux.py
+++ b/lib/packaging/_manylinux.py
@@ -5,7 +5,7 @@ import os
 import re
 import sys
 import warnings
-from typing import Dict, Generator, Iterator, NamedTuple, Optional, Tuple
+from typing import Dict, Generator, Iterator, NamedTuple, Optional, Sequence, Tuple
 
 from ._elffile import EIClass, EIData, ELFFile, EMachine
 
@@ -50,12 +50,21 @@ def _is_linux_i686(executable: str) -> bool:
         )
 
 
-def _have_compatible_abi(executable: str, arch: str) -> bool:
-    if arch == "armv7l":
+def _have_compatible_abi(executable: str, archs: Sequence[str]) -> bool:
+    if "armv7l" in archs:
         return _is_linux_armhf(executable)
-    if arch == "i686":
+    if "i686" in archs:
         return _is_linux_i686(executable)
-    return arch in {"x86_64", "aarch64", "ppc64", "ppc64le", "s390x"}
+    allowed_archs = {
+        "x86_64",
+        "aarch64",
+        "ppc64",
+        "ppc64le",
+        "s390x",
+        "loongarch64",
+        "riscv64",
+    }
+    return any(arch in allowed_archs for arch in archs)
 
 
 # If glibc ever changes its major version, we need to know what the last
@@ -81,7 +90,7 @@ def _glibc_version_string_confstr() -> Optional[str]:
     # https://github.com/python/cpython/blob/fcf1d003bf4f0100c/Lib/platform.py#L175-L183
     try:
         # Should be a string like "glibc 2.17".
-        version_string: str = getattr(os, "confstr")("CS_GNU_LIBC_VERSION")
+        version_string: Optional[str] = os.confstr("CS_GNU_LIBC_VERSION")
         assert version_string is not None
         _, version = version_string.rsplit()
     except (AssertionError, AttributeError, OSError, ValueError):
@@ -167,13 +176,13 @@ def _get_glibc_version() -> Tuple[int, int]:
 
 
 # From PEP 513, PEP 600
-def _is_compatible(name: str, arch: str, version: _GLibCVersion) -> bool:
+def _is_compatible(arch: str, version: _GLibCVersion) -> bool:
     sys_glibc = _get_glibc_version()
     if sys_glibc < version:
         return False
     # Check for presence of _manylinux module.
     try:
-        import _manylinux  # noqa
+        import _manylinux
     except ImportError:
         return True
     if hasattr(_manylinux, "manylinux_compatible"):
@@ -203,12 +212,22 @@ _LEGACY_MANYLINUX_MAP = {
 }
 
 
-def platform_tags(linux: str, arch: str) -> Iterator[str]:
-    if not _have_compatible_abi(sys.executable, arch):
+def platform_tags(archs: Sequence[str]) -> Iterator[str]:
+    """Generate manylinux tags compatible to the current platform.
+
+    :param archs: Sequence of compatible architectures.
+        The first one shall be the closest to the actual architecture and be the part of
+        platform tag after the ``linux_`` prefix, e.g. ``x86_64``.
+        The ``linux_`` prefix is assumed as a prerequisite for the current platform to
+        be manylinux-compatible.
+
+    :returns: An iterator of compatible manylinux tags.
+    """
+    if not _have_compatible_abi(sys.executable, archs):
         return
     # Oldest glibc to be supported regardless of architecture is (2, 17).
     too_old_glibc2 = _GLibCVersion(2, 16)
-    if arch in {"x86_64", "i686"}:
+    if set(archs) & {"x86_64", "i686"}:
         # On x86/i686 also oldest glibc to be supported is (2, 5).
         too_old_glibc2 = _GLibCVersion(2, 4)
     current_glibc = _GLibCVersion(*_get_glibc_version())
@@ -222,19 +241,20 @@ def platform_tags(linux: str, arch: str) -> Iterator[str]:
     for glibc_major in range(current_glibc.major - 1, 1, -1):
         glibc_minor = _LAST_GLIBC_MINOR[glibc_major]
         glibc_max_list.append(_GLibCVersion(glibc_major, glibc_minor))
-    for glibc_max in glibc_max_list:
-        if glibc_max.major == too_old_glibc2.major:
-            min_minor = too_old_glibc2.minor
-        else:
-            # For other glibc major versions oldest supported is (x, 0).
-            min_minor = -1
-        for glibc_minor in range(glibc_max.minor, min_minor, -1):
-            glibc_version = _GLibCVersion(glibc_max.major, glibc_minor)
-            tag = "manylinux_{}_{}".format(*glibc_version)
-            if _is_compatible(tag, arch, glibc_version):
-                yield linux.replace("linux", tag)
-            # Handle the legacy manylinux1, manylinux2010, manylinux2014 tags.
-            if glibc_version in _LEGACY_MANYLINUX_MAP:
-                legacy_tag = _LEGACY_MANYLINUX_MAP[glibc_version]
-                if _is_compatible(legacy_tag, arch, glibc_version):
-                    yield linux.replace("linux", legacy_tag)
+    for arch in archs:
+        for glibc_max in glibc_max_list:
+            if glibc_max.major == too_old_glibc2.major:
+                min_minor = too_old_glibc2.minor
+            else:
+                # For other glibc major versions oldest supported is (x, 0).
+                min_minor = -1
+            for glibc_minor in range(glibc_max.minor, min_minor, -1):
+                glibc_version = _GLibCVersion(glibc_max.major, glibc_minor)
+                tag = "manylinux_{}_{}".format(*glibc_version)
+                if _is_compatible(arch, glibc_version):
+                    yield f"{tag}_{arch}"
+                # Handle the legacy manylinux1, manylinux2010, manylinux2014 tags.
+                if glibc_version in _LEGACY_MANYLINUX_MAP:
+                    legacy_tag = _LEGACY_MANYLINUX_MAP[glibc_version]
+                    if _is_compatible(arch, glibc_version):
+                        yield f"{legacy_tag}_{arch}"
diff --git a/lib/packaging/_musllinux.py b/lib/packaging/_musllinux.py
index 706ba600..86419df9 100644
--- a/lib/packaging/_musllinux.py
+++ b/lib/packaging/_musllinux.py
@@ -8,7 +8,7 @@ import functools
 import re
 import subprocess
 import sys
-from typing import Iterator, NamedTuple, Optional
+from typing import Iterator, NamedTuple, Optional, Sequence
 
 from ._elffile import ELFFile
 
@@ -47,24 +47,27 @@ def _get_musl_version(executable: str) -> Optional[_MuslVersion]:
         return None
     if ld is None or "musl" not in ld:
         return None
-    proc = subprocess.run([ld], stderr=subprocess.PIPE, universal_newlines=True)
+    proc = subprocess.run([ld], stderr=subprocess.PIPE, text=True)
     return _parse_musl_version(proc.stderr)
 
 
-def platform_tags(arch: str) -> Iterator[str]:
+def platform_tags(archs: Sequence[str]) -> Iterator[str]:
     """Generate musllinux tags compatible to the current platform.
 
-    :param arch: Should be the part of platform tag after the ``linux_``
-        prefix, e.g. ``x86_64``. The ``linux_`` prefix is assumed as a
-        prerequisite for the current platform to be musllinux-compatible.
+    :param archs: Sequence of compatible architectures.
+        The first one shall be the closest to the actual architecture and be the part of
+        platform tag after the ``linux_`` prefix, e.g. ``x86_64``.
+        The ``linux_`` prefix is assumed as a prerequisite for the current platform to
+        be musllinux-compatible.
 
     :returns: An iterator of compatible musllinux tags.
     """
     sys_musl = _get_musl_version(sys.executable)
     if sys_musl is None:  # Python not dynamically linked against musl.
         return
-    for minor in range(sys_musl.minor, -1, -1):
-        yield f"musllinux_{sys_musl.major}_{minor}_{arch}"
+    for arch in archs:
+        for minor in range(sys_musl.minor, -1, -1):
+            yield f"musllinux_{sys_musl.major}_{minor}_{arch}"
 
 
 if __name__ == "__main__":  # pragma: no cover
diff --git a/lib/packaging/_parser.py b/lib/packaging/_parser.py
index 5a18b758..684df754 100644
--- a/lib/packaging/_parser.py
+++ b/lib/packaging/_parser.py
@@ -252,7 +252,13 @@ def _parse_version_many(tokenizer: Tokenizer) -> str:
 # Recursive descent parser for marker expression
 # --------------------------------------------------------------------------------------
 def parse_marker(source: str) -> MarkerList:
-    return _parse_marker(Tokenizer(source, rules=DEFAULT_RULES))
+    return _parse_full_marker(Tokenizer(source, rules=DEFAULT_RULES))
+
+
+def _parse_full_marker(tokenizer: Tokenizer) -> MarkerList:
+    retval = _parse_marker(tokenizer)
+    tokenizer.expect("END", expected="end of marker expression")
+    return retval
 
 
 def _parse_marker(tokenizer: Tokenizer) -> MarkerList:
@@ -318,10 +324,7 @@ def _parse_marker_var(tokenizer: Tokenizer) -> MarkerVar:
 
 
 def process_env_var(env_var: str) -> Variable:
-    if (
-        env_var == "platform_python_implementation"
-        or env_var == "python_implementation"
-    ):
+    if env_var in ("platform_python_implementation", "python_implementation"):
         return Variable("platform_python_implementation")
     else:
         return Variable(env_var)
diff --git a/lib/packaging/metadata.py b/lib/packaging/metadata.py
index e76a60c3..fb274930 100644
--- a/lib/packaging/metadata.py
+++ b/lib/packaging/metadata.py
@@ -5,23 +5,77 @@ import email.parser
 import email.policy
 import sys
 import typing
-from typing import Dict, List, Optional, Tuple, Union, cast
+from typing import (
+    Any,
+    Callable,
+    Dict,
+    Generic,
+    List,
+    Optional,
+    Tuple,
+    Type,
+    Union,
+    cast,
+)
 
-if sys.version_info >= (3, 8):  # pragma: no cover
-    from typing import TypedDict
+from . import requirements, specifiers, utils, version as version_module
+
+T = typing.TypeVar("T")
+if sys.version_info[:2] >= (3, 8):  # pragma: no cover
+    from typing import Literal, TypedDict
 else:  # pragma: no cover
     if typing.TYPE_CHECKING:
-        from typing_extensions import TypedDict
+        from typing_extensions import Literal, TypedDict
     else:
         try:
-            from typing_extensions import TypedDict
+            from typing_extensions import Literal, TypedDict
         except ImportError:
 
+            class Literal:
+                def __init_subclass__(*_args, **_kwargs):
+                    pass
+
             class TypedDict:
                 def __init_subclass__(*_args, **_kwargs):
                     pass
 
 
+try:
+    ExceptionGroup
+except NameError:  # pragma: no cover
+
+    class ExceptionGroup(Exception):  # noqa: N818
+        """A minimal implementation of :external:exc:`ExceptionGroup` from Python 3.11.
+
+        If :external:exc:`ExceptionGroup` is already defined by Python itself,
+        that version is used instead.
+        """
+
+        message: str
+        exceptions: List[Exception]
+
+        def __init__(self, message: str, exceptions: List[Exception]) -> None:
+            self.message = message
+            self.exceptions = exceptions
+
+        def __repr__(self) -> str:
+            return f"{self.__class__.__name__}({self.message!r}, {self.exceptions!r})"
+
+else:  # pragma: no cover
+    ExceptionGroup = ExceptionGroup
+
+
+class InvalidMetadata(ValueError):
+    """A metadata field contains invalid data."""
+
+    field: str
+    """The name of the field that contains invalid data."""
+
+    def __init__(self, field: str, message: str) -> None:
+        self.field = field
+        super().__init__(message)
+
+
 # The RawMetadata class attempts to make as few assumptions about the underlying
 # serialization formats as possible. The idea is that as long as a serialization
 # formats offer some very basic primitives in *some* way then we can support
@@ -33,7 +87,8 @@ class RawMetadata(TypedDict, total=False):
     provided). The key is lower-case and underscores are used instead of dashes
     compared to the equivalent core metadata field. Any core metadata field that
     can be specified multiple times or can hold multiple values in a single
-    field have a key with a plural name.
+    field have a key with a plural name. See :class:`Metadata` whose attributes
+    match the keys of this dictionary.
 
     Core metadata fields that can be specified multiple times are stored as a
     list or dict depending on which is appropriate for the field. Any fields
@@ -77,7 +132,7 @@ class RawMetadata(TypedDict, total=False):
     # but got stuck without ever being able to build consensus on
     # it and ultimately ended up withdrawn.
     #
-    # However, a number of tools had started emiting METADATA with
+    # However, a number of tools had started emitting METADATA with
     # `2.0` Metadata-Version, so for historical reasons, this version
     # was skipped.
 
@@ -110,7 +165,7 @@ _STRING_FIELDS = {
     "version",
 }
 
-_LIST_STRING_FIELDS = {
+_LIST_FIELDS = {
     "classifiers",
     "dynamic",
     "obsoletes",
@@ -125,6 +180,10 @@ _LIST_STRING_FIELDS = {
     "supported_platforms",
 }
 
+_DICT_FIELDS = {
+    "project_urls",
+}
+
 
 def _parse_keywords(data: str) -> List[str]:
     """Split a string of comma-separate keyboards into a list of keywords."""
@@ -230,10 +289,11 @@ _EMAIL_TO_RAW_MAPPING = {
     "supported-platform": "supported_platforms",
     "version": "version",
 }
+_RAW_TO_EMAIL_MAPPING = {raw: email for email, raw in _EMAIL_TO_RAW_MAPPING.items()}
 
 
 def parse_email(data: Union[bytes, str]) -> Tuple[RawMetadata, Dict[str, List[str]]]:
-    """Parse a distribution's metadata.
+    """Parse a distribution's metadata stored as email headers (e.g. from ``METADATA``).
 
     This function returns a two-item tuple of dicts. The first dict is of
     recognized fields from the core metadata specification. Fields that can be
@@ -267,7 +327,7 @@ def parse_email(data: Union[bytes, str]) -> Tuple[RawMetadata, Dict[str, List[st
         # We use get_all() here, even for fields that aren't multiple use,
         # because otherwise someone could have e.g. two Name fields, and we
         # would just silently ignore it rather than doing something about it.
-        headers = parsed.get_all(name)
+        headers = parsed.get_all(name) or []
 
         # The way the email module works when parsing bytes is that it
         # unconditionally decodes the bytes as ascii using the surrogateescape
@@ -349,7 +409,7 @@ def parse_email(data: Union[bytes, str]) -> Tuple[RawMetadata, Dict[str, List[st
         # If this is one of our list of string fields, then we can just assign
         # the value, since email *only* has strings, and our get_all() call
         # above ensures that this is a list.
-        elif raw_name in _LIST_STRING_FIELDS:
+        elif raw_name in _LIST_FIELDS:
             raw[raw_name] = value
         # Special Case: Keywords
         # The keywords field is implemented in the metadata spec as a str,
@@ -406,3 +466,360 @@ def parse_email(data: Union[bytes, str]) -> Tuple[RawMetadata, Dict[str, List[st
     # way this function is implemented, our `TypedDict` can only have valid key
     # names.
     return cast(RawMetadata, raw), unparsed
+
+
+_NOT_FOUND = object()
+
+
+# Keep the two values in sync.
+_VALID_METADATA_VERSIONS = ["1.0", "1.1", "1.2", "2.1", "2.2", "2.3"]
+_MetadataVersion = Literal["1.0", "1.1", "1.2", "2.1", "2.2", "2.3"]
+
+_REQUIRED_ATTRS = frozenset(["metadata_version", "name", "version"])
+
+
+class _Validator(Generic[T]):
+    """Validate a metadata field.
+
+    All _process_*() methods correspond to a core metadata field. The method is
+    called with the field's raw value. If the raw value is valid it is returned
+    in its "enriched" form (e.g. ``version.Version`` for the ``Version`` field).
+    If the raw value is invalid, :exc:`InvalidMetadata` is raised (with a cause
+    as appropriate).
+    """
+
+    name: str
+    raw_name: str
+    added: _MetadataVersion
+
+    def __init__(
+        self,
+        *,
+        added: _MetadataVersion = "1.0",
+    ) -> None:
+        self.added = added
+
+    def __set_name__(self, _owner: "Metadata", name: str) -> None:
+        self.name = name
+        self.raw_name = _RAW_TO_EMAIL_MAPPING[name]
+
+    def __get__(self, instance: "Metadata", _owner: Type["Metadata"]) -> T:
+        # With Python 3.8, the caching can be replaced with functools.cached_property().
+        # No need to check the cache as attribute lookup will resolve into the
+        # instance's __dict__ before __get__ is called.
+        cache = instance.__dict__
+        value = instance._raw.get(self.name)
+
+        # To make the _process_* methods easier, we'll check if the value is None
+        # and if this field is NOT a required attribute, and if both of those
+        # things are true, we'll skip the the converter. This will mean that the
+        # converters never have to deal with the None union.
+        if self.name in _REQUIRED_ATTRS or value is not None:
+            try:
+                converter: Callable[[Any], T] = getattr(self, f"_process_{self.name}")
+            except AttributeError:
+                pass
+            else:
+                value = converter(value)
+
+        cache[self.name] = value
+        try:
+            del instance._raw[self.name]  # type: ignore[misc]
+        except KeyError:
+            pass
+
+        return cast(T, value)
+
+    def _invalid_metadata(
+        self, msg: str, cause: Optional[Exception] = None
+    ) -> InvalidMetadata:
+        exc = InvalidMetadata(
+            self.raw_name, msg.format_map({"field": repr(self.raw_name)})
+        )
+        exc.__cause__ = cause
+        return exc
+
+    def _process_metadata_version(self, value: str) -> _MetadataVersion:
+        # Implicitly makes Metadata-Version required.
+        if value not in _VALID_METADATA_VERSIONS:
+            raise self._invalid_metadata(f"{value!r} is not a valid metadata version")
+        return cast(_MetadataVersion, value)
+
+    def _process_name(self, value: str) -> str:
+        if not value:
+            raise self._invalid_metadata("{field} is a required field")
+        # Validate the name as a side-effect.
+        try:
+            utils.canonicalize_name(value, validate=True)
+        except utils.InvalidName as exc:
+            raise self._invalid_metadata(
+                f"{value!r} is invalid for {{field}}", cause=exc
+            )
+        else:
+            return value
+
+    def _process_version(self, value: str) -> version_module.Version:
+        if not value:
+            raise self._invalid_metadata("{field} is a required field")
+        try:
+            return version_module.parse(value)
+        except version_module.InvalidVersion as exc:
+            raise self._invalid_metadata(
+                f"{value!r} is invalid for {{field}}", cause=exc
+            )
+
+    def _process_summary(self, value: str) -> str:
+        """Check the field contains no newlines."""
+        if "\n" in value:
+            raise self._invalid_metadata("{field} must be a single line")
+        return value
+
+    def _process_description_content_type(self, value: str) -> str:
+        content_types = {"text/plain", "text/x-rst", "text/markdown"}
+        message = email.message.EmailMessage()
+        message["content-type"] = value
+
+        content_type, parameters = (
+            # Defaults to `text/plain` if parsing failed.
+            message.get_content_type().lower(),
+            message["content-type"].params,
+        )
+        # Check if content-type is valid or defaulted to `text/plain` and thus was
+        # not parseable.
+        if content_type not in content_types or content_type not in value.lower():
+            raise self._invalid_metadata(
+                f"{{field}} must be one of {list(content_types)}, not {value!r}"
+            )
+
+        charset = parameters.get("charset", "UTF-8")
+        if charset != "UTF-8":
+            raise self._invalid_metadata(
+                f"{{field}} can only specify the UTF-8 charset, not {list(charset)}"
+            )
+
+        markdown_variants = {"GFM", "CommonMark"}
+        variant = parameters.get("variant", "GFM")  # Use an acceptable default.
+        if content_type == "text/markdown" and variant not in markdown_variants:
+            raise self._invalid_metadata(
+                f"valid Markdown variants for {{field}} are {list(markdown_variants)}, "
+                f"not {variant!r}",
+            )
+        return value
+
+    def _process_dynamic(self, value: List[str]) -> List[str]:
+        for dynamic_field in map(str.lower, value):
+            if dynamic_field in {"name", "version", "metadata-version"}:
+                raise self._invalid_metadata(
+                    f"{value!r} is not allowed as a dynamic field"
+                )
+            elif dynamic_field not in _EMAIL_TO_RAW_MAPPING:
+                raise self._invalid_metadata(f"{value!r} is not a valid dynamic field")
+        return list(map(str.lower, value))
+
+    def _process_provides_extra(
+        self,
+        value: List[str],
+    ) -> List[utils.NormalizedName]:
+        normalized_names = []
+        try:
+            for name in value:
+                normalized_names.append(utils.canonicalize_name(name, validate=True))
+        except utils.InvalidName as exc:
+            raise self._invalid_metadata(
+                f"{name!r} is invalid for {{field}}", cause=exc
+            )
+        else:
+            return normalized_names
+
+    def _process_requires_python(self, value: str) -> specifiers.SpecifierSet:
+        try:
+            return specifiers.SpecifierSet(value)
+        except specifiers.InvalidSpecifier as exc:
+            raise self._invalid_metadata(
+                f"{value!r} is invalid for {{field}}", cause=exc
+            )
+
+    def _process_requires_dist(
+        self,
+        value: List[str],
+    ) -> List[requirements.Requirement]:
+        reqs = []
+        try:
+            for req in value:
+                reqs.append(requirements.Requirement(req))
+        except requirements.InvalidRequirement as exc:
+            raise self._invalid_metadata(f"{req!r} is invalid for {{field}}", cause=exc)
+        else:
+            return reqs
+
+
+class Metadata:
+    """Representation of distribution metadata.
+
+    Compared to :class:`RawMetadata`, this class provides objects representing
+    metadata fields instead of only using built-in types. Any invalid metadata
+    will cause :exc:`InvalidMetadata` to be raised (with a
+    :py:attr:`~BaseException.__cause__` attribute as appropriate).
+    """
+
+    _raw: RawMetadata
+
+    @classmethod
+    def from_raw(cls, data: RawMetadata, *, validate: bool = True) -> "Metadata":
+        """Create an instance from :class:`RawMetadata`.
+
+        If *validate* is true, all metadata will be validated. All exceptions
+        related to validation will be gathered and raised as an :class:`ExceptionGroup`.
+        """
+        ins = cls()
+        ins._raw = data.copy()  # Mutations occur due to caching enriched values.
+
+        if validate:
+            exceptions: List[Exception] = []
+            try:
+                metadata_version = ins.metadata_version
+                metadata_age = _VALID_METADATA_VERSIONS.index(metadata_version)
+            except InvalidMetadata as metadata_version_exc:
+                exceptions.append(metadata_version_exc)
+                metadata_version = None
+
+            # Make sure to check for the fields that are present, the required
+            # fields (so their absence can be reported).
+            fields_to_check = frozenset(ins._raw) | _REQUIRED_ATTRS
+            # Remove fields that have already been checked.
+            fields_to_check -= {"metadata_version"}
+
+            for key in fields_to_check:
+                try:
+                    if metadata_version:
+                        # Can't use getattr() as that triggers descriptor protocol which
+                        # will fail due to no value for the instance argument.
+                        try:
+                            field_metadata_version = cls.__dict__[key].added
+                        except KeyError:
+                            exc = InvalidMetadata(key, f"unrecognized field: {key!r}")
+                            exceptions.append(exc)
+                            continue
+                        field_age = _VALID_METADATA_VERSIONS.index(
+                            field_metadata_version
+                        )
+                        if field_age > metadata_age:
+                            field = _RAW_TO_EMAIL_MAPPING[key]
+                            exc = InvalidMetadata(
+                                field,
+                                "{field} introduced in metadata version "
+                                "{field_metadata_version}, not {metadata_version}",
+                            )
+                            exceptions.append(exc)
+                            continue
+                    getattr(ins, key)
+                except InvalidMetadata as exc:
+                    exceptions.append(exc)
+
+            if exceptions:
+                raise ExceptionGroup("invalid metadata", exceptions)
+
+        return ins
+
+    @classmethod
+    def from_email(
+        cls, data: Union[bytes, str], *, validate: bool = True
+    ) -> "Metadata":
+        """Parse metadata from email headers.
+
+        If *validate* is true, the metadata will be validated. All exceptions
+        related to validation will be gathered and raised as an :class:`ExceptionGroup`.
+        """
+        raw, unparsed = parse_email(data)
+
+        if validate:
+            exceptions: list[Exception] = []
+            for unparsed_key in unparsed:
+                if unparsed_key in _EMAIL_TO_RAW_MAPPING:
+                    message = f"{unparsed_key!r} has invalid data"
+                else:
+                    message = f"unrecognized field: {unparsed_key!r}"
+                exceptions.append(InvalidMetadata(unparsed_key, message))
+
+            if exceptions:
+                raise ExceptionGroup("unparsed", exceptions)
+
+        try:
+            return cls.from_raw(raw, validate=validate)
+        except ExceptionGroup as exc_group:
+            raise ExceptionGroup(
+                "invalid or unparsed metadata", exc_group.exceptions
+            ) from None
+
+    metadata_version: _Validator[_MetadataVersion] = _Validator()
+    """:external:ref:`core-metadata-metadata-version`
+    (required; validated to be a valid metadata version)"""
+    name: _Validator[str] = _Validator()
+    """:external:ref:`core-metadata-name`
+    (required; validated using :func:`~packaging.utils.canonicalize_name` and its
+    *validate* parameter)"""
+    version: _Validator[version_module.Version] = _Validator()
+    """:external:ref:`core-metadata-version` (required)"""
+    dynamic: _Validator[Optional[List[str]]] = _Validator(
+        added="2.2",
+    )
+    """:external:ref:`core-metadata-dynamic`
+    (validated against core metadata field names and lowercased)"""
+    platforms: _Validator[Optional[List[str]]] = _Validator()
+    """:external:ref:`core-metadata-platform`"""
+    supported_platforms: _Validator[Optional[List[str]]] = _Validator(added="1.1")
+    """:external:ref:`core-metadata-supported-platform`"""
+    summary: _Validator[Optional[str]] = _Validator()
+    """:external:ref:`core-metadata-summary` (validated to contain no newlines)"""
+    description: _Validator[Optional[str]] = _Validator()  # TODO 2.1: can be in body
+    """:external:ref:`core-metadata-description`"""
+    description_content_type: _Validator[Optional[str]] = _Validator(added="2.1")
+    """:external:ref:`core-metadata-description-content-type` (validated)"""
+    keywords: _Validator[Optional[List[str]]] = _Validator()
+    """:external:ref:`core-metadata-keywords`"""
+    home_page: _Validator[Optional[str]] = _Validator()
+    """:external:ref:`core-metadata-home-page`"""
+    download_url: _Validator[Optional[str]] = _Validator(added="1.1")
+    """:external:ref:`core-metadata-download-url`"""
+    author: _Validator[Optional[str]] = _Validator()
+    """:external:ref:`core-metadata-author`"""
+    author_email: _Validator[Optional[str]] = _Validator()
+    """:external:ref:`core-metadata-author-email`"""
+    maintainer: _Validator[Optional[str]] = _Validator(added="1.2")
+    """:external:ref:`core-metadata-maintainer`"""
+    maintainer_email: _Validator[Optional[str]] = _Validator(added="1.2")
+    """:external:ref:`core-metadata-maintainer-email`"""
+    license: _Validator[Optional[str]] = _Validator()
+    """:external:ref:`core-metadata-license`"""
+    classifiers: _Validator[Optional[List[str]]] = _Validator(added="1.1")
+    """:external:ref:`core-metadata-classifier`"""
+    requires_dist: _Validator[Optional[List[requirements.Requirement]]] = _Validator(
+        added="1.2"
+    )
+    """:external:ref:`core-metadata-requires-dist`"""
+    requires_python: _Validator[Optional[specifiers.SpecifierSet]] = _Validator(
+        added="1.2"
+    )
+    """:external:ref:`core-metadata-requires-python`"""
+    # Because `Requires-External` allows for non-PEP 440 version specifiers, we
+    # don't do any processing on the values.
+    requires_external: _Validator[Optional[List[str]]] = _Validator(added="1.2")
+    """:external:ref:`core-metadata-requires-external`"""
+    project_urls: _Validator[Optional[Dict[str, str]]] = _Validator(added="1.2")
+    """:external:ref:`core-metadata-project-url`"""
+    # PEP 685 lets us raise an error if an extra doesn't pass `Name` validation
+    # regardless of metadata version.
+    provides_extra: _Validator[Optional[List[utils.NormalizedName]]] = _Validator(
+        added="2.1",
+    )
+    """:external:ref:`core-metadata-provides-extra`"""
+    provides_dist: _Validator[Optional[List[str]]] = _Validator(added="1.2")
+    """:external:ref:`core-metadata-provides-dist`"""
+    obsoletes_dist: _Validator[Optional[List[str]]] = _Validator(added="1.2")
+    """:external:ref:`core-metadata-obsoletes-dist`"""
+    requires: _Validator[Optional[List[str]]] = _Validator(added="1.1")
+    """``Requires`` (deprecated)"""
+    provides: _Validator[Optional[List[str]]] = _Validator(added="1.1")
+    """``Provides`` (deprecated)"""
+    obsoletes: _Validator[Optional[List[str]]] = _Validator(added="1.1")
+    """``Obsoletes`` (deprecated)"""
diff --git a/lib/packaging/requirements.py b/lib/packaging/requirements.py
index f34bfa85..bdc43a7e 100644
--- a/lib/packaging/requirements.py
+++ b/lib/packaging/requirements.py
@@ -2,13 +2,13 @@
 # 2.0, and the BSD License. See the LICENSE file in the root of this repository
 # for complete details.
 
-import urllib.parse
-from typing import Any, List, Optional, Set
+from typing import Any, Iterator, Optional, Set
 
 from ._parser import parse_requirement as _parse_requirement
 from ._tokenizer import ParserSyntaxError
 from .markers import Marker, _normalize_extra_values
 from .specifiers import SpecifierSet
+from .utils import canonicalize_name
 
 
 class InvalidRequirement(ValueError):
@@ -37,57 +37,52 @@ class Requirement:
             raise InvalidRequirement(str(e)) from e
 
         self.name: str = parsed.name
-        if parsed.url:
-            parsed_url = urllib.parse.urlparse(parsed.url)
-            if parsed_url.scheme == "file":
-                if urllib.parse.urlunparse(parsed_url) != parsed.url:
-                    raise InvalidRequirement("Invalid URL given")
-            elif not (parsed_url.scheme and parsed_url.netloc) or (
-                not parsed_url.scheme and not parsed_url.netloc
-            ):
-                raise InvalidRequirement(f"Invalid URL: {parsed.url}")
-            self.url: Optional[str] = parsed.url
-        else:
-            self.url = None
-        self.extras: Set[str] = set(parsed.extras if parsed.extras else [])
+        self.url: Optional[str] = parsed.url or None
+        self.extras: Set[str] = set(parsed.extras or [])
         self.specifier: SpecifierSet = SpecifierSet(parsed.specifier)
         self.marker: Optional[Marker] = None
         if parsed.marker is not None:
             self.marker = Marker.__new__(Marker)
             self.marker._markers = _normalize_extra_values(parsed.marker)
 
-    def __str__(self) -> str:
-        parts: List[str] = [self.name]
+    def _iter_parts(self, name: str) -> Iterator[str]:
+        yield name
 
         if self.extras:
             formatted_extras = ",".join(sorted(self.extras))
-            parts.append(f"[{formatted_extras}]")
+            yield f"[{formatted_extras}]"
 
         if self.specifier:
-            parts.append(str(self.specifier))
+            yield str(self.specifier)
 
         if self.url:
-            parts.append(f"@ {self.url}")
+            yield f"@ {self.url}"
             if self.marker:
-                parts.append(" ")
+                yield " "
 
         if self.marker:
-            parts.append(f"; {self.marker}")
+            yield f"; {self.marker}"
 
-        return "".join(parts)
+    def __str__(self) -> str:
+        return "".join(self._iter_parts(self.name))
 
     def __repr__(self) -> str:
         return f"<Requirement('{self}')>"
 
     def __hash__(self) -> int:
-        return hash((self.__class__.__name__, str(self)))
+        return hash(
+            (
+                self.__class__.__name__,
+                *self._iter_parts(canonicalize_name(self.name)),
+            )
+        )
 
     def __eq__(self, other: Any) -> bool:
         if not isinstance(other, Requirement):
             return NotImplemented
 
         return (
-            self.name == other.name
+            canonicalize_name(self.name) == canonicalize_name(other.name)
             and self.extras == other.extras
             and self.specifier == other.specifier
             and self.url == other.url
diff --git a/lib/packaging/specifiers.py b/lib/packaging/specifiers.py
index ba8fe37b..2d015bab 100644
--- a/lib/packaging/specifiers.py
+++ b/lib/packaging/specifiers.py
@@ -11,17 +11,7 @@
 import abc
 import itertools
 import re
-from typing import (
-    Callable,
-    Iterable,
-    Iterator,
-    List,
-    Optional,
-    Set,
-    Tuple,
-    TypeVar,
-    Union,
-)
+from typing import Callable, Iterable, Iterator, List, Optional, Tuple, TypeVar, Union
 
 from .utils import canonicalize_version
 from .version import Version
@@ -383,7 +373,7 @@ class Specifier(BaseSpecifier):
 
         # We want everything but the last item in the version, but we want to
         # ignore suffix segments.
-        prefix = ".".join(
+        prefix = _version_join(
             list(itertools.takewhile(_is_not_suffix, _version_split(spec)))[:-1]
         )
 
@@ -404,13 +394,13 @@ class Specifier(BaseSpecifier):
             )
             # Get the normalized version string ignoring the trailing .*
             normalized_spec = canonicalize_version(spec[:-2], strip_trailing_zero=False)
-            # Split the spec out by dots, and pretend that there is an implicit
-            # dot in between a release segment and a pre-release segment.
+            # Split the spec out by bangs and dots, and pretend that there is
+            # an implicit dot in between a release segment and a pre-release segment.
             split_spec = _version_split(normalized_spec)
 
-            # Split the prospective version out by dots, and pretend that there
-            # is an implicit dot in between a release segment and a pre-release
-            # segment.
+            # Split the prospective version out by bangs and dots, and pretend
+            # that there is an implicit dot in between a release segment and
+            # a pre-release segment.
             split_prospective = _version_split(normalized_prospective)
 
             # 0-pad the prospective version before shortening it to get the correct
@@ -644,8 +634,19 @@ _prefix_regex = re.compile(r"^([0-9]+)((?:a|b|c|rc)[0-9]+)$")
 
 
 def _version_split(version: str) -> List[str]:
+    """Split version into components.
+
+    The split components are intended for version comparison. The logic does
+    not attempt to retain the original version string, so joining the
+    components back with :func:`_version_join` may not produce the original
+    version string.
+    """
     result: List[str] = []
-    for item in version.split("."):
+
+    epoch, _, rest = version.rpartition("!")
+    result.append(epoch or "0")
+
+    for item in rest.split("."):
         match = _prefix_regex.search(item)
         if match:
             result.extend(match.groups())
@@ -654,6 +655,17 @@ def _version_split(version: str) -> List[str]:
     return result
 
 
+def _version_join(components: List[str]) -> str:
+    """Join split version components into a version string.
+
+    This function assumes the input came from :func:`_version_split`, where the
+    first component must be the epoch (either empty or numeric), and all other
+    components numeric.
+    """
+    epoch, *rest = components
+    return f"{epoch}!{'.'.join(rest)}"
+
+
 def _is_not_suffix(segment: str) -> bool:
     return not any(
         segment.startswith(prefix) for prefix in ("dev", "a", "b", "rc", "post")
@@ -675,7 +687,10 @@ def _pad_version(left: List[str], right: List[str]) -> Tuple[List[str], List[str
     left_split.insert(1, ["0"] * max(0, len(right_split[0]) - len(left_split[0])))
     right_split.insert(1, ["0"] * max(0, len(left_split[0]) - len(right_split[0])))
 
-    return (list(itertools.chain(*left_split)), list(itertools.chain(*right_split)))
+    return (
+        list(itertools.chain.from_iterable(left_split)),
+        list(itertools.chain.from_iterable(right_split)),
+    )
 
 
 class SpecifierSet(BaseSpecifier):
@@ -707,14 +722,8 @@ class SpecifierSet(BaseSpecifier):
         # strip each item to remove leading/trailing whitespace.
         split_specifiers = [s.strip() for s in specifiers.split(",") if s.strip()]
 
-        # Parsed each individual specifier, attempting first to make it a
-        # Specifier.
-        parsed: Set[Specifier] = set()
-        for specifier in split_specifiers:
-            parsed.add(Specifier(specifier))
-
-        # Turn our parsed specifiers into a frozen set and save them for later.
-        self._specs = frozenset(parsed)
+        # Make each individual specifier a Specifier and save in a frozen set for later.
+        self._specs = frozenset(map(Specifier, split_specifiers))
 
         # Store our prereleases value so we can use it later to determine if
         # we accept prereleases or not.
diff --git a/lib/packaging/tags.py b/lib/packaging/tags.py
index 76d24341..89f19261 100644
--- a/lib/packaging/tags.py
+++ b/lib/packaging/tags.py
@@ -4,6 +4,8 @@
 
 import logging
 import platform
+import re
+import struct
 import subprocess
 import sys
 import sysconfig
@@ -37,7 +39,7 @@ INTERPRETER_SHORT_NAMES: Dict[str, str] = {
 }
 
 
-_32_BIT_INTERPRETER = sys.maxsize <= 2**32
+_32_BIT_INTERPRETER = struct.calcsize("P") == 4
 
 
 class Tag:
@@ -123,20 +125,37 @@ def _normalize_string(string: str) -> str:
     return string.replace(".", "_").replace("-", "_").replace(" ", "_")
 
 
-def _abi3_applies(python_version: PythonVersion) -> bool:
+def _is_threaded_cpython(abis: List[str]) -> bool:
+    """
+    Determine if the ABI corresponds to a threaded (`--disable-gil`) build.
+
+    The threaded builds are indicated by a "t" in the abiflags.
+    """
+    if len(abis) == 0:
+        return False
+    # expect e.g., cp313
+    m = re.match(r"cp\d+(.*)", abis[0])
+    if not m:
+        return False
+    abiflags = m.group(1)
+    return "t" in abiflags
+
+
+def _abi3_applies(python_version: PythonVersion, threading: bool) -> bool:
     """
     Determine if the Python version supports abi3.
 
-    PEP 384 was first implemented in Python 3.2.
+    PEP 384 was first implemented in Python 3.2. The threaded (`--disable-gil`)
+    builds do not support abi3.
     """
-    return len(python_version) > 1 and tuple(python_version) >= (3, 2)
+    return len(python_version) > 1 and tuple(python_version) >= (3, 2) and not threading
 
 
 def _cpython_abis(py_version: PythonVersion, warn: bool = False) -> List[str]:
     py_version = tuple(py_version)  # To allow for version comparison.
     abis = []
     version = _version_nodot(py_version[:2])
-    debug = pymalloc = ucs4 = ""
+    threading = debug = pymalloc = ucs4 = ""
     with_debug = _get_config_var("Py_DEBUG", warn)
     has_refcount = hasattr(sys, "gettotalrefcount")
     # Windows doesn't set Py_DEBUG, so checking for support of debug-compiled
@@ -145,6 +164,8 @@ def _cpython_abis(py_version: PythonVersion, warn: bool = False) -> List[str]:
     has_ext = "_d.pyd" in EXTENSION_SUFFIXES
     if with_debug or (with_debug is None and (has_refcount or has_ext)):
         debug = "d"
+    if py_version >= (3, 13) and _get_config_var("Py_GIL_DISABLED", warn):
+        threading = "t"
     if py_version < (3, 8):
         with_pymalloc = _get_config_var("WITH_PYMALLOC", warn)
         if with_pymalloc or with_pymalloc is None:
@@ -158,13 +179,8 @@ def _cpython_abis(py_version: PythonVersion, warn: bool = False) -> List[str]:
     elif debug:
         # Debug builds can also load "normal" extension modules.
         # We can also assume no UCS-4 or pymalloc requirement.
-        abis.append(f"cp{version}")
-    abis.insert(
-        0,
-        "cp{version}{debug}{pymalloc}{ucs4}".format(
-            version=version, debug=debug, pymalloc=pymalloc, ucs4=ucs4
-        ),
-    )
+        abis.append(f"cp{version}{threading}")
+    abis.insert(0, f"cp{version}{threading}{debug}{pymalloc}{ucs4}")
     return abis
 
 
@@ -212,11 +228,14 @@ def cpython_tags(
     for abi in abis:
         for platform_ in platforms:
             yield Tag(interpreter, abi, platform_)
-    if _abi3_applies(python_version):
+
+    threading = _is_threaded_cpython(abis)
+    use_abi3 = _abi3_applies(python_version, threading)
+    if use_abi3:
         yield from (Tag(interpreter, "abi3", platform_) for platform_ in platforms)
     yield from (Tag(interpreter, "none", platform_) for platform_ in platforms)
 
-    if _abi3_applies(python_version):
+    if use_abi3:
         for minor_version in range(python_version[1] - 1, 1, -1):
             for platform_ in platforms:
                 interpreter = "cp{version}".format(
@@ -406,7 +425,7 @@ def mac_platforms(
                 check=True,
                 env={"SYSTEM_VERSION_COMPAT": "0"},
                 stdout=subprocess.PIPE,
-                universal_newlines=True,
+                text=True,
             ).stdout
             version = cast("MacVersion", tuple(map(int, version_str.split(".")[:2])))
     else:
@@ -469,15 +488,21 @@ def mac_platforms(
 
 def _linux_platforms(is_32bit: bool = _32_BIT_INTERPRETER) -> Iterator[str]:
     linux = _normalize_string(sysconfig.get_platform())
+    if not linux.startswith("linux_"):
+        # we should never be here, just yield the sysconfig one and return
+        yield linux
+        return
     if is_32bit:
         if linux == "linux_x86_64":
             linux = "linux_i686"
         elif linux == "linux_aarch64":
-            linux = "linux_armv7l"
+            linux = "linux_armv8l"
     _, arch = linux.split("_", 1)
-    yield from _manylinux.platform_tags(linux, arch)
-    yield from _musllinux.platform_tags(arch)
-    yield linux
+    archs = {"armv8l": ["armv8l", "armv7l"]}.get(arch, [arch])
+    yield from _manylinux.platform_tags(archs)
+    yield from _musllinux.platform_tags(archs)
+    for arch in archs:
+        yield f"linux_{arch}"
 
 
 def _generic_platforms() -> Iterator[str]:
diff --git a/lib/packaging/utils.py b/lib/packaging/utils.py
index 33c613b7..c2c2f75a 100644
--- a/lib/packaging/utils.py
+++ b/lib/packaging/utils.py
@@ -12,6 +12,12 @@ BuildTag = Union[Tuple[()], Tuple[int, str]]
 NormalizedName = NewType("NormalizedName", str)
 
 
+class InvalidName(ValueError):
+    """
+    An invalid distribution name; users should refer to the packaging user guide.
+    """
+
+
 class InvalidWheelFilename(ValueError):
     """
     An invalid wheel filename was found, users should refer to PEP 427.
@@ -24,17 +30,28 @@ class InvalidSdistFilename(ValueError):
     """
 
 
+# Core metadata spec for `Name`
+_validate_regex = re.compile(
+    r"^([A-Z0-9]|[A-Z0-9][A-Z0-9._-]*[A-Z0-9])$", re.IGNORECASE
+)
 _canonicalize_regex = re.compile(r"[-_.]+")
+_normalized_regex = re.compile(r"^([a-z0-9]|[a-z0-9]([a-z0-9-](?!--))*[a-z0-9])$")
 # PEP 427: The build number must start with a digit.
 _build_tag_regex = re.compile(r"(\d+)(.*)")
 
 
-def canonicalize_name(name: str) -> NormalizedName:
+def canonicalize_name(name: str, *, validate: bool = False) -> NormalizedName:
+    if validate and not _validate_regex.match(name):
+        raise InvalidName(f"name is invalid: {name!r}")
     # This is taken from PEP 503.
     value = _canonicalize_regex.sub("-", name).lower()
     return cast(NormalizedName, value)
 
 
+def is_normalized_name(name: str) -> bool:
+    return _normalized_regex.match(name) is not None
+
+
 def canonicalize_version(
     version: Union[Version, str], *, strip_trailing_zero: bool = True
 ) -> str:
@@ -100,11 +117,18 @@ def parse_wheel_filename(
 
     parts = filename.split("-", dashes - 2)
     name_part = parts[0]
-    # See PEP 427 for the rules on escaping the project name
+    # See PEP 427 for the rules on escaping the project name.
     if "__" in name_part or re.match(r"^[\w\d._]*$", name_part, re.UNICODE) is None:
         raise InvalidWheelFilename(f"Invalid project name: {filename}")
     name = canonicalize_name(name_part)
-    version = Version(parts[1])
+
+    try:
+        version = Version(parts[1])
+    except InvalidVersion as e:
+        raise InvalidWheelFilename(
+            f"Invalid wheel filename (invalid version): {filename}"
+        ) from e
+
     if dashes == 5:
         build_part = parts[2]
         build_match = _build_tag_regex.match(build_part)
@@ -137,5 +161,12 @@ def parse_sdist_filename(filename: str) -> Tuple[NormalizedName, Version]:
         raise InvalidSdistFilename(f"Invalid sdist filename: {filename}")
 
     name = canonicalize_name(name_part)
-    version = Version(version_part)
+
+    try:
+        version = Version(version_part)
+    except InvalidVersion as e:
+        raise InvalidSdistFilename(
+            f"Invalid sdist filename (invalid version): {filename}"
+        ) from e
+
     return (name, version)
diff --git a/lib/packaging/version.py b/lib/packaging/version.py
index b30e8cbf..5faab9bd 100644
--- a/lib/packaging/version.py
+++ b/lib/packaging/version.py
@@ -7,37 +7,39 @@
     from packaging.version import parse, Version
 """
 
-import collections
 import itertools
 import re
-from typing import Any, Callable, Optional, SupportsInt, Tuple, Union
+from typing import Any, Callable, NamedTuple, Optional, SupportsInt, Tuple, Union
 
 from ._structures import Infinity, InfinityType, NegativeInfinity, NegativeInfinityType
 
 __all__ = ["VERSION_PATTERN", "parse", "Version", "InvalidVersion"]
 
-InfiniteTypes = Union[InfinityType, NegativeInfinityType]
-PrePostDevType = Union[InfiniteTypes, Tuple[str, int]]
-SubLocalType = Union[InfiniteTypes, int, str]
-LocalType = Union[
+LocalType = Tuple[Union[int, str], ...]
+
+CmpPrePostDevType = Union[InfinityType, NegativeInfinityType, Tuple[str, int]]
+CmpLocalType = Union[
     NegativeInfinityType,
-    Tuple[
-        Union[
-            SubLocalType,
-            Tuple[SubLocalType, str],
-            Tuple[NegativeInfinityType, SubLocalType],
-        ],
-        ...,
-    ],
+    Tuple[Union[Tuple[int, str], Tuple[NegativeInfinityType, Union[int, str]]], ...],
 ]
 CmpKey = Tuple[
-    int, Tuple[int, ...], PrePostDevType, PrePostDevType, PrePostDevType, LocalType
+    int,
+    Tuple[int, ...],
+    CmpPrePostDevType,
+    CmpPrePostDevType,
+    CmpPrePostDevType,
+    CmpLocalType,
 ]
 VersionComparisonMethod = Callable[[CmpKey, CmpKey], bool]
 
-_Version = collections.namedtuple(
-    "_Version", ["epoch", "release", "dev", "pre", "post", "local"]
-)
+
+class _Version(NamedTuple):
+    epoch: int
+    release: Tuple[int, ...]
+    dev: Optional[Tuple[str, int]]
+    pre: Optional[Tuple[str, int]]
+    post: Optional[Tuple[str, int]]
+    local: Optional[LocalType]
 
 
 def parse(version: str) -> "Version":
@@ -117,7 +119,7 @@ _VERSION_PATTERN = r"""
         (?P<release>[0-9]+(?:\.[0-9]+)*)                  # release segment
         (?P<pre>                                          # pre-release
             [-_\.]?
-            (?P<pre_l>(a|b|c|rc|alpha|beta|pre|preview))
+            (?P<pre_l>alpha|a|beta|b|preview|pre|c|rc)
             [-_\.]?
             (?P<pre_n>[0-9]+)?
         )?
@@ -269,8 +271,7 @@ class Version(_BaseVersion):
         >>> Version("1!2.0.0").epoch
         1
         """
-        _epoch: int = self._version.epoch
-        return _epoch
+        return self._version.epoch
 
     @property
     def release(self) -> Tuple[int, ...]:
@@ -286,8 +287,7 @@ class Version(_BaseVersion):
         Includes trailing zeroes but not the epoch or any pre-release / development /
         post-release suffixes.
         """
-        _release: Tuple[int, ...] = self._version.release
-        return _release
+        return self._version.release
 
     @property
     def pre(self) -> Optional[Tuple[str, int]]:
@@ -302,8 +302,7 @@ class Version(_BaseVersion):
         >>> Version("1.2.3rc1").pre
         ('rc', 1)
         """
-        _pre: Optional[Tuple[str, int]] = self._version.pre
-        return _pre
+        return self._version.pre
 
     @property
     def post(self) -> Optional[int]:
@@ -451,7 +450,7 @@ class Version(_BaseVersion):
 
 
 def _parse_letter_version(
-    letter: str, number: Union[str, bytes, SupportsInt]
+    letter: Optional[str], number: Union[str, bytes, SupportsInt, None]
 ) -> Optional[Tuple[str, int]]:
 
     if letter:
@@ -489,7 +488,7 @@ def _parse_letter_version(
 _local_version_separators = re.compile(r"[\._-]")
 
 
-def _parse_local_version(local: str) -> Optional[LocalType]:
+def _parse_local_version(local: Optional[str]) -> Optional[LocalType]:
     """
     Takes a string like abc.1.twelve and turns it into ("abc", 1, "twelve").
     """
@@ -507,7 +506,7 @@ def _cmpkey(
     pre: Optional[Tuple[str, int]],
     post: Optional[Tuple[str, int]],
     dev: Optional[Tuple[str, int]],
-    local: Optional[Tuple[SubLocalType]],
+    local: Optional[LocalType],
 ) -> CmpKey:
 
     # When we compare a release version, we want to compare it with all of the
@@ -524,7 +523,7 @@ def _cmpkey(
     # if there is not a pre or a post segment. If we have one of those then
     # the normal sorting rules will handle this case correctly.
     if pre is None and post is None and dev is not None:
-        _pre: PrePostDevType = NegativeInfinity
+        _pre: CmpPrePostDevType = NegativeInfinity
     # Versions without a pre-release (except as noted above) should sort after
     # those with one.
     elif pre is None:
@@ -534,21 +533,21 @@ def _cmpkey(
 
     # Versions without a post segment should sort before those with one.
     if post is None:
-        _post: PrePostDevType = NegativeInfinity
+        _post: CmpPrePostDevType = NegativeInfinity
 
     else:
         _post = post
 
     # Versions without a development segment should sort after those with one.
     if dev is None:
-        _dev: PrePostDevType = Infinity
+        _dev: CmpPrePostDevType = Infinity
 
     else:
         _dev = dev
 
     if local is None:
         # Versions without a local segment should sort before those with one.
-        _local: LocalType = NegativeInfinity
+        _local: CmpLocalType = NegativeInfinity
     else:
         # Versions with a local segment need that segment parsed to implement
         # the sorting rules in PEP440.
diff --git a/requirements.txt b/requirements.txt
index 0b009ea7..30d57ade 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -25,7 +25,7 @@ IPy==1.01
 Mako==1.3.2
 MarkupSafe==2.1.3
 musicbrainzngs==0.7.1
-packaging==23.1
+packaging==24.0
 paho-mqtt==1.6.1
 platformdirs==4.2.0
 plexapi==4.15.10

From 24fff60ed4d2878b7abef7f9a77bf438a873e817 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sun, 24 Mar 2024 15:27:03 -0700
Subject: [PATCH 542/743] Bump zipp from 3.16.2 to 3.18.1 (#2281)

* Bump zipp from 3.16.2 to 3.18.1

Bumps [zipp](https://github.com/jaraco/zipp) from 3.16.2 to 3.18.1.
- [Release notes](https://github.com/jaraco/zipp/releases)
- [Changelog](https://github.com/jaraco/zipp/blob/main/NEWS.rst)
- [Commits](https://github.com/jaraco/zipp/compare/v3.16.2...v3.18.1)

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

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

* Update zipp==3.18.1

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/zipp/__init__.py                         |  67 ++++++++---
 lib/zipp/compat/__init__.py                  |   0
 lib/zipp/{py310compat.py => compat/py310.py} |   0
 lib/zipp/glob.py                             | 112 +++++++++++++++----
 requirements.txt                             |   2 +-
 5 files changed, 142 insertions(+), 39 deletions(-)
 create mode 100644 lib/zipp/compat/__init__.py
 rename lib/zipp/{py310compat.py => compat/py310.py} (100%)

diff --git a/lib/zipp/__init__.py b/lib/zipp/__init__.py
index 3354c2bb..6d05d9a0 100644
--- a/lib/zipp/__init__.py
+++ b/lib/zipp/__init__.py
@@ -5,9 +5,10 @@ import itertools
 import contextlib
 import pathlib
 import re
+import sys
 
-from .py310compat import text_encoding
-from .glob import translate
+from .compat.py310 import text_encoding
+from .glob import Translator
 
 
 __all__ = ['Path']
@@ -148,6 +149,16 @@ class CompleteDirs(InitializedState, zipfile.ZipFile):
         source.__class__ = cls
         return source
 
+    @classmethod
+    def inject(cls, zf: zipfile.ZipFile) -> zipfile.ZipFile:
+        """
+        Given a writable zip file zf, inject directory entries for
+        any directories implied by the presence of children.
+        """
+        for name in cls._implied_dirs(zf.namelist()):
+            zf.writestr(name, b"")
+        return zf
+
 
 class FastLookup(CompleteDirs):
     """
@@ -169,8 +180,10 @@ class FastLookup(CompleteDirs):
 
 
 def _extract_text_encoding(encoding=None, *args, **kwargs):
-    # stacklevel=3 so that the caller of the caller see any warning.
-    return text_encoding(encoding, 3), args, kwargs
+    # compute stack level so that the caller of the caller sees any warning.
+    is_pypy = sys.implementation.name == 'pypy'
+    stack_level = 3 + is_pypy
+    return text_encoding(encoding, stack_level), args, kwargs
 
 
 class Path:
@@ -195,13 +208,13 @@ class Path:
 
     Path accepts the zipfile object itself or a filename
 
-    >>> root = Path(zf)
+    >>> path = Path(zf)
 
     From there, several path operations are available.
 
     Directory iteration (including the zip file itself):
 
-    >>> a, b = root.iterdir()
+    >>> a, b = path.iterdir()
     >>> a
     Path('mem/abcde.zip', 'a.txt')
     >>> b
@@ -239,16 +252,38 @@ class Path:
     'mem/abcde.zip/b/c.txt'
 
     At the root, ``name``, ``filename``, and ``parent``
-    resolve to the zipfile. Note these attributes are not
-    valid and will raise a ``ValueError`` if the zipfile
-    has no filename.
+    resolve to the zipfile.
 
-    >>> root.name
+    >>> str(path)
+    'mem/abcde.zip/'
+    >>> path.name
     'abcde.zip'
-    >>> str(root.filename).replace(os.sep, posixpath.sep)
-    'mem/abcde.zip'
-    >>> str(root.parent)
+    >>> path.filename == pathlib.Path('mem/abcde.zip')
+    True
+    >>> str(path.parent)
     'mem'
+
+    If the zipfile has no filename, such attribtues are not
+    valid and accessing them will raise an Exception.
+
+    >>> zf.filename = None
+    >>> path.name
+    Traceback (most recent call last):
+    ...
+    TypeError: ...
+
+    >>> path.filename
+    Traceback (most recent call last):
+    ...
+    TypeError: ...
+
+    >>> path.parent
+    Traceback (most recent call last):
+    ...
+    TypeError: ...
+
+    # workaround python/cpython#106763
+    >>> pass
     """
 
     __repr = "{self.__class__.__name__}({self.root.filename!r}, {self.at!r})"
@@ -365,8 +400,10 @@ class Path:
             raise ValueError(f"Unacceptable pattern: {pattern!r}")
 
         prefix = re.escape(self.at)
-        matches = re.compile(prefix + translate(pattern)).fullmatch
-        return map(self._next, filter(matches, self.root.namelist()))
+        tr = Translator(seps='/')
+        matches = re.compile(prefix + tr.translate(pattern)).fullmatch
+        names = (data.filename for data in self.root.filelist)
+        return map(self._next, filter(matches, names))
 
     def rglob(self, pattern):
         return self.glob(f'**/{pattern}')
diff --git a/lib/zipp/compat/__init__.py b/lib/zipp/compat/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/lib/zipp/py310compat.py b/lib/zipp/compat/py310.py
similarity index 100%
rename from lib/zipp/py310compat.py
rename to lib/zipp/compat/py310.py
diff --git a/lib/zipp/glob.py b/lib/zipp/glob.py
index 4a2e665e..69c41d77 100644
--- a/lib/zipp/glob.py
+++ b/lib/zipp/glob.py
@@ -1,18 +1,97 @@
+import os
 import re
 
 
-def translate(pattern):
-    r"""
-    Given a glob pattern, produce a regex that matches it.
+_default_seps = os.sep + str(os.altsep) * bool(os.altsep)
 
-    >>> translate('*.txt')
-    '[^/]*\\.txt'
-    >>> translate('a?txt')
-    'a.txt'
-    >>> translate('**/*')
-    '.*/[^/]*'
+
+class Translator:
     """
-    return ''.join(map(replace, separate(pattern)))
+    >>> Translator('xyz')
+    Traceback (most recent call last):
+    ...
+    AssertionError: Invalid separators
+
+    >>> Translator('')
+    Traceback (most recent call last):
+    ...
+    AssertionError: Invalid separators
+    """
+
+    seps: str
+
+    def __init__(self, seps: str = _default_seps):
+        assert seps and set(seps) <= set(_default_seps), "Invalid separators"
+        self.seps = seps
+
+    def translate(self, pattern):
+        """
+        Given a glob pattern, produce a regex that matches it.
+        """
+        return self.extend(self.translate_core(pattern))
+
+    def extend(self, pattern):
+        r"""
+        Extend regex for pattern-wide concerns.
+
+        Apply '(?s:)' to create a non-matching group that
+        matches newlines (valid on Unix).
+
+        Append '\Z' to imply fullmatch even when match is used.
+        """
+        return rf'(?s:{pattern})\Z'
+
+    def translate_core(self, pattern):
+        r"""
+        Given a glob pattern, produce a regex that matches it.
+
+        >>> t = Translator()
+        >>> t.translate_core('*.txt').replace('\\\\', '')
+        '[^/]*\\.txt'
+        >>> t.translate_core('a?txt')
+        'a[^/]txt'
+        >>> t.translate_core('**/*').replace('\\\\', '')
+        '.*/[^/][^/]*'
+        """
+        self.restrict_rglob(pattern)
+        return ''.join(map(self.replace, separate(self.star_not_empty(pattern))))
+
+    def replace(self, match):
+        """
+        Perform the replacements for a match from :func:`separate`.
+        """
+        return match.group('set') or (
+            re.escape(match.group(0))
+            .replace('\\*\\*', r'.*')
+            .replace('\\*', rf'[^{re.escape(self.seps)}]*')
+            .replace('\\?', r'[^/]')
+        )
+
+    def restrict_rglob(self, pattern):
+        """
+        Raise ValueError if ** appears in anything but a full path segment.
+
+        >>> Translator().translate('**foo')
+        Traceback (most recent call last):
+        ...
+        ValueError: ** must appear alone in a path segment
+        """
+        seps_pattern = rf'[{re.escape(self.seps)}]+'
+        segments = re.split(seps_pattern, pattern)
+        if any('**' in segment and segment != '**' for segment in segments):
+            raise ValueError("** must appear alone in a path segment")
+
+    def star_not_empty(self, pattern):
+        """
+        Ensure that * will not match an empty segment.
+        """
+
+        def handle_segment(match):
+            segment = match.group(0)
+            return '?*' if segment == '*' else segment
+
+        not_seps_pattern = rf'[^{re.escape(self.seps)}]+'
+        return re.sub(not_seps_pattern, handle_segment, pattern)
 
 
 def separate(pattern):
@@ -25,16 +104,3 @@ def separate(pattern):
     ['a', '[?]', 'txt']
     """
     return re.finditer(r'([^\[]+)|(?P<set>[\[].*?[\]])|([\[][^\]]*$)', pattern)
-
-
-def replace(match):
-    """
-    Perform the replacements for a match from :func:`separate`.
-    """
-
-    return match.group('set') or (
-        re.escape(match.group(0))
-        .replace('\\*\\*', r'.*')
-        .replace('\\*', r'[^/]*')
-        .replace('\\?', r'.')
-    )
diff --git a/requirements.txt b/requirements.txt
index 30d57ade..760747ea 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -49,7 +49,7 @@ urllib3<2
 webencodings==0.5.1
 websocket-client==1.7.0
 xmltodict==0.13.0
-zipp==3.16.2
+zipp==3.18.1
 
 # configobj==5.1.0
 # sgmllib3k==1.0.0

From 6c6fa34ba403e0fcd8c84f3a904a5b2e1d36ae9c Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sun, 24 Mar 2024 15:27:42 -0700
Subject: [PATCH 543/743] Bump cloudinary from 1.34.0 to 1.39.1 (#2283)

* Bump cloudinary from 1.34.0 to 1.39.1

Bumps [cloudinary](https://github.com/cloudinary/pycloudinary) from 1.34.0 to 1.39.1.
- [Release notes](https://github.com/cloudinary/pycloudinary/releases)
- [Changelog](https://github.com/cloudinary/pycloudinary/blob/master/CHANGELOG.md)
- [Commits](https://github.com/cloudinary/pycloudinary/compare/1.34.0...1.39.1)

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

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

* Update cloudinary==1.39.1

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/cloudinary/__init__.py                    |   8 +-
 lib/cloudinary/api.py                         | 110 +++++++++++---
 lib/cloudinary/api_client/call_account_api.py |   5 +-
 lib/cloudinary/api_client/call_api.py         |  14 +-
 lib/cloudinary/api_client/execute_request.py  |   3 +-
 lib/cloudinary/http_client.py                 |   2 +-
 lib/cloudinary/provisioning/__init__.py       |   3 +-
 lib/cloudinary/provisioning/account.py        | 128 +++++++++++++++-
 lib/cloudinary/search.py                      |  12 +-
 lib/cloudinary/uploader.py                    |  34 +----
 lib/cloudinary/utils.py                       | 138 ++++++++++++++----
 requirements.txt                              |   2 +-
 12 files changed, 349 insertions(+), 110 deletions(-)

diff --git a/lib/cloudinary/__init__.py b/lib/cloudinary/__init__.py
index 2cc24dc4..7702ca9f 100644
--- a/lib/cloudinary/__init__.py
+++ b/lib/cloudinary/__init__.py
@@ -38,7 +38,7 @@ CL_BLANK = "data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAA
 URI_SCHEME = "cloudinary"
 API_VERSION = "v1_1"
 
-VERSION = "1.34.0"
+VERSION = "1.39.1"
 
 _USER_PLATFORM_DETAILS = "; ".join((platform(), "Python {}".format(python_version())))
 
@@ -741,7 +741,11 @@ class CloudinaryResource(object):
         :return: Video tag
         """
         public_id = options.get('public_id', self.public_id)
-        source = re.sub(r"\.({0})$".format("|".join(self.default_source_types())), '', public_id)
+        use_fetch_format = options.get('use_fetch_format', config().use_fetch_format)
+        if not use_fetch_format:
+            source = re.sub(r"\.({0})$".format("|".join(self.default_source_types())), '', public_id)
+        else:
+            source = public_id
 
         custom_attributes = options.pop("attributes", dict())
 
diff --git a/lib/cloudinary/api.py b/lib/cloudinary/api.py
index 8f07ee9e..cf5b2fca 100644
--- a/lib/cloudinary/api.py
+++ b/lib/cloudinary/api.py
@@ -14,7 +14,8 @@ from cloudinary import utils
 from cloudinary.api_client.call_api import (
     call_api,
     call_metadata_api,
-    call_json_api
+    call_json_api,
+    _call_v2_api
 )
 from cloudinary.exceptions import (
     BadRequest,
@@ -54,6 +55,19 @@ def usage(**options):
     return call_api("get", uri, {}, **options)
 
 
+def config(**options):
+    """
+    Get account config details.
+
+    :param options:     Additional options.
+    :type options:      dict, optional
+    :return:            Detailed config information.
+    :rtype:             Response
+    """
+    params = only(options, "settings")
+    return call_api("get", ["config"], params, **options)
+
+
 def resource_types(**options):
     return call_api("get", ["resources"], {}, **options)
 
@@ -64,24 +78,22 @@ def resources(**options):
     uri = ["resources", resource_type]
     if upload_type:
         uri.append(upload_type)
-    params = only(options, "next_cursor", "max_results", "prefix", "tags",
-                  "context", "moderations", "direction", "start_at", "metadata")
+    params = __list_resources_params(**options)
+    params.update(only(options, "prefix", "start_at"))
     return call_api("get", uri, params, **options)
 
 
 def resources_by_tag(tag, **options):
     resource_type = options.pop("resource_type", "image")
     uri = ["resources", resource_type, "tags", tag]
-    params = only(options, "next_cursor", "max_results", "tags",
-                  "context", "moderations", "direction", "metadata")
+    params = __list_resources_params(**options)
     return call_api("get", uri, params, **options)
 
 
 def resources_by_moderation(kind, status, **options):
     resource_type = options.pop("resource_type", "image")
     uri = ["resources", resource_type, "moderations", kind, status]
-    params = only(options, "next_cursor", "max_results", "tags",
-                  "context", "moderations", "direction", "metadata")
+    params = __list_resources_params(**options)
     return call_api("get", uri, params, **options)
 
 
@@ -89,7 +101,7 @@ def resources_by_ids(public_ids, **options):
     resource_type = options.pop("resource_type", "image")
     upload_type = options.pop("type", "upload")
     uri = ["resources", resource_type, upload_type]
-    params = dict(only(options, "tags", "moderations", "context"), public_ids=public_ids)
+    params = dict(__resources_params(**options), public_ids=public_ids)
     return call_api("get", uri, params, **options)
 
 
@@ -105,7 +117,7 @@ def resources_by_asset_folder(asset_folder, **options):
     :rtype:             Response
     """
     uri = ["resources", "by_asset_folder"]
-    params = only(options, "max_results", "tags", "moderations", "context", "next_cursor")
+    params = __list_resources_params(**options)
     params["asset_folder"] = asset_folder
     return call_api("get", uri, params, **options)
 
@@ -125,7 +137,7 @@ def resources_by_asset_ids(asset_ids, **options):
     :rtype:             Response
     """
     uri = ["resources", 'by_asset_ids']
-    params = dict(only(options, "tags", "moderations", "context"), asset_ids=asset_ids)
+    params = dict(__resources_params(**options), asset_ids=asset_ids)
     return call_api("get", uri, params, **options)
 
 
@@ -147,15 +159,43 @@ def resources_by_context(key, value=None, **options):
     """
     resource_type = options.pop("resource_type", "image")
     uri = ["resources", resource_type, "context"]
-    params = only(options, "next_cursor", "max_results", "tags",
-                  "context", "moderations", "direction", "metadata")
+    params = __list_resources_params(**options)
     params["key"] = key
     if value is not None:
         params["value"] = value
     return call_api("get", uri, params, **options)
 
 
-def visual_search(image_url=None, image_asset_id=None, text=None, **options):
+def __resources_params(**options):
+    """
+       Prepares optional parameters for resources_* API calls.
+
+       :param options: Additional options
+       :return: Optional parameters
+
+       :internal
+       """
+    params = only(options, "tags", "context", "metadata", "moderations")
+    params["fields"] = options.get("fields") and utils.encode_list(utils.build_array(options["fields"]))
+    return params
+
+
+def __list_resources_params(**options):
+    """
+       Prepares optional parameters for resources_* API calls.
+
+       :param options: Additional options
+       :return: Optional parameters
+
+       :internal
+       """
+    resources_params = __resources_params(**options)
+    resources_params.update(only(options, "next_cursor", "max_results", "direction"))
+
+    return resources_params
+
+
+def visual_search(image_url=None, image_asset_id=None, text=None, image_file=None, **options):
     """
     Find images based on their visual content.
 
@@ -165,14 +205,17 @@ def visual_search(image_url=None, image_asset_id=None, text=None, **options):
     :type image_asset_id:   str
     :param text:            A textual description, e.g., "cat"
     :type text:             str
+    :param image_file:      The image file.
+    :type image_file:       str|callable|Path|bytes
     :param options:         Additional options
     :type options:          dict, optional
     :return:                Resources (assets) that were found
     :rtype:                 Response
     """
     uri = ["resources", "visual_search"]
-    params = {"image_url": image_url, "image_asset_id": image_asset_id, "text": text}
-    return call_api("get", uri, params, **options)
+    params = {"image_url": image_url, "image_asset_id": image_asset_id, "text": text,
+              "image_file": utils.handle_file_parameter(image_file, "file")}
+    return call_api("post", uri, params, **options)
 
 
 def resource(public_id, **options):
@@ -224,11 +267,11 @@ def update(public_id, **options):
     if "tags" in options:
         params["tags"] = ",".join(utils.build_array(options["tags"]))
     if "face_coordinates" in options:
-        params["face_coordinates"] = utils.encode_double_array(
-            options.get("face_coordinates"))
+        params["face_coordinates"] = utils.encode_double_array(options.get("face_coordinates"))
     if "custom_coordinates" in options:
-        params["custom_coordinates"] = utils.encode_double_array(
-            options.get("custom_coordinates"))
+        params["custom_coordinates"] = utils.encode_double_array(options.get("custom_coordinates"))
+    if "regions" in options:
+        params["regions"] = utils.json_encode(options.get("regions"))
     if "context" in options:
         params["context"] = utils.encode_context(options.get("context"))
     if "metadata" in options:
@@ -656,9 +699,8 @@ def add_metadata_field(field, **options):
 
     :rtype: Response
     """
-    params = only(field, "type", "external_id", "label", "mandatory",
-                  "default_value", "validation", "datasource")
-    return call_metadata_api("post", [], params, **options)
+
+    return call_metadata_api("post", [], __metadata_field_params(field), **options)
 
 
 def update_metadata_field(field_external_id, field, **options):
@@ -677,8 +719,13 @@ def update_metadata_field(field_external_id, field, **options):
     :rtype: Response
     """
     uri = [field_external_id]
-    params = only(field, "label", "mandatory", "default_value", "validation")
-    return call_metadata_api("put", uri, params, **options)
+
+    return call_metadata_api("put", uri, __metadata_field_params(field), **options)
+
+
+def __metadata_field_params(field):
+    return only(field, "type", "external_id", "label", "mandatory", "restrictions",
+                "default_value", "validation", "datasource")
 
 
 def delete_metadata_field(field_external_id, **options):
@@ -798,3 +845,18 @@ def reorder_metadata_fields(order_by, direction=None, **options):
     uri = ['order']
     params = {'order_by': order_by, 'direction': direction}
     return call_metadata_api('put', uri, params, **options)
+
+
+def analyze(input_type, analysis_type, uri=None, **options):
+    """Analyzes an asset with the requested analysis type.
+
+    :param input_type: The type of input for the asset to analyze ('uri').
+    :param analysis_type: The type of analysis to run ('google_tagging', 'captioning', 'fashion').
+    :param uri: The URI of the asset to analyze.
+    :param options: Additional options.
+
+    :rtype: Response
+    """
+    api_uri = ['analysis', 'analyze', input_type]
+    params = {'analysis_type': analysis_type, 'uri': uri, 'parameters': options.get("parameters")}
+    return _call_v2_api('post', api_uri, params, **options)
diff --git a/lib/cloudinary/api_client/call_account_api.py b/lib/cloudinary/api_client/call_account_api.py
index c40aaf3b..5a6cf3ab 100644
--- a/lib/cloudinary/api_client/call_account_api.py
+++ b/lib/cloudinary/api_client/call_account_api.py
@@ -1,8 +1,7 @@
 import cloudinary
 from cloudinary.api_client.execute_request import execute_request
 from cloudinary.provisioning.account_config import account_config
-from cloudinary.utils import get_http_connector
-
+from cloudinary.utils import get_http_connector, normalize_params
 
 PROVISIONING_SUB_PATH = "provisioning"
 ACCOUNT_SUB_PATH = "accounts"
@@ -28,7 +27,7 @@ def _call_account_api(method, uri, params=None, headers=None, **options):
 
     return execute_request(http_connector=_http,
                            method=method,
-                           params=params,
+                           params=normalize_params(params),
                            headers=headers,
                            auth=auth,
                            api_url=provisioning_api_url,
diff --git a/lib/cloudinary/api_client/call_api.py b/lib/cloudinary/api_client/call_api.py
index 916a396a..94a3c9ec 100644
--- a/lib/cloudinary/api_client/call_api.py
+++ b/lib/cloudinary/api_client/call_api.py
@@ -2,8 +2,7 @@ import json
 
 import cloudinary
 from cloudinary.api_client.execute_request import execute_request
-from cloudinary.utils import get_http_connector
-
+from cloudinary.utils import get_http_connector, normalize_params
 
 logger = cloudinary.logger
 _http = get_http_connector(cloudinary.config(), cloudinary.CERT_KWARGS)
@@ -27,6 +26,10 @@ def call_json_api(method, uri, json_body, **options):
     return _call_api(method, uri, body=data, headers={'Content-Type': 'application/json'}, **options)
 
 
+def _call_v2_api(method, uri, json_body, **options):
+    return call_json_api(method, uri, json_body=json_body, api_version='v2', **options)
+
+
 def call_api(method, uri, params, **options):
     return _call_api(method, uri, params=params, **options)
 
@@ -43,10 +46,11 @@ def _call_api(method, uri, params=None, body=None, headers=None, extra_headers=N
     oauth_token = options.pop("oauth_token", cloudinary.config().oauth_token)
 
     _validate_authorization(api_key, api_secret, oauth_token)
-
-    api_url = "/".join([prefix, cloudinary.API_VERSION, cloud_name] + uri)
     auth = {"key": api_key, "secret": api_secret, "oauth_token": oauth_token}
 
+    api_version = options.pop("api_version",  cloudinary.API_VERSION)
+    api_url = "/".join([prefix, api_version, cloud_name] + uri)
+
     if body is not None:
         options["body"] = body
 
@@ -55,7 +59,7 @@ def _call_api(method, uri, params=None, body=None, headers=None, extra_headers=N
 
     return execute_request(http_connector=_http,
                            method=method,
-                           params=params,
+                           params=normalize_params(params),
                            headers=headers,
                            auth=auth,
                            api_url=api_url,
diff --git a/lib/cloudinary/api_client/execute_request.py b/lib/cloudinary/api_client/execute_request.py
index 1bd52a25..97aba8cb 100644
--- a/lib/cloudinary/api_client/execute_request.py
+++ b/lib/cloudinary/api_client/execute_request.py
@@ -63,9 +63,8 @@ def execute_request(http_connector, method, params, headers, auth, api_url, **op
     processed_params = process_params(params)
 
     api_url = smart_escape(unquote(api_url))
-
     try:
-        response = http_connector.request(method.upper(), api_url, processed_params, req_headers, **kw)
+        response = http_connector.request(method=method.upper(), url=api_url, fields=processed_params, headers=req_headers, **kw)
         body = response.data
     except HTTPError as e:
         raise GeneralError("Unexpected error %s" % str(e))
diff --git a/lib/cloudinary/http_client.py b/lib/cloudinary/http_client.py
index 4355b017..b5f6e1b3 100644
--- a/lib/cloudinary/http_client.py
+++ b/lib/cloudinary/http_client.py
@@ -24,7 +24,7 @@ class HttpClient:
 
     def get_json(self, url):
         try:
-            response = self._http_client.request("GET", url, timeout=self.timeout)
+            response = self._http_client.request(method="GET", url=url, timeout=self.timeout)
             body = response.data
         except HTTPError as e:
             raise GeneralError("Unexpected error %s" % str(e))
diff --git a/lib/cloudinary/provisioning/__init__.py b/lib/cloudinary/provisioning/__init__.py
index 09afc114..7016343a 100644
--- a/lib/cloudinary/provisioning/__init__.py
+++ b/lib/cloudinary/provisioning/__init__.py
@@ -2,4 +2,5 @@ from .account_config import AccountConfig, account_config, reset_config
 from .account import (sub_accounts, create_sub_account, delete_sub_account, sub_account, update_sub_account,
                       user_groups, create_user_group, update_user_group, delete_user_group, user_group,
                       add_user_to_group, remove_user_from_group, user_group_users, user_in_user_groups,
-                      users, create_user, delete_user, user, update_user, Role)
+                      users, create_user, delete_user, user, update_user, access_keys, generate_access_key,
+                      update_access_key, delete_access_key, Role)
diff --git a/lib/cloudinary/provisioning/account.py b/lib/cloudinary/provisioning/account.py
index 414c2727..90b1c385 100644
--- a/lib/cloudinary/provisioning/account.py
+++ b/lib/cloudinary/provisioning/account.py
@@ -1,10 +1,10 @@
 from cloudinary.api_client.call_account_api import _call_account_api
 from cloudinary.utils import encode_list
 
-
 SUB_ACCOUNTS_SUB_PATH = "sub_accounts"
 USERS_SUB_PATH = "users"
 USER_GROUPS_SUB_PATH = "user_groups"
+ACCESS_KEYS = "access_keys"
 
 
 class Role(object):
@@ -123,7 +123,8 @@ def update_sub_account(sub_account_id, name=None, cloud_name=None, custom_attrib
     return _call_account_api("put", uri, params=params, **options)
 
 
-def users(user_ids=None, sub_account_id=None, pending=None, prefix=None, **options):
+def users(user_ids=None, sub_account_id=None, pending=None, prefix=None, last_login=None, from_date=None, to_date=None,
+          **options):
     """
     List all users
     :param user_ids:        The ids of the users to fetch
@@ -136,6 +137,13 @@ def users(user_ids=None, sub_account_id=None, pending=None, prefix=None, **optio
     :type pending:          bool, optional
     :param prefix:          User prefix
     :type prefix:           str, optional
+    :param last_login:      Return only users that last logged in in the specified range of dates (true), 
+                            users that didn't last logged in in that range (false), or all users (None).
+    :type last_login:       bool, optional
+    :param from_date:       Last login start date.
+    :type from_date:        datetime, optional
+    :param to_date:         Last login end date.
+    :type to_date:          datetime, optional
     :param options:         Generic advanced options dict, see online documentation.
     :type options:          dict, optional
     :return:                List of users associated with the account
@@ -146,7 +154,10 @@ def users(user_ids=None, sub_account_id=None, pending=None, prefix=None, **optio
     params = {"ids": user_ids,
               "sub_account_id": sub_account_id,
               "pending": pending,
-              "prefix": prefix}
+              "prefix": prefix,
+              "last_login": last_login,
+              "from": from_date,
+              "to": to_date}
     return _call_account_api("get", uri, params=params, **options)
 
 
@@ -351,7 +362,7 @@ def user_in_user_groups(user_id, **options):
     """
     Get all user groups a user belongs to
     :param user_id:             The id of user
-    :param user_id:             str
+    :type user_id:              str
     :param options:             Generic advanced options dict, see online documentation
     :type options:              dict, optional
     :return:                    List of groups user is in
@@ -359,3 +370,112 @@ def user_in_user_groups(user_id, **options):
     """
     uri = [USER_GROUPS_SUB_PATH, user_id]
     return _call_account_api("get", uri, {}, **options)
+
+
+def access_keys(sub_account_id, page_size=None, page=None, sort_by=None, sort_order=None, **options):
+    """
+    Get sub account access keys.
+
+    :param sub_account_id:  The id of the sub account.
+    :type sub_account_id:   str
+    :param page_size:       How many entries to display on each page.
+    :type page_size:        int
+    :param page:            Which page to return (maximum pages: 100). **Default**: All pages are returned.
+    :type page:             int
+    :param sort_by:         Which response parameter to sort by.
+                                **Possible values**: `api_key`, `created_at`, `name`, `enabled`.
+    :type sort_by:          str
+    :param sort_order:      Control the order of returned keys. **Possible values**: `desc` (default), `asc`.
+    :type sort_order:       str
+    :param options:         Generic advanced options dict, see online documentation.
+    :type options:          dict, optional
+    :return:                List of access keys
+    :rtype:                 dict
+    """
+    uri = [SUB_ACCOUNTS_SUB_PATH, sub_account_id, ACCESS_KEYS]
+    params = {
+        "page_size": page_size,
+        "page": page,
+        "sort_by": sort_by,
+        "sort_order": sort_order,
+    }
+    return _call_account_api("get", uri, params, **options)
+
+
+def generate_access_key(sub_account_id, name=None, enabled=None, **options):
+    """
+    Generate a new access key.
+
+    :param sub_account_id:      The id of the sub account.
+    :type sub_account_id:       str
+    :param name:                The name of the new access key.
+    :type name:                 str
+    :param enabled:             Whether the new access key is enabled or disabled.
+    :type enabled:              bool
+    :param options:             Generic advanced options dict, see online documentation.
+    :type options:              dict, optional
+    :return:                    Access key details
+    :rtype:                     dict
+    """
+    uri = [SUB_ACCOUNTS_SUB_PATH, sub_account_id, ACCESS_KEYS]
+    params = {
+        "name": name,
+        "enabled": enabled,
+    }
+    return _call_account_api("post", uri, params, **options)
+
+
+def update_access_key(sub_account_id, api_key, name=None, enabled=None, dedicated_for=None, **options):
+    """
+    Update the name and/or status of an existing access key.
+
+    :param sub_account_id:      The id of the sub account.
+    :type sub_account_id:       str
+    :param api_key:             The API key of the access key.
+    :type api_key:              str|int
+    :param name:                The updated name of the access key.
+    :type name:                 str
+    :param enabled:             Enable or disable the access key.
+    :type enabled:              bool
+    :param dedicated_for:       Designates the access key for a specific purpose while allowing it to be used for
+                                other purposes, as well. This action replaces any previously assigned key.
+                                **Possible values**: `webhooks`
+    :type dedicated_for:        str
+    :param options:             Generic advanced options dict, see online documentation.
+    :type options:              dict, optional
+    :return:                    Access key details
+    :rtype:                     dict
+    """
+    uri = [SUB_ACCOUNTS_SUB_PATH, sub_account_id, ACCESS_KEYS, str(api_key)]
+    params = {
+        "name": name,
+        "enabled": enabled,
+        "dedicated_for": dedicated_for,
+    }
+    return _call_account_api("put", uri, params, **options)
+
+
+def delete_access_key(sub_account_id, api_key=None, name=None, **options):
+    """
+    Delete an existing access key by api_key or by name.
+
+    :param sub_account_id:      The id of the sub account.
+    :type sub_account_id:       str
+    :param api_key:             The API key of the access key.
+    :type api_key:              str|int
+    :param name:                The name of the access key.
+    :type name:                 str
+    :param options:             Generic advanced options dict, see online documentation.
+    :type options:              dict, optional
+    :return:                    Operation status.
+    :rtype:                     dict
+    """
+    uri = [SUB_ACCOUNTS_SUB_PATH, sub_account_id, ACCESS_KEYS]
+
+    if api_key is not None:
+        uri.append(str(api_key))
+
+    params = {
+        "name": name
+    }
+    return _call_account_api("delete", uri, params, **options)
diff --git a/lib/cloudinary/search.py b/lib/cloudinary/search.py
index 7af1773c..4e83af68 100644
--- a/lib/cloudinary/search.py
+++ b/lib/cloudinary/search.py
@@ -3,8 +3,8 @@ import json
 
 import cloudinary
 from cloudinary.api_client.call_api import call_json_api
-from cloudinary.utils import unique, unsigned_download_url_prefix, build_distribution_domain, base64url_encode, \
-    json_encode, compute_hex_hash, SIGNATURE_SHA256
+from cloudinary.utils import (unique, build_distribution_domain, base64url_encode, json_encode, compute_hex_hash,
+                              SIGNATURE_SHA256, build_array)
 
 
 class Search(object):
@@ -16,6 +16,7 @@ class Search(object):
         'sort_by': lambda x: next(iter(x)),
         'aggregate': None,
         'with_field': None,
+        'fields': None,
     }
 
     _ttl = 300  # Used for search URLs
@@ -57,6 +58,11 @@ class Search(object):
         self._add("with_field", value)
         return self
 
+    def fields(self, value):
+        """Request which fields to return in the result set."""
+        self._add("fields", value)
+        return self
+
     def ttl(self, ttl):
         """
         Sets the time to live of the search URL.
@@ -133,5 +139,5 @@ class Search(object):
     def _add(self, name, value):
         if name not in self.query:
             self.query[name] = []
-        self.query[name].append(value)
+        self.query[name].extend(build_array(value))
         return self
diff --git a/lib/cloudinary/uploader.py b/lib/cloudinary/uploader.py
index d4039ccc..a2c91ad5 100644
--- a/lib/cloudinary/uploader.py
+++ b/lib/cloudinary/uploader.py
@@ -23,11 +23,6 @@ try:  # Python 2.7+
 except ImportError:
     from urllib3.packages.ordered_dict import OrderedDict
 
-try:  # Python 3.4+
-    from pathlib import Path as PathLibPathType
-except ImportError:
-    PathLibPathType = None
-
 if is_appengine_sandbox():
     # AppEngineManager uses AppEngine's URLFetch API behind the scenes
     _http = AppEngineManager()
@@ -503,32 +498,7 @@ def call_api(action, params, http_headers=None, return_error=False, unsigned=Fal
 
     if file:
         filename = options.get("filename")  # Custom filename provided by user (relevant only for streams and files)
-
-        if PathLibPathType and isinstance(file, PathLibPathType):
-            name = filename or file.name
-            data = file.read_bytes()
-        elif isinstance(file, string_types):
-            if utils.is_remote_url(file):
-                # URL
-                name = None
-                data = file
-            else:
-                # file path
-                name = filename or file
-                with open(file, "rb") as opened:
-                    data = opened.read()
-        elif hasattr(file, 'read') and callable(file.read):
-            # stream
-            data = file.read()
-            name = filename or (file.name if hasattr(file, 'name') and isinstance(file.name, str) else "stream")
-        elif isinstance(file, tuple):
-            name, data = file
-        else:
-            # Not a string, not a stream
-            name = filename or "file"
-            data = file
-
-        param_list.append(("file", (name, data) if name else data))
+        param_list.append(("file", utils.handle_file_parameter(file, filename)))
 
     kw = {}
     if timeout is not None:
@@ -536,7 +506,7 @@ def call_api(action, params, http_headers=None, return_error=False, unsigned=Fal
 
     code = 200
     try:
-        response = _http.request("POST", api_url, param_list, headers, **kw)
+        response = _http.request(method="POST", url=api_url, fields=param_list, headers=headers, **kw)
     except HTTPError as e:
         raise Error("Unexpected error - {0!r}".format(e))
     except socket.error as e:
diff --git a/lib/cloudinary/utils.py b/lib/cloudinary/utils.py
index 680c175e..1b7b7215 100644
--- a/lib/cloudinary/utils.py
+++ b/lib/cloudinary/utils.py
@@ -25,6 +25,11 @@ from cloudinary import auth_token
 from cloudinary.api_client.tcp_keep_alive_manager import TCPKeepAlivePoolManager, TCPKeepAliveProxyManager
 from cloudinary.compat import PY3, to_bytes, to_bytearray, to_string, string_types, urlparse
 
+try:  # Python 3.4+
+    from pathlib import Path as PathLibPathType
+except ImportError:
+    PathLibPathType = None
+
 VAR_NAME_RE = r'(\$\([a-zA-Z]\w+\))'
 
 urlencode = six.moves.urllib.parse.urlencode
@@ -127,6 +132,7 @@ __SERIALIZED_UPLOAD_PARAMS = [
     "allowed_formats",
     "face_coordinates",
     "custom_coordinates",
+    "regions",
     "context",
     "auto_tagging",
     "responsive_breakpoints",
@@ -181,12 +187,11 @@ def compute_hex_hash(s, algorithm=SIGNATURE_SHA1):
 
 
 def build_array(arg):
-    if isinstance(arg, list):
+    if isinstance(arg, (list, tuple)):
         return arg
     elif arg is None:
         return []
-    else:
-        return [arg]
+    return [arg]
 
 
 def build_list_of_dicts(val):
@@ -235,8 +240,7 @@ def encode_double_array(array):
     array = build_array(array)
     if len(array) > 0 and isinstance(array[0], list):
         return "|".join([",".join([str(i) for i in build_array(inner)]) for inner in array])
-    else:
-        return encode_list([str(i) for i in array])
+    return encode_list([str(i) for i in array])
 
 
 def encode_dict(arg):
@@ -246,8 +250,7 @@ def encode_dict(arg):
         else:
             items = arg.iteritems()
         return "|".join((k + "=" + v) for k, v in items)
-    else:
-        return arg
+    return arg
 
 
 def normalize_context_value(value):
@@ -288,9 +291,14 @@ def json_encode(value, sort_keys=False):
     Converts value to a json encoded string
 
     :param value: value to be encoded
+    :param sort_keys: whether to sort keys
 
     :return: JSON encoded string
     """
+
+    if isinstance(value, str) or value is None:
+        return value
+
     return json.dumps(value, default=__json_serializer, separators=(',', ':'), sort_keys=sort_keys)
 
 
@@ -309,11 +317,13 @@ def patch_fetch_format(options):
     """
     When upload type is fetch, remove the format options.
     In addition, set the fetch_format options to the format value unless it was already set.
-    Mutates the options parameter!
+    Mutates the "options" parameter!
 
     :param options: URL and transformation options
     """
-    if options.get("type", "upload") != "fetch":
+    use_fetch_format = options.pop("use_fetch_format", cloudinary.config().use_fetch_format)
+
+    if options.get("type", "upload") != "fetch" and not use_fetch_format:
         return
 
     resource_format = options.pop("format", None)
@@ -351,8 +361,7 @@ def generate_transformation_string(**options):
         def recurse(bs):
             if isinstance(bs, dict):
                 return generate_transformation_string(**bs)[0]
-            else:
-                return generate_transformation_string(transformation=bs)[0]
+            return generate_transformation_string(transformation=bs)[0]
 
         base_transformations = list(map(recurse, base_transformations))
         named_transformation = None
@@ -375,7 +384,7 @@ def generate_transformation_string(**options):
     flags = ".".join(build_array(options.pop("flags", None)))
     dpr = options.pop("dpr", cloudinary.config().dpr)
     duration = norm_range_value(options.pop("duration", None))
-    
+
     so_raw = options.pop("start_offset", None)
     start_offset = norm_auto_range_value(so_raw)
     if start_offset == None:
@@ -513,8 +522,7 @@ def split_range(range):
         return [range[0], range[-1]]
     elif isinstance(range, string_types) and re.match(RANGE_RE, range):
         return range.split("..", 1)
-    else:
-        return None
+    return None
 
 
 def norm_range_value(value):
@@ -570,6 +578,9 @@ def process_params(params):
         processed_params = {}
         for key, value in params.items():
             if isinstance(value, list) or isinstance(value, tuple):
+                if len(value) == 2 and value[0] == "file":  # keep file parameter as is.
+                    processed_params[key] = value
+                    continue
                 value_list = {"{}[{}]".format(key, i): i_value for i, i_value in enumerate(value)}
                 processed_params.update(value_list)
             elif value is not None:
@@ -578,9 +589,28 @@ def process_params(params):
 
 
 def cleanup_params(params):
+    """
+    Cleans and normalizes parameters when calculating signature in Upload API.
+
+    :param params:
+    :return:
+    """
     return dict([(k, __safe_value(v)) for (k, v) in params.items() if v is not None and not v == ""])
 
 
+def normalize_params(params):
+    """
+    Normalizes Admin API parameters.
+
+    :param params:
+    :return:
+    """
+    if not params or not isinstance(params, dict):
+        return params
+
+    return dict([(k, __bool_string(v)) for (k, v) in params.items() if v is not None and not v == ""])
+
+
 def sign_request(params, options):
     api_key = options.get("api_key", cloudinary.config().api_key)
     if not api_key:
@@ -1086,6 +1116,7 @@ def build_upload_params(**options):
         "allowed_formats": options.get("allowed_formats") and encode_list(build_array(options["allowed_formats"])),
         "face_coordinates": encode_double_array(options.get("face_coordinates")),
         "custom_coordinates": encode_double_array(options.get("custom_coordinates")),
+        "regions": json_encode(options.get("regions")),
         "context": encode_context(options.get("context")),
         "auto_tagging": options.get("auto_tagging") and str(options.get("auto_tagging")),
         "responsive_breakpoints": generate_responsive_breakpoints_string(options.get("responsive_breakpoints")),
@@ -1101,6 +1132,37 @@ def build_upload_params(**options):
     return params
 
 
+def handle_file_parameter(file, filename):
+    if not file:
+        return None
+
+    if PathLibPathType and isinstance(file, PathLibPathType):
+        name = filename or file.name
+        data = file.read_bytes()
+    elif isinstance(file, string_types):
+        if is_remote_url(file):
+            # URL
+            name = None
+            data = file
+        else:
+            # file path
+            name = filename or file
+            with open(file, "rb") as opened:
+                data = opened.read()
+    elif hasattr(file, 'read') and callable(file.read):
+        # stream
+        data = file.read()
+        name = filename or (file.name if hasattr(file, 'name') and isinstance(file.name, str) else "stream")
+    elif isinstance(file, tuple):
+        name, data = file
+    else:
+        # Not a string, not a stream
+        name = filename or "file"
+        data = file
+
+    return (name, data) if name else data
+
+
 def build_multi_and_sprite_params(**options):
     """
     Build params for multi, download_multi, generate_sprite, and download_generated_sprite methods
@@ -1166,8 +1228,21 @@ def __process_text_options(layer, layer_parameter):
 
 
 def process_layer(layer, layer_parameter):
-    if isinstance(layer, string_types) and layer.startswith("fetch:"):
-        layer = {"url": layer[len('fetch:'):]}
+    if isinstance(layer, string_types):
+        resource_type = None
+        if layer.startswith("fetch:"):
+            url = layer[len('fetch:'):]
+        elif layer.find(":fetch:", 0, 12) != -1:
+            resource_type, _, url = layer.split(":", 2)
+        else:
+            # nothing to process, a raw string, keep as is.
+            return layer
+
+        # handle remote fetch URL
+        layer = {"url": url, "type": "fetch"}
+        if resource_type:
+            layer["resource_type"] = resource_type
+
     if not isinstance(layer, dict):
         return layer
 
@@ -1176,19 +1251,19 @@ def process_layer(layer, layer_parameter):
     type = layer.get("type")
     public_id = layer.get("public_id")
     format = layer.get("format")
-    fetch = layer.get("url")
+    fetch_url = layer.get("url")
     components = list()
 
     if text is not None and resource_type is None:
         resource_type = "text"
 
-    if fetch and resource_type is None:
-        resource_type = "fetch"
+    if fetch_url and type is None:
+        type = "fetch"
 
     if public_id is not None and format is not None:
         public_id = public_id + "." + format
 
-    if public_id is None and resource_type != "text" and resource_type != "fetch":
+    if public_id is None and resource_type != "text" and type != "fetch":
         raise ValueError("Must supply public_id for for non-text " + layer_parameter)
 
     if resource_type is not None and resource_type != "image":
@@ -1212,8 +1287,6 @@ def process_layer(layer, layer_parameter):
 
         if text is not None:
             var_pattern = VAR_NAME_RE
-            match = re.findall(var_pattern, text)
-
             parts = filter(lambda p: p is not None, re.split(var_pattern, text))
             encoded_text = []
             for part in parts:
@@ -1223,11 +1296,9 @@ def process_layer(layer, layer_parameter):
                     encoded_text.append(smart_escape(smart_escape(part, r"([,/])")))
 
             text = ''.join(encoded_text)
-            # text = text.replace("%2C", "%252C")
-            # text = text.replace("/", "%252F")
             components.append(text)
-    elif resource_type == "fetch":
-        b64 = base64_encode_url(fetch)
+    elif type == "fetch":
+        b64 = base64url_encode(fetch_url)
         components.append(b64)
     else:
         public_id = public_id.replace("/", ':')
@@ -1359,8 +1430,7 @@ def normalize_expression(expression):
         result = re.sub(replaceRE, translate_if, result)
         result = re.sub('[ _]+', '_', result)
         return result
-    else:
-        return expression
+    return expression
 
 
 def __join_pair(key, value):
@@ -1368,8 +1438,7 @@ def __join_pair(key, value):
         return None
     elif value is True:
         return key
-    else:
-        return u"{0}=\"{1}\"".format(key, value)
+    return u"{0}=\"{1}\"".format(key, value)
 
 
 def html_attrs(attrs, only=None):
@@ -1379,10 +1448,15 @@ def html_attrs(attrs, only=None):
 def __safe_value(v):
     if isinstance(v, bool):
         return "1" if v else "0"
-    else:
-        return v
+    return v
 
 
+def __bool_string(v):
+    if isinstance(v, bool):
+        return "true" if v else "false"
+
+    return v
+
 def __crc(source):
     return str((zlib.crc32(to_bytearray(source)) & 0xffffffff) % 5 + 1)
 
diff --git a/requirements.txt b/requirements.txt
index 760747ea..a91534d0 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -8,7 +8,7 @@ bleach==6.1.0
 certifi==2024.2.2
 cheroot==10.0.0
 cherrypy==18.9.0
-cloudinary==1.34.0
+cloudinary==1.39.1
 distro==1.9.0
 dnspython==2.6.1
 facebook-sdk==3.1.0

From b01b21ae05cb1a7849c6f9cc695154977527e255 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sun, 24 Mar 2024 15:27:55 -0700
Subject: [PATCH 544/743] Bump importlib-resources from 6.0.1 to 6.4.0 (#2285)

* Bump importlib-resources from 6.0.1 to 6.4.0

Bumps [importlib-resources](https://github.com/python/importlib_resources) from 6.0.1 to 6.4.0.
- [Release notes](https://github.com/python/importlib_resources/releases)
- [Changelog](https://github.com/python/importlib_resources/blob/main/NEWS.rst)
- [Commits](https://github.com/python/importlib_resources/compare/v6.0.1...v6.4.0)

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

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

* Update importlib-resources==6.4.0

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/importlib_resources/__init__.py           |  19 ++
 lib/importlib_resources/_common.py            |   7 +-
 lib/importlib_resources/_compat.py            | 109 --------
 lib/importlib_resources/abc.py                |   3 +-
 .../{tests/zipdata01 => compat}/__init__.py   |   0
 lib/importlib_resources/compat/py38.py        |  11 +
 lib/importlib_resources/compat/py39.py        |  10 +
 lib/importlib_resources/functional.py         |  81 ++++++
 .../{tests/zipdata02 => future}/__init__.py   |   0
 lib/importlib_resources/future/adapters.py    |  95 +++++++
 lib/importlib_resources/readers.py            |  56 +++-
 lib/importlib_resources/simple.py             |   2 +-
 lib/importlib_resources/tests/_compat.py      |  32 ---
 .../tests/compat/__init__.py                  |   0
 lib/importlib_resources/tests/compat/py312.py |  18 ++
 lib/importlib_resources/tests/compat/py39.py  |  10 +
 .../tests/data01/subdirectory/binary.file     | Bin 4 -> 4 bytes
 .../namespacedata01/subdirectory/binary.file  |   1 +
 .../tests/test_contents.py                    |   2 +-
 lib/importlib_resources/tests/test_custom.py  |   8 +-
 lib/importlib_resources/tests/test_files.py   |  19 +-
 .../tests/test_functional.py                  | 242 ++++++++++++++++++
 lib/importlib_resources/tests/test_open.py    |   6 +-
 lib/importlib_resources/tests/test_path.py    |  12 +-
 lib/importlib_resources/tests/test_read.py    |  29 ++-
 lib/importlib_resources/tests/test_reader.py  |  29 ++-
 .../tests/test_resource.py                    | 133 +++++-----
 lib/importlib_resources/tests/update-zips.py  |  53 ----
 lib/importlib_resources/tests/util.py         |  51 ++--
 lib/importlib_resources/tests/zip.py          |  32 +++
 .../tests/zipdata01/ziptestdata.zip           | Bin 876 -> 0 bytes
 .../tests/zipdata02/ziptestdata.zip           | Bin 698 -> 0 bytes
 package/requirements-package.txt              |   2 +-
 requirements.txt                              |   2 +-
 34 files changed, 725 insertions(+), 349 deletions(-)
 delete mode 100644 lib/importlib_resources/_compat.py
 rename lib/importlib_resources/{tests/zipdata01 => compat}/__init__.py (100%)
 create mode 100644 lib/importlib_resources/compat/py38.py
 create mode 100644 lib/importlib_resources/compat/py39.py
 create mode 100644 lib/importlib_resources/functional.py
 rename lib/importlib_resources/{tests/zipdata02 => future}/__init__.py (100%)
 create mode 100644 lib/importlib_resources/future/adapters.py
 delete mode 100644 lib/importlib_resources/tests/_compat.py
 create mode 100644 lib/importlib_resources/tests/compat/__init__.py
 create mode 100644 lib/importlib_resources/tests/compat/py312.py
 create mode 100644 lib/importlib_resources/tests/compat/py39.py
 create mode 100644 lib/importlib_resources/tests/namespacedata01/subdirectory/binary.file
 create mode 100644 lib/importlib_resources/tests/test_functional.py
 delete mode 100644 lib/importlib_resources/tests/update-zips.py
 create mode 100644 lib/importlib_resources/tests/zip.py
 delete mode 100644 lib/importlib_resources/tests/zipdata01/ziptestdata.zip
 delete mode 100644 lib/importlib_resources/tests/zipdata02/ziptestdata.zip

diff --git a/lib/importlib_resources/__init__.py b/lib/importlib_resources/__init__.py
index e6b60c18..0d029abd 100644
--- a/lib/importlib_resources/__init__.py
+++ b/lib/importlib_resources/__init__.py
@@ -4,6 +4,17 @@ from ._common import (
     as_file,
     files,
     Package,
+    Anchor,
+)
+
+from .functional import (
+    contents,
+    is_resource,
+    open_binary,
+    open_text,
+    path,
+    read_binary,
+    read_text,
 )
 
 from .abc import ResourceReader
@@ -11,7 +22,15 @@ from .abc import ResourceReader
 
 __all__ = [
     'Package',
+    'Anchor',
     'ResourceReader',
     'as_file',
     'files',
+    'contents',
+    'is_resource',
+    'open_binary',
+    'open_text',
+    'path',
+    'read_binary',
+    'read_text',
 ]
diff --git a/lib/importlib_resources/_common.py b/lib/importlib_resources/_common.py
index 3c6de1cf..8df6b39e 100644
--- a/lib/importlib_resources/_common.py
+++ b/lib/importlib_resources/_common.py
@@ -12,8 +12,6 @@ import itertools
 from typing import Union, Optional, cast
 from .abc import ResourceReader, Traversable
 
-from ._compat import wrap_spec
-
 Package = Union[types.ModuleType, str]
 Anchor = Package
 
@@ -27,6 +25,8 @@ def package_to_anchor(func):
     >>> files('a', 'b')
     Traceback (most recent call last):
     TypeError: files() takes from 0 to 1 positional arguments but 2 were given
+
+    Remove this compatibility in Python 3.14.
     """
     undefined = object()
 
@@ -109,6 +109,9 @@ def from_package(package: types.ModuleType):
     Return a Traversable object for the given package.
 
     """
+    # deferred for performance (python/cpython#109829)
+    from .future.adapters import wrap_spec
+
     spec = wrap_spec(package)
     reader = spec.loader.get_resource_reader(spec.name)
     return reader.files()
diff --git a/lib/importlib_resources/_compat.py b/lib/importlib_resources/_compat.py
deleted file mode 100644
index a93a8826..00000000
--- a/lib/importlib_resources/_compat.py
+++ /dev/null
@@ -1,109 +0,0 @@
-# flake8: noqa
-
-import abc
-import os
-import sys
-import pathlib
-from contextlib import suppress
-from typing import Union
-
-
-if sys.version_info >= (3, 10):
-    from zipfile import Path as ZipPath  # type: ignore
-else:
-    from zipp import Path as ZipPath  # type: ignore
-
-
-try:
-    from typing import runtime_checkable  # type: ignore
-except ImportError:
-
-    def runtime_checkable(cls):  # type: ignore
-        return cls
-
-
-try:
-    from typing import Protocol  # type: ignore
-except ImportError:
-    Protocol = abc.ABC  # type: ignore
-
-
-class TraversableResourcesLoader:
-    """
-    Adapt loaders to provide TraversableResources and other
-    compatibility.
-
-    Used primarily for Python 3.9 and earlier where the native
-    loaders do not yet implement TraversableResources.
-    """
-
-    def __init__(self, spec):
-        self.spec = spec
-
-    @property
-    def path(self):
-        return self.spec.origin
-
-    def get_resource_reader(self, name):
-        from . import readers, _adapters
-
-        def _zip_reader(spec):
-            with suppress(AttributeError):
-                return readers.ZipReader(spec.loader, spec.name)
-
-        def _namespace_reader(spec):
-            with suppress(AttributeError, ValueError):
-                return readers.NamespaceReader(spec.submodule_search_locations)
-
-        def _available_reader(spec):
-            with suppress(AttributeError):
-                return spec.loader.get_resource_reader(spec.name)
-
-        def _native_reader(spec):
-            reader = _available_reader(spec)
-            return reader if hasattr(reader, 'files') else None
-
-        def _file_reader(spec):
-            try:
-                path = pathlib.Path(self.path)
-            except TypeError:
-                return None
-            if path.exists():
-                return readers.FileReader(self)
-
-        return (
-            # local ZipReader if a zip module
-            _zip_reader(self.spec)
-            or
-            # local NamespaceReader if a namespace module
-            _namespace_reader(self.spec)
-            or
-            # local FileReader
-            _file_reader(self.spec)
-            or
-            # native reader if it supplies 'files'
-            _native_reader(self.spec)
-            or
-            # fallback - adapt the spec ResourceReader to TraversableReader
-            _adapters.CompatibilityFiles(self.spec)
-        )
-
-
-def wrap_spec(package):
-    """
-    Construct a package spec with traversable compatibility
-    on the spec/loader/reader.
-
-    Supersedes _adapters.wrap_spec to use TraversableResourcesLoader
-    from above for older Python compatibility (<3.10).
-    """
-    from . import _adapters
-
-    return _adapters.SpecLoaderAdapter(package.__spec__, TraversableResourcesLoader)
-
-
-if sys.version_info >= (3, 9):
-    StrPath = Union[str, os.PathLike[str]]
-else:
-    # PathLike is only subscriptable at runtime in 3.9+
-    StrPath = Union[str, "os.PathLike[str]"]
diff --git a/lib/importlib_resources/abc.py b/lib/importlib_resources/abc.py
index 23b6aeaf..7a58dd2f 100644
--- a/lib/importlib_resources/abc.py
+++ b/lib/importlib_resources/abc.py
@@ -3,8 +3,9 @@ import io
 import itertools
 import pathlib
 from typing import Any, BinaryIO, Iterable, Iterator, NoReturn, Text, Optional
+from typing import runtime_checkable, Protocol
 
-from ._compat import runtime_checkable, Protocol, StrPath
+from .compat.py38 import StrPath
 
 
 __all__ = ["ResourceReader", "Traversable", "TraversableResources"]
diff --git a/lib/importlib_resources/tests/zipdata01/__init__.py b/lib/importlib_resources/compat/__init__.py
similarity index 100%
rename from lib/importlib_resources/tests/zipdata01/__init__.py
rename to lib/importlib_resources/compat/__init__.py
diff --git a/lib/importlib_resources/compat/py38.py b/lib/importlib_resources/compat/py38.py
new file mode 100644
index 00000000..4d548257
--- /dev/null
+++ b/lib/importlib_resources/compat/py38.py
@@ -0,0 +1,11 @@
+import os
+import sys
+
+from typing import Union
+
+
+if sys.version_info >= (3, 9):
+    StrPath = Union[str, os.PathLike[str]]
+else:
+    # PathLike is only subscriptable at runtime in 3.9+
+    StrPath = Union[str, "os.PathLike[str]"]
diff --git a/lib/importlib_resources/compat/py39.py b/lib/importlib_resources/compat/py39.py
new file mode 100644
index 00000000..ab87b9dc
--- /dev/null
+++ b/lib/importlib_resources/compat/py39.py
@@ -0,0 +1,10 @@
+import sys
+
+
+__all__ = ['ZipPath']
+
+
+if sys.version_info >= (3, 10):
+    from zipfile import Path as ZipPath  # type: ignore
+else:
+    from zipp import Path as ZipPath  # type: ignore
diff --git a/lib/importlib_resources/functional.py b/lib/importlib_resources/functional.py
new file mode 100644
index 00000000..f59416f2
--- /dev/null
+++ b/lib/importlib_resources/functional.py
@@ -0,0 +1,81 @@
+"""Simplified function-based API for importlib.resources"""
+
+import warnings
+
+from ._common import files, as_file
+
+
+_MISSING = object()
+
+
+def open_binary(anchor, *path_names):
+    """Open for binary reading the *resource* within *package*."""
+    return _get_resource(anchor, path_names).open('rb')
+
+
+def open_text(anchor, *path_names, encoding=_MISSING, errors='strict'):
+    """Open for text reading the *resource* within *package*."""
+    encoding = _get_encoding_arg(path_names, encoding)
+    resource = _get_resource(anchor, path_names)
+    return resource.open('r', encoding=encoding, errors=errors)
+
+
+def read_binary(anchor, *path_names):
+    """Read and return contents of *resource* within *package* as bytes."""
+    return _get_resource(anchor, path_names).read_bytes()
+
+
+def read_text(anchor, *path_names, encoding=_MISSING, errors='strict'):
+    """Read and return contents of *resource* within *package* as str."""
+    encoding = _get_encoding_arg(path_names, encoding)
+    resource = _get_resource(anchor, path_names)
+    return resource.read_text(encoding=encoding, errors=errors)
+
+
+def path(anchor, *path_names):
+    """Return the path to the *resource* as an actual file system path."""
+    return as_file(_get_resource(anchor, path_names))
+
+
+def is_resource(anchor, *path_names):
+    """Return ``True`` if there is a resource named *name* in the package,
+
+    Otherwise returns ``False``.
+    """
+    return _get_resource(anchor, path_names).is_file()
+
+
+def contents(anchor, *path_names):
+    """Return an iterable over the named resources within the package.
+
+    The iterable returns :class:`str` resources (e.g. files).
+    The iterable does not recurse into subdirectories.
+    """
+    warnings.warn(
+        "importlib.resources.contents is deprecated. "
+        "Use files(anchor).iterdir() instead.",
+        DeprecationWarning,
+        stacklevel=1,
+    )
+    return (resource.name for resource in _get_resource(anchor, path_names).iterdir())
+
+
+def _get_encoding_arg(path_names, encoding):
+    # For compatibility with versions where *encoding* was a positional
+    # argument, it needs to be given explicitly when there are multiple
+    # *path_names*.
+    # This limitation can be removed in Python 3.15.
+    if encoding is _MISSING:
+        if len(path_names) > 1:
+            raise TypeError(
+                "'encoding' argument required with multiple path names",
+            )
+        else:
+            return 'utf-8'
+    return encoding
+
+
+def _get_resource(anchor, path_names):
+    if anchor is None:
+        raise TypeError("anchor must be module or string, got None")
+    return files(anchor).joinpath(*path_names)
diff --git a/lib/importlib_resources/tests/zipdata02/__init__.py b/lib/importlib_resources/future/__init__.py
similarity index 100%
rename from lib/importlib_resources/tests/zipdata02/__init__.py
rename to lib/importlib_resources/future/__init__.py
diff --git a/lib/importlib_resources/future/adapters.py b/lib/importlib_resources/future/adapters.py
new file mode 100644
index 00000000..0e9764ba
--- /dev/null
+++ b/lib/importlib_resources/future/adapters.py
@@ -0,0 +1,95 @@
+import functools
+import pathlib
+from contextlib import suppress
+from types import SimpleNamespace
+
+from .. import readers, _adapters
+
+
+def _block_standard(reader_getter):
+    """
+    Wrap _adapters.TraversableResourcesLoader.get_resource_reader
+    and intercept any standard library readers.
+    """
+
+    @functools.wraps(reader_getter)
+    def wrapper(*args, **kwargs):
+        """
+        If the reader is from the standard library, return None to allow
+        allow likely newer implementations in this library to take precedence.
+        """
+        try:
+            reader = reader_getter(*args, **kwargs)
+        except NotADirectoryError:
+            # MultiplexedPath may fail on zip subdirectory
+            return
+        # Python 3.10+
+        mod_name = reader.__class__.__module__
+        if mod_name.startswith('importlib.') and mod_name.endswith('readers'):
+            return
+        # Python 3.8, 3.9
+        if isinstance(reader, _adapters.CompatibilityFiles) and (
+            reader.spec.loader.__class__.__module__.startswith('zipimport')
+            or reader.spec.loader.__class__.__module__.startswith(
+                '_frozen_importlib_external'
+            )
+        ):
+            return
+        return reader
+
+    return wrapper
+
+
+def _skip_degenerate(reader):
+    """
+    Mask any degenerate reader. Ref #298.
+    """
+    is_degenerate = (
+        isinstance(reader, _adapters.CompatibilityFiles) and not reader._reader
+    )
+    return reader if not is_degenerate else None
+
+
+class TraversableResourcesLoader(_adapters.TraversableResourcesLoader):
+    """
+    Adapt loaders to provide TraversableResources and other
+    compatibility.
+
+    Ensures the readers from importlib_resources are preferred
+    over stdlib readers.
+    """
+
+    def get_resource_reader(self, name):
+        return (
+            _skip_degenerate(_block_standard(super().get_resource_reader)(name))
+            or self._standard_reader()
+            or super().get_resource_reader(name)
+        )
+
+    def _standard_reader(self):
+        return self._zip_reader() or self._namespace_reader() or self._file_reader()
+
+    def _zip_reader(self):
+        with suppress(AttributeError):
+            return readers.ZipReader(self.spec.loader, self.spec.name)
+
+    def _namespace_reader(self):
+        with suppress(AttributeError, ValueError):
+            return readers.NamespaceReader(self.spec.submodule_search_locations)
+
+    def _file_reader(self):
+        try:
+            path = pathlib.Path(self.spec.origin)
+        except TypeError:
+            return None
+        if path.exists():
+            return readers.FileReader(SimpleNamespace(path=path))
+
+
+def wrap_spec(package):
+    """
+    Override _adapters.wrap_spec to use TraversableResourcesLoader
+    from above. Ensures that future behavior is always available on older
+    Pythons.
+    """
+    return _adapters.SpecLoaderAdapter(package.__spec__, TraversableResourcesLoader)
diff --git a/lib/importlib_resources/readers.py b/lib/importlib_resources/readers.py
index 51d030a6..4a80a774 100644
--- a/lib/importlib_resources/readers.py
+++ b/lib/importlib_resources/readers.py
@@ -1,12 +1,15 @@
 import collections
+import contextlib
 import itertools
 import pathlib
 import operator
+import re
+import warnings
 
 from . import abc
 
 from ._itertools import only
-from ._compat import ZipPath
+from .compat.py39 import ZipPath
 
 
 def remove_duplicates(items):
@@ -62,7 +65,7 @@ class MultiplexedPath(abc.Traversable):
     """
 
     def __init__(self, *paths):
-        self._paths = list(map(pathlib.Path, remove_duplicates(paths)))
+        self._paths = list(map(_ensure_traversable, remove_duplicates(paths)))
         if not self._paths:
             message = 'MultiplexedPath must contain at least one path'
             raise FileNotFoundError(message)
@@ -130,7 +133,36 @@ class NamespaceReader(abc.TraversableResources):
     def __init__(self, namespace_path):
         if 'NamespacePath' not in str(namespace_path):
             raise ValueError('Invalid path')
-        self.path = MultiplexedPath(*list(namespace_path))
+        self.path = MultiplexedPath(*map(self._resolve, namespace_path))
+
+    @classmethod
+    def _resolve(cls, path_str) -> abc.Traversable:
+        r"""
+        Given an item from a namespace path, resolve it to a Traversable.
+
+        path_str might be a directory on the filesystem or a path to a
+        zipfile plus the path within the zipfile, e.g. ``/foo/bar`` or
+        ``/foo/baz.zip/inner_dir`` or ``foo\baz.zip\inner_dir\sub``.
+        """
+        (dir,) = (cand for cand in cls._candidate_paths(path_str) if cand.is_dir())
+        return dir
+
+    @classmethod
+    def _candidate_paths(cls, path_str):
+        yield pathlib.Path(path_str)
+        yield from cls._resolve_zip_path(path_str)
+
+    @staticmethod
+    def _resolve_zip_path(path_str):
+        for match in reversed(list(re.finditer(r'[\\/]', path_str))):
+            with contextlib.suppress(
+                FileNotFoundError,
+                IsADirectoryError,
+                NotADirectoryError,
+                PermissionError,
+            ):
+                inner = path_str[match.end() :].replace('\\', '/') + '/'
+                yield ZipPath(path_str[: match.start()], inner.lstrip('/'))
 
     def resource_path(self, resource):
         """
@@ -142,3 +174,21 @@ class NamespaceReader(abc.TraversableResources):
 
     def files(self):
         return self.path
+
+
+def _ensure_traversable(path):
+    """
+    Convert deprecated string arguments to traversables (pathlib.Path).
+
+    Remove with Python 3.15.
+    """
+    if not isinstance(path, str):
+        return path
+
+    warnings.warn(
+        "String arguments are deprecated. Pass a Traversable instead.",
+        DeprecationWarning,
+        stacklevel=3,
+    )
+
+    return pathlib.Path(path)
diff --git a/lib/importlib_resources/simple.py b/lib/importlib_resources/simple.py
index 7770c922..96f117fe 100644
--- a/lib/importlib_resources/simple.py
+++ b/lib/importlib_resources/simple.py
@@ -88,7 +88,7 @@ class ResourceHandle(Traversable):
     def open(self, mode='r', *args, **kwargs):
         stream = self.parent.reader.open_binary(self.name)
         if 'b' not in mode:
-            stream = io.TextIOWrapper(*args, **kwargs)
+            stream = io.TextIOWrapper(stream, *args, **kwargs)
         return stream
 
     def joinpath(self, name):
diff --git a/lib/importlib_resources/tests/_compat.py b/lib/importlib_resources/tests/_compat.py
deleted file mode 100644
index e7bf06dd..00000000
--- a/lib/importlib_resources/tests/_compat.py
+++ /dev/null
@@ -1,32 +0,0 @@
-import os
-
-
-try:
-    from test.support import import_helper  # type: ignore
-except ImportError:
-    # Python 3.9 and earlier
-    class import_helper:  # type: ignore
-        from test.support import (
-            modules_setup,
-            modules_cleanup,
-            DirsOnSysPath,
-            CleanImport,
-        )
-
-
-try:
-    from test.support import os_helper  # type: ignore
-except ImportError:
-    # Python 3.9 compat
-    class os_helper:  # type:ignore
-        from test.support import temp_dir
-
-
-try:
-    # Python 3.10
-    from test.support.os_helper import unlink
-except ImportError:
-    from test.support import unlink as _unlink
-
-    def unlink(target):
-        return _unlink(os.fspath(target))
diff --git a/lib/importlib_resources/tests/compat/__init__.py b/lib/importlib_resources/tests/compat/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/lib/importlib_resources/tests/compat/py312.py b/lib/importlib_resources/tests/compat/py312.py
new file mode 100644
index 00000000..ea9a58ba
--- /dev/null
+++ b/lib/importlib_resources/tests/compat/py312.py
@@ -0,0 +1,18 @@
+import contextlib
+
+from .py39 import import_helper
+
+
+@contextlib.contextmanager
+def isolated_modules():
+    """
+    Save modules on entry and cleanup on exit.
+    """
+    (saved,) = import_helper.modules_setup()
+    try:
+        yield
+    finally:
+        import_helper.modules_cleanup(saved)
+
+
+vars(import_helper).setdefault('isolated_modules', isolated_modules)
diff --git a/lib/importlib_resources/tests/compat/py39.py b/lib/importlib_resources/tests/compat/py39.py
new file mode 100644
index 00000000..e158eb85
--- /dev/null
+++ b/lib/importlib_resources/tests/compat/py39.py
@@ -0,0 +1,10 @@
+"""
+Backward-compatability shims to support Python 3.9 and earlier.
+"""
+
+from jaraco.test.cpython import from_test_support, try_import
+
+import_helper = try_import('import_helper') or from_test_support(
+    'modules_setup', 'modules_cleanup', 'DirsOnSysPath'
+)
+os_helper = try_import('os_helper') or from_test_support('temp_dir')
diff --git a/lib/importlib_resources/tests/data01/subdirectory/binary.file b/lib/importlib_resources/tests/data01/subdirectory/binary.file
index eaf36c1daccfdf325514461cd1a2ffbc139b5464..5bd8bb897b13225c93a1d26baa88c96b7bd5d817 100644
GIT binary patch
literal 4
LcmZQ!Wn%{b05$*@

literal 4
LcmZQzWMT#Y01f~L

diff --git a/lib/importlib_resources/tests/namespacedata01/subdirectory/binary.file b/lib/importlib_resources/tests/namespacedata01/subdirectory/binary.file
new file mode 100644
index 00000000..100f5064
--- /dev/null
+++ b/lib/importlib_resources/tests/namespacedata01/subdirectory/binary.file
@@ -0,0 +1 @@
+

\ No newline at end of file
diff --git a/lib/importlib_resources/tests/test_contents.py b/lib/importlib_resources/tests/test_contents.py
index 525568e8..7dc3b0a6 100644
--- a/lib/importlib_resources/tests/test_contents.py
+++ b/lib/importlib_resources/tests/test_contents.py
@@ -31,8 +31,8 @@ class ContentsZipTests(ContentsTests, util.ZipSetup, unittest.TestCase):
 class ContentsNamespaceTests(ContentsTests, unittest.TestCase):
     expected = {
         # no __init__ because of namespace design
-        # no subdirectory as incidental difference in fixture
         'binary.file',
+        'subdirectory',
         'utf-16.file',
         'utf-8.file',
     }
diff --git a/lib/importlib_resources/tests/test_custom.py b/lib/importlib_resources/tests/test_custom.py
index e85ddd65..86c65676 100644
--- a/lib/importlib_resources/tests/test_custom.py
+++ b/lib/importlib_resources/tests/test_custom.py
@@ -3,9 +3,10 @@ import contextlib
 import pathlib
 
 import importlib_resources as resources
+from .. import abc
 from ..abc import TraversableResources, ResourceReader
 from . import util
-from ._compat import os_helper
+from .compat.py39 import os_helper
 
 
 class SimpleLoader:
@@ -38,8 +39,9 @@ class CustomTraversableResourcesTests(unittest.TestCase):
         self.addCleanup(self.fixtures.close)
 
     def test_custom_loader(self):
-        temp_dir = self.fixtures.enter_context(os_helper.temp_dir())
+        temp_dir = pathlib.Path(self.fixtures.enter_context(os_helper.temp_dir()))
         loader = SimpleLoader(MagicResources(temp_dir))
         pkg = util.create_package_from_loader(loader)
         files = resources.files(pkg)
-        assert files is temp_dir
+        assert isinstance(files, abc.Traversable)
+        assert list(files.iterdir()) == []
diff --git a/lib/importlib_resources/tests/test_files.py b/lib/importlib_resources/tests/test_files.py
index 197a063b..3e86ec64 100644
--- a/lib/importlib_resources/tests/test_files.py
+++ b/lib/importlib_resources/tests/test_files.py
@@ -1,4 +1,3 @@
-import typing
 import textwrap
 import unittest
 import warnings
@@ -10,7 +9,8 @@ from ..abc import Traversable
 from . import data01
 from . import util
 from . import _path
-from ._compat import os_helper, import_helper
+from .compat.py39 import os_helper
+from .compat.py312 import import_helper
 
 
 @contextlib.contextmanager
@@ -31,13 +31,14 @@ class FilesTests:
         actual = files.joinpath('utf-8.file').read_text(encoding='utf-8')
         assert actual == 'Hello, UTF-8 world!\n'
 
-    @unittest.skipUnless(
-        hasattr(typing, 'runtime_checkable'),
-        "Only suitable when typing supports runtime_checkable",
-    )
     def test_traversable(self):
         assert isinstance(resources.files(self.data), Traversable)
 
+    def test_joinpath_with_multiple_args(self):
+        files = resources.files(self.data)
+        binfile = files.joinpath('subdirectory', 'binary.file')
+        self.assertTrue(binfile.is_file())
+
     def test_old_parameter(self):
         """
         Files used to take a 'package' parameter. Make sure anyone
@@ -63,13 +64,17 @@ class OpenNamespaceTests(FilesTests, unittest.TestCase):
         self.data = namespacedata01
 
 
+class OpenNamespaceZipTests(FilesTests, util.ZipSetup, unittest.TestCase):
+    ZIP_MODULE = 'namespacedata01'
+
+
 class SiteDir:
     def setUp(self):
         self.fixtures = contextlib.ExitStack()
         self.addCleanup(self.fixtures.close)
         self.site_dir = self.fixtures.enter_context(os_helper.temp_dir())
         self.fixtures.enter_context(import_helper.DirsOnSysPath(self.site_dir))
-        self.fixtures.enter_context(import_helper.CleanImport())
+        self.fixtures.enter_context(import_helper.isolated_modules())
 
 
 class ModulesFilesTests(SiteDir, unittest.TestCase):
diff --git a/lib/importlib_resources/tests/test_functional.py b/lib/importlib_resources/tests/test_functional.py
new file mode 100644
index 00000000..69706cf7
--- /dev/null
+++ b/lib/importlib_resources/tests/test_functional.py
@@ -0,0 +1,242 @@
+import unittest
+import os
+import contextlib
+
+try:
+    from test.support.warnings_helper import ignore_warnings, check_warnings
+except ImportError:
+    # older Python versions
+    from test.support import ignore_warnings, check_warnings
+
+import importlib_resources as resources
+
+# Since the functional API forwards to Traversable, we only test
+# filesystem resources here -- not zip files, namespace packages etc.
+# We do test for two kinds of Anchor, though.
+
+
+class StringAnchorMixin:
+    anchor01 = 'importlib_resources.tests.data01'
+    anchor02 = 'importlib_resources.tests.data02'
+
+
+class ModuleAnchorMixin:
+    from . import data01 as anchor01
+    from . import data02 as anchor02
+
+
+class FunctionalAPIBase:
+    def _gen_resourcetxt_path_parts(self):
+        """Yield various names of a text file in anchor02, each in a subTest"""
+        for path_parts in (
+            ('subdirectory', 'subsubdir', 'resource.txt'),
+            ('subdirectory/subsubdir/resource.txt',),
+            ('subdirectory/subsubdir', 'resource.txt'),
+        ):
+            with self.subTest(path_parts=path_parts):
+                yield path_parts
+
+    def test_read_text(self):
+        self.assertEqual(
+            resources.read_text(self.anchor01, 'utf-8.file'),
+            'Hello, UTF-8 world!\n',
+        )
+        self.assertEqual(
+            resources.read_text(
+                self.anchor02,
+                'subdirectory',
+                'subsubdir',
+                'resource.txt',
+                encoding='utf-8',
+            ),
+            'a resource',
+        )
+        for path_parts in self._gen_resourcetxt_path_parts():
+            self.assertEqual(
+                resources.read_text(
+                    self.anchor02,
+                    *path_parts,
+                    encoding='utf-8',
+                ),
+                'a resource',
+            )
+        # Use generic OSError, since e.g. attempting to read a directory can
+        # fail with PermissionError rather than IsADirectoryError
+        with self.assertRaises(OSError):
+            resources.read_text(self.anchor01)
+        with self.assertRaises(OSError):
+            resources.read_text(self.anchor01, 'no-such-file')
+        with self.assertRaises(UnicodeDecodeError):
+            resources.read_text(self.anchor01, 'utf-16.file')
+        self.assertEqual(
+            resources.read_text(
+                self.anchor01,
+                'binary.file',
+                encoding='latin1',
+            ),
+            '\x00\x01\x02\x03',
+        )
+        self.assertEqual(
+            resources.read_text(
+                self.anchor01,
+                'utf-16.file',
+                errors='backslashreplace',
+            ),
+            'Hello, UTF-16 world!\n'.encode('utf-16').decode(
+                errors='backslashreplace',
+            ),
+        )
+
+    def test_read_binary(self):
+        self.assertEqual(
+            resources.read_binary(self.anchor01, 'utf-8.file'),
+            b'Hello, UTF-8 world!\n',
+        )
+        for path_parts in self._gen_resourcetxt_path_parts():
+            self.assertEqual(
+                resources.read_binary(self.anchor02, *path_parts),
+                b'a resource',
+            )
+
+    def test_open_text(self):
+        with resources.open_text(self.anchor01, 'utf-8.file') as f:
+            self.assertEqual(f.read(), 'Hello, UTF-8 world!\n')
+        for path_parts in self._gen_resourcetxt_path_parts():
+            with resources.open_text(
+                self.anchor02,
+                *path_parts,
+                encoding='utf-8',
+            ) as f:
+                self.assertEqual(f.read(), 'a resource')
+        # Use generic OSError, since e.g. attempting to read a directory can
+        # fail with PermissionError rather than IsADirectoryError
+        with self.assertRaises(OSError):
+            resources.open_text(self.anchor01)
+        with self.assertRaises(OSError):
+            resources.open_text(self.anchor01, 'no-such-file')
+        with resources.open_text(self.anchor01, 'utf-16.file') as f:
+            with self.assertRaises(UnicodeDecodeError):
+                f.read()
+        with resources.open_text(
+            self.anchor01,
+            'binary.file',
+            encoding='latin1',
+        ) as f:
+            self.assertEqual(f.read(), '\x00\x01\x02\x03')
+        with resources.open_text(
+            self.anchor01,
+            'utf-16.file',
+            errors='backslashreplace',
+        ) as f:
+            self.assertEqual(
+                f.read(),
+                'Hello, UTF-16 world!\n'.encode('utf-16').decode(
+                    errors='backslashreplace',
+                ),
+            )
+
+    def test_open_binary(self):
+        with resources.open_binary(self.anchor01, 'utf-8.file') as f:
+            self.assertEqual(f.read(), b'Hello, UTF-8 world!\n')
+        for path_parts in self._gen_resourcetxt_path_parts():
+            with resources.open_binary(
+                self.anchor02,
+                *path_parts,
+            ) as f:
+                self.assertEqual(f.read(), b'a resource')
+
+    def test_path(self):
+        with resources.path(self.anchor01, 'utf-8.file') as path:
+            with open(str(path), encoding='utf-8') as f:
+                self.assertEqual(f.read(), 'Hello, UTF-8 world!\n')
+        with resources.path(self.anchor01) as path:
+            with open(os.path.join(path, 'utf-8.file'), encoding='utf-8') as f:
+                self.assertEqual(f.read(), 'Hello, UTF-8 world!\n')
+
+    def test_is_resource(self):
+        is_resource = resources.is_resource
+        self.assertTrue(is_resource(self.anchor01, 'utf-8.file'))
+        self.assertFalse(is_resource(self.anchor01, 'no_such_file'))
+        self.assertFalse(is_resource(self.anchor01))
+        self.assertFalse(is_resource(self.anchor01, 'subdirectory'))
+        for path_parts in self._gen_resourcetxt_path_parts():
+            self.assertTrue(is_resource(self.anchor02, *path_parts))
+
+    def test_contents(self):
+        with check_warnings((".*contents.*", DeprecationWarning)):
+            c = resources.contents(self.anchor01)
+        self.assertGreaterEqual(
+            set(c),
+            {'utf-8.file', 'utf-16.file', 'binary.file', 'subdirectory'},
+        )
+        with contextlib.ExitStack() as cm:
+            cm.enter_context(self.assertRaises(OSError))
+            cm.enter_context(check_warnings((".*contents.*", DeprecationWarning)))
+
+            list(resources.contents(self.anchor01, 'utf-8.file'))
+
+        for path_parts in self._gen_resourcetxt_path_parts():
+            with contextlib.ExitStack() as cm:
+                cm.enter_context(self.assertRaises(OSError))
+                cm.enter_context(check_warnings((".*contents.*", DeprecationWarning)))
+
+                list(resources.contents(self.anchor01, *path_parts))
+        with check_warnings((".*contents.*", DeprecationWarning)):
+            c = resources.contents(self.anchor01, 'subdirectory')
+        self.assertGreaterEqual(
+            set(c),
+            {'binary.file'},
+        )
+
+    @ignore_warnings(category=DeprecationWarning)
+    def test_common_errors(self):
+        for func in (
+            resources.read_text,
+            resources.read_binary,
+            resources.open_text,
+            resources.open_binary,
+            resources.path,
+            resources.is_resource,
+            resources.contents,
+        ):
+            with self.subTest(func=func):
+                # Rejecting None anchor
+                with self.assertRaises(TypeError):
+                    func(None)
+                # Rejecting invalid anchor type
+                with self.assertRaises((TypeError, AttributeError)):
+                    func(1234)
+                # Unknown module
+                with self.assertRaises(ModuleNotFoundError):
+                    func('$missing module$')
+
+    def test_text_errors(self):
+        for func in (
+            resources.read_text,
+            resources.open_text,
+        ):
+            with self.subTest(func=func):
+                # Multiple path arguments need explicit encoding argument.
+                with self.assertRaises(TypeError):
+                    func(
+                        self.anchor02,
+                        'subdirectory',
+                        'subsubdir',
+                        'resource.txt',
+                    )
+
+
+class FunctionalAPITest_StringAnchor(
+    unittest.TestCase,
+    FunctionalAPIBase,
+    StringAnchorMixin,
+):
+    pass
+
+
+class FunctionalAPITest_ModuleAnchor(
+    unittest.TestCase,
+    FunctionalAPIBase,
+    ModuleAnchorMixin,
+):
+    pass
diff --git a/lib/importlib_resources/tests/test_open.py b/lib/importlib_resources/tests/test_open.py
index 83b737dc..44f1018a 100644
--- a/lib/importlib_resources/tests/test_open.py
+++ b/lib/importlib_resources/tests/test_open.py
@@ -24,7 +24,7 @@ class OpenTests:
         target = resources.files(self.data) / 'binary.file'
         with target.open('rb') as fp:
             result = fp.read()
-            self.assertEqual(result, b'\x00\x01\x02\x03')
+            self.assertEqual(result, bytes(range(4)))
 
     def test_open_text_default_encoding(self):
         target = resources.files(self.data) / 'utf-8.file'
@@ -81,5 +81,9 @@ class OpenZipTests(OpenTests, util.ZipSetup, unittest.TestCase):
     pass
 
 
+class OpenNamespaceZipTests(OpenTests, util.ZipSetup, unittest.TestCase):
+    ZIP_MODULE = 'namespacedata01'
+
+
 if __name__ == '__main__':
     unittest.main()
diff --git a/lib/importlib_resources/tests/test_path.py b/lib/importlib_resources/tests/test_path.py
index 7cb20003..c3e1cbb4 100644
--- a/lib/importlib_resources/tests/test_path.py
+++ b/lib/importlib_resources/tests/test_path.py
@@ -1,4 +1,5 @@
 import io
+import pathlib
 import unittest
 
 import importlib_resources as resources
@@ -15,18 +16,13 @@ class CommonTests(util.CommonTests, unittest.TestCase):
 class PathTests:
     def test_reading(self):
         """
-        Path should be readable.
-
-        Test also implicitly verifies the returned object is a pathlib.Path
-        instance.
+        Path should be readable and a pathlib.Path instance.
         """
         target = resources.files(self.data) / 'utf-8.file'
         with resources.as_file(target) as path:
+            self.assertIsInstance(path, pathlib.Path)
             self.assertTrue(path.name.endswith("utf-8.file"), repr(path))
-            # pathlib.Path.read_text() was introduced in Python 3.5.
-            with path.open('r', encoding='utf-8') as file:
-                text = file.read()
-            self.assertEqual('Hello, UTF-8 world!\n', text)
+            self.assertEqual('Hello, UTF-8 world!\n', path.read_text(encoding='utf-8'))
 
 
 class PathDiskTests(PathTests, unittest.TestCase):
diff --git a/lib/importlib_resources/tests/test_read.py b/lib/importlib_resources/tests/test_read.py
index b5aaec45..97d90128 100644
--- a/lib/importlib_resources/tests/test_read.py
+++ b/lib/importlib_resources/tests/test_read.py
@@ -19,7 +19,7 @@ class CommonTextTests(util.CommonTests, unittest.TestCase):
 class ReadTests:
     def test_read_bytes(self):
         result = resources.files(self.data).joinpath('binary.file').read_bytes()
-        self.assertEqual(result, b'\0\1\2\3')
+        self.assertEqual(result, bytes(range(4)))
 
     def test_read_text_default_encoding(self):
         result = (
@@ -58,17 +58,15 @@ class ReadDiskTests(ReadTests, unittest.TestCase):
 
 class ReadZipTests(ReadTests, util.ZipSetup, unittest.TestCase):
     def test_read_submodule_resource(self):
-        submodule = import_module('ziptestdata.subdirectory')
+        submodule = import_module('data01.subdirectory')
         result = resources.files(submodule).joinpath('binary.file').read_bytes()
-        self.assertEqual(result, b'\0\1\2\3')
+        self.assertEqual(result, bytes(range(4, 8)))
 
     def test_read_submodule_resource_by_name(self):
         result = (
-            resources.files('ziptestdata.subdirectory')
-            .joinpath('binary.file')
-            .read_bytes()
+            resources.files('data01.subdirectory').joinpath('binary.file').read_bytes()
         )
-        self.assertEqual(result, b'\0\1\2\3')
+        self.assertEqual(result, bytes(range(4, 8)))
 
 
 class ReadNamespaceTests(ReadTests, unittest.TestCase):
@@ -78,5 +76,22 @@ class ReadNamespaceTests(ReadTests, unittest.TestCase):
         self.data = namespacedata01
 
 
+class ReadNamespaceZipTests(ReadTests, util.ZipSetup, unittest.TestCase):
+    ZIP_MODULE = 'namespacedata01'
+
+    def test_read_submodule_resource(self):
+        submodule = import_module('namespacedata01.subdirectory')
+        result = resources.files(submodule).joinpath('binary.file').read_bytes()
+        self.assertEqual(result, bytes(range(12, 16)))
+
+    def test_read_submodule_resource_by_name(self):
+        result = (
+            resources.files('namespacedata01.subdirectory')
+            .joinpath('binary.file')
+            .read_bytes()
+        )
+        self.assertEqual(result, bytes(range(12, 16)))
+
+
 if __name__ == '__main__':
     unittest.main()
diff --git a/lib/importlib_resources/tests/test_reader.py b/lib/importlib_resources/tests/test_reader.py
index e2bdf19c..95c2fc85 100644
--- a/lib/importlib_resources/tests/test_reader.py
+++ b/lib/importlib_resources/tests/test_reader.py
@@ -10,8 +10,7 @@ from importlib_resources.readers import MultiplexedPath, NamespaceReader
 class MultiplexedPathTest(unittest.TestCase):
     @classmethod
     def setUpClass(cls):
-        path = pathlib.Path(__file__).parent / 'namespacedata01'
-        cls.folder = str(path)
+        cls.folder = pathlib.Path(__file__).parent / 'namespacedata01'
 
     def test_init_no_paths(self):
         with self.assertRaises(FileNotFoundError):
@@ -19,7 +18,7 @@ class MultiplexedPathTest(unittest.TestCase):
 
     def test_init_file(self):
         with self.assertRaises(NotADirectoryError):
-            MultiplexedPath(os.path.join(self.folder, 'binary.file'))
+            MultiplexedPath(self.folder / 'binary.file')
 
     def test_iterdir(self):
         contents = {path.name for path in MultiplexedPath(self.folder).iterdir()}
@@ -27,10 +26,12 @@ class MultiplexedPathTest(unittest.TestCase):
             contents.remove('__pycache__')
         except (KeyError, ValueError):
             pass
-        self.assertEqual(contents, {'binary.file', 'utf-16.file', 'utf-8.file'})
+        self.assertEqual(
+            contents, {'subdirectory', 'binary.file', 'utf-16.file', 'utf-8.file'}
+        )
 
     def test_iterdir_duplicate(self):
-        data01 = os.path.abspath(os.path.join(__file__, '..', 'data01'))
+        data01 = pathlib.Path(__file__).parent.joinpath('data01')
         contents = {
             path.name for path in MultiplexedPath(self.folder, data01).iterdir()
         }
@@ -60,17 +61,17 @@ class MultiplexedPathTest(unittest.TestCase):
             path.open()
 
     def test_join_path(self):
-        prefix = os.path.abspath(os.path.join(__file__, '..'))
-        data01 = os.path.join(prefix, 'data01')
+        data01 = pathlib.Path(__file__).parent.joinpath('data01')
+        prefix = str(data01.parent)
         path = MultiplexedPath(self.folder, data01)
         self.assertEqual(
             str(path.joinpath('binary.file'))[len(prefix) + 1 :],
             os.path.join('namespacedata01', 'binary.file'),
         )
-        self.assertEqual(
-            str(path.joinpath('subdirectory'))[len(prefix) + 1 :],
-            os.path.join('data01', 'subdirectory'),
-        )
+        sub = path.joinpath('subdirectory')
+        assert isinstance(sub, MultiplexedPath)
+        assert 'namespacedata01' in str(sub)
+        assert 'data01' in str(sub)
         self.assertEqual(
             str(path.joinpath('imaginary'))[len(prefix) + 1 :],
             os.path.join('namespacedata01', 'imaginary'),
@@ -82,9 +83,9 @@ class MultiplexedPathTest(unittest.TestCase):
         assert not path.joinpath('imaginary/foo.py').exists()
 
     def test_join_path_common_subdir(self):
-        prefix = os.path.abspath(os.path.join(__file__, '..'))
-        data01 = os.path.join(prefix, 'data01')
-        data02 = os.path.join(prefix, 'data02')
+        data01 = pathlib.Path(__file__).parent.joinpath('data01')
+        data02 = pathlib.Path(__file__).parent.joinpath('data02')
+        prefix = str(data01.parent)
         path = MultiplexedPath(data01, data02)
         self.assertIsInstance(path.joinpath('subdirectory'), MultiplexedPath)
         self.assertEqual(
diff --git a/lib/importlib_resources/tests/test_resource.py b/lib/importlib_resources/tests/test_resource.py
index 677110cd..dc2a108c 100644
--- a/lib/importlib_resources/tests/test_resource.py
+++ b/lib/importlib_resources/tests/test_resource.py
@@ -1,15 +1,11 @@
-import contextlib
 import sys
 import unittest
 import importlib_resources as resources
-import uuid
 import pathlib
 
 from . import data01
-from . import zipdata01, zipdata02
 from . import util
 from importlib import import_module
-from ._compat import import_helper, os_helper, unlink
 
 
 class ResourceTests:
@@ -89,34 +85,32 @@ class ResourceCornerCaseTests(unittest.TestCase):
 
 
 class ResourceFromZipsTest01(util.ZipSetupBase, unittest.TestCase):
-    ZIP_MODULE = zipdata01  # type: ignore
+    ZIP_MODULE = 'data01'
 
     def test_is_submodule_resource(self):
-        submodule = import_module('ziptestdata.subdirectory')
+        submodule = import_module('data01.subdirectory')
         self.assertTrue(resources.files(submodule).joinpath('binary.file').is_file())
 
     def test_read_submodule_resource_by_name(self):
         self.assertTrue(
-            resources.files('ziptestdata.subdirectory')
-            .joinpath('binary.file')
-            .is_file()
+            resources.files('data01.subdirectory').joinpath('binary.file').is_file()
         )
 
     def test_submodule_contents(self):
-        submodule = import_module('ziptestdata.subdirectory')
+        submodule = import_module('data01.subdirectory')
         self.assertEqual(
             names(resources.files(submodule)), {'__init__.py', 'binary.file'}
         )
 
     def test_submodule_contents_by_name(self):
         self.assertEqual(
-            names(resources.files('ziptestdata.subdirectory')),
+            names(resources.files('data01.subdirectory')),
             {'__init__.py', 'binary.file'},
         )
 
     def test_as_file_directory(self):
-        with resources.as_file(resources.files('ziptestdata')) as data:
-            assert data.name == 'ziptestdata'
+        with resources.as_file(resources.files('data01')) as data:
+            assert data.name == 'data01'
             assert data.is_dir()
             assert data.joinpath('subdirectory').is_dir()
             assert len(list(data.iterdir()))
@@ -124,7 +118,7 @@ class ResourceFromZipsTest01(util.ZipSetupBase, unittest.TestCase):
 
 
 class ResourceFromZipsTest02(util.ZipSetupBase, unittest.TestCase):
-    ZIP_MODULE = zipdata02  # type: ignore
+    ZIP_MODULE = 'data02'
 
     def test_unrelated_contents(self):
         """
@@ -132,93 +126,48 @@ class ResourceFromZipsTest02(util.ZipSetupBase, unittest.TestCase):
         distinct resources. Ref python/importlib_resources#44.
         """
         self.assertEqual(
-            names(resources.files('ziptestdata.one')),
+            names(resources.files('data02.one')),
             {'__init__.py', 'resource1.txt'},
         )
         self.assertEqual(
-            names(resources.files('ziptestdata.two')),
+            names(resources.files('data02.two')),
             {'__init__.py', 'resource2.txt'},
         )
 
 
-@contextlib.contextmanager
-def zip_on_path(dir):
-    data_path = pathlib.Path(zipdata01.__file__)
-    source_zip_path = data_path.parent.joinpath('ziptestdata.zip')
-    zip_path = pathlib.Path(dir) / f'{uuid.uuid4()}.zip'
-    zip_path.write_bytes(source_zip_path.read_bytes())
-    sys.path.append(str(zip_path))
-    import_module('ziptestdata')
-
-    try:
-        yield
-    finally:
-        with contextlib.suppress(ValueError):
-            sys.path.remove(str(zip_path))
-
-        with contextlib.suppress(KeyError):
-            del sys.path_importer_cache[str(zip_path)]
-            del sys.modules['ziptestdata']
-
-        with contextlib.suppress(OSError):
-            unlink(zip_path)
-
-
-class DeletingZipsTest(unittest.TestCase):
+class DeletingZipsTest(util.ZipSetupBase, unittest.TestCase):
     """Having accessed resources in a zip file should not keep an open
     reference to the zip.
     """
 
-    def setUp(self):
-        self.fixtures = contextlib.ExitStack()
-        self.addCleanup(self.fixtures.close)
-
-        modules = import_helper.modules_setup()
-        self.addCleanup(import_helper.modules_cleanup, *modules)
-
-        temp_dir = self.fixtures.enter_context(os_helper.temp_dir())
-        self.fixtures.enter_context(zip_on_path(temp_dir))
-
     def test_iterdir_does_not_keep_open(self):
-        [item.name for item in resources.files('ziptestdata').iterdir()]
+        [item.name for item in resources.files('data01').iterdir()]
 
     def test_is_file_does_not_keep_open(self):
-        resources.files('ziptestdata').joinpath('binary.file').is_file()
+        resources.files('data01').joinpath('binary.file').is_file()
 
     def test_is_file_failure_does_not_keep_open(self):
-        resources.files('ziptestdata').joinpath('not-present').is_file()
+        resources.files('data01').joinpath('not-present').is_file()
 
     @unittest.skip("Desired but not supported.")
     def test_as_file_does_not_keep_open(self):  # pragma: no cover
-        resources.as_file(resources.files('ziptestdata') / 'binary.file')
+        resources.as_file(resources.files('data01') / 'binary.file')
 
     def test_entered_path_does_not_keep_open(self):
         """
         Mimic what certifi does on import to make its bundle
         available for the process duration.
         """
-        resources.as_file(resources.files('ziptestdata') / 'binary.file').__enter__()
+        resources.as_file(resources.files('data01') / 'binary.file').__enter__()
 
     def test_read_binary_does_not_keep_open(self):
-        resources.files('ziptestdata').joinpath('binary.file').read_bytes()
+        resources.files('data01').joinpath('binary.file').read_bytes()
 
     def test_read_text_does_not_keep_open(self):
-        resources.files('ziptestdata').joinpath('utf-8.file').read_text(
-            encoding='utf-8'
-        )
+        resources.files('data01').joinpath('utf-8.file').read_text(encoding='utf-8')
 
 
-class ResourceFromNamespaceTest01(unittest.TestCase):
-    site_dir = str(pathlib.Path(__file__).parent)
-
-    @classmethod
-    def setUpClass(cls):
-        sys.path.append(cls.site_dir)
-
-    @classmethod
-    def tearDownClass(cls):
-        sys.path.remove(cls.site_dir)
-
+class ResourceFromNamespaceTests:
     def test_is_submodule_resource(self):
         self.assertTrue(
             resources.files(import_module('namespacedata01'))
@@ -237,7 +186,9 @@ class ResourceFromNamespaceTest01(unittest.TestCase):
             contents.remove('__pycache__')
         except KeyError:
             pass
-        self.assertEqual(contents, {'binary.file', 'utf-8.file', 'utf-16.file'})
+        self.assertEqual(
+            contents, {'subdirectory', 'binary.file', 'utf-8.file', 'utf-16.file'}
+        )
 
     def test_submodule_contents_by_name(self):
         contents = names(resources.files('namespacedata01'))
@@ -245,7 +196,45 @@ class ResourceFromNamespaceTest01(unittest.TestCase):
             contents.remove('__pycache__')
         except KeyError:
             pass
-        self.assertEqual(contents, {'binary.file', 'utf-8.file', 'utf-16.file'})
+        self.assertEqual(
+            contents, {'subdirectory', 'binary.file', 'utf-8.file', 'utf-16.file'}
+        )
+
+    def test_submodule_sub_contents(self):
+        contents = names(resources.files(import_module('namespacedata01.subdirectory')))
+        try:
+            contents.remove('__pycache__')
+        except KeyError:
+            pass
+        self.assertEqual(contents, {'binary.file'})
+
+    def test_submodule_sub_contents_by_name(self):
+        contents = names(resources.files('namespacedata01.subdirectory'))
+        try:
+            contents.remove('__pycache__')
+        except KeyError:
+            pass
+        self.assertEqual(contents, {'binary.file'})
+
+
+class ResourceFromNamespaceDiskTests(ResourceFromNamespaceTests, unittest.TestCase):
+    site_dir = str(pathlib.Path(__file__).parent)
+
+    @classmethod
+    def setUpClass(cls):
+        sys.path.append(cls.site_dir)
+
+    @classmethod
+    def tearDownClass(cls):
+        sys.path.remove(cls.site_dir)
+
+
+class ResourceFromNamespaceZipTests(
+    util.ZipSetupBase,
+    ResourceFromNamespaceTests,
+    unittest.TestCase,
+):
+    ZIP_MODULE = 'namespacedata01'
 
 
 if __name__ == '__main__':
diff --git a/lib/importlib_resources/tests/update-zips.py b/lib/importlib_resources/tests/update-zips.py
deleted file mode 100644
index 231334aa..00000000
--- a/lib/importlib_resources/tests/update-zips.py
+++ /dev/null
@@ -1,53 +0,0 @@
-"""
-Generate the zip test data files.
-
-Run to build the tests/zipdataNN/ziptestdata.zip files from
-files in tests/dataNN.
-
-Replaces the file with the working copy, but does commit anything
-to the source repo.
-"""
-
-import contextlib
-import os
-import pathlib
-import zipfile
-
-
-def main():
-    """
-    >>> from unittest import mock
-    >>> monkeypatch = getfixture('monkeypatch')
-    >>> monkeypatch.setattr(zipfile, 'ZipFile', mock.MagicMock())
-    >>> print(); main()  # print workaround for bpo-32509
-    <BLANKLINE>
-    ...data01... -> ziptestdata/...
-    ...
-    ...data02... -> ziptestdata/...
-    ...
-    """
-    suffixes = '01', '02'
-    tuple(map(generate, suffixes))
-
-
-def generate(suffix):
-    root = pathlib.Path(__file__).parent.relative_to(os.getcwd())
-    zfpath = root / f'zipdata{suffix}/ziptestdata.zip'
-    with zipfile.ZipFile(zfpath, 'w') as zf:
-        for src, rel in walk(root / f'data{suffix}'):
-            dst = 'ziptestdata' / pathlib.PurePosixPath(rel.as_posix())
-            print(src, '->', dst)
-            zf.write(src, dst)
-
-
-def walk(datapath):
-    for dirpath, dirnames, filenames in os.walk(datapath):
-        with contextlib.suppress(ValueError):
-            dirnames.remove('__pycache__')
-        for filename in filenames:
-            res = pathlib.Path(dirpath) / filename
-            rel = res.relative_to(datapath)
-            yield res, rel
-
-
-__name__ == '__main__' and main()
diff --git a/lib/importlib_resources/tests/util.py b/lib/importlib_resources/tests/util.py
index ce0e6fad..fb827d2f 100644
--- a/lib/importlib_resources/tests/util.py
+++ b/lib/importlib_resources/tests/util.py
@@ -4,11 +4,12 @@ import io
 import sys
 import types
 import pathlib
+import contextlib
 
 from . import data01
-from . import zipdata01
 from ..abc import ResourceReader
-from ._compat import import_helper
+from .compat.py39 import import_helper, os_helper
+from . import zip as zip_
 
 
 from importlib.machinery import ModuleSpec
@@ -141,39 +142,23 @@ class CommonTests(metaclass=abc.ABCMeta):
 
 
 class ZipSetupBase:
-    ZIP_MODULE = None
-
-    @classmethod
-    def setUpClass(cls):
-        data_path = pathlib.Path(cls.ZIP_MODULE.__file__)
-        data_dir = data_path.parent
-        cls._zip_path = str(data_dir / 'ziptestdata.zip')
-        sys.path.append(cls._zip_path)
-        cls.data = importlib.import_module('ziptestdata')
-
-    @classmethod
-    def tearDownClass(cls):
-        try:
-            sys.path.remove(cls._zip_path)
-        except ValueError:
-            pass
-
-        try:
-            del sys.path_importer_cache[cls._zip_path]
-            del sys.modules[cls.data.__name__]
-        except KeyError:
-            pass
-
-        try:
-            del cls.data
-            del cls._zip_path
-        except AttributeError:
-            pass
+    ZIP_MODULE = 'data01'
 
     def setUp(self):
-        modules = import_helper.modules_setup()
-        self.addCleanup(import_helper.modules_cleanup, *modules)
+        self.fixtures = contextlib.ExitStack()
+        self.addCleanup(self.fixtures.close)
+
+        self.fixtures.enter_context(import_helper.isolated_modules())
+
+        temp_dir = self.fixtures.enter_context(os_helper.temp_dir())
+        modules = pathlib.Path(temp_dir) / 'zipped modules.zip'
+        src_path = pathlib.Path(__file__).parent.joinpath(self.ZIP_MODULE)
+        self.fixtures.enter_context(
+            import_helper.DirsOnSysPath(str(zip_.make_zip_file(src_path, modules)))
+        )
+
+        self.data = importlib.import_module(self.ZIP_MODULE)
 
 
 class ZipSetup(ZipSetupBase):
-    ZIP_MODULE = zipdata01  # type: ignore
+    pass
diff --git a/lib/importlib_resources/tests/zip.py b/lib/importlib_resources/tests/zip.py
new file mode 100644
index 00000000..962195a9
--- /dev/null
+++ b/lib/importlib_resources/tests/zip.py
@@ -0,0 +1,32 @@
+"""
+Generate zip test data files.
+"""
+
+import contextlib
+import os
+import pathlib
+import zipfile
+
+import zipp
+
+
+def make_zip_file(src, dst):
+    """
+    Zip the files in src into a new zipfile at dst.
+    """
+    with zipfile.ZipFile(dst, 'w') as zf:
+        for src_path, rel in walk(src):
+            dst_name = src.name / pathlib.PurePosixPath(rel.as_posix())
+            zf.write(src_path, dst_name)
+        zipp.CompleteDirs.inject(zf)
+    return dst
+
+
+def walk(datapath):
+    for dirpath, dirnames, filenames in os.walk(datapath):
+        with contextlib.suppress(ValueError):
+            dirnames.remove('__pycache__')
+        for filename in filenames:
+            res = pathlib.Path(dirpath) / filename
+            rel = res.relative_to(datapath)
+            yield res, rel
diff --git a/lib/importlib_resources/tests/zipdata01/ziptestdata.zip b/lib/importlib_resources/tests/zipdata01/ziptestdata.zip
deleted file mode 100644
index 9a3bb0739f87e97c1084b94d7d153680f6727738..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 876
zcmWIWW@Zs#00HOCX@Q%&m27l?Y!DU);;PJolGNgol*E!m{nC;&T|+ayw9K5;|NlG~
zQW<i9FdwK?fgzM3gu#tLm%)(149F`7iWULoQWz8&xEKOZEI9q+&@7O3AS{N(0t>MD
z9;rDw`8o=rA#S=B3g!7lIVp-<sOA8*!U4KN<Kr{)GE3s)^$IFcH3_%v>}COK17UPc
zNtt<xMU`ON85o(EQ8mJ?0y0#97&%yqOOsMEi&B$I@{20<iLx562^j8RWD;S<9YHXc
zEolU?kllq8T>;*xhM-3R!jMEPhCreO-3*u>5Df}T7+BJ{639e$2uhfsIs`pJ5Qf}C
xGXyDE@VNvOv@o!wQJfLgCAgysx3f@9jKpUmiW^zkK<;1z!tFpk^MROw0RS~O%0&PG

diff --git a/lib/importlib_resources/tests/zipdata02/ziptestdata.zip b/lib/importlib_resources/tests/zipdata02/ziptestdata.zip
deleted file mode 100644
index d63ff512d2807ef2fd259455283b81b02e0e45fb..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 698
zcmWIWW@Zs#00HOCX@Ot{ln@8fRhb1Psl_EJi6x2p@$s2?nI-Y@dIgmMI5kP5Y0A$_
z#jWw|&p#`9ff_(q7K_HB)Z+ZoqU2OVy^@L&ph*fa0WRVlP*R?c+X1opI-R&20MZDv
z&j{oIpa8N17@0(vaR(gGH(;=&5k%n(M%;#g0ulz6G@1gL$cA79E2=^00gEsw4~s!C
zUxI@<z#G*lm{t&t>ZWaIMqz|BszK;s4KsL2<9jRy!Q2E6`2cTLHjr{wAk1ZCU@!+_
G1_l6Bc%f?m

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index f1ad724e..fd444e98 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -1,6 +1,6 @@
 apscheduler==3.10.1
 importlib-metadata==6.8.0
-importlib-resources==6.0.1
+importlib-resources==6.4.0
 pyinstaller==6.4.0
 pyopenssl==24.0.0
 pycryptodomex==3.20.0
diff --git a/requirements.txt b/requirements.txt
index a91534d0..ad20a775 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -19,7 +19,7 @@ html5lib==1.1
 httpagentparser==1.9.5
 idna==3.4
 importlib-metadata==6.8.0
-importlib-resources==6.0.1
+importlib-resources==6.4.0
 git+https://github.com/Tautulli/ipwhois.git@master#egg=ipwhois
 IPy==1.01
 Mako==1.3.2

From e248c13c15aacd5319a83affe23978be1d06511c Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sun, 24 Mar 2024 15:29:52 -0700
Subject: [PATCH 545/743] Bump importlib-metadata from 6.8.0 to 7.1.0 (#2286)

* Bump importlib-metadata from 6.8.0 to 7.1.0

Bumps [importlib-metadata](https://github.com/python/importlib_metadata) from 6.8.0 to 7.1.0.
- [Release notes](https://github.com/python/importlib_metadata/releases)
- [Changelog](https://github.com/python/importlib_metadata/blob/main/NEWS.rst)
- [Commits](https://github.com/python/importlib_metadata/compare/v6.8.0...v7.1.0)

---
updated-dependencies:
- dependency-name: importlib-metadata
  dependency-type: direct:production
  update-type: version-update:semver-major
...

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

* Update importlib-metadata==7.1.0

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/importlib_metadata/__init__.py            | 422 +++++++++++++-----
 lib/importlib_metadata/_adapters.py           |   2 +-
 lib/importlib_metadata/_compat.py             |  19 +-
 lib/importlib_metadata/_meta.py               |  60 ++-
 lib/importlib_metadata/compat/__init__.py     |   0
 .../{_py39compat.py => compat/py39.py}        |   7 +-
 lib/importlib_metadata/diagnose.py            |  21 +
 package/requirements-package.txt              |   2 +-
 requirements.txt                              |   2 +-
 9 files changed, 379 insertions(+), 156 deletions(-)
 create mode 100644 lib/importlib_metadata/compat/__init__.py
 rename lib/importlib_metadata/{_py39compat.py => compat/py39.py} (82%)
 create mode 100644 lib/importlib_metadata/diagnose.py

diff --git a/lib/importlib_metadata/__init__.py b/lib/importlib_metadata/__init__.py
index 9a36a8e6..32ee3b4d 100644
--- a/lib/importlib_metadata/__init__.py
+++ b/lib/importlib_metadata/__init__.py
@@ -1,10 +1,14 @@
+from __future__ import annotations
+
 import os
 import re
 import abc
-import csv
 import sys
+import json
 import zipp
 import email
+import types
+import inspect
 import pathlib
 import operator
 import textwrap
@@ -14,12 +18,12 @@ import itertools
 import posixpath
 import collections
 
-from . import _adapters, _meta, _py39compat
+from . import _adapters, _meta
+from .compat import py39
 from ._collections import FreezableDefaultDict, Pair
 from ._compat import (
     NullFinder,
     install,
-    pypy_partial,
 )
 from ._functools import method_cache, pass_none
 from ._itertools import always_iterable, unique_everseen
@@ -29,8 +33,7 @@ from contextlib import suppress
 from importlib import import_module
 from importlib.abc import MetaPathFinder
 from itertools import starmap
-from typing import List, Mapping, Optional
-
+from typing import Any, Iterable, List, Mapping, Match, Optional, Set, cast
 
 __all__ = [
     'Distribution',
@@ -51,11 +54,11 @@ __all__ = [
 class PackageNotFoundError(ModuleNotFoundError):
     """The package was not found."""
 
-    def __str__(self):
+    def __str__(self) -> str:
         return f"No package metadata was found for {self.name}"
 
     @property
-    def name(self):
+    def name(self) -> str:  # type: ignore[override]
         (name,) = self.args
         return name
 
@@ -121,38 +124,11 @@ class Sectioned:
             yield Pair(name, value)
 
     @staticmethod
-    def valid(line):
+    def valid(line: str):
         return line and not line.startswith('#')
 
 
-class DeprecatedTuple:
-    """
-    Provide subscript item access for backward compatibility.
-
-    >>> recwarn = getfixture('recwarn')
-    >>> ep = EntryPoint(name='name', value='value', group='group')
-    >>> ep[:]
-    ('name', 'value', 'group')
-    >>> ep[0]
-    'name'
-    >>> len(recwarn)
-    1
-    """
-
-    # Do not remove prior to 2023-05-01 or Python 3.13
-    _warn = functools.partial(
-        warnings.warn,
-        "EntryPoint tuple interface is deprecated. Access members by name.",
-        DeprecationWarning,
-        stacklevel=pypy_partial(2),
-    )
-
-    def __getitem__(self, item):
-        self._warn()
-        return self._key()[item]
-
-
-class EntryPoint(DeprecatedTuple):
+class EntryPoint:
     """An entry point as defined by Python packaging conventions.
 
     See `the packaging docs on entry points
@@ -194,34 +170,37 @@ class EntryPoint(DeprecatedTuple):
     value: str
     group: str
 
-    dist: Optional['Distribution'] = None
+    dist: Optional[Distribution] = None
 
-    def __init__(self, name, value, group):
+    def __init__(self, name: str, value: str, group: str) -> None:
         vars(self).update(name=name, value=value, group=group)
 
-    def load(self):
+    def load(self) -> Any:
         """Load the entry point from its definition. If only a module
         is indicated by the value, return that module. Otherwise,
         return the named object.
         """
-        match = self.pattern.match(self.value)
+        match = cast(Match, self.pattern.match(self.value))
         module = import_module(match.group('module'))
         attrs = filter(None, (match.group('attr') or '').split('.'))
         return functools.reduce(getattr, attrs, module)
 
     @property
-    def module(self):
+    def module(self) -> str:
         match = self.pattern.match(self.value)
+        assert match is not None
         return match.group('module')
 
     @property
-    def attr(self):
+    def attr(self) -> str:
         match = self.pattern.match(self.value)
+        assert match is not None
         return match.group('attr')
 
     @property
-    def extras(self):
+    def extras(self) -> List[str]:
         match = self.pattern.match(self.value)
+        assert match is not None
         return re.findall(r'\w+', match.group('extras') or '')
 
     def _for(self, dist):
@@ -269,7 +248,7 @@ class EntryPoint(DeprecatedTuple):
             f'group={self.group!r})'
         )
 
-    def __hash__(self):
+    def __hash__(self) -> int:
         return hash(self._key())
 
 
@@ -280,7 +259,7 @@ class EntryPoints(tuple):
 
     __slots__ = ()
 
-    def __getitem__(self, name):  # -> EntryPoint:
+    def __getitem__(self, name: str) -> EntryPoint:  # type: ignore[override]
         """
         Get the EntryPoint in self matching name.
         """
@@ -289,22 +268,29 @@ class EntryPoints(tuple):
         except StopIteration:
             raise KeyError(name)
 
-    def select(self, **params):
+    def __repr__(self):
+        """
+        Repr with classname and tuple constructor to
+        signal that we deviate from regular tuple behavior.
+        """
+        return '%s(%r)' % (self.__class__.__name__, tuple(self))
+
+    def select(self, **params) -> EntryPoints:
         """
         Select entry points from self that match the
         given parameters (typically group and/or name).
         """
-        return EntryPoints(ep for ep in self if _py39compat.ep_matches(ep, **params))
+        return EntryPoints(ep for ep in self if py39.ep_matches(ep, **params))
 
     @property
-    def names(self):
+    def names(self) -> Set[str]:
         """
         Return the set of all names of all entry points.
         """
         return {ep.name for ep in self}
 
     @property
-    def groups(self):
+    def groups(self) -> Set[str]:
         """
         Return the set of all groups of all entry points.
         """
@@ -325,47 +311,92 @@ class EntryPoints(tuple):
 class PackagePath(pathlib.PurePosixPath):
     """A reference to a path in a package"""
 
-    def read_text(self, encoding='utf-8'):
-        with self.locate().open(encoding=encoding) as stream:
-            return stream.read()
+    hash: Optional[FileHash]
+    size: int
+    dist: Distribution
 
-    def read_binary(self):
-        with self.locate().open('rb') as stream:
-            return stream.read()
+    def read_text(self, encoding: str = 'utf-8') -> str:  # type: ignore[override]
+        return self.locate().read_text(encoding=encoding)
 
-    def locate(self):
+    def read_binary(self) -> bytes:
+        return self.locate().read_bytes()
+
+    def locate(self) -> SimplePath:
         """Return a path-like object for this path"""
         return self.dist.locate_file(self)
 
 
 class FileHash:
-    def __init__(self, spec):
+    def __init__(self, spec: str) -> None:
         self.mode, _, self.value = spec.partition('=')
 
-    def __repr__(self):
+    def __repr__(self) -> str:
         return f'<FileHash mode: {self.mode} value: {self.value}>'
 
 
-class Distribution(metaclass=abc.ABCMeta):
-    """A Python distribution package."""
+class DeprecatedNonAbstract:
+    # Required until Python 3.14
+    def __new__(cls, *args, **kwargs):
+        all_names = {
+            name for subclass in inspect.getmro(cls) for name in vars(subclass)
+        }
+        abstract = {
+            name
+            for name in all_names
+            if getattr(getattr(cls, name), '__isabstractmethod__', False)
+        }
+        if abstract:
+            warnings.warn(
+                f"Unimplemented abstract methods {abstract}",
+                DeprecationWarning,
+                stacklevel=2,
+            )
+        return super().__new__(cls)
+
+
+class Distribution(DeprecatedNonAbstract):
+    """
+    An abstract Python distribution package.
+
+    Custom providers may derive from this class and define
+    the abstract methods to provide a concrete implementation
+    for their environment. Some providers may opt to override
+    the default implementation of some properties to bypass
+    the file-reading mechanism.
+    """
 
     @abc.abstractmethod
-    def read_text(self, filename):
+    def read_text(self, filename) -> Optional[str]:
         """Attempt to load metadata file given by the name.
 
+        Python distribution metadata is organized by blobs of text
+        typically represented as "files" in the metadata directory
+        (e.g. package-1.0.dist-info). These files include things
+        like:
+
+        - METADATA: The distribution metadata including fields
+          like Name and Version and Description.
+        - entry_points.txt: A series of entry points as defined in
+          `the entry points spec <https://packaging.python.org/en/latest/specifications/entry-points/#file-format>`_.
+        - RECORD: A record of files according to
+          `this recording spec <https://packaging.python.org/en/latest/specifications/recording-installed-packages/#the-record-file>`_.
+
+        A package may provide any set of files, including those
+        not listed here or none at all.
+
         :param filename: The name of the file in the distribution info.
         :return: The text if found, otherwise None.
         """
 
     @abc.abstractmethod
-    def locate_file(self, path):
+    def locate_file(self, path: str | os.PathLike[str]) -> SimplePath:
         """
-        Given a path to a file in this distribution, return a path
+        Given a path to a file in this distribution, return a SimplePath
         to it.
         """
 
     @classmethod
-    def from_name(cls, name: str):
+    def from_name(cls, name: str) -> Distribution:
         """Return the Distribution for the given package name.
 
         :param name: The name of the distribution package to search for.
@@ -378,21 +409,23 @@ class Distribution(metaclass=abc.ABCMeta):
         if not name:
             raise ValueError("A distribution name is required.")
         try:
-            return next(cls.discover(name=name))
+            return next(iter(cls.discover(name=name)))
         except StopIteration:
             raise PackageNotFoundError(name)
 
     @classmethod
-    def discover(cls, **kwargs):
+    def discover(
+        cls, *, context: Optional[DistributionFinder.Context] = None, **kwargs
+    ) -> Iterable[Distribution]:
         """Return an iterable of Distribution objects for all packages.
 
         Pass a ``context`` or pass keyword arguments for constructing
         a context.
 
         :context: A ``DistributionFinder.Context`` object.
-        :return: Iterable of Distribution objects for all packages.
+        :return: Iterable of Distribution objects for packages matching
+          the context.
         """
-        context = kwargs.pop('context', None)
         if context and kwargs:
             raise ValueError("cannot accept context and kwargs")
         context = context or DistributionFinder.Context(**kwargs)
@@ -401,8 +434,8 @@ class Distribution(metaclass=abc.ABCMeta):
         )
 
     @staticmethod
-    def at(path):
-        """Return a Distribution for the indicated metadata path
+    def at(path: str | os.PathLike[str]) -> Distribution:
+        """Return a Distribution for the indicated metadata path.
 
         :param path: a string or path-like object
         :return: a concrete Distribution instance for the path
@@ -411,7 +444,7 @@ class Distribution(metaclass=abc.ABCMeta):
 
     @staticmethod
     def _discover_resolvers():
-        """Search the meta_path for resolvers."""
+        """Search the meta_path for resolvers (MetadataPathFinders)."""
         declared = (
             getattr(finder, 'find_distributions', None) for finder in sys.meta_path
         )
@@ -422,9 +455,13 @@ class Distribution(metaclass=abc.ABCMeta):
         """Return the parsed metadata for this Distribution.
 
         The returned object will have keys that name the various bits of
-        metadata.  See PEP 566 for details.
+        metadata per the
+        `Core metadata specifications <https://packaging.python.org/en/latest/specifications/core-metadata/#core-metadata>`_.
+
+        Custom providers may provide the METADATA file or override this
+        property.
         """
-        text = (
+        opt_text = (
             self.read_text('METADATA')
             or self.read_text('PKG-INFO')
             # This last clause is here to support old egg-info files.  Its
@@ -432,10 +469,11 @@ class Distribution(metaclass=abc.ABCMeta):
             # (which points to the egg-info file) attribute unchanged.
             or self.read_text('')
         )
+        text = cast(str, opt_text)
         return _adapters.Message(email.message_from_string(text))
 
     @property
-    def name(self):
+    def name(self) -> str:
         """Return the 'Name' metadata for the distribution package."""
         return self.metadata['Name']
 
@@ -445,24 +483,34 @@ class Distribution(metaclass=abc.ABCMeta):
         return Prepared.normalize(self.name)
 
     @property
-    def version(self):
+    def version(self) -> str:
         """Return the 'Version' metadata for the distribution package."""
         return self.metadata['Version']
 
     @property
-    def entry_points(self):
+    def entry_points(self) -> EntryPoints:
+        """
+        Return EntryPoints for this distribution.
+
+        Custom providers may provide the ``entry_points.txt`` file
+        or override this property.
+        """
         return EntryPoints._from_text_for(self.read_text('entry_points.txt'), self)
 
     @property
-    def files(self):
+    def files(self) -> Optional[List[PackagePath]]:
         """Files in this distribution.
 
         :return: List of PackagePath for this distribution or None
 
         Result is `None` if the metadata file that enumerates files
-        (i.e. RECORD for dist-info or SOURCES.txt for egg-info) is
-        missing.
+        (i.e. RECORD for dist-info, or installed-files.txt or
+        SOURCES.txt for egg-info) is missing.
         Result may be empty if the metadata exists but is empty.
+
+        Custom providers are recommended to provide a "RECORD" file (in
+        ``read_text``) or override this property to allow for callers to be
+        able to resolve filenames provided by the package.
         """
 
         def make_file(name, hash=None, size_str=None):
@@ -474,27 +522,76 @@ class Distribution(metaclass=abc.ABCMeta):
 
         @pass_none
         def make_files(lines):
-            return list(starmap(make_file, csv.reader(lines)))
+            # Delay csv import, since Distribution.files is not as widely used
+            # as other parts of importlib.metadata
+            import csv
 
-        return make_files(self._read_files_distinfo() or self._read_files_egginfo())
+            return starmap(make_file, csv.reader(lines))
+
+        @pass_none
+        def skip_missing_files(package_paths):
+            return list(filter(lambda path: path.locate().exists(), package_paths))
+
+        return skip_missing_files(
+            make_files(
+                self._read_files_distinfo()
+                or self._read_files_egginfo_installed()
+                or self._read_files_egginfo_sources()
+            )
+        )
 
     def _read_files_distinfo(self):
         """
-        Read the lines of RECORD
+        Read the lines of RECORD.
         """
         text = self.read_text('RECORD')
         return text and text.splitlines()
 
-    def _read_files_egginfo(self):
+    def _read_files_egginfo_installed(self):
         """
-        SOURCES.txt might contain literal commas, so wrap each line
-        in quotes.
+        Read installed-files.txt and return lines in a similar
+        CSV-parsable format as RECORD: each file must be placed
+        relative to the site-packages directory and must also be
+        quoted (since file names can contain literal commas).
+
+        This file is written when the package is installed by pip,
+        but it might not be written for other installation methods.
+        Assume the file is accurate if it exists.
+        """
+        text = self.read_text('installed-files.txt')
+        # Prepend the .egg-info/ subdir to the lines in this file.
+        # But this subdir is only available from PathDistribution's
+        # self._path.
+        subdir = getattr(self, '_path', None)
+        if not text or not subdir:
+            return
+
+        paths = (
+            (subdir / name)
+            .resolve()
+            .relative_to(self.locate_file('').resolve())
+            .as_posix()
+            for name in text.splitlines()
+        )
+        return map('"{}"'.format, paths)
+
+    def _read_files_egginfo_sources(self):
+        """
+        Read SOURCES.txt and return lines in a similar CSV-parsable
+        format as RECORD: each file name must be quoted (since it
+        might contain literal commas).
+
+        Note that SOURCES.txt is not a reliable source for what
+        files are installed by a package. This file is generated
+        for a source archive, and the files that are present
+        there (e.g. setup.py) may not correctly reflect the files
+        that are present after the package has been installed.
         """
         text = self.read_text('SOURCES.txt')
         return text and map('"{}"'.format, text.splitlines())
 
     @property
-    def requires(self):
+    def requires(self) -> Optional[List[str]]:
         """Generated requirements specified for this Distribution"""
         reqs = self._read_dist_info_reqs() or self._read_egg_info_reqs()
         return reqs and list(reqs)
@@ -545,10 +642,23 @@ class Distribution(metaclass=abc.ABCMeta):
             space = url_req_space(section.value)
             yield section.value + space + quoted_marker(section.name)
 
+    @property
+    def origin(self):
+        return self._load_json('direct_url.json')
+
+    def _load_json(self, filename):
+        return pass_none(json.loads)(
+            self.read_text(filename),
+            object_hook=lambda data: types.SimpleNamespace(**data),
+        )
+
 
 class DistributionFinder(MetaPathFinder):
     """
     A MetaPathFinder capable of discovering installed distributions.
+
+    Custom providers should implement this interface in order to
+    supply metadata.
     """
 
     class Context:
@@ -561,6 +671,17 @@ class DistributionFinder(MetaPathFinder):
         Each DistributionFinder may expect any parameters
         and should attempt to honor the canonical
         parameters defined below when appropriate.
+
+        This mechanism gives a custom provider a means to
+        solicit additional details from the caller beyond
+        "name" and "path" when searching distributions.
+        For example, imagine a provider that exposes suites
+        of packages in either a "public" or "private" ``realm``.
+        A caller may wish to query only for distributions in
+        a particular realm and could call
+        ``distributions(realm="private")`` to signal to the
+        custom provider to only include distributions from that
+        realm.
         """
 
         name = None
@@ -573,7 +694,7 @@ class DistributionFinder(MetaPathFinder):
             vars(self).update(kwargs)
 
         @property
-        def path(self):
+        def path(self) -> List[str]:
             """
             The sequence of directory path that a distribution finder
             should search.
@@ -584,7 +705,7 @@ class DistributionFinder(MetaPathFinder):
             return vars(self).get('path', sys.path)
 
     @abc.abstractmethod
-    def find_distributions(self, context=Context()):
+    def find_distributions(self, context=Context()) -> Iterable[Distribution]:
         """
         Find distributions.
 
@@ -596,11 +717,18 @@ class DistributionFinder(MetaPathFinder):
 
 class FastPath:
     """
-    Micro-optimized class for searching a path for
-    children.
+    Micro-optimized class for searching a root for children.
+
+    Root is a path on the file system that may contain metadata
+    directories either as natural directories or within a zip file.
 
     >>> FastPath('').children()
     ['...']
+
+    FastPath objects are cached and recycled for any given root.
+
+    >>> FastPath('foobar') is FastPath('foobar')
+    True
     """
 
     @functools.lru_cache()  # type: ignore
@@ -642,7 +770,19 @@ class FastPath:
 
 
 class Lookup:
+    """
+    A micro-optimized class for searching a (fast) path for metadata.
+    """
+
     def __init__(self, path: FastPath):
+        """
+        Calculate all of the children representing metadata.
+
+        From the children in the path, calculate early all of the
+        children that appear to represent metadata (infos) or legacy
+        metadata (eggs).
+        """
+
         base = os.path.basename(path.root).lower()
         base_is_egg = base.endswith(".egg")
         self.infos = FreezableDefaultDict(list)
@@ -663,7 +803,10 @@ class Lookup:
         self.infos.freeze()
         self.eggs.freeze()
 
-    def search(self, prepared):
+    def search(self, prepared: Prepared):
+        """
+        Yield all infos and eggs matching the Prepared query.
+        """
         infos = (
             self.infos[prepared.normalized]
             if prepared
@@ -679,13 +822,28 @@ class Lookup:
 
 class Prepared:
     """
-    A prepared search for metadata on a possibly-named package.
+    A prepared search query for metadata on a possibly-named package.
+
+    Pre-calculates the normalization to prevent repeated operations.
+
+    >>> none = Prepared(None)
+    >>> none.normalized
+    >>> none.legacy_normalized
+    >>> bool(none)
+    False
+    >>> sample = Prepared('Sample__Pkg-name.foo')
+    >>> sample.normalized
+    'sample_pkg_name_foo'
+    >>> sample.legacy_normalized
+    'sample__pkg_name.foo'
+    >>> bool(sample)
+    True
     """
 
     normalized = None
     legacy_normalized = None
 
-    def __init__(self, name):
+    def __init__(self, name: Optional[str]):
         self.name = name
         if name is None:
             return
@@ -719,7 +877,10 @@ class MetadataPathFinder(NullFinder, DistributionFinder):
     of Python that do not have a PathFinder find_distributions().
     """
 
-    def find_distributions(self, context=DistributionFinder.Context()):
+    @classmethod
+    def find_distributions(
+        cls, context=DistributionFinder.Context()
+    ) -> Iterable[PathDistribution]:
         """
         Find distributions.
 
@@ -728,7 +889,7 @@ class MetadataPathFinder(NullFinder, DistributionFinder):
         (or all names if ``None`` indicated) along the paths in the list
         of directories ``context.path``.
         """
-        found = self._search_paths(context.name, context.path)
+        found = cls._search_paths(context.name, context.path)
         return map(PathDistribution, found)
 
     @classmethod
@@ -739,19 +900,20 @@ class MetadataPathFinder(NullFinder, DistributionFinder):
             path.search(prepared) for path in map(FastPath, paths)
         )
 
-    def invalidate_caches(cls):
+    @classmethod
+    def invalidate_caches(cls) -> None:
         FastPath.__new__.cache_clear()
 
 
 class PathDistribution(Distribution):
-    def __init__(self, path: SimplePath):
+    def __init__(self, path: SimplePath) -> None:
         """Construct a distribution.
 
         :param path: SimplePath indicating the metadata directory.
         """
         self._path = path
 
-    def read_text(self, filename):
+    def read_text(self, filename: str | os.PathLike[str]) -> Optional[str]:
         with suppress(
             FileNotFoundError,
             IsADirectoryError,
@@ -761,9 +923,11 @@ class PathDistribution(Distribution):
         ):
             return self._path.joinpath(filename).read_text(encoding='utf-8')
 
+        return None
+
     read_text.__doc__ = Distribution.read_text.__doc__
 
-    def locate_file(self, path):
+    def locate_file(self, path: str | os.PathLike[str]) -> SimplePath:
         return self._path.parent / path
 
     @property
@@ -796,7 +960,7 @@ class PathDistribution(Distribution):
         return name
 
 
-def distribution(distribution_name):
+def distribution(distribution_name: str) -> Distribution:
     """Get the ``Distribution`` instance for the named package.
 
     :param distribution_name: The name of the distribution package as a string.
@@ -805,7 +969,7 @@ def distribution(distribution_name):
     return Distribution.from_name(distribution_name)
 
 
-def distributions(**kwargs):
+def distributions(**kwargs) -> Iterable[Distribution]:
     """Get all ``Distribution`` instances in the current environment.
 
     :return: An iterable of ``Distribution`` instances.
@@ -813,7 +977,7 @@ def distributions(**kwargs):
     return Distribution.discover(**kwargs)
 
 
-def metadata(distribution_name) -> _meta.PackageMetadata:
+def metadata(distribution_name: str) -> _meta.PackageMetadata:
     """Get the metadata for the named package.
 
     :param distribution_name: The name of the distribution package to query.
@@ -822,7 +986,7 @@ def metadata(distribution_name) -> _meta.PackageMetadata:
     return Distribution.from_name(distribution_name).metadata
 
 
-def version(distribution_name):
+def version(distribution_name: str) -> str:
     """Get the version string for the named package.
 
     :param distribution_name: The name of the distribution package to query.
@@ -834,7 +998,7 @@ def version(distribution_name):
 
 _unique = functools.partial(
     unique_everseen,
-    key=_py39compat.normalized_name,
+    key=py39.normalized_name,
 )
 """
 Wrapper for ``distributions`` to return unique distributions by name.
@@ -856,7 +1020,7 @@ def entry_points(**params) -> EntryPoints:
     return EntryPoints(eps).select(**params)
 
 
-def files(distribution_name):
+def files(distribution_name: str) -> Optional[List[PackagePath]]:
     """Return a list of files for the named package.
 
     :param distribution_name: The name of the distribution package to query.
@@ -865,11 +1029,11 @@ def files(distribution_name):
     return distribution(distribution_name).files
 
 
-def requires(distribution_name):
+def requires(distribution_name: str) -> Optional[List[str]]:
     """
     Return a list of requirements for the named package.
 
-    :return: An iterator of requirements, suitable for
+    :return: An iterable of requirements, suitable for
         packaging.requirement.Requirement.
     """
     return distribution(distribution_name).requires
@@ -896,9 +1060,43 @@ def _top_level_declared(dist):
     return (dist.read_text('top_level.txt') or '').split()
 
 
+def _topmost(name: PackagePath) -> Optional[str]:
+    """
+    Return the top-most parent as long as there is a parent.
+    """
+    top, *rest = name.parts
+    return top if rest else None
+
+
+def _get_toplevel_name(name: PackagePath) -> str:
+    """
+    Infer a possibly importable module name from a name presumed on
+    sys.path.
+
+    >>> _get_toplevel_name(PackagePath('foo.py'))
+    'foo'
+    >>> _get_toplevel_name(PackagePath('foo'))
+    'foo'
+    >>> _get_toplevel_name(PackagePath('foo.pyc'))
+    'foo'
+    >>> _get_toplevel_name(PackagePath('foo/__init__.py'))
+    'foo'
+    >>> _get_toplevel_name(PackagePath('foo.pth'))
+    'foo.pth'
+    >>> _get_toplevel_name(PackagePath('foo.dist-info'))
+    'foo.dist-info'
+    """
+    return _topmost(name) or (
+        # python/typeshed#10328
+        inspect.getmodulename(name)  # type: ignore
+        or str(name)
+    )
+
+
 def _top_level_inferred(dist):
-    return {
-        f.parts[0] if len(f.parts) > 1 else f.with_suffix('').name
-        for f in always_iterable(dist.files)
-        if f.suffix == ".py"
-    }
+    opt_names = set(map(_get_toplevel_name, always_iterable(dist.files)))
+
+    def importable_name(name):
+        return '.' not in name
+
+    return filter(importable_name, opt_names)
diff --git a/lib/importlib_metadata/_adapters.py b/lib/importlib_metadata/_adapters.py
index e33cba5e..120e43a0 100644
--- a/lib/importlib_metadata/_adapters.py
+++ b/lib/importlib_metadata/_adapters.py
@@ -54,7 +54,7 @@ class Message(email.message.Message):
     def __getitem__(self, item):
         """
         Warn users that a ``KeyError`` can be expected when a
-        mising key is supplied. Ref python/importlib_metadata#371.
+        missing key is supplied. Ref python/importlib_metadata#371.
         """
         res = super().__getitem__(item)
         if res is None:
diff --git a/lib/importlib_metadata/_compat.py b/lib/importlib_metadata/_compat.py
index 3d78566e..df312b1c 100644
--- a/lib/importlib_metadata/_compat.py
+++ b/lib/importlib_metadata/_compat.py
@@ -2,14 +2,7 @@ import sys
 import platform
 
 
-__all__ = ['install', 'NullFinder', 'Protocol']
-
-
-try:
-    from typing import Protocol
-except ImportError:  # pragma: no cover
-    # Python 3.7 compatibility
-    from typing_extensions import Protocol  # type: ignore
+__all__ = ['install', 'NullFinder']
 
 
 def install(cls):
@@ -45,7 +38,7 @@ def disable_stdlib_finder():
 
 class NullFinder:
     """
-    A "Finder" (aka "MetaClassFinder") that never finds any modules,
+    A "Finder" (aka "MetaPathFinder") that never finds any modules,
     but may find distributions.
     """
 
@@ -53,14 +46,6 @@ class NullFinder:
     def find_spec(*args, **kwargs):
         return None
 
-    # In Python 2, the import system requires finders
-    # to have a find_module() method, but this usage
-    # is deprecated in Python 3 in favor of find_spec().
-    # For the purposes of this finder (i.e. being present
-    # on sys.meta_path but having no other import
-    # system functionality), the two methods are identical.
-    find_module = find_spec
-
 
 def pypy_partial(val):
     """
diff --git a/lib/importlib_metadata/_meta.py b/lib/importlib_metadata/_meta.py
index 259b15ba..1927d0f6 100644
--- a/lib/importlib_metadata/_meta.py
+++ b/lib/importlib_metadata/_meta.py
@@ -1,24 +1,38 @@
-from ._compat import Protocol
-from typing import Any, Dict, Iterator, List, TypeVar, Union
+from __future__ import annotations
+
+import os
+from typing import Protocol
+from typing import Any, Dict, Iterator, List, Optional, TypeVar, Union, overload
 
 
 _T = TypeVar("_T")
 
 
 class PackageMetadata(Protocol):
-    def __len__(self) -> int:
-        ...  # pragma: no cover
+    def __len__(self) -> int: ...  # pragma: no cover
 
-    def __contains__(self, item: str) -> bool:
-        ...  # pragma: no cover
+    def __contains__(self, item: str) -> bool: ...  # pragma: no cover
 
-    def __getitem__(self, key: str) -> str:
-        ...  # pragma: no cover
+    def __getitem__(self, key: str) -> str: ...  # pragma: no cover
 
-    def __iter__(self) -> Iterator[str]:
-        ...  # pragma: no cover
+    def __iter__(self) -> Iterator[str]: ...  # pragma: no cover
 
-    def get_all(self, name: str, failobj: _T = ...) -> Union[List[Any], _T]:
+    @overload
+    def get(
+        self, name: str, failobj: None = None
+    ) -> Optional[str]: ...  # pragma: no cover
+
+    @overload
+    def get(self, name: str, failobj: _T) -> Union[str, _T]: ...  # pragma: no cover
+
+    # overload per python/importlib_metadata#435
+    @overload
+    def get_all(
+        self, name: str, failobj: None = None
+    ) -> Optional[List[Any]]: ...  # pragma: no cover
+
+    @overload
+    def get_all(self, name: str, failobj: _T) -> Union[List[Any], _T]:
         """
         Return all values associated with a possibly multi-valued key.
         """
@@ -30,20 +44,24 @@ class PackageMetadata(Protocol):
         """
 
 
-class SimplePath(Protocol[_T]):
+class SimplePath(Protocol):
     """
-    A minimal subset of pathlib.Path required by PathDistribution.
+    A minimal subset of pathlib.Path required by Distribution.
     """
 
-    def joinpath(self) -> _T:
-        ...  # pragma: no cover
+    def joinpath(
+        self, other: Union[str, os.PathLike[str]]
+    ) -> SimplePath: ...  # pragma: no cover
 
-    def __truediv__(self, other: Union[str, _T]) -> _T:
-        ...  # pragma: no cover
+    def __truediv__(
+        self, other: Union[str, os.PathLike[str]]
+    ) -> SimplePath: ...  # pragma: no cover
 
     @property
-    def parent(self) -> _T:
-        ...  # pragma: no cover
+    def parent(self) -> SimplePath: ...  # pragma: no cover
 
-    def read_text(self) -> str:
-        ...  # pragma: no cover
+    def read_text(self, encoding=None) -> str: ...  # pragma: no cover
+
+    def read_bytes(self) -> bytes: ...  # pragma: no cover
+
+    def exists(self) -> bool: ...  # pragma: no cover
diff --git a/lib/importlib_metadata/compat/__init__.py b/lib/importlib_metadata/compat/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/lib/importlib_metadata/_py39compat.py b/lib/importlib_metadata/compat/py39.py
similarity index 82%
rename from lib/importlib_metadata/_py39compat.py
rename to lib/importlib_metadata/compat/py39.py
index cde4558f..1f15bd97 100644
--- a/lib/importlib_metadata/_py39compat.py
+++ b/lib/importlib_metadata/compat/py39.py
@@ -1,11 +1,12 @@
 """
 Compatibility layer with Python 3.8/3.9
 """
+
 from typing import TYPE_CHECKING, Any, Optional
 
 if TYPE_CHECKING:  # pragma: no cover
     # Prevent circular imports on runtime.
-    from . import Distribution, EntryPoint
+    from .. import Distribution, EntryPoint
 else:
     Distribution = EntryPoint = Any
 
@@ -17,7 +18,7 @@ def normalized_name(dist: Distribution) -> Optional[str]:
     try:
         return dist._normalized_name
     except AttributeError:
-        from . import Prepared  # -> delay to prevent circular imports.
+        from .. import Prepared  # -> delay to prevent circular imports.
 
         return Prepared.normalize(getattr(dist, "name", None) or dist.metadata['Name'])
 
@@ -29,7 +30,7 @@ def ep_matches(ep: EntryPoint, **params) -> bool:
     try:
         return ep.matches(**params)
     except AttributeError:
-        from . import EntryPoint  # -> delay to prevent circular imports.
+        from .. import EntryPoint  # -> delay to prevent circular imports.
 
         # Reconstruct the EntryPoint object to make sure it is compatible.
         return EntryPoint(ep.name, ep.value, ep.group).matches(**params)
diff --git a/lib/importlib_metadata/diagnose.py b/lib/importlib_metadata/diagnose.py
new file mode 100644
index 00000000..e405471a
--- /dev/null
+++ b/lib/importlib_metadata/diagnose.py
@@ -0,0 +1,21 @@
+import sys
+
+from . import Distribution
+
+
+def inspect(path):
+    print("Inspecting", path)
+    dists = list(Distribution.discover(path=[path]))
+    if not dists:
+        return
+    print("Found", len(dists), "packages:", end=' ')
+    print(', '.join(dist.name for dist in dists))
+
+
+def run():
+    for path in sys.path:
+        inspect(path)
+
+
+if __name__ == '__main__':
+    run()
diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index fd444e98..ee119322 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -1,5 +1,5 @@
 apscheduler==3.10.1
-importlib-metadata==6.8.0
+importlib-metadata==7.1.0
 importlib-resources==6.4.0
 pyinstaller==6.4.0
 pyopenssl==24.0.0
diff --git a/requirements.txt b/requirements.txt
index ad20a775..ca332f91 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -18,7 +18,7 @@ gntp==1.0.3
 html5lib==1.1
 httpagentparser==1.9.5
 idna==3.4
-importlib-metadata==6.8.0
+importlib-metadata==7.1.0
 importlib-resources==6.4.0
 git+https://github.com/Tautulli/ipwhois.git@master#egg=ipwhois
 IPy==1.01

From 4430c14374280b746f0cf6d7383d1d7d6c9eb8a6 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 24 Mar 2024 14:34:50 -0700
Subject: [PATCH 546/743] Fix incorrect reachability websocket event key

---
 plexpy/activity_handler.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/plexpy/activity_handler.py b/plexpy/activity_handler.py
index 32f835c3..2507cf6f 100644
--- a/plexpy/activity_handler.py
+++ b/plexpy/activity_handler.py
@@ -551,7 +551,7 @@ class ReachabilityHandler(object):
     def __init__(self, data):
         self.data = data
 
-        self.is_reachable = self.data.get('reachable', False)
+        self.is_reachable = self.data.get('reachability', False)
 
     def remote_access_enabled(self):
         pms_connect = pmsconnect.PmsConnect()

From 7a11b109472a186d9f083f9a63413240e07a8556 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 24 Mar 2024 15:44:43 -0700
Subject: [PATCH 547/743] Fix Cloudinary delete all limit of 1000

---
 plexpy/helpers.py | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/plexpy/helpers.py b/plexpy/helpers.py
index a3257403..0cb17259 100644
--- a/plexpy/helpers.py
+++ b/plexpy/helpers.py
@@ -921,7 +921,12 @@ def delete_from_cloudinary(rating_key=None, delete_all=False):
     )
 
     if delete_all:
-        delete_resources_by_tag('tautulli')
+        partial = True
+        next_cursor = ''
+        while partial is True:
+            r = delete_resources_by_tag('tautulli', next_cursor=next_cursor)
+            partial = r.get('partial', False)
+            next_cursor = r.get('next_cursor', '')
         logger.debug("Tautulli Helpers :: Deleted all images from Cloudinary.")
     elif rating_key:
         delete_resources_by_tag(str(rating_key))

From 41693ee5f18003d75179a4671ad3f5332a30f52a Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 24 Mar 2024 15:46:57 -0700
Subject: [PATCH 548/743] Remove synced items from UI

---
 data/interfaces/default/base.html |  5 ---
 data/interfaces/default/user.html | 58 -------------------------------
 2 files changed, 63 deletions(-)

diff --git a/data/interfaces/default/base.html b/data/interfaces/default/base.html
index 19edb94b..6ef08805 100644
--- a/data/interfaces/default/base.html
+++ b/data/interfaces/default/base.html
@@ -123,11 +123,6 @@
                     % else:
                     <li><a href="graphs">Graphs</a></li>
                     % endif
-                    % if title == "Synced Items":
-                    <li class="active"><a href="sync">Synced Items</a></li>
-                    % else:
-                    <li><a href="sync">Synced Items</a></li>
-                    % endif
                     % if title == "Settings":
                     <li class="dropdown active">
                     % else:
diff --git a/data/interfaces/default/user.html b/data/interfaces/default/user.html
index 61dfdcb5..6ec74620 100644
--- a/data/interfaces/default/user.html
+++ b/data/interfaces/default/user.html
@@ -76,7 +76,6 @@ DOCUMENTATION :: END
                                     % if _session['user_group'] == 'admin':
                                     <li><a id="nav-tabs-export" href="#tabs-export" role="tab" data-toggle="tab">Export</a></li>
                                     % endif
-                                    <li><a id="nav-tabs-synceditems" href="#tabs-synceditems" role="tab" data-toggle="tab">Synced Items</a></li>
                                     <li><a id="nav-tabs-ipaddresses" href="#tabs-ipaddresses" role="tab" data-toggle="tab">IP Addresses</a></li>
                                     <li><a id="nav-tabs-tautullilogins" href="#tabs-tautullilogins" role="tab" data-toggle="tab">Tautulli Logins</a></li>
                                 </ul>
@@ -316,57 +315,6 @@ DOCUMENTATION :: END
                         </div>
                     </div>
                     % endif
-                    <div role="tabpanel" class="tab-pane" id="tabs-synceditems">
-                        <div class="container-fluid">
-                            <div class="row">
-                                <div class="col-md-12">
-                                    <div class='table-card-header'>
-                                        <div class="header-bar">
-                                            <span>
-                                                <i class="fa fa-cloud-download"></i> Synced Items for <strong>
-                                                    <span class="set-username">${data['friendly_name']}</span>
-                                                </strong>
-                                            </span>
-                                        </div>
-                                        <div class="button-bar">
-                                            % if _session['user_group'] == 'admin':
-                                            <div class="btn-group">
-                                                <button class="btn btn-danger btn-edit" data-toggle="button" aria-pressed="false" autocomplete="off" id="sync-row-edit-mode">
-                                                    <i class="fa fa-trash-o"></i> Delete mode
-                                                </button>
-                                            </div>
-                                            % endif
-                                            <div class="btn-group">
-                                                <button class="btn btn-dark refresh-syncs-button" id="refresh-syncs-list"><i class="fa fa-refresh"></i> Refresh synced items</button>
-                                            </div>
-                                            <div class="btn-group colvis-button-bar" id="button-bar-sync"></div>
-                                        </div>
-                                    </div>
-                                    <div class="table-card-back">
-                                        <table class="display sync_table" id="sync_table-UID-${data['user_id']}" width="100%">
-                                            <thead>
-                                                <tr>
-                                                    <th align="left" id="delete_row">Delete</th>
-                                                    <th align="left" id="state">State</th>
-                                                    <th align="left" id="username">Username</th>
-                                                    <th align="left" id="sync_title">Title</th>
-                                                    <th align="left" id="type">Type</th>
-                                                    <th align="left" id="sync_platform">Platform</th>
-                                                    <th align="left" id="device">Device</th>
-                                                    <th align="left" id="size">Total Size</th>
-                                                    <th align="left" id="items">Total Items</th>
-                                                    <th align="left" id="converted">Converted</th>
-                                                    <th align="left" id="downloaded">Downloaded</th>
-                                                    <th align="left" id="sync_percent_complete">Complete</th>
-                                                </tr>
-                                            </thead>
-                                            <tbody></tbody>
-                                        </table>
-                                    </div>
-                                </div>
-                            </div>
-                        </div>
-                    </div>
                     <div role="tabpanel" class="tab-pane" id="tabs-ipaddresses">
                         <div class="container-fluid">
                             <div class="row">
@@ -642,12 +590,6 @@ DOCUMENTATION :: END
         clearSearchButton('sync_table-UID-${data["user_id"]}', sync_table);
     }
 
-    $('#nav-tabs-synceditems').on('shown.bs.tab', function() {
-        if (typeof(sync_table) === 'undefined') {
-            loadSyncTable(user_id);
-        }
-    });
-
     $("#refresh-syncs-list").click(function() {
         sync_table.ajax.reload();
     });

From cfdb6975f0f57d5229f3bf674879e3eca94e7eb9 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 24 Mar 2024 16:08:58 -0700
Subject: [PATCH 549/743] Add platform version and product version notification
 parameters

Closes #2244
---
 plexpy/common.py               | 2 ++
 plexpy/notification_handler.py | 2 ++
 2 files changed, 4 insertions(+)

diff --git a/plexpy/common.py b/plexpy/common.py
index 9496913f..7ef798f8 100644
--- a/plexpy/common.py
+++ b/plexpy/common.py
@@ -397,7 +397,9 @@ NOTIFICATION_PARAMETERS = [
              {'name': 'User Thumb', 'type': 'str', 'value': 'user_thumb', 'description': 'The profile picture URL of the user streaming.'},
              {'name': 'Device', 'type': 'str', 'value': 'device', 'description': 'The type of client device being used for playback.'},
              {'name': 'Platform', 'type': 'str', 'value': 'platform', 'description': 'The type of client platform being used for playback.'},
+             {'name': 'Platform Version', 'type': 'str', 'value': 'platform_version', 'description': 'The version number of the client platform being used for playback.'},
              {'name': 'Product', 'type': 'str', 'value': 'product', 'description': 'The type of client product being used for playback.'},
+             {'name': 'Product Version', 'type': 'str', 'value': 'product_version', 'description': 'The version number of client product being used for playback.'},
              {'name': 'Player', 'type': 'str', 'value': 'player', 'description': 'The name of the player being used for playback.'},
              {'name': 'Initial Stream', 'type': 'int', 'value': 'initial_stream', 'description': 'If the stream is the initial stream of a continuous streaming session.', 'example': '0 or 1'},
              {'name': 'IP Address', 'type': 'str', 'value': 'ip_address', 'description': 'The IP address of the device being used for playback.'},
diff --git a/plexpy/notification_handler.py b/plexpy/notification_handler.py
index 34a60cd6..3ccec4e0 100644
--- a/plexpy/notification_handler.py
+++ b/plexpy/notification_handler.py
@@ -1005,7 +1005,9 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
         'user_thumb': notify_params['user_thumb'],
         'device': notify_params['device'],
         'platform': notify_params['platform'],
+        'platform_version': notify_params['platform_version'],
         'product': notify_params['product'],
+        'product_version': notify_params['product_version'],
         'player': notify_params['player'],
         'ip_address': notify_params.get('ip_address', 'N/A'),
         'started_datestamp': CustomArrow(arrow.get(notify_params['started']), date_format) if notify_params['started'] else '',

From 9fe58a6d86cfc8ca39f77c52d3daae032bc97cdd Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 24 Mar 2024 16:09:41 -0700
Subject: [PATCH 550/743] Add lan streams and wan streams notification
 parameters

Closes #2276
---
 plexpy/common.py               | 2 ++
 plexpy/notification_handler.py | 4 ++++
 2 files changed, 6 insertions(+)

diff --git a/plexpy/common.py b/plexpy/common.py
index 7ef798f8..a9156eb0 100644
--- a/plexpy/common.py
+++ b/plexpy/common.py
@@ -381,6 +381,8 @@ NOTIFICATION_PARAMETERS = [
         'category': 'Stream Details',
         'parameters': [
              {'name': 'Streams', 'type': 'int', 'value': 'streams', 'description': 'The total number of concurrent streams.'},
+             {'name': 'LAN Streams', 'type': 'int', 'value': 'lan_streams', 'description': 'The total number of concurrent LAN streams.'},
+             {'name': 'WAN Streams', 'type': 'int', 'value': 'wan_streams', 'description': 'The total number of concurrent WAN streams.'},
              {'name': 'Direct Plays', 'type': 'int', 'value': 'direct_plays', 'description': 'The total number of concurrent direct plays.'},
              {'name': 'Direct Streams', 'type': 'int', 'value': 'direct_streams', 'description': 'The total number of concurrent direct streams.'},
              {'name': 'Transcodes', 'type': 'int', 'value': 'transcodes', 'description': 'The total number of concurrent transcodes.'},
diff --git a/plexpy/notification_handler.py b/plexpy/notification_handler.py
index 3ccec4e0..dd45e761 100644
--- a/plexpy/notification_handler.py
+++ b/plexpy/notification_handler.py
@@ -624,6 +624,8 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
 
     stream_count = len(sessions)
     user_stream_count = len(user_sessions)
+    lan_streams = sum(1 for s in sessions if s['location'] == 'lan')
+    wan_streams = stream_count - lan_streams
 
     lan_bandwidth = sum(helpers.cast_to_int(s['bandwidth']) for s in sessions if s['location'] == 'lan')
     wan_bandwidth = sum(helpers.cast_to_int(s['bandwidth']) for s in sessions if s['location'] != 'lan')
@@ -989,6 +991,8 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
         'utctime': helpers.utc_now_iso(),
         # Stream parameters
         'streams': stream_count,
+        'lan_streams': lan_streams,
+        'wan_streams': wan_streams,
         'direct_plays': transcode_decision_count['direct play'],
         'direct_streams': transcode_decision_count['copy'],
         'transcodes': transcode_decision_count['transcode'],

From de3121cba98b3dc3e42336618c088dfc64549155 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 24 Mar 2024 16:36:18 -0700
Subject: [PATCH 551/743] Add Dolby Vision info to media info

---
 plexpy/pmsconnect.py | 14 ++++++++++++++
 plexpy/webserve.py   |  7 +++++++
 2 files changed, 21 insertions(+)

diff --git a/plexpy/pmsconnect.py b/plexpy/pmsconnect.py
index cf662be4..2e0ec22c 100644
--- a/plexpy/pmsconnect.py
+++ b/plexpy/pmsconnect.py
@@ -1516,6 +1516,13 @@ class PmsConnect(object):
                                             'video_color_space': helpers.get_xml_attr(stream, 'colorSpace'),
                                             'video_color_trc': helpers.get_xml_attr(stream, 'colorTrc'),
                                             'video_dynamic_range': self.get_dynamic_range(stream),
+                                            'video_dovi_bl_present': int(helpers.get_xml_attr(stream, 'DOVIBLPresent') == '1'),
+                                            'video_dovi_el_present': int(helpers.get_xml_attr(stream, 'DOVIELPresent') == '1'),
+                                            'video_dovi_level': helpers.cast_to_int(helpers.get_xml_attr(stream, 'DOVILevel')),
+                                            'video_dovi_present': int(helpers.get_xml_attr(stream, 'DOVIPresent') == '1'),
+                                            'video_dovi_profile': helpers.cast_to_int(helpers.get_xml_attr(stream, 'DOVIProfile')),
+                                            'video_dovi_rpu_present': int(helpers.get_xml_attr(stream, 'DOVIRPUPresent') == '1'),
+                                            'video_dovi_version': helpers.cast_to_float(helpers.get_xml_attr(stream, 'DOVIVersion')),
                                             'video_frame_rate': helpers.get_xml_attr(stream, 'frameRate'),
                                             'video_ref_frames': helpers.get_xml_attr(stream, 'refFrames'),
                                             'video_height': helpers.get_xml_attr(stream, 'height'),
@@ -1949,6 +1956,13 @@ class PmsConnect(object):
                              'stream_video_color_space': helpers.get_xml_attr(video_stream_info, 'colorSpace'),
                              'stream_video_color_trc': helpers.get_xml_attr(video_stream_info, 'colorTrc'),
                              'stream_video_dynamic_range': self.get_dynamic_range(video_stream_info),
+                             'stream_video_dovi_bl_present': int(helpers.get_xml_attr(video_stream_info, 'DOVIBLPresent') == '1'),
+                             'stream_video_dovi_el_present': int(helpers.get_xml_attr(video_stream_info, 'DOVIELPresent') == '1'),
+                             'stream_video_dovi_level': helpers.cast_to_int(helpers.get_xml_attr(video_stream_info, 'DOVILevel')),
+                             'stream_video_dovi_present': int(helpers.get_xml_attr(video_stream_info, 'DOVIPresent') == '1'),
+                             'stream_video_dovi_profile': helpers.cast_to_int(helpers.get_xml_attr(video_stream_info, 'DOVIProfile')),
+                             'stream_video_dovi_rpu_present': int(helpers.get_xml_attr(video_stream_info, 'DOVIRPUPresent') == '1'),
+                             'stream_video_dovi_version': helpers.cast_to_float(helpers.get_xml_attr(video_stream_info, 'DOVIVersion')),
                              'stream_video_height': helpers.get_xml_attr(video_stream_info, 'height'),
                              'stream_video_width': helpers.get_xml_attr(video_stream_info, 'width'),
                              'stream_video_ref_frames': helpers.get_xml_attr(video_stream_info, 'refFrames'),
diff --git a/plexpy/webserve.py b/plexpy/webserve.py
index 196bbe5b..d45ce049 100644
--- a/plexpy/webserve.py
+++ b/plexpy/webserve.py
@@ -5464,6 +5464,13 @@ class WebInterface(object):
                                              "video_color_space": "bt709",
                                              "video_color_trc": "",
                                              "video_dynamic_range": "SDR",
+                                             "video_dovi_bl_present": 0,
+                                             "video_dovi_el_present": 0,
+                                             "video_dovi_level": 0,
+                                             "video_dovi_present": 0,
+                                             "video_dovi_profile": 0,
+                                             "video_dovi_rpu_present": 0,
+                                             "video_dovi_version": 0,
                                              "video_frame_rate": "23.976",
                                              "video_height": "1078",
                                              "video_language": "",

From c737161164b521936305fc59bfb721ec05f1af9d Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 24 Mar 2024 16:37:34 -0700
Subject: [PATCH 552/743] Add dovi notification parameters

Closes #2240
---
 plexpy/common.py               | 6 ++++++
 plexpy/notification_handler.py | 6 ++++++
 2 files changed, 12 insertions(+)

diff --git a/plexpy/common.py b/plexpy/common.py
index a9156eb0..b87caffd 100644
--- a/plexpy/common.py
+++ b/plexpy/common.py
@@ -457,6 +457,9 @@ NOTIFICATION_PARAMETERS = [
              {'name': 'Stream Video Color Space', 'type': 'str', 'value': 'stream_video_color_space', 'description': 'The video color space of the stream.'},
              {'name': 'Stream Video Color Transfer Function', 'type': 'str', 'value': 'stream_video_color_trc', 'description': 'The video transfer function of the stream.'},
              {'name': 'Stream Video Dynamic Range', 'type': 'str', 'value': 'stream_video_dynamic_range', 'description': 'The video dynamic range of the stream.', 'example': 'HDR or SDR'},
+             {'name': 'Stream Video DOVI Present', 'type': 'int', 'value': 'stream_video_dovi_present', 'description': 'If Dolby Vision is present in the stream.', 'example': '0 or 1'},
+             {'name': 'Stream Video DOVI Level', 'type': 'int', 'value': 'stream_video_dovi_level', 'description': 'The Dolby Vision level of the stream.'},
+             {'name': 'Stream Video DOVI Profile', 'type': 'int', 'value': 'stream_video_dovi_profile', 'description': 'The Dolby Vision profile of the stream.',},
              {'name': 'Stream Video Framerate', 'type': 'str', 'value': 'stream_video_framerate', 'description': 'The video framerate of the stream.'},
              {'name': 'Stream Video Full Resolution', 'type': 'str', 'value': 'stream_video_full_resolution', 'description': 'The video resolution of the stream with scan type.'},
              {'name': 'Stream Video Ref Frames', 'type': 'int', 'value': 'stream_video_ref_frames', 'description': 'The video reference frames of the stream.'},
@@ -582,6 +585,9 @@ NOTIFICATION_PARAMETERS = [
              {'name': 'Video Color Space', 'type': 'str', 'value': 'video_color_space', 'description': 'The video color space of the original media.'},
              {'name': 'Video Color Transfer Function', 'type': 'str', 'value': 'video_color_trc', 'description': 'The video transfer function of the original media.'},
              {'name': 'Video Dynamic Range', 'type': 'str', 'value': 'video_dynamic_range', 'description': 'The video dynamic range of the original media.', 'example': 'HDR or SDR'},
+             {'name': 'Video DOVI Present', 'type': 'int', 'value': 'video_dovi_present', 'description': 'If Dolby Vision is present in the original media.', 'example': '0 or 1'},
+             {'name': 'Video DOVI Level', 'type': 'int', 'value': 'video_dovi_level', 'description': 'The Dolby Vision level of the original media.'},
+             {'name': 'Video DOVI Profile', 'type': 'int', 'value': 'video_dovi_profile', 'description': 'The Dolby Vision profile of the original media.',},
              {'name': 'Video Framerate', 'type': 'str', 'value': 'video_framerate', 'description': 'The video framerate of the original media.'},
              {'name': 'Video Full Resolution', 'type': 'str', 'value': 'video_full_resolution', 'description': 'The video resolution of the original media with scan type.'},
              {'name': 'Video Ref Frames', 'type': 'int', 'value': 'video_ref_frames', 'description': 'The video reference frames of the original media.'},
diff --git a/plexpy/notification_handler.py b/plexpy/notification_handler.py
index dd45e761..b2780835 100644
--- a/plexpy/notification_handler.py
+++ b/plexpy/notification_handler.py
@@ -1067,6 +1067,9 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
         'stream_video_color_space': notify_params['stream_video_color_space'],
         'stream_video_color_trc': notify_params['stream_video_color_trc'],
         'stream_video_dynamic_range': notify_params['stream_video_dynamic_range'],
+        'stream_video_dovi_present': notify_params['stream_video_dovi_present'],
+        'stream_video_dovi_level': notify_params['stream_video_dovi_level'],
+        'stream_video_dovi_profile': notify_params['stream_video_dovi_profile'],
         'stream_video_framerate': notify_params['stream_video_framerate'],
         'stream_video_full_resolution': notify_params['stream_video_full_resolution'],
         'stream_video_ref_frames': notify_params['stream_video_ref_frames'],
@@ -1195,6 +1198,9 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
         'video_color_space': notify_params['video_color_space'],
         'video_color_trc': notify_params['video_color_trc'],
         'video_dynamic_range': notify_params['video_dynamic_range'],
+        'video_dovi_present': notify_params['video_dovi_present'],
+        'video_dovi_level': notify_params['video_dovi_level'],
+        'video_dovi_profile': notify_params['video_dovi_profile'],
         'video_framerate': notify_params['video_framerate'],
         'video_full_resolution': notify_params['video_full_resolution'],
         'video_ref_frames': notify_params['video_ref_frames'],

From fcd8ef11f4fbb6a664c57b7898d27a900724f7d7 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 24 Mar 2024 17:26:18 -0700
Subject: [PATCH 553/743] Add before and after parameters to get_home_stats API

Closes #2231
---
 plexpy/datafactory.py | 69 ++++++++++++++++++++++++-------------------
 plexpy/helpers.py     |  4 +++
 plexpy/webserve.py    |  8 +++--
 3 files changed, 48 insertions(+), 33 deletions(-)

diff --git a/plexpy/datafactory.py b/plexpy/datafactory.py
index de3ed030..037097af 100644
--- a/plexpy/datafactory.py
+++ b/plexpy/datafactory.py
@@ -367,11 +367,10 @@ class DataFactory(object):
 
     def get_home_stats(self, grouping=None, time_range=30, stats_type='plays',
                        stats_start=0, stats_count=10, stat_id='', stats_cards=None,
-                       section_id=None, user_id=None):
+                       section_id=None, user_id=None, before=None, after=None):
         monitor_db = database.MonitorDatabase()
 
         time_range = helpers.cast_to_int(time_range)
-        timestamp = helpers.timestamp() - time_range * 24 * 60 * 60
 
         stats_start = helpers.cast_to_int(stats_start)
         stats_count = helpers.cast_to_int(stats_count)
@@ -382,6 +381,21 @@ class DataFactory(object):
         if stats_cards is None:
             stats_cards = plexpy.CONFIG.HOME_STATS_CARDS
 
+        where_timeframe = ''
+        if before:
+            where_timeframe += "AND strftime('%%Y-%%m-%%d', datetime(started, 'unixepoch', 'localtime')) <= '%s' " % before
+            if not after:
+                timestamp = helpers.YMD_to_timestamp(before) - time_range * 24 * 60 * 60
+                where_timeframe += "AND session_history.stopped >= %s " % timestamp
+        if after:
+            where_timeframe += "AND strftime('%%Y-%%m-%%d', datetime(started, 'unixepoch', 'localtime')) >= '%s' " % after
+            if not before:
+                timestamp = helpers.YMD_to_timestamp(after) + time_range * 24 * 60 * 60
+                where_timeframe += "AND session_history.stopped <= %s " % timestamp
+        if not (before and after):
+            timestamp = helpers.timestamp() - time_range * 24 * 60 * 60
+            where_timeframe += "AND session_history.stopped >= %s" % timestamp
+
         where_id = ''
         if section_id:
             where_id += 'AND session_history.section_id = %s ' % section_id
@@ -404,13 +418,12 @@ class DataFactory(object):
                             "       (CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) ELSE 0 END) " \
                             "       AS d " \
                             "   FROM session_history " \
-                            "   WHERE session_history.stopped >= %s " \
-                            "       AND session_history.media_type = 'movie' %s " \
+                            "   WHERE session_history.media_type = 'movie' %s %s " \
                             "   GROUP BY %s) AS sh " \
                             "JOIN session_history_metadata AS shm ON shm.id = sh.id " \
                             "GROUP BY shm.full_title, shm.year " \
                             "ORDER BY %s DESC, sh.started DESC " \
-                            "LIMIT %s OFFSET %s " % (timestamp, where_id, group_by, sort_type, stats_count, stats_start)
+                            "LIMIT %s OFFSET %s " % (where_timeframe, where_id, group_by, sort_type, stats_count, stats_start)
                     result = monitor_db.select(query)
                 except Exception as e:
                     logger.warn("Tautulli DataFactory :: Unable to execute database query for get_home_stats: top_movies: %s." % e)
@@ -457,13 +470,12 @@ class DataFactory(object):
                             "       (CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) ELSE 0 END) " \
                             "       AS d " \
                             "   FROM session_history " \
-                            "   WHERE session_history.stopped >= %s " \
-                            "       AND session_history.media_type = 'movie' %s " \
+                            "   WHERE session_history.media_type = 'movie' %s %s " \
                             "   GROUP BY %s) AS sh " \
                             "JOIN session_history_metadata AS shm ON shm.id = sh.id " \
                             "GROUP BY shm.full_title, shm.year " \
                             "ORDER BY users_watched DESC, %s DESC, sh.started DESC " \
-                            "LIMIT %s OFFSET %s " % (timestamp, where_id, group_by, sort_type, stats_count, stats_start)
+                            "LIMIT %s OFFSET %s " % (where_timeframe, where_id, group_by, sort_type, stats_count, stats_start)
                     result = monitor_db.select(query)
                 except Exception as e:
                     logger.warn("Tautulli DataFactory :: Unable to execute database query for get_home_stats: popular_movies: %s." % e)
@@ -509,13 +521,12 @@ class DataFactory(object):
                             "       (CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) ELSE 0 END) " \
                             "       AS d " \
                             "   FROM session_history " \
-                            "   WHERE session_history.stopped >= %s " \
-                            "       AND session_history.media_type = 'episode' %s " \
+                            "   WHERE session_history.media_type = 'episode' %s %s " \
                             "   GROUP BY %s) AS sh " \
                             "JOIN session_history_metadata AS shm ON shm.id = sh.id " \
                             "GROUP BY shm.grandparent_title " \
                             "ORDER BY %s DESC, sh.started DESC " \
-                            "LIMIT %s OFFSET %s " % (timestamp, where_id, group_by, sort_type, stats_count, stats_start)
+                            "LIMIT %s OFFSET %s " % (where_timeframe, where_id, group_by, sort_type, stats_count, stats_start)
                     result = monitor_db.select(query)
                 except Exception as e:
                     logger.warn("Tautulli DataFactory :: Unable to execute database query for get_home_stats: top_tv: %s." % e)
@@ -564,13 +575,12 @@ class DataFactory(object):
                             "       (CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) ELSE 0 END) " \
                             "       AS d " \
                             "   FROM session_history " \
-                            "   WHERE session_history.stopped >= %s " \
-                            "       AND session_history.media_type = 'episode' %s " \
+                            "   WHERE session_history.media_type = 'episode' %s %s " \
                             "   GROUP BY %s) AS sh " \
                             "JOIN session_history_metadata AS shm ON shm.id = sh.id " \
                             "GROUP BY shm.grandparent_title " \
                             "ORDER BY users_watched DESC, %s DESC, sh.started DESC " \
-                            "LIMIT %s OFFSET %s " % (timestamp, where_id, group_by, sort_type, stats_count, stats_start)
+                            "LIMIT %s OFFSET %s " % (where_timeframe, where_id, group_by, sort_type, stats_count, stats_start)
                     result = monitor_db.select(query)
                 except Exception as e:
                     logger.warn("Tautulli DataFactory :: Unable to execute database query for get_home_stats: popular_tv: %s." % e)
@@ -615,13 +625,12 @@ class DataFactory(object):
                             "       (CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) ELSE 0 END) " \
                             "       AS d " \
                             "   FROM session_history " \
-                            "   WHERE session_history.stopped >= %s " \
-                            "       AND session_history.media_type = 'track' %s " \
+                            "   WHERE session_history.media_type = 'track' %s %s " \
                             "   GROUP BY %s) AS sh " \
                             "JOIN session_history_metadata AS shm ON shm.id = sh.id " \
                             "GROUP BY shm.original_title, shm.grandparent_title " \
                             "ORDER BY %s DESC, sh.started DESC " \
-                            "LIMIT %s OFFSET %s " % (timestamp, where_id, group_by, sort_type, stats_count, stats_start)
+                            "LIMIT %s OFFSET %s " % (where_timeframe, where_id, group_by, sort_type, stats_count, stats_start)
                     result = monitor_db.select(query)
                 except Exception as e:
                     logger.warn("Tautulli DataFactory :: Unable to execute database query for get_home_stats: top_music: %s." % e)
@@ -669,13 +678,12 @@ class DataFactory(object):
                             "       (CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) ELSE 0 END) " \
                             "       AS d " \
                             "   FROM session_history " \
-                            "   WHERE session_history.stopped >= %s " \
-                            "       AND session_history.media_type = 'track' %s " \
+                            "   WHERE session_history.media_type = 'track' %s %s " \
                             "   GROUP BY %s) AS sh " \
                             "JOIN session_history_metadata AS shm ON shm.id = sh.id " \
                             "GROUP BY shm.original_title, shm.grandparent_title " \
                             "ORDER BY users_watched DESC, %s DESC, sh.started DESC " \
-                            "LIMIT %s OFFSET %s " % (timestamp, where_id, group_by, sort_type, stats_count, stats_start)
+                            "LIMIT %s OFFSET %s " % (where_timeframe, where_id, group_by, sort_type, stats_count, stats_start)
                     result = monitor_db.select(query)
                 except Exception as e:
                     logger.warn("Tautulli DataFactory :: Unable to execute database query for get_home_stats: popular_music: %s." % e)
@@ -726,14 +734,14 @@ class DataFactory(object):
                             "       (CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) ELSE 0 END) " \
                             "       AS d " \
                             "   FROM session_history " \
-                            "   WHERE session_history.stopped >= %s %s " \
+                            "   WHERE %s %s " \
                             "   GROUP BY %s) AS sh " \
                             "JOIN session_history_metadata AS shm ON shm.id = sh.id " \
                             "LEFT OUTER JOIN (SELECT * FROM library_sections WHERE deleted_section = 0) " \
                             "   AS ls ON sh.section_id = ls.section_id " \
                             "GROUP BY sh.section_id " \
                             "ORDER BY %s DESC, sh.started DESC " \
-                            "LIMIT %s OFFSET %s " % (timestamp, where_id, group_by, sort_type, stats_count, stats_start)
+                            "LIMIT %s OFFSET %s " % (where_timeframe[4:], where_id, group_by, sort_type, stats_count, stats_start)
                     result = monitor_db.select(query)
                 except Exception as e:
                     logger.warn("Tautulli DataFactory :: Unable to execute database query for get_home_stats: top_libraries: %s." % e)
@@ -815,13 +823,13 @@ class DataFactory(object):
                             "       (CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) ELSE 0 END) " \
                             "       AS d " \
                             "   FROM session_history " \
-                            "   WHERE session_history.stopped >= %s %s " \
+                            "   WHERE %s %s " \
                             "   GROUP BY %s) AS sh " \
                             "JOIN session_history_metadata AS shm ON shm.id = sh.id " \
                             "LEFT OUTER JOIN users AS u ON sh.user_id = u.user_id " \
                             "GROUP BY sh.user_id " \
                             "ORDER BY %s DESC, sh.started DESC " \
-                            "LIMIT %s OFFSET %s " % (timestamp, where_id, group_by, sort_type, stats_count, stats_start)
+                            "LIMIT %s OFFSET %s " % (where_timeframe[4:], where_id, group_by, sort_type, stats_count, stats_start)
                     result = monitor_db.select(query)
                 except Exception as e:
                     logger.warn("Tautulli DataFactory :: Unable to execute database query for get_home_stats: top_users: %s." % e)
@@ -884,11 +892,11 @@ class DataFactory(object):
                             "       (CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END) ELSE 0 END) " \
                             "       AS d " \
                             "   FROM session_history " \
-                            "   WHERE session_history.stopped >= %s %s " \
+                            "   WHERE %s %s " \
                             "   GROUP BY %s) AS sh " \
                             "GROUP BY sh.platform " \
                             "ORDER BY %s DESC, sh.started DESC " \
-                            "LIMIT %s OFFSET %s " % (timestamp, where_id, group_by, sort_type, stats_count, stats_start)
+                            "LIMIT %s OFFSET %s " % (where_timeframe[4:], where_id, group_by, sort_type, stats_count, stats_start)
                     result = monitor_db.select(query)
                 except Exception as e:
                     logger.warn("Tautulli DataFactory :: Unable to execute database query for get_home_stats: top_platforms: %s." % e)
@@ -978,9 +986,8 @@ class DataFactory(object):
                             "   (CASE WHEN duration IS NULL THEN 1.0 ELSE duration * 1.0 END) AS _duration " \
                             "   FROM session_history " \
                             "   JOIN session_history_metadata ON session_history_metadata.id = session_history.id " \
-                            "   WHERE session_history.stopped >= %s " \
-                            "       AND (session_history.media_type = 'movie' " \
-                            "           OR session_history.media_type = 'episode') %s " \
+                            "   WHERE (session_history.media_type = 'movie' " \
+                            "           OR session_history.media_type = 'episode') %s %s " \
                             "   GROUP BY %s) AS sh " \
                             "JOIN session_history_metadata AS shm ON shm.id = sh.id " \
                             "LEFT OUTER JOIN users AS u ON sh.user_id = u.user_id " \
@@ -988,7 +995,7 @@ class DataFactory(object):
                             "GROUP BY sh.id " \
                             "ORDER BY last_watch DESC " \
                             "LIMIT %s OFFSET %s" % (watched_threshold,
-                                                    timestamp, where_id, group_by, watched_where,
+                                                    where_timeframe, where_id, group_by, watched_where,
                                                     stats_count, stats_start)
                     result = monitor_db.select(query)
                 except Exception as e:
@@ -1076,7 +1083,7 @@ class DataFactory(object):
                     base_query = "SELECT sh.started, sh.stopped " \
                                  "FROM session_history AS sh " \
                                  "JOIN session_history_media_info AS shmi ON sh.id = shmi.id " \
-                                 "WHERE sh.stopped >= %s " % timestamp
+                                 "WHERE %s " % where_timeframe[4:].replace('session_history.', 'sh.')
 
                     title = 'Concurrent Streams'
                     query = base_query
diff --git a/plexpy/helpers.py b/plexpy/helpers.py
index 0cb17259..04391204 100644
--- a/plexpy/helpers.py
+++ b/plexpy/helpers.py
@@ -238,6 +238,10 @@ def now(sep=False):
     return timestamp_to_YMDHMS(timestamp(), sep=sep)
 
 
+def YMD_to_timestamp(ymd):
+    return datetime.strptime(ymd, "%Y-%m-%d").timestamp()
+
+
 def timestamp_to_YMDHMS(ts, sep=False):
     dt = timestamp_to_datetime(ts)
     if sep:
diff --git a/plexpy/webserve.py b/plexpy/webserve.py
index d45ce049..1e73cca9 100644
--- a/plexpy/webserve.py
+++ b/plexpy/webserve.py
@@ -6283,7 +6283,7 @@ class WebInterface(object):
     @addtoapi()
     def get_home_stats(self, grouping=None, time_range=30, stats_type='plays',
                        stats_start=0, stats_count=10, stat_id='',
-                       section_id=None, user_id=None, **kwargs):
+                       section_id=None, user_id=None, before=None, after=None, **kwargs):
         """ Get the homepage watch statistics.
 
             ```
@@ -6301,6 +6301,8 @@ class WebInterface(object):
                                         'top_users', 'top_platforms', 'last_watched', 'most_concurrent'
                 section_id (int):       The id of the Plex library section
                 user_id (int):          The id of the Plex user
+                before (str):           Stats before and including the date, "YYYY-MM-DD"
+                after (str):            Stats after and including the date, "YYYY-MM-DD"
 
             Returns:
                 json:
@@ -6384,7 +6386,9 @@ class WebInterface(object):
                                              stats_count=stats_count,
                                              stat_id=stat_id,
                                              section_id=section_id,
-                                             user_id=user_id)
+                                             user_id=user_id,
+                                             before=before,
+                                             after=after)
 
         if result:
             return result

From 2fc618c01f23068bb6fe647f213a01d34f2fa73d Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 24 Mar 2024 17:40:56 -0700
Subject: [PATCH 554/743] Revert "Bump cherrypy from 18.8.0 to 18.9.0 (#2266)"

This reverts commit faef9a94c443c7681839725fa4d715c8a45bc125.
---
 lib/PyWin32.chm                               |  Bin 2648456 -> 0 bytes
 lib/adodbapi/__init__.py                      |   74 -
 lib/adodbapi/ado_consts.py                    |  281 -
 lib/adodbapi/adodbapi.py                      | 1223 ----
 lib/adodbapi/apibase.py                       |  794 ---
 lib/adodbapi/examples/db_print.py             |   72 -
 lib/adodbapi/examples/db_table_names.py       |   20 -
 lib/adodbapi/examples/xls_read.py             |   41 -
 lib/adodbapi/examples/xls_write.py            |   41 -
 lib/adodbapi/is64bit.py                       |   41 -
 lib/adodbapi/license.txt                      |  506 --
 lib/adodbapi/process_connect_string.py        |  144 -
 lib/adodbapi/readme.txt                       |   92 -
 lib/adodbapi/remote.py                        |  634 --
 lib/adodbapi/schema_table.py                  |   15 -
 lib/adodbapi/setup.py                         |   70 -
 lib/adodbapi/test/adodbapitest.py             | 1692 ------
 lib/adodbapi/test/adodbapitestconfig.py       |  221 -
 lib/adodbapi/test/dbapi20.py                  |  939 ---
 lib/adodbapi/test/is64bit.py                  |   41 -
 lib/adodbapi/test/setuptestframework.py       |  134 -
 lib/adodbapi/test/test_adodbapi_dbapi20.py    |  200 -
 lib/adodbapi/test/tryconnection.py            |   33 -
 lib/annotated_types/__init__.py               |  396 --
 lib/annotated_types/py.typed                  |    0
 lib/annotated_types/test_cases.py             |  147 -
 lib/autocommand/autoasync.py                  |    8 +-
 lib/cherrypy/_cplogging.py                    |    6 +-
 lib/cherrypy/lib/cptools.py                   |   12 +-
 lib/cherrypy/lib/profiler.py                  |    4 +-
 lib/cherrypy/lib/reprconf.py                  |    2 +-
 lib/cherrypy/lib/static.py                    |   12 +-
 lib/cherrypy/process/wspbus.py                |    2 +-
 lib/cherrypy/test/test_http.py                |   15 -
 lib/cherrypy/test/test_iterator.py            |    2 -
 lib/cherrypy/test/test_logging.py             |   28 -
 lib/inflect/__init__.py                       |  180 +-
 lib/inflect/compat/pydantic.py                |   19 -
 lib/inflect/compat/pydantic1.py               |    8 -
 lib/isapi/README.txt                          |    7 -
 lib/isapi/__init__.py                         |   39 -
 lib/isapi/doc/isapi.html                      |   92 -
 lib/isapi/install.py                          |  815 ---
 lib/isapi/isapicon.py                         |  120 -
 lib/isapi/samples/README.txt                  |   20 -
 lib/isapi/samples/advanced.py                 |  218 -
 lib/isapi/samples/redirector.py               |  125 -
 lib/isapi/samples/redirector_asynch.py        |   85 -
 lib/isapi/samples/redirector_with_filter.py   |  161 -
 lib/isapi/samples/test.py                     |  195 -
 lib/isapi/simple.py                           |   70 -
 lib/isapi/test/README.txt                     |    3 -
 lib/isapi/test/extension_simple.py            |  119 -
 lib/isapi/threaded_extension.py               |  189 -
 .../compat => jaraco/classes}/__init__.py     |    0
 .../__init__.py => collections.py}            |  152 +-
 lib/jaraco/collections/py.typed               |    0
 lib/jaraco/context.py                         |   75 -
 .../{functools/__init__.py => functools.py}   |  155 +-
 lib/jaraco/functools/__init__.pyi             |  128 -
 lib/jaraco/functools/py.typed                 |    0
 lib/jaraco/text/__init__.py                   |   18 +-
 lib/jaraco/text/show-newlines.py              |    4 +-
 lib/jaraco/text/strip-prefix.py               |   21 -
 lib/more_itertools/__init__.py                |    2 +-
 lib/more_itertools/more.py                    |  143 +-
 lib/more_itertools/more.pyi                   |   23 +-
 lib/more_itertools/recipes.py                 |  113 +-
 lib/more_itertools/recipes.pyi                |   16 +-
 lib/pydantic/__init__.py                      |  373 +-
 lib/pydantic/{v1 => }/_hypothesis_plugin.py   |    9 +-
 lib/pydantic/_internal/__init__.py            |    0
 lib/pydantic/_internal/_config.py             |  322 --
 lib/pydantic/_internal/_core_metadata.py      |   92 -
 lib/pydantic/_internal/_core_utils.py         |  570 --
 lib/pydantic/_internal/_dataclasses.py        |  225 -
 lib/pydantic/_internal/_decorators.py         |  791 ---
 lib/pydantic/_internal/_decorators_v1.py      |  181 -
 .../_internal/_discriminated_union.py         |  506 --
 lib/pydantic/_internal/_fields.py             |  319 --
 lib/pydantic/_internal/_forward_ref.py        |   23 -
 lib/pydantic/_internal/_generate_schema.py    | 2231 --------
 lib/pydantic/_internal/_generics.py           |  517 --
 lib/pydantic/_internal/_git.py                |   26 -
 lib/pydantic/_internal/_internal_dataclass.py |   10 -
 .../_internal/_known_annotated_metadata.py    |  410 --
 lib/pydantic/_internal/_mock_val_ser.py       |  140 -
 lib/pydantic/_internal/_model_construction.py |  637 ---
 lib/pydantic/_internal/_repr.py               |  117 -
 .../_internal/_schema_generation_shared.py    |  124 -
 lib/pydantic/_internal/_signature.py          |  164 -
 lib/pydantic/_internal/_std_types_schema.py   |  714 ---
 lib/pydantic/_internal/_typing_extra.py       |  469 --
 lib/pydantic/_internal/_utils.py              |  362 --
 lib/pydantic/_internal/_validate_call.py      |   84 -
 lib/pydantic/_internal/_validators.py         |  278 -
 lib/pydantic/_migration.py                    |  308 -
 lib/pydantic/alias_generators.py              |   50 -
 lib/pydantic/aliases.py                       |  112 -
 lib/pydantic/annotated_handlers.py            |  120 -
 lib/pydantic/{v1 => }/annotated_types.py      |    0
 lib/pydantic/class_validators.py              |  344 +-
 lib/pydantic/color.py                         |  295 +-
 lib/pydantic/config.py                        | 1084 +---
 lib/pydantic/dataclasses.py                   |  632 +-
 lib/pydantic/datetime_parse.py                |  250 +-
 lib/pydantic/decorator.py                     |  266 +-
 lib/pydantic/deprecated/__init__.py           |    0
 lib/pydantic/deprecated/class_validators.py   |  253 -
 lib/pydantic/deprecated/config.py             |   72 -
 lib/pydantic/deprecated/copy_internals.py     |  224 -
 lib/pydantic/deprecated/decorator.py          |  279 -
 lib/pydantic/deprecated/json.py               |  140 -
 lib/pydantic/deprecated/parse.py              |   80 -
 lib/pydantic/deprecated/tools.py              |  103 -
 lib/pydantic/env_settings.py                  |  348 +-
 lib/pydantic/error_wrappers.py                |  164 +-
 lib/pydantic/errors.py                        |  750 ++-
 lib/pydantic/fields.py                        | 2207 +++----
 lib/pydantic/functional_serializers.py        |  395 --
 lib/pydantic/functional_validators.py         |  706 ---
 lib/pydantic/generics.py                      |  366 +-
 lib/pydantic/json.py                          |  114 +-
 lib/pydantic/json_schema.py                   | 2425 --------
 lib/pydantic/main.py                          | 2291 +++-----
 lib/pydantic/mypy.py                          | 1199 ++--
 lib/pydantic/networks.py                      | 1110 ++--
 lib/pydantic/parse.py                         |   68 +-
 lib/pydantic/plugin/__init__.py               |  170 -
 lib/pydantic/plugin/_loader.py                |   50 -
 lib/pydantic/plugin/_schema_validator.py      |  138 -
 lib/pydantic/root_model.py                    |  149 -
 lib/pydantic/schema.py                        | 1155 +++-
 lib/pydantic/tools.py                         |   94 +-
 lib/pydantic/type_adapter.py                  |  460 --
 lib/pydantic/types.py                         | 3368 +++--------
 lib/pydantic/typing.py                        |  604 +-
 lib/pydantic/utils.py                         |  843 ++-
 lib/pydantic/v1/__init__.py                   |  131 -
 lib/pydantic/v1/class_validators.py           |  361 --
 lib/pydantic/v1/color.py                      |  494 --
 lib/pydantic/v1/config.py                     |  191 -
 lib/pydantic/v1/dataclasses.py                |  500 --
 lib/pydantic/v1/datetime_parse.py             |  248 -
 lib/pydantic/v1/decorator.py                  |  264 -
 lib/pydantic/v1/env_settings.py               |  350 --
 lib/pydantic/v1/error_wrappers.py             |  161 -
 lib/pydantic/v1/errors.py                     |  646 ---
 lib/pydantic/v1/fields.py                     | 1253 ----
 lib/pydantic/v1/generics.py                   |  400 --
 lib/pydantic/v1/json.py                       |  112 -
 lib/pydantic/v1/main.py                       | 1107 ----
 lib/pydantic/v1/mypy.py                       |  944 ---
 lib/pydantic/v1/networks.py                   |  747 ---
 lib/pydantic/v1/parse.py                      |   66 -
 lib/pydantic/v1/py.typed                      |    0
 lib/pydantic/v1/schema.py                     | 1163 ----
 lib/pydantic/v1/tools.py                      |   92 -
 lib/pydantic/v1/types.py                      | 1205 ----
 lib/pydantic/v1/typing.py                     |  603 --
 lib/pydantic/v1/utils.py                      |  803 ---
 lib/pydantic/v1/validators.py                 |  765 ---
 lib/pydantic/v1/version.py                    |   38 -
 lib/pydantic/validate_call_decorator.py       |   67 -
 lib/pydantic/validators.py                    |  767 ++-
 lib/pydantic/version.py                       |   84 +-
 lib/pydantic/warnings.py                      |   58 -
 lib/pydantic_core/__init__.py                 |  139 -
 lib/pydantic_core/_pydantic_core.pyi          |  882 ---
 lib/pydantic_core/core_schema.py              | 3980 -------------
 lib/pydantic_core/py.typed                    |    0
 lib/pythoncom.py                              |    4 -
 lib/pythonwin/license.txt                     |   30 -
 .../pywin/Demos/app/basictimerapp.py          |  258 -
 lib/pythonwin/pywin/Demos/app/customprint.py  |  186 -
 lib/pythonwin/pywin/Demos/app/demoutils.py    |   65 -
 lib/pythonwin/pywin/Demos/app/dlgappdemo.py   |   51 -
 lib/pythonwin/pywin/Demos/app/dojobapp.py     |   72 -
 lib/pythonwin/pywin/Demos/app/helloapp.py     |   53 -
 lib/pythonwin/pywin/Demos/cmdserver.py        |  116 -
 lib/pythonwin/pywin/Demos/createwin.py        |  114 -
 lib/pythonwin/pywin/Demos/demoutils.py        |   67 -
 lib/pythonwin/pywin/Demos/dibdemo.py          |   73 -
 lib/pythonwin/pywin/Demos/dlgtest.py          |  145 -
 lib/pythonwin/pywin/Demos/dyndlg.py           |  104 -
 lib/pythonwin/pywin/Demos/fontdemo.py         |   86 -
 lib/pythonwin/pywin/Demos/guidemo.py          |   86 -
 lib/pythonwin/pywin/Demos/hiertest.py         |  138 -
 lib/pythonwin/pywin/Demos/menutest.py         |   13 -
 lib/pythonwin/pywin/Demos/objdoc.py           |   57 -
 lib/pythonwin/pywin/Demos/ocx/__init__.py     |    0
 lib/pythonwin/pywin/Demos/ocx/demoutils.py    |   67 -
 lib/pythonwin/pywin/Demos/ocx/flash.py        |   95 -
 lib/pythonwin/pywin/Demos/ocx/msoffice.py     |  152 -
 .../pywin/Demos/ocx/ocxserialtest.py          |  133 -
 lib/pythonwin/pywin/Demos/ocx/ocxtest.py      |  250 -
 lib/pythonwin/pywin/Demos/ocx/webbrowser.py   |   72 -
 lib/pythonwin/pywin/Demos/openGLDemo.py       |  370 --
 lib/pythonwin/pywin/Demos/progressbar.py      |  105 -
 lib/pythonwin/pywin/Demos/sliderdemo.py       |   76 -
 lib/pythonwin/pywin/Demos/splittst.py         |   79 -
 lib/pythonwin/pywin/Demos/threadedgui.py      |  189 -
 lib/pythonwin/pywin/Demos/toolbar.py          |  106 -
 lib/pythonwin/pywin/IDLE.cfg                  |   29 -
 lib/pythonwin/pywin/__init__.py               |   10 -
 lib/pythonwin/pywin/default.cfg               |  215 -
 lib/pythonwin/pywin/dialogs/__init__.py       |    0
 lib/pythonwin/pywin/dialogs/ideoptions.py     |  139 -
 lib/pythonwin/pywin/dialogs/list.py           |  143 -
 lib/pythonwin/pywin/dialogs/login.py          |  156 -
 lib/pythonwin/pywin/dialogs/status.py         |  242 -
 lib/pythonwin/pywin/docking/DockingBar.py     |  679 ---
 lib/pythonwin/pywin/docking/__init__.py       |    0
 lib/pythonwin/pywin/framework/__init__.py     |    0
 lib/pythonwin/pywin/framework/app.py          |  457 --
 lib/pythonwin/pywin/framework/bitmap.py       |  164 -
 lib/pythonwin/pywin/framework/cmdline.py      |   56 -
 lib/pythonwin/pywin/framework/dbgcommands.py  |  189 -
 lib/pythonwin/pywin/framework/dlgappcore.py   |   75 -
 .../pywin/framework/editor/ModuleBrowser.py   |  235 -
 .../pywin/framework/editor/__init__.py        |  106 -
 .../pywin/framework/editor/color/__init__.py  |    0
 .../framework/editor/color/coloreditor.py     |  664 ---
 .../pywin/framework/editor/configui.py        |  308 -
 .../pywin/framework/editor/document.py        |  378 --
 .../pywin/framework/editor/editor.py          |  516 --
 lib/pythonwin/pywin/framework/editor/frame.py |   74 -
 .../pywin/framework/editor/template.py        |   60 -
 lib/pythonwin/pywin/framework/editor/vss.py   |  104 -
 lib/pythonwin/pywin/framework/help.py         |  173 -
 lib/pythonwin/pywin/framework/interact.py     |  985 ----
 lib/pythonwin/pywin/framework/intpyapp.py     |  555 --
 lib/pythonwin/pywin/framework/intpydde.py     |   60 -
 .../pywin/framework/mdi_pychecker.py          |  849 ---
 lib/pythonwin/pywin/framework/scriptutils.py  |  688 ---
 lib/pythonwin/pywin/framework/sgrepmdi.py     |  758 ---
 lib/pythonwin/pywin/framework/startup.py      |   80 -
 lib/pythonwin/pywin/framework/stdin.py        |  176 -
 lib/pythonwin/pywin/framework/toolmenu.py     |  284 -
 lib/pythonwin/pywin/framework/window.py       |   14 -
 lib/pythonwin/pywin/framework/winout.py       |  594 --
 lib/pythonwin/pywin/idle/AutoExpand.py        |   95 -
 lib/pythonwin/pywin/idle/AutoIndent.py        |  547 --
 lib/pythonwin/pywin/idle/CallTips.py          |  219 -
 lib/pythonwin/pywin/idle/FormatParagraph.py   |  166 -
 lib/pythonwin/pywin/idle/IdleHistory.py       |   87 -
 lib/pythonwin/pywin/idle/PyParse.py           |  591 --
 lib/pythonwin/pywin/idle/__init__.py          |    1 -
 lib/pythonwin/pywin/mfc/__init__.py           |    0
 lib/pythonwin/pywin/mfc/activex.py            |   86 -
 lib/pythonwin/pywin/mfc/afxres.py             |  501 --
 lib/pythonwin/pywin/mfc/dialog.py             |  278 -
 lib/pythonwin/pywin/mfc/docview.py            |  151 -
 lib/pythonwin/pywin/mfc/object.py             |   66 -
 lib/pythonwin/pywin/mfc/thread.py             |   25 -
 lib/pythonwin/pywin/mfc/window.py             |   50 -
 .../pywin/scintilla/IDLEenvironment.py        |  598 --
 lib/pythonwin/pywin/scintilla/__init__.py     |    1 -
 lib/pythonwin/pywin/scintilla/bindings.py     |  178 -
 lib/pythonwin/pywin/scintilla/config.py       |  365 --
 lib/pythonwin/pywin/scintilla/configui.py     |  292 -
 lib/pythonwin/pywin/scintilla/control.py      |  569 --
 lib/pythonwin/pywin/scintilla/document.py     |  312 -
 lib/pythonwin/pywin/scintilla/find.py         |  510 --
 lib/pythonwin/pywin/scintilla/formatter.py    |  695 ---
 lib/pythonwin/pywin/scintilla/keycodes.py     |  190 -
 lib/pythonwin/pywin/scintilla/scintillacon.py | 2001 -------
 lib/pythonwin/pywin/scintilla/view.py         |  832 ---
 lib/pythonwin/pywin/tools/TraceCollector.py   |   79 -
 lib/pythonwin/pywin/tools/__init__.py         |    1 -
 lib/pythonwin/pywin/tools/browseProjects.py   |  324 --
 lib/pythonwin/pywin/tools/browser.py          |  517 --
 lib/pythonwin/pywin/tools/hierlist.py         |  367 --
 lib/pythonwin/pywin/tools/regedit.py          |  386 --
 lib/pythonwin/pywin/tools/regpy.py            |   81 -
 lib/pythonwin/start_pythonwin.pyw             |   19 -
 lib/pywin32.version.txt                       |    1 -
 lib/tempora/timing.py                         |   13 +-
 lib/typing_extensions.py                      | 2142 ++-----
 lib/win32/Demos/BackupRead_BackupWrite.py     |  121 -
 lib/win32/Demos/BackupSeek_streamheaders.py   |  137 -
 lib/win32/Demos/CopyFileEx.py                 |   57 -
 .../Demos/CreateFileTransacted_MiniVersion.py |  123 -
 lib/win32/Demos/EvtFormatMessage.py           |   83 -
 lib/win32/Demos/EvtSubscribe_pull.py          |   28 -
 lib/win32/Demos/EvtSubscribe_push.py          |   25 -
 lib/win32/Demos/FileSecurityTest.py           |  137 -
 lib/win32/Demos/GetSaveFileName.py            |   43 -
 lib/win32/Demos/NetValidatePasswordPolicy.py  |  127 -
 lib/win32/Demos/OpenEncryptedFileRaw.py       |   67 -
 lib/win32/Demos/RegCreateKeyTransacted.py     |   60 -
 lib/win32/Demos/RegRestoreKey.py              |   71 -
 lib/win32/Demos/SystemParametersInfo.py       |  210 -
 lib/win32/Demos/c_extension/setup.py          |   26 -
 lib/win32/Demos/cerapi.py                     |  254 -
 lib/win32/Demos/dde/ddeclient.py              |   18 -
 lib/win32/Demos/dde/ddeserver.py              |   42 -
 lib/win32/Demos/desktopmanager.py             |  246 -
 lib/win32/Demos/eventLogDemo.py               |  142 -
 lib/win32/Demos/getfilever.py                 |   33 -
 lib/win32/Demos/images/frowny.bmp             |  Bin 3126 -> 0 bytes
 lib/win32/Demos/images/smiley.bmp             |  Bin 3126 -> 0 bytes
 lib/win32/Demos/mmapfile_demo.py              |  102 -
 lib/win32/Demos/pipes/cat.py                  |   17 -
 lib/win32/Demos/pipes/runproc.py              |  114 -
 lib/win32/Demos/print_desktop.py              |  113 -
 lib/win32/Demos/rastest.py                    |  168 -
 .../Demos/security/GetTokenInformation.py     |  110 -
 lib/win32/Demos/security/account_rights.py    |   51 -
 lib/win32/Demos/security/explicit_entries.py  |  171 -
 lib/win32/Demos/security/get_policy_info.py   |   42 -
 lib/win32/Demos/security/list_rights.py       |   37 -
 lib/win32/Demos/security/localized_names.py   |   65 -
 lib/win32/Demos/security/lsaregevent.py       |   14 -
 lib/win32/Demos/security/lsastore.py          |   12 -
 lib/win32/Demos/security/query_information.py |   25 -
 lib/win32/Demos/security/regsave_sa.py        |   61 -
 lib/win32/Demos/security/regsecurity.py       |   36 -
 lib/win32/Demos/security/sa_inherit.py        |    8 -
 lib/win32/Demos/security/security_enums.py    |  336 --
 lib/win32/Demos/security/set_file_audit.py    |  107 -
 lib/win32/Demos/security/set_file_owner.py    |   74 -
 lib/win32/Demos/security/set_policy_info.py   |   28 -
 .../Demos/security/setkernelobjectsecurity.py |  135 -
 .../Demos/security/setnamedsecurityinfo.py    |  131 -
 lib/win32/Demos/security/setsecurityinfo.py   |  132 -
 .../Demos/security/setuserobjectsecurity.py   |  103 -
 lib/win32/Demos/security/sspi/fetch_url.py    |  160 -
 lib/win32/Demos/security/sspi/simple_auth.py  |   72 -
 .../Demos/security/sspi/socket_server.py      |  201 -
 .../Demos/security/sspi/validate_password.py  |   41 -
 .../Demos/service/nativePipeTestService.py    |   63 -
 lib/win32/Demos/service/pipeTestService.py    |  184 -
 .../Demos/service/pipeTestServiceClient.py    |  156 -
 lib/win32/Demos/service/serviceEvents.py      |   98 -
 lib/win32/Demos/timer_demo.py                 |   72 -
 lib/win32/Demos/win32clipboardDemo.py         |  145 -
 lib/win32/Demos/win32clipboard_bitmapdemo.py  |  117 -
 lib/win32/Demos/win32comport_demo.py          |  144 -
 lib/win32/Demos/win32console_demo.py          |  135 -
 lib/win32/Demos/win32cred_demo.py             |   82 -
 lib/win32/Demos/win32fileDemo.py              |   41 -
 lib/win32/Demos/win32gui_demo.py              |  177 -
 lib/win32/Demos/win32gui_devicenotify.py      |  107 -
 lib/win32/Demos/win32gui_dialog.py            |  458 --
 lib/win32/Demos/win32gui_menu.py              |  420 --
 lib/win32/Demos/win32gui_taskbar.py           |  141 -
 lib/win32/Demos/win32netdemo.py               |  274 -
 lib/win32/Demos/win32rcparser_demo.py         |   86 -
 lib/win32/Demos/win32servicedemo.py           |   23 -
 .../Demos/win32ts_logoff_disconnected.py      |   24 -
 lib/win32/Demos/win32wnet/testwnet.py         |  125 -
 lib/win32/Demos/win32wnet/winnetwk.py         |  100 -
 lib/win32/Demos/winprocess.py                 |  230 -
 lib/win32/include/PyWinTypes.h                |  727 ---
 lib/win32/lib/afxres.py                       |  501 --
 lib/win32/lib/commctrl.py                     | 1551 -----
 lib/win32/lib/dbi.py                          |   27 -
 lib/win32/lib/mmsystem.py                     |  954 ----
 lib/win32/lib/netbios.py                      |  304 -
 lib/win32/lib/ntsecuritycon.py                |  731 ---
 lib/win32/lib/pywin32_bootstrap.py            |   29 -
 lib/win32/lib/pywin32_testutil.py             |  327 --
 lib/win32/lib/pywintypes.py                   |  126 -
 lib/win32/lib/rasutil.py                      |   40 -
 lib/win32/lib/regcheck.py                     |  162 -
 lib/win32/lib/regutil.py                      |  397 --
 lib/win32/lib/sspi.py                         |  412 --
 lib/win32/lib/sspicon.py                      |  477 --
 lib/win32/lib/win2kras.py                     |    7 -
 lib/win32/lib/win32con.py                     | 5083 -----------------
 lib/win32/lib/win32cryptcon.py                | 1925 -------
 lib/win32/lib/win32evtlogutil.py              |  229 -
 lib/win32/lib/win32gui_struct.py              |  999 ----
 lib/win32/lib/win32inetcon.py                 | 1086 ----
 lib/win32/lib/win32netcon.py                  |  627 --
 lib/win32/lib/win32pdhquery.py                |  571 --
 lib/win32/lib/win32pdhutil.py                 |  210 -
 lib/win32/lib/win32rcparser.py                |  677 ---
 lib/win32/lib/win32serviceutil.py             | 1071 ----
 lib/win32/lib/win32timezone.py                | 1023 ----
 lib/win32/lib/win32traceutil.py               |   59 -
 lib/win32/lib/win32verstamp.py                |  236 -
 lib/win32/lib/winerror.py                     | 3039 ----------
 lib/win32/lib/winioctlcon.py                  | 1079 ----
 lib/win32/lib/winnt.py                        | 1371 -----
 lib/win32/lib/winperf.py                      |  236 -
 lib/win32/lib/winxptheme.py                   |    7 -
 lib/win32/license.txt                         |   30 -
 lib/win32/scripts/ControlService.py           |  594 --
 .../scripts/VersionStamp/BrandProject.py      |   98 -
 lib/win32/scripts/VersionStamp/bulkstamp.py   |  149 -
 lib/win32/scripts/VersionStamp/vssutil.py     |  204 -
 lib/win32/scripts/backupEventLog.py           |   46 -
 lib/win32/scripts/ce/pysynch.py               |  290 -
 lib/win32/scripts/killProcName.py             |   62 -
 lib/win32/scripts/rasutil.py                  |   97 -
 lib/win32/scripts/regsetup.py                 |  612 --
 lib/win32/scripts/setup_d.py                  |  110 -
 lib/win32/test/handles.py                     |  171 -
 lib/win32/test/test_clipboard.py              |  127 -
 lib/win32/test/test_exceptions.py             |  223 -
 lib/win32/test/test_odbc.py                   |  267 -
 lib/win32/test/test_pywintypes.py             |  116 -
 lib/win32/test/test_security.py               |  166 -
 lib/win32/test/test_sspi.py                   |  231 -
 lib/win32/test/test_win32api.py               |  268 -
 lib/win32/test/test_win32crypt.py             |  129 -
 lib/win32/test/test_win32event.py             |  119 -
 lib/win32/test/test_win32file.py              | 1085 ----
 lib/win32/test/test_win32gui.py               |   65 -
 lib/win32/test/test_win32guistruct.py         |  330 --
 lib/win32/test/test_win32inet.py              |   93 -
 lib/win32/test/test_win32net.py               |   24 -
 lib/win32/test/test_win32pipe.py              |  153 -
 lib/win32/test/test_win32print.py             |   24 -
 lib/win32/test/test_win32profile.py           |   18 -
 lib/win32/test/test_win32rcparser.py          |   70 -
 lib/win32/test/test_win32timezone.py          |   27 -
 lib/win32/test/test_win32trace.py             |  369 --
 lib/win32/test/test_win32wnet.py              |  175 -
 lib/win32/test/testall.py                     |  230 -
 lib/win32/test/win32rcparser/python.bmp       |  Bin 778 -> 0 bytes
 lib/win32/test/win32rcparser/python.ico       |  Bin 766 -> 0 bytes
 lib/win32/test/win32rcparser/test.h           |   46 -
 lib/win32/test/win32rcparser/test.rc          |  216 -
 lib/win32com/HTML/GeneratedSupport.html       |  104 -
 lib/win32com/HTML/PythonCOM.html              |   90 -
 lib/win32com/HTML/QuickStartClientCom.html    |   82 -
 lib/win32com/HTML/QuickStartServerCom.html    |  195 -
 lib/win32com/HTML/docindex.html               |   22 -
 lib/win32com/HTML/image/BTN_HomePage.gif      |  Bin 211 -> 0 bytes
 lib/win32com/HTML/image/BTN_ManualTop.gif     |  Bin 215 -> 0 bytes
 lib/win32com/HTML/image/BTN_NextPage.gif      |  Bin 218 -> 0 bytes
 lib/win32com/HTML/image/BTN_PrevPage.gif      |  Bin 216 -> 0 bytes
 lib/win32com/HTML/image/blank.gif             |  Bin 864 -> 0 bytes
 lib/win32com/HTML/image/pycom_blowing.gif     |  Bin 20926 -> 0 bytes
 lib/win32com/HTML/image/pythoncom.gif         |  Bin 5767 -> 0 bytes
 lib/win32com/HTML/image/www_icon.gif          |  Bin 275 -> 0 bytes
 lib/win32com/HTML/index.html                  |   31 -
 lib/win32com/HTML/misc.html                   |   18 -
 lib/win32com/HTML/package.html                |   37 -
 lib/win32com/HTML/variant.html                |  162 -
 lib/win32com/License.txt                      |   30 -
 lib/win32com/__init__.py                      |  132 -
 lib/win32com/client/CLSIDToClass.py           |   57 -
 lib/win32com/client/__init__.py               |  714 ---
 lib/win32com/client/build.py                  |  789 ---
 lib/win32com/client/combrowse.py              |  619 --
 lib/win32com/client/connect.py                |   48 -
 lib/win32com/client/dynamic.py                |  708 ---
 lib/win32com/client/gencache.py               |  799 ---
 lib/win32com/client/genpy.py                  | 1411 -----
 lib/win32com/client/makepy.py                 |  459 --
 lib/win32com/client/selecttlb.py              |  183 -
 lib/win32com/client/tlbrowse.py               |  279 -
 lib/win32com/client/util.py                   |  102 -
 lib/win32com/demos/__init__.py                |    0
 lib/win32com/demos/connect.py                 |  100 -
 lib/win32com/demos/dump_clipboard.py          |   74 -
 lib/win32com/demos/eventsApartmentThreaded.py |   98 -
 lib/win32com/demos/eventsFreeThreaded.py      |   92 -
 lib/win32com/demos/excelAddin.py              |  170 -
 lib/win32com/demos/excelRTDServer.py          |  434 --
 lib/win32com/demos/iebutton.py                |  217 -
 lib/win32com/demos/ietoolbar.py               |  376 --
 lib/win32com/demos/outlookAddin.py            |  138 -
 lib/win32com/demos/trybag.py                  |   77 -
 lib/win32com/include/PythonCOM.h              |  766 ---
 lib/win32com/include/PythonCOMRegister.h      |   84 -
 lib/win32com/include/PythonCOMServer.h        |  176 -
 lib/win32com/makegw/__init__.py               |    1 -
 lib/win32com/makegw/makegw.py                 |  560 --
 lib/win32com/makegw/makegwenum.py             |  331 --
 lib/win32com/makegw/makegwparse.py            | 1008 ----
 lib/win32com/olectl.py                        |   70 -
 lib/win32com/readme.html                      |   87 -
 lib/win32com/server/__init__.py               |    1 -
 lib/win32com/server/connect.py                |   84 -
 lib/win32com/server/dispatcher.py             |  291 -
 lib/win32com/server/exception.py              |  105 -
 lib/win32com/server/factory.py                |   26 -
 lib/win32com/server/localserver.py            |   53 -
 lib/win32com/server/policy.py                 |  829 ---
 lib/win32com/server/register.py               |  672 ---
 lib/win32com/server/util.py                   |  229 -
 lib/win32com/servers/PythonTools.py           |   47 -
 lib/win32com/servers/__init__.py              |    0
 lib/win32com/servers/dictionary.py            |  137 -
 lib/win32com/servers/interp.py                |   55 -
 lib/win32com/servers/perfmon.py               |   34 -
 lib/win32com/servers/test_pycomtest.py        |  182 -
 lib/win32com/storagecon.py                    |  142 -
 lib/win32com/test/GenTestScripts.py           |   95 -
 lib/win32com/test/Testpys.sct                 |   64 -
 lib/win32com/test/__init__.py                 |    1 -
 lib/win32com/test/daodump.py                  |   90 -
 lib/win32com/test/errorSemantics.py           |  259 -
 lib/win32com/test/pippo.idl                   |   66 -
 lib/win32com/test/pippo_server.py             |   97 -
 lib/win32com/test/policySemantics.py          |  116 -
 lib/win32com/test/readme.txt                  |   18 -
 lib/win32com/test/testADOEvents.py            |  100 -
 lib/win32com/test/testAXScript.py             |   43 -
 lib/win32com/test/testAccess.py               |  187 -
 lib/win32com/test/testArrays.py               |   99 -
 lib/win32com/test/testClipboard.py            |  170 -
 lib/win32com/test/testCollections.py          |  166 -
 lib/win32com/test/testConversionErrors.py     |   39 -
 lib/win32com/test/testDCOM.py                 |   50 -
 lib/win32com/test/testDates.py                |   74 -
 lib/win32com/test/testDictionary.py           |   99 -
 lib/win32com/test/testDictionary.vbs          |   26 -
 lib/win32com/test/testDynamic.py              |   89 -
 lib/win32com/test/testExchange.py             |  126 -
 lib/win32com/test/testExplorer.py             |  145 -
 lib/win32com/test/testGIT.py                  |  145 -
 lib/win32com/test/testGatewayAddresses.py     |  149 -
 lib/win32com/test/testInterp.vbs              |   12 -
 lib/win32com/test/testIterators.py            |  140 -
 lib/win32com/test/testMSOffice.py             |  209 -
 lib/win32com/test/testMSOfficeEvents.py       |  136 -
 lib/win32com/test/testMarshal.py              |  160 -
 lib/win32com/test/testNetscape.py             |   27 -
 lib/win32com/test/testPersist.py              |  231 -
 lib/win32com/test/testPippo.py                |   82 -
 lib/win32com/test/testPyComTest.py            |  835 ---
 lib/win32com/test/testPyScriptlet.js          |   33 -
 lib/win32com/test/testROT.py                  |   29 -
 lib/win32com/test/testServers.py              |   52 -
 lib/win32com/test/testShell.py                |  281 -
 lib/win32com/test/testStorage.py              |   88 -
 lib/win32com/test/testStreams.py              |  148 -
 lib/win32com/test/testWMI.py                  |   18 -
 lib/win32com/test/testall.py                  |  321 --
 lib/win32com/test/testmakepy.py               |   55 -
 lib/win32com/test/testvb.py                   |  594 --
 lib/win32com/test/testvbscript_regexp.py      |   40 -
 lib/win32com/test/testxslt.js                 |   12 -
 lib/win32com/test/testxslt.py                 |   34 -
 lib/win32com/test/testxslt.xsl                |   55 -
 lib/win32com/test/util.py                     |  265 -
 lib/win32com/universal.py                     |  226 -
 lib/win32com/util.py                          |   34 -
 lib/win32comext/adsi/__init__.py              |  122 -
 lib/win32comext/adsi/adsi.pyd                 |  Bin 97792 -> 0 bytes
 lib/win32comext/adsi/adsicon.py               |  340 --
 lib/win32comext/adsi/demos/objectPicker.py    |   68 -
 lib/win32comext/adsi/demos/scp.py             |  565 --
 lib/win32comext/adsi/demos/search.py          |  152 -
 lib/win32comext/adsi/demos/test.py            |  273 -
 lib/win32comext/authorization/__init__.py     |    6 -
 .../authorization/authorization.pyd           |  Bin 29696 -> 0 bytes
 .../authorization/demos/EditSecurity.py       |  255 -
 .../demos/EditServiceSecurity.py              |  242 -
 lib/win32comext/axcontrol/__init__.py         |    4 -
 lib/win32comext/axcontrol/axcontrol.pyd       |  Bin 143872 -> 0 bytes
 lib/win32comext/axdebug/__init__.py           |    4 -
 lib/win32comext/axdebug/adb.py                |  480 --
 lib/win32comext/axdebug/axdebug.pyd           |  Bin 285184 -> 0 bytes
 lib/win32comext/axdebug/codecontainer.py      |  278 -
 lib/win32comext/axdebug/contexts.py           |   62 -
 lib/win32comext/axdebug/debugger.py           |  250 -
 lib/win32comext/axdebug/documents.py          |  140 -
 lib/win32comext/axdebug/dump.py               |   61 -
 lib/win32comext/axdebug/expressions.py        |  214 -
 lib/win32comext/axdebug/gateways.py           |  583 --
 lib/win32comext/axdebug/stackframe.py         |  179 -
 lib/win32comext/axdebug/util.py               |  141 -
 .../Demos/client/asp/CreateObject.asp         |   19 -
 .../axscript/Demos/client/asp/caps.asp        |   52 -
 .../Demos/client/asp/interrupt/test.asp       |    4 -
 .../Demos/client/asp/interrupt/test.html      |   10 -
 .../Demos/client/asp/interrupt/test1.asp      |    6 -
 .../Demos/client/asp/interrupt/test1.html     |   11 -
 .../axscript/Demos/client/asp/tut1.asp        |   11 -
 .../axscript/Demos/client/ie/MarqueeText1.htm |   25 -
 .../axscript/Demos/client/ie/calc.htm         |  116 -
 .../axscript/Demos/client/ie/dbgtest.htm      |   16 -
 .../axscript/Demos/client/ie/demo.htm         |   26 -
 .../axscript/Demos/client/ie/demo_check.htm   |   42 -
 .../axscript/Demos/client/ie/demo_intro.htm   |   38 -
 .../axscript/Demos/client/ie/demo_menu.htm    |   16 -
 .../axscript/Demos/client/ie/docwrite.htm     |   25 -
 .../axscript/Demos/client/ie/foo2.htm         |  105 -
 .../axscript/Demos/client/ie/form.htm         |   25 -
 .../axscript/Demos/client/ie/marqueeDemo.htm  |   60 -
 .../axscript/Demos/client/ie/mousetrack.htm   |   83 -
 .../Demos/client/ie/pycom_blowing.gif         |  Bin 20926 -> 0 bytes
 .../axscript/Demos/client/wsh/blank.pys       |    0
 .../axscript/Demos/client/wsh/excel.pys       |   34 -
 .../axscript/Demos/client/wsh/registry.pys    |   45 -
 .../axscript/Demos/client/wsh/test.pys        |   15 -
 lib/win32comext/axscript/__init__.py          |    4 -
 lib/win32comext/axscript/asputil.py           |   13 -
 lib/win32comext/axscript/axscript.pyd         |  Bin 93184 -> 0 bytes
 lib/win32comext/axscript/client/__init__.py   |    1 -
 lib/win32comext/axscript/client/debug.py      |  240 -
 lib/win32comext/axscript/client/error.py      |  273 -
 lib/win32comext/axscript/client/framework.py  | 1270 ----
 lib/win32comext/axscript/client/pydumper.py   |   77 -
 lib/win32comext/axscript/client/pyscript.py   |  443 --
 .../axscript/client/pyscript_rexec.py         |   49 -
 .../axscript/client/scriptdispatch.py         |  115 -
 lib/win32comext/axscript/server/__init__.py   |    0
 lib/win32comext/axscript/server/axsite.py     |  145 -
 lib/win32comext/axscript/server/error.py      |   16 -
 lib/win32comext/axscript/test/debugTest.pys   |   17 -
 lib/win32comext/axscript/test/debugTest.vbs   |    7 -
 lib/win32comext/axscript/test/leakTest.py     |  188 -
 lib/win32comext/axscript/test/testHost.py     |  257 -
 lib/win32comext/axscript/test/testHost4Dbg.py |   88 -
 lib/win32comext/bits/__init__.py              |    6 -
 lib/win32comext/bits/bits.pyd                 |  Bin 62976 -> 0 bytes
 lib/win32comext/bits/test/show_all_jobs.py    |   52 -
 lib/win32comext/bits/test/test_bits.py        |  121 -
 lib/win32comext/directsound/__init__.py       |    4 -
 lib/win32comext/directsound/directsound.pyd   |  Bin 76288 -> 0 bytes
 lib/win32comext/directsound/test/__init__.py  |    1 -
 lib/win32comext/directsound/test/ds_record.py |   60 -
 lib/win32comext/directsound/test/ds_test.py   |  402 --
 lib/win32comext/ifilter/__init__.py           |    1 -
 lib/win32comext/ifilter/demo/filterDemo.py    |  300 -
 lib/win32comext/ifilter/ifilter.pyd           |  Bin 30720 -> 0 bytes
 lib/win32comext/ifilter/ifiltercon.py         |  110 -
 lib/win32comext/internet/__init__.py          |    4 -
 lib/win32comext/internet/inetcon.py           |  261 -
 lib/win32comext/internet/internet.pyd         |  Bin 93696 -> 0 bytes
 lib/win32comext/mapi/__init__.py              |   27 -
 lib/win32comext/mapi/demos/mapisend.py        |   98 -
 lib/win32comext/mapi/emsabtags.py             |  874 ---
 lib/win32comext/mapi/exchange.pyd             |  Bin 88064 -> 0 bytes
 lib/win32comext/mapi/mapi.pyd                 |  Bin 196608 -> 0 bytes
 lib/win32comext/mapi/mapitags.py              | 1025 ----
 lib/win32comext/mapi/mapiutil.py              |  217 -
 lib/win32comext/propsys/__init__.py           |    1 -
 lib/win32comext/propsys/propsys.pyd           |  Bin 138752 -> 0 bytes
 lib/win32comext/propsys/pscon.py              |  838 ---
 lib/win32comext/propsys/test/testpropsys.py   |    5 -
 lib/win32comext/shell/__init__.py             |    4 -
 lib/win32comext/shell/demos/IActiveDesktop.py |   83 -
 .../shell/demos/IFileOperationProgressSink.py |  181 -
 .../shell/demos/IShellLinkDataList.py         |   67 -
 .../shell/demos/ITransferAdviseSink.py        |  107 -
 .../shell/demos/IUniformResourceLocator.py    |   56 -
 .../shell/demos/browse_for_folder.py          |   45 -
 lib/win32comext/shell/demos/create_link.py    |   73 -
 lib/win32comext/shell/demos/dump_link.py      |   58 -
 .../shell/demos/explorer_browser.py           |  143 -
 .../shell/demos/servers/column_provider.py    |  126 -
 .../shell/demos/servers/context_menu.py       |  122 -
 .../shell/demos/servers/copy_hook.py          |   84 -
 .../shell/demos/servers/empty_volume_cache.py |  188 -
 .../shell/demos/servers/folder_view.py        |  862 ---
 .../shell/demos/servers/icon_handler.py       |   82 -
 .../shell/demos/servers/shell_view.py         |  972 ----
 lib/win32comext/shell/demos/shellexecuteex.py |   19 -
 lib/win32comext/shell/demos/viewstate.py      |   68 -
 .../shell/demos/walk_shell_folders.py         |   24 -
 lib/win32comext/shell/shell.pyd               |  Bin 528896 -> 0 bytes
 lib/win32comext/shell/shellcon.py             | 1597 ------
 .../shell/test/testSHFileOperation.py         |   75 -
 lib/win32comext/shell/test/testShellFolder.py |   21 -
 lib/win32comext/shell/test/testShellItem.py   |   69 -
 lib/win32comext/taskscheduler/__init__.py     |    6 -
 .../taskscheduler/taskscheduler.pyd           |  Bin 53248 -> 0 bytes
 .../taskscheduler/test/test_addtask.py        |   66 -
 .../taskscheduler/test/test_addtask_1.py      |   69 -
 .../taskscheduler/test/test_addtask_2.py      |   51 -
 .../taskscheduler/test/test_localsystem.py    |    3 -
 lib/zc/lockfile/__init__.py                   |   23 +-
 lib/zc/lockfile/tests.py                      |   46 +-
 requirements.txt                              |    2 +-
 673 files changed, 11579 insertions(+), 159846 deletions(-)
 delete mode 100644 lib/PyWin32.chm
 delete mode 100644 lib/adodbapi/__init__.py
 delete mode 100644 lib/adodbapi/ado_consts.py
 delete mode 100644 lib/adodbapi/adodbapi.py
 delete mode 100644 lib/adodbapi/apibase.py
 delete mode 100644 lib/adodbapi/examples/db_print.py
 delete mode 100644 lib/adodbapi/examples/db_table_names.py
 delete mode 100644 lib/adodbapi/examples/xls_read.py
 delete mode 100644 lib/adodbapi/examples/xls_write.py
 delete mode 100644 lib/adodbapi/is64bit.py
 delete mode 100644 lib/adodbapi/license.txt
 delete mode 100644 lib/adodbapi/process_connect_string.py
 delete mode 100644 lib/adodbapi/readme.txt
 delete mode 100644 lib/adodbapi/remote.py
 delete mode 100644 lib/adodbapi/schema_table.py
 delete mode 100644 lib/adodbapi/setup.py
 delete mode 100644 lib/adodbapi/test/adodbapitest.py
 delete mode 100644 lib/adodbapi/test/adodbapitestconfig.py
 delete mode 100644 lib/adodbapi/test/dbapi20.py
 delete mode 100644 lib/adodbapi/test/is64bit.py
 delete mode 100644 lib/adodbapi/test/setuptestframework.py
 delete mode 100644 lib/adodbapi/test/test_adodbapi_dbapi20.py
 delete mode 100644 lib/adodbapi/test/tryconnection.py
 delete mode 100644 lib/annotated_types/__init__.py
 delete mode 100644 lib/annotated_types/py.typed
 delete mode 100644 lib/annotated_types/test_cases.py
 delete mode 100644 lib/inflect/compat/pydantic.py
 delete mode 100644 lib/inflect/compat/pydantic1.py
 delete mode 100644 lib/isapi/README.txt
 delete mode 100644 lib/isapi/__init__.py
 delete mode 100644 lib/isapi/doc/isapi.html
 delete mode 100644 lib/isapi/install.py
 delete mode 100644 lib/isapi/isapicon.py
 delete mode 100644 lib/isapi/samples/README.txt
 delete mode 100644 lib/isapi/samples/advanced.py
 delete mode 100644 lib/isapi/samples/redirector.py
 delete mode 100644 lib/isapi/samples/redirector_asynch.py
 delete mode 100644 lib/isapi/samples/redirector_with_filter.py
 delete mode 100644 lib/isapi/samples/test.py
 delete mode 100644 lib/isapi/simple.py
 delete mode 100644 lib/isapi/test/README.txt
 delete mode 100644 lib/isapi/test/extension_simple.py
 delete mode 100644 lib/isapi/threaded_extension.py
 rename lib/{inflect/compat => jaraco/classes}/__init__.py (100%)
 rename lib/jaraco/{collections/__init__.py => collections.py} (88%)
 delete mode 100644 lib/jaraco/collections/py.typed
 rename lib/jaraco/{functools/__init__.py => functools.py} (84%)
 delete mode 100644 lib/jaraco/functools/__init__.pyi
 delete mode 100644 lib/jaraco/functools/py.typed
 delete mode 100644 lib/jaraco/text/strip-prefix.py
 rename lib/pydantic/{v1 => }/_hypothesis_plugin.py (97%)
 delete mode 100644 lib/pydantic/_internal/__init__.py
 delete mode 100644 lib/pydantic/_internal/_config.py
 delete mode 100644 lib/pydantic/_internal/_core_metadata.py
 delete mode 100644 lib/pydantic/_internal/_core_utils.py
 delete mode 100644 lib/pydantic/_internal/_dataclasses.py
 delete mode 100644 lib/pydantic/_internal/_decorators.py
 delete mode 100644 lib/pydantic/_internal/_decorators_v1.py
 delete mode 100644 lib/pydantic/_internal/_discriminated_union.py
 delete mode 100644 lib/pydantic/_internal/_fields.py
 delete mode 100644 lib/pydantic/_internal/_forward_ref.py
 delete mode 100644 lib/pydantic/_internal/_generate_schema.py
 delete mode 100644 lib/pydantic/_internal/_generics.py
 delete mode 100644 lib/pydantic/_internal/_git.py
 delete mode 100644 lib/pydantic/_internal/_internal_dataclass.py
 delete mode 100644 lib/pydantic/_internal/_known_annotated_metadata.py
 delete mode 100644 lib/pydantic/_internal/_mock_val_ser.py
 delete mode 100644 lib/pydantic/_internal/_model_construction.py
 delete mode 100644 lib/pydantic/_internal/_repr.py
 delete mode 100644 lib/pydantic/_internal/_schema_generation_shared.py
 delete mode 100644 lib/pydantic/_internal/_signature.py
 delete mode 100644 lib/pydantic/_internal/_std_types_schema.py
 delete mode 100644 lib/pydantic/_internal/_typing_extra.py
 delete mode 100644 lib/pydantic/_internal/_utils.py
 delete mode 100644 lib/pydantic/_internal/_validate_call.py
 delete mode 100644 lib/pydantic/_internal/_validators.py
 delete mode 100644 lib/pydantic/_migration.py
 delete mode 100644 lib/pydantic/alias_generators.py
 delete mode 100644 lib/pydantic/aliases.py
 delete mode 100644 lib/pydantic/annotated_handlers.py
 rename lib/pydantic/{v1 => }/annotated_types.py (100%)
 delete mode 100644 lib/pydantic/deprecated/__init__.py
 delete mode 100644 lib/pydantic/deprecated/class_validators.py
 delete mode 100644 lib/pydantic/deprecated/config.py
 delete mode 100644 lib/pydantic/deprecated/copy_internals.py
 delete mode 100644 lib/pydantic/deprecated/decorator.py
 delete mode 100644 lib/pydantic/deprecated/json.py
 delete mode 100644 lib/pydantic/deprecated/parse.py
 delete mode 100644 lib/pydantic/deprecated/tools.py
 delete mode 100644 lib/pydantic/functional_serializers.py
 delete mode 100644 lib/pydantic/functional_validators.py
 delete mode 100644 lib/pydantic/json_schema.py
 delete mode 100644 lib/pydantic/plugin/__init__.py
 delete mode 100644 lib/pydantic/plugin/_loader.py
 delete mode 100644 lib/pydantic/plugin/_schema_validator.py
 delete mode 100644 lib/pydantic/root_model.py
 delete mode 100644 lib/pydantic/type_adapter.py
 delete mode 100644 lib/pydantic/v1/__init__.py
 delete mode 100644 lib/pydantic/v1/class_validators.py
 delete mode 100644 lib/pydantic/v1/color.py
 delete mode 100644 lib/pydantic/v1/config.py
 delete mode 100644 lib/pydantic/v1/dataclasses.py
 delete mode 100644 lib/pydantic/v1/datetime_parse.py
 delete mode 100644 lib/pydantic/v1/decorator.py
 delete mode 100644 lib/pydantic/v1/env_settings.py
 delete mode 100644 lib/pydantic/v1/error_wrappers.py
 delete mode 100644 lib/pydantic/v1/errors.py
 delete mode 100644 lib/pydantic/v1/fields.py
 delete mode 100644 lib/pydantic/v1/generics.py
 delete mode 100644 lib/pydantic/v1/json.py
 delete mode 100644 lib/pydantic/v1/main.py
 delete mode 100644 lib/pydantic/v1/mypy.py
 delete mode 100644 lib/pydantic/v1/networks.py
 delete mode 100644 lib/pydantic/v1/parse.py
 delete mode 100644 lib/pydantic/v1/py.typed
 delete mode 100644 lib/pydantic/v1/schema.py
 delete mode 100644 lib/pydantic/v1/tools.py
 delete mode 100644 lib/pydantic/v1/types.py
 delete mode 100644 lib/pydantic/v1/typing.py
 delete mode 100644 lib/pydantic/v1/utils.py
 delete mode 100644 lib/pydantic/v1/validators.py
 delete mode 100644 lib/pydantic/v1/version.py
 delete mode 100644 lib/pydantic/validate_call_decorator.py
 delete mode 100644 lib/pydantic/warnings.py
 delete mode 100644 lib/pydantic_core/__init__.py
 delete mode 100644 lib/pydantic_core/_pydantic_core.pyi
 delete mode 100644 lib/pydantic_core/core_schema.py
 delete mode 100644 lib/pydantic_core/py.typed
 delete mode 100644 lib/pythoncom.py
 delete mode 100644 lib/pythonwin/license.txt
 delete mode 100644 lib/pythonwin/pywin/Demos/app/basictimerapp.py
 delete mode 100644 lib/pythonwin/pywin/Demos/app/customprint.py
 delete mode 100644 lib/pythonwin/pywin/Demos/app/demoutils.py
 delete mode 100644 lib/pythonwin/pywin/Demos/app/dlgappdemo.py
 delete mode 100644 lib/pythonwin/pywin/Demos/app/dojobapp.py
 delete mode 100644 lib/pythonwin/pywin/Demos/app/helloapp.py
 delete mode 100644 lib/pythonwin/pywin/Demos/cmdserver.py
 delete mode 100644 lib/pythonwin/pywin/Demos/createwin.py
 delete mode 100644 lib/pythonwin/pywin/Demos/demoutils.py
 delete mode 100644 lib/pythonwin/pywin/Demos/dibdemo.py
 delete mode 100644 lib/pythonwin/pywin/Demos/dlgtest.py
 delete mode 100644 lib/pythonwin/pywin/Demos/dyndlg.py
 delete mode 100644 lib/pythonwin/pywin/Demos/fontdemo.py
 delete mode 100644 lib/pythonwin/pywin/Demos/guidemo.py
 delete mode 100644 lib/pythonwin/pywin/Demos/hiertest.py
 delete mode 100644 lib/pythonwin/pywin/Demos/menutest.py
 delete mode 100644 lib/pythonwin/pywin/Demos/objdoc.py
 delete mode 100644 lib/pythonwin/pywin/Demos/ocx/__init__.py
 delete mode 100644 lib/pythonwin/pywin/Demos/ocx/demoutils.py
 delete mode 100644 lib/pythonwin/pywin/Demos/ocx/flash.py
 delete mode 100644 lib/pythonwin/pywin/Demos/ocx/msoffice.py
 delete mode 100644 lib/pythonwin/pywin/Demos/ocx/ocxserialtest.py
 delete mode 100644 lib/pythonwin/pywin/Demos/ocx/ocxtest.py
 delete mode 100644 lib/pythonwin/pywin/Demos/ocx/webbrowser.py
 delete mode 100644 lib/pythonwin/pywin/Demos/openGLDemo.py
 delete mode 100644 lib/pythonwin/pywin/Demos/progressbar.py
 delete mode 100644 lib/pythonwin/pywin/Demos/sliderdemo.py
 delete mode 100644 lib/pythonwin/pywin/Demos/splittst.py
 delete mode 100644 lib/pythonwin/pywin/Demos/threadedgui.py
 delete mode 100644 lib/pythonwin/pywin/Demos/toolbar.py
 delete mode 100644 lib/pythonwin/pywin/IDLE.cfg
 delete mode 100644 lib/pythonwin/pywin/__init__.py
 delete mode 100644 lib/pythonwin/pywin/default.cfg
 delete mode 100644 lib/pythonwin/pywin/dialogs/__init__.py
 delete mode 100644 lib/pythonwin/pywin/dialogs/ideoptions.py
 delete mode 100644 lib/pythonwin/pywin/dialogs/list.py
 delete mode 100644 lib/pythonwin/pywin/dialogs/login.py
 delete mode 100644 lib/pythonwin/pywin/dialogs/status.py
 delete mode 100644 lib/pythonwin/pywin/docking/DockingBar.py
 delete mode 100644 lib/pythonwin/pywin/docking/__init__.py
 delete mode 100644 lib/pythonwin/pywin/framework/__init__.py
 delete mode 100644 lib/pythonwin/pywin/framework/app.py
 delete mode 100644 lib/pythonwin/pywin/framework/bitmap.py
 delete mode 100644 lib/pythonwin/pywin/framework/cmdline.py
 delete mode 100644 lib/pythonwin/pywin/framework/dbgcommands.py
 delete mode 100644 lib/pythonwin/pywin/framework/dlgappcore.py
 delete mode 100644 lib/pythonwin/pywin/framework/editor/ModuleBrowser.py
 delete mode 100644 lib/pythonwin/pywin/framework/editor/__init__.py
 delete mode 100644 lib/pythonwin/pywin/framework/editor/color/__init__.py
 delete mode 100644 lib/pythonwin/pywin/framework/editor/color/coloreditor.py
 delete mode 100644 lib/pythonwin/pywin/framework/editor/configui.py
 delete mode 100644 lib/pythonwin/pywin/framework/editor/document.py
 delete mode 100644 lib/pythonwin/pywin/framework/editor/editor.py
 delete mode 100644 lib/pythonwin/pywin/framework/editor/frame.py
 delete mode 100644 lib/pythonwin/pywin/framework/editor/template.py
 delete mode 100644 lib/pythonwin/pywin/framework/editor/vss.py
 delete mode 100644 lib/pythonwin/pywin/framework/help.py
 delete mode 100644 lib/pythonwin/pywin/framework/interact.py
 delete mode 100644 lib/pythonwin/pywin/framework/intpyapp.py
 delete mode 100644 lib/pythonwin/pywin/framework/intpydde.py
 delete mode 100644 lib/pythonwin/pywin/framework/mdi_pychecker.py
 delete mode 100644 lib/pythonwin/pywin/framework/scriptutils.py
 delete mode 100644 lib/pythonwin/pywin/framework/sgrepmdi.py
 delete mode 100644 lib/pythonwin/pywin/framework/startup.py
 delete mode 100644 lib/pythonwin/pywin/framework/stdin.py
 delete mode 100644 lib/pythonwin/pywin/framework/toolmenu.py
 delete mode 100644 lib/pythonwin/pywin/framework/window.py
 delete mode 100644 lib/pythonwin/pywin/framework/winout.py
 delete mode 100644 lib/pythonwin/pywin/idle/AutoExpand.py
 delete mode 100644 lib/pythonwin/pywin/idle/AutoIndent.py
 delete mode 100644 lib/pythonwin/pywin/idle/CallTips.py
 delete mode 100644 lib/pythonwin/pywin/idle/FormatParagraph.py
 delete mode 100644 lib/pythonwin/pywin/idle/IdleHistory.py
 delete mode 100644 lib/pythonwin/pywin/idle/PyParse.py
 delete mode 100644 lib/pythonwin/pywin/idle/__init__.py
 delete mode 100644 lib/pythonwin/pywin/mfc/__init__.py
 delete mode 100644 lib/pythonwin/pywin/mfc/activex.py
 delete mode 100644 lib/pythonwin/pywin/mfc/afxres.py
 delete mode 100644 lib/pythonwin/pywin/mfc/dialog.py
 delete mode 100644 lib/pythonwin/pywin/mfc/docview.py
 delete mode 100644 lib/pythonwin/pywin/mfc/object.py
 delete mode 100644 lib/pythonwin/pywin/mfc/thread.py
 delete mode 100644 lib/pythonwin/pywin/mfc/window.py
 delete mode 100644 lib/pythonwin/pywin/scintilla/IDLEenvironment.py
 delete mode 100644 lib/pythonwin/pywin/scintilla/__init__.py
 delete mode 100644 lib/pythonwin/pywin/scintilla/bindings.py
 delete mode 100644 lib/pythonwin/pywin/scintilla/config.py
 delete mode 100644 lib/pythonwin/pywin/scintilla/configui.py
 delete mode 100644 lib/pythonwin/pywin/scintilla/control.py
 delete mode 100644 lib/pythonwin/pywin/scintilla/document.py
 delete mode 100644 lib/pythonwin/pywin/scintilla/find.py
 delete mode 100644 lib/pythonwin/pywin/scintilla/formatter.py
 delete mode 100644 lib/pythonwin/pywin/scintilla/keycodes.py
 delete mode 100644 lib/pythonwin/pywin/scintilla/scintillacon.py
 delete mode 100644 lib/pythonwin/pywin/scintilla/view.py
 delete mode 100644 lib/pythonwin/pywin/tools/TraceCollector.py
 delete mode 100644 lib/pythonwin/pywin/tools/__init__.py
 delete mode 100644 lib/pythonwin/pywin/tools/browseProjects.py
 delete mode 100644 lib/pythonwin/pywin/tools/browser.py
 delete mode 100644 lib/pythonwin/pywin/tools/hierlist.py
 delete mode 100644 lib/pythonwin/pywin/tools/regedit.py
 delete mode 100644 lib/pythonwin/pywin/tools/regpy.py
 delete mode 100644 lib/pythonwin/start_pythonwin.pyw
 delete mode 100644 lib/pywin32.version.txt
 delete mode 100644 lib/win32/Demos/BackupRead_BackupWrite.py
 delete mode 100644 lib/win32/Demos/BackupSeek_streamheaders.py
 delete mode 100644 lib/win32/Demos/CopyFileEx.py
 delete mode 100644 lib/win32/Demos/CreateFileTransacted_MiniVersion.py
 delete mode 100644 lib/win32/Demos/EvtFormatMessage.py
 delete mode 100644 lib/win32/Demos/EvtSubscribe_pull.py
 delete mode 100644 lib/win32/Demos/EvtSubscribe_push.py
 delete mode 100644 lib/win32/Demos/FileSecurityTest.py
 delete mode 100644 lib/win32/Demos/GetSaveFileName.py
 delete mode 100644 lib/win32/Demos/NetValidatePasswordPolicy.py
 delete mode 100644 lib/win32/Demos/OpenEncryptedFileRaw.py
 delete mode 100644 lib/win32/Demos/RegCreateKeyTransacted.py
 delete mode 100644 lib/win32/Demos/RegRestoreKey.py
 delete mode 100644 lib/win32/Demos/SystemParametersInfo.py
 delete mode 100644 lib/win32/Demos/c_extension/setup.py
 delete mode 100644 lib/win32/Demos/cerapi.py
 delete mode 100644 lib/win32/Demos/dde/ddeclient.py
 delete mode 100644 lib/win32/Demos/dde/ddeserver.py
 delete mode 100644 lib/win32/Demos/desktopmanager.py
 delete mode 100644 lib/win32/Demos/eventLogDemo.py
 delete mode 100644 lib/win32/Demos/getfilever.py
 delete mode 100644 lib/win32/Demos/images/frowny.bmp
 delete mode 100644 lib/win32/Demos/images/smiley.bmp
 delete mode 100644 lib/win32/Demos/mmapfile_demo.py
 delete mode 100644 lib/win32/Demos/pipes/cat.py
 delete mode 100644 lib/win32/Demos/pipes/runproc.py
 delete mode 100644 lib/win32/Demos/print_desktop.py
 delete mode 100644 lib/win32/Demos/rastest.py
 delete mode 100644 lib/win32/Demos/security/GetTokenInformation.py
 delete mode 100644 lib/win32/Demos/security/account_rights.py
 delete mode 100644 lib/win32/Demos/security/explicit_entries.py
 delete mode 100644 lib/win32/Demos/security/get_policy_info.py
 delete mode 100644 lib/win32/Demos/security/list_rights.py
 delete mode 100644 lib/win32/Demos/security/localized_names.py
 delete mode 100644 lib/win32/Demos/security/lsaregevent.py
 delete mode 100644 lib/win32/Demos/security/lsastore.py
 delete mode 100644 lib/win32/Demos/security/query_information.py
 delete mode 100644 lib/win32/Demos/security/regsave_sa.py
 delete mode 100644 lib/win32/Demos/security/regsecurity.py
 delete mode 100644 lib/win32/Demos/security/sa_inherit.py
 delete mode 100644 lib/win32/Demos/security/security_enums.py
 delete mode 100644 lib/win32/Demos/security/set_file_audit.py
 delete mode 100644 lib/win32/Demos/security/set_file_owner.py
 delete mode 100644 lib/win32/Demos/security/set_policy_info.py
 delete mode 100644 lib/win32/Demos/security/setkernelobjectsecurity.py
 delete mode 100644 lib/win32/Demos/security/setnamedsecurityinfo.py
 delete mode 100644 lib/win32/Demos/security/setsecurityinfo.py
 delete mode 100644 lib/win32/Demos/security/setuserobjectsecurity.py
 delete mode 100644 lib/win32/Demos/security/sspi/fetch_url.py
 delete mode 100644 lib/win32/Demos/security/sspi/simple_auth.py
 delete mode 100644 lib/win32/Demos/security/sspi/socket_server.py
 delete mode 100644 lib/win32/Demos/security/sspi/validate_password.py
 delete mode 100644 lib/win32/Demos/service/nativePipeTestService.py
 delete mode 100644 lib/win32/Demos/service/pipeTestService.py
 delete mode 100644 lib/win32/Demos/service/pipeTestServiceClient.py
 delete mode 100644 lib/win32/Demos/service/serviceEvents.py
 delete mode 100644 lib/win32/Demos/timer_demo.py
 delete mode 100644 lib/win32/Demos/win32clipboardDemo.py
 delete mode 100644 lib/win32/Demos/win32clipboard_bitmapdemo.py
 delete mode 100644 lib/win32/Demos/win32comport_demo.py
 delete mode 100644 lib/win32/Demos/win32console_demo.py
 delete mode 100644 lib/win32/Demos/win32cred_demo.py
 delete mode 100644 lib/win32/Demos/win32fileDemo.py
 delete mode 100644 lib/win32/Demos/win32gui_demo.py
 delete mode 100644 lib/win32/Demos/win32gui_devicenotify.py
 delete mode 100644 lib/win32/Demos/win32gui_dialog.py
 delete mode 100644 lib/win32/Demos/win32gui_menu.py
 delete mode 100644 lib/win32/Demos/win32gui_taskbar.py
 delete mode 100644 lib/win32/Demos/win32netdemo.py
 delete mode 100644 lib/win32/Demos/win32rcparser_demo.py
 delete mode 100644 lib/win32/Demos/win32servicedemo.py
 delete mode 100644 lib/win32/Demos/win32ts_logoff_disconnected.py
 delete mode 100644 lib/win32/Demos/win32wnet/testwnet.py
 delete mode 100644 lib/win32/Demos/win32wnet/winnetwk.py
 delete mode 100644 lib/win32/Demos/winprocess.py
 delete mode 100644 lib/win32/include/PyWinTypes.h
 delete mode 100644 lib/win32/lib/afxres.py
 delete mode 100644 lib/win32/lib/commctrl.py
 delete mode 100644 lib/win32/lib/dbi.py
 delete mode 100644 lib/win32/lib/mmsystem.py
 delete mode 100644 lib/win32/lib/netbios.py
 delete mode 100644 lib/win32/lib/ntsecuritycon.py
 delete mode 100644 lib/win32/lib/pywin32_bootstrap.py
 delete mode 100644 lib/win32/lib/pywin32_testutil.py
 delete mode 100644 lib/win32/lib/pywintypes.py
 delete mode 100644 lib/win32/lib/rasutil.py
 delete mode 100644 lib/win32/lib/regcheck.py
 delete mode 100644 lib/win32/lib/regutil.py
 delete mode 100644 lib/win32/lib/sspi.py
 delete mode 100644 lib/win32/lib/sspicon.py
 delete mode 100644 lib/win32/lib/win2kras.py
 delete mode 100644 lib/win32/lib/win32con.py
 delete mode 100644 lib/win32/lib/win32cryptcon.py
 delete mode 100644 lib/win32/lib/win32evtlogutil.py
 delete mode 100644 lib/win32/lib/win32gui_struct.py
 delete mode 100644 lib/win32/lib/win32inetcon.py
 delete mode 100644 lib/win32/lib/win32netcon.py
 delete mode 100644 lib/win32/lib/win32pdhquery.py
 delete mode 100644 lib/win32/lib/win32pdhutil.py
 delete mode 100644 lib/win32/lib/win32rcparser.py
 delete mode 100644 lib/win32/lib/win32serviceutil.py
 delete mode 100644 lib/win32/lib/win32timezone.py
 delete mode 100644 lib/win32/lib/win32traceutil.py
 delete mode 100644 lib/win32/lib/win32verstamp.py
 delete mode 100644 lib/win32/lib/winerror.py
 delete mode 100644 lib/win32/lib/winioctlcon.py
 delete mode 100644 lib/win32/lib/winnt.py
 delete mode 100644 lib/win32/lib/winperf.py
 delete mode 100644 lib/win32/lib/winxptheme.py
 delete mode 100644 lib/win32/license.txt
 delete mode 100644 lib/win32/scripts/ControlService.py
 delete mode 100644 lib/win32/scripts/VersionStamp/BrandProject.py
 delete mode 100644 lib/win32/scripts/VersionStamp/bulkstamp.py
 delete mode 100644 lib/win32/scripts/VersionStamp/vssutil.py
 delete mode 100644 lib/win32/scripts/backupEventLog.py
 delete mode 100644 lib/win32/scripts/ce/pysynch.py
 delete mode 100644 lib/win32/scripts/killProcName.py
 delete mode 100644 lib/win32/scripts/rasutil.py
 delete mode 100644 lib/win32/scripts/regsetup.py
 delete mode 100644 lib/win32/scripts/setup_d.py
 delete mode 100644 lib/win32/test/handles.py
 delete mode 100644 lib/win32/test/test_clipboard.py
 delete mode 100644 lib/win32/test/test_exceptions.py
 delete mode 100644 lib/win32/test/test_odbc.py
 delete mode 100644 lib/win32/test/test_pywintypes.py
 delete mode 100644 lib/win32/test/test_security.py
 delete mode 100644 lib/win32/test/test_sspi.py
 delete mode 100644 lib/win32/test/test_win32api.py
 delete mode 100644 lib/win32/test/test_win32crypt.py
 delete mode 100644 lib/win32/test/test_win32event.py
 delete mode 100644 lib/win32/test/test_win32file.py
 delete mode 100644 lib/win32/test/test_win32gui.py
 delete mode 100644 lib/win32/test/test_win32guistruct.py
 delete mode 100644 lib/win32/test/test_win32inet.py
 delete mode 100644 lib/win32/test/test_win32net.py
 delete mode 100644 lib/win32/test/test_win32pipe.py
 delete mode 100644 lib/win32/test/test_win32print.py
 delete mode 100644 lib/win32/test/test_win32profile.py
 delete mode 100644 lib/win32/test/test_win32rcparser.py
 delete mode 100644 lib/win32/test/test_win32timezone.py
 delete mode 100644 lib/win32/test/test_win32trace.py
 delete mode 100644 lib/win32/test/test_win32wnet.py
 delete mode 100644 lib/win32/test/testall.py
 delete mode 100644 lib/win32/test/win32rcparser/python.bmp
 delete mode 100644 lib/win32/test/win32rcparser/python.ico
 delete mode 100644 lib/win32/test/win32rcparser/test.h
 delete mode 100644 lib/win32/test/win32rcparser/test.rc
 delete mode 100644 lib/win32com/HTML/GeneratedSupport.html
 delete mode 100644 lib/win32com/HTML/PythonCOM.html
 delete mode 100644 lib/win32com/HTML/QuickStartClientCom.html
 delete mode 100644 lib/win32com/HTML/QuickStartServerCom.html
 delete mode 100644 lib/win32com/HTML/docindex.html
 delete mode 100644 lib/win32com/HTML/image/BTN_HomePage.gif
 delete mode 100644 lib/win32com/HTML/image/BTN_ManualTop.gif
 delete mode 100644 lib/win32com/HTML/image/BTN_NextPage.gif
 delete mode 100644 lib/win32com/HTML/image/BTN_PrevPage.gif
 delete mode 100644 lib/win32com/HTML/image/blank.gif
 delete mode 100644 lib/win32com/HTML/image/pycom_blowing.gif
 delete mode 100644 lib/win32com/HTML/image/pythoncom.gif
 delete mode 100644 lib/win32com/HTML/image/www_icon.gif
 delete mode 100644 lib/win32com/HTML/index.html
 delete mode 100644 lib/win32com/HTML/misc.html
 delete mode 100644 lib/win32com/HTML/package.html
 delete mode 100644 lib/win32com/HTML/variant.html
 delete mode 100644 lib/win32com/License.txt
 delete mode 100644 lib/win32com/__init__.py
 delete mode 100644 lib/win32com/client/CLSIDToClass.py
 delete mode 100644 lib/win32com/client/__init__.py
 delete mode 100644 lib/win32com/client/build.py
 delete mode 100644 lib/win32com/client/combrowse.py
 delete mode 100644 lib/win32com/client/connect.py
 delete mode 100644 lib/win32com/client/dynamic.py
 delete mode 100644 lib/win32com/client/gencache.py
 delete mode 100644 lib/win32com/client/genpy.py
 delete mode 100644 lib/win32com/client/makepy.py
 delete mode 100644 lib/win32com/client/selecttlb.py
 delete mode 100644 lib/win32com/client/tlbrowse.py
 delete mode 100644 lib/win32com/client/util.py
 delete mode 100644 lib/win32com/demos/__init__.py
 delete mode 100644 lib/win32com/demos/connect.py
 delete mode 100644 lib/win32com/demos/dump_clipboard.py
 delete mode 100644 lib/win32com/demos/eventsApartmentThreaded.py
 delete mode 100644 lib/win32com/demos/eventsFreeThreaded.py
 delete mode 100644 lib/win32com/demos/excelAddin.py
 delete mode 100644 lib/win32com/demos/excelRTDServer.py
 delete mode 100644 lib/win32com/demos/iebutton.py
 delete mode 100644 lib/win32com/demos/ietoolbar.py
 delete mode 100644 lib/win32com/demos/outlookAddin.py
 delete mode 100644 lib/win32com/demos/trybag.py
 delete mode 100644 lib/win32com/include/PythonCOM.h
 delete mode 100644 lib/win32com/include/PythonCOMRegister.h
 delete mode 100644 lib/win32com/include/PythonCOMServer.h
 delete mode 100644 lib/win32com/makegw/__init__.py
 delete mode 100644 lib/win32com/makegw/makegw.py
 delete mode 100644 lib/win32com/makegw/makegwenum.py
 delete mode 100644 lib/win32com/makegw/makegwparse.py
 delete mode 100644 lib/win32com/olectl.py
 delete mode 100644 lib/win32com/readme.html
 delete mode 100644 lib/win32com/server/__init__.py
 delete mode 100644 lib/win32com/server/connect.py
 delete mode 100644 lib/win32com/server/dispatcher.py
 delete mode 100644 lib/win32com/server/exception.py
 delete mode 100644 lib/win32com/server/factory.py
 delete mode 100644 lib/win32com/server/localserver.py
 delete mode 100644 lib/win32com/server/policy.py
 delete mode 100644 lib/win32com/server/register.py
 delete mode 100644 lib/win32com/server/util.py
 delete mode 100644 lib/win32com/servers/PythonTools.py
 delete mode 100644 lib/win32com/servers/__init__.py
 delete mode 100644 lib/win32com/servers/dictionary.py
 delete mode 100644 lib/win32com/servers/interp.py
 delete mode 100644 lib/win32com/servers/perfmon.py
 delete mode 100644 lib/win32com/servers/test_pycomtest.py
 delete mode 100644 lib/win32com/storagecon.py
 delete mode 100644 lib/win32com/test/GenTestScripts.py
 delete mode 100644 lib/win32com/test/Testpys.sct
 delete mode 100644 lib/win32com/test/__init__.py
 delete mode 100644 lib/win32com/test/daodump.py
 delete mode 100644 lib/win32com/test/errorSemantics.py
 delete mode 100644 lib/win32com/test/pippo.idl
 delete mode 100644 lib/win32com/test/pippo_server.py
 delete mode 100644 lib/win32com/test/policySemantics.py
 delete mode 100644 lib/win32com/test/readme.txt
 delete mode 100644 lib/win32com/test/testADOEvents.py
 delete mode 100644 lib/win32com/test/testAXScript.py
 delete mode 100644 lib/win32com/test/testAccess.py
 delete mode 100644 lib/win32com/test/testArrays.py
 delete mode 100644 lib/win32com/test/testClipboard.py
 delete mode 100644 lib/win32com/test/testCollections.py
 delete mode 100644 lib/win32com/test/testConversionErrors.py
 delete mode 100644 lib/win32com/test/testDCOM.py
 delete mode 100644 lib/win32com/test/testDates.py
 delete mode 100644 lib/win32com/test/testDictionary.py
 delete mode 100644 lib/win32com/test/testDictionary.vbs
 delete mode 100644 lib/win32com/test/testDynamic.py
 delete mode 100644 lib/win32com/test/testExchange.py
 delete mode 100644 lib/win32com/test/testExplorer.py
 delete mode 100644 lib/win32com/test/testGIT.py
 delete mode 100644 lib/win32com/test/testGatewayAddresses.py
 delete mode 100644 lib/win32com/test/testInterp.vbs
 delete mode 100644 lib/win32com/test/testIterators.py
 delete mode 100644 lib/win32com/test/testMSOffice.py
 delete mode 100644 lib/win32com/test/testMSOfficeEvents.py
 delete mode 100644 lib/win32com/test/testMarshal.py
 delete mode 100644 lib/win32com/test/testNetscape.py
 delete mode 100644 lib/win32com/test/testPersist.py
 delete mode 100644 lib/win32com/test/testPippo.py
 delete mode 100644 lib/win32com/test/testPyComTest.py
 delete mode 100644 lib/win32com/test/testPyScriptlet.js
 delete mode 100644 lib/win32com/test/testROT.py
 delete mode 100644 lib/win32com/test/testServers.py
 delete mode 100644 lib/win32com/test/testShell.py
 delete mode 100644 lib/win32com/test/testStorage.py
 delete mode 100644 lib/win32com/test/testStreams.py
 delete mode 100644 lib/win32com/test/testWMI.py
 delete mode 100644 lib/win32com/test/testall.py
 delete mode 100644 lib/win32com/test/testmakepy.py
 delete mode 100644 lib/win32com/test/testvb.py
 delete mode 100644 lib/win32com/test/testvbscript_regexp.py
 delete mode 100644 lib/win32com/test/testxslt.js
 delete mode 100644 lib/win32com/test/testxslt.py
 delete mode 100644 lib/win32com/test/testxslt.xsl
 delete mode 100644 lib/win32com/test/util.py
 delete mode 100644 lib/win32com/universal.py
 delete mode 100644 lib/win32com/util.py
 delete mode 100644 lib/win32comext/adsi/__init__.py
 delete mode 100644 lib/win32comext/adsi/adsi.pyd
 delete mode 100644 lib/win32comext/adsi/adsicon.py
 delete mode 100644 lib/win32comext/adsi/demos/objectPicker.py
 delete mode 100644 lib/win32comext/adsi/demos/scp.py
 delete mode 100644 lib/win32comext/adsi/demos/search.py
 delete mode 100644 lib/win32comext/adsi/demos/test.py
 delete mode 100644 lib/win32comext/authorization/__init__.py
 delete mode 100644 lib/win32comext/authorization/authorization.pyd
 delete mode 100644 lib/win32comext/authorization/demos/EditSecurity.py
 delete mode 100644 lib/win32comext/authorization/demos/EditServiceSecurity.py
 delete mode 100644 lib/win32comext/axcontrol/__init__.py
 delete mode 100644 lib/win32comext/axcontrol/axcontrol.pyd
 delete mode 100644 lib/win32comext/axdebug/__init__.py
 delete mode 100644 lib/win32comext/axdebug/adb.py
 delete mode 100644 lib/win32comext/axdebug/axdebug.pyd
 delete mode 100644 lib/win32comext/axdebug/codecontainer.py
 delete mode 100644 lib/win32comext/axdebug/contexts.py
 delete mode 100644 lib/win32comext/axdebug/debugger.py
 delete mode 100644 lib/win32comext/axdebug/documents.py
 delete mode 100644 lib/win32comext/axdebug/dump.py
 delete mode 100644 lib/win32comext/axdebug/expressions.py
 delete mode 100644 lib/win32comext/axdebug/gateways.py
 delete mode 100644 lib/win32comext/axdebug/stackframe.py
 delete mode 100644 lib/win32comext/axdebug/util.py
 delete mode 100644 lib/win32comext/axscript/Demos/client/asp/CreateObject.asp
 delete mode 100644 lib/win32comext/axscript/Demos/client/asp/caps.asp
 delete mode 100644 lib/win32comext/axscript/Demos/client/asp/interrupt/test.asp
 delete mode 100644 lib/win32comext/axscript/Demos/client/asp/interrupt/test.html
 delete mode 100644 lib/win32comext/axscript/Demos/client/asp/interrupt/test1.asp
 delete mode 100644 lib/win32comext/axscript/Demos/client/asp/interrupt/test1.html
 delete mode 100644 lib/win32comext/axscript/Demos/client/asp/tut1.asp
 delete mode 100644 lib/win32comext/axscript/Demos/client/ie/MarqueeText1.htm
 delete mode 100644 lib/win32comext/axscript/Demos/client/ie/calc.htm
 delete mode 100644 lib/win32comext/axscript/Demos/client/ie/dbgtest.htm
 delete mode 100644 lib/win32comext/axscript/Demos/client/ie/demo.htm
 delete mode 100644 lib/win32comext/axscript/Demos/client/ie/demo_check.htm
 delete mode 100644 lib/win32comext/axscript/Demos/client/ie/demo_intro.htm
 delete mode 100644 lib/win32comext/axscript/Demos/client/ie/demo_menu.htm
 delete mode 100644 lib/win32comext/axscript/Demos/client/ie/docwrite.htm
 delete mode 100644 lib/win32comext/axscript/Demos/client/ie/foo2.htm
 delete mode 100644 lib/win32comext/axscript/Demos/client/ie/form.htm
 delete mode 100644 lib/win32comext/axscript/Demos/client/ie/marqueeDemo.htm
 delete mode 100644 lib/win32comext/axscript/Demos/client/ie/mousetrack.htm
 delete mode 100644 lib/win32comext/axscript/Demos/client/ie/pycom_blowing.gif
 delete mode 100644 lib/win32comext/axscript/Demos/client/wsh/blank.pys
 delete mode 100644 lib/win32comext/axscript/Demos/client/wsh/excel.pys
 delete mode 100644 lib/win32comext/axscript/Demos/client/wsh/registry.pys
 delete mode 100644 lib/win32comext/axscript/Demos/client/wsh/test.pys
 delete mode 100644 lib/win32comext/axscript/__init__.py
 delete mode 100644 lib/win32comext/axscript/asputil.py
 delete mode 100644 lib/win32comext/axscript/axscript.pyd
 delete mode 100644 lib/win32comext/axscript/client/__init__.py
 delete mode 100644 lib/win32comext/axscript/client/debug.py
 delete mode 100644 lib/win32comext/axscript/client/error.py
 delete mode 100644 lib/win32comext/axscript/client/framework.py
 delete mode 100644 lib/win32comext/axscript/client/pydumper.py
 delete mode 100644 lib/win32comext/axscript/client/pyscript.py
 delete mode 100644 lib/win32comext/axscript/client/pyscript_rexec.py
 delete mode 100644 lib/win32comext/axscript/client/scriptdispatch.py
 delete mode 100644 lib/win32comext/axscript/server/__init__.py
 delete mode 100644 lib/win32comext/axscript/server/axsite.py
 delete mode 100644 lib/win32comext/axscript/server/error.py
 delete mode 100644 lib/win32comext/axscript/test/debugTest.pys
 delete mode 100644 lib/win32comext/axscript/test/debugTest.vbs
 delete mode 100644 lib/win32comext/axscript/test/leakTest.py
 delete mode 100644 lib/win32comext/axscript/test/testHost.py
 delete mode 100644 lib/win32comext/axscript/test/testHost4Dbg.py
 delete mode 100644 lib/win32comext/bits/__init__.py
 delete mode 100644 lib/win32comext/bits/bits.pyd
 delete mode 100644 lib/win32comext/bits/test/show_all_jobs.py
 delete mode 100644 lib/win32comext/bits/test/test_bits.py
 delete mode 100644 lib/win32comext/directsound/__init__.py
 delete mode 100644 lib/win32comext/directsound/directsound.pyd
 delete mode 100644 lib/win32comext/directsound/test/__init__.py
 delete mode 100644 lib/win32comext/directsound/test/ds_record.py
 delete mode 100644 lib/win32comext/directsound/test/ds_test.py
 delete mode 100644 lib/win32comext/ifilter/__init__.py
 delete mode 100644 lib/win32comext/ifilter/demo/filterDemo.py
 delete mode 100644 lib/win32comext/ifilter/ifilter.pyd
 delete mode 100644 lib/win32comext/ifilter/ifiltercon.py
 delete mode 100644 lib/win32comext/internet/__init__.py
 delete mode 100644 lib/win32comext/internet/inetcon.py
 delete mode 100644 lib/win32comext/internet/internet.pyd
 delete mode 100644 lib/win32comext/mapi/__init__.py
 delete mode 100644 lib/win32comext/mapi/demos/mapisend.py
 delete mode 100644 lib/win32comext/mapi/emsabtags.py
 delete mode 100644 lib/win32comext/mapi/exchange.pyd
 delete mode 100644 lib/win32comext/mapi/mapi.pyd
 delete mode 100644 lib/win32comext/mapi/mapitags.py
 delete mode 100644 lib/win32comext/mapi/mapiutil.py
 delete mode 100644 lib/win32comext/propsys/__init__.py
 delete mode 100644 lib/win32comext/propsys/propsys.pyd
 delete mode 100644 lib/win32comext/propsys/pscon.py
 delete mode 100644 lib/win32comext/propsys/test/testpropsys.py
 delete mode 100644 lib/win32comext/shell/__init__.py
 delete mode 100644 lib/win32comext/shell/demos/IActiveDesktop.py
 delete mode 100644 lib/win32comext/shell/demos/IFileOperationProgressSink.py
 delete mode 100644 lib/win32comext/shell/demos/IShellLinkDataList.py
 delete mode 100644 lib/win32comext/shell/demos/ITransferAdviseSink.py
 delete mode 100644 lib/win32comext/shell/demos/IUniformResourceLocator.py
 delete mode 100644 lib/win32comext/shell/demos/browse_for_folder.py
 delete mode 100644 lib/win32comext/shell/demos/create_link.py
 delete mode 100644 lib/win32comext/shell/demos/dump_link.py
 delete mode 100644 lib/win32comext/shell/demos/explorer_browser.py
 delete mode 100644 lib/win32comext/shell/demos/servers/column_provider.py
 delete mode 100644 lib/win32comext/shell/demos/servers/context_menu.py
 delete mode 100644 lib/win32comext/shell/demos/servers/copy_hook.py
 delete mode 100644 lib/win32comext/shell/demos/servers/empty_volume_cache.py
 delete mode 100644 lib/win32comext/shell/demos/servers/folder_view.py
 delete mode 100644 lib/win32comext/shell/demos/servers/icon_handler.py
 delete mode 100644 lib/win32comext/shell/demos/servers/shell_view.py
 delete mode 100644 lib/win32comext/shell/demos/shellexecuteex.py
 delete mode 100644 lib/win32comext/shell/demos/viewstate.py
 delete mode 100644 lib/win32comext/shell/demos/walk_shell_folders.py
 delete mode 100644 lib/win32comext/shell/shell.pyd
 delete mode 100644 lib/win32comext/shell/shellcon.py
 delete mode 100644 lib/win32comext/shell/test/testSHFileOperation.py
 delete mode 100644 lib/win32comext/shell/test/testShellFolder.py
 delete mode 100644 lib/win32comext/shell/test/testShellItem.py
 delete mode 100644 lib/win32comext/taskscheduler/__init__.py
 delete mode 100644 lib/win32comext/taskscheduler/taskscheduler.pyd
 delete mode 100644 lib/win32comext/taskscheduler/test/test_addtask.py
 delete mode 100644 lib/win32comext/taskscheduler/test/test_addtask_1.py
 delete mode 100644 lib/win32comext/taskscheduler/test/test_addtask_2.py
 delete mode 100644 lib/win32comext/taskscheduler/test/test_localsystem.py

diff --git a/lib/PyWin32.chm b/lib/PyWin32.chm
deleted file mode 100644
index 7606f82b16c4d3653d70e8f4903f17f015997efe..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 2648456
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%0A>P!`ef8IA;QD
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%0D*b~X_)`<ToZg{^4AFfSZ9dZT2mB18=<JpHCLonS
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%0D@N)WJ*1(U}b%b%-@zG;jbdv4Dd34
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%0A`Zpf~D^$*T|tuIp|#}!!ohEuj=YJ{bK
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%0AR}63eXBw3e`zs8lU~}7PHW=LBUXtSCI>Vx=jqz
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
CCq4E6

diff --git a/lib/adodbapi/__init__.py b/lib/adodbapi/__init__.py
deleted file mode 100644
index 0d769e05..00000000
--- a/lib/adodbapi/__init__.py
+++ /dev/null
@@ -1,74 +0,0 @@
-"""adodbapi - A python DB API 2.0 (PEP 249) interface to Microsoft ADO
-
-Copyright (C) 2002 Henrik Ekelund, version 2.1 by Vernon Cole
-* http://sourceforge.net/projects/adodbapi
-"""
-import sys
-import time
-
-from .adodbapi import Connection, Cursor, __version__, connect, dateconverter
-from .apibase import (
-    BINARY,
-    DATETIME,
-    NUMBER,
-    ROWID,
-    STRING,
-    DatabaseError,
-    DataError,
-    Error,
-    FetchFailedError,
-    IntegrityError,
-    InterfaceError,
-    InternalError,
-    NotSupportedError,
-    OperationalError,
-    ProgrammingError,
-    Warning,
-    apilevel,
-    paramstyle,
-    threadsafety,
-)
-
-
-def Binary(aString):
-    """This function constructs an object capable of holding a binary (long) string value."""
-    return bytes(aString)
-
-
-def Date(year, month, day):
-    "This function constructs an object holding a date value."
-    return dateconverter.Date(year, month, day)
-
-
-def Time(hour, minute, second):
-    "This function constructs an object holding a time value."
-    return dateconverter.Time(hour, minute, second)
-
-
-def Timestamp(year, month, day, hour, minute, second):
-    "This function constructs an object holding a time stamp value."
-    return dateconverter.Timestamp(year, month, day, hour, minute, second)
-
-
-def DateFromTicks(ticks):
-    """This function constructs an object holding a date value from the given ticks value
-    (number of seconds since the epoch; see the documentation of the standard Python time module for details).
-    """
-    return Date(*time.gmtime(ticks)[:3])
-
-
-def TimeFromTicks(ticks):
-    """This function constructs an object holding a time value from the given ticks value
-    (number of seconds since the epoch; see the documentation of the standard Python time module for details).
-    """
-    return Time(*time.gmtime(ticks)[3:6])
-
-
-def TimestampFromTicks(ticks):
-    """This function constructs an object holding a time stamp value from the given
-    ticks value (number of seconds since the epoch;
-    see the documentation of the standard Python time module for details)."""
-    return Timestamp(*time.gmtime(ticks)[:6])
-
-
-version = "adodbapi v" + __version__
diff --git a/lib/adodbapi/ado_consts.py b/lib/adodbapi/ado_consts.py
deleted file mode 100644
index ecb2147d..00000000
--- a/lib/adodbapi/ado_consts.py
+++ /dev/null
@@ -1,281 +0,0 @@
-# ADO enumerated constants documented on MSDN:
-# http://msdn.microsoft.com/en-us/library/ms678353(VS.85).aspx
-
-# IsolationLevelEnum
-adXactUnspecified = -1
-adXactBrowse = 0x100
-adXactChaos = 0x10
-adXactCursorStability = 0x1000
-adXactIsolated = 0x100000
-adXactReadCommitted = 0x1000
-adXactReadUncommitted = 0x100
-adXactRepeatableRead = 0x10000
-adXactSerializable = 0x100000
-
-# CursorLocationEnum
-adUseClient = 3
-adUseServer = 2
-
-# CursorTypeEnum
-adOpenDynamic = 2
-adOpenForwardOnly = 0
-adOpenKeyset = 1
-adOpenStatic = 3
-adOpenUnspecified = -1
-
-# CommandTypeEnum
-adCmdText = 1
-adCmdStoredProc = 4
-adSchemaTables = 20
-
-# ParameterDirectionEnum
-adParamInput = 1
-adParamInputOutput = 3
-adParamOutput = 2
-adParamReturnValue = 4
-adParamUnknown = 0
-directions = {
-    0: "Unknown",
-    1: "Input",
-    2: "Output",
-    3: "InputOutput",
-    4: "Return",
-}
-
-
-def ado_direction_name(ado_dir):
-    try:
-        return "adParam" + directions[ado_dir]
-    except:
-        return "unknown direction (" + str(ado_dir) + ")"
-
-
-# ObjectStateEnum
-adStateClosed = 0
-adStateOpen = 1
-adStateConnecting = 2
-adStateExecuting = 4
-adStateFetching = 8
-
-# FieldAttributeEnum
-adFldMayBeNull = 0x40
-
-# ConnectModeEnum
-adModeUnknown = 0
-adModeRead = 1
-adModeWrite = 2
-adModeReadWrite = 3
-adModeShareDenyRead = 4
-adModeShareDenyWrite = 8
-adModeShareExclusive = 12
-adModeShareDenyNone = 16
-adModeRecursive = 0x400000
-
-# XactAttributeEnum
-adXactCommitRetaining = 131072
-adXactAbortRetaining = 262144
-
-ado_error_TIMEOUT = -2147217871
-
-# DataTypeEnum - ADO Data types documented at:
-# http://msdn2.microsoft.com/en-us/library/ms675318.aspx
-adArray = 0x2000
-adEmpty = 0x0
-adBSTR = 0x8
-adBigInt = 0x14
-adBinary = 0x80
-adBoolean = 0xB
-adChapter = 0x88
-adChar = 0x81
-adCurrency = 0x6
-adDBDate = 0x85
-adDBTime = 0x86
-adDBTimeStamp = 0x87
-adDate = 0x7
-adDecimal = 0xE
-adDouble = 0x5
-adError = 0xA
-adFileTime = 0x40
-adGUID = 0x48
-adIDispatch = 0x9
-adIUnknown = 0xD
-adInteger = 0x3
-adLongVarBinary = 0xCD
-adLongVarChar = 0xC9
-adLongVarWChar = 0xCB
-adNumeric = 0x83
-adPropVariant = 0x8A
-adSingle = 0x4
-adSmallInt = 0x2
-adTinyInt = 0x10
-adUnsignedBigInt = 0x15
-adUnsignedInt = 0x13
-adUnsignedSmallInt = 0x12
-adUnsignedTinyInt = 0x11
-adUserDefined = 0x84
-adVarBinary = 0xCC
-adVarChar = 0xC8
-adVarNumeric = 0x8B
-adVarWChar = 0xCA
-adVariant = 0xC
-adWChar = 0x82
-# Additional constants used by introspection but not ADO itself
-AUTO_FIELD_MARKER = -1000
-
-adTypeNames = {
-    adBSTR: "adBSTR",
-    adBigInt: "adBigInt",
-    adBinary: "adBinary",
-    adBoolean: "adBoolean",
-    adChapter: "adChapter",
-    adChar: "adChar",
-    adCurrency: "adCurrency",
-    adDBDate: "adDBDate",
-    adDBTime: "adDBTime",
-    adDBTimeStamp: "adDBTimeStamp",
-    adDate: "adDate",
-    adDecimal: "adDecimal",
-    adDouble: "adDouble",
-    adEmpty: "adEmpty",
-    adError: "adError",
-    adFileTime: "adFileTime",
-    adGUID: "adGUID",
-    adIDispatch: "adIDispatch",
-    adIUnknown: "adIUnknown",
-    adInteger: "adInteger",
-    adLongVarBinary: "adLongVarBinary",
-    adLongVarChar: "adLongVarChar",
-    adLongVarWChar: "adLongVarWChar",
-    adNumeric: "adNumeric",
-    adPropVariant: "adPropVariant",
-    adSingle: "adSingle",
-    adSmallInt: "adSmallInt",
-    adTinyInt: "adTinyInt",
-    adUnsignedBigInt: "adUnsignedBigInt",
-    adUnsignedInt: "adUnsignedInt",
-    adUnsignedSmallInt: "adUnsignedSmallInt",
-    adUnsignedTinyInt: "adUnsignedTinyInt",
-    adUserDefined: "adUserDefined",
-    adVarBinary: "adVarBinary",
-    adVarChar: "adVarChar",
-    adVarNumeric: "adVarNumeric",
-    adVarWChar: "adVarWChar",
-    adVariant: "adVariant",
-    adWChar: "adWChar",
-}
-
-
-def ado_type_name(ado_type):
-    return adTypeNames.get(ado_type, "unknown type (" + str(ado_type) + ")")
-
-
-# here in decimal, sorted by value
-# adEmpty 0 Specifies no value (DBTYPE_EMPTY).
-# adSmallInt 2 Indicates a two-byte signed integer (DBTYPE_I2).
-# adInteger 3 Indicates a four-byte signed integer (DBTYPE_I4).
-# adSingle 4 Indicates a single-precision floating-point value (DBTYPE_R4).
-# adDouble 5 Indicates a double-precision floating-point value (DBTYPE_R8).
-# adCurrency 6 Indicates a currency value (DBTYPE_CY). Currency is a fixed-point number
-#   with four digits to the right of the decimal point. It is stored in an eight-byte signed integer scaled by 10,000.
-# adDate 7 Indicates a date value (DBTYPE_DATE). A date is stored as a double, the whole part of which is
-#   the number of days since December 30, 1899, and the fractional part of which is the fraction of a day.
-# adBSTR 8 Indicates a null-terminated character string (Unicode) (DBTYPE_BSTR).
-# adIDispatch 9 Indicates a pointer to an IDispatch interface on a COM object (DBTYPE_IDISPATCH).
-# adError 10 Indicates a 32-bit error code (DBTYPE_ERROR).
-# adBoolean 11 Indicates a boolean value (DBTYPE_BOOL).
-# adVariant 12 Indicates an Automation Variant (DBTYPE_VARIANT).
-# adIUnknown 13 Indicates a pointer to an IUnknown interface on a COM object (DBTYPE_IUNKNOWN).
-# adDecimal 14 Indicates an exact numeric value with a fixed precision and scale (DBTYPE_DECIMAL).
-# adTinyInt 16 Indicates a one-byte signed integer (DBTYPE_I1).
-# adUnsignedTinyInt 17 Indicates a one-byte unsigned integer (DBTYPE_UI1).
-# adUnsignedSmallInt 18 Indicates a two-byte unsigned integer (DBTYPE_UI2).
-# adUnsignedInt 19 Indicates a four-byte unsigned integer (DBTYPE_UI4).
-# adBigInt 20 Indicates an eight-byte signed integer (DBTYPE_I8).
-# adUnsignedBigInt 21 Indicates an eight-byte unsigned integer (DBTYPE_UI8).
-# adFileTime 64 Indicates a 64-bit value representing the number of 100-nanosecond intervals since
-#    January 1, 1601 (DBTYPE_FILETIME).
-# adGUID 72 Indicates a globally unique identifier (GUID) (DBTYPE_GUID).
-# adBinary 128 Indicates a binary value (DBTYPE_BYTES).
-# adChar 129 Indicates a string value (DBTYPE_STR).
-# adWChar 130 Indicates a null-terminated Unicode character string (DBTYPE_WSTR).
-# adNumeric 131 Indicates an exact numeric value with a fixed precision and scale (DBTYPE_NUMERIC).
-#   adUserDefined 132 Indicates a user-defined variable (DBTYPE_UDT).
-# adUserDefined 132 Indicates a user-defined variable (DBTYPE_UDT).
-# adDBDate 133 Indicates a date value (yyyymmdd) (DBTYPE_DBDATE).
-# adDBTime 134 Indicates a time value (hhmmss) (DBTYPE_DBTIME).
-# adDBTimeStamp 135 Indicates a date/time stamp (yyyymmddhhmmss plus a fraction in billionths) (DBTYPE_DBTIMESTAMP).
-# adChapter 136 Indicates a four-byte chapter value that identifies rows in a child rowset (DBTYPE_HCHAPTER).
-# adPropVariant 138 Indicates an Automation PROPVARIANT (DBTYPE_PROP_VARIANT).
-# adVarNumeric 139 Indicates a numeric value (Parameter object only).
-# adVarChar 200 Indicates a string value (Parameter object only).
-# adLongVarChar 201 Indicates a long string value (Parameter object only).
-# adVarWChar 202 Indicates a null-terminated Unicode character string (Parameter object only).
-# adLongVarWChar 203 Indicates a long null-terminated Unicode string value (Parameter object only).
-# adVarBinary 204 Indicates a binary value (Parameter object only).
-# adLongVarBinary 205 Indicates a long binary value (Parameter object only).
-# adArray (Does not apply to ADOX.) 0x2000 A flag value, always combined with another data type constant,
-#   that indicates an array of that other data type.
-
-# Error codes to names
-adoErrors = {
-    0xE7B: "adErrBoundToCommand",
-    0xE94: "adErrCannotComplete",
-    0xEA4: "adErrCantChangeConnection",
-    0xC94: "adErrCantChangeProvider",
-    0xE8C: "adErrCantConvertvalue",
-    0xE8D: "adErrCantCreate",
-    0xEA3: "adErrCatalogNotSet",
-    0xE8E: "adErrColumnNotOnThisRow",
-    0xD5D: "adErrDataConversion",
-    0xE89: "adErrDataOverflow",
-    0xE9A: "adErrDelResOutOfScope",
-    0xEA6: "adErrDenyNotSupported",
-    0xEA7: "adErrDenyTypeNotSupported",
-    0xCB3: "adErrFeatureNotAvailable",
-    0xEA5: "adErrFieldsUpdateFailed",
-    0xC93: "adErrIllegalOperation",
-    0xCAE: "adErrInTransaction",
-    0xE87: "adErrIntegrityViolation",
-    0xBB9: "adErrInvalidArgument",
-    0xE7D: "adErrInvalidConnection",
-    0xE7C: "adErrInvalidParamInfo",
-    0xE82: "adErrInvalidTransaction",
-    0xE91: "adErrInvalidURL",
-    0xCC1: "adErrItemNotFound",
-    0xBCD: "adErrNoCurrentRecord",
-    0xE83: "adErrNotExecuting",
-    0xE7E: "adErrNotReentrant",
-    0xE78: "adErrObjectClosed",
-    0xD27: "adErrObjectInCollection",
-    0xD5C: "adErrObjectNotSet",
-    0xE79: "adErrObjectOpen",
-    0xBBA: "adErrOpeningFile",
-    0xE80: "adErrOperationCancelled",
-    0xE96: "adErrOutOfSpace",
-    0xE88: "adErrPermissionDenied",
-    0xE9E: "adErrPropConflicting",
-    0xE9B: "adErrPropInvalidColumn",
-    0xE9C: "adErrPropInvalidOption",
-    0xE9D: "adErrPropInvalidValue",
-    0xE9F: "adErrPropNotAllSettable",
-    0xEA0: "adErrPropNotSet",
-    0xEA1: "adErrPropNotSettable",
-    0xEA2: "adErrPropNotSupported",
-    0xBB8: "adErrProviderFailed",
-    0xE7A: "adErrProviderNotFound",
-    0xBBB: "adErrReadFile",
-    0xE93: "adErrResourceExists",
-    0xE92: "adErrResourceLocked",
-    0xE97: "adErrResourceOutOfScope",
-    0xE8A: "adErrSchemaViolation",
-    0xE8B: "adErrSignMismatch",
-    0xE81: "adErrStillConnecting",
-    0xE7F: "adErrStillExecuting",
-    0xE90: "adErrTreePermissionDenied",
-    0xE8F: "adErrURLDoesNotExist",
-    0xE99: "adErrURLNamedRowDoesNotExist",
-    0xE98: "adErrUnavailable",
-    0xE84: "adErrUnsafeOperation",
-    0xE95: "adErrVolumeNotFound",
-    0xBBC: "adErrWriteFile",
-}
diff --git a/lib/adodbapi/adodbapi.py b/lib/adodbapi/adodbapi.py
deleted file mode 100644
index 8f7c045e..00000000
--- a/lib/adodbapi/adodbapi.py
+++ /dev/null
@@ -1,1223 +0,0 @@
-"""adodbapi - A python DB API 2.0 (PEP 249) interface to Microsoft ADO
-
-Copyright (C) 2002 Henrik Ekelund, versions 2.1 and later by Vernon Cole
-* http://sourceforge.net/projects/pywin32
-* https://github.com/mhammond/pywin32
-* http://sourceforge.net/projects/adodbapi
-
-    This library is free software; you can redistribute it and/or
-    modify it under the terms of the GNU Lesser General Public
-    License as published by the Free Software Foundation; either
-    version 2.1 of the License, or (at your option) any later version.
-
-    This library is distributed in the hope that it will be useful,
-    but WITHOUT ANY WARRANTY; without even the implied warranty of
-    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
-    Lesser General Public License for more details.
-
-    You should have received a copy of the GNU Lesser General Public
-    License along with this library; if not, write to the Free Software
-    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
-
-    django adaptations and refactoring by Adam Vandenberg
-
-DB-API 2.0 specification: http://www.python.org/dev/peps/pep-0249/
-
-This module source should run correctly in CPython versions 2.7 and later,
-or IronPython version 2.7 and later,
-or, after running through 2to3.py, CPython 3.4 or later.
-"""
-
-__version__ = "2.6.2.0"
-version = "adodbapi v" + __version__
-
-import copy
-import decimal
-import os
-import sys
-import weakref
-
-from . import ado_consts as adc, apibase as api, process_connect_string
-
-try:
-    verbose = int(os.environ["ADODBAPI_VERBOSE"])
-except:
-    verbose = False
-if verbose:
-    print(version)
-
-# --- define objects to smooth out IronPython <-> CPython differences
-onWin32 = False  # assume the worst
-if api.onIronPython:
-    from clr import Reference
-    from System import (
-        Activator,
-        Array,
-        Byte,
-        DateTime,
-        DBNull,
-        Decimal as SystemDecimal,
-        Type,
-    )
-
-    def Dispatch(dispatch):
-        type = Type.GetTypeFromProgID(dispatch)
-        return Activator.CreateInstance(type)
-
-    def getIndexedValue(obj, index):
-        return obj.Item[index]
-
-else:  # try pywin32
-    try:
-        import pythoncom
-        import pywintypes
-        import win32com.client
-
-        onWin32 = True
-
-        def Dispatch(dispatch):
-            return win32com.client.Dispatch(dispatch)
-
-    except ImportError:
-        import warnings
-
-        warnings.warn(
-            "pywin32 package (or IronPython) required for adodbapi.", ImportWarning
-        )
-
-    def getIndexedValue(obj, index):
-        return obj(index)
-
-
-from collections.abc import Mapping
-
-# --- define objects to smooth out Python3000 <-> Python 2.x differences
-unicodeType = str
-longType = int
-StringTypes = str
-maxint = sys.maxsize
-
-
-# -----------------  The .connect method -----------------
-def make_COM_connecter():
-    try:
-        if onWin32:
-            pythoncom.CoInitialize()  # v2.1 Paj
-        c = Dispatch("ADODB.Connection")  # connect _after_ CoIninialize v2.1.1 adamvan
-    except:
-        raise api.InterfaceError(
-            "Windows COM Error: Dispatch('ADODB.Connection') failed."
-        )
-    return c
-
-
-def connect(*args, **kwargs):  # --> a db-api connection object
-    """Connect to a database.
-
-    call using:
-    :connection_string -- An ADODB formatted connection string, see:
-         * http://www.connectionstrings.com
-         * http://www.asp101.com/articles/john/connstring/default.asp
-    :timeout -- A command timeout value, in seconds (default 30 seconds)
-    """
-    co = Connection()  # make an empty connection object
-
-    kwargs = process_connect_string.process(args, kwargs, True)
-
-    try:  # connect to the database, using the connection information in kwargs
-        co.connect(kwargs)
-        return co
-    except Exception as e:
-        message = 'Error opening connection to "%s"' % co.connection_string
-        raise api.OperationalError(e, message)
-
-
-# so you could use something like:
-#   myConnection.paramstyle = 'named'
-# The programmer may also change the default.
-#   For example, if I were using django, I would say:
-#     import adodbapi as Database
-#     Database.adodbapi.paramstyle = 'format'
-
-# ------- other module level defaults --------
-defaultIsolationLevel = adc.adXactReadCommitted
-#  Set defaultIsolationLevel on module level before creating the connection.
-#   For example:
-#   import adodbapi, ado_consts
-#   adodbapi.adodbapi.defaultIsolationLevel=ado_consts.adXactBrowse"
-#
-#  Set defaultCursorLocation on module level before creating the connection.
-# It may be one of the "adUse..." consts.
-defaultCursorLocation = adc.adUseClient  # changed from adUseServer as of v 2.3.0
-
-dateconverter = api.pythonDateTimeConverter()  # default
-
-
-def format_parameters(ADOparameters, show_value=False):
-    """Format a collection of ADO Command Parameters.
-
-    Used by error reporting in _execute_command.
-    """
-    try:
-        if show_value:
-            desc = [
-                'Name: %s, Dir.: %s, Type: %s, Size: %s, Value: "%s", Precision: %s, NumericScale: %s'
-                % (
-                    p.Name,
-                    adc.directions[p.Direction],
-                    adc.adTypeNames.get(p.Type, str(p.Type) + " (unknown type)"),
-                    p.Size,
-                    p.Value,
-                    p.Precision,
-                    p.NumericScale,
-                )
-                for p in ADOparameters
-            ]
-        else:
-            desc = [
-                "Name: %s, Dir.: %s, Type: %s, Size: %s, Precision: %s, NumericScale: %s"
-                % (
-                    p.Name,
-                    adc.directions[p.Direction],
-                    adc.adTypeNames.get(p.Type, str(p.Type) + " (unknown type)"),
-                    p.Size,
-                    p.Precision,
-                    p.NumericScale,
-                )
-                for p in ADOparameters
-            ]
-        return "[" + "\n".join(desc) + "]"
-    except:
-        return "[]"
-
-
-def _configure_parameter(p, value, adotype, settings_known):
-    """Configure the given ADO Parameter 'p' with the Python 'value'."""
-
-    if adotype in api.adoBinaryTypes:
-        p.Size = len(value)
-        p.AppendChunk(value)
-
-    elif isinstance(value, StringTypes):  # v2.1 Jevon
-        L = len(value)
-        if adotype in api.adoStringTypes:  # v2.2.1 Cole
-            if settings_known:
-                L = min(L, p.Size)  # v2.1 Cole limit data to defined size
-            p.Value = value[:L]  # v2.1 Jevon & v2.1 Cole
-        else:
-            p.Value = value  # dont limit if db column is numeric
-        if L > 0:  # v2.1 Cole something does not like p.Size as Zero
-            p.Size = L  # v2.1 Jevon
-
-    elif isinstance(value, decimal.Decimal):
-        if api.onIronPython:
-            s = str(value)
-            p.Value = s
-            p.Size = len(s)
-        else:
-            p.Value = value
-        exponent = value.as_tuple()[2]
-        digit_count = len(value.as_tuple()[1])
-        p.Precision = digit_count
-        if exponent == 0:
-            p.NumericScale = 0
-        elif exponent < 0:
-            p.NumericScale = -exponent
-            if p.Precision < p.NumericScale:
-                p.Precision = p.NumericScale
-        else:  # exponent > 0:
-            p.NumericScale = 0
-            p.Precision = digit_count + exponent
-
-    elif type(value) in dateconverter.types:
-        if settings_known and adotype in api.adoDateTimeTypes:
-            p.Value = dateconverter.COMDate(value)
-        else:  # probably a string
-            # provide the date as a string in the format 'YYYY-MM-dd'
-            s = dateconverter.DateObjectToIsoFormatString(value)
-            p.Value = s
-            p.Size = len(s)
-
-    elif api.onIronPython and isinstance(value, longType):  # Iron Python Long
-        s = str(value)  # feature workaround for IPy 2.0
-        p.Value = s
-
-    elif adotype == adc.adEmpty:  # ADO will not let you specify a null column
-        p.Type = (
-            adc.adInteger
-        )  # so we will fake it to be an integer (just to have something)
-        p.Value = None  # and pass in a Null *value*
-
-        # For any other type, set the value and let pythoncom do the right thing.
-    else:
-        p.Value = value
-
-
-# # # # # ----- the Class that defines a connection ----- # # # # #
-class Connection(object):
-    # include connection attributes as class attributes required by api definition.
-    Warning = api.Warning
-    Error = api.Error
-    InterfaceError = api.InterfaceError
-    DataError = api.DataError
-    DatabaseError = api.DatabaseError
-    OperationalError = api.OperationalError
-    IntegrityError = api.IntegrityError
-    InternalError = api.InternalError
-    NotSupportedError = api.NotSupportedError
-    ProgrammingError = api.ProgrammingError
-    FetchFailedError = api.FetchFailedError  # (special for django)
-    # ...class attributes... (can be overridden by instance attributes)
-    verbose = api.verbose
-
-    @property
-    def dbapi(self):  # a proposed db-api version 3 extension.
-        "Return a reference to the DBAPI module for this Connection."
-        return api
-
-    def __init__(self):  # now define the instance attributes
-        self.connector = None
-        self.paramstyle = api.paramstyle
-        self.supportsTransactions = False
-        self.connection_string = ""
-        self.cursors = weakref.WeakValueDictionary()
-        self.dbms_name = ""
-        self.dbms_version = ""
-        self.errorhandler = None  # use the standard error handler for this instance
-        self.transaction_level = 0  # 0 == Not in a transaction, at the top level
-        self._autocommit = False
-
-    def connect(self, kwargs, connection_maker=make_COM_connecter):
-        if verbose > 9:
-            print("kwargs=", repr(kwargs))
-        try:
-            self.connection_string = (
-                kwargs["connection_string"] % kwargs
-            )  # insert keyword arguments
-        except Exception as e:
-            self._raiseConnectionError(
-                KeyError, "Python string format error in connection string->"
-            )
-        self.timeout = kwargs.get("timeout", 30)
-        self.mode = kwargs.get("mode", adc.adModeUnknown)
-        self.kwargs = kwargs
-        if verbose:
-            print('%s attempting: "%s"' % (version, self.connection_string))
-        self.connector = connection_maker()
-        self.connector.ConnectionTimeout = self.timeout
-        self.connector.ConnectionString = self.connection_string
-        self.connector.Mode = self.mode
-
-        try:
-            self.connector.Open()  # Open the ADO connection
-        except api.Error:
-            self._raiseConnectionError(
-                api.DatabaseError,
-                "ADO error trying to Open=%s" % self.connection_string,
-            )
-
-        try:  # Stefan Fuchs; support WINCCOLEDBProvider
-            if getIndexedValue(self.connector.Properties, "Transaction DDL").Value != 0:
-                self.supportsTransactions = True
-        except pywintypes.com_error:
-            pass  # Stefan Fuchs
-        self.dbms_name = getIndexedValue(self.connector.Properties, "DBMS Name").Value
-        try:  # Stefan Fuchs
-            self.dbms_version = getIndexedValue(
-                self.connector.Properties, "DBMS Version"
-            ).Value
-        except pywintypes.com_error:
-            pass  # Stefan Fuchs
-        self.connector.CursorLocation = defaultCursorLocation  # v2.1 Rose
-        if self.supportsTransactions:
-            self.connector.IsolationLevel = defaultIsolationLevel
-            self._autocommit = bool(kwargs.get("autocommit", False))
-            if not self._autocommit:
-                self.transaction_level = (
-                    self.connector.BeginTrans()
-                )  # Disables autocommit & inits transaction_level
-        else:
-            self._autocommit = True
-        if "paramstyle" in kwargs:
-            self.paramstyle = kwargs["paramstyle"]  # let setattr do the error checking
-        self.messages = []
-        if verbose:
-            print("adodbapi New connection at %X" % id(self))
-
-    def _raiseConnectionError(self, errorclass, errorvalue):
-        eh = self.errorhandler
-        if eh is None:
-            eh = api.standardErrorHandler
-        eh(self, None, errorclass, errorvalue)
-
-    def _closeAdoConnection(self):  # all v2.1 Rose
-        """close the underlying ADO Connection object,
-        rolling it back first if it supports transactions."""
-        if self.connector is None:
-            return
-        if not self._autocommit:
-            if self.transaction_level:
-                try:
-                    self.connector.RollbackTrans()
-                except:
-                    pass
-        self.connector.Close()
-        if verbose:
-            print("adodbapi Closed connection at %X" % id(self))
-
-    def close(self):
-        """Close the connection now (rather than whenever __del__ is called).
-
-        The connection will be unusable from this point forward;
-        an Error (or subclass) exception will be raised if any operation is attempted with the connection.
-        The same applies to all cursor objects trying to use the connection.
-        """
-        for crsr in list(self.cursors.values())[
-            :
-        ]:  # copy the list, then close each one
-            crsr.close(dont_tell_me=True)  # close without back-link clearing
-        self.messages = []
-        try:
-            self._closeAdoConnection()  # v2.1 Rose
-        except Exception as e:
-            self._raiseConnectionError(sys.exc_info()[0], sys.exc_info()[1])
-
-        self.connector = None  # v2.4.2.2 fix subtle timeout bug
-        # per M.Hammond: "I expect the benefits of uninitializing are probably fairly small,
-        #    so never uninitializing will probably not cause any problems."
-
-    def commit(self):
-        """Commit any pending transaction to the database.
-
-        Note that if the database supports an auto-commit feature,
-        this must be initially off. An interface method may be provided to turn it back on.
-        Database modules that do not support transactions should implement this method with void functionality.
-        """
-        self.messages = []
-        if not self.supportsTransactions:
-            return
-
-        try:
-            self.transaction_level = self.connector.CommitTrans()
-            if verbose > 1:
-                print("commit done on connection at %X" % id(self))
-            if not (
-                self._autocommit
-                or (self.connector.Attributes & adc.adXactAbortRetaining)
-            ):
-                # If attributes has adXactCommitRetaining it performs retaining commits that is,
-                # calling CommitTrans automatically starts a new transaction. Not all providers support this.
-                # If not, we will have to start a new transaction by this command:
-                self.transaction_level = self.connector.BeginTrans()
-        except Exception as e:
-            self._raiseConnectionError(api.ProgrammingError, e)
-
-    def _rollback(self):
-        """In case a database does provide transactions this method causes the the database to roll back to
-        the start of any pending transaction. Closing a connection without committing the changes first will
-        cause an implicit rollback to be performed.
-
-        If the database does not support the functionality required by the method, the interface should
-        throw an exception in case the method is used.
-        The preferred approach is to not implement the method and thus have Python generate
-        an AttributeError in case the method is requested. This allows the programmer to check for database
-        capabilities using the standard hasattr() function.
-
-        For some dynamically configured interfaces it may not be appropriate to require dynamically making
-        the method available. These interfaces should then raise a NotSupportedError to indicate the
-        non-ability to perform the roll back when the method is invoked.
-        """
-        self.messages = []
-        if (
-            self.transaction_level
-        ):  # trying to roll back with no open transaction causes an error
-            try:
-                self.transaction_level = self.connector.RollbackTrans()
-                if verbose > 1:
-                    print("rollback done on connection at %X" % id(self))
-                if not self._autocommit and not (
-                    self.connector.Attributes & adc.adXactAbortRetaining
-                ):
-                    # If attributes has adXactAbortRetaining it performs retaining aborts that is,
-                    # calling RollbackTrans automatically starts a new transaction. Not all providers support this.
-                    # If not, we will have to start a new transaction by this command:
-                    if (
-                        not self.transaction_level
-                    ):  # if self.transaction_level == 0 or self.transaction_level is None:
-                        self.transaction_level = self.connector.BeginTrans()
-            except Exception as e:
-                self._raiseConnectionError(api.ProgrammingError, e)
-
-    def __setattr__(self, name, value):
-        if name == "autocommit":  # extension: allow user to turn autocommit on or off
-            if self.supportsTransactions:
-                object.__setattr__(self, "_autocommit", bool(value))
-                try:
-                    self._rollback()  # must clear any outstanding transactions
-                except:
-                    pass
-            return
-        elif name == "paramstyle":
-            if value not in api.accepted_paramstyles:
-                self._raiseConnectionError(
-                    api.NotSupportedError,
-                    'paramstyle="%s" not in:%s'
-                    % (value, repr(api.accepted_paramstyles)),
-                )
-        elif name == "variantConversions":
-            value = copy.copy(
-                value
-            )  # make a new copy -- no changes in the default, please
-        object.__setattr__(self, name, value)
-
-    def __getattr__(self, item):
-        if (
-            item == "rollback"
-        ):  # the rollback method only appears if the database supports transactions
-            if self.supportsTransactions:
-                return (
-                    self._rollback
-                )  # return the rollback method so the caller can execute it.
-            else:
-                raise AttributeError("this data provider does not support Rollback")
-        elif item == "autocommit":
-            return self._autocommit
-        else:
-            raise AttributeError(
-                'no such attribute in ADO connection object as="%s"' % item
-            )
-
-    def cursor(self):
-        "Return a new Cursor Object using the connection."
-        self.messages = []
-        c = Cursor(self)
-        return c
-
-    def _i_am_here(self, crsr):
-        "message from a new cursor proclaiming its existence"
-        oid = id(crsr)
-        self.cursors[oid] = crsr
-
-    def _i_am_closing(self, crsr):
-        "message from a cursor giving connection a chance to clean up"
-        try:
-            del self.cursors[id(crsr)]
-        except:
-            pass
-
-    def printADOerrors(self):
-        j = self.connector.Errors.Count
-        if j:
-            print("ADO Errors:(%i)" % j)
-        for e in self.connector.Errors:
-            print("Description: %s" % e.Description)
-            print("Error: %s %s " % (e.Number, adc.adoErrors.get(e.Number, "unknown")))
-            if e.Number == adc.ado_error_TIMEOUT:
-                print(
-                    "Timeout Error: Try using adodbpi.connect(constr,timeout=Nseconds)"
-                )
-            print("Source: %s" % e.Source)
-            print("NativeError: %s" % e.NativeError)
-            print("SQL State: %s" % e.SQLState)
-
-    def _suggest_error_class(self):
-        """Introspect the current ADO Errors and determine an appropriate error class.
-
-        Error.SQLState is a SQL-defined error condition, per the SQL specification:
-        http://www.contrib.andrew.cmu.edu/~shadow/sql/sql1992.txt
-
-        The 23000 class of errors are integrity errors.
-        Error 40002 is a transactional integrity error.
-        """
-        if self.connector is not None:
-            for e in self.connector.Errors:
-                state = str(e.SQLState)
-                if state.startswith("23") or state == "40002":
-                    return api.IntegrityError
-        return api.DatabaseError
-
-    def __del__(self):
-        try:
-            self._closeAdoConnection()  # v2.1 Rose
-        except:
-            pass
-        self.connector = None
-
-    def __enter__(self):  # Connections are context managers
-        return self
-
-    def __exit__(self, exc_type, exc_val, exc_tb):
-        if exc_type:
-            self._rollback()  # automatic rollback on errors
-        else:
-            self.commit()
-
-    def get_table_names(self):
-        schema = self.connector.OpenSchema(20)  # constant = adSchemaTables
-
-        tables = []
-        while not schema.EOF:
-            name = getIndexedValue(schema.Fields, "TABLE_NAME").Value
-            tables.append(name)
-            schema.MoveNext()
-        del schema
-        return tables
-
-
-# # # # # ----- the Class that defines a cursor ----- # # # # #
-class Cursor(object):
-    ## ** api required attributes:
-    ## description...
-    ##    This read-only attribute is a sequence of 7-item sequences.
-    ##    Each of these sequences contains information describing one result column:
-    ##        (name, type_code, display_size, internal_size, precision, scale, null_ok).
-    ##    This attribute will be None for operations that do not return rows or if the
-    ##    cursor has not had an operation invoked via the executeXXX() method yet.
-    ##    The type_code can be interpreted by comparing it to the Type Objects specified in the section below.
-    ## rowcount...
-    ##    This read-only attribute specifies the number of rows that the last executeXXX() produced
-    ##    (for DQL statements like select) or affected (for DML statements like update or insert).
-    ##    The attribute is -1 in case no executeXXX() has been performed on the cursor or
-    ##    the rowcount of the last operation is not determinable by the interface.[7]
-    ## arraysize...
-    ##    This read/write attribute specifies the number of rows to fetch at a time with fetchmany().
-    ##    It defaults to 1 meaning to fetch a single row at a time.
-    ##    Implementations must observe this value with respect to the fetchmany() method,
-    ##    but are free to interact with the database a single row at a time.
-    ##    It may also be used in the implementation of executemany().
-    ## ** extension attributes:
-    ## paramstyle...
-    ##   allows the programmer to override the connection's default paramstyle
-    ## errorhandler...
-    ##   allows the programmer to override the connection's default error handler
-
-    def __init__(self, connection):
-        self.command = None
-        self._ado_prepared = False
-        self.messages = []
-        self.connection = connection
-        self.paramstyle = connection.paramstyle  # used for overriding the paramstyle
-        self._parameter_names = []
-        self.recordset_is_remote = False
-        self.rs = None  # the ADO recordset for this cursor
-        self.converters = []  # conversion function for each column
-        self.columnNames = {}  # names of columns {lowercase name : number,...}
-        self.numberOfColumns = 0
-        self._description = None
-        self.rowcount = -1
-        self.errorhandler = connection.errorhandler
-        self.arraysize = 1
-        connection._i_am_here(self)
-        if verbose:
-            print(
-                "%s New cursor at %X on conn %X"
-                % (version, id(self), id(self.connection))
-            )
-
-    def __iter__(self):  # [2.1 Zamarev]
-        return iter(self.fetchone, None)  # [2.1 Zamarev]
-
-    def prepare(self, operation):
-        self.command = operation
-        self._description = None
-        self._ado_prepared = "setup"
-
-    def __next__(self):
-        r = self.fetchone()
-        if r:
-            return r
-        raise StopIteration
-
-    def __enter__(self):
-        "Allow database cursors to be used with context managers."
-        return self
-
-    def __exit__(self, exc_type, exc_val, exc_tb):
-        "Allow database cursors to be used with context managers."
-        self.close()
-
-    def _raiseCursorError(self, errorclass, errorvalue):
-        eh = self.errorhandler
-        if eh is None:
-            eh = api.standardErrorHandler
-        eh(self.connection, self, errorclass, errorvalue)
-
-    def build_column_info(self, recordset):
-        self.converters = []  # convertion function for each column
-        self.columnNames = {}  # names of columns {lowercase name : number,...}
-        self._description = None
-
-        # if EOF and BOF are true at the same time, there are no records in the recordset
-        if (recordset is None) or (recordset.State == adc.adStateClosed):
-            self.rs = None
-            self.numberOfColumns = 0
-            return
-        self.rs = recordset  # v2.1.1 bkline
-        self.recordset_format = api.RS_ARRAY if api.onIronPython else api.RS_WIN_32
-        self.numberOfColumns = recordset.Fields.Count
-        try:
-            varCon = self.connection.variantConversions
-        except AttributeError:
-            varCon = api.variantConversions
-        for i in range(self.numberOfColumns):
-            f = getIndexedValue(self.rs.Fields, i)
-            try:
-                self.converters.append(
-                    varCon[f.Type]
-                )  # conversion function for this column
-            except KeyError:
-                self._raiseCursorError(
-                    api.InternalError, "Data column of Unknown ADO type=%s" % f.Type
-                )
-            self.columnNames[f.Name.lower()] = i  # columnNames lookup
-
-    def _makeDescriptionFromRS(self):
-        # Abort if closed or no recordset.
-        if self.rs is None:
-            self._description = None
-            return
-        desc = []
-        for i in range(self.numberOfColumns):
-            f = getIndexedValue(self.rs.Fields, i)
-            if self.rs.EOF or self.rs.BOF:
-                display_size = None
-            else:
-                display_size = (
-                    f.ActualSize
-                )  # TODO: Is this the correct defintion according to the DB API 2 Spec ?
-            null_ok = bool(f.Attributes & adc.adFldMayBeNull)  # v2.1 Cole
-            desc.append(
-                (
-                    f.Name,
-                    f.Type,
-                    display_size,
-                    f.DefinedSize,
-                    f.Precision,
-                    f.NumericScale,
-                    null_ok,
-                )
-            )
-        self._description = desc
-
-    def get_description(self):
-        if not self._description:
-            self._makeDescriptionFromRS()
-        return self._description
-
-    def __getattr__(self, item):
-        if item == "description":
-            return self.get_description()
-        object.__getattribute__(
-            self, item
-        )  # may get here on Remote attribute calls for existing attributes
-
-    def format_description(self, d):
-        """Format db_api description tuple for printing."""
-        if self.description is None:
-            self._makeDescriptionFromRS()
-        if isinstance(d, int):
-            d = self.description[d]
-        desc = (
-            "Name= %s, Type= %s, DispSize= %s, IntSize= %s, Precision= %s, Scale= %s NullOK=%s"
-            % (
-                d[0],
-                adc.adTypeNames.get(d[1], str(d[1]) + " (unknown type)"),
-                d[2],
-                d[3],
-                d[4],
-                d[5],
-                d[6],
-            )
-        )
-        return desc
-
-    def close(self, dont_tell_me=False):
-        """Close the cursor now (rather than whenever __del__ is called).
-        The cursor will be unusable from this point forward; an Error (or subclass)
-        exception will be raised if any operation is attempted with the cursor.
-        """
-        if self.connection is None:
-            return
-        self.messages = []
-        if (
-            self.rs and self.rs.State != adc.adStateClosed
-        ):  # rs exists and is open      #v2.1 Rose
-            self.rs.Close()  # v2.1 Rose
-            self.rs = None  # let go of the recordset so ADO will let it be disposed #v2.1 Rose
-        if not dont_tell_me:
-            self.connection._i_am_closing(
-                self
-            )  # take me off the connection's cursors list
-        self.connection = (
-            None  # this will make all future method calls on me throw an exception
-        )
-        if verbose:
-            print("adodbapi Closed cursor at %X" % id(self))
-
-    def __del__(self):
-        try:
-            self.close()
-        except:
-            pass
-
-    def _new_command(self, command_type=adc.adCmdText):
-        self.cmd = None
-        self.messages = []
-
-        if self.connection is None:
-            self._raiseCursorError(api.InterfaceError, None)
-            return
-        try:
-            self.cmd = Dispatch("ADODB.Command")
-            self.cmd.ActiveConnection = self.connection.connector
-            self.cmd.CommandTimeout = self.connection.timeout
-            self.cmd.CommandType = command_type
-            self.cmd.CommandText = self.commandText
-            self.cmd.Prepared = bool(self._ado_prepared)
-        except:
-            self._raiseCursorError(
-                api.DatabaseError,
-                'Error creating new ADODB.Command object for "%s"'
-                % repr(self.commandText),
-            )
-
-    def _execute_command(self):
-        # Stored procedures may have an integer return value
-        self.return_value = None
-        recordset = None
-        count = -1  # default value
-        if verbose:
-            print('Executing command="%s"' % self.commandText)
-        try:
-            # ----- the actual SQL is executed here ---
-            if api.onIronPython:
-                ra = Reference[int]()
-                recordset = self.cmd.Execute(ra)
-                count = ra.Value
-            else:  # pywin32
-                recordset, count = self.cmd.Execute()
-            # ----- ------------------------------- ---
-        except Exception as e:
-            _message = ""
-            if hasattr(e, "args"):
-                _message += str(e.args) + "\n"
-            _message += "Command:\n%s\nParameters:\n%s" % (
-                self.commandText,
-                format_parameters(self.cmd.Parameters, True),
-            )
-            klass = self.connection._suggest_error_class()
-            self._raiseCursorError(klass, _message)
-        try:
-            self.rowcount = recordset.RecordCount
-        except:
-            self.rowcount = count
-        self.build_column_info(recordset)
-
-        # The ADO documentation hints that obtaining the recordcount may be timeconsuming
-        #   "If the Recordset object does not support approximate positioning, this property
-        #    may be a significant drain on resources # [ekelund]
-        # Therefore, COM will not return rowcount for server-side cursors. [Cole]
-        # Client-side cursors (the default since v2.8) will force a static
-        # cursor, and rowcount will then be set accurately [Cole]
-
-    def get_rowcount(self):
-        return self.rowcount
-
-    def get_returned_parameters(self):
-        """with some providers, returned parameters and the .return_value are not available until
-        after the last recordset has been read.  In that case, you must coll nextset() until it
-        returns None, then call this method to get your returned information."""
-
-        retLst = (
-            []
-        )  # store procedures may return altered parameters, including an added "return value" item
-        for p in tuple(self.cmd.Parameters):
-            if verbose > 2:
-                print(
-                    'Returned=Name: %s, Dir.: %s, Type: %s, Size: %s, Value: "%s",'
-                    " Precision: %s, NumericScale: %s"
-                    % (
-                        p.Name,
-                        adc.directions[p.Direction],
-                        adc.adTypeNames.get(p.Type, str(p.Type) + " (unknown type)"),
-                        p.Size,
-                        p.Value,
-                        p.Precision,
-                        p.NumericScale,
-                    )
-                )
-            pyObject = api.convert_to_python(p.Value, api.variantConversions[p.Type])
-            if p.Direction == adc.adParamReturnValue:
-                self.returnValue = (
-                    pyObject  # also load the undocumented attribute (Vernon's Error!)
-                )
-                self.return_value = pyObject
-            else:
-                retLst.append(pyObject)
-        return retLst  # return the parameter list to the caller
-
-    def callproc(self, procname, parameters=None):
-        """Call a stored database procedure with the given name.
-        The sequence of parameters must contain one entry for each
-        argument that the sproc expects. The result of the
-        call is returned as modified copy of the input
-        sequence.  Input parameters are left untouched, output and
-        input/output parameters replaced with possibly new values.
-
-        The sproc may also provide a result set as output,
-        which is available through the standard .fetch*() methods.
-        Extension: A "return_value" property may be set on the
-        cursor if the sproc defines an integer return value.
-        """
-        self._parameter_names = []
-        self.commandText = procname
-        self._new_command(command_type=adc.adCmdStoredProc)
-        self._buildADOparameterList(parameters, sproc=True)
-        if verbose > 2:
-            print(
-                "Calling Stored Proc with Params=",
-                format_parameters(self.cmd.Parameters, True),
-            )
-        self._execute_command()
-        return self.get_returned_parameters()
-
-    def _reformat_operation(self, operation, parameters):
-        if self.paramstyle in ("format", "pyformat"):  # convert %s to ?
-            operation, self._parameter_names = api.changeFormatToQmark(operation)
-        elif self.paramstyle == "named" or (
-            self.paramstyle == "dynamic" and isinstance(parameters, Mapping)
-        ):
-            operation, self._parameter_names = api.changeNamedToQmark(
-                operation
-            )  # convert :name to ?
-        return operation
-
-    def _buildADOparameterList(self, parameters, sproc=False):
-        self.parameters = parameters
-        if parameters is None:
-            parameters = []
-
-        # Note: ADO does not preserve the parameter list, even if "Prepared" is True, so we must build every time.
-        parameters_known = False
-        if sproc:  # needed only if we are calling a stored procedure
-            try:  # attempt to use ADO's parameter list
-                self.cmd.Parameters.Refresh()
-                if verbose > 2:
-                    print(
-                        "ADO detected Params=",
-                        format_parameters(self.cmd.Parameters, True),
-                    )
-                    print("Program Parameters=", repr(parameters))
-                parameters_known = True
-            except api.Error:
-                if verbose:
-                    print("ADO Parameter Refresh failed")
-                pass
-            else:
-                if len(parameters) != self.cmd.Parameters.Count - 1:
-                    raise api.ProgrammingError(
-                        "You must supply %d parameters for this stored procedure"
-                        % (self.cmd.Parameters.Count - 1)
-                    )
-        if sproc or parameters != []:
-            i = 0
-            if parameters_known:  # use ado parameter list
-                if self._parameter_names:  # named parameters
-                    for i, pm_name in enumerate(self._parameter_names):
-                        p = getIndexedValue(self.cmd.Parameters, i)
-                        try:
-                            _configure_parameter(
-                                p, parameters[pm_name], p.Type, parameters_known
-                            )
-                        except Exception as e:
-                            _message = (
-                                "Error Converting Parameter %s: %s, %s <- %s\n"
-                                % (
-                                    p.Name,
-                                    adc.ado_type_name(p.Type),
-                                    p.Value,
-                                    repr(parameters[pm_name]),
-                                )
-                            )
-                            self._raiseCursorError(
-                                api.DataError, _message + "->" + repr(e.args)
-                            )
-                else:  # regular sequence of parameters
-                    for value in parameters:
-                        p = getIndexedValue(self.cmd.Parameters, i)
-                        if (
-                            p.Direction == adc.adParamReturnValue
-                        ):  # this is an extra parameter added by ADO
-                            i += 1  # skip the extra
-                            p = getIndexedValue(self.cmd.Parameters, i)
-                        try:
-                            _configure_parameter(p, value, p.Type, parameters_known)
-                        except Exception as e:
-                            _message = (
-                                "Error Converting Parameter %s: %s, %s <- %s\n"
-                                % (
-                                    p.Name,
-                                    adc.ado_type_name(p.Type),
-                                    p.Value,
-                                    repr(value),
-                                )
-                            )
-                            self._raiseCursorError(
-                                api.DataError, _message + "->" + repr(e.args)
-                            )
-                        i += 1
-            else:  # -- build own parameter list
-                if (
-                    self._parameter_names
-                ):  # we expect a dictionary of parameters, this is the list of expected names
-                    for parm_name in self._parameter_names:
-                        elem = parameters[parm_name]
-                        adotype = api.pyTypeToADOType(elem)
-                        p = self.cmd.CreateParameter(
-                            parm_name, adotype, adc.adParamInput
-                        )
-                        _configure_parameter(p, elem, adotype, parameters_known)
-                        try:
-                            self.cmd.Parameters.Append(p)
-                        except Exception as e:
-                            _message = "Error Building Parameter %s: %s, %s <- %s\n" % (
-                                p.Name,
-                                adc.ado_type_name(p.Type),
-                                p.Value,
-                                repr(elem),
-                            )
-                            self._raiseCursorError(
-                                api.DataError, _message + "->" + repr(e.args)
-                            )
-                else:  # expecting the usual sequence of parameters
-                    if sproc:
-                        p = self.cmd.CreateParameter(
-                            "@RETURN_VALUE", adc.adInteger, adc.adParamReturnValue
-                        )
-                        self.cmd.Parameters.Append(p)
-
-                    for elem in parameters:
-                        name = "p%i" % i
-                        adotype = api.pyTypeToADOType(elem)
-                        p = self.cmd.CreateParameter(
-                            name, adotype, adc.adParamInput
-                        )  # Name, Type, Direction, Size, Value
-                        _configure_parameter(p, elem, adotype, parameters_known)
-                        try:
-                            self.cmd.Parameters.Append(p)
-                        except Exception as e:
-                            _message = "Error Building Parameter %s: %s, %s <- %s\n" % (
-                                p.Name,
-                                adc.ado_type_name(p.Type),
-                                p.Value,
-                                repr(elem),
-                            )
-                            self._raiseCursorError(
-                                api.DataError, _message + "->" + repr(e.args)
-                            )
-                        i += 1
-                if self._ado_prepared == "setup":
-                    self._ado_prepared = (
-                        True  # parameters will be "known" by ADO next loop
-                    )
-
-    def execute(self, operation, parameters=None):
-        """Prepare and execute a database operation (query or command).
-
-        Parameters may be provided as sequence or mapping and will be bound to variables in the operation.
-        Variables are specified in a database-specific notation
-        (see the module's paramstyle attribute for details). [5]
-        A reference to the operation will be retained by the cursor.
-        If the same operation object is passed in again, then the cursor
-        can optimize its behavior. This is most effective for algorithms
-        where the same operation is used, but different parameters are bound to it (many times).
-
-        For maximum efficiency when reusing an operation, it is best to use
-        the setinputsizes() method to specify the parameter types and sizes ahead of time.
-        It is legal for a parameter to not match the predefined information;
-        the implementation should compensate, possibly with a loss of efficiency.
-
-        The parameters may also be specified as list of tuples to e.g. insert multiple rows in
-        a single operation, but this kind of usage is depreciated: executemany() should be used instead.
-
-        Return value is not defined.
-
-        [5] The module will use the __getitem__ method of the parameters object to map either positions
-        (integers) or names (strings) to parameter values. This allows for both sequences and mappings
-        to be used as input.
-        The term "bound" refers to the process of binding an input value to a database execution buffer.
-        In practical terms, this means that the input value is directly used as a value in the operation.
-        The client should not be required to "escape" the value so that it can be used -- the value
-        should be equal to the actual database value."""
-        if (
-            self.command is not operation
-            or self._ado_prepared == "setup"
-            or not hasattr(self, "commandText")
-        ):
-            if self.command is not operation:
-                self._ado_prepared = False
-                self.command = operation
-            self._parameter_names = []
-            self.commandText = (
-                operation
-                if (self.paramstyle == "qmark" or not parameters)
-                else self._reformat_operation(operation, parameters)
-            )
-        self._new_command()
-        self._buildADOparameterList(parameters)
-        if verbose > 3:
-            print("Params=", format_parameters(self.cmd.Parameters, True))
-        self._execute_command()
-
-    def executemany(self, operation, seq_of_parameters):
-        """Prepare a database operation (query or command)
-        and then execute it against all parameter sequences or mappings found in the sequence seq_of_parameters.
-
-            Return values are not defined.
-        """
-        self.messages = list()
-        total_recordcount = 0
-
-        self.prepare(operation)
-        for params in seq_of_parameters:
-            self.execute(self.command, params)
-            if self.rowcount == -1:
-                total_recordcount = -1
-            if total_recordcount != -1:
-                total_recordcount += self.rowcount
-        self.rowcount = total_recordcount
-
-    def _fetch(self, limit=None):
-        """Fetch rows from the current recordset.
-
-        limit -- Number of rows to fetch, or None (default) to fetch all rows.
-        """
-        if self.connection is None or self.rs is None:
-            self._raiseCursorError(
-                api.FetchFailedError, "fetch() on closed connection or empty query set"
-            )
-            return
-
-        if self.rs.State == adc.adStateClosed or self.rs.BOF or self.rs.EOF:
-            return list()
-        if limit:  # limit number of rows retrieved
-            ado_results = self.rs.GetRows(limit)
-        else:  # get all rows
-            ado_results = self.rs.GetRows()
-        if (
-            self.recordset_format == api.RS_ARRAY
-        ):  # result of GetRows is a two-dimension array
-            length = (
-                len(ado_results) // self.numberOfColumns
-            )  # length of first dimension
-        else:  # pywin32
-            length = len(ado_results[0])  # result of GetRows is tuples in a tuple
-        fetchObject = api.SQLrows(
-            ado_results, length, self
-        )  # new object to hold the results of the fetch
-        return fetchObject
-
-    def fetchone(self):
-        """Fetch the next row of a query result set, returning a single sequence,
-        or None when no more data is available.
-
-        An Error (or subclass) exception is raised if the previous call to executeXXX()
-        did not produce any result set or no call was issued yet.
-        """
-        self.messages = []
-        result = self._fetch(1)
-        if result:  # return record (not list of records)
-            return result[0]
-        return None
-
-    def fetchmany(self, size=None):
-        """Fetch the next set of rows of a query result, returning a list of tuples. An empty sequence is returned when no more rows are available.
-
-        The number of rows to fetch per call is specified by the parameter.
-        If it is not given, the cursor's arraysize determines the number of rows to be fetched.
-        The method should try to fetch as many rows as indicated by the size parameter.
-        If this is not possible due to the specified number of rows not being available,
-        fewer rows may be returned.
-
-        An Error (or subclass) exception is raised if the previous call to executeXXX()
-        did not produce any result set or no call was issued yet.
-
-        Note there are performance considerations involved with the size parameter.
-        For optimal performance, it is usually best to use the arraysize attribute.
-        If the size parameter is used, then it is best for it to retain the same value from
-        one fetchmany() call to the next.
-        """
-        self.messages = []
-        if size is None:
-            size = self.arraysize
-        return self._fetch(size)
-
-    def fetchall(self):
-        """Fetch all (remaining) rows of a query result, returning them as a sequence of sequences (e.g. a list of tuples).
-
-        Note that the cursor's arraysize attribute
-        can affect the performance of this operation.
-        An Error (or subclass) exception is raised if the previous call to executeXXX()
-        did not produce any result set or no call was issued yet.
-        """
-        self.messages = []
-        return self._fetch()
-
-    def nextset(self):
-        """Skip to the next available recordset, discarding any remaining rows from the current recordset.
-
-        If there are no more sets, the method returns None. Otherwise, it returns a true
-        value and subsequent calls to the fetch methods will return rows from the next result set.
-
-        An Error (or subclass) exception is raised if the previous call to executeXXX()
-        did not produce any result set or no call was issued yet.
-        """
-        self.messages = []
-        if self.connection is None or self.rs is None:
-            self._raiseCursorError(
-                api.OperationalError,
-                ("nextset() on closed connection or empty query set"),
-            )
-            return None
-
-        if api.onIronPython:
-            try:
-                recordset = self.rs.NextRecordset()
-            except TypeError:
-                recordset = None
-            except api.Error as exc:
-                self._raiseCursorError(api.NotSupportedError, exc.args)
-        else:  # pywin32
-            try:  # [begin 2.1 ekelund]
-                rsTuple = self.rs.NextRecordset()  #
-            except pywintypes.com_error as exc:  # return appropriate error
-                self._raiseCursorError(
-                    api.NotSupportedError, exc.args
-                )  # [end 2.1 ekelund]
-            recordset = rsTuple[0]
-        if recordset is None:
-            return None
-        self.build_column_info(recordset)
-        return True
-
-    def setinputsizes(self, sizes):
-        pass
-
-    def setoutputsize(self, size, column=None):
-        pass
-
-    def _last_query(self):  # let the programmer see what query we actually used
-        try:
-            if self.parameters == None:
-                ret = self.commandText
-            else:
-                ret = "%s,parameters=%s" % (self.commandText, repr(self.parameters))
-        except:
-            ret = None
-        return ret
-
-    query = property(_last_query, None, None, "returns the last query executed")
-
-
-if __name__ == "__main__":
-    raise api.ProgrammingError(version + " cannot be run as a main program.")
diff --git a/lib/adodbapi/apibase.py b/lib/adodbapi/apibase.py
deleted file mode 100644
index a56cd4b6..00000000
--- a/lib/adodbapi/apibase.py
+++ /dev/null
@@ -1,794 +0,0 @@
-"""adodbapi.apibase - A python DB API 2.0 (PEP 249) interface to Microsoft ADO
-
-Copyright (C) 2002 Henrik Ekelund, version 2.1 by Vernon Cole
-* http://sourceforge.net/projects/pywin32
-* http://sourceforge.net/projects/adodbapi
-"""
-
-import datetime
-import decimal
-import numbers
-import sys
-import time
-
-# noinspection PyUnresolvedReferences
-from . import ado_consts as adc
-
-verbose = False  # debugging flag
-
-onIronPython = sys.platform == "cli"
-if onIronPython:  # we need type definitions for odd data we may need to convert
-    # noinspection PyUnresolvedReferences
-    from System import DateTime, DBNull
-
-    NullTypes = (type(None), DBNull)
-else:
-    DateTime = type(NotImplemented)  # should never be seen on win32
-    NullTypes = type(None)
-
-# --- define objects to smooth out Python3 <-> Python 2.x differences
-unicodeType = str
-longType = int
-StringTypes = str
-makeByteBuffer = bytes
-memoryViewType = memoryview
-_BaseException = Exception
-
-try:  # jdhardy -- handle bytes under IronPython & Py3
-    bytes
-except NameError:
-    bytes = str  # define it for old Pythons
-
-
-# ------- Error handlers ------
-def standardErrorHandler(connection, cursor, errorclass, errorvalue):
-    err = (errorclass, errorvalue)
-    try:
-        connection.messages.append(err)
-    except:
-        pass
-    if cursor is not None:
-        try:
-            cursor.messages.append(err)
-        except:
-            pass
-    raise errorclass(errorvalue)
-
-
-# Note: _BaseException is defined differently between Python 2.x and 3.x
-class Error(_BaseException):
-    pass  # Exception that is the base class of all other error
-    # exceptions. You can use this to catch all errors with one
-    # single 'except' statement. Warnings are not considered
-    # errors and thus should not use this class as base. It must
-    # be a subclass of the Python StandardError (defined in the
-    # module exceptions).
-
-
-class Warning(_BaseException):
-    pass
-
-
-class InterfaceError(Error):
-    pass
-
-
-class DatabaseError(Error):
-    pass
-
-
-class InternalError(DatabaseError):
-    pass
-
-
-class OperationalError(DatabaseError):
-    pass
-
-
-class ProgrammingError(DatabaseError):
-    pass
-
-
-class IntegrityError(DatabaseError):
-    pass
-
-
-class DataError(DatabaseError):
-    pass
-
-
-class NotSupportedError(DatabaseError):
-    pass
-
-
-class FetchFailedError(OperationalError):
-    """
-    Error is used by RawStoredProcedureQuerySet to determine when a fetch
-    failed due to a connection being closed or there is no record set
-    returned. (Non-standard, added especially for django)
-    """
-
-    pass
-
-
-# # # # # ----- Type Objects and Constructors ----- # # # # #
-# Many databases need to have the input in a particular format for binding to an operation's input parameters.
-# For example, if an input is destined for a DATE column, then it must be bound to the database in a particular
-# string format. Similar problems exist for "Row ID" columns or large binary items (e.g. blobs or RAW columns).
-# This presents problems for Python since the parameters to the executeXXX() method are untyped.
-# When the database module sees a Python string object, it doesn't know if it should be bound as a simple CHAR
-# column, as a raw BINARY item, or as a DATE.
-#
-# To overcome this problem, a module must provide the constructors defined below to create objects that can
-# hold special values. When passed to the cursor methods, the module can then detect the proper type of
-# the input parameter and bind it accordingly.
-
-# A Cursor Object's description attribute returns information about each of the result columns of a query.
-# The type_code must compare equal to one of Type Objects defined below. Type Objects may be equal to more than
-# one type code (e.g. DATETIME could be equal to the type codes for date, time and timestamp columns;
-# see the Implementation Hints below for details).
-
-# SQL NULL values are represented by the Python None singleton on input and output.
-
-# Note: Usage of Unix ticks for database interfacing can cause troubles because of the limited date range they cover.
-
-
-# def Date(year,month,day):
-#     "This function constructs an object holding a date value. "
-#     return dateconverter.date(year,month,day)  #dateconverter.Date(year,month,day)
-#
-# def Time(hour,minute,second):
-#     "This function constructs an object holding a time value. "
-#     return dateconverter.time(hour, minute, second) # dateconverter.Time(hour,minute,second)
-#
-# def Timestamp(year,month,day,hour,minute,second):
-#     "This function constructs an object holding a time stamp value. "
-#     return dateconverter.datetime(year,month,day,hour,minute,second)
-#
-# def DateFromTicks(ticks):
-#     """This function constructs an object holding a date value from the given ticks value
-#     (number of seconds since the epoch; see the documentation of the standard Python time module for details). """
-#     return Date(*time.gmtime(ticks)[:3])
-#
-# def TimeFromTicks(ticks):
-#     """This function constructs an object holding a time value from the given ticks value
-#     (number of seconds since the epoch; see the documentation of the standard Python time module for details). """
-#     return Time(*time.gmtime(ticks)[3:6])
-#
-# def TimestampFromTicks(ticks):
-#     """This function constructs an object holding a time stamp value from the given
-#     ticks value (number of seconds since the epoch;
-#     see the documentation of the standard Python time module for details). """
-#     return Timestamp(*time.gmtime(ticks)[:6])
-#
-# def Binary(aString):
-#     """This function constructs an object capable of holding a binary (long) string value. """
-#     b = makeByteBuffer(aString)
-#     return b
-# -----     Time converters ----------------------------------------------
-class TimeConverter(object):  # this is a generic time converter skeleton
-    def __init__(self):  # the details will be filled in by instances
-        self._ordinal_1899_12_31 = datetime.date(1899, 12, 31).toordinal() - 1
-        # Use cls.types to compare if an input parameter is a datetime
-        self.types = {
-            type(self.Date(2000, 1, 1)),
-            type(self.Time(12, 1, 1)),
-            type(self.Timestamp(2000, 1, 1, 12, 1, 1)),
-            datetime.datetime,
-            datetime.time,
-            datetime.date,
-        }
-
-    def COMDate(self, obj):
-        """Returns a ComDate from a date-time"""
-        try:  # most likely a datetime
-            tt = obj.timetuple()
-
-            try:
-                ms = obj.microsecond
-            except:
-                ms = 0
-            return self.ComDateFromTuple(tt, ms)
-        except:  # might be a tuple
-            try:
-                return self.ComDateFromTuple(obj)
-            except:  # try an mxdate
-                try:
-                    return obj.COMDate()
-                except:
-                    raise ValueError('Cannot convert "%s" to COMdate.' % repr(obj))
-
-    def ComDateFromTuple(self, t, microseconds=0):
-        d = datetime.date(t[0], t[1], t[2])
-        integerPart = d.toordinal() - self._ordinal_1899_12_31
-        ms = (t[3] * 3600 + t[4] * 60 + t[5]) * 1000000 + microseconds
-        fractPart = float(ms) / 86400000000.0
-        return integerPart + fractPart
-
-    def DateObjectFromCOMDate(self, comDate):
-        "Returns an object of the wanted type from a ComDate"
-        raise NotImplementedError  # "Abstract class"
-
-    def Date(self, year, month, day):
-        "This function constructs an object holding a date value."
-        raise NotImplementedError  # "Abstract class"
-
-    def Time(self, hour, minute, second):
-        "This function constructs an object holding a time value."
-        raise NotImplementedError  # "Abstract class"
-
-    def Timestamp(self, year, month, day, hour, minute, second):
-        "This function constructs an object holding a time stamp value."
-        raise NotImplementedError  # "Abstract class"
-        # all purpose date to ISO format converter
-
-    def DateObjectToIsoFormatString(self, obj):
-        "This function should return a string in the format 'YYYY-MM-dd HH:MM:SS:ms' (ms optional)"
-        try:  # most likely, a datetime.datetime
-            s = obj.isoformat(" ")
-        except (TypeError, AttributeError):
-            if isinstance(obj, datetime.date):
-                s = obj.isoformat() + " 00:00:00"  # return exact midnight
-            else:
-                try:  # maybe it has a strftime method, like mx
-                    s = obj.strftime("%Y-%m-%d %H:%M:%S")
-                except AttributeError:
-                    try:  # but may be time.struct_time
-                        s = time.strftime("%Y-%m-%d %H:%M:%S", obj)
-                    except:
-                        raise ValueError('Cannot convert "%s" to isoformat' % repr(obj))
-        return s
-
-
-# -- Optional: if mx extensions are installed you may use mxDateTime ----
-try:
-    import mx.DateTime
-
-    mxDateTime = True
-except:
-    mxDateTime = False
-if mxDateTime:
-
-    class mxDateTimeConverter(TimeConverter):  # used optionally if installed
-        def __init__(self):
-            TimeConverter.__init__(self)
-            self.types.add(type(mx.DateTime))
-
-        def DateObjectFromCOMDate(self, comDate):
-            return mx.DateTime.DateTimeFromCOMDate(comDate)
-
-        def Date(self, year, month, day):
-            return mx.DateTime.Date(year, month, day)
-
-        def Time(self, hour, minute, second):
-            return mx.DateTime.Time(hour, minute, second)
-
-        def Timestamp(self, year, month, day, hour, minute, second):
-            return mx.DateTime.Timestamp(year, month, day, hour, minute, second)
-
-else:
-
-    class mxDateTimeConverter(TimeConverter):
-        pass  # if no mx is installed
-
-
-class pythonDateTimeConverter(TimeConverter):  # standard since Python 2.3
-    def __init__(self):
-        TimeConverter.__init__(self)
-
-    def DateObjectFromCOMDate(self, comDate):
-        if isinstance(comDate, datetime.datetime):
-            odn = comDate.toordinal()
-            tim = comDate.time()
-            new = datetime.datetime.combine(datetime.datetime.fromordinal(odn), tim)
-            return new
-            # return comDate.replace(tzinfo=None) # make non aware
-        elif isinstance(comDate, DateTime):
-            fComDate = comDate.ToOADate()  # ironPython clr Date/Time
-        else:
-            fComDate = float(comDate)  # ComDate is number of days since 1899-12-31
-        integerPart = int(fComDate)
-        floatpart = fComDate - integerPart
-        ##if floatpart == 0.0:
-        ##    return datetime.date.fromordinal(integerPart + self._ordinal_1899_12_31)
-        dte = datetime.datetime.fromordinal(
-            integerPart + self._ordinal_1899_12_31
-        ) + datetime.timedelta(milliseconds=floatpart * 86400000)
-        # millisecondsperday=86400000 # 24*60*60*1000
-        return dte
-
-    def Date(self, year, month, day):
-        return datetime.date(year, month, day)
-
-    def Time(self, hour, minute, second):
-        return datetime.time(hour, minute, second)
-
-    def Timestamp(self, year, month, day, hour, minute, second):
-        return datetime.datetime(year, month, day, hour, minute, second)
-
-
-class pythonTimeConverter(TimeConverter):  # the old, ?nix type date and time
-    def __init__(self):  # caution: this Class gets confised by timezones and DST
-        TimeConverter.__init__(self)
-        self.types.add(time.struct_time)
-
-    def DateObjectFromCOMDate(self, comDate):
-        "Returns ticks since 1970"
-        if isinstance(comDate, datetime.datetime):
-            return comDate.timetuple()
-        elif isinstance(comDate, DateTime):  # ironPython clr date/time
-            fcomDate = comDate.ToOADate()
-        else:
-            fcomDate = float(comDate)
-        secondsperday = 86400  # 24*60*60
-        # ComDate is number of days since 1899-12-31, gmtime epoch is 1970-1-1 = 25569 days
-        t = time.gmtime(secondsperday * (fcomDate - 25569.0))
-        return t  # year,month,day,hour,minute,second,weekday,julianday,daylightsaving=t
-
-    def Date(self, year, month, day):
-        return self.Timestamp(year, month, day, 0, 0, 0)
-
-    def Time(self, hour, minute, second):
-        return time.gmtime((hour * 60 + minute) * 60 + second)
-
-    def Timestamp(self, year, month, day, hour, minute, second):
-        return time.localtime(
-            time.mktime((year, month, day, hour, minute, second, 0, 0, -1))
-        )
-
-
-base_dateconverter = pythonDateTimeConverter()
-
-# ------ DB API required module attributes ---------------------
-threadsafety = 1  # TODO -- find out whether this module is actually BETTER than 1.
-
-apilevel = "2.0"  # String constant stating the supported DB API level.
-
-paramstyle = "qmark"  # the default parameter style
-
-# ------ control for an extension which may become part of DB API 3.0 ---
-accepted_paramstyles = ("qmark", "named", "format", "pyformat", "dynamic")
-
-# ------------------------------------------------------------------------------------------
-# define similar types for generic conversion routines
-adoIntegerTypes = (
-    adc.adInteger,
-    adc.adSmallInt,
-    adc.adTinyInt,
-    adc.adUnsignedInt,
-    adc.adUnsignedSmallInt,
-    adc.adUnsignedTinyInt,
-    adc.adBoolean,
-    adc.adError,
-)  # max 32 bits
-adoRowIdTypes = (adc.adChapter,)  # v2.1 Rose
-adoLongTypes = (adc.adBigInt, adc.adFileTime, adc.adUnsignedBigInt)
-adoExactNumericTypes = (
-    adc.adDecimal,
-    adc.adNumeric,
-    adc.adVarNumeric,
-    adc.adCurrency,
-)  # v2.3 Cole
-adoApproximateNumericTypes = (adc.adDouble, adc.adSingle)  # v2.1 Cole
-adoStringTypes = (
-    adc.adBSTR,
-    adc.adChar,
-    adc.adLongVarChar,
-    adc.adLongVarWChar,
-    adc.adVarChar,
-    adc.adVarWChar,
-    adc.adWChar,
-)
-adoBinaryTypes = (adc.adBinary, adc.adLongVarBinary, adc.adVarBinary)
-adoDateTimeTypes = (adc.adDBTime, adc.adDBTimeStamp, adc.adDate, adc.adDBDate)
-adoRemainingTypes = (
-    adc.adEmpty,
-    adc.adIDispatch,
-    adc.adIUnknown,
-    adc.adPropVariant,
-    adc.adArray,
-    adc.adUserDefined,
-    adc.adVariant,
-    adc.adGUID,
-)
-
-
-# this class is a trick to determine whether a type is a member of a related group of types. see PEP notes
-class DBAPITypeObject(object):
-    def __init__(self, valuesTuple):
-        self.values = frozenset(valuesTuple)
-
-    def __eq__(self, other):
-        return other in self.values
-
-    def __ne__(self, other):
-        return other not in self.values
-
-
-"""This type object is used to describe columns in a database that are string-based (e.g. CHAR). """
-STRING = DBAPITypeObject(adoStringTypes)
-
-"""This type object is used to describe (long) binary columns in a database (e.g. LONG, RAW, BLOBs). """
-BINARY = DBAPITypeObject(adoBinaryTypes)
-
-"""This type object is used to describe numeric columns in a database. """
-NUMBER = DBAPITypeObject(
-    adoIntegerTypes + adoLongTypes + adoExactNumericTypes + adoApproximateNumericTypes
-)
-
-"""This type object is used to describe date/time columns in a database. """
-
-DATETIME = DBAPITypeObject(adoDateTimeTypes)
-"""This type object is used to describe the "Row ID" column in a database. """
-ROWID = DBAPITypeObject(adoRowIdTypes)
-
-OTHER = DBAPITypeObject(adoRemainingTypes)
-
-# ------- utilities for translating python data types to ADO data types ---------------------------------
-typeMap = {
-    memoryViewType: adc.adVarBinary,
-    float: adc.adDouble,
-    type(None): adc.adEmpty,
-    str: adc.adBSTR,
-    bool: adc.adBoolean,  # v2.1 Cole
-    decimal.Decimal: adc.adDecimal,
-    int: adc.adBigInt,
-    bytes: adc.adVarBinary,
-}
-
-
-def pyTypeToADOType(d):
-    tp = type(d)
-    try:
-        return typeMap[tp]
-    except KeyError:  #   The type was not defined in the pre-computed Type table
-        from . import dateconverter
-
-        if (
-            tp in dateconverter.types
-        ):  # maybe it is one of our supported Date/Time types
-            return adc.adDate
-        #  otherwise, attempt to discern the type by probing the data object itself -- to handle duck typing
-        if isinstance(d, StringTypes):
-            return adc.adBSTR
-        if isinstance(d, numbers.Integral):
-            return adc.adBigInt
-        if isinstance(d, numbers.Real):
-            return adc.adDouble
-        raise DataError('cannot convert "%s" (type=%s) to ADO' % (repr(d), tp))
-
-
-# # # # # # # # # # # # - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-# functions to convert database values to Python objects
-# ------------------------------------------------------------------------
-# variant type : function converting variant to Python value
-def variantConvertDate(v):
-    from . import dateconverter  # this function only called when adodbapi is running
-
-    return dateconverter.DateObjectFromCOMDate(v)
-
-
-def cvtString(variant):  # use to get old action of adodbapi v1 if desired
-    if onIronPython:
-        try:
-            return variant.ToString()
-        except:
-            pass
-    return str(variant)
-
-
-def cvtDecimal(variant):  # better name
-    return _convertNumberWithCulture(variant, decimal.Decimal)
-
-
-def cvtNumeric(variant):  # older name - don't break old code
-    return cvtDecimal(variant)
-
-
-def cvtFloat(variant):
-    return _convertNumberWithCulture(variant, float)
-
-
-def _convertNumberWithCulture(variant, f):
-    try:
-        return f(variant)
-    except (ValueError, TypeError, decimal.InvalidOperation):
-        try:
-            europeVsUS = str(variant).replace(",", ".")
-            return f(europeVsUS)
-        except (ValueError, TypeError, decimal.InvalidOperation):
-            pass
-
-
-def cvtInt(variant):
-    return int(variant)
-
-
-def cvtLong(variant):  # only important in old versions where long and int differ
-    return int(variant)
-
-
-def cvtBuffer(variant):
-    return bytes(variant)
-
-
-def cvtUnicode(variant):
-    return str(variant)
-
-
-def identity(x):
-    return x
-
-
-def cvtUnusual(variant):
-    if verbose > 1:
-        sys.stderr.write("Conversion called for Unusual data=%s\n" % repr(variant))
-    if isinstance(variant, DateTime):  # COMdate or System.Date
-        from .adodbapi import (  # this will only be called when adodbapi is in use, and very rarely
-            dateconverter,
-        )
-
-        return dateconverter.DateObjectFromCOMDate(variant)
-    return variant  # cannot find conversion function -- just give the data to the user
-
-
-def convert_to_python(variant, func):  # convert DB value into Python value
-    if isinstance(variant, NullTypes):  # IronPython Null or None
-        return None
-    return func(variant)  # call the appropriate conversion function
-
-
-class MultiMap(dict):  # builds a dictionary from {(sequence,of,keys) : function}
-    """A dictionary of ado.type : function -- but you can set multiple items by passing a sequence of keys"""
-
-    # useful for defining conversion functions for groups of similar data types.
-    def __init__(self, aDict):
-        for k, v in list(aDict.items()):
-            self[k] = v  # we must call __setitem__
-
-    def __setitem__(self, adoType, cvtFn):
-        "set a single item, or a whole sequence of items"
-        try:  # user passed us a sequence, set them individually
-            for type in adoType:
-                dict.__setitem__(self, type, cvtFn)
-        except TypeError:  # a single value fails attempt to iterate
-            dict.__setitem__(self, adoType, cvtFn)
-
-
-# initialize variantConversions dictionary used to convert SQL to Python
-# this is the dictionary of default conversion functions, built by the class above.
-# this becomes a class attribute for the Connection, and that attribute is used
-# to build the list of column conversion functions for the Cursor
-variantConversions = MultiMap(
-    {
-        adoDateTimeTypes: variantConvertDate,
-        adoApproximateNumericTypes: cvtFloat,
-        adoExactNumericTypes: cvtDecimal,  # use to force decimal rather than unicode
-        adoLongTypes: cvtLong,
-        adoIntegerTypes: cvtInt,
-        adoRowIdTypes: cvtInt,
-        adoStringTypes: identity,
-        adoBinaryTypes: cvtBuffer,
-        adoRemainingTypes: cvtUnusual,
-    }
-)
-
-# # # # # classes to emulate the result of cursor.fetchxxx() as a sequence of sequences # # # # #
-# "an ENUM of how my low level records are laid out"
-RS_WIN_32, RS_ARRAY, RS_REMOTE = list(range(1, 4))
-
-
-class SQLrow(object):  # a single database row
-    # class to emulate a sequence, so that a column may be retrieved by either number or name
-    def __init__(self, rows, index):  # "rows" is an _SQLrows object, index is which row
-        self.rows = rows  # parent 'fetch' container object
-        self.index = index  # my row number within parent
-
-    def __getattr__(self, name):  # used for row.columnName type of value access
-        try:
-            return self._getValue(self.rows.columnNames[name.lower()])
-        except KeyError:
-            raise AttributeError('Unknown column name "{}"'.format(name))
-
-    def _getValue(self, key):  # key must be an integer
-        if (
-            self.rows.recordset_format == RS_ARRAY
-        ):  # retrieve from two-dimensional array
-            v = self.rows.ado_results[key, self.index]
-        elif self.rows.recordset_format == RS_REMOTE:
-            v = self.rows.ado_results[self.index][key]
-        else:  # pywin32 - retrieve from tuple of tuples
-            v = self.rows.ado_results[key][self.index]
-        if self.rows.converters is NotImplemented:
-            return v
-        return convert_to_python(v, self.rows.converters[key])
-
-    def __len__(self):
-        return self.rows.numberOfColumns
-
-    def __getitem__(self, key):  # used for row[key] type of value access
-        if isinstance(key, int):  # normal row[1] designation
-            try:
-                return self._getValue(key)
-            except IndexError:
-                raise
-        if isinstance(key, slice):
-            indices = key.indices(self.rows.numberOfColumns)
-            vl = [self._getValue(i) for i in range(*indices)]
-            return tuple(vl)
-        try:
-            return self._getValue(
-                self.rows.columnNames[key.lower()]
-            )  # extension row[columnName] designation
-        except (KeyError, TypeError):
-            er, st, tr = sys.exc_info()
-            raise er(
-                'No such key as "%s" in %s' % (repr(key), self.__repr__())
-            ).with_traceback(tr)
-
-    def __iter__(self):
-        return iter(self.__next__())
-
-    def __next__(self):
-        for n in range(self.rows.numberOfColumns):
-            yield self._getValue(n)
-
-    def __repr__(self):  # create a human readable representation
-        taglist = sorted(list(self.rows.columnNames.items()), key=lambda x: x[1])
-        s = "<SQLrow={"
-        for name, i in taglist:
-            s += name + ":" + repr(self._getValue(i)) + ", "
-        return s[:-2] + "}>"
-
-    def __str__(self):  # create a pretty human readable representation
-        return str(
-            tuple(str(self._getValue(i)) for i in range(self.rows.numberOfColumns))
-        )
-
-    # TO-DO implement pickling an SQLrow directly
-    # def __getstate__(self): return self.__dict__
-    # def __setstate__(self, d): self.__dict__.update(d)
-    # which basically tell pickle to treat your class just like a normal one,
-    # taking self.__dict__ as representing the whole of the instance state,
-    #  despite the existence of the __getattr__.
-    # # # #
-
-
-class SQLrows(object):
-    # class to emulate a sequence for multiple rows using a container object
-    def __init__(self, ado_results, numberOfRows, cursor):
-        self.ado_results = ado_results  # raw result of SQL get
-        try:
-            self.recordset_format = cursor.recordset_format
-            self.numberOfColumns = cursor.numberOfColumns
-            self.converters = cursor.converters
-            self.columnNames = cursor.columnNames
-        except AttributeError:
-            self.recordset_format = RS_ARRAY
-            self.numberOfColumns = 0
-            self.converters = []
-            self.columnNames = {}
-        self.numberOfRows = numberOfRows
-
-    def __len__(self):
-        return self.numberOfRows
-
-    def __getitem__(self, item):  # used for row or row,column access
-        if not self.ado_results:
-            return []
-        if isinstance(item, slice):  # will return a list of row objects
-            indices = item.indices(self.numberOfRows)
-            return [SQLrow(self, k) for k in range(*indices)]
-        elif isinstance(item, tuple) and len(item) == 2:
-            # d = some_rowsObject[i,j] will return a datum from a two-dimension address
-            i, j = item
-            if not isinstance(j, int):
-                try:
-                    j = self.columnNames[j.lower()]  # convert named column to numeric
-                except KeyError:
-                    raise KeyError('adodbapi: no such column name as "%s"' % repr(j))
-            if self.recordset_format == RS_ARRAY:  # retrieve from two-dimensional array
-                v = self.ado_results[j, i]
-            elif self.recordset_format == RS_REMOTE:
-                v = self.ado_results[i][j]
-            else:  # pywin32 - retrieve from tuple of tuples
-                v = self.ado_results[j][i]
-            if self.converters is NotImplemented:
-                return v
-            return convert_to_python(v, self.converters[j])
-        else:
-            row = SQLrow(self, item)  # new row descriptor
-            return row
-
-    def __iter__(self):
-        return iter(self.__next__())
-
-    def __next__(self):
-        for n in range(self.numberOfRows):
-            row = SQLrow(self, n)
-            yield row
-            # # # # #
-
-    # # # # # functions to re-format SQL requests to other paramstyle requirements # # # # # # # # # #
-
-
-def changeNamedToQmark(
-    op,
-):  # convert from 'named' paramstyle to ADO required '?'mark parameters
-    outOp = ""
-    outparms = []
-    chunks = op.split(
-        "'"
-    )  # quote all literals -- odd numbered list results are literals.
-    inQuotes = False
-    for chunk in chunks:
-        if inQuotes:  # this is inside a quote
-            if chunk == "":  # double apostrophe to quote one apostrophe
-                outOp = outOp[:-1]  # so take one away
-            else:
-                outOp += "'" + chunk + "'"  # else pass the quoted string as is.
-        else:  # is SQL code -- look for a :namedParameter
-            while chunk:  # some SQL string remains
-                sp = chunk.split(":", 1)
-                outOp += sp[0]  # concat the part up to the :
-                s = ""
-                try:
-                    chunk = sp[1]
-                except IndexError:
-                    chunk = None
-                if chunk:  # there was a parameter - parse it out
-                    i = 0
-                    c = chunk[0]
-                    while c.isalnum() or c == "_":
-                        i += 1
-                        try:
-                            c = chunk[i]
-                        except IndexError:
-                            break
-                    s = chunk[:i]
-                    chunk = chunk[i:]
-                if s:
-                    outparms.append(s)  # list the parameters in order
-                    outOp += "?"  # put in the Qmark
-        inQuotes = not inQuotes
-    return outOp, outparms
-
-
-def changeFormatToQmark(
-    op,
-):  # convert from 'format' paramstyle to ADO required '?'mark parameters
-    outOp = ""
-    outparams = []
-    chunks = op.split(
-        "'"
-    )  # quote all literals -- odd numbered list results are literals.
-    inQuotes = False
-    for chunk in chunks:
-        if inQuotes:
-            if (
-                outOp != "" and chunk == ""
-            ):  # he used a double apostrophe to quote one apostrophe
-                outOp = outOp[:-1]  # so take one away
-            else:
-                outOp += "'" + chunk + "'"  # else pass the quoted string as is.
-        else:  # is SQL code -- look for a %s parameter
-            if "%(" in chunk:  # ugh! pyformat!
-                while chunk:  # some SQL string remains
-                    sp = chunk.split("%(", 1)
-                    outOp += sp[0]  # concat the part up to the %
-                    if len(sp) > 1:
-                        try:
-                            s, chunk = sp[1].split(")s", 1)  # find the ')s'
-                        except ValueError:
-                            raise ProgrammingError(
-                                'Pyformat SQL has incorrect format near "%s"' % chunk
-                            )
-                        outparams.append(s)
-                        outOp += "?"  # put in the Qmark
-                    else:
-                        chunk = None
-            else:  # proper '%s' format
-                sp = chunk.split("%s")  # make each %s
-                outOp += "?".join(sp)  # into ?
-        inQuotes = not inQuotes  # every other chunk is a quoted string
-    return outOp, outparams
diff --git a/lib/adodbapi/examples/db_print.py b/lib/adodbapi/examples/db_print.py
deleted file mode 100644
index 3f5f9d5b..00000000
--- a/lib/adodbapi/examples/db_print.py
+++ /dev/null
@@ -1,72 +0,0 @@
-""" db_print.py -- a simple demo for ADO database reads."""
-
-import sys
-
-import adodbapi.ado_consts as adc
-
-cmd_args = ("filename", "table_name")
-if "help" in sys.argv:
-    print("possible settings keywords are:", cmd_args)
-    sys.exit()
-
-kw_args = {}  # pick up filename and proxy address from command line (optionally)
-for arg in sys.argv:
-    s = arg.split("=")
-    if len(s) > 1:
-        if s[0] in cmd_args:
-            kw_args[s[0]] = s[1]
-
-kw_args.setdefault(
-    "filename", "test.mdb"
-)  # assumes server is running from examples folder
-kw_args.setdefault("table_name", "Products")  # the name of the demo table
-
-# the server needs to select the provider based on his Python installation
-provider_switch = ["provider", "Microsoft.ACE.OLEDB.12.0", "Microsoft.Jet.OLEDB.4.0"]
-
-# ------------------------ START HERE -------------------------------------
-# create the connection
-constr = "Provider=%(provider)s;Data Source=%(filename)s"
-import adodbapi as db
-
-con = db.connect(constr, kw_args, macro_is64bit=provider_switch)
-
-if kw_args["table_name"] == "?":
-    print("The tables in your database are:")
-    for name in con.get_table_names():
-        print(name)
-else:
-    # make a cursor on the connection
-    with con.cursor() as c:
-        # run an SQL statement on the cursor
-        sql = "select * from %s" % kw_args["table_name"]
-        print('performing query="%s"' % sql)
-        c.execute(sql)
-
-        # check the results
-        print(
-            'result rowcount shows as= %d. (Note: -1 means "not known")' % (c.rowcount,)
-        )
-        print("")
-        print("result data description is:")
-        print("            NAME Type         DispSize IntrnlSz Prec Scale Null?")
-        for d in c.description:
-            print(
-                ("%16s %-12s %8s %8d %4d %5d %s")
-                % (d[0], adc.adTypeNames[d[1]], d[2], d[3], d[4], d[5], bool(d[6]))
-            )
-        print("")
-        print("str() of first five records are...")
-
-        # get the results
-        db = c.fetchmany(5)
-
-        # print them
-        for rec in db:
-            print(rec)
-
-        print("")
-        print("repr() of next row is...")
-        print(repr(c.fetchone()))
-        print("")
-con.close()
diff --git a/lib/adodbapi/examples/db_table_names.py b/lib/adodbapi/examples/db_table_names.py
deleted file mode 100644
index eb512a33..00000000
--- a/lib/adodbapi/examples/db_table_names.py
+++ /dev/null
@@ -1,20 +0,0 @@
-""" db_table_names.py -- a simple demo for ADO database table listing."""
-import sys
-
-import adodbapi
-
-try:
-    databasename = sys.argv[1]
-except IndexError:
-    databasename = "test.mdb"
-
-provider = ["prv", "Microsoft.ACE.OLEDB.12.0", "Microsoft.Jet.OLEDB.4.0"]
-constr = "Provider=%(prv)s;Data Source=%(db)s"
-
-# create the connection
-con = adodbapi.connect(constr, db=databasename, macro_is64bit=provider)
-
-print("Table names in= %s" % databasename)
-
-for table in con.get_table_names():
-    print(table)
diff --git a/lib/adodbapi/examples/xls_read.py b/lib/adodbapi/examples/xls_read.py
deleted file mode 100644
index 45e0d277..00000000
--- a/lib/adodbapi/examples/xls_read.py
+++ /dev/null
@@ -1,41 +0,0 @@
-import sys
-
-import adodbapi
-
-try:
-    import adodbapi.is64bit as is64bit
-
-    is64 = is64bit.Python()
-except ImportError:
-    is64 = False
-
-if is64:
-    driver = "Microsoft.ACE.OLEDB.12.0"
-else:
-    driver = "Microsoft.Jet.OLEDB.4.0"
-extended = 'Extended Properties="Excel 8.0;HDR=Yes;IMEX=1;"'
-
-try:  # first command line argument will be xls file name -- default to the one written by xls_write.py
-    filename = sys.argv[1]
-except IndexError:
-    filename = "xx.xls"
-
-constr = "Provider=%s;Data Source=%s;%s" % (driver, filename, extended)
-
-conn = adodbapi.connect(constr)
-
-try:  # second command line argument will be worksheet name -- default to first worksheet
-    sheet = sys.argv[2]
-except IndexError:
-    # use ADO feature to get the name of the first worksheet
-    sheet = conn.get_table_names()[0]
-
-print("Shreadsheet=%s  Worksheet=%s" % (filename, sheet))
-print("------------------------------------------------------------")
-crsr = conn.cursor()
-sql = "SELECT * from [%s]" % sheet
-crsr.execute(sql)
-for row in crsr.fetchmany(10):
-    print(repr(row))
-crsr.close()
-conn.close()
diff --git a/lib/adodbapi/examples/xls_write.py b/lib/adodbapi/examples/xls_write.py
deleted file mode 100644
index 9d1d3114..00000000
--- a/lib/adodbapi/examples/xls_write.py
+++ /dev/null
@@ -1,41 +0,0 @@
-import datetime
-
-import adodbapi
-
-try:
-    import adodbapi.is64bit as is64bit
-
-    is64 = is64bit.Python()
-except ImportError:
-    is64 = False  # in case the user has an old version of adodbapi
-if is64:
-    driver = "Microsoft.ACE.OLEDB.12.0"
-else:
-    driver = "Microsoft.Jet.OLEDB.4.0"
-filename = "xx.xls"  # file will be created if it does not exist
-extended = 'Extended Properties="Excel 8.0;Readonly=False;"'
-
-constr = "Provider=%s;Data Source=%s;%s" % (driver, filename, extended)
-
-conn = adodbapi.connect(constr)
-with conn:  # will auto commit if no errors
-    with conn.cursor() as crsr:
-        try:
-            crsr.execute("drop table SheetOne")
-        except:
-            pass  # just is case there is one already there
-
-        # create the sheet and the header row and set the types for the columns
-        crsr.execute(
-            "create table SheetOne (Name varchar, Rank varchar, SrvcNum integer, Weight float,  Birth date)"
-        )
-
-        sql = "INSERT INTO SheetOne (name, rank , srvcnum, weight, birth) values (?,?,?,?,?)"
-
-        data = ("Mike Murphy", "SSG", 123456789, 167.8, datetime.date(1922, 12, 27))
-        crsr.execute(sql, data)  # write the first row of data
-        crsr.execute(
-            sql, ["John Jones", "Pvt", 987654321, 140.0, datetime.date(1921, 7, 4)]
-        )  # another row of data
-conn.close()
-print("Created spreadsheet=%s worksheet=%s" % (filename, "SheetOne"))
diff --git a/lib/adodbapi/is64bit.py b/lib/adodbapi/is64bit.py
deleted file mode 100644
index bba12b43..00000000
--- a/lib/adodbapi/is64bit.py
+++ /dev/null
@@ -1,41 +0,0 @@
-"""is64bit.Python() --> boolean value of detected Python word size. is64bit.os() --> os build version"""
-import sys
-
-
-def Python():
-    if sys.platform == "cli":  # IronPython
-        import System
-
-        return System.IntPtr.Size == 8
-    else:
-        try:
-            return sys.maxsize > 2147483647
-        except AttributeError:
-            return sys.maxint > 2147483647
-
-
-def os():
-    import platform
-
-    pm = platform.machine()
-    if pm != ".." and pm.endswith("64"):  # recent Python (not Iron)
-        return True
-    else:
-        import os
-
-        if "PROCESSOR_ARCHITEW6432" in os.environ:
-            return True  # 32 bit program running on 64 bit Windows
-        try:
-            return os.environ["PROCESSOR_ARCHITECTURE"].endswith(
-                "64"
-            )  # 64 bit Windows 64 bit program
-        except (IndexError, KeyError):
-            pass  # not Windows
-        try:
-            return "64" in platform.architecture()[0]  # this often works in Linux
-        except:
-            return False  # is an older version of Python, assume also an older os (best we can guess)
-
-
-if __name__ == "__main__":
-    print("is64bit.Python() =", Python(), "is64bit.os() =", os())
diff --git a/lib/adodbapi/license.txt b/lib/adodbapi/license.txt
deleted file mode 100644
index c255f4aa..00000000
--- a/lib/adodbapi/license.txt
+++ /dev/null
@@ -1,506 +0,0 @@
-		  GNU LESSER GENERAL PUBLIC LICENSE
-		       Version 2.1, February 1999
-
- Copyright (C) 1991, 1999 Free Software Foundation, Inc.
-     59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
- Everyone is permitted to copy and distribute verbatim copies
- of this license document, but changing it is not allowed.
-
-[This is the first released version of the Lesser GPL.  It also counts
- as the successor of the GNU Library Public License, version 2, hence
- the version number 2.1.]
-
-			    Preamble
-
-  The licenses for most software are designed to take away your
-freedom to share and change it.  By contrast, the GNU General Public
-Licenses are intended to guarantee your freedom to share and change
-free software--to make sure the software is free for all its users.
-
-  This license, the Lesser General Public License, applies to some
-specially designated software packages--typically libraries--of the
-Free Software Foundation and other authors who decide to use it.  You
-can use it too, but we suggest you first think carefully about whether
-this license or the ordinary General Public License is the better
-strategy to use in any particular case, based on the explanations below.
-
-  When we speak of free software, we are referring to freedom of use,
-not price.  Our General Public Licenses are designed to make sure that
-you have the freedom to distribute copies of free software (and charge
-for this service if you wish); that you receive source code or can get
-it if you want it; that you can change the software and use pieces of
-it in new free programs; and that you are informed that you can do
-these things.
-
-  To protect your rights, we need to make restrictions that forbid
-distributors to deny you these rights or to ask you to surrender these
-rights.  These restrictions translate to certain responsibilities for
-you if you distribute copies of the library or if you modify it.
-
-  For example, if you distribute copies of the library, whether gratis
-or for a fee, you must give the recipients all the rights that we gave
-you.  You must make sure that they, too, receive or can get the source
-code.  If you link other code with the library, you must provide
-complete object files to the recipients, so that they can relink them
-with the library after making changes to the library and recompiling
-it.  And you must show them these terms so they know their rights.
-
-  We protect your rights with a two-step method: (1) we copyright the
-library, and (2) we offer you this license, which gives you legal
-permission to copy, distribute and/or modify the library.
-
-  To protect each distributor, we want to make it very clear that
-there is no warranty for the free library.  Also, if the library is
-modified by someone else and passed on, the recipients should know
-that what they have is not the original version, so that the original
-author's reputation will not be affected by problems that might be
-introduced by others.
-
-
-
-  Finally, software patents pose a constant threat to the existence of
-any free program.  We wish to make sure that a company cannot
-effectively restrict the users of a free program by obtaining a
-restrictive license from a patent holder.  Therefore, we insist that
-any patent license obtained for a version of the library must be
-consistent with the full freedom of use specified in this license.
-
-  Most GNU software, including some libraries, is covered by the
-ordinary GNU General Public License.  This license, the GNU Lesser
-General Public License, applies to certain designated libraries, and
-is quite different from the ordinary General Public License.  We use
-this license for certain libraries in order to permit linking those
-libraries into non-free programs.
-
-  When a program is linked with a library, whether statically or using
-a shared library, the combination of the two is legally speaking a
-combined work, a derivative of the original library.  The ordinary
-General Public License therefore permits such linking only if the
-entire combination fits its criteria of freedom.  The Lesser General
-Public License permits more lax criteria for linking other code with
-the library.
-
-  We call this license the "Lesser" General Public License because it
-does Less to protect the user's freedom than the ordinary General
-Public License.  It also provides other free software developers Less
-of an advantage over competing non-free programs.  These disadvantages
-are the reason we use the ordinary General Public License for many
-libraries.  However, the Lesser license provides advantages in certain
-special circumstances.
-
-  For example, on rare occasions, there may be a special need to
-encourage the widest possible use of a certain library, so that it becomes
-a de-facto standard.  To achieve this, non-free programs must be
-allowed to use the library.  A more frequent case is that a free
-library does the same job as widely used non-free libraries.  In this
-case, there is little to gain by limiting the free library to free
-software only, so we use the Lesser General Public License.
-
-  In other cases, permission to use a particular library in non-free
-programs enables a greater number of people to use a large body of
-free software.  For example, permission to use the GNU C Library in
-non-free programs enables many more people to use the whole GNU
-operating system, as well as its variant, the GNU/Linux operating
-system.
-
-  Although the Lesser General Public License is Less protective of the
-users' freedom, it does ensure that the user of a program that is
-linked with the Library has the freedom and the wherewithal to run
-that program using a modified version of the Library.
-
-  The precise terms and conditions for copying, distribution and
-modification follow.  Pay close attention to the difference between a
-"work based on the library" and a "work that uses the library".  The
-former contains code derived from the library, whereas the latter must
-be combined with the library in order to run.
-
-
-
-		  GNU LESSER GENERAL PUBLIC LICENSE
-   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
-
-  0. This License Agreement applies to any software library or other
-program which contains a notice placed by the copyright holder or
-other authorized party saying it may be distributed under the terms of
-this Lesser General Public License (also called "this License").
-Each licensee is addressed as "you".
-
-  A "library" means a collection of software functions and/or data
-prepared so as to be conveniently linked with application programs
-(which use some of those functions and data) to form executables.
-
-  The "Library", below, refers to any such software library or work
-which has been distributed under these terms.  A "work based on the
-Library" means either the Library or any derivative work under
-copyright law: that is to say, a work containing the Library or a
-portion of it, either verbatim or with modifications and/or translated
-straightforwardly into another language.  (Hereinafter, translation is
-included without limitation in the term "modification".)
-
-  "Source code" for a work means the preferred form of the work for
-making modifications to it.  For a library, complete source code means
-all the source code for all modules it contains, plus any associated
-interface definition files, plus the scripts used to control compilation
-and installation of the library.
-
-  Activities other than copying, distribution and modification are not
-covered by this License; they are outside its scope.  The act of
-running a program using the Library is not restricted, and output from
-such a program is covered only if its contents constitute a work based
-on the Library (independent of the use of the Library in a tool for
-writing it).  Whether that is true depends on what the Library does
-and what the program that uses the Library does.
-  
-  1. You may copy and distribute verbatim copies of the Library's
-complete source code as you receive it, in any medium, provided that
-you conspicuously and appropriately publish on each copy an
-appropriate copyright notice and disclaimer of warranty; keep intact
-all the notices that refer to this License and to the absence of any
-warranty; and distribute a copy of this License along with the
-Library.
-  You may charge a fee for the physical act of transferring a copy,
-and you may at your option offer warranty protection in exchange for a
-fee.
-
-  2. You may modify your copy or copies of the Library or any portion
-of it, thus forming a work based on the Library, and copy and
-distribute such modifications or work under the terms of Section 1
-above, provided that you also meet all of these conditions:
-
-    a) The modified work must itself be a software library.
-
-    b) You must cause the files modified to carry prominent notices
-    stating that you changed the files and the date of any change.
-
-    c) You must cause the whole of the work to be licensed at no
-    charge to all third parties under the terms of this License.
-
-    d) If a facility in the modified Library refers to a function or a
-    table of data to be supplied by an application program that uses
-    the facility, other than as an argument passed when the facility
-    is invoked, then you must make a good faith effort to ensure that,
-    in the event an application does not supply such function or
-    table, the facility still operates, and performs whatever part of
-    its purpose remains meaningful.
-
-    (For example, a function in a library to compute square roots has
-    a purpose that is entirely well-defined independent of the
-    application.  Therefore, Subsection 2d requires that any
-    application-supplied function or table used by this function must
-    be optional: if the application does not supply it, the square
-    root function must still compute square roots.)
-
-These requirements apply to the modified work as a whole.  If
-identifiable sections of that work are not derived from the Library,
-and can be reasonably considered independent and separate works in
-themselves, then this License, and its terms, do not apply to those
-sections when you distribute them as separate works.  But when you
-distribute the same sections as part of a whole which is a work based
-on the Library, the distribution of the whole must be on the terms of
-this License, whose permissions for other licensees extend to the
-entire whole, and thus to each and every part regardless of who wrote
-it.
-
-Thus, it is not the intent of this section to claim rights or contest
-your rights to work written entirely by you; rather, the intent is to
-exercise the right to control the distribution of derivative or
-collective works based on the Library.
-
-In addition, mere aggregation of another work not based on the Library
-with the Library (or with a work based on the Library) on a volume of
-a storage or distribution medium does not bring the other work under
-the scope of this License.
-
-  3. You may opt to apply the terms of the ordinary GNU General Public
-License instead of this License to a given copy of the Library.  To do
-this, you must alter all the notices that refer to this License, so
-that they refer to the ordinary GNU General Public License, version 2,
-instead of to this License.  (If a newer version than version 2 of the
-ordinary GNU General Public License has appeared, then you can specify
-that version instead if you wish.)  Do not make any other change in
-these notices.
-
-  Once this change is made in a given copy, it is irreversible for
-that copy, so the ordinary GNU General Public License applies to all
-subsequent copies and derivative works made from that copy.
-
-  This option is useful when you wish to copy part of the code of
-the Library into a program that is not a library.
-
-  4. You may copy and distribute the Library (or a portion or
-derivative of it, under Section 2) in object code or executable form
-under the terms of Sections 1 and 2 above provided that you accompany
-it with the complete corresponding machine-readable source code, which
-must be distributed under the terms of Sections 1 and 2 above on a
-medium customarily used for software interchange.
-
-  If distribution of object code is made by offering access to copy
-from a designated place, then offering equivalent access to copy the
-source code from the same place satisfies the requirement to
-distribute the source code, even though third parties are not
-compelled to copy the source along with the object code.
-
-  5. A program that contains no derivative of any portion of the
-Library, but is designed to work with the Library by being compiled or
-linked with it, is called a "work that uses the Library".  Such a
-work, in isolation, is not a derivative work of the Library, and
-therefore falls outside the scope of this License.
-
-  However, linking a "work that uses the Library" with the Library
-creates an executable that is a derivative of the Library (because it
-contains portions of the Library), rather than a "work that uses the
-library".  The executable is therefore covered by this License.
-Section 6 states terms for distribution of such executables.
-
-  When a "work that uses the Library" uses material from a header file
-that is part of the Library, the object code for the work may be a
-derivative work of the Library even though the source code is not.
-Whether this is true is especially significant if the work can be
-linked without the Library, or if the work is itself a library.  The
-threshold for this to be true is not precisely defined by law.
-
-  If such an object file uses only numerical parameters, data
-structure layouts and accessors, and small macros and small inline
-functions (ten lines or less in length), then the use of the object
-file is unrestricted, regardless of whether it is legally a derivative
-work.  (Executables containing this object code plus portions of the
-Library will still fall under Section 6.)
-
-  Otherwise, if the work is a derivative of the Library, you may
-distribute the object code for the work under the terms of Section 6.
-Any executables containing that work also fall under Section 6,
-whether or not they are linked directly with the Library itself.
-
-  6. As an exception to the Sections above, you may also combine or
-link a "work that uses the Library" with the Library to produce a
-work containing portions of the Library, and distribute that work
-under terms of your choice, provided that the terms permit
-modification of the work for the customer's own use and reverse
-engineering for debugging such modifications.
-
-  You must give prominent notice with each copy of the work that the
-Library is used in it and that the Library and its use are covered by
-this License.  You must supply a copy of this License.  If the work
-during execution displays copyright notices, you must include the
-copyright notice for the Library among them, as well as a reference
-directing the user to the copy of this License.  Also, you must do one
-of these things:
-
-    a) Accompany the work with the complete corresponding
-    machine-readable source code for the Library including whatever
-    changes were used in the work (which must be distributed under
-    Sections 1 and 2 above); and, if the work is an executable linked
-    with the Library, with the complete machine-readable "work that
-    uses the Library", as object code and/or source code, so that the
-    user can modify the Library and then relink to produce a modified
-    executable containing the modified Library.  (It is understood
-    that the user who changes the contents of definitions files in the
-    Library will not necessarily be able to recompile the application
-    to use the modified definitions.)
-
-    b) Use a suitable shared library mechanism for linking with the
-    Library.  A suitable mechanism is one that (1) uses at run time a
-    copy of the library already present on the user's computer system,
-    rather than copying library functions into the executable, and (2)
-    will operate properly with a modified version of the library, if
-    the user installs one, as long as the modified version is
-    interface-compatible with the version that the work was made with.
-
-    c) Accompany the work with a written offer, valid for at
-    least three years, to give the same user the materials
-    specified in Subsection 6a, above, for a charge no more
-    than the cost of performing this distribution.
-
-    d) If distribution of the work is made by offering access to copy
-    from a designated place, offer equivalent access to copy the above
-    specified materials from the same place.
-
-    e) Verify that the user has already received a copy of these
-    materials or that you have already sent this user a copy.
-
-  For an executable, the required form of the "work that uses the
-Library" must include any data and utility programs needed for
-reproducing the executable from it.  However, as a special exception,
-the materials to be distributed need not include anything that is
-normally distributed (in either source or binary form) with the major
-components (compiler, kernel, and so on) of the operating system on
-which the executable runs, unless that component itself accompanies
-the executable.
-
-  It may happen that this requirement contradicts the license
-restrictions of other proprietary libraries that do not normally
-accompany the operating system.  Such a contradiction means you cannot
-use both them and the Library together in an executable that you
-distribute.
-
-  7. You may place library facilities that are a work based on the
-Library side-by-side in a single library together with other library
-facilities not covered by this License, and distribute such a combined
-library, provided that the separate distribution of the work based on
-the Library and of the other library facilities is otherwise
-permitted, and provided that you do these two things:
-
-    a) Accompany the combined library with a copy of the same work
-    based on the Library, uncombined with any other library
-    facilities.  This must be distributed under the terms of the
-    Sections above.
-
-    b) Give prominent notice with the combined library of the fact
-    that part of it is a work based on the Library, and explaining
-    where to find the accompanying uncombined form of the same work.
-
-  8. You may not copy, modify, sublicense, link with, or distribute
-the Library except as expressly provided under this License.  Any
-attempt otherwise to copy, modify, sublicense, link with, or
-distribute the Library is void, and will automatically terminate your
-rights under this License.  However, parties who have received copies,
-or rights, from you under this License will not have their licenses
-terminated so long as such parties remain in full compliance.
-
-  9. You are not required to accept this License, since you have not
-signed it.  However, nothing else grants you permission to modify or
-distribute the Library or its derivative works.  These actions are
-prohibited by law if you do not accept this License.  Therefore, by
-modifying or distributing the Library (or any work based on the
-Library), you indicate your acceptance of this License to do so, and
-all its terms and conditions for copying, distributing or modifying
-the Library or works based on it.
-
-  10. Each time you redistribute the Library (or any work based on the
-Library), the recipient automatically receives a license from the
-original licensor to copy, distribute, link with or modify the Library
-subject to these terms and conditions.  You may not impose any further
-restrictions on the recipients' exercise of the rights granted herein.
-You are not responsible for enforcing compliance by third parties with
-this License.
-
-  11. If, as a consequence of a court judgment or allegation of patent
-infringement or for any other reason (not limited to patent issues),
-conditions are imposed on you (whether by court order, agreement or
-otherwise) that contradict the conditions of this License, they do not
-excuse you from the conditions of this License.  If you cannot
-distribute so as to satisfy simultaneously your obligations under this
-License and any other pertinent obligations, then as a consequence you
-may not distribute the Library at all.  For example, if a patent
-license would not permit royalty-free redistribution of the Library by
-all those who receive copies directly or indirectly through you, then
-the only way you could satisfy both it and this License would be to
-refrain entirely from distribution of the Library.
-
-If any portion of this section is held invalid or unenforceable under any
-particular circumstance, the balance of the section is intended to apply,
-and the section as a whole is intended to apply in other circumstances.
-
-It is not the purpose of this section to induce you to infringe any
-patents or other property right claims or to contest validity of any
-such claims; this section has the sole purpose of protecting the
-integrity of the free software distribution system which is
-implemented by public license practices.  Many people have made
-generous contributions to the wide range of software distributed
-through that system in reliance on consistent application of that
-system; it is up to the author/donor to decide if he or she is willing
-to distribute software through any other system and a licensee cannot
-impose that choice.
-
-This section is intended to make thoroughly clear what is believed to
-be a consequence of the rest of this License.
-
-  12. If the distribution and/or use of the Library is restricted in
-certain countries either by patents or by copyrighted interfaces, the
-original copyright holder who places the Library under this License may add
-an explicit geographical distribution limitation excluding those countries,
-so that distribution is permitted only in or among countries not thus
-excluded.  In such case, this License incorporates the limitation as if
-written in the body of this License.
-
-  13. The Free Software Foundation may publish revised and/or new
-versions of the Lesser General Public License from time to time.
-Such new versions will be similar in spirit to the present version,
-but may differ in detail to address new problems or concerns.
-
-Each version is given a distinguishing version number.  If the Library
-specifies a version number of this License which applies to it and
-"any later version", you have the option of following the terms and
-conditions either of that version or of any later version published by
-the Free Software Foundation.  If the Library does not specify a
-license version number, you may choose any version ever published by
-the Free Software Foundation.
-
-  14. If you wish to incorporate parts of the Library into other free
-programs whose distribution conditions are incompatible with these,
-write to the author to ask for permission.  For software which is
-copyrighted by the Free Software Foundation, write to the Free
-Software Foundation; we sometimes make exceptions for this.  Our
-decision will be guided by the two goals of preserving the free status
-of all derivatives of our free software and of promoting the sharing
-and reuse of software generally.
-
-			    NO WARRANTY
-
-  15. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO
-WARRANTY FOR THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW.
-EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR
-OTHER PARTIES PROVIDE THE LIBRARY "AS IS" WITHOUT WARRANTY OF ANY
-KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
-IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
-LIBRARY IS WITH YOU.  SHOULD THE LIBRARY PROVE DEFECTIVE, YOU ASSUME
-THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
-
-  16. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
-WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY
-AND/OR REDISTRIBUTE THE LIBRARY AS PERMITTED ABOVE, BE LIABLE TO YOU
-FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR
-CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE
-LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING
-RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A
-FAILURE OF THE LIBRARY TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF
-SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
-DAMAGES.
-
-		     END OF TERMS AND CONDITIONS
-
-           How to Apply These Terms to Your New Libraries
-
-  If you develop a new library, and you want it to be of the greatest
-possible use to the public, we recommend making it free software that
-everyone can redistribute and change.  You can do so by permitting
-redistribution under these terms (or, alternatively, under the terms of the
-ordinary General Public License).
-
-  To apply these terms, attach the following notices to the library.  It is
-safest to attach them to the start of each source file to most effectively
-convey the exclusion of warranty; and each file should have at least the
-"copyright" line and a pointer to where the full notice is found.
-
-    <one line to give the library's name and a brief idea of what it does.>
-    Copyright (C) <year>  <name of author>
-
-    This library is free software; you can redistribute it and/or
-    modify it under the terms of the GNU Lesser General Public
-    License as published by the Free Software Foundation; either
-    version 2.1 of the License, or (at your option) any later version.
-
-    This library is distributed in the hope that it will be useful,
-    but WITHOUT ANY WARRANTY; without even the implied warranty of
-    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
-    Lesser General Public License for more details.
-
-    You should have received a copy of the GNU Lesser General Public
-    License along with this library; if not, write to the Free Software
-    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
-
-Also add information on how to contact you by electronic and paper mail.
-
-You should also get your employer (if you work as a programmer) or your
-school, if any, to sign a "copyright disclaimer" for the library, if
-necessary.  Here is a sample; alter the names:
-
-  Yoyodyne, Inc., hereby disclaims all copyright interest in the
-  library `Frob' (a library for tweaking knobs) written by James Random Hacker.
-
-  <signature of Ty Coon>, 1 April 1990
-  Ty Coon, President of Vice
-
-That's all there is to it!
-
diff --git a/lib/adodbapi/process_connect_string.py b/lib/adodbapi/process_connect_string.py
deleted file mode 100644
index fa34d23a..00000000
--- a/lib/adodbapi/process_connect_string.py
+++ /dev/null
@@ -1,144 +0,0 @@
-""" a clumsy attempt at a macro language to let the programmer execute code on the server (ex: determine 64bit)"""
-from . import is64bit as is64bit
-
-
-def macro_call(macro_name, args, kwargs):
-    """allow the programmer to perform limited processing on the server by passing macro names and args
-
-    :new_key - the key name the macro will create
-    :args[0] - macro name
-    :args[1:] - any arguments
-    :code - the value of the keyword item
-    :kwargs - the connection keyword dictionary. ??key has been removed
-    --> the value to put in for kwargs['name'] = value
-    """
-    if isinstance(args, (str, str)):
-        args = [
-            args
-        ]  # the user forgot to pass a sequence, so make a string into args[0]
-    new_key = args[0]
-    try:
-        if macro_name == "is64bit":
-            if is64bit.Python():  # if on 64 bit Python
-                return new_key, args[1]  # return first argument
-            else:
-                try:
-                    return new_key, args[2]  # else return second argument (if defined)
-                except IndexError:
-                    return new_key, ""  # else return blank
-
-        elif (
-            macro_name == "getuser"
-        ):  # get the name of the user the server is logged in under
-            if not new_key in kwargs:
-                import getpass
-
-                return new_key, getpass.getuser()
-
-        elif macro_name == "getnode":  # get the name of the computer running the server
-            import platform
-
-            try:
-                return new_key, args[1] % platform.node()
-            except IndexError:
-                return new_key, platform.node()
-
-        elif macro_name == "getenv":  # expand the server's environment variable args[1]
-            try:
-                dflt = args[2]  # if not found, default from args[2]
-            except IndexError:  # or blank
-                dflt = ""
-            return new_key, os.environ.get(args[1], dflt)
-
-        elif macro_name == "auto_security":
-            if (
-                not "user" in kwargs or not kwargs["user"]
-            ):  # missing, blank, or Null username
-                return new_key, "Integrated Security=SSPI"
-            return new_key, "User ID=%(user)s; Password=%(password)s" % kwargs
-
-        elif (
-            macro_name == "find_temp_test_path"
-        ):  # helper function for testing ado operation -- undocumented
-            import os
-            import tempfile
-
-            return new_key, os.path.join(
-                tempfile.gettempdir(), "adodbapi_test", args[1]
-            )
-
-        raise ValueError("Unknown connect string macro=%s" % macro_name)
-    except:
-        raise ValueError("Error in macro processing %s %s" % (macro_name, repr(args)))
-
-
-def process(
-    args, kwargs, expand_macros=False
-):  # --> connection string with keyword arguments processed.
-    """attempts to inject arguments into a connection string using Python "%" operator for strings
-
-    co: adodbapi connection object
-    args: positional parameters from the .connect() call
-    kvargs: keyword arguments from the .connect() call
-    """
-    try:
-        dsn = args[0]
-    except IndexError:
-        dsn = None
-    if isinstance(
-        dsn, dict
-    ):  # as a convenience the first argument may be django settings
-        kwargs.update(dsn)
-    elif (
-        dsn
-    ):  # the connection string is passed to the connection as part of the keyword dictionary
-        kwargs["connection_string"] = dsn
-    try:
-        a1 = args[1]
-    except IndexError:
-        a1 = None
-    # historically, the second positional argument might be a timeout value
-    if isinstance(a1, int):
-        kwargs["timeout"] = a1
-    # if the second positional argument is a string, then it is user
-    elif isinstance(a1, str):
-        kwargs["user"] = a1
-    # if the second positional argument is a dictionary, use it as keyword arguments, too
-    elif isinstance(a1, dict):
-        kwargs.update(a1)
-    try:
-        kwargs["password"] = args[2]  # the third positional argument is password
-        kwargs["host"] = args[3]  # the fourth positional argument is host name
-        kwargs["database"] = args[4]  # the fifth positional argument is database name
-    except IndexError:
-        pass
-
-    # make sure connection string is defined somehow
-    if not "connection_string" in kwargs:
-        try:  # perhaps 'dsn' was defined
-            kwargs["connection_string"] = kwargs["dsn"]
-        except KeyError:
-            try:  # as a last effort, use the "host" keyword
-                kwargs["connection_string"] = kwargs["host"]
-            except KeyError:
-                raise TypeError("Must define 'connection_string' for ado connections")
-    if expand_macros:
-        for kwarg in list(kwargs.keys()):
-            if kwarg.startswith("macro_"):  # If a key defines a macro
-                macro_name = kwarg[6:]  # name without the "macro_"
-                macro_code = kwargs.pop(
-                    kwarg
-                )  # we remove the macro_key and get the code to execute
-                new_key, rslt = macro_call(
-                    macro_name, macro_code, kwargs
-                )  # run the code in the local context
-                kwargs[new_key] = rslt  # put the result back in the keywords dict
-    # special processing for PyRO IPv6 host address
-    try:
-        s = kwargs["proxy_host"]
-        if ":" in s:  # it is an IPv6 address
-            if s[0] != "[":  # is not surrounded by brackets
-                kwargs["proxy_host"] = s.join(("[", "]"))  # put it in brackets
-    except KeyError:
-        pass
-    return kwargs
diff --git a/lib/adodbapi/readme.txt b/lib/adodbapi/readme.txt
deleted file mode 100644
index cf591905..00000000
--- a/lib/adodbapi/readme.txt
+++ /dev/null
@@ -1,92 +0,0 @@
-Project
--------
-adodbapi
-
-A Python DB-API 2.0 (PEP-249) module that makes it easy to use Microsoft ADO 
-for connecting with databases and other data sources
-using either CPython or IronPython.
-
-Home page: <http://sourceforge.net/projects/adodbapi>
-
-Features:
-* 100% DB-API 2.0 (PEP-249) compliant (including most extensions and recommendations).
-* Includes pyunit testcases that describe how to use the module.  
-* Fully implemented in Python. -- runs in Python 2.5+ Python 3.0+ and IronPython 2.6+
-* Licensed under the LGPL license, which means that it can be used freely even in commercial programs subject to certain restrictions. 
-* The user can choose between paramstyles: 'qmark' 'named' 'format' 'pyformat' 'dynamic'
-* Supports data retrieval by column name e.g.:
-  for row in myCurser.execute("select name,age from students"):
-     print("Student", row.name, "is", row.age, "years old.")
-* Supports user-definable system-to-Python data conversion functions (selected by ADO data type, or by column)
-
-Prerequisites:
-* C Python 2.7 or 3.5 or higher
- and pywin32 (Mark Hammond's python for windows extensions.)
-or
- Iron Python 2.7 or higher.  (works in IPy2.0 for all data types except BUFFER)
-
-Installation:
-* (C-Python on Windows): Install pywin32 ("pip install pywin32") which includes adodbapi.
-* (IronPython on Windows): Download adodbapi from http://sf.net/projects/adodbapi.  Unpack the zip.
-     Open a command window as an administrator. CD to the folder containing the unzipped files.
-     Run "setup.py install" using the IronPython of your choice.
-
-NOTE: ...........
-If you do not like the new default operation of returning Numeric columns as decimal.Decimal,
-you can select other options by the user defined conversion feature. 
-Try:
-        adodbapi.apibase.variantConversions[adodbapi.ado_consts.adNumeric] = adodbapi.apibase.cvtString
-or:
-        adodbapi.apibase.variantConversions[adodbapi.ado_consts.adNumeric] = adodbapi.apibase.cvtFloat
-or:
-        adodbapi.apibase.variantConversions[adodbapi.ado_consts.adNumeric] = write_your_own_convertion_function
-		............
-notes for 2.6.2:
-    The definitive source has been moved to https://github.com/mhammond/pywin32/tree/master/adodbapi.
-    Remote has proven too hard to configure and test with Pyro4. I am moving it to unsupported status
-    until I can change to a different connection method.
-whats new in version 2.6
-   A cursor.prepare() method and support for prepared SQL statements.
-   Lots of refactoring, especially of the Remote and Server modules (still to be treated as Beta code).
-   The quick start document 'quick_reference.odt' will export as a nice-looking pdf.
-   Added paramstyles 'pyformat' and 'dynamic'. If your 'paramstyle' is 'named' you _must_ pass a dictionary of
-      parameters to your .execute() method. If your 'paramstyle' is 'format' 'pyformat' or 'dynamic', you _may_
-      pass a dictionary of parameters -- provided your SQL operation string is formatted correctly.
-
-whats new in version 2.5
-   Remote module: (works on Linux!) allows a Windows computer to serve ADO databases via PyRO
-   Server module: PyRO server for ADO.  Run using a command like= C:>python -m adodbapi.server
-   (server has simple connection string macros: is64bit, getuser, sql_provider, auto_security)
-   Brief documentation included.  See adodbapi/examples folder adodbapi.rtf
-   New connection method conn.get_table_names() --> list of names of tables in database
-
-   Vastly refactored. Data conversion things have been moved to the new adodbapi.apibase module.
-   Many former module-level attributes are now class attributes. (Should be more thread-safe)
-   Connection objects are now context managers for transactions and will commit or rollback.
-   Cursor objects are context managers and will automatically close themselves.
-   Autocommit can be switched on and off.
-   Keyword and positional arguments on the connect() method work as documented in PEP 249.
-   Keyword arguments from the connect call can be formatted into the connection string.
-   New keyword arguments defined, such as: autocommit, paramstyle, remote_proxy, remote_port.
-  *** Breaking change: variantConversion lookups are simplified: the following will raise KeyError:
-         oldconverter=adodbapi.variantConversions[adodbapi.adoStringTypes]
-      Refactor as: oldconverter=adodbapi.variantConversions[adodbapi.adoStringTypes[0]]
-
-License
--------
-LGPL, see http://www.opensource.org/licenses/lgpl-license.php
-
-Documentation
--------------
-
-Look at adodbapi/quick_reference.md
-http://www.python.org/topics/database/DatabaseAPI-2.0.html
-read the examples in adodbapi/examples
-and look at the test cases in adodbapi/test directory.
-
-Mailing lists
--------------
-The adodbapi mailing lists have been deactivated. Submit comments to the 
-pywin32 or IronPython mailing lists.
-  -- the bug tracker on sourceforge.net/projects/adodbapi may be checked, (infrequently).
-  -- please use: https://github.com/mhammond/pywin32/issues
diff --git a/lib/adodbapi/remote.py b/lib/adodbapi/remote.py
deleted file mode 100644
index ae22b5a7..00000000
--- a/lib/adodbapi/remote.py
+++ /dev/null
@@ -1,634 +0,0 @@
-"""adodbapi.remote - A python DB API 2.0 (PEP 249) interface to Microsoft ADO
-
-Copyright (C) 2002 Henrik Ekelund, version 2.1 by Vernon Cole
-* http://sourceforge.net/projects/pywin32
-* http://sourceforge.net/projects/adodbapi
-
-    This library is free software; you can redistribute it and/or
-    modify it under the terms of the GNU Lesser General Public
-    License as published by the Free Software Foundation; either
-    version 2.1 of the License, or (at your option) any later version.
-
-    This library is distributed in the hope that it will be useful,
-    but WITHOUT ANY WARRANTY; without even the implied warranty of
-    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
-    Lesser General Public License for more details.
-
-    You should have received a copy of the GNU Lesser General Public
-    License along with this library; if not, write to the Free Software
-    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
-
-    django adaptations and refactoring thanks to Adam Vandenberg
-
-DB-API 2.0 specification: http://www.python.org/dev/peps/pep-0249/
-
-This module source should run correctly in CPython versions 2.5 and later,
-or IronPython version 2.7 and later,
-or, after running through 2to3.py, CPython 3.0 or later.
-"""
-
-__version__ = "2.6.0.4"
-version = "adodbapi.remote v" + __version__
-
-import array
-import datetime
-import os
-import sys
-import time
-
-# Pyro4 is required for server and remote operation --> https://pypi.python.org/pypi/Pyro4/
-try:
-    import Pyro4
-except ImportError:
-    print('* * * Sorry, server operation requires Pyro4. Please "pip import" it.')
-    exit(11)
-
-import adodbapi
-import adodbapi.apibase as api
-import adodbapi.process_connect_string
-from adodbapi.apibase import ProgrammingError
-
-_BaseException = api._BaseException
-
-sys.excepthook = Pyro4.util.excepthook
-Pyro4.config.PREFER_IP_VERSION = 0  # allow system to prefer IPv6
-Pyro4.config.COMMTIMEOUT = 40.0  # a bit longer than the default SQL server Gtimeout
-Pyro4.config.SERIALIZER = "pickle"
-
-try:
-    verbose = int(os.environ["ADODBAPI_VERBOSE"])
-except:
-    verbose = False
-if verbose:
-    print(version)
-
-# --- define objects to smooth out Python3 <-> Python 2.x differences
-unicodeType = str  # this line will be altered by 2to3.py to '= str'
-longType = int  # this line will be altered by 2to3.py to '= int'
-StringTypes = str
-makeByteBuffer = bytes
-memoryViewType = memoryview
-
-# -----------------------------------------------------------
-# conversion functions mandated by PEP 249
-Binary = makeByteBuffer  # override the function from apibase.py
-
-
-def Date(year, month, day):
-    return datetime.date(year, month, day)  # dateconverter.Date(year,month,day)
-
-
-def Time(hour, minute, second):
-    return datetime.time(hour, minute, second)  # dateconverter.Time(hour,minute,second)
-
-
-def Timestamp(year, month, day, hour, minute, second):
-    return datetime.datetime(year, month, day, hour, minute, second)
-
-
-def DateFromTicks(ticks):
-    return Date(*time.gmtime(ticks)[:3])
-
-
-def TimeFromTicks(ticks):
-    return Time(*time.gmtime(ticks)[3:6])
-
-
-def TimestampFromTicks(ticks):
-    return Timestamp(*time.gmtime(ticks)[:6])
-
-
-def connect(*args, **kwargs):  # --> a remote db-api connection object
-    """Create and open a remote db-api database connection object"""
-    # process the argument list the programmer gave us
-    kwargs = adodbapi.process_connect_string.process(args, kwargs)
-    # the "proxy_xxx" keys tell us where to find the PyRO proxy server
-    kwargs.setdefault(
-        "pyro_connection", "PYRO:ado.connection@%(proxy_host)s:%(proxy_port)s"
-    )
-    if not "proxy_port" in kwargs:
-        try:
-            pport = os.environ["PROXY_PORT"]
-        except KeyError:
-            pport = 9099
-        kwargs["proxy_port"] = pport
-    if not "proxy_host" in kwargs or not kwargs["proxy_host"]:
-        try:
-            phost = os.environ["PROXY_HOST"]
-        except KeyError:
-            phost = "[::1]"  # '127.0.0.1'
-        kwargs["proxy_host"] = phost
-    ado_uri = kwargs["pyro_connection"] % kwargs
-    # ask PyRO make us a remote connection object
-    auto_retry = 3
-    while auto_retry:
-        try:
-            dispatcher = Pyro4.Proxy(ado_uri)
-            if "comm_timeout" in kwargs:
-                dispatcher._pyroTimeout = float(kwargs["comm_timeout"])
-            uri = dispatcher.make_connection()
-            break
-        except Pyro4.core.errors.PyroError:
-            auto_retry -= 1
-            if auto_retry:
-                time.sleep(1)
-            else:
-                raise api.DatabaseError("Cannot create connection to=%s" % ado_uri)
-
-    conn_uri = fix_uri(uri, kwargs)  # get a host connection from the proxy server
-    while auto_retry:
-        try:
-            host_conn = Pyro4.Proxy(
-                conn_uri
-            )  # bring up an exclusive Pyro connection for my ADO connection
-            break
-        except Pyro4.core.errors.PyroError:
-            auto_retry -= 1
-            if auto_retry:
-                time.sleep(1)
-            else:
-                raise api.DatabaseError(
-                    "Cannot create ADO connection object using=%s" % conn_uri
-                )
-    if "comm_timeout" in kwargs:
-        host_conn._pyroTimeout = float(kwargs["comm_timeout"])
-    # make a local clone
-    myConn = Connection()
-    while auto_retry:
-        try:
-            myConn.connect(
-                kwargs, host_conn
-            )  # call my connect method -- hand him the host connection
-            break
-        except Pyro4.core.errors.PyroError:
-            auto_retry -= 1
-            if auto_retry:
-                time.sleep(1)
-            else:
-                raise api.DatabaseError(
-                    "Pyro error creating connection to/thru=%s" % repr(kwargs)
-                )
-        except _BaseException as e:
-            raise api.DatabaseError(
-                "Error creating remote connection to=%s, e=%s, %s"
-                % (repr(kwargs), repr(e), sys.exc_info()[2])
-            )
-    return myConn
-
-
-def fix_uri(uri, kwargs):
-    """convert a generic pyro uri with '0.0.0.0' into the address we actually called"""
-    u = uri.asString()
-    s = u.split("[::0]")  # IPv6 generic address
-    if len(s) == 1:  # did not find one
-        s = u.split("0.0.0.0")  # IPv4 generic address
-    if len(s) > 1:  # found a generic
-        return kwargs["proxy_host"].join(s)  # fill in our address for the host
-    return uri
-
-
-# # # # # ----- the Class that defines a connection ----- # # # # #
-class Connection(object):
-    # include connection attributes required by api definition.
-    Warning = api.Warning
-    Error = api.Error
-    InterfaceError = api.InterfaceError
-    DataError = api.DataError
-    DatabaseError = api.DatabaseError
-    OperationalError = api.OperationalError
-    IntegrityError = api.IntegrityError
-    InternalError = api.InternalError
-    NotSupportedError = api.NotSupportedError
-    ProgrammingError = api.ProgrammingError
-    # set up some class attributes
-    paramstyle = api.paramstyle
-
-    @property
-    def dbapi(self):  # a proposed db-api version 3 extension.
-        "Return a reference to the DBAPI module for this Connection."
-        return api
-
-    def __init__(self):
-        self.proxy = None
-        self.kwargs = {}
-        self.errorhandler = None
-        self.supportsTransactions = False
-        self.paramstyle = api.paramstyle
-        self.timeout = 30
-        self.cursors = {}
-
-    def connect(self, kwargs, connection_maker):
-        self.kwargs = kwargs
-        if verbose:
-            print('%s attempting: "%s"' % (version, repr(kwargs)))
-        self.proxy = connection_maker
-        ##try:
-        ret = self.proxy.connect(kwargs)  # ask the server to hook us up
-        ##except ImportError, e:   # Pyro is trying to import pywinTypes.comerrer
-        ##    self._raiseConnectionError(api.DatabaseError, 'Proxy cannot connect using=%s' % repr(kwargs))
-        if ret is not True:
-            self._raiseConnectionError(
-                api.OperationalError, "Proxy returns error message=%s" % repr(ret)
-            )
-
-        self.supportsTransactions = self.getIndexedValue("supportsTransactions")
-        self.paramstyle = self.getIndexedValue("paramstyle")
-        self.timeout = self.getIndexedValue("timeout")
-        if verbose:
-            print("adodbapi.remote New connection at %X" % id(self))
-
-    def _raiseConnectionError(self, errorclass, errorvalue):
-        eh = self.errorhandler
-        if eh is None:
-            eh = api.standardErrorHandler
-        eh(self, None, errorclass, errorvalue)
-
-    def close(self):
-        """Close the connection now (rather than whenever __del__ is called).
-
-        The connection will be unusable from this point forward;
-        an Error (or subclass) exception will be raised if any operation is attempted with the connection.
-        The same applies to all cursor objects trying to use the connection.
-        """
-        for crsr in list(self.cursors.values())[
-            :
-        ]:  # copy the list, then close each one
-            crsr.close()
-        try:
-            """close the underlying remote Connection object"""
-            self.proxy.close()
-            if verbose:
-                print("adodbapi.remote Closed connection at %X" % id(self))
-            object.__delattr__(
-                self, "proxy"
-            )  # future attempts to use closed cursor will be caught by __getattr__
-        except Exception:
-            pass
-
-    def __del__(self):
-        try:
-            self.proxy.close()
-        except:
-            pass
-
-    def commit(self):
-        """Commit any pending transaction to the database.
-
-        Note that if the database supports an auto-commit feature,
-        this must be initially off. An interface method may be provided to turn it back on.
-        Database modules that do not support transactions should implement this method with void functionality.
-        """
-        if not self.supportsTransactions:
-            return
-        result = self.proxy.commit()
-        if result:
-            self._raiseConnectionError(
-                api.OperationalError, "Error during commit: %s" % result
-            )
-
-    def _rollback(self):
-        """In case a database does provide transactions this method causes the the database to roll back to
-        the start of any pending transaction. Closing a connection without committing the changes first will
-        cause an implicit rollback to be performed.
-        """
-        result = self.proxy.rollback()
-        if result:
-            self._raiseConnectionError(
-                api.OperationalError, "Error during rollback: %s" % result
-            )
-
-    def __setattr__(self, name, value):
-        if name in ("paramstyle", "timeout", "autocommit"):
-            if self.proxy:
-                self.proxy.send_attribute_to_host(name, value)
-        object.__setattr__(self, name, value)  # store attribute locally (too)
-
-    def __getattr__(self, item):
-        if (
-            item == "rollback"
-        ):  # the rollback method only appears if the database supports transactions
-            if self.supportsTransactions:
-                return (
-                    self._rollback
-                )  # return the rollback method so the caller can execute it.
-            else:
-                raise self.ProgrammingError(
-                    "this data provider does not support Rollback"
-                )
-        elif item in (
-            "dbms_name",
-            "dbms_version",
-            "connection_string",
-            "autocommit",
-        ):  # 'messages' ):
-            return self.getIndexedValue(item)
-        elif item == "proxy":
-            raise self.ProgrammingError("Attempting to use closed connection")
-        else:
-            raise self.ProgrammingError('No remote access for attribute="%s"' % item)
-
-    def getIndexedValue(self, index):
-        r = self.proxy.get_attribute_for_remote(index)
-        return r
-
-    def cursor(self):
-        "Return a new Cursor Object using the connection."
-        myCursor = Cursor(self)
-        return myCursor
-
-    def _i_am_here(self, crsr):
-        "message from a new cursor proclaiming its existence"
-        self.cursors[crsr.id] = crsr
-
-    def _i_am_closing(self, crsr):
-        "message from a cursor giving connection a chance to clean up"
-        try:
-            del self.cursors[crsr.id]
-        except:
-            pass
-
-    def __enter__(self):  # Connections are context managers
-        return self
-
-    def __exit__(self, exc_type, exc_val, exc_tb):
-        if exc_type:
-            self._rollback()  # automatic rollback on errors
-        else:
-            self.commit()
-
-    def get_table_names(self):
-        return self.proxy.get_table_names()
-
-
-def fixpickle(x):
-    """pickle barfs on buffer(x) so we pass as array.array(x) then restore to original form for .execute()"""
-    if x is None:
-        return None
-    if isinstance(x, dict):
-        # for 'named' paramstyle user will pass a mapping
-        newargs = {}
-        for arg, val in list(x.items()):
-            if isinstance(val, memoryViewType):
-                newval = array.array("B")
-                newval.fromstring(val)
-                newargs[arg] = newval
-            else:
-                newargs[arg] = val
-        return newargs
-    # if not a mapping, then a sequence
-    newargs = []
-    for arg in x:
-        if isinstance(arg, memoryViewType):
-            newarg = array.array("B")
-            newarg.fromstring(arg)
-            newargs.append(newarg)
-        else:
-            newargs.append(arg)
-    return newargs
-
-
-class Cursor(object):
-    def __init__(self, connection):
-        self.command = None
-        self.errorhandler = None  ## was: connection.errorhandler
-        self.connection = connection
-        self.proxy = self.connection.proxy
-        self.rs = None  # the fetchable data for this cursor
-        self.converters = NotImplemented
-        self.id = connection.proxy.build_cursor()
-        connection._i_am_here(self)
-        self.recordset_format = api.RS_REMOTE
-        if verbose:
-            print(
-                "%s New cursor at %X on conn %X"
-                % (version, id(self), id(self.connection))
-            )
-
-    def prepare(self, operation):
-        self.command = operation
-        try:
-            del self.description
-        except AttributeError:
-            pass
-        self.proxy.crsr_prepare(self.id, operation)
-
-    def __iter__(self):  # [2.1 Zamarev]
-        return iter(self.fetchone, None)  # [2.1 Zamarev]
-
-    def __next__(self):
-        r = self.fetchone()
-        if r:
-            return r
-        raise StopIteration
-
-    def __enter__(self):
-        "Allow database cursors to be used with context managers."
-        return self
-
-    def __exit__(self, exc_type, exc_val, exc_tb):
-        "Allow database cursors to be used with context managers."
-        self.close()
-
-    def __getattr__(self, key):
-        if key == "numberOfColumns":
-            try:
-                return len(self.rs[0])
-            except:
-                return 0
-        if key == "description":
-            try:
-                self.description = self.proxy.crsr_get_description(self.id)[:]
-                return self.description
-            except TypeError:
-                return None
-        if key == "columnNames":
-            try:
-                r = dict(
-                    self.proxy.crsr_get_columnNames(self.id)
-                )  # copy the remote columns
-
-            except TypeError:
-                r = {}
-            self.columnNames = r
-            return r
-
-        if key == "remote_cursor":
-            raise api.OperationalError
-        try:
-            return self.proxy.crsr_get_attribute_for_remote(self.id, key)
-        except AttributeError:
-            raise api.InternalError(
-                'Failure getting attribute "%s" from proxy cursor.' % key
-            )
-
-    def __setattr__(self, key, value):
-        if key == "arraysize":
-            self.proxy.crsr_set_arraysize(self.id, value)
-        if key == "paramstyle":
-            if value in api.accepted_paramstyles:
-                self.proxy.crsr_set_paramstyle(self.id, value)
-            else:
-                self._raiseCursorError(
-                    api.ProgrammingError, 'invalid paramstyle ="%s"' % value
-                )
-        object.__setattr__(self, key, value)
-
-    def _raiseCursorError(self, errorclass, errorvalue):
-        eh = self.errorhandler
-        if eh is None:
-            eh = api.standardErrorHandler
-        eh(self.connection, self, errorclass, errorvalue)
-
-    def execute(self, operation, parameters=None):
-        if self.connection is None:
-            self._raiseCursorError(
-                ProgrammingError, "Attempted operation on closed cursor"
-            )
-        self.command = operation
-        try:
-            del self.description
-        except AttributeError:
-            pass
-        try:
-            del self.columnNames
-        except AttributeError:
-            pass
-        fp = fixpickle(parameters)
-        if verbose > 2:
-            print(
-                (
-                    '%s executing "%s" with params=%s'
-                    % (version, operation, repr(parameters))
-                )
-            )
-        result = self.proxy.crsr_execute(self.id, operation, fp)
-        if result:  # an exception was triggered
-            self._raiseCursorError(result[0], result[1])
-
-    def executemany(self, operation, seq_of_parameters):
-        if self.connection is None:
-            self._raiseCursorError(
-                ProgrammingError, "Attempted operation on closed cursor"
-            )
-        self.command = operation
-        try:
-            del self.description
-        except AttributeError:
-            pass
-        try:
-            del self.columnNames
-        except AttributeError:
-            pass
-        sq = [fixpickle(x) for x in seq_of_parameters]
-        if verbose > 2:
-            print(
-                (
-                    '%s executemany "%s" with params=%s'
-                    % (version, operation, repr(seq_of_parameters))
-                )
-            )
-        self.proxy.crsr_executemany(self.id, operation, sq)
-
-    def nextset(self):
-        try:
-            del self.description
-        except AttributeError:
-            pass
-        try:
-            del self.columnNames
-        except AttributeError:
-            pass
-        if verbose > 2:
-            print(("%s nextset" % version))
-        return self.proxy.crsr_nextset(self.id)
-
-    def callproc(self, procname, parameters=None):
-        if self.connection is None:
-            self._raiseCursorError(
-                ProgrammingError, "Attempted operation on closed cursor"
-            )
-        self.command = procname
-        try:
-            del self.description
-        except AttributeError:
-            pass
-        try:
-            del self.columnNames
-        except AttributeError:
-            pass
-        fp = fixpickle(parameters)
-        if verbose > 2:
-            print(
-                (
-                    '%s callproc "%s" with params=%s'
-                    % (version, procname, repr(parameters))
-                )
-            )
-        return self.proxy.crsr_callproc(self.id, procname, fp)
-
-    def fetchone(self):
-        try:
-            f1 = self.proxy.crsr_fetchone(self.id)
-        except _BaseException as e:
-            self._raiseCursorError(api.DatabaseError, e)
-        else:
-            if f1 is None:
-                return None
-            self.rs = [f1]
-            return api.SQLrows(self.rs, 1, self)[
-                0
-            ]  # new object to hold the results of the fetch
-
-    def fetchmany(self, size=None):
-        try:
-            self.rs = self.proxy.crsr_fetchmany(self.id, size)
-            if not self.rs:
-                return []
-            r = api.SQLrows(self.rs, len(self.rs), self)
-            return r
-        except Exception as e:
-            self._raiseCursorError(api.DatabaseError, e)
-
-    def fetchall(self):
-        try:
-            self.rs = self.proxy.crsr_fetchall(self.id)
-            if not self.rs:
-                return []
-            return api.SQLrows(self.rs, len(self.rs), self)
-        except Exception as e:
-            self._raiseCursorError(api.DatabaseError, e)
-
-    def close(self):
-        if self.connection is None:
-            return
-        self.connection._i_am_closing(self)  # take me off the connection's cursors list
-        try:
-            self.proxy.crsr_close(self.id)
-        except:
-            pass
-        try:
-            del self.description
-        except:
-            pass
-        try:
-            del self.rs  # let go of the recordset
-        except:
-            pass
-        self.connection = (
-            None  # this will make all future method calls on me throw an exception
-        )
-        self.proxy = None
-        if verbose:
-            print("adodbapi.remote Closed cursor at %X" % id(self))
-
-    def __del__(self):
-        try:
-            self.close()
-        except:
-            pass
-
-    def setinputsizes(self, sizes):
-        pass
-
-    def setoutputsize(self, size, column=None):
-        pass
diff --git a/lib/adodbapi/schema_table.py b/lib/adodbapi/schema_table.py
deleted file mode 100644
index 8621830e..00000000
--- a/lib/adodbapi/schema_table.py
+++ /dev/null
@@ -1,15 +0,0 @@
-"""call using an open ADO connection --> list of table names"""
-from . import adodbapi
-
-
-def names(connection_object):
-    ado = connection_object.adoConn
-    schema = ado.OpenSchema(20)  # constant = adSchemaTables
-
-    tables = []
-    while not schema.EOF:
-        name = adodbapi.getIndexedValue(schema.Fields, "TABLE_NAME").Value
-        tables.append(name)
-        schema.MoveNext()
-    del schema
-    return tables
diff --git a/lib/adodbapi/setup.py b/lib/adodbapi/setup.py
deleted file mode 100644
index d25869ad..00000000
--- a/lib/adodbapi/setup.py
+++ /dev/null
@@ -1,70 +0,0 @@
-"""adodbapi -- a pure Python PEP 249 DB-API package using Microsoft ADO
-
-Adodbapi can be run on CPython 3.5 and later.
-or IronPython version 2.6 and later (in theory, possibly no longer in practice!)
-"""
-CLASSIFIERS = """\
-Development Status :: 5 - Production/Stable
-Intended Audience :: Developers
-License :: OSI Approved :: GNU Library or Lesser General Public License (LGPL)
-Operating System :: Microsoft :: Windows
-Operating System :: POSIX :: Linux
-Programming Language :: Python
-Programming Language :: Python :: 3
-Programming Language :: SQL
-Topic :: Software Development
-Topic :: Software Development :: Libraries :: Python Modules
-Topic :: Database
-"""
-
-NAME = "adodbapi"
-MAINTAINER = "Vernon Cole"
-MAINTAINER_EMAIL = "vernondcole@gmail.com"
-DESCRIPTION = (
-    """A pure Python package implementing PEP 249 DB-API using Microsoft ADO."""
-)
-URL = "http://sourceforge.net/projects/adodbapi"
-LICENSE = "LGPL"
-CLASSIFIERS = filter(None, CLASSIFIERS.split("\n"))
-AUTHOR = "Henrik Ekelund, Vernon Cole, et.al."
-AUTHOR_EMAIL = "vernondcole@gmail.com"
-PLATFORMS = ["Windows", "Linux"]
-
-VERSION = None  # in case searching for version fails
-a = open("adodbapi.py")  # find the version string in the source code
-for line in a:
-    if "__version__" in line:
-        VERSION = line.split("'")[1]
-        print('adodbapi version="%s"' % VERSION)
-        break
-a.close()
-
-
-def setup_package():
-    from distutils.command.build_py import build_py
-    from distutils.core import setup
-
-    setup(
-        cmdclass={"build_py": build_py},
-        name=NAME,
-        maintainer=MAINTAINER,
-        maintainer_email=MAINTAINER_EMAIL,
-        description=DESCRIPTION,
-        url=URL,
-        keywords="database ado odbc dbapi db-api Microsoft SQL",
-        ##        download_url=DOWNLOAD_URL,
-        long_description=open("README.txt").read(),
-        license=LICENSE,
-        classifiers=CLASSIFIERS,
-        author=AUTHOR,
-        author_email=AUTHOR_EMAIL,
-        platforms=PLATFORMS,
-        version=VERSION,
-        package_dir={"adodbapi": ""},
-        packages=["adodbapi"],
-    )
-    return
-
-
-if __name__ == "__main__":
-    setup_package()
diff --git a/lib/adodbapi/test/adodbapitest.py b/lib/adodbapi/test/adodbapitest.py
deleted file mode 100644
index e5b3dc19..00000000
--- a/lib/adodbapi/test/adodbapitest.py
+++ /dev/null
@@ -1,1692 +0,0 @@
-""" Unit tests version 2.6.1.0 for adodbapi"""
-"""
-    adodbapi - A python DB API 2.0 interface to Microsoft ADO
-
-    Copyright (C) 2002  Henrik Ekelund
-
-    This library is free software; you can redistribute it and/or
-    modify it under the terms of the GNU Lesser General Public
-    License as published by the Free Software Foundation; either
-    version 2.1 of the License, or (at your option) any later version.
-
-    This library is distributed in the hope that it will be useful,
-    but WITHOUT ANY WARRANTY; without even the implied warranty of
-    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
-    Lesser General Public License for more details.
-
-    You should have received a copy of the GNU Lesser General Public
-    License along with this library; if not, write to the Free Software
-    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
-
-    Updates by Vernon Cole
-"""
-
-import copy
-import datetime
-import decimal
-import random
-import string
-import sys
-import unittest
-
-try:
-    import win32com.client
-
-    win32 = True
-except ImportError:
-    win32 = False
-
-# run the configuration module.
-import adodbapitestconfig as config  # will set sys.path to find correct version of adodbapi
-
-# in our code below, all our switches are from config.whatever
-import tryconnection
-
-import adodbapi
-import adodbapi.apibase as api
-
-try:
-    import adodbapi.ado_consts as ado_consts
-except ImportError:  # we are doing a shortcut import as a module -- so
-    try:
-        import ado_consts
-    except ImportError:
-        from adodbapi import ado_consts
-
-
-def str2bytes(sval):
-    return sval.encode("latin1")
-
-
-long = int
-
-
-def randomstring(length):
-    return "".join([random.choice(string.ascii_letters) for n in range(32)])
-
-
-class CommonDBTests(unittest.TestCase):
-    "Self contained super-simple tests in easy syntax, should work on everything between mySQL and Oracle"
-
-    def setUp(self):
-        self.engine = "unknown"
-
-    def getEngine(self):
-        return self.engine
-
-    def getConnection(self):
-        raise NotImplementedError  # "This method must be overriden by a subclass"
-
-    def getCursor(self):
-        return self.getConnection().cursor()
-
-    def testConnection(self):
-        crsr = self.getCursor()
-        assert crsr.__class__.__name__ == "Cursor"
-
-    def testErrorHandlerInherits(self):
-        if not self.remote:
-            conn = self.getConnection()
-            mycallable = lambda connection, cursor, errorclass, errorvalue: 1
-            conn.errorhandler = mycallable
-            crsr = conn.cursor()
-            assert (
-                crsr.errorhandler == mycallable
-            ), "Error handler on crsr should be same as on connection"
-
-    def testDefaultErrorHandlerConnection(self):
-        if not self.remote:
-            conn = self.getConnection()
-            del conn.messages[:]
-            try:
-                conn.close()
-                conn.commit()  # Should not be able to use connection after it is closed
-            except:
-                assert len(conn.messages) == 1
-                assert len(conn.messages[0]) == 2
-                assert conn.messages[0][0] == api.ProgrammingError
-
-    def testOwnErrorHandlerConnection(self):
-        if self.remote:  # ToDo: use "skip"
-            return
-        mycallable = (
-            lambda connection, cursor, errorclass, errorvalue: 1
-        )  # does not raise anything
-        conn = self.getConnection()
-        conn.errorhandler = mycallable
-        conn.close()
-        conn.commit()  # Should not be able to use connection after it is closed
-        assert len(conn.messages) == 0
-
-        conn.errorhandler = None  # This should bring back the standard error handler
-        try:
-            conn.close()
-            conn.commit()  # Should not be able to use connection after it is closed
-        except:
-            pass
-        # The Standard errorhandler appends error to messages attribute
-        assert (
-            len(conn.messages) > 0
-        ), "Setting errorhandler to none  should bring back the standard error handler"
-
-    def testDefaultErrorHandlerCursor(self):
-        crsr = self.getConnection().cursor()
-        if not self.remote:
-            del crsr.messages[:]
-            try:
-                crsr.execute("SELECT abbtytddrf FROM dasdasd")
-            except:
-                assert len(crsr.messages) == 1
-                assert len(crsr.messages[0]) == 2
-                assert crsr.messages[0][0] == api.DatabaseError
-
-    def testOwnErrorHandlerCursor(self):
-        if self.remote:  # ToDo: should be a "skip"
-            return
-        mycallable = (
-            lambda connection, cursor, errorclass, errorvalue: 1
-        )  # does not raise anything
-        crsr = self.getConnection().cursor()
-        crsr.errorhandler = mycallable
-        crsr.execute("SELECT abbtytddrf FROM dasdasd")
-        assert len(crsr.messages) == 0
-
-        crsr.errorhandler = None  # This should bring back the standard error handler
-        try:
-            crsr.execute("SELECT abbtytddrf FROM dasdasd")
-        except:
-            pass
-        # The Standard errorhandler appends error to messages attribute
-        assert (
-            len(crsr.messages) > 0
-        ), "Setting errorhandler to none  should bring back the standard error handler"
-
-    def testUserDefinedConversions(self):
-        if self.remote:  ## Todo: should be a "skip"
-            return
-        try:
-            duplicatingConverter = lambda aStringField: aStringField * 2
-            assert duplicatingConverter("gabba") == "gabbagabba"
-
-            self.helpForceDropOnTblTemp()
-            conn = self.getConnection()
-            # the variantConversions attribute should not exist on a normal connection object
-            self.assertRaises(AttributeError, lambda x: conn.variantConversions[x], [2])
-            if not self.remote:
-                # create a variantConversions attribute on the connection
-                conn.variantConversions = copy.copy(api.variantConversions)
-                crsr = conn.cursor()
-                tabdef = (
-                    "CREATE TABLE xx_%s (fldData VARCHAR(100) NOT NULL, fld2 VARCHAR(20))"
-                    % config.tmp
-                )
-                crsr.execute(tabdef)
-                crsr.execute(
-                    "INSERT INTO xx_%s(fldData,fld2) VALUES('gabba','booga')"
-                    % config.tmp
-                )
-                crsr.execute(
-                    "INSERT INTO xx_%s(fldData,fld2) VALUES('hey','yo')" % config.tmp
-                )
-                # change converter for ALL adoStringTypes columns
-                conn.variantConversions[api.adoStringTypes] = duplicatingConverter
-                crsr.execute(
-                    "SELECT fldData,fld2 FROM xx_%s ORDER BY fldData" % config.tmp
-                )
-
-                rows = crsr.fetchall()
-                row = rows[0]
-                self.assertEqual(row[0], "gabbagabba")
-                row = rows[1]
-                self.assertEqual(row[0], "heyhey")
-                self.assertEqual(row[1], "yoyo")
-
-                upcaseConverter = lambda aStringField: aStringField.upper()
-                assert upcaseConverter("upThis") == "UPTHIS"
-
-                # now use a single column converter
-                rows.converters[1] = upcaseConverter  # convert second column
-                self.assertEqual(row[0], "heyhey")  # first will be unchanged
-                self.assertEqual(row[1], "YO")  # second will convert to upper case
-
-        finally:
-            try:
-                del conn.variantConversions  # Restore the default
-            except:
-                pass
-            self.helpRollbackTblTemp()
-
-    def testUserDefinedConversionForExactNumericTypes(self):
-        # variantConversions is a dictionary of conversion functions
-        # held internally in adodbapi.apibase
-        #
-        # !!! this test intentionally alters the value of what should be constant in the module
-        # !!! no new code should use this example, to is only a test to see that the
-        # !!! deprecated way of doing this still works.  (use connection.variantConversions)
-        #
-        if not self.remote and sys.version_info < (3, 0):  ### Py3 need different test
-            oldconverter = adodbapi.variantConversions[
-                ado_consts.adNumeric
-            ]  # keep old function to restore later
-            # By default decimal and "numbers" are returned as decimals.
-            # Instead, make numbers return as  floats
-            try:
-                adodbapi.variantConversions[ado_consts.adNumeric] = adodbapi.cvtFloat
-                self.helpTestDataType(
-                    "decimal(18,2)", "NUMBER", 3.45, compareAlmostEqual=1
-                )
-                self.helpTestDataType(
-                    "numeric(18,2)", "NUMBER", 3.45, compareAlmostEqual=1
-                )
-                # now return strings
-                adodbapi.variantConversions[ado_consts.adNumeric] = adodbapi.cvtString
-                self.helpTestDataType("numeric(18,2)", "NUMBER", "3.45")
-                # now a completly weird user defined convertion
-                adodbapi.variantConversions[ado_consts.adNumeric] = (
-                    lambda x: "!!This function returns a funny unicode string %s!!" % x
-                )
-                self.helpTestDataType(
-                    "numeric(18,2)",
-                    "NUMBER",
-                    "3.45",
-                    allowedReturnValues=[
-                        "!!This function returns a funny unicode string 3.45!!"
-                    ],
-                )
-            finally:
-                # now reset the converter to its original function
-                adodbapi.variantConversions[
-                    ado_consts.adNumeric
-                ] = oldconverter  # Restore the original convertion function
-
-    def helpTestDataType(
-        self,
-        sqlDataTypeString,
-        DBAPIDataTypeString,
-        pyData,
-        pyDataInputAlternatives=None,
-        compareAlmostEqual=None,
-        allowedReturnValues=None,
-    ):
-        self.helpForceDropOnTblTemp()
-        conn = self.getConnection()
-        crsr = conn.cursor()
-        tabdef = (
-            """
-            CREATE TABLE xx_%s (
-                fldId integer NOT NULL,
-                fldData """
-            % config.tmp
-            + sqlDataTypeString
-            + ")\n"
-        )
-
-        crsr.execute(tabdef)
-
-        # Test Null values mapped to None
-        crsr.execute("INSERT INTO xx_%s (fldId) VALUES (1)" % config.tmp)
-
-        crsr.execute("SELECT fldId,fldData FROM xx_%s" % config.tmp)
-        rs = crsr.fetchone()
-        self.assertEqual(rs[1], None)  # Null should be mapped to None
-        assert rs[0] == 1
-
-        # Test description related
-        descTuple = crsr.description[1]
-        assert descTuple[0] in ["fldData", "flddata"], 'was "%s" expected "%s"' % (
-            descTuple[0],
-            "fldData",
-        )
-
-        if DBAPIDataTypeString == "STRING":
-            assert descTuple[1] == api.STRING, 'was "%s" expected "%s"' % (
-                descTuple[1],
-                api.STRING.values,
-            )
-        elif DBAPIDataTypeString == "NUMBER":
-            assert descTuple[1] == api.NUMBER, 'was "%s" expected "%s"' % (
-                descTuple[1],
-                api.NUMBER.values,
-            )
-        elif DBAPIDataTypeString == "BINARY":
-            assert descTuple[1] == api.BINARY, 'was "%s" expected "%s"' % (
-                descTuple[1],
-                api.BINARY.values,
-            )
-        elif DBAPIDataTypeString == "DATETIME":
-            assert descTuple[1] == api.DATETIME, 'was "%s" expected "%s"' % (
-                descTuple[1],
-                api.DATETIME.values,
-            )
-        elif DBAPIDataTypeString == "ROWID":
-            assert descTuple[1] == api.ROWID, 'was "%s" expected "%s"' % (
-                descTuple[1],
-                api.ROWID.values,
-            )
-        elif DBAPIDataTypeString == "UUID":
-            assert descTuple[1] == api.OTHER, 'was "%s" expected "%s"' % (
-                descTuple[1],
-                api.OTHER.values,
-            )
-        else:
-            raise NotImplementedError  # "DBAPIDataTypeString not provided"
-
-        # Test data binding
-        inputs = [pyData]
-        if pyDataInputAlternatives:
-            inputs.extend(pyDataInputAlternatives)
-        inputs = set(inputs)  # removes redundant string==unicode tests
-        fldId = 1
-        for inParam in inputs:
-            fldId += 1
-            try:
-                crsr.execute(
-                    "INSERT INTO xx_%s (fldId,fldData) VALUES (?,?)" % config.tmp,
-                    (fldId, inParam),
-                )
-            except:
-                if self.remote:
-                    for message in crsr.messages:
-                        print(message)
-                else:
-                    conn.printADOerrors()
-                raise
-            crsr.execute(
-                "SELECT fldData FROM xx_%s WHERE ?=fldID" % config.tmp, [fldId]
-            )
-            rs = crsr.fetchone()
-            if allowedReturnValues:
-                allowedTypes = tuple([type(aRV) for aRV in allowedReturnValues])
-                assert isinstance(
-                    rs[0], allowedTypes
-                ), 'result type "%s" must be one of %s' % (type(rs[0]), allowedTypes)
-            else:
-                assert isinstance(
-                    rs[0], type(pyData)
-                ), 'result type "%s" must be instance of %s' % (
-                    type(rs[0]),
-                    type(pyData),
-                )
-
-            if compareAlmostEqual and DBAPIDataTypeString == "DATETIME":
-                iso1 = adodbapi.dateconverter.DateObjectToIsoFormatString(rs[0])
-                iso2 = adodbapi.dateconverter.DateObjectToIsoFormatString(pyData)
-                self.assertEqual(iso1, iso2)
-            elif compareAlmostEqual:
-                s = float(pyData)
-                v = float(rs[0])
-                assert (
-                    abs(v - s) / s < 0.00001
-                ), "Values not almost equal recvd=%s, expected=%f" % (rs[0], s)
-            else:
-                if allowedReturnValues:
-                    ok = False
-                    self.assertTrue(
-                        rs[0] in allowedReturnValues,
-                        'Value "%s" not in %s' % (repr(rs[0]), allowedReturnValues),
-                    )
-                else:
-                    self.assertEqual(
-                        rs[0],
-                        pyData,
-                        'Values are not equal recvd="%s", expected="%s"'
-                        % (rs[0], pyData),
-                    )
-
-    def testDataTypeFloat(self):
-        self.helpTestDataType("real", "NUMBER", 3.45, compareAlmostEqual=True)
-        self.helpTestDataType("float", "NUMBER", 1.79e37, compareAlmostEqual=True)
-
-    def testDataTypeDecmal(self):
-        self.helpTestDataType(
-            "decimal(18,2)",
-            "NUMBER",
-            3.45,
-            allowedReturnValues=["3.45", "3,45", decimal.Decimal("3.45")],
-        )
-        self.helpTestDataType(
-            "numeric(18,2)",
-            "NUMBER",
-            3.45,
-            allowedReturnValues=["3.45", "3,45", decimal.Decimal("3.45")],
-        )
-        self.helpTestDataType(
-            "decimal(20,2)",
-            "NUMBER",
-            444444444444444444,
-            allowedReturnValues=[
-                "444444444444444444.00",
-                "444444444444444444,00",
-                decimal.Decimal("444444444444444444"),
-            ],
-        )
-        if self.getEngine() == "MSSQL":
-            self.helpTestDataType(
-                "uniqueidentifier",
-                "UUID",
-                "{71A4F49E-39F3-42B1-A41E-48FF154996E6}",
-                allowedReturnValues=["{71A4F49E-39F3-42B1-A41E-48FF154996E6}"],
-            )
-
-    def testDataTypeMoney(self):  # v2.1 Cole -- use decimal for money
-        if self.getEngine() == "MySQL":
-            self.helpTestDataType(
-                "DECIMAL(20,4)", "NUMBER", decimal.Decimal("-922337203685477.5808")
-            )
-        elif self.getEngine() == "PostgreSQL":
-            self.helpTestDataType(
-                "money",
-                "NUMBER",
-                decimal.Decimal("-922337203685477.5808"),
-                compareAlmostEqual=True,
-                allowedReturnValues=[
-                    -922337203685477.5808,
-                    decimal.Decimal("-922337203685477.5808"),
-                ],
-            )
-        else:
-            self.helpTestDataType("smallmoney", "NUMBER", decimal.Decimal("214748.02"))
-            self.helpTestDataType(
-                "money", "NUMBER", decimal.Decimal("-922337203685477.5808")
-            )
-
-    def testDataTypeInt(self):
-        if self.getEngine() != "PostgreSQL":
-            self.helpTestDataType("tinyint", "NUMBER", 115)
-        self.helpTestDataType("smallint", "NUMBER", -32768)
-        if self.getEngine() not in ["ACCESS", "PostgreSQL"]:
-            self.helpTestDataType(
-                "bit", "NUMBER", 1
-            )  # Does not work correctly with access
-        if self.getEngine() in ["MSSQL", "PostgreSQL"]:
-            self.helpTestDataType(
-                "bigint",
-                "NUMBER",
-                3000000000,
-                allowedReturnValues=[3000000000, int(3000000000)],
-            )
-        self.helpTestDataType("int", "NUMBER", 2147483647)
-
-    def testDataTypeChar(self):
-        for sqlDataType in ("char(6)", "nchar(6)"):
-            self.helpTestDataType(
-                sqlDataType,
-                "STRING",
-                "spam  ",
-                allowedReturnValues=["spam", "spam", "spam  ", "spam  "],
-            )
-
-    def testDataTypeVarChar(self):
-        if self.getEngine() == "MySQL":
-            stringKinds = ["varchar(10)", "text"]
-        elif self.getEngine() == "PostgreSQL":
-            stringKinds = ["varchar(10)", "text", "character varying"]
-        else:
-            stringKinds = [
-                "varchar(10)",
-                "nvarchar(10)",
-                "text",
-                "ntext",
-            ]  # ,"varchar(max)"]
-
-        for sqlDataType in stringKinds:
-            self.helpTestDataType(sqlDataType, "STRING", "spam", ["spam"])
-
-    def testDataTypeDate(self):
-        if self.getEngine() == "PostgreSQL":
-            dt = "timestamp"
-        else:
-            dt = "datetime"
-        self.helpTestDataType(
-            dt, "DATETIME", adodbapi.Date(2002, 10, 28), compareAlmostEqual=True
-        )
-        if self.getEngine() not in ["MySQL", "PostgreSQL"]:
-            self.helpTestDataType(
-                "smalldatetime",
-                "DATETIME",
-                adodbapi.Date(2002, 10, 28),
-                compareAlmostEqual=True,
-            )
-        if tag != "pythontime" and self.getEngine() not in [
-            "MySQL",
-            "PostgreSQL",
-        ]:  # fails when using pythonTime
-            self.helpTestDataType(
-                dt,
-                "DATETIME",
-                adodbapi.Timestamp(2002, 10, 28, 12, 15, 1),
-                compareAlmostEqual=True,
-            )
-
-    def testDataTypeBinary(self):
-        binfld = str2bytes("\x07\x00\xE2\x40*")
-        arv = [binfld, adodbapi.Binary(binfld), bytes(binfld)]
-        if self.getEngine() == "PostgreSQL":
-            self.helpTestDataType(
-                "bytea", "BINARY", adodbapi.Binary(binfld), allowedReturnValues=arv
-            )
-        else:
-            self.helpTestDataType(
-                "binary(5)", "BINARY", adodbapi.Binary(binfld), allowedReturnValues=arv
-            )
-            self.helpTestDataType(
-                "varbinary(100)",
-                "BINARY",
-                adodbapi.Binary(binfld),
-                allowedReturnValues=arv,
-            )
-            if self.getEngine() != "MySQL":
-                self.helpTestDataType(
-                    "image", "BINARY", adodbapi.Binary(binfld), allowedReturnValues=arv
-                )
-
-    def helpRollbackTblTemp(self):
-        self.helpForceDropOnTblTemp()
-
-    def helpForceDropOnTblTemp(self):
-        conn = self.getConnection()
-        with conn.cursor() as crsr:
-            try:
-                crsr.execute("DROP TABLE xx_%s" % config.tmp)
-                if not conn.autocommit:
-                    conn.commit()
-            except:
-                pass
-
-    def helpCreateAndPopulateTableTemp(self, crsr):
-        tabdef = (
-            """
-            CREATE TABLE xx_%s (
-                fldData INTEGER
-            )
-            """
-            % config.tmp
-        )
-        try:  # EAFP
-            crsr.execute(tabdef)
-        except api.DatabaseError:  # was not dropped before
-            self.helpForceDropOnTblTemp()  # so drop it now
-            crsr.execute(tabdef)
-        for i in range(9):  # note: this poor SQL code, but a valid test
-            crsr.execute("INSERT INTO xx_%s (fldData) VALUES (%i)" % (config.tmp, i))
-            # NOTE: building the test table without using parameter substitution
-
-    def testFetchAll(self):
-        crsr = self.getCursor()
-        self.helpCreateAndPopulateTableTemp(crsr)
-        crsr.execute("SELECT fldData FROM xx_%s" % config.tmp)
-        rs = crsr.fetchall()
-        assert len(rs) == 9
-        # test slice of rows
-        i = 3
-        for row in rs[3:-2]:  # should have rowid 3..6
-            assert row[0] == i
-            i += 1
-        self.helpRollbackTblTemp()
-
-    def testPreparedStatement(self):
-        crsr = self.getCursor()
-        self.helpCreateAndPopulateTableTemp(crsr)
-        crsr.prepare("SELECT fldData FROM xx_%s" % config.tmp)
-        crsr.execute(crsr.command)  # remember the one that was prepared
-        rs = crsr.fetchall()
-        assert len(rs) == 9
-        assert rs[2][0] == 2
-        self.helpRollbackTblTemp()
-
-    def testWrongPreparedStatement(self):
-        crsr = self.getCursor()
-        self.helpCreateAndPopulateTableTemp(crsr)
-        crsr.prepare("SELECT * FROM nowhere")
-        crsr.execute(
-            "SELECT fldData FROM xx_%s" % config.tmp
-        )  # should execute this one, not the prepared one
-        rs = crsr.fetchall()
-        assert len(rs) == 9
-        assert rs[2][0] == 2
-        self.helpRollbackTblTemp()
-
-    def testIterator(self):
-        crsr = self.getCursor()
-        self.helpCreateAndPopulateTableTemp(crsr)
-        crsr.execute("SELECT fldData FROM xx_%s" % config.tmp)
-        for i, row in enumerate(
-            crsr
-        ):  # using cursor as an iterator, rather than fetchxxx
-            assert row[0] == i
-        self.helpRollbackTblTemp()
-
-    def testExecuteMany(self):
-        crsr = self.getCursor()
-        self.helpCreateAndPopulateTableTemp(crsr)
-        seq_of_values = [(111,), (222,)]
-        crsr.executemany(
-            "INSERT INTO xx_%s (fldData) VALUES (?)" % config.tmp, seq_of_values
-        )
-        if crsr.rowcount == -1:
-            print(
-                self.getEngine()
-                + " Provider does not support rowcount (on .executemany())"
-            )
-        else:
-            self.assertEqual(crsr.rowcount, 2)
-        crsr.execute("SELECT fldData FROM xx_%s" % config.tmp)
-        rs = crsr.fetchall()
-        assert len(rs) == 11
-        self.helpRollbackTblTemp()
-
-    def testRowCount(self):
-        crsr = self.getCursor()
-        self.helpCreateAndPopulateTableTemp(crsr)
-        crsr.execute("SELECT fldData FROM xx_%s" % config.tmp)
-        if crsr.rowcount == -1:
-            # print("provider does not support rowcount on select")
-            pass
-        else:
-            self.assertEqual(crsr.rowcount, 9)
-        self.helpRollbackTblTemp()
-
-    def testRowCountNoRecordset(self):
-        crsr = self.getCursor()
-        self.helpCreateAndPopulateTableTemp(crsr)
-        crsr.execute("DELETE FROM xx_%s WHERE fldData >= 5" % config.tmp)
-        if crsr.rowcount == -1:
-            print(self.getEngine() + " Provider does not support rowcount (on DELETE)")
-        else:
-            self.assertEqual(crsr.rowcount, 4)
-        self.helpRollbackTblTemp()
-
-    def testFetchMany(self):
-        crsr = self.getCursor()
-        self.helpCreateAndPopulateTableTemp(crsr)
-        crsr.execute("SELECT fldData FROM xx_%s" % config.tmp)
-        rs = crsr.fetchmany(3)
-        assert len(rs) == 3
-        rs = crsr.fetchmany(5)
-        assert len(rs) == 5
-        rs = crsr.fetchmany(5)
-        assert len(rs) == 1  # Asked for five, but there is only one left
-        self.helpRollbackTblTemp()
-
-    def testFetchManyWithArraySize(self):
-        crsr = self.getCursor()
-        self.helpCreateAndPopulateTableTemp(crsr)
-        crsr.execute("SELECT fldData FROM xx_%s" % config.tmp)
-        rs = crsr.fetchmany()
-        assert len(rs) == 1  # arraysize Defaults to one
-        crsr.arraysize = 4
-        rs = crsr.fetchmany()
-        assert len(rs) == 4
-        rs = crsr.fetchmany()
-        assert len(rs) == 4
-        rs = crsr.fetchmany()
-        assert len(rs) == 0
-        self.helpRollbackTblTemp()
-
-    def testErrorConnect(self):
-        conn = self.getConnection()
-        kw = {}
-        if "proxy_host" in conn.kwargs:
-            kw["proxy_host"] = conn.kwargs["proxy_host"]
-        conn.close()
-        self.assertRaises(api.DatabaseError, self.db, "not a valid connect string", kw)
-
-    def testRowIterator(self):
-        self.helpForceDropOnTblTemp()
-        conn = self.getConnection()
-        crsr = conn.cursor()
-        tabdef = (
-            """
-            CREATE TABLE xx_%s (
-                fldId integer NOT NULL,
-                fldTwo integer,
-                fldThree integer,
-                fldFour integer)
-                """
-            % config.tmp
-        )
-        crsr.execute(tabdef)
-
-        inputs = [(2, 3, 4), (102, 103, 104)]
-        fldId = 1
-        for inParam in inputs:
-            fldId += 1
-            try:
-                crsr.execute(
-                    "INSERT INTO xx_%s (fldId,fldTwo,fldThree,fldFour) VALUES (?,?,?,?)"
-                    % config.tmp,
-                    (fldId, inParam[0], inParam[1], inParam[2]),
-                )
-            except:
-                if self.remote:
-                    for message in crsr.messages:
-                        print(message)
-                else:
-                    conn.printADOerrors()
-                raise
-            crsr.execute(
-                "SELECT fldTwo,fldThree,fldFour FROM xx_%s WHERE ?=fldID" % config.tmp,
-                [fldId],
-            )
-            rec = crsr.fetchone()
-            # check that stepping through an emulated row works
-            for j in range(len(inParam)):
-                assert (
-                    rec[j] == inParam[j]
-                ), 'returned value:"%s" != test value:"%s"' % (rec[j], inParam[j])
-            # check that we can get a complete tuple from a row
-            assert tuple(rec) == inParam, 'returned value:"%s" != test value:"%s"' % (
-                repr(rec),
-                repr(inParam),
-            )
-            # test that slices of rows work
-            slice1 = tuple(rec[:-1])
-            slice2 = tuple(inParam[0:2])
-            assert slice1 == slice2, 'returned value:"%s" != test value:"%s"' % (
-                repr(slice1),
-                repr(slice2),
-            )
-            # now test named column retrieval
-            assert rec["fldTwo"] == inParam[0]
-            assert rec.fldThree == inParam[1]
-            assert rec.fldFour == inParam[2]
-        # test array operation
-        # note that the fields vv        vv     vv    are out of order
-        crsr.execute("select fldThree,fldFour,fldTwo from xx_%s" % config.tmp)
-        recs = crsr.fetchall()
-        assert recs[1][0] == 103
-        assert recs[0][1] == 4
-        assert recs[1]["fldFour"] == 104
-        assert recs[0, 0] == 3
-        assert recs[0, "fldTwo"] == 2
-        assert recs[1, 2] == 102
-        for i in range(1):
-            for j in range(2):
-                assert recs[i][j] == recs[i, j]
-
-    def testFormatParamstyle(self):
-        self.helpForceDropOnTblTemp()
-        conn = self.getConnection()
-        conn.paramstyle = "format"  # test nonstandard use of paramstyle
-        crsr = conn.cursor()
-        tabdef = (
-            """
-            CREATE TABLE xx_%s (
-                fldId integer NOT NULL,
-                fldData varchar(10),
-                fldConst varchar(30))
-                """
-            % config.tmp
-        )
-        crsr.execute(tabdef)
-
-        inputs = ["one", "two", "three"]
-        fldId = 2
-        for inParam in inputs:
-            fldId += 1
-            sql = (
-                "INSERT INTO xx_"
-                + config.tmp
-                + " (fldId,fldConst,fldData) VALUES (%s,'thi%s :may cause? trouble', %s)"
-            )
-            try:
-                crsr.execute(sql, (fldId, inParam))
-            except:
-                if self.remote:
-                    for message in crsr.messages:
-                        print(message)
-                else:
-                    conn.printADOerrors()
-                raise
-            crsr.execute(
-                "SELECT fldData, fldConst FROM xx_" + config.tmp + " WHERE %s=fldID",
-                [fldId],
-            )
-            rec = crsr.fetchone()
-            self.assertEqual(
-                rec[0],
-                inParam,
-                'returned value:"%s" != test value:"%s"' % (rec[0], inParam),
-            )
-            self.assertEqual(rec[1], "thi%s :may cause? trouble")
-
-        # now try an operation with a "%s" as part of a literal
-        sel = (
-            "insert into xx_" + config.tmp + " (fldId,fldData) VALUES (%s,'four%sfive')"
-        )
-        params = (20,)
-        crsr.execute(sel, params)
-
-        # test the .query implementation
-        assert "(?," in crsr.query, 'expected:"%s" in "%s"' % ("(?,", crsr.query)
-        # test the .command attribute
-        assert crsr.command == sel, 'expected:"%s" but found "%s"' % (sel, crsr.command)
-
-        # test the .parameters attribute
-        if not self.remote:  # parameter list will be altered in transit
-            self.assertEqual(crsr.parameters, params)
-        # now make sure the data made it
-        crsr.execute("SELECT fldData FROM xx_%s WHERE fldID=20" % config.tmp)
-        rec = crsr.fetchone()
-        self.assertEqual(rec[0], "four%sfive")
-
-    def testNamedParamstyle(self):
-        self.helpForceDropOnTblTemp()
-        conn = self.getConnection()
-        crsr = conn.cursor()
-        crsr.paramstyle = "named"  # test nonstandard use of paramstyle
-        tabdef = (
-            """
-            CREATE TABLE xx_%s (
-                fldId integer NOT NULL,
-                fldData varchar(10))
-                """
-            % config.tmp
-        )
-        crsr.execute(tabdef)
-
-        inputs = ["four", "five", "six"]
-        fldId = 10
-        for inParam in inputs:
-            fldId += 1
-            try:
-                crsr.execute(
-                    "INSERT INTO xx_%s (fldId,fldData) VALUES (:Id,:f_Val)"
-                    % config.tmp,
-                    {"f_Val": inParam, "Id": fldId},
-                )
-            except:
-                if self.remote:
-                    for message in crsr.messages:
-                        print(message)
-                else:
-                    conn.printADOerrors()
-                raise
-            crsr.execute(
-                "SELECT fldData FROM xx_%s WHERE fldID=:Id" % config.tmp, {"Id": fldId}
-            )
-            rec = crsr.fetchone()
-            self.assertEqual(
-                rec[0],
-                inParam,
-                'returned value:"%s" != test value:"%s"' % (rec[0], inParam),
-            )
-        # now a test with a ":" as part of a literal
-        crsr.execute(
-            "insert into xx_%s (fldId,fldData) VALUES (:xyz,'six:five')" % config.tmp,
-            {"xyz": 30},
-        )
-        crsr.execute("SELECT fldData FROM xx_%s WHERE fldID=30" % config.tmp)
-        rec = crsr.fetchone()
-        self.assertEqual(rec[0], "six:five")
-
-    def testPyformatParamstyle(self):
-        self.helpForceDropOnTblTemp()
-        conn = self.getConnection()
-        crsr = conn.cursor()
-        crsr.paramstyle = "pyformat"  # test nonstandard use of paramstyle
-        tabdef = (
-            """
-            CREATE TABLE xx_%s (
-                fldId integer NOT NULL,
-                fldData varchar(10))
-                """
-            % config.tmp
-        )
-        crsr.execute(tabdef)
-
-        inputs = ["four", "five", "six"]
-        fldId = 10
-        for inParam in inputs:
-            fldId += 1
-            try:
-                crsr.execute(
-                    "INSERT INTO xx_%s (fldId,fldData) VALUES (%%(Id)s,%%(f_Val)s)"
-                    % config.tmp,
-                    {"f_Val": inParam, "Id": fldId},
-                )
-            except:
-                if self.remote:
-                    for message in crsr.messages:
-                        print(message)
-                else:
-                    conn.printADOerrors()
-                raise
-            crsr.execute(
-                "SELECT fldData FROM xx_%s WHERE fldID=%%(Id)s" % config.tmp,
-                {"Id": fldId},
-            )
-            rec = crsr.fetchone()
-            self.assertEqual(
-                rec[0],
-                inParam,
-                'returned value:"%s" != test value:"%s"' % (rec[0], inParam),
-            )
-        # now a test with a "%" as part of a literal
-        crsr.execute(
-            "insert into xx_%s (fldId,fldData) VALUES (%%(xyz)s,'six%%five')"
-            % config.tmp,
-            {"xyz": 30},
-        )
-        crsr.execute("SELECT fldData FROM xx_%s WHERE fldID=30" % config.tmp)
-        rec = crsr.fetchone()
-        self.assertEqual(rec[0], "six%five")
-
-    def testAutomaticParamstyle(self):
-        self.helpForceDropOnTblTemp()
-        conn = self.getConnection()
-        conn.paramstyle = "dynamic"  # test nonstandard use of paramstyle
-        crsr = conn.cursor()
-        tabdef = (
-            """
-            CREATE TABLE xx_%s (
-                fldId integer NOT NULL,
-                fldData varchar(10),
-                fldConst varchar(30))
-                """
-            % config.tmp
-        )
-        crsr.execute(tabdef)
-        inputs = ["one", "two", "three"]
-        fldId = 2
-        for inParam in inputs:
-            fldId += 1
-            try:
-                crsr.execute(
-                    "INSERT INTO xx_"
-                    + config.tmp
-                    + " (fldId,fldConst,fldData) VALUES (?,'thi%s :may cause? troub:1e', ?)",
-                    (fldId, inParam),
-                )
-            except:
-                if self.remote:
-                    for message in crsr.messages:
-                        print(message)
-                else:
-                    conn.printADOerrors()
-                raise
-            trouble = "thi%s :may cause? troub:1e"
-            crsr.execute(
-                "SELECT fldData, fldConst FROM xx_" + config.tmp + " WHERE ?=fldID",
-                [fldId],
-            )
-            rec = crsr.fetchone()
-            self.assertEqual(
-                rec[0],
-                inParam,
-                'returned value:"%s" != test value:"%s"' % (rec[0], inParam),
-            )
-            self.assertEqual(rec[1], trouble)
-        #     inputs = [u'four',u'five',u'six']
-        fldId = 10
-        for inParam in inputs:
-            fldId += 1
-            try:
-                crsr.execute(
-                    "INSERT INTO xx_%s (fldId,fldData) VALUES (:Id,:f_Val)"
-                    % config.tmp,
-                    {"f_Val": inParam, "Id": fldId},
-                )
-            except:
-                if self.remote:
-                    for message in crsr.messages:
-                        print(message)
-                else:
-                    conn.printADOerrors()
-                raise
-            crsr.execute(
-                "SELECT fldData FROM xx_%s WHERE :Id=fldID" % config.tmp, {"Id": fldId}
-            )
-            rec = crsr.fetchone()
-            self.assertEqual(
-                rec[0],
-                inParam,
-                'returned value:"%s" != test value:"%s"' % (rec[0], inParam),
-            )
-        # now a test with a ":" as part of a literal -- and use a prepared query
-        ppdcmd = (
-            "insert into xx_%s (fldId,fldData) VALUES (:xyz,'six:five')" % config.tmp
-        )
-        crsr.prepare(ppdcmd)
-        crsr.execute(ppdcmd, {"xyz": 30})
-        crsr.execute("SELECT fldData FROM xx_%s WHERE fldID=30" % config.tmp)
-        rec = crsr.fetchone()
-        self.assertEqual(rec[0], "six:five")
-
-    def testRollBack(self):
-        conn = self.getConnection()
-        crsr = conn.cursor()
-        assert not crsr.connection.autocommit, "Unexpected beginning condition"
-        self.helpCreateAndPopulateTableTemp(crsr)
-        crsr.connection.commit()  # commit the first bunch
-
-        crsr.execute("INSERT INTO xx_%s (fldData) VALUES(100)" % config.tmp)
-
-        selectSql = "SELECT fldData FROM xx_%s WHERE fldData=100" % config.tmp
-        crsr.execute(selectSql)
-        rs = crsr.fetchall()
-        assert len(rs) == 1
-        self.conn.rollback()
-        crsr.execute(selectSql)
-        assert (
-            crsr.fetchone() == None
-        ), "cursor.fetchone should return None if a query retrieves no rows"
-        crsr.execute("SELECT fldData from xx_%s" % config.tmp)
-        rs = crsr.fetchall()
-        assert len(rs) == 9, "the original records should still be present"
-        self.helpRollbackTblTemp()
-
-    def testCommit(self):
-        try:
-            con2 = self.getAnotherConnection()
-        except NotImplementedError:
-            return  # should be "SKIP" for ACCESS
-        assert not con2.autocommit, "default should be manual commit"
-        crsr = con2.cursor()
-        self.helpCreateAndPopulateTableTemp(crsr)
-
-        crsr.execute("INSERT INTO xx_%s (fldData) VALUES(100)" % config.tmp)
-        con2.commit()
-
-        selectSql = "SELECT fldData FROM xx_%s WHERE fldData=100" % config.tmp
-        crsr.execute(selectSql)
-        rs = crsr.fetchall()
-        assert len(rs) == 1
-        crsr.close()
-        con2.close()
-        conn = self.getConnection()
-        crsr = self.getCursor()
-        with conn.cursor() as crsr:
-            crsr.execute(selectSql)
-            rs = crsr.fetchall()
-            assert len(rs) == 1
-            assert rs[0][0] == 100
-        self.helpRollbackTblTemp()
-
-    def testAutoRollback(self):
-        try:
-            con2 = self.getAnotherConnection()
-        except NotImplementedError:
-            return  # should be "SKIP" for ACCESS
-        assert not con2.autocommit, "unexpected beginning condition"
-        crsr = con2.cursor()
-        self.helpCreateAndPopulateTableTemp(crsr)
-        crsr.execute("INSERT INTO xx_%s (fldData) VALUES(100)" % config.tmp)
-        selectSql = "SELECT fldData FROM xx_%s WHERE fldData=100" % config.tmp
-        crsr.execute(selectSql)
-        rs = crsr.fetchall()
-        assert len(rs) == 1
-        crsr.close()
-        con2.close()
-        crsr = self.getCursor()
-        try:
-            crsr.execute(
-                selectSql
-            )  # closing the connection should have forced rollback
-            row = crsr.fetchone()
-        except api.DatabaseError:
-            row = None  # if the entire table disappeared the rollback was perfect and the test passed
-        assert row == None, (
-            "cursor.fetchone should return None if a query retrieves no rows. Got %s"
-            % repr(row)
-        )
-        self.helpRollbackTblTemp()
-
-    def testAutoCommit(self):
-        try:
-            ac_conn = self.getAnotherConnection({"autocommit": True})
-        except NotImplementedError:
-            return  # should be "SKIP" for ACCESS
-        crsr = ac_conn.cursor()
-        self.helpCreateAndPopulateTableTemp(crsr)
-        crsr.execute("INSERT INTO xx_%s (fldData) VALUES(100)" % config.tmp)
-        crsr.close()
-        with self.getCursor() as crsr:
-            selectSql = "SELECT fldData from xx_%s" % config.tmp
-            crsr.execute(
-                selectSql
-            )  # closing the connection should _not_ have forced rollback
-            rs = crsr.fetchall()
-            assert len(rs) == 10, "all records should still be present"
-        ac_conn.close()
-        self.helpRollbackTblTemp()
-
-    def testSwitchedAutoCommit(self):
-        try:
-            ac_conn = self.getAnotherConnection()
-        except NotImplementedError:
-            return  # should be "SKIP" for ACCESS
-        ac_conn.autocommit = True
-        crsr = ac_conn.cursor()
-        self.helpCreateAndPopulateTableTemp(crsr)
-        crsr.execute("INSERT INTO xx_%s (fldData) VALUES(100)" % config.tmp)
-        crsr.close()
-        conn = self.getConnection()
-        ac_conn.close()
-        with self.getCursor() as crsr:
-            selectSql = "SELECT fldData from xx_%s" % config.tmp
-            crsr.execute(
-                selectSql
-            )  # closing the connection should _not_ have forced rollback
-            rs = crsr.fetchall()
-            assert len(rs) == 10, "all records should still be present"
-        self.helpRollbackTblTemp()
-
-    def testExtendedTypeHandling(self):
-        class XtendString(str):
-            pass
-
-        class XtendInt(int):
-            pass
-
-        class XtendFloat(float):
-            pass
-
-        xs = XtendString(randomstring(30))
-        xi = XtendInt(random.randint(-100, 500))
-        xf = XtendFloat(random.random())
-        self.helpForceDropOnTblTemp()
-        conn = self.getConnection()
-        crsr = conn.cursor()
-        tabdef = (
-            """
-            CREATE TABLE xx_%s (
-                s VARCHAR(40) NOT NULL,
-                i INTEGER NOT NULL,
-                f REAL NOT NULL)"""
-            % config.tmp
-        )
-        crsr.execute(tabdef)
-        crsr.execute(
-            "INSERT INTO xx_%s (s, i, f) VALUES (?, ?, ?)" % config.tmp, (xs, xi, xf)
-        )
-        crsr.close()
-        conn = self.getConnection()
-        with self.getCursor() as crsr:
-            selectSql = "SELECT s, i, f from xx_%s" % config.tmp
-            crsr.execute(
-                selectSql
-            )  # closing the connection should _not_ have forced rollback
-            row = crsr.fetchone()
-            self.assertEqual(row.s, xs)
-            self.assertEqual(row.i, xi)
-            self.assertAlmostEqual(row.f, xf)
-        self.helpRollbackTblTemp()
-
-
-class TestADOwithSQLServer(CommonDBTests):
-    def setUp(self):
-        self.conn = config.dbSqlServerconnect(
-            *config.connStrSQLServer[0], **config.connStrSQLServer[1]
-        )
-        self.conn.timeout = 30  # turn timeout back up
-        self.engine = "MSSQL"
-        self.db = config.dbSqlServerconnect
-        self.remote = config.connStrSQLServer[2]
-
-    def tearDown(self):
-        try:
-            self.conn.rollback()
-        except:
-            pass
-        try:
-            self.conn.close()
-        except:
-            pass
-        self.conn = None
-
-    def getConnection(self):
-        return self.conn
-
-    def getAnotherConnection(self, addkeys=None):
-        keys = dict(config.connStrSQLServer[1])
-        if addkeys:
-            keys.update(addkeys)
-        return config.dbSqlServerconnect(*config.connStrSQLServer[0], **keys)
-
-    def testVariableReturningStoredProcedure(self):
-        crsr = self.conn.cursor()
-        spdef = """
-            CREATE PROCEDURE sp_DeleteMeOnlyForTesting
-                @theInput varchar(50),
-                @theOtherInput varchar(50),
-                @theOutput varchar(100) OUTPUT
-            AS
-                SET @theOutput=@theInput+@theOtherInput
-                    """
-        try:
-            crsr.execute("DROP PROCEDURE sp_DeleteMeOnlyForTesting")
-            self.conn.commit()
-        except:  # Make sure it is empty
-            pass
-        crsr.execute(spdef)
-
-        retvalues = crsr.callproc(
-            "sp_DeleteMeOnlyForTesting", ("Dodsworth", "Anne", "              ")
-        )
-        assert retvalues[0] == "Dodsworth", '%s is not "Dodsworth"' % repr(retvalues[0])
-        assert retvalues[1] == "Anne", '%s is not "Anne"' % repr(retvalues[1])
-        assert retvalues[2] == "DodsworthAnne", '%s is not "DodsworthAnne"' % repr(
-            retvalues[2]
-        )
-        self.conn.rollback()
-
-    def testMultipleSetReturn(self):
-        crsr = self.getCursor()
-        self.helpCreateAndPopulateTableTemp(crsr)
-
-        spdef = """
-            CREATE PROCEDURE sp_DeleteMe_OnlyForTesting
-            AS
-                SELECT fldData FROM xx_%s ORDER BY fldData ASC
-                SELECT fldData From xx_%s where fldData = -9999
-                SELECT fldData FROM xx_%s ORDER BY fldData DESC
-                    """ % (
-            config.tmp,
-            config.tmp,
-            config.tmp,
-        )
-        try:
-            crsr.execute("DROP PROCEDURE sp_DeleteMe_OnlyForTesting")
-            self.conn.commit()
-        except:  # Make sure it is empty
-            pass
-        crsr.execute(spdef)
-
-        retvalues = crsr.callproc("sp_DeleteMe_OnlyForTesting")
-        row = crsr.fetchone()
-        self.assertEqual(row[0], 0)
-        assert crsr.nextset() == True, "Operation should succeed"
-        assert not crsr.fetchall(), "Should be an empty second set"
-        assert crsr.nextset() == True, "third set should be present"
-        rowdesc = crsr.fetchall()
-        self.assertEqual(rowdesc[0][0], 8)
-        assert crsr.nextset() == None, "No more return sets, should return None"
-
-        self.helpRollbackTblTemp()
-
-    def testDatetimeProcedureParameter(self):
-        crsr = self.conn.cursor()
-        spdef = """
-            CREATE PROCEDURE sp_DeleteMeOnlyForTesting
-                @theInput DATETIME,
-                @theOtherInput varchar(50),
-                @theOutput varchar(100) OUTPUT
-            AS
-                SET @theOutput = CONVERT(CHARACTER(20), @theInput, 0) + @theOtherInput
-                    """
-        try:
-            crsr.execute("DROP PROCEDURE sp_DeleteMeOnlyForTesting")
-            self.conn.commit()
-        except:  # Make sure it is empty
-            pass
-        crsr.execute(spdef)
-
-        result = crsr.callproc(
-            "sp_DeleteMeOnlyForTesting",
-            [adodbapi.Timestamp(2014, 12, 25, 0, 1, 0), "Beep", " " * 30],
-        )
-
-        assert result[2] == "Dec 25 2014 12:01AM Beep", 'value was="%s"' % result[2]
-        self.conn.rollback()
-
-    def testIncorrectStoredProcedureParameter(self):
-        crsr = self.conn.cursor()
-        spdef = """
-            CREATE PROCEDURE sp_DeleteMeOnlyForTesting
-                @theInput DATETIME,
-                @theOtherInput varchar(50),
-                @theOutput varchar(100) OUTPUT
-            AS
-                SET @theOutput = CONVERT(CHARACTER(20), @theInput) + @theOtherInput
-                    """
-        try:
-            crsr.execute("DROP PROCEDURE sp_DeleteMeOnlyForTesting")
-            self.conn.commit()
-        except:  # Make sure it is empty
-            pass
-        crsr.execute(spdef)
-
-        # calling the sproc with a string for the first parameter where a DateTime is expected
-        result = tryconnection.try_operation_with_expected_exception(
-            (api.DataError, api.DatabaseError),
-            crsr.callproc,
-            ["sp_DeleteMeOnlyForTesting"],
-            {"parameters": ["this is wrong", "Anne", "not Alice"]},
-        )
-        if result[0]:  # the expected exception was raised
-            assert "@theInput" in str(result[1]) or "DatabaseError" in str(
-                result
-            ), "Identifies the wrong erroneous parameter"
-        else:
-            assert result[0], result[1]  # incorrect or no exception
-        self.conn.rollback()
-
-
-class TestADOwithAccessDB(CommonDBTests):
-    def setUp(self):
-        self.conn = config.dbAccessconnect(
-            *config.connStrAccess[0], **config.connStrAccess[1]
-        )
-        self.conn.timeout = 30  # turn timeout back up
-        self.engine = "ACCESS"
-        self.db = config.dbAccessconnect
-        self.remote = config.connStrAccess[2]
-
-    def tearDown(self):
-        try:
-            self.conn.rollback()
-        except:
-            pass
-        try:
-            self.conn.close()
-        except:
-            pass
-        self.conn = None
-
-    def getConnection(self):
-        return self.conn
-
-    def getAnotherConnection(self, addkeys=None):
-        raise NotImplementedError("Jet cannot use a second connection to the database")
-
-    def testOkConnect(self):
-        c = self.db(*config.connStrAccess[0], **config.connStrAccess[1])
-        assert c != None
-        c.close()
-
-
-class TestADOwithMySql(CommonDBTests):
-    def setUp(self):
-        self.conn = config.dbMySqlconnect(
-            *config.connStrMySql[0], **config.connStrMySql[1]
-        )
-        self.conn.timeout = 30  # turn timeout back up
-        self.engine = "MySQL"
-        self.db = config.dbMySqlconnect
-        self.remote = config.connStrMySql[2]
-
-    def tearDown(self):
-        try:
-            self.conn.rollback()
-        except:
-            pass
-        try:
-            self.conn.close()
-        except:
-            pass
-        self.conn = None
-
-    def getConnection(self):
-        return self.conn
-
-    def getAnotherConnection(self, addkeys=None):
-        keys = dict(config.connStrMySql[1])
-        if addkeys:
-            keys.update(addkeys)
-        return config.dbMySqlconnect(*config.connStrMySql[0], **keys)
-
-    def testOkConnect(self):
-        c = self.db(*config.connStrMySql[0], **config.connStrMySql[1])
-        assert c != None
-
-    # def testStoredProcedure(self):
-    #     crsr=self.conn.cursor()
-    #     try:
-    #         crsr.execute("DROP PROCEDURE DeleteMeOnlyForTesting")
-    #         self.conn.commit()
-    #     except: #Make sure it is empty
-    #         pass
-    #     spdef= """
-    #             DELIMITER $$
-    #             CREATE PROCEDURE DeleteMeOnlyForTesting (onein CHAR(10), twoin CHAR(10), OUT theout CHAR(20))
-    #             DETERMINISTIC
-    #              BEGIN
-    #                 SET theout = onein //|| twoin;
-    #                 /* (SELECT 'a small string' as result; */
-    #                 END $$
-    #             """
-    #
-    #     crsr.execute(spdef)
-    #
-    #     retvalues=crsr.callproc('DeleteMeOnlyForTesting',('Dodsworth','Anne','              '))
-    #     print 'return value (mysql)=',repr(crsr.returnValue) ###
-    #     assert retvalues[0]=='Dodsworth', '%s is not "Dodsworth"'%repr(retvalues[0])
-    #     assert retvalues[1]=='Anne','%s is not "Anne"'%repr(retvalues[1])
-    #     assert retvalues[2]=='DodsworthAnne','%s is not "DodsworthAnne"'%repr(retvalues[2])
-    #
-    #     try:
-    #         crsr.execute("DROP PROCEDURE, DeleteMeOnlyForTesting")
-    #         self.conn.commit()
-    #     except: #Make sure it is empty
-    #         pass
-
-
-class TestADOwithPostgres(CommonDBTests):
-    def setUp(self):
-        self.conn = config.dbPostgresConnect(
-            *config.connStrPostgres[0], **config.connStrPostgres[1]
-        )
-        self.conn.timeout = 30  # turn timeout back up
-        self.engine = "PostgreSQL"
-        self.db = config.dbPostgresConnect
-        self.remote = config.connStrPostgres[2]
-
-    def tearDown(self):
-        try:
-            self.conn.rollback()
-        except:
-            pass
-        try:
-            self.conn.close()
-        except:
-            pass
-        self.conn = None
-
-    def getConnection(self):
-        return self.conn
-
-    def getAnotherConnection(self, addkeys=None):
-        keys = dict(config.connStrPostgres[1])
-        if addkeys:
-            keys.update(addkeys)
-        return config.dbPostgresConnect(*config.connStrPostgres[0], **keys)
-
-    def testOkConnect(self):
-        c = self.db(*config.connStrPostgres[0], **config.connStrPostgres[1])
-        assert c != None
-
-    # def testStoredProcedure(self):
-    #     crsr=self.conn.cursor()
-    #     spdef= """
-    #         CREATE OR REPLACE FUNCTION DeleteMeOnlyForTesting (text, text)
-    #         RETURNS text AS $funk$
-    #         BEGIN
-    #           RETURN $1 || $2;
-    #         END;
-    #         $funk$
-    #         LANGUAGE SQL;
-    #         """
-    #
-    #     crsr.execute(spdef)
-    #     retvalues = crsr.callproc('DeleteMeOnlyForTesting',('Dodsworth','Anne','              '))
-    #     ### print 'return value (pg)=',repr(crsr.returnValue) ###
-    #     assert retvalues[0]=='Dodsworth', '%s is not "Dodsworth"'%repr(retvalues[0])
-    #     assert retvalues[1]=='Anne','%s is not "Anne"'%repr(retvalues[1])
-    #     assert retvalues[2]=='Dodsworth Anne','%s is not "Dodsworth Anne"'%repr(retvalues[2])
-    #     self.conn.rollback()
-    #     try:
-    #         crsr.execute("DROP PROCEDURE, DeleteMeOnlyForTesting")
-    #         self.conn.commit()
-    #     except: #Make sure it is empty
-    #         pass
-
-
-class TimeConverterInterfaceTest(unittest.TestCase):
-    def testIDate(self):
-        assert self.tc.Date(1990, 2, 2)
-
-    def testITime(self):
-        assert self.tc.Time(13, 2, 2)
-
-    def testITimestamp(self):
-        assert self.tc.Timestamp(1990, 2, 2, 13, 2, 1)
-
-    def testIDateObjectFromCOMDate(self):
-        assert self.tc.DateObjectFromCOMDate(37435.7604282)
-
-    def testICOMDate(self):
-        assert hasattr(self.tc, "COMDate")
-
-    def testExactDate(self):
-        d = self.tc.Date(1994, 11, 15)
-        comDate = self.tc.COMDate(d)
-        correct = 34653.0
-        assert comDate == correct, comDate
-
-    def testExactTimestamp(self):
-        d = self.tc.Timestamp(1994, 11, 15, 12, 0, 0)
-        comDate = self.tc.COMDate(d)
-        correct = 34653.5
-        self.assertEqual(comDate, correct)
-
-        d = self.tc.Timestamp(2003, 5, 6, 14, 15, 17)
-        comDate = self.tc.COMDate(d)
-        correct = 37747.593946759262
-        self.assertEqual(comDate, correct)
-
-    def testIsoFormat(self):
-        d = self.tc.Timestamp(1994, 11, 15, 12, 3, 10)
-        iso = self.tc.DateObjectToIsoFormatString(d)
-        self.assertEqual(str(iso[:19]), "1994-11-15 12:03:10")
-
-        dt = self.tc.Date(2003, 5, 2)
-        iso = self.tc.DateObjectToIsoFormatString(dt)
-        self.assertEqual(str(iso[:10]), "2003-05-02")
-
-
-if config.doMxDateTimeTest:
-    import mx.DateTime
-
-
-class TestMXDateTimeConverter(TimeConverterInterfaceTest):
-    def setUp(self):
-        self.tc = api.mxDateTimeConverter()
-
-    def testCOMDate(self):
-        t = mx.DateTime.DateTime(2002, 6, 28, 18, 15, 2)
-        cmd = self.tc.COMDate(t)
-        assert cmd == t.COMDate()
-
-    def testDateObjectFromCOMDate(self):
-        cmd = self.tc.DateObjectFromCOMDate(37435.7604282)
-        t = mx.DateTime.DateTime(2002, 6, 28, 18, 15, 0)
-        t2 = mx.DateTime.DateTime(2002, 6, 28, 18, 15, 2)
-        assert t2 > cmd > t
-
-    def testDate(self):
-        assert mx.DateTime.Date(1980, 11, 4) == self.tc.Date(1980, 11, 4)
-
-    def testTime(self):
-        assert mx.DateTime.Time(13, 11, 4) == self.tc.Time(13, 11, 4)
-
-    def testTimestamp(self):
-        t = mx.DateTime.DateTime(2002, 6, 28, 18, 15, 1)
-        obj = self.tc.Timestamp(2002, 6, 28, 18, 15, 1)
-        assert t == obj
-
-
-import time
-
-
-class TestPythonTimeConverter(TimeConverterInterfaceTest):
-    def setUp(self):
-        self.tc = api.pythonTimeConverter()
-
-    def testCOMDate(self):
-        mk = time.mktime((2002, 6, 28, 18, 15, 1, 4, 31 + 28 + 31 + 30 + 31 + 28, -1))
-        t = time.localtime(mk)
-        # Fri, 28 Jun 2002 18:15:01 +0000
-        cmd = self.tc.COMDate(t)
-        assert abs(cmd - 37435.7604282) < 1.0 / 24, "%f more than an hour wrong" % cmd
-
-    def testDateObjectFromCOMDate(self):
-        cmd = self.tc.DateObjectFromCOMDate(37435.7604282)
-        t1 = time.gmtime(
-            time.mktime((2002, 6, 28, 0, 14, 1, 4, 31 + 28 + 31 + 30 + 31 + 28, -1))
-        )
-        # there are errors in the implementation of gmtime which we ignore
-        t2 = time.gmtime(
-            time.mktime((2002, 6, 29, 12, 14, 2, 4, 31 + 28 + 31 + 30 + 31 + 28, -1))
-        )
-        assert t1 < cmd < t2, '"%s" should be about 2002-6-28 12:15:01' % repr(cmd)
-
-    def testDate(self):
-        t1 = time.mktime((2002, 6, 28, 18, 15, 1, 4, 31 + 28 + 31 + 30 + 31 + 30, 0))
-        t2 = time.mktime((2002, 6, 30, 18, 15, 1, 4, 31 + 28 + 31 + 30 + 31 + 28, 0))
-        obj = self.tc.Date(2002, 6, 29)
-        assert t1 < time.mktime(obj) < t2, obj
-
-    def testTime(self):
-        self.assertEqual(
-            self.tc.Time(18, 15, 2), time.gmtime(18 * 60 * 60 + 15 * 60 + 2)
-        )
-
-    def testTimestamp(self):
-        t1 = time.localtime(
-            time.mktime((2002, 6, 28, 18, 14, 1, 4, 31 + 28 + 31 + 30 + 31 + 28, -1))
-        )
-        t2 = time.localtime(
-            time.mktime((2002, 6, 28, 18, 16, 1, 4, 31 + 28 + 31 + 30 + 31 + 28, -1))
-        )
-        obj = self.tc.Timestamp(2002, 6, 28, 18, 15, 2)
-        assert t1 < obj < t2, obj
-
-
-class TestPythonDateTimeConverter(TimeConverterInterfaceTest):
-    def setUp(self):
-        self.tc = api.pythonDateTimeConverter()
-
-    def testCOMDate(self):
-        t = datetime.datetime(2002, 6, 28, 18, 15, 1)
-        # Fri, 28 Jun 2002 18:15:01 +0000
-        cmd = self.tc.COMDate(t)
-        assert abs(cmd - 37435.7604282) < 1.0 / 24, "more than an hour wrong"
-
-    def testDateObjectFromCOMDate(self):
-        cmd = self.tc.DateObjectFromCOMDate(37435.7604282)
-        t1 = datetime.datetime(2002, 6, 28, 18, 14, 1)
-        t2 = datetime.datetime(2002, 6, 28, 18, 16, 1)
-        assert t1 < cmd < t2, cmd
-
-        tx = datetime.datetime(
-            2002, 6, 28, 18, 14, 1, 900000
-        )  # testing that microseconds don't become milliseconds
-        c1 = self.tc.DateObjectFromCOMDate(self.tc.COMDate(tx))
-        assert t1 < c1 < t2, c1
-
-    def testDate(self):
-        t1 = datetime.date(2002, 6, 28)
-        t2 = datetime.date(2002, 6, 30)
-        obj = self.tc.Date(2002, 6, 29)
-        assert t1 < obj < t2, obj
-
-    def testTime(self):
-        self.assertEqual(self.tc.Time(18, 15, 2).isoformat()[:8], "18:15:02")
-
-    def testTimestamp(self):
-        t1 = datetime.datetime(2002, 6, 28, 18, 14, 1)
-        t2 = datetime.datetime(2002, 6, 28, 18, 16, 1)
-        obj = self.tc.Timestamp(2002, 6, 28, 18, 15, 2)
-        assert t1 < obj < t2, obj
-
-
-suites = []
-suites.append(unittest.makeSuite(TestPythonDateTimeConverter, "test"))
-if config.doMxDateTimeTest:
-    suites.append(unittest.makeSuite(TestMXDateTimeConverter, "test"))
-if config.doTimeTest:
-    suites.append(unittest.makeSuite(TestPythonTimeConverter, "test"))
-
-if config.doAccessTest:
-    suites.append(unittest.makeSuite(TestADOwithAccessDB, "test"))
-if config.doSqlServerTest:
-    suites.append(unittest.makeSuite(TestADOwithSQLServer, "test"))
-if config.doMySqlTest:
-    suites.append(unittest.makeSuite(TestADOwithMySql, "test"))
-if config.doPostgresTest:
-    suites.append(unittest.makeSuite(TestADOwithPostgres, "test"))
-
-
-class cleanup_manager(object):
-    def __enter__(self):
-        pass
-
-    def __exit__(self, exc_type, exc_val, exc_tb):
-        config.cleanup(config.testfolder, config.mdb_name)
-
-
-suite = unittest.TestSuite(suites)
-if __name__ == "__main__":
-    mysuite = copy.deepcopy(suite)
-    with cleanup_manager():
-        defaultDateConverter = adodbapi.dateconverter
-        print(__doc__)
-        print("Default Date Converter is %s" % (defaultDateConverter,))
-        dateconverter = defaultDateConverter
-        tag = "datetime"
-        unittest.TextTestRunner().run(mysuite)
-
-        if config.iterateOverTimeTests:
-            for test, dateconverter, tag in (
-                (config.doTimeTest, api.pythonTimeConverter, "pythontime"),
-                (config.doMxDateTimeTest, api.mxDateTimeConverter, "mx"),
-            ):
-                if test:
-                    mysuite = copy.deepcopy(
-                        suite
-                    )  # work around a side effect of unittest.TextTestRunner
-                    adodbapi.adodbapi.dateconverter = dateconverter()
-                    print("Changed dateconverter to ")
-                    print(adodbapi.adodbapi.dateconverter)
-                    unittest.TextTestRunner().run(mysuite)
diff --git a/lib/adodbapi/test/adodbapitestconfig.py b/lib/adodbapi/test/adodbapitestconfig.py
deleted file mode 100644
index 98f25444..00000000
--- a/lib/adodbapi/test/adodbapitestconfig.py
+++ /dev/null
@@ -1,221 +0,0 @@
-# Configure this to _YOUR_ environment in order to run the testcases.
-"testADOdbapiConfig.py v 2.6.2.B00"
-
-# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
-# #
-# #  TESTERS:
-# #
-# #  You will need to make numerous modifications to this file
-# #  to adapt it to your own testing environment.
-# #
-# #  Skip down to the next "# #" line --
-# #  -- the things you need to change are below it.
-# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
-import platform
-import random
-import sys
-
-import is64bit
-import setuptestframework
-import tryconnection
-
-print("\nPython", sys.version)
-node = platform.node()
-try:
-    print(
-        "node=%s, is64bit.os()= %s, is64bit.Python()= %s"
-        % (node, is64bit.os(), is64bit.Python())
-    )
-except:
-    pass
-
-if "--help" in sys.argv:
-    print(
-        """Valid command-line switches are:
-    --package - create a temporary test package, run 2to3 if needed.
-    --all - run all possible tests
-    --time - loop over time format tests (including mxdatetime if present)
-    --nojet - do not test against an ACCESS database file
-    --mssql - test against Microsoft SQL server
-    --pg - test against PostgreSQL
-    --mysql - test against MariaDB
-    --remote= - test unsing remote server at= (experimental) 
-    """
-    )
-    exit()
-try:
-    onWindows = bool(sys.getwindowsversion())  # seems to work on all versions of Python
-except:
-    onWindows = False
-
-# create a random name for temporary table names
-_alphabet = (
-    "PYFGCRLAOEUIDHTNSQJKXBMWVZ"  # why, yes, I do happen to use a dvorak keyboard
-)
-tmp = "".join([random.choice(_alphabet) for x in range(9)])
-mdb_name = "xx_" + tmp + ".mdb"  # generate a non-colliding name for the temporary .mdb
-testfolder = setuptestframework.maketemp()
-
-if "--package" in sys.argv:
-    #  create a new adodbapi module -- running 2to3 if needed.
-    pth = setuptestframework.makeadopackage(testfolder)
-else:
-    #  use the adodbapi module in which this file appears
-    pth = setuptestframework.find_ado_path()
-if pth not in sys.path:
-    #  look here _first_ to find modules
-    sys.path.insert(1, pth)
-
-proxy_host = None
-for arg in sys.argv:
-    if arg.startswith("--remote="):
-        proxy_host = arg.split("=")[1]
-        import adodbapi.remote as remote
-
-        break
-
-
-# function to clean up the temporary folder -- calling program must run this function before exit.
-cleanup = setuptestframework.getcleanupfunction()
-try:
-    import adodbapi  # will (hopefully) be imported using the "pth" discovered above
-except SyntaxError:
-    print(
-        '\n* * * Are you trying to run Python2 code using Python3? Re-run this test using the "--package" switch.'
-    )
-    sys.exit(11)
-try:
-    print(adodbapi.version)  # show version
-except:
-    print('"adodbapi.version" not present or not working.')
-print(__doc__)
-
-verbose = False
-for a in sys.argv:
-    if a.startswith("--verbose"):
-        arg = True
-        try:
-            arg = int(a.split("=")[1])
-        except IndexError:
-            pass
-        adodbapi.adodbapi.verbose = arg
-        verbose = arg
-
-doAllTests = "--all" in sys.argv
-doAccessTest = not ("--nojet" in sys.argv)
-doSqlServerTest = "--mssql" in sys.argv or doAllTests
-doMySqlTest = "--mysql" in sys.argv or doAllTests
-doPostgresTest = "--pg" in sys.argv or doAllTests
-iterateOverTimeTests = ("--time" in sys.argv or doAllTests) and onWindows
-
-# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
-# # start your environment setup here v v v
-SQL_HOST_NODE = "testsql.2txt.us,1430"
-
-try:  # If mx extensions are installed, use mxDateTime
-    import mx.DateTime
-
-    doMxDateTimeTest = True
-except:
-    doMxDateTimeTest = False  # Requires eGenixMXExtensions
-
-doTimeTest = True  # obsolete python time format
-
-if doAccessTest:
-    if proxy_host:  # determine the (probably remote) database file folder
-        c = {"macro_find_temp_test_path": ["mdb", mdb_name], "proxy_host": proxy_host}
-    else:
-        c = {"mdb": setuptestframework.makemdb(testfolder, mdb_name)}
-
-    # macro definition for keyword "provider"  using macro "is64bit" -- see documentation
-    # is64bit will return true for 64 bit versions of Python, so the macro will select the ACE provider
-    # (If running a remote ADO service, this will test the 64-bitedness of the ADO server.)
-    c["macro_is64bit"] = [
-        "provider",
-        "Microsoft.ACE.OLEDB.12.0",  # 64 bit provider
-        "Microsoft.Jet.OLEDB.4.0",
-    ]  # 32 bit provider
-    connStrAccess = "Provider=%(provider)s;Data Source=%(mdb)s"  # ;Mode=ReadWrite;Persist Security Info=False;Jet OLEDB:Bypass UserInfo Validation=True"
-    print(
-        "    ...Testing ACCESS connection to {} file...".format(
-            c.get("mdb", "remote .mdb")
-        )
-    )
-    doAccessTest, connStrAccess, dbAccessconnect = tryconnection.try_connection(
-        verbose, connStrAccess, 10, **c
-    )
-
-if doSqlServerTest:
-    c = {
-        "host": SQL_HOST_NODE,  # name of computer with SQL Server
-        "database": "adotest",
-        "user": "adotestuser",  # None implies Windows security
-        "password": "Sq1234567",
-        # macro definition for keyword "security" using macro "auto_security"
-        "macro_auto_security": "security",
-        "provider": "MSOLEDBSQL; MARS Connection=True",
-    }
-    if proxy_host:
-        c["proxy_host"] = proxy_host
-    connStr = "Provider=%(provider)s; Initial Catalog=%(database)s; Data Source=%(host)s; %(security)s;"
-    print("    ...Testing MS-SQL login to {}...".format(c["host"]))
-    (
-        doSqlServerTest,
-        connStrSQLServer,
-        dbSqlServerconnect,
-    ) = tryconnection.try_connection(verbose, connStr, 30, **c)
-
-if doMySqlTest:
-    c = {
-        "host": "testmysql.2txt.us",
-        "database": "adodbapitest",
-        "user": "adotest",
-        "password": "12345678",
-        "port": "3330",  # note the nonstandard port for obfuscation
-        "driver": "MySQL ODBC 5.1 Driver",
-    }  # or _driver="MySQL ODBC 3.51 Driver
-    if proxy_host:
-        c["proxy_host"] = proxy_host
-    c["macro_is64bit"] = [
-        "provider",
-        "Provider=MSDASQL;",
-    ]  # turn on the 64 bit ODBC adapter only if needed
-    cs = (
-        "%(provider)sDriver={%(driver)s};Server=%(host)s;Port=3330;"
-        + "Database=%(database)s;user=%(user)s;password=%(password)s;Option=3;"
-    )
-    print("    ...Testing MySql login to {}...".format(c["host"]))
-    doMySqlTest, connStrMySql, dbMySqlconnect = tryconnection.try_connection(
-        verbose, cs, 5, **c
-    )
-
-
-if doPostgresTest:
-    _computername = "testpg.2txt.us"
-    _databasename = "adotest"
-    _username = "adotestuser"
-    _password = "12345678"
-    kws = {"timeout": 4}
-    kws["macro_is64bit"] = [
-        "prov_drv",
-        "Provider=MSDASQL;Driver={PostgreSQL Unicode(x64)}",
-        "Driver=PostgreSQL Unicode",
-    ]
-    # get driver from http://www.postgresql.org/ftp/odbc/versions/
-    # test using positional and keyword arguments (bad example for real code)
-    if proxy_host:
-        kws["proxy_host"] = proxy_host
-    print("    ...Testing PostgreSQL login to {}...".format(_computername))
-    doPostgresTest, connStrPostgres, dbPostgresConnect = tryconnection.try_connection(
-        verbose,
-        "%(prov_drv)s;Server=%(host)s;Database=%(database)s;uid=%(user)s;pwd=%(password)s;port=5430;",  # note nonstandard port
-        _username,
-        _password,
-        _computername,
-        _databasename,
-        **kws
-    )
-
-assert (
-    doAccessTest or doSqlServerTest or doMySqlTest or doPostgresTest
-), "No database engine found for testing"
diff --git a/lib/adodbapi/test/dbapi20.py b/lib/adodbapi/test/dbapi20.py
deleted file mode 100644
index e378b194..00000000
--- a/lib/adodbapi/test/dbapi20.py
+++ /dev/null
@@ -1,939 +0,0 @@
-#!/usr/bin/env python
-""" Python DB API 2.0 driver compliance unit test suite. 
-    
-    This software is Public Domain and may be used without restrictions.
-
- "Now we have booze and barflies entering the discussion, plus rumours of
-  DBAs on drugs... and I won't tell you what flashes through my mind each
-  time I read the subject line with 'Anal Compliance' in it.  All around
-  this is turning out to be a thoroughly unwholesome unit test."
-
-    -- Ian Bicking
-"""
-
-__version__ = "$Revision: 1.15.0 $"[11:-2]
-__author__ = "Stuart Bishop <stuart@stuartbishop.net>"
-
-import sys
-import time
-import unittest
-
-if sys.version[0] >= "3":  # python 3.x
-    _BaseException = Exception
-
-    def _failUnless(self, expr, msg=None):
-        self.assertTrue(expr, msg)
-
-else:  # python 2.x
-    from exceptions import Exception as _BaseException
-
-    def _failUnless(self, expr, msg=None):
-        self.failUnless(expr, msg)  ## deprecated since Python 2.6
-
-
-# set this to "True" to follow API 2.0 to the letter
-TEST_FOR_NON_IDEMPOTENT_CLOSE = False
-
-# Revision 1.15  2019/11/22 00:50:00  kf7xm
-# Make Turn off IDEMPOTENT_CLOSE a proper skipTest
-
-# Revision 1.14  2013/05/20 11:02:05  kf7xm
-# Add a literal string to the format insertion test to catch trivial re-format algorithms
-
-# Revision 1.13  2013/05/08 14:31:50  kf7xm
-# Quick switch to Turn off IDEMPOTENT_CLOSE test. Also: Silence teardown failure
-
-
-# Revision 1.12  2009/02/06 03:35:11  kf7xm
-# Tested okay with Python 3.0, includes last minute patches from Mark H.
-#
-# Revision 1.1.1.1.2.1  2008/09/20 19:54:59  rupole
-# Include latest changes from main branch
-# Updates for py3k
-#
-# Revision 1.11  2005/01/02 02:41:01  zenzen
-# Update author email address
-#
-# Revision 1.10  2003/10/09 03:14:14  zenzen
-# Add test for DB API 2.0 optional extension, where database exceptions
-# are exposed as attributes on the Connection object.
-#
-# Revision 1.9  2003/08/13 01:16:36  zenzen
-# Minor tweak from Stefan Fleiter
-#
-# Revision 1.8  2003/04/10 00:13:25  zenzen
-# Changes, as per suggestions by M.-A. Lemburg
-# - Add a table prefix, to ensure namespace collisions can always be avoided
-#
-# Revision 1.7  2003/02/26 23:33:37  zenzen
-# Break out DDL into helper functions, as per request by David Rushby
-#
-# Revision 1.6  2003/02/21 03:04:33  zenzen
-# Stuff from Henrik Ekelund:
-#     added test_None
-#     added test_nextset & hooks
-#
-# Revision 1.5  2003/02/17 22:08:43  zenzen
-# Implement suggestions and code from Henrik Eklund - test that cursor.arraysize
-# defaults to 1 & generic cursor.callproc test added
-#
-# Revision 1.4  2003/02/15 00:16:33  zenzen
-# Changes, as per suggestions and bug reports by M.-A. Lemburg,
-# Matthew T. Kromer, Federico Di Gregorio and Daniel Dittmar
-# - Class renamed
-# - Now a subclass of TestCase, to avoid requiring the driver stub
-#   to use multiple inheritance
-# - Reversed the polarity of buggy test in test_description
-# - Test exception heirarchy correctly
-# - self.populate is now self._populate(), so if a driver stub
-#   overrides self.ddl1 this change propogates
-# - VARCHAR columns now have a width, which will hopefully make the
-#   DDL even more portible (this will be reversed if it causes more problems)
-# - cursor.rowcount being checked after various execute and fetchXXX methods
-# - Check for fetchall and fetchmany returning empty lists after results
-#   are exhausted (already checking for empty lists if select retrieved
-#   nothing
-# - Fix bugs in test_setoutputsize_basic and test_setinputsizes
-#
-def str2bytes(sval):
-    if sys.version_info < (3, 0) and isinstance(sval, str):
-        sval = sval.decode("latin1")
-    return sval.encode("latin1")  # python 3 make unicode into bytes
-
-
-class DatabaseAPI20Test(unittest.TestCase):
-    """Test a database self.driver for DB API 2.0 compatibility.
-    This implementation tests Gadfly, but the TestCase
-    is structured so that other self.drivers can subclass this
-    test case to ensure compiliance with the DB-API. It is
-    expected that this TestCase may be expanded in the future
-    if ambiguities or edge conditions are discovered.
-
-    The 'Optional Extensions' are not yet being tested.
-
-    self.drivers should subclass this test, overriding setUp, tearDown,
-    self.driver, connect_args and connect_kw_args. Class specification
-    should be as follows:
-
-    import dbapi20
-    class mytest(dbapi20.DatabaseAPI20Test):
-       [...]
-
-    Don't 'import DatabaseAPI20Test from dbapi20', or you will
-    confuse the unit tester - just 'import dbapi20'.
-    """
-
-    # The self.driver module. This should be the module where the 'connect'
-    # method is to be found
-    driver = None
-    connect_args = ()  # List of arguments to pass to connect
-    connect_kw_args = {}  # Keyword arguments for connect
-    table_prefix = "dbapi20test_"  # If you need to specify a prefix for tables
-
-    ddl1 = "create table %sbooze (name varchar(20))" % table_prefix
-    ddl2 = "create table %sbarflys (name varchar(20), drink varchar(30))" % table_prefix
-    xddl1 = "drop table %sbooze" % table_prefix
-    xddl2 = "drop table %sbarflys" % table_prefix
-
-    lowerfunc = "lower"  # Name of stored procedure to convert string->lowercase
-
-    # Some drivers may need to override these helpers, for example adding
-    # a 'commit' after the execute.
-    def executeDDL1(self, cursor):
-        cursor.execute(self.ddl1)
-
-    def executeDDL2(self, cursor):
-        cursor.execute(self.ddl2)
-
-    def setUp(self):
-        """self.drivers should override this method to perform required setup
-        if any is necessary, such as creating the database.
-        """
-        pass
-
-    def tearDown(self):
-        """self.drivers should override this method to perform required cleanup
-        if any is necessary, such as deleting the test database.
-        The default drops the tables that may be created.
-        """
-        try:
-            con = self._connect()
-            try:
-                cur = con.cursor()
-                for ddl in (self.xddl1, self.xddl2):
-                    try:
-                        cur.execute(ddl)
-                        con.commit()
-                    except self.driver.Error:
-                        # Assume table didn't exist. Other tests will check if
-                        # execute is busted.
-                        pass
-            finally:
-                con.close()
-        except _BaseException:
-            pass
-
-    def _connect(self):
-        try:
-            r = self.driver.connect(*self.connect_args, **self.connect_kw_args)
-        except AttributeError:
-            self.fail("No connect method found in self.driver module")
-        return r
-
-    def test_connect(self):
-        con = self._connect()
-        con.close()
-
-    def test_apilevel(self):
-        try:
-            # Must exist
-            apilevel = self.driver.apilevel
-            # Must equal 2.0
-            self.assertEqual(apilevel, "2.0")
-        except AttributeError:
-            self.fail("Driver doesn't define apilevel")
-
-    def test_threadsafety(self):
-        try:
-            # Must exist
-            threadsafety = self.driver.threadsafety
-            # Must be a valid value
-            _failUnless(self, threadsafety in (0, 1, 2, 3))
-        except AttributeError:
-            self.fail("Driver doesn't define threadsafety")
-
-    def test_paramstyle(self):
-        try:
-            # Must exist
-            paramstyle = self.driver.paramstyle
-            # Must be a valid value
-            _failUnless(
-                self, paramstyle in ("qmark", "numeric", "named", "format", "pyformat")
-            )
-        except AttributeError:
-            self.fail("Driver doesn't define paramstyle")
-
-    def test_Exceptions(self):
-        # Make sure required exceptions exist, and are in the
-        # defined heirarchy.
-        if sys.version[0] == "3":  # under Python 3 StardardError no longer exists
-            self.assertTrue(issubclass(self.driver.Warning, Exception))
-            self.assertTrue(issubclass(self.driver.Error, Exception))
-        else:
-            self.failUnless(issubclass(self.driver.Warning, Exception))
-            self.failUnless(issubclass(self.driver.Error, Exception))
-
-        _failUnless(self, issubclass(self.driver.InterfaceError, self.driver.Error))
-        _failUnless(self, issubclass(self.driver.DatabaseError, self.driver.Error))
-        _failUnless(self, issubclass(self.driver.OperationalError, self.driver.Error))
-        _failUnless(self, issubclass(self.driver.IntegrityError, self.driver.Error))
-        _failUnless(self, issubclass(self.driver.InternalError, self.driver.Error))
-        _failUnless(self, issubclass(self.driver.ProgrammingError, self.driver.Error))
-        _failUnless(self, issubclass(self.driver.NotSupportedError, self.driver.Error))
-
-    def test_ExceptionsAsConnectionAttributes(self):
-        # OPTIONAL EXTENSION
-        # Test for the optional DB API 2.0 extension, where the exceptions
-        # are exposed as attributes on the Connection object
-        # I figure this optional extension will be implemented by any
-        # driver author who is using this test suite, so it is enabled
-        # by default.
-        con = self._connect()
-        drv = self.driver
-        _failUnless(self, con.Warning is drv.Warning)
-        _failUnless(self, con.Error is drv.Error)
-        _failUnless(self, con.InterfaceError is drv.InterfaceError)
-        _failUnless(self, con.DatabaseError is drv.DatabaseError)
-        _failUnless(self, con.OperationalError is drv.OperationalError)
-        _failUnless(self, con.IntegrityError is drv.IntegrityError)
-        _failUnless(self, con.InternalError is drv.InternalError)
-        _failUnless(self, con.ProgrammingError is drv.ProgrammingError)
-        _failUnless(self, con.NotSupportedError is drv.NotSupportedError)
-
-    def test_commit(self):
-        con = self._connect()
-        try:
-            # Commit must work, even if it doesn't do anything
-            con.commit()
-        finally:
-            con.close()
-
-    def test_rollback(self):
-        con = self._connect()
-        # If rollback is defined, it should either work or throw
-        # the documented exception
-        if hasattr(con, "rollback"):
-            try:
-                con.rollback()
-            except self.driver.NotSupportedError:
-                pass
-
-    def test_cursor(self):
-        con = self._connect()
-        try:
-            cur = con.cursor()
-        finally:
-            con.close()
-
-    def test_cursor_isolation(self):
-        con = self._connect()
-        try:
-            # Make sure cursors created from the same connection have
-            # the documented transaction isolation level
-            cur1 = con.cursor()
-            cur2 = con.cursor()
-            self.executeDDL1(cur1)
-            cur1.execute(
-                "insert into %sbooze values ('Victoria Bitter')" % (self.table_prefix)
-            )
-            cur2.execute("select name from %sbooze" % self.table_prefix)
-            booze = cur2.fetchall()
-            self.assertEqual(len(booze), 1)
-            self.assertEqual(len(booze[0]), 1)
-            self.assertEqual(booze[0][0], "Victoria Bitter")
-        finally:
-            con.close()
-
-    def test_description(self):
-        con = self._connect()
-        try:
-            cur = con.cursor()
-            self.executeDDL1(cur)
-            self.assertEqual(
-                cur.description,
-                None,
-                "cursor.description should be none after executing a "
-                "statement that can return no rows (such as DDL)",
-            )
-            cur.execute("select name from %sbooze" % self.table_prefix)
-            self.assertEqual(
-                len(cur.description), 1, "cursor.description describes too many columns"
-            )
-            self.assertEqual(
-                len(cur.description[0]),
-                7,
-                "cursor.description[x] tuples must have 7 elements",
-            )
-            self.assertEqual(
-                cur.description[0][0].lower(),
-                "name",
-                "cursor.description[x][0] must return column name",
-            )
-            self.assertEqual(
-                cur.description[0][1],
-                self.driver.STRING,
-                "cursor.description[x][1] must return column type. Got %r"
-                % cur.description[0][1],
-            )
-
-            # Make sure self.description gets reset
-            self.executeDDL2(cur)
-            self.assertEqual(
-                cur.description,
-                None,
-                "cursor.description not being set to None when executing "
-                "no-result statements (eg. DDL)",
-            )
-        finally:
-            con.close()
-
-    def test_rowcount(self):
-        con = self._connect()
-        try:
-            cur = con.cursor()
-            self.executeDDL1(cur)
-            _failUnless(
-                self,
-                cur.rowcount in (-1, 0),  # Bug #543885
-                "cursor.rowcount should be -1 or 0 after executing no-result "
-                "statements",
-            )
-            cur.execute(
-                "insert into %sbooze values ('Victoria Bitter')" % (self.table_prefix)
-            )
-            _failUnless(
-                self,
-                cur.rowcount in (-1, 1),
-                "cursor.rowcount should == number or rows inserted, or "
-                "set to -1 after executing an insert statement",
-            )
-            cur.execute("select name from %sbooze" % self.table_prefix)
-            _failUnless(
-                self,
-                cur.rowcount in (-1, 1),
-                "cursor.rowcount should == number of rows returned, or "
-                "set to -1 after executing a select statement",
-            )
-            self.executeDDL2(cur)
-            self.assertEqual(
-                cur.rowcount,
-                -1,
-                "cursor.rowcount not being reset to -1 after executing "
-                "no-result statements",
-            )
-        finally:
-            con.close()
-
-    lower_func = "lower"
-
-    def test_callproc(self):
-        con = self._connect()
-        try:
-            cur = con.cursor()
-            if self.lower_func and hasattr(cur, "callproc"):
-                r = cur.callproc(self.lower_func, ("FOO",))
-                self.assertEqual(len(r), 1)
-                self.assertEqual(r[0], "FOO")
-                r = cur.fetchall()
-                self.assertEqual(len(r), 1, "callproc produced no result set")
-                self.assertEqual(len(r[0]), 1, "callproc produced invalid result set")
-                self.assertEqual(r[0][0], "foo", "callproc produced invalid results")
-        finally:
-            con.close()
-
-    def test_close(self):
-        con = self._connect()
-        try:
-            cur = con.cursor()
-        finally:
-            con.close()
-
-        # cursor.execute should raise an Error if called after connection
-        # closed
-        self.assertRaises(self.driver.Error, self.executeDDL1, cur)
-
-        # connection.commit should raise an Error if called after connection'
-        # closed.'
-        self.assertRaises(self.driver.Error, con.commit)
-
-        # connection.close should raise an Error if called more than once
-        #!!! reasonable persons differ about the usefulness of this test and this feature !!!
-        if TEST_FOR_NON_IDEMPOTENT_CLOSE:
-            self.assertRaises(self.driver.Error, con.close)
-        else:
-            self.skipTest(
-                "Non-idempotent close is considered a bad thing by some people."
-            )
-
-    def test_execute(self):
-        con = self._connect()
-        try:
-            cur = con.cursor()
-            self._paraminsert(cur)
-        finally:
-            con.close()
-
-    def _paraminsert(self, cur):
-        self.executeDDL2(cur)
-        cur.execute(
-            "insert into %sbarflys values ('Victoria Bitter', 'thi%%s :may ca%%(u)se? troub:1e')"
-            % (self.table_prefix)
-        )
-        _failUnless(self, cur.rowcount in (-1, 1))
-
-        if self.driver.paramstyle == "qmark":
-            cur.execute(
-                "insert into %sbarflys values (?, 'thi%%s :may ca%%(u)se? troub:1e')"
-                % self.table_prefix,
-                ("Cooper's",),
-            )
-        elif self.driver.paramstyle == "numeric":
-            cur.execute(
-                "insert into %sbarflys values (:1, 'thi%%s :may ca%%(u)se? troub:1e')"
-                % self.table_prefix,
-                ("Cooper's",),
-            )
-        elif self.driver.paramstyle == "named":
-            cur.execute(
-                "insert into %sbarflys values (:beer, 'thi%%s :may ca%%(u)se? troub:1e')"
-                % self.table_prefix,
-                {"beer": "Cooper's"},
-            )
-        elif self.driver.paramstyle == "format":
-            cur.execute(
-                "insert into %sbarflys values (%%s, 'thi%%s :may ca%%(u)se? troub:1e')"
-                % self.table_prefix,
-                ("Cooper's",),
-            )
-        elif self.driver.paramstyle == "pyformat":
-            cur.execute(
-                "insert into %sbarflys values (%%(beer)s, 'thi%%s :may ca%%(u)se? troub:1e')"
-                % self.table_prefix,
-                {"beer": "Cooper's"},
-            )
-        else:
-            self.fail("Invalid paramstyle")
-        _failUnless(self, cur.rowcount in (-1, 1))
-
-        cur.execute("select name, drink from %sbarflys" % self.table_prefix)
-        res = cur.fetchall()
-        self.assertEqual(len(res), 2, "cursor.fetchall returned too few rows")
-        beers = [res[0][0], res[1][0]]
-        beers.sort()
-        self.assertEqual(
-            beers[0],
-            "Cooper's",
-            "cursor.fetchall retrieved incorrect data, or data inserted " "incorrectly",
-        )
-        self.assertEqual(
-            beers[1],
-            "Victoria Bitter",
-            "cursor.fetchall retrieved incorrect data, or data inserted " "incorrectly",
-        )
-        trouble = "thi%s :may ca%(u)se? troub:1e"
-        self.assertEqual(
-            res[0][1],
-            trouble,
-            "cursor.fetchall retrieved incorrect data, or data inserted "
-            "incorrectly. Got=%s, Expected=%s" % (repr(res[0][1]), repr(trouble)),
-        )
-        self.assertEqual(
-            res[1][1],
-            trouble,
-            "cursor.fetchall retrieved incorrect data, or data inserted "
-            "incorrectly. Got=%s, Expected=%s" % (repr(res[1][1]), repr(trouble)),
-        )
-
-    def test_executemany(self):
-        con = self._connect()
-        try:
-            cur = con.cursor()
-            self.executeDDL1(cur)
-            largs = [("Cooper's",), ("Boag's",)]
-            margs = [{"beer": "Cooper's"}, {"beer": "Boag's"}]
-            if self.driver.paramstyle == "qmark":
-                cur.executemany(
-                    "insert into %sbooze values (?)" % self.table_prefix, largs
-                )
-            elif self.driver.paramstyle == "numeric":
-                cur.executemany(
-                    "insert into %sbooze values (:1)" % self.table_prefix, largs
-                )
-            elif self.driver.paramstyle == "named":
-                cur.executemany(
-                    "insert into %sbooze values (:beer)" % self.table_prefix, margs
-                )
-            elif self.driver.paramstyle == "format":
-                cur.executemany(
-                    "insert into %sbooze values (%%s)" % self.table_prefix, largs
-                )
-            elif self.driver.paramstyle == "pyformat":
-                cur.executemany(
-                    "insert into %sbooze values (%%(beer)s)" % (self.table_prefix),
-                    margs,
-                )
-            else:
-                self.fail("Unknown paramstyle")
-            _failUnless(
-                self,
-                cur.rowcount in (-1, 2),
-                "insert using cursor.executemany set cursor.rowcount to "
-                "incorrect value %r" % cur.rowcount,
-            )
-            cur.execute("select name from %sbooze" % self.table_prefix)
-            res = cur.fetchall()
-            self.assertEqual(
-                len(res), 2, "cursor.fetchall retrieved incorrect number of rows"
-            )
-            beers = [res[0][0], res[1][0]]
-            beers.sort()
-            self.assertEqual(
-                beers[0], "Boag's", 'incorrect data "%s" retrieved' % beers[0]
-            )
-            self.assertEqual(beers[1], "Cooper's", "incorrect data retrieved")
-        finally:
-            con.close()
-
-    def test_fetchone(self):
-        con = self._connect()
-        try:
-            cur = con.cursor()
-
-            # cursor.fetchone should raise an Error if called before
-            # executing a select-type query
-            self.assertRaises(self.driver.Error, cur.fetchone)
-
-            # cursor.fetchone should raise an Error if called after
-            # executing a query that cannnot return rows
-            self.executeDDL1(cur)
-            self.assertRaises(self.driver.Error, cur.fetchone)
-
-            cur.execute("select name from %sbooze" % self.table_prefix)
-            self.assertEqual(
-                cur.fetchone(),
-                None,
-                "cursor.fetchone should return None if a query retrieves " "no rows",
-            )
-            _failUnless(self, cur.rowcount in (-1, 0))
-
-            # cursor.fetchone should raise an Error if called after
-            # executing a query that cannnot return rows
-            cur.execute(
-                "insert into %sbooze values ('Victoria Bitter')" % (self.table_prefix)
-            )
-            self.assertRaises(self.driver.Error, cur.fetchone)
-
-            cur.execute("select name from %sbooze" % self.table_prefix)
-            r = cur.fetchone()
-            self.assertEqual(
-                len(r), 1, "cursor.fetchone should have retrieved a single row"
-            )
-            self.assertEqual(
-                r[0], "Victoria Bitter", "cursor.fetchone retrieved incorrect data"
-            )
-            self.assertEqual(
-                cur.fetchone(),
-                None,
-                "cursor.fetchone should return None if no more rows available",
-            )
-            _failUnless(self, cur.rowcount in (-1, 1))
-        finally:
-            con.close()
-
-    samples = [
-        "Carlton Cold",
-        "Carlton Draft",
-        "Mountain Goat",
-        "Redback",
-        "Victoria Bitter",
-        "XXXX",
-    ]
-
-    def _populate(self):
-        """Return a list of sql commands to setup the DB for the fetch
-        tests.
-        """
-        populate = [
-            "insert into %sbooze values ('%s')" % (self.table_prefix, s)
-            for s in self.samples
-        ]
-        return populate
-
-    def test_fetchmany(self):
-        con = self._connect()
-        try:
-            cur = con.cursor()
-
-            # cursor.fetchmany should raise an Error if called without
-            # issuing a query
-            self.assertRaises(self.driver.Error, cur.fetchmany, 4)
-
-            self.executeDDL1(cur)
-            for sql in self._populate():
-                cur.execute(sql)
-
-            cur.execute("select name from %sbooze" % self.table_prefix)
-            r = cur.fetchmany()
-            self.assertEqual(
-                len(r),
-                1,
-                "cursor.fetchmany retrieved incorrect number of rows, "
-                "default of arraysize is one.",
-            )
-            cur.arraysize = 10
-            r = cur.fetchmany(3)  # Should get 3 rows
-            self.assertEqual(
-                len(r), 3, "cursor.fetchmany retrieved incorrect number of rows"
-            )
-            r = cur.fetchmany(4)  # Should get 2 more
-            self.assertEqual(
-                len(r), 2, "cursor.fetchmany retrieved incorrect number of rows"
-            )
-            r = cur.fetchmany(4)  # Should be an empty sequence
-            self.assertEqual(
-                len(r),
-                0,
-                "cursor.fetchmany should return an empty sequence after "
-                "results are exhausted",
-            )
-            _failUnless(self, cur.rowcount in (-1, 6))
-
-            # Same as above, using cursor.arraysize
-            cur.arraysize = 4
-            cur.execute("select name from %sbooze" % self.table_prefix)
-            r = cur.fetchmany()  # Should get 4 rows
-            self.assertEqual(
-                len(r), 4, "cursor.arraysize not being honoured by fetchmany"
-            )
-            r = cur.fetchmany()  # Should get 2 more
-            self.assertEqual(len(r), 2)
-            r = cur.fetchmany()  # Should be an empty sequence
-            self.assertEqual(len(r), 0)
-            _failUnless(self, cur.rowcount in (-1, 6))
-
-            cur.arraysize = 6
-            cur.execute("select name from %sbooze" % self.table_prefix)
-            rows = cur.fetchmany()  # Should get all rows
-            _failUnless(self, cur.rowcount in (-1, 6))
-            self.assertEqual(len(rows), 6)
-            self.assertEqual(len(rows), 6)
-            rows = [r[0] for r in rows]
-            rows.sort()
-
-            # Make sure we get the right data back out
-            for i in range(0, 6):
-                self.assertEqual(
-                    rows[i],
-                    self.samples[i],
-                    "incorrect data retrieved by cursor.fetchmany",
-                )
-
-            rows = cur.fetchmany()  # Should return an empty list
-            self.assertEqual(
-                len(rows),
-                0,
-                "cursor.fetchmany should return an empty sequence if "
-                "called after the whole result set has been fetched",
-            )
-            _failUnless(self, cur.rowcount in (-1, 6))
-
-            self.executeDDL2(cur)
-            cur.execute("select name from %sbarflys" % self.table_prefix)
-            r = cur.fetchmany()  # Should get empty sequence
-            self.assertEqual(
-                len(r),
-                0,
-                "cursor.fetchmany should return an empty sequence if "
-                "query retrieved no rows",
-            )
-            _failUnless(self, cur.rowcount in (-1, 0))
-
-        finally:
-            con.close()
-
-    def test_fetchall(self):
-        con = self._connect()
-        try:
-            cur = con.cursor()
-            # cursor.fetchall should raise an Error if called
-            # without executing a query that may return rows (such
-            # as a select)
-            self.assertRaises(self.driver.Error, cur.fetchall)
-
-            self.executeDDL1(cur)
-            for sql in self._populate():
-                cur.execute(sql)
-
-            # cursor.fetchall should raise an Error if called
-            # after executing a a statement that cannot return rows
-            self.assertRaises(self.driver.Error, cur.fetchall)
-
-            cur.execute("select name from %sbooze" % self.table_prefix)
-            rows = cur.fetchall()
-            _failUnless(self, cur.rowcount in (-1, len(self.samples)))
-            self.assertEqual(
-                len(rows),
-                len(self.samples),
-                "cursor.fetchall did not retrieve all rows",
-            )
-            rows = [r[0] for r in rows]
-            rows.sort()
-            for i in range(0, len(self.samples)):
-                self.assertEqual(
-                    rows[i], self.samples[i], "cursor.fetchall retrieved incorrect rows"
-                )
-            rows = cur.fetchall()
-            self.assertEqual(
-                len(rows),
-                0,
-                "cursor.fetchall should return an empty list if called "
-                "after the whole result set has been fetched",
-            )
-            _failUnless(self, cur.rowcount in (-1, len(self.samples)))
-
-            self.executeDDL2(cur)
-            cur.execute("select name from %sbarflys" % self.table_prefix)
-            rows = cur.fetchall()
-            _failUnless(self, cur.rowcount in (-1, 0))
-            self.assertEqual(
-                len(rows),
-                0,
-                "cursor.fetchall should return an empty list if "
-                "a select query returns no rows",
-            )
-
-        finally:
-            con.close()
-
-    def test_mixedfetch(self):
-        con = self._connect()
-        try:
-            cur = con.cursor()
-            self.executeDDL1(cur)
-            for sql in self._populate():
-                cur.execute(sql)
-
-            cur.execute("select name from %sbooze" % self.table_prefix)
-            rows1 = cur.fetchone()
-            rows23 = cur.fetchmany(2)
-            rows4 = cur.fetchone()
-            rows56 = cur.fetchall()
-            _failUnless(self, cur.rowcount in (-1, 6))
-            self.assertEqual(
-                len(rows23), 2, "fetchmany returned incorrect number of rows"
-            )
-            self.assertEqual(
-                len(rows56), 2, "fetchall returned incorrect number of rows"
-            )
-
-            rows = [rows1[0]]
-            rows.extend([rows23[0][0], rows23[1][0]])
-            rows.append(rows4[0])
-            rows.extend([rows56[0][0], rows56[1][0]])
-            rows.sort()
-            for i in range(0, len(self.samples)):
-                self.assertEqual(
-                    rows[i], self.samples[i], "incorrect data retrieved or inserted"
-                )
-        finally:
-            con.close()
-
-    def help_nextset_setUp(self, cur):
-        """Should create a procedure called deleteme
-        that returns two result sets, first the
-        number of rows in booze then "name from booze"
-        """
-        raise NotImplementedError("Helper not implemented")
-        # sql="""
-        #    create procedure deleteme as
-        #    begin
-        #        select count(*) from booze
-        #        select name from booze
-        #    end
-        # """
-        # cur.execute(sql)
-
-    def help_nextset_tearDown(self, cur):
-        "If cleaning up is needed after nextSetTest"
-        raise NotImplementedError("Helper not implemented")
-        # cur.execute("drop procedure deleteme")
-
-    def test_nextset(self):
-        con = self._connect()
-        try:
-            cur = con.cursor()
-            if not hasattr(cur, "nextset"):
-                return
-
-            try:
-                self.executeDDL1(cur)
-                sql = self._populate()
-                for sql in self._populate():
-                    cur.execute(sql)
-
-                self.help_nextset_setUp(cur)
-
-                cur.callproc("deleteme")
-                numberofrows = cur.fetchone()
-                assert numberofrows[0] == len(self.samples)
-                assert cur.nextset()
-                names = cur.fetchall()
-                assert len(names) == len(self.samples)
-                s = cur.nextset()
-                assert s == None, "No more return sets, should return None"
-            finally:
-                self.help_nextset_tearDown(cur)
-
-        finally:
-            con.close()
-
-    def test_nextset(self):
-        raise NotImplementedError("Drivers need to override this test")
-
-    def test_arraysize(self):
-        # Not much here - rest of the tests for this are in test_fetchmany
-        con = self._connect()
-        try:
-            cur = con.cursor()
-            _failUnless(
-                self, hasattr(cur, "arraysize"), "cursor.arraysize must be defined"
-            )
-        finally:
-            con.close()
-
-    def test_setinputsizes(self):
-        con = self._connect()
-        try:
-            cur = con.cursor()
-            cur.setinputsizes((25,))
-            self._paraminsert(cur)  # Make sure cursor still works
-        finally:
-            con.close()
-
-    def test_setoutputsize_basic(self):
-        # Basic test is to make sure setoutputsize doesn't blow up
-        con = self._connect()
-        try:
-            cur = con.cursor()
-            cur.setoutputsize(1000)
-            cur.setoutputsize(2000, 0)
-            self._paraminsert(cur)  # Make sure the cursor still works
-        finally:
-            con.close()
-
-    def test_setoutputsize(self):
-        # Real test for setoutputsize is driver dependant
-        raise NotImplementedError("Driver needed to override this test")
-
-    def test_None(self):
-        con = self._connect()
-        try:
-            cur = con.cursor()
-            self.executeDDL1(cur)
-            cur.execute("insert into %sbooze values (NULL)" % self.table_prefix)
-            cur.execute("select name from %sbooze" % self.table_prefix)
-            r = cur.fetchall()
-            self.assertEqual(len(r), 1)
-            self.assertEqual(len(r[0]), 1)
-            self.assertEqual(r[0][0], None, "NULL value not returned as None")
-        finally:
-            con.close()
-
-    def test_Date(self):
-        d1 = self.driver.Date(2002, 12, 25)
-        d2 = self.driver.DateFromTicks(time.mktime((2002, 12, 25, 0, 0, 0, 0, 0, 0)))
-        # Can we assume this? API doesn't specify, but it seems implied
-        # self.assertEqual(str(d1),str(d2))
-
-    def test_Time(self):
-        t1 = self.driver.Time(13, 45, 30)
-        t2 = self.driver.TimeFromTicks(time.mktime((2001, 1, 1, 13, 45, 30, 0, 0, 0)))
-        # Can we assume this? API doesn't specify, but it seems implied
-        # self.assertEqual(str(t1),str(t2))
-
-    def test_Timestamp(self):
-        t1 = self.driver.Timestamp(2002, 12, 25, 13, 45, 30)
-        t2 = self.driver.TimestampFromTicks(
-            time.mktime((2002, 12, 25, 13, 45, 30, 0, 0, 0))
-        )
-        # Can we assume this? API doesn't specify, but it seems implied
-        # self.assertEqual(str(t1),str(t2))
-
-    def test_Binary(self):
-        b = self.driver.Binary(str2bytes("Something"))
-        b = self.driver.Binary(str2bytes(""))
-
-    def test_STRING(self):
-        _failUnless(
-            self, hasattr(self.driver, "STRING"), "module.STRING must be defined"
-        )
-
-    def test_BINARY(self):
-        _failUnless(
-            self, hasattr(self.driver, "BINARY"), "module.BINARY must be defined."
-        )
-
-    def test_NUMBER(self):
-        _failUnless(
-            self, hasattr(self.driver, "NUMBER"), "module.NUMBER must be defined."
-        )
-
-    def test_DATETIME(self):
-        _failUnless(
-            self, hasattr(self.driver, "DATETIME"), "module.DATETIME must be defined."
-        )
-
-    def test_ROWID(self):
-        _failUnless(
-            self, hasattr(self.driver, "ROWID"), "module.ROWID must be defined."
-        )
diff --git a/lib/adodbapi/test/is64bit.py b/lib/adodbapi/test/is64bit.py
deleted file mode 100644
index 39834540..00000000
--- a/lib/adodbapi/test/is64bit.py
+++ /dev/null
@@ -1,41 +0,0 @@
-"""is64bit.Python() --> boolean value of detected Python word size. is64bit.os() --> os build version"""
-import sys
-
-
-def Python():
-    if sys.platform == "cli":  # IronPython
-        import System
-
-        return System.IntPtr.Size == 8
-    else:
-        try:
-            return sys.maxsize > 2147483647
-        except AttributeError:
-            return sys.maxint > 2147483647
-
-
-def os():
-    import platform
-
-    pm = platform.machine()
-    if pm != ".." and pm.endswith("64"):  # recent Python (not Iron)
-        return True
-    else:
-        import os
-
-        if "PROCESSOR_ARCHITEW6432" in os.environ:
-            return True  # 32 bit program running on 64 bit Windows
-        try:
-            return os.environ["PROCESSOR_ARCHITECTURE"].endswith(
-                "64"
-            )  # 64 bit Windows 64 bit program
-        except IndexError:
-            pass  # not Windows
-        try:
-            return "64" in platform.architecture()[0]  # this often works in Linux
-        except:
-            return False  # is an older version of Python, assume also an older os (best we can guess)
-
-
-if __name__ == "__main__":
-    print("is64bit.Python() =", Python(), "is64bit.os() =", os())
diff --git a/lib/adodbapi/test/setuptestframework.py b/lib/adodbapi/test/setuptestframework.py
deleted file mode 100644
index fcaaf1ae..00000000
--- a/lib/adodbapi/test/setuptestframework.py
+++ /dev/null
@@ -1,134 +0,0 @@
-#!/usr/bin/python2
-# Configure this in order to run the testcases.
-"setuptestframework.py v 2.6.0.8"
-import os
-import shutil
-import sys
-import tempfile
-
-try:
-    OSErrors = (WindowsError, OSError)
-except NameError:  # not running on Windows
-    OSErrors = OSError
-
-
-def maketemp():
-    temphome = tempfile.gettempdir()
-    tempdir = os.path.join(temphome, "adodbapi_test")
-    try:
-        os.mkdir(tempdir)
-    except:
-        pass
-    return tempdir
-
-
-def _cleanup_function(testfolder, mdb_name):
-    try:
-        os.unlink(os.path.join(testfolder, mdb_name))
-    except:
-        pass  # mdb database not present
-    try:
-        shutil.rmtree(testfolder)
-        print("   cleaned up folder", testfolder)
-    except:
-        pass  # test package not present
-
-
-def getcleanupfunction():
-    return _cleanup_function
-
-
-def find_ado_path():
-    adoName = os.path.normpath(os.getcwd() + "/../../adodbapi.py")
-    adoPackage = os.path.dirname(adoName)
-    return adoPackage
-
-
-# make a new package directory for the test copy of ado
-def makeadopackage(testfolder):
-    adoName = os.path.normpath(os.getcwd() + "/../adodbapi.py")
-    adoPath = os.path.dirname(adoName)
-    if os.path.exists(adoName):
-        newpackage = os.path.join(testfolder, "adodbapi")
-        try:
-            os.mkdir(newpackage)
-        except OSErrors:
-            print(
-                "*Note: temporary adodbapi package already exists: may be two versions running?"
-            )
-        for f in os.listdir(adoPath):
-            if f.endswith(".py"):
-                shutil.copy(os.path.join(adoPath, f), newpackage)
-        if sys.version_info >= (3, 0):  # only when running Py3.n
-            save = sys.stdout
-            sys.stdout = None
-            from lib2to3.main import main  # use 2to3 to make test package
-
-            main("lib2to3.fixes", args=["-n", "-w", newpackage])
-            sys.stdout = save
-        return testfolder
-    else:
-        raise EnvironmentError("Connot find source of adodbapi to test.")
-
-
-def makemdb(testfolder, mdb_name):
-    # following setup code borrowed from pywin32 odbc test suite
-    # kindly contributed by Frank Millman.
-    import os
-
-    _accessdatasource = os.path.join(testfolder, mdb_name)
-    if os.path.isfile(_accessdatasource):
-        print("using JET database=", _accessdatasource)
-    else:
-        try:
-            from win32com.client import constants
-            from win32com.client.gencache import EnsureDispatch
-
-            win32 = True
-        except ImportError:  # perhaps we are running IronPython
-            win32 = False  # iron Python
-            try:
-                from System import Activator, Type
-            except:
-                pass
-
-        # Create a brand-new database - what is the story with these?
-        dbe = None
-        for suffix in (".36", ".35", ".30"):
-            try:
-                if win32:
-                    dbe = EnsureDispatch("DAO.DBEngine" + suffix)
-                else:
-                    type = Type.GetTypeFromProgID("DAO.DBEngine" + suffix)
-                    dbe = Activator.CreateInstance(type)
-                break
-            except:
-                pass
-        if dbe:
-            print("    ...Creating ACCESS db at " + _accessdatasource)
-            if win32:
-                workspace = dbe.Workspaces(0)
-                newdb = workspace.CreateDatabase(
-                    _accessdatasource, constants.dbLangGeneral, constants.dbVersion40
-                )
-            else:
-                newdb = dbe.CreateDatabase(
-                    _accessdatasource, ";LANGID=0x0409;CP=1252;COUNTRY=0"
-                )
-            newdb.Close()
-        else:
-            print("    ...copying test ACCESS db to " + _accessdatasource)
-            mdbName = os.path.abspath(
-                os.path.join(os.path.dirname(__file__), "..", "examples", "test.mdb")
-            )
-            import shutil
-
-            shutil.copy(mdbName, _accessdatasource)
-
-    return _accessdatasource
-
-
-if __name__ == "__main__":
-    print("Setting up a Jet database for server to use for remote testing...")
-    temp = maketemp()
-    makemdb(temp, "server_test.mdb")
diff --git a/lib/adodbapi/test/test_adodbapi_dbapi20.py b/lib/adodbapi/test/test_adodbapi_dbapi20.py
deleted file mode 100644
index f8986484..00000000
--- a/lib/adodbapi/test/test_adodbapi_dbapi20.py
+++ /dev/null
@@ -1,200 +0,0 @@
-print("This module depends on the dbapi20 compliance tests created by Stuart Bishop")
-print("(see db-sig mailing list history for info)")
-import platform
-import sys
-import unittest
-
-import dbapi20
-import setuptestframework
-
-testfolder = setuptestframework.maketemp()
-if "--package" in sys.argv:
-    pth = setuptestframework.makeadopackage(testfolder)
-    sys.argv.remove("--package")
-else:
-    pth = setuptestframework.find_ado_path()
-if pth not in sys.path:
-    sys.path.insert(1, pth)
-# function to clean up the temporary folder -- calling program must run this function before exit.
-cleanup = setuptestframework.getcleanupfunction()
-
-import adodbapi
-import adodbapi.is64bit as is64bit
-
-db = adodbapi
-
-if "--verbose" in sys.argv:
-    db.adodbapi.verbose = 3
-
-print(adodbapi.version)
-print("Tested with dbapi20 %s" % dbapi20.__version__)
-
-try:
-    onWindows = bool(sys.getwindowsversion())  # seems to work on all versions of Python
-except:
-    onWindows = False
-
-node = platform.node()
-
-conn_kws = {}
-host = "testsql.2txt.us,1430"  # if None, will use macro to fill in node name
-instance = r"%s\SQLEXPRESS"
-conn_kws["name"] = "adotest"
-
-conn_kws["user"] = "adotestuser"  # None implies Windows security
-conn_kws["password"] = "Sq1234567"
-# macro definition for keyword "security" using macro "auto_security"
-conn_kws["macro_auto_security"] = "security"
-
-if host is None:
-    conn_kws["macro_getnode"] = ["host", instance]
-else:
-    conn_kws["host"] = host
-
-conn_kws[
-    "provider"
-] = "Provider=MSOLEDBSQL;DataTypeCompatibility=80;MARS Connection=True;"
-connStr = "%(provider)s; %(security)s; Initial Catalog=%(name)s;Data Source=%(host)s"
-
-if onWindows and node != "z-PC":
-    pass  # default should make a local SQL Server connection
-elif node == "xxx":  # try Postgres database
-    _computername = "25.223.161.222"
-    _databasename = "adotest"
-    _username = "adotestuser"
-    _password = "12345678"
-    _driver = "PostgreSQL Unicode"
-    _provider = ""
-    connStr = "%sDriver={%s};Server=%s;Database=%s;uid=%s;pwd=%s;" % (
-        _provider,
-        _driver,
-        _computername,
-        _databasename,
-        _username,
-        _password,
-    )
-elif node == "yyy":  # ACCESS data base is known to fail some tests.
-    if is64bit.Python():
-        driver = "Microsoft.ACE.OLEDB.12.0"
-    else:
-        driver = "Microsoft.Jet.OLEDB.4.0"
-    testmdb = setuptestframework.makemdb(testfolder)
-    connStr = r"Provider=%s;Data Source=%s" % (driver, testmdb)
-else:  # try a remote connection to an SQL server
-    conn_kws["proxy_host"] = "25.44.77.176"
-    import adodbapi.remote
-
-    db = adodbapi.remote
-
-print("Using Connection String like=%s" % connStr)
-print("Keywords=%s" % repr(conn_kws))
-
-
-class test_adodbapi(dbapi20.DatabaseAPI20Test):
-    driver = db
-    connect_args = (connStr,)
-    connect_kw_args = conn_kws
-
-    def __init__(self, arg):
-        dbapi20.DatabaseAPI20Test.__init__(self, arg)
-
-    def getTestMethodName(self):
-        return self.id().split(".")[-1]
-
-    def setUp(self):
-        # Call superclass setUp In case this does something in the
-        # future
-        dbapi20.DatabaseAPI20Test.setUp(self)
-        if self.getTestMethodName() == "test_callproc":
-            con = self._connect()
-            engine = con.dbms_name
-            ## print('Using database Engine=%s' % engine) ##
-            if engine != "MS Jet":
-                sql = """
-                    create procedure templower
-                        @theData varchar(50)
-                    as
-                        select lower(@theData)
-                """
-            else:  # Jet
-                sql = """
-                    create procedure templower
-                        (theData varchar(50))
-                    as
-                        select lower(theData);
-                """
-            cur = con.cursor()
-            try:
-                cur.execute(sql)
-                con.commit()
-            except:
-                pass
-            cur.close()
-            con.close()
-            self.lower_func = "templower"
-
-    def tearDown(self):
-        if self.getTestMethodName() == "test_callproc":
-            con = self._connect()
-            cur = con.cursor()
-            try:
-                cur.execute("drop procedure templower")
-            except:
-                pass
-            con.commit()
-        dbapi20.DatabaseAPI20Test.tearDown(self)
-
-    def help_nextset_setUp(self, cur):
-        "Should create a procedure called deleteme"
-        'that returns two result sets, first the number of rows in booze then "name from booze"'
-        sql = """
-            create procedure deleteme as
-            begin
-                select count(*) from %sbooze
-                select name from %sbooze
-            end
-        """ % (
-            self.table_prefix,
-            self.table_prefix,
-        )
-        cur.execute(sql)
-
-    def help_nextset_tearDown(self, cur):
-        "If cleaning up is needed after nextSetTest"
-        try:
-            cur.execute("drop procedure deleteme")
-        except:
-            pass
-
-    def test_nextset(self):
-        con = self._connect()
-        try:
-            cur = con.cursor()
-
-            stmts = [self.ddl1] + self._populate()
-            for sql in stmts:
-                cur.execute(sql)
-
-            self.help_nextset_setUp(cur)
-
-            cur.callproc("deleteme")
-            numberofrows = cur.fetchone()
-            assert numberofrows[0] == 6
-            assert cur.nextset()
-            names = cur.fetchall()
-            assert len(names) == len(self.samples)
-            s = cur.nextset()
-            assert s == None, "No more return sets, should return None"
-        finally:
-            try:
-                self.help_nextset_tearDown(cur)
-            finally:
-                con.close()
-
-    def test_setoutputsize(self):
-        pass
-
-
-if __name__ == "__main__":
-    unittest.main()
-    cleanup(testfolder, None)
diff --git a/lib/adodbapi/test/tryconnection.py b/lib/adodbapi/test/tryconnection.py
deleted file mode 100644
index 9d3901a8..00000000
--- a/lib/adodbapi/test/tryconnection.py
+++ /dev/null
@@ -1,33 +0,0 @@
-remote = False  # automatic testing of remote access has been removed here
-
-
-def try_connection(verbose, *args, **kwargs):
-    import adodbapi
-
-    dbconnect = adodbapi.connect
-    try:
-        s = dbconnect(*args, **kwargs)  # connect to server
-        if verbose:
-            print("Connected to:", s.connection_string)
-            print("which has tables:", s.get_table_names())
-        s.close()  # thanks, it worked, goodbye
-    except adodbapi.DatabaseError as inst:
-        print(inst.args[0])  # should be the error message
-        print("***Failed getting connection using=", repr(args), repr(kwargs))
-        return False, (args, kwargs), None
-
-    print("  (successful)")
-
-    return True, (args, kwargs, remote), dbconnect
-
-
-def try_operation_with_expected_exception(
-    expected_exception_list, some_function, *args, **kwargs
-):
-    try:
-        some_function(*args, **kwargs)
-    except expected_exception_list as e:
-        return True, e
-    except:
-        raise  # an exception other than the expected occurred
-    return False, "The expected exception did not occur"
diff --git a/lib/annotated_types/__init__.py b/lib/annotated_types/__init__.py
deleted file mode 100644
index 2f989504..00000000
--- a/lib/annotated_types/__init__.py
+++ /dev/null
@@ -1,396 +0,0 @@
-import math
-import sys
-from dataclasses import dataclass
-from datetime import timezone
-from typing import TYPE_CHECKING, Any, Callable, Iterator, Optional, SupportsFloat, SupportsIndex, TypeVar, Union
-
-if sys.version_info < (3, 8):
-    from typing_extensions import Protocol, runtime_checkable
-else:
-    from typing import Protocol, runtime_checkable
-
-if sys.version_info < (3, 9):
-    from typing_extensions import Annotated, Literal
-else:
-    from typing import Annotated, Literal
-
-if sys.version_info < (3, 10):
-    EllipsisType = type(Ellipsis)
-    KW_ONLY = {}
-    SLOTS = {}
-else:
-    from types import EllipsisType
-
-    KW_ONLY = {"kw_only": True}
-    SLOTS = {"slots": True}
-
-
-__all__ = (
-    'BaseMetadata',
-    'GroupedMetadata',
-    'Gt',
-    'Ge',
-    'Lt',
-    'Le',
-    'Interval',
-    'MultipleOf',
-    'MinLen',
-    'MaxLen',
-    'Len',
-    'Timezone',
-    'Predicate',
-    'LowerCase',
-    'UpperCase',
-    'IsDigits',
-    'IsFinite',
-    'IsNotFinite',
-    'IsNan',
-    'IsNotNan',
-    'IsInfinite',
-    'IsNotInfinite',
-    'doc',
-    'DocInfo',
-    '__version__',
-)
-
-__version__ = '0.6.0'
-
-
-T = TypeVar('T')
-
-
-# arguments that start with __ are considered
-# positional only
-# see https://peps.python.org/pep-0484/#positional-only-arguments
-
-
-class SupportsGt(Protocol):
-    def __gt__(self: T, __other: T) -> bool:
-        ...
-
-
-class SupportsGe(Protocol):
-    def __ge__(self: T, __other: T) -> bool:
-        ...
-
-
-class SupportsLt(Protocol):
-    def __lt__(self: T, __other: T) -> bool:
-        ...
-
-
-class SupportsLe(Protocol):
-    def __le__(self: T, __other: T) -> bool:
-        ...
-
-
-class SupportsMod(Protocol):
-    def __mod__(self: T, __other: T) -> T:
-        ...
-
-
-class SupportsDiv(Protocol):
-    def __div__(self: T, __other: T) -> T:
-        ...
-
-
-class BaseMetadata:
-    """Base class for all metadata.
-
-    This exists mainly so that implementers
-    can do `isinstance(..., BaseMetadata)` while traversing field annotations.
-    """
-
-    __slots__ = ()
-
-
-@dataclass(frozen=True, **SLOTS)
-class Gt(BaseMetadata):
-    """Gt(gt=x) implies that the value must be greater than x.
-
-    It can be used with any type that supports the ``>`` operator,
-    including numbers, dates and times, strings, sets, and so on.
-    """
-
-    gt: SupportsGt
-
-
-@dataclass(frozen=True, **SLOTS)
-class Ge(BaseMetadata):
-    """Ge(ge=x) implies that the value must be greater than or equal to x.
-
-    It can be used with any type that supports the ``>=`` operator,
-    including numbers, dates and times, strings, sets, and so on.
-    """
-
-    ge: SupportsGe
-
-
-@dataclass(frozen=True, **SLOTS)
-class Lt(BaseMetadata):
-    """Lt(lt=x) implies that the value must be less than x.
-
-    It can be used with any type that supports the ``<`` operator,
-    including numbers, dates and times, strings, sets, and so on.
-    """
-
-    lt: SupportsLt
-
-
-@dataclass(frozen=True, **SLOTS)
-class Le(BaseMetadata):
-    """Le(le=x) implies that the value must be less than or equal to x.
-
-    It can be used with any type that supports the ``<=`` operator,
-    including numbers, dates and times, strings, sets, and so on.
-    """
-
-    le: SupportsLe
-
-
-@runtime_checkable
-class GroupedMetadata(Protocol):
-    """A grouping of multiple BaseMetadata objects.
-
-    `GroupedMetadata` on its own is not metadata and has no meaning.
-    All it the the constraint and metadata should be fully expressable
-    in terms of the `BaseMetadata`'s returned by `GroupedMetadata.__iter__()`.
-
-    Concrete implementations should override `GroupedMetadata.__iter__()`
-    to add their own metadata.
-    For example:
-
-    >>> @dataclass
-    >>> class Field(GroupedMetadata):
-    >>>     gt: float | None = None
-    >>>     description: str | None = None
-    ...
-    >>>     def __iter__(self) -> Iterable[BaseMetadata]:
-    >>>         if self.gt is not None:
-    >>>             yield Gt(self.gt)
-    >>>         if self.description is not None:
-    >>>             yield Description(self.gt)
-
-    Also see the implementation of `Interval` below for an example.
-
-    Parsers should recognize this and unpack it so that it can be used
-    both with and without unpacking:
-
-    - `Annotated[int, Field(...)]` (parser must unpack Field)
-    - `Annotated[int, *Field(...)]` (PEP-646)
-    """  # noqa: trailing-whitespace
-
-    @property
-    def __is_annotated_types_grouped_metadata__(self) -> Literal[True]:
-        return True
-
-    def __iter__(self) -> Iterator[BaseMetadata]:
-        ...
-
-    if not TYPE_CHECKING:
-        __slots__ = ()  # allow subclasses to use slots
-
-        def __init_subclass__(cls, *args: Any, **kwargs: Any) -> None:
-            # Basic ABC like functionality without the complexity of an ABC
-            super().__init_subclass__(*args, **kwargs)
-            if cls.__iter__ is GroupedMetadata.__iter__:
-                raise TypeError("Can't subclass GroupedMetadata without implementing __iter__")
-
-        def __iter__(self) -> Iterator[BaseMetadata]:  # noqa: F811
-            raise NotImplementedError  # more helpful than "None has no attribute..." type errors
-
-
-@dataclass(frozen=True, **KW_ONLY, **SLOTS)
-class Interval(GroupedMetadata):
-    """Interval can express inclusive or exclusive bounds with a single object.
-
-    It accepts keyword arguments ``gt``, ``ge``, ``lt``, and/or ``le``, which
-    are interpreted the same way as the single-bound constraints.
-    """
-
-    gt: Union[SupportsGt, None] = None
-    ge: Union[SupportsGe, None] = None
-    lt: Union[SupportsLt, None] = None
-    le: Union[SupportsLe, None] = None
-
-    def __iter__(self) -> Iterator[BaseMetadata]:
-        """Unpack an Interval into zero or more single-bounds."""
-        if self.gt is not None:
-            yield Gt(self.gt)
-        if self.ge is not None:
-            yield Ge(self.ge)
-        if self.lt is not None:
-            yield Lt(self.lt)
-        if self.le is not None:
-            yield Le(self.le)
-
-
-@dataclass(frozen=True, **SLOTS)
-class MultipleOf(BaseMetadata):
-    """MultipleOf(multiple_of=x) might be interpreted in two ways:
-
-    1. Python semantics, implying ``value % multiple_of == 0``, or
-    2. JSONschema semantics, where ``int(value / multiple_of) == value / multiple_of``
-
-    We encourage users to be aware of these two common interpretations,
-    and libraries to carefully document which they implement.
-    """
-
-    multiple_of: Union[SupportsDiv, SupportsMod]
-
-
-@dataclass(frozen=True, **SLOTS)
-class MinLen(BaseMetadata):
-    """
-    MinLen() implies minimum inclusive length,
-    e.g. ``len(value) >= min_length``.
-    """
-
-    min_length: Annotated[int, Ge(0)]
-
-
-@dataclass(frozen=True, **SLOTS)
-class MaxLen(BaseMetadata):
-    """
-    MaxLen() implies maximum inclusive length,
-    e.g. ``len(value) <= max_length``.
-    """
-
-    max_length: Annotated[int, Ge(0)]
-
-
-@dataclass(frozen=True, **SLOTS)
-class Len(GroupedMetadata):
-    """
-    Len() implies that ``min_length <= len(value) <= max_length``.
-
-    Upper bound may be omitted or ``None`` to indicate no upper length bound.
-    """
-
-    min_length: Annotated[int, Ge(0)] = 0
-    max_length: Optional[Annotated[int, Ge(0)]] = None
-
-    def __iter__(self) -> Iterator[BaseMetadata]:
-        """Unpack a Len into zone or more single-bounds."""
-        if self.min_length > 0:
-            yield MinLen(self.min_length)
-        if self.max_length is not None:
-            yield MaxLen(self.max_length)
-
-
-@dataclass(frozen=True, **SLOTS)
-class Timezone(BaseMetadata):
-    """Timezone(tz=...) requires a datetime to be aware (or ``tz=None``, naive).
-
-    ``Annotated[datetime, Timezone(None)]`` must be a naive datetime.
-    ``Timezone[...]`` (the ellipsis literal) expresses that the datetime must be
-    tz-aware but any timezone is allowed.
-
-    You may also pass a specific timezone string or timezone object such as
-    ``Timezone(timezone.utc)`` or ``Timezone("Africa/Abidjan")`` to express that
-    you only allow a specific timezone, though we note that this is often
-    a symptom of poor design.
-    """
-
-    tz: Union[str, timezone, EllipsisType, None]
-
-
-@dataclass(frozen=True, **SLOTS)
-class Predicate(BaseMetadata):
-    """``Predicate(func: Callable)`` implies `func(value)` is truthy for valid values.
-
-    Users should prefer statically inspectable metadata, but if you need the full
-    power and flexibility of arbitrary runtime predicates... here it is.
-
-    We provide a few predefined predicates for common string constraints:
-    ``IsLower = Predicate(str.islower)``, ``IsUpper = Predicate(str.isupper)``, and
-    ``IsDigit = Predicate(str.isdigit)``. Users are encouraged to use methods which
-    can be given special handling, and avoid indirection like ``lambda s: s.lower()``.
-
-    Some libraries might have special logic to handle certain predicates, e.g. by
-    checking for `str.isdigit` and using its presence to both call custom logic to
-    enforce digit-only strings, and customise some generated external schema.
-
-    We do not specify what behaviour should be expected for predicates that raise
-    an exception.  For example `Annotated[int, Predicate(str.isdigit)]` might silently
-    skip invalid constraints, or statically raise an error; or it might try calling it
-    and then propogate or discard the resulting exception.
-    """
-
-    func: Callable[[Any], bool]
-
-
-@dataclass
-class Not:
-    func: Callable[[Any], bool]
-
-    def __call__(self, __v: Any) -> bool:
-        return not self.func(__v)
-
-
-_StrType = TypeVar("_StrType", bound=str)
-
-LowerCase = Annotated[_StrType, Predicate(str.islower)]
-"""
-Return True if the string is a lowercase string, False otherwise.
-
-A string is lowercase if all cased characters in the string are lowercase and there is at least one cased character in the string.
-"""  # noqa: E501
-UpperCase = Annotated[_StrType, Predicate(str.isupper)]
-"""
-Return True if the string is an uppercase string, False otherwise.
-
-A string is uppercase if all cased characters in the string are uppercase and there is at least one cased character in the string.
-"""  # noqa: E501
-IsDigits = Annotated[_StrType, Predicate(str.isdigit)]
-"""
-Return True if the string is a digit string, False otherwise.
-
-A string is a digit string if all characters in the string are digits and there is at least one character in the string.
-"""  # noqa: E501
-IsAscii = Annotated[_StrType, Predicate(str.isascii)]
-"""
-Return True if all characters in the string are ASCII, False otherwise.
-
-ASCII characters have code points in the range U+0000-U+007F. Empty string is ASCII too.
-"""
-
-_NumericType = TypeVar('_NumericType', bound=Union[SupportsFloat, SupportsIndex])
-IsFinite = Annotated[_NumericType, Predicate(math.isfinite)]
-"""Return True if x is neither an infinity nor a NaN, and False otherwise."""
-IsNotFinite = Annotated[_NumericType, Predicate(Not(math.isfinite))]
-"""Return True if x is one of infinity or NaN, and False otherwise"""
-IsNan = Annotated[_NumericType, Predicate(math.isnan)]
-"""Return True if x is a NaN (not a number), and False otherwise."""
-IsNotNan = Annotated[_NumericType, Predicate(Not(math.isnan))]
-"""Return True if x is anything but NaN (not a number), and False otherwise."""
-IsInfinite = Annotated[_NumericType, Predicate(math.isinf)]
-"""Return True if x is a positive or negative infinity, and False otherwise."""
-IsNotInfinite = Annotated[_NumericType, Predicate(Not(math.isinf))]
-"""Return True if x is neither a positive or negative infinity, and False otherwise."""
-
-try:
-    from typing_extensions import DocInfo, doc  # type: ignore [attr-defined]
-except ImportError:
-
-    @dataclass(frozen=True, **SLOTS)
-    class DocInfo:  # type: ignore [no-redef]
-        """ "
-        The return value of doc(), mainly to be used by tools that want to extract the
-        Annotated documentation at runtime.
-        """
-
-        documentation: str
-        """The documentation string passed to doc()."""
-
-    def doc(
-        documentation: str,
-    ) -> DocInfo:
-        """
-        Add documentation to a type annotation inside of Annotated.
-
-        For example:
-
-        >>> def hi(name: Annotated[int, doc("The name of the user")]) -> None: ...
-        """
-        return DocInfo(documentation)
diff --git a/lib/annotated_types/py.typed b/lib/annotated_types/py.typed
deleted file mode 100644
index e69de29b..00000000
diff --git a/lib/annotated_types/test_cases.py b/lib/annotated_types/test_cases.py
deleted file mode 100644
index f54df700..00000000
--- a/lib/annotated_types/test_cases.py
+++ /dev/null
@@ -1,147 +0,0 @@
-import math
-import sys
-from datetime import date, datetime, timedelta, timezone
-from decimal import Decimal
-from typing import Any, Dict, Iterable, Iterator, List, NamedTuple, Set, Tuple
-
-if sys.version_info < (3, 9):
-    from typing_extensions import Annotated
-else:
-    from typing import Annotated
-
-import annotated_types as at
-
-
-class Case(NamedTuple):
-    """
-    A test case for `annotated_types`.
-    """
-
-    annotation: Any
-    valid_cases: Iterable[Any]
-    invalid_cases: Iterable[Any]
-
-
-def cases() -> Iterable[Case]:
-    # Gt, Ge, Lt, Le
-    yield Case(Annotated[int, at.Gt(4)], (5, 6, 1000), (4, 0, -1))
-    yield Case(Annotated[float, at.Gt(0.5)], (0.6, 0.7, 0.8, 0.9), (0.5, 0.0, -0.1))
-    yield Case(
-        Annotated[datetime, at.Gt(datetime(2000, 1, 1))],
-        [datetime(2000, 1, 2), datetime(2000, 1, 3)],
-        [datetime(2000, 1, 1), datetime(1999, 12, 31)],
-    )
-    yield Case(
-        Annotated[datetime, at.Gt(date(2000, 1, 1))],
-        [date(2000, 1, 2), date(2000, 1, 3)],
-        [date(2000, 1, 1), date(1999, 12, 31)],
-    )
-    yield Case(
-        Annotated[datetime, at.Gt(Decimal('1.123'))],
-        [Decimal('1.1231'), Decimal('123')],
-        [Decimal('1.123'), Decimal('0')],
-    )
-
-    yield Case(Annotated[int, at.Ge(4)], (4, 5, 6, 1000, 4), (0, -1))
-    yield Case(Annotated[float, at.Ge(0.5)], (0.5, 0.6, 0.7, 0.8, 0.9), (0.4, 0.0, -0.1))
-    yield Case(
-        Annotated[datetime, at.Ge(datetime(2000, 1, 1))],
-        [datetime(2000, 1, 2), datetime(2000, 1, 3)],
-        [datetime(1998, 1, 1), datetime(1999, 12, 31)],
-    )
-
-    yield Case(Annotated[int, at.Lt(4)], (0, -1), (4, 5, 6, 1000, 4))
-    yield Case(Annotated[float, at.Lt(0.5)], (0.4, 0.0, -0.1), (0.5, 0.6, 0.7, 0.8, 0.9))
-    yield Case(
-        Annotated[datetime, at.Lt(datetime(2000, 1, 1))],
-        [datetime(1999, 12, 31), datetime(1999, 12, 31)],
-        [datetime(2000, 1, 2), datetime(2000, 1, 3)],
-    )
-
-    yield Case(Annotated[int, at.Le(4)], (4, 0, -1), (5, 6, 1000))
-    yield Case(Annotated[float, at.Le(0.5)], (0.5, 0.0, -0.1), (0.6, 0.7, 0.8, 0.9))
-    yield Case(
-        Annotated[datetime, at.Le(datetime(2000, 1, 1))],
-        [datetime(2000, 1, 1), datetime(1999, 12, 31)],
-        [datetime(2000, 1, 2), datetime(2000, 1, 3)],
-    )
-
-    # Interval
-    yield Case(Annotated[int, at.Interval(gt=4)], (5, 6, 1000), (4, 0, -1))
-    yield Case(Annotated[int, at.Interval(gt=4, lt=10)], (5, 6), (4, 10, 1000, 0, -1))
-    yield Case(Annotated[float, at.Interval(ge=0.5, le=1)], (0.5, 0.9, 1), (0.49, 1.1))
-    yield Case(
-        Annotated[datetime, at.Interval(gt=datetime(2000, 1, 1), le=datetime(2000, 1, 3))],
-        [datetime(2000, 1, 2), datetime(2000, 1, 3)],
-        [datetime(2000, 1, 1), datetime(2000, 1, 4)],
-    )
-
-    yield Case(Annotated[int, at.MultipleOf(multiple_of=3)], (0, 3, 9), (1, 2, 4))
-    yield Case(Annotated[float, at.MultipleOf(multiple_of=0.5)], (0, 0.5, 1, 1.5), (0.4, 1.1))
-
-    # lengths
-
-    yield Case(Annotated[str, at.MinLen(3)], ('123', '1234', 'x' * 10), ('', '1', '12'))
-    yield Case(Annotated[str, at.Len(3)], ('123', '1234', 'x' * 10), ('', '1', '12'))
-    yield Case(Annotated[List[int], at.MinLen(3)], ([1, 2, 3], [1, 2, 3, 4], [1] * 10), ([], [1], [1, 2]))
-    yield Case(Annotated[List[int], at.Len(3)], ([1, 2, 3], [1, 2, 3, 4], [1] * 10), ([], [1], [1, 2]))
-
-    yield Case(Annotated[str, at.MaxLen(4)], ('', '1234'), ('12345', 'x' * 10))
-    yield Case(Annotated[str, at.Len(0, 4)], ('', '1234'), ('12345', 'x' * 10))
-    yield Case(Annotated[List[str], at.MaxLen(4)], ([], ['a', 'bcdef'], ['a', 'b', 'c']), (['a'] * 5, ['b'] * 10))
-    yield Case(Annotated[List[str], at.Len(0, 4)], ([], ['a', 'bcdef'], ['a', 'b', 'c']), (['a'] * 5, ['b'] * 10))
-
-    yield Case(Annotated[str, at.Len(3, 5)], ('123', '12345'), ('', '1', '12', '123456', 'x' * 10))
-    yield Case(Annotated[str, at.Len(3, 3)], ('123',), ('12', '1234'))
-
-    yield Case(Annotated[Dict[int, int], at.Len(2, 3)], [{1: 1, 2: 2}], [{}, {1: 1}, {1: 1, 2: 2, 3: 3, 4: 4}])
-    yield Case(Annotated[Set[int], at.Len(2, 3)], ({1, 2}, {1, 2, 3}), (set(), {1}, {1, 2, 3, 4}))
-    yield Case(Annotated[Tuple[int, ...], at.Len(2, 3)], ((1, 2), (1, 2, 3)), ((), (1,), (1, 2, 3, 4)))
-
-    # Timezone
-
-    yield Case(
-        Annotated[datetime, at.Timezone(None)], [datetime(2000, 1, 1)], [datetime(2000, 1, 1, tzinfo=timezone.utc)]
-    )
-    yield Case(
-        Annotated[datetime, at.Timezone(...)], [datetime(2000, 1, 1, tzinfo=timezone.utc)], [datetime(2000, 1, 1)]
-    )
-    yield Case(
-        Annotated[datetime, at.Timezone(timezone.utc)],
-        [datetime(2000, 1, 1, tzinfo=timezone.utc)],
-        [datetime(2000, 1, 1), datetime(2000, 1, 1, tzinfo=timezone(timedelta(hours=6)))],
-    )
-    yield Case(
-        Annotated[datetime, at.Timezone('Europe/London')],
-        [datetime(2000, 1, 1, tzinfo=timezone(timedelta(0), name='Europe/London'))],
-        [datetime(2000, 1, 1), datetime(2000, 1, 1, tzinfo=timezone(timedelta(hours=6)))],
-    )
-
-    # predicate types
-
-    yield Case(at.LowerCase[str], ['abc', 'foobar'], ['', 'A', 'Boom'])
-    yield Case(at.UpperCase[str], ['ABC', 'DEFO'], ['', 'a', 'abc', 'AbC'])
-    yield Case(at.IsDigits[str], ['123'], ['', 'ab', 'a1b2'])
-    yield Case(at.IsAscii[str], ['123', 'foo bar'], ['£100', '😊', 'whatever 👀'])
-
-    yield Case(Annotated[int, at.Predicate(lambda x: x % 2 == 0)], [0, 2, 4], [1, 3, 5])
-
-    yield Case(at.IsFinite[float], [1.23], [math.nan, math.inf, -math.inf])
-    yield Case(at.IsNotFinite[float], [math.nan, math.inf], [1.23])
-    yield Case(at.IsNan[float], [math.nan], [1.23, math.inf])
-    yield Case(at.IsNotNan[float], [1.23, math.inf], [math.nan])
-    yield Case(at.IsInfinite[float], [math.inf], [math.nan, 1.23])
-    yield Case(at.IsNotInfinite[float], [math.nan, 1.23], [math.inf])
-
-    # check stacked predicates
-    yield Case(at.IsInfinite[Annotated[float, at.Predicate(lambda x: x > 0)]], [math.inf], [-math.inf, 1.23, math.nan])
-
-    # doc
-    yield Case(Annotated[int, at.doc("A number")], [1, 2], [])
-
-    # custom GroupedMetadata
-    class MyCustomGroupedMetadata(at.GroupedMetadata):
-        def __iter__(self) -> Iterator[at.Predicate]:
-            yield at.Predicate(lambda x: float(x).is_integer())
-
-    yield Case(Annotated[float, MyCustomGroupedMetadata()], [0, 2.0], [0.01, 1.5])
diff --git a/lib/autocommand/autoasync.py b/lib/autocommand/autoasync.py
index 688f7e05..3c8ebdcf 100644
--- a/lib/autocommand/autoasync.py
+++ b/lib/autocommand/autoasync.py
@@ -20,7 +20,7 @@ from functools import wraps
 from inspect import signature
 
 
-async def _run_forever_coro(coro, args, kwargs, loop):
+def _launch_forever_coro(coro, args, kwargs, loop):
     '''
     This helper function launches an async main function that was tagged with
     forever=True. There are two possibilities:
@@ -48,7 +48,7 @@ async def _run_forever_coro(coro, args, kwargs, loop):
     # forever=True feature from autoasync at some point in the future.
     thing = coro(*args, **kwargs)
     if iscoroutine(thing):
-        await thing
+        loop.create_task(thing)
 
 
 def autoasync(coro=None, *, loop=None, forever=False, pass_loop=False):
@@ -127,9 +127,7 @@ def autoasync(coro=None, *, loop=None, forever=False, pass_loop=False):
             args, kwargs = bound_args.args, bound_args.kwargs
 
         if forever:
-            local_loop.create_task(_run_forever_coro(
-                coro, args, kwargs, local_loop
-            ))
+            _launch_forever_coro(coro, args, kwargs, local_loop)
             local_loop.run_forever()
         else:
             return local_loop.run_until_complete(coro(*args, **kwargs))
diff --git a/lib/cherrypy/_cplogging.py b/lib/cherrypy/_cplogging.py
index bce1c87b..151d3b40 100644
--- a/lib/cherrypy/_cplogging.py
+++ b/lib/cherrypy/_cplogging.py
@@ -452,6 +452,6 @@ class WSGIErrorHandler(logging.Handler):
 
 class LazyRfc3339UtcTime(object):
     def __str__(self):
-        """Return utcnow() in RFC3339 UTC Format."""
-        iso_formatted_now = datetime.datetime.utcnow().isoformat('T')
-        return f'{iso_formatted_now!s}Z'
+        """Return now() in RFC3339 UTC Format."""
+        now = datetime.datetime.now()
+        return now.isoformat('T') + 'Z'
diff --git a/lib/cherrypy/lib/cptools.py b/lib/cherrypy/lib/cptools.py
index 13b4c567..613a8995 100644
--- a/lib/cherrypy/lib/cptools.py
+++ b/lib/cherrypy/lib/cptools.py
@@ -622,15 +622,13 @@ def autovary(ignore=None, debug=False):
 
 
 def convert_params(exception=ValueError, error=400):
-    """Convert request params based on function annotations.
+    """Convert request params based on function annotations, with error handling.
 
-    This function also processes errors that are subclasses of ``exception``.
+    exception
+        Exception class to catch.
 
-    :param BaseException exception: Exception class to catch.
-    :type exception: BaseException
-
-    :param error: The HTTP status code to return to the client on failure.
-    :type error: int
+    status
+        The HTTP error code to return to the client on failure.
     """
     request = cherrypy.serving.request
     types = request.handler.callable.__annotations__
diff --git a/lib/cherrypy/lib/profiler.py b/lib/cherrypy/lib/profiler.py
index 7182278a..fccf2eb8 100644
--- a/lib/cherrypy/lib/profiler.py
+++ b/lib/cherrypy/lib/profiler.py
@@ -47,9 +47,7 @@ try:
     import pstats
 
     def new_func_strip_path(func_name):
-        """Add ``__init__`` modules' parents.
-
-        This makes the profiler output more readable.
+        """Make profiler output more readable by adding `__init__` modules' parents
         """
         filename, line, name = func_name
         if filename.endswith('__init__.py'):
diff --git a/lib/cherrypy/lib/reprconf.py b/lib/cherrypy/lib/reprconf.py
index 536b9417..76381d7b 100644
--- a/lib/cherrypy/lib/reprconf.py
+++ b/lib/cherrypy/lib/reprconf.py
@@ -188,7 +188,7 @@ class Parser(configparser.ConfigParser):
 
     def dict_from_file(self, file):
         if hasattr(file, 'read'):
-            self.read_file(file)
+            self.readfp(file)
         else:
             self.read(file)
         return self.as_dict()
diff --git a/lib/cherrypy/lib/static.py b/lib/cherrypy/lib/static.py
index c1ad95f3..66a5a947 100644
--- a/lib/cherrypy/lib/static.py
+++ b/lib/cherrypy/lib/static.py
@@ -1,18 +1,19 @@
 """Module with helpers for serving static files."""
 
-import mimetypes
 import os
 import platform
 import re
 import stat
-import unicodedata
+import mimetypes
 import urllib.parse
+import unicodedata
+
 from email.generator import _make_boundary as make_boundary
 from io import UnsupportedOperation
 
 import cherrypy
 from cherrypy._cpcompat import ntob
-from cherrypy.lib import cptools, file_generator_limited, httputil
+from cherrypy.lib import cptools, httputil, file_generator_limited
 
 
 def _setup_mimetypes():
@@ -184,10 +185,7 @@ def serve_fileobj(fileobj, content_type=None, disposition=None, name=None,
 
 
 def _serve_fileobj(fileobj, content_type, content_length, debug=False):
-    """Set ``response.body`` to the given file object, perhaps ranged.
-
-    Internal helper.
-    """
+    """Internal. Set response.body to the given file object, perhaps ranged."""
     response = cherrypy.serving.response
 
     # HTTP/1.0 didn't have Range/Accept-Ranges headers, or the 206 code
diff --git a/lib/cherrypy/process/wspbus.py b/lib/cherrypy/process/wspbus.py
index a60cd51e..1d2789b1 100644
--- a/lib/cherrypy/process/wspbus.py
+++ b/lib/cherrypy/process/wspbus.py
@@ -494,7 +494,7 @@ class Bus(object):
                     "Cannot reconstruct command from '-c'. "
                     'Ref: https://github.com/cherrypy/cherrypy/issues/1545')
         except AttributeError:
-            """It looks Py_GetArgcArgv's completely absent in some environments
+            """It looks Py_GetArgcArgv is completely absent in some environments
 
             It is known, that there's no Py_GetArgcArgv in MS Windows and
             ``ctypes`` module is completely absent in Google AppEngine
diff --git a/lib/cherrypy/test/test_http.py b/lib/cherrypy/test/test_http.py
index 9a7e9331..a955be43 100644
--- a/lib/cherrypy/test/test_http.py
+++ b/lib/cherrypy/test/test_http.py
@@ -136,9 +136,6 @@ class HTTPTests(helper.CPWebCase):
         self.assertStatus(200)
         self.assertBody(b'Hello world!')
 
-        response.close()
-        c.close()
-
         # Now send a message that has no Content-Length, but does send a body.
         # Verify that CP times out the socket and responds
         # with 411 Length Required.
@@ -162,9 +159,6 @@ class HTTPTests(helper.CPWebCase):
         self.status = str(response.status)
         self.assertStatus(411)
 
-        response.close()
-        c.close()
-
     def test_post_multipart(self):
         alphabet = 'abcdefghijklmnopqrstuvwxyz'
         # generate file contents for a large post
@@ -190,9 +184,6 @@ class HTTPTests(helper.CPWebCase):
         parts = ['%s * 65536' % ch for ch in alphabet]
         self.assertBody(', '.join(parts))
 
-        response.close()
-        c.close()
-
     def test_post_filename_with_special_characters(self):
         """Testing that we can handle filenames with special characters.
 
@@ -226,9 +217,6 @@ class HTTPTests(helper.CPWebCase):
             self.assertStatus(200)
             self.assertBody(fname)
 
-            response.close()
-            c.close()
-
     def test_malformed_request_line(self):
         if getattr(cherrypy.server, 'using_apache', False):
             return self.skip('skipped due to known Apache differences...')
@@ -276,9 +264,6 @@ class HTTPTests(helper.CPWebCase):
         self.body = response.fp.read(20)
         self.assertBody('Illegal header line.')
 
-        response.close()
-        c.close()
-
     def test_http_over_https(self):
         if self.scheme != 'https':
             return self.skip('skipped (not running HTTPS)... ')
diff --git a/lib/cherrypy/test/test_iterator.py b/lib/cherrypy/test/test_iterator.py
index 5bad59be..6600a78d 100644
--- a/lib/cherrypy/test/test_iterator.py
+++ b/lib/cherrypy/test/test_iterator.py
@@ -150,8 +150,6 @@ class IteratorTest(helper.CPWebCase):
             self.assertStatus(200)
             self.assertBody('0')
 
-            itr_conn.close()
-
         # Now we do the same check with streaming - some classes will
         # be automatically closed, while others cannot.
         stream_counts = {}
diff --git a/lib/cherrypy/test/test_logging.py b/lib/cherrypy/test/test_logging.py
index 49d41d0a..2d4aa56f 100644
--- a/lib/cherrypy/test/test_logging.py
+++ b/lib/cherrypy/test/test_logging.py
@@ -1,6 +1,5 @@
 """Basic tests for the CherryPy core: request handling."""
 
-import datetime
 import logging
 
 from cheroot.test import webtest
@@ -198,33 +197,6 @@ def test_custom_log_format(log_tracker, monkeypatch, server):
     )
 
 
-def test_utc_in_timez(monkeypatch):
-    """Test that ``LazyRfc3339UtcTime`` is rendered as ``str`` using UTC timestamp."""
-    utcoffset8_local_time_in_naive_utc = (
-        datetime.datetime(
-            year=2020,
-            month=1,
-            day=1,
-            hour=1,
-            minute=23,
-            second=45,
-            tzinfo=datetime.timezone(datetime.timedelta(hours=8)),
-        )
-        .astimezone(datetime.timezone.utc)
-        .replace(tzinfo=None)
-    )
-
-    class mock_datetime:
-        @classmethod
-        def utcnow(cls):
-            return utcoffset8_local_time_in_naive_utc
-
-    monkeypatch.setattr('datetime.datetime', mock_datetime)
-    rfc3339_utc_time = str(cherrypy._cplogging.LazyRfc3339UtcTime())
-    expected_time = '2019-12-31T17:23:45Z'
-    assert rfc3339_utc_time == expected_time
-
-
 def test_timez_log_format(log_tracker, monkeypatch, server):
     """Test a customized access_log_format string, which is a
     feature of _cplogging.LogManager.access()."""
diff --git a/lib/inflect/__init__.py b/lib/inflect/__init__.py
index b638c6b8..78d2e33c 100644
--- a/lib/inflect/__init__.py
+++ b/lib/inflect/__init__.py
@@ -3,6 +3,8 @@ inflect: english language inflection
  - correctly generate plurals, ordinals, indefinite articles
  - convert numbers to words
 
+Copyright (C) 2010 Paul Dyson
+
 Based upon the Perl module
 `Lingua::EN::Inflect <https://metacpan.org/pod/Lingua::EN::Inflect>`_.
 
@@ -68,16 +70,11 @@ from typing import (
     cast,
     Any,
 )
-from typing_extensions import Literal
 from numbers import Number
 
 
-from pydantic import Field
-from typing_extensions import Annotated
-
-
-from .compat.pydantic1 import validate_call
-from .compat.pydantic import same_method
+from pydantic import Field, validate_arguments
+from pydantic.typing import Annotated
 
 
 class UnknownClassicalModeError(Exception):
@@ -108,6 +105,14 @@ class BadGenderError(Exception):
     pass
 
 
+STDOUT_ON = False
+
+
+def print3(txt: str) -> None:
+    if STDOUT_ON:
+        print(txt)
+
+
 def enclose(s: str) -> str:
     return f"(?:{s})"
 
@@ -1722,44 +1727,66 @@ plverb_irregular_pres = {
     "is": "are",
     "was": "were",
     "were": "were",
+    "was": "were",
+    "have": "have",
     "have": "have",
     "has": "have",
     "do": "do",
+    "do": "do",
     "does": "do",
 }
 
 plverb_ambiguous_pres = {
+    "act": "act",
     "act": "act",
     "acts": "act",
     "blame": "blame",
+    "blame": "blame",
     "blames": "blame",
     "can": "can",
+    "can": "can",
+    "can": "can",
     "must": "must",
+    "must": "must",
+    "must": "must",
+    "fly": "fly",
     "fly": "fly",
     "flies": "fly",
     "copy": "copy",
+    "copy": "copy",
     "copies": "copy",
     "drink": "drink",
+    "drink": "drink",
     "drinks": "drink",
     "fight": "fight",
+    "fight": "fight",
     "fights": "fight",
     "fire": "fire",
+    "fire": "fire",
     "fires": "fire",
     "like": "like",
+    "like": "like",
     "likes": "like",
     "look": "look",
+    "look": "look",
     "looks": "look",
     "make": "make",
+    "make": "make",
     "makes": "make",
     "reach": "reach",
+    "reach": "reach",
     "reaches": "reach",
     "run": "run",
+    "run": "run",
     "runs": "run",
     "sink": "sink",
+    "sink": "sink",
     "sinks": "sink",
     "sleep": "sleep",
+    "sleep": "sleep",
     "sleeps": "sleep",
     "view": "view",
+    "view": "view",
     "views": "view",
 }
 
@@ -1827,7 +1854,7 @@ pl_adj_poss_keys = re.compile(fr"^({enclose('|'.join(pl_adj_poss))})$", re.IGNOR
 
 A_abbrev = re.compile(
     r"""
-^(?! FJO | [HLMNS]Y.  | RY[EO] | SQU
+(?! FJO | [HLMNS]Y.  | RY[EO] | SQU
   | ( F[LR]? | [HL] | MN? | N | RH? | S[CHKLMNPTVW]? | X(YL)?) [AEIOU])
 [FHLMNRSX][A-Z]
 """,
@@ -2026,14 +2053,15 @@ Falsish = Any  # ideally, falsish would only validate on bool(value) is False
 
 class engine:
     def __init__(self) -> None:
+
         self.classical_dict = def_classical.copy()
         self.persistent_count: Optional[int] = None
         self.mill_count = 0
-        self.pl_sb_user_defined: List[Optional[Word]] = []
-        self.pl_v_user_defined: List[Optional[Word]] = []
-        self.pl_adj_user_defined: List[Optional[Word]] = []
-        self.si_sb_user_defined: List[Optional[Word]] = []
-        self.A_a_user_defined: List[Optional[Word]] = []
+        self.pl_sb_user_defined: List[str] = []
+        self.pl_v_user_defined: List[str] = []
+        self.pl_adj_user_defined: List[str] = []
+        self.si_sb_user_defined: List[str] = []
+        self.A_a_user_defined: List[str] = []
         self.thegender = "neuter"
         self.__number_args: Optional[Dict[str, str]] = None
 
@@ -2045,8 +2073,28 @@ class engine:
     def _number_args(self, val):
         self.__number_args = val
 
-    @validate_call
-    def defnoun(self, singular: Optional[Word], plural: Optional[Word]) -> int:
+    deprecated_methods = dict(
+        pl="plural",
+        plnoun="plural_noun",
+        plverb="plural_verb",
+        pladj="plural_adj",
+        sinoun="single_noun",
+        prespart="present_participle",
+        numwords="number_to_words",
+        plequal="compare",
+        plnounequal="compare_nouns",
+        plverbequal="compare_verbs",
+        pladjequal="compare_adjs",
+        wordlist="join",
+    )
+
+    def __getattr__(self, meth):
+        if meth in self.deprecated_methods:
+            print3(f"{meth}() deprecated, use {self.deprecated_methods[meth]}()")
+            raise DeprecationWarning
+        raise AttributeError
+
+    def defnoun(self, singular: str, plural: str) -> int:
         """
         Set the noun plural of singular to plural.
 
@@ -2057,16 +2105,7 @@ class engine:
         self.si_sb_user_defined.extend((plural, singular))
         return 1
 
-    @validate_call
-    def defverb(
-        self,
-        s1: Optional[Word],
-        p1: Optional[Word],
-        s2: Optional[Word],
-        p2: Optional[Word],
-        s3: Optional[Word],
-        p3: Optional[Word],
-    ) -> int:
+    def defverb(self, s1: str, p1: str, s2: str, p2: str, s3: str, p3: str) -> int:
         """
         Set the verb plurals for s1, s2 and s3 to p1, p2 and p3 respectively.
 
@@ -2082,8 +2121,7 @@ class engine:
         self.pl_v_user_defined.extend((s1, p1, s2, p2, s3, p3))
         return 1
 
-    @validate_call
-    def defadj(self, singular: Optional[Word], plural: Optional[Word]) -> int:
+    def defadj(self, singular: str, plural: str) -> int:
         """
         Set the adjective plural of singular to plural.
 
@@ -2093,8 +2131,7 @@ class engine:
         self.pl_adj_user_defined.extend((singular, plural))
         return 1
 
-    @validate_call
-    def defa(self, pattern: Optional[Word]) -> int:
+    def defa(self, pattern: str) -> int:
         """
         Define the indefinite article as 'a' for words matching pattern.
 
@@ -2103,8 +2140,7 @@ class engine:
         self.A_a_user_defined.extend((pattern, "a"))
         return 1
 
-    @validate_call
-    def defan(self, pattern: Optional[Word]) -> int:
+    def defan(self, pattern: str) -> int:
         """
         Define the indefinite article as 'an' for words matching pattern.
 
@@ -2113,7 +2149,7 @@ class engine:
         self.A_a_user_defined.extend((pattern, "an"))
         return 1
 
-    def checkpat(self, pattern: Optional[Word]) -> None:
+    def checkpat(self, pattern: Optional[str]) -> None:
         """
         check for errors in a regex pattern
         """
@@ -2122,15 +2158,16 @@ class engine:
         try:
             re.match(pattern, "")
         except re.error:
-            raise BadUserDefinedPatternError(pattern)
+            print3(f"\nBad user-defined singular pattern:\n\t{pattern}\n")
+            raise BadUserDefinedPatternError
 
-    def checkpatplural(self, pattern: Optional[Word]) -> None:
+    def checkpatplural(self, pattern: str) -> None:
         """
         check for errors in a regex replace pattern
         """
         return
 
-    @validate_call
+    @validate_arguments
     def ud_match(self, word: Word, wordlist: Sequence[Optional[Word]]) -> Optional[str]:
         for i in range(len(wordlist) - 2, -2, -2):  # backwards through even elements
             mo = re.search(fr"^{wordlist[i]}$", word, re.IGNORECASE)
@@ -2270,7 +2307,7 @@ class engine:
 
     # 0. PERFORM GENERAL INFLECTIONS IN A STRING
 
-    @validate_call
+    @validate_arguments
     def inflect(self, text: Word) -> str:
         """
         Perform inflections in a string.
@@ -2347,7 +2384,7 @@ class engine:
         else:
             return "", "", ""
 
-    @validate_call
+    @validate_arguments
     def plural(self, text: Word, count: Optional[Union[str, int, Any]] = None) -> str:
         """
         Return the plural of text.
@@ -2371,7 +2408,7 @@ class engine:
         )
         return f"{pre}{plural}{post}"
 
-    @validate_call
+    @validate_arguments
     def plural_noun(
         self, text: Word, count: Optional[Union[str, int, Any]] = None
     ) -> str:
@@ -2392,7 +2429,7 @@ class engine:
         plural = self.postprocess(word, self._plnoun(word, count))
         return f"{pre}{plural}{post}"
 
-    @validate_call
+    @validate_arguments
     def plural_verb(
         self, text: Word, count: Optional[Union[str, int, Any]] = None
     ) -> str:
@@ -2416,7 +2453,7 @@ class engine:
         )
         return f"{pre}{plural}{post}"
 
-    @validate_call
+    @validate_arguments
     def plural_adj(
         self, text: Word, count: Optional[Union[str, int, Any]] = None
     ) -> str:
@@ -2437,7 +2474,7 @@ class engine:
         plural = self.postprocess(word, self._pl_special_adjective(word, count) or word)
         return f"{pre}{plural}{post}"
 
-    @validate_call
+    @validate_arguments
     def compare(self, word1: Word, word2: Word) -> Union[str, bool]:
         """
         compare word1 and word2 for equality regardless of plurality
@@ -2460,15 +2497,15 @@ class engine:
         >>> compare('egg', '')
         Traceback (most recent call last):
         ...
-        pydantic...ValidationError: ...
-        ...
-          ...at least 1 characters...
+        pydantic.error_wrappers.ValidationError: 1 validation error for Compare
+        word2
+          ensure this value has at least 1 characters...
         """
         norms = self.plural_noun, self.plural_verb, self.plural_adj
         results = (self._plequal(word1, word2, norm) for norm in norms)
         return next(filter(None, results), False)
 
-    @validate_call
+    @validate_arguments
     def compare_nouns(self, word1: Word, word2: Word) -> Union[str, bool]:
         """
         compare word1 and word2 for equality regardless of plurality
@@ -2484,7 +2521,7 @@ class engine:
         """
         return self._plequal(word1, word2, self.plural_noun)
 
-    @validate_call
+    @validate_arguments
     def compare_verbs(self, word1: Word, word2: Word) -> Union[str, bool]:
         """
         compare word1 and word2 for equality regardless of plurality
@@ -2500,7 +2537,7 @@ class engine:
         """
         return self._plequal(word1, word2, self.plural_verb)
 
-    @validate_call
+    @validate_arguments
     def compare_adjs(self, word1: Word, word2: Word) -> Union[str, bool]:
         """
         compare word1 and word2 for equality regardless of plurality
@@ -2516,13 +2553,13 @@ class engine:
         """
         return self._plequal(word1, word2, self.plural_adj)
 
-    @validate_call
+    @validate_arguments
     def singular_noun(
         self,
         text: Word,
         count: Optional[Union[int, str, Any]] = None,
         gender: Optional[str] = None,
-    ) -> Union[str, Literal[False]]:
+    ) -> Union[str, bool]:
         """
         Return the singular of text, where text is a plural noun.
 
@@ -2574,12 +2611,12 @@ class engine:
             return "s:p"
         self.classical_dict = classval.copy()
 
-        if same_method(pl, self.plural) or same_method(pl, self.plural_noun):
+        if pl == self.plural or pl == self.plural_noun:
             if self._pl_check_plurals_N(word1, word2):
                 return "p:p"
             if self._pl_check_plurals_N(word2, word1):
                 return "p:p"
-        if same_method(pl, self.plural) or same_method(pl, self.plural_adj):
+        if pl == self.plural or pl == self.plural_adj:
             if self._pl_check_plurals_adj(word1, word2):
                 return "p:p"
         return False
@@ -3229,11 +3266,11 @@ class engine:
 
         if words.last in si_sb_irregular_caps:
             llen = len(words.last)
-            return f"{word[:-llen]}{si_sb_irregular_caps[words.last]}"
+            return "{}{}".format(word[:-llen], si_sb_irregular_caps[words.last])
 
         if words.last.lower() in si_sb_irregular:
             llen = len(words.last.lower())
-            return f"{word[:-llen]}{si_sb_irregular[words.last.lower()]}"
+            return "{}{}".format(word[:-llen], si_sb_irregular[words.last.lower()])
 
         dash_split = words.lowered.split("-")
         if (" ".join(dash_split[-2:])).lower() in si_sb_irregular_compound:
@@ -3304,6 +3341,7 @@ class engine:
         # HANDLE INCOMPLETELY ASSIMILATED IMPORTS
 
         if self.classical_dict["ancient"]:
+
             if words.lowered[-6:] == "trices":
                 return word[:-3] + "x"
             if words.lowered[-4:] in ("eaux", "ieux"):
@@ -3421,6 +3459,7 @@ class engine:
         # HANDLE ...o
 
         if words.lowered[-2:] == "os":
+
             if words.last.lower() in si_sb_U_o_os_complete:
                 return word[:-1]
 
@@ -3450,7 +3489,7 @@ class engine:
 
     # ADJECTIVES
 
-    @validate_call
+    @validate_arguments
     def a(self, text: Word, count: Optional[Union[int, str, Any]] = 1) -> str:
         """
         Return the appropriate indefinite article followed by text.
@@ -3531,7 +3570,7 @@ class engine:
 
     # 2. TRANSLATE ZERO-QUANTIFIED $word TO "no plural($word)"
 
-    @validate_call
+    @validate_arguments
     def no(self, text: Word, count: Optional[Union[int, str]] = None) -> str:
         """
         If count is 0, no, zero or nil, return 'no' followed by the plural
@@ -3569,7 +3608,7 @@ class engine:
 
     # PARTICIPLES
 
-    @validate_call
+    @validate_arguments
     def present_participle(self, word: Word) -> str:
         """
         Return the present participle for word.
@@ -3588,31 +3627,31 @@ class engine:
 
     # NUMERICAL INFLECTIONS
 
-    @validate_call(config=dict(arbitrary_types_allowed=True))
-    def ordinal(self, num: Union[Number, Word]) -> str:
+    @validate_arguments
+    def ordinal(self, num: Union[int, Word]) -> str:  # noqa: C901
         """
         Return the ordinal of num.
 
-        >>> ordinal = engine().ordinal
-        >>> ordinal(1)
-        '1st'
-        >>> ordinal('one')
-        'first'
+        num can be an integer or text
+
+        e.g. ordinal(1) returns '1st'
+        ordinal('one') returns 'first'
+
         """
         if DIGIT.match(str(num)):
-            if isinstance(num, (float, int)) and int(num) == num:
+            if isinstance(num, (int, float)):
                 n = int(num)
             else:
                 if "." in str(num):
                     try:
                         # numbers after decimal,
                         # so only need last one for ordinal
-                        n = int(str(num)[-1])
+                        n = int(num[-1])
 
                     except ValueError:  # ends with '.', so need to use whole string
-                        n = int(str(num)[:-1])
+                        n = int(num[:-1])
                 else:
-                    n = int(num)  # type: ignore
+                    n = int(num)
             try:
                 post = nth[n % 100]
             except KeyError:
@@ -3621,7 +3660,7 @@ class engine:
         else:
             # Mad props to Damian Conway (?) whose ordinal()
             # algorithm is type-bendy enough to foil MyPy
-            str_num: str = num  # type: ignore[assignment]
+            str_num: str = num  # type:	ignore[assignment]
             mo = ordinal_suff.search(str_num)
             if mo:
                 post = ordinal[mo.group(1)]
@@ -3632,6 +3671,7 @@ class engine:
 
     def millfn(self, ind: int = 0) -> str:
         if ind > len(mill) - 1:
+            print3("number out of range")
             raise NumOutOfRangeError
         return mill[ind]
 
@@ -3747,7 +3787,7 @@ class engine:
             num = ONE_DIGIT_WORD.sub(self.unitsub, num, 1)
         return num
 
-    @validate_call(config=dict(arbitrary_types_allowed=True))  # noqa: C901
+    @validate_arguments(config=dict(arbitrary_types_allowed=True))  # noqa: C901
     def number_to_words(  # noqa: C901
         self,
         num: Union[Number, Word],
@@ -3899,7 +3939,7 @@ class engine:
 
     # Join words with commas and a trailing 'and' (when appropriate)...
 
-    @validate_call
+    @validate_arguments
     def join(
         self,
         words: Optional[Sequence[Word]],
diff --git a/lib/inflect/compat/pydantic.py b/lib/inflect/compat/pydantic.py
deleted file mode 100644
index d777564a..00000000
--- a/lib/inflect/compat/pydantic.py
+++ /dev/null
@@ -1,19 +0,0 @@
-class ValidateCallWrapperWrapper:
-    def __init__(self, wrapped):
-        self.orig = wrapped
-
-    def __eq__(self, other):
-        return self.raw_function == other.raw_function
-
-    @property
-    def raw_function(self):
-        return getattr(self.orig, 'raw_function') or self.orig
-
-
-def same_method(m1, m2) -> bool:
-    """
-    Return whether m1 and m2 are the same method.
-
-    Workaround for pydantic/pydantic#6390.
-    """
-    return ValidateCallWrapperWrapper(m1) == ValidateCallWrapperWrapper(m2)
diff --git a/lib/inflect/compat/pydantic1.py b/lib/inflect/compat/pydantic1.py
deleted file mode 100644
index 8262fdcf..00000000
--- a/lib/inflect/compat/pydantic1.py
+++ /dev/null
@@ -1,8 +0,0 @@
-try:
-    from pydantic import validate_call  # type: ignore
-except ImportError:
-    # Pydantic 1
-    from pydantic import validate_arguments as validate_call  # type: ignore
-
-
-__all__ = ['validate_call']
diff --git a/lib/isapi/README.txt b/lib/isapi/README.txt
deleted file mode 100644
index dc528624..00000000
--- a/lib/isapi/README.txt
+++ /dev/null
@@ -1,7 +0,0 @@
-A Python ISAPI extension.  Contributed by Phillip Frantz, and is
-Copyright 2002-2003 by Blackdog Software Pty Ltd.
-
-See the 'samples' directory, and particularly samples\README.txt
-
-You can find documentation in the PyWin32.chm file that comes with pywin32 - 
-you can open this from Pythonwin->Help, or from the start menu.
\ No newline at end of file
diff --git a/lib/isapi/__init__.py b/lib/isapi/__init__.py
deleted file mode 100644
index 71823616..00000000
--- a/lib/isapi/__init__.py
+++ /dev/null
@@ -1,39 +0,0 @@
-# The Python ISAPI package.
-
-
-# Exceptions thrown by the DLL framework.
-class ISAPIError(Exception):
-    def __init__(self, errno, strerror=None, funcname=None):
-        # named attributes match IOError etc.
-        self.errno = errno
-        self.strerror = strerror
-        self.funcname = funcname
-        Exception.__init__(self, errno, strerror, funcname)
-
-    def __str__(self):
-        if self.strerror is None:
-            try:
-                import win32api
-
-                self.strerror = win32api.FormatMessage(self.errno).strip()
-            except:
-                self.strerror = "no error message is available"
-        # str() looks like a win32api error.
-        return str((self.errno, self.strerror, self.funcname))
-
-
-class FilterError(ISAPIError):
-    pass
-
-
-class ExtensionError(ISAPIError):
-    pass
-
-
-# A little development aid - a filter or extension callback function can
-# raise one of these exceptions, and the handler module will be reloaded.
-# This means you can change your code without restarting IIS.
-# After a reload, your filter/extension will have the GetFilterVersion/
-# GetExtensionVersion function called, but with None as the first arg.
-class InternalReloadException(Exception):
-    pass
diff --git a/lib/isapi/doc/isapi.html b/lib/isapi/doc/isapi.html
deleted file mode 100644
index 03001a1b..00000000
--- a/lib/isapi/doc/isapi.html
+++ /dev/null
@@ -1,92 +0,0 @@
-<!-- NOTE: This HTML is displayed inside the CHM file - hence some hrefs
-     will only work in that environment
--->
-<HTML>
-<BODY>
-<TITLE>Introduction to Python ISAPI support</TITLE>
-
-<h2>Introduction to Python ISAPI support</h2>
-
-<h3>See also</h3>
-<ul>
-    <li><a href="/isapi_modules.html">The isapi related modules</a>
-    </li>
-    <li><a href="/isapi_objects.html">The isapi related objects</a>
-    </li>
-</ul>
-<p><i>Note: if you are viewing this documentation directly from disk, 
-most links in this document will fail - you can also find this document in the
-CHM file that comes with pywin32, where the links will work</i>
-
-<h3>Introduction</h3>
-This documents Python support for hosting ISAPI exensions and filters inside
-Microsoft Internet Information Server (IIS). It assumes a basic understanding 
-of the ISAPI filter and extension mechanism.
-<p>
-In summary, to implement a filter or extension, you provide a Python module
-which defines a Filter and/or Extension class.  Once your class has been
-loaded, IIS/ISAPI will, via an extension DLL, call methods on your class.
-<p>
-A filter and a class instance need only provide 3 methods - for filters they
-are called <code>GetFilterVersion</code>, <code>HttpFilterProc</code> and
-<code>TerminateFilter</code>.  For extensions they
-are named <code>GetExtensionVersion</code>, <code>HttpExtensionProc</code> and
-<code>TerminateExtension</code>.  If you are familiar with writing ISAPI 
-extensions in C/C++, these names and their purpose will be familiar.
-<p>
-Most of the work is done in the <code>HttpFilterProc</code> and 
-<code>HttpExtensionProc</code> methods.  These both take a single
-parameter - an <a href="/HTTP_FILTER_CONTEXT.html">HTTP_FILTER_CONTEXT</a> and 
-<a href="/EXTENSION_CONTROL_BLOCK.html">EXTENSION_CONTROL_BLOCK</a>
-object respectively.
-<p>
-In addition to these components, there is an 'isapi' package, containing
-support facilities (base-classes, exceptions, etc) which can be leveraged
-by the extension.
-
-<h4>Base classes</h4>
-There are a number of base classes provided to make writing extensions a little
-simpler.  Of particular note is <code>isapi.threaded_extension.ThreadPoolExtension</code>.
-This implements a thread-pool and informs IIS that the request is progressing 
-in the background.  Your sub-class need only provide a <code>Dispatch</code> 
-method, which is called on one of the worker threads rather than the thread
-that the request came in on.
-<p>
-There is base-class for a filter in <code>isapi.simple</code>, but there is no
-equivilent threaded filter - filters work under a different model, where
-background processing is not possible.
-<h4>Samples</h4>
-Please see the <code>isapi/samples</code> directory for some sample filters 
-and extensions.
-
-<H3>Implementation</H3>
-A Python ISAPI filter extension consists of 2 main components:
-<UL>
-<LI>A DLL used by ISAPI to interface with Python.</LI>
-<LI>A Python script used by that DLL to implement the filter or extension 
-functionality</LI>
-</UL>
-
-<h4>Extension DLL</h4>
-The DLL is usually managed automatically by the isapi.install module.  As the
-Python script for the extension is installed, a generic DLL provided with 
-the isapi package is installed next to the script, and IIS configured to
-use this DLL.
-<p>
-The name of the DLL always has the same base name as the Python script, but
-with a leading underscore (_), and an extension of .dll.  For example, the 
-sample "redirector.py" will, when installed, have "_redirector.dll" created
-in the same directory.
-<p/>
-The Python script may provide 2 entry points - methods named __FilterFactory__ 
-and __ExtensionFactory__, both taking no arguments and returning a filter or
-extension object.
-
-<h3>Using py2exe and the isapi package</h3>
-You can instruct py2exe to create a 'frozen' Python ISAPI filter/extension.
-In this case, py2exe will create a package with everything you need in one
-directory, and the Python source file embedded in the .zip file.
-<p>
-In general, you will want to build a seperate installation executable along 
-with the ISAPI extension.  This executable will be built from the same script.
-See the ISAPI sample in the py2exe distribution.
diff --git a/lib/isapi/install.py b/lib/isapi/install.py
deleted file mode 100644
index 154f82af..00000000
--- a/lib/isapi/install.py
+++ /dev/null
@@ -1,815 +0,0 @@
-"""Installation utilities for Python ISAPI filters and extensions."""
-
-# this code adapted from "Tomcat JK2 ISAPI redirector", part of Apache
-# Created July 2004, Mark Hammond.
-import imp
-import os
-import shutil
-import stat
-import sys
-import traceback
-
-import pythoncom
-import win32api
-import winerror
-from win32com.client import Dispatch, GetObject
-from win32com.client.gencache import EnsureDispatch, EnsureModule
-
-_APP_INPROC = 0
-_APP_OUTPROC = 1
-_APP_POOLED = 2
-_IIS_OBJECT = "IIS://LocalHost/W3SVC"
-_IIS_SERVER = "IIsWebServer"
-_IIS_WEBDIR = "IIsWebDirectory"
-_IIS_WEBVIRTUALDIR = "IIsWebVirtualDir"
-_IIS_FILTERS = "IIsFilters"
-_IIS_FILTER = "IIsFilter"
-
-_DEFAULT_SERVER_NAME = "Default Web Site"
-_DEFAULT_HEADERS = "X-Powered-By: Python"
-_DEFAULT_PROTECTION = _APP_POOLED
-
-# Default is for 'execute' only access - ie, only the extension
-# can be used.  This can be overridden via your install script.
-_DEFAULT_ACCESS_EXECUTE = True
-_DEFAULT_ACCESS_READ = False
-_DEFAULT_ACCESS_WRITE = False
-_DEFAULT_ACCESS_SCRIPT = False
-_DEFAULT_CONTENT_INDEXED = False
-_DEFAULT_ENABLE_DIR_BROWSING = False
-_DEFAULT_ENABLE_DEFAULT_DOC = False
-
-_extensions = [ext for ext, _, _ in imp.get_suffixes()]
-is_debug_build = "_d.pyd" in _extensions
-
-this_dir = os.path.abspath(os.path.dirname(__file__))
-
-
-class FilterParameters:
-    Name = None
-    Description = None
-    Path = None
-    Server = None
-    # Params that control if/how AddExtensionFile is called.
-    AddExtensionFile = True
-    AddExtensionFile_Enabled = True
-    AddExtensionFile_GroupID = None  # defaults to Name
-    AddExtensionFile_CanDelete = True
-    AddExtensionFile_Description = None  # defaults to Description.
-
-    def __init__(self, **kw):
-        self.__dict__.update(kw)
-
-
-class VirtualDirParameters:
-    Name = None  # Must be provided.
-    Description = None  # defaults to Name
-    AppProtection = _DEFAULT_PROTECTION
-    Headers = _DEFAULT_HEADERS
-    Path = None  # defaults to WWW root.
-    Type = _IIS_WEBVIRTUALDIR
-    AccessExecute = _DEFAULT_ACCESS_EXECUTE
-    AccessRead = _DEFAULT_ACCESS_READ
-    AccessWrite = _DEFAULT_ACCESS_WRITE
-    AccessScript = _DEFAULT_ACCESS_SCRIPT
-    ContentIndexed = _DEFAULT_CONTENT_INDEXED
-    EnableDirBrowsing = _DEFAULT_ENABLE_DIR_BROWSING
-    EnableDefaultDoc = _DEFAULT_ENABLE_DEFAULT_DOC
-    DefaultDoc = None  # Only set in IIS if not None
-    ScriptMaps = []
-    ScriptMapUpdate = "end"  # can be 'start', 'end', 'replace'
-    Server = None
-
-    def __init__(self, **kw):
-        self.__dict__.update(kw)
-
-    def is_root(self):
-        "This virtual directory is a root directory if parent and name are blank"
-        parent, name = self.split_path()
-        return not parent and not name
-
-    def split_path(self):
-        return split_path(self.Name)
-
-
-class ScriptMapParams:
-    Extension = None
-    Module = None
-    Flags = 5
-    Verbs = ""
-    # Params that control if/how AddExtensionFile is called.
-    AddExtensionFile = True
-    AddExtensionFile_Enabled = True
-    AddExtensionFile_GroupID = None  # defaults to Name
-    AddExtensionFile_CanDelete = True
-    AddExtensionFile_Description = None  # defaults to Description.
-
-    def __init__(self, **kw):
-        self.__dict__.update(kw)
-
-    def __str__(self):
-        "Format this parameter suitable for IIS"
-        items = [self.Extension, self.Module, self.Flags]
-        # IIS gets upset if there is a trailing verb comma, but no verbs
-        if self.Verbs:
-            items.append(self.Verbs)
-        items = [str(item) for item in items]
-        return ",".join(items)
-
-
-class ISAPIParameters:
-    ServerName = _DEFAULT_SERVER_NAME
-    # Description = None
-    Filters = []
-    VirtualDirs = []
-
-    def __init__(self, **kw):
-        self.__dict__.update(kw)
-
-
-verbose = 1  # The level - 0 is quiet.
-
-
-def log(level, what):
-    if verbose >= level:
-        print(what)
-
-
-# Convert an ADSI COM exception to the Win32 error code embedded in it.
-def _GetWin32ErrorCode(com_exc):
-    hr = com_exc.hresult
-    # If we have more details in the 'excepinfo' struct, use it.
-    if com_exc.excepinfo:
-        hr = com_exc.excepinfo[-1]
-    if winerror.HRESULT_FACILITY(hr) != winerror.FACILITY_WIN32:
-        raise
-    return winerror.SCODE_CODE(hr)
-
-
-class InstallationError(Exception):
-    pass
-
-
-class ItemNotFound(InstallationError):
-    pass
-
-
-class ConfigurationError(InstallationError):
-    pass
-
-
-def FindPath(options, server, name):
-    if name.lower().startswith("iis://"):
-        return name
-    else:
-        if name and name[0] != "/":
-            name = "/" + name
-        return FindWebServer(options, server) + "/ROOT" + name
-
-
-def LocateWebServerPath(description):
-    """
-    Find an IIS web server whose name or comment matches the provided
-    description (case-insensitive).
-
-    >>> LocateWebServerPath('Default Web Site') # doctest: +SKIP
-
-    or
-
-    >>> LocateWebServerPath('1') #doctest: +SKIP
-    """
-    assert len(description) >= 1, "Server name or comment is required"
-    iis = GetObject(_IIS_OBJECT)
-    description = description.lower().strip()
-    for site in iis:
-        # Name is generally a number, but no need to assume that.
-        site_attributes = [
-            getattr(site, attr, "").lower().strip()
-            for attr in ("Name", "ServerComment")
-        ]
-        if description in site_attributes:
-            return site.AdsPath
-    msg = "No web sites match the description '%s'" % description
-    raise ItemNotFound(msg)
-
-
-def GetWebServer(description=None):
-    """
-    Load the web server instance (COM object) for a given instance
-    or description.
-    If None is specified, the default website is retrieved (indicated
-    by the identifier 1.
-    """
-    description = description or "1"
-    path = LocateWebServerPath(description)
-    server = LoadWebServer(path)
-    return server
-
-
-def LoadWebServer(path):
-    try:
-        server = GetObject(path)
-    except pythoncom.com_error as details:
-        msg = details.strerror
-        if exc.excepinfo and exc.excepinfo[2]:
-            msg = exc.excepinfo[2]
-        msg = "WebServer %s: %s" % (path, msg)
-        raise ItemNotFound(msg)
-    return server
-
-
-def FindWebServer(options, server_desc):
-    """
-    Legacy function to allow options to define a .server property
-    to override the other parameter.  Use GetWebServer instead.
-    """
-    # options takes precedence
-    server_desc = options.server or server_desc
-    # make sure server_desc is unicode (could be mbcs if passed in
-    #  sys.argv).
-    if server_desc and not isinstance(server_desc, str):
-        server_desc = server_desc.decode("mbcs")
-
-    # get the server (if server_desc is None, the default site is acquired)
-    server = GetWebServer(server_desc)
-    return server.adsPath
-
-
-def split_path(path):
-    """
-    Get the parent path and basename.
-
-    >>> split_path('/')
-    ['', '']
-
-    >>> split_path('')
-    ['', '']
-
-    >>> split_path('foo')
-    ['', 'foo']
-
-    >>> split_path('/foo')
-    ['', 'foo']
-
-    >>> split_path('/foo/bar')
-    ['/foo', 'bar']
-
-    >>> split_path('foo/bar')
-    ['/foo', 'bar']
-    """
-
-    if not path.startswith("/"):
-        path = "/" + path
-    return path.rsplit("/", 1)
-
-
-def _CreateDirectory(iis_dir, name, params):
-    # We used to go to lengths to keep an existing virtual directory
-    # in place.  However, in some cases the existing directories got
-    # into a bad state, and an update failed to get them working.
-    # So we nuke it first.  If this is a problem, we could consider adding
-    # a --keep-existing option.
-    try:
-        # Also seen the Class change to a generic IISObject - so nuke
-        # *any* existing object, regardless of Class
-        assert name.strip("/"), "mustn't delete the root!"
-        iis_dir.Delete("", name)
-        log(2, "Deleted old directory '%s'" % (name,))
-    except pythoncom.com_error:
-        pass
-
-    newDir = iis_dir.Create(params.Type, name)
-    log(2, "Creating new directory '%s' in %s..." % (name, iis_dir.Name))
-
-    friendly = params.Description or params.Name
-    newDir.AppFriendlyName = friendly
-
-    # Note that the new directory won't be visible in the IIS UI
-    # unless the directory exists on the filesystem.
-    try:
-        path = params.Path or iis_dir.Path
-        newDir.Path = path
-    except AttributeError:
-        # If params.Type is IIS_WEBDIRECTORY, an exception is thrown
-        pass
-    newDir.AppCreate2(params.AppProtection)
-    # XXX - note that these Headers only work in IIS6 and earlier.  IIS7
-    # only supports them on the w3svc node - not even on individial sites,
-    # let alone individual extensions in the site!
-    if params.Headers:
-        newDir.HttpCustomHeaders = params.Headers
-
-    log(2, "Setting directory options...")
-    newDir.AccessExecute = params.AccessExecute
-    newDir.AccessRead = params.AccessRead
-    newDir.AccessWrite = params.AccessWrite
-    newDir.AccessScript = params.AccessScript
-    newDir.ContentIndexed = params.ContentIndexed
-    newDir.EnableDirBrowsing = params.EnableDirBrowsing
-    newDir.EnableDefaultDoc = params.EnableDefaultDoc
-    if params.DefaultDoc is not None:
-        newDir.DefaultDoc = params.DefaultDoc
-    newDir.SetInfo()
-    return newDir
-
-
-def CreateDirectory(params, options):
-    _CallHook(params, "PreInstall", options)
-    if not params.Name:
-        raise ConfigurationError("No Name param")
-    parent, name = params.split_path()
-    target_dir = GetObject(FindPath(options, params.Server, parent))
-
-    if not params.is_root():
-        target_dir = _CreateDirectory(target_dir, name, params)
-
-    AssignScriptMaps(params.ScriptMaps, target_dir, params.ScriptMapUpdate)
-
-    _CallHook(params, "PostInstall", options, target_dir)
-    log(1, "Configured Virtual Directory: %s" % (params.Name,))
-    return target_dir
-
-
-def AssignScriptMaps(script_maps, target, update="replace"):
-    """Updates IIS with the supplied script map information.
-
-    script_maps is a list of ScriptMapParameter objects
-
-    target is an IIS Virtual Directory to assign the script maps to
-
-    update is a string indicating how to update the maps, one of  ('start',
-    'end', or 'replace')
-    """
-    # determine which function to use to assign script maps
-    script_map_func = "_AssignScriptMaps" + update.capitalize()
-    try:
-        script_map_func = eval(script_map_func)
-    except NameError:
-        msg = "Unknown ScriptMapUpdate option '%s'" % update
-        raise ConfigurationError(msg)
-    # use the str method to format the script maps for IIS
-    script_maps = [str(s) for s in script_maps]
-    # call the correct function
-    script_map_func(target, script_maps)
-    target.SetInfo()
-
-
-def get_unique_items(sequence, reference):
-    "Return items in sequence that can't be found in reference."
-    return tuple([item for item in sequence if item not in reference])
-
-
-def _AssignScriptMapsReplace(target, script_maps):
-    target.ScriptMaps = script_maps
-
-
-def _AssignScriptMapsEnd(target, script_maps):
-    unique_new_maps = get_unique_items(script_maps, target.ScriptMaps)
-    target.ScriptMaps = target.ScriptMaps + unique_new_maps
-
-
-def _AssignScriptMapsStart(target, script_maps):
-    unique_new_maps = get_unique_items(script_maps, target.ScriptMaps)
-    target.ScriptMaps = unique_new_maps + target.ScriptMaps
-
-
-def CreateISAPIFilter(filterParams, options):
-    server = FindWebServer(options, filterParams.Server)
-    _CallHook(filterParams, "PreInstall", options)
-    try:
-        filters = GetObject(server + "/Filters")
-    except pythoncom.com_error as exc:
-        # Brand new sites don't have the '/Filters' collection - create it.
-        # Any errors other than 'not found' we shouldn't ignore.
-        if (
-            winerror.HRESULT_FACILITY(exc.hresult) != winerror.FACILITY_WIN32
-            or winerror.HRESULT_CODE(exc.hresult) != winerror.ERROR_PATH_NOT_FOUND
-        ):
-            raise
-        server_ob = GetObject(server)
-        filters = server_ob.Create(_IIS_FILTERS, "Filters")
-        filters.FilterLoadOrder = ""
-        filters.SetInfo()
-
-    # As for VirtualDir, delete an existing one.
-    assert filterParams.Name.strip("/"), "mustn't delete the root!"
-    try:
-        filters.Delete(_IIS_FILTER, filterParams.Name)
-        log(2, "Deleted old filter '%s'" % (filterParams.Name,))
-    except pythoncom.com_error:
-        pass
-    newFilter = filters.Create(_IIS_FILTER, filterParams.Name)
-    log(2, "Created new ISAPI filter...")
-    assert os.path.isfile(filterParams.Path)
-    newFilter.FilterPath = filterParams.Path
-    newFilter.FilterDescription = filterParams.Description
-    newFilter.SetInfo()
-    load_order = [b.strip() for b in filters.FilterLoadOrder.split(",") if b]
-    if filterParams.Name not in load_order:
-        load_order.append(filterParams.Name)
-        filters.FilterLoadOrder = ",".join(load_order)
-        filters.SetInfo()
-    _CallHook(filterParams, "PostInstall", options, newFilter)
-    log(1, "Configured Filter: %s" % (filterParams.Name,))
-    return newFilter
-
-
-def DeleteISAPIFilter(filterParams, options):
-    _CallHook(filterParams, "PreRemove", options)
-    server = FindWebServer(options, filterParams.Server)
-    ob_path = server + "/Filters"
-    try:
-        filters = GetObject(ob_path)
-    except pythoncom.com_error as details:
-        # failure to open the filters just means a totally clean IIS install
-        # (IIS5 at least has no 'Filters' key when freshly installed).
-        log(2, "ISAPI filter path '%s' did not exist." % (ob_path,))
-        return
-    try:
-        assert filterParams.Name.strip("/"), "mustn't delete the root!"
-        filters.Delete(_IIS_FILTER, filterParams.Name)
-        log(2, "Deleted ISAPI filter '%s'" % (filterParams.Name,))
-    except pythoncom.com_error as details:
-        rc = _GetWin32ErrorCode(details)
-        if rc != winerror.ERROR_PATH_NOT_FOUND:
-            raise
-        log(2, "ISAPI filter '%s' did not exist." % (filterParams.Name,))
-    # Remove from the load order
-    load_order = [b.strip() for b in filters.FilterLoadOrder.split(",") if b]
-    if filterParams.Name in load_order:
-        load_order.remove(filterParams.Name)
-        filters.FilterLoadOrder = ",".join(load_order)
-        filters.SetInfo()
-    _CallHook(filterParams, "PostRemove", options)
-    log(1, "Deleted Filter: %s" % (filterParams.Name,))
-
-
-def _AddExtensionFile(module, def_groupid, def_desc, params, options):
-    group_id = params.AddExtensionFile_GroupID or def_groupid
-    desc = params.AddExtensionFile_Description or def_desc
-    try:
-        ob = GetObject(_IIS_OBJECT)
-        ob.AddExtensionFile(
-            module,
-            params.AddExtensionFile_Enabled,
-            group_id,
-            params.AddExtensionFile_CanDelete,
-            desc,
-        )
-        log(2, "Added extension file '%s' (%s)" % (module, desc))
-    except (pythoncom.com_error, AttributeError) as details:
-        # IIS5 always fails.  Probably should upgrade this to
-        # complain more loudly if IIS6 fails.
-        log(2, "Failed to add extension file '%s': %s" % (module, details))
-
-
-def AddExtensionFiles(params, options):
-    """Register the modules used by the filters/extensions as a trusted
-    'extension module' - required by the default IIS6 security settings."""
-    # Add each module only once.
-    added = {}
-    for vd in params.VirtualDirs:
-        for smp in vd.ScriptMaps:
-            if smp.Module not in added and smp.AddExtensionFile:
-                _AddExtensionFile(smp.Module, vd.Name, vd.Description, smp, options)
-                added[smp.Module] = True
-
-    for fd in params.Filters:
-        if fd.Path not in added and fd.AddExtensionFile:
-            _AddExtensionFile(fd.Path, fd.Name, fd.Description, fd, options)
-            added[fd.Path] = True
-
-
-def _DeleteExtensionFileRecord(module, options):
-    try:
-        ob = GetObject(_IIS_OBJECT)
-        ob.DeleteExtensionFileRecord(module)
-        log(2, "Deleted extension file record for '%s'" % module)
-    except (pythoncom.com_error, AttributeError) as details:
-        log(2, "Failed to remove extension file '%s': %s" % (module, details))
-
-
-def DeleteExtensionFileRecords(params, options):
-    deleted = {}  # only remove each .dll once.
-    for vd in params.VirtualDirs:
-        for smp in vd.ScriptMaps:
-            if smp.Module not in deleted and smp.AddExtensionFile:
-                _DeleteExtensionFileRecord(smp.Module, options)
-                deleted[smp.Module] = True
-
-    for filter_def in params.Filters:
-        if filter_def.Path not in deleted and filter_def.AddExtensionFile:
-            _DeleteExtensionFileRecord(filter_def.Path, options)
-            deleted[filter_def.Path] = True
-
-
-def CheckLoaderModule(dll_name):
-    suffix = ""
-    if is_debug_build:
-        suffix = "_d"
-    template = os.path.join(this_dir, "PyISAPI_loader" + suffix + ".dll")
-    if not os.path.isfile(template):
-        raise ConfigurationError("Template loader '%s' does not exist" % (template,))
-    # We can't do a simple "is newer" check, as the DLL is specific to the
-    # Python version.  So we check the date-time and size are identical,
-    # and skip the copy in that case.
-    src_stat = os.stat(template)
-    try:
-        dest_stat = os.stat(dll_name)
-    except os.error:
-        same = 0
-    else:
-        same = (
-            src_stat[stat.ST_SIZE] == dest_stat[stat.ST_SIZE]
-            and src_stat[stat.ST_MTIME] == dest_stat[stat.ST_MTIME]
-        )
-    if not same:
-        log(2, "Updating %s->%s" % (template, dll_name))
-        shutil.copyfile(template, dll_name)
-        shutil.copystat(template, dll_name)
-    else:
-        log(2, "%s is up to date." % (dll_name,))
-
-
-def _CallHook(ob, hook_name, options, *extra_args):
-    func = getattr(ob, hook_name, None)
-    if func is not None:
-        args = (ob, options) + extra_args
-        func(*args)
-
-
-def Install(params, options):
-    _CallHook(params, "PreInstall", options)
-    for vd in params.VirtualDirs:
-        CreateDirectory(vd, options)
-
-    for filter_def in params.Filters:
-        CreateISAPIFilter(filter_def, options)
-
-    AddExtensionFiles(params, options)
-
-    _CallHook(params, "PostInstall", options)
-
-
-def RemoveDirectory(params, options):
-    if params.is_root():
-        return
-    try:
-        directory = GetObject(FindPath(options, params.Server, params.Name))
-    except pythoncom.com_error as details:
-        rc = _GetWin32ErrorCode(details)
-        if rc != winerror.ERROR_PATH_NOT_FOUND:
-            raise
-        log(2, "VirtualDirectory '%s' did not exist" % params.Name)
-        directory = None
-    if directory is not None:
-        # Be robust should IIS get upset about unloading.
-        try:
-            directory.AppUnLoad()
-        except:
-            exc_val = sys.exc_info()[1]
-            log(2, "AppUnLoad() for %s failed: %s" % (params.Name, exc_val))
-        # Continue trying to delete it.
-        try:
-            parent = GetObject(directory.Parent)
-            parent.Delete(directory.Class, directory.Name)
-            log(1, "Deleted Virtual Directory: %s" % (params.Name,))
-        except:
-            exc_val = sys.exc_info()[1]
-            log(1, "Failed to remove directory %s: %s" % (params.Name, exc_val))
-
-
-def RemoveScriptMaps(vd_params, options):
-    "Remove script maps from the already installed virtual directory"
-    parent, name = vd_params.split_path()
-    target_dir = GetObject(FindPath(options, vd_params.Server, parent))
-    installed_maps = list(target_dir.ScriptMaps)
-    for _map in map(str, vd_params.ScriptMaps):
-        if _map in installed_maps:
-            installed_maps.remove(_map)
-    target_dir.ScriptMaps = installed_maps
-    target_dir.SetInfo()
-
-
-def Uninstall(params, options):
-    _CallHook(params, "PreRemove", options)
-
-    DeleteExtensionFileRecords(params, options)
-
-    for vd in params.VirtualDirs:
-        _CallHook(vd, "PreRemove", options)
-
-        RemoveDirectory(vd, options)
-        if vd.is_root():
-            # if this is installed to the root virtual directory, we can't delete it
-            #  so remove the script maps.
-            RemoveScriptMaps(vd, options)
-
-        _CallHook(vd, "PostRemove", options)
-
-    for filter_def in params.Filters:
-        DeleteISAPIFilter(filter_def, options)
-    _CallHook(params, "PostRemove", options)
-
-
-# Patch up any missing module names in the params, replacing them with
-# the DLL name that hosts this extension/filter.
-def _PatchParamsModule(params, dll_name, file_must_exist=True):
-    if file_must_exist:
-        if not os.path.isfile(dll_name):
-            raise ConfigurationError("%s does not exist" % (dll_name,))
-
-    # Patch up all references to the DLL.
-    for f in params.Filters:
-        if f.Path is None:
-            f.Path = dll_name
-    for d in params.VirtualDirs:
-        for sm in d.ScriptMaps:
-            if sm.Module is None:
-                sm.Module = dll_name
-
-
-def GetLoaderModuleName(mod_name, check_module=None):
-    # find the name of the DLL hosting us.
-    # By default, this is "_{module_base_name}.dll"
-    if hasattr(sys, "frozen"):
-        # What to do?  The .dll knows its name, but this is likely to be
-        # executed via a .exe, which does not know.
-        base, ext = os.path.splitext(mod_name)
-        path, base = os.path.split(base)
-        # handle the common case of 'foo.exe'/'foow.exe'
-        if base.endswith("w"):
-            base = base[:-1]
-        # For py2exe, we have '_foo.dll' as the standard pyisapi loader - but
-        # 'foo.dll' is what we use (it just delegates).
-        # So no leading '_' on the installed name.
-        dll_name = os.path.abspath(os.path.join(path, base + ".dll"))
-    else:
-        base, ext = os.path.splitext(mod_name)
-        path, base = os.path.split(base)
-        dll_name = os.path.abspath(os.path.join(path, "_" + base + ".dll"))
-    # Check we actually have it.
-    if check_module is None:
-        check_module = not hasattr(sys, "frozen")
-    if check_module:
-        CheckLoaderModule(dll_name)
-    return dll_name
-
-
-# Note the 'log' params to these 'builtin' args - old versions of pywin32
-# didn't log at all in this function (by intent; anyone calling this was
-# responsible). So existing code that calls this function with the old
-# signature (ie, without a 'log' param) still gets the same behaviour as
-# before...
-
-
-def InstallModule(conf_module_name, params, options, log=lambda *args: None):
-    "Install the extension"
-    if not hasattr(sys, "frozen"):
-        conf_module_name = os.path.abspath(conf_module_name)
-        if not os.path.isfile(conf_module_name):
-            raise ConfigurationError("%s does not exist" % (conf_module_name,))
-
-    loader_dll = GetLoaderModuleName(conf_module_name)
-    _PatchParamsModule(params, loader_dll)
-    Install(params, options)
-    log(1, "Installation complete.")
-
-
-def UninstallModule(conf_module_name, params, options, log=lambda *args: None):
-    "Remove the extension"
-    loader_dll = GetLoaderModuleName(conf_module_name, False)
-    _PatchParamsModule(params, loader_dll, False)
-    Uninstall(params, options)
-    log(1, "Uninstallation complete.")
-
-
-standard_arguments = {
-    "install": InstallModule,
-    "remove": UninstallModule,
-}
-
-
-def build_usage(handler_map):
-    docstrings = [handler.__doc__ for handler in handler_map.values()]
-    all_args = dict(zip(iter(handler_map.keys()), docstrings))
-    arg_names = "|".join(iter(all_args.keys()))
-    usage_string = "%prog [options] [" + arg_names + "]\n"
-    usage_string += "commands:\n"
-    for arg, desc in all_args.items():
-        usage_string += " %-10s: %s" % (arg, desc) + "\n"
-    return usage_string[:-1]
-
-
-def MergeStandardOptions(options, params):
-    """
-    Take an options object generated by the command line and merge
-    the values into the IISParameters object.
-    """
-    pass
-
-
-# We support 2 ways of extending our command-line/install support.
-# * Many of the installation items allow you to specify "PreInstall",
-#   "PostInstall", "PreRemove" and "PostRemove" hooks
-#   All hooks are called with the 'params' object being operated on, and
-#   the 'optparser' options for this session (ie, the command-line options)
-#   PostInstall for VirtualDirectories and Filters both have an additional
-#   param - the ADSI object just created.
-# * You can pass your own option parser for us to use, and/or define a map
-#   with your own custom arg handlers.  It is a map of 'arg'->function.
-#   The function is called with (options, log_fn, arg).  The function's
-#   docstring is used in the usage output.
-def HandleCommandLine(
-    params,
-    argv=None,
-    conf_module_name=None,
-    default_arg="install",
-    opt_parser=None,
-    custom_arg_handlers={},
-):
-    """Perform installation or removal of an ISAPI filter or extension.
-
-    This module handles standard command-line options and configuration
-    information, and installs, removes or updates the configuration of an
-    ISAPI filter or extension.
-
-    You must pass your configuration information in params - all other
-    arguments are optional, and allow you to configure the installation
-    process.
-    """
-    global verbose
-    from optparse import OptionParser
-
-    argv = argv or sys.argv
-    if not conf_module_name:
-        conf_module_name = sys.argv[0]
-        # convert to a long name so that if we were somehow registered with
-        # the "short" version but unregistered with the "long" version we
-        # still work (that will depend on exactly how the installer was
-        # started)
-        try:
-            conf_module_name = win32api.GetLongPathName(conf_module_name)
-        except win32api.error as exc:
-            log(
-                2,
-                "Couldn't determine the long name for %r: %s" % (conf_module_name, exc),
-            )
-
-    if opt_parser is None:
-        # Build our own parser.
-        parser = OptionParser(usage="")
-    else:
-        # The caller is providing their own filter, presumably with their
-        # own options all setup.
-        parser = opt_parser
-
-    # build a usage string if we don't have one.
-    if not parser.get_usage():
-        all_handlers = standard_arguments.copy()
-        all_handlers.update(custom_arg_handlers)
-        parser.set_usage(build_usage(all_handlers))
-
-    # allow the user to use uninstall as a synonym for remove if it wasn't
-    #  defined by the custom arg handlers.
-    all_handlers.setdefault("uninstall", all_handlers["remove"])
-
-    parser.add_option(
-        "-q",
-        "--quiet",
-        action="store_false",
-        dest="verbose",
-        default=True,
-        help="don't print status messages to stdout",
-    )
-    parser.add_option(
-        "-v",
-        "--verbosity",
-        action="count",
-        dest="verbose",
-        default=1,
-        help="increase the verbosity of status messages",
-    )
-    parser.add_option(
-        "",
-        "--server",
-        action="store",
-        help="Specifies the IIS server to install/uninstall on."
-        " Default is '%s/1'" % (_IIS_OBJECT,),
-    )
-
-    (options, args) = parser.parse_args(argv[1:])
-    MergeStandardOptions(options, params)
-    verbose = options.verbose
-    if not args:
-        args = [default_arg]
-    try:
-        for arg in args:
-            handler = all_handlers[arg]
-            handler(conf_module_name, params, options, log)
-    except (ItemNotFound, InstallationError) as details:
-        if options.verbose > 1:
-            traceback.print_exc()
-        print("%s: %s" % (details.__class__.__name__, details))
-    except KeyError:
-        parser.error("Invalid arg '%s'" % arg)
diff --git a/lib/isapi/isapicon.py b/lib/isapi/isapicon.py
deleted file mode 100644
index 20de1a44..00000000
--- a/lib/isapi/isapicon.py
+++ /dev/null
@@ -1,120 +0,0 @@
-"""Constants needed by ISAPI filters and extensions."""
-#  ======================================================================
-#  Copyright 2002-2003 by Blackdog Software Pty Ltd.
-#
-#                          All Rights Reserved
-#
-#  Permission to use, copy, modify, and distribute this software and
-#  its documentation for any purpose and without fee is hereby
-#  granted, provided that the above copyright notice appear in all
-#  copies and that both that copyright notice and this permission
-#  notice appear in supporting documentation, and that the name of
-#  Blackdog Software not be used in advertising or publicity pertaining to
-#  distribution of the software without specific, written prior
-#  permission.
-#
-#  BLACKDOG SOFTWARE DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
-#  INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN
-#  NO EVENT SHALL BLACKDOG SOFTWARE BE LIABLE FOR ANY SPECIAL, INDIRECT OR
-#  CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS
-#  OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
-#  NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
-#  CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
-#  ======================================================================
-
-# HTTP reply codes
-
-HTTP_CONTINUE = 100
-HTTP_SWITCHING_PROTOCOLS = 101
-HTTP_PROCESSING = 102
-HTTP_OK = 200
-HTTP_CREATED = 201
-HTTP_ACCEPTED = 202
-HTTP_NON_AUTHORITATIVE = 203
-HTTP_NO_CONTENT = 204
-HTTP_RESET_CONTENT = 205
-HTTP_PARTIAL_CONTENT = 206
-HTTP_MULTI_STATUS = 207
-HTTP_MULTIPLE_CHOICES = 300
-HTTP_MOVED_PERMANENTLY = 301
-HTTP_MOVED_TEMPORARILY = 302
-HTTP_SEE_OTHER = 303
-HTTP_NOT_MODIFIED = 304
-HTTP_USE_PROXY = 305
-HTTP_TEMPORARY_REDIRECT = 307
-HTTP_BAD_REQUEST = 400
-HTTP_UNAUTHORIZED = 401
-HTTP_PAYMENT_REQUIRED = 402
-HTTP_FORBIDDEN = 403
-HTTP_NOT_FOUND = 404
-HTTP_METHOD_NOT_ALLOWED = 405
-HTTP_NOT_ACCEPTABLE = 406
-HTTP_PROXY_AUTHENTICATION_REQUIRED = 407
-HTTP_REQUEST_TIME_OUT = 408
-HTTP_CONFLICT = 409
-HTTP_GONE = 410
-HTTP_LENGTH_REQUIRED = 411
-HTTP_PRECONDITION_FAILED = 412
-HTTP_REQUEST_ENTITY_TOO_LARGE = 413
-HTTP_REQUEST_URI_TOO_LARGE = 414
-HTTP_UNSUPPORTED_MEDIA_TYPE = 415
-HTTP_RANGE_NOT_SATISFIABLE = 416
-HTTP_EXPECTATION_FAILED = 417
-HTTP_UNPROCESSABLE_ENTITY = 422
-HTTP_INTERNAL_SERVER_ERROR = 500
-HTTP_NOT_IMPLEMENTED = 501
-HTTP_BAD_GATEWAY = 502
-HTTP_SERVICE_UNAVAILABLE = 503
-HTTP_GATEWAY_TIME_OUT = 504
-HTTP_VERSION_NOT_SUPPORTED = 505
-HTTP_VARIANT_ALSO_VARIES = 506
-
-HSE_STATUS_SUCCESS = 1
-HSE_STATUS_SUCCESS_AND_KEEP_CONN = 2
-HSE_STATUS_PENDING = 3
-HSE_STATUS_ERROR = 4
-
-SF_NOTIFY_SECURE_PORT = 0x00000001
-SF_NOTIFY_NONSECURE_PORT = 0x00000002
-SF_NOTIFY_READ_RAW_DATA = 0x00008000
-SF_NOTIFY_PREPROC_HEADERS = 0x00004000
-SF_NOTIFY_AUTHENTICATION = 0x00002000
-SF_NOTIFY_URL_MAP = 0x00001000
-SF_NOTIFY_ACCESS_DENIED = 0x00000800
-SF_NOTIFY_SEND_RESPONSE = 0x00000040
-SF_NOTIFY_SEND_RAW_DATA = 0x00000400
-SF_NOTIFY_LOG = 0x00000200
-SF_NOTIFY_END_OF_REQUEST = 0x00000080
-SF_NOTIFY_END_OF_NET_SESSION = 0x00000100
-
-SF_NOTIFY_ORDER_HIGH = 0x00080000
-SF_NOTIFY_ORDER_MEDIUM = 0x00040000
-SF_NOTIFY_ORDER_LOW = 0x00020000
-SF_NOTIFY_ORDER_DEFAULT = SF_NOTIFY_ORDER_LOW
-
-SF_NOTIFY_ORDER_MASK = (
-    SF_NOTIFY_ORDER_HIGH | SF_NOTIFY_ORDER_MEDIUM | SF_NOTIFY_ORDER_LOW
-)
-
-SF_STATUS_REQ_FINISHED = 134217728  # 0x8000000
-SF_STATUS_REQ_FINISHED_KEEP_CONN = 134217728 + 1
-SF_STATUS_REQ_NEXT_NOTIFICATION = 134217728 + 2
-SF_STATUS_REQ_HANDLED_NOTIFICATION = 134217728 + 3
-SF_STATUS_REQ_ERROR = 134217728 + 4
-SF_STATUS_REQ_READ_NEXT = 134217728 + 5
-
-HSE_IO_SYNC = 0x00000001  # for WriteClient
-HSE_IO_ASYNC = 0x00000002  # for WriteClient/TF/EU
-HSE_IO_DISCONNECT_AFTER_SEND = 0x00000004  # for TF
-HSE_IO_SEND_HEADERS = 0x00000008  # for TF
-HSE_IO_NODELAY = 0x00001000  # turn off nagling
-# These two are only used by VectorSend
-HSE_IO_FINAL_SEND = 0x00000010
-HSE_IO_CACHE_RESPONSE = 0x00000020
-
-HSE_EXEC_URL_NO_HEADERS = 0x02
-HSE_EXEC_URL_IGNORE_CURRENT_INTERCEPTOR = 0x04
-HSE_EXEC_URL_IGNORE_VALIDATION_AND_RANGE = 0x10
-HSE_EXEC_URL_DISABLE_CUSTOM_ERROR = 0x20
-HSE_EXEC_URL_SSI_CMD = 0x40
-HSE_EXEC_URL_HTTP_CACHE_ELIGIBLE = 0x80
diff --git a/lib/isapi/samples/README.txt b/lib/isapi/samples/README.txt
deleted file mode 100644
index cff87587..00000000
--- a/lib/isapi/samples/README.txt
+++ /dev/null
@@ -1,20 +0,0 @@
-In this directory you will find examples of ISAPI filters and extensions.
-
-The filter loading mechanism works like this:
-* IIS loads the special Python "loader" DLL.  This DLL will generally have a 
-  leading underscore as part of its name.
-* This loader DLL looks for a Python module, by removing the first letter of
-  the DLL base name.
-  
-This means that an ISAPI extension module consists of 2 key files - the loader
-DLL (eg, "_MyIISModule.dll", and a Python module (which for this example
-would be "MyIISModule.py")
-
-When you install an ISAPI extension, the installation code checks to see if
-there is a loader DLL for your implementation file - if one does not exist, 
-or the standard loader is different, it is copied and renamed accordingly.
-
-We use this mechanism to provide the maximum separation between different
-Python extensions installed on the same server - otherwise filter order and
-other tricky IIS semantics would need to be replicated.  Also, each filter
-gets its own thread-pool, etc.
diff --git a/lib/isapi/samples/advanced.py b/lib/isapi/samples/advanced.py
deleted file mode 100644
index c10d0c80..00000000
--- a/lib/isapi/samples/advanced.py
+++ /dev/null
@@ -1,218 +0,0 @@
-# This extension demonstrates some advanced features of the Python ISAPI
-# framework.
-# We demonstrate:
-# * Reloading your Python module without shutting down IIS (eg, when your
-#   .py implementation file changes.)
-# * Custom command-line handling - both additional options and commands.
-# * Using a query string - any part of the URL after a '?' is assumed to
-#   be "variable names" separated by '&' - we will print the values of
-#   these server variables.
-# * If the tail portion of the URL is "ReportUnhealthy", IIS will be
-#   notified we are unhealthy via a HSE_REQ_REPORT_UNHEALTHY request.
-#   Whether this is acted upon depends on if the IIS health-checking
-#   tools are installed, but you should always see the reason written
-#   to the Windows event log - see the IIS documentation for more.
-
-import os
-import stat
-import sys
-
-from isapi import isapicon
-from isapi.simple import SimpleExtension
-
-if hasattr(sys, "isapidllhandle"):
-    import win32traceutil
-
-# Notes on reloading
-# If your HttpFilterProc or HttpExtensionProc functions raises
-# 'isapi.InternalReloadException', the framework will not treat it
-# as an error but instead will terminate your extension, reload your
-# extension module, re-initialize the instance, and re-issue the request.
-# The Initialize functions are called with None as their param.  The
-# return code from the terminate function is ignored.
-#
-# This is all the framework does to help you.  It is up to your code
-# when you raise this exception.  This sample uses a Win32 "find
-# notification".  Whenever windows tells us one of the files in the
-# directory has changed, we check if the time of our source-file has
-# changed, and set a flag.  Next imcoming request, we check the flag and
-# raise the special exception if set.
-#
-# The end result is that the module is automatically reloaded whenever
-# the source-file changes - you need take no further action to see your
-# changes reflected in the running server.
-
-# The framework only reloads your module - if you have libraries you
-# depend on and also want reloaded, you must arrange for this yourself.
-# One way of doing this would be to special case the import of these
-# modules.  Eg:
-# --
-# try:
-#    my_module = reload(my_module) # module already imported - reload it
-# except NameError:
-#    import my_module # first time around - import it.
-# --
-# When your module is imported for the first time, the NameError will
-# be raised, and the module imported.  When the ISAPI framework reloads
-# your module, the existing module will avoid the NameError, and allow
-# you to reload that module.
-
-import threading
-
-import win32con
-import win32event
-import win32file
-import winerror
-
-from isapi import InternalReloadException
-
-try:
-    reload_counter += 1
-except NameError:
-    reload_counter = 0
-
-
-# A watcher thread that checks for __file__ changing.
-# When it detects it, it simply sets "change_detected" to true.
-class ReloadWatcherThread(threading.Thread):
-    def __init__(self):
-        self.change_detected = False
-        self.filename = __file__
-        if self.filename.endswith("c") or self.filename.endswith("o"):
-            self.filename = self.filename[:-1]
-        self.handle = win32file.FindFirstChangeNotification(
-            os.path.dirname(self.filename),
-            False,  # watch tree?
-            win32con.FILE_NOTIFY_CHANGE_LAST_WRITE,
-        )
-        threading.Thread.__init__(self)
-
-    def run(self):
-        last_time = os.stat(self.filename)[stat.ST_MTIME]
-        while 1:
-            try:
-                rc = win32event.WaitForSingleObject(self.handle, win32event.INFINITE)
-                win32file.FindNextChangeNotification(self.handle)
-            except win32event.error as details:
-                # handle closed - thread should terminate.
-                if details.winerror != winerror.ERROR_INVALID_HANDLE:
-                    raise
-                break
-            this_time = os.stat(self.filename)[stat.ST_MTIME]
-            if this_time != last_time:
-                print("Detected file change - flagging for reload.")
-                self.change_detected = True
-                last_time = this_time
-
-    def stop(self):
-        win32file.FindCloseChangeNotification(self.handle)
-
-
-# The ISAPI extension - handles requests in our virtual dir, and sends the
-# response to the client.
-class Extension(SimpleExtension):
-    "Python advanced sample Extension"
-
-    def __init__(self):
-        self.reload_watcher = ReloadWatcherThread()
-        self.reload_watcher.start()
-
-    def HttpExtensionProc(self, ecb):
-        # NOTE: If you use a ThreadPoolExtension, you must still perform
-        # this check in HttpExtensionProc - raising the exception from
-        # The "Dispatch" method will just cause the exception to be
-        # rendered to the browser.
-        if self.reload_watcher.change_detected:
-            print("Doing reload")
-            raise InternalReloadException
-
-        url = ecb.GetServerVariable("UNICODE_URL")
-        if url.endswith("ReportUnhealthy"):
-            ecb.ReportUnhealthy("I'm a little sick")
-
-        ecb.SendResponseHeaders("200 OK", "Content-Type: text/html\r\n\r\n", 0)
-        print("<HTML><BODY>", file=ecb)
-
-        qs = ecb.GetServerVariable("QUERY_STRING")
-        if qs:
-            queries = qs.split("&")
-            print("<PRE>", file=ecb)
-            for q in queries:
-                val = ecb.GetServerVariable(q, "&lt;no such variable&gt;")
-                print("%s=%r" % (q, val), file=ecb)
-            print("</PRE><P/>", file=ecb)
-
-        print("This module has been imported", file=ecb)
-        print("%d times" % (reload_counter,), file=ecb)
-        print("</BODY></HTML>", file=ecb)
-        ecb.close()
-        return isapicon.HSE_STATUS_SUCCESS
-
-    def TerminateExtension(self, status):
-        self.reload_watcher.stop()
-
-
-# The entry points for the ISAPI extension.
-def __ExtensionFactory__():
-    return Extension()
-
-
-# Our special command line customization.
-# Pre-install hook for our virtual directory.
-def PreInstallDirectory(params, options):
-    # If the user used our special '--description' option,
-    # then we override our default.
-    if options.description:
-        params.Description = options.description
-
-
-# Post install hook for our entire script
-def PostInstall(params, options):
-    print()
-    print("The sample has been installed.")
-    print("Point your browser to /AdvancedPythonSample")
-    print("If you modify the source file and reload the page,")
-    print("you should see the reload counter increment")
-
-
-# Handler for our custom 'status' argument.
-def status_handler(options, log, arg):
-    "Query the status of something"
-    print("Everything seems to be fine!")
-
-
-custom_arg_handlers = {"status": status_handler}
-
-if __name__ == "__main__":
-    # If run from the command-line, install ourselves.
-    from isapi.install import *
-
-    params = ISAPIParameters(PostInstall=PostInstall)
-    # Setup the virtual directories - this is a list of directories our
-    # extension uses - in this case only 1.
-    # Each extension has a "script map" - this is the mapping of ISAPI
-    # extensions.
-    sm = [ScriptMapParams(Extension="*", Flags=0)]
-    vd = VirtualDirParameters(
-        Name="AdvancedPythonSample",
-        Description=Extension.__doc__,
-        ScriptMaps=sm,
-        ScriptMapUpdate="replace",
-        # specify the pre-install hook.
-        PreInstall=PreInstallDirectory,
-    )
-    params.VirtualDirs = [vd]
-    # Setup our custom option parser.
-    from optparse import OptionParser
-
-    parser = OptionParser("")  # blank usage, so isapi sets it.
-    parser.add_option(
-        "",
-        "--description",
-        action="store",
-        help="custom description to use for the virtual directory",
-    )
-
-    HandleCommandLine(
-        params, opt_parser=parser, custom_arg_handlers=custom_arg_handlers
-    )
diff --git a/lib/isapi/samples/redirector.py b/lib/isapi/samples/redirector.py
deleted file mode 100644
index 40698bb2..00000000
--- a/lib/isapi/samples/redirector.py
+++ /dev/null
@@ -1,125 +0,0 @@
-# This is a sample ISAPI extension written in Python.
-#
-# Please see README.txt in this directory, and specifically the
-# information about the "loader" DLL - installing this sample will create
-# "_redirector.dll" in the current directory.  The readme explains this.
-
-# Executing this script (or any server config script) will install the extension
-# into your web server. As the server executes, the PyISAPI framework will load
-# this module and create your Extension and Filter objects.
-
-# This is the simplest possible redirector (or proxy) we can write.  The
-# extension installs with a mask of '*' in the root of the site.
-# As an added bonus though, we optionally show how, on IIS6 and later, we
-# can use HSE_ERQ_EXEC_URL to ignore certain requests - in IIS5 and earlier
-# we can only do this with an ISAPI filter - see redirector_with_filter for
-# an example.  If this sample is run on IIS5 or earlier it simply ignores
-# any excludes.
-
-import sys
-
-from isapi import isapicon, threaded_extension
-
-try:
-    from urllib.request import urlopen
-except ImportError:
-    # py3k spelling...
-    from urllib.request import urlopen
-
-import win32api
-
-# sys.isapidllhandle will exist when we are loaded by the IIS framework.
-# In this case we redirect our output to the win32traceutil collector.
-if hasattr(sys, "isapidllhandle"):
-    import win32traceutil
-
-# The site we are proxying.
-proxy = "http://www.python.org"
-
-# Urls we exclude (ie, allow IIS to handle itself) - all are lowered,
-# and these entries exist by default on Vista...
-excludes = ["/iisstart.htm", "/welcome.png"]
-
-
-# An "io completion" function, called when ecb.ExecURL completes...
-def io_callback(ecb, url, cbIO, errcode):
-    # Get the status of our ExecURL
-    httpstatus, substatus, win32 = ecb.GetExecURLStatus()
-    print(
-        "ExecURL of %r finished with http status %d.%d, win32 status %d (%s)"
-        % (url, httpstatus, substatus, win32, win32api.FormatMessage(win32).strip())
-    )
-    # nothing more to do!
-    ecb.DoneWithSession()
-
-
-# The ISAPI extension - handles all requests in the site.
-class Extension(threaded_extension.ThreadPoolExtension):
-    "Python sample Extension"
-
-    def Dispatch(self, ecb):
-        # Note that our ThreadPoolExtension base class will catch exceptions
-        # in our Dispatch method, and write the traceback to the client.
-        # That is perfect for this sample, so we don't catch our own.
-        # print 'IIS dispatching "%s"' % (ecb.GetServerVariable("URL"),)
-        url = ecb.GetServerVariable("URL").decode("ascii")
-        for exclude in excludes:
-            if url.lower().startswith(exclude):
-                print("excluding %s" % url)
-                if ecb.Version < 0x60000:
-                    print("(but this is IIS5 or earlier - can't do 'excludes')")
-                else:
-                    ecb.IOCompletion(io_callback, url)
-                    ecb.ExecURL(
-                        None,
-                        None,
-                        None,
-                        None,
-                        None,
-                        isapicon.HSE_EXEC_URL_IGNORE_CURRENT_INTERCEPTOR,
-                    )
-                    return isapicon.HSE_STATUS_PENDING
-
-        new_url = proxy + url
-        print("Opening %s" % new_url)
-        fp = urlopen(new_url)
-        headers = fp.info()
-        # subtle py3k breakage: in py3k, str(headers) has normalized \r\n
-        # back to \n and also stuck an extra \n term.  py2k leaves the
-        # \r\n from the server in tact and finishes with a single term.
-        if sys.version_info < (3, 0):
-            header_text = str(headers) + "\r\n"
-        else:
-            # take *all* trailing \n off, replace remaining with
-            # \r\n, then add the 2 trailing \r\n.
-            header_text = str(headers).rstrip("\n").replace("\n", "\r\n") + "\r\n\r\n"
-        ecb.SendResponseHeaders("200 OK", header_text, False)
-        ecb.WriteClient(fp.read())
-        ecb.DoneWithSession()
-        print("Returned data from '%s'" % (new_url,))
-        return isapicon.HSE_STATUS_SUCCESS
-
-
-# The entry points for the ISAPI extension.
-def __ExtensionFactory__():
-    return Extension()
-
-
-if __name__ == "__main__":
-    # If run from the command-line, install ourselves.
-    from isapi.install import *
-
-    params = ISAPIParameters()
-    # Setup the virtual directories - this is a list of directories our
-    # extension uses - in this case only 1.
-    # Each extension has a "script map" - this is the mapping of ISAPI
-    # extensions.
-    sm = [ScriptMapParams(Extension="*", Flags=0)]
-    vd = VirtualDirParameters(
-        Name="/",
-        Description=Extension.__doc__,
-        ScriptMaps=sm,
-        ScriptMapUpdate="replace",
-    )
-    params.VirtualDirs = [vd]
-    HandleCommandLine(params)
diff --git a/lib/isapi/samples/redirector_asynch.py b/lib/isapi/samples/redirector_asynch.py
deleted file mode 100644
index 3c4b5e4f..00000000
--- a/lib/isapi/samples/redirector_asynch.py
+++ /dev/null
@@ -1,85 +0,0 @@
-# This is a sample ISAPI extension written in Python.
-
-# This is like the other 'redirector' samples, but uses asnch IO when writing
-# back to the client (it does *not* use asynch io talking to the remote
-# server!)
-
-import sys
-import urllib.error
-import urllib.parse
-import urllib.request
-
-from isapi import isapicon, threaded_extension
-
-# sys.isapidllhandle will exist when we are loaded by the IIS framework.
-# In this case we redirect our output to the win32traceutil collector.
-if hasattr(sys, "isapidllhandle"):
-    import win32traceutil
-
-# The site we are proxying.
-proxy = "http://www.python.org"
-
-# We synchronously read chunks of this size then asynchronously write them.
-CHUNK_SIZE = 8192
-
-
-# The callback made when IIS completes the asynch write.
-def io_callback(ecb, fp, cbIO, errcode):
-    print("IO callback", ecb, fp, cbIO, errcode)
-    chunk = fp.read(CHUNK_SIZE)
-    if chunk:
-        ecb.WriteClient(chunk, isapicon.HSE_IO_ASYNC)
-        # and wait for the next callback to say this chunk is done.
-    else:
-        # eof - say we are complete.
-        fp.close()
-        ecb.DoneWithSession()
-
-
-# The ISAPI extension - handles all requests in the site.
-class Extension(threaded_extension.ThreadPoolExtension):
-    "Python sample proxy server - asynch version."
-
-    def Dispatch(self, ecb):
-        print('IIS dispatching "%s"' % (ecb.GetServerVariable("URL"),))
-        url = ecb.GetServerVariable("URL")
-
-        new_url = proxy + url
-        print("Opening %s" % new_url)
-        fp = urllib.request.urlopen(new_url)
-        headers = fp.info()
-        ecb.SendResponseHeaders("200 OK", str(headers) + "\r\n", False)
-        # now send the first chunk asynchronously
-        ecb.ReqIOCompletion(io_callback, fp)
-        chunk = fp.read(CHUNK_SIZE)
-        if chunk:
-            ecb.WriteClient(chunk, isapicon.HSE_IO_ASYNC)
-            return isapicon.HSE_STATUS_PENDING
-        # no data - just close things now.
-        ecb.DoneWithSession()
-        return isapicon.HSE_STATUS_SUCCESS
-
-
-# The entry points for the ISAPI extension.
-def __ExtensionFactory__():
-    return Extension()
-
-
-if __name__ == "__main__":
-    # If run from the command-line, install ourselves.
-    from isapi.install import *
-
-    params = ISAPIParameters()
-    # Setup the virtual directories - this is a list of directories our
-    # extension uses - in this case only 1.
-    # Each extension has a "script map" - this is the mapping of ISAPI
-    # extensions.
-    sm = [ScriptMapParams(Extension="*", Flags=0)]
-    vd = VirtualDirParameters(
-        Name="/",
-        Description=Extension.__doc__,
-        ScriptMaps=sm,
-        ScriptMapUpdate="replace",
-    )
-    params.VirtualDirs = [vd]
-    HandleCommandLine(params)
diff --git a/lib/isapi/samples/redirector_with_filter.py b/lib/isapi/samples/redirector_with_filter.py
deleted file mode 100644
index a63b1db1..00000000
--- a/lib/isapi/samples/redirector_with_filter.py
+++ /dev/null
@@ -1,161 +0,0 @@
-# This is a sample configuration file for an ISAPI filter and extension
-# written in Python.
-#
-# Please see README.txt in this directory, and specifically the
-# information about the "loader" DLL - installing this sample will create
-# "_redirector_with_filter.dll" in the current directory.  The readme explains
-# this.
-
-# Executing this script (or any server config script) will install the extension
-# into your web server. As the server executes, the PyISAPI framework will load
-# this module and create your Extension and Filter objects.
-
-# This sample provides sample redirector:
-# It is implemented by a filter and an extension, so that some requests can
-# be ignored.  Compare with 'redirector_simple' which avoids the filter, but
-# is unable to selectively ignore certain requests.
-# The process is sample uses is:
-# * The filter is installed globally, as all filters are.
-# * A Virtual Directory named "python" is setup.  This dir has our ISAPI
-#   extension as the only application, mapped to file-extension '*'.  Thus, our
-#   extension handles *all* requests in this directory.
-# The basic process is that the filter does URL rewriting, redirecting every
-# URL to our Virtual Directory.  Our extension then handles this request,
-# forwarding the data from the proxied site.
-# For example:
-# * URL of "index.html" comes in.
-# * Filter rewrites this to "/python/index.html"
-# * Our extension sees the full "/python/index.html", removes the leading
-#   portion, and opens and forwards the remote URL.
-
-
-# This sample is very small - it avoid most error handling, etc.  It is for
-# demonstration purposes only.
-
-import sys
-import urllib.error
-import urllib.parse
-import urllib.request
-
-from isapi import isapicon, threaded_extension
-from isapi.simple import SimpleFilter
-
-# sys.isapidllhandle will exist when we are loaded by the IIS framework.
-# In this case we redirect our output to the win32traceutil collector.
-if hasattr(sys, "isapidllhandle"):
-    import win32traceutil
-
-# The site we are proxying.
-proxy = "http://www.python.org"
-# The name of the virtual directory we install in, and redirect from.
-virtualdir = "/python"
-
-# The key feature of this redirector over the simple redirector is that it
-# can choose to ignore certain responses by having the filter not rewrite them
-# to our virtual dir. For this sample, we just exclude the IIS help directory.
-
-
-# The ISAPI extension - handles requests in our virtual dir, and sends the
-# response to the client.
-class Extension(threaded_extension.ThreadPoolExtension):
-    "Python sample Extension"
-
-    def Dispatch(self, ecb):
-        # Note that our ThreadPoolExtension base class will catch exceptions
-        # in our Dispatch method, and write the traceback to the client.
-        # That is perfect for this sample, so we don't catch our own.
-        # print 'IIS dispatching "%s"' % (ecb.GetServerVariable("URL"),)
-        url = ecb.GetServerVariable("URL")
-        if url.startswith(virtualdir):
-            new_url = proxy + url[len(virtualdir) :]
-            print("Opening", new_url)
-            fp = urllib.request.urlopen(new_url)
-            headers = fp.info()
-            ecb.SendResponseHeaders("200 OK", str(headers) + "\r\n", False)
-            ecb.WriteClient(fp.read())
-            ecb.DoneWithSession()
-            print("Returned data from '%s'!" % (new_url,))
-        else:
-            # this should never happen - we should only see requests that
-            # start with our virtual directory name.
-            print("Not proxying '%s'" % (url,))
-
-
-# The ISAPI filter.
-class Filter(SimpleFilter):
-    "Sample Python Redirector"
-    filter_flags = isapicon.SF_NOTIFY_PREPROC_HEADERS | isapicon.SF_NOTIFY_ORDER_DEFAULT
-
-    def HttpFilterProc(self, fc):
-        # print "Filter Dispatch"
-        nt = fc.NotificationType
-        if nt != isapicon.SF_NOTIFY_PREPROC_HEADERS:
-            return isapicon.SF_STATUS_REQ_NEXT_NOTIFICATION
-
-        pp = fc.GetData()
-        url = pp.GetHeader("url")
-        # print "URL is '%s'" % (url,)
-        prefix = virtualdir
-        if not url.startswith(prefix):
-            new_url = prefix + url
-            print("New proxied URL is '%s'" % (new_url,))
-            pp.SetHeader("url", new_url)
-            # For the sake of demonstration, show how the FilterContext
-            # attribute is used.  It always starts out life as None, and
-            # any assignments made are automatically decref'd by the
-            # framework during a SF_NOTIFY_END_OF_NET_SESSION notification.
-            if fc.FilterContext is None:
-                fc.FilterContext = 0
-            fc.FilterContext += 1
-            print("This is request number %d on this connection" % fc.FilterContext)
-            return isapicon.SF_STATUS_REQ_HANDLED_NOTIFICATION
-        else:
-            print("Filter ignoring URL '%s'" % (url,))
-
-            # Some older code that handled SF_NOTIFY_URL_MAP.
-            # ~ print "Have URL_MAP notify"
-            # ~ urlmap = fc.GetData()
-            # ~ print "URI is", urlmap.URL
-            # ~ print "Path is", urlmap.PhysicalPath
-            # ~ if urlmap.URL.startswith("/UC/"):
-            # ~ # Find the /UC/ in the physical path, and nuke it (except
-            # ~ # as the path is physical, it is \)
-            # ~ p = urlmap.PhysicalPath
-            # ~ pos = p.index("\\UC\\")
-            # ~ p = p[:pos] + p[pos+3:]
-            # ~ p = r"E:\src\pyisapi\webroot\PyTest\formTest.htm"
-            # ~ print "New path is", p
-            # ~ urlmap.PhysicalPath = p
-
-
-# The entry points for the ISAPI extension.
-def __FilterFactory__():
-    return Filter()
-
-
-def __ExtensionFactory__():
-    return Extension()
-
-
-if __name__ == "__main__":
-    # If run from the command-line, install ourselves.
-    from isapi.install import *
-
-    params = ISAPIParameters()
-    # Setup all filters - these are global to the site.
-    params.Filters = [
-        FilterParameters(Name="PythonRedirector", Description=Filter.__doc__),
-    ]
-    # Setup the virtual directories - this is a list of directories our
-    # extension uses - in this case only 1.
-    # Each extension has a "script map" - this is the mapping of ISAPI
-    # extensions.
-    sm = [ScriptMapParams(Extension="*", Flags=0)]
-    vd = VirtualDirParameters(
-        Name=virtualdir[1:],
-        Description=Extension.__doc__,
-        ScriptMaps=sm,
-        ScriptMapUpdate="replace",
-    )
-    params.VirtualDirs = [vd]
-    HandleCommandLine(params)
diff --git a/lib/isapi/samples/test.py b/lib/isapi/samples/test.py
deleted file mode 100644
index 5e4d899b..00000000
--- a/lib/isapi/samples/test.py
+++ /dev/null
@@ -1,195 +0,0 @@
-# This extension is used mainly for testing purposes - it is not
-# designed to be a simple sample, but instead is a hotch-potch of things
-# that attempts to exercise the framework.
-
-import os
-import stat
-import sys
-
-from isapi import isapicon
-from isapi.simple import SimpleExtension
-
-if hasattr(sys, "isapidllhandle"):
-    import win32traceutil
-
-# We use the same reload support as 'advanced.py' demonstrates.
-import threading
-
-import win32con
-import win32event
-import win32file
-import winerror
-
-from isapi import InternalReloadException
-
-
-# A watcher thread that checks for __file__ changing.
-# When it detects it, it simply sets "change_detected" to true.
-class ReloadWatcherThread(threading.Thread):
-    def __init__(self):
-        self.change_detected = False
-        self.filename = __file__
-        if self.filename.endswith("c") or self.filename.endswith("o"):
-            self.filename = self.filename[:-1]
-        self.handle = win32file.FindFirstChangeNotification(
-            os.path.dirname(self.filename),
-            False,  # watch tree?
-            win32con.FILE_NOTIFY_CHANGE_LAST_WRITE,
-        )
-        threading.Thread.__init__(self)
-
-    def run(self):
-        last_time = os.stat(self.filename)[stat.ST_MTIME]
-        while 1:
-            try:
-                rc = win32event.WaitForSingleObject(self.handle, win32event.INFINITE)
-                win32file.FindNextChangeNotification(self.handle)
-            except win32event.error as details:
-                # handle closed - thread should terminate.
-                if details.winerror != winerror.ERROR_INVALID_HANDLE:
-                    raise
-                break
-            this_time = os.stat(self.filename)[stat.ST_MTIME]
-            if this_time != last_time:
-                print("Detected file change - flagging for reload.")
-                self.change_detected = True
-                last_time = this_time
-
-    def stop(self):
-        win32file.FindCloseChangeNotification(self.handle)
-
-
-def TransmitFileCallback(ecb, hFile, cbIO, errCode):
-    print("Transmit complete!")
-    ecb.close()
-
-
-# The ISAPI extension - handles requests in our virtual dir, and sends the
-# response to the client.
-class Extension(SimpleExtension):
-    "Python test Extension"
-
-    def __init__(self):
-        self.reload_watcher = ReloadWatcherThread()
-        self.reload_watcher.start()
-
-    def HttpExtensionProc(self, ecb):
-        # NOTE: If you use a ThreadPoolExtension, you must still perform
-        # this check in HttpExtensionProc - raising the exception from
-        # The "Dispatch" method will just cause the exception to be
-        # rendered to the browser.
-        if self.reload_watcher.change_detected:
-            print("Doing reload")
-            raise InternalReloadException
-
-        if ecb.GetServerVariable("UNICODE_URL").endswith("test.py"):
-            file_flags = (
-                win32con.FILE_FLAG_SEQUENTIAL_SCAN | win32con.FILE_FLAG_OVERLAPPED
-            )
-            hfile = win32file.CreateFile(
-                __file__,
-                win32con.GENERIC_READ,
-                0,
-                None,
-                win32con.OPEN_EXISTING,
-                file_flags,
-                None,
-            )
-            flags = (
-                isapicon.HSE_IO_ASYNC
-                | isapicon.HSE_IO_DISCONNECT_AFTER_SEND
-                | isapicon.HSE_IO_SEND_HEADERS
-            )
-            # We pass hFile to the callback simply as a way of keeping it alive
-            # for the duration of the transmission
-            try:
-                ecb.TransmitFile(
-                    TransmitFileCallback,
-                    hfile,
-                    int(hfile),
-                    "200 OK",
-                    0,
-                    0,
-                    None,
-                    None,
-                    flags,
-                )
-            except:
-                # Errors keep this source file open!
-                hfile.Close()
-                raise
-        else:
-            # default response
-            ecb.SendResponseHeaders("200 OK", "Content-Type: text/html\r\n\r\n", 0)
-            print("<HTML><BODY>", file=ecb)
-            print("The root of this site is at", ecb.MapURLToPath("/"), file=ecb)
-            print("</BODY></HTML>", file=ecb)
-            ecb.close()
-        return isapicon.HSE_STATUS_SUCCESS
-
-    def TerminateExtension(self, status):
-        self.reload_watcher.stop()
-
-
-# The entry points for the ISAPI extension.
-def __ExtensionFactory__():
-    return Extension()
-
-
-# Our special command line customization.
-# Pre-install hook for our virtual directory.
-def PreInstallDirectory(params, options):
-    # If the user used our special '--description' option,
-    # then we override our default.
-    if options.description:
-        params.Description = options.description
-
-
-# Post install hook for our entire script
-def PostInstall(params, options):
-    print()
-    print("The sample has been installed.")
-    print("Point your browser to /PyISAPITest")
-
-
-# Handler for our custom 'status' argument.
-def status_handler(options, log, arg):
-    "Query the status of something"
-    print("Everything seems to be fine!")
-
-
-custom_arg_handlers = {"status": status_handler}
-
-if __name__ == "__main__":
-    # If run from the command-line, install ourselves.
-    from isapi.install import *
-
-    params = ISAPIParameters(PostInstall=PostInstall)
-    # Setup the virtual directories - this is a list of directories our
-    # extension uses - in this case only 1.
-    # Each extension has a "script map" - this is the mapping of ISAPI
-    # extensions.
-    sm = [ScriptMapParams(Extension="*", Flags=0)]
-    vd = VirtualDirParameters(
-        Name="PyISAPITest",
-        Description=Extension.__doc__,
-        ScriptMaps=sm,
-        ScriptMapUpdate="replace",
-        # specify the pre-install hook.
-        PreInstall=PreInstallDirectory,
-    )
-    params.VirtualDirs = [vd]
-    # Setup our custom option parser.
-    from optparse import OptionParser
-
-    parser = OptionParser("")  # blank usage, so isapi sets it.
-    parser.add_option(
-        "",
-        "--description",
-        action="store",
-        help="custom description to use for the virtual directory",
-    )
-
-    HandleCommandLine(
-        params, opt_parser=parser, custom_arg_handlers=custom_arg_handlers
-    )
diff --git a/lib/isapi/simple.py b/lib/isapi/simple.py
deleted file mode 100644
index b453bbae..00000000
--- a/lib/isapi/simple.py
+++ /dev/null
@@ -1,70 +0,0 @@
-"""Simple base-classes for extensions and filters.
-
-None of the filter and extension functions are considered 'optional' by the
-framework.  These base-classes provide simple implementations for the
-Initialize and Terminate functions, allowing you to omit them,
-
-It is not necessary to use these base-classes - but if you don't, you
-must ensure each of the required methods are implemented.
-"""
-
-
-class SimpleExtension:
-    "Base class for a simple ISAPI extension"
-
-    def __init__(self):
-        pass
-
-    def GetExtensionVersion(self, vi):
-        """Called by the ISAPI framework to get the extension version
-
-        The default implementation uses the classes docstring to
-        set the extension description."""
-        # nod to our reload capability - vi is None when we are reloaded.
-        if vi is not None:
-            vi.ExtensionDesc = self.__doc__
-
-    def HttpExtensionProc(self, control_block):
-        """Called by the ISAPI framework for each extension request.
-
-        sub-classes must provide an implementation for this method.
-        """
-        raise NotImplementedError("sub-classes should override HttpExtensionProc")
-
-    def TerminateExtension(self, status):
-        """Called by the ISAPI framework as the extension terminates."""
-        pass
-
-
-class SimpleFilter:
-    "Base class for a a simple ISAPI filter"
-    filter_flags = None
-
-    def __init__(self):
-        pass
-
-    def GetFilterVersion(self, fv):
-        """Called by the ISAPI framework to get the extension version
-
-        The default implementation uses the classes docstring to
-        set the extension description, and uses the classes
-        filter_flags attribute to set the ISAPI filter flags - you
-        must specify filter_flags in your class.
-        """
-        if self.filter_flags is None:
-            raise RuntimeError("You must specify the filter flags")
-        # nod to our reload capability - fv is None when we are reloaded.
-        if fv is not None:
-            fv.Flags = self.filter_flags
-            fv.FilterDesc = self.__doc__
-
-    def HttpFilterProc(self, fc):
-        """Called by the ISAPI framework for each filter request.
-
-        sub-classes must provide an implementation for this method.
-        """
-        raise NotImplementedError("sub-classes should override HttpExtensionProc")
-
-    def TerminateFilter(self, status):
-        """Called by the ISAPI framework as the filter terminates."""
-        pass
diff --git a/lib/isapi/test/README.txt b/lib/isapi/test/README.txt
deleted file mode 100644
index 18643dd7..00000000
--- a/lib/isapi/test/README.txt
+++ /dev/null
@@ -1,3 +0,0 @@
-This is a directory for tests of the PyISAPI framework.
-
-For demos, please see the pyisapi 'samples' directory.
\ No newline at end of file
diff --git a/lib/isapi/test/extension_simple.py b/lib/isapi/test/extension_simple.py
deleted file mode 100644
index 64bd71fd..00000000
--- a/lib/isapi/test/extension_simple.py
+++ /dev/null
@@ -1,119 +0,0 @@
-# This is an ISAPI extension purely for testing purposes.  It is NOT
-# a 'demo' (even though it may be useful!)
-#
-# Install this extension, then point your browser to:
-# "http://localhost/pyisapi_test/test1"
-# This will execute the method 'test1' below.  See below for the list of
-# test methods that are acceptable.
-
-import urllib.error
-import urllib.parse
-import urllib.request
-
-# If we have no console (eg, am running from inside IIS), redirect output
-# somewhere useful - in this case, the standard win32 trace collector.
-import win32api
-import winerror
-
-from isapi import ExtensionError, isapicon, threaded_extension
-from isapi.simple import SimpleFilter
-
-try:
-    win32api.GetConsoleTitle()
-except win32api.error:
-    # No console - redirect
-    import win32traceutil
-
-
-# The ISAPI extension - handles requests in our virtual dir, and sends the
-# response to the client.
-class Extension(threaded_extension.ThreadPoolExtension):
-    "Python ISAPI Tester"
-
-    def Dispatch(self, ecb):
-        print('Tester dispatching "%s"' % (ecb.GetServerVariable("URL"),))
-        url = ecb.GetServerVariable("URL")
-        test_name = url.split("/")[-1]
-        meth = getattr(self, test_name, None)
-        if meth is None:
-            raise AttributeError("No test named '%s'" % (test_name,))
-        result = meth(ecb)
-        if result is None:
-            # This means the test finalized everything
-            return
-        ecb.SendResponseHeaders("200 OK", "Content-type: text/html\r\n\r\n", False)
-        print("<HTML><BODY>Finished running test <i>", test_name, "</i>", file=ecb)
-        print("<pre>", file=ecb)
-        print(result, file=ecb)
-        print("</pre>", file=ecb)
-        print("</BODY></HTML>", file=ecb)
-        ecb.DoneWithSession()
-
-    def test1(self, ecb):
-        try:
-            ecb.GetServerVariable("foo bar")
-            raise RuntimeError("should have failed!")
-        except ExtensionError as err:
-            assert err.errno == winerror.ERROR_INVALID_INDEX, err
-        return "worked!"
-
-    def test_long_vars(self, ecb):
-        qs = ecb.GetServerVariable("QUERY_STRING")
-        # Our implementation has a default buffer size of 8k - so we test
-        # the code that handles an overflow by ensuring there are more
-        # than 8k worth of chars in the URL.
-        expected_query = "x" * 8500
-        if len(qs) == 0:
-            # Just the URL with no query part - redirect to myself, but with
-            # a huge query portion.
-            me = ecb.GetServerVariable("URL")
-            headers = "Location: " + me + "?" + expected_query + "\r\n\r\n"
-            ecb.SendResponseHeaders("301 Moved", headers)
-            ecb.DoneWithSession()
-            return None
-        if qs == expected_query:
-            return "Total length of variable is %d - test worked!" % (len(qs),)
-        else:
-            return "Unexpected query portion!  Got %d chars, expected %d" % (
-                len(qs),
-                len(expected_query),
-            )
-
-    def test_unicode_vars(self, ecb):
-        # We need to check that we are running IIS6!  This seems the only
-        # effective way from an extension.
-        ver = float(ecb.GetServerVariable("SERVER_SOFTWARE").split("/")[1])
-        if ver < 6.0:
-            return "This is IIS version %g - unicode only works in IIS6 and later" % ver
-
-        us = ecb.GetServerVariable("UNICODE_SERVER_NAME")
-        if not isinstance(us, str):
-            raise RuntimeError("unexpected type!")
-        if us != str(ecb.GetServerVariable("SERVER_NAME")):
-            raise RuntimeError("Unicode and non-unicode values were not the same")
-        return "worked!"
-
-
-# The entry points for the ISAPI extension.
-def __ExtensionFactory__():
-    return Extension()
-
-
-if __name__ == "__main__":
-    # If run from the command-line, install ourselves.
-    from isapi.install import *
-
-    params = ISAPIParameters()
-    # Setup the virtual directories - this is a list of directories our
-    # extension uses - in this case only 1.
-    # Each extension has a "script map" - this is the mapping of ISAPI
-    # extensions.
-    sm = [ScriptMapParams(Extension="*", Flags=0)]
-    vd = VirtualDirParameters(
-        Name="pyisapi_test",
-        Description=Extension.__doc__,
-        ScriptMaps=sm,
-        ScriptMapUpdate="replace",
-    )
-    params.VirtualDirs = [vd]
-    HandleCommandLine(params)
diff --git a/lib/isapi/threaded_extension.py b/lib/isapi/threaded_extension.py
deleted file mode 100644
index b31c8c9e..00000000
--- a/lib/isapi/threaded_extension.py
+++ /dev/null
@@ -1,189 +0,0 @@
-"""An ISAPI extension base class implemented using a thread-pool."""
-# $Id$
-
-import sys
-import threading
-import time
-import traceback
-
-from pywintypes import OVERLAPPED
-from win32event import INFINITE
-from win32file import (
-    CloseHandle,
-    CreateIoCompletionPort,
-    GetQueuedCompletionStatus,
-    PostQueuedCompletionStatus,
-)
-from win32security import SetThreadToken
-
-import isapi.simple
-from isapi import ExtensionError, isapicon
-
-ISAPI_REQUEST = 1
-ISAPI_SHUTDOWN = 2
-
-
-class WorkerThread(threading.Thread):
-    def __init__(self, extension, io_req_port):
-        self.running = False
-        self.io_req_port = io_req_port
-        self.extension = extension
-        threading.Thread.__init__(self)
-        # We wait 15 seconds for a thread to terminate, but if it fails to,
-        # we don't want the process to hang at exit waiting for it...
-        self.setDaemon(True)
-
-    def run(self):
-        self.running = True
-        while self.running:
-            errCode, bytes, key, overlapped = GetQueuedCompletionStatus(
-                self.io_req_port, INFINITE
-            )
-            if key == ISAPI_SHUTDOWN and overlapped is None:
-                break
-
-            # Let the parent extension handle the command.
-            dispatcher = self.extension.dispatch_map.get(key)
-            if dispatcher is None:
-                raise RuntimeError("Bad request '%s'" % (key,))
-
-            dispatcher(errCode, bytes, key, overlapped)
-
-    def call_handler(self, cblock):
-        self.extension.Dispatch(cblock)
-
-
-# A generic thread-pool based extension, using IO Completion Ports.
-# Sub-classes can override one method to implement a simple extension, or
-# may leverage the CompletionPort to queue their own requests, and implement a
-# fully asynch extension.
-class ThreadPoolExtension(isapi.simple.SimpleExtension):
-    "Base class for an ISAPI extension based around a thread-pool"
-    max_workers = 20
-    worker_shutdown_wait = 15000  # 15 seconds for workers to quit...
-
-    def __init__(self):
-        self.workers = []
-        # extensible dispatch map, for sub-classes that need to post their
-        # own requests to the completion port.
-        # Each of these functions is called with the result of
-        # GetQueuedCompletionStatus for our port.
-        self.dispatch_map = {
-            ISAPI_REQUEST: self.DispatchConnection,
-        }
-
-    def GetExtensionVersion(self, vi):
-        isapi.simple.SimpleExtension.GetExtensionVersion(self, vi)
-        # As per Q192800, the CompletionPort should be created with the number
-        # of processors, even if the number of worker threads is much larger.
-        # Passing 0 means the system picks the number.
-        self.io_req_port = CreateIoCompletionPort(-1, None, 0, 0)
-        # start up the workers
-        self.workers = []
-        for i in range(self.max_workers):
-            worker = WorkerThread(self, self.io_req_port)
-            worker.start()
-            self.workers.append(worker)
-
-    def HttpExtensionProc(self, control_block):
-        overlapped = OVERLAPPED()
-        overlapped.object = control_block
-        PostQueuedCompletionStatus(self.io_req_port, 0, ISAPI_REQUEST, overlapped)
-        return isapicon.HSE_STATUS_PENDING
-
-    def TerminateExtension(self, status):
-        for worker in self.workers:
-            worker.running = False
-        for worker in self.workers:
-            PostQueuedCompletionStatus(self.io_req_port, 0, ISAPI_SHUTDOWN, None)
-        # wait for them to terminate - pity we aren't using 'native' threads
-        # as then we could do a smart wait - but now we need to poll....
-        end_time = time.time() + self.worker_shutdown_wait / 1000
-        alive = self.workers
-        while alive:
-            if time.time() > end_time:
-                # xxx - might be nice to log something here.
-                break
-            time.sleep(0.2)
-            alive = [w for w in alive if w.is_alive()]
-        self.dispatch_map = {}  # break circles
-        CloseHandle(self.io_req_port)
-
-    # This is the one operation the base class supports - a simple
-    # Connection request.  We setup the thread-token, and dispatch to the
-    # sub-class's 'Dispatch' method.
-    def DispatchConnection(self, errCode, bytes, key, overlapped):
-        control_block = overlapped.object
-        # setup the correct user for this request
-        hRequestToken = control_block.GetImpersonationToken()
-        SetThreadToken(None, hRequestToken)
-        try:
-            try:
-                self.Dispatch(control_block)
-            except:
-                self.HandleDispatchError(control_block)
-        finally:
-            # reset the security context
-            SetThreadToken(None, None)
-
-    def Dispatch(self, ecb):
-        """Overridden by the sub-class to handle connection requests.
-
-        This class creates a thread-pool using a Windows completion port,
-        and dispatches requests via this port.  Sub-classes can generally
-        implement each connection request using blocking reads and writes, and
-        the thread-pool will still provide decent response to the end user.
-
-        The sub-class can set a max_workers attribute (default is 20).  Note
-        that this generally does *not* mean 20 threads will all be concurrently
-        running, via the magic of Windows completion ports.
-
-        There is no default implementation - sub-classes must implement this.
-        """
-        raise NotImplementedError("sub-classes should override Dispatch")
-
-    def HandleDispatchError(self, ecb):
-        """Handles errors in the Dispatch method.
-
-        When a Dispatch method call fails, this method is called to handle
-        the exception.  The default implementation formats the traceback
-        in the browser.
-        """
-        ecb.HttpStatusCode = isapicon.HSE_STATUS_ERROR
-        # control_block.LogData = "we failed!"
-        exc_typ, exc_val, exc_tb = sys.exc_info()
-        limit = None
-        try:
-            try:
-                import cgi
-
-                ecb.SendResponseHeaders(
-                    "200 OK", "Content-type: text/html\r\n\r\n", False
-                )
-                print(file=ecb)
-                print("<H3>Traceback (most recent call last):</H3>", file=ecb)
-                list = traceback.format_tb(
-                    exc_tb, limit
-                ) + traceback.format_exception_only(exc_typ, exc_val)
-                print(
-                    "<PRE>%s<B>%s</B></PRE>"
-                    % (
-                        cgi.escape("".join(list[:-1])),
-                        cgi.escape(list[-1]),
-                    ),
-                    file=ecb,
-                )
-            except ExtensionError:
-                # The client disconnected without reading the error body -
-                # its probably not a real browser at the other end, ignore it.
-                pass
-            except:
-                print("FAILED to render the error message!")
-                traceback.print_exc()
-                print("ORIGINAL extension error:")
-                traceback.print_exception(exc_typ, exc_val, exc_tb)
-        finally:
-            # holding tracebacks in a local of a frame that may itself be
-            # part of a traceback used to be evil and cause leaks!
-            exc_tb = None
-            ecb.DoneWithSession()
diff --git a/lib/inflect/compat/__init__.py b/lib/jaraco/classes/__init__.py
similarity index 100%
rename from lib/inflect/compat/__init__.py
rename to lib/jaraco/classes/__init__.py
diff --git a/lib/jaraco/collections/__init__.py b/lib/jaraco/collections.py
similarity index 88%
rename from lib/jaraco/collections/__init__.py
rename to lib/jaraco/collections.py
index abedf002..db89b122 100644
--- a/lib/jaraco/collections/__init__.py
+++ b/lib/jaraco/collections.py
@@ -5,49 +5,23 @@ import itertools
 import copy
 import functools
 import random
-from collections.abc import Container, Iterable, Mapping
-from typing import Callable, Union
 
+from jaraco.classes.properties import NonDataProperty
 import jaraco.text
 
 
-_Matchable = Union[Callable, Container, Iterable, re.Pattern]
-
-
-def _dispatch(obj: _Matchable) -> Callable:
-    # can't rely on singledispatch for Union[Container, Iterable]
-    # due to ambiguity
-    # (https://peps.python.org/pep-0443/#abstract-base-classes).
-    if isinstance(obj, re.Pattern):
-        return obj.fullmatch
-    if not isinstance(obj, Callable):  # type: ignore
-        if not isinstance(obj, Container):
-            obj = set(obj)  # type: ignore
-        obj = obj.__contains__
-    return obj  # type: ignore
-
-
 class Projection(collections.abc.Mapping):
     """
     Project a set of keys over a mapping
 
     >>> sample = {'a': 1, 'b': 2, 'c': 3}
     >>> prj = Projection(['a', 'c', 'd'], sample)
-    >>> dict(prj)
-    {'a': 1, 'c': 3}
-
-    Projection also accepts an iterable or callable or pattern.
-
-    >>> iter_prj = Projection(iter('acd'), sample)
-    >>> call_prj = Projection(lambda k: ord(k) in (97, 99, 100), sample)
-    >>> pat_prj = Projection(re.compile(r'[acd]'), sample)
-    >>> prj == iter_prj == call_prj == pat_prj
+    >>> prj == {'a': 1, 'c': 3}
     True
 
     Keys should only appear if they were specified and exist in the space.
-    Order is retained.
 
-    >>> list(prj)
+    >>> sorted(list(prj.keys()))
     ['a', 'c']
 
     Attempting to access a key not in the projection
@@ -62,58 +36,119 @@ class Projection(collections.abc.Mapping):
 
     >>> target = {'a': 2, 'b': 2}
     >>> target.update(prj)
-    >>> target
-    {'a': 1, 'b': 2, 'c': 3}
+    >>> target == {'a': 1, 'b': 2, 'c': 3}
+    True
 
-    Projection keeps a reference to the original dict, so
-    modifying the original dict may modify the Projection.
+    Also note that Projection keeps a reference to the original dict, so
+    if you modify the original dict, that could modify the Projection.
 
     >>> del sample['a']
     >>> dict(prj)
     {'c': 3}
     """
 
-    def __init__(self, keys: _Matchable, space: Mapping):
-        self._match = _dispatch(keys)
+    def __init__(self, keys, space):
+        self._keys = tuple(keys)
         self._space = space
 
     def __getitem__(self, key):
-        if not self._match(key):
+        if key not in self._keys:
             raise KeyError(key)
         return self._space[key]
 
-    def _keys_resolved(self):
-        return filter(self._match, self._space)
-
     def __iter__(self):
-        return self._keys_resolved()
+        return iter(set(self._keys).intersection(self._space))
 
     def __len__(self):
-        return len(tuple(self._keys_resolved()))
+        return len(tuple(iter(self)))
 
 
-class Mask(Projection):
+class DictFilter(collections.abc.Mapping):
     """
-    The inverse of a :class:`Projection`, masking out keys.
+    Takes a dict, and simulates a sub-dict based on the keys.
 
     >>> sample = {'a': 1, 'b': 2, 'c': 3}
-    >>> msk = Mask(['a', 'c', 'd'], sample)
-    >>> dict(msk)
+    >>> filtered = DictFilter(sample, ['a', 'c'])
+    >>> filtered == {'a': 1, 'c': 3}
+    True
+    >>> set(filtered.values()) == {1, 3}
+    True
+    >>> set(filtered.items()) == {('a', 1), ('c', 3)}
+    True
+
+    One can also filter by a regular expression pattern
+
+    >>> sample['d'] = 4
+    >>> sample['ef'] = 5
+
+    Here we filter for only single-character keys
+
+    >>> filtered = DictFilter(sample, include_pattern='.$')
+    >>> filtered == {'a': 1, 'b': 2, 'c': 3, 'd': 4}
+    True
+
+    >>> filtered['e']
+    Traceback (most recent call last):
+    ...
+    KeyError: 'e'
+
+    >>> 'e' in filtered
+    False
+
+    Pattern is useful for excluding keys with a prefix.
+
+    >>> filtered = DictFilter(sample, include_pattern=r'(?![ace])')
+    >>> dict(filtered)
+    {'b': 2, 'd': 4}
+
+    Also note that DictFilter keeps a reference to the original dict, so
+    if you modify the original dict, that could modify the filtered dict.
+
+    >>> del sample['d']
+    >>> dict(filtered)
     {'b': 2}
     """
 
-    def __init__(self, *args, **kwargs):
-        super().__init__(*args, **kwargs)
-        # self._match = compose(operator.not_, self._match)
-        self._match = lambda key, orig=self._match: not orig(key)
+    def __init__(self, dict, include_keys=[], include_pattern=None):
+        self.dict = dict
+        self.specified_keys = set(include_keys)
+        if include_pattern is not None:
+            self.include_pattern = re.compile(include_pattern)
+        else:
+            # for performance, replace the pattern_keys property
+            self.pattern_keys = set()
+
+    def get_pattern_keys(self):
+        keys = filter(self.include_pattern.match, self.dict.keys())
+        return set(keys)
+
+    pattern_keys = NonDataProperty(get_pattern_keys)
+
+    @property
+    def include_keys(self):
+        return self.specified_keys | self.pattern_keys
+
+    def __getitem__(self, i):
+        if i not in self.include_keys:
+            raise KeyError(i)
+        return self.dict[i]
+
+    def __iter__(self):
+        return filter(self.include_keys.__contains__, self.dict.keys())
+
+    def __len__(self):
+        return len(list(self))
 
 
 def dict_map(function, dictionary):
     """
-    Return a new dict with function applied to values of dictionary.
+    dict_map is much like the built-in function map.  It takes a dictionary
+    and applys a function to the values of that dictionary, returning a
+    new dictionary with the mapped values in the original keys.
 
-    >>> dict_map(lambda x: x+1, dict(a=1, b=2))
-    {'a': 2, 'b': 3}
+    >>> d = dict_map(lambda x:x+1, dict(a=1, b=2))
+    >>> d == dict(a=2,b=3)
+    True
     """
     return dict((key, function(value)) for key, value in dictionary.items())
 
@@ -129,7 +164,7 @@ class RangeMap(dict):
     One may supply keyword parameters to be passed to the sort function used
     to sort keys (i.e. key, reverse) as sort_params.
 
-    Create a map that maps 1-3 -> 'a', 4-6 -> 'b'
+    Let's create a map that maps 1-3 -> 'a', 4-6 -> 'b'
 
     >>> r = RangeMap({3: 'a', 6: 'b'})  # boy, that was easy
     >>> r[1], r[2], r[3], r[4], r[5], r[6]
@@ -141,7 +176,7 @@ class RangeMap(dict):
     >>> r[4.5]
     'b'
 
-    Notice that the way rangemap is defined, it must be open-ended
+    But you'll notice that the way rangemap is defined, it must be open-ended
     on one side.
 
     >>> r[0]
@@ -244,7 +279,7 @@ class RangeMap(dict):
         return (sorted_keys[RangeMap.first_item], sorted_keys[RangeMap.last_item])
 
     # some special values for the RangeMap
-    undefined_value = type('RangeValueUndefined', (), {})()
+    undefined_value = type(str('RangeValueUndefined'), (), {})()
 
     class Item(int):
         "RangeMap Item"
@@ -259,7 +294,7 @@ def __identity(x):
 
 def sorted_items(d, key=__identity, reverse=False):
     """
-    Return the items of the dictionary sorted by the keys.
+    Return the items of the dictionary sorted by the keys
 
     >>> sample = dict(foo=20, bar=42, baz=10)
     >>> tuple(sorted_items(sample))
@@ -272,7 +307,6 @@ def sorted_items(d, key=__identity, reverse=False):
     >>> tuple(sorted_items(sample, reverse=True))
     (('foo', 20), ('baz', 10), ('bar', 42))
     """
-
     # wrap the key func so it operates on the first element of each item
     def pairkey_key(item):
         return key(item[0])
@@ -441,7 +475,7 @@ class ItemsAsAttributes:
     Mix-in class to enable a mapping object to provide items as
     attributes.
 
-    >>> C = type('C', (dict, ItemsAsAttributes), dict())
+    >>> C = type(str('C'), (dict, ItemsAsAttributes), dict())
     >>> i = C()
     >>> i['foo'] = 'bar'
     >>> i.foo
@@ -470,7 +504,7 @@ class ItemsAsAttributes:
 
     >>> missing_func = lambda self, key: 'missing item'
     >>> C = type(
-    ...     'C',
+    ...     str('C'),
     ...     (dict, ItemsAsAttributes),
     ...     dict(__missing__ = missing_func),
     ... )
diff --git a/lib/jaraco/collections/py.typed b/lib/jaraco/collections/py.typed
deleted file mode 100644
index e69de29b..00000000
diff --git a/lib/jaraco/context.py b/lib/jaraco/context.py
index b0d1ef37..87a4e3dc 100644
--- a/lib/jaraco/context.py
+++ b/lib/jaraco/context.py
@@ -5,18 +5,10 @@ import functools
 import tempfile
 import shutil
 import operator
-import warnings
 
 
 @contextlib.contextmanager
 def pushd(dir):
-    """
-    >>> tmp_path = getfixture('tmp_path')
-    >>> with pushd(tmp_path):
-    ...     assert os.getcwd() == os.fspath(tmp_path)
-    >>> assert os.getcwd() != os.fspath(tmp_path)
-    """
-
     orig = os.getcwd()
     os.chdir(dir)
     try:
@@ -37,8 +29,6 @@ def tarball_context(url, target_dir=None, runner=None, pushd=pushd):
         target_dir = os.path.basename(url).replace('.tar.gz', '').replace('.tgz', '')
     if runner is None:
         runner = functools.partial(subprocess.check_call, shell=True)
-    else:
-        warnings.warn("runner parameter is deprecated", DeprecationWarning)
     # In the tar command, use --strip-components=1 to strip the first path and
     #  then
     #  use -C to cause the files to be extracted to {target_dir}. This ensures
@@ -58,15 +48,6 @@ def tarball_context(url, target_dir=None, runner=None, pushd=pushd):
 def infer_compression(url):
     """
     Given a URL or filename, infer the compression code for tar.
-
-    >>> infer_compression('http://foo/bar.tar.gz')
-    'z'
-    >>> infer_compression('http://foo/bar.tgz')
-    'z'
-    >>> infer_compression('file.bz')
-    'j'
-    >>> infer_compression('file.xz')
-    'J'
     """
     # cheat and just assume it's the last two characters
     compression_indicator = url[-2:]
@@ -80,12 +61,6 @@ def temp_dir(remover=shutil.rmtree):
     """
     Create a temporary directory context. Pass a custom remover
     to override the removal behavior.
-
-    >>> import pathlib
-    >>> with temp_dir() as the_dir:
-    ...     assert os.path.isdir(the_dir)
-    ...     _ = pathlib.Path(the_dir).joinpath('somefile').write_text('contents')
-    >>> assert not os.path.exists(the_dir)
     """
     temp_dir = tempfile.mkdtemp()
     try:
@@ -115,12 +90,6 @@ def repo_context(url, branch=None, quiet=True, dest_ctx=temp_dir):
 
 @contextlib.contextmanager
 def null():
-    """
-    A null context suitable to stand in for a meaningful context.
-
-    >>> with null() as value:
-    ...     assert value is None
-    """
     yield
 
 
@@ -143,10 +112,6 @@ class ExceptionTrap:
     ...     raise ValueError("1 + 1 is not 3")
     >>> bool(trap)
     True
-    >>> trap.value
-    ValueError('1 + 1 is not 3')
-    >>> trap.tb
-    <traceback object at ...>
 
     >>> with ExceptionTrap(ValueError) as trap:
     ...     raise Exception()
@@ -246,43 +211,3 @@ class suppress(contextlib.suppress, contextlib.ContextDecorator):
     ...     {}['']
     >>> key_error()
     """
-
-
-class on_interrupt(contextlib.ContextDecorator):
-    """
-    Replace a KeyboardInterrupt with SystemExit(1)
-
-    >>> def do_interrupt():
-    ...     raise KeyboardInterrupt()
-    >>> on_interrupt('error')(do_interrupt)()
-    Traceback (most recent call last):
-    ...
-    SystemExit: 1
-    >>> on_interrupt('error', code=255)(do_interrupt)()
-    Traceback (most recent call last):
-    ...
-    SystemExit: 255
-    >>> on_interrupt('suppress')(do_interrupt)()
-    >>> with __import__('pytest').raises(KeyboardInterrupt):
-    ...     on_interrupt('ignore')(do_interrupt)()
-    """
-
-    def __init__(
-        self,
-        action='error',
-        # py3.7 compat
-        # /,
-        code=1,
-    ):
-        self.action = action
-        self.code = code
-
-    def __enter__(self):
-        return self
-
-    def __exit__(self, exctype, excinst, exctb):
-        if exctype is not KeyboardInterrupt or self.action == 'ignore':
-            return
-        elif self.action == 'error':
-            raise SystemExit(self.code) from excinst
-        return self.action == 'suppress'
diff --git a/lib/jaraco/functools/__init__.py b/lib/jaraco/functools.py
similarity index 84%
rename from lib/jaraco/functools/__init__.py
rename to lib/jaraco/functools.py
index ca6c22fa..43c009f9 100644
--- a/lib/jaraco/functools/__init__.py
+++ b/lib/jaraco/functools.py
@@ -1,4 +1,4 @@
-import collections.abc
+import collections
 import functools
 import inspect
 import itertools
@@ -9,6 +9,11 @@ import warnings
 
 import more_itertools
 
+from typing import Callable, TypeVar
+
+
+CallableT = TypeVar("CallableT", bound=Callable[..., object])
+
 
 def compose(*funcs):
     """
@@ -34,6 +39,24 @@ def compose(*funcs):
     return functools.reduce(compose_two, funcs)
 
 
+def method_caller(method_name, *args, **kwargs):
+    """
+    Return a function that will call a named method on the
+    target object with optional positional and keyword
+    arguments.
+
+    >>> lower = method_caller('lower')
+    >>> lower('MyString')
+    'mystring'
+    """
+
+    def call_method(target):
+        func = getattr(target, method_name)
+        return func(*args, **kwargs)
+
+    return call_method
+
+
 def once(func):
     """
     Decorate func so it's only ever called the first time.
@@ -76,7 +99,12 @@ def once(func):
     return wrapper
 
 
-def method_cache(method, cache_wrapper=functools.lru_cache()):
+def method_cache(
+    method: CallableT,
+    cache_wrapper: Callable[
+        [CallableT], CallableT
+    ] = functools.lru_cache(),  # type: ignore[assignment]
+) -> CallableT:
     """
     Wrap lru_cache to support storing the cache data in the object instances.
 
@@ -144,17 +172,22 @@ def method_cache(method, cache_wrapper=functools.lru_cache()):
     for another implementation and additional justification.
     """
 
-    def wrapper(self, *args, **kwargs):
+    def wrapper(self: object, *args: object, **kwargs: object) -> object:
         # it's the first call, replace the method with a cached, bound method
-        bound_method = types.MethodType(method, self)
+        bound_method: CallableT = types.MethodType(  # type: ignore[assignment]
+            method, self
+        )
         cached_method = cache_wrapper(bound_method)
         setattr(self, method.__name__, cached_method)
         return cached_method(*args, **kwargs)
 
     # Support cache clear even before cache has been created.
-    wrapper.cache_clear = lambda: None
+    wrapper.cache_clear = lambda: None  # type: ignore[attr-defined]
 
-    return _special_method_cache(method, cache_wrapper) or wrapper
+    return (
+        _special_method_cache(method, cache_wrapper)  # type: ignore[return-value]
+        or wrapper
+    )
 
 
 def _special_method_cache(method, cache_wrapper):
@@ -170,13 +203,12 @@ def _special_method_cache(method, cache_wrapper):
     """
     name = method.__name__
     special_names = '__getattr__', '__getitem__'
-
     if name not in special_names:
-        return None
+        return
 
     wrapper_name = '__cached' + name
 
-    def proxy(self, /, *args, **kwargs):
+    def proxy(self, *args, **kwargs):
         if wrapper_name not in vars(self):
             bound = types.MethodType(method, self)
             cache = cache_wrapper(bound)
@@ -213,7 +245,7 @@ def result_invoke(action):
     r"""
     Decorate a function with an action function that is
     invoked on the results returned from the decorated
-    function (for its side effect), then return the original
+    function (for its side-effect), then return the original
     result.
 
     >>> @result_invoke(print)
@@ -237,7 +269,7 @@ def result_invoke(action):
     return wrap
 
 
-def invoke(f, /, *args, **kwargs):
+def invoke(f, *args, **kwargs):
     """
     Call a function for its side effect after initialization.
 
@@ -272,15 +304,25 @@ def invoke(f, /, *args, **kwargs):
     Use functools.partial to pass parameters to the initial call
 
     >>> @functools.partial(invoke, name='bingo')
-    ... def func(name): print('called with', name)
+    ... def func(name): print("called with", name)
     called with bingo
     """
     f(*args, **kwargs)
     return f
 
 
+def call_aside(*args, **kwargs):
+    """
+    Deprecated name for invoke.
+    """
+    warnings.warn("call_aside is deprecated, use invoke", DeprecationWarning)
+    return invoke(*args, **kwargs)
+
+
 class Throttler:
-    """Rate-limit a function (or other callable)."""
+    """
+    Rate-limit a function (or other callable)
+    """
 
     def __init__(self, func, max_rate=float('Inf')):
         if isinstance(func, Throttler):
@@ -297,20 +339,20 @@ class Throttler:
         return self.func(*args, **kwargs)
 
     def _wait(self):
-        """Ensure at least 1/max_rate seconds from last call."""
+        "ensure at least 1/max_rate seconds from last call"
         elapsed = time.time() - self.last_called
         must_wait = 1 / self.max_rate - elapsed
         time.sleep(max(0, must_wait))
         self.last_called = time.time()
 
-    def __get__(self, obj, owner=None):
+    def __get__(self, obj, type=None):
         return first_invoke(self._wait, functools.partial(self.func, obj))
 
 
 def first_invoke(func1, func2):
     """
     Return a function that when invoked will invoke func1 without
-    any parameters (for its side effect) and then invoke func2
+    any parameters (for its side-effect) and then invoke func2
     with whatever parameters were passed, returning its result.
     """
 
@@ -321,17 +363,6 @@ def first_invoke(func1, func2):
     return wrapper
 
 
-method_caller = first_invoke(
-    lambda: warnings.warn(
-        '`jaraco.functools.method_caller` is deprecated, '
-        'use `operator.methodcaller` instead',
-        DeprecationWarning,
-        stacklevel=3,
-    ),
-    operator.methodcaller,
-)
-
-
 def retry_call(func, cleanup=lambda: None, retries=0, trap=()):
     """
     Given a callable func, trap the indicated exceptions
@@ -340,7 +371,7 @@ def retry_call(func, cleanup=lambda: None, retries=0, trap=()):
     to propagate.
     """
     attempts = itertools.count() if retries == float('inf') else range(retries)
-    for _ in attempts:
+    for attempt in attempts:
         try:
             return func()
         except trap:
@@ -377,7 +408,7 @@ def retry(*r_args, **r_kwargs):
 
 def print_yielded(func):
     """
-    Convert a generator into a function that prints all yielded elements.
+    Convert a generator into a function that prints all yielded elements
 
     >>> @print_yielded
     ... def x():
@@ -393,7 +424,7 @@ def print_yielded(func):
 
 def pass_none(func):
     """
-    Wrap func so it's not called if its first param is None.
+    Wrap func so it's not called if its first param is None
 
     >>> print_text = pass_none(print)
     >>> print_text('text')
@@ -402,10 +433,9 @@ def pass_none(func):
     """
 
     @functools.wraps(func)
-    def wrapper(param, /, *args, **kwargs):
+    def wrapper(param, *args, **kwargs):
         if param is not None:
             return func(param, *args, **kwargs)
-        return None
 
     return wrapper
 
@@ -479,7 +509,7 @@ def save_method_args(method):
     args_and_kwargs = collections.namedtuple('args_and_kwargs', 'args kwargs')
 
     @functools.wraps(method)
-    def wrapper(self, /, *args, **kwargs):
+    def wrapper(self, *args, **kwargs):
         attr_name = '_saved_' + method.__name__
         attr = args_and_kwargs(args, kwargs)
         setattr(self, attr_name, attr)
@@ -529,13 +559,6 @@ def except_(*exceptions, replace=None, use=None):
 
 
 def identity(x):
-    """
-    Return the argument.
-
-    >>> o = object()
-    >>> identity(o) is o
-    True
-    """
     return x
 
 
@@ -557,7 +580,7 @@ def bypass_when(check, *, _op=identity):
 
     def decorate(func):
         @functools.wraps(func)
-        def wrapper(param, /):
+        def wrapper(param):
             return param if _op(check) else func(param)
 
         return wrapper
@@ -581,53 +604,3 @@ def bypass_unless(check):
     2
     """
     return bypass_when(check, _op=operator.not_)
-
-
-@functools.singledispatch
-def _splat_inner(args, func):
-    """Splat args to func."""
-    return func(*args)
-
-
-@_splat_inner.register
-def _(args: collections.abc.Mapping, func):
-    """Splat kargs to func as kwargs."""
-    return func(**args)
-
-
-def splat(func):
-    """
-    Wrap func to expect its parameters to be passed positionally in a tuple.
-
-    Has a similar effect to that of ``itertools.starmap`` over
-    simple ``map``.
-
-    >>> pairs = [(-1, 1), (0, 2)]
-    >>> more_itertools.consume(itertools.starmap(print, pairs))
-    -1 1
-    0 2
-    >>> more_itertools.consume(map(splat(print), pairs))
-    -1 1
-    0 2
-
-    The approach generalizes to other iterators that don't have a "star"
-    equivalent, such as a "starfilter".
-
-    >>> list(filter(splat(operator.add), pairs))
-    [(0, 2)]
-
-    Splat also accepts a mapping argument.
-
-    >>> def is_nice(msg, code):
-    ...     return "smile" in msg or code == 0
-    >>> msgs = [
-    ...     dict(msg='smile!', code=20),
-    ...     dict(msg='error :(', code=1),
-    ...     dict(msg='unknown', code=0),
-    ... ]
-    >>> for msg in filter(splat(is_nice), msgs):
-    ...     print(msg)
-    {'msg': 'smile!', 'code': 20}
-    {'msg': 'unknown', 'code': 0}
-    """
-    return functools.wraps(func)(functools.partial(_splat_inner, func=func))
diff --git a/lib/jaraco/functools/__init__.pyi b/lib/jaraco/functools/__init__.pyi
deleted file mode 100644
index c2b9ab17..00000000
--- a/lib/jaraco/functools/__init__.pyi
+++ /dev/null
@@ -1,128 +0,0 @@
-from collections.abc import Callable, Hashable, Iterator
-from functools import partial
-from operator import methodcaller
-import sys
-from typing import (
-    Any,
-    Generic,
-    Protocol,
-    TypeVar,
-    overload,
-)
-
-if sys.version_info >= (3, 10):
-    from typing import Concatenate, ParamSpec
-else:
-    from typing_extensions import Concatenate, ParamSpec
-
-_P = ParamSpec('_P')
-_R = TypeVar('_R')
-_T = TypeVar('_T')
-_R1 = TypeVar('_R1')
-_R2 = TypeVar('_R2')
-_V = TypeVar('_V')
-_S = TypeVar('_S')
-_R_co = TypeVar('_R_co', covariant=True)
-
-class _OnceCallable(Protocol[_P, _R]):
-    saved_result: _R
-    reset: Callable[[], None]
-    def __call__(self, *args: _P.args, **kwargs: _P.kwargs) -> _R: ...
-
-class _ProxyMethodCacheWrapper(Protocol[_R_co]):
-    cache_clear: Callable[[], None]
-    def __call__(self, *args: Hashable, **kwargs: Hashable) -> _R_co: ...
-
-class _MethodCacheWrapper(Protocol[_R_co]):
-    def cache_clear(self) -> None: ...
-    def __call__(self, *args: Hashable, **kwargs: Hashable) -> _R_co: ...
-
-# `compose()` overloads below will cover most use cases.
-
-@overload
-def compose(
-    __func1: Callable[[_R], _T],
-    __func2: Callable[_P, _R],
-    /,
-) -> Callable[_P, _T]: ...
-@overload
-def compose(
-    __func1: Callable[[_R], _T],
-    __func2: Callable[[_R1], _R],
-    __func3: Callable[_P, _R1],
-    /,
-) -> Callable[_P, _T]: ...
-@overload
-def compose(
-    __func1: Callable[[_R], _T],
-    __func2: Callable[[_R2], _R],
-    __func3: Callable[[_R1], _R2],
-    __func4: Callable[_P, _R1],
-    /,
-) -> Callable[_P, _T]: ...
-def once(func: Callable[_P, _R]) -> _OnceCallable[_P, _R]: ...
-def method_cache(
-    method: Callable[..., _R],
-    cache_wrapper: Callable[[Callable[..., _R]], _MethodCacheWrapper[_R]] = ...,
-) -> _MethodCacheWrapper[_R] | _ProxyMethodCacheWrapper[_R]: ...
-def apply(
-    transform: Callable[[_R], _T]
-) -> Callable[[Callable[_P, _R]], Callable[_P, _T]]: ...
-def result_invoke(
-    action: Callable[[_R], Any]
-) -> Callable[[Callable[_P, _R]], Callable[_P, _R]]: ...
-def invoke(
-    f: Callable[_P, _R], /, *args: _P.args, **kwargs: _P.kwargs
-) -> Callable[_P, _R]: ...
-def call_aside(
-    f: Callable[_P, _R], *args: _P.args, **kwargs: _P.kwargs
-) -> Callable[_P, _R]: ...
-
-class Throttler(Generic[_R]):
-    last_called: float
-    func: Callable[..., _R]
-    max_rate: float
-    def __init__(
-        self, func: Callable[..., _R] | Throttler[_R], max_rate: float = ...
-    ) -> None: ...
-    def reset(self) -> None: ...
-    def __call__(self, *args: Any, **kwargs: Any) -> _R: ...
-    def __get__(self, obj: Any, owner: type[Any] | None = ...) -> Callable[..., _R]: ...
-
-def first_invoke(
-    func1: Callable[..., Any], func2: Callable[_P, _R]
-) -> Callable[_P, _R]: ...
-
-method_caller: Callable[..., methodcaller]
-
-def retry_call(
-    func: Callable[..., _R],
-    cleanup: Callable[..., None] = ...,
-    retries: int | float = ...,
-    trap: type[BaseException] | tuple[type[BaseException], ...] = ...,
-) -> _R: ...
-def retry(
-    cleanup: Callable[..., None] = ...,
-    retries: int | float = ...,
-    trap: type[BaseException] | tuple[type[BaseException], ...] = ...,
-) -> Callable[[Callable[..., _R]], Callable[..., _R]]: ...
-def print_yielded(func: Callable[_P, Iterator[Any]]) -> Callable[_P, None]: ...
-def pass_none(
-    func: Callable[Concatenate[_T, _P], _R]
-) -> Callable[Concatenate[_T, _P], _R]: ...
-def assign_params(
-    func: Callable[..., _R], namespace: dict[str, Any]
-) -> partial[_R]: ...
-def save_method_args(
-    method: Callable[Concatenate[_S, _P], _R]
-) -> Callable[Concatenate[_S, _P], _R]: ...
-def except_(
-    *exceptions: type[BaseException], replace: Any = ..., use: Any = ...
-) -> Callable[[Callable[_P, Any]], Callable[_P, Any]]: ...
-def identity(x: _T) -> _T: ...
-def bypass_when(
-    check: _V, *, _op: Callable[[_V], Any] = ...
-) -> Callable[[Callable[[_T], _R]], Callable[[_T], _T | _R]]: ...
-def bypass_unless(
-    check: Any,
-) -> Callable[[Callable[[_T], _R]], Callable[[_T], _T | _R]]: ...
diff --git a/lib/jaraco/functools/py.typed b/lib/jaraco/functools/py.typed
deleted file mode 100644
index e69de29b..00000000
diff --git a/lib/jaraco/text/__init__.py b/lib/jaraco/text/__init__.py
index 0fabd0c3..e51101c2 100644
--- a/lib/jaraco/text/__init__.py
+++ b/lib/jaraco/text/__init__.py
@@ -227,12 +227,10 @@ def unwrap(s):
     return '\n'.join(cleaned)
 
 
-lorem_ipsum: str = (
-    files(__name__).joinpath('Lorem ipsum.txt').read_text(encoding='utf-8')
-)
+lorem_ipsum: str = files(__name__).joinpath('Lorem ipsum.txt').read_text()
 
 
-class Splitter:
+class Splitter(object):
     """object that will split a string with the given arguments for each call
 
     >>> s = Splitter(',')
@@ -369,7 +367,7 @@ class WordSet(tuple):
         return self.trim_left(item).trim_right(item)
 
     def __getitem__(self, item):
-        result = super().__getitem__(item)
+        result = super(WordSet, self).__getitem__(item)
         if isinstance(item, slice):
             result = WordSet(result)
         return result
@@ -584,7 +582,7 @@ def join_continuation(lines):
     ['foobarbaz']
 
     Not sure why, but...
-    The character preceding the backslash is also elided.
+    The character preceeding the backslash is also elided.
 
     >>> list(join_continuation(['goo\\', 'dly']))
     ['godly']
@@ -609,16 +607,16 @@ def read_newlines(filename, limit=1024):
     r"""
     >>> tmp_path = getfixture('tmp_path')
     >>> filename = tmp_path / 'out.txt'
-    >>> _ = filename.write_text('foo\n', newline='', encoding='utf-8')
+    >>> _ = filename.write_text('foo\n', newline='')
     >>> read_newlines(filename)
     '\n'
-    >>> _ = filename.write_text('foo\r\n', newline='', encoding='utf-8')
+    >>> _ = filename.write_text('foo\r\n', newline='')
     >>> read_newlines(filename)
     '\r\n'
-    >>> _ = filename.write_text('foo\r\nbar\nbing\r', newline='', encoding='utf-8')
+    >>> _ = filename.write_text('foo\r\nbar\nbing\r', newline='')
     >>> read_newlines(filename)
     ('\r', '\n', '\r\n')
     """
-    with open(filename, encoding='utf-8') as fp:
+    with open(filename) as fp:
         fp.read(limit)
     return fp.newlines
diff --git a/lib/jaraco/text/show-newlines.py b/lib/jaraco/text/show-newlines.py
index e11d1ba4..2ba32062 100644
--- a/lib/jaraco/text/show-newlines.py
+++ b/lib/jaraco/text/show-newlines.py
@@ -12,11 +12,11 @@ def report_newlines(filename):
 
     >>> tmp_path = getfixture('tmp_path')
     >>> filename = tmp_path / 'out.txt'
-    >>> _ = filename.write_text('foo\nbar\n', newline='', encoding='utf-8')
+    >>> _ = filename.write_text('foo\nbar\n', newline='')
     >>> report_newlines(filename)
     newline is '\n'
     >>> filename = tmp_path / 'out.txt'
-    >>> _ = filename.write_text('foo\nbar\r\n', newline='', encoding='utf-8')
+    >>> _ = filename.write_text('foo\nbar\r\n', newline='')
     >>> report_newlines(filename)
     newlines are ('\n', '\r\n')
     """
diff --git a/lib/jaraco/text/strip-prefix.py b/lib/jaraco/text/strip-prefix.py
deleted file mode 100644
index 761717a9..00000000
--- a/lib/jaraco/text/strip-prefix.py
+++ /dev/null
@@ -1,21 +0,0 @@
-import sys
-
-import autocommand
-
-from jaraco.text import Stripper
-
-
-def strip_prefix():
-    r"""
-    Strip any common prefix from stdin.
-
-    >>> import io, pytest
-    >>> getfixture('monkeypatch').setattr('sys.stdin', io.StringIO('abcdef\nabc123'))
-    >>> strip_prefix()
-    def
-    123
-    """
-    sys.stdout.writelines(Stripper.strip_prefix(sys.stdin).lines)
-
-
-autocommand.autocommand(__name__)(strip_prefix)
diff --git a/lib/more_itertools/__init__.py b/lib/more_itertools/__init__.py
index aff94a9a..28ffadcf 100644
--- a/lib/more_itertools/__init__.py
+++ b/lib/more_itertools/__init__.py
@@ -3,4 +3,4 @@
 from .more import *  # noqa
 from .recipes import *  # noqa
 
-__version__ = '10.2.0'
+__version__ = '10.1.0'
diff --git a/lib/more_itertools/more.py b/lib/more_itertools/more.py
index dd711a47..59c2f1a4 100755
--- a/lib/more_itertools/more.py
+++ b/lib/more_itertools/more.py
@@ -19,7 +19,7 @@ from itertools import (
     zip_longest,
     product,
 )
-from math import exp, factorial, floor, log, perm, comb
+from math import exp, factorial, floor, log
 from queue import Empty, Queue
 from random import random, randrange, uniform
 from operator import itemgetter, mul, sub, gt, lt, ge, le
@@ -68,10 +68,8 @@ __all__ = [
     'divide',
     'duplicates_everseen',
     'duplicates_justseen',
-    'classify_unique',
     'exactly_n',
     'filter_except',
-    'filter_map',
     'first',
     'gray_product',
     'groupby_transform',
@@ -85,7 +83,6 @@ __all__ = [
     'is_sorted',
     'islice_extended',
     'iterate',
-    'iter_suppress',
     'last',
     'locate',
     'longest_common_prefix',
@@ -201,14 +198,15 @@ def first(iterable, default=_marker):
     ``next(iter(iterable), default)``.
 
     """
-    for item in iterable:
-        return item
-    if default is _marker:
-        raise ValueError(
-            'first() was called on an empty iterable, and no '
-            'default value was provided.'
-        )
-    return default
+    try:
+        return next(iter(iterable))
+    except StopIteration as e:
+        if default is _marker:
+            raise ValueError(
+                'first() was called on an empty iterable, and no '
+                'default value was provided.'
+            ) from e
+        return default
 
 
 def last(iterable, default=_marker):
@@ -584,9 +582,6 @@ def strictly_n(iterable, n, too_short=None, too_long=None):
         >>> list(strictly_n(iterable, n))
         ['a', 'b', 'c', 'd']
 
-    Note that the returned iterable must be consumed in order for the check to
-    be made.
-
     By default, *too_short* and *too_long* are functions that raise
     ``ValueError``.
 
@@ -924,7 +919,7 @@ def substrings_indexes(seq, reverse=False):
 
 
 class bucket:
-    """Wrap *iterable* and return an object that buckets the iterable into
+    """Wrap *iterable* and return an object that buckets it iterable into
     child iterables based on a *key* function.
 
         >>> iterable = ['a1', 'b1', 'c1', 'a2', 'b2', 'c2', 'b3']
@@ -3227,8 +3222,6 @@ class time_limited:
     stops if  the time elapsed is greater than *limit_seconds*. If your time
     limit is 1 second, but it takes 2 seconds to generate the first item from
     the iterable, the function will run for 2 seconds and not yield anything.
-    As a special case, when *limit_seconds* is zero, the iterator never
-    returns anything.
 
     """
 
@@ -3244,9 +3237,6 @@ class time_limited:
         return self
 
     def __next__(self):
-        if self.limit_seconds == 0:
-            self.timed_out = True
-            raise StopIteration
         item = next(self._iterable)
         if monotonic() - self._start_time > self.limit_seconds:
             self.timed_out = True
@@ -3366,7 +3356,7 @@ def iequals(*iterables):
     >>> iequals("abc", "acb")
     False
 
-    Not to be confused with :func:`all_equal`, which checks whether all
+    Not to be confused with :func:`all_equals`, which checks whether all
     elements of iterable are equal to each other.
 
     """
@@ -3863,7 +3853,7 @@ def nth_permutation(iterable, r, index):
     elif not 0 <= r < n:
         raise ValueError
     else:
-        c = perm(n, r)
+        c = factorial(n) // factorial(n - r)
 
     if index < 0:
         index += c
@@ -3908,7 +3898,7 @@ def nth_combination_with_replacement(iterable, r, index):
     if (r < 0) or (r > n):
         raise ValueError
 
-    c = comb(n + r - 1, r)
+    c = factorial(n + r - 1) // (factorial(r) * factorial(n - 1))
 
     if index < 0:
         index += c
@@ -3921,7 +3911,9 @@ def nth_combination_with_replacement(iterable, r, index):
     while r:
         r -= 1
         while n >= 0:
-            num_combs = comb(n + r - 1, r)
+            num_combs = factorial(n + r - 1) // (
+                factorial(r) * factorial(n - 1)
+            )
             if index < num_combs:
                 break
             n -= 1
@@ -4023,9 +4015,9 @@ def combination_index(element, iterable):
     for i, j in enumerate(reversed(indexes), start=1):
         j = n - j
         if i <= j:
-            index += comb(j, i)
+            index += factorial(j) // (factorial(i) * factorial(j - i))
 
-    return comb(n + 1, k + 1) - index
+    return factorial(n + 1) // (factorial(k + 1) * factorial(n - k)) - index
 
 
 def combination_with_replacement_index(element, iterable):
@@ -4065,7 +4057,7 @@ def combination_with_replacement_index(element, iterable):
             break
     else:
         raise ValueError(
-            'element is not a combination with replacement of iterable'
+            'element is not a combination with replacment of iterable'
         )
 
     n = len(pool)
@@ -4074,13 +4066,11 @@ def combination_with_replacement_index(element, iterable):
         occupations[p] += 1
 
     index = 0
-    cumulative_sum = 0
     for k in range(1, n):
-        cumulative_sum += occupations[k - 1]
-        j = l + n - 1 - k - cumulative_sum
+        j = l + n - 1 - k - sum(occupations[:k])
         i = n - k
         if i <= j:
-            index += comb(j, i)
+            index += factorial(j) // (factorial(i) * factorial(j - i))
 
     return index
 
@@ -4306,7 +4296,7 @@ def duplicates_everseen(iterable, key=None):
     >>> list(duplicates_everseen('AaaBbbCccAaa', str.lower))
     ['a', 'a', 'b', 'b', 'c', 'c', 'A', 'a', 'a']
 
-    This function is analogous to :func:`unique_everseen` and is subject to
+    This function is analagous to :func:`unique_everseen` and is subject to
     the same performance considerations.
 
     """
@@ -4336,54 +4326,12 @@ def duplicates_justseen(iterable, key=None):
     >>> list(duplicates_justseen('AaaBbbCccAaa', str.lower))
     ['a', 'a', 'b', 'b', 'c', 'c', 'a', 'a']
 
-    This function is analogous to :func:`unique_justseen`.
+    This function is analagous to :func:`unique_justseen`.
 
     """
     return flatten(g for _, g in groupby(iterable, key) for _ in g)
 
 
-def classify_unique(iterable, key=None):
-    """Classify each element in terms of its uniqueness.
-
-    For each element in the input iterable, return a 3-tuple consisting of:
-
-    1. The element itself
-    2. ``False`` if the element is equal to the one preceding it in the input,
-       ``True`` otherwise (i.e. the equivalent of :func:`unique_justseen`)
-    3. ``False`` if this element has been seen anywhere in the input before,
-       ``True`` otherwise (i.e. the equivalent of :func:`unique_everseen`)
-
-    >>> list(classify_unique('otto'))    # doctest: +NORMALIZE_WHITESPACE
-    [('o', True,  True),
-     ('t', True,  True),
-     ('t', False, False),
-     ('o', True,  False)]
-
-    This function is analogous to :func:`unique_everseen` and is subject to
-    the same performance considerations.
-
-    """
-    seen_set = set()
-    seen_list = []
-    use_key = key is not None
-    previous = None
-
-    for i, element in enumerate(iterable):
-        k = key(element) if use_key else element
-        is_unique_justseen = not i or previous != k
-        previous = k
-        is_unique_everseen = False
-        try:
-            if k not in seen_set:
-                seen_set.add(k)
-                is_unique_everseen = True
-        except TypeError:
-            if k not in seen_list:
-                seen_list.append(k)
-                is_unique_everseen = True
-        yield element, is_unique_justseen, is_unique_everseen
-
-
 def minmax(iterable_or_value, *others, key=None, default=_marker):
     """Returns both the smallest and largest items in an iterable
     or the largest of two or more arguments.
@@ -4581,8 +4529,10 @@ def takewhile_inclusive(predicate, iterable):
     :func:`takewhile` would return ``[1, 4]``.
     """
     for x in iterable:
-        yield x
-        if not predicate(x):
+        if predicate(x):
+            yield x
+        else:
+            yield x
             break
 
 
@@ -4617,40 +4567,3 @@ def outer_product(func, xs, ys, *args, **kwargs):
         starmap(lambda x, y: func(x, y, *args, **kwargs), product(xs, ys)),
         n=len(ys),
     )
-
-
-def iter_suppress(iterable, *exceptions):
-    """Yield each of the items from *iterable*. If the iteration raises one of
-    the specified *exceptions*, that exception will be suppressed and iteration
-    will stop.
-
-    >>> from itertools import chain
-    >>> def breaks_at_five(x):
-    ...     while True:
-    ...         if x >= 5:
-    ...             raise RuntimeError
-    ...         yield x
-    ...         x += 1
-    >>> it_1 = iter_suppress(breaks_at_five(1), RuntimeError)
-    >>> it_2 = iter_suppress(breaks_at_five(2), RuntimeError)
-    >>> list(chain(it_1, it_2))
-    [1, 2, 3, 4, 2, 3, 4]
-    """
-    try:
-        yield from iterable
-    except exceptions:
-        return
-
-
-def filter_map(func, iterable):
-    """Apply *func* to every element of *iterable*, yielding only those which
-    are not ``None``.
-
-    >>> elems = ['1', 'a', '2', 'b', '3']
-    >>> list(filter_map(lambda s: int(s) if s.isnumeric() else None, elems))
-    [1, 2, 3]
-    """
-    for x in iterable:
-        y = func(x)
-        if y is not None:
-            yield y
diff --git a/lib/more_itertools/more.pyi b/lib/more_itertools/more.pyi
index 9a5fc911..07bfc155 100644
--- a/lib/more_itertools/more.pyi
+++ b/lib/more_itertools/more.pyi
@@ -29,7 +29,7 @@ _U = TypeVar('_U')
 _V = TypeVar('_V')
 _W = TypeVar('_W')
 _T_co = TypeVar('_T_co', covariant=True)
-_GenFn = TypeVar('_GenFn', bound=Callable[..., Iterator[Any]])
+_GenFn = TypeVar('_GenFn', bound=Callable[..., Iterator[object]])
 _Raisable = BaseException | Type[BaseException]
 
 @type_check_only
@@ -74,7 +74,7 @@ class peekable(Generic[_T], Iterator[_T]):
     def __getitem__(self, index: slice) -> list[_T]: ...
 
 def consumer(func: _GenFn) -> _GenFn: ...
-def ilen(iterable: Iterable[_T]) -> int: ...
+def ilen(iterable: Iterable[object]) -> int: ...
 def iterate(func: Callable[[_T], _T], start: _T) -> Iterator[_T]: ...
 def with_iter(
     context_manager: ContextManager[Iterable[_T]],
@@ -116,7 +116,7 @@ class bucket(Generic[_T, _U], Container[_U]):
         self,
         iterable: Iterable[_T],
         key: Callable[[_T], _U],
-        validator: Callable[[_U], object] | None = ...,
+        validator: Callable[[object], object] | None = ...,
     ) -> None: ...
     def __contains__(self, value: object) -> bool: ...
     def __iter__(self) -> Iterator[_U]: ...
@@ -383,7 +383,7 @@ def mark_ends(
     iterable: Iterable[_T],
 ) -> Iterable[tuple[bool, bool, _T]]: ...
 def locate(
-    iterable: Iterable[_T],
+    iterable: Iterable[object],
     pred: Callable[..., Any] = ...,
     window_size: int | None = ...,
 ) -> Iterator[int]: ...
@@ -618,9 +618,6 @@ def duplicates_everseen(
 def duplicates_justseen(
     iterable: Iterable[_T], key: Callable[[_T], _U] | None = ...
 ) -> Iterator[_T]: ...
-def classify_unique(
-    iterable: Iterable[_T], key: Callable[[_T], _U] | None = ...
-) -> Iterator[tuple[_T, bool, bool]]: ...
 
 class _SupportsLessThan(Protocol):
     def __lt__(self, __other: Any) -> bool: ...
@@ -665,9 +662,9 @@ def minmax(
 def longest_common_prefix(
     iterables: Iterable[Iterable[_T]],
 ) -> Iterator[_T]: ...
-def iequals(*iterables: Iterable[Any]) -> bool: ...
+def iequals(*iterables: Iterable[object]) -> bool: ...
 def constrained_batches(
-    iterable: Iterable[_T],
+    iterable: Iterable[object],
     max_size: int,
     max_count: int | None = ...,
     get_len: Callable[[_T], object] = ...,
@@ -685,11 +682,3 @@ def outer_product(
     *args: Any,
     **kwargs: Any,
 ) -> Iterator[tuple[_V, ...]]: ...
-def iter_suppress(
-    iterable: Iterable[_T],
-    *exceptions: Type[BaseException],
-) -> Iterator[_T]: ...
-def filter_map(
-    func: Callable[[_T], _V | None],
-    iterable: Iterable[_T],
-) -> Iterator[_V]: ...
diff --git a/lib/more_itertools/recipes.py b/lib/more_itertools/recipes.py
index 145e3cb5..a0bdbece 100644
--- a/lib/more_itertools/recipes.py
+++ b/lib/more_itertools/recipes.py
@@ -28,7 +28,6 @@ from itertools import (
     zip_longest,
 )
 from random import randrange, sample, choice
-from sys import hexversion
 
 __all__ = [
     'all_equal',
@@ -57,7 +56,6 @@ __all__ = [
     'powerset',
     'prepend',
     'quantify',
-    'reshape',
     'random_combination_with_replacement',
     'random_combination',
     'random_permutation',
@@ -71,7 +69,6 @@ __all__ = [
     'tabulate',
     'tail',
     'take',
-    'totient',
     'transpose',
     'triplewise',
     'unique_everseen',
@@ -495,7 +492,7 @@ def unique_everseen(iterable, key=None):
         >>> list(unique_everseen(iterable, key=tuple))  # Faster
         [[1, 2], [2, 3]]
 
-    Similarly, you may want to convert unhashable ``set`` objects with
+    Similary, you may want to convert unhashable ``set`` objects with
     ``key=frozenset``. For ``dict`` objects,
     ``key=lambda x: frozenset(x.items())`` can be used.
 
@@ -527,9 +524,6 @@ def unique_justseen(iterable, key=None):
     ['A', 'B', 'C', 'A', 'D']
 
     """
-    if key is None:
-        return map(operator.itemgetter(0), groupby(iterable))
-
     return map(next, map(operator.itemgetter(1), groupby(iterable, key)))
 
 
@@ -823,34 +817,35 @@ def polynomial_from_roots(roots):
     return list(reduce(convolve, factors, [1]))
 
 
-def iter_index(iterable, value, start=0, stop=None):
+def iter_index(iterable, value, start=0):
     """Yield the index of each place in *iterable* that *value* occurs,
-    beginning with index *start* and ending before index *stop*.
+    beginning with index *start*.
 
     See :func:`locate` for a more general means of finding the indexes
     associated with particular values.
 
     >>> list(iter_index('AABCADEAF', 'A'))
     [0, 1, 4, 7]
-    >>> list(iter_index('AABCADEAF', 'A', 1))  # start index is inclusive
-    [1, 4, 7]
-    >>> list(iter_index('AABCADEAF', 'A', 1, 7))  # stop index is not inclusive
-    [1, 4]
     """
-    seq_index = getattr(iterable, 'index', None)
-    if seq_index is None:
+    try:
+        seq_index = iterable.index
+    except AttributeError:
         # Slow path for general iterables
-        it = islice(iterable, start, stop)
-        for i, element in enumerate(it, start):
-            if element is value or element == value:
-                yield i
-    else:
-        # Fast path for sequences
-        stop = len(iterable) if stop is None else stop
+        it = islice(iterable, start, None)
         i = start - 1
         try:
             while True:
-                yield (i := seq_index(value, i + 1, stop))
+                i = i + operator.indexOf(it, value) + 1
+                yield i
+        except ValueError:
+            pass
+    else:
+        # Fast path for sequences
+        i = start - 1
+        try:
+            while True:
+                i = seq_index(value, i + 1)
+                yield i
         except ValueError:
             pass
 
@@ -861,52 +856,47 @@ def sieve(n):
     >>> list(sieve(30))
     [2, 3, 5, 7, 11, 13, 17, 19, 23, 29]
     """
-    if n > 2:
-        yield 2
-    start = 3
     data = bytearray((0, 1)) * (n // 2)
+    data[:3] = 0, 0, 0
     limit = math.isqrt(n) + 1
-    for p in iter_index(data, 1, start, limit):
-        yield from iter_index(data, 1, start, p * p)
+    for p in compress(range(limit), data):
         data[p * p : n : p + p] = bytes(len(range(p * p, n, p + p)))
-        start = p * p
-    yield from iter_index(data, 1, start)
+    data[2] = 1
+    return iter_index(data, 1) if n > 2 else iter([])
 
 
-def _batched(iterable, n, *, strict=False):
-    """Batch data into tuples of length *n*. If the number of items in
-    *iterable* is not divisible by *n*:
-    * The last batch will be shorter if *strict* is ``False``.
-    * :exc:`ValueError` will be raised if *strict* is ``True``.
+def _batched(iterable, n):
+    """Batch data into lists of length *n*. The last batch may be shorter.
 
     >>> list(batched('ABCDEFG', 3))
     [('A', 'B', 'C'), ('D', 'E', 'F'), ('G',)]
 
-    On Python 3.13 and above, this is an alias for :func:`itertools.batched`.
+    On Python 3.12 and above, this is an alias for :func:`itertools.batched`.
     """
     if n < 1:
         raise ValueError('n must be at least one')
     it = iter(iterable)
-    while batch := tuple(islice(it, n)):
-        if strict and len(batch) != n:
-            raise ValueError('batched(): incomplete batch')
+    while True:
+        batch = tuple(islice(it, n))
+        if not batch:
+            break
         yield batch
 
 
-if hexversion >= 0x30D00A2:
+try:
     from itertools import batched as itertools_batched
-
-    def batched(iterable, n, *, strict=False):
-        return itertools_batched(iterable, n, strict=strict)
-
-else:
+except ImportError:
     batched = _batched
+else:
+
+    def batched(iterable, n):
+        return itertools_batched(iterable, n)
 
     batched.__doc__ = _batched.__doc__
 
 
 def transpose(it):
-    """Swap the rows and columns of the input matrix.
+    """Swap the rows and columns of the input.
 
     >>> list(transpose([(1, 2, 3), (11, 22, 33)]))
     [(1, 11), (2, 22), (3, 33)]
@@ -917,20 +907,8 @@ def transpose(it):
     return _zip_strict(*it)
 
 
-def reshape(matrix, cols):
-    """Reshape the 2-D input *matrix* to have a column count given by *cols*.
-
-    >>> matrix = [(0, 1), (2, 3), (4, 5)]
-    >>> cols = 3
-    >>> list(reshape(matrix, cols))
-    [(0, 1, 2), (3, 4, 5)]
-    """
-    return batched(chain.from_iterable(matrix), cols)
-
-
 def matmul(m1, m2):
     """Multiply two matrices.
-
     >>> list(matmul([(7, 5), (3, 5)], [(2, 5), (7, 9)]))
     [(49, 80), (41, 60)]
 
@@ -943,12 +921,13 @@ def matmul(m1, m2):
 
 def factor(n):
     """Yield the prime factors of n.
-
     >>> list(factor(360))
     [2, 2, 2, 3, 3, 5]
     """
     for prime in sieve(math.isqrt(n) + 1):
-        while not n % prime:
+        while True:
+            if n % prime:
+                break
             yield prime
             n //= prime
             if n == 1:
@@ -996,17 +975,3 @@ def polynomial_derivative(coefficients):
     n = len(coefficients)
     powers = reversed(range(1, n))
     return list(map(operator.mul, coefficients, powers))
-
-
-def totient(n):
-    """Return the count of natural numbers up to *n* that are coprime with *n*.
-
-    >>> totient(9)
-    6
-    >>> totient(12)
-    4
-    """
-    for p in unique_justseen(factor(n)):
-        n = n // p * (p - 1)
-
-    return n
diff --git a/lib/more_itertools/recipes.pyi b/lib/more_itertools/recipes.pyi
index ed4c19db..ef883864 100644
--- a/lib/more_itertools/recipes.pyi
+++ b/lib/more_itertools/recipes.pyi
@@ -14,8 +14,6 @@ from typing import (
 
 # Type and type variable definitions
 _T = TypeVar('_T')
-_T1 = TypeVar('_T1')
-_T2 = TypeVar('_T2')
 _U = TypeVar('_U')
 
 def take(n: int, iterable: Iterable[_T]) -> list[_T]: ...
@@ -28,14 +26,14 @@ def consume(iterator: Iterable[_T], n: int | None = ...) -> None: ...
 def nth(iterable: Iterable[_T], n: int) -> _T | None: ...
 @overload
 def nth(iterable: Iterable[_T], n: int, default: _U) -> _T | _U: ...
-def all_equal(iterable: Iterable[_T]) -> bool: ...
+def all_equal(iterable: Iterable[object]) -> bool: ...
 def quantify(
     iterable: Iterable[_T], pred: Callable[[_T], bool] = ...
 ) -> int: ...
 def pad_none(iterable: Iterable[_T]) -> Iterator[_T | None]: ...
 def padnone(iterable: Iterable[_T]) -> Iterator[_T | None]: ...
 def ncycles(iterable: Iterable[_T], n: int) -> Iterator[_T]: ...
-def dotproduct(vec1: Iterable[_T1], vec2: Iterable[_T2]) -> Any: ...
+def dotproduct(vec1: Iterable[object], vec2: Iterable[object]) -> object: ...
 def flatten(listOfLists: Iterable[Iterable[_T]]) -> Iterator[_T]: ...
 def repeatfunc(
     func: Callable[..., _U], times: int | None = ..., *args: Any
@@ -105,24 +103,20 @@ def sliding_window(
 def subslices(iterable: Iterable[_T]) -> Iterator[list[_T]]: ...
 def polynomial_from_roots(roots: Sequence[_T]) -> list[_T]: ...
 def iter_index(
-    iterable: Iterable[_T],
+    iterable: Iterable[object],
     value: Any,
     start: int | None = ...,
-    stop: int | None = ...,
 ) -> Iterator[int]: ...
 def sieve(n: int) -> Iterator[int]: ...
 def batched(
-    iterable: Iterable[_T], n: int, *, strict: bool = False
+    iterable: Iterable[_T],
+    n: int,
 ) -> Iterator[tuple[_T]]: ...
 def transpose(
     it: Iterable[Iterable[_T]],
 ) -> Iterator[tuple[_T, ...]]: ...
-def reshape(
-    matrix: Iterable[Iterable[_T]], cols: int
-) -> Iterator[tuple[_T, ...]]: ...
 def matmul(m1: Sequence[_T], m2: Sequence[_T]) -> Iterator[tuple[_T]]: ...
 def factor(n: int) -> Iterator[int]: ...
 def polynomial_eval(coefficients: Sequence[_T], x: _U) -> _U: ...
 def sum_of_squares(it: Iterable[_T]) -> _T: ...
 def polynomial_derivative(coefficients: Sequence[_T]) -> list[_T]: ...
-def totient(n: int) -> int: ...
diff --git a/lib/pydantic/__init__.py b/lib/pydantic/__init__.py
index 85a8c18b..3bf1418f 100644
--- a/lib/pydantic/__init__.py
+++ b/lib/pydantic/__init__.py
@@ -1,114 +1,56 @@
-import typing
-
-from ._migration import getattr_migration
-from .version import VERSION
-
-if typing.TYPE_CHECKING:
-    # import of virtually everything is supported via `__getattr__` below,
-    # but we need them here for type checking and IDE support
-    import pydantic_core
-    from pydantic_core.core_schema import (
-        FieldSerializationInfo,
-        SerializationInfo,
-        SerializerFunctionWrapHandler,
-        ValidationInfo,
-        ValidatorFunctionWrapHandler,
-    )
-
-    from . import dataclasses
-    from ._internal._generate_schema import GenerateSchema as GenerateSchema
-    from .aliases import AliasChoices, AliasGenerator, AliasPath
-    from .annotated_handlers import GetCoreSchemaHandler, GetJsonSchemaHandler
-    from .config import ConfigDict
-    from .errors import *
-    from .fields import Field, PrivateAttr, computed_field
-    from .functional_serializers import (
-        PlainSerializer,
-        SerializeAsAny,
-        WrapSerializer,
-        field_serializer,
-        model_serializer,
-    )
-    from .functional_validators import (
-        AfterValidator,
-        BeforeValidator,
-        InstanceOf,
-        PlainValidator,
-        SkipValidation,
-        WrapValidator,
-        field_validator,
-        model_validator,
-    )
-    from .json_schema import WithJsonSchema
-    from .main import *
-    from .networks import *
-    from .type_adapter import TypeAdapter
-    from .types import *
-    from .validate_call_decorator import validate_call
-    from .warnings import PydanticDeprecatedSince20, PydanticDeprecatedSince26, PydanticDeprecationWarning
-
-    # this encourages pycharm to import `ValidationError` from here, not pydantic_core
-    ValidationError = pydantic_core.ValidationError
-    from .deprecated.class_validators import root_validator, validator
-    from .deprecated.config import BaseConfig, Extra
-    from .deprecated.tools import *
-    from .root_model import RootModel
+# flake8: noqa
+from . import dataclasses
+from .annotated_types import create_model_from_namedtuple, create_model_from_typeddict
+from .class_validators import root_validator, validator
+from .config import BaseConfig, ConfigDict, Extra
+from .decorator import validate_arguments
+from .env_settings import BaseSettings
+from .error_wrappers import ValidationError
+from .errors import *
+from .fields import Field, PrivateAttr, Required
+from .main import *
+from .networks import *
+from .parse import Protocol
+from .tools import *
+from .types import *
+from .version import VERSION, compiled
 
 __version__ = VERSION
-__all__ = (
+
+# WARNING __all__ from .errors is not included here, it will be removed as an export here in v2
+# please use "from pydantic.errors import ..." instead
+__all__ = [
+    # annotated types utils
+    'create_model_from_namedtuple',
+    'create_model_from_typeddict',
     # dataclasses
     'dataclasses',
-    # functional validators
-    'field_validator',
-    'model_validator',
-    'AfterValidator',
-    'BeforeValidator',
-    'PlainValidator',
-    'WrapValidator',
-    'SkipValidation',
-    'InstanceOf',
-    # JSON Schema
-    'WithJsonSchema',
-    # deprecated V1 functional validators, these are imported via `__getattr__` below
+    # class_validators
     'root_validator',
     'validator',
-    # functional serializers
-    'field_serializer',
-    'model_serializer',
-    'PlainSerializer',
-    'SerializeAsAny',
-    'WrapSerializer',
     # config
-    'ConfigDict',
-    # deprecated V1 config, these are imported via `__getattr__` below
     'BaseConfig',
+    'ConfigDict',
     'Extra',
-    # validate_call
-    'validate_call',
-    # errors
-    'PydanticErrorCodes',
-    'PydanticUserError',
-    'PydanticSchemaGenerationError',
-    'PydanticImportError',
-    'PydanticUndefinedAnnotation',
-    'PydanticInvalidForJsonSchema',
+    # decorator
+    'validate_arguments',
+    # env_settings
+    'BaseSettings',
+    # error_wrappers
+    'ValidationError',
     # fields
     'Field',
-    'computed_field',
-    'PrivateAttr',
-    # alias
-    'AliasChoices',
-    'AliasGenerator',
-    'AliasPath',
+    'Required',
     # main
     'BaseModel',
     'create_model',
+    'validate_model',
     # network
     'AnyUrl',
     'AnyHttpUrl',
     'FileUrl',
     'HttpUrl',
-    'UrlConstraints',
+    'stricturl',
     'EmailStr',
     'NameEmail',
     'IPvAnyAddress',
@@ -120,38 +62,48 @@ __all__ = (
     'RedisDsn',
     'MongoDsn',
     'KafkaDsn',
-    'NatsDsn',
-    'MySQLDsn',
-    'MariaDBDsn',
     'validate_email',
-    # root_model
-    'RootModel',
-    # deprecated tools, these are imported via `__getattr__` below
+    # parse
+    'Protocol',
+    # tools
+    'parse_file_as',
     'parse_obj_as',
+    'parse_raw_as',
     'schema_of',
     'schema_json_of',
     # types
-    'Strict',
+    'NoneStr',
+    'NoneBytes',
+    'StrBytes',
+    'NoneStrBytes',
     'StrictStr',
+    'ConstrainedBytes',
     'conbytes',
+    'ConstrainedList',
     'conlist',
+    'ConstrainedSet',
     'conset',
+    'ConstrainedFrozenSet',
     'confrozenset',
+    'ConstrainedStr',
     'constr',
-    'StringConstraints',
-    'ImportString',
+    'PyObject',
+    'ConstrainedInt',
     'conint',
     'PositiveInt',
     'NegativeInt',
     'NonNegativeInt',
     'NonPositiveInt',
+    'ConstrainedFloat',
     'confloat',
     'PositiveFloat',
     'NegativeFloat',
     'NonNegativeFloat',
     'NonPositiveFloat',
     'FiniteFloat',
+    'ConstrainedDecimal',
     'condecimal',
+    'ConstrainedDate',
     'condate',
     'UUID1',
     'UUID3',
@@ -159,8 +111,9 @@ __all__ = (
     'UUID5',
     'FilePath',
     'DirectoryPath',
-    'NewPath',
     'Json',
+    'JsonWrapper',
+    'SecretField',
     'SecretStr',
     'SecretBytes',
     'StrictBool',
@@ -168,221 +121,11 @@ __all__ = (
     'StrictInt',
     'StrictFloat',
     'PaymentCardNumber',
+    'PrivateAttr',
     'ByteSize',
     'PastDate',
     'FutureDate',
-    'PastDatetime',
-    'FutureDatetime',
-    'AwareDatetime',
-    'NaiveDatetime',
-    'AllowInfNan',
-    'EncoderProtocol',
-    'EncodedBytes',
-    'EncodedStr',
-    'Base64Encoder',
-    'Base64Bytes',
-    'Base64Str',
-    'Base64UrlBytes',
-    'Base64UrlStr',
-    'GetPydanticSchema',
-    'Tag',
-    'Discriminator',
-    'JsonValue',
-    # type_adapter
-    'TypeAdapter',
     # version
-    '__version__',
+    'compiled',
     'VERSION',
-    # warnings
-    'PydanticDeprecatedSince20',
-    'PydanticDeprecatedSince26',
-    'PydanticDeprecationWarning',
-    # annotated handlers
-    'GetCoreSchemaHandler',
-    'GetJsonSchemaHandler',
-    # generate schema from ._internal
-    'GenerateSchema',
-    # pydantic_core
-    'ValidationError',
-    'ValidationInfo',
-    'SerializationInfo',
-    'ValidatorFunctionWrapHandler',
-    'FieldSerializationInfo',
-    'SerializerFunctionWrapHandler',
-    'OnErrorOmit',
-)
-
-# A mapping of {<member name>: (package, <module name>)} defining dynamic imports
-_dynamic_imports: 'dict[str, tuple[str, str]]' = {
-    'dataclasses': (__package__, '__module__'),
-    # functional validators
-    'field_validator': (__package__, '.functional_validators'),
-    'model_validator': (__package__, '.functional_validators'),
-    'AfterValidator': (__package__, '.functional_validators'),
-    'BeforeValidator': (__package__, '.functional_validators'),
-    'PlainValidator': (__package__, '.functional_validators'),
-    'WrapValidator': (__package__, '.functional_validators'),
-    'SkipValidation': (__package__, '.functional_validators'),
-    'InstanceOf': (__package__, '.functional_validators'),
-    # JSON Schema
-    'WithJsonSchema': (__package__, '.json_schema'),
-    # functional serializers
-    'field_serializer': (__package__, '.functional_serializers'),
-    'model_serializer': (__package__, '.functional_serializers'),
-    'PlainSerializer': (__package__, '.functional_serializers'),
-    'SerializeAsAny': (__package__, '.functional_serializers'),
-    'WrapSerializer': (__package__, '.functional_serializers'),
-    # config
-    'ConfigDict': (__package__, '.config'),
-    # validate call
-    'validate_call': (__package__, '.validate_call_decorator'),
-    # errors
-    'PydanticErrorCodes': (__package__, '.errors'),
-    'PydanticUserError': (__package__, '.errors'),
-    'PydanticSchemaGenerationError': (__package__, '.errors'),
-    'PydanticImportError': (__package__, '.errors'),
-    'PydanticUndefinedAnnotation': (__package__, '.errors'),
-    'PydanticInvalidForJsonSchema': (__package__, '.errors'),
-    # fields
-    'Field': (__package__, '.fields'),
-    'computed_field': (__package__, '.fields'),
-    'PrivateAttr': (__package__, '.fields'),
-    # alias
-    'AliasChoices': (__package__, '.aliases'),
-    'AliasGenerator': (__package__, '.aliases'),
-    'AliasPath': (__package__, '.aliases'),
-    # main
-    'BaseModel': (__package__, '.main'),
-    'create_model': (__package__, '.main'),
-    # network
-    'AnyUrl': (__package__, '.networks'),
-    'AnyHttpUrl': (__package__, '.networks'),
-    'FileUrl': (__package__, '.networks'),
-    'HttpUrl': (__package__, '.networks'),
-    'UrlConstraints': (__package__, '.networks'),
-    'EmailStr': (__package__, '.networks'),
-    'NameEmail': (__package__, '.networks'),
-    'IPvAnyAddress': (__package__, '.networks'),
-    'IPvAnyInterface': (__package__, '.networks'),
-    'IPvAnyNetwork': (__package__, '.networks'),
-    'PostgresDsn': (__package__, '.networks'),
-    'CockroachDsn': (__package__, '.networks'),
-    'AmqpDsn': (__package__, '.networks'),
-    'RedisDsn': (__package__, '.networks'),
-    'MongoDsn': (__package__, '.networks'),
-    'KafkaDsn': (__package__, '.networks'),
-    'NatsDsn': (__package__, '.networks'),
-    'MySQLDsn': (__package__, '.networks'),
-    'MariaDBDsn': (__package__, '.networks'),
-    'validate_email': (__package__, '.networks'),
-    # root_model
-    'RootModel': (__package__, '.root_model'),
-    # types
-    'Strict': (__package__, '.types'),
-    'StrictStr': (__package__, '.types'),
-    'conbytes': (__package__, '.types'),
-    'conlist': (__package__, '.types'),
-    'conset': (__package__, '.types'),
-    'confrozenset': (__package__, '.types'),
-    'constr': (__package__, '.types'),
-    'StringConstraints': (__package__, '.types'),
-    'ImportString': (__package__, '.types'),
-    'conint': (__package__, '.types'),
-    'PositiveInt': (__package__, '.types'),
-    'NegativeInt': (__package__, '.types'),
-    'NonNegativeInt': (__package__, '.types'),
-    'NonPositiveInt': (__package__, '.types'),
-    'confloat': (__package__, '.types'),
-    'PositiveFloat': (__package__, '.types'),
-    'NegativeFloat': (__package__, '.types'),
-    'NonNegativeFloat': (__package__, '.types'),
-    'NonPositiveFloat': (__package__, '.types'),
-    'FiniteFloat': (__package__, '.types'),
-    'condecimal': (__package__, '.types'),
-    'condate': (__package__, '.types'),
-    'UUID1': (__package__, '.types'),
-    'UUID3': (__package__, '.types'),
-    'UUID4': (__package__, '.types'),
-    'UUID5': (__package__, '.types'),
-    'FilePath': (__package__, '.types'),
-    'DirectoryPath': (__package__, '.types'),
-    'NewPath': (__package__, '.types'),
-    'Json': (__package__, '.types'),
-    'SecretStr': (__package__, '.types'),
-    'SecretBytes': (__package__, '.types'),
-    'StrictBool': (__package__, '.types'),
-    'StrictBytes': (__package__, '.types'),
-    'StrictInt': (__package__, '.types'),
-    'StrictFloat': (__package__, '.types'),
-    'PaymentCardNumber': (__package__, '.types'),
-    'ByteSize': (__package__, '.types'),
-    'PastDate': (__package__, '.types'),
-    'FutureDate': (__package__, '.types'),
-    'PastDatetime': (__package__, '.types'),
-    'FutureDatetime': (__package__, '.types'),
-    'AwareDatetime': (__package__, '.types'),
-    'NaiveDatetime': (__package__, '.types'),
-    'AllowInfNan': (__package__, '.types'),
-    'EncoderProtocol': (__package__, '.types'),
-    'EncodedBytes': (__package__, '.types'),
-    'EncodedStr': (__package__, '.types'),
-    'Base64Encoder': (__package__, '.types'),
-    'Base64Bytes': (__package__, '.types'),
-    'Base64Str': (__package__, '.types'),
-    'Base64UrlBytes': (__package__, '.types'),
-    'Base64UrlStr': (__package__, '.types'),
-    'GetPydanticSchema': (__package__, '.types'),
-    'Tag': (__package__, '.types'),
-    'Discriminator': (__package__, '.types'),
-    'JsonValue': (__package__, '.types'),
-    'OnErrorOmit': (__package__, '.types'),
-    # type_adapter
-    'TypeAdapter': (__package__, '.type_adapter'),
-    # warnings
-    'PydanticDeprecatedSince20': (__package__, '.warnings'),
-    'PydanticDeprecatedSince26': (__package__, '.warnings'),
-    'PydanticDeprecationWarning': (__package__, '.warnings'),
-    # annotated handlers
-    'GetCoreSchemaHandler': (__package__, '.annotated_handlers'),
-    'GetJsonSchemaHandler': (__package__, '.annotated_handlers'),
-    # generate schema from ._internal
-    'GenerateSchema': (__package__, '._internal._generate_schema'),
-    # pydantic_core stuff
-    'ValidationError': ('pydantic_core', '.'),
-    'ValidationInfo': ('pydantic_core', '.core_schema'),
-    'SerializationInfo': ('pydantic_core', '.core_schema'),
-    'ValidatorFunctionWrapHandler': ('pydantic_core', '.core_schema'),
-    'FieldSerializationInfo': ('pydantic_core', '.core_schema'),
-    'SerializerFunctionWrapHandler': ('pydantic_core', '.core_schema'),
-    # deprecated, mostly not included in __all__
-    'root_validator': (__package__, '.deprecated.class_validators'),
-    'validator': (__package__, '.deprecated.class_validators'),
-    'BaseConfig': (__package__, '.deprecated.config'),
-    'Extra': (__package__, '.deprecated.config'),
-    'parse_obj_as': (__package__, '.deprecated.tools'),
-    'schema_of': (__package__, '.deprecated.tools'),
-    'schema_json_of': (__package__, '.deprecated.tools'),
-    'FieldValidationInfo': ('pydantic_core', '.core_schema'),
-}
-
-_getattr_migration = getattr_migration(__name__)
-
-
-def __getattr__(attr_name: str) -> object:
-    dynamic_attr = _dynamic_imports.get(attr_name)
-    if dynamic_attr is None:
-        return _getattr_migration(attr_name)
-
-    package, module_name = dynamic_attr
-
-    from importlib import import_module
-
-    if module_name == '__module__':
-        return import_module(f'.{attr_name}', package=package)
-    else:
-        module = import_module(module_name, package=package)
-        return getattr(module, attr_name)
-
-
-def __dir__() -> 'list[str]':
-    return list(__all__)
+]
diff --git a/lib/pydantic/v1/_hypothesis_plugin.py b/lib/pydantic/_hypothesis_plugin.py
similarity index 97%
rename from lib/pydantic/v1/_hypothesis_plugin.py
rename to lib/pydantic/_hypothesis_plugin.py
index 0c529620..a56d2b98 100644
--- a/lib/pydantic/v1/_hypothesis_plugin.py
+++ b/lib/pydantic/_hypothesis_plugin.py
@@ -10,7 +10,7 @@ Pydantic is installed.  See also:
 https://hypothesis.readthedocs.io/en/latest/strategies.html#registering-strategies-via-setuptools-entry-points
 https://hypothesis.readthedocs.io/en/latest/data.html#hypothesis.strategies.register_type_strategy
 https://hypothesis.readthedocs.io/en/latest/strategies.html#interaction-with-pytest-cov
-https://docs.pydantic.dev/usage/types/#pydantic-types
+https://pydantic-docs.helpmanual.io/usage/types/#pydantic-types
 
 Note that because our motivation is to *improve user experience*, the strategies
 are always sound (never generate invalid data) but sacrifice completeness for
@@ -46,7 +46,7 @@ from pydantic.utils import lenient_issubclass
 #
 # conlist() and conset() are unsupported for now, because the workarounds for
 # Cython and Hypothesis to handle parametrized generic types are incompatible.
-# We are rethinking Hypothesis compatibility in Pydantic v2.
+# Once Cython can support 'normal' generics we'll revisit this.
 
 # Emails
 try:
@@ -168,11 +168,6 @@ st.register_type_strategy(pydantic.StrictBool, st.booleans())
 st.register_type_strategy(pydantic.StrictStr, st.text())
 
 
-# FutureDate, PastDate
-st.register_type_strategy(pydantic.FutureDate, st.dates(min_value=datetime.date.today() + datetime.timedelta(days=1)))
-st.register_type_strategy(pydantic.PastDate, st.dates(max_value=datetime.date.today() - datetime.timedelta(days=1)))
-
-
 # Constrained-type resolver functions
 #
 # For these ones, we actually want to inspect the type in order to work out a
diff --git a/lib/pydantic/_internal/__init__.py b/lib/pydantic/_internal/__init__.py
deleted file mode 100644
index e69de29b..00000000
diff --git a/lib/pydantic/_internal/_config.py b/lib/pydantic/_internal/_config.py
deleted file mode 100644
index 52c4cc42..00000000
--- a/lib/pydantic/_internal/_config.py
+++ /dev/null
@@ -1,322 +0,0 @@
-from __future__ import annotations as _annotations
-
-import warnings
-from contextlib import contextmanager
-from typing import (
-    TYPE_CHECKING,
-    Any,
-    Callable,
-    cast,
-)
-
-from pydantic_core import core_schema
-from typing_extensions import (
-    Literal,
-    Self,
-)
-
-from ..aliases import AliasGenerator
-from ..config import ConfigDict, ExtraValues, JsonDict, JsonEncoder, JsonSchemaExtraCallable
-from ..errors import PydanticUserError
-from ..warnings import PydanticDeprecatedSince20
-
-if not TYPE_CHECKING:
-    # See PyCharm issues https://youtrack.jetbrains.com/issue/PY-21915
-    # and https://youtrack.jetbrains.com/issue/PY-51428
-    DeprecationWarning = PydanticDeprecatedSince20
-
-if TYPE_CHECKING:
-    from .._internal._schema_generation_shared import GenerateSchema
-
-DEPRECATION_MESSAGE = 'Support for class-based `config` is deprecated, use ConfigDict instead.'
-
-
-class ConfigWrapper:
-    """Internal wrapper for Config which exposes ConfigDict items as attributes."""
-
-    __slots__ = ('config_dict',)
-
-    config_dict: ConfigDict
-
-    # all annotations are copied directly from ConfigDict, and should be kept up to date, a test will fail if they
-    # stop matching
-    title: str | None
-    str_to_lower: bool
-    str_to_upper: bool
-    str_strip_whitespace: bool
-    str_min_length: int
-    str_max_length: int | None
-    extra: ExtraValues | None
-    frozen: bool
-    populate_by_name: bool
-    use_enum_values: bool
-    validate_assignment: bool
-    arbitrary_types_allowed: bool
-    from_attributes: bool
-    # whether to use the actual key provided in the data (e.g. alias or first alias for "field required" errors) instead of field_names
-    # to construct error `loc`s, default `True`
-    loc_by_alias: bool
-    alias_generator: Callable[[str], str] | AliasGenerator | None
-    ignored_types: tuple[type, ...]
-    allow_inf_nan: bool
-    json_schema_extra: JsonDict | JsonSchemaExtraCallable | None
-    json_encoders: dict[type[object], JsonEncoder] | None
-
-    # new in V2
-    strict: bool
-    # whether instances of models and dataclasses (including subclass instances) should re-validate, default 'never'
-    revalidate_instances: Literal['always', 'never', 'subclass-instances']
-    ser_json_timedelta: Literal['iso8601', 'float']
-    ser_json_bytes: Literal['utf8', 'base64']
-    ser_json_inf_nan: Literal['null', 'constants']
-    # whether to validate default values during validation, default False
-    validate_default: bool
-    validate_return: bool
-    protected_namespaces: tuple[str, ...]
-    hide_input_in_errors: bool
-    defer_build: bool
-    plugin_settings: dict[str, object] | None
-    schema_generator: type[GenerateSchema] | None
-    json_schema_serialization_defaults_required: bool
-    json_schema_mode_override: Literal['validation', 'serialization', None]
-    coerce_numbers_to_str: bool
-    regex_engine: Literal['rust-regex', 'python-re']
-    validation_error_cause: bool
-
-    def __init__(self, config: ConfigDict | dict[str, Any] | type[Any] | None, *, check: bool = True):
-        if check:
-            self.config_dict = prepare_config(config)
-        else:
-            self.config_dict = cast(ConfigDict, config)
-
-    @classmethod
-    def for_model(cls, bases: tuple[type[Any], ...], namespace: dict[str, Any], kwargs: dict[str, Any]) -> Self:
-        """Build a new `ConfigWrapper` instance for a `BaseModel`.
-
-        The config wrapper built based on (in descending order of priority):
-        - options from `kwargs`
-        - options from the `namespace`
-        - options from the base classes (`bases`)
-
-        Args:
-            bases: A tuple of base classes.
-            namespace: The namespace of the class being created.
-            kwargs: The kwargs passed to the class being created.
-
-        Returns:
-            A `ConfigWrapper` instance for `BaseModel`.
-        """
-        config_new = ConfigDict()
-        for base in bases:
-            config = getattr(base, 'model_config', None)
-            if config:
-                config_new.update(config.copy())
-
-        config_class_from_namespace = namespace.get('Config')
-        config_dict_from_namespace = namespace.get('model_config')
-
-        if config_class_from_namespace and config_dict_from_namespace:
-            raise PydanticUserError('"Config" and "model_config" cannot be used together', code='config-both')
-
-        config_from_namespace = config_dict_from_namespace or prepare_config(config_class_from_namespace)
-
-        config_new.update(config_from_namespace)
-
-        for k in list(kwargs.keys()):
-            if k in config_keys:
-                config_new[k] = kwargs.pop(k)
-
-        return cls(config_new)
-
-    # we don't show `__getattr__` to type checkers so missing attributes cause errors
-    if not TYPE_CHECKING:  # pragma: no branch
-
-        def __getattr__(self, name: str) -> Any:
-            try:
-                return self.config_dict[name]
-            except KeyError:
-                try:
-                    return config_defaults[name]
-                except KeyError:
-                    raise AttributeError(f'Config has no attribute {name!r}') from None
-
-    def core_config(self, obj: Any) -> core_schema.CoreConfig:
-        """Create a pydantic-core config, `obj` is just used to populate `title` if not set in config.
-
-        Pass `obj=None` if you do not want to attempt to infer the `title`.
-
-        We don't use getattr here since we don't want to populate with defaults.
-
-        Args:
-            obj: An object used to populate `title` if not set in config.
-
-        Returns:
-            A `CoreConfig` object created from config.
-        """
-
-        def dict_not_none(**kwargs: Any) -> Any:
-            return {k: v for k, v in kwargs.items() if v is not None}
-
-        core_config = core_schema.CoreConfig(
-            **dict_not_none(
-                title=self.config_dict.get('title') or (obj and obj.__name__),
-                extra_fields_behavior=self.config_dict.get('extra'),
-                allow_inf_nan=self.config_dict.get('allow_inf_nan'),
-                populate_by_name=self.config_dict.get('populate_by_name'),
-                str_strip_whitespace=self.config_dict.get('str_strip_whitespace'),
-                str_to_lower=self.config_dict.get('str_to_lower'),
-                str_to_upper=self.config_dict.get('str_to_upper'),
-                strict=self.config_dict.get('strict'),
-                ser_json_timedelta=self.config_dict.get('ser_json_timedelta'),
-                ser_json_bytes=self.config_dict.get('ser_json_bytes'),
-                ser_json_inf_nan=self.config_dict.get('ser_json_inf_nan'),
-                from_attributes=self.config_dict.get('from_attributes'),
-                loc_by_alias=self.config_dict.get('loc_by_alias'),
-                revalidate_instances=self.config_dict.get('revalidate_instances'),
-                validate_default=self.config_dict.get('validate_default'),
-                str_max_length=self.config_dict.get('str_max_length'),
-                str_min_length=self.config_dict.get('str_min_length'),
-                hide_input_in_errors=self.config_dict.get('hide_input_in_errors'),
-                coerce_numbers_to_str=self.config_dict.get('coerce_numbers_to_str'),
-                regex_engine=self.config_dict.get('regex_engine'),
-                validation_error_cause=self.config_dict.get('validation_error_cause'),
-            )
-        )
-        return core_config
-
-    def __repr__(self):
-        c = ', '.join(f'{k}={v!r}' for k, v in self.config_dict.items())
-        return f'ConfigWrapper({c})'
-
-
-class ConfigWrapperStack:
-    """A stack of `ConfigWrapper` instances."""
-
-    def __init__(self, config_wrapper: ConfigWrapper):
-        self._config_wrapper_stack: list[ConfigWrapper] = [config_wrapper]
-
-    @property
-    def tail(self) -> ConfigWrapper:
-        return self._config_wrapper_stack[-1]
-
-    @contextmanager
-    def push(self, config_wrapper: ConfigWrapper | ConfigDict | None):
-        if config_wrapper is None:
-            yield
-            return
-
-        if not isinstance(config_wrapper, ConfigWrapper):
-            config_wrapper = ConfigWrapper(config_wrapper, check=False)
-
-        self._config_wrapper_stack.append(config_wrapper)
-        try:
-            yield
-        finally:
-            self._config_wrapper_stack.pop()
-
-
-config_defaults = ConfigDict(
-    title=None,
-    str_to_lower=False,
-    str_to_upper=False,
-    str_strip_whitespace=False,
-    str_min_length=0,
-    str_max_length=None,
-    # let the model / dataclass decide how to handle it
-    extra=None,
-    frozen=False,
-    populate_by_name=False,
-    use_enum_values=False,
-    validate_assignment=False,
-    arbitrary_types_allowed=False,
-    from_attributes=False,
-    loc_by_alias=True,
-    alias_generator=None,
-    ignored_types=(),
-    allow_inf_nan=True,
-    json_schema_extra=None,
-    strict=False,
-    revalidate_instances='never',
-    ser_json_timedelta='iso8601',
-    ser_json_bytes='utf8',
-    ser_json_inf_nan='null',
-    validate_default=False,
-    validate_return=False,
-    protected_namespaces=('model_',),
-    hide_input_in_errors=False,
-    json_encoders=None,
-    defer_build=False,
-    plugin_settings=None,
-    schema_generator=None,
-    json_schema_serialization_defaults_required=False,
-    json_schema_mode_override=None,
-    coerce_numbers_to_str=False,
-    regex_engine='rust-regex',
-    validation_error_cause=False,
-)
-
-
-def prepare_config(config: ConfigDict | dict[str, Any] | type[Any] | None) -> ConfigDict:
-    """Create a `ConfigDict` instance from an existing dict, a class (e.g. old class-based config) or None.
-
-    Args:
-        config: The input config.
-
-    Returns:
-        A ConfigDict object created from config.
-    """
-    if config is None:
-        return ConfigDict()
-
-    if not isinstance(config, dict):
-        warnings.warn(DEPRECATION_MESSAGE, DeprecationWarning)
-        config = {k: getattr(config, k) for k in dir(config) if not k.startswith('__')}
-
-    config_dict = cast(ConfigDict, config)
-    check_deprecated(config_dict)
-    return config_dict
-
-
-config_keys = set(ConfigDict.__annotations__.keys())
-
-
-V2_REMOVED_KEYS = {
-    'allow_mutation',
-    'error_msg_templates',
-    'fields',
-    'getter_dict',
-    'smart_union',
-    'underscore_attrs_are_private',
-    'json_loads',
-    'json_dumps',
-    'copy_on_model_validation',
-    'post_init_call',
-}
-V2_RENAMED_KEYS = {
-    'allow_population_by_field_name': 'populate_by_name',
-    'anystr_lower': 'str_to_lower',
-    'anystr_strip_whitespace': 'str_strip_whitespace',
-    'anystr_upper': 'str_to_upper',
-    'keep_untouched': 'ignored_types',
-    'max_anystr_length': 'str_max_length',
-    'min_anystr_length': 'str_min_length',
-    'orm_mode': 'from_attributes',
-    'schema_extra': 'json_schema_extra',
-    'validate_all': 'validate_default',
-}
-
-
-def check_deprecated(config_dict: ConfigDict) -> None:
-    """Check for deprecated config keys and warn the user.
-
-    Args:
-        config_dict: The input config.
-    """
-    deprecated_removed_keys = V2_REMOVED_KEYS & config_dict.keys()
-    deprecated_renamed_keys = V2_RENAMED_KEYS.keys() & config_dict.keys()
-    if deprecated_removed_keys or deprecated_renamed_keys:
-        renamings = {k: V2_RENAMED_KEYS[k] for k in sorted(deprecated_renamed_keys)}
-        renamed_bullets = [f'* {k!r} has been renamed to {v!r}' for k, v in renamings.items()]
-        removed_bullets = [f'* {k!r} has been removed' for k in sorted(deprecated_removed_keys)]
-        message = '\n'.join(['Valid config keys have changed in V2:'] + renamed_bullets + removed_bullets)
-        warnings.warn(message, UserWarning)
diff --git a/lib/pydantic/_internal/_core_metadata.py b/lib/pydantic/_internal/_core_metadata.py
deleted file mode 100644
index 296d49f5..00000000
--- a/lib/pydantic/_internal/_core_metadata.py
+++ /dev/null
@@ -1,92 +0,0 @@
-from __future__ import annotations as _annotations
-
-import typing
-from typing import Any
-
-import typing_extensions
-
-if typing.TYPE_CHECKING:
-    from ._schema_generation_shared import (
-        CoreSchemaOrField as CoreSchemaOrField,
-    )
-    from ._schema_generation_shared import (
-        GetJsonSchemaFunction,
-    )
-
-
-class CoreMetadata(typing_extensions.TypedDict, total=False):
-    """A `TypedDict` for holding the metadata dict of the schema.
-
-    Attributes:
-        pydantic_js_functions: List of JSON schema functions.
-        pydantic_js_prefer_positional_arguments: Whether JSON schema generator will
-            prefer positional over keyword arguments for an 'arguments' schema.
-    """
-
-    pydantic_js_functions: list[GetJsonSchemaFunction]
-    pydantic_js_annotation_functions: list[GetJsonSchemaFunction]
-
-    # If `pydantic_js_prefer_positional_arguments` is True, the JSON schema generator will
-    # prefer positional over keyword arguments for an 'arguments' schema.
-    pydantic_js_prefer_positional_arguments: bool | None
-
-    pydantic_typed_dict_cls: type[Any] | None  # TODO: Consider moving this into the pydantic-core TypedDictSchema
-
-
-class CoreMetadataHandler:
-    """Because the metadata field in pydantic_core is of type `Any`, we can't assume much about its contents.
-
-    This class is used to interact with the metadata field on a CoreSchema object in a consistent
-    way throughout pydantic.
-    """
-
-    __slots__ = ('_schema',)
-
-    def __init__(self, schema: CoreSchemaOrField):
-        self._schema = schema
-
-        metadata = schema.get('metadata')
-        if metadata is None:
-            schema['metadata'] = CoreMetadata()
-        elif not isinstance(metadata, dict):
-            raise TypeError(f'CoreSchema metadata should be a dict; got {metadata!r}.')
-
-    @property
-    def metadata(self) -> CoreMetadata:
-        """Retrieves the metadata dict from the schema, initializing it to a dict if it is None
-        and raises an error if it is not a dict.
-        """
-        metadata = self._schema.get('metadata')
-        if metadata is None:
-            self._schema['metadata'] = metadata = CoreMetadata()
-        if not isinstance(metadata, dict):
-            raise TypeError(f'CoreSchema metadata should be a dict; got {metadata!r}.')
-        return metadata
-
-
-def build_metadata_dict(
-    *,  # force keyword arguments to make it easier to modify this signature in a backwards-compatible way
-    js_functions: list[GetJsonSchemaFunction] | None = None,
-    js_annotation_functions: list[GetJsonSchemaFunction] | None = None,
-    js_prefer_positional_arguments: bool | None = None,
-    typed_dict_cls: type[Any] | None = None,
-    initial_metadata: Any | None = None,
-) -> Any:
-    """Builds a dict to use as the metadata field of a CoreSchema object in a manner that is consistent
-    with the CoreMetadataHandler class.
-    """
-    if initial_metadata is not None and not isinstance(initial_metadata, dict):
-        raise TypeError(f'CoreSchema metadata should be a dict; got {initial_metadata!r}.')
-
-    metadata = CoreMetadata(
-        pydantic_js_functions=js_functions or [],
-        pydantic_js_annotation_functions=js_annotation_functions or [],
-        pydantic_js_prefer_positional_arguments=js_prefer_positional_arguments,
-        pydantic_typed_dict_cls=typed_dict_cls,
-    )
-    metadata = {k: v for k, v in metadata.items() if v is not None}
-
-    if initial_metadata is not None:
-        metadata = {**initial_metadata, **metadata}
-
-    return metadata
diff --git a/lib/pydantic/_internal/_core_utils.py b/lib/pydantic/_internal/_core_utils.py
deleted file mode 100644
index e74c74ac..00000000
--- a/lib/pydantic/_internal/_core_utils.py
+++ /dev/null
@@ -1,570 +0,0 @@
-from __future__ import annotations
-
-import os
-from collections import defaultdict
-from typing import (
-    Any,
-    Callable,
-    Hashable,
-    TypeVar,
-    Union,
-)
-
-from pydantic_core import CoreSchema, core_schema
-from pydantic_core import validate_core_schema as _validate_core_schema
-from typing_extensions import TypeAliasType, TypeGuard, get_args, get_origin
-
-from . import _repr
-from ._typing_extra import is_generic_alias
-
-AnyFunctionSchema = Union[
-    core_schema.AfterValidatorFunctionSchema,
-    core_schema.BeforeValidatorFunctionSchema,
-    core_schema.WrapValidatorFunctionSchema,
-    core_schema.PlainValidatorFunctionSchema,
-]
-
-
-FunctionSchemaWithInnerSchema = Union[
-    core_schema.AfterValidatorFunctionSchema,
-    core_schema.BeforeValidatorFunctionSchema,
-    core_schema.WrapValidatorFunctionSchema,
-]
-
-CoreSchemaField = Union[
-    core_schema.ModelField, core_schema.DataclassField, core_schema.TypedDictField, core_schema.ComputedField
-]
-CoreSchemaOrField = Union[core_schema.CoreSchema, CoreSchemaField]
-
-_CORE_SCHEMA_FIELD_TYPES = {'typed-dict-field', 'dataclass-field', 'model-field', 'computed-field'}
-_FUNCTION_WITH_INNER_SCHEMA_TYPES = {'function-before', 'function-after', 'function-wrap'}
-_LIST_LIKE_SCHEMA_WITH_ITEMS_TYPES = {'list', 'set', 'frozenset'}
-
-_DEFINITIONS_CACHE_METADATA_KEY = 'pydantic.definitions_cache'
-
-TAGGED_UNION_TAG_KEY = 'pydantic.internal.tagged_union_tag'
-"""
-Used in a `Tag` schema to specify the tag used for a discriminated union.
-"""
-HAS_INVALID_SCHEMAS_METADATA_KEY = 'pydantic.internal.invalid'
-"""Used to mark a schema that is invalid because it refers to a definition that was not yet defined when the
-schema was first encountered.
-"""
-
-
-def is_core_schema(
-    schema: CoreSchemaOrField,
-) -> TypeGuard[CoreSchema]:
-    return schema['type'] not in _CORE_SCHEMA_FIELD_TYPES
-
-
-def is_core_schema_field(
-    schema: CoreSchemaOrField,
-) -> TypeGuard[CoreSchemaField]:
-    return schema['type'] in _CORE_SCHEMA_FIELD_TYPES
-
-
-def is_function_with_inner_schema(
-    schema: CoreSchemaOrField,
-) -> TypeGuard[FunctionSchemaWithInnerSchema]:
-    return schema['type'] in _FUNCTION_WITH_INNER_SCHEMA_TYPES
-
-
-def is_list_like_schema_with_items_schema(
-    schema: CoreSchema,
-) -> TypeGuard[core_schema.ListSchema | core_schema.SetSchema | core_schema.FrozenSetSchema]:
-    return schema['type'] in _LIST_LIKE_SCHEMA_WITH_ITEMS_TYPES
-
-
-def get_type_ref(type_: type[Any], args_override: tuple[type[Any], ...] | None = None) -> str:
-    """Produces the ref to be used for this type by pydantic_core's core schemas.
-
-    This `args_override` argument was added for the purpose of creating valid recursive references
-    when creating generic models without needing to create a concrete class.
-    """
-    origin = get_origin(type_) or type_
-
-    args = get_args(type_) if is_generic_alias(type_) else (args_override or ())
-    generic_metadata = getattr(type_, '__pydantic_generic_metadata__', None)
-    if generic_metadata:
-        origin = generic_metadata['origin'] or origin
-        args = generic_metadata['args'] or args
-
-    module_name = getattr(origin, '__module__', '<No __module__>')
-    if isinstance(origin, TypeAliasType):
-        type_ref = f'{module_name}.{origin.__name__}:{id(origin)}'
-    else:
-        try:
-            qualname = getattr(origin, '__qualname__', f'<No __qualname__: {origin}>')
-        except Exception:
-            qualname = getattr(origin, '__qualname__', '<No __qualname__>')
-        type_ref = f'{module_name}.{qualname}:{id(origin)}'
-
-    arg_refs: list[str] = []
-    for arg in args:
-        if isinstance(arg, str):
-            # Handle string literals as a special case; we may be able to remove this special handling if we
-            # wrap them in a ForwardRef at some point.
-            arg_ref = f'{arg}:str-{id(arg)}'
-        else:
-            arg_ref = f'{_repr.display_as_type(arg)}:{id(arg)}'
-        arg_refs.append(arg_ref)
-    if arg_refs:
-        type_ref = f'{type_ref}[{",".join(arg_refs)}]'
-    return type_ref
-
-
-def get_ref(s: core_schema.CoreSchema) -> None | str:
-    """Get the ref from the schema if it has one.
-    This exists just for type checking to work correctly.
-    """
-    return s.get('ref', None)
-
-
-def collect_definitions(schema: core_schema.CoreSchema) -> dict[str, core_schema.CoreSchema]:
-    defs: dict[str, CoreSchema] = {}
-
-    def _record_valid_refs(s: core_schema.CoreSchema, recurse: Recurse) -> core_schema.CoreSchema:
-        ref = get_ref(s)
-        if ref:
-            defs[ref] = s
-        return recurse(s, _record_valid_refs)
-
-    walk_core_schema(schema, _record_valid_refs)
-
-    return defs
-
-
-def define_expected_missing_refs(
-    schema: core_schema.CoreSchema, allowed_missing_refs: set[str]
-) -> core_schema.CoreSchema | None:
-    if not allowed_missing_refs:
-        # in this case, there are no missing refs to potentially substitute, so there's no need to walk the schema
-        # this is a common case (will be hit for all non-generic models), so it's worth optimizing for
-        return None
-
-    refs = collect_definitions(schema).keys()
-
-    expected_missing_refs = allowed_missing_refs.difference(refs)
-    if expected_missing_refs:
-        definitions: list[core_schema.CoreSchema] = [
-            # TODO: Replace this with a (new) CoreSchema that, if present at any level, makes validation fail
-            #   Issue: https://github.com/pydantic/pydantic-core/issues/619
-            core_schema.none_schema(ref=ref, metadata={HAS_INVALID_SCHEMAS_METADATA_KEY: True})
-            for ref in expected_missing_refs
-        ]
-        return core_schema.definitions_schema(schema, definitions)
-    return None
-
-
-def collect_invalid_schemas(schema: core_schema.CoreSchema) -> bool:
-    invalid = False
-
-    def _is_schema_valid(s: core_schema.CoreSchema, recurse: Recurse) -> core_schema.CoreSchema:
-        nonlocal invalid
-        if 'metadata' in s:
-            metadata = s['metadata']
-            if HAS_INVALID_SCHEMAS_METADATA_KEY in metadata:
-                invalid = metadata[HAS_INVALID_SCHEMAS_METADATA_KEY]
-                return s
-        return recurse(s, _is_schema_valid)
-
-    walk_core_schema(schema, _is_schema_valid)
-    return invalid
-
-
-T = TypeVar('T')
-
-
-Recurse = Callable[[core_schema.CoreSchema, 'Walk'], core_schema.CoreSchema]
-Walk = Callable[[core_schema.CoreSchema, Recurse], core_schema.CoreSchema]
-
-# TODO: Should we move _WalkCoreSchema into pydantic_core proper?
-#   Issue: https://github.com/pydantic/pydantic-core/issues/615
-
-
-class _WalkCoreSchema:
-    def __init__(self):
-        self._schema_type_to_method = self._build_schema_type_to_method()
-
-    def _build_schema_type_to_method(self) -> dict[core_schema.CoreSchemaType, Recurse]:
-        mapping: dict[core_schema.CoreSchemaType, Recurse] = {}
-        key: core_schema.CoreSchemaType
-        for key in get_args(core_schema.CoreSchemaType):
-            method_name = f"handle_{key.replace('-', '_')}_schema"
-            mapping[key] = getattr(self, method_name, self._handle_other_schemas)
-        return mapping
-
-    def walk(self, schema: core_schema.CoreSchema, f: Walk) -> core_schema.CoreSchema:
-        return f(schema, self._walk)
-
-    def _walk(self, schema: core_schema.CoreSchema, f: Walk) -> core_schema.CoreSchema:
-        schema = self._schema_type_to_method[schema['type']](schema.copy(), f)
-        ser_schema: core_schema.SerSchema | None = schema.get('serialization')  # type: ignore
-        if ser_schema:
-            schema['serialization'] = self._handle_ser_schemas(ser_schema, f)
-        return schema
-
-    def _handle_other_schemas(self, schema: core_schema.CoreSchema, f: Walk) -> core_schema.CoreSchema:
-        sub_schema = schema.get('schema', None)
-        if sub_schema is not None:
-            schema['schema'] = self.walk(sub_schema, f)  # type: ignore
-        return schema
-
-    def _handle_ser_schemas(self, ser_schema: core_schema.SerSchema, f: Walk) -> core_schema.SerSchema:
-        schema: core_schema.CoreSchema | None = ser_schema.get('schema', None)
-        if schema is not None:
-            ser_schema['schema'] = self.walk(schema, f)  # type: ignore
-        return_schema: core_schema.CoreSchema | None = ser_schema.get('return_schema', None)
-        if return_schema is not None:
-            ser_schema['return_schema'] = self.walk(return_schema, f)  # type: ignore
-        return ser_schema
-
-    def handle_definitions_schema(self, schema: core_schema.DefinitionsSchema, f: Walk) -> core_schema.CoreSchema:
-        new_definitions: list[core_schema.CoreSchema] = []
-        for definition in schema['definitions']:
-            if 'schema_ref' in definition and 'ref' in definition:
-                # This indicates a purposely indirect reference
-                # We want to keep such references around for implications related to JSON schema, etc.:
-                new_definitions.append(definition)
-                # However, we still need to walk the referenced definition:
-                self.walk(definition, f)
-                continue
-
-            updated_definition = self.walk(definition, f)
-            if 'ref' in updated_definition:
-                # If the updated definition schema doesn't have a 'ref', it shouldn't go in the definitions
-                # This is most likely to happen due to replacing something with a definition reference, in
-                # which case it should certainly not go in the definitions list
-                new_definitions.append(updated_definition)
-        new_inner_schema = self.walk(schema['schema'], f)
-
-        if not new_definitions and len(schema) == 3:
-            # This means we'd be returning a "trivial" definitions schema that just wrapped the inner schema
-            return new_inner_schema
-
-        new_schema = schema.copy()
-        new_schema['schema'] = new_inner_schema
-        new_schema['definitions'] = new_definitions
-        return new_schema
-
-    def handle_list_schema(self, schema: core_schema.ListSchema, f: Walk) -> core_schema.CoreSchema:
-        items_schema = schema.get('items_schema')
-        if items_schema is not None:
-            schema['items_schema'] = self.walk(items_schema, f)
-        return schema
-
-    def handle_set_schema(self, schema: core_schema.SetSchema, f: Walk) -> core_schema.CoreSchema:
-        items_schema = schema.get('items_schema')
-        if items_schema is not None:
-            schema['items_schema'] = self.walk(items_schema, f)
-        return schema
-
-    def handle_frozenset_schema(self, schema: core_schema.FrozenSetSchema, f: Walk) -> core_schema.CoreSchema:
-        items_schema = schema.get('items_schema')
-        if items_schema is not None:
-            schema['items_schema'] = self.walk(items_schema, f)
-        return schema
-
-    def handle_generator_schema(self, schema: core_schema.GeneratorSchema, f: Walk) -> core_schema.CoreSchema:
-        items_schema = schema.get('items_schema')
-        if items_schema is not None:
-            schema['items_schema'] = self.walk(items_schema, f)
-        return schema
-
-    def handle_tuple_schema(self, schema: core_schema.TupleSchema, f: Walk) -> core_schema.CoreSchema:
-        schema['items_schema'] = [self.walk(v, f) for v in schema['items_schema']]
-        return schema
-
-    def handle_dict_schema(self, schema: core_schema.DictSchema, f: Walk) -> core_schema.CoreSchema:
-        keys_schema = schema.get('keys_schema')
-        if keys_schema is not None:
-            schema['keys_schema'] = self.walk(keys_schema, f)
-        values_schema = schema.get('values_schema')
-        if values_schema:
-            schema['values_schema'] = self.walk(values_schema, f)
-        return schema
-
-    def handle_function_schema(self, schema: AnyFunctionSchema, f: Walk) -> core_schema.CoreSchema:
-        if not is_function_with_inner_schema(schema):
-            return schema
-        schema['schema'] = self.walk(schema['schema'], f)
-        return schema
-
-    def handle_union_schema(self, schema: core_schema.UnionSchema, f: Walk) -> core_schema.CoreSchema:
-        new_choices: list[CoreSchema | tuple[CoreSchema, str]] = []
-        for v in schema['choices']:
-            if isinstance(v, tuple):
-                new_choices.append((self.walk(v[0], f), v[1]))
-            else:
-                new_choices.append(self.walk(v, f))
-        schema['choices'] = new_choices
-        return schema
-
-    def handle_tagged_union_schema(self, schema: core_schema.TaggedUnionSchema, f: Walk) -> core_schema.CoreSchema:
-        new_choices: dict[Hashable, core_schema.CoreSchema] = {}
-        for k, v in schema['choices'].items():
-            new_choices[k] = v if isinstance(v, (str, int)) else self.walk(v, f)
-        schema['choices'] = new_choices
-        return schema
-
-    def handle_chain_schema(self, schema: core_schema.ChainSchema, f: Walk) -> core_schema.CoreSchema:
-        schema['steps'] = [self.walk(v, f) for v in schema['steps']]
-        return schema
-
-    def handle_lax_or_strict_schema(self, schema: core_schema.LaxOrStrictSchema, f: Walk) -> core_schema.CoreSchema:
-        schema['lax_schema'] = self.walk(schema['lax_schema'], f)
-        schema['strict_schema'] = self.walk(schema['strict_schema'], f)
-        return schema
-
-    def handle_json_or_python_schema(self, schema: core_schema.JsonOrPythonSchema, f: Walk) -> core_schema.CoreSchema:
-        schema['json_schema'] = self.walk(schema['json_schema'], f)
-        schema['python_schema'] = self.walk(schema['python_schema'], f)
-        return schema
-
-    def handle_model_fields_schema(self, schema: core_schema.ModelFieldsSchema, f: Walk) -> core_schema.CoreSchema:
-        extras_schema = schema.get('extras_schema')
-        if extras_schema is not None:
-            schema['extras_schema'] = self.walk(extras_schema, f)
-        replaced_fields: dict[str, core_schema.ModelField] = {}
-        replaced_computed_fields: list[core_schema.ComputedField] = []
-        for computed_field in schema.get('computed_fields', ()):
-            replaced_field = computed_field.copy()
-            replaced_field['return_schema'] = self.walk(computed_field['return_schema'], f)
-            replaced_computed_fields.append(replaced_field)
-        if replaced_computed_fields:
-            schema['computed_fields'] = replaced_computed_fields
-        for k, v in schema['fields'].items():
-            replaced_field = v.copy()
-            replaced_field['schema'] = self.walk(v['schema'], f)
-            replaced_fields[k] = replaced_field
-        schema['fields'] = replaced_fields
-        return schema
-
-    def handle_typed_dict_schema(self, schema: core_schema.TypedDictSchema, f: Walk) -> core_schema.CoreSchema:
-        extras_schema = schema.get('extras_schema')
-        if extras_schema is not None:
-            schema['extras_schema'] = self.walk(extras_schema, f)
-        replaced_computed_fields: list[core_schema.ComputedField] = []
-        for computed_field in schema.get('computed_fields', ()):
-            replaced_field = computed_field.copy()
-            replaced_field['return_schema'] = self.walk(computed_field['return_schema'], f)
-            replaced_computed_fields.append(replaced_field)
-        if replaced_computed_fields:
-            schema['computed_fields'] = replaced_computed_fields
-        replaced_fields: dict[str, core_schema.TypedDictField] = {}
-        for k, v in schema['fields'].items():
-            replaced_field = v.copy()
-            replaced_field['schema'] = self.walk(v['schema'], f)
-            replaced_fields[k] = replaced_field
-        schema['fields'] = replaced_fields
-        return schema
-
-    def handle_dataclass_args_schema(self, schema: core_schema.DataclassArgsSchema, f: Walk) -> core_schema.CoreSchema:
-        replaced_fields: list[core_schema.DataclassField] = []
-        replaced_computed_fields: list[core_schema.ComputedField] = []
-        for computed_field in schema.get('computed_fields', ()):
-            replaced_field = computed_field.copy()
-            replaced_field['return_schema'] = self.walk(computed_field['return_schema'], f)
-            replaced_computed_fields.append(replaced_field)
-        if replaced_computed_fields:
-            schema['computed_fields'] = replaced_computed_fields
-        for field in schema['fields']:
-            replaced_field = field.copy()
-            replaced_field['schema'] = self.walk(field['schema'], f)
-            replaced_fields.append(replaced_field)
-        schema['fields'] = replaced_fields
-        return schema
-
-    def handle_arguments_schema(self, schema: core_schema.ArgumentsSchema, f: Walk) -> core_schema.CoreSchema:
-        replaced_arguments_schema: list[core_schema.ArgumentsParameter] = []
-        for param in schema['arguments_schema']:
-            replaced_param = param.copy()
-            replaced_param['schema'] = self.walk(param['schema'], f)
-            replaced_arguments_schema.append(replaced_param)
-        schema['arguments_schema'] = replaced_arguments_schema
-        if 'var_args_schema' in schema:
-            schema['var_args_schema'] = self.walk(schema['var_args_schema'], f)
-        if 'var_kwargs_schema' in schema:
-            schema['var_kwargs_schema'] = self.walk(schema['var_kwargs_schema'], f)
-        return schema
-
-    def handle_call_schema(self, schema: core_schema.CallSchema, f: Walk) -> core_schema.CoreSchema:
-        schema['arguments_schema'] = self.walk(schema['arguments_schema'], f)
-        if 'return_schema' in schema:
-            schema['return_schema'] = self.walk(schema['return_schema'], f)
-        return schema
-
-
-_dispatch = _WalkCoreSchema().walk
-
-
-def walk_core_schema(schema: core_schema.CoreSchema, f: Walk) -> core_schema.CoreSchema:
-    """Recursively traverse a CoreSchema.
-
-    Args:
-        schema (core_schema.CoreSchema): The CoreSchema to process, it will not be modified.
-        f (Walk): A function to apply. This function takes two arguments:
-          1. The current CoreSchema that is being processed
-             (not the same one you passed into this function, one level down).
-          2. The "next" `f` to call. This lets you for example use `f=functools.partial(some_method, some_context)`
-             to pass data down the recursive calls without using globals or other mutable state.
-
-    Returns:
-        core_schema.CoreSchema: A processed CoreSchema.
-    """
-    return f(schema.copy(), _dispatch)
-
-
-def simplify_schema_references(schema: core_schema.CoreSchema) -> core_schema.CoreSchema:  # noqa: C901
-    definitions: dict[str, core_schema.CoreSchema] = {}
-    ref_counts: dict[str, int] = defaultdict(int)
-    involved_in_recursion: dict[str, bool] = {}
-    current_recursion_ref_count: dict[str, int] = defaultdict(int)
-
-    def collect_refs(s: core_schema.CoreSchema, recurse: Recurse) -> core_schema.CoreSchema:
-        if s['type'] == 'definitions':
-            for definition in s['definitions']:
-                ref = get_ref(definition)
-                assert ref is not None
-                if ref not in definitions:
-                    definitions[ref] = definition
-                recurse(definition, collect_refs)
-            return recurse(s['schema'], collect_refs)
-        else:
-            ref = get_ref(s)
-            if ref is not None:
-                new = recurse(s, collect_refs)
-                new_ref = get_ref(new)
-                if new_ref:
-                    definitions[new_ref] = new
-                return core_schema.definition_reference_schema(schema_ref=ref)
-            else:
-                return recurse(s, collect_refs)
-
-    schema = walk_core_schema(schema, collect_refs)
-
-    def count_refs(s: core_schema.CoreSchema, recurse: Recurse) -> core_schema.CoreSchema:
-        if s['type'] != 'definition-ref':
-            return recurse(s, count_refs)
-        ref = s['schema_ref']
-        ref_counts[ref] += 1
-
-        if ref_counts[ref] >= 2:
-            # If this model is involved in a recursion this should be detected
-            # on its second encounter, we can safely stop the walk here.
-            if current_recursion_ref_count[ref] != 0:
-                involved_in_recursion[ref] = True
-            return s
-
-        current_recursion_ref_count[ref] += 1
-        recurse(definitions[ref], count_refs)
-        current_recursion_ref_count[ref] -= 1
-        return s
-
-    schema = walk_core_schema(schema, count_refs)
-
-    assert all(c == 0 for c in current_recursion_ref_count.values()), 'this is a bug! please report it'
-
-    def can_be_inlined(s: core_schema.DefinitionReferenceSchema, ref: str) -> bool:
-        if ref_counts[ref] > 1:
-            return False
-        if involved_in_recursion.get(ref, False):
-            return False
-        if 'serialization' in s:
-            return False
-        if 'metadata' in s:
-            metadata = s['metadata']
-            for k in (
-                'pydantic_js_functions',
-                'pydantic_js_annotation_functions',
-                'pydantic.internal.union_discriminator',
-            ):
-                if k in metadata:
-                    # we need to keep this as a ref
-                    return False
-        return True
-
-    def inline_refs(s: core_schema.CoreSchema, recurse: Recurse) -> core_schema.CoreSchema:
-        if s['type'] == 'definition-ref':
-            ref = s['schema_ref']
-            # Check if the reference is only used once, not involved in recursion and does not have
-            # any extra keys (like 'serialization')
-            if can_be_inlined(s, ref):
-                # Inline the reference by replacing the reference with the actual schema
-                new = definitions.pop(ref)
-                ref_counts[ref] -= 1  # because we just replaced it!
-                # put all other keys that were on the def-ref schema into the inlined version
-                # in particular this is needed for `serialization`
-                if 'serialization' in s:
-                    new['serialization'] = s['serialization']
-                s = recurse(new, inline_refs)
-                return s
-            else:
-                return recurse(s, inline_refs)
-        else:
-            return recurse(s, inline_refs)
-
-    schema = walk_core_schema(schema, inline_refs)
-
-    def_values = [v for v in definitions.values() if ref_counts[v['ref']] > 0]  # type: ignore
-
-    if def_values:
-        schema = core_schema.definitions_schema(schema=schema, definitions=def_values)
-    return schema
-
-
-def _strip_metadata(schema: CoreSchema) -> CoreSchema:
-    def strip_metadata(s: CoreSchema, recurse: Recurse) -> CoreSchema:
-        s = s.copy()
-        s.pop('metadata', None)
-        if s['type'] == 'model-fields':
-            s = s.copy()
-            s['fields'] = {k: v.copy() for k, v in s['fields'].items()}
-            for field_name, field_schema in s['fields'].items():
-                field_schema.pop('metadata', None)
-                s['fields'][field_name] = field_schema
-            computed_fields = s.get('computed_fields', None)
-            if computed_fields:
-                s['computed_fields'] = [cf.copy() for cf in computed_fields]
-                for cf in computed_fields:
-                    cf.pop('metadata', None)
-            else:
-                s.pop('computed_fields', None)
-        elif s['type'] == 'model':
-            # remove some defaults
-            if s.get('custom_init', True) is False:
-                s.pop('custom_init')
-            if s.get('root_model', True) is False:
-                s.pop('root_model')
-            if {'title'}.issuperset(s.get('config', {}).keys()):
-                s.pop('config', None)
-
-        return recurse(s, strip_metadata)
-
-    return walk_core_schema(schema, strip_metadata)
-
-
-def pretty_print_core_schema(
-    schema: CoreSchema,
-    include_metadata: bool = False,
-) -> None:
-    """Pretty print a CoreSchema using rich.
-    This is intended for debugging purposes.
-
-    Args:
-        schema: The CoreSchema to print.
-        include_metadata: Whether to include metadata in the output. Defaults to `False`.
-    """
-    from rich import print  # type: ignore  # install it manually in your dev env
-
-    if not include_metadata:
-        schema = _strip_metadata(schema)
-
-    return print(schema)
-
-
-def validate_core_schema(schema: CoreSchema) -> CoreSchema:
-    if 'PYDANTIC_SKIP_VALIDATING_CORE_SCHEMAS' in os.environ:
-        return schema
-    return _validate_core_schema(schema)
diff --git a/lib/pydantic/_internal/_dataclasses.py b/lib/pydantic/_internal/_dataclasses.py
deleted file mode 100644
index 1ec23044..00000000
--- a/lib/pydantic/_internal/_dataclasses.py
+++ /dev/null
@@ -1,225 +0,0 @@
-"""Private logic for creating pydantic dataclasses."""
-from __future__ import annotations as _annotations
-
-import dataclasses
-import typing
-import warnings
-from functools import partial, wraps
-from typing import Any, Callable, ClassVar
-
-from pydantic_core import (
-    ArgsKwargs,
-    SchemaSerializer,
-    SchemaValidator,
-    core_schema,
-)
-from typing_extensions import TypeGuard
-
-from ..errors import PydanticUndefinedAnnotation
-from ..fields import FieldInfo
-from ..plugin._schema_validator import create_schema_validator
-from ..warnings import PydanticDeprecatedSince20
-from . import _config, _decorators, _typing_extra
-from ._fields import collect_dataclass_fields
-from ._generate_schema import GenerateSchema
-from ._generics import get_standard_typevars_map
-from ._mock_val_ser import set_dataclass_mocks
-from ._schema_generation_shared import CallbackGetCoreSchemaHandler
-from ._signature import generate_pydantic_signature
-
-if typing.TYPE_CHECKING:
-    from ..config import ConfigDict
-
-    class StandardDataclass(typing.Protocol):
-        __dataclass_fields__: ClassVar[dict[str, Any]]
-        __dataclass_params__: ClassVar[Any]  # in reality `dataclasses._DataclassParams`
-        __post_init__: ClassVar[Callable[..., None]]
-
-        def __init__(self, *args: object, **kwargs: object) -> None:
-            pass
-
-    class PydanticDataclass(StandardDataclass, typing.Protocol):
-        """A protocol containing attributes only available once a class has been decorated as a Pydantic dataclass.
-
-        Attributes:
-            __pydantic_config__: Pydantic-specific configuration settings for the dataclass.
-            __pydantic_complete__: Whether dataclass building is completed, or if there are still undefined fields.
-            __pydantic_core_schema__: The pydantic-core schema used to build the SchemaValidator and SchemaSerializer.
-            __pydantic_decorators__: Metadata containing the decorators defined on the dataclass.
-            __pydantic_fields__: Metadata about the fields defined on the dataclass.
-            __pydantic_serializer__: The pydantic-core SchemaSerializer used to dump instances of the dataclass.
-            __pydantic_validator__: The pydantic-core SchemaValidator used to validate instances of the dataclass.
-        """
-
-        __pydantic_config__: ClassVar[ConfigDict]
-        __pydantic_complete__: ClassVar[bool]
-        __pydantic_core_schema__: ClassVar[core_schema.CoreSchema]
-        __pydantic_decorators__: ClassVar[_decorators.DecoratorInfos]
-        __pydantic_fields__: ClassVar[dict[str, FieldInfo]]
-        __pydantic_serializer__: ClassVar[SchemaSerializer]
-        __pydantic_validator__: ClassVar[SchemaValidator]
-
-else:
-    # See PyCharm issues https://youtrack.jetbrains.com/issue/PY-21915
-    # and https://youtrack.jetbrains.com/issue/PY-51428
-    DeprecationWarning = PydanticDeprecatedSince20
-
-
-def set_dataclass_fields(cls: type[StandardDataclass], types_namespace: dict[str, Any] | None = None) -> None:
-    """Collect and set `cls.__pydantic_fields__`.
-
-    Args:
-        cls: The class.
-        types_namespace: The types namespace, defaults to `None`.
-    """
-    typevars_map = get_standard_typevars_map(cls)
-    fields = collect_dataclass_fields(cls, types_namespace, typevars_map=typevars_map)
-
-    cls.__pydantic_fields__ = fields  # type: ignore
-
-
-def complete_dataclass(
-    cls: type[Any],
-    config_wrapper: _config.ConfigWrapper,
-    *,
-    raise_errors: bool = True,
-    types_namespace: dict[str, Any] | None,
-) -> bool:
-    """Finish building a pydantic dataclass.
-
-    This logic is called on a class which has already been wrapped in `dataclasses.dataclass()`.
-
-    This is somewhat analogous to `pydantic._internal._model_construction.complete_model_class`.
-
-    Args:
-        cls: The class.
-        config_wrapper: The config wrapper instance.
-        raise_errors: Whether to raise errors, defaults to `True`.
-        types_namespace: The types namespace.
-
-    Returns:
-        `True` if building a pydantic dataclass is successfully completed, `False` otherwise.
-
-    Raises:
-        PydanticUndefinedAnnotation: If `raise_error` is `True` and there is an undefined annotations.
-    """
-    if hasattr(cls, '__post_init_post_parse__'):
-        warnings.warn(
-            'Support for `__post_init_post_parse__` has been dropped, the method will not be called', DeprecationWarning
-        )
-
-    if types_namespace is None:
-        types_namespace = _typing_extra.get_cls_types_namespace(cls)
-
-    set_dataclass_fields(cls, types_namespace)
-
-    typevars_map = get_standard_typevars_map(cls)
-    gen_schema = GenerateSchema(
-        config_wrapper,
-        types_namespace,
-        typevars_map,
-    )
-
-    # This needs to be called before we change the __init__
-    sig = generate_pydantic_signature(
-        init=cls.__init__,
-        fields=cls.__pydantic_fields__,  # type: ignore
-        config_wrapper=config_wrapper,
-        is_dataclass=True,
-    )
-
-    # dataclass.__init__ must be defined here so its `__qualname__` can be changed since functions can't be copied.
-    def __init__(__dataclass_self__: PydanticDataclass, *args: Any, **kwargs: Any) -> None:
-        __tracebackhide__ = True
-        s = __dataclass_self__
-        s.__pydantic_validator__.validate_python(ArgsKwargs(args, kwargs), self_instance=s)
-
-    __init__.__qualname__ = f'{cls.__qualname__}.__init__'
-
-    cls.__init__ = __init__  # type: ignore
-    cls.__pydantic_config__ = config_wrapper.config_dict  # type: ignore
-    cls.__signature__ = sig  # type: ignore
-    get_core_schema = getattr(cls, '__get_pydantic_core_schema__', None)
-    try:
-        if get_core_schema:
-            schema = get_core_schema(
-                cls,
-                CallbackGetCoreSchemaHandler(
-                    partial(gen_schema.generate_schema, from_dunder_get_core_schema=False),
-                    gen_schema,
-                    ref_mode='unpack',
-                ),
-            )
-        else:
-            schema = gen_schema.generate_schema(cls, from_dunder_get_core_schema=False)
-    except PydanticUndefinedAnnotation as e:
-        if raise_errors:
-            raise
-        set_dataclass_mocks(cls, cls.__name__, f'`{e.name}`')
-        return False
-
-    core_config = config_wrapper.core_config(cls)
-
-    try:
-        schema = gen_schema.clean_schema(schema)
-    except gen_schema.CollectedInvalid:
-        set_dataclass_mocks(cls, cls.__name__, 'all referenced types')
-        return False
-
-    # We are about to set all the remaining required properties expected for this cast;
-    # __pydantic_decorators__ and __pydantic_fields__ should already be set
-    cls = typing.cast('type[PydanticDataclass]', cls)
-    # debug(schema)
-
-    cls.__pydantic_core_schema__ = schema
-    cls.__pydantic_validator__ = validator = create_schema_validator(
-        schema, cls, cls.__module__, cls.__qualname__, 'dataclass', core_config, config_wrapper.plugin_settings
-    )
-    cls.__pydantic_serializer__ = SchemaSerializer(schema, core_config)
-
-    if config_wrapper.validate_assignment:
-
-        @wraps(cls.__setattr__)
-        def validated_setattr(instance: Any, __field: str, __value: str) -> None:
-            validator.validate_assignment(instance, __field, __value)
-
-        cls.__setattr__ = validated_setattr.__get__(None, cls)  # type: ignore
-
-    return True
-
-
-def is_builtin_dataclass(_cls: type[Any]) -> TypeGuard[type[StandardDataclass]]:
-    """Returns True if a class is a stdlib dataclass and *not* a pydantic dataclass.
-
-    We check that
-    - `_cls` is a dataclass
-    - `_cls` does not inherit from a processed pydantic dataclass (and thus have a `__pydantic_validator__`)
-    - `_cls` does not have any annotations that are not dataclass fields
-    e.g.
-    ```py
-    import dataclasses
-
-    import pydantic.dataclasses
-
-    @dataclasses.dataclass
-    class A:
-        x: int
-
-    @pydantic.dataclasses.dataclass
-    class B(A):
-        y: int
-    ```
-    In this case, when we first check `B`, we make an extra check and look at the annotations ('y'),
-    which won't be a superset of all the dataclass fields (only the stdlib fields i.e. 'x')
-
-    Args:
-        cls: The class.
-
-    Returns:
-        `True` if the class is a stdlib dataclass, `False` otherwise.
-    """
-    return (
-        dataclasses.is_dataclass(_cls)
-        and not hasattr(_cls, '__pydantic_validator__')
-        and set(_cls.__dataclass_fields__).issuperset(set(getattr(_cls, '__annotations__', {})))
-    )
diff --git a/lib/pydantic/_internal/_decorators.py b/lib/pydantic/_internal/_decorators.py
deleted file mode 100644
index 5672464c..00000000
--- a/lib/pydantic/_internal/_decorators.py
+++ /dev/null
@@ -1,791 +0,0 @@
-"""Logic related to validators applied to models etc. via the `@field_validator` and `@model_validator` decorators."""
-from __future__ import annotations as _annotations
-
-from collections import deque
-from dataclasses import dataclass, field
-from functools import cached_property, partial, partialmethod
-from inspect import Parameter, Signature, isdatadescriptor, ismethoddescriptor, signature
-from itertools import islice
-from typing import TYPE_CHECKING, Any, Callable, ClassVar, Generic, Iterable, TypeVar, Union
-
-from pydantic_core import PydanticUndefined, core_schema
-from typing_extensions import Literal, TypeAlias, is_typeddict
-
-from ..errors import PydanticUserError
-from ._core_utils import get_type_ref
-from ._internal_dataclass import slots_true
-from ._typing_extra import get_function_type_hints
-
-if TYPE_CHECKING:
-    from ..fields import ComputedFieldInfo
-    from ..functional_validators import FieldValidatorModes
-
-
-@dataclass(**slots_true)
-class ValidatorDecoratorInfo:
-    """A container for data from `@validator` so that we can access it
-    while building the pydantic-core schema.
-
-    Attributes:
-        decorator_repr: A class variable representing the decorator string, '@validator'.
-        fields: A tuple of field names the validator should be called on.
-        mode: The proposed validator mode.
-        each_item: For complex objects (sets, lists etc.) whether to validate individual
-            elements rather than the whole object.
-        always: Whether this method and other validators should be called even if the value is missing.
-        check_fields: Whether to check that the fields actually exist on the model.
-    """
-
-    decorator_repr: ClassVar[str] = '@validator'
-
-    fields: tuple[str, ...]
-    mode: Literal['before', 'after']
-    each_item: bool
-    always: bool
-    check_fields: bool | None
-
-
-@dataclass(**slots_true)
-class FieldValidatorDecoratorInfo:
-    """A container for data from `@field_validator` so that we can access it
-    while building the pydantic-core schema.
-
-    Attributes:
-        decorator_repr: A class variable representing the decorator string, '@field_validator'.
-        fields: A tuple of field names the validator should be called on.
-        mode: The proposed validator mode.
-        check_fields: Whether to check that the fields actually exist on the model.
-    """
-
-    decorator_repr: ClassVar[str] = '@field_validator'
-
-    fields: tuple[str, ...]
-    mode: FieldValidatorModes
-    check_fields: bool | None
-
-
-@dataclass(**slots_true)
-class RootValidatorDecoratorInfo:
-    """A container for data from `@root_validator` so that we can access it
-    while building the pydantic-core schema.
-
-    Attributes:
-        decorator_repr: A class variable representing the decorator string, '@root_validator'.
-        mode: The proposed validator mode.
-    """
-
-    decorator_repr: ClassVar[str] = '@root_validator'
-    mode: Literal['before', 'after']
-
-
-@dataclass(**slots_true)
-class FieldSerializerDecoratorInfo:
-    """A container for data from `@field_serializer` so that we can access it
-    while building the pydantic-core schema.
-
-    Attributes:
-        decorator_repr: A class variable representing the decorator string, '@field_serializer'.
-        fields: A tuple of field names the serializer should be called on.
-        mode: The proposed serializer mode.
-        return_type: The type of the serializer's return value.
-        when_used: The serialization condition. Accepts a string with values `'always'`, `'unless-none'`, `'json'`,
-            and `'json-unless-none'`.
-        check_fields: Whether to check that the fields actually exist on the model.
-    """
-
-    decorator_repr: ClassVar[str] = '@field_serializer'
-    fields: tuple[str, ...]
-    mode: Literal['plain', 'wrap']
-    return_type: Any
-    when_used: core_schema.WhenUsed
-    check_fields: bool | None
-
-
-@dataclass(**slots_true)
-class ModelSerializerDecoratorInfo:
-    """A container for data from `@model_serializer` so that we can access it
-    while building the pydantic-core schema.
-
-    Attributes:
-        decorator_repr: A class variable representing the decorator string, '@model_serializer'.
-        mode: The proposed serializer mode.
-        return_type: The type of the serializer's return value.
-        when_used: The serialization condition. Accepts a string with values `'always'`, `'unless-none'`, `'json'`,
-            and `'json-unless-none'`.
-    """
-
-    decorator_repr: ClassVar[str] = '@model_serializer'
-    mode: Literal['plain', 'wrap']
-    return_type: Any
-    when_used: core_schema.WhenUsed
-
-
-@dataclass(**slots_true)
-class ModelValidatorDecoratorInfo:
-    """A container for data from `@model_validator` so that we can access it
-    while building the pydantic-core schema.
-
-    Attributes:
-        decorator_repr: A class variable representing the decorator string, '@model_serializer'.
-        mode: The proposed serializer mode.
-    """
-
-    decorator_repr: ClassVar[str] = '@model_validator'
-    mode: Literal['wrap', 'before', 'after']
-
-
-DecoratorInfo: TypeAlias = """Union[
-    ValidatorDecoratorInfo,
-    FieldValidatorDecoratorInfo,
-    RootValidatorDecoratorInfo,
-    FieldSerializerDecoratorInfo,
-    ModelSerializerDecoratorInfo,
-    ModelValidatorDecoratorInfo,
-    ComputedFieldInfo,
-]"""
-
-ReturnType = TypeVar('ReturnType')
-DecoratedType: TypeAlias = (
-    'Union[classmethod[Any, Any, ReturnType], staticmethod[Any, ReturnType], Callable[..., ReturnType], property]'
-)
-
-
-@dataclass  # can't use slots here since we set attributes on `__post_init__`
-class PydanticDescriptorProxy(Generic[ReturnType]):
-    """Wrap a classmethod, staticmethod, property or unbound function
-    and act as a descriptor that allows us to detect decorated items
-    from the class' attributes.
-
-    This class' __get__ returns the wrapped item's __get__ result,
-    which makes it transparent for classmethods and staticmethods.
-
-    Attributes:
-        wrapped: The decorator that has to be wrapped.
-        decorator_info: The decorator info.
-        shim: A wrapper function to wrap V1 style function.
-    """
-
-    wrapped: DecoratedType[ReturnType]
-    decorator_info: DecoratorInfo
-    shim: Callable[[Callable[..., Any]], Callable[..., Any]] | None = None
-
-    def __post_init__(self):
-        for attr in 'setter', 'deleter':
-            if hasattr(self.wrapped, attr):
-                f = partial(self._call_wrapped_attr, name=attr)
-                setattr(self, attr, f)
-
-    def _call_wrapped_attr(self, func: Callable[[Any], None], *, name: str) -> PydanticDescriptorProxy[ReturnType]:
-        self.wrapped = getattr(self.wrapped, name)(func)
-        return self
-
-    def __get__(self, obj: object | None, obj_type: type[object] | None = None) -> PydanticDescriptorProxy[ReturnType]:
-        try:
-            return self.wrapped.__get__(obj, obj_type)
-        except AttributeError:
-            # not a descriptor, e.g. a partial object
-            return self.wrapped  # type: ignore[return-value]
-
-    def __set_name__(self, instance: Any, name: str) -> None:
-        if hasattr(self.wrapped, '__set_name__'):
-            self.wrapped.__set_name__(instance, name)  # pyright: ignore[reportFunctionMemberAccess]
-
-    def __getattr__(self, __name: str) -> Any:
-        """Forward checks for __isabstractmethod__ and such."""
-        return getattr(self.wrapped, __name)
-
-
-DecoratorInfoType = TypeVar('DecoratorInfoType', bound=DecoratorInfo)
-
-
-@dataclass(**slots_true)
-class Decorator(Generic[DecoratorInfoType]):
-    """A generic container class to join together the decorator metadata
-    (metadata from decorator itself, which we have when the
-    decorator is called but not when we are building the core-schema)
-    and the bound function (which we have after the class itself is created).
-
-    Attributes:
-        cls_ref: The class ref.
-        cls_var_name: The decorated function name.
-        func: The decorated function.
-        shim: A wrapper function to wrap V1 style function.
-        info: The decorator info.
-    """
-
-    cls_ref: str
-    cls_var_name: str
-    func: Callable[..., Any]
-    shim: Callable[[Any], Any] | None
-    info: DecoratorInfoType
-
-    @staticmethod
-    def build(
-        cls_: Any,
-        *,
-        cls_var_name: str,
-        shim: Callable[[Any], Any] | None,
-        info: DecoratorInfoType,
-    ) -> Decorator[DecoratorInfoType]:
-        """Build a new decorator.
-
-        Args:
-            cls_: The class.
-            cls_var_name: The decorated function name.
-            shim: A wrapper function to wrap V1 style function.
-            info: The decorator info.
-
-        Returns:
-            The new decorator instance.
-        """
-        func = get_attribute_from_bases(cls_, cls_var_name)
-        if shim is not None:
-            func = shim(func)
-        func = unwrap_wrapped_function(func, unwrap_partial=False)
-        if not callable(func):
-            # This branch will get hit for classmethod properties
-            attribute = get_attribute_from_base_dicts(cls_, cls_var_name)  # prevents the binding call to `__get__`
-            if isinstance(attribute, PydanticDescriptorProxy):
-                func = unwrap_wrapped_function(attribute.wrapped)
-        return Decorator(
-            cls_ref=get_type_ref(cls_),
-            cls_var_name=cls_var_name,
-            func=func,
-            shim=shim,
-            info=info,
-        )
-
-    def bind_to_cls(self, cls: Any) -> Decorator[DecoratorInfoType]:
-        """Bind the decorator to a class.
-
-        Args:
-            cls: the class.
-
-        Returns:
-            The new decorator instance.
-        """
-        return self.build(
-            cls,
-            cls_var_name=self.cls_var_name,
-            shim=self.shim,
-            info=self.info,
-        )
-
-
-def get_bases(tp: type[Any]) -> tuple[type[Any], ...]:
-    """Get the base classes of a class or typeddict.
-
-    Args:
-        tp: The type or class to get the bases.
-
-    Returns:
-        The base classes.
-    """
-    if is_typeddict(tp):
-        return tp.__orig_bases__  # type: ignore
-    try:
-        return tp.__bases__
-    except AttributeError:
-        return ()
-
-
-def mro(tp: type[Any]) -> tuple[type[Any], ...]:
-    """Calculate the Method Resolution Order of bases using the C3 algorithm.
-
-    See https://www.python.org/download/releases/2.3/mro/
-    """
-    # try to use the existing mro, for performance mainly
-    # but also because it helps verify the implementation below
-    if not is_typeddict(tp):
-        try:
-            return tp.__mro__
-        except AttributeError:
-            # GenericAlias and some other cases
-            pass
-
-    bases = get_bases(tp)
-    return (tp,) + mro_for_bases(bases)
-
-
-def mro_for_bases(bases: tuple[type[Any], ...]) -> tuple[type[Any], ...]:
-    def merge_seqs(seqs: list[deque[type[Any]]]) -> Iterable[type[Any]]:
-        while True:
-            non_empty = [seq for seq in seqs if seq]
-            if not non_empty:
-                # Nothing left to process, we're done.
-                return
-            candidate: type[Any] | None = None
-            for seq in non_empty:  # Find merge candidates among seq heads.
-                candidate = seq[0]
-                not_head = [s for s in non_empty if candidate in islice(s, 1, None)]
-                if not_head:
-                    # Reject the candidate.
-                    candidate = None
-                else:
-                    break
-            if not candidate:
-                raise TypeError('Inconsistent hierarchy, no C3 MRO is possible')
-            yield candidate
-            for seq in non_empty:
-                # Remove candidate.
-                if seq[0] == candidate:
-                    seq.popleft()
-
-    seqs = [deque(mro(base)) for base in bases] + [deque(bases)]
-    return tuple(merge_seqs(seqs))
-
-
-_sentinel = object()
-
-
-def get_attribute_from_bases(tp: type[Any] | tuple[type[Any], ...], name: str) -> Any:
-    """Get the attribute from the next class in the MRO that has it,
-    aiming to simulate calling the method on the actual class.
-
-    The reason for iterating over the mro instead of just getting
-    the attribute (which would do that for us) is to support TypedDict,
-    which lacks a real __mro__, but can have a virtual one constructed
-    from its bases (as done here).
-
-    Args:
-        tp: The type or class to search for the attribute. If a tuple, this is treated as a set of base classes.
-        name: The name of the attribute to retrieve.
-
-    Returns:
-        Any: The attribute value, if found.
-
-    Raises:
-        AttributeError: If the attribute is not found in any class in the MRO.
-    """
-    if isinstance(tp, tuple):
-        for base in mro_for_bases(tp):
-            attribute = base.__dict__.get(name, _sentinel)
-            if attribute is not _sentinel:
-                attribute_get = getattr(attribute, '__get__', None)
-                if attribute_get is not None:
-                    return attribute_get(None, tp)
-                return attribute
-        raise AttributeError(f'{name} not found in {tp}')
-    else:
-        try:
-            return getattr(tp, name)
-        except AttributeError:
-            return get_attribute_from_bases(mro(tp), name)
-
-
-def get_attribute_from_base_dicts(tp: type[Any], name: str) -> Any:
-    """Get an attribute out of the `__dict__` following the MRO.
-    This prevents the call to `__get__` on the descriptor, and allows
-    us to get the original function for classmethod properties.
-
-    Args:
-        tp: The type or class to search for the attribute.
-        name: The name of the attribute to retrieve.
-
-    Returns:
-        Any: The attribute value, if found.
-
-    Raises:
-        KeyError: If the attribute is not found in any class's `__dict__` in the MRO.
-    """
-    for base in reversed(mro(tp)):
-        if name in base.__dict__:
-            return base.__dict__[name]
-    return tp.__dict__[name]  # raise the error
-
-
-@dataclass(**slots_true)
-class DecoratorInfos:
-    """Mapping of name in the class namespace to decorator info.
-
-    note that the name in the class namespace is the function or attribute name
-    not the field name!
-    """
-
-    validators: dict[str, Decorator[ValidatorDecoratorInfo]] = field(default_factory=dict)
-    field_validators: dict[str, Decorator[FieldValidatorDecoratorInfo]] = field(default_factory=dict)
-    root_validators: dict[str, Decorator[RootValidatorDecoratorInfo]] = field(default_factory=dict)
-    field_serializers: dict[str, Decorator[FieldSerializerDecoratorInfo]] = field(default_factory=dict)
-    model_serializers: dict[str, Decorator[ModelSerializerDecoratorInfo]] = field(default_factory=dict)
-    model_validators: dict[str, Decorator[ModelValidatorDecoratorInfo]] = field(default_factory=dict)
-    computed_fields: dict[str, Decorator[ComputedFieldInfo]] = field(default_factory=dict)
-
-    @staticmethod
-    def build(model_dc: type[Any]) -> DecoratorInfos:  # noqa: C901 (ignore complexity)
-        """We want to collect all DecFunc instances that exist as
-        attributes in the namespace of the class (a BaseModel or dataclass)
-        that called us
-        But we want to collect these in the order of the bases
-        So instead of getting them all from the leaf class (the class that called us),
-        we traverse the bases from root (the oldest ancestor class) to leaf
-        and collect all of the instances as we go, taking care to replace
-        any duplicate ones with the last one we see to mimic how function overriding
-        works with inheritance.
-        If we do replace any functions we put the replacement into the position
-        the replaced function was in; that is, we maintain the order.
-        """
-        # reminder: dicts are ordered and replacement does not alter the order
-        res = DecoratorInfos()
-        for base in reversed(mro(model_dc)[1:]):
-            existing: DecoratorInfos | None = base.__dict__.get('__pydantic_decorators__')
-            if existing is None:
-                existing = DecoratorInfos.build(base)
-            res.validators.update({k: v.bind_to_cls(model_dc) for k, v in existing.validators.items()})
-            res.field_validators.update({k: v.bind_to_cls(model_dc) for k, v in existing.field_validators.items()})
-            res.root_validators.update({k: v.bind_to_cls(model_dc) for k, v in existing.root_validators.items()})
-            res.field_serializers.update({k: v.bind_to_cls(model_dc) for k, v in existing.field_serializers.items()})
-            res.model_serializers.update({k: v.bind_to_cls(model_dc) for k, v in existing.model_serializers.items()})
-            res.model_validators.update({k: v.bind_to_cls(model_dc) for k, v in existing.model_validators.items()})
-            res.computed_fields.update({k: v.bind_to_cls(model_dc) for k, v in existing.computed_fields.items()})
-
-        to_replace: list[tuple[str, Any]] = []
-
-        for var_name, var_value in vars(model_dc).items():
-            if isinstance(var_value, PydanticDescriptorProxy):
-                info = var_value.decorator_info
-                if isinstance(info, ValidatorDecoratorInfo):
-                    res.validators[var_name] = Decorator.build(
-                        model_dc, cls_var_name=var_name, shim=var_value.shim, info=info
-                    )
-                elif isinstance(info, FieldValidatorDecoratorInfo):
-                    res.field_validators[var_name] = Decorator.build(
-                        model_dc, cls_var_name=var_name, shim=var_value.shim, info=info
-                    )
-                elif isinstance(info, RootValidatorDecoratorInfo):
-                    res.root_validators[var_name] = Decorator.build(
-                        model_dc, cls_var_name=var_name, shim=var_value.shim, info=info
-                    )
-                elif isinstance(info, FieldSerializerDecoratorInfo):
-                    # check whether a serializer function is already registered for fields
-                    for field_serializer_decorator in res.field_serializers.values():
-                        # check that each field has at most one serializer function.
-                        # serializer functions for the same field in subclasses are allowed,
-                        # and are treated as overrides
-                        if field_serializer_decorator.cls_var_name == var_name:
-                            continue
-                        for f in info.fields:
-                            if f in field_serializer_decorator.info.fields:
-                                raise PydanticUserError(
-                                    'Multiple field serializer functions were defined '
-                                    f'for field {f!r}, this is not allowed.',
-                                    code='multiple-field-serializers',
-                                )
-                    res.field_serializers[var_name] = Decorator.build(
-                        model_dc, cls_var_name=var_name, shim=var_value.shim, info=info
-                    )
-                elif isinstance(info, ModelValidatorDecoratorInfo):
-                    res.model_validators[var_name] = Decorator.build(
-                        model_dc, cls_var_name=var_name, shim=var_value.shim, info=info
-                    )
-                elif isinstance(info, ModelSerializerDecoratorInfo):
-                    res.model_serializers[var_name] = Decorator.build(
-                        model_dc, cls_var_name=var_name, shim=var_value.shim, info=info
-                    )
-                else:
-                    from ..fields import ComputedFieldInfo
-
-                    isinstance(var_value, ComputedFieldInfo)
-                    res.computed_fields[var_name] = Decorator.build(
-                        model_dc, cls_var_name=var_name, shim=None, info=info
-                    )
-                to_replace.append((var_name, var_value.wrapped))
-        if to_replace:
-            # If we can save `__pydantic_decorators__` on the class we'll be able to check for it above
-            # so then we don't need to re-process the type, which means we can discard our descriptor wrappers
-            # and replace them with the thing they are wrapping (see the other setattr call below)
-            # which allows validator class methods to also function as regular class methods
-            setattr(model_dc, '__pydantic_decorators__', res)
-            for name, value in to_replace:
-                setattr(model_dc, name, value)
-        return res
-
-
-def inspect_validator(validator: Callable[..., Any], mode: FieldValidatorModes) -> bool:
-    """Look at a field or model validator function and determine whether it takes an info argument.
-
-    An error is raised if the function has an invalid signature.
-
-    Args:
-        validator: The validator function to inspect.
-        mode: The proposed validator mode.
-
-    Returns:
-        Whether the validator takes an info argument.
-    """
-    try:
-        sig = signature(validator)
-    except ValueError:
-        # builtins and some C extensions don't have signatures
-        # assume that they don't take an info argument and only take a single argument
-        # e.g. `str.strip` or `datetime.datetime`
-        return False
-    n_positional = count_positional_params(sig)
-    if mode == 'wrap':
-        if n_positional == 3:
-            return True
-        elif n_positional == 2:
-            return False
-    else:
-        assert mode in {'before', 'after', 'plain'}, f"invalid mode: {mode!r}, expected 'before', 'after' or 'plain"
-        if n_positional == 2:
-            return True
-        elif n_positional == 1:
-            return False
-
-    raise PydanticUserError(
-        f'Unrecognized field_validator function signature for {validator} with `mode={mode}`:{sig}',
-        code='validator-signature',
-    )
-
-
-def inspect_field_serializer(
-    serializer: Callable[..., Any], mode: Literal['plain', 'wrap'], computed_field: bool = False
-) -> tuple[bool, bool]:
-    """Look at a field serializer function and determine if it is a field serializer,
-    and whether it takes an info argument.
-
-    An error is raised if the function has an invalid signature.
-
-    Args:
-        serializer: The serializer function to inspect.
-        mode: The serializer mode, either 'plain' or 'wrap'.
-        computed_field: When serializer is applied on computed_field. It doesn't require
-            info signature.
-
-    Returns:
-        Tuple of (is_field_serializer, info_arg).
-    """
-    sig = signature(serializer)
-
-    first = next(iter(sig.parameters.values()), None)
-    is_field_serializer = first is not None and first.name == 'self'
-
-    n_positional = count_positional_params(sig)
-    if is_field_serializer:
-        # -1 to correct for self parameter
-        info_arg = _serializer_info_arg(mode, n_positional - 1)
-    else:
-        info_arg = _serializer_info_arg(mode, n_positional)
-
-    if info_arg is None:
-        raise PydanticUserError(
-            f'Unrecognized field_serializer function signature for {serializer} with `mode={mode}`:{sig}',
-            code='field-serializer-signature',
-        )
-    if info_arg and computed_field:
-        raise PydanticUserError(
-            'field_serializer on computed_field does not use info signature', code='field-serializer-signature'
-        )
-
-    else:
-        return is_field_serializer, info_arg
-
-
-def inspect_annotated_serializer(serializer: Callable[..., Any], mode: Literal['plain', 'wrap']) -> bool:
-    """Look at a serializer function used via `Annotated` and determine whether it takes an info argument.
-
-    An error is raised if the function has an invalid signature.
-
-    Args:
-        serializer: The serializer function to check.
-        mode: The serializer mode, either 'plain' or 'wrap'.
-
-    Returns:
-        info_arg
-    """
-    sig = signature(serializer)
-    info_arg = _serializer_info_arg(mode, count_positional_params(sig))
-    if info_arg is None:
-        raise PydanticUserError(
-            f'Unrecognized field_serializer function signature for {serializer} with `mode={mode}`:{sig}',
-            code='field-serializer-signature',
-        )
-    else:
-        return info_arg
-
-
-def inspect_model_serializer(serializer: Callable[..., Any], mode: Literal['plain', 'wrap']) -> bool:
-    """Look at a model serializer function and determine whether it takes an info argument.
-
-    An error is raised if the function has an invalid signature.
-
-    Args:
-        serializer: The serializer function to check.
-        mode: The serializer mode, either 'plain' or 'wrap'.
-
-    Returns:
-        `info_arg` - whether the function expects an info argument.
-    """
-    if isinstance(serializer, (staticmethod, classmethod)) or not is_instance_method_from_sig(serializer):
-        raise PydanticUserError(
-            '`@model_serializer` must be applied to instance methods', code='model-serializer-instance-method'
-        )
-
-    sig = signature(serializer)
-    info_arg = _serializer_info_arg(mode, count_positional_params(sig))
-    if info_arg is None:
-        raise PydanticUserError(
-            f'Unrecognized model_serializer function signature for {serializer} with `mode={mode}`:{sig}',
-            code='model-serializer-signature',
-        )
-    else:
-        return info_arg
-
-
-def _serializer_info_arg(mode: Literal['plain', 'wrap'], n_positional: int) -> bool | None:
-    if mode == 'plain':
-        if n_positional == 1:
-            # (__input_value: Any) -> Any
-            return False
-        elif n_positional == 2:
-            # (__model: Any, __input_value: Any) -> Any
-            return True
-    else:
-        assert mode == 'wrap', f"invalid mode: {mode!r}, expected 'plain' or 'wrap'"
-        if n_positional == 2:
-            # (__input_value: Any, __serializer: SerializerFunctionWrapHandler) -> Any
-            return False
-        elif n_positional == 3:
-            # (__input_value: Any, __serializer: SerializerFunctionWrapHandler, __info: SerializationInfo) -> Any
-            return True
-
-    return None
-
-
-AnyDecoratorCallable: TypeAlias = (
-    'Union[classmethod[Any, Any, Any], staticmethod[Any, Any], partialmethod[Any], Callable[..., Any]]'
-)
-
-
-def is_instance_method_from_sig(function: AnyDecoratorCallable) -> bool:
-    """Whether the function is an instance method.
-
-    It will consider a function as instance method if the first parameter of
-    function is `self`.
-
-    Args:
-        function: The function to check.
-
-    Returns:
-        `True` if the function is an instance method, `False` otherwise.
-    """
-    sig = signature(unwrap_wrapped_function(function))
-    first = next(iter(sig.parameters.values()), None)
-    if first and first.name == 'self':
-        return True
-    return False
-
-
-def ensure_classmethod_based_on_signature(function: AnyDecoratorCallable) -> Any:
-    """Apply the `@classmethod` decorator on the function.
-
-    Args:
-        function: The function to apply the decorator on.
-
-    Return:
-        The `@classmethod` decorator applied function.
-    """
-    if not isinstance(
-        unwrap_wrapped_function(function, unwrap_class_static_method=False), classmethod
-    ) and _is_classmethod_from_sig(function):
-        return classmethod(function)  # type: ignore[arg-type]
-    return function
-
-
-def _is_classmethod_from_sig(function: AnyDecoratorCallable) -> bool:
-    sig = signature(unwrap_wrapped_function(function))
-    first = next(iter(sig.parameters.values()), None)
-    if first and first.name == 'cls':
-        return True
-    return False
-
-
-def unwrap_wrapped_function(
-    func: Any,
-    *,
-    unwrap_partial: bool = True,
-    unwrap_class_static_method: bool = True,
-) -> Any:
-    """Recursively unwraps a wrapped function until the underlying function is reached.
-    This handles property, functools.partial, functools.partialmethod, staticmethod and classmethod.
-
-    Args:
-        func: The function to unwrap.
-        unwrap_partial: If True (default), unwrap partial and partialmethod decorators, otherwise don't.
-            decorators.
-        unwrap_class_static_method: If True (default), also unwrap classmethod and staticmethod
-            decorators. If False, only unwrap partial and partialmethod decorators.
-
-    Returns:
-        The underlying function of the wrapped function.
-    """
-    all: set[Any] = {property, cached_property}
-
-    if unwrap_partial:
-        all.update({partial, partialmethod})
-
-    if unwrap_class_static_method:
-        all.update({staticmethod, classmethod})
-
-    while isinstance(func, tuple(all)):
-        if unwrap_class_static_method and isinstance(func, (classmethod, staticmethod)):
-            func = func.__func__
-        elif isinstance(func, (partial, partialmethod)):
-            func = func.func
-        elif isinstance(func, property):
-            func = func.fget  # arbitrary choice, convenient for computed fields
-        else:
-            # Make coverage happy as it can only get here in the last possible case
-            assert isinstance(func, cached_property)
-            func = func.func  # type: ignore
-
-    return func
-
-
-def get_function_return_type(
-    func: Any, explicit_return_type: Any, types_namespace: dict[str, Any] | None = None
-) -> Any:
-    """Get the function return type.
-
-    It gets the return type from the type annotation if `explicit_return_type` is `None`.
-    Otherwise, it returns `explicit_return_type`.
-
-    Args:
-        func: The function to get its return type.
-        explicit_return_type: The explicit return type.
-        types_namespace: The types namespace, defaults to `None`.
-
-    Returns:
-        The function return type.
-    """
-    if explicit_return_type is PydanticUndefined:
-        # try to get it from the type annotation
-        hints = get_function_type_hints(
-            unwrap_wrapped_function(func), include_keys={'return'}, types_namespace=types_namespace
-        )
-        return hints.get('return', PydanticUndefined)
-    else:
-        return explicit_return_type
-
-
-def count_positional_params(sig: Signature) -> int:
-    return sum(1 for param in sig.parameters.values() if can_be_positional(param))
-
-
-def can_be_positional(param: Parameter) -> bool:
-    return param.kind in (Parameter.POSITIONAL_ONLY, Parameter.POSITIONAL_OR_KEYWORD)
-
-
-def ensure_property(f: Any) -> Any:
-    """Ensure that a function is a `property` or `cached_property`, or is a valid descriptor.
-
-    Args:
-        f: The function to check.
-
-    Returns:
-        The function, or a `property` or `cached_property` instance wrapping the function.
-    """
-    if ismethoddescriptor(f) or isdatadescriptor(f):
-        return f
-    else:
-        return property(f)
diff --git a/lib/pydantic/_internal/_decorators_v1.py b/lib/pydantic/_internal/_decorators_v1.py
deleted file mode 100644
index 4f81e6d4..00000000
--- a/lib/pydantic/_internal/_decorators_v1.py
+++ /dev/null
@@ -1,181 +0,0 @@
-"""Logic for V1 validators, e.g. `@validator` and `@root_validator`."""
-from __future__ import annotations as _annotations
-
-from inspect import Parameter, signature
-from typing import Any, Dict, Tuple, Union, cast
-
-from pydantic_core import core_schema
-from typing_extensions import Protocol
-
-from ..errors import PydanticUserError
-from ._decorators import can_be_positional
-
-
-class V1OnlyValueValidator(Protocol):
-    """A simple validator, supported for V1 validators and V2 validators."""
-
-    def __call__(self, __value: Any) -> Any:
-        ...
-
-
-class V1ValidatorWithValues(Protocol):
-    """A validator with `values` argument, supported for V1 validators and V2 validators."""
-
-    def __call__(self, __value: Any, values: dict[str, Any]) -> Any:
-        ...
-
-
-class V1ValidatorWithValuesKwOnly(Protocol):
-    """A validator with keyword only `values` argument, supported for V1 validators and V2 validators."""
-
-    def __call__(self, __value: Any, *, values: dict[str, Any]) -> Any:
-        ...
-
-
-class V1ValidatorWithKwargs(Protocol):
-    """A validator with `kwargs` argument, supported for V1 validators and V2 validators."""
-
-    def __call__(self, __value: Any, **kwargs: Any) -> Any:
-        ...
-
-
-class V1ValidatorWithValuesAndKwargs(Protocol):
-    """A validator with `values` and `kwargs` arguments, supported for V1 validators and V2 validators."""
-
-    def __call__(self, __value: Any, values: dict[str, Any], **kwargs: Any) -> Any:
-        ...
-
-
-V1Validator = Union[
-    V1ValidatorWithValues, V1ValidatorWithValuesKwOnly, V1ValidatorWithKwargs, V1ValidatorWithValuesAndKwargs
-]
-
-
-def can_be_keyword(param: Parameter) -> bool:
-    return param.kind in (Parameter.POSITIONAL_OR_KEYWORD, Parameter.KEYWORD_ONLY)
-
-
-def make_generic_v1_field_validator(validator: V1Validator) -> core_schema.WithInfoValidatorFunction:
-    """Wrap a V1 style field validator for V2 compatibility.
-
-    Args:
-        validator: The V1 style field validator.
-
-    Returns:
-        A wrapped V2 style field validator.
-
-    Raises:
-        PydanticUserError: If the signature is not supported or the parameters are
-            not available in Pydantic V2.
-    """
-    sig = signature(validator)
-
-    needs_values_kw = False
-
-    for param_num, (param_name, parameter) in enumerate(sig.parameters.items()):
-        if can_be_keyword(parameter) and param_name in ('field', 'config'):
-            raise PydanticUserError(
-                'The `field` and `config` parameters are not available in Pydantic V2, '
-                'please use the `info` parameter instead.',
-                code='validator-field-config-info',
-            )
-        if parameter.kind is Parameter.VAR_KEYWORD:
-            needs_values_kw = True
-        elif can_be_keyword(parameter) and param_name == 'values':
-            needs_values_kw = True
-        elif can_be_positional(parameter) and param_num == 0:
-            # value
-            continue
-        elif parameter.default is Parameter.empty:  # ignore params with defaults e.g. bound by functools.partial
-            raise PydanticUserError(
-                f'Unsupported signature for V1 style validator {validator}: {sig} is not supported.',
-                code='validator-v1-signature',
-            )
-
-    if needs_values_kw:
-        # (v, **kwargs), (v, values, **kwargs), (v, *, values, **kwargs) or (v, *, values)
-        val1 = cast(V1ValidatorWithValues, validator)
-
-        def wrapper1(value: Any, info: core_schema.ValidationInfo) -> Any:
-            return val1(value, values=info.data)
-
-        return wrapper1
-    else:
-        val2 = cast(V1OnlyValueValidator, validator)
-
-        def wrapper2(value: Any, _: core_schema.ValidationInfo) -> Any:
-            return val2(value)
-
-        return wrapper2
-
-
-RootValidatorValues = Dict[str, Any]
-# technically tuple[model_dict, model_extra, fields_set] | tuple[dataclass_dict, init_vars]
-RootValidatorFieldsTuple = Tuple[Any, ...]
-
-
-class V1RootValidatorFunction(Protocol):
-    """A simple root validator, supported for V1 validators and V2 validators."""
-
-    def __call__(self, __values: RootValidatorValues) -> RootValidatorValues:
-        ...
-
-
-class V2CoreBeforeRootValidator(Protocol):
-    """V2 validator with mode='before'."""
-
-    def __call__(self, __values: RootValidatorValues, __info: core_schema.ValidationInfo) -> RootValidatorValues:
-        ...
-
-
-class V2CoreAfterRootValidator(Protocol):
-    """V2 validator with mode='after'."""
-
-    def __call__(
-        self, __fields_tuple: RootValidatorFieldsTuple, __info: core_schema.ValidationInfo
-    ) -> RootValidatorFieldsTuple:
-        ...
-
-
-def make_v1_generic_root_validator(
-    validator: V1RootValidatorFunction, pre: bool
-) -> V2CoreBeforeRootValidator | V2CoreAfterRootValidator:
-    """Wrap a V1 style root validator for V2 compatibility.
-
-    Args:
-        validator: The V1 style field validator.
-        pre: Whether the validator is a pre validator.
-
-    Returns:
-        A wrapped V2 style validator.
-    """
-    if pre is True:
-        # mode='before' for pydantic-core
-        def _wrapper1(values: RootValidatorValues, _: core_schema.ValidationInfo) -> RootValidatorValues:
-            return validator(values)
-
-        return _wrapper1
-
-    # mode='after' for pydantic-core
-    def _wrapper2(fields_tuple: RootValidatorFieldsTuple, _: core_schema.ValidationInfo) -> RootValidatorFieldsTuple:
-        if len(fields_tuple) == 2:
-            # dataclass, this is easy
-            values, init_vars = fields_tuple
-            values = validator(values)
-            return values, init_vars
-        else:
-            # ugly hack: to match v1 behaviour, we merge values and model_extra, then split them up based on fields
-            # afterwards
-            model_dict, model_extra, fields_set = fields_tuple
-            if model_extra:
-                fields = set(model_dict.keys())
-                model_dict.update(model_extra)
-                model_dict_new = validator(model_dict)
-                for k in list(model_dict_new.keys()):
-                    if k not in fields:
-                        model_extra[k] = model_dict_new.pop(k)
-            else:
-                model_dict_new = validator(model_dict)
-            return model_dict_new, model_extra, fields_set
-
-    return _wrapper2
diff --git a/lib/pydantic/_internal/_discriminated_union.py b/lib/pydantic/_internal/_discriminated_union.py
deleted file mode 100644
index c40117d3..00000000
--- a/lib/pydantic/_internal/_discriminated_union.py
+++ /dev/null
@@ -1,506 +0,0 @@
-from __future__ import annotations as _annotations
-
-from typing import TYPE_CHECKING, Any, Hashable, Sequence
-
-from pydantic_core import CoreSchema, core_schema
-
-from ..errors import PydanticUserError
-from . import _core_utils
-from ._core_utils import (
-    CoreSchemaField,
-    collect_definitions,
-    simplify_schema_references,
-)
-
-if TYPE_CHECKING:
-    from ..types import Discriminator
-
-CORE_SCHEMA_METADATA_DISCRIMINATOR_PLACEHOLDER_KEY = 'pydantic.internal.union_discriminator'
-
-
-class MissingDefinitionForUnionRef(Exception):
-    """Raised when applying a discriminated union discriminator to a schema
-    requires a definition that is not yet defined
-    """
-
-    def __init__(self, ref: str) -> None:
-        self.ref = ref
-        super().__init__(f'Missing definition for ref {self.ref!r}')
-
-
-def set_discriminator_in_metadata(schema: CoreSchema, discriminator: Any) -> None:
-    schema.setdefault('metadata', {})
-    metadata = schema.get('metadata')
-    assert metadata is not None
-    metadata[CORE_SCHEMA_METADATA_DISCRIMINATOR_PLACEHOLDER_KEY] = discriminator
-
-
-def apply_discriminators(schema: core_schema.CoreSchema) -> core_schema.CoreSchema:
-    definitions: dict[str, CoreSchema] | None = None
-
-    def inner(s: core_schema.CoreSchema, recurse: _core_utils.Recurse) -> core_schema.CoreSchema:
-        nonlocal definitions
-
-        s = recurse(s, inner)
-        if s['type'] == 'tagged-union':
-            return s
-
-        metadata = s.get('metadata', {})
-        discriminator = metadata.pop(CORE_SCHEMA_METADATA_DISCRIMINATOR_PLACEHOLDER_KEY, None)
-        if discriminator is not None:
-            if definitions is None:
-                definitions = collect_definitions(schema)
-            s = apply_discriminator(s, discriminator, definitions)
-        return s
-
-    return simplify_schema_references(_core_utils.walk_core_schema(schema, inner))
-
-
-def apply_discriminator(
-    schema: core_schema.CoreSchema,
-    discriminator: str | Discriminator,
-    definitions: dict[str, core_schema.CoreSchema] | None = None,
-) -> core_schema.CoreSchema:
-    """Applies the discriminator and returns a new core schema.
-
-    Args:
-        schema: The input schema.
-        discriminator: The name of the field which will serve as the discriminator.
-        definitions: A mapping of schema ref to schema.
-
-    Returns:
-        The new core schema.
-
-    Raises:
-        TypeError:
-            - If `discriminator` is used with invalid union variant.
-            - If `discriminator` is used with `Union` type with one variant.
-            - If `discriminator` value mapped to multiple choices.
-        MissingDefinitionForUnionRef:
-            If the definition for ref is missing.
-        PydanticUserError:
-            - If a model in union doesn't have a discriminator field.
-            - If discriminator field has a non-string alias.
-            - If discriminator fields have different aliases.
-            - If discriminator field not of type `Literal`.
-    """
-    from ..types import Discriminator
-
-    if isinstance(discriminator, Discriminator):
-        if isinstance(discriminator.discriminator, str):
-            discriminator = discriminator.discriminator
-        else:
-            return discriminator._convert_schema(schema)
-
-    return _ApplyInferredDiscriminator(discriminator, definitions or {}).apply(schema)
-
-
-class _ApplyInferredDiscriminator:
-    """This class is used to convert an input schema containing a union schema into one where that union is
-    replaced with a tagged-union, with all the associated debugging and performance benefits.
-
-    This is done by:
-    * Validating that the input schema is compatible with the provided discriminator
-    * Introspecting the schema to determine which discriminator values should map to which union choices
-    * Handling various edge cases such as 'definitions', 'default', 'nullable' schemas, and more
-
-    I have chosen to implement the conversion algorithm in this class, rather than a function,
-    to make it easier to maintain state while recursively walking the provided CoreSchema.
-    """
-
-    def __init__(self, discriminator: str, definitions: dict[str, core_schema.CoreSchema]):
-        # `discriminator` should be the name of the field which will serve as the discriminator.
-        # It must be the python name of the field, and *not* the field's alias. Note that as of now,
-        # all members of a discriminated union _must_ use a field with the same name as the discriminator.
-        # This may change if/when we expose a way to manually specify the TaggedUnionSchema's choices.
-        self.discriminator = discriminator
-
-        # `definitions` should contain a mapping of schema ref to schema for all schemas which might
-        # be referenced by some choice
-        self.definitions = definitions
-
-        # `_discriminator_alias` will hold the value, if present, of the alias for the discriminator
-        #
-        # Note: following the v1 implementation, we currently disallow the use of different aliases
-        # for different choices. This is not a limitation of pydantic_core, but if we try to handle
-        # this, the inference logic gets complicated very quickly, and could result in confusing
-        # debugging challenges for users making subtle mistakes.
-        #
-        # Rather than trying to do the most powerful inference possible, I think we should eventually
-        # expose a way to more-manually control the way the TaggedUnionSchema is constructed through
-        # the use of a new type which would be placed as an Annotation on the Union type. This would
-        # provide the full flexibility/power of pydantic_core's TaggedUnionSchema where necessary for
-        # more complex cases, without over-complicating the inference logic for the common cases.
-        self._discriminator_alias: str | None = None
-
-        # `_should_be_nullable` indicates whether the converted union has `None` as an allowed value.
-        # If `None` is an acceptable value of the (possibly-wrapped) union, we ignore it while
-        # constructing the TaggedUnionSchema, but set the `_should_be_nullable` attribute to True.
-        # Once we have constructed the TaggedUnionSchema, if `_should_be_nullable` is True, we ensure
-        # that the final schema gets wrapped as a NullableSchema. This has the same semantics on the
-        # python side, but resolves the issue that `None` cannot correspond to any discriminator values.
-        self._should_be_nullable = False
-
-        # `_is_nullable` is used to track if the final produced schema will definitely be nullable;
-        # we set it to True if the input schema is wrapped in a nullable schema that we know will be preserved
-        # as an indication that, even if None is discovered as one of the union choices, we will not need to wrap
-        # the final value in another nullable schema.
-        #
-        # This is more complicated than just checking for the final outermost schema having type 'nullable' thanks
-        # to the possible presence of other wrapper schemas such as DefinitionsSchema, WithDefaultSchema, etc.
-        self._is_nullable = False
-
-        # `_choices_to_handle` serves as a stack of choices to add to the tagged union. Initially, choices
-        # from the union in the wrapped schema will be appended to this list, and the recursive choice-handling
-        # algorithm may add more choices to this stack as (nested) unions are encountered.
-        self._choices_to_handle: list[core_schema.CoreSchema] = []
-
-        # `_tagged_union_choices` is built during the call to `apply`, and will hold the choices to be included
-        # in the output TaggedUnionSchema that will replace the union from the input schema
-        self._tagged_union_choices: dict[Hashable, core_schema.CoreSchema] = {}
-
-        # `_used` is changed to True after applying the discriminator to prevent accidental re-use
-        self._used = False
-
-    def apply(self, schema: core_schema.CoreSchema) -> core_schema.CoreSchema:
-        """Return a new CoreSchema based on `schema` that uses a tagged-union with the discriminator provided
-        to this class.
-
-        Args:
-            schema: The input schema.
-
-        Returns:
-            The new core schema.
-
-        Raises:
-            TypeError:
-                - If `discriminator` is used with invalid union variant.
-                - If `discriminator` is used with `Union` type with one variant.
-                - If `discriminator` value mapped to multiple choices.
-            ValueError:
-                If the definition for ref is missing.
-            PydanticUserError:
-                - If a model in union doesn't have a discriminator field.
-                - If discriminator field has a non-string alias.
-                - If discriminator fields have different aliases.
-                - If discriminator field not of type `Literal`.
-        """
-        self.definitions.update(collect_definitions(schema))
-        assert not self._used
-        schema = self._apply_to_root(schema)
-        if self._should_be_nullable and not self._is_nullable:
-            schema = core_schema.nullable_schema(schema)
-        self._used = True
-        new_defs = collect_definitions(schema)
-        missing_defs = self.definitions.keys() - new_defs.keys()
-        if missing_defs:
-            schema = core_schema.definitions_schema(schema, [self.definitions[ref] for ref in missing_defs])
-        return schema
-
-    def _apply_to_root(self, schema: core_schema.CoreSchema) -> core_schema.CoreSchema:
-        """This method handles the outer-most stage of recursion over the input schema:
-        unwrapping nullable or definitions schemas, and calling the `_handle_choice`
-        method iteratively on the choices extracted (recursively) from the possibly-wrapped union.
-        """
-        if schema['type'] == 'nullable':
-            self._is_nullable = True
-            wrapped = self._apply_to_root(schema['schema'])
-            nullable_wrapper = schema.copy()
-            nullable_wrapper['schema'] = wrapped
-            return nullable_wrapper
-
-        if schema['type'] == 'definitions':
-            wrapped = self._apply_to_root(schema['schema'])
-            definitions_wrapper = schema.copy()
-            definitions_wrapper['schema'] = wrapped
-            return definitions_wrapper
-
-        if schema['type'] != 'union':
-            # If the schema is not a union, it probably means it just had a single member and
-            # was flattened by pydantic_core.
-            # However, it still may make sense to apply the discriminator to this schema,
-            # as a way to get discriminated-union-style error messages, so we allow this here.
-            schema = core_schema.union_schema([schema])
-
-        # Reverse the choices list before extending the stack so that they get handled in the order they occur
-        choices_schemas = [v[0] if isinstance(v, tuple) else v for v in schema['choices'][::-1]]
-        self._choices_to_handle.extend(choices_schemas)
-        while self._choices_to_handle:
-            choice = self._choices_to_handle.pop()
-            self._handle_choice(choice)
-
-        if self._discriminator_alias is not None and self._discriminator_alias != self.discriminator:
-            # * We need to annotate `discriminator` as a union here to handle both branches of this conditional
-            # * We need to annotate `discriminator` as list[list[str | int]] and not list[list[str]] due to the
-            #   invariance of list, and because list[list[str | int]] is the type of the discriminator argument
-            #   to tagged_union_schema below
-            # * See the docstring of pydantic_core.core_schema.tagged_union_schema for more details about how to
-            #   interpret the value of the discriminator argument to tagged_union_schema. (The list[list[str]] here
-            #   is the appropriate way to provide a list of fallback attributes to check for a discriminator value.)
-            discriminator: str | list[list[str | int]] = [[self.discriminator], [self._discriminator_alias]]
-        else:
-            discriminator = self.discriminator
-        return core_schema.tagged_union_schema(
-            choices=self._tagged_union_choices,
-            discriminator=discriminator,
-            custom_error_type=schema.get('custom_error_type'),
-            custom_error_message=schema.get('custom_error_message'),
-            custom_error_context=schema.get('custom_error_context'),
-            strict=False,
-            from_attributes=True,
-            ref=schema.get('ref'),
-            metadata=schema.get('metadata'),
-            serialization=schema.get('serialization'),
-        )
-
-    def _handle_choice(self, choice: core_schema.CoreSchema) -> None:
-        """This method handles the "middle" stage of recursion over the input schema.
-        Specifically, it is responsible for handling each choice of the outermost union
-        (and any "coalesced" choices obtained from inner unions).
-
-        Here, "handling" entails:
-        * Coalescing nested unions and compatible tagged-unions
-        * Tracking the presence of 'none' and 'nullable' schemas occurring as choices
-        * Validating that each allowed discriminator value maps to a unique choice
-        * Updating the _tagged_union_choices mapping that will ultimately be used to build the TaggedUnionSchema.
-        """
-        if choice['type'] == 'definition-ref':
-            if choice['schema_ref'] not in self.definitions:
-                raise MissingDefinitionForUnionRef(choice['schema_ref'])
-
-        if choice['type'] == 'none':
-            self._should_be_nullable = True
-        elif choice['type'] == 'definitions':
-            self._handle_choice(choice['schema'])
-        elif choice['type'] == 'nullable':
-            self._should_be_nullable = True
-            self._handle_choice(choice['schema'])  # unwrap the nullable schema
-        elif choice['type'] == 'union':
-            # Reverse the choices list before extending the stack so that they get handled in the order they occur
-            choices_schemas = [v[0] if isinstance(v, tuple) else v for v in choice['choices'][::-1]]
-            self._choices_to_handle.extend(choices_schemas)
-        elif choice['type'] not in {
-            'model',
-            'typed-dict',
-            'tagged-union',
-            'lax-or-strict',
-            'dataclass',
-            'dataclass-args',
-            'definition-ref',
-        } and not _core_utils.is_function_with_inner_schema(choice):
-            # We should eventually handle 'definition-ref' as well
-            raise TypeError(
-                f'{choice["type"]!r} is not a valid discriminated union variant;'
-                ' should be a `BaseModel` or `dataclass`'
-            )
-        else:
-            if choice['type'] == 'tagged-union' and self._is_discriminator_shared(choice):
-                # In this case, this inner tagged-union is compatible with the outer tagged-union,
-                # and its choices can be coalesced into the outer TaggedUnionSchema.
-                subchoices = [x for x in choice['choices'].values() if not isinstance(x, (str, int))]
-                # Reverse the choices list before extending the stack so that they get handled in the order they occur
-                self._choices_to_handle.extend(subchoices[::-1])
-                return
-
-            inferred_discriminator_values = self._infer_discriminator_values_for_choice(choice, source_name=None)
-            self._set_unique_choice_for_values(choice, inferred_discriminator_values)
-
-    def _is_discriminator_shared(self, choice: core_schema.TaggedUnionSchema) -> bool:
-        """This method returns a boolean indicating whether the discriminator for the `choice`
-        is the same as that being used for the outermost tagged union. This is used to
-        determine whether this TaggedUnionSchema choice should be "coalesced" into the top level,
-        or whether it should be treated as a separate (nested) choice.
-        """
-        inner_discriminator = choice['discriminator']
-        return inner_discriminator == self.discriminator or (
-            isinstance(inner_discriminator, list)
-            and (self.discriminator in inner_discriminator or [self.discriminator] in inner_discriminator)
-        )
-
-    def _infer_discriminator_values_for_choice(  # noqa C901
-        self, choice: core_schema.CoreSchema, source_name: str | None
-    ) -> list[str | int]:
-        """This function recurses over `choice`, extracting all discriminator values that should map to this choice.
-
-        `model_name` is accepted for the purpose of producing useful error messages.
-        """
-        if choice['type'] == 'definitions':
-            return self._infer_discriminator_values_for_choice(choice['schema'], source_name=source_name)
-        elif choice['type'] == 'function-plain':
-            raise TypeError(
-                f'{choice["type"]!r} is not a valid discriminated union variant;'
-                ' should be a `BaseModel` or `dataclass`'
-            )
-        elif _core_utils.is_function_with_inner_schema(choice):
-            return self._infer_discriminator_values_for_choice(choice['schema'], source_name=source_name)
-        elif choice['type'] == 'lax-or-strict':
-            return sorted(
-                set(
-                    self._infer_discriminator_values_for_choice(choice['lax_schema'], source_name=None)
-                    + self._infer_discriminator_values_for_choice(choice['strict_schema'], source_name=None)
-                )
-            )
-
-        elif choice['type'] == 'tagged-union':
-            values: list[str | int] = []
-            # Ignore str/int "choices" since these are just references to other choices
-            subchoices = [x for x in choice['choices'].values() if not isinstance(x, (str, int))]
-            for subchoice in subchoices:
-                subchoice_values = self._infer_discriminator_values_for_choice(subchoice, source_name=None)
-                values.extend(subchoice_values)
-            return values
-
-        elif choice['type'] == 'union':
-            values = []
-            for subchoice in choice['choices']:
-                subchoice_schema = subchoice[0] if isinstance(subchoice, tuple) else subchoice
-                subchoice_values = self._infer_discriminator_values_for_choice(subchoice_schema, source_name=None)
-                values.extend(subchoice_values)
-            return values
-
-        elif choice['type'] == 'nullable':
-            self._should_be_nullable = True
-            return self._infer_discriminator_values_for_choice(choice['schema'], source_name=None)
-
-        elif choice['type'] == 'model':
-            return self._infer_discriminator_values_for_choice(choice['schema'], source_name=choice['cls'].__name__)
-
-        elif choice['type'] == 'dataclass':
-            return self._infer_discriminator_values_for_choice(choice['schema'], source_name=choice['cls'].__name__)
-
-        elif choice['type'] == 'model-fields':
-            return self._infer_discriminator_values_for_model_choice(choice, source_name=source_name)
-
-        elif choice['type'] == 'dataclass-args':
-            return self._infer_discriminator_values_for_dataclass_choice(choice, source_name=source_name)
-
-        elif choice['type'] == 'typed-dict':
-            return self._infer_discriminator_values_for_typed_dict_choice(choice, source_name=source_name)
-
-        elif choice['type'] == 'definition-ref':
-            schema_ref = choice['schema_ref']
-            if schema_ref not in self.definitions:
-                raise MissingDefinitionForUnionRef(schema_ref)
-            return self._infer_discriminator_values_for_choice(self.definitions[schema_ref], source_name=source_name)
-        else:
-            raise TypeError(
-                f'{choice["type"]!r} is not a valid discriminated union variant;'
-                ' should be a `BaseModel` or `dataclass`'
-            )
-
-    def _infer_discriminator_values_for_typed_dict_choice(
-        self, choice: core_schema.TypedDictSchema, source_name: str | None = None
-    ) -> list[str | int]:
-        """This method just extracts the _infer_discriminator_values_for_choice logic specific to TypedDictSchema
-        for the sake of readability.
-        """
-        source = 'TypedDict' if source_name is None else f'TypedDict {source_name!r}'
-        field = choice['fields'].get(self.discriminator)
-        if field is None:
-            raise PydanticUserError(
-                f'{source} needs a discriminator field for key {self.discriminator!r}', code='discriminator-no-field'
-            )
-        return self._infer_discriminator_values_for_field(field, source)
-
-    def _infer_discriminator_values_for_model_choice(
-        self, choice: core_schema.ModelFieldsSchema, source_name: str | None = None
-    ) -> list[str | int]:
-        source = 'ModelFields' if source_name is None else f'Model {source_name!r}'
-        field = choice['fields'].get(self.discriminator)
-        if field is None:
-            raise PydanticUserError(
-                f'{source} needs a discriminator field for key {self.discriminator!r}', code='discriminator-no-field'
-            )
-        return self._infer_discriminator_values_for_field(field, source)
-
-    def _infer_discriminator_values_for_dataclass_choice(
-        self, choice: core_schema.DataclassArgsSchema, source_name: str | None = None
-    ) -> list[str | int]:
-        source = 'DataclassArgs' if source_name is None else f'Dataclass {source_name!r}'
-        for field in choice['fields']:
-            if field['name'] == self.discriminator:
-                break
-        else:
-            raise PydanticUserError(
-                f'{source} needs a discriminator field for key {self.discriminator!r}', code='discriminator-no-field'
-            )
-        return self._infer_discriminator_values_for_field(field, source)
-
-    def _infer_discriminator_values_for_field(self, field: CoreSchemaField, source: str) -> list[str | int]:
-        if field['type'] == 'computed-field':
-            # This should never occur as a discriminator, as it is only relevant to serialization
-            return []
-        alias = field.get('validation_alias', self.discriminator)
-        if not isinstance(alias, str):
-            raise PydanticUserError(
-                f'Alias {alias!r} is not supported in a discriminated union', code='discriminator-alias-type'
-            )
-        if self._discriminator_alias is None:
-            self._discriminator_alias = alias
-        elif self._discriminator_alias != alias:
-            raise PydanticUserError(
-                f'Aliases for discriminator {self.discriminator!r} must be the same '
-                f'(got {alias}, {self._discriminator_alias})',
-                code='discriminator-alias',
-            )
-        return self._infer_discriminator_values_for_inner_schema(field['schema'], source)
-
-    def _infer_discriminator_values_for_inner_schema(
-        self, schema: core_schema.CoreSchema, source: str
-    ) -> list[str | int]:
-        """When inferring discriminator values for a field, we typically extract the expected values from a literal
-        schema. This function does that, but also handles nested unions and defaults.
-        """
-        if schema['type'] == 'literal':
-            return schema['expected']
-
-        elif schema['type'] == 'union':
-            # Generally when multiple values are allowed they should be placed in a single `Literal`, but
-            # we add this case to handle the situation where a field is annotated as a `Union` of `Literal`s.
-            # For example, this lets us handle `Union[Literal['key'], Union[Literal['Key'], Literal['KEY']]]`
-            values: list[Any] = []
-            for choice in schema['choices']:
-                choice_schema = choice[0] if isinstance(choice, tuple) else choice
-                choice_values = self._infer_discriminator_values_for_inner_schema(choice_schema, source)
-                values.extend(choice_values)
-            return values
-
-        elif schema['type'] == 'default':
-            # This will happen if the field has a default value; we ignore it while extracting the discriminator values
-            return self._infer_discriminator_values_for_inner_schema(schema['schema'], source)
-
-        elif schema['type'] == 'function-after':
-            # After validators don't affect the discriminator values
-            return self._infer_discriminator_values_for_inner_schema(schema['schema'], source)
-
-        elif schema['type'] in {'function-before', 'function-wrap', 'function-plain'}:
-            validator_type = repr(schema['type'].split('-')[1])
-            raise PydanticUserError(
-                f'Cannot use a mode={validator_type} validator in the'
-                f' discriminator field {self.discriminator!r} of {source}',
-                code='discriminator-validator',
-            )
-
-        else:
-            raise PydanticUserError(
-                f'{source} needs field {self.discriminator!r} to be of type `Literal`',
-                code='discriminator-needs-literal',
-            )
-
-    def _set_unique_choice_for_values(self, choice: core_schema.CoreSchema, values: Sequence[str | int]) -> None:
-        """This method updates `self.tagged_union_choices` so that all provided (discriminator) `values` map to the
-        provided `choice`, validating that none of these values already map to another (different) choice.
-        """
-        for discriminator_value in values:
-            if discriminator_value in self._tagged_union_choices:
-                # It is okay if `value` is already in tagged_union_choices as long as it maps to the same value.
-                # Because tagged_union_choices may map values to other values, we need to walk the choices dict
-                # until we get to a "real" choice, and confirm that is equal to the one assigned.
-                existing_choice = self._tagged_union_choices[discriminator_value]
-                if existing_choice != choice:
-                    raise TypeError(
-                        f'Value {discriminator_value!r} for discriminator '
-                        f'{self.discriminator!r} mapped to multiple choices'
-                    )
-            else:
-                self._tagged_union_choices[discriminator_value] = choice
diff --git a/lib/pydantic/_internal/_fields.py b/lib/pydantic/_internal/_fields.py
deleted file mode 100644
index 94de3062..00000000
--- a/lib/pydantic/_internal/_fields.py
+++ /dev/null
@@ -1,319 +0,0 @@
-"""Private logic related to fields (the `Field()` function and `FieldInfo` class), and arguments to `Annotated`."""
-from __future__ import annotations as _annotations
-
-import dataclasses
-import sys
-import warnings
-from copy import copy
-from functools import lru_cache
-from typing import TYPE_CHECKING, Any
-
-from pydantic_core import PydanticUndefined
-
-from pydantic.errors import PydanticUserError
-
-from . import _typing_extra
-from ._config import ConfigWrapper
-from ._repr import Representation
-from ._typing_extra import get_cls_type_hints_lenient, get_type_hints, is_classvar, is_finalvar
-
-if TYPE_CHECKING:
-    from annotated_types import BaseMetadata
-
-    from ..fields import FieldInfo
-    from ..main import BaseModel
-    from ._dataclasses import StandardDataclass
-    from ._decorators import DecoratorInfos
-
-
-def get_type_hints_infer_globalns(
-    obj: Any,
-    localns: dict[str, Any] | None = None,
-    include_extras: bool = False,
-) -> dict[str, Any]:
-    """Gets type hints for an object by inferring the global namespace.
-
-    It uses the `typing.get_type_hints`, The only thing that we do here is fetching
-    global namespace from `obj.__module__` if it is not `None`.
-
-    Args:
-        obj: The object to get its type hints.
-        localns: The local namespaces.
-        include_extras: Whether to recursively include annotation metadata.
-
-    Returns:
-        The object type hints.
-    """
-    module_name = getattr(obj, '__module__', None)
-    globalns: dict[str, Any] | None = None
-    if module_name:
-        try:
-            globalns = sys.modules[module_name].__dict__
-        except KeyError:
-            # happens occasionally, see https://github.com/pydantic/pydantic/issues/2363
-            pass
-    return get_type_hints(obj, globalns=globalns, localns=localns, include_extras=include_extras)
-
-
-class PydanticMetadata(Representation):
-    """Base class for annotation markers like `Strict`."""
-
-    __slots__ = ()
-
-
-def pydantic_general_metadata(**metadata: Any) -> BaseMetadata:
-    """Create a new `_PydanticGeneralMetadata` class with the given metadata.
-
-    Args:
-        **metadata: The metadata to add.
-
-    Returns:
-        The new `_PydanticGeneralMetadata` class.
-    """
-    return _general_metadata_cls()(metadata)  # type: ignore
-
-
-@lru_cache(maxsize=None)
-def _general_metadata_cls() -> type[BaseMetadata]:
-    """Do it this way to avoid importing `annotated_types` at import time."""
-    from annotated_types import BaseMetadata
-
-    class _PydanticGeneralMetadata(PydanticMetadata, BaseMetadata):
-        """Pydantic general metadata like `max_digits`."""
-
-        def __init__(self, metadata: Any):
-            self.__dict__ = metadata
-
-    return _PydanticGeneralMetadata  # type: ignore
-
-
-def collect_model_fields(  # noqa: C901
-    cls: type[BaseModel],
-    bases: tuple[type[Any], ...],
-    config_wrapper: ConfigWrapper,
-    types_namespace: dict[str, Any] | None,
-    *,
-    typevars_map: dict[Any, Any] | None = None,
-) -> tuple[dict[str, FieldInfo], set[str]]:
-    """Collect the fields of a nascent pydantic model.
-
-    Also collect the names of any ClassVars present in the type hints.
-
-    The returned value is a tuple of two items: the fields dict, and the set of ClassVar names.
-
-    Args:
-        cls: BaseModel or dataclass.
-        bases: Parents of the class, generally `cls.__bases__`.
-        config_wrapper: The config wrapper instance.
-        types_namespace: Optional extra namespace to look for types in.
-        typevars_map: A dictionary mapping type variables to their concrete types.
-
-    Returns:
-        A tuple contains fields and class variables.
-
-    Raises:
-        NameError:
-            - If there is a conflict between a field name and protected namespaces.
-            - If there is a field other than `root` in `RootModel`.
-            - If a field shadows an attribute in the parent model.
-    """
-    from ..fields import FieldInfo
-
-    type_hints = get_cls_type_hints_lenient(cls, types_namespace)
-
-    # https://docs.python.org/3/howto/annotations.html#accessing-the-annotations-dict-of-an-object-in-python-3-9-and-older
-    # annotations is only used for finding fields in parent classes
-    annotations = cls.__dict__.get('__annotations__', {})
-    fields: dict[str, FieldInfo] = {}
-
-    class_vars: set[str] = set()
-    for ann_name, ann_type in type_hints.items():
-        if ann_name == 'model_config':
-            # We never want to treat `model_config` as a field
-            # Note: we may need to change this logic if/when we introduce a `BareModel` class with no
-            # protected namespaces (where `model_config` might be allowed as a field name)
-            continue
-        for protected_namespace in config_wrapper.protected_namespaces:
-            if ann_name.startswith(protected_namespace):
-                for b in bases:
-                    if hasattr(b, ann_name):
-                        from ..main import BaseModel
-
-                        if not (issubclass(b, BaseModel) and ann_name in b.model_fields):
-                            raise NameError(
-                                f'Field "{ann_name}" conflicts with member {getattr(b, ann_name)}'
-                                f' of protected namespace "{protected_namespace}".'
-                            )
-                else:
-                    valid_namespaces = tuple(
-                        x for x in config_wrapper.protected_namespaces if not ann_name.startswith(x)
-                    )
-                    warnings.warn(
-                        f'Field "{ann_name}" has conflict with protected namespace "{protected_namespace}".'
-                        '\n\nYou may be able to resolve this warning by setting'
-                        f" `model_config['protected_namespaces'] = {valid_namespaces}`.",
-                        UserWarning,
-                    )
-        if is_classvar(ann_type):
-            class_vars.add(ann_name)
-            continue
-        if _is_finalvar_with_default_val(ann_type, getattr(cls, ann_name, PydanticUndefined)):
-            class_vars.add(ann_name)
-            continue
-        if not is_valid_field_name(ann_name):
-            continue
-        if cls.__pydantic_root_model__ and ann_name != 'root':
-            raise NameError(
-                f"Unexpected field with name {ann_name!r}; only 'root' is allowed as a field of a `RootModel`"
-            )
-
-        # when building a generic model with `MyModel[int]`, the generic_origin check makes sure we don't get
-        # "... shadows an attribute" errors
-        generic_origin = getattr(cls, '__pydantic_generic_metadata__', {}).get('origin')
-        for base in bases:
-            dataclass_fields = {
-                field.name for field in (dataclasses.fields(base) if dataclasses.is_dataclass(base) else ())
-            }
-            if hasattr(base, ann_name):
-                if base is generic_origin:
-                    # Don't error when "shadowing" of attributes in parametrized generics
-                    continue
-
-                if ann_name in dataclass_fields:
-                    # Don't error when inheriting stdlib dataclasses whose fields are "shadowed" by defaults being set
-                    # on the class instance.
-                    continue
-                warnings.warn(
-                    f'Field name "{ann_name}" shadows an attribute in parent "{base.__qualname__}"; ',
-                    UserWarning,
-                )
-
-        try:
-            default = getattr(cls, ann_name, PydanticUndefined)
-            if default is PydanticUndefined:
-                raise AttributeError
-        except AttributeError:
-            if ann_name in annotations:
-                field_info = FieldInfo.from_annotation(ann_type)
-            else:
-                # if field has no default value and is not in __annotations__ this means that it is
-                # defined in a base class and we can take it from there
-                model_fields_lookup: dict[str, FieldInfo] = {}
-                for x in cls.__bases__[::-1]:
-                    model_fields_lookup.update(getattr(x, 'model_fields', {}))
-                if ann_name in model_fields_lookup:
-                    # The field was present on one of the (possibly multiple) base classes
-                    # copy the field to make sure typevar substitutions don't cause issues with the base classes
-                    field_info = copy(model_fields_lookup[ann_name])
-                else:
-                    # The field was not found on any base classes; this seems to be caused by fields not getting
-                    # generated thanks to models not being fully defined while initializing recursive models.
-                    # Nothing stops us from just creating a new FieldInfo for this type hint, so we do this.
-                    field_info = FieldInfo.from_annotation(ann_type)
-        else:
-            field_info = FieldInfo.from_annotated_attribute(ann_type, default)
-            # attributes which are fields are removed from the class namespace:
-            # 1. To match the behaviour of annotation-only fields
-            # 2. To avoid false positives in the NameError check above
-            try:
-                delattr(cls, ann_name)
-            except AttributeError:
-                pass  # indicates the attribute was on a parent class
-
-        # Use cls.__dict__['__pydantic_decorators__'] instead of cls.__pydantic_decorators__
-        # to make sure the decorators have already been built for this exact class
-        decorators: DecoratorInfos = cls.__dict__['__pydantic_decorators__']
-        if ann_name in decorators.computed_fields:
-            raise ValueError("you can't override a field with a computed field")
-        fields[ann_name] = field_info
-
-    if typevars_map:
-        for field in fields.values():
-            field.apply_typevars_map(typevars_map, types_namespace)
-
-    return fields, class_vars
-
-
-def _is_finalvar_with_default_val(type_: type[Any], val: Any) -> bool:
-    from ..fields import FieldInfo
-
-    if not is_finalvar(type_):
-        return False
-    elif val is PydanticUndefined:
-        return False
-    elif isinstance(val, FieldInfo) and (val.default is PydanticUndefined and val.default_factory is None):
-        return False
-    else:
-        return True
-
-
-def collect_dataclass_fields(
-    cls: type[StandardDataclass], types_namespace: dict[str, Any] | None, *, typevars_map: dict[Any, Any] | None = None
-) -> dict[str, FieldInfo]:
-    """Collect the fields of a dataclass.
-
-    Args:
-        cls: dataclass.
-        types_namespace: Optional extra namespace to look for types in.
-        typevars_map: A dictionary mapping type variables to their concrete types.
-
-    Returns:
-        The dataclass fields.
-    """
-    from ..fields import FieldInfo
-
-    fields: dict[str, FieldInfo] = {}
-    dataclass_fields: dict[str, dataclasses.Field] = cls.__dataclass_fields__
-    cls_localns = dict(vars(cls))  # this matches get_cls_type_hints_lenient, but all tests pass with `= None` instead
-
-    source_module = sys.modules.get(cls.__module__)
-    if source_module is not None:
-        types_namespace = {**source_module.__dict__, **(types_namespace or {})}
-
-    for ann_name, dataclass_field in dataclass_fields.items():
-        ann_type = _typing_extra.eval_type_lenient(dataclass_field.type, types_namespace, cls_localns)
-        if is_classvar(ann_type):
-            continue
-
-        if (
-            not dataclass_field.init
-            and dataclass_field.default == dataclasses.MISSING
-            and dataclass_field.default_factory == dataclasses.MISSING
-        ):
-            # TODO: We should probably do something with this so that validate_assignment behaves properly
-            #   Issue: https://github.com/pydantic/pydantic/issues/5470
-            continue
-
-        if isinstance(dataclass_field.default, FieldInfo):
-            if dataclass_field.default.init_var:
-                if dataclass_field.default.init is False:
-                    raise PydanticUserError(
-                        f'Dataclass field {ann_name} has init=False and init_var=True, but these are mutually exclusive.',
-                        code='clashing-init-and-init-var',
-                    )
-
-                # TODO: same note as above re validate_assignment
-                continue
-            field_info = FieldInfo.from_annotated_attribute(ann_type, dataclass_field.default)
-        else:
-            field_info = FieldInfo.from_annotated_attribute(ann_type, dataclass_field)
-
-        fields[ann_name] = field_info
-
-        if field_info.default is not PydanticUndefined and isinstance(getattr(cls, ann_name, field_info), FieldInfo):
-            # We need this to fix the default when the "default" from __dataclass_fields__ is a pydantic.FieldInfo
-            setattr(cls, ann_name, field_info.default)
-
-    if typevars_map:
-        for field in fields.values():
-            field.apply_typevars_map(typevars_map, types_namespace)
-
-    return fields
-
-
-def is_valid_field_name(name: str) -> bool:
-    return not name.startswith('_')
-
-
-def is_valid_privateattr_name(name: str) -> bool:
-    return name.startswith('_') and not name.startswith('__')
diff --git a/lib/pydantic/_internal/_forward_ref.py b/lib/pydantic/_internal/_forward_ref.py
deleted file mode 100644
index 231f81d1..00000000
--- a/lib/pydantic/_internal/_forward_ref.py
+++ /dev/null
@@ -1,23 +0,0 @@
-from __future__ import annotations as _annotations
-
-from dataclasses import dataclass
-from typing import Union
-
-
-@dataclass
-class PydanticRecursiveRef:
-    type_ref: str
-
-    __name__ = 'PydanticRecursiveRef'
-    __hash__ = object.__hash__
-
-    def __call__(self) -> None:
-        """Defining __call__ is necessary for the `typing` module to let you use an instance of
-        this class as the result of resolving a standard ForwardRef.
-        """
-
-    def __or__(self, other):
-        return Union[self, other]  # type: ignore
-
-    def __ror__(self, other):
-        return Union[other, self]  # type: ignore
diff --git a/lib/pydantic/_internal/_generate_schema.py b/lib/pydantic/_internal/_generate_schema.py
deleted file mode 100644
index 6ab7ec19..00000000
--- a/lib/pydantic/_internal/_generate_schema.py
+++ /dev/null
@@ -1,2231 +0,0 @@
-"""Convert python types to pydantic-core schema."""
-from __future__ import annotations as _annotations
-
-import collections.abc
-import dataclasses
-import inspect
-import re
-import sys
-import typing
-import warnings
-from contextlib import contextmanager
-from copy import copy, deepcopy
-from enum import Enum
-from functools import partial
-from inspect import Parameter, _ParameterKind, signature
-from itertools import chain
-from operator import attrgetter
-from types import FunctionType, LambdaType, MethodType
-from typing import (
-    TYPE_CHECKING,
-    Any,
-    Callable,
-    Dict,
-    Final,
-    ForwardRef,
-    Iterable,
-    Iterator,
-    Mapping,
-    Type,
-    TypeVar,
-    Union,
-    cast,
-    overload,
-)
-from warnings import warn
-
-from pydantic_core import CoreSchema, PydanticUndefined, core_schema, to_jsonable_python
-from typing_extensions import Annotated, Literal, TypeAliasType, TypedDict, get_args, get_origin, is_typeddict
-
-from ..aliases import AliasGenerator
-from ..annotated_handlers import GetCoreSchemaHandler, GetJsonSchemaHandler
-from ..config import ConfigDict, JsonDict, JsonEncoder
-from ..errors import PydanticSchemaGenerationError, PydanticUndefinedAnnotation, PydanticUserError
-from ..json_schema import JsonSchemaValue
-from ..version import version_short
-from ..warnings import PydanticDeprecatedSince20
-from . import _core_utils, _decorators, _discriminated_union, _known_annotated_metadata, _typing_extra
-from ._config import ConfigWrapper, ConfigWrapperStack
-from ._core_metadata import CoreMetadataHandler, build_metadata_dict
-from ._core_utils import (
-    CoreSchemaOrField,
-    collect_invalid_schemas,
-    define_expected_missing_refs,
-    get_ref,
-    get_type_ref,
-    is_function_with_inner_schema,
-    is_list_like_schema_with_items_schema,
-    simplify_schema_references,
-    validate_core_schema,
-)
-from ._decorators import (
-    Decorator,
-    DecoratorInfos,
-    FieldSerializerDecoratorInfo,
-    FieldValidatorDecoratorInfo,
-    ModelSerializerDecoratorInfo,
-    ModelValidatorDecoratorInfo,
-    RootValidatorDecoratorInfo,
-    ValidatorDecoratorInfo,
-    get_attribute_from_bases,
-    inspect_field_serializer,
-    inspect_model_serializer,
-    inspect_validator,
-)
-from ._fields import collect_dataclass_fields, get_type_hints_infer_globalns
-from ._forward_ref import PydanticRecursiveRef
-from ._generics import get_standard_typevars_map, has_instance_in_type, recursively_defined_type_refs, replace_types
-from ._schema_generation_shared import (
-    CallbackGetCoreSchemaHandler,
-)
-from ._typing_extra import is_finalvar
-from ._utils import lenient_issubclass
-
-if TYPE_CHECKING:
-    from ..fields import ComputedFieldInfo, FieldInfo
-    from ..main import BaseModel
-    from ..types import Discriminator
-    from ..validators import FieldValidatorModes
-    from ._dataclasses import StandardDataclass
-    from ._schema_generation_shared import GetJsonSchemaFunction
-
-_SUPPORTS_TYPEDDICT = sys.version_info >= (3, 12)
-_AnnotatedType = type(Annotated[int, 123])
-
-FieldDecoratorInfo = Union[ValidatorDecoratorInfo, FieldValidatorDecoratorInfo, FieldSerializerDecoratorInfo]
-FieldDecoratorInfoType = TypeVar('FieldDecoratorInfoType', bound=FieldDecoratorInfo)
-AnyFieldDecorator = Union[
-    Decorator[ValidatorDecoratorInfo],
-    Decorator[FieldValidatorDecoratorInfo],
-    Decorator[FieldSerializerDecoratorInfo],
-]
-
-ModifyCoreSchemaWrapHandler = GetCoreSchemaHandler
-GetCoreSchemaFunction = Callable[[Any, ModifyCoreSchemaWrapHandler], core_schema.CoreSchema]
-
-
-TUPLE_TYPES: list[type] = [tuple, typing.Tuple]
-LIST_TYPES: list[type] = [list, typing.List, collections.abc.MutableSequence]
-SET_TYPES: list[type] = [set, typing.Set, collections.abc.MutableSet]
-FROZEN_SET_TYPES: list[type] = [frozenset, typing.FrozenSet, collections.abc.Set]
-DICT_TYPES: list[type] = [dict, typing.Dict, collections.abc.MutableMapping, collections.abc.Mapping]
-
-
-def check_validator_fields_against_field_name(
-    info: FieldDecoratorInfo,
-    field: str,
-) -> bool:
-    """Check if field name is in validator fields.
-
-    Args:
-        info: The field info.
-        field: The field name to check.
-
-    Returns:
-        `True` if field name is in validator fields, `False` otherwise.
-    """
-    if isinstance(info, (ValidatorDecoratorInfo, FieldValidatorDecoratorInfo)):
-        if '*' in info.fields:
-            return True
-    for v_field_name in info.fields:
-        if v_field_name == field:
-            return True
-    return False
-
-
-def check_decorator_fields_exist(decorators: Iterable[AnyFieldDecorator], fields: Iterable[str]) -> None:
-    """Check if the defined fields in decorators exist in `fields` param.
-
-    It ignores the check for a decorator if the decorator has `*` as field or `check_fields=False`.
-
-    Args:
-        decorators: An iterable of decorators.
-        fields: An iterable of fields name.
-
-    Raises:
-        PydanticUserError: If one of the field names does not exist in `fields` param.
-    """
-    fields = set(fields)
-    for dec in decorators:
-        if isinstance(dec.info, (ValidatorDecoratorInfo, FieldValidatorDecoratorInfo)) and '*' in dec.info.fields:
-            continue
-        if dec.info.check_fields is False:
-            continue
-        for field in dec.info.fields:
-            if field not in fields:
-                raise PydanticUserError(
-                    f'Decorators defined with incorrect fields: {dec.cls_ref}.{dec.cls_var_name}'
-                    " (use check_fields=False if you're inheriting from the model and intended this)",
-                    code='decorator-missing-field',
-                )
-
-
-def filter_field_decorator_info_by_field(
-    validator_functions: Iterable[Decorator[FieldDecoratorInfoType]], field: str
-) -> list[Decorator[FieldDecoratorInfoType]]:
-    return [dec for dec in validator_functions if check_validator_fields_against_field_name(dec.info, field)]
-
-
-def apply_each_item_validators(
-    schema: core_schema.CoreSchema,
-    each_item_validators: list[Decorator[ValidatorDecoratorInfo]],
-    field_name: str | None,
-) -> core_schema.CoreSchema:
-    # This V1 compatibility shim should eventually be removed
-
-    # push down any `each_item=True` validators
-    # note that this won't work for any Annotated types that get wrapped by a function validator
-    # but that's okay because that didn't exist in V1
-    if schema['type'] == 'nullable':
-        schema['schema'] = apply_each_item_validators(schema['schema'], each_item_validators, field_name)
-        return schema
-    elif schema['type'] == 'tuple':
-        if (variadic_item_index := schema.get('variadic_item_index')) is not None:
-            schema['items_schema'][variadic_item_index] = apply_validators(
-                schema['items_schema'][variadic_item_index], each_item_validators, field_name
-            )
-    elif is_list_like_schema_with_items_schema(schema):
-        inner_schema = schema.get('items_schema', None)
-        if inner_schema is None:
-            inner_schema = core_schema.any_schema()
-        schema['items_schema'] = apply_validators(inner_schema, each_item_validators, field_name)
-    elif schema['type'] == 'dict':
-        # push down any `each_item=True` validators onto dict _values_
-        # this is super arbitrary but it's the V1 behavior
-        inner_schema = schema.get('values_schema', None)
-        if inner_schema is None:
-            inner_schema = core_schema.any_schema()
-        schema['values_schema'] = apply_validators(inner_schema, each_item_validators, field_name)
-    elif each_item_validators:
-        raise TypeError(
-            f"`@validator(..., each_item=True)` cannot be applied to fields with a schema of {schema['type']}"
-        )
-    return schema
-
-
-def modify_model_json_schema(
-    schema_or_field: CoreSchemaOrField, handler: GetJsonSchemaHandler, *, cls: Any
-) -> JsonSchemaValue:
-    """Add title and description for model-like classes' JSON schema.
-
-    Args:
-        schema_or_field: The schema data to generate a JSON schema from.
-        handler: The `GetCoreSchemaHandler` instance.
-        cls: The model-like class.
-
-    Returns:
-        JsonSchemaValue: The updated JSON schema.
-    """
-    from ..main import BaseModel
-
-    json_schema = handler(schema_or_field)
-    original_schema = handler.resolve_ref_schema(json_schema)
-    # Preserve the fact that definitions schemas should never have sibling keys:
-    if '$ref' in original_schema:
-        ref = original_schema['$ref']
-        original_schema.clear()
-        original_schema['allOf'] = [{'$ref': ref}]
-    if 'title' not in original_schema:
-        original_schema['title'] = cls.__name__
-    # BaseModel; don't use cls.__doc__ as it will contain the verbose class signature by default
-    docstring = None if cls is BaseModel else cls.__doc__
-    if docstring and 'description' not in original_schema:
-        original_schema['description'] = inspect.cleandoc(docstring)
-    return json_schema
-
-
-JsonEncoders = Dict[Type[Any], JsonEncoder]
-
-
-def _add_custom_serialization_from_json_encoders(
-    json_encoders: JsonEncoders | None, tp: Any, schema: CoreSchema
-) -> CoreSchema:
-    """Iterate over the json_encoders and add the first matching encoder to the schema.
-
-    Args:
-        json_encoders: A dictionary of types and their encoder functions.
-        tp: The type to check for a matching encoder.
-        schema: The schema to add the encoder to.
-    """
-    if not json_encoders:
-        return schema
-    if 'serialization' in schema:
-        return schema
-    # Check the class type and its superclasses for a matching encoder
-    # Decimal.__class__.__mro__ (and probably other cases) doesn't include Decimal itself
-    # if the type is a GenericAlias (e.g. from list[int]) we need to use __class__ instead of .__mro__
-    for base in (tp, *getattr(tp, '__mro__', tp.__class__.__mro__)[:-1]):
-        encoder = json_encoders.get(base)
-        if encoder is None:
-            continue
-
-        warnings.warn(
-            f'`json_encoders` is deprecated. See https://docs.pydantic.dev/{version_short()}/concepts/serialization/#custom-serializers for alternatives',
-            PydanticDeprecatedSince20,
-        )
-
-        # TODO: in theory we should check that the schema accepts a serialization key
-        schema['serialization'] = core_schema.plain_serializer_function_ser_schema(encoder, when_used='json')
-        return schema
-
-    return schema
-
-
-TypesNamespace = Union[Dict[str, Any], None]
-
-
-class TypesNamespaceStack:
-    """A stack of types namespaces."""
-
-    def __init__(self, types_namespace: TypesNamespace):
-        self._types_namespace_stack: list[TypesNamespace] = [types_namespace]
-
-    @property
-    def tail(self) -> TypesNamespace:
-        return self._types_namespace_stack[-1]
-
-    @contextmanager
-    def push(self, for_type: type[Any]):
-        types_namespace = {**_typing_extra.get_cls_types_namespace(for_type), **(self.tail or {})}
-        self._types_namespace_stack.append(types_namespace)
-        try:
-            yield
-        finally:
-            self._types_namespace_stack.pop()
-
-
-class GenerateSchema:
-    """Generate core schema for a Pydantic model, dataclass and types like `str`, `datetime`, ... ."""
-
-    __slots__ = (
-        '_config_wrapper_stack',
-        '_types_namespace_stack',
-        '_typevars_map',
-        '_has_invalid_schema',
-        'field_name_stack',
-        'defs',
-    )
-
-    def __init__(
-        self,
-        config_wrapper: ConfigWrapper,
-        types_namespace: dict[str, Any] | None,
-        typevars_map: dict[Any, Any] | None = None,
-    ) -> None:
-        # we need a stack for recursing into child models
-        self._config_wrapper_stack = ConfigWrapperStack(config_wrapper)
-        self._types_namespace_stack = TypesNamespaceStack(types_namespace)
-        self._typevars_map = typevars_map
-        self._has_invalid_schema = False
-        self.field_name_stack = _FieldNameStack()
-        self.defs = _Definitions()
-
-    @classmethod
-    def __from_parent(
-        cls,
-        config_wrapper_stack: ConfigWrapperStack,
-        types_namespace_stack: TypesNamespaceStack,
-        typevars_map: dict[Any, Any] | None,
-        defs: _Definitions,
-    ) -> GenerateSchema:
-        obj = cls.__new__(cls)
-        obj._config_wrapper_stack = config_wrapper_stack
-        obj._types_namespace_stack = types_namespace_stack
-        obj._typevars_map = typevars_map
-        obj._has_invalid_schema = False
-        obj.field_name_stack = _FieldNameStack()
-        obj.defs = defs
-        return obj
-
-    @property
-    def _config_wrapper(self) -> ConfigWrapper:
-        return self._config_wrapper_stack.tail
-
-    @property
-    def _types_namespace(self) -> dict[str, Any] | None:
-        return self._types_namespace_stack.tail
-
-    @property
-    def _current_generate_schema(self) -> GenerateSchema:
-        cls = self._config_wrapper.schema_generator or GenerateSchema
-        return cls.__from_parent(
-            self._config_wrapper_stack,
-            self._types_namespace_stack,
-            self._typevars_map,
-            self.defs,
-        )
-
-    @property
-    def _arbitrary_types(self) -> bool:
-        return self._config_wrapper.arbitrary_types_allowed
-
-    def str_schema(self) -> CoreSchema:
-        """Generate a CoreSchema for `str`"""
-        return core_schema.str_schema()
-
-    # the following methods can be overridden but should be considered
-    # unstable / private APIs
-    def _list_schema(self, tp: Any, items_type: Any) -> CoreSchema:
-        return core_schema.list_schema(self.generate_schema(items_type))
-
-    def _dict_schema(self, tp: Any, keys_type: Any, values_type: Any) -> CoreSchema:
-        return core_schema.dict_schema(self.generate_schema(keys_type), self.generate_schema(values_type))
-
-    def _set_schema(self, tp: Any, items_type: Any) -> CoreSchema:
-        return core_schema.set_schema(self.generate_schema(items_type))
-
-    def _frozenset_schema(self, tp: Any, items_type: Any) -> CoreSchema:
-        return core_schema.frozenset_schema(self.generate_schema(items_type))
-
-    def _arbitrary_type_schema(self, tp: Any) -> CoreSchema:
-        if not isinstance(tp, type):
-            warn(
-                f'{tp!r} is not a Python type (it may be an instance of an object),'
-                ' Pydantic will allow any object with no validation since we cannot even'
-                ' enforce that the input is an instance of the given type.'
-                ' To get rid of this error wrap the type with `pydantic.SkipValidation`.',
-                UserWarning,
-            )
-            return core_schema.any_schema()
-        return core_schema.is_instance_schema(tp)
-
-    def _unknown_type_schema(self, obj: Any) -> CoreSchema:
-        raise PydanticSchemaGenerationError(
-            f'Unable to generate pydantic-core schema for {obj!r}. '
-            'Set `arbitrary_types_allowed=True` in the model_config to ignore this error'
-            ' or implement `__get_pydantic_core_schema__` on your type to fully support it.'
-            '\n\nIf you got this error by calling handler(<some type>) within'
-            ' `__get_pydantic_core_schema__` then you likely need to call'
-            ' `handler.generate_schema(<some type>)` since we do not call'
-            ' `__get_pydantic_core_schema__` on `<some type>` otherwise to avoid infinite recursion.'
-        )
-
-    def _apply_discriminator_to_union(
-        self, schema: CoreSchema, discriminator: str | Discriminator | None
-    ) -> CoreSchema:
-        if discriminator is None:
-            return schema
-        try:
-            return _discriminated_union.apply_discriminator(
-                schema,
-                discriminator,
-            )
-        except _discriminated_union.MissingDefinitionForUnionRef:
-            # defer until defs are resolved
-            _discriminated_union.set_discriminator_in_metadata(
-                schema,
-                discriminator,
-            )
-            return schema
-
-    class CollectedInvalid(Exception):
-        pass
-
-    def clean_schema(self, schema: CoreSchema) -> CoreSchema:
-        schema = self.collect_definitions(schema)
-        schema = simplify_schema_references(schema)
-        schema = _discriminated_union.apply_discriminators(schema)
-        if collect_invalid_schemas(schema):
-            raise self.CollectedInvalid()
-        schema = validate_core_schema(schema)
-        return schema
-
-    def collect_definitions(self, schema: CoreSchema) -> CoreSchema:
-        ref = cast('str | None', schema.get('ref', None))
-        if ref:
-            self.defs.definitions[ref] = schema
-        if 'ref' in schema:
-            schema = core_schema.definition_reference_schema(schema['ref'])
-        return core_schema.definitions_schema(
-            schema,
-            list(self.defs.definitions.values()),
-        )
-
-    def _add_js_function(self, metadata_schema: CoreSchema, js_function: Callable[..., Any]) -> None:
-        metadata = CoreMetadataHandler(metadata_schema).metadata
-        pydantic_js_functions = metadata.setdefault('pydantic_js_functions', [])
-        # because of how we generate core schemas for nested generic models
-        # we can end up adding `BaseModel.__get_pydantic_json_schema__` multiple times
-        # this check may fail to catch duplicates if the function is a `functools.partial`
-        # or something like that
-        # but if it does it'll fail by inserting the duplicate
-        if js_function not in pydantic_js_functions:
-            pydantic_js_functions.append(js_function)
-
-    def generate_schema(
-        self,
-        obj: Any,
-        from_dunder_get_core_schema: bool = True,
-    ) -> core_schema.CoreSchema:
-        """Generate core schema.
-
-        Args:
-            obj: The object to generate core schema for.
-            from_dunder_get_core_schema: Whether to generate schema from either the
-                `__get_pydantic_core_schema__` function or `__pydantic_core_schema__` property.
-
-        Returns:
-            The generated core schema.
-
-        Raises:
-            PydanticUndefinedAnnotation:
-                If it is not possible to evaluate forward reference.
-            PydanticSchemaGenerationError:
-                If it is not possible to generate pydantic-core schema.
-            TypeError:
-                - If `alias_generator` returns a disallowed type (must be str, AliasPath or AliasChoices).
-                - If V1 style validator with `each_item=True` applied on a wrong field.
-            PydanticUserError:
-                - If `typing.TypedDict` is used instead of `typing_extensions.TypedDict` on Python < 3.12.
-                - If `__modify_schema__` method is used instead of `__get_pydantic_json_schema__`.
-        """
-        schema: CoreSchema | None = None
-
-        if from_dunder_get_core_schema:
-            from_property = self._generate_schema_from_property(obj, obj)
-            if from_property is not None:
-                schema = from_property
-
-        if schema is None:
-            schema = self._generate_schema(obj)
-
-        metadata_js_function = _extract_get_pydantic_json_schema(obj, schema)
-        if metadata_js_function is not None:
-            metadata_schema = resolve_original_schema(schema, self.defs.definitions)
-            if metadata_schema:
-                self._add_js_function(metadata_schema, metadata_js_function)
-
-        schema = _add_custom_serialization_from_json_encoders(self._config_wrapper.json_encoders, obj, schema)
-
-        schema = self._post_process_generated_schema(schema)
-
-        return schema
-
-    def _model_schema(self, cls: type[BaseModel]) -> core_schema.CoreSchema:
-        """Generate schema for a Pydantic model."""
-        with self.defs.get_schema_or_ref(cls) as (model_ref, maybe_schema):
-            if maybe_schema is not None:
-                return maybe_schema
-
-            fields = cls.model_fields
-            decorators = cls.__pydantic_decorators__
-            computed_fields = decorators.computed_fields
-            check_decorator_fields_exist(
-                chain(
-                    decorators.field_validators.values(),
-                    decorators.field_serializers.values(),
-                    decorators.validators.values(),
-                ),
-                {*fields.keys(), *computed_fields.keys()},
-            )
-            config_wrapper = ConfigWrapper(cls.model_config, check=False)
-            core_config = config_wrapper.core_config(cls)
-            metadata = build_metadata_dict(js_functions=[partial(modify_model_json_schema, cls=cls)])
-
-            model_validators = decorators.model_validators.values()
-
-            extras_schema = None
-            if core_config.get('extra_fields_behavior') == 'allow':
-                for tp in (cls, *cls.__mro__):
-                    extras_annotation = cls.__annotations__.get('__pydantic_extra__', None)
-                    if extras_annotation is not None:
-                        tp = get_origin(extras_annotation)
-                        if tp not in (Dict, dict):
-                            raise PydanticSchemaGenerationError(
-                                'The type annotation for `__pydantic_extra__` must be `Dict[str, ...]`'
-                            )
-                        extra_items_type = self._get_args_resolving_forward_refs(
-                            cls.__annotations__['__pydantic_extra__'],
-                            required=True,
-                        )[1]
-                        if extra_items_type is not Any:
-                            extras_schema = self.generate_schema(extra_items_type)
-                            break
-
-            with self._config_wrapper_stack.push(config_wrapper), self._types_namespace_stack.push(cls):
-                self = self._current_generate_schema
-                if cls.__pydantic_root_model__:
-                    root_field = self._common_field_schema('root', fields['root'], decorators)
-                    inner_schema = root_field['schema']
-                    inner_schema = apply_model_validators(inner_schema, model_validators, 'inner')
-                    model_schema = core_schema.model_schema(
-                        cls,
-                        inner_schema,
-                        custom_init=getattr(cls, '__pydantic_custom_init__', None),
-                        root_model=True,
-                        post_init=getattr(cls, '__pydantic_post_init__', None),
-                        config=core_config,
-                        ref=model_ref,
-                        metadata=metadata,
-                    )
-                else:
-                    fields_schema: core_schema.CoreSchema = core_schema.model_fields_schema(
-                        {k: self._generate_md_field_schema(k, v, decorators) for k, v in fields.items()},
-                        computed_fields=[
-                            self._computed_field_schema(d, decorators.field_serializers)
-                            for d in computed_fields.values()
-                        ],
-                        extras_schema=extras_schema,
-                        model_name=cls.__name__,
-                    )
-                    inner_schema = apply_validators(fields_schema, decorators.root_validators.values(), None)
-                    new_inner_schema = define_expected_missing_refs(inner_schema, recursively_defined_type_refs())
-                    if new_inner_schema is not None:
-                        inner_schema = new_inner_schema
-                    inner_schema = apply_model_validators(inner_schema, model_validators, 'inner')
-
-                    model_schema = core_schema.model_schema(
-                        cls,
-                        inner_schema,
-                        custom_init=getattr(cls, '__pydantic_custom_init__', None),
-                        root_model=False,
-                        post_init=getattr(cls, '__pydantic_post_init__', None),
-                        config=core_config,
-                        ref=model_ref,
-                        metadata=metadata,
-                    )
-
-                schema = self._apply_model_serializers(model_schema, decorators.model_serializers.values())
-                schema = apply_model_validators(schema, model_validators, 'outer')
-                self.defs.definitions[model_ref] = self._post_process_generated_schema(schema)
-                return core_schema.definition_reference_schema(model_ref)
-
-    def _unpack_refs_defs(self, schema: CoreSchema) -> CoreSchema:
-        """Unpack all 'definitions' schemas into `GenerateSchema.defs.definitions`
-        and return the inner schema.
-        """
-
-        def get_ref(s: CoreSchema) -> str:
-            return s['ref']  # type: ignore
-
-        if schema['type'] == 'definitions':
-            self.defs.definitions.update({get_ref(s): s for s in schema['definitions']})
-            schema = schema['schema']
-        return schema
-
-    def _generate_schema_from_property(self, obj: Any, source: Any) -> core_schema.CoreSchema | None:
-        """Try to generate schema from either the `__get_pydantic_core_schema__` function or
-        `__pydantic_core_schema__` property.
-
-        Note: `__get_pydantic_core_schema__` takes priority so it can
-        decide whether to use a `__pydantic_core_schema__` attribute, or generate a fresh schema.
-        """
-        # avoid calling `__get_pydantic_core_schema__` if we've already visited this object
-        with self.defs.get_schema_or_ref(obj) as (_, maybe_schema):
-            if maybe_schema is not None:
-                return maybe_schema
-        if obj is source:
-            ref_mode = 'unpack'
-        else:
-            ref_mode = 'to-def'
-
-        schema: CoreSchema
-        get_schema = getattr(obj, '__get_pydantic_core_schema__', None)
-        if get_schema is None:
-            validators = getattr(obj, '__get_validators__', None)
-            if validators is None:
-                return None
-            warn(
-                '`__get_validators__` is deprecated and will be removed, use `__get_pydantic_core_schema__` instead.',
-                PydanticDeprecatedSince20,
-            )
-            schema = core_schema.chain_schema([core_schema.with_info_plain_validator_function(v) for v in validators()])
-        else:
-            if len(inspect.signature(get_schema).parameters) == 1:
-                # (source) -> CoreSchema
-                schema = get_schema(source)
-            else:
-                schema = get_schema(
-                    source, CallbackGetCoreSchemaHandler(self._generate_schema, self, ref_mode=ref_mode)
-                )
-
-        schema = self._unpack_refs_defs(schema)
-
-        if is_function_with_inner_schema(schema):
-            ref = schema['schema'].pop('ref', None)  # pyright: ignore[reportGeneralTypeIssues]
-            if ref:
-                schema['ref'] = ref
-        else:
-            ref = get_ref(schema)
-
-        if ref:
-            self.defs.definitions[ref] = self._post_process_generated_schema(schema)
-            return core_schema.definition_reference_schema(ref)
-
-        schema = self._post_process_generated_schema(schema)
-
-        return schema
-
-    def _resolve_forward_ref(self, obj: Any) -> Any:
-        # we assume that types_namespace has the target of forward references in its scope,
-        # but this could fail, for example, if calling Validator on an imported type which contains
-        # forward references to other types only defined in the module from which it was imported
-        # `Validator(SomeImportedTypeAliasWithAForwardReference)`
-        # or the equivalent for BaseModel
-        # class Model(BaseModel):
-        #   x: SomeImportedTypeAliasWithAForwardReference
-        try:
-            obj = _typing_extra.eval_type_backport(obj, globalns=self._types_namespace)
-        except NameError as e:
-            raise PydanticUndefinedAnnotation.from_name_error(e) from e
-
-        # if obj is still a ForwardRef, it means we can't evaluate it, raise PydanticUndefinedAnnotation
-        if isinstance(obj, ForwardRef):
-            raise PydanticUndefinedAnnotation(obj.__forward_arg__, f'Unable to evaluate forward reference {obj}')
-
-        if self._typevars_map:
-            obj = replace_types(obj, self._typevars_map)
-
-        return obj
-
-    @overload
-    def _get_args_resolving_forward_refs(self, obj: Any, required: Literal[True]) -> tuple[Any, ...]:
-        ...
-
-    @overload
-    def _get_args_resolving_forward_refs(self, obj: Any) -> tuple[Any, ...] | None:
-        ...
-
-    def _get_args_resolving_forward_refs(self, obj: Any, required: bool = False) -> tuple[Any, ...] | None:
-        args = get_args(obj)
-        if args:
-            args = tuple([self._resolve_forward_ref(a) if isinstance(a, ForwardRef) else a for a in args])
-        elif required:  # pragma: no cover
-            raise TypeError(f'Expected {obj} to have generic parameters but it had none')
-        return args
-
-    def _get_first_arg_or_any(self, obj: Any) -> Any:
-        args = self._get_args_resolving_forward_refs(obj)
-        if not args:
-            return Any
-        return args[0]
-
-    def _get_first_two_args_or_any(self, obj: Any) -> tuple[Any, Any]:
-        args = self._get_args_resolving_forward_refs(obj)
-        if not args:
-            return (Any, Any)
-        if len(args) < 2:
-            origin = get_origin(obj)
-            raise TypeError(f'Expected two type arguments for {origin}, got 1')
-        return args[0], args[1]
-
-    def _post_process_generated_schema(self, schema: core_schema.CoreSchema) -> core_schema.CoreSchema:
-        if 'metadata' not in schema:
-            schema['metadata'] = {}
-        return schema
-
-    def _generate_schema(self, obj: Any) -> core_schema.CoreSchema:
-        """Recursively generate a pydantic-core schema for any supported python type."""
-        has_invalid_schema = self._has_invalid_schema
-        self._has_invalid_schema = False
-        schema = self._generate_schema_inner(obj)
-        self._has_invalid_schema = self._has_invalid_schema or has_invalid_schema
-        return schema
-
-    def _generate_schema_inner(self, obj: Any) -> core_schema.CoreSchema:
-        if isinstance(obj, _AnnotatedType):
-            return self._annotated_schema(obj)
-
-        if isinstance(obj, dict):
-            # we assume this is already a valid schema
-            return obj  # type: ignore[return-value]
-
-        if isinstance(obj, str):
-            obj = ForwardRef(obj)
-
-        if isinstance(obj, ForwardRef):
-            return self.generate_schema(self._resolve_forward_ref(obj))
-
-        from ..main import BaseModel
-
-        if lenient_issubclass(obj, BaseModel):
-            return self._model_schema(obj)
-
-        if isinstance(obj, PydanticRecursiveRef):
-            return core_schema.definition_reference_schema(schema_ref=obj.type_ref)
-
-        return self.match_type(obj)
-
-    def match_type(self, obj: Any) -> core_schema.CoreSchema:  # noqa: C901
-        """Main mapping of types to schemas.
-
-        The general structure is a series of if statements starting with the simple cases
-        (non-generic primitive types) and then handling generics and other more complex cases.
-
-        Each case either generates a schema directly, calls into a public user-overridable method
-        (like `GenerateSchema.tuple_variable_schema`) or calls into a private method that handles some
-        boilerplate before calling into the user-facing method (e.g. `GenerateSchema._tuple_schema`).
-
-        The idea is that we'll evolve this into adding more and more user facing methods over time
-        as they get requested and we figure out what the right API for them is.
-        """
-        if obj is str:
-            return self.str_schema()
-        elif obj is bytes:
-            return core_schema.bytes_schema()
-        elif obj is int:
-            return core_schema.int_schema()
-        elif obj is float:
-            return core_schema.float_schema()
-        elif obj is bool:
-            return core_schema.bool_schema()
-        elif obj is Any or obj is object:
-            return core_schema.any_schema()
-        elif obj is None or obj is _typing_extra.NoneType:
-            return core_schema.none_schema()
-        elif obj in TUPLE_TYPES:
-            return self._tuple_schema(obj)
-        elif obj in LIST_TYPES:
-            return self._list_schema(obj, self._get_first_arg_or_any(obj))
-        elif obj in SET_TYPES:
-            return self._set_schema(obj, self._get_first_arg_or_any(obj))
-        elif obj in FROZEN_SET_TYPES:
-            return self._frozenset_schema(obj, self._get_first_arg_or_any(obj))
-        elif obj in DICT_TYPES:
-            return self._dict_schema(obj, *self._get_first_two_args_or_any(obj))
-        elif isinstance(obj, TypeAliasType):
-            return self._type_alias_type_schema(obj)
-        elif obj == type:
-            return self._type_schema()
-        elif _typing_extra.is_callable_type(obj):
-            return core_schema.callable_schema()
-        elif _typing_extra.is_literal_type(obj):
-            return self._literal_schema(obj)
-        elif is_typeddict(obj):
-            return self._typed_dict_schema(obj, None)
-        elif _typing_extra.is_namedtuple(obj):
-            return self._namedtuple_schema(obj, None)
-        elif _typing_extra.is_new_type(obj):
-            # NewType, can't use isinstance because it fails <3.10
-            return self.generate_schema(obj.__supertype__)
-        elif obj == re.Pattern:
-            return self._pattern_schema(obj)
-        elif obj is collections.abc.Hashable or obj is typing.Hashable:
-            return self._hashable_schema()
-        elif isinstance(obj, typing.TypeVar):
-            return self._unsubstituted_typevar_schema(obj)
-        elif is_finalvar(obj):
-            if obj is Final:
-                return core_schema.any_schema()
-            return self.generate_schema(
-                self._get_first_arg_or_any(obj),
-            )
-        elif isinstance(obj, (FunctionType, LambdaType, MethodType, partial)):
-            return self._callable_schema(obj)
-        elif inspect.isclass(obj) and issubclass(obj, Enum):
-            from ._std_types_schema import get_enum_core_schema
-
-            return get_enum_core_schema(obj, self._config_wrapper.config_dict)
-
-        if _typing_extra.is_dataclass(obj):
-            return self._dataclass_schema(obj, None)
-
-        res = self._get_prepare_pydantic_annotations_for_known_type(obj, ())
-        if res is not None:
-            source_type, annotations = res
-            return self._apply_annotations(source_type, annotations)
-
-        origin = get_origin(obj)
-        if origin is not None:
-            return self._match_generic_type(obj, origin)
-
-        if self._arbitrary_types:
-            return self._arbitrary_type_schema(obj)
-        return self._unknown_type_schema(obj)
-
-    def _match_generic_type(self, obj: Any, origin: Any) -> CoreSchema:  # noqa: C901
-        if isinstance(origin, TypeAliasType):
-            return self._type_alias_type_schema(obj)
-
-        # Need to handle generic dataclasses before looking for the schema properties because attribute accesses
-        # on _GenericAlias delegate to the origin type, so lose the information about the concrete parametrization
-        # As a result, currently, there is no way to cache the schema for generic dataclasses. This may be possible
-        # to resolve by modifying the value returned by `Generic.__class_getitem__`, but that is a dangerous game.
-        if _typing_extra.is_dataclass(origin):
-            return self._dataclass_schema(obj, origin)
-        if _typing_extra.is_namedtuple(origin):
-            return self._namedtuple_schema(obj, origin)
-
-        from_property = self._generate_schema_from_property(origin, obj)
-        if from_property is not None:
-            return from_property
-
-        if _typing_extra.origin_is_union(origin):
-            return self._union_schema(obj)
-        elif origin in TUPLE_TYPES:
-            return self._tuple_schema(obj)
-        elif origin in LIST_TYPES:
-            return self._list_schema(obj, self._get_first_arg_or_any(obj))
-        elif origin in SET_TYPES:
-            return self._set_schema(obj, self._get_first_arg_or_any(obj))
-        elif origin in FROZEN_SET_TYPES:
-            return self._frozenset_schema(obj, self._get_first_arg_or_any(obj))
-        elif origin in DICT_TYPES:
-            return self._dict_schema(obj, *self._get_first_two_args_or_any(obj))
-        elif is_typeddict(origin):
-            return self._typed_dict_schema(obj, origin)
-        elif origin in (typing.Type, type):
-            return self._subclass_schema(obj)
-        elif origin in {typing.Sequence, collections.abc.Sequence}:
-            return self._sequence_schema(obj)
-        elif origin in {typing.Iterable, collections.abc.Iterable, typing.Generator, collections.abc.Generator}:
-            return self._iterable_schema(obj)
-        elif origin in (re.Pattern, typing.Pattern):
-            return self._pattern_schema(obj)
-
-        if self._arbitrary_types:
-            return self._arbitrary_type_schema(origin)
-        return self._unknown_type_schema(obj)
-
-    def _generate_td_field_schema(
-        self,
-        name: str,
-        field_info: FieldInfo,
-        decorators: DecoratorInfos,
-        *,
-        required: bool = True,
-    ) -> core_schema.TypedDictField:
-        """Prepare a TypedDictField to represent a model or typeddict field."""
-        common_field = self._common_field_schema(name, field_info, decorators)
-        return core_schema.typed_dict_field(
-            common_field['schema'],
-            required=False if not field_info.is_required() else required,
-            serialization_exclude=common_field['serialization_exclude'],
-            validation_alias=common_field['validation_alias'],
-            serialization_alias=common_field['serialization_alias'],
-            metadata=common_field['metadata'],
-        )
-
-    def _generate_md_field_schema(
-        self,
-        name: str,
-        field_info: FieldInfo,
-        decorators: DecoratorInfos,
-    ) -> core_schema.ModelField:
-        """Prepare a ModelField to represent a model field."""
-        common_field = self._common_field_schema(name, field_info, decorators)
-        return core_schema.model_field(
-            common_field['schema'],
-            serialization_exclude=common_field['serialization_exclude'],
-            validation_alias=common_field['validation_alias'],
-            serialization_alias=common_field['serialization_alias'],
-            frozen=common_field['frozen'],
-            metadata=common_field['metadata'],
-        )
-
-    def _generate_dc_field_schema(
-        self,
-        name: str,
-        field_info: FieldInfo,
-        decorators: DecoratorInfos,
-    ) -> core_schema.DataclassField:
-        """Prepare a DataclassField to represent the parameter/field, of a dataclass."""
-        common_field = self._common_field_schema(name, field_info, decorators)
-        return core_schema.dataclass_field(
-            name,
-            common_field['schema'],
-            init=field_info.init,
-            init_only=field_info.init_var or None,
-            kw_only=None if field_info.kw_only else False,
-            serialization_exclude=common_field['serialization_exclude'],
-            validation_alias=common_field['validation_alias'],
-            serialization_alias=common_field['serialization_alias'],
-            frozen=common_field['frozen'],
-            metadata=common_field['metadata'],
-        )
-
-    @staticmethod
-    def _apply_alias_generator_to_field_info(
-        alias_generator: Callable[[str], str] | AliasGenerator, field_info: FieldInfo, field_name: str
-    ) -> None:
-        """Apply an alias_generator to aliases on a FieldInfo instance if appropriate.
-
-        Args:
-            alias_generator: A callable that takes a string and returns a string, or an AliasGenerator instance.
-            field_info: The FieldInfo instance to which the alias_generator is (maybe) applied.
-            field_name: The name of the field from which to generate the alias.
-        """
-        # Apply an alias_generator if
-        # 1. An alias is not specified
-        # 2. An alias is specified, but the priority is <= 1
-        if (
-            field_info.alias_priority is None
-            or field_info.alias_priority <= 1
-            or field_info.alias is None
-            or field_info.validation_alias is None
-            or field_info.serialization_alias is None
-        ):
-            alias, validation_alias, serialization_alias = None, None, None
-
-            if isinstance(alias_generator, AliasGenerator):
-                alias, validation_alias, serialization_alias = alias_generator.generate_aliases(field_name)
-            elif isinstance(alias_generator, Callable):
-                alias = alias_generator(field_name)
-                if not isinstance(alias, str):
-                    raise TypeError(f'alias_generator {alias_generator} must return str, not {alias.__class__}')
-
-            # if priority is not set, we set to 1
-            # which supports the case where the alias_generator from a child class is used
-            # to generate an alias for a field in a parent class
-            if field_info.alias_priority is None or field_info.alias_priority <= 1:
-                field_info.alias_priority = 1
-
-            # if the priority is 1, then we set the aliases to the generated alias
-            if field_info.alias_priority == 1:
-                field_info.serialization_alias = serialization_alias or alias
-                field_info.validation_alias = validation_alias or alias
-                field_info.alias = alias
-
-            # if any of the aliases are not set, then we set them to the corresponding generated alias
-            if field_info.alias is None:
-                field_info.alias = alias
-            if field_info.serialization_alias is None:
-                field_info.serialization_alias = serialization_alias or alias
-            if field_info.validation_alias is None:
-                field_info.validation_alias = validation_alias or alias
-
-    @staticmethod
-    def _apply_alias_generator_to_computed_field_info(
-        alias_generator: Callable[[str], str] | AliasGenerator,
-        computed_field_info: ComputedFieldInfo,
-        computed_field_name: str,
-    ):
-        """Apply an alias_generator to alias on a ComputedFieldInfo instance if appropriate.
-
-        Args:
-            alias_generator: A callable that takes a string and returns a string, or an AliasGenerator instance.
-            computed_field_info: The ComputedFieldInfo instance to which the alias_generator is (maybe) applied.
-            computed_field_name: The name of the computed field from which to generate the alias.
-        """
-        # Apply an alias_generator if
-        # 1. An alias is not specified
-        # 2. An alias is specified, but the priority is <= 1
-
-        if (
-            computed_field_info.alias_priority is None
-            or computed_field_info.alias_priority <= 1
-            or computed_field_info.alias is None
-        ):
-            alias, validation_alias, serialization_alias = None, None, None
-
-            if isinstance(alias_generator, AliasGenerator):
-                alias, validation_alias, serialization_alias = alias_generator.generate_aliases(computed_field_name)
-            elif isinstance(alias_generator, Callable):
-                alias = alias_generator(computed_field_name)
-                if not isinstance(alias, str):
-                    raise TypeError(f'alias_generator {alias_generator} must return str, not {alias.__class__}')
-
-            # if priority is not set, we set to 1
-            # which supports the case where the alias_generator from a child class is used
-            # to generate an alias for a field in a parent class
-            if computed_field_info.alias_priority is None or computed_field_info.alias_priority <= 1:
-                computed_field_info.alias_priority = 1
-
-            # if the priority is 1, then we set the aliases to the generated alias
-            # note that we use the serialization_alias with priority over alias, as computed_field
-            # aliases are used for serialization only (not validation)
-            if computed_field_info.alias_priority == 1:
-                computed_field_info.alias = serialization_alias or alias
-
-    def _common_field_schema(  # C901
-        self, name: str, field_info: FieldInfo, decorators: DecoratorInfos
-    ) -> _CommonField:
-        # Update FieldInfo annotation if appropriate:
-        from .. import AliasChoices, AliasPath
-        from ..fields import FieldInfo
-
-        if has_instance_in_type(field_info.annotation, (ForwardRef, str)):
-            types_namespace = self._types_namespace
-            if self._typevars_map:
-                types_namespace = (types_namespace or {}).copy()
-                # Ensure that typevars get mapped to their concrete types:
-                types_namespace.update({k.__name__: v for k, v in self._typevars_map.items()})
-
-            evaluated = _typing_extra.eval_type_lenient(field_info.annotation, types_namespace)
-            if evaluated is not field_info.annotation and not has_instance_in_type(evaluated, PydanticRecursiveRef):
-                new_field_info = FieldInfo.from_annotation(evaluated)
-                field_info.annotation = new_field_info.annotation
-
-                # Handle any field info attributes that may have been obtained from now-resolved annotations
-                for k, v in new_field_info._attributes_set.items():
-                    # If an attribute is already set, it means it was set by assigning to a call to Field (or just a
-                    # default value), and that should take the highest priority. So don't overwrite existing attributes.
-                    # We skip over "attributes" that are present in the metadata_lookup dict because these won't
-                    # actually end up as attributes of the `FieldInfo` instance.
-                    if k not in field_info._attributes_set and k not in field_info.metadata_lookup:
-                        setattr(field_info, k, v)
-
-                # Finally, ensure the field info also reflects all the `_attributes_set` that are actually metadata.
-                field_info.metadata = [*new_field_info.metadata, *field_info.metadata]
-
-        source_type, annotations = field_info.annotation, field_info.metadata
-
-        def set_discriminator(schema: CoreSchema) -> CoreSchema:
-            schema = self._apply_discriminator_to_union(schema, field_info.discriminator)
-            return schema
-
-        with self.field_name_stack.push(name):
-            if field_info.discriminator is not None:
-                schema = self._apply_annotations(source_type, annotations, transform_inner_schema=set_discriminator)
-            else:
-                schema = self._apply_annotations(
-                    source_type,
-                    annotations,
-                )
-
-        # This V1 compatibility shim should eventually be removed
-        # push down any `each_item=True` validators
-        # note that this won't work for any Annotated types that get wrapped by a function validator
-        # but that's okay because that didn't exist in V1
-        this_field_validators = filter_field_decorator_info_by_field(decorators.validators.values(), name)
-        if _validators_require_validate_default(this_field_validators):
-            field_info.validate_default = True
-        each_item_validators = [v for v in this_field_validators if v.info.each_item is True]
-        this_field_validators = [v for v in this_field_validators if v not in each_item_validators]
-        schema = apply_each_item_validators(schema, each_item_validators, name)
-
-        schema = apply_validators(schema, filter_field_decorator_info_by_field(this_field_validators, name), name)
-        schema = apply_validators(
-            schema, filter_field_decorator_info_by_field(decorators.field_validators.values(), name), name
-        )
-
-        # the default validator needs to go outside of any other validators
-        # so that it is the topmost validator for the field validator
-        # which uses it to check if the field has a default value or not
-        if not field_info.is_required():
-            schema = wrap_default(field_info, schema)
-
-        schema = self._apply_field_serializers(
-            schema, filter_field_decorator_info_by_field(decorators.field_serializers.values(), name)
-        )
-        json_schema_updates = {
-            'title': field_info.title,
-            'description': field_info.description,
-            'examples': to_jsonable_python(field_info.examples),
-        }
-        json_schema_updates = {k: v for k, v in json_schema_updates.items() if v is not None}
-
-        json_schema_extra = field_info.json_schema_extra
-
-        metadata = build_metadata_dict(
-            js_annotation_functions=[get_json_schema_update_func(json_schema_updates, json_schema_extra)]
-        )
-
-        alias_generator = self._config_wrapper.alias_generator
-        if alias_generator is not None:
-            self._apply_alias_generator_to_field_info(alias_generator, field_info, name)
-
-        if isinstance(field_info.validation_alias, (AliasChoices, AliasPath)):
-            validation_alias = field_info.validation_alias.convert_to_aliases()
-        else:
-            validation_alias = field_info.validation_alias
-
-        return _common_field(
-            schema,
-            serialization_exclude=True if field_info.exclude else None,
-            validation_alias=validation_alias,
-            serialization_alias=field_info.serialization_alias,
-            frozen=field_info.frozen,
-            metadata=metadata,
-        )
-
-    def _union_schema(self, union_type: Any) -> core_schema.CoreSchema:
-        """Generate schema for a Union."""
-        args = self._get_args_resolving_forward_refs(union_type, required=True)
-        choices: list[CoreSchema] = []
-        nullable = False
-        for arg in args:
-            if arg is None or arg is _typing_extra.NoneType:
-                nullable = True
-            else:
-                choices.append(self.generate_schema(arg))
-
-        if len(choices) == 1:
-            s = choices[0]
-        else:
-            choices_with_tags: list[CoreSchema | tuple[CoreSchema, str]] = []
-            for choice in choices:
-                metadata = choice.get('metadata')
-                if isinstance(metadata, dict):
-                    tag = metadata.get(_core_utils.TAGGED_UNION_TAG_KEY)
-                    if tag is not None:
-                        choices_with_tags.append((choice, tag))
-                    else:
-                        choices_with_tags.append(choice)
-            s = core_schema.union_schema(choices_with_tags)
-
-        if nullable:
-            s = core_schema.nullable_schema(s)
-        return s
-
-    def _type_alias_type_schema(
-        self,
-        obj: Any,  # TypeAliasType
-    ) -> CoreSchema:
-        with self.defs.get_schema_or_ref(obj) as (ref, maybe_schema):
-            if maybe_schema is not None:
-                return maybe_schema
-
-            origin = get_origin(obj) or obj
-
-            annotation = origin.__value__
-            typevars_map = get_standard_typevars_map(obj)
-
-            with self._types_namespace_stack.push(origin):
-                annotation = _typing_extra.eval_type_lenient(annotation, self._types_namespace)
-                annotation = replace_types(annotation, typevars_map)
-                schema = self.generate_schema(annotation)
-                assert schema['type'] != 'definitions'
-                schema['ref'] = ref  # type: ignore
-            self.defs.definitions[ref] = schema
-            return core_schema.definition_reference_schema(ref)
-
-    def _literal_schema(self, literal_type: Any) -> CoreSchema:
-        """Generate schema for a Literal."""
-        expected = _typing_extra.all_literal_values(literal_type)
-        assert expected, f'literal "expected" cannot be empty, obj={literal_type}'
-        return core_schema.literal_schema(expected)
-
-    def _typed_dict_schema(self, typed_dict_cls: Any, origin: Any) -> core_schema.CoreSchema:
-        """Generate schema for a TypedDict.
-
-        It is not possible to track required/optional keys in TypedDict without __required_keys__
-        since TypedDict.__new__ erases the base classes (it replaces them with just `dict`)
-        and thus we can track usage of total=True/False
-        __required_keys__ was added in Python 3.9
-        (https://github.com/miss-islington/cpython/blob/1e9939657dd1f8eb9f596f77c1084d2d351172fc/Doc/library/typing.rst?plain=1#L1546-L1548)
-        however it is buggy
-        (https://github.com/python/typing_extensions/blob/ac52ac5f2cb0e00e7988bae1e2a1b8257ac88d6d/src/typing_extensions.py#L657-L666).
-
-        On 3.11 but < 3.12 TypedDict does not preserve inheritance information.
-
-        Hence to avoid creating validators that do not do what users expect we only
-        support typing.TypedDict on Python >= 3.12 or typing_extension.TypedDict on all versions
-        """
-        from ..fields import FieldInfo
-
-        with self.defs.get_schema_or_ref(typed_dict_cls) as (typed_dict_ref, maybe_schema):
-            if maybe_schema is not None:
-                return maybe_schema
-
-            typevars_map = get_standard_typevars_map(typed_dict_cls)
-            if origin is not None:
-                typed_dict_cls = origin
-
-            if not _SUPPORTS_TYPEDDICT and type(typed_dict_cls).__module__ == 'typing':
-                raise PydanticUserError(
-                    'Please use `typing_extensions.TypedDict` instead of `typing.TypedDict` on Python < 3.12.',
-                    code='typed-dict-version',
-                )
-
-            try:
-                config: ConfigDict | None = get_attribute_from_bases(typed_dict_cls, '__pydantic_config__')
-            except AttributeError:
-                config = None
-
-            with self._config_wrapper_stack.push(config), self._types_namespace_stack.push(typed_dict_cls):
-                core_config = self._config_wrapper.core_config(typed_dict_cls)
-
-                self = self._current_generate_schema
-
-                required_keys: frozenset[str] = typed_dict_cls.__required_keys__
-
-                fields: dict[str, core_schema.TypedDictField] = {}
-
-                decorators = DecoratorInfos.build(typed_dict_cls)
-
-                for field_name, annotation in get_type_hints_infer_globalns(
-                    typed_dict_cls, localns=self._types_namespace, include_extras=True
-                ).items():
-                    annotation = replace_types(annotation, typevars_map)
-                    required = field_name in required_keys
-
-                    if get_origin(annotation) == _typing_extra.Required:
-                        required = True
-                        annotation = self._get_args_resolving_forward_refs(
-                            annotation,
-                            required=True,
-                        )[0]
-                    elif get_origin(annotation) == _typing_extra.NotRequired:
-                        required = False
-                        annotation = self._get_args_resolving_forward_refs(
-                            annotation,
-                            required=True,
-                        )[0]
-
-                    field_info = FieldInfo.from_annotation(annotation)
-                    fields[field_name] = self._generate_td_field_schema(
-                        field_name, field_info, decorators, required=required
-                    )
-
-                metadata = build_metadata_dict(
-                    js_functions=[partial(modify_model_json_schema, cls=typed_dict_cls)], typed_dict_cls=typed_dict_cls
-                )
-
-                td_schema = core_schema.typed_dict_schema(
-                    fields,
-                    computed_fields=[
-                        self._computed_field_schema(d, decorators.field_serializers)
-                        for d in decorators.computed_fields.values()
-                    ],
-                    ref=typed_dict_ref,
-                    metadata=metadata,
-                    config=core_config,
-                )
-
-                schema = self._apply_model_serializers(td_schema, decorators.model_serializers.values())
-                schema = apply_model_validators(schema, decorators.model_validators.values(), 'all')
-                self.defs.definitions[typed_dict_ref] = self._post_process_generated_schema(schema)
-                return core_schema.definition_reference_schema(typed_dict_ref)
-
-    def _namedtuple_schema(self, namedtuple_cls: Any, origin: Any) -> core_schema.CoreSchema:
-        """Generate schema for a NamedTuple."""
-        with self.defs.get_schema_or_ref(namedtuple_cls) as (namedtuple_ref, maybe_schema):
-            if maybe_schema is not None:
-                return maybe_schema
-            typevars_map = get_standard_typevars_map(namedtuple_cls)
-            if origin is not None:
-                namedtuple_cls = origin
-
-            annotations: dict[str, Any] = get_type_hints_infer_globalns(
-                namedtuple_cls, include_extras=True, localns=self._types_namespace
-            )
-            if not annotations:
-                # annotations is empty, happens if namedtuple_cls defined via collections.namedtuple(...)
-                annotations = {k: Any for k in namedtuple_cls._fields}
-
-            if typevars_map:
-                annotations = {
-                    field_name: replace_types(annotation, typevars_map)
-                    for field_name, annotation in annotations.items()
-                }
-
-            arguments_schema = core_schema.arguments_schema(
-                [
-                    self._generate_parameter_schema(
-                        field_name, annotation, default=namedtuple_cls._field_defaults.get(field_name, Parameter.empty)
-                    )
-                    for field_name, annotation in annotations.items()
-                ],
-                metadata=build_metadata_dict(js_prefer_positional_arguments=True),
-            )
-            return core_schema.call_schema(arguments_schema, namedtuple_cls, ref=namedtuple_ref)
-
-    def _generate_parameter_schema(
-        self,
-        name: str,
-        annotation: type[Any],
-        default: Any = Parameter.empty,
-        mode: Literal['positional_only', 'positional_or_keyword', 'keyword_only'] | None = None,
-    ) -> core_schema.ArgumentsParameter:
-        """Prepare a ArgumentsParameter to represent a field in a namedtuple or function signature."""
-        from ..fields import FieldInfo
-
-        if default is Parameter.empty:
-            field = FieldInfo.from_annotation(annotation)
-        else:
-            field = FieldInfo.from_annotated_attribute(annotation, default)
-        assert field.annotation is not None, 'field.annotation should not be None when generating a schema'
-        source_type, annotations = field.annotation, field.metadata
-        with self.field_name_stack.push(name):
-            schema = self._apply_annotations(source_type, annotations)
-
-        if not field.is_required():
-            schema = wrap_default(field, schema)
-
-        parameter_schema = core_schema.arguments_parameter(name, schema)
-        if mode is not None:
-            parameter_schema['mode'] = mode
-        if field.alias is not None:
-            parameter_schema['alias'] = field.alias
-        else:
-            alias_generator = self._config_wrapper.alias_generator
-            if isinstance(alias_generator, AliasGenerator) and alias_generator.alias is not None:
-                parameter_schema['alias'] = alias_generator.alias(name)
-            elif isinstance(alias_generator, Callable):
-                parameter_schema['alias'] = alias_generator(name)
-        return parameter_schema
-
-    def _tuple_schema(self, tuple_type: Any) -> core_schema.CoreSchema:
-        """Generate schema for a Tuple, e.g. `tuple[int, str]` or `tuple[int, ...]`."""
-        # TODO: do we really need to resolve type vars here?
-        typevars_map = get_standard_typevars_map(tuple_type)
-        params = self._get_args_resolving_forward_refs(tuple_type)
-
-        if typevars_map and params:
-            params = tuple(replace_types(param, typevars_map) for param in params)
-
-        # NOTE: subtle difference: `tuple[()]` gives `params=()`, whereas `typing.Tuple[()]` gives `params=((),)`
-        # This is only true for <3.11, on Python 3.11+ `typing.Tuple[()]` gives `params=()`
-        if not params:
-            if tuple_type in TUPLE_TYPES:
-                return core_schema.tuple_schema([core_schema.any_schema()], variadic_item_index=0)
-            else:
-                # special case for `tuple[()]` which means `tuple[]` - an empty tuple
-                return core_schema.tuple_schema([])
-        elif params[-1] is Ellipsis:
-            if len(params) == 2:
-                return core_schema.tuple_schema([self.generate_schema(params[0])], variadic_item_index=0)
-            else:
-                # TODO: something like https://github.com/pydantic/pydantic/issues/5952
-                raise ValueError('Variable tuples can only have one type')
-        elif len(params) == 1 and params[0] == ():
-            # special case for `Tuple[()]` which means `Tuple[]` - an empty tuple
-            # NOTE: This conditional can be removed when we drop support for Python 3.10.
-            return core_schema.tuple_schema([])
-        else:
-            return core_schema.tuple_schema([self.generate_schema(param) for param in params])
-
-    def _type_schema(self) -> core_schema.CoreSchema:
-        return core_schema.custom_error_schema(
-            core_schema.is_instance_schema(type),
-            custom_error_type='is_type',
-            custom_error_message='Input should be a type',
-        )
-
-    def _union_is_subclass_schema(self, union_type: Any) -> core_schema.CoreSchema:
-        """Generate schema for `Type[Union[X, ...]]`."""
-        args = self._get_args_resolving_forward_refs(union_type, required=True)
-        return core_schema.union_schema([self.generate_schema(typing.Type[args]) for args in args])
-
-    def _subclass_schema(self, type_: Any) -> core_schema.CoreSchema:
-        """Generate schema for a Type, e.g. `Type[int]`."""
-        type_param = self._get_first_arg_or_any(type_)
-        if type_param == Any:
-            return self._type_schema()
-        elif isinstance(type_param, typing.TypeVar):
-            if type_param.__bound__:
-                if _typing_extra.origin_is_union(get_origin(type_param.__bound__)):
-                    return self._union_is_subclass_schema(type_param.__bound__)
-                return core_schema.is_subclass_schema(type_param.__bound__)
-            elif type_param.__constraints__:
-                return core_schema.union_schema(
-                    [self.generate_schema(typing.Type[c]) for c in type_param.__constraints__]
-                )
-            else:
-                return self._type_schema()
-        elif _typing_extra.origin_is_union(get_origin(type_param)):
-            return self._union_is_subclass_schema(type_param)
-        else:
-            return core_schema.is_subclass_schema(type_param)
-
-    def _sequence_schema(self, sequence_type: Any) -> core_schema.CoreSchema:
-        """Generate schema for a Sequence, e.g. `Sequence[int]`."""
-        item_type = self._get_first_arg_or_any(sequence_type)
-
-        list_schema = core_schema.list_schema(self.generate_schema(item_type))
-        python_schema = core_schema.is_instance_schema(typing.Sequence, cls_repr='Sequence')
-        if item_type != Any:
-            from ._validators import sequence_validator
-
-            python_schema = core_schema.chain_schema(
-                [python_schema, core_schema.no_info_wrap_validator_function(sequence_validator, list_schema)],
-            )
-        return core_schema.json_or_python_schema(json_schema=list_schema, python_schema=python_schema)
-
-    def _iterable_schema(self, type_: Any) -> core_schema.GeneratorSchema:
-        """Generate a schema for an `Iterable`."""
-        item_type = self._get_first_arg_or_any(type_)
-
-        return core_schema.generator_schema(self.generate_schema(item_type))
-
-    def _pattern_schema(self, pattern_type: Any) -> core_schema.CoreSchema:
-        from . import _validators
-
-        metadata = build_metadata_dict(js_functions=[lambda _1, _2: {'type': 'string', 'format': 'regex'}])
-        ser = core_schema.plain_serializer_function_ser_schema(
-            attrgetter('pattern'), when_used='json', return_schema=core_schema.str_schema()
-        )
-        if pattern_type == typing.Pattern or pattern_type == re.Pattern:
-            # bare type
-            return core_schema.no_info_plain_validator_function(
-                _validators.pattern_either_validator, serialization=ser, metadata=metadata
-            )
-
-        param = self._get_args_resolving_forward_refs(
-            pattern_type,
-            required=True,
-        )[0]
-        if param == str:
-            return core_schema.no_info_plain_validator_function(
-                _validators.pattern_str_validator, serialization=ser, metadata=metadata
-            )
-        elif param == bytes:
-            return core_schema.no_info_plain_validator_function(
-                _validators.pattern_bytes_validator, serialization=ser, metadata=metadata
-            )
-        else:
-            raise PydanticSchemaGenerationError(f'Unable to generate pydantic-core schema for {pattern_type!r}.')
-
-    def _hashable_schema(self) -> core_schema.CoreSchema:
-        return core_schema.custom_error_schema(
-            core_schema.is_instance_schema(collections.abc.Hashable),
-            custom_error_type='is_hashable',
-            custom_error_message='Input should be hashable',
-        )
-
-    def _dataclass_schema(
-        self, dataclass: type[StandardDataclass], origin: type[StandardDataclass] | None
-    ) -> core_schema.CoreSchema:
-        """Generate schema for a dataclass."""
-        with self.defs.get_schema_or_ref(dataclass) as (dataclass_ref, maybe_schema):
-            if maybe_schema is not None:
-                return maybe_schema
-
-            typevars_map = get_standard_typevars_map(dataclass)
-            if origin is not None:
-                dataclass = origin
-
-            config = getattr(dataclass, '__pydantic_config__', None)
-            with self._config_wrapper_stack.push(config), self._types_namespace_stack.push(dataclass):
-                core_config = self._config_wrapper.core_config(dataclass)
-
-                self = self._current_generate_schema
-
-                from ..dataclasses import is_pydantic_dataclass
-
-                if is_pydantic_dataclass(dataclass):
-                    fields = deepcopy(dataclass.__pydantic_fields__)
-                    if typevars_map:
-                        for field in fields.values():
-                            field.apply_typevars_map(typevars_map, self._types_namespace)
-                else:
-                    fields = collect_dataclass_fields(
-                        dataclass,
-                        self._types_namespace,
-                        typevars_map=typevars_map,
-                    )
-
-                # disallow combination of init=False on a dataclass field and extra='allow' on a dataclass
-                if config and config.get('extra') == 'allow':
-                    # disallow combination of init=False on a dataclass field and extra='allow' on a dataclass
-                    for field_name, field in fields.items():
-                        if field.init is False:
-                            raise PydanticUserError(
-                                f'Field {field_name} has `init=False` and dataclass has config setting `extra="allow"`. '
-                                f'This combination is not allowed.',
-                                code='dataclass-init-false-extra-allow',
-                            )
-
-                decorators = dataclass.__dict__.get('__pydantic_decorators__') or DecoratorInfos.build(dataclass)
-                # Move kw_only=False args to the start of the list, as this is how vanilla dataclasses work.
-                # Note that when kw_only is missing or None, it is treated as equivalent to kw_only=True
-                args = sorted(
-                    (self._generate_dc_field_schema(k, v, decorators) for k, v in fields.items()),
-                    key=lambda a: a.get('kw_only') is not False,
-                )
-                has_post_init = hasattr(dataclass, '__post_init__')
-                has_slots = hasattr(dataclass, '__slots__')
-
-                args_schema = core_schema.dataclass_args_schema(
-                    dataclass.__name__,
-                    args,
-                    computed_fields=[
-                        self._computed_field_schema(d, decorators.field_serializers)
-                        for d in decorators.computed_fields.values()
-                    ],
-                    collect_init_only=has_post_init,
-                )
-
-                inner_schema = apply_validators(args_schema, decorators.root_validators.values(), None)
-
-                model_validators = decorators.model_validators.values()
-                inner_schema = apply_model_validators(inner_schema, model_validators, 'inner')
-
-                dc_schema = core_schema.dataclass_schema(
-                    dataclass,
-                    inner_schema,
-                    post_init=has_post_init,
-                    ref=dataclass_ref,
-                    fields=[field.name for field in dataclasses.fields(dataclass)],
-                    slots=has_slots,
-                    config=core_config,
-                )
-                schema = self._apply_model_serializers(dc_schema, decorators.model_serializers.values())
-                schema = apply_model_validators(schema, model_validators, 'outer')
-                self.defs.definitions[dataclass_ref] = self._post_process_generated_schema(schema)
-                return core_schema.definition_reference_schema(dataclass_ref)
-
-    def _callable_schema(self, function: Callable[..., Any]) -> core_schema.CallSchema:
-        """Generate schema for a Callable.
-
-        TODO support functional validators once we support them in Config
-        """
-        sig = signature(function)
-
-        type_hints = _typing_extra.get_function_type_hints(function)
-
-        mode_lookup: dict[_ParameterKind, Literal['positional_only', 'positional_or_keyword', 'keyword_only']] = {
-            Parameter.POSITIONAL_ONLY: 'positional_only',
-            Parameter.POSITIONAL_OR_KEYWORD: 'positional_or_keyword',
-            Parameter.KEYWORD_ONLY: 'keyword_only',
-        }
-
-        arguments_list: list[core_schema.ArgumentsParameter] = []
-        var_args_schema: core_schema.CoreSchema | None = None
-        var_kwargs_schema: core_schema.CoreSchema | None = None
-
-        for name, p in sig.parameters.items():
-            if p.annotation is sig.empty:
-                annotation = Any
-            else:
-                annotation = type_hints[name]
-
-            parameter_mode = mode_lookup.get(p.kind)
-            if parameter_mode is not None:
-                arg_schema = self._generate_parameter_schema(name, annotation, p.default, parameter_mode)
-                arguments_list.append(arg_schema)
-            elif p.kind == Parameter.VAR_POSITIONAL:
-                var_args_schema = self.generate_schema(annotation)
-            else:
-                assert p.kind == Parameter.VAR_KEYWORD, p.kind
-                var_kwargs_schema = self.generate_schema(annotation)
-
-        return_schema: core_schema.CoreSchema | None = None
-        config_wrapper = self._config_wrapper
-        if config_wrapper.validate_return:
-            return_hint = type_hints.get('return')
-            if return_hint is not None:
-                return_schema = self.generate_schema(return_hint)
-
-        return core_schema.call_schema(
-            core_schema.arguments_schema(
-                arguments_list,
-                var_args_schema=var_args_schema,
-                var_kwargs_schema=var_kwargs_schema,
-                populate_by_name=config_wrapper.populate_by_name,
-            ),
-            function,
-            return_schema=return_schema,
-        )
-
-    def _unsubstituted_typevar_schema(self, typevar: typing.TypeVar) -> core_schema.CoreSchema:
-        assert isinstance(typevar, typing.TypeVar)
-
-        bound = typevar.__bound__
-        constraints = typevar.__constraints__
-        default = getattr(typevar, '__default__', None)
-
-        if (bound is not None) + (len(constraints) != 0) + (default is not None) > 1:
-            raise NotImplementedError(
-                'Pydantic does not support mixing more than one of TypeVar bounds, constraints and defaults'
-            )
-
-        if default is not None:
-            return self.generate_schema(default)
-        elif constraints:
-            return self._union_schema(typing.Union[constraints])  # type: ignore
-        elif bound:
-            schema = self.generate_schema(bound)
-            schema['serialization'] = core_schema.wrap_serializer_function_ser_schema(
-                lambda x, h: h(x), schema=core_schema.any_schema()
-            )
-            return schema
-        else:
-            return core_schema.any_schema()
-
-    def _computed_field_schema(
-        self,
-        d: Decorator[ComputedFieldInfo],
-        field_serializers: dict[str, Decorator[FieldSerializerDecoratorInfo]],
-    ) -> core_schema.ComputedField:
-        try:
-            return_type = _decorators.get_function_return_type(d.func, d.info.return_type, self._types_namespace)
-        except NameError as e:
-            raise PydanticUndefinedAnnotation.from_name_error(e) from e
-        if return_type is PydanticUndefined:
-            raise PydanticUserError(
-                'Computed field is missing return type annotation or specifying `return_type`'
-                ' to the `@computed_field` decorator (e.g. `@computed_field(return_type=int|str)`)',
-                code='model-field-missing-annotation',
-            )
-
-        return_type = replace_types(return_type, self._typevars_map)
-        # Create a new ComputedFieldInfo so that different type parametrizations of the same
-        # generic model's computed field can have different return types.
-        d.info = dataclasses.replace(d.info, return_type=return_type)
-        return_type_schema = self.generate_schema(return_type)
-        # Apply serializers to computed field if there exist
-        return_type_schema = self._apply_field_serializers(
-            return_type_schema,
-            filter_field_decorator_info_by_field(field_serializers.values(), d.cls_var_name),
-            computed_field=True,
-        )
-
-        alias_generator = self._config_wrapper.alias_generator
-        if alias_generator is not None:
-            self._apply_alias_generator_to_computed_field_info(
-                alias_generator=alias_generator, computed_field_info=d.info, computed_field_name=d.cls_var_name
-            )
-
-        def set_computed_field_metadata(schema: CoreSchemaOrField, handler: GetJsonSchemaHandler) -> JsonSchemaValue:
-            json_schema = handler(schema)
-
-            json_schema['readOnly'] = True
-
-            title = d.info.title
-            if title is not None:
-                json_schema['title'] = title
-
-            description = d.info.description
-            if description is not None:
-                json_schema['description'] = description
-
-            examples = d.info.examples
-            if examples is not None:
-                json_schema['examples'] = to_jsonable_python(examples)
-
-            json_schema_extra = d.info.json_schema_extra
-            if json_schema_extra is not None:
-                add_json_schema_extra(json_schema, json_schema_extra)
-
-            return json_schema
-
-        metadata = build_metadata_dict(js_annotation_functions=[set_computed_field_metadata])
-        return core_schema.computed_field(
-            d.cls_var_name, return_schema=return_type_schema, alias=d.info.alias, metadata=metadata
-        )
-
-    def _annotated_schema(self, annotated_type: Any) -> core_schema.CoreSchema:
-        """Generate schema for an Annotated type, e.g. `Annotated[int, Field(...)]` or `Annotated[int, Gt(0)]`."""
-        from ..fields import FieldInfo
-
-        source_type, *annotations = self._get_args_resolving_forward_refs(
-            annotated_type,
-            required=True,
-        )
-        schema = self._apply_annotations(source_type, annotations)
-        # put the default validator last so that TypeAdapter.get_default_value() works
-        # even if there are function validators involved
-        for annotation in annotations:
-            if isinstance(annotation, FieldInfo):
-                schema = wrap_default(annotation, schema)
-        return schema
-
-    def _get_prepare_pydantic_annotations_for_known_type(
-        self, obj: Any, annotations: tuple[Any, ...]
-    ) -> tuple[Any, list[Any]] | None:
-        from ._std_types_schema import PREPARE_METHODS
-
-        # Check for hashability
-        try:
-            hash(obj)
-        except TypeError:
-            # obj is definitely not a known type if this fails
-            return None
-
-        for gen in PREPARE_METHODS:
-            res = gen(obj, annotations, self._config_wrapper.config_dict)
-            if res is not None:
-                return res
-
-        return None
-
-    def _apply_annotations(
-        self,
-        source_type: Any,
-        annotations: list[Any],
-        transform_inner_schema: Callable[[CoreSchema], CoreSchema] = lambda x: x,
-    ) -> CoreSchema:
-        """Apply arguments from `Annotated` or from `FieldInfo` to a schema.
-
-        This gets called by `GenerateSchema._annotated_schema` but differs from it in that it does
-        not expect `source_type` to be an `Annotated` object, it expects it to be  the first argument of that
-        (in other words, `GenerateSchema._annotated_schema` just unpacks `Annotated`, this process it).
-        """
-        annotations = list(_known_annotated_metadata.expand_grouped_metadata(annotations))
-        res = self._get_prepare_pydantic_annotations_for_known_type(source_type, tuple(annotations))
-        if res is not None:
-            source_type, annotations = res
-
-        pydantic_js_annotation_functions: list[GetJsonSchemaFunction] = []
-
-        def inner_handler(obj: Any) -> CoreSchema:
-            from_property = self._generate_schema_from_property(obj, obj)
-            if from_property is None:
-                schema = self._generate_schema(obj)
-            else:
-                schema = from_property
-            metadata_js_function = _extract_get_pydantic_json_schema(obj, schema)
-            if metadata_js_function is not None:
-                metadata_schema = resolve_original_schema(schema, self.defs.definitions)
-                if metadata_schema is not None:
-                    self._add_js_function(metadata_schema, metadata_js_function)
-            return transform_inner_schema(schema)
-
-        get_inner_schema = CallbackGetCoreSchemaHandler(inner_handler, self)
-
-        for annotation in annotations:
-            if annotation is None:
-                continue
-            get_inner_schema = self._get_wrapped_inner_schema(
-                get_inner_schema, annotation, pydantic_js_annotation_functions
-            )
-
-        schema = get_inner_schema(source_type)
-        if pydantic_js_annotation_functions:
-            metadata = CoreMetadataHandler(schema).metadata
-            metadata.setdefault('pydantic_js_annotation_functions', []).extend(pydantic_js_annotation_functions)
-        return _add_custom_serialization_from_json_encoders(self._config_wrapper.json_encoders, source_type, schema)
-
-    def _apply_single_annotation(self, schema: core_schema.CoreSchema, metadata: Any) -> core_schema.CoreSchema:
-        from ..fields import FieldInfo
-
-        if isinstance(metadata, FieldInfo):
-            for field_metadata in metadata.metadata:
-                schema = self._apply_single_annotation(schema, field_metadata)
-
-            if metadata.discriminator is not None:
-                schema = self._apply_discriminator_to_union(schema, metadata.discriminator)
-            return schema
-
-        if schema['type'] == 'nullable':
-            # for nullable schemas, metadata is automatically applied to the inner schema
-            inner = schema.get('schema', core_schema.any_schema())
-            inner = self._apply_single_annotation(inner, metadata)
-            if inner:
-                schema['schema'] = inner
-            return schema
-
-        original_schema = schema
-        ref = schema.get('ref', None)
-        if ref is not None:
-            schema = schema.copy()
-            new_ref = ref + f'_{repr(metadata)}'
-            if new_ref in self.defs.definitions:
-                return self.defs.definitions[new_ref]
-            schema['ref'] = new_ref  # type: ignore
-        elif schema['type'] == 'definition-ref':
-            ref = schema['schema_ref']
-            if ref in self.defs.definitions:
-                schema = self.defs.definitions[ref].copy()
-                new_ref = ref + f'_{repr(metadata)}'
-                if new_ref in self.defs.definitions:
-                    return self.defs.definitions[new_ref]
-                schema['ref'] = new_ref  # type: ignore
-
-        maybe_updated_schema = _known_annotated_metadata.apply_known_metadata(metadata, schema.copy())
-
-        if maybe_updated_schema is not None:
-            return maybe_updated_schema
-        return original_schema
-
-    def _apply_single_annotation_json_schema(
-        self, schema: core_schema.CoreSchema, metadata: Any
-    ) -> core_schema.CoreSchema:
-        from ..fields import FieldInfo
-
-        if isinstance(metadata, FieldInfo):
-            for field_metadata in metadata.metadata:
-                schema = self._apply_single_annotation_json_schema(schema, field_metadata)
-            json_schema_update: JsonSchemaValue = {}
-            if metadata.title:
-                json_schema_update['title'] = metadata.title
-            if metadata.description:
-                json_schema_update['description'] = metadata.description
-            if metadata.examples:
-                json_schema_update['examples'] = to_jsonable_python(metadata.examples)
-
-            json_schema_extra = metadata.json_schema_extra
-            if json_schema_update or json_schema_extra:
-                CoreMetadataHandler(schema).metadata.setdefault('pydantic_js_annotation_functions', []).append(
-                    get_json_schema_update_func(json_schema_update, json_schema_extra)
-                )
-        return schema
-
-    def _get_wrapped_inner_schema(
-        self,
-        get_inner_schema: GetCoreSchemaHandler,
-        annotation: Any,
-        pydantic_js_annotation_functions: list[GetJsonSchemaFunction],
-    ) -> CallbackGetCoreSchemaHandler:
-        metadata_get_schema: GetCoreSchemaFunction = getattr(annotation, '__get_pydantic_core_schema__', None) or (
-            lambda source, handler: handler(source)
-        )
-
-        def new_handler(source: Any) -> core_schema.CoreSchema:
-            schema = metadata_get_schema(source, get_inner_schema)
-            schema = self._apply_single_annotation(schema, annotation)
-            schema = self._apply_single_annotation_json_schema(schema, annotation)
-
-            metadata_js_function = _extract_get_pydantic_json_schema(annotation, schema)
-            if metadata_js_function is not None:
-                pydantic_js_annotation_functions.append(metadata_js_function)
-            return schema
-
-        return CallbackGetCoreSchemaHandler(new_handler, self)
-
-    def _apply_field_serializers(
-        self,
-        schema: core_schema.CoreSchema,
-        serializers: list[Decorator[FieldSerializerDecoratorInfo]],
-        computed_field: bool = False,
-    ) -> core_schema.CoreSchema:
-        """Apply field serializers to a schema."""
-        if serializers:
-            schema = copy(schema)
-            if schema['type'] == 'definitions':
-                inner_schema = schema['schema']
-                schema['schema'] = self._apply_field_serializers(inner_schema, serializers)
-                return schema
-            else:
-                ref = typing.cast('str|None', schema.get('ref', None))
-                if ref is not None:
-                    schema = core_schema.definition_reference_schema(ref)
-
-            # use the last serializer to make it easy to override a serializer set on a parent model
-            serializer = serializers[-1]
-            is_field_serializer, info_arg = inspect_field_serializer(
-                serializer.func, serializer.info.mode, computed_field=computed_field
-            )
-
-            try:
-                return_type = _decorators.get_function_return_type(
-                    serializer.func, serializer.info.return_type, self._types_namespace
-                )
-            except NameError as e:
-                raise PydanticUndefinedAnnotation.from_name_error(e) from e
-
-            if return_type is PydanticUndefined:
-                return_schema = None
-            else:
-                return_schema = self.generate_schema(return_type)
-
-            if serializer.info.mode == 'wrap':
-                schema['serialization'] = core_schema.wrap_serializer_function_ser_schema(
-                    serializer.func,
-                    is_field_serializer=is_field_serializer,
-                    info_arg=info_arg,
-                    return_schema=return_schema,
-                    when_used=serializer.info.when_used,
-                )
-            else:
-                assert serializer.info.mode == 'plain'
-                schema['serialization'] = core_schema.plain_serializer_function_ser_schema(
-                    serializer.func,
-                    is_field_serializer=is_field_serializer,
-                    info_arg=info_arg,
-                    return_schema=return_schema,
-                    when_used=serializer.info.when_used,
-                )
-        return schema
-
-    def _apply_model_serializers(
-        self, schema: core_schema.CoreSchema, serializers: Iterable[Decorator[ModelSerializerDecoratorInfo]]
-    ) -> core_schema.CoreSchema:
-        """Apply model serializers to a schema."""
-        ref: str | None = schema.pop('ref', None)  # type: ignore
-        if serializers:
-            serializer = list(serializers)[-1]
-            info_arg = inspect_model_serializer(serializer.func, serializer.info.mode)
-
-            try:
-                return_type = _decorators.get_function_return_type(
-                    serializer.func, serializer.info.return_type, self._types_namespace
-                )
-            except NameError as e:
-                raise PydanticUndefinedAnnotation.from_name_error(e) from e
-            if return_type is PydanticUndefined:
-                return_schema = None
-            else:
-                return_schema = self.generate_schema(return_type)
-
-            if serializer.info.mode == 'wrap':
-                ser_schema: core_schema.SerSchema = core_schema.wrap_serializer_function_ser_schema(
-                    serializer.func,
-                    info_arg=info_arg,
-                    return_schema=return_schema,
-                    when_used=serializer.info.when_used,
-                )
-            else:
-                # plain
-                ser_schema = core_schema.plain_serializer_function_ser_schema(
-                    serializer.func,
-                    info_arg=info_arg,
-                    return_schema=return_schema,
-                    when_used=serializer.info.when_used,
-                )
-            schema['serialization'] = ser_schema
-        if ref:
-            schema['ref'] = ref  # type: ignore
-        return schema
-
-
-_VALIDATOR_F_MATCH: Mapping[
-    tuple[FieldValidatorModes, Literal['no-info', 'with-info']],
-    Callable[[Callable[..., Any], core_schema.CoreSchema, str | None], core_schema.CoreSchema],
-] = {
-    ('before', 'no-info'): lambda f, schema, _: core_schema.no_info_before_validator_function(f, schema),
-    ('after', 'no-info'): lambda f, schema, _: core_schema.no_info_after_validator_function(f, schema),
-    ('plain', 'no-info'): lambda f, _1, _2: core_schema.no_info_plain_validator_function(f),
-    ('wrap', 'no-info'): lambda f, schema, _: core_schema.no_info_wrap_validator_function(f, schema),
-    ('before', 'with-info'): lambda f, schema, field_name: core_schema.with_info_before_validator_function(
-        f, schema, field_name=field_name
-    ),
-    ('after', 'with-info'): lambda f, schema, field_name: core_schema.with_info_after_validator_function(
-        f, schema, field_name=field_name
-    ),
-    ('plain', 'with-info'): lambda f, _, field_name: core_schema.with_info_plain_validator_function(
-        f, field_name=field_name
-    ),
-    ('wrap', 'with-info'): lambda f, schema, field_name: core_schema.with_info_wrap_validator_function(
-        f, schema, field_name=field_name
-    ),
-}
-
-
-def apply_validators(
-    schema: core_schema.CoreSchema,
-    validators: Iterable[Decorator[RootValidatorDecoratorInfo]]
-    | Iterable[Decorator[ValidatorDecoratorInfo]]
-    | Iterable[Decorator[FieldValidatorDecoratorInfo]],
-    field_name: str | None,
-) -> core_schema.CoreSchema:
-    """Apply validators to a schema.
-
-    Args:
-        schema: The schema to apply validators on.
-        validators: An iterable of validators.
-        field_name: The name of the field if validators are being applied to a model field.
-
-    Returns:
-        The updated schema.
-    """
-    for validator in validators:
-        info_arg = inspect_validator(validator.func, validator.info.mode)
-        val_type = 'with-info' if info_arg else 'no-info'
-
-        schema = _VALIDATOR_F_MATCH[(validator.info.mode, val_type)](validator.func, schema, field_name)
-    return schema
-
-
-def _validators_require_validate_default(validators: Iterable[Decorator[ValidatorDecoratorInfo]]) -> bool:
-    """In v1, if any of the validators for a field had `always=True`, the default value would be validated.
-
-    This serves as an auxiliary function for re-implementing that logic, by looping over a provided
-    collection of (v1-style) ValidatorDecoratorInfo's and checking if any of them have `always=True`.
-
-    We should be able to drop this function and the associated logic calling it once we drop support
-    for v1-style validator decorators. (Or we can extend it and keep it if we add something equivalent
-    to the v1-validator `always` kwarg to `field_validator`.)
-    """
-    for validator in validators:
-        if validator.info.always:
-            return True
-    return False
-
-
-def apply_model_validators(
-    schema: core_schema.CoreSchema,
-    validators: Iterable[Decorator[ModelValidatorDecoratorInfo]],
-    mode: Literal['inner', 'outer', 'all'],
-) -> core_schema.CoreSchema:
-    """Apply model validators to a schema.
-
-    If mode == 'inner', only "before" validators are applied
-    If mode == 'outer', validators other than "before" are applied
-    If mode == 'all', all validators are applied
-
-    Args:
-        schema: The schema to apply validators on.
-        validators: An iterable of validators.
-        mode: The validator mode.
-
-    Returns:
-        The updated schema.
-    """
-    ref: str | None = schema.pop('ref', None)  # type: ignore
-    for validator in validators:
-        if mode == 'inner' and validator.info.mode != 'before':
-            continue
-        if mode == 'outer' and validator.info.mode == 'before':
-            continue
-        info_arg = inspect_validator(validator.func, validator.info.mode)
-        if validator.info.mode == 'wrap':
-            if info_arg:
-                schema = core_schema.with_info_wrap_validator_function(function=validator.func, schema=schema)
-            else:
-                schema = core_schema.no_info_wrap_validator_function(function=validator.func, schema=schema)
-        elif validator.info.mode == 'before':
-            if info_arg:
-                schema = core_schema.with_info_before_validator_function(function=validator.func, schema=schema)
-            else:
-                schema = core_schema.no_info_before_validator_function(function=validator.func, schema=schema)
-        else:
-            assert validator.info.mode == 'after'
-            if info_arg:
-                schema = core_schema.with_info_after_validator_function(function=validator.func, schema=schema)
-            else:
-                schema = core_schema.no_info_after_validator_function(function=validator.func, schema=schema)
-    if ref:
-        schema['ref'] = ref  # type: ignore
-    return schema
-
-
-def wrap_default(field_info: FieldInfo, schema: core_schema.CoreSchema) -> core_schema.CoreSchema:
-    """Wrap schema with default schema if default value or `default_factory` are available.
-
-    Args:
-        field_info: The field info object.
-        schema: The schema to apply default on.
-
-    Returns:
-        Updated schema by default value or `default_factory`.
-    """
-    if field_info.default_factory:
-        return core_schema.with_default_schema(
-            schema, default_factory=field_info.default_factory, validate_default=field_info.validate_default
-        )
-    elif field_info.default is not PydanticUndefined:
-        return core_schema.with_default_schema(
-            schema, default=field_info.default, validate_default=field_info.validate_default
-        )
-    else:
-        return schema
-
-
-def _extract_get_pydantic_json_schema(tp: Any, schema: CoreSchema) -> GetJsonSchemaFunction | None:
-    """Extract `__get_pydantic_json_schema__` from a type, handling the deprecated `__modify_schema__`."""
-    js_modify_function = getattr(tp, '__get_pydantic_json_schema__', None)
-
-    if hasattr(tp, '__modify_schema__'):
-        from pydantic import BaseModel  # circular reference
-
-        has_custom_v2_modify_js_func = (
-            js_modify_function is not None
-            and BaseModel.__get_pydantic_json_schema__.__func__  # type: ignore
-            not in (js_modify_function, getattr(js_modify_function, '__func__', None))
-        )
-
-        if not has_custom_v2_modify_js_func:
-            raise PydanticUserError(
-                'The `__modify_schema__` method is not supported in Pydantic v2. '
-                'Use `__get_pydantic_json_schema__` instead.',
-                code='custom-json-schema',
-            )
-
-    # handle GenericAlias' but ignore Annotated which "lies" about its origin (in this case it would be `int`)
-    if hasattr(tp, '__origin__') and not isinstance(tp, type(Annotated[int, 'placeholder'])):
-        return _extract_get_pydantic_json_schema(tp.__origin__, schema)
-
-    if js_modify_function is None:
-        return None
-
-    return js_modify_function
-
-
-def get_json_schema_update_func(
-    json_schema_update: JsonSchemaValue, json_schema_extra: JsonDict | typing.Callable[[JsonDict], None] | None
-) -> GetJsonSchemaFunction:
-    def json_schema_update_func(
-        core_schema_or_field: CoreSchemaOrField, handler: GetJsonSchemaHandler
-    ) -> JsonSchemaValue:
-        json_schema = {**handler(core_schema_or_field), **json_schema_update}
-        add_json_schema_extra(json_schema, json_schema_extra)
-        return json_schema
-
-    return json_schema_update_func
-
-
-def add_json_schema_extra(
-    json_schema: JsonSchemaValue, json_schema_extra: JsonDict | typing.Callable[[JsonDict], None] | None
-):
-    if isinstance(json_schema_extra, dict):
-        json_schema.update(to_jsonable_python(json_schema_extra))
-    elif callable(json_schema_extra):
-        json_schema_extra(json_schema)
-
-
-class _CommonField(TypedDict):
-    schema: core_schema.CoreSchema
-    validation_alias: str | list[str | int] | list[list[str | int]] | None
-    serialization_alias: str | None
-    serialization_exclude: bool | None
-    frozen: bool | None
-    metadata: dict[str, Any]
-
-
-def _common_field(
-    schema: core_schema.CoreSchema,
-    *,
-    validation_alias: str | list[str | int] | list[list[str | int]] | None = None,
-    serialization_alias: str | None = None,
-    serialization_exclude: bool | None = None,
-    frozen: bool | None = None,
-    metadata: Any = None,
-) -> _CommonField:
-    return {
-        'schema': schema,
-        'validation_alias': validation_alias,
-        'serialization_alias': serialization_alias,
-        'serialization_exclude': serialization_exclude,
-        'frozen': frozen,
-        'metadata': metadata,
-    }
-
-
-class _Definitions:
-    """Keeps track of references and definitions."""
-
-    def __init__(self) -> None:
-        self.seen: set[str] = set()
-        self.definitions: dict[str, core_schema.CoreSchema] = {}
-
-    @contextmanager
-    def get_schema_or_ref(self, tp: Any) -> Iterator[tuple[str, None] | tuple[str, CoreSchema]]:
-        """Get a definition for `tp` if one exists.
-
-        If a definition exists, a tuple of `(ref_string, CoreSchema)` is returned.
-        If no definition exists yet, a tuple of `(ref_string, None)` is returned.
-
-        Note that the returned `CoreSchema` will always be a `DefinitionReferenceSchema`,
-        not the actual definition itself.
-
-        This should be called for any type that can be identified by reference.
-        This includes any recursive types.
-
-        At present the following types can be named/recursive:
-
-        - BaseModel
-        - Dataclasses
-        - TypedDict
-        - TypeAliasType
-        """
-        ref = get_type_ref(tp)
-        # return the reference if we're either (1) in a cycle or (2) it was already defined
-        if ref in self.seen or ref in self.definitions:
-            yield (ref, core_schema.definition_reference_schema(ref))
-        else:
-            self.seen.add(ref)
-            try:
-                yield (ref, None)
-            finally:
-                self.seen.discard(ref)
-
-
-def resolve_original_schema(schema: CoreSchema, definitions: dict[str, CoreSchema]) -> CoreSchema | None:
-    if schema['type'] == 'definition-ref':
-        return definitions.get(schema['schema_ref'], None)
-    elif schema['type'] == 'definitions':
-        return schema['schema']
-    else:
-        return schema
-
-
-class _FieldNameStack:
-    __slots__ = ('_stack',)
-
-    def __init__(self) -> None:
-        self._stack: list[str] = []
-
-    @contextmanager
-    def push(self, field_name: str) -> Iterator[None]:
-        self._stack.append(field_name)
-        yield
-        self._stack.pop()
-
-    def get(self) -> str | None:
-        if self._stack:
-            return self._stack[-1]
-        else:
-            return None
diff --git a/lib/pydantic/_internal/_generics.py b/lib/pydantic/_internal/_generics.py
deleted file mode 100644
index 5a66eaa9..00000000
--- a/lib/pydantic/_internal/_generics.py
+++ /dev/null
@@ -1,517 +0,0 @@
-from __future__ import annotations
-
-import sys
-import types
-import typing
-from collections import ChainMap
-from contextlib import contextmanager
-from contextvars import ContextVar
-from types import prepare_class
-from typing import TYPE_CHECKING, Any, Iterator, List, Mapping, MutableMapping, Tuple, TypeVar
-from weakref import WeakValueDictionary
-
-import typing_extensions
-
-from ._core_utils import get_type_ref
-from ._forward_ref import PydanticRecursiveRef
-from ._typing_extra import TypeVarType, typing_base
-from ._utils import all_identical, is_model_class
-
-if sys.version_info >= (3, 10):
-    from typing import _UnionGenericAlias  # type: ignore[attr-defined]
-
-if TYPE_CHECKING:
-    from ..main import BaseModel
-
-GenericTypesCacheKey = Tuple[Any, Any, Tuple[Any, ...]]
-
-# Note: We want to remove LimitedDict, but to do this, we'd need to improve the handling of generics caching.
-#   Right now, to handle recursive generics, we some types must remain cached for brief periods without references.
-#   By chaining the WeakValuesDict with a LimitedDict, we have a way to retain caching for all types with references,
-#   while also retaining a limited number of types even without references. This is generally enough to build
-#   specific recursive generic models without losing required items out of the cache.
-
-KT = TypeVar('KT')
-VT = TypeVar('VT')
-_LIMITED_DICT_SIZE = 100
-if TYPE_CHECKING:
-
-    class LimitedDict(dict, MutableMapping[KT, VT]):
-        def __init__(self, size_limit: int = _LIMITED_DICT_SIZE):
-            ...
-
-else:
-
-    class LimitedDict(dict):
-        """Limit the size/length of a dict used for caching to avoid unlimited increase in memory usage.
-
-        Since the dict is ordered, and we always remove elements from the beginning, this is effectively a FIFO cache.
-        """
-
-        def __init__(self, size_limit: int = _LIMITED_DICT_SIZE):
-            self.size_limit = size_limit
-            super().__init__()
-
-        def __setitem__(self, __key: Any, __value: Any) -> None:
-            super().__setitem__(__key, __value)
-            if len(self) > self.size_limit:
-                excess = len(self) - self.size_limit + self.size_limit // 10
-                to_remove = list(self.keys())[:excess]
-                for key in to_remove:
-                    del self[key]
-
-
-# weak dictionaries allow the dynamically created parametrized versions of generic models to get collected
-# once they are no longer referenced by the caller.
-if sys.version_info >= (3, 9):  # Typing for weak dictionaries available at 3.9
-    GenericTypesCache = WeakValueDictionary[GenericTypesCacheKey, 'type[BaseModel]']
-else:
-    GenericTypesCache = WeakValueDictionary
-
-if TYPE_CHECKING:
-
-    class DeepChainMap(ChainMap[KT, VT]):  # type: ignore
-        ...
-
-else:
-
-    class DeepChainMap(ChainMap):
-        """Variant of ChainMap that allows direct updates to inner scopes.
-
-        Taken from https://docs.python.org/3/library/collections.html#collections.ChainMap,
-        with some light modifications for this use case.
-        """
-
-        def clear(self) -> None:
-            for mapping in self.maps:
-                mapping.clear()
-
-        def __setitem__(self, key: KT, value: VT) -> None:
-            for mapping in self.maps:
-                mapping[key] = value
-
-        def __delitem__(self, key: KT) -> None:
-            hit = False
-            for mapping in self.maps:
-                if key in mapping:
-                    del mapping[key]
-                    hit = True
-            if not hit:
-                raise KeyError(key)
-
-
-# Despite the fact that LimitedDict _seems_ no longer necessary, I'm very nervous to actually remove it
-# and discover later on that we need to re-add all this infrastructure...
-# _GENERIC_TYPES_CACHE = DeepChainMap(GenericTypesCache(), LimitedDict())
-
-_GENERIC_TYPES_CACHE = GenericTypesCache()
-
-
-class PydanticGenericMetadata(typing_extensions.TypedDict):
-    origin: type[BaseModel] | None  # analogous to typing._GenericAlias.__origin__
-    args: tuple[Any, ...]  # analogous to typing._GenericAlias.__args__
-    parameters: tuple[type[Any], ...]  # analogous to typing.Generic.__parameters__
-
-
-def create_generic_submodel(
-    model_name: str, origin: type[BaseModel], args: tuple[Any, ...], params: tuple[Any, ...]
-) -> type[BaseModel]:
-    """Dynamically create a submodel of a provided (generic) BaseModel.
-
-    This is used when producing concrete parametrizations of generic models. This function
-    only *creates* the new subclass; the schema/validators/serialization must be updated to
-    reflect a concrete parametrization elsewhere.
-
-    Args:
-        model_name: The name of the newly created model.
-        origin: The base class for the new model to inherit from.
-        args: A tuple of generic metadata arguments.
-        params: A tuple of generic metadata parameters.
-
-    Returns:
-        The created submodel.
-    """
-    namespace: dict[str, Any] = {'__module__': origin.__module__}
-    bases = (origin,)
-    meta, ns, kwds = prepare_class(model_name, bases)
-    namespace.update(ns)
-    created_model = meta(
-        model_name,
-        bases,
-        namespace,
-        __pydantic_generic_metadata__={
-            'origin': origin,
-            'args': args,
-            'parameters': params,
-        },
-        __pydantic_reset_parent_namespace__=False,
-        **kwds,
-    )
-
-    model_module, called_globally = _get_caller_frame_info(depth=3)
-    if called_globally:  # create global reference and therefore allow pickling
-        object_by_reference = None
-        reference_name = model_name
-        reference_module_globals = sys.modules[created_model.__module__].__dict__
-        while object_by_reference is not created_model:
-            object_by_reference = reference_module_globals.setdefault(reference_name, created_model)
-            reference_name += '_'
-
-    return created_model
-
-
-def _get_caller_frame_info(depth: int = 2) -> tuple[str | None, bool]:
-    """Used inside a function to check whether it was called globally.
-
-    Args:
-        depth: The depth to get the frame.
-
-    Returns:
-        A tuple contains `module_name` and `called_globally`.
-
-    Raises:
-        RuntimeError: If the function is not called inside a function.
-    """
-    try:
-        previous_caller_frame = sys._getframe(depth)
-    except ValueError as e:
-        raise RuntimeError('This function must be used inside another function') from e
-    except AttributeError:  # sys module does not have _getframe function, so there's nothing we can do about it
-        return None, False
-    frame_globals = previous_caller_frame.f_globals
-    return frame_globals.get('__name__'), previous_caller_frame.f_locals is frame_globals
-
-
-DictValues: type[Any] = {}.values().__class__
-
-
-def iter_contained_typevars(v: Any) -> Iterator[TypeVarType]:
-    """Recursively iterate through all subtypes and type args of `v` and yield any typevars that are found.
-
-    This is inspired as an alternative to directly accessing the `__parameters__` attribute of a GenericAlias,
-    since __parameters__ of (nested) generic BaseModel subclasses won't show up in that list.
-    """
-    if isinstance(v, TypeVar):
-        yield v
-    elif is_model_class(v):
-        yield from v.__pydantic_generic_metadata__['parameters']
-    elif isinstance(v, (DictValues, list)):
-        for var in v:
-            yield from iter_contained_typevars(var)
-    else:
-        args = get_args(v)
-        for arg in args:
-            yield from iter_contained_typevars(arg)
-
-
-def get_args(v: Any) -> Any:
-    pydantic_generic_metadata: PydanticGenericMetadata | None = getattr(v, '__pydantic_generic_metadata__', None)
-    if pydantic_generic_metadata:
-        return pydantic_generic_metadata.get('args')
-    return typing_extensions.get_args(v)
-
-
-def get_origin(v: Any) -> Any:
-    pydantic_generic_metadata: PydanticGenericMetadata | None = getattr(v, '__pydantic_generic_metadata__', None)
-    if pydantic_generic_metadata:
-        return pydantic_generic_metadata.get('origin')
-    return typing_extensions.get_origin(v)
-
-
-def get_standard_typevars_map(cls: type[Any]) -> dict[TypeVarType, Any] | None:
-    """Package a generic type's typevars and parametrization (if present) into a dictionary compatible with the
-    `replace_types` function. Specifically, this works with standard typing generics and typing._GenericAlias.
-    """
-    origin = get_origin(cls)
-    if origin is None:
-        return None
-    if not hasattr(origin, '__parameters__'):
-        return None
-
-    # In this case, we know that cls is a _GenericAlias, and origin is the generic type
-    # So it is safe to access cls.__args__ and origin.__parameters__
-    args: tuple[Any, ...] = cls.__args__  # type: ignore
-    parameters: tuple[TypeVarType, ...] = origin.__parameters__
-    return dict(zip(parameters, args))
-
-
-def get_model_typevars_map(cls: type[BaseModel]) -> dict[TypeVarType, Any] | None:
-    """Package a generic BaseModel's typevars and concrete parametrization (if present) into a dictionary compatible
-    with the `replace_types` function.
-
-    Since BaseModel.__class_getitem__ does not produce a typing._GenericAlias, and the BaseModel generic info is
-    stored in the __pydantic_generic_metadata__ attribute, we need special handling here.
-    """
-    # TODO: This could be unified with `get_standard_typevars_map` if we stored the generic metadata
-    #   in the __origin__, __args__, and __parameters__ attributes of the model.
-    generic_metadata = cls.__pydantic_generic_metadata__
-    origin = generic_metadata['origin']
-    args = generic_metadata['args']
-    return dict(zip(iter_contained_typevars(origin), args))
-
-
-def replace_types(type_: Any, type_map: Mapping[Any, Any] | None) -> Any:
-    """Return type with all occurrences of `type_map` keys recursively replaced with their values.
-
-    Args:
-        type_: The class or generic alias.
-        type_map: Mapping from `TypeVar` instance to concrete types.
-
-    Returns:
-        A new type representing the basic structure of `type_` with all
-        `typevar_map` keys recursively replaced.
-
-    Example:
-        ```py
-        from typing import List, Tuple, Union
-
-        from pydantic._internal._generics import replace_types
-
-        replace_types(Tuple[str, Union[List[str], float]], {str: int})
-        #> Tuple[int, Union[List[int], float]]
-        ```
-    """
-    if not type_map:
-        return type_
-
-    type_args = get_args(type_)
-    origin_type = get_origin(type_)
-
-    if origin_type is typing_extensions.Annotated:
-        annotated_type, *annotations = type_args
-        annotated = replace_types(annotated_type, type_map)
-        for annotation in annotations:
-            annotated = typing_extensions.Annotated[annotated, annotation]
-        return annotated
-
-    # Having type args is a good indicator that this is a typing module
-    # class instantiation or a generic alias of some sort.
-    if type_args:
-        resolved_type_args = tuple(replace_types(arg, type_map) for arg in type_args)
-        if all_identical(type_args, resolved_type_args):
-            # If all arguments are the same, there is no need to modify the
-            # type or create a new object at all
-            return type_
-        if (
-            origin_type is not None
-            and isinstance(type_, typing_base)
-            and not isinstance(origin_type, typing_base)
-            and getattr(type_, '_name', None) is not None
-        ):
-            # In python < 3.9 generic aliases don't exist so any of these like `list`,
-            # `type` or `collections.abc.Callable` need to be translated.
-            # See: https://www.python.org/dev/peps/pep-0585
-            origin_type = getattr(typing, type_._name)
-        assert origin_type is not None
-        # PEP-604 syntax (Ex.: list | str) is represented with a types.UnionType object that does not have __getitem__.
-        # We also cannot use isinstance() since we have to compare types.
-        if sys.version_info >= (3, 10) and origin_type is types.UnionType:
-            return _UnionGenericAlias(origin_type, resolved_type_args)
-        # NotRequired[T] and Required[T] don't support tuple type resolved_type_args, hence the condition below
-        return origin_type[resolved_type_args[0] if len(resolved_type_args) == 1 else resolved_type_args]
-
-    # We handle pydantic generic models separately as they don't have the same
-    # semantics as "typing" classes or generic aliases
-
-    if not origin_type and is_model_class(type_):
-        parameters = type_.__pydantic_generic_metadata__['parameters']
-        if not parameters:
-            return type_
-        resolved_type_args = tuple(replace_types(t, type_map) for t in parameters)
-        if all_identical(parameters, resolved_type_args):
-            return type_
-        return type_[resolved_type_args]
-
-    # Handle special case for typehints that can have lists as arguments.
-    # `typing.Callable[[int, str], int]` is an example for this.
-    if isinstance(type_, (List, list)):
-        resolved_list = list(replace_types(element, type_map) for element in type_)
-        if all_identical(type_, resolved_list):
-            return type_
-        return resolved_list
-
-    # If all else fails, we try to resolve the type directly and otherwise just
-    # return the input with no modifications.
-    return type_map.get(type_, type_)
-
-
-def has_instance_in_type(type_: Any, isinstance_target: Any) -> bool:
-    """Checks if the type, or any of its arbitrary nested args, satisfy
-    `isinstance(<type>, isinstance_target)`.
-    """
-    if isinstance(type_, isinstance_target):
-        return True
-
-    type_args = get_args(type_)
-    origin_type = get_origin(type_)
-
-    if origin_type is typing_extensions.Annotated:
-        annotated_type, *annotations = type_args
-        return has_instance_in_type(annotated_type, isinstance_target)
-
-    # Having type args is a good indicator that this is a typing module
-    # class instantiation or a generic alias of some sort.
-    if any(has_instance_in_type(a, isinstance_target) for a in type_args):
-        return True
-
-    # Handle special case for typehints that can have lists as arguments.
-    # `typing.Callable[[int, str], int]` is an example for this.
-    if isinstance(type_, (List, list)) and not isinstance(type_, typing_extensions.ParamSpec):
-        if any(has_instance_in_type(element, isinstance_target) for element in type_):
-            return True
-
-    return False
-
-
-def check_parameters_count(cls: type[BaseModel], parameters: tuple[Any, ...]) -> None:
-    """Check the generic model parameters count is equal.
-
-    Args:
-        cls: The generic model.
-        parameters: A tuple of passed parameters to the generic model.
-
-    Raises:
-        TypeError: If the passed parameters count is not equal to generic model parameters count.
-    """
-    actual = len(parameters)
-    expected = len(cls.__pydantic_generic_metadata__['parameters'])
-    if actual != expected:
-        description = 'many' if actual > expected else 'few'
-        raise TypeError(f'Too {description} parameters for {cls}; actual {actual}, expected {expected}')
-
-
-_generic_recursion_cache: ContextVar[set[str] | None] = ContextVar('_generic_recursion_cache', default=None)
-
-
-@contextmanager
-def generic_recursion_self_type(
-    origin: type[BaseModel], args: tuple[Any, ...]
-) -> Iterator[PydanticRecursiveRef | None]:
-    """This contextmanager should be placed around the recursive calls used to build a generic type,
-    and accept as arguments the generic origin type and the type arguments being passed to it.
-
-    If the same origin and arguments are observed twice, it implies that a self-reference placeholder
-    can be used while building the core schema, and will produce a schema_ref that will be valid in the
-    final parent schema.
-    """
-    previously_seen_type_refs = _generic_recursion_cache.get()
-    if previously_seen_type_refs is None:
-        previously_seen_type_refs = set()
-        token = _generic_recursion_cache.set(previously_seen_type_refs)
-    else:
-        token = None
-
-    try:
-        type_ref = get_type_ref(origin, args_override=args)
-        if type_ref in previously_seen_type_refs:
-            self_type = PydanticRecursiveRef(type_ref=type_ref)
-            yield self_type
-        else:
-            previously_seen_type_refs.add(type_ref)
-            yield None
-    finally:
-        if token:
-            _generic_recursion_cache.reset(token)
-
-
-def recursively_defined_type_refs() -> set[str]:
-    visited = _generic_recursion_cache.get()
-    if not visited:
-        return set()  # not in a generic recursion, so there are no types
-
-    return visited.copy()  # don't allow modifications
-
-
-def get_cached_generic_type_early(parent: type[BaseModel], typevar_values: Any) -> type[BaseModel] | None:
-    """The use of a two-stage cache lookup approach was necessary to have the highest performance possible for
-    repeated calls to `__class_getitem__` on generic types (which may happen in tighter loops during runtime),
-    while still ensuring that certain alternative parametrizations ultimately resolve to the same type.
-
-    As a concrete example, this approach was necessary to make Model[List[T]][int] equal to Model[List[int]].
-    The approach could be modified to not use two different cache keys at different points, but the
-    _early_cache_key is optimized to be as quick to compute as possible (for repeated-access speed), and the
-    _late_cache_key is optimized to be as "correct" as possible, so that two types that will ultimately be the
-    same after resolving the type arguments will always produce cache hits.
-
-    If we wanted to move to only using a single cache key per type, we would either need to always use the
-    slower/more computationally intensive logic associated with _late_cache_key, or would need to accept
-    that Model[List[T]][int] is a different type than Model[List[T]][int]. Because we rely on subclass relationships
-    during validation, I think it is worthwhile to ensure that types that are functionally equivalent are actually
-    equal.
-    """
-    return _GENERIC_TYPES_CACHE.get(_early_cache_key(parent, typevar_values))
-
-
-def get_cached_generic_type_late(
-    parent: type[BaseModel], typevar_values: Any, origin: type[BaseModel], args: tuple[Any, ...]
-) -> type[BaseModel] | None:
-    """See the docstring of `get_cached_generic_type_early` for more information about the two-stage cache lookup."""
-    cached = _GENERIC_TYPES_CACHE.get(_late_cache_key(origin, args, typevar_values))
-    if cached is not None:
-        set_cached_generic_type(parent, typevar_values, cached, origin, args)
-    return cached
-
-
-def set_cached_generic_type(
-    parent: type[BaseModel],
-    typevar_values: tuple[Any, ...],
-    type_: type[BaseModel],
-    origin: type[BaseModel] | None = None,
-    args: tuple[Any, ...] | None = None,
-) -> None:
-    """See the docstring of `get_cached_generic_type_early` for more information about why items are cached with
-    two different keys.
-    """
-    _GENERIC_TYPES_CACHE[_early_cache_key(parent, typevar_values)] = type_
-    if len(typevar_values) == 1:
-        _GENERIC_TYPES_CACHE[_early_cache_key(parent, typevar_values[0])] = type_
-    if origin and args:
-        _GENERIC_TYPES_CACHE[_late_cache_key(origin, args, typevar_values)] = type_
-
-
-def _union_orderings_key(typevar_values: Any) -> Any:
-    """This is intended to help differentiate between Union types with the same arguments in different order.
-
-    Thanks to caching internal to the `typing` module, it is not possible to distinguish between
-    List[Union[int, float]] and List[Union[float, int]] (and similarly for other "parent" origins besides List)
-    because `typing` considers Union[int, float] to be equal to Union[float, int].
-
-    However, you _can_ distinguish between (top-level) Union[int, float] vs. Union[float, int].
-    Because we parse items as the first Union type that is successful, we get slightly more consistent behavior
-    if we make an effort to distinguish the ordering of items in a union. It would be best if we could _always_
-    get the exact-correct order of items in the union, but that would require a change to the `typing` module itself.
-    (See https://github.com/python/cpython/issues/86483 for reference.)
-    """
-    if isinstance(typevar_values, tuple):
-        args_data = []
-        for value in typevar_values:
-            args_data.append(_union_orderings_key(value))
-        return tuple(args_data)
-    elif typing_extensions.get_origin(typevar_values) is typing.Union:
-        return get_args(typevar_values)
-    else:
-        return ()
-
-
-def _early_cache_key(cls: type[BaseModel], typevar_values: Any) -> GenericTypesCacheKey:
-    """This is intended for minimal computational overhead during lookups of cached types.
-
-    Note that this is overly simplistic, and it's possible that two different cls/typevar_values
-    inputs would ultimately result in the same type being created in BaseModel.__class_getitem__.
-    To handle this, we have a fallback _late_cache_key that is checked later if the _early_cache_key
-    lookup fails, and should result in a cache hit _precisely_ when the inputs to __class_getitem__
-    would result in the same type.
-    """
-    return cls, typevar_values, _union_orderings_key(typevar_values)
-
-
-def _late_cache_key(origin: type[BaseModel], args: tuple[Any, ...], typevar_values: Any) -> GenericTypesCacheKey:
-    """This is intended for use later in the process of creating a new type, when we have more information
-    about the exact args that will be passed. If it turns out that a different set of inputs to
-    __class_getitem__ resulted in the same inputs to the generic type creation process, we can still
-    return the cached type, and update the cache with the _early_cache_key as well.
-    """
-    # The _union_orderings_key is placed at the start here to ensure there cannot be a collision with an
-    # _early_cache_key, as that function will always produce a BaseModel subclass as the first item in the key,
-    # whereas this function will always produce a tuple as the first item in the key.
-    return _union_orderings_key(typevar_values), origin, args
diff --git a/lib/pydantic/_internal/_git.py b/lib/pydantic/_internal/_git.py
deleted file mode 100644
index 9de7aaf9..00000000
--- a/lib/pydantic/_internal/_git.py
+++ /dev/null
@@ -1,26 +0,0 @@
-"""Git utilities, adopted from mypy's git utilities (https://github.com/python/mypy/blob/master/mypy/git.py)."""
-from __future__ import annotations
-
-import os
-import subprocess
-
-
-def is_git_repo(dir: str) -> bool:
-    """Is the given directory version-controlled with git?"""
-    return os.path.exists(os.path.join(dir, '.git'))
-
-
-def have_git() -> bool:
-    """Can we run the git executable?"""
-    try:
-        subprocess.check_output(['git', '--help'])
-        return True
-    except subprocess.CalledProcessError:
-        return False
-    except OSError:
-        return False
-
-
-def git_revision(dir: str) -> str:
-    """Get the SHA-1 of the HEAD of a git repository."""
-    return subprocess.check_output(['git', 'rev-parse', '--short', 'HEAD'], cwd=dir).decode('utf-8').strip()
diff --git a/lib/pydantic/_internal/_internal_dataclass.py b/lib/pydantic/_internal/_internal_dataclass.py
deleted file mode 100644
index 317a3d9c..00000000
--- a/lib/pydantic/_internal/_internal_dataclass.py
+++ /dev/null
@@ -1,10 +0,0 @@
-import sys
-from typing import Any, Dict
-
-dataclass_kwargs: Dict[str, Any]
-
-# `slots` is available on Python >= 3.10
-if sys.version_info >= (3, 10):
-    slots_true = {'slots': True}
-else:
-    slots_true = {}
diff --git a/lib/pydantic/_internal/_known_annotated_metadata.py b/lib/pydantic/_internal/_known_annotated_metadata.py
deleted file mode 100644
index 77caf705..00000000
--- a/lib/pydantic/_internal/_known_annotated_metadata.py
+++ /dev/null
@@ -1,410 +0,0 @@
-from __future__ import annotations
-
-from collections import defaultdict
-from copy import copy
-from functools import partial
-from typing import TYPE_CHECKING, Any, Callable, Iterable
-
-from pydantic_core import CoreSchema, PydanticCustomError, to_jsonable_python
-from pydantic_core import core_schema as cs
-
-from ._fields import PydanticMetadata
-
-if TYPE_CHECKING:
-    from ..annotated_handlers import GetJsonSchemaHandler
-
-
-STRICT = {'strict'}
-SEQUENCE_CONSTRAINTS = {'min_length', 'max_length'}
-INEQUALITY = {'le', 'ge', 'lt', 'gt'}
-NUMERIC_CONSTRAINTS = {'multiple_of', 'allow_inf_nan', *INEQUALITY}
-
-STR_CONSTRAINTS = {*SEQUENCE_CONSTRAINTS, *STRICT, 'strip_whitespace', 'to_lower', 'to_upper', 'pattern'}
-BYTES_CONSTRAINTS = {*SEQUENCE_CONSTRAINTS, *STRICT}
-
-LIST_CONSTRAINTS = {*SEQUENCE_CONSTRAINTS, *STRICT}
-TUPLE_CONSTRAINTS = {*SEQUENCE_CONSTRAINTS, *STRICT}
-SET_CONSTRAINTS = {*SEQUENCE_CONSTRAINTS, *STRICT}
-DICT_CONSTRAINTS = {*SEQUENCE_CONSTRAINTS, *STRICT}
-GENERATOR_CONSTRAINTS = {*SEQUENCE_CONSTRAINTS, *STRICT}
-
-FLOAT_CONSTRAINTS = {*NUMERIC_CONSTRAINTS, *STRICT}
-INT_CONSTRAINTS = {*NUMERIC_CONSTRAINTS, *STRICT}
-BOOL_CONSTRAINTS = STRICT
-UUID_CONSTRAINTS = STRICT
-
-DATE_TIME_CONSTRAINTS = {*NUMERIC_CONSTRAINTS, *STRICT}
-TIMEDELTA_CONSTRAINTS = {*NUMERIC_CONSTRAINTS, *STRICT}
-TIME_CONSTRAINTS = {*NUMERIC_CONSTRAINTS, *STRICT}
-LAX_OR_STRICT_CONSTRAINTS = STRICT
-
-UNION_CONSTRAINTS = {'union_mode'}
-URL_CONSTRAINTS = {
-    'max_length',
-    'allowed_schemes',
-    'host_required',
-    'default_host',
-    'default_port',
-    'default_path',
-}
-
-TEXT_SCHEMA_TYPES = ('str', 'bytes', 'url', 'multi-host-url')
-SEQUENCE_SCHEMA_TYPES = ('list', 'tuple', 'set', 'frozenset', 'generator', *TEXT_SCHEMA_TYPES)
-NUMERIC_SCHEMA_TYPES = ('float', 'int', 'date', 'time', 'timedelta', 'datetime')
-
-CONSTRAINTS_TO_ALLOWED_SCHEMAS: dict[str, set[str]] = defaultdict(set)
-for constraint in STR_CONSTRAINTS:
-    CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(TEXT_SCHEMA_TYPES)
-for constraint in BYTES_CONSTRAINTS:
-    CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('bytes',))
-for constraint in LIST_CONSTRAINTS:
-    CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('list',))
-for constraint in TUPLE_CONSTRAINTS:
-    CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('tuple',))
-for constraint in SET_CONSTRAINTS:
-    CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('set', 'frozenset'))
-for constraint in DICT_CONSTRAINTS:
-    CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('dict',))
-for constraint in GENERATOR_CONSTRAINTS:
-    CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('generator',))
-for constraint in FLOAT_CONSTRAINTS:
-    CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('float',))
-for constraint in INT_CONSTRAINTS:
-    CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('int',))
-for constraint in DATE_TIME_CONSTRAINTS:
-    CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('date', 'time', 'datetime'))
-for constraint in TIMEDELTA_CONSTRAINTS:
-    CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('timedelta',))
-for constraint in TIME_CONSTRAINTS:
-    CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('time',))
-for schema_type in (*TEXT_SCHEMA_TYPES, *SEQUENCE_SCHEMA_TYPES, *NUMERIC_SCHEMA_TYPES, 'typed-dict', 'model'):
-    CONSTRAINTS_TO_ALLOWED_SCHEMAS['strict'].add(schema_type)
-for constraint in UNION_CONSTRAINTS:
-    CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('union',))
-for constraint in URL_CONSTRAINTS:
-    CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('url', 'multi-host-url'))
-for constraint in BOOL_CONSTRAINTS:
-    CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('bool',))
-for constraint in UUID_CONSTRAINTS:
-    CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('uuid',))
-for constraint in LAX_OR_STRICT_CONSTRAINTS:
-    CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('lax-or-strict',))
-
-
-def add_js_update_schema(s: cs.CoreSchema, f: Callable[[], dict[str, Any]]) -> None:
-    def update_js_schema(s: cs.CoreSchema, handler: GetJsonSchemaHandler) -> dict[str, Any]:
-        js_schema = handler(s)
-        js_schema.update(f())
-        return js_schema
-
-    if 'metadata' in s:
-        metadata = s['metadata']
-        if 'pydantic_js_functions' in s:
-            metadata['pydantic_js_functions'].append(update_js_schema)
-        else:
-            metadata['pydantic_js_functions'] = [update_js_schema]
-    else:
-        s['metadata'] = {'pydantic_js_functions': [update_js_schema]}
-
-
-def as_jsonable_value(v: Any) -> Any:
-    if type(v) not in (int, str, float, bytes, bool, type(None)):
-        return to_jsonable_python(v)
-    return v
-
-
-def expand_grouped_metadata(annotations: Iterable[Any]) -> Iterable[Any]:
-    """Expand the annotations.
-
-    Args:
-        annotations: An iterable of annotations.
-
-    Returns:
-        An iterable of expanded annotations.
-
-    Example:
-        ```py
-        from annotated_types import Ge, Len
-
-        from pydantic._internal._known_annotated_metadata import expand_grouped_metadata
-
-        print(list(expand_grouped_metadata([Ge(4), Len(5)])))
-        #> [Ge(ge=4), MinLen(min_length=5)]
-        ```
-    """
-    import annotated_types as at
-
-    from pydantic.fields import FieldInfo  # circular import
-
-    for annotation in annotations:
-        if isinstance(annotation, at.GroupedMetadata):
-            yield from annotation
-        elif isinstance(annotation, FieldInfo):
-            yield from annotation.metadata
-            # this is a bit problematic in that it results in duplicate metadata
-            # all of our "consumers" can handle it, but it is not ideal
-            # we probably should split up FieldInfo into:
-            # - annotated types metadata
-            # - individual metadata known only to Pydantic
-            annotation = copy(annotation)
-            annotation.metadata = []
-            yield annotation
-        else:
-            yield annotation
-
-
-def apply_known_metadata(annotation: Any, schema: CoreSchema) -> CoreSchema | None:  # noqa: C901
-    """Apply `annotation` to `schema` if it is an annotation we know about (Gt, Le, etc.).
-    Otherwise return `None`.
-
-    This does not handle all known annotations. If / when it does, it can always
-    return a CoreSchema and return the unmodified schema if the annotation should be ignored.
-
-    Assumes that GroupedMetadata has already been expanded via `expand_grouped_metadata`.
-
-    Args:
-        annotation: The annotation.
-        schema: The schema.
-
-    Returns:
-        An updated schema with annotation if it is an annotation we know about, `None` otherwise.
-
-    Raises:
-        PydanticCustomError: If `Predicate` fails.
-    """
-    import annotated_types as at
-
-    from . import _validators
-
-    schema = schema.copy()
-    schema_update, other_metadata = collect_known_metadata([annotation])
-    schema_type = schema['type']
-    for constraint, value in schema_update.items():
-        if constraint not in CONSTRAINTS_TO_ALLOWED_SCHEMAS:
-            raise ValueError(f'Unknown constraint {constraint}')
-        allowed_schemas = CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint]
-
-        if schema_type in allowed_schemas:
-            if constraint == 'union_mode' and schema_type == 'union':
-                schema['mode'] = value  # type: ignore  # schema is UnionSchema
-            else:
-                schema[constraint] = value
-            continue
-
-        if constraint == 'allow_inf_nan' and value is False:
-            return cs.no_info_after_validator_function(
-                _validators.forbid_inf_nan_check,
-                schema,
-            )
-        elif constraint == 'pattern':
-            # insert a str schema to make sure the regex engine matches
-            return cs.chain_schema(
-                [
-                    schema,
-                    cs.str_schema(pattern=value),
-                ]
-            )
-        elif constraint == 'gt':
-            s = cs.no_info_after_validator_function(
-                partial(_validators.greater_than_validator, gt=value),
-                schema,
-            )
-            add_js_update_schema(s, lambda: {'gt': as_jsonable_value(value)})
-            return s
-        elif constraint == 'ge':
-            return cs.no_info_after_validator_function(
-                partial(_validators.greater_than_or_equal_validator, ge=value),
-                schema,
-            )
-        elif constraint == 'lt':
-            return cs.no_info_after_validator_function(
-                partial(_validators.less_than_validator, lt=value),
-                schema,
-            )
-        elif constraint == 'le':
-            return cs.no_info_after_validator_function(
-                partial(_validators.less_than_or_equal_validator, le=value),
-                schema,
-            )
-        elif constraint == 'multiple_of':
-            return cs.no_info_after_validator_function(
-                partial(_validators.multiple_of_validator, multiple_of=value),
-                schema,
-            )
-        elif constraint == 'min_length':
-            s = cs.no_info_after_validator_function(
-                partial(_validators.min_length_validator, min_length=value),
-                schema,
-            )
-            add_js_update_schema(s, lambda: {'minLength': (as_jsonable_value(value))})
-            return s
-        elif constraint == 'max_length':
-            s = cs.no_info_after_validator_function(
-                partial(_validators.max_length_validator, max_length=value),
-                schema,
-            )
-            add_js_update_schema(s, lambda: {'maxLength': (as_jsonable_value(value))})
-            return s
-        elif constraint == 'strip_whitespace':
-            return cs.chain_schema(
-                [
-                    schema,
-                    cs.str_schema(strip_whitespace=True),
-                ]
-            )
-        elif constraint == 'to_lower':
-            return cs.chain_schema(
-                [
-                    schema,
-                    cs.str_schema(to_lower=True),
-                ]
-            )
-        elif constraint == 'to_upper':
-            return cs.chain_schema(
-                [
-                    schema,
-                    cs.str_schema(to_upper=True),
-                ]
-            )
-        elif constraint == 'min_length':
-            return cs.no_info_after_validator_function(
-                partial(_validators.min_length_validator, min_length=annotation.min_length),
-                schema,
-            )
-        elif constraint == 'max_length':
-            return cs.no_info_after_validator_function(
-                partial(_validators.max_length_validator, max_length=annotation.max_length),
-                schema,
-            )
-        else:
-            raise RuntimeError(f'Unable to apply constraint {constraint} to schema {schema_type}')
-
-    for annotation in other_metadata:
-        if isinstance(annotation, at.Gt):
-            return cs.no_info_after_validator_function(
-                partial(_validators.greater_than_validator, gt=annotation.gt),
-                schema,
-            )
-        elif isinstance(annotation, at.Ge):
-            return cs.no_info_after_validator_function(
-                partial(_validators.greater_than_or_equal_validator, ge=annotation.ge),
-                schema,
-            )
-        elif isinstance(annotation, at.Lt):
-            return cs.no_info_after_validator_function(
-                partial(_validators.less_than_validator, lt=annotation.lt),
-                schema,
-            )
-        elif isinstance(annotation, at.Le):
-            return cs.no_info_after_validator_function(
-                partial(_validators.less_than_or_equal_validator, le=annotation.le),
-                schema,
-            )
-        elif isinstance(annotation, at.MultipleOf):
-            return cs.no_info_after_validator_function(
-                partial(_validators.multiple_of_validator, multiple_of=annotation.multiple_of),
-                schema,
-            )
-        elif isinstance(annotation, at.MinLen):
-            return cs.no_info_after_validator_function(
-                partial(_validators.min_length_validator, min_length=annotation.min_length),
-                schema,
-            )
-        elif isinstance(annotation, at.MaxLen):
-            return cs.no_info_after_validator_function(
-                partial(_validators.max_length_validator, max_length=annotation.max_length),
-                schema,
-            )
-        elif isinstance(annotation, at.Predicate):
-            predicate_name = f'{annotation.func.__qualname__} ' if hasattr(annotation.func, '__qualname__') else ''
-
-            def val_func(v: Any) -> Any:
-                # annotation.func may also raise an exception, let it pass through
-                if not annotation.func(v):
-                    raise PydanticCustomError(
-                        'predicate_failed',
-                        f'Predicate {predicate_name}failed',  # type: ignore
-                    )
-                return v
-
-            return cs.no_info_after_validator_function(val_func, schema)
-        # ignore any other unknown metadata
-        return None
-
-    return schema
-
-
-def collect_known_metadata(annotations: Iterable[Any]) -> tuple[dict[str, Any], list[Any]]:
-    """Split `annotations` into known metadata and unknown annotations.
-
-    Args:
-        annotations: An iterable of annotations.
-
-    Returns:
-        A tuple contains a dict of known metadata and a list of unknown annotations.
-
-    Example:
-        ```py
-        from annotated_types import Gt, Len
-
-        from pydantic._internal._known_annotated_metadata import collect_known_metadata
-
-        print(collect_known_metadata([Gt(1), Len(42), ...]))
-        #> ({'gt': 1, 'min_length': 42}, [Ellipsis])
-        ```
-    """
-    import annotated_types as at
-
-    annotations = expand_grouped_metadata(annotations)
-
-    res: dict[str, Any] = {}
-    remaining: list[Any] = []
-    for annotation in annotations:
-        # isinstance(annotation, PydanticMetadata) also covers ._fields:_PydanticGeneralMetadata
-        if isinstance(annotation, PydanticMetadata):
-            res.update(annotation.__dict__)
-        # we don't use dataclasses.asdict because that recursively calls asdict on the field values
-        elif isinstance(annotation, at.MinLen):
-            res.update({'min_length': annotation.min_length})
-        elif isinstance(annotation, at.MaxLen):
-            res.update({'max_length': annotation.max_length})
-        elif isinstance(annotation, at.Gt):
-            res.update({'gt': annotation.gt})
-        elif isinstance(annotation, at.Ge):
-            res.update({'ge': annotation.ge})
-        elif isinstance(annotation, at.Lt):
-            res.update({'lt': annotation.lt})
-        elif isinstance(annotation, at.Le):
-            res.update({'le': annotation.le})
-        elif isinstance(annotation, at.MultipleOf):
-            res.update({'multiple_of': annotation.multiple_of})
-        elif isinstance(annotation, type) and issubclass(annotation, PydanticMetadata):
-            # also support PydanticMetadata classes being used without initialisation,
-            # e.g. `Annotated[int, Strict]` as well as `Annotated[int, Strict()]`
-            res.update({k: v for k, v in vars(annotation).items() if not k.startswith('_')})
-        else:
-            remaining.append(annotation)
-    # Nones can sneak in but pydantic-core will reject them
-    # it'd be nice to clean things up so we don't put in None (we probably don't _need_ to, it was just easier)
-    # but this is simple enough to kick that can down the road
-    res = {k: v for k, v in res.items() if v is not None}
-    return res, remaining
-
-
-def check_metadata(metadata: dict[str, Any], allowed: Iterable[str], source_type: Any) -> None:
-    """A small utility function to validate that the given metadata can be applied to the target.
-    More than saving lines of code, this gives us a consistent error message for all of our internal implementations.
-
-    Args:
-        metadata: A dict of metadata.
-        allowed: An iterable of allowed metadata.
-        source_type: The source type.
-
-    Raises:
-        TypeError: If there is metadatas that can't be applied on source type.
-    """
-    unknown = metadata.keys() - set(allowed)
-    if unknown:
-        raise TypeError(
-            f'The following constraints cannot be applied to {source_type!r}: {", ".join([f"{k!r}" for k in unknown])}'
-        )
diff --git a/lib/pydantic/_internal/_mock_val_ser.py b/lib/pydantic/_internal/_mock_val_ser.py
deleted file mode 100644
index b303fed2..00000000
--- a/lib/pydantic/_internal/_mock_val_ser.py
+++ /dev/null
@@ -1,140 +0,0 @@
-from __future__ import annotations
-
-from typing import TYPE_CHECKING, Callable, Generic, TypeVar
-
-from pydantic_core import SchemaSerializer, SchemaValidator
-from typing_extensions import Literal
-
-from ..errors import PydanticErrorCodes, PydanticUserError
-
-if TYPE_CHECKING:
-    from ..dataclasses import PydanticDataclass
-    from ..main import BaseModel
-
-
-ValSer = TypeVar('ValSer', SchemaValidator, SchemaSerializer)
-
-
-class MockValSer(Generic[ValSer]):
-    """Mocker for `pydantic_core.SchemaValidator` or `pydantic_core.SchemaSerializer` which optionally attempts to
-    rebuild the thing it's mocking when one of its methods is accessed and raises an error if that fails.
-    """
-
-    __slots__ = '_error_message', '_code', '_val_or_ser', '_attempt_rebuild'
-
-    def __init__(
-        self,
-        error_message: str,
-        *,
-        code: PydanticErrorCodes,
-        val_or_ser: Literal['validator', 'serializer'],
-        attempt_rebuild: Callable[[], ValSer | None] | None = None,
-    ) -> None:
-        self._error_message = error_message
-        self._val_or_ser = SchemaValidator if val_or_ser == 'validator' else SchemaSerializer
-        self._code: PydanticErrorCodes = code
-        self._attempt_rebuild = attempt_rebuild
-
-    def __getattr__(self, item: str) -> None:
-        __tracebackhide__ = True
-        if self._attempt_rebuild:
-            val_ser = self._attempt_rebuild()
-            if val_ser is not None:
-                return getattr(val_ser, item)
-
-        # raise an AttributeError if `item` doesn't exist
-        getattr(self._val_or_ser, item)
-        raise PydanticUserError(self._error_message, code=self._code)
-
-    def rebuild(self) -> ValSer | None:
-        if self._attempt_rebuild:
-            val_ser = self._attempt_rebuild()
-            if val_ser is not None:
-                return val_ser
-            else:
-                raise PydanticUserError(self._error_message, code=self._code)
-        return None
-
-
-def set_model_mocks(cls: type[BaseModel], cls_name: str, undefined_name: str = 'all referenced types') -> None:
-    """Set `__pydantic_validator__` and `__pydantic_serializer__` to `MockValSer`s on a model.
-
-    Args:
-        cls: The model class to set the mocks on
-        cls_name: Name of the model class, used in error messages
-        undefined_name: Name of the undefined thing, used in error messages
-    """
-    undefined_type_error_message = (
-        f'`{cls_name}` is not fully defined; you should define {undefined_name},'
-        f' then call `{cls_name}.model_rebuild()`.'
-    )
-
-    def attempt_rebuild_validator() -> SchemaValidator | None:
-        if cls.model_rebuild(raise_errors=False, _parent_namespace_depth=5) is not False:
-            return cls.__pydantic_validator__
-        else:
-            return None
-
-    cls.__pydantic_validator__ = MockValSer(  # type: ignore[assignment]
-        undefined_type_error_message,
-        code='class-not-fully-defined',
-        val_or_ser='validator',
-        attempt_rebuild=attempt_rebuild_validator,
-    )
-
-    def attempt_rebuild_serializer() -> SchemaSerializer | None:
-        if cls.model_rebuild(raise_errors=False, _parent_namespace_depth=5) is not False:
-            return cls.__pydantic_serializer__
-        else:
-            return None
-
-    cls.__pydantic_serializer__ = MockValSer(  # type: ignore[assignment]
-        undefined_type_error_message,
-        code='class-not-fully-defined',
-        val_or_ser='serializer',
-        attempt_rebuild=attempt_rebuild_serializer,
-    )
-
-
-def set_dataclass_mocks(
-    cls: type[PydanticDataclass], cls_name: str, undefined_name: str = 'all referenced types'
-) -> None:
-    """Set `__pydantic_validator__` and `__pydantic_serializer__` to `MockValSer`s on a dataclass.
-
-    Args:
-        cls: The model class to set the mocks on
-        cls_name: Name of the model class, used in error messages
-        undefined_name: Name of the undefined thing, used in error messages
-    """
-    from ..dataclasses import rebuild_dataclass
-
-    undefined_type_error_message = (
-        f'`{cls_name}` is not fully defined; you should define {undefined_name},'
-        f' then call `pydantic.dataclasses.rebuild_dataclass({cls_name})`.'
-    )
-
-    def attempt_rebuild_validator() -> SchemaValidator | None:
-        if rebuild_dataclass(cls, raise_errors=False, _parent_namespace_depth=5) is not False:
-            return cls.__pydantic_validator__
-        else:
-            return None
-
-    cls.__pydantic_validator__ = MockValSer(  # type: ignore[assignment]
-        undefined_type_error_message,
-        code='class-not-fully-defined',
-        val_or_ser='validator',
-        attempt_rebuild=attempt_rebuild_validator,
-    )
-
-    def attempt_rebuild_serializer() -> SchemaSerializer | None:
-        if rebuild_dataclass(cls, raise_errors=False, _parent_namespace_depth=5) is not False:
-            return cls.__pydantic_serializer__
-        else:
-            return None
-
-    cls.__pydantic_serializer__ = MockValSer(  # type: ignore[assignment]
-        undefined_type_error_message,
-        code='class-not-fully-defined',
-        val_or_ser='validator',
-        attempt_rebuild=attempt_rebuild_serializer,
-    )
diff --git a/lib/pydantic/_internal/_model_construction.py b/lib/pydantic/_internal/_model_construction.py
deleted file mode 100644
index 543f73e9..00000000
--- a/lib/pydantic/_internal/_model_construction.py
+++ /dev/null
@@ -1,637 +0,0 @@
-"""Private logic for creating models."""
-from __future__ import annotations as _annotations
-
-import operator
-import typing
-import warnings
-import weakref
-from abc import ABCMeta
-from functools import partial
-from types import FunctionType
-from typing import Any, Callable, Generic
-
-import typing_extensions
-from pydantic_core import PydanticUndefined, SchemaSerializer
-from typing_extensions import dataclass_transform, deprecated
-
-from ..errors import PydanticUndefinedAnnotation, PydanticUserError
-from ..plugin._schema_validator import create_schema_validator
-from ..warnings import GenericBeforeBaseModelWarning, PydanticDeprecatedSince20
-from ._config import ConfigWrapper
-from ._decorators import DecoratorInfos, PydanticDescriptorProxy, get_attribute_from_bases
-from ._fields import collect_model_fields, is_valid_field_name, is_valid_privateattr_name
-from ._generate_schema import GenerateSchema
-from ._generics import PydanticGenericMetadata, get_model_typevars_map
-from ._mock_val_ser import MockValSer, set_model_mocks
-from ._schema_generation_shared import CallbackGetCoreSchemaHandler
-from ._signature import generate_pydantic_signature
-from ._typing_extra import get_cls_types_namespace, is_annotated, is_classvar, parent_frame_namespace
-from ._utils import ClassAttribute, SafeGetItemProxy
-from ._validate_call import ValidateCallWrapper
-
-if typing.TYPE_CHECKING:
-    from ..fields import Field as PydanticModelField
-    from ..fields import FieldInfo, ModelPrivateAttr
-    from ..main import BaseModel
-else:
-    # See PyCharm issues https://youtrack.jetbrains.com/issue/PY-21915
-    # and https://youtrack.jetbrains.com/issue/PY-51428
-    DeprecationWarning = PydanticDeprecatedSince20
-    PydanticModelField = object()
-
-object_setattr = object.__setattr__
-
-
-class _ModelNamespaceDict(dict):
-    """A dictionary subclass that intercepts attribute setting on model classes and
-    warns about overriding of decorators.
-    """
-
-    def __setitem__(self, k: str, v: object) -> None:
-        existing: Any = self.get(k, None)
-        if existing and v is not existing and isinstance(existing, PydanticDescriptorProxy):
-            warnings.warn(f'`{k}` overrides an existing Pydantic `{existing.decorator_info.decorator_repr}` decorator')
-
-        return super().__setitem__(k, v)
-
-
-@dataclass_transform(kw_only_default=True, field_specifiers=(PydanticModelField,))
-class ModelMetaclass(ABCMeta):
-    def __new__(
-        mcs,
-        cls_name: str,
-        bases: tuple[type[Any], ...],
-        namespace: dict[str, Any],
-        __pydantic_generic_metadata__: PydanticGenericMetadata | None = None,
-        __pydantic_reset_parent_namespace__: bool = True,
-        _create_model_module: str | None = None,
-        **kwargs: Any,
-    ) -> type:
-        """Metaclass for creating Pydantic models.
-
-        Args:
-            cls_name: The name of the class to be created.
-            bases: The base classes of the class to be created.
-            namespace: The attribute dictionary of the class to be created.
-            __pydantic_generic_metadata__: Metadata for generic models.
-            __pydantic_reset_parent_namespace__: Reset parent namespace.
-            _create_model_module: The module of the class to be created, if created by `create_model`.
-            **kwargs: Catch-all for any other keyword arguments.
-
-        Returns:
-            The new class created by the metaclass.
-        """
-        # Note `ModelMetaclass` refers to `BaseModel`, but is also used to *create* `BaseModel`, so we rely on the fact
-        # that `BaseModel` itself won't have any bases, but any subclass of it will, to determine whether the `__new__`
-        # call we're in the middle of is for the `BaseModel` class.
-        if bases:
-            base_field_names, class_vars, base_private_attributes = mcs._collect_bases_data(bases)
-
-            config_wrapper = ConfigWrapper.for_model(bases, namespace, kwargs)
-            namespace['model_config'] = config_wrapper.config_dict
-            private_attributes = inspect_namespace(
-                namespace, config_wrapper.ignored_types, class_vars, base_field_names
-            )
-            if private_attributes:
-                original_model_post_init = get_model_post_init(namespace, bases)
-                if original_model_post_init is not None:
-                    # if there are private_attributes and a model_post_init function, we handle both
-
-                    def wrapped_model_post_init(self: BaseModel, __context: Any) -> None:
-                        """We need to both initialize private attributes and call the user-defined model_post_init
-                        method.
-                        """
-                        init_private_attributes(self, __context)
-                        original_model_post_init(self, __context)
-
-                    namespace['model_post_init'] = wrapped_model_post_init
-                else:
-                    namespace['model_post_init'] = init_private_attributes
-
-            namespace['__class_vars__'] = class_vars
-            namespace['__private_attributes__'] = {**base_private_attributes, **private_attributes}
-
-            cls: type[BaseModel] = super().__new__(mcs, cls_name, bases, namespace, **kwargs)  # type: ignore
-
-            from ..main import BaseModel
-
-            mro = cls.__mro__
-            if Generic in mro and mro.index(Generic) < mro.index(BaseModel):
-                warnings.warn(
-                    GenericBeforeBaseModelWarning(
-                        'Classes should inherit from `BaseModel` before generic classes (e.g. `typing.Generic[T]`) '
-                        'for pydantic generics to work properly.'
-                    ),
-                    stacklevel=2,
-                )
-
-            cls.__pydantic_custom_init__ = not getattr(cls.__init__, '__pydantic_base_init__', False)
-            cls.__pydantic_post_init__ = None if cls.model_post_init is BaseModel.model_post_init else 'model_post_init'
-
-            cls.__pydantic_decorators__ = DecoratorInfos.build(cls)
-
-            # Use the getattr below to grab the __parameters__ from the `typing.Generic` parent class
-            if __pydantic_generic_metadata__:
-                cls.__pydantic_generic_metadata__ = __pydantic_generic_metadata__
-            else:
-                parent_parameters = getattr(cls, '__pydantic_generic_metadata__', {}).get('parameters', ())
-                parameters = getattr(cls, '__parameters__', None) or parent_parameters
-                if parameters and parent_parameters and not all(x in parameters for x in parent_parameters):
-                    combined_parameters = parent_parameters + tuple(x for x in parameters if x not in parent_parameters)
-                    parameters_str = ', '.join([str(x) for x in combined_parameters])
-                    generic_type_label = f'typing.Generic[{parameters_str}]'
-                    error_message = (
-                        f'All parameters must be present on typing.Generic;'
-                        f' you should inherit from {generic_type_label}.'
-                    )
-                    if Generic not in bases:  # pragma: no cover
-                        # We raise an error here not because it is desirable, but because some cases are mishandled.
-                        # It would be nice to remove this error and still have things behave as expected, it's just
-                        # challenging because we are using a custom `__class_getitem__` to parametrize generic models,
-                        # and not returning a typing._GenericAlias from it.
-                        bases_str = ', '.join([x.__name__ for x in bases] + [generic_type_label])
-                        error_message += (
-                            f' Note: `typing.Generic` must go last: `class {cls.__name__}({bases_str}): ...`)'
-                        )
-                    raise TypeError(error_message)
-
-                cls.__pydantic_generic_metadata__ = {
-                    'origin': None,
-                    'args': (),
-                    'parameters': parameters,
-                }
-
-            cls.__pydantic_complete__ = False  # Ensure this specific class gets completed
-
-            # preserve `__set_name__` protocol defined in https://peps.python.org/pep-0487
-            # for attributes not in `new_namespace` (e.g. private attributes)
-            for name, obj in private_attributes.items():
-                obj.__set_name__(cls, name)
-
-            if __pydantic_reset_parent_namespace__:
-                cls.__pydantic_parent_namespace__ = build_lenient_weakvaluedict(parent_frame_namespace())
-            parent_namespace = getattr(cls, '__pydantic_parent_namespace__', None)
-            if isinstance(parent_namespace, dict):
-                parent_namespace = unpack_lenient_weakvaluedict(parent_namespace)
-
-            types_namespace = get_cls_types_namespace(cls, parent_namespace)
-            set_model_fields(cls, bases, config_wrapper, types_namespace)
-
-            if config_wrapper.frozen and '__hash__' not in namespace:
-                set_default_hash_func(cls, bases)
-
-            complete_model_class(
-                cls,
-                cls_name,
-                config_wrapper,
-                raise_errors=False,
-                types_namespace=types_namespace,
-                create_model_module=_create_model_module,
-            )
-
-            # If this is placed before the complete_model_class call above,
-            # the generic computed fields return type is set to PydanticUndefined
-            cls.model_computed_fields = {k: v.info for k, v in cls.__pydantic_decorators__.computed_fields.items()}
-
-            # using super(cls, cls) on the next line ensures we only call the parent class's __pydantic_init_subclass__
-            # I believe the `type: ignore` is only necessary because mypy doesn't realize that this code branch is
-            # only hit for _proper_ subclasses of BaseModel
-            super(cls, cls).__pydantic_init_subclass__(**kwargs)  # type: ignore[misc]
-            return cls
-        else:
-            # this is the BaseModel class itself being created, no logic required
-            return super().__new__(mcs, cls_name, bases, namespace, **kwargs)
-
-    if not typing.TYPE_CHECKING:  # pragma: no branch
-        # We put `__getattr__` in a non-TYPE_CHECKING block because otherwise, mypy allows arbitrary attribute access
-
-        def __getattr__(self, item: str) -> Any:
-            """This is necessary to keep attribute access working for class attribute access."""
-            private_attributes = self.__dict__.get('__private_attributes__')
-            if private_attributes and item in private_attributes:
-                return private_attributes[item]
-            if item == '__pydantic_core_schema__':
-                # This means the class didn't get a schema generated for it, likely because there was an undefined reference
-                maybe_mock_validator = getattr(self, '__pydantic_validator__', None)
-                if isinstance(maybe_mock_validator, MockValSer):
-                    rebuilt_validator = maybe_mock_validator.rebuild()
-                    if rebuilt_validator is not None:
-                        # In this case, a validator was built, and so `__pydantic_core_schema__` should now be set
-                        return getattr(self, '__pydantic_core_schema__')
-            raise AttributeError(item)
-
-    @classmethod
-    def __prepare__(cls, *args: Any, **kwargs: Any) -> dict[str, object]:
-        return _ModelNamespaceDict()
-
-    def __instancecheck__(self, instance: Any) -> bool:
-        """Avoid calling ABC _abc_subclasscheck unless we're pretty sure.
-
-        See #3829 and python/cpython#92810
-        """
-        return hasattr(instance, '__pydantic_validator__') and super().__instancecheck__(instance)
-
-    @staticmethod
-    def _collect_bases_data(bases: tuple[type[Any], ...]) -> tuple[set[str], set[str], dict[str, ModelPrivateAttr]]:
-        from ..main import BaseModel
-
-        field_names: set[str] = set()
-        class_vars: set[str] = set()
-        private_attributes: dict[str, ModelPrivateAttr] = {}
-        for base in bases:
-            if issubclass(base, BaseModel) and base is not BaseModel:
-                # model_fields might not be defined yet in the case of generics, so we use getattr here:
-                field_names.update(getattr(base, 'model_fields', {}).keys())
-                class_vars.update(base.__class_vars__)
-                private_attributes.update(base.__private_attributes__)
-        return field_names, class_vars, private_attributes
-
-    @property
-    @deprecated('The `__fields__` attribute is deprecated, use `model_fields` instead.', category=None)
-    def __fields__(self) -> dict[str, FieldInfo]:
-        warnings.warn(
-            'The `__fields__` attribute is deprecated, use `model_fields` instead.', PydanticDeprecatedSince20
-        )
-        return self.model_fields  # type: ignore
-
-    def __dir__(self) -> list[str]:
-        attributes = list(super().__dir__())
-        if '__fields__' in attributes:
-            attributes.remove('__fields__')
-        return attributes
-
-
-def init_private_attributes(self: BaseModel, __context: Any) -> None:
-    """This function is meant to behave like a BaseModel method to initialise private attributes.
-
-    It takes context as an argument since that's what pydantic-core passes when calling it.
-
-    Args:
-        self: The BaseModel instance.
-        __context: The context.
-    """
-    if getattr(self, '__pydantic_private__', None) is None:
-        pydantic_private = {}
-        for name, private_attr in self.__private_attributes__.items():
-            default = private_attr.get_default()
-            if default is not PydanticUndefined:
-                pydantic_private[name] = default
-        object_setattr(self, '__pydantic_private__', pydantic_private)
-
-
-def get_model_post_init(namespace: dict[str, Any], bases: tuple[type[Any], ...]) -> Callable[..., Any] | None:
-    """Get the `model_post_init` method from the namespace or the class bases, or `None` if not defined."""
-    if 'model_post_init' in namespace:
-        return namespace['model_post_init']
-
-    from ..main import BaseModel
-
-    model_post_init = get_attribute_from_bases(bases, 'model_post_init')
-    if model_post_init is not BaseModel.model_post_init:
-        return model_post_init
-
-
-def inspect_namespace(  # noqa C901
-    namespace: dict[str, Any],
-    ignored_types: tuple[type[Any], ...],
-    base_class_vars: set[str],
-    base_class_fields: set[str],
-) -> dict[str, ModelPrivateAttr]:
-    """Iterate over the namespace and:
-    * gather private attributes
-    * check for items which look like fields but are not (e.g. have no annotation) and warn.
-
-    Args:
-        namespace: The attribute dictionary of the class to be created.
-        ignored_types: A tuple of ignore types.
-        base_class_vars: A set of base class class variables.
-        base_class_fields: A set of base class fields.
-
-    Returns:
-        A dict contains private attributes info.
-
-    Raises:
-        TypeError: If there is a `__root__` field in model.
-        NameError: If private attribute name is invalid.
-        PydanticUserError:
-            - If a field does not have a type annotation.
-            - If a field on base class was overridden by a non-annotated attribute.
-    """
-    from ..fields import FieldInfo, ModelPrivateAttr, PrivateAttr
-
-    all_ignored_types = ignored_types + default_ignored_types()
-
-    private_attributes: dict[str, ModelPrivateAttr] = {}
-    raw_annotations = namespace.get('__annotations__', {})
-
-    if '__root__' in raw_annotations or '__root__' in namespace:
-        raise TypeError("To define root models, use `pydantic.RootModel` rather than a field called '__root__'")
-
-    ignored_names: set[str] = set()
-    for var_name, value in list(namespace.items()):
-        if var_name == 'model_config':
-            continue
-        elif (
-            isinstance(value, type)
-            and value.__module__ == namespace['__module__']
-            and value.__qualname__.startswith(namespace['__qualname__'])
-        ):
-            # `value` is a nested type defined in this namespace; don't error
-            continue
-        elif isinstance(value, all_ignored_types) or value.__class__.__module__ == 'functools':
-            ignored_names.add(var_name)
-            continue
-        elif isinstance(value, ModelPrivateAttr):
-            if var_name.startswith('__'):
-                raise NameError(
-                    'Private attributes must not use dunder names;'
-                    f' use a single underscore prefix instead of {var_name!r}.'
-                )
-            elif is_valid_field_name(var_name):
-                raise NameError(
-                    'Private attributes must not use valid field names;'
-                    f' use sunder names, e.g. {"_" + var_name!r} instead of {var_name!r}.'
-                )
-            private_attributes[var_name] = value
-            del namespace[var_name]
-        elif isinstance(value, FieldInfo) and not is_valid_field_name(var_name):
-            suggested_name = var_name.lstrip('_') or 'my_field'  # don't suggest '' for all-underscore name
-            raise NameError(
-                f'Fields must not use names with leading underscores;'
-                f' e.g., use {suggested_name!r} instead of {var_name!r}.'
-            )
-
-        elif var_name.startswith('__'):
-            continue
-        elif is_valid_privateattr_name(var_name):
-            if var_name not in raw_annotations or not is_classvar(raw_annotations[var_name]):
-                private_attributes[var_name] = PrivateAttr(default=value)
-                del namespace[var_name]
-        elif var_name in base_class_vars:
-            continue
-        elif var_name not in raw_annotations:
-            if var_name in base_class_fields:
-                raise PydanticUserError(
-                    f'Field {var_name!r} defined on a base class was overridden by a non-annotated attribute. '
-                    f'All field definitions, including overrides, require a type annotation.',
-                    code='model-field-overridden',
-                )
-            elif isinstance(value, FieldInfo):
-                raise PydanticUserError(
-                    f'Field {var_name!r} requires a type annotation', code='model-field-missing-annotation'
-                )
-            else:
-                raise PydanticUserError(
-                    f'A non-annotated attribute was detected: `{var_name} = {value!r}`. All model fields require a '
-                    f'type annotation; if `{var_name}` is not meant to be a field, you may be able to resolve this '
-                    f"error by annotating it as a `ClassVar` or updating `model_config['ignored_types']`.",
-                    code='model-field-missing-annotation',
-                )
-
-    for ann_name, ann_type in raw_annotations.items():
-        if (
-            is_valid_privateattr_name(ann_name)
-            and ann_name not in private_attributes
-            and ann_name not in ignored_names
-            and not is_classvar(ann_type)
-            and ann_type not in all_ignored_types
-            and getattr(ann_type, '__module__', None) != 'functools'
-        ):
-            if is_annotated(ann_type):
-                _, *metadata = typing_extensions.get_args(ann_type)
-                private_attr = next((v for v in metadata if isinstance(v, ModelPrivateAttr)), None)
-                if private_attr is not None:
-                    private_attributes[ann_name] = private_attr
-                    continue
-            private_attributes[ann_name] = PrivateAttr()
-
-    return private_attributes
-
-
-def set_default_hash_func(cls: type[BaseModel], bases: tuple[type[Any], ...]) -> None:
-    base_hash_func = get_attribute_from_bases(bases, '__hash__')
-    new_hash_func = make_hash_func(cls)
-    if base_hash_func in {None, object.__hash__} or getattr(base_hash_func, '__code__', None) == new_hash_func.__code__:
-        # If `__hash__` is some default, we generate a hash function.
-        # It will be `None` if not overridden from BaseModel.
-        # It may be `object.__hash__` if there is another
-        # parent class earlier in the bases which doesn't override `__hash__` (e.g. `typing.Generic`).
-        # It may be a value set by `set_default_hash_func` if `cls` is a subclass of another frozen model.
-        # In the last case we still need a new hash function to account for new `model_fields`.
-        cls.__hash__ = new_hash_func
-
-
-def make_hash_func(cls: type[BaseModel]) -> Any:
-    getter = operator.itemgetter(*cls.model_fields.keys()) if cls.model_fields else lambda _: 0
-
-    def hash_func(self: Any) -> int:
-        try:
-            return hash(getter(self.__dict__))
-        except KeyError:
-            # In rare cases (such as when using the deprecated copy method), the __dict__ may not contain
-            # all model fields, which is how we can get here.
-            # getter(self.__dict__) is much faster than any 'safe' method that accounts for missing keys,
-            # and wrapping it in a `try` doesn't slow things down much in the common case.
-            return hash(getter(SafeGetItemProxy(self.__dict__)))
-
-    return hash_func
-
-
-def set_model_fields(
-    cls: type[BaseModel], bases: tuple[type[Any], ...], config_wrapper: ConfigWrapper, types_namespace: dict[str, Any]
-) -> None:
-    """Collect and set `cls.model_fields` and `cls.__class_vars__`.
-
-    Args:
-        cls: BaseModel or dataclass.
-        bases: Parents of the class, generally `cls.__bases__`.
-        config_wrapper: The config wrapper instance.
-        types_namespace: Optional extra namespace to look for types in.
-    """
-    typevars_map = get_model_typevars_map(cls)
-    fields, class_vars = collect_model_fields(cls, bases, config_wrapper, types_namespace, typevars_map=typevars_map)
-
-    cls.model_fields = fields
-    cls.__class_vars__.update(class_vars)
-
-    for k in class_vars:
-        # Class vars should not be private attributes
-        #     We remove them _here_ and not earlier because we rely on inspecting the class to determine its classvars,
-        #     but private attributes are determined by inspecting the namespace _prior_ to class creation.
-        #     In the case that a classvar with a leading-'_' is defined via a ForwardRef (e.g., when using
-        #     `__future__.annotations`), we want to remove the private attribute which was detected _before_ we knew it
-        #     evaluated to a classvar
-
-        value = cls.__private_attributes__.pop(k, None)
-        if value is not None and value.default is not PydanticUndefined:
-            setattr(cls, k, value.default)
-
-
-def complete_model_class(
-    cls: type[BaseModel],
-    cls_name: str,
-    config_wrapper: ConfigWrapper,
-    *,
-    raise_errors: bool = True,
-    types_namespace: dict[str, Any] | None,
-    create_model_module: str | None = None,
-) -> bool:
-    """Finish building a model class.
-
-    This logic must be called after class has been created since validation functions must be bound
-    and `get_type_hints` requires a class object.
-
-    Args:
-        cls: BaseModel or dataclass.
-        cls_name: The model or dataclass name.
-        config_wrapper: The config wrapper instance.
-        raise_errors: Whether to raise errors.
-        types_namespace: Optional extra namespace to look for types in.
-        create_model_module: The module of the class to be created, if created by `create_model`.
-
-    Returns:
-        `True` if the model is successfully completed, else `False`.
-
-    Raises:
-        PydanticUndefinedAnnotation: If `PydanticUndefinedAnnotation` occurs in`__get_pydantic_core_schema__`
-            and `raise_errors=True`.
-    """
-    typevars_map = get_model_typevars_map(cls)
-    gen_schema = GenerateSchema(
-        config_wrapper,
-        types_namespace,
-        typevars_map,
-    )
-
-    handler = CallbackGetCoreSchemaHandler(
-        partial(gen_schema.generate_schema, from_dunder_get_core_schema=False),
-        gen_schema,
-        ref_mode='unpack',
-    )
-
-    if config_wrapper.defer_build:
-        set_model_mocks(cls, cls_name)
-        return False
-
-    try:
-        schema = cls.__get_pydantic_core_schema__(cls, handler)
-    except PydanticUndefinedAnnotation as e:
-        if raise_errors:
-            raise
-        set_model_mocks(cls, cls_name, f'`{e.name}`')
-        return False
-
-    core_config = config_wrapper.core_config(cls)
-
-    try:
-        schema = gen_schema.clean_schema(schema)
-    except gen_schema.CollectedInvalid:
-        set_model_mocks(cls, cls_name)
-        return False
-
-    # debug(schema)
-    cls.__pydantic_core_schema__ = schema
-
-    cls.__pydantic_validator__ = create_schema_validator(
-        schema,
-        cls,
-        create_model_module or cls.__module__,
-        cls.__qualname__,
-        'create_model' if create_model_module else 'BaseModel',
-        core_config,
-        config_wrapper.plugin_settings,
-    )
-    cls.__pydantic_serializer__ = SchemaSerializer(schema, core_config)
-    cls.__pydantic_complete__ = True
-
-    # set __signature__ attr only for model class, but not for its instances
-    cls.__signature__ = ClassAttribute(
-        '__signature__',
-        generate_pydantic_signature(init=cls.__init__, fields=cls.model_fields, config_wrapper=config_wrapper),
-    )
-    return True
-
-
-class _PydanticWeakRef:
-    """Wrapper for `weakref.ref` that enables `pickle` serialization.
-
-    Cloudpickle fails to serialize `weakref.ref` objects due to an arcane error related
-    to abstract base classes (`abc.ABC`). This class works around the issue by wrapping
-    `weakref.ref` instead of subclassing it.
-
-    See https://github.com/pydantic/pydantic/issues/6763 for context.
-
-    Semantics:
-        - If not pickled, behaves the same as a `weakref.ref`.
-        - If pickled along with the referenced object, the same `weakref.ref` behavior
-          will be maintained between them after unpickling.
-        - If pickled without the referenced object, after unpickling the underlying
-          reference will be cleared (`__call__` will always return `None`).
-    """
-
-    def __init__(self, obj: Any):
-        if obj is None:
-            # The object will be `None` upon deserialization if the serialized weakref
-            # had lost its underlying object.
-            self._wr = None
-        else:
-            self._wr = weakref.ref(obj)
-
-    def __call__(self) -> Any:
-        if self._wr is None:
-            return None
-        else:
-            return self._wr()
-
-    def __reduce__(self) -> tuple[Callable, tuple[weakref.ReferenceType | None]]:
-        return _PydanticWeakRef, (self(),)
-
-
-def build_lenient_weakvaluedict(d: dict[str, Any] | None) -> dict[str, Any] | None:
-    """Takes an input dictionary, and produces a new value that (invertibly) replaces the values with weakrefs.
-
-    We can't just use a WeakValueDictionary because many types (including int, str, etc.) can't be stored as values
-    in a WeakValueDictionary.
-
-    The `unpack_lenient_weakvaluedict` function can be used to reverse this operation.
-    """
-    if d is None:
-        return None
-    result = {}
-    for k, v in d.items():
-        try:
-            proxy = _PydanticWeakRef(v)
-        except TypeError:
-            proxy = v
-        result[k] = proxy
-    return result
-
-
-def unpack_lenient_weakvaluedict(d: dict[str, Any] | None) -> dict[str, Any] | None:
-    """Inverts the transform performed by `build_lenient_weakvaluedict`."""
-    if d is None:
-        return None
-
-    result = {}
-    for k, v in d.items():
-        if isinstance(v, _PydanticWeakRef):
-            v = v()
-            if v is not None:
-                result[k] = v
-        else:
-            result[k] = v
-    return result
-
-
-def default_ignored_types() -> tuple[type[Any], ...]:
-    from ..fields import ComputedFieldInfo
-
-    return (
-        FunctionType,
-        property,
-        classmethod,
-        staticmethod,
-        PydanticDescriptorProxy,
-        ComputedFieldInfo,
-        ValidateCallWrapper,
-    )
diff --git a/lib/pydantic/_internal/_repr.py b/lib/pydantic/_internal/_repr.py
deleted file mode 100644
index 479b4479..00000000
--- a/lib/pydantic/_internal/_repr.py
+++ /dev/null
@@ -1,117 +0,0 @@
-"""Tools to provide pretty/human-readable display of objects."""
-from __future__ import annotations as _annotations
-
-import types
-import typing
-from typing import Any
-
-import typing_extensions
-
-from . import _typing_extra
-
-if typing.TYPE_CHECKING:
-    ReprArgs: typing_extensions.TypeAlias = 'typing.Iterable[tuple[str | None, Any]]'
-    RichReprResult: typing_extensions.TypeAlias = (
-        'typing.Iterable[Any | tuple[Any] | tuple[str, Any] | tuple[str, Any, Any]]'
-    )
-
-
-class PlainRepr(str):
-    """String class where repr doesn't include quotes. Useful with Representation when you want to return a string
-    representation of something that is valid (or pseudo-valid) python.
-    """
-
-    def __repr__(self) -> str:
-        return str(self)
-
-
-class Representation:
-    # Mixin to provide `__str__`, `__repr__`, and `__pretty__` and `__rich_repr__` methods.
-    # `__pretty__` is used by [devtools](https://python-devtools.helpmanual.io/).
-    # `__rich_repr__` is used by [rich](https://rich.readthedocs.io/en/stable/pretty.html).
-    # (this is not a docstring to avoid adding a docstring to classes which inherit from Representation)
-
-    # we don't want to use a type annotation here as it can break get_type_hints
-    __slots__ = tuple()  # type: typing.Collection[str]
-
-    def __repr_args__(self) -> ReprArgs:
-        """Returns the attributes to show in __str__, __repr__, and __pretty__ this is generally overridden.
-
-        Can either return:
-        * name - value pairs, e.g.: `[('foo_name', 'foo'), ('bar_name', ['b', 'a', 'r'])]`
-        * or, just values, e.g.: `[(None, 'foo'), (None, ['b', 'a', 'r'])]`
-        """
-        attrs_names = self.__slots__
-        if not attrs_names and hasattr(self, '__dict__'):
-            attrs_names = self.__dict__.keys()
-        attrs = ((s, getattr(self, s)) for s in attrs_names)
-        return [(a, v) for a, v in attrs if v is not None]
-
-    def __repr_name__(self) -> str:
-        """Name of the instance's class, used in __repr__."""
-        return self.__class__.__name__
-
-    def __repr_str__(self, join_str: str) -> str:
-        return join_str.join(repr(v) if a is None else f'{a}={v!r}' for a, v in self.__repr_args__())
-
-    def __pretty__(self, fmt: typing.Callable[[Any], Any], **kwargs: Any) -> typing.Generator[Any, None, None]:
-        """Used by devtools (https://python-devtools.helpmanual.io/) to pretty print objects."""
-        yield self.__repr_name__() + '('
-        yield 1
-        for name, value in self.__repr_args__():
-            if name is not None:
-                yield name + '='
-            yield fmt(value)
-            yield ','
-            yield 0
-        yield -1
-        yield ')'
-
-    def __rich_repr__(self) -> RichReprResult:
-        """Used by Rich (https://rich.readthedocs.io/en/stable/pretty.html) to pretty print objects."""
-        for name, field_repr in self.__repr_args__():
-            if name is None:
-                yield field_repr
-            else:
-                yield name, field_repr
-
-    def __str__(self) -> str:
-        return self.__repr_str__(' ')
-
-    def __repr__(self) -> str:
-        return f'{self.__repr_name__()}({self.__repr_str__(", ")})'
-
-
-def display_as_type(obj: Any) -> str:
-    """Pretty representation of a type, should be as close as possible to the original type definition string.
-
-    Takes some logic from `typing._type_repr`.
-    """
-    if isinstance(obj, types.FunctionType):
-        return obj.__name__
-    elif obj is ...:
-        return '...'
-    elif isinstance(obj, Representation):
-        return repr(obj)
-    elif isinstance(obj, typing_extensions.TypeAliasType):
-        return str(obj)
-
-    if not isinstance(obj, (_typing_extra.typing_base, _typing_extra.WithArgsTypes, type)):
-        obj = obj.__class__
-
-    if _typing_extra.origin_is_union(typing_extensions.get_origin(obj)):
-        args = ', '.join(map(display_as_type, typing_extensions.get_args(obj)))
-        return f'Union[{args}]'
-    elif isinstance(obj, _typing_extra.WithArgsTypes):
-        if typing_extensions.get_origin(obj) == typing_extensions.Literal:
-            args = ', '.join(map(repr, typing_extensions.get_args(obj)))
-        else:
-            args = ', '.join(map(display_as_type, typing_extensions.get_args(obj)))
-        try:
-            return f'{obj.__qualname__}[{args}]'
-        except AttributeError:
-            return str(obj)  # handles TypeAliasType in 3.12
-    elif isinstance(obj, type):
-        return obj.__qualname__
-    else:
-        return repr(obj).replace('typing.', '').replace('typing_extensions.', '')
diff --git a/lib/pydantic/_internal/_schema_generation_shared.py b/lib/pydantic/_internal/_schema_generation_shared.py
deleted file mode 100644
index 1a9aa852..00000000
--- a/lib/pydantic/_internal/_schema_generation_shared.py
+++ /dev/null
@@ -1,124 +0,0 @@
-"""Types and utility functions used by various other internal tools."""
-from __future__ import annotations
-
-from typing import TYPE_CHECKING, Any, Callable
-
-from pydantic_core import core_schema
-from typing_extensions import Literal
-
-from ..annotated_handlers import GetCoreSchemaHandler, GetJsonSchemaHandler
-
-if TYPE_CHECKING:
-    from ..json_schema import GenerateJsonSchema, JsonSchemaValue
-    from ._core_utils import CoreSchemaOrField
-    from ._generate_schema import GenerateSchema
-
-    GetJsonSchemaFunction = Callable[[CoreSchemaOrField, GetJsonSchemaHandler], JsonSchemaValue]
-    HandlerOverride = Callable[[CoreSchemaOrField], JsonSchemaValue]
-
-
-class GenerateJsonSchemaHandler(GetJsonSchemaHandler):
-    """JsonSchemaHandler implementation that doesn't do ref unwrapping by default.
-
-    This is used for any Annotated metadata so that we don't end up with conflicting
-    modifications to the definition schema.
-
-    Used internally by Pydantic, please do not rely on this implementation.
-    See `GetJsonSchemaHandler` for the handler API.
-    """
-
-    def __init__(self, generate_json_schema: GenerateJsonSchema, handler_override: HandlerOverride | None) -> None:
-        self.generate_json_schema = generate_json_schema
-        self.handler = handler_override or generate_json_schema.generate_inner
-        self.mode = generate_json_schema.mode
-
-    def __call__(self, __core_schema: CoreSchemaOrField) -> JsonSchemaValue:
-        return self.handler(__core_schema)
-
-    def resolve_ref_schema(self, maybe_ref_json_schema: JsonSchemaValue) -> JsonSchemaValue:
-        """Resolves `$ref` in the json schema.
-
-        This returns the input json schema if there is no `$ref` in json schema.
-
-        Args:
-            maybe_ref_json_schema: The input json schema that may contains `$ref`.
-
-        Returns:
-            Resolved json schema.
-
-        Raises:
-            LookupError: If it can't find the definition for `$ref`.
-        """
-        if '$ref' not in maybe_ref_json_schema:
-            return maybe_ref_json_schema
-        ref = maybe_ref_json_schema['$ref']
-        json_schema = self.generate_json_schema.get_schema_from_definitions(ref)
-        if json_schema is None:
-            raise LookupError(
-                f'Could not find a ref for {ref}.'
-                ' Maybe you tried to call resolve_ref_schema from within a recursive model?'
-            )
-        return json_schema
-
-
-class CallbackGetCoreSchemaHandler(GetCoreSchemaHandler):
-    """Wrapper to use an arbitrary function as a `GetCoreSchemaHandler`.
-
-    Used internally by Pydantic, please do not rely on this implementation.
-    See `GetCoreSchemaHandler` for the handler API.
-    """
-
-    def __init__(
-        self,
-        handler: Callable[[Any], core_schema.CoreSchema],
-        generate_schema: GenerateSchema,
-        ref_mode: Literal['to-def', 'unpack'] = 'to-def',
-    ) -> None:
-        self._handler = handler
-        self._generate_schema = generate_schema
-        self._ref_mode = ref_mode
-
-    def __call__(self, __source_type: Any) -> core_schema.CoreSchema:
-        schema = self._handler(__source_type)
-        ref = schema.get('ref')
-        if self._ref_mode == 'to-def':
-            if ref is not None:
-                self._generate_schema.defs.definitions[ref] = schema
-                return core_schema.definition_reference_schema(ref)
-            return schema
-        else:  # ref_mode = 'unpack
-            return self.resolve_ref_schema(schema)
-
-    def _get_types_namespace(self) -> dict[str, Any] | None:
-        return self._generate_schema._types_namespace
-
-    def generate_schema(self, __source_type: Any) -> core_schema.CoreSchema:
-        return self._generate_schema.generate_schema(__source_type)
-
-    @property
-    def field_name(self) -> str | None:
-        return self._generate_schema.field_name_stack.get()
-
-    def resolve_ref_schema(self, maybe_ref_schema: core_schema.CoreSchema) -> core_schema.CoreSchema:
-        """Resolves reference in the core schema.
-
-        Args:
-            maybe_ref_schema: The input core schema that may contains reference.
-
-        Returns:
-            Resolved core schema.
-
-        Raises:
-            LookupError: If it can't find the definition for reference.
-        """
-        if maybe_ref_schema['type'] == 'definition-ref':
-            ref = maybe_ref_schema['schema_ref']
-            if ref not in self._generate_schema.defs.definitions:
-                raise LookupError(
-                    f'Could not find a ref for {ref}.'
-                    ' Maybe you tried to call resolve_ref_schema from within a recursive model?'
-                )
-            return self._generate_schema.defs.definitions[ref]
-        elif maybe_ref_schema['type'] == 'definitions':
-            return self.resolve_ref_schema(maybe_ref_schema['schema'])
-        return maybe_ref_schema
diff --git a/lib/pydantic/_internal/_signature.py b/lib/pydantic/_internal/_signature.py
deleted file mode 100644
index 816a1651..00000000
--- a/lib/pydantic/_internal/_signature.py
+++ /dev/null
@@ -1,164 +0,0 @@
-from __future__ import annotations
-
-import dataclasses
-from inspect import Parameter, Signature, signature
-from typing import TYPE_CHECKING, Any, Callable
-
-from pydantic_core import PydanticUndefined
-
-from ._config import ConfigWrapper
-from ._utils import is_valid_identifier
-
-if TYPE_CHECKING:
-    from ..fields import FieldInfo
-
-
-def _field_name_for_signature(field_name: str, field_info: FieldInfo) -> str:
-    """Extract the correct name to use for the field when generating a signature.
-
-    Assuming the field has a valid alias, this will return the alias. Otherwise, it will return the field name.
-    First priority is given to the validation_alias, then the alias, then the field name.
-
-    Args:
-        field_name: The name of the field
-        field_info: The corresponding FieldInfo object.
-
-    Returns:
-        The correct name to use when generating a signature.
-    """
-
-    def _alias_if_valid(x: Any) -> str | None:
-        """Return the alias if it is a valid alias and identifier, else None."""
-        return x if isinstance(x, str) and is_valid_identifier(x) else None
-
-    return _alias_if_valid(field_info.alias) or _alias_if_valid(field_info.validation_alias) or field_name
-
-
-def _process_param_defaults(param: Parameter) -> Parameter:
-    """Modify the signature for a parameter in a dataclass where the default value is a FieldInfo instance.
-
-    Args:
-        param (Parameter): The parameter
-
-    Returns:
-        Parameter: The custom processed parameter
-    """
-    from ..fields import FieldInfo
-
-    param_default = param.default
-    if isinstance(param_default, FieldInfo):
-        annotation = param.annotation
-        # Replace the annotation if appropriate
-        # inspect does "clever" things to show annotations as strings because we have
-        # `from __future__ import annotations` in main, we don't want that
-        if annotation == 'Any':
-            annotation = Any
-
-        # Replace the field default
-        default = param_default.default
-        if default is PydanticUndefined:
-            if param_default.default_factory is PydanticUndefined:
-                default = Signature.empty
-            else:
-                # this is used by dataclasses to indicate a factory exists:
-                default = dataclasses._HAS_DEFAULT_FACTORY  # type: ignore
-        return param.replace(
-            annotation=annotation, name=_field_name_for_signature(param.name, param_default), default=default
-        )
-    return param
-
-
-def _generate_signature_parameters(  # noqa: C901 (ignore complexity, could use a refactor)
-    init: Callable[..., None],
-    fields: dict[str, FieldInfo],
-    config_wrapper: ConfigWrapper,
-) -> dict[str, Parameter]:
-    """Generate a mapping of parameter names to Parameter objects for a pydantic BaseModel or dataclass."""
-    from itertools import islice
-
-    present_params = signature(init).parameters.values()
-    merged_params: dict[str, Parameter] = {}
-    var_kw = None
-    use_var_kw = False
-
-    for param in islice(present_params, 1, None):  # skip self arg
-        # inspect does "clever" things to show annotations as strings because we have
-        # `from __future__ import annotations` in main, we don't want that
-        if fields.get(param.name):
-            # exclude params with init=False
-            if getattr(fields[param.name], 'init', True) is False:
-                continue
-            param = param.replace(name=_field_name_for_signature(param.name, fields[param.name]))
-        if param.annotation == 'Any':
-            param = param.replace(annotation=Any)
-        if param.kind is param.VAR_KEYWORD:
-            var_kw = param
-            continue
-        merged_params[param.name] = param
-
-    if var_kw:  # if custom init has no var_kw, fields which are not declared in it cannot be passed through
-        allow_names = config_wrapper.populate_by_name
-        for field_name, field in fields.items():
-            # when alias is a str it should be used for signature generation
-            param_name = _field_name_for_signature(field_name, field)
-
-            if field_name in merged_params or param_name in merged_params:
-                continue
-
-            if not is_valid_identifier(param_name):
-                if allow_names:
-                    param_name = field_name
-                else:
-                    use_var_kw = True
-                    continue
-
-            kwargs = {} if field.is_required() else {'default': field.get_default(call_default_factory=False)}
-            merged_params[param_name] = Parameter(
-                param_name, Parameter.KEYWORD_ONLY, annotation=field.rebuild_annotation(), **kwargs
-            )
-
-    if config_wrapper.extra == 'allow':
-        use_var_kw = True
-
-    if var_kw and use_var_kw:
-        # Make sure the parameter for extra kwargs
-        # does not have the same name as a field
-        default_model_signature = [
-            ('self', Parameter.POSITIONAL_ONLY),
-            ('data', Parameter.VAR_KEYWORD),
-        ]
-        if [(p.name, p.kind) for p in present_params] == default_model_signature:
-            # if this is the standard model signature, use extra_data as the extra args name
-            var_kw_name = 'extra_data'
-        else:
-            # else start from var_kw
-            var_kw_name = var_kw.name
-
-        # generate a name that's definitely unique
-        while var_kw_name in fields:
-            var_kw_name += '_'
-        merged_params[var_kw_name] = var_kw.replace(name=var_kw_name)
-
-    return merged_params
-
-
-def generate_pydantic_signature(
-    init: Callable[..., None], fields: dict[str, FieldInfo], config_wrapper: ConfigWrapper, is_dataclass: bool = False
-) -> Signature:
-    """Generate signature for a pydantic BaseModel or dataclass.
-
-    Args:
-        init: The class init.
-        fields: The model fields.
-        config_wrapper: The config wrapper instance.
-        is_dataclass: Whether the model is a dataclass.
-
-    Returns:
-        The dataclass/BaseModel subclass signature.
-    """
-    merged_params = _generate_signature_parameters(init, fields, config_wrapper)
-
-    if is_dataclass:
-        merged_params = {k: _process_param_defaults(v) for k, v in merged_params.items()}
-
-    return Signature(parameters=list(merged_params.values()), return_annotation=None)
diff --git a/lib/pydantic/_internal/_std_types_schema.py b/lib/pydantic/_internal/_std_types_schema.py
deleted file mode 100644
index c8523bf4..00000000
--- a/lib/pydantic/_internal/_std_types_schema.py
+++ /dev/null
@@ -1,714 +0,0 @@
-"""Logic for generating pydantic-core schemas for standard library types.
-
-Import of this module is deferred since it contains imports of many standard library modules.
-"""
-from __future__ import annotations as _annotations
-
-import collections
-import collections.abc
-import dataclasses
-import decimal
-import inspect
-import os
-import typing
-from enum import Enum
-from functools import partial
-from ipaddress import IPv4Address, IPv4Interface, IPv4Network, IPv6Address, IPv6Interface, IPv6Network
-from typing import Any, Callable, Iterable, TypeVar
-
-import typing_extensions
-from pydantic_core import (
-    CoreSchema,
-    MultiHostUrl,
-    PydanticCustomError,
-    PydanticOmit,
-    Url,
-    core_schema,
-)
-from typing_extensions import get_args, get_origin
-
-from pydantic.errors import PydanticSchemaGenerationError
-from pydantic.fields import FieldInfo
-from pydantic.types import Strict
-
-from ..config import ConfigDict
-from ..json_schema import JsonSchemaValue, update_json_schema
-from . import _known_annotated_metadata, _typing_extra, _validators
-from ._core_utils import get_type_ref
-from ._internal_dataclass import slots_true
-from ._schema_generation_shared import GetCoreSchemaHandler, GetJsonSchemaHandler
-
-if typing.TYPE_CHECKING:
-    from ._generate_schema import GenerateSchema
-
-    StdSchemaFunction = Callable[[GenerateSchema, type[Any]], core_schema.CoreSchema]
-
-
-@dataclasses.dataclass(**slots_true)
-class SchemaTransformer:
-    get_core_schema: Callable[[Any, GetCoreSchemaHandler], CoreSchema]
-    get_json_schema: Callable[[CoreSchema, GetJsonSchemaHandler], JsonSchemaValue]
-
-    def __get_pydantic_core_schema__(self, source_type: Any, handler: GetCoreSchemaHandler) -> CoreSchema:
-        return self.get_core_schema(source_type, handler)
-
-    def __get_pydantic_json_schema__(self, schema: CoreSchema, handler: GetJsonSchemaHandler) -> JsonSchemaValue:
-        return self.get_json_schema(schema, handler)
-
-
-def get_enum_core_schema(enum_type: type[Enum], config: ConfigDict) -> CoreSchema:
-    cases: list[Any] = list(enum_type.__members__.values())
-
-    enum_ref = get_type_ref(enum_type)
-    description = None if not enum_type.__doc__ else inspect.cleandoc(enum_type.__doc__)
-    if description == 'An enumeration.':  # This is the default value provided by enum.EnumMeta.__new__; don't use it
-        description = None
-    updates = {'title': enum_type.__name__, 'description': description}
-    updates = {k: v for k, v in updates.items() if v is not None}
-
-    def get_json_schema(_, handler: GetJsonSchemaHandler) -> JsonSchemaValue:
-        json_schema = handler(core_schema.literal_schema([x.value for x in cases], ref=enum_ref))
-        original_schema = handler.resolve_ref_schema(json_schema)
-        update_json_schema(original_schema, updates)
-        return json_schema
-
-    if not cases:
-        # Use an isinstance check for enums with no cases.
-        # The most important use case for this is creating TypeVar bounds for generics that should
-        # be restricted to enums. This is more consistent than it might seem at first, since you can only
-        # subclass enum.Enum (or subclasses of enum.Enum) if all parent classes have no cases.
-        # We use the get_json_schema function when an Enum subclass has been declared with no cases
-        # so that we can still generate a valid json schema.
-        return core_schema.is_instance_schema(enum_type, metadata={'pydantic_js_functions': [get_json_schema]})
-
-    use_enum_values = config.get('use_enum_values', False)
-
-    if len(cases) == 1:
-        expected = repr(cases[0].value)
-    else:
-        expected = ', '.join([repr(case.value) for case in cases[:-1]]) + f' or {cases[-1].value!r}'
-
-    def to_enum(__input_value: Any) -> Enum:
-        try:
-            enum_field = enum_type(__input_value)
-            if use_enum_values:
-                return enum_field.value
-            return enum_field
-        except ValueError:
-            # The type: ignore on the next line is to ignore the requirement of LiteralString
-            raise PydanticCustomError('enum', f'Input should be {expected}', {'expected': expected})  # type: ignore
-
-    strict_python_schema = core_schema.is_instance_schema(enum_type)
-    if use_enum_values:
-        strict_python_schema = core_schema.chain_schema(
-            [strict_python_schema, core_schema.no_info_plain_validator_function(lambda x: x.value)]
-        )
-
-    to_enum_validator = core_schema.no_info_plain_validator_function(to_enum)
-    if issubclass(enum_type, int):
-        # this handles `IntEnum`, and also `Foobar(int, Enum)`
-        updates['type'] = 'integer'
-        lax = core_schema.chain_schema([core_schema.int_schema(), to_enum_validator])
-        # Disallow float from JSON due to strict mode
-        strict = core_schema.json_or_python_schema(
-            json_schema=core_schema.no_info_after_validator_function(to_enum, core_schema.int_schema()),
-            python_schema=strict_python_schema,
-        )
-    elif issubclass(enum_type, str):
-        # this handles `StrEnum` (3.11 only), and also `Foobar(str, Enum)`
-        updates['type'] = 'string'
-        lax = core_schema.chain_schema([core_schema.str_schema(), to_enum_validator])
-        strict = core_schema.json_or_python_schema(
-            json_schema=core_schema.no_info_after_validator_function(to_enum, core_schema.str_schema()),
-            python_schema=strict_python_schema,
-        )
-    elif issubclass(enum_type, float):
-        updates['type'] = 'numeric'
-        lax = core_schema.chain_schema([core_schema.float_schema(), to_enum_validator])
-        strict = core_schema.json_or_python_schema(
-            json_schema=core_schema.no_info_after_validator_function(to_enum, core_schema.float_schema()),
-            python_schema=strict_python_schema,
-        )
-    else:
-        lax = to_enum_validator
-        strict = core_schema.json_or_python_schema(json_schema=to_enum_validator, python_schema=strict_python_schema)
-    return core_schema.lax_or_strict_schema(
-        lax_schema=lax, strict_schema=strict, ref=enum_ref, metadata={'pydantic_js_functions': [get_json_schema]}
-    )
-
-
-@dataclasses.dataclass(**slots_true)
-class InnerSchemaValidator:
-    """Use a fixed CoreSchema, avoiding interference from outward annotations."""
-
-    core_schema: CoreSchema
-    js_schema: JsonSchemaValue | None = None
-    js_core_schema: CoreSchema | None = None
-    js_schema_update: JsonSchemaValue | None = None
-
-    def __get_pydantic_json_schema__(self, _schema: CoreSchema, handler: GetJsonSchemaHandler) -> JsonSchemaValue:
-        if self.js_schema is not None:
-            return self.js_schema
-        js_schema = handler(self.js_core_schema or self.core_schema)
-        if self.js_schema_update is not None:
-            js_schema.update(self.js_schema_update)
-        return js_schema
-
-    def __get_pydantic_core_schema__(self, _source_type: Any, _handler: GetCoreSchemaHandler) -> CoreSchema:
-        return self.core_schema
-
-
-def decimal_prepare_pydantic_annotations(
-    source: Any, annotations: Iterable[Any], config: ConfigDict
-) -> tuple[Any, list[Any]] | None:
-    if source is not decimal.Decimal:
-        return None
-
-    metadata, remaining_annotations = _known_annotated_metadata.collect_known_metadata(annotations)
-
-    config_allow_inf_nan = config.get('allow_inf_nan')
-    if config_allow_inf_nan is not None:
-        metadata.setdefault('allow_inf_nan', config_allow_inf_nan)
-
-    _known_annotated_metadata.check_metadata(
-        metadata, {*_known_annotated_metadata.FLOAT_CONSTRAINTS, 'max_digits', 'decimal_places'}, decimal.Decimal
-    )
-    return source, [InnerSchemaValidator(core_schema.decimal_schema(**metadata)), *remaining_annotations]
-
-
-def datetime_prepare_pydantic_annotations(
-    source_type: Any, annotations: Iterable[Any], _config: ConfigDict
-) -> tuple[Any, list[Any]] | None:
-    import datetime
-
-    metadata, remaining_annotations = _known_annotated_metadata.collect_known_metadata(annotations)
-    if source_type is datetime.date:
-        sv = InnerSchemaValidator(core_schema.date_schema(**metadata))
-    elif source_type is datetime.datetime:
-        sv = InnerSchemaValidator(core_schema.datetime_schema(**metadata))
-    elif source_type is datetime.time:
-        sv = InnerSchemaValidator(core_schema.time_schema(**metadata))
-    elif source_type is datetime.timedelta:
-        sv = InnerSchemaValidator(core_schema.timedelta_schema(**metadata))
-    else:
-        return None
-    # check now that we know the source type is correct
-    _known_annotated_metadata.check_metadata(metadata, _known_annotated_metadata.DATE_TIME_CONSTRAINTS, source_type)
-    return (source_type, [sv, *remaining_annotations])
-
-
-def uuid_prepare_pydantic_annotations(
-    source_type: Any, annotations: Iterable[Any], _config: ConfigDict
-) -> tuple[Any, list[Any]] | None:
-    # UUIDs have no constraints - they are fixed length, constructing a UUID instance checks the length
-
-    from uuid import UUID
-
-    if source_type is not UUID:
-        return None
-
-    return (source_type, [InnerSchemaValidator(core_schema.uuid_schema()), *annotations])
-
-
-def path_schema_prepare_pydantic_annotations(
-    source_type: Any, annotations: Iterable[Any], _config: ConfigDict
-) -> tuple[Any, list[Any]] | None:
-    import pathlib
-
-    if source_type not in {
-        os.PathLike,
-        pathlib.Path,
-        pathlib.PurePath,
-        pathlib.PosixPath,
-        pathlib.PurePosixPath,
-        pathlib.PureWindowsPath,
-    }:
-        return None
-
-    metadata, remaining_annotations = _known_annotated_metadata.collect_known_metadata(annotations)
-    _known_annotated_metadata.check_metadata(metadata, _known_annotated_metadata.STR_CONSTRAINTS, source_type)
-
-    construct_path = pathlib.PurePath if source_type is os.PathLike else source_type
-
-    def path_validator(input_value: str) -> os.PathLike[Any]:
-        try:
-            return construct_path(input_value)
-        except TypeError as e:
-            raise PydanticCustomError('path_type', 'Input is not a valid path') from e
-
-    constrained_str_schema = core_schema.str_schema(**metadata)
-
-    instance_schema = core_schema.json_or_python_schema(
-        json_schema=core_schema.no_info_after_validator_function(path_validator, constrained_str_schema),
-        python_schema=core_schema.is_instance_schema(source_type),
-    )
-
-    strict: bool | None = None
-    for annotation in annotations:
-        if isinstance(annotation, Strict):
-            strict = annotation.strict
-
-    schema = core_schema.lax_or_strict_schema(
-        lax_schema=core_schema.union_schema(
-            [
-                instance_schema,
-                core_schema.no_info_after_validator_function(path_validator, constrained_str_schema),
-            ],
-            custom_error_type='path_type',
-            custom_error_message='Input is not a valid path',
-            strict=True,
-        ),
-        strict_schema=instance_schema,
-        serialization=core_schema.to_string_ser_schema(),
-        strict=strict,
-    )
-
-    return (
-        source_type,
-        [
-            InnerSchemaValidator(schema, js_core_schema=constrained_str_schema, js_schema_update={'format': 'path'}),
-            *remaining_annotations,
-        ],
-    )
-
-
-def dequeue_validator(
-    input_value: Any, handler: core_schema.ValidatorFunctionWrapHandler, maxlen: None | int
-) -> collections.deque[Any]:
-    if isinstance(input_value, collections.deque):
-        maxlens = [v for v in (input_value.maxlen, maxlen) if v is not None]
-        if maxlens:
-            maxlen = min(maxlens)
-        return collections.deque(handler(input_value), maxlen=maxlen)
-    else:
-        return collections.deque(handler(input_value), maxlen=maxlen)
-
-
-@dataclasses.dataclass(**slots_true)
-class SequenceValidator:
-    mapped_origin: type[Any]
-    item_source_type: type[Any]
-    min_length: int | None = None
-    max_length: int | None = None
-    strict: bool = False
-
-    def serialize_sequence_via_list(
-        self, v: Any, handler: core_schema.SerializerFunctionWrapHandler, info: core_schema.SerializationInfo
-    ) -> Any:
-        items: list[Any] = []
-        for index, item in enumerate(v):
-            try:
-                v = handler(item, index)
-            except PydanticOmit:
-                pass
-            else:
-                items.append(v)
-
-        if info.mode_is_json():
-            return items
-        else:
-            return self.mapped_origin(items)
-
-    def __get_pydantic_core_schema__(self, source_type: Any, handler: GetCoreSchemaHandler) -> CoreSchema:
-        if self.item_source_type is Any:
-            items_schema = None
-        else:
-            items_schema = handler.generate_schema(self.item_source_type)
-
-        metadata = {'min_length': self.min_length, 'max_length': self.max_length, 'strict': self.strict}
-
-        if self.mapped_origin in (list, set, frozenset):
-            if self.mapped_origin is list:
-                constrained_schema = core_schema.list_schema(items_schema, **metadata)
-            elif self.mapped_origin is set:
-                constrained_schema = core_schema.set_schema(items_schema, **metadata)
-            else:
-                assert self.mapped_origin is frozenset  # safety check in case we forget to add a case
-                constrained_schema = core_schema.frozenset_schema(items_schema, **metadata)
-
-            schema = constrained_schema
-        else:
-            # safety check in case we forget to add a case
-            assert self.mapped_origin in (collections.deque, collections.Counter)
-
-            if self.mapped_origin is collections.deque:
-                # if we have a MaxLen annotation might as well set that as the default maxlen on the deque
-                # this lets us re-use existing metadata annotations to let users set the maxlen on a dequeue
-                # that e.g. comes from JSON
-                coerce_instance_wrap = partial(
-                    core_schema.no_info_wrap_validator_function,
-                    partial(dequeue_validator, maxlen=metadata.get('max_length', None)),
-                )
-            else:
-                coerce_instance_wrap = partial(core_schema.no_info_after_validator_function, self.mapped_origin)
-
-            constrained_schema = core_schema.list_schema(items_schema, **metadata)
-
-            check_instance = core_schema.json_or_python_schema(
-                json_schema=core_schema.list_schema(),
-                python_schema=core_schema.is_instance_schema(self.mapped_origin),
-            )
-
-            serialization = core_schema.wrap_serializer_function_ser_schema(
-                self.serialize_sequence_via_list, schema=items_schema or core_schema.any_schema(), info_arg=True
-            )
-
-            strict = core_schema.chain_schema([check_instance, coerce_instance_wrap(constrained_schema)])
-
-            if metadata.get('strict', False):
-                schema = strict
-            else:
-                lax = coerce_instance_wrap(constrained_schema)
-                schema = core_schema.lax_or_strict_schema(lax_schema=lax, strict_schema=strict)
-            schema['serialization'] = serialization
-
-        return schema
-
-
-SEQUENCE_ORIGIN_MAP: dict[Any, Any] = {
-    typing.Deque: collections.deque,
-    collections.deque: collections.deque,
-    list: list,
-    typing.List: list,
-    set: set,
-    typing.AbstractSet: set,
-    typing.Set: set,
-    frozenset: frozenset,
-    typing.FrozenSet: frozenset,
-    typing.Sequence: list,
-    typing.MutableSequence: list,
-    typing.MutableSet: set,
-    # this doesn't handle subclasses of these
-    # parametrized typing.Set creates one of these
-    collections.abc.MutableSet: set,
-    collections.abc.Set: frozenset,
-}
-
-
-def identity(s: CoreSchema) -> CoreSchema:
-    return s
-
-
-def sequence_like_prepare_pydantic_annotations(
-    source_type: Any, annotations: Iterable[Any], _config: ConfigDict
-) -> tuple[Any, list[Any]] | None:
-    origin: Any = get_origin(source_type)
-
-    mapped_origin = SEQUENCE_ORIGIN_MAP.get(origin, None) if origin else SEQUENCE_ORIGIN_MAP.get(source_type, None)
-    if mapped_origin is None:
-        return None
-
-    args = get_args(source_type)
-
-    if not args:
-        args = (Any,)
-    elif len(args) != 1:
-        raise ValueError('Expected sequence to have exactly 1 generic parameter')
-
-    item_source_type = args[0]
-
-    metadata, remaining_annotations = _known_annotated_metadata.collect_known_metadata(annotations)
-    _known_annotated_metadata.check_metadata(metadata, _known_annotated_metadata.SEQUENCE_CONSTRAINTS, source_type)
-
-    return (source_type, [SequenceValidator(mapped_origin, item_source_type, **metadata), *remaining_annotations])
-
-
-MAPPING_ORIGIN_MAP: dict[Any, Any] = {
-    typing.DefaultDict: collections.defaultdict,
-    collections.defaultdict: collections.defaultdict,
-    collections.OrderedDict: collections.OrderedDict,
-    typing_extensions.OrderedDict: collections.OrderedDict,
-    dict: dict,
-    typing.Dict: dict,
-    collections.Counter: collections.Counter,
-    typing.Counter: collections.Counter,
-    # this doesn't handle subclasses of these
-    typing.Mapping: dict,
-    typing.MutableMapping: dict,
-    # parametrized typing.{Mutable}Mapping creates one of these
-    collections.abc.MutableMapping: dict,
-    collections.abc.Mapping: dict,
-}
-
-
-def defaultdict_validator(
-    input_value: Any, handler: core_schema.ValidatorFunctionWrapHandler, default_default_factory: Callable[[], Any]
-) -> collections.defaultdict[Any, Any]:
-    if isinstance(input_value, collections.defaultdict):
-        default_factory = input_value.default_factory
-        return collections.defaultdict(default_factory, handler(input_value))
-    else:
-        return collections.defaultdict(default_default_factory, handler(input_value))
-
-
-def get_defaultdict_default_default_factory(values_source_type: Any) -> Callable[[], Any]:
-    def infer_default() -> Callable[[], Any]:
-        allowed_default_types: dict[Any, Any] = {
-            typing.Tuple: tuple,
-            tuple: tuple,
-            collections.abc.Sequence: tuple,
-            collections.abc.MutableSequence: list,
-            typing.List: list,
-            list: list,
-            typing.Sequence: list,
-            typing.Set: set,
-            set: set,
-            typing.MutableSet: set,
-            collections.abc.MutableSet: set,
-            collections.abc.Set: frozenset,
-            typing.MutableMapping: dict,
-            typing.Mapping: dict,
-            collections.abc.Mapping: dict,
-            collections.abc.MutableMapping: dict,
-            float: float,
-            int: int,
-            str: str,
-            bool: bool,
-        }
-        values_type_origin = get_origin(values_source_type) or values_source_type
-        instructions = 'set using `DefaultDict[..., Annotated[..., Field(default_factory=...)]]`'
-        if isinstance(values_type_origin, TypeVar):
-
-            def type_var_default_factory() -> None:
-                raise RuntimeError(
-                    'Generic defaultdict cannot be used without a concrete value type or an'
-                    ' explicit default factory, ' + instructions
-                )
-
-            return type_var_default_factory
-        elif values_type_origin not in allowed_default_types:
-            # a somewhat subjective set of types that have reasonable default values
-            allowed_msg = ', '.join([t.__name__ for t in set(allowed_default_types.values())])
-            raise PydanticSchemaGenerationError(
-                f'Unable to infer a default factory for keys of type {values_source_type}.'
-                f' Only {allowed_msg} are supported, other types require an explicit default factory'
-                ' ' + instructions
-            )
-        return allowed_default_types[values_type_origin]
-
-    # Assume Annotated[..., Field(...)]
-    if _typing_extra.is_annotated(values_source_type):
-        field_info = next((v for v in get_args(values_source_type) if isinstance(v, FieldInfo)), None)
-    else:
-        field_info = None
-    if field_info and field_info.default_factory:
-        default_default_factory = field_info.default_factory
-    else:
-        default_default_factory = infer_default()
-    return default_default_factory
-
-
-@dataclasses.dataclass(**slots_true)
-class MappingValidator:
-    mapped_origin: type[Any]
-    keys_source_type: type[Any]
-    values_source_type: type[Any]
-    min_length: int | None = None
-    max_length: int | None = None
-    strict: bool = False
-
-    def serialize_mapping_via_dict(self, v: Any, handler: core_schema.SerializerFunctionWrapHandler) -> Any:
-        return handler(v)
-
-    def __get_pydantic_core_schema__(self, source_type: Any, handler: GetCoreSchemaHandler) -> CoreSchema:
-        if self.keys_source_type is Any:
-            keys_schema = None
-        else:
-            keys_schema = handler.generate_schema(self.keys_source_type)
-        if self.values_source_type is Any:
-            values_schema = None
-        else:
-            values_schema = handler.generate_schema(self.values_source_type)
-
-        metadata = {'min_length': self.min_length, 'max_length': self.max_length, 'strict': self.strict}
-
-        if self.mapped_origin is dict:
-            schema = core_schema.dict_schema(keys_schema, values_schema, **metadata)
-        else:
-            constrained_schema = core_schema.dict_schema(keys_schema, values_schema, **metadata)
-            check_instance = core_schema.json_or_python_schema(
-                json_schema=core_schema.dict_schema(),
-                python_schema=core_schema.is_instance_schema(self.mapped_origin),
-            )
-
-            if self.mapped_origin is collections.defaultdict:
-                default_default_factory = get_defaultdict_default_default_factory(self.values_source_type)
-                coerce_instance_wrap = partial(
-                    core_schema.no_info_wrap_validator_function,
-                    partial(defaultdict_validator, default_default_factory=default_default_factory),
-                )
-            else:
-                coerce_instance_wrap = partial(core_schema.no_info_after_validator_function, self.mapped_origin)
-
-            serialization = core_schema.wrap_serializer_function_ser_schema(
-                self.serialize_mapping_via_dict,
-                schema=core_schema.dict_schema(
-                    keys_schema or core_schema.any_schema(), values_schema or core_schema.any_schema()
-                ),
-                info_arg=False,
-            )
-
-            strict = core_schema.chain_schema([check_instance, coerce_instance_wrap(constrained_schema)])
-
-            if metadata.get('strict', False):
-                schema = strict
-            else:
-                lax = coerce_instance_wrap(constrained_schema)
-                schema = core_schema.lax_or_strict_schema(lax_schema=lax, strict_schema=strict)
-                schema['serialization'] = serialization
-
-        return schema
-
-
-def mapping_like_prepare_pydantic_annotations(
-    source_type: Any, annotations: Iterable[Any], _config: ConfigDict
-) -> tuple[Any, list[Any]] | None:
-    origin: Any = get_origin(source_type)
-
-    mapped_origin = MAPPING_ORIGIN_MAP.get(origin, None) if origin else MAPPING_ORIGIN_MAP.get(source_type, None)
-    if mapped_origin is None:
-        return None
-
-    args = get_args(source_type)
-
-    if not args:
-        args = (Any, Any)
-    elif mapped_origin is collections.Counter:
-        # a single generic
-        if len(args) != 1:
-            raise ValueError('Expected Counter to have exactly 1 generic parameter')
-        args = (args[0], int)  # keys are always an int
-    elif len(args) != 2:
-        raise ValueError('Expected mapping to have exactly 2 generic parameters')
-
-    keys_source_type, values_source_type = args
-
-    metadata, remaining_annotations = _known_annotated_metadata.collect_known_metadata(annotations)
-    _known_annotated_metadata.check_metadata(metadata, _known_annotated_metadata.SEQUENCE_CONSTRAINTS, source_type)
-
-    return (
-        source_type,
-        [
-            MappingValidator(mapped_origin, keys_source_type, values_source_type, **metadata),
-            *remaining_annotations,
-        ],
-    )
-
-
-def ip_prepare_pydantic_annotations(
-    source_type: Any, annotations: Iterable[Any], _config: ConfigDict
-) -> tuple[Any, list[Any]] | None:
-    def make_strict_ip_schema(tp: type[Any]) -> CoreSchema:
-        return core_schema.json_or_python_schema(
-            json_schema=core_schema.no_info_after_validator_function(tp, core_schema.str_schema()),
-            python_schema=core_schema.is_instance_schema(tp),
-        )
-
-    if source_type is IPv4Address:
-        return source_type, [
-            SchemaTransformer(
-                lambda _1, _2: core_schema.lax_or_strict_schema(
-                    lax_schema=core_schema.no_info_plain_validator_function(_validators.ip_v4_address_validator),
-                    strict_schema=make_strict_ip_schema(IPv4Address),
-                    serialization=core_schema.to_string_ser_schema(),
-                ),
-                lambda _1, _2: {'type': 'string', 'format': 'ipv4'},
-            ),
-            *annotations,
-        ]
-    if source_type is IPv4Network:
-        return source_type, [
-            SchemaTransformer(
-                lambda _1, _2: core_schema.lax_or_strict_schema(
-                    lax_schema=core_schema.no_info_plain_validator_function(_validators.ip_v4_network_validator),
-                    strict_schema=make_strict_ip_schema(IPv4Network),
-                    serialization=core_schema.to_string_ser_schema(),
-                ),
-                lambda _1, _2: {'type': 'string', 'format': 'ipv4network'},
-            ),
-            *annotations,
-        ]
-    if source_type is IPv4Interface:
-        return source_type, [
-            SchemaTransformer(
-                lambda _1, _2: core_schema.lax_or_strict_schema(
-                    lax_schema=core_schema.no_info_plain_validator_function(_validators.ip_v4_interface_validator),
-                    strict_schema=make_strict_ip_schema(IPv4Interface),
-                    serialization=core_schema.to_string_ser_schema(),
-                ),
-                lambda _1, _2: {'type': 'string', 'format': 'ipv4interface'},
-            ),
-            *annotations,
-        ]
-
-    if source_type is IPv6Address:
-        return source_type, [
-            SchemaTransformer(
-                lambda _1, _2: core_schema.lax_or_strict_schema(
-                    lax_schema=core_schema.no_info_plain_validator_function(_validators.ip_v6_address_validator),
-                    strict_schema=make_strict_ip_schema(IPv6Address),
-                    serialization=core_schema.to_string_ser_schema(),
-                ),
-                lambda _1, _2: {'type': 'string', 'format': 'ipv6'},
-            ),
-            *annotations,
-        ]
-    if source_type is IPv6Network:
-        return source_type, [
-            SchemaTransformer(
-                lambda _1, _2: core_schema.lax_or_strict_schema(
-                    lax_schema=core_schema.no_info_plain_validator_function(_validators.ip_v6_network_validator),
-                    strict_schema=make_strict_ip_schema(IPv6Network),
-                    serialization=core_schema.to_string_ser_schema(),
-                ),
-                lambda _1, _2: {'type': 'string', 'format': 'ipv6network'},
-            ),
-            *annotations,
-        ]
-    if source_type is IPv6Interface:
-        return source_type, [
-            SchemaTransformer(
-                lambda _1, _2: core_schema.lax_or_strict_schema(
-                    lax_schema=core_schema.no_info_plain_validator_function(_validators.ip_v6_interface_validator),
-                    strict_schema=make_strict_ip_schema(IPv6Interface),
-                    serialization=core_schema.to_string_ser_schema(),
-                ),
-                lambda _1, _2: {'type': 'string', 'format': 'ipv6interface'},
-            ),
-            *annotations,
-        ]
-
-    return None
-
-
-def url_prepare_pydantic_annotations(
-    source_type: Any, annotations: Iterable[Any], _config: ConfigDict
-) -> tuple[Any, list[Any]] | None:
-    if source_type is Url:
-        return source_type, [
-            SchemaTransformer(
-                lambda _1, _2: core_schema.url_schema(),
-                lambda cs, handler: handler(cs),
-            ),
-            *annotations,
-        ]
-    if source_type is MultiHostUrl:
-        return source_type, [
-            SchemaTransformer(
-                lambda _1, _2: core_schema.multi_host_url_schema(),
-                lambda cs, handler: handler(cs),
-            ),
-            *annotations,
-        ]
-
-
-PREPARE_METHODS: tuple[Callable[[Any, Iterable[Any], ConfigDict], tuple[Any, list[Any]] | None], ...] = (
-    decimal_prepare_pydantic_annotations,
-    sequence_like_prepare_pydantic_annotations,
-    datetime_prepare_pydantic_annotations,
-    uuid_prepare_pydantic_annotations,
-    path_schema_prepare_pydantic_annotations,
-    mapping_like_prepare_pydantic_annotations,
-    ip_prepare_pydantic_annotations,
-    url_prepare_pydantic_annotations,
-)
diff --git a/lib/pydantic/_internal/_typing_extra.py b/lib/pydantic/_internal/_typing_extra.py
deleted file mode 100644
index 1d5d3b3f..00000000
--- a/lib/pydantic/_internal/_typing_extra.py
+++ /dev/null
@@ -1,469 +0,0 @@
-"""Logic for interacting with type annotations, mostly extensions, shims and hacks to wrap python's typing module."""
-from __future__ import annotations as _annotations
-
-import dataclasses
-import sys
-import types
-import typing
-from collections.abc import Callable
-from functools import partial
-from types import GetSetDescriptorType
-from typing import TYPE_CHECKING, Any, Final
-
-from typing_extensions import Annotated, Literal, TypeAliasType, TypeGuard, get_args, get_origin
-
-if TYPE_CHECKING:
-    from ._dataclasses import StandardDataclass
-
-try:
-    from typing import _TypingBase  # type: ignore[attr-defined]
-except ImportError:
-    from typing import _Final as _TypingBase  # type: ignore[attr-defined]
-
-typing_base = _TypingBase
-
-
-if sys.version_info < (3, 9):
-    # python < 3.9 does not have GenericAlias (list[int], tuple[str, ...] and so on)
-    TypingGenericAlias = ()
-else:
-    from typing import GenericAlias as TypingGenericAlias  # type: ignore
-
-
-if sys.version_info < (3, 11):
-    from typing_extensions import NotRequired, Required
-else:
-    from typing import NotRequired, Required  # noqa: F401
-
-
-if sys.version_info < (3, 10):
-
-    def origin_is_union(tp: type[Any] | None) -> bool:
-        return tp is typing.Union
-
-    WithArgsTypes = (TypingGenericAlias,)
-
-else:
-
-    def origin_is_union(tp: type[Any] | None) -> bool:
-        return tp is typing.Union or tp is types.UnionType
-
-    WithArgsTypes = typing._GenericAlias, types.GenericAlias, types.UnionType  # type: ignore[attr-defined]
-
-
-if sys.version_info < (3, 10):
-    NoneType = type(None)
-    EllipsisType = type(Ellipsis)
-else:
-    from types import NoneType as NoneType
-
-
-LITERAL_TYPES: set[Any] = {Literal}
-if hasattr(typing, 'Literal'):
-    LITERAL_TYPES.add(typing.Literal)  # type: ignore
-
-NONE_TYPES: tuple[Any, ...] = (None, NoneType, *(tp[None] for tp in LITERAL_TYPES))
-
-
-TypeVarType = Any  # since mypy doesn't allow the use of TypeVar as a type
-
-
-def is_none_type(type_: Any) -> bool:
-    return type_ in NONE_TYPES
-
-
-def is_callable_type(type_: type[Any]) -> bool:
-    return type_ is Callable or get_origin(type_) is Callable
-
-
-def is_literal_type(type_: type[Any]) -> bool:
-    return Literal is not None and get_origin(type_) in LITERAL_TYPES
-
-
-def literal_values(type_: type[Any]) -> tuple[Any, ...]:
-    return get_args(type_)
-
-
-def all_literal_values(type_: type[Any]) -> list[Any]:
-    """This method is used to retrieve all Literal values as
-    Literal can be used recursively (see https://www.python.org/dev/peps/pep-0586)
-    e.g. `Literal[Literal[Literal[1, 2, 3], "foo"], 5, None]`.
-    """
-    if not is_literal_type(type_):
-        return [type_]
-
-    values = literal_values(type_)
-    return list(x for value in values for x in all_literal_values(value))
-
-
-def is_annotated(ann_type: Any) -> bool:
-    from ._utils import lenient_issubclass
-
-    origin = get_origin(ann_type)
-    return origin is not None and lenient_issubclass(origin, Annotated)
-
-
-def is_namedtuple(type_: type[Any]) -> bool:
-    """Check if a given class is a named tuple.
-    It can be either a `typing.NamedTuple` or `collections.namedtuple`.
-    """
-    from ._utils import lenient_issubclass
-
-    return lenient_issubclass(type_, tuple) and hasattr(type_, '_fields')
-
-
-test_new_type = typing.NewType('test_new_type', str)
-
-
-def is_new_type(type_: type[Any]) -> bool:
-    """Check whether type_ was created using typing.NewType.
-
-    Can't use isinstance because it fails <3.10.
-    """
-    return isinstance(type_, test_new_type.__class__) and hasattr(type_, '__supertype__')  # type: ignore[arg-type]
-
-
-def _check_classvar(v: type[Any] | None) -> bool:
-    if v is None:
-        return False
-
-    return v.__class__ == typing.ClassVar.__class__ and getattr(v, '_name', None) == 'ClassVar'
-
-
-def is_classvar(ann_type: type[Any]) -> bool:
-    if _check_classvar(ann_type) or _check_classvar(get_origin(ann_type)):
-        return True
-
-    # this is an ugly workaround for class vars that contain forward references and are therefore themselves
-    # forward references, see #3679
-    if ann_type.__class__ == typing.ForwardRef and ann_type.__forward_arg__.startswith('ClassVar['):  # type: ignore
-        return True
-
-    return False
-
-
-def _check_finalvar(v: type[Any] | None) -> bool:
-    """Check if a given type is a `typing.Final` type."""
-    if v is None:
-        return False
-
-    return v.__class__ == Final.__class__ and (sys.version_info < (3, 8) or getattr(v, '_name', None) == 'Final')
-
-
-def is_finalvar(ann_type: Any) -> bool:
-    return _check_finalvar(ann_type) or _check_finalvar(get_origin(ann_type))
-
-
-def parent_frame_namespace(*, parent_depth: int = 2) -> dict[str, Any] | None:
-    """We allow use of items in parent namespace to get around the issue with `get_type_hints` only looking in the
-    global module namespace. See https://github.com/pydantic/pydantic/issues/2678#issuecomment-1008139014 -> Scope
-    and suggestion at the end of the next comment by @gvanrossum.
-
-    WARNING 1: it matters exactly where this is called. By default, this function will build a namespace from the
-    parent of where it is called.
-
-    WARNING 2: this only looks in the parent namespace, not other parents since (AFAIK) there's no way to collect a
-    dict of exactly what's in scope. Using `f_back` would work sometimes but would be very wrong and confusing in many
-    other cases. See https://discuss.python.org/t/is-there-a-way-to-access-parent-nested-namespaces/20659.
-    """
-    frame = sys._getframe(parent_depth)
-    # if f_back is None, it's the global module namespace and we don't need to include it here
-    if frame.f_back is None:
-        return None
-    else:
-        return frame.f_locals
-
-
-def add_module_globals(obj: Any, globalns: dict[str, Any] | None = None) -> dict[str, Any]:
-    module_name = getattr(obj, '__module__', None)
-    if module_name:
-        try:
-            module_globalns = sys.modules[module_name].__dict__
-        except KeyError:
-            # happens occasionally, see https://github.com/pydantic/pydantic/issues/2363
-            pass
-        else:
-            if globalns:
-                return {**module_globalns, **globalns}
-            else:
-                # copy module globals to make sure it can't be updated later
-                return module_globalns.copy()
-
-    return globalns or {}
-
-
-def get_cls_types_namespace(cls: type[Any], parent_namespace: dict[str, Any] | None = None) -> dict[str, Any]:
-    ns = add_module_globals(cls, parent_namespace)
-    ns[cls.__name__] = cls
-    return ns
-
-
-def get_cls_type_hints_lenient(obj: Any, globalns: dict[str, Any] | None = None) -> dict[str, Any]:
-    """Collect annotations from a class, including those from parent classes.
-
-    Unlike `typing.get_type_hints`, this function will not error if a forward reference is not resolvable.
-    """
-    hints = {}
-    for base in reversed(obj.__mro__):
-        ann = base.__dict__.get('__annotations__')
-        localns = dict(vars(base))
-        if ann is not None and ann is not GetSetDescriptorType:
-            for name, value in ann.items():
-                hints[name] = eval_type_lenient(value, globalns, localns)
-    return hints
-
-
-def eval_type_lenient(value: Any, globalns: dict[str, Any] | None = None, localns: dict[str, Any] | None = None) -> Any:
-    """Behaves like typing._eval_type, except it won't raise an error if a forward reference can't be resolved."""
-    if value is None:
-        value = NoneType
-    elif isinstance(value, str):
-        value = _make_forward_ref(value, is_argument=False, is_class=True)
-
-    try:
-        return eval_type_backport(value, globalns, localns)
-    except NameError:
-        # the point of this function is to be tolerant to this case
-        return value
-
-
-def eval_type_backport(
-    value: Any, globalns: dict[str, Any] | None = None, localns: dict[str, Any] | None = None
-) -> Any:
-    """Like `typing._eval_type`, but falls back to the `eval_type_backport` package if it's
-    installed to let older Python versions use newer typing features.
-    Specifically, this transforms `X | Y` into `typing.Union[X, Y]`
-    and `list[X]` into `typing.List[X]` etc. (for all the types made generic in PEP 585)
-    if the original syntax is not supported in the current Python version.
-    """
-    try:
-        return typing._eval_type(  # type: ignore
-            value, globalns, localns
-        )
-    except TypeError as e:
-        if not (isinstance(value, typing.ForwardRef) and is_backport_fixable_error(e)):
-            raise
-        try:
-            from eval_type_backport import eval_type_backport
-        except ImportError:
-            raise TypeError(
-                f'You have a type annotation {value.__forward_arg__!r} '
-                f'which makes use of newer typing features than are supported in your version of Python. '
-                f'To handle this error, you should either remove the use of new syntax '
-                f'or install the `eval_type_backport` package.'
-            ) from e
-
-        return eval_type_backport(value, globalns, localns, try_default=False)
-
-
-def is_backport_fixable_error(e: TypeError) -> bool:
-    msg = str(e)
-    return msg.startswith('unsupported operand type(s) for |: ') or "' object is not subscriptable" in msg
-
-
-def get_function_type_hints(
-    function: Callable[..., Any], *, include_keys: set[str] | None = None, types_namespace: dict[str, Any] | None = None
-) -> dict[str, Any]:
-    """Like `typing.get_type_hints`, but doesn't convert `X` to `Optional[X]` if the default value is `None`, also
-    copes with `partial`.
-    """
-    if isinstance(function, partial):
-        annotations = function.func.__annotations__
-    else:
-        annotations = function.__annotations__
-
-    globalns = add_module_globals(function)
-    type_hints = {}
-    for name, value in annotations.items():
-        if include_keys is not None and name not in include_keys:
-            continue
-        if value is None:
-            value = NoneType
-        elif isinstance(value, str):
-            value = _make_forward_ref(value)
-
-        type_hints[name] = eval_type_backport(value, globalns, types_namespace)
-
-    return type_hints
-
-
-if sys.version_info < (3, 9, 8) or (3, 10) <= sys.version_info < (3, 10, 1):
-
-    def _make_forward_ref(
-        arg: Any,
-        is_argument: bool = True,
-        *,
-        is_class: bool = False,
-    ) -> typing.ForwardRef:
-        """Wrapper for ForwardRef that accounts for the `is_class` argument missing in older versions.
-        The `module` argument is omitted as it breaks <3.9.8, =3.10.0 and isn't used in the calls below.
-
-        See https://github.com/python/cpython/pull/28560 for some background.
-        The backport happened on 3.9.8, see:
-        https://github.com/pydantic/pydantic/discussions/6244#discussioncomment-6275458,
-        and on 3.10.1 for the 3.10 branch, see:
-        https://github.com/pydantic/pydantic/issues/6912
-
-        Implemented as EAFP with memory.
-        """
-        return typing.ForwardRef(arg, is_argument)
-
-else:
-    _make_forward_ref = typing.ForwardRef
-
-
-if sys.version_info >= (3, 10):
-    get_type_hints = typing.get_type_hints
-
-else:
-    """
-    For older versions of python, we have a custom implementation of `get_type_hints` which is a close as possible to
-    the implementation in CPython 3.10.8.
-    """
-
-    @typing.no_type_check
-    def get_type_hints(  # noqa: C901
-        obj: Any,
-        globalns: dict[str, Any] | None = None,
-        localns: dict[str, Any] | None = None,
-        include_extras: bool = False,
-    ) -> dict[str, Any]:  # pragma: no cover
-        """Taken verbatim from python 3.10.8 unchanged, except:
-        * type annotations of the function definition above.
-        * prefixing `typing.` where appropriate
-        * Use `_make_forward_ref` instead of `typing.ForwardRef` to handle the `is_class` argument.
-
-        https://github.com/python/cpython/blob/aaaf5174241496afca7ce4d4584570190ff972fe/Lib/typing.py#L1773-L1875
-
-        DO NOT CHANGE THIS METHOD UNLESS ABSOLUTELY NECESSARY.
-        ======================================================
-
-        Return type hints for an object.
-
-        This is often the same as obj.__annotations__, but it handles
-        forward references encoded as string literals, adds Optional[t] if a
-        default value equal to None is set and recursively replaces all
-        'Annotated[T, ...]' with 'T' (unless 'include_extras=True').
-
-        The argument may be a module, class, method, or function. The annotations
-        are returned as a dictionary. For classes, annotations include also
-        inherited members.
-
-        TypeError is raised if the argument is not of a type that can contain
-        annotations, and an empty dictionary is returned if no annotations are
-        present.
-
-        BEWARE -- the behavior of globalns and localns is counterintuitive
-        (unless you are familiar with how eval() and exec() work).  The
-        search order is locals first, then globals.
-
-        - If no dict arguments are passed, an attempt is made to use the
-          globals from obj (or the respective module's globals for classes),
-          and these are also used as the locals.  If the object does not appear
-          to have globals, an empty dictionary is used.  For classes, the search
-          order is globals first then locals.
-
-        - If one dict argument is passed, it is used for both globals and
-          locals.
-
-        - If two dict arguments are passed, they specify globals and
-          locals, respectively.
-        """
-        if getattr(obj, '__no_type_check__', None):
-            return {}
-        # Classes require a special treatment.
-        if isinstance(obj, type):
-            hints = {}
-            for base in reversed(obj.__mro__):
-                if globalns is None:
-                    base_globals = getattr(sys.modules.get(base.__module__, None), '__dict__', {})
-                else:
-                    base_globals = globalns
-                ann = base.__dict__.get('__annotations__', {})
-                if isinstance(ann, types.GetSetDescriptorType):
-                    ann = {}
-                base_locals = dict(vars(base)) if localns is None else localns
-                if localns is None and globalns is None:
-                    # This is surprising, but required.  Before Python 3.10,
-                    # get_type_hints only evaluated the globalns of
-                    # a class.  To maintain backwards compatibility, we reverse
-                    # the globalns and localns order so that eval() looks into
-                    # *base_globals* first rather than *base_locals*.
-                    # This only affects ForwardRefs.
-                    base_globals, base_locals = base_locals, base_globals
-                for name, value in ann.items():
-                    if value is None:
-                        value = type(None)
-                    if isinstance(value, str):
-                        value = _make_forward_ref(value, is_argument=False, is_class=True)
-
-                    value = eval_type_backport(value, base_globals, base_locals)
-                    hints[name] = value
-            if not include_extras and hasattr(typing, '_strip_annotations'):
-                return {
-                    k: typing._strip_annotations(t)  # type: ignore
-                    for k, t in hints.items()
-                }
-            else:
-                return hints
-
-        if globalns is None:
-            if isinstance(obj, types.ModuleType):
-                globalns = obj.__dict__
-            else:
-                nsobj = obj
-                # Find globalns for the unwrapped object.
-                while hasattr(nsobj, '__wrapped__'):
-                    nsobj = nsobj.__wrapped__
-                globalns = getattr(nsobj, '__globals__', {})
-            if localns is None:
-                localns = globalns
-        elif localns is None:
-            localns = globalns
-        hints = getattr(obj, '__annotations__', None)
-        if hints is None:
-            # Return empty annotations for something that _could_ have them.
-            if isinstance(obj, typing._allowed_types):  # type: ignore
-                return {}
-            else:
-                raise TypeError(f'{obj!r} is not a module, class, method, ' 'or function.')
-        defaults = typing._get_defaults(obj)  # type: ignore
-        hints = dict(hints)
-        for name, value in hints.items():
-            if value is None:
-                value = type(None)
-            if isinstance(value, str):
-                # class-level forward refs were handled above, this must be either
-                # a module-level annotation or a function argument annotation
-
-                value = _make_forward_ref(
-                    value,
-                    is_argument=not isinstance(obj, types.ModuleType),
-                    is_class=False,
-                )
-            value = eval_type_backport(value, globalns, localns)
-            if name in defaults and defaults[name] is None:
-                value = typing.Optional[value]
-            hints[name] = value
-        return hints if include_extras else {k: typing._strip_annotations(t) for k, t in hints.items()}  # type: ignore
-
-
-def is_dataclass(_cls: type[Any]) -> TypeGuard[type[StandardDataclass]]:
-    # The dataclasses.is_dataclass function doesn't seem to provide TypeGuard functionality,
-    # so I created this convenience function
-    return dataclasses.is_dataclass(_cls)
-
-
-def origin_is_type_alias_type(origin: Any) -> TypeGuard[TypeAliasType]:
-    return isinstance(origin, TypeAliasType)
-
-
-if sys.version_info >= (3, 10):
-
-    def is_generic_alias(type_: type[Any]) -> bool:
-        return isinstance(type_, (types.GenericAlias, typing._GenericAlias))  # type: ignore[attr-defined]
-
-else:
-
-    def is_generic_alias(type_: type[Any]) -> bool:
-        return isinstance(type_, typing._GenericAlias)  # type: ignore
diff --git a/lib/pydantic/_internal/_utils.py b/lib/pydantic/_internal/_utils.py
deleted file mode 100644
index 31f5b2c5..00000000
--- a/lib/pydantic/_internal/_utils.py
+++ /dev/null
@@ -1,362 +0,0 @@
-"""Bucket of reusable internal utilities.
-
-This should be reduced as much as possible with functions only used in one place, moved to that place.
-"""
-from __future__ import annotations as _annotations
-
-import dataclasses
-import keyword
-import typing
-import weakref
-from collections import OrderedDict, defaultdict, deque
-from copy import deepcopy
-from itertools import zip_longest
-from types import BuiltinFunctionType, CodeType, FunctionType, GeneratorType, LambdaType, ModuleType
-from typing import Any, Mapping, TypeVar
-
-from typing_extensions import TypeAlias, TypeGuard
-
-from . import _repr, _typing_extra
-
-if typing.TYPE_CHECKING:
-    MappingIntStrAny: TypeAlias = 'typing.Mapping[int, Any] | typing.Mapping[str, Any]'
-    AbstractSetIntStr: TypeAlias = 'typing.AbstractSet[int] | typing.AbstractSet[str]'
-    from ..main import BaseModel
-
-
-# these are types that are returned unchanged by deepcopy
-IMMUTABLE_NON_COLLECTIONS_TYPES: set[type[Any]] = {
-    int,
-    float,
-    complex,
-    str,
-    bool,
-    bytes,
-    type,
-    _typing_extra.NoneType,
-    FunctionType,
-    BuiltinFunctionType,
-    LambdaType,
-    weakref.ref,
-    CodeType,
-    # note: including ModuleType will differ from behaviour of deepcopy by not producing error.
-    # It might be not a good idea in general, but considering that this function used only internally
-    # against default values of fields, this will allow to actually have a field with module as default value
-    ModuleType,
-    NotImplemented.__class__,
-    Ellipsis.__class__,
-}
-
-# these are types that if empty, might be copied with simple copy() instead of deepcopy()
-BUILTIN_COLLECTIONS: set[type[Any]] = {
-    list,
-    set,
-    tuple,
-    frozenset,
-    dict,
-    OrderedDict,
-    defaultdict,
-    deque,
-}
-
-
-def sequence_like(v: Any) -> bool:
-    return isinstance(v, (list, tuple, set, frozenset, GeneratorType, deque))
-
-
-def lenient_isinstance(o: Any, class_or_tuple: type[Any] | tuple[type[Any], ...] | None) -> bool:  # pragma: no cover
-    try:
-        return isinstance(o, class_or_tuple)  # type: ignore[arg-type]
-    except TypeError:
-        return False
-
-
-def lenient_issubclass(cls: Any, class_or_tuple: Any) -> bool:  # pragma: no cover
-    try:
-        return isinstance(cls, type) and issubclass(cls, class_or_tuple)
-    except TypeError:
-        if isinstance(cls, _typing_extra.WithArgsTypes):
-            return False
-        raise  # pragma: no cover
-
-
-def is_model_class(cls: Any) -> TypeGuard[type[BaseModel]]:
-    """Returns true if cls is a _proper_ subclass of BaseModel, and provides proper type-checking,
-    unlike raw calls to lenient_issubclass.
-    """
-    from ..main import BaseModel
-
-    return lenient_issubclass(cls, BaseModel) and cls is not BaseModel
-
-
-def is_valid_identifier(identifier: str) -> bool:
-    """Checks that a string is a valid identifier and not a Python keyword.
-    :param identifier: The identifier to test.
-    :return: True if the identifier is valid.
-    """
-    return identifier.isidentifier() and not keyword.iskeyword(identifier)
-
-
-KeyType = TypeVar('KeyType')
-
-
-def deep_update(mapping: dict[KeyType, Any], *updating_mappings: dict[KeyType, Any]) -> dict[KeyType, Any]:
-    updated_mapping = mapping.copy()
-    for updating_mapping in updating_mappings:
-        for k, v in updating_mapping.items():
-            if k in updated_mapping and isinstance(updated_mapping[k], dict) and isinstance(v, dict):
-                updated_mapping[k] = deep_update(updated_mapping[k], v)
-            else:
-                updated_mapping[k] = v
-    return updated_mapping
-
-
-def update_not_none(mapping: dict[Any, Any], **update: Any) -> None:
-    mapping.update({k: v for k, v in update.items() if v is not None})
-
-
-T = TypeVar('T')
-
-
-def unique_list(
-    input_list: list[T] | tuple[T, ...],
-    *,
-    name_factory: typing.Callable[[T], str] = str,
-) -> list[T]:
-    """Make a list unique while maintaining order.
-    We update the list if another one with the same name is set
-    (e.g. model validator overridden in subclass).
-    """
-    result: list[T] = []
-    result_names: list[str] = []
-    for v in input_list:
-        v_name = name_factory(v)
-        if v_name not in result_names:
-            result_names.append(v_name)
-            result.append(v)
-        else:
-            result[result_names.index(v_name)] = v
-
-    return result
-
-
-class ValueItems(_repr.Representation):
-    """Class for more convenient calculation of excluded or included fields on values."""
-
-    __slots__ = ('_items', '_type')
-
-    def __init__(self, value: Any, items: AbstractSetIntStr | MappingIntStrAny) -> None:
-        items = self._coerce_items(items)
-
-        if isinstance(value, (list, tuple)):
-            items = self._normalize_indexes(items, len(value))  # type: ignore
-
-        self._items: MappingIntStrAny = items  # type: ignore
-
-    def is_excluded(self, item: Any) -> bool:
-        """Check if item is fully excluded.
-
-        :param item: key or index of a value
-        """
-        return self.is_true(self._items.get(item))
-
-    def is_included(self, item: Any) -> bool:
-        """Check if value is contained in self._items.
-
-        :param item: key or index of value
-        """
-        return item in self._items
-
-    def for_element(self, e: int | str) -> AbstractSetIntStr | MappingIntStrAny | None:
-        """:param e: key or index of element on value
-        :return: raw values for element if self._items is dict and contain needed element
-        """
-        item = self._items.get(e)  # type: ignore
-        return item if not self.is_true(item) else None
-
-    def _normalize_indexes(self, items: MappingIntStrAny, v_length: int) -> dict[int | str, Any]:
-        """:param items: dict or set of indexes which will be normalized
-        :param v_length: length of sequence indexes of which will be
-
-        >>> self._normalize_indexes({0: True, -2: True, -1: True}, 4)
-        {0: True, 2: True, 3: True}
-        >>> self._normalize_indexes({'__all__': True}, 4)
-        {0: True, 1: True, 2: True, 3: True}
-        """
-        normalized_items: dict[int | str, Any] = {}
-        all_items = None
-        for i, v in items.items():
-            if not (isinstance(v, typing.Mapping) or isinstance(v, typing.AbstractSet) or self.is_true(v)):
-                raise TypeError(f'Unexpected type of exclude value for index "{i}" {v.__class__}')
-            if i == '__all__':
-                all_items = self._coerce_value(v)
-                continue
-            if not isinstance(i, int):
-                raise TypeError(
-                    'Excluding fields from a sequence of sub-models or dicts must be performed index-wise: '
-                    'expected integer keys or keyword "__all__"'
-                )
-            normalized_i = v_length + i if i < 0 else i
-            normalized_items[normalized_i] = self.merge(v, normalized_items.get(normalized_i))
-
-        if not all_items:
-            return normalized_items
-        if self.is_true(all_items):
-            for i in range(v_length):
-                normalized_items.setdefault(i, ...)
-            return normalized_items
-        for i in range(v_length):
-            normalized_item = normalized_items.setdefault(i, {})
-            if not self.is_true(normalized_item):
-                normalized_items[i] = self.merge(all_items, normalized_item)
-        return normalized_items
-
-    @classmethod
-    def merge(cls, base: Any, override: Any, intersect: bool = False) -> Any:
-        """Merge a `base` item with an `override` item.
-
-        Both `base` and `override` are converted to dictionaries if possible.
-        Sets are converted to dictionaries with the sets entries as keys and
-        Ellipsis as values.
-
-        Each key-value pair existing in `base` is merged with `override`,
-        while the rest of the key-value pairs are updated recursively with this function.
-
-        Merging takes place based on the "union" of keys if `intersect` is
-        set to `False` (default) and on the intersection of keys if
-        `intersect` is set to `True`.
-        """
-        override = cls._coerce_value(override)
-        base = cls._coerce_value(base)
-        if override is None:
-            return base
-        if cls.is_true(base) or base is None:
-            return override
-        if cls.is_true(override):
-            return base if intersect else override
-
-        # intersection or union of keys while preserving ordering:
-        if intersect:
-            merge_keys = [k for k in base if k in override] + [k for k in override if k in base]
-        else:
-            merge_keys = list(base) + [k for k in override if k not in base]
-
-        merged: dict[int | str, Any] = {}
-        for k in merge_keys:
-            merged_item = cls.merge(base.get(k), override.get(k), intersect=intersect)
-            if merged_item is not None:
-                merged[k] = merged_item
-
-        return merged
-
-    @staticmethod
-    def _coerce_items(items: AbstractSetIntStr | MappingIntStrAny) -> MappingIntStrAny:
-        if isinstance(items, typing.Mapping):
-            pass
-        elif isinstance(items, typing.AbstractSet):
-            items = dict.fromkeys(items, ...)  # type: ignore
-        else:
-            class_name = getattr(items, '__class__', '???')
-            raise TypeError(f'Unexpected type of exclude value {class_name}')
-        return items  # type: ignore
-
-    @classmethod
-    def _coerce_value(cls, value: Any) -> Any:
-        if value is None or cls.is_true(value):
-            return value
-        return cls._coerce_items(value)
-
-    @staticmethod
-    def is_true(v: Any) -> bool:
-        return v is True or v is ...
-
-    def __repr_args__(self) -> _repr.ReprArgs:
-        return [(None, self._items)]
-
-
-if typing.TYPE_CHECKING:
-
-    def ClassAttribute(name: str, value: T) -> T:
-        ...
-
-else:
-
-    class ClassAttribute:
-        """Hide class attribute from its instances."""
-
-        __slots__ = 'name', 'value'
-
-        def __init__(self, name: str, value: Any) -> None:
-            self.name = name
-            self.value = value
-
-        def __get__(self, instance: Any, owner: type[Any]) -> None:
-            if instance is None:
-                return self.value
-            raise AttributeError(f'{self.name!r} attribute of {owner.__name__!r} is class-only')
-
-
-Obj = TypeVar('Obj')
-
-
-def smart_deepcopy(obj: Obj) -> Obj:
-    """Return type as is for immutable built-in types
-    Use obj.copy() for built-in empty collections
-    Use copy.deepcopy() for non-empty collections and unknown objects.
-    """
-    obj_type = obj.__class__
-    if obj_type in IMMUTABLE_NON_COLLECTIONS_TYPES:
-        return obj  # fastest case: obj is immutable and not collection therefore will not be copied anyway
-    try:
-        if not obj and obj_type in BUILTIN_COLLECTIONS:
-            # faster way for empty collections, no need to copy its members
-            return obj if obj_type is tuple else obj.copy()  # tuple doesn't have copy method  # type: ignore
-    except (TypeError, ValueError, RuntimeError):
-        # do we really dare to catch ALL errors? Seems a bit risky
-        pass
-
-    return deepcopy(obj)  # slowest way when we actually might need a deepcopy
-
-
-_SENTINEL = object()
-
-
-def all_identical(left: typing.Iterable[Any], right: typing.Iterable[Any]) -> bool:
-    """Check that the items of `left` are the same objects as those in `right`.
-
-    >>> a, b = object(), object()
-    >>> all_identical([a, b, a], [a, b, a])
-    True
-    >>> all_identical([a, b, [a]], [a, b, [a]])  # new list object, while "equal" is not "identical"
-    False
-    """
-    for left_item, right_item in zip_longest(left, right, fillvalue=_SENTINEL):
-        if left_item is not right_item:
-            return False
-    return True
-
-
-@dataclasses.dataclass(frozen=True)
-class SafeGetItemProxy:
-    """Wrapper redirecting `__getitem__` to `get` with a sentinel value as default
-
-    This makes is safe to use in `operator.itemgetter` when some keys may be missing
-    """
-
-    # Define __slots__manually for performances
-    # @dataclasses.dataclass() only support slots=True in python>=3.10
-    __slots__ = ('wrapped',)
-
-    wrapped: Mapping[str, Any]
-
-    def __getitem__(self, __key: str) -> Any:
-        return self.wrapped.get(__key, _SENTINEL)
-
-    # required to pass the object to operator.itemgetter() instances due to a quirk of typeshed
-    # https://github.com/python/mypy/issues/13713
-    # https://github.com/python/typeshed/pull/8785
-    # Since this is typing-only, hide it in a typing.TYPE_CHECKING block
-    if typing.TYPE_CHECKING:
-
-        def __contains__(self, __key: str) -> bool:
-            return self.wrapped.__contains__(__key)
diff --git a/lib/pydantic/_internal/_validate_call.py b/lib/pydantic/_internal/_validate_call.py
deleted file mode 100644
index 664c0630..00000000
--- a/lib/pydantic/_internal/_validate_call.py
+++ /dev/null
@@ -1,84 +0,0 @@
-from __future__ import annotations as _annotations
-
-import inspect
-from functools import partial
-from typing import Any, Awaitable, Callable
-
-import pydantic_core
-
-from ..config import ConfigDict
-from ..plugin._schema_validator import create_schema_validator
-from . import _generate_schema, _typing_extra
-from ._config import ConfigWrapper
-
-
-class ValidateCallWrapper:
-    """This is a wrapper around a function that validates the arguments passed to it, and optionally the return value."""
-
-    __slots__ = (
-        '__pydantic_validator__',
-        '__name__',
-        '__qualname__',
-        '__annotations__',
-        '__dict__',  # required for __module__
-    )
-
-    def __init__(self, function: Callable[..., Any], config: ConfigDict | None, validate_return: bool):
-        if isinstance(function, partial):
-            func = function.func
-            schema_type = func
-            self.__name__ = f'partial({func.__name__})'
-            self.__qualname__ = f'partial({func.__qualname__})'
-            self.__module__ = func.__module__
-        else:
-            schema_type = function
-            self.__name__ = function.__name__
-            self.__qualname__ = function.__qualname__
-            self.__module__ = function.__module__
-
-        namespace = _typing_extra.add_module_globals(function, None)
-        config_wrapper = ConfigWrapper(config)
-        gen_schema = _generate_schema.GenerateSchema(config_wrapper, namespace)
-        schema = gen_schema.clean_schema(gen_schema.generate_schema(function))
-        core_config = config_wrapper.core_config(self)
-
-        self.__pydantic_validator__ = create_schema_validator(
-            schema,
-            schema_type,
-            self.__module__,
-            self.__qualname__,
-            'validate_call',
-            core_config,
-            config_wrapper.plugin_settings,
-        )
-
-        if validate_return:
-            signature = inspect.signature(function)
-            return_type = signature.return_annotation if signature.return_annotation is not signature.empty else Any
-            gen_schema = _generate_schema.GenerateSchema(config_wrapper, namespace)
-            schema = gen_schema.clean_schema(gen_schema.generate_schema(return_type))
-            validator = create_schema_validator(
-                schema,
-                schema_type,
-                self.__module__,
-                self.__qualname__,
-                'validate_call',
-                core_config,
-                config_wrapper.plugin_settings,
-            )
-            if inspect.iscoroutinefunction(function):
-
-                async def return_val_wrapper(aw: Awaitable[Any]) -> None:
-                    return validator.validate_python(await aw)
-
-                self.__return_pydantic_validator__ = return_val_wrapper
-            else:
-                self.__return_pydantic_validator__ = validator.validate_python
-        else:
-            self.__return_pydantic_validator__ = None
-
-    def __call__(self, *args: Any, **kwargs: Any) -> Any:
-        res = self.__pydantic_validator__.validate_python(pydantic_core.ArgsKwargs(args, kwargs))
-        if self.__return_pydantic_validator__:
-            return self.__return_pydantic_validator__(res)
-        return res
diff --git a/lib/pydantic/_internal/_validators.py b/lib/pydantic/_internal/_validators.py
deleted file mode 100644
index 7193fe5c..00000000
--- a/lib/pydantic/_internal/_validators.py
+++ /dev/null
@@ -1,278 +0,0 @@
-"""Validator functions for standard library types.
-
-Import of this module is deferred since it contains imports of many standard library modules.
-"""
-
-from __future__ import annotations as _annotations
-
-import math
-import re
-import typing
-from ipaddress import IPv4Address, IPv4Interface, IPv4Network, IPv6Address, IPv6Interface, IPv6Network
-from typing import Any
-
-from pydantic_core import PydanticCustomError, core_schema
-from pydantic_core._pydantic_core import PydanticKnownError
-
-
-def sequence_validator(
-    __input_value: typing.Sequence[Any],
-    validator: core_schema.ValidatorFunctionWrapHandler,
-) -> typing.Sequence[Any]:
-    """Validator for `Sequence` types, isinstance(v, Sequence) has already been called."""
-    value_type = type(__input_value)
-
-    # We don't accept any plain string as a sequence
-    # Relevant issue: https://github.com/pydantic/pydantic/issues/5595
-    if issubclass(value_type, (str, bytes)):
-        raise PydanticCustomError(
-            'sequence_str',
-            "'{type_name}' instances are not allowed as a Sequence value",
-            {'type_name': value_type.__name__},
-        )
-
-    v_list = validator(__input_value)
-
-    # the rest of the logic is just re-creating the original type from `v_list`
-    if value_type == list:
-        return v_list
-    elif issubclass(value_type, range):
-        # return the list as we probably can't re-create the range
-        return v_list
-    else:
-        # best guess at how to re-create the original type, more custom construction logic might be required
-        return value_type(v_list)  # type: ignore[call-arg]
-
-
-def import_string(value: Any) -> Any:
-    if isinstance(value, str):
-        try:
-            return _import_string_logic(value)
-        except ImportError as e:
-            raise PydanticCustomError('import_error', 'Invalid python path: {error}', {'error': str(e)}) from e
-    else:
-        # otherwise we just return the value and let the next validator do the rest of the work
-        return value
-
-
-def _import_string_logic(dotted_path: str) -> Any:
-    """Inspired by uvicorn — dotted paths should include a colon before the final item if that item is not a module.
-    (This is necessary to distinguish between a submodule and an attribute when there is a conflict.).
-
-    If the dotted path does not include a colon and the final item is not a valid module, importing as an attribute
-    rather than a submodule will be attempted automatically.
-
-    So, for example, the following values of `dotted_path` result in the following returned values:
-    * 'collections': <module 'collections'>
-    * 'collections.abc': <module 'collections.abc'>
-    * 'collections.abc:Mapping': <class 'collections.abc.Mapping'>
-    * `collections.abc.Mapping`: <class 'collections.abc.Mapping'> (though this is a bit slower than the previous line)
-
-    An error will be raised under any of the following scenarios:
-    * `dotted_path` contains more than one colon (e.g., 'collections:abc:Mapping')
-    * the substring of `dotted_path` before the colon is not a valid module in the environment (e.g., '123:Mapping')
-    * the substring of `dotted_path` after the colon is not an attribute of the module (e.g., 'collections:abc123')
-    """
-    from importlib import import_module
-
-    components = dotted_path.strip().split(':')
-    if len(components) > 2:
-        raise ImportError(f"Import strings should have at most one ':'; received {dotted_path!r}")
-
-    module_path = components[0]
-    if not module_path:
-        raise ImportError(f'Import strings should have a nonempty module name; received {dotted_path!r}')
-
-    try:
-        module = import_module(module_path)
-    except ModuleNotFoundError as e:
-        if '.' in module_path:
-            # Check if it would be valid if the final item was separated from its module with a `:`
-            maybe_module_path, maybe_attribute = dotted_path.strip().rsplit('.', 1)
-            try:
-                return _import_string_logic(f'{maybe_module_path}:{maybe_attribute}')
-            except ImportError:
-                pass
-            raise ImportError(f'No module named {module_path!r}') from e
-        raise e
-
-    if len(components) > 1:
-        attribute = components[1]
-        try:
-            return getattr(module, attribute)
-        except AttributeError as e:
-            raise ImportError(f'cannot import name {attribute!r} from {module_path!r}') from e
-    else:
-        return module
-
-
-def pattern_either_validator(__input_value: Any) -> typing.Pattern[Any]:
-    if isinstance(__input_value, typing.Pattern):
-        return __input_value
-    elif isinstance(__input_value, (str, bytes)):
-        # todo strict mode
-        return compile_pattern(__input_value)  # type: ignore
-    else:
-        raise PydanticCustomError('pattern_type', 'Input should be a valid pattern')
-
-
-def pattern_str_validator(__input_value: Any) -> typing.Pattern[str]:
-    if isinstance(__input_value, typing.Pattern):
-        if isinstance(__input_value.pattern, str):
-            return __input_value
-        else:
-            raise PydanticCustomError('pattern_str_type', 'Input should be a string pattern')
-    elif isinstance(__input_value, str):
-        return compile_pattern(__input_value)
-    elif isinstance(__input_value, bytes):
-        raise PydanticCustomError('pattern_str_type', 'Input should be a string pattern')
-    else:
-        raise PydanticCustomError('pattern_type', 'Input should be a valid pattern')
-
-
-def pattern_bytes_validator(__input_value: Any) -> typing.Pattern[bytes]:
-    if isinstance(__input_value, typing.Pattern):
-        if isinstance(__input_value.pattern, bytes):
-            return __input_value
-        else:
-            raise PydanticCustomError('pattern_bytes_type', 'Input should be a bytes pattern')
-    elif isinstance(__input_value, bytes):
-        return compile_pattern(__input_value)
-    elif isinstance(__input_value, str):
-        raise PydanticCustomError('pattern_bytes_type', 'Input should be a bytes pattern')
-    else:
-        raise PydanticCustomError('pattern_type', 'Input should be a valid pattern')
-
-
-PatternType = typing.TypeVar('PatternType', str, bytes)
-
-
-def compile_pattern(pattern: PatternType) -> typing.Pattern[PatternType]:
-    try:
-        return re.compile(pattern)
-    except re.error:
-        raise PydanticCustomError('pattern_regex', 'Input should be a valid regular expression')
-
-
-def ip_v4_address_validator(__input_value: Any) -> IPv4Address:
-    if isinstance(__input_value, IPv4Address):
-        return __input_value
-
-    try:
-        return IPv4Address(__input_value)
-    except ValueError:
-        raise PydanticCustomError('ip_v4_address', 'Input is not a valid IPv4 address')
-
-
-def ip_v6_address_validator(__input_value: Any) -> IPv6Address:
-    if isinstance(__input_value, IPv6Address):
-        return __input_value
-
-    try:
-        return IPv6Address(__input_value)
-    except ValueError:
-        raise PydanticCustomError('ip_v6_address', 'Input is not a valid IPv6 address')
-
-
-def ip_v4_network_validator(__input_value: Any) -> IPv4Network:
-    """Assume IPv4Network initialised with a default `strict` argument.
-
-    See more:
-    https://docs.python.org/library/ipaddress.html#ipaddress.IPv4Network
-    """
-    if isinstance(__input_value, IPv4Network):
-        return __input_value
-
-    try:
-        return IPv4Network(__input_value)
-    except ValueError:
-        raise PydanticCustomError('ip_v4_network', 'Input is not a valid IPv4 network')
-
-
-def ip_v6_network_validator(__input_value: Any) -> IPv6Network:
-    """Assume IPv6Network initialised with a default `strict` argument.
-
-    See more:
-    https://docs.python.org/library/ipaddress.html#ipaddress.IPv6Network
-    """
-    if isinstance(__input_value, IPv6Network):
-        return __input_value
-
-    try:
-        return IPv6Network(__input_value)
-    except ValueError:
-        raise PydanticCustomError('ip_v6_network', 'Input is not a valid IPv6 network')
-
-
-def ip_v4_interface_validator(__input_value: Any) -> IPv4Interface:
-    if isinstance(__input_value, IPv4Interface):
-        return __input_value
-
-    try:
-        return IPv4Interface(__input_value)
-    except ValueError:
-        raise PydanticCustomError('ip_v4_interface', 'Input is not a valid IPv4 interface')
-
-
-def ip_v6_interface_validator(__input_value: Any) -> IPv6Interface:
-    if isinstance(__input_value, IPv6Interface):
-        return __input_value
-
-    try:
-        return IPv6Interface(__input_value)
-    except ValueError:
-        raise PydanticCustomError('ip_v6_interface', 'Input is not a valid IPv6 interface')
-
-
-def greater_than_validator(x: Any, gt: Any) -> Any:
-    if not (x > gt):
-        raise PydanticKnownError('greater_than', {'gt': gt})
-    return x
-
-
-def greater_than_or_equal_validator(x: Any, ge: Any) -> Any:
-    if not (x >= ge):
-        raise PydanticKnownError('greater_than_equal', {'ge': ge})
-    return x
-
-
-def less_than_validator(x: Any, lt: Any) -> Any:
-    if not (x < lt):
-        raise PydanticKnownError('less_than', {'lt': lt})
-    return x
-
-
-def less_than_or_equal_validator(x: Any, le: Any) -> Any:
-    if not (x <= le):
-        raise PydanticKnownError('less_than_equal', {'le': le})
-    return x
-
-
-def multiple_of_validator(x: Any, multiple_of: Any) -> Any:
-    if not (x % multiple_of == 0):
-        raise PydanticKnownError('multiple_of', {'multiple_of': multiple_of})
-    return x
-
-
-def min_length_validator(x: Any, min_length: Any) -> Any:
-    if not (len(x) >= min_length):
-        raise PydanticKnownError(
-            'too_short',
-            {'field_type': 'Value', 'min_length': min_length, 'actual_length': len(x)},
-        )
-    return x
-
-
-def max_length_validator(x: Any, max_length: Any) -> Any:
-    if len(x) > max_length:
-        raise PydanticKnownError(
-            'too_long',
-            {'field_type': 'Value', 'max_length': max_length, 'actual_length': len(x)},
-        )
-    return x
-
-
-def forbid_inf_nan_check(x: Any) -> Any:
-    if not math.isfinite(x):
-        raise PydanticKnownError('finite_number')
-    return x
diff --git a/lib/pydantic/_migration.py b/lib/pydantic/_migration.py
deleted file mode 100644
index c8478a62..00000000
--- a/lib/pydantic/_migration.py
+++ /dev/null
@@ -1,308 +0,0 @@
-import sys
-from typing import Any, Callable, Dict
-
-from .version import version_short
-
-MOVED_IN_V2 = {
-    'pydantic.utils:version_info': 'pydantic.version:version_info',
-    'pydantic.error_wrappers:ValidationError': 'pydantic:ValidationError',
-    'pydantic.utils:to_camel': 'pydantic.alias_generators:to_pascal',
-    'pydantic.utils:to_lower_camel': 'pydantic.alias_generators:to_camel',
-    'pydantic:PyObject': 'pydantic.types:ImportString',
-    'pydantic.types:PyObject': 'pydantic.types:ImportString',
-    'pydantic.generics:GenericModel': 'pydantic.BaseModel',
-}
-
-DEPRECATED_MOVED_IN_V2 = {
-    'pydantic.tools:schema_of': 'pydantic.deprecated.tools:schema_of',
-    'pydantic.tools:parse_obj_as': 'pydantic.deprecated.tools:parse_obj_as',
-    'pydantic.tools:schema_json_of': 'pydantic.deprecated.tools:schema_json_of',
-    'pydantic.json:pydantic_encoder': 'pydantic.deprecated.json:pydantic_encoder',
-    'pydantic:validate_arguments': 'pydantic.deprecated.decorator:validate_arguments',
-    'pydantic.json:custom_pydantic_encoder': 'pydantic.deprecated.json:custom_pydantic_encoder',
-    'pydantic.json:timedelta_isoformat': 'pydantic.deprecated.json:timedelta_isoformat',
-    'pydantic.decorator:validate_arguments': 'pydantic.deprecated.decorator:validate_arguments',
-    'pydantic.class_validators:validator': 'pydantic.deprecated.class_validators:validator',
-    'pydantic.class_validators:root_validator': 'pydantic.deprecated.class_validators:root_validator',
-    'pydantic.config:BaseConfig': 'pydantic.deprecated.config:BaseConfig',
-    'pydantic.config:Extra': 'pydantic.deprecated.config:Extra',
-}
-
-REDIRECT_TO_V1 = {
-    f'pydantic.utils:{obj}': f'pydantic.v1.utils:{obj}'
-    for obj in (
-        'deep_update',
-        'GetterDict',
-        'lenient_issubclass',
-        'lenient_isinstance',
-        'is_valid_field',
-        'update_not_none',
-        'import_string',
-        'Representation',
-        'ROOT_KEY',
-        'smart_deepcopy',
-        'sequence_like',
-    )
-}
-
-
-REMOVED_IN_V2 = {
-    'pydantic:ConstrainedBytes',
-    'pydantic:ConstrainedDate',
-    'pydantic:ConstrainedDecimal',
-    'pydantic:ConstrainedFloat',
-    'pydantic:ConstrainedFrozenSet',
-    'pydantic:ConstrainedInt',
-    'pydantic:ConstrainedList',
-    'pydantic:ConstrainedSet',
-    'pydantic:ConstrainedStr',
-    'pydantic:JsonWrapper',
-    'pydantic:NoneBytes',
-    'pydantic:NoneStr',
-    'pydantic:NoneStrBytes',
-    'pydantic:Protocol',
-    'pydantic:Required',
-    'pydantic:StrBytes',
-    'pydantic:compiled',
-    'pydantic.config:get_config',
-    'pydantic.config:inherit_config',
-    'pydantic.config:prepare_config',
-    'pydantic:create_model_from_namedtuple',
-    'pydantic:create_model_from_typeddict',
-    'pydantic.dataclasses:create_pydantic_model_from_dataclass',
-    'pydantic.dataclasses:make_dataclass_validator',
-    'pydantic.dataclasses:set_validation',
-    'pydantic.datetime_parse:parse_date',
-    'pydantic.datetime_parse:parse_time',
-    'pydantic.datetime_parse:parse_datetime',
-    'pydantic.datetime_parse:parse_duration',
-    'pydantic.error_wrappers:ErrorWrapper',
-    'pydantic.errors:AnyStrMaxLengthError',
-    'pydantic.errors:AnyStrMinLengthError',
-    'pydantic.errors:ArbitraryTypeError',
-    'pydantic.errors:BoolError',
-    'pydantic.errors:BytesError',
-    'pydantic.errors:CallableError',
-    'pydantic.errors:ClassError',
-    'pydantic.errors:ColorError',
-    'pydantic.errors:ConfigError',
-    'pydantic.errors:DataclassTypeError',
-    'pydantic.errors:DateError',
-    'pydantic.errors:DateNotInTheFutureError',
-    'pydantic.errors:DateNotInThePastError',
-    'pydantic.errors:DateTimeError',
-    'pydantic.errors:DecimalError',
-    'pydantic.errors:DecimalIsNotFiniteError',
-    'pydantic.errors:DecimalMaxDigitsError',
-    'pydantic.errors:DecimalMaxPlacesError',
-    'pydantic.errors:DecimalWholeDigitsError',
-    'pydantic.errors:DictError',
-    'pydantic.errors:DurationError',
-    'pydantic.errors:EmailError',
-    'pydantic.errors:EnumError',
-    'pydantic.errors:EnumMemberError',
-    'pydantic.errors:ExtraError',
-    'pydantic.errors:FloatError',
-    'pydantic.errors:FrozenSetError',
-    'pydantic.errors:FrozenSetMaxLengthError',
-    'pydantic.errors:FrozenSetMinLengthError',
-    'pydantic.errors:HashableError',
-    'pydantic.errors:IPv4AddressError',
-    'pydantic.errors:IPv4InterfaceError',
-    'pydantic.errors:IPv4NetworkError',
-    'pydantic.errors:IPv6AddressError',
-    'pydantic.errors:IPv6InterfaceError',
-    'pydantic.errors:IPv6NetworkError',
-    'pydantic.errors:IPvAnyAddressError',
-    'pydantic.errors:IPvAnyInterfaceError',
-    'pydantic.errors:IPvAnyNetworkError',
-    'pydantic.errors:IntEnumError',
-    'pydantic.errors:IntegerError',
-    'pydantic.errors:InvalidByteSize',
-    'pydantic.errors:InvalidByteSizeUnit',
-    'pydantic.errors:InvalidDiscriminator',
-    'pydantic.errors:InvalidLengthForBrand',
-    'pydantic.errors:JsonError',
-    'pydantic.errors:JsonTypeError',
-    'pydantic.errors:ListError',
-    'pydantic.errors:ListMaxLengthError',
-    'pydantic.errors:ListMinLengthError',
-    'pydantic.errors:ListUniqueItemsError',
-    'pydantic.errors:LuhnValidationError',
-    'pydantic.errors:MissingDiscriminator',
-    'pydantic.errors:MissingError',
-    'pydantic.errors:NoneIsAllowedError',
-    'pydantic.errors:NoneIsNotAllowedError',
-    'pydantic.errors:NotDigitError',
-    'pydantic.errors:NotNoneError',
-    'pydantic.errors:NumberNotGeError',
-    'pydantic.errors:NumberNotGtError',
-    'pydantic.errors:NumberNotLeError',
-    'pydantic.errors:NumberNotLtError',
-    'pydantic.errors:NumberNotMultipleError',
-    'pydantic.errors:PathError',
-    'pydantic.errors:PathNotADirectoryError',
-    'pydantic.errors:PathNotAFileError',
-    'pydantic.errors:PathNotExistsError',
-    'pydantic.errors:PatternError',
-    'pydantic.errors:PyObjectError',
-    'pydantic.errors:PydanticTypeError',
-    'pydantic.errors:PydanticValueError',
-    'pydantic.errors:SequenceError',
-    'pydantic.errors:SetError',
-    'pydantic.errors:SetMaxLengthError',
-    'pydantic.errors:SetMinLengthError',
-    'pydantic.errors:StrError',
-    'pydantic.errors:StrRegexError',
-    'pydantic.errors:StrictBoolError',
-    'pydantic.errors:SubclassError',
-    'pydantic.errors:TimeError',
-    'pydantic.errors:TupleError',
-    'pydantic.errors:TupleLengthError',
-    'pydantic.errors:UUIDError',
-    'pydantic.errors:UUIDVersionError',
-    'pydantic.errors:UrlError',
-    'pydantic.errors:UrlExtraError',
-    'pydantic.errors:UrlHostError',
-    'pydantic.errors:UrlHostTldError',
-    'pydantic.errors:UrlPortError',
-    'pydantic.errors:UrlSchemeError',
-    'pydantic.errors:UrlSchemePermittedError',
-    'pydantic.errors:UrlUserInfoError',
-    'pydantic.errors:WrongConstantError',
-    'pydantic.main:validate_model',
-    'pydantic.networks:stricturl',
-    'pydantic:parse_file_as',
-    'pydantic:parse_raw_as',
-    'pydantic:stricturl',
-    'pydantic.tools:parse_file_as',
-    'pydantic.tools:parse_raw_as',
-    'pydantic.types:ConstrainedBytes',
-    'pydantic.types:ConstrainedDate',
-    'pydantic.types:ConstrainedDecimal',
-    'pydantic.types:ConstrainedFloat',
-    'pydantic.types:ConstrainedFrozenSet',
-    'pydantic.types:ConstrainedInt',
-    'pydantic.types:ConstrainedList',
-    'pydantic.types:ConstrainedSet',
-    'pydantic.types:ConstrainedStr',
-    'pydantic.types:JsonWrapper',
-    'pydantic.types:NoneBytes',
-    'pydantic.types:NoneStr',
-    'pydantic.types:NoneStrBytes',
-    'pydantic.types:StrBytes',
-    'pydantic.typing:evaluate_forwardref',
-    'pydantic.typing:AbstractSetIntStr',
-    'pydantic.typing:AnyCallable',
-    'pydantic.typing:AnyClassMethod',
-    'pydantic.typing:CallableGenerator',
-    'pydantic.typing:DictAny',
-    'pydantic.typing:DictIntStrAny',
-    'pydantic.typing:DictStrAny',
-    'pydantic.typing:IntStr',
-    'pydantic.typing:ListStr',
-    'pydantic.typing:MappingIntStrAny',
-    'pydantic.typing:NoArgAnyCallable',
-    'pydantic.typing:NoneType',
-    'pydantic.typing:ReprArgs',
-    'pydantic.typing:SetStr',
-    'pydantic.typing:StrPath',
-    'pydantic.typing:TupleGenerator',
-    'pydantic.typing:WithArgsTypes',
-    'pydantic.typing:all_literal_values',
-    'pydantic.typing:display_as_type',
-    'pydantic.typing:get_all_type_hints',
-    'pydantic.typing:get_args',
-    'pydantic.typing:get_origin',
-    'pydantic.typing:get_sub_types',
-    'pydantic.typing:is_callable_type',
-    'pydantic.typing:is_classvar',
-    'pydantic.typing:is_finalvar',
-    'pydantic.typing:is_literal_type',
-    'pydantic.typing:is_namedtuple',
-    'pydantic.typing:is_new_type',
-    'pydantic.typing:is_none_type',
-    'pydantic.typing:is_typeddict',
-    'pydantic.typing:is_typeddict_special',
-    'pydantic.typing:is_union',
-    'pydantic.typing:new_type_supertype',
-    'pydantic.typing:resolve_annotations',
-    'pydantic.typing:typing_base',
-    'pydantic.typing:update_field_forward_refs',
-    'pydantic.typing:update_model_forward_refs',
-    'pydantic.utils:ClassAttribute',
-    'pydantic.utils:DUNDER_ATTRIBUTES',
-    'pydantic.utils:PyObjectStr',
-    'pydantic.utils:ValueItems',
-    'pydantic.utils:almost_equal_floats',
-    'pydantic.utils:get_discriminator_alias_and_values',
-    'pydantic.utils:get_model',
-    'pydantic.utils:get_unique_discriminator_alias',
-    'pydantic.utils:in_ipython',
-    'pydantic.utils:is_valid_identifier',
-    'pydantic.utils:path_type',
-    'pydantic.utils:validate_field_name',
-    'pydantic:validate_model',
-}
-
-
-def getattr_migration(module: str) -> Callable[[str], Any]:
-    """Implement PEP 562 for objects that were either moved or removed on the migration
-    to V2.
-
-    Args:
-        module: The module name.
-
-    Returns:
-        A callable that will raise an error if the object is not found.
-    """
-    # This avoids circular import with errors.py.
-    from .errors import PydanticImportError
-
-    def wrapper(name: str) -> object:
-        """Raise an error if the object is not found, or warn if it was moved.
-
-        In case it was moved, it still returns the object.
-
-        Args:
-            name: The object name.
-
-        Returns:
-            The object.
-        """
-        if name == '__path__':
-            raise AttributeError(f'module {module!r} has no attribute {name!r}')
-
-        import warnings
-
-        from ._internal._validators import import_string
-
-        import_path = f'{module}:{name}'
-        if import_path in MOVED_IN_V2.keys():
-            new_location = MOVED_IN_V2[import_path]
-            warnings.warn(f'`{import_path}` has been moved to `{new_location}`.')
-            return import_string(MOVED_IN_V2[import_path])
-        if import_path in DEPRECATED_MOVED_IN_V2:
-            # skip the warning here because a deprecation warning will be raised elsewhere
-            return import_string(DEPRECATED_MOVED_IN_V2[import_path])
-        if import_path in REDIRECT_TO_V1:
-            new_location = REDIRECT_TO_V1[import_path]
-            warnings.warn(
-                f'`{import_path}` has been removed. We are importing from `{new_location}` instead.'
-                'See the migration guide for more details: https://docs.pydantic.dev/latest/migration/'
-            )
-            return import_string(REDIRECT_TO_V1[import_path])
-        if import_path == 'pydantic:BaseSettings':
-            raise PydanticImportError(
-                '`BaseSettings` has been moved to the `pydantic-settings` package. '
-                f'See https://docs.pydantic.dev/{version_short()}/migration/#basesettings-has-moved-to-pydantic-settings '
-                'for more details.'
-            )
-        if import_path in REMOVED_IN_V2:
-            raise PydanticImportError(f'`{import_path}` has been removed in V2.')
-        globals: Dict[str, Any] = sys.modules[module].__dict__
-        if name in globals:
-            return globals[name]
-        raise AttributeError(f'module {module!r} has no attribute {name!r}')
-
-    return wrapper
diff --git a/lib/pydantic/alias_generators.py b/lib/pydantic/alias_generators.py
deleted file mode 100644
index 155e66e0..00000000
--- a/lib/pydantic/alias_generators.py
+++ /dev/null
@@ -1,50 +0,0 @@
-"""Alias generators for converting between different capitalization conventions."""
-import re
-
-__all__ = ('to_pascal', 'to_camel', 'to_snake')
-
-
-def to_pascal(snake: str) -> str:
-    """Convert a snake_case string to PascalCase.
-
-    Args:
-        snake: The string to convert.
-
-    Returns:
-        The PascalCase string.
-    """
-    camel = snake.title()
-    return re.sub('([0-9A-Za-z])_(?=[0-9A-Z])', lambda m: m.group(1), camel)
-
-
-def to_camel(snake: str) -> str:
-    """Convert a snake_case string to camelCase.
-
-    Args:
-        snake: The string to convert.
-
-    Returns:
-        The converted camelCase string.
-    """
-    camel = to_pascal(snake)
-    return re.sub('(^_*[A-Z])', lambda m: m.group(1).lower(), camel)
-
-
-def to_snake(camel: str) -> str:
-    """Convert a PascalCase or camelCase string to snake_case.
-
-    Args:
-        camel: The string to convert.
-
-    Returns:
-        The converted string in snake_case.
-    """
-    # Handle the sequence of uppercase letters followed by a lowercase letter
-    snake = re.sub(r'([A-Z]+)([A-Z][a-z])', lambda m: f'{m.group(1)}_{m.group(2)}', camel)
-    # Insert an underscore between a lowercase letter and an uppercase letter
-    snake = re.sub(r'([a-z])([A-Z])', lambda m: f'{m.group(1)}_{m.group(2)}', snake)
-    # Insert an underscore between a digit and an uppercase letter
-    snake = re.sub(r'([0-9])([A-Z])', lambda m: f'{m.group(1)}_{m.group(2)}', snake)
-    # Insert an underscore between a lowercase letter and a digit
-    snake = re.sub(r'([a-z])([0-9])', lambda m: f'{m.group(1)}_{m.group(2)}', snake)
-    return snake.lower()
diff --git a/lib/pydantic/aliases.py b/lib/pydantic/aliases.py
deleted file mode 100644
index b53557b1..00000000
--- a/lib/pydantic/aliases.py
+++ /dev/null
@@ -1,112 +0,0 @@
-"""Support for alias configurations."""
-from __future__ import annotations
-
-import dataclasses
-from typing import Callable, Literal
-
-from ._internal import _internal_dataclass
-
-__all__ = ('AliasGenerator', 'AliasPath', 'AliasChoices')
-
-
-@dataclasses.dataclass(**_internal_dataclass.slots_true)
-class AliasPath:
-    """Usage docs: https://docs.pydantic.dev/2.6/concepts/alias#aliaspath-and-aliaschoices
-
-    A data class used by `validation_alias` as a convenience to create aliases.
-
-    Attributes:
-        path: A list of string or integer aliases.
-    """
-
-    path: list[int | str]
-
-    def __init__(self, first_arg: str, *args: str | int) -> None:
-        self.path = [first_arg] + list(args)
-
-    def convert_to_aliases(self) -> list[str | int]:
-        """Converts arguments to a list of string or integer aliases.
-
-        Returns:
-            The list of aliases.
-        """
-        return self.path
-
-
-@dataclasses.dataclass(**_internal_dataclass.slots_true)
-class AliasChoices:
-    """Usage docs: https://docs.pydantic.dev/2.6/concepts/alias#aliaspath-and-aliaschoices
-
-    A data class used by `validation_alias` as a convenience to create aliases.
-
-    Attributes:
-        choices: A list containing a string or `AliasPath`.
-    """
-
-    choices: list[str | AliasPath]
-
-    def __init__(self, first_choice: str | AliasPath, *choices: str | AliasPath) -> None:
-        self.choices = [first_choice] + list(choices)
-
-    def convert_to_aliases(self) -> list[list[str | int]]:
-        """Converts arguments to a list of lists containing string or integer aliases.
-
-        Returns:
-            The list of aliases.
-        """
-        aliases: list[list[str | int]] = []
-        for c in self.choices:
-            if isinstance(c, AliasPath):
-                aliases.append(c.convert_to_aliases())
-            else:
-                aliases.append([c])
-        return aliases
-
-
-@dataclasses.dataclass(**_internal_dataclass.slots_true)
-class AliasGenerator:
-    """Usage docs: https://docs.pydantic.dev/2.6/concepts/alias#using-an-aliasgenerator
-
-    A data class used by `alias_generator` as a convenience to create various aliases.
-
-    Attributes:
-        alias: A callable that takes a field name and returns an alias for it.
-        validation_alias: A callable that takes a field name and returns a validation alias for it.
-        serialization_alias: A callable that takes a field name and returns a serialization alias for it.
-    """
-
-    alias: Callable[[str], str] | None = None
-    validation_alias: Callable[[str], str | AliasPath | AliasChoices] | None = None
-    serialization_alias: Callable[[str], str] | None = None
-
-    def _generate_alias(
-        self,
-        alias_kind: Literal['alias', 'validation_alias', 'serialization_alias'],
-        allowed_types: tuple[type[str] | type[AliasPath] | type[AliasChoices], ...],
-        field_name: str,
-    ) -> str | AliasPath | AliasChoices | None:
-        """Generate an alias of the specified kind. Returns None if the alias generator is None.
-
-        Raises:
-            TypeError: If the alias generator produces an invalid type.
-        """
-        alias = None
-        if alias_generator := getattr(self, alias_kind):
-            alias = alias_generator(field_name)
-            if alias and not isinstance(alias, allowed_types):
-                raise TypeError(
-                    f'Invalid `{alias_kind}` type. `{alias_kind}` generator must produce one of `{allowed_types}`'
-                )
-        return alias
-
-    def generate_aliases(self, field_name: str) -> tuple[str | None, str | AliasPath | AliasChoices | None, str | None]:
-        """Generate `alias`, `validation_alias`, and `serialization_alias` for a field.
-
-        Returns:
-            A tuple of three aliases - validation, alias, and serialization.
-        """
-        alias = self._generate_alias('alias', (str,), field_name)
-        validation_alias = self._generate_alias('validation_alias', (str, AliasChoices, AliasPath), field_name)
-        serialization_alias = self._generate_alias('serialization_alias', (str,), field_name)
-
-        return alias, validation_alias, serialization_alias  # type: ignore
diff --git a/lib/pydantic/annotated_handlers.py b/lib/pydantic/annotated_handlers.py
deleted file mode 100644
index 081949a8..00000000
--- a/lib/pydantic/annotated_handlers.py
+++ /dev/null
@@ -1,120 +0,0 @@
-"""Type annotations to use with `__get_pydantic_core_schema__` and `__get_pydantic_json_schema__`."""
-from __future__ import annotations as _annotations
-
-from typing import TYPE_CHECKING, Any, Union
-
-from pydantic_core import core_schema
-
-if TYPE_CHECKING:
-    from .json_schema import JsonSchemaMode, JsonSchemaValue
-
-    CoreSchemaOrField = Union[
-        core_schema.CoreSchema,
-        core_schema.ModelField,
-        core_schema.DataclassField,
-        core_schema.TypedDictField,
-        core_schema.ComputedField,
-    ]
-
-__all__ = 'GetJsonSchemaHandler', 'GetCoreSchemaHandler'
-
-
-class GetJsonSchemaHandler:
-    """Handler to call into the next JSON schema generation function.
-
-    Attributes:
-        mode: Json schema mode, can be `validation` or `serialization`.
-    """
-
-    mode: JsonSchemaMode
-
-    def __call__(self, __core_schema: CoreSchemaOrField) -> JsonSchemaValue:
-        """Call the inner handler and get the JsonSchemaValue it returns.
-        This will call the next JSON schema modifying function up until it calls
-        into `pydantic.json_schema.GenerateJsonSchema`, which will raise a
-        `pydantic.errors.PydanticInvalidForJsonSchema` error if it cannot generate
-        a JSON schema.
-
-        Args:
-            __core_schema: A `pydantic_core.core_schema.CoreSchema`.
-
-        Returns:
-            JsonSchemaValue: The JSON schema generated by the inner JSON schema modify
-            functions.
-        """
-        raise NotImplementedError
-
-    def resolve_ref_schema(self, __maybe_ref_json_schema: JsonSchemaValue) -> JsonSchemaValue:
-        """Get the real schema for a `{"$ref": ...}` schema.
-        If the schema given is not a `$ref` schema, it will be returned as is.
-        This means you don't have to check before calling this function.
-
-        Args:
-            __maybe_ref_json_schema: A JsonSchemaValue which may be a `$ref` schema.
-
-        Raises:
-            LookupError: If the ref is not found.
-
-        Returns:
-            JsonSchemaValue: A JsonSchemaValue that has no `$ref`.
-        """
-        raise NotImplementedError
-
-
-class GetCoreSchemaHandler:
-    """Handler to call into the next CoreSchema schema generation function."""
-
-    def __call__(self, __source_type: Any) -> core_schema.CoreSchema:
-        """Call the inner handler and get the CoreSchema it returns.
-        This will call the next CoreSchema modifying function up until it calls
-        into Pydantic's internal schema generation machinery, which will raise a
-        `pydantic.errors.PydanticSchemaGenerationError` error if it cannot generate
-        a CoreSchema for the given source type.
-
-        Args:
-            __source_type: The input type.
-
-        Returns:
-            CoreSchema: The `pydantic-core` CoreSchema generated.
-        """
-        raise NotImplementedError
-
-    def generate_schema(self, __source_type: Any) -> core_schema.CoreSchema:
-        """Generate a schema unrelated to the current context.
-        Use this function if e.g. you are handling schema generation for a sequence
-        and want to generate a schema for its items.
-        Otherwise, you may end up doing something like applying a `min_length` constraint
-        that was intended for the sequence itself to its items!
-
-        Args:
-            __source_type: The input type.
-
-        Returns:
-            CoreSchema: The `pydantic-core` CoreSchema generated.
-        """
-        raise NotImplementedError
-
-    def resolve_ref_schema(self, __maybe_ref_schema: core_schema.CoreSchema) -> core_schema.CoreSchema:
-        """Get the real schema for a `definition-ref` schema.
-        If the schema given is not a `definition-ref` schema, it will be returned as is.
-        This means you don't have to check before calling this function.
-
-        Args:
-            __maybe_ref_schema: A `CoreSchema`, `ref`-based or not.
-
-        Raises:
-            LookupError: If the `ref` is not found.
-
-        Returns:
-            A concrete `CoreSchema`.
-        """
-        raise NotImplementedError
-
-    @property
-    def field_name(self) -> str | None:
-        """Get the name of the closest field to this validator."""
-        raise NotImplementedError
-
-    def _get_types_namespace(self) -> dict[str, Any] | None:
-        """Internal method used during type resolution for serializer annotations."""
-        raise NotImplementedError
diff --git a/lib/pydantic/v1/annotated_types.py b/lib/pydantic/annotated_types.py
similarity index 100%
rename from lib/pydantic/v1/annotated_types.py
rename to lib/pydantic/annotated_types.py
diff --git a/lib/pydantic/class_validators.py b/lib/pydantic/class_validators.py
index 2ff72ae5..87190610 100644
--- a/lib/pydantic/class_validators.py
+++ b/lib/pydantic/class_validators.py
@@ -1,4 +1,342 @@
-"""`class_validators` module is a backport module from V1."""
-from ._migration import getattr_migration
+import warnings
+from collections import ChainMap
+from functools import wraps
+from itertools import chain
+from types import FunctionType
+from typing import TYPE_CHECKING, Any, Callable, Dict, Iterable, List, Optional, Set, Tuple, Type, Union, overload
 
-__getattr__ = getattr_migration(__name__)
+from .errors import ConfigError
+from .typing import AnyCallable
+from .utils import ROOT_KEY, in_ipython
+
+if TYPE_CHECKING:
+    from .typing import AnyClassMethod
+
+
+class Validator:
+    __slots__ = 'func', 'pre', 'each_item', 'always', 'check_fields', 'skip_on_failure'
+
+    def __init__(
+        self,
+        func: AnyCallable,
+        pre: bool = False,
+        each_item: bool = False,
+        always: bool = False,
+        check_fields: bool = False,
+        skip_on_failure: bool = False,
+    ):
+        self.func = func
+        self.pre = pre
+        self.each_item = each_item
+        self.always = always
+        self.check_fields = check_fields
+        self.skip_on_failure = skip_on_failure
+
+
+if TYPE_CHECKING:
+    from inspect import Signature
+
+    from .config import BaseConfig
+    from .fields import ModelField
+    from .types import ModelOrDc
+
+    ValidatorCallable = Callable[[Optional[ModelOrDc], Any, Dict[str, Any], ModelField, Type[BaseConfig]], Any]
+    ValidatorsList = List[ValidatorCallable]
+    ValidatorListDict = Dict[str, List[Validator]]
+
+_FUNCS: Set[str] = set()
+VALIDATOR_CONFIG_KEY = '__validator_config__'
+ROOT_VALIDATOR_CONFIG_KEY = '__root_validator_config__'
+
+
+def validator(
+    *fields: str,
+    pre: bool = False,
+    each_item: bool = False,
+    always: bool = False,
+    check_fields: bool = True,
+    whole: bool = None,
+    allow_reuse: bool = False,
+) -> Callable[[AnyCallable], 'AnyClassMethod']:
+    """
+    Decorate methods on the class indicating that they should be used to validate fields
+    :param fields: which field(s) the method should be called on
+    :param pre: whether or not this validator should be called before the standard validators (else after)
+    :param each_item: for complex objects (sets, lists etc.) whether to validate individual elements rather than the
+      whole object
+    :param always: whether this method and other validators should be called even if the value is missing
+    :param check_fields: whether to check that the fields actually exist on the model
+    :param allow_reuse: whether to track and raise an error if another validator refers to the decorated function
+    """
+    if not fields:
+        raise ConfigError('validator with no fields specified')
+    elif isinstance(fields[0], FunctionType):
+        raise ConfigError(
+            "validators should be used with fields and keyword arguments, not bare. "  # noqa: Q000
+            "E.g. usage should be `@validator('<field_name>', ...)`"
+        )
+    elif not all(isinstance(field, str) for field in fields):
+        raise ConfigError(
+            "validator fields should be passed as separate string args. "  # noqa: Q000
+            "E.g. usage should be `@validator('<field_name_1>', '<field_name_2>', ...)`"
+        )
+
+    if whole is not None:
+        warnings.warn(
+            'The "whole" keyword argument is deprecated, use "each_item" (inverse meaning, default False) instead',
+            DeprecationWarning,
+        )
+        assert each_item is False, '"each_item" and "whole" conflict, remove "whole"'
+        each_item = not whole
+
+    def dec(f: AnyCallable) -> 'AnyClassMethod':
+        f_cls = _prepare_validator(f, allow_reuse)
+        setattr(
+            f_cls,
+            VALIDATOR_CONFIG_KEY,
+            (
+                fields,
+                Validator(func=f_cls.__func__, pre=pre, each_item=each_item, always=always, check_fields=check_fields),
+            ),
+        )
+        return f_cls
+
+    return dec
+
+
+@overload
+def root_validator(_func: AnyCallable) -> 'AnyClassMethod':
+    ...
+
+
+@overload
+def root_validator(
+    *, pre: bool = False, allow_reuse: bool = False, skip_on_failure: bool = False
+) -> Callable[[AnyCallable], 'AnyClassMethod']:
+    ...
+
+
+def root_validator(
+    _func: Optional[AnyCallable] = None, *, pre: bool = False, allow_reuse: bool = False, skip_on_failure: bool = False
+) -> Union['AnyClassMethod', Callable[[AnyCallable], 'AnyClassMethod']]:
+    """
+    Decorate methods on a model indicating that they should be used to validate (and perhaps modify) data either
+    before or after standard model parsing/validation is performed.
+    """
+    if _func:
+        f_cls = _prepare_validator(_func, allow_reuse)
+        setattr(
+            f_cls, ROOT_VALIDATOR_CONFIG_KEY, Validator(func=f_cls.__func__, pre=pre, skip_on_failure=skip_on_failure)
+        )
+        return f_cls
+
+    def dec(f: AnyCallable) -> 'AnyClassMethod':
+        f_cls = _prepare_validator(f, allow_reuse)
+        setattr(
+            f_cls, ROOT_VALIDATOR_CONFIG_KEY, Validator(func=f_cls.__func__, pre=pre, skip_on_failure=skip_on_failure)
+        )
+        return f_cls
+
+    return dec
+
+
+def _prepare_validator(function: AnyCallable, allow_reuse: bool) -> 'AnyClassMethod':
+    """
+    Avoid validators with duplicated names since without this, validators can be overwritten silently
+    which generally isn't the intended behaviour, don't run in ipython (see #312) or if allow_reuse is False.
+    """
+    f_cls = function if isinstance(function, classmethod) else classmethod(function)
+    if not in_ipython() and not allow_reuse:
+        ref = f_cls.__func__.__module__ + '.' + f_cls.__func__.__qualname__
+        if ref in _FUNCS:
+            raise ConfigError(f'duplicate validator function "{ref}"; if this is intended, set `allow_reuse=True`')
+        _FUNCS.add(ref)
+    return f_cls
+
+
+class ValidatorGroup:
+    def __init__(self, validators: 'ValidatorListDict') -> None:
+        self.validators = validators
+        self.used_validators = {'*'}
+
+    def get_validators(self, name: str) -> Optional[Dict[str, Validator]]:
+        self.used_validators.add(name)
+        validators = self.validators.get(name, [])
+        if name != ROOT_KEY:
+            validators += self.validators.get('*', [])
+        if validators:
+            return {v.func.__name__: v for v in validators}
+        else:
+            return None
+
+    def check_for_unused(self) -> None:
+        unused_validators = set(
+            chain.from_iterable(
+                (v.func.__name__ for v in self.validators[f] if v.check_fields)
+                for f in (self.validators.keys() - self.used_validators)
+            )
+        )
+        if unused_validators:
+            fn = ', '.join(unused_validators)
+            raise ConfigError(
+                f"Validators defined with incorrect fields: {fn} "  # noqa: Q000
+                f"(use check_fields=False if you're inheriting from the model and intended this)"
+            )
+
+
+def extract_validators(namespace: Dict[str, Any]) -> Dict[str, List[Validator]]:
+    validators: Dict[str, List[Validator]] = {}
+    for var_name, value in namespace.items():
+        validator_config = getattr(value, VALIDATOR_CONFIG_KEY, None)
+        if validator_config:
+            fields, v = validator_config
+            for field in fields:
+                if field in validators:
+                    validators[field].append(v)
+                else:
+                    validators[field] = [v]
+    return validators
+
+
+def extract_root_validators(namespace: Dict[str, Any]) -> Tuple[List[AnyCallable], List[Tuple[bool, AnyCallable]]]:
+    from inspect import signature
+
+    pre_validators: List[AnyCallable] = []
+    post_validators: List[Tuple[bool, AnyCallable]] = []
+    for name, value in namespace.items():
+        validator_config: Optional[Validator] = getattr(value, ROOT_VALIDATOR_CONFIG_KEY, None)
+        if validator_config:
+            sig = signature(validator_config.func)
+            args = list(sig.parameters.keys())
+            if args[0] == 'self':
+                raise ConfigError(
+                    f'Invalid signature for root validator {name}: {sig}, "self" not permitted as first argument, '
+                    f'should be: (cls, values).'
+                )
+            if len(args) != 2:
+                raise ConfigError(f'Invalid signature for root validator {name}: {sig}, should be: (cls, values).')
+            # check function signature
+            if validator_config.pre:
+                pre_validators.append(validator_config.func)
+            else:
+                post_validators.append((validator_config.skip_on_failure, validator_config.func))
+    return pre_validators, post_validators
+
+
+def inherit_validators(base_validators: 'ValidatorListDict', validators: 'ValidatorListDict') -> 'ValidatorListDict':
+    for field, field_validators in base_validators.items():
+        if field not in validators:
+            validators[field] = []
+        validators[field] += field_validators
+    return validators
+
+
+def make_generic_validator(validator: AnyCallable) -> 'ValidatorCallable':
+    """
+    Make a generic function which calls a validator with the right arguments.
+
+    Unfortunately other approaches (eg. return a partial of a function that builds the arguments) is slow,
+    hence this laborious way of doing things.
+
+    It's done like this so validators don't all need **kwargs in their signature, eg. any combination of
+    the arguments "values", "fields" and/or "config" are permitted.
+    """
+    from inspect import signature
+
+    sig = signature(validator)
+    args = list(sig.parameters.keys())
+    first_arg = args.pop(0)
+    if first_arg == 'self':
+        raise ConfigError(
+            f'Invalid signature for validator {validator}: {sig}, "self" not permitted as first argument, '
+            f'should be: (cls, value, values, config, field), "values", "config" and "field" are all optional.'
+        )
+    elif first_arg == 'cls':
+        # assume the second argument is value
+        return wraps(validator)(_generic_validator_cls(validator, sig, set(args[1:])))
+    else:
+        # assume the first argument was value which has already been removed
+        return wraps(validator)(_generic_validator_basic(validator, sig, set(args)))
+
+
+def prep_validators(v_funcs: Iterable[AnyCallable]) -> 'ValidatorsList':
+    return [make_generic_validator(f) for f in v_funcs if f]
+
+
+all_kwargs = {'values', 'field', 'config'}
+
+
+def _generic_validator_cls(validator: AnyCallable, sig: 'Signature', args: Set[str]) -> 'ValidatorCallable':
+    # assume the first argument is value
+    has_kwargs = False
+    if 'kwargs' in args:
+        has_kwargs = True
+        args -= {'kwargs'}
+
+    if not args.issubset(all_kwargs):
+        raise ConfigError(
+            f'Invalid signature for validator {validator}: {sig}, should be: '
+            f'(cls, value, values, config, field), "values", "config" and "field" are all optional.'
+        )
+
+    if has_kwargs:
+        return lambda cls, v, values, field, config: validator(cls, v, values=values, field=field, config=config)
+    elif args == set():
+        return lambda cls, v, values, field, config: validator(cls, v)
+    elif args == {'values'}:
+        return lambda cls, v, values, field, config: validator(cls, v, values=values)
+    elif args == {'field'}:
+        return lambda cls, v, values, field, config: validator(cls, v, field=field)
+    elif args == {'config'}:
+        return lambda cls, v, values, field, config: validator(cls, v, config=config)
+    elif args == {'values', 'field'}:
+        return lambda cls, v, values, field, config: validator(cls, v, values=values, field=field)
+    elif args == {'values', 'config'}:
+        return lambda cls, v, values, field, config: validator(cls, v, values=values, config=config)
+    elif args == {'field', 'config'}:
+        return lambda cls, v, values, field, config: validator(cls, v, field=field, config=config)
+    else:
+        # args == {'values', 'field', 'config'}
+        return lambda cls, v, values, field, config: validator(cls, v, values=values, field=field, config=config)
+
+
+def _generic_validator_basic(validator: AnyCallable, sig: 'Signature', args: Set[str]) -> 'ValidatorCallable':
+    has_kwargs = False
+    if 'kwargs' in args:
+        has_kwargs = True
+        args -= {'kwargs'}
+
+    if not args.issubset(all_kwargs):
+        raise ConfigError(
+            f'Invalid signature for validator {validator}: {sig}, should be: '
+            f'(value, values, config, field), "values", "config" and "field" are all optional.'
+        )
+
+    if has_kwargs:
+        return lambda cls, v, values, field, config: validator(v, values=values, field=field, config=config)
+    elif args == set():
+        return lambda cls, v, values, field, config: validator(v)
+    elif args == {'values'}:
+        return lambda cls, v, values, field, config: validator(v, values=values)
+    elif args == {'field'}:
+        return lambda cls, v, values, field, config: validator(v, field=field)
+    elif args == {'config'}:
+        return lambda cls, v, values, field, config: validator(v, config=config)
+    elif args == {'values', 'field'}:
+        return lambda cls, v, values, field, config: validator(v, values=values, field=field)
+    elif args == {'values', 'config'}:
+        return lambda cls, v, values, field, config: validator(v, values=values, config=config)
+    elif args == {'field', 'config'}:
+        return lambda cls, v, values, field, config: validator(v, field=field, config=config)
+    else:
+        # args == {'values', 'field', 'config'}
+        return lambda cls, v, values, field, config: validator(v, values=values, field=field, config=config)
+
+
+def gather_all_validators(type_: 'ModelOrDc') -> Dict[str, 'AnyClassMethod']:
+    all_attributes = ChainMap(*[cls.__dict__ for cls in type_.__mro__])  # type: ignore[arg-type,var-annotated]
+    return {
+        k: v
+        for k, v in all_attributes.items()
+        if hasattr(v, VALIDATOR_CONFIG_KEY) or hasattr(v, ROOT_VALIDATOR_CONFIG_KEY)
+    }
diff --git a/lib/pydantic/color.py b/lib/pydantic/color.py
index 108bb8fa..6fdc9fb1 100644
--- a/lib/pydantic/color.py
+++ b/lib/pydantic/color.py
@@ -1,28 +1,22 @@
-"""Color definitions are used as per the CSS3
-[CSS Color Module Level 3](http://www.w3.org/TR/css3-color/#svg-color) specification.
+"""
+Color definitions are  used as per CSS3 specification:
+http://www.w3.org/TR/css3-color/#svg-color
 
 A few colors have multiple names referring to the sames colors, eg. `grey` and `gray` or `aqua` and `cyan`.
 
-In these cases the _last_ color when sorted alphabetically takes preferences,
-eg. `Color((0, 255, 255)).as_named() == 'cyan'` because "cyan" comes after "aqua".
-
-Warning: Deprecated
-    The `Color` class is deprecated, use `pydantic_extra_types` instead.
-    See [`pydantic-extra-types.Color`](../usage/types/extra_types/color_types.md)
-    for more information.
+In these cases the LAST color when sorted alphabetically takes preferences,
+eg. Color((0, 255, 255)).as_named() == 'cyan' because "cyan" comes after "aqua".
 """
 import math
 import re
 from colorsys import hls_to_rgb, rgb_to_hls
-from typing import Any, Callable, Optional, Tuple, Type, Union, cast
+from typing import TYPE_CHECKING, Any, Dict, Optional, Tuple, Union, cast
 
-from pydantic_core import CoreSchema, PydanticCustomError, core_schema
-from typing_extensions import deprecated
+from .errors import ColorError
+from .utils import Representation, almost_equal_floats
 
-from ._internal import _repr
-from ._internal._schema_generation_shared import GetJsonSchemaHandler as _GetJsonSchemaHandler
-from .json_schema import JsonSchemaValue
-from .warnings import PydanticDeprecatedSince20
+if TYPE_CHECKING:
+    from .typing import CallableGenerator, ReprArgs
 
 ColorTuple = Union[Tuple[int, int, int], Tuple[int, int, int, float]]
 ColorType = Union[ColorTuple, str]
@@ -30,7 +24,9 @@ HslColorTuple = Union[Tuple[float, float, float], Tuple[float, float, float, flo
 
 
 class RGBA:
-    """Internal use only as a representation of a color."""
+    """
+    Internal use only as a representation of a color.
+    """
 
     __slots__ = 'r', 'g', 'b', 'alpha', '_tuple'
 
@@ -47,35 +43,24 @@ class RGBA:
 
 
 # these are not compiled here to avoid import slowdown, they'll be compiled the first time they're used, then cached
-_r_255 = r'(\d{1,3}(?:\.\d+)?)'
-_r_comma = r'\s*,\s*'
-_r_alpha = r'(\d(?:\.\d+)?|\.\d+|\d{1,2}%)'
-_r_h = r'(-?\d+(?:\.\d+)?|-?\.\d+)(deg|rad|turn)?'
-_r_sl = r'(\d{1,3}(?:\.\d+)?)%'
 r_hex_short = r'\s*(?:#|0x)?([0-9a-f])([0-9a-f])([0-9a-f])([0-9a-f])?\s*'
 r_hex_long = r'\s*(?:#|0x)?([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})?\s*'
-# CSS3 RGB examples: rgb(0, 0, 0), rgba(0, 0, 0, 0.5), rgba(0, 0, 0, 50%)
-r_rgb = rf'\s*rgba?\(\s*{_r_255}{_r_comma}{_r_255}{_r_comma}{_r_255}(?:{_r_comma}{_r_alpha})?\s*\)\s*'
-# CSS3 HSL examples: hsl(270, 60%, 50%), hsla(270, 60%, 50%, 0.5), hsla(270, 60%, 50%, 50%)
-r_hsl = rf'\s*hsla?\(\s*{_r_h}{_r_comma}{_r_sl}{_r_comma}{_r_sl}(?:{_r_comma}{_r_alpha})?\s*\)\s*'
-# CSS4 RGB examples: rgb(0 0 0), rgb(0 0 0 / 0.5), rgb(0 0 0 / 50%), rgba(0 0 0 / 50%)
-r_rgb_v4_style = rf'\s*rgba?\(\s*{_r_255}\s+{_r_255}\s+{_r_255}(?:\s*/\s*{_r_alpha})?\s*\)\s*'
-# CSS4 HSL examples: hsl(270 60% 50%), hsl(270 60% 50% / 0.5), hsl(270 60% 50% / 50%), hsla(270 60% 50% / 50%)
-r_hsl_v4_style = rf'\s*hsla?\(\s*{_r_h}\s+{_r_sl}\s+{_r_sl}(?:\s*/\s*{_r_alpha})?\s*\)\s*'
+_r_255 = r'(\d{1,3}(?:\.\d+)?)'
+_r_comma = r'\s*,\s*'
+r_rgb = fr'\s*rgb\(\s*{_r_255}{_r_comma}{_r_255}{_r_comma}{_r_255}\)\s*'
+_r_alpha = r'(\d(?:\.\d+)?|\.\d+|\d{1,2}%)'
+r_rgba = fr'\s*rgba\(\s*{_r_255}{_r_comma}{_r_255}{_r_comma}{_r_255}{_r_comma}{_r_alpha}\s*\)\s*'
+_r_h = r'(-?\d+(?:\.\d+)?|-?\.\d+)(deg|rad|turn)?'
+_r_sl = r'(\d{1,3}(?:\.\d+)?)%'
+r_hsl = fr'\s*hsl\(\s*{_r_h}{_r_comma}{_r_sl}{_r_comma}{_r_sl}\s*\)\s*'
+r_hsla = fr'\s*hsl\(\s*{_r_h}{_r_comma}{_r_sl}{_r_comma}{_r_sl}{_r_comma}{_r_alpha}\s*\)\s*'
 
 # colors where the two hex characters are the same, if all colors match this the short version of hex colors can be used
 repeat_colors = {int(c * 2, 16) for c in '0123456789abcdef'}
 rads = 2 * math.pi
 
 
-@deprecated(
-    'The `Color` class is deprecated, use `pydantic_extra_types` instead. '
-    'See https://docs.pydantic.dev/latest/api/pydantic_extra_types_color/.',
-    category=PydanticDeprecatedSince20,
-)
-class Color(_repr.Representation):
-    """Represents a color."""
-
+class Color(Representation):
     __slots__ = '_original', '_rgba'
 
     def __init__(self, value: ColorType) -> None:
@@ -89,39 +74,22 @@ class Color(_repr.Representation):
             self._rgba = value._rgba
             value = value._original
         else:
-            raise PydanticCustomError(
-                'color_error', 'value is not a valid color: value must be a tuple, list or string'
-            )
+            raise ColorError(reason='value must be a tuple, list or string')
 
         # if we've got here value must be a valid color
         self._original = value
 
     @classmethod
-    def __get_pydantic_json_schema__(
-        cls, core_schema: core_schema.CoreSchema, handler: _GetJsonSchemaHandler
-    ) -> JsonSchemaValue:
-        field_schema = {}
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
         field_schema.update(type='string', format='color')
-        return field_schema
 
     def original(self) -> ColorType:
-        """Original value passed to `Color`."""
+        """
+        Original value passed to Color
+        """
         return self._original
 
     def as_named(self, *, fallback: bool = False) -> str:
-        """Returns the name of the color if it can be found in `COLORS_BY_VALUE` dictionary,
-        otherwise returns the hexadecimal representation of the color or raises `ValueError`.
-
-        Args:
-            fallback: If True, falls back to returning the hexadecimal representation of
-                the color instead of raising a ValueError when no named color is found.
-
-        Returns:
-            The name of the color, or the hexadecimal representation of the color.
-
-        Raises:
-            ValueError: When no named color is found and fallback is `False`.
-        """
         if self._rgba.alpha is None:
             rgb = cast(Tuple[int, int, int], self.as_rgb_tuple())
             try:
@@ -135,13 +103,9 @@ class Color(_repr.Representation):
             return self.as_hex()
 
     def as_hex(self) -> str:
-        """Returns the hexadecimal representation of the color.
-
-        Hex string representing the color can be 3, 4, 6, or 8 characters depending on whether the string
+        """
+        Hex string representing the color can be 3, 4, 6 or 8 characters depending on whether the string
         a "short" representation of the color is possible and whether there's an alpha channel.
-
-        Returns:
-            The hexadecimal representation of the color.
         """
         values = [float_to_255(c) for c in self._rgba[:3]]
         if self._rgba.alpha is not None:
@@ -153,7 +117,9 @@ class Color(_repr.Representation):
         return '#' + as_hex
 
     def as_rgb(self) -> str:
-        """Color as an `rgb(<r>, <g>, <b>)` or `rgba(<r>, <g>, <b>, <a>)` string."""
+        """
+        Color as an rgb(<r>, <g>, <b>) or rgba(<r>, <g>, <b>, <a>) string.
+        """
         if self._rgba.alpha is None:
             return f'rgb({float_to_255(self._rgba.r)}, {float_to_255(self._rgba.g)}, {float_to_255(self._rgba.b)})'
         else:
@@ -163,18 +129,14 @@ class Color(_repr.Representation):
             )
 
     def as_rgb_tuple(self, *, alpha: Optional[bool] = None) -> ColorTuple:
-        """Returns the color as an RGB or RGBA tuple.
+        """
+        Color as an RGB or RGBA tuple; red, green and blue are in the range 0 to 255, alpha if included is
+        in the range 0 to 1.
 
-        Args:
-            alpha: Whether to include the alpha channel. There are three options for this input:
-
-                - `None` (default): Include alpha only if it's set. (e.g. not `None`)
-                - `True`: Always include alpha.
-                - `False`: Always omit alpha.
-
-        Returns:
-            A tuple that contains the values of the red, green, and blue channels in the range 0 to 255.
-                If alpha is included, it is in the range 0 to 1.
+        :param alpha: whether to include the alpha channel, options are
+          None - (default) include alpha only if it's set (e.g. not None)
+          True - always include alpha,
+          False - always omit alpha,
         """
         r, g, b = (float_to_255(c) for c in self._rgba[:3])
         if alpha is None:
@@ -189,7 +151,9 @@ class Color(_repr.Representation):
             return r, g, b
 
     def as_hsl(self) -> str:
-        """Color as an `hsl(<h>, <s>, <l>)` or `hsl(<h>, <s>, <l>, <a>)` string."""
+        """
+        Color as an hsl(<h>, <s>, <l>) or hsl(<h>, <s>, <l>, <a>) string.
+        """
         if self._rgba.alpha is None:
             h, s, li = self.as_hsl_tuple(alpha=False)  # type: ignore
             return f'hsl({h * 360:0.0f}, {s:0.0%}, {li:0.0%})'
@@ -198,23 +162,18 @@ class Color(_repr.Representation):
             return f'hsl({h * 360:0.0f}, {s:0.0%}, {li:0.0%}, {round(a, 2)})'
 
     def as_hsl_tuple(self, *, alpha: Optional[bool] = None) -> HslColorTuple:
-        """Returns the color as an HSL or HSLA tuple.
-
-        Args:
-            alpha: Whether to include the alpha channel.
-
-                - `None` (default): Include the alpha channel only if it's set (e.g. not `None`).
-                - `True`: Always include alpha.
-                - `False`: Always omit alpha.
-
-        Returns:
-            The color as a tuple of hue, saturation, lightness, and alpha (if included).
-                All elements are in the range 0 to 1.
-
-        Note:
-            This is HSL as used in HTML and most other places, not HLS as used in Python's `colorsys`.
         """
-        h, l, s = rgb_to_hls(self._rgba.r, self._rgba.g, self._rgba.b)  # noqa: E741
+        Color as an HSL or HSLA tuple, e.g. hue, saturation, lightness and optionally alpha; all elements are in
+        the range 0 to 1.
+
+        NOTE: this is HSL as used in HTML and most other places, not HLS as used in python's colorsys.
+
+        :param alpha: whether to include the alpha channel, options are
+          None - (default) include alpha only if it's set (e.g. not None)
+          True - always include alpha,
+          False - always omit alpha,
+        """
+        h, l, s = rgb_to_hls(self._rgba.r, self._rgba.g, self._rgba.b)
         if alpha is None:
             if self._rgba.alpha is None:
                 return h, s, l
@@ -230,22 +189,14 @@ class Color(_repr.Representation):
         return 1 if self._rgba.alpha is None else self._rgba.alpha
 
     @classmethod
-    def __get_pydantic_core_schema__(
-        cls, source: Type[Any], handler: Callable[[Any], CoreSchema]
-    ) -> core_schema.CoreSchema:
-        return core_schema.with_info_plain_validator_function(
-            cls._validate, serialization=core_schema.to_string_ser_schema()
-        )
-
-    @classmethod
-    def _validate(cls, __input_value: Any, _: Any) -> 'Color':
-        return cls(__input_value)
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield cls
 
     def __str__(self) -> str:
         return self.as_named(fallback=True)
 
-    def __repr_args__(self) -> '_repr.ReprArgs':
-        return [(None, self.as_named(fallback=True))] + [('rgb', self.as_rgb_tuple())]
+    def __repr_args__(self) -> 'ReprArgs':
+        return [(None, self.as_named(fallback=True))] + [('rgb', self.as_rgb_tuple())]  # type: ignore
 
     def __eq__(self, other: Any) -> bool:
         return isinstance(other, Color) and self.as_rgb_tuple() == other.as_rgb_tuple()
@@ -255,16 +206,8 @@ class Color(_repr.Representation):
 
 
 def parse_tuple(value: Tuple[Any, ...]) -> RGBA:
-    """Parse a tuple or list to get RGBA values.
-
-    Args:
-        value: A tuple or list.
-
-    Returns:
-        An `RGBA` tuple parsed from the input tuple.
-
-    Raises:
-        PydanticCustomError: If tuple is not valid.
+    """
+    Parse a tuple or list as a color.
     """
     if len(value) == 3:
         r, g, b = (parse_color_value(v) for v in value)
@@ -273,28 +216,17 @@ def parse_tuple(value: Tuple[Any, ...]) -> RGBA:
         r, g, b = (parse_color_value(v) for v in value[:3])
         return RGBA(r, g, b, parse_float_alpha(value[3]))
     else:
-        raise PydanticCustomError('color_error', 'value is not a valid color: tuples must have length 3 or 4')
+        raise ColorError(reason='tuples must have length 3 or 4')
 
 
 def parse_str(value: str) -> RGBA:
-    """Parse a string representing a color to an RGBA tuple.
-
-    Possible formats for the input string include:
-
-    * named color, see `COLORS_BY_NAME`
+    """
+    Parse a string to an RGBA tuple, trying the following formats (in this order):
+    * named color, see COLORS_BY_NAME below
     * hex short eg. `<prefix>fff` (prefix can be `#`, `0x` or nothing)
     * hex long eg. `<prefix>ffffff` (prefix can be `#`, `0x` or nothing)
-    * `rgb(<r>, <g>, <b>)`
+    * `rgb(<r>, <g>, <b>) `
     * `rgba(<r>, <g>, <b>, <a>)`
-
-    Args:
-        value: A string representing a color.
-
-    Returns:
-        An `RGBA` tuple parsed from the input string.
-
-    Raises:
-        ValueError: If the input string cannot be parsed to an RGBA tuple.
     """
     value_lower = value.lower()
     try:
@@ -324,70 +256,49 @@ def parse_str(value: str) -> RGBA:
             alpha = None
         return ints_to_rgba(r, g, b, alpha)
 
-    m = re.fullmatch(r_rgb, value_lower) or re.fullmatch(r_rgb_v4_style, value_lower)
+    m = re.fullmatch(r_rgb, value_lower)
+    if m:
+        return ints_to_rgba(*m.groups(), None)  # type: ignore
+
+    m = re.fullmatch(r_rgba, value_lower)
     if m:
         return ints_to_rgba(*m.groups())  # type: ignore
 
-    m = re.fullmatch(r_hsl, value_lower) or re.fullmatch(r_hsl_v4_style, value_lower)
+    m = re.fullmatch(r_hsl, value_lower)
     if m:
-        return parse_hsl(*m.groups())  # type: ignore
+        h, h_units, s, l_ = m.groups()
+        return parse_hsl(h, h_units, s, l_)
 
-    raise PydanticCustomError('color_error', 'value is not a valid color: string not recognised as a valid color')
+    m = re.fullmatch(r_hsla, value_lower)
+    if m:
+        h, h_units, s, l_, a = m.groups()
+        return parse_hsl(h, h_units, s, l_, parse_float_alpha(a))
+
+    raise ColorError(reason='string not recognised as a valid color')
 
 
-def ints_to_rgba(r: Union[int, str], g: Union[int, str], b: Union[int, str], alpha: Optional[float] = None) -> RGBA:
-    """Converts integer or string values for RGB color and an optional alpha value to an `RGBA` object.
-
-    Args:
-        r: An integer or string representing the red color value.
-        g: An integer or string representing the green color value.
-        b: An integer or string representing the blue color value.
-        alpha: A float representing the alpha value. Defaults to None.
-
-    Returns:
-        An instance of the `RGBA` class with the corresponding color and alpha values.
-    """
+def ints_to_rgba(r: Union[int, str], g: Union[int, str], b: Union[int, str], alpha: Optional[float]) -> RGBA:
     return RGBA(parse_color_value(r), parse_color_value(g), parse_color_value(b), parse_float_alpha(alpha))
 
 
 def parse_color_value(value: Union[int, str], max_val: int = 255) -> float:
-    """Parse the color value provided and return a number between 0 and 1.
-
-    Args:
-        value: An integer or string color value.
-        max_val: Maximum range value. Defaults to 255.
-
-    Raises:
-        PydanticCustomError: If the value is not a valid color.
-
-    Returns:
-        A number between 0 and 1.
+    """
+    Parse a value checking it's a valid int in the range 0 to max_val and divide by max_val to give a number
+    in the range 0 to 1
     """
     try:
         color = float(value)
     except ValueError:
-        raise PydanticCustomError('color_error', 'value is not a valid color: color values must be a valid number')
+        raise ColorError(reason='color values must be a valid number')
     if 0 <= color <= max_val:
         return color / max_val
     else:
-        raise PydanticCustomError(
-            'color_error',
-            'value is not a valid color: color values must be in the range 0 to {max_val}',
-            {'max_val': max_val},
-        )
+        raise ColorError(reason=f'color values must be in the range 0 to {max_val}')
 
 
 def parse_float_alpha(value: Union[None, str, float, int]) -> Optional[float]:
-    """Parse an alpha value checking it's a valid float in the range 0 to 1.
-
-    Args:
-        value: The input value to parse.
-
-    Returns:
-        The parsed value as a float, or `None` if the value was None or equal 1.
-
-    Raises:
-        PydanticCustomError: If the input value cannot be successfully parsed as a float in the expected range.
+    """
+    Parse a value checking it's a valid float in the range 0 to 1
     """
     if value is None:
         return None
@@ -397,28 +308,19 @@ def parse_float_alpha(value: Union[None, str, float, int]) -> Optional[float]:
         else:
             alpha = float(value)
     except ValueError:
-        raise PydanticCustomError('color_error', 'value is not a valid color: alpha values must be a valid float')
+        raise ColorError(reason='alpha values must be a valid float')
 
-    if math.isclose(alpha, 1):
+    if almost_equal_floats(alpha, 1):
         return None
     elif 0 <= alpha <= 1:
         return alpha
     else:
-        raise PydanticCustomError('color_error', 'value is not a valid color: alpha values must be in the range 0 to 1')
+        raise ColorError(reason='alpha values must be in the range 0 to 1')
 
 
 def parse_hsl(h: str, h_units: str, sat: str, light: str, alpha: Optional[float] = None) -> RGBA:
-    """Parse raw hue, saturation, lightness, and alpha values and convert to RGBA.
-
-    Args:
-        h: The hue value.
-        h_units: The unit for hue value.
-        sat: The saturation value.
-        light: The lightness value.
-        alpha: Alpha value.
-
-    Returns:
-        An instance of `RGBA`.
+    """
+    Parse raw hue, saturation, lightness and alpha values and convert to RGBA.
     """
     s_value, l_value = parse_color_value(sat, 100), parse_color_value(light, 100)
 
@@ -432,21 +334,10 @@ def parse_hsl(h: str, h_units: str, sat: str, light: str, alpha: Optional[float]
         h_value = h_value % 1
 
     r, g, b = hls_to_rgb(h_value, l_value, s_value)
-    return RGBA(r, g, b, parse_float_alpha(alpha))
+    return RGBA(r, g, b, alpha)
 
 
 def float_to_255(c: float) -> int:
-    """Converts a float value between 0 and 1 (inclusive) to an integer between 0 and 255 (inclusive).
-
-    Args:
-        c: The float value to be converted. Must be between 0 and 1 (inclusive).
-
-    Returns:
-        The integer equivalent of the given float value rounded to the nearest whole number.
-
-    Raises:
-        ValueError: If the given float value is outside the acceptable range of 0 to 1 (inclusive).
-    """
     return int(round(c * 255))
 
 
diff --git a/lib/pydantic/config.py b/lib/pydantic/config.py
index 6b22586b..74687ca0 100644
--- a/lib/pydantic/config.py
+++ b/lib/pydantic/config.py
@@ -1,912 +1,192 @@
-"""Configuration for Pydantic models."""
-from __future__ import annotations as _annotations
+import json
+from enum import Enum
+from typing import TYPE_CHECKING, Any, Callable, Dict, ForwardRef, Optional, Tuple, Type, Union
 
-from typing import TYPE_CHECKING, Any, Callable, Dict, List, Type, Union
+from typing_extensions import Literal, Protocol
 
-from typing_extensions import Literal, TypeAlias, TypedDict
-
-from ._migration import getattr_migration
-from .aliases import AliasGenerator
+from .typing import AnyArgTCallable, AnyCallable
+from .utils import GetterDict
+from .version import compiled
 
 if TYPE_CHECKING:
-    from ._internal._generate_schema import GenerateSchema as _GenerateSchema
-
-__all__ = ('ConfigDict',)
-
-
-JsonValue: TypeAlias = Union[int, float, str, bool, None, List['JsonValue'], 'JsonDict']
-JsonDict: TypeAlias = Dict[str, JsonValue]
-
-JsonEncoder = Callable[[Any], Any]
-
-JsonSchemaExtraCallable: TypeAlias = Union[
-    Callable[[JsonDict], None],
-    Callable[[JsonDict, Type[Any]], None],
-]
-
-ExtraValues = Literal['allow', 'ignore', 'forbid']
-
-
-class ConfigDict(TypedDict, total=False):
-    """A TypedDict for configuring Pydantic behaviour."""
-
-    title: str | None
-    """The title for the generated JSON schema, defaults to the model's name"""
-
-    str_to_lower: bool
-    """Whether to convert all characters to lowercase for str types. Defaults to `False`."""
-
-    str_to_upper: bool
-    """Whether to convert all characters to uppercase for str types. Defaults to `False`."""
-    str_strip_whitespace: bool
-    """Whether to strip leading and trailing whitespace for str types."""
-
-    str_min_length: int
-    """The minimum length for str types. Defaults to `None`."""
-
-    str_max_length: int | None
-    """The maximum length for str types. Defaults to `None`."""
-
-    extra: ExtraValues | None
-    """
-    Whether to ignore, allow, or forbid extra attributes during model initialization. Defaults to `'ignore'`.
-
-    You can configure how pydantic handles the attributes that are not defined in the model:
-
-    * `allow` - Allow any extra attributes.
-    * `forbid` - Forbid any extra attributes.
-    * `ignore` - Ignore any extra attributes.
-
-    ```py
-    from pydantic import BaseModel, ConfigDict
-
-
-    class User(BaseModel):
-        model_config = ConfigDict(extra='ignore')  # (1)!
-
-        name: str
-
-
-    user = User(name='John Doe', age=20)  # (2)!
-    print(user)
-    #> name='John Doe'
-    ```
-
-    1. This is the default behaviour.
-    2. The `age` argument is ignored.
-
-    Instead, with `extra='allow'`, the `age` argument is included:
-
-    ```py
-    from pydantic import BaseModel, ConfigDict
-
-
-    class User(BaseModel):
-        model_config = ConfigDict(extra='allow')
-
-        name: str
-
-
-    user = User(name='John Doe', age=20)  # (1)!
-    print(user)
-    #> name='John Doe' age=20
-    ```
-
-    1. The `age` argument is included.
-
-    With `extra='forbid'`, an error is raised:
-
-    ```py
-    from pydantic import BaseModel, ConfigDict, ValidationError
-
-
-    class User(BaseModel):
-        model_config = ConfigDict(extra='forbid')
-
-        name: str
-
-
-    try:
-        User(name='John Doe', age=20)
-    except ValidationError as e:
-        print(e)
-        '''
-        1 validation error for User
-        age
-        Extra inputs are not permitted [type=extra_forbidden, input_value=20, input_type=int]
-        '''
-    ```
-    """
-
-    frozen: bool
-    """
-    Whether models are faux-immutable, i.e. whether `__setattr__` is allowed, and also generates
-    a `__hash__()` method for the model. This makes instances of the model potentially hashable if all the
-    attributes are hashable. Defaults to `False`.
-
-    Note:
-        On V1, the inverse of this setting was called `allow_mutation`, and was `True` by default.
-    """
-
-    populate_by_name: bool
-    """
-    Whether an aliased field may be populated by its name as given by the model
-    attribute, as well as the alias. Defaults to `False`.
-
-    Note:
-        The name of this configuration setting was changed in **v2.0** from
-        `allow_population_by_field_name` to `populate_by_name`.
-
-    ```py
-    from pydantic import BaseModel, ConfigDict, Field
-
-
-    class User(BaseModel):
-        model_config = ConfigDict(populate_by_name=True)
-
-        name: str = Field(alias='full_name')  # (1)!
-        age: int
-
-
-    user = User(full_name='John Doe', age=20)  # (2)!
-    print(user)
-    #> name='John Doe' age=20
-    user = User(name='John Doe', age=20)  # (3)!
-    print(user)
-    #> name='John Doe' age=20
-    ```
-
-    1. The field `'name'` has an alias `'full_name'`.
-    2. The model is populated by the alias `'full_name'`.
-    3. The model is populated by the field name `'name'`.
-    """
-
-    use_enum_values: bool
-    """
-    Whether to populate models with the `value` property of enums, rather than the raw enum.
-    This may be useful if you want to serialize `model.model_dump()` later. Defaults to `False`.
-
-    !!! note
-        If you have an `Optional[Enum]` value that you set a default for, you need to use `validate_default=True`
-        for said Field to ensure that the `use_enum_values` flag takes effect on the default, as extracting an
-        enum's value occurs during validation, not serialization.
-
-    ```py
-    from enum import Enum
-    from typing import Optional
-
-    from pydantic import BaseModel, ConfigDict, Field
-
-
-    class SomeEnum(Enum):
-        FOO = 'foo'
-        BAR = 'bar'
-        BAZ = 'baz'
-
-
-    class SomeModel(BaseModel):
-        model_config = ConfigDict(use_enum_values=True)
-
-        some_enum: SomeEnum
-        another_enum: Optional[SomeEnum] = Field(default=SomeEnum.FOO, validate_default=True)
-
-
-    model1 = SomeModel(some_enum=SomeEnum.BAR)
-    print(model1.model_dump())
-    # {'some_enum': 'bar', 'another_enum': 'foo'}
-
-    model2 = SomeModel(some_enum=SomeEnum.BAR, another_enum=SomeEnum.BAZ)
-    print(model2.model_dump())
-    #> {'some_enum': 'bar', 'another_enum': 'baz'}
-    ```
-    """
-
-    validate_assignment: bool
-    """
-    Whether to validate the data when the model is changed. Defaults to `False`.
-
-    The default behavior of Pydantic is to validate the data when the model is created.
-
-    In case the user changes the data after the model is created, the model is _not_ revalidated.
-
-    ```py
-    from pydantic import BaseModel
-
-    class User(BaseModel):
-        name: str
-
-    user = User(name='John Doe')  # (1)!
-    print(user)
-    #> name='John Doe'
-    user.name = 123  # (1)!
-    print(user)
-    #> name=123
-    ```
-
-    1. The validation happens only when the model is created.
-    2. The validation does not happen when the data is changed.
-
-    In case you want to revalidate the model when the data is changed, you can use `validate_assignment=True`:
-
-    ```py
-    from pydantic import BaseModel, ValidationError
-
-    class User(BaseModel, validate_assignment=True):  # (1)!
-        name: str
-
-    user = User(name='John Doe')  # (2)!
-    print(user)
-    #> name='John Doe'
-    try:
-        user.name = 123  # (3)!
-    except ValidationError as e:
-        print(e)
-        '''
-        1 validation error for User
-        name
-          Input should be a valid string [type=string_type, input_value=123, input_type=int]
-        '''
-    ```
-
-    1. You can either use class keyword arguments, or `model_config` to set `validate_assignment=True`.
-    2. The validation happens when the model is created.
-    3. The validation _also_ happens when the data is changed.
-    """
-
-    arbitrary_types_allowed: bool
-    """
-    Whether arbitrary types are allowed for field types. Defaults to `False`.
-
-    ```py
-    from pydantic import BaseModel, ConfigDict, ValidationError
-
-    # This is not a pydantic model, it's an arbitrary class
-    class Pet:
-        def __init__(self, name: str):
-            self.name = name
-
-    class Model(BaseModel):
-        model_config = ConfigDict(arbitrary_types_allowed=True)
-
-        pet: Pet
-        owner: str
-
-    pet = Pet(name='Hedwig')
-    # A simple check of instance type is used to validate the data
-    model = Model(owner='Harry', pet=pet)
-    print(model)
-    #> pet=<__main__.Pet object at 0x0123456789ab> owner='Harry'
-    print(model.pet)
-    #> <__main__.Pet object at 0x0123456789ab>
-    print(model.pet.name)
-    #> Hedwig
-    print(type(model.pet))
-    #> <class '__main__.Pet'>
-    try:
-        # If the value is not an instance of the type, it's invalid
-        Model(owner='Harry', pet='Hedwig')
-    except ValidationError as e:
-        print(e)
-        '''
-        1 validation error for Model
-        pet
-          Input should be an instance of Pet [type=is_instance_of, input_value='Hedwig', input_type=str]
-        '''
-
-    # Nothing in the instance of the arbitrary type is checked
-    # Here name probably should have been a str, but it's not validated
-    pet2 = Pet(name=42)
-    model2 = Model(owner='Harry', pet=pet2)
-    print(model2)
-    #> pet=<__main__.Pet object at 0x0123456789ab> owner='Harry'
-    print(model2.pet)
-    #> <__main__.Pet object at 0x0123456789ab>
-    print(model2.pet.name)
-    #> 42
-    print(type(model2.pet))
-    #> <class '__main__.Pet'>
-    ```
-    """
-
-    from_attributes: bool
-    """
-    Whether to build models and look up discriminators of tagged unions using python object attributes.
-    """
-
-    loc_by_alias: bool
-    """Whether to use the actual key provided in the data (e.g. alias) for error `loc`s rather than the field's name. Defaults to `True`."""
-
-    alias_generator: Callable[[str], str] | AliasGenerator | None
-    """
-    A callable that takes a field name and returns an alias for it
-    or an instance of [`AliasGenerator`][pydantic.aliases.AliasGenerator]. Defaults to `None`.
-
-    When using a callable, the alias generator is used for both validation and serialization.
-    If you want to use different alias generators for validation and serialization, you can use
-    [`AliasGenerator`][pydantic.aliases.AliasGenerator] instead.
-
-    If data source field names do not match your code style (e. g. CamelCase fields),
-    you can automatically generate aliases using `alias_generator`. Here's an example with
-    a basic callable:
-
-    ```py
-    from pydantic import BaseModel, ConfigDict
-    from pydantic.alias_generators import to_pascal
-
-    class Voice(BaseModel):
-        model_config = ConfigDict(alias_generator=to_pascal)
-
-        name: str
-        language_code: str
-
-    voice = Voice(Name='Filiz', LanguageCode='tr-TR')
-    print(voice.language_code)
-    #> tr-TR
-    print(voice.model_dump(by_alias=True))
-    #> {'Name': 'Filiz', 'LanguageCode': 'tr-TR'}
-    ```
-
-    If you want to use different alias generators for validation and serialization, you can use
-    [`AliasGenerator`][pydantic.aliases.AliasGenerator].
-
-    ```py
-    from pydantic import AliasGenerator, BaseModel, ConfigDict
-    from pydantic.alias_generators import to_camel, to_pascal
-
-    class Athlete(BaseModel):
-        first_name: str
-        last_name: str
-        sport: str
-
-        model_config = ConfigDict(
-            alias_generator=AliasGenerator(
-                validation_alias=to_camel,
-                serialization_alias=to_pascal,
-            )
+    from typing import overload
+
+    from .fields import ModelField
+    from .main import BaseModel
+
+    ConfigType = Type['BaseConfig']
+
+    class SchemaExtraCallable(Protocol):
+        @overload
+        def __call__(self, schema: Dict[str, Any]) -> None:
+            pass
+
+        @overload
+        def __call__(self, schema: Dict[str, Any], model_class: Type[BaseModel]) -> None:
+            pass
+
+else:
+    SchemaExtraCallable = Callable[..., None]
+
+__all__ = 'BaseConfig', 'ConfigDict', 'get_config', 'Extra', 'inherit_config', 'prepare_config'
+
+
+class Extra(str, Enum):
+    allow = 'allow'
+    ignore = 'ignore'
+    forbid = 'forbid'
+
+
+# https://github.com/cython/cython/issues/4003
+# Will be fixed with Cython 3 but still in alpha right now
+if not compiled:
+    from typing_extensions import TypedDict
+
+    class ConfigDict(TypedDict, total=False):
+        title: Optional[str]
+        anystr_lower: bool
+        anystr_strip_whitespace: bool
+        min_anystr_length: int
+        max_anystr_length: Optional[int]
+        validate_all: bool
+        extra: Extra
+        allow_mutation: bool
+        frozen: bool
+        allow_population_by_field_name: bool
+        use_enum_values: bool
+        fields: Dict[str, Union[str, Dict[str, str]]]
+        validate_assignment: bool
+        error_msg_templates: Dict[str, str]
+        arbitrary_types_allowed: bool
+        orm_mode: bool
+        getter_dict: Type[GetterDict]
+        alias_generator: Optional[Callable[[str], str]]
+        keep_untouched: Tuple[type, ...]
+        schema_extra: Union[Dict[str, object], 'SchemaExtraCallable']
+        json_loads: Callable[[str], object]
+        json_dumps: AnyArgTCallable[str]
+        json_encoders: Dict[Type[object], AnyCallable]
+        underscore_attrs_are_private: bool
+        allow_inf_nan: bool
+
+        # whether or not inherited models as fields should be reconstructed as base model
+        copy_on_model_validation: bool
+        # whether dataclass `__post_init__` should be run after validation
+        post_init_call: Literal['before_validation', 'after_validation']
+
+else:
+    ConfigDict = dict  # type: ignore
+
+
+class BaseConfig:
+    title: Optional[str] = None
+    anystr_lower: bool = False
+    anystr_upper: bool = False
+    anystr_strip_whitespace: bool = False
+    min_anystr_length: int = 0
+    max_anystr_length: Optional[int] = None
+    validate_all: bool = False
+    extra: Extra = Extra.ignore
+    allow_mutation: bool = True
+    frozen: bool = False
+    allow_population_by_field_name: bool = False
+    use_enum_values: bool = False
+    fields: Dict[str, Union[str, Dict[str, str]]] = {}
+    validate_assignment: bool = False
+    error_msg_templates: Dict[str, str] = {}
+    arbitrary_types_allowed: bool = False
+    orm_mode: bool = False
+    getter_dict: Type[GetterDict] = GetterDict
+    alias_generator: Optional[Callable[[str], str]] = None
+    keep_untouched: Tuple[type, ...] = ()
+    schema_extra: Union[Dict[str, Any], 'SchemaExtraCallable'] = {}
+    json_loads: Callable[[str], Any] = json.loads
+    json_dumps: Callable[..., str] = json.dumps
+    json_encoders: Dict[Union[Type[Any], str, ForwardRef], AnyCallable] = {}
+    underscore_attrs_are_private: bool = False
+    allow_inf_nan: bool = True
+
+    # whether inherited models as fields should be reconstructed as base model,
+    # and whether such a copy should be shallow or deep
+    copy_on_model_validation: Literal['none', 'deep', 'shallow'] = 'shallow'
+
+    # whether `Union` should check all allowed types before even trying to coerce
+    smart_union: bool = False
+    # whether dataclass `__post_init__` should be run before or after validation
+    post_init_call: Literal['before_validation', 'after_validation'] = 'before_validation'
+
+    @classmethod
+    def get_field_info(cls, name: str) -> Dict[str, Any]:
+        """
+        Get properties of FieldInfo from the `fields` property of the config class.
+        """
+
+        fields_value = cls.fields.get(name)
+
+        if isinstance(fields_value, str):
+            field_info: Dict[str, Any] = {'alias': fields_value}
+        elif isinstance(fields_value, dict):
+            field_info = fields_value
+        else:
+            field_info = {}
+
+        if 'alias' in field_info:
+            field_info.setdefault('alias_priority', 2)
+
+        if field_info.get('alias_priority', 0) <= 1 and cls.alias_generator:
+            alias = cls.alias_generator(name)
+            if not isinstance(alias, str):
+                raise TypeError(f'Config.alias_generator must return str, not {alias.__class__}')
+            field_info.update(alias=alias, alias_priority=1)
+        return field_info
+
+    @classmethod
+    def prepare_field(cls, field: 'ModelField') -> None:
+        """
+        Optional hook to check or modify fields during model creation.
+        """
+        pass
+
+
+def get_config(config: Union[ConfigDict, Type[object], None]) -> Type[BaseConfig]:
+    if config is None:
+        return BaseConfig
+
+    else:
+        config_dict = (
+            config
+            if isinstance(config, dict)
+            else {k: getattr(config, k) for k in dir(config) if not k.startswith('__')}
         )
 
-    athlete = Athlete(firstName='John', lastName='Doe', sport='track')
-    print(athlete.model_dump(by_alias=True))
-    #> {'FirstName': 'John', 'LastName': 'Doe', 'Sport': 'track'}
-    ```
-
-    Note:
-        Pydantic offers three built-in alias generators: [`to_pascal`][pydantic.alias_generators.to_pascal],
-        [`to_camel`][pydantic.alias_generators.to_camel], and [`to_snake`][pydantic.alias_generators.to_snake].
-    """
-
-    ignored_types: tuple[type, ...]
-    """A tuple of types that may occur as values of class attributes without annotations. This is
-    typically used for custom descriptors (classes that behave like `property`). If an attribute is set on a
-    class without an annotation and has a type that is not in this tuple (or otherwise recognized by
-    _pydantic_), an error will be raised. Defaults to `()`.
-    """
-
-    allow_inf_nan: bool
-    """Whether to allow infinity (`+inf` an `-inf`) and NaN values to float fields. Defaults to `True`."""
-
-    json_schema_extra: JsonDict | JsonSchemaExtraCallable | None
-    """A dict or callable to provide extra JSON schema properties. Defaults to `None`."""
-
-    json_encoders: dict[type[object], JsonEncoder] | None
-    """
-    A `dict` of custom JSON encoders for specific types. Defaults to `None`.
-
-    !!! warning "Deprecated"
-        This config option is a carryover from v1.
-        We originally planned to remove it in v2 but didn't have a 1:1 replacement so we are keeping it for now.
-        It is still deprecated and will likely be removed in the future.
-    """
-
-    # new in V2
-    strict: bool
-    """
-    _(new in V2)_ If `True`, strict validation is applied to all fields on the model.
-
-    By default, Pydantic attempts to coerce values to the correct type, when possible.
-
-    There are situations in which you may want to disable this behavior, and instead raise an error if a value's type
-    does not match the field's type annotation.
-
-    To configure strict mode for all fields on a model, you can set `strict=True` on the model.
-
-    ```py
-    from pydantic import BaseModel, ConfigDict
-
-    class Model(BaseModel):
-        model_config = ConfigDict(strict=True)
-
-        name: str
-        age: int
-    ```
-
-    See [Strict Mode](../concepts/strict_mode.md) for more details.
-
-    See the [Conversion Table](../concepts/conversion_table.md) for more details on how Pydantic converts data in both
-    strict and lax modes.
-    """
-    # whether instances of models and dataclasses (including subclass instances) should re-validate, default 'never'
-    revalidate_instances: Literal['always', 'never', 'subclass-instances']
-    """
-    When and how to revalidate models and dataclasses during validation. Accepts the string
-    values of `'never'`, `'always'` and `'subclass-instances'`. Defaults to `'never'`.
-
-    - `'never'` will not revalidate models and dataclasses during validation
-    - `'always'` will revalidate models and dataclasses during validation
-    - `'subclass-instances'` will revalidate models and dataclasses during validation if the instance is a
-        subclass of the model or dataclass
-
-    By default, model and dataclass instances are not revalidated during validation.
-
-    ```py
-    from typing import List
-
-    from pydantic import BaseModel
-
-    class User(BaseModel, revalidate_instances='never'):  # (1)!
-        hobbies: List[str]
-
-    class SubUser(User):
-        sins: List[str]
-
-    class Transaction(BaseModel):
-        user: User
-
-    my_user = User(hobbies=['reading'])
-    t = Transaction(user=my_user)
-    print(t)
-    #> user=User(hobbies=['reading'])
-
-    my_user.hobbies = [1]  # (2)!
-    t = Transaction(user=my_user)  # (3)!
-    print(t)
-    #> user=User(hobbies=[1])
-
-    my_sub_user = SubUser(hobbies=['scuba diving'], sins=['lying'])
-    t = Transaction(user=my_sub_user)
-    print(t)
-    #> user=SubUser(hobbies=['scuba diving'], sins=['lying'])
-    ```
-
-    1. `revalidate_instances` is set to `'never'` by **default.
-    2. The assignment is not validated, unless you set `validate_assignment` to `True` in the model's config.
-    3. Since `revalidate_instances` is set to `never`, this is not revalidated.
-
-    If you want to revalidate instances during validation, you can set `revalidate_instances` to `'always'`
-    in the model's config.
-
-    ```py
-    from typing import List
-
-    from pydantic import BaseModel, ValidationError
-
-    class User(BaseModel, revalidate_instances='always'):  # (1)!
-        hobbies: List[str]
-
-    class SubUser(User):
-        sins: List[str]
-
-    class Transaction(BaseModel):
-        user: User
-
-    my_user = User(hobbies=['reading'])
-    t = Transaction(user=my_user)
-    print(t)
-    #> user=User(hobbies=['reading'])
-
-    my_user.hobbies = [1]
-    try:
-        t = Transaction(user=my_user)  # (2)!
-    except ValidationError as e:
-        print(e)
-        '''
-        1 validation error for Transaction
-        user.hobbies.0
-          Input should be a valid string [type=string_type, input_value=1, input_type=int]
-        '''
-
-    my_sub_user = SubUser(hobbies=['scuba diving'], sins=['lying'])
-    t = Transaction(user=my_sub_user)
-    print(t)  # (3)!
-    #> user=User(hobbies=['scuba diving'])
-    ```
-
-    1. `revalidate_instances` is set to `'always'`.
-    2. The model is revalidated, since `revalidate_instances` is set to `'always'`.
-    3. Using `'never'` we would have gotten `user=SubUser(hobbies=['scuba diving'], sins=['lying'])`.
-
-    It's also possible to set `revalidate_instances` to `'subclass-instances'` to only revalidate instances
-    of subclasses of the model.
-
-    ```py
-    from typing import List
-
-    from pydantic import BaseModel
-
-    class User(BaseModel, revalidate_instances='subclass-instances'):  # (1)!
-        hobbies: List[str]
-
-    class SubUser(User):
-        sins: List[str]
-
-    class Transaction(BaseModel):
-        user: User
-
-    my_user = User(hobbies=['reading'])
-    t = Transaction(user=my_user)
-    print(t)
-    #> user=User(hobbies=['reading'])
-
-    my_user.hobbies = [1]
-    t = Transaction(user=my_user)  # (2)!
-    print(t)
-    #> user=User(hobbies=[1])
-
-    my_sub_user = SubUser(hobbies=['scuba diving'], sins=['lying'])
-    t = Transaction(user=my_sub_user)
-    print(t)  # (3)!
-    #> user=User(hobbies=['scuba diving'])
-    ```
-
-    1. `revalidate_instances` is set to `'subclass-instances'`.
-    2. This is not revalidated, since `my_user` is not a subclass of `User`.
-    3. Using `'never'` we would have gotten `user=SubUser(hobbies=['scuba diving'], sins=['lying'])`.
-    """
-
-    ser_json_timedelta: Literal['iso8601', 'float']
-    """
-    The format of JSON serialized timedeltas. Accepts the string values of `'iso8601'` and
-    `'float'`. Defaults to `'iso8601'`.
-
-    - `'iso8601'` will serialize timedeltas to ISO 8601 durations.
-    - `'float'` will serialize timedeltas to the total number of seconds.
-    """
-
-    ser_json_bytes: Literal['utf8', 'base64']
-    """
-    The encoding of JSON serialized bytes. Accepts the string values of `'utf8'` and `'base64'`.
-    Defaults to `'utf8'`.
-
-    - `'utf8'` will serialize bytes to UTF-8 strings.
-    - `'base64'` will serialize bytes to URL safe base64 strings.
-    """
-
-    ser_json_inf_nan: Literal['null', 'constants']
-    """
-    The encoding of JSON serialized infinity and NaN float values. Accepts the string values of `'null'` and `'constants'`.
-    Defaults to `'null'`.
-
-    - `'null'` will serialize infinity and NaN values as `null`.
-    - `'constants'` will serialize infinity and NaN values as `Infinity` and `NaN`.
-    """
-
-    # whether to validate default values during validation, default False
-    validate_default: bool
-    """Whether to validate default values during validation. Defaults to `False`."""
-
-    validate_return: bool
-    """whether to validate the return value from call validators. Defaults to `False`."""
-
-    protected_namespaces: tuple[str, ...]
-    """
-    A `tuple` of strings that prevent model to have field which conflict with them.
-    Defaults to `('model_', )`).
-
-    Pydantic prevents collisions between model attributes and `BaseModel`'s own methods by
-    namespacing them with the prefix `model_`.
-
-    ```py
-    import warnings
-
-    from pydantic import BaseModel
-
-    warnings.filterwarnings('error')  # Raise warnings as errors
-
-    try:
-
-        class Model(BaseModel):
-            model_prefixed_field: str
-
-    except UserWarning as e:
-        print(e)
-        '''
-        Field "model_prefixed_field" has conflict with protected namespace "model_".
-
-        You may be able to resolve this warning by setting `model_config['protected_namespaces'] = ()`.
-        '''
-    ```
-
-    You can customize this behavior using the `protected_namespaces` setting:
-
-    ```py
-    import warnings
-
-    from pydantic import BaseModel, ConfigDict
-
-    warnings.filterwarnings('error')  # Raise warnings as errors
-
-    try:
-
-        class Model(BaseModel):
-            model_prefixed_field: str
-            also_protect_field: str
-
-            model_config = ConfigDict(
-                protected_namespaces=('protect_me_', 'also_protect_')
-            )
-
-    except UserWarning as e:
-        print(e)
-        '''
-        Field "also_protect_field" has conflict with protected namespace "also_protect_".
-
-        You may be able to resolve this warning by setting `model_config['protected_namespaces'] = ('protect_me_',)`.
-        '''
-    ```
-
-    While Pydantic will only emit a warning when an item is in a protected namespace but does not actually have a collision,
-    an error _is_ raised if there is an actual collision with an existing attribute:
-
-    ```py
-    from pydantic import BaseModel
-
-    try:
-
-        class Model(BaseModel):
-            model_validate: str
-
-    except NameError as e:
-        print(e)
-        '''
-        Field "model_validate" conflicts with member <bound method BaseModel.model_validate of <class 'pydantic.main.BaseModel'>> of protected namespace "model_".
-        '''
-    ```
-    """
-
-    hide_input_in_errors: bool
-    """
-    Whether to hide inputs when printing errors. Defaults to `False`.
-
-    Pydantic shows the input value and type when it raises `ValidationError` during the validation.
-
-    ```py
-    from pydantic import BaseModel, ValidationError
-
-    class Model(BaseModel):
-        a: str
-
-    try:
-        Model(a=123)
-    except ValidationError as e:
-        print(e)
-        '''
-        1 validation error for Model
-        a
-          Input should be a valid string [type=string_type, input_value=123, input_type=int]
-        '''
-    ```
-
-    You can hide the input value and type by setting the `hide_input_in_errors` config to `True`.
-
-    ```py
-    from pydantic import BaseModel, ConfigDict, ValidationError
-
-    class Model(BaseModel):
-        a: str
-        model_config = ConfigDict(hide_input_in_errors=True)
-
-    try:
-        Model(a=123)
-    except ValidationError as e:
-        print(e)
-        '''
-        1 validation error for Model
-        a
-          Input should be a valid string [type=string_type]
-        '''
-    ```
-    """
-
-    defer_build: bool
-    """
-    Whether to defer model validator and serializer construction until the first model validation.
-
-    This can be useful to avoid the overhead of building models which are only
-    used nested within other models, or when you want to manually define type namespace via
-    [`Model.model_rebuild(_types_namespace=...)`][pydantic.BaseModel.model_rebuild]. Defaults to False.
-    """
-
-    plugin_settings: dict[str, object] | None
-    """A `dict` of settings for plugins. Defaults to `None`.
-
-    See [Pydantic Plugins](../concepts/plugins.md) for details.
-    """
-
-    schema_generator: type[_GenerateSchema] | None
-    """
-    A custom core schema generator class to use when generating JSON schemas.
-    Useful if you want to change the way types are validated across an entire model/schema. Defaults to `None`.
-
-    The `GenerateSchema` interface is subject to change, currently only the `string_schema` method is public.
-
-    See [#6737](https://github.com/pydantic/pydantic/pull/6737) for details.
-    """
-
-    json_schema_serialization_defaults_required: bool
-    """
-    Whether fields with default values should be marked as required in the serialization schema. Defaults to `False`.
-
-    This ensures that the serialization schema will reflect the fact a field with a default will always be present
-    when serializing the model, even though it is not required for validation.
-
-    However, there are scenarios where this may be undesirable — in particular, if you want to share the schema
-    between validation and serialization, and don't mind fields with defaults being marked as not required during
-    serialization. See [#7209](https://github.com/pydantic/pydantic/issues/7209) for more details.
-
-    ```py
-    from pydantic import BaseModel, ConfigDict
-
-    class Model(BaseModel):
-        a: str = 'a'
-
-        model_config = ConfigDict(json_schema_serialization_defaults_required=True)
-
-    print(Model.model_json_schema(mode='validation'))
-    '''
-    {
-        'properties': {'a': {'default': 'a', 'title': 'A', 'type': 'string'}},
-        'title': 'Model',
-        'type': 'object',
+        class Config(BaseConfig):
+            ...
+
+        for k, v in config_dict.items():
+            setattr(Config, k, v)
+        return Config
+
+
+def inherit_config(self_config: 'ConfigType', parent_config: 'ConfigType', **namespace: Any) -> 'ConfigType':
+    if not self_config:
+        base_classes: Tuple['ConfigType', ...] = (parent_config,)
+    elif self_config == parent_config:
+        base_classes = (self_config,)
+    else:
+        base_classes = self_config, parent_config
+
+    namespace['json_encoders'] = {
+        **getattr(parent_config, 'json_encoders', {}),
+        **getattr(self_config, 'json_encoders', {}),
+        **namespace.get('json_encoders', {}),
     }
-    '''
-    print(Model.model_json_schema(mode='serialization'))
-    '''
-    {
-        'properties': {'a': {'default': 'a', 'title': 'A', 'type': 'string'}},
-        'required': ['a'],
-        'title': 'Model',
-        'type': 'object',
-    }
-    '''
-    ```
-    """
 
-    json_schema_mode_override: Literal['validation', 'serialization', None]
-    """
-    If not `None`, the specified mode will be used to generate the JSON schema regardless of what `mode` was passed to
-    the function call. Defaults to `None`.
-
-    This provides a way to force the JSON schema generation to reflect a specific mode, e.g., to always use the
-    validation schema.
-
-    It can be useful when using frameworks (such as FastAPI) that may generate different schemas for validation
-    and serialization that must both be referenced from the same schema; when this happens, we automatically append
-    `-Input` to the definition reference for the validation schema and `-Output` to the definition reference for the
-    serialization schema. By specifying a `json_schema_mode_override` though, this prevents the conflict between
-    the validation and serialization schemas (since both will use the specified schema), and so prevents the suffixes
-    from being added to the definition references.
-
-    ```py
-    from pydantic import BaseModel, ConfigDict, Json
-
-    class Model(BaseModel):
-        a: Json[int]  # requires a string to validate, but will dump an int
-
-    print(Model.model_json_schema(mode='serialization'))
-    '''
-    {
-        'properties': {'a': {'title': 'A', 'type': 'integer'}},
-        'required': ['a'],
-        'title': 'Model',
-        'type': 'object',
-    }
-    '''
-
-    class ForceInputModel(Model):
-        # the following ensures that even with mode='serialization', we
-        # will get the schema that would be generated for validation.
-        model_config = ConfigDict(json_schema_mode_override='validation')
-
-    print(ForceInputModel.model_json_schema(mode='serialization'))
-    '''
-    {
-        'properties': {
-            'a': {
-                'contentMediaType': 'application/json',
-                'contentSchema': {'type': 'integer'},
-                'title': 'A',
-                'type': 'string',
-            }
-        },
-        'required': ['a'],
-        'title': 'ForceInputModel',
-        'type': 'object',
-    }
-    '''
-    ```
-    """
-
-    coerce_numbers_to_str: bool
-    """
-    If `True`, enables automatic coercion of any `Number` type to `str` in "lax" (non-strict) mode. Defaults to `False`.
-
-    Pydantic doesn't allow number types (`int`, `float`, `Decimal`) to be coerced as type `str` by default.
-
-    ```py
-    from decimal import Decimal
-
-    from pydantic import BaseModel, ConfigDict, ValidationError
-
-    class Model(BaseModel):
-        value: str
-
-    try:
-        print(Model(value=42))
-    except ValidationError as e:
-        print(e)
-        '''
-        1 validation error for Model
-        value
-          Input should be a valid string [type=string_type, input_value=42, input_type=int]
-        '''
-
-    class Model(BaseModel):
-        model_config = ConfigDict(coerce_numbers_to_str=True)
-
-        value: str
-
-    repr(Model(value=42).value)
-    #> "42"
-    repr(Model(value=42.13).value)
-    #> "42.13"
-    repr(Model(value=Decimal('42.13')).value)
-    #> "42.13"
-    ```
-    """
-
-    regex_engine: Literal['rust-regex', 'python-re']
-    """
-    The regex engine to used for pattern validation
-    Defaults to `'rust-regex'`.
-
-    - `rust-regex` uses the [`regex`](https://docs.rs/regex) Rust crate,
-      which is non-backtracking and therefore more DDoS resistant, but does not support all regex features.
-    - `python-re` use the [`re`](https://docs.python.org/3/library/re.html) module,
-      which supports all regex features, but may be slower.
-
-    ```py
-    from pydantic import BaseModel, ConfigDict, Field, ValidationError
-
-    class Model(BaseModel):
-        model_config = ConfigDict(regex_engine='python-re')
-
-        value: str = Field(pattern=r'^abc(?=def)')
-
-    print(Model(value='abcdef').value)
-    #> abcdef
-
-    try:
-        print(Model(value='abxyzcdef'))
-    except ValidationError as e:
-        print(e)
-        '''
-        1 validation error for Model
-        value
-          String should match pattern '^abc(?=def)' [type=string_pattern_mismatch, input_value='abxyzcdef', input_type=str]
-        '''
-    ```
-    """
-
-    validation_error_cause: bool
-    """
-    If `True`, python exceptions that were part of a validation failure will be shown as an exception group as a cause. Can be useful for debugging. Defaults to `False`.
-
-    Note:
-        Python 3.10 and older don't support exception groups natively. <=3.10, backport must be installed: `pip install exceptiongroup`.
-
-    Note:
-        The structure of validation errors are likely to change in future pydantic versions. Pydantic offers no guarantees about the structure of validation errors. Should be used for visual traceback debugging only.
-    """
+    return type('Config', base_classes, namespace)
 
 
-__getattr__ = getattr_migration(__name__)
+def prepare_config(config: Type[BaseConfig], cls_name: str) -> None:
+    if not isinstance(config.extra, Extra):
+        try:
+            config.extra = Extra(config.extra)
+        except ValueError:
+            raise ValueError(f'"{cls_name}": {config.extra} is not a valid value for "extra"')
diff --git a/lib/pydantic/dataclasses.py b/lib/pydantic/dataclasses.py
index d9c9c903..68331127 100644
--- a/lib/pydantic/dataclasses.py
+++ b/lib/pydantic/dataclasses.py
@@ -1,327 +1,479 @@
-"""Provide an enhanced dataclass that performs validation."""
-from __future__ import annotations as _annotations
+"""
+The main purpose is to enhance stdlib dataclasses by adding validation
+A pydantic dataclass can be generated from scratch or from a stdlib one.
 
-import dataclasses
+Behind the scene, a pydantic dataclass is just like a regular one on which we attach
+a `BaseModel` and magic methods to trigger the validation of the data.
+`__init__` and `__post_init__` are hence overridden and have extra logic to be
+able to validate input data.
+
+When a pydantic dataclass is generated from scratch, it's just a plain dataclass
+with validation triggered at initialization
+
+The tricky part if for stdlib dataclasses that are converted after into pydantic ones e.g.
+
+```py
+@dataclasses.dataclass
+class M:
+    x: int
+
+ValidatedM = pydantic.dataclasses.dataclass(M)
+```
+
+We indeed still want to support equality, hashing, repr, ... as if it was the stdlib one!
+
+```py
+assert isinstance(ValidatedM(x=1), M)
+assert ValidatedM(x=1) == M(x=1)
+```
+
+This means we **don't want to create a new dataclass that inherits from it**
+The trick is to create a wrapper around `M` that will act as a proxy to trigger
+validation without altering default `M` behaviour.
+"""
 import sys
-import types
-from typing import TYPE_CHECKING, Any, Callable, Generic, NoReturn, TypeVar, overload
+from contextlib import contextmanager
+from functools import wraps
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    ClassVar,
+    Dict,
+    Generator,
+    Optional,
+    Set,
+    Type,
+    TypeVar,
+    Union,
+    overload,
+)
 
-from typing_extensions import Literal, TypeGuard, dataclass_transform
+from typing_extensions import dataclass_transform
 
-from ._internal import _config, _decorators, _typing_extra
-from ._internal import _dataclasses as _pydantic_dataclasses
-from ._migration import getattr_migration
-from .config import ConfigDict
-from .fields import Field, FieldInfo
+from .class_validators import gather_all_validators
+from .config import BaseConfig, ConfigDict, Extra, get_config
+from .error_wrappers import ValidationError
+from .errors import DataclassTypeError
+from .fields import Field, FieldInfo, Required, Undefined
+from .main import create_model, validate_model
+from .utils import ClassAttribute
 
 if TYPE_CHECKING:
-    from ._internal._dataclasses import PydanticDataclass
+    from .main import BaseModel
+    from .typing import CallableGenerator, NoArgAnyCallable
 
-__all__ = 'dataclass', 'rebuild_dataclass'
+    DataclassT = TypeVar('DataclassT', bound='Dataclass')
+
+    DataclassClassOrWrapper = Union[Type['Dataclass'], 'DataclassProxy']
+
+    class Dataclass:
+        # stdlib attributes
+        __dataclass_fields__: ClassVar[Dict[str, Any]]
+        __dataclass_params__: ClassVar[Any]  # in reality `dataclasses._DataclassParams`
+        __post_init__: ClassVar[Callable[..., None]]
+
+        # Added by pydantic
+        __pydantic_run_validation__: ClassVar[bool]
+        __post_init_post_parse__: ClassVar[Callable[..., None]]
+        __pydantic_initialised__: ClassVar[bool]
+        __pydantic_model__: ClassVar[Type[BaseModel]]
+        __pydantic_validate_values__: ClassVar[Callable[['Dataclass'], None]]
+        __pydantic_has_field_info_default__: ClassVar[bool]  # whether a `pydantic.Field` is used as default value
+
+        def __init__(self, *args: object, **kwargs: object) -> None:
+            pass
+
+        @classmethod
+        def __get_validators__(cls: Type['Dataclass']) -> 'CallableGenerator':
+            pass
+
+        @classmethod
+        def __validate__(cls: Type['DataclassT'], v: Any) -> 'DataclassT':
+            pass
+
+
+__all__ = [
+    'dataclass',
+    'set_validation',
+    'create_pydantic_model_from_dataclass',
+    'is_builtin_dataclass',
+    'make_dataclass_validator',
+]
 
 _T = TypeVar('_T')
 
 if sys.version_info >= (3, 10):
 
-    @dataclass_transform(field_specifiers=(dataclasses.field, Field))
+    @dataclass_transform(kw_only_default=True, field_descriptors=(Field, FieldInfo))
     @overload
     def dataclass(
         *,
-        init: Literal[False] = False,
+        init: bool = True,
         repr: bool = True,
         eq: bool = True,
         order: bool = False,
         unsafe_hash: bool = False,
         frozen: bool = False,
-        config: ConfigDict | type[object] | None = None,
-        validate_on_init: bool | None = None,
+        config: Union[ConfigDict, Type[object], None] = None,
+        validate_on_init: Optional[bool] = None,
         kw_only: bool = ...,
-        slots: bool = ...,
-    ) -> Callable[[type[_T]], type[PydanticDataclass]]:  # type: ignore
+    ) -> Callable[[Type[_T]], 'DataclassClassOrWrapper']:
         ...
 
-    @dataclass_transform(field_specifiers=(dataclasses.field, Field))
+    @dataclass_transform(kw_only_default=True, field_descriptors=(Field, FieldInfo))
     @overload
     def dataclass(
-        _cls: type[_T],  # type: ignore
+        _cls: Type[_T],
         *,
-        init: Literal[False] = False,
+        init: bool = True,
         repr: bool = True,
         eq: bool = True,
         order: bool = False,
         unsafe_hash: bool = False,
         frozen: bool = False,
-        config: ConfigDict | type[object] | None = None,
-        validate_on_init: bool | None = None,
+        config: Union[ConfigDict, Type[object], None] = None,
+        validate_on_init: Optional[bool] = None,
         kw_only: bool = ...,
-        slots: bool = ...,
-    ) -> type[PydanticDataclass]:
+    ) -> 'DataclassClassOrWrapper':
         ...
 
 else:
 
-    @dataclass_transform(field_specifiers=(dataclasses.field, Field))
+    @dataclass_transform(kw_only_default=True, field_descriptors=(Field, FieldInfo))
     @overload
     def dataclass(
         *,
-        init: Literal[False] = False,
+        init: bool = True,
         repr: bool = True,
         eq: bool = True,
         order: bool = False,
         unsafe_hash: bool = False,
         frozen: bool = False,
-        config: ConfigDict | type[object] | None = None,
-        validate_on_init: bool | None = None,
-    ) -> Callable[[type[_T]], type[PydanticDataclass]]:  # type: ignore
+        config: Union[ConfigDict, Type[object], None] = None,
+        validate_on_init: Optional[bool] = None,
+    ) -> Callable[[Type[_T]], 'DataclassClassOrWrapper']:
         ...
 
-    @dataclass_transform(field_specifiers=(dataclasses.field, Field))
+    @dataclass_transform(kw_only_default=True, field_descriptors=(Field, FieldInfo))
     @overload
     def dataclass(
-        _cls: type[_T],  # type: ignore
+        _cls: Type[_T],
         *,
-        init: Literal[False] = False,
+        init: bool = True,
         repr: bool = True,
         eq: bool = True,
         order: bool = False,
         unsafe_hash: bool = False,
         frozen: bool = False,
-        config: ConfigDict | type[object] | None = None,
-        validate_on_init: bool | None = None,
-    ) -> type[PydanticDataclass]:
+        config: Union[ConfigDict, Type[object], None] = None,
+        validate_on_init: Optional[bool] = None,
+    ) -> 'DataclassClassOrWrapper':
         ...
 
 
-@dataclass_transform(field_specifiers=(dataclasses.field, Field))
-def dataclass(  # noqa: C901
-    _cls: type[_T] | None = None,
+@dataclass_transform(kw_only_default=True, field_descriptors=(Field, FieldInfo))
+def dataclass(
+    _cls: Optional[Type[_T]] = None,
     *,
-    init: Literal[False] = False,
+    init: bool = True,
     repr: bool = True,
     eq: bool = True,
     order: bool = False,
     unsafe_hash: bool = False,
     frozen: bool = False,
-    config: ConfigDict | type[object] | None = None,
-    validate_on_init: bool | None = None,
+    config: Union[ConfigDict, Type[object], None] = None,
+    validate_on_init: Optional[bool] = None,
     kw_only: bool = False,
-    slots: bool = False,
-) -> Callable[[type[_T]], type[PydanticDataclass]] | type[PydanticDataclass]:
-    """Usage docs: https://docs.pydantic.dev/2.6/concepts/dataclasses/
-
-    A decorator used to create a Pydantic-enhanced dataclass, similar to the standard Python `dataclass`,
-    but with added validation.
-
-    This function should be used similarly to `dataclasses.dataclass`.
-
-    Args:
-        _cls: The target `dataclass`.
-        init: Included for signature compatibility with `dataclasses.dataclass`, and is passed through to
-            `dataclasses.dataclass` when appropriate. If specified, must be set to `False`, as pydantic inserts its
-            own  `__init__` function.
-        repr: A boolean indicating whether to include the field in the `__repr__` output.
-        eq: Determines if a `__eq__` method should be generated for the class.
-        order: Determines if comparison magic methods should be generated, such as `__lt__`, but not `__eq__`.
-        unsafe_hash: Determines if a `__hash__` method should be included in the class, as in `dataclasses.dataclass`.
-        frozen: Determines if the generated class should be a 'frozen' `dataclass`, which does not allow its
-            attributes to be modified after it has been initialized.
-        config: The Pydantic config to use for the `dataclass`.
-        validate_on_init: A deprecated parameter included for backwards compatibility; in V2, all Pydantic dataclasses
-            are validated on init.
-        kw_only: Determines if `__init__` method parameters must be specified by keyword only. Defaults to `False`.
-        slots: Determines if the generated class should be a 'slots' `dataclass`, which does not allow the addition of
-            new attributes after instantiation.
-
-    Returns:
-        A decorator that accepts a class as its argument and returns a Pydantic `dataclass`.
-
-    Raises:
-        AssertionError: Raised if `init` is not `False` or `validate_on_init` is `False`.
+) -> Union[Callable[[Type[_T]], 'DataclassClassOrWrapper'], 'DataclassClassOrWrapper']:
     """
-    assert init is False, 'pydantic.dataclasses.dataclass only supports init=False'
-    assert validate_on_init is not False, 'validate_on_init=False is no longer supported'
+    Like the python standard lib dataclasses but with type validation.
+    The result is either a pydantic dataclass that will validate input data
+    or a wrapper that will trigger validation around a stdlib dataclass
+    to avoid modifying it directly
+    """
+    the_config = get_config(config)
 
-    if sys.version_info >= (3, 10):
-        kwargs = dict(kw_only=kw_only, slots=slots)
-    else:
-        kwargs = {}
+    def wrap(cls: Type[Any]) -> 'DataclassClassOrWrapper':
+        import dataclasses
 
-    def make_pydantic_fields_compatible(cls: type[Any]) -> None:
-        """Make sure that stdlib `dataclasses` understands `Field` kwargs like `kw_only`
-        To do that, we simply change
-          `x: int = pydantic.Field(..., kw_only=True)`
-        into
-          `x: int = dataclasses.field(default=pydantic.Field(..., kw_only=True), kw_only=True)`
-        """
-        for annotation_cls in cls.__mro__:
-            # In Python < 3.9, `__annotations__` might not be present if there are no fields.
-            # we therefore need to use `getattr` to avoid an `AttributeError`.
-            annotations = getattr(annotation_cls, '__annotations__', [])
-            for field_name in annotations:
-                field_value = getattr(cls, field_name, None)
-                # Process only if this is an instance of `FieldInfo`.
-                if not isinstance(field_value, FieldInfo):
-                    continue
+        if is_builtin_dataclass(cls) and _extra_dc_args(_cls) == _extra_dc_args(_cls.__bases__[0]):  # type: ignore
+            dc_cls_doc = ''
+            dc_cls = DataclassProxy(cls)
+            default_validate_on_init = False
+        else:
+            dc_cls_doc = cls.__doc__ or ''  # needs to be done before generating dataclass
+            if sys.version_info >= (3, 10):
+                dc_cls = dataclasses.dataclass(
+                    cls,
+                    init=init,
+                    repr=repr,
+                    eq=eq,
+                    order=order,
+                    unsafe_hash=unsafe_hash,
+                    frozen=frozen,
+                    kw_only=kw_only,
+                )
+            else:
+                dc_cls = dataclasses.dataclass(  # type: ignore
+                    cls, init=init, repr=repr, eq=eq, order=order, unsafe_hash=unsafe_hash, frozen=frozen
+                )
+            default_validate_on_init = True
 
-                # Initialize arguments for the standard `dataclasses.field`.
-                field_args: dict = {'default': field_value}
-
-                # Handle `kw_only` for Python 3.10+
-                if sys.version_info >= (3, 10) and field_value.kw_only:
-                    field_args['kw_only'] = True
-
-                # Set `repr` attribute if it's explicitly specified to be not `True`.
-                if field_value.repr is not True:
-                    field_args['repr'] = field_value.repr
-
-                setattr(cls, field_name, dataclasses.field(**field_args))
-                # In Python 3.8, dataclasses checks cls.__dict__['__annotations__'] for annotations,
-                # so we must make sure it's initialized before we add to it.
-                if cls.__dict__.get('__annotations__') is None:
-                    cls.__annotations__ = {}
-                cls.__annotations__[field_name] = annotations[field_name]
-
-    def create_dataclass(cls: type[Any]) -> type[PydanticDataclass]:
-        """Create a Pydantic dataclass from a regular dataclass.
-
-        Args:
-            cls: The class to create the Pydantic dataclass from.
-
-        Returns:
-            A Pydantic dataclass.
-        """
-        original_cls = cls
-
-        config_dict = config
-        if config_dict is None:
-            # if not explicitly provided, read from the type
-            cls_config = getattr(cls, '__pydantic_config__', None)
-            if cls_config is not None:
-                config_dict = cls_config
-        config_wrapper = _config.ConfigWrapper(config_dict)
-        decorators = _decorators.DecoratorInfos.build(cls)
-
-        # Keep track of the original __doc__ so that we can restore it after applying the dataclasses decorator
-        # Otherwise, classes with no __doc__ will have their signature added into the JSON schema description,
-        # since dataclasses.dataclass will set this as the __doc__
-        original_doc = cls.__doc__
-
-        if _pydantic_dataclasses.is_builtin_dataclass(cls):
-            # Don't preserve the docstring for vanilla dataclasses, as it may include the signature
-            # This matches v1 behavior, and there was an explicit test for it
-            original_doc = None
-
-            # We don't want to add validation to the existing std lib dataclass, so we will subclass it
-            #   If the class is generic, we need to make sure the subclass also inherits from Generic
-            #   with all the same parameters.
-            bases = (cls,)
-            if issubclass(cls, Generic):
-                generic_base = Generic[cls.__parameters__]  # type: ignore
-                bases = bases + (generic_base,)
-            cls = types.new_class(cls.__name__, bases)
-
-        make_pydantic_fields_compatible(cls)
-
-        cls = dataclasses.dataclass(  # type: ignore[call-overload]
-            cls,
-            # the value of init here doesn't affect anything except that it makes it easier to generate a signature
-            init=True,
-            repr=repr,
-            eq=eq,
-            order=order,
-            unsafe_hash=unsafe_hash,
-            frozen=frozen,
-            **kwargs,
-        )
-
-        cls.__pydantic_decorators__ = decorators  # type: ignore
-        cls.__doc__ = original_doc
-        cls.__module__ = original_cls.__module__
-        cls.__qualname__ = original_cls.__qualname__
-        pydantic_complete = _pydantic_dataclasses.complete_dataclass(
-            cls, config_wrapper, raise_errors=False, types_namespace=None
-        )
-        cls.__pydantic_complete__ = pydantic_complete  # type: ignore
-        return cls
+        should_validate_on_init = default_validate_on_init if validate_on_init is None else validate_on_init
+        _add_pydantic_validation_attributes(cls, the_config, should_validate_on_init, dc_cls_doc)
+        dc_cls.__pydantic_model__.__try_update_forward_refs__(**{cls.__name__: cls})
+        return dc_cls
 
     if _cls is None:
-        return create_dataclass
+        return wrap
 
-    return create_dataclass(_cls)
+    return wrap(_cls)
 
 
-__getattr__ = getattr_migration(__name__)
-
-if (3, 8) <= sys.version_info < (3, 11):
-    # Monkeypatch dataclasses.InitVar so that typing doesn't error if it occurs as a type when evaluating type hints
-    # Starting in 3.11, typing.get_type_hints will not raise an error if the retrieved type hints are not callable.
-
-    def _call_initvar(*args: Any, **kwargs: Any) -> NoReturn:
-        """This function does nothing but raise an error that is as similar as possible to what you'd get
-        if you were to try calling `InitVar[int]()` without this monkeypatch. The whole purpose is just
-        to ensure typing._type_check does not error if the type hint evaluates to `InitVar[<parameter>]`.
-        """
-        raise TypeError("'InitVar' object is not callable")
-
-    dataclasses.InitVar.__call__ = _call_initvar
+@contextmanager
+def set_validation(cls: Type['DataclassT'], value: bool) -> Generator[Type['DataclassT'], None, None]:
+    original_run_validation = cls.__pydantic_run_validation__
+    try:
+        cls.__pydantic_run_validation__ = value
+        yield cls
+    finally:
+        cls.__pydantic_run_validation__ = original_run_validation
 
 
-def rebuild_dataclass(
-    cls: type[PydanticDataclass],
-    *,
-    force: bool = False,
-    raise_errors: bool = True,
-    _parent_namespace_depth: int = 2,
-    _types_namespace: dict[str, Any] | None = None,
-) -> bool | None:
-    """Try to rebuild the pydantic-core schema for the dataclass.
+class DataclassProxy:
+    __slots__ = '__dataclass__'
 
-    This may be necessary when one of the annotations is a ForwardRef which could not be resolved during
-    the initial attempt to build the schema, and automatic rebuilding fails.
+    def __init__(self, dc_cls: Type['Dataclass']) -> None:
+        object.__setattr__(self, '__dataclass__', dc_cls)
 
-    This is analogous to `BaseModel.model_rebuild`.
+    def __call__(self, *args: Any, **kwargs: Any) -> Any:
+        with set_validation(self.__dataclass__, True):
+            return self.__dataclass__(*args, **kwargs)
 
-    Args:
-        cls: The class to rebuild the pydantic-core schema for.
-        force: Whether to force the rebuilding of the schema, defaults to `False`.
-        raise_errors: Whether to raise errors, defaults to `True`.
-        _parent_namespace_depth: The depth level of the parent namespace, defaults to 2.
-        _types_namespace: The types namespace, defaults to `None`.
+    def __getattr__(self, name: str) -> Any:
+        return getattr(self.__dataclass__, name)
 
-    Returns:
-        Returns `None` if the schema is already "complete" and rebuilding was not required.
-        If rebuilding _was_ required, returns `True` if rebuilding was successful, otherwise `False`.
+    def __instancecheck__(self, instance: Any) -> bool:
+        return isinstance(instance, self.__dataclass__)
+
+
+def _add_pydantic_validation_attributes(  # noqa: C901 (ignore complexity)
+    dc_cls: Type['Dataclass'],
+    config: Type[BaseConfig],
+    validate_on_init: bool,
+    dc_cls_doc: str,
+) -> None:
     """
-    if not force and cls.__pydantic_complete__:
-        return None
-    else:
-        if _types_namespace is not None:
-            types_namespace: dict[str, Any] | None = _types_namespace.copy()
+    We need to replace the right method. If no `__post_init__` has been set in the stdlib dataclass
+    it won't even exist (code is generated on the fly by `dataclasses`)
+    By default, we run validation after `__init__` or `__post_init__` if defined
+    """
+    init = dc_cls.__init__
+
+    @wraps(init)
+    def handle_extra_init(self: 'Dataclass', *args: Any, **kwargs: Any) -> None:
+        if config.extra == Extra.ignore:
+            init(self, *args, **{k: v for k, v in kwargs.items() if k in self.__dataclass_fields__})
+
+        elif config.extra == Extra.allow:
+            for k, v in kwargs.items():
+                self.__dict__.setdefault(k, v)
+            init(self, *args, **{k: v for k, v in kwargs.items() if k in self.__dataclass_fields__})
+
         else:
-            if _parent_namespace_depth > 0:
-                frame_parent_ns = _typing_extra.parent_frame_namespace(parent_depth=_parent_namespace_depth) or {}
-                # Note: we may need to add something similar to cls.__pydantic_parent_namespace__ from BaseModel
-                #   here when implementing handling of recursive generics. See BaseModel.model_rebuild for reference.
-                types_namespace = frame_parent_ns
-            else:
-                types_namespace = {}
+            init(self, *args, **kwargs)
 
-            types_namespace = _typing_extra.get_cls_types_namespace(cls, types_namespace)
-        return _pydantic_dataclasses.complete_dataclass(
-            cls,
-            _config.ConfigWrapper(cls.__pydantic_config__, check=False),
-            raise_errors=raise_errors,
-            types_namespace=types_namespace,
-        )
+    if hasattr(dc_cls, '__post_init__'):
+        post_init = dc_cls.__post_init__
+
+        @wraps(post_init)
+        def new_post_init(self: 'Dataclass', *args: Any, **kwargs: Any) -> None:
+            if config.post_init_call == 'before_validation':
+                post_init(self, *args, **kwargs)
+
+            if self.__class__.__pydantic_run_validation__:
+                self.__pydantic_validate_values__()
+                if hasattr(self, '__post_init_post_parse__'):
+                    self.__post_init_post_parse__(*args, **kwargs)
+
+            if config.post_init_call == 'after_validation':
+                post_init(self, *args, **kwargs)
+
+        setattr(dc_cls, '__init__', handle_extra_init)
+        setattr(dc_cls, '__post_init__', new_post_init)
+
+    else:
+
+        @wraps(init)
+        def new_init(self: 'Dataclass', *args: Any, **kwargs: Any) -> None:
+            handle_extra_init(self, *args, **kwargs)
+
+            if self.__class__.__pydantic_run_validation__:
+                self.__pydantic_validate_values__()
+
+            if hasattr(self, '__post_init_post_parse__'):
+                # We need to find again the initvars. To do that we use `__dataclass_fields__` instead of
+                # public method `dataclasses.fields`
+                import dataclasses
+
+                # get all initvars and their default values
+                initvars_and_values: Dict[str, Any] = {}
+                for i, f in enumerate(self.__class__.__dataclass_fields__.values()):
+                    if f._field_type is dataclasses._FIELD_INITVAR:  # type: ignore[attr-defined]
+                        try:
+                            # set arg value by default
+                            initvars_and_values[f.name] = args[i]
+                        except IndexError:
+                            initvars_and_values[f.name] = kwargs.get(f.name, f.default)
+
+                self.__post_init_post_parse__(**initvars_and_values)
+
+        setattr(dc_cls, '__init__', new_init)
+
+    setattr(dc_cls, '__pydantic_run_validation__', ClassAttribute('__pydantic_run_validation__', validate_on_init))
+    setattr(dc_cls, '__pydantic_initialised__', False)
+    setattr(dc_cls, '__pydantic_model__', create_pydantic_model_from_dataclass(dc_cls, config, dc_cls_doc))
+    setattr(dc_cls, '__pydantic_validate_values__', _dataclass_validate_values)
+    setattr(dc_cls, '__validate__', classmethod(_validate_dataclass))
+    setattr(dc_cls, '__get_validators__', classmethod(_get_validators))
+
+    if dc_cls.__pydantic_model__.__config__.validate_assignment and not dc_cls.__dataclass_params__.frozen:
+        setattr(dc_cls, '__setattr__', _dataclass_validate_assignment_setattr)
 
 
-def is_pydantic_dataclass(__cls: type[Any]) -> TypeGuard[type[PydanticDataclass]]:
-    """Whether a class is a pydantic dataclass.
+def _get_validators(cls: 'DataclassClassOrWrapper') -> 'CallableGenerator':
+    yield cls.__validate__
 
-    Args:
-        __cls: The class.
 
-    Returns:
-        `True` if the class is a pydantic dataclass, `False` otherwise.
+def _validate_dataclass(cls: Type['DataclassT'], v: Any) -> 'DataclassT':
+    with set_validation(cls, True):
+        if isinstance(v, cls):
+            v.__pydantic_validate_values__()
+            return v
+        elif isinstance(v, (list, tuple)):
+            return cls(*v)
+        elif isinstance(v, dict):
+            return cls(**v)
+        else:
+            raise DataclassTypeError(class_name=cls.__name__)
+
+
+def create_pydantic_model_from_dataclass(
+    dc_cls: Type['Dataclass'],
+    config: Type[Any] = BaseConfig,
+    dc_cls_doc: Optional[str] = None,
+) -> Type['BaseModel']:
+    import dataclasses
+
+    field_definitions: Dict[str, Any] = {}
+    for field in dataclasses.fields(dc_cls):
+        default: Any = Undefined
+        default_factory: Optional['NoArgAnyCallable'] = None
+        field_info: FieldInfo
+
+        if field.default is not dataclasses.MISSING:
+            default = field.default
+        elif field.default_factory is not dataclasses.MISSING:
+            default_factory = field.default_factory
+        else:
+            default = Required
+
+        if isinstance(default, FieldInfo):
+            field_info = default
+            dc_cls.__pydantic_has_field_info_default__ = True
+        else:
+            field_info = Field(default=default, default_factory=default_factory, **field.metadata)
+
+        field_definitions[field.name] = (field.type, field_info)
+
+    validators = gather_all_validators(dc_cls)
+    model: Type['BaseModel'] = create_model(
+        dc_cls.__name__,
+        __config__=config,
+        __module__=dc_cls.__module__,
+        __validators__=validators,
+        __cls_kwargs__={'__resolve_forward_refs__': False},
+        **field_definitions,
+    )
+    model.__doc__ = dc_cls_doc if dc_cls_doc is not None else dc_cls.__doc__ or ''
+    return model
+
+
+def _dataclass_validate_values(self: 'Dataclass') -> None:
+    # validation errors can occur if this function is called twice on an already initialised dataclass.
+    # for example if Extra.forbid is enabled, it would consider __pydantic_initialised__ an invalid extra property
+    if getattr(self, '__pydantic_initialised__'):
+        return
+    if getattr(self, '__pydantic_has_field_info_default__', False):
+        # We need to remove `FieldInfo` values since they are not valid as input
+        # It's ok to do that because they are obviously the default values!
+        input_data = {k: v for k, v in self.__dict__.items() if not isinstance(v, FieldInfo)}
+    else:
+        input_data = self.__dict__
+    d, _, validation_error = validate_model(self.__pydantic_model__, input_data, cls=self.__class__)
+    if validation_error:
+        raise validation_error
+    self.__dict__.update(d)
+    object.__setattr__(self, '__pydantic_initialised__', True)
+
+
+def _dataclass_validate_assignment_setattr(self: 'Dataclass', name: str, value: Any) -> None:
+    if self.__pydantic_initialised__:
+        d = dict(self.__dict__)
+        d.pop(name, None)
+        known_field = self.__pydantic_model__.__fields__.get(name, None)
+        if known_field:
+            value, error_ = known_field.validate(value, d, loc=name, cls=self.__class__)
+            if error_:
+                raise ValidationError([error_], self.__class__)
+
+    object.__setattr__(self, name, value)
+
+
+def _extra_dc_args(cls: Type[Any]) -> Set[str]:
+    return {
+        x
+        for x in dir(cls)
+        if x not in getattr(cls, '__dataclass_fields__', {}) and not (x.startswith('__') and x.endswith('__'))
+    }
+
+
+def is_builtin_dataclass(_cls: Type[Any]) -> bool:
     """
-    return dataclasses.is_dataclass(__cls) and '__pydantic_validator__' in __cls.__dict__
+    Whether a class is a stdlib dataclass
+    (useful to discriminated a pydantic dataclass that is actually a wrapper around a stdlib dataclass)
+
+    we check that
+    - `_cls` is a dataclass
+    - `_cls` is not a processed pydantic dataclass (with a basemodel attached)
+    - `_cls` is not a pydantic dataclass inheriting directly from a stdlib dataclass
+    e.g.
+    ```
+    @dataclasses.dataclass
+    class A:
+        x: int
+
+    @pydantic.dataclasses.dataclass
+    class B(A):
+        y: int
+    ```
+    In this case, when we first check `B`, we make an extra check and look at the annotations ('y'),
+    which won't be a superset of all the dataclass fields (only the stdlib fields i.e. 'x')
+    """
+    import dataclasses
+
+    return (
+        dataclasses.is_dataclass(_cls)
+        and not hasattr(_cls, '__pydantic_model__')
+        and set(_cls.__dataclass_fields__).issuperset(set(getattr(_cls, '__annotations__', {})))
+    )
+
+
+def make_dataclass_validator(dc_cls: Type['Dataclass'], config: Type[BaseConfig]) -> 'CallableGenerator':
+    """
+    Create a pydantic.dataclass from a builtin dataclass to add type validation
+    and yield the validators
+    It retrieves the parameters of the dataclass and forwards them to the newly created dataclass
+    """
+    yield from _get_validators(dataclass(dc_cls, config=config, validate_on_init=False))
diff --git a/lib/pydantic/datetime_parse.py b/lib/pydantic/datetime_parse.py
index 902219df..cfd54593 100644
--- a/lib/pydantic/datetime_parse.py
+++ b/lib/pydantic/datetime_parse.py
@@ -1,4 +1,248 @@
-"""The `datetime_parse` module is a backport module from V1."""
-from ._migration import getattr_migration
+"""
+Functions to parse datetime objects.
 
-__getattr__ = getattr_migration(__name__)
+We're using regular expressions rather than time.strptime because:
+- They provide both validation and parsing.
+- They're more flexible for datetimes.
+- The date/datetime/time constructors produce friendlier error messages.
+
+Stolen from https://raw.githubusercontent.com/django/django/main/django/utils/dateparse.py at
+9718fa2e8abe430c3526a9278dd976443d4ae3c6
+
+Changed to:
+* use standard python datetime types not django.utils.timezone
+* raise ValueError when regex doesn't match rather than returning None
+* support parsing unix timestamps for dates and datetimes
+"""
+import re
+from datetime import date, datetime, time, timedelta, timezone
+from typing import Dict, Optional, Type, Union
+
+from . import errors
+
+date_expr = r'(?P<year>\d{4})-(?P<month>\d{1,2})-(?P<day>\d{1,2})'
+time_expr = (
+    r'(?P<hour>\d{1,2}):(?P<minute>\d{1,2})'
+    r'(?::(?P<second>\d{1,2})(?:\.(?P<microsecond>\d{1,6})\d{0,6})?)?'
+    r'(?P<tzinfo>Z|[+-]\d{2}(?::?\d{2})?)?$'
+)
+
+date_re = re.compile(f'{date_expr}$')
+time_re = re.compile(time_expr)
+datetime_re = re.compile(f'{date_expr}[T ]{time_expr}')
+
+standard_duration_re = re.compile(
+    r'^'
+    r'(?:(?P<days>-?\d+) (days?, )?)?'
+    r'((?:(?P<hours>-?\d+):)(?=\d+:\d+))?'
+    r'(?:(?P<minutes>-?\d+):)?'
+    r'(?P<seconds>-?\d+)'
+    r'(?:\.(?P<microseconds>\d{1,6})\d{0,6})?'
+    r'$'
+)
+
+# Support the sections of ISO 8601 date representation that are accepted by timedelta
+iso8601_duration_re = re.compile(
+    r'^(?P<sign>[-+]?)'
+    r'P'
+    r'(?:(?P<days>\d+(.\d+)?)D)?'
+    r'(?:T'
+    r'(?:(?P<hours>\d+(.\d+)?)H)?'
+    r'(?:(?P<minutes>\d+(.\d+)?)M)?'
+    r'(?:(?P<seconds>\d+(.\d+)?)S)?'
+    r')?'
+    r'$'
+)
+
+EPOCH = datetime(1970, 1, 1)
+# if greater than this, the number is in ms, if less than or equal it's in seconds
+# (in seconds this is 11th October 2603, in ms it's 20th August 1970)
+MS_WATERSHED = int(2e10)
+# slightly more than datetime.max in ns - (datetime.max - EPOCH).total_seconds() * 1e9
+MAX_NUMBER = int(3e20)
+StrBytesIntFloat = Union[str, bytes, int, float]
+
+
+def get_numeric(value: StrBytesIntFloat, native_expected_type: str) -> Union[None, int, float]:
+    if isinstance(value, (int, float)):
+        return value
+    try:
+        return float(value)
+    except ValueError:
+        return None
+    except TypeError:
+        raise TypeError(f'invalid type; expected {native_expected_type}, string, bytes, int or float')
+
+
+def from_unix_seconds(seconds: Union[int, float]) -> datetime:
+    if seconds > MAX_NUMBER:
+        return datetime.max
+    elif seconds < -MAX_NUMBER:
+        return datetime.min
+
+    while abs(seconds) > MS_WATERSHED:
+        seconds /= 1000
+    dt = EPOCH + timedelta(seconds=seconds)
+    return dt.replace(tzinfo=timezone.utc)
+
+
+def _parse_timezone(value: Optional[str], error: Type[Exception]) -> Union[None, int, timezone]:
+    if value == 'Z':
+        return timezone.utc
+    elif value is not None:
+        offset_mins = int(value[-2:]) if len(value) > 3 else 0
+        offset = 60 * int(value[1:3]) + offset_mins
+        if value[0] == '-':
+            offset = -offset
+        try:
+            return timezone(timedelta(minutes=offset))
+        except ValueError:
+            raise error()
+    else:
+        return None
+
+
+def parse_date(value: Union[date, StrBytesIntFloat]) -> date:
+    """
+    Parse a date/int/float/string and return a datetime.date.
+
+    Raise ValueError if the input is well formatted but not a valid date.
+    Raise ValueError if the input isn't well formatted.
+    """
+    if isinstance(value, date):
+        if isinstance(value, datetime):
+            return value.date()
+        else:
+            return value
+
+    number = get_numeric(value, 'date')
+    if number is not None:
+        return from_unix_seconds(number).date()
+
+    if isinstance(value, bytes):
+        value = value.decode()
+
+    match = date_re.match(value)  # type: ignore
+    if match is None:
+        raise errors.DateError()
+
+    kw = {k: int(v) for k, v in match.groupdict().items()}
+
+    try:
+        return date(**kw)
+    except ValueError:
+        raise errors.DateError()
+
+
+def parse_time(value: Union[time, StrBytesIntFloat]) -> time:
+    """
+    Parse a time/string and return a datetime.time.
+
+    Raise ValueError if the input is well formatted but not a valid time.
+    Raise ValueError if the input isn't well formatted, in particular if it contains an offset.
+    """
+    if isinstance(value, time):
+        return value
+
+    number = get_numeric(value, 'time')
+    if number is not None:
+        if number >= 86400:
+            # doesn't make sense since the time time loop back around to 0
+            raise errors.TimeError()
+        return (datetime.min + timedelta(seconds=number)).time()
+
+    if isinstance(value, bytes):
+        value = value.decode()
+
+    match = time_re.match(value)  # type: ignore
+    if match is None:
+        raise errors.TimeError()
+
+    kw = match.groupdict()
+    if kw['microsecond']:
+        kw['microsecond'] = kw['microsecond'].ljust(6, '0')
+
+    tzinfo = _parse_timezone(kw.pop('tzinfo'), errors.TimeError)
+    kw_: Dict[str, Union[None, int, timezone]] = {k: int(v) for k, v in kw.items() if v is not None}
+    kw_['tzinfo'] = tzinfo
+
+    try:
+        return time(**kw_)  # type: ignore
+    except ValueError:
+        raise errors.TimeError()
+
+
+def parse_datetime(value: Union[datetime, StrBytesIntFloat]) -> datetime:
+    """
+    Parse a datetime/int/float/string and return a datetime.datetime.
+
+    This function supports time zone offsets. When the input contains one,
+    the output uses a timezone with a fixed offset from UTC.
+
+    Raise ValueError if the input is well formatted but not a valid datetime.
+    Raise ValueError if the input isn't well formatted.
+    """
+    if isinstance(value, datetime):
+        return value
+
+    number = get_numeric(value, 'datetime')
+    if number is not None:
+        return from_unix_seconds(number)
+
+    if isinstance(value, bytes):
+        value = value.decode()
+
+    match = datetime_re.match(value)  # type: ignore
+    if match is None:
+        raise errors.DateTimeError()
+
+    kw = match.groupdict()
+    if kw['microsecond']:
+        kw['microsecond'] = kw['microsecond'].ljust(6, '0')
+
+    tzinfo = _parse_timezone(kw.pop('tzinfo'), errors.DateTimeError)
+    kw_: Dict[str, Union[None, int, timezone]] = {k: int(v) for k, v in kw.items() if v is not None}
+    kw_['tzinfo'] = tzinfo
+
+    try:
+        return datetime(**kw_)  # type: ignore
+    except ValueError:
+        raise errors.DateTimeError()
+
+
+def parse_duration(value: StrBytesIntFloat) -> timedelta:
+    """
+    Parse a duration int/float/string and return a datetime.timedelta.
+
+    The preferred format for durations in Django is '%d %H:%M:%S.%f'.
+
+    Also supports ISO 8601 representation.
+    """
+    if isinstance(value, timedelta):
+        return value
+
+    if isinstance(value, (int, float)):
+        # below code requires a string
+        value = f'{value:f}'
+    elif isinstance(value, bytes):
+        value = value.decode()
+
+    try:
+        match = standard_duration_re.match(value) or iso8601_duration_re.match(value)
+    except TypeError:
+        raise TypeError('invalid type; expected timedelta, string, bytes, int or float')
+
+    if not match:
+        raise errors.DurationError()
+
+    kw = match.groupdict()
+    sign = -1 if kw.pop('sign', '+') == '-' else 1
+    if kw.get('microseconds'):
+        kw['microseconds'] = kw['microseconds'].ljust(6, '0')
+
+    if kw.get('seconds') and kw.get('microseconds') and kw['seconds'].startswith('-'):
+        kw['microseconds'] = '-' + kw['microseconds']
+
+    kw_ = {k: float(v) for k, v in kw.items() if v is not None}
+
+    return sign * timedelta(**kw_)
diff --git a/lib/pydantic/decorator.py b/lib/pydantic/decorator.py
index c3643468..089aab65 100644
--- a/lib/pydantic/decorator.py
+++ b/lib/pydantic/decorator.py
@@ -1,4 +1,264 @@
-"""The `decorator` module is a backport module from V1."""
-from ._migration import getattr_migration
+from functools import wraps
+from typing import TYPE_CHECKING, Any, Callable, Dict, List, Mapping, Optional, Tuple, Type, TypeVar, Union, overload
 
-__getattr__ = getattr_migration(__name__)
+from . import validator
+from .config import Extra
+from .errors import ConfigError
+from .main import BaseModel, create_model
+from .typing import get_all_type_hints
+from .utils import to_camel
+
+__all__ = ('validate_arguments',)
+
+if TYPE_CHECKING:
+    from .typing import AnyCallable
+
+    AnyCallableT = TypeVar('AnyCallableT', bound=AnyCallable)
+    ConfigType = Union[None, Type[Any], Dict[str, Any]]
+
+
+@overload
+def validate_arguments(func: None = None, *, config: 'ConfigType' = None) -> Callable[['AnyCallableT'], 'AnyCallableT']:
+    ...
+
+
+@overload
+def validate_arguments(func: 'AnyCallableT') -> 'AnyCallableT':
+    ...
+
+
+def validate_arguments(func: Optional['AnyCallableT'] = None, *, config: 'ConfigType' = None) -> Any:
+    """
+    Decorator to validate the arguments passed to a function.
+    """
+
+    def validate(_func: 'AnyCallable') -> 'AnyCallable':
+        vd = ValidatedFunction(_func, config)
+
+        @wraps(_func)
+        def wrapper_function(*args: Any, **kwargs: Any) -> Any:
+            return vd.call(*args, **kwargs)
+
+        wrapper_function.vd = vd  # type: ignore
+        wrapper_function.validate = vd.init_model_instance  # type: ignore
+        wrapper_function.raw_function = vd.raw_function  # type: ignore
+        wrapper_function.model = vd.model  # type: ignore
+        return wrapper_function
+
+    if func:
+        return validate(func)
+    else:
+        return validate
+
+
+ALT_V_ARGS = 'v__args'
+ALT_V_KWARGS = 'v__kwargs'
+V_POSITIONAL_ONLY_NAME = 'v__positional_only'
+V_DUPLICATE_KWARGS = 'v__duplicate_kwargs'
+
+
+class ValidatedFunction:
+    def __init__(self, function: 'AnyCallableT', config: 'ConfigType'):  # noqa C901
+        from inspect import Parameter, signature
+
+        parameters: Mapping[str, Parameter] = signature(function).parameters
+
+        if parameters.keys() & {ALT_V_ARGS, ALT_V_KWARGS, V_POSITIONAL_ONLY_NAME, V_DUPLICATE_KWARGS}:
+            raise ConfigError(
+                f'"{ALT_V_ARGS}", "{ALT_V_KWARGS}", "{V_POSITIONAL_ONLY_NAME}" and "{V_DUPLICATE_KWARGS}" '
+                f'are not permitted as argument names when using the "{validate_arguments.__name__}" decorator'
+            )
+
+        self.raw_function = function
+        self.arg_mapping: Dict[int, str] = {}
+        self.positional_only_args = set()
+        self.v_args_name = 'args'
+        self.v_kwargs_name = 'kwargs'
+
+        type_hints = get_all_type_hints(function)
+        takes_args = False
+        takes_kwargs = False
+        fields: Dict[str, Tuple[Any, Any]] = {}
+        for i, (name, p) in enumerate(parameters.items()):
+            if p.annotation is p.empty:
+                annotation = Any
+            else:
+                annotation = type_hints[name]
+
+            default = ... if p.default is p.empty else p.default
+            if p.kind == Parameter.POSITIONAL_ONLY:
+                self.arg_mapping[i] = name
+                fields[name] = annotation, default
+                fields[V_POSITIONAL_ONLY_NAME] = List[str], None
+                self.positional_only_args.add(name)
+            elif p.kind == Parameter.POSITIONAL_OR_KEYWORD:
+                self.arg_mapping[i] = name
+                fields[name] = annotation, default
+                fields[V_DUPLICATE_KWARGS] = List[str], None
+            elif p.kind == Parameter.KEYWORD_ONLY:
+                fields[name] = annotation, default
+            elif p.kind == Parameter.VAR_POSITIONAL:
+                self.v_args_name = name
+                fields[name] = Tuple[annotation, ...], None
+                takes_args = True
+            else:
+                assert p.kind == Parameter.VAR_KEYWORD, p.kind
+                self.v_kwargs_name = name
+                fields[name] = Dict[str, annotation], None  # type: ignore
+                takes_kwargs = True
+
+        # these checks avoid a clash between "args" and a field with that name
+        if not takes_args and self.v_args_name in fields:
+            self.v_args_name = ALT_V_ARGS
+
+        # same with "kwargs"
+        if not takes_kwargs and self.v_kwargs_name in fields:
+            self.v_kwargs_name = ALT_V_KWARGS
+
+        if not takes_args:
+            # we add the field so validation below can raise the correct exception
+            fields[self.v_args_name] = List[Any], None
+
+        if not takes_kwargs:
+            # same with kwargs
+            fields[self.v_kwargs_name] = Dict[Any, Any], None
+
+        self.create_model(fields, takes_args, takes_kwargs, config)
+
+    def init_model_instance(self, *args: Any, **kwargs: Any) -> BaseModel:
+        values = self.build_values(args, kwargs)
+        return self.model(**values)
+
+    def call(self, *args: Any, **kwargs: Any) -> Any:
+        m = self.init_model_instance(*args, **kwargs)
+        return self.execute(m)
+
+    def build_values(self, args: Tuple[Any, ...], kwargs: Dict[str, Any]) -> Dict[str, Any]:
+        values: Dict[str, Any] = {}
+        if args:
+            arg_iter = enumerate(args)
+            while True:
+                try:
+                    i, a = next(arg_iter)
+                except StopIteration:
+                    break
+                arg_name = self.arg_mapping.get(i)
+                if arg_name is not None:
+                    values[arg_name] = a
+                else:
+                    values[self.v_args_name] = [a] + [a for _, a in arg_iter]
+                    break
+
+        var_kwargs: Dict[str, Any] = {}
+        wrong_positional_args = []
+        duplicate_kwargs = []
+        fields_alias = [
+            field.alias
+            for name, field in self.model.__fields__.items()
+            if name not in (self.v_args_name, self.v_kwargs_name)
+        ]
+        non_var_fields = set(self.model.__fields__) - {self.v_args_name, self.v_kwargs_name}
+        for k, v in kwargs.items():
+            if k in non_var_fields or k in fields_alias:
+                if k in self.positional_only_args:
+                    wrong_positional_args.append(k)
+                if k in values:
+                    duplicate_kwargs.append(k)
+                values[k] = v
+            else:
+                var_kwargs[k] = v
+
+        if var_kwargs:
+            values[self.v_kwargs_name] = var_kwargs
+        if wrong_positional_args:
+            values[V_POSITIONAL_ONLY_NAME] = wrong_positional_args
+        if duplicate_kwargs:
+            values[V_DUPLICATE_KWARGS] = duplicate_kwargs
+        return values
+
+    def execute(self, m: BaseModel) -> Any:
+        d = {k: v for k, v in m._iter() if k in m.__fields_set__ or m.__fields__[k].default_factory}
+        var_kwargs = d.pop(self.v_kwargs_name, {})
+
+        if self.v_args_name in d:
+            args_: List[Any] = []
+            in_kwargs = False
+            kwargs = {}
+            for name, value in d.items():
+                if in_kwargs:
+                    kwargs[name] = value
+                elif name == self.v_args_name:
+                    args_ += value
+                    in_kwargs = True
+                else:
+                    args_.append(value)
+            return self.raw_function(*args_, **kwargs, **var_kwargs)
+        elif self.positional_only_args:
+            args_ = []
+            kwargs = {}
+            for name, value in d.items():
+                if name in self.positional_only_args:
+                    args_.append(value)
+                else:
+                    kwargs[name] = value
+            return self.raw_function(*args_, **kwargs, **var_kwargs)
+        else:
+            return self.raw_function(**d, **var_kwargs)
+
+    def create_model(self, fields: Dict[str, Any], takes_args: bool, takes_kwargs: bool, config: 'ConfigType') -> None:
+        pos_args = len(self.arg_mapping)
+
+        class CustomConfig:
+            pass
+
+        if not TYPE_CHECKING:  # pragma: no branch
+            if isinstance(config, dict):
+                CustomConfig = type('Config', (), config)  # noqa: F811
+            elif config is not None:
+                CustomConfig = config  # noqa: F811
+
+        if hasattr(CustomConfig, 'fields') or hasattr(CustomConfig, 'alias_generator'):
+            raise ConfigError(
+                'Setting the "fields" and "alias_generator" property on custom Config for '
+                '@validate_arguments is not yet supported, please remove.'
+            )
+
+        class DecoratorBaseModel(BaseModel):
+            @validator(self.v_args_name, check_fields=False, allow_reuse=True)
+            def check_args(cls, v: Optional[List[Any]]) -> Optional[List[Any]]:
+                if takes_args or v is None:
+                    return v
+
+                raise TypeError(f'{pos_args} positional arguments expected but {pos_args + len(v)} given')
+
+            @validator(self.v_kwargs_name, check_fields=False, allow_reuse=True)
+            def check_kwargs(cls, v: Optional[Dict[str, Any]]) -> Optional[Dict[str, Any]]:
+                if takes_kwargs or v is None:
+                    return v
+
+                plural = '' if len(v) == 1 else 's'
+                keys = ', '.join(map(repr, v.keys()))
+                raise TypeError(f'unexpected keyword argument{plural}: {keys}')
+
+            @validator(V_POSITIONAL_ONLY_NAME, check_fields=False, allow_reuse=True)
+            def check_positional_only(cls, v: Optional[List[str]]) -> None:
+                if v is None:
+                    return
+
+                plural = '' if len(v) == 1 else 's'
+                keys = ', '.join(map(repr, v))
+                raise TypeError(f'positional-only argument{plural} passed as keyword argument{plural}: {keys}')
+
+            @validator(V_DUPLICATE_KWARGS, check_fields=False, allow_reuse=True)
+            def check_duplicate_kwargs(cls, v: Optional[List[str]]) -> None:
+                if v is None:
+                    return
+
+                plural = '' if len(v) == 1 else 's'
+                keys = ', '.join(map(repr, v))
+                raise TypeError(f'multiple values for argument{plural}: {keys}')
+
+            class Config(CustomConfig):
+                extra = getattr(CustomConfig, 'extra', Extra.forbid)
+
+        self.model = create_model(to_camel(self.raw_function.__name__), __base__=DecoratorBaseModel, **fields)
diff --git a/lib/pydantic/deprecated/__init__.py b/lib/pydantic/deprecated/__init__.py
deleted file mode 100644
index e69de29b..00000000
diff --git a/lib/pydantic/deprecated/class_validators.py b/lib/pydantic/deprecated/class_validators.py
deleted file mode 100644
index 7b48afd2..00000000
--- a/lib/pydantic/deprecated/class_validators.py
+++ /dev/null
@@ -1,253 +0,0 @@
-"""Old `@validator` and `@root_validator` function validators from V1."""
-
-from __future__ import annotations as _annotations
-
-from functools import partial, partialmethod
-from types import FunctionType
-from typing import TYPE_CHECKING, Any, Callable, TypeVar, Union, overload
-from warnings import warn
-
-from typing_extensions import Literal, Protocol, TypeAlias
-
-from .._internal import _decorators, _decorators_v1
-from ..errors import PydanticUserError
-from ..warnings import PydanticDeprecatedSince20
-
-_ALLOW_REUSE_WARNING_MESSAGE = '`allow_reuse` is deprecated and will be ignored; it should no longer be necessary'
-
-
-if TYPE_CHECKING:
-
-    class _OnlyValueValidatorClsMethod(Protocol):
-        def __call__(self, __cls: Any, __value: Any) -> Any:
-            ...
-
-    class _V1ValidatorWithValuesClsMethod(Protocol):
-        def __call__(self, __cls: Any, __value: Any, values: dict[str, Any]) -> Any:
-            ...
-
-    class _V1ValidatorWithValuesKwOnlyClsMethod(Protocol):
-        def __call__(self, __cls: Any, __value: Any, *, values: dict[str, Any]) -> Any:
-            ...
-
-    class _V1ValidatorWithKwargsClsMethod(Protocol):
-        def __call__(self, __cls: Any, **kwargs: Any) -> Any:
-            ...
-
-    class _V1ValidatorWithValuesAndKwargsClsMethod(Protocol):
-        def __call__(self, __cls: Any, values: dict[str, Any], **kwargs: Any) -> Any:
-            ...
-
-    class _V1RootValidatorClsMethod(Protocol):
-        def __call__(
-            self, __cls: Any, __values: _decorators_v1.RootValidatorValues
-        ) -> _decorators_v1.RootValidatorValues:
-            ...
-
-    V1Validator = Union[
-        _OnlyValueValidatorClsMethod,
-        _V1ValidatorWithValuesClsMethod,
-        _V1ValidatorWithValuesKwOnlyClsMethod,
-        _V1ValidatorWithKwargsClsMethod,
-        _V1ValidatorWithValuesAndKwargsClsMethod,
-        _decorators_v1.V1ValidatorWithValues,
-        _decorators_v1.V1ValidatorWithValuesKwOnly,
-        _decorators_v1.V1ValidatorWithKwargs,
-        _decorators_v1.V1ValidatorWithValuesAndKwargs,
-    ]
-
-    V1RootValidator = Union[
-        _V1RootValidatorClsMethod,
-        _decorators_v1.V1RootValidatorFunction,
-    ]
-
-    _PartialClsOrStaticMethod: TypeAlias = Union[classmethod[Any, Any, Any], staticmethod[Any, Any], partialmethod[Any]]
-
-    # Allow both a V1 (assumed pre=False) or V2 (assumed mode='after') validator
-    # We lie to type checkers and say we return the same thing we get
-    # but in reality we return a proxy object that _mostly_ behaves like the wrapped thing
-    _V1ValidatorType = TypeVar('_V1ValidatorType', V1Validator, _PartialClsOrStaticMethod)
-    _V1RootValidatorFunctionType = TypeVar(
-        '_V1RootValidatorFunctionType',
-        _decorators_v1.V1RootValidatorFunction,
-        _V1RootValidatorClsMethod,
-        _PartialClsOrStaticMethod,
-    )
-else:
-    # See PyCharm issues https://youtrack.jetbrains.com/issue/PY-21915
-    # and https://youtrack.jetbrains.com/issue/PY-51428
-    DeprecationWarning = PydanticDeprecatedSince20
-
-
-def validator(
-    __field: str,
-    *fields: str,
-    pre: bool = False,
-    each_item: bool = False,
-    always: bool = False,
-    check_fields: bool | None = None,
-    allow_reuse: bool = False,
-) -> Callable[[_V1ValidatorType], _V1ValidatorType]:
-    """Decorate methods on the class indicating that they should be used to validate fields.
-
-    Args:
-        __field (str): The first field the validator should be called on; this is separate
-            from `fields` to ensure an error is raised if you don't pass at least one.
-        *fields (str): Additional field(s) the validator should be called on.
-        pre (bool, optional): Whether this validator should be called before the standard
-            validators (else after). Defaults to False.
-        each_item (bool, optional): For complex objects (sets, lists etc.) whether to validate
-            individual elements rather than the whole object. Defaults to False.
-        always (bool, optional): Whether this method and other validators should be called even if
-            the value is missing. Defaults to False.
-        check_fields (bool | None, optional): Whether to check that the fields actually exist on the model.
-            Defaults to None.
-        allow_reuse (bool, optional): Whether to track and raise an error if another validator refers to
-            the decorated function. Defaults to False.
-
-    Returns:
-        Callable: A decorator that can be used to decorate a
-            function to be used as a validator.
-    """
-    if allow_reuse is True:  # pragma: no cover
-        warn(_ALLOW_REUSE_WARNING_MESSAGE, DeprecationWarning)
-    fields = tuple((__field, *fields))
-    if isinstance(fields[0], FunctionType):
-        raise PydanticUserError(
-            '`@validator` should be used with fields and keyword arguments, not bare. '
-            "E.g. usage should be `@validator('<field_name>', ...)`",
-            code='validator-no-fields',
-        )
-    elif not all(isinstance(field, str) for field in fields):
-        raise PydanticUserError(
-            '`@validator` fields should be passed as separate string args. '
-            "E.g. usage should be `@validator('<field_name_1>', '<field_name_2>', ...)`",
-            code='validator-invalid-fields',
-        )
-
-    warn(
-        'Pydantic V1 style `@validator` validators are deprecated.'
-        ' You should migrate to Pydantic V2 style `@field_validator` validators,'
-        ' see the migration guide for more details',
-        DeprecationWarning,
-        stacklevel=2,
-    )
-
-    mode: Literal['before', 'after'] = 'before' if pre is True else 'after'
-
-    def dec(f: Any) -> _decorators.PydanticDescriptorProxy[Any]:
-        if _decorators.is_instance_method_from_sig(f):
-            raise PydanticUserError(
-                '`@validator` cannot be applied to instance methods', code='validator-instance-method'
-            )
-        # auto apply the @classmethod decorator
-        f = _decorators.ensure_classmethod_based_on_signature(f)
-        wrap = _decorators_v1.make_generic_v1_field_validator
-        validator_wrapper_info = _decorators.ValidatorDecoratorInfo(
-            fields=fields,
-            mode=mode,
-            each_item=each_item,
-            always=always,
-            check_fields=check_fields,
-        )
-        return _decorators.PydanticDescriptorProxy(f, validator_wrapper_info, shim=wrap)
-
-    return dec  # type: ignore[return-value]
-
-
-@overload
-def root_validator(
-    *,
-    # if you don't specify `pre` the default is `pre=False`
-    # which means you need to specify `skip_on_failure=True`
-    skip_on_failure: Literal[True],
-    allow_reuse: bool = ...,
-) -> Callable[
-    [_V1RootValidatorFunctionType],
-    _V1RootValidatorFunctionType,
-]:
-    ...
-
-
-@overload
-def root_validator(
-    *,
-    # if you specify `pre=True` then you don't need to specify
-    # `skip_on_failure`, in fact it is not allowed as an argument!
-    pre: Literal[True],
-    allow_reuse: bool = ...,
-) -> Callable[
-    [_V1RootValidatorFunctionType],
-    _V1RootValidatorFunctionType,
-]:
-    ...
-
-
-@overload
-def root_validator(
-    *,
-    # if you explicitly specify `pre=False` then you
-    # MUST specify `skip_on_failure=True`
-    pre: Literal[False],
-    skip_on_failure: Literal[True],
-    allow_reuse: bool = ...,
-) -> Callable[
-    [_V1RootValidatorFunctionType],
-    _V1RootValidatorFunctionType,
-]:
-    ...
-
-
-def root_validator(
-    *__args,
-    pre: bool = False,
-    skip_on_failure: bool = False,
-    allow_reuse: bool = False,
-) -> Any:
-    """Decorate methods on a model indicating that they should be used to validate (and perhaps
-    modify) data either before or after standard model parsing/validation is performed.
-
-    Args:
-        pre (bool, optional): Whether this validator should be called before the standard
-            validators (else after). Defaults to False.
-        skip_on_failure (bool, optional): Whether to stop validation and return as soon as a
-            failure is encountered. Defaults to False.
-        allow_reuse (bool, optional): Whether to track and raise an error if another validator
-            refers to the decorated function. Defaults to False.
-
-    Returns:
-        Any: A decorator that can be used to decorate a function to be used as a root_validator.
-    """
-    warn(
-        'Pydantic V1 style `@root_validator` validators are deprecated.'
-        ' You should migrate to Pydantic V2 style `@model_validator` validators,'
-        ' see the migration guide for more details',
-        DeprecationWarning,
-        stacklevel=2,
-    )
-
-    if __args:
-        # Ensure a nice error is raised if someone attempts to use the bare decorator
-        return root_validator()(*__args)  # type: ignore
-
-    if allow_reuse is True:  # pragma: no cover
-        warn(_ALLOW_REUSE_WARNING_MESSAGE, DeprecationWarning)
-    mode: Literal['before', 'after'] = 'before' if pre is True else 'after'
-    if pre is False and skip_on_failure is not True:
-        raise PydanticUserError(
-            'If you use `@root_validator` with pre=False (the default) you MUST specify `skip_on_failure=True`.'
-            ' Note that `@root_validator` is deprecated and should be replaced with `@model_validator`.',
-            code='root-validator-pre-skip',
-        )
-
-    wrap = partial(_decorators_v1.make_v1_generic_root_validator, pre=pre)
-
-    def dec(f: Callable[..., Any] | classmethod[Any, Any, Any] | staticmethod[Any, Any]) -> Any:
-        if _decorators.is_instance_method_from_sig(f):
-            raise TypeError('`@root_validator` cannot be applied to instance methods')
-        # auto apply the @classmethod decorator
-        res = _decorators.ensure_classmethod_based_on_signature(f)
-        dec_info = _decorators.RootValidatorDecoratorInfo(mode=mode)
-        return _decorators.PydanticDescriptorProxy(res, dec_info, shim=wrap)
-
-    return dec
diff --git a/lib/pydantic/deprecated/config.py b/lib/pydantic/deprecated/config.py
deleted file mode 100644
index 45400c65..00000000
--- a/lib/pydantic/deprecated/config.py
+++ /dev/null
@@ -1,72 +0,0 @@
-from __future__ import annotations as _annotations
-
-import warnings
-from typing import TYPE_CHECKING, Any
-
-from typing_extensions import Literal, deprecated
-
-from .._internal import _config
-from ..warnings import PydanticDeprecatedSince20
-
-if not TYPE_CHECKING:
-    # See PyCharm issues https://youtrack.jetbrains.com/issue/PY-21915
-    # and https://youtrack.jetbrains.com/issue/PY-51428
-    DeprecationWarning = PydanticDeprecatedSince20
-
-__all__ = 'BaseConfig', 'Extra'
-
-
-class _ConfigMetaclass(type):
-    def __getattr__(self, item: str) -> Any:
-        try:
-            obj = _config.config_defaults[item]
-            warnings.warn(_config.DEPRECATION_MESSAGE, DeprecationWarning)
-            return obj
-        except KeyError as exc:
-            raise AttributeError(f"type object '{self.__name__}' has no attribute {exc}") from exc
-
-
-@deprecated('BaseConfig is deprecated. Use the `pydantic.ConfigDict` instead.', category=PydanticDeprecatedSince20)
-class BaseConfig(metaclass=_ConfigMetaclass):
-    """This class is only retained for backwards compatibility.
-
-    !!! Warning "Deprecated"
-        BaseConfig is deprecated. Use the [`pydantic.ConfigDict`][pydantic.ConfigDict] instead.
-    """
-
-    def __getattr__(self, item: str) -> Any:
-        try:
-            obj = super().__getattribute__(item)
-            warnings.warn(_config.DEPRECATION_MESSAGE, DeprecationWarning)
-            return obj
-        except AttributeError as exc:
-            try:
-                return getattr(type(self), item)
-            except AttributeError:
-                # re-raising changes the displayed text to reflect that `self` is not a type
-                raise AttributeError(str(exc)) from exc
-
-    def __init_subclass__(cls, **kwargs: Any) -> None:
-        warnings.warn(_config.DEPRECATION_MESSAGE, DeprecationWarning)
-        return super().__init_subclass__(**kwargs)
-
-
-class _ExtraMeta(type):
-    def __getattribute__(self, __name: str) -> Any:
-        # The @deprecated decorator accesses other attributes, so we only emit a warning for the expected ones
-        if __name in {'allow', 'ignore', 'forbid'}:
-            warnings.warn(
-                "`pydantic.config.Extra` is deprecated, use literal values instead (e.g. `extra='allow'`)",
-                DeprecationWarning,
-                stacklevel=2,
-            )
-        return super().__getattribute__(__name)
-
-
-@deprecated(
-    "Extra is deprecated. Use literal values instead (e.g. `extra='allow'`)", category=PydanticDeprecatedSince20
-)
-class Extra(metaclass=_ExtraMeta):
-    allow: Literal['allow'] = 'allow'
-    ignore: Literal['ignore'] = 'ignore'
-    forbid: Literal['forbid'] = 'forbid'
diff --git a/lib/pydantic/deprecated/copy_internals.py b/lib/pydantic/deprecated/copy_internals.py
deleted file mode 100644
index efe5de28..00000000
--- a/lib/pydantic/deprecated/copy_internals.py
+++ /dev/null
@@ -1,224 +0,0 @@
-from __future__ import annotations as _annotations
-
-import typing
-from copy import deepcopy
-from enum import Enum
-from typing import Any, Tuple
-
-import typing_extensions
-
-from .._internal import (
-    _model_construction,
-    _typing_extra,
-    _utils,
-)
-
-if typing.TYPE_CHECKING:
-    from .. import BaseModel
-    from .._internal._utils import AbstractSetIntStr, MappingIntStrAny
-
-    AnyClassMethod = classmethod[Any, Any, Any]
-    TupleGenerator = typing.Generator[Tuple[str, Any], None, None]
-    Model = typing.TypeVar('Model', bound='BaseModel')
-    # should be `set[int] | set[str] | dict[int, IncEx] | dict[str, IncEx] | None`, but mypy can't cope
-    IncEx: typing_extensions.TypeAlias = 'set[int] | set[str] | dict[int, Any] | dict[str, Any] | None'
-
-_object_setattr = _model_construction.object_setattr
-
-
-def _iter(
-    self: BaseModel,
-    to_dict: bool = False,
-    by_alias: bool = False,
-    include: AbstractSetIntStr | MappingIntStrAny | None = None,
-    exclude: AbstractSetIntStr | MappingIntStrAny | None = None,
-    exclude_unset: bool = False,
-    exclude_defaults: bool = False,
-    exclude_none: bool = False,
-) -> TupleGenerator:
-    # Merge field set excludes with explicit exclude parameter with explicit overriding field set options.
-    # The extra "is not None" guards are not logically necessary but optimizes performance for the simple case.
-    if exclude is not None:
-        exclude = _utils.ValueItems.merge(
-            {k: v.exclude for k, v in self.model_fields.items() if v.exclude is not None}, exclude
-        )
-
-    if include is not None:
-        include = _utils.ValueItems.merge({k: True for k in self.model_fields}, include, intersect=True)
-
-    allowed_keys = _calculate_keys(self, include=include, exclude=exclude, exclude_unset=exclude_unset)  # type: ignore
-    if allowed_keys is None and not (to_dict or by_alias or exclude_unset or exclude_defaults or exclude_none):
-        # huge boost for plain _iter()
-        yield from self.__dict__.items()
-        if self.__pydantic_extra__:
-            yield from self.__pydantic_extra__.items()
-        return
-
-    value_exclude = _utils.ValueItems(self, exclude) if exclude is not None else None
-    value_include = _utils.ValueItems(self, include) if include is not None else None
-
-    if self.__pydantic_extra__ is None:
-        items = self.__dict__.items()
-    else:
-        items = list(self.__dict__.items()) + list(self.__pydantic_extra__.items())
-
-    for field_key, v in items:
-        if (allowed_keys is not None and field_key not in allowed_keys) or (exclude_none and v is None):
-            continue
-
-        if exclude_defaults:
-            try:
-                field = self.model_fields[field_key]
-            except KeyError:
-                pass
-            else:
-                if not field.is_required() and field.default == v:
-                    continue
-
-        if by_alias and field_key in self.model_fields:
-            dict_key = self.model_fields[field_key].alias or field_key
-        else:
-            dict_key = field_key
-
-        if to_dict or value_include or value_exclude:
-            v = _get_value(
-                type(self),
-                v,
-                to_dict=to_dict,
-                by_alias=by_alias,
-                include=value_include and value_include.for_element(field_key),
-                exclude=value_exclude and value_exclude.for_element(field_key),
-                exclude_unset=exclude_unset,
-                exclude_defaults=exclude_defaults,
-                exclude_none=exclude_none,
-            )
-        yield dict_key, v
-
-
-def _copy_and_set_values(
-    self: Model,
-    values: dict[str, Any],
-    fields_set: set[str],
-    extra: dict[str, Any] | None = None,
-    private: dict[str, Any] | None = None,
-    *,
-    deep: bool,  # UP006
-) -> Model:
-    if deep:
-        # chances of having empty dict here are quite low for using smart_deepcopy
-        values = deepcopy(values)
-        extra = deepcopy(extra)
-        private = deepcopy(private)
-
-    cls = self.__class__
-    m = cls.__new__(cls)
-    _object_setattr(m, '__dict__', values)
-    _object_setattr(m, '__pydantic_extra__', extra)
-    _object_setattr(m, '__pydantic_fields_set__', fields_set)
-    _object_setattr(m, '__pydantic_private__', private)
-
-    return m
-
-
-@typing.no_type_check
-def _get_value(
-    cls: type[BaseModel],
-    v: Any,
-    to_dict: bool,
-    by_alias: bool,
-    include: AbstractSetIntStr | MappingIntStrAny | None,
-    exclude: AbstractSetIntStr | MappingIntStrAny | None,
-    exclude_unset: bool,
-    exclude_defaults: bool,
-    exclude_none: bool,
-) -> Any:
-    from .. import BaseModel
-
-    if isinstance(v, BaseModel):
-        if to_dict:
-            return v.model_dump(
-                by_alias=by_alias,
-                exclude_unset=exclude_unset,
-                exclude_defaults=exclude_defaults,
-                include=include,  # type: ignore
-                exclude=exclude,  # type: ignore
-                exclude_none=exclude_none,
-            )
-        else:
-            return v.copy(include=include, exclude=exclude)
-
-    value_exclude = _utils.ValueItems(v, exclude) if exclude else None
-    value_include = _utils.ValueItems(v, include) if include else None
-
-    if isinstance(v, dict):
-        return {
-            k_: _get_value(
-                cls,
-                v_,
-                to_dict=to_dict,
-                by_alias=by_alias,
-                exclude_unset=exclude_unset,
-                exclude_defaults=exclude_defaults,
-                include=value_include and value_include.for_element(k_),
-                exclude=value_exclude and value_exclude.for_element(k_),
-                exclude_none=exclude_none,
-            )
-            for k_, v_ in v.items()
-            if (not value_exclude or not value_exclude.is_excluded(k_))
-            and (not value_include or value_include.is_included(k_))
-        }
-
-    elif _utils.sequence_like(v):
-        seq_args = (
-            _get_value(
-                cls,
-                v_,
-                to_dict=to_dict,
-                by_alias=by_alias,
-                exclude_unset=exclude_unset,
-                exclude_defaults=exclude_defaults,
-                include=value_include and value_include.for_element(i),
-                exclude=value_exclude and value_exclude.for_element(i),
-                exclude_none=exclude_none,
-            )
-            for i, v_ in enumerate(v)
-            if (not value_exclude or not value_exclude.is_excluded(i))
-            and (not value_include or value_include.is_included(i))
-        )
-
-        return v.__class__(*seq_args) if _typing_extra.is_namedtuple(v.__class__) else v.__class__(seq_args)
-
-    elif isinstance(v, Enum) and getattr(cls.model_config, 'use_enum_values', False):
-        return v.value
-
-    else:
-        return v
-
-
-def _calculate_keys(
-    self: BaseModel,
-    include: MappingIntStrAny | None,
-    exclude: MappingIntStrAny | None,
-    exclude_unset: bool,
-    update: typing.Dict[str, Any] | None = None,  # noqa UP006
-) -> typing.AbstractSet[str] | None:
-    if include is None and exclude is None and exclude_unset is False:
-        return None
-
-    keys: typing.AbstractSet[str]
-    if exclude_unset:
-        keys = self.__pydantic_fields_set__.copy()
-    else:
-        keys = set(self.__dict__.keys())
-        keys = keys | (self.__pydantic_extra__ or {}).keys()
-
-    if include is not None:
-        keys &= include.keys()
-
-    if update:
-        keys -= update.keys()
-
-    if exclude:
-        keys -= {k for k, v in exclude.items() if _utils.ValueItems.is_true(v)}
-
-    return keys
diff --git a/lib/pydantic/deprecated/decorator.py b/lib/pydantic/deprecated/decorator.py
deleted file mode 100644
index 36bd0690..00000000
--- a/lib/pydantic/deprecated/decorator.py
+++ /dev/null
@@ -1,279 +0,0 @@
-import warnings
-from functools import wraps
-from typing import TYPE_CHECKING, Any, Callable, Dict, List, Mapping, Optional, Tuple, Type, TypeVar, Union, overload
-
-from typing_extensions import deprecated
-
-from .._internal import _config, _typing_extra
-from ..alias_generators import to_pascal
-from ..errors import PydanticUserError
-from ..functional_validators import field_validator
-from ..main import BaseModel, create_model
-from ..warnings import PydanticDeprecatedSince20
-
-if not TYPE_CHECKING:
-    # See PyCharm issues https://youtrack.jetbrains.com/issue/PY-21915
-    # and https://youtrack.jetbrains.com/issue/PY-51428
-    DeprecationWarning = PydanticDeprecatedSince20
-
-__all__ = ('validate_arguments',)
-
-if TYPE_CHECKING:
-    AnyCallable = Callable[..., Any]
-
-    AnyCallableT = TypeVar('AnyCallableT', bound=AnyCallable)
-    ConfigType = Union[None, Type[Any], Dict[str, Any]]
-
-
-@overload
-def validate_arguments(func: None = None, *, config: 'ConfigType' = None) -> Callable[['AnyCallableT'], 'AnyCallableT']:
-    ...
-
-
-@overload
-def validate_arguments(func: 'AnyCallableT') -> 'AnyCallableT':
-    ...
-
-
-@deprecated(
-    'The `validate_arguments` method is deprecated; use `validate_call` instead.',
-    category=None,
-)
-def validate_arguments(func: Optional['AnyCallableT'] = None, *, config: 'ConfigType' = None) -> Any:
-    """Decorator to validate the arguments passed to a function."""
-    warnings.warn(
-        'The `validate_arguments` method is deprecated; use `validate_call` instead.',
-        PydanticDeprecatedSince20,
-        stacklevel=2,
-    )
-
-    def validate(_func: 'AnyCallable') -> 'AnyCallable':
-        vd = ValidatedFunction(_func, config)
-
-        @wraps(_func)
-        def wrapper_function(*args: Any, **kwargs: Any) -> Any:
-            return vd.call(*args, **kwargs)
-
-        wrapper_function.vd = vd  # type: ignore
-        wrapper_function.validate = vd.init_model_instance  # type: ignore
-        wrapper_function.raw_function = vd.raw_function  # type: ignore
-        wrapper_function.model = vd.model  # type: ignore
-        return wrapper_function
-
-    if func:
-        return validate(func)
-    else:
-        return validate
-
-
-ALT_V_ARGS = 'v__args'
-ALT_V_KWARGS = 'v__kwargs'
-V_POSITIONAL_ONLY_NAME = 'v__positional_only'
-V_DUPLICATE_KWARGS = 'v__duplicate_kwargs'
-
-
-class ValidatedFunction:
-    def __init__(self, function: 'AnyCallable', config: 'ConfigType'):
-        from inspect import Parameter, signature
-
-        parameters: Mapping[str, Parameter] = signature(function).parameters
-
-        if parameters.keys() & {ALT_V_ARGS, ALT_V_KWARGS, V_POSITIONAL_ONLY_NAME, V_DUPLICATE_KWARGS}:
-            raise PydanticUserError(
-                f'"{ALT_V_ARGS}", "{ALT_V_KWARGS}", "{V_POSITIONAL_ONLY_NAME}" and "{V_DUPLICATE_KWARGS}" '
-                f'are not permitted as argument names when using the "{validate_arguments.__name__}" decorator',
-                code=None,
-            )
-
-        self.raw_function = function
-        self.arg_mapping: Dict[int, str] = {}
-        self.positional_only_args: set[str] = set()
-        self.v_args_name = 'args'
-        self.v_kwargs_name = 'kwargs'
-
-        type_hints = _typing_extra.get_type_hints(function, include_extras=True)
-        takes_args = False
-        takes_kwargs = False
-        fields: Dict[str, Tuple[Any, Any]] = {}
-        for i, (name, p) in enumerate(parameters.items()):
-            if p.annotation is p.empty:
-                annotation = Any
-            else:
-                annotation = type_hints[name]
-
-            default = ... if p.default is p.empty else p.default
-            if p.kind == Parameter.POSITIONAL_ONLY:
-                self.arg_mapping[i] = name
-                fields[name] = annotation, default
-                fields[V_POSITIONAL_ONLY_NAME] = List[str], None
-                self.positional_only_args.add(name)
-            elif p.kind == Parameter.POSITIONAL_OR_KEYWORD:
-                self.arg_mapping[i] = name
-                fields[name] = annotation, default
-                fields[V_DUPLICATE_KWARGS] = List[str], None
-            elif p.kind == Parameter.KEYWORD_ONLY:
-                fields[name] = annotation, default
-            elif p.kind == Parameter.VAR_POSITIONAL:
-                self.v_args_name = name
-                fields[name] = Tuple[annotation, ...], None
-                takes_args = True
-            else:
-                assert p.kind == Parameter.VAR_KEYWORD, p.kind
-                self.v_kwargs_name = name
-                fields[name] = Dict[str, annotation], None
-                takes_kwargs = True
-
-        # these checks avoid a clash between "args" and a field with that name
-        if not takes_args and self.v_args_name in fields:
-            self.v_args_name = ALT_V_ARGS
-
-        # same with "kwargs"
-        if not takes_kwargs and self.v_kwargs_name in fields:
-            self.v_kwargs_name = ALT_V_KWARGS
-
-        if not takes_args:
-            # we add the field so validation below can raise the correct exception
-            fields[self.v_args_name] = List[Any], None
-
-        if not takes_kwargs:
-            # same with kwargs
-            fields[self.v_kwargs_name] = Dict[Any, Any], None
-
-        self.create_model(fields, takes_args, takes_kwargs, config)
-
-    def init_model_instance(self, *args: Any, **kwargs: Any) -> BaseModel:
-        values = self.build_values(args, kwargs)
-        return self.model(**values)
-
-    def call(self, *args: Any, **kwargs: Any) -> Any:
-        m = self.init_model_instance(*args, **kwargs)
-        return self.execute(m)
-
-    def build_values(self, args: Tuple[Any, ...], kwargs: Dict[str, Any]) -> Dict[str, Any]:
-        values: Dict[str, Any] = {}
-        if args:
-            arg_iter = enumerate(args)
-            while True:
-                try:
-                    i, a = next(arg_iter)
-                except StopIteration:
-                    break
-                arg_name = self.arg_mapping.get(i)
-                if arg_name is not None:
-                    values[arg_name] = a
-                else:
-                    values[self.v_args_name] = [a] + [a for _, a in arg_iter]
-                    break
-
-        var_kwargs: Dict[str, Any] = {}
-        wrong_positional_args = []
-        duplicate_kwargs = []
-        fields_alias = [
-            field.alias
-            for name, field in self.model.model_fields.items()
-            if name not in (self.v_args_name, self.v_kwargs_name)
-        ]
-        non_var_fields = set(self.model.model_fields) - {self.v_args_name, self.v_kwargs_name}
-        for k, v in kwargs.items():
-            if k in non_var_fields or k in fields_alias:
-                if k in self.positional_only_args:
-                    wrong_positional_args.append(k)
-                if k in values:
-                    duplicate_kwargs.append(k)
-                values[k] = v
-            else:
-                var_kwargs[k] = v
-
-        if var_kwargs:
-            values[self.v_kwargs_name] = var_kwargs
-        if wrong_positional_args:
-            values[V_POSITIONAL_ONLY_NAME] = wrong_positional_args
-        if duplicate_kwargs:
-            values[V_DUPLICATE_KWARGS] = duplicate_kwargs
-        return values
-
-    def execute(self, m: BaseModel) -> Any:
-        d = {k: v for k, v in m.__dict__.items() if k in m.__pydantic_fields_set__ or m.model_fields[k].default_factory}
-        var_kwargs = d.pop(self.v_kwargs_name, {})
-
-        if self.v_args_name in d:
-            args_: List[Any] = []
-            in_kwargs = False
-            kwargs = {}
-            for name, value in d.items():
-                if in_kwargs:
-                    kwargs[name] = value
-                elif name == self.v_args_name:
-                    args_ += value
-                    in_kwargs = True
-                else:
-                    args_.append(value)
-            return self.raw_function(*args_, **kwargs, **var_kwargs)
-        elif self.positional_only_args:
-            args_ = []
-            kwargs = {}
-            for name, value in d.items():
-                if name in self.positional_only_args:
-                    args_.append(value)
-                else:
-                    kwargs[name] = value
-            return self.raw_function(*args_, **kwargs, **var_kwargs)
-        else:
-            return self.raw_function(**d, **var_kwargs)
-
-    def create_model(self, fields: Dict[str, Any], takes_args: bool, takes_kwargs: bool, config: 'ConfigType') -> None:
-        pos_args = len(self.arg_mapping)
-
-        config_wrapper = _config.ConfigWrapper(config)
-
-        if config_wrapper.alias_generator:
-            raise PydanticUserError(
-                'Setting the "alias_generator" property on custom Config for '
-                '@validate_arguments is not yet supported, please remove.',
-                code=None,
-            )
-        if config_wrapper.extra is None:
-            config_wrapper.config_dict['extra'] = 'forbid'
-
-        class DecoratorBaseModel(BaseModel):
-            @field_validator(self.v_args_name, check_fields=False)
-            @classmethod
-            def check_args(cls, v: Optional[List[Any]]) -> Optional[List[Any]]:
-                if takes_args or v is None:
-                    return v
-
-                raise TypeError(f'{pos_args} positional arguments expected but {pos_args + len(v)} given')
-
-            @field_validator(self.v_kwargs_name, check_fields=False)
-            @classmethod
-            def check_kwargs(cls, v: Optional[Dict[str, Any]]) -> Optional[Dict[str, Any]]:
-                if takes_kwargs or v is None:
-                    return v
-
-                plural = '' if len(v) == 1 else 's'
-                keys = ', '.join(map(repr, v.keys()))
-                raise TypeError(f'unexpected keyword argument{plural}: {keys}')
-
-            @field_validator(V_POSITIONAL_ONLY_NAME, check_fields=False)
-            @classmethod
-            def check_positional_only(cls, v: Optional[List[str]]) -> None:
-                if v is None:
-                    return
-
-                plural = '' if len(v) == 1 else 's'
-                keys = ', '.join(map(repr, v))
-                raise TypeError(f'positional-only argument{plural} passed as keyword argument{plural}: {keys}')
-
-            @field_validator(V_DUPLICATE_KWARGS, check_fields=False)
-            @classmethod
-            def check_duplicate_kwargs(cls, v: Optional[List[str]]) -> None:
-                if v is None:
-                    return
-
-                plural = '' if len(v) == 1 else 's'
-                keys = ', '.join(map(repr, v))
-                raise TypeError(f'multiple values for argument{plural}: {keys}')
-
-            model_config = config_wrapper.config_dict
-
-        self.model = create_model(to_pascal(self.raw_function.__name__), __base__=DecoratorBaseModel, **fields)
diff --git a/lib/pydantic/deprecated/json.py b/lib/pydantic/deprecated/json.py
deleted file mode 100644
index 79e2f44a..00000000
--- a/lib/pydantic/deprecated/json.py
+++ /dev/null
@@ -1,140 +0,0 @@
-import datetime
-import warnings
-from collections import deque
-from decimal import Decimal
-from enum import Enum
-from ipaddress import IPv4Address, IPv4Interface, IPv4Network, IPv6Address, IPv6Interface, IPv6Network
-from pathlib import Path
-from re import Pattern
-from types import GeneratorType
-from typing import TYPE_CHECKING, Any, Callable, Dict, Type, Union
-from uuid import UUID
-
-from typing_extensions import deprecated
-
-from ..color import Color
-from ..networks import NameEmail
-from ..types import SecretBytes, SecretStr
-from ..warnings import PydanticDeprecatedSince20
-
-if not TYPE_CHECKING:
-    # See PyCharm issues https://youtrack.jetbrains.com/issue/PY-21915
-    # and https://youtrack.jetbrains.com/issue/PY-51428
-    DeprecationWarning = PydanticDeprecatedSince20
-
-__all__ = 'pydantic_encoder', 'custom_pydantic_encoder', 'timedelta_isoformat'
-
-
-def isoformat(o: Union[datetime.date, datetime.time]) -> str:
-    return o.isoformat()
-
-
-def decimal_encoder(dec_value: Decimal) -> Union[int, float]:
-    """Encodes a Decimal as int of there's no exponent, otherwise float.
-
-    This is useful when we use ConstrainedDecimal to represent Numeric(x,0)
-    where a integer (but not int typed) is used. Encoding this as a float
-    results in failed round-tripping between encode and parse.
-    Our Id type is a prime example of this.
-
-    >>> decimal_encoder(Decimal("1.0"))
-    1.0
-
-    >>> decimal_encoder(Decimal("1"))
-    1
-    """
-    exponent = dec_value.as_tuple().exponent
-    if isinstance(exponent, int) and exponent >= 0:
-        return int(dec_value)
-    else:
-        return float(dec_value)
-
-
-ENCODERS_BY_TYPE: Dict[Type[Any], Callable[[Any], Any]] = {
-    bytes: lambda o: o.decode(),
-    Color: str,
-    datetime.date: isoformat,
-    datetime.datetime: isoformat,
-    datetime.time: isoformat,
-    datetime.timedelta: lambda td: td.total_seconds(),
-    Decimal: decimal_encoder,
-    Enum: lambda o: o.value,
-    frozenset: list,
-    deque: list,
-    GeneratorType: list,
-    IPv4Address: str,
-    IPv4Interface: str,
-    IPv4Network: str,
-    IPv6Address: str,
-    IPv6Interface: str,
-    IPv6Network: str,
-    NameEmail: str,
-    Path: str,
-    Pattern: lambda o: o.pattern,
-    SecretBytes: str,
-    SecretStr: str,
-    set: list,
-    UUID: str,
-}
-
-
-@deprecated(
-    '`pydantic_encoder` is deprecated, use `pydantic_core.to_jsonable_python` instead.',
-    category=None,
-)
-def pydantic_encoder(obj: Any) -> Any:
-    warnings.warn(
-        '`pydantic_encoder` is deprecated, use `pydantic_core.to_jsonable_python` instead.',
-        category=PydanticDeprecatedSince20,
-        stacklevel=2,
-    )
-    from dataclasses import asdict, is_dataclass
-
-    from ..main import BaseModel
-
-    if isinstance(obj, BaseModel):
-        return obj.model_dump()
-    elif is_dataclass(obj):
-        return asdict(obj)
-
-    # Check the class type and its superclasses for a matching encoder
-    for base in obj.__class__.__mro__[:-1]:
-        try:
-            encoder = ENCODERS_BY_TYPE[base]
-        except KeyError:
-            continue
-        return encoder(obj)
-    else:  # We have exited the for loop without finding a suitable encoder
-        raise TypeError(f"Object of type '{obj.__class__.__name__}' is not JSON serializable")
-
-
-# TODO: Add a suggested migration path once there is a way to use custom encoders
-@deprecated(
-    '`custom_pydantic_encoder` is deprecated, use `BaseModel.model_dump` instead.',
-    category=None,
-)
-def custom_pydantic_encoder(type_encoders: Dict[Any, Callable[[Type[Any]], Any]], obj: Any) -> Any:
-    warnings.warn(
-        '`custom_pydantic_encoder` is deprecated, use `BaseModel.model_dump` instead.',
-        category=PydanticDeprecatedSince20,
-        stacklevel=2,
-    )
-    # Check the class type and its superclasses for a matching encoder
-    for base in obj.__class__.__mro__[:-1]:
-        try:
-            encoder = type_encoders[base]
-        except KeyError:
-            continue
-
-        return encoder(obj)
-    else:  # We have exited the for loop without finding a suitable encoder
-        return pydantic_encoder(obj)
-
-
-@deprecated('`timedelta_isoformat` is deprecated.', category=None)
-def timedelta_isoformat(td: datetime.timedelta) -> str:
-    """ISO 8601 encoding for Python timedelta object."""
-    warnings.warn('`timedelta_isoformat` is deprecated.', category=PydanticDeprecatedSince20, stacklevel=2)
-    minutes, seconds = divmod(td.seconds, 60)
-    hours, minutes = divmod(minutes, 60)
-    return f'{"-" if td.days < 0 else ""}P{abs(td.days)}DT{hours:d}H{minutes:d}M{seconds:d}.{td.microseconds:06d}S'
diff --git a/lib/pydantic/deprecated/parse.py b/lib/pydantic/deprecated/parse.py
deleted file mode 100644
index 2a92e62b..00000000
--- a/lib/pydantic/deprecated/parse.py
+++ /dev/null
@@ -1,80 +0,0 @@
-from __future__ import annotations
-
-import json
-import pickle
-import warnings
-from enum import Enum
-from pathlib import Path
-from typing import TYPE_CHECKING, Any, Callable
-
-from typing_extensions import deprecated
-
-from ..warnings import PydanticDeprecatedSince20
-
-if not TYPE_CHECKING:
-    # See PyCharm issues https://youtrack.jetbrains.com/issue/PY-21915
-    # and https://youtrack.jetbrains.com/issue/PY-51428
-    DeprecationWarning = PydanticDeprecatedSince20
-
-
-class Protocol(str, Enum):
-    json = 'json'
-    pickle = 'pickle'
-
-
-@deprecated('`load_str_bytes` is deprecated.', category=None)
-def load_str_bytes(
-    b: str | bytes,
-    *,
-    content_type: str | None = None,
-    encoding: str = 'utf8',
-    proto: Protocol | None = None,
-    allow_pickle: bool = False,
-    json_loads: Callable[[str], Any] = json.loads,
-) -> Any:
-    warnings.warn('`load_str_bytes` is deprecated.', category=PydanticDeprecatedSince20, stacklevel=2)
-    if proto is None and content_type:
-        if content_type.endswith(('json', 'javascript')):
-            pass
-        elif allow_pickle and content_type.endswith('pickle'):
-            proto = Protocol.pickle
-        else:
-            raise TypeError(f'Unknown content-type: {content_type}')
-
-    proto = proto or Protocol.json
-
-    if proto == Protocol.json:
-        if isinstance(b, bytes):
-            b = b.decode(encoding)
-        return json_loads(b)  # type: ignore
-    elif proto == Protocol.pickle:
-        if not allow_pickle:
-            raise RuntimeError('Trying to decode with pickle with allow_pickle=False')
-        bb = b if isinstance(b, bytes) else b.encode()  # type: ignore
-        return pickle.loads(bb)
-    else:
-        raise TypeError(f'Unknown protocol: {proto}')
-
-
-@deprecated('`load_file` is deprecated.', category=None)
-def load_file(
-    path: str | Path,
-    *,
-    content_type: str | None = None,
-    encoding: str = 'utf8',
-    proto: Protocol | None = None,
-    allow_pickle: bool = False,
-    json_loads: Callable[[str], Any] = json.loads,
-) -> Any:
-    warnings.warn('`load_file` is deprecated.', category=PydanticDeprecatedSince20, stacklevel=2)
-    path = Path(path)
-    b = path.read_bytes()
-    if content_type is None:
-        if path.suffix in ('.js', '.json'):
-            proto = Protocol.json
-        elif path.suffix == '.pkl':
-            proto = Protocol.pickle
-
-    return load_str_bytes(
-        b, proto=proto, content_type=content_type, encoding=encoding, allow_pickle=allow_pickle, json_loads=json_loads
-    )
diff --git a/lib/pydantic/deprecated/tools.py b/lib/pydantic/deprecated/tools.py
deleted file mode 100644
index b04eae40..00000000
--- a/lib/pydantic/deprecated/tools.py
+++ /dev/null
@@ -1,103 +0,0 @@
-from __future__ import annotations
-
-import json
-import warnings
-from typing import TYPE_CHECKING, Any, Callable, Type, TypeVar, Union
-
-from typing_extensions import deprecated
-
-from ..json_schema import DEFAULT_REF_TEMPLATE, GenerateJsonSchema
-from ..type_adapter import TypeAdapter
-from ..warnings import PydanticDeprecatedSince20
-
-if not TYPE_CHECKING:
-    # See PyCharm issues https://youtrack.jetbrains.com/issue/PY-21915
-    # and https://youtrack.jetbrains.com/issue/PY-51428
-    DeprecationWarning = PydanticDeprecatedSince20
-
-__all__ = 'parse_obj_as', 'schema_of', 'schema_json_of'
-
-NameFactory = Union[str, Callable[[Type[Any]], str]]
-
-
-T = TypeVar('T')
-
-
-@deprecated(
-    '`parse_obj_as` is deprecated. Use `pydantic.TypeAdapter.validate_python` instead.',
-    category=None,
-)
-def parse_obj_as(type_: type[T], obj: Any, type_name: NameFactory | None = None) -> T:
-    warnings.warn(
-        '`parse_obj_as` is deprecated. Use `pydantic.TypeAdapter.validate_python` instead.',
-        category=PydanticDeprecatedSince20,
-        stacklevel=2,
-    )
-    if type_name is not None:  # pragma: no cover
-        warnings.warn(
-            'The type_name parameter is deprecated. parse_obj_as no longer creates temporary models',
-            DeprecationWarning,
-            stacklevel=2,
-        )
-    return TypeAdapter(type_).validate_python(obj)
-
-
-@deprecated(
-    '`schema_of` is deprecated. Use `pydantic.TypeAdapter.json_schema` instead.',
-    category=None,
-)
-def schema_of(
-    type_: Any,
-    *,
-    title: NameFactory | None = None,
-    by_alias: bool = True,
-    ref_template: str = DEFAULT_REF_TEMPLATE,
-    schema_generator: type[GenerateJsonSchema] = GenerateJsonSchema,
-) -> dict[str, Any]:
-    """Generate a JSON schema (as dict) for the passed model or dynamically generated one."""
-    warnings.warn(
-        '`schema_of` is deprecated. Use `pydantic.TypeAdapter.json_schema` instead.',
-        category=PydanticDeprecatedSince20,
-        stacklevel=2,
-    )
-    res = TypeAdapter(type_).json_schema(
-        by_alias=by_alias,
-        schema_generator=schema_generator,
-        ref_template=ref_template,
-    )
-    if title is not None:
-        if isinstance(title, str):
-            res['title'] = title
-        else:
-            warnings.warn(
-                'Passing a callable for the `title` parameter is deprecated and no longer supported',
-                DeprecationWarning,
-                stacklevel=2,
-            )
-            res['title'] = title(type_)
-    return res
-
-
-@deprecated(
-    '`schema_json_of` is deprecated. Use `pydantic.TypeAdapter.json_schema` instead.',
-    category=None,
-)
-def schema_json_of(
-    type_: Any,
-    *,
-    title: NameFactory | None = None,
-    by_alias: bool = True,
-    ref_template: str = DEFAULT_REF_TEMPLATE,
-    schema_generator: type[GenerateJsonSchema] = GenerateJsonSchema,
-    **dumps_kwargs: Any,
-) -> str:
-    """Generate a JSON schema (as JSON) for the passed model or dynamically generated one."""
-    warnings.warn(
-        '`schema_json_of` is deprecated. Use `pydantic.TypeAdapter.json_schema` instead.',
-        category=PydanticDeprecatedSince20,
-        stacklevel=2,
-    )
-    return json.dumps(
-        schema_of(type_, title=title, by_alias=by_alias, ref_template=ref_template, schema_generator=schema_generator),
-        **dumps_kwargs,
-    )
diff --git a/lib/pydantic/env_settings.py b/lib/pydantic/env_settings.py
index 662f5900..e9988c01 100644
--- a/lib/pydantic/env_settings.py
+++ b/lib/pydantic/env_settings.py
@@ -1,4 +1,346 @@
-"""The `env_settings` module is a backport module from V1."""
-from ._migration import getattr_migration
+import os
+import warnings
+from pathlib import Path
+from typing import AbstractSet, Any, Callable, ClassVar, Dict, List, Mapping, Optional, Tuple, Type, Union
 
-__getattr__ = getattr_migration(__name__)
+from .config import BaseConfig, Extra
+from .fields import ModelField
+from .main import BaseModel
+from .typing import StrPath, display_as_type, get_origin, is_union
+from .utils import deep_update, path_type, sequence_like
+
+env_file_sentinel = str(object())
+
+SettingsSourceCallable = Callable[['BaseSettings'], Dict[str, Any]]
+DotenvType = Union[StrPath, List[StrPath], Tuple[StrPath, ...]]
+
+
+class SettingsError(ValueError):
+    pass
+
+
+class BaseSettings(BaseModel):
+    """
+    Base class for settings, allowing values to be overridden by environment variables.
+
+    This is useful in production for secrets you do not wish to save in code, it plays nicely with docker(-compose),
+    Heroku and any 12 factor app design.
+    """
+
+    def __init__(
+        __pydantic_self__,
+        _env_file: Optional[DotenvType] = env_file_sentinel,
+        _env_file_encoding: Optional[str] = None,
+        _env_nested_delimiter: Optional[str] = None,
+        _secrets_dir: Optional[StrPath] = None,
+        **values: Any,
+    ) -> None:
+        # Uses something other than `self` the first arg to allow "self" as a settable attribute
+        super().__init__(
+            **__pydantic_self__._build_values(
+                values,
+                _env_file=_env_file,
+                _env_file_encoding=_env_file_encoding,
+                _env_nested_delimiter=_env_nested_delimiter,
+                _secrets_dir=_secrets_dir,
+            )
+        )
+
+    def _build_values(
+        self,
+        init_kwargs: Dict[str, Any],
+        _env_file: Optional[DotenvType] = None,
+        _env_file_encoding: Optional[str] = None,
+        _env_nested_delimiter: Optional[str] = None,
+        _secrets_dir: Optional[StrPath] = None,
+    ) -> Dict[str, Any]:
+        # Configure built-in sources
+        init_settings = InitSettingsSource(init_kwargs=init_kwargs)
+        env_settings = EnvSettingsSource(
+            env_file=(_env_file if _env_file != env_file_sentinel else self.__config__.env_file),
+            env_file_encoding=(
+                _env_file_encoding if _env_file_encoding is not None else self.__config__.env_file_encoding
+            ),
+            env_nested_delimiter=(
+                _env_nested_delimiter if _env_nested_delimiter is not None else self.__config__.env_nested_delimiter
+            ),
+            env_prefix_len=len(self.__config__.env_prefix),
+        )
+        file_secret_settings = SecretsSettingsSource(secrets_dir=_secrets_dir or self.__config__.secrets_dir)
+        # Provide a hook to set built-in sources priority and add / remove sources
+        sources = self.__config__.customise_sources(
+            init_settings=init_settings, env_settings=env_settings, file_secret_settings=file_secret_settings
+        )
+        if sources:
+            return deep_update(*reversed([source(self) for source in sources]))
+        else:
+            # no one should mean to do this, but I think returning an empty dict is marginally preferable
+            # to an informative error and much better than a confusing error
+            return {}
+
+    class Config(BaseConfig):
+        env_prefix: str = ''
+        env_file: Optional[DotenvType] = None
+        env_file_encoding: Optional[str] = None
+        env_nested_delimiter: Optional[str] = None
+        secrets_dir: Optional[StrPath] = None
+        validate_all: bool = True
+        extra: Extra = Extra.forbid
+        arbitrary_types_allowed: bool = True
+        case_sensitive: bool = False
+
+        @classmethod
+        def prepare_field(cls, field: ModelField) -> None:
+            env_names: Union[List[str], AbstractSet[str]]
+            field_info_from_config = cls.get_field_info(field.name)
+
+            env = field_info_from_config.get('env') or field.field_info.extra.get('env')
+            if env is None:
+                if field.has_alias:
+                    warnings.warn(
+                        'aliases are no longer used by BaseSettings to define which environment variables to read. '
+                        'Instead use the "env" field setting. '
+                        'See https://pydantic-docs.helpmanual.io/usage/settings/#environment-variable-names',
+                        FutureWarning,
+                    )
+                env_names = {cls.env_prefix + field.name}
+            elif isinstance(env, str):
+                env_names = {env}
+            elif isinstance(env, (set, frozenset)):
+                env_names = env
+            elif sequence_like(env):
+                env_names = list(env)
+            else:
+                raise TypeError(f'invalid field env: {env!r} ({display_as_type(env)}); should be string, list or set')
+
+            if not cls.case_sensitive:
+                env_names = env_names.__class__(n.lower() for n in env_names)
+            field.field_info.extra['env_names'] = env_names
+
+        @classmethod
+        def customise_sources(
+            cls,
+            init_settings: SettingsSourceCallable,
+            env_settings: SettingsSourceCallable,
+            file_secret_settings: SettingsSourceCallable,
+        ) -> Tuple[SettingsSourceCallable, ...]:
+            return init_settings, env_settings, file_secret_settings
+
+        @classmethod
+        def parse_env_var(cls, field_name: str, raw_val: str) -> Any:
+            return cls.json_loads(raw_val)
+
+    # populated by the metaclass using the Config class defined above, annotated here to help IDEs only
+    __config__: ClassVar[Type[Config]]
+
+
+class InitSettingsSource:
+    __slots__ = ('init_kwargs',)
+
+    def __init__(self, init_kwargs: Dict[str, Any]):
+        self.init_kwargs = init_kwargs
+
+    def __call__(self, settings: BaseSettings) -> Dict[str, Any]:
+        return self.init_kwargs
+
+    def __repr__(self) -> str:
+        return f'InitSettingsSource(init_kwargs={self.init_kwargs!r})'
+
+
+class EnvSettingsSource:
+    __slots__ = ('env_file', 'env_file_encoding', 'env_nested_delimiter', 'env_prefix_len')
+
+    def __init__(
+        self,
+        env_file: Optional[DotenvType],
+        env_file_encoding: Optional[str],
+        env_nested_delimiter: Optional[str] = None,
+        env_prefix_len: int = 0,
+    ):
+        self.env_file: Optional[DotenvType] = env_file
+        self.env_file_encoding: Optional[str] = env_file_encoding
+        self.env_nested_delimiter: Optional[str] = env_nested_delimiter
+        self.env_prefix_len: int = env_prefix_len
+
+    def __call__(self, settings: BaseSettings) -> Dict[str, Any]:  # noqa C901
+        """
+        Build environment variables suitable for passing to the Model.
+        """
+        d: Dict[str, Any] = {}
+
+        if settings.__config__.case_sensitive:
+            env_vars: Mapping[str, Optional[str]] = os.environ
+        else:
+            env_vars = {k.lower(): v for k, v in os.environ.items()}
+
+        dotenv_vars = self._read_env_files(settings.__config__.case_sensitive)
+        if dotenv_vars:
+            env_vars = {**dotenv_vars, **env_vars}
+
+        for field in settings.__fields__.values():
+            env_val: Optional[str] = None
+            for env_name in field.field_info.extra['env_names']:
+                env_val = env_vars.get(env_name)
+                if env_val is not None:
+                    break
+
+            is_complex, allow_parse_failure = self.field_is_complex(field)
+            if is_complex:
+                if env_val is None:
+                    # field is complex but no value found so far, try explode_env_vars
+                    env_val_built = self.explode_env_vars(field, env_vars)
+                    if env_val_built:
+                        d[field.alias] = env_val_built
+                else:
+                    # field is complex and there's a value, decode that as JSON, then add explode_env_vars
+                    try:
+                        env_val = settings.__config__.parse_env_var(field.name, env_val)
+                    except ValueError as e:
+                        if not allow_parse_failure:
+                            raise SettingsError(f'error parsing env var "{env_name}"') from e
+
+                    if isinstance(env_val, dict):
+                        d[field.alias] = deep_update(env_val, self.explode_env_vars(field, env_vars))
+                    else:
+                        d[field.alias] = env_val
+            elif env_val is not None:
+                # simplest case, field is not complex, we only need to add the value if it was found
+                d[field.alias] = env_val
+
+        return d
+
+    def _read_env_files(self, case_sensitive: bool) -> Dict[str, Optional[str]]:
+        env_files = self.env_file
+        if env_files is None:
+            return {}
+
+        if isinstance(env_files, (str, os.PathLike)):
+            env_files = [env_files]
+
+        dotenv_vars = {}
+        for env_file in env_files:
+            env_path = Path(env_file).expanduser()
+            if env_path.is_file():
+                dotenv_vars.update(
+                    read_env_file(env_path, encoding=self.env_file_encoding, case_sensitive=case_sensitive)
+                )
+
+        return dotenv_vars
+
+    def field_is_complex(self, field: ModelField) -> Tuple[bool, bool]:
+        """
+        Find out if a field is complex, and if so whether JSON errors should be ignored
+        """
+        if field.is_complex():
+            allow_parse_failure = False
+        elif is_union(get_origin(field.type_)) and field.sub_fields and any(f.is_complex() for f in field.sub_fields):
+            allow_parse_failure = True
+        else:
+            return False, False
+
+        return True, allow_parse_failure
+
+    def explode_env_vars(self, field: ModelField, env_vars: Mapping[str, Optional[str]]) -> Dict[str, Any]:
+        """
+        Process env_vars and extract the values of keys containing env_nested_delimiter into nested dictionaries.
+
+        This is applied to a single field, hence filtering by env_var prefix.
+        """
+        prefixes = [f'{env_name}{self.env_nested_delimiter}' for env_name in field.field_info.extra['env_names']]
+        result: Dict[str, Any] = {}
+        for env_name, env_val in env_vars.items():
+            if not any(env_name.startswith(prefix) for prefix in prefixes):
+                continue
+            # we remove the prefix before splitting in case the prefix has characters in common with the delimiter
+            env_name_without_prefix = env_name[self.env_prefix_len :]
+            _, *keys, last_key = env_name_without_prefix.split(self.env_nested_delimiter)
+            env_var = result
+            for key in keys:
+                env_var = env_var.setdefault(key, {})
+            env_var[last_key] = env_val
+
+        return result
+
+    def __repr__(self) -> str:
+        return (
+            f'EnvSettingsSource(env_file={self.env_file!r}, env_file_encoding={self.env_file_encoding!r}, '
+            f'env_nested_delimiter={self.env_nested_delimiter!r})'
+        )
+
+
+class SecretsSettingsSource:
+    __slots__ = ('secrets_dir',)
+
+    def __init__(self, secrets_dir: Optional[StrPath]):
+        self.secrets_dir: Optional[StrPath] = secrets_dir
+
+    def __call__(self, settings: BaseSettings) -> Dict[str, Any]:
+        """
+        Build fields from "secrets" files.
+        """
+        secrets: Dict[str, Optional[str]] = {}
+
+        if self.secrets_dir is None:
+            return secrets
+
+        secrets_path = Path(self.secrets_dir).expanduser()
+
+        if not secrets_path.exists():
+            warnings.warn(f'directory "{secrets_path}" does not exist')
+            return secrets
+
+        if not secrets_path.is_dir():
+            raise SettingsError(f'secrets_dir must reference a directory, not a {path_type(secrets_path)}')
+
+        for field in settings.__fields__.values():
+            for env_name in field.field_info.extra['env_names']:
+                path = find_case_path(secrets_path, env_name, settings.__config__.case_sensitive)
+                if not path:
+                    # path does not exist, we curently don't return a warning for this
+                    continue
+
+                if path.is_file():
+                    secret_value = path.read_text().strip()
+                    if field.is_complex():
+                        try:
+                            secret_value = settings.__config__.parse_env_var(field.name, secret_value)
+                        except ValueError as e:
+                            raise SettingsError(f'error parsing env var "{env_name}"') from e
+
+                    secrets[field.alias] = secret_value
+                else:
+                    warnings.warn(
+                        f'attempted to load secret file "{path}" but found a {path_type(path)} instead.',
+                        stacklevel=4,
+                    )
+        return secrets
+
+    def __repr__(self) -> str:
+        return f'SecretsSettingsSource(secrets_dir={self.secrets_dir!r})'
+
+
+def read_env_file(
+    file_path: StrPath, *, encoding: str = None, case_sensitive: bool = False
+) -> Dict[str, Optional[str]]:
+    try:
+        from dotenv import dotenv_values
+    except ImportError as e:
+        raise ImportError('python-dotenv is not installed, run `pip install pydantic[dotenv]`') from e
+
+    file_vars: Dict[str, Optional[str]] = dotenv_values(file_path, encoding=encoding or 'utf8')
+    if not case_sensitive:
+        return {k.lower(): v for k, v in file_vars.items()}
+    else:
+        return file_vars
+
+
+def find_case_path(dir_path: Path, file_name: str, case_sensitive: bool) -> Optional[Path]:
+    """
+    Find a file within path's directory matching filename, optionally ignoring case.
+    """
+    for f in dir_path.iterdir():
+        if f.name == file_name:
+            return f
+        elif not case_sensitive and f.name.lower() == file_name.lower():
+            return f
+    return None
diff --git a/lib/pydantic/error_wrappers.py b/lib/pydantic/error_wrappers.py
index 5144eeee..5d3204f4 100644
--- a/lib/pydantic/error_wrappers.py
+++ b/lib/pydantic/error_wrappers.py
@@ -1,4 +1,162 @@
-"""The `error_wrappers` module is a backport module from V1."""
-from ._migration import getattr_migration
+import json
+from typing import TYPE_CHECKING, Any, Dict, Generator, List, Optional, Sequence, Tuple, Type, Union
 
-__getattr__ = getattr_migration(__name__)
+from .json import pydantic_encoder
+from .utils import Representation
+
+if TYPE_CHECKING:
+    from typing_extensions import TypedDict
+
+    from .config import BaseConfig
+    from .types import ModelOrDc
+    from .typing import ReprArgs
+
+    Loc = Tuple[Union[int, str], ...]
+
+    class _ErrorDictRequired(TypedDict):
+        loc: Loc
+        msg: str
+        type: str
+
+    class ErrorDict(_ErrorDictRequired, total=False):
+        ctx: Dict[str, Any]
+
+
+__all__ = 'ErrorWrapper', 'ValidationError'
+
+
+class ErrorWrapper(Representation):
+    __slots__ = 'exc', '_loc'
+
+    def __init__(self, exc: Exception, loc: Union[str, 'Loc']) -> None:
+        self.exc = exc
+        self._loc = loc
+
+    def loc_tuple(self) -> 'Loc':
+        if isinstance(self._loc, tuple):
+            return self._loc
+        else:
+            return (self._loc,)
+
+    def __repr_args__(self) -> 'ReprArgs':
+        return [('exc', self.exc), ('loc', self.loc_tuple())]
+
+
+# ErrorList is something like Union[List[Union[List[ErrorWrapper], ErrorWrapper]], ErrorWrapper]
+# but recursive, therefore just use:
+ErrorList = Union[Sequence[Any], ErrorWrapper]
+
+
+class ValidationError(Representation, ValueError):
+    __slots__ = 'raw_errors', 'model', '_error_cache'
+
+    def __init__(self, errors: Sequence[ErrorList], model: 'ModelOrDc') -> None:
+        self.raw_errors = errors
+        self.model = model
+        self._error_cache: Optional[List['ErrorDict']] = None
+
+    def errors(self) -> List['ErrorDict']:
+        if self._error_cache is None:
+            try:
+                config = self.model.__config__  # type: ignore
+            except AttributeError:
+                config = self.model.__pydantic_model__.__config__  # type: ignore
+            self._error_cache = list(flatten_errors(self.raw_errors, config))
+        return self._error_cache
+
+    def json(self, *, indent: Union[None, int, str] = 2) -> str:
+        return json.dumps(self.errors(), indent=indent, default=pydantic_encoder)
+
+    def __str__(self) -> str:
+        errors = self.errors()
+        no_errors = len(errors)
+        return (
+            f'{no_errors} validation error{"" if no_errors == 1 else "s"} for {self.model.__name__}\n'
+            f'{display_errors(errors)}'
+        )
+
+    def __repr_args__(self) -> 'ReprArgs':
+        return [('model', self.model.__name__), ('errors', self.errors())]
+
+
+def display_errors(errors: List['ErrorDict']) -> str:
+    return '\n'.join(f'{_display_error_loc(e)}\n  {e["msg"]} ({_display_error_type_and_ctx(e)})' for e in errors)
+
+
+def _display_error_loc(error: 'ErrorDict') -> str:
+    return ' -> '.join(str(e) for e in error['loc'])
+
+
+def _display_error_type_and_ctx(error: 'ErrorDict') -> str:
+    t = 'type=' + error['type']
+    ctx = error.get('ctx')
+    if ctx:
+        return t + ''.join(f'; {k}={v}' for k, v in ctx.items())
+    else:
+        return t
+
+
+def flatten_errors(
+    errors: Sequence[Any], config: Type['BaseConfig'], loc: Optional['Loc'] = None
+) -> Generator['ErrorDict', None, None]:
+    for error in errors:
+        if isinstance(error, ErrorWrapper):
+
+            if loc:
+                error_loc = loc + error.loc_tuple()
+            else:
+                error_loc = error.loc_tuple()
+
+            if isinstance(error.exc, ValidationError):
+                yield from flatten_errors(error.exc.raw_errors, config, error_loc)
+            else:
+                yield error_dict(error.exc, config, error_loc)
+        elif isinstance(error, list):
+            yield from flatten_errors(error, config, loc=loc)
+        else:
+            raise RuntimeError(f'Unknown error object: {error}')
+
+
+def error_dict(exc: Exception, config: Type['BaseConfig'], loc: 'Loc') -> 'ErrorDict':
+    type_ = get_exc_type(exc.__class__)
+    msg_template = config.error_msg_templates.get(type_) or getattr(exc, 'msg_template', None)
+    ctx = exc.__dict__
+    if msg_template:
+        msg = msg_template.format(**ctx)
+    else:
+        msg = str(exc)
+
+    d: 'ErrorDict' = {'loc': loc, 'msg': msg, 'type': type_}
+
+    if ctx:
+        d['ctx'] = ctx
+
+    return d
+
+
+_EXC_TYPE_CACHE: Dict[Type[Exception], str] = {}
+
+
+def get_exc_type(cls: Type[Exception]) -> str:
+    # slightly more efficient than using lru_cache since we don't need to worry about the cache filling up
+    try:
+        return _EXC_TYPE_CACHE[cls]
+    except KeyError:
+        r = _get_exc_type(cls)
+        _EXC_TYPE_CACHE[cls] = r
+        return r
+
+
+def _get_exc_type(cls: Type[Exception]) -> str:
+    if issubclass(cls, AssertionError):
+        return 'assertion_error'
+
+    base_name = 'type_error' if issubclass(cls, TypeError) else 'value_error'
+    if cls in (TypeError, ValueError):
+        # just TypeError or ValueError, no extra code
+        return base_name
+
+    # if it's not a TypeError or ValueError, we just take the lowercase of the exception name
+    # no chaining or snake case logic, use "code" for more complex error types.
+    code = getattr(cls, 'code', None) or cls.__name__.replace('Error', '').lower()
+    return base_name + '.' + code
diff --git a/lib/pydantic/errors.py b/lib/pydantic/errors.py
index c5fa9612..7bdafdd1 100644
--- a/lib/pydantic/errors.py
+++ b/lib/pydantic/errors.py
@@ -1,152 +1,646 @@
-"""Pydantic-specific errors."""
-from __future__ import annotations as _annotations
+from decimal import Decimal
+from pathlib import Path
+from typing import TYPE_CHECKING, Any, Callable, Sequence, Set, Tuple, Type, Union
 
-import re
+from .typing import display_as_type
 
-from typing_extensions import Literal, Self
-
-from ._migration import getattr_migration
-from .version import version_short
+if TYPE_CHECKING:
+    from .typing import DictStrAny
 
+# explicitly state exports to avoid "from .errors import *" also importing Decimal, Path etc.
 __all__ = (
-    'PydanticUserError',
-    'PydanticUndefinedAnnotation',
-    'PydanticImportError',
-    'PydanticSchemaGenerationError',
-    'PydanticInvalidForJsonSchema',
-    'PydanticErrorCodes',
+    'PydanticTypeError',
+    'PydanticValueError',
+    'ConfigError',
+    'MissingError',
+    'ExtraError',
+    'NoneIsNotAllowedError',
+    'NoneIsAllowedError',
+    'WrongConstantError',
+    'NotNoneError',
+    'BoolError',
+    'BytesError',
+    'DictError',
+    'EmailError',
+    'UrlError',
+    'UrlSchemeError',
+    'UrlSchemePermittedError',
+    'UrlUserInfoError',
+    'UrlHostError',
+    'UrlHostTldError',
+    'UrlPortError',
+    'UrlExtraError',
+    'EnumError',
+    'IntEnumError',
+    'EnumMemberError',
+    'IntegerError',
+    'FloatError',
+    'PathError',
+    'PathNotExistsError',
+    'PathNotAFileError',
+    'PathNotADirectoryError',
+    'PyObjectError',
+    'SequenceError',
+    'ListError',
+    'SetError',
+    'FrozenSetError',
+    'TupleError',
+    'TupleLengthError',
+    'ListMinLengthError',
+    'ListMaxLengthError',
+    'ListUniqueItemsError',
+    'SetMinLengthError',
+    'SetMaxLengthError',
+    'FrozenSetMinLengthError',
+    'FrozenSetMaxLengthError',
+    'AnyStrMinLengthError',
+    'AnyStrMaxLengthError',
+    'StrError',
+    'StrRegexError',
+    'NumberNotGtError',
+    'NumberNotGeError',
+    'NumberNotLtError',
+    'NumberNotLeError',
+    'NumberNotMultipleError',
+    'DecimalError',
+    'DecimalIsNotFiniteError',
+    'DecimalMaxDigitsError',
+    'DecimalMaxPlacesError',
+    'DecimalWholeDigitsError',
+    'DateTimeError',
+    'DateError',
+    'DateNotInThePastError',
+    'DateNotInTheFutureError',
+    'TimeError',
+    'DurationError',
+    'HashableError',
+    'UUIDError',
+    'UUIDVersionError',
+    'ArbitraryTypeError',
+    'ClassError',
+    'SubclassError',
+    'JsonError',
+    'JsonTypeError',
+    'PatternError',
+    'DataclassTypeError',
+    'CallableError',
+    'IPvAnyAddressError',
+    'IPvAnyInterfaceError',
+    'IPvAnyNetworkError',
+    'IPv4AddressError',
+    'IPv6AddressError',
+    'IPv4NetworkError',
+    'IPv6NetworkError',
+    'IPv4InterfaceError',
+    'IPv6InterfaceError',
+    'ColorError',
+    'StrictBoolError',
+    'NotDigitError',
+    'LuhnValidationError',
+    'InvalidLengthForBrand',
+    'InvalidByteSize',
+    'InvalidByteSizeUnit',
+    'MissingDiscriminator',
+    'InvalidDiscriminator',
 )
 
-# We use this URL to allow for future flexibility about how we host the docs, while allowing for Pydantic
-# code in the while with "old" URLs to still work.
-# 'u' refers to "user errors" - e.g. errors caused by developers using pydantic, as opposed to validation errors.
-DEV_ERROR_DOCS_URL = f'https://errors.pydantic.dev/{version_short()}/u/'
-PydanticErrorCodes = Literal[
-    'class-not-fully-defined',
-    'custom-json-schema',
-    'decorator-missing-field',
-    'discriminator-no-field',
-    'discriminator-alias-type',
-    'discriminator-needs-literal',
-    'discriminator-alias',
-    'discriminator-validator',
-    'callable-discriminator-no-tag',
-    'typed-dict-version',
-    'model-field-overridden',
-    'model-field-missing-annotation',
-    'config-both',
-    'removed-kwargs',
-    'invalid-for-json-schema',
-    'json-schema-already-used',
-    'base-model-instantiated',
-    'undefined-annotation',
-    'schema-for-unknown-type',
-    'import-error',
-    'create-model-field-definitions',
-    'create-model-config-base',
-    'validator-no-fields',
-    'validator-invalid-fields',
-    'validator-instance-method',
-    'root-validator-pre-skip',
-    'model-serializer-instance-method',
-    'validator-field-config-info',
-    'validator-v1-signature',
-    'validator-signature',
-    'field-serializer-signature',
-    'model-serializer-signature',
-    'multiple-field-serializers',
-    'invalid_annotated_type',
-    'type-adapter-config-unused',
-    'root-model-extra',
-    'unevaluable-type-annotation',
-    'dataclass-init-false-extra-allow',
-    'clashing-init-and-init-var',
-]
+
+def cls_kwargs(cls: Type['PydanticErrorMixin'], ctx: 'DictStrAny') -> 'PydanticErrorMixin':
+    """
+    For built-in exceptions like ValueError or TypeError, we need to implement
+    __reduce__ to override the default behaviour (instead of __getstate__/__setstate__)
+    By default pickle protocol 2 calls `cls.__new__(cls, *args)`.
+    Since we only use kwargs, we need a little constructor to change that.
+    Note: the callable can't be a lambda as pickle looks in the namespace to find it
+    """
+    return cls(**ctx)
 
 
 class PydanticErrorMixin:
-    """A mixin class for common functionality shared by all Pydantic-specific errors.
+    code: str
+    msg_template: str
 
-    Attributes:
-        message: A message describing the error.
-        code: An optional error code from PydanticErrorCodes enum.
-    """
-
-    def __init__(self, message: str, *, code: PydanticErrorCodes | None) -> None:
-        self.message = message
-        self.code = code
+    def __init__(self, **ctx: Any) -> None:
+        self.__dict__ = ctx
 
     def __str__(self) -> str:
-        if self.code is None:
-            return self.message
-        else:
-            return f'{self.message}\n\nFor further information visit {DEV_ERROR_DOCS_URL}{self.code}'
+        return self.msg_template.format(**self.__dict__)
+
+    def __reduce__(self) -> Tuple[Callable[..., 'PydanticErrorMixin'], Tuple[Type['PydanticErrorMixin'], 'DictStrAny']]:
+        return cls_kwargs, (self.__class__, self.__dict__)
 
 
-class PydanticUserError(PydanticErrorMixin, TypeError):
-    """An error raised due to incorrect use of Pydantic."""
+class PydanticTypeError(PydanticErrorMixin, TypeError):
+    pass
 
 
-class PydanticUndefinedAnnotation(PydanticErrorMixin, NameError):
-    """A subclass of `NameError` raised when handling undefined annotations during `CoreSchema` generation.
-
-    Attributes:
-        name: Name of the error.
-        message: Description of the error.
-    """
-
-    def __init__(self, name: str, message: str) -> None:
-        self.name = name
-        super().__init__(message=message, code='undefined-annotation')
-
-    @classmethod
-    def from_name_error(cls, name_error: NameError) -> Self:
-        """Convert a `NameError` to a `PydanticUndefinedAnnotation` error.
-
-        Args:
-            name_error: `NameError` to be converted.
-
-        Returns:
-            Converted `PydanticUndefinedAnnotation` error.
-        """
-        try:
-            name = name_error.name  # type: ignore  # python > 3.10
-        except AttributeError:
-            name = re.search(r".*'(.+?)'", str(name_error)).group(1)  # type: ignore[union-attr]
-        return cls(name=name, message=str(name_error))
+class PydanticValueError(PydanticErrorMixin, ValueError):
+    pass
 
 
-class PydanticImportError(PydanticErrorMixin, ImportError):
-    """An error raised when an import fails due to module changes between V1 and V2.
-
-    Attributes:
-        message: Description of the error.
-    """
-
-    def __init__(self, message: str) -> None:
-        super().__init__(message, code='import-error')
+class ConfigError(RuntimeError):
+    pass
 
 
-class PydanticSchemaGenerationError(PydanticUserError):
-    """An error raised during failures to generate a `CoreSchema` for some type.
-
-    Attributes:
-        message: Description of the error.
-    """
-
-    def __init__(self, message: str) -> None:
-        super().__init__(message, code='schema-for-unknown-type')
+class MissingError(PydanticValueError):
+    msg_template = 'field required'
 
 
-class PydanticInvalidForJsonSchema(PydanticUserError):
-    """An error raised during failures to generate a JSON schema for some `CoreSchema`.
-
-    Attributes:
-        message: Description of the error.
-    """
-
-    def __init__(self, message: str) -> None:
-        super().__init__(message, code='invalid-for-json-schema')
+class ExtraError(PydanticValueError):
+    msg_template = 'extra fields not permitted'
 
 
-__getattr__ = getattr_migration(__name__)
+class NoneIsNotAllowedError(PydanticTypeError):
+    code = 'none.not_allowed'
+    msg_template = 'none is not an allowed value'
+
+
+class NoneIsAllowedError(PydanticTypeError):
+    code = 'none.allowed'
+    msg_template = 'value is not none'
+
+
+class WrongConstantError(PydanticValueError):
+    code = 'const'
+
+    def __str__(self) -> str:
+        permitted = ', '.join(repr(v) for v in self.permitted)  # type: ignore
+        return f'unexpected value; permitted: {permitted}'
+
+
+class NotNoneError(PydanticTypeError):
+    code = 'not_none'
+    msg_template = 'value is not None'
+
+
+class BoolError(PydanticTypeError):
+    msg_template = 'value could not be parsed to a boolean'
+
+
+class BytesError(PydanticTypeError):
+    msg_template = 'byte type expected'
+
+
+class DictError(PydanticTypeError):
+    msg_template = 'value is not a valid dict'
+
+
+class EmailError(PydanticValueError):
+    msg_template = 'value is not a valid email address'
+
+
+class UrlError(PydanticValueError):
+    code = 'url'
+
+
+class UrlSchemeError(UrlError):
+    code = 'url.scheme'
+    msg_template = 'invalid or missing URL scheme'
+
+
+class UrlSchemePermittedError(UrlError):
+    code = 'url.scheme'
+    msg_template = 'URL scheme not permitted'
+
+    def __init__(self, allowed_schemes: Set[str]):
+        super().__init__(allowed_schemes=allowed_schemes)
+
+
+class UrlUserInfoError(UrlError):
+    code = 'url.userinfo'
+    msg_template = 'userinfo required in URL but missing'
+
+
+class UrlHostError(UrlError):
+    code = 'url.host'
+    msg_template = 'URL host invalid'
+
+
+class UrlHostTldError(UrlError):
+    code = 'url.host'
+    msg_template = 'URL host invalid, top level domain required'
+
+
+class UrlPortError(UrlError):
+    code = 'url.port'
+    msg_template = 'URL port invalid, port cannot exceed 65535'
+
+
+class UrlExtraError(UrlError):
+    code = 'url.extra'
+    msg_template = 'URL invalid, extra characters found after valid URL: {extra!r}'
+
+
+class EnumMemberError(PydanticTypeError):
+    code = 'enum'
+
+    def __str__(self) -> str:
+        permitted = ', '.join(repr(v.value) for v in self.enum_values)  # type: ignore
+        return f'value is not a valid enumeration member; permitted: {permitted}'
+
+
+class IntegerError(PydanticTypeError):
+    msg_template = 'value is not a valid integer'
+
+
+class FloatError(PydanticTypeError):
+    msg_template = 'value is not a valid float'
+
+
+class PathError(PydanticTypeError):
+    msg_template = 'value is not a valid path'
+
+
+class _PathValueError(PydanticValueError):
+    def __init__(self, *, path: Path) -> None:
+        super().__init__(path=str(path))
+
+
+class PathNotExistsError(_PathValueError):
+    code = 'path.not_exists'
+    msg_template = 'file or directory at path "{path}" does not exist'
+
+
+class PathNotAFileError(_PathValueError):
+    code = 'path.not_a_file'
+    msg_template = 'path "{path}" does not point to a file'
+
+
+class PathNotADirectoryError(_PathValueError):
+    code = 'path.not_a_directory'
+    msg_template = 'path "{path}" does not point to a directory'
+
+
+class PyObjectError(PydanticTypeError):
+    msg_template = 'ensure this value contains valid import path or valid callable: {error_message}'
+
+
+class SequenceError(PydanticTypeError):
+    msg_template = 'value is not a valid sequence'
+
+
+class IterableError(PydanticTypeError):
+    msg_template = 'value is not a valid iterable'
+
+
+class ListError(PydanticTypeError):
+    msg_template = 'value is not a valid list'
+
+
+class SetError(PydanticTypeError):
+    msg_template = 'value is not a valid set'
+
+
+class FrozenSetError(PydanticTypeError):
+    msg_template = 'value is not a valid frozenset'
+
+
+class DequeError(PydanticTypeError):
+    msg_template = 'value is not a valid deque'
+
+
+class TupleError(PydanticTypeError):
+    msg_template = 'value is not a valid tuple'
+
+
+class TupleLengthError(PydanticValueError):
+    code = 'tuple.length'
+    msg_template = 'wrong tuple length {actual_length}, expected {expected_length}'
+
+    def __init__(self, *, actual_length: int, expected_length: int) -> None:
+        super().__init__(actual_length=actual_length, expected_length=expected_length)
+
+
+class ListMinLengthError(PydanticValueError):
+    code = 'list.min_items'
+    msg_template = 'ensure this value has at least {limit_value} items'
+
+    def __init__(self, *, limit_value: int) -> None:
+        super().__init__(limit_value=limit_value)
+
+
+class ListMaxLengthError(PydanticValueError):
+    code = 'list.max_items'
+    msg_template = 'ensure this value has at most {limit_value} items'
+
+    def __init__(self, *, limit_value: int) -> None:
+        super().__init__(limit_value=limit_value)
+
+
+class ListUniqueItemsError(PydanticValueError):
+    code = 'list.unique_items'
+    msg_template = 'the list has duplicated items'
+
+
+class SetMinLengthError(PydanticValueError):
+    code = 'set.min_items'
+    msg_template = 'ensure this value has at least {limit_value} items'
+
+    def __init__(self, *, limit_value: int) -> None:
+        super().__init__(limit_value=limit_value)
+
+
+class SetMaxLengthError(PydanticValueError):
+    code = 'set.max_items'
+    msg_template = 'ensure this value has at most {limit_value} items'
+
+    def __init__(self, *, limit_value: int) -> None:
+        super().__init__(limit_value=limit_value)
+
+
+class FrozenSetMinLengthError(PydanticValueError):
+    code = 'frozenset.min_items'
+    msg_template = 'ensure this value has at least {limit_value} items'
+
+    def __init__(self, *, limit_value: int) -> None:
+        super().__init__(limit_value=limit_value)
+
+
+class FrozenSetMaxLengthError(PydanticValueError):
+    code = 'frozenset.max_items'
+    msg_template = 'ensure this value has at most {limit_value} items'
+
+    def __init__(self, *, limit_value: int) -> None:
+        super().__init__(limit_value=limit_value)
+
+
+class AnyStrMinLengthError(PydanticValueError):
+    code = 'any_str.min_length'
+    msg_template = 'ensure this value has at least {limit_value} characters'
+
+    def __init__(self, *, limit_value: int) -> None:
+        super().__init__(limit_value=limit_value)
+
+
+class AnyStrMaxLengthError(PydanticValueError):
+    code = 'any_str.max_length'
+    msg_template = 'ensure this value has at most {limit_value} characters'
+
+    def __init__(self, *, limit_value: int) -> None:
+        super().__init__(limit_value=limit_value)
+
+
+class StrError(PydanticTypeError):
+    msg_template = 'str type expected'
+
+
+class StrRegexError(PydanticValueError):
+    code = 'str.regex'
+    msg_template = 'string does not match regex "{pattern}"'
+
+    def __init__(self, *, pattern: str) -> None:
+        super().__init__(pattern=pattern)
+
+
+class _NumberBoundError(PydanticValueError):
+    def __init__(self, *, limit_value: Union[int, float, Decimal]) -> None:
+        super().__init__(limit_value=limit_value)
+
+
+class NumberNotGtError(_NumberBoundError):
+    code = 'number.not_gt'
+    msg_template = 'ensure this value is greater than {limit_value}'
+
+
+class NumberNotGeError(_NumberBoundError):
+    code = 'number.not_ge'
+    msg_template = 'ensure this value is greater than or equal to {limit_value}'
+
+
+class NumberNotLtError(_NumberBoundError):
+    code = 'number.not_lt'
+    msg_template = 'ensure this value is less than {limit_value}'
+
+
+class NumberNotLeError(_NumberBoundError):
+    code = 'number.not_le'
+    msg_template = 'ensure this value is less than or equal to {limit_value}'
+
+
+class NumberNotFiniteError(PydanticValueError):
+    code = 'number.not_finite_number'
+    msg_template = 'ensure this value is a finite number'
+
+
+class NumberNotMultipleError(PydanticValueError):
+    code = 'number.not_multiple'
+    msg_template = 'ensure this value is a multiple of {multiple_of}'
+
+    def __init__(self, *, multiple_of: Union[int, float, Decimal]) -> None:
+        super().__init__(multiple_of=multiple_of)
+
+
+class DecimalError(PydanticTypeError):
+    msg_template = 'value is not a valid decimal'
+
+
+class DecimalIsNotFiniteError(PydanticValueError):
+    code = 'decimal.not_finite'
+    msg_template = 'value is not a valid decimal'
+
+
+class DecimalMaxDigitsError(PydanticValueError):
+    code = 'decimal.max_digits'
+    msg_template = 'ensure that there are no more than {max_digits} digits in total'
+
+    def __init__(self, *, max_digits: int) -> None:
+        super().__init__(max_digits=max_digits)
+
+
+class DecimalMaxPlacesError(PydanticValueError):
+    code = 'decimal.max_places'
+    msg_template = 'ensure that there are no more than {decimal_places} decimal places'
+
+    def __init__(self, *, decimal_places: int) -> None:
+        super().__init__(decimal_places=decimal_places)
+
+
+class DecimalWholeDigitsError(PydanticValueError):
+    code = 'decimal.whole_digits'
+    msg_template = 'ensure that there are no more than {whole_digits} digits before the decimal point'
+
+    def __init__(self, *, whole_digits: int) -> None:
+        super().__init__(whole_digits=whole_digits)
+
+
+class DateTimeError(PydanticValueError):
+    msg_template = 'invalid datetime format'
+
+
+class DateError(PydanticValueError):
+    msg_template = 'invalid date format'
+
+
+class DateNotInThePastError(PydanticValueError):
+    code = 'date.not_in_the_past'
+    msg_template = 'date is not in the past'
+
+
+class DateNotInTheFutureError(PydanticValueError):
+    code = 'date.not_in_the_future'
+    msg_template = 'date is not in the future'
+
+
+class TimeError(PydanticValueError):
+    msg_template = 'invalid time format'
+
+
+class DurationError(PydanticValueError):
+    msg_template = 'invalid duration format'
+
+
+class HashableError(PydanticTypeError):
+    msg_template = 'value is not a valid hashable'
+
+
+class UUIDError(PydanticTypeError):
+    msg_template = 'value is not a valid uuid'
+
+
+class UUIDVersionError(PydanticValueError):
+    code = 'uuid.version'
+    msg_template = 'uuid version {required_version} expected'
+
+    def __init__(self, *, required_version: int) -> None:
+        super().__init__(required_version=required_version)
+
+
+class ArbitraryTypeError(PydanticTypeError):
+    code = 'arbitrary_type'
+    msg_template = 'instance of {expected_arbitrary_type} expected'
+
+    def __init__(self, *, expected_arbitrary_type: Type[Any]) -> None:
+        super().__init__(expected_arbitrary_type=display_as_type(expected_arbitrary_type))
+
+
+class ClassError(PydanticTypeError):
+    code = 'class'
+    msg_template = 'a class is expected'
+
+
+class SubclassError(PydanticTypeError):
+    code = 'subclass'
+    msg_template = 'subclass of {expected_class} expected'
+
+    def __init__(self, *, expected_class: Type[Any]) -> None:
+        super().__init__(expected_class=display_as_type(expected_class))
+
+
+class JsonError(PydanticValueError):
+    msg_template = 'Invalid JSON'
+
+
+class JsonTypeError(PydanticTypeError):
+    code = 'json'
+    msg_template = 'JSON object must be str, bytes or bytearray'
+
+
+class PatternError(PydanticValueError):
+    code = 'regex_pattern'
+    msg_template = 'Invalid regular expression'
+
+
+class DataclassTypeError(PydanticTypeError):
+    code = 'dataclass'
+    msg_template = 'instance of {class_name}, tuple or dict expected'
+
+
+class CallableError(PydanticTypeError):
+    msg_template = '{value} is not callable'
+
+
+class EnumError(PydanticTypeError):
+    code = 'enum_instance'
+    msg_template = '{value} is not a valid Enum instance'
+
+
+class IntEnumError(PydanticTypeError):
+    code = 'int_enum_instance'
+    msg_template = '{value} is not a valid IntEnum instance'
+
+
+class IPvAnyAddressError(PydanticValueError):
+    msg_template = 'value is not a valid IPv4 or IPv6 address'
+
+
+class IPvAnyInterfaceError(PydanticValueError):
+    msg_template = 'value is not a valid IPv4 or IPv6 interface'
+
+
+class IPvAnyNetworkError(PydanticValueError):
+    msg_template = 'value is not a valid IPv4 or IPv6 network'
+
+
+class IPv4AddressError(PydanticValueError):
+    msg_template = 'value is not a valid IPv4 address'
+
+
+class IPv6AddressError(PydanticValueError):
+    msg_template = 'value is not a valid IPv6 address'
+
+
+class IPv4NetworkError(PydanticValueError):
+    msg_template = 'value is not a valid IPv4 network'
+
+
+class IPv6NetworkError(PydanticValueError):
+    msg_template = 'value is not a valid IPv6 network'
+
+
+class IPv4InterfaceError(PydanticValueError):
+    msg_template = 'value is not a valid IPv4 interface'
+
+
+class IPv6InterfaceError(PydanticValueError):
+    msg_template = 'value is not a valid IPv6 interface'
+
+
+class ColorError(PydanticValueError):
+    msg_template = 'value is not a valid color: {reason}'
+
+
+class StrictBoolError(PydanticValueError):
+    msg_template = 'value is not a valid boolean'
+
+
+class NotDigitError(PydanticValueError):
+    code = 'payment_card_number.digits'
+    msg_template = 'card number is not all digits'
+
+
+class LuhnValidationError(PydanticValueError):
+    code = 'payment_card_number.luhn_check'
+    msg_template = 'card number is not luhn valid'
+
+
+class InvalidLengthForBrand(PydanticValueError):
+    code = 'payment_card_number.invalid_length_for_brand'
+    msg_template = 'Length for a {brand} card must be {required_length}'
+
+
+class InvalidByteSize(PydanticValueError):
+    msg_template = 'could not parse value and unit from byte string'
+
+
+class InvalidByteSizeUnit(PydanticValueError):
+    msg_template = 'could not interpret byte unit: {unit}'
+
+
+class MissingDiscriminator(PydanticValueError):
+    code = 'discriminated_union.missing_discriminator'
+    msg_template = 'Discriminator {discriminator_key!r} is missing in value'
+
+
+class InvalidDiscriminator(PydanticValueError):
+    code = 'discriminated_union.invalid_discriminator'
+    msg_template = (
+        'No match for discriminator {discriminator_key!r} and value {discriminator_value!r} '
+        '(allowed values: {allowed_values})'
+    )
+
+    def __init__(self, *, discriminator_key: str, discriminator_value: Any, allowed_values: Sequence[Any]) -> None:
+        super().__init__(
+            discriminator_key=discriminator_key,
+            discriminator_value=discriminator_value,
+            allowed_values=', '.join(map(repr, allowed_values)),
+        )
diff --git a/lib/pydantic/fields.py b/lib/pydantic/fields.py
index b416bb7d..cecd3d20 100644
--- a/lib/pydantic/fields.py
+++ b/lib/pydantic/fields.py
@@ -1,875 +1,1209 @@
-"""Defining fields on models."""
-from __future__ import annotations as _annotations
+import copy
+import re
+from collections import Counter as CollectionCounter, defaultdict, deque
+from collections.abc import Callable, Hashable as CollectionsHashable, Iterable as CollectionsIterable
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Counter,
+    DefaultDict,
+    Deque,
+    Dict,
+    ForwardRef,
+    FrozenSet,
+    Generator,
+    Iterable,
+    Iterator,
+    List,
+    Mapping,
+    Optional,
+    Pattern,
+    Sequence,
+    Set,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+)
 
-import dataclasses
-import inspect
-import typing
-from copy import copy
-from dataclasses import Field as DataclassField
-from functools import cached_property
-from typing import Any, ClassVar
-from warnings import warn
+from typing_extensions import Annotated, Final
 
-import annotated_types
-import typing_extensions
-from pydantic_core import PydanticUndefined
-from typing_extensions import Literal, Unpack
+from . import errors as errors_
+from .class_validators import Validator, make_generic_validator, prep_validators
+from .error_wrappers import ErrorWrapper
+from .errors import ConfigError, InvalidDiscriminator, MissingDiscriminator, NoneIsNotAllowedError
+from .types import Json, JsonWrapper
+from .typing import (
+    NoArgAnyCallable,
+    convert_generics,
+    display_as_type,
+    get_args,
+    get_origin,
+    is_finalvar,
+    is_literal_type,
+    is_new_type,
+    is_none_type,
+    is_typeddict,
+    is_typeddict_special,
+    is_union,
+    new_type_supertype,
+)
+from .utils import (
+    PyObjectStr,
+    Representation,
+    ValueItems,
+    get_discriminator_alias_and_values,
+    get_unique_discriminator_alias,
+    lenient_isinstance,
+    lenient_issubclass,
+    sequence_like,
+    smart_deepcopy,
+)
+from .validators import constant_validator, dict_validator, find_validators, validate_json
 
-from . import types
-from ._internal import _decorators, _fields, _generics, _internal_dataclass, _repr, _typing_extra, _utils
-from .aliases import AliasChoices, AliasPath
-from .config import JsonDict
-from .errors import PydanticUserError
-from .warnings import PydanticDeprecatedSince20
+Required: Any = Ellipsis
 
-if typing.TYPE_CHECKING:
-    from ._internal._repr import ReprArgs
-else:
-    # See PyCharm issues https://youtrack.jetbrains.com/issue/PY-21915
-    # and https://youtrack.jetbrains.com/issue/PY-51428
-    DeprecationWarning = PydanticDeprecatedSince20
+T = TypeVar('T')
 
 
-_Unset: Any = PydanticUndefined
+class UndefinedType:
+    def __repr__(self) -> str:
+        return 'PydanticUndefined'
+
+    def __copy__(self: T) -> T:
+        return self
+
+    def __reduce__(self) -> str:
+        return 'Undefined'
+
+    def __deepcopy__(self: T, _: Any) -> T:
+        return self
 
 
-class _FromFieldInfoInputs(typing_extensions.TypedDict, total=False):
-    """This class exists solely to add type checking for the `**kwargs` in `FieldInfo.from_field`."""
+Undefined = UndefinedType()
 
-    annotation: type[Any] | None
-    default_factory: typing.Callable[[], Any] | None
-    alias: str | None
-    alias_priority: int | None
-    validation_alias: str | AliasPath | AliasChoices | None
-    serialization_alias: str | None
-    title: str | None
-    description: str | None
-    examples: list[Any] | None
-    exclude: bool | None
-    gt: float | None
-    ge: float | None
-    lt: float | None
-    le: float | None
-    multiple_of: float | None
-    strict: bool | None
-    min_length: int | None
-    max_length: int | None
-    pattern: str | None
-    allow_inf_nan: bool | None
-    max_digits: int | None
-    decimal_places: int | None
-    union_mode: Literal['smart', 'left_to_right'] | None
-    discriminator: str | types.Discriminator | None
-    json_schema_extra: JsonDict | typing.Callable[[JsonDict], None] | None
-    frozen: bool | None
-    validate_default: bool | None
-    repr: bool
-    init: bool | None
-    init_var: bool | None
-    kw_only: bool | None
+if TYPE_CHECKING:
+    from .class_validators import ValidatorsList
+    from .config import BaseConfig
+    from .error_wrappers import ErrorList
+    from .types import ModelOrDc
+    from .typing import AbstractSetIntStr, MappingIntStrAny, ReprArgs
+
+    ValidateReturn = Tuple[Optional[Any], Optional[ErrorList]]
+    LocStr = Union[Tuple[Union[int, str], ...], str]
+    BoolUndefined = Union[bool, UndefinedType]
 
 
-class _FieldInfoInputs(_FromFieldInfoInputs, total=False):
-    """This class exists solely to add type checking for the `**kwargs` in `FieldInfo.__init__`."""
-
-    default: Any
-
-
-class FieldInfo(_repr.Representation):
-    """This class holds information about a field.
-
-    `FieldInfo` is used for any field definition regardless of whether the [`Field()`][pydantic.fields.Field]
-    function is explicitly used.
-
-    !!! warning
-        You generally shouldn't be creating `FieldInfo` directly, you'll only need to use it when accessing
-        [`BaseModel`][pydantic.main.BaseModel] `.model_fields` internals.
-
-    Attributes:
-        annotation: The type annotation of the field.
-        default: The default value of the field.
-        default_factory: The factory function used to construct the default for the field.
-        alias: The alias name of the field.
-        alias_priority: The priority of the field's alias.
-        validation_alias: The validation alias of the field.
-        serialization_alias: The serialization alias of the field.
-        title: The title of the field.
-        description: The description of the field.
-        examples: List of examples of the field.
-        exclude: Whether to exclude the field from the model serialization.
-        discriminator: Field name or Discriminator for discriminating the type in a tagged union.
-        json_schema_extra: A dict or callable to provide extra JSON schema properties.
-        frozen: Whether the field is frozen.
-        validate_default: Whether to validate the default value of the field.
-        repr: Whether to include the field in representation of the model.
-        init: Whether the field should be included in the constructor of the dataclass.
-        init_var: Whether the field should _only_ be included in the constructor of the dataclass, and not stored.
-        kw_only: Whether the field should be a keyword-only argument in the constructor of the dataclass.
-        metadata: List of metadata constraints.
+class FieldInfo(Representation):
+    """
+    Captures extra information about a field.
     """
 
-    annotation: type[Any] | None
-    default: Any
-    default_factory: typing.Callable[[], Any] | None
-    alias: str | None
-    alias_priority: int | None
-    validation_alias: str | AliasPath | AliasChoices | None
-    serialization_alias: str | None
-    title: str | None
-    description: str | None
-    examples: list[Any] | None
-    exclude: bool | None
-    discriminator: str | types.Discriminator | None
-    json_schema_extra: JsonDict | typing.Callable[[JsonDict], None] | None
-    frozen: bool | None
-    validate_default: bool | None
-    repr: bool
-    init: bool | None
-    init_var: bool | None
-    kw_only: bool | None
-    metadata: list[Any]
-
     __slots__ = (
-        'annotation',
         'default',
         'default_factory',
         'alias',
         'alias_priority',
-        'validation_alias',
-        'serialization_alias',
         'title',
         'description',
-        'examples',
         'exclude',
-        'discriminator',
-        'json_schema_extra',
-        'frozen',
-        'validate_default',
+        'include',
+        'const',
+        'gt',
+        'ge',
+        'lt',
+        'le',
+        'multiple_of',
+        'allow_inf_nan',
+        'max_digits',
+        'decimal_places',
+        'min_items',
+        'max_items',
+        'unique_items',
+        'min_length',
+        'max_length',
+        'allow_mutation',
         'repr',
-        'init',
-        'init_var',
-        'kw_only',
-        'metadata',
-        '_attributes_set',
+        'regex',
+        'discriminator',
+        'extra',
     )
 
-    # used to convert kwargs to metadata/constraints,
-    # None has a special meaning - these items are collected into a `PydanticGeneralMetadata`
-    metadata_lookup: ClassVar[dict[str, typing.Callable[[Any], Any] | None]] = {
-        'strict': types.Strict,
-        'gt': annotated_types.Gt,
-        'ge': annotated_types.Ge,
-        'lt': annotated_types.Lt,
-        'le': annotated_types.Le,
-        'multiple_of': annotated_types.MultipleOf,
-        'min_length': annotated_types.MinLen,
-        'max_length': annotated_types.MaxLen,
-        'pattern': None,
+    # field constraints with the default value, it's also used in update_from_config below
+    __field_constraints__ = {
+        'min_length': None,
+        'max_length': None,
+        'regex': None,
+        'gt': None,
+        'lt': None,
+        'ge': None,
+        'le': None,
+        'multiple_of': None,
         'allow_inf_nan': None,
         'max_digits': None,
         'decimal_places': None,
-        'union_mode': None,
+        'min_items': None,
+        'max_items': None,
+        'unique_items': None,
+        'allow_mutation': True,
     }
 
-    def __init__(self, **kwargs: Unpack[_FieldInfoInputs]) -> None:
-        """This class should generally not be initialized directly; instead, use the `pydantic.fields.Field` function
-        or one of the constructor classmethods.
-
-        See the signature of `pydantic.fields.Field` for more details about the expected arguments.
-        """
-        self._attributes_set = {k: v for k, v in kwargs.items() if v is not _Unset}
-        kwargs = {k: _DefaultValues.get(k) if v is _Unset else v for k, v in kwargs.items()}  # type: ignore
-        self.annotation, annotation_metadata = self._extract_metadata(kwargs.get('annotation'))
-
-        default = kwargs.pop('default', PydanticUndefined)
-        if default is Ellipsis:
-            self.default = PydanticUndefined
-        else:
-            self.default = default
-
+    def __init__(self, default: Any = Undefined, **kwargs: Any) -> None:
+        self.default = default
         self.default_factory = kwargs.pop('default_factory', None)
-
-        if self.default is not PydanticUndefined and self.default_factory is not None:
-            raise TypeError('cannot specify both default and default_factory')
-
-        self.title = kwargs.pop('title', None)
         self.alias = kwargs.pop('alias', None)
-        self.validation_alias = kwargs.pop('validation_alias', None)
-        self.serialization_alias = kwargs.pop('serialization_alias', None)
-        alias_is_set = any(alias is not None for alias in (self.alias, self.validation_alias, self.serialization_alias))
-        self.alias_priority = kwargs.pop('alias_priority', None) or 2 if alias_is_set else None
+        self.alias_priority = kwargs.pop('alias_priority', 2 if self.alias is not None else None)
+        self.title = kwargs.pop('title', None)
         self.description = kwargs.pop('description', None)
-        self.examples = kwargs.pop('examples', None)
         self.exclude = kwargs.pop('exclude', None)
+        self.include = kwargs.pop('include', None)
+        self.const = kwargs.pop('const', None)
+        self.gt = kwargs.pop('gt', None)
+        self.ge = kwargs.pop('ge', None)
+        self.lt = kwargs.pop('lt', None)
+        self.le = kwargs.pop('le', None)
+        self.multiple_of = kwargs.pop('multiple_of', None)
+        self.allow_inf_nan = kwargs.pop('allow_inf_nan', None)
+        self.max_digits = kwargs.pop('max_digits', None)
+        self.decimal_places = kwargs.pop('decimal_places', None)
+        self.min_items = kwargs.pop('min_items', None)
+        self.max_items = kwargs.pop('max_items', None)
+        self.unique_items = kwargs.pop('unique_items', None)
+        self.min_length = kwargs.pop('min_length', None)
+        self.max_length = kwargs.pop('max_length', None)
+        self.allow_mutation = kwargs.pop('allow_mutation', True)
+        self.regex = kwargs.pop('regex', None)
         self.discriminator = kwargs.pop('discriminator', None)
         self.repr = kwargs.pop('repr', True)
-        self.json_schema_extra = kwargs.pop('json_schema_extra', None)
-        self.validate_default = kwargs.pop('validate_default', None)
-        self.frozen = kwargs.pop('frozen', None)
-        # currently only used on dataclasses
-        self.init = kwargs.pop('init', None)
-        self.init_var = kwargs.pop('init_var', None)
-        self.kw_only = kwargs.pop('kw_only', None)
+        self.extra = kwargs
 
-        self.metadata = self._collect_metadata(kwargs) + annotation_metadata  # type: ignore
+    def __repr_args__(self) -> 'ReprArgs':
 
-    @staticmethod
-    def from_field(default: Any = PydanticUndefined, **kwargs: Unpack[_FromFieldInfoInputs]) -> FieldInfo:
-        """Create a new `FieldInfo` object with the `Field` function.
+        field_defaults_to_hide: Dict[str, Any] = {
+            'repr': True,
+            **self.__field_constraints__,
+        }
 
-        Args:
-            default: The default value for the field. Defaults to Undefined.
-            **kwargs: Additional arguments dictionary.
+        attrs = ((s, getattr(self, s)) for s in self.__slots__)
+        return [(a, v) for a, v in attrs if v != field_defaults_to_hide.get(a, None)]
 
-        Raises:
-            TypeError: If 'annotation' is passed as a keyword argument.
-
-        Returns:
-            A new FieldInfo object with the given parameters.
-
-        Example:
-            This is how you can create a field with default value like this:
-
-            ```python
-            import pydantic
-
-            class MyModel(pydantic.BaseModel):
-                foo: int = pydantic.Field(4)
-            ```
+    def get_constraints(self) -> Set[str]:
         """
-        if 'annotation' in kwargs:
-            raise TypeError('"annotation" is not permitted as a Field keyword argument')
-        return FieldInfo(default=default, **kwargs)
+        Gets the constraints set on the field by comparing the constraint value with its default value
 
-    @staticmethod
-    def from_annotation(annotation: type[Any]) -> FieldInfo:
-        """Creates a `FieldInfo` instance from a bare annotation.
-
-        This function is used internally to create a `FieldInfo` from a bare annotation like this:
-
-        ```python
-        import pydantic
-
-        class MyModel(pydantic.BaseModel):
-            foo: int  # <-- like this
-        ```
-
-        We also account for the case where the annotation can be an instance of `Annotated` and where
-        one of the (not first) arguments in `Annotated` is an instance of `FieldInfo`, e.g.:
-
-        ```python
-        import annotated_types
-        from typing_extensions import Annotated
-
-        import pydantic
-
-        class MyModel(pydantic.BaseModel):
-            foo: Annotated[int, annotated_types.Gt(42)]
-            bar: Annotated[int, pydantic.Field(gt=42)]
-        ```
-
-        Args:
-            annotation: An annotation object.
-
-        Returns:
-            An instance of the field metadata.
+        :return: the constraints set on field_info
         """
-        final = False
-        if _typing_extra.is_finalvar(annotation):
-            final = True
-            if annotation is not typing_extensions.Final:
-                annotation = typing_extensions.get_args(annotation)[0]
+        return {attr for attr, default in self.__field_constraints__.items() if getattr(self, attr) != default}
 
-        if _typing_extra.is_annotated(annotation):
-            first_arg, *extra_args = typing_extensions.get_args(annotation)
-            if _typing_extra.is_finalvar(first_arg):
-                final = True
-            field_info_annotations = [a for a in extra_args if isinstance(a, FieldInfo)]
-            field_info = FieldInfo.merge_field_infos(*field_info_annotations, annotation=first_arg)
-            if field_info:
-                new_field_info = copy(field_info)
-                new_field_info.annotation = first_arg
-                new_field_info.frozen = final or field_info.frozen
-                metadata: list[Any] = []
-                for a in extra_args:
-                    if not isinstance(a, FieldInfo):
-                        metadata.append(a)
-                    else:
-                        metadata.extend(a.metadata)
-                new_field_info.metadata = metadata
-                return new_field_info
-
-        return FieldInfo(annotation=annotation, frozen=final or None)
-
-    @staticmethod
-    def from_annotated_attribute(annotation: type[Any], default: Any) -> FieldInfo:
-        """Create `FieldInfo` from an annotation with a default value.
-
-        This is used in cases like the following:
-
-        ```python
-        import annotated_types
-        from typing_extensions import Annotated
-
-        import pydantic
-
-        class MyModel(pydantic.BaseModel):
-            foo: int = 4  # <-- like this
-            bar: Annotated[int, annotated_types.Gt(4)] = 4  # <-- or this
-            spam: Annotated[int, pydantic.Field(gt=4)] = 4  # <-- or this
-        ```
-
-        Args:
-            annotation: The type annotation of the field.
-            default: The default value of the field.
-
-        Returns:
-            A field object with the passed values.
+    def update_from_config(self, from_config: Dict[str, Any]) -> None:
         """
-        if annotation is default:
-            raise PydanticUserError(
-                'Error when building FieldInfo from annotated attribute. '
-                "Make sure you don't have any field name clashing with a type annotation ",
-                code='unevaluable-type-annotation',
-            )
-
-        final = False
-        if _typing_extra.is_finalvar(annotation):
-            final = True
-            if annotation is not typing_extensions.Final:
-                annotation = typing_extensions.get_args(annotation)[0]
-
-        if isinstance(default, FieldInfo):
-            default.annotation, annotation_metadata = FieldInfo._extract_metadata(annotation)
-            default.metadata += annotation_metadata
-            default = default.merge_field_infos(
-                *[x for x in annotation_metadata if isinstance(x, FieldInfo)], default, annotation=default.annotation
-            )
-            default.frozen = final or default.frozen
-            return default
-        elif isinstance(default, dataclasses.Field):
-            init_var = False
-            if annotation is dataclasses.InitVar:
-                init_var = True
-                annotation = Any
-            elif isinstance(annotation, dataclasses.InitVar):
-                init_var = True
-                annotation = annotation.type
-            pydantic_field = FieldInfo._from_dataclass_field(default)
-            pydantic_field.annotation, annotation_metadata = FieldInfo._extract_metadata(annotation)
-            pydantic_field.metadata += annotation_metadata
-            pydantic_field = pydantic_field.merge_field_infos(
-                *[x for x in annotation_metadata if isinstance(x, FieldInfo)],
-                pydantic_field,
-                annotation=pydantic_field.annotation,
-            )
-            pydantic_field.frozen = final or pydantic_field.frozen
-            pydantic_field.init_var = init_var
-            pydantic_field.init = getattr(default, 'init', None)
-            pydantic_field.kw_only = getattr(default, 'kw_only', None)
-            return pydantic_field
-        else:
-            if _typing_extra.is_annotated(annotation):
-                first_arg, *extra_args = typing_extensions.get_args(annotation)
-                field_infos = [a for a in extra_args if isinstance(a, FieldInfo)]
-                field_info = FieldInfo.merge_field_infos(*field_infos, annotation=first_arg, default=default)
-                metadata: list[Any] = []
-                for a in extra_args:
-                    if not isinstance(a, FieldInfo):
-                        metadata.append(a)
-                    else:
-                        metadata.extend(a.metadata)
-                field_info.metadata = metadata
-                return field_info
-
-            return FieldInfo(annotation=annotation, default=default, frozen=final or None)
-
-    @staticmethod
-    def merge_field_infos(*field_infos: FieldInfo, **overrides: Any) -> FieldInfo:
-        """Merge `FieldInfo` instances keeping only explicitly set attributes.
-
-        Later `FieldInfo` instances override earlier ones.
-
-        Returns:
-            FieldInfo: A merged FieldInfo instance.
+        Update this FieldInfo based on a dict from get_field_info, only fields which have not been set are dated.
         """
-        flattened_field_infos: list[FieldInfo] = []
-        for field_info in field_infos:
-            flattened_field_infos.extend(x for x in field_info.metadata if isinstance(x, FieldInfo))
-            flattened_field_infos.append(field_info)
-        field_infos = tuple(flattened_field_infos)
-        if len(field_infos) == 1:
-            # No merging necessary, but we still need to make a copy and apply the overrides
-            field_info = copy(field_infos[0])
-            field_info._attributes_set.update(overrides)
-            for k, v in overrides.items():
-                setattr(field_info, k, v)
-            return field_info  # type: ignore
-
-        new_kwargs: dict[str, Any] = {}
-        metadata = {}
-        for field_info in field_infos:
-            new_kwargs.update(field_info._attributes_set)
-            for x in field_info.metadata:
-                if not isinstance(x, FieldInfo):
-                    metadata[type(x)] = x
-        new_kwargs.update(overrides)
-        field_info = FieldInfo(**new_kwargs)
-        field_info.metadata = list(metadata.values())
-        return field_info
-
-    @staticmethod
-    def _from_dataclass_field(dc_field: DataclassField[Any]) -> FieldInfo:
-        """Return a new `FieldInfo` instance from a `dataclasses.Field` instance.
-
-        Args:
-            dc_field: The `dataclasses.Field` instance to convert.
-
-        Returns:
-            The corresponding `FieldInfo` instance.
-
-        Raises:
-            TypeError: If any of the `FieldInfo` kwargs does not match the `dataclass.Field` kwargs.
-        """
-        default = dc_field.default
-        if default is dataclasses.MISSING:
-            default = PydanticUndefined
-
-        if dc_field.default_factory is dataclasses.MISSING:
-            default_factory: typing.Callable[[], Any] | None = None
-        else:
-            default_factory = dc_field.default_factory
-
-        # use the `Field` function so in correct kwargs raise the correct `TypeError`
-        dc_field_metadata = {k: v for k, v in dc_field.metadata.items() if k in _FIELD_ARG_NAMES}
-        return Field(default=default, default_factory=default_factory, repr=dc_field.repr, **dc_field_metadata)
-
-    @staticmethod
-    def _extract_metadata(annotation: type[Any] | None) -> tuple[type[Any] | None, list[Any]]:
-        """Tries to extract metadata/constraints from an annotation if it uses `Annotated`.
-
-        Args:
-            annotation: The type hint annotation for which metadata has to be extracted.
-
-        Returns:
-            A tuple containing the extracted metadata type and the list of extra arguments.
-        """
-        if annotation is not None:
-            if _typing_extra.is_annotated(annotation):
-                first_arg, *extra_args = typing_extensions.get_args(annotation)
-                return first_arg, list(extra_args)
-
-        return annotation, []
-
-    @staticmethod
-    def _collect_metadata(kwargs: dict[str, Any]) -> list[Any]:
-        """Collect annotations from kwargs.
-
-        Args:
-            kwargs: Keyword arguments passed to the function.
-
-        Returns:
-            A list of metadata objects - a combination of `annotated_types.BaseMetadata` and
-                `PydanticMetadata`.
-        """
-        metadata: list[Any] = []
-        general_metadata = {}
-        for key, value in list(kwargs.items()):
+        for attr_name, value in from_config.items():
             try:
-                marker = FieldInfo.metadata_lookup[key]
-            except KeyError:
-                continue
-
-            del kwargs[key]
-            if value is not None:
-                if marker is None:
-                    general_metadata[key] = value
-                else:
-                    metadata.append(marker(value))
-        if general_metadata:
-            metadata.append(_fields.pydantic_general_metadata(**general_metadata))
-        return metadata
-
-    def get_default(self, *, call_default_factory: bool = False) -> Any:
-        """Get the default value.
-
-        We expose an option for whether to call the default_factory (if present), as calling it may
-        result in side effects that we want to avoid. However, there are times when it really should
-        be called (namely, when instantiating a model via `model_construct`).
-
-        Args:
-            call_default_factory: Whether to call the default_factory or not. Defaults to `False`.
-
-        Returns:
-            The default value, calling the default factory if requested or `None` if not set.
-        """
-        if self.default_factory is None:
-            return _utils.smart_deepcopy(self.default)
-        elif call_default_factory:
-            return self.default_factory()
-        else:
-            return None
-
-    def is_required(self) -> bool:
-        """Check if the field is required (i.e., does not have a default value or factory).
-
-        Returns:
-            `True` if the field is required, `False` otherwise.
-        """
-        return self.default is PydanticUndefined and self.default_factory is None
-
-    def rebuild_annotation(self) -> Any:
-        """Attempts to rebuild the original annotation for use in function signatures.
-
-        If metadata is present, it adds it to the original annotation using
-        `Annotated`. Otherwise, it returns the original annotation as-is.
-
-        Note that because the metadata has been flattened, the original annotation
-        may not be reconstructed exactly as originally provided, e.g. if the original
-        type had unrecognized annotations, or was annotated with a call to `pydantic.Field`.
-
-        Returns:
-            The rebuilt annotation.
-        """
-        if not self.metadata:
-            return self.annotation
-        else:
-            # Annotated arguments must be a tuple
-            return typing_extensions.Annotated[(self.annotation, *self.metadata)]  # type: ignore
-
-    def apply_typevars_map(self, typevars_map: dict[Any, Any] | None, types_namespace: dict[str, Any] | None) -> None:
-        """Apply a `typevars_map` to the annotation.
-
-        This method is used when analyzing parametrized generic types to replace typevars with their concrete types.
-
-        This method applies the `typevars_map` to the annotation in place.
-
-        Args:
-            typevars_map: A dictionary mapping type variables to their concrete types.
-            types_namespace (dict | None): A dictionary containing related types to the annotated type.
-
-        See Also:
-            pydantic._internal._generics.replace_types is used for replacing the typevars with
-                their concrete types.
-        """
-        annotation = _typing_extra.eval_type_lenient(self.annotation, types_namespace)
-        self.annotation = _generics.replace_types(annotation, typevars_map)
-
-    def __repr_args__(self) -> ReprArgs:
-        yield 'annotation', _repr.PlainRepr(_repr.display_as_type(self.annotation))
-        yield 'required', self.is_required()
-
-        for s in self.__slots__:
-            if s == '_attributes_set':
-                continue
-            if s == 'annotation':
-                continue
-            elif s == 'metadata' and not self.metadata:
-                continue
-            elif s == 'repr' and self.repr is True:
-                continue
-            if s == 'frozen' and self.frozen is False:
-                continue
-            if s == 'validation_alias' and self.validation_alias == self.alias:
-                continue
-            if s == 'serialization_alias' and self.serialization_alias == self.alias:
-                continue
-            if s == 'default_factory' and self.default_factory is not None:
-                yield 'default_factory', _repr.PlainRepr(_repr.display_as_type(self.default_factory))
+                current_value = getattr(self, attr_name)
+            except AttributeError:
+                # attr_name is not an attribute of FieldInfo, it should therefore be added to extra
+                # (except if extra already has this value!)
+                self.extra.setdefault(attr_name, value)
             else:
-                value = getattr(self, s)
-                if value is not None and value is not PydanticUndefined:
-                    yield s, value
+                if current_value is self.__field_constraints__.get(attr_name, None):
+                    setattr(self, attr_name, value)
+                elif attr_name == 'exclude':
+                    self.exclude = ValueItems.merge(value, current_value)
+                elif attr_name == 'include':
+                    self.include = ValueItems.merge(value, current_value, intersect=True)
+
+    def _validate(self) -> None:
+        if self.default is not Undefined and self.default_factory is not None:
+            raise ValueError('cannot specify both default and default_factory')
 
 
-class _EmptyKwargs(typing_extensions.TypedDict):
-    """This class exists solely to ensure that type checking warns about passing `**extra` in `Field`."""
-
-
-_DefaultValues = dict(
-    default=...,
-    default_factory=None,
-    alias=None,
-    alias_priority=None,
-    validation_alias=None,
-    serialization_alias=None,
-    title=None,
-    description=None,
-    examples=None,
-    exclude=None,
-    discriminator=None,
-    json_schema_extra=None,
-    frozen=None,
-    validate_default=None,
-    repr=True,
-    init=None,
-    init_var=None,
-    kw_only=None,
-    pattern=None,
-    strict=None,
-    gt=None,
-    ge=None,
-    lt=None,
-    le=None,
-    multiple_of=None,
-    allow_inf_nan=None,
-    max_digits=None,
-    decimal_places=None,
-    min_length=None,
-    max_length=None,
-)
-
-
-def Field(  # noqa: C901
-    default: Any = PydanticUndefined,
+def Field(
+    default: Any = Undefined,
     *,
-    default_factory: typing.Callable[[], Any] | None = _Unset,
-    alias: str | None = _Unset,
-    alias_priority: int | None = _Unset,
-    validation_alias: str | AliasPath | AliasChoices | None = _Unset,
-    serialization_alias: str | None = _Unset,
-    title: str | None = _Unset,
-    description: str | None = _Unset,
-    examples: list[Any] | None = _Unset,
-    exclude: bool | None = _Unset,
-    discriminator: str | types.Discriminator | None = _Unset,
-    json_schema_extra: JsonDict | typing.Callable[[JsonDict], None] | None = _Unset,
-    frozen: bool | None = _Unset,
-    validate_default: bool | None = _Unset,
-    repr: bool = _Unset,
-    init: bool | None = _Unset,
-    init_var: bool | None = _Unset,
-    kw_only: bool | None = _Unset,
-    pattern: str | None = _Unset,
-    strict: bool | None = _Unset,
-    gt: float | None = _Unset,
-    ge: float | None = _Unset,
-    lt: float | None = _Unset,
-    le: float | None = _Unset,
-    multiple_of: float | None = _Unset,
-    allow_inf_nan: bool | None = _Unset,
-    max_digits: int | None = _Unset,
-    decimal_places: int | None = _Unset,
-    min_length: int | None = _Unset,
-    max_length: int | None = _Unset,
-    union_mode: Literal['smart', 'left_to_right'] = _Unset,
-    **extra: Unpack[_EmptyKwargs],
+    default_factory: Optional[NoArgAnyCallable] = None,
+    alias: str = None,
+    title: str = None,
+    description: str = None,
+    exclude: Union['AbstractSetIntStr', 'MappingIntStrAny', Any] = None,
+    include: Union['AbstractSetIntStr', 'MappingIntStrAny', Any] = None,
+    const: bool = None,
+    gt: float = None,
+    ge: float = None,
+    lt: float = None,
+    le: float = None,
+    multiple_of: float = None,
+    allow_inf_nan: bool = None,
+    max_digits: int = None,
+    decimal_places: int = None,
+    min_items: int = None,
+    max_items: int = None,
+    unique_items: bool = None,
+    min_length: int = None,
+    max_length: int = None,
+    allow_mutation: bool = True,
+    regex: str = None,
+    discriminator: str = None,
+    repr: bool = True,
+    **extra: Any,
 ) -> Any:
-    """Usage docs: https://docs.pydantic.dev/2.6/concepts/fields
-
-    Create a field for objects that can be configured.
-
-    Used to provide extra information about a field, either for the model schema or complex validation. Some arguments
-    apply only to number fields (`int`, `float`, `Decimal`) and some apply only to `str`.
-
-    Note:
-        - Any `_Unset` objects will be replaced by the corresponding value defined in the `_DefaultValues` dictionary. If a key for the `_Unset` object is not found in the `_DefaultValues` dictionary, it will default to `None`
-
-    Args:
-        default: Default value if the field is not set.
-        default_factory: A callable to generate the default value, such as :func:`~datetime.utcnow`.
-        alias: The name to use for the attribute when validating or serializing by alias.
-            This is often used for things like converting between snake and camel case.
-        alias_priority: Priority of the alias. This affects whether an alias generator is used.
-        validation_alias: Like `alias`, but only affects validation, not serialization.
-        serialization_alias: Like `alias`, but only affects serialization, not validation.
-        title: Human-readable title.
-        description: Human-readable description.
-        examples: Example values for this field.
-        exclude: Whether to exclude the field from the model serialization.
-        discriminator: Field name or Discriminator for discriminating the type in a tagged union.
-        json_schema_extra: A dict or callable to provide extra JSON schema properties.
-        frozen: Whether the field is frozen. If true, attempts to change the value on an instance will raise an error.
-        validate_default: If `True`, apply validation to the default value every time you create an instance.
-            Otherwise, for performance reasons, the default value of the field is trusted and not validated.
-        repr: A boolean indicating whether to include the field in the `__repr__` output.
-        init: Whether the field should be included in the constructor of the dataclass.
-            (Only applies to dataclasses.)
-        init_var: Whether the field should _only_ be included in the constructor of the dataclass.
-            (Only applies to dataclasses.)
-        kw_only: Whether the field should be a keyword-only argument in the constructor of the dataclass.
-            (Only applies to dataclasses.)
-        strict: If `True`, strict validation is applied to the field.
-            See [Strict Mode](../concepts/strict_mode.md) for details.
-        gt: Greater than. If set, value must be greater than this. Only applicable to numbers.
-        ge: Greater than or equal. If set, value must be greater than or equal to this. Only applicable to numbers.
-        lt: Less than. If set, value must be less than this. Only applicable to numbers.
-        le: Less than or equal. If set, value must be less than or equal to this. Only applicable to numbers.
-        multiple_of: Value must be a multiple of this. Only applicable to numbers.
-        min_length: Minimum length for strings.
-        max_length: Maximum length for strings.
-        pattern: Pattern for strings (a regular expression).
-        allow_inf_nan: Allow `inf`, `-inf`, `nan`. Only applicable to numbers.
-        max_digits: Maximum number of allow digits for strings.
-        decimal_places: Maximum number of decimal places allowed for numbers.
-        union_mode: The strategy to apply when validating a union. Can be `smart` (the default), or `left_to_right`.
-            See [Union Mode](standard_library_types.md#union-mode) for details.
-        extra: (Deprecated) Extra fields that will be included in the JSON schema.
-
-            !!! warning Deprecated
-                The `extra` kwargs is deprecated. Use `json_schema_extra` instead.
-
-    Returns:
-        A new [`FieldInfo`][pydantic.fields.FieldInfo]. The return annotation is `Any` so `Field` can be used on
-            type-annotated fields without causing a type error.
     """
-    # Check deprecated and removed params from V1. This logic should eventually be removed.
-    const = extra.pop('const', None)  # type: ignore
-    if const is not None:
-        raise PydanticUserError('`const` is removed, use `Literal` instead', code='removed-kwargs')
+    Used to provide extra information about a field, either for the model schema or complex validation. Some arguments
+    apply only to number fields (``int``, ``float``, ``Decimal``) and some apply only to ``str``.
 
-    min_items = extra.pop('min_items', None)  # type: ignore
-    if min_items is not None:
-        warn('`min_items` is deprecated and will be removed, use `min_length` instead', DeprecationWarning)
-        if min_length in (None, _Unset):
-            min_length = min_items  # type: ignore
-
-    max_items = extra.pop('max_items', None)  # type: ignore
-    if max_items is not None:
-        warn('`max_items` is deprecated and will be removed, use `max_length` instead', DeprecationWarning)
-        if max_length in (None, _Unset):
-            max_length = max_items  # type: ignore
-
-    unique_items = extra.pop('unique_items', None)  # type: ignore
-    if unique_items is not None:
-        raise PydanticUserError(
-            (
-                '`unique_items` is removed, use `Set` instead'
-                '(this feature is discussed in https://github.com/pydantic/pydantic-core/issues/296)'
-            ),
-            code='removed-kwargs',
-        )
-
-    allow_mutation = extra.pop('allow_mutation', None)  # type: ignore
-    if allow_mutation is not None:
-        warn('`allow_mutation` is deprecated and will be removed. use `frozen` instead', DeprecationWarning)
-        if allow_mutation is False:
-            frozen = True
-
-    regex = extra.pop('regex', None)  # type: ignore
-    if regex is not None:
-        raise PydanticUserError('`regex` is removed. use `pattern` instead', code='removed-kwargs')
-
-    if extra:
-        warn(
-            'Using extra keyword arguments on `Field` is deprecated and will be removed.'
-            ' Use `json_schema_extra` instead.'
-            f' (Extra keys: {", ".join(k.__repr__() for k in extra.keys())})',
-            DeprecationWarning,
-        )
-        if not json_schema_extra or json_schema_extra is _Unset:
-            json_schema_extra = extra  # type: ignore
-
-    if (
-        validation_alias
-        and validation_alias is not _Unset
-        and not isinstance(validation_alias, (str, AliasChoices, AliasPath))
-    ):
-        raise TypeError('Invalid `validation_alias` type. it should be `str`, `AliasChoices`, or `AliasPath`')
-
-    if serialization_alias in (_Unset, None) and isinstance(alias, str):
-        serialization_alias = alias
-
-    if validation_alias in (_Unset, None):
-        validation_alias = alias
-
-    include = extra.pop('include', None)  # type: ignore
-    if include is not None:
-        warn('`include` is deprecated and does nothing. It will be removed, use `exclude` instead', DeprecationWarning)
-
-    return FieldInfo.from_field(
+    :param default: since this is replacing the field’s default, its first argument is used
+      to set the default, use ellipsis (``...``) to indicate the field is required
+    :param default_factory: callable that will be called when a default value is needed for this field
+      If both `default` and `default_factory` are set, an error is raised.
+    :param alias: the public name of the field
+    :param title: can be any string, used in the schema
+    :param description: can be any string, used in the schema
+    :param exclude: exclude this field while dumping.
+      Takes same values as the ``include`` and ``exclude`` arguments on the ``.dict`` method.
+    :param include: include this field while dumping.
+      Takes same values as the ``include`` and ``exclude`` arguments on the ``.dict`` method.
+    :param const: this field is required and *must* take it's default value
+    :param gt: only applies to numbers, requires the field to be "greater than". The schema
+      will have an ``exclusiveMinimum`` validation keyword
+    :param ge: only applies to numbers, requires the field to be "greater than or equal to". The
+      schema will have a ``minimum`` validation keyword
+    :param lt: only applies to numbers, requires the field to be "less than". The schema
+      will have an ``exclusiveMaximum`` validation keyword
+    :param le: only applies to numbers, requires the field to be "less than or equal to". The
+      schema will have a ``maximum`` validation keyword
+    :param multiple_of: only applies to numbers, requires the field to be "a multiple of". The
+      schema will have a ``multipleOf`` validation keyword
+    :param allow_inf_nan: only applies to numbers, allows the field to be NaN or infinity (+inf or -inf),
+        which is a valid Python float. Default True, set to False for compatibility with JSON.
+    :param max_digits: only applies to Decimals, requires the field to have a maximum number
+      of digits within the decimal. It does not include a zero before the decimal point or trailing decimal zeroes.
+    :param decimal_places: only applies to Decimals, requires the field to have at most a number of decimal places
+      allowed. It does not include trailing decimal zeroes.
+    :param min_items: only applies to lists, requires the field to have a minimum number of
+      elements. The schema will have a ``minItems`` validation keyword
+    :param max_items: only applies to lists, requires the field to have a maximum number of
+      elements. The schema will have a ``maxItems`` validation keyword
+    :param unique_items: only applies to lists, requires the field not to have duplicated
+      elements. The schema will have a ``uniqueItems`` validation keyword
+    :param min_length: only applies to strings, requires the field to have a minimum length. The
+      schema will have a ``maximum`` validation keyword
+    :param max_length: only applies to strings, requires the field to have a maximum length. The
+      schema will have a ``maxLength`` validation keyword
+    :param allow_mutation: a boolean which defaults to True. When False, the field raises a TypeError if the field is
+      assigned on an instance.  The BaseModel Config must set validate_assignment to True
+    :param regex: only applies to strings, requires the field match against a regular expression
+      pattern string. The schema will have a ``pattern`` validation keyword
+    :param discriminator: only useful with a (discriminated a.k.a. tagged) `Union` of sub models with a common field.
+      The `discriminator` is the name of this common field to shorten validation and improve generated schema
+    :param repr: show this field in the representation
+    :param **extra: any additional keyword arguments will be added as is to the schema
+    """
+    field_info = FieldInfo(
         default,
         default_factory=default_factory,
         alias=alias,
-        alias_priority=alias_priority,
-        validation_alias=validation_alias,
-        serialization_alias=serialization_alias,
         title=title,
         description=description,
-        examples=examples,
         exclude=exclude,
-        discriminator=discriminator,
-        json_schema_extra=json_schema_extra,
-        frozen=frozen,
-        pattern=pattern,
-        validate_default=validate_default,
-        repr=repr,
-        init=init,
-        init_var=init_var,
-        kw_only=kw_only,
-        strict=strict,
+        include=include,
+        const=const,
         gt=gt,
         ge=ge,
         lt=lt,
         le=le,
         multiple_of=multiple_of,
-        min_length=min_length,
-        max_length=max_length,
         allow_inf_nan=allow_inf_nan,
         max_digits=max_digits,
         decimal_places=decimal_places,
-        union_mode=union_mode,
+        min_items=min_items,
+        max_items=max_items,
+        unique_items=unique_items,
+        min_length=min_length,
+        max_length=max_length,
+        allow_mutation=allow_mutation,
+        regex=regex,
+        discriminator=discriminator,
+        repr=repr,
+        **extra,
+    )
+    field_info._validate()
+    return field_info
+
+
+# used to be an enum but changed to int's for small performance improvement as less access overhead
+SHAPE_SINGLETON = 1
+SHAPE_LIST = 2
+SHAPE_SET = 3
+SHAPE_MAPPING = 4
+SHAPE_TUPLE = 5
+SHAPE_TUPLE_ELLIPSIS = 6
+SHAPE_SEQUENCE = 7
+SHAPE_FROZENSET = 8
+SHAPE_ITERABLE = 9
+SHAPE_GENERIC = 10
+SHAPE_DEQUE = 11
+SHAPE_DICT = 12
+SHAPE_DEFAULTDICT = 13
+SHAPE_COUNTER = 14
+SHAPE_NAME_LOOKUP = {
+    SHAPE_LIST: 'List[{}]',
+    SHAPE_SET: 'Set[{}]',
+    SHAPE_TUPLE_ELLIPSIS: 'Tuple[{}, ...]',
+    SHAPE_SEQUENCE: 'Sequence[{}]',
+    SHAPE_FROZENSET: 'FrozenSet[{}]',
+    SHAPE_ITERABLE: 'Iterable[{}]',
+    SHAPE_DEQUE: 'Deque[{}]',
+    SHAPE_DICT: 'Dict[{}]',
+    SHAPE_DEFAULTDICT: 'DefaultDict[{}]',
+    SHAPE_COUNTER: 'Counter[{}]',
+}
+
+MAPPING_LIKE_SHAPES: Set[int] = {SHAPE_DEFAULTDICT, SHAPE_DICT, SHAPE_MAPPING, SHAPE_COUNTER}
+
+
+class ModelField(Representation):
+    __slots__ = (
+        'type_',
+        'outer_type_',
+        'annotation',
+        'sub_fields',
+        'sub_fields_mapping',
+        'key_field',
+        'validators',
+        'pre_validators',
+        'post_validators',
+        'default',
+        'default_factory',
+        'required',
+        'final',
+        'model_config',
+        'name',
+        'alias',
+        'has_alias',
+        'field_info',
+        'discriminator_key',
+        'discriminator_alias',
+        'validate_always',
+        'allow_none',
+        'shape',
+        'class_validators',
+        'parse_json',
     )
 
-
-_FIELD_ARG_NAMES = set(inspect.signature(Field).parameters)
-_FIELD_ARG_NAMES.remove('extra')  # do not include the varkwargs parameter
-
-
-class ModelPrivateAttr(_repr.Representation):
-    """A descriptor for private attributes in class models.
-
-    !!! warning
-        You generally shouldn't be creating `ModelPrivateAttr` instances directly, instead use
-        `pydantic.fields.PrivateAttr`. (This is similar to `FieldInfo` vs. `Field`.)
-
-    Attributes:
-        default: The default value of the attribute if not provided.
-        default_factory: A callable function that generates the default value of the
-            attribute if not provided.
-    """
-
-    __slots__ = 'default', 'default_factory'
-
     def __init__(
-        self, default: Any = PydanticUndefined, *, default_factory: typing.Callable[[], Any] | None = None
+        self,
+        *,
+        name: str,
+        type_: Type[Any],
+        class_validators: Optional[Dict[str, Validator]],
+        model_config: Type['BaseConfig'],
+        default: Any = None,
+        default_factory: Optional[NoArgAnyCallable] = None,
+        required: 'BoolUndefined' = Undefined,
+        final: bool = False,
+        alias: str = None,
+        field_info: Optional[FieldInfo] = None,
     ) -> None:
+
+        self.name: str = name
+        self.has_alias: bool = alias is not None
+        self.alias: str = alias if alias is not None else name
+        self.annotation = type_
+        self.type_: Any = convert_generics(type_)
+        self.outer_type_: Any = type_
+        self.class_validators = class_validators or {}
+        self.default: Any = default
+        self.default_factory: Optional[NoArgAnyCallable] = default_factory
+        self.required: 'BoolUndefined' = required
+        self.final: bool = final
+        self.model_config = model_config
+        self.field_info: FieldInfo = field_info or FieldInfo(default)
+        self.discriminator_key: Optional[str] = self.field_info.discriminator
+        self.discriminator_alias: Optional[str] = self.discriminator_key
+
+        self.allow_none: bool = False
+        self.validate_always: bool = False
+        self.sub_fields: Optional[List[ModelField]] = None
+        self.sub_fields_mapping: Optional[Dict[str, 'ModelField']] = None  # used for discriminated union
+        self.key_field: Optional[ModelField] = None
+        self.validators: 'ValidatorsList' = []
+        self.pre_validators: Optional['ValidatorsList'] = None
+        self.post_validators: Optional['ValidatorsList'] = None
+        self.parse_json: bool = False
+        self.shape: int = SHAPE_SINGLETON
+        self.model_config.prepare_field(self)
+        self.prepare()
+
+    def get_default(self) -> Any:
+        return smart_deepcopy(self.default) if self.default_factory is None else self.default_factory()
+
+    @staticmethod
+    def _get_field_info(
+        field_name: str, annotation: Any, value: Any, config: Type['BaseConfig']
+    ) -> Tuple[FieldInfo, Any]:
+        """
+        Get a FieldInfo from a root typing.Annotated annotation, value, or config default.
+
+        The FieldInfo may be set in typing.Annotated or the value, but not both. If neither contain
+        a FieldInfo, a new one will be created using the config.
+
+        :param field_name: name of the field for use in error messages
+        :param annotation: a type hint such as `str` or `Annotated[str, Field(..., min_length=5)]`
+        :param value: the field's assigned value
+        :param config: the model's config object
+        :return: the FieldInfo contained in the `annotation`, the value, or a new one from the config.
+        """
+        field_info_from_config = config.get_field_info(field_name)
+
+        field_info = None
+        if get_origin(annotation) is Annotated:
+            field_infos = [arg for arg in get_args(annotation)[1:] if isinstance(arg, FieldInfo)]
+            if len(field_infos) > 1:
+                raise ValueError(f'cannot specify multiple `Annotated` `Field`s for {field_name!r}')
+            field_info = next(iter(field_infos), None)
+            if field_info is not None:
+                field_info = copy.copy(field_info)
+                field_info.update_from_config(field_info_from_config)
+                if field_info.default not in (Undefined, Required):
+                    raise ValueError(f'`Field` default cannot be set in `Annotated` for {field_name!r}')
+                if value is not Undefined and value is not Required:
+                    # check also `Required` because of `validate_arguments` that sets `...` as default value
+                    field_info.default = value
+
+        if isinstance(value, FieldInfo):
+            if field_info is not None:
+                raise ValueError(f'cannot specify `Annotated` and value `Field`s together for {field_name!r}')
+            field_info = value
+            field_info.update_from_config(field_info_from_config)
+        elif field_info is None:
+            field_info = FieldInfo(value, **field_info_from_config)
+        value = None if field_info.default_factory is not None else field_info.default
+        field_info._validate()
+        return field_info, value
+
+    @classmethod
+    def infer(
+        cls,
+        *,
+        name: str,
+        value: Any,
+        annotation: Any,
+        class_validators: Optional[Dict[str, Validator]],
+        config: Type['BaseConfig'],
+    ) -> 'ModelField':
+        from .schema import get_annotation_from_field_info
+
+        field_info, value = cls._get_field_info(name, annotation, value, config)
+        required: 'BoolUndefined' = Undefined
+        if value is Required:
+            required = True
+            value = None
+        elif value is not Undefined:
+            required = False
+        annotation = get_annotation_from_field_info(annotation, field_info, name, config.validate_assignment)
+
+        return cls(
+            name=name,
+            type_=annotation,
+            alias=field_info.alias,
+            class_validators=class_validators,
+            default=value,
+            default_factory=field_info.default_factory,
+            required=required,
+            model_config=config,
+            field_info=field_info,
+        )
+
+    def set_config(self, config: Type['BaseConfig']) -> None:
+        self.model_config = config
+        info_from_config = config.get_field_info(self.name)
+        config.prepare_field(self)
+        new_alias = info_from_config.get('alias')
+        new_alias_priority = info_from_config.get('alias_priority') or 0
+        if new_alias and new_alias_priority >= (self.field_info.alias_priority or 0):
+            self.field_info.alias = new_alias
+            self.field_info.alias_priority = new_alias_priority
+            self.alias = new_alias
+        new_exclude = info_from_config.get('exclude')
+        if new_exclude is not None:
+            self.field_info.exclude = ValueItems.merge(self.field_info.exclude, new_exclude)
+        new_include = info_from_config.get('include')
+        if new_include is not None:
+            self.field_info.include = ValueItems.merge(self.field_info.include, new_include, intersect=True)
+
+    @property
+    def alt_alias(self) -> bool:
+        return self.name != self.alias
+
+    def prepare(self) -> None:
+        """
+        Prepare the field but inspecting self.default, self.type_ etc.
+
+        Note: this method is **not** idempotent (because _type_analysis is not idempotent),
+        e.g. calling it it multiple times may modify the field and configure it incorrectly.
+        """
+        self._set_default_and_type()
+        if self.type_.__class__ is ForwardRef or self.type_.__class__ is DeferredType:
+            # self.type_ is currently a ForwardRef and there's nothing we can do now,
+            # user will need to call model.update_forward_refs()
+            return
+
+        self._type_analysis()
+        if self.required is Undefined:
+            self.required = True
+        if self.default is Undefined and self.default_factory is None:
+            self.default = None
+        self.populate_validators()
+
+    def _set_default_and_type(self) -> None:
+        """
+        Set the default value, infer the type if needed and check if `None` value is valid.
+        """
+        if self.default_factory is not None:
+            if self.type_ is Undefined:
+                raise errors_.ConfigError(
+                    f'you need to set the type of field {self.name!r} when using `default_factory`'
+                )
+            return
+
+        default_value = self.get_default()
+
+        if default_value is not None and self.type_ is Undefined:
+            self.type_ = default_value.__class__
+            self.outer_type_ = self.type_
+            self.annotation = self.type_
+
+        if self.type_ is Undefined:
+            raise errors_.ConfigError(f'unable to infer type for attribute "{self.name}"')
+
+        if self.required is False and default_value is None:
+            self.allow_none = True
+
+    def _type_analysis(self) -> None:  # noqa: C901 (ignore complexity)
+        # typing interface is horrible, we have to do some ugly checks
+        if lenient_issubclass(self.type_, JsonWrapper):
+            self.type_ = self.type_.inner_type
+            self.parse_json = True
+        elif lenient_issubclass(self.type_, Json):
+            self.type_ = Any
+            self.parse_json = True
+        elif isinstance(self.type_, TypeVar):
+            if self.type_.__bound__:
+                self.type_ = self.type_.__bound__
+            elif self.type_.__constraints__:
+                self.type_ = Union[self.type_.__constraints__]
+            else:
+                self.type_ = Any
+        elif is_new_type(self.type_):
+            self.type_ = new_type_supertype(self.type_)
+
+        if self.type_ is Any or self.type_ is object:
+            if self.required is Undefined:
+                self.required = False
+            self.allow_none = True
+            return
+        elif self.type_ is Pattern or self.type_ is re.Pattern:
+            # python 3.7 only, Pattern is a typing object but without sub fields
+            return
+        elif is_literal_type(self.type_):
+            return
+        elif is_typeddict(self.type_):
+            return
+
+        if is_finalvar(self.type_):
+            self.final = True
+
+            if self.type_ is Final:
+                self.type_ = Any
+            else:
+                self.type_ = get_args(self.type_)[0]
+
+            self._type_analysis()
+            return
+
+        origin = get_origin(self.type_)
+
+        if origin is Annotated or is_typeddict_special(origin):
+            self.type_ = get_args(self.type_)[0]
+            self._type_analysis()
+            return
+
+        if self.discriminator_key is not None and not is_union(origin):
+            raise TypeError('`discriminator` can only be used with `Union` type with more than one variant')
+
+        # add extra check for `collections.abc.Hashable` for python 3.10+ where origin is not `None`
+        if origin is None or origin is CollectionsHashable:
+            # field is not "typing" object eg. Union, Dict, List etc.
+            # allow None for virtual superclasses of NoneType, e.g. Hashable
+            if isinstance(self.type_, type) and isinstance(None, self.type_):
+                self.allow_none = True
+            return
+        elif origin is Callable:
+            return
+        elif is_union(origin):
+            types_ = []
+            for type_ in get_args(self.type_):
+                if is_none_type(type_) or type_ is Any or type_ is object:
+                    if self.required is Undefined:
+                        self.required = False
+                    self.allow_none = True
+                if is_none_type(type_):
+                    continue
+                types_.append(type_)
+
+            if len(types_) == 1:
+                # Optional[]
+                self.type_ = types_[0]
+                # this is the one case where the "outer type" isn't just the original type
+                self.outer_type_ = self.type_
+                # re-run to correctly interpret the new self.type_
+                self._type_analysis()
+            else:
+                self.sub_fields = [self._create_sub_type(t, f'{self.name}_{display_as_type(t)}') for t in types_]
+
+                if self.discriminator_key is not None:
+                    self.prepare_discriminated_union_sub_fields()
+            return
+        elif issubclass(origin, Tuple):  # type: ignore
+            # origin == Tuple without item type
+            args = get_args(self.type_)
+            if not args:  # plain tuple
+                self.type_ = Any
+                self.shape = SHAPE_TUPLE_ELLIPSIS
+            elif len(args) == 2 and args[1] is Ellipsis:  # e.g. Tuple[int, ...]
+                self.type_ = args[0]
+                self.shape = SHAPE_TUPLE_ELLIPSIS
+                self.sub_fields = [self._create_sub_type(args[0], f'{self.name}_0')]
+            elif args == ((),):  # Tuple[()] means empty tuple
+                self.shape = SHAPE_TUPLE
+                self.type_ = Any
+                self.sub_fields = []
+            else:
+                self.shape = SHAPE_TUPLE
+                self.sub_fields = [self._create_sub_type(t, f'{self.name}_{i}') for i, t in enumerate(args)]
+            return
+        elif issubclass(origin, List):
+            # Create self validators
+            get_validators = getattr(self.type_, '__get_validators__', None)
+            if get_validators:
+                self.class_validators.update(
+                    {f'list_{i}': Validator(validator, pre=True) for i, validator in enumerate(get_validators())}
+                )
+
+            self.type_ = get_args(self.type_)[0]
+            self.shape = SHAPE_LIST
+        elif issubclass(origin, Set):
+            # Create self validators
+            get_validators = getattr(self.type_, '__get_validators__', None)
+            if get_validators:
+                self.class_validators.update(
+                    {f'set_{i}': Validator(validator, pre=True) for i, validator in enumerate(get_validators())}
+                )
+
+            self.type_ = get_args(self.type_)[0]
+            self.shape = SHAPE_SET
+        elif issubclass(origin, FrozenSet):
+            # Create self validators
+            get_validators = getattr(self.type_, '__get_validators__', None)
+            if get_validators:
+                self.class_validators.update(
+                    {f'frozenset_{i}': Validator(validator, pre=True) for i, validator in enumerate(get_validators())}
+                )
+
+            self.type_ = get_args(self.type_)[0]
+            self.shape = SHAPE_FROZENSET
+        elif issubclass(origin, Deque):
+            self.type_ = get_args(self.type_)[0]
+            self.shape = SHAPE_DEQUE
+        elif issubclass(origin, Sequence):
+            self.type_ = get_args(self.type_)[0]
+            self.shape = SHAPE_SEQUENCE
+        # priority to most common mapping: dict
+        elif origin is dict or origin is Dict:
+            self.key_field = self._create_sub_type(get_args(self.type_)[0], 'key_' + self.name, for_keys=True)
+            self.type_ = get_args(self.type_)[1]
+            self.shape = SHAPE_DICT
+        elif issubclass(origin, DefaultDict):
+            self.key_field = self._create_sub_type(get_args(self.type_)[0], 'key_' + self.name, for_keys=True)
+            self.type_ = get_args(self.type_)[1]
+            self.shape = SHAPE_DEFAULTDICT
+        elif issubclass(origin, Counter):
+            self.key_field = self._create_sub_type(get_args(self.type_)[0], 'key_' + self.name, for_keys=True)
+            self.type_ = int
+            self.shape = SHAPE_COUNTER
+        elif issubclass(origin, Mapping):
+            self.key_field = self._create_sub_type(get_args(self.type_)[0], 'key_' + self.name, for_keys=True)
+            self.type_ = get_args(self.type_)[1]
+            self.shape = SHAPE_MAPPING
+        # Equality check as almost everything inherits form Iterable, including str
+        # check for Iterable and CollectionsIterable, as it could receive one even when declared with the other
+        elif origin in {Iterable, CollectionsIterable}:
+            self.type_ = get_args(self.type_)[0]
+            self.shape = SHAPE_ITERABLE
+            self.sub_fields = [self._create_sub_type(self.type_, f'{self.name}_type')]
+        elif issubclass(origin, Type):  # type: ignore
+            return
+        elif hasattr(origin, '__get_validators__') or self.model_config.arbitrary_types_allowed:
+            # Is a Pydantic-compatible generic that handles itself
+            # or we have arbitrary_types_allowed = True
+            self.shape = SHAPE_GENERIC
+            self.sub_fields = [self._create_sub_type(t, f'{self.name}_{i}') for i, t in enumerate(get_args(self.type_))]
+            self.type_ = origin
+            return
+        else:
+            raise TypeError(f'Fields of type "{origin}" are not supported.')
+
+        # type_ has been refined eg. as the type of a List and sub_fields needs to be populated
+        self.sub_fields = [self._create_sub_type(self.type_, '_' + self.name)]
+
+    def prepare_discriminated_union_sub_fields(self) -> None:
+        """
+        Prepare the mapping <discriminator key> -> <ModelField> and update `sub_fields`
+        Note that this process can be aborted if a `ForwardRef` is encountered
+        """
+        assert self.discriminator_key is not None
+
+        if self.type_.__class__ is DeferredType:
+            return
+
+        assert self.sub_fields is not None
+        sub_fields_mapping: Dict[str, 'ModelField'] = {}
+        all_aliases: Set[str] = set()
+
+        for sub_field in self.sub_fields:
+            t = sub_field.type_
+            if t.__class__ is ForwardRef:
+                # Stopping everything...will need to call `update_forward_refs`
+                return
+
+            alias, discriminator_values = get_discriminator_alias_and_values(t, self.discriminator_key)
+            all_aliases.add(alias)
+            for discriminator_value in discriminator_values:
+                sub_fields_mapping[discriminator_value] = sub_field
+
+        self.sub_fields_mapping = sub_fields_mapping
+        self.discriminator_alias = get_unique_discriminator_alias(all_aliases, self.discriminator_key)
+
+    def _create_sub_type(self, type_: Type[Any], name: str, *, for_keys: bool = False) -> 'ModelField':
+        if for_keys:
+            class_validators = None
+        else:
+            # validators for sub items should not have `each_item` as we want to check only the first sublevel
+            class_validators = {
+                k: Validator(
+                    func=v.func,
+                    pre=v.pre,
+                    each_item=False,
+                    always=v.always,
+                    check_fields=v.check_fields,
+                    skip_on_failure=v.skip_on_failure,
+                )
+                for k, v in self.class_validators.items()
+                if v.each_item
+            }
+
+        field_info, _ = self._get_field_info(name, type_, None, self.model_config)
+
+        return self.__class__(
+            type_=type_,
+            name=name,
+            class_validators=class_validators,
+            model_config=self.model_config,
+            field_info=field_info,
+        )
+
+    def populate_validators(self) -> None:
+        """
+        Prepare self.pre_validators, self.validators, and self.post_validators based on self.type_'s  __get_validators__
+        and class validators. This method should be idempotent, e.g. it should be safe to call multiple times
+        without mis-configuring the field.
+        """
+        self.validate_always = getattr(self.type_, 'validate_always', False) or any(
+            v.always for v in self.class_validators.values()
+        )
+
+        class_validators_ = self.class_validators.values()
+        if not self.sub_fields or self.shape == SHAPE_GENERIC:
+            get_validators = getattr(self.type_, '__get_validators__', None)
+            v_funcs = (
+                *[v.func for v in class_validators_ if v.each_item and v.pre],
+                *(get_validators() if get_validators else list(find_validators(self.type_, self.model_config))),
+                *[v.func for v in class_validators_ if v.each_item and not v.pre],
+            )
+            self.validators = prep_validators(v_funcs)
+
+        self.pre_validators = []
+        self.post_validators = []
+
+        if self.field_info and self.field_info.const:
+            self.post_validators.append(make_generic_validator(constant_validator))
+
+        if class_validators_:
+            self.pre_validators += prep_validators(v.func for v in class_validators_ if not v.each_item and v.pre)
+            self.post_validators += prep_validators(v.func for v in class_validators_ if not v.each_item and not v.pre)
+
+        if self.parse_json:
+            self.pre_validators.append(make_generic_validator(validate_json))
+
+        self.pre_validators = self.pre_validators or None
+        self.post_validators = self.post_validators or None
+
+    def validate(
+        self, v: Any, values: Dict[str, Any], *, loc: 'LocStr', cls: Optional['ModelOrDc'] = None
+    ) -> 'ValidateReturn':
+
+        assert self.type_.__class__ is not DeferredType
+
+        if self.type_.__class__ is ForwardRef:
+            assert cls is not None
+            raise ConfigError(
+                f'field "{self.name}" not yet prepared so type is still a ForwardRef, '
+                f'you might need to call {cls.__name__}.update_forward_refs().'
+            )
+
+        errors: Optional['ErrorList']
+        if self.pre_validators:
+            v, errors = self._apply_validators(v, values, loc, cls, self.pre_validators)
+            if errors:
+                return v, errors
+
+        if v is None:
+            if is_none_type(self.type_):
+                # keep validating
+                pass
+            elif self.allow_none:
+                if self.post_validators:
+                    return self._apply_validators(v, values, loc, cls, self.post_validators)
+                else:
+                    return None, None
+            else:
+                return v, ErrorWrapper(NoneIsNotAllowedError(), loc)
+
+        if self.shape == SHAPE_SINGLETON:
+            v, errors = self._validate_singleton(v, values, loc, cls)
+        elif self.shape in MAPPING_LIKE_SHAPES:
+            v, errors = self._validate_mapping_like(v, values, loc, cls)
+        elif self.shape == SHAPE_TUPLE:
+            v, errors = self._validate_tuple(v, values, loc, cls)
+        elif self.shape == SHAPE_ITERABLE:
+            v, errors = self._validate_iterable(v, values, loc, cls)
+        elif self.shape == SHAPE_GENERIC:
+            v, errors = self._apply_validators(v, values, loc, cls, self.validators)
+        else:
+            #  sequence, list, set, generator, tuple with ellipsis, frozen set
+            v, errors = self._validate_sequence_like(v, values, loc, cls)
+
+        if not errors and self.post_validators:
+            v, errors = self._apply_validators(v, values, loc, cls, self.post_validators)
+        return v, errors
+
+    def _validate_sequence_like(  # noqa: C901 (ignore complexity)
+        self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc']
+    ) -> 'ValidateReturn':
+        """
+        Validate sequence-like containers: lists, tuples, sets and generators
+        Note that large if-else blocks are necessary to enable Cython
+        optimization, which is why we disable the complexity check above.
+        """
+        if not sequence_like(v):
+            e: errors_.PydanticTypeError
+            if self.shape == SHAPE_LIST:
+                e = errors_.ListError()
+            elif self.shape in (SHAPE_TUPLE, SHAPE_TUPLE_ELLIPSIS):
+                e = errors_.TupleError()
+            elif self.shape == SHAPE_SET:
+                e = errors_.SetError()
+            elif self.shape == SHAPE_FROZENSET:
+                e = errors_.FrozenSetError()
+            else:
+                e = errors_.SequenceError()
+            return v, ErrorWrapper(e, loc)
+
+        loc = loc if isinstance(loc, tuple) else (loc,)
+        result = []
+        errors: List[ErrorList] = []
+        for i, v_ in enumerate(v):
+            v_loc = *loc, i
+            r, ee = self._validate_singleton(v_, values, v_loc, cls)
+            if ee:
+                errors.append(ee)
+            else:
+                result.append(r)
+
+        if errors:
+            return v, errors
+
+        converted: Union[List[Any], Set[Any], FrozenSet[Any], Tuple[Any, ...], Iterator[Any], Deque[Any]] = result
+
+        if self.shape == SHAPE_SET:
+            converted = set(result)
+        elif self.shape == SHAPE_FROZENSET:
+            converted = frozenset(result)
+        elif self.shape == SHAPE_TUPLE_ELLIPSIS:
+            converted = tuple(result)
+        elif self.shape == SHAPE_DEQUE:
+            converted = deque(result)
+        elif self.shape == SHAPE_SEQUENCE:
+            if isinstance(v, tuple):
+                converted = tuple(result)
+            elif isinstance(v, set):
+                converted = set(result)
+            elif isinstance(v, Generator):
+                converted = iter(result)
+            elif isinstance(v, deque):
+                converted = deque(result)
+        return converted, None
+
+    def _validate_iterable(
+        self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc']
+    ) -> 'ValidateReturn':
+        """
+        Validate Iterables.
+
+        This intentionally doesn't validate values to allow infinite generators.
+        """
+
+        try:
+            iterable = iter(v)
+        except TypeError:
+            return v, ErrorWrapper(errors_.IterableError(), loc)
+        return iterable, None
+
+    def _validate_tuple(
+        self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc']
+    ) -> 'ValidateReturn':
+        e: Optional[Exception] = None
+        if not sequence_like(v):
+            e = errors_.TupleError()
+        else:
+            actual_length, expected_length = len(v), len(self.sub_fields)  # type: ignore
+            if actual_length != expected_length:
+                e = errors_.TupleLengthError(actual_length=actual_length, expected_length=expected_length)
+
+        if e:
+            return v, ErrorWrapper(e, loc)
+
+        loc = loc if isinstance(loc, tuple) else (loc,)
+        result = []
+        errors: List[ErrorList] = []
+        for i, (v_, field) in enumerate(zip(v, self.sub_fields)):  # type: ignore
+            v_loc = *loc, i
+            r, ee = field.validate(v_, values, loc=v_loc, cls=cls)
+            if ee:
+                errors.append(ee)
+            else:
+                result.append(r)
+
+        if errors:
+            return v, errors
+        else:
+            return tuple(result), None
+
+    def _validate_mapping_like(
+        self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc']
+    ) -> 'ValidateReturn':
+        try:
+            v_iter = dict_validator(v)
+        except TypeError as exc:
+            return v, ErrorWrapper(exc, loc)
+
+        loc = loc if isinstance(loc, tuple) else (loc,)
+        result, errors = {}, []
+        for k, v_ in v_iter.items():
+            v_loc = *loc, '__key__'
+            key_result, key_errors = self.key_field.validate(k, values, loc=v_loc, cls=cls)  # type: ignore
+            if key_errors:
+                errors.append(key_errors)
+                continue
+
+            v_loc = *loc, k
+            value_result, value_errors = self._validate_singleton(v_, values, v_loc, cls)
+            if value_errors:
+                errors.append(value_errors)
+                continue
+
+            result[key_result] = value_result
+        if errors:
+            return v, errors
+        elif self.shape == SHAPE_DICT:
+            return result, None
+        elif self.shape == SHAPE_DEFAULTDICT:
+            return defaultdict(self.type_, result), None
+        elif self.shape == SHAPE_COUNTER:
+            return CollectionCounter(result), None
+        else:
+            return self._get_mapping_value(v, result), None
+
+    def _get_mapping_value(self, original: T, converted: Dict[Any, Any]) -> Union[T, Dict[Any, Any]]:
+        """
+        When type is `Mapping[KT, KV]` (or another unsupported mapping), we try to avoid
+        coercing to `dict` unwillingly.
+        """
+        original_cls = original.__class__
+
+        if original_cls == dict or original_cls == Dict:
+            return converted
+        elif original_cls in {defaultdict, DefaultDict}:
+            return defaultdict(self.type_, converted)
+        else:
+            try:
+                # Counter, OrderedDict, UserDict, ...
+                return original_cls(converted)  # type: ignore
+            except TypeError:
+                raise RuntimeError(f'Could not convert dictionary to {original_cls.__name__!r}') from None
+
+    def _validate_singleton(
+        self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc']
+    ) -> 'ValidateReturn':
+        if self.sub_fields:
+            if self.discriminator_key is not None:
+                return self._validate_discriminated_union(v, values, loc, cls)
+
+            errors = []
+
+            if self.model_config.smart_union and is_union(get_origin(self.type_)):
+                # 1st pass: check if the value is an exact instance of one of the Union types
+                # (e.g. to avoid coercing a bool into an int)
+                for field in self.sub_fields:
+                    if v.__class__ is field.outer_type_:
+                        return v, None
+
+                # 2nd pass: check if the value is an instance of any subclass of the Union types
+                for field in self.sub_fields:
+                    # This whole logic will be improved later on to support more complex `isinstance` checks
+                    # It will probably be done once a strict mode is added and be something like:
+                    # ```
+                    #     value, error = field.validate(v, values, strict=True)
+                    #     if error is None:
+                    #         return value, None
+                    # ```
+                    try:
+                        if isinstance(v, field.outer_type_):
+                            return v, None
+                    except TypeError:
+                        # compound type
+                        if lenient_isinstance(v, get_origin(field.outer_type_)):
+                            value, error = field.validate(v, values, loc=loc, cls=cls)
+                            if not error:
+                                return value, None
+
+            # 1st pass by default or 3rd pass with `smart_union` enabled:
+            # check if the value can be coerced into one of the Union types
+            for field in self.sub_fields:
+                value, error = field.validate(v, values, loc=loc, cls=cls)
+                if error:
+                    errors.append(error)
+                else:
+                    return value, None
+            return v, errors
+        else:
+            return self._apply_validators(v, values, loc, cls, self.validators)
+
+    def _validate_discriminated_union(
+        self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc']
+    ) -> 'ValidateReturn':
+        assert self.discriminator_key is not None
+        assert self.discriminator_alias is not None
+
+        try:
+            discriminator_value = v[self.discriminator_alias]
+        except KeyError:
+            return v, ErrorWrapper(MissingDiscriminator(discriminator_key=self.discriminator_key), loc)
+        except TypeError:
+            try:
+                # BaseModel or dataclass
+                discriminator_value = getattr(v, self.discriminator_key)
+            except (AttributeError, TypeError):
+                return v, ErrorWrapper(MissingDiscriminator(discriminator_key=self.discriminator_key), loc)
+
+        try:
+            sub_field = self.sub_fields_mapping[discriminator_value]  # type: ignore[index]
+        except TypeError:
+            assert cls is not None
+            raise ConfigError(
+                f'field "{self.name}" not yet prepared so type is still a ForwardRef, '
+                f'you might need to call {cls.__name__}.update_forward_refs().'
+            )
+        except KeyError:
+            assert self.sub_fields_mapping is not None
+            return v, ErrorWrapper(
+                InvalidDiscriminator(
+                    discriminator_key=self.discriminator_key,
+                    discriminator_value=discriminator_value,
+                    allowed_values=list(self.sub_fields_mapping),
+                ),
+                loc,
+            )
+        else:
+            if not isinstance(loc, tuple):
+                loc = (loc,)
+            return sub_field.validate(v, values, loc=(*loc, display_as_type(sub_field.type_)), cls=cls)
+
+    def _apply_validators(
+        self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc'], validators: 'ValidatorsList'
+    ) -> 'ValidateReturn':
+        for validator in validators:
+            try:
+                v = validator(cls, v, values, self, self.model_config)
+            except (ValueError, TypeError, AssertionError) as exc:
+                return v, ErrorWrapper(exc, loc)
+        return v, None
+
+    def is_complex(self) -> bool:
+        """
+        Whether the field is "complex" eg. env variables should be parsed as JSON.
+        """
+        from .main import BaseModel
+
+        return (
+            self.shape != SHAPE_SINGLETON
+            or hasattr(self.type_, '__pydantic_model__')
+            or lenient_issubclass(self.type_, (BaseModel, list, set, frozenset, dict))
+        )
+
+    def _type_display(self) -> PyObjectStr:
+        t = display_as_type(self.type_)
+
+        if self.shape in MAPPING_LIKE_SHAPES:
+            t = f'Mapping[{display_as_type(self.key_field.type_)}, {t}]'  # type: ignore
+        elif self.shape == SHAPE_TUPLE:
+            t = 'Tuple[{}]'.format(', '.join(display_as_type(f.type_) for f in self.sub_fields))  # type: ignore
+        elif self.shape == SHAPE_GENERIC:
+            assert self.sub_fields
+            t = '{}[{}]'.format(
+                display_as_type(self.type_), ', '.join(display_as_type(f.type_) for f in self.sub_fields)
+            )
+        elif self.shape != SHAPE_SINGLETON:
+            t = SHAPE_NAME_LOOKUP[self.shape].format(t)
+
+        if self.allow_none and (self.shape != SHAPE_SINGLETON or not self.sub_fields):
+            t = f'Optional[{t}]'
+        return PyObjectStr(t)
+
+    def __repr_args__(self) -> 'ReprArgs':
+        args = [('name', self.name), ('type', self._type_display()), ('required', self.required)]
+
+        if not self.required:
+            if self.default_factory is not None:
+                args.append(('default_factory', f'<function {self.default_factory.__name__}>'))
+            else:
+                args.append(('default', self.default))
+
+        if self.alt_alias:
+            args.append(('alias', self.alias))
+        return args
+
+
+class ModelPrivateAttr(Representation):
+    __slots__ = ('default', 'default_factory')
+
+    def __init__(self, default: Any = Undefined, *, default_factory: Optional[NoArgAnyCallable] = None) -> None:
         self.default = default
         self.default_factory = default_factory
 
-    if not typing.TYPE_CHECKING:
-        # We put `__getattr__` in a non-TYPE_CHECKING block because otherwise, mypy allows arbitrary attribute access
-
-        def __getattr__(self, item: str) -> Any:
-            """This function improves compatibility with custom descriptors by ensuring delegation happens
-            as expected when the default value of a private attribute is a descriptor.
-            """
-            if item in {'__get__', '__set__', '__delete__'}:
-                if hasattr(self.default, item):
-                    return getattr(self.default, item)
-            raise AttributeError(f'{type(self).__name__!r} object has no attribute {item!r}')
-
-    def __set_name__(self, cls: type[Any], name: str) -> None:
-        """Preserve `__set_name__` protocol defined in https://peps.python.org/pep-0487."""
-        if self.default is PydanticUndefined:
-            return
-        if not hasattr(self.default, '__set_name__'):
-            return
-        set_name = self.default.__set_name__
-        if callable(set_name):
-            set_name(cls, name)
-
     def get_default(self) -> Any:
-        """Retrieve the default value of the object.
-
-        If `self.default_factory` is `None`, the method will return a deep copy of the `self.default` object.
-
-        If `self.default_factory` is not `None`, it will call `self.default_factory` and return the value returned.
-
-        Returns:
-            The default value of the object.
-        """
-        return _utils.smart_deepcopy(self.default) if self.default_factory is None else self.default_factory()
+        return smart_deepcopy(self.default) if self.default_factory is None else self.default_factory()
 
     def __eq__(self, other: Any) -> bool:
         return isinstance(other, self.__class__) and (self.default, self.default_factory) == (
@@ -879,32 +1213,23 @@ class ModelPrivateAttr(_repr.Representation):
 
 
 def PrivateAttr(
-    default: Any = PydanticUndefined,
+    default: Any = Undefined,
     *,
-    default_factory: typing.Callable[[], Any] | None = None,
+    default_factory: Optional[NoArgAnyCallable] = None,
 ) -> Any:
-    """Usage docs: https://docs.pydantic.dev/2.6/concepts/models/#private-model-attributes
-
-    Indicates that an attribute is intended for private use and not handled during normal validation/serialization.
-
-    Private attributes are not validated by Pydantic, so it's up to you to ensure they are used in a type-safe manner.
-
-    Private attributes are stored in `__private_attributes__` on the model.
-
-    Args:
-        default: The attribute's default value. Defaults to Undefined.
-        default_factory: Callable that will be
-            called when a default value is needed for this attribute.
-            If both `default` and `default_factory` are set, an error will be raised.
-
-    Returns:
-        An instance of [`ModelPrivateAttr`][pydantic.fields.ModelPrivateAttr] class.
-
-    Raises:
-        ValueError: If both `default` and `default_factory` are set.
     """
-    if default is not PydanticUndefined and default_factory is not None:
-        raise TypeError('cannot specify both default and default_factory')
+    Indicates that attribute is only used internally and never mixed with regular fields.
+
+    Types or values of private attrs are not checked by pydantic and it's up to you to keep them relevant.
+
+    Private attrs are stored in model __slots__.
+
+    :param default: the attribute’s default value
+    :param default_factory: callable that will be called when a default value is needed for this attribute
+      If both `default` and `default_factory` are set, an error is raised.
+    """
+    if default is not Undefined and default_factory is not None:
+        raise ValueError('cannot specify both default and default_factory')
 
     return ModelPrivateAttr(
         default,
@@ -912,243 +1237,11 @@ def PrivateAttr(
     )
 
 
-@dataclasses.dataclass(**_internal_dataclass.slots_true)
-class ComputedFieldInfo:
-    """A container for data from `@computed_field` so that we can access it while building the pydantic-core schema.
-
-    Attributes:
-        decorator_repr: A class variable representing the decorator string, '@computed_field'.
-        wrapped_property: The wrapped computed field property.
-        return_type: The type of the computed field property's return value.
-        alias: The alias of the property to be used during serialization.
-        alias_priority: The priority of the alias. This affects whether an alias generator is used.
-        title: Title of the computed field to include in the serialization JSON schema.
-        description: Description of the computed field to include in the serialization JSON schema.
-        examples: Example values of the computed field to include in the serialization JSON schema.
-        json_schema_extra: A dict or callable to provide extra JSON schema properties.
-        repr: A boolean indicating whether to include the field in the __repr__ output.
+class DeferredType:
+    """
+    Used to postpone field preparation, while creating recursive generic models.
     """
 
-    decorator_repr: ClassVar[str] = '@computed_field'
-    wrapped_property: property
-    return_type: Any
-    alias: str | None
-    alias_priority: int | None
-    title: str | None
-    description: str | None
-    examples: list[Any] | None
-    json_schema_extra: JsonDict | typing.Callable[[JsonDict], None] | None
-    repr: bool
 
-
-def _wrapped_property_is_private(property_: cached_property | property) -> bool:  # type: ignore
-    """Returns true if provided property is private, False otherwise."""
-    wrapped_name: str = ''
-
-    if isinstance(property_, property):
-        wrapped_name = getattr(property_.fget, '__name__', '')
-    elif isinstance(property_, cached_property):  # type: ignore
-        wrapped_name = getattr(property_.func, '__name__', '')  # type: ignore
-
-    return wrapped_name.startswith('_') and not wrapped_name.startswith('__')
-
-
-# this should really be `property[T], cached_property[T]` but property is not generic unlike cached_property
-# See https://github.com/python/typing/issues/985 and linked issues
-PropertyT = typing.TypeVar('PropertyT')
-
-
-@typing.overload
-def computed_field(
-    *,
-    alias: str | None = None,
-    alias_priority: int | None = None,
-    title: str | None = None,
-    description: str | None = None,
-    examples: list[Any] | None = None,
-    json_schema_extra: JsonDict | typing.Callable[[JsonDict], None] | None = None,
-    repr: bool = True,
-    return_type: Any = PydanticUndefined,
-) -> typing.Callable[[PropertyT], PropertyT]:
-    ...
-
-
-@typing.overload
-def computed_field(__func: PropertyT) -> PropertyT:
-    ...
-
-
-def computed_field(
-    __f: PropertyT | None = None,
-    *,
-    alias: str | None = None,
-    alias_priority: int | None = None,
-    title: str | None = None,
-    description: str | None = None,
-    examples: list[Any] | None = None,
-    json_schema_extra: JsonDict | typing.Callable[[JsonDict], None] | None = None,
-    repr: bool | None = None,
-    return_type: Any = PydanticUndefined,
-) -> PropertyT | typing.Callable[[PropertyT], PropertyT]:
-    """Usage docs: https://docs.pydantic.dev/2.6/concepts/fields#the-computed_field-decorator
-
-    Decorator to include `property` and `cached_property` when serializing models or dataclasses.
-
-    This is useful for fields that are computed from other fields, or for fields that are expensive to compute and should be cached.
-
-    ```py
-    from pydantic import BaseModel, computed_field
-
-    class Rectangle(BaseModel):
-        width: int
-        length: int
-
-        @computed_field
-        @property
-        def area(self) -> int:
-            return self.width * self.length
-
-    print(Rectangle(width=3, length=2).model_dump())
-    #> {'width': 3, 'length': 2, 'area': 6}
-    ```
-
-    If applied to functions not yet decorated with `@property` or `@cached_property`, the function is
-    automatically wrapped with `property`. Although this is more concise, you will lose IntelliSense in your IDE,
-    and confuse static type checkers, thus explicit use of `@property` is recommended.
-
-    !!! warning "Mypy Warning"
-        Even with the `@property` or `@cached_property` applied to your function before `@computed_field`,
-        mypy may throw a `Decorated property not supported` error.
-        See [mypy issue #1362](https://github.com/python/mypy/issues/1362), for more information.
-        To avoid this error message, add `# type: ignore[misc]` to the `@computed_field` line.
-
-        [pyright](https://github.com/microsoft/pyright) supports `@computed_field` without error.
-
-    ```py
-    import random
-
-    from pydantic import BaseModel, computed_field
-
-    class Square(BaseModel):
-        width: float
-
-        @computed_field
-        def area(self) -> float:  # converted to a `property` by `computed_field`
-            return round(self.width**2, 2)
-
-        @area.setter
-        def area(self, new_area: float) -> None:
-            self.width = new_area**0.5
-
-        @computed_field(alias='the magic number', repr=False)
-        def random_number(self) -> int:
-            return random.randint(0, 1_000)
-
-    square = Square(width=1.3)
-
-    # `random_number` does not appear in representation
-    print(repr(square))
-    #> Square(width=1.3, area=1.69)
-
-    print(square.random_number)
-    #> 3
-
-    square.area = 4
-
-    print(square.model_dump_json(by_alias=True))
-    #> {"width":2.0,"area":4.0,"the magic number":3}
-    ```
-
-    !!! warning "Overriding with `computed_field`"
-        You can't override a field from a parent class with a `computed_field` in the child class.
-        `mypy` complains about this behavior if allowed, and `dataclasses` doesn't allow this pattern either.
-        See the example below:
-
-    ```py
-    from pydantic import BaseModel, computed_field
-
-    class Parent(BaseModel):
-        a: str
-
-    try:
-
-        class Child(Parent):
-            @computed_field
-            @property
-            def a(self) -> str:
-                return 'new a'
-
-    except ValueError as e:
-        print(repr(e))
-        #> ValueError("you can't override a field with a computed field")
-    ```
-
-    Private properties decorated with `@computed_field` have `repr=False` by default.
-
-    ```py
-    from functools import cached_property
-
-    from pydantic import BaseModel, computed_field
-
-    class Model(BaseModel):
-        foo: int
-
-        @computed_field
-        @cached_property
-        def _private_cached_property(self) -> int:
-            return -self.foo
-
-        @computed_field
-        @property
-        def _private_property(self) -> int:
-            return -self.foo
-
-    m = Model(foo=1)
-    print(repr(m))
-    #> M(foo=1)
-    ```
-
-    Args:
-        __f: the function to wrap.
-        alias: alias to use when serializing this computed field, only used when `by_alias=True`
-        alias_priority: priority of the alias. This affects whether an alias generator is used
-        title: Title to use when including this computed field in JSON Schema
-        description: Description to use when including this computed field in JSON Schema, defaults to the function's
-            docstring
-        examples: Example values to use when including this computed field in JSON Schema
-        json_schema_extra: A dict or callable to provide extra JSON schema properties.
-        repr: whether to include this computed field in model repr.
-            Default is `False` for private properties and `True` for public properties.
-        return_type: optional return for serialization logic to expect when serializing to JSON, if included
-            this must be correct, otherwise a `TypeError` is raised.
-            If you don't include a return type Any is used, which does runtime introspection to handle arbitrary
-            objects.
-
-    Returns:
-        A proxy wrapper for the property.
-    """
-
-    def dec(f: Any) -> Any:
-        nonlocal description, return_type, alias_priority
-        unwrapped = _decorators.unwrap_wrapped_function(f)
-        if description is None and unwrapped.__doc__:
-            description = inspect.cleandoc(unwrapped.__doc__)
-
-        # if the function isn't already decorated with `@property` (or another descriptor), then we wrap it now
-        f = _decorators.ensure_property(f)
-        alias_priority = (alias_priority or 2) if alias is not None else None
-
-        if repr is None:
-            repr_: bool = False if _wrapped_property_is_private(property_=f) else True
-        else:
-            repr_ = repr
-
-        dec_info = ComputedFieldInfo(
-            f, return_type, alias, alias_priority, title, description, examples, json_schema_extra, repr_
-        )
-        return _decorators.PydanticDescriptorProxy(f, dec_info)
-
-    if __f is None:
-        return dec
-    else:
-        return dec(__f)
+def is_finalvar_with_default_val(type_: Type[Any], val: Any) -> bool:
+    return is_finalvar(type_) and val is not Undefined and not isinstance(val, FieldInfo)
diff --git a/lib/pydantic/functional_serializers.py b/lib/pydantic/functional_serializers.py
deleted file mode 100644
index 6e31bf67..00000000
--- a/lib/pydantic/functional_serializers.py
+++ /dev/null
@@ -1,395 +0,0 @@
-"""This module contains related classes and functions for serialization."""
-from __future__ import annotations
-
-import dataclasses
-from functools import partialmethod
-from typing import TYPE_CHECKING, Any, Callable, TypeVar, Union, overload
-
-from pydantic_core import PydanticUndefined, core_schema
-from pydantic_core import core_schema as _core_schema
-from typing_extensions import Annotated, Literal, TypeAlias
-
-from . import PydanticUndefinedAnnotation
-from ._internal import _decorators, _internal_dataclass
-from .annotated_handlers import GetCoreSchemaHandler
-
-
-@dataclasses.dataclass(**_internal_dataclass.slots_true, frozen=True)
-class PlainSerializer:
-    """Plain serializers use a function to modify the output of serialization.
-
-    This is particularly helpful when you want to customize the serialization for annotated types.
-    Consider an input of `list`, which will be serialized into a space-delimited string.
-
-    ```python
-    from typing import List
-
-    from typing_extensions import Annotated
-
-    from pydantic import BaseModel, PlainSerializer
-
-    CustomStr = Annotated[
-        List, PlainSerializer(lambda x: ' '.join(x), return_type=str)
-    ]
-
-    class StudentModel(BaseModel):
-        courses: CustomStr
-
-    student = StudentModel(courses=['Math', 'Chemistry', 'English'])
-    print(student.model_dump())
-    #> {'courses': 'Math Chemistry English'}
-    ```
-
-    Attributes:
-        func: The serializer function.
-        return_type: The return type for the function. If omitted it will be inferred from the type annotation.
-        when_used: Determines when this serializer should be used. Accepts a string with values `'always'`,
-            `'unless-none'`, `'json'`, and `'json-unless-none'`. Defaults to 'always'.
-    """
-
-    func: core_schema.SerializerFunction
-    return_type: Any = PydanticUndefined
-    when_used: Literal['always', 'unless-none', 'json', 'json-unless-none'] = 'always'
-
-    def __get_pydantic_core_schema__(self, source_type: Any, handler: GetCoreSchemaHandler) -> core_schema.CoreSchema:
-        """Gets the Pydantic core schema.
-
-        Args:
-            source_type: The source type.
-            handler: The `GetCoreSchemaHandler` instance.
-
-        Returns:
-            The Pydantic core schema.
-        """
-        schema = handler(source_type)
-        try:
-            return_type = _decorators.get_function_return_type(
-                self.func, self.return_type, handler._get_types_namespace()
-            )
-        except NameError as e:
-            raise PydanticUndefinedAnnotation.from_name_error(e) from e
-        return_schema = None if return_type is PydanticUndefined else handler.generate_schema(return_type)
-        schema['serialization'] = core_schema.plain_serializer_function_ser_schema(
-            function=self.func,
-            info_arg=_decorators.inspect_annotated_serializer(self.func, 'plain'),
-            return_schema=return_schema,
-            when_used=self.when_used,
-        )
-        return schema
-
-
-@dataclasses.dataclass(**_internal_dataclass.slots_true, frozen=True)
-class WrapSerializer:
-    """Wrap serializers receive the raw inputs along with a handler function that applies the standard serialization
-    logic, and can modify the resulting value before returning it as the final output of serialization.
-
-    For example, here's a scenario in which a wrap serializer transforms timezones to UTC **and** utilizes the existing `datetime` serialization logic.
-
-    ```python
-    from datetime import datetime, timezone
-    from typing import Any, Dict
-
-    from typing_extensions import Annotated
-
-    from pydantic import BaseModel, WrapSerializer
-
-    class EventDatetime(BaseModel):
-        start: datetime
-        end: datetime
-
-    def convert_to_utc(value: Any, handler, info) -> Dict[str, datetime]:
-        # Note that `helper` can actually help serialize the `value` for further custom serialization in case it's a subclass.
-        partial_result = handler(value, info)
-        if info.mode == 'json':
-            return {
-                k: datetime.fromisoformat(v).astimezone(timezone.utc)
-                for k, v in partial_result.items()
-            }
-        return {k: v.astimezone(timezone.utc) for k, v in partial_result.items()}
-
-    UTCEventDatetime = Annotated[EventDatetime, WrapSerializer(convert_to_utc)]
-
-    class EventModel(BaseModel):
-        event_datetime: UTCEventDatetime
-
-    dt = EventDatetime(
-        start='2024-01-01T07:00:00-08:00', end='2024-01-03T20:00:00+06:00'
-    )
-    event = EventModel(event_datetime=dt)
-    print(event.model_dump())
-    '''
-    {
-        'event_datetime': {
-            'start': datetime.datetime(
-                2024, 1, 1, 15, 0, tzinfo=datetime.timezone.utc
-            ),
-            'end': datetime.datetime(
-                2024, 1, 3, 14, 0, tzinfo=datetime.timezone.utc
-            ),
-        }
-    }
-    '''
-
-    print(event.model_dump_json())
-    '''
-    {"event_datetime":{"start":"2024-01-01T15:00:00Z","end":"2024-01-03T14:00:00Z"}}
-    '''
-    ```
-
-    Attributes:
-        func: The serializer function to be wrapped.
-        return_type: The return type for the function. If omitted it will be inferred from the type annotation.
-        when_used: Determines when this serializer should be used. Accepts a string with values `'always'`,
-            `'unless-none'`, `'json'`, and `'json-unless-none'`. Defaults to 'always'.
-    """
-
-    func: core_schema.WrapSerializerFunction
-    return_type: Any = PydanticUndefined
-    when_used: Literal['always', 'unless-none', 'json', 'json-unless-none'] = 'always'
-
-    def __get_pydantic_core_schema__(self, source_type: Any, handler: GetCoreSchemaHandler) -> core_schema.CoreSchema:
-        """This method is used to get the Pydantic core schema of the class.
-
-        Args:
-            source_type: Source type.
-            handler: Core schema handler.
-
-        Returns:
-            The generated core schema of the class.
-        """
-        schema = handler(source_type)
-        try:
-            return_type = _decorators.get_function_return_type(
-                self.func, self.return_type, handler._get_types_namespace()
-            )
-        except NameError as e:
-            raise PydanticUndefinedAnnotation.from_name_error(e) from e
-        return_schema = None if return_type is PydanticUndefined else handler.generate_schema(return_type)
-        schema['serialization'] = core_schema.wrap_serializer_function_ser_schema(
-            function=self.func,
-            info_arg=_decorators.inspect_annotated_serializer(self.func, 'wrap'),
-            return_schema=return_schema,
-            when_used=self.when_used,
-        )
-        return schema
-
-
-if TYPE_CHECKING:
-    _PartialClsOrStaticMethod: TypeAlias = Union[classmethod[Any, Any, Any], staticmethod[Any, Any], partialmethod[Any]]
-    _PlainSerializationFunction = Union[_core_schema.SerializerFunction, _PartialClsOrStaticMethod]
-    _WrapSerializationFunction = Union[_core_schema.WrapSerializerFunction, _PartialClsOrStaticMethod]
-    _PlainSerializeMethodType = TypeVar('_PlainSerializeMethodType', bound=_PlainSerializationFunction)
-    _WrapSerializeMethodType = TypeVar('_WrapSerializeMethodType', bound=_WrapSerializationFunction)
-
-
-@overload
-def field_serializer(
-    __field: str,
-    *fields: str,
-    return_type: Any = ...,
-    when_used: Literal['always', 'unless-none', 'json', 'json-unless-none'] = ...,
-    check_fields: bool | None = ...,
-) -> Callable[[_PlainSerializeMethodType], _PlainSerializeMethodType]:
-    ...
-
-
-@overload
-def field_serializer(
-    __field: str,
-    *fields: str,
-    mode: Literal['plain'],
-    return_type: Any = ...,
-    when_used: Literal['always', 'unless-none', 'json', 'json-unless-none'] = ...,
-    check_fields: bool | None = ...,
-) -> Callable[[_PlainSerializeMethodType], _PlainSerializeMethodType]:
-    ...
-
-
-@overload
-def field_serializer(
-    __field: str,
-    *fields: str,
-    mode: Literal['wrap'],
-    return_type: Any = ...,
-    when_used: Literal['always', 'unless-none', 'json', 'json-unless-none'] = ...,
-    check_fields: bool | None = ...,
-) -> Callable[[_WrapSerializeMethodType], _WrapSerializeMethodType]:
-    ...
-
-
-def field_serializer(
-    *fields: str,
-    mode: Literal['plain', 'wrap'] = 'plain',
-    return_type: Any = PydanticUndefined,
-    when_used: Literal['always', 'unless-none', 'json', 'json-unless-none'] = 'always',
-    check_fields: bool | None = None,
-) -> Callable[[Any], Any]:
-    """Decorator that enables custom field serialization.
-
-    In the below example, a field of type `set` is used to mitigate duplication. A `field_serializer` is used to serialize the data as a sorted list.
-
-    ```python
-    from typing import Set
-
-    from pydantic import BaseModel, field_serializer
-
-    class StudentModel(BaseModel):
-        name: str = 'Jane'
-        courses: Set[str]
-
-        @field_serializer('courses', when_used='json')
-        def serialize_courses_in_order(courses: Set[str]):
-            return sorted(courses)
-
-    student = StudentModel(courses={'Math', 'Chemistry', 'English'})
-    print(student.model_dump_json())
-    #> {"name":"Jane","courses":["Chemistry","English","Math"]}
-    ```
-
-    See [Custom serializers](../concepts/serialization.md#custom-serializers) for more information.
-
-    Four signatures are supported:
-
-    - `(self, value: Any, info: FieldSerializationInfo)`
-    - `(self, value: Any, nxt: SerializerFunctionWrapHandler, info: FieldSerializationInfo)`
-    - `(value: Any, info: SerializationInfo)`
-    - `(value: Any, nxt: SerializerFunctionWrapHandler, info: SerializationInfo)`
-
-    Args:
-        fields: Which field(s) the method should be called on.
-        mode: The serialization mode.
-
-            - `plain` means the function will be called instead of the default serialization logic,
-            - `wrap` means the function will be called with an argument to optionally call the
-               default serialization logic.
-        return_type: Optional return type for the function, if omitted it will be inferred from the type annotation.
-        when_used: Determines the serializer will be used for serialization.
-        check_fields: Whether to check that the fields actually exist on the model.
-
-    Returns:
-        The decorator function.
-    """
-
-    def dec(
-        f: Callable[..., Any] | staticmethod[Any, Any] | classmethod[Any, Any, Any],
-    ) -> _decorators.PydanticDescriptorProxy[Any]:
-        dec_info = _decorators.FieldSerializerDecoratorInfo(
-            fields=fields,
-            mode=mode,
-            return_type=return_type,
-            when_used=when_used,
-            check_fields=check_fields,
-        )
-        return _decorators.PydanticDescriptorProxy(f, dec_info)
-
-    return dec
-
-
-FuncType = TypeVar('FuncType', bound=Callable[..., Any])
-
-
-@overload
-def model_serializer(__f: FuncType) -> FuncType:
-    ...
-
-
-@overload
-def model_serializer(
-    *,
-    mode: Literal['plain', 'wrap'] = ...,
-    when_used: Literal['always', 'unless-none', 'json', 'json-unless-none'] = 'always',
-    return_type: Any = ...,
-) -> Callable[[FuncType], FuncType]:
-    ...
-
-
-def model_serializer(
-    __f: Callable[..., Any] | None = None,
-    *,
-    mode: Literal['plain', 'wrap'] = 'plain',
-    when_used: Literal['always', 'unless-none', 'json', 'json-unless-none'] = 'always',
-    return_type: Any = PydanticUndefined,
-) -> Callable[[Any], Any]:
-    """Decorator that enables custom model serialization.
-
-    This is useful when a model need to be serialized in a customized manner, allowing for flexibility beyond just specific fields.
-
-    An example would be to serialize temperature to the same temperature scale, such as degrees Celsius.
-
-    ```python
-    from typing import Literal
-
-    from pydantic import BaseModel, model_serializer
-
-    class TemperatureModel(BaseModel):
-        unit: Literal['C', 'F']
-        value: int
-
-        @model_serializer()
-        def serialize_model(self):
-            if self.unit == 'F':
-                return {'unit': 'C', 'value': int((self.value - 32) / 1.8)}
-            return {'unit': self.unit, 'value': self.value}
-
-    temperature = TemperatureModel(unit='F', value=212)
-    print(temperature.model_dump())
-    #> {'unit': 'C', 'value': 100}
-    ```
-
-    See [Custom serializers](../concepts/serialization.md#custom-serializers) for more information.
-
-    Args:
-        __f: The function to be decorated.
-        mode: The serialization mode.
-
-            - `'plain'` means the function will be called instead of the default serialization logic
-            - `'wrap'` means the function will be called with an argument to optionally call the default
-                serialization logic.
-        when_used: Determines when this serializer should be used.
-        return_type: The return type for the function. If omitted it will be inferred from the type annotation.
-
-    Returns:
-        The decorator function.
-    """
-
-    def dec(f: Callable[..., Any]) -> _decorators.PydanticDescriptorProxy[Any]:
-        dec_info = _decorators.ModelSerializerDecoratorInfo(mode=mode, return_type=return_type, when_used=when_used)
-        return _decorators.PydanticDescriptorProxy(f, dec_info)
-
-    if __f is None:
-        return dec
-    else:
-        return dec(__f)  # type: ignore
-
-
-AnyType = TypeVar('AnyType')
-
-
-if TYPE_CHECKING:
-    SerializeAsAny = Annotated[AnyType, ...]  # SerializeAsAny[list[str]] will be treated by type checkers as list[str]
-    """Force serialization to ignore whatever is defined in the schema and instead ask the object
-    itself how it should be serialized.
-    In particular, this means that when model subclasses are serialized, fields present in the subclass
-    but not in the original schema will be included.
-    """
-else:
-
-    @dataclasses.dataclass(**_internal_dataclass.slots_true)
-    class SerializeAsAny:  # noqa: D101
-        def __class_getitem__(cls, item: Any) -> Any:
-            return Annotated[item, SerializeAsAny()]
-
-        def __get_pydantic_core_schema__(
-            self, source_type: Any, handler: GetCoreSchemaHandler
-        ) -> core_schema.CoreSchema:
-            schema = handler(source_type)
-            schema_to_update = schema
-            while schema_to_update['type'] == 'definitions':
-                schema_to_update = schema_to_update.copy()
-                schema_to_update = schema_to_update['schema']
-            schema_to_update['serialization'] = core_schema.wrap_serializer_function_ser_schema(
-                lambda x, h: h(x), schema=core_schema.any_schema()
-            )
-            return schema
-
-        __hash__ = object.__hash__
diff --git a/lib/pydantic/functional_validators.py b/lib/pydantic/functional_validators.py
deleted file mode 100644
index b547755b..00000000
--- a/lib/pydantic/functional_validators.py
+++ /dev/null
@@ -1,706 +0,0 @@
-"""This module contains related classes and functions for validation."""
-
-from __future__ import annotations as _annotations
-
-import dataclasses
-import sys
-from functools import partialmethod
-from types import FunctionType
-from typing import TYPE_CHECKING, Any, Callable, TypeVar, Union, cast, overload
-
-from pydantic_core import core_schema
-from pydantic_core import core_schema as _core_schema
-from typing_extensions import Annotated, Literal, TypeAlias
-
-from . import GetCoreSchemaHandler as _GetCoreSchemaHandler
-from ._internal import _core_metadata, _decorators, _generics, _internal_dataclass
-from .annotated_handlers import GetCoreSchemaHandler
-from .errors import PydanticUserError
-
-if sys.version_info < (3, 11):
-    from typing_extensions import Protocol
-else:
-    from typing import Protocol
-
-_inspect_validator = _decorators.inspect_validator
-
-
-@dataclasses.dataclass(frozen=True, **_internal_dataclass.slots_true)
-class AfterValidator:
-    """Usage docs: https://docs.pydantic.dev/2.6/concepts/validators/#annotated-validators
-
-    A metadata class that indicates that a validation should be applied **after** the inner validation logic.
-
-    Attributes:
-        func: The validator function.
-
-    Example:
-        ```py
-        from typing_extensions import Annotated
-
-        from pydantic import AfterValidator, BaseModel, ValidationError
-
-        MyInt = Annotated[int, AfterValidator(lambda v: v + 1)]
-
-        class Model(BaseModel):
-            a: MyInt
-
-        print(Model(a=1).a)
-        #> 2
-
-        try:
-            Model(a='a')
-        except ValidationError as e:
-            print(e.json(indent=2))
-            '''
-            [
-              {
-                "type": "int_parsing",
-                "loc": [
-                  "a"
-                ],
-                "msg": "Input should be a valid integer, unable to parse string as an integer",
-                "input": "a",
-                "url": "https://errors.pydantic.dev/2/v/int_parsing"
-              }
-            ]
-            '''
-        ```
-    """
-
-    func: core_schema.NoInfoValidatorFunction | core_schema.WithInfoValidatorFunction
-
-    def __get_pydantic_core_schema__(self, source_type: Any, handler: _GetCoreSchemaHandler) -> core_schema.CoreSchema:
-        schema = handler(source_type)
-        info_arg = _inspect_validator(self.func, 'after')
-        if info_arg:
-            func = cast(core_schema.WithInfoValidatorFunction, self.func)
-            return core_schema.with_info_after_validator_function(func, schema=schema, field_name=handler.field_name)
-        else:
-            func = cast(core_schema.NoInfoValidatorFunction, self.func)
-            return core_schema.no_info_after_validator_function(func, schema=schema)
-
-
-@dataclasses.dataclass(frozen=True, **_internal_dataclass.slots_true)
-class BeforeValidator:
-    """Usage docs: https://docs.pydantic.dev/2.6/concepts/validators/#annotated-validators
-
-    A metadata class that indicates that a validation should be applied **before** the inner validation logic.
-
-    Attributes:
-        func: The validator function.
-
-    Example:
-        ```py
-        from typing_extensions import Annotated
-
-        from pydantic import BaseModel, BeforeValidator
-
-        MyInt = Annotated[int, BeforeValidator(lambda v: v + 1)]
-
-        class Model(BaseModel):
-            a: MyInt
-
-        print(Model(a=1).a)
-        #> 2
-
-        try:
-            Model(a='a')
-        except TypeError as e:
-            print(e)
-            #> can only concatenate str (not "int") to str
-        ```
-    """
-
-    func: core_schema.NoInfoValidatorFunction | core_schema.WithInfoValidatorFunction
-
-    def __get_pydantic_core_schema__(self, source_type: Any, handler: _GetCoreSchemaHandler) -> core_schema.CoreSchema:
-        schema = handler(source_type)
-        info_arg = _inspect_validator(self.func, 'before')
-        if info_arg:
-            func = cast(core_schema.WithInfoValidatorFunction, self.func)
-            return core_schema.with_info_before_validator_function(func, schema=schema, field_name=handler.field_name)
-        else:
-            func = cast(core_schema.NoInfoValidatorFunction, self.func)
-            return core_schema.no_info_before_validator_function(func, schema=schema)
-
-
-@dataclasses.dataclass(frozen=True, **_internal_dataclass.slots_true)
-class PlainValidator:
-    """Usage docs: https://docs.pydantic.dev/2.6/concepts/validators/#annotated-validators
-
-    A metadata class that indicates that a validation should be applied **instead** of the inner validation logic.
-
-    Attributes:
-        func: The validator function.
-
-    Example:
-        ```py
-        from typing_extensions import Annotated
-
-        from pydantic import BaseModel, PlainValidator
-
-        MyInt = Annotated[int, PlainValidator(lambda v: int(v) + 1)]
-
-        class Model(BaseModel):
-            a: MyInt
-
-        print(Model(a='1').a)
-        #> 2
-        ```
-    """
-
-    func: core_schema.NoInfoValidatorFunction | core_schema.WithInfoValidatorFunction
-
-    def __get_pydantic_core_schema__(self, source_type: Any, handler: _GetCoreSchemaHandler) -> core_schema.CoreSchema:
-        # Note that for some valid uses of PlainValidator, it is not possible to generate a core schema for the
-        # source_type, so calling `handler(source_type)` will error, which prevents us from generating a proper
-        # serialization schema. To work around this for use cases that will not involve serialization, we simply
-        # catch any PydanticSchemaGenerationError that may be raised while attempting to build the serialization schema
-        # and abort any attempts to handle special serialization.
-        from pydantic import PydanticSchemaGenerationError
-
-        try:
-            schema = handler(source_type)
-            serialization = core_schema.wrap_serializer_function_ser_schema(function=lambda v, h: h(v), schema=schema)
-        except PydanticSchemaGenerationError:
-            serialization = None
-
-        info_arg = _inspect_validator(self.func, 'plain')
-        if info_arg:
-            func = cast(core_schema.WithInfoValidatorFunction, self.func)
-            return core_schema.with_info_plain_validator_function(
-                func, field_name=handler.field_name, serialization=serialization
-            )
-        else:
-            func = cast(core_schema.NoInfoValidatorFunction, self.func)
-            return core_schema.no_info_plain_validator_function(func, serialization=serialization)
-
-
-@dataclasses.dataclass(frozen=True, **_internal_dataclass.slots_true)
-class WrapValidator:
-    """Usage docs: https://docs.pydantic.dev/2.6/concepts/validators/#annotated-validators
-
-    A metadata class that indicates that a validation should be applied **around** the inner validation logic.
-
-    Attributes:
-        func: The validator function.
-
-    ```py
-    from datetime import datetime
-
-    from typing_extensions import Annotated
-
-    from pydantic import BaseModel, ValidationError, WrapValidator
-
-    def validate_timestamp(v, handler):
-        if v == 'now':
-            # we don't want to bother with further validation, just return the new value
-            return datetime.now()
-        try:
-            return handler(v)
-        except ValidationError:
-            # validation failed, in this case we want to return a default value
-            return datetime(2000, 1, 1)
-
-    MyTimestamp = Annotated[datetime, WrapValidator(validate_timestamp)]
-
-    class Model(BaseModel):
-        a: MyTimestamp
-
-    print(Model(a='now').a)
-    #> 2032-01-02 03:04:05.000006
-    print(Model(a='invalid').a)
-    #> 2000-01-01 00:00:00
-    ```
-    """
-
-    func: core_schema.NoInfoWrapValidatorFunction | core_schema.WithInfoWrapValidatorFunction
-
-    def __get_pydantic_core_schema__(self, source_type: Any, handler: _GetCoreSchemaHandler) -> core_schema.CoreSchema:
-        schema = handler(source_type)
-        info_arg = _inspect_validator(self.func, 'wrap')
-        if info_arg:
-            func = cast(core_schema.WithInfoWrapValidatorFunction, self.func)
-            return core_schema.with_info_wrap_validator_function(func, schema=schema, field_name=handler.field_name)
-        else:
-            func = cast(core_schema.NoInfoWrapValidatorFunction, self.func)
-            return core_schema.no_info_wrap_validator_function(func, schema=schema)
-
-
-if TYPE_CHECKING:
-
-    class _OnlyValueValidatorClsMethod(Protocol):
-        def __call__(self, cls: Any, value: Any, /) -> Any:
-            ...
-
-    class _V2ValidatorClsMethod(Protocol):
-        def __call__(self, cls: Any, value: Any, info: _core_schema.ValidationInfo, /) -> Any:
-            ...
-
-    class _V2WrapValidatorClsMethod(Protocol):
-        def __call__(
-            self,
-            cls: Any,
-            value: Any,
-            handler: _core_schema.ValidatorFunctionWrapHandler,
-            info: _core_schema.ValidationInfo,
-            /,
-        ) -> Any:
-            ...
-
-    _V2Validator = Union[
-        _V2ValidatorClsMethod,
-        _core_schema.WithInfoValidatorFunction,
-        _OnlyValueValidatorClsMethod,
-        _core_schema.NoInfoValidatorFunction,
-    ]
-
-    _V2WrapValidator = Union[
-        _V2WrapValidatorClsMethod,
-        _core_schema.WithInfoWrapValidatorFunction,
-    ]
-
-    _PartialClsOrStaticMethod: TypeAlias = Union[classmethod[Any, Any, Any], staticmethod[Any, Any], partialmethod[Any]]
-
-    _V2BeforeAfterOrPlainValidatorType = TypeVar(
-        '_V2BeforeAfterOrPlainValidatorType',
-        _V2Validator,
-        _PartialClsOrStaticMethod,
-    )
-    _V2WrapValidatorType = TypeVar('_V2WrapValidatorType', _V2WrapValidator, _PartialClsOrStaticMethod)
-
-
-@overload
-def field_validator(
-    __field: str,
-    *fields: str,
-    mode: Literal['before', 'after', 'plain'] = ...,
-    check_fields: bool | None = ...,
-) -> Callable[[_V2BeforeAfterOrPlainValidatorType], _V2BeforeAfterOrPlainValidatorType]:
-    ...
-
-
-@overload
-def field_validator(
-    __field: str,
-    *fields: str,
-    mode: Literal['wrap'],
-    check_fields: bool | None = ...,
-) -> Callable[[_V2WrapValidatorType], _V2WrapValidatorType]:
-    ...
-
-
-FieldValidatorModes: TypeAlias = Literal['before', 'after', 'wrap', 'plain']
-
-
-def field_validator(
-    __field: str,
-    *fields: str,
-    mode: FieldValidatorModes = 'after',
-    check_fields: bool | None = None,
-) -> Callable[[Any], Any]:
-    """Usage docs: https://docs.pydantic.dev/2.6/concepts/validators/#field-validators
-
-    Decorate methods on the class indicating that they should be used to validate fields.
-
-    Example usage:
-    ```py
-    from typing import Any
-
-    from pydantic import (
-        BaseModel,
-        ValidationError,
-        field_validator,
-    )
-
-    class Model(BaseModel):
-        a: str
-
-        @field_validator('a')
-        @classmethod
-        def ensure_foobar(cls, v: Any):
-            if 'foobar' not in v:
-                raise ValueError('"foobar" not found in a')
-            return v
-
-    print(repr(Model(a='this is foobar good')))
-    #> Model(a='this is foobar good')
-
-    try:
-        Model(a='snap')
-    except ValidationError as exc_info:
-        print(exc_info)
-        '''
-        1 validation error for Model
-        a
-          Value error, "foobar" not found in a [type=value_error, input_value='snap', input_type=str]
-        '''
-    ```
-
-    For more in depth examples, see [Field Validators](../concepts/validators.md#field-validators).
-
-    Args:
-        __field: The first field the `field_validator` should be called on; this is separate
-            from `fields` to ensure an error is raised if you don't pass at least one.
-        *fields: Additional field(s) the `field_validator` should be called on.
-        mode: Specifies whether to validate the fields before or after validation.
-        check_fields: Whether to check that the fields actually exist on the model.
-
-    Returns:
-        A decorator that can be used to decorate a function to be used as a field_validator.
-
-    Raises:
-        PydanticUserError:
-            - If `@field_validator` is used bare (with no fields).
-            - If the args passed to `@field_validator` as fields are not strings.
-            - If `@field_validator` applied to instance methods.
-    """
-    if isinstance(__field, FunctionType):
-        raise PydanticUserError(
-            '`@field_validator` should be used with fields and keyword arguments, not bare. '
-            "E.g. usage should be `@validator('<field_name>', ...)`",
-            code='validator-no-fields',
-        )
-    fields = __field, *fields
-    if not all(isinstance(field, str) for field in fields):
-        raise PydanticUserError(
-            '`@field_validator` fields should be passed as separate string args. '
-            "E.g. usage should be `@validator('<field_name_1>', '<field_name_2>', ...)`",
-            code='validator-invalid-fields',
-        )
-
-    def dec(
-        f: Callable[..., Any] | staticmethod[Any, Any] | classmethod[Any, Any, Any],
-    ) -> _decorators.PydanticDescriptorProxy[Any]:
-        if _decorators.is_instance_method_from_sig(f):
-            raise PydanticUserError(
-                '`@field_validator` cannot be applied to instance methods', code='validator-instance-method'
-            )
-
-        # auto apply the @classmethod decorator
-        f = _decorators.ensure_classmethod_based_on_signature(f)
-
-        dec_info = _decorators.FieldValidatorDecoratorInfo(fields=fields, mode=mode, check_fields=check_fields)
-        return _decorators.PydanticDescriptorProxy(f, dec_info)
-
-    return dec
-
-
-_ModelType = TypeVar('_ModelType')
-_ModelTypeCo = TypeVar('_ModelTypeCo', covariant=True)
-
-
-class ModelWrapValidatorHandler(_core_schema.ValidatorFunctionWrapHandler, Protocol[_ModelTypeCo]):
-    """@model_validator decorated function handler argument type. This is used when `mode='wrap'`."""
-
-    def __call__(  # noqa: D102
-        self,
-        value: Any,
-        outer_location: str | int | None = None,
-        /,
-    ) -> _ModelTypeCo:  # pragma: no cover
-        ...
-
-
-class ModelWrapValidatorWithoutInfo(Protocol[_ModelType]):
-    """A @model_validator decorated function signature.
-    This is used when `mode='wrap'` and the function does not have info argument.
-    """
-
-    def __call__(  # noqa: D102
-        self,
-        cls: type[_ModelType],
-        # this can be a dict, a model instance
-        # or anything else that gets passed to validate_python
-        # thus validators _must_ handle all cases
-        value: Any,
-        handler: ModelWrapValidatorHandler[_ModelType],
-        /,
-    ) -> _ModelType:
-        ...
-
-
-class ModelWrapValidator(Protocol[_ModelType]):
-    """A @model_validator decorated function signature. This is used when `mode='wrap'`."""
-
-    def __call__(  # noqa: D102
-        self,
-        cls: type[_ModelType],
-        # this can be a dict, a model instance
-        # or anything else that gets passed to validate_python
-        # thus validators _must_ handle all cases
-        value: Any,
-        handler: ModelWrapValidatorHandler[_ModelType],
-        info: _core_schema.ValidationInfo,
-        /,
-    ) -> _ModelType:
-        ...
-
-
-class FreeModelBeforeValidatorWithoutInfo(Protocol):
-    """A @model_validator decorated function signature.
-    This is used when `mode='before'` and the function does not have info argument.
-    """
-
-    def __call__(  # noqa: D102
-        self,
-        # this can be a dict, a model instance
-        # or anything else that gets passed to validate_python
-        # thus validators _must_ handle all cases
-        value: Any,
-        /,
-    ) -> Any:
-        ...
-
-
-class ModelBeforeValidatorWithoutInfo(Protocol):
-    """A @model_validator decorated function signature.
-    This is used when `mode='before'` and the function does not have info argument.
-    """
-
-    def __call__(  # noqa: D102
-        self,
-        cls: Any,
-        # this can be a dict, a model instance
-        # or anything else that gets passed to validate_python
-        # thus validators _must_ handle all cases
-        value: Any,
-        /,
-    ) -> Any:
-        ...
-
-
-class FreeModelBeforeValidator(Protocol):
-    """A `@model_validator` decorated function signature. This is used when `mode='before'`."""
-
-    def __call__(  # noqa: D102
-        self,
-        # this can be a dict, a model instance
-        # or anything else that gets passed to validate_python
-        # thus validators _must_ handle all cases
-        value: Any,
-        info: _core_schema.ValidationInfo,
-        /,
-    ) -> Any:
-        ...
-
-
-class ModelBeforeValidator(Protocol):
-    """A `@model_validator` decorated function signature. This is used when `mode='before'`."""
-
-    def __call__(  # noqa: D102
-        self,
-        cls: Any,
-        # this can be a dict, a model instance
-        # or anything else that gets passed to validate_python
-        # thus validators _must_ handle all cases
-        value: Any,
-        info: _core_schema.ValidationInfo,
-        /,
-    ) -> Any:
-        ...
-
-
-ModelAfterValidatorWithoutInfo = Callable[[_ModelType], _ModelType]
-"""A `@model_validator` decorated function signature. This is used when `mode='after'` and the function does not
-have info argument.
-"""
-
-ModelAfterValidator = Callable[[_ModelType, _core_schema.ValidationInfo], _ModelType]
-"""A `@model_validator` decorated function signature. This is used when `mode='after'`."""
-
-_AnyModelWrapValidator = Union[ModelWrapValidator[_ModelType], ModelWrapValidatorWithoutInfo[_ModelType]]
-_AnyModeBeforeValidator = Union[
-    FreeModelBeforeValidator, ModelBeforeValidator, FreeModelBeforeValidatorWithoutInfo, ModelBeforeValidatorWithoutInfo
-]
-_AnyModelAfterValidator = Union[ModelAfterValidator[_ModelType], ModelAfterValidatorWithoutInfo[_ModelType]]
-
-
-@overload
-def model_validator(
-    *,
-    mode: Literal['wrap'],
-) -> Callable[
-    [_AnyModelWrapValidator[_ModelType]], _decorators.PydanticDescriptorProxy[_decorators.ModelValidatorDecoratorInfo]
-]:
-    ...
-
-
-@overload
-def model_validator(
-    *,
-    mode: Literal['before'],
-) -> Callable[[_AnyModeBeforeValidator], _decorators.PydanticDescriptorProxy[_decorators.ModelValidatorDecoratorInfo]]:
-    ...
-
-
-@overload
-def model_validator(
-    *,
-    mode: Literal['after'],
-) -> Callable[
-    [_AnyModelAfterValidator[_ModelType]], _decorators.PydanticDescriptorProxy[_decorators.ModelValidatorDecoratorInfo]
-]:
-    ...
-
-
-def model_validator(
-    *,
-    mode: Literal['wrap', 'before', 'after'],
-) -> Any:
-    """Usage docs: https://docs.pydantic.dev/2.6/concepts/validators/#model-validators
-
-    Decorate model methods for validation purposes.
-
-    Example usage:
-    ```py
-    from typing_extensions import Self
-
-    from pydantic import BaseModel, ValidationError, model_validator
-
-    class Square(BaseModel):
-        width: float
-        height: float
-
-        @model_validator(mode='after')
-        def verify_square(self) -> Self:
-            if self.width != self.height:
-                raise ValueError('width and height do not match')
-            return self
-
-    s = Square(width=1, height=1)
-    print(repr(s))
-    #> Square(width=1.0, height=1.0)
-
-    try:
-        Square(width=1, height=2)
-    except ValidationError as e:
-        print(e)
-        '''
-        1 validation error for Square
-          Value error, width and height do not match [type=value_error, input_value={'width': 1, 'height': 2}, input_type=dict]
-        '''
-    ```
-
-    For more in depth examples, see [Model Validators](../concepts/validators.md#model-validators).
-
-    Args:
-        mode: A required string literal that specifies the validation mode.
-            It can be one of the following: 'wrap', 'before', or 'after'.
-
-    Returns:
-        A decorator that can be used to decorate a function to be used as a model validator.
-    """
-
-    def dec(f: Any) -> _decorators.PydanticDescriptorProxy[Any]:
-        # auto apply the @classmethod decorator
-        f = _decorators.ensure_classmethod_based_on_signature(f)
-        dec_info = _decorators.ModelValidatorDecoratorInfo(mode=mode)
-        return _decorators.PydanticDescriptorProxy(f, dec_info)
-
-    return dec
-
-
-AnyType = TypeVar('AnyType')
-
-
-if TYPE_CHECKING:
-    # If we add configurable attributes to IsInstance, we'd probably need to stop hiding it from type checkers like this
-    InstanceOf = Annotated[AnyType, ...]  # `IsInstance[Sequence]` will be recognized by type checkers as `Sequence`
-
-else:
-
-    @dataclasses.dataclass(**_internal_dataclass.slots_true)
-    class InstanceOf:
-        '''Generic type for annotating a type that is an instance of a given class.
-
-        Example:
-            ```py
-            from pydantic import BaseModel, InstanceOf
-
-            class Foo:
-                ...
-
-            class Bar(BaseModel):
-                foo: InstanceOf[Foo]
-
-            Bar(foo=Foo())
-            try:
-                Bar(foo=42)
-            except ValidationError as e:
-                print(e)
-                """
-                [
-                │   {
-                │   │   'type': 'is_instance_of',
-                │   │   'loc': ('foo',),
-                │   │   'msg': 'Input should be an instance of Foo',
-                │   │   'input': 42,
-                │   │   'ctx': {'class': 'Foo'},
-                │   │   'url': 'https://errors.pydantic.dev/0.38.0/v/is_instance_of'
-                │   }
-                ]
-                """
-            ```
-        '''
-
-        @classmethod
-        def __class_getitem__(cls, item: AnyType) -> AnyType:
-            return Annotated[item, cls()]
-
-        @classmethod
-        def __get_pydantic_core_schema__(cls, source: Any, handler: GetCoreSchemaHandler) -> core_schema.CoreSchema:
-            from pydantic import PydanticSchemaGenerationError
-
-            # use the generic _origin_ as the second argument to isinstance when appropriate
-            instance_of_schema = core_schema.is_instance_schema(_generics.get_origin(source) or source)
-
-            try:
-                # Try to generate the "standard" schema, which will be used when loading from JSON
-                original_schema = handler(source)
-            except PydanticSchemaGenerationError:
-                # If that fails, just produce a schema that can validate from python
-                return instance_of_schema
-            else:
-                # Use the "original" approach to serialization
-                instance_of_schema['serialization'] = core_schema.wrap_serializer_function_ser_schema(
-                    function=lambda v, h: h(v), schema=original_schema
-                )
-                return core_schema.json_or_python_schema(python_schema=instance_of_schema, json_schema=original_schema)
-
-        __hash__ = object.__hash__
-
-
-if TYPE_CHECKING:
-    SkipValidation = Annotated[AnyType, ...]  # SkipValidation[list[str]] will be treated by type checkers as list[str]
-else:
-
-    @dataclasses.dataclass(**_internal_dataclass.slots_true)
-    class SkipValidation:
-        """If this is applied as an annotation (e.g., via `x: Annotated[int, SkipValidation]`), validation will be
-            skipped. You can also use `SkipValidation[int]` as a shorthand for `Annotated[int, SkipValidation]`.
-
-        This can be useful if you want to use a type annotation for documentation/IDE/type-checking purposes,
-        and know that it is safe to skip validation for one or more of the fields.
-
-        Because this converts the validation schema to `any_schema`, subsequent annotation-applied transformations
-        may not have the expected effects. Therefore, when used, this annotation should generally be the final
-        annotation applied to a type.
-        """
-
-        def __class_getitem__(cls, item: Any) -> Any:
-            return Annotated[item, SkipValidation()]
-
-        @classmethod
-        def __get_pydantic_core_schema__(cls, source: Any, handler: GetCoreSchemaHandler) -> core_schema.CoreSchema:
-            original_schema = handler(source)
-            metadata = _core_metadata.build_metadata_dict(js_annotation_functions=[lambda _c, h: h(original_schema)])
-            return core_schema.any_schema(
-                metadata=metadata,
-                serialization=core_schema.wrap_serializer_function_ser_schema(
-                    function=lambda v, h: h(v), schema=original_schema
-                ),
-            )
-
-        __hash__ = object.__hash__
diff --git a/lib/pydantic/generics.py b/lib/pydantic/generics.py
index 5f6f7f7a..a3f52bfe 100644
--- a/lib/pydantic/generics.py
+++ b/lib/pydantic/generics.py
@@ -1,4 +1,364 @@
-"""The `generics` module is a backport module from V1."""
-from ._migration import getattr_migration
+import sys
+import typing
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    ClassVar,
+    Dict,
+    Generic,
+    Iterator,
+    List,
+    Mapping,
+    Optional,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+    cast,
+)
 
-__getattr__ = getattr_migration(__name__)
+from typing_extensions import Annotated
+
+from .class_validators import gather_all_validators
+from .fields import DeferredType
+from .main import BaseModel, create_model
+from .types import JsonWrapper
+from .typing import display_as_type, get_all_type_hints, get_args, get_origin, typing_base
+from .utils import LimitedDict, all_identical, lenient_issubclass
+
+GenericModelT = TypeVar('GenericModelT', bound='GenericModel')
+TypeVarType = Any  # since mypy doesn't allow the use of TypeVar as a type
+
+Parametrization = Mapping[TypeVarType, Type[Any]]
+
+_generic_types_cache: LimitedDict[Tuple[Type[Any], Union[Any, Tuple[Any, ...]]], Type[BaseModel]] = LimitedDict()
+# _assigned_parameters is a Mapping from parametrized version of generic models to assigned types of parametrizations
+# as captured during construction of the class (not instances).
+# E.g., for generic model `Model[A, B]`, when parametrized model `Model[int, str]` is created,
+# `Model[int, str]`: {A: int, B: str}` will be stored in `_assigned_parameters`.
+# (This information is only otherwise available after creation from the class name string).
+_assigned_parameters: LimitedDict[Type[Any], Parametrization] = LimitedDict()
+
+
+class GenericModel(BaseModel):
+    __slots__ = ()
+    __concrete__: ClassVar[bool] = False
+
+    if TYPE_CHECKING:
+        # Putting this in a TYPE_CHECKING block allows us to replace `if Generic not in cls.__bases__` with
+        # `not hasattr(cls, "__parameters__")`. This means we don't need to force non-concrete subclasses of
+        # `GenericModel` to also inherit from `Generic`, which would require changes to the use of `create_model` below.
+        __parameters__: ClassVar[Tuple[TypeVarType, ...]]
+
+    # Setting the return type as Type[Any] instead of Type[BaseModel] prevents PyCharm warnings
+    def __class_getitem__(cls: Type[GenericModelT], params: Union[Type[Any], Tuple[Type[Any], ...]]) -> Type[Any]:
+        """Instantiates a new class from a generic class `cls` and type variables `params`.
+
+        :param params: Tuple of types the class . Given a generic class
+            `Model` with 2 type variables and a concrete model `Model[str, int]`,
+            the value `(str, int)` would be passed to `params`.
+        :return: New model class inheriting from `cls` with instantiated
+            types described by `params`. If no parameters are given, `cls` is
+            returned as is.
+
+        """
+
+        def _cache_key(_params: Any) -> Tuple[Type[GenericModelT], Any, Tuple[Any, ...]]:
+            return cls, _params, get_args(_params)
+
+        cached = _generic_types_cache.get(_cache_key(params))
+        if cached is not None:
+            return cached
+        if cls.__concrete__ and Generic not in cls.__bases__:
+            raise TypeError('Cannot parameterize a concrete instantiation of a generic model')
+        if not isinstance(params, tuple):
+            params = (params,)
+        if cls is GenericModel and any(isinstance(param, TypeVar) for param in params):
+            raise TypeError('Type parameters should be placed on typing.Generic, not GenericModel')
+        if not hasattr(cls, '__parameters__'):
+            raise TypeError(f'Type {cls.__name__} must inherit from typing.Generic before being parameterized')
+
+        check_parameters_count(cls, params)
+        # Build map from generic typevars to passed params
+        typevars_map: Dict[TypeVarType, Type[Any]] = dict(zip(cls.__parameters__, params))
+        if all_identical(typevars_map.keys(), typevars_map.values()) and typevars_map:
+            return cls  # if arguments are equal to parameters it's the same object
+
+        # Create new model with original model as parent inserting fields with DeferredType.
+        model_name = cls.__concrete_name__(params)
+        validators = gather_all_validators(cls)
+
+        type_hints = get_all_type_hints(cls).items()
+        instance_type_hints = {k: v for k, v in type_hints if get_origin(v) is not ClassVar}
+
+        fields = {k: (DeferredType(), cls.__fields__[k].field_info) for k in instance_type_hints if k in cls.__fields__}
+
+        model_module, called_globally = get_caller_frame_info()
+        created_model = cast(
+            Type[GenericModel],  # casting ensures mypy is aware of the __concrete__ and __parameters__ attributes
+            create_model(
+                model_name,
+                __module__=model_module or cls.__module__,
+                __base__=(cls,) + tuple(cls.__parameterized_bases__(typevars_map)),
+                __config__=None,
+                __validators__=validators,
+                __cls_kwargs__=None,
+                **fields,
+            ),
+        )
+
+        _assigned_parameters[created_model] = typevars_map
+
+        if called_globally:  # create global reference and therefore allow pickling
+            object_by_reference = None
+            reference_name = model_name
+            reference_module_globals = sys.modules[created_model.__module__].__dict__
+            while object_by_reference is not created_model:
+                object_by_reference = reference_module_globals.setdefault(reference_name, created_model)
+                reference_name += '_'
+
+        created_model.Config = cls.Config
+
+        # Find any typevars that are still present in the model.
+        # If none are left, the model is fully "concrete", otherwise the new
+        # class is a generic class as well taking the found typevars as
+        # parameters.
+        new_params = tuple(
+            {param: None for param in iter_contained_typevars(typevars_map.values())}
+        )  # use dict as ordered set
+        created_model.__concrete__ = not new_params
+        if new_params:
+            created_model.__parameters__ = new_params
+
+        # Save created model in cache so we don't end up creating duplicate
+        # models that should be identical.
+        _generic_types_cache[_cache_key(params)] = created_model
+        if len(params) == 1:
+            _generic_types_cache[_cache_key(params[0])] = created_model
+
+        # Recursively walk class type hints and replace generic typevars
+        # with concrete types that were passed.
+        _prepare_model_fields(created_model, fields, instance_type_hints, typevars_map)
+
+        return created_model
+
+    @classmethod
+    def __concrete_name__(cls: Type[Any], params: Tuple[Type[Any], ...]) -> str:
+        """Compute class name for child classes.
+
+        :param params: Tuple of types the class . Given a generic class
+            `Model` with 2 type variables and a concrete model `Model[str, int]`,
+            the value `(str, int)` would be passed to `params`.
+        :return: String representing a the new class where `params` are
+            passed to `cls` as type variables.
+
+        This method can be overridden to achieve a custom naming scheme for GenericModels.
+        """
+        param_names = [display_as_type(param) for param in params]
+        params_component = ', '.join(param_names)
+        return f'{cls.__name__}[{params_component}]'
+
+    @classmethod
+    def __parameterized_bases__(cls, typevars_map: Parametrization) -> Iterator[Type[Any]]:
+        """
+        Returns unbound bases of cls parameterised to given type variables
+
+        :param typevars_map: Dictionary of type applications for binding subclasses.
+            Given a generic class `Model` with 2 type variables [S, T]
+            and a concrete model `Model[str, int]`,
+            the value `{S: str, T: int}` would be passed to `typevars_map`.
+        :return: an iterator of generic sub classes, parameterised by `typevars_map`
+            and other assigned parameters of `cls`
+
+        e.g.:
+        ```
+        class A(GenericModel, Generic[T]):
+            ...
+
+        class B(A[V], Generic[V]):
+            ...
+
+        assert A[int] in B.__parameterized_bases__({V: int})
+        ```
+        """
+
+        def build_base_model(
+            base_model: Type[GenericModel], mapped_types: Parametrization
+        ) -> Iterator[Type[GenericModel]]:
+            base_parameters = tuple(mapped_types[param] for param in base_model.__parameters__)
+            parameterized_base = base_model.__class_getitem__(base_parameters)
+            if parameterized_base is base_model or parameterized_base is cls:
+                # Avoid duplication in MRO
+                return
+            yield parameterized_base
+
+        for base_model in cls.__bases__:
+            if not issubclass(base_model, GenericModel):
+                # not a class that can be meaningfully parameterized
+                continue
+            elif not getattr(base_model, '__parameters__', None):
+                # base_model is "GenericModel"  (and has no __parameters__)
+                # or
+                # base_model is already concrete, and will be included transitively via cls.
+                continue
+            elif cls in _assigned_parameters:
+                if base_model in _assigned_parameters:
+                    # cls is partially parameterised but not from base_model
+                    # e.g. cls = B[S], base_model = A[S]
+                    # B[S][int] should subclass A[int],  (and will be transitively via B[int])
+                    # but it's not viable to consistently subclass types with arbitrary construction
+                    # So don't attempt to include A[S][int]
+                    continue
+                else:  # base_model not in _assigned_parameters:
+                    # cls is partially parameterized, base_model is original generic
+                    # e.g.  cls = B[str, T], base_model = B[S, T]
+                    # Need to determine the mapping for the base_model parameters
+                    mapped_types: Parametrization = {
+                        key: typevars_map.get(value, value) for key, value in _assigned_parameters[cls].items()
+                    }
+                    yield from build_base_model(base_model, mapped_types)
+            else:
+                # cls is base generic, so base_class has a distinct base
+                # can construct the Parameterised base model using typevars_map directly
+                yield from build_base_model(base_model, typevars_map)
+
+
+def replace_types(type_: Any, type_map: Mapping[Any, Any]) -> Any:
+    """Return type with all occurrences of `type_map` keys recursively replaced with their values.
+
+    :param type_: Any type, class or generic alias
+    :param type_map: Mapping from `TypeVar` instance to concrete types.
+    :return: New type representing the basic structure of `type_` with all
+        `typevar_map` keys recursively replaced.
+
+    >>> replace_types(Tuple[str, Union[List[str], float]], {str: int})
+    Tuple[int, Union[List[int], float]]
+
+    """
+    if not type_map:
+        return type_
+
+    type_args = get_args(type_)
+    origin_type = get_origin(type_)
+
+    if origin_type is Annotated:
+        annotated_type, *annotations = type_args
+        return Annotated[replace_types(annotated_type, type_map), tuple(annotations)]
+
+    # Having type args is a good indicator that this is a typing module
+    # class instantiation or a generic alias of some sort.
+    if type_args:
+        resolved_type_args = tuple(replace_types(arg, type_map) for arg in type_args)
+        if all_identical(type_args, resolved_type_args):
+            # If all arguments are the same, there is no need to modify the
+            # type or create a new object at all
+            return type_
+        if (
+            origin_type is not None
+            and isinstance(type_, typing_base)
+            and not isinstance(origin_type, typing_base)
+            and getattr(type_, '_name', None) is not None
+        ):
+            # In python < 3.9 generic aliases don't exist so any of these like `list`,
+            # `type` or `collections.abc.Callable` need to be translated.
+            # See: https://www.python.org/dev/peps/pep-0585
+            origin_type = getattr(typing, type_._name)
+        assert origin_type is not None
+        return origin_type[resolved_type_args]
+
+    # We handle pydantic generic models separately as they don't have the same
+    # semantics as "typing" classes or generic aliases
+    if not origin_type and lenient_issubclass(type_, GenericModel) and not type_.__concrete__:
+        type_args = type_.__parameters__
+        resolved_type_args = tuple(replace_types(t, type_map) for t in type_args)
+        if all_identical(type_args, resolved_type_args):
+            return type_
+        return type_[resolved_type_args]
+
+    # Handle special case for typehints that can have lists as arguments.
+    # `typing.Callable[[int, str], int]` is an example for this.
+    if isinstance(type_, (List, list)):
+        resolved_list = list(replace_types(element, type_map) for element in type_)
+        if all_identical(type_, resolved_list):
+            return type_
+        return resolved_list
+
+    # For JsonWrapperValue, need to handle its inner type to allow correct parsing
+    # of generic Json arguments like Json[T]
+    if not origin_type and lenient_issubclass(type_, JsonWrapper):
+        type_.inner_type = replace_types(type_.inner_type, type_map)
+        return type_
+
+    # If all else fails, we try to resolve the type directly and otherwise just
+    # return the input with no modifications.
+    return type_map.get(type_, type_)
+
+
+def check_parameters_count(cls: Type[GenericModel], parameters: Tuple[Any, ...]) -> None:
+    actual = len(parameters)
+    expected = len(cls.__parameters__)
+    if actual != expected:
+        description = 'many' if actual > expected else 'few'
+        raise TypeError(f'Too {description} parameters for {cls.__name__}; actual {actual}, expected {expected}')
+
+
+DictValues: Type[Any] = {}.values().__class__
+
+
+def iter_contained_typevars(v: Any) -> Iterator[TypeVarType]:
+    """Recursively iterate through all subtypes and type args of `v` and yield any typevars that are found."""
+    if isinstance(v, TypeVar):
+        yield v
+    elif hasattr(v, '__parameters__') and not get_origin(v) and lenient_issubclass(v, GenericModel):
+        yield from v.__parameters__
+    elif isinstance(v, (DictValues, list)):
+        for var in v:
+            yield from iter_contained_typevars(var)
+    else:
+        args = get_args(v)
+        for arg in args:
+            yield from iter_contained_typevars(arg)
+
+
+def get_caller_frame_info() -> Tuple[Optional[str], bool]:
+    """
+    Used inside a function to check whether it was called globally
+
+    Will only work against non-compiled code, therefore used only in pydantic.generics
+
+    :returns Tuple[module_name, called_globally]
+    """
+    try:
+        previous_caller_frame = sys._getframe(2)
+    except ValueError as e:
+        raise RuntimeError('This function must be used inside another function') from e
+    except AttributeError:  # sys module does not have _getframe function, so there's nothing we can do about it
+        return None, False
+    frame_globals = previous_caller_frame.f_globals
+    return frame_globals.get('__name__'), previous_caller_frame.f_locals is frame_globals
+
+
+def _prepare_model_fields(
+    created_model: Type[GenericModel],
+    fields: Mapping[str, Any],
+    instance_type_hints: Mapping[str, type],
+    typevars_map: Mapping[Any, type],
+) -> None:
+    """
+    Replace DeferredType fields with concrete type hints and prepare them.
+    """
+
+    for key, field in created_model.__fields__.items():
+        if key not in fields:
+            assert field.type_.__class__ is not DeferredType
+            # https://github.com/nedbat/coveragepy/issues/198
+            continue  # pragma: no cover
+
+        assert field.type_.__class__ is DeferredType, field.type_.__class__
+
+        field_type_hint = instance_type_hints[key]
+        concrete_type = replace_types(field_type_hint, typevars_map)
+        field.type_ = concrete_type
+        field.outer_type_ = concrete_type
+        field.prepare()
+        created_model.__annotations__[key] = concrete_type
diff --git a/lib/pydantic/json.py b/lib/pydantic/json.py
index 020fb6d2..b358b850 100644
--- a/lib/pydantic/json.py
+++ b/lib/pydantic/json.py
@@ -1,4 +1,112 @@
-"""The `json` module is a backport module from V1."""
-from ._migration import getattr_migration
+import datetime
+from collections import deque
+from decimal import Decimal
+from enum import Enum
+from ipaddress import IPv4Address, IPv4Interface, IPv4Network, IPv6Address, IPv6Interface, IPv6Network
+from pathlib import Path
+from re import Pattern
+from types import GeneratorType
+from typing import Any, Callable, Dict, Type, Union
+from uuid import UUID
 
-__getattr__ = getattr_migration(__name__)
+from .color import Color
+from .networks import NameEmail
+from .types import SecretBytes, SecretStr
+
+__all__ = 'pydantic_encoder', 'custom_pydantic_encoder', 'timedelta_isoformat'
+
+
+def isoformat(o: Union[datetime.date, datetime.time]) -> str:
+    return o.isoformat()
+
+
+def decimal_encoder(dec_value: Decimal) -> Union[int, float]:
+    """
+    Encodes a Decimal as int of there's no exponent, otherwise float
+
+    This is useful when we use ConstrainedDecimal to represent Numeric(x,0)
+    where a integer (but not int typed) is used. Encoding this as a float
+    results in failed round-tripping between encode and parse.
+    Our Id type is a prime example of this.
+
+    >>> decimal_encoder(Decimal("1.0"))
+    1.0
+
+    >>> decimal_encoder(Decimal("1"))
+    1
+    """
+    if dec_value.as_tuple().exponent >= 0:
+        return int(dec_value)
+    else:
+        return float(dec_value)
+
+
+ENCODERS_BY_TYPE: Dict[Type[Any], Callable[[Any], Any]] = {
+    bytes: lambda o: o.decode(),
+    Color: str,
+    datetime.date: isoformat,
+    datetime.datetime: isoformat,
+    datetime.time: isoformat,
+    datetime.timedelta: lambda td: td.total_seconds(),
+    Decimal: decimal_encoder,
+    Enum: lambda o: o.value,
+    frozenset: list,
+    deque: list,
+    GeneratorType: list,
+    IPv4Address: str,
+    IPv4Interface: str,
+    IPv4Network: str,
+    IPv6Address: str,
+    IPv6Interface: str,
+    IPv6Network: str,
+    NameEmail: str,
+    Path: str,
+    Pattern: lambda o: o.pattern,
+    SecretBytes: str,
+    SecretStr: str,
+    set: list,
+    UUID: str,
+}
+
+
+def pydantic_encoder(obj: Any) -> Any:
+    from dataclasses import asdict, is_dataclass
+
+    from .main import BaseModel
+
+    if isinstance(obj, BaseModel):
+        return obj.dict()
+    elif is_dataclass(obj):
+        return asdict(obj)
+
+    # Check the class type and its superclasses for a matching encoder
+    for base in obj.__class__.__mro__[:-1]:
+        try:
+            encoder = ENCODERS_BY_TYPE[base]
+        except KeyError:
+            continue
+        return encoder(obj)
+    else:  # We have exited the for loop without finding a suitable encoder
+        raise TypeError(f"Object of type '{obj.__class__.__name__}' is not JSON serializable")
+
+
+def custom_pydantic_encoder(type_encoders: Dict[Any, Callable[[Type[Any]], Any]], obj: Any) -> Any:
+    # Check the class type and its superclasses for a matching encoder
+    for base in obj.__class__.__mro__[:-1]:
+        try:
+            encoder = type_encoders[base]
+        except KeyError:
+            continue
+
+        return encoder(obj)
+    else:  # We have exited the for loop without finding a suitable encoder
+        return pydantic_encoder(obj)
+
+
+def timedelta_isoformat(td: datetime.timedelta) -> str:
+    """
+    ISO 8601 encoding for Python timedelta object.
+    """
+    minutes, seconds = divmod(td.seconds, 60)
+    hours, minutes = divmod(minutes, 60)
+    return f'{"-" if td.days < 0 else ""}P{abs(td.days)}DT{hours:d}H{minutes:d}M{seconds:d}.{td.microseconds:06d}S'
diff --git a/lib/pydantic/json_schema.py b/lib/pydantic/json_schema.py
deleted file mode 100644
index eee9e60e..00000000
--- a/lib/pydantic/json_schema.py
+++ /dev/null
@@ -1,2425 +0,0 @@
-"""
-Usage docs: https://docs.pydantic.dev/2.5/concepts/json_schema/
-
-The `json_schema` module contains classes and functions to allow the way [JSON Schema](https://json-schema.org/)
-is generated to be customized.
-
-In general you shouldn't need to use this module directly; instead, you can
-[`BaseModel.model_json_schema`][pydantic.BaseModel.model_json_schema] and
-[`TypeAdapter.json_schema`][pydantic.TypeAdapter.json_schema].
-"""
-from __future__ import annotations as _annotations
-
-import dataclasses
-import inspect
-import math
-import re
-import warnings
-from collections import defaultdict
-from copy import deepcopy
-from dataclasses import is_dataclass
-from enum import Enum
-from typing import (
-    TYPE_CHECKING,
-    Any,
-    Callable,
-    Counter,
-    Dict,
-    Hashable,
-    Iterable,
-    NewType,
-    Sequence,
-    Tuple,
-    TypeVar,
-    Union,
-    cast,
-)
-
-import pydantic_core
-from pydantic_core import CoreSchema, PydanticOmit, core_schema, to_jsonable_python
-from pydantic_core.core_schema import ComputedField
-from typing_extensions import Annotated, Literal, TypeAlias, assert_never, deprecated, final
-
-from pydantic.warnings import PydanticDeprecatedSince26
-
-from ._internal import (
-    _config,
-    _core_metadata,
-    _core_utils,
-    _decorators,
-    _internal_dataclass,
-    _mock_val_ser,
-    _schema_generation_shared,
-    _typing_extra,
-)
-from .annotated_handlers import GetJsonSchemaHandler
-from .config import JsonDict, JsonSchemaExtraCallable, JsonValue
-from .errors import PydanticInvalidForJsonSchema, PydanticUserError
-
-if TYPE_CHECKING:
-    from . import ConfigDict
-    from ._internal._core_utils import CoreSchemaField, CoreSchemaOrField
-    from ._internal._dataclasses import PydanticDataclass
-    from ._internal._schema_generation_shared import GetJsonSchemaFunction
-    from .main import BaseModel
-
-
-CoreSchemaOrFieldType = Literal[core_schema.CoreSchemaType, core_schema.CoreSchemaFieldType]
-"""
-A type alias for defined schema types that represents a union of
-`core_schema.CoreSchemaType` and
-`core_schema.CoreSchemaFieldType`.
-"""
-
-JsonSchemaValue = Dict[str, Any]
-"""
-A type alias for a JSON schema value. This is a dictionary of string keys to arbitrary JSON values.
-"""
-
-JsonSchemaMode = Literal['validation', 'serialization']
-"""
-A type alias that represents the mode of a JSON schema; either 'validation' or 'serialization'.
-
-For some types, the inputs to validation differ from the outputs of serialization. For example,
-computed fields will only be present when serializing, and should not be provided when
-validating. This flag provides a way to indicate whether you want the JSON schema required
-for validation inputs, or that will be matched by serialization outputs.
-"""
-
-_MODE_TITLE_MAPPING: dict[JsonSchemaMode, str] = {'validation': 'Input', 'serialization': 'Output'}
-
-
-def update_json_schema(schema: JsonSchemaValue, updates: dict[str, Any]) -> JsonSchemaValue:
-    """Update a JSON schema in-place by providing a dictionary of updates.
-
-    This function sets the provided key-value pairs in the schema and returns the updated schema.
-
-    Args:
-        schema: The JSON schema to update.
-        updates: A dictionary of key-value pairs to set in the schema.
-
-    Returns:
-        The updated JSON schema.
-    """
-    schema.update(updates)
-    return schema
-
-
-JsonSchemaWarningKind = Literal['skipped-choice', 'non-serializable-default']
-"""
-A type alias representing the kinds of warnings that can be emitted during JSON schema generation.
-
-See [`GenerateJsonSchema.render_warning_message`][pydantic.json_schema.GenerateJsonSchema.render_warning_message]
-for more details.
-"""
-
-
-class PydanticJsonSchemaWarning(UserWarning):
-    """This class is used to emit warnings produced during JSON schema generation.
-    See the [`GenerateJsonSchema.emit_warning`][pydantic.json_schema.GenerateJsonSchema.emit_warning] and
-    [`GenerateJsonSchema.render_warning_message`][pydantic.json_schema.GenerateJsonSchema.render_warning_message]
-    methods for more details; these can be overridden to control warning behavior.
-    """
-
-
-# ##### JSON Schema Generation #####
-DEFAULT_REF_TEMPLATE = '#/$defs/{model}'
-"""The default format string used to generate reference names."""
-
-# There are three types of references relevant to building JSON schemas:
-#   1. core_schema "ref" values; these are not exposed as part of the JSON schema
-#       * these might look like the fully qualified path of a model, its id, or something similar
-CoreRef = NewType('CoreRef', str)
-#   2. keys of the "definitions" object that will eventually go into the JSON schema
-#       * by default, these look like "MyModel", though may change in the presence of collisions
-#       * eventually, we may want to make it easier to modify the way these names are generated
-DefsRef = NewType('DefsRef', str)
-#   3. the values corresponding to the "$ref" key in the schema
-#       * By default, these look like "#/$defs/MyModel", as in {"$ref": "#/$defs/MyModel"}
-JsonRef = NewType('JsonRef', str)
-
-CoreModeRef = Tuple[CoreRef, JsonSchemaMode]
-JsonSchemaKeyT = TypeVar('JsonSchemaKeyT', bound=Hashable)
-
-
-@dataclasses.dataclass(**_internal_dataclass.slots_true)
-class _DefinitionsRemapping:
-    defs_remapping: dict[DefsRef, DefsRef]
-    json_remapping: dict[JsonRef, JsonRef]
-
-    @staticmethod
-    def from_prioritized_choices(
-        prioritized_choices: dict[DefsRef, list[DefsRef]],
-        defs_to_json: dict[DefsRef, JsonRef],
-        definitions: dict[DefsRef, JsonSchemaValue],
-    ) -> _DefinitionsRemapping:
-        """
-        This function should produce a remapping that replaces complex DefsRef with the simpler ones from the
-        prioritized_choices such that applying the name remapping would result in an equivalent JSON schema.
-        """
-        # We need to iteratively simplify the definitions until we reach a fixed point.
-        # The reason for this is that outer definitions may reference inner definitions that get simplified
-        # into an equivalent reference, and the outer definitions won't be equivalent until we've simplified
-        # the inner definitions.
-        copied_definitions = deepcopy(definitions)
-        definitions_schema = {'$defs': copied_definitions}
-        for _iter in range(100):  # prevent an infinite loop in the case of a bug, 100 iterations should be enough
-            # For every possible remapped DefsRef, collect all schemas that that DefsRef might be used for:
-            schemas_for_alternatives: dict[DefsRef, list[JsonSchemaValue]] = defaultdict(list)
-            for defs_ref in copied_definitions:
-                alternatives = prioritized_choices[defs_ref]
-                for alternative in alternatives:
-                    schemas_for_alternatives[alternative].append(copied_definitions[defs_ref])
-
-            # Deduplicate the schemas for each alternative; the idea is that we only want to remap to a new DefsRef
-            # if it introduces no ambiguity, i.e., there is only one distinct schema for that DefsRef.
-            for defs_ref, schemas in schemas_for_alternatives.items():
-                schemas_for_alternatives[defs_ref] = _deduplicate_schemas(schemas_for_alternatives[defs_ref])
-
-            # Build the remapping
-            defs_remapping: dict[DefsRef, DefsRef] = {}
-            json_remapping: dict[JsonRef, JsonRef] = {}
-            for original_defs_ref in definitions:
-                alternatives = prioritized_choices[original_defs_ref]
-                # Pick the first alternative that has only one schema, since that means there is no collision
-                remapped_defs_ref = next(x for x in alternatives if len(schemas_for_alternatives[x]) == 1)
-                defs_remapping[original_defs_ref] = remapped_defs_ref
-                json_remapping[defs_to_json[original_defs_ref]] = defs_to_json[remapped_defs_ref]
-            remapping = _DefinitionsRemapping(defs_remapping, json_remapping)
-            new_definitions_schema = remapping.remap_json_schema({'$defs': copied_definitions})
-            if definitions_schema == new_definitions_schema:
-                # We've reached the fixed point
-                return remapping
-            definitions_schema = new_definitions_schema
-
-        raise PydanticInvalidForJsonSchema('Failed to simplify the JSON schema definitions')
-
-    def remap_defs_ref(self, ref: DefsRef) -> DefsRef:
-        return self.defs_remapping.get(ref, ref)
-
-    def remap_json_ref(self, ref: JsonRef) -> JsonRef:
-        return self.json_remapping.get(ref, ref)
-
-    def remap_json_schema(self, schema: Any) -> Any:
-        """
-        Recursively update the JSON schema replacing all $refs
-        """
-        if isinstance(schema, str):
-            # Note: this may not really be a JsonRef; we rely on having no collisions between JsonRefs and other strings
-            return self.remap_json_ref(JsonRef(schema))
-        elif isinstance(schema, list):
-            return [self.remap_json_schema(item) for item in schema]
-        elif isinstance(schema, dict):
-            for key, value in schema.items():
-                if key == '$ref' and isinstance(value, str):
-                    schema['$ref'] = self.remap_json_ref(JsonRef(value))
-                elif key == '$defs':
-                    schema['$defs'] = {
-                        self.remap_defs_ref(DefsRef(key)): self.remap_json_schema(value)
-                        for key, value in schema['$defs'].items()
-                    }
-                else:
-                    schema[key] = self.remap_json_schema(value)
-        return schema
-
-
-class GenerateJsonSchema:
-    """Usage docs: https://docs.pydantic.dev/2.6/concepts/json_schema/#customizing-the-json-schema-generation-process
-
-    A class for generating JSON schemas.
-
-    This class generates JSON schemas based on configured parameters. The default schema dialect
-    is [https://json-schema.org/draft/2020-12/schema](https://json-schema.org/draft/2020-12/schema).
-    The class uses `by_alias` to configure how fields with
-    multiple names are handled and `ref_template` to format reference names.
-
-    Attributes:
-        schema_dialect: The JSON schema dialect used to generate the schema. See
-            [Declaring a Dialect](https://json-schema.org/understanding-json-schema/reference/schema.html#id4)
-            in the JSON Schema documentation for more information about dialects.
-        ignored_warning_kinds: Warnings to ignore when generating the schema. `self.render_warning_message` will
-            do nothing if its argument `kind` is in `ignored_warning_kinds`;
-            this value can be modified on subclasses to easily control which warnings are emitted.
-        by_alias: Whether to use field aliases when generating the schema.
-        ref_template: The format string used when generating reference names.
-        core_to_json_refs: A mapping of core refs to JSON refs.
-        core_to_defs_refs: A mapping of core refs to definition refs.
-        defs_to_core_refs: A mapping of definition refs to core refs.
-        json_to_defs_refs: A mapping of JSON refs to definition refs.
-        definitions: Definitions in the schema.
-
-    Args:
-        by_alias: Whether to use field aliases in the generated schemas.
-        ref_template: The format string to use when generating reference names.
-
-    Raises:
-        JsonSchemaError: If the instance of the class is inadvertently re-used after generating a schema.
-    """
-
-    schema_dialect = 'https://json-schema.org/draft/2020-12/schema'
-
-    # `self.render_warning_message` will do nothing if its argument `kind` is in `ignored_warning_kinds`;
-    # this value can be modified on subclasses to easily control which warnings are emitted
-    ignored_warning_kinds: set[JsonSchemaWarningKind] = {'skipped-choice'}
-
-    def __init__(self, by_alias: bool = True, ref_template: str = DEFAULT_REF_TEMPLATE):
-        self.by_alias = by_alias
-        self.ref_template = ref_template
-
-        self.core_to_json_refs: dict[CoreModeRef, JsonRef] = {}
-        self.core_to_defs_refs: dict[CoreModeRef, DefsRef] = {}
-        self.defs_to_core_refs: dict[DefsRef, CoreModeRef] = {}
-        self.json_to_defs_refs: dict[JsonRef, DefsRef] = {}
-
-        self.definitions: dict[DefsRef, JsonSchemaValue] = {}
-        self._config_wrapper_stack = _config.ConfigWrapperStack(_config.ConfigWrapper({}))
-
-        self._mode: JsonSchemaMode = 'validation'
-
-        # The following includes a mapping of a fully-unique defs ref choice to a list of preferred
-        # alternatives, which are generally simpler, such as only including the class name.
-        # At the end of schema generation, we use these to produce a JSON schema with more human-readable
-        # definitions, which would also work better in a generated OpenAPI client, etc.
-        self._prioritized_defsref_choices: dict[DefsRef, list[DefsRef]] = {}
-        self._collision_counter: dict[str, int] = defaultdict(int)
-        self._collision_index: dict[str, int] = {}
-
-        self._schema_type_to_method = self.build_schema_type_to_method()
-
-        # When we encounter definitions we need to try to build them immediately
-        # so that they are available schemas that reference them
-        # But it's possible that CoreSchema was never going to be used
-        # (e.g. because the CoreSchema that references short circuits is JSON schema generation without needing
-        #  the reference) so instead of failing altogether if we can't build a definition we
-        # store the error raised and re-throw it if we end up needing that def
-        self._core_defs_invalid_for_json_schema: dict[DefsRef, PydanticInvalidForJsonSchema] = {}
-
-        # This changes to True after generating a schema, to prevent issues caused by accidental re-use
-        # of a single instance of a schema generator
-        self._used = False
-
-    @property
-    def _config(self) -> _config.ConfigWrapper:
-        return self._config_wrapper_stack.tail
-
-    @property
-    def mode(self) -> JsonSchemaMode:
-        if self._config.json_schema_mode_override is not None:
-            return self._config.json_schema_mode_override
-        else:
-            return self._mode
-
-    def build_schema_type_to_method(
-        self,
-    ) -> dict[CoreSchemaOrFieldType, Callable[[CoreSchemaOrField], JsonSchemaValue]]:
-        """Builds a dictionary mapping fields to methods for generating JSON schemas.
-
-        Returns:
-            A dictionary containing the mapping of `CoreSchemaOrFieldType` to a handler method.
-
-        Raises:
-            TypeError: If no method has been defined for generating a JSON schema for a given pydantic core schema type.
-        """
-        mapping: dict[CoreSchemaOrFieldType, Callable[[CoreSchemaOrField], JsonSchemaValue]] = {}
-        core_schema_types: list[CoreSchemaOrFieldType] = _typing_extra.all_literal_values(
-            CoreSchemaOrFieldType  # type: ignore
-        )
-        for key in core_schema_types:
-            method_name = f"{key.replace('-', '_')}_schema"
-            try:
-                mapping[key] = getattr(self, method_name)
-            except AttributeError as e:  # pragma: no cover
-                raise TypeError(
-                    f'No method for generating JsonSchema for core_schema.type={key!r} '
-                    f'(expected: {type(self).__name__}.{method_name})'
-                ) from e
-        return mapping
-
-    def generate_definitions(
-        self, inputs: Sequence[tuple[JsonSchemaKeyT, JsonSchemaMode, core_schema.CoreSchema]]
-    ) -> tuple[dict[tuple[JsonSchemaKeyT, JsonSchemaMode], JsonSchemaValue], dict[DefsRef, JsonSchemaValue]]:
-        """Generates JSON schema definitions from a list of core schemas, pairing the generated definitions with a
-        mapping that links the input keys to the definition references.
-
-        Args:
-            inputs: A sequence of tuples, where:
-
-                - The first element is a JSON schema key type.
-                - The second element is the JSON mode: either 'validation' or 'serialization'.
-                - The third element is a core schema.
-
-        Returns:
-            A tuple where:
-
-                - The first element is a dictionary whose keys are tuples of JSON schema key type and JSON mode, and
-                    whose values are the JSON schema corresponding to that pair of inputs. (These schemas may have
-                    JsonRef references to definitions that are defined in the second returned element.)
-                - The second element is a dictionary whose keys are definition references for the JSON schemas
-                    from the first returned element, and whose values are the actual JSON schema definitions.
-
-        Raises:
-            PydanticUserError: Raised if the JSON schema generator has already been used to generate a JSON schema.
-        """
-        if self._used:
-            raise PydanticUserError(
-                'This JSON schema generator has already been used to generate a JSON schema. '
-                f'You must create a new instance of {type(self).__name__} to generate a new JSON schema.',
-                code='json-schema-already-used',
-            )
-
-        for key, mode, schema in inputs:
-            self._mode = mode
-            self.generate_inner(schema)
-
-        definitions_remapping = self._build_definitions_remapping()
-
-        json_schemas_map: dict[tuple[JsonSchemaKeyT, JsonSchemaMode], DefsRef] = {}
-        for key, mode, schema in inputs:
-            self._mode = mode
-            json_schema = self.generate_inner(schema)
-            json_schemas_map[(key, mode)] = definitions_remapping.remap_json_schema(json_schema)
-
-        json_schema = {'$defs': self.definitions}
-        json_schema = definitions_remapping.remap_json_schema(json_schema)
-        self._used = True
-        return json_schemas_map, _sort_json_schema(json_schema['$defs'])  # type: ignore
-
-    def generate(self, schema: CoreSchema, mode: JsonSchemaMode = 'validation') -> JsonSchemaValue:
-        """Generates a JSON schema for a specified schema in a specified mode.
-
-        Args:
-            schema: A Pydantic model.
-            mode: The mode in which to generate the schema. Defaults to 'validation'.
-
-        Returns:
-            A JSON schema representing the specified schema.
-
-        Raises:
-            PydanticUserError: If the JSON schema generator has already been used to generate a JSON schema.
-        """
-        self._mode = mode
-        if self._used:
-            raise PydanticUserError(
-                'This JSON schema generator has already been used to generate a JSON schema. '
-                f'You must create a new instance of {type(self).__name__} to generate a new JSON schema.',
-                code='json-schema-already-used',
-            )
-
-        json_schema: JsonSchemaValue = self.generate_inner(schema)
-        json_ref_counts = self.get_json_ref_counts(json_schema)
-
-        # Remove the top-level $ref if present; note that the _generate method already ensures there are no sibling keys
-        ref = cast(JsonRef, json_schema.get('$ref'))
-        while ref is not None:  # may need to unpack multiple levels
-            ref_json_schema = self.get_schema_from_definitions(ref)
-            if json_ref_counts[ref] > 1 or ref_json_schema is None:
-                # Keep the ref, but use an allOf to remove the top level $ref
-                json_schema = {'allOf': [{'$ref': ref}]}
-            else:
-                # "Unpack" the ref since this is the only reference
-                json_schema = ref_json_schema.copy()  # copy to prevent recursive dict reference
-                json_ref_counts[ref] -= 1
-            ref = cast(JsonRef, json_schema.get('$ref'))
-
-        self._garbage_collect_definitions(json_schema)
-        definitions_remapping = self._build_definitions_remapping()
-
-        if self.definitions:
-            json_schema['$defs'] = self.definitions
-
-        json_schema = definitions_remapping.remap_json_schema(json_schema)
-
-        # For now, we will not set the $schema key. However, if desired, this can be easily added by overriding
-        # this method and adding the following line after a call to super().generate(schema):
-        # json_schema['$schema'] = self.schema_dialect
-
-        self._used = True
-        return _sort_json_schema(json_schema)
-
-    def generate_inner(self, schema: CoreSchemaOrField) -> JsonSchemaValue:  # noqa: C901
-        """Generates a JSON schema for a given core schema.
-
-        Args:
-            schema: The given core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        # If a schema with the same CoreRef has been handled, just return a reference to it
-        # Note that this assumes that it will _never_ be the case that the same CoreRef is used
-        # on types that should have different JSON schemas
-        if 'ref' in schema:
-            core_ref = CoreRef(schema['ref'])  # type: ignore[typeddict-item]
-            core_mode_ref = (core_ref, self.mode)
-            if core_mode_ref in self.core_to_defs_refs and self.core_to_defs_refs[core_mode_ref] in self.definitions:
-                return {'$ref': self.core_to_json_refs[core_mode_ref]}
-
-        # Generate the JSON schema, accounting for the json_schema_override and core_schema_override
-        metadata_handler = _core_metadata.CoreMetadataHandler(schema)
-
-        def populate_defs(core_schema: CoreSchema, json_schema: JsonSchemaValue) -> JsonSchemaValue:
-            if 'ref' in core_schema:
-                core_ref = CoreRef(core_schema['ref'])  # type: ignore[typeddict-item]
-                defs_ref, ref_json_schema = self.get_cache_defs_ref_schema(core_ref)
-                json_ref = JsonRef(ref_json_schema['$ref'])
-                self.json_to_defs_refs[json_ref] = defs_ref
-                # Replace the schema if it's not a reference to itself
-                # What we want to avoid is having the def be just a ref to itself
-                # which is what would happen if we blindly assigned any
-                if json_schema.get('$ref', None) != json_ref:
-                    self.definitions[defs_ref] = json_schema
-                    self._core_defs_invalid_for_json_schema.pop(defs_ref, None)
-                json_schema = ref_json_schema
-            return json_schema
-
-        def convert_to_all_of(json_schema: JsonSchemaValue) -> JsonSchemaValue:
-            if '$ref' in json_schema and len(json_schema.keys()) > 1:
-                # technically you can't have any other keys next to a "$ref"
-                # but it's an easy mistake to make and not hard to correct automatically here
-                json_schema = json_schema.copy()
-                ref = json_schema.pop('$ref')
-                json_schema = {'allOf': [{'$ref': ref}], **json_schema}
-            return json_schema
-
-        def handler_func(schema_or_field: CoreSchemaOrField) -> JsonSchemaValue:
-            """Generate a JSON schema based on the input schema.
-
-            Args:
-                schema_or_field: The core schema to generate a JSON schema from.
-
-            Returns:
-                The generated JSON schema.
-
-            Raises:
-                TypeError: If an unexpected schema type is encountered.
-            """
-            # Generate the core-schema-type-specific bits of the schema generation:
-            json_schema: JsonSchemaValue | None = None
-            if self.mode == 'serialization' and 'serialization' in schema_or_field:
-                ser_schema = schema_or_field['serialization']  # type: ignore
-                json_schema = self.ser_schema(ser_schema)
-            if json_schema is None:
-                if _core_utils.is_core_schema(schema_or_field) or _core_utils.is_core_schema_field(schema_or_field):
-                    generate_for_schema_type = self._schema_type_to_method[schema_or_field['type']]
-                    json_schema = generate_for_schema_type(schema_or_field)
-                else:
-                    raise TypeError(f'Unexpected schema type: schema={schema_or_field}')
-            if _core_utils.is_core_schema(schema_or_field):
-                json_schema = populate_defs(schema_or_field, json_schema)
-                json_schema = convert_to_all_of(json_schema)
-            return json_schema
-
-        current_handler = _schema_generation_shared.GenerateJsonSchemaHandler(self, handler_func)
-
-        for js_modify_function in metadata_handler.metadata.get('pydantic_js_functions', ()):
-
-            def new_handler_func(
-                schema_or_field: CoreSchemaOrField,
-                current_handler: GetJsonSchemaHandler = current_handler,
-                js_modify_function: GetJsonSchemaFunction = js_modify_function,
-            ) -> JsonSchemaValue:
-                json_schema = js_modify_function(schema_or_field, current_handler)
-                if _core_utils.is_core_schema(schema_or_field):
-                    json_schema = populate_defs(schema_or_field, json_schema)
-                original_schema = current_handler.resolve_ref_schema(json_schema)
-                ref = json_schema.pop('$ref', None)
-                if ref and json_schema:
-                    original_schema.update(json_schema)
-                return original_schema
-
-            current_handler = _schema_generation_shared.GenerateJsonSchemaHandler(self, new_handler_func)
-
-        for js_modify_function in metadata_handler.metadata.get('pydantic_js_annotation_functions', ()):
-
-            def new_handler_func(
-                schema_or_field: CoreSchemaOrField,
-                current_handler: GetJsonSchemaHandler = current_handler,
-                js_modify_function: GetJsonSchemaFunction = js_modify_function,
-            ) -> JsonSchemaValue:
-                json_schema = js_modify_function(schema_or_field, current_handler)
-                if _core_utils.is_core_schema(schema_or_field):
-                    json_schema = populate_defs(schema_or_field, json_schema)
-                    json_schema = convert_to_all_of(json_schema)
-                return json_schema
-
-            current_handler = _schema_generation_shared.GenerateJsonSchemaHandler(self, new_handler_func)
-
-        json_schema = current_handler(schema)
-        if _core_utils.is_core_schema(schema):
-            json_schema = populate_defs(schema, json_schema)
-            json_schema = convert_to_all_of(json_schema)
-        return json_schema
-
-    # ### Schema generation methods
-    def any_schema(self, schema: core_schema.AnySchema) -> JsonSchemaValue:
-        """Generates a JSON schema that matches any value.
-
-        Args:
-            schema: The core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        return {}
-
-    def none_schema(self, schema: core_schema.NoneSchema) -> JsonSchemaValue:
-        """Generates a JSON schema that matches `None`.
-
-        Args:
-            schema: The core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        return {'type': 'null'}
-
-    def bool_schema(self, schema: core_schema.BoolSchema) -> JsonSchemaValue:
-        """Generates a JSON schema that matches a bool value.
-
-        Args:
-            schema: The core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        return {'type': 'boolean'}
-
-    def int_schema(self, schema: core_schema.IntSchema) -> JsonSchemaValue:
-        """Generates a JSON schema that matches an int value.
-
-        Args:
-            schema: The core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        json_schema: dict[str, Any] = {'type': 'integer'}
-        self.update_with_validations(json_schema, schema, self.ValidationsMapping.numeric)
-        json_schema = {k: v for k, v in json_schema.items() if v not in {math.inf, -math.inf}}
-        return json_schema
-
-    def float_schema(self, schema: core_schema.FloatSchema) -> JsonSchemaValue:
-        """Generates a JSON schema that matches a float value.
-
-        Args:
-            schema: The core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        json_schema: dict[str, Any] = {'type': 'number'}
-        self.update_with_validations(json_schema, schema, self.ValidationsMapping.numeric)
-        json_schema = {k: v for k, v in json_schema.items() if v not in {math.inf, -math.inf}}
-        return json_schema
-
-    def decimal_schema(self, schema: core_schema.DecimalSchema) -> JsonSchemaValue:
-        """Generates a JSON schema that matches a decimal value.
-
-        Args:
-            schema: The core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        json_schema = self.str_schema(core_schema.str_schema())
-        if self.mode == 'validation':
-            multiple_of = schema.get('multiple_of')
-            le = schema.get('le')
-            ge = schema.get('ge')
-            lt = schema.get('lt')
-            gt = schema.get('gt')
-            json_schema = {
-                'anyOf': [
-                    self.float_schema(
-                        core_schema.float_schema(
-                            allow_inf_nan=schema.get('allow_inf_nan'),
-                            multiple_of=None if multiple_of is None else float(multiple_of),
-                            le=None if le is None else float(le),
-                            ge=None if ge is None else float(ge),
-                            lt=None if lt is None else float(lt),
-                            gt=None if gt is None else float(gt),
-                        )
-                    ),
-                    json_schema,
-                ],
-            }
-        return json_schema
-
-    def str_schema(self, schema: core_schema.StringSchema) -> JsonSchemaValue:
-        """Generates a JSON schema that matches a string value.
-
-        Args:
-            schema: The core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        json_schema = {'type': 'string'}
-        self.update_with_validations(json_schema, schema, self.ValidationsMapping.string)
-        return json_schema
-
-    def bytes_schema(self, schema: core_schema.BytesSchema) -> JsonSchemaValue:
-        """Generates a JSON schema that matches a bytes value.
-
-        Args:
-            schema: The core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        json_schema = {'type': 'string', 'format': 'base64url' if self._config.ser_json_bytes == 'base64' else 'binary'}
-        self.update_with_validations(json_schema, schema, self.ValidationsMapping.bytes)
-        return json_schema
-
-    def date_schema(self, schema: core_schema.DateSchema) -> JsonSchemaValue:
-        """Generates a JSON schema that matches a date value.
-
-        Args:
-            schema: The core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        json_schema = {'type': 'string', 'format': 'date'}
-        self.update_with_validations(json_schema, schema, self.ValidationsMapping.date)
-        return json_schema
-
-    def time_schema(self, schema: core_schema.TimeSchema) -> JsonSchemaValue:
-        """Generates a JSON schema that matches a time value.
-
-        Args:
-            schema: The core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        return {'type': 'string', 'format': 'time'}
-
-    def datetime_schema(self, schema: core_schema.DatetimeSchema) -> JsonSchemaValue:
-        """Generates a JSON schema that matches a datetime value.
-
-        Args:
-            schema: The core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        return {'type': 'string', 'format': 'date-time'}
-
-    def timedelta_schema(self, schema: core_schema.TimedeltaSchema) -> JsonSchemaValue:
-        """Generates a JSON schema that matches a timedelta value.
-
-        Args:
-            schema: The core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        if self._config.ser_json_timedelta == 'float':
-            return {'type': 'number'}
-        return {'type': 'string', 'format': 'duration'}
-
-    def literal_schema(self, schema: core_schema.LiteralSchema) -> JsonSchemaValue:
-        """Generates a JSON schema that matches a literal value.
-
-        Args:
-            schema: The core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        expected = [v.value if isinstance(v, Enum) else v for v in schema['expected']]
-        # jsonify the expected values
-        expected = [to_jsonable_python(v) for v in expected]
-
-        if len(expected) == 1:
-            return {'const': expected[0]}
-
-        types = {type(e) for e in expected}
-        if types == {str}:
-            return {'enum': expected, 'type': 'string'}
-        elif types == {int}:
-            return {'enum': expected, 'type': 'integer'}
-        elif types == {float}:
-            return {'enum': expected, 'type': 'number'}
-        elif types == {bool}:
-            return {'enum': expected, 'type': 'boolean'}
-        elif types == {list}:
-            return {'enum': expected, 'type': 'array'}
-        # there is not None case because if it's mixed it hits the final `else`
-        # if it's a single Literal[None] then it becomes a `const` schema above
-        else:
-            return {'enum': expected}
-
-    def is_instance_schema(self, schema: core_schema.IsInstanceSchema) -> JsonSchemaValue:
-        """Handles JSON schema generation for a core schema that checks if a value is an instance of a class.
-
-        Unless overridden in a subclass, this raises an error.
-
-        Args:
-            schema: The core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        return self.handle_invalid_for_json_schema(schema, f'core_schema.IsInstanceSchema ({schema["cls"]})')
-
-    def is_subclass_schema(self, schema: core_schema.IsSubclassSchema) -> JsonSchemaValue:
-        """Handles JSON schema generation for a core schema that checks if a value is a subclass of a class.
-
-        For backwards compatibility with v1, this does not raise an error, but can be overridden to change this.
-
-        Args:
-            schema: The core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        # Note: This is for compatibility with V1; you can override if you want different behavior.
-        return {}
-
-    def callable_schema(self, schema: core_schema.CallableSchema) -> JsonSchemaValue:
-        """Generates a JSON schema that matches a callable value.
-
-        Unless overridden in a subclass, this raises an error.
-
-        Args:
-            schema: The core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        return self.handle_invalid_for_json_schema(schema, 'core_schema.CallableSchema')
-
-    def list_schema(self, schema: core_schema.ListSchema) -> JsonSchemaValue:
-        """Returns a schema that matches a list schema.
-
-        Args:
-            schema: The core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        items_schema = {} if 'items_schema' not in schema else self.generate_inner(schema['items_schema'])
-        json_schema = {'type': 'array', 'items': items_schema}
-        self.update_with_validations(json_schema, schema, self.ValidationsMapping.array)
-        return json_schema
-
-    @deprecated('`tuple_positional_schema` is deprecated. Use `tuple_schema` instead.', category=None)
-    @final
-    def tuple_positional_schema(self, schema: core_schema.TupleSchema) -> JsonSchemaValue:
-        """Replaced by `tuple_schema`."""
-        warnings.warn(
-            '`tuple_positional_schema` is deprecated. Use `tuple_schema` instead.',
-            PydanticDeprecatedSince26,
-            stacklevel=2,
-        )
-        return self.tuple_schema(schema)
-
-    @deprecated('`tuple_variable_schema` is deprecated. Use `tuple_schema` instead.', category=None)
-    @final
-    def tuple_variable_schema(self, schema: core_schema.TupleSchema) -> JsonSchemaValue:
-        """Replaced by `tuple_schema`."""
-        warnings.warn(
-            '`tuple_variable_schema` is deprecated. Use `tuple_schema` instead.',
-            PydanticDeprecatedSince26,
-            stacklevel=2,
-        )
-        return self.tuple_schema(schema)
-
-    def tuple_schema(self, schema: core_schema.TupleSchema) -> JsonSchemaValue:
-        """Generates a JSON schema that matches a tuple schema e.g. `Tuple[int,
-        str, bool]` or `Tuple[int, ...]`.
-
-        Args:
-            schema: The core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        json_schema: JsonSchemaValue = {'type': 'array'}
-        if 'variadic_item_index' in schema:
-            variadic_item_index = schema['variadic_item_index']
-            if variadic_item_index > 0:
-                json_schema['minItems'] = variadic_item_index
-                json_schema['prefixItems'] = [
-                    self.generate_inner(item) for item in schema['items_schema'][:variadic_item_index]
-                ]
-            if variadic_item_index + 1 == len(schema['items_schema']):
-                # if the variadic item is the last item, then represent it faithfully
-                json_schema['items'] = self.generate_inner(schema['items_schema'][variadic_item_index])
-            else:
-                # otherwise, 'items' represents the schema for the variadic
-                # item plus the suffix, so just allow anything for simplicity
-                # for now
-                json_schema['items'] = True
-        else:
-            prefixItems = [self.generate_inner(item) for item in schema['items_schema']]
-            if prefixItems:
-                json_schema['prefixItems'] = prefixItems
-            json_schema['minItems'] = len(prefixItems)
-            json_schema['maxItems'] = len(prefixItems)
-        self.update_with_validations(json_schema, schema, self.ValidationsMapping.array)
-        return json_schema
-
-    def set_schema(self, schema: core_schema.SetSchema) -> JsonSchemaValue:
-        """Generates a JSON schema that matches a set schema.
-
-        Args:
-            schema: The core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        return self._common_set_schema(schema)
-
-    def frozenset_schema(self, schema: core_schema.FrozenSetSchema) -> JsonSchemaValue:
-        """Generates a JSON schema that matches a frozenset schema.
-
-        Args:
-            schema: The core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        return self._common_set_schema(schema)
-
-    def _common_set_schema(self, schema: core_schema.SetSchema | core_schema.FrozenSetSchema) -> JsonSchemaValue:
-        items_schema = {} if 'items_schema' not in schema else self.generate_inner(schema['items_schema'])
-        json_schema = {'type': 'array', 'uniqueItems': True, 'items': items_schema}
-        self.update_with_validations(json_schema, schema, self.ValidationsMapping.array)
-        return json_schema
-
-    def generator_schema(self, schema: core_schema.GeneratorSchema) -> JsonSchemaValue:
-        """Returns a JSON schema that represents the provided GeneratorSchema.
-
-        Args:
-            schema: The schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        items_schema = {} if 'items_schema' not in schema else self.generate_inner(schema['items_schema'])
-        json_schema = {'type': 'array', 'items': items_schema}
-        self.update_with_validations(json_schema, schema, self.ValidationsMapping.array)
-        return json_schema
-
-    def dict_schema(self, schema: core_schema.DictSchema) -> JsonSchemaValue:
-        """Generates a JSON schema that matches a dict schema.
-
-        Args:
-            schema: The core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        json_schema: JsonSchemaValue = {'type': 'object'}
-
-        keys_schema = self.generate_inner(schema['keys_schema']).copy() if 'keys_schema' in schema else {}
-        keys_pattern = keys_schema.pop('pattern', None)
-
-        values_schema = self.generate_inner(schema['values_schema']).copy() if 'values_schema' in schema else {}
-        values_schema.pop('title', None)  # don't give a title to the additionalProperties
-        if values_schema or keys_pattern is not None:  # don't add additionalProperties if it's empty
-            if keys_pattern is None:
-                json_schema['additionalProperties'] = values_schema
-            else:
-                json_schema['patternProperties'] = {keys_pattern: values_schema}
-
-        self.update_with_validations(json_schema, schema, self.ValidationsMapping.object)
-        return json_schema
-
-    def _function_schema(
-        self,
-        schema: _core_utils.AnyFunctionSchema,
-    ) -> JsonSchemaValue:
-        if _core_utils.is_function_with_inner_schema(schema):
-            # This could be wrong if the function's mode is 'before', but in practice will often be right, and when it
-            # isn't, I think it would be hard to automatically infer what the desired schema should be.
-            return self.generate_inner(schema['schema'])
-
-        # function-plain
-        return self.handle_invalid_for_json_schema(
-            schema, f'core_schema.PlainValidatorFunctionSchema ({schema["function"]})'
-        )
-
-    def function_before_schema(self, schema: core_schema.BeforeValidatorFunctionSchema) -> JsonSchemaValue:
-        """Generates a JSON schema that matches a function-before schema.
-
-        Args:
-            schema: The core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        return self._function_schema(schema)
-
-    def function_after_schema(self, schema: core_schema.AfterValidatorFunctionSchema) -> JsonSchemaValue:
-        """Generates a JSON schema that matches a function-after schema.
-
-        Args:
-            schema: The core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        return self._function_schema(schema)
-
-    def function_plain_schema(self, schema: core_schema.PlainValidatorFunctionSchema) -> JsonSchemaValue:
-        """Generates a JSON schema that matches a function-plain schema.
-
-        Args:
-            schema: The core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        return self._function_schema(schema)
-
-    def function_wrap_schema(self, schema: core_schema.WrapValidatorFunctionSchema) -> JsonSchemaValue:
-        """Generates a JSON schema that matches a function-wrap schema.
-
-        Args:
-            schema: The core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        return self._function_schema(schema)
-
-    def default_schema(self, schema: core_schema.WithDefaultSchema) -> JsonSchemaValue:
-        """Generates a JSON schema that matches a schema with a default value.
-
-        Args:
-            schema: The core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        json_schema = self.generate_inner(schema['schema'])
-
-        if 'default' not in schema:
-            return json_schema
-        default = schema['default']
-        # Note: if you want to include the value returned by the default_factory,
-        # override this method and replace the code above with:
-        # if 'default' in schema:
-        #     default = schema['default']
-        # elif 'default_factory' in schema:
-        #     default = schema['default_factory']()
-        # else:
-        #     return json_schema
-
-        try:
-            encoded_default = self.encode_default(default)
-        except pydantic_core.PydanticSerializationError:
-            self.emit_warning(
-                'non-serializable-default',
-                f'Default value {default} is not JSON serializable; excluding default from JSON schema',
-            )
-            # Return the inner schema, as though there was no default
-            return json_schema
-
-        if '$ref' in json_schema:
-            # Since reference schemas do not support child keys, we wrap the reference schema in a single-case allOf:
-            return {'allOf': [json_schema], 'default': encoded_default}
-        else:
-            json_schema['default'] = encoded_default
-            return json_schema
-
-    def nullable_schema(self, schema: core_schema.NullableSchema) -> JsonSchemaValue:
-        """Generates a JSON schema that matches a schema that allows null values.
-
-        Args:
-            schema: The core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        null_schema = {'type': 'null'}
-        inner_json_schema = self.generate_inner(schema['schema'])
-
-        if inner_json_schema == null_schema:
-            return null_schema
-        else:
-            # Thanks to the equality check against `null_schema` above, I think 'oneOf' would also be valid here;
-            # I'll use 'anyOf' for now, but it could be changed it if it would work better with some external tooling
-            return self.get_flattened_anyof([inner_json_schema, null_schema])
-
-    def union_schema(self, schema: core_schema.UnionSchema) -> JsonSchemaValue:
-        """Generates a JSON schema that matches a schema that allows values matching any of the given schemas.
-
-        Args:
-            schema: The core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        generated: list[JsonSchemaValue] = []
-
-        choices = schema['choices']
-        for choice in choices:
-            # choice will be a tuple if an explicit label was provided
-            choice_schema = choice[0] if isinstance(choice, tuple) else choice
-            try:
-                generated.append(self.generate_inner(choice_schema))
-            except PydanticOmit:
-                continue
-            except PydanticInvalidForJsonSchema as exc:
-                self.emit_warning('skipped-choice', exc.message)
-        if len(generated) == 1:
-            return generated[0]
-        return self.get_flattened_anyof(generated)
-
-    def tagged_union_schema(self, schema: core_schema.TaggedUnionSchema) -> JsonSchemaValue:
-        """Generates a JSON schema that matches a schema that allows values matching any of the given schemas, where
-        the schemas are tagged with a discriminator field that indicates which schema should be used to validate
-        the value.
-
-        Args:
-            schema: The core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        generated: dict[str, JsonSchemaValue] = {}
-        for k, v in schema['choices'].items():
-            if isinstance(k, Enum):
-                k = k.value
-            try:
-                # Use str(k) since keys must be strings for json; while not technically correct,
-                # it's the closest that can be represented in valid JSON
-                generated[str(k)] = self.generate_inner(v).copy()
-            except PydanticOmit:
-                continue
-            except PydanticInvalidForJsonSchema as exc:
-                self.emit_warning('skipped-choice', exc.message)
-
-        one_of_choices = _deduplicate_schemas(generated.values())
-        json_schema: JsonSchemaValue = {'oneOf': one_of_choices}
-
-        # This reflects the v1 behavior; TODO: we should make it possible to exclude OpenAPI stuff from the JSON schema
-        openapi_discriminator = self._extract_discriminator(schema, one_of_choices)
-        if openapi_discriminator is not None:
-            json_schema['discriminator'] = {
-                'propertyName': openapi_discriminator,
-                'mapping': {k: v.get('$ref', v) for k, v in generated.items()},
-            }
-
-        return json_schema
-
-    def _extract_discriminator(
-        self, schema: core_schema.TaggedUnionSchema, one_of_choices: list[JsonDict]
-    ) -> str | None:
-        """Extract a compatible OpenAPI discriminator from the schema and one_of choices that end up in the final
-        schema."""
-        openapi_discriminator: str | None = None
-
-        if isinstance(schema['discriminator'], str):
-            return schema['discriminator']
-
-        if isinstance(schema['discriminator'], list):
-            # If the discriminator is a single item list containing a string, that is equivalent to the string case
-            if len(schema['discriminator']) == 1 and isinstance(schema['discriminator'][0], str):
-                return schema['discriminator'][0]
-            # When an alias is used that is different from the field name, the discriminator will be a list of single
-            # str lists, one for the attribute and one for the actual alias. The logic here will work even if there is
-            # more than one possible attribute, and looks for whether a single alias choice is present as a documented
-            # property on all choices. If so, that property will be used as the OpenAPI discriminator.
-            for alias_path in schema['discriminator']:
-                if not isinstance(alias_path, list):
-                    break  # this means that the discriminator is not a list of alias paths
-                if len(alias_path) != 1:
-                    continue  # this means that the "alias" does not represent a single field
-                alias = alias_path[0]
-                if not isinstance(alias, str):
-                    continue  # this means that the "alias" does not represent a field
-                alias_is_present_on_all_choices = True
-                for choice in one_of_choices:
-                    while '$ref' in choice:
-                        assert isinstance(choice['$ref'], str)
-                        choice = self.get_schema_from_definitions(JsonRef(choice['$ref'])) or {}
-                    properties = choice.get('properties', {})
-                    if not isinstance(properties, dict) or alias not in properties:
-                        alias_is_present_on_all_choices = False
-                        break
-                if alias_is_present_on_all_choices:
-                    openapi_discriminator = alias
-                    break
-        return openapi_discriminator
-
-    def chain_schema(self, schema: core_schema.ChainSchema) -> JsonSchemaValue:
-        """Generates a JSON schema that matches a core_schema.ChainSchema.
-
-        When generating a schema for validation, we return the validation JSON schema for the first step in the chain.
-        For serialization, we return the serialization JSON schema for the last step in the chain.
-
-        Args:
-            schema: The core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        step_index = 0 if self.mode == 'validation' else -1  # use first step for validation, last for serialization
-        return self.generate_inner(schema['steps'][step_index])
-
-    def lax_or_strict_schema(self, schema: core_schema.LaxOrStrictSchema) -> JsonSchemaValue:
-        """Generates a JSON schema that matches a schema that allows values matching either the lax schema or the
-        strict schema.
-
-        Args:
-            schema: The core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        # TODO: Need to read the default value off of model config or whatever
-        use_strict = schema.get('strict', False)  # TODO: replace this default False
-        # If your JSON schema fails to generate it is probably
-        # because one of the following two branches failed.
-        if use_strict:
-            return self.generate_inner(schema['strict_schema'])
-        else:
-            return self.generate_inner(schema['lax_schema'])
-
-    def json_or_python_schema(self, schema: core_schema.JsonOrPythonSchema) -> JsonSchemaValue:
-        """Generates a JSON schema that matches a schema that allows values matching either the JSON schema or the
-        Python schema.
-
-        The JSON schema is used instead of the Python schema. If you want to use the Python schema, you should override
-        this method.
-
-        Args:
-            schema: The core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        return self.generate_inner(schema['json_schema'])
-
-    def typed_dict_schema(self, schema: core_schema.TypedDictSchema) -> JsonSchemaValue:
-        """Generates a JSON schema that matches a schema that defines a typed dict.
-
-        Args:
-            schema: The core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        total = schema.get('total', True)
-        named_required_fields: list[tuple[str, bool, CoreSchemaField]] = [
-            (name, self.field_is_required(field, total), field)
-            for name, field in schema['fields'].items()
-            if self.field_is_present(field)
-        ]
-        if self.mode == 'serialization':
-            named_required_fields.extend(self._name_required_computed_fields(schema.get('computed_fields', [])))
-
-        config = _get_typed_dict_config(schema)
-        with self._config_wrapper_stack.push(config):
-            json_schema = self._named_required_fields_schema(named_required_fields)
-
-        extra = schema.get('extra_behavior')
-        if extra is None:
-            extra = config.get('extra', 'ignore')
-        if extra == 'forbid':
-            json_schema['additionalProperties'] = False
-        elif extra == 'allow':
-            json_schema['additionalProperties'] = True
-
-        return json_schema
-
-    @staticmethod
-    def _name_required_computed_fields(
-        computed_fields: list[ComputedField],
-    ) -> list[tuple[str, bool, core_schema.ComputedField]]:
-        return [(field['property_name'], True, field) for field in computed_fields]
-
-    def _named_required_fields_schema(
-        self, named_required_fields: Sequence[tuple[str, bool, CoreSchemaField]]
-    ) -> JsonSchemaValue:
-        properties: dict[str, JsonSchemaValue] = {}
-        required_fields: list[str] = []
-        for name, required, field in named_required_fields:
-            if self.by_alias:
-                name = self._get_alias_name(field, name)
-            try:
-                field_json_schema = self.generate_inner(field).copy()
-            except PydanticOmit:
-                continue
-            if 'title' not in field_json_schema and self.field_title_should_be_set(field):
-                title = self.get_title_from_name(name)
-                field_json_schema['title'] = title
-            field_json_schema = self.handle_ref_overrides(field_json_schema)
-            properties[name] = field_json_schema
-            if required:
-                required_fields.append(name)
-
-        json_schema = {'type': 'object', 'properties': properties}
-        if required_fields:
-            json_schema['required'] = required_fields
-        return json_schema
-
-    def _get_alias_name(self, field: CoreSchemaField, name: str) -> str:
-        if field['type'] == 'computed-field':
-            alias: Any = field.get('alias', name)
-        elif self.mode == 'validation':
-            alias = field.get('validation_alias', name)
-        else:
-            alias = field.get('serialization_alias', name)
-        if isinstance(alias, str):
-            name = alias
-        elif isinstance(alias, list):
-            alias = cast('list[str] | str', alias)
-            for path in alias:
-                if isinstance(path, list) and len(path) == 1 and isinstance(path[0], str):
-                    # Use the first valid single-item string path; the code that constructs the alias array
-                    # should ensure the first such item is what belongs in the JSON schema
-                    name = path[0]
-                    break
-        else:
-            assert_never(alias)
-        return name
-
-    def typed_dict_field_schema(self, schema: core_schema.TypedDictField) -> JsonSchemaValue:
-        """Generates a JSON schema that matches a schema that defines a typed dict field.
-
-        Args:
-            schema: The core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        return self.generate_inner(schema['schema'])
-
-    def dataclass_field_schema(self, schema: core_schema.DataclassField) -> JsonSchemaValue:
-        """Generates a JSON schema that matches a schema that defines a dataclass field.
-
-        Args:
-            schema: The core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        return self.generate_inner(schema['schema'])
-
-    def model_field_schema(self, schema: core_schema.ModelField) -> JsonSchemaValue:
-        """Generates a JSON schema that matches a schema that defines a model field.
-
-        Args:
-            schema: The core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        return self.generate_inner(schema['schema'])
-
-    def computed_field_schema(self, schema: core_schema.ComputedField) -> JsonSchemaValue:
-        """Generates a JSON schema that matches a schema that defines a computed field.
-
-        Args:
-            schema: The core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        return self.generate_inner(schema['return_schema'])
-
-    def model_schema(self, schema: core_schema.ModelSchema) -> JsonSchemaValue:
-        """Generates a JSON schema that matches a schema that defines a model.
-
-        Args:
-            schema: The core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        # We do not use schema['model'].model_json_schema() here
-        # because it could lead to inconsistent refs handling, etc.
-        cls = cast('type[BaseModel]', schema['cls'])
-        config = cls.model_config
-        title = config.get('title')
-
-        with self._config_wrapper_stack.push(config):
-            json_schema = self.generate_inner(schema['schema'])
-
-        json_schema_extra = config.get('json_schema_extra')
-        if cls.__pydantic_root_model__:
-            root_json_schema_extra = cls.model_fields['root'].json_schema_extra
-            if json_schema_extra and root_json_schema_extra:
-                raise ValueError(
-                    '"model_config[\'json_schema_extra\']" and "Field.json_schema_extra" on "RootModel.root"'
-                    ' field must not be set simultaneously'
-                )
-            if root_json_schema_extra:
-                json_schema_extra = root_json_schema_extra
-
-        json_schema = self._update_class_schema(json_schema, title, config.get('extra', None), cls, json_schema_extra)
-
-        return json_schema
-
-    def _update_class_schema(
-        self,
-        json_schema: JsonSchemaValue,
-        title: str | None,
-        extra: Literal['allow', 'ignore', 'forbid'] | None,
-        cls: type[Any],
-        json_schema_extra: JsonDict | JsonSchemaExtraCallable | None,
-    ) -> JsonSchemaValue:
-        if '$ref' in json_schema:
-            schema_to_update = self.get_schema_from_definitions(JsonRef(json_schema['$ref'])) or json_schema
-        else:
-            schema_to_update = json_schema
-
-        if title is not None:
-            # referenced_schema['title'] = title
-            schema_to_update.setdefault('title', title)
-
-        if 'additionalProperties' not in schema_to_update:
-            if extra == 'allow':
-                schema_to_update['additionalProperties'] = True
-            elif extra == 'forbid':
-                schema_to_update['additionalProperties'] = False
-
-        if isinstance(json_schema_extra, (staticmethod, classmethod)):
-            # In older versions of python, this is necessary to ensure staticmethod/classmethods are callable
-            json_schema_extra = json_schema_extra.__get__(cls)
-
-        if isinstance(json_schema_extra, dict):
-            schema_to_update.update(json_schema_extra)
-        elif callable(json_schema_extra):
-            if len(inspect.signature(json_schema_extra).parameters) > 1:
-                json_schema_extra(schema_to_update, cls)  # type: ignore
-            else:
-                json_schema_extra(schema_to_update)  # type: ignore
-        elif json_schema_extra is not None:
-            raise ValueError(
-                f"model_config['json_schema_extra']={json_schema_extra} should be a dict, callable, or None"
-            )
-
-        return json_schema
-
-    def resolve_schema_to_update(self, json_schema: JsonSchemaValue) -> JsonSchemaValue:
-        """Resolve a JsonSchemaValue to the non-ref schema if it is a $ref schema.
-
-        Args:
-            json_schema: The schema to resolve.
-
-        Returns:
-            The resolved schema.
-        """
-        if '$ref' in json_schema:
-            schema_to_update = self.get_schema_from_definitions(JsonRef(json_schema['$ref']))
-            if schema_to_update is None:
-                raise RuntimeError(f'Cannot update undefined schema for $ref={json_schema["$ref"]}')
-            return self.resolve_schema_to_update(schema_to_update)
-        else:
-            schema_to_update = json_schema
-        return schema_to_update
-
-    def model_fields_schema(self, schema: core_schema.ModelFieldsSchema) -> JsonSchemaValue:
-        """Generates a JSON schema that matches a schema that defines a model's fields.
-
-        Args:
-            schema: The core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        named_required_fields: list[tuple[str, bool, CoreSchemaField]] = [
-            (name, self.field_is_required(field, total=True), field)
-            for name, field in schema['fields'].items()
-            if self.field_is_present(field)
-        ]
-        if self.mode == 'serialization':
-            named_required_fields.extend(self._name_required_computed_fields(schema.get('computed_fields', [])))
-        json_schema = self._named_required_fields_schema(named_required_fields)
-        extras_schema = schema.get('extras_schema', None)
-        if extras_schema is not None:
-            schema_to_update = self.resolve_schema_to_update(json_schema)
-            schema_to_update['additionalProperties'] = self.generate_inner(extras_schema)
-        return json_schema
-
-    def field_is_present(self, field: CoreSchemaField) -> bool:
-        """Whether the field should be included in the generated JSON schema.
-
-        Args:
-            field: The schema for the field itself.
-
-        Returns:
-            `True` if the field should be included in the generated JSON schema, `False` otherwise.
-        """
-        if self.mode == 'serialization':
-            # If you still want to include the field in the generated JSON schema,
-            # override this method and return True
-            return not field.get('serialization_exclude')
-        elif self.mode == 'validation':
-            return True
-        else:
-            assert_never(self.mode)
-
-    def field_is_required(
-        self,
-        field: core_schema.ModelField | core_schema.DataclassField | core_schema.TypedDictField,
-        total: bool,
-    ) -> bool:
-        """Whether the field should be marked as required in the generated JSON schema.
-        (Note that this is irrelevant if the field is not present in the JSON schema.).
-
-        Args:
-            field: The schema for the field itself.
-            total: Only applies to `TypedDictField`s.
-                Indicates if the `TypedDict` this field belongs to is total, in which case any fields that don't
-                explicitly specify `required=False` are required.
-
-        Returns:
-            `True` if the field should be marked as required in the generated JSON schema, `False` otherwise.
-        """
-        if self.mode == 'serialization' and self._config.json_schema_serialization_defaults_required:
-            return not field.get('serialization_exclude')
-        else:
-            if field['type'] == 'typed-dict-field':
-                return field.get('required', total)
-            else:
-                return field['schema']['type'] != 'default'
-
-    def dataclass_args_schema(self, schema: core_schema.DataclassArgsSchema) -> JsonSchemaValue:
-        """Generates a JSON schema that matches a schema that defines a dataclass's constructor arguments.
-
-        Args:
-            schema: The core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        named_required_fields: list[tuple[str, bool, CoreSchemaField]] = [
-            (field['name'], self.field_is_required(field, total=True), field)
-            for field in schema['fields']
-            if self.field_is_present(field)
-        ]
-        if self.mode == 'serialization':
-            named_required_fields.extend(self._name_required_computed_fields(schema.get('computed_fields', [])))
-        return self._named_required_fields_schema(named_required_fields)
-
-    def dataclass_schema(self, schema: core_schema.DataclassSchema) -> JsonSchemaValue:
-        """Generates a JSON schema that matches a schema that defines a dataclass.
-
-        Args:
-            schema: The core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        cls = schema['cls']
-        config: ConfigDict = getattr(cls, '__pydantic_config__', cast('ConfigDict', {}))
-        title = config.get('title') or cls.__name__
-
-        with self._config_wrapper_stack.push(config):
-            json_schema = self.generate_inner(schema['schema']).copy()
-
-        json_schema_extra = config.get('json_schema_extra')
-        json_schema = self._update_class_schema(json_schema, title, config.get('extra', None), cls, json_schema_extra)
-
-        # Dataclass-specific handling of description
-        if is_dataclass(cls) and not hasattr(cls, '__pydantic_validator__'):
-            # vanilla dataclass; don't use cls.__doc__ as it will contain the class signature by default
-            description = None
-        else:
-            description = None if cls.__doc__ is None else inspect.cleandoc(cls.__doc__)
-        if description:
-            json_schema['description'] = description
-
-        return json_schema
-
-    def arguments_schema(self, schema: core_schema.ArgumentsSchema) -> JsonSchemaValue:
-        """Generates a JSON schema that matches a schema that defines a function's arguments.
-
-        Args:
-            schema: The core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        metadata = _core_metadata.CoreMetadataHandler(schema).metadata
-        prefer_positional = metadata.get('pydantic_js_prefer_positional_arguments')
-
-        arguments = schema['arguments_schema']
-        kw_only_arguments = [a for a in arguments if a.get('mode') == 'keyword_only']
-        kw_or_p_arguments = [a for a in arguments if a.get('mode') in {'positional_or_keyword', None}]
-        p_only_arguments = [a for a in arguments if a.get('mode') == 'positional_only']
-        var_args_schema = schema.get('var_args_schema')
-        var_kwargs_schema = schema.get('var_kwargs_schema')
-
-        if prefer_positional:
-            positional_possible = not kw_only_arguments and not var_kwargs_schema
-            if positional_possible:
-                return self.p_arguments_schema(p_only_arguments + kw_or_p_arguments, var_args_schema)
-
-        keyword_possible = not p_only_arguments and not var_args_schema
-        if keyword_possible:
-            return self.kw_arguments_schema(kw_or_p_arguments + kw_only_arguments, var_kwargs_schema)
-
-        if not prefer_positional:
-            positional_possible = not kw_only_arguments and not var_kwargs_schema
-            if positional_possible:
-                return self.p_arguments_schema(p_only_arguments + kw_or_p_arguments, var_args_schema)
-
-        raise PydanticInvalidForJsonSchema(
-            'Unable to generate JSON schema for arguments validator with positional-only and keyword-only arguments'
-        )
-
-    def kw_arguments_schema(
-        self, arguments: list[core_schema.ArgumentsParameter], var_kwargs_schema: CoreSchema | None
-    ) -> JsonSchemaValue:
-        """Generates a JSON schema that matches a schema that defines a function's keyword arguments.
-
-        Args:
-            arguments: The core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        properties: dict[str, JsonSchemaValue] = {}
-        required: list[str] = []
-        for argument in arguments:
-            name = self.get_argument_name(argument)
-            argument_schema = self.generate_inner(argument['schema']).copy()
-            argument_schema['title'] = self.get_title_from_name(name)
-            properties[name] = argument_schema
-
-            if argument['schema']['type'] != 'default':
-                # This assumes that if the argument has a default value,
-                # the inner schema must be of type WithDefaultSchema.
-                # I believe this is true, but I am not 100% sure
-                required.append(name)
-
-        json_schema: JsonSchemaValue = {'type': 'object', 'properties': properties}
-        if required:
-            json_schema['required'] = required
-
-        if var_kwargs_schema:
-            additional_properties_schema = self.generate_inner(var_kwargs_schema)
-            if additional_properties_schema:
-                json_schema['additionalProperties'] = additional_properties_schema
-        else:
-            json_schema['additionalProperties'] = False
-        return json_schema
-
-    def p_arguments_schema(
-        self, arguments: list[core_schema.ArgumentsParameter], var_args_schema: CoreSchema | None
-    ) -> JsonSchemaValue:
-        """Generates a JSON schema that matches a schema that defines a function's positional arguments.
-
-        Args:
-            arguments: The core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        prefix_items: list[JsonSchemaValue] = []
-        min_items = 0
-
-        for argument in arguments:
-            name = self.get_argument_name(argument)
-
-            argument_schema = self.generate_inner(argument['schema']).copy()
-            argument_schema['title'] = self.get_title_from_name(name)
-            prefix_items.append(argument_schema)
-
-            if argument['schema']['type'] != 'default':
-                # This assumes that if the argument has a default value,
-                # the inner schema must be of type WithDefaultSchema.
-                # I believe this is true, but I am not 100% sure
-                min_items += 1
-
-        json_schema: JsonSchemaValue = {'type': 'array', 'prefixItems': prefix_items}
-        if min_items:
-            json_schema['minItems'] = min_items
-
-        if var_args_schema:
-            items_schema = self.generate_inner(var_args_schema)
-            if items_schema:
-                json_schema['items'] = items_schema
-        else:
-            json_schema['maxItems'] = len(prefix_items)
-
-        return json_schema
-
-    def get_argument_name(self, argument: core_schema.ArgumentsParameter) -> str:
-        """Retrieves the name of an argument.
-
-        Args:
-            argument: The core schema.
-
-        Returns:
-            The name of the argument.
-        """
-        name = argument['name']
-        if self.by_alias:
-            alias = argument.get('alias')
-            if isinstance(alias, str):
-                name = alias
-            else:
-                pass  # might want to do something else?
-        return name
-
-    def call_schema(self, schema: core_schema.CallSchema) -> JsonSchemaValue:
-        """Generates a JSON schema that matches a schema that defines a function call.
-
-        Args:
-            schema: The core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        return self.generate_inner(schema['arguments_schema'])
-
-    def custom_error_schema(self, schema: core_schema.CustomErrorSchema) -> JsonSchemaValue:
-        """Generates a JSON schema that matches a schema that defines a custom error.
-
-        Args:
-            schema: The core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        return self.generate_inner(schema['schema'])
-
-    def json_schema(self, schema: core_schema.JsonSchema) -> JsonSchemaValue:
-        """Generates a JSON schema that matches a schema that defines a JSON object.
-
-        Args:
-            schema: The core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        content_core_schema = schema.get('schema') or core_schema.any_schema()
-        content_json_schema = self.generate_inner(content_core_schema)
-        if self.mode == 'validation':
-            return {'type': 'string', 'contentMediaType': 'application/json', 'contentSchema': content_json_schema}
-        else:
-            # self.mode == 'serialization'
-            return content_json_schema
-
-    def url_schema(self, schema: core_schema.UrlSchema) -> JsonSchemaValue:
-        """Generates a JSON schema that matches a schema that defines a URL.
-
-        Args:
-            schema: The core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        json_schema = {'type': 'string', 'format': 'uri', 'minLength': 1}
-        self.update_with_validations(json_schema, schema, self.ValidationsMapping.string)
-        return json_schema
-
-    def multi_host_url_schema(self, schema: core_schema.MultiHostUrlSchema) -> JsonSchemaValue:
-        """Generates a JSON schema that matches a schema that defines a URL that can be used with multiple hosts.
-
-        Args:
-            schema: The core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        # Note: 'multi-host-uri' is a custom/pydantic-specific format, not part of the JSON Schema spec
-        json_schema = {'type': 'string', 'format': 'multi-host-uri', 'minLength': 1}
-        self.update_with_validations(json_schema, schema, self.ValidationsMapping.string)
-        return json_schema
-
-    def uuid_schema(self, schema: core_schema.UuidSchema) -> JsonSchemaValue:
-        """Generates a JSON schema that matches a UUID.
-
-        Args:
-            schema: The core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        return {'type': 'string', 'format': 'uuid'}
-
-    def definitions_schema(self, schema: core_schema.DefinitionsSchema) -> JsonSchemaValue:
-        """Generates a JSON schema that matches a schema that defines a JSON object with definitions.
-
-        Args:
-            schema: The core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        for definition in schema['definitions']:
-            try:
-                self.generate_inner(definition)
-            except PydanticInvalidForJsonSchema as e:
-                core_ref: CoreRef = CoreRef(definition['ref'])  # type: ignore
-                self._core_defs_invalid_for_json_schema[self.get_defs_ref((core_ref, self.mode))] = e
-                continue
-        return self.generate_inner(schema['schema'])
-
-    def definition_ref_schema(self, schema: core_schema.DefinitionReferenceSchema) -> JsonSchemaValue:
-        """Generates a JSON schema that matches a schema that references a definition.
-
-        Args:
-            schema: The core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        core_ref = CoreRef(schema['schema_ref'])
-        _, ref_json_schema = self.get_cache_defs_ref_schema(core_ref)
-        return ref_json_schema
-
-    def ser_schema(
-        self, schema: core_schema.SerSchema | core_schema.IncExSeqSerSchema | core_schema.IncExDictSerSchema
-    ) -> JsonSchemaValue | None:
-        """Generates a JSON schema that matches a schema that defines a serialized object.
-
-        Args:
-            schema: The core schema.
-
-        Returns:
-            The generated JSON schema.
-        """
-        schema_type = schema['type']
-        if schema_type == 'function-plain' or schema_type == 'function-wrap':
-            # PlainSerializerFunctionSerSchema or WrapSerializerFunctionSerSchema
-            return_schema = schema.get('return_schema')
-            if return_schema is not None:
-                return self.generate_inner(return_schema)
-        elif schema_type == 'format' or schema_type == 'to-string':
-            # FormatSerSchema or ToStringSerSchema
-            return self.str_schema(core_schema.str_schema())
-        elif schema['type'] == 'model':
-            # ModelSerSchema
-            return self.generate_inner(schema['schema'])
-        return None
-
-    # ### Utility methods
-
-    def get_title_from_name(self, name: str) -> str:
-        """Retrieves a title from a name.
-
-        Args:
-            name: The name to retrieve a title from.
-
-        Returns:
-            The title.
-        """
-        return name.title().replace('_', ' ')
-
-    def field_title_should_be_set(self, schema: CoreSchemaOrField) -> bool:
-        """Returns true if a field with the given schema should have a title set based on the field name.
-
-        Intuitively, we want this to return true for schemas that wouldn't otherwise provide their own title
-        (e.g., int, float, str), and false for those that would (e.g., BaseModel subclasses).
-
-        Args:
-            schema: The schema to check.
-
-        Returns:
-            `True` if the field should have a title set, `False` otherwise.
-        """
-        if _core_utils.is_core_schema_field(schema):
-            if schema['type'] == 'computed-field':
-                field_schema = schema['return_schema']
-            else:
-                field_schema = schema['schema']
-            return self.field_title_should_be_set(field_schema)
-
-        elif _core_utils.is_core_schema(schema):
-            if schema.get('ref'):  # things with refs, such as models and enums, should not have titles set
-                return False
-            if schema['type'] in {'default', 'nullable', 'definitions'}:
-                return self.field_title_should_be_set(schema['schema'])  # type: ignore[typeddict-item]
-            if _core_utils.is_function_with_inner_schema(schema):
-                return self.field_title_should_be_set(schema['schema'])
-            if schema['type'] == 'definition-ref':
-                # Referenced schemas should not have titles set for the same reason
-                # schemas with refs should not
-                return False
-            return True  # anything else should have title set
-
-        else:
-            raise PydanticInvalidForJsonSchema(f'Unexpected schema type: schema={schema}')  # pragma: no cover
-
-    def normalize_name(self, name: str) -> str:
-        """Normalizes a name to be used as a key in a dictionary.
-
-        Args:
-            name: The name to normalize.
-
-        Returns:
-            The normalized name.
-        """
-        return re.sub(r'[^a-zA-Z0-9.\-_]', '_', name).replace('.', '__')
-
-    def get_defs_ref(self, core_mode_ref: CoreModeRef) -> DefsRef:
-        """Override this method to change the way that definitions keys are generated from a core reference.
-
-        Args:
-            core_mode_ref: The core reference.
-
-        Returns:
-            The definitions key.
-        """
-        # Split the core ref into "components"; generic origins and arguments are each separate components
-        core_ref, mode = core_mode_ref
-        components = re.split(r'([\][,])', core_ref)
-        # Remove IDs from each component
-        components = [x.rsplit(':', 1)[0] for x in components]
-        core_ref_no_id = ''.join(components)
-        # Remove everything before the last period from each "component"
-        components = [re.sub(r'(?:[^.[\]]+\.)+((?:[^.[\]]+))', r'\1', x) for x in components]
-        short_ref = ''.join(components)
-
-        mode_title = _MODE_TITLE_MAPPING[mode]
-
-        # It is important that the generated defs_ref values be such that at least one choice will not
-        # be generated for any other core_ref. Currently, this should be the case because we include
-        # the id of the source type in the core_ref
-        name = DefsRef(self.normalize_name(short_ref))
-        name_mode = DefsRef(self.normalize_name(short_ref) + f'-{mode_title}')
-        module_qualname = DefsRef(self.normalize_name(core_ref_no_id))
-        module_qualname_mode = DefsRef(f'{module_qualname}-{mode_title}')
-        module_qualname_id = DefsRef(self.normalize_name(core_ref))
-        occurrence_index = self._collision_index.get(module_qualname_id)
-        if occurrence_index is None:
-            self._collision_counter[module_qualname] += 1
-            occurrence_index = self._collision_index[module_qualname_id] = self._collision_counter[module_qualname]
-
-        module_qualname_occurrence = DefsRef(f'{module_qualname}__{occurrence_index}')
-        module_qualname_occurrence_mode = DefsRef(f'{module_qualname_mode}__{occurrence_index}')
-
-        self._prioritized_defsref_choices[module_qualname_occurrence_mode] = [
-            name,
-            name_mode,
-            module_qualname,
-            module_qualname_mode,
-            module_qualname_occurrence,
-            module_qualname_occurrence_mode,
-        ]
-
-        return module_qualname_occurrence_mode
-
-    def get_cache_defs_ref_schema(self, core_ref: CoreRef) -> tuple[DefsRef, JsonSchemaValue]:
-        """This method wraps the get_defs_ref method with some cache-lookup/population logic,
-        and returns both the produced defs_ref and the JSON schema that will refer to the right definition.
-
-        Args:
-            core_ref: The core reference to get the definitions reference for.
-
-        Returns:
-            A tuple of the definitions reference and the JSON schema that will refer to it.
-        """
-        core_mode_ref = (core_ref, self.mode)
-        maybe_defs_ref = self.core_to_defs_refs.get(core_mode_ref)
-        if maybe_defs_ref is not None:
-            json_ref = self.core_to_json_refs[core_mode_ref]
-            return maybe_defs_ref, {'$ref': json_ref}
-
-        defs_ref = self.get_defs_ref(core_mode_ref)
-
-        # populate the ref translation mappings
-        self.core_to_defs_refs[core_mode_ref] = defs_ref
-        self.defs_to_core_refs[defs_ref] = core_mode_ref
-
-        json_ref = JsonRef(self.ref_template.format(model=defs_ref))
-        self.core_to_json_refs[core_mode_ref] = json_ref
-        self.json_to_defs_refs[json_ref] = defs_ref
-        ref_json_schema = {'$ref': json_ref}
-        return defs_ref, ref_json_schema
-
-    def handle_ref_overrides(self, json_schema: JsonSchemaValue) -> JsonSchemaValue:
-        """It is not valid for a schema with a top-level $ref to have sibling keys.
-
-        During our own schema generation, we treat sibling keys as overrides to the referenced schema,
-        but this is not how the official JSON schema spec works.
-
-        Because of this, we first remove any sibling keys that are redundant with the referenced schema, then if
-        any remain, we transform the schema from a top-level '$ref' to use allOf to move the $ref out of the top level.
-        (See bottom of https://swagger.io/docs/specification/using-ref/ for a reference about this behavior)
-        """
-        if '$ref' in json_schema:
-            # prevent modifications to the input; this copy may be safe to drop if there is significant overhead
-            json_schema = json_schema.copy()
-
-            referenced_json_schema = self.get_schema_from_definitions(JsonRef(json_schema['$ref']))
-            if referenced_json_schema is None:
-                # This can happen when building schemas for models with not-yet-defined references.
-                # It may be a good idea to do a recursive pass at the end of the generation to remove
-                # any redundant override keys.
-                if len(json_schema) > 1:
-                    # Make it an allOf to at least resolve the sibling keys issue
-                    json_schema = json_schema.copy()
-                    json_schema.setdefault('allOf', [])
-                    json_schema['allOf'].append({'$ref': json_schema['$ref']})
-                    del json_schema['$ref']
-
-                return json_schema
-            for k, v in list(json_schema.items()):
-                if k == '$ref':
-                    continue
-                if k in referenced_json_schema and referenced_json_schema[k] == v:
-                    del json_schema[k]  # redundant key
-            if len(json_schema) > 1:
-                # There is a remaining "override" key, so we need to move $ref out of the top level
-                json_ref = JsonRef(json_schema['$ref'])
-                del json_schema['$ref']
-                assert 'allOf' not in json_schema  # this should never happen, but just in case
-                json_schema['allOf'] = [{'$ref': json_ref}]
-
-        return json_schema
-
-    def get_schema_from_definitions(self, json_ref: JsonRef) -> JsonSchemaValue | None:
-        def_ref = self.json_to_defs_refs[json_ref]
-        if def_ref in self._core_defs_invalid_for_json_schema:
-            raise self._core_defs_invalid_for_json_schema[def_ref]
-        return self.definitions.get(def_ref, None)
-
-    def encode_default(self, dft: Any) -> Any:
-        """Encode a default value to a JSON-serializable value.
-
-        This is used to encode default values for fields in the generated JSON schema.
-
-        Args:
-            dft: The default value to encode.
-
-        Returns:
-            The encoded default value.
-        """
-        config = self._config
-        return pydantic_core.to_jsonable_python(
-            dft,
-            timedelta_mode=config.ser_json_timedelta,
-            bytes_mode=config.ser_json_bytes,
-        )
-
-    def update_with_validations(
-        self, json_schema: JsonSchemaValue, core_schema: CoreSchema, mapping: dict[str, str]
-    ) -> None:
-        """Update the json_schema with the corresponding validations specified in the core_schema,
-        using the provided mapping to translate keys in core_schema to the appropriate keys for a JSON schema.
-
-        Args:
-            json_schema: The JSON schema to update.
-            core_schema: The core schema to get the validations from.
-            mapping: A mapping from core_schema attribute names to the corresponding JSON schema attribute names.
-        """
-        for core_key, json_schema_key in mapping.items():
-            if core_key in core_schema:
-                json_schema[json_schema_key] = core_schema[core_key]
-
-    class ValidationsMapping:
-        """This class just contains mappings from core_schema attribute names to the corresponding
-        JSON schema attribute names. While I suspect it is unlikely to be necessary, you can in
-        principle override this class in a subclass of GenerateJsonSchema (by inheriting from
-        GenerateJsonSchema.ValidationsMapping) to change these mappings.
-        """
-
-        numeric = {
-            'multiple_of': 'multipleOf',
-            'le': 'maximum',
-            'ge': 'minimum',
-            'lt': 'exclusiveMaximum',
-            'gt': 'exclusiveMinimum',
-        }
-        bytes = {
-            'min_length': 'minLength',
-            'max_length': 'maxLength',
-        }
-        string = {
-            'min_length': 'minLength',
-            'max_length': 'maxLength',
-            'pattern': 'pattern',
-        }
-        array = {
-            'min_length': 'minItems',
-            'max_length': 'maxItems',
-        }
-        object = {
-            'min_length': 'minProperties',
-            'max_length': 'maxProperties',
-        }
-        date = {
-            'le': 'maximum',
-            'ge': 'minimum',
-            'lt': 'exclusiveMaximum',
-            'gt': 'exclusiveMinimum',
-        }
-
-    def get_flattened_anyof(self, schemas: list[JsonSchemaValue]) -> JsonSchemaValue:
-        members = []
-        for schema in schemas:
-            if len(schema) == 1 and 'anyOf' in schema:
-                members.extend(schema['anyOf'])
-            else:
-                members.append(schema)
-        members = _deduplicate_schemas(members)
-        if len(members) == 1:
-            return members[0]
-        return {'anyOf': members}
-
-    def get_json_ref_counts(self, json_schema: JsonSchemaValue) -> dict[JsonRef, int]:
-        """Get all values corresponding to the key '$ref' anywhere in the json_schema."""
-        json_refs: dict[JsonRef, int] = Counter()
-
-        def _add_json_refs(schema: Any) -> None:
-            if isinstance(schema, dict):
-                if '$ref' in schema:
-                    json_ref = JsonRef(schema['$ref'])
-                    if not isinstance(json_ref, str):
-                        return  # in this case, '$ref' might have been the name of a property
-                    already_visited = json_ref in json_refs
-                    json_refs[json_ref] += 1
-                    if already_visited:
-                        return  # prevent recursion on a definition that was already visited
-                    defs_ref = self.json_to_defs_refs[json_ref]
-                    if defs_ref in self._core_defs_invalid_for_json_schema:
-                        raise self._core_defs_invalid_for_json_schema[defs_ref]
-                    _add_json_refs(self.definitions[defs_ref])
-
-                for v in schema.values():
-                    _add_json_refs(v)
-            elif isinstance(schema, list):
-                for v in schema:
-                    _add_json_refs(v)
-
-        _add_json_refs(json_schema)
-        return json_refs
-
-    def handle_invalid_for_json_schema(self, schema: CoreSchemaOrField, error_info: str) -> JsonSchemaValue:
-        raise PydanticInvalidForJsonSchema(f'Cannot generate a JsonSchema for {error_info}')
-
-    def emit_warning(self, kind: JsonSchemaWarningKind, detail: str) -> None:
-        """This method simply emits PydanticJsonSchemaWarnings based on handling in the `warning_message` method."""
-        message = self.render_warning_message(kind, detail)
-        if message is not None:
-            warnings.warn(message, PydanticJsonSchemaWarning)
-
-    def render_warning_message(self, kind: JsonSchemaWarningKind, detail: str) -> str | None:
-        """This method is responsible for ignoring warnings as desired, and for formatting the warning messages.
-
-        You can override the value of `ignored_warning_kinds` in a subclass of GenerateJsonSchema
-        to modify what warnings are generated. If you want more control, you can override this method;
-        just return None in situations where you don't want warnings to be emitted.
-
-        Args:
-            kind: The kind of warning to render. It can be one of the following:
-
-                - 'skipped-choice': A choice field was skipped because it had no valid choices.
-                - 'non-serializable-default': A default value was skipped because it was not JSON-serializable.
-            detail: A string with additional details about the warning.
-
-        Returns:
-            The formatted warning message, or `None` if no warning should be emitted.
-        """
-        if kind in self.ignored_warning_kinds:
-            return None
-        return f'{detail} [{kind}]'
-
-    def _build_definitions_remapping(self) -> _DefinitionsRemapping:
-        defs_to_json: dict[DefsRef, JsonRef] = {}
-        for defs_refs in self._prioritized_defsref_choices.values():
-            for defs_ref in defs_refs:
-                json_ref = JsonRef(self.ref_template.format(model=defs_ref))
-                defs_to_json[defs_ref] = json_ref
-
-        return _DefinitionsRemapping.from_prioritized_choices(
-            self._prioritized_defsref_choices, defs_to_json, self.definitions
-        )
-
-    def _garbage_collect_definitions(self, schema: JsonSchemaValue) -> None:
-        visited_defs_refs: set[DefsRef] = set()
-        unvisited_json_refs = _get_all_json_refs(schema)
-        while unvisited_json_refs:
-            next_json_ref = unvisited_json_refs.pop()
-            next_defs_ref = self.json_to_defs_refs[next_json_ref]
-            if next_defs_ref in visited_defs_refs:
-                continue
-            visited_defs_refs.add(next_defs_ref)
-            unvisited_json_refs.update(_get_all_json_refs(self.definitions[next_defs_ref]))
-
-        self.definitions = {k: v for k, v in self.definitions.items() if k in visited_defs_refs}
-
-
-# ##### Start JSON Schema Generation Functions #####
-
-
-def model_json_schema(
-    cls: type[BaseModel] | type[PydanticDataclass],
-    by_alias: bool = True,
-    ref_template: str = DEFAULT_REF_TEMPLATE,
-    schema_generator: type[GenerateJsonSchema] = GenerateJsonSchema,
-    mode: JsonSchemaMode = 'validation',
-) -> dict[str, Any]:
-    """Utility function to generate a JSON Schema for a model.
-
-    Args:
-        cls: The model class to generate a JSON Schema for.
-        by_alias: If `True` (the default), fields will be serialized according to their alias.
-            If `False`, fields will be serialized according to their attribute name.
-        ref_template: The template to use for generating JSON Schema references.
-        schema_generator: The class to use for generating the JSON Schema.
-        mode: The mode to use for generating the JSON Schema. It can be one of the following:
-
-            - 'validation': Generate a JSON Schema for validating data.
-            - 'serialization': Generate a JSON Schema for serializing data.
-
-    Returns:
-        The generated JSON Schema.
-    """
-    schema_generator_instance = schema_generator(by_alias=by_alias, ref_template=ref_template)
-    if isinstance(cls.__pydantic_validator__, _mock_val_ser.MockValSer):
-        cls.__pydantic_validator__.rebuild()
-    assert '__pydantic_core_schema__' in cls.__dict__, 'this is a bug! please report it'
-    return schema_generator_instance.generate(cls.__pydantic_core_schema__, mode=mode)
-
-
-def models_json_schema(
-    models: Sequence[tuple[type[BaseModel] | type[PydanticDataclass], JsonSchemaMode]],
-    *,
-    by_alias: bool = True,
-    title: str | None = None,
-    description: str | None = None,
-    ref_template: str = DEFAULT_REF_TEMPLATE,
-    schema_generator: type[GenerateJsonSchema] = GenerateJsonSchema,
-) -> tuple[dict[tuple[type[BaseModel] | type[PydanticDataclass], JsonSchemaMode], JsonSchemaValue], JsonSchemaValue]:
-    """Utility function to generate a JSON Schema for multiple models.
-
-    Args:
-        models: A sequence of tuples of the form (model, mode).
-        by_alias: Whether field aliases should be used as keys in the generated JSON Schema.
-        title: The title of the generated JSON Schema.
-        description: The description of the generated JSON Schema.
-        ref_template: The reference template to use for generating JSON Schema references.
-        schema_generator: The schema generator to use for generating the JSON Schema.
-
-    Returns:
-        A tuple where:
-            - The first element is a dictionary whose keys are tuples of JSON schema key type and JSON mode, and
-                whose values are the JSON schema corresponding to that pair of inputs. (These schemas may have
-                JsonRef references to definitions that are defined in the second returned element.)
-            - The second element is a JSON schema containing all definitions referenced in the first returned
-                    element, along with the optional title and description keys.
-    """
-    for cls, _ in models:
-        if isinstance(cls.__pydantic_validator__, _mock_val_ser.MockValSer):
-            cls.__pydantic_validator__.rebuild()
-
-    instance = schema_generator(by_alias=by_alias, ref_template=ref_template)
-    inputs = [(m, mode, m.__pydantic_core_schema__) for m, mode in models]
-    json_schemas_map, definitions = instance.generate_definitions(inputs)
-
-    json_schema: dict[str, Any] = {}
-    if definitions:
-        json_schema['$defs'] = definitions
-    if title:
-        json_schema['title'] = title
-    if description:
-        json_schema['description'] = description
-
-    return json_schemas_map, json_schema
-
-
-# ##### End JSON Schema Generation Functions #####
-
-
-_HashableJsonValue: TypeAlias = Union[
-    int, float, str, bool, None, Tuple['_HashableJsonValue', ...], Tuple[Tuple[str, '_HashableJsonValue'], ...]
-]
-
-
-def _deduplicate_schemas(schemas: Iterable[JsonDict]) -> list[JsonDict]:
-    return list({_make_json_hashable(schema): schema for schema in schemas}.values())
-
-
-def _make_json_hashable(value: JsonValue) -> _HashableJsonValue:
-    if isinstance(value, dict):
-        return tuple(sorted((k, _make_json_hashable(v)) for k, v in value.items()))
-    elif isinstance(value, list):
-        return tuple(_make_json_hashable(v) for v in value)
-    else:
-        return value
-
-
-def _sort_json_schema(value: JsonSchemaValue, parent_key: str | None = None) -> JsonSchemaValue:
-    if isinstance(value, dict):
-        sorted_dict: dict[str, JsonSchemaValue] = {}
-        keys = value.keys()
-        if (parent_key != 'properties') and (parent_key != 'default'):
-            keys = sorted(keys)
-        for key in keys:
-            sorted_dict[key] = _sort_json_schema(value[key], parent_key=key)
-        return sorted_dict
-    elif isinstance(value, list):
-        sorted_list: list[JsonSchemaValue] = []
-        for item in value:  # type: ignore
-            sorted_list.append(_sort_json_schema(item, parent_key))
-        return sorted_list  # type: ignore
-    else:
-        return value
-
-
-@dataclasses.dataclass(**_internal_dataclass.slots_true)
-class WithJsonSchema:
-    """Usage docs: https://docs.pydantic.dev/2.6/concepts/json_schema/#withjsonschema-annotation
-
-    Add this as an annotation on a field to override the (base) JSON schema that would be generated for that field.
-    This provides a way to set a JSON schema for types that would otherwise raise errors when producing a JSON schema,
-    such as Callable, or types that have an is-instance core schema, without needing to go so far as creating a
-    custom subclass of pydantic.json_schema.GenerateJsonSchema.
-    Note that any _modifications_ to the schema that would normally be made (such as setting the title for model fields)
-    will still be performed.
-
-    If `mode` is set this will only apply to that schema generation mode, allowing you
-    to set different json schemas for validation and serialization.
-    """
-
-    json_schema: JsonSchemaValue | None
-    mode: Literal['validation', 'serialization'] | None = None
-
-    def __get_pydantic_json_schema__(
-        self, core_schema: core_schema.CoreSchema, handler: GetJsonSchemaHandler
-    ) -> JsonSchemaValue:
-        mode = self.mode or handler.mode
-        if mode != handler.mode:
-            return handler(core_schema)
-        if self.json_schema is None:
-            # This exception is handled in pydantic.json_schema.GenerateJsonSchema._named_required_fields_schema
-            raise PydanticOmit
-        else:
-            return self.json_schema
-
-    def __hash__(self) -> int:
-        return hash(type(self.mode))
-
-
-@dataclasses.dataclass(**_internal_dataclass.slots_true)
-class Examples:
-    """Add examples to a JSON schema.
-
-    Examples should be a map of example names (strings)
-    to example values (any valid JSON).
-
-    If `mode` is set this will only apply to that schema generation mode,
-    allowing you to add different examples for validation and serialization.
-    """
-
-    examples: dict[str, Any]
-    mode: Literal['validation', 'serialization'] | None = None
-
-    def __get_pydantic_json_schema__(
-        self, core_schema: core_schema.CoreSchema, handler: GetJsonSchemaHandler
-    ) -> JsonSchemaValue:
-        mode = self.mode or handler.mode
-        json_schema = handler(core_schema)
-        if mode != handler.mode:
-            return json_schema
-        examples = json_schema.get('examples', {})
-        examples.update(to_jsonable_python(self.examples))
-        json_schema['examples'] = examples
-        return json_schema
-
-    def __hash__(self) -> int:
-        return hash(type(self.mode))
-
-
-def _get_all_json_refs(item: Any) -> set[JsonRef]:
-    """Get all the definitions references from a JSON schema."""
-    refs: set[JsonRef] = set()
-    if isinstance(item, dict):
-        for key, value in item.items():
-            if key == '$ref' and isinstance(value, str):
-                # the isinstance check ensures that '$ref' isn't the name of a property, etc.
-                refs.add(JsonRef(value))
-            elif isinstance(value, dict):
-                refs.update(_get_all_json_refs(value))
-            elif isinstance(value, list):
-                for item in value:
-                    refs.update(_get_all_json_refs(item))
-    elif isinstance(item, list):
-        for item in item:
-            refs.update(_get_all_json_refs(item))
-    return refs
-
-
-AnyType = TypeVar('AnyType')
-
-if TYPE_CHECKING:
-    SkipJsonSchema = Annotated[AnyType, ...]
-else:
-
-    @dataclasses.dataclass(**_internal_dataclass.slots_true)
-    class SkipJsonSchema:
-        """Usage docs: https://docs.pydantic.dev/2.6/concepts/json_schema/#skipjsonschema-annotation
-
-        Add this as an annotation on a field to skip generating a JSON schema for that field.
-
-        Example:
-            ```py
-            from typing import Union
-
-            from pydantic import BaseModel
-            from pydantic.json_schema import SkipJsonSchema
-
-            from pprint import pprint
-
-
-            class Model(BaseModel):
-                a: Union[int, None] = None  # (1)!
-                b: Union[int, SkipJsonSchema[None]] = None  # (2)!
-                c: SkipJsonSchema[Union[int, None]] = None  # (3)!
-
-
-            pprint(Model.model_json_schema())
-            '''
-            {
-                'properties': {
-                    'a': {
-                        'anyOf': [
-                            {'type': 'integer'},
-                            {'type': 'null'}
-                        ],
-                        'default': None,
-                        'title': 'A'
-                    },
-                    'b': {
-                        'default': None,
-                        'title': 'B',
-                        'type': 'integer'
-                    }
-                },
-                'title': 'Model',
-                'type': 'object'
-            }
-            '''
-            ```
-
-            1. The integer and null types are both included in the schema for `a`.
-            2. The integer type is the only type included in the schema for `b`.
-            3. The entirety of the `c` field is omitted from the schema.
-        """
-
-        def __class_getitem__(cls, item: AnyType) -> AnyType:
-            return Annotated[item, cls()]
-
-        def __get_pydantic_json_schema__(
-            self, core_schema: CoreSchema, handler: GetJsonSchemaHandler
-        ) -> JsonSchemaValue:
-            raise PydanticOmit
-
-        def __hash__(self) -> int:
-            return hash(type(self))
-
-
-def _get_typed_dict_config(schema: core_schema.TypedDictSchema) -> ConfigDict:
-    metadata = _core_metadata.CoreMetadataHandler(schema).metadata
-    cls = metadata.get('pydantic_typed_dict_cls')
-    if cls is not None:
-        try:
-            return _decorators.get_attribute_from_bases(cls, '__pydantic_config__')
-        except AttributeError:
-            pass
-    return {}
diff --git a/lib/pydantic/main.py b/lib/pydantic/main.py
index 8c7ebbbf..69f3b751 100644
--- a/lib/pydantic/main.py
+++ b/lib/pydantic/main.py
@@ -1,1434 +1,980 @@
-"""Logic for creating models."""
-from __future__ import annotations as _annotations
-
-import operator
-import sys
-import types
-import typing
 import warnings
-from copy import copy, deepcopy
-from typing import Any, ClassVar
-
-import pydantic_core
-import typing_extensions
-from pydantic_core import PydanticUndefined
-
-from ._internal import (
-    _config,
-    _decorators,
-    _fields,
-    _forward_ref,
-    _generics,
-    _mock_val_ser,
-    _model_construction,
-    _repr,
-    _typing_extra,
-    _utils,
+from abc import ABCMeta
+from copy import deepcopy
+from enum import Enum
+from functools import partial
+from pathlib import Path
+from types import FunctionType, prepare_class, resolve_bases
+from typing import (
+    TYPE_CHECKING,
+    AbstractSet,
+    Any,
+    Callable,
+    ClassVar,
+    Dict,
+    List,
+    Mapping,
+    Optional,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+    cast,
+    no_type_check,
+    overload,
 )
-from ._migration import getattr_migration
-from .annotated_handlers import GetCoreSchemaHandler, GetJsonSchemaHandler
-from .config import ConfigDict
-from .errors import PydanticUndefinedAnnotation, PydanticUserError
-from .json_schema import DEFAULT_REF_TEMPLATE, GenerateJsonSchema, JsonSchemaMode, JsonSchemaValue, model_json_schema
-from .warnings import PydanticDeprecatedSince20
 
-if typing.TYPE_CHECKING:
+from typing_extensions import dataclass_transform
+
+from .class_validators import ValidatorGroup, extract_root_validators, extract_validators, inherit_validators
+from .config import BaseConfig, Extra, inherit_config, prepare_config
+from .error_wrappers import ErrorWrapper, ValidationError
+from .errors import ConfigError, DictError, ExtraError, MissingError
+from .fields import (
+    MAPPING_LIKE_SHAPES,
+    Field,
+    FieldInfo,
+    ModelField,
+    ModelPrivateAttr,
+    PrivateAttr,
+    Undefined,
+    is_finalvar_with_default_val,
+)
+from .json import custom_pydantic_encoder, pydantic_encoder
+from .parse import Protocol, load_file, load_str_bytes
+from .schema import default_ref_template, model_schema
+from .types import PyObject, StrBytes
+from .typing import (
+    AnyCallable,
+    get_args,
+    get_origin,
+    is_classvar,
+    is_namedtuple,
+    is_union,
+    resolve_annotations,
+    update_model_forward_refs,
+)
+from .utils import (
+    DUNDER_ATTRIBUTES,
+    ROOT_KEY,
+    ClassAttribute,
+    GetterDict,
+    Representation,
+    ValueItems,
+    generate_model_signature,
+    is_valid_field,
+    is_valid_private_name,
+    lenient_issubclass,
+    sequence_like,
+    smart_deepcopy,
+    unique_list,
+    validate_field_name,
+)
+
+if TYPE_CHECKING:
     from inspect import Signature
-    from pathlib import Path
 
-    from pydantic_core import CoreSchema, SchemaSerializer, SchemaValidator
-    from typing_extensions import Literal, Unpack
-
-    from ._internal._utils import AbstractSetIntStr, MappingIntStrAny
-    from .deprecated.parse import Protocol as DeprecatedParseProtocol
-    from .fields import ComputedFieldInfo, FieldInfo, ModelPrivateAttr
-    from .fields import Field as _Field
-
-    TupleGenerator = typing.Generator[typing.Tuple[str, Any], None, None]
-    Model = typing.TypeVar('Model', bound='BaseModel')
-    # should be `set[int] | set[str] | dict[int, IncEx] | dict[str, IncEx] | None`, but mypy can't cope
-    IncEx: typing_extensions.TypeAlias = 'set[int] | set[str] | dict[int, Any] | dict[str, Any] | None'
-else:
-    # See PyCharm issues https://youtrack.jetbrains.com/issue/PY-21915
-    # and https://youtrack.jetbrains.com/issue/PY-51428
-    DeprecationWarning = PydanticDeprecatedSince20
-
-__all__ = 'BaseModel', 'create_model'
-
-_object_setattr = _model_construction.object_setattr
-
-
-class BaseModel(metaclass=_model_construction.ModelMetaclass):
-    """Usage docs: https://docs.pydantic.dev/2.6/concepts/models/
-
-    A base class for creating Pydantic models.
-
-    Attributes:
-        __class_vars__: The names of classvars defined on the model.
-        __private_attributes__: Metadata about the private attributes of the model.
-        __signature__: The signature for instantiating the model.
-
-        __pydantic_complete__: Whether model building is completed, or if there are still undefined fields.
-        __pydantic_core_schema__: The pydantic-core schema used to build the SchemaValidator and SchemaSerializer.
-        __pydantic_custom_init__: Whether the model has a custom `__init__` function.
-        __pydantic_decorators__: Metadata containing the decorators defined on the model.
-            This replaces `Model.__validators__` and `Model.__root_validators__` from Pydantic V1.
-        __pydantic_generic_metadata__: Metadata for generic models; contains data used for a similar purpose to
-            __args__, __origin__, __parameters__ in typing-module generics. May eventually be replaced by these.
-        __pydantic_parent_namespace__: Parent namespace of the model, used for automatic rebuilding of models.
-        __pydantic_post_init__: The name of the post-init method for the model, if defined.
-        __pydantic_root_model__: Whether the model is a `RootModel`.
-        __pydantic_serializer__: The pydantic-core SchemaSerializer used to dump instances of the model.
-        __pydantic_validator__: The pydantic-core SchemaValidator used to validate instances of the model.
-
-        __pydantic_extra__: An instance attribute with the values of extra fields from validation when
-            `model_config['extra'] == 'allow'`.
-        __pydantic_fields_set__: An instance attribute with the names of fields explicitly set.
-        __pydantic_private__: Instance attribute with the values of private attributes set on the model instance.
-    """
-
-    if typing.TYPE_CHECKING:
-        # Here we provide annotations for the attributes of BaseModel.
-        # Many of these are populated by the metaclass, which is why this section is in a `TYPE_CHECKING` block.
-        # However, for the sake of easy review, we have included type annotations of all class and instance attributes
-        # of `BaseModel` here:
-
-        # Class attributes
-        model_config: ClassVar[ConfigDict]
-        """
-        Configuration for the model, should be a dictionary conforming to [`ConfigDict`][pydantic.config.ConfigDict].
-        """
-
-        model_fields: ClassVar[dict[str, FieldInfo]]
-        """
-        Metadata about the fields defined on the model,
-        mapping of field names to [`FieldInfo`][pydantic.fields.FieldInfo].
-
-        This replaces `Model.__fields__` from Pydantic V1.
-        """
-
-        model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]]
-        """A dictionary of computed field names and their corresponding `ComputedFieldInfo` objects."""
-
-        __class_vars__: ClassVar[set[str]]
-        __private_attributes__: ClassVar[dict[str, ModelPrivateAttr]]
-        __signature__: ClassVar[Signature]
-
-        __pydantic_complete__: ClassVar[bool]
-        __pydantic_core_schema__: ClassVar[CoreSchema]
-        __pydantic_custom_init__: ClassVar[bool]
-        __pydantic_decorators__: ClassVar[_decorators.DecoratorInfos]
-        __pydantic_generic_metadata__: ClassVar[_generics.PydanticGenericMetadata]
-        __pydantic_parent_namespace__: ClassVar[dict[str, Any] | None]
-        __pydantic_post_init__: ClassVar[None | Literal['model_post_init']]
-        __pydantic_root_model__: ClassVar[bool]
-        __pydantic_serializer__: ClassVar[SchemaSerializer]
-        __pydantic_validator__: ClassVar[SchemaValidator]
-
-        # Instance attributes
-        # Note: we use the non-existent kwarg `init=False` in pydantic.fields.Field below so that @dataclass_transform
-        # doesn't think these are valid as keyword arguments to the class initializer.
-        __pydantic_extra__: dict[str, Any] | None = _Field(init=False)  # type: ignore
-        __pydantic_fields_set__: set[str] = _Field(init=False)  # type: ignore
-        __pydantic_private__: dict[str, Any] | None = _Field(init=False)  # type: ignore
-
-    else:
-        # `model_fields` and `__pydantic_decorators__` must be set for
-        # pydantic._internal._generate_schema.GenerateSchema.model_schema to work for a plain BaseModel annotation
-        model_fields = {}
-        model_computed_fields = {}
-
-        __pydantic_decorators__ = _decorators.DecoratorInfos()
-        __pydantic_parent_namespace__ = None
-        # Prevent `BaseModel` from being instantiated directly:
-        __pydantic_validator__ = _mock_val_ser.MockValSer(
-            'Pydantic models should inherit from BaseModel, BaseModel cannot be instantiated directly',
-            val_or_ser='validator',
-            code='base-model-instantiated',
-        )
-        __pydantic_serializer__ = _mock_val_ser.MockValSer(
-            'Pydantic models should inherit from BaseModel, BaseModel cannot be instantiated directly',
-            val_or_ser='serializer',
-            code='base-model-instantiated',
-        )
-
-    __slots__ = '__dict__', '__pydantic_fields_set__', '__pydantic_extra__', '__pydantic_private__'
-
-    model_config = ConfigDict()
-    __pydantic_complete__ = False
-    __pydantic_root_model__ = False
-
-    def __init__(self, /, **data: Any) -> None:  # type: ignore
-        """Create a new model by parsing and validating input data from keyword arguments.
-
-        Raises [`ValidationError`][pydantic_core.ValidationError] if the input data cannot be
-        validated to form a valid model.
-
-        `self` is explicitly positional-only to allow `self` as a field name.
-        """
-        # `__tracebackhide__` tells pytest and some other tools to omit this function from tracebacks
-        __tracebackhide__ = True
-        self.__pydantic_validator__.validate_python(data, self_instance=self)
-
-    # The following line sets a flag that we use to determine when `__init__` gets overridden by the user
-    __init__.__pydantic_base_init__ = True  # pyright: ignore[reportFunctionMemberAccess]
-
-    @property
-    def model_extra(self) -> dict[str, Any] | None:
-        """Get extra fields set during validation.
-
-        Returns:
-            A dictionary of extra fields, or `None` if `config.extra` is not set to `"allow"`.
-        """
-        return self.__pydantic_extra__
-
-    @property
-    def model_fields_set(self) -> set[str]:
-        """Returns the set of fields that have been explicitly set on this model instance.
-
-        Returns:
-            A set of strings representing the fields that have been set,
-                i.e. that were not filled from defaults.
-        """
-        return self.__pydantic_fields_set__
-
-    @classmethod
-    def model_construct(cls: type[Model], _fields_set: set[str] | None = None, **values: Any) -> Model:
-        """Creates a new instance of the `Model` class with validated data.
-
-        Creates a new model setting `__dict__` and `__pydantic_fields_set__` from trusted or pre-validated data.
-        Default values are respected, but no other validation is performed.
-        Behaves as if `Config.extra = 'allow'` was set since it adds all passed values
-
-        Args:
-            _fields_set: The set of field names accepted for the Model instance.
-            values: Trusted or pre-validated data dictionary.
-
-        Returns:
-            A new instance of the `Model` class with validated data.
-        """
-        m = cls.__new__(cls)
-        fields_values: dict[str, Any] = {}
-        fields_set = set()
-
-        for name, field in cls.model_fields.items():
-            if field.alias and field.alias in values:
-                fields_values[name] = values.pop(field.alias)
-                fields_set.add(name)
-            elif name in values:
-                fields_values[name] = values.pop(name)
-                fields_set.add(name)
-            elif not field.is_required():
-                fields_values[name] = field.get_default(call_default_factory=True)
-        if _fields_set is None:
-            _fields_set = fields_set
-
-        _extra: dict[str, Any] | None = None
-        if cls.model_config.get('extra') == 'allow':
-            _extra = {}
-            for k, v in values.items():
-                _extra[k] = v
-        else:
-            fields_values.update(values)
-        _object_setattr(m, '__dict__', fields_values)
-        _object_setattr(m, '__pydantic_fields_set__', _fields_set)
-        if not cls.__pydantic_root_model__:
-            _object_setattr(m, '__pydantic_extra__', _extra)
-
-        if cls.__pydantic_post_init__:
-            m.model_post_init(None)
-            # update private attributes with values set
-            if hasattr(m, '__pydantic_private__') and m.__pydantic_private__ is not None:
-                for k, v in values.items():
-                    if k in m.__private_attributes__:
-                        m.__pydantic_private__[k] = v
-
-        elif not cls.__pydantic_root_model__:
-            # Note: if there are any private attributes, cls.__pydantic_post_init__ would exist
-            # Since it doesn't, that means that `__pydantic_private__` should be set to None
-            _object_setattr(m, '__pydantic_private__', None)
-
-        return m
-
-    def model_copy(self: Model, *, update: dict[str, Any] | None = None, deep: bool = False) -> Model:
-        """Usage docs: https://docs.pydantic.dev/2.6/concepts/serialization/#model_copy
-
-        Returns a copy of the model.
-
-        Args:
-            update: Values to change/add in the new model. Note: the data is not validated
-                before creating the new model. You should trust this data.
-            deep: Set to `True` to make a deep copy of the model.
-
-        Returns:
-            New model instance.
-        """
-        copied = self.__deepcopy__() if deep else self.__copy__()
-        if update:
-            if self.model_config.get('extra') == 'allow':
-                for k, v in update.items():
-                    if k in self.model_fields:
-                        copied.__dict__[k] = v
-                    else:
-                        if copied.__pydantic_extra__ is None:
-                            copied.__pydantic_extra__ = {}
-                        copied.__pydantic_extra__[k] = v
-            else:
-                copied.__dict__.update(update)
-            copied.__pydantic_fields_set__.update(update.keys())
-        return copied
-
-    def model_dump(
-        self,
-        *,
-        mode: Literal['json', 'python'] | str = 'python',
-        include: IncEx = None,
-        exclude: IncEx = None,
-        by_alias: bool = False,
-        exclude_unset: bool = False,
-        exclude_defaults: bool = False,
-        exclude_none: bool = False,
-        round_trip: bool = False,
-        warnings: bool = True,
-    ) -> dict[str, Any]:
-        """Usage docs: https://docs.pydantic.dev/2.6/concepts/serialization/#modelmodel_dump
-
-        Generate a dictionary representation of the model, optionally specifying which fields to include or exclude.
-
-        Args:
-            mode: The mode in which `to_python` should run.
-                If mode is 'json', the output will only contain JSON serializable types.
-                If mode is 'python', the output may contain non-JSON-serializable Python objects.
-            include: A list of fields to include in the output.
-            exclude: A list of fields to exclude from the output.
-            by_alias: Whether to use the field's alias in the dictionary key if defined.
-            exclude_unset: Whether to exclude fields that have not been explicitly set.
-            exclude_defaults: Whether to exclude fields that are set to their default value.
-            exclude_none: Whether to exclude fields that have a value of `None`.
-            round_trip: If True, dumped values should be valid as input for non-idempotent types such as Json[T].
-            warnings: Whether to log warnings when invalid fields are encountered.
-
-        Returns:
-            A dictionary representation of the model.
-        """
-        return self.__pydantic_serializer__.to_python(
-            self,
-            mode=mode,
-            by_alias=by_alias,
-            include=include,
-            exclude=exclude,
-            exclude_unset=exclude_unset,
-            exclude_defaults=exclude_defaults,
-            exclude_none=exclude_none,
-            round_trip=round_trip,
-            warnings=warnings,
-        )
-
-    def model_dump_json(
-        self,
-        *,
-        indent: int | None = None,
-        include: IncEx = None,
-        exclude: IncEx = None,
-        by_alias: bool = False,
-        exclude_unset: bool = False,
-        exclude_defaults: bool = False,
-        exclude_none: bool = False,
-        round_trip: bool = False,
-        warnings: bool = True,
-    ) -> str:
-        """Usage docs: https://docs.pydantic.dev/2.6/concepts/serialization/#modelmodel_dump_json
-
-        Generates a JSON representation of the model using Pydantic's `to_json` method.
-
-        Args:
-            indent: Indentation to use in the JSON output. If None is passed, the output will be compact.
-            include: Field(s) to include in the JSON output.
-            exclude: Field(s) to exclude from the JSON output.
-            by_alias: Whether to serialize using field aliases.
-            exclude_unset: Whether to exclude fields that have not been explicitly set.
-            exclude_defaults: Whether to exclude fields that are set to their default value.
-            exclude_none: Whether to exclude fields that have a value of `None`.
-            round_trip: If True, dumped values should be valid as input for non-idempotent types such as Json[T].
-            warnings: Whether to log warnings when invalid fields are encountered.
-
-        Returns:
-            A JSON string representation of the model.
-        """
-        return self.__pydantic_serializer__.to_json(
-            self,
-            indent=indent,
-            include=include,
-            exclude=exclude,
-            by_alias=by_alias,
-            exclude_unset=exclude_unset,
-            exclude_defaults=exclude_defaults,
-            exclude_none=exclude_none,
-            round_trip=round_trip,
-            warnings=warnings,
-        ).decode()
-
-    @classmethod
-    def model_json_schema(
-        cls,
-        by_alias: bool = True,
-        ref_template: str = DEFAULT_REF_TEMPLATE,
-        schema_generator: type[GenerateJsonSchema] = GenerateJsonSchema,
-        mode: JsonSchemaMode = 'validation',
-    ) -> dict[str, Any]:
-        """Generates a JSON schema for a model class.
-
-        Args:
-            by_alias: Whether to use attribute aliases or not.
-            ref_template: The reference template.
-            schema_generator: To override the logic used to generate the JSON schema, as a subclass of
-                `GenerateJsonSchema` with your desired modifications
-            mode: The mode in which to generate the schema.
-
-        Returns:
-            The JSON schema for the given model class.
-        """
-        return model_json_schema(
-            cls, by_alias=by_alias, ref_template=ref_template, schema_generator=schema_generator, mode=mode
-        )
-
-    @classmethod
-    def model_parametrized_name(cls, params: tuple[type[Any], ...]) -> str:
-        """Compute the class name for parametrizations of generic classes.
-
-        This method can be overridden to achieve a custom naming scheme for generic BaseModels.
-
-        Args:
-            params: Tuple of types of the class. Given a generic class
-                `Model` with 2 type variables and a concrete model `Model[str, int]`,
-                the value `(str, int)` would be passed to `params`.
-
-        Returns:
-            String representing the new class where `params` are passed to `cls` as type variables.
-
-        Raises:
-            TypeError: Raised when trying to generate concrete names for non-generic models.
-        """
-        if not issubclass(cls, typing.Generic):
-            raise TypeError('Concrete names should only be generated for generic models.')
-
-        # Any strings received should represent forward references, so we handle them specially below.
-        # If we eventually move toward wrapping them in a ForwardRef in __class_getitem__ in the future,
-        # we may be able to remove this special case.
-        param_names = [param if isinstance(param, str) else _repr.display_as_type(param) for param in params]
-        params_component = ', '.join(param_names)
-        return f'{cls.__name__}[{params_component}]'
-
-    def model_post_init(self, __context: Any) -> None:
-        """Override this method to perform additional initialization after `__init__` and `model_construct`.
-        This is useful if you want to do some validation that requires the entire model to be initialized.
-        """
-        pass
-
-    @classmethod
-    def model_rebuild(
-        cls,
-        *,
-        force: bool = False,
-        raise_errors: bool = True,
-        _parent_namespace_depth: int = 2,
-        _types_namespace: dict[str, Any] | None = None,
-    ) -> bool | None:
-        """Try to rebuild the pydantic-core schema for the model.
-
-        This may be necessary when one of the annotations is a ForwardRef which could not be resolved during
-        the initial attempt to build the schema, and automatic rebuilding fails.
-
-        Args:
-            force: Whether to force the rebuilding of the model schema, defaults to `False`.
-            raise_errors: Whether to raise errors, defaults to `True`.
-            _parent_namespace_depth: The depth level of the parent namespace, defaults to 2.
-            _types_namespace: The types namespace, defaults to `None`.
-
-        Returns:
-            Returns `None` if the schema is already "complete" and rebuilding was not required.
-            If rebuilding _was_ required, returns `True` if rebuilding was successful, otherwise `False`.
-        """
-        if not force and cls.__pydantic_complete__:
-            return None
-        else:
-            if '__pydantic_core_schema__' in cls.__dict__:
-                delattr(cls, '__pydantic_core_schema__')  # delete cached value to ensure full rebuild happens
-            if _types_namespace is not None:
-                types_namespace: dict[str, Any] | None = _types_namespace.copy()
-            else:
-                if _parent_namespace_depth > 0:
-                    frame_parent_ns = _typing_extra.parent_frame_namespace(parent_depth=_parent_namespace_depth) or {}
-                    cls_parent_ns = (
-                        _model_construction.unpack_lenient_weakvaluedict(cls.__pydantic_parent_namespace__) or {}
+    from .class_validators import ValidatorListDict
+    from .types import ModelOrDc
+    from .typing import (
+        AbstractSetIntStr,
+        AnyClassMethod,
+        CallableGenerator,
+        DictAny,
+        DictStrAny,
+        MappingIntStrAny,
+        ReprArgs,
+        SetStr,
+        TupleGenerator,
+    )
+
+    Model = TypeVar('Model', bound='BaseModel')
+
+__all__ = 'BaseModel', 'create_model', 'validate_model'
+
+_T = TypeVar('_T')
+
+
+def validate_custom_root_type(fields: Dict[str, ModelField]) -> None:
+    if len(fields) > 1:
+        raise ValueError(f'{ROOT_KEY} cannot be mixed with other fields')
+
+
+def generate_hash_function(frozen: bool) -> Optional[Callable[[Any], int]]:
+    def hash_function(self_: Any) -> int:
+        return hash(self_.__class__) + hash(tuple(self_.__dict__.values()))
+
+    return hash_function if frozen else None
+
+
+# If a field is of type `Callable`, its default value should be a function and cannot to ignored.
+ANNOTATED_FIELD_UNTOUCHED_TYPES: Tuple[Any, ...] = (property, type, classmethod, staticmethod)
+# When creating a `BaseModel` instance, we bypass all the methods, properties... added to the model
+UNTOUCHED_TYPES: Tuple[Any, ...] = (FunctionType,) + ANNOTATED_FIELD_UNTOUCHED_TYPES
+# Note `ModelMetaclass` refers to `BaseModel`, but is also used to *create* `BaseModel`, so we need to add this extra
+# (somewhat hacky) boolean to keep track of whether we've created the `BaseModel` class yet, and therefore whether it's
+# safe to refer to it. If it *hasn't* been created, we assume that the `__new__` call we're in the middle of is for
+# the `BaseModel` class, since that's defined immediately after the metaclass.
+_is_base_model_class_defined = False
+
+
+@dataclass_transform(kw_only_default=True, field_descriptors=(Field, FieldInfo))
+class ModelMetaclass(ABCMeta):
+    @no_type_check  # noqa C901
+    def __new__(mcs, name, bases, namespace, **kwargs):  # noqa C901
+        fields: Dict[str, ModelField] = {}
+        config = BaseConfig
+        validators: 'ValidatorListDict' = {}
+
+        pre_root_validators, post_root_validators = [], []
+        private_attributes: Dict[str, ModelPrivateAttr] = {}
+        base_private_attributes: Dict[str, ModelPrivateAttr] = {}
+        slots: SetStr = namespace.get('__slots__', ())
+        slots = {slots} if isinstance(slots, str) else set(slots)
+        class_vars: SetStr = set()
+        hash_func: Optional[Callable[[Any], int]] = None
+
+        for base in reversed(bases):
+            if _is_base_model_class_defined and issubclass(base, BaseModel) and base != BaseModel:
+                fields.update(smart_deepcopy(base.__fields__))
+                config = inherit_config(base.__config__, config)
+                validators = inherit_validators(base.__validators__, validators)
+                pre_root_validators += base.__pre_root_validators__
+                post_root_validators += base.__post_root_validators__
+                base_private_attributes.update(base.__private_attributes__)
+                class_vars.update(base.__class_vars__)
+                hash_func = base.__hash__
+
+        resolve_forward_refs = kwargs.pop('__resolve_forward_refs__', True)
+        allowed_config_kwargs: SetStr = {
+            key
+            for key in dir(config)
+            if not (key.startswith('__') and key.endswith('__'))  # skip dunder methods and attributes
+        }
+        config_kwargs = {key: kwargs.pop(key) for key in kwargs.keys() & allowed_config_kwargs}
+        config_from_namespace = namespace.get('Config')
+        if config_kwargs and config_from_namespace:
+            raise TypeError('Specifying config in two places is ambiguous, use either Config attribute or class kwargs')
+        config = inherit_config(config_from_namespace, config, **config_kwargs)
+
+        validators = inherit_validators(extract_validators(namespace), validators)
+        vg = ValidatorGroup(validators)
+
+        for f in fields.values():
+            f.set_config(config)
+            extra_validators = vg.get_validators(f.name)
+            if extra_validators:
+                f.class_validators.update(extra_validators)
+                # re-run prepare to add extra validators
+                f.populate_validators()
+
+        prepare_config(config, name)
+
+        untouched_types = ANNOTATED_FIELD_UNTOUCHED_TYPES
+
+        def is_untouched(v: Any) -> bool:
+            return isinstance(v, untouched_types) or v.__class__.__name__ == 'cython_function_or_method'
+
+        if (namespace.get('__module__'), namespace.get('__qualname__')) != ('pydantic.main', 'BaseModel'):
+            annotations = resolve_annotations(namespace.get('__annotations__', {}), namespace.get('__module__', None))
+            # annotation only fields need to come first in fields
+            for ann_name, ann_type in annotations.items():
+                if is_classvar(ann_type):
+                    class_vars.add(ann_name)
+                elif is_finalvar_with_default_val(ann_type, namespace.get(ann_name, Undefined)):
+                    class_vars.add(ann_name)
+                elif is_valid_field(ann_name):
+                    validate_field_name(bases, ann_name)
+                    value = namespace.get(ann_name, Undefined)
+                    allowed_types = get_args(ann_type) if is_union(get_origin(ann_type)) else (ann_type,)
+                    if (
+                        is_untouched(value)
+                        and ann_type != PyObject
+                        and not any(
+                            lenient_issubclass(get_origin(allowed_type), Type) for allowed_type in allowed_types
+                        )
+                    ):
+                        continue
+                    fields[ann_name] = ModelField.infer(
+                        name=ann_name,
+                        value=value,
+                        annotation=ann_type,
+                        class_validators=vg.get_validators(ann_name),
+                        config=config,
                     )
-                    types_namespace = {**cls_parent_ns, **frame_parent_ns}
-                    cls.__pydantic_parent_namespace__ = _model_construction.build_lenient_weakvaluedict(types_namespace)
-                else:
-                    types_namespace = _model_construction.unpack_lenient_weakvaluedict(
-                        cls.__pydantic_parent_namespace__
+                elif ann_name not in namespace and config.underscore_attrs_are_private:
+                    private_attributes[ann_name] = PrivateAttr()
+
+            untouched_types = UNTOUCHED_TYPES + config.keep_untouched
+            for var_name, value in namespace.items():
+                can_be_changed = var_name not in class_vars and not is_untouched(value)
+                if isinstance(value, ModelPrivateAttr):
+                    if not is_valid_private_name(var_name):
+                        raise NameError(
+                            f'Private attributes "{var_name}" must not be a valid field name; '
+                            f'Use sunder or dunder names, e. g. "_{var_name}" or "__{var_name}__"'
+                        )
+                    private_attributes[var_name] = value
+                elif config.underscore_attrs_are_private and is_valid_private_name(var_name) and can_be_changed:
+                    private_attributes[var_name] = PrivateAttr(default=value)
+                elif is_valid_field(var_name) and var_name not in annotations and can_be_changed:
+                    validate_field_name(bases, var_name)
+                    inferred = ModelField.infer(
+                        name=var_name,
+                        value=value,
+                        annotation=annotations.get(var_name, Undefined),
+                        class_validators=vg.get_validators(var_name),
+                        config=config,
                     )
+                    if var_name in fields:
+                        if lenient_issubclass(inferred.type_, fields[var_name].type_):
+                            inferred.type_ = fields[var_name].type_
+                        else:
+                            raise TypeError(
+                                f'The type of {name}.{var_name} differs from the new default value; '
+                                f'if you wish to change the type of this field, please use a type annotation'
+                            )
+                    fields[var_name] = inferred
 
-                types_namespace = _typing_extra.get_cls_types_namespace(cls, types_namespace)
-
-            # manually override defer_build so complete_model_class doesn't skip building the model again
-            config = {**cls.model_config, 'defer_build': False}
-            return _model_construction.complete_model_class(
-                cls,
-                cls.__name__,
-                _config.ConfigWrapper(config, check=False),
-                raise_errors=raise_errors,
-                types_namespace=types_namespace,
-            )
-
-    @classmethod
-    def model_validate(
-        cls: type[Model],
-        obj: Any,
-        *,
-        strict: bool | None = None,
-        from_attributes: bool | None = None,
-        context: dict[str, Any] | None = None,
-    ) -> Model:
-        """Validate a pydantic model instance.
-
-        Args:
-            obj: The object to validate.
-            strict: Whether to enforce types strictly.
-            from_attributes: Whether to extract data from object attributes.
-            context: Additional context to pass to the validator.
-
-        Raises:
-            ValidationError: If the object could not be validated.
-
-        Returns:
-            The validated model instance.
-        """
-        # `__tracebackhide__` tells pytest and some other tools to omit this function from tracebacks
-        __tracebackhide__ = True
-        return cls.__pydantic_validator__.validate_python(
-            obj, strict=strict, from_attributes=from_attributes, context=context
-        )
-
-    @classmethod
-    def model_validate_json(
-        cls: type[Model],
-        json_data: str | bytes | bytearray,
-        *,
-        strict: bool | None = None,
-        context: dict[str, Any] | None = None,
-    ) -> Model:
-        """Usage docs: https://docs.pydantic.dev/2.6/concepts/json/#json-parsing
-
-        Validate the given JSON data against the Pydantic model.
-
-        Args:
-            json_data: The JSON data to validate.
-            strict: Whether to enforce types strictly.
-            context: Extra variables to pass to the validator.
-
-        Returns:
-            The validated Pydantic model.
-
-        Raises:
-            ValueError: If `json_data` is not a JSON string.
-        """
-        # `__tracebackhide__` tells pytest and some other tools to omit this function from tracebacks
-        __tracebackhide__ = True
-        return cls.__pydantic_validator__.validate_json(json_data, strict=strict, context=context)
-
-    @classmethod
-    def model_validate_strings(
-        cls: type[Model],
-        obj: Any,
-        *,
-        strict: bool | None = None,
-        context: dict[str, Any] | None = None,
-    ) -> Model:
-        """Validate the given object contains string data against the Pydantic model.
-
-        Args:
-            obj: The object contains string data to validate.
-            strict: Whether to enforce types strictly.
-            context: Extra variables to pass to the validator.
-
-        Returns:
-            The validated Pydantic model.
-        """
-        # `__tracebackhide__` tells pytest and some other tools to omit this function from tracebacks
-        __tracebackhide__ = True
-        return cls.__pydantic_validator__.validate_strings(obj, strict=strict, context=context)
-
-    @classmethod
-    def __get_pydantic_core_schema__(cls, __source: type[BaseModel], __handler: GetCoreSchemaHandler) -> CoreSchema:
-        """Hook into generating the model's CoreSchema.
-
-        Args:
-            __source: The class we are generating a schema for.
-                This will generally be the same as the `cls` argument if this is a classmethod.
-            __handler: Call into Pydantic's internal JSON schema generation.
-                A callable that calls into Pydantic's internal CoreSchema generation logic.
-
-        Returns:
-            A `pydantic-core` `CoreSchema`.
-        """
-        # Only use the cached value from this _exact_ class; we don't want one from a parent class
-        # This is why we check `cls.__dict__` and don't use `cls.__pydantic_core_schema__` or similar.
-        if '__pydantic_core_schema__' in cls.__dict__:
-            # Due to the way generic classes are built, it's possible that an invalid schema may be temporarily
-            # set on generic classes. I think we could resolve this to ensure that we get proper schema caching
-            # for generics, but for simplicity for now, we just always rebuild if the class has a generic origin.
-            if not cls.__pydantic_generic_metadata__['origin']:
-                return cls.__pydantic_core_schema__
-
-        return __handler(__source)
-
-    @classmethod
-    def __get_pydantic_json_schema__(
-        cls,
-        __core_schema: CoreSchema,
-        __handler: GetJsonSchemaHandler,
-    ) -> JsonSchemaValue:
-        """Hook into generating the model's JSON schema.
-
-        Args:
-            __core_schema: A `pydantic-core` CoreSchema.
-                You can ignore this argument and call the handler with a new CoreSchema,
-                wrap this CoreSchema (`{'type': 'nullable', 'schema': current_schema}`),
-                or just call the handler with the original schema.
-            __handler: Call into Pydantic's internal JSON schema generation.
-                This will raise a `pydantic.errors.PydanticInvalidForJsonSchema` if JSON schema
-                generation fails.
-                Since this gets called by `BaseModel.model_json_schema` you can override the
-                `schema_generator` argument to that function to change JSON schema generation globally
-                for a type.
-
-        Returns:
-            A JSON schema, as a Python object.
-        """
-        return __handler(__core_schema)
-
-    @classmethod
-    def __pydantic_init_subclass__(cls, **kwargs: Any) -> None:
-        """This is intended to behave just like `__init_subclass__`, but is called by `ModelMetaclass`
-        only after the class is actually fully initialized. In particular, attributes like `model_fields` will
-        be present when this is called.
-
-        This is necessary because `__init_subclass__` will always be called by `type.__new__`,
-        and it would require a prohibitively large refactor to the `ModelMetaclass` to ensure that
-        `type.__new__` was called in such a manner that the class would already be sufficiently initialized.
-
-        This will receive the same `kwargs` that would be passed to the standard `__init_subclass__`, namely,
-        any kwargs passed to the class definition that aren't used internally by pydantic.
-
-        Args:
-            **kwargs: Any keyword arguments passed to the class definition that aren't used internally
-                by pydantic.
-        """
-        pass
-
-    def __class_getitem__(
-        cls, typevar_values: type[Any] | tuple[type[Any], ...]
-    ) -> type[BaseModel] | _forward_ref.PydanticRecursiveRef:
-        cached = _generics.get_cached_generic_type_early(cls, typevar_values)
-        if cached is not None:
-            return cached
-
-        if cls is BaseModel:
-            raise TypeError('Type parameters should be placed on typing.Generic, not BaseModel')
-        if not hasattr(cls, '__parameters__'):
-            raise TypeError(f'{cls} cannot be parametrized because it does not inherit from typing.Generic')
-        if not cls.__pydantic_generic_metadata__['parameters'] and typing.Generic not in cls.__bases__:
-            raise TypeError(f'{cls} is not a generic class')
-
-        if not isinstance(typevar_values, tuple):
-            typevar_values = (typevar_values,)
-        _generics.check_parameters_count(cls, typevar_values)
-
-        # Build map from generic typevars to passed params
-        typevars_map: dict[_typing_extra.TypeVarType, type[Any]] = dict(
-            zip(cls.__pydantic_generic_metadata__['parameters'], typevar_values)
-        )
-
-        if _utils.all_identical(typevars_map.keys(), typevars_map.values()) and typevars_map:
-            submodel = cls  # if arguments are equal to parameters it's the same object
-            _generics.set_cached_generic_type(cls, typevar_values, submodel)
+        _custom_root_type = ROOT_KEY in fields
+        if _custom_root_type:
+            validate_custom_root_type(fields)
+        vg.check_for_unused()
+        if config.json_encoders:
+            json_encoder = partial(custom_pydantic_encoder, config.json_encoders)
         else:
-            parent_args = cls.__pydantic_generic_metadata__['args']
-            if not parent_args:
-                args = typevar_values
-            else:
-                args = tuple(_generics.replace_types(arg, typevars_map) for arg in parent_args)
+            json_encoder = pydantic_encoder
+        pre_rv_new, post_rv_new = extract_root_validators(namespace)
 
-            origin = cls.__pydantic_generic_metadata__['origin'] or cls
-            model_name = origin.model_parametrized_name(args)
-            params = tuple(
-                {param: None for param in _generics.iter_contained_typevars(typevars_map.values())}
-            )  # use dict as ordered set
+        if hash_func is None:
+            hash_func = generate_hash_function(config.frozen)
 
-            with _generics.generic_recursion_self_type(origin, args) as maybe_self_type:
-                if maybe_self_type is not None:
-                    return maybe_self_type
+        exclude_from_namespace = fields | private_attributes.keys() | {'__slots__'}
+        new_namespace = {
+            '__config__': config,
+            '__fields__': fields,
+            '__exclude_fields__': {
+                name: field.field_info.exclude for name, field in fields.items() if field.field_info.exclude is not None
+            }
+            or None,
+            '__include_fields__': {
+                name: field.field_info.include for name, field in fields.items() if field.field_info.include is not None
+            }
+            or None,
+            '__validators__': vg.validators,
+            '__pre_root_validators__': unique_list(
+                pre_root_validators + pre_rv_new,
+                name_factory=lambda v: v.__name__,
+            ),
+            '__post_root_validators__': unique_list(
+                post_root_validators + post_rv_new,
+                name_factory=lambda skip_on_failure_and_v: skip_on_failure_and_v[1].__name__,
+            ),
+            '__schema_cache__': {},
+            '__json_encoder__': staticmethod(json_encoder),
+            '__custom_root_type__': _custom_root_type,
+            '__private_attributes__': {**base_private_attributes, **private_attributes},
+            '__slots__': slots | private_attributes.keys(),
+            '__hash__': hash_func,
+            '__class_vars__': class_vars,
+            **{n: v for n, v in namespace.items() if n not in exclude_from_namespace},
+        }
 
-                cached = _generics.get_cached_generic_type_late(cls, typevar_values, origin, args)
-                if cached is not None:
-                    return cached
+        cls = super().__new__(mcs, name, bases, new_namespace, **kwargs)
+        # set __signature__ attr only for model class, but not for its instances
+        cls.__signature__ = ClassAttribute('__signature__', generate_model_signature(cls.__init__, fields, config))
+        if resolve_forward_refs:
+            cls.__try_update_forward_refs__()
 
-                # Attempt to rebuild the origin in case new types have been defined
-                try:
-                    # depth 3 gets you above this __class_getitem__ call
-                    origin.model_rebuild(_parent_namespace_depth=3)
-                except PydanticUndefinedAnnotation:
-                    # It's okay if it fails, it just means there are still undefined types
-                    # that could be evaluated later.
-                    # TODO: Make sure validation fails if there are still undefined types, perhaps using MockValidator
-                    pass
+        # preserve `__set_name__` protocol defined in https://peps.python.org/pep-0487
+        # for attributes not in `new_namespace` (e.g. private attributes)
+        for name, obj in namespace.items():
+            if name not in new_namespace:
+                set_name = getattr(obj, '__set_name__', None)
+                if callable(set_name):
+                    set_name(cls, name)
 
-                submodel = _generics.create_generic_submodel(model_name, origin, args, params)
+        return cls
 
-                # Update cache
-                _generics.set_cached_generic_type(cls, typevar_values, submodel, origin, args)
+    def __instancecheck__(self, instance: Any) -> bool:
+        """
+        Avoid calling ABC _abc_subclasscheck unless we're pretty sure.
 
-        return submodel
+        See #3829 and python/cpython#92810
+        """
+        return hasattr(instance, '__fields__') and super().__instancecheck__(instance)
 
-    def __copy__(self: Model) -> Model:
-        """Returns a shallow copy of the model."""
-        cls = type(self)
-        m = cls.__new__(cls)
-        _object_setattr(m, '__dict__', copy(self.__dict__))
-        _object_setattr(m, '__pydantic_extra__', copy(self.__pydantic_extra__))
-        _object_setattr(m, '__pydantic_fields_set__', copy(self.__pydantic_fields_set__))
 
-        if self.__pydantic_private__ is None:
-            _object_setattr(m, '__pydantic_private__', None)
-        else:
-            _object_setattr(
-                m,
-                '__pydantic_private__',
-                {k: v for k, v in self.__pydantic_private__.items() if v is not PydanticUndefined},
-            )
+object_setattr = object.__setattr__
 
-        return m
 
-    def __deepcopy__(self: Model, memo: dict[int, Any] | None = None) -> Model:
-        """Returns a deep copy of the model."""
-        cls = type(self)
-        m = cls.__new__(cls)
-        _object_setattr(m, '__dict__', deepcopy(self.__dict__, memo=memo))
-        _object_setattr(m, '__pydantic_extra__', deepcopy(self.__pydantic_extra__, memo=memo))
-        # This next line doesn't need a deepcopy because __pydantic_fields_set__ is a set[str],
-        # and attempting a deepcopy would be marginally slower.
-        _object_setattr(m, '__pydantic_fields_set__', copy(self.__pydantic_fields_set__))
+class BaseModel(Representation, metaclass=ModelMetaclass):
+    if TYPE_CHECKING:
+        # populated by the metaclass, defined here to help IDEs only
+        __fields__: ClassVar[Dict[str, ModelField]] = {}
+        __include_fields__: ClassVar[Optional[Mapping[str, Any]]] = None
+        __exclude_fields__: ClassVar[Optional[Mapping[str, Any]]] = None
+        __validators__: ClassVar[Dict[str, AnyCallable]] = {}
+        __pre_root_validators__: ClassVar[List[AnyCallable]]
+        __post_root_validators__: ClassVar[List[Tuple[bool, AnyCallable]]]
+        __config__: ClassVar[Type[BaseConfig]] = BaseConfig
+        __json_encoder__: ClassVar[Callable[[Any], Any]] = lambda x: x
+        __schema_cache__: ClassVar['DictAny'] = {}
+        __custom_root_type__: ClassVar[bool] = False
+        __signature__: ClassVar['Signature']
+        __private_attributes__: ClassVar[Dict[str, ModelPrivateAttr]]
+        __class_vars__: ClassVar[SetStr]
+        __fields_set__: ClassVar[SetStr] = set()
 
-        if self.__pydantic_private__ is None:
-            _object_setattr(m, '__pydantic_private__', None)
-        else:
-            _object_setattr(
-                m,
-                '__pydantic_private__',
-                deepcopy({k: v for k, v in self.__pydantic_private__.items() if v is not PydanticUndefined}, memo=memo),
-            )
+    Config = BaseConfig
+    __slots__ = ('__dict__', '__fields_set__')
+    __doc__ = ''  # Null out the Representation docstring
 
-        return m
+    def __init__(__pydantic_self__, **data: Any) -> None:
+        """
+        Create a new model by parsing and validating input data from keyword arguments.
 
-    if not typing.TYPE_CHECKING:
-        # We put `__getattr__` in a non-TYPE_CHECKING block because otherwise, mypy allows arbitrary attribute access
+        Raises ValidationError if the input data cannot be parsed to form a valid model.
+        """
+        # Uses something other than `self` the first arg to allow "self" as a settable attribute
+        values, fields_set, validation_error = validate_model(__pydantic_self__.__class__, data)
+        if validation_error:
+            raise validation_error
+        try:
+            object_setattr(__pydantic_self__, '__dict__', values)
+        except TypeError as e:
+            raise TypeError(
+                'Model values must be a dict; you may not have returned a dictionary from a root validator'
+            ) from e
+        object_setattr(__pydantic_self__, '__fields_set__', fields_set)
+        __pydantic_self__._init_private_attributes()
 
-        def __getattr__(self, item: str) -> Any:
-            private_attributes = object.__getattribute__(self, '__private_attributes__')
-            if item in private_attributes:
-                attribute = private_attributes[item]
-                if hasattr(attribute, '__get__'):
-                    return attribute.__get__(self, type(self))  # type: ignore
+    @no_type_check
+    def __setattr__(self, name, value):  # noqa: C901 (ignore complexity)
+        if name in self.__private_attributes__ or name in DUNDER_ATTRIBUTES:
+            return object_setattr(self, name, value)
 
-                try:
-                    # Note: self.__pydantic_private__ cannot be None if self.__private_attributes__ has items
-                    return self.__pydantic_private__[item]  # type: ignore
-                except KeyError as exc:
-                    raise AttributeError(f'{type(self).__name__!r} object has no attribute {item!r}') from exc
-            else:
-                # `__pydantic_extra__` can fail to be set if the model is not yet fully initialized.
-                # See `BaseModel.__repr_args__` for more details
-                try:
-                    pydantic_extra = object.__getattribute__(self, '__pydantic_extra__')
-                except AttributeError:
-                    pydantic_extra = None
-
-                if pydantic_extra is not None:
-                    try:
-                        return pydantic_extra[item]
-                    except KeyError as exc:
-                        raise AttributeError(f'{type(self).__name__!r} object has no attribute {item!r}') from exc
-                else:
-                    if hasattr(self.__class__, item):
-                        return super().__getattribute__(item)  # Raises AttributeError if appropriate
-                    else:
-                        # this is the current error
-                        raise AttributeError(f'{type(self).__name__!r} object has no attribute {item!r}')
-
-    def __setattr__(self, name: str, value: Any) -> None:
-        if name in self.__class_vars__:
-            raise AttributeError(
-                f'{name!r} is a ClassVar of `{self.__class__.__name__}` and cannot be set on an instance. '
-                f'If you want to set a value on the class, use `{self.__class__.__name__}.{name} = value`.'
-            )
-        elif not _fields.is_valid_field_name(name):
-            if self.__pydantic_private__ is None or name not in self.__private_attributes__:
-                _object_setattr(self, name, value)
-            else:
-                attribute = self.__private_attributes__[name]
-                if hasattr(attribute, '__set__'):
-                    attribute.__set__(self, value)  # type: ignore
-                else:
-                    self.__pydantic_private__[name] = value
-            return
-
-        self._check_frozen(name, value)
-
-        attr = getattr(self.__class__, name, None)
-        if isinstance(attr, property):
-            attr.__set__(self, value)
-        elif self.model_config.get('validate_assignment', None):
-            self.__pydantic_validator__.validate_assignment(self, name, value)
-        elif self.model_config.get('extra') != 'allow' and name not in self.model_fields:
-            # TODO - matching error
+        if self.__config__.extra is not Extra.allow and name not in self.__fields__:
             raise ValueError(f'"{self.__class__.__name__}" object has no field "{name}"')
-        elif self.model_config.get('extra') == 'allow' and name not in self.model_fields:
-            if self.model_extra and name in self.model_extra:
-                self.__pydantic_extra__[name] = value  # type: ignore
-            else:
+        elif not self.__config__.allow_mutation or self.__config__.frozen:
+            raise TypeError(f'"{self.__class__.__name__}" is immutable and does not support item assignment')
+        elif name in self.__fields__ and self.__fields__[name].final:
+            raise TypeError(
+                f'"{self.__class__.__name__}" object "{name}" field is final and does not support reassignment'
+            )
+        elif self.__config__.validate_assignment:
+            new_values = {**self.__dict__, name: value}
+
+            for validator in self.__pre_root_validators__:
                 try:
-                    getattr(self, name)
-                except AttributeError:
-                    # attribute does not already exist on instance, so put it in extra
-                    self.__pydantic_extra__[name] = value  # type: ignore
+                    new_values = validator(self.__class__, new_values)
+                except (ValueError, TypeError, AssertionError) as exc:
+                    raise ValidationError([ErrorWrapper(exc, loc=ROOT_KEY)], self.__class__)
+
+            known_field = self.__fields__.get(name, None)
+            if known_field:
+                # We want to
+                # - make sure validators are called without the current value for this field inside `values`
+                # - keep other values (e.g. submodels) untouched (using `BaseModel.dict()` will change them into dicts)
+                # - keep the order of the fields
+                if not known_field.field_info.allow_mutation:
+                    raise TypeError(f'"{known_field.name}" has allow_mutation set to False and cannot be assigned')
+                dict_without_original_value = {k: v for k, v in self.__dict__.items() if k != name}
+                value, error_ = known_field.validate(value, dict_without_original_value, loc=name, cls=self.__class__)
+                if error_:
+                    raise ValidationError([error_], self.__class__)
                 else:
-                    # attribute _does_ already exist on instance, and was not in extra, so update it
-                    _object_setattr(self, name, value)
+                    new_values[name] = value
+
+            errors = []
+            for skip_on_failure, validator in self.__post_root_validators__:
+                if skip_on_failure and errors:
+                    continue
+                try:
+                    new_values = validator(self.__class__, new_values)
+                except (ValueError, TypeError, AssertionError) as exc:
+                    errors.append(ErrorWrapper(exc, loc=ROOT_KEY))
+            if errors:
+                raise ValidationError(errors, self.__class__)
+
+            # update the whole __dict__ as other values than just `value`
+            # may be changed (e.g. with `root_validator`)
+            object_setattr(self, '__dict__', new_values)
         else:
             self.__dict__[name] = value
-            self.__pydantic_fields_set__.add(name)
 
-    def __delattr__(self, item: str) -> Any:
-        if item in self.__private_attributes__:
-            attribute = self.__private_attributes__[item]
-            if hasattr(attribute, '__delete__'):
-                attribute.__delete__(self)  # type: ignore
-                return
+        self.__fields_set__.add(name)
 
-            try:
-                # Note: self.__pydantic_private__ cannot be None if self.__private_attributes__ has items
-                del self.__pydantic_private__[item]  # type: ignore
-                return
-            except KeyError as exc:
-                raise AttributeError(f'{type(self).__name__!r} object has no attribute {item!r}') from exc
-
-        self._check_frozen(item, None)
-
-        if item in self.model_fields:
-            object.__delattr__(self, item)
-        elif self.__pydantic_extra__ is not None and item in self.__pydantic_extra__:
-            del self.__pydantic_extra__[item]
-        else:
-            try:
-                object.__delattr__(self, item)
-            except AttributeError:
-                raise AttributeError(f'{type(self).__name__!r} object has no attribute {item!r}')
-
-    def _check_frozen(self, name: str, value: Any) -> None:
-        if self.model_config.get('frozen', None):
-            typ = 'frozen_instance'
-        elif getattr(self.model_fields.get(name), 'frozen', False):
-            typ = 'frozen_field'
-        else:
-            return
-        error: pydantic_core.InitErrorDetails = {
-            'type': typ,
-            'loc': (name,),
-            'input': value,
-        }
-        raise pydantic_core.ValidationError.from_exception_data(self.__class__.__name__, [error])
-
-    def __getstate__(self) -> dict[Any, Any]:
-        private = self.__pydantic_private__
-        if private:
-            private = {k: v for k, v in private.items() if v is not PydanticUndefined}
+    def __getstate__(self) -> 'DictAny':
+        private_attrs = ((k, getattr(self, k, Undefined)) for k in self.__private_attributes__)
         return {
             '__dict__': self.__dict__,
-            '__pydantic_extra__': self.__pydantic_extra__,
-            '__pydantic_fields_set__': self.__pydantic_fields_set__,
-            '__pydantic_private__': private,
+            '__fields_set__': self.__fields_set__,
+            '__private_attribute_values__': {k: v for k, v in private_attrs if v is not Undefined},
         }
 
-    def __setstate__(self, state: dict[Any, Any]) -> None:
-        _object_setattr(self, '__pydantic_fields_set__', state['__pydantic_fields_set__'])
-        _object_setattr(self, '__pydantic_extra__', state['__pydantic_extra__'])
-        _object_setattr(self, '__pydantic_private__', state['__pydantic_private__'])
-        _object_setattr(self, '__dict__', state['__dict__'])
+    def __setstate__(self, state: 'DictAny') -> None:
+        object_setattr(self, '__dict__', state['__dict__'])
+        object_setattr(self, '__fields_set__', state['__fields_set__'])
+        for name, value in state.get('__private_attribute_values__', {}).items():
+            object_setattr(self, name, value)
 
-    def __eq__(self, other: Any) -> bool:
-        if isinstance(other, BaseModel):
-            # When comparing instances of generic types for equality, as long as all field values are equal,
-            # only require their generic origin types to be equal, rather than exact type equality.
-            # This prevents headaches like MyGeneric(x=1) != MyGeneric[Any](x=1).
-            self_type = self.__pydantic_generic_metadata__['origin'] or self.__class__
-            other_type = other.__pydantic_generic_metadata__['origin'] or other.__class__
+    def _init_private_attributes(self) -> None:
+        for name, private_attr in self.__private_attributes__.items():
+            default = private_attr.get_default()
+            if default is not Undefined:
+                object_setattr(self, name, default)
 
-            # Perform common checks first
-            if not (
-                self_type == other_type
-                and self.__pydantic_private__ == other.__pydantic_private__
-                and self.__pydantic_extra__ == other.__pydantic_extra__
-            ):
-                return False
-
-            # We only want to compare pydantic fields but ignoring fields is costly.
-            # We'll perform a fast check first, and fallback only when needed
-            # See GH-7444 and GH-7825 for rationale and a performance benchmark
-
-            # First, do the fast (and sometimes faulty) __dict__ comparison
-            if self.__dict__ == other.__dict__:
-                # If the check above passes, then pydantic fields are equal, we can return early
-                return True
-
-            # We don't want to trigger unnecessary costly filtering of __dict__ on all unequal objects, so we return
-            # early if there are no keys to ignore (we would just return False later on anyway)
-            model_fields = type(self).model_fields.keys()
-            if self.__dict__.keys() <= model_fields and other.__dict__.keys() <= model_fields:
-                return False
-
-            # If we reach here, there are non-pydantic-fields keys, mapped to unequal values, that we need to ignore
-            # Resort to costly filtering of the __dict__ objects
-            # We use operator.itemgetter because it is much faster than dict comprehensions
-            # NOTE: Contrary to standard python class and instances, when the Model class has a default value for an
-            # attribute and the model instance doesn't have a corresponding attribute, accessing the missing attribute
-            # raises an error in BaseModel.__getattr__ instead of returning the class attribute
-            # So we can use operator.itemgetter() instead of operator.attrgetter()
-            getter = operator.itemgetter(*model_fields) if model_fields else lambda _: _utils._SENTINEL
-            try:
-                return getter(self.__dict__) == getter(other.__dict__)
-            except KeyError:
-                # In rare cases (such as when using the deprecated BaseModel.copy() method),
-                # the __dict__ may not contain all model fields, which is how we can get here.
-                # getter(self.__dict__) is much faster than any 'safe' method that accounts
-                # for missing keys, and wrapping it in a `try` doesn't slow things down much
-                # in the common case.
-                self_fields_proxy = _utils.SafeGetItemProxy(self.__dict__)
-                other_fields_proxy = _utils.SafeGetItemProxy(other.__dict__)
-                return getter(self_fields_proxy) == getter(other_fields_proxy)
-
-        # other instance is not a BaseModel
-        else:
-            return NotImplemented  # delegate to the other item in the comparison
-
-    if typing.TYPE_CHECKING:
-        # We put `__init_subclass__` in a TYPE_CHECKING block because, even though we want the type-checking benefits
-        # described in the signature of `__init_subclass__` below, we don't want to modify the default behavior of
-        # subclass initialization.
-
-        def __init_subclass__(cls, **kwargs: Unpack[ConfigDict]):
-            """This signature is included purely to help type-checkers check arguments to class declaration, which
-            provides a way to conveniently set model_config key/value pairs.
-
-            ```py
-            from pydantic import BaseModel
-
-            class MyModel(BaseModel, extra='allow'):
-                ...
-            ```
-
-            However, this may be deceiving, since the _actual_ calls to `__init_subclass__` will not receive any
-            of the config arguments, and will only receive any keyword arguments passed during class initialization
-            that are _not_ expected keys in ConfigDict. (This is due to the way `ModelMetaclass.__new__` works.)
-
-            Args:
-                **kwargs: Keyword arguments passed to the class definition, which set model_config
-
-            Note:
-                You may want to override `__pydantic_init_subclass__` instead, which behaves similarly but is called
-                *after* the class is fully initialized.
-            """
-
-    def __iter__(self) -> TupleGenerator:
-        """So `dict(model)` works."""
-        yield from [(k, v) for (k, v) in self.__dict__.items() if not k.startswith('_')]
-        extra = self.__pydantic_extra__
-        if extra:
-            yield from extra.items()
-
-    def __repr__(self) -> str:
-        return f'{self.__repr_name__()}({self.__repr_str__(", ")})'
-
-    def __repr_args__(self) -> _repr.ReprArgs:
-        for k, v in self.__dict__.items():
-            field = self.model_fields.get(k)
-            if field and field.repr:
-                yield k, v
-
-        # `__pydantic_extra__` can fail to be set if the model is not yet fully initialized.
-        # This can happen if a `ValidationError` is raised during initialization and the instance's
-        # repr is generated as part of the exception handling. Therefore, we use `getattr` here
-        # with a fallback, even though the type hints indicate the attribute will always be present.
-        try:
-            pydantic_extra = object.__getattribute__(self, '__pydantic_extra__')
-        except AttributeError:
-            pydantic_extra = None
-
-        if pydantic_extra is not None:
-            yield from ((k, v) for k, v in pydantic_extra.items())
-        yield from ((k, getattr(self, k)) for k, v in self.model_computed_fields.items() if v.repr)
-
-    # take logic from `_repr.Representation` without the side effects of inheritance, see #5740
-    __repr_name__ = _repr.Representation.__repr_name__
-    __repr_str__ = _repr.Representation.__repr_str__
-    __pretty__ = _repr.Representation.__pretty__
-    __rich_repr__ = _repr.Representation.__rich_repr__
-
-    def __str__(self) -> str:
-        return self.__repr_str__(' ')
-
-    # ##### Deprecated methods from v1 #####
-    @property
-    @typing_extensions.deprecated(
-        'The `__fields__` attribute is deprecated, use `model_fields` instead.', category=None
-    )
-    def __fields__(self) -> dict[str, FieldInfo]:
-        warnings.warn(
-            'The `__fields__` attribute is deprecated, use `model_fields` instead.', category=PydanticDeprecatedSince20
-        )
-        return self.model_fields
-
-    @property
-    @typing_extensions.deprecated(
-        'The `__fields_set__` attribute is deprecated, use `model_fields_set` instead.',
-        category=None,
-    )
-    def __fields_set__(self) -> set[str]:
-        warnings.warn(
-            'The `__fields_set__` attribute is deprecated, use `model_fields_set` instead.',
-            category=PydanticDeprecatedSince20,
-        )
-        return self.__pydantic_fields_set__
-
-    @typing_extensions.deprecated('The `dict` method is deprecated; use `model_dump` instead.', category=None)
-    def dict(  # noqa: D102
+    def dict(
         self,
         *,
-        include: IncEx = None,
-        exclude: IncEx = None,
+        include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
+        exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
         by_alias: bool = False,
+        skip_defaults: Optional[bool] = None,
         exclude_unset: bool = False,
         exclude_defaults: bool = False,
         exclude_none: bool = False,
-    ) -> typing.Dict[str, Any]:  # noqa UP006
-        warnings.warn('The `dict` method is deprecated; use `model_dump` instead.', category=PydanticDeprecatedSince20)
-        return self.model_dump(
-            include=include,
-            exclude=exclude,
-            by_alias=by_alias,
-            exclude_unset=exclude_unset,
-            exclude_defaults=exclude_defaults,
-            exclude_none=exclude_none,
+    ) -> 'DictStrAny':
+        """
+        Generate a dictionary representation of the model, optionally specifying which fields to include or exclude.
+
+        """
+        if skip_defaults is not None:
+            warnings.warn(
+                f'{self.__class__.__name__}.dict(): "skip_defaults" is deprecated and replaced by "exclude_unset"',
+                DeprecationWarning,
+            )
+            exclude_unset = skip_defaults
+
+        return dict(
+            self._iter(
+                to_dict=True,
+                by_alias=by_alias,
+                include=include,
+                exclude=exclude,
+                exclude_unset=exclude_unset,
+                exclude_defaults=exclude_defaults,
+                exclude_none=exclude_none,
+            )
         )
 
-    @typing_extensions.deprecated('The `json` method is deprecated; use `model_dump_json` instead.', category=None)
-    def json(  # noqa: D102
+    def json(
         self,
         *,
-        include: IncEx = None,
-        exclude: IncEx = None,
+        include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
+        exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
         by_alias: bool = False,
+        skip_defaults: Optional[bool] = None,
         exclude_unset: bool = False,
         exclude_defaults: bool = False,
         exclude_none: bool = False,
-        encoder: typing.Callable[[Any], Any] | None = PydanticUndefined,  # type: ignore[assignment]
-        models_as_dict: bool = PydanticUndefined,  # type: ignore[assignment]
+        encoder: Optional[Callable[[Any], Any]] = None,
+        models_as_dict: bool = True,
         **dumps_kwargs: Any,
     ) -> str:
-        warnings.warn(
-            'The `json` method is deprecated; use `model_dump_json` instead.', category=PydanticDeprecatedSince20
-        )
-        if encoder is not PydanticUndefined:
-            raise TypeError('The `encoder` argument is no longer supported; use field serializers instead.')
-        if models_as_dict is not PydanticUndefined:
-            raise TypeError('The `models_as_dict` argument is no longer supported; use a model serializer instead.')
-        if dumps_kwargs:
-            raise TypeError('`dumps_kwargs` keyword arguments are no longer supported.')
-        return self.model_dump_json(
-            include=include,
-            exclude=exclude,
-            by_alias=by_alias,
-            exclude_unset=exclude_unset,
-            exclude_defaults=exclude_defaults,
-            exclude_none=exclude_none,
+        """
+        Generate a JSON representation of the model, `include` and `exclude` arguments as per `dict()`.
+
+        `encoder` is an optional function to supply as `default` to json.dumps(), other arguments as per `json.dumps()`.
+        """
+        if skip_defaults is not None:
+            warnings.warn(
+                f'{self.__class__.__name__}.json(): "skip_defaults" is deprecated and replaced by "exclude_unset"',
+                DeprecationWarning,
+            )
+            exclude_unset = skip_defaults
+        encoder = cast(Callable[[Any], Any], encoder or self.__json_encoder__)
+
+        # We don't directly call `self.dict()`, which does exactly this with `to_dict=True`
+        # because we want to be able to keep raw `BaseModel` instances and not as `dict`.
+        # This allows users to write custom JSON encoders for given `BaseModel` classes.
+        data = dict(
+            self._iter(
+                to_dict=models_as_dict,
+                by_alias=by_alias,
+                include=include,
+                exclude=exclude,
+                exclude_unset=exclude_unset,
+                exclude_defaults=exclude_defaults,
+                exclude_none=exclude_none,
+            )
         )
+        if self.__custom_root_type__:
+            data = data[ROOT_KEY]
+        return self.__config__.json_dumps(data, default=encoder, **dumps_kwargs)
 
     @classmethod
-    @typing_extensions.deprecated('The `parse_obj` method is deprecated; use `model_validate` instead.', category=None)
-    def parse_obj(cls: type[Model], obj: Any) -> Model:  # noqa: D102
-        warnings.warn(
-            'The `parse_obj` method is deprecated; use `model_validate` instead.', category=PydanticDeprecatedSince20
-        )
-        return cls.model_validate(obj)
+    def _enforce_dict_if_root(cls, obj: Any) -> Any:
+        if cls.__custom_root_type__ and (
+            not (isinstance(obj, dict) and obj.keys() == {ROOT_KEY})
+            or cls.__fields__[ROOT_KEY].shape in MAPPING_LIKE_SHAPES
+        ):
+            return {ROOT_KEY: obj}
+        else:
+            return obj
 
     @classmethod
-    @typing_extensions.deprecated(
-        'The `parse_raw` method is deprecated; if your data is JSON use `model_validate_json`, '
-        'otherwise load the data then use `model_validate` instead.',
-        category=None,
-    )
-    def parse_raw(  # noqa: D102
-        cls: type[Model],
-        b: str | bytes,
+    def parse_obj(cls: Type['Model'], obj: Any) -> 'Model':
+        obj = cls._enforce_dict_if_root(obj)
+        if not isinstance(obj, dict):
+            try:
+                obj = dict(obj)
+            except (TypeError, ValueError) as e:
+                exc = TypeError(f'{cls.__name__} expected dict not {obj.__class__.__name__}')
+                raise ValidationError([ErrorWrapper(exc, loc=ROOT_KEY)], cls) from e
+        return cls(**obj)
+
+    @classmethod
+    def parse_raw(
+        cls: Type['Model'],
+        b: StrBytes,
         *,
-        content_type: str | None = None,
+        content_type: str = None,
         encoding: str = 'utf8',
-        proto: DeprecatedParseProtocol | None = None,
+        proto: Protocol = None,
         allow_pickle: bool = False,
-    ) -> Model:  # pragma: no cover
-        warnings.warn(
-            'The `parse_raw` method is deprecated; if your data is JSON use `model_validate_json`, '
-            'otherwise load the data then use `model_validate` instead.',
-            category=PydanticDeprecatedSince20,
-        )
-        from .deprecated import parse
-
+    ) -> 'Model':
         try:
-            obj = parse.load_str_bytes(
+            obj = load_str_bytes(
                 b,
                 proto=proto,
                 content_type=content_type,
                 encoding=encoding,
                 allow_pickle=allow_pickle,
+                json_loads=cls.__config__.json_loads,
             )
-        except (ValueError, TypeError) as exc:
-            import json
-
-            # try to match V1
-            if isinstance(exc, UnicodeDecodeError):
-                type_str = 'value_error.unicodedecode'
-            elif isinstance(exc, json.JSONDecodeError):
-                type_str = 'value_error.jsondecode'
-            elif isinstance(exc, ValueError):
-                type_str = 'value_error'
-            else:
-                type_str = 'type_error'
-
-            # ctx is missing here, but since we've added `input` to the error, we're not pretending it's the same
-            error: pydantic_core.InitErrorDetails = {
-                # The type: ignore on the next line is to ignore the requirement of LiteralString
-                'type': pydantic_core.PydanticCustomError(type_str, str(exc)),  # type: ignore
-                'loc': ('__root__',),
-                'input': b,
-            }
-            raise pydantic_core.ValidationError.from_exception_data(cls.__name__, [error])
-        return cls.model_validate(obj)
+        except (ValueError, TypeError, UnicodeDecodeError) as e:
+            raise ValidationError([ErrorWrapper(e, loc=ROOT_KEY)], cls)
+        return cls.parse_obj(obj)
 
     @classmethod
-    @typing_extensions.deprecated(
-        'The `parse_file` method is deprecated; load the data from file, then if your data is JSON '
-        'use `model_validate_json`, otherwise `model_validate` instead.',
-        category=None,
-    )
-    def parse_file(  # noqa: D102
-        cls: type[Model],
-        path: str | Path,
+    def parse_file(
+        cls: Type['Model'],
+        path: Union[str, Path],
         *,
-        content_type: str | None = None,
+        content_type: str = None,
         encoding: str = 'utf8',
-        proto: DeprecatedParseProtocol | None = None,
+        proto: Protocol = None,
         allow_pickle: bool = False,
-    ) -> Model:
-        warnings.warn(
-            'The `parse_file` method is deprecated; load the data from file, then if your data is JSON '
-            'use `model_validate_json`, otherwise `model_validate` instead.',
-            category=PydanticDeprecatedSince20,
-        )
-        from .deprecated import parse
-
-        obj = parse.load_file(
+    ) -> 'Model':
+        obj = load_file(
             path,
             proto=proto,
             content_type=content_type,
             encoding=encoding,
             allow_pickle=allow_pickle,
+            json_loads=cls.__config__.json_loads,
         )
         return cls.parse_obj(obj)
 
     @classmethod
-    @typing_extensions.deprecated(
-        'The `from_orm` method is deprecated; set '
-        "`model_config['from_attributes']=True` and use `model_validate` instead.",
-        category=None,
-    )
-    def from_orm(cls: type[Model], obj: Any) -> Model:  # noqa: D102
-        warnings.warn(
-            'The `from_orm` method is deprecated; set '
-            "`model_config['from_attributes']=True` and use `model_validate` instead.",
-            category=PydanticDeprecatedSince20,
-        )
-        if not cls.model_config.get('from_attributes', None):
-            raise PydanticUserError(
-                'You must set the config attribute `from_attributes=True` to use from_orm', code=None
-            )
-        return cls.model_validate(obj)
+    def from_orm(cls: Type['Model'], obj: Any) -> 'Model':
+        if not cls.__config__.orm_mode:
+            raise ConfigError('You must have the config attribute orm_mode=True to use from_orm')
+        obj = {ROOT_KEY: obj} if cls.__custom_root_type__ else cls._decompose_class(obj)
+        m = cls.__new__(cls)
+        values, fields_set, validation_error = validate_model(cls, obj)
+        if validation_error:
+            raise validation_error
+        object_setattr(m, '__dict__', values)
+        object_setattr(m, '__fields_set__', fields_set)
+        m._init_private_attributes()
+        return m
 
     @classmethod
-    @typing_extensions.deprecated('The `construct` method is deprecated; use `model_construct` instead.', category=None)
-    def construct(cls: type[Model], _fields_set: set[str] | None = None, **values: Any) -> Model:  # noqa: D102
-        warnings.warn(
-            'The `construct` method is deprecated; use `model_construct` instead.', category=PydanticDeprecatedSince20
-        )
-        return cls.model_construct(_fields_set=_fields_set, **values)
-
-    @typing_extensions.deprecated(
-        'The `copy` method is deprecated; use `model_copy` instead. '
-        'See the docstring of `BaseModel.copy` for details about how to handle `include` and `exclude`.',
-        category=None,
-    )
-    def copy(
-        self: Model,
-        *,
-        include: AbstractSetIntStr | MappingIntStrAny | None = None,
-        exclude: AbstractSetIntStr | MappingIntStrAny | None = None,
-        update: typing.Dict[str, Any] | None = None,  # noqa UP006
-        deep: bool = False,
-    ) -> Model:  # pragma: no cover
-        """Returns a copy of the model.
-
-        !!! warning "Deprecated"
-            This method is now deprecated; use `model_copy` instead.
-
-        If you need `include` or `exclude`, use:
-
-        ```py
-        data = self.model_dump(include=include, exclude=exclude, round_trip=True)
-        data = {**data, **(update or {})}
-        copied = self.model_validate(data)
-        ```
-
-        Args:
-            include: Optional set or mapping specifying which fields to include in the copied model.
-            exclude: Optional set or mapping specifying which fields to exclude in the copied model.
-            update: Optional dictionary of field-value pairs to override field values in the copied model.
-            deep: If True, the values of fields that are Pydantic models will be deep-copied.
-
-        Returns:
-            A copy of the model with included, excluded and updated fields as specified.
+    def construct(cls: Type['Model'], _fields_set: Optional['SetStr'] = None, **values: Any) -> 'Model':
+        """
+        Creates a new model setting __dict__ and __fields_set__ from trusted or pre-validated data.
+        Default values are respected, but no other validation is performed.
+        Behaves as if `Config.extra = 'allow'` was set since it adds all passed values
+        """
+        m = cls.__new__(cls)
+        fields_values: Dict[str, Any] = {}
+        for name, field in cls.__fields__.items():
+            if field.alt_alias and field.alias in values:
+                fields_values[name] = values[field.alias]
+            elif name in values:
+                fields_values[name] = values[name]
+            elif not field.required:
+                fields_values[name] = field.get_default()
+        fields_values.update(values)
+        object_setattr(m, '__dict__', fields_values)
+        if _fields_set is None:
+            _fields_set = set(values.keys())
+        object_setattr(m, '__fields_set__', _fields_set)
+        m._init_private_attributes()
+        return m
+
+    def _copy_and_set_values(self: 'Model', values: 'DictStrAny', fields_set: 'SetStr', *, deep: bool) -> 'Model':
+        if deep:
+            # chances of having empty dict here are quite low for using smart_deepcopy
+            values = deepcopy(values)
+
+        cls = self.__class__
+        m = cls.__new__(cls)
+        object_setattr(m, '__dict__', values)
+        object_setattr(m, '__fields_set__', fields_set)
+        for name in self.__private_attributes__:
+            value = getattr(self, name, Undefined)
+            if value is not Undefined:
+                if deep:
+                    value = deepcopy(value)
+                object_setattr(m, name, value)
+
+        return m
+
+    def copy(
+        self: 'Model',
+        *,
+        include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
+        exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
+        update: Optional['DictStrAny'] = None,
+        deep: bool = False,
+    ) -> 'Model':
+        """
+        Duplicate a model, optionally choose which fields to include, exclude and change.
+
+        :param include: fields to include in new model
+        :param exclude: fields to exclude from new model, as with values this takes precedence over include
+        :param update: values to change/add in the new model. Note: the data is not validated before creating
+            the new model: you should trust this data
+        :param deep: set to `True` to make a deep copy of the model
+        :return: new model instance
         """
-        warnings.warn(
-            'The `copy` method is deprecated; use `model_copy` instead. '
-            'See the docstring of `BaseModel.copy` for details about how to handle `include` and `exclude`.',
-            category=PydanticDeprecatedSince20,
-        )
-        from .deprecated import copy_internals
 
         values = dict(
-            copy_internals._iter(
-                self, to_dict=False, by_alias=False, include=include, exclude=exclude, exclude_unset=False
-            ),
+            self._iter(to_dict=False, by_alias=False, include=include, exclude=exclude, exclude_unset=False),
             **(update or {}),
         )
-        if self.__pydantic_private__ is None:
-            private = None
-        else:
-            private = {k: v for k, v in self.__pydantic_private__.items() if v is not PydanticUndefined}
 
-        if self.__pydantic_extra__ is None:
-            extra: dict[str, Any] | None = None
-        else:
-            extra = self.__pydantic_extra__.copy()
-            for k in list(self.__pydantic_extra__):
-                if k not in values:  # k was in the exclude
-                    extra.pop(k)
-            for k in list(values):
-                if k in self.__pydantic_extra__:  # k must have come from extra
-                    extra[k] = values.pop(k)
-
-        # new `__pydantic_fields_set__` can have unset optional fields with a set value in `update` kwarg
+        # new `__fields_set__` can have unset optional fields with a set value in `update` kwarg
         if update:
-            fields_set = self.__pydantic_fields_set__ | update.keys()
+            fields_set = self.__fields_set__ | update.keys()
         else:
-            fields_set = set(self.__pydantic_fields_set__)
+            fields_set = set(self.__fields_set__)
+
+        return self._copy_and_set_values(values, fields_set, deep=deep)
+
+    @classmethod
+    def schema(cls, by_alias: bool = True, ref_template: str = default_ref_template) -> 'DictStrAny':
+        cached = cls.__schema_cache__.get((by_alias, ref_template))
+        if cached is not None:
+            return cached
+        s = model_schema(cls, by_alias=by_alias, ref_template=ref_template)
+        cls.__schema_cache__[(by_alias, ref_template)] = s
+        return s
+
+    @classmethod
+    def schema_json(
+        cls, *, by_alias: bool = True, ref_template: str = default_ref_template, **dumps_kwargs: Any
+    ) -> str:
+        from .json import pydantic_encoder
+
+        return cls.__config__.json_dumps(
+            cls.schema(by_alias=by_alias, ref_template=ref_template), default=pydantic_encoder, **dumps_kwargs
+        )
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield cls.validate
+
+    @classmethod
+    def validate(cls: Type['Model'], value: Any) -> 'Model':
+        if isinstance(value, cls):
+            copy_on_model_validation = cls.__config__.copy_on_model_validation
+            # whether to deep or shallow copy the model on validation, None means do not copy
+            deep_copy: Optional[bool] = None
+            if copy_on_model_validation not in {'deep', 'shallow', 'none'}:
+                # Warn about deprecated behavior
+                warnings.warn(
+                    "`copy_on_model_validation` should be a string: 'deep', 'shallow' or 'none'", DeprecationWarning
+                )
+                if copy_on_model_validation:
+                    deep_copy = False
+
+            if copy_on_model_validation == 'shallow':
+                # shallow copy
+                deep_copy = False
+            elif copy_on_model_validation == 'deep':
+                # deep copy
+                deep_copy = True
+
+            if deep_copy is None:
+                return value
+            else:
+                return value._copy_and_set_values(value.__dict__, value.__fields_set__, deep=deep_copy)
+
+        value = cls._enforce_dict_if_root(value)
+
+        if isinstance(value, dict):
+            return cls(**value)
+        elif cls.__config__.orm_mode:
+            return cls.from_orm(value)
+        else:
+            try:
+                value_as_dict = dict(value)
+            except (TypeError, ValueError) as e:
+                raise DictError() from e
+            return cls(**value_as_dict)
+
+    @classmethod
+    def _decompose_class(cls: Type['Model'], obj: Any) -> GetterDict:
+        if isinstance(obj, GetterDict):
+            return obj
+        return cls.__config__.getter_dict(obj)
+
+    @classmethod
+    @no_type_check
+    def _get_value(
+        cls,
+        v: Any,
+        to_dict: bool,
+        by_alias: bool,
+        include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']],
+        exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']],
+        exclude_unset: bool,
+        exclude_defaults: bool,
+        exclude_none: bool,
+    ) -> Any:
+
+        if isinstance(v, BaseModel):
+            if to_dict:
+                v_dict = v.dict(
+                    by_alias=by_alias,
+                    exclude_unset=exclude_unset,
+                    exclude_defaults=exclude_defaults,
+                    include=include,
+                    exclude=exclude,
+                    exclude_none=exclude_none,
+                )
+                if ROOT_KEY in v_dict:
+                    return v_dict[ROOT_KEY]
+                return v_dict
+            else:
+                return v.copy(include=include, exclude=exclude)
+
+        value_exclude = ValueItems(v, exclude) if exclude else None
+        value_include = ValueItems(v, include) if include else None
+
+        if isinstance(v, dict):
+            return {
+                k_: cls._get_value(
+                    v_,
+                    to_dict=to_dict,
+                    by_alias=by_alias,
+                    exclude_unset=exclude_unset,
+                    exclude_defaults=exclude_defaults,
+                    include=value_include and value_include.for_element(k_),
+                    exclude=value_exclude and value_exclude.for_element(k_),
+                    exclude_none=exclude_none,
+                )
+                for k_, v_ in v.items()
+                if (not value_exclude or not value_exclude.is_excluded(k_))
+                and (not value_include or value_include.is_included(k_))
+            }
+
+        elif sequence_like(v):
+            seq_args = (
+                cls._get_value(
+                    v_,
+                    to_dict=to_dict,
+                    by_alias=by_alias,
+                    exclude_unset=exclude_unset,
+                    exclude_defaults=exclude_defaults,
+                    include=value_include and value_include.for_element(i),
+                    exclude=value_exclude and value_exclude.for_element(i),
+                    exclude_none=exclude_none,
+                )
+                for i, v_ in enumerate(v)
+                if (not value_exclude or not value_exclude.is_excluded(i))
+                and (not value_include or value_include.is_included(i))
+            )
+
+            return v.__class__(*seq_args) if is_namedtuple(v.__class__) else v.__class__(seq_args)
+
+        elif isinstance(v, Enum) and getattr(cls.Config, 'use_enum_values', False):
+            return v.value
+
+        else:
+            return v
+
+    @classmethod
+    def __try_update_forward_refs__(cls, **localns: Any) -> None:
+        """
+        Same as update_forward_refs but will not raise exception
+        when forward references are not defined.
+        """
+        update_model_forward_refs(cls, cls.__fields__.values(), cls.__config__.json_encoders, localns, (NameError,))
+
+    @classmethod
+    def update_forward_refs(cls, **localns: Any) -> None:
+        """
+        Try to update ForwardRefs on fields based on this Model, globalns and localns.
+        """
+        update_model_forward_refs(cls, cls.__fields__.values(), cls.__config__.json_encoders, localns)
+
+    def __iter__(self) -> 'TupleGenerator':
+        """
+        so `dict(model)` works
+        """
+        yield from self.__dict__.items()
+
+    def _iter(
+        self,
+        to_dict: bool = False,
+        by_alias: bool = False,
+        include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
+        exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
+        exclude_unset: bool = False,
+        exclude_defaults: bool = False,
+        exclude_none: bool = False,
+    ) -> 'TupleGenerator':
+
+        # Merge field set excludes with explicit exclude parameter with explicit overriding field set options.
+        # The extra "is not None" guards are not logically necessary but optimizes performance for the simple case.
+        if exclude is not None or self.__exclude_fields__ is not None:
+            exclude = ValueItems.merge(self.__exclude_fields__, exclude)
+
+        if include is not None or self.__include_fields__ is not None:
+            include = ValueItems.merge(self.__include_fields__, include, intersect=True)
+
+        allowed_keys = self._calculate_keys(
+            include=include, exclude=exclude, exclude_unset=exclude_unset  # type: ignore
+        )
+        if allowed_keys is None and not (to_dict or by_alias or exclude_unset or exclude_defaults or exclude_none):
+            # huge boost for plain _iter()
+            yield from self.__dict__.items()
+            return
+
+        value_exclude = ValueItems(self, exclude) if exclude is not None else None
+        value_include = ValueItems(self, include) if include is not None else None
+
+        for field_key, v in self.__dict__.items():
+            if (allowed_keys is not None and field_key not in allowed_keys) or (exclude_none and v is None):
+                continue
+
+            if exclude_defaults:
+                model_field = self.__fields__.get(field_key)
+                if not getattr(model_field, 'required', True) and getattr(model_field, 'default', _missing) == v:
+                    continue
+
+            if by_alias and field_key in self.__fields__:
+                dict_key = self.__fields__[field_key].alias
+            else:
+                dict_key = field_key
+
+            if to_dict or value_include or value_exclude:
+                v = self._get_value(
+                    v,
+                    to_dict=to_dict,
+                    by_alias=by_alias,
+                    include=value_include and value_include.for_element(field_key),
+                    exclude=value_exclude and value_exclude.for_element(field_key),
+                    exclude_unset=exclude_unset,
+                    exclude_defaults=exclude_defaults,
+                    exclude_none=exclude_none,
+                )
+            yield dict_key, v
+
+    def _calculate_keys(
+        self,
+        include: Optional['MappingIntStrAny'],
+        exclude: Optional['MappingIntStrAny'],
+        exclude_unset: bool,
+        update: Optional['DictStrAny'] = None,
+    ) -> Optional[AbstractSet[str]]:
+        if include is None and exclude is None and exclude_unset is False:
+            return None
+
+        keys: AbstractSet[str]
+        if exclude_unset:
+            keys = self.__fields_set__.copy()
+        else:
+            keys = self.__dict__.keys()
+
+        if include is not None:
+            keys &= include.keys()
+
+        if update:
+            keys -= update.keys()
 
-        # removing excluded fields from `__pydantic_fields_set__`
         if exclude:
-            fields_set -= set(exclude)
+            keys -= {k for k, v in exclude.items() if ValueItems.is_true(v)}
 
-        return copy_internals._copy_and_set_values(self, values, fields_set, extra, private, deep=deep)
+        return keys
 
-    @classmethod
-    @typing_extensions.deprecated('The `schema` method is deprecated; use `model_json_schema` instead.', category=None)
-    def schema(  # noqa: D102
-        cls, by_alias: bool = True, ref_template: str = DEFAULT_REF_TEMPLATE
-    ) -> typing.Dict[str, Any]:  # noqa UP006
-        warnings.warn(
-            'The `schema` method is deprecated; use `model_json_schema` instead.', category=PydanticDeprecatedSince20
-        )
-        return cls.model_json_schema(by_alias=by_alias, ref_template=ref_template)
+    def __eq__(self, other: Any) -> bool:
+        if isinstance(other, BaseModel):
+            return self.dict() == other.dict()
+        else:
+            return self.dict() == other
 
-    @classmethod
-    @typing_extensions.deprecated(
-        'The `schema_json` method is deprecated; use `model_json_schema` and json.dumps instead.',
-        category=None,
-    )
-    def schema_json(  # noqa: D102
-        cls, *, by_alias: bool = True, ref_template: str = DEFAULT_REF_TEMPLATE, **dumps_kwargs: Any
-    ) -> str:  # pragma: no cover
-        warnings.warn(
-            'The `schema_json` method is deprecated; use `model_json_schema` and json.dumps instead.',
-            category=PydanticDeprecatedSince20,
-        )
-        import json
-
-        from .deprecated.json import pydantic_encoder
-
-        return json.dumps(
-            cls.model_json_schema(by_alias=by_alias, ref_template=ref_template),
-            default=pydantic_encoder,
-            **dumps_kwargs,
-        )
-
-    @classmethod
-    @typing_extensions.deprecated('The `validate` method is deprecated; use `model_validate` instead.', category=None)
-    def validate(cls: type[Model], value: Any) -> Model:  # noqa: D102
-        warnings.warn(
-            'The `validate` method is deprecated; use `model_validate` instead.', category=PydanticDeprecatedSince20
-        )
-        return cls.model_validate(value)
-
-    @classmethod
-    @typing_extensions.deprecated(
-        'The `update_forward_refs` method is deprecated; use `model_rebuild` instead.',
-        category=None,
-    )
-    def update_forward_refs(cls, **localns: Any) -> None:  # noqa: D102
-        warnings.warn(
-            'The `update_forward_refs` method is deprecated; use `model_rebuild` instead.',
-            category=PydanticDeprecatedSince20,
-        )
-        if localns:  # pragma: no cover
-            raise TypeError('`localns` arguments are not longer accepted.')
-        cls.model_rebuild(force=True)
-
-    @typing_extensions.deprecated(
-        'The private method `_iter` will be removed and should no longer be used.', category=None
-    )
-    def _iter(self, *args: Any, **kwargs: Any) -> Any:
-        warnings.warn(
-            'The private method `_iter` will be removed and should no longer be used.',
-            category=PydanticDeprecatedSince20,
-        )
-        from .deprecated import copy_internals
-
-        return copy_internals._iter(self, *args, **kwargs)
-
-    @typing_extensions.deprecated(
-        'The private method `_copy_and_set_values` will be removed and should no longer be used.',
-        category=None,
-    )
-    def _copy_and_set_values(self, *args: Any, **kwargs: Any) -> Any:
-        warnings.warn(
-            'The private method `_copy_and_set_values` will be removed and should no longer be used.',
-            category=PydanticDeprecatedSince20,
-        )
-        from .deprecated import copy_internals
-
-        return copy_internals._copy_and_set_values(self, *args, **kwargs)
-
-    @classmethod
-    @typing_extensions.deprecated(
-        'The private method `_get_value` will be removed and should no longer be used.',
-        category=None,
-    )
-    def _get_value(cls, *args: Any, **kwargs: Any) -> Any:
-        warnings.warn(
-            'The private method `_get_value` will be removed and should no longer be used.',
-            category=PydanticDeprecatedSince20,
-        )
-        from .deprecated import copy_internals
-
-        return copy_internals._get_value(cls, *args, **kwargs)
-
-    @typing_extensions.deprecated(
-        'The private method `_calculate_keys` will be removed and should no longer be used.',
-        category=None,
-    )
-    def _calculate_keys(self, *args: Any, **kwargs: Any) -> Any:
-        warnings.warn(
-            'The private method `_calculate_keys` will be removed and should no longer be used.',
-            category=PydanticDeprecatedSince20,
-        )
-        from .deprecated import copy_internals
-
-        return copy_internals._calculate_keys(self, *args, **kwargs)
+    def __repr_args__(self) -> 'ReprArgs':
+        return [
+            (k, v)
+            for k, v in self.__dict__.items()
+            if k not in DUNDER_ATTRIBUTES and (k not in self.__fields__ or self.__fields__[k].field_info.repr)
+        ]
 
 
-@typing.overload
+_is_base_model_class_defined = True
+
+
+@overload
 def create_model(
     __model_name: str,
     *,
-    __config__: ConfigDict | None = None,
-    __doc__: str | None = None,
+    __config__: Optional[Type[BaseConfig]] = None,
     __base__: None = None,
     __module__: str = __name__,
-    __validators__: dict[str, classmethod] | None = None,
-    __cls_kwargs__: dict[str, Any] | None = None,
+    __validators__: Dict[str, 'AnyClassMethod'] = None,
+    __cls_kwargs__: Dict[str, Any] = None,
     **field_definitions: Any,
-) -> type[BaseModel]:
+) -> Type['BaseModel']:
     ...
 
 
-@typing.overload
+@overload
 def create_model(
     __model_name: str,
     *,
-    __config__: ConfigDict | None = None,
-    __doc__: str | None = None,
-    __base__: type[Model] | tuple[type[Model], ...],
+    __config__: Optional[Type[BaseConfig]] = None,
+    __base__: Union[Type['Model'], Tuple[Type['Model'], ...]],
     __module__: str = __name__,
-    __validators__: dict[str, classmethod] | None = None,
-    __cls_kwargs__: dict[str, Any] | None = None,
+    __validators__: Dict[str, 'AnyClassMethod'] = None,
+    __cls_kwargs__: Dict[str, Any] = None,
     **field_definitions: Any,
-) -> type[Model]:
+) -> Type['Model']:
     ...
 
 
-def create_model(  # noqa: C901
+def create_model(
     __model_name: str,
     *,
-    __config__: ConfigDict | None = None,
-    __doc__: str | None = None,
-    __base__: type[Model] | tuple[type[Model], ...] | None = None,
-    __module__: str | None = None,
-    __validators__: dict[str, classmethod] | None = None,
-    __cls_kwargs__: dict[str, Any] | None = None,
-    __slots__: tuple[str, ...] | None = None,
+    __config__: Optional[Type[BaseConfig]] = None,
+    __base__: Union[None, Type['Model'], Tuple[Type['Model'], ...]] = None,
+    __module__: str = __name__,
+    __validators__: Dict[str, 'AnyClassMethod'] = None,
+    __cls_kwargs__: Dict[str, Any] = None,
+    __slots__: Optional[Tuple[str, ...]] = None,
     **field_definitions: Any,
-) -> type[Model]:
-    """Usage docs: https://docs.pydantic.dev/2.6/concepts/models/#dynamic-model-creation
-
-    Dynamically creates and returns a new Pydantic model, in other words, `create_model` dynamically creates a
-    subclass of [`BaseModel`][pydantic.BaseModel].
-
-    Args:
-        __model_name: The name of the newly created model.
-        __config__: The configuration of the new model.
-        __doc__: The docstring of the new model.
-        __base__: The base class or classes for the new model.
-        __module__: The name of the module that the model belongs to;
-            if `None`, the value is taken from `sys._getframe(1)`
-        __validators__: A dictionary of methods that validate fields.
-        __cls_kwargs__: A dictionary of keyword arguments for class creation, such as `metaclass`.
-        __slots__: Deprecated. Should not be passed to `create_model`.
-        **field_definitions: Attributes of the new model. They should be passed in the format:
-            `<name>=(<type>, <default value>)` or `<name>=(<type>, <FieldInfo>)`.
-
-    Returns:
-        The new [model][pydantic.BaseModel].
-
-    Raises:
-        PydanticUserError: If `__base__` and `__config__` are both passed.
+) -> Type['Model']:
+    """
+    Dynamically create a model.
+    :param __model_name: name of the created model
+    :param __config__: config class to use for the new model
+    :param __base__: base class for the new model to inherit from
+    :param __module__: module of the created model
+    :param __validators__: a dict of method names and @validator class methods
+    :param __cls_kwargs__: a dict for class creation
+    :param __slots__: Deprecated, `__slots__` should not be passed to `create_model`
+    :param field_definitions: fields of the model (or extra fields if a base is supplied)
+        in the format `<name>=(<type>, <default default>)` or `<name>=<default value>, e.g.
+        `foobar=(str, ...)` or `foobar=123`, or, for complex use-cases, in the format
+        `<name>=<Field>` or `<name>=(<type>, <FieldInfo>)`, e.g.
+        `foo=Field(datetime, default_factory=datetime.utcnow, alias='bar')` or
+        `foo=(str, FieldInfo(title='Foo'))`
     """
     if __slots__ is not None:
         # __slots__ will be ignored from here on
@@ -1436,14 +982,11 @@ def create_model(  # noqa: C901
 
     if __base__ is not None:
         if __config__ is not None:
-            raise PydanticUserError(
-                'to avoid confusion `__config__` and `__base__` cannot be used together',
-                code='create-model-config-base',
-            )
+            raise ConfigError('to avoid confusion __config__ and __base__ cannot be used together')
         if not isinstance(__base__, tuple):
             __base__ = (__base__,)
     else:
-        __base__ = (typing.cast(typing.Type['Model'], BaseModel),)
+        __base__ = (cast(Type['Model'], BaseModel),)
 
     __cls_kwargs__ = __cls_kwargs__ or {}
 
@@ -1451,16 +994,16 @@ def create_model(  # noqa: C901
     annotations = {}
 
     for f_name, f_def in field_definitions.items():
-        if not _fields.is_valid_field_name(f_name):
+        if not is_valid_field(f_name):
             warnings.warn(f'fields may not start with an underscore, ignoring "{f_name}"', RuntimeWarning)
         if isinstance(f_def, tuple):
-            f_def = typing.cast('tuple[str, Any]', f_def)
             try:
                 f_annotation, f_value = f_def
             except ValueError as e:
-                raise PydanticUserError(
-                    'Field definitions should be a `(<type>, <default>)`.',
-                    code='create-model-field-definitions',
+                raise ConfigError(
+                    'field definitions should either be a tuple of (<type>, <default>) or just a '
+                    'default value, unfortunately this means tuples as '
+                    'default values are not allowed'
                 ) from e
         else:
             f_annotation, f_value = None, f_def
@@ -1469,32 +1012,98 @@ def create_model(  # noqa: C901
             annotations[f_name] = f_annotation
         fields[f_name] = f_value
 
-    if __module__ is None:
-        f = sys._getframe(1)
-        __module__ = f.f_globals['__name__']
-
-    namespace: dict[str, Any] = {'__annotations__': annotations, '__module__': __module__}
-    if __doc__:
-        namespace.update({'__doc__': __doc__})
+    namespace: 'DictStrAny' = {'__annotations__': annotations, '__module__': __module__}
     if __validators__:
         namespace.update(__validators__)
     namespace.update(fields)
     if __config__:
-        namespace['model_config'] = _config.ConfigWrapper(__config__).config_dict
-    resolved_bases = types.resolve_bases(__base__)
-    meta, ns, kwds = types.prepare_class(__model_name, resolved_bases, kwds=__cls_kwargs__)
+        namespace['Config'] = inherit_config(__config__, BaseConfig)
+    resolved_bases = resolve_bases(__base__)
+    meta, ns, kwds = prepare_class(__model_name, resolved_bases, kwds=__cls_kwargs__)
     if resolved_bases is not __base__:
         ns['__orig_bases__'] = __base__
     namespace.update(ns)
-
-    return meta(
-        __model_name,
-        resolved_bases,
-        namespace,
-        __pydantic_reset_parent_namespace__=False,
-        _create_model_module=__module__,
-        **kwds,
-    )
+    return meta(__model_name, resolved_bases, namespace, **kwds)
 
 
-__getattr__ = getattr_migration(__name__)
+_missing = object()
+
+
+def validate_model(  # noqa: C901 (ignore complexity)
+    model: Type[BaseModel], input_data: 'DictStrAny', cls: 'ModelOrDc' = None
+) -> Tuple['DictStrAny', 'SetStr', Optional[ValidationError]]:
+    """
+    validate data against a model.
+    """
+    values = {}
+    errors = []
+    # input_data names, possibly alias
+    names_used = set()
+    # field names, never aliases
+    fields_set = set()
+    config = model.__config__
+    check_extra = config.extra is not Extra.ignore
+    cls_ = cls or model
+
+    for validator in model.__pre_root_validators__:
+        try:
+            input_data = validator(cls_, input_data)
+        except (ValueError, TypeError, AssertionError) as exc:
+            return {}, set(), ValidationError([ErrorWrapper(exc, loc=ROOT_KEY)], cls_)
+
+    for name, field in model.__fields__.items():
+        value = input_data.get(field.alias, _missing)
+        using_name = False
+        if value is _missing and config.allow_population_by_field_name and field.alt_alias:
+            value = input_data.get(field.name, _missing)
+            using_name = True
+
+        if value is _missing:
+            if field.required:
+                errors.append(ErrorWrapper(MissingError(), loc=field.alias))
+                continue
+
+            value = field.get_default()
+
+            if not config.validate_all and not field.validate_always:
+                values[name] = value
+                continue
+        else:
+            fields_set.add(name)
+            if check_extra:
+                names_used.add(field.name if using_name else field.alias)
+
+        v_, errors_ = field.validate(value, values, loc=field.alias, cls=cls_)
+        if isinstance(errors_, ErrorWrapper):
+            errors.append(errors_)
+        elif isinstance(errors_, list):
+            errors.extend(errors_)
+        else:
+            values[name] = v_
+
+    if check_extra:
+        if isinstance(input_data, GetterDict):
+            extra = input_data.extra_keys() - names_used
+        else:
+            extra = input_data.keys() - names_used
+        if extra:
+            fields_set |= extra
+            if config.extra is Extra.allow:
+                for f in extra:
+                    values[f] = input_data[f]
+            else:
+                for f in sorted(extra):
+                    errors.append(ErrorWrapper(ExtraError(), loc=f))
+
+    for skip_on_failure, validator in model.__post_root_validators__:
+        if skip_on_failure and errors:
+            continue
+        try:
+            values = validator(cls_, values)
+        except (ValueError, TypeError, AssertionError) as exc:
+            errors.append(ErrorWrapper(exc, loc=ROOT_KEY))
+
+    if errors:
+        return values, fields_set, ValidationError(errors, cls_)
+    else:
+        return values, fields_set, None
diff --git a/lib/pydantic/mypy.py b/lib/pydantic/mypy.py
index 0e70eab5..6bd9db18 100644
--- a/lib/pydantic/mypy.py
+++ b/lib/pydantic/mypy.py
@@ -1,13 +1,8 @@
-"""This module includes classes and functions designed specifically for use with the mypy plugin."""
-
-from __future__ import annotations
-
 import sys
 from configparser import ConfigParser
-from typing import Any, Callable, Iterator
+from typing import Any, Callable, Dict, List, Optional, Set, Tuple, Type as TypingType, Union
 
 from mypy.errorcodes import ErrorCode
-from mypy.expandtype import expand_type, expand_type_by_instance
 from mypy.nodes import (
     ARG_NAMED,
     ARG_NAMED_OPT,
@@ -22,23 +17,21 @@ from mypy.nodes import (
     ClassDef,
     Context,
     Decorator,
-    DictExpr,
     EllipsisExpr,
-    Expression,
+    FuncBase,
     FuncDef,
-    IfStmt,
     JsonDict,
     MemberExpr,
     NameExpr,
     PassStmt,
     PlaceholderNode,
     RefExpr,
-    Statement,
     StrExpr,
+    SymbolNode,
     SymbolTableNode,
     TempNode,
-    TypeAlias,
     TypeInfo,
+    TypeVarExpr,
     Var,
 )
 from mypy.options import Options
@@ -48,17 +41,11 @@ from mypy.plugin import (
     FunctionContext,
     MethodContext,
     Plugin,
-    ReportConfigContext,
     SemanticAnalyzerPluginInterface,
 )
 from mypy.plugins import dataclasses
-from mypy.plugins.common import (
-    deserialize_and_fixup_type,
-)
-from mypy.semanal import set_callable_name
+from mypy.semanal import set_callable_name  # type: ignore
 from mypy.server.trigger import make_wildcard_trigger
-from mypy.state import state
-from mypy.typeops import map_type_from_supertype
 from mypy.types import (
     AnyType,
     CallableType,
@@ -76,131 +63,76 @@ from mypy.typevars import fill_typevars
 from mypy.util import get_unique_redefinition_name
 from mypy.version import __version__ as mypy_version
 
-from pydantic._internal import _fields
-from pydantic.version import parse_mypy_version
+from pydantic.utils import is_valid_field
 
 try:
     from mypy.types import TypeVarDef  # type: ignore[attr-defined]
 except ImportError:  # pragma: no cover
-    # Backward-compatible with TypeVarDef from Mypy 0.930.
+    # Backward-compatible with TypeVarDef from Mypy 0.910.
     from mypy.types import TypeVarType as TypeVarDef
 
 CONFIGFILE_KEY = 'pydantic-mypy'
 METADATA_KEY = 'pydantic-mypy-metadata'
 BASEMODEL_FULLNAME = 'pydantic.main.BaseModel'
-BASESETTINGS_FULLNAME = 'pydantic_settings.main.BaseSettings'
-ROOT_MODEL_FULLNAME = 'pydantic.root_model.RootModel'
-MODEL_METACLASS_FULLNAME = 'pydantic._internal._model_construction.ModelMetaclass'
+BASESETTINGS_FULLNAME = 'pydantic.env_settings.BaseSettings'
 FIELD_FULLNAME = 'pydantic.fields.Field'
 DATACLASS_FULLNAME = 'pydantic.dataclasses.dataclass'
-MODEL_VALIDATOR_FULLNAME = 'pydantic.functional_validators.model_validator'
-DECORATOR_FULLNAMES = {
-    'pydantic.functional_validators.field_validator',
-    'pydantic.functional_validators.model_validator',
-    'pydantic.functional_serializers.serializer',
-    'pydantic.functional_serializers.model_serializer',
-    'pydantic.deprecated.class_validators.validator',
-    'pydantic.deprecated.class_validators.root_validator',
-}
+
+
+def parse_mypy_version(version: str) -> Tuple[int, ...]:
+    return tuple(int(part) for part in version.split('+', 1)[0].split('.'))
 
 
 MYPY_VERSION_TUPLE = parse_mypy_version(mypy_version)
 BUILTINS_NAME = 'builtins' if MYPY_VERSION_TUPLE >= (0, 930) else '__builtins__'
 
-# Increment version if plugin changes and mypy caches should be invalidated
-__version__ = 2
 
-
-def plugin(version: str) -> type[Plugin]:
-    """`version` is the mypy version string.
+def plugin(version: str) -> 'TypingType[Plugin]':
+    """
+    `version` is the mypy version string
 
     We might want to use this to print a warning if the mypy version being used is
     newer, or especially older, than we expect (or need).
-
-    Args:
-        version: The mypy version string.
-
-    Return:
-        The Pydantic mypy plugin type.
     """
     return PydanticPlugin
 
 
-class _DeferAnalysis(Exception):
-    pass
-
-
 class PydanticPlugin(Plugin):
-    """The Pydantic mypy plugin."""
-
     def __init__(self, options: Options) -> None:
         self.plugin_config = PydanticPluginConfig(options)
-        self._plugin_data = self.plugin_config.to_data()
         super().__init__(options)
 
-    def get_base_class_hook(self, fullname: str) -> Callable[[ClassDefContext], bool] | None:
-        """Update Pydantic model class."""
+    def get_base_class_hook(self, fullname: str) -> 'Optional[Callable[[ClassDefContext], None]]':
         sym = self.lookup_fully_qualified(fullname)
         if sym and isinstance(sym.node, TypeInfo):  # pragma: no branch
             # No branching may occur if the mypy cache has not been cleared
-            if any(base.fullname == BASEMODEL_FULLNAME for base in sym.node.mro):
+            if any(get_fullname(base) == BASEMODEL_FULLNAME for base in sym.node.mro):
                 return self._pydantic_model_class_maker_callback
         return None
 
-    def get_metaclass_hook(self, fullname: str) -> Callable[[ClassDefContext], None] | None:
-        """Update Pydantic `ModelMetaclass` definition."""
-        if fullname == MODEL_METACLASS_FULLNAME:
-            return self._pydantic_model_metaclass_marker_callback
-        return None
-
-    def get_function_hook(self, fullname: str) -> Callable[[FunctionContext], Type] | None:
-        """Adjust the return type of the `Field` function."""
+    def get_function_hook(self, fullname: str) -> 'Optional[Callable[[FunctionContext], Type]]':
         sym = self.lookup_fully_qualified(fullname)
         if sym and sym.fullname == FIELD_FULLNAME:
             return self._pydantic_field_callback
         return None
 
-    def get_method_hook(self, fullname: str) -> Callable[[MethodContext], Type] | None:
-        """Adjust return type of `from_orm` method call."""
+    def get_method_hook(self, fullname: str) -> Optional[Callable[[MethodContext], Type]]:
         if fullname.endswith('.from_orm'):
-            return from_attributes_callback
+            return from_orm_callback
         return None
 
-    def get_class_decorator_hook(self, fullname: str) -> Callable[[ClassDefContext], None] | None:
-        """Mark pydantic.dataclasses as dataclass.
-
-        Mypy version 1.1.1 added support for `@dataclass_transform` decorator.
-        """
-        if fullname == DATACLASS_FULLNAME and MYPY_VERSION_TUPLE < (1, 1):
+    def get_class_decorator_hook(self, fullname: str) -> Optional[Callable[[ClassDefContext], None]]:
+        if fullname == DATACLASS_FULLNAME:
             return dataclasses.dataclass_class_maker_callback  # type: ignore[return-value]
         return None
 
-    def report_config_data(self, ctx: ReportConfigContext) -> dict[str, Any]:
-        """Return all plugin config data.
+    def _pydantic_model_class_maker_callback(self, ctx: ClassDefContext) -> None:
+        transformer = PydanticModelTransformer(ctx, self.plugin_config)
+        transformer.transform()
 
-        Used by mypy to determine if cache needs to be discarded.
+    def _pydantic_field_callback(self, ctx: FunctionContext) -> 'Type':
         """
-        return self._plugin_data
-
-    def _pydantic_model_class_maker_callback(self, ctx: ClassDefContext) -> bool:
-        transformer = PydanticModelTransformer(ctx.cls, ctx.reason, ctx.api, self.plugin_config)
-        return transformer.transform()
-
-    def _pydantic_model_metaclass_marker_callback(self, ctx: ClassDefContext) -> None:
-        """Reset dataclass_transform_spec attribute of ModelMetaclass.
-
-        Let the plugin handle it. This behavior can be disabled
-        if 'debug_dataclass_transform' is set to True', for testing purposes.
-        """
-        if self.plugin_config.debug_dataclass_transform:
-            return
-        info_metaclass = ctx.cls.info.declared_metaclass
-        assert info_metaclass, "callback not passed from 'get_metaclass_hook'"
-        if getattr(info_metaclass.type, 'dataclass_transform_spec', None):
-            info_metaclass.type.dataclass_transform_spec = None
-
-    def _pydantic_field_callback(self, ctx: FunctionContext) -> Type:
-        """Extract the type of the `default` argument from the Field function, and use it as the return type.
+        Extract the type of the `default` argument from the Field function, and use it as the return type.
 
         In particular:
         * Check whether the default and default_factory argument is specified.
@@ -232,7 +164,11 @@ class PydanticPlugin(Plugin):
             # Functions which use `ParamSpec` can be overloaded, exposing the callable's types as a parameter
             # Pydantic calls the default factory without any argument, so we retrieve the first item
             if isinstance(default_factory_type, Overloaded):
-                default_factory_type = default_factory_type.items[0]
+                if MYPY_VERSION_TUPLE > (0, 910):
+                    default_factory_type = default_factory_type.items[0]
+                else:
+                    # Mypy0.910 exposes the items of overloaded types in a function
+                    default_factory_type = default_factory_type.items()[0]  # type: ignore[operator]
 
             if isinstance(default_factory_type, CallableType):
                 ret_type = default_factory_type.ret_type
@@ -249,26 +185,11 @@ class PydanticPlugin(Plugin):
 
 
 class PydanticPluginConfig:
-    """A Pydantic mypy plugin config holder.
-
-    Attributes:
-        init_forbid_extra: Whether to add a `**kwargs` at the end of the generated `__init__` signature.
-        init_typed: Whether to annotate fields in the generated `__init__`.
-        warn_required_dynamic_aliases: Whether to raise required dynamic aliases error.
-        debug_dataclass_transform: Whether to not reset `dataclass_transform_spec` attribute
-            of `ModelMetaclass` for testing purposes.
-    """
-
-    __slots__ = (
-        'init_forbid_extra',
-        'init_typed',
-        'warn_required_dynamic_aliases',
-        'debug_dataclass_transform',
-    )
+    __slots__ = ('init_forbid_extra', 'init_typed', 'warn_required_dynamic_aliases', 'warn_untyped_fields')
     init_forbid_extra: bool
     init_typed: bool
     warn_required_dynamic_aliases: bool
-    debug_dataclass_transform: bool  # undocumented
+    warn_untyped_fields: bool
 
     def __init__(self, options: Options) -> None:
         if options.config_file is None:  # pragma: no cover
@@ -289,724 +210,343 @@ class PydanticPluginConfig:
                 setting = plugin_config.getboolean(CONFIGFILE_KEY, key, fallback=False)
                 setattr(self, key, setting)
 
-    def to_data(self) -> dict[str, Any]:
-        """Returns a dict of config names to their values."""
-        return {key: getattr(self, key) for key in self.__slots__}
 
-
-def from_attributes_callback(ctx: MethodContext) -> Type:
-    """Raise an error if from_attributes is not enabled."""
+def from_orm_callback(ctx: MethodContext) -> Type:
+    """
+    Raise an error if orm_mode is not enabled
+    """
     model_type: Instance
-    ctx_type = ctx.type
-    if isinstance(ctx_type, TypeType):
-        ctx_type = ctx_type.item
-    if isinstance(ctx_type, CallableType) and isinstance(ctx_type.ret_type, Instance):
-        model_type = ctx_type.ret_type  # called on the class
-    elif isinstance(ctx_type, Instance):
-        model_type = ctx_type  # called on an instance (unusual, but still valid)
+    if isinstance(ctx.type, CallableType) and isinstance(ctx.type.ret_type, Instance):
+        model_type = ctx.type.ret_type  # called on the class
+    elif isinstance(ctx.type, Instance):
+        model_type = ctx.type  # called on an instance (unusual, but still valid)
     else:  # pragma: no cover
-        detail = f'ctx.type: {ctx_type} (of type {ctx_type.__class__.__name__})'
+        detail = f'ctx.type: {ctx.type} (of type {ctx.type.__class__.__name__})'
         error_unexpected_behavior(detail, ctx.api, ctx.context)
         return ctx.default_return_type
     pydantic_metadata = model_type.type.metadata.get(METADATA_KEY)
     if pydantic_metadata is None:
         return ctx.default_return_type
-    from_attributes = pydantic_metadata.get('config', {}).get('from_attributes')
-    if from_attributes is not True:
-        error_from_attributes(model_type.type.name, ctx.api, ctx.context)
+    orm_mode = pydantic_metadata.get('config', {}).get('orm_mode')
+    if orm_mode is not True:
+        error_from_orm(get_name(model_type.type), ctx.api, ctx.context)
     return ctx.default_return_type
 
 
-class PydanticModelField:
-    """Based on mypy.plugins.dataclasses.DataclassAttribute."""
-
-    def __init__(
-        self,
-        name: str,
-        alias: str | None,
-        has_dynamic_alias: bool,
-        has_default: bool,
-        line: int,
-        column: int,
-        type: Type | None,
-        info: TypeInfo,
-    ):
-        self.name = name
-        self.alias = alias
-        self.has_dynamic_alias = has_dynamic_alias
-        self.has_default = has_default
-        self.line = line
-        self.column = column
-        self.type = type
-        self.info = info
-
-    def to_argument(
-        self,
-        current_info: TypeInfo,
-        typed: bool,
-        force_optional: bool,
-        use_alias: bool,
-        api: SemanticAnalyzerPluginInterface,
-    ) -> Argument:
-        """Based on mypy.plugins.dataclasses.DataclassAttribute.to_argument."""
-        variable = self.to_var(current_info, api, use_alias)
-        type_annotation = self.expand_type(current_info, api) if typed else AnyType(TypeOfAny.explicit)
-        return Argument(
-            variable=variable,
-            type_annotation=type_annotation,
-            initializer=None,
-            kind=ARG_NAMED_OPT if force_optional or self.has_default else ARG_NAMED,
-        )
-
-    def expand_type(self, current_info: TypeInfo, api: SemanticAnalyzerPluginInterface) -> Type | None:
-        """Based on mypy.plugins.dataclasses.DataclassAttribute.expand_type."""
-        # The getattr in the next line is used to prevent errors in legacy versions of mypy without this attribute
-        if self.type is not None and getattr(self.info, 'self_type', None) is not None:
-            # In general, it is not safe to call `expand_type()` during semantic analyzis,
-            # however this plugin is called very late, so all types should be fully ready.
-            # Also, it is tricky to avoid eager expansion of Self types here (e.g. because
-            # we serialize attributes).
-            expanded_type = expand_type(self.type, {self.info.self_type.id: fill_typevars(current_info)})
-            if isinstance(self.type, UnionType) and not isinstance(expanded_type, UnionType):
-                if not api.final_iteration:
-                    raise _DeferAnalysis()
-            return expanded_type
-        return self.type
-
-    def to_var(self, current_info: TypeInfo, api: SemanticAnalyzerPluginInterface, use_alias: bool) -> Var:
-        """Based on mypy.plugins.dataclasses.DataclassAttribute.to_var."""
-        if use_alias and self.alias is not None:
-            name = self.alias
-        else:
-            name = self.name
-
-        return Var(name, self.expand_type(current_info, api))
-
-    def serialize(self) -> JsonDict:
-        """Based on mypy.plugins.dataclasses.DataclassAttribute.serialize."""
-        assert self.type
-        return {
-            'name': self.name,
-            'alias': self.alias,
-            'has_dynamic_alias': self.has_dynamic_alias,
-            'has_default': self.has_default,
-            'line': self.line,
-            'column': self.column,
-            'type': self.type.serialize(),
-        }
-
-    @classmethod
-    def deserialize(cls, info: TypeInfo, data: JsonDict, api: SemanticAnalyzerPluginInterface) -> PydanticModelField:
-        """Based on mypy.plugins.dataclasses.DataclassAttribute.deserialize."""
-        data = data.copy()
-        typ = deserialize_and_fixup_type(data.pop('type'), api)
-        return cls(type=typ, info=info, **data)
-
-    def expand_typevar_from_subtype(self, sub_type: TypeInfo) -> None:
-        """Expands type vars in the context of a subtype when an attribute is inherited
-        from a generic super type.
-        """
-        if self.type is not None:
-            self.type = map_type_from_supertype(self.type, sub_type, self.info)
-
-
-class PydanticModelClassVar:
-    """Based on mypy.plugins.dataclasses.DataclassAttribute.
-
-    ClassVars are ignored by subclasses.
-
-    Attributes:
-        name: the ClassVar name
-    """
-
-    def __init__(self, name):
-        self.name = name
-
-    @classmethod
-    def deserialize(cls, data: JsonDict) -> PydanticModelClassVar:
-        """Based on mypy.plugins.dataclasses.DataclassAttribute.deserialize."""
-        data = data.copy()
-        return cls(**data)
-
-    def serialize(self) -> JsonDict:
-        """Based on mypy.plugins.dataclasses.DataclassAttribute.serialize."""
-        return {
-            'name': self.name,
-        }
-
-
 class PydanticModelTransformer:
-    """Transform the BaseModel subclass according to the plugin settings.
-
-    Attributes:
-        tracked_config_fields: A set of field configs that the plugin has to track their value.
-    """
-
-    tracked_config_fields: set[str] = {
+    tracked_config_fields: Set[str] = {
         'extra',
+        'allow_mutation',
         'frozen',
-        'from_attributes',
-        'populate_by_name',
+        'orm_mode',
+        'allow_population_by_field_name',
         'alias_generator',
     }
 
-    def __init__(
-        self,
-        cls: ClassDef,
-        reason: Expression | Statement,
-        api: SemanticAnalyzerPluginInterface,
-        plugin_config: PydanticPluginConfig,
-    ) -> None:
-        self._cls = cls
-        self._reason = reason
-        self._api = api
-
+    def __init__(self, ctx: ClassDefContext, plugin_config: PydanticPluginConfig) -> None:
+        self._ctx = ctx
         self.plugin_config = plugin_config
 
-    def transform(self) -> bool:
-        """Configures the BaseModel subclass according to the plugin settings.
+    def transform(self) -> None:
+        """
+        Configures the BaseModel subclass according to the plugin settings.
 
         In particular:
-
         * determines the model config and fields,
         * adds a fields-aware signature for the initializer and construct methods
-        * freezes the class if frozen = True
+        * freezes the class if allow_mutation = False or frozen = True
         * stores the fields, config, and if the class is settings in the mypy metadata for access by subclasses
         """
-        info = self._cls.info
-        is_root_model = any(ROOT_MODEL_FULLNAME in base.fullname for base in info.mro[:-1])
+        ctx = self._ctx
+        info = self._ctx.cls.info
+
+        self.adjust_validator_signatures()
         config = self.collect_config()
-        fields, class_vars = self.collect_fields_and_class_vars(config, is_root_model)
-        if fields is None or class_vars is None:
-            # Some definitions are not ready. We need another pass.
-            return False
+        fields = self.collect_fields(config)
         for field in fields:
-            if field.type is None:
-                return False
-
-        is_settings = any(base.fullname == BASESETTINGS_FULLNAME for base in info.mro[:-1])
-        try:
-            self.add_initializer(fields, config, is_settings, is_root_model)
-            self.add_model_construct_method(fields, config, is_settings)
-            self.set_frozen(fields, self._api, frozen=config.frozen is True)
-        except _DeferAnalysis:
-            if not self._api.final_iteration:
-                self._api.defer()
-
-        self.adjust_decorator_signatures()
-
+            if info[field.name].type is None:
+                if not ctx.api.final_iteration:
+                    ctx.api.defer()
+        is_settings = any(get_fullname(base) == BASESETTINGS_FULLNAME for base in info.mro[:-1])
+        self.add_initializer(fields, config, is_settings)
+        self.add_construct_method(fields)
+        self.set_frozen(fields, frozen=config.allow_mutation is False or config.frozen is True)
         info.metadata[METADATA_KEY] = {
             'fields': {field.name: field.serialize() for field in fields},
-            'class_vars': {class_var.name: class_var.serialize() for class_var in class_vars},
-            'config': config.get_values_dict(),
+            'config': config.set_values_dict(),
         }
 
-        return True
+    def adjust_validator_signatures(self) -> None:
+        """When we decorate a function `f` with `pydantic.validator(...), mypy sees
+        `f` as a regular method taking a `self` instance, even though pydantic
+        internally wraps `f` with `classmethod` if necessary.
 
-    def adjust_decorator_signatures(self) -> None:
-        """When we decorate a function `f` with `pydantic.validator(...)`, `pydantic.field_validator`
-        or `pydantic.serializer(...)`, mypy sees `f` as a regular method taking a `self` instance,
-        even though pydantic internally wraps `f` with `classmethod` if necessary.
-
-        Teach mypy this by marking any function whose outermost decorator is a `validator()`,
-        `field_validator()` or `serializer()` call as a `classmethod`.
+        Teach mypy this by marking any function whose outermost decorator is a
+        `validator()` call as a classmethod.
         """
-        for name, sym in self._cls.info.names.items():
+        for name, sym in self._ctx.cls.info.names.items():
             if isinstance(sym.node, Decorator):
                 first_dec = sym.node.original_decorators[0]
                 if (
                     isinstance(first_dec, CallExpr)
                     and isinstance(first_dec.callee, NameExpr)
-                    and first_dec.callee.fullname in DECORATOR_FULLNAMES
-                    # @model_validator(mode="after") is an exception, it expects a regular method
-                    and not (
-                        first_dec.callee.fullname == MODEL_VALIDATOR_FULLNAME
-                        and any(
-                            first_dec.arg_names[i] == 'mode' and isinstance(arg, StrExpr) and arg.value == 'after'
-                            for i, arg in enumerate(first_dec.args)
-                        )
-                    )
+                    and first_dec.callee.fullname == 'pydantic.class_validators.validator'
                 ):
-                    # TODO: Only do this if the first argument of the decorated function is `cls`
                     sym.node.func.is_class = True
 
-    def collect_config(self) -> ModelConfigData:  # noqa: C901 (ignore complexity)
-        """Collects the values of the config attributes that are used by the plugin, accounting for parent classes."""
-        cls = self._cls
+    def collect_config(self) -> 'ModelConfigData':
+        """
+        Collects the values of the config attributes that are used by the plugin, accounting for parent classes.
+        """
+        ctx = self._ctx
+        cls = ctx.cls
         config = ModelConfigData()
-
-        has_config_kwargs = False
-        has_config_from_namespace = False
-
-        # Handle `class MyModel(BaseModel, <name>=<expr>, ...):`
-        for name, expr in cls.keywords.items():
-            config_data = self.get_config_update(name, expr)
-            if config_data:
-                has_config_kwargs = True
-                config.update(config_data)
-
-        # Handle `model_config`
-        stmt: Statement | None = None
         for stmt in cls.defs.body:
-            if not isinstance(stmt, (AssignmentStmt, ClassDef)):
+            if not isinstance(stmt, ClassDef):
                 continue
-
-            if isinstance(stmt, AssignmentStmt):
-                lhs = stmt.lvalues[0]
-                if not isinstance(lhs, NameExpr) or lhs.name != 'model_config':
-                    continue
-
-                if isinstance(stmt.rvalue, CallExpr):  # calls to `dict` or `ConfigDict`
-                    for arg_name, arg in zip(stmt.rvalue.arg_names, stmt.rvalue.args):
-                        if arg_name is None:
-                            continue
-                        config.update(self.get_config_update(arg_name, arg))
-                elif isinstance(stmt.rvalue, DictExpr):  # dict literals
-                    for key_expr, value_expr in stmt.rvalue.items:
-                        if not isinstance(key_expr, StrExpr):
-                            continue
-                        config.update(self.get_config_update(key_expr.value, value_expr))
-
-            elif isinstance(stmt, ClassDef):
-                if stmt.name != 'Config':  # 'deprecated' Config-class
-                    continue
+            if stmt.name == 'Config':
                 for substmt in stmt.defs.body:
                     if not isinstance(substmt, AssignmentStmt):
                         continue
-                    lhs = substmt.lvalues[0]
-                    if not isinstance(lhs, NameExpr):
-                        continue
-                    config.update(self.get_config_update(lhs.name, substmt.rvalue))
-
-            if has_config_kwargs:
-                self._api.fail(
-                    'Specifying config in two places is ambiguous, use either Config attribute or class kwargs',
-                    cls,
-                )
-                break
-
-            has_config_from_namespace = True
-
-        if has_config_kwargs or has_config_from_namespace:
-            if (
-                stmt
-                and config.has_alias_generator
-                and not config.populate_by_name
-                and self.plugin_config.warn_required_dynamic_aliases
-            ):
-                error_required_dynamic_aliases(self._api, stmt)
-
+                    config.update(self.get_config_update(substmt))
+                if (
+                    config.has_alias_generator
+                    and not config.allow_population_by_field_name
+                    and self.plugin_config.warn_required_dynamic_aliases
+                ):
+                    error_required_dynamic_aliases(ctx.api, stmt)
         for info in cls.info.mro[1:]:  # 0 is the current class
             if METADATA_KEY not in info.metadata:
                 continue
 
             # Each class depends on the set of fields in its ancestors
-            self._api.add_plugin_dependency(make_wildcard_trigger(info.fullname))
+            ctx.api.add_plugin_dependency(make_wildcard_trigger(get_fullname(info)))
             for name, value in info.metadata[METADATA_KEY]['config'].items():
                 config.setdefault(name, value)
         return config
 
-    def collect_fields_and_class_vars(
-        self, model_config: ModelConfigData, is_root_model: bool
-    ) -> tuple[list[PydanticModelField] | None, list[PydanticModelClassVar] | None]:
-        """Collects the fields for the model, accounting for parent classes."""
-        cls = self._cls
+    def collect_fields(self, model_config: 'ModelConfigData') -> List['PydanticModelField']:
+        """
+        Collects the fields for the model, accounting for parent classes
+        """
+        # First, collect fields belonging to the current class.
+        ctx = self._ctx
+        cls = self._ctx.cls
+        fields = []  # type: List[PydanticModelField]
+        known_fields = set()  # type: Set[str]
+        for stmt in cls.defs.body:
+            if not isinstance(stmt, AssignmentStmt):  # `and stmt.new_syntax` to require annotation
+                continue
 
-        # First, collect fields and ClassVars belonging to any class in the MRO, ignoring duplicates.
-        #
-        # We iterate through the MRO in reverse because attrs defined in the parent must appear
-        # earlier in the attributes list than attrs defined in the child. See:
-        # https://docs.python.org/3/library/dataclasses.html#inheritance
-        #
-        # However, we also want fields defined in the subtype to override ones defined
-        # in the parent. We can implement this via a dict without disrupting the attr order
-        # because dicts preserve insertion order in Python 3.7+.
-        found_fields: dict[str, PydanticModelField] = {}
-        found_class_vars: dict[str, PydanticModelClassVar] = {}
-        for info in reversed(cls.info.mro[1:-1]):  # 0 is the current class, -2 is BaseModel, -1 is object
-            # if BASEMODEL_METADATA_TAG_KEY in info.metadata and BASEMODEL_METADATA_KEY not in info.metadata:
-            #     # We haven't processed the base class yet. Need another pass.
-            #     return None, None
+            lhs = stmt.lvalues[0]
+            if not isinstance(lhs, NameExpr) or not is_valid_field(lhs.name):
+                continue
+
+            if not stmt.new_syntax and self.plugin_config.warn_untyped_fields:
+                error_untyped_fields(ctx.api, stmt)
+
+            # if lhs.name == '__config__':  # BaseConfig not well handled; I'm not sure why yet
+            #     continue
+
+            sym = cls.info.names.get(lhs.name)
+            if sym is None:  # pragma: no cover
+                # This is likely due to a star import (see the dataclasses plugin for a more detailed explanation)
+                # This is the same logic used in the dataclasses plugin
+                continue
+
+            node = sym.node
+            if isinstance(node, PlaceholderNode):  # pragma: no cover
+                # See the PlaceholderNode docstring for more detail about how this can occur
+                # Basically, it is an edge case when dealing with complex import logic
+                # This is the same logic used in the dataclasses plugin
+                continue
+            if not isinstance(node, Var):  # pragma: no cover
+                # Don't know if this edge case still happens with the `is_valid_field` check above
+                # but better safe than sorry
+                continue
+
+            # x: ClassVar[int] is ignored by dataclasses.
+            if node.is_classvar:
+                continue
+
+            is_required = self.get_is_required(cls, stmt, lhs)
+            alias, has_dynamic_alias = self.get_alias_info(stmt)
+            if (
+                has_dynamic_alias
+                and not model_config.allow_population_by_field_name
+                and self.plugin_config.warn_required_dynamic_aliases
+            ):
+                error_required_dynamic_aliases(ctx.api, stmt)
+            fields.append(
+                PydanticModelField(
+                    name=lhs.name,
+                    is_required=is_required,
+                    alias=alias,
+                    has_dynamic_alias=has_dynamic_alias,
+                    line=stmt.line,
+                    column=stmt.column,
+                )
+            )
+            known_fields.add(lhs.name)
+        all_fields = fields.copy()
+        for info in cls.info.mro[1:]:  # 0 is the current class, -2 is BaseModel, -1 is object
             if METADATA_KEY not in info.metadata:
                 continue
 
-            # Each class depends on the set of attributes in its dataclass ancestors.
-            self._api.add_plugin_dependency(make_wildcard_trigger(info.fullname))
+            superclass_fields = []
+            # Each class depends on the set of fields in its ancestors
+            ctx.api.add_plugin_dependency(make_wildcard_trigger(get_fullname(info)))
 
             for name, data in info.metadata[METADATA_KEY]['fields'].items():
-                field = PydanticModelField.deserialize(info, data, self._api)
-                # (The following comment comes directly from the dataclasses plugin)
-                # TODO: We shouldn't be performing type operations during the main
-                #       semantic analysis pass, since some TypeInfo attributes might
-                #       still be in flux. This should be performed in a later phase.
-                with state.strict_optional_set(self._api.options.strict_optional):
-                    field.expand_typevar_from_subtype(cls.info)
-                found_fields[name] = field
-
-                sym_node = cls.info.names.get(name)
-                if sym_node and sym_node.node and not isinstance(sym_node.node, Var):
-                    self._api.fail(
-                        'BaseModel field may only be overridden by another field',
-                        sym_node.node,
-                    )
-            # Collect ClassVars
-            for name, data in info.metadata[METADATA_KEY]['class_vars'].items():
-                found_class_vars[name] = PydanticModelClassVar.deserialize(data)
-
-        # Second, collect fields and ClassVars belonging to the current class.
-        current_field_names: set[str] = set()
-        current_class_vars_names: set[str] = set()
-        for stmt in self._get_assignment_statements_from_block(cls.defs):
-            maybe_field = self.collect_field_or_class_var_from_stmt(stmt, model_config, found_class_vars)
-            if isinstance(maybe_field, PydanticModelField):
-                lhs = stmt.lvalues[0]
-                if is_root_model and lhs.name != 'root':
-                    error_extra_fields_on_root_model(self._api, stmt)
+                if name not in known_fields:
+                    field = PydanticModelField.deserialize(info, data)
+                    known_fields.add(name)
+                    superclass_fields.append(field)
                 else:
-                    current_field_names.add(lhs.name)
-                    found_fields[lhs.name] = maybe_field
-            elif isinstance(maybe_field, PydanticModelClassVar):
-                lhs = stmt.lvalues[0]
-                current_class_vars_names.add(lhs.name)
-                found_class_vars[lhs.name] = maybe_field
+                    (field,) = (a for a in all_fields if a.name == name)
+                    all_fields.remove(field)
+                    superclass_fields.append(field)
+            all_fields = superclass_fields + all_fields
+        return all_fields
 
-        return list(found_fields.values()), list(found_class_vars.values())
-
-    def _get_assignment_statements_from_if_statement(self, stmt: IfStmt) -> Iterator[AssignmentStmt]:
-        for body in stmt.body:
-            if not body.is_unreachable:
-                yield from self._get_assignment_statements_from_block(body)
-        if stmt.else_body is not None and not stmt.else_body.is_unreachable:
-            yield from self._get_assignment_statements_from_block(stmt.else_body)
-
-    def _get_assignment_statements_from_block(self, block: Block) -> Iterator[AssignmentStmt]:
-        for stmt in block.body:
-            if isinstance(stmt, AssignmentStmt):
-                yield stmt
-            elif isinstance(stmt, IfStmt):
-                yield from self._get_assignment_statements_from_if_statement(stmt)
-
-    def collect_field_or_class_var_from_stmt(  # noqa C901
-        self, stmt: AssignmentStmt, model_config: ModelConfigData, class_vars: dict[str, PydanticModelClassVar]
-    ) -> PydanticModelField | PydanticModelClassVar | None:
-        """Get pydantic model field from statement.
-
-        Args:
-            stmt: The statement.
-            model_config: Configuration settings for the model.
-            class_vars: ClassVars already known to be defined on the model.
-
-        Returns:
-            A pydantic model field if it could find the field in statement. Otherwise, `None`.
+    def add_initializer(self, fields: List['PydanticModelField'], config: 'ModelConfigData', is_settings: bool) -> None:
         """
-        cls = self._cls
-
-        lhs = stmt.lvalues[0]
-        if not isinstance(lhs, NameExpr) or not _fields.is_valid_field_name(lhs.name) or lhs.name == 'model_config':
-            return None
-
-        if not stmt.new_syntax:
-            if (
-                isinstance(stmt.rvalue, CallExpr)
-                and isinstance(stmt.rvalue.callee, CallExpr)
-                and isinstance(stmt.rvalue.callee.callee, NameExpr)
-                and stmt.rvalue.callee.callee.fullname in DECORATOR_FULLNAMES
-            ):
-                # This is a (possibly-reused) validator or serializer, not a field
-                # In particular, it looks something like: my_validator = validator('my_field')(f)
-                # Eventually, we may want to attempt to respect model_config['ignored_types']
-                return None
-
-            if lhs.name in class_vars:
-                # Class vars are not fields and are not required to be annotated
-                return None
-
-            # The assignment does not have an annotation, and it's not anything else we recognize
-            error_untyped_fields(self._api, stmt)
-            return None
-
-        lhs = stmt.lvalues[0]
-        if not isinstance(lhs, NameExpr):
-            return None
-
-        if not _fields.is_valid_field_name(lhs.name) or lhs.name == 'model_config':
-            return None
-
-        sym = cls.info.names.get(lhs.name)
-        if sym is None:  # pragma: no cover
-            # This is likely due to a star import (see the dataclasses plugin for a more detailed explanation)
-            # This is the same logic used in the dataclasses plugin
-            return None
-
-        node = sym.node
-        if isinstance(node, PlaceholderNode):  # pragma: no cover
-            # See the PlaceholderNode docstring for more detail about how this can occur
-            # Basically, it is an edge case when dealing with complex import logic
-
-            # The dataclasses plugin now asserts this cannot happen, but I'd rather not error if it does..
-            return None
-
-        if isinstance(node, TypeAlias):
-            self._api.fail(
-                'Type aliases inside BaseModel definitions are not supported at runtime',
-                node,
-            )
-            # Skip processing this node. This doesn't match the runtime behaviour,
-            # but the only alternative would be to modify the SymbolTable,
-            # and it's a little hairy to do that in a plugin.
-            return None
-
-        if not isinstance(node, Var):  # pragma: no cover
-            # Don't know if this edge case still happens with the `is_valid_field` check above
-            # but better safe than sorry
-
-            # The dataclasses plugin now asserts this cannot happen, but I'd rather not error if it does..
-            return None
-
-        # x: ClassVar[int] is not a field
-        if node.is_classvar:
-            return PydanticModelClassVar(lhs.name)
-
-        # x: InitVar[int] is not supported in BaseModel
-        node_type = get_proper_type(node.type)
-        if isinstance(node_type, Instance) and node_type.type.fullname == 'dataclasses.InitVar':
-            self._api.fail(
-                'InitVar is not supported in BaseModel',
-                node,
-            )
-
-        has_default = self.get_has_default(stmt)
-
-        if sym.type is None and node.is_final and node.is_inferred:
-            # This follows the logic from the dataclasses plugin. The following comment is taken verbatim:
-            #
-            # This is a special case, assignment like x: Final = 42 is classified
-            # annotated above, but mypy strips the `Final` turning it into x = 42.
-            # We do not support inferred types in dataclasses, so we can try inferring
-            # type for simple literals, and otherwise require an explicit type
-            # argument for Final[...].
-            typ = self._api.analyze_simple_literal_type(stmt.rvalue, is_final=True)
-            if typ:
-                node.type = typ
-            else:
-                self._api.fail(
-                    'Need type argument for Final[...] with non-literal default in BaseModel',
-                    stmt,
-                )
-                node.type = AnyType(TypeOfAny.from_error)
-
-        alias, has_dynamic_alias = self.get_alias_info(stmt)
-        if has_dynamic_alias and not model_config.populate_by_name and self.plugin_config.warn_required_dynamic_aliases:
-            error_required_dynamic_aliases(self._api, stmt)
-
-        init_type = self._infer_dataclass_attr_init_type(sym, lhs.name, stmt)
-        return PydanticModelField(
-            name=lhs.name,
-            has_dynamic_alias=has_dynamic_alias,
-            has_default=has_default,
-            alias=alias,
-            line=stmt.line,
-            column=stmt.column,
-            type=init_type,
-            info=cls.info,
-        )
-
-    def _infer_dataclass_attr_init_type(self, sym: SymbolTableNode, name: str, context: Context) -> Type | None:
-        """Infer __init__ argument type for an attribute.
-
-        In particular, possibly use the signature of __set__.
-        """
-        default = sym.type
-        if sym.implicit:
-            return default
-        t = get_proper_type(sym.type)
-
-        # Perform a simple-minded inference from the signature of __set__, if present.
-        # We can't use mypy.checkmember here, since this plugin runs before type checking.
-        # We only support some basic scanerios here, which is hopefully sufficient for
-        # the vast majority of use cases.
-        if not isinstance(t, Instance):
-            return default
-        setter = t.type.get('__set__')
-        if setter:
-            if isinstance(setter.node, FuncDef):
-                super_info = t.type.get_containing_type_info('__set__')
-                assert super_info
-                if setter.type:
-                    setter_type = get_proper_type(map_type_from_supertype(setter.type, t.type, super_info))
-                else:
-                    return AnyType(TypeOfAny.unannotated)
-                if isinstance(setter_type, CallableType) and setter_type.arg_kinds == [
-                    ARG_POS,
-                    ARG_POS,
-                    ARG_POS,
-                ]:
-                    return expand_type_by_instance(setter_type.arg_types[2], t)
-                else:
-                    self._api.fail(f'Unsupported signature for "__set__" in "{t.type.name}"', context)
-            else:
-                self._api.fail(f'Unsupported "__set__" in "{t.type.name}"', context)
-
-        return default
-
-    def add_initializer(
-        self, fields: list[PydanticModelField], config: ModelConfigData, is_settings: bool, is_root_model: bool
-    ) -> None:
-        """Adds a fields-aware `__init__` method to the class.
+        Adds a fields-aware `__init__` method to the class.
 
         The added `__init__` will be annotated with types vs. all `Any` depending on the plugin settings.
         """
-        if '__init__' in self._cls.info.names and not self._cls.info.names['__init__'].plugin_generated:
-            return  # Don't generate an __init__ if one already exists
-
+        ctx = self._ctx
         typed = self.plugin_config.init_typed
-        use_alias = config.populate_by_name is not True
-        requires_dynamic_aliases = bool(config.has_alias_generator and not config.populate_by_name)
-        with state.strict_optional_set(self._api.options.strict_optional):
-            args = self.get_field_arguments(
-                fields,
-                typed=typed,
-                requires_dynamic_aliases=requires_dynamic_aliases,
-                use_alias=use_alias,
-                is_settings=is_settings,
-            )
-
-            if is_root_model and MYPY_VERSION_TUPLE <= (1, 0, 1):
-                # convert root argument to positional argument
-                # This is needed because mypy support for `dataclass_transform` isn't complete on 1.0.1
-                args[0].kind = ARG_POS if args[0].kind == ARG_NAMED else ARG_OPT
-
-            if is_settings:
-                base_settings_node = self._api.lookup_fully_qualified(BASESETTINGS_FULLNAME).node
-                if '__init__' in base_settings_node.names:
-                    base_settings_init_node = base_settings_node.names['__init__'].node
-                    if base_settings_init_node is not None and base_settings_init_node.type is not None:
-                        func_type = base_settings_init_node.type
-                        for arg_idx, arg_name in enumerate(func_type.arg_names):
-                            if arg_name.startswith('__') or not arg_name.startswith('_'):
-                                continue
-                            analyzed_variable_type = self._api.anal_type(func_type.arg_types[arg_idx])
-                            variable = Var(arg_name, analyzed_variable_type)
-                            args.append(Argument(variable, analyzed_variable_type, None, ARG_OPT))
-
+        use_alias = config.allow_population_by_field_name is not True
+        force_all_optional = is_settings or bool(
+            config.has_alias_generator and not config.allow_population_by_field_name
+        )
+        init_arguments = self.get_field_arguments(
+            fields, typed=typed, force_all_optional=force_all_optional, use_alias=use_alias
+        )
         if not self.should_init_forbid_extra(fields, config):
             var = Var('kwargs')
-            args.append(Argument(var, AnyType(TypeOfAny.explicit), None, ARG_STAR2))
+            init_arguments.append(Argument(var, AnyType(TypeOfAny.explicit), None, ARG_STAR2))
 
-        add_method(self._api, self._cls, '__init__', args=args, return_type=NoneType())
+        if '__init__' not in ctx.cls.info.names:
+            add_method(ctx, '__init__', init_arguments, NoneType())
 
-    def add_model_construct_method(
-        self, fields: list[PydanticModelField], config: ModelConfigData, is_settings: bool
-    ) -> None:
-        """Adds a fully typed `model_construct` classmethod to the class.
+    def add_construct_method(self, fields: List['PydanticModelField']) -> None:
+        """
+        Adds a fully typed `construct` classmethod to the class.
 
         Similar to the fields-aware __init__ method, but always uses the field names (not aliases),
         and does not treat settings fields as optional.
         """
-        set_str = self._api.named_type(f'{BUILTINS_NAME}.set', [self._api.named_type(f'{BUILTINS_NAME}.str')])
+        ctx = self._ctx
+        set_str = ctx.api.named_type(f'{BUILTINS_NAME}.set', [ctx.api.named_type(f'{BUILTINS_NAME}.str')])
         optional_set_str = UnionType([set_str, NoneType()])
         fields_set_argument = Argument(Var('_fields_set', optional_set_str), optional_set_str, None, ARG_OPT)
-        with state.strict_optional_set(self._api.options.strict_optional):
-            args = self.get_field_arguments(
-                fields, typed=True, requires_dynamic_aliases=False, use_alias=False, is_settings=is_settings
-            )
-        if not self.should_init_forbid_extra(fields, config):
-            var = Var('kwargs')
-            args.append(Argument(var, AnyType(TypeOfAny.explicit), None, ARG_STAR2))
+        construct_arguments = self.get_field_arguments(fields, typed=True, force_all_optional=False, use_alias=False)
+        construct_arguments = [fields_set_argument] + construct_arguments
 
-        args = [fields_set_argument] + args
+        obj_type = ctx.api.named_type(f'{BUILTINS_NAME}.object')
+        self_tvar_name = '_PydanticBaseModel'  # Make sure it does not conflict with other names in the class
+        tvar_fullname = ctx.cls.fullname + '.' + self_tvar_name
+        tvd = TypeVarDef(self_tvar_name, tvar_fullname, -1, [], obj_type)
+        self_tvar_expr = TypeVarExpr(self_tvar_name, tvar_fullname, [], obj_type)
+        ctx.cls.info.names[self_tvar_name] = SymbolTableNode(MDEF, self_tvar_expr)
+
+        # Backward-compatible with TypeVarDef from Mypy 0.910.
+        if isinstance(tvd, TypeVarType):
+            self_type = tvd
+        else:
+            self_type = TypeVarType(tvd)  # type: ignore[call-arg]
 
         add_method(
-            self._api,
-            self._cls,
-            'model_construct',
-            args=args,
-            return_type=fill_typevars(self._cls.info),
+            ctx,
+            'construct',
+            construct_arguments,
+            return_type=self_type,
+            self_type=self_type,
+            tvar_def=tvd,
             is_classmethod=True,
         )
 
-    def set_frozen(self, fields: list[PydanticModelField], api: SemanticAnalyzerPluginInterface, frozen: bool) -> None:
-        """Marks all fields as properties so that attempts to set them trigger mypy errors.
+    def set_frozen(self, fields: List['PydanticModelField'], frozen: bool) -> None:
+        """
+        Marks all fields as properties so that attempts to set them trigger mypy errors.
 
         This is the same approach used by the attrs and dataclasses plugins.
         """
-        info = self._cls.info
+        info = self._ctx.cls.info
         for field in fields:
             sym_node = info.names.get(field.name)
             if sym_node is not None:
                 var = sym_node.node
-                if isinstance(var, Var):
-                    var.is_property = frozen
-                elif isinstance(var, PlaceholderNode) and not self._api.final_iteration:
-                    # See https://github.com/pydantic/pydantic/issues/5191 to hit this branch for test coverage
-                    self._api.defer()
-                else:  # pragma: no cover
-                    # I don't know whether it's possible to hit this branch, but I've added it for safety
-                    try:
-                        var_str = str(var)
-                    except TypeError:
-                        # This happens for PlaceholderNode; perhaps it will happen for other types in the future..
-                        var_str = repr(var)
-                    detail = f'sym_node.node: {var_str} (of type {var.__class__})'
-                    error_unexpected_behavior(detail, self._api, self._cls)
+                assert isinstance(var, Var)
+                var.is_property = frozen
             else:
-                var = field.to_var(info, api, use_alias=False)
+                var = field.to_var(info, use_alias=False)
                 var.info = info
                 var.is_property = frozen
-                var._fullname = info.fullname + '.' + var.name
-                info.names[var.name] = SymbolTableNode(MDEF, var)
+                var._fullname = get_fullname(info) + '.' + get_name(var)
+                info.names[get_name(var)] = SymbolTableNode(MDEF, var)
 
-    def get_config_update(self, name: str, arg: Expression) -> ModelConfigData | None:
-        """Determines the config update due to a single kwarg in the ConfigDict definition.
+    def get_config_update(self, substmt: AssignmentStmt) -> Optional['ModelConfigData']:
+        """
+        Determines the config update due to a single statement in the Config class definition.
 
         Warns if a tracked config attribute is set to a value the plugin doesn't know how to interpret (e.g., an int)
         """
-        if name not in self.tracked_config_fields:
+        lhs = substmt.lvalues[0]
+        if not (isinstance(lhs, NameExpr) and lhs.name in self.tracked_config_fields):
             return None
-        if name == 'extra':
-            if isinstance(arg, StrExpr):
-                forbid_extra = arg.value == 'forbid'
-            elif isinstance(arg, MemberExpr):
-                forbid_extra = arg.name == 'forbid'
+        if lhs.name == 'extra':
+            if isinstance(substmt.rvalue, StrExpr):
+                forbid_extra = substmt.rvalue.value == 'forbid'
+            elif isinstance(substmt.rvalue, MemberExpr):
+                forbid_extra = substmt.rvalue.name == 'forbid'
             else:
-                error_invalid_config_value(name, self._api, arg)
+                error_invalid_config_value(lhs.name, self._ctx.api, substmt)
                 return None
             return ModelConfigData(forbid_extra=forbid_extra)
-        if name == 'alias_generator':
+        if lhs.name == 'alias_generator':
             has_alias_generator = True
-            if isinstance(arg, NameExpr) and arg.fullname == 'builtins.None':
+            if isinstance(substmt.rvalue, NameExpr) and substmt.rvalue.fullname == 'builtins.None':
                 has_alias_generator = False
             return ModelConfigData(has_alias_generator=has_alias_generator)
-        if isinstance(arg, NameExpr) and arg.fullname in ('builtins.True', 'builtins.False'):
-            return ModelConfigData(**{name: arg.fullname == 'builtins.True'})
-        error_invalid_config_value(name, self._api, arg)
+        if isinstance(substmt.rvalue, NameExpr) and substmt.rvalue.fullname in ('builtins.True', 'builtins.False'):
+            return ModelConfigData(**{lhs.name: substmt.rvalue.fullname == 'builtins.True'})
+        error_invalid_config_value(lhs.name, self._ctx.api, substmt)
         return None
 
     @staticmethod
-    def get_has_default(stmt: AssignmentStmt) -> bool:
-        """Returns a boolean indicating whether the field defined in `stmt` is a required field."""
+    def get_is_required(cls: ClassDef, stmt: AssignmentStmt, lhs: NameExpr) -> bool:
+        """
+        Returns a boolean indicating whether the field defined in `stmt` is a required field.
+        """
         expr = stmt.rvalue
         if isinstance(expr, TempNode):
-            # TempNode means annotation-only, so has no default
-            return False
+            # TempNode means annotation-only, so only non-required if Optional
+            value_type = get_proper_type(cls.info[lhs.name].type)
+            if isinstance(value_type, UnionType) and any(isinstance(item, NoneType) for item in value_type.items):
+                # Annotated as Optional, or otherwise having NoneType in the union
+                return False
+            return True
         if isinstance(expr, CallExpr) and isinstance(expr.callee, RefExpr) and expr.callee.fullname == FIELD_FULLNAME:
-            # The "default value" is a call to `Field`; at this point, the field has a default if and only if:
-            # * there is a positional argument that is not `...`
-            # * there is a keyword argument named "default" that is not `...`
-            # * there is a "default_factory" that is not `None`
+            # The "default value" is a call to `Field`; at this point, the field is
+            # only required if default is Ellipsis (i.e., `field_name: Annotation = Field(...)`) or if default_factory
+            # is specified.
             for arg, name in zip(expr.args, expr.arg_names):
-                # If name is None, then this arg is the default because it is the only positional argument.
+                # If name is None, then this arg is the default because it is the only positonal argument.
                 if name is None or name == 'default':
-                    return arg.__class__ is not EllipsisExpr
+                    return arg.__class__ is EllipsisExpr
                 if name == 'default_factory':
-                    return not (isinstance(arg, NameExpr) and arg.fullname == 'builtins.None')
-            return False
-        # Has no default if the "default value" is Ellipsis (i.e., `field_name: Annotation = ...`)
-        return not isinstance(expr, EllipsisExpr)
+                    return False
+            return True
+        # Only required if the "default value" is Ellipsis (i.e., `field_name: Annotation = ...`)
+        return isinstance(expr, EllipsisExpr)
 
     @staticmethod
-    def get_alias_info(stmt: AssignmentStmt) -> tuple[str | None, bool]:
-        """Returns a pair (alias, has_dynamic_alias), extracted from the declaration of the field defined in `stmt`.
+    def get_alias_info(stmt: AssignmentStmt) -> Tuple[Optional[str], bool]:
+        """
+        Returns a pair (alias, has_dynamic_alias), extracted from the declaration of the field defined in `stmt`.
 
         `has_dynamic_alias` is True if and only if an alias is provided, but not as a string literal.
         If `has_dynamic_alias` is True, `alias` will be None.
@@ -1033,38 +573,29 @@ class PydanticModelTransformer:
         return None, False
 
     def get_field_arguments(
-        self,
-        fields: list[PydanticModelField],
-        typed: bool,
-        use_alias: bool,
-        requires_dynamic_aliases: bool,
-        is_settings: bool,
-    ) -> list[Argument]:
-        """Helper function used during the construction of the `__init__` and `model_construct` method signatures.
+        self, fields: List['PydanticModelField'], typed: bool, force_all_optional: bool, use_alias: bool
+    ) -> List[Argument]:
+        """
+        Helper function used during the construction of the `__init__` and `construct` method signatures.
 
         Returns a list of mypy Argument instances for use in the generated signatures.
         """
-        info = self._cls.info
+        info = self._ctx.cls.info
         arguments = [
-            field.to_argument(
-                info,
-                typed=typed,
-                force_optional=requires_dynamic_aliases or is_settings,
-                use_alias=use_alias,
-                api=self._api,
-            )
+            field.to_argument(info, typed=typed, force_optional=force_all_optional, use_alias=use_alias)
             for field in fields
             if not (use_alias and field.has_dynamic_alias)
         ]
         return arguments
 
-    def should_init_forbid_extra(self, fields: list[PydanticModelField], config: ModelConfigData) -> bool:
-        """Indicates whether the generated `__init__` should get a `**kwargs` at the end of its signature.
+    def should_init_forbid_extra(self, fields: List['PydanticModelField'], config: 'ModelConfigData') -> bool:
+        """
+        Indicates whether the generated `__init__` should get a `**kwargs` at the end of its signature
 
         We disallow arbitrary kwargs if the extra config setting is "forbid", or if the plugin config says to,
         *unless* a required dynamic alias is present (since then we can't determine a valid signature).
         """
-        if not config.populate_by_name:
+        if not config.allow_population_by_field_name:
             if self.is_dynamic_alias_present(fields, bool(config.has_alias_generator)):
                 return False
         if config.forbid_extra:
@@ -1072,8 +603,9 @@ class PydanticModelTransformer:
         return self.plugin_config.init_forbid_extra
 
     @staticmethod
-    def is_dynamic_alias_present(fields: list[PydanticModelField], has_alias_generator: bool) -> bool:
-        """Returns whether any fields on the model have a "dynamic alias", i.e., an alias that cannot be
+    def is_dynamic_alias_present(fields: List['PydanticModelField'], has_alias_generator: bool) -> bool:
+        """
+        Returns whether any fields on the model have a "dynamic alias", i.e., an alias that cannot be
         determined during static analysis.
         """
         for field in fields:
@@ -1086,74 +618,95 @@ class PydanticModelTransformer:
         return False
 
 
-class ModelConfigData:
-    """Pydantic mypy plugin model config class."""
+class PydanticModelField:
+    def __init__(
+        self, name: str, is_required: bool, alias: Optional[str], has_dynamic_alias: bool, line: int, column: int
+    ):
+        self.name = name
+        self.is_required = is_required
+        self.alias = alias
+        self.has_dynamic_alias = has_dynamic_alias
+        self.line = line
+        self.column = column
 
+    def to_var(self, info: TypeInfo, use_alias: bool) -> Var:
+        name = self.name
+        if use_alias and self.alias is not None:
+            name = self.alias
+        return Var(name, info[self.name].type)
+
+    def to_argument(self, info: TypeInfo, typed: bool, force_optional: bool, use_alias: bool) -> Argument:
+        if typed and info[self.name].type is not None:
+            type_annotation = info[self.name].type
+        else:
+            type_annotation = AnyType(TypeOfAny.explicit)
+        return Argument(
+            variable=self.to_var(info, use_alias),
+            type_annotation=type_annotation,
+            initializer=None,
+            kind=ARG_NAMED_OPT if force_optional or not self.is_required else ARG_NAMED,
+        )
+
+    def serialize(self) -> JsonDict:
+        return self.__dict__
+
+    @classmethod
+    def deserialize(cls, info: TypeInfo, data: JsonDict) -> 'PydanticModelField':
+        return cls(**data)
+
+
+class ModelConfigData:
     def __init__(
         self,
-        forbid_extra: bool | None = None,
-        frozen: bool | None = None,
-        from_attributes: bool | None = None,
-        populate_by_name: bool | None = None,
-        has_alias_generator: bool | None = None,
+        forbid_extra: Optional[bool] = None,
+        allow_mutation: Optional[bool] = None,
+        frozen: Optional[bool] = None,
+        orm_mode: Optional[bool] = None,
+        allow_population_by_field_name: Optional[bool] = None,
+        has_alias_generator: Optional[bool] = None,
     ):
         self.forbid_extra = forbid_extra
+        self.allow_mutation = allow_mutation
         self.frozen = frozen
-        self.from_attributes = from_attributes
-        self.populate_by_name = populate_by_name
+        self.orm_mode = orm_mode
+        self.allow_population_by_field_name = allow_population_by_field_name
         self.has_alias_generator = has_alias_generator
 
-    def get_values_dict(self) -> dict[str, Any]:
-        """Returns a dict of Pydantic model config names to their values.
-
-        It includes the config if config value is not `None`.
-        """
+    def set_values_dict(self) -> Dict[str, Any]:
         return {k: v for k, v in self.__dict__.items() if v is not None}
 
-    def update(self, config: ModelConfigData | None) -> None:
-        """Update Pydantic model config values."""
+    def update(self, config: Optional['ModelConfigData']) -> None:
         if config is None:
             return
-        for k, v in config.get_values_dict().items():
+        for k, v in config.set_values_dict().items():
             setattr(self, k, v)
 
     def setdefault(self, key: str, value: Any) -> None:
-        """Set default value for Pydantic model config if config value is `None`."""
         if getattr(self, key) is None:
             setattr(self, key, value)
 
 
-ERROR_ORM = ErrorCode('pydantic-orm', 'Invalid from_attributes call', 'Pydantic')
+ERROR_ORM = ErrorCode('pydantic-orm', 'Invalid from_orm call', 'Pydantic')
 ERROR_CONFIG = ErrorCode('pydantic-config', 'Invalid config value', 'Pydantic')
 ERROR_ALIAS = ErrorCode('pydantic-alias', 'Dynamic alias disallowed', 'Pydantic')
 ERROR_UNEXPECTED = ErrorCode('pydantic-unexpected', 'Unexpected behavior', 'Pydantic')
 ERROR_UNTYPED = ErrorCode('pydantic-field', 'Untyped field disallowed', 'Pydantic')
 ERROR_FIELD_DEFAULTS = ErrorCode('pydantic-field', 'Invalid Field defaults', 'Pydantic')
-ERROR_EXTRA_FIELD_ROOT_MODEL = ErrorCode('pydantic-field', 'Extra field on RootModel subclass', 'Pydantic')
 
 
-def error_from_attributes(model_name: str, api: CheckerPluginInterface, context: Context) -> None:
-    """Emits an error when the model does not have `from_attributes=True`."""
-    api.fail(f'"{model_name}" does not have from_attributes=True', context, code=ERROR_ORM)
+def error_from_orm(model_name: str, api: CheckerPluginInterface, context: Context) -> None:
+    api.fail(f'"{model_name}" does not have orm_mode=True', context, code=ERROR_ORM)
 
 
 def error_invalid_config_value(name: str, api: SemanticAnalyzerPluginInterface, context: Context) -> None:
-    """Emits an error when the config value is invalid."""
     api.fail(f'Invalid value for "Config.{name}"', context, code=ERROR_CONFIG)
 
 
 def error_required_dynamic_aliases(api: SemanticAnalyzerPluginInterface, context: Context) -> None:
-    """Emits required dynamic aliases error.
-
-    This will be called when `warn_required_dynamic_aliases=True`.
-    """
     api.fail('Required dynamic aliases disallowed', context, code=ERROR_ALIAS)
 
 
-def error_unexpected_behavior(
-    detail: str, api: CheckerPluginInterface | SemanticAnalyzerPluginInterface, context: Context
-) -> None:  # pragma: no cover
-    """Emits unexpected behavior error."""
+def error_unexpected_behavior(detail: str, api: CheckerPluginInterface, context: Context) -> None:  # pragma: no cover
     # Can't think of a good way to test this, but I confirmed it renders as desired by adding to a non-error path
     link = 'https://github.com/pydantic/pydantic/issues/new/choose'
     full_message = f'The pydantic mypy plugin ran into unexpected behavior: {detail}\n'
@@ -1162,70 +715,55 @@ def error_unexpected_behavior(
 
 
 def error_untyped_fields(api: SemanticAnalyzerPluginInterface, context: Context) -> None:
-    """Emits an error when there is an untyped field in the model."""
     api.fail('Untyped fields disallowed', context, code=ERROR_UNTYPED)
 
 
-def error_extra_fields_on_root_model(api: CheckerPluginInterface, context: Context) -> None:
-    """Emits an error when there is more than just a root field defined for a subclass of RootModel."""
-    api.fail('Only `root` is allowed as a field of a `RootModel`', context, code=ERROR_EXTRA_FIELD_ROOT_MODEL)
-
-
 def error_default_and_default_factory_specified(api: CheckerPluginInterface, context: Context) -> None:
-    """Emits an error when `Field` has both `default` and `default_factory` together."""
     api.fail('Field default and default_factory cannot be specified together', context, code=ERROR_FIELD_DEFAULTS)
 
 
 def add_method(
-    api: SemanticAnalyzerPluginInterface | CheckerPluginInterface,
-    cls: ClassDef,
+    ctx: ClassDefContext,
     name: str,
-    args: list[Argument],
+    args: List[Argument],
     return_type: Type,
-    self_type: Type | None = None,
-    tvar_def: TypeVarDef | None = None,
+    self_type: Optional[Type] = None,
+    tvar_def: Optional[TypeVarDef] = None,
     is_classmethod: bool = False,
+    is_new: bool = False,
+    # is_staticmethod: bool = False,
 ) -> None:
-    """Very closely related to `mypy.plugins.common.add_method_to_class`, with a few pydantic-specific changes."""
-    info = cls.info
+    """
+    Adds a new method to a class.
+
+    This can be dropped if/when https://github.com/python/mypy/issues/7301 is merged
+    """
+    info = ctx.cls.info
 
     # First remove any previously generated methods with the same name
     # to avoid clashes and problems in the semantic analyzer.
     if name in info.names:
         sym = info.names[name]
         if sym.plugin_generated and isinstance(sym.node, FuncDef):
-            cls.defs.body.remove(sym.node)  # pragma: no cover
+            ctx.cls.defs.body.remove(sym.node)  # pragma: no cover
 
-    if isinstance(api, SemanticAnalyzerPluginInterface):
-        function_type = api.named_type('builtins.function')
-    else:
-        function_type = api.named_generic_type('builtins.function', [])
-
-    if is_classmethod:
-        self_type = self_type or TypeType(fill_typevars(info))
-        first = [Argument(Var('_cls'), self_type, None, ARG_POS, True)]
+    self_type = self_type or fill_typevars(info)
+    if is_classmethod or is_new:
+        first = [Argument(Var('_cls'), TypeType.make_normalized(self_type), None, ARG_POS)]
+    # elif is_staticmethod:
+    #     first = []
     else:
         self_type = self_type or fill_typevars(info)
-        # `self` is positional *ONLY* here, but this can't be expressed
-        # fully in the mypy internal API. ARG_POS is the closest we can get.
-        # Using ARG_POS will, however, give mypy errors if a `self` field
-        # is present on a model:
-        #
-        #     Name "self" already defined (possibly by an import)  [no-redef]
-        #
-        # As a workaround, we give this argument a name that will
-        # never conflict. By its positional nature, this name will not
-        # be used or exposed to users.
         first = [Argument(Var('__pydantic_self__'), self_type, None, ARG_POS)]
     args = first + args
-
     arg_types, arg_names, arg_kinds = [], [], []
     for arg in args:
         assert arg.type_annotation, 'All arguments must be fully typed.'
         arg_types.append(arg.type_annotation)
-        arg_names.append(arg.variable.name)
+        arg_names.append(get_name(arg.variable))
         arg_kinds.append(arg.kind)
 
+    function_type = ctx.api.named_type(f'{BUILTINS_NAME}.function')
     signature = CallableType(arg_types, arg_kinds, arg_names, return_type, function_type)
     if tvar_def:
         signature.variables = [tvar_def]
@@ -1234,7 +772,8 @@ def add_method(
     func.info = info
     func.type = set_callable_name(signature, func)
     func.is_class = is_classmethod
-    func._fullname = info.fullname + '.' + name
+    # func.is_static = is_staticmethod
+    func._fullname = get_fullname(info) + '.' + name
     func.line = info.line
 
     # NOTE: we would like the plugin generated node to dominate, but we still
@@ -1244,44 +783,68 @@ def add_method(
         r_name = get_unique_redefinition_name(name, info.names)
         info.names[r_name] = info.names[name]
 
-    # Add decorator for is_classmethod
-    # The dataclasses plugin claims this is unnecessary for classmethods, but not including it results in a
-    # signature incompatible with the superclass, which causes mypy errors to occur for every subclass of BaseModel.
-    if is_classmethod:
+    if is_classmethod:  # or is_staticmethod:
         func.is_decorated = True
         v = Var(name, func.type)
         v.info = info
         v._fullname = func._fullname
+        # if is_classmethod:
         v.is_classmethod = True
         dec = Decorator(func, [NameExpr('classmethod')], v)
+        # else:
+        #     v.is_staticmethod = True
+        #     dec = Decorator(func, [NameExpr('staticmethod')], v)
+
         dec.line = info.line
         sym = SymbolTableNode(MDEF, dec)
     else:
         sym = SymbolTableNode(MDEF, func)
     sym.plugin_generated = True
-    info.names[name] = sym
 
+    info.names[name] = sym
     info.defn.defs.body.append(func)
 
 
-def parse_toml(config_file: str) -> dict[str, Any] | None:
-    """Returns a dict of config keys to values.
-
-    It reads configs from toml file and returns `None` if the file is not a toml file.
+def get_fullname(x: Union[FuncBase, SymbolNode]) -> str:
     """
+    Used for compatibility with mypy 0.740; can be dropped once support for 0.740 is dropped.
+    """
+    fn = x.fullname
+    if callable(fn):  # pragma: no cover
+        return fn()
+    return fn
+
+
+def get_name(x: Union[FuncBase, SymbolNode]) -> str:
+    """
+    Used for compatibility with mypy 0.740; can be dropped once support for 0.740 is dropped.
+    """
+    fn = x.name
+    if callable(fn):  # pragma: no cover
+        return fn()
+    return fn
+
+
+def parse_toml(config_file: str) -> Optional[Dict[str, Any]]:
     if not config_file.endswith('.toml'):
         return None
 
+    read_mode = 'rb'
     if sys.version_info >= (3, 11):
         import tomllib as toml_
     else:
         try:
             import tomli as toml_
-        except ImportError:  # pragma: no cover
-            import warnings
+        except ImportError:
+            # older versions of mypy have toml as a dependency, not tomli
+            read_mode = 'r'
+            try:
+                import toml as toml_  # type: ignore[no-redef]
+            except ImportError:  # pragma: no cover
+                import warnings
 
-            warnings.warn('No TOML parser installed, cannot read configuration from `pyproject.toml`.')
-            return None
+                warnings.warn('No TOML parser installed, cannot read configuration from `pyproject.toml`.')
+                return None
 
-    with open(config_file, 'rb') as rf:
-        return toml_.load(rf)
+    with open(config_file, read_mode) as rf:
+        return toml_.load(rf)  # type: ignore[arg-type]
diff --git a/lib/pydantic/networks.py b/lib/pydantic/networks.py
index 6d9d292f..c7d97186 100644
--- a/lib/pydantic/networks.py
+++ b/lib/pydantic/networks.py
@@ -1,35 +1,80 @@
-"""The networks module contains types for common network-related fields."""
-from __future__ import annotations as _annotations
-
-import dataclasses as _dataclasses
 import re
-from importlib.metadata import version
-from ipaddress import IPv4Address, IPv4Interface, IPv4Network, IPv6Address, IPv6Interface, IPv6Network
-from typing import TYPE_CHECKING, Any
+from ipaddress import (
+    IPv4Address,
+    IPv4Interface,
+    IPv4Network,
+    IPv6Address,
+    IPv6Interface,
+    IPv6Network,
+    _BaseAddress,
+    _BaseNetwork,
+)
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Collection,
+    Dict,
+    Generator,
+    List,
+    Match,
+    Optional,
+    Pattern,
+    Set,
+    Tuple,
+    Type,
+    Union,
+    cast,
+    no_type_check,
+)
 
-from pydantic_core import MultiHostUrl, PydanticCustomError, Url, core_schema
-from typing_extensions import Annotated, TypeAlias
-
-from ._internal import _fields, _repr, _schema_generation_shared
-from ._migration import getattr_migration
-from .annotated_handlers import GetCoreSchemaHandler
-from .json_schema import JsonSchemaValue
+from . import errors
+from .utils import Representation, update_not_none
+from .validators import constr_length_validator, str_validator
 
 if TYPE_CHECKING:
     import email_validator
+    from typing_extensions import TypedDict
 
-    NetworkType: TypeAlias = 'str | bytes | int | tuple[str | bytes | int, str | int]'
+    from .config import BaseConfig
+    from .fields import ModelField
+    from .typing import AnyCallable
+
+    CallableGenerator = Generator[AnyCallable, None, None]
+
+    class Parts(TypedDict, total=False):
+        scheme: str
+        user: Optional[str]
+        password: Optional[str]
+        ipv4: Optional[str]
+        ipv6: Optional[str]
+        domain: Optional[str]
+        port: Optional[str]
+        path: Optional[str]
+        query: Optional[str]
+        fragment: Optional[str]
+
+    class HostParts(TypedDict, total=False):
+        host: str
+        tld: Optional[str]
+        host_type: Optional[str]
+        port: Optional[str]
+        rebuild: bool
 
 else:
     email_validator = None
 
+    class Parts(dict):
+        pass
+
+
+NetworkType = Union[str, bytes, int, Tuple[Union[str, bytes, int], Union[str, int]]]
 
 __all__ = [
     'AnyUrl',
     'AnyHttpUrl',
     'FileUrl',
     'HttpUrl',
-    'UrlConstraints',
+    'stricturl',
     'EmailStr',
     'NameEmail',
     'IPvAnyAddress',
@@ -41,321 +86,489 @@ __all__ = [
     'RedisDsn',
     'MongoDsn',
     'KafkaDsn',
-    'NatsDsn',
     'validate_email',
-    'MySQLDsn',
-    'MariaDBDsn',
 ]
 
+_url_regex_cache = None
+_multi_host_url_regex_cache = None
+_ascii_domain_regex_cache = None
+_int_domain_regex_cache = None
+_host_regex_cache = None
 
-@_dataclasses.dataclass
-class UrlConstraints(_fields.PydanticMetadata):
-    """Url constraints.
+_host_regex = (
+    r'(?:'
+    r'(?P<ipv4>(?:\d{1,3}\.){3}\d{1,3})(?=$|[/:#?])|'  # ipv4
+    r'(?P<ipv6>\[[A-F0-9]*:[A-F0-9:]+\])(?=$|[/:#?])|'  # ipv6
+    r'(?P<domain>[^\s/:?#]+)'  # domain, validation occurs later
+    r')?'
+    r'(?::(?P<port>\d+))?'  # port
+)
+_scheme_regex = r'(?:(?P<scheme>[a-z][a-z0-9+\-.]+)://)?'  # scheme https://tools.ietf.org/html/rfc3986#appendix-A
+_user_info_regex = r'(?:(?P<user>[^\s:/]*)(?::(?P<password>[^\s/]*))?@)?'
+_path_regex = r'(?P<path>/[^\s?#]*)?'
+_query_regex = r'(?:\?(?P<query>[^\s#]*))?'
+_fragment_regex = r'(?:#(?P<fragment>[^\s#]*))?'
 
-    Attributes:
-        max_length: The maximum length of the url. Defaults to `None`.
-        allowed_schemes: The allowed schemes. Defaults to `None`.
-        host_required: Whether the host is required. Defaults to `None`.
-        default_host: The default host. Defaults to `None`.
-        default_port: The default port. Defaults to `None`.
-        default_path: The default path. Defaults to `None`.
+
+def url_regex() -> Pattern[str]:
+    global _url_regex_cache
+    if _url_regex_cache is None:
+        _url_regex_cache = re.compile(
+            rf'{_scheme_regex}{_user_info_regex}{_host_regex}{_path_regex}{_query_regex}{_fragment_regex}',
+            re.IGNORECASE,
+        )
+    return _url_regex_cache
+
+
+def multi_host_url_regex() -> Pattern[str]:
     """
+    Compiled multi host url regex.
 
-    max_length: int | None = None
-    allowed_schemes: list[str] | None = None
-    host_required: bool | None = None
-    default_host: str | None = None
-    default_port: int | None = None
-    default_path: str | None = None
+    Additionally to `url_regex` it allows to match multiple hosts.
+    E.g. host1.db.net,host2.db.net
+    """
+    global _multi_host_url_regex_cache
+    if _multi_host_url_regex_cache is None:
+        _multi_host_url_regex_cache = re.compile(
+            rf'{_scheme_regex}{_user_info_regex}'
+            r'(?P<hosts>([^/]*))'  # validation occurs later
+            rf'{_path_regex}{_query_regex}{_fragment_regex}',
+            re.IGNORECASE,
+        )
+    return _multi_host_url_regex_cache
 
-    def __hash__(self) -> int:
-        return hash(
-            (
-                self.max_length,
-                tuple(self.allowed_schemes) if self.allowed_schemes is not None else None,
-                self.host_required,
-                self.default_host,
-                self.default_port,
-                self.default_path,
-            )
+
+def ascii_domain_regex() -> Pattern[str]:
+    global _ascii_domain_regex_cache
+    if _ascii_domain_regex_cache is None:
+        ascii_chunk = r'[_0-9a-z](?:[-_0-9a-z]{0,61}[_0-9a-z])?'
+        ascii_domain_ending = r'(?P<tld>\.[a-z]{2,63})?\.?'
+        _ascii_domain_regex_cache = re.compile(
+            fr'(?:{ascii_chunk}\.)*?{ascii_chunk}{ascii_domain_ending}', re.IGNORECASE
+        )
+    return _ascii_domain_regex_cache
+
+
+def int_domain_regex() -> Pattern[str]:
+    global _int_domain_regex_cache
+    if _int_domain_regex_cache is None:
+        int_chunk = r'[_0-9a-\U00040000](?:[-_0-9a-\U00040000]{0,61}[_0-9a-\U00040000])?'
+        int_domain_ending = r'(?P<tld>(\.[^\W\d_]{2,63})|(\.(?:xn--)[_0-9a-z-]{2,63}))?\.?'
+        _int_domain_regex_cache = re.compile(fr'(?:{int_chunk}\.)*?{int_chunk}{int_domain_ending}', re.IGNORECASE)
+    return _int_domain_regex_cache
+
+
+def host_regex() -> Pattern[str]:
+    global _host_regex_cache
+    if _host_regex_cache is None:
+        _host_regex_cache = re.compile(
+            _host_regex,
+            re.IGNORECASE,
+        )
+    return _host_regex_cache
+
+
+class AnyUrl(str):
+    strip_whitespace = True
+    min_length = 1
+    max_length = 2**16
+    allowed_schemes: Optional[Collection[str]] = None
+    tld_required: bool = False
+    user_required: bool = False
+    host_required: bool = True
+    hidden_parts: Set[str] = set()
+
+    __slots__ = ('scheme', 'user', 'password', 'host', 'tld', 'host_type', 'port', 'path', 'query', 'fragment')
+
+    @no_type_check
+    def __new__(cls, url: Optional[str], **kwargs) -> object:
+        return str.__new__(cls, cls.build(**kwargs) if url is None else url)
+
+    def __init__(
+        self,
+        url: str,
+        *,
+        scheme: str,
+        user: Optional[str] = None,
+        password: Optional[str] = None,
+        host: Optional[str] = None,
+        tld: Optional[str] = None,
+        host_type: str = 'domain',
+        port: Optional[str] = None,
+        path: Optional[str] = None,
+        query: Optional[str] = None,
+        fragment: Optional[str] = None,
+    ) -> None:
+        str.__init__(url)
+        self.scheme = scheme
+        self.user = user
+        self.password = password
+        self.host = host
+        self.tld = tld
+        self.host_type = host_type
+        self.port = port
+        self.path = path
+        self.query = query
+        self.fragment = fragment
+
+    @classmethod
+    def build(
+        cls,
+        *,
+        scheme: str,
+        user: Optional[str] = None,
+        password: Optional[str] = None,
+        host: str,
+        port: Optional[str] = None,
+        path: Optional[str] = None,
+        query: Optional[str] = None,
+        fragment: Optional[str] = None,
+        **_kwargs: str,
+    ) -> str:
+        parts = Parts(
+            scheme=scheme,
+            user=user,
+            password=password,
+            host=host,
+            port=port,
+            path=path,
+            query=query,
+            fragment=fragment,
+            **_kwargs,  # type: ignore[misc]
         )
 
+        url = scheme + '://'
+        if user:
+            url += user
+        if password:
+            url += ':' + password
+        if user or password:
+            url += '@'
+        url += host
+        if port and ('port' not in cls.hidden_parts or cls.get_default_parts(parts).get('port') != port):
+            url += ':' + port
+        if path:
+            url += path
+        if query:
+            url += '?' + query
+        if fragment:
+            url += '#' + fragment
+        return url
 
-AnyUrl = Url
-"""Base type for all URLs.
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        update_not_none(field_schema, minLength=cls.min_length, maxLength=cls.max_length, format='uri')
 
-* Any scheme allowed
-* Top-level domain (TLD) not required
-* Host required
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield cls.validate
 
-Assuming an input URL of `http://samuel:pass@example.com:8000/the/path/?query=here#fragment=is;this=bit`,
-the types export the following properties:
+    @classmethod
+    def validate(cls, value: Any, field: 'ModelField', config: 'BaseConfig') -> 'AnyUrl':
+        if value.__class__ == cls:
+            return value
+        value = str_validator(value)
+        if cls.strip_whitespace:
+            value = value.strip()
+        url: str = cast(str, constr_length_validator(value, field, config))
 
-- `scheme`: the URL scheme (`http`), always set.
-- `host`: the URL host (`example.com`), always set.
-- `username`: optional username if included (`samuel`).
-- `password`: optional password if included (`pass`).
-- `port`: optional port (`8000`).
-- `path`: optional path (`/the/path/`).
-- `query`: optional URL query (for example, `GET` arguments or "search string", such as `query=here`).
-- `fragment`: optional fragment (`fragment=is;this=bit`).
-"""
-AnyHttpUrl = Annotated[Url, UrlConstraints(allowed_schemes=['http', 'https'])]
-"""A type that will accept any http or https URL.
+        m = cls._match_url(url)
+        # the regex should always match, if it doesn't please report with details of the URL tried
+        assert m, 'URL regex failed unexpectedly'
 
-* TLD not required
-* Host required
-"""
-HttpUrl = Annotated[Url, UrlConstraints(max_length=2083, allowed_schemes=['http', 'https'])]
-"""A type that will accept any http or https URL.
+        original_parts = cast('Parts', m.groupdict())
+        parts = cls.apply_default_parts(original_parts)
+        parts = cls.validate_parts(parts)
 
-* TLD required
-* Host required
-* Max length 2083
+        if m.end() != len(url):
+            raise errors.UrlExtraError(extra=url[m.end() :])
 
-```py
-from pydantic import BaseModel, HttpUrl, ValidationError
+        return cls._build_url(m, url, parts)
 
-class MyModel(BaseModel):
-    url: HttpUrl
+    @classmethod
+    def _build_url(cls, m: Match[str], url: str, parts: 'Parts') -> 'AnyUrl':
+        """
+        Validate hosts and build the AnyUrl object. Split from `validate` so this method
+        can be altered in `MultiHostDsn`.
+        """
+        host, tld, host_type, rebuild = cls.validate_host(parts)
 
-m = MyModel(url='http://www.example.com')
-print(m.url)
-#> http://www.example.com/
+        return cls(
+            None if rebuild else url,
+            scheme=parts['scheme'],
+            user=parts['user'],
+            password=parts['password'],
+            host=host,
+            tld=tld,
+            host_type=host_type,
+            port=parts['port'],
+            path=parts['path'],
+            query=parts['query'],
+            fragment=parts['fragment'],
+        )
 
-try:
-    MyModel(url='ftp://invalid.url')
-except ValidationError as e:
-    print(e)
-    '''
-    1 validation error for MyModel
-    url
-      URL scheme should be 'http' or 'https' [type=url_scheme, input_value='ftp://invalid.url', input_type=str]
-    '''
+    @staticmethod
+    def _match_url(url: str) -> Optional[Match[str]]:
+        return url_regex().match(url)
 
-try:
-    MyModel(url='not a url')
-except ValidationError as e:
-    print(e)
-    '''
-    1 validation error for MyModel
-    url
-      Input should be a valid URL, relative URL without a base [type=url_parsing, input_value='not a url', input_type=str]
-    '''
-```
+    @staticmethod
+    def _validate_port(port: Optional[str]) -> None:
+        if port is not None and int(port) > 65_535:
+            raise errors.UrlPortError()
 
-"International domains" (e.g. a URL where the host or TLD includes non-ascii characters) will be encoded via
-[punycode](https://en.wikipedia.org/wiki/Punycode) (see
-[this article](https://www.xudongz.com/blog/2017/idn-phishing/) for a good description of why this is important):
+    @classmethod
+    def validate_parts(cls, parts: 'Parts', validate_port: bool = True) -> 'Parts':
+        """
+        A method used to validate parts of a URL.
+        Could be overridden to set default values for parts if missing
+        """
+        scheme = parts['scheme']
+        if scheme is None:
+            raise errors.UrlSchemeError()
 
-```py
-from pydantic import BaseModel, HttpUrl
+        if cls.allowed_schemes and scheme.lower() not in cls.allowed_schemes:
+            raise errors.UrlSchemePermittedError(set(cls.allowed_schemes))
 
-class MyModel(BaseModel):
-    url: HttpUrl
+        if validate_port:
+            cls._validate_port(parts['port'])
 
-m1 = MyModel(url='http://puny£code.com')
-print(m1.url)
-#> http://xn--punycode-eja.com/
-m2 = MyModel(url='https://www.аррӏе.com/')
-print(m2.url)
-#> https://www.xn--80ak6aa92e.com/
-m3 = MyModel(url='https://www.example.珠宝/')
-print(m3.url)
-#> https://www.example.xn--pbt977c/
-```
+        user = parts['user']
+        if cls.user_required and user is None:
+            raise errors.UrlUserInfoError()
+
+        return parts
+
+    @classmethod
+    def validate_host(cls, parts: 'Parts') -> Tuple[str, Optional[str], str, bool]:
+        tld, host_type, rebuild = None, None, False
+        for f in ('domain', 'ipv4', 'ipv6'):
+            host = parts[f]  # type: ignore[literal-required]
+            if host:
+                host_type = f
+                break
+
+        if host is None:
+            if cls.host_required:
+                raise errors.UrlHostError()
+        elif host_type == 'domain':
+            is_international = False
+            d = ascii_domain_regex().fullmatch(host)
+            if d is None:
+                d = int_domain_regex().fullmatch(host)
+                if d is None:
+                    raise errors.UrlHostError()
+                is_international = True
+
+            tld = d.group('tld')
+            if tld is None and not is_international:
+                d = int_domain_regex().fullmatch(host)
+                assert d is not None
+                tld = d.group('tld')
+                is_international = True
+
+            if tld is not None:
+                tld = tld[1:]
+            elif cls.tld_required:
+                raise errors.UrlHostTldError()
+
+            if is_international:
+                host_type = 'int_domain'
+                rebuild = True
+                host = host.encode('idna').decode('ascii')
+                if tld is not None:
+                    tld = tld.encode('idna').decode('ascii')
+
+        return host, tld, host_type, rebuild  # type: ignore
+
+    @staticmethod
+    def get_default_parts(parts: 'Parts') -> 'Parts':
+        return {}
+
+    @classmethod
+    def apply_default_parts(cls, parts: 'Parts') -> 'Parts':
+        for key, value in cls.get_default_parts(parts).items():
+            if not parts[key]:  # type: ignore[literal-required]
+                parts[key] = value  # type: ignore[literal-required]
+        return parts
+
+    def __repr__(self) -> str:
+        extra = ', '.join(f'{n}={getattr(self, n)!r}' for n in self.__slots__ if getattr(self, n) is not None)
+        return f'{self.__class__.__name__}({super().__repr__()}, {extra})'
 
 
-!!! warning "Underscores in Hostnames"
-    In Pydantic, underscores are allowed in all parts of a domain except the TLD.
-    Technically this might be wrong - in theory the hostname cannot have underscores, but subdomains can.
+class AnyHttpUrl(AnyUrl):
+    allowed_schemes = {'http', 'https'}
 
-    To explain this; consider the following two cases:
+    __slots__ = ()
 
-    - `exam_ple.co.uk`: the hostname is `exam_ple`, which should not be allowed since it contains an underscore.
-    - `foo_bar.example.com` the hostname is `example`, which should be allowed since the underscore is in the subdomain.
 
-    Without having an exhaustive list of TLDs, it would be impossible to differentiate between these two. Therefore
-    underscores are allowed, but you can always do further validation in a validator if desired.
+class HttpUrl(AnyHttpUrl):
+    tld_required = True
+    # https://stackoverflow.com/questions/417142/what-is-the-maximum-length-of-a-url-in-different-browsers
+    max_length = 2083
+    hidden_parts = {'port'}
 
-    Also, Chrome, Firefox, and Safari all currently accept `http://exam_ple.com` as a URL, so we're in good
-    (or at least big) company.
-"""
-FileUrl = Annotated[Url, UrlConstraints(allowed_schemes=['file'])]
-"""A type that will accept any file URL.
+    @staticmethod
+    def get_default_parts(parts: 'Parts') -> 'Parts':
+        return {'port': '80' if parts['scheme'] == 'http' else '443'}
 
-* Host not required
-"""
-PostgresDsn = Annotated[
-    MultiHostUrl,
-    UrlConstraints(
-        host_required=True,
-        allowed_schemes=[
-            'postgres',
-            'postgresql',
-            'postgresql+asyncpg',
-            'postgresql+pg8000',
-            'postgresql+psycopg',
-            'postgresql+psycopg2',
-            'postgresql+psycopg2cffi',
-            'postgresql+py-postgresql',
-            'postgresql+pygresql',
-        ],
-    ),
-]
-"""A type that will accept any Postgres DSN.
 
-* User info required
-* TLD not required
-* Host required
-* Supports multiple hosts
+class FileUrl(AnyUrl):
+    allowed_schemes = {'file'}
+    host_required = False
 
-If further validation is required, these properties can be used by validators to enforce specific behaviour:
+    __slots__ = ()
 
-```py
-from pydantic import (
-    BaseModel,
-    HttpUrl,
-    PostgresDsn,
-    ValidationError,
-    field_validator,
-)
 
-class MyModel(BaseModel):
-    url: HttpUrl
+class MultiHostDsn(AnyUrl):
+    __slots__ = AnyUrl.__slots__ + ('hosts',)
 
-m = MyModel(url='http://www.example.com')
+    def __init__(self, *args: Any, hosts: Optional[List['HostParts']] = None, **kwargs: Any):
+        super().__init__(*args, **kwargs)
+        self.hosts = hosts
 
-# the repr() method for a url will display all properties of the url
-print(repr(m.url))
-#> Url('http://www.example.com/')
-print(m.url.scheme)
-#> http
-print(m.url.host)
-#> www.example.com
-print(m.url.port)
-#> 80
+    @staticmethod
+    def _match_url(url: str) -> Optional[Match[str]]:
+        return multi_host_url_regex().match(url)
 
-class MyDatabaseModel(BaseModel):
-    db: PostgresDsn
+    @classmethod
+    def validate_parts(cls, parts: 'Parts', validate_port: bool = True) -> 'Parts':
+        return super().validate_parts(parts, validate_port=False)
 
-    @field_validator('db')
-    def check_db_name(cls, v):
-        assert v.path and len(v.path) > 1, 'database must be provided'
-        return v
+    @classmethod
+    def _build_url(cls, m: Match[str], url: str, parts: 'Parts') -> 'MultiHostDsn':
+        hosts_parts: List['HostParts'] = []
+        host_re = host_regex()
+        for host in m.groupdict()['hosts'].split(','):
+            d: Parts = host_re.match(host).groupdict()  # type: ignore
+            host, tld, host_type, rebuild = cls.validate_host(d)
+            port = d.get('port')
+            cls._validate_port(port)
+            hosts_parts.append(
+                {
+                    'host': host,
+                    'host_type': host_type,
+                    'tld': tld,
+                    'rebuild': rebuild,
+                    'port': port,
+                }
+            )
 
-m = MyDatabaseModel(db='postgres://user:pass@localhost:5432/foobar')
-print(m.db)
-#> postgres://user:pass@localhost:5432/foobar
+        if len(hosts_parts) > 1:
+            return cls(
+                None if any([hp['rebuild'] for hp in hosts_parts]) else url,
+                scheme=parts['scheme'],
+                user=parts['user'],
+                password=parts['password'],
+                path=parts['path'],
+                query=parts['query'],
+                fragment=parts['fragment'],
+                host_type=None,
+                hosts=hosts_parts,
+            )
+        else:
+            # backwards compatibility with single host
+            host_part = hosts_parts[0]
+            return cls(
+                None if host_part['rebuild'] else url,
+                scheme=parts['scheme'],
+                user=parts['user'],
+                password=parts['password'],
+                host=host_part['host'],
+                tld=host_part['tld'],
+                host_type=host_part['host_type'],
+                port=host_part.get('port'),
+                path=parts['path'],
+                query=parts['query'],
+                fragment=parts['fragment'],
+            )
 
-try:
-    MyDatabaseModel(db='postgres://user:pass@localhost:5432')
-except ValidationError as e:
-    print(e)
-    '''
-    1 validation error for MyDatabaseModel
-    db
-      Assertion failed, database must be provided
-    assert (None)
-     +  where None = MultiHostUrl('postgres://user:pass@localhost:5432').path [type=assertion_error, input_value='postgres://user:pass@localhost:5432', input_type=str]
-    '''
-```
-"""
 
-CockroachDsn = Annotated[
-    Url,
-    UrlConstraints(
-        host_required=True,
-        allowed_schemes=[
-            'cockroachdb',
-            'cockroachdb+psycopg2',
-            'cockroachdb+asyncpg',
-        ],
-    ),
-]
-"""A type that will accept any Cockroach DSN.
+class PostgresDsn(MultiHostDsn):
+    allowed_schemes = {
+        'postgres',
+        'postgresql',
+        'postgresql+asyncpg',
+        'postgresql+pg8000',
+        'postgresql+psycopg2',
+        'postgresql+psycopg2cffi',
+        'postgresql+py-postgresql',
+        'postgresql+pygresql',
+    }
+    user_required = True
 
-* User info required
-* TLD not required
-* Host required
-"""
-AmqpDsn = Annotated[Url, UrlConstraints(allowed_schemes=['amqp', 'amqps'])]
-"""A type that will accept any AMQP DSN.
+    __slots__ = ()
 
-* User info required
-* TLD not required
-* Host required
-"""
-RedisDsn = Annotated[
-    Url,
-    UrlConstraints(allowed_schemes=['redis', 'rediss'], default_host='localhost', default_port=6379, default_path='/0'),
-]
-"""A type that will accept any Redis DSN.
 
-* User info required
-* TLD not required
-* Host required (e.g., `rediss://:pass@localhost`)
-"""
-MongoDsn = Annotated[MultiHostUrl, UrlConstraints(allowed_schemes=['mongodb', 'mongodb+srv'], default_port=27017)]
-"""A type that will accept any MongoDB DSN.
+class CockroachDsn(AnyUrl):
+    allowed_schemes = {
+        'cockroachdb',
+        'cockroachdb+psycopg2',
+        'cockroachdb+asyncpg',
+    }
+    user_required = True
 
-* User info not required
-* Database name not required
-* Port not required
-* User info may be passed without user part (e.g., `mongodb://mongodb0.example.com:27017`).
-"""
-KafkaDsn = Annotated[Url, UrlConstraints(allowed_schemes=['kafka'], default_host='localhost', default_port=9092)]
-"""A type that will accept any Kafka DSN.
 
-* User info required
-* TLD not required
-* Host required
-"""
-NatsDsn = Annotated[
-    MultiHostUrl, UrlConstraints(allowed_schemes=['nats', 'tls', 'ws'], default_host='localhost', default_port=4222)
-]
-"""A type that will accept any NATS DSN.
+class AmqpDsn(AnyUrl):
+    allowed_schemes = {'amqp', 'amqps'}
+    host_required = False
 
-NATS is a connective technology built for the ever increasingly hyper-connected world.
-It is a single technology that enables applications to securely communicate across
-any combination of cloud vendors, on-premise, edge, web and mobile, and devices.
-More: https://nats.io
-"""
-MySQLDsn = Annotated[
-    Url,
-    UrlConstraints(
-        allowed_schemes=[
-            'mysql',
-            'mysql+mysqlconnector',
-            'mysql+aiomysql',
-            'mysql+asyncmy',
-            'mysql+mysqldb',
-            'mysql+pymysql',
-            'mysql+cymysql',
-            'mysql+pyodbc',
-        ],
-        default_port=3306,
-    ),
-]
-"""A type that will accept any MySQL DSN.
 
-* User info required
-* TLD not required
-* Host required
-"""
-MariaDBDsn = Annotated[
-    Url,
-    UrlConstraints(
-        allowed_schemes=['mariadb', 'mariadb+mariadbconnector', 'mariadb+pymysql'],
-        default_port=3306,
-    ),
-]
-"""A type that will accept any MariaDB DSN.
+class RedisDsn(AnyUrl):
+    __slots__ = ()
+    allowed_schemes = {'redis', 'rediss'}
+    host_required = False
 
-* User info required
-* TLD not required
-* Host required
-"""
+    @staticmethod
+    def get_default_parts(parts: 'Parts') -> 'Parts':
+        return {
+            'domain': 'localhost' if not (parts['ipv4'] or parts['ipv6']) else '',
+            'port': '6379',
+            'path': '/0',
+        }
+
+
+class MongoDsn(AnyUrl):
+    allowed_schemes = {'mongodb'}
+
+    # TODO: Needed to generic "Parts" for "Replica Set", "Sharded Cluster", and other mongodb deployment modes
+    @staticmethod
+    def get_default_parts(parts: 'Parts') -> 'Parts':
+        return {
+            'port': '27017',
+        }
+
+
+class KafkaDsn(AnyUrl):
+    allowed_schemes = {'kafka'}
+
+    @staticmethod
+    def get_default_parts(parts: 'Parts') -> 'Parts':
+        return {
+            'domain': 'localhost',
+            'port': '9092',
+        }
+
+
+def stricturl(
+    *,
+    strip_whitespace: bool = True,
+    min_length: int = 1,
+    max_length: int = 2**16,
+    tld_required: bool = True,
+    host_required: bool = True,
+    allowed_schemes: Optional[Collection[str]] = None,
+) -> Type[AnyUrl]:
+    # use kwargs then define conf in a dict to aid with IDE type hinting
+    namespace = dict(
+        strip_whitespace=strip_whitespace,
+        min_length=min_length,
+        max_length=max_length,
+        tld_required=tld_required,
+        host_required=host_required,
+        allowed_schemes=allowed_schemes,
+    )
+    return type('UrlValue', (AnyUrl,), namespace)
 
 
 def import_email_validator() -> None:
@@ -364,95 +577,27 @@ def import_email_validator() -> None:
         import email_validator
     except ImportError as e:
         raise ImportError('email-validator is not installed, run `pip install pydantic[email]`') from e
-    if not version('email-validator').partition('.')[0] == '2':
-        raise ImportError('email-validator version >= 2.0 required, run pip install -U email-validator')
 
 
-if TYPE_CHECKING:
-    EmailStr = Annotated[str, ...]
-else:
+class EmailStr(str):
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        field_schema.update(type='string', format='email')
 
-    class EmailStr:
-        """
-        Info:
-            To use this type, you need to install the optional
-            [`email-validator`](https://github.com/JoshData/python-email-validator) package:
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        # included here and below so the error happens straight away
+        import_email_validator()
 
-            ```bash
-            pip install email-validator
-            ```
+        yield str_validator
+        yield cls.validate
 
-        Validate email addresses.
-
-        ```py
-        from pydantic import BaseModel, EmailStr
-
-        class Model(BaseModel):
-            email: EmailStr
-
-        print(Model(email='contact@mail.com'))
-        #> email='contact@mail.com'
-        ```
-        """  # noqa: D212
-
-        @classmethod
-        def __get_pydantic_core_schema__(
-            cls,
-            _source: type[Any],
-            _handler: GetCoreSchemaHandler,
-        ) -> core_schema.CoreSchema:
-            import_email_validator()
-            return core_schema.no_info_after_validator_function(cls._validate, core_schema.str_schema())
-
-        @classmethod
-        def __get_pydantic_json_schema__(
-            cls, core_schema: core_schema.CoreSchema, handler: _schema_generation_shared.GetJsonSchemaHandler
-        ) -> JsonSchemaValue:
-            field_schema = handler(core_schema)
-            field_schema.update(type='string', format='email')
-            return field_schema
-
-        @classmethod
-        def _validate(cls, __input_value: str) -> str:
-            return validate_email(__input_value)[1]
+    @classmethod
+    def validate(cls, value: Union[str]) -> str:
+        return validate_email(value)[1]
 
 
-class NameEmail(_repr.Representation):
-    """
-    Info:
-        To use this type, you need to install the optional
-        [`email-validator`](https://github.com/JoshData/python-email-validator) package:
-
-        ```bash
-        pip install email-validator
-        ```
-
-    Validate a name and email address combination, as specified by
-    [RFC 5322](https://datatracker.ietf.org/doc/html/rfc5322#section-3.4).
-
-    The `NameEmail` has two properties: `name` and `email`.
-    In case the `name` is not provided, it's inferred from the email address.
-
-    ```py
-    from pydantic import BaseModel, NameEmail
-
-    class User(BaseModel):
-        email: NameEmail
-
-    user = User(email='Fred Bloggs <fred.bloggs@example.com>')
-    print(user.email)
-    #> Fred Bloggs <fred.bloggs@example.com>
-    print(user.email.name)
-    #> Fred Bloggs
-
-    user = User(email='fred.bloggs@example.com')
-    print(user.email)
-    #> fred.bloggs <fred.bloggs@example.com>
-    print(user.email.name)
-    #> fred.bloggs
-    ```
-    """  # noqa: D212
-
+class NameEmail(Representation):
     __slots__ = 'name', 'email'
 
     def __init__(self, name: str, email: str):
@@ -463,76 +608,39 @@ class NameEmail(_repr.Representation):
         return isinstance(other, NameEmail) and (self.name, self.email) == (other.name, other.email)
 
     @classmethod
-    def __get_pydantic_json_schema__(
-        cls, core_schema: core_schema.CoreSchema, handler: _schema_generation_shared.GetJsonSchemaHandler
-    ) -> JsonSchemaValue:
-        field_schema = handler(core_schema)
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
         field_schema.update(type='string', format='name-email')
-        return field_schema
 
     @classmethod
-    def __get_pydantic_core_schema__(
-        cls,
-        _source: type[Any],
-        _handler: GetCoreSchemaHandler,
-    ) -> core_schema.CoreSchema:
+    def __get_validators__(cls) -> 'CallableGenerator':
         import_email_validator()
-        return core_schema.no_info_after_validator_function(
-            cls._validate,
-            core_schema.union_schema(
-                [core_schema.is_instance_schema(cls), core_schema.str_schema()],
-                custom_error_type='name_email_type',
-                custom_error_message='Input is not a valid NameEmail',
-            ),
-            serialization=core_schema.to_string_ser_schema(),
-        )
+
+        yield cls.validate
 
     @classmethod
-    def _validate(cls, __input_value: NameEmail | str) -> NameEmail:
-        if isinstance(__input_value, cls):
-            return __input_value
-        else:
-            name, email = validate_email(__input_value)  # type: ignore[arg-type]
-            return cls(name, email)
+    def validate(cls, value: Any) -> 'NameEmail':
+        if value.__class__ == cls:
+            return value
+        value = str_validator(value)
+        return cls(*validate_email(value))
 
     def __str__(self) -> str:
         return f'{self.name} <{self.email}>'
 
 
-class IPvAnyAddress:
-    """Validate an IPv4 or IPv6 address.
-
-    ```py
-    from pydantic import BaseModel
-    from pydantic.networks import IPvAnyAddress
-
-    class IpModel(BaseModel):
-        ip: IPvAnyAddress
-
-    print(IpModel(ip='127.0.0.1'))
-    #> ip=IPv4Address('127.0.0.1')
-
-    try:
-        IpModel(ip='http://www.example.com')
-    except ValueError as e:
-        print(e.errors())
-        '''
-        [
-            {
-                'type': 'ip_any_address',
-                'loc': ('ip',),
-                'msg': 'value is not a valid IPv4 or IPv6 address',
-                'input': 'http://www.example.com',
-            }
-        ]
-        '''
-    ```
-    """
-
+class IPvAnyAddress(_BaseAddress):
     __slots__ = ()
 
-    def __new__(cls, value: Any) -> IPv4Address | IPv6Address:
-        """Validate an IPv4 or IPv6 address."""
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        field_schema.update(type='string', format='ipvanyaddress')
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield cls.validate
+
+    @classmethod
+    def validate(cls, value: Union[str, bytes, int]) -> Union[IPv4Address, IPv6Address]:
         try:
             return IPv4Address(value)
         except ValueError:
@@ -541,38 +649,22 @@ class IPvAnyAddress:
         try:
             return IPv6Address(value)
         except ValueError:
-            raise PydanticCustomError('ip_any_address', 'value is not a valid IPv4 or IPv6 address')
-
-    @classmethod
-    def __get_pydantic_json_schema__(
-        cls, core_schema: core_schema.CoreSchema, handler: _schema_generation_shared.GetJsonSchemaHandler
-    ) -> JsonSchemaValue:
-        field_schema = {}
-        field_schema.update(type='string', format='ipvanyaddress')
-        return field_schema
-
-    @classmethod
-    def __get_pydantic_core_schema__(
-        cls,
-        _source: type[Any],
-        _handler: GetCoreSchemaHandler,
-    ) -> core_schema.CoreSchema:
-        return core_schema.no_info_plain_validator_function(
-            cls._validate, serialization=core_schema.to_string_ser_schema()
-        )
-
-    @classmethod
-    def _validate(cls, __input_value: Any) -> IPv4Address | IPv6Address:
-        return cls(__input_value)  # type: ignore[return-value]
+            raise errors.IPvAnyAddressError()
 
 
-class IPvAnyInterface:
-    """Validate an IPv4 or IPv6 interface."""
-
+class IPvAnyInterface(_BaseAddress):
     __slots__ = ()
 
-    def __new__(cls, value: NetworkType) -> IPv4Interface | IPv6Interface:
-        """Validate an IPv4 or IPv6 interface."""
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        field_schema.update(type='string', format='ipvanyinterface')
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield cls.validate
+
+    @classmethod
+    def validate(cls, value: NetworkType) -> Union[IPv4Interface, IPv6Interface]:
         try:
             return IPv4Interface(value)
         except ValueError:
@@ -581,39 +673,21 @@ class IPvAnyInterface:
         try:
             return IPv6Interface(value)
         except ValueError:
-            raise PydanticCustomError('ip_any_interface', 'value is not a valid IPv4 or IPv6 interface')
+            raise errors.IPvAnyInterfaceError()
+
+
+class IPvAnyNetwork(_BaseNetwork):  # type: ignore
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        field_schema.update(type='string', format='ipvanynetwork')
 
     @classmethod
-    def __get_pydantic_json_schema__(
-        cls, core_schema: core_schema.CoreSchema, handler: _schema_generation_shared.GetJsonSchemaHandler
-    ) -> JsonSchemaValue:
-        field_schema = {}
-        field_schema.update(type='string', format='ipvanyinterface')
-        return field_schema
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield cls.validate
 
     @classmethod
-    def __get_pydantic_core_schema__(
-        cls,
-        _source: type[Any],
-        _handler: GetCoreSchemaHandler,
-    ) -> core_schema.CoreSchema:
-        return core_schema.no_info_plain_validator_function(
-            cls._validate, serialization=core_schema.to_string_ser_schema()
-        )
-
-    @classmethod
-    def _validate(cls, __input_value: NetworkType) -> IPv4Interface | IPv6Interface:
-        return cls(__input_value)  # type: ignore[return-value]
-
-
-class IPvAnyNetwork:
-    """Validate an IPv4 or IPv6 network."""
-
-    __slots__ = ()
-
-    def __new__(cls, value: NetworkType) -> IPv4Network | IPv6Network:
-        """Validate an IPv4 or IPv6 network."""
-        # Assume IP Network is defined with a default value for `strict` argument.
+    def validate(cls, value: NetworkType) -> Union[IPv4Network, IPv6Network]:
+        # Assume IP Network is defined with a default value for ``strict`` argument.
         # Define your own class if you want to specify network address check strictness.
         try:
             return IPv4Network(value)
@@ -623,86 +697,40 @@ class IPvAnyNetwork:
         try:
             return IPv6Network(value)
         except ValueError:
-            raise PydanticCustomError('ip_any_network', 'value is not a valid IPv4 or IPv6 network')
-
-    @classmethod
-    def __get_pydantic_json_schema__(
-        cls, core_schema: core_schema.CoreSchema, handler: _schema_generation_shared.GetJsonSchemaHandler
-    ) -> JsonSchemaValue:
-        field_schema = {}
-        field_schema.update(type='string', format='ipvanynetwork')
-        return field_schema
-
-    @classmethod
-    def __get_pydantic_core_schema__(
-        cls,
-        _source: type[Any],
-        _handler: GetCoreSchemaHandler,
-    ) -> core_schema.CoreSchema:
-        return core_schema.no_info_plain_validator_function(
-            cls._validate, serialization=core_schema.to_string_ser_schema()
-        )
-
-    @classmethod
-    def _validate(cls, __input_value: NetworkType) -> IPv4Network | IPv6Network:
-        return cls(__input_value)  # type: ignore[return-value]
+            raise errors.IPvAnyNetworkError()
 
 
-def _build_pretty_email_regex() -> re.Pattern[str]:
-    name_chars = r'[\w!#$%&\'*+\-/=?^_`{|}~]'
-    unquoted_name_group = rf'((?:{name_chars}+\s+)*{name_chars}+)'
-    quoted_name_group = r'"((?:[^"]|\")+)"'
-    email_group = r'<\s*(.+)\s*>'
-    return re.compile(rf'\s*(?:{unquoted_name_group}|{quoted_name_group})?\s*{email_group}\s*')
+pretty_email_regex = re.compile(r'([\w ]*?) *<(.*)> *')
 
 
-pretty_email_regex = _build_pretty_email_regex()
+def validate_email(value: Union[str]) -> Tuple[str, str]:
+    """
+    Brutally simple email address validation. Note unlike most email address validation
+    * raw ip address (literal) domain parts are not allowed.
+    * "John Doe <local_part@domain.com>" style "pretty" email addresses are processed
+    * the local part check is extremely basic. This raises the possibility of unicode spoofing, but no better
+        solution is really possible.
+    * spaces are striped from the beginning and end of addresses but no error is raised
 
-MAX_EMAIL_LENGTH = 2048
-"""Maximum length for an email.
-A somewhat arbitrary but very generous number compared to what is allowed by most implementations.
-"""
-
-
-def validate_email(value: str) -> tuple[str, str]:
-    """Email address validation using [email-validator](https://pypi.org/project/email-validator/).
-
-    Note:
-        Note that:
-
-        * Raw IP address (literal) domain parts are not allowed.
-        * `"John Doe <local_part@domain.com>"` style "pretty" email addresses are processed.
-        * Spaces are striped from the beginning and end of addresses, but no error is raised.
+    See RFC 5322 but treat it with suspicion, there seems to exist no universally acknowledged test for a valid email!
     """
     if email_validator is None:
         import_email_validator()
 
-    if len(value) > MAX_EMAIL_LENGTH:
-        raise PydanticCustomError(
-            'value_error',
-            'value is not a valid email address: {reason}',
-            {'reason': f'Length must not exceed {MAX_EMAIL_LENGTH} characters'},
-        )
-
     m = pretty_email_regex.fullmatch(value)
-    name: str | None = None
+    name: Optional[str] = None
     if m:
-        unquoted_name, quoted_name, value = m.groups()
-        name = unquoted_name or quoted_name
+        name, value = m.groups()
 
     email = value.strip()
 
     try:
-        parts = email_validator.validate_email(email, check_deliverability=False)
+        email_validator.validate_email(email, check_deliverability=False)
     except email_validator.EmailNotValidError as e:
-        raise PydanticCustomError(
-            'value_error', 'value is not a valid email address: {reason}', {'reason': str(e.args[0])}
-        ) from e
+        raise errors.EmailError() from e
 
-    email = parts.normalized
-    assert email is not None
-    name = name or parts.local_part
-    return name, email
+    at_index = email.index('@')
+    local_part = email[:at_index]  # RFC 5321, local part must be case-sensitive.
+    global_part = email[at_index:].lower()
 
-
-__getattr__ = getattr_migration(__name__)
+    return name or local_part, local_part + global_part
diff --git a/lib/pydantic/parse.py b/lib/pydantic/parse.py
index ceee6342..7ac330ca 100644
--- a/lib/pydantic/parse.py
+++ b/lib/pydantic/parse.py
@@ -1,4 +1,66 @@
-"""The `parse` module is a backport module from V1."""
-from ._migration import getattr_migration
+import json
+import pickle
+from enum import Enum
+from pathlib import Path
+from typing import Any, Callable, Union
 
-__getattr__ = getattr_migration(__name__)
+from .types import StrBytes
+
+
+class Protocol(str, Enum):
+    json = 'json'
+    pickle = 'pickle'
+
+
+def load_str_bytes(
+    b: StrBytes,
+    *,
+    content_type: str = None,
+    encoding: str = 'utf8',
+    proto: Protocol = None,
+    allow_pickle: bool = False,
+    json_loads: Callable[[str], Any] = json.loads,
+) -> Any:
+    if proto is None and content_type:
+        if content_type.endswith(('json', 'javascript')):
+            pass
+        elif allow_pickle and content_type.endswith('pickle'):
+            proto = Protocol.pickle
+        else:
+            raise TypeError(f'Unknown content-type: {content_type}')
+
+    proto = proto or Protocol.json
+
+    if proto == Protocol.json:
+        if isinstance(b, bytes):
+            b = b.decode(encoding)
+        return json_loads(b)
+    elif proto == Protocol.pickle:
+        if not allow_pickle:
+            raise RuntimeError('Trying to decode with pickle with allow_pickle=False')
+        bb = b if isinstance(b, bytes) else b.encode()
+        return pickle.loads(bb)
+    else:
+        raise TypeError(f'Unknown protocol: {proto}')
+
+
+def load_file(
+    path: Union[str, Path],
+    *,
+    content_type: str = None,
+    encoding: str = 'utf8',
+    proto: Protocol = None,
+    allow_pickle: bool = False,
+    json_loads: Callable[[str], Any] = json.loads,
+) -> Any:
+    path = Path(path)
+    b = path.read_bytes()
+    if content_type is None:
+        if path.suffix in ('.js', '.json'):
+            proto = Protocol.json
+        elif path.suffix == '.pkl':
+            proto = Protocol.pickle
+
+    return load_str_bytes(
+        b, proto=proto, content_type=content_type, encoding=encoding, allow_pickle=allow_pickle, json_loads=json_loads
+    )
diff --git a/lib/pydantic/plugin/__init__.py b/lib/pydantic/plugin/__init__.py
deleted file mode 100644
index 84197006..00000000
--- a/lib/pydantic/plugin/__init__.py
+++ /dev/null
@@ -1,170 +0,0 @@
-"""Usage docs: https://docs.pydantic.dev/2.6/concepts/plugins#build-a-plugin
-
-Plugin interface for Pydantic plugins, and related types.
-"""
-from __future__ import annotations
-
-from typing import Any, Callable, NamedTuple
-
-from pydantic_core import CoreConfig, CoreSchema, ValidationError
-from typing_extensions import Literal, Protocol, TypeAlias
-
-__all__ = (
-    'PydanticPluginProtocol',
-    'BaseValidateHandlerProtocol',
-    'ValidatePythonHandlerProtocol',
-    'ValidateJsonHandlerProtocol',
-    'ValidateStringsHandlerProtocol',
-    'NewSchemaReturns',
-    'SchemaTypePath',
-    'SchemaKind',
-)
-
-NewSchemaReturns: TypeAlias = 'tuple[ValidatePythonHandlerProtocol | None, ValidateJsonHandlerProtocol | None, ValidateStringsHandlerProtocol | None]'
-
-
-class SchemaTypePath(NamedTuple):
-    """Path defining where `schema_type` was defined, or where `TypeAdapter` was called."""
-
-    module: str
-    name: str
-
-
-SchemaKind: TypeAlias = Literal['BaseModel', 'TypeAdapter', 'dataclass', 'create_model', 'validate_call']
-
-
-class PydanticPluginProtocol(Protocol):
-    """Protocol defining the interface for Pydantic plugins."""
-
-    def new_schema_validator(
-        self,
-        schema: CoreSchema,
-        schema_type: Any,
-        schema_type_path: SchemaTypePath,
-        schema_kind: SchemaKind,
-        config: CoreConfig | None,
-        plugin_settings: dict[str, object],
-    ) -> tuple[
-        ValidatePythonHandlerProtocol | None, ValidateJsonHandlerProtocol | None, ValidateStringsHandlerProtocol | None
-    ]:
-        """This method is called for each plugin every time a new [`SchemaValidator`][pydantic_core.SchemaValidator]
-        is created.
-
-        It should return an event handler for each of the three validation methods, or `None` if the plugin does not
-        implement that method.
-
-        Args:
-            schema: The schema to validate against.
-            schema_type: The original type which the schema was created from, e.g. the model class.
-            schema_type_path: Path defining where `schema_type` was defined, or where `TypeAdapter` was called.
-            schema_kind: The kind of schema to validate against.
-            config: The config to use for validation.
-            plugin_settings: Any plugin settings.
-
-        Returns:
-            A tuple of optional event handlers for each of the three validation methods -
-                `validate_python`, `validate_json`, `validate_strings`.
-        """
-        raise NotImplementedError('Pydantic plugins should implement `new_schema_validator`.')
-
-
-class BaseValidateHandlerProtocol(Protocol):
-    """Base class for plugin callbacks protocols.
-
-    You shouldn't implement this protocol directly, instead use one of the subclasses with adds the correctly
-    typed `on_error` method.
-    """
-
-    on_enter: Callable[..., None]
-    """`on_enter` is changed to be more specific on all subclasses"""
-
-    def on_success(self, result: Any) -> None:
-        """Callback to be notified of successful validation.
-
-        Args:
-            result: The result of the validation.
-        """
-        return
-
-    def on_error(self, error: ValidationError) -> None:
-        """Callback to be notified of validation errors.
-
-        Args:
-            error: The validation error.
-        """
-        return
-
-    def on_exception(self, exception: Exception) -> None:
-        """Callback to be notified of validation exceptions.
-
-        Args:
-            exception: The exception raised during validation.
-        """
-        return
-
-
-class ValidatePythonHandlerProtocol(BaseValidateHandlerProtocol, Protocol):
-    """Event handler for `SchemaValidator.validate_python`."""
-
-    def on_enter(
-        self,
-        input: Any,
-        *,
-        strict: bool | None = None,
-        from_attributes: bool | None = None,
-        context: dict[str, Any] | None = None,
-        self_instance: Any | None = None,
-    ) -> None:
-        """Callback to be notified of validation start, and create an instance of the event handler.
-
-        Args:
-            input: The input to be validated.
-            strict: Whether to validate the object in strict mode.
-            from_attributes: Whether to validate objects as inputs by extracting attributes.
-            context: The context to use for validation, this is passed to functional validators.
-            self_instance: An instance of a model to set attributes on from validation, this is used when running
-                validation from the `__init__` method of a model.
-        """
-        pass
-
-
-class ValidateJsonHandlerProtocol(BaseValidateHandlerProtocol, Protocol):
-    """Event handler for `SchemaValidator.validate_json`."""
-
-    def on_enter(
-        self,
-        input: str | bytes | bytearray,
-        *,
-        strict: bool | None = None,
-        context: dict[str, Any] | None = None,
-        self_instance: Any | None = None,
-    ) -> None:
-        """Callback to be notified of validation start, and create an instance of the event handler.
-
-        Args:
-            input: The JSON data to be validated.
-            strict: Whether to validate the object in strict mode.
-            context: The context to use for validation, this is passed to functional validators.
-            self_instance: An instance of a model to set attributes on from validation, this is used when running
-                validation from the `__init__` method of a model.
-        """
-        pass
-
-
-StringInput: TypeAlias = 'dict[str, StringInput]'
-
-
-class ValidateStringsHandlerProtocol(BaseValidateHandlerProtocol, Protocol):
-    """Event handler for `SchemaValidator.validate_strings`."""
-
-    def on_enter(
-        self, input: StringInput, *, strict: bool | None = None, context: dict[str, Any] | None = None
-    ) -> None:
-        """Callback to be notified of validation start, and create an instance of the event handler.
-
-        Args:
-            input: The string data to be validated.
-            strict: Whether to validate the object in strict mode.
-            context: The context to use for validation, this is passed to functional validators.
-        """
-        pass
diff --git a/lib/pydantic/plugin/_loader.py b/lib/pydantic/plugin/_loader.py
deleted file mode 100644
index 9e0e33ca..00000000
--- a/lib/pydantic/plugin/_loader.py
+++ /dev/null
@@ -1,50 +0,0 @@
-from __future__ import annotations
-
-import importlib.metadata as importlib_metadata
-import warnings
-from typing import TYPE_CHECKING, Final, Iterable
-
-if TYPE_CHECKING:
-    from . import PydanticPluginProtocol
-
-
-PYDANTIC_ENTRY_POINT_GROUP: Final[str] = 'pydantic'
-
-# cache of plugins
-_plugins: dict[str, PydanticPluginProtocol] | None = None
-# return no plugins while loading plugins to avoid recursion and errors while import plugins
-# this means that if plugins use pydantic
-_loading_plugins: bool = False
-
-
-def get_plugins() -> Iterable[PydanticPluginProtocol]:
-    """Load plugins for Pydantic.
-
-    Inspired by: https://github.com/pytest-dev/pluggy/blob/1.3.0/src/pluggy/_manager.py#L376-L402
-    """
-    global _plugins, _loading_plugins
-    if _loading_plugins:
-        # this happens when plugins themselves use pydantic, we return no plugins
-        return ()
-    elif _plugins is None:
-        _plugins = {}
-        # set _loading_plugins so any plugins that use pydantic don't themselves use plugins
-        _loading_plugins = True
-        try:
-            for dist in importlib_metadata.distributions():
-                for entry_point in dist.entry_points:
-                    if entry_point.group != PYDANTIC_ENTRY_POINT_GROUP:
-                        continue
-                    if entry_point.value in _plugins:
-                        continue
-                    try:
-                        _plugins[entry_point.value] = entry_point.load()
-                    except (ImportError, AttributeError) as e:
-                        warnings.warn(
-                            f'{e.__class__.__name__} while loading the `{entry_point.name}` Pydantic plugin, '
-                            f'this plugin will not be installed.\n\n{e!r}'
-                        )
-        finally:
-            _loading_plugins = False
-
-    return _plugins.values()
diff --git a/lib/pydantic/plugin/_schema_validator.py b/lib/pydantic/plugin/_schema_validator.py
deleted file mode 100644
index 7186ece6..00000000
--- a/lib/pydantic/plugin/_schema_validator.py
+++ /dev/null
@@ -1,138 +0,0 @@
-"""Pluggable schema validator for pydantic."""
-from __future__ import annotations
-
-import functools
-from typing import TYPE_CHECKING, Any, Callable, Iterable, TypeVar
-
-from pydantic_core import CoreConfig, CoreSchema, SchemaValidator, ValidationError
-from typing_extensions import Literal, ParamSpec
-
-if TYPE_CHECKING:
-    from . import BaseValidateHandlerProtocol, PydanticPluginProtocol, SchemaKind, SchemaTypePath
-
-
-P = ParamSpec('P')
-R = TypeVar('R')
-Event = Literal['on_validate_python', 'on_validate_json', 'on_validate_strings']
-events: list[Event] = list(Event.__args__)  # type: ignore
-
-
-def create_schema_validator(
-    schema: CoreSchema,
-    schema_type: Any,
-    schema_type_module: str,
-    schema_type_name: str,
-    schema_kind: SchemaKind,
-    config: CoreConfig | None = None,
-    plugin_settings: dict[str, Any] | None = None,
-) -> SchemaValidator:
-    """Create a `SchemaValidator` or `PluggableSchemaValidator` if plugins are installed.
-
-    Returns:
-        If plugins are installed then return `PluggableSchemaValidator`, otherwise return `SchemaValidator`.
-    """
-    from . import SchemaTypePath
-    from ._loader import get_plugins
-
-    plugins = get_plugins()
-    if plugins:
-        return PluggableSchemaValidator(
-            schema,
-            schema_type,
-            SchemaTypePath(schema_type_module, schema_type_name),
-            schema_kind,
-            config,
-            plugins,
-            plugin_settings or {},
-        )  # type: ignore
-    else:
-        return SchemaValidator(schema, config)
-
-
-class PluggableSchemaValidator:
-    """Pluggable schema validator."""
-
-    __slots__ = '_schema_validator', 'validate_json', 'validate_python', 'validate_strings'
-
-    def __init__(
-        self,
-        schema: CoreSchema,
-        schema_type: Any,
-        schema_type_path: SchemaTypePath,
-        schema_kind: SchemaKind,
-        config: CoreConfig | None,
-        plugins: Iterable[PydanticPluginProtocol],
-        plugin_settings: dict[str, Any],
-    ) -> None:
-        self._schema_validator = SchemaValidator(schema, config)
-
-        python_event_handlers: list[BaseValidateHandlerProtocol] = []
-        json_event_handlers: list[BaseValidateHandlerProtocol] = []
-        strings_event_handlers: list[BaseValidateHandlerProtocol] = []
-        for plugin in plugins:
-            try:
-                p, j, s = plugin.new_schema_validator(
-                    schema, schema_type, schema_type_path, schema_kind, config, plugin_settings
-                )
-            except TypeError as e:  # pragma: no cover
-                raise TypeError(f'Error using plugin `{plugin.__module__}:{plugin.__class__.__name__}`: {e}') from e
-            if p is not None:
-                python_event_handlers.append(p)
-            if j is not None:
-                json_event_handlers.append(j)
-            if s is not None:
-                strings_event_handlers.append(s)
-
-        self.validate_python = build_wrapper(self._schema_validator.validate_python, python_event_handlers)
-        self.validate_json = build_wrapper(self._schema_validator.validate_json, json_event_handlers)
-        self.validate_strings = build_wrapper(self._schema_validator.validate_strings, strings_event_handlers)
-
-    def __getattr__(self, name: str) -> Any:
-        return getattr(self._schema_validator, name)
-
-
-def build_wrapper(func: Callable[P, R], event_handlers: list[BaseValidateHandlerProtocol]) -> Callable[P, R]:
-    if not event_handlers:
-        return func
-    else:
-        on_enters = tuple(h.on_enter for h in event_handlers if filter_handlers(h, 'on_enter'))
-        on_successes = tuple(h.on_success for h in event_handlers if filter_handlers(h, 'on_success'))
-        on_errors = tuple(h.on_error for h in event_handlers if filter_handlers(h, 'on_error'))
-        on_exceptions = tuple(h.on_exception for h in event_handlers if filter_handlers(h, 'on_exception'))
-
-        @functools.wraps(func)
-        def wrapper(*args: P.args, **kwargs: P.kwargs) -> R:
-            for on_enter_handler in on_enters:
-                on_enter_handler(*args, **kwargs)
-
-            try:
-                result = func(*args, **kwargs)
-            except ValidationError as error:
-                for on_error_handler in on_errors:
-                    on_error_handler(error)
-                raise
-            except Exception as exception:
-                for on_exception_handler in on_exceptions:
-                    on_exception_handler(exception)
-                raise
-            else:
-                for on_success_handler in on_successes:
-                    on_success_handler(result)
-                return result
-
-        return wrapper
-
-
-def filter_handlers(handler_cls: BaseValidateHandlerProtocol, method_name: str) -> bool:
-    """Filter out handler methods which are not implemented by the plugin directly - e.g. are missing
-    or are inherited from the protocol.
-    """
-    handler = getattr(handler_cls, method_name, None)
-    if handler is None:
-        return False
-    elif handler.__module__ == 'pydantic.plugin':
-        # this is the original handler, from the protocol due to runtime inheritance
-        # we don't want to call it
-        return False
-    else:
-        return True
diff --git a/lib/pydantic/root_model.py b/lib/pydantic/root_model.py
deleted file mode 100644
index 42186b9d..00000000
--- a/lib/pydantic/root_model.py
+++ /dev/null
@@ -1,149 +0,0 @@
-"""RootModel class and type definitions."""
-
-from __future__ import annotations as _annotations
-
-import typing
-from copy import copy, deepcopy
-
-from pydantic_core import PydanticUndefined
-
-from . import PydanticUserError
-from ._internal import _model_construction, _repr
-from .main import BaseModel, _object_setattr
-
-if typing.TYPE_CHECKING:
-    from typing import Any
-
-    from typing_extensions import Literal, dataclass_transform
-
-    from .fields import Field as PydanticModelField
-
-    # dataclass_transform could be applied to RootModel directly, but `ModelMetaclass`'s dataclass_transform
-    # takes priority (at least with pyright). We trick type checkers into thinking we apply dataclass_transform
-    # on a new metaclass.
-    @dataclass_transform(kw_only_default=False, field_specifiers=(PydanticModelField,))
-    class _RootModelMetaclass(_model_construction.ModelMetaclass):
-        ...
-
-    Model = typing.TypeVar('Model', bound='BaseModel')
-else:
-    _RootModelMetaclass = _model_construction.ModelMetaclass
-
-__all__ = ('RootModel',)
-
-
-RootModelRootType = typing.TypeVar('RootModelRootType')
-
-
-class RootModel(BaseModel, typing.Generic[RootModelRootType], metaclass=_RootModelMetaclass):
-    """Usage docs: https://docs.pydantic.dev/2.6/concepts/models/#rootmodel-and-custom-root-types
-
-    A Pydantic `BaseModel` for the root object of the model.
-
-    Attributes:
-        root: The root object of the model.
-        __pydantic_root_model__: Whether the model is a RootModel.
-        __pydantic_private__: Private fields in the model.
-        __pydantic_extra__: Extra fields in the model.
-
-    """
-
-    __pydantic_root_model__ = True
-    __pydantic_private__ = None
-    __pydantic_extra__ = None
-
-    root: RootModelRootType
-
-    def __init_subclass__(cls, **kwargs):
-        extra = cls.model_config.get('extra')
-        if extra is not None:
-            raise PydanticUserError(
-                "`RootModel` does not support setting `model_config['extra']`", code='root-model-extra'
-            )
-        super().__init_subclass__(**kwargs)
-
-    def __init__(self, /, root: RootModelRootType = PydanticUndefined, **data) -> None:  # type: ignore
-        __tracebackhide__ = True
-        if data:
-            if root is not PydanticUndefined:
-                raise ValueError(
-                    '"RootModel.__init__" accepts either a single positional argument or arbitrary keyword arguments'
-                )
-            root = data  # type: ignore
-        self.__pydantic_validator__.validate_python(root, self_instance=self)
-
-    __init__.__pydantic_base_init__ = True  # pyright: ignore[reportFunctionMemberAccess]
-
-    @classmethod
-    def model_construct(cls: type[Model], root: RootModelRootType, _fields_set: set[str] | None = None) -> Model:  # type: ignore
-        """Create a new model using the provided root object and update fields set.
-
-        Args:
-            root: The root object of the model.
-            _fields_set: The set of fields to be updated.
-
-        Returns:
-            The new model.
-
-        Raises:
-            NotImplemented: If the model is not a subclass of `RootModel`.
-        """
-        return super().model_construct(root=root, _fields_set=_fields_set)
-
-    def __getstate__(self) -> dict[Any, Any]:
-        return {
-            '__dict__': self.__dict__,
-            '__pydantic_fields_set__': self.__pydantic_fields_set__,
-        }
-
-    def __setstate__(self, state: dict[Any, Any]) -> None:
-        _object_setattr(self, '__pydantic_fields_set__', state['__pydantic_fields_set__'])
-        _object_setattr(self, '__dict__', state['__dict__'])
-
-    def __copy__(self: Model) -> Model:
-        """Returns a shallow copy of the model."""
-        cls = type(self)
-        m = cls.__new__(cls)
-        _object_setattr(m, '__dict__', copy(self.__dict__))
-        _object_setattr(m, '__pydantic_fields_set__', copy(self.__pydantic_fields_set__))
-        return m
-
-    def __deepcopy__(self: Model, memo: dict[int, Any] | None = None) -> Model:
-        """Returns a deep copy of the model."""
-        cls = type(self)
-        m = cls.__new__(cls)
-        _object_setattr(m, '__dict__', deepcopy(self.__dict__, memo=memo))
-        # This next line doesn't need a deepcopy because __pydantic_fields_set__ is a set[str],
-        # and attempting a deepcopy would be marginally slower.
-        _object_setattr(m, '__pydantic_fields_set__', copy(self.__pydantic_fields_set__))
-        return m
-
-    if typing.TYPE_CHECKING:
-
-        def model_dump(  # type: ignore
-            self,
-            *,
-            mode: Literal['json', 'python'] | str = 'python',
-            include: Any = None,
-            exclude: Any = None,
-            by_alias: bool = False,
-            exclude_unset: bool = False,
-            exclude_defaults: bool = False,
-            exclude_none: bool = False,
-            round_trip: bool = False,
-            warnings: bool = True,
-        ) -> RootModelRootType:
-            """This method is included just to get a more accurate return type for type checkers.
-            It is included in this `if TYPE_CHECKING:` block since no override is actually necessary.
-
-            See the documentation of `BaseModel.model_dump` for more details about the arguments.
-            """
-            ...
-
-    def __eq__(self, other: Any) -> bool:
-        if not isinstance(other, RootModel):
-            return NotImplemented
-        return self.model_fields['root'].annotation == other.model_fields['root'].annotation and super().__eq__(other)
-
-    def __repr_args__(self) -> _repr.ReprArgs:
-        yield 'root', self.root
diff --git a/lib/pydantic/schema.py b/lib/pydantic/schema.py
index e290aed9..e7af56f1 100644
--- a/lib/pydantic/schema.py
+++ b/lib/pydantic/schema.py
@@ -1,4 +1,1153 @@
-"""The `schema` module is a backport module from V1."""
-from ._migration import getattr_migration
+import re
+import warnings
+from collections import defaultdict
+from datetime import date, datetime, time, timedelta
+from decimal import Decimal
+from enum import Enum
+from ipaddress import IPv4Address, IPv4Interface, IPv4Network, IPv6Address, IPv6Interface, IPv6Network
+from pathlib import Path
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    Dict,
+    ForwardRef,
+    FrozenSet,
+    Generic,
+    Iterable,
+    List,
+    Optional,
+    Pattern,
+    Sequence,
+    Set,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+    cast,
+)
+from uuid import UUID
 
-__getattr__ = getattr_migration(__name__)
+from typing_extensions import Annotated, Literal
+
+from .fields import (
+    MAPPING_LIKE_SHAPES,
+    SHAPE_DEQUE,
+    SHAPE_FROZENSET,
+    SHAPE_GENERIC,
+    SHAPE_ITERABLE,
+    SHAPE_LIST,
+    SHAPE_SEQUENCE,
+    SHAPE_SET,
+    SHAPE_SINGLETON,
+    SHAPE_TUPLE,
+    SHAPE_TUPLE_ELLIPSIS,
+    FieldInfo,
+    ModelField,
+)
+from .json import pydantic_encoder
+from .networks import AnyUrl, EmailStr
+from .types import (
+    ConstrainedDecimal,
+    ConstrainedFloat,
+    ConstrainedFrozenSet,
+    ConstrainedInt,
+    ConstrainedList,
+    ConstrainedSet,
+    SecretBytes,
+    SecretStr,
+    StrictBytes,
+    StrictStr,
+    conbytes,
+    condecimal,
+    confloat,
+    confrozenset,
+    conint,
+    conlist,
+    conset,
+    constr,
+)
+from .typing import (
+    all_literal_values,
+    get_args,
+    get_origin,
+    get_sub_types,
+    is_callable_type,
+    is_literal_type,
+    is_namedtuple,
+    is_none_type,
+    is_union,
+)
+from .utils import ROOT_KEY, get_model, lenient_issubclass
+
+if TYPE_CHECKING:
+    from .dataclasses import Dataclass
+    from .main import BaseModel
+
+default_prefix = '#/definitions/'
+default_ref_template = '#/definitions/{model}'
+
+TypeModelOrEnum = Union[Type['BaseModel'], Type[Enum]]
+TypeModelSet = Set[TypeModelOrEnum]
+
+
+def _apply_modify_schema(
+    modify_schema: Callable[..., None], field: Optional[ModelField], field_schema: Dict[str, Any]
+) -> None:
+    from inspect import signature
+
+    sig = signature(modify_schema)
+    args = set(sig.parameters.keys())
+    if 'field' in args or 'kwargs' in args:
+        modify_schema(field_schema, field=field)
+    else:
+        modify_schema(field_schema)
+
+
+def schema(
+    models: Sequence[Union[Type['BaseModel'], Type['Dataclass']]],
+    *,
+    by_alias: bool = True,
+    title: Optional[str] = None,
+    description: Optional[str] = None,
+    ref_prefix: Optional[str] = None,
+    ref_template: str = default_ref_template,
+) -> Dict[str, Any]:
+    """
+    Process a list of models and generate a single JSON Schema with all of them defined in the ``definitions``
+    top-level JSON key, including their sub-models.
+
+    :param models: a list of models to include in the generated JSON Schema
+    :param by_alias: generate the schemas using the aliases defined, if any
+    :param title: title for the generated schema that includes the definitions
+    :param description: description for the generated schema
+    :param ref_prefix: the JSON Pointer prefix for schema references with ``$ref``, if None, will be set to the
+      default of ``#/definitions/``. Update it if you want the schemas to reference the definitions somewhere
+      else, e.g. for OpenAPI use ``#/components/schemas/``. The resulting generated schemas will still be at the
+      top-level key ``definitions``, so you can extract them from there. But all the references will have the set
+      prefix.
+    :param ref_template: Use a ``string.format()`` template for ``$ref`` instead of a prefix. This can be useful
+      for references that cannot be represented by ``ref_prefix`` such as a definition stored in another file. For
+      a sibling json file in a ``/schemas`` directory use ``"/schemas/${model}.json#"``.
+    :return: dict with the JSON Schema with a ``definitions`` top-level key including the schema definitions for
+      the models and sub-models passed in ``models``.
+    """
+    clean_models = [get_model(model) for model in models]
+    flat_models = get_flat_models_from_models(clean_models)
+    model_name_map = get_model_name_map(flat_models)
+    definitions = {}
+    output_schema: Dict[str, Any] = {}
+    if title:
+        output_schema['title'] = title
+    if description:
+        output_schema['description'] = description
+    for model in clean_models:
+        m_schema, m_definitions, m_nested_models = model_process_schema(
+            model,
+            by_alias=by_alias,
+            model_name_map=model_name_map,
+            ref_prefix=ref_prefix,
+            ref_template=ref_template,
+        )
+        definitions.update(m_definitions)
+        model_name = model_name_map[model]
+        definitions[model_name] = m_schema
+    if definitions:
+        output_schema['definitions'] = definitions
+    return output_schema
+
+
+def model_schema(
+    model: Union[Type['BaseModel'], Type['Dataclass']],
+    by_alias: bool = True,
+    ref_prefix: Optional[str] = None,
+    ref_template: str = default_ref_template,
+) -> Dict[str, Any]:
+    """
+    Generate a JSON Schema for one model. With all the sub-models defined in the ``definitions`` top-level
+    JSON key.
+
+    :param model: a Pydantic model (a class that inherits from BaseModel)
+    :param by_alias: generate the schemas using the aliases defined, if any
+    :param ref_prefix: the JSON Pointer prefix for schema references with ``$ref``, if None, will be set to the
+      default of ``#/definitions/``. Update it if you want the schemas to reference the definitions somewhere
+      else, e.g. for OpenAPI use ``#/components/schemas/``. The resulting generated schemas will still be at the
+      top-level key ``definitions``, so you can extract them from there. But all the references will have the set
+      prefix.
+    :param ref_template: Use a ``string.format()`` template for ``$ref`` instead of a prefix. This can be useful for
+      references that cannot be represented by ``ref_prefix`` such as a definition stored in another file. For a
+      sibling json file in a ``/schemas`` directory use ``"/schemas/${model}.json#"``.
+    :return: dict with the JSON Schema for the passed ``model``
+    """
+    model = get_model(model)
+    flat_models = get_flat_models_from_model(model)
+    model_name_map = get_model_name_map(flat_models)
+    model_name = model_name_map[model]
+    m_schema, m_definitions, nested_models = model_process_schema(
+        model, by_alias=by_alias, model_name_map=model_name_map, ref_prefix=ref_prefix, ref_template=ref_template
+    )
+    if model_name in nested_models:
+        # model_name is in Nested models, it has circular references
+        m_definitions[model_name] = m_schema
+        m_schema = get_schema_ref(model_name, ref_prefix, ref_template, False)
+    if m_definitions:
+        m_schema.update({'definitions': m_definitions})
+    return m_schema
+
+
+def get_field_info_schema(field: ModelField, schema_overrides: bool = False) -> Tuple[Dict[str, Any], bool]:
+
+    # If no title is explicitly set, we don't set title in the schema for enums.
+    # The behaviour is the same as `BaseModel` reference, where the default title
+    # is in the definitions part of the schema.
+    schema_: Dict[str, Any] = {}
+    if field.field_info.title or not lenient_issubclass(field.type_, Enum):
+        schema_['title'] = field.field_info.title or field.alias.title().replace('_', ' ')
+
+    if field.field_info.title:
+        schema_overrides = True
+
+    if field.field_info.description:
+        schema_['description'] = field.field_info.description
+        schema_overrides = True
+
+    if not field.required and field.default is not None and not is_callable_type(field.outer_type_):
+        schema_['default'] = encode_default(field.default)
+        schema_overrides = True
+
+    return schema_, schema_overrides
+
+
+def field_schema(
+    field: ModelField,
+    *,
+    by_alias: bool = True,
+    model_name_map: Dict[TypeModelOrEnum, str],
+    ref_prefix: Optional[str] = None,
+    ref_template: str = default_ref_template,
+    known_models: TypeModelSet = None,
+) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]:
+    """
+    Process a Pydantic field and return a tuple with a JSON Schema for it as the first item.
+    Also return a dictionary of definitions with models as keys and their schemas as values. If the passed field
+    is a model and has sub-models, and those sub-models don't have overrides (as ``title``, ``default``, etc), they
+    will be included in the definitions and referenced in the schema instead of included recursively.
+
+    :param field: a Pydantic ``ModelField``
+    :param by_alias: use the defined alias (if any) in the returned schema
+    :param model_name_map: used to generate the JSON Schema references to other models included in the definitions
+    :param ref_prefix: the JSON Pointer prefix to use for references to other schemas, if None, the default of
+      #/definitions/ will be used
+    :param ref_template: Use a ``string.format()`` template for ``$ref`` instead of a prefix. This can be useful for
+      references that cannot be represented by ``ref_prefix`` such as a definition stored in another file. For a
+      sibling json file in a ``/schemas`` directory use ``"/schemas/${model}.json#"``.
+    :param known_models: used to solve circular references
+    :return: tuple of the schema for this field and additional definitions
+    """
+    s, schema_overrides = get_field_info_schema(field)
+
+    validation_schema = get_field_schema_validations(field)
+    if validation_schema:
+        s.update(validation_schema)
+        schema_overrides = True
+
+    f_schema, f_definitions, f_nested_models = field_type_schema(
+        field,
+        by_alias=by_alias,
+        model_name_map=model_name_map,
+        schema_overrides=schema_overrides,
+        ref_prefix=ref_prefix,
+        ref_template=ref_template,
+        known_models=known_models or set(),
+    )
+
+    # $ref will only be returned when there are no schema_overrides
+    if '$ref' in f_schema:
+        return f_schema, f_definitions, f_nested_models
+    else:
+        s.update(f_schema)
+        return s, f_definitions, f_nested_models
+
+
+numeric_types = (int, float, Decimal)
+_str_types_attrs: Tuple[Tuple[str, Union[type, Tuple[type, ...]], str], ...] = (
+    ('max_length', numeric_types, 'maxLength'),
+    ('min_length', numeric_types, 'minLength'),
+    ('regex', str, 'pattern'),
+)
+
+_numeric_types_attrs: Tuple[Tuple[str, Union[type, Tuple[type, ...]], str], ...] = (
+    ('gt', numeric_types, 'exclusiveMinimum'),
+    ('lt', numeric_types, 'exclusiveMaximum'),
+    ('ge', numeric_types, 'minimum'),
+    ('le', numeric_types, 'maximum'),
+    ('multiple_of', numeric_types, 'multipleOf'),
+)
+
+
+def get_field_schema_validations(field: ModelField) -> Dict[str, Any]:
+    """
+    Get the JSON Schema validation keywords for a ``field`` with an annotation of
+    a Pydantic ``FieldInfo`` with validation arguments.
+    """
+    f_schema: Dict[str, Any] = {}
+
+    if lenient_issubclass(field.type_, Enum):
+        # schema is already updated by `enum_process_schema`; just update with field extra
+        if field.field_info.extra:
+            f_schema.update(field.field_info.extra)
+        return f_schema
+
+    if lenient_issubclass(field.type_, (str, bytes)):
+        for attr_name, t, keyword in _str_types_attrs:
+            attr = getattr(field.field_info, attr_name, None)
+            if isinstance(attr, t):
+                f_schema[keyword] = attr
+    if lenient_issubclass(field.type_, numeric_types) and not issubclass(field.type_, bool):
+        for attr_name, t, keyword in _numeric_types_attrs:
+            attr = getattr(field.field_info, attr_name, None)
+            if isinstance(attr, t):
+                f_schema[keyword] = attr
+    if field.field_info is not None and field.field_info.const:
+        f_schema['const'] = field.default
+    if field.field_info.extra:
+        f_schema.update(field.field_info.extra)
+    modify_schema = getattr(field.outer_type_, '__modify_schema__', None)
+    if modify_schema:
+        _apply_modify_schema(modify_schema, field, f_schema)
+    return f_schema
+
+
+def get_model_name_map(unique_models: TypeModelSet) -> Dict[TypeModelOrEnum, str]:
+    """
+    Process a set of models and generate unique names for them to be used as keys in the JSON Schema
+    definitions. By default the names are the same as the class name. But if two models in different Python
+    modules have the same name (e.g. "users.Model" and "items.Model"), the generated names will be
+    based on the Python module path for those conflicting models to prevent name collisions.
+
+    :param unique_models: a Python set of models
+    :return: dict mapping models to names
+    """
+    name_model_map = {}
+    conflicting_names: Set[str] = set()
+    for model in unique_models:
+        model_name = normalize_name(model.__name__)
+        if model_name in conflicting_names:
+            model_name = get_long_model_name(model)
+            name_model_map[model_name] = model
+        elif model_name in name_model_map:
+            conflicting_names.add(model_name)
+            conflicting_model = name_model_map.pop(model_name)
+            name_model_map[get_long_model_name(conflicting_model)] = conflicting_model
+            name_model_map[get_long_model_name(model)] = model
+        else:
+            name_model_map[model_name] = model
+    return {v: k for k, v in name_model_map.items()}
+
+
+def get_flat_models_from_model(model: Type['BaseModel'], known_models: TypeModelSet = None) -> TypeModelSet:
+    """
+    Take a single ``model`` and generate a set with itself and all the sub-models in the tree. I.e. if you pass
+    model ``Foo`` (subclass of Pydantic ``BaseModel``) as ``model``, and it has a field of type ``Bar`` (also
+    subclass of ``BaseModel``) and that model ``Bar`` has a field of type ``Baz`` (also subclass of ``BaseModel``),
+    the return value will be ``set([Foo, Bar, Baz])``.
+
+    :param model: a Pydantic ``BaseModel`` subclass
+    :param known_models: used to solve circular references
+    :return: a set with the initial model and all its sub-models
+    """
+    known_models = known_models or set()
+    flat_models: TypeModelSet = set()
+    flat_models.add(model)
+    known_models |= flat_models
+    fields = cast(Sequence[ModelField], model.__fields__.values())
+    flat_models |= get_flat_models_from_fields(fields, known_models=known_models)
+    return flat_models
+
+
+def get_flat_models_from_field(field: ModelField, known_models: TypeModelSet) -> TypeModelSet:
+    """
+    Take a single Pydantic ``ModelField`` (from a model) that could have been declared as a sublcass of BaseModel
+    (so, it could be a submodel), and generate a set with its model and all the sub-models in the tree.
+    I.e. if you pass a field that was declared to be of type ``Foo`` (subclass of BaseModel) as ``field``, and that
+    model ``Foo`` has a field of type ``Bar`` (also subclass of ``BaseModel``) and that model ``Bar`` has a field of
+    type ``Baz`` (also subclass of ``BaseModel``), the return value will be ``set([Foo, Bar, Baz])``.
+
+    :param field: a Pydantic ``ModelField``
+    :param known_models: used to solve circular references
+    :return: a set with the model used in the declaration for this field, if any, and all its sub-models
+    """
+    from .main import BaseModel
+
+    flat_models: TypeModelSet = set()
+
+    field_type = field.type_
+    if lenient_issubclass(getattr(field_type, '__pydantic_model__', None), BaseModel):
+        field_type = field_type.__pydantic_model__
+
+    if field.sub_fields and not lenient_issubclass(field_type, BaseModel):
+        flat_models |= get_flat_models_from_fields(field.sub_fields, known_models=known_models)
+    elif lenient_issubclass(field_type, BaseModel) and field_type not in known_models:
+        flat_models |= get_flat_models_from_model(field_type, known_models=known_models)
+    elif lenient_issubclass(field_type, Enum):
+        flat_models.add(field_type)
+    return flat_models
+
+
+def get_flat_models_from_fields(fields: Sequence[ModelField], known_models: TypeModelSet) -> TypeModelSet:
+    """
+    Take a list of Pydantic  ``ModelField``s (from a model) that could have been declared as subclasses of ``BaseModel``
+    (so, any of them could be a submodel), and generate a set with their models and all the sub-models in the tree.
+    I.e. if you pass a the fields of a model ``Foo`` (subclass of ``BaseModel``) as ``fields``, and on of them has a
+    field of type ``Bar`` (also subclass of ``BaseModel``) and that model ``Bar`` has a field of type ``Baz`` (also
+    subclass of ``BaseModel``), the return value will be ``set([Foo, Bar, Baz])``.
+
+    :param fields: a list of Pydantic ``ModelField``s
+    :param known_models: used to solve circular references
+    :return: a set with any model declared in the fields, and all their sub-models
+    """
+    flat_models: TypeModelSet = set()
+    for field in fields:
+        flat_models |= get_flat_models_from_field(field, known_models=known_models)
+    return flat_models
+
+
+def get_flat_models_from_models(models: Sequence[Type['BaseModel']]) -> TypeModelSet:
+    """
+    Take a list of ``models`` and generate a set with them and all their sub-models in their trees. I.e. if you pass
+    a list of two models, ``Foo`` and ``Bar``, both subclasses of Pydantic ``BaseModel`` as models, and ``Bar`` has
+    a field of type ``Baz`` (also subclass of ``BaseModel``), the return value will be ``set([Foo, Bar, Baz])``.
+    """
+    flat_models: TypeModelSet = set()
+    for model in models:
+        flat_models |= get_flat_models_from_model(model)
+    return flat_models
+
+
+def get_long_model_name(model: TypeModelOrEnum) -> str:
+    return f'{model.__module__}__{model.__qualname__}'.replace('.', '__')
+
+
+def field_type_schema(
+    field: ModelField,
+    *,
+    by_alias: bool,
+    model_name_map: Dict[TypeModelOrEnum, str],
+    ref_template: str,
+    schema_overrides: bool = False,
+    ref_prefix: Optional[str] = None,
+    known_models: TypeModelSet,
+) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]:
+    """
+    Used by ``field_schema()``, you probably should be using that function.
+
+    Take a single ``field`` and generate the schema for its type only, not including additional
+    information as title, etc. Also return additional schema definitions, from sub-models.
+    """
+    from .main import BaseModel  # noqa: F811
+
+    definitions = {}
+    nested_models: Set[str] = set()
+    f_schema: Dict[str, Any]
+    if field.shape in {
+        SHAPE_LIST,
+        SHAPE_TUPLE_ELLIPSIS,
+        SHAPE_SEQUENCE,
+        SHAPE_SET,
+        SHAPE_FROZENSET,
+        SHAPE_ITERABLE,
+        SHAPE_DEQUE,
+    }:
+        items_schema, f_definitions, f_nested_models = field_singleton_schema(
+            field,
+            by_alias=by_alias,
+            model_name_map=model_name_map,
+            ref_prefix=ref_prefix,
+            ref_template=ref_template,
+            known_models=known_models,
+        )
+        definitions.update(f_definitions)
+        nested_models.update(f_nested_models)
+        f_schema = {'type': 'array', 'items': items_schema}
+        if field.shape in {SHAPE_SET, SHAPE_FROZENSET}:
+            f_schema['uniqueItems'] = True
+
+    elif field.shape in MAPPING_LIKE_SHAPES:
+        f_schema = {'type': 'object'}
+        key_field = cast(ModelField, field.key_field)
+        regex = getattr(key_field.type_, 'regex', None)
+        items_schema, f_definitions, f_nested_models = field_singleton_schema(
+            field,
+            by_alias=by_alias,
+            model_name_map=model_name_map,
+            ref_prefix=ref_prefix,
+            ref_template=ref_template,
+            known_models=known_models,
+        )
+        definitions.update(f_definitions)
+        nested_models.update(f_nested_models)
+        if regex:
+            # Dict keys have a regex pattern
+            # items_schema might be a schema or empty dict, add it either way
+            f_schema['patternProperties'] = {regex.pattern: items_schema}
+        elif items_schema:
+            # The dict values are not simply Any, so they need a schema
+            f_schema['additionalProperties'] = items_schema
+    elif field.shape == SHAPE_TUPLE or (field.shape == SHAPE_GENERIC and not issubclass(field.type_, BaseModel)):
+        sub_schema = []
+        sub_fields = cast(List[ModelField], field.sub_fields)
+        for sf in sub_fields:
+            sf_schema, sf_definitions, sf_nested_models = field_type_schema(
+                sf,
+                by_alias=by_alias,
+                model_name_map=model_name_map,
+                ref_prefix=ref_prefix,
+                ref_template=ref_template,
+                known_models=known_models,
+            )
+            definitions.update(sf_definitions)
+            nested_models.update(sf_nested_models)
+            sub_schema.append(sf_schema)
+
+        sub_fields_len = len(sub_fields)
+        if field.shape == SHAPE_GENERIC:
+            all_of_schemas = sub_schema[0] if sub_fields_len == 1 else {'type': 'array', 'items': sub_schema}
+            f_schema = {'allOf': [all_of_schemas]}
+        else:
+            f_schema = {
+                'type': 'array',
+                'minItems': sub_fields_len,
+                'maxItems': sub_fields_len,
+            }
+            if sub_fields_len >= 1:
+                f_schema['items'] = sub_schema
+    else:
+        assert field.shape in {SHAPE_SINGLETON, SHAPE_GENERIC}, field.shape
+        f_schema, f_definitions, f_nested_models = field_singleton_schema(
+            field,
+            by_alias=by_alias,
+            model_name_map=model_name_map,
+            schema_overrides=schema_overrides,
+            ref_prefix=ref_prefix,
+            ref_template=ref_template,
+            known_models=known_models,
+        )
+        definitions.update(f_definitions)
+        nested_models.update(f_nested_models)
+
+    # check field type to avoid repeated calls to the same __modify_schema__ method
+    if field.type_ != field.outer_type_:
+        if field.shape == SHAPE_GENERIC:
+            field_type = field.type_
+        else:
+            field_type = field.outer_type_
+        modify_schema = getattr(field_type, '__modify_schema__', None)
+        if modify_schema:
+            _apply_modify_schema(modify_schema, field, f_schema)
+    return f_schema, definitions, nested_models
+
+
+def model_process_schema(
+    model: TypeModelOrEnum,
+    *,
+    by_alias: bool = True,
+    model_name_map: Dict[TypeModelOrEnum, str],
+    ref_prefix: Optional[str] = None,
+    ref_template: str = default_ref_template,
+    known_models: TypeModelSet = None,
+    field: Optional[ModelField] = None,
+) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]:
+    """
+    Used by ``model_schema()``, you probably should be using that function.
+
+    Take a single ``model`` and generate its schema. Also return additional schema definitions, from sub-models. The
+    sub-models of the returned schema will be referenced, but their definitions will not be included in the schema. All
+    the definitions are returned as the second value.
+    """
+    from inspect import getdoc, signature
+
+    known_models = known_models or set()
+    if lenient_issubclass(model, Enum):
+        model = cast(Type[Enum], model)
+        s = enum_process_schema(model, field=field)
+        return s, {}, set()
+    model = cast(Type['BaseModel'], model)
+    s = {'title': model.__config__.title or model.__name__}
+    doc = getdoc(model)
+    if doc:
+        s['description'] = doc
+    known_models.add(model)
+    m_schema, m_definitions, nested_models = model_type_schema(
+        model,
+        by_alias=by_alias,
+        model_name_map=model_name_map,
+        ref_prefix=ref_prefix,
+        ref_template=ref_template,
+        known_models=known_models,
+    )
+    s.update(m_schema)
+    schema_extra = model.__config__.schema_extra
+    if callable(schema_extra):
+        if len(signature(schema_extra).parameters) == 1:
+            schema_extra(s)
+        else:
+            schema_extra(s, model)
+    else:
+        s.update(schema_extra)
+    return s, m_definitions, nested_models
+
+
+def model_type_schema(
+    model: Type['BaseModel'],
+    *,
+    by_alias: bool,
+    model_name_map: Dict[TypeModelOrEnum, str],
+    ref_template: str,
+    ref_prefix: Optional[str] = None,
+    known_models: TypeModelSet,
+) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]:
+    """
+    You probably should be using ``model_schema()``, this function is indirectly used by that function.
+
+    Take a single ``model`` and generate the schema for its type only, not including additional
+    information as title, etc. Also return additional schema definitions, from sub-models.
+    """
+    properties = {}
+    required = []
+    definitions: Dict[str, Any] = {}
+    nested_models: Set[str] = set()
+    for k, f in model.__fields__.items():
+        try:
+            f_schema, f_definitions, f_nested_models = field_schema(
+                f,
+                by_alias=by_alias,
+                model_name_map=model_name_map,
+                ref_prefix=ref_prefix,
+                ref_template=ref_template,
+                known_models=known_models,
+            )
+        except SkipField as skip:
+            warnings.warn(skip.message, UserWarning)
+            continue
+        definitions.update(f_definitions)
+        nested_models.update(f_nested_models)
+        if by_alias:
+            properties[f.alias] = f_schema
+            if f.required:
+                required.append(f.alias)
+        else:
+            properties[k] = f_schema
+            if f.required:
+                required.append(k)
+    if ROOT_KEY in properties:
+        out_schema = properties[ROOT_KEY]
+        out_schema['title'] = model.__config__.title or model.__name__
+    else:
+        out_schema = {'type': 'object', 'properties': properties}
+        if required:
+            out_schema['required'] = required
+    if model.__config__.extra == 'forbid':
+        out_schema['additionalProperties'] = False
+    return out_schema, definitions, nested_models
+
+
+def enum_process_schema(enum: Type[Enum], *, field: Optional[ModelField] = None) -> Dict[str, Any]:
+    """
+    Take a single `enum` and generate its schema.
+
+    This is similar to the `model_process_schema` function, but applies to ``Enum`` objects.
+    """
+    schema_: Dict[str, Any] = {
+        'title': enum.__name__,
+        # Python assigns all enums a default docstring value of 'An enumeration', so
+        # all enums will have a description field even if not explicitly provided.
+        'description': enum.__doc__ or 'An enumeration.',
+        # Add enum values and the enum field type to the schema.
+        'enum': [item.value for item in cast(Iterable[Enum], enum)],
+    }
+
+    add_field_type_to_schema(enum, schema_)
+
+    modify_schema = getattr(enum, '__modify_schema__', None)
+    if modify_schema:
+        _apply_modify_schema(modify_schema, field, schema_)
+
+    return schema_
+
+
+def field_singleton_sub_fields_schema(
+    field: ModelField,
+    *,
+    by_alias: bool,
+    model_name_map: Dict[TypeModelOrEnum, str],
+    ref_template: str,
+    schema_overrides: bool = False,
+    ref_prefix: Optional[str] = None,
+    known_models: TypeModelSet,
+) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]:
+    """
+    This function is indirectly used by ``field_schema()``, you probably should be using that function.
+
+    Take a list of Pydantic ``ModelField`` from the declaration of a type with parameters, and generate their
+    schema. I.e., fields used as "type parameters", like ``str`` and ``int`` in ``Tuple[str, int]``.
+    """
+    sub_fields = cast(List[ModelField], field.sub_fields)
+    definitions = {}
+    nested_models: Set[str] = set()
+    if len(sub_fields) == 1:
+        return field_type_schema(
+            sub_fields[0],
+            by_alias=by_alias,
+            model_name_map=model_name_map,
+            schema_overrides=schema_overrides,
+            ref_prefix=ref_prefix,
+            ref_template=ref_template,
+            known_models=known_models,
+        )
+    else:
+        s: Dict[str, Any] = {}
+        # https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#discriminator-object
+        field_has_discriminator: bool = field.discriminator_key is not None
+        if field_has_discriminator:
+            assert field.sub_fields_mapping is not None
+
+            discriminator_models_refs: Dict[str, Union[str, Dict[str, Any]]] = {}
+
+            for discriminator_value, sub_field in field.sub_fields_mapping.items():
+                # sub_field is either a `BaseModel` or directly an `Annotated` `Union` of many
+                if is_union(get_origin(sub_field.type_)):
+                    sub_models = get_sub_types(sub_field.type_)
+                    discriminator_models_refs[discriminator_value] = {
+                        model_name_map[sub_model]: get_schema_ref(
+                            model_name_map[sub_model], ref_prefix, ref_template, False
+                        )
+                        for sub_model in sub_models
+                    }
+                else:
+                    sub_field_type = sub_field.type_
+                    if hasattr(sub_field_type, '__pydantic_model__'):
+                        sub_field_type = sub_field_type.__pydantic_model__
+
+                    discriminator_model_name = model_name_map[sub_field_type]
+                    discriminator_model_ref = get_schema_ref(discriminator_model_name, ref_prefix, ref_template, False)
+                    discriminator_models_refs[discriminator_value] = discriminator_model_ref['$ref']
+
+            s['discriminator'] = {
+                'propertyName': field.discriminator_alias,
+                'mapping': discriminator_models_refs,
+            }
+
+        sub_field_schemas = []
+        for sf in sub_fields:
+            sub_schema, sub_definitions, sub_nested_models = field_type_schema(
+                sf,
+                by_alias=by_alias,
+                model_name_map=model_name_map,
+                schema_overrides=schema_overrides,
+                ref_prefix=ref_prefix,
+                ref_template=ref_template,
+                known_models=known_models,
+            )
+            definitions.update(sub_definitions)
+            if schema_overrides and 'allOf' in sub_schema:
+                # if the sub_field is a referenced schema we only need the referenced
+                # object. Otherwise we will end up with several allOf inside anyOf/oneOf.
+                # See https://github.com/pydantic/pydantic/issues/1209
+                sub_schema = sub_schema['allOf'][0]
+
+            if sub_schema.keys() == {'discriminator', 'oneOf'}:
+                # we don't want discriminator information inside oneOf choices, this is dealt with elsewhere
+                sub_schema.pop('discriminator')
+            sub_field_schemas.append(sub_schema)
+            nested_models.update(sub_nested_models)
+        s['oneOf' if field_has_discriminator else 'anyOf'] = sub_field_schemas
+        return s, definitions, nested_models
+
+
+# Order is important, e.g. subclasses of str must go before str
+# this is used only for standard library types, custom types should use __modify_schema__ instead
+field_class_to_schema: Tuple[Tuple[Any, Dict[str, Any]], ...] = (
+    (Path, {'type': 'string', 'format': 'path'}),
+    (datetime, {'type': 'string', 'format': 'date-time'}),
+    (date, {'type': 'string', 'format': 'date'}),
+    (time, {'type': 'string', 'format': 'time'}),
+    (timedelta, {'type': 'number', 'format': 'time-delta'}),
+    (IPv4Network, {'type': 'string', 'format': 'ipv4network'}),
+    (IPv6Network, {'type': 'string', 'format': 'ipv6network'}),
+    (IPv4Interface, {'type': 'string', 'format': 'ipv4interface'}),
+    (IPv6Interface, {'type': 'string', 'format': 'ipv6interface'}),
+    (IPv4Address, {'type': 'string', 'format': 'ipv4'}),
+    (IPv6Address, {'type': 'string', 'format': 'ipv6'}),
+    (Pattern, {'type': 'string', 'format': 'regex'}),
+    (str, {'type': 'string'}),
+    (bytes, {'type': 'string', 'format': 'binary'}),
+    (bool, {'type': 'boolean'}),
+    (int, {'type': 'integer'}),
+    (float, {'type': 'number'}),
+    (Decimal, {'type': 'number'}),
+    (UUID, {'type': 'string', 'format': 'uuid'}),
+    (dict, {'type': 'object'}),
+    (list, {'type': 'array', 'items': {}}),
+    (tuple, {'type': 'array', 'items': {}}),
+    (set, {'type': 'array', 'items': {}, 'uniqueItems': True}),
+    (frozenset, {'type': 'array', 'items': {}, 'uniqueItems': True}),
+)
+
+json_scheme = {'type': 'string', 'format': 'json-string'}
+
+
+def add_field_type_to_schema(field_type: Any, schema_: Dict[str, Any]) -> None:
+    """
+    Update the given `schema` with the type-specific metadata for the given `field_type`.
+
+    This function looks through `field_class_to_schema` for a class that matches the given `field_type`,
+    and then modifies the given `schema` with the information from that type.
+    """
+    for type_, t_schema in field_class_to_schema:
+        # Fallback for `typing.Pattern` and `re.Pattern` as they are not a valid class
+        if lenient_issubclass(field_type, type_) or field_type is type_ is Pattern:
+            schema_.update(t_schema)
+            break
+
+
+def get_schema_ref(name: str, ref_prefix: Optional[str], ref_template: str, schema_overrides: bool) -> Dict[str, Any]:
+    if ref_prefix:
+        schema_ref = {'$ref': ref_prefix + name}
+    else:
+        schema_ref = {'$ref': ref_template.format(model=name)}
+    return {'allOf': [schema_ref]} if schema_overrides else schema_ref
+
+
+def field_singleton_schema(  # noqa: C901 (ignore complexity)
+    field: ModelField,
+    *,
+    by_alias: bool,
+    model_name_map: Dict[TypeModelOrEnum, str],
+    ref_template: str,
+    schema_overrides: bool = False,
+    ref_prefix: Optional[str] = None,
+    known_models: TypeModelSet,
+) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]:
+    """
+    This function is indirectly used by ``field_schema()``, you should probably be using that function.
+
+    Take a single Pydantic ``ModelField``, and return its schema and any additional definitions from sub-models.
+    """
+    from .main import BaseModel
+
+    definitions: Dict[str, Any] = {}
+    nested_models: Set[str] = set()
+    field_type = field.type_
+
+    # Recurse into this field if it contains sub_fields and is NOT a
+    # BaseModel OR that BaseModel is a const
+    if field.sub_fields and (
+        (field.field_info and field.field_info.const) or not lenient_issubclass(field_type, BaseModel)
+    ):
+        return field_singleton_sub_fields_schema(
+            field,
+            by_alias=by_alias,
+            model_name_map=model_name_map,
+            schema_overrides=schema_overrides,
+            ref_prefix=ref_prefix,
+            ref_template=ref_template,
+            known_models=known_models,
+        )
+    if field_type is Any or field_type is object or field_type.__class__ == TypeVar or get_origin(field_type) is type:
+        return {}, definitions, nested_models  # no restrictions
+    if is_none_type(field_type):
+        return {'type': 'null'}, definitions, nested_models
+    if is_callable_type(field_type):
+        raise SkipField(f'Callable {field.name} was excluded from schema since JSON schema has no equivalent type.')
+    f_schema: Dict[str, Any] = {}
+    if field.field_info is not None and field.field_info.const:
+        f_schema['const'] = field.default
+
+    if is_literal_type(field_type):
+        values = all_literal_values(field_type)
+
+        if len({v.__class__ for v in values}) > 1:
+            return field_schema(
+                multitypes_literal_field_for_schema(values, field),
+                by_alias=by_alias,
+                model_name_map=model_name_map,
+                ref_prefix=ref_prefix,
+                ref_template=ref_template,
+                known_models=known_models,
+            )
+
+        # All values have the same type
+        field_type = values[0].__class__
+        f_schema['enum'] = list(values)
+        add_field_type_to_schema(field_type, f_schema)
+    elif lenient_issubclass(field_type, Enum):
+        enum_name = model_name_map[field_type]
+        f_schema, schema_overrides = get_field_info_schema(field, schema_overrides)
+        f_schema.update(get_schema_ref(enum_name, ref_prefix, ref_template, schema_overrides))
+        definitions[enum_name] = enum_process_schema(field_type, field=field)
+    elif is_namedtuple(field_type):
+        sub_schema, *_ = model_process_schema(
+            field_type.__pydantic_model__,
+            by_alias=by_alias,
+            model_name_map=model_name_map,
+            ref_prefix=ref_prefix,
+            ref_template=ref_template,
+            known_models=known_models,
+            field=field,
+        )
+        items_schemas = list(sub_schema['properties'].values())
+        f_schema.update(
+            {
+                'type': 'array',
+                'items': items_schemas,
+                'minItems': len(items_schemas),
+                'maxItems': len(items_schemas),
+            }
+        )
+    elif not hasattr(field_type, '__pydantic_model__'):
+        add_field_type_to_schema(field_type, f_schema)
+
+        modify_schema = getattr(field_type, '__modify_schema__', None)
+        if modify_schema:
+            _apply_modify_schema(modify_schema, field, f_schema)
+
+    if f_schema:
+        return f_schema, definitions, nested_models
+
+    # Handle dataclass-based models
+    if lenient_issubclass(getattr(field_type, '__pydantic_model__', None), BaseModel):
+        field_type = field_type.__pydantic_model__
+
+    if issubclass(field_type, BaseModel):
+        model_name = model_name_map[field_type]
+        if field_type not in known_models:
+            sub_schema, sub_definitions, sub_nested_models = model_process_schema(
+                field_type,
+                by_alias=by_alias,
+                model_name_map=model_name_map,
+                ref_prefix=ref_prefix,
+                ref_template=ref_template,
+                known_models=known_models,
+                field=field,
+            )
+            definitions.update(sub_definitions)
+            definitions[model_name] = sub_schema
+            nested_models.update(sub_nested_models)
+        else:
+            nested_models.add(model_name)
+        schema_ref = get_schema_ref(model_name, ref_prefix, ref_template, schema_overrides)
+        return schema_ref, definitions, nested_models
+
+    # For generics with no args
+    args = get_args(field_type)
+    if args is not None and not args and Generic in field_type.__bases__:
+        return f_schema, definitions, nested_models
+
+    raise ValueError(f'Value not declarable with JSON Schema, field: {field}')
+
+
+def multitypes_literal_field_for_schema(values: Tuple[Any, ...], field: ModelField) -> ModelField:
+    """
+    To support `Literal` with values of different types, we split it into multiple `Literal` with same type
+    e.g. `Literal['qwe', 'asd', 1, 2]` becomes `Union[Literal['qwe', 'asd'], Literal[1, 2]]`
+    """
+    literal_distinct_types = defaultdict(list)
+    for v in values:
+        literal_distinct_types[v.__class__].append(v)
+    distinct_literals = (Literal[tuple(same_type_values)] for same_type_values in literal_distinct_types.values())
+
+    return ModelField(
+        name=field.name,
+        type_=Union[tuple(distinct_literals)],  # type: ignore
+        class_validators=field.class_validators,
+        model_config=field.model_config,
+        default=field.default,
+        required=field.required,
+        alias=field.alias,
+        field_info=field.field_info,
+    )
+
+
+def encode_default(dft: Any) -> Any:
+    if isinstance(dft, Enum):
+        return dft.value
+    elif isinstance(dft, (int, float, str)):
+        return dft
+    elif isinstance(dft, (list, tuple)):
+        t = dft.__class__
+        seq_args = (encode_default(v) for v in dft)
+        return t(*seq_args) if is_namedtuple(t) else t(seq_args)
+    elif isinstance(dft, dict):
+        return {encode_default(k): encode_default(v) for k, v in dft.items()}
+    elif dft is None:
+        return None
+    else:
+        return pydantic_encoder(dft)
+
+
+_map_types_constraint: Dict[Any, Callable[..., type]] = {int: conint, float: confloat, Decimal: condecimal}
+
+
+def get_annotation_from_field_info(
+    annotation: Any, field_info: FieldInfo, field_name: str, validate_assignment: bool = False
+) -> Type[Any]:
+    """
+    Get an annotation with validation implemented for numbers and strings based on the field_info.
+    :param annotation: an annotation from a field specification, as ``str``, ``ConstrainedStr``
+    :param field_info: an instance of FieldInfo, possibly with declarations for validations and JSON Schema
+    :param field_name: name of the field for use in error messages
+    :param validate_assignment: default False, flag for BaseModel Config value of validate_assignment
+    :return: the same ``annotation`` if unmodified or a new annotation with validation in place
+    """
+    constraints = field_info.get_constraints()
+    used_constraints: Set[str] = set()
+    if constraints:
+        annotation, used_constraints = get_annotation_with_constraints(annotation, field_info)
+    if validate_assignment:
+        used_constraints.add('allow_mutation')
+
+    unused_constraints = constraints - used_constraints
+    if unused_constraints:
+        raise ValueError(
+            f'On field "{field_name}" the following field constraints are set but not enforced: '
+            f'{", ".join(unused_constraints)}. '
+            f'\nFor more details see https://pydantic-docs.helpmanual.io/usage/schema/#unenforced-field-constraints'
+        )
+
+    return annotation
+
+
+def get_annotation_with_constraints(annotation: Any, field_info: FieldInfo) -> Tuple[Type[Any], Set[str]]:  # noqa: C901
+    """
+    Get an annotation with used constraints implemented for numbers and strings based on the field_info.
+
+    :param annotation: an annotation from a field specification, as ``str``, ``ConstrainedStr``
+    :param field_info: an instance of FieldInfo, possibly with declarations for validations and JSON Schema
+    :return: the same ``annotation`` if unmodified or a new annotation along with the used constraints.
+    """
+    used_constraints: Set[str] = set()
+
+    def go(type_: Any) -> Type[Any]:
+        if (
+            is_literal_type(type_)
+            or isinstance(type_, ForwardRef)
+            or lenient_issubclass(type_, (ConstrainedList, ConstrainedSet, ConstrainedFrozenSet))
+        ):
+            return type_
+        origin = get_origin(type_)
+        if origin is not None:
+            args: Tuple[Any, ...] = get_args(type_)
+            if any(isinstance(a, ForwardRef) for a in args):
+                # forward refs cause infinite recursion below
+                return type_
+
+            if origin is Annotated:
+                return go(args[0])
+            if is_union(origin):
+                return Union[tuple(go(a) for a in args)]  # type: ignore
+
+            if issubclass(origin, List) and (
+                field_info.min_items is not None
+                or field_info.max_items is not None
+                or field_info.unique_items is not None
+            ):
+                used_constraints.update({'min_items', 'max_items', 'unique_items'})
+                return conlist(
+                    go(args[0]),
+                    min_items=field_info.min_items,
+                    max_items=field_info.max_items,
+                    unique_items=field_info.unique_items,
+                )
+
+            if issubclass(origin, Set) and (field_info.min_items is not None or field_info.max_items is not None):
+                used_constraints.update({'min_items', 'max_items'})
+                return conset(go(args[0]), min_items=field_info.min_items, max_items=field_info.max_items)
+
+            if issubclass(origin, FrozenSet) and (field_info.min_items is not None or field_info.max_items is not None):
+                used_constraints.update({'min_items', 'max_items'})
+                return confrozenset(go(args[0]), min_items=field_info.min_items, max_items=field_info.max_items)
+
+            for t in (Tuple, List, Set, FrozenSet, Sequence):
+                if issubclass(origin, t):  # type: ignore
+                    return t[tuple(go(a) for a in args)]  # type: ignore
+
+            if issubclass(origin, Dict):
+                return Dict[args[0], go(args[1])]  # type: ignore
+
+        attrs: Optional[Tuple[str, ...]] = None
+        constraint_func: Optional[Callable[..., type]] = None
+        if isinstance(type_, type):
+            if issubclass(type_, (SecretStr, SecretBytes)):
+                attrs = ('max_length', 'min_length')
+
+                def constraint_func(**kw: Any) -> Type[Any]:
+                    return type(type_.__name__, (type_,), kw)
+
+            elif issubclass(type_, str) and not issubclass(type_, (EmailStr, AnyUrl)):
+                attrs = ('max_length', 'min_length', 'regex')
+                if issubclass(type_, StrictStr):
+
+                    def constraint_func(**kw: Any) -> Type[Any]:
+                        return type(type_.__name__, (type_,), kw)
+
+                else:
+                    constraint_func = constr
+            elif issubclass(type_, bytes):
+                attrs = ('max_length', 'min_length', 'regex')
+                if issubclass(type_, StrictBytes):
+
+                    def constraint_func(**kw: Any) -> Type[Any]:
+                        return type(type_.__name__, (type_,), kw)
+
+                else:
+                    constraint_func = conbytes
+            elif issubclass(type_, numeric_types) and not issubclass(
+                type_,
+                (
+                    ConstrainedInt,
+                    ConstrainedFloat,
+                    ConstrainedDecimal,
+                    ConstrainedList,
+                    ConstrainedSet,
+                    ConstrainedFrozenSet,
+                    bool,
+                ),
+            ):
+                # Is numeric type
+                attrs = ('gt', 'lt', 'ge', 'le', 'multiple_of')
+                if issubclass(type_, float):
+                    attrs += ('allow_inf_nan',)
+                if issubclass(type_, Decimal):
+                    attrs += ('max_digits', 'decimal_places')
+                numeric_type = next(t for t in numeric_types if issubclass(type_, t))  # pragma: no branch
+                constraint_func = _map_types_constraint[numeric_type]
+
+        if attrs:
+            used_constraints.update(set(attrs))
+            kwargs = {
+                attr_name: attr
+                for attr_name, attr in ((attr_name, getattr(field_info, attr_name)) for attr_name in attrs)
+                if attr is not None
+            }
+            if kwargs:
+                constraint_func = cast(Callable[..., type], constraint_func)
+                return constraint_func(**kwargs)
+        return type_
+
+    return go(annotation), used_constraints
+
+
+def normalize_name(name: str) -> str:
+    """
+    Normalizes the given name. This can be applied to either a model *or* enum.
+    """
+    return re.sub(r'[^a-zA-Z0-9.\-_]', '_', name)
+
+
+class SkipField(Exception):
+    """
+    Utility exception used to exclude fields from schema.
+    """
+
+    def __init__(self, message: str) -> None:
+        self.message = message
diff --git a/lib/pydantic/tools.py b/lib/pydantic/tools.py
index 8e317c92..9cdb4538 100644
--- a/lib/pydantic/tools.py
+++ b/lib/pydantic/tools.py
@@ -1,4 +1,92 @@
-"""The `tools` module is a backport module from V1."""
-from ._migration import getattr_migration
+import json
+from functools import lru_cache
+from pathlib import Path
+from typing import TYPE_CHECKING, Any, Callable, Optional, Type, TypeVar, Union
 
-__getattr__ = getattr_migration(__name__)
+from .parse import Protocol, load_file, load_str_bytes
+from .types import StrBytes
+from .typing import display_as_type
+
+__all__ = ('parse_file_as', 'parse_obj_as', 'parse_raw_as', 'schema_of', 'schema_json_of')
+
+NameFactory = Union[str, Callable[[Type[Any]], str]]
+
+if TYPE_CHECKING:
+    from .typing import DictStrAny
+
+
+def _generate_parsing_type_name(type_: Any) -> str:
+    return f'ParsingModel[{display_as_type(type_)}]'
+
+
+@lru_cache(maxsize=2048)
+def _get_parsing_type(type_: Any, *, type_name: Optional[NameFactory] = None) -> Any:
+    from pydantic.main import create_model
+
+    if type_name is None:
+        type_name = _generate_parsing_type_name
+    if not isinstance(type_name, str):
+        type_name = type_name(type_)
+    return create_model(type_name, __root__=(type_, ...))
+
+
+T = TypeVar('T')
+
+
+def parse_obj_as(type_: Type[T], obj: Any, *, type_name: Optional[NameFactory] = None) -> T:
+    model_type = _get_parsing_type(type_, type_name=type_name)  # type: ignore[arg-type]
+    return model_type(__root__=obj).__root__
+
+
+def parse_file_as(
+    type_: Type[T],
+    path: Union[str, Path],
+    *,
+    content_type: str = None,
+    encoding: str = 'utf8',
+    proto: Protocol = None,
+    allow_pickle: bool = False,
+    json_loads: Callable[[str], Any] = json.loads,
+    type_name: Optional[NameFactory] = None,
+) -> T:
+    obj = load_file(
+        path,
+        proto=proto,
+        content_type=content_type,
+        encoding=encoding,
+        allow_pickle=allow_pickle,
+        json_loads=json_loads,
+    )
+    return parse_obj_as(type_, obj, type_name=type_name)
+
+
+def parse_raw_as(
+    type_: Type[T],
+    b: StrBytes,
+    *,
+    content_type: str = None,
+    encoding: str = 'utf8',
+    proto: Protocol = None,
+    allow_pickle: bool = False,
+    json_loads: Callable[[str], Any] = json.loads,
+    type_name: Optional[NameFactory] = None,
+) -> T:
+    obj = load_str_bytes(
+        b,
+        proto=proto,
+        content_type=content_type,
+        encoding=encoding,
+        allow_pickle=allow_pickle,
+        json_loads=json_loads,
+    )
+    return parse_obj_as(type_, obj, type_name=type_name)
+
+
+def schema_of(type_: Any, *, title: Optional[NameFactory] = None, **schema_kwargs: Any) -> 'DictStrAny':
+    """Generate a JSON schema (as dict) for the passed model or dynamically generated one"""
+    return _get_parsing_type(type_, type_name=title).schema(**schema_kwargs)
+
+
+def schema_json_of(type_: Any, *, title: Optional[NameFactory] = None, **schema_json_kwargs: Any) -> str:
+    """Generate a JSON schema (as JSON) for the passed model or dynamically generated one"""
+    return _get_parsing_type(type_, type_name=title).schema_json(**schema_json_kwargs)
diff --git a/lib/pydantic/type_adapter.py b/lib/pydantic/type_adapter.py
deleted file mode 100644
index 366262fe..00000000
--- a/lib/pydantic/type_adapter.py
+++ /dev/null
@@ -1,460 +0,0 @@
-"""Type adapter specification."""
-from __future__ import annotations as _annotations
-
-import sys
-from dataclasses import is_dataclass
-from typing import TYPE_CHECKING, Any, Dict, Generic, Iterable, Set, TypeVar, Union, cast, final, overload
-
-from pydantic_core import CoreSchema, SchemaSerializer, SchemaValidator, Some
-from typing_extensions import Literal, get_args, is_typeddict
-
-from pydantic.errors import PydanticUserError
-from pydantic.main import BaseModel
-
-from ._internal import _config, _generate_schema, _typing_extra
-from .config import ConfigDict
-from .json_schema import (
-    DEFAULT_REF_TEMPLATE,
-    GenerateJsonSchema,
-    JsonSchemaKeyT,
-    JsonSchemaMode,
-    JsonSchemaValue,
-)
-from .plugin._schema_validator import create_schema_validator
-
-T = TypeVar('T')
-
-
-if TYPE_CHECKING:
-    # should be `set[int] | set[str] | dict[int, IncEx] | dict[str, IncEx] | None`, but mypy can't cope
-    IncEx = Union[Set[int], Set[str], Dict[int, Any], Dict[str, Any]]
-
-
-def _get_schema(type_: Any, config_wrapper: _config.ConfigWrapper, parent_depth: int) -> CoreSchema:
-    """`BaseModel` uses its own `__module__` to find out where it was defined
-    and then looks for symbols to resolve forward references in those globals.
-    On the other hand this function can be called with arbitrary objects,
-    including type aliases, where `__module__` (always `typing.py`) is not useful.
-    So instead we look at the globals in our parent stack frame.
-
-    This works for the case where this function is called in a module that
-    has the target of forward references in its scope, but
-    does not always work for more complex cases.
-
-    For example, take the following:
-
-    a.py
-    ```python
-    from typing import Dict, List
-
-    IntList = List[int]
-    OuterDict = Dict[str, 'IntList']
-    ```
-
-    b.py
-    ```python test="skip"
-    from a import OuterDict
-
-    from pydantic import TypeAdapter
-
-    IntList = int  # replaces the symbol the forward reference is looking for
-    v = TypeAdapter(OuterDict)
-    v({'x': 1})  # should fail but doesn't
-    ```
-
-    If `OuterDict` were a `BaseModel`, this would work because it would resolve
-    the forward reference within the `a.py` namespace.
-    But `TypeAdapter(OuterDict)` can't determine what module `OuterDict` came from.
-
-    In other words, the assumption that _all_ forward references exist in the
-    module we are being called from is not technically always true.
-    Although most of the time it is and it works fine for recursive models and such,
-    `BaseModel`'s behavior isn't perfect either and _can_ break in similar ways,
-    so there is no right or wrong between the two.
-
-    But at the very least this behavior is _subtly_ different from `BaseModel`'s.
-    """
-    local_ns = _typing_extra.parent_frame_namespace(parent_depth=parent_depth)
-    global_ns = sys._getframe(max(parent_depth - 1, 1)).f_globals.copy()
-    global_ns.update(local_ns or {})
-    gen = _generate_schema.GenerateSchema(config_wrapper, types_namespace=global_ns, typevars_map={})
-    schema = gen.generate_schema(type_)
-    schema = gen.clean_schema(schema)
-    return schema
-
-
-def _getattr_no_parents(obj: Any, attribute: str) -> Any:
-    """Returns the attribute value without attempting to look up attributes from parent types."""
-    if hasattr(obj, '__dict__'):
-        try:
-            return obj.__dict__[attribute]
-        except KeyError:
-            pass
-
-    slots = getattr(obj, '__slots__', None)
-    if slots is not None and attribute in slots:
-        return getattr(obj, attribute)
-    else:
-        raise AttributeError(attribute)
-
-
-def _type_has_config(type_: Any) -> bool:
-    """Returns whether the type has config."""
-    try:
-        return issubclass(type_, BaseModel) or is_dataclass(type_) or is_typeddict(type_)
-    except TypeError:
-        # type is not a class
-        return False
-
-
-@final
-class TypeAdapter(Generic[T]):
-    """Usage docs: https://docs.pydantic.dev/2.6/concepts/type_adapter/
-
-    Type adapters provide a flexible way to perform validation and serialization based on a Python type.
-
-    A `TypeAdapter` instance exposes some of the functionality from `BaseModel` instance methods
-    for types that do not have such methods (such as dataclasses, primitive types, and more).
-
-    **Note:** `TypeAdapter` instances are not types, and cannot be used as type annotations for fields.
-
-    Attributes:
-        core_schema: The core schema for the type.
-        validator (SchemaValidator): The schema validator for the type.
-        serializer: The schema serializer for the type.
-    """
-
-    @overload
-    def __init__(
-        self,
-        type: type[T],
-        *,
-        config: ConfigDict | None = ...,
-        _parent_depth: int = ...,
-        module: str | None = ...,
-    ) -> None:
-        ...
-
-    # This second overload is for unsupported special forms (such as Union). `pyright` handles them fine, but `mypy` does not match
-    # them against `type: type[T]`, so an explicit overload with `type: T` is needed.
-    @overload
-    def __init__(  # pyright: ignore[reportOverlappingOverload]
-        self,
-        type: T,
-        *,
-        config: ConfigDict | None = ...,
-        _parent_depth: int = ...,
-        module: str | None = ...,
-    ) -> None:
-        ...
-
-    def __init__(
-        self,
-        type: type[T] | T,
-        *,
-        config: ConfigDict | None = None,
-        _parent_depth: int = 2,
-        module: str | None = None,
-    ) -> None:
-        """Initializes the TypeAdapter object.
-
-        Args:
-            type: The type associated with the `TypeAdapter`.
-            config: Configuration for the `TypeAdapter`, should be a dictionary conforming to [`ConfigDict`][pydantic.config.ConfigDict].
-            _parent_depth: depth at which to search the parent namespace to construct the local namespace.
-            module: The module that passes to plugin if provided.
-
-        !!! note
-            You cannot use the `config` argument when instantiating a `TypeAdapter` if the type you're using has its own
-            config that cannot be overridden (ex: `BaseModel`, `TypedDict`, and `dataclass`). A
-            [`type-adapter-config-unused`](../errors/usage_errors.md#type-adapter-config-unused) error will be raised in this case.
-
-        !!! note
-            The `_parent_depth` argument is named with an underscore to suggest its private nature and discourage use.
-            It may be deprecated in a minor version, so we only recommend using it if you're
-            comfortable with potential change in behavior / support.
-
-        ??? tip "Compatibility with `mypy`"
-            Depending on the type used, `mypy` might raise an error when instantiating a `TypeAdapter`. As a workaround, you can explicitly
-            annotate your variable:
-
-            ```py
-            from typing import Union
-
-            from pydantic import TypeAdapter
-
-            ta: TypeAdapter[Union[str, int]] = TypeAdapter(Union[str, int])  # type: ignore[arg-type]
-            ```
-
-        Returns:
-            A type adapter configured for the specified `type`.
-        """
-        type_is_annotated: bool = _typing_extra.is_annotated(type)
-        annotated_type: Any = get_args(type)[0] if type_is_annotated else None
-        type_has_config: bool = _type_has_config(annotated_type if type_is_annotated else type)
-
-        if type_has_config and config is not None:
-            raise PydanticUserError(
-                'Cannot use `config` when the type is a BaseModel, dataclass or TypedDict.'
-                ' These types can have their own config and setting the config via the `config`'
-                ' parameter to TypeAdapter will not override it, thus the `config` you passed to'
-                ' TypeAdapter becomes meaningless, which is probably not what you want.',
-                code='type-adapter-config-unused',
-            )
-
-        config_wrapper = _config.ConfigWrapper(config)
-
-        core_schema: CoreSchema
-        try:
-            core_schema = _getattr_no_parents(type, '__pydantic_core_schema__')
-        except AttributeError:
-            core_schema = _get_schema(type, config_wrapper, parent_depth=_parent_depth + 1)
-
-        core_config = config_wrapper.core_config(None)
-        validator: SchemaValidator
-        try:
-            validator = _getattr_no_parents(type, '__pydantic_validator__')
-        except AttributeError:
-            if module is None:
-                f = sys._getframe(1)
-                module = cast(str, f.f_globals.get('__name__', ''))
-            validator = create_schema_validator(
-                core_schema, type, module, str(type), 'TypeAdapter', core_config, config_wrapper.plugin_settings
-            )  # type: ignore
-
-        serializer: SchemaSerializer
-        try:
-            serializer = _getattr_no_parents(type, '__pydantic_serializer__')
-        except AttributeError:
-            serializer = SchemaSerializer(core_schema, core_config)
-
-        self.core_schema = core_schema
-        self.validator = validator
-        self.serializer = serializer
-
-    def validate_python(
-        self,
-        __object: Any,
-        *,
-        strict: bool | None = None,
-        from_attributes: bool | None = None,
-        context: dict[str, Any] | None = None,
-    ) -> T:
-        """Validate a Python object against the model.
-
-        Args:
-            __object: The Python object to validate against the model.
-            strict: Whether to strictly check types.
-            from_attributes: Whether to extract data from object attributes.
-            context: Additional context to pass to the validator.
-
-        !!! note
-            When using `TypeAdapter` with a Pydantic `dataclass`, the use of the `from_attributes`
-            argument is not supported.
-
-        Returns:
-            The validated object.
-        """
-        return self.validator.validate_python(__object, strict=strict, from_attributes=from_attributes, context=context)
-
-    def validate_json(
-        self, __data: str | bytes, *, strict: bool | None = None, context: dict[str, Any] | None = None
-    ) -> T:
-        """Usage docs: https://docs.pydantic.dev/2.6/concepts/json/#json-parsing
-
-        Validate a JSON string or bytes against the model.
-
-        Args:
-            __data: The JSON data to validate against the model.
-            strict: Whether to strictly check types.
-            context: Additional context to use during validation.
-
-        Returns:
-            The validated object.
-        """
-        return self.validator.validate_json(__data, strict=strict, context=context)
-
-    def validate_strings(self, __obj: Any, *, strict: bool | None = None, context: dict[str, Any] | None = None) -> T:
-        """Validate object contains string data against the model.
-
-        Args:
-            __obj: The object contains string data to validate.
-            strict: Whether to strictly check types.
-            context: Additional context to use during validation.
-
-        Returns:
-            The validated object.
-        """
-        return self.validator.validate_strings(__obj, strict=strict, context=context)
-
-    def get_default_value(self, *, strict: bool | None = None, context: dict[str, Any] | None = None) -> Some[T] | None:
-        """Get the default value for the wrapped type.
-
-        Args:
-            strict: Whether to strictly check types.
-            context: Additional context to pass to the validator.
-
-        Returns:
-            The default value wrapped in a `Some` if there is one or None if not.
-        """
-        return self.validator.get_default_value(strict=strict, context=context)
-
-    def dump_python(
-        self,
-        __instance: T,
-        *,
-        mode: Literal['json', 'python'] = 'python',
-        include: IncEx | None = None,
-        exclude: IncEx | None = None,
-        by_alias: bool = False,
-        exclude_unset: bool = False,
-        exclude_defaults: bool = False,
-        exclude_none: bool = False,
-        round_trip: bool = False,
-        warnings: bool = True,
-    ) -> Any:
-        """Dump an instance of the adapted type to a Python object.
-
-        Args:
-            __instance: The Python object to serialize.
-            mode: The output format.
-            include: Fields to include in the output.
-            exclude: Fields to exclude from the output.
-            by_alias: Whether to use alias names for field names.
-            exclude_unset: Whether to exclude unset fields.
-            exclude_defaults: Whether to exclude fields with default values.
-            exclude_none: Whether to exclude fields with None values.
-            round_trip: Whether to output the serialized data in a way that is compatible with deserialization.
-            warnings: Whether to display serialization warnings.
-
-        Returns:
-            The serialized object.
-        """
-        return self.serializer.to_python(
-            __instance,
-            mode=mode,
-            by_alias=by_alias,
-            include=include,
-            exclude=exclude,
-            exclude_unset=exclude_unset,
-            exclude_defaults=exclude_defaults,
-            exclude_none=exclude_none,
-            round_trip=round_trip,
-            warnings=warnings,
-        )
-
-    def dump_json(
-        self,
-        __instance: T,
-        *,
-        indent: int | None = None,
-        include: IncEx | None = None,
-        exclude: IncEx | None = None,
-        by_alias: bool = False,
-        exclude_unset: bool = False,
-        exclude_defaults: bool = False,
-        exclude_none: bool = False,
-        round_trip: bool = False,
-        warnings: bool = True,
-    ) -> bytes:
-        """Usage docs: https://docs.pydantic.dev/2.6/concepts/json/#json-serialization
-
-        Serialize an instance of the adapted type to JSON.
-
-        Args:
-            __instance: The instance to be serialized.
-            indent: Number of spaces for JSON indentation.
-            include: Fields to include.
-            exclude: Fields to exclude.
-            by_alias: Whether to use alias names for field names.
-            exclude_unset: Whether to exclude unset fields.
-            exclude_defaults: Whether to exclude fields with default values.
-            exclude_none: Whether to exclude fields with a value of `None`.
-            round_trip: Whether to serialize and deserialize the instance to ensure round-tripping.
-            warnings: Whether to emit serialization warnings.
-
-        Returns:
-            The JSON representation of the given instance as bytes.
-        """
-        return self.serializer.to_json(
-            __instance,
-            indent=indent,
-            include=include,
-            exclude=exclude,
-            by_alias=by_alias,
-            exclude_unset=exclude_unset,
-            exclude_defaults=exclude_defaults,
-            exclude_none=exclude_none,
-            round_trip=round_trip,
-            warnings=warnings,
-        )
-
-    def json_schema(
-        self,
-        *,
-        by_alias: bool = True,
-        ref_template: str = DEFAULT_REF_TEMPLATE,
-        schema_generator: type[GenerateJsonSchema] = GenerateJsonSchema,
-        mode: JsonSchemaMode = 'validation',
-    ) -> dict[str, Any]:
-        """Generate a JSON schema for the adapted type.
-
-        Args:
-            by_alias: Whether to use alias names for field names.
-            ref_template: The format string used for generating $ref strings.
-            schema_generator: The generator class used for creating the schema.
-            mode: The mode to use for schema generation.
-
-        Returns:
-            The JSON schema for the model as a dictionary.
-        """
-        schema_generator_instance = schema_generator(by_alias=by_alias, ref_template=ref_template)
-        return schema_generator_instance.generate(self.core_schema, mode=mode)
-
-    @staticmethod
-    def json_schemas(
-        __inputs: Iterable[tuple[JsonSchemaKeyT, JsonSchemaMode, TypeAdapter[Any]]],
-        *,
-        by_alias: bool = True,
-        title: str | None = None,
-        description: str | None = None,
-        ref_template: str = DEFAULT_REF_TEMPLATE,
-        schema_generator: type[GenerateJsonSchema] = GenerateJsonSchema,
-    ) -> tuple[dict[tuple[JsonSchemaKeyT, JsonSchemaMode], JsonSchemaValue], JsonSchemaValue]:
-        """Generate a JSON schema including definitions from multiple type adapters.
-
-        Args:
-            __inputs: Inputs to schema generation. The first two items will form the keys of the (first)
-                output mapping; the type adapters will provide the core schemas that get converted into
-                definitions in the output JSON schema.
-            by_alias: Whether to use alias names.
-            title: The title for the schema.
-            description: The description for the schema.
-            ref_template: The format string used for generating $ref strings.
-            schema_generator: The generator class used for creating the schema.
-
-        Returns:
-            A tuple where:
-
-                - The first element is a dictionary whose keys are tuples of JSON schema key type and JSON mode, and
-                    whose values are the JSON schema corresponding to that pair of inputs. (These schemas may have
-                    JsonRef references to definitions that are defined in the second returned element.)
-                - The second element is a JSON schema containing all definitions referenced in the first returned
-                    element, along with the optional title and description keys.
-
-        """
-        schema_generator_instance = schema_generator(by_alias=by_alias, ref_template=ref_template)
-
-        inputs = [(key, mode, adapter.core_schema) for key, mode, adapter in __inputs]
-
-        json_schemas_map, definitions = schema_generator_instance.generate_definitions(inputs)
-
-        json_schema: dict[str, Any] = {}
-        if definitions:
-            json_schema['$defs'] = definitions
-        if title:
-            json_schema['title'] = title
-        if description:
-            json_schema['description'] = description
-
-        return json_schemas_map, json_schema
diff --git a/lib/pydantic/types.py b/lib/pydantic/types.py
index c2534c88..f98dba3d 100644
--- a/lib/pydantic/types.py
+++ b/lib/pydantic/types.py
@@ -1,14 +1,12 @@
-"""The types module contains custom types used by pydantic."""
-from __future__ import annotations as _annotations
-
-import base64
-import dataclasses as _dataclasses
+import abc
+import math
 import re
-from datetime import date, datetime
+import warnings
+from datetime import date
 from decimal import Decimal
 from enum import Enum
 from pathlib import Path
-from types import ModuleType
+from types import new_class
 from typing import (
     TYPE_CHECKING,
     Any,
@@ -16,56 +14,78 @@ from typing import (
     ClassVar,
     Dict,
     FrozenSet,
-    Generic,
-    Hashable,
-    Iterator,
     List,
+    Optional,
+    Pattern,
     Set,
+    Tuple,
+    Type,
     TypeVar,
     Union,
     cast,
+    overload,
 )
 from uuid import UUID
+from weakref import WeakSet
 
-import annotated_types
-from annotated_types import BaseMetadata, MaxLen, MinLen
-from pydantic_core import CoreSchema, PydanticCustomError, core_schema
-from typing_extensions import Annotated, Literal, Protocol, TypeAlias, TypeAliasType, deprecated
-
-from ._internal import (
-    _core_utils,
-    _fields,
-    _internal_dataclass,
-    _typing_extra,
-    _utils,
-    _validators,
+from . import errors
+from .datetime_parse import parse_date
+from .utils import import_string, update_not_none
+from .validators import (
+    bytes_validator,
+    constr_length_validator,
+    constr_lower,
+    constr_strip_whitespace,
+    constr_upper,
+    decimal_validator,
+    float_finite_validator,
+    float_validator,
+    frozenset_validator,
+    int_validator,
+    list_validator,
+    number_multiple_validator,
+    number_size_validator,
+    path_exists_validator,
+    path_validator,
+    set_validator,
+    str_validator,
+    strict_bytes_validator,
+    strict_float_validator,
+    strict_int_validator,
+    strict_str_validator,
 )
-from ._migration import getattr_migration
-from .annotated_handlers import GetCoreSchemaHandler, GetJsonSchemaHandler
-from .errors import PydanticUserError
-from .json_schema import JsonSchemaValue
-from .warnings import PydanticDeprecatedSince20
 
-__all__ = (
-    'Strict',
+__all__ = [
+    'NoneStr',
+    'NoneBytes',
+    'StrBytes',
+    'NoneStrBytes',
     'StrictStr',
+    'ConstrainedBytes',
     'conbytes',
+    'ConstrainedList',
     'conlist',
+    'ConstrainedSet',
     'conset',
+    'ConstrainedFrozenSet',
     'confrozenset',
+    'ConstrainedStr',
     'constr',
-    'ImportString',
+    'PyObject',
+    'ConstrainedInt',
     'conint',
     'PositiveInt',
     'NegativeInt',
     'NonNegativeInt',
     'NonPositiveInt',
+    'ConstrainedFloat',
     'confloat',
     'PositiveFloat',
     'NegativeFloat',
     'NonNegativeFloat',
     'NonPositiveFloat',
     'FiniteFloat',
+    'ConstrainedDecimal',
     'condecimal',
     'UUID1',
     'UUID3',
@@ -73,8 +93,9 @@ __all__ = (
     'UUID5',
     'FilePath',
     'DirectoryPath',
-    'NewPath',
     'Json',
+    'JsonWrapper',
+    'SecretField',
     'SecretStr',
     'SecretBytes',
     'StrictBool',
@@ -85,1512 +106,845 @@ __all__ = (
     'ByteSize',
     'PastDate',
     'FutureDate',
-    'PastDatetime',
-    'FutureDatetime',
+    'ConstrainedDate',
     'condate',
-    'AwareDatetime',
-    'NaiveDatetime',
-    'AllowInfNan',
-    'EncoderProtocol',
-    'EncodedBytes',
-    'EncodedStr',
-    'Base64Encoder',
-    'Base64Bytes',
-    'Base64Str',
-    'Base64UrlBytes',
-    'Base64UrlStr',
-    'GetPydanticSchema',
-    'StringConstraints',
-    'Tag',
-    'Discriminator',
-    'JsonValue',
-    'OnErrorOmit',
-)
+]
 
+NoneStr = Optional[str]
+NoneBytes = Optional[bytes]
+StrBytes = Union[str, bytes]
+NoneStrBytes = Optional[StrBytes]
+OptionalInt = Optional[int]
+OptionalIntFloat = Union[OptionalInt, float]
+OptionalIntFloatDecimal = Union[OptionalIntFloat, Decimal]
+OptionalDate = Optional[date]
+StrIntFloat = Union[str, int, float]
+
+if TYPE_CHECKING:
+    from typing_extensions import Annotated
+
+    from .dataclasses import Dataclass
+    from .main import BaseModel
+    from .typing import CallableGenerator
+
+    ModelOrDc = Type[Union[BaseModel, Dataclass]]
 
 T = TypeVar('T')
+_DEFINED_TYPES: 'WeakSet[type]' = WeakSet()
 
 
-@_dataclasses.dataclass
-class Strict(_fields.PydanticMetadata, BaseMetadata):
-    """Usage docs: https://docs.pydantic.dev/2.6/concepts/strict_mode/#strict-mode-with-annotated-strict
+@overload
+def _registered(typ: Type[T]) -> Type[T]:
+    pass
 
-    A field metadata class to indicate that a field should be validated in strict mode.
 
-    Attributes:
-        strict: Whether to validate the field in strict mode.
+@overload
+def _registered(typ: 'ConstrainedNumberMeta') -> 'ConstrainedNumberMeta':
+    pass
 
-    Example:
-        ```python
-        from typing_extensions import Annotated
 
-        from pydantic.types import Strict
+def _registered(typ: Union[Type[T], 'ConstrainedNumberMeta']) -> Union[Type[T], 'ConstrainedNumberMeta']:
+    # In order to generate valid examples of constrained types, Hypothesis needs
+    # to inspect the type object - so we keep a weakref to each contype object
+    # until it can be registered.  When (or if) our Hypothesis plugin is loaded,
+    # it monkeypatches this function.
+    # If Hypothesis is never used, the total effect is to keep a weak reference
+    # which has minimal memory usage and doesn't even affect garbage collection.
+    _DEFINED_TYPES.add(typ)
+    return typ
 
-        StrictBool = Annotated[bool, Strict()]
-        ```
-    """
 
-    strict: bool = True
+class ConstrainedNumberMeta(type):
+    def __new__(cls, name: str, bases: Any, dct: Dict[str, Any]) -> 'ConstrainedInt':  # type: ignore
+        new_cls = cast('ConstrainedInt', type.__new__(cls, name, bases, dct))
 
-    def __hash__(self) -> int:
-        return hash(self.strict)
+        if new_cls.gt is not None and new_cls.ge is not None:
+            raise errors.ConfigError('bounds gt and ge cannot be specified at the same time')
+        if new_cls.lt is not None and new_cls.le is not None:
+            raise errors.ConfigError('bounds lt and le cannot be specified at the same time')
+
+        return _registered(new_cls)  # type: ignore
 
 
 # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ BOOLEAN TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-StrictBool = Annotated[bool, Strict()]
-"""A boolean that must be either ``True`` or ``False``."""
+if TYPE_CHECKING:
+    StrictBool = bool
+else:
+
+    class StrictBool(int):
+        """
+        StrictBool to allow for bools which are not type-coerced.
+        """
+
+        @classmethod
+        def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+            field_schema.update(type='boolean')
+
+        @classmethod
+        def __get_validators__(cls) -> 'CallableGenerator':
+            yield cls.validate
+
+        @classmethod
+        def validate(cls, value: Any) -> bool:
+            """
+            Ensure that we only allow bools.
+            """
+            if isinstance(value, bool):
+                return value
+
+            raise errors.StrictBoolError()
+
 
 # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ INTEGER TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 
+class ConstrainedInt(int, metaclass=ConstrainedNumberMeta):
+    strict: bool = False
+    gt: OptionalInt = None
+    ge: OptionalInt = None
+    lt: OptionalInt = None
+    le: OptionalInt = None
+    multiple_of: OptionalInt = None
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        update_not_none(
+            field_schema,
+            exclusiveMinimum=cls.gt,
+            exclusiveMaximum=cls.lt,
+            minimum=cls.ge,
+            maximum=cls.le,
+            multipleOf=cls.multiple_of,
+        )
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield strict_int_validator if cls.strict else int_validator
+        yield number_size_validator
+        yield number_multiple_validator
+
+
 def conint(
-    *,
-    strict: bool | None = None,
-    gt: int | None = None,
-    ge: int | None = None,
-    lt: int | None = None,
-    le: int | None = None,
-    multiple_of: int | None = None,
-) -> type[int]:
-    """
-    !!! warning "Discouraged"
-        This function is **discouraged** in favor of using
-        [`Annotated`](https://docs.python.org/3/library/typing.html#typing.Annotated) with
-        [`Field`][pydantic.fields.Field] instead.
-
-        This function will be **deprecated** in Pydantic 3.0.
-
-        The reason is that `conint` returns a type, which doesn't play well with static analysis tools.
-
-        === ":x: Don't do this"
-            ```py
-            from pydantic import BaseModel, conint
-
-            class Foo(BaseModel):
-                bar: conint(strict=True, gt=0)
-            ```
-
-        === ":white_check_mark: Do this"
-            ```py
-            from typing_extensions import Annotated
-
-            from pydantic import BaseModel, Field
-
-            class Foo(BaseModel):
-                bar: Annotated[int, Field(strict=True, gt=0)]
-            ```
-
-    A wrapper around `int` that allows for additional constraints.
-
-    Args:
-        strict: Whether to validate the integer in strict mode. Defaults to `None`.
-        gt: The value must be greater than this.
-        ge: The value must be greater than or equal to this.
-        lt: The value must be less than this.
-        le: The value must be less than or equal to this.
-        multiple_of: The value must be a multiple of this.
-
-    Returns:
-        The wrapped integer type.
-
-    ```py
-    from pydantic import BaseModel, ValidationError, conint
-
-    class ConstrainedExample(BaseModel):
-        constrained_int: conint(gt=1)
-
-    m = ConstrainedExample(constrained_int=2)
-    print(repr(m))
-    #> ConstrainedExample(constrained_int=2)
-
-    try:
-        ConstrainedExample(constrained_int=0)
-    except ValidationError as e:
-        print(e.errors())
-        '''
-        [
-            {
-                'type': 'greater_than',
-                'loc': ('constrained_int',),
-                'msg': 'Input should be greater than 1',
-                'input': 0,
-                'ctx': {'gt': 1},
-                'url': 'https://errors.pydantic.dev/2/v/greater_than',
-            }
-        ]
-        '''
-    ```
-
-    """  # noqa: D212
-    return Annotated[
-        int,
-        Strict(strict) if strict is not None else None,
-        annotated_types.Interval(gt=gt, ge=ge, lt=lt, le=le),
-        annotated_types.MultipleOf(multiple_of) if multiple_of is not None else None,
-    ]
+    *, strict: bool = False, gt: int = None, ge: int = None, lt: int = None, le: int = None, multiple_of: int = None
+) -> Type[int]:
+    # use kwargs then define conf in a dict to aid with IDE type hinting
+    namespace = dict(strict=strict, gt=gt, ge=ge, lt=lt, le=le, multiple_of=multiple_of)
+    return type('ConstrainedIntValue', (ConstrainedInt,), namespace)
 
 
-PositiveInt = Annotated[int, annotated_types.Gt(0)]
-"""An integer that must be greater than zero.
+if TYPE_CHECKING:
+    PositiveInt = int
+    NegativeInt = int
+    NonPositiveInt = int
+    NonNegativeInt = int
+    StrictInt = int
+else:
 
-```py
-from pydantic import BaseModel, PositiveInt, ValidationError
+    class PositiveInt(ConstrainedInt):
+        gt = 0
 
-class Model(BaseModel):
-    positive_int: PositiveInt
+    class NegativeInt(ConstrainedInt):
+        lt = 0
 
-m = Model(positive_int=1)
-print(repr(m))
-#> Model(positive_int=1)
+    class NonPositiveInt(ConstrainedInt):
+        le = 0
 
-try:
-    Model(positive_int=-1)
-except ValidationError as e:
-    print(e.errors())
-    '''
-    [
-        {
-            'type': 'greater_than',
-            'loc': ('positive_int',),
-            'msg': 'Input should be greater than 0',
-            'input': -1,
-            'ctx': {'gt': 0},
-            'url': 'https://errors.pydantic.dev/2/v/greater_than',
-        }
-    ]
-    '''
-```
-"""
-NegativeInt = Annotated[int, annotated_types.Lt(0)]
-"""An integer that must be less than zero.
+    class NonNegativeInt(ConstrainedInt):
+        ge = 0
 
-```py
-from pydantic import BaseModel, NegativeInt, ValidationError
+    class StrictInt(ConstrainedInt):
+        strict = True
 
-class Model(BaseModel):
-    negative_int: NegativeInt
-
-m = Model(negative_int=-1)
-print(repr(m))
-#> Model(negative_int=-1)
-
-try:
-    Model(negative_int=1)
-except ValidationError as e:
-    print(e.errors())
-    '''
-    [
-        {
-            'type': 'less_than',
-            'loc': ('negative_int',),
-            'msg': 'Input should be less than 0',
-            'input': 1,
-            'ctx': {'lt': 0},
-            'url': 'https://errors.pydantic.dev/2/v/less_than',
-        }
-    ]
-    '''
-```
-"""
-NonPositiveInt = Annotated[int, annotated_types.Le(0)]
-"""An integer that must be less than or equal to zero.
-
-```py
-from pydantic import BaseModel, NonPositiveInt, ValidationError
-
-class Model(BaseModel):
-    non_positive_int: NonPositiveInt
-
-m = Model(non_positive_int=0)
-print(repr(m))
-#> Model(non_positive_int=0)
-
-try:
-    Model(non_positive_int=1)
-except ValidationError as e:
-    print(e.errors())
-    '''
-    [
-        {
-            'type': 'less_than_equal',
-            'loc': ('non_positive_int',),
-            'msg': 'Input should be less than or equal to 0',
-            'input': 1,
-            'ctx': {'le': 0},
-            'url': 'https://errors.pydantic.dev/2/v/less_than_equal',
-        }
-    ]
-    '''
-```
-"""
-NonNegativeInt = Annotated[int, annotated_types.Ge(0)]
-"""An integer that must be greater than or equal to zero.
-
-```py
-from pydantic import BaseModel, NonNegativeInt, ValidationError
-
-class Model(BaseModel):
-    non_negative_int: NonNegativeInt
-
-m = Model(non_negative_int=0)
-print(repr(m))
-#> Model(non_negative_int=0)
-
-try:
-    Model(non_negative_int=-1)
-except ValidationError as e:
-    print(e.errors())
-    '''
-    [
-        {
-            'type': 'greater_than_equal',
-            'loc': ('non_negative_int',),
-            'msg': 'Input should be greater than or equal to 0',
-            'input': -1,
-            'ctx': {'ge': 0},
-            'url': 'https://errors.pydantic.dev/2/v/greater_than_equal',
-        }
-    ]
-    '''
-```
-"""
-StrictInt = Annotated[int, Strict()]
-"""An integer that must be validated in strict mode.
-
-```py
-from pydantic import BaseModel, StrictInt, ValidationError
-
-class StrictIntModel(BaseModel):
-    strict_int: StrictInt
-
-try:
-    StrictIntModel(strict_int=3.14159)
-except ValidationError as e:
-    print(e)
-    '''
-    1 validation error for StrictIntModel
-    strict_int
-      Input should be a valid integer [type=int_type, input_value=3.14159, input_type=float]
-    '''
-```
-"""
 
 # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ FLOAT TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 
-@_dataclasses.dataclass
-class AllowInfNan(_fields.PydanticMetadata):
-    """A field metadata class to indicate that a field should allow ``-inf``, ``inf``, and ``nan``."""
+class ConstrainedFloat(float, metaclass=ConstrainedNumberMeta):
+    strict: bool = False
+    gt: OptionalIntFloat = None
+    ge: OptionalIntFloat = None
+    lt: OptionalIntFloat = None
+    le: OptionalIntFloat = None
+    multiple_of: OptionalIntFloat = None
+    allow_inf_nan: Optional[bool] = None
 
-    allow_inf_nan: bool = True
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        update_not_none(
+            field_schema,
+            exclusiveMinimum=cls.gt,
+            exclusiveMaximum=cls.lt,
+            minimum=cls.ge,
+            maximum=cls.le,
+            multipleOf=cls.multiple_of,
+        )
+        # Modify constraints to account for differences between IEEE floats and JSON
+        if field_schema.get('exclusiveMinimum') == -math.inf:
+            del field_schema['exclusiveMinimum']
+        if field_schema.get('minimum') == -math.inf:
+            del field_schema['minimum']
+        if field_schema.get('exclusiveMaximum') == math.inf:
+            del field_schema['exclusiveMaximum']
+        if field_schema.get('maximum') == math.inf:
+            del field_schema['maximum']
 
-    def __hash__(self) -> int:
-        return hash(self.allow_inf_nan)
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield strict_float_validator if cls.strict else float_validator
+        yield number_size_validator
+        yield number_multiple_validator
+        yield float_finite_validator
 
 
 def confloat(
     *,
-    strict: bool | None = None,
-    gt: float | None = None,
-    ge: float | None = None,
-    lt: float | None = None,
-    le: float | None = None,
-    multiple_of: float | None = None,
-    allow_inf_nan: bool | None = None,
-) -> type[float]:
-    """
-    !!! warning "Discouraged"
-        This function is **discouraged** in favor of using
-        [`Annotated`](https://docs.python.org/3/library/typing.html#typing.Annotated) with
-        [`Field`][pydantic.fields.Field] instead.
-
-        This function will be **deprecated** in Pydantic 3.0.
-
-        The reason is that `confloat` returns a type, which doesn't play well with static analysis tools.
-
-        === ":x: Don't do this"
-            ```py
-            from pydantic import BaseModel, confloat
-
-            class Foo(BaseModel):
-                bar: confloat(strict=True, gt=0)
-            ```
-
-        === ":white_check_mark: Do this"
-            ```py
-            from typing_extensions import Annotated
-
-            from pydantic import BaseModel, Field
-
-            class Foo(BaseModel):
-                bar: Annotated[float, Field(strict=True, gt=0)]
-            ```
-
-    A wrapper around `float` that allows for additional constraints.
-
-    Args:
-        strict: Whether to validate the float in strict mode.
-        gt: The value must be greater than this.
-        ge: The value must be greater than or equal to this.
-        lt: The value must be less than this.
-        le: The value must be less than or equal to this.
-        multiple_of: The value must be a multiple of this.
-        allow_inf_nan: Whether to allow `-inf`, `inf`, and `nan`.
-
-    Returns:
-        The wrapped float type.
-
-    ```py
-    from pydantic import BaseModel, ValidationError, confloat
-
-    class ConstrainedExample(BaseModel):
-        constrained_float: confloat(gt=1.0)
-
-    m = ConstrainedExample(constrained_float=1.1)
-    print(repr(m))
-    #> ConstrainedExample(constrained_float=1.1)
-
-    try:
-        ConstrainedExample(constrained_float=0.9)
-    except ValidationError as e:
-        print(e.errors())
-        '''
-        [
-            {
-                'type': 'greater_than',
-                'loc': ('constrained_float',),
-                'msg': 'Input should be greater than 1',
-                'input': 0.9,
-                'ctx': {'gt': 1.0},
-                'url': 'https://errors.pydantic.dev/2/v/greater_than',
-            }
-        ]
-        '''
-    ```
-    """  # noqa: D212
-    return Annotated[
-        float,
-        Strict(strict) if strict is not None else None,
-        annotated_types.Interval(gt=gt, ge=ge, lt=lt, le=le),
-        annotated_types.MultipleOf(multiple_of) if multiple_of is not None else None,
-        AllowInfNan(allow_inf_nan) if allow_inf_nan is not None else None,
-    ]
+    strict: bool = False,
+    gt: float = None,
+    ge: float = None,
+    lt: float = None,
+    le: float = None,
+    multiple_of: float = None,
+    allow_inf_nan: Optional[bool] = None,
+) -> Type[float]:
+    # use kwargs then define conf in a dict to aid with IDE type hinting
+    namespace = dict(strict=strict, gt=gt, ge=ge, lt=lt, le=le, multiple_of=multiple_of, allow_inf_nan=allow_inf_nan)
+    return type('ConstrainedFloatValue', (ConstrainedFloat,), namespace)
 
 
-PositiveFloat = Annotated[float, annotated_types.Gt(0)]
-"""A float that must be greater than zero.
+if TYPE_CHECKING:
+    PositiveFloat = float
+    NegativeFloat = float
+    NonPositiveFloat = float
+    NonNegativeFloat = float
+    StrictFloat = float
+    FiniteFloat = float
+else:
 
-```py
-from pydantic import BaseModel, PositiveFloat, ValidationError
+    class PositiveFloat(ConstrainedFloat):
+        gt = 0
 
-class Model(BaseModel):
-    positive_float: PositiveFloat
+    class NegativeFloat(ConstrainedFloat):
+        lt = 0
 
-m = Model(positive_float=1.0)
-print(repr(m))
-#> Model(positive_float=1.0)
+    class NonPositiveFloat(ConstrainedFloat):
+        le = 0
 
-try:
-    Model(positive_float=-1.0)
-except ValidationError as e:
-    print(e.errors())
-    '''
-    [
-        {
-            'type': 'greater_than',
-            'loc': ('positive_float',),
-            'msg': 'Input should be greater than 0',
-            'input': -1.0,
-            'ctx': {'gt': 0.0},
-            'url': 'https://errors.pydantic.dev/2/v/greater_than',
-        }
-    ]
-    '''
-```
-"""
-NegativeFloat = Annotated[float, annotated_types.Lt(0)]
-"""A float that must be less than zero.
+    class NonNegativeFloat(ConstrainedFloat):
+        ge = 0
 
-```py
-from pydantic import BaseModel, NegativeFloat, ValidationError
+    class StrictFloat(ConstrainedFloat):
+        strict = True
 
-class Model(BaseModel):
-    negative_float: NegativeFloat
-
-m = Model(negative_float=-1.0)
-print(repr(m))
-#> Model(negative_float=-1.0)
-
-try:
-    Model(negative_float=1.0)
-except ValidationError as e:
-    print(e.errors())
-    '''
-    [
-        {
-            'type': 'less_than',
-            'loc': ('negative_float',),
-            'msg': 'Input should be less than 0',
-            'input': 1.0,
-            'ctx': {'lt': 0.0},
-            'url': 'https://errors.pydantic.dev/2/v/less_than',
-        }
-    ]
-    '''
-```
-"""
-NonPositiveFloat = Annotated[float, annotated_types.Le(0)]
-"""A float that must be less than or equal to zero.
-
-```py
-from pydantic import BaseModel, NonPositiveFloat, ValidationError
-
-class Model(BaseModel):
-    non_positive_float: NonPositiveFloat
-
-m = Model(non_positive_float=0.0)
-print(repr(m))
-#> Model(non_positive_float=0.0)
-
-try:
-    Model(non_positive_float=1.0)
-except ValidationError as e:
-    print(e.errors())
-    '''
-    [
-        {
-            'type': 'less_than_equal',
-            'loc': ('non_positive_float',),
-            'msg': 'Input should be less than or equal to 0',
-            'input': 1.0,
-            'ctx': {'le': 0.0},
-            'url': 'https://errors.pydantic.dev/2/v/less_than_equal',
-        }
-    ]
-    '''
-```
-"""
-NonNegativeFloat = Annotated[float, annotated_types.Ge(0)]
-"""A float that must be greater than or equal to zero.
-
-```py
-from pydantic import BaseModel, NonNegativeFloat, ValidationError
-
-class Model(BaseModel):
-    non_negative_float: NonNegativeFloat
-
-m = Model(non_negative_float=0.0)
-print(repr(m))
-#> Model(non_negative_float=0.0)
-
-try:
-    Model(non_negative_float=-1.0)
-except ValidationError as e:
-    print(e.errors())
-    '''
-    [
-        {
-            'type': 'greater_than_equal',
-            'loc': ('non_negative_float',),
-            'msg': 'Input should be greater than or equal to 0',
-            'input': -1.0,
-            'ctx': {'ge': 0.0},
-            'url': 'https://errors.pydantic.dev/2/v/greater_than_equal',
-        }
-    ]
-    '''
-```
-"""
-StrictFloat = Annotated[float, Strict(True)]
-"""A float that must be validated in strict mode.
-
-```py
-from pydantic import BaseModel, StrictFloat, ValidationError
-
-class StrictFloatModel(BaseModel):
-    strict_float: StrictFloat
-
-try:
-    StrictFloatModel(strict_float='1.0')
-except ValidationError as e:
-    print(e)
-    '''
-    1 validation error for StrictFloatModel
-    strict_float
-      Input should be a valid number [type=float_type, input_value='1.0', input_type=str]
-    '''
-```
-"""
-FiniteFloat = Annotated[float, AllowInfNan(False)]
-"""A float that must be finite (not ``-inf``, ``inf``, or ``nan``).
-
-```py
-from pydantic import BaseModel, FiniteFloat
-
-class Model(BaseModel):
-    finite: FiniteFloat
-
-m = Model(finite=1.0)
-print(m)
-#> finite=1.0
-```
-"""
+    class FiniteFloat(ConstrainedFloat):
+        allow_inf_nan = False
 
 
 # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ BYTES TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 
+class ConstrainedBytes(bytes):
+    strip_whitespace = False
+    to_upper = False
+    to_lower = False
+    min_length: OptionalInt = None
+    max_length: OptionalInt = None
+    strict: bool = False
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        update_not_none(field_schema, minLength=cls.min_length, maxLength=cls.max_length)
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield strict_bytes_validator if cls.strict else bytes_validator
+        yield constr_strip_whitespace
+        yield constr_upper
+        yield constr_lower
+        yield constr_length_validator
+
+
 def conbytes(
     *,
-    min_length: int | None = None,
-    max_length: int | None = None,
-    strict: bool | None = None,
-) -> type[bytes]:
-    """A wrapper around `bytes` that allows for additional constraints.
-
-    Args:
-        min_length: The minimum length of the bytes.
-        max_length: The maximum length of the bytes.
-        strict: Whether to validate the bytes in strict mode.
-
-    Returns:
-        The wrapped bytes type.
-    """
-    return Annotated[
-        bytes,
-        Strict(strict) if strict is not None else None,
-        annotated_types.Len(min_length or 0, max_length),
-    ]
+    strip_whitespace: bool = False,
+    to_upper: bool = False,
+    to_lower: bool = False,
+    min_length: int = None,
+    max_length: int = None,
+    strict: bool = False,
+) -> Type[bytes]:
+    # use kwargs then define conf in a dict to aid with IDE type hinting
+    namespace = dict(
+        strip_whitespace=strip_whitespace,
+        to_upper=to_upper,
+        to_lower=to_lower,
+        min_length=min_length,
+        max_length=max_length,
+        strict=strict,
+    )
+    return _registered(type('ConstrainedBytesValue', (ConstrainedBytes,), namespace))
 
 
-StrictBytes = Annotated[bytes, Strict()]
-"""A bytes that must be validated in strict mode."""
+if TYPE_CHECKING:
+    StrictBytes = bytes
+else:
+
+    class StrictBytes(ConstrainedBytes):
+        strict = True
 
 
 # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ STRING TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 
-@_dataclasses.dataclass(frozen=True)
-class StringConstraints(annotated_types.GroupedMetadata):
-    """Usage docs: https://docs.pydantic.dev/2.6/concepts/fields/#string-constraints
+class ConstrainedStr(str):
+    strip_whitespace = False
+    to_upper = False
+    to_lower = False
+    min_length: OptionalInt = None
+    max_length: OptionalInt = None
+    curtail_length: OptionalInt = None
+    regex: Optional[Pattern[str]] = None
+    strict = False
 
-    Apply constraints to `str` types.
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        update_not_none(
+            field_schema,
+            minLength=cls.min_length,
+            maxLength=cls.max_length,
+            pattern=cls.regex and cls.regex.pattern,
+        )
 
-    Attributes:
-        strip_whitespace: Whether to strip whitespace from the string.
-        to_upper: Whether to convert the string to uppercase.
-        to_lower: Whether to convert the string to lowercase.
-        strict: Whether to validate the string in strict mode.
-        min_length: The minimum length of the string.
-        max_length: The maximum length of the string.
-        pattern: A regex pattern that the string must match.
-    """
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield strict_str_validator if cls.strict else str_validator
+        yield constr_strip_whitespace
+        yield constr_upper
+        yield constr_lower
+        yield constr_length_validator
+        yield cls.validate
 
-    strip_whitespace: bool | None = None
-    to_upper: bool | None = None
-    to_lower: bool | None = None
-    strict: bool | None = None
-    min_length: int | None = None
-    max_length: int | None = None
-    pattern: str | None = None
+    @classmethod
+    def validate(cls, value: Union[str]) -> Union[str]:
+        if cls.curtail_length and len(value) > cls.curtail_length:
+            value = value[: cls.curtail_length]
 
-    def __iter__(self) -> Iterator[BaseMetadata]:
-        if self.min_length is not None:
-            yield MinLen(self.min_length)
-        if self.max_length is not None:
-            yield MaxLen(self.max_length)
-        if self.strict is not None:
-            yield Strict()
-        if (
-            self.strip_whitespace is not None
-            or self.pattern is not None
-            or self.to_lower is not None
-            or self.to_upper is not None
-        ):
-            yield _fields.pydantic_general_metadata(
-                strip_whitespace=self.strip_whitespace,
-                to_upper=self.to_upper,
-                to_lower=self.to_lower,
-                pattern=self.pattern,
-            )
+        if cls.regex:
+            if not cls.regex.match(value):
+                raise errors.StrRegexError(pattern=cls.regex.pattern)
+
+        return value
 
 
 def constr(
     *,
-    strip_whitespace: bool | None = None,
-    to_upper: bool | None = None,
-    to_lower: bool | None = None,
-    strict: bool | None = None,
-    min_length: int | None = None,
-    max_length: int | None = None,
-    pattern: str | None = None,
-) -> type[str]:
-    """
-    !!! warning "Discouraged"
-        This function is **discouraged** in favor of using
-        [`Annotated`](https://docs.python.org/3/library/typing.html#typing.Annotated) with
-        [`StringConstraints`][pydantic.types.StringConstraints] instead.
-
-        This function will be **deprecated** in Pydantic 3.0.
-
-        The reason is that `constr` returns a type, which doesn't play well with static analysis tools.
-
-        === ":x: Don't do this"
-            ```py
-            from pydantic import BaseModel, constr
-
-            class Foo(BaseModel):
-                bar: constr(strip_whitespace=True, to_upper=True, pattern=r'^[A-Z]+$')
-            ```
-
-        === ":white_check_mark: Do this"
-            ```py
-            from typing_extensions import Annotated
-
-            from pydantic import BaseModel, StringConstraints
-
-            class Foo(BaseModel):
-                bar: Annotated[str, StringConstraints(strip_whitespace=True, to_upper=True, pattern=r'^[A-Z]+$')]
-            ```
-
-    A wrapper around `str` that allows for additional constraints.
-
-    ```py
-    from pydantic import BaseModel, constr
-
-    class Foo(BaseModel):
-        bar: constr(strip_whitespace=True, to_upper=True, pattern=r'^[A-Z]+$')
+    strip_whitespace: bool = False,
+    to_upper: bool = False,
+    to_lower: bool = False,
+    strict: bool = False,
+    min_length: int = None,
+    max_length: int = None,
+    curtail_length: int = None,
+    regex: str = None,
+) -> Type[str]:
+    # use kwargs then define conf in a dict to aid with IDE type hinting
+    namespace = dict(
+        strip_whitespace=strip_whitespace,
+        to_upper=to_upper,
+        to_lower=to_lower,
+        strict=strict,
+        min_length=min_length,
+        max_length=max_length,
+        curtail_length=curtail_length,
+        regex=regex and re.compile(regex),
+    )
+    return _registered(type('ConstrainedStrValue', (ConstrainedStr,), namespace))
 
 
-    foo = Foo(bar='  hello  ')
-    print(foo)
-    #> bar='HELLO'
-    ```
+if TYPE_CHECKING:
+    StrictStr = str
+else:
 
-    Args:
-        strip_whitespace: Whether to remove leading and trailing whitespace.
-        to_upper: Whether to turn all characters to uppercase.
-        to_lower: Whether to turn all characters to lowercase.
-        strict: Whether to validate the string in strict mode.
-        min_length: The minimum length of the string.
-        max_length: The maximum length of the string.
-        pattern: A regex pattern to validate the string against.
-
-    Returns:
-        The wrapped string type.
-    """  # noqa: D212
-    return Annotated[
-        str,
-        StringConstraints(
-            strip_whitespace=strip_whitespace,
-            to_upper=to_upper,
-            to_lower=to_lower,
-            strict=strict,
-            min_length=min_length,
-            max_length=max_length,
-            pattern=pattern,
-        ),
-    ]
+    class StrictStr(ConstrainedStr):
+        strict = True
 
 
-StrictStr = Annotated[str, Strict()]
-"""A string that must be validated in strict mode."""
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ SET TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+# This types superclass should be Set[T], but cython chokes on that...
+class ConstrainedSet(set):  # type: ignore
+    # Needed for pydantic to detect that this is a set
+    __origin__ = set
+    __args__: Set[Type[T]]  # type: ignore
+
+    min_items: Optional[int] = None
+    max_items: Optional[int] = None
+    item_type: Type[T]  # type: ignore
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield cls.set_length_validator
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        update_not_none(field_schema, minItems=cls.min_items, maxItems=cls.max_items)
+
+    @classmethod
+    def set_length_validator(cls, v: 'Optional[Set[T]]') -> 'Optional[Set[T]]':
+        if v is None:
+            return None
+
+        v = set_validator(v)
+        v_len = len(v)
+
+        if cls.min_items is not None and v_len < cls.min_items:
+            raise errors.SetMinLengthError(limit_value=cls.min_items)
+
+        if cls.max_items is not None and v_len > cls.max_items:
+            raise errors.SetMaxLengthError(limit_value=cls.max_items)
+
+        return v
 
 
-# ~~~~~~~~~~~~~~~~~~~~~~~~~~~ COLLECTION TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-HashableItemType = TypeVar('HashableItemType', bound=Hashable)
+def conset(item_type: Type[T], *, min_items: int = None, max_items: int = None) -> Type[Set[T]]:
+    # __args__ is needed to conform to typing generics api
+    namespace = {'min_items': min_items, 'max_items': max_items, 'item_type': item_type, '__args__': [item_type]}
+    # We use new_class to be able to deal with Generic types
+    return new_class('ConstrainedSetValue', (ConstrainedSet,), {}, lambda ns: ns.update(namespace))
 
 
-def conset(
-    item_type: type[HashableItemType], *, min_length: int | None = None, max_length: int | None = None
-) -> type[set[HashableItemType]]:
-    """A wrapper around `typing.Set` that allows for additional constraints.
+# This types superclass should be FrozenSet[T], but cython chokes on that...
+class ConstrainedFrozenSet(frozenset):  # type: ignore
+    # Needed for pydantic to detect that this is a set
+    __origin__ = frozenset
+    __args__: FrozenSet[Type[T]]  # type: ignore
 
-    Args:
-        item_type: The type of the items in the set.
-        min_length: The minimum length of the set.
-        max_length: The maximum length of the set.
+    min_items: Optional[int] = None
+    max_items: Optional[int] = None
+    item_type: Type[T]  # type: ignore
 
-    Returns:
-        The wrapped set type.
-    """
-    return Annotated[Set[item_type], annotated_types.Len(min_length or 0, max_length)]
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield cls.frozenset_length_validator
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        update_not_none(field_schema, minItems=cls.min_items, maxItems=cls.max_items)
+
+    @classmethod
+    def frozenset_length_validator(cls, v: 'Optional[FrozenSet[T]]') -> 'Optional[FrozenSet[T]]':
+        if v is None:
+            return None
+
+        v = frozenset_validator(v)
+        v_len = len(v)
+
+        if cls.min_items is not None and v_len < cls.min_items:
+            raise errors.FrozenSetMinLengthError(limit_value=cls.min_items)
+
+        if cls.max_items is not None and v_len > cls.max_items:
+            raise errors.FrozenSetMaxLengthError(limit_value=cls.max_items)
+
+        return v
 
 
-def confrozenset(
-    item_type: type[HashableItemType], *, min_length: int | None = None, max_length: int | None = None
-) -> type[frozenset[HashableItemType]]:
-    """A wrapper around `typing.FrozenSet` that allows for additional constraints.
-
-    Args:
-        item_type: The type of the items in the frozenset.
-        min_length: The minimum length of the frozenset.
-        max_length: The maximum length of the frozenset.
-
-    Returns:
-        The wrapped frozenset type.
-    """
-    return Annotated[FrozenSet[item_type], annotated_types.Len(min_length or 0, max_length)]
+def confrozenset(item_type: Type[T], *, min_items: int = None, max_items: int = None) -> Type[FrozenSet[T]]:
+    # __args__ is needed to conform to typing generics api
+    namespace = {'min_items': min_items, 'max_items': max_items, 'item_type': item_type, '__args__': [item_type]}
+    # We use new_class to be able to deal with Generic types
+    return new_class('ConstrainedFrozenSetValue', (ConstrainedFrozenSet,), {}, lambda ns: ns.update(namespace))
 
 
-AnyItemType = TypeVar('AnyItemType')
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ LIST TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+# This types superclass should be List[T], but cython chokes on that...
+class ConstrainedList(list):  # type: ignore
+    # Needed for pydantic to detect that this is a list
+    __origin__ = list
+    __args__: Tuple[Type[T], ...]  # type: ignore
+
+    min_items: Optional[int] = None
+    max_items: Optional[int] = None
+    unique_items: Optional[bool] = None
+    item_type: Type[T]  # type: ignore
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield cls.list_length_validator
+        if cls.unique_items:
+            yield cls.unique_items_validator
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        update_not_none(field_schema, minItems=cls.min_items, maxItems=cls.max_items, uniqueItems=cls.unique_items)
+
+    @classmethod
+    def list_length_validator(cls, v: 'Optional[List[T]]') -> 'Optional[List[T]]':
+        if v is None:
+            return None
+
+        v = list_validator(v)
+        v_len = len(v)
+
+        if cls.min_items is not None and v_len < cls.min_items:
+            raise errors.ListMinLengthError(limit_value=cls.min_items)
+
+        if cls.max_items is not None and v_len > cls.max_items:
+            raise errors.ListMaxLengthError(limit_value=cls.max_items)
+
+        return v
+
+    @classmethod
+    def unique_items_validator(cls, v: 'List[T]') -> 'List[T]':
+        for i, value in enumerate(v, start=1):
+            if value in v[i:]:
+                raise errors.ListUniqueItemsError()
+
+        return v
 
 
 def conlist(
-    item_type: type[AnyItemType],
-    *,
-    min_length: int | None = None,
-    max_length: int | None = None,
-    unique_items: bool | None = None,
-) -> type[list[AnyItemType]]:
-    """A wrapper around typing.List that adds validation.
-
-    Args:
-        item_type: The type of the items in the list.
-        min_length: The minimum length of the list. Defaults to None.
-        max_length: The maximum length of the list. Defaults to None.
-        unique_items: Whether the items in the list must be unique. Defaults to None.
-            !!! warning Deprecated
-                The `unique_items` parameter is deprecated, use `Set` instead.
-                See [this issue](https://github.com/pydantic/pydantic-core/issues/296) for more details.
-
-    Returns:
-        The wrapped list type.
-    """
-    if unique_items is not None:
-        raise PydanticUserError(
-            (
-                '`unique_items` is removed, use `Set` instead'
-                '(this feature is discussed in https://github.com/pydantic/pydantic-core/issues/296)'
-            ),
-            code='removed-kwargs',
-        )
-    return Annotated[List[item_type], annotated_types.Len(min_length or 0, max_length)]
+    item_type: Type[T], *, min_items: int = None, max_items: int = None, unique_items: bool = None
+) -> Type[List[T]]:
+    # __args__ is needed to conform to typing generics api
+    namespace = dict(
+        min_items=min_items, max_items=max_items, unique_items=unique_items, item_type=item_type, __args__=(item_type,)
+    )
+    # We use new_class to be able to deal with Generic types
+    return new_class('ConstrainedListValue', (ConstrainedList,), {}, lambda ns: ns.update(namespace))
 
 
-# ~~~~~~~~~~~~~~~~~~~~~~~~~~ IMPORT STRING TYPE ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ PYOBJECT TYPE ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
 
-AnyType = TypeVar('AnyType')
 if TYPE_CHECKING:
-    ImportString = Annotated[AnyType, ...]
+    PyObject = Callable[..., Any]
 else:
 
-    class ImportString:
-        """A type that can be used to import a type from a string.
-
-        `ImportString` expects a string and loads the Python object importable at that dotted path.
-        Attributes of modules may be separated from the module by `:` or `.`, e.g. if `'math:cos'` was provided,
-        the resulting field value would be the function`cos`. If a `.` is used and both an attribute and submodule
-        are present at the same path, the module will be preferred.
-
-        On model instantiation, pointers will be evaluated and imported. There is
-        some nuance to this behavior, demonstrated in the examples below.
-
-        **Good behavior:**
-        ```py
-        from math import cos
-
-        from pydantic import BaseModel, Field, ImportString, ValidationError
-
-
-        class ImportThings(BaseModel):
-            obj: ImportString
-
-
-        # A string value will cause an automatic import
-        my_cos = ImportThings(obj='math.cos')
-
-        # You can use the imported function as you would expect
-        cos_of_0 = my_cos.obj(0)
-        assert cos_of_0 == 1
-
-
-        # A string whose value cannot be imported will raise an error
-        try:
-            ImportThings(obj='foo.bar')
-        except ValidationError as e:
-            print(e)
-            '''
-            1 validation error for ImportThings
-            obj
-            Invalid python path: No module named 'foo.bar' [type=import_error, input_value='foo.bar', input_type=str]
-            '''
-
-
-        # Actual python objects can be assigned as well
-        my_cos = ImportThings(obj=cos)
-        my_cos_2 = ImportThings(obj='math.cos')
-        my_cos_3 = ImportThings(obj='math:cos')
-        assert my_cos == my_cos_2 == my_cos_3
-
-
-        # You can set default field value either as Python object:
-        class ImportThingsDefaultPyObj(BaseModel):
-            obj: ImportString = math.cos
-
-
-        # or as a string value (but only if used with `validate_default=True`)
-        class ImportThingsDefaultString(BaseModel):
-            obj: ImportString = Field(default='math.cos', validate_default=True)
-
-
-        my_cos_default1 = ImportThingsDefaultPyObj()
-        my_cos_default2 = ImportThingsDefaultString()
-        assert my_cos_default1.obj == my_cos_default2.obj == math.cos
-
-
-        # note: this will not work!
-        class ImportThingsMissingValidateDefault(BaseModel):
-            obj: ImportString = 'math.cos'
-
-        my_cos_default3 = ImportThingsMissingValidateDefault()
-        assert my_cos_default3.obj == 'math.cos'  # just string, not evaluated
-        ```
-
-        Serializing an `ImportString` type to json is also possible.
-
-        ```py
-        from pydantic import BaseModel, ImportString
-
-
-        class ImportThings(BaseModel):
-            obj: ImportString
-
-
-        # Create an instance
-        m = ImportThings(obj='math.cos')
-        print(m)
-        #> obj=<built-in function cos>
-        print(m.model_dump_json())
-        #> {"obj":"math.cos"}
-        ```
-        """
+    class PyObject:
+        validate_always = True
 
         @classmethod
-        def __class_getitem__(cls, item: AnyType) -> AnyType:
-            return Annotated[item, cls()]
+        def __get_validators__(cls) -> 'CallableGenerator':
+            yield cls.validate
 
         @classmethod
-        def __get_pydantic_core_schema__(
-            cls, source: type[Any], handler: GetCoreSchemaHandler
-        ) -> core_schema.CoreSchema:
-            serializer = core_schema.plain_serializer_function_ser_schema(cls._serialize, when_used='json')
-            if cls is source:
-                # Treat bare usage of ImportString (`schema is None`) as the same as ImportString[Any]
-                return core_schema.no_info_plain_validator_function(
-                    function=_validators.import_string, serialization=serializer
-                )
-            else:
-                return core_schema.no_info_before_validator_function(
-                    function=_validators.import_string, schema=handler(source), serialization=serializer
-                )
+        def validate(cls, value: Any) -> Any:
+            if isinstance(value, Callable):
+                return value
 
-        @staticmethod
-        def _serialize(v: Any) -> str:
-            if isinstance(v, ModuleType):
-                return v.__name__
-            elif hasattr(v, '__module__') and hasattr(v, '__name__'):
-                return f'{v.__module__}.{v.__name__}'
-            else:
-                return v
+            try:
+                value = str_validator(value)
+            except errors.StrError:
+                raise errors.PyObjectError(error_message='value is neither a valid import path not a valid callable')
 
-        def __repr__(self) -> str:
-            return 'ImportString'
+            try:
+                return import_string(value)
+            except ImportError as e:
+                raise errors.PyObjectError(error_message=str(e))
 
 
 # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ DECIMAL TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 
+class ConstrainedDecimal(Decimal, metaclass=ConstrainedNumberMeta):
+    gt: OptionalIntFloatDecimal = None
+    ge: OptionalIntFloatDecimal = None
+    lt: OptionalIntFloatDecimal = None
+    le: OptionalIntFloatDecimal = None
+    max_digits: OptionalInt = None
+    decimal_places: OptionalInt = None
+    multiple_of: OptionalIntFloatDecimal = None
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        update_not_none(
+            field_schema,
+            exclusiveMinimum=cls.gt,
+            exclusiveMaximum=cls.lt,
+            minimum=cls.ge,
+            maximum=cls.le,
+            multipleOf=cls.multiple_of,
+        )
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield decimal_validator
+        yield number_size_validator
+        yield number_multiple_validator
+        yield cls.validate
+
+    @classmethod
+    def validate(cls, value: Decimal) -> Decimal:
+        digit_tuple, exponent = value.as_tuple()[1:]
+        if exponent in {'F', 'n', 'N'}:
+            raise errors.DecimalIsNotFiniteError()
+
+        if exponent >= 0:
+            # A positive exponent adds that many trailing zeros.
+            digits = len(digit_tuple) + exponent
+            decimals = 0
+        else:
+            # If the absolute value of the negative exponent is larger than the
+            # number of digits, then it's the same as the number of digits,
+            # because it'll consume all of the digits in digit_tuple and then
+            # add abs(exponent) - len(digit_tuple) leading zeros after the
+            # decimal point.
+            if abs(exponent) > len(digit_tuple):
+                digits = decimals = abs(exponent)
+            else:
+                digits = len(digit_tuple)
+                decimals = abs(exponent)
+        whole_digits = digits - decimals
+
+        if cls.max_digits is not None and digits > cls.max_digits:
+            raise errors.DecimalMaxDigitsError(max_digits=cls.max_digits)
+
+        if cls.decimal_places is not None and decimals > cls.decimal_places:
+            raise errors.DecimalMaxPlacesError(decimal_places=cls.decimal_places)
+
+        if cls.max_digits is not None and cls.decimal_places is not None:
+            expected = cls.max_digits - cls.decimal_places
+            if whole_digits > expected:
+                raise errors.DecimalWholeDigitsError(whole_digits=expected)
+
+        return value
+
+
 def condecimal(
     *,
-    strict: bool | None = None,
-    gt: int | Decimal | None = None,
-    ge: int | Decimal | None = None,
-    lt: int | Decimal | None = None,
-    le: int | Decimal | None = None,
-    multiple_of: int | Decimal | None = None,
-    max_digits: int | None = None,
-    decimal_places: int | None = None,
-    allow_inf_nan: bool | None = None,
-) -> type[Decimal]:
-    """
-    !!! warning "Discouraged"
-        This function is **discouraged** in favor of using
-        [`Annotated`](https://docs.python.org/3/library/typing.html#typing.Annotated) with
-        [`Field`][pydantic.fields.Field] instead.
-
-        This function will be **deprecated** in Pydantic 3.0.
-
-        The reason is that `condecimal` returns a type, which doesn't play well with static analysis tools.
-
-        === ":x: Don't do this"
-            ```py
-            from pydantic import BaseModel, condecimal
-
-            class Foo(BaseModel):
-                bar: condecimal(strict=True, allow_inf_nan=True)
-            ```
-
-        === ":white_check_mark: Do this"
-            ```py
-            from decimal import Decimal
-
-            from typing_extensions import Annotated
-
-            from pydantic import BaseModel, Field
-
-            class Foo(BaseModel):
-                bar: Annotated[Decimal, Field(strict=True, allow_inf_nan=True)]
-            ```
-
-    A wrapper around Decimal that adds validation.
-
-    Args:
-        strict: Whether to validate the value in strict mode. Defaults to `None`.
-        gt: The value must be greater than this. Defaults to `None`.
-        ge: The value must be greater than or equal to this. Defaults to `None`.
-        lt: The value must be less than this. Defaults to `None`.
-        le: The value must be less than or equal to this. Defaults to `None`.
-        multiple_of: The value must be a multiple of this. Defaults to `None`.
-        max_digits: The maximum number of digits. Defaults to `None`.
-        decimal_places: The number of decimal places. Defaults to `None`.
-        allow_inf_nan: Whether to allow infinity and NaN. Defaults to `None`.
-
-    ```py
-    from decimal import Decimal
-
-    from pydantic import BaseModel, ValidationError, condecimal
-
-    class ConstrainedExample(BaseModel):
-        constrained_decimal: condecimal(gt=Decimal('1.0'))
-
-    m = ConstrainedExample(constrained_decimal=Decimal('1.1'))
-    print(repr(m))
-    #> ConstrainedExample(constrained_decimal=Decimal('1.1'))
-
-    try:
-        ConstrainedExample(constrained_decimal=Decimal('0.9'))
-    except ValidationError as e:
-        print(e.errors())
-        '''
-        [
-            {
-                'type': 'greater_than',
-                'loc': ('constrained_decimal',),
-                'msg': 'Input should be greater than 1.0',
-                'input': Decimal('0.9'),
-                'ctx': {'gt': Decimal('1.0')},
-                'url': 'https://errors.pydantic.dev/2/v/greater_than',
-            }
-        ]
-        '''
-    ```
-    """  # noqa: D212
-    return Annotated[
-        Decimal,
-        Strict(strict) if strict is not None else None,
-        annotated_types.Interval(gt=gt, ge=ge, lt=lt, le=le),
-        annotated_types.MultipleOf(multiple_of) if multiple_of is not None else None,
-        _fields.pydantic_general_metadata(max_digits=max_digits, decimal_places=decimal_places),
-        AllowInfNan(allow_inf_nan) if allow_inf_nan is not None else None,
-    ]
+    gt: Decimal = None,
+    ge: Decimal = None,
+    lt: Decimal = None,
+    le: Decimal = None,
+    max_digits: int = None,
+    decimal_places: int = None,
+    multiple_of: Decimal = None,
+) -> Type[Decimal]:
+    # use kwargs then define conf in a dict to aid with IDE type hinting
+    namespace = dict(
+        gt=gt, ge=ge, lt=lt, le=le, max_digits=max_digits, decimal_places=decimal_places, multiple_of=multiple_of
+    )
+    return type('ConstrainedDecimalValue', (ConstrainedDecimal,), namespace)
 
 
 # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ UUID TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
+if TYPE_CHECKING:
+    UUID1 = UUID
+    UUID3 = UUID
+    UUID4 = UUID
+    UUID5 = UUID
+else:
 
-@_dataclasses.dataclass(**_internal_dataclass.slots_true)
-class UuidVersion:
-    """A field metadata class to indicate a [UUID](https://docs.python.org/3/library/uuid.html) version."""
+    class UUID1(UUID):
+        _required_version = 1
 
-    uuid_version: Literal[1, 3, 4, 5]
+        @classmethod
+        def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+            field_schema.update(type='string', format=f'uuid{cls._required_version}')
 
-    def __get_pydantic_json_schema__(
-        self, core_schema: core_schema.CoreSchema, handler: GetJsonSchemaHandler
-    ) -> JsonSchemaValue:
-        field_schema = handler(core_schema)
-        field_schema.pop('anyOf', None)  # remove the bytes/str union
-        field_schema.update(type='string', format=f'uuid{self.uuid_version}')
-        return field_schema
+    class UUID3(UUID1):
+        _required_version = 3
 
-    def __get_pydantic_core_schema__(self, source: Any, handler: GetCoreSchemaHandler) -> core_schema.CoreSchema:
-        if isinstance(self, source):
-            # used directly as a type
-            return core_schema.uuid_schema(version=self.uuid_version)
-        else:
-            # update existing schema with self.uuid_version
-            schema = handler(source)
-            _check_annotated_type(schema['type'], 'uuid', self.__class__.__name__)
-            schema['version'] = self.uuid_version  # type: ignore
-            return schema
+    class UUID4(UUID1):
+        _required_version = 4
 
-    def __hash__(self) -> int:
-        return hash(type(self.uuid_version))
-
-
-UUID1 = Annotated[UUID, UuidVersion(1)]
-"""A [UUID](https://docs.python.org/3/library/uuid.html) that must be version 1.
-
-```py
-import uuid
-
-from pydantic import UUID1, BaseModel
-
-class Model(BaseModel):
-    uuid1: UUID1
-
-Model(uuid1=uuid.uuid1())
-```
-"""
-UUID3 = Annotated[UUID, UuidVersion(3)]
-"""A [UUID](https://docs.python.org/3/library/uuid.html) that must be version 3.
-
-```py
-import uuid
-
-from pydantic import UUID3, BaseModel
-
-class Model(BaseModel):
-    uuid3: UUID3
-
-Model(uuid3=uuid.uuid3(uuid.NAMESPACE_DNS, 'pydantic.org'))
-```
-"""
-UUID4 = Annotated[UUID, UuidVersion(4)]
-"""A [UUID](https://docs.python.org/3/library/uuid.html) that must be version 4.
-
-```py
-import uuid
-
-from pydantic import UUID4, BaseModel
-
-class Model(BaseModel):
-    uuid4: UUID4
-
-Model(uuid4=uuid.uuid4())
-```
-"""
-UUID5 = Annotated[UUID, UuidVersion(5)]
-"""A [UUID](https://docs.python.org/3/library/uuid.html) that must be version 5.
-
-```py
-import uuid
-
-from pydantic import UUID5, BaseModel
-
-class Model(BaseModel):
-    uuid5: UUID5
-
-Model(uuid5=uuid.uuid5(uuid.NAMESPACE_DNS, 'pydantic.org'))
-```
-"""
+    class UUID5(UUID1):
+        _required_version = 5
 
 
 # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ PATH TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
+if TYPE_CHECKING:
+    FilePath = Path
+    DirectoryPath = Path
+else:
 
-@_dataclasses.dataclass
-class PathType:
-    path_type: Literal['file', 'dir', 'new']
+    class FilePath(Path):
+        @classmethod
+        def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+            field_schema.update(format='file-path')
 
-    def __get_pydantic_json_schema__(
-        self, core_schema: core_schema.CoreSchema, handler: GetJsonSchemaHandler
-    ) -> JsonSchemaValue:
-        field_schema = handler(core_schema)
-        format_conversion = {'file': 'file-path', 'dir': 'directory-path'}
-        field_schema.update(format=format_conversion.get(self.path_type, 'path'), type='string')
-        return field_schema
+        @classmethod
+        def __get_validators__(cls) -> 'CallableGenerator':
+            yield path_validator
+            yield path_exists_validator
+            yield cls.validate
 
-    def __get_pydantic_core_schema__(self, source: Any, handler: GetCoreSchemaHandler) -> core_schema.CoreSchema:
-        function_lookup = {
-            'file': cast(core_schema.WithInfoValidatorFunction, self.validate_file),
-            'dir': cast(core_schema.WithInfoValidatorFunction, self.validate_directory),
-            'new': cast(core_schema.WithInfoValidatorFunction, self.validate_new),
-        }
+        @classmethod
+        def validate(cls, value: Path) -> Path:
+            if not value.is_file():
+                raise errors.PathNotAFileError(path=value)
 
-        return core_schema.with_info_after_validator_function(
-            function_lookup[self.path_type],
-            handler(source),
-        )
+            return value
 
-    @staticmethod
-    def validate_file(path: Path, _: core_schema.ValidationInfo) -> Path:
-        if path.is_file():
-            return path
-        else:
-            raise PydanticCustomError('path_not_file', 'Path does not point to a file')
+    class DirectoryPath(Path):
+        @classmethod
+        def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+            field_schema.update(format='directory-path')
 
-    @staticmethod
-    def validate_directory(path: Path, _: core_schema.ValidationInfo) -> Path:
-        if path.is_dir():
-            return path
-        else:
-            raise PydanticCustomError('path_not_directory', 'Path does not point to a directory')
+        @classmethod
+        def __get_validators__(cls) -> 'CallableGenerator':
+            yield path_validator
+            yield path_exists_validator
+            yield cls.validate
 
-    @staticmethod
-    def validate_new(path: Path, _: core_schema.ValidationInfo) -> Path:
-        if path.exists():
-            raise PydanticCustomError('path_exists', 'Path already exists')
-        elif not path.parent.exists():
-            raise PydanticCustomError('parent_does_not_exist', 'Parent directory does not exist')
-        else:
-            return path
+        @classmethod
+        def validate(cls, value: Path) -> Path:
+            if not value.is_dir():
+                raise errors.PathNotADirectoryError(path=value)
 
-    def __hash__(self) -> int:
-        return hash(type(self.path_type))
-
-
-FilePath = Annotated[Path, PathType('file')]
-"""A path that must point to a file.
-
-```py
-from pathlib import Path
-
-from pydantic import BaseModel, FilePath, ValidationError
-
-class Model(BaseModel):
-    f: FilePath
-
-path = Path('text.txt')
-path.touch()
-m = Model(f='text.txt')
-print(m.model_dump())
-#> {'f': PosixPath('text.txt')}
-path.unlink()
-
-path = Path('directory')
-path.mkdir(exist_ok=True)
-try:
-    Model(f='directory')  # directory
-except ValidationError as e:
-    print(e)
-    '''
-    1 validation error for Model
-    f
-      Path does not point to a file [type=path_not_file, input_value='directory', input_type=str]
-    '''
-path.rmdir()
-
-try:
-    Model(f='not-exists-file')
-except ValidationError as e:
-    print(e)
-    '''
-    1 validation error for Model
-    f
-      Path does not point to a file [type=path_not_file, input_value='not-exists-file', input_type=str]
-    '''
-```
-"""
-DirectoryPath = Annotated[Path, PathType('dir')]
-"""A path that must point to a directory.
-
-```py
-from pathlib import Path
-
-from pydantic import BaseModel, DirectoryPath, ValidationError
-
-class Model(BaseModel):
-    f: DirectoryPath
-
-path = Path('directory/')
-path.mkdir()
-m = Model(f='directory/')
-print(m.model_dump())
-#> {'f': PosixPath('directory')}
-path.rmdir()
-
-path = Path('file.txt')
-path.touch()
-try:
-    Model(f='file.txt')  # file
-except ValidationError as e:
-    print(e)
-    '''
-    1 validation error for Model
-    f
-      Path does not point to a directory [type=path_not_directory, input_value='file.txt', input_type=str]
-    '''
-path.unlink()
-
-try:
-    Model(f='not-exists-directory')
-except ValidationError as e:
-    print(e)
-    '''
-    1 validation error for Model
-    f
-      Path does not point to a directory [type=path_not_directory, input_value='not-exists-directory', input_type=str]
-    '''
-```
-"""
-NewPath = Annotated[Path, PathType('new')]
-"""A path for a new file or directory that must not already exist."""
+            return value
 
 
 # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ JSON TYPE ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
+
+class JsonWrapper:
+    pass
+
+
+class JsonMeta(type):
+    def __getitem__(self, t: Type[Any]) -> Type[JsonWrapper]:
+        if t is Any:
+            return Json  # allow Json[Any] to replecate plain Json
+        return _registered(type('JsonWrapperValue', (JsonWrapper,), {'inner_type': t}))
+
+
 if TYPE_CHECKING:
-    Json = Annotated[AnyType, ...]  # Json[list[str]] will be recognized by type checkers as list[str]
+    Json = Annotated[T, ...]  # Json[list[str]] will be recognized by type checkers as list[str]
 
 else:
 
-    class Json:
-        """A special type wrapper which loads JSON before parsing.
-
-        You can use the `Json` data type to make Pydantic first load a raw JSON string before
-        validating the loaded data into the parametrized type:
-
-        ```py
-        from typing import Any, List
-
-        from pydantic import BaseModel, Json, ValidationError
-
-
-        class AnyJsonModel(BaseModel):
-            json_obj: Json[Any]
-
-
-        class ConstrainedJsonModel(BaseModel):
-            json_obj: Json[List[int]]
-
-
-        print(AnyJsonModel(json_obj='{"b": 1}'))
-        #> json_obj={'b': 1}
-        print(ConstrainedJsonModel(json_obj='[1, 2, 3]'))
-        #> json_obj=[1, 2, 3]
-
-        try:
-            ConstrainedJsonModel(json_obj=12)
-        except ValidationError as e:
-            print(e)
-            '''
-            1 validation error for ConstrainedJsonModel
-            json_obj
-            JSON input should be string, bytes or bytearray [type=json_type, input_value=12, input_type=int]
-            '''
-
-        try:
-            ConstrainedJsonModel(json_obj='[a, b]')
-        except ValidationError as e:
-            print(e)
-            '''
-            1 validation error for ConstrainedJsonModel
-            json_obj
-            Invalid JSON: expected value at line 1 column 2 [type=json_invalid, input_value='[a, b]', input_type=str]
-            '''
-
-        try:
-            ConstrainedJsonModel(json_obj='["a", "b"]')
-        except ValidationError as e:
-            print(e)
-            '''
-            2 validation errors for ConstrainedJsonModel
-            json_obj.0
-            Input should be a valid integer, unable to parse string as an integer [type=int_parsing, input_value='a', input_type=str]
-            json_obj.1
-            Input should be a valid integer, unable to parse string as an integer [type=int_parsing, input_value='b', input_type=str]
-            '''
-        ```
-
-        When you dump the model using `model_dump` or `model_dump_json`, the dumped value will be the result of validation,
-        not the original JSON string. However, you can use the argument `round_trip=True` to get the original JSON string back:
-
-        ```py
-        from typing import List
-
-        from pydantic import BaseModel, Json
-
-
-        class ConstrainedJsonModel(BaseModel):
-            json_obj: Json[List[int]]
-
-
-        print(ConstrainedJsonModel(json_obj='[1, 2, 3]').model_dump_json())
-        #> {"json_obj":[1,2,3]}
-        print(
-            ConstrainedJsonModel(json_obj='[1, 2, 3]').model_dump_json(round_trip=True)
-        )
-        #> {"json_obj":"[1,2,3]"}
-        ```
-        """
-
+    class Json(metaclass=JsonMeta):
         @classmethod
-        def __class_getitem__(cls, item: AnyType) -> AnyType:
-            return Annotated[item, cls()]
-
-        @classmethod
-        def __get_pydantic_core_schema__(cls, source: Any, handler: GetCoreSchemaHandler) -> core_schema.CoreSchema:
-            if cls is source:
-                return core_schema.json_schema(None)
-            else:
-                return core_schema.json_schema(handler(source))
-
-        def __repr__(self) -> str:
-            return 'Json'
-
-        def __hash__(self) -> int:
-            return hash(type(self))
-
-        def __eq__(self, other: Any) -> bool:
-            return type(other) == type(self)
+        def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+            field_schema.update(type='string', format='json-string')
 
 
 # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ SECRET TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-SecretType = TypeVar('SecretType', str, bytes)
 
+class SecretField(abc.ABC):
+    """
+    Note: this should be implemented as a generic like `SecretField(ABC, Generic[T])`,
+          the `__init__()` should be part of the abstract class and the
+          `get_secret_value()` method should use the generic `T` type.
 
-class _SecretField(Generic[SecretType]):
-    def __init__(self, secret_value: SecretType) -> None:
-        self._secret_value: SecretType = secret_value
-
-    def get_secret_value(self) -> SecretType:
-        """Get the secret value.
-
-        Returns:
-            The secret value.
-        """
-        return self._secret_value
+          However Cython doesn't support very well generics at the moment and
+          the generated code fails to be imported (see
+          https://github.com/cython/cython/issues/2753).
+    """
 
     def __eq__(self, other: Any) -> bool:
         return isinstance(other, self.__class__) and self.get_secret_value() == other.get_secret_value()
 
+    def __str__(self) -> str:
+        return '**********' if self.get_secret_value() else ''
+
     def __hash__(self) -> int:
         return hash(self.get_secret_value())
 
+    @abc.abstractmethod
+    def get_secret_value(self) -> Any:  # pragma: no cover
+        ...
+
+
+class SecretStr(SecretField):
+    min_length: OptionalInt = None
+    max_length: OptionalInt = None
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        update_not_none(
+            field_schema,
+            type='string',
+            writeOnly=True,
+            format='password',
+            minLength=cls.min_length,
+            maxLength=cls.max_length,
+        )
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield cls.validate
+        yield constr_length_validator
+
+    @classmethod
+    def validate(cls, value: Any) -> 'SecretStr':
+        if isinstance(value, cls):
+            return value
+        value = str_validator(value)
+        return cls(value)
+
+    def __init__(self, value: str):
+        self._secret_value = value
+
+    def __repr__(self) -> str:
+        return f"SecretStr('{self}')"
+
     def __len__(self) -> int:
         return len(self._secret_value)
 
-    def __str__(self) -> str:
-        return str(self._display())
+    def display(self) -> str:
+        warnings.warn('`secret_str.display()` is deprecated, use `str(secret_str)` instead', DeprecationWarning)
+        return str(self)
 
-    def __repr__(self) -> str:
-        return f'{self.__class__.__name__}({self._display()!r})'
+    def get_secret_value(self) -> str:
+        return self._secret_value
 
-    def _display(self) -> SecretType:
-        raise NotImplementedError
+
+class SecretBytes(SecretField):
+    min_length: OptionalInt = None
+    max_length: OptionalInt = None
 
     @classmethod
-    def __get_pydantic_core_schema__(cls, source: type[Any], handler: GetCoreSchemaHandler) -> core_schema.CoreSchema:
-        if issubclass(source, SecretStr):
-            field_type = str
-            inner_schema = core_schema.str_schema()
-        else:
-            assert issubclass(source, SecretBytes)
-            field_type = bytes
-            inner_schema = core_schema.bytes_schema()
-        error_kind = 'string_type' if field_type is str else 'bytes_type'
-
-        def serialize(
-            value: _SecretField[SecretType], info: core_schema.SerializationInfo
-        ) -> str | _SecretField[SecretType]:
-            if info.mode == 'json':
-                # we want the output to always be string without the `b'` prefix for bytes,
-                # hence we just use `secret_display`
-                return _secret_display(value.get_secret_value())
-            else:
-                return value
-
-        def get_json_schema(_core_schema: core_schema.CoreSchema, handler: GetJsonSchemaHandler) -> JsonSchemaValue:
-            json_schema = handler(inner_schema)
-            _utils.update_not_none(
-                json_schema,
-                type='string',
-                writeOnly=True,
-                format='password',
-            )
-            return json_schema
-
-        json_schema = core_schema.no_info_after_validator_function(
-            source,  # construct the type
-            inner_schema,
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        update_not_none(
+            field_schema,
+            type='string',
+            writeOnly=True,
+            format='password',
+            minLength=cls.min_length,
+            maxLength=cls.max_length,
         )
-        s = core_schema.json_or_python_schema(
-            python_schema=core_schema.union_schema(
-                [
-                    core_schema.is_instance_schema(source),
-                    json_schema,
-                ],
-                strict=True,
-                custom_error_type=error_kind,
-            ),
-            json_schema=json_schema,
-            serialization=core_schema.plain_serializer_function_ser_schema(
-                serialize,
-                info_arg=True,
-                return_schema=core_schema.str_schema(),
-                when_used='json',
-            ),
-        )
-        s.setdefault('metadata', {}).setdefault('pydantic_js_functions', []).append(get_json_schema)
-        return s
 
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield cls.validate
+        yield constr_length_validator
 
-def _secret_display(value: str | bytes) -> str:
-    return '**********' if value else ''
+    @classmethod
+    def validate(cls, value: Any) -> 'SecretBytes':
+        if isinstance(value, cls):
+            return value
+        value = bytes_validator(value)
+        return cls(value)
 
+    def __init__(self, value: bytes):
+        self._secret_value = value
 
-class SecretStr(_SecretField[str]):
-    """A string used for storing sensitive information that you do not want to be visible in logging or tracebacks.
+    def __repr__(self) -> str:
+        return f"SecretBytes(b'{self}')"
 
-    When the secret value is nonempty, it is displayed as `'**********'` instead of the underlying value in
-    calls to `repr()` and `str()`. If the value _is_ empty, it is displayed as `''`.
+    def __len__(self) -> int:
+        return len(self._secret_value)
 
-    ```py
-    from pydantic import BaseModel, SecretStr
+    def display(self) -> str:
+        warnings.warn('`secret_bytes.display()` is deprecated, use `str(secret_bytes)` instead', DeprecationWarning)
+        return str(self)
 
-    class User(BaseModel):
-        username: str
-        password: SecretStr
-
-    user = User(username='scolvin', password='password1')
-
-    print(user)
-    #> username='scolvin' password=SecretStr('**********')
-    print(user.password.get_secret_value())
-    #> password1
-    print((SecretStr('password'), SecretStr('')))
-    #> (SecretStr('**********'), SecretStr(''))
-    ```
-    """
-
-    def _display(self) -> str:
-        return _secret_display(self.get_secret_value())
-
-
-class SecretBytes(_SecretField[bytes]):
-    """A bytes used for storing sensitive information that you do not want to be visible in logging or tracebacks.
-
-    It displays `b'**********'` instead of the string value on `repr()` and `str()` calls.
-    When the secret value is nonempty, it is displayed as `b'**********'` instead of the underlying value in
-    calls to `repr()` and `str()`. If the value _is_ empty, it is displayed as `b''`.
-
-    ```py
-    from pydantic import BaseModel, SecretBytes
-
-    class User(BaseModel):
-        username: str
-        password: SecretBytes
-
-    user = User(username='scolvin', password=b'password1')
-    #> username='scolvin' password=SecretBytes(b'**********')
-    print(user.password.get_secret_value())
-    #> b'password1'
-    print((SecretBytes(b'password'), SecretBytes(b'')))
-    #> (SecretBytes(b'**********'), SecretBytes(b''))
-    ```
-    """
-
-    def _display(self) -> bytes:
-        return _secret_display(self.get_secret_value()).encode()
+    def get_secret_value(self) -> bytes:
+        return self._secret_value
 
 
 # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ PAYMENT CARD TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 
 class PaymentCardBrand(str, Enum):
+    # If you add another card type, please also add it to the
+    # Hypothesis strategy in `pydantic._hypothesis_plugin`.
     amex = 'American Express'
     mastercard = 'Mastercard'
     visa = 'Visa'
@@ -1600,13 +954,10 @@ class PaymentCardBrand(str, Enum):
         return self.value
 
 
-@deprecated(
-    'The `PaymentCardNumber` class is deprecated, use `pydantic_extra_types` instead. '
-    'See https://docs.pydantic.dev/latest/api/pydantic_extra_types_payment/#pydantic_extra_types.payment.PaymentCardNumber.',
-    category=PydanticDeprecatedSince20,
-)
 class PaymentCardNumber(str):
-    """Based on: https://en.wikipedia.org/wiki/Payment_card_number."""
+    """
+    Based on: https://en.wikipedia.org/wiki/Payment_card_number
+    """
 
     strip_whitespace: ClassVar[bool] = True
     min_length: ClassVar[int] = 12
@@ -1616,47 +967,36 @@ class PaymentCardNumber(str):
     brand: PaymentCardBrand
 
     def __init__(self, card_number: str):
-        self.validate_digits(card_number)
-
-        card_number = self.validate_luhn_check_digit(card_number)
-
         self.bin = card_number[:6]
         self.last4 = card_number[-4:]
-        self.brand = self.validate_brand(card_number)
+        self.brand = self._get_brand(card_number)
 
     @classmethod
-    def __get_pydantic_core_schema__(cls, source: type[Any], handler: GetCoreSchemaHandler) -> core_schema.CoreSchema:
-        return core_schema.with_info_after_validator_function(
-            cls.validate,
-            core_schema.str_schema(
-                min_length=cls.min_length, max_length=cls.max_length, strip_whitespace=cls.strip_whitespace
-            ),
-        )
-
-    @classmethod
-    def validate(cls, __input_value: str, _: core_schema.ValidationInfo) -> PaymentCardNumber:
-        """Validate the card number and return a `PaymentCardNumber` instance."""
-        return cls(__input_value)
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield str_validator
+        yield constr_strip_whitespace
+        yield constr_length_validator
+        yield cls.validate_digits
+        yield cls.validate_luhn_check_digit
+        yield cls
+        yield cls.validate_length_for_brand
 
     @property
     def masked(self) -> str:
-        """Mask all but the last 4 digits of the card number.
-
-        Returns:
-            A masked card number string.
-        """
         num_masked = len(self) - 10  # len(bin) + len(last4) == 10
         return f'{self.bin}{"*" * num_masked}{self.last4}'
 
     @classmethod
-    def validate_digits(cls, card_number: str) -> None:
-        """Validate that the card number is all digits."""
+    def validate_digits(cls, card_number: str) -> str:
         if not card_number.isdigit():
-            raise PydanticCustomError('payment_card_number_digits', 'Card number is not all digits')
+            raise errors.NotDigitError
+        return card_number
 
     @classmethod
     def validate_luhn_check_digit(cls, card_number: str) -> str:
-        """Based on: https://en.wikipedia.org/wiki/Luhn_algorithm."""
+        """
+        Based on: https://en.wikipedia.org/wiki/Luhn_algorithm
+        """
         sum_ = int(card_number[-1])
         length = len(card_number)
         parity = length % 2
@@ -1669,14 +1009,33 @@ class PaymentCardNumber(str):
             sum_ += digit
         valid = sum_ % 10 == 0
         if not valid:
-            raise PydanticCustomError('payment_card_number_luhn', 'Card number is not luhn valid')
+            raise errors.LuhnValidationError
+        return card_number
+
+    @classmethod
+    def validate_length_for_brand(cls, card_number: 'PaymentCardNumber') -> 'PaymentCardNumber':
+        """
+        Validate length based on BIN for major brands:
+        https://en.wikipedia.org/wiki/Payment_card_number#Issuer_identification_number_(IIN)
+        """
+        required_length: Union[None, int, str] = None
+        if card_number.brand in PaymentCardBrand.mastercard:
+            required_length = 16
+            valid = len(card_number) == required_length
+        elif card_number.brand == PaymentCardBrand.visa:
+            required_length = '13, 16 or 19'
+            valid = len(card_number) in {13, 16, 19}
+        elif card_number.brand == PaymentCardBrand.amex:
+            required_length = 15
+            valid = len(card_number) == required_length
+        else:
+            valid = True
+        if not valid:
+            raise errors.InvalidLengthForBrand(brand=card_number.brand, required_length=required_length)
         return card_number
 
     @staticmethod
-    def validate_brand(card_number: str) -> PaymentCardBrand:
-        """Validate length based on BIN for major brands:
-        https://en.wikipedia.org/wiki/Payment_card_number#Issuer_identification_number_(IIN).
-        """
+    def _get_brand(card_number: str) -> PaymentCardBrand:
         if card_number[0] == '4':
             brand = PaymentCardBrand.visa
         elif 51 <= int(card_number[:2]) <= 55:
@@ -1685,1195 +1044,144 @@ class PaymentCardNumber(str):
             brand = PaymentCardBrand.amex
         else:
             brand = PaymentCardBrand.other
-
-        required_length: None | int | str = None
-        if brand in PaymentCardBrand.mastercard:
-            required_length = 16
-            valid = len(card_number) == required_length
-        elif brand == PaymentCardBrand.visa:
-            required_length = '13, 16 or 19'
-            valid = len(card_number) in {13, 16, 19}
-        elif brand == PaymentCardBrand.amex:
-            required_length = 15
-            valid = len(card_number) == required_length
-        else:
-            valid = True
-
-        if not valid:
-            raise PydanticCustomError(
-                'payment_card_number_brand',
-                'Length for a {brand} card must be {required_length}',
-                {'brand': brand, 'required_length': required_length},
-            )
         return brand
 
 
 # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ BYTE SIZE TYPE ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
+BYTE_SIZES = {
+    'b': 1,
+    'kb': 10**3,
+    'mb': 10**6,
+    'gb': 10**9,
+    'tb': 10**12,
+    'pb': 10**15,
+    'eb': 10**18,
+    'kib': 2**10,
+    'mib': 2**20,
+    'gib': 2**30,
+    'tib': 2**40,
+    'pib': 2**50,
+    'eib': 2**60,
+}
+BYTE_SIZES.update({k.lower()[0]: v for k, v in BYTE_SIZES.items() if 'i' not in k})
+byte_string_re = re.compile(r'^\s*(\d*\.?\d+)\s*(\w+)?', re.IGNORECASE)
+
 
 class ByteSize(int):
-    """Converts a string representing a number of bytes with units (such as `'1KB'` or `'11.5MiB'`) into an integer.
-
-    You can use the `ByteSize` data type to (case-insensitively) convert a string representation of a number of bytes into
-    an integer, and also to print out human-readable strings representing a number of bytes.
-
-    In conformance with [IEC 80000-13 Standard](https://en.wikipedia.org/wiki/ISO/IEC_80000) we interpret `'1KB'` to mean 1000 bytes,
-    and `'1KiB'` to mean 1024 bytes. In general, including a middle `'i'` will cause the unit to be interpreted as a power of 2,
-    rather than a power of 10 (so, for example, `'1 MB'` is treated as `1_000_000` bytes, whereas `'1 MiB'` is treated as `1_048_576` bytes).
-
-    !!! info
-        Note that `1b` will be parsed as "1 byte" and not "1 bit".
-
-    ```py
-    from pydantic import BaseModel, ByteSize
-
-    class MyModel(BaseModel):
-        size: ByteSize
-
-    print(MyModel(size=52000).size)
-    #> 52000
-    print(MyModel(size='3000 KiB').size)
-    #> 3072000
-
-    m = MyModel(size='50 PB')
-    print(m.size.human_readable())
-    #> 44.4PiB
-    print(m.size.human_readable(decimal=True))
-    #> 50.0PB
-
-    print(m.size.to('TiB'))
-    #> 45474.73508864641
-    ```
-    """
-
-    byte_sizes = {
-        'b': 1,
-        'kb': 10**3,
-        'mb': 10**6,
-        'gb': 10**9,
-        'tb': 10**12,
-        'pb': 10**15,
-        'eb': 10**18,
-        'kib': 2**10,
-        'mib': 2**20,
-        'gib': 2**30,
-        'tib': 2**40,
-        'pib': 2**50,
-        'eib': 2**60,
-        'bit': 1 / 8,
-        'kbit': 10**3 / 8,
-        'mbit': 10**6 / 8,
-        'gbit': 10**9 / 8,
-        'tbit': 10**12 / 8,
-        'pbit': 10**15 / 8,
-        'ebit': 10**18 / 8,
-        'kibit': 2**10 / 8,
-        'mibit': 2**20 / 8,
-        'gibit': 2**30 / 8,
-        'tibit': 2**40 / 8,
-        'pibit': 2**50 / 8,
-        'eibit': 2**60 / 8,
-    }
-    byte_sizes.update({k.lower()[0]: v for k, v in byte_sizes.items() if 'i' not in k})
-
-    byte_string_pattern = r'^\s*(\d*\.?\d+)\s*(\w+)?'
-    byte_string_re = re.compile(byte_string_pattern, re.IGNORECASE)
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield cls.validate
 
     @classmethod
-    def __get_pydantic_core_schema__(cls, source: type[Any], handler: GetCoreSchemaHandler) -> core_schema.CoreSchema:
-        return core_schema.with_info_after_validator_function(
-            function=cls._validate,
-            schema=core_schema.union_schema(
-                [
-                    core_schema.str_schema(pattern=cls.byte_string_pattern),
-                    core_schema.int_schema(ge=0),
-                ],
-                custom_error_type='byte_size',
-                custom_error_message='could not parse value and unit from byte string',
-            ),
-            serialization=core_schema.plain_serializer_function_ser_schema(
-                int, return_schema=core_schema.int_schema(ge=0)
-            ),
-        )
+    def validate(cls, v: StrIntFloat) -> 'ByteSize':
 
-    @classmethod
-    def _validate(cls, __input_value: Any, _: core_schema.ValidationInfo) -> ByteSize:
         try:
-            return cls(int(__input_value))
+            return cls(int(v))
         except ValueError:
             pass
 
-        str_match = cls.byte_string_re.match(str(__input_value))
+        str_match = byte_string_re.match(str(v))
         if str_match is None:
-            raise PydanticCustomError('byte_size', 'could not parse value and unit from byte string')
+            raise errors.InvalidByteSize()
 
         scalar, unit = str_match.groups()
         if unit is None:
             unit = 'b'
 
         try:
-            unit_mult = cls.byte_sizes[unit.lower()]
+            unit_mult = BYTE_SIZES[unit.lower()]
         except KeyError:
-            raise PydanticCustomError('byte_size_unit', 'could not interpret byte unit: {unit}', {'unit': unit})
+            raise errors.InvalidByteSizeUnit(unit=unit)
 
         return cls(int(float(scalar) * unit_mult))
 
     def human_readable(self, decimal: bool = False) -> str:
-        """Converts a byte size to a human readable string.
 
-        Args:
-            decimal: If True, use decimal units (e.g. 1000 bytes per KB). If False, use binary units
-                (e.g. 1024 bytes per KiB).
-
-        Returns:
-            A human readable string representation of the byte size.
-        """
         if decimal:
             divisor = 1000
-            units = 'B', 'KB', 'MB', 'GB', 'TB', 'PB'
+            units = ['B', 'KB', 'MB', 'GB', 'TB', 'PB']
             final_unit = 'EB'
         else:
             divisor = 1024
-            units = 'B', 'KiB', 'MiB', 'GiB', 'TiB', 'PiB'
+            units = ['B', 'KiB', 'MiB', 'GiB', 'TiB', 'PiB']
             final_unit = 'EiB'
 
         num = float(self)
         for unit in units:
             if abs(num) < divisor:
-                if unit == 'B':
-                    return f'{num:0.0f}{unit}'
-                else:
-                    return f'{num:0.1f}{unit}'
+                return f'{num:0.1f}{unit}'
             num /= divisor
 
         return f'{num:0.1f}{final_unit}'
 
     def to(self, unit: str) -> float:
-        """Converts a byte size to another unit, including both byte and bit units.
 
-        Args:
-            unit: The unit to convert to. Must be one of the following: B, KB, MB, GB, TB, PB, EB,
-                KiB, MiB, GiB, TiB, PiB, EiB (byte units) and
-                bit, kbit, mbit, gbit, tbit, pbit, ebit,
-                kibit, mibit, gibit, tibit, pibit, eibit (bit units).
-
-        Returns:
-            The byte size in the new unit.
-        """
         try:
-            unit_div = self.byte_sizes[unit.lower()]
+            unit_div = BYTE_SIZES[unit.lower()]
         except KeyError:
-            raise PydanticCustomError('byte_size_unit', 'Could not interpret byte unit: {unit}', {'unit': unit})
+            raise errors.InvalidByteSizeUnit(unit=unit)
 
         return self / unit_div
 
 
 # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ DATE TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-
-def _check_annotated_type(annotated_type: str, expected_type: str, annotation: str) -> None:
-    if annotated_type != expected_type:
-        raise PydanticUserError(f"'{annotation}' cannot annotate '{annotated_type}'.", code='invalid_annotated_type')
-
-
 if TYPE_CHECKING:
-    PastDate = Annotated[date, ...]
-    FutureDate = Annotated[date, ...]
+    PastDate = date
+    FutureDate = date
 else:
 
-    class PastDate:
-        """A date in the past."""
+    class PastDate(date):
+        @classmethod
+        def __get_validators__(cls) -> 'CallableGenerator':
+            yield parse_date
+            yield cls.validate
 
         @classmethod
-        def __get_pydantic_core_schema__(
-            cls, source: type[Any], handler: GetCoreSchemaHandler
-        ) -> core_schema.CoreSchema:
-            if cls is source:
-                # used directly as a type
-                return core_schema.date_schema(now_op='past')
-            else:
-                schema = handler(source)
-                _check_annotated_type(schema['type'], 'date', cls.__name__)
-                schema['now_op'] = 'past'
-                return schema
+        def validate(cls, value: date) -> date:
+            if value >= date.today():
+                raise errors.DateNotInThePastError()
 
-        def __repr__(self) -> str:
-            return 'PastDate'
+            return value
 
-    class FutureDate:
-        """A date in the future."""
+    class FutureDate(date):
+        @classmethod
+        def __get_validators__(cls) -> 'CallableGenerator':
+            yield parse_date
+            yield cls.validate
 
         @classmethod
-        def __get_pydantic_core_schema__(
-            cls, source: type[Any], handler: GetCoreSchemaHandler
-        ) -> core_schema.CoreSchema:
-            if cls is source:
-                # used directly as a type
-                return core_schema.date_schema(now_op='future')
-            else:
-                schema = handler(source)
-                _check_annotated_type(schema['type'], 'date', cls.__name__)
-                schema['now_op'] = 'future'
-                return schema
+        def validate(cls, value: date) -> date:
+            if value <= date.today():
+                raise errors.DateNotInTheFutureError()
 
-        def __repr__(self) -> str:
-            return 'FutureDate'
+            return value
+
+
+class ConstrainedDate(date, metaclass=ConstrainedNumberMeta):
+    gt: OptionalDate = None
+    ge: OptionalDate = None
+    lt: OptionalDate = None
+    le: OptionalDate = None
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        update_not_none(field_schema, exclusiveMinimum=cls.gt, exclusiveMaximum=cls.lt, minimum=cls.ge, maximum=cls.le)
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield parse_date
+        yield number_size_validator
 
 
 def condate(
     *,
-    strict: bool | None = None,
-    gt: date | None = None,
-    ge: date | None = None,
-    lt: date | None = None,
-    le: date | None = None,
-) -> type[date]:
-    """A wrapper for date that adds constraints.
-
-    Args:
-        strict: Whether to validate the date value in strict mode. Defaults to `None`.
-        gt: The value must be greater than this. Defaults to `None`.
-        ge: The value must be greater than or equal to this. Defaults to `None`.
-        lt: The value must be less than this. Defaults to `None`.
-        le: The value must be less than or equal to this. Defaults to `None`.
-
-    Returns:
-        A date type with the specified constraints.
-    """
-    return Annotated[
-        date,
-        Strict(strict) if strict is not None else None,
-        annotated_types.Interval(gt=gt, ge=ge, lt=lt, le=le),
-    ]
-
-
-# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ DATETIME TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-if TYPE_CHECKING:
-    AwareDatetime = Annotated[datetime, ...]
-    NaiveDatetime = Annotated[datetime, ...]
-    PastDatetime = Annotated[datetime, ...]
-    FutureDatetime = Annotated[datetime, ...]
-
-else:
-
-    class AwareDatetime:
-        """A datetime that requires timezone info."""
-
-        @classmethod
-        def __get_pydantic_core_schema__(
-            cls, source: type[Any], handler: GetCoreSchemaHandler
-        ) -> core_schema.CoreSchema:
-            if cls is source:
-                # used directly as a type
-                return core_schema.datetime_schema(tz_constraint='aware')
-            else:
-                schema = handler(source)
-                _check_annotated_type(schema['type'], 'datetime', cls.__name__)
-                schema['tz_constraint'] = 'aware'
-                return schema
-
-        def __repr__(self) -> str:
-            return 'AwareDatetime'
-
-    class NaiveDatetime:
-        """A datetime that doesn't require timezone info."""
-
-        @classmethod
-        def __get_pydantic_core_schema__(
-            cls, source: type[Any], handler: GetCoreSchemaHandler
-        ) -> core_schema.CoreSchema:
-            if cls is source:
-                # used directly as a type
-                return core_schema.datetime_schema(tz_constraint='naive')
-            else:
-                schema = handler(source)
-                _check_annotated_type(schema['type'], 'datetime', cls.__name__)
-                schema['tz_constraint'] = 'naive'
-                return schema
-
-        def __repr__(self) -> str:
-            return 'NaiveDatetime'
-
-    class PastDatetime:
-        """A datetime that must be in the past."""
-
-        @classmethod
-        def __get_pydantic_core_schema__(
-            cls, source: type[Any], handler: GetCoreSchemaHandler
-        ) -> core_schema.CoreSchema:
-            if cls is source:
-                # used directly as a type
-                return core_schema.datetime_schema(now_op='past')
-            else:
-                schema = handler(source)
-                _check_annotated_type(schema['type'], 'datetime', cls.__name__)
-                schema['now_op'] = 'past'
-                return schema
-
-        def __repr__(self) -> str:
-            return 'PastDatetime'
-
-    class FutureDatetime:
-        """A datetime that must be in the future."""
-
-        @classmethod
-        def __get_pydantic_core_schema__(
-            cls, source: type[Any], handler: GetCoreSchemaHandler
-        ) -> core_schema.CoreSchema:
-            if cls is source:
-                # used directly as a type
-                return core_schema.datetime_schema(now_op='future')
-            else:
-                schema = handler(source)
-                _check_annotated_type(schema['type'], 'datetime', cls.__name__)
-                schema['now_op'] = 'future'
-                return schema
-
-        def __repr__(self) -> str:
-            return 'FutureDatetime'
-
-
-# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Encoded TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-
-class EncoderProtocol(Protocol):
-    """Protocol for encoding and decoding data to and from bytes."""
-
-    @classmethod
-    def decode(cls, data: bytes) -> bytes:
-        """Decode the data using the encoder.
-
-        Args:
-            data: The data to decode.
-
-        Returns:
-            The decoded data.
-        """
-        ...
-
-    @classmethod
-    def encode(cls, value: bytes) -> bytes:
-        """Encode the data using the encoder.
-
-        Args:
-            value: The data to encode.
-
-        Returns:
-            The encoded data.
-        """
-        ...
-
-    @classmethod
-    def get_json_format(cls) -> str:
-        """Get the JSON format for the encoded data.
-
-        Returns:
-            The JSON format for the encoded data.
-        """
-        ...
-
-
-class Base64Encoder(EncoderProtocol):
-    """Standard (non-URL-safe) Base64 encoder."""
-
-    @classmethod
-    def decode(cls, data: bytes) -> bytes:
-        """Decode the data from base64 encoded bytes to original bytes data.
-
-        Args:
-            data: The data to decode.
-
-        Returns:
-            The decoded data.
-        """
-        try:
-            return base64.decodebytes(data)
-        except ValueError as e:
-            raise PydanticCustomError('base64_decode', "Base64 decoding error: '{error}'", {'error': str(e)})
-
-    @classmethod
-    def encode(cls, value: bytes) -> bytes:
-        """Encode the data from bytes to a base64 encoded bytes.
-
-        Args:
-            value: The data to encode.
-
-        Returns:
-            The encoded data.
-        """
-        return base64.encodebytes(value)
-
-    @classmethod
-    def get_json_format(cls) -> Literal['base64']:
-        """Get the JSON format for the encoded data.
-
-        Returns:
-            The JSON format for the encoded data.
-        """
-        return 'base64'
-
-
-class Base64UrlEncoder(EncoderProtocol):
-    """URL-safe Base64 encoder."""
-
-    @classmethod
-    def decode(cls, data: bytes) -> bytes:
-        """Decode the data from base64 encoded bytes to original bytes data.
-
-        Args:
-            data: The data to decode.
-
-        Returns:
-            The decoded data.
-        """
-        try:
-            return base64.urlsafe_b64decode(data)
-        except ValueError as e:
-            raise PydanticCustomError('base64_decode', "Base64 decoding error: '{error}'", {'error': str(e)})
-
-    @classmethod
-    def encode(cls, value: bytes) -> bytes:
-        """Encode the data from bytes to a base64 encoded bytes.
-
-        Args:
-            value: The data to encode.
-
-        Returns:
-            The encoded data.
-        """
-        return base64.urlsafe_b64encode(value)
-
-    @classmethod
-    def get_json_format(cls) -> Literal['base64url']:
-        """Get the JSON format for the encoded data.
-
-        Returns:
-            The JSON format for the encoded data.
-        """
-        return 'base64url'
-
-
-@_dataclasses.dataclass(**_internal_dataclass.slots_true)
-class EncodedBytes:
-    """A bytes type that is encoded and decoded using the specified encoder.
-
-    `EncodedBytes` needs an encoder that implements `EncoderProtocol` to operate.
-
-    ```py
-    from typing_extensions import Annotated
-
-    from pydantic import BaseModel, EncodedBytes, EncoderProtocol, ValidationError
-
-    class MyEncoder(EncoderProtocol):
-        @classmethod
-        def decode(cls, data: bytes) -> bytes:
-            if data == b'**undecodable**':
-                raise ValueError('Cannot decode data')
-            return data[13:]
-
-        @classmethod
-        def encode(cls, value: bytes) -> bytes:
-            return b'**encoded**: ' + value
-
-        @classmethod
-        def get_json_format(cls) -> str:
-            return 'my-encoder'
-
-    MyEncodedBytes = Annotated[bytes, EncodedBytes(encoder=MyEncoder)]
-
-    class Model(BaseModel):
-        my_encoded_bytes: MyEncodedBytes
-
-    # Initialize the model with encoded data
-    m = Model(my_encoded_bytes=b'**encoded**: some bytes')
-
-    # Access decoded value
-    print(m.my_encoded_bytes)
-    #> b'some bytes'
-
-    # Serialize into the encoded form
-    print(m.model_dump())
-    #> {'my_encoded_bytes': b'**encoded**: some bytes'}
-
-    # Validate encoded data
-    try:
-        Model(my_encoded_bytes=b'**undecodable**')
-    except ValidationError as e:
-        print(e)
-        '''
-        1 validation error for Model
-        my_encoded_bytes
-          Value error, Cannot decode data [type=value_error, input_value=b'**undecodable**', input_type=bytes]
-        '''
-    ```
-    """
-
-    encoder: type[EncoderProtocol]
-
-    def __get_pydantic_json_schema__(
-        self, core_schema: core_schema.CoreSchema, handler: GetJsonSchemaHandler
-    ) -> JsonSchemaValue:
-        field_schema = handler(core_schema)
-        field_schema.update(type='string', format=self.encoder.get_json_format())
-        return field_schema
-
-    def __get_pydantic_core_schema__(self, source: type[Any], handler: GetCoreSchemaHandler) -> core_schema.CoreSchema:
-        return core_schema.with_info_after_validator_function(
-            function=self.decode,
-            schema=core_schema.bytes_schema(),
-            serialization=core_schema.plain_serializer_function_ser_schema(function=self.encode),
-        )
-
-    def decode(self, data: bytes, _: core_schema.ValidationInfo) -> bytes:
-        """Decode the data using the specified encoder.
-
-        Args:
-            data: The data to decode.
-
-        Returns:
-            The decoded data.
-        """
-        return self.encoder.decode(data)
-
-    def encode(self, value: bytes) -> bytes:
-        """Encode the data using the specified encoder.
-
-        Args:
-            value: The data to encode.
-
-        Returns:
-            The encoded data.
-        """
-        return self.encoder.encode(value)
-
-    def __hash__(self) -> int:
-        return hash(self.encoder)
-
-
-@_dataclasses.dataclass(**_internal_dataclass.slots_true)
-class EncodedStr(EncodedBytes):
-    """A str type that is encoded and decoded using the specified encoder.
-
-    `EncodedStr` needs an encoder that implements `EncoderProtocol` to operate.
-
-    ```py
-    from typing_extensions import Annotated
-
-    from pydantic import BaseModel, EncodedStr, EncoderProtocol, ValidationError
-
-    class MyEncoder(EncoderProtocol):
-        @classmethod
-        def decode(cls, data: bytes) -> bytes:
-            if data == b'**undecodable**':
-                raise ValueError('Cannot decode data')
-            return data[13:]
-
-        @classmethod
-        def encode(cls, value: bytes) -> bytes:
-            return b'**encoded**: ' + value
-
-        @classmethod
-        def get_json_format(cls) -> str:
-            return 'my-encoder'
-
-    MyEncodedStr = Annotated[str, EncodedStr(encoder=MyEncoder)]
-
-    class Model(BaseModel):
-        my_encoded_str: MyEncodedStr
-
-    # Initialize the model with encoded data
-    m = Model(my_encoded_str='**encoded**: some str')
-
-    # Access decoded value
-    print(m.my_encoded_str)
-    #> some str
-
-    # Serialize into the encoded form
-    print(m.model_dump())
-    #> {'my_encoded_str': '**encoded**: some str'}
-
-    # Validate encoded data
-    try:
-        Model(my_encoded_str='**undecodable**')
-    except ValidationError as e:
-        print(e)
-        '''
-        1 validation error for Model
-        my_encoded_str
-          Value error, Cannot decode data [type=value_error, input_value='**undecodable**', input_type=str]
-        '''
-    ```
-    """
-
-    def __get_pydantic_core_schema__(self, source: type[Any], handler: GetCoreSchemaHandler) -> core_schema.CoreSchema:
-        return core_schema.with_info_after_validator_function(
-            function=self.decode_str,
-            schema=super(EncodedStr, self).__get_pydantic_core_schema__(source=source, handler=handler),  # noqa: UP008
-            serialization=core_schema.plain_serializer_function_ser_schema(function=self.encode_str),
-        )
-
-    def decode_str(self, data: bytes, _: core_schema.ValidationInfo) -> str:
-        """Decode the data using the specified encoder.
-
-        Args:
-            data: The data to decode.
-
-        Returns:
-            The decoded data.
-        """
-        return data.decode()
-
-    def encode_str(self, value: str) -> str:
-        """Encode the data using the specified encoder.
-
-        Args:
-            value: The data to encode.
-
-        Returns:
-            The encoded data.
-        """
-        return super(EncodedStr, self).encode(value=value.encode()).decode()  # noqa: UP008
-
-    def __hash__(self) -> int:
-        return hash(self.encoder)
-
-
-Base64Bytes = Annotated[bytes, EncodedBytes(encoder=Base64Encoder)]
-"""A bytes type that is encoded and decoded using the standard (non-URL-safe) base64 encoder.
-
-Note:
-    Under the hood, `Base64Bytes` use standard library `base64.encodebytes` and `base64.decodebytes` functions.
-
-    As a result, attempting to decode url-safe base64 data using the `Base64Bytes` type may fail or produce an incorrect
-    decoding.
-
-```py
-from pydantic import Base64Bytes, BaseModel, ValidationError
-
-class Model(BaseModel):
-    base64_bytes: Base64Bytes
-
-# Initialize the model with base64 data
-m = Model(base64_bytes=b'VGhpcyBpcyB0aGUgd2F5')
-
-# Access decoded value
-print(m.base64_bytes)
-#> b'This is the way'
-
-# Serialize into the base64 form
-print(m.model_dump())
-#> {'base64_bytes': b'VGhpcyBpcyB0aGUgd2F5\n'}
-
-# Validate base64 data
-try:
-    print(Model(base64_bytes=b'undecodable').base64_bytes)
-except ValidationError as e:
-    print(e)
-    '''
-    1 validation error for Model
-    base64_bytes
-      Base64 decoding error: 'Incorrect padding' [type=base64_decode, input_value=b'undecodable', input_type=bytes]
-    '''
-```
-"""
-Base64Str = Annotated[str, EncodedStr(encoder=Base64Encoder)]
-"""A str type that is encoded and decoded using the standard (non-URL-safe) base64 encoder.
-
-Note:
-    Under the hood, `Base64Bytes` use standard library `base64.encodebytes` and `base64.decodebytes` functions.
-
-    As a result, attempting to decode url-safe base64 data using the `Base64Str` type may fail or produce an incorrect
-    decoding.
-
-```py
-from pydantic import Base64Str, BaseModel, ValidationError
-
-class Model(BaseModel):
-    base64_str: Base64Str
-
-# Initialize the model with base64 data
-m = Model(base64_str='VGhlc2UgYXJlbid0IHRoZSBkcm9pZHMgeW91J3JlIGxvb2tpbmcgZm9y')
-
-# Access decoded value
-print(m.base64_str)
-#> These aren't the droids you're looking for
-
-# Serialize into the base64 form
-print(m.model_dump())
-#> {'base64_str': 'VGhlc2UgYXJlbid0IHRoZSBkcm9pZHMgeW91J3JlIGxvb2tpbmcgZm9y\n'}
-
-# Validate base64 data
-try:
-    print(Model(base64_str='undecodable').base64_str)
-except ValidationError as e:
-    print(e)
-    '''
-    1 validation error for Model
-    base64_str
-      Base64 decoding error: 'Incorrect padding' [type=base64_decode, input_value='undecodable', input_type=str]
-    '''
-```
-"""
-Base64UrlBytes = Annotated[bytes, EncodedBytes(encoder=Base64UrlEncoder)]
-"""A bytes type that is encoded and decoded using the URL-safe base64 encoder.
-
-Note:
-    Under the hood, `Base64UrlBytes` use standard library `base64.urlsafe_b64encode` and `base64.urlsafe_b64decode`
-    functions.
-
-    As a result, the `Base64UrlBytes` type can be used to faithfully decode "vanilla" base64 data
-    (using `'+'` and `'/'`).
-
-```py
-from pydantic import Base64UrlBytes, BaseModel
-
-class Model(BaseModel):
-    base64url_bytes: Base64UrlBytes
-
-# Initialize the model with base64 data
-m = Model(base64url_bytes=b'SHc_dHc-TXc==')
-print(m)
-#> base64url_bytes=b'Hw?tw>Mw'
-```
-"""
-Base64UrlStr = Annotated[str, EncodedStr(encoder=Base64UrlEncoder)]
-"""A str type that is encoded and decoded using the URL-safe base64 encoder.
-
-Note:
-    Under the hood, `Base64UrlStr` use standard library `base64.urlsafe_b64encode` and `base64.urlsafe_b64decode`
-    functions.
-
-    As a result, the `Base64UrlStr` type can be used to faithfully decode "vanilla" base64 data (using `'+'` and `'/'`).
-
-```py
-from pydantic import Base64UrlStr, BaseModel
-
-class Model(BaseModel):
-    base64url_str: Base64UrlStr
-
-# Initialize the model with base64 data
-m = Model(base64url_str='SHc_dHc-TXc==')
-print(m)
-#> base64url_str='Hw?tw>Mw'
-```
-"""
-
-
-__getattr__ = getattr_migration(__name__)
-
-
-@_dataclasses.dataclass(**_internal_dataclass.slots_true)
-class GetPydanticSchema:
-    """Usage docs: https://docs.pydantic.dev/2.6/concepts/types/#using-getpydanticschema-to-reduce-boilerplate
-
-    A convenience class for creating an annotation that provides pydantic custom type hooks.
-
-    This class is intended to eliminate the need to create a custom "marker" which defines the
-     `__get_pydantic_core_schema__` and `__get_pydantic_json_schema__` custom hook methods.
-
-    For example, to have a field treated by type checkers as `int`, but by pydantic as `Any`, you can do:
-    ```python
-    from typing import Any
-
-    from typing_extensions import Annotated
-
-    from pydantic import BaseModel, GetPydanticSchema
-
-    HandleAsAny = GetPydanticSchema(lambda _s, h: h(Any))
-
-    class Model(BaseModel):
-        x: Annotated[int, HandleAsAny]  # pydantic sees `x: Any`
-
-    print(repr(Model(x='abc').x))
-    #> 'abc'
-    ```
-    """
-
-    get_pydantic_core_schema: Callable[[Any, GetCoreSchemaHandler], CoreSchema] | None = None
-    get_pydantic_json_schema: Callable[[Any, GetJsonSchemaHandler], JsonSchemaValue] | None = None
-
-    # Note: we may want to consider adding a convenience staticmethod `def for_type(type_: Any) -> GetPydanticSchema:`
-    #   which returns `GetPydanticSchema(lambda _s, h: h(type_))`
-
-    if not TYPE_CHECKING:
-        # We put `__getattr__` in a non-TYPE_CHECKING block because otherwise, mypy allows arbitrary attribute access
-
-        def __getattr__(self, item: str) -> Any:
-            """Use this rather than defining `__get_pydantic_core_schema__` etc. to reduce the number of nested calls."""
-            if item == '__get_pydantic_core_schema__' and self.get_pydantic_core_schema:
-                return self.get_pydantic_core_schema
-            elif item == '__get_pydantic_json_schema__' and self.get_pydantic_json_schema:
-                return self.get_pydantic_json_schema
-            else:
-                return object.__getattribute__(self, item)
-
-    __hash__ = object.__hash__
-
-
-@_dataclasses.dataclass(**_internal_dataclass.slots_true, frozen=True)
-class Tag:
-    """Provides a way to specify the expected tag to use for a case of a (callable) discriminated union.
-
-    Also provides a way to label a union case in error messages.
-
-    When using a callable `Discriminator`, attach a `Tag` to each case in the `Union` to specify the tag that
-    should be used to identify that case. For example, in the below example, the `Tag` is used to specify that
-    if `get_discriminator_value` returns `'apple'`, the input should be validated as an `ApplePie`, and if it
-    returns `'pumpkin'`, the input should be validated as a `PumpkinPie`.
-
-    The primary role of the `Tag` here is to map the return value from the callable `Discriminator` function to
-    the appropriate member of the `Union` in question.
-
-    ```py
-    from typing import Any, Union
-
-    from typing_extensions import Annotated, Literal
-
-    from pydantic import BaseModel, Discriminator, Tag
-
-    class Pie(BaseModel):
-        time_to_cook: int
-        num_ingredients: int
-
-    class ApplePie(Pie):
-        fruit: Literal['apple'] = 'apple'
-
-    class PumpkinPie(Pie):
-        filling: Literal['pumpkin'] = 'pumpkin'
-
-    def get_discriminator_value(v: Any) -> str:
-        if isinstance(v, dict):
-            return v.get('fruit', v.get('filling'))
-        return getattr(v, 'fruit', getattr(v, 'filling', None))
-
-    class ThanksgivingDinner(BaseModel):
-        dessert: Annotated[
-            Union[
-                Annotated[ApplePie, Tag('apple')],
-                Annotated[PumpkinPie, Tag('pumpkin')],
-            ],
-            Discriminator(get_discriminator_value),
-        ]
-
-    apple_variation = ThanksgivingDinner.model_validate(
-        {'dessert': {'fruit': 'apple', 'time_to_cook': 60, 'num_ingredients': 8}}
-    )
-    print(repr(apple_variation))
-    '''
-    ThanksgivingDinner(dessert=ApplePie(time_to_cook=60, num_ingredients=8, fruit='apple'))
-    '''
-
-    pumpkin_variation = ThanksgivingDinner.model_validate(
-        {
-            'dessert': {
-                'filling': 'pumpkin',
-                'time_to_cook': 40,
-                'num_ingredients': 6,
-            }
-        }
-    )
-    print(repr(pumpkin_variation))
-    '''
-    ThanksgivingDinner(dessert=PumpkinPie(time_to_cook=40, num_ingredients=6, filling='pumpkin'))
-    '''
-    ```
-
-    !!! note
-        You must specify a `Tag` for every case in a `Tag` that is associated with a
-        callable `Discriminator`. Failing to do so will result in a `PydanticUserError` with code
-        [`callable-discriminator-no-tag`](../errors/usage_errors.md#callable-discriminator-no-tag).
-
-    See the [Discriminated Unions] concepts docs for more details on how to use `Tag`s.
-
-    [Discriminated Unions]: ../concepts/unions.md#discriminated-unions
-    """
-
-    tag: str
-
-    def __get_pydantic_core_schema__(self, source_type: Any, handler: GetCoreSchemaHandler) -> CoreSchema:
-        schema = handler(source_type)
-        metadata = schema.setdefault('metadata', {})
-        assert isinstance(metadata, dict)
-        metadata[_core_utils.TAGGED_UNION_TAG_KEY] = self.tag
-        return schema
-
-
-@_dataclasses.dataclass(**_internal_dataclass.slots_true, frozen=True)
-class Discriminator:
-    """Usage docs: https://docs.pydantic.dev/2.6/concepts/unions/#discriminated-unions-with-callable-discriminator
-
-    Provides a way to use a custom callable as the way to extract the value of a union discriminator.
-
-    This allows you to get validation behavior like you'd get from `Field(discriminator=<field_name>)`,
-    but without needing to have a single shared field across all the union choices. This also makes it
-    possible to handle unions of models and primitive types with discriminated-union-style validation errors.
-    Finally, this allows you to use a custom callable as the way to identify which member of a union a value
-    belongs to, while still seeing all the performance benefits of a discriminated union.
-
-    Consider this example, which is much more performant with the use of `Discriminator` and thus a `TaggedUnion`
-    than it would be as a normal `Union`.
-
-    ```py
-    from typing import Any, Union
-
-    from typing_extensions import Annotated, Literal
-
-    from pydantic import BaseModel, Discriminator, Tag
-
-    class Pie(BaseModel):
-        time_to_cook: int
-        num_ingredients: int
-
-    class ApplePie(Pie):
-        fruit: Literal['apple'] = 'apple'
-
-    class PumpkinPie(Pie):
-        filling: Literal['pumpkin'] = 'pumpkin'
-
-    def get_discriminator_value(v: Any) -> str:
-        if isinstance(v, dict):
-            return v.get('fruit', v.get('filling'))
-        return getattr(v, 'fruit', getattr(v, 'filling', None))
-
-    class ThanksgivingDinner(BaseModel):
-        dessert: Annotated[
-            Union[
-                Annotated[ApplePie, Tag('apple')],
-                Annotated[PumpkinPie, Tag('pumpkin')],
-            ],
-            Discriminator(get_discriminator_value),
-        ]
-
-    apple_variation = ThanksgivingDinner.model_validate(
-        {'dessert': {'fruit': 'apple', 'time_to_cook': 60, 'num_ingredients': 8}}
-    )
-    print(repr(apple_variation))
-    '''
-    ThanksgivingDinner(dessert=ApplePie(time_to_cook=60, num_ingredients=8, fruit='apple'))
-    '''
-
-    pumpkin_variation = ThanksgivingDinner.model_validate(
-        {
-            'dessert': {
-                'filling': 'pumpkin',
-                'time_to_cook': 40,
-                'num_ingredients': 6,
-            }
-        }
-    )
-    print(repr(pumpkin_variation))
-    '''
-    ThanksgivingDinner(dessert=PumpkinPie(time_to_cook=40, num_ingredients=6, filling='pumpkin'))
-    '''
-    ```
-
-    See the [Discriminated Unions] concepts docs for more details on how to use `Discriminator`s.
-
-    [Discriminated Unions]: ../concepts/unions.md#discriminated-unions
-    """
-
-    discriminator: str | Callable[[Any], Hashable]
-    """The callable or field name for discriminating the type in a tagged union.
-
-    A `Callable` discriminator must extract the value of the discriminator from the input.
-    A `str` discriminator must be the name of a field to discriminate against.
-    """
-    custom_error_type: str | None = None
-    """Type to use in [custom errors](../errors/errors.md#custom-errors) replacing the standard discriminated union
-    validation errors.
-    """
-    custom_error_message: str | None = None
-    """Message to use in custom errors."""
-    custom_error_context: dict[str, int | str | float] | None = None
-    """Context to use in custom errors."""
-
-    def __get_pydantic_core_schema__(self, source_type: Any, handler: GetCoreSchemaHandler) -> CoreSchema:
-        origin = _typing_extra.get_origin(source_type)
-        if not origin or not _typing_extra.origin_is_union(origin):
-            raise TypeError(f'{type(self).__name__} must be used with a Union type, not {source_type}')
-
-        if isinstance(self.discriminator, str):
-            from pydantic import Field
-
-            return handler(Annotated[source_type, Field(discriminator=self.discriminator)])
-        else:
-            original_schema = handler(source_type)
-            return self._convert_schema(original_schema)
-
-    def _convert_schema(self, original_schema: core_schema.CoreSchema) -> core_schema.TaggedUnionSchema:
-        if original_schema['type'] != 'union':
-            # This likely indicates that the schema was a single-item union that was simplified.
-            # In this case, we do the same thing we do in
-            # `pydantic._internal._discriminated_union._ApplyInferredDiscriminator._apply_to_root`, namely,
-            # package the generated schema back into a single-item union.
-            original_schema = core_schema.union_schema([original_schema])
-
-        tagged_union_choices = {}
-        for i, choice in enumerate(original_schema['choices']):
-            tag = None
-            if isinstance(choice, tuple):
-                choice, tag = choice
-            metadata = choice.get('metadata')
-            if metadata is not None:
-                metadata_tag = metadata.get(_core_utils.TAGGED_UNION_TAG_KEY)
-                if metadata_tag is not None:
-                    tag = metadata_tag
-            if tag is None:
-                raise PydanticUserError(
-                    f'`Tag` not provided for choice {choice} used with `Discriminator`',
-                    code='callable-discriminator-no-tag',
-                )
-            tagged_union_choices[tag] = choice
-
-        # Have to do these verbose checks to ensure falsy values ('' and {}) don't get ignored
-        custom_error_type = self.custom_error_type
-        if custom_error_type is None:
-            custom_error_type = original_schema.get('custom_error_type')
-
-        custom_error_message = self.custom_error_message
-        if custom_error_message is None:
-            custom_error_message = original_schema.get('custom_error_message')
-
-        custom_error_context = self.custom_error_context
-        if custom_error_context is None:
-            custom_error_context = original_schema.get('custom_error_context')
-
-        custom_error_type = original_schema.get('custom_error_type') if custom_error_type is None else custom_error_type
-        return core_schema.tagged_union_schema(
-            tagged_union_choices,
-            self.discriminator,
-            custom_error_type=custom_error_type,
-            custom_error_message=custom_error_message,
-            custom_error_context=custom_error_context,
-            strict=original_schema.get('strict'),
-            ref=original_schema.get('ref'),
-            metadata=original_schema.get('metadata'),
-            serialization=original_schema.get('serialization'),
-        )
-
-
-_JSON_TYPES = {int, float, str, bool, list, dict, type(None)}
-
-
-def _get_type_name(x: Any) -> str:
-    type_ = type(x)
-    if type_ in _JSON_TYPES:
-        return type_.__name__
-
-    # Handle proper subclasses; note we don't need to handle None or bool here
-    if isinstance(x, int):
-        return 'int'
-    if isinstance(x, float):
-        return 'float'
-    if isinstance(x, str):
-        return 'str'
-    if isinstance(x, list):
-        return 'list'
-    if isinstance(x, dict):
-        return 'dict'
-
-    # Fail by returning the type's actual name
-    return getattr(type_, '__name__', '<no type name>')
-
-
-class _AllowAnyJson:
-    @classmethod
-    def __get_pydantic_core_schema__(cls, source_type: Any, handler: GetCoreSchemaHandler) -> CoreSchema:
-        python_schema = handler(source_type)
-        return core_schema.json_or_python_schema(json_schema=core_schema.any_schema(), python_schema=python_schema)
-
-
-if TYPE_CHECKING:
-    # This seems to only be necessary for mypy
-    JsonValue: TypeAlias = Union[
-        List['JsonValue'],
-        Dict[str, 'JsonValue'],
-        str,
-        bool,
-        int,
-        float,
-        None,
-    ]
-    """A `JsonValue` is used to represent a value that can be serialized to JSON.
-
-    It may be one of:
-
-    * `List['JsonValue']`
-    * `Dict[str, 'JsonValue']`
-    * `str`
-    * `bool`
-    * `int`
-    * `float`
-    * `None`
-
-    The following example demonstrates how to use `JsonValue` to validate JSON data,
-    and what kind of errors to expect when input data is not json serializable.
-
-    ```py
-    import json
-
-    from pydantic import BaseModel, JsonValue, ValidationError
-
-    class Model(BaseModel):
-        j: JsonValue
-
-    valid_json_data = {'j': {'a': {'b': {'c': 1, 'd': [2, None]}}}}
-    invalid_json_data = {'j': {'a': {'b': ...}}}
-
-    print(repr(Model.model_validate(valid_json_data)))
-    #> Model(j={'a': {'b': {'c': 1, 'd': [2, None]}}})
-    print(repr(Model.model_validate_json(json.dumps(valid_json_data))))
-    #> Model(j={'a': {'b': {'c': 1, 'd': [2, None]}}})
-
-    try:
-        Model.model_validate(invalid_json_data)
-    except ValidationError as e:
-        print(e)
-        '''
-        1 validation error for Model
-        j.dict.a.dict.b
-          input was not a valid JSON value [type=invalid-json-value, input_value=Ellipsis, input_type=ellipsis]
-        '''
-    ```
-    """
-
-else:
-    JsonValue = TypeAliasType(
-        'JsonValue',
-        Annotated[
-            Union[
-                Annotated[List['JsonValue'], Tag('list')],
-                Annotated[Dict[str, 'JsonValue'], Tag('dict')],
-                Annotated[str, Tag('str')],
-                Annotated[bool, Tag('bool')],
-                Annotated[int, Tag('int')],
-                Annotated[float, Tag('float')],
-                Annotated[None, Tag('NoneType')],
-            ],
-            Discriminator(
-                _get_type_name,
-                custom_error_type='invalid-json-value',
-                custom_error_message='input was not a valid JSON value',
-            ),
-            _AllowAnyJson,
-        ],
-    )
-
-
-class _OnErrorOmit:
-    @classmethod
-    def __get_pydantic_core_schema__(cls, source_type: Any, handler: GetCoreSchemaHandler) -> CoreSchema:
-        # there is no actual default value here but we use with_default_schema since it already has the on_error
-        # behavior implemented and it would be no more efficient to implement it on every other validator
-        # or as a standalone validator
-        return core_schema.with_default_schema(schema=handler(source_type), on_error='omit')
-
-
-OnErrorOmit = Annotated[T, _OnErrorOmit]
-"""
-When used as an item in a list, the key type in a dict, optional values of a TypedDict, etc.
-this annotation omits the item from the iteration if there is any error validating it.
-That is, instead of a [`ValidationError`][pydantic_core.ValidationError] being propagated up and the entire iterable being discarded
-any invalid items are discarded and the valid ones are returned.
-"""
+    gt: date = None,
+    ge: date = None,
+    lt: date = None,
+    le: date = None,
+) -> Type[date]:
+    # use kwargs then define conf in a dict to aid with IDE type hinting
+    namespace = dict(gt=gt, ge=ge, lt=lt, le=le)
+    return type('ConstrainedDateValue', (ConstrainedDate,), namespace)
diff --git a/lib/pydantic/typing.py b/lib/pydantic/typing.py
index f1b32ba2..5ccf266c 100644
--- a/lib/pydantic/typing.py
+++ b/lib/pydantic/typing.py
@@ -1,4 +1,602 @@
-"""`typing` module is a backport module from V1."""
-from ._migration import getattr_migration
+import sys
+from collections.abc import Callable
+from os import PathLike
+from typing import (  # type: ignore
+    TYPE_CHECKING,
+    AbstractSet,
+    Any,
+    Callable as TypingCallable,
+    ClassVar,
+    Dict,
+    ForwardRef,
+    Generator,
+    Iterable,
+    List,
+    Mapping,
+    NewType,
+    Optional,
+    Sequence,
+    Set,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+    _eval_type,
+    cast,
+    get_type_hints,
+)
 
-__getattr__ = getattr_migration(__name__)
+from typing_extensions import (
+    Annotated,
+    Final,
+    Literal,
+    NotRequired as TypedDictNotRequired,
+    Required as TypedDictRequired,
+)
+
+try:
+    from typing import _TypingBase as typing_base  # type: ignore
+except ImportError:
+    from typing import _Final as typing_base  # type: ignore
+
+try:
+    from typing import GenericAlias as TypingGenericAlias  # type: ignore
+except ImportError:
+    # python < 3.9 does not have GenericAlias (list[int], tuple[str, ...] and so on)
+    TypingGenericAlias = ()
+
+try:
+    from types import UnionType as TypesUnionType  # type: ignore
+except ImportError:
+    # python < 3.10 does not have UnionType (str | int, byte | bool and so on)
+    TypesUnionType = ()
+
+
+if sys.version_info < (3, 9):
+
+    def evaluate_forwardref(type_: ForwardRef, globalns: Any, localns: Any) -> Any:
+        return type_._evaluate(globalns, localns)
+
+else:
+
+    def evaluate_forwardref(type_: ForwardRef, globalns: Any, localns: Any) -> Any:
+        # Even though it is the right signature for python 3.9, mypy complains with
+        # `error: Too many arguments for "_evaluate" of "ForwardRef"` hence the cast...
+        return cast(Any, type_)._evaluate(globalns, localns, set())
+
+
+if sys.version_info < (3, 9):
+    # Ensure we always get all the whole `Annotated` hint, not just the annotated type.
+    # For 3.7 to 3.8, `get_type_hints` doesn't recognize `typing_extensions.Annotated`,
+    # so it already returns the full annotation
+    get_all_type_hints = get_type_hints
+
+else:
+
+    def get_all_type_hints(obj: Any, globalns: Any = None, localns: Any = None) -> Any:
+        return get_type_hints(obj, globalns, localns, include_extras=True)
+
+
+_T = TypeVar('_T')
+
+AnyCallable = TypingCallable[..., Any]
+NoArgAnyCallable = TypingCallable[[], Any]
+
+# workaround for https://github.com/python/mypy/issues/9496
+AnyArgTCallable = TypingCallable[..., _T]
+
+
+# Annotated[...] is implemented by returning an instance of one of these classes, depending on
+# python/typing_extensions version.
+AnnotatedTypeNames = {'AnnotatedMeta', '_AnnotatedAlias'}
+
+
+if sys.version_info < (3, 8):
+
+    def get_origin(t: Type[Any]) -> Optional[Type[Any]]:
+        if type(t).__name__ in AnnotatedTypeNames:
+            # weirdly this is a runtime requirement, as well as for mypy
+            return cast(Type[Any], Annotated)
+        return getattr(t, '__origin__', None)
+
+else:
+    from typing import get_origin as _typing_get_origin
+
+    def get_origin(tp: Type[Any]) -> Optional[Type[Any]]:
+        """
+        We can't directly use `typing.get_origin` since we need a fallback to support
+        custom generic classes like `ConstrainedList`
+        It should be useless once https://github.com/cython/cython/issues/3537 is
+        solved and https://github.com/pydantic/pydantic/pull/1753 is merged.
+        """
+        if type(tp).__name__ in AnnotatedTypeNames:
+            return cast(Type[Any], Annotated)  # mypy complains about _SpecialForm
+        return _typing_get_origin(tp) or getattr(tp, '__origin__', None)
+
+
+if sys.version_info < (3, 8):
+    from typing import _GenericAlias
+
+    def get_args(t: Type[Any]) -> Tuple[Any, ...]:
+        """Compatibility version of get_args for python 3.7.
+
+        Mostly compatible with the python 3.8 `typing` module version
+        and able to handle almost all use cases.
+        """
+        if type(t).__name__ in AnnotatedTypeNames:
+            return t.__args__ + t.__metadata__
+        if isinstance(t, _GenericAlias):
+            res = t.__args__
+            if t.__origin__ is Callable and res and res[0] is not Ellipsis:
+                res = (list(res[:-1]), res[-1])
+            return res
+        return getattr(t, '__args__', ())
+
+else:
+    from typing import get_args as _typing_get_args
+
+    def _generic_get_args(tp: Type[Any]) -> Tuple[Any, ...]:
+        """
+        In python 3.9, `typing.Dict`, `typing.List`, ...
+        do have an empty `__args__` by default (instead of the generic ~T for example).
+        In order to still support `Dict` for example and consider it as `Dict[Any, Any]`,
+        we retrieve the `_nparams` value that tells us how many parameters it needs.
+        """
+        if hasattr(tp, '_nparams'):
+            return (Any,) * tp._nparams
+        # Special case for `tuple[()]`, which used to return ((),) with `typing.Tuple`
+        # in python 3.10- but now returns () for `tuple` and `Tuple`.
+        # This will probably be clarified in pydantic v2
+        try:
+            if tp == Tuple[()] or sys.version_info >= (3, 9) and tp == tuple[()]:  # type: ignore[misc]
+                return ((),)
+        # there is a TypeError when compiled with cython
+        except TypeError:  # pragma: no cover
+            pass
+        return ()
+
+    def get_args(tp: Type[Any]) -> Tuple[Any, ...]:
+        """Get type arguments with all substitutions performed.
+
+        For unions, basic simplifications used by Union constructor are performed.
+        Examples::
+            get_args(Dict[str, int]) == (str, int)
+            get_args(int) == ()
+            get_args(Union[int, Union[T, int], str][int]) == (int, str)
+            get_args(Union[int, Tuple[T, int]][str]) == (int, Tuple[str, int])
+            get_args(Callable[[], T][int]) == ([], int)
+        """
+        if type(tp).__name__ in AnnotatedTypeNames:
+            return tp.__args__ + tp.__metadata__
+        # the fallback is needed for the same reasons as `get_origin` (see above)
+        return _typing_get_args(tp) or getattr(tp, '__args__', ()) or _generic_get_args(tp)
+
+
+if sys.version_info < (3, 9):
+
+    def convert_generics(tp: Type[Any]) -> Type[Any]:
+        """Python 3.9 and older only supports generics from `typing` module.
+        They convert strings to ForwardRef automatically.
+
+        Examples::
+            typing.List['Hero'] == typing.List[ForwardRef('Hero')]
+        """
+        return tp
+
+else:
+    from typing import _UnionGenericAlias  # type: ignore
+
+    from typing_extensions import _AnnotatedAlias
+
+    def convert_generics(tp: Type[Any]) -> Type[Any]:
+        """
+        Recursively searches for `str` type hints and replaces them with ForwardRef.
+
+        Examples::
+            convert_generics(list['Hero']) == list[ForwardRef('Hero')]
+            convert_generics(dict['Hero', 'Team']) == dict[ForwardRef('Hero'), ForwardRef('Team')]
+            convert_generics(typing.Dict['Hero', 'Team']) == typing.Dict[ForwardRef('Hero'), ForwardRef('Team')]
+            convert_generics(list[str | 'Hero'] | int) == list[str | ForwardRef('Hero')] | int
+        """
+        origin = get_origin(tp)
+        if not origin or not hasattr(tp, '__args__'):
+            return tp
+
+        args = get_args(tp)
+
+        # typing.Annotated needs special treatment
+        if origin is Annotated:
+            return _AnnotatedAlias(convert_generics(args[0]), args[1:])
+
+        # recursively replace `str` instances inside of `GenericAlias` with `ForwardRef(arg)`
+        converted = tuple(
+            ForwardRef(arg) if isinstance(arg, str) and isinstance(tp, TypingGenericAlias) else convert_generics(arg)
+            for arg in args
+        )
+
+        if converted == args:
+            return tp
+        elif isinstance(tp, TypingGenericAlias):
+            return TypingGenericAlias(origin, converted)
+        elif isinstance(tp, TypesUnionType):
+            # recreate types.UnionType (PEP604, Python >= 3.10)
+            return _UnionGenericAlias(origin, converted)
+        else:
+            try:
+                setattr(tp, '__args__', converted)
+            except AttributeError:
+                pass
+            return tp
+
+
+if sys.version_info < (3, 10):
+
+    def is_union(tp: Optional[Type[Any]]) -> bool:
+        return tp is Union
+
+    WithArgsTypes = (TypingGenericAlias,)
+
+else:
+    import types
+    import typing
+
+    def is_union(tp: Optional[Type[Any]]) -> bool:
+        return tp is Union or tp is types.UnionType  # noqa: E721
+
+    WithArgsTypes = (typing._GenericAlias, types.GenericAlias, types.UnionType)
+
+
+if sys.version_info < (3, 9):
+    StrPath = Union[str, PathLike]
+else:
+    StrPath = Union[str, PathLike]
+    # TODO: Once we switch to Cython 3 to handle generics properly
+    #  (https://github.com/cython/cython/issues/2753), use following lines instead
+    #  of the one above
+    # # os.PathLike only becomes subscriptable from Python 3.9 onwards
+    # StrPath = Union[str, PathLike[str]]
+
+
+if TYPE_CHECKING:
+    from .fields import ModelField
+
+    TupleGenerator = Generator[Tuple[str, Any], None, None]
+    DictStrAny = Dict[str, Any]
+    DictAny = Dict[Any, Any]
+    SetStr = Set[str]
+    ListStr = List[str]
+    IntStr = Union[int, str]
+    AbstractSetIntStr = AbstractSet[IntStr]
+    DictIntStrAny = Dict[IntStr, Any]
+    MappingIntStrAny = Mapping[IntStr, Any]
+    CallableGenerator = Generator[AnyCallable, None, None]
+    ReprArgs = Sequence[Tuple[Optional[str], Any]]
+    AnyClassMethod = classmethod[Any]
+
+__all__ = (
+    'AnyCallable',
+    'NoArgAnyCallable',
+    'NoneType',
+    'is_none_type',
+    'display_as_type',
+    'resolve_annotations',
+    'is_callable_type',
+    'is_literal_type',
+    'all_literal_values',
+    'is_namedtuple',
+    'is_typeddict',
+    'is_typeddict_special',
+    'is_new_type',
+    'new_type_supertype',
+    'is_classvar',
+    'is_finalvar',
+    'update_field_forward_refs',
+    'update_model_forward_refs',
+    'TupleGenerator',
+    'DictStrAny',
+    'DictAny',
+    'SetStr',
+    'ListStr',
+    'IntStr',
+    'AbstractSetIntStr',
+    'DictIntStrAny',
+    'CallableGenerator',
+    'ReprArgs',
+    'AnyClassMethod',
+    'CallableGenerator',
+    'WithArgsTypes',
+    'get_args',
+    'get_origin',
+    'get_sub_types',
+    'typing_base',
+    'get_all_type_hints',
+    'is_union',
+    'StrPath',
+    'MappingIntStrAny',
+)
+
+
+NoneType = None.__class__
+
+
+NONE_TYPES: Tuple[Any, Any, Any] = (None, NoneType, Literal[None])
+
+
+if sys.version_info < (3, 8):
+    # Even though this implementation is slower, we need it for python 3.7:
+    # In python 3.7 "Literal" is not a builtin type and uses a different
+    # mechanism.
+    # for this reason `Literal[None] is Literal[None]` evaluates to `False`,
+    # breaking the faster implementation used for the other python versions.
+
+    def is_none_type(type_: Any) -> bool:
+        return type_ in NONE_TYPES
+
+elif sys.version_info[:2] == (3, 8):
+
+    def is_none_type(type_: Any) -> bool:
+        for none_type in NONE_TYPES:
+            if type_ is none_type:
+                return True
+        # With python 3.8, specifically 3.8.10, Literal "is" check sare very flakey
+        # can change on very subtle changes like use of types in other modules,
+        # hopefully this check avoids that issue.
+        if is_literal_type(type_):  # pragma: no cover
+            return all_literal_values(type_) == (None,)
+        return False
+
+else:
+
+    def is_none_type(type_: Any) -> bool:
+        for none_type in NONE_TYPES:
+            if type_ is none_type:
+                return True
+        return False
+
+
+def display_as_type(v: Type[Any]) -> str:
+    if not isinstance(v, typing_base) and not isinstance(v, WithArgsTypes) and not isinstance(v, type):
+        v = v.__class__
+
+    if is_union(get_origin(v)):
+        return f'Union[{", ".join(map(display_as_type, get_args(v)))}]'
+
+    if isinstance(v, WithArgsTypes):
+        # Generic alias are constructs like `list[int]`
+        return str(v).replace('typing.', '')
+
+    try:
+        return v.__name__
+    except AttributeError:
+        # happens with typing objects
+        return str(v).replace('typing.', '')
+
+
+def resolve_annotations(raw_annotations: Dict[str, Type[Any]], module_name: Optional[str]) -> Dict[str, Type[Any]]:
+    """
+    Partially taken from typing.get_type_hints.
+
+    Resolve string or ForwardRef annotations into type objects if possible.
+    """
+    base_globals: Optional[Dict[str, Any]] = None
+    if module_name:
+        try:
+            module = sys.modules[module_name]
+        except KeyError:
+            # happens occasionally, see https://github.com/pydantic/pydantic/issues/2363
+            pass
+        else:
+            base_globals = module.__dict__
+
+    annotations = {}
+    for name, value in raw_annotations.items():
+        if isinstance(value, str):
+            if (3, 10) > sys.version_info >= (3, 9, 8) or sys.version_info >= (3, 10, 1):
+                value = ForwardRef(value, is_argument=False, is_class=True)
+            else:
+                value = ForwardRef(value, is_argument=False)
+        try:
+            value = _eval_type(value, base_globals, None)
+        except NameError:
+            # this is ok, it can be fixed with update_forward_refs
+            pass
+        annotations[name] = value
+    return annotations
+
+
+def is_callable_type(type_: Type[Any]) -> bool:
+    return type_ is Callable or get_origin(type_) is Callable
+
+
+def is_literal_type(type_: Type[Any]) -> bool:
+    return Literal is not None and get_origin(type_) is Literal
+
+
+def literal_values(type_: Type[Any]) -> Tuple[Any, ...]:
+    return get_args(type_)
+
+
+def all_literal_values(type_: Type[Any]) -> Tuple[Any, ...]:
+    """
+    This method is used to retrieve all Literal values as
+    Literal can be used recursively (see https://www.python.org/dev/peps/pep-0586)
+    e.g. `Literal[Literal[Literal[1, 2, 3], "foo"], 5, None]`
+    """
+    if not is_literal_type(type_):
+        return (type_,)
+
+    values = literal_values(type_)
+    return tuple(x for value in values for x in all_literal_values(value))
+
+
+def is_namedtuple(type_: Type[Any]) -> bool:
+    """
+    Check if a given class is a named tuple.
+    It can be either a `typing.NamedTuple` or `collections.namedtuple`
+    """
+    from .utils import lenient_issubclass
+
+    return lenient_issubclass(type_, tuple) and hasattr(type_, '_fields')
+
+
+def is_typeddict(type_: Type[Any]) -> bool:
+    """
+    Check if a given class is a typed dict (from `typing` or `typing_extensions`)
+    In 3.10, there will be a public method (https://docs.python.org/3.10/library/typing.html#typing.is_typeddict)
+    """
+    from .utils import lenient_issubclass
+
+    return lenient_issubclass(type_, dict) and hasattr(type_, '__total__')
+
+
+def _check_typeddict_special(type_: Any) -> bool:
+    return type_ is TypedDictRequired or type_ is TypedDictNotRequired
+
+
+def is_typeddict_special(type_: Any) -> bool:
+    """
+    Check if type is a TypedDict special form (Required or NotRequired).
+    """
+    return _check_typeddict_special(type_) or _check_typeddict_special(get_origin(type_))
+
+
+test_type = NewType('test_type', str)
+
+
+def is_new_type(type_: Type[Any]) -> bool:
+    """
+    Check whether type_ was created using typing.NewType
+    """
+    return isinstance(type_, test_type.__class__) and hasattr(type_, '__supertype__')  # type: ignore
+
+
+def new_type_supertype(type_: Type[Any]) -> Type[Any]:
+    while hasattr(type_, '__supertype__'):
+        type_ = type_.__supertype__
+    return type_
+
+
+def _check_classvar(v: Optional[Type[Any]]) -> bool:
+    if v is None:
+        return False
+
+    return v.__class__ == ClassVar.__class__ and getattr(v, '_name', None) == 'ClassVar'
+
+
+def _check_finalvar(v: Optional[Type[Any]]) -> bool:
+    """
+    Check if a given type is a `typing.Final` type.
+    """
+    if v is None:
+        return False
+
+    return v.__class__ == Final.__class__ and (sys.version_info < (3, 8) or getattr(v, '_name', None) == 'Final')
+
+
+def is_classvar(ann_type: Type[Any]) -> bool:
+    if _check_classvar(ann_type) or _check_classvar(get_origin(ann_type)):
+        return True
+
+    # this is an ugly workaround for class vars that contain forward references and are therefore themselves
+    # forward references, see #3679
+    if ann_type.__class__ == ForwardRef and ann_type.__forward_arg__.startswith('ClassVar['):
+        return True
+
+    return False
+
+
+def is_finalvar(ann_type: Type[Any]) -> bool:
+    return _check_finalvar(ann_type) or _check_finalvar(get_origin(ann_type))
+
+
+def update_field_forward_refs(field: 'ModelField', globalns: Any, localns: Any) -> None:
+    """
+    Try to update ForwardRefs on fields based on this ModelField, globalns and localns.
+    """
+    prepare = False
+    if field.type_.__class__ == ForwardRef:
+        prepare = True
+        field.type_ = evaluate_forwardref(field.type_, globalns, localns or None)
+    if field.outer_type_.__class__ == ForwardRef:
+        prepare = True
+        field.outer_type_ = evaluate_forwardref(field.outer_type_, globalns, localns or None)
+    if prepare:
+        field.prepare()
+
+    if field.sub_fields:
+        for sub_f in field.sub_fields:
+            update_field_forward_refs(sub_f, globalns=globalns, localns=localns)
+
+    if field.discriminator_key is not None:
+        field.prepare_discriminated_union_sub_fields()
+
+
+def update_model_forward_refs(
+    model: Type[Any],
+    fields: Iterable['ModelField'],
+    json_encoders: Dict[Union[Type[Any], str, ForwardRef], AnyCallable],
+    localns: 'DictStrAny',
+    exc_to_suppress: Tuple[Type[BaseException], ...] = (),
+) -> None:
+    """
+    Try to update model fields ForwardRefs based on model and localns.
+    """
+    if model.__module__ in sys.modules:
+        globalns = sys.modules[model.__module__].__dict__.copy()
+    else:
+        globalns = {}
+
+    globalns.setdefault(model.__name__, model)
+
+    for f in fields:
+        try:
+            update_field_forward_refs(f, globalns=globalns, localns=localns)
+        except exc_to_suppress:
+            pass
+
+    for key in set(json_encoders.keys()):
+        if isinstance(key, str):
+            fr: ForwardRef = ForwardRef(key)
+        elif isinstance(key, ForwardRef):
+            fr = key
+        else:
+            continue
+
+        try:
+            new_key = evaluate_forwardref(fr, globalns, localns or None)
+        except exc_to_suppress:  # pragma: no cover
+            continue
+
+        json_encoders[new_key] = json_encoders.pop(key)
+
+
+def get_class(type_: Type[Any]) -> Union[None, bool, Type[Any]]:
+    """
+    Tries to get the class of a Type[T] annotation. Returns True if Type is used
+    without brackets. Otherwise returns None.
+    """
+    if type_ is type:
+        return True
+
+    if get_origin(type_) is None:
+        return None
+
+    args = get_args(type_)
+    if not args or not isinstance(args[0], type):
+        return True
+    else:
+        return args[0]
+
+
+def get_sub_types(tp: Any) -> List[Any]:
+    """
+    Return all the types that are allowed by type `tp`
+    `tp` can be a `Union` of allowed types or an `Annotated` type
+    """
+    origin = get_origin(tp)
+    if origin is Annotated:
+        return get_sub_types(get_args(tp)[0])
+    elif is_union(origin):
+        return [x for t in get_args(tp) for x in get_sub_types(t)]
+    else:
+        return [tp]
diff --git a/lib/pydantic/utils.py b/lib/pydantic/utils.py
index 1619d1db..1d016c0e 100644
--- a/lib/pydantic/utils.py
+++ b/lib/pydantic/utils.py
@@ -1,4 +1,841 @@
-"""The `utils` module is a backport module from V1."""
-from ._migration import getattr_migration
+import keyword
+import warnings
+import weakref
+from collections import OrderedDict, defaultdict, deque
+from copy import deepcopy
+from itertools import islice, zip_longest
+from types import BuiltinFunctionType, CodeType, FunctionType, GeneratorType, LambdaType, ModuleType
+from typing import (
+    TYPE_CHECKING,
+    AbstractSet,
+    Any,
+    Callable,
+    Collection,
+    Dict,
+    Generator,
+    Iterable,
+    Iterator,
+    List,
+    Mapping,
+    MutableMapping,
+    NoReturn,
+    Optional,
+    Set,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+)
 
-__getattr__ = getattr_migration(__name__)
+from typing_extensions import Annotated
+
+from .errors import ConfigError
+from .typing import (
+    NoneType,
+    WithArgsTypes,
+    all_literal_values,
+    display_as_type,
+    get_args,
+    get_origin,
+    is_literal_type,
+    is_union,
+)
+from .version import version_info
+
+if TYPE_CHECKING:
+    from inspect import Signature
+    from pathlib import Path
+
+    from .config import BaseConfig
+    from .dataclasses import Dataclass
+    from .fields import ModelField
+    from .main import BaseModel
+    from .typing import AbstractSetIntStr, DictIntStrAny, IntStr, MappingIntStrAny, ReprArgs
+
+    RichReprResult = Iterable[Union[Any, Tuple[Any], Tuple[str, Any], Tuple[str, Any, Any]]]
+
+__all__ = (
+    'import_string',
+    'sequence_like',
+    'validate_field_name',
+    'lenient_isinstance',
+    'lenient_issubclass',
+    'in_ipython',
+    'is_valid_identifier',
+    'deep_update',
+    'update_not_none',
+    'almost_equal_floats',
+    'get_model',
+    'to_camel',
+    'is_valid_field',
+    'smart_deepcopy',
+    'PyObjectStr',
+    'Representation',
+    'GetterDict',
+    'ValueItems',
+    'version_info',  # required here to match behaviour in v1.3
+    'ClassAttribute',
+    'path_type',
+    'ROOT_KEY',
+    'get_unique_discriminator_alias',
+    'get_discriminator_alias_and_values',
+    'DUNDER_ATTRIBUTES',
+    'LimitedDict',
+)
+
+ROOT_KEY = '__root__'
+# these are types that are returned unchanged by deepcopy
+IMMUTABLE_NON_COLLECTIONS_TYPES: Set[Type[Any]] = {
+    int,
+    float,
+    complex,
+    str,
+    bool,
+    bytes,
+    type,
+    NoneType,
+    FunctionType,
+    BuiltinFunctionType,
+    LambdaType,
+    weakref.ref,
+    CodeType,
+    # note: including ModuleType will differ from behaviour of deepcopy by not producing error.
+    # It might be not a good idea in general, but considering that this function used only internally
+    # against default values of fields, this will allow to actually have a field with module as default value
+    ModuleType,
+    NotImplemented.__class__,
+    Ellipsis.__class__,
+}
+
+# these are types that if empty, might be copied with simple copy() instead of deepcopy()
+BUILTIN_COLLECTIONS: Set[Type[Any]] = {
+    list,
+    set,
+    tuple,
+    frozenset,
+    dict,
+    OrderedDict,
+    defaultdict,
+    deque,
+}
+
+
+def import_string(dotted_path: str) -> Any:
+    """
+    Stolen approximately from django. Import a dotted module path and return the attribute/class designated by the
+    last name in the path. Raise ImportError if the import fails.
+    """
+    from importlib import import_module
+
+    try:
+        module_path, class_name = dotted_path.strip(' ').rsplit('.', 1)
+    except ValueError as e:
+        raise ImportError(f'"{dotted_path}" doesn\'t look like a module path') from e
+
+    module = import_module(module_path)
+    try:
+        return getattr(module, class_name)
+    except AttributeError as e:
+        raise ImportError(f'Module "{module_path}" does not define a "{class_name}" attribute') from e
+
+
+def truncate(v: Union[str], *, max_len: int = 80) -> str:
+    """
+    Truncate a value and add a unicode ellipsis (three dots) to the end if it was too long
+    """
+    warnings.warn('`truncate` is no-longer used by pydantic and is deprecated', DeprecationWarning)
+    if isinstance(v, str) and len(v) > (max_len - 2):
+        # -3 so quote + string + … + quote has correct length
+        return (v[: (max_len - 3)] + '…').__repr__()
+    try:
+        v = v.__repr__()
+    except TypeError:
+        v = v.__class__.__repr__(v)  # in case v is a type
+    if len(v) > max_len:
+        v = v[: max_len - 1] + '…'
+    return v
+
+
+def sequence_like(v: Any) -> bool:
+    return isinstance(v, (list, tuple, set, frozenset, GeneratorType, deque))
+
+
+def validate_field_name(bases: List[Type['BaseModel']], field_name: str) -> None:
+    """
+    Ensure that the field's name does not shadow an existing attribute of the model.
+    """
+    for base in bases:
+        if getattr(base, field_name, None):
+            raise NameError(
+                f'Field name "{field_name}" shadows a BaseModel attribute; '
+                f'use a different field name with "alias=\'{field_name}\'".'
+            )
+
+
+def lenient_isinstance(o: Any, class_or_tuple: Union[Type[Any], Tuple[Type[Any], ...], None]) -> bool:
+    try:
+        return isinstance(o, class_or_tuple)  # type: ignore[arg-type]
+    except TypeError:
+        return False
+
+
+def lenient_issubclass(cls: Any, class_or_tuple: Union[Type[Any], Tuple[Type[Any], ...], None]) -> bool:
+    try:
+        return isinstance(cls, type) and issubclass(cls, class_or_tuple)  # type: ignore[arg-type]
+    except TypeError:
+        if isinstance(cls, WithArgsTypes):
+            return False
+        raise  # pragma: no cover
+
+
+def in_ipython() -> bool:
+    """
+    Check whether we're in an ipython environment, including jupyter notebooks.
+    """
+    try:
+        eval('__IPYTHON__')
+    except NameError:
+        return False
+    else:  # pragma: no cover
+        return True
+
+
+def is_valid_identifier(identifier: str) -> bool:
+    """
+    Checks that a string is a valid identifier and not a Python keyword.
+    :param identifier: The identifier to test.
+    :return: True if the identifier is valid.
+    """
+    return identifier.isidentifier() and not keyword.iskeyword(identifier)
+
+
+KeyType = TypeVar('KeyType')
+
+
+def deep_update(mapping: Dict[KeyType, Any], *updating_mappings: Dict[KeyType, Any]) -> Dict[KeyType, Any]:
+    updated_mapping = mapping.copy()
+    for updating_mapping in updating_mappings:
+        for k, v in updating_mapping.items():
+            if k in updated_mapping and isinstance(updated_mapping[k], dict) and isinstance(v, dict):
+                updated_mapping[k] = deep_update(updated_mapping[k], v)
+            else:
+                updated_mapping[k] = v
+    return updated_mapping
+
+
+def update_not_none(mapping: Dict[Any, Any], **update: Any) -> None:
+    mapping.update({k: v for k, v in update.items() if v is not None})
+
+
+def almost_equal_floats(value_1: float, value_2: float, *, delta: float = 1e-8) -> bool:
+    """
+    Return True if two floats are almost equal
+    """
+    return abs(value_1 - value_2) <= delta
+
+
+def generate_model_signature(
+    init: Callable[..., None], fields: Dict[str, 'ModelField'], config: Type['BaseConfig']
+) -> 'Signature':
+    """
+    Generate signature for model based on its fields
+    """
+    from inspect import Parameter, Signature, signature
+
+    from .config import Extra
+
+    present_params = signature(init).parameters.values()
+    merged_params: Dict[str, Parameter] = {}
+    var_kw = None
+    use_var_kw = False
+
+    for param in islice(present_params, 1, None):  # skip self arg
+        if param.kind is param.VAR_KEYWORD:
+            var_kw = param
+            continue
+        merged_params[param.name] = param
+
+    if var_kw:  # if custom init has no var_kw, fields which are not declared in it cannot be passed through
+        allow_names = config.allow_population_by_field_name
+        for field_name, field in fields.items():
+            param_name = field.alias
+            if field_name in merged_params or param_name in merged_params:
+                continue
+            elif not is_valid_identifier(param_name):
+                if allow_names and is_valid_identifier(field_name):
+                    param_name = field_name
+                else:
+                    use_var_kw = True
+                    continue
+
+            # TODO: replace annotation with actual expected types once #1055 solved
+            kwargs = {'default': field.default} if not field.required else {}
+            merged_params[param_name] = Parameter(
+                param_name, Parameter.KEYWORD_ONLY, annotation=field.annotation, **kwargs
+            )
+
+    if config.extra is Extra.allow:
+        use_var_kw = True
+
+    if var_kw and use_var_kw:
+        # Make sure the parameter for extra kwargs
+        # does not have the same name as a field
+        default_model_signature = [
+            ('__pydantic_self__', Parameter.POSITIONAL_OR_KEYWORD),
+            ('data', Parameter.VAR_KEYWORD),
+        ]
+        if [(p.name, p.kind) for p in present_params] == default_model_signature:
+            # if this is the standard model signature, use extra_data as the extra args name
+            var_kw_name = 'extra_data'
+        else:
+            # else start from var_kw
+            var_kw_name = var_kw.name
+
+        # generate a name that's definitely unique
+        while var_kw_name in fields:
+            var_kw_name += '_'
+        merged_params[var_kw_name] = var_kw.replace(name=var_kw_name)
+
+    return Signature(parameters=list(merged_params.values()), return_annotation=None)
+
+
+def get_model(obj: Union[Type['BaseModel'], Type['Dataclass']]) -> Type['BaseModel']:
+    from .main import BaseModel
+
+    try:
+        model_cls = obj.__pydantic_model__  # type: ignore
+    except AttributeError:
+        model_cls = obj
+
+    if not issubclass(model_cls, BaseModel):
+        raise TypeError('Unsupported type, must be either BaseModel or dataclass')
+    return model_cls
+
+
+def to_camel(string: str) -> str:
+    return ''.join(word.capitalize() for word in string.split('_'))
+
+
+def to_lower_camel(string: str) -> str:
+    if len(string) >= 1:
+        pascal_string = to_camel(string)
+        return pascal_string[0].lower() + pascal_string[1:]
+    return string.lower()
+
+
+T = TypeVar('T')
+
+
+def unique_list(
+    input_list: Union[List[T], Tuple[T, ...]],
+    *,
+    name_factory: Callable[[T], str] = str,
+) -> List[T]:
+    """
+    Make a list unique while maintaining order.
+    We update the list if another one with the same name is set
+    (e.g. root validator overridden in subclass)
+    """
+    result: List[T] = []
+    result_names: List[str] = []
+    for v in input_list:
+        v_name = name_factory(v)
+        if v_name not in result_names:
+            result_names.append(v_name)
+            result.append(v)
+        else:
+            result[result_names.index(v_name)] = v
+
+    return result
+
+
+class PyObjectStr(str):
+    """
+    String class where repr doesn't include quotes. Useful with Representation when you want to return a string
+    representation of something that valid (or pseudo-valid) python.
+    """
+
+    def __repr__(self) -> str:
+        return str(self)
+
+
+class Representation:
+    """
+    Mixin to provide __str__, __repr__, and __pretty__ methods. See #884 for more details.
+
+    __pretty__ is used by [devtools](https://python-devtools.helpmanual.io/) to provide human readable representations
+    of objects.
+    """
+
+    __slots__: Tuple[str, ...] = tuple()
+
+    def __repr_args__(self) -> 'ReprArgs':
+        """
+        Returns the attributes to show in __str__, __repr__, and __pretty__ this is generally overridden.
+
+        Can either return:
+        * name - value pairs, e.g.: `[('foo_name', 'foo'), ('bar_name', ['b', 'a', 'r'])]`
+        * or, just values, e.g.: `[(None, 'foo'), (None, ['b', 'a', 'r'])]`
+        """
+        attrs = ((s, getattr(self, s)) for s in self.__slots__)
+        return [(a, v) for a, v in attrs if v is not None]
+
+    def __repr_name__(self) -> str:
+        """
+        Name of the instance's class, used in __repr__.
+        """
+        return self.__class__.__name__
+
+    def __repr_str__(self, join_str: str) -> str:
+        return join_str.join(repr(v) if a is None else f'{a}={v!r}' for a, v in self.__repr_args__())
+
+    def __pretty__(self, fmt: Callable[[Any], Any], **kwargs: Any) -> Generator[Any, None, None]:
+        """
+        Used by devtools (https://python-devtools.helpmanual.io/) to provide a human readable representations of objects
+        """
+        yield self.__repr_name__() + '('
+        yield 1
+        for name, value in self.__repr_args__():
+            if name is not None:
+                yield name + '='
+            yield fmt(value)
+            yield ','
+            yield 0
+        yield -1
+        yield ')'
+
+    def __str__(self) -> str:
+        return self.__repr_str__(' ')
+
+    def __repr__(self) -> str:
+        return f'{self.__repr_name__()}({self.__repr_str__(", ")})'
+
+    def __rich_repr__(self) -> 'RichReprResult':
+        """Get fields for Rich library"""
+        for name, field_repr in self.__repr_args__():
+            if name is None:
+                yield field_repr
+            else:
+                yield name, field_repr
+
+
+class GetterDict(Representation):
+    """
+    Hack to make object's smell just enough like dicts for validate_model.
+
+    We can't inherit from Mapping[str, Any] because it upsets cython so we have to implement all methods ourselves.
+    """
+
+    __slots__ = ('_obj',)
+
+    def __init__(self, obj: Any):
+        self._obj = obj
+
+    def __getitem__(self, key: str) -> Any:
+        try:
+            return getattr(self._obj, key)
+        except AttributeError as e:
+            raise KeyError(key) from e
+
+    def get(self, key: Any, default: Any = None) -> Any:
+        return getattr(self._obj, key, default)
+
+    def extra_keys(self) -> Set[Any]:
+        """
+        We don't want to get any other attributes of obj if the model didn't explicitly ask for them
+        """
+        return set()
+
+    def keys(self) -> List[Any]:
+        """
+        Keys of the pseudo dictionary, uses a list not set so order information can be maintained like python
+        dictionaries.
+        """
+        return list(self)
+
+    def values(self) -> List[Any]:
+        return [self[k] for k in self]
+
+    def items(self) -> Iterator[Tuple[str, Any]]:
+        for k in self:
+            yield k, self.get(k)
+
+    def __iter__(self) -> Iterator[str]:
+        for name in dir(self._obj):
+            if not name.startswith('_'):
+                yield name
+
+    def __len__(self) -> int:
+        return sum(1 for _ in self)
+
+    def __contains__(self, item: Any) -> bool:
+        return item in self.keys()
+
+    def __eq__(self, other: Any) -> bool:
+        return dict(self) == dict(other.items())
+
+    def __repr_args__(self) -> 'ReprArgs':
+        return [(None, dict(self))]
+
+    def __repr_name__(self) -> str:
+        return f'GetterDict[{display_as_type(self._obj)}]'
+
+
+class ValueItems(Representation):
+    """
+    Class for more convenient calculation of excluded or included fields on values.
+    """
+
+    __slots__ = ('_items', '_type')
+
+    def __init__(self, value: Any, items: Union['AbstractSetIntStr', 'MappingIntStrAny']) -> None:
+        items = self._coerce_items(items)
+
+        if isinstance(value, (list, tuple)):
+            items = self._normalize_indexes(items, len(value))
+
+        self._items: 'MappingIntStrAny' = items
+
+    def is_excluded(self, item: Any) -> bool:
+        """
+        Check if item is fully excluded.
+
+        :param item: key or index of a value
+        """
+        return self.is_true(self._items.get(item))
+
+    def is_included(self, item: Any) -> bool:
+        """
+        Check if value is contained in self._items
+
+        :param item: key or index of value
+        """
+        return item in self._items
+
+    def for_element(self, e: 'IntStr') -> Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']]:
+        """
+        :param e: key or index of element on value
+        :return: raw values for element if self._items is dict and contain needed element
+        """
+
+        item = self._items.get(e)
+        return item if not self.is_true(item) else None
+
+    def _normalize_indexes(self, items: 'MappingIntStrAny', v_length: int) -> 'DictIntStrAny':
+        """
+        :param items: dict or set of indexes which will be normalized
+        :param v_length: length of sequence indexes of which will be
+
+        >>> self._normalize_indexes({0: True, -2: True, -1: True}, 4)
+        {0: True, 2: True, 3: True}
+        >>> self._normalize_indexes({'__all__': True}, 4)
+        {0: True, 1: True, 2: True, 3: True}
+        """
+
+        normalized_items: 'DictIntStrAny' = {}
+        all_items = None
+        for i, v in items.items():
+            if not (isinstance(v, Mapping) or isinstance(v, AbstractSet) or self.is_true(v)):
+                raise TypeError(f'Unexpected type of exclude value for index "{i}" {v.__class__}')
+            if i == '__all__':
+                all_items = self._coerce_value(v)
+                continue
+            if not isinstance(i, int):
+                raise TypeError(
+                    'Excluding fields from a sequence of sub-models or dicts must be performed index-wise: '
+                    'expected integer keys or keyword "__all__"'
+                )
+            normalized_i = v_length + i if i < 0 else i
+            normalized_items[normalized_i] = self.merge(v, normalized_items.get(normalized_i))
+
+        if not all_items:
+            return normalized_items
+        if self.is_true(all_items):
+            for i in range(v_length):
+                normalized_items.setdefault(i, ...)
+            return normalized_items
+        for i in range(v_length):
+            normalized_item = normalized_items.setdefault(i, {})
+            if not self.is_true(normalized_item):
+                normalized_items[i] = self.merge(all_items, normalized_item)
+        return normalized_items
+
+    @classmethod
+    def merge(cls, base: Any, override: Any, intersect: bool = False) -> Any:
+        """
+        Merge a ``base`` item with an ``override`` item.
+
+        Both ``base`` and ``override`` are converted to dictionaries if possible.
+        Sets are converted to dictionaries with the sets entries as keys and
+        Ellipsis as values.
+
+        Each key-value pair existing in ``base`` is merged with ``override``,
+        while the rest of the key-value pairs are updated recursively with this function.
+
+        Merging takes place based on the "union" of keys if ``intersect`` is
+        set to ``False`` (default) and on the intersection of keys if
+        ``intersect`` is set to ``True``.
+        """
+        override = cls._coerce_value(override)
+        base = cls._coerce_value(base)
+        if override is None:
+            return base
+        if cls.is_true(base) or base is None:
+            return override
+        if cls.is_true(override):
+            return base if intersect else override
+
+        # intersection or union of keys while preserving ordering:
+        if intersect:
+            merge_keys = [k for k in base if k in override] + [k for k in override if k in base]
+        else:
+            merge_keys = list(base) + [k for k in override if k not in base]
+
+        merged: 'DictIntStrAny' = {}
+        for k in merge_keys:
+            merged_item = cls.merge(base.get(k), override.get(k), intersect=intersect)
+            if merged_item is not None:
+                merged[k] = merged_item
+
+        return merged
+
+    @staticmethod
+    def _coerce_items(items: Union['AbstractSetIntStr', 'MappingIntStrAny']) -> 'MappingIntStrAny':
+        if isinstance(items, Mapping):
+            pass
+        elif isinstance(items, AbstractSet):
+            items = dict.fromkeys(items, ...)
+        else:
+            class_name = getattr(items, '__class__', '???')
+            assert_never(
+                items,
+                f'Unexpected type of exclude value {class_name}',
+            )
+        return items
+
+    @classmethod
+    def _coerce_value(cls, value: Any) -> Any:
+        if value is None or cls.is_true(value):
+            return value
+        return cls._coerce_items(value)
+
+    @staticmethod
+    def is_true(v: Any) -> bool:
+        return v is True or v is ...
+
+    def __repr_args__(self) -> 'ReprArgs':
+        return [(None, self._items)]
+
+
+class ClassAttribute:
+    """
+    Hide class attribute from its instances
+    """
+
+    __slots__ = (
+        'name',
+        'value',
+    )
+
+    def __init__(self, name: str, value: Any) -> None:
+        self.name = name
+        self.value = value
+
+    def __get__(self, instance: Any, owner: Type[Any]) -> None:
+        if instance is None:
+            return self.value
+        raise AttributeError(f'{self.name!r} attribute of {owner.__name__!r} is class-only')
+
+
+path_types = {
+    'is_dir': 'directory',
+    'is_file': 'file',
+    'is_mount': 'mount point',
+    'is_symlink': 'symlink',
+    'is_block_device': 'block device',
+    'is_char_device': 'char device',
+    'is_fifo': 'FIFO',
+    'is_socket': 'socket',
+}
+
+
+def path_type(p: 'Path') -> str:
+    """
+    Find out what sort of thing a path is.
+    """
+    assert p.exists(), 'path does not exist'
+    for method, name in path_types.items():
+        if getattr(p, method)():
+            return name
+
+    return 'unknown'
+
+
+Obj = TypeVar('Obj')
+
+
+def smart_deepcopy(obj: Obj) -> Obj:
+    """
+    Return type as is for immutable built-in types
+    Use obj.copy() for built-in empty collections
+    Use copy.deepcopy() for non-empty collections and unknown objects
+    """
+
+    obj_type = obj.__class__
+    if obj_type in IMMUTABLE_NON_COLLECTIONS_TYPES:
+        return obj  # fastest case: obj is immutable and not collection therefore will not be copied anyway
+    try:
+        if not obj and obj_type in BUILTIN_COLLECTIONS:
+            # faster way for empty collections, no need to copy its members
+            return obj if obj_type is tuple else obj.copy()  # type: ignore  # tuple doesn't have copy method
+    except (TypeError, ValueError, RuntimeError):
+        # do we really dare to catch ALL errors? Seems a bit risky
+        pass
+
+    return deepcopy(obj)  # slowest way when we actually might need a deepcopy
+
+
+def is_valid_field(name: str) -> bool:
+    if not name.startswith('_'):
+        return True
+    return ROOT_KEY == name
+
+
+DUNDER_ATTRIBUTES = {
+    '__annotations__',
+    '__classcell__',
+    '__doc__',
+    '__module__',
+    '__orig_bases__',
+    '__orig_class__',
+    '__qualname__',
+}
+
+
+def is_valid_private_name(name: str) -> bool:
+    return not is_valid_field(name) and name not in DUNDER_ATTRIBUTES
+
+
+_EMPTY = object()
+
+
+def all_identical(left: Iterable[Any], right: Iterable[Any]) -> bool:
+    """
+    Check that the items of `left` are the same objects as those in `right`.
+
+    >>> a, b = object(), object()
+    >>> all_identical([a, b, a], [a, b, a])
+    True
+    >>> all_identical([a, b, [a]], [a, b, [a]])  # new list object, while "equal" is not "identical"
+    False
+    """
+    for left_item, right_item in zip_longest(left, right, fillvalue=_EMPTY):
+        if left_item is not right_item:
+            return False
+    return True
+
+
+def assert_never(obj: NoReturn, msg: str) -> NoReturn:
+    """
+    Helper to make sure that we have covered all possible types.
+
+    This is mostly useful for ``mypy``, docs:
+    https://mypy.readthedocs.io/en/latest/literal_types.html#exhaustive-checks
+    """
+    raise TypeError(msg)
+
+
+def get_unique_discriminator_alias(all_aliases: Collection[str], discriminator_key: str) -> str:
+    """Validate that all aliases are the same and if that's the case return the alias"""
+    unique_aliases = set(all_aliases)
+    if len(unique_aliases) > 1:
+        raise ConfigError(
+            f'Aliases for discriminator {discriminator_key!r} must be the same (got {", ".join(sorted(all_aliases))})'
+        )
+    return unique_aliases.pop()
+
+
+def get_discriminator_alias_and_values(tp: Any, discriminator_key: str) -> Tuple[str, Tuple[str, ...]]:
+    """
+    Get alias and all valid values in the `Literal` type of the discriminator field
+    `tp` can be a `BaseModel` class or directly an `Annotated` `Union` of many.
+    """
+    is_root_model = getattr(tp, '__custom_root_type__', False)
+
+    if get_origin(tp) is Annotated:
+        tp = get_args(tp)[0]
+
+    if hasattr(tp, '__pydantic_model__'):
+        tp = tp.__pydantic_model__
+
+    if is_union(get_origin(tp)):
+        alias, all_values = _get_union_alias_and_all_values(tp, discriminator_key)
+        return alias, tuple(v for values in all_values for v in values)
+    elif is_root_model:
+        union_type = tp.__fields__[ROOT_KEY].type_
+        alias, all_values = _get_union_alias_and_all_values(union_type, discriminator_key)
+
+        if len(set(all_values)) > 1:
+            raise ConfigError(
+                f'Field {discriminator_key!r} is not the same for all submodels of {display_as_type(tp)!r}'
+            )
+
+        return alias, all_values[0]
+
+    else:
+        try:
+            t_discriminator_type = tp.__fields__[discriminator_key].type_
+        except AttributeError as e:
+            raise TypeError(f'Type {tp.__name__!r} is not a valid `BaseModel` or `dataclass`') from e
+        except KeyError as e:
+            raise ConfigError(f'Model {tp.__name__!r} needs a discriminator field for key {discriminator_key!r}') from e
+
+        if not is_literal_type(t_discriminator_type):
+            raise ConfigError(f'Field {discriminator_key!r} of model {tp.__name__!r} needs to be a `Literal`')
+
+        return tp.__fields__[discriminator_key].alias, all_literal_values(t_discriminator_type)
+
+
+def _get_union_alias_and_all_values(
+    union_type: Type[Any], discriminator_key: str
+) -> Tuple[str, Tuple[Tuple[str, ...], ...]]:
+    zipped_aliases_values = [get_discriminator_alias_and_values(t, discriminator_key) for t in get_args(union_type)]
+    # unzip: [('alias_a',('v1', 'v2)), ('alias_b', ('v3',))] => [('alias_a', 'alias_b'), (('v1', 'v2'), ('v3',))]
+    all_aliases, all_values = zip(*zipped_aliases_values)
+    return get_unique_discriminator_alias(all_aliases, discriminator_key), all_values
+
+
+KT = TypeVar('KT')
+VT = TypeVar('VT')
+if TYPE_CHECKING:
+    # Annoying inheriting from `MutableMapping` and `dict` breaks cython, hence this work around
+    class LimitedDict(dict, MutableMapping[KT, VT]):  # type: ignore[type-arg]
+        def __init__(self, size_limit: int = 1000):
+            ...
+
+else:
+
+    class LimitedDict(dict):
+        """
+        Limit the size/length of a dict used for caching to avoid unlimited increase in memory usage.
+
+        Since the dict is ordered, and we always remove elements from the beginning, this is effectively a FIFO cache.
+
+        Annoying inheriting from `MutableMapping` breaks cython.
+        """
+
+        def __init__(self, size_limit: int = 1000):
+            self.size_limit = size_limit
+            super().__init__()
+
+        def __setitem__(self, __key: Any, __value: Any) -> None:
+            super().__setitem__(__key, __value)
+            if len(self) > self.size_limit:
+                excess = len(self) - self.size_limit + self.size_limit // 10
+                to_remove = list(self.keys())[:excess]
+                for key in to_remove:
+                    del self[key]
+
+        def __class_getitem__(cls, *args: Any) -> Any:
+            # to avoid errors with 3.7
+            pass
diff --git a/lib/pydantic/v1/__init__.py b/lib/pydantic/v1/__init__.py
deleted file mode 100644
index 3bf1418f..00000000
--- a/lib/pydantic/v1/__init__.py
+++ /dev/null
@@ -1,131 +0,0 @@
-# flake8: noqa
-from . import dataclasses
-from .annotated_types import create_model_from_namedtuple, create_model_from_typeddict
-from .class_validators import root_validator, validator
-from .config import BaseConfig, ConfigDict, Extra
-from .decorator import validate_arguments
-from .env_settings import BaseSettings
-from .error_wrappers import ValidationError
-from .errors import *
-from .fields import Field, PrivateAttr, Required
-from .main import *
-from .networks import *
-from .parse import Protocol
-from .tools import *
-from .types import *
-from .version import VERSION, compiled
-
-__version__ = VERSION
-
-# WARNING __all__ from .errors is not included here, it will be removed as an export here in v2
-# please use "from pydantic.errors import ..." instead
-__all__ = [
-    # annotated types utils
-    'create_model_from_namedtuple',
-    'create_model_from_typeddict',
-    # dataclasses
-    'dataclasses',
-    # class_validators
-    'root_validator',
-    'validator',
-    # config
-    'BaseConfig',
-    'ConfigDict',
-    'Extra',
-    # decorator
-    'validate_arguments',
-    # env_settings
-    'BaseSettings',
-    # error_wrappers
-    'ValidationError',
-    # fields
-    'Field',
-    'Required',
-    # main
-    'BaseModel',
-    'create_model',
-    'validate_model',
-    # network
-    'AnyUrl',
-    'AnyHttpUrl',
-    'FileUrl',
-    'HttpUrl',
-    'stricturl',
-    'EmailStr',
-    'NameEmail',
-    'IPvAnyAddress',
-    'IPvAnyInterface',
-    'IPvAnyNetwork',
-    'PostgresDsn',
-    'CockroachDsn',
-    'AmqpDsn',
-    'RedisDsn',
-    'MongoDsn',
-    'KafkaDsn',
-    'validate_email',
-    # parse
-    'Protocol',
-    # tools
-    'parse_file_as',
-    'parse_obj_as',
-    'parse_raw_as',
-    'schema_of',
-    'schema_json_of',
-    # types
-    'NoneStr',
-    'NoneBytes',
-    'StrBytes',
-    'NoneStrBytes',
-    'StrictStr',
-    'ConstrainedBytes',
-    'conbytes',
-    'ConstrainedList',
-    'conlist',
-    'ConstrainedSet',
-    'conset',
-    'ConstrainedFrozenSet',
-    'confrozenset',
-    'ConstrainedStr',
-    'constr',
-    'PyObject',
-    'ConstrainedInt',
-    'conint',
-    'PositiveInt',
-    'NegativeInt',
-    'NonNegativeInt',
-    'NonPositiveInt',
-    'ConstrainedFloat',
-    'confloat',
-    'PositiveFloat',
-    'NegativeFloat',
-    'NonNegativeFloat',
-    'NonPositiveFloat',
-    'FiniteFloat',
-    'ConstrainedDecimal',
-    'condecimal',
-    'ConstrainedDate',
-    'condate',
-    'UUID1',
-    'UUID3',
-    'UUID4',
-    'UUID5',
-    'FilePath',
-    'DirectoryPath',
-    'Json',
-    'JsonWrapper',
-    'SecretField',
-    'SecretStr',
-    'SecretBytes',
-    'StrictBool',
-    'StrictBytes',
-    'StrictInt',
-    'StrictFloat',
-    'PaymentCardNumber',
-    'PrivateAttr',
-    'ByteSize',
-    'PastDate',
-    'FutureDate',
-    # version
-    'compiled',
-    'VERSION',
-]
diff --git a/lib/pydantic/v1/class_validators.py b/lib/pydantic/v1/class_validators.py
deleted file mode 100644
index 71e66509..00000000
--- a/lib/pydantic/v1/class_validators.py
+++ /dev/null
@@ -1,361 +0,0 @@
-import warnings
-from collections import ChainMap
-from functools import partial, partialmethod, wraps
-from itertools import chain
-from types import FunctionType
-from typing import TYPE_CHECKING, Any, Callable, Dict, Iterable, List, Optional, Set, Tuple, Type, Union, overload
-
-from .errors import ConfigError
-from .typing import AnyCallable
-from .utils import ROOT_KEY, in_ipython
-
-if TYPE_CHECKING:
-    from .typing import AnyClassMethod
-
-
-class Validator:
-    __slots__ = 'func', 'pre', 'each_item', 'always', 'check_fields', 'skip_on_failure'
-
-    def __init__(
-        self,
-        func: AnyCallable,
-        pre: bool = False,
-        each_item: bool = False,
-        always: bool = False,
-        check_fields: bool = False,
-        skip_on_failure: bool = False,
-    ):
-        self.func = func
-        self.pre = pre
-        self.each_item = each_item
-        self.always = always
-        self.check_fields = check_fields
-        self.skip_on_failure = skip_on_failure
-
-
-if TYPE_CHECKING:
-    from inspect import Signature
-
-    from .config import BaseConfig
-    from .fields import ModelField
-    from .types import ModelOrDc
-
-    ValidatorCallable = Callable[[Optional[ModelOrDc], Any, Dict[str, Any], ModelField, Type[BaseConfig]], Any]
-    ValidatorsList = List[ValidatorCallable]
-    ValidatorListDict = Dict[str, List[Validator]]
-
-_FUNCS: Set[str] = set()
-VALIDATOR_CONFIG_KEY = '__validator_config__'
-ROOT_VALIDATOR_CONFIG_KEY = '__root_validator_config__'
-
-
-def validator(
-    *fields: str,
-    pre: bool = False,
-    each_item: bool = False,
-    always: bool = False,
-    check_fields: bool = True,
-    whole: Optional[bool] = None,
-    allow_reuse: bool = False,
-) -> Callable[[AnyCallable], 'AnyClassMethod']:
-    """
-    Decorate methods on the class indicating that they should be used to validate fields
-    :param fields: which field(s) the method should be called on
-    :param pre: whether or not this validator should be called before the standard validators (else after)
-    :param each_item: for complex objects (sets, lists etc.) whether to validate individual elements rather than the
-      whole object
-    :param always: whether this method and other validators should be called even if the value is missing
-    :param check_fields: whether to check that the fields actually exist on the model
-    :param allow_reuse: whether to track and raise an error if another validator refers to the decorated function
-    """
-    if not fields:
-        raise ConfigError('validator with no fields specified')
-    elif isinstance(fields[0], FunctionType):
-        raise ConfigError(
-            "validators should be used with fields and keyword arguments, not bare. "  # noqa: Q000
-            "E.g. usage should be `@validator('<field_name>', ...)`"
-        )
-    elif not all(isinstance(field, str) for field in fields):
-        raise ConfigError(
-            "validator fields should be passed as separate string args. "  # noqa: Q000
-            "E.g. usage should be `@validator('<field_name_1>', '<field_name_2>', ...)`"
-        )
-
-    if whole is not None:
-        warnings.warn(
-            'The "whole" keyword argument is deprecated, use "each_item" (inverse meaning, default False) instead',
-            DeprecationWarning,
-        )
-        assert each_item is False, '"each_item" and "whole" conflict, remove "whole"'
-        each_item = not whole
-
-    def dec(f: AnyCallable) -> 'AnyClassMethod':
-        f_cls = _prepare_validator(f, allow_reuse)
-        setattr(
-            f_cls,
-            VALIDATOR_CONFIG_KEY,
-            (
-                fields,
-                Validator(func=f_cls.__func__, pre=pre, each_item=each_item, always=always, check_fields=check_fields),
-            ),
-        )
-        return f_cls
-
-    return dec
-
-
-@overload
-def root_validator(_func: AnyCallable) -> 'AnyClassMethod':
-    ...
-
-
-@overload
-def root_validator(
-    *, pre: bool = False, allow_reuse: bool = False, skip_on_failure: bool = False
-) -> Callable[[AnyCallable], 'AnyClassMethod']:
-    ...
-
-
-def root_validator(
-    _func: Optional[AnyCallable] = None, *, pre: bool = False, allow_reuse: bool = False, skip_on_failure: bool = False
-) -> Union['AnyClassMethod', Callable[[AnyCallable], 'AnyClassMethod']]:
-    """
-    Decorate methods on a model indicating that they should be used to validate (and perhaps modify) data either
-    before or after standard model parsing/validation is performed.
-    """
-    if _func:
-        f_cls = _prepare_validator(_func, allow_reuse)
-        setattr(
-            f_cls, ROOT_VALIDATOR_CONFIG_KEY, Validator(func=f_cls.__func__, pre=pre, skip_on_failure=skip_on_failure)
-        )
-        return f_cls
-
-    def dec(f: AnyCallable) -> 'AnyClassMethod':
-        f_cls = _prepare_validator(f, allow_reuse)
-        setattr(
-            f_cls, ROOT_VALIDATOR_CONFIG_KEY, Validator(func=f_cls.__func__, pre=pre, skip_on_failure=skip_on_failure)
-        )
-        return f_cls
-
-    return dec
-
-
-def _prepare_validator(function: AnyCallable, allow_reuse: bool) -> 'AnyClassMethod':
-    """
-    Avoid validators with duplicated names since without this, validators can be overwritten silently
-    which generally isn't the intended behaviour, don't run in ipython (see #312) or if allow_reuse is False.
-    """
-    f_cls = function if isinstance(function, classmethod) else classmethod(function)
-    if not in_ipython() and not allow_reuse:
-        ref = (
-            getattr(f_cls.__func__, '__module__', '<No __module__>')
-            + '.'
-            + getattr(f_cls.__func__, '__qualname__', f'<No __qualname__: id:{id(f_cls.__func__)}>')
-        )
-        if ref in _FUNCS:
-            raise ConfigError(f'duplicate validator function "{ref}"; if this is intended, set `allow_reuse=True`')
-        _FUNCS.add(ref)
-    return f_cls
-
-
-class ValidatorGroup:
-    def __init__(self, validators: 'ValidatorListDict') -> None:
-        self.validators = validators
-        self.used_validators = {'*'}
-
-    def get_validators(self, name: str) -> Optional[Dict[str, Validator]]:
-        self.used_validators.add(name)
-        validators = self.validators.get(name, [])
-        if name != ROOT_KEY:
-            validators += self.validators.get('*', [])
-        if validators:
-            return {getattr(v.func, '__name__', f'<No __name__: id:{id(v.func)}>'): v for v in validators}
-        else:
-            return None
-
-    def check_for_unused(self) -> None:
-        unused_validators = set(
-            chain.from_iterable(
-                (
-                    getattr(v.func, '__name__', f'<No __name__: id:{id(v.func)}>')
-                    for v in self.validators[f]
-                    if v.check_fields
-                )
-                for f in (self.validators.keys() - self.used_validators)
-            )
-        )
-        if unused_validators:
-            fn = ', '.join(unused_validators)
-            raise ConfigError(
-                f"Validators defined with incorrect fields: {fn} "  # noqa: Q000
-                f"(use check_fields=False if you're inheriting from the model and intended this)"
-            )
-
-
-def extract_validators(namespace: Dict[str, Any]) -> Dict[str, List[Validator]]:
-    validators: Dict[str, List[Validator]] = {}
-    for var_name, value in namespace.items():
-        validator_config = getattr(value, VALIDATOR_CONFIG_KEY, None)
-        if validator_config:
-            fields, v = validator_config
-            for field in fields:
-                if field in validators:
-                    validators[field].append(v)
-                else:
-                    validators[field] = [v]
-    return validators
-
-
-def extract_root_validators(namespace: Dict[str, Any]) -> Tuple[List[AnyCallable], List[Tuple[bool, AnyCallable]]]:
-    from inspect import signature
-
-    pre_validators: List[AnyCallable] = []
-    post_validators: List[Tuple[bool, AnyCallable]] = []
-    for name, value in namespace.items():
-        validator_config: Optional[Validator] = getattr(value, ROOT_VALIDATOR_CONFIG_KEY, None)
-        if validator_config:
-            sig = signature(validator_config.func)
-            args = list(sig.parameters.keys())
-            if args[0] == 'self':
-                raise ConfigError(
-                    f'Invalid signature for root validator {name}: {sig}, "self" not permitted as first argument, '
-                    f'should be: (cls, values).'
-                )
-            if len(args) != 2:
-                raise ConfigError(f'Invalid signature for root validator {name}: {sig}, should be: (cls, values).')
-            # check function signature
-            if validator_config.pre:
-                pre_validators.append(validator_config.func)
-            else:
-                post_validators.append((validator_config.skip_on_failure, validator_config.func))
-    return pre_validators, post_validators
-
-
-def inherit_validators(base_validators: 'ValidatorListDict', validators: 'ValidatorListDict') -> 'ValidatorListDict':
-    for field, field_validators in base_validators.items():
-        if field not in validators:
-            validators[field] = []
-        validators[field] += field_validators
-    return validators
-
-
-def make_generic_validator(validator: AnyCallable) -> 'ValidatorCallable':
-    """
-    Make a generic function which calls a validator with the right arguments.
-
-    Unfortunately other approaches (eg. return a partial of a function that builds the arguments) is slow,
-    hence this laborious way of doing things.
-
-    It's done like this so validators don't all need **kwargs in their signature, eg. any combination of
-    the arguments "values", "fields" and/or "config" are permitted.
-    """
-    from inspect import signature
-
-    if not isinstance(validator, (partial, partialmethod)):
-        # This should be the default case, so overhead is reduced
-        sig = signature(validator)
-        args = list(sig.parameters.keys())
-    else:
-        # Fix the generated argument lists of partial methods
-        sig = signature(validator.func)
-        args = [
-            k
-            for k in signature(validator.func).parameters.keys()
-            if k not in validator.args | validator.keywords.keys()
-        ]
-
-    first_arg = args.pop(0)
-    if first_arg == 'self':
-        raise ConfigError(
-            f'Invalid signature for validator {validator}: {sig}, "self" not permitted as first argument, '
-            f'should be: (cls, value, values, config, field), "values", "config" and "field" are all optional.'
-        )
-    elif first_arg == 'cls':
-        # assume the second argument is value
-        return wraps(validator)(_generic_validator_cls(validator, sig, set(args[1:])))
-    else:
-        # assume the first argument was value which has already been removed
-        return wraps(validator)(_generic_validator_basic(validator, sig, set(args)))
-
-
-def prep_validators(v_funcs: Iterable[AnyCallable]) -> 'ValidatorsList':
-    return [make_generic_validator(f) for f in v_funcs if f]
-
-
-all_kwargs = {'values', 'field', 'config'}
-
-
-def _generic_validator_cls(validator: AnyCallable, sig: 'Signature', args: Set[str]) -> 'ValidatorCallable':
-    # assume the first argument is value
-    has_kwargs = False
-    if 'kwargs' in args:
-        has_kwargs = True
-        args -= {'kwargs'}
-
-    if not args.issubset(all_kwargs):
-        raise ConfigError(
-            f'Invalid signature for validator {validator}: {sig}, should be: '
-            f'(cls, value, values, config, field), "values", "config" and "field" are all optional.'
-        )
-
-    if has_kwargs:
-        return lambda cls, v, values, field, config: validator(cls, v, values=values, field=field, config=config)
-    elif args == set():
-        return lambda cls, v, values, field, config: validator(cls, v)
-    elif args == {'values'}:
-        return lambda cls, v, values, field, config: validator(cls, v, values=values)
-    elif args == {'field'}:
-        return lambda cls, v, values, field, config: validator(cls, v, field=field)
-    elif args == {'config'}:
-        return lambda cls, v, values, field, config: validator(cls, v, config=config)
-    elif args == {'values', 'field'}:
-        return lambda cls, v, values, field, config: validator(cls, v, values=values, field=field)
-    elif args == {'values', 'config'}:
-        return lambda cls, v, values, field, config: validator(cls, v, values=values, config=config)
-    elif args == {'field', 'config'}:
-        return lambda cls, v, values, field, config: validator(cls, v, field=field, config=config)
-    else:
-        # args == {'values', 'field', 'config'}
-        return lambda cls, v, values, field, config: validator(cls, v, values=values, field=field, config=config)
-
-
-def _generic_validator_basic(validator: AnyCallable, sig: 'Signature', args: Set[str]) -> 'ValidatorCallable':
-    has_kwargs = False
-    if 'kwargs' in args:
-        has_kwargs = True
-        args -= {'kwargs'}
-
-    if not args.issubset(all_kwargs):
-        raise ConfigError(
-            f'Invalid signature for validator {validator}: {sig}, should be: '
-            f'(value, values, config, field), "values", "config" and "field" are all optional.'
-        )
-
-    if has_kwargs:
-        return lambda cls, v, values, field, config: validator(v, values=values, field=field, config=config)
-    elif args == set():
-        return lambda cls, v, values, field, config: validator(v)
-    elif args == {'values'}:
-        return lambda cls, v, values, field, config: validator(v, values=values)
-    elif args == {'field'}:
-        return lambda cls, v, values, field, config: validator(v, field=field)
-    elif args == {'config'}:
-        return lambda cls, v, values, field, config: validator(v, config=config)
-    elif args == {'values', 'field'}:
-        return lambda cls, v, values, field, config: validator(v, values=values, field=field)
-    elif args == {'values', 'config'}:
-        return lambda cls, v, values, field, config: validator(v, values=values, config=config)
-    elif args == {'field', 'config'}:
-        return lambda cls, v, values, field, config: validator(v, field=field, config=config)
-    else:
-        # args == {'values', 'field', 'config'}
-        return lambda cls, v, values, field, config: validator(v, values=values, field=field, config=config)
-
-
-def gather_all_validators(type_: 'ModelOrDc') -> Dict[str, 'AnyClassMethod']:
-    all_attributes = ChainMap(*[cls.__dict__ for cls in type_.__mro__])  # type: ignore[arg-type,var-annotated]
-    return {
-        k: v
-        for k, v in all_attributes.items()
-        if hasattr(v, VALIDATOR_CONFIG_KEY) or hasattr(v, ROOT_VALIDATOR_CONFIG_KEY)
-    }
diff --git a/lib/pydantic/v1/color.py b/lib/pydantic/v1/color.py
deleted file mode 100644
index 6fdc9fb1..00000000
--- a/lib/pydantic/v1/color.py
+++ /dev/null
@@ -1,494 +0,0 @@
-"""
-Color definitions are  used as per CSS3 specification:
-http://www.w3.org/TR/css3-color/#svg-color
-
-A few colors have multiple names referring to the sames colors, eg. `grey` and `gray` or `aqua` and `cyan`.
-
-In these cases the LAST color when sorted alphabetically takes preferences,
-eg. Color((0, 255, 255)).as_named() == 'cyan' because "cyan" comes after "aqua".
-"""
-import math
-import re
-from colorsys import hls_to_rgb, rgb_to_hls
-from typing import TYPE_CHECKING, Any, Dict, Optional, Tuple, Union, cast
-
-from .errors import ColorError
-from .utils import Representation, almost_equal_floats
-
-if TYPE_CHECKING:
-    from .typing import CallableGenerator, ReprArgs
-
-ColorTuple = Union[Tuple[int, int, int], Tuple[int, int, int, float]]
-ColorType = Union[ColorTuple, str]
-HslColorTuple = Union[Tuple[float, float, float], Tuple[float, float, float, float]]
-
-
-class RGBA:
-    """
-    Internal use only as a representation of a color.
-    """
-
-    __slots__ = 'r', 'g', 'b', 'alpha', '_tuple'
-
-    def __init__(self, r: float, g: float, b: float, alpha: Optional[float]):
-        self.r = r
-        self.g = g
-        self.b = b
-        self.alpha = alpha
-
-        self._tuple: Tuple[float, float, float, Optional[float]] = (r, g, b, alpha)
-
-    def __getitem__(self, item: Any) -> Any:
-        return self._tuple[item]
-
-
-# these are not compiled here to avoid import slowdown, they'll be compiled the first time they're used, then cached
-r_hex_short = r'\s*(?:#|0x)?([0-9a-f])([0-9a-f])([0-9a-f])([0-9a-f])?\s*'
-r_hex_long = r'\s*(?:#|0x)?([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})?\s*'
-_r_255 = r'(\d{1,3}(?:\.\d+)?)'
-_r_comma = r'\s*,\s*'
-r_rgb = fr'\s*rgb\(\s*{_r_255}{_r_comma}{_r_255}{_r_comma}{_r_255}\)\s*'
-_r_alpha = r'(\d(?:\.\d+)?|\.\d+|\d{1,2}%)'
-r_rgba = fr'\s*rgba\(\s*{_r_255}{_r_comma}{_r_255}{_r_comma}{_r_255}{_r_comma}{_r_alpha}\s*\)\s*'
-_r_h = r'(-?\d+(?:\.\d+)?|-?\.\d+)(deg|rad|turn)?'
-_r_sl = r'(\d{1,3}(?:\.\d+)?)%'
-r_hsl = fr'\s*hsl\(\s*{_r_h}{_r_comma}{_r_sl}{_r_comma}{_r_sl}\s*\)\s*'
-r_hsla = fr'\s*hsl\(\s*{_r_h}{_r_comma}{_r_sl}{_r_comma}{_r_sl}{_r_comma}{_r_alpha}\s*\)\s*'
-
-# colors where the two hex characters are the same, if all colors match this the short version of hex colors can be used
-repeat_colors = {int(c * 2, 16) for c in '0123456789abcdef'}
-rads = 2 * math.pi
-
-
-class Color(Representation):
-    __slots__ = '_original', '_rgba'
-
-    def __init__(self, value: ColorType) -> None:
-        self._rgba: RGBA
-        self._original: ColorType
-        if isinstance(value, (tuple, list)):
-            self._rgba = parse_tuple(value)
-        elif isinstance(value, str):
-            self._rgba = parse_str(value)
-        elif isinstance(value, Color):
-            self._rgba = value._rgba
-            value = value._original
-        else:
-            raise ColorError(reason='value must be a tuple, list or string')
-
-        # if we've got here value must be a valid color
-        self._original = value
-
-    @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-        field_schema.update(type='string', format='color')
-
-    def original(self) -> ColorType:
-        """
-        Original value passed to Color
-        """
-        return self._original
-
-    def as_named(self, *, fallback: bool = False) -> str:
-        if self._rgba.alpha is None:
-            rgb = cast(Tuple[int, int, int], self.as_rgb_tuple())
-            try:
-                return COLORS_BY_VALUE[rgb]
-            except KeyError as e:
-                if fallback:
-                    return self.as_hex()
-                else:
-                    raise ValueError('no named color found, use fallback=True, as_hex() or as_rgb()') from e
-        else:
-            return self.as_hex()
-
-    def as_hex(self) -> str:
-        """
-        Hex string representing the color can be 3, 4, 6 or 8 characters depending on whether the string
-        a "short" representation of the color is possible and whether there's an alpha channel.
-        """
-        values = [float_to_255(c) for c in self._rgba[:3]]
-        if self._rgba.alpha is not None:
-            values.append(float_to_255(self._rgba.alpha))
-
-        as_hex = ''.join(f'{v:02x}' for v in values)
-        if all(c in repeat_colors for c in values):
-            as_hex = ''.join(as_hex[c] for c in range(0, len(as_hex), 2))
-        return '#' + as_hex
-
-    def as_rgb(self) -> str:
-        """
-        Color as an rgb(<r>, <g>, <b>) or rgba(<r>, <g>, <b>, <a>) string.
-        """
-        if self._rgba.alpha is None:
-            return f'rgb({float_to_255(self._rgba.r)}, {float_to_255(self._rgba.g)}, {float_to_255(self._rgba.b)})'
-        else:
-            return (
-                f'rgba({float_to_255(self._rgba.r)}, {float_to_255(self._rgba.g)}, {float_to_255(self._rgba.b)}, '
-                f'{round(self._alpha_float(), 2)})'
-            )
-
-    def as_rgb_tuple(self, *, alpha: Optional[bool] = None) -> ColorTuple:
-        """
-        Color as an RGB or RGBA tuple; red, green and blue are in the range 0 to 255, alpha if included is
-        in the range 0 to 1.
-
-        :param alpha: whether to include the alpha channel, options are
-          None - (default) include alpha only if it's set (e.g. not None)
-          True - always include alpha,
-          False - always omit alpha,
-        """
-        r, g, b = (float_to_255(c) for c in self._rgba[:3])
-        if alpha is None:
-            if self._rgba.alpha is None:
-                return r, g, b
-            else:
-                return r, g, b, self._alpha_float()
-        elif alpha:
-            return r, g, b, self._alpha_float()
-        else:
-            # alpha is False
-            return r, g, b
-
-    def as_hsl(self) -> str:
-        """
-        Color as an hsl(<h>, <s>, <l>) or hsl(<h>, <s>, <l>, <a>) string.
-        """
-        if self._rgba.alpha is None:
-            h, s, li = self.as_hsl_tuple(alpha=False)  # type: ignore
-            return f'hsl({h * 360:0.0f}, {s:0.0%}, {li:0.0%})'
-        else:
-            h, s, li, a = self.as_hsl_tuple(alpha=True)  # type: ignore
-            return f'hsl({h * 360:0.0f}, {s:0.0%}, {li:0.0%}, {round(a, 2)})'
-
-    def as_hsl_tuple(self, *, alpha: Optional[bool] = None) -> HslColorTuple:
-        """
-        Color as an HSL or HSLA tuple, e.g. hue, saturation, lightness and optionally alpha; all elements are in
-        the range 0 to 1.
-
-        NOTE: this is HSL as used in HTML and most other places, not HLS as used in python's colorsys.
-
-        :param alpha: whether to include the alpha channel, options are
-          None - (default) include alpha only if it's set (e.g. not None)
-          True - always include alpha,
-          False - always omit alpha,
-        """
-        h, l, s = rgb_to_hls(self._rgba.r, self._rgba.g, self._rgba.b)
-        if alpha is None:
-            if self._rgba.alpha is None:
-                return h, s, l
-            else:
-                return h, s, l, self._alpha_float()
-        if alpha:
-            return h, s, l, self._alpha_float()
-        else:
-            # alpha is False
-            return h, s, l
-
-    def _alpha_float(self) -> float:
-        return 1 if self._rgba.alpha is None else self._rgba.alpha
-
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield cls
-
-    def __str__(self) -> str:
-        return self.as_named(fallback=True)
-
-    def __repr_args__(self) -> 'ReprArgs':
-        return [(None, self.as_named(fallback=True))] + [('rgb', self.as_rgb_tuple())]  # type: ignore
-
-    def __eq__(self, other: Any) -> bool:
-        return isinstance(other, Color) and self.as_rgb_tuple() == other.as_rgb_tuple()
-
-    def __hash__(self) -> int:
-        return hash(self.as_rgb_tuple())
-
-
-def parse_tuple(value: Tuple[Any, ...]) -> RGBA:
-    """
-    Parse a tuple or list as a color.
-    """
-    if len(value) == 3:
-        r, g, b = (parse_color_value(v) for v in value)
-        return RGBA(r, g, b, None)
-    elif len(value) == 4:
-        r, g, b = (parse_color_value(v) for v in value[:3])
-        return RGBA(r, g, b, parse_float_alpha(value[3]))
-    else:
-        raise ColorError(reason='tuples must have length 3 or 4')
-
-
-def parse_str(value: str) -> RGBA:
-    """
-    Parse a string to an RGBA tuple, trying the following formats (in this order):
-    * named color, see COLORS_BY_NAME below
-    * hex short eg. `<prefix>fff` (prefix can be `#`, `0x` or nothing)
-    * hex long eg. `<prefix>ffffff` (prefix can be `#`, `0x` or nothing)
-    * `rgb(<r>, <g>, <b>) `
-    * `rgba(<r>, <g>, <b>, <a>)`
-    """
-    value_lower = value.lower()
-    try:
-        r, g, b = COLORS_BY_NAME[value_lower]
-    except KeyError:
-        pass
-    else:
-        return ints_to_rgba(r, g, b, None)
-
-    m = re.fullmatch(r_hex_short, value_lower)
-    if m:
-        *rgb, a = m.groups()
-        r, g, b = (int(v * 2, 16) for v in rgb)
-        if a:
-            alpha: Optional[float] = int(a * 2, 16) / 255
-        else:
-            alpha = None
-        return ints_to_rgba(r, g, b, alpha)
-
-    m = re.fullmatch(r_hex_long, value_lower)
-    if m:
-        *rgb, a = m.groups()
-        r, g, b = (int(v, 16) for v in rgb)
-        if a:
-            alpha = int(a, 16) / 255
-        else:
-            alpha = None
-        return ints_to_rgba(r, g, b, alpha)
-
-    m = re.fullmatch(r_rgb, value_lower)
-    if m:
-        return ints_to_rgba(*m.groups(), None)  # type: ignore
-
-    m = re.fullmatch(r_rgba, value_lower)
-    if m:
-        return ints_to_rgba(*m.groups())  # type: ignore
-
-    m = re.fullmatch(r_hsl, value_lower)
-    if m:
-        h, h_units, s, l_ = m.groups()
-        return parse_hsl(h, h_units, s, l_)
-
-    m = re.fullmatch(r_hsla, value_lower)
-    if m:
-        h, h_units, s, l_, a = m.groups()
-        return parse_hsl(h, h_units, s, l_, parse_float_alpha(a))
-
-    raise ColorError(reason='string not recognised as a valid color')
-
-
-def ints_to_rgba(r: Union[int, str], g: Union[int, str], b: Union[int, str], alpha: Optional[float]) -> RGBA:
-    return RGBA(parse_color_value(r), parse_color_value(g), parse_color_value(b), parse_float_alpha(alpha))
-
-
-def parse_color_value(value: Union[int, str], max_val: int = 255) -> float:
-    """
-    Parse a value checking it's a valid int in the range 0 to max_val and divide by max_val to give a number
-    in the range 0 to 1
-    """
-    try:
-        color = float(value)
-    except ValueError:
-        raise ColorError(reason='color values must be a valid number')
-    if 0 <= color <= max_val:
-        return color / max_val
-    else:
-        raise ColorError(reason=f'color values must be in the range 0 to {max_val}')
-
-
-def parse_float_alpha(value: Union[None, str, float, int]) -> Optional[float]:
-    """
-    Parse a value checking it's a valid float in the range 0 to 1
-    """
-    if value is None:
-        return None
-    try:
-        if isinstance(value, str) and value.endswith('%'):
-            alpha = float(value[:-1]) / 100
-        else:
-            alpha = float(value)
-    except ValueError:
-        raise ColorError(reason='alpha values must be a valid float')
-
-    if almost_equal_floats(alpha, 1):
-        return None
-    elif 0 <= alpha <= 1:
-        return alpha
-    else:
-        raise ColorError(reason='alpha values must be in the range 0 to 1')
-
-
-def parse_hsl(h: str, h_units: str, sat: str, light: str, alpha: Optional[float] = None) -> RGBA:
-    """
-    Parse raw hue, saturation, lightness and alpha values and convert to RGBA.
-    """
-    s_value, l_value = parse_color_value(sat, 100), parse_color_value(light, 100)
-
-    h_value = float(h)
-    if h_units in {None, 'deg'}:
-        h_value = h_value % 360 / 360
-    elif h_units == 'rad':
-        h_value = h_value % rads / rads
-    else:
-        # turns
-        h_value = h_value % 1
-
-    r, g, b = hls_to_rgb(h_value, l_value, s_value)
-    return RGBA(r, g, b, alpha)
-
-
-def float_to_255(c: float) -> int:
-    return int(round(c * 255))
-
-
-COLORS_BY_NAME = {
-    'aliceblue': (240, 248, 255),
-    'antiquewhite': (250, 235, 215),
-    'aqua': (0, 255, 255),
-    'aquamarine': (127, 255, 212),
-    'azure': (240, 255, 255),
-    'beige': (245, 245, 220),
-    'bisque': (255, 228, 196),
-    'black': (0, 0, 0),
-    'blanchedalmond': (255, 235, 205),
-    'blue': (0, 0, 255),
-    'blueviolet': (138, 43, 226),
-    'brown': (165, 42, 42),
-    'burlywood': (222, 184, 135),
-    'cadetblue': (95, 158, 160),
-    'chartreuse': (127, 255, 0),
-    'chocolate': (210, 105, 30),
-    'coral': (255, 127, 80),
-    'cornflowerblue': (100, 149, 237),
-    'cornsilk': (255, 248, 220),
-    'crimson': (220, 20, 60),
-    'cyan': (0, 255, 255),
-    'darkblue': (0, 0, 139),
-    'darkcyan': (0, 139, 139),
-    'darkgoldenrod': (184, 134, 11),
-    'darkgray': (169, 169, 169),
-    'darkgreen': (0, 100, 0),
-    'darkgrey': (169, 169, 169),
-    'darkkhaki': (189, 183, 107),
-    'darkmagenta': (139, 0, 139),
-    'darkolivegreen': (85, 107, 47),
-    'darkorange': (255, 140, 0),
-    'darkorchid': (153, 50, 204),
-    'darkred': (139, 0, 0),
-    'darksalmon': (233, 150, 122),
-    'darkseagreen': (143, 188, 143),
-    'darkslateblue': (72, 61, 139),
-    'darkslategray': (47, 79, 79),
-    'darkslategrey': (47, 79, 79),
-    'darkturquoise': (0, 206, 209),
-    'darkviolet': (148, 0, 211),
-    'deeppink': (255, 20, 147),
-    'deepskyblue': (0, 191, 255),
-    'dimgray': (105, 105, 105),
-    'dimgrey': (105, 105, 105),
-    'dodgerblue': (30, 144, 255),
-    'firebrick': (178, 34, 34),
-    'floralwhite': (255, 250, 240),
-    'forestgreen': (34, 139, 34),
-    'fuchsia': (255, 0, 255),
-    'gainsboro': (220, 220, 220),
-    'ghostwhite': (248, 248, 255),
-    'gold': (255, 215, 0),
-    'goldenrod': (218, 165, 32),
-    'gray': (128, 128, 128),
-    'green': (0, 128, 0),
-    'greenyellow': (173, 255, 47),
-    'grey': (128, 128, 128),
-    'honeydew': (240, 255, 240),
-    'hotpink': (255, 105, 180),
-    'indianred': (205, 92, 92),
-    'indigo': (75, 0, 130),
-    'ivory': (255, 255, 240),
-    'khaki': (240, 230, 140),
-    'lavender': (230, 230, 250),
-    'lavenderblush': (255, 240, 245),
-    'lawngreen': (124, 252, 0),
-    'lemonchiffon': (255, 250, 205),
-    'lightblue': (173, 216, 230),
-    'lightcoral': (240, 128, 128),
-    'lightcyan': (224, 255, 255),
-    'lightgoldenrodyellow': (250, 250, 210),
-    'lightgray': (211, 211, 211),
-    'lightgreen': (144, 238, 144),
-    'lightgrey': (211, 211, 211),
-    'lightpink': (255, 182, 193),
-    'lightsalmon': (255, 160, 122),
-    'lightseagreen': (32, 178, 170),
-    'lightskyblue': (135, 206, 250),
-    'lightslategray': (119, 136, 153),
-    'lightslategrey': (119, 136, 153),
-    'lightsteelblue': (176, 196, 222),
-    'lightyellow': (255, 255, 224),
-    'lime': (0, 255, 0),
-    'limegreen': (50, 205, 50),
-    'linen': (250, 240, 230),
-    'magenta': (255, 0, 255),
-    'maroon': (128, 0, 0),
-    'mediumaquamarine': (102, 205, 170),
-    'mediumblue': (0, 0, 205),
-    'mediumorchid': (186, 85, 211),
-    'mediumpurple': (147, 112, 219),
-    'mediumseagreen': (60, 179, 113),
-    'mediumslateblue': (123, 104, 238),
-    'mediumspringgreen': (0, 250, 154),
-    'mediumturquoise': (72, 209, 204),
-    'mediumvioletred': (199, 21, 133),
-    'midnightblue': (25, 25, 112),
-    'mintcream': (245, 255, 250),
-    'mistyrose': (255, 228, 225),
-    'moccasin': (255, 228, 181),
-    'navajowhite': (255, 222, 173),
-    'navy': (0, 0, 128),
-    'oldlace': (253, 245, 230),
-    'olive': (128, 128, 0),
-    'olivedrab': (107, 142, 35),
-    'orange': (255, 165, 0),
-    'orangered': (255, 69, 0),
-    'orchid': (218, 112, 214),
-    'palegoldenrod': (238, 232, 170),
-    'palegreen': (152, 251, 152),
-    'paleturquoise': (175, 238, 238),
-    'palevioletred': (219, 112, 147),
-    'papayawhip': (255, 239, 213),
-    'peachpuff': (255, 218, 185),
-    'peru': (205, 133, 63),
-    'pink': (255, 192, 203),
-    'plum': (221, 160, 221),
-    'powderblue': (176, 224, 230),
-    'purple': (128, 0, 128),
-    'red': (255, 0, 0),
-    'rosybrown': (188, 143, 143),
-    'royalblue': (65, 105, 225),
-    'saddlebrown': (139, 69, 19),
-    'salmon': (250, 128, 114),
-    'sandybrown': (244, 164, 96),
-    'seagreen': (46, 139, 87),
-    'seashell': (255, 245, 238),
-    'sienna': (160, 82, 45),
-    'silver': (192, 192, 192),
-    'skyblue': (135, 206, 235),
-    'slateblue': (106, 90, 205),
-    'slategray': (112, 128, 144),
-    'slategrey': (112, 128, 144),
-    'snow': (255, 250, 250),
-    'springgreen': (0, 255, 127),
-    'steelblue': (70, 130, 180),
-    'tan': (210, 180, 140),
-    'teal': (0, 128, 128),
-    'thistle': (216, 191, 216),
-    'tomato': (255, 99, 71),
-    'turquoise': (64, 224, 208),
-    'violet': (238, 130, 238),
-    'wheat': (245, 222, 179),
-    'white': (255, 255, 255),
-    'whitesmoke': (245, 245, 245),
-    'yellow': (255, 255, 0),
-    'yellowgreen': (154, 205, 50),
-}
-
-COLORS_BY_VALUE = {v: k for k, v in COLORS_BY_NAME.items()}
diff --git a/lib/pydantic/v1/config.py b/lib/pydantic/v1/config.py
deleted file mode 100644
index a25973af..00000000
--- a/lib/pydantic/v1/config.py
+++ /dev/null
@@ -1,191 +0,0 @@
-import json
-from enum import Enum
-from typing import TYPE_CHECKING, Any, Callable, Dict, ForwardRef, Optional, Tuple, Type, Union
-
-from typing_extensions import Literal, Protocol
-
-from .typing import AnyArgTCallable, AnyCallable
-from .utils import GetterDict
-from .version import compiled
-
-if TYPE_CHECKING:
-    from typing import overload
-
-    from .fields import ModelField
-    from .main import BaseModel
-
-    ConfigType = Type['BaseConfig']
-
-    class SchemaExtraCallable(Protocol):
-        @overload
-        def __call__(self, schema: Dict[str, Any]) -> None:
-            pass
-
-        @overload
-        def __call__(self, schema: Dict[str, Any], model_class: Type[BaseModel]) -> None:
-            pass
-
-else:
-    SchemaExtraCallable = Callable[..., None]
-
-__all__ = 'BaseConfig', 'ConfigDict', 'get_config', 'Extra', 'inherit_config', 'prepare_config'
-
-
-class Extra(str, Enum):
-    allow = 'allow'
-    ignore = 'ignore'
-    forbid = 'forbid'
-
-
-# https://github.com/cython/cython/issues/4003
-# Fixed in Cython 3 and Pydantic v1 won't support Cython 3.
-# Pydantic v2 doesn't depend on Cython at all.
-if not compiled:
-    from typing_extensions import TypedDict
-
-    class ConfigDict(TypedDict, total=False):
-        title: Optional[str]
-        anystr_lower: bool
-        anystr_strip_whitespace: bool
-        min_anystr_length: int
-        max_anystr_length: Optional[int]
-        validate_all: bool
-        extra: Extra
-        allow_mutation: bool
-        frozen: bool
-        allow_population_by_field_name: bool
-        use_enum_values: bool
-        fields: Dict[str, Union[str, Dict[str, str]]]
-        validate_assignment: bool
-        error_msg_templates: Dict[str, str]
-        arbitrary_types_allowed: bool
-        orm_mode: bool
-        getter_dict: Type[GetterDict]
-        alias_generator: Optional[Callable[[str], str]]
-        keep_untouched: Tuple[type, ...]
-        schema_extra: Union[Dict[str, object], 'SchemaExtraCallable']
-        json_loads: Callable[[str], object]
-        json_dumps: AnyArgTCallable[str]
-        json_encoders: Dict[Type[object], AnyCallable]
-        underscore_attrs_are_private: bool
-        allow_inf_nan: bool
-        copy_on_model_validation: Literal['none', 'deep', 'shallow']
-        # whether dataclass `__post_init__` should be run after validation
-        post_init_call: Literal['before_validation', 'after_validation']
-
-else:
-    ConfigDict = dict  # type: ignore
-
-
-class BaseConfig:
-    title: Optional[str] = None
-    anystr_lower: bool = False
-    anystr_upper: bool = False
-    anystr_strip_whitespace: bool = False
-    min_anystr_length: int = 0
-    max_anystr_length: Optional[int] = None
-    validate_all: bool = False
-    extra: Extra = Extra.ignore
-    allow_mutation: bool = True
-    frozen: bool = False
-    allow_population_by_field_name: bool = False
-    use_enum_values: bool = False
-    fields: Dict[str, Union[str, Dict[str, str]]] = {}
-    validate_assignment: bool = False
-    error_msg_templates: Dict[str, str] = {}
-    arbitrary_types_allowed: bool = False
-    orm_mode: bool = False
-    getter_dict: Type[GetterDict] = GetterDict
-    alias_generator: Optional[Callable[[str], str]] = None
-    keep_untouched: Tuple[type, ...] = ()
-    schema_extra: Union[Dict[str, Any], 'SchemaExtraCallable'] = {}
-    json_loads: Callable[[str], Any] = json.loads
-    json_dumps: Callable[..., str] = json.dumps
-    json_encoders: Dict[Union[Type[Any], str, ForwardRef], AnyCallable] = {}
-    underscore_attrs_are_private: bool = False
-    allow_inf_nan: bool = True
-
-    # whether inherited models as fields should be reconstructed as base model,
-    # and whether such a copy should be shallow or deep
-    copy_on_model_validation: Literal['none', 'deep', 'shallow'] = 'shallow'
-
-    # whether `Union` should check all allowed types before even trying to coerce
-    smart_union: bool = False
-    # whether dataclass `__post_init__` should be run before or after validation
-    post_init_call: Literal['before_validation', 'after_validation'] = 'before_validation'
-
-    @classmethod
-    def get_field_info(cls, name: str) -> Dict[str, Any]:
-        """
-        Get properties of FieldInfo from the `fields` property of the config class.
-        """
-
-        fields_value = cls.fields.get(name)
-
-        if isinstance(fields_value, str):
-            field_info: Dict[str, Any] = {'alias': fields_value}
-        elif isinstance(fields_value, dict):
-            field_info = fields_value
-        else:
-            field_info = {}
-
-        if 'alias' in field_info:
-            field_info.setdefault('alias_priority', 2)
-
-        if field_info.get('alias_priority', 0) <= 1 and cls.alias_generator:
-            alias = cls.alias_generator(name)
-            if not isinstance(alias, str):
-                raise TypeError(f'Config.alias_generator must return str, not {alias.__class__}')
-            field_info.update(alias=alias, alias_priority=1)
-        return field_info
-
-    @classmethod
-    def prepare_field(cls, field: 'ModelField') -> None:
-        """
-        Optional hook to check or modify fields during model creation.
-        """
-        pass
-
-
-def get_config(config: Union[ConfigDict, Type[object], None]) -> Type[BaseConfig]:
-    if config is None:
-        return BaseConfig
-
-    else:
-        config_dict = (
-            config
-            if isinstance(config, dict)
-            else {k: getattr(config, k) for k in dir(config) if not k.startswith('__')}
-        )
-
-        class Config(BaseConfig):
-            ...
-
-        for k, v in config_dict.items():
-            setattr(Config, k, v)
-        return Config
-
-
-def inherit_config(self_config: 'ConfigType', parent_config: 'ConfigType', **namespace: Any) -> 'ConfigType':
-    if not self_config:
-        base_classes: Tuple['ConfigType', ...] = (parent_config,)
-    elif self_config == parent_config:
-        base_classes = (self_config,)
-    else:
-        base_classes = self_config, parent_config
-
-    namespace['json_encoders'] = {
-        **getattr(parent_config, 'json_encoders', {}),
-        **getattr(self_config, 'json_encoders', {}),
-        **namespace.get('json_encoders', {}),
-    }
-
-    return type('Config', base_classes, namespace)
-
-
-def prepare_config(config: Type[BaseConfig], cls_name: str) -> None:
-    if not isinstance(config.extra, Extra):
-        try:
-            config.extra = Extra(config.extra)
-        except ValueError:
-            raise ValueError(f'"{cls_name}": {config.extra} is not a valid value for "extra"')
diff --git a/lib/pydantic/v1/dataclasses.py b/lib/pydantic/v1/dataclasses.py
deleted file mode 100644
index 2df3987a..00000000
--- a/lib/pydantic/v1/dataclasses.py
+++ /dev/null
@@ -1,500 +0,0 @@
-"""
-The main purpose is to enhance stdlib dataclasses by adding validation
-A pydantic dataclass can be generated from scratch or from a stdlib one.
-
-Behind the scene, a pydantic dataclass is just like a regular one on which we attach
-a `BaseModel` and magic methods to trigger the validation of the data.
-`__init__` and `__post_init__` are hence overridden and have extra logic to be
-able to validate input data.
-
-When a pydantic dataclass is generated from scratch, it's just a plain dataclass
-with validation triggered at initialization
-
-The tricky part if for stdlib dataclasses that are converted after into pydantic ones e.g.
-
-```py
-@dataclasses.dataclass
-class M:
-    x: int
-
-ValidatedM = pydantic.dataclasses.dataclass(M)
-```
-
-We indeed still want to support equality, hashing, repr, ... as if it was the stdlib one!
-
-```py
-assert isinstance(ValidatedM(x=1), M)
-assert ValidatedM(x=1) == M(x=1)
-```
-
-This means we **don't want to create a new dataclass that inherits from it**
-The trick is to create a wrapper around `M` that will act as a proxy to trigger
-validation without altering default `M` behaviour.
-"""
-import copy
-import dataclasses
-import sys
-from contextlib import contextmanager
-from functools import wraps
-
-try:
-    from functools import cached_property
-except ImportError:
-    # cached_property available only for python3.8+
-    pass
-
-from typing import TYPE_CHECKING, Any, Callable, ClassVar, Dict, Generator, Optional, Type, TypeVar, Union, overload
-
-from typing_extensions import dataclass_transform
-
-from .class_validators import gather_all_validators
-from .config import BaseConfig, ConfigDict, Extra, get_config
-from .error_wrappers import ValidationError
-from .errors import DataclassTypeError
-from .fields import Field, FieldInfo, Required, Undefined
-from .main import create_model, validate_model
-from .utils import ClassAttribute
-
-if TYPE_CHECKING:
-    from .main import BaseModel
-    from .typing import CallableGenerator, NoArgAnyCallable
-
-    DataclassT = TypeVar('DataclassT', bound='Dataclass')
-
-    DataclassClassOrWrapper = Union[Type['Dataclass'], 'DataclassProxy']
-
-    class Dataclass:
-        # stdlib attributes
-        __dataclass_fields__: ClassVar[Dict[str, Any]]
-        __dataclass_params__: ClassVar[Any]  # in reality `dataclasses._DataclassParams`
-        __post_init__: ClassVar[Callable[..., None]]
-
-        # Added by pydantic
-        __pydantic_run_validation__: ClassVar[bool]
-        __post_init_post_parse__: ClassVar[Callable[..., None]]
-        __pydantic_initialised__: ClassVar[bool]
-        __pydantic_model__: ClassVar[Type[BaseModel]]
-        __pydantic_validate_values__: ClassVar[Callable[['Dataclass'], None]]
-        __pydantic_has_field_info_default__: ClassVar[bool]  # whether a `pydantic.Field` is used as default value
-
-        def __init__(self, *args: object, **kwargs: object) -> None:
-            pass
-
-        @classmethod
-        def __get_validators__(cls: Type['Dataclass']) -> 'CallableGenerator':
-            pass
-
-        @classmethod
-        def __validate__(cls: Type['DataclassT'], v: Any) -> 'DataclassT':
-            pass
-
-
-__all__ = [
-    'dataclass',
-    'set_validation',
-    'create_pydantic_model_from_dataclass',
-    'is_builtin_dataclass',
-    'make_dataclass_validator',
-]
-
-_T = TypeVar('_T')
-
-if sys.version_info >= (3, 10):
-
-    @dataclass_transform(field_specifiers=(dataclasses.field, Field))
-    @overload
-    def dataclass(
-        *,
-        init: bool = True,
-        repr: bool = True,
-        eq: bool = True,
-        order: bool = False,
-        unsafe_hash: bool = False,
-        frozen: bool = False,
-        config: Union[ConfigDict, Type[object], None] = None,
-        validate_on_init: Optional[bool] = None,
-        use_proxy: Optional[bool] = None,
-        kw_only: bool = ...,
-    ) -> Callable[[Type[_T]], 'DataclassClassOrWrapper']:
-        ...
-
-    @dataclass_transform(field_specifiers=(dataclasses.field, Field))
-    @overload
-    def dataclass(
-        _cls: Type[_T],
-        *,
-        init: bool = True,
-        repr: bool = True,
-        eq: bool = True,
-        order: bool = False,
-        unsafe_hash: bool = False,
-        frozen: bool = False,
-        config: Union[ConfigDict, Type[object], None] = None,
-        validate_on_init: Optional[bool] = None,
-        use_proxy: Optional[bool] = None,
-        kw_only: bool = ...,
-    ) -> 'DataclassClassOrWrapper':
-        ...
-
-else:
-
-    @dataclass_transform(field_specifiers=(dataclasses.field, Field))
-    @overload
-    def dataclass(
-        *,
-        init: bool = True,
-        repr: bool = True,
-        eq: bool = True,
-        order: bool = False,
-        unsafe_hash: bool = False,
-        frozen: bool = False,
-        config: Union[ConfigDict, Type[object], None] = None,
-        validate_on_init: Optional[bool] = None,
-        use_proxy: Optional[bool] = None,
-    ) -> Callable[[Type[_T]], 'DataclassClassOrWrapper']:
-        ...
-
-    @dataclass_transform(field_specifiers=(dataclasses.field, Field))
-    @overload
-    def dataclass(
-        _cls: Type[_T],
-        *,
-        init: bool = True,
-        repr: bool = True,
-        eq: bool = True,
-        order: bool = False,
-        unsafe_hash: bool = False,
-        frozen: bool = False,
-        config: Union[ConfigDict, Type[object], None] = None,
-        validate_on_init: Optional[bool] = None,
-        use_proxy: Optional[bool] = None,
-    ) -> 'DataclassClassOrWrapper':
-        ...
-
-
-@dataclass_transform(field_specifiers=(dataclasses.field, Field))
-def dataclass(
-    _cls: Optional[Type[_T]] = None,
-    *,
-    init: bool = True,
-    repr: bool = True,
-    eq: bool = True,
-    order: bool = False,
-    unsafe_hash: bool = False,
-    frozen: bool = False,
-    config: Union[ConfigDict, Type[object], None] = None,
-    validate_on_init: Optional[bool] = None,
-    use_proxy: Optional[bool] = None,
-    kw_only: bool = False,
-) -> Union[Callable[[Type[_T]], 'DataclassClassOrWrapper'], 'DataclassClassOrWrapper']:
-    """
-    Like the python standard lib dataclasses but with type validation.
-    The result is either a pydantic dataclass that will validate input data
-    or a wrapper that will trigger validation around a stdlib dataclass
-    to avoid modifying it directly
-    """
-    the_config = get_config(config)
-
-    def wrap(cls: Type[Any]) -> 'DataclassClassOrWrapper':
-        should_use_proxy = (
-            use_proxy
-            if use_proxy is not None
-            else (
-                is_builtin_dataclass(cls)
-                and (cls.__bases__[0] is object or set(dir(cls)) == set(dir(cls.__bases__[0])))
-            )
-        )
-        if should_use_proxy:
-            dc_cls_doc = ''
-            dc_cls = DataclassProxy(cls)
-            default_validate_on_init = False
-        else:
-            dc_cls_doc = cls.__doc__ or ''  # needs to be done before generating dataclass
-            if sys.version_info >= (3, 10):
-                dc_cls = dataclasses.dataclass(
-                    cls,
-                    init=init,
-                    repr=repr,
-                    eq=eq,
-                    order=order,
-                    unsafe_hash=unsafe_hash,
-                    frozen=frozen,
-                    kw_only=kw_only,
-                )
-            else:
-                dc_cls = dataclasses.dataclass(  # type: ignore
-                    cls, init=init, repr=repr, eq=eq, order=order, unsafe_hash=unsafe_hash, frozen=frozen
-                )
-            default_validate_on_init = True
-
-        should_validate_on_init = default_validate_on_init if validate_on_init is None else validate_on_init
-        _add_pydantic_validation_attributes(cls, the_config, should_validate_on_init, dc_cls_doc)
-        dc_cls.__pydantic_model__.__try_update_forward_refs__(**{cls.__name__: cls})
-        return dc_cls
-
-    if _cls is None:
-        return wrap
-
-    return wrap(_cls)
-
-
-@contextmanager
-def set_validation(cls: Type['DataclassT'], value: bool) -> Generator[Type['DataclassT'], None, None]:
-    original_run_validation = cls.__pydantic_run_validation__
-    try:
-        cls.__pydantic_run_validation__ = value
-        yield cls
-    finally:
-        cls.__pydantic_run_validation__ = original_run_validation
-
-
-class DataclassProxy:
-    __slots__ = '__dataclass__'
-
-    def __init__(self, dc_cls: Type['Dataclass']) -> None:
-        object.__setattr__(self, '__dataclass__', dc_cls)
-
-    def __call__(self, *args: Any, **kwargs: Any) -> Any:
-        with set_validation(self.__dataclass__, True):
-            return self.__dataclass__(*args, **kwargs)
-
-    def __getattr__(self, name: str) -> Any:
-        return getattr(self.__dataclass__, name)
-
-    def __setattr__(self, __name: str, __value: Any) -> None:
-        return setattr(self.__dataclass__, __name, __value)
-
-    def __instancecheck__(self, instance: Any) -> bool:
-        return isinstance(instance, self.__dataclass__)
-
-    def __copy__(self) -> 'DataclassProxy':
-        return DataclassProxy(copy.copy(self.__dataclass__))
-
-    def __deepcopy__(self, memo: Any) -> 'DataclassProxy':
-        return DataclassProxy(copy.deepcopy(self.__dataclass__, memo))
-
-
-def _add_pydantic_validation_attributes(  # noqa: C901 (ignore complexity)
-    dc_cls: Type['Dataclass'],
-    config: Type[BaseConfig],
-    validate_on_init: bool,
-    dc_cls_doc: str,
-) -> None:
-    """
-    We need to replace the right method. If no `__post_init__` has been set in the stdlib dataclass
-    it won't even exist (code is generated on the fly by `dataclasses`)
-    By default, we run validation after `__init__` or `__post_init__` if defined
-    """
-    init = dc_cls.__init__
-
-    @wraps(init)
-    def handle_extra_init(self: 'Dataclass', *args: Any, **kwargs: Any) -> None:
-        if config.extra == Extra.ignore:
-            init(self, *args, **{k: v for k, v in kwargs.items() if k in self.__dataclass_fields__})
-
-        elif config.extra == Extra.allow:
-            for k, v in kwargs.items():
-                self.__dict__.setdefault(k, v)
-            init(self, *args, **{k: v for k, v in kwargs.items() if k in self.__dataclass_fields__})
-
-        else:
-            init(self, *args, **kwargs)
-
-    if hasattr(dc_cls, '__post_init__'):
-        try:
-            post_init = dc_cls.__post_init__.__wrapped__  # type: ignore[attr-defined]
-        except AttributeError:
-            post_init = dc_cls.__post_init__
-
-        @wraps(post_init)
-        def new_post_init(self: 'Dataclass', *args: Any, **kwargs: Any) -> None:
-            if config.post_init_call == 'before_validation':
-                post_init(self, *args, **kwargs)
-
-            if self.__class__.__pydantic_run_validation__:
-                self.__pydantic_validate_values__()
-                if hasattr(self, '__post_init_post_parse__'):
-                    self.__post_init_post_parse__(*args, **kwargs)
-
-            if config.post_init_call == 'after_validation':
-                post_init(self, *args, **kwargs)
-
-        setattr(dc_cls, '__init__', handle_extra_init)
-        setattr(dc_cls, '__post_init__', new_post_init)
-
-    else:
-
-        @wraps(init)
-        def new_init(self: 'Dataclass', *args: Any, **kwargs: Any) -> None:
-            handle_extra_init(self, *args, **kwargs)
-
-            if self.__class__.__pydantic_run_validation__:
-                self.__pydantic_validate_values__()
-
-            if hasattr(self, '__post_init_post_parse__'):
-                # We need to find again the initvars. To do that we use `__dataclass_fields__` instead of
-                # public method `dataclasses.fields`
-
-                # get all initvars and their default values
-                initvars_and_values: Dict[str, Any] = {}
-                for i, f in enumerate(self.__class__.__dataclass_fields__.values()):
-                    if f._field_type is dataclasses._FIELD_INITVAR:  # type: ignore[attr-defined]
-                        try:
-                            # set arg value by default
-                            initvars_and_values[f.name] = args[i]
-                        except IndexError:
-                            initvars_and_values[f.name] = kwargs.get(f.name, f.default)
-
-                self.__post_init_post_parse__(**initvars_and_values)
-
-        setattr(dc_cls, '__init__', new_init)
-
-    setattr(dc_cls, '__pydantic_run_validation__', ClassAttribute('__pydantic_run_validation__', validate_on_init))
-    setattr(dc_cls, '__pydantic_initialised__', False)
-    setattr(dc_cls, '__pydantic_model__', create_pydantic_model_from_dataclass(dc_cls, config, dc_cls_doc))
-    setattr(dc_cls, '__pydantic_validate_values__', _dataclass_validate_values)
-    setattr(dc_cls, '__validate__', classmethod(_validate_dataclass))
-    setattr(dc_cls, '__get_validators__', classmethod(_get_validators))
-
-    if dc_cls.__pydantic_model__.__config__.validate_assignment and not dc_cls.__dataclass_params__.frozen:
-        setattr(dc_cls, '__setattr__', _dataclass_validate_assignment_setattr)
-
-
-def _get_validators(cls: 'DataclassClassOrWrapper') -> 'CallableGenerator':
-    yield cls.__validate__
-
-
-def _validate_dataclass(cls: Type['DataclassT'], v: Any) -> 'DataclassT':
-    with set_validation(cls, True):
-        if isinstance(v, cls):
-            v.__pydantic_validate_values__()
-            return v
-        elif isinstance(v, (list, tuple)):
-            return cls(*v)
-        elif isinstance(v, dict):
-            return cls(**v)
-        else:
-            raise DataclassTypeError(class_name=cls.__name__)
-
-
-def create_pydantic_model_from_dataclass(
-    dc_cls: Type['Dataclass'],
-    config: Type[Any] = BaseConfig,
-    dc_cls_doc: Optional[str] = None,
-) -> Type['BaseModel']:
-    field_definitions: Dict[str, Any] = {}
-    for field in dataclasses.fields(dc_cls):
-        default: Any = Undefined
-        default_factory: Optional['NoArgAnyCallable'] = None
-        field_info: FieldInfo
-
-        if field.default is not dataclasses.MISSING:
-            default = field.default
-        elif field.default_factory is not dataclasses.MISSING:
-            default_factory = field.default_factory
-        else:
-            default = Required
-
-        if isinstance(default, FieldInfo):
-            field_info = default
-            dc_cls.__pydantic_has_field_info_default__ = True
-        else:
-            field_info = Field(default=default, default_factory=default_factory, **field.metadata)
-
-        field_definitions[field.name] = (field.type, field_info)
-
-    validators = gather_all_validators(dc_cls)
-    model: Type['BaseModel'] = create_model(
-        dc_cls.__name__,
-        __config__=config,
-        __module__=dc_cls.__module__,
-        __validators__=validators,
-        __cls_kwargs__={'__resolve_forward_refs__': False},
-        **field_definitions,
-    )
-    model.__doc__ = dc_cls_doc if dc_cls_doc is not None else dc_cls.__doc__ or ''
-    return model
-
-
-if sys.version_info >= (3, 8):
-
-    def _is_field_cached_property(obj: 'Dataclass', k: str) -> bool:
-        return isinstance(getattr(type(obj), k, None), cached_property)
-
-else:
-
-    def _is_field_cached_property(obj: 'Dataclass', k: str) -> bool:
-        return False
-
-
-def _dataclass_validate_values(self: 'Dataclass') -> None:
-    # validation errors can occur if this function is called twice on an already initialised dataclass.
-    # for example if Extra.forbid is enabled, it would consider __pydantic_initialised__ an invalid extra property
-    if getattr(self, '__pydantic_initialised__'):
-        return
-    if getattr(self, '__pydantic_has_field_info_default__', False):
-        # We need to remove `FieldInfo` values since they are not valid as input
-        # It's ok to do that because they are obviously the default values!
-        input_data = {
-            k: v
-            for k, v in self.__dict__.items()
-            if not (isinstance(v, FieldInfo) or _is_field_cached_property(self, k))
-        }
-    else:
-        input_data = {k: v for k, v in self.__dict__.items() if not _is_field_cached_property(self, k)}
-    d, _, validation_error = validate_model(self.__pydantic_model__, input_data, cls=self.__class__)
-    if validation_error:
-        raise validation_error
-    self.__dict__.update(d)
-    object.__setattr__(self, '__pydantic_initialised__', True)
-
-
-def _dataclass_validate_assignment_setattr(self: 'Dataclass', name: str, value: Any) -> None:
-    if self.__pydantic_initialised__:
-        d = dict(self.__dict__)
-        d.pop(name, None)
-        known_field = self.__pydantic_model__.__fields__.get(name, None)
-        if known_field:
-            value, error_ = known_field.validate(value, d, loc=name, cls=self.__class__)
-            if error_:
-                raise ValidationError([error_], self.__class__)
-
-    object.__setattr__(self, name, value)
-
-
-def is_builtin_dataclass(_cls: Type[Any]) -> bool:
-    """
-    Whether a class is a stdlib dataclass
-    (useful to discriminated a pydantic dataclass that is actually a wrapper around a stdlib dataclass)
-
-    we check that
-    - `_cls` is a dataclass
-    - `_cls` is not a processed pydantic dataclass (with a basemodel attached)
-    - `_cls` is not a pydantic dataclass inheriting directly from a stdlib dataclass
-    e.g.
-    ```
-    @dataclasses.dataclass
-    class A:
-        x: int
-
-    @pydantic.dataclasses.dataclass
-    class B(A):
-        y: int
-    ```
-    In this case, when we first check `B`, we make an extra check and look at the annotations ('y'),
-    which won't be a superset of all the dataclass fields (only the stdlib fields i.e. 'x')
-    """
-    return (
-        dataclasses.is_dataclass(_cls)
-        and not hasattr(_cls, '__pydantic_model__')
-        and set(_cls.__dataclass_fields__).issuperset(set(getattr(_cls, '__annotations__', {})))
-    )
-
-
-def make_dataclass_validator(dc_cls: Type['Dataclass'], config: Type[BaseConfig]) -> 'CallableGenerator':
-    """
-    Create a pydantic.dataclass from a builtin dataclass to add type validation
-    and yield the validators
-    It retrieves the parameters of the dataclass and forwards them to the newly created dataclass
-    """
-    yield from _get_validators(dataclass(dc_cls, config=config, use_proxy=True))
diff --git a/lib/pydantic/v1/datetime_parse.py b/lib/pydantic/v1/datetime_parse.py
deleted file mode 100644
index cfd54593..00000000
--- a/lib/pydantic/v1/datetime_parse.py
+++ /dev/null
@@ -1,248 +0,0 @@
-"""
-Functions to parse datetime objects.
-
-We're using regular expressions rather than time.strptime because:
-- They provide both validation and parsing.
-- They're more flexible for datetimes.
-- The date/datetime/time constructors produce friendlier error messages.
-
-Stolen from https://raw.githubusercontent.com/django/django/main/django/utils/dateparse.py at
-9718fa2e8abe430c3526a9278dd976443d4ae3c6
-
-Changed to:
-* use standard python datetime types not django.utils.timezone
-* raise ValueError when regex doesn't match rather than returning None
-* support parsing unix timestamps for dates and datetimes
-"""
-import re
-from datetime import date, datetime, time, timedelta, timezone
-from typing import Dict, Optional, Type, Union
-
-from . import errors
-
-date_expr = r'(?P<year>\d{4})-(?P<month>\d{1,2})-(?P<day>\d{1,2})'
-time_expr = (
-    r'(?P<hour>\d{1,2}):(?P<minute>\d{1,2})'
-    r'(?::(?P<second>\d{1,2})(?:\.(?P<microsecond>\d{1,6})\d{0,6})?)?'
-    r'(?P<tzinfo>Z|[+-]\d{2}(?::?\d{2})?)?$'
-)
-
-date_re = re.compile(f'{date_expr}$')
-time_re = re.compile(time_expr)
-datetime_re = re.compile(f'{date_expr}[T ]{time_expr}')
-
-standard_duration_re = re.compile(
-    r'^'
-    r'(?:(?P<days>-?\d+) (days?, )?)?'
-    r'((?:(?P<hours>-?\d+):)(?=\d+:\d+))?'
-    r'(?:(?P<minutes>-?\d+):)?'
-    r'(?P<seconds>-?\d+)'
-    r'(?:\.(?P<microseconds>\d{1,6})\d{0,6})?'
-    r'$'
-)
-
-# Support the sections of ISO 8601 date representation that are accepted by timedelta
-iso8601_duration_re = re.compile(
-    r'^(?P<sign>[-+]?)'
-    r'P'
-    r'(?:(?P<days>\d+(.\d+)?)D)?'
-    r'(?:T'
-    r'(?:(?P<hours>\d+(.\d+)?)H)?'
-    r'(?:(?P<minutes>\d+(.\d+)?)M)?'
-    r'(?:(?P<seconds>\d+(.\d+)?)S)?'
-    r')?'
-    r'$'
-)
-
-EPOCH = datetime(1970, 1, 1)
-# if greater than this, the number is in ms, if less than or equal it's in seconds
-# (in seconds this is 11th October 2603, in ms it's 20th August 1970)
-MS_WATERSHED = int(2e10)
-# slightly more than datetime.max in ns - (datetime.max - EPOCH).total_seconds() * 1e9
-MAX_NUMBER = int(3e20)
-StrBytesIntFloat = Union[str, bytes, int, float]
-
-
-def get_numeric(value: StrBytesIntFloat, native_expected_type: str) -> Union[None, int, float]:
-    if isinstance(value, (int, float)):
-        return value
-    try:
-        return float(value)
-    except ValueError:
-        return None
-    except TypeError:
-        raise TypeError(f'invalid type; expected {native_expected_type}, string, bytes, int or float')
-
-
-def from_unix_seconds(seconds: Union[int, float]) -> datetime:
-    if seconds > MAX_NUMBER:
-        return datetime.max
-    elif seconds < -MAX_NUMBER:
-        return datetime.min
-
-    while abs(seconds) > MS_WATERSHED:
-        seconds /= 1000
-    dt = EPOCH + timedelta(seconds=seconds)
-    return dt.replace(tzinfo=timezone.utc)
-
-
-def _parse_timezone(value: Optional[str], error: Type[Exception]) -> Union[None, int, timezone]:
-    if value == 'Z':
-        return timezone.utc
-    elif value is not None:
-        offset_mins = int(value[-2:]) if len(value) > 3 else 0
-        offset = 60 * int(value[1:3]) + offset_mins
-        if value[0] == '-':
-            offset = -offset
-        try:
-            return timezone(timedelta(minutes=offset))
-        except ValueError:
-            raise error()
-    else:
-        return None
-
-
-def parse_date(value: Union[date, StrBytesIntFloat]) -> date:
-    """
-    Parse a date/int/float/string and return a datetime.date.
-
-    Raise ValueError if the input is well formatted but not a valid date.
-    Raise ValueError if the input isn't well formatted.
-    """
-    if isinstance(value, date):
-        if isinstance(value, datetime):
-            return value.date()
-        else:
-            return value
-
-    number = get_numeric(value, 'date')
-    if number is not None:
-        return from_unix_seconds(number).date()
-
-    if isinstance(value, bytes):
-        value = value.decode()
-
-    match = date_re.match(value)  # type: ignore
-    if match is None:
-        raise errors.DateError()
-
-    kw = {k: int(v) for k, v in match.groupdict().items()}
-
-    try:
-        return date(**kw)
-    except ValueError:
-        raise errors.DateError()
-
-
-def parse_time(value: Union[time, StrBytesIntFloat]) -> time:
-    """
-    Parse a time/string and return a datetime.time.
-
-    Raise ValueError if the input is well formatted but not a valid time.
-    Raise ValueError if the input isn't well formatted, in particular if it contains an offset.
-    """
-    if isinstance(value, time):
-        return value
-
-    number = get_numeric(value, 'time')
-    if number is not None:
-        if number >= 86400:
-            # doesn't make sense since the time time loop back around to 0
-            raise errors.TimeError()
-        return (datetime.min + timedelta(seconds=number)).time()
-
-    if isinstance(value, bytes):
-        value = value.decode()
-
-    match = time_re.match(value)  # type: ignore
-    if match is None:
-        raise errors.TimeError()
-
-    kw = match.groupdict()
-    if kw['microsecond']:
-        kw['microsecond'] = kw['microsecond'].ljust(6, '0')
-
-    tzinfo = _parse_timezone(kw.pop('tzinfo'), errors.TimeError)
-    kw_: Dict[str, Union[None, int, timezone]] = {k: int(v) for k, v in kw.items() if v is not None}
-    kw_['tzinfo'] = tzinfo
-
-    try:
-        return time(**kw_)  # type: ignore
-    except ValueError:
-        raise errors.TimeError()
-
-
-def parse_datetime(value: Union[datetime, StrBytesIntFloat]) -> datetime:
-    """
-    Parse a datetime/int/float/string and return a datetime.datetime.
-
-    This function supports time zone offsets. When the input contains one,
-    the output uses a timezone with a fixed offset from UTC.
-
-    Raise ValueError if the input is well formatted but not a valid datetime.
-    Raise ValueError if the input isn't well formatted.
-    """
-    if isinstance(value, datetime):
-        return value
-
-    number = get_numeric(value, 'datetime')
-    if number is not None:
-        return from_unix_seconds(number)
-
-    if isinstance(value, bytes):
-        value = value.decode()
-
-    match = datetime_re.match(value)  # type: ignore
-    if match is None:
-        raise errors.DateTimeError()
-
-    kw = match.groupdict()
-    if kw['microsecond']:
-        kw['microsecond'] = kw['microsecond'].ljust(6, '0')
-
-    tzinfo = _parse_timezone(kw.pop('tzinfo'), errors.DateTimeError)
-    kw_: Dict[str, Union[None, int, timezone]] = {k: int(v) for k, v in kw.items() if v is not None}
-    kw_['tzinfo'] = tzinfo
-
-    try:
-        return datetime(**kw_)  # type: ignore
-    except ValueError:
-        raise errors.DateTimeError()
-
-
-def parse_duration(value: StrBytesIntFloat) -> timedelta:
-    """
-    Parse a duration int/float/string and return a datetime.timedelta.
-
-    The preferred format for durations in Django is '%d %H:%M:%S.%f'.
-
-    Also supports ISO 8601 representation.
-    """
-    if isinstance(value, timedelta):
-        return value
-
-    if isinstance(value, (int, float)):
-        # below code requires a string
-        value = f'{value:f}'
-    elif isinstance(value, bytes):
-        value = value.decode()
-
-    try:
-        match = standard_duration_re.match(value) or iso8601_duration_re.match(value)
-    except TypeError:
-        raise TypeError('invalid type; expected timedelta, string, bytes, int or float')
-
-    if not match:
-        raise errors.DurationError()
-
-    kw = match.groupdict()
-    sign = -1 if kw.pop('sign', '+') == '-' else 1
-    if kw.get('microseconds'):
-        kw['microseconds'] = kw['microseconds'].ljust(6, '0')
-
-    if kw.get('seconds') and kw.get('microseconds') and kw['seconds'].startswith('-'):
-        kw['microseconds'] = '-' + kw['microseconds']
-
-    kw_ = {k: float(v) for k, v in kw.items() if v is not None}
-
-    return sign * timedelta(**kw_)
diff --git a/lib/pydantic/v1/decorator.py b/lib/pydantic/v1/decorator.py
deleted file mode 100644
index 089aab65..00000000
--- a/lib/pydantic/v1/decorator.py
+++ /dev/null
@@ -1,264 +0,0 @@
-from functools import wraps
-from typing import TYPE_CHECKING, Any, Callable, Dict, List, Mapping, Optional, Tuple, Type, TypeVar, Union, overload
-
-from . import validator
-from .config import Extra
-from .errors import ConfigError
-from .main import BaseModel, create_model
-from .typing import get_all_type_hints
-from .utils import to_camel
-
-__all__ = ('validate_arguments',)
-
-if TYPE_CHECKING:
-    from .typing import AnyCallable
-
-    AnyCallableT = TypeVar('AnyCallableT', bound=AnyCallable)
-    ConfigType = Union[None, Type[Any], Dict[str, Any]]
-
-
-@overload
-def validate_arguments(func: None = None, *, config: 'ConfigType' = None) -> Callable[['AnyCallableT'], 'AnyCallableT']:
-    ...
-
-
-@overload
-def validate_arguments(func: 'AnyCallableT') -> 'AnyCallableT':
-    ...
-
-
-def validate_arguments(func: Optional['AnyCallableT'] = None, *, config: 'ConfigType' = None) -> Any:
-    """
-    Decorator to validate the arguments passed to a function.
-    """
-
-    def validate(_func: 'AnyCallable') -> 'AnyCallable':
-        vd = ValidatedFunction(_func, config)
-
-        @wraps(_func)
-        def wrapper_function(*args: Any, **kwargs: Any) -> Any:
-            return vd.call(*args, **kwargs)
-
-        wrapper_function.vd = vd  # type: ignore
-        wrapper_function.validate = vd.init_model_instance  # type: ignore
-        wrapper_function.raw_function = vd.raw_function  # type: ignore
-        wrapper_function.model = vd.model  # type: ignore
-        return wrapper_function
-
-    if func:
-        return validate(func)
-    else:
-        return validate
-
-
-ALT_V_ARGS = 'v__args'
-ALT_V_KWARGS = 'v__kwargs'
-V_POSITIONAL_ONLY_NAME = 'v__positional_only'
-V_DUPLICATE_KWARGS = 'v__duplicate_kwargs'
-
-
-class ValidatedFunction:
-    def __init__(self, function: 'AnyCallableT', config: 'ConfigType'):  # noqa C901
-        from inspect import Parameter, signature
-
-        parameters: Mapping[str, Parameter] = signature(function).parameters
-
-        if parameters.keys() & {ALT_V_ARGS, ALT_V_KWARGS, V_POSITIONAL_ONLY_NAME, V_DUPLICATE_KWARGS}:
-            raise ConfigError(
-                f'"{ALT_V_ARGS}", "{ALT_V_KWARGS}", "{V_POSITIONAL_ONLY_NAME}" and "{V_DUPLICATE_KWARGS}" '
-                f'are not permitted as argument names when using the "{validate_arguments.__name__}" decorator'
-            )
-
-        self.raw_function = function
-        self.arg_mapping: Dict[int, str] = {}
-        self.positional_only_args = set()
-        self.v_args_name = 'args'
-        self.v_kwargs_name = 'kwargs'
-
-        type_hints = get_all_type_hints(function)
-        takes_args = False
-        takes_kwargs = False
-        fields: Dict[str, Tuple[Any, Any]] = {}
-        for i, (name, p) in enumerate(parameters.items()):
-            if p.annotation is p.empty:
-                annotation = Any
-            else:
-                annotation = type_hints[name]
-
-            default = ... if p.default is p.empty else p.default
-            if p.kind == Parameter.POSITIONAL_ONLY:
-                self.arg_mapping[i] = name
-                fields[name] = annotation, default
-                fields[V_POSITIONAL_ONLY_NAME] = List[str], None
-                self.positional_only_args.add(name)
-            elif p.kind == Parameter.POSITIONAL_OR_KEYWORD:
-                self.arg_mapping[i] = name
-                fields[name] = annotation, default
-                fields[V_DUPLICATE_KWARGS] = List[str], None
-            elif p.kind == Parameter.KEYWORD_ONLY:
-                fields[name] = annotation, default
-            elif p.kind == Parameter.VAR_POSITIONAL:
-                self.v_args_name = name
-                fields[name] = Tuple[annotation, ...], None
-                takes_args = True
-            else:
-                assert p.kind == Parameter.VAR_KEYWORD, p.kind
-                self.v_kwargs_name = name
-                fields[name] = Dict[str, annotation], None  # type: ignore
-                takes_kwargs = True
-
-        # these checks avoid a clash between "args" and a field with that name
-        if not takes_args and self.v_args_name in fields:
-            self.v_args_name = ALT_V_ARGS
-
-        # same with "kwargs"
-        if not takes_kwargs and self.v_kwargs_name in fields:
-            self.v_kwargs_name = ALT_V_KWARGS
-
-        if not takes_args:
-            # we add the field so validation below can raise the correct exception
-            fields[self.v_args_name] = List[Any], None
-
-        if not takes_kwargs:
-            # same with kwargs
-            fields[self.v_kwargs_name] = Dict[Any, Any], None
-
-        self.create_model(fields, takes_args, takes_kwargs, config)
-
-    def init_model_instance(self, *args: Any, **kwargs: Any) -> BaseModel:
-        values = self.build_values(args, kwargs)
-        return self.model(**values)
-
-    def call(self, *args: Any, **kwargs: Any) -> Any:
-        m = self.init_model_instance(*args, **kwargs)
-        return self.execute(m)
-
-    def build_values(self, args: Tuple[Any, ...], kwargs: Dict[str, Any]) -> Dict[str, Any]:
-        values: Dict[str, Any] = {}
-        if args:
-            arg_iter = enumerate(args)
-            while True:
-                try:
-                    i, a = next(arg_iter)
-                except StopIteration:
-                    break
-                arg_name = self.arg_mapping.get(i)
-                if arg_name is not None:
-                    values[arg_name] = a
-                else:
-                    values[self.v_args_name] = [a] + [a for _, a in arg_iter]
-                    break
-
-        var_kwargs: Dict[str, Any] = {}
-        wrong_positional_args = []
-        duplicate_kwargs = []
-        fields_alias = [
-            field.alias
-            for name, field in self.model.__fields__.items()
-            if name not in (self.v_args_name, self.v_kwargs_name)
-        ]
-        non_var_fields = set(self.model.__fields__) - {self.v_args_name, self.v_kwargs_name}
-        for k, v in kwargs.items():
-            if k in non_var_fields or k in fields_alias:
-                if k in self.positional_only_args:
-                    wrong_positional_args.append(k)
-                if k in values:
-                    duplicate_kwargs.append(k)
-                values[k] = v
-            else:
-                var_kwargs[k] = v
-
-        if var_kwargs:
-            values[self.v_kwargs_name] = var_kwargs
-        if wrong_positional_args:
-            values[V_POSITIONAL_ONLY_NAME] = wrong_positional_args
-        if duplicate_kwargs:
-            values[V_DUPLICATE_KWARGS] = duplicate_kwargs
-        return values
-
-    def execute(self, m: BaseModel) -> Any:
-        d = {k: v for k, v in m._iter() if k in m.__fields_set__ or m.__fields__[k].default_factory}
-        var_kwargs = d.pop(self.v_kwargs_name, {})
-
-        if self.v_args_name in d:
-            args_: List[Any] = []
-            in_kwargs = False
-            kwargs = {}
-            for name, value in d.items():
-                if in_kwargs:
-                    kwargs[name] = value
-                elif name == self.v_args_name:
-                    args_ += value
-                    in_kwargs = True
-                else:
-                    args_.append(value)
-            return self.raw_function(*args_, **kwargs, **var_kwargs)
-        elif self.positional_only_args:
-            args_ = []
-            kwargs = {}
-            for name, value in d.items():
-                if name in self.positional_only_args:
-                    args_.append(value)
-                else:
-                    kwargs[name] = value
-            return self.raw_function(*args_, **kwargs, **var_kwargs)
-        else:
-            return self.raw_function(**d, **var_kwargs)
-
-    def create_model(self, fields: Dict[str, Any], takes_args: bool, takes_kwargs: bool, config: 'ConfigType') -> None:
-        pos_args = len(self.arg_mapping)
-
-        class CustomConfig:
-            pass
-
-        if not TYPE_CHECKING:  # pragma: no branch
-            if isinstance(config, dict):
-                CustomConfig = type('Config', (), config)  # noqa: F811
-            elif config is not None:
-                CustomConfig = config  # noqa: F811
-
-        if hasattr(CustomConfig, 'fields') or hasattr(CustomConfig, 'alias_generator'):
-            raise ConfigError(
-                'Setting the "fields" and "alias_generator" property on custom Config for '
-                '@validate_arguments is not yet supported, please remove.'
-            )
-
-        class DecoratorBaseModel(BaseModel):
-            @validator(self.v_args_name, check_fields=False, allow_reuse=True)
-            def check_args(cls, v: Optional[List[Any]]) -> Optional[List[Any]]:
-                if takes_args or v is None:
-                    return v
-
-                raise TypeError(f'{pos_args} positional arguments expected but {pos_args + len(v)} given')
-
-            @validator(self.v_kwargs_name, check_fields=False, allow_reuse=True)
-            def check_kwargs(cls, v: Optional[Dict[str, Any]]) -> Optional[Dict[str, Any]]:
-                if takes_kwargs or v is None:
-                    return v
-
-                plural = '' if len(v) == 1 else 's'
-                keys = ', '.join(map(repr, v.keys()))
-                raise TypeError(f'unexpected keyword argument{plural}: {keys}')
-
-            @validator(V_POSITIONAL_ONLY_NAME, check_fields=False, allow_reuse=True)
-            def check_positional_only(cls, v: Optional[List[str]]) -> None:
-                if v is None:
-                    return
-
-                plural = '' if len(v) == 1 else 's'
-                keys = ', '.join(map(repr, v))
-                raise TypeError(f'positional-only argument{plural} passed as keyword argument{plural}: {keys}')
-
-            @validator(V_DUPLICATE_KWARGS, check_fields=False, allow_reuse=True)
-            def check_duplicate_kwargs(cls, v: Optional[List[str]]) -> None:
-                if v is None:
-                    return
-
-                plural = '' if len(v) == 1 else 's'
-                keys = ', '.join(map(repr, v))
-                raise TypeError(f'multiple values for argument{plural}: {keys}')
-
-            class Config(CustomConfig):
-                extra = getattr(CustomConfig, 'extra', Extra.forbid)
-
-        self.model = create_model(to_camel(self.raw_function.__name__), __base__=DecoratorBaseModel, **fields)
diff --git a/lib/pydantic/v1/env_settings.py b/lib/pydantic/v1/env_settings.py
deleted file mode 100644
index 6c446e51..00000000
--- a/lib/pydantic/v1/env_settings.py
+++ /dev/null
@@ -1,350 +0,0 @@
-import os
-import warnings
-from pathlib import Path
-from typing import AbstractSet, Any, Callable, ClassVar, Dict, List, Mapping, Optional, Tuple, Type, Union
-
-from .config import BaseConfig, Extra
-from .fields import ModelField
-from .main import BaseModel
-from .types import JsonWrapper
-from .typing import StrPath, display_as_type, get_origin, is_union
-from .utils import deep_update, lenient_issubclass, path_type, sequence_like
-
-env_file_sentinel = str(object())
-
-SettingsSourceCallable = Callable[['BaseSettings'], Dict[str, Any]]
-DotenvType = Union[StrPath, List[StrPath], Tuple[StrPath, ...]]
-
-
-class SettingsError(ValueError):
-    pass
-
-
-class BaseSettings(BaseModel):
-    """
-    Base class for settings, allowing values to be overridden by environment variables.
-
-    This is useful in production for secrets you do not wish to save in code, it plays nicely with docker(-compose),
-    Heroku and any 12 factor app design.
-    """
-
-    def __init__(
-        __pydantic_self__,
-        _env_file: Optional[DotenvType] = env_file_sentinel,
-        _env_file_encoding: Optional[str] = None,
-        _env_nested_delimiter: Optional[str] = None,
-        _secrets_dir: Optional[StrPath] = None,
-        **values: Any,
-    ) -> None:
-        # Uses something other than `self` the first arg to allow "self" as a settable attribute
-        super().__init__(
-            **__pydantic_self__._build_values(
-                values,
-                _env_file=_env_file,
-                _env_file_encoding=_env_file_encoding,
-                _env_nested_delimiter=_env_nested_delimiter,
-                _secrets_dir=_secrets_dir,
-            )
-        )
-
-    def _build_values(
-        self,
-        init_kwargs: Dict[str, Any],
-        _env_file: Optional[DotenvType] = None,
-        _env_file_encoding: Optional[str] = None,
-        _env_nested_delimiter: Optional[str] = None,
-        _secrets_dir: Optional[StrPath] = None,
-    ) -> Dict[str, Any]:
-        # Configure built-in sources
-        init_settings = InitSettingsSource(init_kwargs=init_kwargs)
-        env_settings = EnvSettingsSource(
-            env_file=(_env_file if _env_file != env_file_sentinel else self.__config__.env_file),
-            env_file_encoding=(
-                _env_file_encoding if _env_file_encoding is not None else self.__config__.env_file_encoding
-            ),
-            env_nested_delimiter=(
-                _env_nested_delimiter if _env_nested_delimiter is not None else self.__config__.env_nested_delimiter
-            ),
-            env_prefix_len=len(self.__config__.env_prefix),
-        )
-        file_secret_settings = SecretsSettingsSource(secrets_dir=_secrets_dir or self.__config__.secrets_dir)
-        # Provide a hook to set built-in sources priority and add / remove sources
-        sources = self.__config__.customise_sources(
-            init_settings=init_settings, env_settings=env_settings, file_secret_settings=file_secret_settings
-        )
-        if sources:
-            return deep_update(*reversed([source(self) for source in sources]))
-        else:
-            # no one should mean to do this, but I think returning an empty dict is marginally preferable
-            # to an informative error and much better than a confusing error
-            return {}
-
-    class Config(BaseConfig):
-        env_prefix: str = ''
-        env_file: Optional[DotenvType] = None
-        env_file_encoding: Optional[str] = None
-        env_nested_delimiter: Optional[str] = None
-        secrets_dir: Optional[StrPath] = None
-        validate_all: bool = True
-        extra: Extra = Extra.forbid
-        arbitrary_types_allowed: bool = True
-        case_sensitive: bool = False
-
-        @classmethod
-        def prepare_field(cls, field: ModelField) -> None:
-            env_names: Union[List[str], AbstractSet[str]]
-            field_info_from_config = cls.get_field_info(field.name)
-
-            env = field_info_from_config.get('env') or field.field_info.extra.get('env')
-            if env is None:
-                if field.has_alias:
-                    warnings.warn(
-                        'aliases are no longer used by BaseSettings to define which environment variables to read. '
-                        'Instead use the "env" field setting. '
-                        'See https://pydantic-docs.helpmanual.io/usage/settings/#environment-variable-names',
-                        FutureWarning,
-                    )
-                env_names = {cls.env_prefix + field.name}
-            elif isinstance(env, str):
-                env_names = {env}
-            elif isinstance(env, (set, frozenset)):
-                env_names = env
-            elif sequence_like(env):
-                env_names = list(env)
-            else:
-                raise TypeError(f'invalid field env: {env!r} ({display_as_type(env)}); should be string, list or set')
-
-            if not cls.case_sensitive:
-                env_names = env_names.__class__(n.lower() for n in env_names)
-            field.field_info.extra['env_names'] = env_names
-
-        @classmethod
-        def customise_sources(
-            cls,
-            init_settings: SettingsSourceCallable,
-            env_settings: SettingsSourceCallable,
-            file_secret_settings: SettingsSourceCallable,
-        ) -> Tuple[SettingsSourceCallable, ...]:
-            return init_settings, env_settings, file_secret_settings
-
-        @classmethod
-        def parse_env_var(cls, field_name: str, raw_val: str) -> Any:
-            return cls.json_loads(raw_val)
-
-    # populated by the metaclass using the Config class defined above, annotated here to help IDEs only
-    __config__: ClassVar[Type[Config]]
-
-
-class InitSettingsSource:
-    __slots__ = ('init_kwargs',)
-
-    def __init__(self, init_kwargs: Dict[str, Any]):
-        self.init_kwargs = init_kwargs
-
-    def __call__(self, settings: BaseSettings) -> Dict[str, Any]:
-        return self.init_kwargs
-
-    def __repr__(self) -> str:
-        return f'InitSettingsSource(init_kwargs={self.init_kwargs!r})'
-
-
-class EnvSettingsSource:
-    __slots__ = ('env_file', 'env_file_encoding', 'env_nested_delimiter', 'env_prefix_len')
-
-    def __init__(
-        self,
-        env_file: Optional[DotenvType],
-        env_file_encoding: Optional[str],
-        env_nested_delimiter: Optional[str] = None,
-        env_prefix_len: int = 0,
-    ):
-        self.env_file: Optional[DotenvType] = env_file
-        self.env_file_encoding: Optional[str] = env_file_encoding
-        self.env_nested_delimiter: Optional[str] = env_nested_delimiter
-        self.env_prefix_len: int = env_prefix_len
-
-    def __call__(self, settings: BaseSettings) -> Dict[str, Any]:  # noqa C901
-        """
-        Build environment variables suitable for passing to the Model.
-        """
-        d: Dict[str, Any] = {}
-
-        if settings.__config__.case_sensitive:
-            env_vars: Mapping[str, Optional[str]] = os.environ
-        else:
-            env_vars = {k.lower(): v for k, v in os.environ.items()}
-
-        dotenv_vars = self._read_env_files(settings.__config__.case_sensitive)
-        if dotenv_vars:
-            env_vars = {**dotenv_vars, **env_vars}
-
-        for field in settings.__fields__.values():
-            env_val: Optional[str] = None
-            for env_name in field.field_info.extra['env_names']:
-                env_val = env_vars.get(env_name)
-                if env_val is not None:
-                    break
-
-            is_complex, allow_parse_failure = self.field_is_complex(field)
-            if is_complex:
-                if env_val is None:
-                    # field is complex but no value found so far, try explode_env_vars
-                    env_val_built = self.explode_env_vars(field, env_vars)
-                    if env_val_built:
-                        d[field.alias] = env_val_built
-                else:
-                    # field is complex and there's a value, decode that as JSON, then add explode_env_vars
-                    try:
-                        env_val = settings.__config__.parse_env_var(field.name, env_val)
-                    except ValueError as e:
-                        if not allow_parse_failure:
-                            raise SettingsError(f'error parsing env var "{env_name}"') from e
-
-                    if isinstance(env_val, dict):
-                        d[field.alias] = deep_update(env_val, self.explode_env_vars(field, env_vars))
-                    else:
-                        d[field.alias] = env_val
-            elif env_val is not None:
-                # simplest case, field is not complex, we only need to add the value if it was found
-                d[field.alias] = env_val
-
-        return d
-
-    def _read_env_files(self, case_sensitive: bool) -> Dict[str, Optional[str]]:
-        env_files = self.env_file
-        if env_files is None:
-            return {}
-
-        if isinstance(env_files, (str, os.PathLike)):
-            env_files = [env_files]
-
-        dotenv_vars = {}
-        for env_file in env_files:
-            env_path = Path(env_file).expanduser()
-            if env_path.is_file():
-                dotenv_vars.update(
-                    read_env_file(env_path, encoding=self.env_file_encoding, case_sensitive=case_sensitive)
-                )
-
-        return dotenv_vars
-
-    def field_is_complex(self, field: ModelField) -> Tuple[bool, bool]:
-        """
-        Find out if a field is complex, and if so whether JSON errors should be ignored
-        """
-        if lenient_issubclass(field.annotation, JsonWrapper):
-            return False, False
-
-        if field.is_complex():
-            allow_parse_failure = False
-        elif is_union(get_origin(field.type_)) and field.sub_fields and any(f.is_complex() for f in field.sub_fields):
-            allow_parse_failure = True
-        else:
-            return False, False
-
-        return True, allow_parse_failure
-
-    def explode_env_vars(self, field: ModelField, env_vars: Mapping[str, Optional[str]]) -> Dict[str, Any]:
-        """
-        Process env_vars and extract the values of keys containing env_nested_delimiter into nested dictionaries.
-
-        This is applied to a single field, hence filtering by env_var prefix.
-        """
-        prefixes = [f'{env_name}{self.env_nested_delimiter}' for env_name in field.field_info.extra['env_names']]
-        result: Dict[str, Any] = {}
-        for env_name, env_val in env_vars.items():
-            if not any(env_name.startswith(prefix) for prefix in prefixes):
-                continue
-            # we remove the prefix before splitting in case the prefix has characters in common with the delimiter
-            env_name_without_prefix = env_name[self.env_prefix_len :]
-            _, *keys, last_key = env_name_without_prefix.split(self.env_nested_delimiter)
-            env_var = result
-            for key in keys:
-                env_var = env_var.setdefault(key, {})
-            env_var[last_key] = env_val
-
-        return result
-
-    def __repr__(self) -> str:
-        return (
-            f'EnvSettingsSource(env_file={self.env_file!r}, env_file_encoding={self.env_file_encoding!r}, '
-            f'env_nested_delimiter={self.env_nested_delimiter!r})'
-        )
-
-
-class SecretsSettingsSource:
-    __slots__ = ('secrets_dir',)
-
-    def __init__(self, secrets_dir: Optional[StrPath]):
-        self.secrets_dir: Optional[StrPath] = secrets_dir
-
-    def __call__(self, settings: BaseSettings) -> Dict[str, Any]:
-        """
-        Build fields from "secrets" files.
-        """
-        secrets: Dict[str, Optional[str]] = {}
-
-        if self.secrets_dir is None:
-            return secrets
-
-        secrets_path = Path(self.secrets_dir).expanduser()
-
-        if not secrets_path.exists():
-            warnings.warn(f'directory "{secrets_path}" does not exist')
-            return secrets
-
-        if not secrets_path.is_dir():
-            raise SettingsError(f'secrets_dir must reference a directory, not a {path_type(secrets_path)}')
-
-        for field in settings.__fields__.values():
-            for env_name in field.field_info.extra['env_names']:
-                path = find_case_path(secrets_path, env_name, settings.__config__.case_sensitive)
-                if not path:
-                    # path does not exist, we currently don't return a warning for this
-                    continue
-
-                if path.is_file():
-                    secret_value = path.read_text().strip()
-                    if field.is_complex():
-                        try:
-                            secret_value = settings.__config__.parse_env_var(field.name, secret_value)
-                        except ValueError as e:
-                            raise SettingsError(f'error parsing env var "{env_name}"') from e
-
-                    secrets[field.alias] = secret_value
-                else:
-                    warnings.warn(
-                        f'attempted to load secret file "{path}" but found a {path_type(path)} instead.',
-                        stacklevel=4,
-                    )
-        return secrets
-
-    def __repr__(self) -> str:
-        return f'SecretsSettingsSource(secrets_dir={self.secrets_dir!r})'
-
-
-def read_env_file(
-    file_path: StrPath, *, encoding: str = None, case_sensitive: bool = False
-) -> Dict[str, Optional[str]]:
-    try:
-        from dotenv import dotenv_values
-    except ImportError as e:
-        raise ImportError('python-dotenv is not installed, run `pip install pydantic[dotenv]`') from e
-
-    file_vars: Dict[str, Optional[str]] = dotenv_values(file_path, encoding=encoding or 'utf8')
-    if not case_sensitive:
-        return {k.lower(): v for k, v in file_vars.items()}
-    else:
-        return file_vars
-
-
-def find_case_path(dir_path: Path, file_name: str, case_sensitive: bool) -> Optional[Path]:
-    """
-    Find a file within path's directory matching filename, optionally ignoring case.
-    """
-    for f in dir_path.iterdir():
-        if f.name == file_name:
-            return f
-        elif not case_sensitive and f.name.lower() == file_name.lower():
-            return f
-    return None
diff --git a/lib/pydantic/v1/error_wrappers.py b/lib/pydantic/v1/error_wrappers.py
deleted file mode 100644
index d89a500c..00000000
--- a/lib/pydantic/v1/error_wrappers.py
+++ /dev/null
@@ -1,161 +0,0 @@
-import json
-from typing import TYPE_CHECKING, Any, Dict, Generator, List, Optional, Sequence, Tuple, Type, Union
-
-from .json import pydantic_encoder
-from .utils import Representation
-
-if TYPE_CHECKING:
-    from typing_extensions import TypedDict
-
-    from .config import BaseConfig
-    from .types import ModelOrDc
-    from .typing import ReprArgs
-
-    Loc = Tuple[Union[int, str], ...]
-
-    class _ErrorDictRequired(TypedDict):
-        loc: Loc
-        msg: str
-        type: str
-
-    class ErrorDict(_ErrorDictRequired, total=False):
-        ctx: Dict[str, Any]
-
-
-__all__ = 'ErrorWrapper', 'ValidationError'
-
-
-class ErrorWrapper(Representation):
-    __slots__ = 'exc', '_loc'
-
-    def __init__(self, exc: Exception, loc: Union[str, 'Loc']) -> None:
-        self.exc = exc
-        self._loc = loc
-
-    def loc_tuple(self) -> 'Loc':
-        if isinstance(self._loc, tuple):
-            return self._loc
-        else:
-            return (self._loc,)
-
-    def __repr_args__(self) -> 'ReprArgs':
-        return [('exc', self.exc), ('loc', self.loc_tuple())]
-
-
-# ErrorList is something like Union[List[Union[List[ErrorWrapper], ErrorWrapper]], ErrorWrapper]
-# but recursive, therefore just use:
-ErrorList = Union[Sequence[Any], ErrorWrapper]
-
-
-class ValidationError(Representation, ValueError):
-    __slots__ = 'raw_errors', 'model', '_error_cache'
-
-    def __init__(self, errors: Sequence[ErrorList], model: 'ModelOrDc') -> None:
-        self.raw_errors = errors
-        self.model = model
-        self._error_cache: Optional[List['ErrorDict']] = None
-
-    def errors(self) -> List['ErrorDict']:
-        if self._error_cache is None:
-            try:
-                config = self.model.__config__  # type: ignore
-            except AttributeError:
-                config = self.model.__pydantic_model__.__config__  # type: ignore
-            self._error_cache = list(flatten_errors(self.raw_errors, config))
-        return self._error_cache
-
-    def json(self, *, indent: Union[None, int, str] = 2) -> str:
-        return json.dumps(self.errors(), indent=indent, default=pydantic_encoder)
-
-    def __str__(self) -> str:
-        errors = self.errors()
-        no_errors = len(errors)
-        return (
-            f'{no_errors} validation error{"" if no_errors == 1 else "s"} for {self.model.__name__}\n'
-            f'{display_errors(errors)}'
-        )
-
-    def __repr_args__(self) -> 'ReprArgs':
-        return [('model', self.model.__name__), ('errors', self.errors())]
-
-
-def display_errors(errors: List['ErrorDict']) -> str:
-    return '\n'.join(f'{_display_error_loc(e)}\n  {e["msg"]} ({_display_error_type_and_ctx(e)})' for e in errors)
-
-
-def _display_error_loc(error: 'ErrorDict') -> str:
-    return ' -> '.join(str(e) for e in error['loc'])
-
-
-def _display_error_type_and_ctx(error: 'ErrorDict') -> str:
-    t = 'type=' + error['type']
-    ctx = error.get('ctx')
-    if ctx:
-        return t + ''.join(f'; {k}={v}' for k, v in ctx.items())
-    else:
-        return t
-
-
-def flatten_errors(
-    errors: Sequence[Any], config: Type['BaseConfig'], loc: Optional['Loc'] = None
-) -> Generator['ErrorDict', None, None]:
-    for error in errors:
-        if isinstance(error, ErrorWrapper):
-            if loc:
-                error_loc = loc + error.loc_tuple()
-            else:
-                error_loc = error.loc_tuple()
-
-            if isinstance(error.exc, ValidationError):
-                yield from flatten_errors(error.exc.raw_errors, config, error_loc)
-            else:
-                yield error_dict(error.exc, config, error_loc)
-        elif isinstance(error, list):
-            yield from flatten_errors(error, config, loc=loc)
-        else:
-            raise RuntimeError(f'Unknown error object: {error}')
-
-
-def error_dict(exc: Exception, config: Type['BaseConfig'], loc: 'Loc') -> 'ErrorDict':
-    type_ = get_exc_type(exc.__class__)
-    msg_template = config.error_msg_templates.get(type_) or getattr(exc, 'msg_template', None)
-    ctx = exc.__dict__
-    if msg_template:
-        msg = msg_template.format(**ctx)
-    else:
-        msg = str(exc)
-
-    d: 'ErrorDict' = {'loc': loc, 'msg': msg, 'type': type_}
-
-    if ctx:
-        d['ctx'] = ctx
-
-    return d
-
-
-_EXC_TYPE_CACHE: Dict[Type[Exception], str] = {}
-
-
-def get_exc_type(cls: Type[Exception]) -> str:
-    # slightly more efficient than using lru_cache since we don't need to worry about the cache filling up
-    try:
-        return _EXC_TYPE_CACHE[cls]
-    except KeyError:
-        r = _get_exc_type(cls)
-        _EXC_TYPE_CACHE[cls] = r
-        return r
-
-
-def _get_exc_type(cls: Type[Exception]) -> str:
-    if issubclass(cls, AssertionError):
-        return 'assertion_error'
-
-    base_name = 'type_error' if issubclass(cls, TypeError) else 'value_error'
-    if cls in (TypeError, ValueError):
-        # just TypeError or ValueError, no extra code
-        return base_name
-
-    # if it's not a TypeError or ValueError, we just take the lowercase of the exception name
-    # no chaining or snake case logic, use "code" for more complex error types.
-    code = getattr(cls, 'code', None) or cls.__name__.replace('Error', '').lower()
-    return base_name + '.' + code
diff --git a/lib/pydantic/v1/errors.py b/lib/pydantic/v1/errors.py
deleted file mode 100644
index 7bdafdd1..00000000
--- a/lib/pydantic/v1/errors.py
+++ /dev/null
@@ -1,646 +0,0 @@
-from decimal import Decimal
-from pathlib import Path
-from typing import TYPE_CHECKING, Any, Callable, Sequence, Set, Tuple, Type, Union
-
-from .typing import display_as_type
-
-if TYPE_CHECKING:
-    from .typing import DictStrAny
-
-# explicitly state exports to avoid "from .errors import *" also importing Decimal, Path etc.
-__all__ = (
-    'PydanticTypeError',
-    'PydanticValueError',
-    'ConfigError',
-    'MissingError',
-    'ExtraError',
-    'NoneIsNotAllowedError',
-    'NoneIsAllowedError',
-    'WrongConstantError',
-    'NotNoneError',
-    'BoolError',
-    'BytesError',
-    'DictError',
-    'EmailError',
-    'UrlError',
-    'UrlSchemeError',
-    'UrlSchemePermittedError',
-    'UrlUserInfoError',
-    'UrlHostError',
-    'UrlHostTldError',
-    'UrlPortError',
-    'UrlExtraError',
-    'EnumError',
-    'IntEnumError',
-    'EnumMemberError',
-    'IntegerError',
-    'FloatError',
-    'PathError',
-    'PathNotExistsError',
-    'PathNotAFileError',
-    'PathNotADirectoryError',
-    'PyObjectError',
-    'SequenceError',
-    'ListError',
-    'SetError',
-    'FrozenSetError',
-    'TupleError',
-    'TupleLengthError',
-    'ListMinLengthError',
-    'ListMaxLengthError',
-    'ListUniqueItemsError',
-    'SetMinLengthError',
-    'SetMaxLengthError',
-    'FrozenSetMinLengthError',
-    'FrozenSetMaxLengthError',
-    'AnyStrMinLengthError',
-    'AnyStrMaxLengthError',
-    'StrError',
-    'StrRegexError',
-    'NumberNotGtError',
-    'NumberNotGeError',
-    'NumberNotLtError',
-    'NumberNotLeError',
-    'NumberNotMultipleError',
-    'DecimalError',
-    'DecimalIsNotFiniteError',
-    'DecimalMaxDigitsError',
-    'DecimalMaxPlacesError',
-    'DecimalWholeDigitsError',
-    'DateTimeError',
-    'DateError',
-    'DateNotInThePastError',
-    'DateNotInTheFutureError',
-    'TimeError',
-    'DurationError',
-    'HashableError',
-    'UUIDError',
-    'UUIDVersionError',
-    'ArbitraryTypeError',
-    'ClassError',
-    'SubclassError',
-    'JsonError',
-    'JsonTypeError',
-    'PatternError',
-    'DataclassTypeError',
-    'CallableError',
-    'IPvAnyAddressError',
-    'IPvAnyInterfaceError',
-    'IPvAnyNetworkError',
-    'IPv4AddressError',
-    'IPv6AddressError',
-    'IPv4NetworkError',
-    'IPv6NetworkError',
-    'IPv4InterfaceError',
-    'IPv6InterfaceError',
-    'ColorError',
-    'StrictBoolError',
-    'NotDigitError',
-    'LuhnValidationError',
-    'InvalidLengthForBrand',
-    'InvalidByteSize',
-    'InvalidByteSizeUnit',
-    'MissingDiscriminator',
-    'InvalidDiscriminator',
-)
-
-
-def cls_kwargs(cls: Type['PydanticErrorMixin'], ctx: 'DictStrAny') -> 'PydanticErrorMixin':
-    """
-    For built-in exceptions like ValueError or TypeError, we need to implement
-    __reduce__ to override the default behaviour (instead of __getstate__/__setstate__)
-    By default pickle protocol 2 calls `cls.__new__(cls, *args)`.
-    Since we only use kwargs, we need a little constructor to change that.
-    Note: the callable can't be a lambda as pickle looks in the namespace to find it
-    """
-    return cls(**ctx)
-
-
-class PydanticErrorMixin:
-    code: str
-    msg_template: str
-
-    def __init__(self, **ctx: Any) -> None:
-        self.__dict__ = ctx
-
-    def __str__(self) -> str:
-        return self.msg_template.format(**self.__dict__)
-
-    def __reduce__(self) -> Tuple[Callable[..., 'PydanticErrorMixin'], Tuple[Type['PydanticErrorMixin'], 'DictStrAny']]:
-        return cls_kwargs, (self.__class__, self.__dict__)
-
-
-class PydanticTypeError(PydanticErrorMixin, TypeError):
-    pass
-
-
-class PydanticValueError(PydanticErrorMixin, ValueError):
-    pass
-
-
-class ConfigError(RuntimeError):
-    pass
-
-
-class MissingError(PydanticValueError):
-    msg_template = 'field required'
-
-
-class ExtraError(PydanticValueError):
-    msg_template = 'extra fields not permitted'
-
-
-class NoneIsNotAllowedError(PydanticTypeError):
-    code = 'none.not_allowed'
-    msg_template = 'none is not an allowed value'
-
-
-class NoneIsAllowedError(PydanticTypeError):
-    code = 'none.allowed'
-    msg_template = 'value is not none'
-
-
-class WrongConstantError(PydanticValueError):
-    code = 'const'
-
-    def __str__(self) -> str:
-        permitted = ', '.join(repr(v) for v in self.permitted)  # type: ignore
-        return f'unexpected value; permitted: {permitted}'
-
-
-class NotNoneError(PydanticTypeError):
-    code = 'not_none'
-    msg_template = 'value is not None'
-
-
-class BoolError(PydanticTypeError):
-    msg_template = 'value could not be parsed to a boolean'
-
-
-class BytesError(PydanticTypeError):
-    msg_template = 'byte type expected'
-
-
-class DictError(PydanticTypeError):
-    msg_template = 'value is not a valid dict'
-
-
-class EmailError(PydanticValueError):
-    msg_template = 'value is not a valid email address'
-
-
-class UrlError(PydanticValueError):
-    code = 'url'
-
-
-class UrlSchemeError(UrlError):
-    code = 'url.scheme'
-    msg_template = 'invalid or missing URL scheme'
-
-
-class UrlSchemePermittedError(UrlError):
-    code = 'url.scheme'
-    msg_template = 'URL scheme not permitted'
-
-    def __init__(self, allowed_schemes: Set[str]):
-        super().__init__(allowed_schemes=allowed_schemes)
-
-
-class UrlUserInfoError(UrlError):
-    code = 'url.userinfo'
-    msg_template = 'userinfo required in URL but missing'
-
-
-class UrlHostError(UrlError):
-    code = 'url.host'
-    msg_template = 'URL host invalid'
-
-
-class UrlHostTldError(UrlError):
-    code = 'url.host'
-    msg_template = 'URL host invalid, top level domain required'
-
-
-class UrlPortError(UrlError):
-    code = 'url.port'
-    msg_template = 'URL port invalid, port cannot exceed 65535'
-
-
-class UrlExtraError(UrlError):
-    code = 'url.extra'
-    msg_template = 'URL invalid, extra characters found after valid URL: {extra!r}'
-
-
-class EnumMemberError(PydanticTypeError):
-    code = 'enum'
-
-    def __str__(self) -> str:
-        permitted = ', '.join(repr(v.value) for v in self.enum_values)  # type: ignore
-        return f'value is not a valid enumeration member; permitted: {permitted}'
-
-
-class IntegerError(PydanticTypeError):
-    msg_template = 'value is not a valid integer'
-
-
-class FloatError(PydanticTypeError):
-    msg_template = 'value is not a valid float'
-
-
-class PathError(PydanticTypeError):
-    msg_template = 'value is not a valid path'
-
-
-class _PathValueError(PydanticValueError):
-    def __init__(self, *, path: Path) -> None:
-        super().__init__(path=str(path))
-
-
-class PathNotExistsError(_PathValueError):
-    code = 'path.not_exists'
-    msg_template = 'file or directory at path "{path}" does not exist'
-
-
-class PathNotAFileError(_PathValueError):
-    code = 'path.not_a_file'
-    msg_template = 'path "{path}" does not point to a file'
-
-
-class PathNotADirectoryError(_PathValueError):
-    code = 'path.not_a_directory'
-    msg_template = 'path "{path}" does not point to a directory'
-
-
-class PyObjectError(PydanticTypeError):
-    msg_template = 'ensure this value contains valid import path or valid callable: {error_message}'
-
-
-class SequenceError(PydanticTypeError):
-    msg_template = 'value is not a valid sequence'
-
-
-class IterableError(PydanticTypeError):
-    msg_template = 'value is not a valid iterable'
-
-
-class ListError(PydanticTypeError):
-    msg_template = 'value is not a valid list'
-
-
-class SetError(PydanticTypeError):
-    msg_template = 'value is not a valid set'
-
-
-class FrozenSetError(PydanticTypeError):
-    msg_template = 'value is not a valid frozenset'
-
-
-class DequeError(PydanticTypeError):
-    msg_template = 'value is not a valid deque'
-
-
-class TupleError(PydanticTypeError):
-    msg_template = 'value is not a valid tuple'
-
-
-class TupleLengthError(PydanticValueError):
-    code = 'tuple.length'
-    msg_template = 'wrong tuple length {actual_length}, expected {expected_length}'
-
-    def __init__(self, *, actual_length: int, expected_length: int) -> None:
-        super().__init__(actual_length=actual_length, expected_length=expected_length)
-
-
-class ListMinLengthError(PydanticValueError):
-    code = 'list.min_items'
-    msg_template = 'ensure this value has at least {limit_value} items'
-
-    def __init__(self, *, limit_value: int) -> None:
-        super().__init__(limit_value=limit_value)
-
-
-class ListMaxLengthError(PydanticValueError):
-    code = 'list.max_items'
-    msg_template = 'ensure this value has at most {limit_value} items'
-
-    def __init__(self, *, limit_value: int) -> None:
-        super().__init__(limit_value=limit_value)
-
-
-class ListUniqueItemsError(PydanticValueError):
-    code = 'list.unique_items'
-    msg_template = 'the list has duplicated items'
-
-
-class SetMinLengthError(PydanticValueError):
-    code = 'set.min_items'
-    msg_template = 'ensure this value has at least {limit_value} items'
-
-    def __init__(self, *, limit_value: int) -> None:
-        super().__init__(limit_value=limit_value)
-
-
-class SetMaxLengthError(PydanticValueError):
-    code = 'set.max_items'
-    msg_template = 'ensure this value has at most {limit_value} items'
-
-    def __init__(self, *, limit_value: int) -> None:
-        super().__init__(limit_value=limit_value)
-
-
-class FrozenSetMinLengthError(PydanticValueError):
-    code = 'frozenset.min_items'
-    msg_template = 'ensure this value has at least {limit_value} items'
-
-    def __init__(self, *, limit_value: int) -> None:
-        super().__init__(limit_value=limit_value)
-
-
-class FrozenSetMaxLengthError(PydanticValueError):
-    code = 'frozenset.max_items'
-    msg_template = 'ensure this value has at most {limit_value} items'
-
-    def __init__(self, *, limit_value: int) -> None:
-        super().__init__(limit_value=limit_value)
-
-
-class AnyStrMinLengthError(PydanticValueError):
-    code = 'any_str.min_length'
-    msg_template = 'ensure this value has at least {limit_value} characters'
-
-    def __init__(self, *, limit_value: int) -> None:
-        super().__init__(limit_value=limit_value)
-
-
-class AnyStrMaxLengthError(PydanticValueError):
-    code = 'any_str.max_length'
-    msg_template = 'ensure this value has at most {limit_value} characters'
-
-    def __init__(self, *, limit_value: int) -> None:
-        super().__init__(limit_value=limit_value)
-
-
-class StrError(PydanticTypeError):
-    msg_template = 'str type expected'
-
-
-class StrRegexError(PydanticValueError):
-    code = 'str.regex'
-    msg_template = 'string does not match regex "{pattern}"'
-
-    def __init__(self, *, pattern: str) -> None:
-        super().__init__(pattern=pattern)
-
-
-class _NumberBoundError(PydanticValueError):
-    def __init__(self, *, limit_value: Union[int, float, Decimal]) -> None:
-        super().__init__(limit_value=limit_value)
-
-
-class NumberNotGtError(_NumberBoundError):
-    code = 'number.not_gt'
-    msg_template = 'ensure this value is greater than {limit_value}'
-
-
-class NumberNotGeError(_NumberBoundError):
-    code = 'number.not_ge'
-    msg_template = 'ensure this value is greater than or equal to {limit_value}'
-
-
-class NumberNotLtError(_NumberBoundError):
-    code = 'number.not_lt'
-    msg_template = 'ensure this value is less than {limit_value}'
-
-
-class NumberNotLeError(_NumberBoundError):
-    code = 'number.not_le'
-    msg_template = 'ensure this value is less than or equal to {limit_value}'
-
-
-class NumberNotFiniteError(PydanticValueError):
-    code = 'number.not_finite_number'
-    msg_template = 'ensure this value is a finite number'
-
-
-class NumberNotMultipleError(PydanticValueError):
-    code = 'number.not_multiple'
-    msg_template = 'ensure this value is a multiple of {multiple_of}'
-
-    def __init__(self, *, multiple_of: Union[int, float, Decimal]) -> None:
-        super().__init__(multiple_of=multiple_of)
-
-
-class DecimalError(PydanticTypeError):
-    msg_template = 'value is not a valid decimal'
-
-
-class DecimalIsNotFiniteError(PydanticValueError):
-    code = 'decimal.not_finite'
-    msg_template = 'value is not a valid decimal'
-
-
-class DecimalMaxDigitsError(PydanticValueError):
-    code = 'decimal.max_digits'
-    msg_template = 'ensure that there are no more than {max_digits} digits in total'
-
-    def __init__(self, *, max_digits: int) -> None:
-        super().__init__(max_digits=max_digits)
-
-
-class DecimalMaxPlacesError(PydanticValueError):
-    code = 'decimal.max_places'
-    msg_template = 'ensure that there are no more than {decimal_places} decimal places'
-
-    def __init__(self, *, decimal_places: int) -> None:
-        super().__init__(decimal_places=decimal_places)
-
-
-class DecimalWholeDigitsError(PydanticValueError):
-    code = 'decimal.whole_digits'
-    msg_template = 'ensure that there are no more than {whole_digits} digits before the decimal point'
-
-    def __init__(self, *, whole_digits: int) -> None:
-        super().__init__(whole_digits=whole_digits)
-
-
-class DateTimeError(PydanticValueError):
-    msg_template = 'invalid datetime format'
-
-
-class DateError(PydanticValueError):
-    msg_template = 'invalid date format'
-
-
-class DateNotInThePastError(PydanticValueError):
-    code = 'date.not_in_the_past'
-    msg_template = 'date is not in the past'
-
-
-class DateNotInTheFutureError(PydanticValueError):
-    code = 'date.not_in_the_future'
-    msg_template = 'date is not in the future'
-
-
-class TimeError(PydanticValueError):
-    msg_template = 'invalid time format'
-
-
-class DurationError(PydanticValueError):
-    msg_template = 'invalid duration format'
-
-
-class HashableError(PydanticTypeError):
-    msg_template = 'value is not a valid hashable'
-
-
-class UUIDError(PydanticTypeError):
-    msg_template = 'value is not a valid uuid'
-
-
-class UUIDVersionError(PydanticValueError):
-    code = 'uuid.version'
-    msg_template = 'uuid version {required_version} expected'
-
-    def __init__(self, *, required_version: int) -> None:
-        super().__init__(required_version=required_version)
-
-
-class ArbitraryTypeError(PydanticTypeError):
-    code = 'arbitrary_type'
-    msg_template = 'instance of {expected_arbitrary_type} expected'
-
-    def __init__(self, *, expected_arbitrary_type: Type[Any]) -> None:
-        super().__init__(expected_arbitrary_type=display_as_type(expected_arbitrary_type))
-
-
-class ClassError(PydanticTypeError):
-    code = 'class'
-    msg_template = 'a class is expected'
-
-
-class SubclassError(PydanticTypeError):
-    code = 'subclass'
-    msg_template = 'subclass of {expected_class} expected'
-
-    def __init__(self, *, expected_class: Type[Any]) -> None:
-        super().__init__(expected_class=display_as_type(expected_class))
-
-
-class JsonError(PydanticValueError):
-    msg_template = 'Invalid JSON'
-
-
-class JsonTypeError(PydanticTypeError):
-    code = 'json'
-    msg_template = 'JSON object must be str, bytes or bytearray'
-
-
-class PatternError(PydanticValueError):
-    code = 'regex_pattern'
-    msg_template = 'Invalid regular expression'
-
-
-class DataclassTypeError(PydanticTypeError):
-    code = 'dataclass'
-    msg_template = 'instance of {class_name}, tuple or dict expected'
-
-
-class CallableError(PydanticTypeError):
-    msg_template = '{value} is not callable'
-
-
-class EnumError(PydanticTypeError):
-    code = 'enum_instance'
-    msg_template = '{value} is not a valid Enum instance'
-
-
-class IntEnumError(PydanticTypeError):
-    code = 'int_enum_instance'
-    msg_template = '{value} is not a valid IntEnum instance'
-
-
-class IPvAnyAddressError(PydanticValueError):
-    msg_template = 'value is not a valid IPv4 or IPv6 address'
-
-
-class IPvAnyInterfaceError(PydanticValueError):
-    msg_template = 'value is not a valid IPv4 or IPv6 interface'
-
-
-class IPvAnyNetworkError(PydanticValueError):
-    msg_template = 'value is not a valid IPv4 or IPv6 network'
-
-
-class IPv4AddressError(PydanticValueError):
-    msg_template = 'value is not a valid IPv4 address'
-
-
-class IPv6AddressError(PydanticValueError):
-    msg_template = 'value is not a valid IPv6 address'
-
-
-class IPv4NetworkError(PydanticValueError):
-    msg_template = 'value is not a valid IPv4 network'
-
-
-class IPv6NetworkError(PydanticValueError):
-    msg_template = 'value is not a valid IPv6 network'
-
-
-class IPv4InterfaceError(PydanticValueError):
-    msg_template = 'value is not a valid IPv4 interface'
-
-
-class IPv6InterfaceError(PydanticValueError):
-    msg_template = 'value is not a valid IPv6 interface'
-
-
-class ColorError(PydanticValueError):
-    msg_template = 'value is not a valid color: {reason}'
-
-
-class StrictBoolError(PydanticValueError):
-    msg_template = 'value is not a valid boolean'
-
-
-class NotDigitError(PydanticValueError):
-    code = 'payment_card_number.digits'
-    msg_template = 'card number is not all digits'
-
-
-class LuhnValidationError(PydanticValueError):
-    code = 'payment_card_number.luhn_check'
-    msg_template = 'card number is not luhn valid'
-
-
-class InvalidLengthForBrand(PydanticValueError):
-    code = 'payment_card_number.invalid_length_for_brand'
-    msg_template = 'Length for a {brand} card must be {required_length}'
-
-
-class InvalidByteSize(PydanticValueError):
-    msg_template = 'could not parse value and unit from byte string'
-
-
-class InvalidByteSizeUnit(PydanticValueError):
-    msg_template = 'could not interpret byte unit: {unit}'
-
-
-class MissingDiscriminator(PydanticValueError):
-    code = 'discriminated_union.missing_discriminator'
-    msg_template = 'Discriminator {discriminator_key!r} is missing in value'
-
-
-class InvalidDiscriminator(PydanticValueError):
-    code = 'discriminated_union.invalid_discriminator'
-    msg_template = (
-        'No match for discriminator {discriminator_key!r} and value {discriminator_value!r} '
-        '(allowed values: {allowed_values})'
-    )
-
-    def __init__(self, *, discriminator_key: str, discriminator_value: Any, allowed_values: Sequence[Any]) -> None:
-        super().__init__(
-            discriminator_key=discriminator_key,
-            discriminator_value=discriminator_value,
-            allowed_values=', '.join(map(repr, allowed_values)),
-        )
diff --git a/lib/pydantic/v1/fields.py b/lib/pydantic/v1/fields.py
deleted file mode 100644
index 60d260e9..00000000
--- a/lib/pydantic/v1/fields.py
+++ /dev/null
@@ -1,1253 +0,0 @@
-import copy
-import re
-from collections import Counter as CollectionCounter, defaultdict, deque
-from collections.abc import Callable, Hashable as CollectionsHashable, Iterable as CollectionsIterable
-from typing import (
-    TYPE_CHECKING,
-    Any,
-    Counter,
-    DefaultDict,
-    Deque,
-    Dict,
-    ForwardRef,
-    FrozenSet,
-    Generator,
-    Iterable,
-    Iterator,
-    List,
-    Mapping,
-    Optional,
-    Pattern,
-    Sequence,
-    Set,
-    Tuple,
-    Type,
-    TypeVar,
-    Union,
-)
-
-from typing_extensions import Annotated, Final
-
-from . import errors as errors_
-from .class_validators import Validator, make_generic_validator, prep_validators
-from .error_wrappers import ErrorWrapper
-from .errors import ConfigError, InvalidDiscriminator, MissingDiscriminator, NoneIsNotAllowedError
-from .types import Json, JsonWrapper
-from .typing import (
-    NoArgAnyCallable,
-    convert_generics,
-    display_as_type,
-    get_args,
-    get_origin,
-    is_finalvar,
-    is_literal_type,
-    is_new_type,
-    is_none_type,
-    is_typeddict,
-    is_typeddict_special,
-    is_union,
-    new_type_supertype,
-)
-from .utils import (
-    PyObjectStr,
-    Representation,
-    ValueItems,
-    get_discriminator_alias_and_values,
-    get_unique_discriminator_alias,
-    lenient_isinstance,
-    lenient_issubclass,
-    sequence_like,
-    smart_deepcopy,
-)
-from .validators import constant_validator, dict_validator, find_validators, validate_json
-
-Required: Any = Ellipsis
-
-T = TypeVar('T')
-
-
-class UndefinedType:
-    def __repr__(self) -> str:
-        return 'PydanticUndefined'
-
-    def __copy__(self: T) -> T:
-        return self
-
-    def __reduce__(self) -> str:
-        return 'Undefined'
-
-    def __deepcopy__(self: T, _: Any) -> T:
-        return self
-
-
-Undefined = UndefinedType()
-
-if TYPE_CHECKING:
-    from .class_validators import ValidatorsList
-    from .config import BaseConfig
-    from .error_wrappers import ErrorList
-    from .types import ModelOrDc
-    from .typing import AbstractSetIntStr, MappingIntStrAny, ReprArgs
-
-    ValidateReturn = Tuple[Optional[Any], Optional[ErrorList]]
-    LocStr = Union[Tuple[Union[int, str], ...], str]
-    BoolUndefined = Union[bool, UndefinedType]
-
-
-class FieldInfo(Representation):
-    """
-    Captures extra information about a field.
-    """
-
-    __slots__ = (
-        'default',
-        'default_factory',
-        'alias',
-        'alias_priority',
-        'title',
-        'description',
-        'exclude',
-        'include',
-        'const',
-        'gt',
-        'ge',
-        'lt',
-        'le',
-        'multiple_of',
-        'allow_inf_nan',
-        'max_digits',
-        'decimal_places',
-        'min_items',
-        'max_items',
-        'unique_items',
-        'min_length',
-        'max_length',
-        'allow_mutation',
-        'repr',
-        'regex',
-        'discriminator',
-        'extra',
-    )
-
-    # field constraints with the default value, it's also used in update_from_config below
-    __field_constraints__ = {
-        'min_length': None,
-        'max_length': None,
-        'regex': None,
-        'gt': None,
-        'lt': None,
-        'ge': None,
-        'le': None,
-        'multiple_of': None,
-        'allow_inf_nan': None,
-        'max_digits': None,
-        'decimal_places': None,
-        'min_items': None,
-        'max_items': None,
-        'unique_items': None,
-        'allow_mutation': True,
-    }
-
-    def __init__(self, default: Any = Undefined, **kwargs: Any) -> None:
-        self.default = default
-        self.default_factory = kwargs.pop('default_factory', None)
-        self.alias = kwargs.pop('alias', None)
-        self.alias_priority = kwargs.pop('alias_priority', 2 if self.alias is not None else None)
-        self.title = kwargs.pop('title', None)
-        self.description = kwargs.pop('description', None)
-        self.exclude = kwargs.pop('exclude', None)
-        self.include = kwargs.pop('include', None)
-        self.const = kwargs.pop('const', None)
-        self.gt = kwargs.pop('gt', None)
-        self.ge = kwargs.pop('ge', None)
-        self.lt = kwargs.pop('lt', None)
-        self.le = kwargs.pop('le', None)
-        self.multiple_of = kwargs.pop('multiple_of', None)
-        self.allow_inf_nan = kwargs.pop('allow_inf_nan', None)
-        self.max_digits = kwargs.pop('max_digits', None)
-        self.decimal_places = kwargs.pop('decimal_places', None)
-        self.min_items = kwargs.pop('min_items', None)
-        self.max_items = kwargs.pop('max_items', None)
-        self.unique_items = kwargs.pop('unique_items', None)
-        self.min_length = kwargs.pop('min_length', None)
-        self.max_length = kwargs.pop('max_length', None)
-        self.allow_mutation = kwargs.pop('allow_mutation', True)
-        self.regex = kwargs.pop('regex', None)
-        self.discriminator = kwargs.pop('discriminator', None)
-        self.repr = kwargs.pop('repr', True)
-        self.extra = kwargs
-
-    def __repr_args__(self) -> 'ReprArgs':
-        field_defaults_to_hide: Dict[str, Any] = {
-            'repr': True,
-            **self.__field_constraints__,
-        }
-
-        attrs = ((s, getattr(self, s)) for s in self.__slots__)
-        return [(a, v) for a, v in attrs if v != field_defaults_to_hide.get(a, None)]
-
-    def get_constraints(self) -> Set[str]:
-        """
-        Gets the constraints set on the field by comparing the constraint value with its default value
-
-        :return: the constraints set on field_info
-        """
-        return {attr for attr, default in self.__field_constraints__.items() if getattr(self, attr) != default}
-
-    def update_from_config(self, from_config: Dict[str, Any]) -> None:
-        """
-        Update this FieldInfo based on a dict from get_field_info, only fields which have not been set are dated.
-        """
-        for attr_name, value in from_config.items():
-            try:
-                current_value = getattr(self, attr_name)
-            except AttributeError:
-                # attr_name is not an attribute of FieldInfo, it should therefore be added to extra
-                # (except if extra already has this value!)
-                self.extra.setdefault(attr_name, value)
-            else:
-                if current_value is self.__field_constraints__.get(attr_name, None):
-                    setattr(self, attr_name, value)
-                elif attr_name == 'exclude':
-                    self.exclude = ValueItems.merge(value, current_value)
-                elif attr_name == 'include':
-                    self.include = ValueItems.merge(value, current_value, intersect=True)
-
-    def _validate(self) -> None:
-        if self.default is not Undefined and self.default_factory is not None:
-            raise ValueError('cannot specify both default and default_factory')
-
-
-def Field(
-    default: Any = Undefined,
-    *,
-    default_factory: Optional[NoArgAnyCallable] = None,
-    alias: Optional[str] = None,
-    title: Optional[str] = None,
-    description: Optional[str] = None,
-    exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny', Any]] = None,
-    include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny', Any]] = None,
-    const: Optional[bool] = None,
-    gt: Optional[float] = None,
-    ge: Optional[float] = None,
-    lt: Optional[float] = None,
-    le: Optional[float] = None,
-    multiple_of: Optional[float] = None,
-    allow_inf_nan: Optional[bool] = None,
-    max_digits: Optional[int] = None,
-    decimal_places: Optional[int] = None,
-    min_items: Optional[int] = None,
-    max_items: Optional[int] = None,
-    unique_items: Optional[bool] = None,
-    min_length: Optional[int] = None,
-    max_length: Optional[int] = None,
-    allow_mutation: bool = True,
-    regex: Optional[str] = None,
-    discriminator: Optional[str] = None,
-    repr: bool = True,
-    **extra: Any,
-) -> Any:
-    """
-    Used to provide extra information about a field, either for the model schema or complex validation. Some arguments
-    apply only to number fields (``int``, ``float``, ``Decimal``) and some apply only to ``str``.
-
-    :param default: since this is replacing the field’s default, its first argument is used
-      to set the default, use ellipsis (``...``) to indicate the field is required
-    :param default_factory: callable that will be called when a default value is needed for this field
-      If both `default` and `default_factory` are set, an error is raised.
-    :param alias: the public name of the field
-    :param title: can be any string, used in the schema
-    :param description: can be any string, used in the schema
-    :param exclude: exclude this field while dumping.
-      Takes same values as the ``include`` and ``exclude`` arguments on the ``.dict`` method.
-    :param include: include this field while dumping.
-      Takes same values as the ``include`` and ``exclude`` arguments on the ``.dict`` method.
-    :param const: this field is required and *must* take it's default value
-    :param gt: only applies to numbers, requires the field to be "greater than". The schema
-      will have an ``exclusiveMinimum`` validation keyword
-    :param ge: only applies to numbers, requires the field to be "greater than or equal to". The
-      schema will have a ``minimum`` validation keyword
-    :param lt: only applies to numbers, requires the field to be "less than". The schema
-      will have an ``exclusiveMaximum`` validation keyword
-    :param le: only applies to numbers, requires the field to be "less than or equal to". The
-      schema will have a ``maximum`` validation keyword
-    :param multiple_of: only applies to numbers, requires the field to be "a multiple of". The
-      schema will have a ``multipleOf`` validation keyword
-    :param allow_inf_nan: only applies to numbers, allows the field to be NaN or infinity (+inf or -inf),
-        which is a valid Python float. Default True, set to False for compatibility with JSON.
-    :param max_digits: only applies to Decimals, requires the field to have a maximum number
-      of digits within the decimal. It does not include a zero before the decimal point or trailing decimal zeroes.
-    :param decimal_places: only applies to Decimals, requires the field to have at most a number of decimal places
-      allowed. It does not include trailing decimal zeroes.
-    :param min_items: only applies to lists, requires the field to have a minimum number of
-      elements. The schema will have a ``minItems`` validation keyword
-    :param max_items: only applies to lists, requires the field to have a maximum number of
-      elements. The schema will have a ``maxItems`` validation keyword
-    :param unique_items: only applies to lists, requires the field not to have duplicated
-      elements. The schema will have a ``uniqueItems`` validation keyword
-    :param min_length: only applies to strings, requires the field to have a minimum length. The
-      schema will have a ``minLength`` validation keyword
-    :param max_length: only applies to strings, requires the field to have a maximum length. The
-      schema will have a ``maxLength`` validation keyword
-    :param allow_mutation: a boolean which defaults to True. When False, the field raises a TypeError if the field is
-      assigned on an instance.  The BaseModel Config must set validate_assignment to True
-    :param regex: only applies to strings, requires the field match against a regular expression
-      pattern string. The schema will have a ``pattern`` validation keyword
-    :param discriminator: only useful with a (discriminated a.k.a. tagged) `Union` of sub models with a common field.
-      The `discriminator` is the name of this common field to shorten validation and improve generated schema
-    :param repr: show this field in the representation
-    :param **extra: any additional keyword arguments will be added as is to the schema
-    """
-    field_info = FieldInfo(
-        default,
-        default_factory=default_factory,
-        alias=alias,
-        title=title,
-        description=description,
-        exclude=exclude,
-        include=include,
-        const=const,
-        gt=gt,
-        ge=ge,
-        lt=lt,
-        le=le,
-        multiple_of=multiple_of,
-        allow_inf_nan=allow_inf_nan,
-        max_digits=max_digits,
-        decimal_places=decimal_places,
-        min_items=min_items,
-        max_items=max_items,
-        unique_items=unique_items,
-        min_length=min_length,
-        max_length=max_length,
-        allow_mutation=allow_mutation,
-        regex=regex,
-        discriminator=discriminator,
-        repr=repr,
-        **extra,
-    )
-    field_info._validate()
-    return field_info
-
-
-# used to be an enum but changed to int's for small performance improvement as less access overhead
-SHAPE_SINGLETON = 1
-SHAPE_LIST = 2
-SHAPE_SET = 3
-SHAPE_MAPPING = 4
-SHAPE_TUPLE = 5
-SHAPE_TUPLE_ELLIPSIS = 6
-SHAPE_SEQUENCE = 7
-SHAPE_FROZENSET = 8
-SHAPE_ITERABLE = 9
-SHAPE_GENERIC = 10
-SHAPE_DEQUE = 11
-SHAPE_DICT = 12
-SHAPE_DEFAULTDICT = 13
-SHAPE_COUNTER = 14
-SHAPE_NAME_LOOKUP = {
-    SHAPE_LIST: 'List[{}]',
-    SHAPE_SET: 'Set[{}]',
-    SHAPE_TUPLE_ELLIPSIS: 'Tuple[{}, ...]',
-    SHAPE_SEQUENCE: 'Sequence[{}]',
-    SHAPE_FROZENSET: 'FrozenSet[{}]',
-    SHAPE_ITERABLE: 'Iterable[{}]',
-    SHAPE_DEQUE: 'Deque[{}]',
-    SHAPE_DICT: 'Dict[{}]',
-    SHAPE_DEFAULTDICT: 'DefaultDict[{}]',
-    SHAPE_COUNTER: 'Counter[{}]',
-}
-
-MAPPING_LIKE_SHAPES: Set[int] = {SHAPE_DEFAULTDICT, SHAPE_DICT, SHAPE_MAPPING, SHAPE_COUNTER}
-
-
-class ModelField(Representation):
-    __slots__ = (
-        'type_',
-        'outer_type_',
-        'annotation',
-        'sub_fields',
-        'sub_fields_mapping',
-        'key_field',
-        'validators',
-        'pre_validators',
-        'post_validators',
-        'default',
-        'default_factory',
-        'required',
-        'final',
-        'model_config',
-        'name',
-        'alias',
-        'has_alias',
-        'field_info',
-        'discriminator_key',
-        'discriminator_alias',
-        'validate_always',
-        'allow_none',
-        'shape',
-        'class_validators',
-        'parse_json',
-    )
-
-    def __init__(
-        self,
-        *,
-        name: str,
-        type_: Type[Any],
-        class_validators: Optional[Dict[str, Validator]],
-        model_config: Type['BaseConfig'],
-        default: Any = None,
-        default_factory: Optional[NoArgAnyCallable] = None,
-        required: 'BoolUndefined' = Undefined,
-        final: bool = False,
-        alias: Optional[str] = None,
-        field_info: Optional[FieldInfo] = None,
-    ) -> None:
-        self.name: str = name
-        self.has_alias: bool = alias is not None
-        self.alias: str = alias if alias is not None else name
-        self.annotation = type_
-        self.type_: Any = convert_generics(type_)
-        self.outer_type_: Any = type_
-        self.class_validators = class_validators or {}
-        self.default: Any = default
-        self.default_factory: Optional[NoArgAnyCallable] = default_factory
-        self.required: 'BoolUndefined' = required
-        self.final: bool = final
-        self.model_config = model_config
-        self.field_info: FieldInfo = field_info or FieldInfo(default)
-        self.discriminator_key: Optional[str] = self.field_info.discriminator
-        self.discriminator_alias: Optional[str] = self.discriminator_key
-
-        self.allow_none: bool = False
-        self.validate_always: bool = False
-        self.sub_fields: Optional[List[ModelField]] = None
-        self.sub_fields_mapping: Optional[Dict[str, 'ModelField']] = None  # used for discriminated union
-        self.key_field: Optional[ModelField] = None
-        self.validators: 'ValidatorsList' = []
-        self.pre_validators: Optional['ValidatorsList'] = None
-        self.post_validators: Optional['ValidatorsList'] = None
-        self.parse_json: bool = False
-        self.shape: int = SHAPE_SINGLETON
-        self.model_config.prepare_field(self)
-        self.prepare()
-
-    def get_default(self) -> Any:
-        return smart_deepcopy(self.default) if self.default_factory is None else self.default_factory()
-
-    @staticmethod
-    def _get_field_info(
-        field_name: str, annotation: Any, value: Any, config: Type['BaseConfig']
-    ) -> Tuple[FieldInfo, Any]:
-        """
-        Get a FieldInfo from a root typing.Annotated annotation, value, or config default.
-
-        The FieldInfo may be set in typing.Annotated or the value, but not both. If neither contain
-        a FieldInfo, a new one will be created using the config.
-
-        :param field_name: name of the field for use in error messages
-        :param annotation: a type hint such as `str` or `Annotated[str, Field(..., min_length=5)]`
-        :param value: the field's assigned value
-        :param config: the model's config object
-        :return: the FieldInfo contained in the `annotation`, the value, or a new one from the config.
-        """
-        field_info_from_config = config.get_field_info(field_name)
-
-        field_info = None
-        if get_origin(annotation) is Annotated:
-            field_infos = [arg for arg in get_args(annotation)[1:] if isinstance(arg, FieldInfo)]
-            if len(field_infos) > 1:
-                raise ValueError(f'cannot specify multiple `Annotated` `Field`s for {field_name!r}')
-            field_info = next(iter(field_infos), None)
-            if field_info is not None:
-                field_info = copy.copy(field_info)
-                field_info.update_from_config(field_info_from_config)
-                if field_info.default not in (Undefined, Required):
-                    raise ValueError(f'`Field` default cannot be set in `Annotated` for {field_name!r}')
-                if value is not Undefined and value is not Required:
-                    # check also `Required` because of `validate_arguments` that sets `...` as default value
-                    field_info.default = value
-
-        if isinstance(value, FieldInfo):
-            if field_info is not None:
-                raise ValueError(f'cannot specify `Annotated` and value `Field`s together for {field_name!r}')
-            field_info = value
-            field_info.update_from_config(field_info_from_config)
-        elif field_info is None:
-            field_info = FieldInfo(value, **field_info_from_config)
-        value = None if field_info.default_factory is not None else field_info.default
-        field_info._validate()
-        return field_info, value
-
-    @classmethod
-    def infer(
-        cls,
-        *,
-        name: str,
-        value: Any,
-        annotation: Any,
-        class_validators: Optional[Dict[str, Validator]],
-        config: Type['BaseConfig'],
-    ) -> 'ModelField':
-        from .schema import get_annotation_from_field_info
-
-        field_info, value = cls._get_field_info(name, annotation, value, config)
-        required: 'BoolUndefined' = Undefined
-        if value is Required:
-            required = True
-            value = None
-        elif value is not Undefined:
-            required = False
-        annotation = get_annotation_from_field_info(annotation, field_info, name, config.validate_assignment)
-
-        return cls(
-            name=name,
-            type_=annotation,
-            alias=field_info.alias,
-            class_validators=class_validators,
-            default=value,
-            default_factory=field_info.default_factory,
-            required=required,
-            model_config=config,
-            field_info=field_info,
-        )
-
-    def set_config(self, config: Type['BaseConfig']) -> None:
-        self.model_config = config
-        info_from_config = config.get_field_info(self.name)
-        config.prepare_field(self)
-        new_alias = info_from_config.get('alias')
-        new_alias_priority = info_from_config.get('alias_priority') or 0
-        if new_alias and new_alias_priority >= (self.field_info.alias_priority or 0):
-            self.field_info.alias = new_alias
-            self.field_info.alias_priority = new_alias_priority
-            self.alias = new_alias
-        new_exclude = info_from_config.get('exclude')
-        if new_exclude is not None:
-            self.field_info.exclude = ValueItems.merge(self.field_info.exclude, new_exclude)
-        new_include = info_from_config.get('include')
-        if new_include is not None:
-            self.field_info.include = ValueItems.merge(self.field_info.include, new_include, intersect=True)
-
-    @property
-    def alt_alias(self) -> bool:
-        return self.name != self.alias
-
-    def prepare(self) -> None:
-        """
-        Prepare the field but inspecting self.default, self.type_ etc.
-
-        Note: this method is **not** idempotent (because _type_analysis is not idempotent),
-        e.g. calling it it multiple times may modify the field and configure it incorrectly.
-        """
-        self._set_default_and_type()
-        if self.type_.__class__ is ForwardRef or self.type_.__class__ is DeferredType:
-            # self.type_ is currently a ForwardRef and there's nothing we can do now,
-            # user will need to call model.update_forward_refs()
-            return
-
-        self._type_analysis()
-        if self.required is Undefined:
-            self.required = True
-        if self.default is Undefined and self.default_factory is None:
-            self.default = None
-        self.populate_validators()
-
-    def _set_default_and_type(self) -> None:
-        """
-        Set the default value, infer the type if needed and check if `None` value is valid.
-        """
-        if self.default_factory is not None:
-            if self.type_ is Undefined:
-                raise errors_.ConfigError(
-                    f'you need to set the type of field {self.name!r} when using `default_factory`'
-                )
-            return
-
-        default_value = self.get_default()
-
-        if default_value is not None and self.type_ is Undefined:
-            self.type_ = default_value.__class__
-            self.outer_type_ = self.type_
-            self.annotation = self.type_
-
-        if self.type_ is Undefined:
-            raise errors_.ConfigError(f'unable to infer type for attribute "{self.name}"')
-
-        if self.required is False and default_value is None:
-            self.allow_none = True
-
-    def _type_analysis(self) -> None:  # noqa: C901 (ignore complexity)
-        # typing interface is horrible, we have to do some ugly checks
-        if lenient_issubclass(self.type_, JsonWrapper):
-            self.type_ = self.type_.inner_type
-            self.parse_json = True
-        elif lenient_issubclass(self.type_, Json):
-            self.type_ = Any
-            self.parse_json = True
-        elif isinstance(self.type_, TypeVar):
-            if self.type_.__bound__:
-                self.type_ = self.type_.__bound__
-            elif self.type_.__constraints__:
-                self.type_ = Union[self.type_.__constraints__]
-            else:
-                self.type_ = Any
-        elif is_new_type(self.type_):
-            self.type_ = new_type_supertype(self.type_)
-
-        if self.type_ is Any or self.type_ is object:
-            if self.required is Undefined:
-                self.required = False
-            self.allow_none = True
-            return
-        elif self.type_ is Pattern or self.type_ is re.Pattern:
-            # python 3.7 only, Pattern is a typing object but without sub fields
-            return
-        elif is_literal_type(self.type_):
-            return
-        elif is_typeddict(self.type_):
-            return
-
-        if is_finalvar(self.type_):
-            self.final = True
-
-            if self.type_ is Final:
-                self.type_ = Any
-            else:
-                self.type_ = get_args(self.type_)[0]
-
-            self._type_analysis()
-            return
-
-        origin = get_origin(self.type_)
-
-        if origin is Annotated or is_typeddict_special(origin):
-            self.type_ = get_args(self.type_)[0]
-            self._type_analysis()
-            return
-
-        if self.discriminator_key is not None and not is_union(origin):
-            raise TypeError('`discriminator` can only be used with `Union` type with more than one variant')
-
-        # add extra check for `collections.abc.Hashable` for python 3.10+ where origin is not `None`
-        if origin is None or origin is CollectionsHashable:
-            # field is not "typing" object eg. Union, Dict, List etc.
-            # allow None for virtual superclasses of NoneType, e.g. Hashable
-            if isinstance(self.type_, type) and isinstance(None, self.type_):
-                self.allow_none = True
-            return
-        elif origin is Callable:
-            return
-        elif is_union(origin):
-            types_ = []
-            for type_ in get_args(self.type_):
-                if is_none_type(type_) or type_ is Any or type_ is object:
-                    if self.required is Undefined:
-                        self.required = False
-                    self.allow_none = True
-                if is_none_type(type_):
-                    continue
-                types_.append(type_)
-
-            if len(types_) == 1:
-                # Optional[]
-                self.type_ = types_[0]
-                # this is the one case where the "outer type" isn't just the original type
-                self.outer_type_ = self.type_
-                # re-run to correctly interpret the new self.type_
-                self._type_analysis()
-            else:
-                self.sub_fields = [self._create_sub_type(t, f'{self.name}_{display_as_type(t)}') for t in types_]
-
-                if self.discriminator_key is not None:
-                    self.prepare_discriminated_union_sub_fields()
-            return
-        elif issubclass(origin, Tuple):  # type: ignore
-            # origin == Tuple without item type
-            args = get_args(self.type_)
-            if not args:  # plain tuple
-                self.type_ = Any
-                self.shape = SHAPE_TUPLE_ELLIPSIS
-            elif len(args) == 2 and args[1] is Ellipsis:  # e.g. Tuple[int, ...]
-                self.type_ = args[0]
-                self.shape = SHAPE_TUPLE_ELLIPSIS
-                self.sub_fields = [self._create_sub_type(args[0], f'{self.name}_0')]
-            elif args == ((),):  # Tuple[()] means empty tuple
-                self.shape = SHAPE_TUPLE
-                self.type_ = Any
-                self.sub_fields = []
-            else:
-                self.shape = SHAPE_TUPLE
-                self.sub_fields = [self._create_sub_type(t, f'{self.name}_{i}') for i, t in enumerate(args)]
-            return
-        elif issubclass(origin, List):
-            # Create self validators
-            get_validators = getattr(self.type_, '__get_validators__', None)
-            if get_validators:
-                self.class_validators.update(
-                    {f'list_{i}': Validator(validator, pre=True) for i, validator in enumerate(get_validators())}
-                )
-
-            self.type_ = get_args(self.type_)[0]
-            self.shape = SHAPE_LIST
-        elif issubclass(origin, Set):
-            # Create self validators
-            get_validators = getattr(self.type_, '__get_validators__', None)
-            if get_validators:
-                self.class_validators.update(
-                    {f'set_{i}': Validator(validator, pre=True) for i, validator in enumerate(get_validators())}
-                )
-
-            self.type_ = get_args(self.type_)[0]
-            self.shape = SHAPE_SET
-        elif issubclass(origin, FrozenSet):
-            # Create self validators
-            get_validators = getattr(self.type_, '__get_validators__', None)
-            if get_validators:
-                self.class_validators.update(
-                    {f'frozenset_{i}': Validator(validator, pre=True) for i, validator in enumerate(get_validators())}
-                )
-
-            self.type_ = get_args(self.type_)[0]
-            self.shape = SHAPE_FROZENSET
-        elif issubclass(origin, Deque):
-            self.type_ = get_args(self.type_)[0]
-            self.shape = SHAPE_DEQUE
-        elif issubclass(origin, Sequence):
-            self.type_ = get_args(self.type_)[0]
-            self.shape = SHAPE_SEQUENCE
-        # priority to most common mapping: dict
-        elif origin is dict or origin is Dict:
-            self.key_field = self._create_sub_type(get_args(self.type_)[0], 'key_' + self.name, for_keys=True)
-            self.type_ = get_args(self.type_)[1]
-            self.shape = SHAPE_DICT
-        elif issubclass(origin, DefaultDict):
-            self.key_field = self._create_sub_type(get_args(self.type_)[0], 'key_' + self.name, for_keys=True)
-            self.type_ = get_args(self.type_)[1]
-            self.shape = SHAPE_DEFAULTDICT
-        elif issubclass(origin, Counter):
-            self.key_field = self._create_sub_type(get_args(self.type_)[0], 'key_' + self.name, for_keys=True)
-            self.type_ = int
-            self.shape = SHAPE_COUNTER
-        elif issubclass(origin, Mapping):
-            self.key_field = self._create_sub_type(get_args(self.type_)[0], 'key_' + self.name, for_keys=True)
-            self.type_ = get_args(self.type_)[1]
-            self.shape = SHAPE_MAPPING
-        # Equality check as almost everything inherits form Iterable, including str
-        # check for Iterable and CollectionsIterable, as it could receive one even when declared with the other
-        elif origin in {Iterable, CollectionsIterable}:
-            self.type_ = get_args(self.type_)[0]
-            self.shape = SHAPE_ITERABLE
-            self.sub_fields = [self._create_sub_type(self.type_, f'{self.name}_type')]
-        elif issubclass(origin, Type):  # type: ignore
-            return
-        elif hasattr(origin, '__get_validators__') or self.model_config.arbitrary_types_allowed:
-            # Is a Pydantic-compatible generic that handles itself
-            # or we have arbitrary_types_allowed = True
-            self.shape = SHAPE_GENERIC
-            self.sub_fields = [self._create_sub_type(t, f'{self.name}_{i}') for i, t in enumerate(get_args(self.type_))]
-            self.type_ = origin
-            return
-        else:
-            raise TypeError(f'Fields of type "{origin}" are not supported.')
-
-        # type_ has been refined eg. as the type of a List and sub_fields needs to be populated
-        self.sub_fields = [self._create_sub_type(self.type_, '_' + self.name)]
-
-    def prepare_discriminated_union_sub_fields(self) -> None:
-        """
-        Prepare the mapping <discriminator key> -> <ModelField> and update `sub_fields`
-        Note that this process can be aborted if a `ForwardRef` is encountered
-        """
-        assert self.discriminator_key is not None
-
-        if self.type_.__class__ is DeferredType:
-            return
-
-        assert self.sub_fields is not None
-        sub_fields_mapping: Dict[str, 'ModelField'] = {}
-        all_aliases: Set[str] = set()
-
-        for sub_field in self.sub_fields:
-            t = sub_field.type_
-            if t.__class__ is ForwardRef:
-                # Stopping everything...will need to call `update_forward_refs`
-                return
-
-            alias, discriminator_values = get_discriminator_alias_and_values(t, self.discriminator_key)
-            all_aliases.add(alias)
-            for discriminator_value in discriminator_values:
-                sub_fields_mapping[discriminator_value] = sub_field
-
-        self.sub_fields_mapping = sub_fields_mapping
-        self.discriminator_alias = get_unique_discriminator_alias(all_aliases, self.discriminator_key)
-
-    def _create_sub_type(self, type_: Type[Any], name: str, *, for_keys: bool = False) -> 'ModelField':
-        if for_keys:
-            class_validators = None
-        else:
-            # validators for sub items should not have `each_item` as we want to check only the first sublevel
-            class_validators = {
-                k: Validator(
-                    func=v.func,
-                    pre=v.pre,
-                    each_item=False,
-                    always=v.always,
-                    check_fields=v.check_fields,
-                    skip_on_failure=v.skip_on_failure,
-                )
-                for k, v in self.class_validators.items()
-                if v.each_item
-            }
-
-        field_info, _ = self._get_field_info(name, type_, None, self.model_config)
-
-        return self.__class__(
-            type_=type_,
-            name=name,
-            class_validators=class_validators,
-            model_config=self.model_config,
-            field_info=field_info,
-        )
-
-    def populate_validators(self) -> None:
-        """
-        Prepare self.pre_validators, self.validators, and self.post_validators based on self.type_'s  __get_validators__
-        and class validators. This method should be idempotent, e.g. it should be safe to call multiple times
-        without mis-configuring the field.
-        """
-        self.validate_always = getattr(self.type_, 'validate_always', False) or any(
-            v.always for v in self.class_validators.values()
-        )
-
-        class_validators_ = self.class_validators.values()
-        if not self.sub_fields or self.shape == SHAPE_GENERIC:
-            get_validators = getattr(self.type_, '__get_validators__', None)
-            v_funcs = (
-                *[v.func for v in class_validators_ if v.each_item and v.pre],
-                *(get_validators() if get_validators else list(find_validators(self.type_, self.model_config))),
-                *[v.func for v in class_validators_ if v.each_item and not v.pre],
-            )
-            self.validators = prep_validators(v_funcs)
-
-        self.pre_validators = []
-        self.post_validators = []
-
-        if self.field_info and self.field_info.const:
-            self.post_validators.append(make_generic_validator(constant_validator))
-
-        if class_validators_:
-            self.pre_validators += prep_validators(v.func for v in class_validators_ if not v.each_item and v.pre)
-            self.post_validators += prep_validators(v.func for v in class_validators_ if not v.each_item and not v.pre)
-
-        if self.parse_json:
-            self.pre_validators.append(make_generic_validator(validate_json))
-
-        self.pre_validators = self.pre_validators or None
-        self.post_validators = self.post_validators or None
-
-    def validate(
-        self, v: Any, values: Dict[str, Any], *, loc: 'LocStr', cls: Optional['ModelOrDc'] = None
-    ) -> 'ValidateReturn':
-        assert self.type_.__class__ is not DeferredType
-
-        if self.type_.__class__ is ForwardRef:
-            assert cls is not None
-            raise ConfigError(
-                f'field "{self.name}" not yet prepared so type is still a ForwardRef, '
-                f'you might need to call {cls.__name__}.update_forward_refs().'
-            )
-
-        errors: Optional['ErrorList']
-        if self.pre_validators:
-            v, errors = self._apply_validators(v, values, loc, cls, self.pre_validators)
-            if errors:
-                return v, errors
-
-        if v is None:
-            if is_none_type(self.type_):
-                # keep validating
-                pass
-            elif self.allow_none:
-                if self.post_validators:
-                    return self._apply_validators(v, values, loc, cls, self.post_validators)
-                else:
-                    return None, None
-            else:
-                return v, ErrorWrapper(NoneIsNotAllowedError(), loc)
-
-        if self.shape == SHAPE_SINGLETON:
-            v, errors = self._validate_singleton(v, values, loc, cls)
-        elif self.shape in MAPPING_LIKE_SHAPES:
-            v, errors = self._validate_mapping_like(v, values, loc, cls)
-        elif self.shape == SHAPE_TUPLE:
-            v, errors = self._validate_tuple(v, values, loc, cls)
-        elif self.shape == SHAPE_ITERABLE:
-            v, errors = self._validate_iterable(v, values, loc, cls)
-        elif self.shape == SHAPE_GENERIC:
-            v, errors = self._apply_validators(v, values, loc, cls, self.validators)
-        else:
-            #  sequence, list, set, generator, tuple with ellipsis, frozen set
-            v, errors = self._validate_sequence_like(v, values, loc, cls)
-
-        if not errors and self.post_validators:
-            v, errors = self._apply_validators(v, values, loc, cls, self.post_validators)
-        return v, errors
-
-    def _validate_sequence_like(  # noqa: C901 (ignore complexity)
-        self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc']
-    ) -> 'ValidateReturn':
-        """
-        Validate sequence-like containers: lists, tuples, sets and generators
-        Note that large if-else blocks are necessary to enable Cython
-        optimization, which is why we disable the complexity check above.
-        """
-        if not sequence_like(v):
-            e: errors_.PydanticTypeError
-            if self.shape == SHAPE_LIST:
-                e = errors_.ListError()
-            elif self.shape in (SHAPE_TUPLE, SHAPE_TUPLE_ELLIPSIS):
-                e = errors_.TupleError()
-            elif self.shape == SHAPE_SET:
-                e = errors_.SetError()
-            elif self.shape == SHAPE_FROZENSET:
-                e = errors_.FrozenSetError()
-            else:
-                e = errors_.SequenceError()
-            return v, ErrorWrapper(e, loc)
-
-        loc = loc if isinstance(loc, tuple) else (loc,)
-        result = []
-        errors: List[ErrorList] = []
-        for i, v_ in enumerate(v):
-            v_loc = *loc, i
-            r, ee = self._validate_singleton(v_, values, v_loc, cls)
-            if ee:
-                errors.append(ee)
-            else:
-                result.append(r)
-
-        if errors:
-            return v, errors
-
-        converted: Union[List[Any], Set[Any], FrozenSet[Any], Tuple[Any, ...], Iterator[Any], Deque[Any]] = result
-
-        if self.shape == SHAPE_SET:
-            converted = set(result)
-        elif self.shape == SHAPE_FROZENSET:
-            converted = frozenset(result)
-        elif self.shape == SHAPE_TUPLE_ELLIPSIS:
-            converted = tuple(result)
-        elif self.shape == SHAPE_DEQUE:
-            converted = deque(result, maxlen=getattr(v, 'maxlen', None))
-        elif self.shape == SHAPE_SEQUENCE:
-            if isinstance(v, tuple):
-                converted = tuple(result)
-            elif isinstance(v, set):
-                converted = set(result)
-            elif isinstance(v, Generator):
-                converted = iter(result)
-            elif isinstance(v, deque):
-                converted = deque(result, maxlen=getattr(v, 'maxlen', None))
-        return converted, None
-
-    def _validate_iterable(
-        self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc']
-    ) -> 'ValidateReturn':
-        """
-        Validate Iterables.
-
-        This intentionally doesn't validate values to allow infinite generators.
-        """
-
-        try:
-            iterable = iter(v)
-        except TypeError:
-            return v, ErrorWrapper(errors_.IterableError(), loc)
-        return iterable, None
-
-    def _validate_tuple(
-        self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc']
-    ) -> 'ValidateReturn':
-        e: Optional[Exception] = None
-        if not sequence_like(v):
-            e = errors_.TupleError()
-        else:
-            actual_length, expected_length = len(v), len(self.sub_fields)  # type: ignore
-            if actual_length != expected_length:
-                e = errors_.TupleLengthError(actual_length=actual_length, expected_length=expected_length)
-
-        if e:
-            return v, ErrorWrapper(e, loc)
-
-        loc = loc if isinstance(loc, tuple) else (loc,)
-        result = []
-        errors: List[ErrorList] = []
-        for i, (v_, field) in enumerate(zip(v, self.sub_fields)):  # type: ignore
-            v_loc = *loc, i
-            r, ee = field.validate(v_, values, loc=v_loc, cls=cls)
-            if ee:
-                errors.append(ee)
-            else:
-                result.append(r)
-
-        if errors:
-            return v, errors
-        else:
-            return tuple(result), None
-
-    def _validate_mapping_like(
-        self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc']
-    ) -> 'ValidateReturn':
-        try:
-            v_iter = dict_validator(v)
-        except TypeError as exc:
-            return v, ErrorWrapper(exc, loc)
-
-        loc = loc if isinstance(loc, tuple) else (loc,)
-        result, errors = {}, []
-        for k, v_ in v_iter.items():
-            v_loc = *loc, '__key__'
-            key_result, key_errors = self.key_field.validate(k, values, loc=v_loc, cls=cls)  # type: ignore
-            if key_errors:
-                errors.append(key_errors)
-                continue
-
-            v_loc = *loc, k
-            value_result, value_errors = self._validate_singleton(v_, values, v_loc, cls)
-            if value_errors:
-                errors.append(value_errors)
-                continue
-
-            result[key_result] = value_result
-        if errors:
-            return v, errors
-        elif self.shape == SHAPE_DICT:
-            return result, None
-        elif self.shape == SHAPE_DEFAULTDICT:
-            return defaultdict(self.type_, result), None
-        elif self.shape == SHAPE_COUNTER:
-            return CollectionCounter(result), None
-        else:
-            return self._get_mapping_value(v, result), None
-
-    def _get_mapping_value(self, original: T, converted: Dict[Any, Any]) -> Union[T, Dict[Any, Any]]:
-        """
-        When type is `Mapping[KT, KV]` (or another unsupported mapping), we try to avoid
-        coercing to `dict` unwillingly.
-        """
-        original_cls = original.__class__
-
-        if original_cls == dict or original_cls == Dict:
-            return converted
-        elif original_cls in {defaultdict, DefaultDict}:
-            return defaultdict(self.type_, converted)
-        else:
-            try:
-                # Counter, OrderedDict, UserDict, ...
-                return original_cls(converted)  # type: ignore
-            except TypeError:
-                raise RuntimeError(f'Could not convert dictionary to {original_cls.__name__!r}') from None
-
-    def _validate_singleton(
-        self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc']
-    ) -> 'ValidateReturn':
-        if self.sub_fields:
-            if self.discriminator_key is not None:
-                return self._validate_discriminated_union(v, values, loc, cls)
-
-            errors = []
-
-            if self.model_config.smart_union and is_union(get_origin(self.type_)):
-                # 1st pass: check if the value is an exact instance of one of the Union types
-                # (e.g. to avoid coercing a bool into an int)
-                for field in self.sub_fields:
-                    if v.__class__ is field.outer_type_:
-                        return v, None
-
-                # 2nd pass: check if the value is an instance of any subclass of the Union types
-                for field in self.sub_fields:
-                    # This whole logic will be improved later on to support more complex `isinstance` checks
-                    # It will probably be done once a strict mode is added and be something like:
-                    # ```
-                    #     value, error = field.validate(v, values, strict=True)
-                    #     if error is None:
-                    #         return value, None
-                    # ```
-                    try:
-                        if isinstance(v, field.outer_type_):
-                            return v, None
-                    except TypeError:
-                        # compound type
-                        if lenient_isinstance(v, get_origin(field.outer_type_)):
-                            value, error = field.validate(v, values, loc=loc, cls=cls)
-                            if not error:
-                                return value, None
-
-            # 1st pass by default or 3rd pass with `smart_union` enabled:
-            # check if the value can be coerced into one of the Union types
-            for field in self.sub_fields:
-                value, error = field.validate(v, values, loc=loc, cls=cls)
-                if error:
-                    errors.append(error)
-                else:
-                    return value, None
-            return v, errors
-        else:
-            return self._apply_validators(v, values, loc, cls, self.validators)
-
-    def _validate_discriminated_union(
-        self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc']
-    ) -> 'ValidateReturn':
-        assert self.discriminator_key is not None
-        assert self.discriminator_alias is not None
-
-        try:
-            try:
-                discriminator_value = v[self.discriminator_alias]
-            except KeyError:
-                if self.model_config.allow_population_by_field_name:
-                    discriminator_value = v[self.discriminator_key]
-                else:
-                    raise
-        except KeyError:
-            return v, ErrorWrapper(MissingDiscriminator(discriminator_key=self.discriminator_key), loc)
-        except TypeError:
-            try:
-                # BaseModel or dataclass
-                discriminator_value = getattr(v, self.discriminator_key)
-            except (AttributeError, TypeError):
-                return v, ErrorWrapper(MissingDiscriminator(discriminator_key=self.discriminator_key), loc)
-
-        if self.sub_fields_mapping is None:
-            assert cls is not None
-            raise ConfigError(
-                f'field "{self.name}" not yet prepared so type is still a ForwardRef, '
-                f'you might need to call {cls.__name__}.update_forward_refs().'
-            )
-
-        try:
-            sub_field = self.sub_fields_mapping[discriminator_value]
-        except (KeyError, TypeError):
-            # KeyError: `discriminator_value` is not in the dictionary.
-            # TypeError: `discriminator_value` is unhashable.
-            assert self.sub_fields_mapping is not None
-            return v, ErrorWrapper(
-                InvalidDiscriminator(
-                    discriminator_key=self.discriminator_key,
-                    discriminator_value=discriminator_value,
-                    allowed_values=list(self.sub_fields_mapping),
-                ),
-                loc,
-            )
-        else:
-            if not isinstance(loc, tuple):
-                loc = (loc,)
-            return sub_field.validate(v, values, loc=(*loc, display_as_type(sub_field.type_)), cls=cls)
-
-    def _apply_validators(
-        self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc'], validators: 'ValidatorsList'
-    ) -> 'ValidateReturn':
-        for validator in validators:
-            try:
-                v = validator(cls, v, values, self, self.model_config)
-            except (ValueError, TypeError, AssertionError) as exc:
-                return v, ErrorWrapper(exc, loc)
-        return v, None
-
-    def is_complex(self) -> bool:
-        """
-        Whether the field is "complex" eg. env variables should be parsed as JSON.
-        """
-        from .main import BaseModel
-
-        return (
-            self.shape != SHAPE_SINGLETON
-            or hasattr(self.type_, '__pydantic_model__')
-            or lenient_issubclass(self.type_, (BaseModel, list, set, frozenset, dict))
-        )
-
-    def _type_display(self) -> PyObjectStr:
-        t = display_as_type(self.type_)
-
-        if self.shape in MAPPING_LIKE_SHAPES:
-            t = f'Mapping[{display_as_type(self.key_field.type_)}, {t}]'  # type: ignore
-        elif self.shape == SHAPE_TUPLE:
-            t = 'Tuple[{}]'.format(', '.join(display_as_type(f.type_) for f in self.sub_fields))  # type: ignore
-        elif self.shape == SHAPE_GENERIC:
-            assert self.sub_fields
-            t = '{}[{}]'.format(
-                display_as_type(self.type_), ', '.join(display_as_type(f.type_) for f in self.sub_fields)
-            )
-        elif self.shape != SHAPE_SINGLETON:
-            t = SHAPE_NAME_LOOKUP[self.shape].format(t)
-
-        if self.allow_none and (self.shape != SHAPE_SINGLETON or not self.sub_fields):
-            t = f'Optional[{t}]'
-        return PyObjectStr(t)
-
-    def __repr_args__(self) -> 'ReprArgs':
-        args = [('name', self.name), ('type', self._type_display()), ('required', self.required)]
-
-        if not self.required:
-            if self.default_factory is not None:
-                args.append(('default_factory', f'<function {self.default_factory.__name__}>'))
-            else:
-                args.append(('default', self.default))
-
-        if self.alt_alias:
-            args.append(('alias', self.alias))
-        return args
-
-
-class ModelPrivateAttr(Representation):
-    __slots__ = ('default', 'default_factory')
-
-    def __init__(self, default: Any = Undefined, *, default_factory: Optional[NoArgAnyCallable] = None) -> None:
-        self.default = default
-        self.default_factory = default_factory
-
-    def get_default(self) -> Any:
-        return smart_deepcopy(self.default) if self.default_factory is None else self.default_factory()
-
-    def __eq__(self, other: Any) -> bool:
-        return isinstance(other, self.__class__) and (self.default, self.default_factory) == (
-            other.default,
-            other.default_factory,
-        )
-
-
-def PrivateAttr(
-    default: Any = Undefined,
-    *,
-    default_factory: Optional[NoArgAnyCallable] = None,
-) -> Any:
-    """
-    Indicates that attribute is only used internally and never mixed with regular fields.
-
-    Types or values of private attrs are not checked by pydantic and it's up to you to keep them relevant.
-
-    Private attrs are stored in model __slots__.
-
-    :param default: the attribute’s default value
-    :param default_factory: callable that will be called when a default value is needed for this attribute
-      If both `default` and `default_factory` are set, an error is raised.
-    """
-    if default is not Undefined and default_factory is not None:
-        raise ValueError('cannot specify both default and default_factory')
-
-    return ModelPrivateAttr(
-        default,
-        default_factory=default_factory,
-    )
-
-
-class DeferredType:
-    """
-    Used to postpone field preparation, while creating recursive generic models.
-    """
-
-
-def is_finalvar_with_default_val(type_: Type[Any], val: Any) -> bool:
-    return is_finalvar(type_) and val is not Undefined and not isinstance(val, FieldInfo)
diff --git a/lib/pydantic/v1/generics.py b/lib/pydantic/v1/generics.py
deleted file mode 100644
index a75b6b98..00000000
--- a/lib/pydantic/v1/generics.py
+++ /dev/null
@@ -1,400 +0,0 @@
-import sys
-import types
-import typing
-from typing import (
-    TYPE_CHECKING,
-    Any,
-    ClassVar,
-    Dict,
-    ForwardRef,
-    Generic,
-    Iterator,
-    List,
-    Mapping,
-    Optional,
-    Tuple,
-    Type,
-    TypeVar,
-    Union,
-    cast,
-)
-from weakref import WeakKeyDictionary, WeakValueDictionary
-
-from typing_extensions import Annotated, Literal as ExtLiteral
-
-from .class_validators import gather_all_validators
-from .fields import DeferredType
-from .main import BaseModel, create_model
-from .types import JsonWrapper
-from .typing import display_as_type, get_all_type_hints, get_args, get_origin, typing_base
-from .utils import all_identical, lenient_issubclass
-
-if sys.version_info >= (3, 10):
-    from typing import _UnionGenericAlias
-if sys.version_info >= (3, 8):
-    from typing import Literal
-
-GenericModelT = TypeVar('GenericModelT', bound='GenericModel')
-TypeVarType = Any  # since mypy doesn't allow the use of TypeVar as a type
-
-CacheKey = Tuple[Type[Any], Any, Tuple[Any, ...]]
-Parametrization = Mapping[TypeVarType, Type[Any]]
-
-# weak dictionaries allow the dynamically created parametrized versions of generic models to get collected
-# once they are no longer referenced by the caller.
-if sys.version_info >= (3, 9):  # Typing for weak dictionaries available at 3.9
-    GenericTypesCache = WeakValueDictionary[CacheKey, Type[BaseModel]]
-    AssignedParameters = WeakKeyDictionary[Type[BaseModel], Parametrization]
-else:
-    GenericTypesCache = WeakValueDictionary
-    AssignedParameters = WeakKeyDictionary
-
-# _generic_types_cache is a Mapping from __class_getitem__ arguments to the parametrized version of generic models.
-# This ensures multiple calls of e.g. A[B] return always the same class.
-_generic_types_cache = GenericTypesCache()
-
-# _assigned_parameters is a Mapping from parametrized version of generic models to assigned types of parametrizations
-# as captured during construction of the class (not instances).
-# E.g., for generic model `Model[A, B]`, when parametrized model `Model[int, str]` is created,
-# `Model[int, str]`: {A: int, B: str}` will be stored in `_assigned_parameters`.
-# (This information is only otherwise available after creation from the class name string).
-_assigned_parameters = AssignedParameters()
-
-
-class GenericModel(BaseModel):
-    __slots__ = ()
-    __concrete__: ClassVar[bool] = False
-
-    if TYPE_CHECKING:
-        # Putting this in a TYPE_CHECKING block allows us to replace `if Generic not in cls.__bases__` with
-        # `not hasattr(cls, "__parameters__")`. This means we don't need to force non-concrete subclasses of
-        # `GenericModel` to also inherit from `Generic`, which would require changes to the use of `create_model` below.
-        __parameters__: ClassVar[Tuple[TypeVarType, ...]]
-
-    # Setting the return type as Type[Any] instead of Type[BaseModel] prevents PyCharm warnings
-    def __class_getitem__(cls: Type[GenericModelT], params: Union[Type[Any], Tuple[Type[Any], ...]]) -> Type[Any]:
-        """Instantiates a new class from a generic class `cls` and type variables `params`.
-
-        :param params: Tuple of types the class . Given a generic class
-            `Model` with 2 type variables and a concrete model `Model[str, int]`,
-            the value `(str, int)` would be passed to `params`.
-        :return: New model class inheriting from `cls` with instantiated
-            types described by `params`. If no parameters are given, `cls` is
-            returned as is.
-
-        """
-
-        def _cache_key(_params: Any) -> CacheKey:
-            args = get_args(_params)
-            # python returns a list for Callables, which is not hashable
-            if len(args) == 2 and isinstance(args[0], list):
-                args = (tuple(args[0]), args[1])
-            return cls, _params, args
-
-        cached = _generic_types_cache.get(_cache_key(params))
-        if cached is not None:
-            return cached
-        if cls.__concrete__ and Generic not in cls.__bases__:
-            raise TypeError('Cannot parameterize a concrete instantiation of a generic model')
-        if not isinstance(params, tuple):
-            params = (params,)
-        if cls is GenericModel and any(isinstance(param, TypeVar) for param in params):
-            raise TypeError('Type parameters should be placed on typing.Generic, not GenericModel')
-        if not hasattr(cls, '__parameters__'):
-            raise TypeError(f'Type {cls.__name__} must inherit from typing.Generic before being parameterized')
-
-        check_parameters_count(cls, params)
-        # Build map from generic typevars to passed params
-        typevars_map: Dict[TypeVarType, Type[Any]] = dict(zip(cls.__parameters__, params))
-        if all_identical(typevars_map.keys(), typevars_map.values()) and typevars_map:
-            return cls  # if arguments are equal to parameters it's the same object
-
-        # Create new model with original model as parent inserting fields with DeferredType.
-        model_name = cls.__concrete_name__(params)
-        validators = gather_all_validators(cls)
-
-        type_hints = get_all_type_hints(cls).items()
-        instance_type_hints = {k: v for k, v in type_hints if get_origin(v) is not ClassVar}
-
-        fields = {k: (DeferredType(), cls.__fields__[k].field_info) for k in instance_type_hints if k in cls.__fields__}
-
-        model_module, called_globally = get_caller_frame_info()
-        created_model = cast(
-            Type[GenericModel],  # casting ensures mypy is aware of the __concrete__ and __parameters__ attributes
-            create_model(
-                model_name,
-                __module__=model_module or cls.__module__,
-                __base__=(cls,) + tuple(cls.__parameterized_bases__(typevars_map)),
-                __config__=None,
-                __validators__=validators,
-                __cls_kwargs__=None,
-                **fields,
-            ),
-        )
-
-        _assigned_parameters[created_model] = typevars_map
-
-        if called_globally:  # create global reference and therefore allow pickling
-            object_by_reference = None
-            reference_name = model_name
-            reference_module_globals = sys.modules[created_model.__module__].__dict__
-            while object_by_reference is not created_model:
-                object_by_reference = reference_module_globals.setdefault(reference_name, created_model)
-                reference_name += '_'
-
-        created_model.Config = cls.Config
-
-        # Find any typevars that are still present in the model.
-        # If none are left, the model is fully "concrete", otherwise the new
-        # class is a generic class as well taking the found typevars as
-        # parameters.
-        new_params = tuple(
-            {param: None for param in iter_contained_typevars(typevars_map.values())}
-        )  # use dict as ordered set
-        created_model.__concrete__ = not new_params
-        if new_params:
-            created_model.__parameters__ = new_params
-
-        # Save created model in cache so we don't end up creating duplicate
-        # models that should be identical.
-        _generic_types_cache[_cache_key(params)] = created_model
-        if len(params) == 1:
-            _generic_types_cache[_cache_key(params[0])] = created_model
-
-        # Recursively walk class type hints and replace generic typevars
-        # with concrete types that were passed.
-        _prepare_model_fields(created_model, fields, instance_type_hints, typevars_map)
-
-        return created_model
-
-    @classmethod
-    def __concrete_name__(cls: Type[Any], params: Tuple[Type[Any], ...]) -> str:
-        """Compute class name for child classes.
-
-        :param params: Tuple of types the class . Given a generic class
-            `Model` with 2 type variables and a concrete model `Model[str, int]`,
-            the value `(str, int)` would be passed to `params`.
-        :return: String representing a the new class where `params` are
-            passed to `cls` as type variables.
-
-        This method can be overridden to achieve a custom naming scheme for GenericModels.
-        """
-        param_names = [display_as_type(param) for param in params]
-        params_component = ', '.join(param_names)
-        return f'{cls.__name__}[{params_component}]'
-
-    @classmethod
-    def __parameterized_bases__(cls, typevars_map: Parametrization) -> Iterator[Type[Any]]:
-        """
-        Returns unbound bases of cls parameterised to given type variables
-
-        :param typevars_map: Dictionary of type applications for binding subclasses.
-            Given a generic class `Model` with 2 type variables [S, T]
-            and a concrete model `Model[str, int]`,
-            the value `{S: str, T: int}` would be passed to `typevars_map`.
-        :return: an iterator of generic sub classes, parameterised by `typevars_map`
-            and other assigned parameters of `cls`
-
-        e.g.:
-        ```
-        class A(GenericModel, Generic[T]):
-            ...
-
-        class B(A[V], Generic[V]):
-            ...
-
-        assert A[int] in B.__parameterized_bases__({V: int})
-        ```
-        """
-
-        def build_base_model(
-            base_model: Type[GenericModel], mapped_types: Parametrization
-        ) -> Iterator[Type[GenericModel]]:
-            base_parameters = tuple(mapped_types[param] for param in base_model.__parameters__)
-            parameterized_base = base_model.__class_getitem__(base_parameters)
-            if parameterized_base is base_model or parameterized_base is cls:
-                # Avoid duplication in MRO
-                return
-            yield parameterized_base
-
-        for base_model in cls.__bases__:
-            if not issubclass(base_model, GenericModel):
-                # not a class that can be meaningfully parameterized
-                continue
-            elif not getattr(base_model, '__parameters__', None):
-                # base_model is "GenericModel"  (and has no __parameters__)
-                # or
-                # base_model is already concrete, and will be included transitively via cls.
-                continue
-            elif cls in _assigned_parameters:
-                if base_model in _assigned_parameters:
-                    # cls is partially parameterised but not from base_model
-                    # e.g. cls = B[S], base_model = A[S]
-                    # B[S][int] should subclass A[int],  (and will be transitively via B[int])
-                    # but it's not viable to consistently subclass types with arbitrary construction
-                    # So don't attempt to include A[S][int]
-                    continue
-                else:  # base_model not in _assigned_parameters:
-                    # cls is partially parameterized, base_model is original generic
-                    # e.g.  cls = B[str, T], base_model = B[S, T]
-                    # Need to determine the mapping for the base_model parameters
-                    mapped_types: Parametrization = {
-                        key: typevars_map.get(value, value) for key, value in _assigned_parameters[cls].items()
-                    }
-                    yield from build_base_model(base_model, mapped_types)
-            else:
-                # cls is base generic, so base_class has a distinct base
-                # can construct the Parameterised base model using typevars_map directly
-                yield from build_base_model(base_model, typevars_map)
-
-
-def replace_types(type_: Any, type_map: Mapping[Any, Any]) -> Any:
-    """Return type with all occurrences of `type_map` keys recursively replaced with their values.
-
-    :param type_: Any type, class or generic alias
-    :param type_map: Mapping from `TypeVar` instance to concrete types.
-    :return: New type representing the basic structure of `type_` with all
-        `typevar_map` keys recursively replaced.
-
-    >>> replace_types(Tuple[str, Union[List[str], float]], {str: int})
-    Tuple[int, Union[List[int], float]]
-
-    """
-    if not type_map:
-        return type_
-
-    type_args = get_args(type_)
-    origin_type = get_origin(type_)
-
-    if origin_type is Annotated:
-        annotated_type, *annotations = type_args
-        return Annotated[replace_types(annotated_type, type_map), tuple(annotations)]
-
-    if (origin_type is ExtLiteral) or (sys.version_info >= (3, 8) and origin_type is Literal):
-        return type_map.get(type_, type_)
-    # Having type args is a good indicator that this is a typing module
-    # class instantiation or a generic alias of some sort.
-    if type_args:
-        resolved_type_args = tuple(replace_types(arg, type_map) for arg in type_args)
-        if all_identical(type_args, resolved_type_args):
-            # If all arguments are the same, there is no need to modify the
-            # type or create a new object at all
-            return type_
-        if (
-            origin_type is not None
-            and isinstance(type_, typing_base)
-            and not isinstance(origin_type, typing_base)
-            and getattr(type_, '_name', None) is not None
-        ):
-            # In python < 3.9 generic aliases don't exist so any of these like `list`,
-            # `type` or `collections.abc.Callable` need to be translated.
-            # See: https://www.python.org/dev/peps/pep-0585
-            origin_type = getattr(typing, type_._name)
-        assert origin_type is not None
-        # PEP-604 syntax (Ex.: list | str) is represented with a types.UnionType object that does not have __getitem__.
-        # We also cannot use isinstance() since we have to compare types.
-        if sys.version_info >= (3, 10) and origin_type is types.UnionType:  # noqa: E721
-            return _UnionGenericAlias(origin_type, resolved_type_args)
-        return origin_type[resolved_type_args]
-
-    # We handle pydantic generic models separately as they don't have the same
-    # semantics as "typing" classes or generic aliases
-    if not origin_type and lenient_issubclass(type_, GenericModel) and not type_.__concrete__:
-        type_args = type_.__parameters__
-        resolved_type_args = tuple(replace_types(t, type_map) for t in type_args)
-        if all_identical(type_args, resolved_type_args):
-            return type_
-        return type_[resolved_type_args]
-
-    # Handle special case for typehints that can have lists as arguments.
-    # `typing.Callable[[int, str], int]` is an example for this.
-    if isinstance(type_, (List, list)):
-        resolved_list = list(replace_types(element, type_map) for element in type_)
-        if all_identical(type_, resolved_list):
-            return type_
-        return resolved_list
-
-    # For JsonWrapperValue, need to handle its inner type to allow correct parsing
-    # of generic Json arguments like Json[T]
-    if not origin_type and lenient_issubclass(type_, JsonWrapper):
-        type_.inner_type = replace_types(type_.inner_type, type_map)
-        return type_
-
-    # If all else fails, we try to resolve the type directly and otherwise just
-    # return the input with no modifications.
-    new_type = type_map.get(type_, type_)
-    # Convert string to ForwardRef
-    if isinstance(new_type, str):
-        return ForwardRef(new_type)
-    else:
-        return new_type
-
-
-def check_parameters_count(cls: Type[GenericModel], parameters: Tuple[Any, ...]) -> None:
-    actual = len(parameters)
-    expected = len(cls.__parameters__)
-    if actual != expected:
-        description = 'many' if actual > expected else 'few'
-        raise TypeError(f'Too {description} parameters for {cls.__name__}; actual {actual}, expected {expected}')
-
-
-DictValues: Type[Any] = {}.values().__class__
-
-
-def iter_contained_typevars(v: Any) -> Iterator[TypeVarType]:
-    """Recursively iterate through all subtypes and type args of `v` and yield any typevars that are found."""
-    if isinstance(v, TypeVar):
-        yield v
-    elif hasattr(v, '__parameters__') and not get_origin(v) and lenient_issubclass(v, GenericModel):
-        yield from v.__parameters__
-    elif isinstance(v, (DictValues, list)):
-        for var in v:
-            yield from iter_contained_typevars(var)
-    else:
-        args = get_args(v)
-        for arg in args:
-            yield from iter_contained_typevars(arg)
-
-
-def get_caller_frame_info() -> Tuple[Optional[str], bool]:
-    """
-    Used inside a function to check whether it was called globally
-
-    Will only work against non-compiled code, therefore used only in pydantic.generics
-
-    :returns Tuple[module_name, called_globally]
-    """
-    try:
-        previous_caller_frame = sys._getframe(2)
-    except ValueError as e:
-        raise RuntimeError('This function must be used inside another function') from e
-    except AttributeError:  # sys module does not have _getframe function, so there's nothing we can do about it
-        return None, False
-    frame_globals = previous_caller_frame.f_globals
-    return frame_globals.get('__name__'), previous_caller_frame.f_locals is frame_globals
-
-
-def _prepare_model_fields(
-    created_model: Type[GenericModel],
-    fields: Mapping[str, Any],
-    instance_type_hints: Mapping[str, type],
-    typevars_map: Mapping[Any, type],
-) -> None:
-    """
-    Replace DeferredType fields with concrete type hints and prepare them.
-    """
-
-    for key, field in created_model.__fields__.items():
-        if key not in fields:
-            assert field.type_.__class__ is not DeferredType
-            # https://github.com/nedbat/coveragepy/issues/198
-            continue  # pragma: no cover
-
-        assert field.type_.__class__ is DeferredType, field.type_.__class__
-
-        field_type_hint = instance_type_hints[key]
-        concrete_type = replace_types(field_type_hint, typevars_map)
-        field.type_ = concrete_type
-        field.outer_type_ = concrete_type
-        field.prepare()
-        created_model.__annotations__[key] = concrete_type
diff --git a/lib/pydantic/v1/json.py b/lib/pydantic/v1/json.py
deleted file mode 100644
index b358b850..00000000
--- a/lib/pydantic/v1/json.py
+++ /dev/null
@@ -1,112 +0,0 @@
-import datetime
-from collections import deque
-from decimal import Decimal
-from enum import Enum
-from ipaddress import IPv4Address, IPv4Interface, IPv4Network, IPv6Address, IPv6Interface, IPv6Network
-from pathlib import Path
-from re import Pattern
-from types import GeneratorType
-from typing import Any, Callable, Dict, Type, Union
-from uuid import UUID
-
-from .color import Color
-from .networks import NameEmail
-from .types import SecretBytes, SecretStr
-
-__all__ = 'pydantic_encoder', 'custom_pydantic_encoder', 'timedelta_isoformat'
-
-
-def isoformat(o: Union[datetime.date, datetime.time]) -> str:
-    return o.isoformat()
-
-
-def decimal_encoder(dec_value: Decimal) -> Union[int, float]:
-    """
-    Encodes a Decimal as int of there's no exponent, otherwise float
-
-    This is useful when we use ConstrainedDecimal to represent Numeric(x,0)
-    where a integer (but not int typed) is used. Encoding this as a float
-    results in failed round-tripping between encode and parse.
-    Our Id type is a prime example of this.
-
-    >>> decimal_encoder(Decimal("1.0"))
-    1.0
-
-    >>> decimal_encoder(Decimal("1"))
-    1
-    """
-    if dec_value.as_tuple().exponent >= 0:
-        return int(dec_value)
-    else:
-        return float(dec_value)
-
-
-ENCODERS_BY_TYPE: Dict[Type[Any], Callable[[Any], Any]] = {
-    bytes: lambda o: o.decode(),
-    Color: str,
-    datetime.date: isoformat,
-    datetime.datetime: isoformat,
-    datetime.time: isoformat,
-    datetime.timedelta: lambda td: td.total_seconds(),
-    Decimal: decimal_encoder,
-    Enum: lambda o: o.value,
-    frozenset: list,
-    deque: list,
-    GeneratorType: list,
-    IPv4Address: str,
-    IPv4Interface: str,
-    IPv4Network: str,
-    IPv6Address: str,
-    IPv6Interface: str,
-    IPv6Network: str,
-    NameEmail: str,
-    Path: str,
-    Pattern: lambda o: o.pattern,
-    SecretBytes: str,
-    SecretStr: str,
-    set: list,
-    UUID: str,
-}
-
-
-def pydantic_encoder(obj: Any) -> Any:
-    from dataclasses import asdict, is_dataclass
-
-    from .main import BaseModel
-
-    if isinstance(obj, BaseModel):
-        return obj.dict()
-    elif is_dataclass(obj):
-        return asdict(obj)
-
-    # Check the class type and its superclasses for a matching encoder
-    for base in obj.__class__.__mro__[:-1]:
-        try:
-            encoder = ENCODERS_BY_TYPE[base]
-        except KeyError:
-            continue
-        return encoder(obj)
-    else:  # We have exited the for loop without finding a suitable encoder
-        raise TypeError(f"Object of type '{obj.__class__.__name__}' is not JSON serializable")
-
-
-def custom_pydantic_encoder(type_encoders: Dict[Any, Callable[[Type[Any]], Any]], obj: Any) -> Any:
-    # Check the class type and its superclasses for a matching encoder
-    for base in obj.__class__.__mro__[:-1]:
-        try:
-            encoder = type_encoders[base]
-        except KeyError:
-            continue
-
-        return encoder(obj)
-    else:  # We have exited the for loop without finding a suitable encoder
-        return pydantic_encoder(obj)
-
-
-def timedelta_isoformat(td: datetime.timedelta) -> str:
-    """
-    ISO 8601 encoding for Python timedelta object.
-    """
-    minutes, seconds = divmod(td.seconds, 60)
-    hours, minutes = divmod(minutes, 60)
-    return f'{"-" if td.days < 0 else ""}P{abs(td.days)}DT{hours:d}H{minutes:d}M{seconds:d}.{td.microseconds:06d}S'
diff --git a/lib/pydantic/v1/main.py b/lib/pydantic/v1/main.py
deleted file mode 100644
index 08b8af55..00000000
--- a/lib/pydantic/v1/main.py
+++ /dev/null
@@ -1,1107 +0,0 @@
-import warnings
-from abc import ABCMeta
-from copy import deepcopy
-from enum import Enum
-from functools import partial
-from pathlib import Path
-from types import FunctionType, prepare_class, resolve_bases
-from typing import (
-    TYPE_CHECKING,
-    AbstractSet,
-    Any,
-    Callable,
-    ClassVar,
-    Dict,
-    List,
-    Mapping,
-    Optional,
-    Tuple,
-    Type,
-    TypeVar,
-    Union,
-    cast,
-    no_type_check,
-    overload,
-)
-
-from typing_extensions import dataclass_transform
-
-from .class_validators import ValidatorGroup, extract_root_validators, extract_validators, inherit_validators
-from .config import BaseConfig, Extra, inherit_config, prepare_config
-from .error_wrappers import ErrorWrapper, ValidationError
-from .errors import ConfigError, DictError, ExtraError, MissingError
-from .fields import (
-    MAPPING_LIKE_SHAPES,
-    Field,
-    ModelField,
-    ModelPrivateAttr,
-    PrivateAttr,
-    Undefined,
-    is_finalvar_with_default_val,
-)
-from .json import custom_pydantic_encoder, pydantic_encoder
-from .parse import Protocol, load_file, load_str_bytes
-from .schema import default_ref_template, model_schema
-from .types import PyObject, StrBytes
-from .typing import (
-    AnyCallable,
-    get_args,
-    get_origin,
-    is_classvar,
-    is_namedtuple,
-    is_union,
-    resolve_annotations,
-    update_model_forward_refs,
-)
-from .utils import (
-    DUNDER_ATTRIBUTES,
-    ROOT_KEY,
-    ClassAttribute,
-    GetterDict,
-    Representation,
-    ValueItems,
-    generate_model_signature,
-    is_valid_field,
-    is_valid_private_name,
-    lenient_issubclass,
-    sequence_like,
-    smart_deepcopy,
-    unique_list,
-    validate_field_name,
-)
-
-if TYPE_CHECKING:
-    from inspect import Signature
-
-    from .class_validators import ValidatorListDict
-    from .types import ModelOrDc
-    from .typing import (
-        AbstractSetIntStr,
-        AnyClassMethod,
-        CallableGenerator,
-        DictAny,
-        DictStrAny,
-        MappingIntStrAny,
-        ReprArgs,
-        SetStr,
-        TupleGenerator,
-    )
-
-    Model = TypeVar('Model', bound='BaseModel')
-
-__all__ = 'BaseModel', 'create_model', 'validate_model'
-
-_T = TypeVar('_T')
-
-
-def validate_custom_root_type(fields: Dict[str, ModelField]) -> None:
-    if len(fields) > 1:
-        raise ValueError(f'{ROOT_KEY} cannot be mixed with other fields')
-
-
-def generate_hash_function(frozen: bool) -> Optional[Callable[[Any], int]]:
-    def hash_function(self_: Any) -> int:
-        return hash(self_.__class__) + hash(tuple(self_.__dict__.values()))
-
-    return hash_function if frozen else None
-
-
-# If a field is of type `Callable`, its default value should be a function and cannot to ignored.
-ANNOTATED_FIELD_UNTOUCHED_TYPES: Tuple[Any, ...] = (property, type, classmethod, staticmethod)
-# When creating a `BaseModel` instance, we bypass all the methods, properties... added to the model
-UNTOUCHED_TYPES: Tuple[Any, ...] = (FunctionType,) + ANNOTATED_FIELD_UNTOUCHED_TYPES
-# Note `ModelMetaclass` refers to `BaseModel`, but is also used to *create* `BaseModel`, so we need to add this extra
-# (somewhat hacky) boolean to keep track of whether we've created the `BaseModel` class yet, and therefore whether it's
-# safe to refer to it. If it *hasn't* been created, we assume that the `__new__` call we're in the middle of is for
-# the `BaseModel` class, since that's defined immediately after the metaclass.
-_is_base_model_class_defined = False
-
-
-@dataclass_transform(kw_only_default=True, field_specifiers=(Field,))
-class ModelMetaclass(ABCMeta):
-    @no_type_check  # noqa C901
-    def __new__(mcs, name, bases, namespace, **kwargs):  # noqa C901
-        fields: Dict[str, ModelField] = {}
-        config = BaseConfig
-        validators: 'ValidatorListDict' = {}
-
-        pre_root_validators, post_root_validators = [], []
-        private_attributes: Dict[str, ModelPrivateAttr] = {}
-        base_private_attributes: Dict[str, ModelPrivateAttr] = {}
-        slots: SetStr = namespace.get('__slots__', ())
-        slots = {slots} if isinstance(slots, str) else set(slots)
-        class_vars: SetStr = set()
-        hash_func: Optional[Callable[[Any], int]] = None
-
-        for base in reversed(bases):
-            if _is_base_model_class_defined and issubclass(base, BaseModel) and base != BaseModel:
-                fields.update(smart_deepcopy(base.__fields__))
-                config = inherit_config(base.__config__, config)
-                validators = inherit_validators(base.__validators__, validators)
-                pre_root_validators += base.__pre_root_validators__
-                post_root_validators += base.__post_root_validators__
-                base_private_attributes.update(base.__private_attributes__)
-                class_vars.update(base.__class_vars__)
-                hash_func = base.__hash__
-
-        resolve_forward_refs = kwargs.pop('__resolve_forward_refs__', True)
-        allowed_config_kwargs: SetStr = {
-            key
-            for key in dir(config)
-            if not (key.startswith('__') and key.endswith('__'))  # skip dunder methods and attributes
-        }
-        config_kwargs = {key: kwargs.pop(key) for key in kwargs.keys() & allowed_config_kwargs}
-        config_from_namespace = namespace.get('Config')
-        if config_kwargs and config_from_namespace:
-            raise TypeError('Specifying config in two places is ambiguous, use either Config attribute or class kwargs')
-        config = inherit_config(config_from_namespace, config, **config_kwargs)
-
-        validators = inherit_validators(extract_validators(namespace), validators)
-        vg = ValidatorGroup(validators)
-
-        for f in fields.values():
-            f.set_config(config)
-            extra_validators = vg.get_validators(f.name)
-            if extra_validators:
-                f.class_validators.update(extra_validators)
-                # re-run prepare to add extra validators
-                f.populate_validators()
-
-        prepare_config(config, name)
-
-        untouched_types = ANNOTATED_FIELD_UNTOUCHED_TYPES
-
-        def is_untouched(v: Any) -> bool:
-            return isinstance(v, untouched_types) or v.__class__.__name__ == 'cython_function_or_method'
-
-        if (namespace.get('__module__'), namespace.get('__qualname__')) != ('pydantic.main', 'BaseModel'):
-            annotations = resolve_annotations(namespace.get('__annotations__', {}), namespace.get('__module__', None))
-            # annotation only fields need to come first in fields
-            for ann_name, ann_type in annotations.items():
-                if is_classvar(ann_type):
-                    class_vars.add(ann_name)
-                elif is_finalvar_with_default_val(ann_type, namespace.get(ann_name, Undefined)):
-                    class_vars.add(ann_name)
-                elif is_valid_field(ann_name):
-                    validate_field_name(bases, ann_name)
-                    value = namespace.get(ann_name, Undefined)
-                    allowed_types = get_args(ann_type) if is_union(get_origin(ann_type)) else (ann_type,)
-                    if (
-                        is_untouched(value)
-                        and ann_type != PyObject
-                        and not any(
-                            lenient_issubclass(get_origin(allowed_type), Type) for allowed_type in allowed_types
-                        )
-                    ):
-                        continue
-                    fields[ann_name] = ModelField.infer(
-                        name=ann_name,
-                        value=value,
-                        annotation=ann_type,
-                        class_validators=vg.get_validators(ann_name),
-                        config=config,
-                    )
-                elif ann_name not in namespace and config.underscore_attrs_are_private:
-                    private_attributes[ann_name] = PrivateAttr()
-
-            untouched_types = UNTOUCHED_TYPES + config.keep_untouched
-            for var_name, value in namespace.items():
-                can_be_changed = var_name not in class_vars and not is_untouched(value)
-                if isinstance(value, ModelPrivateAttr):
-                    if not is_valid_private_name(var_name):
-                        raise NameError(
-                            f'Private attributes "{var_name}" must not be a valid field name; '
-                            f'Use sunder or dunder names, e. g. "_{var_name}" or "__{var_name}__"'
-                        )
-                    private_attributes[var_name] = value
-                elif config.underscore_attrs_are_private and is_valid_private_name(var_name) and can_be_changed:
-                    private_attributes[var_name] = PrivateAttr(default=value)
-                elif is_valid_field(var_name) and var_name not in annotations and can_be_changed:
-                    validate_field_name(bases, var_name)
-                    inferred = ModelField.infer(
-                        name=var_name,
-                        value=value,
-                        annotation=annotations.get(var_name, Undefined),
-                        class_validators=vg.get_validators(var_name),
-                        config=config,
-                    )
-                    if var_name in fields:
-                        if lenient_issubclass(inferred.type_, fields[var_name].type_):
-                            inferred.type_ = fields[var_name].type_
-                        else:
-                            raise TypeError(
-                                f'The type of {name}.{var_name} differs from the new default value; '
-                                f'if you wish to change the type of this field, please use a type annotation'
-                            )
-                    fields[var_name] = inferred
-
-        _custom_root_type = ROOT_KEY in fields
-        if _custom_root_type:
-            validate_custom_root_type(fields)
-        vg.check_for_unused()
-        if config.json_encoders:
-            json_encoder = partial(custom_pydantic_encoder, config.json_encoders)
-        else:
-            json_encoder = pydantic_encoder
-        pre_rv_new, post_rv_new = extract_root_validators(namespace)
-
-        if hash_func is None:
-            hash_func = generate_hash_function(config.frozen)
-
-        exclude_from_namespace = fields | private_attributes.keys() | {'__slots__'}
-        new_namespace = {
-            '__config__': config,
-            '__fields__': fields,
-            '__exclude_fields__': {
-                name: field.field_info.exclude for name, field in fields.items() if field.field_info.exclude is not None
-            }
-            or None,
-            '__include_fields__': {
-                name: field.field_info.include for name, field in fields.items() if field.field_info.include is not None
-            }
-            or None,
-            '__validators__': vg.validators,
-            '__pre_root_validators__': unique_list(
-                pre_root_validators + pre_rv_new,
-                name_factory=lambda v: v.__name__,
-            ),
-            '__post_root_validators__': unique_list(
-                post_root_validators + post_rv_new,
-                name_factory=lambda skip_on_failure_and_v: skip_on_failure_and_v[1].__name__,
-            ),
-            '__schema_cache__': {},
-            '__json_encoder__': staticmethod(json_encoder),
-            '__custom_root_type__': _custom_root_type,
-            '__private_attributes__': {**base_private_attributes, **private_attributes},
-            '__slots__': slots | private_attributes.keys(),
-            '__hash__': hash_func,
-            '__class_vars__': class_vars,
-            **{n: v for n, v in namespace.items() if n not in exclude_from_namespace},
-        }
-
-        cls = super().__new__(mcs, name, bases, new_namespace, **kwargs)
-        # set __signature__ attr only for model class, but not for its instances
-        cls.__signature__ = ClassAttribute('__signature__', generate_model_signature(cls.__init__, fields, config))
-        if resolve_forward_refs:
-            cls.__try_update_forward_refs__()
-
-        # preserve `__set_name__` protocol defined in https://peps.python.org/pep-0487
-        # for attributes not in `new_namespace` (e.g. private attributes)
-        for name, obj in namespace.items():
-            if name not in new_namespace:
-                set_name = getattr(obj, '__set_name__', None)
-                if callable(set_name):
-                    set_name(cls, name)
-
-        return cls
-
-    def __instancecheck__(self, instance: Any) -> bool:
-        """
-        Avoid calling ABC _abc_subclasscheck unless we're pretty sure.
-
-        See #3829 and python/cpython#92810
-        """
-        return hasattr(instance, '__fields__') and super().__instancecheck__(instance)
-
-
-object_setattr = object.__setattr__
-
-
-class BaseModel(Representation, metaclass=ModelMetaclass):
-    if TYPE_CHECKING:
-        # populated by the metaclass, defined here to help IDEs only
-        __fields__: ClassVar[Dict[str, ModelField]] = {}
-        __include_fields__: ClassVar[Optional[Mapping[str, Any]]] = None
-        __exclude_fields__: ClassVar[Optional[Mapping[str, Any]]] = None
-        __validators__: ClassVar[Dict[str, AnyCallable]] = {}
-        __pre_root_validators__: ClassVar[List[AnyCallable]]
-        __post_root_validators__: ClassVar[List[Tuple[bool, AnyCallable]]]
-        __config__: ClassVar[Type[BaseConfig]] = BaseConfig
-        __json_encoder__: ClassVar[Callable[[Any], Any]] = lambda x: x
-        __schema_cache__: ClassVar['DictAny'] = {}
-        __custom_root_type__: ClassVar[bool] = False
-        __signature__: ClassVar['Signature']
-        __private_attributes__: ClassVar[Dict[str, ModelPrivateAttr]]
-        __class_vars__: ClassVar[SetStr]
-        __fields_set__: ClassVar[SetStr] = set()
-
-    Config = BaseConfig
-    __slots__ = ('__dict__', '__fields_set__')
-    __doc__ = ''  # Null out the Representation docstring
-
-    def __init__(__pydantic_self__, **data: Any) -> None:
-        """
-        Create a new model by parsing and validating input data from keyword arguments.
-
-        Raises ValidationError if the input data cannot be parsed to form a valid model.
-        """
-        # Uses something other than `self` the first arg to allow "self" as a settable attribute
-        values, fields_set, validation_error = validate_model(__pydantic_self__.__class__, data)
-        if validation_error:
-            raise validation_error
-        try:
-            object_setattr(__pydantic_self__, '__dict__', values)
-        except TypeError as e:
-            raise TypeError(
-                'Model values must be a dict; you may not have returned a dictionary from a root validator'
-            ) from e
-        object_setattr(__pydantic_self__, '__fields_set__', fields_set)
-        __pydantic_self__._init_private_attributes()
-
-    @no_type_check
-    def __setattr__(self, name, value):  # noqa: C901 (ignore complexity)
-        if name in self.__private_attributes__ or name in DUNDER_ATTRIBUTES:
-            return object_setattr(self, name, value)
-
-        if self.__config__.extra is not Extra.allow and name not in self.__fields__:
-            raise ValueError(f'"{self.__class__.__name__}" object has no field "{name}"')
-        elif not self.__config__.allow_mutation or self.__config__.frozen:
-            raise TypeError(f'"{self.__class__.__name__}" is immutable and does not support item assignment')
-        elif name in self.__fields__ and self.__fields__[name].final:
-            raise TypeError(
-                f'"{self.__class__.__name__}" object "{name}" field is final and does not support reassignment'
-            )
-        elif self.__config__.validate_assignment:
-            new_values = {**self.__dict__, name: value}
-
-            for validator in self.__pre_root_validators__:
-                try:
-                    new_values = validator(self.__class__, new_values)
-                except (ValueError, TypeError, AssertionError) as exc:
-                    raise ValidationError([ErrorWrapper(exc, loc=ROOT_KEY)], self.__class__)
-
-            known_field = self.__fields__.get(name, None)
-            if known_field:
-                # We want to
-                # - make sure validators are called without the current value for this field inside `values`
-                # - keep other values (e.g. submodels) untouched (using `BaseModel.dict()` will change them into dicts)
-                # - keep the order of the fields
-                if not known_field.field_info.allow_mutation:
-                    raise TypeError(f'"{known_field.name}" has allow_mutation set to False and cannot be assigned')
-                dict_without_original_value = {k: v for k, v in self.__dict__.items() if k != name}
-                value, error_ = known_field.validate(value, dict_without_original_value, loc=name, cls=self.__class__)
-                if error_:
-                    raise ValidationError([error_], self.__class__)
-                else:
-                    new_values[name] = value
-
-            errors = []
-            for skip_on_failure, validator in self.__post_root_validators__:
-                if skip_on_failure and errors:
-                    continue
-                try:
-                    new_values = validator(self.__class__, new_values)
-                except (ValueError, TypeError, AssertionError) as exc:
-                    errors.append(ErrorWrapper(exc, loc=ROOT_KEY))
-            if errors:
-                raise ValidationError(errors, self.__class__)
-
-            # update the whole __dict__ as other values than just `value`
-            # may be changed (e.g. with `root_validator`)
-            object_setattr(self, '__dict__', new_values)
-        else:
-            self.__dict__[name] = value
-
-        self.__fields_set__.add(name)
-
-    def __getstate__(self) -> 'DictAny':
-        private_attrs = ((k, getattr(self, k, Undefined)) for k in self.__private_attributes__)
-        return {
-            '__dict__': self.__dict__,
-            '__fields_set__': self.__fields_set__,
-            '__private_attribute_values__': {k: v for k, v in private_attrs if v is not Undefined},
-        }
-
-    def __setstate__(self, state: 'DictAny') -> None:
-        object_setattr(self, '__dict__', state['__dict__'])
-        object_setattr(self, '__fields_set__', state['__fields_set__'])
-        for name, value in state.get('__private_attribute_values__', {}).items():
-            object_setattr(self, name, value)
-
-    def _init_private_attributes(self) -> None:
-        for name, private_attr in self.__private_attributes__.items():
-            default = private_attr.get_default()
-            if default is not Undefined:
-                object_setattr(self, name, default)
-
-    def dict(
-        self,
-        *,
-        include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
-        exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
-        by_alias: bool = False,
-        skip_defaults: Optional[bool] = None,
-        exclude_unset: bool = False,
-        exclude_defaults: bool = False,
-        exclude_none: bool = False,
-    ) -> 'DictStrAny':
-        """
-        Generate a dictionary representation of the model, optionally specifying which fields to include or exclude.
-
-        """
-        if skip_defaults is not None:
-            warnings.warn(
-                f'{self.__class__.__name__}.dict(): "skip_defaults" is deprecated and replaced by "exclude_unset"',
-                DeprecationWarning,
-            )
-            exclude_unset = skip_defaults
-
-        return dict(
-            self._iter(
-                to_dict=True,
-                by_alias=by_alias,
-                include=include,
-                exclude=exclude,
-                exclude_unset=exclude_unset,
-                exclude_defaults=exclude_defaults,
-                exclude_none=exclude_none,
-            )
-        )
-
-    def json(
-        self,
-        *,
-        include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
-        exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
-        by_alias: bool = False,
-        skip_defaults: Optional[bool] = None,
-        exclude_unset: bool = False,
-        exclude_defaults: bool = False,
-        exclude_none: bool = False,
-        encoder: Optional[Callable[[Any], Any]] = None,
-        models_as_dict: bool = True,
-        **dumps_kwargs: Any,
-    ) -> str:
-        """
-        Generate a JSON representation of the model, `include` and `exclude` arguments as per `dict()`.
-
-        `encoder` is an optional function to supply as `default` to json.dumps(), other arguments as per `json.dumps()`.
-        """
-        if skip_defaults is not None:
-            warnings.warn(
-                f'{self.__class__.__name__}.json(): "skip_defaults" is deprecated and replaced by "exclude_unset"',
-                DeprecationWarning,
-            )
-            exclude_unset = skip_defaults
-        encoder = cast(Callable[[Any], Any], encoder or self.__json_encoder__)
-
-        # We don't directly call `self.dict()`, which does exactly this with `to_dict=True`
-        # because we want to be able to keep raw `BaseModel` instances and not as `dict`.
-        # This allows users to write custom JSON encoders for given `BaseModel` classes.
-        data = dict(
-            self._iter(
-                to_dict=models_as_dict,
-                by_alias=by_alias,
-                include=include,
-                exclude=exclude,
-                exclude_unset=exclude_unset,
-                exclude_defaults=exclude_defaults,
-                exclude_none=exclude_none,
-            )
-        )
-        if self.__custom_root_type__:
-            data = data[ROOT_KEY]
-        return self.__config__.json_dumps(data, default=encoder, **dumps_kwargs)
-
-    @classmethod
-    def _enforce_dict_if_root(cls, obj: Any) -> Any:
-        if cls.__custom_root_type__ and (
-            not (isinstance(obj, dict) and obj.keys() == {ROOT_KEY})
-            and not (isinstance(obj, BaseModel) and obj.__fields__.keys() == {ROOT_KEY})
-            or cls.__fields__[ROOT_KEY].shape in MAPPING_LIKE_SHAPES
-        ):
-            return {ROOT_KEY: obj}
-        else:
-            return obj
-
-    @classmethod
-    def parse_obj(cls: Type['Model'], obj: Any) -> 'Model':
-        obj = cls._enforce_dict_if_root(obj)
-        if not isinstance(obj, dict):
-            try:
-                obj = dict(obj)
-            except (TypeError, ValueError) as e:
-                exc = TypeError(f'{cls.__name__} expected dict not {obj.__class__.__name__}')
-                raise ValidationError([ErrorWrapper(exc, loc=ROOT_KEY)], cls) from e
-        return cls(**obj)
-
-    @classmethod
-    def parse_raw(
-        cls: Type['Model'],
-        b: StrBytes,
-        *,
-        content_type: str = None,
-        encoding: str = 'utf8',
-        proto: Protocol = None,
-        allow_pickle: bool = False,
-    ) -> 'Model':
-        try:
-            obj = load_str_bytes(
-                b,
-                proto=proto,
-                content_type=content_type,
-                encoding=encoding,
-                allow_pickle=allow_pickle,
-                json_loads=cls.__config__.json_loads,
-            )
-        except (ValueError, TypeError, UnicodeDecodeError) as e:
-            raise ValidationError([ErrorWrapper(e, loc=ROOT_KEY)], cls)
-        return cls.parse_obj(obj)
-
-    @classmethod
-    def parse_file(
-        cls: Type['Model'],
-        path: Union[str, Path],
-        *,
-        content_type: str = None,
-        encoding: str = 'utf8',
-        proto: Protocol = None,
-        allow_pickle: bool = False,
-    ) -> 'Model':
-        obj = load_file(
-            path,
-            proto=proto,
-            content_type=content_type,
-            encoding=encoding,
-            allow_pickle=allow_pickle,
-            json_loads=cls.__config__.json_loads,
-        )
-        return cls.parse_obj(obj)
-
-    @classmethod
-    def from_orm(cls: Type['Model'], obj: Any) -> 'Model':
-        if not cls.__config__.orm_mode:
-            raise ConfigError('You must have the config attribute orm_mode=True to use from_orm')
-        obj = {ROOT_KEY: obj} if cls.__custom_root_type__ else cls._decompose_class(obj)
-        m = cls.__new__(cls)
-        values, fields_set, validation_error = validate_model(cls, obj)
-        if validation_error:
-            raise validation_error
-        object_setattr(m, '__dict__', values)
-        object_setattr(m, '__fields_set__', fields_set)
-        m._init_private_attributes()
-        return m
-
-    @classmethod
-    def construct(cls: Type['Model'], _fields_set: Optional['SetStr'] = None, **values: Any) -> 'Model':
-        """
-        Creates a new model setting __dict__ and __fields_set__ from trusted or pre-validated data.
-        Default values are respected, but no other validation is performed.
-        Behaves as if `Config.extra = 'allow'` was set since it adds all passed values
-        """
-        m = cls.__new__(cls)
-        fields_values: Dict[str, Any] = {}
-        for name, field in cls.__fields__.items():
-            if field.alt_alias and field.alias in values:
-                fields_values[name] = values[field.alias]
-            elif name in values:
-                fields_values[name] = values[name]
-            elif not field.required:
-                fields_values[name] = field.get_default()
-        fields_values.update(values)
-        object_setattr(m, '__dict__', fields_values)
-        if _fields_set is None:
-            _fields_set = set(values.keys())
-        object_setattr(m, '__fields_set__', _fields_set)
-        m._init_private_attributes()
-        return m
-
-    def _copy_and_set_values(self: 'Model', values: 'DictStrAny', fields_set: 'SetStr', *, deep: bool) -> 'Model':
-        if deep:
-            # chances of having empty dict here are quite low for using smart_deepcopy
-            values = deepcopy(values)
-
-        cls = self.__class__
-        m = cls.__new__(cls)
-        object_setattr(m, '__dict__', values)
-        object_setattr(m, '__fields_set__', fields_set)
-        for name in self.__private_attributes__:
-            value = getattr(self, name, Undefined)
-            if value is not Undefined:
-                if deep:
-                    value = deepcopy(value)
-                object_setattr(m, name, value)
-
-        return m
-
-    def copy(
-        self: 'Model',
-        *,
-        include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
-        exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
-        update: Optional['DictStrAny'] = None,
-        deep: bool = False,
-    ) -> 'Model':
-        """
-        Duplicate a model, optionally choose which fields to include, exclude and change.
-
-        :param include: fields to include in new model
-        :param exclude: fields to exclude from new model, as with values this takes precedence over include
-        :param update: values to change/add in the new model. Note: the data is not validated before creating
-            the new model: you should trust this data
-        :param deep: set to `True` to make a deep copy of the model
-        :return: new model instance
-        """
-
-        values = dict(
-            self._iter(to_dict=False, by_alias=False, include=include, exclude=exclude, exclude_unset=False),
-            **(update or {}),
-        )
-
-        # new `__fields_set__` can have unset optional fields with a set value in `update` kwarg
-        if update:
-            fields_set = self.__fields_set__ | update.keys()
-        else:
-            fields_set = set(self.__fields_set__)
-
-        return self._copy_and_set_values(values, fields_set, deep=deep)
-
-    @classmethod
-    def schema(cls, by_alias: bool = True, ref_template: str = default_ref_template) -> 'DictStrAny':
-        cached = cls.__schema_cache__.get((by_alias, ref_template))
-        if cached is not None:
-            return cached
-        s = model_schema(cls, by_alias=by_alias, ref_template=ref_template)
-        cls.__schema_cache__[(by_alias, ref_template)] = s
-        return s
-
-    @classmethod
-    def schema_json(
-        cls, *, by_alias: bool = True, ref_template: str = default_ref_template, **dumps_kwargs: Any
-    ) -> str:
-        from .json import pydantic_encoder
-
-        return cls.__config__.json_dumps(
-            cls.schema(by_alias=by_alias, ref_template=ref_template), default=pydantic_encoder, **dumps_kwargs
-        )
-
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield cls.validate
-
-    @classmethod
-    def validate(cls: Type['Model'], value: Any) -> 'Model':
-        if isinstance(value, cls):
-            copy_on_model_validation = cls.__config__.copy_on_model_validation
-            # whether to deep or shallow copy the model on validation, None means do not copy
-            deep_copy: Optional[bool] = None
-            if copy_on_model_validation not in {'deep', 'shallow', 'none'}:
-                # Warn about deprecated behavior
-                warnings.warn(
-                    "`copy_on_model_validation` should be a string: 'deep', 'shallow' or 'none'", DeprecationWarning
-                )
-                if copy_on_model_validation:
-                    deep_copy = False
-
-            if copy_on_model_validation == 'shallow':
-                # shallow copy
-                deep_copy = False
-            elif copy_on_model_validation == 'deep':
-                # deep copy
-                deep_copy = True
-
-            if deep_copy is None:
-                return value
-            else:
-                return value._copy_and_set_values(value.__dict__, value.__fields_set__, deep=deep_copy)
-
-        value = cls._enforce_dict_if_root(value)
-
-        if isinstance(value, dict):
-            return cls(**value)
-        elif cls.__config__.orm_mode:
-            return cls.from_orm(value)
-        else:
-            try:
-                value_as_dict = dict(value)
-            except (TypeError, ValueError) as e:
-                raise DictError() from e
-            return cls(**value_as_dict)
-
-    @classmethod
-    def _decompose_class(cls: Type['Model'], obj: Any) -> GetterDict:
-        if isinstance(obj, GetterDict):
-            return obj
-        return cls.__config__.getter_dict(obj)
-
-    @classmethod
-    @no_type_check
-    def _get_value(
-        cls,
-        v: Any,
-        to_dict: bool,
-        by_alias: bool,
-        include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']],
-        exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']],
-        exclude_unset: bool,
-        exclude_defaults: bool,
-        exclude_none: bool,
-    ) -> Any:
-        if isinstance(v, BaseModel):
-            if to_dict:
-                v_dict = v.dict(
-                    by_alias=by_alias,
-                    exclude_unset=exclude_unset,
-                    exclude_defaults=exclude_defaults,
-                    include=include,
-                    exclude=exclude,
-                    exclude_none=exclude_none,
-                )
-                if ROOT_KEY in v_dict:
-                    return v_dict[ROOT_KEY]
-                return v_dict
-            else:
-                return v.copy(include=include, exclude=exclude)
-
-        value_exclude = ValueItems(v, exclude) if exclude else None
-        value_include = ValueItems(v, include) if include else None
-
-        if isinstance(v, dict):
-            return {
-                k_: cls._get_value(
-                    v_,
-                    to_dict=to_dict,
-                    by_alias=by_alias,
-                    exclude_unset=exclude_unset,
-                    exclude_defaults=exclude_defaults,
-                    include=value_include and value_include.for_element(k_),
-                    exclude=value_exclude and value_exclude.for_element(k_),
-                    exclude_none=exclude_none,
-                )
-                for k_, v_ in v.items()
-                if (not value_exclude or not value_exclude.is_excluded(k_))
-                and (not value_include or value_include.is_included(k_))
-            }
-
-        elif sequence_like(v):
-            seq_args = (
-                cls._get_value(
-                    v_,
-                    to_dict=to_dict,
-                    by_alias=by_alias,
-                    exclude_unset=exclude_unset,
-                    exclude_defaults=exclude_defaults,
-                    include=value_include and value_include.for_element(i),
-                    exclude=value_exclude and value_exclude.for_element(i),
-                    exclude_none=exclude_none,
-                )
-                for i, v_ in enumerate(v)
-                if (not value_exclude or not value_exclude.is_excluded(i))
-                and (not value_include or value_include.is_included(i))
-            )
-
-            return v.__class__(*seq_args) if is_namedtuple(v.__class__) else v.__class__(seq_args)
-
-        elif isinstance(v, Enum) and getattr(cls.Config, 'use_enum_values', False):
-            return v.value
-
-        else:
-            return v
-
-    @classmethod
-    def __try_update_forward_refs__(cls, **localns: Any) -> None:
-        """
-        Same as update_forward_refs but will not raise exception
-        when forward references are not defined.
-        """
-        update_model_forward_refs(cls, cls.__fields__.values(), cls.__config__.json_encoders, localns, (NameError,))
-
-    @classmethod
-    def update_forward_refs(cls, **localns: Any) -> None:
-        """
-        Try to update ForwardRefs on fields based on this Model, globalns and localns.
-        """
-        update_model_forward_refs(cls, cls.__fields__.values(), cls.__config__.json_encoders, localns)
-
-    def __iter__(self) -> 'TupleGenerator':
-        """
-        so `dict(model)` works
-        """
-        yield from self.__dict__.items()
-
-    def _iter(
-        self,
-        to_dict: bool = False,
-        by_alias: bool = False,
-        include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
-        exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
-        exclude_unset: bool = False,
-        exclude_defaults: bool = False,
-        exclude_none: bool = False,
-    ) -> 'TupleGenerator':
-        # Merge field set excludes with explicit exclude parameter with explicit overriding field set options.
-        # The extra "is not None" guards are not logically necessary but optimizes performance for the simple case.
-        if exclude is not None or self.__exclude_fields__ is not None:
-            exclude = ValueItems.merge(self.__exclude_fields__, exclude)
-
-        if include is not None or self.__include_fields__ is not None:
-            include = ValueItems.merge(self.__include_fields__, include, intersect=True)
-
-        allowed_keys = self._calculate_keys(
-            include=include, exclude=exclude, exclude_unset=exclude_unset  # type: ignore
-        )
-        if allowed_keys is None and not (to_dict or by_alias or exclude_unset or exclude_defaults or exclude_none):
-            # huge boost for plain _iter()
-            yield from self.__dict__.items()
-            return
-
-        value_exclude = ValueItems(self, exclude) if exclude is not None else None
-        value_include = ValueItems(self, include) if include is not None else None
-
-        for field_key, v in self.__dict__.items():
-            if (allowed_keys is not None and field_key not in allowed_keys) or (exclude_none and v is None):
-                continue
-
-            if exclude_defaults:
-                model_field = self.__fields__.get(field_key)
-                if not getattr(model_field, 'required', True) and getattr(model_field, 'default', _missing) == v:
-                    continue
-
-            if by_alias and field_key in self.__fields__:
-                dict_key = self.__fields__[field_key].alias
-            else:
-                dict_key = field_key
-
-            if to_dict or value_include or value_exclude:
-                v = self._get_value(
-                    v,
-                    to_dict=to_dict,
-                    by_alias=by_alias,
-                    include=value_include and value_include.for_element(field_key),
-                    exclude=value_exclude and value_exclude.for_element(field_key),
-                    exclude_unset=exclude_unset,
-                    exclude_defaults=exclude_defaults,
-                    exclude_none=exclude_none,
-                )
-            yield dict_key, v
-
-    def _calculate_keys(
-        self,
-        include: Optional['MappingIntStrAny'],
-        exclude: Optional['MappingIntStrAny'],
-        exclude_unset: bool,
-        update: Optional['DictStrAny'] = None,
-    ) -> Optional[AbstractSet[str]]:
-        if include is None and exclude is None and exclude_unset is False:
-            return None
-
-        keys: AbstractSet[str]
-        if exclude_unset:
-            keys = self.__fields_set__.copy()
-        else:
-            keys = self.__dict__.keys()
-
-        if include is not None:
-            keys &= include.keys()
-
-        if update:
-            keys -= update.keys()
-
-        if exclude:
-            keys -= {k for k, v in exclude.items() if ValueItems.is_true(v)}
-
-        return keys
-
-    def __eq__(self, other: Any) -> bool:
-        if isinstance(other, BaseModel):
-            return self.dict() == other.dict()
-        else:
-            return self.dict() == other
-
-    def __repr_args__(self) -> 'ReprArgs':
-        return [
-            (k, v)
-            for k, v in self.__dict__.items()
-            if k not in DUNDER_ATTRIBUTES and (k not in self.__fields__ or self.__fields__[k].field_info.repr)
-        ]
-
-
-_is_base_model_class_defined = True
-
-
-@overload
-def create_model(
-    __model_name: str,
-    *,
-    __config__: Optional[Type[BaseConfig]] = None,
-    __base__: None = None,
-    __module__: str = __name__,
-    __validators__: Dict[str, 'AnyClassMethod'] = None,
-    __cls_kwargs__: Dict[str, Any] = None,
-    **field_definitions: Any,
-) -> Type['BaseModel']:
-    ...
-
-
-@overload
-def create_model(
-    __model_name: str,
-    *,
-    __config__: Optional[Type[BaseConfig]] = None,
-    __base__: Union[Type['Model'], Tuple[Type['Model'], ...]],
-    __module__: str = __name__,
-    __validators__: Dict[str, 'AnyClassMethod'] = None,
-    __cls_kwargs__: Dict[str, Any] = None,
-    **field_definitions: Any,
-) -> Type['Model']:
-    ...
-
-
-def create_model(
-    __model_name: str,
-    *,
-    __config__: Optional[Type[BaseConfig]] = None,
-    __base__: Union[None, Type['Model'], Tuple[Type['Model'], ...]] = None,
-    __module__: str = __name__,
-    __validators__: Dict[str, 'AnyClassMethod'] = None,
-    __cls_kwargs__: Dict[str, Any] = None,
-    __slots__: Optional[Tuple[str, ...]] = None,
-    **field_definitions: Any,
-) -> Type['Model']:
-    """
-    Dynamically create a model.
-    :param __model_name: name of the created model
-    :param __config__: config class to use for the new model
-    :param __base__: base class for the new model to inherit from
-    :param __module__: module of the created model
-    :param __validators__: a dict of method names and @validator class methods
-    :param __cls_kwargs__: a dict for class creation
-    :param __slots__: Deprecated, `__slots__` should not be passed to `create_model`
-    :param field_definitions: fields of the model (or extra fields if a base is supplied)
-        in the format `<name>=(<type>, <default default>)` or `<name>=<default value>, e.g.
-        `foobar=(str, ...)` or `foobar=123`, or, for complex use-cases, in the format
-        `<name>=<Field>` or `<name>=(<type>, <FieldInfo>)`, e.g.
-        `foo=Field(datetime, default_factory=datetime.utcnow, alias='bar')` or
-        `foo=(str, FieldInfo(title='Foo'))`
-    """
-    if __slots__ is not None:
-        # __slots__ will be ignored from here on
-        warnings.warn('__slots__ should not be passed to create_model', RuntimeWarning)
-
-    if __base__ is not None:
-        if __config__ is not None:
-            raise ConfigError('to avoid confusion __config__ and __base__ cannot be used together')
-        if not isinstance(__base__, tuple):
-            __base__ = (__base__,)
-    else:
-        __base__ = (cast(Type['Model'], BaseModel),)
-
-    __cls_kwargs__ = __cls_kwargs__ or {}
-
-    fields = {}
-    annotations = {}
-
-    for f_name, f_def in field_definitions.items():
-        if not is_valid_field(f_name):
-            warnings.warn(f'fields may not start with an underscore, ignoring "{f_name}"', RuntimeWarning)
-        if isinstance(f_def, tuple):
-            try:
-                f_annotation, f_value = f_def
-            except ValueError as e:
-                raise ConfigError(
-                    'field definitions should either be a tuple of (<type>, <default>) or just a '
-                    'default value, unfortunately this means tuples as '
-                    'default values are not allowed'
-                ) from e
-        else:
-            f_annotation, f_value = None, f_def
-
-        if f_annotation:
-            annotations[f_name] = f_annotation
-        fields[f_name] = f_value
-
-    namespace: 'DictStrAny' = {'__annotations__': annotations, '__module__': __module__}
-    if __validators__:
-        namespace.update(__validators__)
-    namespace.update(fields)
-    if __config__:
-        namespace['Config'] = inherit_config(__config__, BaseConfig)
-    resolved_bases = resolve_bases(__base__)
-    meta, ns, kwds = prepare_class(__model_name, resolved_bases, kwds=__cls_kwargs__)
-    if resolved_bases is not __base__:
-        ns['__orig_bases__'] = __base__
-    namespace.update(ns)
-    return meta(__model_name, resolved_bases, namespace, **kwds)
-
-
-_missing = object()
-
-
-def validate_model(  # noqa: C901 (ignore complexity)
-    model: Type[BaseModel], input_data: 'DictStrAny', cls: 'ModelOrDc' = None
-) -> Tuple['DictStrAny', 'SetStr', Optional[ValidationError]]:
-    """
-    validate data against a model.
-    """
-    values = {}
-    errors = []
-    # input_data names, possibly alias
-    names_used = set()
-    # field names, never aliases
-    fields_set = set()
-    config = model.__config__
-    check_extra = config.extra is not Extra.ignore
-    cls_ = cls or model
-
-    for validator in model.__pre_root_validators__:
-        try:
-            input_data = validator(cls_, input_data)
-        except (ValueError, TypeError, AssertionError) as exc:
-            return {}, set(), ValidationError([ErrorWrapper(exc, loc=ROOT_KEY)], cls_)
-
-    for name, field in model.__fields__.items():
-        value = input_data.get(field.alias, _missing)
-        using_name = False
-        if value is _missing and config.allow_population_by_field_name and field.alt_alias:
-            value = input_data.get(field.name, _missing)
-            using_name = True
-
-        if value is _missing:
-            if field.required:
-                errors.append(ErrorWrapper(MissingError(), loc=field.alias))
-                continue
-
-            value = field.get_default()
-
-            if not config.validate_all and not field.validate_always:
-                values[name] = value
-                continue
-        else:
-            fields_set.add(name)
-            if check_extra:
-                names_used.add(field.name if using_name else field.alias)
-
-        v_, errors_ = field.validate(value, values, loc=field.alias, cls=cls_)
-        if isinstance(errors_, ErrorWrapper):
-            errors.append(errors_)
-        elif isinstance(errors_, list):
-            errors.extend(errors_)
-        else:
-            values[name] = v_
-
-    if check_extra:
-        if isinstance(input_data, GetterDict):
-            extra = input_data.extra_keys() - names_used
-        else:
-            extra = input_data.keys() - names_used
-        if extra:
-            fields_set |= extra
-            if config.extra is Extra.allow:
-                for f in extra:
-                    values[f] = input_data[f]
-            else:
-                for f in sorted(extra):
-                    errors.append(ErrorWrapper(ExtraError(), loc=f))
-
-    for skip_on_failure, validator in model.__post_root_validators__:
-        if skip_on_failure and errors:
-            continue
-        try:
-            values = validator(cls_, values)
-        except (ValueError, TypeError, AssertionError) as exc:
-            errors.append(ErrorWrapper(exc, loc=ROOT_KEY))
-
-    if errors:
-        return values, fields_set, ValidationError(errors, cls_)
-    else:
-        return values, fields_set, None
diff --git a/lib/pydantic/v1/mypy.py b/lib/pydantic/v1/mypy.py
deleted file mode 100644
index 1d6d5ae2..00000000
--- a/lib/pydantic/v1/mypy.py
+++ /dev/null
@@ -1,944 +0,0 @@
-import sys
-from configparser import ConfigParser
-from typing import Any, Callable, Dict, List, Optional, Set, Tuple, Type as TypingType, Union
-
-from mypy.errorcodes import ErrorCode
-from mypy.nodes import (
-    ARG_NAMED,
-    ARG_NAMED_OPT,
-    ARG_OPT,
-    ARG_POS,
-    ARG_STAR2,
-    MDEF,
-    Argument,
-    AssignmentStmt,
-    Block,
-    CallExpr,
-    ClassDef,
-    Context,
-    Decorator,
-    EllipsisExpr,
-    FuncBase,
-    FuncDef,
-    JsonDict,
-    MemberExpr,
-    NameExpr,
-    PassStmt,
-    PlaceholderNode,
-    RefExpr,
-    StrExpr,
-    SymbolNode,
-    SymbolTableNode,
-    TempNode,
-    TypeInfo,
-    TypeVarExpr,
-    Var,
-)
-from mypy.options import Options
-from mypy.plugin import (
-    CheckerPluginInterface,
-    ClassDefContext,
-    FunctionContext,
-    MethodContext,
-    Plugin,
-    ReportConfigContext,
-    SemanticAnalyzerPluginInterface,
-)
-from mypy.plugins import dataclasses
-from mypy.semanal import set_callable_name  # type: ignore
-from mypy.server.trigger import make_wildcard_trigger
-from mypy.types import (
-    AnyType,
-    CallableType,
-    Instance,
-    NoneType,
-    Overloaded,
-    ProperType,
-    Type,
-    TypeOfAny,
-    TypeType,
-    TypeVarType,
-    UnionType,
-    get_proper_type,
-)
-from mypy.typevars import fill_typevars
-from mypy.util import get_unique_redefinition_name
-from mypy.version import __version__ as mypy_version
-
-from pydantic.utils import is_valid_field
-
-try:
-    from mypy.types import TypeVarDef  # type: ignore[attr-defined]
-except ImportError:  # pragma: no cover
-    # Backward-compatible with TypeVarDef from Mypy 0.910.
-    from mypy.types import TypeVarType as TypeVarDef
-
-CONFIGFILE_KEY = 'pydantic-mypy'
-METADATA_KEY = 'pydantic-mypy-metadata'
-_NAMESPACE = __name__[:-5]  # 'pydantic' in 1.10.X, 'pydantic.v1' in v2.X
-BASEMODEL_FULLNAME = f'{_NAMESPACE}.main.BaseModel'
-BASESETTINGS_FULLNAME = f'{_NAMESPACE}.env_settings.BaseSettings'
-MODEL_METACLASS_FULLNAME = f'{_NAMESPACE}.main.ModelMetaclass'
-FIELD_FULLNAME = f'{_NAMESPACE}.fields.Field'
-DATACLASS_FULLNAME = f'{_NAMESPACE}.dataclasses.dataclass'
-
-
-def parse_mypy_version(version: str) -> Tuple[int, ...]:
-    return tuple(map(int, version.partition('+')[0].split('.')))
-
-
-MYPY_VERSION_TUPLE = parse_mypy_version(mypy_version)
-BUILTINS_NAME = 'builtins' if MYPY_VERSION_TUPLE >= (0, 930) else '__builtins__'
-
-# Increment version if plugin changes and mypy caches should be invalidated
-__version__ = 2
-
-
-def plugin(version: str) -> 'TypingType[Plugin]':
-    """
-    `version` is the mypy version string
-
-    We might want to use this to print a warning if the mypy version being used is
-    newer, or especially older, than we expect (or need).
-    """
-    return PydanticPlugin
-
-
-class PydanticPlugin(Plugin):
-    def __init__(self, options: Options) -> None:
-        self.plugin_config = PydanticPluginConfig(options)
-        self._plugin_data = self.plugin_config.to_data()
-        super().__init__(options)
-
-    def get_base_class_hook(self, fullname: str) -> 'Optional[Callable[[ClassDefContext], None]]':
-        sym = self.lookup_fully_qualified(fullname)
-        if sym and isinstance(sym.node, TypeInfo):  # pragma: no branch
-            # No branching may occur if the mypy cache has not been cleared
-            if any(get_fullname(base) == BASEMODEL_FULLNAME for base in sym.node.mro):
-                return self._pydantic_model_class_maker_callback
-        return None
-
-    def get_metaclass_hook(self, fullname: str) -> Optional[Callable[[ClassDefContext], None]]:
-        if fullname == MODEL_METACLASS_FULLNAME:
-            return self._pydantic_model_metaclass_marker_callback
-        return None
-
-    def get_function_hook(self, fullname: str) -> 'Optional[Callable[[FunctionContext], Type]]':
-        sym = self.lookup_fully_qualified(fullname)
-        if sym and sym.fullname == FIELD_FULLNAME:
-            return self._pydantic_field_callback
-        return None
-
-    def get_method_hook(self, fullname: str) -> Optional[Callable[[MethodContext], Type]]:
-        if fullname.endswith('.from_orm'):
-            return from_orm_callback
-        return None
-
-    def get_class_decorator_hook(self, fullname: str) -> Optional[Callable[[ClassDefContext], None]]:
-        """Mark pydantic.dataclasses as dataclass.
-
-        Mypy version 1.1.1 added support for `@dataclass_transform` decorator.
-        """
-        if fullname == DATACLASS_FULLNAME and MYPY_VERSION_TUPLE < (1, 1):
-            return dataclasses.dataclass_class_maker_callback  # type: ignore[return-value]
-        return None
-
-    def report_config_data(self, ctx: ReportConfigContext) -> Dict[str, Any]:
-        """Return all plugin config data.
-
-        Used by mypy to determine if cache needs to be discarded.
-        """
-        return self._plugin_data
-
-    def _pydantic_model_class_maker_callback(self, ctx: ClassDefContext) -> None:
-        transformer = PydanticModelTransformer(ctx, self.plugin_config)
-        transformer.transform()
-
-    def _pydantic_model_metaclass_marker_callback(self, ctx: ClassDefContext) -> None:
-        """Reset dataclass_transform_spec attribute of ModelMetaclass.
-
-        Let the plugin handle it. This behavior can be disabled
-        if 'debug_dataclass_transform' is set to True', for testing purposes.
-        """
-        if self.plugin_config.debug_dataclass_transform:
-            return
-        info_metaclass = ctx.cls.info.declared_metaclass
-        assert info_metaclass, "callback not passed from 'get_metaclass_hook'"
-        if getattr(info_metaclass.type, 'dataclass_transform_spec', None):
-            info_metaclass.type.dataclass_transform_spec = None  # type: ignore[attr-defined]
-
-    def _pydantic_field_callback(self, ctx: FunctionContext) -> 'Type':
-        """
-        Extract the type of the `default` argument from the Field function, and use it as the return type.
-
-        In particular:
-        * Check whether the default and default_factory argument is specified.
-        * Output an error if both are specified.
-        * Retrieve the type of the argument which is specified, and use it as return type for the function.
-        """
-        default_any_type = ctx.default_return_type
-
-        assert ctx.callee_arg_names[0] == 'default', '"default" is no longer first argument in Field()'
-        assert ctx.callee_arg_names[1] == 'default_factory', '"default_factory" is no longer second argument in Field()'
-        default_args = ctx.args[0]
-        default_factory_args = ctx.args[1]
-
-        if default_args and default_factory_args:
-            error_default_and_default_factory_specified(ctx.api, ctx.context)
-            return default_any_type
-
-        if default_args:
-            default_type = ctx.arg_types[0][0]
-            default_arg = default_args[0]
-
-            # Fallback to default Any type if the field is required
-            if not isinstance(default_arg, EllipsisExpr):
-                return default_type
-
-        elif default_factory_args:
-            default_factory_type = ctx.arg_types[1][0]
-
-            # Functions which use `ParamSpec` can be overloaded, exposing the callable's types as a parameter
-            # Pydantic calls the default factory without any argument, so we retrieve the first item
-            if isinstance(default_factory_type, Overloaded):
-                if MYPY_VERSION_TUPLE > (0, 910):
-                    default_factory_type = default_factory_type.items[0]
-                else:
-                    # Mypy0.910 exposes the items of overloaded types in a function
-                    default_factory_type = default_factory_type.items()[0]  # type: ignore[operator]
-
-            if isinstance(default_factory_type, CallableType):
-                ret_type = default_factory_type.ret_type
-                # mypy doesn't think `ret_type` has `args`, you'd think mypy should know,
-                # add this check in case it varies by version
-                args = getattr(ret_type, 'args', None)
-                if args:
-                    if all(isinstance(arg, TypeVarType) for arg in args):
-                        # Looks like the default factory is a type like `list` or `dict`, replace all args with `Any`
-                        ret_type.args = tuple(default_any_type for _ in args)  # type: ignore[attr-defined]
-                return ret_type
-
-        return default_any_type
-
-
-class PydanticPluginConfig:
-    __slots__ = (
-        'init_forbid_extra',
-        'init_typed',
-        'warn_required_dynamic_aliases',
-        'warn_untyped_fields',
-        'debug_dataclass_transform',
-    )
-    init_forbid_extra: bool
-    init_typed: bool
-    warn_required_dynamic_aliases: bool
-    warn_untyped_fields: bool
-    debug_dataclass_transform: bool  # undocumented
-
-    def __init__(self, options: Options) -> None:
-        if options.config_file is None:  # pragma: no cover
-            return
-
-        toml_config = parse_toml(options.config_file)
-        if toml_config is not None:
-            config = toml_config.get('tool', {}).get('pydantic-mypy', {})
-            for key in self.__slots__:
-                setting = config.get(key, False)
-                if not isinstance(setting, bool):
-                    raise ValueError(f'Configuration value must be a boolean for key: {key}')
-                setattr(self, key, setting)
-        else:
-            plugin_config = ConfigParser()
-            plugin_config.read(options.config_file)
-            for key in self.__slots__:
-                setting = plugin_config.getboolean(CONFIGFILE_KEY, key, fallback=False)
-                setattr(self, key, setting)
-
-    def to_data(self) -> Dict[str, Any]:
-        return {key: getattr(self, key) for key in self.__slots__}
-
-
-def from_orm_callback(ctx: MethodContext) -> Type:
-    """
-    Raise an error if orm_mode is not enabled
-    """
-    model_type: Instance
-    ctx_type = ctx.type
-    if isinstance(ctx_type, TypeType):
-        ctx_type = ctx_type.item
-    if isinstance(ctx_type, CallableType) and isinstance(ctx_type.ret_type, Instance):
-        model_type = ctx_type.ret_type  # called on the class
-    elif isinstance(ctx_type, Instance):
-        model_type = ctx_type  # called on an instance (unusual, but still valid)
-    else:  # pragma: no cover
-        detail = f'ctx.type: {ctx_type} (of type {ctx_type.__class__.__name__})'
-        error_unexpected_behavior(detail, ctx.api, ctx.context)
-        return ctx.default_return_type
-    pydantic_metadata = model_type.type.metadata.get(METADATA_KEY)
-    if pydantic_metadata is None:
-        return ctx.default_return_type
-    orm_mode = pydantic_metadata.get('config', {}).get('orm_mode')
-    if orm_mode is not True:
-        error_from_orm(get_name(model_type.type), ctx.api, ctx.context)
-    return ctx.default_return_type
-
-
-class PydanticModelTransformer:
-    tracked_config_fields: Set[str] = {
-        'extra',
-        'allow_mutation',
-        'frozen',
-        'orm_mode',
-        'allow_population_by_field_name',
-        'alias_generator',
-    }
-
-    def __init__(self, ctx: ClassDefContext, plugin_config: PydanticPluginConfig) -> None:
-        self._ctx = ctx
-        self.plugin_config = plugin_config
-
-    def transform(self) -> None:
-        """
-        Configures the BaseModel subclass according to the plugin settings.
-
-        In particular:
-        * determines the model config and fields,
-        * adds a fields-aware signature for the initializer and construct methods
-        * freezes the class if allow_mutation = False or frozen = True
-        * stores the fields, config, and if the class is settings in the mypy metadata for access by subclasses
-        """
-        ctx = self._ctx
-        info = ctx.cls.info
-
-        self.adjust_validator_signatures()
-        config = self.collect_config()
-        fields = self.collect_fields(config)
-        is_settings = any(get_fullname(base) == BASESETTINGS_FULLNAME for base in info.mro[:-1])
-        self.add_initializer(fields, config, is_settings)
-        self.add_construct_method(fields)
-        self.set_frozen(fields, frozen=config.allow_mutation is False or config.frozen is True)
-        info.metadata[METADATA_KEY] = {
-            'fields': {field.name: field.serialize() for field in fields},
-            'config': config.set_values_dict(),
-        }
-
-    def adjust_validator_signatures(self) -> None:
-        """When we decorate a function `f` with `pydantic.validator(...), mypy sees
-        `f` as a regular method taking a `self` instance, even though pydantic
-        internally wraps `f` with `classmethod` if necessary.
-
-        Teach mypy this by marking any function whose outermost decorator is a
-        `validator()` call as a classmethod.
-        """
-        for name, sym in self._ctx.cls.info.names.items():
-            if isinstance(sym.node, Decorator):
-                first_dec = sym.node.original_decorators[0]
-                if (
-                    isinstance(first_dec, CallExpr)
-                    and isinstance(first_dec.callee, NameExpr)
-                    and first_dec.callee.fullname == f'{_NAMESPACE}.class_validators.validator'
-                ):
-                    sym.node.func.is_class = True
-
-    def collect_config(self) -> 'ModelConfigData':
-        """
-        Collects the values of the config attributes that are used by the plugin, accounting for parent classes.
-        """
-        ctx = self._ctx
-        cls = ctx.cls
-        config = ModelConfigData()
-        for stmt in cls.defs.body:
-            if not isinstance(stmt, ClassDef):
-                continue
-            if stmt.name == 'Config':
-                for substmt in stmt.defs.body:
-                    if not isinstance(substmt, AssignmentStmt):
-                        continue
-                    config.update(self.get_config_update(substmt))
-                if (
-                    config.has_alias_generator
-                    and not config.allow_population_by_field_name
-                    and self.plugin_config.warn_required_dynamic_aliases
-                ):
-                    error_required_dynamic_aliases(ctx.api, stmt)
-        for info in cls.info.mro[1:]:  # 0 is the current class
-            if METADATA_KEY not in info.metadata:
-                continue
-
-            # Each class depends on the set of fields in its ancestors
-            ctx.api.add_plugin_dependency(make_wildcard_trigger(get_fullname(info)))
-            for name, value in info.metadata[METADATA_KEY]['config'].items():
-                config.setdefault(name, value)
-        return config
-
-    def collect_fields(self, model_config: 'ModelConfigData') -> List['PydanticModelField']:
-        """
-        Collects the fields for the model, accounting for parent classes
-        """
-        # First, collect fields belonging to the current class.
-        ctx = self._ctx
-        cls = self._ctx.cls
-        fields = []  # type: List[PydanticModelField]
-        known_fields = set()  # type: Set[str]
-        for stmt in cls.defs.body:
-            if not isinstance(stmt, AssignmentStmt):  # `and stmt.new_syntax` to require annotation
-                continue
-
-            lhs = stmt.lvalues[0]
-            if not isinstance(lhs, NameExpr) or not is_valid_field(lhs.name):
-                continue
-
-            if not stmt.new_syntax and self.plugin_config.warn_untyped_fields:
-                error_untyped_fields(ctx.api, stmt)
-
-            # if lhs.name == '__config__':  # BaseConfig not well handled; I'm not sure why yet
-            #     continue
-
-            sym = cls.info.names.get(lhs.name)
-            if sym is None:  # pragma: no cover
-                # This is likely due to a star import (see the dataclasses plugin for a more detailed explanation)
-                # This is the same logic used in the dataclasses plugin
-                continue
-
-            node = sym.node
-            if isinstance(node, PlaceholderNode):  # pragma: no cover
-                # See the PlaceholderNode docstring for more detail about how this can occur
-                # Basically, it is an edge case when dealing with complex import logic
-                # This is the same logic used in the dataclasses plugin
-                continue
-            if not isinstance(node, Var):  # pragma: no cover
-                # Don't know if this edge case still happens with the `is_valid_field` check above
-                # but better safe than sorry
-                continue
-
-            # x: ClassVar[int] is ignored by dataclasses.
-            if node.is_classvar:
-                continue
-
-            is_required = self.get_is_required(cls, stmt, lhs)
-            alias, has_dynamic_alias = self.get_alias_info(stmt)
-            if (
-                has_dynamic_alias
-                and not model_config.allow_population_by_field_name
-                and self.plugin_config.warn_required_dynamic_aliases
-            ):
-                error_required_dynamic_aliases(ctx.api, stmt)
-            fields.append(
-                PydanticModelField(
-                    name=lhs.name,
-                    is_required=is_required,
-                    alias=alias,
-                    has_dynamic_alias=has_dynamic_alias,
-                    line=stmt.line,
-                    column=stmt.column,
-                )
-            )
-            known_fields.add(lhs.name)
-        all_fields = fields.copy()
-        for info in cls.info.mro[1:]:  # 0 is the current class, -2 is BaseModel, -1 is object
-            if METADATA_KEY not in info.metadata:
-                continue
-
-            superclass_fields = []
-            # Each class depends on the set of fields in its ancestors
-            ctx.api.add_plugin_dependency(make_wildcard_trigger(get_fullname(info)))
-
-            for name, data in info.metadata[METADATA_KEY]['fields'].items():
-                if name not in known_fields:
-                    field = PydanticModelField.deserialize(info, data)
-                    known_fields.add(name)
-                    superclass_fields.append(field)
-                else:
-                    (field,) = (a for a in all_fields if a.name == name)
-                    all_fields.remove(field)
-                    superclass_fields.append(field)
-            all_fields = superclass_fields + all_fields
-        return all_fields
-
-    def add_initializer(self, fields: List['PydanticModelField'], config: 'ModelConfigData', is_settings: bool) -> None:
-        """
-        Adds a fields-aware `__init__` method to the class.
-
-        The added `__init__` will be annotated with types vs. all `Any` depending on the plugin settings.
-        """
-        ctx = self._ctx
-        typed = self.plugin_config.init_typed
-        use_alias = config.allow_population_by_field_name is not True
-        force_all_optional = is_settings or bool(
-            config.has_alias_generator and not config.allow_population_by_field_name
-        )
-        init_arguments = self.get_field_arguments(
-            fields, typed=typed, force_all_optional=force_all_optional, use_alias=use_alias
-        )
-        if not self.should_init_forbid_extra(fields, config):
-            var = Var('kwargs')
-            init_arguments.append(Argument(var, AnyType(TypeOfAny.explicit), None, ARG_STAR2))
-
-        if '__init__' not in ctx.cls.info.names:
-            add_method(ctx, '__init__', init_arguments, NoneType())
-
-    def add_construct_method(self, fields: List['PydanticModelField']) -> None:
-        """
-        Adds a fully typed `construct` classmethod to the class.
-
-        Similar to the fields-aware __init__ method, but always uses the field names (not aliases),
-        and does not treat settings fields as optional.
-        """
-        ctx = self._ctx
-        set_str = ctx.api.named_type(f'{BUILTINS_NAME}.set', [ctx.api.named_type(f'{BUILTINS_NAME}.str')])
-        optional_set_str = UnionType([set_str, NoneType()])
-        fields_set_argument = Argument(Var('_fields_set', optional_set_str), optional_set_str, None, ARG_OPT)
-        construct_arguments = self.get_field_arguments(fields, typed=True, force_all_optional=False, use_alias=False)
-        construct_arguments = [fields_set_argument] + construct_arguments
-
-        obj_type = ctx.api.named_type(f'{BUILTINS_NAME}.object')
-        self_tvar_name = '_PydanticBaseModel'  # Make sure it does not conflict with other names in the class
-        tvar_fullname = ctx.cls.fullname + '.' + self_tvar_name
-        if MYPY_VERSION_TUPLE >= (1, 4):
-            tvd = TypeVarType(
-                self_tvar_name,
-                tvar_fullname,
-                -1,
-                [],
-                obj_type,
-                AnyType(TypeOfAny.from_omitted_generics),  # type: ignore[arg-type]
-            )
-            self_tvar_expr = TypeVarExpr(
-                self_tvar_name,
-                tvar_fullname,
-                [],
-                obj_type,
-                AnyType(TypeOfAny.from_omitted_generics),  # type: ignore[arg-type]
-            )
-        else:
-            tvd = TypeVarDef(self_tvar_name, tvar_fullname, -1, [], obj_type)
-            self_tvar_expr = TypeVarExpr(self_tvar_name, tvar_fullname, [], obj_type)
-        ctx.cls.info.names[self_tvar_name] = SymbolTableNode(MDEF, self_tvar_expr)
-
-        # Backward-compatible with TypeVarDef from Mypy 0.910.
-        if isinstance(tvd, TypeVarType):
-            self_type = tvd
-        else:
-            self_type = TypeVarType(tvd)
-
-        add_method(
-            ctx,
-            'construct',
-            construct_arguments,
-            return_type=self_type,
-            self_type=self_type,
-            tvar_def=tvd,
-            is_classmethod=True,
-        )
-
-    def set_frozen(self, fields: List['PydanticModelField'], frozen: bool) -> None:
-        """
-        Marks all fields as properties so that attempts to set them trigger mypy errors.
-
-        This is the same approach used by the attrs and dataclasses plugins.
-        """
-        ctx = self._ctx
-        info = ctx.cls.info
-        for field in fields:
-            sym_node = info.names.get(field.name)
-            if sym_node is not None:
-                var = sym_node.node
-                if isinstance(var, Var):
-                    var.is_property = frozen
-                elif isinstance(var, PlaceholderNode) and not ctx.api.final_iteration:
-                    # See https://github.com/pydantic/pydantic/issues/5191 to hit this branch for test coverage
-                    ctx.api.defer()
-                else:  # pragma: no cover
-                    # I don't know whether it's possible to hit this branch, but I've added it for safety
-                    try:
-                        var_str = str(var)
-                    except TypeError:
-                        # This happens for PlaceholderNode; perhaps it will happen for other types in the future..
-                        var_str = repr(var)
-                    detail = f'sym_node.node: {var_str} (of type {var.__class__})'
-                    error_unexpected_behavior(detail, ctx.api, ctx.cls)
-            else:
-                var = field.to_var(info, use_alias=False)
-                var.info = info
-                var.is_property = frozen
-                var._fullname = get_fullname(info) + '.' + get_name(var)
-                info.names[get_name(var)] = SymbolTableNode(MDEF, var)
-
-    def get_config_update(self, substmt: AssignmentStmt) -> Optional['ModelConfigData']:
-        """
-        Determines the config update due to a single statement in the Config class definition.
-
-        Warns if a tracked config attribute is set to a value the plugin doesn't know how to interpret (e.g., an int)
-        """
-        lhs = substmt.lvalues[0]
-        if not (isinstance(lhs, NameExpr) and lhs.name in self.tracked_config_fields):
-            return None
-        if lhs.name == 'extra':
-            if isinstance(substmt.rvalue, StrExpr):
-                forbid_extra = substmt.rvalue.value == 'forbid'
-            elif isinstance(substmt.rvalue, MemberExpr):
-                forbid_extra = substmt.rvalue.name == 'forbid'
-            else:
-                error_invalid_config_value(lhs.name, self._ctx.api, substmt)
-                return None
-            return ModelConfigData(forbid_extra=forbid_extra)
-        if lhs.name == 'alias_generator':
-            has_alias_generator = True
-            if isinstance(substmt.rvalue, NameExpr) and substmt.rvalue.fullname == 'builtins.None':
-                has_alias_generator = False
-            return ModelConfigData(has_alias_generator=has_alias_generator)
-        if isinstance(substmt.rvalue, NameExpr) and substmt.rvalue.fullname in ('builtins.True', 'builtins.False'):
-            return ModelConfigData(**{lhs.name: substmt.rvalue.fullname == 'builtins.True'})
-        error_invalid_config_value(lhs.name, self._ctx.api, substmt)
-        return None
-
-    @staticmethod
-    def get_is_required(cls: ClassDef, stmt: AssignmentStmt, lhs: NameExpr) -> bool:
-        """
-        Returns a boolean indicating whether the field defined in `stmt` is a required field.
-        """
-        expr = stmt.rvalue
-        if isinstance(expr, TempNode):
-            # TempNode means annotation-only, so only non-required if Optional
-            value_type = get_proper_type(cls.info[lhs.name].type)
-            return not PydanticModelTransformer.type_has_implicit_default(value_type)
-        if isinstance(expr, CallExpr) and isinstance(expr.callee, RefExpr) and expr.callee.fullname == FIELD_FULLNAME:
-            # The "default value" is a call to `Field`; at this point, the field is
-            # only required if default is Ellipsis (i.e., `field_name: Annotation = Field(...)`) or if default_factory
-            # is specified.
-            for arg, name in zip(expr.args, expr.arg_names):
-                # If name is None, then this arg is the default because it is the only positional argument.
-                if name is None or name == 'default':
-                    return arg.__class__ is EllipsisExpr
-                if name == 'default_factory':
-                    return False
-            # In this case, default and default_factory are not specified, so we need to look at the annotation
-            value_type = get_proper_type(cls.info[lhs.name].type)
-            return not PydanticModelTransformer.type_has_implicit_default(value_type)
-        # Only required if the "default value" is Ellipsis (i.e., `field_name: Annotation = ...`)
-        return isinstance(expr, EllipsisExpr)
-
-    @staticmethod
-    def type_has_implicit_default(type_: Optional[ProperType]) -> bool:
-        """
-        Returns True if the passed type will be given an implicit default value.
-
-        In pydantic v1, this is the case for Optional types and Any (with default value None).
-        """
-        if isinstance(type_, AnyType):
-            # Annotated as Any
-            return True
-        if isinstance(type_, UnionType) and any(
-            isinstance(item, NoneType) or isinstance(item, AnyType) for item in type_.items
-        ):
-            # Annotated as Optional, or otherwise having NoneType or AnyType in the union
-            return True
-        return False
-
-    @staticmethod
-    def get_alias_info(stmt: AssignmentStmt) -> Tuple[Optional[str], bool]:
-        """
-        Returns a pair (alias, has_dynamic_alias), extracted from the declaration of the field defined in `stmt`.
-
-        `has_dynamic_alias` is True if and only if an alias is provided, but not as a string literal.
-        If `has_dynamic_alias` is True, `alias` will be None.
-        """
-        expr = stmt.rvalue
-        if isinstance(expr, TempNode):
-            # TempNode means annotation-only
-            return None, False
-
-        if not (
-            isinstance(expr, CallExpr) and isinstance(expr.callee, RefExpr) and expr.callee.fullname == FIELD_FULLNAME
-        ):
-            # Assigned value is not a call to pydantic.fields.Field
-            return None, False
-
-        for i, arg_name in enumerate(expr.arg_names):
-            if arg_name != 'alias':
-                continue
-            arg = expr.args[i]
-            if isinstance(arg, StrExpr):
-                return arg.value, False
-            else:
-                return None, True
-        return None, False
-
-    def get_field_arguments(
-        self, fields: List['PydanticModelField'], typed: bool, force_all_optional: bool, use_alias: bool
-    ) -> List[Argument]:
-        """
-        Helper function used during the construction of the `__init__` and `construct` method signatures.
-
-        Returns a list of mypy Argument instances for use in the generated signatures.
-        """
-        info = self._ctx.cls.info
-        arguments = [
-            field.to_argument(info, typed=typed, force_optional=force_all_optional, use_alias=use_alias)
-            for field in fields
-            if not (use_alias and field.has_dynamic_alias)
-        ]
-        return arguments
-
-    def should_init_forbid_extra(self, fields: List['PydanticModelField'], config: 'ModelConfigData') -> bool:
-        """
-        Indicates whether the generated `__init__` should get a `**kwargs` at the end of its signature
-
-        We disallow arbitrary kwargs if the extra config setting is "forbid", or if the plugin config says to,
-        *unless* a required dynamic alias is present (since then we can't determine a valid signature).
-        """
-        if not config.allow_population_by_field_name:
-            if self.is_dynamic_alias_present(fields, bool(config.has_alias_generator)):
-                return False
-        if config.forbid_extra:
-            return True
-        return self.plugin_config.init_forbid_extra
-
-    @staticmethod
-    def is_dynamic_alias_present(fields: List['PydanticModelField'], has_alias_generator: bool) -> bool:
-        """
-        Returns whether any fields on the model have a "dynamic alias", i.e., an alias that cannot be
-        determined during static analysis.
-        """
-        for field in fields:
-            if field.has_dynamic_alias:
-                return True
-        if has_alias_generator:
-            for field in fields:
-                if field.alias is None:
-                    return True
-        return False
-
-
-class PydanticModelField:
-    def __init__(
-        self, name: str, is_required: bool, alias: Optional[str], has_dynamic_alias: bool, line: int, column: int
-    ):
-        self.name = name
-        self.is_required = is_required
-        self.alias = alias
-        self.has_dynamic_alias = has_dynamic_alias
-        self.line = line
-        self.column = column
-
-    def to_var(self, info: TypeInfo, use_alias: bool) -> Var:
-        name = self.name
-        if use_alias and self.alias is not None:
-            name = self.alias
-        return Var(name, info[self.name].type)
-
-    def to_argument(self, info: TypeInfo, typed: bool, force_optional: bool, use_alias: bool) -> Argument:
-        if typed and info[self.name].type is not None:
-            type_annotation = info[self.name].type
-        else:
-            type_annotation = AnyType(TypeOfAny.explicit)
-        return Argument(
-            variable=self.to_var(info, use_alias),
-            type_annotation=type_annotation,
-            initializer=None,
-            kind=ARG_NAMED_OPT if force_optional or not self.is_required else ARG_NAMED,
-        )
-
-    def serialize(self) -> JsonDict:
-        return self.__dict__
-
-    @classmethod
-    def deserialize(cls, info: TypeInfo, data: JsonDict) -> 'PydanticModelField':
-        return cls(**data)
-
-
-class ModelConfigData:
-    def __init__(
-        self,
-        forbid_extra: Optional[bool] = None,
-        allow_mutation: Optional[bool] = None,
-        frozen: Optional[bool] = None,
-        orm_mode: Optional[bool] = None,
-        allow_population_by_field_name: Optional[bool] = None,
-        has_alias_generator: Optional[bool] = None,
-    ):
-        self.forbid_extra = forbid_extra
-        self.allow_mutation = allow_mutation
-        self.frozen = frozen
-        self.orm_mode = orm_mode
-        self.allow_population_by_field_name = allow_population_by_field_name
-        self.has_alias_generator = has_alias_generator
-
-    def set_values_dict(self) -> Dict[str, Any]:
-        return {k: v for k, v in self.__dict__.items() if v is not None}
-
-    def update(self, config: Optional['ModelConfigData']) -> None:
-        if config is None:
-            return
-        for k, v in config.set_values_dict().items():
-            setattr(self, k, v)
-
-    def setdefault(self, key: str, value: Any) -> None:
-        if getattr(self, key) is None:
-            setattr(self, key, value)
-
-
-ERROR_ORM = ErrorCode('pydantic-orm', 'Invalid from_orm call', 'Pydantic')
-ERROR_CONFIG = ErrorCode('pydantic-config', 'Invalid config value', 'Pydantic')
-ERROR_ALIAS = ErrorCode('pydantic-alias', 'Dynamic alias disallowed', 'Pydantic')
-ERROR_UNEXPECTED = ErrorCode('pydantic-unexpected', 'Unexpected behavior', 'Pydantic')
-ERROR_UNTYPED = ErrorCode('pydantic-field', 'Untyped field disallowed', 'Pydantic')
-ERROR_FIELD_DEFAULTS = ErrorCode('pydantic-field', 'Invalid Field defaults', 'Pydantic')
-
-
-def error_from_orm(model_name: str, api: CheckerPluginInterface, context: Context) -> None:
-    api.fail(f'"{model_name}" does not have orm_mode=True', context, code=ERROR_ORM)
-
-
-def error_invalid_config_value(name: str, api: SemanticAnalyzerPluginInterface, context: Context) -> None:
-    api.fail(f'Invalid value for "Config.{name}"', context, code=ERROR_CONFIG)
-
-
-def error_required_dynamic_aliases(api: SemanticAnalyzerPluginInterface, context: Context) -> None:
-    api.fail('Required dynamic aliases disallowed', context, code=ERROR_ALIAS)
-
-
-def error_unexpected_behavior(
-    detail: str, api: Union[CheckerPluginInterface, SemanticAnalyzerPluginInterface], context: Context
-) -> None:  # pragma: no cover
-    # Can't think of a good way to test this, but I confirmed it renders as desired by adding to a non-error path
-    link = 'https://github.com/pydantic/pydantic/issues/new/choose'
-    full_message = f'The pydantic mypy plugin ran into unexpected behavior: {detail}\n'
-    full_message += f'Please consider reporting this bug at {link} so we can try to fix it!'
-    api.fail(full_message, context, code=ERROR_UNEXPECTED)
-
-
-def error_untyped_fields(api: SemanticAnalyzerPluginInterface, context: Context) -> None:
-    api.fail('Untyped fields disallowed', context, code=ERROR_UNTYPED)
-
-
-def error_default_and_default_factory_specified(api: CheckerPluginInterface, context: Context) -> None:
-    api.fail('Field default and default_factory cannot be specified together', context, code=ERROR_FIELD_DEFAULTS)
-
-
-def add_method(
-    ctx: ClassDefContext,
-    name: str,
-    args: List[Argument],
-    return_type: Type,
-    self_type: Optional[Type] = None,
-    tvar_def: Optional[TypeVarDef] = None,
-    is_classmethod: bool = False,
-    is_new: bool = False,
-    # is_staticmethod: bool = False,
-) -> None:
-    """
-    Adds a new method to a class.
-
-    This can be dropped if/when https://github.com/python/mypy/issues/7301 is merged
-    """
-    info = ctx.cls.info
-
-    # First remove any previously generated methods with the same name
-    # to avoid clashes and problems in the semantic analyzer.
-    if name in info.names:
-        sym = info.names[name]
-        if sym.plugin_generated and isinstance(sym.node, FuncDef):
-            ctx.cls.defs.body.remove(sym.node)  # pragma: no cover
-
-    self_type = self_type or fill_typevars(info)
-    if is_classmethod or is_new:
-        first = [Argument(Var('_cls'), TypeType.make_normalized(self_type), None, ARG_POS)]
-    # elif is_staticmethod:
-    #     first = []
-    else:
-        self_type = self_type or fill_typevars(info)
-        first = [Argument(Var('__pydantic_self__'), self_type, None, ARG_POS)]
-    args = first + args
-    arg_types, arg_names, arg_kinds = [], [], []
-    for arg in args:
-        assert arg.type_annotation, 'All arguments must be fully typed.'
-        arg_types.append(arg.type_annotation)
-        arg_names.append(get_name(arg.variable))
-        arg_kinds.append(arg.kind)
-
-    function_type = ctx.api.named_type(f'{BUILTINS_NAME}.function')
-    signature = CallableType(arg_types, arg_kinds, arg_names, return_type, function_type)
-    if tvar_def:
-        signature.variables = [tvar_def]
-
-    func = FuncDef(name, args, Block([PassStmt()]))
-    func.info = info
-    func.type = set_callable_name(signature, func)
-    func.is_class = is_classmethod
-    # func.is_static = is_staticmethod
-    func._fullname = get_fullname(info) + '.' + name
-    func.line = info.line
-
-    # NOTE: we would like the plugin generated node to dominate, but we still
-    # need to keep any existing definitions so they get semantically analyzed.
-    if name in info.names:
-        # Get a nice unique name instead.
-        r_name = get_unique_redefinition_name(name, info.names)
-        info.names[r_name] = info.names[name]
-
-    if is_classmethod:  # or is_staticmethod:
-        func.is_decorated = True
-        v = Var(name, func.type)
-        v.info = info
-        v._fullname = func._fullname
-        # if is_classmethod:
-        v.is_classmethod = True
-        dec = Decorator(func, [NameExpr('classmethod')], v)
-        # else:
-        #     v.is_staticmethod = True
-        #     dec = Decorator(func, [NameExpr('staticmethod')], v)
-
-        dec.line = info.line
-        sym = SymbolTableNode(MDEF, dec)
-    else:
-        sym = SymbolTableNode(MDEF, func)
-    sym.plugin_generated = True
-
-    info.names[name] = sym
-    info.defn.defs.body.append(func)
-
-
-def get_fullname(x: Union[FuncBase, SymbolNode]) -> str:
-    """
-    Used for compatibility with mypy 0.740; can be dropped once support for 0.740 is dropped.
-    """
-    fn = x.fullname
-    if callable(fn):  # pragma: no cover
-        return fn()
-    return fn
-
-
-def get_name(x: Union[FuncBase, SymbolNode]) -> str:
-    """
-    Used for compatibility with mypy 0.740; can be dropped once support for 0.740 is dropped.
-    """
-    fn = x.name
-    if callable(fn):  # pragma: no cover
-        return fn()
-    return fn
-
-
-def parse_toml(config_file: str) -> Optional[Dict[str, Any]]:
-    if not config_file.endswith('.toml'):
-        return None
-
-    read_mode = 'rb'
-    if sys.version_info >= (3, 11):
-        import tomllib as toml_
-    else:
-        try:
-            import tomli as toml_
-        except ImportError:
-            # older versions of mypy have toml as a dependency, not tomli
-            read_mode = 'r'
-            try:
-                import toml as toml_  # type: ignore[no-redef]
-            except ImportError:  # pragma: no cover
-                import warnings
-
-                warnings.warn('No TOML parser installed, cannot read configuration from `pyproject.toml`.')
-                return None
-
-    with open(config_file, read_mode) as rf:
-        return toml_.load(rf)  # type: ignore[arg-type]
diff --git a/lib/pydantic/v1/networks.py b/lib/pydantic/v1/networks.py
deleted file mode 100644
index cfebe588..00000000
--- a/lib/pydantic/v1/networks.py
+++ /dev/null
@@ -1,747 +0,0 @@
-import re
-from ipaddress import (
-    IPv4Address,
-    IPv4Interface,
-    IPv4Network,
-    IPv6Address,
-    IPv6Interface,
-    IPv6Network,
-    _BaseAddress,
-    _BaseNetwork,
-)
-from typing import (
-    TYPE_CHECKING,
-    Any,
-    Collection,
-    Dict,
-    Generator,
-    List,
-    Match,
-    Optional,
-    Pattern,
-    Set,
-    Tuple,
-    Type,
-    Union,
-    cast,
-    no_type_check,
-)
-
-from . import errors
-from .utils import Representation, update_not_none
-from .validators import constr_length_validator, str_validator
-
-if TYPE_CHECKING:
-    import email_validator
-    from typing_extensions import TypedDict
-
-    from .config import BaseConfig
-    from .fields import ModelField
-    from .typing import AnyCallable
-
-    CallableGenerator = Generator[AnyCallable, None, None]
-
-    class Parts(TypedDict, total=False):
-        scheme: str
-        user: Optional[str]
-        password: Optional[str]
-        ipv4: Optional[str]
-        ipv6: Optional[str]
-        domain: Optional[str]
-        port: Optional[str]
-        path: Optional[str]
-        query: Optional[str]
-        fragment: Optional[str]
-
-    class HostParts(TypedDict, total=False):
-        host: str
-        tld: Optional[str]
-        host_type: Optional[str]
-        port: Optional[str]
-        rebuild: bool
-
-else:
-    email_validator = None
-
-    class Parts(dict):
-        pass
-
-
-NetworkType = Union[str, bytes, int, Tuple[Union[str, bytes, int], Union[str, int]]]
-
-__all__ = [
-    'AnyUrl',
-    'AnyHttpUrl',
-    'FileUrl',
-    'HttpUrl',
-    'stricturl',
-    'EmailStr',
-    'NameEmail',
-    'IPvAnyAddress',
-    'IPvAnyInterface',
-    'IPvAnyNetwork',
-    'PostgresDsn',
-    'CockroachDsn',
-    'AmqpDsn',
-    'RedisDsn',
-    'MongoDsn',
-    'KafkaDsn',
-    'validate_email',
-]
-
-_url_regex_cache = None
-_multi_host_url_regex_cache = None
-_ascii_domain_regex_cache = None
-_int_domain_regex_cache = None
-_host_regex_cache = None
-
-_host_regex = (
-    r'(?:'
-    r'(?P<ipv4>(?:\d{1,3}\.){3}\d{1,3})(?=$|[/:#?])|'  # ipv4
-    r'(?P<ipv6>\[[A-F0-9]*:[A-F0-9:]+\])(?=$|[/:#?])|'  # ipv6
-    r'(?P<domain>[^\s/:?#]+)'  # domain, validation occurs later
-    r')?'
-    r'(?::(?P<port>\d+))?'  # port
-)
-_scheme_regex = r'(?:(?P<scheme>[a-z][a-z0-9+\-.]+)://)?'  # scheme https://tools.ietf.org/html/rfc3986#appendix-A
-_user_info_regex = r'(?:(?P<user>[^\s:/]*)(?::(?P<password>[^\s/]*))?@)?'
-_path_regex = r'(?P<path>/[^\s?#]*)?'
-_query_regex = r'(?:\?(?P<query>[^\s#]*))?'
-_fragment_regex = r'(?:#(?P<fragment>[^\s#]*))?'
-
-
-def url_regex() -> Pattern[str]:
-    global _url_regex_cache
-    if _url_regex_cache is None:
-        _url_regex_cache = re.compile(
-            rf'{_scheme_regex}{_user_info_regex}{_host_regex}{_path_regex}{_query_regex}{_fragment_regex}',
-            re.IGNORECASE,
-        )
-    return _url_regex_cache
-
-
-def multi_host_url_regex() -> Pattern[str]:
-    """
-    Compiled multi host url regex.
-
-    Additionally to `url_regex` it allows to match multiple hosts.
-    E.g. host1.db.net,host2.db.net
-    """
-    global _multi_host_url_regex_cache
-    if _multi_host_url_regex_cache is None:
-        _multi_host_url_regex_cache = re.compile(
-            rf'{_scheme_regex}{_user_info_regex}'
-            r'(?P<hosts>([^/]*))'  # validation occurs later
-            rf'{_path_regex}{_query_regex}{_fragment_regex}',
-            re.IGNORECASE,
-        )
-    return _multi_host_url_regex_cache
-
-
-def ascii_domain_regex() -> Pattern[str]:
-    global _ascii_domain_regex_cache
-    if _ascii_domain_regex_cache is None:
-        ascii_chunk = r'[_0-9a-z](?:[-_0-9a-z]{0,61}[_0-9a-z])?'
-        ascii_domain_ending = r'(?P<tld>\.[a-z]{2,63})?\.?'
-        _ascii_domain_regex_cache = re.compile(
-            fr'(?:{ascii_chunk}\.)*?{ascii_chunk}{ascii_domain_ending}', re.IGNORECASE
-        )
-    return _ascii_domain_regex_cache
-
-
-def int_domain_regex() -> Pattern[str]:
-    global _int_domain_regex_cache
-    if _int_domain_regex_cache is None:
-        int_chunk = r'[_0-9a-\U00040000](?:[-_0-9a-\U00040000]{0,61}[_0-9a-\U00040000])?'
-        int_domain_ending = r'(?P<tld>(\.[^\W\d_]{2,63})|(\.(?:xn--)[_0-9a-z-]{2,63}))?\.?'
-        _int_domain_regex_cache = re.compile(fr'(?:{int_chunk}\.)*?{int_chunk}{int_domain_ending}', re.IGNORECASE)
-    return _int_domain_regex_cache
-
-
-def host_regex() -> Pattern[str]:
-    global _host_regex_cache
-    if _host_regex_cache is None:
-        _host_regex_cache = re.compile(
-            _host_regex,
-            re.IGNORECASE,
-        )
-    return _host_regex_cache
-
-
-class AnyUrl(str):
-    strip_whitespace = True
-    min_length = 1
-    max_length = 2**16
-    allowed_schemes: Optional[Collection[str]] = None
-    tld_required: bool = False
-    user_required: bool = False
-    host_required: bool = True
-    hidden_parts: Set[str] = set()
-
-    __slots__ = ('scheme', 'user', 'password', 'host', 'tld', 'host_type', 'port', 'path', 'query', 'fragment')
-
-    @no_type_check
-    def __new__(cls, url: Optional[str], **kwargs) -> object:
-        return str.__new__(cls, cls.build(**kwargs) if url is None else url)
-
-    def __init__(
-        self,
-        url: str,
-        *,
-        scheme: str,
-        user: Optional[str] = None,
-        password: Optional[str] = None,
-        host: Optional[str] = None,
-        tld: Optional[str] = None,
-        host_type: str = 'domain',
-        port: Optional[str] = None,
-        path: Optional[str] = None,
-        query: Optional[str] = None,
-        fragment: Optional[str] = None,
-    ) -> None:
-        str.__init__(url)
-        self.scheme = scheme
-        self.user = user
-        self.password = password
-        self.host = host
-        self.tld = tld
-        self.host_type = host_type
-        self.port = port
-        self.path = path
-        self.query = query
-        self.fragment = fragment
-
-    @classmethod
-    def build(
-        cls,
-        *,
-        scheme: str,
-        user: Optional[str] = None,
-        password: Optional[str] = None,
-        host: str,
-        port: Optional[str] = None,
-        path: Optional[str] = None,
-        query: Optional[str] = None,
-        fragment: Optional[str] = None,
-        **_kwargs: str,
-    ) -> str:
-        parts = Parts(
-            scheme=scheme,
-            user=user,
-            password=password,
-            host=host,
-            port=port,
-            path=path,
-            query=query,
-            fragment=fragment,
-            **_kwargs,  # type: ignore[misc]
-        )
-
-        url = scheme + '://'
-        if user:
-            url += user
-        if password:
-            url += ':' + password
-        if user or password:
-            url += '@'
-        url += host
-        if port and ('port' not in cls.hidden_parts or cls.get_default_parts(parts).get('port') != port):
-            url += ':' + port
-        if path:
-            url += path
-        if query:
-            url += '?' + query
-        if fragment:
-            url += '#' + fragment
-        return url
-
-    @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-        update_not_none(field_schema, minLength=cls.min_length, maxLength=cls.max_length, format='uri')
-
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield cls.validate
-
-    @classmethod
-    def validate(cls, value: Any, field: 'ModelField', config: 'BaseConfig') -> 'AnyUrl':
-        if value.__class__ == cls:
-            return value
-        value = str_validator(value)
-        if cls.strip_whitespace:
-            value = value.strip()
-        url: str = cast(str, constr_length_validator(value, field, config))
-
-        m = cls._match_url(url)
-        # the regex should always match, if it doesn't please report with details of the URL tried
-        assert m, 'URL regex failed unexpectedly'
-
-        original_parts = cast('Parts', m.groupdict())
-        parts = cls.apply_default_parts(original_parts)
-        parts = cls.validate_parts(parts)
-
-        if m.end() != len(url):
-            raise errors.UrlExtraError(extra=url[m.end() :])
-
-        return cls._build_url(m, url, parts)
-
-    @classmethod
-    def _build_url(cls, m: Match[str], url: str, parts: 'Parts') -> 'AnyUrl':
-        """
-        Validate hosts and build the AnyUrl object. Split from `validate` so this method
-        can be altered in `MultiHostDsn`.
-        """
-        host, tld, host_type, rebuild = cls.validate_host(parts)
-
-        return cls(
-            None if rebuild else url,
-            scheme=parts['scheme'],
-            user=parts['user'],
-            password=parts['password'],
-            host=host,
-            tld=tld,
-            host_type=host_type,
-            port=parts['port'],
-            path=parts['path'],
-            query=parts['query'],
-            fragment=parts['fragment'],
-        )
-
-    @staticmethod
-    def _match_url(url: str) -> Optional[Match[str]]:
-        return url_regex().match(url)
-
-    @staticmethod
-    def _validate_port(port: Optional[str]) -> None:
-        if port is not None and int(port) > 65_535:
-            raise errors.UrlPortError()
-
-    @classmethod
-    def validate_parts(cls, parts: 'Parts', validate_port: bool = True) -> 'Parts':
-        """
-        A method used to validate parts of a URL.
-        Could be overridden to set default values for parts if missing
-        """
-        scheme = parts['scheme']
-        if scheme is None:
-            raise errors.UrlSchemeError()
-
-        if cls.allowed_schemes and scheme.lower() not in cls.allowed_schemes:
-            raise errors.UrlSchemePermittedError(set(cls.allowed_schemes))
-
-        if validate_port:
-            cls._validate_port(parts['port'])
-
-        user = parts['user']
-        if cls.user_required and user is None:
-            raise errors.UrlUserInfoError()
-
-        return parts
-
-    @classmethod
-    def validate_host(cls, parts: 'Parts') -> Tuple[str, Optional[str], str, bool]:
-        tld, host_type, rebuild = None, None, False
-        for f in ('domain', 'ipv4', 'ipv6'):
-            host = parts[f]  # type: ignore[literal-required]
-            if host:
-                host_type = f
-                break
-
-        if host is None:
-            if cls.host_required:
-                raise errors.UrlHostError()
-        elif host_type == 'domain':
-            is_international = False
-            d = ascii_domain_regex().fullmatch(host)
-            if d is None:
-                d = int_domain_regex().fullmatch(host)
-                if d is None:
-                    raise errors.UrlHostError()
-                is_international = True
-
-            tld = d.group('tld')
-            if tld is None and not is_international:
-                d = int_domain_regex().fullmatch(host)
-                assert d is not None
-                tld = d.group('tld')
-                is_international = True
-
-            if tld is not None:
-                tld = tld[1:]
-            elif cls.tld_required:
-                raise errors.UrlHostTldError()
-
-            if is_international:
-                host_type = 'int_domain'
-                rebuild = True
-                host = host.encode('idna').decode('ascii')
-                if tld is not None:
-                    tld = tld.encode('idna').decode('ascii')
-
-        return host, tld, host_type, rebuild  # type: ignore
-
-    @staticmethod
-    def get_default_parts(parts: 'Parts') -> 'Parts':
-        return {}
-
-    @classmethod
-    def apply_default_parts(cls, parts: 'Parts') -> 'Parts':
-        for key, value in cls.get_default_parts(parts).items():
-            if not parts[key]:  # type: ignore[literal-required]
-                parts[key] = value  # type: ignore[literal-required]
-        return parts
-
-    def __repr__(self) -> str:
-        extra = ', '.join(f'{n}={getattr(self, n)!r}' for n in self.__slots__ if getattr(self, n) is not None)
-        return f'{self.__class__.__name__}({super().__repr__()}, {extra})'
-
-
-class AnyHttpUrl(AnyUrl):
-    allowed_schemes = {'http', 'https'}
-
-    __slots__ = ()
-
-
-class HttpUrl(AnyHttpUrl):
-    tld_required = True
-    # https://stackoverflow.com/questions/417142/what-is-the-maximum-length-of-a-url-in-different-browsers
-    max_length = 2083
-    hidden_parts = {'port'}
-
-    @staticmethod
-    def get_default_parts(parts: 'Parts') -> 'Parts':
-        return {'port': '80' if parts['scheme'] == 'http' else '443'}
-
-
-class FileUrl(AnyUrl):
-    allowed_schemes = {'file'}
-    host_required = False
-
-    __slots__ = ()
-
-
-class MultiHostDsn(AnyUrl):
-    __slots__ = AnyUrl.__slots__ + ('hosts',)
-
-    def __init__(self, *args: Any, hosts: Optional[List['HostParts']] = None, **kwargs: Any):
-        super().__init__(*args, **kwargs)
-        self.hosts = hosts
-
-    @staticmethod
-    def _match_url(url: str) -> Optional[Match[str]]:
-        return multi_host_url_regex().match(url)
-
-    @classmethod
-    def validate_parts(cls, parts: 'Parts', validate_port: bool = True) -> 'Parts':
-        return super().validate_parts(parts, validate_port=False)
-
-    @classmethod
-    def _build_url(cls, m: Match[str], url: str, parts: 'Parts') -> 'MultiHostDsn':
-        hosts_parts: List['HostParts'] = []
-        host_re = host_regex()
-        for host in m.groupdict()['hosts'].split(','):
-            d: Parts = host_re.match(host).groupdict()  # type: ignore
-            host, tld, host_type, rebuild = cls.validate_host(d)
-            port = d.get('port')
-            cls._validate_port(port)
-            hosts_parts.append(
-                {
-                    'host': host,
-                    'host_type': host_type,
-                    'tld': tld,
-                    'rebuild': rebuild,
-                    'port': port,
-                }
-            )
-
-        if len(hosts_parts) > 1:
-            return cls(
-                None if any([hp['rebuild'] for hp in hosts_parts]) else url,
-                scheme=parts['scheme'],
-                user=parts['user'],
-                password=parts['password'],
-                path=parts['path'],
-                query=parts['query'],
-                fragment=parts['fragment'],
-                host_type=None,
-                hosts=hosts_parts,
-            )
-        else:
-            # backwards compatibility with single host
-            host_part = hosts_parts[0]
-            return cls(
-                None if host_part['rebuild'] else url,
-                scheme=parts['scheme'],
-                user=parts['user'],
-                password=parts['password'],
-                host=host_part['host'],
-                tld=host_part['tld'],
-                host_type=host_part['host_type'],
-                port=host_part.get('port'),
-                path=parts['path'],
-                query=parts['query'],
-                fragment=parts['fragment'],
-            )
-
-
-class PostgresDsn(MultiHostDsn):
-    allowed_schemes = {
-        'postgres',
-        'postgresql',
-        'postgresql+asyncpg',
-        'postgresql+pg8000',
-        'postgresql+psycopg',
-        'postgresql+psycopg2',
-        'postgresql+psycopg2cffi',
-        'postgresql+py-postgresql',
-        'postgresql+pygresql',
-    }
-    user_required = True
-
-    __slots__ = ()
-
-
-class CockroachDsn(AnyUrl):
-    allowed_schemes = {
-        'cockroachdb',
-        'cockroachdb+psycopg2',
-        'cockroachdb+asyncpg',
-    }
-    user_required = True
-
-
-class AmqpDsn(AnyUrl):
-    allowed_schemes = {'amqp', 'amqps'}
-    host_required = False
-
-
-class RedisDsn(AnyUrl):
-    __slots__ = ()
-    allowed_schemes = {'redis', 'rediss'}
-    host_required = False
-
-    @staticmethod
-    def get_default_parts(parts: 'Parts') -> 'Parts':
-        return {
-            'domain': 'localhost' if not (parts['ipv4'] or parts['ipv6']) else '',
-            'port': '6379',
-            'path': '/0',
-        }
-
-
-class MongoDsn(AnyUrl):
-    allowed_schemes = {'mongodb'}
-
-    # TODO: Needed to generic "Parts" for "Replica Set", "Sharded Cluster", and other mongodb deployment modes
-    @staticmethod
-    def get_default_parts(parts: 'Parts') -> 'Parts':
-        return {
-            'port': '27017',
-        }
-
-
-class KafkaDsn(AnyUrl):
-    allowed_schemes = {'kafka'}
-
-    @staticmethod
-    def get_default_parts(parts: 'Parts') -> 'Parts':
-        return {
-            'domain': 'localhost',
-            'port': '9092',
-        }
-
-
-def stricturl(
-    *,
-    strip_whitespace: bool = True,
-    min_length: int = 1,
-    max_length: int = 2**16,
-    tld_required: bool = True,
-    host_required: bool = True,
-    allowed_schemes: Optional[Collection[str]] = None,
-) -> Type[AnyUrl]:
-    # use kwargs then define conf in a dict to aid with IDE type hinting
-    namespace = dict(
-        strip_whitespace=strip_whitespace,
-        min_length=min_length,
-        max_length=max_length,
-        tld_required=tld_required,
-        host_required=host_required,
-        allowed_schemes=allowed_schemes,
-    )
-    return type('UrlValue', (AnyUrl,), namespace)
-
-
-def import_email_validator() -> None:
-    global email_validator
-    try:
-        import email_validator
-    except ImportError as e:
-        raise ImportError('email-validator is not installed, run `pip install pydantic[email]`') from e
-
-
-class EmailStr(str):
-    @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-        field_schema.update(type='string', format='email')
-
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        # included here and below so the error happens straight away
-        import_email_validator()
-
-        yield str_validator
-        yield cls.validate
-
-    @classmethod
-    def validate(cls, value: Union[str]) -> str:
-        return validate_email(value)[1]
-
-
-class NameEmail(Representation):
-    __slots__ = 'name', 'email'
-
-    def __init__(self, name: str, email: str):
-        self.name = name
-        self.email = email
-
-    def __eq__(self, other: Any) -> bool:
-        return isinstance(other, NameEmail) and (self.name, self.email) == (other.name, other.email)
-
-    @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-        field_schema.update(type='string', format='name-email')
-
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        import_email_validator()
-
-        yield cls.validate
-
-    @classmethod
-    def validate(cls, value: Any) -> 'NameEmail':
-        if value.__class__ == cls:
-            return value
-        value = str_validator(value)
-        return cls(*validate_email(value))
-
-    def __str__(self) -> str:
-        return f'{self.name} <{self.email}>'
-
-
-class IPvAnyAddress(_BaseAddress):
-    __slots__ = ()
-
-    @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-        field_schema.update(type='string', format='ipvanyaddress')
-
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield cls.validate
-
-    @classmethod
-    def validate(cls, value: Union[str, bytes, int]) -> Union[IPv4Address, IPv6Address]:
-        try:
-            return IPv4Address(value)
-        except ValueError:
-            pass
-
-        try:
-            return IPv6Address(value)
-        except ValueError:
-            raise errors.IPvAnyAddressError()
-
-
-class IPvAnyInterface(_BaseAddress):
-    __slots__ = ()
-
-    @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-        field_schema.update(type='string', format='ipvanyinterface')
-
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield cls.validate
-
-    @classmethod
-    def validate(cls, value: NetworkType) -> Union[IPv4Interface, IPv6Interface]:
-        try:
-            return IPv4Interface(value)
-        except ValueError:
-            pass
-
-        try:
-            return IPv6Interface(value)
-        except ValueError:
-            raise errors.IPvAnyInterfaceError()
-
-
-class IPvAnyNetwork(_BaseNetwork):  # type: ignore
-    @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-        field_schema.update(type='string', format='ipvanynetwork')
-
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield cls.validate
-
-    @classmethod
-    def validate(cls, value: NetworkType) -> Union[IPv4Network, IPv6Network]:
-        # Assume IP Network is defined with a default value for ``strict`` argument.
-        # Define your own class if you want to specify network address check strictness.
-        try:
-            return IPv4Network(value)
-        except ValueError:
-            pass
-
-        try:
-            return IPv6Network(value)
-        except ValueError:
-            raise errors.IPvAnyNetworkError()
-
-
-pretty_email_regex = re.compile(r'([\w ]*?) *<(.*)> *')
-MAX_EMAIL_LENGTH = 2048
-"""Maximum length for an email.
-A somewhat arbitrary but very generous number compared to what is allowed by most implementations.
-"""
-
-
-def validate_email(value: Union[str]) -> Tuple[str, str]:
-    """
-    Email address validation using https://pypi.org/project/email-validator/
-    Notes:
-    * raw ip address (literal) domain parts are not allowed.
-    * "John Doe <local_part@domain.com>" style "pretty" email addresses are processed
-    * spaces are striped from the beginning and end of addresses but no error is raised
-    """
-    if email_validator is None:
-        import_email_validator()
-
-    if len(value) > MAX_EMAIL_LENGTH:
-        raise errors.EmailError()
-
-    m = pretty_email_regex.fullmatch(value)
-    name: Union[str, None] = None
-    if m:
-        name, value = m.groups()
-    email = value.strip()
-    try:
-        parts = email_validator.validate_email(email, check_deliverability=False)
-    except email_validator.EmailNotValidError as e:
-        raise errors.EmailError from e
-
-    if hasattr(parts, 'normalized'):
-        # email-validator >= 2
-        email = parts.normalized
-        assert email is not None
-        name = name or parts.local_part
-        return name, email
-    else:
-        # email-validator >1, <2
-        at_index = email.index('@')
-        local_part = email[:at_index]  # RFC 5321, local part must be case-sensitive.
-        global_part = email[at_index:].lower()
-
-        return name or local_part, local_part + global_part
diff --git a/lib/pydantic/v1/parse.py b/lib/pydantic/v1/parse.py
deleted file mode 100644
index 7ac330ca..00000000
--- a/lib/pydantic/v1/parse.py
+++ /dev/null
@@ -1,66 +0,0 @@
-import json
-import pickle
-from enum import Enum
-from pathlib import Path
-from typing import Any, Callable, Union
-
-from .types import StrBytes
-
-
-class Protocol(str, Enum):
-    json = 'json'
-    pickle = 'pickle'
-
-
-def load_str_bytes(
-    b: StrBytes,
-    *,
-    content_type: str = None,
-    encoding: str = 'utf8',
-    proto: Protocol = None,
-    allow_pickle: bool = False,
-    json_loads: Callable[[str], Any] = json.loads,
-) -> Any:
-    if proto is None and content_type:
-        if content_type.endswith(('json', 'javascript')):
-            pass
-        elif allow_pickle and content_type.endswith('pickle'):
-            proto = Protocol.pickle
-        else:
-            raise TypeError(f'Unknown content-type: {content_type}')
-
-    proto = proto or Protocol.json
-
-    if proto == Protocol.json:
-        if isinstance(b, bytes):
-            b = b.decode(encoding)
-        return json_loads(b)
-    elif proto == Protocol.pickle:
-        if not allow_pickle:
-            raise RuntimeError('Trying to decode with pickle with allow_pickle=False')
-        bb = b if isinstance(b, bytes) else b.encode()
-        return pickle.loads(bb)
-    else:
-        raise TypeError(f'Unknown protocol: {proto}')
-
-
-def load_file(
-    path: Union[str, Path],
-    *,
-    content_type: str = None,
-    encoding: str = 'utf8',
-    proto: Protocol = None,
-    allow_pickle: bool = False,
-    json_loads: Callable[[str], Any] = json.loads,
-) -> Any:
-    path = Path(path)
-    b = path.read_bytes()
-    if content_type is None:
-        if path.suffix in ('.js', '.json'):
-            proto = Protocol.json
-        elif path.suffix == '.pkl':
-            proto = Protocol.pickle
-
-    return load_str_bytes(
-        b, proto=proto, content_type=content_type, encoding=encoding, allow_pickle=allow_pickle, json_loads=json_loads
-    )
diff --git a/lib/pydantic/v1/py.typed b/lib/pydantic/v1/py.typed
deleted file mode 100644
index e69de29b..00000000
diff --git a/lib/pydantic/v1/schema.py b/lib/pydantic/v1/schema.py
deleted file mode 100644
index ea16a72a..00000000
--- a/lib/pydantic/v1/schema.py
+++ /dev/null
@@ -1,1163 +0,0 @@
-import re
-import warnings
-from collections import defaultdict
-from dataclasses import is_dataclass
-from datetime import date, datetime, time, timedelta
-from decimal import Decimal
-from enum import Enum
-from ipaddress import IPv4Address, IPv4Interface, IPv4Network, IPv6Address, IPv6Interface, IPv6Network
-from pathlib import Path
-from typing import (
-    TYPE_CHECKING,
-    Any,
-    Callable,
-    Dict,
-    ForwardRef,
-    FrozenSet,
-    Generic,
-    Iterable,
-    List,
-    Optional,
-    Pattern,
-    Sequence,
-    Set,
-    Tuple,
-    Type,
-    TypeVar,
-    Union,
-    cast,
-)
-from uuid import UUID
-
-from typing_extensions import Annotated, Literal
-
-from .fields import (
-    MAPPING_LIKE_SHAPES,
-    SHAPE_DEQUE,
-    SHAPE_FROZENSET,
-    SHAPE_GENERIC,
-    SHAPE_ITERABLE,
-    SHAPE_LIST,
-    SHAPE_SEQUENCE,
-    SHAPE_SET,
-    SHAPE_SINGLETON,
-    SHAPE_TUPLE,
-    SHAPE_TUPLE_ELLIPSIS,
-    FieldInfo,
-    ModelField,
-)
-from .json import pydantic_encoder
-from .networks import AnyUrl, EmailStr
-from .types import (
-    ConstrainedDecimal,
-    ConstrainedFloat,
-    ConstrainedFrozenSet,
-    ConstrainedInt,
-    ConstrainedList,
-    ConstrainedSet,
-    ConstrainedStr,
-    SecretBytes,
-    SecretStr,
-    StrictBytes,
-    StrictStr,
-    conbytes,
-    condecimal,
-    confloat,
-    confrozenset,
-    conint,
-    conlist,
-    conset,
-    constr,
-)
-from .typing import (
-    all_literal_values,
-    get_args,
-    get_origin,
-    get_sub_types,
-    is_callable_type,
-    is_literal_type,
-    is_namedtuple,
-    is_none_type,
-    is_union,
-)
-from .utils import ROOT_KEY, get_model, lenient_issubclass
-
-if TYPE_CHECKING:
-    from .dataclasses import Dataclass
-    from .main import BaseModel
-
-default_prefix = '#/definitions/'
-default_ref_template = '#/definitions/{model}'
-
-TypeModelOrEnum = Union[Type['BaseModel'], Type[Enum]]
-TypeModelSet = Set[TypeModelOrEnum]
-
-
-def _apply_modify_schema(
-    modify_schema: Callable[..., None], field: Optional[ModelField], field_schema: Dict[str, Any]
-) -> None:
-    from inspect import signature
-
-    sig = signature(modify_schema)
-    args = set(sig.parameters.keys())
-    if 'field' in args or 'kwargs' in args:
-        modify_schema(field_schema, field=field)
-    else:
-        modify_schema(field_schema)
-
-
-def schema(
-    models: Sequence[Union[Type['BaseModel'], Type['Dataclass']]],
-    *,
-    by_alias: bool = True,
-    title: Optional[str] = None,
-    description: Optional[str] = None,
-    ref_prefix: Optional[str] = None,
-    ref_template: str = default_ref_template,
-) -> Dict[str, Any]:
-    """
-    Process a list of models and generate a single JSON Schema with all of them defined in the ``definitions``
-    top-level JSON key, including their sub-models.
-
-    :param models: a list of models to include in the generated JSON Schema
-    :param by_alias: generate the schemas using the aliases defined, if any
-    :param title: title for the generated schema that includes the definitions
-    :param description: description for the generated schema
-    :param ref_prefix: the JSON Pointer prefix for schema references with ``$ref``, if None, will be set to the
-      default of ``#/definitions/``. Update it if you want the schemas to reference the definitions somewhere
-      else, e.g. for OpenAPI use ``#/components/schemas/``. The resulting generated schemas will still be at the
-      top-level key ``definitions``, so you can extract them from there. But all the references will have the set
-      prefix.
-    :param ref_template: Use a ``string.format()`` template for ``$ref`` instead of a prefix. This can be useful
-      for references that cannot be represented by ``ref_prefix`` such as a definition stored in another file. For
-      a sibling json file in a ``/schemas`` directory use ``"/schemas/${model}.json#"``.
-    :return: dict with the JSON Schema with a ``definitions`` top-level key including the schema definitions for
-      the models and sub-models passed in ``models``.
-    """
-    clean_models = [get_model(model) for model in models]
-    flat_models = get_flat_models_from_models(clean_models)
-    model_name_map = get_model_name_map(flat_models)
-    definitions = {}
-    output_schema: Dict[str, Any] = {}
-    if title:
-        output_schema['title'] = title
-    if description:
-        output_schema['description'] = description
-    for model in clean_models:
-        m_schema, m_definitions, m_nested_models = model_process_schema(
-            model,
-            by_alias=by_alias,
-            model_name_map=model_name_map,
-            ref_prefix=ref_prefix,
-            ref_template=ref_template,
-        )
-        definitions.update(m_definitions)
-        model_name = model_name_map[model]
-        definitions[model_name] = m_schema
-    if definitions:
-        output_schema['definitions'] = definitions
-    return output_schema
-
-
-def model_schema(
-    model: Union[Type['BaseModel'], Type['Dataclass']],
-    by_alias: bool = True,
-    ref_prefix: Optional[str] = None,
-    ref_template: str = default_ref_template,
-) -> Dict[str, Any]:
-    """
-    Generate a JSON Schema for one model. With all the sub-models defined in the ``definitions`` top-level
-    JSON key.
-
-    :param model: a Pydantic model (a class that inherits from BaseModel)
-    :param by_alias: generate the schemas using the aliases defined, if any
-    :param ref_prefix: the JSON Pointer prefix for schema references with ``$ref``, if None, will be set to the
-      default of ``#/definitions/``. Update it if you want the schemas to reference the definitions somewhere
-      else, e.g. for OpenAPI use ``#/components/schemas/``. The resulting generated schemas will still be at the
-      top-level key ``definitions``, so you can extract them from there. But all the references will have the set
-      prefix.
-    :param ref_template: Use a ``string.format()`` template for ``$ref`` instead of a prefix. This can be useful for
-      references that cannot be represented by ``ref_prefix`` such as a definition stored in another file. For a
-      sibling json file in a ``/schemas`` directory use ``"/schemas/${model}.json#"``.
-    :return: dict with the JSON Schema for the passed ``model``
-    """
-    model = get_model(model)
-    flat_models = get_flat_models_from_model(model)
-    model_name_map = get_model_name_map(flat_models)
-    model_name = model_name_map[model]
-    m_schema, m_definitions, nested_models = model_process_schema(
-        model, by_alias=by_alias, model_name_map=model_name_map, ref_prefix=ref_prefix, ref_template=ref_template
-    )
-    if model_name in nested_models:
-        # model_name is in Nested models, it has circular references
-        m_definitions[model_name] = m_schema
-        m_schema = get_schema_ref(model_name, ref_prefix, ref_template, False)
-    if m_definitions:
-        m_schema.update({'definitions': m_definitions})
-    return m_schema
-
-
-def get_field_info_schema(field: ModelField, schema_overrides: bool = False) -> Tuple[Dict[str, Any], bool]:
-    # If no title is explicitly set, we don't set title in the schema for enums.
-    # The behaviour is the same as `BaseModel` reference, where the default title
-    # is in the definitions part of the schema.
-    schema_: Dict[str, Any] = {}
-    if field.field_info.title or not lenient_issubclass(field.type_, Enum):
-        schema_['title'] = field.field_info.title or field.alias.title().replace('_', ' ')
-
-    if field.field_info.title:
-        schema_overrides = True
-
-    if field.field_info.description:
-        schema_['description'] = field.field_info.description
-        schema_overrides = True
-
-    if not field.required and field.default is not None and not is_callable_type(field.outer_type_):
-        schema_['default'] = encode_default(field.default)
-        schema_overrides = True
-
-    return schema_, schema_overrides
-
-
-def field_schema(
-    field: ModelField,
-    *,
-    by_alias: bool = True,
-    model_name_map: Dict[TypeModelOrEnum, str],
-    ref_prefix: Optional[str] = None,
-    ref_template: str = default_ref_template,
-    known_models: Optional[TypeModelSet] = None,
-) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]:
-    """
-    Process a Pydantic field and return a tuple with a JSON Schema for it as the first item.
-    Also return a dictionary of definitions with models as keys and their schemas as values. If the passed field
-    is a model and has sub-models, and those sub-models don't have overrides (as ``title``, ``default``, etc), they
-    will be included in the definitions and referenced in the schema instead of included recursively.
-
-    :param field: a Pydantic ``ModelField``
-    :param by_alias: use the defined alias (if any) in the returned schema
-    :param model_name_map: used to generate the JSON Schema references to other models included in the definitions
-    :param ref_prefix: the JSON Pointer prefix to use for references to other schemas, if None, the default of
-      #/definitions/ will be used
-    :param ref_template: Use a ``string.format()`` template for ``$ref`` instead of a prefix. This can be useful for
-      references that cannot be represented by ``ref_prefix`` such as a definition stored in another file. For a
-      sibling json file in a ``/schemas`` directory use ``"/schemas/${model}.json#"``.
-    :param known_models: used to solve circular references
-    :return: tuple of the schema for this field and additional definitions
-    """
-    s, schema_overrides = get_field_info_schema(field)
-
-    validation_schema = get_field_schema_validations(field)
-    if validation_schema:
-        s.update(validation_schema)
-        schema_overrides = True
-
-    f_schema, f_definitions, f_nested_models = field_type_schema(
-        field,
-        by_alias=by_alias,
-        model_name_map=model_name_map,
-        schema_overrides=schema_overrides,
-        ref_prefix=ref_prefix,
-        ref_template=ref_template,
-        known_models=known_models or set(),
-    )
-
-    # $ref will only be returned when there are no schema_overrides
-    if '$ref' in f_schema:
-        return f_schema, f_definitions, f_nested_models
-    else:
-        s.update(f_schema)
-        return s, f_definitions, f_nested_models
-
-
-numeric_types = (int, float, Decimal)
-_str_types_attrs: Tuple[Tuple[str, Union[type, Tuple[type, ...]], str], ...] = (
-    ('max_length', numeric_types, 'maxLength'),
-    ('min_length', numeric_types, 'minLength'),
-    ('regex', str, 'pattern'),
-)
-
-_numeric_types_attrs: Tuple[Tuple[str, Union[type, Tuple[type, ...]], str], ...] = (
-    ('gt', numeric_types, 'exclusiveMinimum'),
-    ('lt', numeric_types, 'exclusiveMaximum'),
-    ('ge', numeric_types, 'minimum'),
-    ('le', numeric_types, 'maximum'),
-    ('multiple_of', numeric_types, 'multipleOf'),
-)
-
-
-def get_field_schema_validations(field: ModelField) -> Dict[str, Any]:
-    """
-    Get the JSON Schema validation keywords for a ``field`` with an annotation of
-    a Pydantic ``FieldInfo`` with validation arguments.
-    """
-    f_schema: Dict[str, Any] = {}
-
-    if lenient_issubclass(field.type_, Enum):
-        # schema is already updated by `enum_process_schema`; just update with field extra
-        if field.field_info.extra:
-            f_schema.update(field.field_info.extra)
-        return f_schema
-
-    if lenient_issubclass(field.type_, (str, bytes)):
-        for attr_name, t, keyword in _str_types_attrs:
-            attr = getattr(field.field_info, attr_name, None)
-            if isinstance(attr, t):
-                f_schema[keyword] = attr
-    if lenient_issubclass(field.type_, numeric_types) and not issubclass(field.type_, bool):
-        for attr_name, t, keyword in _numeric_types_attrs:
-            attr = getattr(field.field_info, attr_name, None)
-            if isinstance(attr, t):
-                f_schema[keyword] = attr
-    if field.field_info is not None and field.field_info.const:
-        f_schema['const'] = field.default
-    if field.field_info.extra:
-        f_schema.update(field.field_info.extra)
-    modify_schema = getattr(field.outer_type_, '__modify_schema__', None)
-    if modify_schema:
-        _apply_modify_schema(modify_schema, field, f_schema)
-    return f_schema
-
-
-def get_model_name_map(unique_models: TypeModelSet) -> Dict[TypeModelOrEnum, str]:
-    """
-    Process a set of models and generate unique names for them to be used as keys in the JSON Schema
-    definitions. By default the names are the same as the class name. But if two models in different Python
-    modules have the same name (e.g. "users.Model" and "items.Model"), the generated names will be
-    based on the Python module path for those conflicting models to prevent name collisions.
-
-    :param unique_models: a Python set of models
-    :return: dict mapping models to names
-    """
-    name_model_map = {}
-    conflicting_names: Set[str] = set()
-    for model in unique_models:
-        model_name = normalize_name(model.__name__)
-        if model_name in conflicting_names:
-            model_name = get_long_model_name(model)
-            name_model_map[model_name] = model
-        elif model_name in name_model_map:
-            conflicting_names.add(model_name)
-            conflicting_model = name_model_map.pop(model_name)
-            name_model_map[get_long_model_name(conflicting_model)] = conflicting_model
-            name_model_map[get_long_model_name(model)] = model
-        else:
-            name_model_map[model_name] = model
-    return {v: k for k, v in name_model_map.items()}
-
-
-def get_flat_models_from_model(model: Type['BaseModel'], known_models: Optional[TypeModelSet] = None) -> TypeModelSet:
-    """
-    Take a single ``model`` and generate a set with itself and all the sub-models in the tree. I.e. if you pass
-    model ``Foo`` (subclass of Pydantic ``BaseModel``) as ``model``, and it has a field of type ``Bar`` (also
-    subclass of ``BaseModel``) and that model ``Bar`` has a field of type ``Baz`` (also subclass of ``BaseModel``),
-    the return value will be ``set([Foo, Bar, Baz])``.
-
-    :param model: a Pydantic ``BaseModel`` subclass
-    :param known_models: used to solve circular references
-    :return: a set with the initial model and all its sub-models
-    """
-    known_models = known_models or set()
-    flat_models: TypeModelSet = set()
-    flat_models.add(model)
-    known_models |= flat_models
-    fields = cast(Sequence[ModelField], model.__fields__.values())
-    flat_models |= get_flat_models_from_fields(fields, known_models=known_models)
-    return flat_models
-
-
-def get_flat_models_from_field(field: ModelField, known_models: TypeModelSet) -> TypeModelSet:
-    """
-    Take a single Pydantic ``ModelField`` (from a model) that could have been declared as a subclass of BaseModel
-    (so, it could be a submodel), and generate a set with its model and all the sub-models in the tree.
-    I.e. if you pass a field that was declared to be of type ``Foo`` (subclass of BaseModel) as ``field``, and that
-    model ``Foo`` has a field of type ``Bar`` (also subclass of ``BaseModel``) and that model ``Bar`` has a field of
-    type ``Baz`` (also subclass of ``BaseModel``), the return value will be ``set([Foo, Bar, Baz])``.
-
-    :param field: a Pydantic ``ModelField``
-    :param known_models: used to solve circular references
-    :return: a set with the model used in the declaration for this field, if any, and all its sub-models
-    """
-    from .main import BaseModel
-
-    flat_models: TypeModelSet = set()
-
-    field_type = field.type_
-    if lenient_issubclass(getattr(field_type, '__pydantic_model__', None), BaseModel):
-        field_type = field_type.__pydantic_model__
-
-    if field.sub_fields and not lenient_issubclass(field_type, BaseModel):
-        flat_models |= get_flat_models_from_fields(field.sub_fields, known_models=known_models)
-    elif lenient_issubclass(field_type, BaseModel) and field_type not in known_models:
-        flat_models |= get_flat_models_from_model(field_type, known_models=known_models)
-    elif lenient_issubclass(field_type, Enum):
-        flat_models.add(field_type)
-    return flat_models
-
-
-def get_flat_models_from_fields(fields: Sequence[ModelField], known_models: TypeModelSet) -> TypeModelSet:
-    """
-    Take a list of Pydantic  ``ModelField``s (from a model) that could have been declared as subclasses of ``BaseModel``
-    (so, any of them could be a submodel), and generate a set with their models and all the sub-models in the tree.
-    I.e. if you pass a the fields of a model ``Foo`` (subclass of ``BaseModel``) as ``fields``, and on of them has a
-    field of type ``Bar`` (also subclass of ``BaseModel``) and that model ``Bar`` has a field of type ``Baz`` (also
-    subclass of ``BaseModel``), the return value will be ``set([Foo, Bar, Baz])``.
-
-    :param fields: a list of Pydantic ``ModelField``s
-    :param known_models: used to solve circular references
-    :return: a set with any model declared in the fields, and all their sub-models
-    """
-    flat_models: TypeModelSet = set()
-    for field in fields:
-        flat_models |= get_flat_models_from_field(field, known_models=known_models)
-    return flat_models
-
-
-def get_flat_models_from_models(models: Sequence[Type['BaseModel']]) -> TypeModelSet:
-    """
-    Take a list of ``models`` and generate a set with them and all their sub-models in their trees. I.e. if you pass
-    a list of two models, ``Foo`` and ``Bar``, both subclasses of Pydantic ``BaseModel`` as models, and ``Bar`` has
-    a field of type ``Baz`` (also subclass of ``BaseModel``), the return value will be ``set([Foo, Bar, Baz])``.
-    """
-    flat_models: TypeModelSet = set()
-    for model in models:
-        flat_models |= get_flat_models_from_model(model)
-    return flat_models
-
-
-def get_long_model_name(model: TypeModelOrEnum) -> str:
-    return f'{model.__module__}__{model.__qualname__}'.replace('.', '__')
-
-
-def field_type_schema(
-    field: ModelField,
-    *,
-    by_alias: bool,
-    model_name_map: Dict[TypeModelOrEnum, str],
-    ref_template: str,
-    schema_overrides: bool = False,
-    ref_prefix: Optional[str] = None,
-    known_models: TypeModelSet,
-) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]:
-    """
-    Used by ``field_schema()``, you probably should be using that function.
-
-    Take a single ``field`` and generate the schema for its type only, not including additional
-    information as title, etc. Also return additional schema definitions, from sub-models.
-    """
-    from .main import BaseModel  # noqa: F811
-
-    definitions = {}
-    nested_models: Set[str] = set()
-    f_schema: Dict[str, Any]
-    if field.shape in {
-        SHAPE_LIST,
-        SHAPE_TUPLE_ELLIPSIS,
-        SHAPE_SEQUENCE,
-        SHAPE_SET,
-        SHAPE_FROZENSET,
-        SHAPE_ITERABLE,
-        SHAPE_DEQUE,
-    }:
-        items_schema, f_definitions, f_nested_models = field_singleton_schema(
-            field,
-            by_alias=by_alias,
-            model_name_map=model_name_map,
-            ref_prefix=ref_prefix,
-            ref_template=ref_template,
-            known_models=known_models,
-        )
-        definitions.update(f_definitions)
-        nested_models.update(f_nested_models)
-        f_schema = {'type': 'array', 'items': items_schema}
-        if field.shape in {SHAPE_SET, SHAPE_FROZENSET}:
-            f_schema['uniqueItems'] = True
-
-    elif field.shape in MAPPING_LIKE_SHAPES:
-        f_schema = {'type': 'object'}
-        key_field = cast(ModelField, field.key_field)
-        regex = getattr(key_field.type_, 'regex', None)
-        items_schema, f_definitions, f_nested_models = field_singleton_schema(
-            field,
-            by_alias=by_alias,
-            model_name_map=model_name_map,
-            ref_prefix=ref_prefix,
-            ref_template=ref_template,
-            known_models=known_models,
-        )
-        definitions.update(f_definitions)
-        nested_models.update(f_nested_models)
-        if regex:
-            # Dict keys have a regex pattern
-            # items_schema might be a schema or empty dict, add it either way
-            f_schema['patternProperties'] = {ConstrainedStr._get_pattern(regex): items_schema}
-        if items_schema:
-            # The dict values are not simply Any, so they need a schema
-            f_schema['additionalProperties'] = items_schema
-    elif field.shape == SHAPE_TUPLE or (field.shape == SHAPE_GENERIC and not issubclass(field.type_, BaseModel)):
-        sub_schema = []
-        sub_fields = cast(List[ModelField], field.sub_fields)
-        for sf in sub_fields:
-            sf_schema, sf_definitions, sf_nested_models = field_type_schema(
-                sf,
-                by_alias=by_alias,
-                model_name_map=model_name_map,
-                ref_prefix=ref_prefix,
-                ref_template=ref_template,
-                known_models=known_models,
-            )
-            definitions.update(sf_definitions)
-            nested_models.update(sf_nested_models)
-            sub_schema.append(sf_schema)
-
-        sub_fields_len = len(sub_fields)
-        if field.shape == SHAPE_GENERIC:
-            all_of_schemas = sub_schema[0] if sub_fields_len == 1 else {'type': 'array', 'items': sub_schema}
-            f_schema = {'allOf': [all_of_schemas]}
-        else:
-            f_schema = {
-                'type': 'array',
-                'minItems': sub_fields_len,
-                'maxItems': sub_fields_len,
-            }
-            if sub_fields_len >= 1:
-                f_schema['items'] = sub_schema
-    else:
-        assert field.shape in {SHAPE_SINGLETON, SHAPE_GENERIC}, field.shape
-        f_schema, f_definitions, f_nested_models = field_singleton_schema(
-            field,
-            by_alias=by_alias,
-            model_name_map=model_name_map,
-            schema_overrides=schema_overrides,
-            ref_prefix=ref_prefix,
-            ref_template=ref_template,
-            known_models=known_models,
-        )
-        definitions.update(f_definitions)
-        nested_models.update(f_nested_models)
-
-    # check field type to avoid repeated calls to the same __modify_schema__ method
-    if field.type_ != field.outer_type_:
-        if field.shape == SHAPE_GENERIC:
-            field_type = field.type_
-        else:
-            field_type = field.outer_type_
-        modify_schema = getattr(field_type, '__modify_schema__', None)
-        if modify_schema:
-            _apply_modify_schema(modify_schema, field, f_schema)
-    return f_schema, definitions, nested_models
-
-
-def model_process_schema(
-    model: TypeModelOrEnum,
-    *,
-    by_alias: bool = True,
-    model_name_map: Dict[TypeModelOrEnum, str],
-    ref_prefix: Optional[str] = None,
-    ref_template: str = default_ref_template,
-    known_models: Optional[TypeModelSet] = None,
-    field: Optional[ModelField] = None,
-) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]:
-    """
-    Used by ``model_schema()``, you probably should be using that function.
-
-    Take a single ``model`` and generate its schema. Also return additional schema definitions, from sub-models. The
-    sub-models of the returned schema will be referenced, but their definitions will not be included in the schema. All
-    the definitions are returned as the second value.
-    """
-    from inspect import getdoc, signature
-
-    known_models = known_models or set()
-    if lenient_issubclass(model, Enum):
-        model = cast(Type[Enum], model)
-        s = enum_process_schema(model, field=field)
-        return s, {}, set()
-    model = cast(Type['BaseModel'], model)
-    s = {'title': model.__config__.title or model.__name__}
-    doc = getdoc(model)
-    if doc:
-        s['description'] = doc
-    known_models.add(model)
-    m_schema, m_definitions, nested_models = model_type_schema(
-        model,
-        by_alias=by_alias,
-        model_name_map=model_name_map,
-        ref_prefix=ref_prefix,
-        ref_template=ref_template,
-        known_models=known_models,
-    )
-    s.update(m_schema)
-    schema_extra = model.__config__.schema_extra
-    if callable(schema_extra):
-        if len(signature(schema_extra).parameters) == 1:
-            schema_extra(s)
-        else:
-            schema_extra(s, model)
-    else:
-        s.update(schema_extra)
-    return s, m_definitions, nested_models
-
-
-def model_type_schema(
-    model: Type['BaseModel'],
-    *,
-    by_alias: bool,
-    model_name_map: Dict[TypeModelOrEnum, str],
-    ref_template: str,
-    ref_prefix: Optional[str] = None,
-    known_models: TypeModelSet,
-) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]:
-    """
-    You probably should be using ``model_schema()``, this function is indirectly used by that function.
-
-    Take a single ``model`` and generate the schema for its type only, not including additional
-    information as title, etc. Also return additional schema definitions, from sub-models.
-    """
-    properties = {}
-    required = []
-    definitions: Dict[str, Any] = {}
-    nested_models: Set[str] = set()
-    for k, f in model.__fields__.items():
-        try:
-            f_schema, f_definitions, f_nested_models = field_schema(
-                f,
-                by_alias=by_alias,
-                model_name_map=model_name_map,
-                ref_prefix=ref_prefix,
-                ref_template=ref_template,
-                known_models=known_models,
-            )
-        except SkipField as skip:
-            warnings.warn(skip.message, UserWarning)
-            continue
-        definitions.update(f_definitions)
-        nested_models.update(f_nested_models)
-        if by_alias:
-            properties[f.alias] = f_schema
-            if f.required:
-                required.append(f.alias)
-        else:
-            properties[k] = f_schema
-            if f.required:
-                required.append(k)
-    if ROOT_KEY in properties:
-        out_schema = properties[ROOT_KEY]
-        out_schema['title'] = model.__config__.title or model.__name__
-    else:
-        out_schema = {'type': 'object', 'properties': properties}
-        if required:
-            out_schema['required'] = required
-    if model.__config__.extra == 'forbid':
-        out_schema['additionalProperties'] = False
-    return out_schema, definitions, nested_models
-
-
-def enum_process_schema(enum: Type[Enum], *, field: Optional[ModelField] = None) -> Dict[str, Any]:
-    """
-    Take a single `enum` and generate its schema.
-
-    This is similar to the `model_process_schema` function, but applies to ``Enum`` objects.
-    """
-    import inspect
-
-    schema_: Dict[str, Any] = {
-        'title': enum.__name__,
-        # Python assigns all enums a default docstring value of 'An enumeration', so
-        # all enums will have a description field even if not explicitly provided.
-        'description': inspect.cleandoc(enum.__doc__ or 'An enumeration.'),
-        # Add enum values and the enum field type to the schema.
-        'enum': [item.value for item in cast(Iterable[Enum], enum)],
-    }
-
-    add_field_type_to_schema(enum, schema_)
-
-    modify_schema = getattr(enum, '__modify_schema__', None)
-    if modify_schema:
-        _apply_modify_schema(modify_schema, field, schema_)
-
-    return schema_
-
-
-def field_singleton_sub_fields_schema(
-    field: ModelField,
-    *,
-    by_alias: bool,
-    model_name_map: Dict[TypeModelOrEnum, str],
-    ref_template: str,
-    schema_overrides: bool = False,
-    ref_prefix: Optional[str] = None,
-    known_models: TypeModelSet,
-) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]:
-    """
-    This function is indirectly used by ``field_schema()``, you probably should be using that function.
-
-    Take a list of Pydantic ``ModelField`` from the declaration of a type with parameters, and generate their
-    schema. I.e., fields used as "type parameters", like ``str`` and ``int`` in ``Tuple[str, int]``.
-    """
-    sub_fields = cast(List[ModelField], field.sub_fields)
-    definitions = {}
-    nested_models: Set[str] = set()
-    if len(sub_fields) == 1:
-        return field_type_schema(
-            sub_fields[0],
-            by_alias=by_alias,
-            model_name_map=model_name_map,
-            schema_overrides=schema_overrides,
-            ref_prefix=ref_prefix,
-            ref_template=ref_template,
-            known_models=known_models,
-        )
-    else:
-        s: Dict[str, Any] = {}
-        # https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#discriminator-object
-        field_has_discriminator: bool = field.discriminator_key is not None
-        if field_has_discriminator:
-            assert field.sub_fields_mapping is not None
-
-            discriminator_models_refs: Dict[str, Union[str, Dict[str, Any]]] = {}
-
-            for discriminator_value, sub_field in field.sub_fields_mapping.items():
-                if isinstance(discriminator_value, Enum):
-                    discriminator_value = str(discriminator_value.value)
-                # sub_field is either a `BaseModel` or directly an `Annotated` `Union` of many
-                if is_union(get_origin(sub_field.type_)):
-                    sub_models = get_sub_types(sub_field.type_)
-                    discriminator_models_refs[discriminator_value] = {
-                        model_name_map[sub_model]: get_schema_ref(
-                            model_name_map[sub_model], ref_prefix, ref_template, False
-                        )
-                        for sub_model in sub_models
-                    }
-                else:
-                    sub_field_type = sub_field.type_
-                    if hasattr(sub_field_type, '__pydantic_model__'):
-                        sub_field_type = sub_field_type.__pydantic_model__
-
-                    discriminator_model_name = model_name_map[sub_field_type]
-                    discriminator_model_ref = get_schema_ref(discriminator_model_name, ref_prefix, ref_template, False)
-                    discriminator_models_refs[discriminator_value] = discriminator_model_ref['$ref']
-
-            s['discriminator'] = {
-                'propertyName': field.discriminator_alias,
-                'mapping': discriminator_models_refs,
-            }
-
-        sub_field_schemas = []
-        for sf in sub_fields:
-            sub_schema, sub_definitions, sub_nested_models = field_type_schema(
-                sf,
-                by_alias=by_alias,
-                model_name_map=model_name_map,
-                schema_overrides=schema_overrides,
-                ref_prefix=ref_prefix,
-                ref_template=ref_template,
-                known_models=known_models,
-            )
-            definitions.update(sub_definitions)
-            if schema_overrides and 'allOf' in sub_schema:
-                # if the sub_field is a referenced schema we only need the referenced
-                # object. Otherwise we will end up with several allOf inside anyOf/oneOf.
-                # See https://github.com/pydantic/pydantic/issues/1209
-                sub_schema = sub_schema['allOf'][0]
-
-            if sub_schema.keys() == {'discriminator', 'oneOf'}:
-                # we don't want discriminator information inside oneOf choices, this is dealt with elsewhere
-                sub_schema.pop('discriminator')
-            sub_field_schemas.append(sub_schema)
-            nested_models.update(sub_nested_models)
-        s['oneOf' if field_has_discriminator else 'anyOf'] = sub_field_schemas
-        return s, definitions, nested_models
-
-
-# Order is important, e.g. subclasses of str must go before str
-# this is used only for standard library types, custom types should use __modify_schema__ instead
-field_class_to_schema: Tuple[Tuple[Any, Dict[str, Any]], ...] = (
-    (Path, {'type': 'string', 'format': 'path'}),
-    (datetime, {'type': 'string', 'format': 'date-time'}),
-    (date, {'type': 'string', 'format': 'date'}),
-    (time, {'type': 'string', 'format': 'time'}),
-    (timedelta, {'type': 'number', 'format': 'time-delta'}),
-    (IPv4Network, {'type': 'string', 'format': 'ipv4network'}),
-    (IPv6Network, {'type': 'string', 'format': 'ipv6network'}),
-    (IPv4Interface, {'type': 'string', 'format': 'ipv4interface'}),
-    (IPv6Interface, {'type': 'string', 'format': 'ipv6interface'}),
-    (IPv4Address, {'type': 'string', 'format': 'ipv4'}),
-    (IPv6Address, {'type': 'string', 'format': 'ipv6'}),
-    (Pattern, {'type': 'string', 'format': 'regex'}),
-    (str, {'type': 'string'}),
-    (bytes, {'type': 'string', 'format': 'binary'}),
-    (bool, {'type': 'boolean'}),
-    (int, {'type': 'integer'}),
-    (float, {'type': 'number'}),
-    (Decimal, {'type': 'number'}),
-    (UUID, {'type': 'string', 'format': 'uuid'}),
-    (dict, {'type': 'object'}),
-    (list, {'type': 'array', 'items': {}}),
-    (tuple, {'type': 'array', 'items': {}}),
-    (set, {'type': 'array', 'items': {}, 'uniqueItems': True}),
-    (frozenset, {'type': 'array', 'items': {}, 'uniqueItems': True}),
-)
-
-json_scheme = {'type': 'string', 'format': 'json-string'}
-
-
-def add_field_type_to_schema(field_type: Any, schema_: Dict[str, Any]) -> None:
-    """
-    Update the given `schema` with the type-specific metadata for the given `field_type`.
-
-    This function looks through `field_class_to_schema` for a class that matches the given `field_type`,
-    and then modifies the given `schema` with the information from that type.
-    """
-    for type_, t_schema in field_class_to_schema:
-        # Fallback for `typing.Pattern` and `re.Pattern` as they are not a valid class
-        if lenient_issubclass(field_type, type_) or field_type is type_ is Pattern:
-            schema_.update(t_schema)
-            break
-
-
-def get_schema_ref(name: str, ref_prefix: Optional[str], ref_template: str, schema_overrides: bool) -> Dict[str, Any]:
-    if ref_prefix:
-        schema_ref = {'$ref': ref_prefix + name}
-    else:
-        schema_ref = {'$ref': ref_template.format(model=name)}
-    return {'allOf': [schema_ref]} if schema_overrides else schema_ref
-
-
-def field_singleton_schema(  # noqa: C901 (ignore complexity)
-    field: ModelField,
-    *,
-    by_alias: bool,
-    model_name_map: Dict[TypeModelOrEnum, str],
-    ref_template: str,
-    schema_overrides: bool = False,
-    ref_prefix: Optional[str] = None,
-    known_models: TypeModelSet,
-) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]:
-    """
-    This function is indirectly used by ``field_schema()``, you should probably be using that function.
-
-    Take a single Pydantic ``ModelField``, and return its schema and any additional definitions from sub-models.
-    """
-    from .main import BaseModel
-
-    definitions: Dict[str, Any] = {}
-    nested_models: Set[str] = set()
-    field_type = field.type_
-
-    # Recurse into this field if it contains sub_fields and is NOT a
-    # BaseModel OR that BaseModel is a const
-    if field.sub_fields and (
-        (field.field_info and field.field_info.const) or not lenient_issubclass(field_type, BaseModel)
-    ):
-        return field_singleton_sub_fields_schema(
-            field,
-            by_alias=by_alias,
-            model_name_map=model_name_map,
-            schema_overrides=schema_overrides,
-            ref_prefix=ref_prefix,
-            ref_template=ref_template,
-            known_models=known_models,
-        )
-    if field_type is Any or field_type is object or field_type.__class__ == TypeVar or get_origin(field_type) is type:
-        return {}, definitions, nested_models  # no restrictions
-    if is_none_type(field_type):
-        return {'type': 'null'}, definitions, nested_models
-    if is_callable_type(field_type):
-        raise SkipField(f'Callable {field.name} was excluded from schema since JSON schema has no equivalent type.')
-    f_schema: Dict[str, Any] = {}
-    if field.field_info is not None and field.field_info.const:
-        f_schema['const'] = field.default
-
-    if is_literal_type(field_type):
-        values = tuple(x.value if isinstance(x, Enum) else x for x in all_literal_values(field_type))
-
-        if len({v.__class__ for v in values}) > 1:
-            return field_schema(
-                multitypes_literal_field_for_schema(values, field),
-                by_alias=by_alias,
-                model_name_map=model_name_map,
-                ref_prefix=ref_prefix,
-                ref_template=ref_template,
-                known_models=known_models,
-            )
-
-        # All values have the same type
-        field_type = values[0].__class__
-        f_schema['enum'] = list(values)
-        add_field_type_to_schema(field_type, f_schema)
-    elif lenient_issubclass(field_type, Enum):
-        enum_name = model_name_map[field_type]
-        f_schema, schema_overrides = get_field_info_schema(field, schema_overrides)
-        f_schema.update(get_schema_ref(enum_name, ref_prefix, ref_template, schema_overrides))
-        definitions[enum_name] = enum_process_schema(field_type, field=field)
-    elif is_namedtuple(field_type):
-        sub_schema, *_ = model_process_schema(
-            field_type.__pydantic_model__,
-            by_alias=by_alias,
-            model_name_map=model_name_map,
-            ref_prefix=ref_prefix,
-            ref_template=ref_template,
-            known_models=known_models,
-            field=field,
-        )
-        items_schemas = list(sub_schema['properties'].values())
-        f_schema.update(
-            {
-                'type': 'array',
-                'items': items_schemas,
-                'minItems': len(items_schemas),
-                'maxItems': len(items_schemas),
-            }
-        )
-    elif not hasattr(field_type, '__pydantic_model__'):
-        add_field_type_to_schema(field_type, f_schema)
-
-        modify_schema = getattr(field_type, '__modify_schema__', None)
-        if modify_schema:
-            _apply_modify_schema(modify_schema, field, f_schema)
-
-    if f_schema:
-        return f_schema, definitions, nested_models
-
-    # Handle dataclass-based models
-    if lenient_issubclass(getattr(field_type, '__pydantic_model__', None), BaseModel):
-        field_type = field_type.__pydantic_model__
-
-    if issubclass(field_type, BaseModel):
-        model_name = model_name_map[field_type]
-        if field_type not in known_models:
-            sub_schema, sub_definitions, sub_nested_models = model_process_schema(
-                field_type,
-                by_alias=by_alias,
-                model_name_map=model_name_map,
-                ref_prefix=ref_prefix,
-                ref_template=ref_template,
-                known_models=known_models,
-                field=field,
-            )
-            definitions.update(sub_definitions)
-            definitions[model_name] = sub_schema
-            nested_models.update(sub_nested_models)
-        else:
-            nested_models.add(model_name)
-        schema_ref = get_schema_ref(model_name, ref_prefix, ref_template, schema_overrides)
-        return schema_ref, definitions, nested_models
-
-    # For generics with no args
-    args = get_args(field_type)
-    if args is not None and not args and Generic in field_type.__bases__:
-        return f_schema, definitions, nested_models
-
-    raise ValueError(f'Value not declarable with JSON Schema, field: {field}')
-
-
-def multitypes_literal_field_for_schema(values: Tuple[Any, ...], field: ModelField) -> ModelField:
-    """
-    To support `Literal` with values of different types, we split it into multiple `Literal` with same type
-    e.g. `Literal['qwe', 'asd', 1, 2]` becomes `Union[Literal['qwe', 'asd'], Literal[1, 2]]`
-    """
-    literal_distinct_types = defaultdict(list)
-    for v in values:
-        literal_distinct_types[v.__class__].append(v)
-    distinct_literals = (Literal[tuple(same_type_values)] for same_type_values in literal_distinct_types.values())
-
-    return ModelField(
-        name=field.name,
-        type_=Union[tuple(distinct_literals)],  # type: ignore
-        class_validators=field.class_validators,
-        model_config=field.model_config,
-        default=field.default,
-        required=field.required,
-        alias=field.alias,
-        field_info=field.field_info,
-    )
-
-
-def encode_default(dft: Any) -> Any:
-    from .main import BaseModel
-
-    if isinstance(dft, BaseModel) or is_dataclass(dft):
-        dft = cast('dict[str, Any]', pydantic_encoder(dft))
-
-    if isinstance(dft, dict):
-        return {encode_default(k): encode_default(v) for k, v in dft.items()}
-    elif isinstance(dft, Enum):
-        return dft.value
-    elif isinstance(dft, (int, float, str)):
-        return dft
-    elif isinstance(dft, (list, tuple)):
-        t = dft.__class__
-        seq_args = (encode_default(v) for v in dft)
-        return t(*seq_args) if is_namedtuple(t) else t(seq_args)
-    elif dft is None:
-        return None
-    else:
-        return pydantic_encoder(dft)
-
-
-_map_types_constraint: Dict[Any, Callable[..., type]] = {int: conint, float: confloat, Decimal: condecimal}
-
-
-def get_annotation_from_field_info(
-    annotation: Any, field_info: FieldInfo, field_name: str, validate_assignment: bool = False
-) -> Type[Any]:
-    """
-    Get an annotation with validation implemented for numbers and strings based on the field_info.
-    :param annotation: an annotation from a field specification, as ``str``, ``ConstrainedStr``
-    :param field_info: an instance of FieldInfo, possibly with declarations for validations and JSON Schema
-    :param field_name: name of the field for use in error messages
-    :param validate_assignment: default False, flag for BaseModel Config value of validate_assignment
-    :return: the same ``annotation`` if unmodified or a new annotation with validation in place
-    """
-    constraints = field_info.get_constraints()
-    used_constraints: Set[str] = set()
-    if constraints:
-        annotation, used_constraints = get_annotation_with_constraints(annotation, field_info)
-    if validate_assignment:
-        used_constraints.add('allow_mutation')
-
-    unused_constraints = constraints - used_constraints
-    if unused_constraints:
-        raise ValueError(
-            f'On field "{field_name}" the following field constraints are set but not enforced: '
-            f'{", ".join(unused_constraints)}. '
-            f'\nFor more details see https://docs.pydantic.dev/usage/schema/#unenforced-field-constraints'
-        )
-
-    return annotation
-
-
-def get_annotation_with_constraints(annotation: Any, field_info: FieldInfo) -> Tuple[Type[Any], Set[str]]:  # noqa: C901
-    """
-    Get an annotation with used constraints implemented for numbers and strings based on the field_info.
-
-    :param annotation: an annotation from a field specification, as ``str``, ``ConstrainedStr``
-    :param field_info: an instance of FieldInfo, possibly with declarations for validations and JSON Schema
-    :return: the same ``annotation`` if unmodified or a new annotation along with the used constraints.
-    """
-    used_constraints: Set[str] = set()
-
-    def go(type_: Any) -> Type[Any]:
-        if (
-            is_literal_type(type_)
-            or isinstance(type_, ForwardRef)
-            or lenient_issubclass(type_, (ConstrainedList, ConstrainedSet, ConstrainedFrozenSet))
-        ):
-            return type_
-        origin = get_origin(type_)
-        if origin is not None:
-            args: Tuple[Any, ...] = get_args(type_)
-            if any(isinstance(a, ForwardRef) for a in args):
-                # forward refs cause infinite recursion below
-                return type_
-
-            if origin is Annotated:
-                return go(args[0])
-            if is_union(origin):
-                return Union[tuple(go(a) for a in args)]  # type: ignore
-
-            if issubclass(origin, List) and (
-                field_info.min_items is not None
-                or field_info.max_items is not None
-                or field_info.unique_items is not None
-            ):
-                used_constraints.update({'min_items', 'max_items', 'unique_items'})
-                return conlist(
-                    go(args[0]),
-                    min_items=field_info.min_items,
-                    max_items=field_info.max_items,
-                    unique_items=field_info.unique_items,
-                )
-
-            if issubclass(origin, Set) and (field_info.min_items is not None or field_info.max_items is not None):
-                used_constraints.update({'min_items', 'max_items'})
-                return conset(go(args[0]), min_items=field_info.min_items, max_items=field_info.max_items)
-
-            if issubclass(origin, FrozenSet) and (field_info.min_items is not None or field_info.max_items is not None):
-                used_constraints.update({'min_items', 'max_items'})
-                return confrozenset(go(args[0]), min_items=field_info.min_items, max_items=field_info.max_items)
-
-            for t in (Tuple, List, Set, FrozenSet, Sequence):
-                if issubclass(origin, t):  # type: ignore
-                    return t[tuple(go(a) for a in args)]  # type: ignore
-
-            if issubclass(origin, Dict):
-                return Dict[args[0], go(args[1])]  # type: ignore
-
-        attrs: Optional[Tuple[str, ...]] = None
-        constraint_func: Optional[Callable[..., type]] = None
-        if isinstance(type_, type):
-            if issubclass(type_, (SecretStr, SecretBytes)):
-                attrs = ('max_length', 'min_length')
-
-                def constraint_func(**kw: Any) -> Type[Any]:
-                    return type(type_.__name__, (type_,), kw)
-
-            elif issubclass(type_, str) and not issubclass(type_, (EmailStr, AnyUrl)):
-                attrs = ('max_length', 'min_length', 'regex')
-                if issubclass(type_, StrictStr):
-
-                    def constraint_func(**kw: Any) -> Type[Any]:
-                        return type(type_.__name__, (type_,), kw)
-
-                else:
-                    constraint_func = constr
-            elif issubclass(type_, bytes):
-                attrs = ('max_length', 'min_length', 'regex')
-                if issubclass(type_, StrictBytes):
-
-                    def constraint_func(**kw: Any) -> Type[Any]:
-                        return type(type_.__name__, (type_,), kw)
-
-                else:
-                    constraint_func = conbytes
-            elif issubclass(type_, numeric_types) and not issubclass(
-                type_,
-                (
-                    ConstrainedInt,
-                    ConstrainedFloat,
-                    ConstrainedDecimal,
-                    ConstrainedList,
-                    ConstrainedSet,
-                    ConstrainedFrozenSet,
-                    bool,
-                ),
-            ):
-                # Is numeric type
-                attrs = ('gt', 'lt', 'ge', 'le', 'multiple_of')
-                if issubclass(type_, float):
-                    attrs += ('allow_inf_nan',)
-                if issubclass(type_, Decimal):
-                    attrs += ('max_digits', 'decimal_places')
-                numeric_type = next(t for t in numeric_types if issubclass(type_, t))  # pragma: no branch
-                constraint_func = _map_types_constraint[numeric_type]
-
-        if attrs:
-            used_constraints.update(set(attrs))
-            kwargs = {
-                attr_name: attr
-                for attr_name, attr in ((attr_name, getattr(field_info, attr_name)) for attr_name in attrs)
-                if attr is not None
-            }
-            if kwargs:
-                constraint_func = cast(Callable[..., type], constraint_func)
-                return constraint_func(**kwargs)
-        return type_
-
-    return go(annotation), used_constraints
-
-
-def normalize_name(name: str) -> str:
-    """
-    Normalizes the given name. This can be applied to either a model *or* enum.
-    """
-    return re.sub(r'[^a-zA-Z0-9.\-_]', '_', name)
-
-
-class SkipField(Exception):
-    """
-    Utility exception used to exclude fields from schema.
-    """
-
-    def __init__(self, message: str) -> None:
-        self.message = message
diff --git a/lib/pydantic/v1/tools.py b/lib/pydantic/v1/tools.py
deleted file mode 100644
index 45be2770..00000000
--- a/lib/pydantic/v1/tools.py
+++ /dev/null
@@ -1,92 +0,0 @@
-import json
-from functools import lru_cache
-from pathlib import Path
-from typing import TYPE_CHECKING, Any, Callable, Optional, Type, TypeVar, Union
-
-from .parse import Protocol, load_file, load_str_bytes
-from .types import StrBytes
-from .typing import display_as_type
-
-__all__ = ('parse_file_as', 'parse_obj_as', 'parse_raw_as', 'schema_of', 'schema_json_of')
-
-NameFactory = Union[str, Callable[[Type[Any]], str]]
-
-if TYPE_CHECKING:
-    from .typing import DictStrAny
-
-
-def _generate_parsing_type_name(type_: Any) -> str:
-    return f'ParsingModel[{display_as_type(type_)}]'
-
-
-@lru_cache(maxsize=2048)
-def _get_parsing_type(type_: Any, *, type_name: Optional[NameFactory] = None) -> Any:
-    from .main import create_model
-
-    if type_name is None:
-        type_name = _generate_parsing_type_name
-    if not isinstance(type_name, str):
-        type_name = type_name(type_)
-    return create_model(type_name, __root__=(type_, ...))
-
-
-T = TypeVar('T')
-
-
-def parse_obj_as(type_: Type[T], obj: Any, *, type_name: Optional[NameFactory] = None) -> T:
-    model_type = _get_parsing_type(type_, type_name=type_name)  # type: ignore[arg-type]
-    return model_type(__root__=obj).__root__
-
-
-def parse_file_as(
-    type_: Type[T],
-    path: Union[str, Path],
-    *,
-    content_type: str = None,
-    encoding: str = 'utf8',
-    proto: Protocol = None,
-    allow_pickle: bool = False,
-    json_loads: Callable[[str], Any] = json.loads,
-    type_name: Optional[NameFactory] = None,
-) -> T:
-    obj = load_file(
-        path,
-        proto=proto,
-        content_type=content_type,
-        encoding=encoding,
-        allow_pickle=allow_pickle,
-        json_loads=json_loads,
-    )
-    return parse_obj_as(type_, obj, type_name=type_name)
-
-
-def parse_raw_as(
-    type_: Type[T],
-    b: StrBytes,
-    *,
-    content_type: str = None,
-    encoding: str = 'utf8',
-    proto: Protocol = None,
-    allow_pickle: bool = False,
-    json_loads: Callable[[str], Any] = json.loads,
-    type_name: Optional[NameFactory] = None,
-) -> T:
-    obj = load_str_bytes(
-        b,
-        proto=proto,
-        content_type=content_type,
-        encoding=encoding,
-        allow_pickle=allow_pickle,
-        json_loads=json_loads,
-    )
-    return parse_obj_as(type_, obj, type_name=type_name)
-
-
-def schema_of(type_: Any, *, title: Optional[NameFactory] = None, **schema_kwargs: Any) -> 'DictStrAny':
-    """Generate a JSON schema (as dict) for the passed model or dynamically generated one"""
-    return _get_parsing_type(type_, type_name=title).schema(**schema_kwargs)
-
-
-def schema_json_of(type_: Any, *, title: Optional[NameFactory] = None, **schema_json_kwargs: Any) -> str:
-    """Generate a JSON schema (as JSON) for the passed model or dynamically generated one"""
-    return _get_parsing_type(type_, type_name=title).schema_json(**schema_json_kwargs)
diff --git a/lib/pydantic/v1/types.py b/lib/pydantic/v1/types.py
deleted file mode 100644
index 754e58ff..00000000
--- a/lib/pydantic/v1/types.py
+++ /dev/null
@@ -1,1205 +0,0 @@
-import abc
-import math
-import re
-import warnings
-from datetime import date
-from decimal import Decimal, InvalidOperation
-from enum import Enum
-from pathlib import Path
-from types import new_class
-from typing import (
-    TYPE_CHECKING,
-    Any,
-    Callable,
-    ClassVar,
-    Dict,
-    FrozenSet,
-    List,
-    Optional,
-    Pattern,
-    Set,
-    Tuple,
-    Type,
-    TypeVar,
-    Union,
-    cast,
-    overload,
-)
-from uuid import UUID
-from weakref import WeakSet
-
-from . import errors
-from .datetime_parse import parse_date
-from .utils import import_string, update_not_none
-from .validators import (
-    bytes_validator,
-    constr_length_validator,
-    constr_lower,
-    constr_strip_whitespace,
-    constr_upper,
-    decimal_validator,
-    float_finite_validator,
-    float_validator,
-    frozenset_validator,
-    int_validator,
-    list_validator,
-    number_multiple_validator,
-    number_size_validator,
-    path_exists_validator,
-    path_validator,
-    set_validator,
-    str_validator,
-    strict_bytes_validator,
-    strict_float_validator,
-    strict_int_validator,
-    strict_str_validator,
-)
-
-__all__ = [
-    'NoneStr',
-    'NoneBytes',
-    'StrBytes',
-    'NoneStrBytes',
-    'StrictStr',
-    'ConstrainedBytes',
-    'conbytes',
-    'ConstrainedList',
-    'conlist',
-    'ConstrainedSet',
-    'conset',
-    'ConstrainedFrozenSet',
-    'confrozenset',
-    'ConstrainedStr',
-    'constr',
-    'PyObject',
-    'ConstrainedInt',
-    'conint',
-    'PositiveInt',
-    'NegativeInt',
-    'NonNegativeInt',
-    'NonPositiveInt',
-    'ConstrainedFloat',
-    'confloat',
-    'PositiveFloat',
-    'NegativeFloat',
-    'NonNegativeFloat',
-    'NonPositiveFloat',
-    'FiniteFloat',
-    'ConstrainedDecimal',
-    'condecimal',
-    'UUID1',
-    'UUID3',
-    'UUID4',
-    'UUID5',
-    'FilePath',
-    'DirectoryPath',
-    'Json',
-    'JsonWrapper',
-    'SecretField',
-    'SecretStr',
-    'SecretBytes',
-    'StrictBool',
-    'StrictBytes',
-    'StrictInt',
-    'StrictFloat',
-    'PaymentCardNumber',
-    'ByteSize',
-    'PastDate',
-    'FutureDate',
-    'ConstrainedDate',
-    'condate',
-]
-
-NoneStr = Optional[str]
-NoneBytes = Optional[bytes]
-StrBytes = Union[str, bytes]
-NoneStrBytes = Optional[StrBytes]
-OptionalInt = Optional[int]
-OptionalIntFloat = Union[OptionalInt, float]
-OptionalIntFloatDecimal = Union[OptionalIntFloat, Decimal]
-OptionalDate = Optional[date]
-StrIntFloat = Union[str, int, float]
-
-if TYPE_CHECKING:
-    from typing_extensions import Annotated
-
-    from .dataclasses import Dataclass
-    from .main import BaseModel
-    from .typing import CallableGenerator
-
-    ModelOrDc = Type[Union[BaseModel, Dataclass]]
-
-T = TypeVar('T')
-_DEFINED_TYPES: 'WeakSet[type]' = WeakSet()
-
-
-@overload
-def _registered(typ: Type[T]) -> Type[T]:
-    pass
-
-
-@overload
-def _registered(typ: 'ConstrainedNumberMeta') -> 'ConstrainedNumberMeta':
-    pass
-
-
-def _registered(typ: Union[Type[T], 'ConstrainedNumberMeta']) -> Union[Type[T], 'ConstrainedNumberMeta']:
-    # In order to generate valid examples of constrained types, Hypothesis needs
-    # to inspect the type object - so we keep a weakref to each contype object
-    # until it can be registered.  When (or if) our Hypothesis plugin is loaded,
-    # it monkeypatches this function.
-    # If Hypothesis is never used, the total effect is to keep a weak reference
-    # which has minimal memory usage and doesn't even affect garbage collection.
-    _DEFINED_TYPES.add(typ)
-    return typ
-
-
-class ConstrainedNumberMeta(type):
-    def __new__(cls, name: str, bases: Any, dct: Dict[str, Any]) -> 'ConstrainedInt':  # type: ignore
-        new_cls = cast('ConstrainedInt', type.__new__(cls, name, bases, dct))
-
-        if new_cls.gt is not None and new_cls.ge is not None:
-            raise errors.ConfigError('bounds gt and ge cannot be specified at the same time')
-        if new_cls.lt is not None and new_cls.le is not None:
-            raise errors.ConfigError('bounds lt and le cannot be specified at the same time')
-
-        return _registered(new_cls)  # type: ignore
-
-
-# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ BOOLEAN TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-if TYPE_CHECKING:
-    StrictBool = bool
-else:
-
-    class StrictBool(int):
-        """
-        StrictBool to allow for bools which are not type-coerced.
-        """
-
-        @classmethod
-        def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-            field_schema.update(type='boolean')
-
-        @classmethod
-        def __get_validators__(cls) -> 'CallableGenerator':
-            yield cls.validate
-
-        @classmethod
-        def validate(cls, value: Any) -> bool:
-            """
-            Ensure that we only allow bools.
-            """
-            if isinstance(value, bool):
-                return value
-
-            raise errors.StrictBoolError()
-
-
-# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ INTEGER TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-
-class ConstrainedInt(int, metaclass=ConstrainedNumberMeta):
-    strict: bool = False
-    gt: OptionalInt = None
-    ge: OptionalInt = None
-    lt: OptionalInt = None
-    le: OptionalInt = None
-    multiple_of: OptionalInt = None
-
-    @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-        update_not_none(
-            field_schema,
-            exclusiveMinimum=cls.gt,
-            exclusiveMaximum=cls.lt,
-            minimum=cls.ge,
-            maximum=cls.le,
-            multipleOf=cls.multiple_of,
-        )
-
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield strict_int_validator if cls.strict else int_validator
-        yield number_size_validator
-        yield number_multiple_validator
-
-
-def conint(
-    *,
-    strict: bool = False,
-    gt: Optional[int] = None,
-    ge: Optional[int] = None,
-    lt: Optional[int] = None,
-    le: Optional[int] = None,
-    multiple_of: Optional[int] = None,
-) -> Type[int]:
-    # use kwargs then define conf in a dict to aid with IDE type hinting
-    namespace = dict(strict=strict, gt=gt, ge=ge, lt=lt, le=le, multiple_of=multiple_of)
-    return type('ConstrainedIntValue', (ConstrainedInt,), namespace)
-
-
-if TYPE_CHECKING:
-    PositiveInt = int
-    NegativeInt = int
-    NonPositiveInt = int
-    NonNegativeInt = int
-    StrictInt = int
-else:
-
-    class PositiveInt(ConstrainedInt):
-        gt = 0
-
-    class NegativeInt(ConstrainedInt):
-        lt = 0
-
-    class NonPositiveInt(ConstrainedInt):
-        le = 0
-
-    class NonNegativeInt(ConstrainedInt):
-        ge = 0
-
-    class StrictInt(ConstrainedInt):
-        strict = True
-
-
-# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ FLOAT TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-
-class ConstrainedFloat(float, metaclass=ConstrainedNumberMeta):
-    strict: bool = False
-    gt: OptionalIntFloat = None
-    ge: OptionalIntFloat = None
-    lt: OptionalIntFloat = None
-    le: OptionalIntFloat = None
-    multiple_of: OptionalIntFloat = None
-    allow_inf_nan: Optional[bool] = None
-
-    @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-        update_not_none(
-            field_schema,
-            exclusiveMinimum=cls.gt,
-            exclusiveMaximum=cls.lt,
-            minimum=cls.ge,
-            maximum=cls.le,
-            multipleOf=cls.multiple_of,
-        )
-        # Modify constraints to account for differences between IEEE floats and JSON
-        if field_schema.get('exclusiveMinimum') == -math.inf:
-            del field_schema['exclusiveMinimum']
-        if field_schema.get('minimum') == -math.inf:
-            del field_schema['minimum']
-        if field_schema.get('exclusiveMaximum') == math.inf:
-            del field_schema['exclusiveMaximum']
-        if field_schema.get('maximum') == math.inf:
-            del field_schema['maximum']
-
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield strict_float_validator if cls.strict else float_validator
-        yield number_size_validator
-        yield number_multiple_validator
-        yield float_finite_validator
-
-
-def confloat(
-    *,
-    strict: bool = False,
-    gt: float = None,
-    ge: float = None,
-    lt: float = None,
-    le: float = None,
-    multiple_of: float = None,
-    allow_inf_nan: Optional[bool] = None,
-) -> Type[float]:
-    # use kwargs then define conf in a dict to aid with IDE type hinting
-    namespace = dict(strict=strict, gt=gt, ge=ge, lt=lt, le=le, multiple_of=multiple_of, allow_inf_nan=allow_inf_nan)
-    return type('ConstrainedFloatValue', (ConstrainedFloat,), namespace)
-
-
-if TYPE_CHECKING:
-    PositiveFloat = float
-    NegativeFloat = float
-    NonPositiveFloat = float
-    NonNegativeFloat = float
-    StrictFloat = float
-    FiniteFloat = float
-else:
-
-    class PositiveFloat(ConstrainedFloat):
-        gt = 0
-
-    class NegativeFloat(ConstrainedFloat):
-        lt = 0
-
-    class NonPositiveFloat(ConstrainedFloat):
-        le = 0
-
-    class NonNegativeFloat(ConstrainedFloat):
-        ge = 0
-
-    class StrictFloat(ConstrainedFloat):
-        strict = True
-
-    class FiniteFloat(ConstrainedFloat):
-        allow_inf_nan = False
-
-
-# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ BYTES TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-
-class ConstrainedBytes(bytes):
-    strip_whitespace = False
-    to_upper = False
-    to_lower = False
-    min_length: OptionalInt = None
-    max_length: OptionalInt = None
-    strict: bool = False
-
-    @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-        update_not_none(field_schema, minLength=cls.min_length, maxLength=cls.max_length)
-
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield strict_bytes_validator if cls.strict else bytes_validator
-        yield constr_strip_whitespace
-        yield constr_upper
-        yield constr_lower
-        yield constr_length_validator
-
-
-def conbytes(
-    *,
-    strip_whitespace: bool = False,
-    to_upper: bool = False,
-    to_lower: bool = False,
-    min_length: Optional[int] = None,
-    max_length: Optional[int] = None,
-    strict: bool = False,
-) -> Type[bytes]:
-    # use kwargs then define conf in a dict to aid with IDE type hinting
-    namespace = dict(
-        strip_whitespace=strip_whitespace,
-        to_upper=to_upper,
-        to_lower=to_lower,
-        min_length=min_length,
-        max_length=max_length,
-        strict=strict,
-    )
-    return _registered(type('ConstrainedBytesValue', (ConstrainedBytes,), namespace))
-
-
-if TYPE_CHECKING:
-    StrictBytes = bytes
-else:
-
-    class StrictBytes(ConstrainedBytes):
-        strict = True
-
-
-# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ STRING TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-
-class ConstrainedStr(str):
-    strip_whitespace = False
-    to_upper = False
-    to_lower = False
-    min_length: OptionalInt = None
-    max_length: OptionalInt = None
-    curtail_length: OptionalInt = None
-    regex: Optional[Union[str, Pattern[str]]] = None
-    strict = False
-
-    @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-        update_not_none(
-            field_schema,
-            minLength=cls.min_length,
-            maxLength=cls.max_length,
-            pattern=cls.regex and cls._get_pattern(cls.regex),
-        )
-
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield strict_str_validator if cls.strict else str_validator
-        yield constr_strip_whitespace
-        yield constr_upper
-        yield constr_lower
-        yield constr_length_validator
-        yield cls.validate
-
-    @classmethod
-    def validate(cls, value: Union[str]) -> Union[str]:
-        if cls.curtail_length and len(value) > cls.curtail_length:
-            value = value[: cls.curtail_length]
-
-        if cls.regex:
-            if not re.match(cls.regex, value):
-                raise errors.StrRegexError(pattern=cls._get_pattern(cls.regex))
-
-        return value
-
-    @staticmethod
-    def _get_pattern(regex: Union[str, Pattern[str]]) -> str:
-        return regex if isinstance(regex, str) else regex.pattern
-
-
-def constr(
-    *,
-    strip_whitespace: bool = False,
-    to_upper: bool = False,
-    to_lower: bool = False,
-    strict: bool = False,
-    min_length: Optional[int] = None,
-    max_length: Optional[int] = None,
-    curtail_length: Optional[int] = None,
-    regex: Optional[str] = None,
-) -> Type[str]:
-    # use kwargs then define conf in a dict to aid with IDE type hinting
-    namespace = dict(
-        strip_whitespace=strip_whitespace,
-        to_upper=to_upper,
-        to_lower=to_lower,
-        strict=strict,
-        min_length=min_length,
-        max_length=max_length,
-        curtail_length=curtail_length,
-        regex=regex and re.compile(regex),
-    )
-    return _registered(type('ConstrainedStrValue', (ConstrainedStr,), namespace))
-
-
-if TYPE_CHECKING:
-    StrictStr = str
-else:
-
-    class StrictStr(ConstrainedStr):
-        strict = True
-
-
-# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ SET TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-
-# This types superclass should be Set[T], but cython chokes on that...
-class ConstrainedSet(set):  # type: ignore
-    # Needed for pydantic to detect that this is a set
-    __origin__ = set
-    __args__: Set[Type[T]]  # type: ignore
-
-    min_items: Optional[int] = None
-    max_items: Optional[int] = None
-    item_type: Type[T]  # type: ignore
-
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield cls.set_length_validator
-
-    @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-        update_not_none(field_schema, minItems=cls.min_items, maxItems=cls.max_items)
-
-    @classmethod
-    def set_length_validator(cls, v: 'Optional[Set[T]]') -> 'Optional[Set[T]]':
-        if v is None:
-            return None
-
-        v = set_validator(v)
-        v_len = len(v)
-
-        if cls.min_items is not None and v_len < cls.min_items:
-            raise errors.SetMinLengthError(limit_value=cls.min_items)
-
-        if cls.max_items is not None and v_len > cls.max_items:
-            raise errors.SetMaxLengthError(limit_value=cls.max_items)
-
-        return v
-
-
-def conset(item_type: Type[T], *, min_items: Optional[int] = None, max_items: Optional[int] = None) -> Type[Set[T]]:
-    # __args__ is needed to conform to typing generics api
-    namespace = {'min_items': min_items, 'max_items': max_items, 'item_type': item_type, '__args__': [item_type]}
-    # We use new_class to be able to deal with Generic types
-    return new_class('ConstrainedSetValue', (ConstrainedSet,), {}, lambda ns: ns.update(namespace))
-
-
-# This types superclass should be FrozenSet[T], but cython chokes on that...
-class ConstrainedFrozenSet(frozenset):  # type: ignore
-    # Needed for pydantic to detect that this is a set
-    __origin__ = frozenset
-    __args__: FrozenSet[Type[T]]  # type: ignore
-
-    min_items: Optional[int] = None
-    max_items: Optional[int] = None
-    item_type: Type[T]  # type: ignore
-
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield cls.frozenset_length_validator
-
-    @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-        update_not_none(field_schema, minItems=cls.min_items, maxItems=cls.max_items)
-
-    @classmethod
-    def frozenset_length_validator(cls, v: 'Optional[FrozenSet[T]]') -> 'Optional[FrozenSet[T]]':
-        if v is None:
-            return None
-
-        v = frozenset_validator(v)
-        v_len = len(v)
-
-        if cls.min_items is not None and v_len < cls.min_items:
-            raise errors.FrozenSetMinLengthError(limit_value=cls.min_items)
-
-        if cls.max_items is not None and v_len > cls.max_items:
-            raise errors.FrozenSetMaxLengthError(limit_value=cls.max_items)
-
-        return v
-
-
-def confrozenset(
-    item_type: Type[T], *, min_items: Optional[int] = None, max_items: Optional[int] = None
-) -> Type[FrozenSet[T]]:
-    # __args__ is needed to conform to typing generics api
-    namespace = {'min_items': min_items, 'max_items': max_items, 'item_type': item_type, '__args__': [item_type]}
-    # We use new_class to be able to deal with Generic types
-    return new_class('ConstrainedFrozenSetValue', (ConstrainedFrozenSet,), {}, lambda ns: ns.update(namespace))
-
-
-# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ LIST TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-
-# This types superclass should be List[T], but cython chokes on that...
-class ConstrainedList(list):  # type: ignore
-    # Needed for pydantic to detect that this is a list
-    __origin__ = list
-    __args__: Tuple[Type[T], ...]  # type: ignore
-
-    min_items: Optional[int] = None
-    max_items: Optional[int] = None
-    unique_items: Optional[bool] = None
-    item_type: Type[T]  # type: ignore
-
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield cls.list_length_validator
-        if cls.unique_items:
-            yield cls.unique_items_validator
-
-    @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-        update_not_none(field_schema, minItems=cls.min_items, maxItems=cls.max_items, uniqueItems=cls.unique_items)
-
-    @classmethod
-    def list_length_validator(cls, v: 'Optional[List[T]]') -> 'Optional[List[T]]':
-        if v is None:
-            return None
-
-        v = list_validator(v)
-        v_len = len(v)
-
-        if cls.min_items is not None and v_len < cls.min_items:
-            raise errors.ListMinLengthError(limit_value=cls.min_items)
-
-        if cls.max_items is not None and v_len > cls.max_items:
-            raise errors.ListMaxLengthError(limit_value=cls.max_items)
-
-        return v
-
-    @classmethod
-    def unique_items_validator(cls, v: 'Optional[List[T]]') -> 'Optional[List[T]]':
-        if v is None:
-            return None
-
-        for i, value in enumerate(v, start=1):
-            if value in v[i:]:
-                raise errors.ListUniqueItemsError()
-
-        return v
-
-
-def conlist(
-    item_type: Type[T], *, min_items: Optional[int] = None, max_items: Optional[int] = None, unique_items: bool = None
-) -> Type[List[T]]:
-    # __args__ is needed to conform to typing generics api
-    namespace = dict(
-        min_items=min_items, max_items=max_items, unique_items=unique_items, item_type=item_type, __args__=(item_type,)
-    )
-    # We use new_class to be able to deal with Generic types
-    return new_class('ConstrainedListValue', (ConstrainedList,), {}, lambda ns: ns.update(namespace))
-
-
-# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ PYOBJECT TYPE ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-
-if TYPE_CHECKING:
-    PyObject = Callable[..., Any]
-else:
-
-    class PyObject:
-        validate_always = True
-
-        @classmethod
-        def __get_validators__(cls) -> 'CallableGenerator':
-            yield cls.validate
-
-        @classmethod
-        def validate(cls, value: Any) -> Any:
-            if isinstance(value, Callable):
-                return value
-
-            try:
-                value = str_validator(value)
-            except errors.StrError:
-                raise errors.PyObjectError(error_message='value is neither a valid import path not a valid callable')
-
-            try:
-                return import_string(value)
-            except ImportError as e:
-                raise errors.PyObjectError(error_message=str(e))
-
-
-# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ DECIMAL TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-
-class ConstrainedDecimal(Decimal, metaclass=ConstrainedNumberMeta):
-    gt: OptionalIntFloatDecimal = None
-    ge: OptionalIntFloatDecimal = None
-    lt: OptionalIntFloatDecimal = None
-    le: OptionalIntFloatDecimal = None
-    max_digits: OptionalInt = None
-    decimal_places: OptionalInt = None
-    multiple_of: OptionalIntFloatDecimal = None
-
-    @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-        update_not_none(
-            field_schema,
-            exclusiveMinimum=cls.gt,
-            exclusiveMaximum=cls.lt,
-            minimum=cls.ge,
-            maximum=cls.le,
-            multipleOf=cls.multiple_of,
-        )
-
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield decimal_validator
-        yield number_size_validator
-        yield number_multiple_validator
-        yield cls.validate
-
-    @classmethod
-    def validate(cls, value: Decimal) -> Decimal:
-        try:
-            normalized_value = value.normalize()
-        except InvalidOperation:
-            normalized_value = value
-        digit_tuple, exponent = normalized_value.as_tuple()[1:]
-        if exponent in {'F', 'n', 'N'}:
-            raise errors.DecimalIsNotFiniteError()
-
-        if exponent >= 0:
-            # A positive exponent adds that many trailing zeros.
-            digits = len(digit_tuple) + exponent
-            decimals = 0
-        else:
-            # If the absolute value of the negative exponent is larger than the
-            # number of digits, then it's the same as the number of digits,
-            # because it'll consume all of the digits in digit_tuple and then
-            # add abs(exponent) - len(digit_tuple) leading zeros after the
-            # decimal point.
-            if abs(exponent) > len(digit_tuple):
-                digits = decimals = abs(exponent)
-            else:
-                digits = len(digit_tuple)
-                decimals = abs(exponent)
-        whole_digits = digits - decimals
-
-        if cls.max_digits is not None and digits > cls.max_digits:
-            raise errors.DecimalMaxDigitsError(max_digits=cls.max_digits)
-
-        if cls.decimal_places is not None and decimals > cls.decimal_places:
-            raise errors.DecimalMaxPlacesError(decimal_places=cls.decimal_places)
-
-        if cls.max_digits is not None and cls.decimal_places is not None:
-            expected = cls.max_digits - cls.decimal_places
-            if whole_digits > expected:
-                raise errors.DecimalWholeDigitsError(whole_digits=expected)
-
-        return value
-
-
-def condecimal(
-    *,
-    gt: Decimal = None,
-    ge: Decimal = None,
-    lt: Decimal = None,
-    le: Decimal = None,
-    max_digits: Optional[int] = None,
-    decimal_places: Optional[int] = None,
-    multiple_of: Decimal = None,
-) -> Type[Decimal]:
-    # use kwargs then define conf in a dict to aid with IDE type hinting
-    namespace = dict(
-        gt=gt, ge=ge, lt=lt, le=le, max_digits=max_digits, decimal_places=decimal_places, multiple_of=multiple_of
-    )
-    return type('ConstrainedDecimalValue', (ConstrainedDecimal,), namespace)
-
-
-# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ UUID TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-if TYPE_CHECKING:
-    UUID1 = UUID
-    UUID3 = UUID
-    UUID4 = UUID
-    UUID5 = UUID
-else:
-
-    class UUID1(UUID):
-        _required_version = 1
-
-        @classmethod
-        def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-            field_schema.update(type='string', format=f'uuid{cls._required_version}')
-
-    class UUID3(UUID1):
-        _required_version = 3
-
-    class UUID4(UUID1):
-        _required_version = 4
-
-    class UUID5(UUID1):
-        _required_version = 5
-
-
-# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ PATH TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-if TYPE_CHECKING:
-    FilePath = Path
-    DirectoryPath = Path
-else:
-
-    class FilePath(Path):
-        @classmethod
-        def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-            field_schema.update(format='file-path')
-
-        @classmethod
-        def __get_validators__(cls) -> 'CallableGenerator':
-            yield path_validator
-            yield path_exists_validator
-            yield cls.validate
-
-        @classmethod
-        def validate(cls, value: Path) -> Path:
-            if not value.is_file():
-                raise errors.PathNotAFileError(path=value)
-
-            return value
-
-    class DirectoryPath(Path):
-        @classmethod
-        def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-            field_schema.update(format='directory-path')
-
-        @classmethod
-        def __get_validators__(cls) -> 'CallableGenerator':
-            yield path_validator
-            yield path_exists_validator
-            yield cls.validate
-
-        @classmethod
-        def validate(cls, value: Path) -> Path:
-            if not value.is_dir():
-                raise errors.PathNotADirectoryError(path=value)
-
-            return value
-
-
-# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ JSON TYPE ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-
-class JsonWrapper:
-    pass
-
-
-class JsonMeta(type):
-    def __getitem__(self, t: Type[Any]) -> Type[JsonWrapper]:
-        if t is Any:
-            return Json  # allow Json[Any] to replecate plain Json
-        return _registered(type('JsonWrapperValue', (JsonWrapper,), {'inner_type': t}))
-
-
-if TYPE_CHECKING:
-    Json = Annotated[T, ...]  # Json[list[str]] will be recognized by type checkers as list[str]
-
-else:
-
-    class Json(metaclass=JsonMeta):
-        @classmethod
-        def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-            field_schema.update(type='string', format='json-string')
-
-
-# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ SECRET TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-
-class SecretField(abc.ABC):
-    """
-    Note: this should be implemented as a generic like `SecretField(ABC, Generic[T])`,
-          the `__init__()` should be part of the abstract class and the
-          `get_secret_value()` method should use the generic `T` type.
-
-          However Cython doesn't support very well generics at the moment and
-          the generated code fails to be imported (see
-          https://github.com/cython/cython/issues/2753).
-    """
-
-    def __eq__(self, other: Any) -> bool:
-        return isinstance(other, self.__class__) and self.get_secret_value() == other.get_secret_value()
-
-    def __str__(self) -> str:
-        return '**********' if self.get_secret_value() else ''
-
-    def __hash__(self) -> int:
-        return hash(self.get_secret_value())
-
-    @abc.abstractmethod
-    def get_secret_value(self) -> Any:  # pragma: no cover
-        ...
-
-
-class SecretStr(SecretField):
-    min_length: OptionalInt = None
-    max_length: OptionalInt = None
-
-    @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-        update_not_none(
-            field_schema,
-            type='string',
-            writeOnly=True,
-            format='password',
-            minLength=cls.min_length,
-            maxLength=cls.max_length,
-        )
-
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield cls.validate
-        yield constr_length_validator
-
-    @classmethod
-    def validate(cls, value: Any) -> 'SecretStr':
-        if isinstance(value, cls):
-            return value
-        value = str_validator(value)
-        return cls(value)
-
-    def __init__(self, value: str):
-        self._secret_value = value
-
-    def __repr__(self) -> str:
-        return f"SecretStr('{self}')"
-
-    def __len__(self) -> int:
-        return len(self._secret_value)
-
-    def display(self) -> str:
-        warnings.warn('`secret_str.display()` is deprecated, use `str(secret_str)` instead', DeprecationWarning)
-        return str(self)
-
-    def get_secret_value(self) -> str:
-        return self._secret_value
-
-
-class SecretBytes(SecretField):
-    min_length: OptionalInt = None
-    max_length: OptionalInt = None
-
-    @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-        update_not_none(
-            field_schema,
-            type='string',
-            writeOnly=True,
-            format='password',
-            minLength=cls.min_length,
-            maxLength=cls.max_length,
-        )
-
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield cls.validate
-        yield constr_length_validator
-
-    @classmethod
-    def validate(cls, value: Any) -> 'SecretBytes':
-        if isinstance(value, cls):
-            return value
-        value = bytes_validator(value)
-        return cls(value)
-
-    def __init__(self, value: bytes):
-        self._secret_value = value
-
-    def __repr__(self) -> str:
-        return f"SecretBytes(b'{self}')"
-
-    def __len__(self) -> int:
-        return len(self._secret_value)
-
-    def display(self) -> str:
-        warnings.warn('`secret_bytes.display()` is deprecated, use `str(secret_bytes)` instead', DeprecationWarning)
-        return str(self)
-
-    def get_secret_value(self) -> bytes:
-        return self._secret_value
-
-
-# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ PAYMENT CARD TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-
-class PaymentCardBrand(str, Enum):
-    # If you add another card type, please also add it to the
-    # Hypothesis strategy in `pydantic._hypothesis_plugin`.
-    amex = 'American Express'
-    mastercard = 'Mastercard'
-    visa = 'Visa'
-    other = 'other'
-
-    def __str__(self) -> str:
-        return self.value
-
-
-class PaymentCardNumber(str):
-    """
-    Based on: https://en.wikipedia.org/wiki/Payment_card_number
-    """
-
-    strip_whitespace: ClassVar[bool] = True
-    min_length: ClassVar[int] = 12
-    max_length: ClassVar[int] = 19
-    bin: str
-    last4: str
-    brand: PaymentCardBrand
-
-    def __init__(self, card_number: str):
-        self.bin = card_number[:6]
-        self.last4 = card_number[-4:]
-        self.brand = self._get_brand(card_number)
-
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield str_validator
-        yield constr_strip_whitespace
-        yield constr_length_validator
-        yield cls.validate_digits
-        yield cls.validate_luhn_check_digit
-        yield cls
-        yield cls.validate_length_for_brand
-
-    @property
-    def masked(self) -> str:
-        num_masked = len(self) - 10  # len(bin) + len(last4) == 10
-        return f'{self.bin}{"*" * num_masked}{self.last4}'
-
-    @classmethod
-    def validate_digits(cls, card_number: str) -> str:
-        if not card_number.isdigit():
-            raise errors.NotDigitError
-        return card_number
-
-    @classmethod
-    def validate_luhn_check_digit(cls, card_number: str) -> str:
-        """
-        Based on: https://en.wikipedia.org/wiki/Luhn_algorithm
-        """
-        sum_ = int(card_number[-1])
-        length = len(card_number)
-        parity = length % 2
-        for i in range(length - 1):
-            digit = int(card_number[i])
-            if i % 2 == parity:
-                digit *= 2
-            if digit > 9:
-                digit -= 9
-            sum_ += digit
-        valid = sum_ % 10 == 0
-        if not valid:
-            raise errors.LuhnValidationError
-        return card_number
-
-    @classmethod
-    def validate_length_for_brand(cls, card_number: 'PaymentCardNumber') -> 'PaymentCardNumber':
-        """
-        Validate length based on BIN for major brands:
-        https://en.wikipedia.org/wiki/Payment_card_number#Issuer_identification_number_(IIN)
-        """
-        required_length: Union[None, int, str] = None
-        if card_number.brand in PaymentCardBrand.mastercard:
-            required_length = 16
-            valid = len(card_number) == required_length
-        elif card_number.brand == PaymentCardBrand.visa:
-            required_length = '13, 16 or 19'
-            valid = len(card_number) in {13, 16, 19}
-        elif card_number.brand == PaymentCardBrand.amex:
-            required_length = 15
-            valid = len(card_number) == required_length
-        else:
-            valid = True
-        if not valid:
-            raise errors.InvalidLengthForBrand(brand=card_number.brand, required_length=required_length)
-        return card_number
-
-    @staticmethod
-    def _get_brand(card_number: str) -> PaymentCardBrand:
-        if card_number[0] == '4':
-            brand = PaymentCardBrand.visa
-        elif 51 <= int(card_number[:2]) <= 55:
-            brand = PaymentCardBrand.mastercard
-        elif card_number[:2] in {'34', '37'}:
-            brand = PaymentCardBrand.amex
-        else:
-            brand = PaymentCardBrand.other
-        return brand
-
-
-# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ BYTE SIZE TYPE ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-BYTE_SIZES = {
-    'b': 1,
-    'kb': 10**3,
-    'mb': 10**6,
-    'gb': 10**9,
-    'tb': 10**12,
-    'pb': 10**15,
-    'eb': 10**18,
-    'kib': 2**10,
-    'mib': 2**20,
-    'gib': 2**30,
-    'tib': 2**40,
-    'pib': 2**50,
-    'eib': 2**60,
-}
-BYTE_SIZES.update({k.lower()[0]: v for k, v in BYTE_SIZES.items() if 'i' not in k})
-byte_string_re = re.compile(r'^\s*(\d*\.?\d+)\s*(\w+)?', re.IGNORECASE)
-
-
-class ByteSize(int):
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield cls.validate
-
-    @classmethod
-    def validate(cls, v: StrIntFloat) -> 'ByteSize':
-        try:
-            return cls(int(v))
-        except ValueError:
-            pass
-
-        str_match = byte_string_re.match(str(v))
-        if str_match is None:
-            raise errors.InvalidByteSize()
-
-        scalar, unit = str_match.groups()
-        if unit is None:
-            unit = 'b'
-
-        try:
-            unit_mult = BYTE_SIZES[unit.lower()]
-        except KeyError:
-            raise errors.InvalidByteSizeUnit(unit=unit)
-
-        return cls(int(float(scalar) * unit_mult))
-
-    def human_readable(self, decimal: bool = False) -> str:
-        if decimal:
-            divisor = 1000
-            units = ['B', 'KB', 'MB', 'GB', 'TB', 'PB']
-            final_unit = 'EB'
-        else:
-            divisor = 1024
-            units = ['B', 'KiB', 'MiB', 'GiB', 'TiB', 'PiB']
-            final_unit = 'EiB'
-
-        num = float(self)
-        for unit in units:
-            if abs(num) < divisor:
-                return f'{num:0.1f}{unit}'
-            num /= divisor
-
-        return f'{num:0.1f}{final_unit}'
-
-    def to(self, unit: str) -> float:
-        try:
-            unit_div = BYTE_SIZES[unit.lower()]
-        except KeyError:
-            raise errors.InvalidByteSizeUnit(unit=unit)
-
-        return self / unit_div
-
-
-# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ DATE TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-if TYPE_CHECKING:
-    PastDate = date
-    FutureDate = date
-else:
-
-    class PastDate(date):
-        @classmethod
-        def __get_validators__(cls) -> 'CallableGenerator':
-            yield parse_date
-            yield cls.validate
-
-        @classmethod
-        def validate(cls, value: date) -> date:
-            if value >= date.today():
-                raise errors.DateNotInThePastError()
-
-            return value
-
-    class FutureDate(date):
-        @classmethod
-        def __get_validators__(cls) -> 'CallableGenerator':
-            yield parse_date
-            yield cls.validate
-
-        @classmethod
-        def validate(cls, value: date) -> date:
-            if value <= date.today():
-                raise errors.DateNotInTheFutureError()
-
-            return value
-
-
-class ConstrainedDate(date, metaclass=ConstrainedNumberMeta):
-    gt: OptionalDate = None
-    ge: OptionalDate = None
-    lt: OptionalDate = None
-    le: OptionalDate = None
-
-    @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-        update_not_none(field_schema, exclusiveMinimum=cls.gt, exclusiveMaximum=cls.lt, minimum=cls.ge, maximum=cls.le)
-
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield parse_date
-        yield number_size_validator
-
-
-def condate(
-    *,
-    gt: date = None,
-    ge: date = None,
-    lt: date = None,
-    le: date = None,
-) -> Type[date]:
-    # use kwargs then define conf in a dict to aid with IDE type hinting
-    namespace = dict(gt=gt, ge=ge, lt=lt, le=le)
-    return type('ConstrainedDateValue', (ConstrainedDate,), namespace)
diff --git a/lib/pydantic/v1/typing.py b/lib/pydantic/v1/typing.py
deleted file mode 100644
index a690a053..00000000
--- a/lib/pydantic/v1/typing.py
+++ /dev/null
@@ -1,603 +0,0 @@
-import sys
-import typing
-from collections.abc import Callable
-from os import PathLike
-from typing import (  # type: ignore
-    TYPE_CHECKING,
-    AbstractSet,
-    Any,
-    Callable as TypingCallable,
-    ClassVar,
-    Dict,
-    ForwardRef,
-    Generator,
-    Iterable,
-    List,
-    Mapping,
-    NewType,
-    Optional,
-    Sequence,
-    Set,
-    Tuple,
-    Type,
-    TypeVar,
-    Union,
-    _eval_type,
-    cast,
-    get_type_hints,
-)
-
-from typing_extensions import (
-    Annotated,
-    Final,
-    Literal,
-    NotRequired as TypedDictNotRequired,
-    Required as TypedDictRequired,
-)
-
-try:
-    from typing import _TypingBase as typing_base  # type: ignore
-except ImportError:
-    from typing import _Final as typing_base  # type: ignore
-
-try:
-    from typing import GenericAlias as TypingGenericAlias  # type: ignore
-except ImportError:
-    # python < 3.9 does not have GenericAlias (list[int], tuple[str, ...] and so on)
-    TypingGenericAlias = ()
-
-try:
-    from types import UnionType as TypesUnionType  # type: ignore
-except ImportError:
-    # python < 3.10 does not have UnionType (str | int, byte | bool and so on)
-    TypesUnionType = ()
-
-
-if sys.version_info < (3, 9):
-
-    def evaluate_forwardref(type_: ForwardRef, globalns: Any, localns: Any) -> Any:
-        return type_._evaluate(globalns, localns)
-
-else:
-
-    def evaluate_forwardref(type_: ForwardRef, globalns: Any, localns: Any) -> Any:
-        # Even though it is the right signature for python 3.9, mypy complains with
-        # `error: Too many arguments for "_evaluate" of "ForwardRef"` hence the cast...
-        return cast(Any, type_)._evaluate(globalns, localns, set())
-
-
-if sys.version_info < (3, 9):
-    # Ensure we always get all the whole `Annotated` hint, not just the annotated type.
-    # For 3.7 to 3.8, `get_type_hints` doesn't recognize `typing_extensions.Annotated`,
-    # so it already returns the full annotation
-    get_all_type_hints = get_type_hints
-
-else:
-
-    def get_all_type_hints(obj: Any, globalns: Any = None, localns: Any = None) -> Any:
-        return get_type_hints(obj, globalns, localns, include_extras=True)
-
-
-_T = TypeVar('_T')
-
-AnyCallable = TypingCallable[..., Any]
-NoArgAnyCallable = TypingCallable[[], Any]
-
-# workaround for https://github.com/python/mypy/issues/9496
-AnyArgTCallable = TypingCallable[..., _T]
-
-
-# Annotated[...] is implemented by returning an instance of one of these classes, depending on
-# python/typing_extensions version.
-AnnotatedTypeNames = {'AnnotatedMeta', '_AnnotatedAlias'}
-
-
-LITERAL_TYPES: Set[Any] = {Literal}
-if hasattr(typing, 'Literal'):
-    LITERAL_TYPES.add(typing.Literal)
-
-
-if sys.version_info < (3, 8):
-
-    def get_origin(t: Type[Any]) -> Optional[Type[Any]]:
-        if type(t).__name__ in AnnotatedTypeNames:
-            # weirdly this is a runtime requirement, as well as for mypy
-            return cast(Type[Any], Annotated)
-        return getattr(t, '__origin__', None)
-
-else:
-    from typing import get_origin as _typing_get_origin
-
-    def get_origin(tp: Type[Any]) -> Optional[Type[Any]]:
-        """
-        We can't directly use `typing.get_origin` since we need a fallback to support
-        custom generic classes like `ConstrainedList`
-        It should be useless once https://github.com/cython/cython/issues/3537 is
-        solved and https://github.com/pydantic/pydantic/pull/1753 is merged.
-        """
-        if type(tp).__name__ in AnnotatedTypeNames:
-            return cast(Type[Any], Annotated)  # mypy complains about _SpecialForm
-        return _typing_get_origin(tp) or getattr(tp, '__origin__', None)
-
-
-if sys.version_info < (3, 8):
-    from typing import _GenericAlias
-
-    def get_args(t: Type[Any]) -> Tuple[Any, ...]:
-        """Compatibility version of get_args for python 3.7.
-
-        Mostly compatible with the python 3.8 `typing` module version
-        and able to handle almost all use cases.
-        """
-        if type(t).__name__ in AnnotatedTypeNames:
-            return t.__args__ + t.__metadata__
-        if isinstance(t, _GenericAlias):
-            res = t.__args__
-            if t.__origin__ is Callable and res and res[0] is not Ellipsis:
-                res = (list(res[:-1]), res[-1])
-            return res
-        return getattr(t, '__args__', ())
-
-else:
-    from typing import get_args as _typing_get_args
-
-    def _generic_get_args(tp: Type[Any]) -> Tuple[Any, ...]:
-        """
-        In python 3.9, `typing.Dict`, `typing.List`, ...
-        do have an empty `__args__` by default (instead of the generic ~T for example).
-        In order to still support `Dict` for example and consider it as `Dict[Any, Any]`,
-        we retrieve the `_nparams` value that tells us how many parameters it needs.
-        """
-        if hasattr(tp, '_nparams'):
-            return (Any,) * tp._nparams
-        # Special case for `tuple[()]`, which used to return ((),) with `typing.Tuple`
-        # in python 3.10- but now returns () for `tuple` and `Tuple`.
-        # This will probably be clarified in pydantic v2
-        try:
-            if tp == Tuple[()] or sys.version_info >= (3, 9) and tp == tuple[()]:  # type: ignore[misc]
-                return ((),)
-        # there is a TypeError when compiled with cython
-        except TypeError:  # pragma: no cover
-            pass
-        return ()
-
-    def get_args(tp: Type[Any]) -> Tuple[Any, ...]:
-        """Get type arguments with all substitutions performed.
-
-        For unions, basic simplifications used by Union constructor are performed.
-        Examples::
-            get_args(Dict[str, int]) == (str, int)
-            get_args(int) == ()
-            get_args(Union[int, Union[T, int], str][int]) == (int, str)
-            get_args(Union[int, Tuple[T, int]][str]) == (int, Tuple[str, int])
-            get_args(Callable[[], T][int]) == ([], int)
-        """
-        if type(tp).__name__ in AnnotatedTypeNames:
-            return tp.__args__ + tp.__metadata__
-        # the fallback is needed for the same reasons as `get_origin` (see above)
-        return _typing_get_args(tp) or getattr(tp, '__args__', ()) or _generic_get_args(tp)
-
-
-if sys.version_info < (3, 9):
-
-    def convert_generics(tp: Type[Any]) -> Type[Any]:
-        """Python 3.9 and older only supports generics from `typing` module.
-        They convert strings to ForwardRef automatically.
-
-        Examples::
-            typing.List['Hero'] == typing.List[ForwardRef('Hero')]
-        """
-        return tp
-
-else:
-    from typing import _UnionGenericAlias  # type: ignore
-
-    from typing_extensions import _AnnotatedAlias
-
-    def convert_generics(tp: Type[Any]) -> Type[Any]:
-        """
-        Recursively searches for `str` type hints and replaces them with ForwardRef.
-
-        Examples::
-            convert_generics(list['Hero']) == list[ForwardRef('Hero')]
-            convert_generics(dict['Hero', 'Team']) == dict[ForwardRef('Hero'), ForwardRef('Team')]
-            convert_generics(typing.Dict['Hero', 'Team']) == typing.Dict[ForwardRef('Hero'), ForwardRef('Team')]
-            convert_generics(list[str | 'Hero'] | int) == list[str | ForwardRef('Hero')] | int
-        """
-        origin = get_origin(tp)
-        if not origin or not hasattr(tp, '__args__'):
-            return tp
-
-        args = get_args(tp)
-
-        # typing.Annotated needs special treatment
-        if origin is Annotated:
-            return _AnnotatedAlias(convert_generics(args[0]), args[1:])
-
-        # recursively replace `str` instances inside of `GenericAlias` with `ForwardRef(arg)`
-        converted = tuple(
-            ForwardRef(arg) if isinstance(arg, str) and isinstance(tp, TypingGenericAlias) else convert_generics(arg)
-            for arg in args
-        )
-
-        if converted == args:
-            return tp
-        elif isinstance(tp, TypingGenericAlias):
-            return TypingGenericAlias(origin, converted)
-        elif isinstance(tp, TypesUnionType):
-            # recreate types.UnionType (PEP604, Python >= 3.10)
-            return _UnionGenericAlias(origin, converted)
-        else:
-            try:
-                setattr(tp, '__args__', converted)
-            except AttributeError:
-                pass
-            return tp
-
-
-if sys.version_info < (3, 10):
-
-    def is_union(tp: Optional[Type[Any]]) -> bool:
-        return tp is Union
-
-    WithArgsTypes = (TypingGenericAlias,)
-
-else:
-    import types
-    import typing
-
-    def is_union(tp: Optional[Type[Any]]) -> bool:
-        return tp is Union or tp is types.UnionType  # noqa: E721
-
-    WithArgsTypes = (typing._GenericAlias, types.GenericAlias, types.UnionType)
-
-
-StrPath = Union[str, PathLike]
-
-
-if TYPE_CHECKING:
-    from .fields import ModelField
-
-    TupleGenerator = Generator[Tuple[str, Any], None, None]
-    DictStrAny = Dict[str, Any]
-    DictAny = Dict[Any, Any]
-    SetStr = Set[str]
-    ListStr = List[str]
-    IntStr = Union[int, str]
-    AbstractSetIntStr = AbstractSet[IntStr]
-    DictIntStrAny = Dict[IntStr, Any]
-    MappingIntStrAny = Mapping[IntStr, Any]
-    CallableGenerator = Generator[AnyCallable, None, None]
-    ReprArgs = Sequence[Tuple[Optional[str], Any]]
-
-    MYPY = False
-    if MYPY:
-        AnyClassMethod = classmethod[Any]
-    else:
-        # classmethod[TargetType, CallableParamSpecType, CallableReturnType]
-        AnyClassMethod = classmethod[Any, Any, Any]
-
-__all__ = (
-    'AnyCallable',
-    'NoArgAnyCallable',
-    'NoneType',
-    'is_none_type',
-    'display_as_type',
-    'resolve_annotations',
-    'is_callable_type',
-    'is_literal_type',
-    'all_literal_values',
-    'is_namedtuple',
-    'is_typeddict',
-    'is_typeddict_special',
-    'is_new_type',
-    'new_type_supertype',
-    'is_classvar',
-    'is_finalvar',
-    'update_field_forward_refs',
-    'update_model_forward_refs',
-    'TupleGenerator',
-    'DictStrAny',
-    'DictAny',
-    'SetStr',
-    'ListStr',
-    'IntStr',
-    'AbstractSetIntStr',
-    'DictIntStrAny',
-    'CallableGenerator',
-    'ReprArgs',
-    'AnyClassMethod',
-    'CallableGenerator',
-    'WithArgsTypes',
-    'get_args',
-    'get_origin',
-    'get_sub_types',
-    'typing_base',
-    'get_all_type_hints',
-    'is_union',
-    'StrPath',
-    'MappingIntStrAny',
-)
-
-
-NoneType = None.__class__
-
-
-NONE_TYPES: Tuple[Any, Any, Any] = (None, NoneType, Literal[None])
-
-
-if sys.version_info < (3, 8):
-    # Even though this implementation is slower, we need it for python 3.7:
-    # In python 3.7 "Literal" is not a builtin type and uses a different
-    # mechanism.
-    # for this reason `Literal[None] is Literal[None]` evaluates to `False`,
-    # breaking the faster implementation used for the other python versions.
-
-    def is_none_type(type_: Any) -> bool:
-        return type_ in NONE_TYPES
-
-elif sys.version_info[:2] == (3, 8):
-
-    def is_none_type(type_: Any) -> bool:
-        for none_type in NONE_TYPES:
-            if type_ is none_type:
-                return True
-        # With python 3.8, specifically 3.8.10, Literal "is" check sare very flakey
-        # can change on very subtle changes like use of types in other modules,
-        # hopefully this check avoids that issue.
-        if is_literal_type(type_):  # pragma: no cover
-            return all_literal_values(type_) == (None,)
-        return False
-
-else:
-
-    def is_none_type(type_: Any) -> bool:
-        return type_ in NONE_TYPES
-
-
-def display_as_type(v: Type[Any]) -> str:
-    if not isinstance(v, typing_base) and not isinstance(v, WithArgsTypes) and not isinstance(v, type):
-        v = v.__class__
-
-    if is_union(get_origin(v)):
-        return f'Union[{", ".join(map(display_as_type, get_args(v)))}]'
-
-    if isinstance(v, WithArgsTypes):
-        # Generic alias are constructs like `list[int]`
-        return str(v).replace('typing.', '')
-
-    try:
-        return v.__name__
-    except AttributeError:
-        # happens with typing objects
-        return str(v).replace('typing.', '')
-
-
-def resolve_annotations(raw_annotations: Dict[str, Type[Any]], module_name: Optional[str]) -> Dict[str, Type[Any]]:
-    """
-    Partially taken from typing.get_type_hints.
-
-    Resolve string or ForwardRef annotations into type objects if possible.
-    """
-    base_globals: Optional[Dict[str, Any]] = None
-    if module_name:
-        try:
-            module = sys.modules[module_name]
-        except KeyError:
-            # happens occasionally, see https://github.com/pydantic/pydantic/issues/2363
-            pass
-        else:
-            base_globals = module.__dict__
-
-    annotations = {}
-    for name, value in raw_annotations.items():
-        if isinstance(value, str):
-            if (3, 10) > sys.version_info >= (3, 9, 8) or sys.version_info >= (3, 10, 1):
-                value = ForwardRef(value, is_argument=False, is_class=True)
-            else:
-                value = ForwardRef(value, is_argument=False)
-        try:
-            value = _eval_type(value, base_globals, None)
-        except NameError:
-            # this is ok, it can be fixed with update_forward_refs
-            pass
-        annotations[name] = value
-    return annotations
-
-
-def is_callable_type(type_: Type[Any]) -> bool:
-    return type_ is Callable or get_origin(type_) is Callable
-
-
-def is_literal_type(type_: Type[Any]) -> bool:
-    return Literal is not None and get_origin(type_) in LITERAL_TYPES
-
-
-def literal_values(type_: Type[Any]) -> Tuple[Any, ...]:
-    return get_args(type_)
-
-
-def all_literal_values(type_: Type[Any]) -> Tuple[Any, ...]:
-    """
-    This method is used to retrieve all Literal values as
-    Literal can be used recursively (see https://www.python.org/dev/peps/pep-0586)
-    e.g. `Literal[Literal[Literal[1, 2, 3], "foo"], 5, None]`
-    """
-    if not is_literal_type(type_):
-        return (type_,)
-
-    values = literal_values(type_)
-    return tuple(x for value in values for x in all_literal_values(value))
-
-
-def is_namedtuple(type_: Type[Any]) -> bool:
-    """
-    Check if a given class is a named tuple.
-    It can be either a `typing.NamedTuple` or `collections.namedtuple`
-    """
-    from .utils import lenient_issubclass
-
-    return lenient_issubclass(type_, tuple) and hasattr(type_, '_fields')
-
-
-def is_typeddict(type_: Type[Any]) -> bool:
-    """
-    Check if a given class is a typed dict (from `typing` or `typing_extensions`)
-    In 3.10, there will be a public method (https://docs.python.org/3.10/library/typing.html#typing.is_typeddict)
-    """
-    from .utils import lenient_issubclass
-
-    return lenient_issubclass(type_, dict) and hasattr(type_, '__total__')
-
-
-def _check_typeddict_special(type_: Any) -> bool:
-    return type_ is TypedDictRequired or type_ is TypedDictNotRequired
-
-
-def is_typeddict_special(type_: Any) -> bool:
-    """
-    Check if type is a TypedDict special form (Required or NotRequired).
-    """
-    return _check_typeddict_special(type_) or _check_typeddict_special(get_origin(type_))
-
-
-test_type = NewType('test_type', str)
-
-
-def is_new_type(type_: Type[Any]) -> bool:
-    """
-    Check whether type_ was created using typing.NewType
-    """
-    return isinstance(type_, test_type.__class__) and hasattr(type_, '__supertype__')  # type: ignore
-
-
-def new_type_supertype(type_: Type[Any]) -> Type[Any]:
-    while hasattr(type_, '__supertype__'):
-        type_ = type_.__supertype__
-    return type_
-
-
-def _check_classvar(v: Optional[Type[Any]]) -> bool:
-    if v is None:
-        return False
-
-    return v.__class__ == ClassVar.__class__ and getattr(v, '_name', None) == 'ClassVar'
-
-
-def _check_finalvar(v: Optional[Type[Any]]) -> bool:
-    """
-    Check if a given type is a `typing.Final` type.
-    """
-    if v is None:
-        return False
-
-    return v.__class__ == Final.__class__ and (sys.version_info < (3, 8) or getattr(v, '_name', None) == 'Final')
-
-
-def is_classvar(ann_type: Type[Any]) -> bool:
-    if _check_classvar(ann_type) or _check_classvar(get_origin(ann_type)):
-        return True
-
-    # this is an ugly workaround for class vars that contain forward references and are therefore themselves
-    # forward references, see #3679
-    if ann_type.__class__ == ForwardRef and ann_type.__forward_arg__.startswith('ClassVar['):
-        return True
-
-    return False
-
-
-def is_finalvar(ann_type: Type[Any]) -> bool:
-    return _check_finalvar(ann_type) or _check_finalvar(get_origin(ann_type))
-
-
-def update_field_forward_refs(field: 'ModelField', globalns: Any, localns: Any) -> None:
-    """
-    Try to update ForwardRefs on fields based on this ModelField, globalns and localns.
-    """
-    prepare = False
-    if field.type_.__class__ == ForwardRef:
-        prepare = True
-        field.type_ = evaluate_forwardref(field.type_, globalns, localns or None)
-    if field.outer_type_.__class__ == ForwardRef:
-        prepare = True
-        field.outer_type_ = evaluate_forwardref(field.outer_type_, globalns, localns or None)
-    if prepare:
-        field.prepare()
-
-    if field.sub_fields:
-        for sub_f in field.sub_fields:
-            update_field_forward_refs(sub_f, globalns=globalns, localns=localns)
-
-    if field.discriminator_key is not None:
-        field.prepare_discriminated_union_sub_fields()
-
-
-def update_model_forward_refs(
-    model: Type[Any],
-    fields: Iterable['ModelField'],
-    json_encoders: Dict[Union[Type[Any], str, ForwardRef], AnyCallable],
-    localns: 'DictStrAny',
-    exc_to_suppress: Tuple[Type[BaseException], ...] = (),
-) -> None:
-    """
-    Try to update model fields ForwardRefs based on model and localns.
-    """
-    if model.__module__ in sys.modules:
-        globalns = sys.modules[model.__module__].__dict__.copy()
-    else:
-        globalns = {}
-
-    globalns.setdefault(model.__name__, model)
-
-    for f in fields:
-        try:
-            update_field_forward_refs(f, globalns=globalns, localns=localns)
-        except exc_to_suppress:
-            pass
-
-    for key in set(json_encoders.keys()):
-        if isinstance(key, str):
-            fr: ForwardRef = ForwardRef(key)
-        elif isinstance(key, ForwardRef):
-            fr = key
-        else:
-            continue
-
-        try:
-            new_key = evaluate_forwardref(fr, globalns, localns or None)
-        except exc_to_suppress:  # pragma: no cover
-            continue
-
-        json_encoders[new_key] = json_encoders.pop(key)
-
-
-def get_class(type_: Type[Any]) -> Union[None, bool, Type[Any]]:
-    """
-    Tries to get the class of a Type[T] annotation. Returns True if Type is used
-    without brackets. Otherwise returns None.
-    """
-    if type_ is type:
-        return True
-
-    if get_origin(type_) is None:
-        return None
-
-    args = get_args(type_)
-    if not args or not isinstance(args[0], type):
-        return True
-    else:
-        return args[0]
-
-
-def get_sub_types(tp: Any) -> List[Any]:
-    """
-    Return all the types that are allowed by type `tp`
-    `tp` can be a `Union` of allowed types or an `Annotated` type
-    """
-    origin = get_origin(tp)
-    if origin is Annotated:
-        return get_sub_types(get_args(tp)[0])
-    elif is_union(origin):
-        return [x for t in get_args(tp) for x in get_sub_types(t)]
-    else:
-        return [tp]
diff --git a/lib/pydantic/v1/utils.py b/lib/pydantic/v1/utils.py
deleted file mode 100644
index 4d0f68ed..00000000
--- a/lib/pydantic/v1/utils.py
+++ /dev/null
@@ -1,803 +0,0 @@
-import keyword
-import warnings
-import weakref
-from collections import OrderedDict, defaultdict, deque
-from copy import deepcopy
-from itertools import islice, zip_longest
-from types import BuiltinFunctionType, CodeType, FunctionType, GeneratorType, LambdaType, ModuleType
-from typing import (
-    TYPE_CHECKING,
-    AbstractSet,
-    Any,
-    Callable,
-    Collection,
-    Dict,
-    Generator,
-    Iterable,
-    Iterator,
-    List,
-    Mapping,
-    NoReturn,
-    Optional,
-    Set,
-    Tuple,
-    Type,
-    TypeVar,
-    Union,
-)
-
-from typing_extensions import Annotated
-
-from .errors import ConfigError
-from .typing import (
-    NoneType,
-    WithArgsTypes,
-    all_literal_values,
-    display_as_type,
-    get_args,
-    get_origin,
-    is_literal_type,
-    is_union,
-)
-from .version import version_info
-
-if TYPE_CHECKING:
-    from inspect import Signature
-    from pathlib import Path
-
-    from .config import BaseConfig
-    from .dataclasses import Dataclass
-    from .fields import ModelField
-    from .main import BaseModel
-    from .typing import AbstractSetIntStr, DictIntStrAny, IntStr, MappingIntStrAny, ReprArgs
-
-    RichReprResult = Iterable[Union[Any, Tuple[Any], Tuple[str, Any], Tuple[str, Any, Any]]]
-
-__all__ = (
-    'import_string',
-    'sequence_like',
-    'validate_field_name',
-    'lenient_isinstance',
-    'lenient_issubclass',
-    'in_ipython',
-    'is_valid_identifier',
-    'deep_update',
-    'update_not_none',
-    'almost_equal_floats',
-    'get_model',
-    'to_camel',
-    'is_valid_field',
-    'smart_deepcopy',
-    'PyObjectStr',
-    'Representation',
-    'GetterDict',
-    'ValueItems',
-    'version_info',  # required here to match behaviour in v1.3
-    'ClassAttribute',
-    'path_type',
-    'ROOT_KEY',
-    'get_unique_discriminator_alias',
-    'get_discriminator_alias_and_values',
-    'DUNDER_ATTRIBUTES',
-)
-
-ROOT_KEY = '__root__'
-# these are types that are returned unchanged by deepcopy
-IMMUTABLE_NON_COLLECTIONS_TYPES: Set[Type[Any]] = {
-    int,
-    float,
-    complex,
-    str,
-    bool,
-    bytes,
-    type,
-    NoneType,
-    FunctionType,
-    BuiltinFunctionType,
-    LambdaType,
-    weakref.ref,
-    CodeType,
-    # note: including ModuleType will differ from behaviour of deepcopy by not producing error.
-    # It might be not a good idea in general, but considering that this function used only internally
-    # against default values of fields, this will allow to actually have a field with module as default value
-    ModuleType,
-    NotImplemented.__class__,
-    Ellipsis.__class__,
-}
-
-# these are types that if empty, might be copied with simple copy() instead of deepcopy()
-BUILTIN_COLLECTIONS: Set[Type[Any]] = {
-    list,
-    set,
-    tuple,
-    frozenset,
-    dict,
-    OrderedDict,
-    defaultdict,
-    deque,
-}
-
-
-def import_string(dotted_path: str) -> Any:
-    """
-    Stolen approximately from django. Import a dotted module path and return the attribute/class designated by the
-    last name in the path. Raise ImportError if the import fails.
-    """
-    from importlib import import_module
-
-    try:
-        module_path, class_name = dotted_path.strip(' ').rsplit('.', 1)
-    except ValueError as e:
-        raise ImportError(f'"{dotted_path}" doesn\'t look like a module path') from e
-
-    module = import_module(module_path)
-    try:
-        return getattr(module, class_name)
-    except AttributeError as e:
-        raise ImportError(f'Module "{module_path}" does not define a "{class_name}" attribute') from e
-
-
-def truncate(v: Union[str], *, max_len: int = 80) -> str:
-    """
-    Truncate a value and add a unicode ellipsis (three dots) to the end if it was too long
-    """
-    warnings.warn('`truncate` is no-longer used by pydantic and is deprecated', DeprecationWarning)
-    if isinstance(v, str) and len(v) > (max_len - 2):
-        # -3 so quote + string + … + quote has correct length
-        return (v[: (max_len - 3)] + '…').__repr__()
-    try:
-        v = v.__repr__()
-    except TypeError:
-        v = v.__class__.__repr__(v)  # in case v is a type
-    if len(v) > max_len:
-        v = v[: max_len - 1] + '…'
-    return v
-
-
-def sequence_like(v: Any) -> bool:
-    return isinstance(v, (list, tuple, set, frozenset, GeneratorType, deque))
-
-
-def validate_field_name(bases: List[Type['BaseModel']], field_name: str) -> None:
-    """
-    Ensure that the field's name does not shadow an existing attribute of the model.
-    """
-    for base in bases:
-        if getattr(base, field_name, None):
-            raise NameError(
-                f'Field name "{field_name}" shadows a BaseModel attribute; '
-                f'use a different field name with "alias=\'{field_name}\'".'
-            )
-
-
-def lenient_isinstance(o: Any, class_or_tuple: Union[Type[Any], Tuple[Type[Any], ...], None]) -> bool:
-    try:
-        return isinstance(o, class_or_tuple)  # type: ignore[arg-type]
-    except TypeError:
-        return False
-
-
-def lenient_issubclass(cls: Any, class_or_tuple: Union[Type[Any], Tuple[Type[Any], ...], None]) -> bool:
-    try:
-        return isinstance(cls, type) and issubclass(cls, class_or_tuple)  # type: ignore[arg-type]
-    except TypeError:
-        if isinstance(cls, WithArgsTypes):
-            return False
-        raise  # pragma: no cover
-
-
-def in_ipython() -> bool:
-    """
-    Check whether we're in an ipython environment, including jupyter notebooks.
-    """
-    try:
-        eval('__IPYTHON__')
-    except NameError:
-        return False
-    else:  # pragma: no cover
-        return True
-
-
-def is_valid_identifier(identifier: str) -> bool:
-    """
-    Checks that a string is a valid identifier and not a Python keyword.
-    :param identifier: The identifier to test.
-    :return: True if the identifier is valid.
-    """
-    return identifier.isidentifier() and not keyword.iskeyword(identifier)
-
-
-KeyType = TypeVar('KeyType')
-
-
-def deep_update(mapping: Dict[KeyType, Any], *updating_mappings: Dict[KeyType, Any]) -> Dict[KeyType, Any]:
-    updated_mapping = mapping.copy()
-    for updating_mapping in updating_mappings:
-        for k, v in updating_mapping.items():
-            if k in updated_mapping and isinstance(updated_mapping[k], dict) and isinstance(v, dict):
-                updated_mapping[k] = deep_update(updated_mapping[k], v)
-            else:
-                updated_mapping[k] = v
-    return updated_mapping
-
-
-def update_not_none(mapping: Dict[Any, Any], **update: Any) -> None:
-    mapping.update({k: v for k, v in update.items() if v is not None})
-
-
-def almost_equal_floats(value_1: float, value_2: float, *, delta: float = 1e-8) -> bool:
-    """
-    Return True if two floats are almost equal
-    """
-    return abs(value_1 - value_2) <= delta
-
-
-def generate_model_signature(
-    init: Callable[..., None], fields: Dict[str, 'ModelField'], config: Type['BaseConfig']
-) -> 'Signature':
-    """
-    Generate signature for model based on its fields
-    """
-    from inspect import Parameter, Signature, signature
-
-    from .config import Extra
-
-    present_params = signature(init).parameters.values()
-    merged_params: Dict[str, Parameter] = {}
-    var_kw = None
-    use_var_kw = False
-
-    for param in islice(present_params, 1, None):  # skip self arg
-        if param.kind is param.VAR_KEYWORD:
-            var_kw = param
-            continue
-        merged_params[param.name] = param
-
-    if var_kw:  # if custom init has no var_kw, fields which are not declared in it cannot be passed through
-        allow_names = config.allow_population_by_field_name
-        for field_name, field in fields.items():
-            param_name = field.alias
-            if field_name in merged_params or param_name in merged_params:
-                continue
-            elif not is_valid_identifier(param_name):
-                if allow_names and is_valid_identifier(field_name):
-                    param_name = field_name
-                else:
-                    use_var_kw = True
-                    continue
-
-            # TODO: replace annotation with actual expected types once #1055 solved
-            kwargs = {'default': field.default} if not field.required else {}
-            merged_params[param_name] = Parameter(
-                param_name, Parameter.KEYWORD_ONLY, annotation=field.annotation, **kwargs
-            )
-
-    if config.extra is Extra.allow:
-        use_var_kw = True
-
-    if var_kw and use_var_kw:
-        # Make sure the parameter for extra kwargs
-        # does not have the same name as a field
-        default_model_signature = [
-            ('__pydantic_self__', Parameter.POSITIONAL_OR_KEYWORD),
-            ('data', Parameter.VAR_KEYWORD),
-        ]
-        if [(p.name, p.kind) for p in present_params] == default_model_signature:
-            # if this is the standard model signature, use extra_data as the extra args name
-            var_kw_name = 'extra_data'
-        else:
-            # else start from var_kw
-            var_kw_name = var_kw.name
-
-        # generate a name that's definitely unique
-        while var_kw_name in fields:
-            var_kw_name += '_'
-        merged_params[var_kw_name] = var_kw.replace(name=var_kw_name)
-
-    return Signature(parameters=list(merged_params.values()), return_annotation=None)
-
-
-def get_model(obj: Union[Type['BaseModel'], Type['Dataclass']]) -> Type['BaseModel']:
-    from .main import BaseModel
-
-    try:
-        model_cls = obj.__pydantic_model__  # type: ignore
-    except AttributeError:
-        model_cls = obj
-
-    if not issubclass(model_cls, BaseModel):
-        raise TypeError('Unsupported type, must be either BaseModel or dataclass')
-    return model_cls
-
-
-def to_camel(string: str) -> str:
-    return ''.join(word.capitalize() for word in string.split('_'))
-
-
-def to_lower_camel(string: str) -> str:
-    if len(string) >= 1:
-        pascal_string = to_camel(string)
-        return pascal_string[0].lower() + pascal_string[1:]
-    return string.lower()
-
-
-T = TypeVar('T')
-
-
-def unique_list(
-    input_list: Union[List[T], Tuple[T, ...]],
-    *,
-    name_factory: Callable[[T], str] = str,
-) -> List[T]:
-    """
-    Make a list unique while maintaining order.
-    We update the list if another one with the same name is set
-    (e.g. root validator overridden in subclass)
-    """
-    result: List[T] = []
-    result_names: List[str] = []
-    for v in input_list:
-        v_name = name_factory(v)
-        if v_name not in result_names:
-            result_names.append(v_name)
-            result.append(v)
-        else:
-            result[result_names.index(v_name)] = v
-
-    return result
-
-
-class PyObjectStr(str):
-    """
-    String class where repr doesn't include quotes. Useful with Representation when you want to return a string
-    representation of something that valid (or pseudo-valid) python.
-    """
-
-    def __repr__(self) -> str:
-        return str(self)
-
-
-class Representation:
-    """
-    Mixin to provide __str__, __repr__, and __pretty__ methods. See #884 for more details.
-
-    __pretty__ is used by [devtools](https://python-devtools.helpmanual.io/) to provide human readable representations
-    of objects.
-    """
-
-    __slots__: Tuple[str, ...] = tuple()
-
-    def __repr_args__(self) -> 'ReprArgs':
-        """
-        Returns the attributes to show in __str__, __repr__, and __pretty__ this is generally overridden.
-
-        Can either return:
-        * name - value pairs, e.g.: `[('foo_name', 'foo'), ('bar_name', ['b', 'a', 'r'])]`
-        * or, just values, e.g.: `[(None, 'foo'), (None, ['b', 'a', 'r'])]`
-        """
-        attrs = ((s, getattr(self, s)) for s in self.__slots__)
-        return [(a, v) for a, v in attrs if v is not None]
-
-    def __repr_name__(self) -> str:
-        """
-        Name of the instance's class, used in __repr__.
-        """
-        return self.__class__.__name__
-
-    def __repr_str__(self, join_str: str) -> str:
-        return join_str.join(repr(v) if a is None else f'{a}={v!r}' for a, v in self.__repr_args__())
-
-    def __pretty__(self, fmt: Callable[[Any], Any], **kwargs: Any) -> Generator[Any, None, None]:
-        """
-        Used by devtools (https://python-devtools.helpmanual.io/) to provide a human readable representations of objects
-        """
-        yield self.__repr_name__() + '('
-        yield 1
-        for name, value in self.__repr_args__():
-            if name is not None:
-                yield name + '='
-            yield fmt(value)
-            yield ','
-            yield 0
-        yield -1
-        yield ')'
-
-    def __str__(self) -> str:
-        return self.__repr_str__(' ')
-
-    def __repr__(self) -> str:
-        return f'{self.__repr_name__()}({self.__repr_str__(", ")})'
-
-    def __rich_repr__(self) -> 'RichReprResult':
-        """Get fields for Rich library"""
-        for name, field_repr in self.__repr_args__():
-            if name is None:
-                yield field_repr
-            else:
-                yield name, field_repr
-
-
-class GetterDict(Representation):
-    """
-    Hack to make object's smell just enough like dicts for validate_model.
-
-    We can't inherit from Mapping[str, Any] because it upsets cython so we have to implement all methods ourselves.
-    """
-
-    __slots__ = ('_obj',)
-
-    def __init__(self, obj: Any):
-        self._obj = obj
-
-    def __getitem__(self, key: str) -> Any:
-        try:
-            return getattr(self._obj, key)
-        except AttributeError as e:
-            raise KeyError(key) from e
-
-    def get(self, key: Any, default: Any = None) -> Any:
-        return getattr(self._obj, key, default)
-
-    def extra_keys(self) -> Set[Any]:
-        """
-        We don't want to get any other attributes of obj if the model didn't explicitly ask for them
-        """
-        return set()
-
-    def keys(self) -> List[Any]:
-        """
-        Keys of the pseudo dictionary, uses a list not set so order information can be maintained like python
-        dictionaries.
-        """
-        return list(self)
-
-    def values(self) -> List[Any]:
-        return [self[k] for k in self]
-
-    def items(self) -> Iterator[Tuple[str, Any]]:
-        for k in self:
-            yield k, self.get(k)
-
-    def __iter__(self) -> Iterator[str]:
-        for name in dir(self._obj):
-            if not name.startswith('_'):
-                yield name
-
-    def __len__(self) -> int:
-        return sum(1 for _ in self)
-
-    def __contains__(self, item: Any) -> bool:
-        return item in self.keys()
-
-    def __eq__(self, other: Any) -> bool:
-        return dict(self) == dict(other.items())
-
-    def __repr_args__(self) -> 'ReprArgs':
-        return [(None, dict(self))]
-
-    def __repr_name__(self) -> str:
-        return f'GetterDict[{display_as_type(self._obj)}]'
-
-
-class ValueItems(Representation):
-    """
-    Class for more convenient calculation of excluded or included fields on values.
-    """
-
-    __slots__ = ('_items', '_type')
-
-    def __init__(self, value: Any, items: Union['AbstractSetIntStr', 'MappingIntStrAny']) -> None:
-        items = self._coerce_items(items)
-
-        if isinstance(value, (list, tuple)):
-            items = self._normalize_indexes(items, len(value))
-
-        self._items: 'MappingIntStrAny' = items
-
-    def is_excluded(self, item: Any) -> bool:
-        """
-        Check if item is fully excluded.
-
-        :param item: key or index of a value
-        """
-        return self.is_true(self._items.get(item))
-
-    def is_included(self, item: Any) -> bool:
-        """
-        Check if value is contained in self._items
-
-        :param item: key or index of value
-        """
-        return item in self._items
-
-    def for_element(self, e: 'IntStr') -> Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']]:
-        """
-        :param e: key or index of element on value
-        :return: raw values for element if self._items is dict and contain needed element
-        """
-
-        item = self._items.get(e)
-        return item if not self.is_true(item) else None
-
-    def _normalize_indexes(self, items: 'MappingIntStrAny', v_length: int) -> 'DictIntStrAny':
-        """
-        :param items: dict or set of indexes which will be normalized
-        :param v_length: length of sequence indexes of which will be
-
-        >>> self._normalize_indexes({0: True, -2: True, -1: True}, 4)
-        {0: True, 2: True, 3: True}
-        >>> self._normalize_indexes({'__all__': True}, 4)
-        {0: True, 1: True, 2: True, 3: True}
-        """
-
-        normalized_items: 'DictIntStrAny' = {}
-        all_items = None
-        for i, v in items.items():
-            if not (isinstance(v, Mapping) or isinstance(v, AbstractSet) or self.is_true(v)):
-                raise TypeError(f'Unexpected type of exclude value for index "{i}" {v.__class__}')
-            if i == '__all__':
-                all_items = self._coerce_value(v)
-                continue
-            if not isinstance(i, int):
-                raise TypeError(
-                    'Excluding fields from a sequence of sub-models or dicts must be performed index-wise: '
-                    'expected integer keys or keyword "__all__"'
-                )
-            normalized_i = v_length + i if i < 0 else i
-            normalized_items[normalized_i] = self.merge(v, normalized_items.get(normalized_i))
-
-        if not all_items:
-            return normalized_items
-        if self.is_true(all_items):
-            for i in range(v_length):
-                normalized_items.setdefault(i, ...)
-            return normalized_items
-        for i in range(v_length):
-            normalized_item = normalized_items.setdefault(i, {})
-            if not self.is_true(normalized_item):
-                normalized_items[i] = self.merge(all_items, normalized_item)
-        return normalized_items
-
-    @classmethod
-    def merge(cls, base: Any, override: Any, intersect: bool = False) -> Any:
-        """
-        Merge a ``base`` item with an ``override`` item.
-
-        Both ``base`` and ``override`` are converted to dictionaries if possible.
-        Sets are converted to dictionaries with the sets entries as keys and
-        Ellipsis as values.
-
-        Each key-value pair existing in ``base`` is merged with ``override``,
-        while the rest of the key-value pairs are updated recursively with this function.
-
-        Merging takes place based on the "union" of keys if ``intersect`` is
-        set to ``False`` (default) and on the intersection of keys if
-        ``intersect`` is set to ``True``.
-        """
-        override = cls._coerce_value(override)
-        base = cls._coerce_value(base)
-        if override is None:
-            return base
-        if cls.is_true(base) or base is None:
-            return override
-        if cls.is_true(override):
-            return base if intersect else override
-
-        # intersection or union of keys while preserving ordering:
-        if intersect:
-            merge_keys = [k for k in base if k in override] + [k for k in override if k in base]
-        else:
-            merge_keys = list(base) + [k for k in override if k not in base]
-
-        merged: 'DictIntStrAny' = {}
-        for k in merge_keys:
-            merged_item = cls.merge(base.get(k), override.get(k), intersect=intersect)
-            if merged_item is not None:
-                merged[k] = merged_item
-
-        return merged
-
-    @staticmethod
-    def _coerce_items(items: Union['AbstractSetIntStr', 'MappingIntStrAny']) -> 'MappingIntStrAny':
-        if isinstance(items, Mapping):
-            pass
-        elif isinstance(items, AbstractSet):
-            items = dict.fromkeys(items, ...)
-        else:
-            class_name = getattr(items, '__class__', '???')
-            assert_never(
-                items,
-                f'Unexpected type of exclude value {class_name}',
-            )
-        return items
-
-    @classmethod
-    def _coerce_value(cls, value: Any) -> Any:
-        if value is None or cls.is_true(value):
-            return value
-        return cls._coerce_items(value)
-
-    @staticmethod
-    def is_true(v: Any) -> bool:
-        return v is True or v is ...
-
-    def __repr_args__(self) -> 'ReprArgs':
-        return [(None, self._items)]
-
-
-class ClassAttribute:
-    """
-    Hide class attribute from its instances
-    """
-
-    __slots__ = (
-        'name',
-        'value',
-    )
-
-    def __init__(self, name: str, value: Any) -> None:
-        self.name = name
-        self.value = value
-
-    def __get__(self, instance: Any, owner: Type[Any]) -> None:
-        if instance is None:
-            return self.value
-        raise AttributeError(f'{self.name!r} attribute of {owner.__name__!r} is class-only')
-
-
-path_types = {
-    'is_dir': 'directory',
-    'is_file': 'file',
-    'is_mount': 'mount point',
-    'is_symlink': 'symlink',
-    'is_block_device': 'block device',
-    'is_char_device': 'char device',
-    'is_fifo': 'FIFO',
-    'is_socket': 'socket',
-}
-
-
-def path_type(p: 'Path') -> str:
-    """
-    Find out what sort of thing a path is.
-    """
-    assert p.exists(), 'path does not exist'
-    for method, name in path_types.items():
-        if getattr(p, method)():
-            return name
-
-    return 'unknown'
-
-
-Obj = TypeVar('Obj')
-
-
-def smart_deepcopy(obj: Obj) -> Obj:
-    """
-    Return type as is for immutable built-in types
-    Use obj.copy() for built-in empty collections
-    Use copy.deepcopy() for non-empty collections and unknown objects
-    """
-
-    obj_type = obj.__class__
-    if obj_type in IMMUTABLE_NON_COLLECTIONS_TYPES:
-        return obj  # fastest case: obj is immutable and not collection therefore will not be copied anyway
-    try:
-        if not obj and obj_type in BUILTIN_COLLECTIONS:
-            # faster way for empty collections, no need to copy its members
-            return obj if obj_type is tuple else obj.copy()  # type: ignore  # tuple doesn't have copy method
-    except (TypeError, ValueError, RuntimeError):
-        # do we really dare to catch ALL errors? Seems a bit risky
-        pass
-
-    return deepcopy(obj)  # slowest way when we actually might need a deepcopy
-
-
-def is_valid_field(name: str) -> bool:
-    if not name.startswith('_'):
-        return True
-    return ROOT_KEY == name
-
-
-DUNDER_ATTRIBUTES = {
-    '__annotations__',
-    '__classcell__',
-    '__doc__',
-    '__module__',
-    '__orig_bases__',
-    '__orig_class__',
-    '__qualname__',
-}
-
-
-def is_valid_private_name(name: str) -> bool:
-    return not is_valid_field(name) and name not in DUNDER_ATTRIBUTES
-
-
-_EMPTY = object()
-
-
-def all_identical(left: Iterable[Any], right: Iterable[Any]) -> bool:
-    """
-    Check that the items of `left` are the same objects as those in `right`.
-
-    >>> a, b = object(), object()
-    >>> all_identical([a, b, a], [a, b, a])
-    True
-    >>> all_identical([a, b, [a]], [a, b, [a]])  # new list object, while "equal" is not "identical"
-    False
-    """
-    for left_item, right_item in zip_longest(left, right, fillvalue=_EMPTY):
-        if left_item is not right_item:
-            return False
-    return True
-
-
-def assert_never(obj: NoReturn, msg: str) -> NoReturn:
-    """
-    Helper to make sure that we have covered all possible types.
-
-    This is mostly useful for ``mypy``, docs:
-    https://mypy.readthedocs.io/en/latest/literal_types.html#exhaustive-checks
-    """
-    raise TypeError(msg)
-
-
-def get_unique_discriminator_alias(all_aliases: Collection[str], discriminator_key: str) -> str:
-    """Validate that all aliases are the same and if that's the case return the alias"""
-    unique_aliases = set(all_aliases)
-    if len(unique_aliases) > 1:
-        raise ConfigError(
-            f'Aliases for discriminator {discriminator_key!r} must be the same (got {", ".join(sorted(all_aliases))})'
-        )
-    return unique_aliases.pop()
-
-
-def get_discriminator_alias_and_values(tp: Any, discriminator_key: str) -> Tuple[str, Tuple[str, ...]]:
-    """
-    Get alias and all valid values in the `Literal` type of the discriminator field
-    `tp` can be a `BaseModel` class or directly an `Annotated` `Union` of many.
-    """
-    is_root_model = getattr(tp, '__custom_root_type__', False)
-
-    if get_origin(tp) is Annotated:
-        tp = get_args(tp)[0]
-
-    if hasattr(tp, '__pydantic_model__'):
-        tp = tp.__pydantic_model__
-
-    if is_union(get_origin(tp)):
-        alias, all_values = _get_union_alias_and_all_values(tp, discriminator_key)
-        return alias, tuple(v for values in all_values for v in values)
-    elif is_root_model:
-        union_type = tp.__fields__[ROOT_KEY].type_
-        alias, all_values = _get_union_alias_and_all_values(union_type, discriminator_key)
-
-        if len(set(all_values)) > 1:
-            raise ConfigError(
-                f'Field {discriminator_key!r} is not the same for all submodels of {display_as_type(tp)!r}'
-            )
-
-        return alias, all_values[0]
-
-    else:
-        try:
-            t_discriminator_type = tp.__fields__[discriminator_key].type_
-        except AttributeError as e:
-            raise TypeError(f'Type {tp.__name__!r} is not a valid `BaseModel` or `dataclass`') from e
-        except KeyError as e:
-            raise ConfigError(f'Model {tp.__name__!r} needs a discriminator field for key {discriminator_key!r}') from e
-
-        if not is_literal_type(t_discriminator_type):
-            raise ConfigError(f'Field {discriminator_key!r} of model {tp.__name__!r} needs to be a `Literal`')
-
-        return tp.__fields__[discriminator_key].alias, all_literal_values(t_discriminator_type)
-
-
-def _get_union_alias_and_all_values(
-    union_type: Type[Any], discriminator_key: str
-) -> Tuple[str, Tuple[Tuple[str, ...], ...]]:
-    zipped_aliases_values = [get_discriminator_alias_and_values(t, discriminator_key) for t in get_args(union_type)]
-    # unzip: [('alias_a',('v1', 'v2)), ('alias_b', ('v3',))] => [('alias_a', 'alias_b'), (('v1', 'v2'), ('v3',))]
-    all_aliases, all_values = zip(*zipped_aliases_values)
-    return get_unique_discriminator_alias(all_aliases, discriminator_key), all_values
diff --git a/lib/pydantic/v1/validators.py b/lib/pydantic/v1/validators.py
deleted file mode 100644
index 549a235e..00000000
--- a/lib/pydantic/v1/validators.py
+++ /dev/null
@@ -1,765 +0,0 @@
-import math
-import re
-from collections import OrderedDict, deque
-from collections.abc import Hashable as CollectionsHashable
-from datetime import date, datetime, time, timedelta
-from decimal import Decimal, DecimalException
-from enum import Enum, IntEnum
-from ipaddress import IPv4Address, IPv4Interface, IPv4Network, IPv6Address, IPv6Interface, IPv6Network
-from pathlib import Path
-from typing import (
-    TYPE_CHECKING,
-    Any,
-    Callable,
-    Deque,
-    Dict,
-    ForwardRef,
-    FrozenSet,
-    Generator,
-    Hashable,
-    List,
-    NamedTuple,
-    Pattern,
-    Set,
-    Tuple,
-    Type,
-    TypeVar,
-    Union,
-)
-from uuid import UUID
-
-from . import errors
-from .datetime_parse import parse_date, parse_datetime, parse_duration, parse_time
-from .typing import (
-    AnyCallable,
-    all_literal_values,
-    display_as_type,
-    get_class,
-    is_callable_type,
-    is_literal_type,
-    is_namedtuple,
-    is_none_type,
-    is_typeddict,
-)
-from .utils import almost_equal_floats, lenient_issubclass, sequence_like
-
-if TYPE_CHECKING:
-    from typing_extensions import Literal, TypedDict
-
-    from .config import BaseConfig
-    from .fields import ModelField
-    from .types import ConstrainedDecimal, ConstrainedFloat, ConstrainedInt
-
-    ConstrainedNumber = Union[ConstrainedDecimal, ConstrainedFloat, ConstrainedInt]
-    AnyOrderedDict = OrderedDict[Any, Any]
-    Number = Union[int, float, Decimal]
-    StrBytes = Union[str, bytes]
-
-
-def str_validator(v: Any) -> Union[str]:
-    if isinstance(v, str):
-        if isinstance(v, Enum):
-            return v.value
-        else:
-            return v
-    elif isinstance(v, (float, int, Decimal)):
-        # is there anything else we want to add here? If you think so, create an issue.
-        return str(v)
-    elif isinstance(v, (bytes, bytearray)):
-        return v.decode()
-    else:
-        raise errors.StrError()
-
-
-def strict_str_validator(v: Any) -> Union[str]:
-    if isinstance(v, str) and not isinstance(v, Enum):
-        return v
-    raise errors.StrError()
-
-
-def bytes_validator(v: Any) -> Union[bytes]:
-    if isinstance(v, bytes):
-        return v
-    elif isinstance(v, bytearray):
-        return bytes(v)
-    elif isinstance(v, str):
-        return v.encode()
-    elif isinstance(v, (float, int, Decimal)):
-        return str(v).encode()
-    else:
-        raise errors.BytesError()
-
-
-def strict_bytes_validator(v: Any) -> Union[bytes]:
-    if isinstance(v, bytes):
-        return v
-    elif isinstance(v, bytearray):
-        return bytes(v)
-    else:
-        raise errors.BytesError()
-
-
-BOOL_FALSE = {0, '0', 'off', 'f', 'false', 'n', 'no'}
-BOOL_TRUE = {1, '1', 'on', 't', 'true', 'y', 'yes'}
-
-
-def bool_validator(v: Any) -> bool:
-    if v is True or v is False:
-        return v
-    if isinstance(v, bytes):
-        v = v.decode()
-    if isinstance(v, str):
-        v = v.lower()
-    try:
-        if v in BOOL_TRUE:
-            return True
-        if v in BOOL_FALSE:
-            return False
-    except TypeError:
-        raise errors.BoolError()
-    raise errors.BoolError()
-
-
-# matches the default limit cpython, see https://github.com/python/cpython/pull/96500
-max_str_int = 4_300
-
-
-def int_validator(v: Any) -> int:
-    if isinstance(v, int) and not (v is True or v is False):
-        return v
-
-    # see https://github.com/pydantic/pydantic/issues/1477 and in turn, https://github.com/python/cpython/issues/95778
-    # this check should be unnecessary once patch releases are out for 3.7, 3.8, 3.9 and 3.10
-    # but better to check here until then.
-    # NOTICE: this does not fully protect user from the DOS risk since the standard library JSON implementation
-    # (and other std lib modules like xml) use `int()` and are likely called before this, the best workaround is to
-    # 1. update to the latest patch release of python once released, 2. use a different JSON library like ujson
-    if isinstance(v, (str, bytes, bytearray)) and len(v) > max_str_int:
-        raise errors.IntegerError()
-
-    try:
-        return int(v)
-    except (TypeError, ValueError, OverflowError):
-        raise errors.IntegerError()
-
-
-def strict_int_validator(v: Any) -> int:
-    if isinstance(v, int) and not (v is True or v is False):
-        return v
-    raise errors.IntegerError()
-
-
-def float_validator(v: Any) -> float:
-    if isinstance(v, float):
-        return v
-
-    try:
-        return float(v)
-    except (TypeError, ValueError):
-        raise errors.FloatError()
-
-
-def strict_float_validator(v: Any) -> float:
-    if isinstance(v, float):
-        return v
-    raise errors.FloatError()
-
-
-def float_finite_validator(v: 'Number', field: 'ModelField', config: 'BaseConfig') -> 'Number':
-    allow_inf_nan = getattr(field.type_, 'allow_inf_nan', None)
-    if allow_inf_nan is None:
-        allow_inf_nan = config.allow_inf_nan
-
-    if allow_inf_nan is False and (math.isnan(v) or math.isinf(v)):
-        raise errors.NumberNotFiniteError()
-    return v
-
-
-def number_multiple_validator(v: 'Number', field: 'ModelField') -> 'Number':
-    field_type: ConstrainedNumber = field.type_
-    if field_type.multiple_of is not None:
-        mod = float(v) / float(field_type.multiple_of) % 1
-        if not almost_equal_floats(mod, 0.0) and not almost_equal_floats(mod, 1.0):
-            raise errors.NumberNotMultipleError(multiple_of=field_type.multiple_of)
-    return v
-
-
-def number_size_validator(v: 'Number', field: 'ModelField') -> 'Number':
-    field_type: ConstrainedNumber = field.type_
-    if field_type.gt is not None and not v > field_type.gt:
-        raise errors.NumberNotGtError(limit_value=field_type.gt)
-    elif field_type.ge is not None and not v >= field_type.ge:
-        raise errors.NumberNotGeError(limit_value=field_type.ge)
-
-    if field_type.lt is not None and not v < field_type.lt:
-        raise errors.NumberNotLtError(limit_value=field_type.lt)
-    if field_type.le is not None and not v <= field_type.le:
-        raise errors.NumberNotLeError(limit_value=field_type.le)
-
-    return v
-
-
-def constant_validator(v: 'Any', field: 'ModelField') -> 'Any':
-    """Validate ``const`` fields.
-
-    The value provided for a ``const`` field must be equal to the default value
-    of the field. This is to support the keyword of the same name in JSON
-    Schema.
-    """
-    if v != field.default:
-        raise errors.WrongConstantError(given=v, permitted=[field.default])
-
-    return v
-
-
-def anystr_length_validator(v: 'StrBytes', config: 'BaseConfig') -> 'StrBytes':
-    v_len = len(v)
-
-    min_length = config.min_anystr_length
-    if v_len < min_length:
-        raise errors.AnyStrMinLengthError(limit_value=min_length)
-
-    max_length = config.max_anystr_length
-    if max_length is not None and v_len > max_length:
-        raise errors.AnyStrMaxLengthError(limit_value=max_length)
-
-    return v
-
-
-def anystr_strip_whitespace(v: 'StrBytes') -> 'StrBytes':
-    return v.strip()
-
-
-def anystr_upper(v: 'StrBytes') -> 'StrBytes':
-    return v.upper()
-
-
-def anystr_lower(v: 'StrBytes') -> 'StrBytes':
-    return v.lower()
-
-
-def ordered_dict_validator(v: Any) -> 'AnyOrderedDict':
-    if isinstance(v, OrderedDict):
-        return v
-
-    try:
-        return OrderedDict(v)
-    except (TypeError, ValueError):
-        raise errors.DictError()
-
-
-def dict_validator(v: Any) -> Dict[Any, Any]:
-    if isinstance(v, dict):
-        return v
-
-    try:
-        return dict(v)
-    except (TypeError, ValueError):
-        raise errors.DictError()
-
-
-def list_validator(v: Any) -> List[Any]:
-    if isinstance(v, list):
-        return v
-    elif sequence_like(v):
-        return list(v)
-    else:
-        raise errors.ListError()
-
-
-def tuple_validator(v: Any) -> Tuple[Any, ...]:
-    if isinstance(v, tuple):
-        return v
-    elif sequence_like(v):
-        return tuple(v)
-    else:
-        raise errors.TupleError()
-
-
-def set_validator(v: Any) -> Set[Any]:
-    if isinstance(v, set):
-        return v
-    elif sequence_like(v):
-        return set(v)
-    else:
-        raise errors.SetError()
-
-
-def frozenset_validator(v: Any) -> FrozenSet[Any]:
-    if isinstance(v, frozenset):
-        return v
-    elif sequence_like(v):
-        return frozenset(v)
-    else:
-        raise errors.FrozenSetError()
-
-
-def deque_validator(v: Any) -> Deque[Any]:
-    if isinstance(v, deque):
-        return v
-    elif sequence_like(v):
-        return deque(v)
-    else:
-        raise errors.DequeError()
-
-
-def enum_member_validator(v: Any, field: 'ModelField', config: 'BaseConfig') -> Enum:
-    try:
-        enum_v = field.type_(v)
-    except ValueError:
-        # field.type_ should be an enum, so will be iterable
-        raise errors.EnumMemberError(enum_values=list(field.type_))
-    return enum_v.value if config.use_enum_values else enum_v
-
-
-def uuid_validator(v: Any, field: 'ModelField') -> UUID:
-    try:
-        if isinstance(v, str):
-            v = UUID(v)
-        elif isinstance(v, (bytes, bytearray)):
-            try:
-                v = UUID(v.decode())
-            except ValueError:
-                # 16 bytes in big-endian order as the bytes argument fail
-                # the above check
-                v = UUID(bytes=v)
-    except ValueError:
-        raise errors.UUIDError()
-
-    if not isinstance(v, UUID):
-        raise errors.UUIDError()
-
-    required_version = getattr(field.type_, '_required_version', None)
-    if required_version and v.version != required_version:
-        raise errors.UUIDVersionError(required_version=required_version)
-
-    return v
-
-
-def decimal_validator(v: Any) -> Decimal:
-    if isinstance(v, Decimal):
-        return v
-    elif isinstance(v, (bytes, bytearray)):
-        v = v.decode()
-
-    v = str(v).strip()
-
-    try:
-        v = Decimal(v)
-    except DecimalException:
-        raise errors.DecimalError()
-
-    if not v.is_finite():
-        raise errors.DecimalIsNotFiniteError()
-
-    return v
-
-
-def hashable_validator(v: Any) -> Hashable:
-    if isinstance(v, Hashable):
-        return v
-
-    raise errors.HashableError()
-
-
-def ip_v4_address_validator(v: Any) -> IPv4Address:
-    if isinstance(v, IPv4Address):
-        return v
-
-    try:
-        return IPv4Address(v)
-    except ValueError:
-        raise errors.IPv4AddressError()
-
-
-def ip_v6_address_validator(v: Any) -> IPv6Address:
-    if isinstance(v, IPv6Address):
-        return v
-
-    try:
-        return IPv6Address(v)
-    except ValueError:
-        raise errors.IPv6AddressError()
-
-
-def ip_v4_network_validator(v: Any) -> IPv4Network:
-    """
-    Assume IPv4Network initialised with a default ``strict`` argument
-
-    See more:
-    https://docs.python.org/library/ipaddress.html#ipaddress.IPv4Network
-    """
-    if isinstance(v, IPv4Network):
-        return v
-
-    try:
-        return IPv4Network(v)
-    except ValueError:
-        raise errors.IPv4NetworkError()
-
-
-def ip_v6_network_validator(v: Any) -> IPv6Network:
-    """
-    Assume IPv6Network initialised with a default ``strict`` argument
-
-    See more:
-    https://docs.python.org/library/ipaddress.html#ipaddress.IPv6Network
-    """
-    if isinstance(v, IPv6Network):
-        return v
-
-    try:
-        return IPv6Network(v)
-    except ValueError:
-        raise errors.IPv6NetworkError()
-
-
-def ip_v4_interface_validator(v: Any) -> IPv4Interface:
-    if isinstance(v, IPv4Interface):
-        return v
-
-    try:
-        return IPv4Interface(v)
-    except ValueError:
-        raise errors.IPv4InterfaceError()
-
-
-def ip_v6_interface_validator(v: Any) -> IPv6Interface:
-    if isinstance(v, IPv6Interface):
-        return v
-
-    try:
-        return IPv6Interface(v)
-    except ValueError:
-        raise errors.IPv6InterfaceError()
-
-
-def path_validator(v: Any) -> Path:
-    if isinstance(v, Path):
-        return v
-
-    try:
-        return Path(v)
-    except TypeError:
-        raise errors.PathError()
-
-
-def path_exists_validator(v: Any) -> Path:
-    if not v.exists():
-        raise errors.PathNotExistsError(path=v)
-
-    return v
-
-
-def callable_validator(v: Any) -> AnyCallable:
-    """
-    Perform a simple check if the value is callable.
-
-    Note: complete matching of argument type hints and return types is not performed
-    """
-    if callable(v):
-        return v
-
-    raise errors.CallableError(value=v)
-
-
-def enum_validator(v: Any) -> Enum:
-    if isinstance(v, Enum):
-        return v
-
-    raise errors.EnumError(value=v)
-
-
-def int_enum_validator(v: Any) -> IntEnum:
-    if isinstance(v, IntEnum):
-        return v
-
-    raise errors.IntEnumError(value=v)
-
-
-def make_literal_validator(type_: Any) -> Callable[[Any], Any]:
-    permitted_choices = all_literal_values(type_)
-
-    # To have a O(1) complexity and still return one of the values set inside the `Literal`,
-    # we create a dict with the set values (a set causes some problems with the way intersection works).
-    # In some cases the set value and checked value can indeed be different (see `test_literal_validator_str_enum`)
-    allowed_choices = {v: v for v in permitted_choices}
-
-    def literal_validator(v: Any) -> Any:
-        try:
-            return allowed_choices[v]
-        except (KeyError, TypeError):
-            raise errors.WrongConstantError(given=v, permitted=permitted_choices)
-
-    return literal_validator
-
-
-def constr_length_validator(v: 'StrBytes', field: 'ModelField', config: 'BaseConfig') -> 'StrBytes':
-    v_len = len(v)
-
-    min_length = field.type_.min_length if field.type_.min_length is not None else config.min_anystr_length
-    if v_len < min_length:
-        raise errors.AnyStrMinLengthError(limit_value=min_length)
-
-    max_length = field.type_.max_length if field.type_.max_length is not None else config.max_anystr_length
-    if max_length is not None and v_len > max_length:
-        raise errors.AnyStrMaxLengthError(limit_value=max_length)
-
-    return v
-
-
-def constr_strip_whitespace(v: 'StrBytes', field: 'ModelField', config: 'BaseConfig') -> 'StrBytes':
-    strip_whitespace = field.type_.strip_whitespace or config.anystr_strip_whitespace
-    if strip_whitespace:
-        v = v.strip()
-
-    return v
-
-
-def constr_upper(v: 'StrBytes', field: 'ModelField', config: 'BaseConfig') -> 'StrBytes':
-    upper = field.type_.to_upper or config.anystr_upper
-    if upper:
-        v = v.upper()
-
-    return v
-
-
-def constr_lower(v: 'StrBytes', field: 'ModelField', config: 'BaseConfig') -> 'StrBytes':
-    lower = field.type_.to_lower or config.anystr_lower
-    if lower:
-        v = v.lower()
-    return v
-
-
-def validate_json(v: Any, config: 'BaseConfig') -> Any:
-    if v is None:
-        # pass None through to other validators
-        return v
-    try:
-        return config.json_loads(v)  # type: ignore
-    except ValueError:
-        raise errors.JsonError()
-    except TypeError:
-        raise errors.JsonTypeError()
-
-
-T = TypeVar('T')
-
-
-def make_arbitrary_type_validator(type_: Type[T]) -> Callable[[T], T]:
-    def arbitrary_type_validator(v: Any) -> T:
-        if isinstance(v, type_):
-            return v
-        raise errors.ArbitraryTypeError(expected_arbitrary_type=type_)
-
-    return arbitrary_type_validator
-
-
-def make_class_validator(type_: Type[T]) -> Callable[[Any], Type[T]]:
-    def class_validator(v: Any) -> Type[T]:
-        if lenient_issubclass(v, type_):
-            return v
-        raise errors.SubclassError(expected_class=type_)
-
-    return class_validator
-
-
-def any_class_validator(v: Any) -> Type[T]:
-    if isinstance(v, type):
-        return v
-    raise errors.ClassError()
-
-
-def none_validator(v: Any) -> 'Literal[None]':
-    if v is None:
-        return v
-    raise errors.NotNoneError()
-
-
-def pattern_validator(v: Any) -> Pattern[str]:
-    if isinstance(v, Pattern):
-        return v
-
-    str_value = str_validator(v)
-
-    try:
-        return re.compile(str_value)
-    except re.error:
-        raise errors.PatternError()
-
-
-NamedTupleT = TypeVar('NamedTupleT', bound=NamedTuple)
-
-
-def make_namedtuple_validator(
-    namedtuple_cls: Type[NamedTupleT], config: Type['BaseConfig']
-) -> Callable[[Tuple[Any, ...]], NamedTupleT]:
-    from .annotated_types import create_model_from_namedtuple
-
-    NamedTupleModel = create_model_from_namedtuple(
-        namedtuple_cls,
-        __config__=config,
-        __module__=namedtuple_cls.__module__,
-    )
-    namedtuple_cls.__pydantic_model__ = NamedTupleModel  # type: ignore[attr-defined]
-
-    def namedtuple_validator(values: Tuple[Any, ...]) -> NamedTupleT:
-        annotations = NamedTupleModel.__annotations__
-
-        if len(values) > len(annotations):
-            raise errors.ListMaxLengthError(limit_value=len(annotations))
-
-        dict_values: Dict[str, Any] = dict(zip(annotations, values))
-        validated_dict_values: Dict[str, Any] = dict(NamedTupleModel(**dict_values))
-        return namedtuple_cls(**validated_dict_values)
-
-    return namedtuple_validator
-
-
-def make_typeddict_validator(
-    typeddict_cls: Type['TypedDict'], config: Type['BaseConfig']  # type: ignore[valid-type]
-) -> Callable[[Any], Dict[str, Any]]:
-    from .annotated_types import create_model_from_typeddict
-
-    TypedDictModel = create_model_from_typeddict(
-        typeddict_cls,
-        __config__=config,
-        __module__=typeddict_cls.__module__,
-    )
-    typeddict_cls.__pydantic_model__ = TypedDictModel  # type: ignore[attr-defined]
-
-    def typeddict_validator(values: 'TypedDict') -> Dict[str, Any]:  # type: ignore[valid-type]
-        return TypedDictModel.parse_obj(values).dict(exclude_unset=True)
-
-    return typeddict_validator
-
-
-class IfConfig:
-    def __init__(self, validator: AnyCallable, *config_attr_names: str, ignored_value: Any = False) -> None:
-        self.validator = validator
-        self.config_attr_names = config_attr_names
-        self.ignored_value = ignored_value
-
-    def check(self, config: Type['BaseConfig']) -> bool:
-        return any(getattr(config, name) not in {None, self.ignored_value} for name in self.config_attr_names)
-
-
-# order is important here, for example: bool is a subclass of int so has to come first, datetime before date same,
-# IPv4Interface before IPv4Address, etc
-_VALIDATORS: List[Tuple[Type[Any], List[Any]]] = [
-    (IntEnum, [int_validator, enum_member_validator]),
-    (Enum, [enum_member_validator]),
-    (
-        str,
-        [
-            str_validator,
-            IfConfig(anystr_strip_whitespace, 'anystr_strip_whitespace'),
-            IfConfig(anystr_upper, 'anystr_upper'),
-            IfConfig(anystr_lower, 'anystr_lower'),
-            IfConfig(anystr_length_validator, 'min_anystr_length', 'max_anystr_length'),
-        ],
-    ),
-    (
-        bytes,
-        [
-            bytes_validator,
-            IfConfig(anystr_strip_whitespace, 'anystr_strip_whitespace'),
-            IfConfig(anystr_upper, 'anystr_upper'),
-            IfConfig(anystr_lower, 'anystr_lower'),
-            IfConfig(anystr_length_validator, 'min_anystr_length', 'max_anystr_length'),
-        ],
-    ),
-    (bool, [bool_validator]),
-    (int, [int_validator]),
-    (float, [float_validator, IfConfig(float_finite_validator, 'allow_inf_nan', ignored_value=True)]),
-    (Path, [path_validator]),
-    (datetime, [parse_datetime]),
-    (date, [parse_date]),
-    (time, [parse_time]),
-    (timedelta, [parse_duration]),
-    (OrderedDict, [ordered_dict_validator]),
-    (dict, [dict_validator]),
-    (list, [list_validator]),
-    (tuple, [tuple_validator]),
-    (set, [set_validator]),
-    (frozenset, [frozenset_validator]),
-    (deque, [deque_validator]),
-    (UUID, [uuid_validator]),
-    (Decimal, [decimal_validator]),
-    (IPv4Interface, [ip_v4_interface_validator]),
-    (IPv6Interface, [ip_v6_interface_validator]),
-    (IPv4Address, [ip_v4_address_validator]),
-    (IPv6Address, [ip_v6_address_validator]),
-    (IPv4Network, [ip_v4_network_validator]),
-    (IPv6Network, [ip_v6_network_validator]),
-]
-
-
-def find_validators(  # noqa: C901 (ignore complexity)
-    type_: Type[Any], config: Type['BaseConfig']
-) -> Generator[AnyCallable, None, None]:
-    from .dataclasses import is_builtin_dataclass, make_dataclass_validator
-
-    if type_ is Any or type_ is object:
-        return
-    type_type = type_.__class__
-    if type_type == ForwardRef or type_type == TypeVar:
-        return
-
-    if is_none_type(type_):
-        yield none_validator
-        return
-    if type_ is Pattern or type_ is re.Pattern:
-        yield pattern_validator
-        return
-    if type_ is Hashable or type_ is CollectionsHashable:
-        yield hashable_validator
-        return
-    if is_callable_type(type_):
-        yield callable_validator
-        return
-    if is_literal_type(type_):
-        yield make_literal_validator(type_)
-        return
-    if is_builtin_dataclass(type_):
-        yield from make_dataclass_validator(type_, config)
-        return
-    if type_ is Enum:
-        yield enum_validator
-        return
-    if type_ is IntEnum:
-        yield int_enum_validator
-        return
-    if is_namedtuple(type_):
-        yield tuple_validator
-        yield make_namedtuple_validator(type_, config)
-        return
-    if is_typeddict(type_):
-        yield make_typeddict_validator(type_, config)
-        return
-
-    class_ = get_class(type_)
-    if class_ is not None:
-        if class_ is not Any and isinstance(class_, type):
-            yield make_class_validator(class_)
-        else:
-            yield any_class_validator
-        return
-
-    for val_type, validators in _VALIDATORS:
-        try:
-            if issubclass(type_, val_type):
-                for v in validators:
-                    if isinstance(v, IfConfig):
-                        if v.check(config):
-                            yield v.validator
-                    else:
-                        yield v
-                return
-        except TypeError:
-            raise RuntimeError(f'error checking inheritance of {type_!r} (type: {display_as_type(type_)})')
-
-    if config.arbitrary_types_allowed:
-        yield make_arbitrary_type_validator(type_)
-    else:
-        raise RuntimeError(f'no validator found for {type_}, see `arbitrary_types_allowed` in Config')
diff --git a/lib/pydantic/v1/version.py b/lib/pydantic/v1/version.py
deleted file mode 100644
index ec982ba7..00000000
--- a/lib/pydantic/v1/version.py
+++ /dev/null
@@ -1,38 +0,0 @@
-__all__ = 'compiled', 'VERSION', 'version_info'
-
-VERSION = '1.10.14'
-
-try:
-    import cython  # type: ignore
-except ImportError:
-    compiled: bool = False
-else:  # pragma: no cover
-    try:
-        compiled = cython.compiled
-    except AttributeError:
-        compiled = False
-
-
-def version_info() -> str:
-    import platform
-    import sys
-    from importlib import import_module
-    from pathlib import Path
-
-    optional_deps = []
-    for p in ('devtools', 'dotenv', 'email-validator', 'typing-extensions'):
-        try:
-            import_module(p.replace('-', '_'))
-        except ImportError:
-            continue
-        optional_deps.append(p)
-
-    info = {
-        'pydantic version': VERSION,
-        'pydantic compiled': compiled,
-        'install path': Path(__file__).resolve().parent,
-        'python version': sys.version,
-        'platform': platform.platform(),
-        'optional deps. installed': optional_deps,
-    }
-    return '\n'.join('{:>30} {}'.format(k + ':', str(v).replace('\n', ' ')) for k, v in info.items())
diff --git a/lib/pydantic/validate_call_decorator.py b/lib/pydantic/validate_call_decorator.py
deleted file mode 100644
index b95fa3b6..00000000
--- a/lib/pydantic/validate_call_decorator.py
+++ /dev/null
@@ -1,67 +0,0 @@
-"""Decorator for validating function calls."""
-from __future__ import annotations as _annotations
-
-import functools
-from typing import TYPE_CHECKING, Any, Callable, TypeVar, overload
-
-from ._internal import _validate_call
-
-__all__ = ('validate_call',)
-
-if TYPE_CHECKING:
-    from .config import ConfigDict
-
-    AnyCallableT = TypeVar('AnyCallableT', bound=Callable[..., Any])
-
-
-@overload
-def validate_call(
-    *, config: ConfigDict | None = None, validate_return: bool = False
-) -> Callable[[AnyCallableT], AnyCallableT]:
-    ...
-
-
-@overload
-def validate_call(__func: AnyCallableT) -> AnyCallableT:
-    ...
-
-
-def validate_call(
-    __func: AnyCallableT | None = None,
-    *,
-    config: ConfigDict | None = None,
-    validate_return: bool = False,
-) -> AnyCallableT | Callable[[AnyCallableT], AnyCallableT]:
-    """Usage docs: https://docs.pydantic.dev/2.6/concepts/validation_decorator/
-
-    Returns a decorated wrapper around the function that validates the arguments and, optionally, the return value.
-
-    Usage may be either as a plain decorator `@validate_call` or with arguments `@validate_call(...)`.
-
-    Args:
-        __func: The function to be decorated.
-        config: The configuration dictionary.
-        validate_return: Whether to validate the return value.
-
-    Returns:
-        The decorated function.
-    """
-
-    def validate(function: AnyCallableT) -> AnyCallableT:
-        if isinstance(function, (classmethod, staticmethod)):
-            name = type(function).__name__
-            raise TypeError(f'The `@{name}` decorator should be applied after `@validate_call` (put `@{name}` on top)')
-        validate_call_wrapper = _validate_call.ValidateCallWrapper(function, config, validate_return)
-
-        @functools.wraps(function)
-        def wrapper_function(*args, **kwargs):
-            return validate_call_wrapper(*args, **kwargs)
-
-        wrapper_function.raw_function = function  # type: ignore
-
-        return wrapper_function  # type: ignore
-
-    if __func:
-        return validate(__func)
-    else:
-        return validate
diff --git a/lib/pydantic/validators.py b/lib/pydantic/validators.py
index 55b0339e..fb6d0418 100644
--- a/lib/pydantic/validators.py
+++ b/lib/pydantic/validators.py
@@ -1,4 +1,765 @@
-"""The `validators` module is a backport module from V1."""
-from ._migration import getattr_migration
+import math
+import re
+from collections import OrderedDict, deque
+from collections.abc import Hashable as CollectionsHashable
+from datetime import date, datetime, time, timedelta
+from decimal import Decimal, DecimalException
+from enum import Enum, IntEnum
+from ipaddress import IPv4Address, IPv4Interface, IPv4Network, IPv6Address, IPv6Interface, IPv6Network
+from pathlib import Path
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    Deque,
+    Dict,
+    ForwardRef,
+    FrozenSet,
+    Generator,
+    Hashable,
+    List,
+    NamedTuple,
+    Pattern,
+    Set,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+)
+from uuid import UUID
 
-__getattr__ = getattr_migration(__name__)
+from . import errors
+from .datetime_parse import parse_date, parse_datetime, parse_duration, parse_time
+from .typing import (
+    AnyCallable,
+    all_literal_values,
+    display_as_type,
+    get_class,
+    is_callable_type,
+    is_literal_type,
+    is_namedtuple,
+    is_none_type,
+    is_typeddict,
+)
+from .utils import almost_equal_floats, lenient_issubclass, sequence_like
+
+if TYPE_CHECKING:
+    from typing_extensions import Literal, TypedDict
+
+    from .config import BaseConfig
+    from .fields import ModelField
+    from .types import ConstrainedDecimal, ConstrainedFloat, ConstrainedInt
+
+    ConstrainedNumber = Union[ConstrainedDecimal, ConstrainedFloat, ConstrainedInt]
+    AnyOrderedDict = OrderedDict[Any, Any]
+    Number = Union[int, float, Decimal]
+    StrBytes = Union[str, bytes]
+
+
+def str_validator(v: Any) -> Union[str]:
+    if isinstance(v, str):
+        if isinstance(v, Enum):
+            return v.value
+        else:
+            return v
+    elif isinstance(v, (float, int, Decimal)):
+        # is there anything else we want to add here? If you think so, create an issue.
+        return str(v)
+    elif isinstance(v, (bytes, bytearray)):
+        return v.decode()
+    else:
+        raise errors.StrError()
+
+
+def strict_str_validator(v: Any) -> Union[str]:
+    if isinstance(v, str) and not isinstance(v, Enum):
+        return v
+    raise errors.StrError()
+
+
+def bytes_validator(v: Any) -> Union[bytes]:
+    if isinstance(v, bytes):
+        return v
+    elif isinstance(v, bytearray):
+        return bytes(v)
+    elif isinstance(v, str):
+        return v.encode()
+    elif isinstance(v, (float, int, Decimal)):
+        return str(v).encode()
+    else:
+        raise errors.BytesError()
+
+
+def strict_bytes_validator(v: Any) -> Union[bytes]:
+    if isinstance(v, bytes):
+        return v
+    elif isinstance(v, bytearray):
+        return bytes(v)
+    else:
+        raise errors.BytesError()
+
+
+BOOL_FALSE = {0, '0', 'off', 'f', 'false', 'n', 'no'}
+BOOL_TRUE = {1, '1', 'on', 't', 'true', 'y', 'yes'}
+
+
+def bool_validator(v: Any) -> bool:
+    if v is True or v is False:
+        return v
+    if isinstance(v, bytes):
+        v = v.decode()
+    if isinstance(v, str):
+        v = v.lower()
+    try:
+        if v in BOOL_TRUE:
+            return True
+        if v in BOOL_FALSE:
+            return False
+    except TypeError:
+        raise errors.BoolError()
+    raise errors.BoolError()
+
+
+# matches the default limit cpython, see https://github.com/python/cpython/pull/96500
+max_str_int = 4_300
+
+
+def int_validator(v: Any) -> int:
+    if isinstance(v, int) and not (v is True or v is False):
+        return v
+
+    # see https://github.com/pydantic/pydantic/issues/1477 and in turn, https://github.com/python/cpython/issues/95778
+    # this check should be unnecessary once patch releases are out for 3.7, 3.8, 3.9 and 3.10
+    # but better to check here until then.
+    # NOTICE: this does not fully protect user from the DOS risk since the standard library JSON implementation
+    # (and other std lib modules like xml) use `int()` and are likely called before this, the best workaround is to
+    # 1. update to the latest patch release of python once released, 2. use a different JSON library like ujson
+    if isinstance(v, (str, bytes, bytearray)) and len(v) > max_str_int:
+        raise errors.IntegerError()
+
+    try:
+        return int(v)
+    except (TypeError, ValueError, OverflowError):
+        raise errors.IntegerError()
+
+
+def strict_int_validator(v: Any) -> int:
+    if isinstance(v, int) and not (v is True or v is False):
+        return v
+    raise errors.IntegerError()
+
+
+def float_validator(v: Any) -> float:
+    if isinstance(v, float):
+        return v
+
+    try:
+        return float(v)
+    except (TypeError, ValueError):
+        raise errors.FloatError()
+
+
+def strict_float_validator(v: Any) -> float:
+    if isinstance(v, float):
+        return v
+    raise errors.FloatError()
+
+
+def float_finite_validator(v: 'Number', field: 'ModelField', config: 'BaseConfig') -> 'Number':
+    allow_inf_nan = getattr(field.type_, 'allow_inf_nan', None)
+    if allow_inf_nan is None:
+        allow_inf_nan = config.allow_inf_nan
+
+    if allow_inf_nan is False and (math.isnan(v) or math.isinf(v)):
+        raise errors.NumberNotFiniteError()
+    return v
+
+
+def number_multiple_validator(v: 'Number', field: 'ModelField') -> 'Number':
+    field_type: ConstrainedNumber = field.type_
+    if field_type.multiple_of is not None:
+        mod = float(v) / float(field_type.multiple_of) % 1
+        if not almost_equal_floats(mod, 0.0) and not almost_equal_floats(mod, 1.0):
+            raise errors.NumberNotMultipleError(multiple_of=field_type.multiple_of)
+    return v
+
+
+def number_size_validator(v: 'Number', field: 'ModelField') -> 'Number':
+    field_type: ConstrainedNumber = field.type_
+    if field_type.gt is not None and not v > field_type.gt:
+        raise errors.NumberNotGtError(limit_value=field_type.gt)
+    elif field_type.ge is not None and not v >= field_type.ge:
+        raise errors.NumberNotGeError(limit_value=field_type.ge)
+
+    if field_type.lt is not None and not v < field_type.lt:
+        raise errors.NumberNotLtError(limit_value=field_type.lt)
+    if field_type.le is not None and not v <= field_type.le:
+        raise errors.NumberNotLeError(limit_value=field_type.le)
+
+    return v
+
+
+def constant_validator(v: 'Any', field: 'ModelField') -> 'Any':
+    """Validate ``const`` fields.
+
+    The value provided for a ``const`` field must be equal to the default value
+    of the field. This is to support the keyword of the same name in JSON
+    Schema.
+    """
+    if v != field.default:
+        raise errors.WrongConstantError(given=v, permitted=[field.default])
+
+    return v
+
+
+def anystr_length_validator(v: 'StrBytes', config: 'BaseConfig') -> 'StrBytes':
+    v_len = len(v)
+
+    min_length = config.min_anystr_length
+    if v_len < min_length:
+        raise errors.AnyStrMinLengthError(limit_value=min_length)
+
+    max_length = config.max_anystr_length
+    if max_length is not None and v_len > max_length:
+        raise errors.AnyStrMaxLengthError(limit_value=max_length)
+
+    return v
+
+
+def anystr_strip_whitespace(v: 'StrBytes') -> 'StrBytes':
+    return v.strip()
+
+
+def anystr_upper(v: 'StrBytes') -> 'StrBytes':
+    return v.upper()
+
+
+def anystr_lower(v: 'StrBytes') -> 'StrBytes':
+    return v.lower()
+
+
+def ordered_dict_validator(v: Any) -> 'AnyOrderedDict':
+    if isinstance(v, OrderedDict):
+        return v
+
+    try:
+        return OrderedDict(v)
+    except (TypeError, ValueError):
+        raise errors.DictError()
+
+
+def dict_validator(v: Any) -> Dict[Any, Any]:
+    if isinstance(v, dict):
+        return v
+
+    try:
+        return dict(v)
+    except (TypeError, ValueError):
+        raise errors.DictError()
+
+
+def list_validator(v: Any) -> List[Any]:
+    if isinstance(v, list):
+        return v
+    elif sequence_like(v):
+        return list(v)
+    else:
+        raise errors.ListError()
+
+
+def tuple_validator(v: Any) -> Tuple[Any, ...]:
+    if isinstance(v, tuple):
+        return v
+    elif sequence_like(v):
+        return tuple(v)
+    else:
+        raise errors.TupleError()
+
+
+def set_validator(v: Any) -> Set[Any]:
+    if isinstance(v, set):
+        return v
+    elif sequence_like(v):
+        return set(v)
+    else:
+        raise errors.SetError()
+
+
+def frozenset_validator(v: Any) -> FrozenSet[Any]:
+    if isinstance(v, frozenset):
+        return v
+    elif sequence_like(v):
+        return frozenset(v)
+    else:
+        raise errors.FrozenSetError()
+
+
+def deque_validator(v: Any) -> Deque[Any]:
+    if isinstance(v, deque):
+        return v
+    elif sequence_like(v):
+        return deque(v)
+    else:
+        raise errors.DequeError()
+
+
+def enum_member_validator(v: Any, field: 'ModelField', config: 'BaseConfig') -> Enum:
+    try:
+        enum_v = field.type_(v)
+    except ValueError:
+        # field.type_ should be an enum, so will be iterable
+        raise errors.EnumMemberError(enum_values=list(field.type_))
+    return enum_v.value if config.use_enum_values else enum_v
+
+
+def uuid_validator(v: Any, field: 'ModelField') -> UUID:
+    try:
+        if isinstance(v, str):
+            v = UUID(v)
+        elif isinstance(v, (bytes, bytearray)):
+            try:
+                v = UUID(v.decode())
+            except ValueError:
+                # 16 bytes in big-endian order as the bytes argument fail
+                # the above check
+                v = UUID(bytes=v)
+    except ValueError:
+        raise errors.UUIDError()
+
+    if not isinstance(v, UUID):
+        raise errors.UUIDError()
+
+    required_version = getattr(field.type_, '_required_version', None)
+    if required_version and v.version != required_version:
+        raise errors.UUIDVersionError(required_version=required_version)
+
+    return v
+
+
+def decimal_validator(v: Any) -> Decimal:
+    if isinstance(v, Decimal):
+        return v
+    elif isinstance(v, (bytes, bytearray)):
+        v = v.decode()
+
+    v = str(v).strip()
+
+    try:
+        v = Decimal(v)
+    except DecimalException:
+        raise errors.DecimalError()
+
+    if not v.is_finite():
+        raise errors.DecimalIsNotFiniteError()
+
+    return v
+
+
+def hashable_validator(v: Any) -> Hashable:
+    if isinstance(v, Hashable):
+        return v
+
+    raise errors.HashableError()
+
+
+def ip_v4_address_validator(v: Any) -> IPv4Address:
+    if isinstance(v, IPv4Address):
+        return v
+
+    try:
+        return IPv4Address(v)
+    except ValueError:
+        raise errors.IPv4AddressError()
+
+
+def ip_v6_address_validator(v: Any) -> IPv6Address:
+    if isinstance(v, IPv6Address):
+        return v
+
+    try:
+        return IPv6Address(v)
+    except ValueError:
+        raise errors.IPv6AddressError()
+
+
+def ip_v4_network_validator(v: Any) -> IPv4Network:
+    """
+    Assume IPv4Network initialised with a default ``strict`` argument
+
+    See more:
+    https://docs.python.org/library/ipaddress.html#ipaddress.IPv4Network
+    """
+    if isinstance(v, IPv4Network):
+        return v
+
+    try:
+        return IPv4Network(v)
+    except ValueError:
+        raise errors.IPv4NetworkError()
+
+
+def ip_v6_network_validator(v: Any) -> IPv6Network:
+    """
+    Assume IPv6Network initialised with a default ``strict`` argument
+
+    See more:
+    https://docs.python.org/library/ipaddress.html#ipaddress.IPv6Network
+    """
+    if isinstance(v, IPv6Network):
+        return v
+
+    try:
+        return IPv6Network(v)
+    except ValueError:
+        raise errors.IPv6NetworkError()
+
+
+def ip_v4_interface_validator(v: Any) -> IPv4Interface:
+    if isinstance(v, IPv4Interface):
+        return v
+
+    try:
+        return IPv4Interface(v)
+    except ValueError:
+        raise errors.IPv4InterfaceError()
+
+
+def ip_v6_interface_validator(v: Any) -> IPv6Interface:
+    if isinstance(v, IPv6Interface):
+        return v
+
+    try:
+        return IPv6Interface(v)
+    except ValueError:
+        raise errors.IPv6InterfaceError()
+
+
+def path_validator(v: Any) -> Path:
+    if isinstance(v, Path):
+        return v
+
+    try:
+        return Path(v)
+    except TypeError:
+        raise errors.PathError()
+
+
+def path_exists_validator(v: Any) -> Path:
+    if not v.exists():
+        raise errors.PathNotExistsError(path=v)
+
+    return v
+
+
+def callable_validator(v: Any) -> AnyCallable:
+    """
+    Perform a simple check if the value is callable.
+
+    Note: complete matching of argument type hints and return types is not performed
+    """
+    if callable(v):
+        return v
+
+    raise errors.CallableError(value=v)
+
+
+def enum_validator(v: Any) -> Enum:
+    if isinstance(v, Enum):
+        return v
+
+    raise errors.EnumError(value=v)
+
+
+def int_enum_validator(v: Any) -> IntEnum:
+    if isinstance(v, IntEnum):
+        return v
+
+    raise errors.IntEnumError(value=v)
+
+
+def make_literal_validator(type_: Any) -> Callable[[Any], Any]:
+    permitted_choices = all_literal_values(type_)
+
+    # To have a O(1) complexity and still return one of the values set inside the `Literal`,
+    # we create a dict with the set values (a set causes some problems with the way intersection works).
+    # In some cases the set value and checked value can indeed be different (see `test_literal_validator_str_enum`)
+    allowed_choices = {v: v for v in permitted_choices}
+
+    def literal_validator(v: Any) -> Any:
+        try:
+            return allowed_choices[v]
+        except KeyError:
+            raise errors.WrongConstantError(given=v, permitted=permitted_choices)
+
+    return literal_validator
+
+
+def constr_length_validator(v: 'StrBytes', field: 'ModelField', config: 'BaseConfig') -> 'StrBytes':
+    v_len = len(v)
+
+    min_length = field.type_.min_length if field.type_.min_length is not None else config.min_anystr_length
+    if v_len < min_length:
+        raise errors.AnyStrMinLengthError(limit_value=min_length)
+
+    max_length = field.type_.max_length if field.type_.max_length is not None else config.max_anystr_length
+    if max_length is not None and v_len > max_length:
+        raise errors.AnyStrMaxLengthError(limit_value=max_length)
+
+    return v
+
+
+def constr_strip_whitespace(v: 'StrBytes', field: 'ModelField', config: 'BaseConfig') -> 'StrBytes':
+    strip_whitespace = field.type_.strip_whitespace or config.anystr_strip_whitespace
+    if strip_whitespace:
+        v = v.strip()
+
+    return v
+
+
+def constr_upper(v: 'StrBytes', field: 'ModelField', config: 'BaseConfig') -> 'StrBytes':
+    upper = field.type_.to_upper or config.anystr_upper
+    if upper:
+        v = v.upper()
+
+    return v
+
+
+def constr_lower(v: 'StrBytes', field: 'ModelField', config: 'BaseConfig') -> 'StrBytes':
+    lower = field.type_.to_lower or config.anystr_lower
+    if lower:
+        v = v.lower()
+    return v
+
+
+def validate_json(v: Any, config: 'BaseConfig') -> Any:
+    if v is None:
+        # pass None through to other validators
+        return v
+    try:
+        return config.json_loads(v)  # type: ignore
+    except ValueError:
+        raise errors.JsonError()
+    except TypeError:
+        raise errors.JsonTypeError()
+
+
+T = TypeVar('T')
+
+
+def make_arbitrary_type_validator(type_: Type[T]) -> Callable[[T], T]:
+    def arbitrary_type_validator(v: Any) -> T:
+        if isinstance(v, type_):
+            return v
+        raise errors.ArbitraryTypeError(expected_arbitrary_type=type_)
+
+    return arbitrary_type_validator
+
+
+def make_class_validator(type_: Type[T]) -> Callable[[Any], Type[T]]:
+    def class_validator(v: Any) -> Type[T]:
+        if lenient_issubclass(v, type_):
+            return v
+        raise errors.SubclassError(expected_class=type_)
+
+    return class_validator
+
+
+def any_class_validator(v: Any) -> Type[T]:
+    if isinstance(v, type):
+        return v
+    raise errors.ClassError()
+
+
+def none_validator(v: Any) -> 'Literal[None]':
+    if v is None:
+        return v
+    raise errors.NotNoneError()
+
+
+def pattern_validator(v: Any) -> Pattern[str]:
+    if isinstance(v, Pattern):
+        return v
+
+    str_value = str_validator(v)
+
+    try:
+        return re.compile(str_value)
+    except re.error:
+        raise errors.PatternError()
+
+
+NamedTupleT = TypeVar('NamedTupleT', bound=NamedTuple)
+
+
+def make_namedtuple_validator(
+    namedtuple_cls: Type[NamedTupleT], config: Type['BaseConfig']
+) -> Callable[[Tuple[Any, ...]], NamedTupleT]:
+    from .annotated_types import create_model_from_namedtuple
+
+    NamedTupleModel = create_model_from_namedtuple(
+        namedtuple_cls,
+        __config__=config,
+        __module__=namedtuple_cls.__module__,
+    )
+    namedtuple_cls.__pydantic_model__ = NamedTupleModel  # type: ignore[attr-defined]
+
+    def namedtuple_validator(values: Tuple[Any, ...]) -> NamedTupleT:
+        annotations = NamedTupleModel.__annotations__
+
+        if len(values) > len(annotations):
+            raise errors.ListMaxLengthError(limit_value=len(annotations))
+
+        dict_values: Dict[str, Any] = dict(zip(annotations, values))
+        validated_dict_values: Dict[str, Any] = dict(NamedTupleModel(**dict_values))
+        return namedtuple_cls(**validated_dict_values)
+
+    return namedtuple_validator
+
+
+def make_typeddict_validator(
+    typeddict_cls: Type['TypedDict'], config: Type['BaseConfig']  # type: ignore[valid-type]
+) -> Callable[[Any], Dict[str, Any]]:
+    from .annotated_types import create_model_from_typeddict
+
+    TypedDictModel = create_model_from_typeddict(
+        typeddict_cls,
+        __config__=config,
+        __module__=typeddict_cls.__module__,
+    )
+    typeddict_cls.__pydantic_model__ = TypedDictModel  # type: ignore[attr-defined]
+
+    def typeddict_validator(values: 'TypedDict') -> Dict[str, Any]:  # type: ignore[valid-type]
+        return TypedDictModel.parse_obj(values).dict(exclude_unset=True)
+
+    return typeddict_validator
+
+
+class IfConfig:
+    def __init__(self, validator: AnyCallable, *config_attr_names: str, ignored_value: Any = False) -> None:
+        self.validator = validator
+        self.config_attr_names = config_attr_names
+        self.ignored_value = ignored_value
+
+    def check(self, config: Type['BaseConfig']) -> bool:
+        return any(getattr(config, name) not in {None, self.ignored_value} for name in self.config_attr_names)
+
+
+# order is important here, for example: bool is a subclass of int so has to come first, datetime before date same,
+# IPv4Interface before IPv4Address, etc
+_VALIDATORS: List[Tuple[Type[Any], List[Any]]] = [
+    (IntEnum, [int_validator, enum_member_validator]),
+    (Enum, [enum_member_validator]),
+    (
+        str,
+        [
+            str_validator,
+            IfConfig(anystr_strip_whitespace, 'anystr_strip_whitespace'),
+            IfConfig(anystr_upper, 'anystr_upper'),
+            IfConfig(anystr_lower, 'anystr_lower'),
+            IfConfig(anystr_length_validator, 'min_anystr_length', 'max_anystr_length'),
+        ],
+    ),
+    (
+        bytes,
+        [
+            bytes_validator,
+            IfConfig(anystr_strip_whitespace, 'anystr_strip_whitespace'),
+            IfConfig(anystr_upper, 'anystr_upper'),
+            IfConfig(anystr_lower, 'anystr_lower'),
+            IfConfig(anystr_length_validator, 'min_anystr_length', 'max_anystr_length'),
+        ],
+    ),
+    (bool, [bool_validator]),
+    (int, [int_validator]),
+    (float, [float_validator, IfConfig(float_finite_validator, 'allow_inf_nan', ignored_value=True)]),
+    (Path, [path_validator]),
+    (datetime, [parse_datetime]),
+    (date, [parse_date]),
+    (time, [parse_time]),
+    (timedelta, [parse_duration]),
+    (OrderedDict, [ordered_dict_validator]),
+    (dict, [dict_validator]),
+    (list, [list_validator]),
+    (tuple, [tuple_validator]),
+    (set, [set_validator]),
+    (frozenset, [frozenset_validator]),
+    (deque, [deque_validator]),
+    (UUID, [uuid_validator]),
+    (Decimal, [decimal_validator]),
+    (IPv4Interface, [ip_v4_interface_validator]),
+    (IPv6Interface, [ip_v6_interface_validator]),
+    (IPv4Address, [ip_v4_address_validator]),
+    (IPv6Address, [ip_v6_address_validator]),
+    (IPv4Network, [ip_v4_network_validator]),
+    (IPv6Network, [ip_v6_network_validator]),
+]
+
+
+def find_validators(  # noqa: C901 (ignore complexity)
+    type_: Type[Any], config: Type['BaseConfig']
+) -> Generator[AnyCallable, None, None]:
+    from .dataclasses import is_builtin_dataclass, make_dataclass_validator
+
+    if type_ is Any or type_ is object:
+        return
+    type_type = type_.__class__
+    if type_type == ForwardRef or type_type == TypeVar:
+        return
+
+    if is_none_type(type_):
+        yield none_validator
+        return
+    if type_ is Pattern or type_ is re.Pattern:
+        yield pattern_validator
+        return
+    if type_ is Hashable or type_ is CollectionsHashable:
+        yield hashable_validator
+        return
+    if is_callable_type(type_):
+        yield callable_validator
+        return
+    if is_literal_type(type_):
+        yield make_literal_validator(type_)
+        return
+    if is_builtin_dataclass(type_):
+        yield from make_dataclass_validator(type_, config)
+        return
+    if type_ is Enum:
+        yield enum_validator
+        return
+    if type_ is IntEnum:
+        yield int_enum_validator
+        return
+    if is_namedtuple(type_):
+        yield tuple_validator
+        yield make_namedtuple_validator(type_, config)
+        return
+    if is_typeddict(type_):
+        yield make_typeddict_validator(type_, config)
+        return
+
+    class_ = get_class(type_)
+    if class_ is not None:
+        if class_ is not Any and isinstance(class_, type):
+            yield make_class_validator(class_)
+        else:
+            yield any_class_validator
+        return
+
+    for val_type, validators in _VALIDATORS:
+        try:
+            if issubclass(type_, val_type):
+                for v in validators:
+                    if isinstance(v, IfConfig):
+                        if v.check(config):
+                            yield v.validator
+                    else:
+                        yield v
+                return
+        except TypeError:
+            raise RuntimeError(f'error checking inheritance of {type_!r} (type: {display_as_type(type_)})')
+
+    if config.arbitrary_types_allowed:
+        yield make_arbitrary_type_validator(type_)
+    else:
+        raise RuntimeError(f'no validator found for {type_}, see `arbitrary_types_allowed` in Config')
diff --git a/lib/pydantic/version.py b/lib/pydantic/version.py
index 3e233771..32c61633 100644
--- a/lib/pydantic/version.py
+++ b/lib/pydantic/version.py
@@ -1,80 +1,38 @@
-"""The `version` module holds the version information for Pydantic."""
-from __future__ import annotations as _annotations
+__all__ = 'compiled', 'VERSION', 'version_info'
 
-__all__ = 'VERSION', 'version_info'
+VERSION = '1.10.2'
 
-VERSION = '2.6.4'
-"""The version of Pydantic."""
-
-
-def version_short() -> str:
-    """Return the `major.minor` part of Pydantic version.
-
-    It returns '2.1' if Pydantic version is '2.1.1'.
-    """
-    return '.'.join(VERSION.split('.')[:2])
+try:
+    import cython  # type: ignore
+except ImportError:
+    compiled: bool = False
+else:  # pragma: no cover
+    try:
+        compiled = cython.compiled
+    except AttributeError:
+        compiled = False
 
 
 def version_info() -> str:
-    """Return complete version information for Pydantic and its dependencies."""
-    import importlib.metadata as importlib_metadata
-    import os
     import platform
     import sys
+    from importlib import import_module
     from pathlib import Path
 
-    import pydantic_core._pydantic_core as pdc
-
-    from ._internal import _git as git
-
-    # get data about packages that are closely related to pydantic, use pydantic or often conflict with pydantic
-    package_names = {
-        'email-validator',
-        'fastapi',
-        'mypy',
-        'pydantic-extra-types',
-        'pydantic-settings',
-        'pyright',
-        'typing_extensions',
-    }
-    related_packages = []
-
-    for dist in importlib_metadata.distributions():
-        name = dist.metadata['Name']
-        if name in package_names:
-            related_packages.append(f'{name}-{dist.version}')
-
-    pydantic_dir = os.path.abspath(os.path.dirname(os.path.dirname(__file__)))
-    most_recent_commit = (
-        git.git_revision(pydantic_dir) if git.is_git_repo(pydantic_dir) and git.have_git() else 'unknown'
-    )
+    optional_deps = []
+    for p in ('devtools', 'dotenv', 'email-validator', 'typing-extensions'):
+        try:
+            import_module(p.replace('-', '_'))
+        except ImportError:
+            continue
+        optional_deps.append(p)
 
     info = {
         'pydantic version': VERSION,
-        'pydantic-core version': pdc.__version__,
-        'pydantic-core build': getattr(pdc, 'build_info', None) or pdc.build_profile,
+        'pydantic compiled': compiled,
         'install path': Path(__file__).resolve().parent,
         'python version': sys.version,
         'platform': platform.platform(),
-        'related packages': ' '.join(related_packages),
-        'commit': most_recent_commit,
+        'optional deps. installed': optional_deps,
     }
     return '\n'.join('{:>30} {}'.format(k + ':', str(v).replace('\n', ' ')) for k, v in info.items())
-
-
-def parse_mypy_version(version: str) -> tuple[int, ...]:
-    """Parse mypy string version to tuple of ints.
-
-    This function is included here rather than the mypy plugin file because the mypy plugin file cannot be imported
-    outside a mypy run.
-
-    It parses normal version like `0.930` and dev version
-    like `0.940+dev.04cac4b5d911c4f9529e6ce86a27b44f28846f5d.dirty`.
-
-    Args:
-        version: The mypy version string.
-
-    Returns:
-        A tuple of ints. e.g. (0, 930).
-    """
-    return tuple(map(int, version.partition('+')[0].split('.')))
diff --git a/lib/pydantic/warnings.py b/lib/pydantic/warnings.py
deleted file mode 100644
index aedd4fba..00000000
--- a/lib/pydantic/warnings.py
+++ /dev/null
@@ -1,58 +0,0 @@
-"""Pydantic-specific warnings."""
-from __future__ import annotations as _annotations
-
-from .version import version_short
-
-__all__ = 'PydanticDeprecatedSince20', 'PydanticDeprecationWarning'
-
-
-class PydanticDeprecationWarning(DeprecationWarning):
-    """A Pydantic specific deprecation warning.
-
-    This warning is raised when using deprecated functionality in Pydantic. It provides information on when the
-    deprecation was introduced and the expected version in which the corresponding functionality will be removed.
-
-    Attributes:
-        message: Description of the warning.
-        since: Pydantic version in what the deprecation was introduced.
-        expected_removal: Pydantic version in what the corresponding functionality expected to be removed.
-    """
-
-    message: str
-    since: tuple[int, int]
-    expected_removal: tuple[int, int]
-
-    def __init__(
-        self, message: str, *args: object, since: tuple[int, int], expected_removal: tuple[int, int] | None = None
-    ) -> None:
-        super().__init__(message, *args)
-        self.message = message.rstrip('.')
-        self.since = since
-        self.expected_removal = expected_removal if expected_removal is not None else (since[0] + 1, 0)
-
-    def __str__(self) -> str:
-        message = (
-            f'{self.message}. Deprecated in Pydantic V{self.since[0]}.{self.since[1]}'
-            f' to be removed in V{self.expected_removal[0]}.{self.expected_removal[1]}.'
-        )
-        if self.since == (2, 0):
-            message += f' See Pydantic V2 Migration Guide at https://errors.pydantic.dev/{version_short()}/migration/'
-        return message
-
-
-class PydanticDeprecatedSince20(PydanticDeprecationWarning):
-    """A specific `PydanticDeprecationWarning` subclass defining functionality deprecated since Pydantic 2.0."""
-
-    def __init__(self, message: str, *args: object) -> None:
-        super().__init__(message, *args, since=(2, 0), expected_removal=(3, 0))
-
-
-class PydanticDeprecatedSince26(PydanticDeprecationWarning):
-    """A specific `PydanticDeprecationWarning` subclass defining functionality deprecated since Pydantic 2.6."""
-
-    def __init__(self, message: str, *args: object) -> None:
-        super().__init__(message, *args, since=(2, 0), expected_removal=(3, 0))
-
-
-class GenericBeforeBaseModelWarning(Warning):
-    pass
diff --git a/lib/pydantic_core/__init__.py b/lib/pydantic_core/__init__.py
deleted file mode 100644
index 5b2655c9..00000000
--- a/lib/pydantic_core/__init__.py
+++ /dev/null
@@ -1,139 +0,0 @@
-from __future__ import annotations
-
-import sys as _sys
-from typing import Any as _Any
-
-from ._pydantic_core import (
-    ArgsKwargs,
-    MultiHostUrl,
-    PydanticCustomError,
-    PydanticKnownError,
-    PydanticOmit,
-    PydanticSerializationError,
-    PydanticSerializationUnexpectedValue,
-    PydanticUndefined,
-    PydanticUndefinedType,
-    PydanticUseDefault,
-    SchemaError,
-    SchemaSerializer,
-    SchemaValidator,
-    Some,
-    TzInfo,
-    Url,
-    ValidationError,
-    __version__,
-    from_json,
-    to_json,
-    to_jsonable_python,
-    validate_core_schema,
-)
-from .core_schema import CoreConfig, CoreSchema, CoreSchemaType, ErrorType
-
-if _sys.version_info < (3, 11):
-    from typing_extensions import NotRequired as _NotRequired
-else:
-    from typing import NotRequired as _NotRequired
-
-if _sys.version_info < (3, 9):
-    from typing_extensions import TypedDict as _TypedDict
-else:
-    from typing import TypedDict as _TypedDict
-
-__all__ = [
-    '__version__',
-    'CoreConfig',
-    'CoreSchema',
-    'CoreSchemaType',
-    'SchemaValidator',
-    'SchemaSerializer',
-    'Some',
-    'Url',
-    'MultiHostUrl',
-    'ArgsKwargs',
-    'PydanticUndefined',
-    'PydanticUndefinedType',
-    'SchemaError',
-    'ErrorDetails',
-    'InitErrorDetails',
-    'ValidationError',
-    'PydanticCustomError',
-    'PydanticKnownError',
-    'PydanticOmit',
-    'PydanticUseDefault',
-    'PydanticSerializationError',
-    'PydanticSerializationUnexpectedValue',
-    'TzInfo',
-    'to_json',
-    'from_json',
-    'to_jsonable_python',
-    'validate_core_schema',
-]
-
-
-class ErrorDetails(_TypedDict):
-    type: str
-    """
-    The type of error that occurred, this is an identifier designed for
-    programmatic use that will change rarely or never.
-
-    `type` is unique for each error message, and can hence be used as an identifier to build custom error messages.
-    """
-    loc: tuple[int | str, ...]
-    """Tuple of strings and ints identifying where in the schema the error occurred."""
-    msg: str
-    """A human readable error message."""
-    input: _Any
-    """The input data at this `loc` that caused the error."""
-    ctx: _NotRequired[dict[str, _Any]]
-    """
-    Values which are required to render the error message, and could hence be useful in rendering custom error messages.
-    Also useful for passing custom error data forward.
-    """
-
-
-class InitErrorDetails(_TypedDict):
-    type: str | PydanticCustomError
-    """The type of error that occurred, this should a "slug" identifier that changes rarely or never."""
-    loc: _NotRequired[tuple[int | str, ...]]
-    """Tuple of strings and ints identifying where in the schema the error occurred."""
-    input: _Any
-    """The input data at this `loc` that caused the error."""
-    ctx: _NotRequired[dict[str, _Any]]
-    """
-    Values which are required to render the error message, and could hence be useful in rendering custom error messages.
-    Also useful for passing custom error data forward.
-    """
-
-
-class ErrorTypeInfo(_TypedDict):
-    """
-    Gives information about errors.
-    """
-
-    type: ErrorType
-    """The type of error that occurred, this should a "slug" identifier that changes rarely or never."""
-    message_template_python: str
-    """String template to render a human readable error message from using context, when the input is Python."""
-    example_message_python: str
-    """Example of a human readable error message, when the input is Python."""
-    message_template_json: _NotRequired[str]
-    """String template to render a human readable error message from using context, when the input is JSON data."""
-    example_message_json: _NotRequired[str]
-    """Example of a human readable error message, when the input is JSON data."""
-    example_context: dict[str, _Any] | None
-    """Example of context values."""
-
-
-class MultiHostHost(_TypedDict):
-    """
-    A host part of a multi-host URL.
-    """
-
-    username: str | None
-    """The username part of this host, or `None`."""
-    password: str | None
-    """The password part of this host, or `None`."""
-    host: str | None
-    """The host part of this host, or `None`."""
-    port: int | None
-    """The port part of this host, or `None`."""
diff --git a/lib/pydantic_core/_pydantic_core.pyi b/lib/pydantic_core/_pydantic_core.pyi
deleted file mode 100644
index a7b727f8..00000000
--- a/lib/pydantic_core/_pydantic_core.pyi
+++ /dev/null
@@ -1,882 +0,0 @@
-from __future__ import annotations
-
-import datetime
-import sys
-from typing import Any, Callable, Generic, Optional, Type, TypeVar
-
-from pydantic_core import ErrorDetails, ErrorTypeInfo, InitErrorDetails, MultiHostHost
-from pydantic_core.core_schema import CoreConfig, CoreSchema, ErrorType
-
-if sys.version_info < (3, 8):
-    from typing_extensions import final
-else:
-    from typing import final
-
-if sys.version_info < (3, 11):
-    from typing_extensions import Literal, LiteralString, Self, TypeAlias
-else:
-    from typing import Literal, LiteralString, Self, TypeAlias
-
-from _typeshed import SupportsAllComparisons
-
-__all__ = [
-    '__version__',
-    'build_profile',
-    'build_info',
-    '_recursion_limit',
-    'ArgsKwargs',
-    'SchemaValidator',
-    'SchemaSerializer',
-    'Url',
-    'MultiHostUrl',
-    'SchemaError',
-    'ValidationError',
-    'PydanticCustomError',
-    'PydanticKnownError',
-    'PydanticOmit',
-    'PydanticUseDefault',
-    'PydanticSerializationError',
-    'PydanticSerializationUnexpectedValue',
-    'PydanticUndefined',
-    'PydanticUndefinedType',
-    'Some',
-    'to_json',
-    'from_json',
-    'to_jsonable_python',
-    'list_all_errors',
-    'TzInfo',
-    'validate_core_schema',
-]
-__version__: str
-build_profile: str
-build_info: str
-_recursion_limit: int
-
-_T = TypeVar('_T', default=Any, covariant=True)
-
-_StringInput: TypeAlias = 'dict[str, _StringInput]'
-
-@final
-class Some(Generic[_T]):
-    """
-    Similar to Rust's [`Option::Some`](https://doc.rust-lang.org/std/option/enum.Option.html) type, this
-    identifies a value as being present, and provides a way to access it.
-
-    Generally used in a union with `None` to different between "some value which could be None" and no value.
-    """
-
-    __match_args__ = ('value',)
-
-    @property
-    def value(self) -> _T:
-        """
-        Returns the value wrapped by `Some`.
-        """
-    @classmethod
-    def __class_getitem__(cls, __item: Any) -> Type[Self]: ...
-
-@final
-class SchemaValidator:
-    """
-    `SchemaValidator` is the Python wrapper for `pydantic-core`'s Rust validation logic, internally it owns one
-    `CombinedValidator` which may in turn own more `CombinedValidator`s which make up the full schema validator.
-    """
-
-    def __new__(cls, schema: CoreSchema, config: CoreConfig | None = None) -> Self:
-        """
-        Create a new SchemaValidator.
-
-        Arguments:
-            schema: The [`CoreSchema`][pydantic_core.core_schema.CoreSchema] to use for validation.
-            config: Optionally a [`CoreConfig`][pydantic_core.core_schema.CoreConfig] to configure validation.
-        """
-    @property
-    def title(self) -> str:
-        """
-        The title of the schema, as used in the heading of [`ValidationError.__str__()`][pydantic_core.ValidationError].
-        """
-    def validate_python(
-        self,
-        input: Any,
-        *,
-        strict: bool | None = None,
-        from_attributes: bool | None = None,
-        context: 'dict[str, Any] | None' = None,
-        self_instance: Any | None = None,
-    ) -> Any:
-        """
-        Validate a Python object against the schema and return the validated object.
-
-        Arguments:
-            input: The Python object to validate.
-            strict: Whether to validate the object in strict mode.
-                If `None`, the value of [`CoreConfig.strict`][pydantic_core.core_schema.CoreConfig] is used.
-            from_attributes: Whether to validate objects as inputs to models by extracting attributes.
-                If `None`, the value of [`CoreConfig.from_attributes`][pydantic_core.core_schema.CoreConfig] is used.
-            context: The context to use for validation, this is passed to functional validators as
-                [`info.context`][pydantic_core.core_schema.ValidationInfo.context].
-            self_instance: An instance of a model set attributes on from validation, this is used when running
-                validation from the `__init__` method of a model.
-
-        Raises:
-            ValidationError: If validation fails.
-            Exception: Other error types maybe raised if internal errors occur.
-
-        Returns:
-            The validated object.
-        """
-    def isinstance_python(
-        self,
-        input: Any,
-        *,
-        strict: bool | None = None,
-        from_attributes: bool | None = None,
-        context: 'dict[str, Any] | None' = None,
-        self_instance: Any | None = None,
-    ) -> bool:
-        """
-        Similar to [`validate_python()`][pydantic_core.SchemaValidator.validate_python] but returns a boolean.
-
-        Arguments match `validate_python()`. This method will not raise `ValidationError`s but will raise internal
-        errors.
-
-        Returns:
-            `True` if validation succeeds, `False` if validation fails.
-        """
-    def validate_json(
-        self,
-        input: str | bytes | bytearray,
-        *,
-        strict: bool | None = None,
-        context: 'dict[str, Any] | None' = None,
-        self_instance: Any | None = None,
-    ) -> Any:
-        """
-        Validate JSON data directly against the schema and return the validated Python object.
-
-        This method should be significantly faster than `validate_python(json.loads(json_data))` as it avoids the
-        need to create intermediate Python objects
-
-        It also handles constructing the correct Python type even in strict mode, where
-        `validate_python(json.loads(json_data))` would fail validation.
-
-        Arguments:
-            input: The JSON data to validate.
-            strict: Whether to validate the object in strict mode.
-                If `None`, the value of [`CoreConfig.strict`][pydantic_core.core_schema.CoreConfig] is used.
-            context: The context to use for validation, this is passed to functional validators as
-                [`info.context`][pydantic_core.core_schema.ValidationInfo.context].
-            self_instance: An instance of a model set attributes on from validation.
-
-        Raises:
-            ValidationError: If validation fails or if the JSON data is invalid.
-            Exception: Other error types maybe raised if internal errors occur.
-
-        Returns:
-            The validated Python object.
-        """
-    def validate_strings(
-        self, input: _StringInput, *, strict: bool | None = None, context: 'dict[str, Any] | None' = None
-    ) -> Any:
-        """
-        Validate a string against the schema and return the validated Python object.
-
-        This is similar to `validate_json` but applies to scenarios where the input will be a string but not
-        JSON data, e.g. URL fragments, query parameters, etc.
-
-        Arguments:
-            input: The input as a string, or bytes/bytearray if `strict=False`.
-            strict: Whether to validate the object in strict mode.
-                If `None`, the value of [`CoreConfig.strict`][pydantic_core.core_schema.CoreConfig] is used.
-            context: The context to use for validation, this is passed to functional validators as
-                [`info.context`][pydantic_core.core_schema.ValidationInfo.context].
-
-        Raises:
-            ValidationError: If validation fails or if the JSON data is invalid.
-            Exception: Other error types maybe raised if internal errors occur.
-
-        Returns:
-            The validated Python object.
-        """
-    def validate_assignment(
-        self,
-        obj: Any,
-        field_name: str,
-        field_value: Any,
-        *,
-        strict: bool | None = None,
-        from_attributes: bool | None = None,
-        context: 'dict[str, Any] | None' = None,
-    ) -> dict[str, Any] | tuple[dict[str, Any], dict[str, Any] | None, set[str]]:
-        """
-        Validate an assignment to a field on a model.
-
-        Arguments:
-            obj: The model instance being assigned to.
-            field_name: The name of the field to validate assignment for.
-            field_value: The value to assign to the field.
-            strict: Whether to validate the object in strict mode.
-                If `None`, the value of [`CoreConfig.strict`][pydantic_core.core_schema.CoreConfig] is used.
-            from_attributes: Whether to validate objects as inputs to models by extracting attributes.
-                If `None`, the value of [`CoreConfig.from_attributes`][pydantic_core.core_schema.CoreConfig] is used.
-            context: The context to use for validation, this is passed to functional validators as
-                [`info.context`][pydantic_core.core_schema.ValidationInfo.context].
-
-        Raises:
-            ValidationError: If validation fails.
-            Exception: Other error types maybe raised if internal errors occur.
-
-        Returns:
-            Either the model dict or a tuple of `(model_data, model_extra, fields_set)`
-        """
-    def get_default_value(self, *, strict: bool | None = None, context: Any = None) -> Some | None:
-        """
-        Get the default value for the schema, including running default value validation.
-
-        Arguments:
-            strict: Whether to validate the default value in strict mode.
-                If `None`, the value of [`CoreConfig.strict`][pydantic_core.core_schema.CoreConfig] is used.
-            context: The context to use for validation, this is passed to functional validators as
-                [`info.context`][pydantic_core.core_schema.ValidationInfo.context].
-
-        Raises:
-            ValidationError: If validation fails.
-            Exception: Other error types maybe raised if internal errors occur.
-
-        Returns:
-            `None` if the schema has no default value, otherwise a [`Some`][pydantic_core.Some] containing the default.
-        """
-
-_IncEx: TypeAlias = set[int] | set[str] | dict[int, _IncEx] | dict[str, _IncEx] | None
-
-@final
-class SchemaSerializer:
-    """
-    `SchemaSerializer` is the Python wrapper for `pydantic-core`'s Rust serialization logic, internally it owns one
-    `CombinedSerializer` which may in turn own more `CombinedSerializer`s which make up the full schema serializer.
-    """
-
-    def __new__(cls, schema: CoreSchema, config: CoreConfig | None = None) -> Self:
-        """
-        Create a new SchemaSerializer.
-
-        Arguments:
-            schema: The [`CoreSchema`][pydantic_core.core_schema.CoreSchema] to use for serialization.
-            config: Optionally a [`CoreConfig`][pydantic_core.core_schema.CoreConfig] to to configure serialization.
-        """
-    def to_python(
-        self,
-        value: Any,
-        *,
-        mode: str | None = None,
-        include: _IncEx = None,
-        exclude: _IncEx = None,
-        by_alias: bool = True,
-        exclude_unset: bool = False,
-        exclude_defaults: bool = False,
-        exclude_none: bool = False,
-        round_trip: bool = False,
-        warnings: bool = True,
-        fallback: Callable[[Any], Any] | None = None,
-    ) -> Any:
-        """
-        Serialize/marshal a Python object to a Python object including transforming and filtering data.
-
-        Arguments:
-            value: The Python object to serialize.
-            mode: The serialization mode to use, either `'python'` or `'json'`, defaults to `'python'`. In JSON mode,
-                all values are converted to JSON compatible types, e.g. `None`, `int`, `float`, `str`, `list`, `dict`.
-            include: A set of fields to include, if `None` all fields are included.
-            exclude: A set of fields to exclude, if `None` no fields are excluded.
-            by_alias: Whether to use the alias names of fields.
-            exclude_unset: Whether to exclude fields that are not set,
-                e.g. are not included in `__pydantic_fields_set__`.
-            exclude_defaults: Whether to exclude fields that are equal to their default value.
-            exclude_none: Whether to exclude fields that have a value of `None`.
-            round_trip: Whether to enable serialization and validation round-trip support.
-            warnings: Whether to log warnings when invalid fields are encountered.
-            fallback: A function to call when an unknown value is encountered,
-                if `None` a [`PydanticSerializationError`][pydantic_core.PydanticSerializationError] error is raised.
-
-        Raises:
-            PydanticSerializationError: If serialization fails and no `fallback` function is provided.
-
-        Returns:
-            The serialized Python object.
-        """
-    def to_json(
-        self,
-        value: Any,
-        *,
-        indent: int | None = None,
-        include: _IncEx = None,
-        exclude: _IncEx = None,
-        by_alias: bool = True,
-        exclude_unset: bool = False,
-        exclude_defaults: bool = False,
-        exclude_none: bool = False,
-        round_trip: bool = False,
-        warnings: bool = True,
-        fallback: Callable[[Any], Any] | None = None,
-    ) -> bytes:
-        """
-        Serialize a Python object to JSON including transforming and filtering data.
-
-        Arguments:
-            value: The Python object to serialize.
-            indent: If `None`, the JSON will be compact, otherwise it will be pretty-printed with the indent provided.
-            include: A set of fields to include, if `None` all fields are included.
-            exclude: A set of fields to exclude, if `None` no fields are excluded.
-            by_alias: Whether to use the alias names of fields.
-            exclude_unset: Whether to exclude fields that are not set,
-                e.g. are not included in `__pydantic_fields_set__`.
-            exclude_defaults: Whether to exclude fields that are equal to their default value.
-            exclude_none: Whether to exclude fields that have a value of `None`.
-            round_trip: Whether to enable serialization and validation round-trip support.
-            warnings: Whether to log warnings when invalid fields are encountered.
-            fallback: A function to call when an unknown value is encountered,
-                if `None` a [`PydanticSerializationError`][pydantic_core.PydanticSerializationError] error is raised.
-
-        Raises:
-            PydanticSerializationError: If serialization fails and no `fallback` function is provided.
-
-        Returns:
-           JSON bytes.
-        """
-
-def to_json(
-    value: Any,
-    *,
-    indent: int | None = None,
-    include: _IncEx = None,
-    exclude: _IncEx = None,
-    by_alias: bool = True,
-    exclude_none: bool = False,
-    round_trip: bool = False,
-    timedelta_mode: Literal['iso8601', 'float'] = 'iso8601',
-    bytes_mode: Literal['utf8', 'base64'] = 'utf8',
-    inf_nan_mode: Literal['null', 'constants'] = 'constants',
-    serialize_unknown: bool = False,
-    fallback: Callable[[Any], Any] | None = None,
-) -> bytes:
-    """
-    Serialize a Python object to JSON including transforming and filtering data.
-
-    This is effectively a standalone version of [`SchemaSerializer.to_json`][pydantic_core.SchemaSerializer.to_json].
-
-    Arguments:
-        value: The Python object to serialize.
-        indent: If `None`, the JSON will be compact, otherwise it will be pretty-printed with the indent provided.
-        include: A set of fields to include, if `None` all fields are included.
-        exclude: A set of fields to exclude, if `None` no fields are excluded.
-        by_alias: Whether to use the alias names of fields.
-        exclude_none: Whether to exclude fields that have a value of `None`.
-        round_trip: Whether to enable serialization and validation round-trip support.
-        timedelta_mode: How to serialize `timedelta` objects, either `'iso8601'` or `'float'`.
-        bytes_mode: How to serialize `bytes` objects, either `'utf8'` or `'base64'`.
-        inf_nan_mode: How to serialize `Infinity`, `-Infinity` and `NaN` values, either `'null'` or `'constants'`.
-        serialize_unknown: Attempt to serialize unknown types, `str(value)` will be used, if that fails
-            `"<Unserializable {value_type} object>"` will be used.
-        fallback: A function to call when an unknown value is encountered,
-            if `None` a [`PydanticSerializationError`][pydantic_core.PydanticSerializationError] error is raised.
-
-    Raises:
-        PydanticSerializationError: If serialization fails and no `fallback` function is provided.
-
-    Returns:
-       JSON bytes.
-    """
-
-def from_json(data: str | bytes | bytearray, *, allow_inf_nan: bool = True, cache_strings: bool = True) -> Any:
-    """
-    Deserialize JSON data to a Python object.
-
-    This is effectively a faster version of `json.loads()`.
-
-    Arguments:
-        data: The JSON data to deserialize.
-        allow_inf_nan: Whether to allow `Infinity`, `-Infinity` and `NaN` values as `json.loads()` does by default.
-        cache_strings: Whether to cache strings to avoid constructing new Python objects,
-            this should have a significant impact on performance while increasing memory usage slightly.
-
-    Raises:
-        ValueError: If deserialization fails.
-
-    Returns:
-        The deserialized Python object.
-    """
-
-def to_jsonable_python(
-    value: Any,
-    *,
-    include: _IncEx = None,
-    exclude: _IncEx = None,
-    by_alias: bool = True,
-    exclude_none: bool = False,
-    round_trip: bool = False,
-    timedelta_mode: Literal['iso8601', 'float'] = 'iso8601',
-    bytes_mode: Literal['utf8', 'base64'] = 'utf8',
-    inf_nan_mode: Literal['null', 'constants'] = 'constants',
-    serialize_unknown: bool = False,
-    fallback: Callable[[Any], Any] | None = None,
-) -> Any:
-    """
-    Serialize/marshal a Python object to a JSON-serializable Python object including transforming and filtering data.
-
-    This is effectively a standalone version of
-    [`SchemaSerializer.to_python(mode='json')`][pydantic_core.SchemaSerializer.to_python].
-
-    Args:
-        value: The Python object to serialize.
-        include: A set of fields to include, if `None` all fields are included.
-        exclude: A set of fields to exclude, if `None` no fields are excluded.
-        by_alias: Whether to use the alias names of fields.
-        exclude_none: Whether to exclude fields that have a value of `None`.
-        round_trip: Whether to enable serialization and validation round-trip support.
-        timedelta_mode: How to serialize `timedelta` objects, either `'iso8601'` or `'float'`.
-        bytes_mode: How to serialize `bytes` objects, either `'utf8'` or `'base64'`.
-        inf_nan_mode: How to serialize `Infinity`, `-Infinity` and `NaN` values, either `'null'` or `'constants'`.
-        serialize_unknown: Attempt to serialize unknown types, `str(value)` will be used, if that fails
-            `"<Unserializable {value_type} object>"` will be used.
-        fallback: A function to call when an unknown value is encountered,
-            if `None` a [`PydanticSerializationError`][pydantic_core.PydanticSerializationError] error is raised.
-
-    Raises:
-        PydanticSerializationError: If serialization fails and no `fallback` function is provided.
-
-    Returns:
-        The serialized Python object.
-    """
-
-class Url(SupportsAllComparisons):
-    """
-    A URL type, internal logic uses the [url rust crate](https://docs.rs/url/latest/url/) originally developed
-    by Mozilla.
-    """
-
-    def __new__(cls, url: str) -> Self:
-        """
-        Create a new `Url` instance.
-
-        Args:
-            url: String representation of a URL.
-
-        Returns:
-            A new `Url` instance.
-
-        Raises:
-            ValidationError: If the URL is invalid.
-        """
-    @property
-    def scheme(self) -> str:
-        """
-        The scheme part of the URL.
-
-        e.g. `https` in `https://user:pass@host:port/path?query#fragment`
-        """
-    @property
-    def username(self) -> str | None:
-        """
-        The username part of the URL, or `None`.
-
-        e.g. `user` in `https://user:pass@host:port/path?query#fragment`
-        """
-    @property
-    def password(self) -> str | None:
-        """
-        The password part of the URL, or `None`.
-
-        e.g. `pass` in `https://user:pass@host:port/path?query#fragment`
-        """
-    @property
-    def host(self) -> str | None:
-        """
-        The host part of the URL, or `None`.
-
-        If the URL must be punycode encoded, this is the encoded host, e.g if the input URL is `https://£££.com`,
-        `host` will be `xn--9aaa.com`
-        """
-    def unicode_host(self) -> str | None:
-        """
-        The host part of the URL as a unicode string, or `None`.
-
-        e.g. `host` in `https://user:pass@host:port/path?query#fragment`
-
-        If the URL must be punycode encoded, this is the decoded host, e.g if the input URL is `https://£££.com`,
-        `unicode_host()` will be `£££.com`
-        """
-    @property
-    def port(self) -> int | None:
-        """
-        The port part of the URL, or `None`.
-
-        e.g. `port` in `https://user:pass@host:port/path?query#fragment`
-        """
-    @property
-    def path(self) -> str | None:
-        """
-        The path part of the URL, or `None`.
-
-        e.g. `/path` in `https://user:pass@host:port/path?query#fragment`
-        """
-    @property
-    def query(self) -> str | None:
-        """
-        The query part of the URL, or `None`.
-
-        e.g. `query` in `https://user:pass@host:port/path?query#fragment`
-        """
-    def query_params(self) -> list[tuple[str, str]]:
-        """
-        The query part of the URL as a list of key-value pairs.
-
-        e.g. `[('foo', 'bar')]` in `https://user:pass@host:port/path?foo=bar#fragment`
-        """
-    @property
-    def fragment(self) -> str | None:
-        """
-        The fragment part of the URL, or `None`.
-
-        e.g. `fragment` in `https://user:pass@host:port/path?query#fragment`
-        """
-    def unicode_string(self) -> str:
-        """
-        The URL as a unicode string, unlike `__str__()` this will not punycode encode the host.
-
-        If the URL must be punycode encoded, this is the decoded string, e.g if the input URL is `https://£££.com`,
-        `unicode_string()` will be `https://£££.com`
-        """
-    def __repr__(self) -> str: ...
-    def __str__(self) -> str:
-        """
-        The URL as a string, this will punycode encode the host if required.
-        """
-    def __deepcopy__(self, memo: dict) -> str: ...
-    @classmethod
-    def build(
-        cls,
-        *,
-        scheme: str,
-        username: Optional[str] = None,
-        password: Optional[str] = None,
-        host: str,
-        port: Optional[int] = None,
-        path: Optional[str] = None,
-        query: Optional[str] = None,
-        fragment: Optional[str] = None,
-    ) -> Self:
-        """
-        Build a new `Url` instance from its component parts.
-
-        Args:
-            scheme: The scheme part of the URL.
-            username: The username part of the URL, or omit for no username.
-            password: The password part of the URL, or omit for no password.
-            host: The host part of the URL.
-            port: The port part of the URL, or omit for no port.
-            path: The path part of the URL, or omit for no path.
-            query: The query part of the URL, or omit for no query.
-            fragment: The fragment part of the URL, or omit for no fragment.
-
-        Returns:
-            An instance of URL
-        """
-
-class MultiHostUrl(SupportsAllComparisons):
-    """
-    A URL type with support for multiple hosts, as used by some databases for DSNs, e.g. `https://foo.com,bar.com/path`.
-
-    Internal URL logic uses the [url rust crate](https://docs.rs/url/latest/url/) originally developed
-    by Mozilla.
-    """
-
-    def __new__(cls, url: str) -> Self:
-        """
-        Create a new `MultiHostUrl` instance.
-
-        Args:
-            url: String representation of a URL.
-
-        Returns:
-            A new `MultiHostUrl` instance.
-
-        Raises:
-            ValidationError: If the URL is invalid.
-        """
-    @property
-    def scheme(self) -> str:
-        """
-        The scheme part of the URL.
-
-        e.g. `https` in `https://foo.com,bar.com/path?query#fragment`
-        """
-    @property
-    def path(self) -> str | None:
-        """
-        The path part of the URL, or `None`.
-
-        e.g. `/path` in `https://foo.com,bar.com/path?query#fragment`
-        """
-    @property
-    def query(self) -> str | None:
-        """
-        The query part of the URL, or `None`.
-
-        e.g. `query` in `https://foo.com,bar.com/path?query#fragment`
-        """
-    def query_params(self) -> list[tuple[str, str]]:
-        """
-        The query part of the URL as a list of key-value pairs.
-
-        e.g. `[('foo', 'bar')]` in `https://foo.com,bar.com/path?query#fragment`
-        """
-    @property
-    def fragment(self) -> str | None:
-        """
-        The fragment part of the URL, or `None`.
-
-        e.g. `fragment` in `https://foo.com,bar.com/path?query#fragment`
-        """
-    def hosts(self) -> list[MultiHostHost]:
-        '''
-
-        The hosts of the `MultiHostUrl` as [`MultiHostHost`][pydantic_core.MultiHostHost] typed dicts.
-
-        ```py
-        from pydantic_core import MultiHostUrl
-
-        mhu = MultiHostUrl('https://foo.com:123,foo:bar@bar.com/path')
-        print(mhu.hosts())
-        """
-        [
-            {'username': None, 'password': None, 'host': 'foo.com', 'port': 123},
-            {'username': 'foo', 'password': 'bar', 'host': 'bar.com', 'port': 443}
-        ]
-        ```
-        Returns:
-            A list of dicts, each representing a host.
-        '''
-    def unicode_string(self) -> str:
-        """
-        The URL as a unicode string, unlike `__str__()` this will not punycode encode the hosts.
-        """
-    def __repr__(self) -> str: ...
-    def __str__(self) -> str:
-        """
-        The URL as a string, this will punycode encode the hosts if required.
-        """
-    def __deepcopy__(self, memo: dict) -> Self: ...
-    @classmethod
-    def build(
-        cls,
-        *,
-        scheme: str,
-        hosts: Optional[list[MultiHostHost]] = None,
-        username: Optional[str] = None,
-        password: Optional[str] = None,
-        host: Optional[str] = None,
-        port: Optional[int] = None,
-        path: Optional[str] = None,
-        query: Optional[str] = None,
-        fragment: Optional[str] = None,
-    ) -> Self:
-        """
-        Build a new `MultiHostUrl` instance from its component parts.
-
-        This method takes either `hosts` - a list of `MultiHostHost` typed dicts, or the individual components
-        `username`, `password`, `host` and `port`.
-
-        Args:
-            scheme: The scheme part of the URL.
-            hosts: Multiple hosts to build the URL from.
-            username: The username part of the URL.
-            password: The password part of the URL.
-            host: The host part of the URL.
-            port: The port part of the URL.
-            path: The path part of the URL.
-            query: The query part of the URL, or omit for no query.
-            fragment: The fragment part of the URL, or omit for no fragment.
-
-        Returns:
-            An instance of `MultiHostUrl`
-        """
-
-@final
-class SchemaError(Exception):
-    """
-    Information about errors that occur while building a [`SchemaValidator`][pydantic_core.SchemaValidator]
-    or [`SchemaSerializer`][pydantic_core.SchemaSerializer].
-    """
-
-    def error_count(self) -> int:
-        """
-        Returns:
-            The number of errors in the schema.
-        """
-    def errors(self) -> list[ErrorDetails]:
-        """
-        Returns:
-            A list of [`ErrorDetails`][pydantic_core.ErrorDetails] for each error in the schema.
-        """
-
-@final
-class ValidationError(ValueError):
-    """
-    `ValidationError` is the exception raised by `pydantic-core` when validation fails, it contains a list of errors
-    which detail why validation failed.
-    """
-
-    @staticmethod
-    def from_exception_data(
-        title: str,
-        line_errors: list[InitErrorDetails],
-        input_type: Literal['python', 'json'] = 'python',
-        hide_input: bool = False,
-    ) -> ValidationError:
-        """
-        Python constructor for a Validation Error.
-
-        The API for constructing validation errors will probably change in the future,
-        hence the static method rather than `__init__`.
-
-        Arguments:
-            title: The title of the error, as used in the heading of `str(validation_error)`
-            line_errors: A list of [`InitErrorDetails`][pydantic_core.InitErrorDetails] which contain information
-                about errors that occurred during validation.
-            input_type: Whether the error is for a Python object or JSON.
-            hide_input: Whether to hide the input value in the error message.
-        """
-    @property
-    def title(self) -> str:
-        """
-        The title of the error, as used in the heading of `str(validation_error)`.
-        """
-    def error_count(self) -> int:
-        """
-        Returns:
-            The number of errors in the validation error.
-        """
-    def errors(
-        self, *, include_url: bool = True, include_context: bool = True, include_input: bool = True
-    ) -> list[ErrorDetails]:
-        """
-        Details about each error in the validation error.
-
-        Args:
-            include_url: Whether to include a URL to documentation on the error each error.
-            include_context: Whether to include the context of each error.
-            include_input: Whether to include the input value of each error.
-
-        Returns:
-            A list of [`ErrorDetails`][pydantic_core.ErrorDetails] for each error in the validation error.
-        """
-    def json(
-        self,
-        *,
-        indent: int | None = None,
-        include_url: bool = True,
-        include_context: bool = True,
-        include_input: bool = True,
-    ) -> str:
-        """
-        Same as [`errors()`][pydantic_core.ValidationError.errors] but returns a JSON string.
-
-        Args:
-            indent: The number of spaces to indent the JSON by, or `None` for no indentation - compact JSON.
-            include_url: Whether to include a URL to documentation on the error each error.
-            include_context: Whether to include the context of each error.
-            include_input: Whether to include the input value of each error.
-
-        Returns:
-            a JSON string.
-        """
-
-    def __repr__(self) -> str:
-        """
-        A string representation of the validation error.
-
-        Whether or not documentation URLs are included in the repr is controlled by the
-        environment variable `PYDANTIC_ERRORS_INCLUDE_URL` being set to `1` or
-        `true`; by default, URLs are shown.
-
-        Due to implementation details, this environment variable can only be set once,
-        before the first validation error is created.
-        """
-
-@final
-class PydanticCustomError(ValueError):
-    def __new__(
-        cls, error_type: LiteralString, message_template: LiteralString, context: dict[str, Any] | None = None
-    ) -> Self: ...
-    @property
-    def context(self) -> dict[str, Any] | None: ...
-    @property
-    def type(self) -> str: ...
-    @property
-    def message_template(self) -> str: ...
-    def message(self) -> str: ...
-
-@final
-class PydanticKnownError(ValueError):
-    def __new__(cls, error_type: ErrorType, context: dict[str, Any] | None = None) -> Self: ...
-    @property
-    def context(self) -> dict[str, Any] | None: ...
-    @property
-    def type(self) -> ErrorType: ...
-    @property
-    def message_template(self) -> str: ...
-    def message(self) -> str: ...
-
-@final
-class PydanticOmit(Exception):
-    def __new__(cls) -> Self: ...
-
-@final
-class PydanticUseDefault(Exception):
-    def __new__(cls) -> Self: ...
-
-@final
-class PydanticSerializationError(ValueError):
-    def __new__(cls, message: str) -> Self: ...
-
-@final
-class PydanticSerializationUnexpectedValue(ValueError):
-    def __new__(cls, message: str | None = None) -> Self: ...
-
-@final
-class ArgsKwargs:
-    def __new__(cls, args: tuple[Any, ...], kwargs: dict[str, Any] | None = None) -> Self: ...
-    @property
-    def args(self) -> tuple[Any, ...]: ...
-    @property
-    def kwargs(self) -> dict[str, Any] | None: ...
-
-@final
-class PydanticUndefinedType:
-    def __copy__(self) -> Self: ...
-    def __deepcopy__(self, memo: Any) -> Self: ...
-
-PydanticUndefined: PydanticUndefinedType
-
-def list_all_errors() -> list[ErrorTypeInfo]:
-    """
-    Get information about all built-in errors.
-
-    Returns:
-        A list of `ErrorTypeInfo` typed dicts.
-    """
-@final
-class TzInfo(datetime.tzinfo):
-    def tzname(self, _dt: datetime.datetime | None) -> str | None: ...
-    def utcoffset(self, _dt: datetime.datetime | None) -> datetime.timedelta: ...
-    def dst(self, _dt: datetime.datetime | None) -> datetime.timedelta: ...
-    def fromutc(self, dt: datetime.datetime) -> datetime.datetime: ...
-    def __deepcopy__(self, _memo: dict[Any, Any]) -> 'TzInfo': ...
-
-def validate_core_schema(schema: CoreSchema, *, strict: bool | None = None) -> CoreSchema:
-    """Validate a CoreSchema
-    This currently uses lax mode for validation (i.e. will coerce strings to dates and such)
-    but may use strict mode in the future.
-    We may also remove this function altogether, do not rely on it being present if you are
-    using pydantic-core directly.
-    """
diff --git a/lib/pydantic_core/core_schema.py b/lib/pydantic_core/core_schema.py
deleted file mode 100644
index 31bf4878..00000000
--- a/lib/pydantic_core/core_schema.py
+++ /dev/null
@@ -1,3980 +0,0 @@
-"""
-This module contains definitions to build schemas which `pydantic_core` can
-validate and serialize.
-"""
-
-from __future__ import annotations as _annotations
-
-import sys
-import warnings
-from collections.abc import Mapping
-from datetime import date, datetime, time, timedelta
-from decimal import Decimal
-from typing import TYPE_CHECKING, Any, Callable, Dict, Hashable, List, Set, Tuple, Type, Union
-
-from typing_extensions import deprecated
-
-if sys.version_info < (3, 12):
-    from typing_extensions import TypedDict
-else:
-    from typing import TypedDict
-
-if sys.version_info < (3, 11):
-    from typing_extensions import Protocol, Required, TypeAlias
-else:
-    from typing import Protocol, Required, TypeAlias
-
-if sys.version_info < (3, 9):
-    from typing_extensions import Literal
-else:
-    from typing import Literal
-
-if TYPE_CHECKING:
-    from pydantic_core import PydanticUndefined
-else:
-    # The initial build of pydantic_core requires PydanticUndefined to generate
-    # the core schema; so we need to conditionally skip it. mypy doesn't like
-    # this at all, hence the TYPE_CHECKING branch above.
-    try:
-        from pydantic_core import PydanticUndefined
-    except ImportError:
-        PydanticUndefined = object()
-
-
-ExtraBehavior = Literal['allow', 'forbid', 'ignore']
-
-
-class CoreConfig(TypedDict, total=False):
-    """
-    Base class for schema configuration options.
-
-    Attributes:
-        title: The name of the configuration.
-        strict: Whether the configuration should strictly adhere to specified rules.
-        extra_fields_behavior: The behavior for handling extra fields.
-        typed_dict_total: Whether the TypedDict should be considered total. Default is `True`.
-        from_attributes: Whether to use attributes for models, dataclasses, and tagged union keys.
-        loc_by_alias: Whether to use the used alias (or first alias for "field required" errors) instead of
-            `field_names` to construct error `loc`s. Default is `True`.
-        revalidate_instances: Whether instances of models and dataclasses should re-validate. Default is 'never'.
-        validate_default: Whether to validate default values during validation. Default is `False`.
-        populate_by_name: Whether an aliased field may be populated by its name as given by the model attribute,
-            as well as the alias. (Replaces 'allow_population_by_field_name' in Pydantic v1.) Default is `False`.
-        str_max_length: The maximum length for string fields.
-        str_min_length: The minimum length for string fields.
-        str_strip_whitespace: Whether to strip whitespace from string fields.
-        str_to_lower: Whether to convert string fields to lowercase.
-        str_to_upper: Whether to convert string fields to uppercase.
-        allow_inf_nan: Whether to allow infinity and NaN values for float fields. Default is `True`.
-        ser_json_timedelta: The serialization option for `timedelta` values. Default is 'iso8601'.
-        ser_json_bytes: The serialization option for `bytes` values. Default is 'utf8'.
-        ser_json_inf_nan: The serialization option for infinity and NaN values
-            in float fields. Default is 'null'.
-        hide_input_in_errors: Whether to hide input data from `ValidationError` representation.
-        validation_error_cause: Whether to add user-python excs to the __cause__ of a ValidationError.
-            Requires exceptiongroup backport pre Python 3.11.
-        coerce_numbers_to_str: Whether to enable coercion of any `Number` type to `str` (not applicable in `strict` mode).
-        regex_engine: The regex engine to use for regex pattern validation. Default is 'rust-regex'. See `StringSchema`.
-    """
-
-    title: str
-    strict: bool
-    # settings related to typed dicts, model fields, dataclass fields
-    extra_fields_behavior: ExtraBehavior
-    typed_dict_total: bool  # default: True
-    # used for models, dataclasses, and tagged union keys
-    from_attributes: bool
-    # whether to use the used alias (or first alias for "field required" errors) instead of field_names
-    # to construct error `loc`s, default True
-    loc_by_alias: bool
-    # whether instances of models and dataclasses (including subclass instances) should re-validate, default 'never'
-    revalidate_instances: Literal['always', 'never', 'subclass-instances']
-    # whether to validate default values during validation, default False
-    validate_default: bool
-    # used on typed-dicts and arguments
-    populate_by_name: bool  # replaces `allow_population_by_field_name` in pydantic v1
-    # fields related to string fields only
-    str_max_length: int
-    str_min_length: int
-    str_strip_whitespace: bool
-    str_to_lower: bool
-    str_to_upper: bool
-    # fields related to float fields only
-    allow_inf_nan: bool  # default: True
-    # the config options are used to customise serialization to JSON
-    ser_json_timedelta: Literal['iso8601', 'float']  # default: 'iso8601'
-    ser_json_bytes: Literal['utf8', 'base64', 'hex']  # default: 'utf8'
-    ser_json_inf_nan: Literal['null', 'constants']  # default: 'null'
-    # used to hide input data from ValidationError repr
-    hide_input_in_errors: bool
-    validation_error_cause: bool  # default: False
-    coerce_numbers_to_str: bool  # default: False
-    regex_engine: Literal['rust-regex', 'python-re']  # default: 'rust-regex'
-
-
-IncExCall: TypeAlias = 'set[int | str] | dict[int | str, IncExCall] | None'
-
-
-class SerializationInfo(Protocol):
-    @property
-    def include(self) -> IncExCall:
-        ...
-
-    @property
-    def exclude(self) -> IncExCall:
-        ...
-
-    @property
-    def mode(self) -> str:
-        ...
-
-    @property
-    def by_alias(self) -> bool:
-        ...
-
-    @property
-    def exclude_unset(self) -> bool:
-        ...
-
-    @property
-    def exclude_defaults(self) -> bool:
-        ...
-
-    @property
-    def exclude_none(self) -> bool:
-        ...
-
-    @property
-    def round_trip(self) -> bool:
-        ...
-
-    def mode_is_json(self) -> bool:
-        ...
-
-    def __str__(self) -> str:
-        ...
-
-    def __repr__(self) -> str:
-        ...
-
-
-class FieldSerializationInfo(SerializationInfo, Protocol):
-    @property
-    def field_name(self) -> str:
-        ...
-
-
-class ValidationInfo(Protocol):
-    """
-    Argument passed to validation functions.
-    """
-
-    @property
-    def context(self) -> Any | None:
-        """Current validation context."""
-        ...
-
-    @property
-    def config(self) -> CoreConfig | None:
-        """The CoreConfig that applies to this validation."""
-        ...
-
-    @property
-    def mode(self) -> Literal['python', 'json']:
-        """The type of input data we are currently validating"""
-        ...
-
-    @property
-    def data(self) -> Dict[str, Any]:
-        """The data being validated for this model."""
-        ...
-
-    @property
-    def field_name(self) -> str | None:
-        """
-        The name of the current field being validated if this validator is
-        attached to a model field.
-        """
-        ...
-
-
-ExpectedSerializationTypes = Literal[
-    'none',
-    'int',
-    'bool',
-    'float',
-    'str',
-    'bytes',
-    'bytearray',
-    'list',
-    'tuple',
-    'set',
-    'frozenset',
-    'generator',
-    'dict',
-    'datetime',
-    'date',
-    'time',
-    'timedelta',
-    'url',
-    'multi-host-url',
-    'json',
-    'uuid',
-]
-
-
-class SimpleSerSchema(TypedDict, total=False):
-    type: Required[ExpectedSerializationTypes]
-
-
-def simple_ser_schema(type: ExpectedSerializationTypes) -> SimpleSerSchema:
-    """
-    Returns a schema for serialization with a custom type.
-
-    Args:
-        type: The type to use for serialization
-    """
-    return SimpleSerSchema(type=type)
-
-
-# (__input_value: Any) -> Any
-GeneralPlainNoInfoSerializerFunction = Callable[[Any], Any]
-# (__input_value: Any, __info: FieldSerializationInfo) -> Any
-GeneralPlainInfoSerializerFunction = Callable[[Any, SerializationInfo], Any]
-# (__model: Any, __input_value: Any) -> Any
-FieldPlainNoInfoSerializerFunction = Callable[[Any, Any], Any]
-# (__model: Any, __input_value: Any, __info: FieldSerializationInfo) -> Any
-FieldPlainInfoSerializerFunction = Callable[[Any, Any, FieldSerializationInfo], Any]
-SerializerFunction = Union[
-    GeneralPlainNoInfoSerializerFunction,
-    GeneralPlainInfoSerializerFunction,
-    FieldPlainNoInfoSerializerFunction,
-    FieldPlainInfoSerializerFunction,
-]
-
-WhenUsed = Literal['always', 'unless-none', 'json', 'json-unless-none']
-"""
-Values have the following meanings:
-
-* `'always'` means always use
-* `'unless-none'` means use unless the value is `None`
-* `'json'` means use when serializing to JSON
-* `'json-unless-none'` means use when serializing to JSON and the value is not `None`
-"""
-
-
-class PlainSerializerFunctionSerSchema(TypedDict, total=False):
-    type: Required[Literal['function-plain']]
-    function: Required[SerializerFunction]
-    is_field_serializer: bool  # default False
-    info_arg: bool  # default False
-    return_schema: CoreSchema  # if omitted, AnySchema is used
-    when_used: WhenUsed  # default: 'always'
-
-
-def plain_serializer_function_ser_schema(
-    function: SerializerFunction,
-    *,
-    is_field_serializer: bool | None = None,
-    info_arg: bool | None = None,
-    return_schema: CoreSchema | None = None,
-    when_used: WhenUsed = 'always',
-) -> PlainSerializerFunctionSerSchema:
-    """
-    Returns a schema for serialization with a function, can be either a "general" or "field" function.
-
-    Args:
-        function: The function to use for serialization
-        is_field_serializer: Whether the serializer is for a field, e.g. takes `model` as the first argument,
-            and `info` includes `field_name`
-        info_arg: Whether the function takes an `__info` argument
-        return_schema: Schema to use for serializing return value
-        when_used: When the function should be called
-    """
-    if when_used == 'always':
-        # just to avoid extra elements in schema, and to use the actual default defined in rust
-        when_used = None  # type: ignore
-    return _dict_not_none(
-        type='function-plain',
-        function=function,
-        is_field_serializer=is_field_serializer,
-        info_arg=info_arg,
-        return_schema=return_schema,
-        when_used=when_used,
-    )
-
-
-class SerializerFunctionWrapHandler(Protocol):  # pragma: no cover
-    def __call__(self, __input_value: Any, __index_key: int | str | None = None) -> Any:
-        ...
-
-
-# (__input_value: Any, __serializer: SerializerFunctionWrapHandler) -> Any
-GeneralWrapNoInfoSerializerFunction = Callable[[Any, SerializerFunctionWrapHandler], Any]
-# (__input_value: Any, __serializer: SerializerFunctionWrapHandler, __info: SerializationInfo) -> Any
-GeneralWrapInfoSerializerFunction = Callable[[Any, SerializerFunctionWrapHandler, SerializationInfo], Any]
-# (__model: Any, __input_value: Any, __serializer: SerializerFunctionWrapHandler) -> Any
-FieldWrapNoInfoSerializerFunction = Callable[[Any, Any, SerializerFunctionWrapHandler], Any]
-# (__model: Any, __input_value: Any, __serializer: SerializerFunctionWrapHandler, __info: FieldSerializationInfo) -> Any
-FieldWrapInfoSerializerFunction = Callable[[Any, Any, SerializerFunctionWrapHandler, FieldSerializationInfo], Any]
-WrapSerializerFunction = Union[
-    GeneralWrapNoInfoSerializerFunction,
-    GeneralWrapInfoSerializerFunction,
-    FieldWrapNoInfoSerializerFunction,
-    FieldWrapInfoSerializerFunction,
-]
-
-
-class WrapSerializerFunctionSerSchema(TypedDict, total=False):
-    type: Required[Literal['function-wrap']]
-    function: Required[WrapSerializerFunction]
-    is_field_serializer: bool  # default False
-    info_arg: bool  # default False
-    schema: CoreSchema  # if omitted, the schema on which this serializer is defined is used
-    return_schema: CoreSchema  # if omitted, AnySchema is used
-    when_used: WhenUsed  # default: 'always'
-
-
-def wrap_serializer_function_ser_schema(
-    function: WrapSerializerFunction,
-    *,
-    is_field_serializer: bool | None = None,
-    info_arg: bool | None = None,
-    schema: CoreSchema | None = None,
-    return_schema: CoreSchema | None = None,
-    when_used: WhenUsed = 'always',
-) -> WrapSerializerFunctionSerSchema:
-    """
-    Returns a schema for serialization with a wrap function, can be either a "general" or "field" function.
-
-    Args:
-        function: The function to use for serialization
-        is_field_serializer: Whether the serializer is for a field, e.g. takes `model` as the first argument,
-            and `info` includes `field_name`
-        info_arg: Whether the function takes an `__info` argument
-        schema: The schema to use for the inner serialization
-        return_schema: Schema to use for serializing return value
-        when_used: When the function should be called
-    """
-    if when_used == 'always':
-        # just to avoid extra elements in schema, and to use the actual default defined in rust
-        when_used = None  # type: ignore
-    return _dict_not_none(
-        type='function-wrap',
-        function=function,
-        is_field_serializer=is_field_serializer,
-        info_arg=info_arg,
-        schema=schema,
-        return_schema=return_schema,
-        when_used=when_used,
-    )
-
-
-class FormatSerSchema(TypedDict, total=False):
-    type: Required[Literal['format']]
-    formatting_string: Required[str]
-    when_used: WhenUsed  # default: 'json-unless-none'
-
-
-def format_ser_schema(formatting_string: str, *, when_used: WhenUsed = 'json-unless-none') -> FormatSerSchema:
-    """
-    Returns a schema for serialization using python's `format` method.
-
-    Args:
-        formatting_string: String defining the format to use
-        when_used: Same meaning as for [general_function_plain_ser_schema], but with a different default
-    """
-    if when_used == 'json-unless-none':
-        # just to avoid extra elements in schema, and to use the actual default defined in rust
-        when_used = None  # type: ignore
-    return _dict_not_none(type='format', formatting_string=formatting_string, when_used=when_used)
-
-
-class ToStringSerSchema(TypedDict, total=False):
-    type: Required[Literal['to-string']]
-    when_used: WhenUsed  # default: 'json-unless-none'
-
-
-def to_string_ser_schema(*, when_used: WhenUsed = 'json-unless-none') -> ToStringSerSchema:
-    """
-    Returns a schema for serialization using python's `str()` / `__str__` method.
-
-    Args:
-        when_used: Same meaning as for [general_function_plain_ser_schema], but with a different default
-    """
-    s = dict(type='to-string')
-    if when_used != 'json-unless-none':
-        # just to avoid extra elements in schema, and to use the actual default defined in rust
-        s['when_used'] = when_used
-    return s  # type: ignore
-
-
-class ModelSerSchema(TypedDict, total=False):
-    type: Required[Literal['model']]
-    cls: Required[Type[Any]]
-    schema: Required[CoreSchema]
-
-
-def model_ser_schema(cls: Type[Any], schema: CoreSchema) -> ModelSerSchema:
-    """
-    Returns a schema for serialization using a model.
-
-    Args:
-        cls: The expected class type, used to generate warnings if the wrong type is passed
-        schema: Internal schema to use to serialize the model dict
-    """
-    return ModelSerSchema(type='model', cls=cls, schema=schema)
-
-
-SerSchema = Union[
-    SimpleSerSchema,
-    PlainSerializerFunctionSerSchema,
-    WrapSerializerFunctionSerSchema,
-    FormatSerSchema,
-    ToStringSerSchema,
-    ModelSerSchema,
-]
-
-
-class ComputedField(TypedDict, total=False):
-    type: Required[Literal['computed-field']]
-    property_name: Required[str]
-    return_schema: Required[CoreSchema]
-    alias: str
-    metadata: Any
-
-
-def computed_field(
-    property_name: str, return_schema: CoreSchema, *, alias: str | None = None, metadata: Any = None
-) -> ComputedField:
-    """
-    ComputedFields are properties of a model or dataclass that are included in serialization.
-
-    Args:
-        property_name: The name of the property on the model or dataclass
-        return_schema: The schema used for the type returned by the computed field
-        alias: The name to use in the serialized output
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-    """
-    return _dict_not_none(
-        type='computed-field', property_name=property_name, return_schema=return_schema, alias=alias, metadata=metadata
-    )
-
-
-class AnySchema(TypedDict, total=False):
-    type: Required[Literal['any']]
-    ref: str
-    metadata: Any
-    serialization: SerSchema
-
-
-def any_schema(*, ref: str | None = None, metadata: Any = None, serialization: SerSchema | None = None) -> AnySchema:
-    """
-    Returns a schema that matches any value, e.g.:
-
-    ```py
-    from pydantic_core import SchemaValidator, core_schema
-
-    schema = core_schema.any_schema()
-    v = SchemaValidator(schema)
-    assert v.validate_python(1) == 1
-    ```
-
-    Args:
-        ref: optional unique identifier of the schema, used to reference the schema in other places
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-        serialization: Custom serialization schema
-    """
-    return _dict_not_none(type='any', ref=ref, metadata=metadata, serialization=serialization)
-
-
-class NoneSchema(TypedDict, total=False):
-    type: Required[Literal['none']]
-    ref: str
-    metadata: Any
-    serialization: SerSchema
-
-
-def none_schema(*, ref: str | None = None, metadata: Any = None, serialization: SerSchema | None = None) -> NoneSchema:
-    """
-    Returns a schema that matches a None value, e.g.:
-
-    ```py
-    from pydantic_core import SchemaValidator, core_schema
-
-    schema = core_schema.none_schema()
-    v = SchemaValidator(schema)
-    assert v.validate_python(None) is None
-    ```
-
-    Args:
-        ref: optional unique identifier of the schema, used to reference the schema in other places
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-        serialization: Custom serialization schema
-    """
-    return _dict_not_none(type='none', ref=ref, metadata=metadata, serialization=serialization)
-
-
-class BoolSchema(TypedDict, total=False):
-    type: Required[Literal['bool']]
-    strict: bool
-    ref: str
-    metadata: Any
-    serialization: SerSchema
-
-
-def bool_schema(
-    strict: bool | None = None, ref: str | None = None, metadata: Any = None, serialization: SerSchema | None = None
-) -> BoolSchema:
-    """
-    Returns a schema that matches a bool value, e.g.:
-
-    ```py
-    from pydantic_core import SchemaValidator, core_schema
-
-    schema = core_schema.bool_schema()
-    v = SchemaValidator(schema)
-    assert v.validate_python('True') is True
-    ```
-
-    Args:
-        strict: Whether the value should be a bool or a value that can be converted to a bool
-        ref: optional unique identifier of the schema, used to reference the schema in other places
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-        serialization: Custom serialization schema
-    """
-    return _dict_not_none(type='bool', strict=strict, ref=ref, metadata=metadata, serialization=serialization)
-
-
-class IntSchema(TypedDict, total=False):
-    type: Required[Literal['int']]
-    multiple_of: int
-    le: int
-    ge: int
-    lt: int
-    gt: int
-    strict: bool
-    ref: str
-    metadata: Any
-    serialization: SerSchema
-
-
-def int_schema(
-    *,
-    multiple_of: int | None = None,
-    le: int | None = None,
-    ge: int | None = None,
-    lt: int | None = None,
-    gt: int | None = None,
-    strict: bool | None = None,
-    ref: str | None = None,
-    metadata: Any = None,
-    serialization: SerSchema | None = None,
-) -> IntSchema:
-    """
-    Returns a schema that matches a int value, e.g.:
-
-    ```py
-    from pydantic_core import SchemaValidator, core_schema
-
-    schema = core_schema.int_schema(multiple_of=2, le=6, ge=2)
-    v = SchemaValidator(schema)
-    assert v.validate_python('4') == 4
-    ```
-
-    Args:
-        multiple_of: The value must be a multiple of this number
-        le: The value must be less than or equal to this number
-        ge: The value must be greater than or equal to this number
-        lt: The value must be strictly less than this number
-        gt: The value must be strictly greater than this number
-        strict: Whether the value should be a int or a value that can be converted to a int
-        ref: optional unique identifier of the schema, used to reference the schema in other places
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-        serialization: Custom serialization schema
-    """
-    return _dict_not_none(
-        type='int',
-        multiple_of=multiple_of,
-        le=le,
-        ge=ge,
-        lt=lt,
-        gt=gt,
-        strict=strict,
-        ref=ref,
-        metadata=metadata,
-        serialization=serialization,
-    )
-
-
-class FloatSchema(TypedDict, total=False):
-    type: Required[Literal['float']]
-    allow_inf_nan: bool  # whether 'NaN', '+inf', '-inf' should be forbidden. default: True
-    multiple_of: float
-    le: float
-    ge: float
-    lt: float
-    gt: float
-    strict: bool
-    ref: str
-    metadata: Any
-    serialization: SerSchema
-
-
-def float_schema(
-    *,
-    allow_inf_nan: bool | None = None,
-    multiple_of: float | None = None,
-    le: float | None = None,
-    ge: float | None = None,
-    lt: float | None = None,
-    gt: float | None = None,
-    strict: bool | None = None,
-    ref: str | None = None,
-    metadata: Any = None,
-    serialization: SerSchema | None = None,
-) -> FloatSchema:
-    """
-    Returns a schema that matches a float value, e.g.:
-
-    ```py
-    from pydantic_core import SchemaValidator, core_schema
-
-    schema = core_schema.float_schema(le=0.8, ge=0.2)
-    v = SchemaValidator(schema)
-    assert v.validate_python('0.5') == 0.5
-    ```
-
-    Args:
-        allow_inf_nan: Whether to allow inf and nan values
-        multiple_of: The value must be a multiple of this number
-        le: The value must be less than or equal to this number
-        ge: The value must be greater than or equal to this number
-        lt: The value must be strictly less than this number
-        gt: The value must be strictly greater than this number
-        strict: Whether the value should be a float or a value that can be converted to a float
-        ref: optional unique identifier of the schema, used to reference the schema in other places
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-        serialization: Custom serialization schema
-    """
-    return _dict_not_none(
-        type='float',
-        allow_inf_nan=allow_inf_nan,
-        multiple_of=multiple_of,
-        le=le,
-        ge=ge,
-        lt=lt,
-        gt=gt,
-        strict=strict,
-        ref=ref,
-        metadata=metadata,
-        serialization=serialization,
-    )
-
-
-class DecimalSchema(TypedDict, total=False):
-    type: Required[Literal['decimal']]
-    allow_inf_nan: bool  # whether 'NaN', '+inf', '-inf' should be forbidden. default: False
-    multiple_of: Decimal
-    le: Decimal
-    ge: Decimal
-    lt: Decimal
-    gt: Decimal
-    max_digits: int
-    decimal_places: int
-    strict: bool
-    ref: str
-    metadata: Any
-    serialization: SerSchema
-
-
-def decimal_schema(
-    *,
-    allow_inf_nan: bool = None,
-    multiple_of: Decimal | None = None,
-    le: Decimal | None = None,
-    ge: Decimal | None = None,
-    lt: Decimal | None = None,
-    gt: Decimal | None = None,
-    max_digits: int | None = None,
-    decimal_places: int | None = None,
-    strict: bool | None = None,
-    ref: str | None = None,
-    metadata: Any = None,
-    serialization: SerSchema | None = None,
-) -> DecimalSchema:
-    """
-    Returns a schema that matches a decimal value, e.g.:
-
-    ```py
-    from decimal import Decimal
-    from pydantic_core import SchemaValidator, core_schema
-
-    schema = core_schema.decimal_schema(le=0.8, ge=0.2)
-    v = SchemaValidator(schema)
-    assert v.validate_python('0.5') == Decimal('0.5')
-    ```
-
-    Args:
-        allow_inf_nan: Whether to allow inf and nan values
-        multiple_of: The value must be a multiple of this number
-        le: The value must be less than or equal to this number
-        ge: The value must be greater than or equal to this number
-        lt: The value must be strictly less than this number
-        gt: The value must be strictly greater than this number
-        max_digits: The maximum number of decimal digits allowed
-        decimal_places: The maximum number of decimal places allowed
-        strict: Whether the value should be a float or a value that can be converted to a float
-        ref: optional unique identifier of the schema, used to reference the schema in other places
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-        serialization: Custom serialization schema
-    """
-    return _dict_not_none(
-        type='decimal',
-        gt=gt,
-        ge=ge,
-        lt=lt,
-        le=le,
-        max_digits=max_digits,
-        decimal_places=decimal_places,
-        multiple_of=multiple_of,
-        allow_inf_nan=allow_inf_nan,
-        strict=strict,
-        ref=ref,
-        metadata=metadata,
-        serialization=serialization,
-    )
-
-
-class StringSchema(TypedDict, total=False):
-    type: Required[Literal['str']]
-    pattern: str
-    max_length: int
-    min_length: int
-    strip_whitespace: bool
-    to_lower: bool
-    to_upper: bool
-    regex_engine: Literal['rust-regex', 'python-re']  # default: 'rust-regex'
-    strict: bool
-    ref: str
-    metadata: Any
-    serialization: SerSchema
-
-
-def str_schema(
-    *,
-    pattern: str | None = None,
-    max_length: int | None = None,
-    min_length: int | None = None,
-    strip_whitespace: bool | None = None,
-    to_lower: bool | None = None,
-    to_upper: bool | None = None,
-    regex_engine: Literal['rust-regex', 'python-re'] | None = None,
-    strict: bool | None = None,
-    ref: str | None = None,
-    metadata: Any = None,
-    serialization: SerSchema | None = None,
-) -> StringSchema:
-    """
-    Returns a schema that matches a string value, e.g.:
-
-    ```py
-    from pydantic_core import SchemaValidator, core_schema
-
-    schema = core_schema.str_schema(max_length=10, min_length=2)
-    v = SchemaValidator(schema)
-    assert v.validate_python('hello') == 'hello'
-    ```
-
-    Args:
-        pattern: A regex pattern that the value must match
-        max_length: The value must be at most this length
-        min_length: The value must be at least this length
-        strip_whitespace: Whether to strip whitespace from the value
-        to_lower: Whether to convert the value to lowercase
-        to_upper: Whether to convert the value to uppercase
-        regex_engine: The regex engine to use for pattern validation. Default is 'rust-regex'.
-            - `rust-regex` uses the [`regex`](https://docs.rs/regex) Rust
-              crate, which is non-backtracking and therefore more DDoS
-              resistant, but does not support all regex features.
-            - `python-re` use the [`re`](https://docs.python.org/3/library/re.html) module,
-              which supports all regex features, but may be slower.
-        strict: Whether the value should be a string or a value that can be converted to a string
-        ref: optional unique identifier of the schema, used to reference the schema in other places
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-        serialization: Custom serialization schema
-    """
-    return _dict_not_none(
-        type='str',
-        pattern=pattern,
-        max_length=max_length,
-        min_length=min_length,
-        strip_whitespace=strip_whitespace,
-        to_lower=to_lower,
-        to_upper=to_upper,
-        regex_engine=regex_engine,
-        strict=strict,
-        ref=ref,
-        metadata=metadata,
-        serialization=serialization,
-    )
-
-
-class BytesSchema(TypedDict, total=False):
-    type: Required[Literal['bytes']]
-    max_length: int
-    min_length: int
-    strict: bool
-    ref: str
-    metadata: Any
-    serialization: SerSchema
-
-
-def bytes_schema(
-    *,
-    max_length: int | None = None,
-    min_length: int | None = None,
-    strict: bool | None = None,
-    ref: str | None = None,
-    metadata: Any = None,
-    serialization: SerSchema | None = None,
-) -> BytesSchema:
-    """
-    Returns a schema that matches a bytes value, e.g.:
-
-    ```py
-    from pydantic_core import SchemaValidator, core_schema
-
-    schema = core_schema.bytes_schema(max_length=10, min_length=2)
-    v = SchemaValidator(schema)
-    assert v.validate_python(b'hello') == b'hello'
-    ```
-
-    Args:
-        max_length: The value must be at most this length
-        min_length: The value must be at least this length
-        strict: Whether the value should be a bytes or a value that can be converted to a bytes
-        ref: optional unique identifier of the schema, used to reference the schema in other places
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-        serialization: Custom serialization schema
-    """
-    return _dict_not_none(
-        type='bytes',
-        max_length=max_length,
-        min_length=min_length,
-        strict=strict,
-        ref=ref,
-        metadata=metadata,
-        serialization=serialization,
-    )
-
-
-class DateSchema(TypedDict, total=False):
-    type: Required[Literal['date']]
-    strict: bool
-    le: date
-    ge: date
-    lt: date
-    gt: date
-    now_op: Literal['past', 'future']
-    # defaults to current local utc offset from `time.localtime().tm_gmtoff`
-    # value is restricted to -86_400 < offset < 86_400 by bounds in generate_self_schema.py
-    now_utc_offset: int
-    ref: str
-    metadata: Any
-    serialization: SerSchema
-
-
-def date_schema(
-    *,
-    strict: bool | None = None,
-    le: date | None = None,
-    ge: date | None = None,
-    lt: date | None = None,
-    gt: date | None = None,
-    now_op: Literal['past', 'future'] | None = None,
-    now_utc_offset: int | None = None,
-    ref: str | None = None,
-    metadata: Any = None,
-    serialization: SerSchema | None = None,
-) -> DateSchema:
-    """
-    Returns a schema that matches a date value, e.g.:
-
-    ```py
-    from datetime import date
-    from pydantic_core import SchemaValidator, core_schema
-
-    schema = core_schema.date_schema(le=date(2020, 1, 1), ge=date(2019, 1, 1))
-    v = SchemaValidator(schema)
-    assert v.validate_python(date(2019, 6, 1)) == date(2019, 6, 1)
-    ```
-
-    Args:
-        strict: Whether the value should be a date or a value that can be converted to a date
-        le: The value must be less than or equal to this date
-        ge: The value must be greater than or equal to this date
-        lt: The value must be strictly less than this date
-        gt: The value must be strictly greater than this date
-        now_op: The value must be in the past or future relative to the current date
-        now_utc_offset: The value must be in the past or future relative to the current date with this utc offset
-        ref: optional unique identifier of the schema, used to reference the schema in other places
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-        serialization: Custom serialization schema
-    """
-    return _dict_not_none(
-        type='date',
-        strict=strict,
-        le=le,
-        ge=ge,
-        lt=lt,
-        gt=gt,
-        now_op=now_op,
-        now_utc_offset=now_utc_offset,
-        ref=ref,
-        metadata=metadata,
-        serialization=serialization,
-    )
-
-
-class TimeSchema(TypedDict, total=False):
-    type: Required[Literal['time']]
-    strict: bool
-    le: time
-    ge: time
-    lt: time
-    gt: time
-    tz_constraint: Union[Literal['aware', 'naive'], int]
-    microseconds_precision: Literal['truncate', 'error']
-    ref: str
-    metadata: Any
-    serialization: SerSchema
-
-
-def time_schema(
-    *,
-    strict: bool | None = None,
-    le: time | None = None,
-    ge: time | None = None,
-    lt: time | None = None,
-    gt: time | None = None,
-    tz_constraint: Literal['aware', 'naive'] | int | None = None,
-    microseconds_precision: Literal['truncate', 'error'] = 'truncate',
-    ref: str | None = None,
-    metadata: Any = None,
-    serialization: SerSchema | None = None,
-) -> TimeSchema:
-    """
-    Returns a schema that matches a time value, e.g.:
-
-    ```py
-    from datetime import time
-    from pydantic_core import SchemaValidator, core_schema
-
-    schema = core_schema.time_schema(le=time(12, 0, 0), ge=time(6, 0, 0))
-    v = SchemaValidator(schema)
-    assert v.validate_python(time(9, 0, 0)) == time(9, 0, 0)
-    ```
-
-    Args:
-        strict: Whether the value should be a time or a value that can be converted to a time
-        le: The value must be less than or equal to this time
-        ge: The value must be greater than or equal to this time
-        lt: The value must be strictly less than this time
-        gt: The value must be strictly greater than this time
-        tz_constraint: The value must be timezone aware or naive, or an int to indicate required tz offset
-        microseconds_precision: The behavior when seconds have more than 6 digits or microseconds is too large
-        ref: optional unique identifier of the schema, used to reference the schema in other places
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-        serialization: Custom serialization schema
-    """
-    return _dict_not_none(
-        type='time',
-        strict=strict,
-        le=le,
-        ge=ge,
-        lt=lt,
-        gt=gt,
-        tz_constraint=tz_constraint,
-        microseconds_precision=microseconds_precision,
-        ref=ref,
-        metadata=metadata,
-        serialization=serialization,
-    )
-
-
-class DatetimeSchema(TypedDict, total=False):
-    type: Required[Literal['datetime']]
-    strict: bool
-    le: datetime
-    ge: datetime
-    lt: datetime
-    gt: datetime
-    now_op: Literal['past', 'future']
-    tz_constraint: Union[Literal['aware', 'naive'], int]
-    # defaults to current local utc offset from `time.localtime().tm_gmtoff`
-    # value is restricted to -86_400 < offset < 86_400 by bounds in generate_self_schema.py
-    now_utc_offset: int
-    microseconds_precision: Literal['truncate', 'error']  # default: 'truncate'
-    ref: str
-    metadata: Any
-    serialization: SerSchema
-
-
-def datetime_schema(
-    *,
-    strict: bool | None = None,
-    le: datetime | None = None,
-    ge: datetime | None = None,
-    lt: datetime | None = None,
-    gt: datetime | None = None,
-    now_op: Literal['past', 'future'] | None = None,
-    tz_constraint: Literal['aware', 'naive'] | int | None = None,
-    now_utc_offset: int | None = None,
-    microseconds_precision: Literal['truncate', 'error'] = 'truncate',
-    ref: str | None = None,
-    metadata: Any = None,
-    serialization: SerSchema | None = None,
-) -> DatetimeSchema:
-    """
-    Returns a schema that matches a datetime value, e.g.:
-
-    ```py
-    from datetime import datetime
-    from pydantic_core import SchemaValidator, core_schema
-
-    schema = core_schema.datetime_schema()
-    v = SchemaValidator(schema)
-    now = datetime.now()
-    assert v.validate_python(str(now)) == now
-    ```
-
-    Args:
-        strict: Whether the value should be a datetime or a value that can be converted to a datetime
-        le: The value must be less than or equal to this datetime
-        ge: The value must be greater than or equal to this datetime
-        lt: The value must be strictly less than this datetime
-        gt: The value must be strictly greater than this datetime
-        now_op: The value must be in the past or future relative to the current datetime
-        tz_constraint: The value must be timezone aware or naive, or an int to indicate required tz offset
-            TODO: use of a tzinfo where offset changes based on the datetime is not yet supported
-        now_utc_offset: The value must be in the past or future relative to the current datetime with this utc offset
-        microseconds_precision: The behavior when seconds have more than 6 digits or microseconds is too large
-        ref: optional unique identifier of the schema, used to reference the schema in other places
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-        serialization: Custom serialization schema
-    """
-    return _dict_not_none(
-        type='datetime',
-        strict=strict,
-        le=le,
-        ge=ge,
-        lt=lt,
-        gt=gt,
-        now_op=now_op,
-        tz_constraint=tz_constraint,
-        now_utc_offset=now_utc_offset,
-        microseconds_precision=microseconds_precision,
-        ref=ref,
-        metadata=metadata,
-        serialization=serialization,
-    )
-
-
-class TimedeltaSchema(TypedDict, total=False):
-    type: Required[Literal['timedelta']]
-    strict: bool
-    le: timedelta
-    ge: timedelta
-    lt: timedelta
-    gt: timedelta
-    microseconds_precision: Literal['truncate', 'error']
-    ref: str
-    metadata: Any
-    serialization: SerSchema
-
-
-def timedelta_schema(
-    *,
-    strict: bool | None = None,
-    le: timedelta | None = None,
-    ge: timedelta | None = None,
-    lt: timedelta | None = None,
-    gt: timedelta | None = None,
-    microseconds_precision: Literal['truncate', 'error'] = 'truncate',
-    ref: str | None = None,
-    metadata: Any = None,
-    serialization: SerSchema | None = None,
-) -> TimedeltaSchema:
-    """
-    Returns a schema that matches a timedelta value, e.g.:
-
-    ```py
-    from datetime import timedelta
-    from pydantic_core import SchemaValidator, core_schema
-
-    schema = core_schema.timedelta_schema(le=timedelta(days=1), ge=timedelta(days=0))
-    v = SchemaValidator(schema)
-    assert v.validate_python(timedelta(hours=12)) == timedelta(hours=12)
-    ```
-
-    Args:
-        strict: Whether the value should be a timedelta or a value that can be converted to a timedelta
-        le: The value must be less than or equal to this timedelta
-        ge: The value must be greater than or equal to this timedelta
-        lt: The value must be strictly less than this timedelta
-        gt: The value must be strictly greater than this timedelta
-        microseconds_precision: The behavior when seconds have more than 6 digits or microseconds is too large
-        ref: optional unique identifier of the schema, used to reference the schema in other places
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-        serialization: Custom serialization schema
-    """
-    return _dict_not_none(
-        type='timedelta',
-        strict=strict,
-        le=le,
-        ge=ge,
-        lt=lt,
-        gt=gt,
-        microseconds_precision=microseconds_precision,
-        ref=ref,
-        metadata=metadata,
-        serialization=serialization,
-    )
-
-
-class LiteralSchema(TypedDict, total=False):
-    type: Required[Literal['literal']]
-    expected: Required[List[Any]]
-    ref: str
-    metadata: Any
-    serialization: SerSchema
-
-
-def literal_schema(
-    expected: list[Any], *, ref: str | None = None, metadata: Any = None, serialization: SerSchema | None = None
-) -> LiteralSchema:
-    """
-    Returns a schema that matches a literal value, e.g.:
-
-    ```py
-    from pydantic_core import SchemaValidator, core_schema
-
-    schema = core_schema.literal_schema(['hello', 'world'])
-    v = SchemaValidator(schema)
-    assert v.validate_python('hello') == 'hello'
-    ```
-
-    Args:
-        expected: The value must be one of these values
-        ref: optional unique identifier of the schema, used to reference the schema in other places
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-        serialization: Custom serialization schema
-    """
-    return _dict_not_none(type='literal', expected=expected, ref=ref, metadata=metadata, serialization=serialization)
-
-
-# must match input/parse_json.rs::JsonType::try_from
-JsonType = Literal['null', 'bool', 'int', 'float', 'str', 'list', 'dict']
-
-
-class IsInstanceSchema(TypedDict, total=False):
-    type: Required[Literal['is-instance']]
-    cls: Required[Any]
-    cls_repr: str
-    ref: str
-    metadata: Any
-    serialization: SerSchema
-
-
-def is_instance_schema(
-    cls: Any,
-    *,
-    cls_repr: str | None = None,
-    ref: str | None = None,
-    metadata: Any = None,
-    serialization: SerSchema | None = None,
-) -> IsInstanceSchema:
-    """
-    Returns a schema that checks if a value is an instance of a class, equivalent to python's `isinstance` method, e.g.:
-
-    ```py
-    from pydantic_core import SchemaValidator, core_schema
-
-    class A:
-        pass
-
-    schema = core_schema.is_instance_schema(cls=A)
-    v = SchemaValidator(schema)
-    v.validate_python(A())
-    ```
-
-    Args:
-        cls: The value must be an instance of this class
-        cls_repr: If provided this string is used in the validator name instead of `repr(cls)`
-        ref: optional unique identifier of the schema, used to reference the schema in other places
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-        serialization: Custom serialization schema
-    """
-    return _dict_not_none(
-        type='is-instance', cls=cls, cls_repr=cls_repr, ref=ref, metadata=metadata, serialization=serialization
-    )
-
-
-class IsSubclassSchema(TypedDict, total=False):
-    type: Required[Literal['is-subclass']]
-    cls: Required[Type[Any]]
-    cls_repr: str
-    ref: str
-    metadata: Any
-    serialization: SerSchema
-
-
-def is_subclass_schema(
-    cls: Type[Any],
-    *,
-    cls_repr: str | None = None,
-    ref: str | None = None,
-    metadata: Any = None,
-    serialization: SerSchema | None = None,
-) -> IsInstanceSchema:
-    """
-    Returns a schema that checks if a value is a subtype of a class, equivalent to python's `issubclass` method, e.g.:
-
-    ```py
-    from pydantic_core import SchemaValidator, core_schema
-
-    class A:
-        pass
-
-    class B(A):
-        pass
-
-    schema = core_schema.is_subclass_schema(cls=A)
-    v = SchemaValidator(schema)
-    v.validate_python(B)
-    ```
-
-    Args:
-        cls: The value must be a subclass of this class
-        cls_repr: If provided this string is used in the validator name instead of `repr(cls)`
-        ref: optional unique identifier of the schema, used to reference the schema in other places
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-        serialization: Custom serialization schema
-    """
-    return _dict_not_none(
-        type='is-subclass', cls=cls, cls_repr=cls_repr, ref=ref, metadata=metadata, serialization=serialization
-    )
-
-
-class CallableSchema(TypedDict, total=False):
-    type: Required[Literal['callable']]
-    ref: str
-    metadata: Any
-    serialization: SerSchema
-
-
-def callable_schema(
-    *, ref: str | None = None, metadata: Any = None, serialization: SerSchema | None = None
-) -> CallableSchema:
-    """
-    Returns a schema that checks if a value is callable, equivalent to python's `callable` method, e.g.:
-
-    ```py
-    from pydantic_core import SchemaValidator, core_schema
-
-    schema = core_schema.callable_schema()
-    v = SchemaValidator(schema)
-    v.validate_python(min)
-    ```
-
-    Args:
-        ref: optional unique identifier of the schema, used to reference the schema in other places
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-        serialization: Custom serialization schema
-    """
-    return _dict_not_none(type='callable', ref=ref, metadata=metadata, serialization=serialization)
-
-
-class UuidSchema(TypedDict, total=False):
-    type: Required[Literal['uuid']]
-    version: Literal[1, 3, 4, 5]
-    strict: bool
-    ref: str
-    metadata: Any
-    serialization: SerSchema
-
-
-def uuid_schema(
-    *,
-    version: Literal[1, 3, 4, 5] | None = None,
-    strict: bool | None = None,
-    ref: str | None = None,
-    metadata: Any = None,
-    serialization: SerSchema | None = None,
-) -> UuidSchema:
-    return _dict_not_none(
-        type='uuid', version=version, strict=strict, ref=ref, metadata=metadata, serialization=serialization
-    )
-
-
-class IncExSeqSerSchema(TypedDict, total=False):
-    type: Required[Literal['include-exclude-sequence']]
-    include: Set[int]
-    exclude: Set[int]
-
-
-def filter_seq_schema(*, include: Set[int] | None = None, exclude: Set[int] | None = None) -> IncExSeqSerSchema:
-    return _dict_not_none(type='include-exclude-sequence', include=include, exclude=exclude)
-
-
-IncExSeqOrElseSerSchema = Union[IncExSeqSerSchema, SerSchema]
-
-
-class ListSchema(TypedDict, total=False):
-    type: Required[Literal['list']]
-    items_schema: CoreSchema
-    min_length: int
-    max_length: int
-    strict: bool
-    ref: str
-    metadata: Any
-    serialization: IncExSeqOrElseSerSchema
-
-
-def list_schema(
-    items_schema: CoreSchema | None = None,
-    *,
-    min_length: int | None = None,
-    max_length: int | None = None,
-    strict: bool | None = None,
-    ref: str | None = None,
-    metadata: Any = None,
-    serialization: IncExSeqOrElseSerSchema | None = None,
-) -> ListSchema:
-    """
-    Returns a schema that matches a list value, e.g.:
-
-    ```py
-    from pydantic_core import SchemaValidator, core_schema
-
-    schema = core_schema.list_schema(core_schema.int_schema(), min_length=0, max_length=10)
-    v = SchemaValidator(schema)
-    assert v.validate_python(['4']) == [4]
-    ```
-
-    Args:
-        items_schema: The value must be a list of items that match this schema
-        min_length: The value must be a list with at least this many items
-        max_length: The value must be a list with at most this many items
-        strict: The value must be a list with exactly this many items
-        ref: optional unique identifier of the schema, used to reference the schema in other places
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-        serialization: Custom serialization schema
-    """
-    return _dict_not_none(
-        type='list',
-        items_schema=items_schema,
-        min_length=min_length,
-        max_length=max_length,
-        strict=strict,
-        ref=ref,
-        metadata=metadata,
-        serialization=serialization,
-    )
-
-
-# @deprecated('tuple_positional_schema is deprecated. Use pydantic_core.core_schema.tuple_schema instead.')
-def tuple_positional_schema(
-    items_schema: list[CoreSchema],
-    *,
-    extras_schema: CoreSchema | None = None,
-    strict: bool | None = None,
-    ref: str | None = None,
-    metadata: Any = None,
-    serialization: IncExSeqOrElseSerSchema | None = None,
-) -> TupleSchema:
-    """
-    Returns a schema that matches a tuple of schemas, e.g.:
-
-    ```py
-    from pydantic_core import SchemaValidator, core_schema
-
-    schema = core_schema.tuple_positional_schema(
-        [core_schema.int_schema(), core_schema.str_schema()]
-    )
-    v = SchemaValidator(schema)
-    assert v.validate_python((1, 'hello')) == (1, 'hello')
-    ```
-
-    Args:
-        items_schema: The value must be a tuple with items that match these schemas
-        extras_schema: The value must be a tuple with items that match this schema
-            This was inspired by JSON schema's `prefixItems` and `items` fields.
-            In python's `typing.Tuple`, you can't specify a type for "extra" items -- they must all be the same type
-            if the length is variable. So this field won't be set from a `typing.Tuple` annotation on a pydantic model.
-        strict: The value must be a tuple with exactly this many items
-        ref: optional unique identifier of the schema, used to reference the schema in other places
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-        serialization: Custom serialization schema
-    """
-    if extras_schema is not None:
-        variadic_item_index = len(items_schema)
-        items_schema = items_schema + [extras_schema]
-    else:
-        variadic_item_index = None
-    return tuple_schema(
-        items_schema=items_schema,
-        variadic_item_index=variadic_item_index,
-        strict=strict,
-        ref=ref,
-        metadata=metadata,
-        serialization=serialization,
-    )
-
-
-# @deprecated('tuple_variable_schema is deprecated. Use pydantic_core.core_schema.tuple_schema instead.')
-def tuple_variable_schema(
-    items_schema: CoreSchema | None = None,
-    *,
-    min_length: int | None = None,
-    max_length: int | None = None,
-    strict: bool | None = None,
-    ref: str | None = None,
-    metadata: Any = None,
-    serialization: IncExSeqOrElseSerSchema | None = None,
-) -> TupleSchema:
-    """
-    Returns a schema that matches a tuple of a given schema, e.g.:
-
-    ```py
-    from pydantic_core import SchemaValidator, core_schema
-
-    schema = core_schema.tuple_variable_schema(
-        items_schema=core_schema.int_schema(), min_length=0, max_length=10
-    )
-    v = SchemaValidator(schema)
-    assert v.validate_python(('1', 2, 3)) == (1, 2, 3)
-    ```
-
-    Args:
-        items_schema: The value must be a tuple with items that match this schema
-        min_length: The value must be a tuple with at least this many items
-        max_length: The value must be a tuple with at most this many items
-        strict: The value must be a tuple with exactly this many items
-        ref: Optional unique identifier of the schema, used to reference the schema in other places
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-        serialization: Custom serialization schema
-    """
-    return tuple_schema(
-        items_schema=[items_schema or any_schema()],
-        variadic_item_index=0,
-        min_length=min_length,
-        max_length=max_length,
-        strict=strict,
-        ref=ref,
-        metadata=metadata,
-        serialization=serialization,
-    )
-
-
-class TupleSchema(TypedDict, total=False):
-    type: Required[Literal['tuple']]
-    items_schema: Required[List[CoreSchema]]
-    variadic_item_index: int
-    min_length: int
-    max_length: int
-    strict: bool
-    ref: str
-    metadata: Any
-    serialization: IncExSeqOrElseSerSchema
-
-
-def tuple_schema(
-    items_schema: list[CoreSchema],
-    *,
-    variadic_item_index: int | None = None,
-    min_length: int | None = None,
-    max_length: int | None = None,
-    strict: bool | None = None,
-    ref: str | None = None,
-    metadata: Any = None,
-    serialization: IncExSeqOrElseSerSchema | None = None,
-) -> TupleSchema:
-    """
-    Returns a schema that matches a tuple of schemas, with an optional variadic item, e.g.:
-
-    ```py
-    from pydantic_core import SchemaValidator, core_schema
-
-    schema = core_schema.tuple_schema(
-        [core_schema.int_schema(), core_schema.str_schema(), core_schema.float_schema()],
-        variadic_item_index=1,
-    )
-    v = SchemaValidator(schema)
-    assert v.validate_python((1, 'hello', 'world', 1.5)) == (1, 'hello', 'world', 1.5)
-    ```
-
-    Args:
-        items_schema: The value must be a tuple with items that match these schemas
-        variadic_item_index: The index of the schema in `items_schema` to be treated as variadic (following PEP 646)
-        min_length: The value must be a tuple with at least this many items
-        max_length: The value must be a tuple with at most this many items
-        strict: The value must be a tuple with exactly this many items
-        ref: Optional unique identifier of the schema, used to reference the schema in other places
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-        serialization: Custom serialization schema
-    """
-    return _dict_not_none(
-        type='tuple',
-        items_schema=items_schema,
-        variadic_item_index=variadic_item_index,
-        min_length=min_length,
-        max_length=max_length,
-        strict=strict,
-        ref=ref,
-        metadata=metadata,
-        serialization=serialization,
-    )
-
-
-class SetSchema(TypedDict, total=False):
-    type: Required[Literal['set']]
-    items_schema: CoreSchema
-    min_length: int
-    max_length: int
-    strict: bool
-    ref: str
-    metadata: Any
-    serialization: SerSchema
-
-
-def set_schema(
-    items_schema: CoreSchema | None = None,
-    *,
-    min_length: int | None = None,
-    max_length: int | None = None,
-    strict: bool | None = None,
-    ref: str | None = None,
-    metadata: Any = None,
-    serialization: SerSchema | None = None,
-) -> SetSchema:
-    """
-    Returns a schema that matches a set of a given schema, e.g.:
-
-    ```py
-    from pydantic_core import SchemaValidator, core_schema
-
-    schema = core_schema.set_schema(
-        items_schema=core_schema.int_schema(), min_length=0, max_length=10
-    )
-    v = SchemaValidator(schema)
-    assert v.validate_python({1, '2', 3}) == {1, 2, 3}
-    ```
-
-    Args:
-        items_schema: The value must be a set with items that match this schema
-        min_length: The value must be a set with at least this many items
-        max_length: The value must be a set with at most this many items
-        strict: The value must be a set with exactly this many items
-        ref: optional unique identifier of the schema, used to reference the schema in other places
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-        serialization: Custom serialization schema
-    """
-    return _dict_not_none(
-        type='set',
-        items_schema=items_schema,
-        min_length=min_length,
-        max_length=max_length,
-        strict=strict,
-        ref=ref,
-        metadata=metadata,
-        serialization=serialization,
-    )
-
-
-class FrozenSetSchema(TypedDict, total=False):
-    type: Required[Literal['frozenset']]
-    items_schema: CoreSchema
-    min_length: int
-    max_length: int
-    strict: bool
-    ref: str
-    metadata: Any
-    serialization: SerSchema
-
-
-def frozenset_schema(
-    items_schema: CoreSchema | None = None,
-    *,
-    min_length: int | None = None,
-    max_length: int | None = None,
-    strict: bool | None = None,
-    ref: str | None = None,
-    metadata: Any = None,
-    serialization: SerSchema | None = None,
-) -> FrozenSetSchema:
-    """
-    Returns a schema that matches a frozenset of a given schema, e.g.:
-
-    ```py
-    from pydantic_core import SchemaValidator, core_schema
-
-    schema = core_schema.frozenset_schema(
-        items_schema=core_schema.int_schema(), min_length=0, max_length=10
-    )
-    v = SchemaValidator(schema)
-    assert v.validate_python(frozenset(range(3))) == frozenset({0, 1, 2})
-    ```
-
-    Args:
-        items_schema: The value must be a frozenset with items that match this schema
-        min_length: The value must be a frozenset with at least this many items
-        max_length: The value must be a frozenset with at most this many items
-        strict: The value must be a frozenset with exactly this many items
-        ref: optional unique identifier of the schema, used to reference the schema in other places
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-        serialization: Custom serialization schema
-    """
-    return _dict_not_none(
-        type='frozenset',
-        items_schema=items_schema,
-        min_length=min_length,
-        max_length=max_length,
-        strict=strict,
-        ref=ref,
-        metadata=metadata,
-        serialization=serialization,
-    )
-
-
-class GeneratorSchema(TypedDict, total=False):
-    type: Required[Literal['generator']]
-    items_schema: CoreSchema
-    min_length: int
-    max_length: int
-    ref: str
-    metadata: Any
-    serialization: IncExSeqOrElseSerSchema
-
-
-def generator_schema(
-    items_schema: CoreSchema | None = None,
-    *,
-    min_length: int | None = None,
-    max_length: int | None = None,
-    ref: str | None = None,
-    metadata: Any = None,
-    serialization: IncExSeqOrElseSerSchema | None = None,
-) -> GeneratorSchema:
-    """
-    Returns a schema that matches a generator value, e.g.:
-
-    ```py
-    from typing import Iterator
-    from pydantic_core import SchemaValidator, core_schema
-
-    def gen() -> Iterator[int]:
-        yield 1
-
-    schema = core_schema.generator_schema(items_schema=core_schema.int_schema())
-    v = SchemaValidator(schema)
-    v.validate_python(gen())
-    ```
-
-    Unlike other types, validated generators do not raise ValidationErrors eagerly,
-    but instead will raise a ValidationError when a violating value is actually read from the generator.
-    This is to ensure that "validated" generators retain the benefit of lazy evaluation.
-
-    Args:
-        items_schema: The value must be a generator with items that match this schema
-        min_length: The value must be a generator that yields at least this many items
-        max_length: The value must be a generator that yields at most this many items
-        ref: optional unique identifier of the schema, used to reference the schema in other places
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-        serialization: Custom serialization schema
-    """
-    return _dict_not_none(
-        type='generator',
-        items_schema=items_schema,
-        min_length=min_length,
-        max_length=max_length,
-        ref=ref,
-        metadata=metadata,
-        serialization=serialization,
-    )
-
-
-IncExDict = Set[Union[int, str]]
-
-
-class IncExDictSerSchema(TypedDict, total=False):
-    type: Required[Literal['include-exclude-dict']]
-    include: IncExDict
-    exclude: IncExDict
-
-
-def filter_dict_schema(*, include: IncExDict | None = None, exclude: IncExDict | None = None) -> IncExDictSerSchema:
-    return _dict_not_none(type='include-exclude-dict', include=include, exclude=exclude)
-
-
-IncExDictOrElseSerSchema = Union[IncExDictSerSchema, SerSchema]
-
-
-class DictSchema(TypedDict, total=False):
-    type: Required[Literal['dict']]
-    keys_schema: CoreSchema  # default: AnySchema
-    values_schema: CoreSchema  # default: AnySchema
-    min_length: int
-    max_length: int
-    strict: bool
-    ref: str
-    metadata: Any
-    serialization: IncExDictOrElseSerSchema
-
-
-def dict_schema(
-    keys_schema: CoreSchema | None = None,
-    values_schema: CoreSchema | None = None,
-    *,
-    min_length: int | None = None,
-    max_length: int | None = None,
-    strict: bool | None = None,
-    ref: str | None = None,
-    metadata: Any = None,
-    serialization: SerSchema | None = None,
-) -> DictSchema:
-    """
-    Returns a schema that matches a dict value, e.g.:
-
-    ```py
-    from pydantic_core import SchemaValidator, core_schema
-
-    schema = core_schema.dict_schema(
-        keys_schema=core_schema.str_schema(), values_schema=core_schema.int_schema()
-    )
-    v = SchemaValidator(schema)
-    assert v.validate_python({'a': '1', 'b': 2}) == {'a': 1, 'b': 2}
-    ```
-
-    Args:
-        keys_schema: The value must be a dict with keys that match this schema
-        values_schema: The value must be a dict with values that match this schema
-        min_length: The value must be a dict with at least this many items
-        max_length: The value must be a dict with at most this many items
-        strict: Whether the keys and values should be validated with strict mode
-        ref: optional unique identifier of the schema, used to reference the schema in other places
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-        serialization: Custom serialization schema
-    """
-    return _dict_not_none(
-        type='dict',
-        keys_schema=keys_schema,
-        values_schema=values_schema,
-        min_length=min_length,
-        max_length=max_length,
-        strict=strict,
-        ref=ref,
-        metadata=metadata,
-        serialization=serialization,
-    )
-
-
-# (__input_value: Any) -> Any
-NoInfoValidatorFunction = Callable[[Any], Any]
-
-
-class NoInfoValidatorFunctionSchema(TypedDict):
-    type: Literal['no-info']
-    function: NoInfoValidatorFunction
-
-
-# (__input_value: Any, __info: ValidationInfo) -> Any
-WithInfoValidatorFunction = Callable[[Any, ValidationInfo], Any]
-
-
-class WithInfoValidatorFunctionSchema(TypedDict, total=False):
-    type: Required[Literal['with-info']]
-    function: Required[WithInfoValidatorFunction]
-    field_name: str
-
-
-ValidationFunction = Union[NoInfoValidatorFunctionSchema, WithInfoValidatorFunctionSchema]
-
-
-class _ValidatorFunctionSchema(TypedDict, total=False):
-    function: Required[ValidationFunction]
-    schema: Required[CoreSchema]
-    ref: str
-    metadata: Any
-    serialization: SerSchema
-
-
-class BeforeValidatorFunctionSchema(_ValidatorFunctionSchema, total=False):
-    type: Required[Literal['function-before']]
-
-
-def no_info_before_validator_function(
-    function: NoInfoValidatorFunction,
-    schema: CoreSchema,
-    *,
-    ref: str | None = None,
-    metadata: Any = None,
-    serialization: SerSchema | None = None,
-) -> BeforeValidatorFunctionSchema:
-    """
-    Returns a schema that calls a validator function before validating, no `info` argument is provided, e.g.:
-
-    ```py
-    from pydantic_core import SchemaValidator, core_schema
-
-    def fn(v: bytes) -> str:
-        return v.decode() + 'world'
-
-    func_schema = core_schema.no_info_before_validator_function(
-        function=fn, schema=core_schema.str_schema()
-    )
-    schema = core_schema.typed_dict_schema({'a': core_schema.typed_dict_field(func_schema)})
-
-    v = SchemaValidator(schema)
-    assert v.validate_python({'a': b'hello '}) == {'a': 'hello world'}
-    ```
-
-    Args:
-        function: The validator function to call
-        schema: The schema to validate the output of the validator function
-        ref: optional unique identifier of the schema, used to reference the schema in other places
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-        serialization: Custom serialization schema
-    """
-    return _dict_not_none(
-        type='function-before',
-        function={'type': 'no-info', 'function': function},
-        schema=schema,
-        ref=ref,
-        metadata=metadata,
-        serialization=serialization,
-    )
-
-
-def with_info_before_validator_function(
-    function: WithInfoValidatorFunction,
-    schema: CoreSchema,
-    *,
-    field_name: str | None = None,
-    ref: str | None = None,
-    metadata: Any = None,
-    serialization: SerSchema | None = None,
-) -> BeforeValidatorFunctionSchema:
-    """
-    Returns a schema that calls a validator function before validation, the function is called with
-    an `info` argument, e.g.:
-
-    ```py
-    from pydantic_core import SchemaValidator, core_schema
-
-    def fn(v: bytes, info: core_schema.ValidationInfo) -> str:
-        assert info.data is not None
-        assert info.field_name is not None
-        return v.decode() + 'world'
-
-    func_schema = core_schema.with_info_before_validator_function(
-        function=fn, schema=core_schema.str_schema(), field_name='a'
-    )
-    schema = core_schema.typed_dict_schema({'a': core_schema.typed_dict_field(func_schema)})
-
-    v = SchemaValidator(schema)
-    assert v.validate_python({'a': b'hello '}) == {'a': 'hello world'}
-    ```
-
-    Args:
-        function: The validator function to call
-        field_name: The name of the field
-        schema: The schema to validate the output of the validator function
-        ref: optional unique identifier of the schema, used to reference the schema in other places
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-        serialization: Custom serialization schema
-    """
-    return _dict_not_none(
-        type='function-before',
-        function=_dict_not_none(type='with-info', function=function, field_name=field_name),
-        schema=schema,
-        ref=ref,
-        metadata=metadata,
-        serialization=serialization,
-    )
-
-
-class AfterValidatorFunctionSchema(_ValidatorFunctionSchema, total=False):
-    type: Required[Literal['function-after']]
-
-
-def no_info_after_validator_function(
-    function: NoInfoValidatorFunction,
-    schema: CoreSchema,
-    *,
-    ref: str | None = None,
-    metadata: Any = None,
-    serialization: SerSchema | None = None,
-) -> AfterValidatorFunctionSchema:
-    """
-    Returns a schema that calls a validator function after validating, no `info` argument is provided, e.g.:
-
-    ```py
-    from pydantic_core import SchemaValidator, core_schema
-
-    def fn(v: str) -> str:
-        return v + 'world'
-
-    func_schema = core_schema.no_info_after_validator_function(fn, core_schema.str_schema())
-    schema = core_schema.typed_dict_schema({'a': core_schema.typed_dict_field(func_schema)})
-
-    v = SchemaValidator(schema)
-    assert v.validate_python({'a': b'hello '}) == {'a': 'hello world'}
-    ```
-
-    Args:
-        function: The validator function to call after the schema is validated
-        schema: The schema to validate before the validator function
-        ref: optional unique identifier of the schema, used to reference the schema in other places
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-        serialization: Custom serialization schema
-    """
-    return _dict_not_none(
-        type='function-after',
-        function={'type': 'no-info', 'function': function},
-        schema=schema,
-        ref=ref,
-        metadata=metadata,
-        serialization=serialization,
-    )
-
-
-def with_info_after_validator_function(
-    function: WithInfoValidatorFunction,
-    schema: CoreSchema,
-    *,
-    field_name: str | None = None,
-    ref: str | None = None,
-    metadata: Any = None,
-    serialization: SerSchema | None = None,
-) -> AfterValidatorFunctionSchema:
-    """
-    Returns a schema that calls a validator function after validation, the function is called with
-    an `info` argument, e.g.:
-
-    ```py
-    from pydantic_core import SchemaValidator, core_schema
-
-    def fn(v: str, info: core_schema.ValidationInfo) -> str:
-        assert info.data is not None
-        assert info.field_name is not None
-        return v + 'world'
-
-    func_schema = core_schema.with_info_after_validator_function(
-        function=fn, schema=core_schema.str_schema(), field_name='a'
-    )
-    schema = core_schema.typed_dict_schema({'a': core_schema.typed_dict_field(func_schema)})
-
-    v = SchemaValidator(schema)
-    assert v.validate_python({'a': b'hello '}) == {'a': 'hello world'}
-    ```
-
-    Args:
-        function: The validator function to call after the schema is validated
-        schema: The schema to validate before the validator function
-        field_name: The name of the field this validators is applied to, if any
-        ref: optional unique identifier of the schema, used to reference the schema in other places
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-        serialization: Custom serialization schema
-    """
-    return _dict_not_none(
-        type='function-after',
-        function=_dict_not_none(type='with-info', function=function, field_name=field_name),
-        schema=schema,
-        ref=ref,
-        metadata=metadata,
-        serialization=serialization,
-    )
-
-
-class ValidatorFunctionWrapHandler(Protocol):
-    def __call__(self, input_value: Any, outer_location: str | int | None = None) -> Any:  # pragma: no cover
-        ...
-
-
-# (__input_value: Any, __validator: ValidatorFunctionWrapHandler) -> Any
-NoInfoWrapValidatorFunction = Callable[[Any, ValidatorFunctionWrapHandler], Any]
-
-
-class NoInfoWrapValidatorFunctionSchema(TypedDict):
-    type: Literal['no-info']
-    function: NoInfoWrapValidatorFunction
-
-
-# (__input_value: Any, __validator: ValidatorFunctionWrapHandler, __info: ValidationInfo) -> Any
-WithInfoWrapValidatorFunction = Callable[[Any, ValidatorFunctionWrapHandler, ValidationInfo], Any]
-
-
-class WithInfoWrapValidatorFunctionSchema(TypedDict, total=False):
-    type: Required[Literal['with-info']]
-    function: Required[WithInfoWrapValidatorFunction]
-    field_name: str
-
-
-WrapValidatorFunction = Union[NoInfoWrapValidatorFunctionSchema, WithInfoWrapValidatorFunctionSchema]
-
-
-class WrapValidatorFunctionSchema(TypedDict, total=False):
-    type: Required[Literal['function-wrap']]
-    function: Required[WrapValidatorFunction]
-    schema: Required[CoreSchema]
-    ref: str
-    metadata: Any
-    serialization: SerSchema
-
-
-def no_info_wrap_validator_function(
-    function: NoInfoWrapValidatorFunction,
-    schema: CoreSchema,
-    *,
-    ref: str | None = None,
-    metadata: Any = None,
-    serialization: SerSchema | None = None,
-) -> WrapValidatorFunctionSchema:
-    """
-    Returns a schema which calls a function with a `validator` callable argument which can
-    optionally be used to call inner validation with the function logic, this is much like the
-    "onion" implementation of middleware in many popular web frameworks, no `info` argument is passed, e.g.:
-
-    ```py
-    from pydantic_core import SchemaValidator, core_schema
-
-    def fn(
-        v: str,
-        validator: core_schema.ValidatorFunctionWrapHandler,
-    ) -> str:
-        return validator(input_value=v) + 'world'
-
-    schema = core_schema.no_info_wrap_validator_function(
-        function=fn, schema=core_schema.str_schema()
-    )
-    v = SchemaValidator(schema)
-    assert v.validate_python('hello ') == 'hello world'
-    ```
-
-    Args:
-        function: The validator function to call
-        schema: The schema to validate the output of the validator function
-        ref: optional unique identifier of the schema, used to reference the schema in other places
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-        serialization: Custom serialization schema
-    """
-    return _dict_not_none(
-        type='function-wrap',
-        function={'type': 'no-info', 'function': function},
-        schema=schema,
-        ref=ref,
-        metadata=metadata,
-        serialization=serialization,
-    )
-
-
-def with_info_wrap_validator_function(
-    function: WithInfoWrapValidatorFunction,
-    schema: CoreSchema,
-    *,
-    field_name: str | None = None,
-    ref: str | None = None,
-    metadata: Any = None,
-    serialization: SerSchema | None = None,
-) -> WrapValidatorFunctionSchema:
-    """
-    Returns a schema which calls a function with a `validator` callable argument which can
-    optionally be used to call inner validation with the function logic, this is much like the
-    "onion" implementation of middleware in many popular web frameworks, an `info` argument is also passed, e.g.:
-
-    ```py
-    from pydantic_core import SchemaValidator, core_schema
-
-    def fn(
-        v: str,
-        validator: core_schema.ValidatorFunctionWrapHandler,
-        info: core_schema.ValidationInfo,
-    ) -> str:
-        return validator(input_value=v) + 'world'
-
-    schema = core_schema.with_info_wrap_validator_function(
-        function=fn, schema=core_schema.str_schema()
-    )
-    v = SchemaValidator(schema)
-    assert v.validate_python('hello ') == 'hello world'
-    ```
-
-    Args:
-        function: The validator function to call
-        schema: The schema to validate the output of the validator function
-        field_name: The name of the field this validators is applied to, if any
-        ref: optional unique identifier of the schema, used to reference the schema in other places
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-        serialization: Custom serialization schema
-    """
-    return _dict_not_none(
-        type='function-wrap',
-        function=_dict_not_none(type='with-info', function=function, field_name=field_name),
-        schema=schema,
-        ref=ref,
-        metadata=metadata,
-        serialization=serialization,
-    )
-
-
-class PlainValidatorFunctionSchema(TypedDict, total=False):
-    type: Required[Literal['function-plain']]
-    function: Required[ValidationFunction]
-    ref: str
-    metadata: Any
-    serialization: SerSchema
-
-
-def no_info_plain_validator_function(
-    function: NoInfoValidatorFunction,
-    *,
-    ref: str | None = None,
-    metadata: Any = None,
-    serialization: SerSchema | None = None,
-) -> PlainValidatorFunctionSchema:
-    """
-    Returns a schema that uses the provided function for validation, no `info` argument is passed, e.g.:
-
-    ```py
-    from pydantic_core import SchemaValidator, core_schema
-
-    def fn(v: str) -> str:
-        assert 'hello' in v
-        return v + 'world'
-
-    schema = core_schema.no_info_plain_validator_function(function=fn)
-    v = SchemaValidator(schema)
-    assert v.validate_python('hello ') == 'hello world'
-    ```
-
-    Args:
-        function: The validator function to call
-        ref: optional unique identifier of the schema, used to reference the schema in other places
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-        serialization: Custom serialization schema
-    """
-    return _dict_not_none(
-        type='function-plain',
-        function={'type': 'no-info', 'function': function},
-        ref=ref,
-        metadata=metadata,
-        serialization=serialization,
-    )
-
-
-def with_info_plain_validator_function(
-    function: WithInfoValidatorFunction,
-    *,
-    field_name: str | None = None,
-    ref: str | None = None,
-    metadata: Any = None,
-    serialization: SerSchema | None = None,
-) -> PlainValidatorFunctionSchema:
-    """
-    Returns a schema that uses the provided function for validation, an `info` argument is passed, e.g.:
-
-    ```py
-    from pydantic_core import SchemaValidator, core_schema
-
-    def fn(v: str, info: core_schema.ValidationInfo) -> str:
-        assert 'hello' in v
-        return v + 'world'
-
-    schema = core_schema.with_info_plain_validator_function(function=fn)
-    v = SchemaValidator(schema)
-    assert v.validate_python('hello ') == 'hello world'
-    ```
-
-    Args:
-        function: The validator function to call
-        field_name: The name of the field this validators is applied to, if any
-        ref: optional unique identifier of the schema, used to reference the schema in other places
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-        serialization: Custom serialization schema
-    """
-    return _dict_not_none(
-        type='function-plain',
-        function=_dict_not_none(type='with-info', function=function, field_name=field_name),
-        ref=ref,
-        metadata=metadata,
-        serialization=serialization,
-    )
-
-
-class WithDefaultSchema(TypedDict, total=False):
-    type: Required[Literal['default']]
-    schema: Required[CoreSchema]
-    default: Any
-    default_factory: Callable[[], Any]
-    on_error: Literal['raise', 'omit', 'default']  # default: 'raise'
-    validate_default: bool  # default: False
-    strict: bool
-    ref: str
-    metadata: Any
-    serialization: SerSchema
-
-
-def with_default_schema(
-    schema: CoreSchema,
-    *,
-    default: Any = PydanticUndefined,
-    default_factory: Callable[[], Any] | None = None,
-    on_error: Literal['raise', 'omit', 'default'] | None = None,
-    validate_default: bool | None = None,
-    strict: bool | None = None,
-    ref: str | None = None,
-    metadata: Any = None,
-    serialization: SerSchema | None = None,
-) -> WithDefaultSchema:
-    """
-    Returns a schema that adds a default value to the given schema, e.g.:
-
-    ```py
-    from pydantic_core import SchemaValidator, core_schema
-
-    schema = core_schema.with_default_schema(core_schema.str_schema(), default='hello')
-    wrapper_schema = core_schema.typed_dict_schema(
-        {'a': core_schema.typed_dict_field(schema)}
-    )
-    v = SchemaValidator(wrapper_schema)
-    assert v.validate_python({}) == v.validate_python({'a': 'hello'})
-    ```
-
-    Args:
-        schema: The schema to add a default value to
-        default: The default value to use
-        default_factory: A function that returns the default value to use
-        on_error: What to do if the schema validation fails. One of 'raise', 'omit', 'default'
-        validate_default: Whether the default value should be validated
-        strict: Whether the underlying schema should be validated with strict mode
-        ref: optional unique identifier of the schema, used to reference the schema in other places
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-        serialization: Custom serialization schema
-    """
-    s = _dict_not_none(
-        type='default',
-        schema=schema,
-        default_factory=default_factory,
-        on_error=on_error,
-        validate_default=validate_default,
-        strict=strict,
-        ref=ref,
-        metadata=metadata,
-        serialization=serialization,
-    )
-    if default is not PydanticUndefined:
-        s['default'] = default
-    return s
-
-
-class NullableSchema(TypedDict, total=False):
-    type: Required[Literal['nullable']]
-    schema: Required[CoreSchema]
-    strict: bool
-    ref: str
-    metadata: Any
-    serialization: SerSchema
-
-
-def nullable_schema(
-    schema: CoreSchema,
-    *,
-    strict: bool | None = None,
-    ref: str | None = None,
-    metadata: Any = None,
-    serialization: SerSchema | None = None,
-) -> NullableSchema:
-    """
-    Returns a schema that matches a nullable value, e.g.:
-
-    ```py
-    from pydantic_core import SchemaValidator, core_schema
-
-    schema = core_schema.nullable_schema(core_schema.str_schema())
-    v = SchemaValidator(schema)
-    assert v.validate_python(None) is None
-    ```
-
-    Args:
-        schema: The schema to wrap
-        strict: Whether the underlying schema should be validated with strict mode
-        ref: optional unique identifier of the schema, used to reference the schema in other places
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-        serialization: Custom serialization schema
-    """
-    return _dict_not_none(
-        type='nullable', schema=schema, strict=strict, ref=ref, metadata=metadata, serialization=serialization
-    )
-
-
-class UnionSchema(TypedDict, total=False):
-    type: Required[Literal['union']]
-    choices: Required[List[Union[CoreSchema, Tuple[CoreSchema, str]]]]
-    # default true, whether to automatically collapse unions with one element to the inner validator
-    auto_collapse: bool
-    custom_error_type: str
-    custom_error_message: str
-    custom_error_context: Dict[str, Union[str, int, float]]
-    mode: Literal['smart', 'left_to_right']  # default: 'smart'
-    strict: bool
-    ref: str
-    metadata: Any
-    serialization: SerSchema
-
-
-def union_schema(
-    choices: list[CoreSchema | tuple[CoreSchema, str]],
-    *,
-    auto_collapse: bool | None = None,
-    custom_error_type: str | None = None,
-    custom_error_message: str | None = None,
-    custom_error_context: dict[str, str | int] | None = None,
-    mode: Literal['smart', 'left_to_right'] | None = None,
-    strict: bool | None = None,
-    ref: str | None = None,
-    metadata: Any = None,
-    serialization: SerSchema | None = None,
-) -> UnionSchema:
-    """
-    Returns a schema that matches a union value, e.g.:
-
-    ```py
-    from pydantic_core import SchemaValidator, core_schema
-
-    schema = core_schema.union_schema([core_schema.str_schema(), core_schema.int_schema()])
-    v = SchemaValidator(schema)
-    assert v.validate_python('hello') == 'hello'
-    assert v.validate_python(1) == 1
-    ```
-
-    Args:
-        choices: The schemas to match. If a tuple, the second item is used as the label for the case.
-        auto_collapse: whether to automatically collapse unions with one element to the inner validator, default true
-        custom_error_type: The custom error type to use if the validation fails
-        custom_error_message: The custom error message to use if the validation fails
-        custom_error_context: The custom error context to use if the validation fails
-        mode: How to select which choice to return
-            * `smart` (default) will try to return the choice which is the closest match to the input value
-            * `left_to_right` will return the first choice in `choices` which succeeds validation
-        strict: Whether the underlying schemas should be validated with strict mode
-        ref: optional unique identifier of the schema, used to reference the schema in other places
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-        serialization: Custom serialization schema
-    """
-    return _dict_not_none(
-        type='union',
-        choices=choices,
-        auto_collapse=auto_collapse,
-        custom_error_type=custom_error_type,
-        custom_error_message=custom_error_message,
-        custom_error_context=custom_error_context,
-        mode=mode,
-        strict=strict,
-        ref=ref,
-        metadata=metadata,
-        serialization=serialization,
-    )
-
-
-class TaggedUnionSchema(TypedDict, total=False):
-    type: Required[Literal['tagged-union']]
-    choices: Required[Dict[Hashable, CoreSchema]]
-    discriminator: Required[Union[str, List[Union[str, int]], List[List[Union[str, int]]], Callable[[Any], Hashable]]]
-    custom_error_type: str
-    custom_error_message: str
-    custom_error_context: Dict[str, Union[str, int, float]]
-    strict: bool
-    from_attributes: bool  # default: True
-    ref: str
-    metadata: Any
-    serialization: SerSchema
-
-
-def tagged_union_schema(
-    choices: Dict[Hashable, CoreSchema],
-    discriminator: str | list[str | int] | list[list[str | int]] | Callable[[Any], Hashable],
-    *,
-    custom_error_type: str | None = None,
-    custom_error_message: str | None = None,
-    custom_error_context: dict[str, int | str | float] | None = None,
-    strict: bool | None = None,
-    from_attributes: bool | None = None,
-    ref: str | None = None,
-    metadata: Any = None,
-    serialization: SerSchema | None = None,
-) -> TaggedUnionSchema:
-    """
-    Returns a schema that matches a tagged union value, e.g.:
-
-    ```py
-    from pydantic_core import SchemaValidator, core_schema
-
-    apple_schema = core_schema.typed_dict_schema(
-        {
-            'foo': core_schema.typed_dict_field(core_schema.str_schema()),
-            'bar': core_schema.typed_dict_field(core_schema.int_schema()),
-        }
-    )
-    banana_schema = core_schema.typed_dict_schema(
-        {
-            'foo': core_schema.typed_dict_field(core_schema.str_schema()),
-            'spam': core_schema.typed_dict_field(
-                core_schema.list_schema(items_schema=core_schema.int_schema())
-            ),
-        }
-    )
-    schema = core_schema.tagged_union_schema(
-        choices={
-            'apple': apple_schema,
-            'banana': banana_schema,
-        },
-        discriminator='foo',
-    )
-    v = SchemaValidator(schema)
-    assert v.validate_python({'foo': 'apple', 'bar': '123'}) == {'foo': 'apple', 'bar': 123}
-    assert v.validate_python({'foo': 'banana', 'spam': [1, 2, 3]}) == {
-        'foo': 'banana',
-        'spam': [1, 2, 3],
-    }
-    ```
-
-    Args:
-        choices: The schemas to match
-            When retrieving a schema from `choices` using the discriminator value, if the value is a str,
-            it should be fed back into the `choices` map until a schema is obtained
-            (This approach is to prevent multiple ownership of a single schema in Rust)
-        discriminator: The discriminator to use to determine the schema to use
-            * If `discriminator` is a str, it is the name of the attribute to use as the discriminator
-            * If `discriminator` is a list of int/str, it should be used as a "path" to access the discriminator
-            * If `discriminator` is a list of lists, each inner list is a path, and the first path that exists is used
-            * If `discriminator` is a callable, it should return the discriminator when called on the value to validate;
-              the callable can return `None` to indicate that there is no matching discriminator present on the input
-        custom_error_type: The custom error type to use if the validation fails
-        custom_error_message: The custom error message to use if the validation fails
-        custom_error_context: The custom error context to use if the validation fails
-        strict: Whether the underlying schemas should be validated with strict mode
-        from_attributes: Whether to use the attributes of the object to retrieve the discriminator value
-        ref: optional unique identifier of the schema, used to reference the schema in other places
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-        serialization: Custom serialization schema
-    """
-    return _dict_not_none(
-        type='tagged-union',
-        choices=choices,
-        discriminator=discriminator,
-        custom_error_type=custom_error_type,
-        custom_error_message=custom_error_message,
-        custom_error_context=custom_error_context,
-        strict=strict,
-        from_attributes=from_attributes,
-        ref=ref,
-        metadata=metadata,
-        serialization=serialization,
-    )
-
-
-class ChainSchema(TypedDict, total=False):
-    type: Required[Literal['chain']]
-    steps: Required[List[CoreSchema]]
-    ref: str
-    metadata: Any
-    serialization: SerSchema
-
-
-def chain_schema(
-    steps: list[CoreSchema], *, ref: str | None = None, metadata: Any = None, serialization: SerSchema | None = None
-) -> ChainSchema:
-    """
-    Returns a schema that chains the provided validation schemas, e.g.:
-
-    ```py
-    from pydantic_core import SchemaValidator, core_schema
-
-    def fn(v: str, info: core_schema.ValidationInfo) -> str:
-        assert 'hello' in v
-        return v + ' world'
-
-    fn_schema = core_schema.with_info_plain_validator_function(function=fn)
-    schema = core_schema.chain_schema(
-        [fn_schema, fn_schema, fn_schema, core_schema.str_schema()]
-    )
-    v = SchemaValidator(schema)
-    assert v.validate_python('hello') == 'hello world world world'
-    ```
-
-    Args:
-        steps: The schemas to chain
-        ref: optional unique identifier of the schema, used to reference the schema in other places
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-        serialization: Custom serialization schema
-    """
-    return _dict_not_none(type='chain', steps=steps, ref=ref, metadata=metadata, serialization=serialization)
-
-
-class LaxOrStrictSchema(TypedDict, total=False):
-    type: Required[Literal['lax-or-strict']]
-    lax_schema: Required[CoreSchema]
-    strict_schema: Required[CoreSchema]
-    strict: bool
-    ref: str
-    metadata: Any
-    serialization: SerSchema
-
-
-def lax_or_strict_schema(
-    lax_schema: CoreSchema,
-    strict_schema: CoreSchema,
-    *,
-    strict: bool | None = None,
-    ref: str | None = None,
-    metadata: Any = None,
-    serialization: SerSchema | None = None,
-) -> LaxOrStrictSchema:
-    """
-    Returns a schema that uses the lax or strict schema, e.g.:
-
-    ```py
-    from pydantic_core import SchemaValidator, core_schema
-
-    def fn(v: str, info: core_schema.ValidationInfo) -> str:
-        assert 'hello' in v
-        return v + ' world'
-
-    lax_schema = core_schema.int_schema(strict=False)
-    strict_schema = core_schema.int_schema(strict=True)
-
-    schema = core_schema.lax_or_strict_schema(
-        lax_schema=lax_schema, strict_schema=strict_schema, strict=True
-    )
-    v = SchemaValidator(schema)
-    assert v.validate_python(123) == 123
-
-    schema = core_schema.lax_or_strict_schema(
-        lax_schema=lax_schema, strict_schema=strict_schema, strict=False
-    )
-    v = SchemaValidator(schema)
-    assert v.validate_python('123') == 123
-    ```
-
-    Args:
-        lax_schema: The lax schema to use
-        strict_schema: The strict schema to use
-        strict: Whether the strict schema should be used
-        ref: optional unique identifier of the schema, used to reference the schema in other places
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-        serialization: Custom serialization schema
-    """
-    return _dict_not_none(
-        type='lax-or-strict',
-        lax_schema=lax_schema,
-        strict_schema=strict_schema,
-        strict=strict,
-        ref=ref,
-        metadata=metadata,
-        serialization=serialization,
-    )
-
-
-class JsonOrPythonSchema(TypedDict, total=False):
-    type: Required[Literal['json-or-python']]
-    json_schema: Required[CoreSchema]
-    python_schema: Required[CoreSchema]
-    ref: str
-    metadata: Any
-    serialization: SerSchema
-
-
-def json_or_python_schema(
-    json_schema: CoreSchema,
-    python_schema: CoreSchema,
-    *,
-    ref: str | None = None,
-    metadata: Any = None,
-    serialization: SerSchema | None = None,
-) -> JsonOrPythonSchema:
-    """
-    Returns a schema that uses the Json or Python schema depending on the input:
-
-    ```py
-    from pydantic_core import SchemaValidator, ValidationError, core_schema
-
-    v = SchemaValidator(
-        core_schema.json_or_python_schema(
-            json_schema=core_schema.int_schema(),
-            python_schema=core_schema.int_schema(strict=True),
-        )
-    )
-
-    assert v.validate_json('"123"') == 123
-
-    try:
-        v.validate_python('123')
-    except ValidationError:
-        pass
-    else:
-        raise AssertionError('Validation should have failed')
-    ```
-
-    Args:
-        json_schema: The schema to use for Json inputs
-        python_schema: The schema to use for Python inputs
-        ref: optional unique identifier of the schema, used to reference the schema in other places
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-        serialization: Custom serialization schema
-    """
-    return _dict_not_none(
-        type='json-or-python',
-        json_schema=json_schema,
-        python_schema=python_schema,
-        ref=ref,
-        metadata=metadata,
-        serialization=serialization,
-    )
-
-
-class TypedDictField(TypedDict, total=False):
-    type: Required[Literal['typed-dict-field']]
-    schema: Required[CoreSchema]
-    required: bool
-    validation_alias: Union[str, List[Union[str, int]], List[List[Union[str, int]]]]
-    serialization_alias: str
-    serialization_exclude: bool  # default: False
-    metadata: Any
-
-
-def typed_dict_field(
-    schema: CoreSchema,
-    *,
-    required: bool | None = None,
-    validation_alias: str | list[str | int] | list[list[str | int]] | None = None,
-    serialization_alias: str | None = None,
-    serialization_exclude: bool | None = None,
-    metadata: Any = None,
-) -> TypedDictField:
-    """
-    Returns a schema that matches a typed dict field, e.g.:
-
-    ```py
-    from pydantic_core import core_schema
-
-    field = core_schema.typed_dict_field(schema=core_schema.int_schema(), required=True)
-    ```
-
-    Args:
-        schema: The schema to use for the field
-        required: Whether the field is required
-        validation_alias: The alias(es) to use to find the field in the validation data
-        serialization_alias: The alias to use as a key when serializing
-        serialization_exclude: Whether to exclude the field when serializing
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-    """
-    return _dict_not_none(
-        type='typed-dict-field',
-        schema=schema,
-        required=required,
-        validation_alias=validation_alias,
-        serialization_alias=serialization_alias,
-        serialization_exclude=serialization_exclude,
-        metadata=metadata,
-    )
-
-
-class TypedDictSchema(TypedDict, total=False):
-    type: Required[Literal['typed-dict']]
-    fields: Required[Dict[str, TypedDictField]]
-    computed_fields: List[ComputedField]
-    strict: bool
-    extras_schema: CoreSchema
-    # all these values can be set via config, equivalent fields have `typed_dict_` prefix
-    extra_behavior: ExtraBehavior
-    total: bool  # default: True
-    populate_by_name: bool  # replaces `allow_population_by_field_name` in pydantic v1
-    ref: str
-    metadata: Any
-    serialization: SerSchema
-    config: CoreConfig
-
-
-def typed_dict_schema(
-    fields: Dict[str, TypedDictField],
-    *,
-    computed_fields: list[ComputedField] | None = None,
-    strict: bool | None = None,
-    extras_schema: CoreSchema | None = None,
-    extra_behavior: ExtraBehavior | None = None,
-    total: bool | None = None,
-    populate_by_name: bool | None = None,
-    ref: str | None = None,
-    metadata: Any = None,
-    serialization: SerSchema | None = None,
-    config: CoreConfig | None = None,
-) -> TypedDictSchema:
-    """
-    Returns a schema that matches a typed dict, e.g.:
-
-    ```py
-    from pydantic_core import SchemaValidator, core_schema
-
-    wrapper_schema = core_schema.typed_dict_schema(
-        {'a': core_schema.typed_dict_field(core_schema.str_schema())}
-    )
-    v = SchemaValidator(wrapper_schema)
-    assert v.validate_python({'a': 'hello'}) == {'a': 'hello'}
-    ```
-
-    Args:
-        fields: The fields to use for the typed dict
-        computed_fields: Computed fields to use when serializing the model, only applies when directly inside a model
-        strict: Whether the typed dict is strict
-        extras_schema: The extra validator to use for the typed dict
-        ref: optional unique identifier of the schema, used to reference the schema in other places
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-        extra_behavior: The extra behavior to use for the typed dict
-        total: Whether the typed dict is total
-        populate_by_name: Whether the typed dict should populate by name
-        serialization: Custom serialization schema
-    """
-    return _dict_not_none(
-        type='typed-dict',
-        fields=fields,
-        computed_fields=computed_fields,
-        strict=strict,
-        extras_schema=extras_schema,
-        extra_behavior=extra_behavior,
-        total=total,
-        populate_by_name=populate_by_name,
-        ref=ref,
-        metadata=metadata,
-        serialization=serialization,
-        config=config,
-    )
-
-
-class ModelField(TypedDict, total=False):
-    type: Required[Literal['model-field']]
-    schema: Required[CoreSchema]
-    validation_alias: Union[str, List[Union[str, int]], List[List[Union[str, int]]]]
-    serialization_alias: str
-    serialization_exclude: bool  # default: False
-    frozen: bool
-    metadata: Any
-
-
-def model_field(
-    schema: CoreSchema,
-    *,
-    validation_alias: str | list[str | int] | list[list[str | int]] | None = None,
-    serialization_alias: str | None = None,
-    serialization_exclude: bool | None = None,
-    frozen: bool | None = None,
-    metadata: Any = None,
-) -> ModelField:
-    """
-    Returns a schema for a model field, e.g.:
-
-    ```py
-    from pydantic_core import core_schema
-
-    field = core_schema.model_field(schema=core_schema.int_schema())
-    ```
-
-    Args:
-        schema: The schema to use for the field
-        validation_alias: The alias(es) to use to find the field in the validation data
-        serialization_alias: The alias to use as a key when serializing
-        serialization_exclude: Whether to exclude the field when serializing
-        frozen: Whether the field is frozen
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-    """
-    return _dict_not_none(
-        type='model-field',
-        schema=schema,
-        validation_alias=validation_alias,
-        serialization_alias=serialization_alias,
-        serialization_exclude=serialization_exclude,
-        frozen=frozen,
-        metadata=metadata,
-    )
-
-
-class ModelFieldsSchema(TypedDict, total=False):
-    type: Required[Literal['model-fields']]
-    fields: Required[Dict[str, ModelField]]
-    model_name: str
-    computed_fields: List[ComputedField]
-    strict: bool
-    extras_schema: CoreSchema
-    # all these values can be set via config, equivalent fields have `typed_dict_` prefix
-    extra_behavior: ExtraBehavior
-    populate_by_name: bool  # replaces `allow_population_by_field_name` in pydantic v1
-    from_attributes: bool
-    ref: str
-    metadata: Any
-    serialization: SerSchema
-
-
-def model_fields_schema(
-    fields: Dict[str, ModelField],
-    *,
-    model_name: str | None = None,
-    computed_fields: list[ComputedField] | None = None,
-    strict: bool | None = None,
-    extras_schema: CoreSchema | None = None,
-    extra_behavior: ExtraBehavior | None = None,
-    populate_by_name: bool | None = None,
-    from_attributes: bool | None = None,
-    ref: str | None = None,
-    metadata: Any = None,
-    serialization: SerSchema | None = None,
-) -> ModelFieldsSchema:
-    """
-    Returns a schema that matches a typed dict, e.g.:
-
-    ```py
-    from pydantic_core import SchemaValidator, core_schema
-
-    wrapper_schema = core_schema.model_fields_schema(
-        {'a': core_schema.model_field(core_schema.str_schema())}
-    )
-    v = SchemaValidator(wrapper_schema)
-    print(v.validate_python({'a': 'hello'}))
-    #> ({'a': 'hello'}, None, {'a'})
-    ```
-
-    Args:
-        fields: The fields to use for the typed dict
-        model_name: The name of the model, used for error messages, defaults to "Model"
-        computed_fields: Computed fields to use when serializing the model, only applies when directly inside a model
-        strict: Whether the typed dict is strict
-        extras_schema: The extra validator to use for the typed dict
-        ref: optional unique identifier of the schema, used to reference the schema in other places
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-        extra_behavior: The extra behavior to use for the typed dict
-        populate_by_name: Whether the typed dict should populate by name
-        from_attributes: Whether the typed dict should be populated from attributes
-        serialization: Custom serialization schema
-    """
-    return _dict_not_none(
-        type='model-fields',
-        fields=fields,
-        model_name=model_name,
-        computed_fields=computed_fields,
-        strict=strict,
-        extras_schema=extras_schema,
-        extra_behavior=extra_behavior,
-        populate_by_name=populate_by_name,
-        from_attributes=from_attributes,
-        ref=ref,
-        metadata=metadata,
-        serialization=serialization,
-    )
-
-
-class ModelSchema(TypedDict, total=False):
-    type: Required[Literal['model']]
-    cls: Required[Type[Any]]
-    schema: Required[CoreSchema]
-    custom_init: bool
-    root_model: bool
-    post_init: str
-    revalidate_instances: Literal['always', 'never', 'subclass-instances']  # default: 'never'
-    strict: bool
-    frozen: bool
-    extra_behavior: ExtraBehavior
-    config: CoreConfig
-    ref: str
-    metadata: Any
-    serialization: SerSchema
-
-
-def model_schema(
-    cls: Type[Any],
-    schema: CoreSchema,
-    *,
-    custom_init: bool | None = None,
-    root_model: bool | None = None,
-    post_init: str | None = None,
-    revalidate_instances: Literal['always', 'never', 'subclass-instances'] | None = None,
-    strict: bool | None = None,
-    frozen: bool | None = None,
-    extra_behavior: ExtraBehavior | None = None,
-    config: CoreConfig | None = None,
-    ref: str | None = None,
-    metadata: Any = None,
-    serialization: SerSchema | None = None,
-) -> ModelSchema:
-    """
-    A model schema generally contains a typed-dict schema.
-    It will run the typed dict validator, then create a new class
-    and set the dict and fields set returned from the typed dict validator
-    to `__dict__` and `__pydantic_fields_set__` respectively.
-
-    Example:
-
-    ```py
-    from pydantic_core import CoreConfig, SchemaValidator, core_schema
-
-    class MyModel:
-        __slots__ = (
-            '__dict__',
-            '__pydantic_fields_set__',
-            '__pydantic_extra__',
-            '__pydantic_private__',
-        )
-
-    schema = core_schema.model_schema(
-        cls=MyModel,
-        config=CoreConfig(str_max_length=5),
-        schema=core_schema.model_fields_schema(
-            fields={'a': core_schema.model_field(core_schema.str_schema())},
-        ),
-    )
-    v = SchemaValidator(schema)
-    assert v.isinstance_python({'a': 'hello'}) is True
-    assert v.isinstance_python({'a': 'too long'}) is False
-    ```
-
-    Args:
-        cls: The class to use for the model
-        schema: The schema to use for the model
-        custom_init: Whether the model has a custom init method
-        root_model: Whether the model is a `RootModel`
-        post_init: The call after init to use for the model
-        revalidate_instances: whether instances of models and dataclasses (including subclass instances)
-            should re-validate defaults to config.revalidate_instances, else 'never'
-        strict: Whether the model is strict
-        frozen: Whether the model is frozen
-        extra_behavior: The extra behavior to use for the model, used in serialization
-        config: The config to use for the model
-        ref: optional unique identifier of the schema, used to reference the schema in other places
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-        serialization: Custom serialization schema
-    """
-    return _dict_not_none(
-        type='model',
-        cls=cls,
-        schema=schema,
-        custom_init=custom_init,
-        root_model=root_model,
-        post_init=post_init,
-        revalidate_instances=revalidate_instances,
-        strict=strict,
-        frozen=frozen,
-        extra_behavior=extra_behavior,
-        config=config,
-        ref=ref,
-        metadata=metadata,
-        serialization=serialization,
-    )
-
-
-class DataclassField(TypedDict, total=False):
-    type: Required[Literal['dataclass-field']]
-    name: Required[str]
-    schema: Required[CoreSchema]
-    kw_only: bool  # default: True
-    init: bool  # default: True
-    init_only: bool  # default: False
-    frozen: bool  # default: False
-    validation_alias: Union[str, List[Union[str, int]], List[List[Union[str, int]]]]
-    serialization_alias: str
-    serialization_exclude: bool  # default: False
-    metadata: Any
-
-
-def dataclass_field(
-    name: str,
-    schema: CoreSchema,
-    *,
-    kw_only: bool | None = None,
-    init: bool | None = None,
-    init_only: bool | None = None,
-    validation_alias: str | list[str | int] | list[list[str | int]] | None = None,
-    serialization_alias: str | None = None,
-    serialization_exclude: bool | None = None,
-    metadata: Any = None,
-    frozen: bool | None = None,
-) -> DataclassField:
-    """
-    Returns a schema for a dataclass field, e.g.:
-
-    ```py
-    from pydantic_core import SchemaValidator, core_schema
-
-    field = core_schema.dataclass_field(
-        name='a', schema=core_schema.str_schema(), kw_only=False
-    )
-    schema = core_schema.dataclass_args_schema('Foobar', [field])
-    v = SchemaValidator(schema)
-    assert v.validate_python({'a': 'hello'}) == ({'a': 'hello'}, None)
-    ```
-
-    Args:
-        name: The name to use for the argument parameter
-        schema: The schema to use for the argument parameter
-        kw_only: Whether the field can be set with a positional argument as well as a keyword argument
-        init: Whether the field should be validated during initialization
-        init_only: Whether the field should be omitted  from `__dict__` and passed to `__post_init__`
-        validation_alias: The alias(es) to use to find the field in the validation data
-        serialization_alias: The alias to use as a key when serializing
-        serialization_exclude: Whether to exclude the field when serializing
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-        frozen: Whether the field is frozen
-    """
-    return _dict_not_none(
-        type='dataclass-field',
-        name=name,
-        schema=schema,
-        kw_only=kw_only,
-        init=init,
-        init_only=init_only,
-        validation_alias=validation_alias,
-        serialization_alias=serialization_alias,
-        serialization_exclude=serialization_exclude,
-        metadata=metadata,
-        frozen=frozen,
-    )
-
-
-class DataclassArgsSchema(TypedDict, total=False):
-    type: Required[Literal['dataclass-args']]
-    dataclass_name: Required[str]
-    fields: Required[List[DataclassField]]
-    computed_fields: List[ComputedField]
-    populate_by_name: bool  # default: False
-    collect_init_only: bool  # default: False
-    ref: str
-    metadata: Any
-    serialization: SerSchema
-    extra_behavior: ExtraBehavior
-
-
-def dataclass_args_schema(
-    dataclass_name: str,
-    fields: list[DataclassField],
-    *,
-    computed_fields: List[ComputedField] | None = None,
-    populate_by_name: bool | None = None,
-    collect_init_only: bool | None = None,
-    ref: str | None = None,
-    metadata: Any = None,
-    serialization: SerSchema | None = None,
-    extra_behavior: ExtraBehavior | None = None,
-) -> DataclassArgsSchema:
-    """
-    Returns a schema for validating dataclass arguments, e.g.:
-
-    ```py
-    from pydantic_core import SchemaValidator, core_schema
-
-    field_a = core_schema.dataclass_field(
-        name='a', schema=core_schema.str_schema(), kw_only=False
-    )
-    field_b = core_schema.dataclass_field(
-        name='b', schema=core_schema.bool_schema(), kw_only=False
-    )
-    schema = core_schema.dataclass_args_schema('Foobar', [field_a, field_b])
-    v = SchemaValidator(schema)
-    assert v.validate_python({'a': 'hello', 'b': True}) == ({'a': 'hello', 'b': True}, None)
-    ```
-
-    Args:
-        dataclass_name: The name of the dataclass being validated
-        fields: The fields to use for the dataclass
-        computed_fields: Computed fields to use when serializing the dataclass
-        populate_by_name: Whether to populate by name
-        collect_init_only: Whether to collect init only fields into a dict to pass to `__post_init__`
-        ref: optional unique identifier of the schema, used to reference the schema in other places
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-        serialization: Custom serialization schema
-        extra_behavior: How to handle extra fields
-    """
-    return _dict_not_none(
-        type='dataclass-args',
-        dataclass_name=dataclass_name,
-        fields=fields,
-        computed_fields=computed_fields,
-        populate_by_name=populate_by_name,
-        collect_init_only=collect_init_only,
-        ref=ref,
-        metadata=metadata,
-        serialization=serialization,
-        extra_behavior=extra_behavior,
-    )
-
-
-class DataclassSchema(TypedDict, total=False):
-    type: Required[Literal['dataclass']]
-    cls: Required[Type[Any]]
-    schema: Required[CoreSchema]
-    fields: Required[List[str]]
-    cls_name: str
-    post_init: bool  # default: False
-    revalidate_instances: Literal['always', 'never', 'subclass-instances']  # default: 'never'
-    strict: bool  # default: False
-    frozen: bool  # default False
-    ref: str
-    metadata: Any
-    serialization: SerSchema
-    slots: bool
-    config: CoreConfig
-
-
-def dataclass_schema(
-    cls: Type[Any],
-    schema: CoreSchema,
-    fields: List[str],
-    *,
-    cls_name: str | None = None,
-    post_init: bool | None = None,
-    revalidate_instances: Literal['always', 'never', 'subclass-instances'] | None = None,
-    strict: bool | None = None,
-    ref: str | None = None,
-    metadata: Any = None,
-    serialization: SerSchema | None = None,
-    frozen: bool | None = None,
-    slots: bool | None = None,
-    config: CoreConfig | None = None,
-) -> DataclassSchema:
-    """
-    Returns a schema for a dataclass. As with `ModelSchema`, this schema can only be used as a field within
-    another schema, not as the root type.
-
-    Args:
-        cls: The dataclass type, used to perform subclass checks
-        schema: The schema to use for the dataclass fields
-        fields: Fields of the dataclass, this is used in serialization and in validation during re-validation
-            and while validating assignment
-        cls_name: The name to use in error locs, etc; this is useful for generics (default: `cls.__name__`)
-        post_init: Whether to call `__post_init__` after validation
-        revalidate_instances: whether instances of models and dataclasses (including subclass instances)
-            should re-validate defaults to config.revalidate_instances, else 'never'
-        strict: Whether to require an exact instance of `cls`
-        ref: optional unique identifier of the schema, used to reference the schema in other places
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-        serialization: Custom serialization schema
-        frozen: Whether the dataclass is frozen
-        slots: Whether `slots=True` on the dataclass, means each field is assigned independently, rather than
-            simply setting `__dict__`, default false
-    """
-    return _dict_not_none(
-        type='dataclass',
-        cls=cls,
-        fields=fields,
-        cls_name=cls_name,
-        schema=schema,
-        post_init=post_init,
-        revalidate_instances=revalidate_instances,
-        strict=strict,
-        ref=ref,
-        metadata=metadata,
-        serialization=serialization,
-        frozen=frozen,
-        slots=slots,
-        config=config,
-    )
-
-
-class ArgumentsParameter(TypedDict, total=False):
-    name: Required[str]
-    schema: Required[CoreSchema]
-    mode: Literal['positional_only', 'positional_or_keyword', 'keyword_only']  # default positional_or_keyword
-    alias: Union[str, List[Union[str, int]], List[List[Union[str, int]]]]
-
-
-def arguments_parameter(
-    name: str,
-    schema: CoreSchema,
-    *,
-    mode: Literal['positional_only', 'positional_or_keyword', 'keyword_only'] | None = None,
-    alias: str | list[str | int] | list[list[str | int]] | None = None,
-) -> ArgumentsParameter:
-    """
-    Returns a schema that matches an argument parameter, e.g.:
-
-    ```py
-    from pydantic_core import SchemaValidator, core_schema
-
-    param = core_schema.arguments_parameter(
-        name='a', schema=core_schema.str_schema(), mode='positional_only'
-    )
-    schema = core_schema.arguments_schema([param])
-    v = SchemaValidator(schema)
-    assert v.validate_python(('hello',)) == (('hello',), {})
-    ```
-
-    Args:
-        name: The name to use for the argument parameter
-        schema: The schema to use for the argument parameter
-        mode: The mode to use for the argument parameter
-        alias: The alias to use for the argument parameter
-    """
-    return _dict_not_none(name=name, schema=schema, mode=mode, alias=alias)
-
-
-class ArgumentsSchema(TypedDict, total=False):
-    type: Required[Literal['arguments']]
-    arguments_schema: Required[List[ArgumentsParameter]]
-    populate_by_name: bool
-    var_args_schema: CoreSchema
-    var_kwargs_schema: CoreSchema
-    ref: str
-    metadata: Any
-    serialization: SerSchema
-
-
-def arguments_schema(
-    arguments: list[ArgumentsParameter],
-    *,
-    populate_by_name: bool | None = None,
-    var_args_schema: CoreSchema | None = None,
-    var_kwargs_schema: CoreSchema | None = None,
-    ref: str | None = None,
-    metadata: Any = None,
-    serialization: SerSchema | None = None,
-) -> ArgumentsSchema:
-    """
-    Returns a schema that matches an arguments schema, e.g.:
-
-    ```py
-    from pydantic_core import SchemaValidator, core_schema
-
-    param_a = core_schema.arguments_parameter(
-        name='a', schema=core_schema.str_schema(), mode='positional_only'
-    )
-    param_b = core_schema.arguments_parameter(
-        name='b', schema=core_schema.bool_schema(), mode='positional_only'
-    )
-    schema = core_schema.arguments_schema([param_a, param_b])
-    v = SchemaValidator(schema)
-    assert v.validate_python(('hello', True)) == (('hello', True), {})
-    ```
-
-    Args:
-        arguments: The arguments to use for the arguments schema
-        populate_by_name: Whether to populate by name
-        var_args_schema: The variable args schema to use for the arguments schema
-        var_kwargs_schema: The variable kwargs schema to use for the arguments schema
-        ref: optional unique identifier of the schema, used to reference the schema in other places
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-        serialization: Custom serialization schema
-    """
-    return _dict_not_none(
-        type='arguments',
-        arguments_schema=arguments,
-        populate_by_name=populate_by_name,
-        var_args_schema=var_args_schema,
-        var_kwargs_schema=var_kwargs_schema,
-        ref=ref,
-        metadata=metadata,
-        serialization=serialization,
-    )
-
-
-class CallSchema(TypedDict, total=False):
-    type: Required[Literal['call']]
-    arguments_schema: Required[CoreSchema]
-    function: Required[Callable[..., Any]]
-    function_name: str  # default function.__name__
-    return_schema: CoreSchema
-    ref: str
-    metadata: Any
-    serialization: SerSchema
-
-
-def call_schema(
-    arguments: CoreSchema,
-    function: Callable[..., Any],
-    *,
-    function_name: str | None = None,
-    return_schema: CoreSchema | None = None,
-    ref: str | None = None,
-    metadata: Any = None,
-    serialization: SerSchema | None = None,
-) -> CallSchema:
-    """
-    Returns a schema that matches an arguments schema, then calls a function, e.g.:
-
-    ```py
-    from pydantic_core import SchemaValidator, core_schema
-
-    param_a = core_schema.arguments_parameter(
-        name='a', schema=core_schema.str_schema(), mode='positional_only'
-    )
-    param_b = core_schema.arguments_parameter(
-        name='b', schema=core_schema.bool_schema(), mode='positional_only'
-    )
-    args_schema = core_schema.arguments_schema([param_a, param_b])
-
-    schema = core_schema.call_schema(
-        arguments=args_schema,
-        function=lambda a, b: a + str(not b),
-        return_schema=core_schema.str_schema(),
-    )
-    v = SchemaValidator(schema)
-    assert v.validate_python((('hello', True))) == 'helloFalse'
-    ```
-
-    Args:
-        arguments: The arguments to use for the arguments schema
-        function: The function to use for the call schema
-        function_name: The function name to use for the call schema, if not provided `function.__name__` is used
-        return_schema: The return schema to use for the call schema
-        ref: optional unique identifier of the schema, used to reference the schema in other places
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-        serialization: Custom serialization schema
-    """
-    return _dict_not_none(
-        type='call',
-        arguments_schema=arguments,
-        function=function,
-        function_name=function_name,
-        return_schema=return_schema,
-        ref=ref,
-        metadata=metadata,
-        serialization=serialization,
-    )
-
-
-class CustomErrorSchema(TypedDict, total=False):
-    type: Required[Literal['custom-error']]
-    schema: Required[CoreSchema]
-    custom_error_type: Required[str]
-    custom_error_message: str
-    custom_error_context: Dict[str, Union[str, int, float]]
-    ref: str
-    metadata: Any
-    serialization: SerSchema
-
-
-def custom_error_schema(
-    schema: CoreSchema,
-    custom_error_type: str,
-    *,
-    custom_error_message: str | None = None,
-    custom_error_context: dict[str, Any] | None = None,
-    ref: str | None = None,
-    metadata: Any = None,
-    serialization: SerSchema | None = None,
-) -> CustomErrorSchema:
-    """
-    Returns a schema that matches a custom error value, e.g.:
-
-    ```py
-    from pydantic_core import SchemaValidator, core_schema
-
-    schema = core_schema.custom_error_schema(
-        schema=core_schema.int_schema(),
-        custom_error_type='MyError',
-        custom_error_message='Error msg',
-    )
-    v = SchemaValidator(schema)
-    v.validate_python(1)
-    ```
-
-    Args:
-        schema: The schema to use for the custom error schema
-        custom_error_type: The custom error type to use for the custom error schema
-        custom_error_message: The custom error message to use for the custom error schema
-        custom_error_context: The custom error context to use for the custom error schema
-        ref: optional unique identifier of the schema, used to reference the schema in other places
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-        serialization: Custom serialization schema
-    """
-    return _dict_not_none(
-        type='custom-error',
-        schema=schema,
-        custom_error_type=custom_error_type,
-        custom_error_message=custom_error_message,
-        custom_error_context=custom_error_context,
-        ref=ref,
-        metadata=metadata,
-        serialization=serialization,
-    )
-
-
-class JsonSchema(TypedDict, total=False):
-    type: Required[Literal['json']]
-    schema: CoreSchema
-    ref: str
-    metadata: Any
-    serialization: SerSchema
-
-
-def json_schema(
-    schema: CoreSchema | None = None,
-    *,
-    ref: str | None = None,
-    metadata: Any = None,
-    serialization: SerSchema | None = None,
-) -> JsonSchema:
-    """
-    Returns a schema that matches a JSON value, e.g.:
-
-    ```py
-    from pydantic_core import SchemaValidator, core_schema
-
-    dict_schema = core_schema.model_fields_schema(
-        {
-            'field_a': core_schema.model_field(core_schema.str_schema()),
-            'field_b': core_schema.model_field(core_schema.bool_schema()),
-        },
-    )
-
-    class MyModel:
-        __slots__ = (
-            '__dict__',
-            '__pydantic_fields_set__',
-            '__pydantic_extra__',
-            '__pydantic_private__',
-        )
-        field_a: str
-        field_b: bool
-
-    json_schema = core_schema.json_schema(schema=dict_schema)
-    schema = core_schema.model_schema(cls=MyModel, schema=json_schema)
-    v = SchemaValidator(schema)
-    m = v.validate_python('{"field_a": "hello", "field_b": true}')
-    assert isinstance(m, MyModel)
-    ```
-
-    Args:
-        schema: The schema to use for the JSON schema
-        ref: optional unique identifier of the schema, used to reference the schema in other places
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-        serialization: Custom serialization schema
-    """
-    return _dict_not_none(type='json', schema=schema, ref=ref, metadata=metadata, serialization=serialization)
-
-
-class UrlSchema(TypedDict, total=False):
-    type: Required[Literal['url']]
-    max_length: int
-    allowed_schemes: List[str]
-    host_required: bool  # default False
-    default_host: str
-    default_port: int
-    default_path: str
-    strict: bool
-    ref: str
-    metadata: Any
-    serialization: SerSchema
-
-
-def url_schema(
-    *,
-    max_length: int | None = None,
-    allowed_schemes: list[str] | None = None,
-    host_required: bool | None = None,
-    default_host: str | None = None,
-    default_port: int | None = None,
-    default_path: str | None = None,
-    strict: bool | None = None,
-    ref: str | None = None,
-    metadata: Any = None,
-    serialization: SerSchema | None = None,
-) -> UrlSchema:
-    """
-    Returns a schema that matches a URL value, e.g.:
-
-    ```py
-    from pydantic_core import SchemaValidator, core_schema
-
-    schema = core_schema.url_schema()
-    v = SchemaValidator(schema)
-    print(v.validate_python('https://example.com'))
-    #> https://example.com/
-    ```
-
-    Args:
-        max_length: The maximum length of the URL
-        allowed_schemes: The allowed URL schemes
-        host_required: Whether the URL must have a host
-        default_host: The default host to use if the URL does not have a host
-        default_port: The default port to use if the URL does not have a port
-        default_path: The default path to use if the URL does not have a path
-        strict: Whether to use strict URL parsing
-        ref: optional unique identifier of the schema, used to reference the schema in other places
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-        serialization: Custom serialization schema
-    """
-    return _dict_not_none(
-        type='url',
-        max_length=max_length,
-        allowed_schemes=allowed_schemes,
-        host_required=host_required,
-        default_host=default_host,
-        default_port=default_port,
-        default_path=default_path,
-        strict=strict,
-        ref=ref,
-        metadata=metadata,
-        serialization=serialization,
-    )
-
-
-class MultiHostUrlSchema(TypedDict, total=False):
-    type: Required[Literal['multi-host-url']]
-    max_length: int
-    allowed_schemes: List[str]
-    host_required: bool  # default False
-    default_host: str
-    default_port: int
-    default_path: str
-    strict: bool
-    ref: str
-    metadata: Any
-    serialization: SerSchema
-
-
-def multi_host_url_schema(
-    *,
-    max_length: int | None = None,
-    allowed_schemes: list[str] | None = None,
-    host_required: bool | None = None,
-    default_host: str | None = None,
-    default_port: int | None = None,
-    default_path: str | None = None,
-    strict: bool | None = None,
-    ref: str | None = None,
-    metadata: Any = None,
-    serialization: SerSchema | None = None,
-) -> MultiHostUrlSchema:
-    """
-    Returns a schema that matches a URL value with possibly multiple hosts, e.g.:
-
-    ```py
-    from pydantic_core import SchemaValidator, core_schema
-
-    schema = core_schema.multi_host_url_schema()
-    v = SchemaValidator(schema)
-    print(v.validate_python('redis://localhost,0.0.0.0,127.0.0.1'))
-    #> redis://localhost,0.0.0.0,127.0.0.1
-    ```
-
-    Args:
-        max_length: The maximum length of the URL
-        allowed_schemes: The allowed URL schemes
-        host_required: Whether the URL must have a host
-        default_host: The default host to use if the URL does not have a host
-        default_port: The default port to use if the URL does not have a port
-        default_path: The default path to use if the URL does not have a path
-        strict: Whether to use strict URL parsing
-        ref: optional unique identifier of the schema, used to reference the schema in other places
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-        serialization: Custom serialization schema
-    """
-    return _dict_not_none(
-        type='multi-host-url',
-        max_length=max_length,
-        allowed_schemes=allowed_schemes,
-        host_required=host_required,
-        default_host=default_host,
-        default_port=default_port,
-        default_path=default_path,
-        strict=strict,
-        ref=ref,
-        metadata=metadata,
-        serialization=serialization,
-    )
-
-
-class DefinitionsSchema(TypedDict, total=False):
-    type: Required[Literal['definitions']]
-    schema: Required[CoreSchema]
-    definitions: Required[List[CoreSchema]]
-    metadata: Any
-    serialization: SerSchema
-
-
-def definitions_schema(schema: CoreSchema, definitions: list[CoreSchema]) -> DefinitionsSchema:
-    """
-    Build a schema that contains both an inner schema and a list of definitions which can be used
-    within the inner schema.
-
-    ```py
-    from pydantic_core import SchemaValidator, core_schema
-
-    schema = core_schema.definitions_schema(
-        core_schema.list_schema(core_schema.definition_reference_schema('foobar')),
-        [core_schema.int_schema(ref='foobar')],
-    )
-    v = SchemaValidator(schema)
-    assert v.validate_python([1, 2, '3']) == [1, 2, 3]
-    ```
-
-    Args:
-        schema: The inner schema
-        definitions: List of definitions which can be referenced within inner schema
-    """
-    return DefinitionsSchema(type='definitions', schema=schema, definitions=definitions)
-
-
-class DefinitionReferenceSchema(TypedDict, total=False):
-    type: Required[Literal['definition-ref']]
-    schema_ref: Required[str]
-    ref: str
-    metadata: Any
-    serialization: SerSchema
-
-
-def definition_reference_schema(
-    schema_ref: str, ref: str | None = None, metadata: Any = None, serialization: SerSchema | None = None
-) -> DefinitionReferenceSchema:
-    """
-    Returns a schema that points to a schema stored in "definitions", this is useful for nested recursive
-    models and also when you want to define validators separately from the main schema, e.g.:
-
-    ```py
-    from pydantic_core import SchemaValidator, core_schema
-
-    schema_definition = core_schema.definition_reference_schema('list-schema')
-    schema = core_schema.definitions_schema(
-        schema=schema_definition,
-        definitions=[
-            core_schema.list_schema(items_schema=schema_definition, ref='list-schema'),
-        ],
-    )
-    v = SchemaValidator(schema)
-    assert v.validate_python([()]) == [[]]
-    ```
-
-    Args:
-        schema_ref: The schema ref to use for the definition reference schema
-        metadata: Any other information you want to include with the schema, not used by pydantic-core
-        serialization: Custom serialization schema
-    """
-    return _dict_not_none(
-        type='definition-ref', schema_ref=schema_ref, ref=ref, metadata=metadata, serialization=serialization
-    )
-
-
-MYPY = False
-# See https://github.com/python/mypy/issues/14034 for details, in summary mypy is extremely slow to process this
-# union which kills performance not just for pydantic, but even for code using pydantic
-if not MYPY:
-    CoreSchema = Union[
-        AnySchema,
-        NoneSchema,
-        BoolSchema,
-        IntSchema,
-        FloatSchema,
-        DecimalSchema,
-        StringSchema,
-        BytesSchema,
-        DateSchema,
-        TimeSchema,
-        DatetimeSchema,
-        TimedeltaSchema,
-        LiteralSchema,
-        IsInstanceSchema,
-        IsSubclassSchema,
-        CallableSchema,
-        ListSchema,
-        TupleSchema,
-        SetSchema,
-        FrozenSetSchema,
-        GeneratorSchema,
-        DictSchema,
-        AfterValidatorFunctionSchema,
-        BeforeValidatorFunctionSchema,
-        WrapValidatorFunctionSchema,
-        PlainValidatorFunctionSchema,
-        WithDefaultSchema,
-        NullableSchema,
-        UnionSchema,
-        TaggedUnionSchema,
-        ChainSchema,
-        LaxOrStrictSchema,
-        JsonOrPythonSchema,
-        TypedDictSchema,
-        ModelFieldsSchema,
-        ModelSchema,
-        DataclassArgsSchema,
-        DataclassSchema,
-        ArgumentsSchema,
-        CallSchema,
-        CustomErrorSchema,
-        JsonSchema,
-        UrlSchema,
-        MultiHostUrlSchema,
-        DefinitionsSchema,
-        DefinitionReferenceSchema,
-        UuidSchema,
-    ]
-elif False:
-    CoreSchema: TypeAlias = Mapping[str, Any]
-
-
-# to update this, call `pytest -k test_core_schema_type_literal` and copy the output
-CoreSchemaType = Literal[
-    'any',
-    'none',
-    'bool',
-    'int',
-    'float',
-    'decimal',
-    'str',
-    'bytes',
-    'date',
-    'time',
-    'datetime',
-    'timedelta',
-    'literal',
-    'is-instance',
-    'is-subclass',
-    'callable',
-    'list',
-    'tuple',
-    'set',
-    'frozenset',
-    'generator',
-    'dict',
-    'function-after',
-    'function-before',
-    'function-wrap',
-    'function-plain',
-    'default',
-    'nullable',
-    'union',
-    'tagged-union',
-    'chain',
-    'lax-or-strict',
-    'json-or-python',
-    'typed-dict',
-    'model-fields',
-    'model',
-    'dataclass-args',
-    'dataclass',
-    'arguments',
-    'call',
-    'custom-error',
-    'json',
-    'url',
-    'multi-host-url',
-    'definitions',
-    'definition-ref',
-    'uuid',
-]
-
-CoreSchemaFieldType = Literal['model-field', 'dataclass-field', 'typed-dict-field', 'computed-field']
-
-
-# used in _pydantic_core.pyi::PydanticKnownError
-# to update this, call `pytest -k test_all_errors` and copy the output
-ErrorType = Literal[
-    'no_such_attribute',
-    'json_invalid',
-    'json_type',
-    'recursion_loop',
-    'missing',
-    'frozen_field',
-    'frozen_instance',
-    'extra_forbidden',
-    'invalid_key',
-    'get_attribute_error',
-    'model_type',
-    'model_attributes_type',
-    'dataclass_type',
-    'dataclass_exact_type',
-    'none_required',
-    'greater_than',
-    'greater_than_equal',
-    'less_than',
-    'less_than_equal',
-    'multiple_of',
-    'finite_number',
-    'too_short',
-    'too_long',
-    'iterable_type',
-    'iteration_error',
-    'string_type',
-    'string_sub_type',
-    'string_unicode',
-    'string_too_short',
-    'string_too_long',
-    'string_pattern_mismatch',
-    'enum',
-    'dict_type',
-    'mapping_type',
-    'list_type',
-    'tuple_type',
-    'set_type',
-    'bool_type',
-    'bool_parsing',
-    'int_type',
-    'int_parsing',
-    'int_parsing_size',
-    'int_from_float',
-    'float_type',
-    'float_parsing',
-    'bytes_type',
-    'bytes_too_short',
-    'bytes_too_long',
-    'value_error',
-    'assertion_error',
-    'literal_error',
-    'date_type',
-    'date_parsing',
-    'date_from_datetime_parsing',
-    'date_from_datetime_inexact',
-    'date_past',
-    'date_future',
-    'time_type',
-    'time_parsing',
-    'datetime_type',
-    'datetime_parsing',
-    'datetime_object_invalid',
-    'datetime_from_date_parsing',
-    'datetime_past',
-    'datetime_future',
-    'timezone_naive',
-    'timezone_aware',
-    'timezone_offset',
-    'time_delta_type',
-    'time_delta_parsing',
-    'frozen_set_type',
-    'is_instance_of',
-    'is_subclass_of',
-    'callable_type',
-    'union_tag_invalid',
-    'union_tag_not_found',
-    'arguments_type',
-    'missing_argument',
-    'unexpected_keyword_argument',
-    'missing_keyword_only_argument',
-    'unexpected_positional_argument',
-    'missing_positional_only_argument',
-    'multiple_argument_values',
-    'url_type',
-    'url_parsing',
-    'url_syntax_violation',
-    'url_too_long',
-    'url_scheme',
-    'uuid_type',
-    'uuid_parsing',
-    'uuid_version',
-    'decimal_type',
-    'decimal_parsing',
-    'decimal_max_digits',
-    'decimal_max_places',
-    'decimal_whole_digits',
-]
-
-
-def _dict_not_none(**kwargs: Any) -> Any:
-    return {k: v for k, v in kwargs.items() if v is not None}
-
-
-###############################################################################
-# All this stuff is deprecated by #980 and will be removed eventually
-# They're kept because some code external code will be using them
-
-
-@deprecated('`field_before_validator_function` is deprecated, use `with_info_before_validator_function` instead.')
-def field_before_validator_function(function: WithInfoValidatorFunction, field_name: str, schema: CoreSchema, **kwargs):
-    warnings.warn(
-        '`field_before_validator_function` is deprecated, use `with_info_before_validator_function` instead.',
-        DeprecationWarning,
-    )
-    return with_info_before_validator_function(function, schema, field_name=field_name, **kwargs)
-
-
-@deprecated('`general_before_validator_function` is deprecated, use `with_info_before_validator_function` instead.')
-def general_before_validator_function(*args, **kwargs):
-    warnings.warn(
-        '`general_before_validator_function` is deprecated, use `with_info_before_validator_function` instead.',
-        DeprecationWarning,
-    )
-    return with_info_before_validator_function(*args, **kwargs)
-
-
-@deprecated('`field_after_validator_function` is deprecated, use `with_info_after_validator_function` instead.')
-def field_after_validator_function(function: WithInfoValidatorFunction, field_name: str, schema: CoreSchema, **kwargs):
-    warnings.warn(
-        '`field_after_validator_function` is deprecated, use `with_info_after_validator_function` instead.',
-        DeprecationWarning,
-    )
-    return with_info_after_validator_function(function, schema, field_name=field_name, **kwargs)
-
-
-@deprecated('`general_after_validator_function` is deprecated, use `with_info_after_validator_function` instead.')
-def general_after_validator_function(*args, **kwargs):
-    warnings.warn(
-        '`general_after_validator_function` is deprecated, use `with_info_after_validator_function` instead.',
-        DeprecationWarning,
-    )
-    return with_info_after_validator_function(*args, **kwargs)
-
-
-@deprecated('`field_wrap_validator_function` is deprecated, use `with_info_wrap_validator_function` instead.')
-def field_wrap_validator_function(
-    function: WithInfoWrapValidatorFunction, field_name: str, schema: CoreSchema, **kwargs
-):
-    warnings.warn(
-        '`field_wrap_validator_function` is deprecated, use `with_info_wrap_validator_function` instead.',
-        DeprecationWarning,
-    )
-    return with_info_wrap_validator_function(function, schema, field_name=field_name, **kwargs)
-
-
-@deprecated('`general_wrap_validator_function` is deprecated, use `with_info_wrap_validator_function` instead.')
-def general_wrap_validator_function(*args, **kwargs):
-    warnings.warn(
-        '`general_wrap_validator_function` is deprecated, use `with_info_wrap_validator_function` instead.',
-        DeprecationWarning,
-    )
-    return with_info_wrap_validator_function(*args, **kwargs)
-
-
-@deprecated('`field_plain_validator_function` is deprecated, use `with_info_plain_validator_function` instead.')
-def field_plain_validator_function(function: WithInfoValidatorFunction, field_name: str, **kwargs):
-    warnings.warn(
-        '`field_plain_validator_function` is deprecated, use `with_info_plain_validator_function` instead.',
-        DeprecationWarning,
-    )
-    return with_info_plain_validator_function(function, field_name=field_name, **kwargs)
-
-
-@deprecated('`general_plain_validator_function` is deprecated, use `with_info_plain_validator_function` instead.')
-def general_plain_validator_function(*args, **kwargs):
-    warnings.warn(
-        '`general_plain_validator_function` is deprecated, use `with_info_plain_validator_function` instead.',
-        DeprecationWarning,
-    )
-    return with_info_plain_validator_function(*args, **kwargs)
-
-
-_deprecated_import_lookup = {
-    'FieldValidationInfo': ValidationInfo,
-    'FieldValidatorFunction': WithInfoValidatorFunction,
-    'GeneralValidatorFunction': WithInfoValidatorFunction,
-    'FieldWrapValidatorFunction': WithInfoWrapValidatorFunction,
-}
-
-if TYPE_CHECKING:
-    FieldValidationInfo = ValidationInfo
-
-
-def __getattr__(attr_name: str) -> object:
-    new_attr = _deprecated_import_lookup.get(attr_name)
-    if new_attr is None:
-        raise AttributeError(f"module 'pydantic_core' has no attribute '{attr_name}'")
-    else:
-        import warnings
-
-        msg = f'`{attr_name}` is deprecated, use `{new_attr.__name__}` instead.'
-        warnings.warn(msg, DeprecationWarning, stacklevel=1)
-        return new_attr
diff --git a/lib/pydantic_core/py.typed b/lib/pydantic_core/py.typed
deleted file mode 100644
index e69de29b..00000000
diff --git a/lib/pythoncom.py b/lib/pythoncom.py
deleted file mode 100644
index 2180ecc3..00000000
--- a/lib/pythoncom.py
+++ /dev/null
@@ -1,4 +0,0 @@
-# Magic utility that "redirects" to pythoncomxx.dll
-import pywintypes
-
-pywintypes.__import_pywin32_system_module__("pythoncom", globals())
diff --git a/lib/pythonwin/license.txt b/lib/pythonwin/license.txt
deleted file mode 100644
index fa340d74..00000000
--- a/lib/pythonwin/license.txt
+++ /dev/null
@@ -1,30 +0,0 @@
-Unless stated in the specfic source file, this work is
-Copyright (c) 1994-2008, Mark Hammond 
-All rights reserved.
-
-Redistribution and use in source and binary forms, with or without 
-modification, are permitted provided that the following conditions 
-are met:
-
-Redistributions of source code must retain the above copyright notice, 
-this list of conditions and the following disclaimer.
-
-Redistributions in binary form must reproduce the above copyright 
-notice, this list of conditions and the following disclaimer in 
-the documentation and/or other materials provided with the distribution.
-
-Neither name of Mark Hammond nor the name of contributors may be used 
-to endorse or promote products derived from this software without 
-specific prior written permission. 
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS
-IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
-TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
-PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR
-CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
-EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
-PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
-PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
-NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
-SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 
diff --git a/lib/pythonwin/pywin/Demos/app/basictimerapp.py b/lib/pythonwin/pywin/Demos/app/basictimerapp.py
deleted file mode 100644
index da771da1..00000000
--- a/lib/pythonwin/pywin/Demos/app/basictimerapp.py
+++ /dev/null
@@ -1,258 +0,0 @@
-# basictimerapp - a really simple timer application.
-# This should be run using the command line:
-# pythonwin /app demos\basictimerapp.py
-import sys
-import time
-
-import timer
-import win32api
-import win32con
-import win32ui
-from pywin.framework import app, cmdline, dlgappcore
-
-
-class TimerAppDialog(dlgappcore.AppDialog):
-    softspace = 1
-
-    def __init__(self, appName=""):
-        dlgappcore.AppDialog.__init__(self, win32ui.IDD_GENERAL_STATUS)
-        self.timerAppName = appName
-        self.argOff = 0
-        if len(self.timerAppName) == 0:
-            if len(sys.argv) > 1 and sys.argv[1][0] != "/":
-                self.timerAppName = sys.argv[1]
-                self.argOff = 1
-
-    def PreDoModal(self):
-        # 		sys.stderr = sys.stdout
-        pass
-
-    def ProcessArgs(self, args):
-        for arg in args:
-            if arg == "/now":
-                self.OnOK()
-
-    def OnInitDialog(self):
-        win32ui.SetProfileFileName("pytimer.ini")
-        self.title = win32ui.GetProfileVal(
-            self.timerAppName, "Title", "Remote System Timer"
-        )
-        self.buildTimer = win32ui.GetProfileVal(
-            self.timerAppName, "Timer", "EachMinuteIntervaler()"
-        )
-        self.doWork = win32ui.GetProfileVal(self.timerAppName, "Work", "DoDemoWork()")
-        # replace "\n" with real \n.
-        self.doWork = self.doWork.replace("\\n", "\n")
-        dlgappcore.AppDialog.OnInitDialog(self)
-
-        self.SetWindowText(self.title)
-        self.prompt1 = self.GetDlgItem(win32ui.IDC_PROMPT1)
-        self.prompt2 = self.GetDlgItem(win32ui.IDC_PROMPT2)
-        self.prompt3 = self.GetDlgItem(win32ui.IDC_PROMPT3)
-        self.butOK = self.GetDlgItem(win32con.IDOK)
-        self.butCancel = self.GetDlgItem(win32con.IDCANCEL)
-        self.prompt1.SetWindowText("Python Timer App")
-        self.prompt2.SetWindowText("")
-        self.prompt3.SetWindowText("")
-        self.butOK.SetWindowText("Do it now")
-        self.butCancel.SetWindowText("Close")
-
-        self.timerManager = TimerManager(self)
-        self.ProcessArgs(sys.argv[self.argOff :])
-        self.timerManager.go()
-        return 1
-
-    def OnDestroy(self, msg):
-        dlgappcore.AppDialog.OnDestroy(self, msg)
-        self.timerManager.stop()
-
-    def OnOK(self):
-        # stop the timer, then restart after setting special boolean
-        self.timerManager.stop()
-        self.timerManager.bConnectNow = 1
-        self.timerManager.go()
-        return
-
-
-# 	def OnCancel(self): default behaviour - cancel == close.
-# 		return
-
-
-class TimerManager:
-    def __init__(self, dlg):
-        self.dlg = dlg
-        self.timerId = None
-        self.intervaler = eval(self.dlg.buildTimer)
-        self.bConnectNow = 0
-        self.bHaveSetPrompt1 = 0
-
-    def CaptureOutput(self):
-        self.oldOut = sys.stdout
-        self.oldErr = sys.stderr
-        sys.stdout = sys.stderr = self
-        self.bHaveSetPrompt1 = 0
-
-    def ReleaseOutput(self):
-        sys.stdout = self.oldOut
-        sys.stderr = self.oldErr
-
-    def write(self, str):
-        s = str.strip()
-        if len(s):
-            if self.bHaveSetPrompt1:
-                dest = self.dlg.prompt3
-            else:
-                dest = self.dlg.prompt1
-                self.bHaveSetPrompt1 = 1
-            dest.SetWindowText(s)
-
-    def go(self):
-        self.OnTimer(None, None)
-
-    def stop(self):
-        if self.timerId:
-            timer.kill_timer(self.timerId)
-        self.timerId = None
-
-    def OnTimer(self, id, timeVal):
-        if id:
-            timer.kill_timer(id)
-        if self.intervaler.IsTime() or self.bConnectNow:
-            # do the work.
-            try:
-                self.dlg.SetWindowText(self.dlg.title + " - Working...")
-                self.dlg.butOK.EnableWindow(0)
-                self.dlg.butCancel.EnableWindow(0)
-                self.CaptureOutput()
-                try:
-                    exec(self.dlg.doWork)
-                    print("The last operation completed successfully.")
-                except:
-                    t, v, tb = sys.exc_info()
-                    str = "Failed: %s: %s" % (t, repr(v))
-                    print(str)
-                    self.oldErr.write(str)
-                    tb = None  # Prevent cycle
-            finally:
-                self.ReleaseOutput()
-                self.dlg.butOK.EnableWindow()
-                self.dlg.butCancel.EnableWindow()
-                self.dlg.SetWindowText(self.dlg.title)
-        else:
-            now = time.time()
-            nextTime = self.intervaler.GetNextTime()
-            if nextTime:
-                timeDiffSeconds = nextTime - now
-                timeDiffMinutes = int(timeDiffSeconds / 60)
-                timeDiffSeconds = timeDiffSeconds % 60
-                timeDiffHours = int(timeDiffMinutes / 60)
-                timeDiffMinutes = timeDiffMinutes % 60
-                self.dlg.prompt1.SetWindowText(
-                    "Next connection due in %02d:%02d:%02d"
-                    % (timeDiffHours, timeDiffMinutes, timeDiffSeconds)
-                )
-        self.timerId = timer.set_timer(
-            self.intervaler.GetWakeupInterval(), self.OnTimer
-        )
-        self.bConnectNow = 0
-
-
-class TimerIntervaler:
-    def __init__(self):
-        self.nextTime = None
-        self.wakeUpInterval = 2000
-
-    def GetWakeupInterval(self):
-        return self.wakeUpInterval
-
-    def GetNextTime(self):
-        return self.nextTime
-
-    def IsTime(self):
-        now = time.time()
-        if self.nextTime is None:
-            self.nextTime = self.SetFirstTime(now)
-        ret = 0
-        if now >= self.nextTime:
-            ret = 1
-            self.nextTime = self.SetNextTime(self.nextTime, now)
-            # do the work.
-        return ret
-
-
-class EachAnyIntervaler(TimerIntervaler):
-    def __init__(self, timeAt, timePos, timeAdd, wakeUpInterval=None):
-        TimerIntervaler.__init__(self)
-        self.timeAt = timeAt
-        self.timePos = timePos
-        self.timeAdd = timeAdd
-        if wakeUpInterval:
-            self.wakeUpInterval = wakeUpInterval
-
-    def SetFirstTime(self, now):
-        timeTup = time.localtime(now)
-        lst = []
-        for item in timeTup:
-            lst.append(item)
-        bAdd = timeTup[self.timePos] > self.timeAt
-        lst[self.timePos] = self.timeAt
-        for pos in range(self.timePos + 1, 6):
-            lst[pos] = 0
-        ret = time.mktime(tuple(lst))
-        if bAdd:
-            ret = ret + self.timeAdd
-        return ret
-
-    def SetNextTime(self, lastTime, now):
-        return lastTime + self.timeAdd
-
-
-class EachMinuteIntervaler(EachAnyIntervaler):
-    def __init__(self, at=0):
-        EachAnyIntervaler.__init__(self, at, 5, 60, 2000)
-
-
-class EachHourIntervaler(EachAnyIntervaler):
-    def __init__(self, at=0):
-        EachAnyIntervaler.__init__(self, at, 4, 3600, 10000)
-
-
-class EachDayIntervaler(EachAnyIntervaler):
-    def __init__(self, at=0):
-        EachAnyIntervaler.__init__(self, at, 3, 86400, 10000)
-
-
-class TimerDialogApp(dlgappcore.DialogApp):
-    def CreateDialog(self):
-        return TimerAppDialog()
-
-
-def DoDemoWork():
-    print("Doing the work...")
-    print("About to connect")
-    win32api.MessageBeep(win32con.MB_ICONASTERISK)
-    win32api.Sleep(2000)
-    print("Doing something else...")
-    win32api.MessageBeep(win32con.MB_ICONEXCLAMATION)
-    win32api.Sleep(2000)
-    print("More work.")
-    win32api.MessageBeep(win32con.MB_ICONHAND)
-    win32api.Sleep(2000)
-    print("The last bit.")
-    win32api.MessageBeep(win32con.MB_OK)
-    win32api.Sleep(2000)
-
-
-app = TimerDialogApp()
-
-
-def t():
-    t = TimerAppDialog("Test Dialog")
-    t.DoModal()
-    return t
-
-
-if __name__ == "__main__":
-    import demoutils
-
-    demoutils.NeedApp()
diff --git a/lib/pythonwin/pywin/Demos/app/customprint.py b/lib/pythonwin/pywin/Demos/app/customprint.py
deleted file mode 100644
index 356073e5..00000000
--- a/lib/pythonwin/pywin/Demos/app/customprint.py
+++ /dev/null
@@ -1,186 +0,0 @@
-# A demo of an Application object that has some custom print functionality.
-
-# If you desire, you can also run this from inside Pythonwin, in which
-# case it will do the demo inside the Pythonwin environment.
-
-# This sample was contributed by Roger Burnham.
-
-import win32api
-import win32con
-import win32ui
-from pywin.framework import app
-from pywin.mfc import afxres, dialog, docview
-
-PRINTDLGORD = 1538
-IDC_PRINT_MAG_EDIT = 1010
-
-
-class PrintDemoTemplate(docview.DocTemplate):
-    def _SetupSharedMenu_(self):
-        pass
-
-
-class PrintDemoView(docview.ScrollView):
-    def OnInitialUpdate(self):
-        ret = self._obj_.OnInitialUpdate()
-        self.colors = {
-            "Black": (0x00 << 0) + (0x00 << 8) + (0x00 << 16),
-            "Red": (0xFF << 0) + (0x00 << 8) + (0x00 << 16),
-            "Green": (0x00 << 0) + (0xFF << 8) + (0x00 << 16),
-            "Blue": (0x00 << 0) + (0x00 << 8) + (0xFF << 16),
-            "Cyan": (0x00 << 0) + (0xFF << 8) + (0xFF << 16),
-            "Magenta": (0xFF << 0) + (0x00 << 8) + (0xFF << 16),
-            "Yellow": (0xFF << 0) + (0xFF << 8) + (0x00 << 16),
-        }
-        self.pens = {}
-        for name, color in self.colors.items():
-            self.pens[name] = win32ui.CreatePen(win32con.PS_SOLID, 5, color)
-        self.pen = None
-        self.size = (128, 128)
-        self.SetScaleToFitSize(self.size)
-        self.HookCommand(self.OnFilePrint, afxres.ID_FILE_PRINT)
-        self.HookCommand(self.OnFilePrintPreview, win32ui.ID_FILE_PRINT_PREVIEW)
-        return ret
-
-    def OnDraw(self, dc):
-        oldPen = None
-        x, y = self.size
-        delta = 2
-        colors = list(self.colors.keys())
-        colors.sort()
-        colors = colors * 2
-        for color in colors:
-            if oldPen is None:
-                oldPen = dc.SelectObject(self.pens[color])
-            else:
-                dc.SelectObject(self.pens[color])
-            dc.MoveTo((delta, delta))
-            dc.LineTo((x - delta, delta))
-            dc.LineTo((x - delta, y - delta))
-            dc.LineTo((delta, y - delta))
-            dc.LineTo((delta, delta))
-            delta = delta + 4
-            if x - delta <= 0 or y - delta <= 0:
-                break
-        dc.SelectObject(oldPen)
-
-    def OnPrepareDC(self, dc, pInfo):
-        if dc.IsPrinting():
-            mag = self.prtDlg["mag"]
-            dc.SetMapMode(win32con.MM_ANISOTROPIC)
-            dc.SetWindowOrg((0, 0))
-            dc.SetWindowExt((1, 1))
-            dc.SetViewportOrg((0, 0))
-            dc.SetViewportExt((mag, mag))
-
-    def OnPreparePrinting(self, pInfo):
-        flags = (
-            win32ui.PD_USEDEVMODECOPIES
-            | win32ui.PD_PAGENUMS
-            | win32ui.PD_NOPAGENUMS
-            | win32ui.PD_NOSELECTION
-        )
-        self.prtDlg = ImagePrintDialog(pInfo, PRINTDLGORD, flags)
-        pInfo.SetPrintDialog(self.prtDlg)
-        pInfo.SetMinPage(1)
-        pInfo.SetMaxPage(1)
-        pInfo.SetFromPage(1)
-        pInfo.SetToPage(1)
-        ret = self.DoPreparePrinting(pInfo)
-        return ret
-
-    def OnBeginPrinting(self, dc, pInfo):
-        return self._obj_.OnBeginPrinting(dc, pInfo)
-
-    def OnEndPrinting(self, dc, pInfo):
-        del self.prtDlg
-        return self._obj_.OnEndPrinting(dc, pInfo)
-
-    def OnFilePrintPreview(self, *arg):
-        self._obj_.OnFilePrintPreview()
-
-    def OnFilePrint(self, *arg):
-        self._obj_.OnFilePrint()
-
-    def OnPrint(self, dc, pInfo):
-        doc = self.GetDocument()
-        metrics = dc.GetTextMetrics()
-        cxChar = metrics["tmAveCharWidth"]
-        cyChar = metrics["tmHeight"]
-        left, top, right, bottom = pInfo.GetDraw()
-        dc.TextOut(0, 2 * cyChar, doc.GetTitle())
-        top = top + (7 * cyChar) / 2
-        dc.MoveTo(left, top)
-        dc.LineTo(right, top)
-        top = top + cyChar
-        # this seems to have not effect...
-        # get what I want with the dc.SetWindowOrg calls
-        pInfo.SetDraw((left, top, right, bottom))
-        dc.SetWindowOrg((0, -top))
-
-        self.OnDraw(dc)
-        dc.SetTextAlign(win32con.TA_LEFT | win32con.TA_BOTTOM)
-
-        rect = self.GetWindowRect()
-        rect = self.ScreenToClient(rect)
-        height = rect[3] - rect[1]
-        dc.SetWindowOrg((0, -(top + height + cyChar)))
-        dc.MoveTo(left, 0)
-        dc.LineTo(right, 0)
-
-        x = 0
-        y = (3 * cyChar) / 2
-
-        dc.TextOut(x, y, doc.GetTitle())
-        y = y + cyChar
-
-
-class PrintDemoApp(app.CApp):
-    def __init__(self):
-        app.CApp.__init__(self)
-
-    def InitInstance(self):
-        template = PrintDemoTemplate(None, None, None, PrintDemoView)
-        self.AddDocTemplate(template)
-        self._obj_.InitMDIInstance()
-        self.LoadMainFrame()
-        doc = template.OpenDocumentFile(None)
-        doc.SetTitle("Custom Print Document")
-
-
-class ImagePrintDialog(dialog.PrintDialog):
-    sectionPos = "Image Print Demo"
-
-    def __init__(self, pInfo, dlgID, flags=win32ui.PD_USEDEVMODECOPIES):
-        dialog.PrintDialog.__init__(self, pInfo, dlgID, flags=flags)
-        mag = win32ui.GetProfileVal(self.sectionPos, "Document Magnification", 0)
-        if mag <= 0:
-            mag = 2
-            win32ui.WriteProfileVal(self.sectionPos, "Document Magnification", mag)
-
-        self["mag"] = mag
-
-    def OnInitDialog(self):
-        self.magCtl = self.GetDlgItem(IDC_PRINT_MAG_EDIT)
-        self.magCtl.SetWindowText(repr(self["mag"]))
-        return dialog.PrintDialog.OnInitDialog(self)
-
-    def OnOK(self):
-        dialog.PrintDialog.OnOK(self)
-        strMag = self.magCtl.GetWindowText()
-        try:
-            self["mag"] = int(strMag)
-        except:
-            pass
-        win32ui.WriteProfileVal(self.sectionPos, "Document Magnification", self["mag"])
-
-
-if __name__ == "__main__":
-    # Running under Pythonwin
-    def test():
-        template = PrintDemoTemplate(None, None, None, PrintDemoView)
-        template.OpenDocumentFile(None)
-
-    test()
-else:
-    app = PrintDemoApp()
diff --git a/lib/pythonwin/pywin/Demos/app/demoutils.py b/lib/pythonwin/pywin/Demos/app/demoutils.py
deleted file mode 100644
index ee1fefcf..00000000
--- a/lib/pythonwin/pywin/Demos/app/demoutils.py
+++ /dev/null
@@ -1,65 +0,0 @@
-# Utilities for the demos
-
-import sys
-
-import win32api
-import win32con
-import win32ui
-
-NotScriptMsg = """\
-This demo program is not designed to be run as a Script, but is
-probably used by some other test program.  Please try another demo.
-"""
-
-NeedGUIMsg = """\
-This demo program can only be run from inside of Pythonwin
-
-You must start Pythonwin, and select 'Run' from the toolbar or File menu
-"""
-
-
-NeedAppMsg = """\
-This demo program is a 'Pythonwin Application'.
-
-It is more demo code than an example of Pythonwin's capabilities.
-
-To run it, you must execute the command:
-pythonwin.exe /app "%s"
-
-Would you like to execute it now?
-"""
-
-
-def NotAScript():
-    import win32ui
-
-    win32ui.MessageBox(NotScriptMsg, "Demos")
-
-
-def NeedGoodGUI():
-    from pywin.framework.app import HaveGoodGUI
-
-    rc = HaveGoodGUI()
-    if not rc:
-        win32ui.MessageBox(NeedGUIMsg, "Demos")
-    return rc
-
-
-def NeedApp():
-    import win32ui
-
-    rc = win32ui.MessageBox(NeedAppMsg % sys.argv[0], "Demos", win32con.MB_YESNO)
-    if rc == win32con.IDYES:
-        try:
-            parent = win32ui.GetMainFrame().GetSafeHwnd()
-            win32api.ShellExecute(
-                parent, None, "pythonwin.exe", '/app "%s"' % sys.argv[0], None, 1
-            )
-        except win32api.error as details:
-            win32ui.MessageBox("Error executing command - %s" % (details), "Demos")
-
-
-if __name__ == "__main__":
-    import demoutils
-
-    demoutils.NotAScript()
diff --git a/lib/pythonwin/pywin/Demos/app/dlgappdemo.py b/lib/pythonwin/pywin/Demos/app/dlgappdemo.py
deleted file mode 100644
index 38659a62..00000000
--- a/lib/pythonwin/pywin/Demos/app/dlgappdemo.py
+++ /dev/null
@@ -1,51 +0,0 @@
-# dlgappdemo - a demo of a dialog application.
-# This is a demonstration of both a custom "application" module,
-# and a Python program in a dialog box.
-#
-# NOTE:  You CAN NOT import this module from either PythonWin or Python.
-# This module must be specified on the commandline to PythonWin only.
-# eg, PythonWin /app dlgappdemo.py
-
-import sys
-
-import win32ui
-from pywin.framework import app, dlgappcore
-
-
-class TestDialogApp(dlgappcore.DialogApp):
-    def CreateDialog(self):
-        return TestAppDialog()
-
-
-class TestAppDialog(dlgappcore.AppDialog):
-    def __init__(self):
-        self.edit = None
-        dlgappcore.AppDialog.__init__(self, win32ui.IDD_LARGE_EDIT)
-
-    def OnInitDialog(self):
-        self.SetWindowText("Test dialog application")
-        self.edit = self.GetDlgItem(win32ui.IDC_EDIT1)
-        print("Hello from Python")
-        print("args are:", end=" ")
-        for arg in sys.argv:
-            print(arg)
-        return 1
-
-    def PreDoModal(self):
-        sys.stdout = sys.stderr = self
-
-    def write(self, str):
-        if self.edit:
-            self.edit.SetSel(-2)
-            # translate \n to \n\r
-            self.edit.ReplaceSel(str.replace("\n", "\r\n"))
-        else:
-            win32ui.OutputDebug("dlgapp - no edit control! >>\n%s\n<<\n" % str)
-
-
-app.AppBuilder = TestDialogApp
-
-if __name__ == "__main__":
-    import demoutils
-
-    demoutils.NeedApp()
diff --git a/lib/pythonwin/pywin/Demos/app/dojobapp.py b/lib/pythonwin/pywin/Demos/app/dojobapp.py
deleted file mode 100644
index d97ce5e2..00000000
--- a/lib/pythonwin/pywin/Demos/app/dojobapp.py
+++ /dev/null
@@ -1,72 +0,0 @@
-# dojobapp - do a job, show the result in a dialog, and exit.
-#
-# Very simple - faily minimal dialog based app.
-#
-# This should be run using the command line:
-# pythonwin /app demos\dojobapp.py
-
-
-import win32api
-import win32con
-import win32ui
-from pywin.framework import app, dlgappcore
-
-
-class DoJobAppDialog(dlgappcore.AppDialog):
-    softspace = 1
-
-    def __init__(self, appName=""):
-        self.appName = appName
-        dlgappcore.AppDialog.__init__(self, win32ui.IDD_GENERAL_STATUS)
-
-    def PreDoModal(self):
-        pass
-
-    def ProcessArgs(self, args):
-        pass
-
-    def OnInitDialog(self):
-        self.SetWindowText(self.appName)
-        butCancel = self.GetDlgItem(win32con.IDCANCEL)
-        butCancel.ShowWindow(win32con.SW_HIDE)
-        p1 = self.GetDlgItem(win32ui.IDC_PROMPT1)
-        p2 = self.GetDlgItem(win32ui.IDC_PROMPT2)
-
-        # Do something here!
-
-        p1.SetWindowText("Hello there")
-        p2.SetWindowText("from the demo")
-
-    def OnDestroy(self, msg):
-        pass
-
-
-# 	def OnOK(self):
-# 		pass
-# 	def OnCancel(self): default behaviour - cancel == close.
-# 		return
-
-
-class DoJobDialogApp(dlgappcore.DialogApp):
-    def CreateDialog(self):
-        return DoJobAppDialog("Do Something")
-
-
-class CopyToDialogApp(DoJobDialogApp):
-    def __init__(self):
-        DoJobDialogApp.__init__(self)
-
-
-app.AppBuilder = DoJobDialogApp
-
-
-def t():
-    t = DoJobAppDialog("Copy To")
-    t.DoModal()
-    return t
-
-
-if __name__ == "__main__":
-    import demoutils
-
-    demoutils.NeedApp()
diff --git a/lib/pythonwin/pywin/Demos/app/helloapp.py b/lib/pythonwin/pywin/Demos/app/helloapp.py
deleted file mode 100644
index 876f16f7..00000000
--- a/lib/pythonwin/pywin/Demos/app/helloapp.py
+++ /dev/null
@@ -1,53 +0,0 @@
-##
-## helloapp.py
-##
-##
-## A nice, small 'hello world' Pythonwin application.
-## NOT an MDI application - just a single, normal, top-level window.
-##
-## MUST be run with the command line "pythonwin.exe /app helloapp.py"
-## (or if you are really keen, rename "pythonwin.exe" to something else, then
-## using MSVC or similar, edit the string section in the .EXE to name this file)
-##
-## Originally by Willy Heineman <wheineman@uconect.net>
-
-
-import win32con
-import win32ui
-from pywin.mfc import afxres, dialog, window
-from pywin.mfc.thread import WinApp
-
-
-# The main frame.
-# Does almost nothing at all - doesnt even create a child window!
-class HelloWindow(window.Wnd):
-    def __init__(self):
-        # The window.Wnd ctor creates a Window object, and places it in
-        # self._obj_.  Note the window object exists, but the window itself
-        # does not!
-        window.Wnd.__init__(self, win32ui.CreateWnd())
-
-        # Now we ask the window object to create the window itself.
-        self._obj_.CreateWindowEx(
-            win32con.WS_EX_CLIENTEDGE,
-            win32ui.RegisterWndClass(0, 0, win32con.COLOR_WINDOW + 1),
-            "Hello World!",
-            win32con.WS_OVERLAPPEDWINDOW,
-            (100, 100, 400, 300),
-            None,
-            0,
-            None,
-        )
-
-
-# The application object itself.
-class HelloApp(WinApp):
-    def InitInstance(self):
-        self.frame = HelloWindow()
-        self.frame.ShowWindow(win32con.SW_SHOWNORMAL)
-        # We need to tell MFC what our main frame is.
-        self.SetMainFrame(self.frame)
-
-
-# Now create the application object itself!
-app = HelloApp()
diff --git a/lib/pythonwin/pywin/Demos/cmdserver.py b/lib/pythonwin/pywin/Demos/cmdserver.py
deleted file mode 100644
index 7b1c257a..00000000
--- a/lib/pythonwin/pywin/Demos/cmdserver.py
+++ /dev/null
@@ -1,116 +0,0 @@
-# cmdserver.py
-
-# Demo code that is not Pythonwin related, but too good to throw away...
-
-import _thread
-import sys
-import traceback
-
-import win32api
-from pywin.framework import winout
-
-
-class ThreadWriter:
-    "Assign an instance to sys.stdout for per-thread printing objects - Courtesy Guido!"
-
-    def __init__(self):
-        "Constructor -- initialize the table of writers"
-        self.writers = {}
-        self.origStdOut = None
-
-    def register(self, writer):
-        "Register the writer for the current thread"
-        self.writers[_thread.get_ident()] = writer
-        if self.origStdOut is None:
-            self.origStdOut = sys.stdout
-            sys.stdout = self
-
-    def unregister(self):
-        "Remove the writer for the current thread, if any"
-        try:
-            del self.writers[_thread.get_ident()]
-        except KeyError:
-            pass
-        if len(self.writers) == 0:
-            sys.stdout = self.origStdOut
-            self.origStdOut = None
-
-    def getwriter(self):
-        "Return the current thread's writer, default sys.stdout"
-        try:
-            return self.writers[_thread.get_ident()]
-        except KeyError:
-            return self.origStdOut
-
-    def write(self, str):
-        "Write to the current thread's writer, default sys.stdout"
-        self.getwriter().write(str)
-
-
-def Test():
-    num = 1
-    while num < 1000:
-        print("Hello there no " + str(num))
-        win32api.Sleep(50)
-        num = num + 1
-
-
-class flags:
-    SERVER_BEST = 0
-    SERVER_IMMEDIATE = 1
-    SERVER_THREAD = 2
-    SERVER_PROCESS = 3
-
-
-def StartServer(cmd, title=None, bCloseOnEnd=0, serverFlags=flags.SERVER_BEST):
-    out = winout.WindowOutput(title, None, winout.flags.WQ_IDLE)
-    if not title:
-        title = cmd
-    out.Create(title)
-    # 	ServerThread((out, cmd, title, bCloseOnEnd))
-    # 	out = sys.stdout
-    _thread.start_new_thread(ServerThread, (out, cmd, title, bCloseOnEnd))
-
-
-def ServerThread(myout, cmd, title, bCloseOnEnd):
-    try:
-        writer.register(myout)
-        print('Executing "%s"\n' % cmd)
-        bOK = 1
-        try:
-            import __main__
-
-            exec(cmd + "\n", __main__.__dict__)
-        except:
-            bOK = 0
-        if bOK:
-            print("Command terminated without errors.")
-        else:
-            t, v, tb = sys.exc_info()
-            print(t, ": ", v)
-            traceback.print_tb(tb)
-            tb = None  # prevent a cycle
-            print("Command terminated with an unhandled exception")
-        writer.unregister()
-        if bOK and bCloseOnEnd:
-            myout.frame.DestroyWindow()
-
-    # Unhandled exception of any kind in a thread kills the gui!
-    except:
-        t, v, tb = sys.exc_info()
-        print(t, ": ", v)
-        traceback.print_tb(tb)
-        tb = None
-        print("Thread failed")
-
-
-# assist for reloading (when debugging) - use only 1 tracer object,
-# else a large chain of tracer objects will exist.
-# try:
-# 	writer
-# except NameError:
-# 	writer=ThreadWriter()
-if __name__ == "__main__":
-    import demoutils
-
-    demoutils.NotAScript()
diff --git a/lib/pythonwin/pywin/Demos/createwin.py b/lib/pythonwin/pywin/Demos/createwin.py
deleted file mode 100644
index 38f6947e..00000000
--- a/lib/pythonwin/pywin/Demos/createwin.py
+++ /dev/null
@@ -1,114 +0,0 @@
-#
-# Window creation example
-#
-# 	This example creates a minimal "control" that just fills in its
-# 	window with red.  To make your own control, subclass Control and
-# 	write your own OnPaint() method.  See PyCWnd.HookMessage for what
-# 	the parameters to OnPaint are.
-#
-
-import win32api
-import win32con
-import win32ui
-from pywin.mfc import dialog, window
-
-
-class Control(window.Wnd):
-    """Generic control class"""
-
-    def __init__(self):
-        window.Wnd.__init__(self, win32ui.CreateWnd())
-
-    def OnPaint(self):
-        dc, paintStruct = self.BeginPaint()
-        self.DoPaint(dc)
-        self.EndPaint(paintStruct)
-
-    def DoPaint(self, dc):  # Override this!
-        pass
-
-
-class RedBox(Control):
-    def DoPaint(self, dc):
-        dc.FillSolidRect(self.GetClientRect(), win32api.RGB(255, 0, 0))
-
-
-class RedBoxWithPie(RedBox):
-    def DoPaint(self, dc):
-        RedBox.DoPaint(self, dc)
-        r = self.GetClientRect()
-        dc.Pie(r[0], r[1], r[2], r[3], 0, 0, r[2], r[3] // 2)
-
-
-def MakeDlgTemplate():
-    style = (
-        win32con.DS_MODALFRAME
-        | win32con.WS_POPUP
-        | win32con.WS_VISIBLE
-        | win32con.WS_CAPTION
-        | win32con.WS_SYSMENU
-        | win32con.DS_SETFONT
-    )
-    cs = win32con.WS_CHILD | win32con.WS_VISIBLE
-
-    w = 64
-    h = 64
-
-    dlg = [
-        ["Red box", (0, 0, w, h), style, None, (8, "MS Sans Serif")],
-    ]
-
-    s = win32con.WS_TABSTOP | cs
-
-    dlg.append(
-        [
-            128,
-            "Cancel",
-            win32con.IDCANCEL,
-            (7, h - 18, 50, 14),
-            s | win32con.BS_PUSHBUTTON,
-        ]
-    )
-
-    return dlg
-
-
-class TestDialog(dialog.Dialog):
-    def OnInitDialog(self):
-        rc = dialog.Dialog.OnInitDialog(self)
-        self.redbox = RedBox()
-        self.redbox.CreateWindow(
-            None,
-            "RedBox",
-            win32con.WS_CHILD | win32con.WS_VISIBLE,
-            (5, 5, 90, 68),
-            self,
-            1003,
-        )
-        return rc
-
-
-class TestPieDialog(dialog.Dialog):
-    def OnInitDialog(self):
-        rc = dialog.Dialog.OnInitDialog(self)
-        self.control = RedBoxWithPie()
-        self.control.CreateWindow(
-            None,
-            "RedBox with Pie",
-            win32con.WS_CHILD | win32con.WS_VISIBLE,
-            (5, 5, 90, 68),
-            self,
-            1003,
-        )
-
-
-def demo(modal=0):
-    d = TestPieDialog(MakeDlgTemplate())
-    if modal:
-        d.DoModal()
-    else:
-        d.CreateWindow()
-
-
-if __name__ == "__main__":
-    demo(1)
diff --git a/lib/pythonwin/pywin/Demos/demoutils.py b/lib/pythonwin/pywin/Demos/demoutils.py
deleted file mode 100644
index f6080c46..00000000
--- a/lib/pythonwin/pywin/Demos/demoutils.py
+++ /dev/null
@@ -1,67 +0,0 @@
-# Utilities for the demos
-
-import sys
-
-import win32api
-import win32con
-import win32ui
-
-NotScriptMsg = """\
-This demo program is not designed to be run as a Script, but is
-probably used by some other test program.  Please try another demo.
-"""
-
-NeedGUIMsg = """\
-This demo program can only be run from inside of Pythonwin
-
-You must start Pythonwin, and select 'Run' from the toolbar or File menu
-"""
-
-
-NeedAppMsg = """\
-This demo program is a 'Pythonwin Application'.
-
-It is more demo code than an example of Pythonwin's capabilities.
-
-To run it, you must execute the command:
-pythonwin.exe /app "%s"
-
-Would you like to execute it now?
-"""
-
-
-def NotAScript():
-    import win32ui
-
-    win32ui.MessageBox(NotScriptMsg, "Demos")
-
-
-def NeedGoodGUI():
-    from pywin.framework.app import HaveGoodGUI
-
-    rc = HaveGoodGUI()
-    if not rc:
-        win32ui.MessageBox(NeedGUIMsg, "Demos")
-    return rc
-
-
-def NeedApp():
-    import win32ui
-
-    rc = win32ui.MessageBox(NeedAppMsg % sys.argv[0], "Demos", win32con.MB_YESNO)
-    if rc == win32con.IDYES:
-        try:
-            parent = win32ui.GetMainFrame().GetSafeHwnd()
-            win32api.ShellExecute(
-                parent, None, "pythonwin.exe", '/app "%s"' % sys.argv[0], None, 1
-            )
-        except win32api.error as details:
-            win32ui.MessageBox("Error executing command - %s" % (details), "Demos")
-
-
-from pywin.framework.app import HaveGoodGUI
-
-if __name__ == "__main__":
-    import demoutils
-
-    demoutils.NotAScript()
diff --git a/lib/pythonwin/pywin/Demos/dibdemo.py b/lib/pythonwin/pywin/Demos/dibdemo.py
deleted file mode 100644
index 615227ab..00000000
--- a/lib/pythonwin/pywin/Demos/dibdemo.py
+++ /dev/null
@@ -1,73 +0,0 @@
-# A demo which creates a view and a frame which displays a PPM format bitmap
-#
-# This hasnnt been run in a while, as I dont have many of that format around!
-
-import win32api
-import win32con
-import win32ui
-
-
-class DIBView:
-    def __init__(self, doc, dib):
-        self.dib = dib
-        self.view = win32ui.CreateView(doc)
-        self.width = self.height = 0
-        # set up message handlers
-        # 		self.view.OnPrepareDC = self.OnPrepareDC
-        self.view.HookMessage(self.OnSize, win32con.WM_SIZE)
-
-    def OnSize(self, params):
-        lParam = params[3]
-        self.width = win32api.LOWORD(lParam)
-        self.height = win32api.HIWORD(lParam)
-
-    def OnDraw(self, ob, dc):
-        # set sizes used for "non strecth" mode.
-        self.view.SetScrollSizes(win32con.MM_TEXT, self.dib.GetSize())
-        dibSize = self.dib.GetSize()
-        dibRect = (0, 0, dibSize[0], dibSize[1])
-        # stretch BMP.
-        # self.dib.Paint(dc, (0,0,self.width, self.height),dibRect)
-        # non stretch.
-        self.dib.Paint(dc)
-
-
-class DIBDemo:
-    def __init__(self, filename, *bPBM):
-        # init data members
-        f = open(filename, "rb")
-        dib = win32ui.CreateDIBitmap()
-        if len(bPBM) > 0:
-            magic = f.readline()
-            if magic != "P6\n":
-                print("The file is not a PBM format file")
-                raise ValueError("Failed - The file is not a PBM format file")
-            # check magic?
-            rowcollist = f.readline().split()
-            cols = int(rowcollist[0])
-            rows = int(rowcollist[1])
-            f.readline()  # whats this one?
-            dib.LoadPBMData(f, (cols, rows))
-        else:
-            dib.LoadWindowsFormatFile(f)
-        f.close()
-        # create doc/view
-        self.doc = win32ui.CreateDoc()
-        self.dibView = DIBView(self.doc, dib)
-        self.frame = win32ui.CreateMDIFrame()
-        self.frame.LoadFrame()  # this will force OnCreateClient
-        self.doc.SetTitle("DIB Demo")
-        self.frame.ShowWindow()
-
-        # display the sucka
-        self.frame.ActivateFrame()
-
-    def OnCreateClient(self, createparams, context):
-        self.dibView.view.CreateWindow(self.frame)
-        return 1
-
-
-if __name__ == "__main__":
-    import demoutils
-
-    demoutils.NotAScript()
diff --git a/lib/pythonwin/pywin/Demos/dlgtest.py b/lib/pythonwin/pywin/Demos/dlgtest.py
deleted file mode 100644
index 8dcb0e5e..00000000
--- a/lib/pythonwin/pywin/Demos/dlgtest.py
+++ /dev/null
@@ -1,145 +0,0 @@
-# A Demo of Pythonwin's Dialog and Property Page support.
-
-###################
-#
-# First demo - use the built-in to Pythonwin "Tab Stop" dialog, but
-# customise it heavily.
-#
-# ID's for the tabstop dialog - out test.
-#
-import win32con
-import win32ui
-from pywin.mfc import dialog
-from win32con import IDCANCEL
-from win32ui import IDC_EDIT_TABS, IDC_PROMPT_TABS, IDD_SET_TABSTOPS
-
-
-class TestDialog(dialog.Dialog):
-    def __init__(self, modal=1):
-        dialog.Dialog.__init__(self, IDD_SET_TABSTOPS)
-        self.counter = 0
-        if modal:
-            self.DoModal()
-        else:
-            self.CreateWindow()
-
-    def OnInitDialog(self):
-        # Set the caption of the dialog itself.
-        self.SetWindowText("Used to be Tab Stops!")
-        # Get a child control, remember it, and change its text.
-        self.edit = self.GetDlgItem(IDC_EDIT_TABS)  # the text box.
-        self.edit.SetWindowText("Test")
-        # Hook a Windows message for the dialog.
-        self.edit.HookMessage(self.KillFocus, win32con.WM_KILLFOCUS)
-        # Get the prompt control, and change its next.
-        prompt = self.GetDlgItem(IDC_PROMPT_TABS)  # the prompt box.
-        prompt.SetWindowText("Prompt")
-        # And the same for the button..
-        cancel = self.GetDlgItem(IDCANCEL)  # the cancel button
-        cancel.SetWindowText("&Kill me")
-
-        # And just for demonstration purposes, we hook the notify message for the dialog.
-        # This allows us to be notified when the Edit Control text changes.
-        self.HookCommand(self.OnNotify, IDC_EDIT_TABS)
-
-    def OnNotify(self, controlid, code):
-        if code == win32con.EN_CHANGE:
-            print("Edit text changed!")
-        return 1  # I handled this, so no need to call defaults!
-
-    # kill focus for the edit box.
-    # Simply increment the value in the text box.
-    def KillFocus(self, msg):
-        self.counter = self.counter + 1
-        if self.edit != None:
-            self.edit.SetWindowText(str(self.counter))
-
-    # Called when the dialog box is terminating...
-    def OnDestroy(self, msg):
-        del self.edit
-        del self.counter
-
-
-# A very simply Property Sheet.
-# We only make a new class for demonstration purposes.
-class TestSheet(dialog.PropertySheet):
-    def __init__(self, title):
-        dialog.PropertySheet.__init__(self, title)
-        self.HookMessage(self.OnActivate, win32con.WM_ACTIVATE)
-
-    def OnActivate(self, msg):
-        pass
-
-
-# A very simply Property Page, which will be "owned" by the above
-# Property Sheet.
-# We create a new class, just so we can hook a control notification.
-class TestPage(dialog.PropertyPage):
-    def OnInitDialog(self):
-        # We use the HookNotify function to allow Python to respond to
-        # Windows WM_NOTIFY messages.
-        # In this case, we are interested in BN_CLICKED messages.
-        self.HookNotify(self.OnNotify, win32con.BN_CLICKED)
-
-    def OnNotify(self, std, extra):
-        print("OnNotify", std, extra)
-
-
-# Some code that actually uses these objects.
-def demo(modal=0):
-    TestDialog(modal)
-
-    # property sheet/page demo
-    ps = win32ui.CreatePropertySheet("Property Sheet/Page Demo")
-    # Create a completely standard PropertyPage.
-    page1 = win32ui.CreatePropertyPage(win32ui.IDD_PROPDEMO1)
-    # Create our custom property page.
-    page2 = TestPage(win32ui.IDD_PROPDEMO2)
-    ps.AddPage(page1)
-    ps.AddPage(page2)
-    if modal:
-        ps.DoModal()
-    else:
-        style = (
-            win32con.WS_SYSMENU
-            | win32con.WS_POPUP
-            | win32con.WS_CAPTION
-            | win32con.DS_MODALFRAME
-            | win32con.WS_VISIBLE
-        )
-        styleex = win32con.WS_EX_DLGMODALFRAME | win32con.WS_EX_PALETTEWINDOW
-        ps.CreateWindow(win32ui.GetMainFrame(), style, styleex)
-
-
-def test(modal=1):
-    # 	dlg=dialog.Dialog(1010)
-    # 	dlg.CreateWindow()
-    # 	dlg.EndDialog(0)
-    # 	del dlg
-    # 	return
-    # property sheet/page demo
-    ps = TestSheet("Property Sheet/Page Demo")
-    page1 = win32ui.CreatePropertyPage(win32ui.IDD_PROPDEMO1)
-    page2 = win32ui.CreatePropertyPage(win32ui.IDD_PROPDEMO2)
-    ps.AddPage(page1)
-    ps.AddPage(page2)
-    del page1
-    del page2
-    if modal:
-        ps.DoModal()
-    else:
-        ps.CreateWindow(win32ui.GetMainFrame())
-    return ps
-
-
-def d():
-    dlg = win32ui.CreateDialog(win32ui.IDD_DEBUGGER)
-    dlg.datalist.append((win32ui.IDC_DBG_RADIOSTACK, "radio"))
-    print("data list is ", dlg.datalist)
-    dlg.data["radio"] = 1
-    dlg.DoModal()
-    print(dlg.data["radio"])
-
-
-if __name__ == "__main__":
-    demo(1)
diff --git a/lib/pythonwin/pywin/Demos/dyndlg.py b/lib/pythonwin/pywin/Demos/dyndlg.py
deleted file mode 100644
index 46a4e7fc..00000000
--- a/lib/pythonwin/pywin/Demos/dyndlg.py
+++ /dev/null
@@ -1,104 +0,0 @@
-# dyndlg.py
-# contributed by Curt Hagenlocher <chi@earthlink.net>
-
-# Dialog Template params:
-# 	Parameter 0 - Window caption
-# 	Parameter 1 - Bounds (rect tuple)
-# 	Parameter 2 - Window style
-# 	Parameter 3 - Extended style
-# 	Parameter 4 - Font tuple
-# 	Parameter 5 - Menu name
-# 	Parameter 6 - Window class
-# Dialog item params:
-# 	Parameter 0 - Window class
-# 	Parameter 1 - Text
-# 	Parameter 2 - ID
-# 	Parameter 3 - Bounds
-# 	Parameter 4 - Style
-# 	Parameter 5 - Extended style
-# 	Parameter 6 - Extra data
-
-
-import win32con
-import win32ui
-from pywin.mfc import dialog, window
-
-
-def MakeDlgTemplate():
-    style = (
-        win32con.DS_MODALFRAME
-        | win32con.WS_POPUP
-        | win32con.WS_VISIBLE
-        | win32con.WS_CAPTION
-        | win32con.WS_SYSMENU
-        | win32con.DS_SETFONT
-    )
-    cs = win32con.WS_CHILD | win32con.WS_VISIBLE
-    dlg = [
-        ["Select Warehouse", (0, 0, 177, 93), style, None, (8, "MS Sans Serif")],
-    ]
-    dlg.append([130, "Current Warehouse:", -1, (7, 7, 69, 9), cs | win32con.SS_LEFT])
-    dlg.append([130, "ASTORIA", 128, (16, 17, 99, 7), cs | win32con.SS_LEFT])
-    dlg.append([130, "New &Warehouse:", -1, (7, 29, 69, 9), cs | win32con.SS_LEFT])
-    s = win32con.WS_TABSTOP | cs
-    # 	dlg.append([131, None, 130, (5, 40, 110, 48),
-    # 		s | win32con.LBS_NOTIFY | win32con.LBS_SORT | win32con.LBS_NOINTEGRALHEIGHT | win32con.WS_VSCROLL | win32con.WS_BORDER])
-    dlg.append(
-        [
-            "{8E27C92B-1264-101C-8A2F-040224009C02}",
-            None,
-            131,
-            (5, 40, 110, 48),
-            win32con.WS_TABSTOP,
-        ]
-    )
-
-    dlg.append(
-        [128, "OK", win32con.IDOK, (124, 5, 50, 14), s | win32con.BS_DEFPUSHBUTTON]
-    )
-    s = win32con.BS_PUSHBUTTON | s
-    dlg.append([128, "Cancel", win32con.IDCANCEL, (124, 22, 50, 14), s])
-    dlg.append([128, "&Help", 100, (124, 74, 50, 14), s])
-
-    return dlg
-
-
-def test1():
-    win32ui.CreateDialogIndirect(MakeDlgTemplate()).DoModal()
-
-
-def test2():
-    dialog.Dialog(MakeDlgTemplate()).DoModal()
-
-
-def test3():
-    dlg = win32ui.LoadDialogResource(win32ui.IDD_SET_TABSTOPS)
-    dlg[0][0] = "New Dialog Title"
-    dlg[0][1] = (80, 20, 161, 60)
-    dlg[1][1] = "&Confusion:"
-    cs = (
-        win32con.WS_CHILD
-        | win32con.WS_VISIBLE
-        | win32con.WS_TABSTOP
-        | win32con.BS_PUSHBUTTON
-    )
-    dlg.append([128, "&Help", 100, (111, 41, 40, 14), cs])
-    dialog.Dialog(dlg).DoModal()
-
-
-def test4():
-    page1 = dialog.PropertyPage(win32ui.LoadDialogResource(win32ui.IDD_PROPDEMO1))
-    page2 = dialog.PropertyPage(win32ui.LoadDialogResource(win32ui.IDD_PROPDEMO2))
-    ps = dialog.PropertySheet("Property Sheet/Page Demo", None, [page1, page2])
-    ps.DoModal()
-
-
-def testall():
-    test1()
-    test2()
-    test3()
-    test4()
-
-
-if __name__ == "__main__":
-    testall()
diff --git a/lib/pythonwin/pywin/Demos/fontdemo.py b/lib/pythonwin/pywin/Demos/fontdemo.py
deleted file mode 100644
index fc35f4ca..00000000
--- a/lib/pythonwin/pywin/Demos/fontdemo.py
+++ /dev/null
@@ -1,86 +0,0 @@
-# Demo of Generic document windows, DC, and Font usage
-# by Dave Brennan (brennan@hal.com)
-
-# usage examples:
-
-# >>> from fontdemo import *
-# >>> d = FontDemo('Hello, Python')
-# >>> f1 = { 'name':'Arial', 'height':36, 'weight':win32con.FW_BOLD}
-# >>> d.SetFont(f1)
-# >>> f2 = {'name':'Courier New', 'height':24, 'italic':1}
-# >>> d.SetFont (f2)
-
-import win32api
-import win32con
-import win32ui
-from pywin.mfc import docview
-
-# font is a dictionary in which the following elements matter:
-# (the best matching font to supplied parameters is returned)
-#   name		string name of the font as known by Windows
-#   size		point size of font in logical units
-#   weight		weight of font (win32con.FW_NORMAL, win32con.FW_BOLD)
-#   italic		boolean; true if set to anything but None
-#   underline	boolean; true if set to anything but None
-
-
-class FontView(docview.ScrollView):
-    def __init__(
-        self, doc, text="Python Rules!", font_spec={"name": "Arial", "height": 42}
-    ):
-        docview.ScrollView.__init__(self, doc)
-        self.font = win32ui.CreateFont(font_spec)
-        self.text = text
-        self.width = self.height = 0
-        # set up message handlers
-        self.HookMessage(self.OnSize, win32con.WM_SIZE)
-
-    def OnAttachedObjectDeath(self):
-        docview.ScrollView.OnAttachedObjectDeath(self)
-        del self.font
-
-    def SetFont(self, new_font):
-        # Change font on the fly
-        self.font = win32ui.CreateFont(new_font)
-        # redraw the entire client window
-        selfInvalidateRect(None)
-
-    def OnSize(self, params):
-        lParam = params[3]
-        self.width = win32api.LOWORD(lParam)
-        self.height = win32api.HIWORD(lParam)
-
-    def OnPrepareDC(self, dc, printinfo):
-        # Set up the DC for forthcoming OnDraw call
-        self.SetScrollSizes(win32con.MM_TEXT, (100, 100))
-        dc.SetTextColor(win32api.RGB(0, 0, 255))
-        dc.SetBkColor(win32api.GetSysColor(win32con.COLOR_WINDOW))
-        dc.SelectObject(self.font)
-        dc.SetTextAlign(win32con.TA_CENTER | win32con.TA_BASELINE)
-
-    def OnDraw(self, dc):
-        if self.width == 0 and self.height == 0:
-            left, top, right, bottom = self.GetClientRect()
-            self.width = right - left
-            self.height = bottom - top
-        x, y = self.width // 2, self.height // 2
-        dc.TextOut(x, y, self.text)
-
-
-def FontDemo():
-    # create doc/view
-    template = docview.DocTemplate(win32ui.IDR_PYTHONTYPE, None, None, FontView)
-    doc = template.OpenDocumentFile(None)
-    doc.SetTitle("Font Demo")
-    # 	print "template is ", template, "obj is", template._obj_
-    template.close()
-
-
-# 	print "closed"
-# 	del template
-
-if __name__ == "__main__":
-    import demoutils
-
-    if demoutils.NeedGoodGUI():
-        FontDemo()
diff --git a/lib/pythonwin/pywin/Demos/guidemo.py b/lib/pythonwin/pywin/Demos/guidemo.py
deleted file mode 100644
index b4d88159..00000000
--- a/lib/pythonwin/pywin/Demos/guidemo.py
+++ /dev/null
@@ -1,86 +0,0 @@
-# GUI Demo - just a worker script to invoke all the other demo/test scripts.
-import sys
-
-import __main__
-import regutil
-import win32api
-import win32ui
-
-demos = [  # 	('Font', 'import fontdemo;fontdemo.FontDemo()'),
-    ("Open GL Demo", "import openGLDemo;openGLDemo.test()"),
-    ("Threaded GUI", "import threadedgui;threadedgui.ThreadedDemo()"),
-    ("Tree View Demo", "import hiertest;hiertest.demoboth()"),
-    ("3-Way Splitter Window", "import splittst;splittst.demo()"),
-    ("Custom Toolbars and Tooltips", "import toolbar;toolbar.test()"),
-    ("Progress Bar", "import progressbar;progressbar.demo()"),
-    ("Slider Control", "import sliderdemo;sliderdemo.demo()"),
-    ("Dynamic window creation", "import createwin;createwin.demo()"),
-    ("Various Dialog demos", "import dlgtest;dlgtest.demo()"),
-    ("OCX Control Demo", "from ocx import ocxtest;ocxtest.demo()"),
-    ("OCX Serial Port Demo", "from ocx import ocxserialtest;	ocxserialtest.test()"),
-    (
-        "IE4 Control Demo",
-        'from ocx import webbrowser; webbrowser.Demo("http://www.python.org")',
-    ),
-]
-
-
-def demo():
-    try:
-        # seeif I can locate the demo files.
-        import fontdemo
-    except ImportError:
-        # else put the demos direectory on the path (if not already)
-        try:
-            instPath = regutil.GetRegistryDefaultValue(
-                regutil.BuildDefaultPythonKey() + "\\InstallPath"
-            )
-        except win32api.error:
-            print(
-                "The InstallPath can not be located, and the Demos directory is not on the path"
-            )
-            instPath = "."
-
-        demosDir = win32ui.FullPath(instPath + "\\Demos")
-        for path in sys.path:
-            if win32ui.FullPath(path) == demosDir:
-                break
-        else:
-            sys.path.append(demosDir)
-        import fontdemo
-
-    import sys
-
-    if "/go" in sys.argv:
-        for name, cmd in demos:
-            try:
-                exec(cmd)
-            except:
-                print(
-                    "Demo of %s failed - %s:%s"
-                    % (cmd, sys.exc_info()[0], sys.exc_info()[1])
-                )
-        return
-    # Otherwise allow the user to select the demo to run
-
-    import pywin.dialogs.list
-
-    while 1:
-        rc = pywin.dialogs.list.SelectFromLists("Select a Demo", demos, ["Demo Title"])
-        if rc is None:
-            break
-        title, cmd = demos[rc]
-        try:
-            exec(cmd)
-        except:
-            print(
-                "Demo of %s failed - %s:%s"
-                % (title, sys.exc_info()[0], sys.exc_info()[1])
-            )
-
-
-if __name__ == __main__.__name__:
-    import demoutils
-
-    if demoutils.NeedGoodGUI():
-        demo()
diff --git a/lib/pythonwin/pywin/Demos/hiertest.py b/lib/pythonwin/pywin/Demos/hiertest.py
deleted file mode 100644
index 287b71da..00000000
--- a/lib/pythonwin/pywin/Demos/hiertest.py
+++ /dev/null
@@ -1,138 +0,0 @@
-import os
-
-import commctrl
-import win32ui
-from pywin.mfc import docview, window
-from pywin.tools import hierlist
-
-
-# directory listbox
-# This has obvious limitations - doesnt track subdirs, etc.  Demonstrates
-# simple use of Python code for querying the tree as needed.
-# Only use strings, and lists of strings (from curdir())
-class DirHierList(hierlist.HierList):
-    def __init__(self, root, listBoxID=win32ui.IDC_LIST1):
-        hierlist.HierList.__init__(self, root, win32ui.IDB_HIERFOLDERS, listBoxID)
-
-    def GetText(self, item):
-        return os.path.basename(item)
-
-    def GetSubList(self, item):
-        if os.path.isdir(item):
-            ret = [os.path.join(item, fname) for fname in os.listdir(item)]
-        else:
-            ret = None
-        return ret
-
-    # if the item is a dir, it is expandable.
-    def IsExpandable(self, item):
-        return os.path.isdir(item)
-
-    def GetSelectedBitmapColumn(self, item):
-        return self.GetBitmapColumn(item) + 6  # Use different color for selection
-
-
-class TestDocument(docview.Document):
-    def __init__(self, template):
-        docview.Document.__init__(self, template)
-        self.hierlist = hierlist.HierListWithItems(
-            HLIFileDir("\\"), win32ui.IDB_HIERFOLDERS, win32ui.AFX_IDW_PANE_FIRST
-        )
-
-
-class HierListView(docview.TreeView):
-    def OnInitialUpdate(self):
-        rc = self._obj_.OnInitialUpdate()
-        self.hierList = self.GetDocument().hierlist
-        self.hierList.HierInit(self.GetParent())
-        self.hierList.SetStyle(
-            commctrl.TVS_HASLINES | commctrl.TVS_LINESATROOT | commctrl.TVS_HASBUTTONS
-        )
-        return rc
-
-
-class HierListFrame(window.MDIChildWnd):
-    pass
-
-
-def GetTestRoot():
-    tree1 = ("Tree 1", [("Item 1", "Item 1 data"), "Item 2", 3])
-    tree2 = ("Tree 2", [("Item 2.1", "Item 2 data"), "Item 2.2", 2.3])
-    return ("Root", [tree1, tree2, "Item 3"])
-
-
-def demoboth():
-    template = docview.DocTemplate(
-        win32ui.IDR_PYTHONTYPE, TestDocument, HierListFrame, HierListView
-    )
-    template.OpenDocumentFile(None).SetTitle("Hierlist demo")
-
-    demomodeless()
-
-
-def demomodeless():
-    testList2 = DirHierList("\\")
-    dlg = hierlist.HierDialog("hier list test", testList2)
-    dlg.CreateWindow()
-
-
-def demodlg():
-    testList2 = DirHierList("\\")
-    dlg = hierlist.HierDialog("hier list test", testList2)
-    dlg.DoModal()
-
-
-def demo():
-    template = docview.DocTemplate(
-        win32ui.IDR_PYTHONTYPE, TestDocument, HierListFrame, HierListView
-    )
-    template.OpenDocumentFile(None).SetTitle("Hierlist demo")
-
-
-#
-# Demo/Test for HierList items.
-#
-# Easy to make a better directory program.
-#
-class HLIFileDir(hierlist.HierListItem):
-    def __init__(self, filename):
-        self.filename = filename
-        hierlist.HierListItem.__init__(self)
-
-    def GetText(self):
-        try:
-            return "%-20s %d bytes" % (
-                os.path.basename(self.filename),
-                os.stat(self.filename)[6],
-            )
-        except os.error as details:
-            return "%-20s - %s" % (self.filename, details[1])
-
-    def IsExpandable(self):
-        return os.path.isdir(self.filename)
-
-    def GetSubList(self):
-        ret = []
-        for newname in os.listdir(self.filename):
-            if newname not in (".", ".."):
-                ret.append(HLIFileDir(os.path.join(self.filename, newname)))
-        return ret
-
-
-def demohli():
-    template = docview.DocTemplate(
-        win32ui.IDR_PYTHONTYPE,
-        TestDocument,
-        hierlist.HierListFrame,
-        hierlist.HierListView,
-    )
-    template.OpenDocumentFile(None).SetTitle("Hierlist demo")
-
-
-if __name__ == "__main__":
-    import demoutils
-
-    if demoutils.HaveGoodGUI():
-        demoboth()
-    else:
-        demodlg()
diff --git a/lib/pythonwin/pywin/Demos/menutest.py b/lib/pythonwin/pywin/Demos/menutest.py
deleted file mode 100644
index d2ba65b6..00000000
--- a/lib/pythonwin/pywin/Demos/menutest.py
+++ /dev/null
@@ -1,13 +0,0 @@
-# Run this as a python script, to gray "close" off the edit window system menu.
-import win32con
-from pywin.framework import interact
-
-if __name__ == "__main__":
-    import demoutils
-
-    if demoutils.NeedGoodGUI():
-        win = interact.edit.currentView.GetParent()
-        menu = win.GetSystemMenu()
-        id = menu.GetMenuItemID(6)
-        menu.EnableMenuItem(id, win32con.MF_BYCOMMAND | win32con.MF_GRAYED)
-        print("The interactive window's 'Close' menu item is now disabled.")
diff --git a/lib/pythonwin/pywin/Demos/objdoc.py b/lib/pythonwin/pywin/Demos/objdoc.py
deleted file mode 100644
index fff79253..00000000
--- a/lib/pythonwin/pywin/Demos/objdoc.py
+++ /dev/null
@@ -1,57 +0,0 @@
-# This is a sample file, and shows the basic framework for using an "Object" based
-# document, rather than a "filename" based document.
-# This is referenced by the Pythonwin .html documentation.
-
-# In the example below, the OpenObject() method is used instead of OpenDocumentFile,
-# and all the core MFC document open functionality is retained.
-
-import win32ui
-from pywin.mfc import docview
-
-
-class object_template(docview.DocTemplate):
-    def __init__(self):
-        docview.DocTemplate.__init__(self, None, None, None, object_view)
-
-    def OpenObject(self, object):  # Use this instead of OpenDocumentFile.
-        # Look for existing open document
-        for doc in self.GetDocumentList():
-            print("document is ", doc)
-            if doc.object is object:
-                doc.GetFirstView().ActivateFrame()
-                return doc
-        # not found - new one.
-        doc = object_document(self, object)
-        frame = self.CreateNewFrame(doc)
-        doc.OnNewDocument()
-        doc.SetTitle(str(object))
-        self.InitialUpdateFrame(frame, doc)
-        return doc
-
-
-class object_document(docview.Document):
-    def __init__(self, template, object):
-        docview.Document.__init__(self, template)
-        self.object = object
-
-    def OnOpenDocument(self, name):
-        raise RuntimeError("Should not be called if template strings set up correctly")
-        return 0
-
-
-class object_view(docview.EditView):
-    def OnInitialUpdate(self):
-        self.ReplaceSel("Object is %s" % repr(self.GetDocument().object))
-
-
-def demo():
-    t = object_template()
-    d = t.OpenObject(win32ui)
-    return (t, d)
-
-
-if __name__ == "__main__":
-    import demoutils
-
-    if demoutils.NeedGoodGUI():
-        demo()
diff --git a/lib/pythonwin/pywin/Demos/ocx/__init__.py b/lib/pythonwin/pywin/Demos/ocx/__init__.py
deleted file mode 100644
index e69de29b..00000000
diff --git a/lib/pythonwin/pywin/Demos/ocx/demoutils.py b/lib/pythonwin/pywin/Demos/ocx/demoutils.py
deleted file mode 100644
index 27fa091c..00000000
--- a/lib/pythonwin/pywin/Demos/ocx/demoutils.py
+++ /dev/null
@@ -1,67 +0,0 @@
-# Utilities for the demos
-
-import sys
-
-import win32api
-import win32con
-import win32ui
-
-NotScriptMsg = """\
-This demo program is not designed to be run as a Script, but is
-probably used by some other test program.  Please try another demo.
-"""
-
-NeedGUIMsg = """\
-This demo program can only be run from inside of Pythonwin
-
-You must start Pythonwin, and select 'Run' from the toolbar or File menu
-"""
-
-
-NeedAppMsg = """\
-This demo program is a 'Pythonwin Application'.
-
-It is more demo code than an example of Pythonwin's capabilities.
-
-To run it, you must execute the command:
-pythonwin.exe /app "%s"
-
-Would you like to execute it now?
-"""
-
-
-def NotAScript():
-    import win32ui
-
-    win32ui.MessageBox(NotScriptMsg, "Demos")
-
-
-def NeedGoodGUI():
-    from pywin.framework.app import HaveGoodGUI
-
-    rc = HaveGoodGUI()
-    if not rc:
-        win32ui.MessageBox(NeedGUIMsg, "Demos")
-    return rc
-
-
-def NeedApp():
-    import win32ui
-
-    rc = win32ui.MessageBox(NeedAppMsg % sys.argv[0], "Demos", win32con.MB_YESNO)
-    if rc == win32con.IDYES:
-        try:
-            parent = win32ui.GetMainFrame().GetSafeHwnd()
-            win32api.ShellExecute(
-                parent, None, "pythonwin.exe", '/app "%s"' % sys.argv[0], None, 1
-            )
-        except win32api.error as details:
-            win32ui.MessageBox("Error executing command - %s" % (details), "Demos")
-
-
-from pywin.framework.app import HaveGoodGUI
-
-if __name__ == "__main__":
-    from . import demoutils
-
-    demoutils.NotAScript()
diff --git a/lib/pythonwin/pywin/Demos/ocx/flash.py b/lib/pythonwin/pywin/Demos/ocx/flash.py
deleted file mode 100644
index 239240ee..00000000
--- a/lib/pythonwin/pywin/Demos/ocx/flash.py
+++ /dev/null
@@ -1,95 +0,0 @@
-# By Bradley Schatz
-# simple flash/python application demonstrating bidirectional
-# communicaion between flash and python. Click the sphere to see
-# behavior. Uses Bounce.swf from FlashBounce.zip, available from
-# http://pages.cpsc.ucalgary.ca/~saul/vb_examples/tutorial12/
-
-# Update to the path of the .swf file (note it could be a true URL)
-flash_url = "c:\\bounce.swf"
-
-import sys
-
-import regutil
-import win32api
-import win32con
-import win32ui
-from pywin.mfc import activex, window
-from win32com.client import gencache
-
-FlashModule = gencache.EnsureModule("{D27CDB6B-AE6D-11CF-96B8-444553540000}", 0, 1, 0)
-
-if FlashModule is None:
-    raise ImportError("Flash does not appear to be installed.")
-
-
-class MyFlashComponent(activex.Control, FlashModule.ShockwaveFlash):
-    def __init__(self):
-        activex.Control.__init__(self)
-        FlashModule.ShockwaveFlash.__init__(self)
-        self.x = 50
-        self.y = 50
-        self.angle = 30
-        self.started = 0
-
-    def OnFSCommand(self, command, args):
-        print("FSCommend", command, args)
-        self.x = self.x + 20
-        self.y = self.y + 20
-        self.angle = self.angle + 20
-        if self.x > 200 or self.y > 200:
-            self.x = 0
-            self.y = 0
-        if self.angle > 360:
-            self.angle = 0
-        self.SetVariable("xVal", self.x)
-        self.SetVariable("yVal", self.y)
-        self.SetVariable("angle", self.angle)
-        self.TPlay("_root.mikeBall")
-
-    def OnProgress(self, percentDone):
-        print("PercentDone", percentDone)
-
-    def OnReadyStateChange(self, newState):
-        # 0=Loading, 1=Uninitialized, 2=Loaded, 3=Interactive, 4=Complete
-        print("State", newState)
-
-
-class BrowserFrame(window.MDIChildWnd):
-    def __init__(self, url=None):
-        if url is None:
-            self.url = regutil.GetRegisteredHelpFile("Main Python Documentation")
-        else:
-            self.url = url
-        pass  # Dont call base class doc/view version...
-
-    def Create(self, title, rect=None, parent=None):
-        style = win32con.WS_CHILD | win32con.WS_VISIBLE | win32con.WS_OVERLAPPEDWINDOW
-        self._obj_ = win32ui.CreateMDIChild()
-        self._obj_.AttachObject(self)
-        self._obj_.CreateWindow(None, title, style, rect, parent)
-        rect = self.GetClientRect()
-        rect = (0, 0, rect[2] - rect[0], rect[3] - rect[1])
-        self.ocx = MyFlashComponent()
-        self.ocx.CreateControl(
-            "Flash Player", win32con.WS_VISIBLE | win32con.WS_CHILD, rect, self, 1000
-        )
-        self.ocx.LoadMovie(0, flash_url)
-        self.ocx.Play()
-        self.HookMessage(self.OnSize, win32con.WM_SIZE)
-
-    def OnSize(self, params):
-        rect = self.GetClientRect()
-        rect = (0, 0, rect[2] - rect[0], rect[3] - rect[1])
-        self.ocx.SetWindowPos(0, rect, 0)
-
-
-def Demo():
-    url = None
-    if len(sys.argv) > 1:
-        url = win32api.GetFullPathName(sys.argv[1])
-    f = BrowserFrame(url)
-    f.Create("Flash Player")
-
-
-if __name__ == "__main__":
-    Demo()
diff --git a/lib/pythonwin/pywin/Demos/ocx/msoffice.py b/lib/pythonwin/pywin/Demos/ocx/msoffice.py
deleted file mode 100644
index be24ead8..00000000
--- a/lib/pythonwin/pywin/Demos/ocx/msoffice.py
+++ /dev/null
@@ -1,152 +0,0 @@
-# This demo uses some of the Microsoft Office components.
-#
-# It was taken from an MSDN article showing how to embed excel.
-# It is not comlpete yet, but it _does_ show an Excel spreadsheet in a frame!
-#
-
-import regutil
-import win32con
-import win32ui
-import win32uiole
-from pywin.mfc import activex, docview, object, window
-from win32com.client import gencache
-
-# WordModule = gencache.EnsureModule('{00020905-0000-0000-C000-000000000046}', 1033, 8, 0)
-# if WordModule is None:
-# 	raise ImportError, "Microsoft Word version 8 does not appear to be installed."
-
-
-class OleClientItem(object.CmdTarget):
-    def __init__(self, doc):
-        object.CmdTarget.__init__(self, win32uiole.CreateOleClientItem(doc))
-
-    def OnGetItemPosition(self):
-        # For now return a hard-coded rect.
-        return (10, 10, 210, 210)
-
-    def OnActivate(self):
-        # Allow only one inplace activate item per frame
-        view = self.GetActiveView()
-        item = self.GetDocument().GetInPlaceActiveItem(view)
-        if item is not None and item._obj_ != self._obj_:
-            item.Close()
-        self._obj_.OnActivate()
-
-    def OnChange(self, oleNotification, dwParam):
-        self._obj_.OnChange(oleNotification, dwParam)
-        self.GetDocument().UpdateAllViews(None)
-
-    def OnChangeItemPosition(self, rect):
-        # During in-place activation CEmbed_ExcelCntrItem::OnChangeItemPosition
-        #  is called by the server to change the position of the in-place
-        #  window.  Usually, this is a result of the data in the server
-        #  document changing such that the extent has changed or as a result
-        #  of in-place resizing.
-        #
-        # The default here is to call the base class, which will call
-        #  COleClientItem::SetItemRects to move the item
-        #  to the new position.
-        if not self._obj_.OnChangeItemPosition(self, rect):
-            return 0
-
-        # TODO: update any cache you may have of the item's rectangle/extent
-        return 1
-
-
-class OleDocument(object.CmdTarget):
-    def __init__(self, template):
-        object.CmdTarget.__init__(self, win32uiole.CreateOleDocument(template))
-        self.EnableCompoundFile()
-
-
-class ExcelView(docview.ScrollView):
-    def OnInitialUpdate(self):
-        self.HookMessage(self.OnSetFocus, win32con.WM_SETFOCUS)
-        self.HookMessage(self.OnSize, win32con.WM_SIZE)
-
-        self.SetScrollSizes(win32con.MM_TEXT, (100, 100))
-        rc = self._obj_.OnInitialUpdate()
-        self.EmbedExcel()
-        return rc
-
-    def EmbedExcel(self):
-        doc = self.GetDocument()
-        self.clientItem = OleClientItem(doc)
-        self.clientItem.CreateNewItem("Excel.Sheet")
-        self.clientItem.DoVerb(-1, self)
-        doc.UpdateAllViews(None)
-
-    def OnDraw(self, dc):
-        doc = self.GetDocument()
-        pos = doc.GetStartPosition()
-        clientItem, pos = doc.GetNextItem(pos)
-        clientItem.Draw(dc, (10, 10, 210, 210))
-
-    # Special handling of OnSetFocus and OnSize are required for a container
-    #  when an object is being edited in-place.
-    def OnSetFocus(self, msg):
-        item = self.GetDocument().GetInPlaceActiveItem(self)
-        if (
-            item is not None
-            and item.GetItemState() == win32uiole.COleClientItem_activeUIState
-        ):
-            wnd = item.GetInPlaceWindow()
-            if wnd is not None:
-                wnd.SetFocus()
-            return 0  # Dont get the base version called.
-        return 1  # Call the base version.
-
-    def OnSize(self, params):
-        item = self.GetDocument().GetInPlaceActiveItem(self)
-        if item is not None:
-            item.SetItemRects()
-        return 1  # do call the base!
-
-
-class OleTemplate(docview.DocTemplate):
-    def __init__(
-        self, resourceId=None, MakeDocument=None, MakeFrame=None, MakeView=None
-    ):
-        if MakeDocument is None:
-            MakeDocument = OleDocument
-        if MakeView is None:
-            MakeView = ExcelView
-        docview.DocTemplate.__init__(
-            self, resourceId, MakeDocument, MakeFrame, MakeView
-        )
-
-
-class WordFrame(window.MDIChildWnd):
-    def __init__(self, doc=None):
-        self._obj_ = win32ui.CreateMDIChild()
-        self._obj_.AttachObject(self)
-        # Dont call base class doc/view version...
-
-    def Create(self, title, rect=None, parent=None):
-        style = win32con.WS_CHILD | win32con.WS_VISIBLE | win32con.WS_OVERLAPPEDWINDOW
-        self._obj_.CreateWindow(None, title, style, rect, parent)
-
-        rect = self.GetClientRect()
-        rect = (0, 0, rect[2] - rect[0], rect[3] - rect[1])
-        self.ocx = MyWordControl()
-        self.ocx.CreateControl(
-            "Microsoft Word", win32con.WS_VISIBLE | win32con.WS_CHILD, rect, self, 20000
-        )
-
-
-def Demo():
-    import sys
-
-    import win32api
-
-    docName = None
-    if len(sys.argv) > 1:
-        docName = win32api.GetFullPathName(sys.argv[1])
-    OleTemplate().OpenDocumentFile(None)
-
-
-# 	f = WordFrame(docName)
-# 	f.Create("Microsoft Office")
-
-if __name__ == "__main__":
-    Demo()
diff --git a/lib/pythonwin/pywin/Demos/ocx/ocxserialtest.py b/lib/pythonwin/pywin/Demos/ocx/ocxserialtest.py
deleted file mode 100644
index 326d312c..00000000
--- a/lib/pythonwin/pywin/Demos/ocx/ocxserialtest.py
+++ /dev/null
@@ -1,133 +0,0 @@
-# ocxserialtest.py
-#
-# Sample that uses the mscomm OCX to talk to a serial
-# device.
-
-# Very simple -  queries a modem for ATI responses
-
-import pythoncom
-import win32con
-import win32ui
-import win32uiole
-from pywin.mfc import activex, dialog
-from win32com.client import gencache
-
-SERIAL_SETTINGS = "19200,n,8,1"
-SERIAL_PORT = 2
-
-win32ui.DoWaitCursor(1)
-serialModule = gencache.EnsureModule("{648A5603-2C6E-101B-82B6-000000000014}", 0, 1, 1)
-win32ui.DoWaitCursor(0)
-if serialModule is None:
-    raise ImportError("MS COMM Control does not appear to be installed on the PC")
-
-
-def MakeDlgTemplate():
-    style = (
-        win32con.DS_MODALFRAME
-        | win32con.WS_POPUP
-        | win32con.WS_VISIBLE
-        | win32con.WS_CAPTION
-        | win32con.WS_SYSMENU
-        | win32con.DS_SETFONT
-    )
-    cs = win32con.WS_CHILD | win32con.WS_VISIBLE
-    dlg = [
-        ["Very Basic Terminal", (0, 0, 350, 180), style, None, (8, "MS Sans Serif")],
-    ]
-    s = win32con.WS_TABSTOP | cs
-    dlg.append(
-        [
-            "RICHEDIT",
-            None,
-            132,
-            (5, 5, 340, 170),
-            s
-            | win32con.ES_WANTRETURN
-            | win32con.ES_MULTILINE
-            | win32con.ES_AUTOVSCROLL
-            | win32con.WS_VSCROLL,
-        ]
-    )
-    return dlg
-
-
-####################################
-#
-# Serial Control
-#
-class MySerialControl(activex.Control, serialModule.MSComm):
-    def __init__(self, parent):
-        activex.Control.__init__(self)
-        serialModule.MSComm.__init__(self)
-        self.parent = parent
-
-    def OnComm(self):
-        self.parent.OnComm()
-
-
-class TestSerDialog(dialog.Dialog):
-    def __init__(self, *args):
-        dialog.Dialog.__init__(*(self,) + args)
-        self.olectl = None
-
-    def OnComm(self):
-        event = self.olectl.CommEvent
-        if event == serialModule.OnCommConstants.comEvReceive:
-            self.editwindow.ReplaceSel(self.olectl.Input)
-
-    def OnKey(self, key):
-        if self.olectl:
-            self.olectl.Output = chr(key)
-
-    def OnInitDialog(self):
-        rc = dialog.Dialog.OnInitDialog(self)
-        self.editwindow = self.GetDlgItem(132)
-        self.editwindow.HookAllKeyStrokes(self.OnKey)
-
-        self.olectl = MySerialControl(self)
-        try:
-            self.olectl.CreateControl(
-                "OCX",
-                win32con.WS_TABSTOP | win32con.WS_VISIBLE,
-                (7, 43, 500, 300),
-                self._obj_,
-                131,
-            )
-        except win32ui.error:
-            self.MessageBox("The Serial Control could not be created")
-            self.olectl = None
-            self.EndDialog(win32con.IDCANCEL)
-        if self.olectl:
-            self.olectl.Settings = SERIAL_SETTINGS
-            self.olectl.CommPort = SERIAL_PORT
-            self.olectl.RThreshold = 1
-            try:
-                self.olectl.PortOpen = 1
-            except pythoncom.com_error as details:
-                print(
-                    "Could not open the specified serial port - %s"
-                    % (details.excepinfo[2])
-                )
-                self.EndDialog(win32con.IDCANCEL)
-        return rc
-
-    def OnDestroy(self, msg):
-        if self.olectl:
-            try:
-                self.olectl.PortOpen = 0
-            except pythoncom.com_error as details:
-                print("Error closing port - %s" % (details.excepinfo[2]))
-        return dialog.Dialog.OnDestroy(self, msg)
-
-
-def test():
-    d = TestSerDialog(MakeDlgTemplate())
-    d.DoModal()
-
-
-if __name__ == "__main__":
-    from . import demoutils
-
-    if demoutils.NeedGoodGUI():
-        test()
diff --git a/lib/pythonwin/pywin/Demos/ocx/ocxtest.py b/lib/pythonwin/pywin/Demos/ocx/ocxtest.py
deleted file mode 100644
index 4a3d7336..00000000
--- a/lib/pythonwin/pywin/Demos/ocx/ocxtest.py
+++ /dev/null
@@ -1,250 +0,0 @@
-# OCX Tester for Pythonwin
-#
-# This file _is_ ready to run.  All that is required is that the OCXs being tested
-# are installed on your machine.
-#
-# The .py files behind the OCXs will be automatically generated and imported.
-
-import glob
-import os
-
-import win32api
-import win32con
-import win32ui
-import win32uiole
-from pywin.mfc import activex, dialog, window
-from win32com.client import gencache
-
-
-def MakeDlgTemplate():
-    style = (
-        win32con.DS_MODALFRAME
-        | win32con.WS_POPUP
-        | win32con.WS_VISIBLE
-        | win32con.WS_CAPTION
-        | win32con.WS_SYSMENU
-        | win32con.DS_SETFONT
-    )
-    cs = win32con.WS_CHILD | win32con.WS_VISIBLE
-    dlg = [
-        ["OCX Demos", (0, 0, 350, 350), style, None, (8, "MS Sans Serif")],
-    ]
-    s = win32con.WS_TABSTOP | cs
-    # 	dlg.append([131, None, 130, (5, 40, 110, 48),
-    # 		s | win32con.LBS_NOTIFY | win32con.LBS_SORT | win32con.LBS_NOINTEGRALHEIGHT | win32con.WS_VSCROLL | win32con.WS_BORDER])
-    # 	dlg.append(["{8E27C92B-1264-101C-8A2F-040224009C02}", None, 131, (5, 40, 110, 48),win32con.WS_TABSTOP])
-
-    dlg.append(
-        [128, "About", win32con.IDOK, (124, 5, 50, 14), s | win32con.BS_DEFPUSHBUTTON]
-    )
-    s = win32con.BS_PUSHBUTTON | s
-    dlg.append([128, "Close", win32con.IDCANCEL, (124, 22, 50, 14), s])
-
-    return dlg
-
-
-####################################
-#
-# Calendar test code
-#
-
-
-def GetTestCalendarClass():
-    global calendarParentModule
-    win32ui.DoWaitCursor(1)
-    calendarParentModule = gencache.EnsureModule(
-        "{8E27C92E-1264-101C-8A2F-040224009C02}", 0, 7, 0
-    )
-    win32ui.DoWaitCursor(0)
-    if calendarParentModule is None:
-        return None
-
-    class TestCalDialog(dialog.Dialog):
-        def OnInitDialog(self):
-            class MyCal(activex.Control, calendarParentModule.Calendar):
-                def OnAfterUpdate(self):
-                    print("OnAfterUpdate")
-
-                def OnClick(self):
-                    print("OnClick")
-
-                def OnDblClick(self):
-                    print("OnDblClick")
-
-                def OnKeyDown(self, KeyCode, Shift):
-                    print("OnKeyDown", KeyCode, Shift)
-
-                def OnKeyPress(self, KeyAscii):
-                    print("OnKeyPress", KeyAscii)
-
-                def OnKeyUp(self, KeyCode, Shift):
-                    print("OnKeyUp", KeyCode, Shift)
-
-                def OnBeforeUpdate(self, Cancel):
-                    print("OnBeforeUpdate", Cancel)
-
-                def OnNewMonth(self):
-                    print("OnNewMonth")
-
-                def OnNewYear(self):
-                    print("OnNewYear")
-
-            rc = dialog.Dialog.OnInitDialog(self)
-            self.olectl = MyCal()
-            try:
-                self.olectl.CreateControl(
-                    "OCX",
-                    win32con.WS_TABSTOP | win32con.WS_VISIBLE,
-                    (7, 43, 500, 300),
-                    self._obj_,
-                    131,
-                )
-            except win32ui.error:
-                self.MessageBox("The Calendar Control could not be created")
-                self.olectl = None
-                self.EndDialog(win32con.IDCANCEL)
-
-            return rc
-
-        def OnOK(self):
-            self.olectl.AboutBox()
-
-    return TestCalDialog
-
-
-####################################
-#
-# Video Control
-#
-def GetTestVideoModule():
-    global videoControlModule, videoControlFileName
-    win32ui.DoWaitCursor(1)
-    videoControlModule = gencache.EnsureModule(
-        "{05589FA0-C356-11CE-BF01-00AA0055595A}", 0, 2, 0
-    )
-    win32ui.DoWaitCursor(0)
-    if videoControlModule is None:
-        return None
-    fnames = glob.glob(os.path.join(win32api.GetWindowsDirectory(), "*.avi"))
-    if not fnames:
-        print("No AVI files available in system directory")
-        return None
-    videoControlFileName = fnames[0]
-    return videoControlModule
-
-
-def GetTestVideoDialogClass():
-    if GetTestVideoModule() is None:
-        return None
-
-    class TestVideoDialog(dialog.Dialog):
-        def OnInitDialog(self):
-            rc = dialog.Dialog.OnInitDialog(self)
-            try:
-                self.olectl = activex.MakeControlInstance(
-                    videoControlModule.ActiveMovie
-                )
-                self.olectl.CreateControl(
-                    "",
-                    win32con.WS_TABSTOP | win32con.WS_VISIBLE,
-                    (7, 43, 500, 300),
-                    self._obj_,
-                    131,
-                )
-            except win32ui.error:
-                self.MessageBox("The Video Control could not be created")
-                self.olectl = None
-                self.EndDialog(win32con.IDCANCEL)
-                return
-
-            self.olectl.FileName = videoControlFileName
-            # 			self.olectl.Run()
-            return rc
-
-        def OnOK(self):
-            self.olectl.AboutBox()
-
-    return TestVideoDialog
-
-
-###############
-#
-# An OCX in an MDI Frame
-#
-class OCXFrame(window.MDIChildWnd):
-    def __init__(self):
-        pass  # Dont call base class doc/view version...
-
-    def Create(self, controlClass, title, rect=None, parent=None):
-        style = win32con.WS_CHILD | win32con.WS_VISIBLE | win32con.WS_OVERLAPPEDWINDOW
-        self._obj_ = win32ui.CreateMDIChild()
-        self._obj_.AttachObject(self)
-        self._obj_.CreateWindow(None, title, style, rect, parent)
-
-        rect = self.GetClientRect()
-        rect = (0, 0, rect[2] - rect[0], rect[3] - rect[1])
-        self.ocx = controlClass()
-        self.ocx.CreateControl(
-            "", win32con.WS_VISIBLE | win32con.WS_CHILD, rect, self, 1000
-        )
-
-
-def MDITest():
-    calendarParentModule = gencache.EnsureModule(
-        "{8E27C92E-1264-101C-8A2F-040224009C02}", 0, 7, 0
-    )
-
-    class MyCal(activex.Control, calendarParentModule.Calendar):
-        def OnAfterUpdate(self):
-            print("OnAfterUpdate")
-
-        def OnClick(self):
-            print("OnClick")
-
-    f = OCXFrame()
-    f.Create(MyCal, "Calendar Test")
-
-
-def test1():
-    klass = GetTestCalendarClass()
-    if klass is None:
-        print(
-            "Can not test the MSAccess Calendar control - it does not appear to be installed"
-        )
-        return
-
-    d = klass(MakeDlgTemplate())
-    d.DoModal()
-
-
-def test2():
-    klass = GetTestVideoDialogClass()
-    if klass is None:
-        print("Can not test the Video OCX - it does not appear to be installed,")
-        print("or no AVI files can be found.")
-        return
-    d = klass(MakeDlgTemplate())
-    d.DoModal()
-    d = None
-
-
-def test3():
-    d = TestCOMMDialog(MakeDlgTemplate())
-    d.DoModal()
-    d = None
-
-
-def testall():
-    test1()
-    test2()
-
-
-def demo():
-    testall()
-
-
-if __name__ == "__main__":
-    from . import demoutils
-
-    if demoutils.NeedGoodGUI():
-        testall()
diff --git a/lib/pythonwin/pywin/Demos/ocx/webbrowser.py b/lib/pythonwin/pywin/Demos/ocx/webbrowser.py
deleted file mode 100644
index cc17445e..00000000
--- a/lib/pythonwin/pywin/Demos/ocx/webbrowser.py
+++ /dev/null
@@ -1,72 +0,0 @@
-# This demo uses the IE4 Web Browser control.
-
-# It catches an "OnNavigate" event, and updates the frame title.
-# (event stuff by Neil Hodgson)
-
-import sys
-
-import regutil
-import win32api
-import win32con
-import win32ui
-from pywin.mfc import activex, window
-from win32com.client import gencache
-
-WebBrowserModule = gencache.EnsureModule(
-    "{EAB22AC0-30C1-11CF-A7EB-0000C05BAE0B}", 0, 1, 1
-)
-if WebBrowserModule is None:
-    raise ImportError("IE4 does not appear to be installed.")
-
-
-class MyWebBrowser(activex.Control, WebBrowserModule.WebBrowser):
-    def OnBeforeNavigate2(
-        self, pDisp, URL, Flags, TargetFrameName, PostData, Headers, Cancel
-    ):
-        self.GetParent().OnNavigate(URL)
-        # print "BeforeNavigate2", pDisp, URL, Flags, TargetFrameName, PostData, Headers, Cancel
-
-
-class BrowserFrame(window.MDIChildWnd):
-    def __init__(self, url=None):
-        if url is None:
-            self.url = regutil.GetRegisteredHelpFile("Main Python Documentation")
-            if self.url is None:
-                self.url = "http://www.python.org"
-        else:
-            self.url = url
-        pass  # Dont call base class doc/view version...
-
-    def Create(self, title, rect=None, parent=None):
-        style = win32con.WS_CHILD | win32con.WS_VISIBLE | win32con.WS_OVERLAPPEDWINDOW
-        self._obj_ = win32ui.CreateMDIChild()
-        self._obj_.AttachObject(self)
-        self._obj_.CreateWindow(None, title, style, rect, parent)
-        rect = self.GetClientRect()
-        rect = (0, 0, rect[2] - rect[0], rect[3] - rect[1])
-        self.ocx = MyWebBrowser()
-        self.ocx.CreateControl(
-            "Web Browser", win32con.WS_VISIBLE | win32con.WS_CHILD, rect, self, 1000
-        )
-        self.ocx.Navigate(self.url)
-        self.HookMessage(self.OnSize, win32con.WM_SIZE)
-
-    def OnSize(self, params):
-        rect = self.GetClientRect()
-        rect = (0, 0, rect[2] - rect[0], rect[3] - rect[1])
-        self.ocx.SetWindowPos(0, rect, 0)
-
-    def OnNavigate(self, url):
-        title = "Web Browser - %s" % (url,)
-        self.SetWindowText(title)
-
-
-def Demo(url=None):
-    if url is None and len(sys.argv) > 1:
-        url = win32api.GetFullPathName(sys.argv[1])
-    f = BrowserFrame(url)
-    f.Create("Web Browser")
-
-
-if __name__ == "__main__":
-    Demo()
diff --git a/lib/pythonwin/pywin/Demos/openGLDemo.py b/lib/pythonwin/pywin/Demos/openGLDemo.py
deleted file mode 100644
index 9274949d..00000000
--- a/lib/pythonwin/pywin/Demos/openGLDemo.py
+++ /dev/null
@@ -1,370 +0,0 @@
-# Ported from the win32 and MFC OpenGL Samples.
-
-import sys
-
-from pywin.mfc import docview
-
-try:
-    from OpenGL.GL import *  # nopycln: import
-    from OpenGL.GLU import *  # nopycln: import
-except ImportError:
-    print("The OpenGL extensions do not appear to be installed.")
-    print("This Pythonwin demo can not run")
-    sys.exit(1)
-
-import timer
-import win32api
-import win32con
-import win32ui
-
-PFD_TYPE_RGBA = 0
-PFD_TYPE_COLORINDEX = 1
-PFD_MAIN_PLANE = 0
-PFD_OVERLAY_PLANE = 1
-PFD_UNDERLAY_PLANE = -1
-PFD_DOUBLEBUFFER = 0x00000001
-PFD_STEREO = 0x00000002
-PFD_DRAW_TO_WINDOW = 0x00000004
-PFD_DRAW_TO_BITMAP = 0x00000008
-PFD_SUPPORT_GDI = 0x00000010
-PFD_SUPPORT_OPENGL = 0x00000020
-PFD_GENERIC_FORMAT = 0x00000040
-PFD_NEED_PALETTE = 0x00000080
-PFD_NEED_SYSTEM_PALETTE = 0x00000100
-PFD_SWAP_EXCHANGE = 0x00000200
-PFD_SWAP_COPY = 0x00000400
-PFD_SWAP_LAYER_BUFFERS = 0x00000800
-PFD_GENERIC_ACCELERATED = 0x00001000
-PFD_DEPTH_DONTCARE = 0x20000000
-PFD_DOUBLEBUFFER_DONTCARE = 0x40000000
-PFD_STEREO_DONTCARE = 0x80000000
-
-
-# threeto8 = [0, 0o111>>1, 0o222>>1, 0o333>>1, 0o444>>1, 0o555>>1, 0o666>>1, 0o377]
-threeto8 = [0, 73 >> 1, 146 >> 1, 219 >> 1, 292 >> 1, 365 >> 1, 438 >> 1, 255]
-twoto8 = [0, 0x55, 0xAA, 0xFF]
-oneto8 = [0, 255]
-
-
-def ComponentFromIndex(i, nbits, shift):
-    # val = (unsigned char) (i >> shift);
-    val = (i >> shift) & 0xF
-    if nbits == 1:
-        val = val & 0x1
-        return oneto8[val]
-    elif nbits == 2:
-        val = val & 0x3
-        return twoto8[val]
-    elif nbits == 3:
-        val = val & 0x7
-        return threeto8[val]
-    else:
-        return 0
-
-
-OpenGLViewParent = docview.ScrollView
-
-
-class OpenGLView(OpenGLViewParent):
-    def PreCreateWindow(self, cc):
-        self.HookMessage(self.OnSize, win32con.WM_SIZE)
-        # An OpenGL window must be created with the following flags and must not
-        # include CS_PARENTDC for the class style. Refer to SetPixelFormat
-        # documentation in the "Comments" section for further information.
-        style = cc[5]
-        style = style | win32con.WS_CLIPSIBLINGS | win32con.WS_CLIPCHILDREN
-        cc = cc[0], cc[1], cc[2], cc[3], cc[4], style, cc[6], cc[7], cc[8]
-        cc = self._obj_.PreCreateWindow(cc)
-        return cc
-
-    def OnSize(self, params):
-        lParam = params[3]
-        cx = win32api.LOWORD(lParam)
-        cy = win32api.HIWORD(lParam)
-        glViewport(0, 0, cx, cy)
-
-        if self.oldrect[2] > cx or self.oldrect[3] > cy:
-            self.RedrawWindow()
-
-        self.OnSizeChange(cx, cy)
-
-        self.oldrect = self.oldrect[0], self.oldrect[1], cx, cy
-
-    def OnInitialUpdate(self):
-        self.SetScaleToFitSize(
-            (100, 100)
-        )  # or SetScrollSizes() - A Pythonwin requirement
-        return self._obj_.OnInitialUpdate()
-
-    # 		return rc
-
-    def OnCreate(self, cs):
-        self.oldrect = self.GetClientRect()
-        self._InitContexts()
-        self.Init()
-
-    def OnDestroy(self, msg):
-        self.Term()
-        self._DestroyContexts()
-        return OpenGLViewParent.OnDestroy(self, msg)
-
-    def OnDraw(self, dc):
-        self.DrawScene()
-
-    def OnEraseBkgnd(self, dc):
-        return 1
-
-    # The OpenGL helpers
-    def _SetupPixelFormat(self):
-        dc = self.dc.GetSafeHdc()
-        pfd = CreatePIXELFORMATDESCRIPTOR()
-        pfd.dwFlags = PFD_DRAW_TO_WINDOW | PFD_SUPPORT_OPENGL | PFD_DOUBLEBUFFER
-        pfd.iPixelType = PFD_TYPE_RGBA
-        pfd.cColorBits = 24
-        pfd.cDepthBits = 32
-        pfd.iLayerType = PFD_MAIN_PLANE
-        pixelformat = ChoosePixelFormat(dc, pfd)
-        SetPixelFormat(dc, pixelformat, pfd)
-        self._CreateRGBPalette()
-
-    def _CreateRGBPalette(self):
-        dc = self.dc.GetSafeHdc()
-        n = GetPixelFormat(dc)
-        pfd = DescribePixelFormat(dc, n)
-        if pfd.dwFlags & PFD_NEED_PALETTE:
-            n = 1 << pfd.cColorBits
-            pal = []
-            for i in range(n):
-                this = (
-                    ComponentFromIndex(i, pfd.cRedBits, pfd.cRedShift),
-                    ComponentFromIndex(i, pfd.cGreenBits, pfd.cGreenShift),
-                    ComponentFromIndex(i, pfd.cBlueBits, pfd.cBlueShift),
-                    0,
-                )
-                pal.append(this)
-            hpal = win32ui.CreatePalette(pal)
-            self.dc.SelectPalette(hpal, 0)
-            self.dc.RealizePalette()
-
-    def _InitContexts(self):
-        self.dc = self.GetDC()
-        self._SetupPixelFormat()
-        hrc = wglCreateContext(self.dc.GetSafeHdc())
-        wglMakeCurrent(self.dc.GetSafeHdc(), hrc)
-
-    def _DestroyContexts(self):
-        hrc = wglGetCurrentContext()
-        wglMakeCurrent(0, 0)
-        if hrc:
-            wglDeleteContext(hrc)
-
-    # The methods to support OpenGL
-    def DrawScene(self):
-        assert 0, "You must override this method"
-
-    def Init(self):
-        assert 0, "You must override this method"
-
-    def OnSizeChange(self, cx, cy):
-        pass
-
-    def Term(self):
-        pass
-
-
-class TestView(OpenGLView):
-    def OnSizeChange(self, right, bottom):
-        glClearColor(0.0, 0.0, 0.0, 1.0)
-        glClearDepth(1.0)
-        glEnable(GL_DEPTH_TEST)
-
-        glMatrixMode(GL_PROJECTION)
-        if bottom:
-            aspect = right / bottom
-        else:
-            aspect = 0  # When window created!
-        glLoadIdentity()
-        gluPerspective(45.0, aspect, 3.0, 7.0)
-        glMatrixMode(GL_MODELVIEW)
-
-        near_plane = 3.0
-        far_plane = 7.0
-        maxObjectSize = 3.0
-        self.radius = near_plane + maxObjectSize / 2.0
-
-    def Init(self):
-        pass
-
-    def DrawScene(self):
-        glClearColor(0.0, 0.0, 0.0, 1.0)
-        glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT)
-
-        glPushMatrix()
-        glTranslatef(0.0, 0.0, -self.radius)
-
-        self._DrawCone()
-
-        self._DrawPyramid()
-
-        glPopMatrix()
-        glFinish()
-
-        SwapBuffers(wglGetCurrentDC())
-
-    def _DrawCone(self):
-        glColor3f(0.0, 1.0, 0.0)
-
-        glPushMatrix()
-        glTranslatef(-1.0, 0.0, 0.0)
-        quadObj = gluNewQuadric()
-        gluQuadricDrawStyle(quadObj, GLU_FILL)
-        gluQuadricNormals(quadObj, GLU_SMOOTH)
-        gluCylinder(quadObj, 1.0, 0.0, 1.0, 20, 10)
-        # 		gluDeleteQuadric(quadObj);
-        glPopMatrix()
-
-    def _DrawPyramid(self):
-        glPushMatrix()
-        glTranslatef(1.0, 0.0, 0.0)
-        glBegin(GL_TRIANGLE_FAN)
-        glColor3f(1.0, 0.0, 0.0)
-        glVertex3f(0.0, 1.0, 0.0)
-        glColor3f(0.0, 1.0, 0.0)
-        glVertex3f(-1.0, 0.0, 0.0)
-        glColor3f(0.0, 0.0, 1.0)
-        glVertex3f(0.0, 0.0, 1.0)
-        glColor3f(0.0, 1.0, 0.0)
-        glVertex3f(1.0, 0.0, 0.0)
-        glEnd()
-        glPopMatrix()
-
-
-class CubeView(OpenGLView):
-    def OnSizeChange(self, right, bottom):
-        glClearColor(0.0, 0.0, 0.0, 1.0)
-        glClearDepth(1.0)
-        glEnable(GL_DEPTH_TEST)
-
-        glMatrixMode(GL_PROJECTION)
-        if bottom:
-            aspect = right / bottom
-        else:
-            aspect = 0  # When window created!
-        glLoadIdentity()
-        gluPerspective(45.0, aspect, 3.0, 7.0)
-        glMatrixMode(GL_MODELVIEW)
-
-        near_plane = 3.0
-        far_plane = 7.0
-        maxObjectSize = 3.0
-        self.radius = near_plane + maxObjectSize / 2.0
-
-    def Init(self):
-        self.busy = 0
-        self.wAngleY = 10.0
-        self.wAngleX = 1.0
-        self.wAngleZ = 5.0
-        self.timerid = timer.set_timer(150, self.OnTimer)
-
-    def OnTimer(self, id, timeVal):
-        self.DrawScene()
-
-    def Term(self):
-        timer.kill_timer(self.timerid)
-
-    def DrawScene(self):
-        if self.busy:
-            return
-        self.busy = 1
-
-        glClearColor(0.0, 0.0, 0.0, 1.0)
-        glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT)
-
-        glPushMatrix()
-
-        glTranslatef(0.0, 0.0, -self.radius)
-        glRotatef(self.wAngleX, 1.0, 0.0, 0.0)
-        glRotatef(self.wAngleY, 0.0, 1.0, 0.0)
-        glRotatef(self.wAngleZ, 0.0, 0.0, 1.0)
-
-        self.wAngleX = self.wAngleX + 1.0
-        self.wAngleY = self.wAngleY + 10.0
-        self.wAngleZ = self.wAngleZ + 5.0
-
-        glBegin(GL_QUAD_STRIP)
-        glColor3f(1.0, 0.0, 1.0)
-        glVertex3f(-0.5, 0.5, 0.5)
-
-        glColor3f(1.0, 0.0, 0.0)
-        glVertex3f(-0.5, -0.5, 0.5)
-
-        glColor3f(1.0, 1.0, 1.0)
-        glVertex3f(0.5, 0.5, 0.5)
-
-        glColor3f(1.0, 1.0, 0.0)
-        glVertex3f(0.5, -0.5, 0.5)
-
-        glColor3f(0.0, 1.0, 1.0)
-        glVertex3f(0.5, 0.5, -0.5)
-
-        glColor3f(0.0, 1.0, 0.0)
-        glVertex3f(0.5, -0.5, -0.5)
-
-        glColor3f(0.0, 0.0, 1.0)
-        glVertex3f(-0.5, 0.5, -0.5)
-
-        glColor3f(0.0, 0.0, 0.0)
-        glVertex3f(-0.5, -0.5, -0.5)
-
-        glColor3f(1.0, 0.0, 1.0)
-        glVertex3f(-0.5, 0.5, 0.5)
-
-        glColor3f(1.0, 0.0, 0.0)
-        glVertex3f(-0.5, -0.5, 0.5)
-
-        glEnd()
-
-        glBegin(GL_QUADS)
-        glColor3f(1.0, 0.0, 1.0)
-        glVertex3f(-0.5, 0.5, 0.5)
-
-        glColor3f(1.0, 1.0, 1.0)
-        glVertex3f(0.5, 0.5, 0.5)
-
-        glColor3f(0.0, 1.0, 1.0)
-        glVertex3f(0.5, 0.5, -0.5)
-
-        glColor3f(0.0, 0.0, 1.0)
-        glVertex3f(-0.5, 0.5, -0.5)
-        glEnd()
-
-        glBegin(GL_QUADS)
-        glColor3f(1.0, 0.0, 0.0)
-        glVertex3f(-0.5, -0.5, 0.5)
-
-        glColor3f(1.0, 1.0, 0.0)
-        glVertex3f(0.5, -0.5, 0.5)
-
-        glColor3f(0.0, 1.0, 0.0)
-        glVertex3f(0.5, -0.5, -0.5)
-
-        glColor3f(0.0, 0.0, 0.0)
-        glVertex3f(-0.5, -0.5, -0.5)
-        glEnd()
-
-        glPopMatrix()
-
-        glFinish()
-        SwapBuffers(wglGetCurrentDC())
-
-        self.busy = 0
-
-
-def test():
-    template = docview.DocTemplate(None, None, None, CubeView)
-    # 	template = docview.DocTemplate(None, None, None, TestView )
-    template.OpenDocumentFile(None)
-
-
-if __name__ == "__main__":
-    test()
diff --git a/lib/pythonwin/pywin/Demos/progressbar.py b/lib/pythonwin/pywin/Demos/progressbar.py
deleted file mode 100644
index 81cd7e38..00000000
--- a/lib/pythonwin/pywin/Demos/progressbar.py
+++ /dev/null
@@ -1,105 +0,0 @@
-#
-# Progress bar control example
-#
-# 	PyCProgressCtrl encapsulates the MFC CProgressCtrl class.  To use it,
-# 	you:
-#
-# 	- Create the control with win32ui.CreateProgressCtrl()
-# 	- Create the control window with PyCProgressCtrl.CreateWindow()
-# 	- Initialize the range if you want it to be other than (0, 100) using
-# 	  PyCProgressCtrl.SetRange()
-# 	- Either:
-# 	  - Set the step size with PyCProgressCtrl.SetStep(), and
-# 	  - Increment using PyCProgressCtrl.StepIt()
-# 	  or:
-# 	  - Set the amount completed using PyCProgressCtrl.SetPos()
-#
-# Example and progress bar code courtesy of KDL Technologies, Ltd., Hong Kong SAR, China.
-#
-
-import win32con
-import win32ui
-from pywin.mfc import dialog
-
-
-def MakeDlgTemplate():
-    style = (
-        win32con.DS_MODALFRAME
-        | win32con.WS_POPUP
-        | win32con.WS_VISIBLE
-        | win32con.WS_CAPTION
-        | win32con.WS_SYSMENU
-        | win32con.DS_SETFONT
-    )
-    cs = win32con.WS_CHILD | win32con.WS_VISIBLE
-
-    w = 215
-    h = 36
-
-    dlg = [
-        [
-            "Progress bar control example",
-            (0, 0, w, h),
-            style,
-            None,
-            (8, "MS Sans Serif"),
-        ],
-    ]
-
-    s = win32con.WS_TABSTOP | cs
-
-    dlg.append(
-        [
-            128,
-            "Tick",
-            win32con.IDOK,
-            (10, h - 18, 50, 14),
-            s | win32con.BS_DEFPUSHBUTTON,
-        ]
-    )
-
-    dlg.append(
-        [
-            128,
-            "Cancel",
-            win32con.IDCANCEL,
-            (w - 60, h - 18, 50, 14),
-            s | win32con.BS_PUSHBUTTON,
-        ]
-    )
-
-    return dlg
-
-
-class TestDialog(dialog.Dialog):
-    def OnInitDialog(self):
-        rc = dialog.Dialog.OnInitDialog(self)
-        self.pbar = win32ui.CreateProgressCtrl()
-        self.pbar.CreateWindow(
-            win32con.WS_CHILD | win32con.WS_VISIBLE, (10, 10, 310, 24), self, 1001
-        )
-        # self.pbar.SetStep (5)
-        self.progress = 0
-        self.pincr = 5
-        return rc
-
-    def OnOK(self):
-        # NB: StepIt wraps at the end if you increment past the upper limit!
-        # self.pbar.StepIt()
-        self.progress = self.progress + self.pincr
-        if self.progress > 100:
-            self.progress = 100
-        if self.progress <= 100:
-            self.pbar.SetPos(self.progress)
-
-
-def demo(modal=0):
-    d = TestDialog(MakeDlgTemplate())
-    if modal:
-        d.DoModal()
-    else:
-        d.CreateWindow()
-
-
-if __name__ == "__main__":
-    demo(1)
diff --git a/lib/pythonwin/pywin/Demos/sliderdemo.py b/lib/pythonwin/pywin/Demos/sliderdemo.py
deleted file mode 100644
index 9fc7b570..00000000
--- a/lib/pythonwin/pywin/Demos/sliderdemo.py
+++ /dev/null
@@ -1,76 +0,0 @@
-# sliderdemo.py
-# Demo of the slider control courtesy of Mike Fletcher.
-
-import win32con
-import win32ui
-from pywin.mfc import dialog
-
-
-class MyDialog(dialog.Dialog):
-    """
-    Example using simple controls
-    """
-
-    _dialogstyle = (
-        win32con.WS_MINIMIZEBOX
-        | win32con.WS_DLGFRAME
-        | win32con.DS_MODALFRAME
-        | win32con.WS_POPUP
-        | win32con.WS_VISIBLE
-        | win32con.WS_CAPTION
-        | win32con.WS_SYSMENU
-        | win32con.DS_SETFONT
-    )
-    _buttonstyle = (
-        win32con.BS_PUSHBUTTON
-        | win32con.WS_TABSTOP
-        | win32con.WS_CHILD
-        | win32con.WS_VISIBLE
-    )
-    ### The static template, contains all "normal" dialog items
-    DIALOGTEMPLATE = [
-        # the dialog itself is the first element in the template
-        ["Example slider", (0, 0, 50, 43), _dialogstyle, None, (8, "MS SansSerif")],
-        # rest of elements are the controls within the dialog
-        # standard "Close" button
-        [128, "Close", win32con.IDCANCEL, (0, 30, 50, 13), _buttonstyle],
-    ]
-    ### ID of the control to be created during dialog initialisation
-    IDC_SLIDER = 9500
-
-    def __init__(self):
-        dialog.Dialog.__init__(self, self.DIALOGTEMPLATE)
-
-    def OnInitDialog(self):
-        rc = dialog.Dialog.OnInitDialog(self)
-        # now initialise your controls that you want to create
-        # programmatically, including those which are OLE controls
-        # those created directly by win32ui.Create*
-        # and your "custom controls" which are subclasses/whatever
-        win32ui.EnableControlContainer()
-        self.slider = win32ui.CreateSliderCtrl()
-        self.slider.CreateWindow(
-            win32con.WS_TABSTOP | win32con.WS_VISIBLE,
-            (0, 0, 100, 30),
-            self._obj_,
-            self.IDC_SLIDER,
-        )
-        self.HookMessage(self.OnSliderMove, win32con.WM_HSCROLL)
-        return rc
-
-    def OnSliderMove(self, params):
-        print("Slider moved")
-
-    def OnCancel(self):
-        print("The slider control is at position", self.slider.GetPos())
-        self._obj_.OnCancel()
-
-
-###
-def demo():
-    dia = MyDialog()
-    dia.DoModal()
-
-
-if __name__ == "__main__":
-    demo()
diff --git a/lib/pythonwin/pywin/Demos/splittst.py b/lib/pythonwin/pywin/Demos/splittst.py
deleted file mode 100644
index 0114bf09..00000000
--- a/lib/pythonwin/pywin/Demos/splittst.py
+++ /dev/null
@@ -1,79 +0,0 @@
-import commctrl
-import fontdemo
-import win32ui
-from pywin.mfc import docview, window
-
-# derive from CMDIChild.  This does much work for us.
-
-
-class SplitterFrame(window.MDIChildWnd):
-    def __init__(self):
-        # call base CreateFrame
-        self.images = None
-        window.MDIChildWnd.__init__(self)
-
-    def OnCreateClient(self, cp, context):
-        splitter = win32ui.CreateSplitter()
-        doc = context.doc
-        frame_rect = self.GetWindowRect()
-        size = ((frame_rect[2] - frame_rect[0]), (frame_rect[3] - frame_rect[1]) // 2)
-        sub_size = (size[0] // 2, size[1])
-        splitter.CreateStatic(self, 2, 1)
-        self.v1 = win32ui.CreateEditView(doc)
-        self.v2 = fontdemo.FontView(doc)
-        # CListControl view
-        self.v3 = win32ui.CreateListView(doc)
-        sub_splitter = win32ui.CreateSplitter()
-        # pass "splitter" so each view knows how to get to the others
-        sub_splitter.CreateStatic(splitter, 1, 2)
-        sub_splitter.CreateView(self.v1, 0, 0, (sub_size))
-        sub_splitter.CreateView(self.v2, 0, 1, (0, 0))  # size ignored.
-        splitter.SetRowInfo(0, size[1], 0)
-        splitter.CreateView(self.v3, 1, 0, (0, 0))  # size ignored.
-        # Setup items in the imagelist
-        self.images = win32ui.CreateImageList(32, 32, 1, 5, 5)
-        self.images.Add(win32ui.GetApp().LoadIcon(win32ui.IDR_MAINFRAME))
-        self.images.Add(win32ui.GetApp().LoadIcon(win32ui.IDR_PYTHONCONTYPE))
-        self.images.Add(win32ui.GetApp().LoadIcon(win32ui.IDR_TEXTTYPE))
-        self.v3.SetImageList(self.images, commctrl.LVSIL_NORMAL)
-        self.v3.InsertItem(0, "Icon 1", 0)
-        self.v3.InsertItem(0, "Icon 2", 1)
-        self.v3.InsertItem(0, "Icon 3", 2)
-        # 		self.v3.Arrange(commctrl.LVA_DEFAULT) Hmmm - win95 aligns left always???
-        return 1
-
-    def OnDestroy(self, msg):
-        window.MDIChildWnd.OnDestroy(self, msg)
-        if self.images:
-            self.images.DeleteImageList()
-            self.images = None
-
-    def InitialUpdateFrame(self, doc, makeVisible):
-        self.v1.ReplaceSel("Hello from Edit Window 1")
-        self.v1.SetModifiedFlag(0)
-
-
-class SampleTemplate(docview.DocTemplate):
-    def __init__(self):
-        docview.DocTemplate.__init__(
-            self, win32ui.IDR_PYTHONTYPE, None, SplitterFrame, None
-        )
-
-    def InitialUpdateFrame(self, frame, doc, makeVisible):
-        # 		print "frame is ", frame, frame._obj_
-        # 		print "doc is ", doc, doc._obj_
-        self._obj_.InitialUpdateFrame(frame, doc, makeVisible)  # call default handler.
-        frame.InitialUpdateFrame(doc, makeVisible)
-
-
-def demo():
-    template = SampleTemplate()
-    doc = template.OpenDocumentFile(None)
-    doc.SetTitle("Splitter Demo")
-
-
-if __name__ == "__main__":
-    import demoutils
-
-    if demoutils.NeedGoodGUI():
-        demo()
diff --git a/lib/pythonwin/pywin/Demos/threadedgui.py b/lib/pythonwin/pywin/Demos/threadedgui.py
deleted file mode 100644
index bbe1369e..00000000
--- a/lib/pythonwin/pywin/Demos/threadedgui.py
+++ /dev/null
@@ -1,189 +0,0 @@
-# Demo of using just windows, without documents and views.
-
-# Also demo of a GUI thread, pretty much direct from the MFC C++ sample MTMDI.
-
-import timer
-import win32api
-import win32con
-import win32ui
-from pywin.mfc import docview, thread, window
-from pywin.mfc.thread import WinThread
-
-WM_USER_PREPARE_TO_CLOSE = win32con.WM_USER + 32
-
-# font is a dictionary in which the following elements matter:
-# (the best matching font to supplied parameters is returned)
-#   name		string name of the font as known by Windows
-#   size		point size of font in logical units
-#   weight		weight of font (win32con.FW_NORMAL, win32con.FW_BOLD)
-#   italic		boolean; true if set to anything but None
-#   underline	boolean; true if set to anything but None
-
-
-# This window is a child window of a frame.  It is not the frame window itself.
-class FontWindow(window.Wnd):
-    def __init__(self, text="Python Rules!"):
-        window.Wnd.__init__(self)
-        self.text = text
-        self.index = 0
-        self.incr = 1
-        self.width = self.height = 0
-        self.ChangeAttributes()
-        # set up message handlers
-
-    def Create(self, title, style, rect, parent):
-        classStyle = win32con.CS_HREDRAW | win32con.CS_VREDRAW
-        className = win32ui.RegisterWndClass(
-            classStyle, 0, win32con.COLOR_WINDOW + 1, 0
-        )
-        self._obj_ = win32ui.CreateWnd()
-        self._obj_.AttachObject(self)
-        self._obj_.CreateWindow(
-            className, title, style, rect, parent, win32ui.AFX_IDW_PANE_FIRST
-        )
-        self.HookMessage(self.OnSize, win32con.WM_SIZE)
-        self.HookMessage(self.OnPrepareToClose, WM_USER_PREPARE_TO_CLOSE)
-        self.HookMessage(self.OnDestroy, win32con.WM_DESTROY)
-        self.timerid = timer.set_timer(100, self.OnTimer)
-        self.InvalidateRect()
-
-    def OnDestroy(self, msg):
-        timer.kill_timer(self.timerid)
-
-    def OnTimer(self, id, timeVal):
-        self.index = self.index + self.incr
-        if self.index > len(self.text):
-            self.incr = -1
-            self.index = len(self.text)
-        elif self.index < 0:
-            self.incr = 1
-            self.index = 0
-        self.InvalidateRect()
-
-    def OnPaint(self):
-        # 		print "Paint message from thread", win32api.GetCurrentThreadId()
-        dc, paintStruct = self.BeginPaint()
-        self.OnPrepareDC(dc, None)
-
-        if self.width == 0 and self.height == 0:
-            left, top, right, bottom = self.GetClientRect()
-            self.width = right - left
-            self.height = bottom - top
-        x, y = self.width // 2, self.height // 2
-        dc.TextOut(x, y, self.text[: self.index])
-        self.EndPaint(paintStruct)
-
-    def ChangeAttributes(self):
-        font_spec = {"name": "Arial", "height": 42}
-        self.font = win32ui.CreateFont(font_spec)
-
-    def OnPrepareToClose(self, params):
-        self.DestroyWindow()
-
-    def OnSize(self, params):
-        lParam = params[3]
-        self.width = win32api.LOWORD(lParam)
-        self.height = win32api.HIWORD(lParam)
-
-    def OnPrepareDC(self, dc, printinfo):
-        # Set up the DC for forthcoming OnDraw call
-        dc.SetTextColor(win32api.RGB(0, 0, 255))
-        dc.SetBkColor(win32api.GetSysColor(win32con.COLOR_WINDOW))
-        dc.SelectObject(self.font)
-        dc.SetTextAlign(win32con.TA_CENTER | win32con.TA_BASELINE)
-
-
-class FontFrame(window.MDIChildWnd):
-    def __init__(self):
-        pass  # Dont call base class doc/view version...
-
-    def Create(self, title, rect=None, parent=None):
-        style = win32con.WS_CHILD | win32con.WS_VISIBLE | win32con.WS_OVERLAPPEDWINDOW
-        self._obj_ = win32ui.CreateMDIChild()
-        self._obj_.AttachObject(self)
-
-        self._obj_.CreateWindow(None, title, style, rect, parent)
-        rect = self.GetClientRect()
-        rect = (0, 0, rect[2] - rect[0], rect[3] - rect[1])
-        self.child = FontWindow("Not threaded")
-        self.child.Create(
-            "FontDemo", win32con.WS_CHILD | win32con.WS_VISIBLE, rect, self
-        )
-
-
-class TestThread(WinThread):
-    def __init__(self, parentWindow):
-        self.parentWindow = parentWindow
-        self.child = None
-        WinThread.__init__(self)
-
-    def InitInstance(self):
-        rect = self.parentWindow.GetClientRect()
-        rect = (0, 0, rect[2] - rect[0], rect[3] - rect[1])
-
-        self.child = FontWindow()
-        self.child.Create(
-            "FontDemo", win32con.WS_CHILD | win32con.WS_VISIBLE, rect, self.parentWindow
-        )
-        self.SetMainFrame(self.child)
-        return WinThread.InitInstance(self)
-
-    def ExitInstance(self):
-        return 0
-
-
-class ThreadedFontFrame(window.MDIChildWnd):
-    def __init__(self):
-        pass  # Dont call base class doc/view version...
-        self.thread = None
-
-    def Create(self, title, rect=None, parent=None):
-        style = win32con.WS_CHILD | win32con.WS_VISIBLE | win32con.WS_OVERLAPPEDWINDOW
-        self._obj_ = win32ui.CreateMDIChild()
-        self._obj_.CreateWindow(None, title, style, rect, parent)
-        self._obj_.HookMessage(self.OnDestroy, win32con.WM_DESTROY)
-        self._obj_.HookMessage(self.OnSize, win32con.WM_SIZE)
-
-        self.thread = TestThread(self)
-        self.thread.CreateThread()
-
-    def OnSize(self, msg):
-        pass
-
-    def OnDestroy(self, msg):
-        win32ui.OutputDebugString("OnDestroy\n")
-        if self.thread and self.thread.child:
-            child = self.thread.child
-            child.SendMessage(WM_USER_PREPARE_TO_CLOSE, 0, 0)
-            win32ui.OutputDebugString("Destroyed\n")
-
-
-def Demo():
-    f = FontFrame()
-    f.Create("Font Demo")
-
-
-def ThreadedDemo():
-    rect = win32ui.GetMainFrame().GetMDIClient().GetClientRect()
-    rect = rect[0], int(rect[3] * 3 / 4), int(rect[2] / 4), rect[3]
-    incr = rect[2]
-    for i in range(4):
-        if i == 0:
-            f = FontFrame()
-            title = "Not threaded"
-        else:
-            f = ThreadedFontFrame()
-            title = "Threaded GUI Demo"
-        f.Create(title, rect)
-        rect = rect[0] + incr, rect[1], rect[2] + incr, rect[3]
-    # Givem a chance to start
-    win32api.Sleep(100)
-    win32ui.PumpWaitingMessages()
-
-
-if __name__ == "__main__":
-    import demoutils
-
-    if demoutils.NeedGoodGUI():
-        ThreadedDemo()
-# 		Demo()
diff --git a/lib/pythonwin/pywin/Demos/toolbar.py b/lib/pythonwin/pywin/Demos/toolbar.py
deleted file mode 100644
index e56aefef..00000000
--- a/lib/pythonwin/pywin/Demos/toolbar.py
+++ /dev/null
@@ -1,106 +0,0 @@
-# Demo of ToolBars
-
-# Shows the toolbar control.
-# Demos how to make custom tooltips, etc.
-
-import commctrl
-import win32api
-import win32con
-import win32ui
-from pywin.mfc import afxres, docview, window
-
-
-class GenericFrame(window.MDIChildWnd):
-    def OnCreateClient(self, cp, context):
-        # handlers for toolbar buttons
-        self.HookCommand(self.OnPrevious, 401)
-        self.HookCommand(self.OnNext, 402)
-        # Its not necessary for us to hook both of these - the
-        # common controls should fall-back all by themselves.
-        # Indeed, given we hook TTN_NEEDTEXTW, commctrl.TTN_NEEDTEXTA
-        # will not be called.
-        self.HookNotify(self.GetTTText, commctrl.TTN_NEEDTEXT)
-        self.HookNotify(self.GetTTText, commctrl.TTN_NEEDTEXTW)
-
-        # 		parent = win32ui.GetMainFrame()
-        parent = self
-        style = (
-            win32con.WS_CHILD
-            | win32con.WS_VISIBLE
-            | afxres.CBRS_SIZE_DYNAMIC
-            | afxres.CBRS_TOP
-            | afxres.CBRS_TOOLTIPS
-            | afxres.CBRS_FLYBY
-        )
-
-        buttons = (win32ui.ID_APP_ABOUT, win32ui.ID_VIEW_INTERACTIVE)
-        bitmap = win32ui.IDB_BROWSER_HIER
-        tbid = 0xE840
-        self.toolbar = tb = win32ui.CreateToolBar(parent, style, tbid)
-        tb.LoadBitmap(bitmap)
-        tb.SetButtons(buttons)
-
-        tb.EnableDocking(afxres.CBRS_ALIGN_ANY)
-        tb.SetWindowText("Test")
-        parent.EnableDocking(afxres.CBRS_ALIGN_ANY)
-        parent.DockControlBar(tb)
-        parent.LoadBarState("ToolbarTest")
-        window.MDIChildWnd.OnCreateClient(self, cp, context)
-        return 1
-
-    def OnDestroy(self, msg):
-        self.SaveBarState("ToolbarTest")
-
-    def GetTTText(self, std, extra):
-        (hwndFrom, idFrom, code) = std
-        text, hinst, flags = extra
-        if flags & commctrl.TTF_IDISHWND:
-            return  # Not handled
-        if idFrom == win32ui.ID_APP_ABOUT:
-            # our 'extra' return value needs to be the following
-            # entries from a NMTTDISPINFO[W] struct:
-            # (szText, hinst, uFlags).  None means 'don't change
-            # the value'
-            return 0, ("It works!", None, None)
-        return None  # not handled.
-
-    def GetMessageString(self, id):
-        if id == win32ui.ID_APP_ABOUT:
-            return "Dialog Test\nTest"
-        else:
-            return self._obj_.GetMessageString(id)
-
-    def OnSize(self, params):
-        print("OnSize called with ", params)
-
-    def OnNext(self, id, cmd):
-        print("OnNext called")
-
-    def OnPrevious(self, id, cmd):
-        print("OnPrevious called")
-
-
-msg = """\
-This toolbar was dynamically created.\r
-\r
-The first item's tooltips is provided by Python code.\r
-\r
-(Dont close the window with the toolbar in a floating state - it may not re-appear!)\r
-"""
-
-
-def test():
-    template = docview.DocTemplate(
-        win32ui.IDR_PYTHONTYPE, None, GenericFrame, docview.EditView
-    )
-    doc = template.OpenDocumentFile(None)
-    doc.SetTitle("Toolbar Test")
-    view = doc.GetFirstView()
-    view.SetWindowText(msg)
-
-
-if __name__ == "__main__":
-    import demoutils
-
-    if demoutils.NeedGoodGUI():
-        test()
diff --git a/lib/pythonwin/pywin/IDLE.cfg b/lib/pythonwin/pywin/IDLE.cfg
deleted file mode 100644
index b1987b14..00000000
--- a/lib/pythonwin/pywin/IDLE.cfg
+++ /dev/null
@@ -1,29 +0,0 @@
-[General]
-# We base this configuration on the default config.
-# You can list "Based On" as many times as you like
-Based On          = default
-
-[Keys]
-# Only list keys different to default.
-# Note you may wish to rebind some of the default
-# Pythonwin keys to "Beep" or "DoNothing"
-
-Alt+L             = LocateSelectedFile
-Ctrl+Q            = AppExit
-
-# Other non-default Pythonwin keys
-Alt+A             = EditSelectAll
-Alt+M             = LocateModule
-
-# Movement
-Ctrl+D            = GotoEndOfFile
-
-# Tabs and other indent features
-Alt+T            = <<toggle-tabs>>
-Ctrl+[            = <<indent-region>>
-Ctrl+]            = <<dedent-region>>
-
-[Keys:Interactive]
-Alt+P             = <<history-previous>>
-Alt+N             = <<history-next>>
-
diff --git a/lib/pythonwin/pywin/__init__.py b/lib/pythonwin/pywin/__init__.py
deleted file mode 100644
index 2e44fba5..00000000
--- a/lib/pythonwin/pywin/__init__.py
+++ /dev/null
@@ -1,10 +0,0 @@
-# is_platform_unicode is an old variable that was never correctly used and
-# is no longer referenced in pywin32.  It is staying for a few releases incase
-# others are looking at it, but it will go away soon!
-is_platform_unicode = 0
-
-# Ditto default_platform_encoding - not referenced and will die.
-default_platform_encoding = "mbcs"
-
-# This one *is* real and used - but in practice can't be changed.
-default_scintilla_encoding = "utf-8"  # Scintilla _only_ supports this ATM
diff --git a/lib/pythonwin/pywin/default.cfg b/lib/pythonwin/pywin/default.cfg
deleted file mode 100644
index 55371f6b..00000000
--- a/lib/pythonwin/pywin/default.cfg
+++ /dev/null
@@ -1,215 +0,0 @@
-# The default keyboard etc configuration file for Pythonwin.
-#
-# The format of this file is very similar to a Windows INI file.
-# Sections are identified with [Section] lines, but comments
-# use the standatd Python # character.  Depending on the section,
-# lines may not be in the standard "key=value" format.
-
-# NOTE:  You should not need to modify this file.
-# Simply create a new .CFG file, and add an entry:
-# [General]
-# BasedOn = Default
-#
-# and add your customisations.  Then select your new configuration 
-# from the Pythonwin View/Options/Editor dialog.
-# This way you get to add your own customisations,
-# but still take advantage of changes to the default
-# configuration in new releases.
-
-# See IDLE.cfg for an example extension configuration.
-#
-##########################################################################
-
-[IDLE Extensions]
-
-# The list of IDLE extensions to load.  The extensions
-# AutoIndent, AutoFormat and possibly others are
-# "built-in", so do not need specifying.
-
-FormatParagraph
-CallTips
-
-
-[Keys]
-
-# The list of _default_ key definitions.  
-#  See [Keys:Interactive] and [Keys:Editor] below for further defs.
-
-#Events of the format <<event-name>> 
-# are events defined in IDLE extensions.
-
-Alt+Q             = <<format-paragraph>>
-
-Ctrl+W            = ViewWhitespace
-Ctrl+Shift+8      = ViewWhitespace # The MSVC default key def.
-
-Ctrl+Shift+F      = ViewFixedFont
-
-# Auto-complete, call-tips, etc.
-Alt+/             = <<expand-word>>
-Ctrl+Space   = <<expand-word>>
-(           = <<paren-open>>
-)           = <<paren-close>>
-Up                = <<check-calltip-cancel>>
-Down              = <<check-calltip-cancel>>
-Left              = <<check-calltip-cancel>>
-Right             = <<check-calltip-cancel>>
-.                 = KeyDot
-
-# Debugger - These are the MSVC default keys, for want of a better choice.
-F9                = DbgBreakpointToggle
-F5                = DbgGo
-Shift+F5          = DbgClose
-F11               = DbgStep
-F10               = DbgStepOver
-Shift+F11         = DbgStepOut
-
-Ctrl+F3           = AutoFindNext
-
-
-[Keys:Editor]
-# Key bindings specific to the editor
-F2                = GotoNextBookmark
-Ctrl+F2           = ToggleBookmark
-Ctrl+G            = GotoLine
-
-Alt+I             = ShowInteractiveWindow
-Alt-B             = AddBanner # A sample Event defined in this file.
-
-# Block operations
-Alt+3             = <<comment-region>>
-Shift+Alt+3       = <<uncomment-region>>
-Alt+4             = <<uncomment-region>> # IDLE default.
-Alt+5             = <<tabify-region>>
-Alt+6             = <<untabify-region>>
-
-# Tabs and other indent features
-Back              = <<smart-backspace>>
-Ctrl+T            = <<toggle-tabs>>
-Alt+U             = <<change-indentwidth>>
-Enter             = EnterKey
-Tab               = TabKey
-Shift-Tab         = <<dedent-region>>
-
-# Folding
-Add               = FoldExpand
-Alt+Add           = FoldExpandAll
-Shift+Add         = FoldExpandSecondLevel
-Subtract          = FoldCollapse
-Alt+Subtract      = FoldCollapseAll
-Shift+Subtract    = FoldCollapseSecondLevel
-Multiply          = FoldTopLevel
-
-[Keys:Interactive]
-# Key bindings specific to the interactive window.
-# History for the interactive window
-Ctrl+Up           = <<history-previous>>
-Ctrl+Down         = <<history-next>>
-Enter             = ProcessEnter
-Ctrl+Enter        = ProcessEnter
-Shift+Enter       = ProcessEnter
-Esc               = ProcessEsc
-Alt+I             = WindowBack # Toggle back to previous window.
-Home              = InteractiveHome # A sample Event defined in this file.
-Shift+Home        = InteractiveHomeExtend # A sample Event defined in this file.
-
-# When docked, the Ctrl+Tab and Shift+Ctrl+Tab keys dont work as expected.
-Ctrl+Tab          = MDINext
-Ctrl+Shift+Tab    = MDIPrev
-
-[Extensions]
-# Python event handlers specific to this config file.
-# All functions not starting with an "_" are assumed
-# to be events, and take 2 params:
-# * editor_window is the same object passed to IDLE
-#   extensions.  editor_window.text is a text widget
-#   that conforms to the Tk text widget interface.
-# * event is the event being fired.  Will always be None
-#   in the current implementation.
-
-# Simply by defining these functions, they are available as
-# events.
-# Note that we bind keystrokes to these events in the various
-# [Keys] sections.
-
-# Add a simple file/class/function simple banner
-def AddBanner(editor_window, event):
-
-	text = editor_window.text
-	big_line = "#" * 70
-	banner = "%s\n## \n## \n## \n%s\n" % (big_line, big_line)
-
-	# Insert at the start of the current line.
-	pos = text.index("insert linestart")
-
-	text.undo_block_start() # Allow action to be undone as a single unit.
-	text.insert(pos, banner)
-	text.undo_block_stop()
-
-	# Now set the insert point to the middle of the banner.
-	line, col = [int(s) for s in pos.split(".")]
-	text.mark_set("insert", "%d.1 lineend" % (line+2, ) )
-
-
-# Here is a sample event bound to the "Home" key in the
-# interactive window
-def InteractiveHome(editor_window, event):
-	return _DoInteractiveHome(editor_window.text, 0)
-
-def InteractiveHomeExtend(editor_window, event):
-	return _DoInteractiveHome(editor_window.text, 1)
-
-def _DoInteractiveHome(text, extend):
-	import sys
-	# If Scintilla has an autocomplete window open, then let Scintilla handle it.
-	if text.edit.SCIAutoCActive():
-		return 1
-	of_interest = "insert linestart + %d c" % len(sys.ps1)
-	if not text.compare("insert", "==", of_interest) and \
-	   text.get("insert linestart", of_interest) in [sys.ps1, sys.ps2]: # Not sys.ps? line
-		end = of_interest
-	else:
-		end = "insert linestart"
-
-	if extend: start = "insert"
-	else: start = end
-	text.tag_add("sel", start, end)
-
-# From Niki Spahie
-def AutoFindNext(editor_window, event):
-    "find selected text or word under cursor"
-
-    from pywin.scintilla import find
-    from pywin.scintilla import scintillacon
-
-    try:
-        sci = editor_window.edit
-        word = sci.GetSelText()
-        if word:
-            find.lastSearch.findText = word
-            find.lastSearch.sel = sci.GetSel()
-        else:
-            pos = sci.SendScintilla( scintillacon.SCI_GETCURRENTPOS )
-            start = sci.SendScintilla( scintillacon.SCI_WORDSTARTPOSITION, pos, 1 )
-            end = sci.SendScintilla( scintillacon.SCI_WORDENDPOSITION, pos, 1 )
-            word = sci.GetTextRange( start, end )
-            if word:
-                find.lastSearch.findText = word
-                find.lastSearch.sel = (start,end)
-    except Exception:
-        import traceback
-        traceback.print_exc()
-    find.FindNext()
-
-
-# A couple of generic events.
-def Beep(editor_window, event):
-	editor_window.text.beep()
-
-def DoNothing(editor_window, event):
-	pass
-
-def ContinueEvent(editor_window, event):
-	# Almost an "unbind" - allows Pythonwin/MFC to handle the keystroke
-	return 1
-
diff --git a/lib/pythonwin/pywin/dialogs/__init__.py b/lib/pythonwin/pywin/dialogs/__init__.py
deleted file mode 100644
index e69de29b..00000000
diff --git a/lib/pythonwin/pywin/dialogs/ideoptions.py b/lib/pythonwin/pywin/dialogs/ideoptions.py
deleted file mode 100644
index f1bae90d..00000000
--- a/lib/pythonwin/pywin/dialogs/ideoptions.py
+++ /dev/null
@@ -1,139 +0,0 @@
-# The property page to define generic IDE options for Pythonwin
-
-import win32con
-import win32ui
-from pywin.framework import interact
-from pywin.mfc import dialog
-
-buttonControlMap = {
-    win32ui.IDC_BUTTON1: win32ui.IDC_EDIT1,
-    win32ui.IDC_BUTTON2: win32ui.IDC_EDIT2,
-    win32ui.IDC_BUTTON3: win32ui.IDC_EDIT3,
-}
-
-
-class OptionsPropPage(dialog.PropertyPage):
-    def __init__(self):
-        dialog.PropertyPage.__init__(self, win32ui.IDD_PP_IDE)
-        self.AddDDX(win32ui.IDC_CHECK1, "bShowAtStartup")
-        self.AddDDX(win32ui.IDC_CHECK2, "bDocking")
-        self.AddDDX(win32ui.IDC_EDIT4, "MRUSize", "i")
-
-    def OnInitDialog(self):
-        edit = self.GetDlgItem(win32ui.IDC_EDIT1)
-        format = eval(
-            win32ui.GetProfileVal(
-                interact.sectionProfile,
-                interact.STYLE_INTERACTIVE_PROMPT,
-                str(interact.formatInput),
-            )
-        )
-        edit.SetDefaultCharFormat(format)
-        edit.SetWindowText("Input Text")
-
-        edit = self.GetDlgItem(win32ui.IDC_EDIT2)
-        format = eval(
-            win32ui.GetProfileVal(
-                interact.sectionProfile,
-                interact.STYLE_INTERACTIVE_OUTPUT,
-                str(interact.formatOutput),
-            )
-        )
-        edit.SetDefaultCharFormat(format)
-        edit.SetWindowText("Output Text")
-
-        edit = self.GetDlgItem(win32ui.IDC_EDIT3)
-        format = eval(
-            win32ui.GetProfileVal(
-                interact.sectionProfile,
-                interact.STYLE_INTERACTIVE_ERROR,
-                str(interact.formatOutputError),
-            )
-        )
-        edit.SetDefaultCharFormat(format)
-        edit.SetWindowText("Error Text")
-
-        self["bShowAtStartup"] = interact.LoadPreference("Show at startup", 1)
-        self["bDocking"] = interact.LoadPreference("Docking", 0)
-        self["MRUSize"] = win32ui.GetProfileVal("Settings", "Recent File List Size", 10)
-
-        # Hook the button clicks.
-        self.HookCommand(self.HandleCharFormatChange, win32ui.IDC_BUTTON1)
-        self.HookCommand(self.HandleCharFormatChange, win32ui.IDC_BUTTON2)
-        self.HookCommand(self.HandleCharFormatChange, win32ui.IDC_BUTTON3)
-
-        # Ensure the spin control remains in range.
-        spinner = self.GetDlgItem(win32ui.IDC_SPIN1)
-        spinner.SetRange(1, 16)
-
-        return dialog.PropertyPage.OnInitDialog(self)
-
-    # Called to save away the new format tuple for the specified item.
-    def HandleCharFormatChange(self, id, code):
-        if code == win32con.BN_CLICKED:
-            editId = buttonControlMap.get(id)
-            assert editId is not None, "Format button has no associated edit control"
-            editControl = self.GetDlgItem(editId)
-            existingFormat = editControl.GetDefaultCharFormat()
-            flags = win32con.CF_SCREENFONTS
-            d = win32ui.CreateFontDialog(existingFormat, flags, None, self)
-            if d.DoModal() == win32con.IDOK:
-                cf = d.GetCharFormat()
-                editControl.SetDefaultCharFormat(cf)
-                self.SetModified(1)
-            return 0  # We handled this fully!
-
-    def OnOK(self):
-        # Handle the edit controls - get all the fonts, put them back into interact, then
-        # get interact to save its stuff!
-        controlAttrs = [
-            (win32ui.IDC_EDIT1, interact.STYLE_INTERACTIVE_PROMPT),
-            (win32ui.IDC_EDIT2, interact.STYLE_INTERACTIVE_OUTPUT),
-            (win32ui.IDC_EDIT3, interact.STYLE_INTERACTIVE_ERROR),
-        ]
-        for id, key in controlAttrs:
-            control = self.GetDlgItem(id)
-            fmt = control.GetDefaultCharFormat()
-            win32ui.WriteProfileVal(interact.sectionProfile, key, str(fmt))
-
-        # Save the other interactive window options.
-        interact.SavePreference("Show at startup", self["bShowAtStartup"])
-        interact.SavePreference("Docking", self["bDocking"])
-
-        # And the other options.
-        win32ui.WriteProfileVal("Settings", "Recent File List Size", self["MRUSize"])
-
-        return 1
-
-    def ChangeFormat(self, fmtAttribute, fmt):
-        dlg = win32ui.CreateFontDialog(fmt)
-        if dlg.DoModal() != win32con.IDOK:
-            return None
-        return dlg.GetCharFormat()
-
-    def OnFormatTitle(self, command, code):
-        fmt = self.GetFormat(interact.formatTitle)
-        if fmt:
-            formatTitle = fmt
-            SaveFontPreferences()
-
-    def OnFormatInput(self, command, code):
-        global formatInput
-        fmt = self.GetFormat(formatInput)
-        if fmt:
-            formatInput = fmt
-            SaveFontPreferences()
-
-    def OnFormatOutput(self, command, code):
-        global formatOutput
-        fmt = self.GetFormat(formatOutput)
-        if fmt:
-            formatOutput = fmt
-            SaveFontPreferences()
-
-    def OnFormatError(self, command, code):
-        global formatOutputError
-        fmt = self.GetFormat(formatOutputError)
-        if fmt:
-            formatOutputError = fmt
-            SaveFontPreferences()
diff --git a/lib/pythonwin/pywin/dialogs/list.py b/lib/pythonwin/pywin/dialogs/list.py
deleted file mode 100644
index b9934ce7..00000000
--- a/lib/pythonwin/pywin/dialogs/list.py
+++ /dev/null
@@ -1,143 +0,0 @@
-import commctrl
-import win32api
-import win32con
-import win32ui
-from pywin.mfc import dialog
-
-
-class ListDialog(dialog.Dialog):
-    def __init__(self, title, list):
-        dialog.Dialog.__init__(self, self._maketemplate(title))
-        self.HookMessage(self.on_size, win32con.WM_SIZE)
-        self.HookNotify(self.OnListItemChange, commctrl.LVN_ITEMCHANGED)
-        self.HookCommand(self.OnListClick, win32ui.IDC_LIST1)
-        self.items = list
-
-    def _maketemplate(self, title):
-        style = win32con.WS_DLGFRAME | win32con.WS_SYSMENU | win32con.WS_VISIBLE
-        ls = (
-            win32con.WS_CHILD
-            | win32con.WS_VISIBLE
-            | commctrl.LVS_ALIGNLEFT
-            | commctrl.LVS_REPORT
-        )
-        bs = win32con.WS_CHILD | win32con.WS_VISIBLE
-        return [
-            [title, (0, 0, 200, 200), style, None, (8, "MS Sans Serif")],
-            ["SysListView32", None, win32ui.IDC_LIST1, (0, 0, 200, 200), ls],
-            [128, "OK", win32con.IDOK, (10, 0, 50, 14), bs | win32con.BS_DEFPUSHBUTTON],
-            [128, "Cancel", win32con.IDCANCEL, (0, 0, 50, 14), bs],
-        ]
-
-    def FillList(self):
-        size = self.GetWindowRect()
-        width = size[2] - size[0] - (10)
-        itemDetails = (commctrl.LVCFMT_LEFT, width, "Item", 0)
-        self.itemsControl.InsertColumn(0, itemDetails)
-        index = 0
-        for item in self.items:
-            index = self.itemsControl.InsertItem(index + 1, str(item), 0)
-
-    def OnListClick(self, id, code):
-        if code == commctrl.NM_DBLCLK:
-            self.EndDialog(win32con.IDOK)
-        return 1
-
-    def OnListItemChange(self, std, extra):
-        (hwndFrom, idFrom, code), (
-            itemNotify,
-            sub,
-            newState,
-            oldState,
-            change,
-            point,
-            lparam,
-        ) = (std, extra)
-        oldSel = (oldState & commctrl.LVIS_SELECTED) != 0
-        newSel = (newState & commctrl.LVIS_SELECTED) != 0
-        if oldSel != newSel:
-            try:
-                self.selecteditem = itemNotify
-                self.butOK.EnableWindow(1)
-            except win32ui.error:
-                self.selecteditem = None
-
-    def OnInitDialog(self):
-        rc = dialog.Dialog.OnInitDialog(self)
-        self.itemsControl = self.GetDlgItem(win32ui.IDC_LIST1)
-        self.butOK = self.GetDlgItem(win32con.IDOK)
-        self.butCancel = self.GetDlgItem(win32con.IDCANCEL)
-
-        self.FillList()
-
-        size = self.GetWindowRect()
-        self.LayoutControls(size[2] - size[0], size[3] - size[1])
-        self.butOK.EnableWindow(0)  # wait for first selection
-        return rc
-
-    def LayoutControls(self, w, h):
-        self.itemsControl.MoveWindow((0, 0, w, h - 30))
-        self.butCancel.MoveWindow((10, h - 24, 60, h - 4))
-        self.butOK.MoveWindow((w - 60, h - 24, w - 10, h - 4))
-
-    def on_size(self, params):
-        lparam = params[3]
-        w = win32api.LOWORD(lparam)
-        h = win32api.HIWORD(lparam)
-        self.LayoutControls(w, h)
-
-
-class ListsDialog(ListDialog):
-    def __init__(self, title, list, colHeadings=["Item"]):
-        ListDialog.__init__(self, title, list)
-        self.colHeadings = colHeadings
-
-    def FillList(self):
-        index = 0
-        size = self.GetWindowRect()
-        width = (
-            size[2] - size[0] - (10) - win32api.GetSystemMetrics(win32con.SM_CXVSCROLL)
-        )
-        numCols = len(self.colHeadings)
-
-        for col in self.colHeadings:
-            itemDetails = (commctrl.LVCFMT_LEFT, int(width / numCols), col, 0)
-            self.itemsControl.InsertColumn(index, itemDetails)
-            index = index + 1
-        index = 0
-        for items in self.items:
-            index = self.itemsControl.InsertItem(index + 1, str(items[0]), 0)
-            for itemno in range(1, numCols):
-                item = items[itemno]
-                self.itemsControl.SetItemText(index, itemno, str(item))
-
-
-def SelectFromList(title, lst):
-    dlg = ListDialog(title, lst)
-    if dlg.DoModal() == win32con.IDOK:
-        return dlg.selecteditem
-    else:
-        return None
-
-
-def SelectFromLists(title, lists, headings):
-    dlg = ListsDialog(title, lists, headings)
-    if dlg.DoModal() == win32con.IDOK:
-        return dlg.selecteditem
-    else:
-        return None
-
-
-def test():
-    # 	print SelectFromList('Single list',  [1,2,3])
-    print(
-        SelectFromLists(
-            "Multi-List",
-            [("1", 1, "a"), ("2", 2, "b"), ("3", 3, "c")],
-            ["Col 1", "Col 2"],
-        )
-    )
-
-
-if __name__ == "__main__":
-    test()
diff --git a/lib/pythonwin/pywin/dialogs/login.py b/lib/pythonwin/pywin/dialogs/login.py
deleted file mode 100644
index 2a329569..00000000
--- a/lib/pythonwin/pywin/dialogs/login.py
+++ /dev/null
@@ -1,156 +0,0 @@
-"""login -- PythonWin user ID and password dialog box
-
-(Adapted from originally distributed with Mark Hammond's PythonWin - 
-this now replaces it!)
-
-login.GetLogin() displays a modal "OK/Cancel" dialog box with input
-fields for a user ID and password. The password field input is masked
-with *'s. GetLogin takes two optional parameters, a window title, and a
-default user ID. If these parameters are omitted, the title defaults to
-"Login", and the user ID is left blank. GetLogin returns a (userid, password)
-tuple. GetLogin can be called from scripts running on the console - i.e. you
-don't need to write a full-blown GUI app to use it.
-
-login.GetPassword() is similar, except there is no username field.
-
-Example:
-import pywin.dialogs.login
-title = "FTP Login"
-def_user = "fred"
-userid, password = pywin.dialogs.login.GetLogin(title, def_user)
-
-Jim Eggleston, 28 August 1996
-Merged with dlgpass and moved to pywin.dialogs by Mark Hammond Jan 1998.
-"""
-
-import win32api
-import win32con
-import win32ui
-from pywin.mfc import dialog
-
-
-def MakeLoginDlgTemplate(title):
-    style = (
-        win32con.DS_MODALFRAME
-        | win32con.WS_POPUP
-        | win32con.WS_VISIBLE
-        | win32con.WS_CAPTION
-        | win32con.WS_SYSMENU
-        | win32con.DS_SETFONT
-    )
-    cs = win32con.WS_CHILD | win32con.WS_VISIBLE
-
-    # Window frame and title
-    dlg = [
-        [title, (0, 0, 184, 40), style, None, (8, "MS Sans Serif")],
-    ]
-
-    # ID label and text box
-    dlg.append([130, "User ID:", -1, (7, 9, 69, 9), cs | win32con.SS_LEFT])
-    s = cs | win32con.WS_TABSTOP | win32con.WS_BORDER
-    dlg.append(["EDIT", None, win32ui.IDC_EDIT1, (50, 7, 60, 12), s])
-
-    # Password label and text box
-    dlg.append([130, "Password:", -1, (7, 22, 69, 9), cs | win32con.SS_LEFT])
-    s = cs | win32con.WS_TABSTOP | win32con.WS_BORDER
-    dlg.append(
-        ["EDIT", None, win32ui.IDC_EDIT2, (50, 20, 60, 12), s | win32con.ES_PASSWORD]
-    )
-
-    # OK/Cancel Buttons
-    s = cs | win32con.WS_TABSTOP
-    dlg.append(
-        [128, "OK", win32con.IDOK, (124, 5, 50, 14), s | win32con.BS_DEFPUSHBUTTON]
-    )
-    s = win32con.BS_PUSHBUTTON | s
-    dlg.append([128, "Cancel", win32con.IDCANCEL, (124, 20, 50, 14), s])
-    return dlg
-
-
-def MakePasswordDlgTemplate(title):
-    style = (
-        win32con.DS_MODALFRAME
-        | win32con.WS_POPUP
-        | win32con.WS_VISIBLE
-        | win32con.WS_CAPTION
-        | win32con.WS_SYSMENU
-        | win32con.DS_SETFONT
-    )
-    cs = win32con.WS_CHILD | win32con.WS_VISIBLE
-    # Window frame and title
-    dlg = [
-        [title, (0, 0, 177, 45), style, None, (8, "MS Sans Serif")],
-    ]
-
-    # Password label and text box
-    dlg.append([130, "Password:", -1, (7, 7, 69, 9), cs | win32con.SS_LEFT])
-    s = cs | win32con.WS_TABSTOP | win32con.WS_BORDER
-    dlg.append(
-        ["EDIT", None, win32ui.IDC_EDIT1, (50, 7, 60, 12), s | win32con.ES_PASSWORD]
-    )
-
-    # OK/Cancel Buttons
-    s = cs | win32con.WS_TABSTOP | win32con.BS_PUSHBUTTON
-    dlg.append(
-        [128, "OK", win32con.IDOK, (124, 5, 50, 14), s | win32con.BS_DEFPUSHBUTTON]
-    )
-    dlg.append([128, "Cancel", win32con.IDCANCEL, (124, 22, 50, 14), s])
-    return dlg
-
-
-class LoginDlg(dialog.Dialog):
-    Cancel = 0
-
-    def __init__(self, title):
-        dialog.Dialog.__init__(self, MakeLoginDlgTemplate(title))
-        self.AddDDX(win32ui.IDC_EDIT1, "userid")
-        self.AddDDX(win32ui.IDC_EDIT2, "password")
-
-
-def GetLogin(title="Login", userid="", password=""):
-    d = LoginDlg(title)
-    d["userid"] = userid
-    d["password"] = password
-    if d.DoModal() != win32con.IDOK:
-        return (None, None)
-    else:
-        return (d["userid"], d["password"])
-
-
-class PasswordDlg(dialog.Dialog):
-    def __init__(self, title):
-        dialog.Dialog.__init__(self, MakePasswordDlgTemplate(title))
-        self.AddDDX(win32ui.IDC_EDIT1, "password")
-
-
-def GetPassword(title="Password", password=""):
-    d = PasswordDlg(title)
-    d["password"] = password
-    if d.DoModal() != win32con.IDOK:
-        return None
-    return d["password"]
-
-
-if __name__ == "__main__":
-    import sys
-
-    title = "Login"
-    def_user = ""
-    if len(sys.argv) > 1:
-        title = sys.argv[1]
-    if len(sys.argv) > 2:
-        def_userid = sys.argv[2]
-    userid, password = GetLogin(title, def_user)
-    if userid == password == None:
-        print("User pressed Cancel")
-    else:
-        print("User ID: ", userid)
-        print("Password:", password)
-        newpassword = GetPassword("Reenter just for fun", password)
-        if newpassword is None:
-            print("User cancelled")
-        else:
-            what = ""
-            if newpassword != password:
-                what = "not "
-            print("The passwords did %smatch" % (what))
diff --git a/lib/pythonwin/pywin/dialogs/status.py b/lib/pythonwin/pywin/dialogs/status.py
deleted file mode 100644
index aef33914..00000000
--- a/lib/pythonwin/pywin/dialogs/status.py
+++ /dev/null
@@ -1,242 +0,0 @@
-# No cancel button.
-
-import threading
-import time
-
-import win32api
-import win32con
-import win32ui
-from pywin.mfc import dialog
-from pywin.mfc.thread import WinThread
-
-
-def MakeProgressDlgTemplate(caption, staticText=""):
-    style = (
-        win32con.DS_MODALFRAME
-        | win32con.WS_POPUP
-        | win32con.WS_VISIBLE
-        | win32con.WS_CAPTION
-        | win32con.WS_SYSMENU
-        | win32con.DS_SETFONT
-    )
-    cs = win32con.WS_CHILD | win32con.WS_VISIBLE
-
-    w = 215
-    h = 36  # With button
-    h = 40
-
-    dlg = [
-        [caption, (0, 0, w, h), style, None, (8, "MS Sans Serif")],
-    ]
-
-    s = win32con.WS_TABSTOP | cs
-
-    dlg.append([130, staticText, 1000, (7, 7, w - 7, h - 32), cs | win32con.SS_LEFT])
-
-    #    dlg.append([128,
-    # 		"Cancel",
-    # 		win32con.IDCANCEL,
-    # 		(w - 60, h - 18, 50, 14), s | win32con.BS_PUSHBUTTON])
-
-    return dlg
-
-
-class CStatusProgressDialog(dialog.Dialog):
-    def __init__(self, title, msg="", maxticks=100, tickincr=1):
-        self.initMsg = msg
-        templ = MakeProgressDlgTemplate(title, msg)
-        dialog.Dialog.__init__(self, templ)
-        self.maxticks = maxticks
-        self.tickincr = tickincr
-        self.pbar = None
-
-    def OnInitDialog(self):
-        rc = dialog.Dialog.OnInitDialog(self)
-        self.static = self.GetDlgItem(1000)
-        self.pbar = win32ui.CreateProgressCtrl()
-        self.pbar.CreateWindow(
-            win32con.WS_CHILD | win32con.WS_VISIBLE, (10, 30, 310, 44), self, 1001
-        )
-        self.pbar.SetRange(0, self.maxticks)
-        self.pbar.SetStep(self.tickincr)
-        self.progress = 0
-        self.pincr = 5
-        return rc
-
-    def Close(self):
-        self.EndDialog(0)
-
-    def SetMaxTicks(self, maxticks):
-        if self.pbar is not None:
-            self.pbar.SetRange(0, maxticks)
-
-    def Tick(self):
-        if self.pbar is not None:
-            self.pbar.StepIt()
-
-    def SetTitle(self, text):
-        self.SetWindowText(text)
-
-    def SetText(self, text):
-        self.SetDlgItemText(1000, text)
-
-    def Set(self, pos, max=None):
-        if self.pbar is not None:
-            self.pbar.SetPos(pos)
-            if max is not None:
-                self.pbar.SetRange(0, max)
-
-
-# a progress dialog created in a new thread - especially suitable for
-# console apps with no message loop.
-MYWM_SETTITLE = win32con.WM_USER + 10
-MYWM_SETMSG = win32con.WM_USER + 11
-MYWM_TICK = win32con.WM_USER + 12
-MYWM_SETMAXTICKS = win32con.WM_USER + 13
-MYWM_SET = win32con.WM_USER + 14
-
-
-class CThreadedStatusProcessDialog(CStatusProgressDialog):
-    def __init__(self, title, msg="", maxticks=100, tickincr=1):
-        self.title = title
-        self.msg = msg
-        self.threadid = win32api.GetCurrentThreadId()
-        CStatusProgressDialog.__init__(self, title, msg, maxticks, tickincr)
-
-    def OnInitDialog(self):
-        rc = CStatusProgressDialog.OnInitDialog(self)
-        self.HookMessage(self.OnTitle, MYWM_SETTITLE)
-        self.HookMessage(self.OnMsg, MYWM_SETMSG)
-        self.HookMessage(self.OnTick, MYWM_TICK)
-        self.HookMessage(self.OnMaxTicks, MYWM_SETMAXTICKS)
-        self.HookMessage(self.OnSet, MYWM_SET)
-        return rc
-
-    def _Send(self, msg):
-        try:
-            self.PostMessage(msg)
-        except win32ui.error:
-            # the user closed the window - but this does not cancel the
-            # process - so just ignore it.
-            pass
-
-    def OnTitle(self, msg):
-        CStatusProgressDialog.SetTitle(self, self.title)
-
-    def OnMsg(self, msg):
-        CStatusProgressDialog.SetText(self, self.msg)
-
-    def OnTick(self, msg):
-        CStatusProgressDialog.Tick(self)
-
-    def OnMaxTicks(self, msg):
-        CStatusProgressDialog.SetMaxTicks(self, self.maxticks)
-
-    def OnSet(self, msg):
-        CStatusProgressDialog.Set(self, self.pos, self.max)
-
-    def Close(self):
-        assert self.threadid, "No thread!"
-        win32api.PostThreadMessage(self.threadid, win32con.WM_QUIT, 0, 0)
-
-    def SetMaxTicks(self, maxticks):
-        self.maxticks = maxticks
-        self._Send(MYWM_SETMAXTICKS)
-
-    def SetTitle(self, title):
-        self.title = title
-        self._Send(MYWM_SETTITLE)
-
-    def SetText(self, text):
-        self.msg = text
-        self._Send(MYWM_SETMSG)
-
-    def Tick(self):
-        self._Send(MYWM_TICK)
-
-    def Set(self, pos, max=None):
-        self.pos = pos
-        self.max = max
-        self._Send(MYWM_SET)
-
-
-class ProgressThread(WinThread):
-    def __init__(self, title, msg="", maxticks=100, tickincr=1):
-        self.title = title
-        self.msg = msg
-        self.maxticks = maxticks
-        self.tickincr = tickincr
-        self.dialog = None
-        WinThread.__init__(self)
-        self.createdEvent = threading.Event()
-
-    def InitInstance(self):
-        self.dialog = CThreadedStatusProcessDialog(
-            self.title, self.msg, self.maxticks, self.tickincr
-        )
-        self.dialog.CreateWindow()
-        try:
-            self.dialog.SetForegroundWindow()
-        except win32ui.error:
-            pass
-        self.createdEvent.set()
-        return WinThread.InitInstance(self)
-
-    def ExitInstance(self):
-        return 0
-
-
-def StatusProgressDialog(title, msg="", maxticks=100, parent=None):
-    d = CStatusProgressDialog(title, msg, maxticks)
-    d.CreateWindow(parent)
-    return d
-
-
-def ThreadedStatusProgressDialog(title, msg="", maxticks=100):
-    t = ProgressThread(title, msg, maxticks)
-    t.CreateThread()
-    # Need to run a basic "PumpWaitingMessages" loop just incase we are
-    # running inside Pythonwin.
-    # Basic timeout incase things go terribly wrong.  Ideally we should use
-    # win32event.MsgWaitForMultipleObjects(), but we use a threading module
-    # event - so use a dumb strategy
-    end_time = time.time() + 10
-    while time.time() < end_time:
-        if t.createdEvent.isSet():
-            break
-        win32ui.PumpWaitingMessages()
-        time.sleep(0.1)
-    return t.dialog
-
-
-def demo():
-    d = StatusProgressDialog("A Demo", "Doing something...")
-    import win32api
-
-    for i in range(100):
-        if i == 50:
-            d.SetText("Getting there...")
-        if i == 90:
-            d.SetText("Nearly done...")
-        win32api.Sleep(20)
-        d.Tick()
-    d.Close()
-
-
-def thread_demo():
-    d = ThreadedStatusProgressDialog("A threaded demo", "Doing something")
-    import win32api
-
-    for i in range(100):
-        if i == 50:
-            d.SetText("Getting there...")
-        if i == 90:
-            d.SetText("Nearly done...")
-        win32api.Sleep(20)
-        d.Tick()
-    d.Close()
-
-
-if __name__ == "__main__":
-    thread_demo()
-    # demo()
diff --git a/lib/pythonwin/pywin/docking/DockingBar.py b/lib/pythonwin/pywin/docking/DockingBar.py
deleted file mode 100644
index 3e51eb70..00000000
--- a/lib/pythonwin/pywin/docking/DockingBar.py
+++ /dev/null
@@ -1,679 +0,0 @@
-# DockingBar.py
-
-# Ported directly (comments and all) from the samples at www.codeguru.com
-
-# WARNING: Use at your own risk, as this interface is highly likely to change.
-# Currently we support only one child per DockingBar.  Later we need to add
-# support for multiple children.
-
-import struct
-
-import win32api
-import win32con
-import win32ui
-from pywin.mfc import afxres, window
-
-clrBtnHilight = win32api.GetSysColor(win32con.COLOR_BTNHILIGHT)
-clrBtnShadow = win32api.GetSysColor(win32con.COLOR_BTNSHADOW)
-
-
-def CenterPoint(rect):
-    width = rect[2] - rect[0]
-    height = rect[3] - rect[1]
-    return rect[0] + width // 2, rect[1] + height // 2
-
-
-def OffsetRect(rect, point):
-    (x, y) = point
-    return rect[0] + x, rect[1] + y, rect[2] + x, rect[3] + y
-
-
-def DeflateRect(rect, point):
-    (x, y) = point
-    return rect[0] + x, rect[1] + y, rect[2] - x, rect[3] - y
-
-
-def PtInRect(rect, pt):
-    return rect[0] <= pt[0] < rect[2] and rect[1] <= pt[1] < rect[3]
-
-
-class DockingBar(window.Wnd):
-    def __init__(self, obj=None):
-        if obj is None:
-            obj = win32ui.CreateControlBar()
-        window.Wnd.__init__(self, obj)
-        self.dialog = None
-        self.nDockBarID = 0
-        self.sizeMin = 32, 32
-        self.sizeHorz = 200, 200
-        self.sizeVert = 200, 200
-        self.sizeFloat = 200, 200
-        self.bTracking = 0
-        self.bInRecalcNC = 0
-        self.cxEdge = 6
-        self.cxBorder = 3
-        self.cxGripper = 20
-        self.brushBkgd = win32ui.CreateBrush()
-        self.brushBkgd.CreateSolidBrush(win32api.GetSysColor(win32con.COLOR_BTNFACE))
-
-        # Support for diagonal resizing
-        self.cyBorder = 3
-        self.cCaptionSize = win32api.GetSystemMetrics(win32con.SM_CYSMCAPTION)
-        self.cMinWidth = win32api.GetSystemMetrics(win32con.SM_CXMIN)
-        self.cMinHeight = win32api.GetSystemMetrics(win32con.SM_CYMIN)
-        self.rectUndock = (0, 0, 0, 0)
-
-    def OnUpdateCmdUI(self, target, bDisableIfNoHndler):
-        return self.UpdateDialogControls(target, bDisableIfNoHndler)
-
-    def CreateWindow(
-        self,
-        parent,
-        childCreator,
-        title,
-        id,
-        style=win32con.WS_CHILD | win32con.WS_VISIBLE | afxres.CBRS_LEFT,
-        childCreatorArgs=(),
-    ):
-        assert not (
-            (style & afxres.CBRS_SIZE_FIXED) and (style & afxres.CBRS_SIZE_DYNAMIC)
-        ), "Invalid style"
-        self.rectClose = self.rectBorder = self.rectGripper = self.rectTracker = (
-            0,
-            0,
-            0,
-            0,
-        )
-
-        # save the style
-        self._obj_.dwStyle = style & afxres.CBRS_ALL
-
-        cursor = win32api.LoadCursor(0, win32con.IDC_ARROW)
-        wndClass = win32ui.RegisterWndClass(
-            win32con.CS_DBLCLKS, cursor, self.brushBkgd.GetSafeHandle(), 0
-        )
-
-        self._obj_.CreateWindow(wndClass, title, style, (0, 0, 0, 0), parent, id)
-
-        # Create the child dialog
-        self.dialog = childCreator(*(self,) + childCreatorArgs)
-
-        # use the dialog dimensions as default base dimensions
-        assert self.dialog.IsWindow(), (
-            "The childCreator function %s did not create a window!" % childCreator
-        )
-        rect = self.dialog.GetWindowRect()
-        self.sizeHorz = self.sizeVert = self.sizeFloat = (
-            rect[2] - rect[0],
-            rect[3] - rect[1],
-        )
-
-        self.sizeHorz = self.sizeHorz[0], self.sizeHorz[1] + self.cxEdge + self.cxBorder
-        self.sizeVert = self.sizeVert[0] + self.cxEdge + self.cxBorder, self.sizeVert[1]
-        self.HookMessages()
-
-    def CalcFixedLayout(self, bStretch, bHorz):
-        rectTop = self.dockSite.GetControlBar(
-            afxres.AFX_IDW_DOCKBAR_TOP
-        ).GetWindowRect()
-        rectLeft = self.dockSite.GetControlBar(
-            afxres.AFX_IDW_DOCKBAR_LEFT
-        ).GetWindowRect()
-        if bStretch:
-            nHorzDockBarWidth = 32767
-            nVertDockBarHeight = 32767
-        else:
-            nHorzDockBarWidth = rectTop[2] - rectTop[0] + 4
-            nVertDockBarHeight = rectLeft[3] - rectLeft[1] + 4
-
-        if self.IsFloating():
-            return self.sizeFloat
-        if bHorz:
-            return nHorzDockBarWidth, self.sizeHorz[1]
-        return self.sizeVert[0], nVertDockBarHeight
-
-    def CalcDynamicLayout(self, length, mode):
-        # Support for diagonal sizing.
-        if self.IsFloating():
-            self.GetParent().GetParent().ModifyStyle(win32ui.MFS_4THICKFRAME, 0)
-        if mode & (win32ui.LM_HORZDOCK | win32ui.LM_VERTDOCK):
-            flags = (
-                win32con.SWP_NOSIZE
-                | win32con.SWP_NOMOVE
-                | win32con.SWP_NOZORDER
-                | win32con.SWP_NOACTIVATE
-                | win32con.SWP_FRAMECHANGED
-            )
-            self.SetWindowPos(
-                0,
-                (
-                    0,
-                    0,
-                    0,
-                    0,
-                ),
-                flags,
-            )
-            self.dockSite.RecalcLayout()
-            return self._obj_.CalcDynamicLayout(length, mode)
-
-        if mode & win32ui.LM_MRUWIDTH:
-            return self.sizeFloat
-        if mode & win32ui.LM_COMMIT:
-            self.sizeFloat = length, self.sizeFloat[1]
-            return self.sizeFloat
-        # More diagonal sizing.
-        if self.IsFloating():
-            dc = self.dockContext
-            pt = win32api.GetCursorPos()
-            windowRect = self.GetParent().GetParent().GetWindowRect()
-
-            hittest = dc.nHitTest
-            if hittest == win32con.HTTOPLEFT:
-                cx = max(windowRect[2] - pt[0], self.cMinWidth) - self.cxBorder
-                cy = max(windowRect[3] - self.cCaptionSize - pt[1], self.cMinHeight) - 1
-                self.sizeFloat = cx, cy
-
-                top = (
-                    min(pt[1], windowRect[3] - self.cCaptionSize - self.cMinHeight)
-                    - self.cyBorder
-                )
-                left = min(pt[0], windowRect[2] - self.cMinWidth) - 1
-                dc.rectFrameDragHorz = (
-                    left,
-                    top,
-                    dc.rectFrameDragHorz[2],
-                    dc.rectFrameDragHorz[3],
-                )
-                return self.sizeFloat
-            if hittest == win32con.HTTOPRIGHT:
-                cx = max(pt[0] - windowRect[0], self.cMinWidth)
-                cy = max(windowRect[3] - self.cCaptionSize - pt[1], self.cMinHeight) - 1
-                self.sizeFloat = cx, cy
-
-                top = (
-                    min(pt[1], windowRect[3] - self.cCaptionSize - self.cMinHeight)
-                    - self.cyBorder
-                )
-                dc.rectFrameDragHorz = (
-                    dc.rectFrameDragHorz[0],
-                    top,
-                    dc.rectFrameDragHorz[2],
-                    dc.rectFrameDragHorz[3],
-                )
-                return self.sizeFloat
-
-            if hittest == win32con.HTBOTTOMLEFT:
-                cx = max(windowRect[2] - pt[0], self.cMinWidth) - self.cxBorder
-                cy = max(pt[1] - windowRect[1] - self.cCaptionSize, self.cMinHeight)
-                self.sizeFloat = cx, cy
-
-                left = min(pt[0], windowRect[2] - self.cMinWidth) - 1
-                dc.rectFrameDragHorz = (
-                    left,
-                    dc.rectFrameDragHorz[1],
-                    dc.rectFrameDragHorz[2],
-                    dc.rectFrameDragHorz[3],
-                )
-                return self.sizeFloat
-
-            if hittest == win32con.HTBOTTOMRIGHT:
-                cx = max(pt[0] - windowRect[0], self.cMinWidth)
-                cy = max(pt[1] - windowRect[1] - self.cCaptionSize, self.cMinHeight)
-                self.sizeFloat = cx, cy
-                return self.sizeFloat
-
-        if mode & win32ui.LM_LENGTHY:
-            self.sizeFloat = self.sizeFloat[0], max(self.sizeMin[1], length)
-            return self.sizeFloat
-        else:
-            return max(self.sizeMin[0], length), self.sizeFloat[1]
-
-    def OnWindowPosChanged(self, msg):
-        if self.GetSafeHwnd() == 0 or self.dialog is None:
-            return 0
-        lparam = msg[3]
-        """ LPARAM used with WM_WINDOWPOSCHANGED:
-			typedef struct {
-				HWND hwnd;
-				HWND hwndInsertAfter;
-				int x;
-				int y;
-				int cx;
-				int cy;
-				UINT flags;} WINDOWPOS;
-		"""
-        format = "PPiiiii"
-        bytes = win32ui.GetBytes(lparam, struct.calcsize(format))
-        hwnd, hwndAfter, x, y, cx, cy, flags = struct.unpack(format, bytes)
-
-        if self.bInRecalcNC:
-            rc = self.GetClientRect()
-            self.dialog.MoveWindow(rc)
-            return 0
-        # Find on which side are we docked
-        nDockBarID = self.GetParent().GetDlgCtrlID()
-        # Return if dropped at same location
-        # no docking side change and no size change
-        if (
-            (nDockBarID == self.nDockBarID)
-            and (flags & win32con.SWP_NOSIZE)
-            and (
-                (self._obj_.dwStyle & afxres.CBRS_BORDER_ANY) != afxres.CBRS_BORDER_ANY
-            )
-        ):
-            return
-        self.nDockBarID = nDockBarID
-
-        # Force recalc the non-client area
-        self.bInRecalcNC = 1
-        try:
-            swpflags = (
-                win32con.SWP_NOSIZE
-                | win32con.SWP_NOMOVE
-                | win32con.SWP_NOZORDER
-                | win32con.SWP_FRAMECHANGED
-            )
-            self.SetWindowPos(0, (0, 0, 0, 0), swpflags)
-        finally:
-            self.bInRecalcNC = 0
-        return 0
-
-    # This is a virtual and not a message hook.
-    def OnSetCursor(self, window, nHitTest, wMouseMsg):
-        if nHitTest != win32con.HTSIZE or self.bTracking:
-            return self._obj_.OnSetCursor(window, nHitTest, wMouseMsg)
-
-        if self.IsHorz():
-            win32api.SetCursor(win32api.LoadCursor(0, win32con.IDC_SIZENS))
-        else:
-            win32api.SetCursor(win32api.LoadCursor(0, win32con.IDC_SIZEWE))
-        return 1
-
-    # Mouse Handling
-    def OnLButtonUp(self, msg):
-        if not self.bTracking:
-            return 1  # pass it on.
-        self.StopTracking(1)
-        return 0  # Dont pass on
-
-    def OnLButtonDown(self, msg):
-        # UINT nFlags, CPoint point)
-        # only start dragging if clicked in "void" space
-        if self.dockBar is not None:
-            # start the drag
-            pt = msg[5]
-            pt = self.ClientToScreen(pt)
-            self.dockContext.StartDrag(pt)
-            return 0
-        return 1
-
-    def OnNcLButtonDown(self, msg):
-        if self.bTracking:
-            return 0
-        nHitTest = wparam = msg[2]
-        pt = msg[5]
-
-        if nHitTest == win32con.HTSYSMENU and not self.IsFloating():
-            self.GetDockingFrame().ShowControlBar(self, 0, 0)
-        elif nHitTest == win32con.HTMINBUTTON and not self.IsFloating():
-            self.dockContext.ToggleDocking()
-        elif (
-            nHitTest == win32con.HTCAPTION
-            and not self.IsFloating()
-            and self.dockBar is not None
-        ):
-            self.dockContext.StartDrag(pt)
-        elif nHitTest == win32con.HTSIZE and not self.IsFloating():
-            self.StartTracking()
-        else:
-            return 1
-        return 0
-
-    def OnLButtonDblClk(self, msg):
-        # only toggle docking if clicked in "void" space
-        if self.dockBar is not None:
-            # toggle docking
-            self.dockContext.ToggleDocking()
-            return 0
-        return 1
-
-    def OnNcLButtonDblClk(self, msg):
-        nHitTest = wparam = msg[2]
-        # UINT nHitTest, CPoint point)
-        if self.dockBar is not None and nHitTest == win32con.HTCAPTION:
-            # toggle docking
-            self.dockContext.ToggleDocking()
-            return 0
-        return 1
-
-    def OnMouseMove(self, msg):
-        flags = wparam = msg[2]
-        lparam = msg[3]
-        if self.IsFloating() or not self.bTracking:
-            return 1
-
-        # Convert unsigned 16 bit to signed 32 bit.
-        x = win32api.LOWORD(lparam)
-        if x & 32768:
-            x = x | -65536
-        y = win32api.HIWORD(lparam)
-        if y & 32768:
-            y = y | -65536
-        pt = x, y
-        cpt = CenterPoint(self.rectTracker)
-        pt = self.ClientToWnd(pt)
-        if self.IsHorz():
-            if cpt[1] != pt[1]:
-                self.OnInvertTracker(self.rectTracker)
-                self.rectTracker = OffsetRect(self.rectTracker, (0, pt[1] - cpt[1]))
-                self.OnInvertTracker(self.rectTracker)
-        else:
-            if cpt[0] != pt[0]:
-                self.OnInvertTracker(self.rectTracker)
-                self.rectTracker = OffsetRect(self.rectTracker, (pt[0] - cpt[0], 0))
-                self.OnInvertTracker(self.rectTracker)
-
-        return 0  # Dont pass it on.
-
-    # 	def OnBarStyleChange(self, old, new):
-
-    def OnNcCalcSize(self, bCalcValid, size_info):
-        (rc0, rc1, rc2, pos) = size_info
-        self.rectBorder = self.GetWindowRect()
-        self.rectBorder = OffsetRect(
-            self.rectBorder, (-self.rectBorder[0], -self.rectBorder[1])
-        )
-
-        dwBorderStyle = self._obj_.dwStyle | afxres.CBRS_BORDER_ANY
-
-        if self.nDockBarID == afxres.AFX_IDW_DOCKBAR_TOP:
-            dwBorderStyle = dwBorderStyle & ~afxres.CBRS_BORDER_BOTTOM
-            rc0.left = rc0.left + self.cxGripper
-            rc0.bottom = rc0.bottom - self.cxEdge
-            rc0.top = rc0.top + self.cxBorder
-            rc0.right = rc0.right - self.cxBorder
-            self.rectBorder = (
-                self.rectBorder[0],
-                self.rectBorder[3] - self.cxEdge,
-                self.rectBorder[2],
-                self.rectBorder[3],
-            )
-        elif self.nDockBarID == afxres.AFX_IDW_DOCKBAR_BOTTOM:
-            dwBorderStyle = dwBorderStyle & ~afxres.CBRS_BORDER_TOP
-            rc0.left = rc0.left + self.cxGripper
-            rc0.top = rc0.top + self.cxEdge
-            rc0.bottom = rc0.bottom - self.cxBorder
-            rc0.right = rc0.right - self.cxBorder
-            self.rectBorder = (
-                self.rectBorder[0],
-                self.rectBorder[1],
-                self.rectBorder[2],
-                self.rectBorder[1] + self.cxEdge,
-            )
-        elif self.nDockBarID == afxres.AFX_IDW_DOCKBAR_LEFT:
-            dwBorderStyle = dwBorderStyle & ~afxres.CBRS_BORDER_RIGHT
-            rc0.right = rc0.right - self.cxEdge
-            rc0.left = rc0.left + self.cxBorder
-            rc0.bottom = rc0.bottom - self.cxBorder
-            rc0.top = rc0.top + self.cxGripper
-            self.rectBorder = (
-                self.rectBorder[2] - self.cxEdge,
-                self.rectBorder[1],
-                self.rectBorder[2],
-                self.rectBorder[3],
-            )
-        elif self.nDockBarID == afxres.AFX_IDW_DOCKBAR_RIGHT:
-            dwBorderStyle = dwBorderStyle & ~afxres.CBRS_BORDER_LEFT
-            rc0.left = rc0.left + self.cxEdge
-            rc0.right = rc0.right - self.cxBorder
-            rc0.bottom = rc0.bottom - self.cxBorder
-            rc0.top = rc0.top + self.cxGripper
-            self.rectBorder = (
-                self.rectBorder[0],
-                self.rectBorder[1],
-                self.rectBorder[0] + self.cxEdge,
-                self.rectBorder[3],
-            )
-        else:
-            self.rectBorder = 0, 0, 0, 0
-
-        self.SetBarStyle(dwBorderStyle)
-        return 0
-
-    def OnNcPaint(self, msg):
-        self.EraseNonClient()
-        dc = self.GetWindowDC()
-        ctl = win32api.GetSysColor(win32con.COLOR_BTNHIGHLIGHT)
-        cbr = win32api.GetSysColor(win32con.COLOR_BTNSHADOW)
-        dc.Draw3dRect(self.rectBorder, ctl, cbr)
-
-        self.DrawGripper(dc)
-
-        rect = self.GetClientRect()
-        self.InvalidateRect(rect, 1)
-        return 0
-
-    def OnNcHitTest(self, pt):  # A virtual, not a hooked message.
-        if self.IsFloating():
-            return 1
-
-        ptOrig = pt
-        rect = self.GetWindowRect()
-        pt = pt[0] - rect[0], pt[1] - rect[1]
-
-        if PtInRect(self.rectClose, pt):
-            return win32con.HTSYSMENU
-        elif PtInRect(self.rectUndock, pt):
-            return win32con.HTMINBUTTON
-        elif PtInRect(self.rectGripper, pt):
-            return win32con.HTCAPTION
-        elif PtInRect(self.rectBorder, pt):
-            return win32con.HTSIZE
-        else:
-            return self._obj_.OnNcHitTest(ptOrig)
-
-    def StartTracking(self):
-        self.SetCapture()
-
-        # make sure no updates are pending
-        self.RedrawWindow(None, None, win32con.RDW_ALLCHILDREN | win32con.RDW_UPDATENOW)
-        self.dockSite.LockWindowUpdate()
-
-        self.ptOld = CenterPoint(self.rectBorder)
-        self.bTracking = 1
-
-        self.rectTracker = self.rectBorder
-        if not self.IsHorz():
-            l, t, r, b = self.rectTracker
-            b = b - 4
-            self.rectTracker = l, t, r, b
-
-        self.OnInvertTracker(self.rectTracker)
-
-    def OnCaptureChanged(self, msg):
-        hwnd = lparam = msg[3]
-        if self.bTracking and hwnd != self.GetSafeHwnd():
-            self.StopTracking(0)  # cancel tracking
-        return 1
-
-    def StopTracking(self, bAccept):
-        self.OnInvertTracker(self.rectTracker)
-        self.dockSite.UnlockWindowUpdate()
-        self.bTracking = 0
-        self.ReleaseCapture()
-        if not bAccept:
-            return
-
-        rcc = self.dockSite.GetWindowRect()
-        if self.IsHorz():
-            newsize = self.sizeHorz[1]
-            maxsize = newsize + (rcc[3] - rcc[1])
-            minsize = self.sizeMin[1]
-        else:
-            newsize = self.sizeVert[0]
-            maxsize = newsize + (rcc[2] - rcc[0])
-            minsize = self.sizeMin[0]
-
-        pt = CenterPoint(self.rectTracker)
-        if self.nDockBarID == afxres.AFX_IDW_DOCKBAR_TOP:
-            newsize = newsize + (pt[1] - self.ptOld[1])
-        elif self.nDockBarID == afxres.AFX_IDW_DOCKBAR_BOTTOM:
-            newsize = newsize + (-pt[1] + self.ptOld[1])
-        elif self.nDockBarID == afxres.AFX_IDW_DOCKBAR_LEFT:
-            newsize = newsize + (pt[0] - self.ptOld[0])
-        elif self.nDockBarID == afxres.AFX_IDW_DOCKBAR_RIGHT:
-            newsize = newsize + (-pt[0] + self.ptOld[0])
-        newsize = max(minsize, min(maxsize, newsize))
-        if self.IsHorz():
-            self.sizeHorz = self.sizeHorz[0], newsize
-        else:
-            self.sizeVert = newsize, self.sizeVert[1]
-        self.dockSite.RecalcLayout()
-        return 0
-
-    def OnInvertTracker(self, rect):
-        assert rect[2] - rect[0] > 0 and rect[3] - rect[1] > 0, "rect is empty"
-        assert self.bTracking
-        rcc = self.GetWindowRect()
-        rcf = self.dockSite.GetWindowRect()
-
-        rect = OffsetRect(rect, (rcc[0] - rcf[0], rcc[1] - rcf[1]))
-        rect = DeflateRect(rect, (1, 1))
-
-        flags = win32con.DCX_WINDOW | win32con.DCX_CACHE | win32con.DCX_LOCKWINDOWUPDATE
-        dc = self.dockSite.GetDCEx(None, flags)
-        try:
-            brush = win32ui.GetHalftoneBrush()
-            oldBrush = dc.SelectObject(brush)
-
-            dc.PatBlt(
-                (rect[0], rect[1]),
-                (rect[2] - rect[0], rect[3] - rect[1]),
-                win32con.PATINVERT,
-            )
-            dc.SelectObject(oldBrush)
-        finally:
-            self.dockSite.ReleaseDC(dc)
-
-    def IsHorz(self):
-        return (
-            self.nDockBarID == afxres.AFX_IDW_DOCKBAR_TOP
-            or self.nDockBarID == afxres.AFX_IDW_DOCKBAR_BOTTOM
-        )
-
-    def ClientToWnd(self, pt):
-        x, y = pt
-        if self.nDockBarID == afxres.AFX_IDW_DOCKBAR_BOTTOM:
-            y = y + self.cxEdge
-        elif self.nDockBarID == afxres.AFX_IDW_DOCKBAR_RIGHT:
-            x = x + self.cxEdge
-        return x, y
-
-    def DrawGripper(self, dc):
-        # no gripper if floating
-        if self._obj_.dwStyle & afxres.CBRS_FLOATING:
-            return
-
-        # -==HACK==-
-        # in order to calculate the client area properly after docking,
-        # the client area must be recalculated twice (I have no idea why)
-        self.dockSite.RecalcLayout()
-        # -==END HACK==-
-
-        gripper = self.GetWindowRect()
-        gripper = self.ScreenToClient(gripper)
-        gripper = OffsetRect(gripper, (-gripper[0], -gripper[1]))
-        gl, gt, gr, gb = gripper
-
-        if self._obj_.dwStyle & afxres.CBRS_ORIENT_HORZ:
-            # gripper at left
-            self.rectGripper = gl, gt + 40, gl + 20, gb
-            # draw close box
-            self.rectClose = gl + 7, gt + 10, gl + 19, gt + 22
-            dc.DrawFrameControl(
-                self.rectClose, win32con.DFC_CAPTION, win32con.DFCS_CAPTIONCLOSE
-            )
-            # draw docking toggle box
-            self.rectUndock = OffsetRect(self.rectClose, (0, 13))
-            dc.DrawFrameControl(
-                self.rectUndock, win32con.DFC_CAPTION, win32con.DFCS_CAPTIONMAX
-            )
-
-            gt = gt + 38
-            gb = gb - 10
-            gl = gl + 10
-            gr = gl + 3
-            gripper = gl, gt, gr, gb
-            dc.Draw3dRect(gripper, clrBtnHilight, clrBtnShadow)
-            dc.Draw3dRect(OffsetRect(gripper, (4, 0)), clrBtnHilight, clrBtnShadow)
-        else:
-            # gripper at top
-            self.rectGripper = gl, gt, gr - 40, gt + 20
-            # draw close box
-            self.rectClose = gr - 21, gt + 7, gr - 10, gt + 18
-            dc.DrawFrameControl(
-                self.rectClose, win32con.DFC_CAPTION, win32con.DFCS_CAPTIONCLOSE
-            )
-            #  draw docking toggle box
-            self.rectUndock = OffsetRect(self.rectClose, (-13, 0))
-            dc.DrawFrameControl(
-                self.rectUndock, win32con.DFC_CAPTION, win32con.DFCS_CAPTIONMAX
-            )
-            gr = gr - 38
-            gl = gl + 10
-            gt = gt + 10
-            gb = gt + 3
-
-            gripper = gl, gt, gr, gb
-            dc.Draw3dRect(gripper, clrBtnHilight, clrBtnShadow)
-            dc.Draw3dRect(OffsetRect(gripper, (0, 4)), clrBtnHilight, clrBtnShadow)
-
-    def HookMessages(self):
-        self.HookMessage(self.OnLButtonUp, win32con.WM_LBUTTONUP)
-        self.HookMessage(self.OnLButtonDown, win32con.WM_LBUTTONDOWN)
-        self.HookMessage(self.OnLButtonDblClk, win32con.WM_LBUTTONDBLCLK)
-        self.HookMessage(self.OnNcLButtonDown, win32con.WM_NCLBUTTONDOWN)
-        self.HookMessage(self.OnNcLButtonDblClk, win32con.WM_NCLBUTTONDBLCLK)
-        self.HookMessage(self.OnMouseMove, win32con.WM_MOUSEMOVE)
-        self.HookMessage(self.OnNcPaint, win32con.WM_NCPAINT)
-        self.HookMessage(self.OnCaptureChanged, win32con.WM_CAPTURECHANGED)
-        self.HookMessage(self.OnWindowPosChanged, win32con.WM_WINDOWPOSCHANGED)
-
-
-# 		self.HookMessage(self.OnSize, win32con.WM_SIZE)
-
-
-def EditCreator(parent):
-    d = win32ui.CreateEdit()
-    es = (
-        win32con.WS_CHILD
-        | win32con.WS_VISIBLE
-        | win32con.WS_BORDER
-        | win32con.ES_MULTILINE
-        | win32con.ES_WANTRETURN
-    )
-    d.CreateWindow(es, (0, 0, 150, 150), parent, 1000)
-    return d
-
-
-def test():
-    import pywin.mfc.dialog
-
-    global bar
-    bar = DockingBar()
-    creator = EditCreator
-    bar.CreateWindow(win32ui.GetMainFrame(), creator, "Coolbar Demo", 0xFFFFF)
-    # 	win32ui.GetMainFrame().ShowControlBar(bar, 1, 0)
-    bar.SetBarStyle(
-        bar.GetBarStyle()
-        | afxres.CBRS_TOOLTIPS
-        | afxres.CBRS_FLYBY
-        | afxres.CBRS_SIZE_DYNAMIC
-    )
-    bar.EnableDocking(afxres.CBRS_ALIGN_ANY)
-    win32ui.GetMainFrame().DockControlBar(bar, afxres.AFX_IDW_DOCKBAR_BOTTOM)
-
-
-if __name__ == "__main__":
-    test()
diff --git a/lib/pythonwin/pywin/docking/__init__.py b/lib/pythonwin/pywin/docking/__init__.py
deleted file mode 100644
index e69de29b..00000000
diff --git a/lib/pythonwin/pywin/framework/__init__.py b/lib/pythonwin/pywin/framework/__init__.py
deleted file mode 100644
index e69de29b..00000000
diff --git a/lib/pythonwin/pywin/framework/app.py b/lib/pythonwin/pywin/framework/app.py
deleted file mode 100644
index f994f99f..00000000
--- a/lib/pythonwin/pywin/framework/app.py
+++ /dev/null
@@ -1,457 +0,0 @@
-# App.py
-# Application stuff.
-# The application is responsible for managing the main frame window.
-#
-# We also grab the FileOpen command, to invoke our Python editor
-" The PythonWin application code. Manages most aspects of MDI, etc "
-import os
-import sys
-import traceback
-
-import regutil
-import win32api
-import win32con
-import win32ui
-from pywin.mfc import afxres, dialog, window
-from pywin.mfc.thread import WinApp
-
-from . import scriptutils
-
-## NOTE: App and AppBuild should NOT be used - instead, you should contruct your
-## APP class manually whenever you like (just ensure you leave these 2 params None!)
-## Whoever wants the generic "Application" should get it via win32iu.GetApp()
-
-# These are "legacy"
-AppBuilder = None
-App = None  # default - if used, must end up a CApp derived class.
-
-
-# Helpers that should one day be removed!
-def AddIdleHandler(handler):
-    print(
-        "app.AddIdleHandler is deprecated - please use win32ui.GetApp().AddIdleHandler() instead."
-    )
-    return win32ui.GetApp().AddIdleHandler(handler)
-
-
-def DeleteIdleHandler(handler):
-    print(
-        "app.DeleteIdleHandler is deprecated - please use win32ui.GetApp().DeleteIdleHandler() instead."
-    )
-    return win32ui.GetApp().DeleteIdleHandler(handler)
-
-
-# Helper for writing a Window position by name, and later loading it.
-def SaveWindowSize(section, rect, state=""):
-    """Writes a rectangle to an INI file
-    Args: section = section name in the applications INI file
-          rect = a rectangle in a (cy, cx, y, x) tuple
-                 (same format as CREATESTRUCT position tuples)."""
-    left, top, right, bottom = rect
-    if state:
-        state = state + " "
-    win32ui.WriteProfileVal(section, state + "left", left)
-    win32ui.WriteProfileVal(section, state + "top", top)
-    win32ui.WriteProfileVal(section, state + "right", right)
-    win32ui.WriteProfileVal(section, state + "bottom", bottom)
-
-
-def LoadWindowSize(section, state=""):
-    """Loads a section from an INI file, and returns a rect in a tuple (see SaveWindowSize)"""
-    if state:
-        state = state + " "
-    left = win32ui.GetProfileVal(section, state + "left", 0)
-    top = win32ui.GetProfileVal(section, state + "top", 0)
-    right = win32ui.GetProfileVal(section, state + "right", 0)
-    bottom = win32ui.GetProfileVal(section, state + "bottom", 0)
-    return (left, top, right, bottom)
-
-
-def RectToCreateStructRect(rect):
-    return (rect[3] - rect[1], rect[2] - rect[0], rect[1], rect[0])
-
-
-# Define FrameWindow and Application objects
-#
-# The Main Frame of the application.
-class MainFrame(window.MDIFrameWnd):
-    sectionPos = "Main Window"
-    statusBarIndicators = (
-        afxres.ID_SEPARATOR,  # // status line indicator
-        afxres.ID_INDICATOR_CAPS,
-        afxres.ID_INDICATOR_NUM,
-        afxres.ID_INDICATOR_SCRL,
-        win32ui.ID_INDICATOR_LINENUM,
-        win32ui.ID_INDICATOR_COLNUM,
-    )
-
-    def OnCreate(self, cs):
-        self._CreateStatusBar()
-        return 0
-
-    def _CreateStatusBar(self):
-        self.statusBar = win32ui.CreateStatusBar(self)
-        self.statusBar.SetIndicators(self.statusBarIndicators)
-        self.HookCommandUpdate(self.OnUpdatePosIndicator, win32ui.ID_INDICATOR_LINENUM)
-        self.HookCommandUpdate(self.OnUpdatePosIndicator, win32ui.ID_INDICATOR_COLNUM)
-
-    def OnUpdatePosIndicator(self, cmdui):
-        editControl = scriptutils.GetActiveEditControl()
-        value = " " * 5
-        if editControl is not None:
-            try:
-                startChar, endChar = editControl.GetSel()
-                lineNo = editControl.LineFromChar(startChar)
-                colNo = endChar - editControl.LineIndex(lineNo)
-
-                if cmdui.m_nID == win32ui.ID_INDICATOR_LINENUM:
-                    value = "%0*d" % (5, lineNo + 1)
-                else:
-                    value = "%0*d" % (3, colNo + 1)
-            except win32ui.error:
-                pass
-        cmdui.SetText(value)
-        cmdui.Enable()
-
-    def PreCreateWindow(self, cc):
-        cc = self._obj_.PreCreateWindow(cc)
-        pos = LoadWindowSize(self.sectionPos)
-        self.startRect = pos
-        if pos[2] - pos[0]:
-            rect = RectToCreateStructRect(pos)
-            cc = cc[0], cc[1], cc[2], cc[3], rect, cc[5], cc[6], cc[7], cc[8]
-        return cc
-
-    def OnDestroy(self, msg):
-        # use GetWindowPlacement(), as it works even when min'd or max'd
-        rectNow = self.GetWindowPlacement()[4]
-        if rectNow != self.startRect:
-            SaveWindowSize(self.sectionPos, rectNow)
-        return 0
-
-
-class CApp(WinApp):
-    "A class for the application"
-
-    def __init__(self):
-        self.oldCallbackCaller = None
-        WinApp.__init__(self, win32ui.GetApp())
-        self.idleHandlers = []
-
-    def InitInstance(self):
-        "Called to crank up the app"
-        HookInput()
-        numMRU = win32ui.GetProfileVal("Settings", "Recent File List Size", 10)
-        win32ui.LoadStdProfileSettings(numMRU)
-        # 		self._obj_.InitMDIInstance()
-        if win32api.GetVersionEx()[0] < 4:
-            win32ui.SetDialogBkColor()
-            win32ui.Enable3dControls()
-
-        # install a "callback caller" - a manager for the callbacks
-        # 		self.oldCallbackCaller = win32ui.InstallCallbackCaller(self.CallbackManager)
-        self.LoadMainFrame()
-        self.SetApplicationPaths()
-
-    def ExitInstance(self):
-        "Called as the app dies - too late to prevent it here!"
-        win32ui.OutputDebug("Application shutdown\n")
-        # Restore the callback manager, if any.
-        try:
-            win32ui.InstallCallbackCaller(self.oldCallbackCaller)
-        except AttributeError:
-            pass
-        if self.oldCallbackCaller:
-            del self.oldCallbackCaller
-        self.frame = None  # clean Python references to the now destroyed window object.
-        self.idleHandlers = []
-        # Attempt cleanup if not already done!
-        if self._obj_:
-            self._obj_.AttachObject(None)
-        self._obj_ = None
-        global App
-        global AppBuilder
-        App = None
-        AppBuilder = None
-        return 0
-
-    def HaveIdleHandler(self, handler):
-        return handler in self.idleHandlers
-
-    def AddIdleHandler(self, handler):
-        self.idleHandlers.append(handler)
-
-    def DeleteIdleHandler(self, handler):
-        self.idleHandlers.remove(handler)
-
-    def OnIdle(self, count):
-        try:
-            ret = 0
-            handlers = self.idleHandlers[:]  # copy list, as may be modified during loop
-            for handler in handlers:
-                try:
-                    thisRet = handler(handler, count)
-                except:
-                    print("Idle handler %s failed" % (repr(handler)))
-                    traceback.print_exc()
-                    print("Idle handler removed from list")
-                    try:
-                        self.DeleteIdleHandler(handler)
-                    except ValueError:  # Item not in list.
-                        pass
-                    thisRet = 0
-                ret = ret or thisRet
-            return ret
-        except KeyboardInterrupt:
-            pass
-
-    def CreateMainFrame(self):
-        return MainFrame()
-
-    def LoadMainFrame(self):
-        "Create the main applications frame"
-        self.frame = self.CreateMainFrame()
-        self.SetMainFrame(self.frame)
-        self.frame.LoadFrame(win32ui.IDR_MAINFRAME, win32con.WS_OVERLAPPEDWINDOW)
-        self.frame.DragAcceptFiles()  # we can accept these.
-        self.frame.ShowWindow(win32ui.GetInitialStateRequest())
-        self.frame.UpdateWindow()
-        self.HookCommands()
-
-    def OnHelp(self, id, code):
-        try:
-            if id == win32ui.ID_HELP_GUI_REF:
-                helpFile = regutil.GetRegisteredHelpFile("Pythonwin Reference")
-                helpCmd = win32con.HELP_CONTENTS
-            else:
-                helpFile = regutil.GetRegisteredHelpFile("Main Python Documentation")
-                helpCmd = win32con.HELP_FINDER
-            if helpFile is None:
-                win32ui.MessageBox("The help file is not registered!")
-            else:
-                from . import help
-
-                help.OpenHelpFile(helpFile, helpCmd)
-        except:
-            t, v, tb = sys.exc_info()
-            win32ui.MessageBox(
-                "Internal error in help file processing\r\n%s: %s" % (t, v)
-            )
-            tb = None  # Prevent a cycle
-
-    def DoLoadModules(self, modules):
-        # XXX - this should go, but the debugger uses it :-(
-        # dont do much checking!
-        for module in modules:
-            __import__(module)
-
-    def HookCommands(self):
-        self.frame.HookMessage(self.OnDropFiles, win32con.WM_DROPFILES)
-        self.HookCommand(self.HandleOnFileOpen, win32ui.ID_FILE_OPEN)
-        self.HookCommand(self.HandleOnFileNew, win32ui.ID_FILE_NEW)
-        self.HookCommand(self.OnFileMRU, win32ui.ID_FILE_MRU_FILE1)
-        self.HookCommand(self.OnHelpAbout, win32ui.ID_APP_ABOUT)
-        self.HookCommand(self.OnHelp, win32ui.ID_HELP_PYTHON)
-        self.HookCommand(self.OnHelp, win32ui.ID_HELP_GUI_REF)
-        # Hook for the right-click menu.
-        self.frame.GetWindow(win32con.GW_CHILD).HookMessage(
-            self.OnRClick, win32con.WM_RBUTTONDOWN
-        )
-
-    def SetApplicationPaths(self):
-        # Load the users/application paths
-        new_path = []
-        apppath = win32ui.GetProfileVal("Python", "Application Path", "").split(";")
-        for path in apppath:
-            if len(path) > 0:
-                new_path.append(win32ui.FullPath(path))
-        for extra_num in range(1, 11):
-            apppath = win32ui.GetProfileVal(
-                "Python", "Application Path %d" % extra_num, ""
-            ).split(";")
-            if len(apppath) == 0:
-                break
-            for path in apppath:
-                if len(path) > 0:
-                    new_path.append(win32ui.FullPath(path))
-        sys.path = new_path + sys.path
-
-    def OnRClick(self, params):
-        "Handle right click message"
-        # put up the entire FILE menu!
-        menu = win32ui.LoadMenu(win32ui.IDR_TEXTTYPE).GetSubMenu(0)
-        menu.TrackPopupMenu(params[5])  # track at mouse position.
-        return 0
-
-    def OnDropFiles(self, msg):
-        "Handle a file being dropped from file manager"
-        hDropInfo = msg[2]
-        self.frame.SetActiveWindow()  # active us
-        nFiles = win32api.DragQueryFile(hDropInfo)
-        try:
-            for iFile in range(0, nFiles):
-                fileName = win32api.DragQueryFile(hDropInfo, iFile)
-                win32ui.GetApp().OpenDocumentFile(fileName)
-        finally:
-            win32api.DragFinish(hDropInfo)
-
-        return 0
-
-    # No longer used by Pythonwin, as the C++ code has this same basic functionality
-    # but handles errors slightly better.
-    # It all still works, tho, so if you need similar functionality, you can use it.
-    # Therefore I havent deleted this code completely!
-    # 	def CallbackManager( self, ob, args = () ):
-    # 		"""Manage win32 callbacks.  Trap exceptions, report on them, then return 'All OK'
-    # 		to the frame-work. """
-    # 		import traceback
-    # 		try:
-    # 			ret = apply(ob, args)
-    # 			return ret
-    # 		except:
-    # 			# take copies of the exception values, else other (handled) exceptions may get
-    # 			# copied over by the other fns called.
-    # 			win32ui.SetStatusText('An exception occured in a windows command handler.')
-    # 			t, v, tb = sys.exc_info()
-    # 			traceback.print_exception(t, v, tb.tb_next)
-    # 			try:
-    # 				sys.stdout.flush()
-    # 			except (NameError, AttributeError):
-    # 				pass
-
-    # Command handlers.
-    def OnFileMRU(self, id, code):
-        "Called when a File 1-n message is recieved"
-        fileName = win32ui.GetRecentFileList()[id - win32ui.ID_FILE_MRU_FILE1]
-        win32ui.GetApp().OpenDocumentFile(fileName)
-
-    def HandleOnFileOpen(self, id, code):
-        "Called when FileOpen message is received"
-        win32ui.GetApp().OnFileOpen()
-
-    def HandleOnFileNew(self, id, code):
-        "Called when FileNew message is received"
-        win32ui.GetApp().OnFileNew()
-
-    def OnHelpAbout(self, id, code):
-        "Called when HelpAbout message is received.  Displays the About dialog."
-        win32ui.InitRichEdit()
-        dlg = AboutBox()
-        dlg.DoModal()
-
-
-def _GetRegistryValue(key, val, default=None):
-    # val is registry value - None for default val.
-    try:
-        hkey = win32api.RegOpenKey(win32con.HKEY_CURRENT_USER, key)
-        return win32api.RegQueryValueEx(hkey, val)[0]
-    except win32api.error:
-        try:
-            hkey = win32api.RegOpenKey(win32con.HKEY_LOCAL_MACHINE, key)
-            return win32api.RegQueryValueEx(hkey, val)[0]
-        except win32api.error:
-            return default
-
-
-scintilla = "Scintilla is Copyright 1998-2008 Neil Hodgson (http://www.scintilla.org)"
-idle = "This program uses IDLE extensions by Guido van Rossum, Tim Peters and others."
-contributors = "Thanks to the following people for making significant contributions: Roger Upole, Sidnei da Silva, Sam Rushing, Curt Hagenlocher, Dave Brennan, Roger Burnham, Gordon McMillan, Neil Hodgson, Laramie Leavitt. (let me know if I have forgotten you!)"
-
-
-# The About Box
-class AboutBox(dialog.Dialog):
-    def __init__(self, idd=win32ui.IDD_ABOUTBOX):
-        dialog.Dialog.__init__(self, idd)
-
-    def OnInitDialog(self):
-        text = (
-            "Pythonwin - Python IDE and GUI Framework for Windows.\n\n%s\n\nPython is %s\n\n%s\n\n%s\n\n%s"
-            % (win32ui.copyright, sys.copyright, scintilla, idle, contributors)
-        )
-        self.SetDlgItemText(win32ui.IDC_EDIT1, text)
-        # Get the build number - written by installers.
-        # For distutils build, read pywin32.version.txt
-        import sysconfig
-
-        site_packages = sysconfig.get_paths()["platlib"]
-        try:
-            build_no = (
-                open(os.path.join(site_packages, "pywin32.version.txt")).read().strip()
-            )
-            ver = "pywin32 build %s" % build_no
-        except EnvironmentError:
-            ver = None
-        if ver is None:
-            # See if we are Part of Active Python
-            ver = _GetRegistryValue(
-                "SOFTWARE\\ActiveState\\ActivePython", "CurrentVersion"
-            )
-            if ver is not None:
-                ver = "ActivePython build %s" % (ver,)
-        if ver is None:
-            ver = ""
-        self.SetDlgItemText(win32ui.IDC_ABOUT_VERSION, ver)
-        self.HookCommand(self.OnButHomePage, win32ui.IDC_BUTTON1)
-
-    def OnButHomePage(self, id, code):
-        if code == win32con.BN_CLICKED:
-            win32api.ShellExecute(
-                0, "open", "https://github.com/mhammond/pywin32", None, "", 1
-            )
-
-
-def Win32RawInput(prompt=None):
-    "Provide raw_input() for gui apps"
-    # flush stderr/out first.
-    try:
-        sys.stdout.flush()
-        sys.stderr.flush()
-    except:
-        pass
-    if prompt is None:
-        prompt = ""
-    ret = dialog.GetSimpleInput(prompt)
-    if ret == None:
-        raise KeyboardInterrupt("operation cancelled")
-    return ret
-
-
-def Win32Input(prompt=None):
-    "Provide input() for gui apps"
-    return eval(input(prompt))
-
-
-def HookInput():
-    try:
-        raw_input
-        # must be py2x...
-        sys.modules["__builtin__"].raw_input = Win32RawInput
-        sys.modules["__builtin__"].input = Win32Input
-    except NameError:
-        # must be py3k
-        import code
-
-        sys.modules["builtins"].input = Win32RawInput
-
-
-def HaveGoodGUI():
-    """Returns true if we currently have a good gui available."""
-    return "pywin.framework.startup" in sys.modules
-
-
-def CreateDefaultGUI(appClass=None):
-    """Creates a default GUI environment"""
-    if appClass is None:
-        from . import intpyapp  # Bring in the default app - could be param'd later.
-
-        appClass = intpyapp.InteractivePythonApp
-    # Create and init the app.
-    appClass().InitInstance()
-
-
-def CheckCreateDefaultGUI():
-    """Checks and creates if necessary a default GUI environment."""
-    rc = HaveGoodGUI()
-    if not rc:
-        CreateDefaultGUI()
-    return rc
diff --git a/lib/pythonwin/pywin/framework/bitmap.py b/lib/pythonwin/pywin/framework/bitmap.py
deleted file mode 100644
index 1501f72d..00000000
--- a/lib/pythonwin/pywin/framework/bitmap.py
+++ /dev/null
@@ -1,164 +0,0 @@
-import os
-
-import win32api
-import win32con
-import win32ui
-from pywin.mfc import docview, window
-
-from . import app
-
-bStretch = 1
-
-
-class BitmapDocument(docview.Document):
-    "A bitmap document.  Holds the bitmap data itself."
-
-    def __init__(self, template):
-        docview.Document.__init__(self, template)
-        self.bitmap = None
-
-    def OnNewDocument(self):
-        # I can not create new bitmaps.
-        win32ui.MessageBox("Bitmaps can not be created.")
-
-    def OnOpenDocument(self, filename):
-        self.bitmap = win32ui.CreateBitmap()
-        # init data members
-        f = open(filename, "rb")
-        try:
-            try:
-                self.bitmap.LoadBitmapFile(f)
-            except IOError:
-                win32ui.MessageBox("Could not load the bitmap from %s" % filename)
-                return 0
-        finally:
-            f.close()
-        self.size = self.bitmap.GetSize()
-        return 1
-
-    def DeleteContents(self):
-        self.bitmap = None
-
-
-class BitmapView(docview.ScrollView):
-    "A view of a bitmap.  Obtains data from document."
-
-    def __init__(self, doc):
-        docview.ScrollView.__init__(self, doc)
-        self.width = self.height = 0
-        # set up message handlers
-        self.HookMessage(self.OnSize, win32con.WM_SIZE)
-
-    def OnInitialUpdate(self):
-        doc = self.GetDocument()
-        if doc.bitmap:
-            bitmapSize = doc.bitmap.GetSize()
-            self.SetScrollSizes(win32con.MM_TEXT, bitmapSize)
-
-    def OnSize(self, params):
-        lParam = params[3]
-        self.width = win32api.LOWORD(lParam)
-        self.height = win32api.HIWORD(lParam)
-
-    def OnDraw(self, dc):
-        # set sizes used for "non stretch" mode.
-        doc = self.GetDocument()
-        if doc.bitmap is None:
-            return
-        bitmapSize = doc.bitmap.GetSize()
-        if bStretch:
-            # stretch BMP.
-            viewRect = (0, 0, self.width, self.height)
-            bitmapRect = (0, 0, bitmapSize[0], bitmapSize[1])
-            doc.bitmap.Paint(dc, viewRect, bitmapRect)
-        else:
-            # non stretch.
-            doc.bitmap.Paint(dc)
-
-
-class BitmapFrame(window.MDIChildWnd):
-    def OnCreateClient(self, createparams, context):
-        borderX = win32api.GetSystemMetrics(win32con.SM_CXFRAME)
-        borderY = win32api.GetSystemMetrics(win32con.SM_CYFRAME)
-        titleY = win32api.GetSystemMetrics(win32con.SM_CYCAPTION)  # includes border
-        # try and maintain default window pos, else adjust if cant fit
-        # get the main client window dimensions.
-        mdiClient = win32ui.GetMainFrame().GetWindow(win32con.GW_CHILD)
-        clientWindowRect = mdiClient.ScreenToClient(mdiClient.GetWindowRect())
-        clientWindowSize = (
-            clientWindowRect[2] - clientWindowRect[0],
-            clientWindowRect[3] - clientWindowRect[1],
-        )
-        left, top, right, bottom = mdiClient.ScreenToClient(self.GetWindowRect())
-        # 		width, height=context.doc.size[0], context.doc.size[1]
-        # 		width = width+borderX*2
-        # 		height= height+titleY+borderY*2-1
-        # 		if (left+width)>clientWindowSize[0]:
-        # 			left = clientWindowSize[0] - width
-        # 		if left<0:
-        # 			left = 0
-        # 			width = clientWindowSize[0]
-        # 		if (top+height)>clientWindowSize[1]:
-        # 			top = clientWindowSize[1] - height
-        # 		if top<0:
-        # 			top = 0
-        # 			height = clientWindowSize[1]
-        # 		self.frame.MoveWindow((left, top, left+width, top+height),0)
-        window.MDIChildWnd.OnCreateClient(self, createparams, context)
-        return 1
-
-
-class BitmapTemplate(docview.DocTemplate):
-    def __init__(self):
-        docview.DocTemplate.__init__(
-            self, win32ui.IDR_PYTHONTYPE, BitmapDocument, BitmapFrame, BitmapView
-        )
-
-    def MatchDocType(self, fileName, fileType):
-        doc = self.FindOpenDocument(fileName)
-        if doc:
-            return doc
-        ext = os.path.splitext(fileName)[1].lower()
-        if ext == ".bmp":  # removed due to PIL! or ext=='.ppm':
-            return win32ui.CDocTemplate_Confidence_yesAttemptNative
-        return win32ui.CDocTemplate_Confidence_maybeAttemptForeign
-
-
-# 		return win32ui.CDocTemplate_Confidence_noAttempt
-
-# For debugging purposes, when this module may be reloaded many times.
-try:
-    win32ui.GetApp().RemoveDocTemplate(bitmapTemplate)
-except NameError:
-    pass
-
-bitmapTemplate = BitmapTemplate()
-bitmapTemplate.SetDocStrings(
-    "\nBitmap\nBitmap\nBitmap (*.bmp)\n.bmp\nPythonBitmapFileType\nPython Bitmap File"
-)
-win32ui.GetApp().AddDocTemplate(bitmapTemplate)
-
-# This works, but just didnt make it through the code reorg.
-# class PPMBitmap(Bitmap):
-# 	def LoadBitmapFile(self, file ):
-# 		magic=file.readline()
-# 		if magic <> "P6\n":
-# 			raise TypeError, "The file is not a PPM format file"
-# 		rowcollist=string.split(file.readline())
-# 		cols=string.atoi(rowcollist[0])
-# 		rows=string.atoi(rowcollist[1])
-# 		file.readline()	# whats this one?
-# 		self.bitmap.LoadPPMFile(file,(cols,rows))
-
-
-def t():
-    bitmapTemplate.OpenDocumentFile("d:\\winnt\\arcade.bmp")
-    # OpenBMPFile( 'd:\\winnt\\arcade.bmp')
-
-
-def demo():
-    import glob
-
-    winDir = win32api.GetWindowsDirectory()
-    for fileName in glob.glob1(winDir, "*.bmp")[:2]:
-        bitmapTemplate.OpenDocumentFile(os.path.join(winDir, fileName))
diff --git a/lib/pythonwin/pywin/framework/cmdline.py b/lib/pythonwin/pywin/framework/cmdline.py
deleted file mode 100644
index dba31d1a..00000000
--- a/lib/pythonwin/pywin/framework/cmdline.py
+++ /dev/null
@@ -1,56 +0,0 @@
-# cmdline - command line utilities.
-import string
-import sys
-
-import win32ui
-
-
-def ParseArgs(str):
-    import string
-
-    ret = []
-    pos = 0
-    length = len(str)
-    while pos < length:
-        try:
-            while str[pos] in string.whitespace:
-                pos = pos + 1
-        except IndexError:
-            break
-        if pos >= length:
-            break
-        if str[pos] == '"':
-            pos = pos + 1
-            try:
-                endPos = str.index('"', pos) - 1
-                nextPos = endPos + 2
-            except ValueError:
-                endPos = length
-                nextPos = endPos + 1
-        else:
-            endPos = pos
-            while endPos < length and not str[endPos] in string.whitespace:
-                endPos = endPos + 1
-            nextPos = endPos + 1
-        ret.append(str[pos : endPos + 1].strip())
-        pos = nextPos
-    return ret
-
-
-def FixArgFileName(fileName):
-    """Convert a filename on the commandline to something useful.
-    Given an automatic filename on the commandline, turn it a python module name,
-    with the path added to sys.path."""
-    import os
-
-    path, fname = os.path.split(fileName)
-    if len(path) == 0:
-        path = os.curdir
-    path = os.path.abspath(path)
-    # must check that the command line arg's path is in sys.path
-    for syspath in sys.path:
-        if os.path.abspath(syspath) == path:
-            break
-    else:
-        sys.path.append(path)
-    return os.path.splitext(fname)[0]
diff --git a/lib/pythonwin/pywin/framework/dbgcommands.py b/lib/pythonwin/pywin/framework/dbgcommands.py
deleted file mode 100644
index e295926c..00000000
--- a/lib/pythonwin/pywin/framework/dbgcommands.py
+++ /dev/null
@@ -1,189 +0,0 @@
-# Command Handlers for the debugger.
-
-# Not in the debugger package, as I always want these interfaces to be
-# available, even if the debugger has not yet been (or can not be)
-# imported
-import warnings
-
-import win32ui
-from pywin.scintilla.control import CScintillaEditInterface
-
-from . import scriptutils
-
-IdToBarNames = {
-    win32ui.IDC_DBG_STACK: ("Stack", 0),
-    win32ui.IDC_DBG_BREAKPOINTS: ("Breakpoints", 0),
-    win32ui.IDC_DBG_WATCH: ("Watch", 1),
-}
-
-
-class DebuggerCommandHandler:
-    def HookCommands(self):
-        commands = (
-            (self.OnStep, None, win32ui.IDC_DBG_STEP),
-            (self.OnStepOut, self.OnUpdateOnlyBreak, win32ui.IDC_DBG_STEPOUT),
-            (self.OnStepOver, None, win32ui.IDC_DBG_STEPOVER),
-            (self.OnGo, None, win32ui.IDC_DBG_GO),
-            (self.OnClose, self.OnUpdateClose, win32ui.IDC_DBG_CLOSE),
-            (self.OnAdd, self.OnUpdateAddBreakpoints, win32ui.IDC_DBG_ADD),
-            (self.OnClearAll, self.OnUpdateClearAllBreakpoints, win32ui.IDC_DBG_CLEAR),
-            # 		                  (self.OnDebuggerToolbar, self.OnUpdateDebuggerToolbar, win32ui.ID_DEBUGGER_TOOLBAR),
-        )
-
-        frame = win32ui.GetMainFrame()
-
-        for methHandler, methUpdate, id in commands:
-            frame.HookCommand(methHandler, id)
-            if not methUpdate is None:
-                frame.HookCommandUpdate(methUpdate, id)
-
-        for id in list(IdToBarNames.keys()):
-            frame.HookCommand(self.OnDebuggerBar, id)
-            frame.HookCommandUpdate(self.OnUpdateDebuggerBar, id)
-
-    def OnDebuggerToolbar(self, id, code):
-        if code == 0:
-            return not win32ui.GetMainFrame().OnBarCheck(id)
-
-    def OnUpdateDebuggerToolbar(self, cmdui):
-        win32ui.GetMainFrame().OnUpdateControlBarMenu(cmdui)
-        cmdui.Enable(1)
-
-    def _GetDebugger(self):
-        try:
-            import pywin.debugger
-
-            return pywin.debugger.currentDebugger
-        except ImportError:
-            return None
-
-    def _DoOrStart(self, doMethod, startFlag):
-        d = self._GetDebugger()
-        if d is not None and d.IsDebugging():
-            method = getattr(d, doMethod)
-            method()
-        else:
-            scriptutils.RunScript(
-                defName=None, defArgs=None, bShowDialog=0, debuggingType=startFlag
-            )
-
-    def OnStep(self, msg, code):
-        self._DoOrStart("do_set_step", scriptutils.RS_DEBUGGER_STEP)
-
-    def OnStepOver(self, msg, code):
-        self._DoOrStart("do_set_next", scriptutils.RS_DEBUGGER_STEP)
-
-    def OnStepOut(self, msg, code):
-        d = self._GetDebugger()
-        if d is not None and d.IsDebugging():
-            d.do_set_return()
-
-    def OnGo(self, msg, code):
-        self._DoOrStart("do_set_continue", scriptutils.RS_DEBUGGER_GO)
-
-    def OnClose(self, msg, code):
-        d = self._GetDebugger()
-        if d is not None:
-            if d.IsDebugging():
-                d.set_quit()
-            else:
-                d.close()
-
-    def OnUpdateClose(self, cmdui):
-        d = self._GetDebugger()
-        if d is not None and d.inited:
-            cmdui.Enable(1)
-        else:
-            cmdui.Enable(0)
-
-    def OnAdd(self, msg, code):
-        doc, view = scriptutils.GetActiveEditorDocument()
-        if doc is None:
-            ## Don't do a messagebox, as this could be triggered from the app's
-            ## idle loop whenever the debug toolbar is visible, giving a never-ending
-            ## series of dialogs.  This can happen when the OnUpdate handler
-            ## for the toolbar button IDC_DBG_ADD fails, since MFC falls back to
-            ## sending a normal command if the UI update command fails.
-            ## win32ui.MessageBox('There is no active window - no breakpoint can be added')
-            warnings.warn("There is no active window - no breakpoint can be added")
-            return None
-        pathName = doc.GetPathName()
-        lineNo = view.LineFromChar(view.GetSel()[0]) + 1
-        # If I have a debugger, then tell it, otherwise just add a marker
-        d = self._GetDebugger()
-        if d is None:
-            import pywin.framework.editor.color.coloreditor
-
-            doc.MarkerToggle(
-                lineNo, pywin.framework.editor.color.coloreditor.MARKER_BREAKPOINT
-            )
-        else:
-            if d.get_break(pathName, lineNo):
-                win32ui.SetStatusText("Clearing breakpoint", 1)
-                rc = d.clear_break(pathName, lineNo)
-            else:
-                win32ui.SetStatusText("Setting breakpoint", 1)
-                rc = d.set_break(pathName, lineNo)
-            if rc:
-                win32ui.MessageBox(rc)
-            d.GUIRespondDebuggerData()
-
-    def OnClearAll(self, msg, code):
-        win32ui.SetStatusText("Clearing all breakpoints")
-        d = self._GetDebugger()
-        if d is None:
-            import pywin.framework.editor
-            import pywin.framework.editor.color.coloreditor
-
-            for doc in pywin.framework.editor.editorTemplate.GetDocumentList():
-                doc.MarkerDeleteAll(
-                    pywin.framework.editor.color.coloreditor.MARKER_BREAKPOINT
-                )
-        else:
-            d.clear_all_breaks()
-            d.UpdateAllLineStates()
-            d.GUIRespondDebuggerData()
-
-    def OnUpdateOnlyBreak(self, cmdui):
-        d = self._GetDebugger()
-        ok = d is not None and d.IsBreak()
-        cmdui.Enable(ok)
-
-    def OnUpdateAddBreakpoints(self, cmdui):
-        doc, view = scriptutils.GetActiveEditorDocument()
-        if doc is None or not isinstance(view, CScintillaEditInterface):
-            enabled = 0
-        else:
-            enabled = 1
-            lineNo = view.LineFromChar(view.GetSel()[0]) + 1
-            import pywin.framework.editor.color.coloreditor
-
-            cmdui.SetCheck(
-                doc.MarkerAtLine(
-                    lineNo, pywin.framework.editor.color.coloreditor.MARKER_BREAKPOINT
-                )
-                != 0
-            )
-        cmdui.Enable(enabled)
-
-    def OnUpdateClearAllBreakpoints(self, cmdui):
-        d = self._GetDebugger()
-        cmdui.Enable(d is None or len(d.breaks) != 0)
-
-    def OnUpdateDebuggerBar(self, cmdui):
-        name, always = IdToBarNames.get(cmdui.m_nID)
-        enabled = always
-        d = self._GetDebugger()
-        if d is not None and d.IsDebugging() and name is not None:
-            enabled = 1
-            bar = d.GetDebuggerBar(name)
-            cmdui.SetCheck(bar.IsWindowVisible())
-        cmdui.Enable(enabled)
-
-    def OnDebuggerBar(self, id, code):
-        name = IdToBarNames.get(id)[0]
-        d = self._GetDebugger()
-        if d is not None and name is not None:
-            bar = d.GetDebuggerBar(name)
-            newState = not bar.IsWindowVisible()
-            win32ui.GetMainFrame().ShowControlBar(bar, newState, 1)
diff --git a/lib/pythonwin/pywin/framework/dlgappcore.py b/lib/pythonwin/pywin/framework/dlgappcore.py
deleted file mode 100644
index 4b60cc1c..00000000
--- a/lib/pythonwin/pywin/framework/dlgappcore.py
+++ /dev/null
@@ -1,75 +0,0 @@
-# dlgappcore.
-#
-# base classes for dialog based apps.
-
-
-import win32api
-import win32con
-import win32ui
-from pywin.mfc import dialog
-
-from . import app
-
-error = "Dialog Application Error"
-
-
-class AppDialog(dialog.Dialog):
-    "The dialog box for the application"
-
-    def __init__(self, id, dll=None):
-        self.iconId = win32ui.IDR_MAINFRAME
-        dialog.Dialog.__init__(self, id, dll)
-
-    def OnInitDialog(self):
-        return dialog.Dialog.OnInitDialog(self)
-
-    # Provide support for a dlg app using an icon
-    def OnPaint(self):
-        if not self.IsIconic():
-            return self._obj_.OnPaint()
-        self.DefWindowProc(win32con.WM_ICONERASEBKGND, dc.GetHandleOutput(), 0)
-        left, top, right, bottom = self.GetClientRect()
-        left = (right - win32api.GetSystemMetrics(win32con.SM_CXICON)) >> 1
-        top = (bottom - win32api.GetSystemMetrics(win32con.SM_CYICON)) >> 1
-        hIcon = win32ui.GetApp().LoadIcon(self.iconId)
-        self.GetDC().DrawIcon((left, top), hIcon)
-
-    # Only needed to provide a minimized icon (and this seems
-    # less important under win95/NT4
-    def OnEraseBkgnd(self, dc):
-        if self.IsIconic():
-            return 1
-        else:
-            return self._obj_.OnEraseBkgnd(dc)
-
-    def OnQueryDragIcon(self):
-        return win32ui.GetApp().LoadIcon(self.iconId)
-
-    def PreDoModal(self):
-        pass
-
-
-class DialogApp(app.CApp):
-    "An application class, for an app with main dialog box"
-
-    def InitInstance(self):
-        # 		win32ui.SetProfileFileName('dlgapp.ini')
-        win32ui.LoadStdProfileSettings()
-        win32ui.EnableControlContainer()
-        win32ui.Enable3dControls()
-        self.dlg = self.frame = self.CreateDialog()
-
-        if self.frame is None:
-            raise error("No dialog was created by CreateDialog()")
-            return
-
-        self._obj_.InitDlgInstance(self.dlg)
-        self.PreDoModal()
-        self.dlg.PreDoModal()
-        self.dlg.DoModal()
-
-    def CreateDialog(self):
-        pass
-
-    def PreDoModal(self):
-        pass
diff --git a/lib/pythonwin/pywin/framework/editor/ModuleBrowser.py b/lib/pythonwin/pywin/framework/editor/ModuleBrowser.py
deleted file mode 100644
index 7fd96532..00000000
--- a/lib/pythonwin/pywin/framework/editor/ModuleBrowser.py
+++ /dev/null
@@ -1,235 +0,0 @@
-# ModuleBrowser.py - A view that provides a module browser for an editor document.
-import pyclbr
-
-import afxres
-import commctrl
-import pywin.framework.scriptutils
-import pywin.mfc.docview
-import win32api
-import win32con
-import win32ui
-from pywin.tools import browser, hierlist
-
-
-class HierListCLBRModule(hierlist.HierListItem):
-    def __init__(self, modName, clbrdata):
-        self.modName = modName
-        self.clbrdata = clbrdata
-
-    def GetText(self):
-        return self.modName
-
-    def GetSubList(self):
-        ret = []
-        for item in self.clbrdata.values():
-            if (
-                item.__class__ != pyclbr.Class
-            ):  # ie, it is a pyclbr Function instance (only introduced post 1.5.2)
-                ret.append(HierListCLBRFunction(item))
-            else:
-                ret.append(HierListCLBRClass(item))
-        ret.sort()
-        return ret
-
-    def IsExpandable(self):
-        return 1
-
-
-class HierListCLBRItem(hierlist.HierListItem):
-    def __init__(self, name, file, lineno, suffix=""):
-        self.name = str(name)
-        self.file = file
-        self.lineno = lineno
-        self.suffix = suffix
-
-    def __lt__(self, other):
-        return self.name < other.name
-
-    def __eq__(self, other):
-        return self.name == other.name
-
-    def GetText(self):
-        return self.name + self.suffix
-
-    def TakeDefaultAction(self):
-        if self.file:
-            pywin.framework.scriptutils.JumpToDocument(
-                self.file, self.lineno, bScrollToTop=1
-            )
-        else:
-            win32ui.SetStatusText("Can not locate the source code for this object.")
-
-    def PerformItemSelected(self):
-        if self.file is None:
-            msg = "%s - source can not be located." % (self.name,)
-        else:
-            msg = "%s defined at line %d of %s" % (self.name, self.lineno, self.file)
-        win32ui.SetStatusText(msg)
-
-
-class HierListCLBRClass(HierListCLBRItem):
-    def __init__(self, clbrclass, suffix=""):
-        try:
-            name = clbrclass.name
-            file = clbrclass.file
-            lineno = clbrclass.lineno
-            self.super = clbrclass.super
-            self.methods = clbrclass.methods
-        except AttributeError:
-            name = clbrclass
-            file = lineno = None
-            self.super = []
-            self.methods = {}
-        HierListCLBRItem.__init__(self, name, file, lineno, suffix)
-
-    def GetSubList(self):
-        r1 = []
-        for c in self.super:
-            r1.append(HierListCLBRClass(c, " (Parent class)"))
-        r1.sort()
-        r2 = []
-        for meth, lineno in self.methods.items():
-            r2.append(HierListCLBRMethod(meth, self.file, lineno))
-        r2.sort()
-        return r1 + r2
-
-    def IsExpandable(self):
-        return len(self.methods) + len(self.super)
-
-    def GetBitmapColumn(self):
-        return 21
-
-
-class HierListCLBRFunction(HierListCLBRItem):
-    def __init__(self, clbrfunc, suffix=""):
-        name = clbrfunc.name
-        file = clbrfunc.file
-        lineno = clbrfunc.lineno
-        HierListCLBRItem.__init__(self, name, file, lineno, suffix)
-
-    def GetBitmapColumn(self):
-        return 22
-
-
-class HierListCLBRMethod(HierListCLBRItem):
-    def GetBitmapColumn(self):
-        return 22
-
-
-class HierListCLBRErrorItem(hierlist.HierListItem):
-    def __init__(self, text):
-        self.text = text
-
-    def GetText(self):
-        return self.text
-
-    def GetSubList(self):
-        return [HierListCLBRErrorItem(self.text)]
-
-    def IsExpandable(self):
-        return 0
-
-
-class HierListCLBRErrorRoot(HierListCLBRErrorItem):
-    def IsExpandable(self):
-        return 1
-
-
-class BrowserView(pywin.mfc.docview.TreeView):
-    def OnInitialUpdate(self):
-        self.list = None
-        rc = self._obj_.OnInitialUpdate()
-        self.HookMessage(self.OnSize, win32con.WM_SIZE)
-        self.bDirty = 0
-        self.destroying = 0
-        return rc
-
-    def DestroyBrowser(self):
-        self.DestroyList()
-
-    def OnActivateView(self, activate, av, dv):
-        #        print "AV", self.bDirty, activate
-        if activate:
-            self.CheckRefreshList()
-        return self._obj_.OnActivateView(activate, av, dv)
-
-    def _MakeRoot(self):
-        path = self.GetDocument().GetPathName()
-        if not path:
-            return HierListCLBRErrorRoot(
-                "Error: Can not browse a file until it is saved"
-            )
-        else:
-            mod, path = pywin.framework.scriptutils.GetPackageModuleName(path)
-            if self.bDirty:
-                what = "Refreshing"
-                # Hack for pyclbr being too smart
-                try:
-                    del pyclbr._modules[mod]
-                except (KeyError, AttributeError):
-                    pass
-            else:
-                what = "Building"
-            win32ui.SetStatusText("%s class list - please wait..." % (what,), 1)
-            win32ui.DoWaitCursor(1)
-            try:
-                reader = pyclbr.readmodule_ex  # new version post 1.5.2
-            except AttributeError:
-                reader = pyclbr.readmodule
-            try:
-                data = reader(mod, [path])
-                if data:
-                    return HierListCLBRModule(mod, data)
-                else:
-                    return HierListCLBRErrorRoot("No Python classes in module.")
-
-            finally:
-                win32ui.DoWaitCursor(0)
-                win32ui.SetStatusText(win32ui.LoadString(afxres.AFX_IDS_IDLEMESSAGE))
-
-    def DestroyList(self):
-        self.destroying = 1
-        list = getattr(
-            self, "list", None
-        )  # If the document was not successfully opened, we may not have a list.
-        self.list = None
-        if list is not None:
-            list.HierTerm()
-        self.destroying = 0
-
-    def CheckMadeList(self):
-        if self.list is not None or self.destroying:
-            return
-        self.rootitem = root = self._MakeRoot()
-        self.list = list = hierlist.HierListWithItems(root, win32ui.IDB_BROWSER_HIER)
-        list.HierInit(self.GetParentFrame(), self)
-        list.SetStyle(
-            commctrl.TVS_HASLINES | commctrl.TVS_LINESATROOT | commctrl.TVS_HASBUTTONS
-        )
-
-    def CheckRefreshList(self):
-        if self.bDirty:
-            if self.list is None:
-                self.CheckMadeList()
-            else:
-                new_root = self._MakeRoot()
-                if self.rootitem.__class__ == new_root.__class__ == HierListCLBRModule:
-                    self.rootitem.modName = new_root.modName
-                    self.rootitem.clbrdata = new_root.clbrdata
-                    self.list.Refresh()
-                else:
-                    self.list.AcceptRoot(self._MakeRoot())
-            self.bDirty = 0
-
-    def OnSize(self, params):
-        lparam = params[3]
-        w = win32api.LOWORD(lparam)
-        h = win32api.HIWORD(lparam)
-        if w != 0:
-            self.CheckMadeList()
-        elif w == 0:
-            self.DestroyList()
-        return 1
-
-    def _UpdateUIForState(self):
-        self.bDirty = 1
diff --git a/lib/pythonwin/pywin/framework/editor/__init__.py b/lib/pythonwin/pywin/framework/editor/__init__.py
deleted file mode 100644
index ce13ece6..00000000
--- a/lib/pythonwin/pywin/framework/editor/__init__.py
+++ /dev/null
@@ -1,106 +0,0 @@
-# __init__ for the Pythonwin editor package.
-#
-# We used to support optional editors - eg, color or non-color.
-#
-# This really isnt necessary with Scintilla, and scintilla
-# is getting so deeply embedded that it was too much work.
-
-import sys
-
-import win32con
-import win32ui
-
-defaultCharacterFormat = (-402653169, 0, 200, 0, 0, 0, 49, "Courier New")
-
-##def GetDefaultEditorModuleName():
-##	import pywin
-##	# If someone has set pywin.editormodulename, then this is what we use
-##	try:
-##		prefModule = pywin.editormodulename
-##	except AttributeError:
-##		prefModule = win32ui.GetProfileVal("Editor","Module", "")
-##	return prefModule
-##
-##def WriteDefaultEditorModule(module):
-##	try:
-##		module = module.__name__
-##	except:
-##		pass
-##	win32ui.WriteProfileVal("Editor", "Module", module)
-
-
-def LoadDefaultEditor():
-    pass
-
-
-##	prefModule = GetDefaultEditorModuleName()
-##	restorePrefModule = None
-##	mod = None
-##	if prefModule:
-##		try:
-##			mod = __import__(prefModule)
-##		except 'xx':
-##			msg = "Importing your preferred editor ('%s') failed.\n\nError %s: %s\n\nAn attempt will be made to load the default editor.\n\nWould you like this editor disabled in the future?" % (prefModule, sys.exc_info()[0], sys.exc_info()[1])
-##			rc = win32ui.MessageBox(msg, "Error importing editor", win32con.MB_YESNO)
-##			if rc == win32con.IDNO:
-##				restorePrefModule = prefModule
-##			WriteDefaultEditorModule("")
-##			del rc
-##
-##	try:
-##		# Try and load the default one - dont catch errors here.
-##		if mod is None:
-##			prefModule = "pywin.framework.editor.color.coloreditor"
-##			mod = __import__(prefModule)
-##
-##		# Get at the real module.
-##		mod = sys.modules[prefModule]
-##
-##		# Do a "from mod import *"
-##		globals().update(mod.__dict__)
-##
-##	finally:
-##		# Restore the users default editor if it failed and they requested not to disable it.
-##		if restorePrefModule:
-##			WriteDefaultEditorModule(restorePrefModule)
-
-
-def GetEditorOption(option, defaultValue, min=None, max=None):
-    rc = win32ui.GetProfileVal("Editor", option, defaultValue)
-    if min is not None and rc < min:
-        rc = defaultValue
-    if max is not None and rc > max:
-        rc = defaultValue
-    return rc
-
-
-def SetEditorOption(option, newValue):
-    win32ui.WriteProfileVal("Editor", option, newValue)
-
-
-def DeleteEditorOption(option):
-    try:
-        win32ui.WriteProfileVal("Editor", option, None)
-    except win32ui.error:
-        pass
-
-
-# Load and save font tuples
-def GetEditorFontOption(option, default=None):
-    if default is None:
-        default = defaultCharacterFormat
-    fmt = GetEditorOption(option, "")
-    if fmt == "":
-        return default
-    try:
-        return eval(fmt)
-    except:
-        print("WARNING: Invalid font setting in registry - setting ignored")
-        return default
-
-
-def SetEditorFontOption(option, newValue):
-    SetEditorOption(option, str(newValue))
-
-
-from pywin.framework.editor.color.coloreditor import editorTemplate
diff --git a/lib/pythonwin/pywin/framework/editor/color/__init__.py b/lib/pythonwin/pywin/framework/editor/color/__init__.py
deleted file mode 100644
index e69de29b..00000000
diff --git a/lib/pythonwin/pywin/framework/editor/color/coloreditor.py b/lib/pythonwin/pywin/framework/editor/color/coloreditor.py
deleted file mode 100644
index 4aacc0ea..00000000
--- a/lib/pythonwin/pywin/framework/editor/color/coloreditor.py
+++ /dev/null
@@ -1,664 +0,0 @@
-# Color Editor originally by Neil Hodgson, but restructured by mh to integrate
-# even tighter into Pythonwin.
-
-import pywin.scintilla.keycodes
-import win32api
-import win32con
-import win32ui
-from pywin.framework.editor import (
-    GetEditorFontOption,
-    GetEditorOption,
-    SetEditorFontOption,
-    SetEditorOption,
-    defaultCharacterFormat,
-)
-from pywin.scintilla import bindings
-
-# from pywin.framework.editor import EditorPropertyPage
-
-MSG_CHECK_EXTERNAL_FILE = (
-    win32con.WM_USER + 1999
-)  ## WARNING: Duplicated in document.py and editor.py
-
-# Define a few common markers
-MARKER_BOOKMARK = 0
-MARKER_BREAKPOINT = 1
-MARKER_CURRENT = 2
-
-import pywin.scintilla.view
-from pywin.debugger import dbgcon
-from pywin.framework.editor.document import EditorDocumentBase
-from pywin.scintilla import scintillacon  # For the marker definitions
-from pywin.scintilla.document import CScintillaDocument
-
-
-class SyntEditDocument(EditorDocumentBase):
-    "A SyntEdit document."
-
-    def OnDebuggerStateChange(self, state):
-        self._ApplyOptionalToViews("OnDebuggerStateChange", state)
-
-    def HookViewNotifications(self, view):
-        EditorDocumentBase.HookViewNotifications(self, view)
-        view.SCISetUndoCollection(1)
-
-    def FinalizeViewCreation(self, view):
-        EditorDocumentBase.FinalizeViewCreation(self, view)
-        if view == self.GetFirstView():
-            self.GetDocTemplate().CheckIDLEMenus(view.idle)
-
-
-SyntEditViewParent = pywin.scintilla.view.CScintillaView
-
-
-class SyntEditView(SyntEditViewParent):
-    "A view of a SyntEdit.  Obtains data from document."
-
-    def __init__(self, doc):
-        SyntEditViewParent.__init__(self, doc)
-        self.bCheckingFile = 0
-
-    def OnInitialUpdate(self):
-        SyntEditViewParent.OnInitialUpdate(self)
-
-        self.HookMessage(self.OnRClick, win32con.WM_RBUTTONDOWN)
-
-        for id in (
-            win32ui.ID_VIEW_FOLD_COLLAPSE,
-            win32ui.ID_VIEW_FOLD_COLLAPSE_ALL,
-            win32ui.ID_VIEW_FOLD_EXPAND,
-            win32ui.ID_VIEW_FOLD_EXPAND_ALL,
-        ):
-            self.HookCommand(self.OnCmdViewFold, id)
-            self.HookCommandUpdate(self.OnUpdateViewFold, id)
-        self.HookCommand(self.OnCmdViewFoldTopLevel, win32ui.ID_VIEW_FOLD_TOPLEVEL)
-
-        # Define the markers
-        # 		self.SCIMarkerDeleteAll()
-        self.SCIMarkerDefineAll(
-            MARKER_BOOKMARK,
-            scintillacon.SC_MARK_ROUNDRECT,
-            win32api.RGB(0x0, 0x0, 0x0),
-            win32api.RGB(0, 0xFF, 0xFF),
-        )
-
-        self.SCIMarkerDefine(MARKER_CURRENT, scintillacon.SC_MARK_ARROW)
-        self.SCIMarkerSetBack(MARKER_CURRENT, win32api.RGB(0xFF, 0xFF, 0x00))
-
-        # Define the folding markers
-        if 1:  # traditional markers
-            self.SCIMarkerDefineAll(
-                scintillacon.SC_MARKNUM_FOLDEROPEN,
-                scintillacon.SC_MARK_MINUS,
-                win32api.RGB(0xFF, 0xFF, 0xFF),
-                win32api.RGB(0, 0, 0),
-            )
-            self.SCIMarkerDefineAll(
-                scintillacon.SC_MARKNUM_FOLDER,
-                scintillacon.SC_MARK_PLUS,
-                win32api.RGB(0xFF, 0xFF, 0xFF),
-                win32api.RGB(0, 0, 0),
-            )
-            self.SCIMarkerDefineAll(
-                scintillacon.SC_MARKNUM_FOLDERSUB,
-                scintillacon.SC_MARK_EMPTY,
-                win32api.RGB(0xFF, 0xFF, 0xFF),
-                win32api.RGB(0, 0, 0),
-            )
-            self.SCIMarkerDefineAll(
-                scintillacon.SC_MARKNUM_FOLDERTAIL,
-                scintillacon.SC_MARK_EMPTY,
-                win32api.RGB(0xFF, 0xFF, 0xFF),
-                win32api.RGB(0, 0, 0),
-            )
-            self.SCIMarkerDefineAll(
-                scintillacon.SC_MARKNUM_FOLDEREND,
-                scintillacon.SC_MARK_EMPTY,
-                win32api.RGB(0xFF, 0xFF, 0xFF),
-                win32api.RGB(0, 0, 0),
-            )
-            self.SCIMarkerDefineAll(
-                scintillacon.SC_MARKNUM_FOLDEROPENMID,
-                scintillacon.SC_MARK_EMPTY,
-                win32api.RGB(0xFF, 0xFF, 0xFF),
-                win32api.RGB(0, 0, 0),
-            )
-            self.SCIMarkerDefineAll(
-                scintillacon.SC_MARKNUM_FOLDERMIDTAIL,
-                scintillacon.SC_MARK_EMPTY,
-                win32api.RGB(0xFF, 0xFF, 0xFF),
-                win32api.RGB(0, 0, 0),
-            )
-        else:  # curved markers
-            self.SCIMarkerDefineAll(
-                scintillacon.SC_MARKNUM_FOLDEROPEN,
-                scintillacon.SC_MARK_CIRCLEMINUS,
-                win32api.RGB(0xFF, 0xFF, 0xFF),
-                win32api.RGB(0, 0, 0),
-            )
-            self.SCIMarkerDefineAll(
-                scintillacon.SC_MARKNUM_FOLDER,
-                scintillacon.SC_MARK_CIRCLEPLUS,
-                win32api.RGB(0xFF, 0xFF, 0xFF),
-                win32api.RGB(0, 0, 0),
-            )
-            self.SCIMarkerDefineAll(
-                scintillacon.SC_MARKNUM_FOLDERSUB,
-                scintillacon.SC_MARK_VLINE,
-                win32api.RGB(0xFF, 0xFF, 0xFF),
-                win32api.RGB(0, 0, 0),
-            )
-            self.SCIMarkerDefineAll(
-                scintillacon.SC_MARKNUM_FOLDERTAIL,
-                scintillacon.SC_MARK_LCORNERCURVE,
-                win32api.RGB(0xFF, 0xFF, 0xFF),
-                win32api.RGB(0, 0, 0),
-            )
-            self.SCIMarkerDefineAll(
-                scintillacon.SC_MARKNUM_FOLDEREND,
-                scintillacon.SC_MARK_CIRCLEPLUSCONNECTED,
-                win32api.RGB(0xFF, 0xFF, 0xFF),
-                win32api.RGB(0, 0, 0),
-            )
-            self.SCIMarkerDefineAll(
-                scintillacon.SC_MARKNUM_FOLDEROPENMID,
-                scintillacon.SC_MARK_CIRCLEMINUSCONNECTED,
-                win32api.RGB(0xFF, 0xFF, 0xFF),
-                win32api.RGB(0, 0, 0),
-            )
-            self.SCIMarkerDefineAll(
-                scintillacon.SC_MARKNUM_FOLDERMIDTAIL,
-                scintillacon.SC_MARK_TCORNERCURVE,
-                win32api.RGB(0xFF, 0xFF, 0xFF),
-                win32api.RGB(0, 0, 0),
-            )
-
-        self.SCIMarkerDefine(MARKER_BREAKPOINT, scintillacon.SC_MARK_CIRCLE)
-        # Marker background depends on debugger state
-        self.SCIMarkerSetFore(MARKER_BREAKPOINT, win32api.RGB(0x0, 0, 0))
-        # Get the current debugger state.
-        try:
-            import pywin.debugger
-
-            if pywin.debugger.currentDebugger is None:
-                state = dbgcon.DBGSTATE_NOT_DEBUGGING
-            else:
-                state = pywin.debugger.currentDebugger.debuggerState
-        except ImportError:
-            state = dbgcon.DBGSTATE_NOT_DEBUGGING
-        self.OnDebuggerStateChange(state)
-
-    def _GetSubConfigNames(self):
-        return ["editor"]  # Allow [Keys:Editor] sections to be specific to us
-
-    def DoConfigChange(self):
-        SyntEditViewParent.DoConfigChange(self)
-        tabSize = GetEditorOption("Tab Size", 4, 2)
-        indentSize = GetEditorOption("Indent Size", 4, 2)
-        bUseTabs = GetEditorOption("Use Tabs", 0)
-        bSmartTabs = GetEditorOption("Smart Tabs", 1)
-        ext = self.idle.IDLEExtension("AutoIndent")  # Required extension.
-
-        self.SCISetViewWS(GetEditorOption("View Whitespace", 0))
-        self.SCISetViewEOL(GetEditorOption("View EOL", 0))
-        self.SCISetIndentationGuides(GetEditorOption("View Indentation Guides", 0))
-
-        if GetEditorOption("Right Edge Enabled", 0):
-            mode = scintillacon.EDGE_BACKGROUND
-        else:
-            mode = scintillacon.EDGE_NONE
-        self.SCISetEdgeMode(mode)
-        self.SCISetEdgeColumn(GetEditorOption("Right Edge Column", 75))
-        self.SCISetEdgeColor(
-            GetEditorOption("Right Edge Color", win32api.RGB(0xEF, 0xEF, 0xEF))
-        )
-
-        width = GetEditorOption("Marker Margin Width", 16)
-        self.SCISetMarginWidthN(1, width)
-        width = GetEditorOption("Fold Margin Width", 12)
-        self.SCISetMarginWidthN(2, width)
-        width = GetEditorOption("Line Number Margin Width", 0)
-        self.SCISetMarginWidthN(0, width)
-        self.bFolding = GetEditorOption("Enable Folding", 1)
-        fold_flags = 0
-        self.SendScintilla(
-            scintillacon.SCI_SETMODEVENTMASK, scintillacon.SC_MOD_CHANGEFOLD
-        )
-        if self.bFolding:
-            if GetEditorOption("Fold Lines", 1):
-                fold_flags = 16
-
-        self.SCISetProperty("fold", self.bFolding)
-        self.SCISetFoldFlags(fold_flags)
-
-        tt_color = GetEditorOption("Tab Timmy Color", win32api.RGB(0xFF, 0, 0))
-        self.SendScintilla(scintillacon.SCI_INDICSETFORE, 1, tt_color)
-
-        tt_use = GetEditorOption("Use Tab Timmy", 1)
-        if tt_use:
-            self.SCISetProperty("tab.timmy.whinge.level", "1")
-
-        # Auto-indent has very complicated behaviour.  In a nutshell, the only
-        # way to get sensible behaviour from it is to ensure tabwidth != indentsize.
-        # Further, usetabs will only ever go from 1->0, never 0->1.
-        # This is _not_ the behaviour Pythonwin wants:
-        # * Tab width is arbitary, so should have no impact on smarts.
-        # * bUseTabs setting should reflect how new files are created, and
-        #   if Smart Tabs disabled, existing files are edited
-        # * If "Smart Tabs" is enabled, bUseTabs should have no bearing
-        #   for existing files (unless of course no context can be determined)
-        #
-        # So for smart tabs we configure the widget with completely dummy
-        # values (ensuring tabwidth != indentwidth), ask it to guess, then
-        # look at the values it has guessed, and re-configure
-        if bSmartTabs:
-            ext.config(usetabs=1, tabwidth=5, indentwidth=4)
-            ext.set_indentation_params(1)
-            if ext.indentwidth == 5:
-                # Either 5 literal spaces, or a single tab character. Assume a tab
-                usetabs = 1
-                indentwidth = tabSize
-            else:
-                # Either Indented with spaces, and indent size has been guessed or
-                # an empty file (or no context found - tough!)
-                if self.GetTextLength() == 0:  # emtpy
-                    usetabs = bUseTabs
-                    indentwidth = indentSize
-                else:  # guessed.
-                    indentwidth = ext.indentwidth
-                    usetabs = 0
-            # Tab size can never be guessed - set at user preference.
-            ext.config(usetabs=usetabs, indentwidth=indentwidth, tabwidth=tabSize)
-        else:
-            # Dont want smart-tabs - just set the options!
-            ext.config(usetabs=bUseTabs, tabwidth=tabSize, indentwidth=indentSize)
-        self.SCISetIndent(indentSize)
-        self.SCISetTabWidth(tabSize)
-
-    def OnDebuggerStateChange(self, state):
-        if state == dbgcon.DBGSTATE_NOT_DEBUGGING:
-            # Indicate breakpoints arent really usable.
-            # Not quite white - useful when no marker margin, so set as background color.
-            self.SCIMarkerSetBack(MARKER_BREAKPOINT, win32api.RGB(0xEF, 0xEF, 0xEF))
-        else:
-            # A light-red, so still readable when no marker margin.
-            self.SCIMarkerSetBack(MARKER_BREAKPOINT, win32api.RGB(0xFF, 0x80, 0x80))
-
-    def HookDocumentHandlers(self):
-        SyntEditViewParent.HookDocumentHandlers(self)
-        self.HookMessage(self.OnCheckExternalDocumentUpdated, MSG_CHECK_EXTERNAL_FILE)
-
-    def HookHandlers(self):
-        SyntEditViewParent.HookHandlers(self)
-        self.HookMessage(self.OnSetFocus, win32con.WM_SETFOCUS)
-
-    def _PrepareUserStateChange(self):
-        return self.GetSel(), self.GetFirstVisibleLine()
-
-    def _EndUserStateChange(self, info):
-        scrollOff = info[1] - self.GetFirstVisibleLine()
-        if scrollOff:
-            self.LineScroll(scrollOff)
-        # Make sure we dont reset the cursor beyond the buffer.
-        max = self.GetTextLength()
-        newPos = min(info[0][0], max), min(info[0][1], max)
-        self.SetSel(newPos)
-
-    #######################################
-    # The Windows Message or Notify handlers.
-    #######################################
-    def OnMarginClick(self, std, extra):
-        notify = self.SCIUnpackNotifyMessage(extra)
-        if notify.margin == 2:  # Our fold margin
-            line_click = self.LineFromChar(notify.position)
-            # 			max_line = self.GetLineCount()
-            if self.SCIGetFoldLevel(line_click) & scintillacon.SC_FOLDLEVELHEADERFLAG:
-                # If a fold point.
-                self.SCIToggleFold(line_click)
-        return 1
-
-    def OnSetFocus(self, msg):
-        # Even though we use file change notifications, we should be very sure about it here.
-        self.OnCheckExternalDocumentUpdated(msg)
-        return 1
-
-    def OnCheckExternalDocumentUpdated(self, msg):
-        if self.bCheckingFile:
-            return
-        self.bCheckingFile = 1
-        self.GetDocument().CheckExternalDocumentUpdated()
-        self.bCheckingFile = 0
-
-    def OnRClick(self, params):
-        menu = win32ui.CreatePopupMenu()
-        self.AppendMenu(menu, "&Locate module", "LocateModule")
-        self.AppendMenu(menu, flags=win32con.MF_SEPARATOR)
-        self.AppendMenu(menu, "&Undo", "EditUndo")
-        self.AppendMenu(menu, "&Redo", "EditRedo")
-        self.AppendMenu(menu, flags=win32con.MF_SEPARATOR)
-        self.AppendMenu(menu, "Cu&t", "EditCut")
-        self.AppendMenu(menu, "&Copy", "EditCopy")
-        self.AppendMenu(menu, "&Paste", "EditPaste")
-        self.AppendMenu(menu, flags=win32con.MF_SEPARATOR)
-        self.AppendMenu(menu, "&Select all", "EditSelectAll")
-        self.AppendMenu(
-            menu, "View &Whitespace", "ViewWhitespace", checked=self.SCIGetViewWS()
-        )
-        self.AppendMenu(
-            menu, "&Fixed Font", "ViewFixedFont", checked=self._GetColorizer().bUseFixed
-        )
-        self.AppendMenu(menu, flags=win32con.MF_SEPARATOR)
-        self.AppendMenu(menu, "&Goto line...", "GotoLine")
-
-        submenu = win32ui.CreatePopupMenu()
-        newitems = self.idle.GetMenuItems("edit")
-        for text, event in newitems:
-            self.AppendMenu(submenu, text, event)
-
-        flags = win32con.MF_STRING | win32con.MF_ENABLED | win32con.MF_POPUP
-        menu.AppendMenu(flags, submenu.GetHandle(), "&Source code")
-
-        flags = (
-            win32con.TPM_LEFTALIGN | win32con.TPM_LEFTBUTTON | win32con.TPM_RIGHTBUTTON
-        )
-        menu.TrackPopupMenu(params[5], flags, self)
-        return 0
-
-    def OnCmdViewFold(self, cid, code):  # Handle the menu command
-        if cid == win32ui.ID_VIEW_FOLD_EXPAND_ALL:
-            self.FoldExpandAllEvent(None)
-        elif cid == win32ui.ID_VIEW_FOLD_EXPAND:
-            self.FoldExpandEvent(None)
-        elif cid == win32ui.ID_VIEW_FOLD_COLLAPSE_ALL:
-            self.FoldCollapseAllEvent(None)
-        elif cid == win32ui.ID_VIEW_FOLD_COLLAPSE:
-            self.FoldCollapseEvent(None)
-        else:
-            print("Unknown collapse/expand ID")
-
-    def OnUpdateViewFold(self, cmdui):  # Update the tick on the UI.
-        if not self.bFolding:
-            cmdui.Enable(0)
-            return
-        id = cmdui.m_nID
-        if id in (win32ui.ID_VIEW_FOLD_EXPAND_ALL, win32ui.ID_VIEW_FOLD_COLLAPSE_ALL):
-            cmdui.Enable()
-        else:
-            enable = 0
-            lineno = self.LineFromChar(self.GetSel()[0])
-            foldable = (
-                self.SCIGetFoldLevel(lineno) & scintillacon.SC_FOLDLEVELHEADERFLAG
-            )
-            is_expanded = self.SCIGetFoldExpanded(lineno)
-            if id == win32ui.ID_VIEW_FOLD_EXPAND:
-                if foldable and not is_expanded:
-                    enable = 1
-            elif id == win32ui.ID_VIEW_FOLD_COLLAPSE:
-                if foldable and is_expanded:
-                    enable = 1
-            cmdui.Enable(enable)
-
-    def OnCmdViewFoldTopLevel(self, cid, code):  # Handle the menu command
-        self.FoldTopLevelEvent(None)
-
-    #######################################
-    # The Events
-    #######################################
-    def ToggleBookmarkEvent(self, event, pos=-1):
-        """Toggle a bookmark at the specified or current position"""
-        if pos == -1:
-            pos, end = self.GetSel()
-        startLine = self.LineFromChar(pos)
-        self.GetDocument().MarkerToggle(startLine + 1, MARKER_BOOKMARK)
-        return 0
-
-    def GotoNextBookmarkEvent(self, event, fromPos=-1):
-        """Move to the next bookmark"""
-        if fromPos == -1:
-            fromPos, end = self.GetSel()
-        startLine = self.LineFromChar(fromPos) + 1  # Zero based line to start
-        nextLine = self.GetDocument().MarkerGetNext(startLine + 1, MARKER_BOOKMARK) - 1
-        if nextLine < 0:
-            nextLine = self.GetDocument().MarkerGetNext(0, MARKER_BOOKMARK) - 1
-        if nextLine < 0 or nextLine == startLine - 1:
-            win32api.MessageBeep()
-        else:
-            self.SCIEnsureVisible(nextLine)
-            self.SCIGotoLine(nextLine)
-        return 0
-
-    def TabKeyEvent(self, event):
-        """Insert an indent.  If no selection, a single indent, otherwise a block indent"""
-        # Handle auto-complete first.
-        if self.SCIAutoCActive():
-            self.SCIAutoCComplete()
-            return 0
-        # Call the IDLE event.
-        return self.bindings.fire("<<smart-indent>>", event)
-
-    def EnterKeyEvent(self, event):
-        """Handle the enter key with special handling for auto-complete"""
-        # Handle auto-complete first.
-        if self.SCIAutoCActive():
-            self.SCIAutoCComplete()
-            self.SCIAutoCCancel()
-        # Call the IDLE event.
-        return self.bindings.fire("<<newline-and-indent>>", event)
-
-    def ShowInteractiveWindowEvent(self, event):
-        import pywin.framework.interact
-
-        pywin.framework.interact.ShowInteractiveWindow()
-
-    def FoldTopLevelEvent(self, event=None):
-        if not self.bFolding:
-            return 1
-
-        win32ui.DoWaitCursor(1)
-        try:
-            self.Colorize()
-            maxLine = self.GetLineCount()
-            # Find the first line, and check out its state.
-            for lineSeek in range(maxLine):
-                if self.SCIGetFoldLevel(lineSeek) & scintillacon.SC_FOLDLEVELHEADERFLAG:
-                    expanding = not self.SCIGetFoldExpanded(lineSeek)
-                    break
-            else:
-                # no folds here!
-                return
-            for lineSeek in range(lineSeek, maxLine):
-                level = self.SCIGetFoldLevel(lineSeek)
-                level_no = (
-                    level
-                    & scintillacon.SC_FOLDLEVELNUMBERMASK
-                    - scintillacon.SC_FOLDLEVELBASE
-                )
-                is_header = level & scintillacon.SC_FOLDLEVELHEADERFLAG
-                # 			print lineSeek, level_no, is_header
-                if level_no == 0 and is_header:
-                    if (expanding and not self.SCIGetFoldExpanded(lineSeek)) or (
-                        not expanding and self.SCIGetFoldExpanded(lineSeek)
-                    ):
-                        self.SCIToggleFold(lineSeek)
-        finally:
-            win32ui.DoWaitCursor(-1)
-
-    def FoldExpandSecondLevelEvent(self, event):
-        if not self.bFolding:
-            return 1
-        win32ui.DoWaitCursor(1)
-        ## I think this is needed since Scintilla may not have
-        ## already formatted parts of file outside visible window.
-        self.Colorize()
-        levels = [scintillacon.SC_FOLDLEVELBASE]
-        ## Scintilla's level number is based on amount of whitespace indentation
-        for lineno in range(self.GetLineCount()):
-            level = self.SCIGetFoldLevel(lineno)
-            if not level & scintillacon.SC_FOLDLEVELHEADERFLAG:
-                continue
-            curr_level = level & scintillacon.SC_FOLDLEVELNUMBERMASK
-            if curr_level > levels[-1]:
-                levels.append(curr_level)
-            try:
-                level_ind = levels.index(curr_level)
-            except ValueError:
-                ## probably syntax error in source file, bail
-                break
-            levels = levels[: level_ind + 1]
-            if level_ind == 1 and not self.SCIGetFoldExpanded(lineno):
-                self.SCIToggleFold(lineno)
-        win32ui.DoWaitCursor(-1)
-
-    def FoldCollapseSecondLevelEvent(self, event):
-        if not self.bFolding:
-            return 1
-        win32ui.DoWaitCursor(1)
-        ## I think this is needed since Scintilla may not have
-        ## already formatted parts of file outside visible window.
-        self.Colorize()
-        levels = [scintillacon.SC_FOLDLEVELBASE]
-        ## Scintilla's level number is based on amount of whitespace indentation
-        for lineno in range(self.GetLineCount()):
-            level = self.SCIGetFoldLevel(lineno)
-            if not level & scintillacon.SC_FOLDLEVELHEADERFLAG:
-                continue
-            curr_level = level & scintillacon.SC_FOLDLEVELNUMBERMASK
-            if curr_level > levels[-1]:
-                levels.append(curr_level)
-            try:
-                level_ind = levels.index(curr_level)
-            except ValueError:
-                ## probably syntax error in source file, bail
-                break
-            levels = levels[: level_ind + 1]
-            if level_ind == 1 and self.SCIGetFoldExpanded(lineno):
-                self.SCIToggleFold(lineno)
-        win32ui.DoWaitCursor(-1)
-
-    def FoldExpandEvent(self, event):
-        if not self.bFolding:
-            return 1
-        win32ui.DoWaitCursor(1)
-        lineno = self.LineFromChar(self.GetSel()[0])
-        if self.SCIGetFoldLevel(
-            lineno
-        ) & scintillacon.SC_FOLDLEVELHEADERFLAG and not self.SCIGetFoldExpanded(lineno):
-            self.SCIToggleFold(lineno)
-        win32ui.DoWaitCursor(-1)
-
-    def FoldExpandAllEvent(self, event):
-        if not self.bFolding:
-            return 1
-        win32ui.DoWaitCursor(1)
-        for lineno in range(0, self.GetLineCount()):
-            if self.SCIGetFoldLevel(
-                lineno
-            ) & scintillacon.SC_FOLDLEVELHEADERFLAG and not self.SCIGetFoldExpanded(
-                lineno
-            ):
-                self.SCIToggleFold(lineno)
-        win32ui.DoWaitCursor(-1)
-
-    def FoldCollapseEvent(self, event):
-        if not self.bFolding:
-            return 1
-        win32ui.DoWaitCursor(1)
-        lineno = self.LineFromChar(self.GetSel()[0])
-        if self.SCIGetFoldLevel(
-            lineno
-        ) & scintillacon.SC_FOLDLEVELHEADERFLAG and self.SCIGetFoldExpanded(lineno):
-            self.SCIToggleFold(lineno)
-        win32ui.DoWaitCursor(-1)
-
-    def FoldCollapseAllEvent(self, event):
-        if not self.bFolding:
-            return 1
-        win32ui.DoWaitCursor(1)
-        self.Colorize()
-        for lineno in range(0, self.GetLineCount()):
-            if self.SCIGetFoldLevel(
-                lineno
-            ) & scintillacon.SC_FOLDLEVELHEADERFLAG and self.SCIGetFoldExpanded(lineno):
-                self.SCIToggleFold(lineno)
-        win32ui.DoWaitCursor(-1)
-
-
-from pywin.framework.editor.frame import EditorFrame
-
-
-class SplitterFrame(EditorFrame):
-    def OnCreate(self, cs):
-        self.HookCommand(self.OnWindowSplit, win32ui.ID_WINDOW_SPLIT)
-        return 1
-
-    def OnWindowSplit(self, id, code):
-        self.GetDlgItem(win32ui.AFX_IDW_PANE_FIRST).DoKeyboardSplit()
-        return 1
-
-
-from pywin.framework.editor.template import EditorTemplateBase
-
-
-class SyntEditTemplate(EditorTemplateBase):
-    def __init__(
-        self, res=win32ui.IDR_TEXTTYPE, makeDoc=None, makeFrame=None, makeView=None
-    ):
-        if makeDoc is None:
-            makeDoc = SyntEditDocument
-        if makeView is None:
-            makeView = SyntEditView
-        if makeFrame is None:
-            makeFrame = SplitterFrame
-        self.bSetMenus = 0
-        EditorTemplateBase.__init__(self, res, makeDoc, makeFrame, makeView)
-
-    def CheckIDLEMenus(self, idle):
-        if self.bSetMenus:
-            return
-        self.bSetMenus = 1
-
-        submenu = win32ui.CreatePopupMenu()
-        newitems = idle.GetMenuItems("edit")
-        flags = win32con.MF_STRING | win32con.MF_ENABLED
-        for text, event in newitems:
-            id = bindings.event_to_commands.get(event)
-            if id is not None:
-                keyname = pywin.scintilla.view.configManager.get_key_binding(
-                    event, ["editor"]
-                )
-                if keyname is not None:
-                    text = text + "\t" + keyname
-                submenu.AppendMenu(flags, id, text)
-
-        mainMenu = self.GetSharedMenu()
-        editMenu = mainMenu.GetSubMenu(1)
-        editMenu.AppendMenu(win32con.MF_SEPARATOR, 0, "")
-        editMenu.AppendMenu(
-            win32con.MF_STRING | win32con.MF_POPUP | win32con.MF_ENABLED,
-            submenu.GetHandle(),
-            "&Source Code",
-        )
-
-    def _CreateDocTemplate(self, resourceId):
-        return win32ui.CreateDocTemplate(resourceId)
-
-    def CreateWin32uiDocument(self):
-        return self.DoCreateDoc()
-
-    def GetPythonPropertyPages(self):
-        """Returns a list of property pages"""
-        from pywin.scintilla import configui
-
-        return EditorTemplateBase.GetPythonPropertyPages(self) + [
-            configui.ScintillaFormatPropertyPage()
-        ]
-
-
-# For debugging purposes, when this module may be reloaded many times.
-try:
-    win32ui.GetApp().RemoveDocTemplate(editorTemplate)
-except NameError:
-    pass
-
-editorTemplate = SyntEditTemplate()
-win32ui.GetApp().AddDocTemplate(editorTemplate)
diff --git a/lib/pythonwin/pywin/framework/editor/configui.py b/lib/pythonwin/pywin/framework/editor/configui.py
deleted file mode 100644
index 903ad66c..00000000
--- a/lib/pythonwin/pywin/framework/editor/configui.py
+++ /dev/null
@@ -1,308 +0,0 @@
-import pywin.scintilla.config
-import win32api
-import win32con
-import win32ui
-from pywin.framework.editor import (
-    DeleteEditorOption,
-    GetEditorFontOption,
-    GetEditorOption,
-    SetEditorFontOption,
-    SetEditorOption,
-    defaultCharacterFormat,
-    editorTemplate,
-)
-from pywin.mfc import dialog
-
-from . import document
-
-# The standard 16 color VGA palette should always be possible
-paletteVGA = (
-    ("Black", 0, 0, 0),
-    ("Navy", 0, 0, 128),
-    ("Green", 0, 128, 0),
-    ("Cyan", 0, 128, 128),
-    ("Maroon", 128, 0, 0),
-    ("Purple", 128, 0, 128),
-    ("Olive", 128, 128, 0),
-    ("Gray", 128, 128, 128),
-    ("Silver", 192, 192, 192),
-    ("Blue", 0, 0, 255),
-    ("Lime", 0, 255, 0),
-    ("Aqua", 0, 255, 255),
-    ("Red", 255, 0, 0),
-    ("Fuchsia", 255, 0, 255),
-    ("Yellow", 255, 255, 0),
-    ("White", 255, 255, 255),
-)
-
-
-######################################################
-#
-# Property Page for editor options
-#
-class EditorPropertyPage(dialog.PropertyPage):
-    def __init__(self):
-        dialog.PropertyPage.__init__(self, win32ui.IDD_PP_EDITOR)
-        self.autooptions = []
-        self._AddEditorOption(win32ui.IDC_AUTO_RELOAD, "i", "Auto Reload", 1)
-        self._AddEditorOption(
-            win32ui.IDC_COMBO1, "i", "Backup Type", document.BAK_DOT_BAK_BAK_DIR
-        )
-        self._AddEditorOption(
-            win32ui.IDC_AUTOCOMPLETE, "i", "Autocomplete Attributes", 1
-        )
-        self._AddEditorOption(win32ui.IDC_CALLTIPS, "i", "Show Call Tips", 1)
-        self._AddEditorOption(
-            win32ui.IDC_MARGIN_LINENUMBER, "i", "Line Number Margin Width", 0
-        )
-        self._AddEditorOption(win32ui.IDC_RADIO1, "i", "MarkersInMargin", None)
-        self._AddEditorOption(
-            win32ui.IDC_MARGIN_MARKER, "i", "Marker Margin Width", None
-        )
-        self["Marker Margin Width"] = GetEditorOption("Marker Margin Width", 16)
-
-        # Folding
-        self._AddEditorOption(win32ui.IDC_MARGIN_FOLD, "i", "Fold Margin Width", 12)
-        self._AddEditorOption(win32ui.IDC_FOLD_ENABLE, "i", "Enable Folding", 1)
-        self._AddEditorOption(win32ui.IDC_FOLD_ON_OPEN, "i", "Fold On Open", 0)
-        self._AddEditorOption(win32ui.IDC_FOLD_SHOW_LINES, "i", "Fold Lines", 1)
-
-        # Right edge.
-        self._AddEditorOption(
-            win32ui.IDC_RIGHTEDGE_ENABLE, "i", "Right Edge Enabled", 0
-        )
-        self._AddEditorOption(
-            win32ui.IDC_RIGHTEDGE_COLUMN, "i", "Right Edge Column", 75
-        )
-
-        # Source control, etc
-        self.AddDDX(win32ui.IDC_VSS_INTEGRATE, "bVSS")
-        self.AddDDX(win32ui.IDC_KEYBOARD_CONFIG, "Configs", "l")
-        self["Configs"] = pywin.scintilla.config.find_config_files()
-
-    def _AddEditorOption(self, idd, typ, optionName, defaultVal):
-        self.AddDDX(idd, optionName, typ)
-        # some options are "derived" - ie, can be implied from others
-        # (eg, "view markers in background" is implied from "markerMarginWidth==0"
-        # So we don't actually store these values, but they do still get DDX support.
-        if defaultVal is not None:
-            self[optionName] = GetEditorOption(optionName, defaultVal)
-            self.autooptions.append((optionName, defaultVal))
-
-    def OnInitDialog(self):
-        for name, val in self.autooptions:
-            self[name] = GetEditorOption(name, val)
-
-        # Note that these MUST be in the same order as the BAK constants.
-        cbo = self.GetDlgItem(win32ui.IDC_COMBO1)
-        cbo.AddString("None")
-        cbo.AddString(".BAK File")
-        cbo.AddString("TEMP dir")
-        cbo.AddString("Own dir")
-
-        # Source Safe
-        bVSS = (
-            GetEditorOption("Source Control Module", "") == "pywin.framework.editor.vss"
-        )
-        self["bVSS"] = bVSS
-
-        edit = self.GetDlgItem(win32ui.IDC_RIGHTEDGE_SAMPLE)
-        edit.SetWindowText("Sample Color")
-
-        rc = dialog.PropertyPage.OnInitDialog(self)
-
-        try:
-            self.GetDlgItem(win32ui.IDC_KEYBOARD_CONFIG).SelectString(
-                -1, GetEditorOption("Keyboard Config", "default")
-            )
-        except win32ui.error:
-            import traceback
-
-            traceback.print_exc()
-            pass
-
-        self.HookCommand(self.OnButSimple, win32ui.IDC_FOLD_ENABLE)
-        self.HookCommand(self.OnButSimple, win32ui.IDC_RADIO1)
-        self.HookCommand(self.OnButSimple, win32ui.IDC_RADIO2)
-        self.HookCommand(self.OnButSimple, win32ui.IDC_RIGHTEDGE_ENABLE)
-        self.HookCommand(self.OnButEdgeColor, win32ui.IDC_RIGHTEDGE_DEFINE)
-
-        butMarginEnabled = self["Marker Margin Width"] > 0
-        self.GetDlgItem(win32ui.IDC_RADIO1).SetCheck(butMarginEnabled)
-        self.GetDlgItem(win32ui.IDC_RADIO2).SetCheck(not butMarginEnabled)
-
-        self.edgeColor = self.initialEdgeColor = GetEditorOption(
-            "Right Edge Color", win32api.RGB(0xEF, 0xEF, 0xEF)
-        )
-        for spinner_id in (win32ui.IDC_SPIN1, win32ui.IDC_SPIN2, win32ui.IDC_SPIN3):
-            spinner = self.GetDlgItem(spinner_id)
-            spinner.SetRange(0, 100)
-        self.UpdateUIForState()
-
-        return rc
-
-    def OnButSimple(self, id, code):
-        if code == win32con.BN_CLICKED:
-            self.UpdateUIForState()
-
-    def OnButEdgeColor(self, id, code):
-        if code == win32con.BN_CLICKED:
-            d = win32ui.CreateColorDialog(self.edgeColor, 0, self)
-            # Ensure the current color is a custom color (as it may not be in the swatch)
-            # plus some other nice gray scales.
-            ccs = [self.edgeColor]
-            for c in range(0xEF, 0x4F, -0x10):
-                ccs.append(win32api.RGB(c, c, c))
-            d.SetCustomColors(ccs)
-            if d.DoModal() == win32con.IDOK:
-                self.edgeColor = d.GetColor()
-                self.UpdateUIForState()
-
-    def UpdateUIForState(self):
-        folding = self.GetDlgItem(win32ui.IDC_FOLD_ENABLE).GetCheck()
-        self.GetDlgItem(win32ui.IDC_FOLD_ON_OPEN).EnableWindow(folding)
-        self.GetDlgItem(win32ui.IDC_FOLD_SHOW_LINES).EnableWindow(folding)
-
-        widthEnabled = self.GetDlgItem(win32ui.IDC_RADIO1).GetCheck()
-        self.GetDlgItem(win32ui.IDC_MARGIN_MARKER).EnableWindow(widthEnabled)
-        self.UpdateData()  # Ensure self[] is up to date with the control data.
-        if widthEnabled and self["Marker Margin Width"] == 0:
-            self["Marker Margin Width"] = 16
-            self.UpdateData(0)  # Ensure control up to date with self[]
-
-        # Right edge
-        edgeEnabled = self.GetDlgItem(win32ui.IDC_RIGHTEDGE_ENABLE).GetCheck()
-        self.GetDlgItem(win32ui.IDC_RIGHTEDGE_COLUMN).EnableWindow(edgeEnabled)
-        self.GetDlgItem(win32ui.IDC_RIGHTEDGE_SAMPLE).EnableWindow(edgeEnabled)
-        self.GetDlgItem(win32ui.IDC_RIGHTEDGE_DEFINE).EnableWindow(edgeEnabled)
-
-        edit = self.GetDlgItem(win32ui.IDC_RIGHTEDGE_SAMPLE)
-        edit.SetBackgroundColor(0, self.edgeColor)
-
-    def OnOK(self):
-        for name, defVal in self.autooptions:
-            SetEditorOption(name, self[name])
-        # Margin width gets handled differently.
-        if self["MarkersInMargin"] == 0:
-            SetEditorOption("Marker Margin Width", self["Marker Margin Width"])
-        else:
-            SetEditorOption("Marker Margin Width", 0)
-        if self.edgeColor != self.initialEdgeColor:
-            SetEditorOption("Right Edge Color", self.edgeColor)
-        if self["bVSS"]:
-            SetEditorOption("Source Control Module", "pywin.framework.editor.vss")
-        else:
-            if (
-                GetEditorOption("Source Control Module", "")
-                == "pywin.framework.editor.vss"
-            ):
-                SetEditorOption("Source Control Module", "")
-        # Keyboard config
-        configname = self.GetDlgItem(win32ui.IDC_KEYBOARD_CONFIG).GetWindowText()
-        if configname:
-            if configname == "default":
-                DeleteEditorOption("Keyboard Config")
-            else:
-                SetEditorOption("Keyboard Config", configname)
-
-            import pywin.scintilla.view
-
-            pywin.scintilla.view.LoadConfiguration()
-
-        # Now tell all views we have changed.
-        ##		for doc in editorTemplate.GetDocumentList():
-        ##			for view in doc.GetAllViews():
-        ##				try:
-        ##					fn = view.OnConfigChange
-        ##				except AttributeError:
-        ##					continue
-        ##				fn()
-        return 1
-
-
-class EditorWhitespacePropertyPage(dialog.PropertyPage):
-    def __init__(self):
-        dialog.PropertyPage.__init__(self, win32ui.IDD_PP_TABS)
-        self.autooptions = []
-        self._AddEditorOption(win32ui.IDC_TAB_SIZE, "i", "Tab Size", 4)
-        self._AddEditorOption(win32ui.IDC_INDENT_SIZE, "i", "Indent Size", 4)
-        self._AddEditorOption(win32ui.IDC_USE_SMART_TABS, "i", "Smart Tabs", 1)
-        self._AddEditorOption(win32ui.IDC_VIEW_WHITESPACE, "i", "View Whitespace", 0)
-        self._AddEditorOption(win32ui.IDC_VIEW_EOL, "i", "View EOL", 0)
-        self._AddEditorOption(
-            win32ui.IDC_VIEW_INDENTATIONGUIDES, "i", "View Indentation Guides", 0
-        )
-
-    def _AddEditorOption(self, idd, typ, optionName, defaultVal):
-        self.AddDDX(idd, optionName, typ)
-        self[optionName] = GetEditorOption(optionName, defaultVal)
-        self.autooptions.append((optionName, defaultVal))
-
-    def OnInitDialog(self):
-        for name, val in self.autooptions:
-            self[name] = GetEditorOption(name, val)
-
-        rc = dialog.PropertyPage.OnInitDialog(self)
-
-        idc = win32ui.IDC_TABTIMMY_NONE
-        if GetEditorOption("Use Tab Timmy", 1):
-            idc = win32ui.IDC_TABTIMMY_IND
-        self.GetDlgItem(idc).SetCheck(1)
-
-        idc = win32ui.IDC_RADIO1
-        if GetEditorOption("Use Tabs", 0):
-            idc = win32ui.IDC_USE_TABS
-        self.GetDlgItem(idc).SetCheck(1)
-
-        tt_color = GetEditorOption("Tab Timmy Color", win32api.RGB(0xFF, 0, 0))
-        self.cbo = self.GetDlgItem(win32ui.IDC_COMBO1)
-        for c in paletteVGA:
-            self.cbo.AddString(c[0])
-        sel = 0
-        for c in paletteVGA:
-            if tt_color == win32api.RGB(c[1], c[2], c[3]):
-                break
-            sel = sel + 1
-        else:
-            sel = -1
-        self.cbo.SetCurSel(sel)
-        self.HookCommand(self.OnButSimple, win32ui.IDC_TABTIMMY_NONE)
-        self.HookCommand(self.OnButSimple, win32ui.IDC_TABTIMMY_IND)
-        self.HookCommand(self.OnButSimple, win32ui.IDC_TABTIMMY_BG)
-        # Set ranges for the spinners.
-        for spinner_id in [win32ui.IDC_SPIN1, win32ui.IDC_SPIN2]:
-            spinner = self.GetDlgItem(spinner_id)
-            spinner.SetRange(1, 16)
-        return rc
-
-    def OnButSimple(self, id, code):
-        if code == win32con.BN_CLICKED:
-            self.UpdateUIForState()
-
-    def UpdateUIForState(self):
-        timmy = self.GetDlgItem(win32ui.IDC_TABTIMMY_NONE).GetCheck()
-        self.GetDlgItem(win32ui.IDC_COMBO1).EnableWindow(not timmy)
-
-    def OnOK(self):
-        for name, defVal in self.autooptions:
-            SetEditorOption(name, self[name])
-
-        SetEditorOption("Use Tabs", self.GetDlgItem(win32ui.IDC_USE_TABS).GetCheck())
-
-        SetEditorOption(
-            "Use Tab Timmy", self.GetDlgItem(win32ui.IDC_TABTIMMY_IND).GetCheck()
-        )
-        c = paletteVGA[self.cbo.GetCurSel()]
-        SetEditorOption("Tab Timmy Color", win32api.RGB(c[1], c[2], c[3]))
-
-        return 1
-
-
-def testpp():
-    ps = dialog.PropertySheet("Editor Options")
-    ps.AddPage(EditorWhitespacePropertyPage())
-    ps.DoModal()
-
-
-if __name__ == "__main__":
-    testpp()
diff --git a/lib/pythonwin/pywin/framework/editor/document.py b/lib/pythonwin/pywin/framework/editor/document.py
deleted file mode 100644
index e66947b8..00000000
--- a/lib/pythonwin/pywin/framework/editor/document.py
+++ /dev/null
@@ -1,378 +0,0 @@
-# We no longer support the old, non-colour editor!
-
-import os
-import shutil
-import traceback
-
-import win32api
-import win32con
-import win32ui
-from pywin.framework.editor import GetEditorOption
-from pywin.mfc import docview, object
-
-BAK_NONE = 0
-BAK_DOT_BAK = 1
-BAK_DOT_BAK_TEMP_DIR = 2
-BAK_DOT_BAK_BAK_DIR = 3
-
-MSG_CHECK_EXTERNAL_FILE = (
-    win32con.WM_USER + 1999
-)  ## WARNING: Duplicated in editor.py and coloreditor.py
-
-import pywin.scintilla.document
-
-ParentEditorDocument = pywin.scintilla.document.CScintillaDocument
-
-
-class EditorDocumentBase(ParentEditorDocument):
-    def __init__(self, template):
-        self.bAutoReload = GetEditorOption("Auto Reload", 1)
-        self.bDeclinedReload = 0  # Has the user declined to reload.
-        self.fileStat = None
-        self.bReportedFileNotFound = 0
-
-        # what sort of bak file should I create.
-        # default to write to %temp%/bak/filename.ext
-        self.bakFileType = GetEditorOption("Backup Type", BAK_DOT_BAK_BAK_DIR)
-
-        self.watcherThread = FileWatchingThread(self)
-        self.watcherThread.CreateThread()
-        # Should I try and use VSS integration?
-        self.scModuleName = GetEditorOption("Source Control Module", "")
-        self.scModule = None  # Loaded when first used.
-        ParentEditorDocument.__init__(self, template, template.CreateWin32uiDocument())
-
-    def OnCloseDocument(self):
-        self.watcherThread.SignalStop()
-        return self._obj_.OnCloseDocument()
-
-    # 	def OnOpenDocument(self, name):
-    # 		rc = ParentEditorDocument.OnOpenDocument(self, name)
-    # 		self.GetFirstView()._SetLoadedText(self.text)
-    # 		self._DocumentStateChanged()
-    # 		return rc
-
-    def OnSaveDocument(self, fileName):
-        win32ui.SetStatusText("Saving file...", 1)
-        # rename to bak if required.
-        dir, basename = os.path.split(fileName)
-        if self.bakFileType == BAK_DOT_BAK:
-            bakFileName = dir + "\\" + os.path.splitext(basename)[0] + ".bak"
-        elif self.bakFileType == BAK_DOT_BAK_TEMP_DIR:
-            bakFileName = (
-                win32api.GetTempPath() + "\\" + os.path.splitext(basename)[0] + ".bak"
-            )
-        elif self.bakFileType == BAK_DOT_BAK_BAK_DIR:
-            tempPath = os.path.join(win32api.GetTempPath(), "bak")
-            try:
-                os.mkdir(tempPath, 0)
-            except os.error:
-                pass
-            bakFileName = os.path.join(tempPath, basename)
-        try:
-            os.unlink(bakFileName)  # raise NameError if no bakups wanted.
-        except (os.error, NameError):
-            pass
-        try:
-            # Do a copy as it might be on different volumes,
-            # and the file may be a hard-link, causing the link
-            # to follow the backup.
-            shutil.copy2(fileName, bakFileName)
-        except (os.error, NameError, IOError):
-            pass
-        try:
-            self.SaveFile(fileName)
-        except IOError as details:
-            win32ui.MessageBox("Error - could not save file\r\n\r\n%s" % details)
-            return 0
-        except (UnicodeEncodeError, LookupError) as details:
-            rc = win32ui.MessageBox(
-                "Encoding failed: \r\n%s" % details
-                + "\r\nPlease add desired source encoding as first line of file, eg \r\n"
-                + "# -*- coding: mbcs -*-\r\n\r\n"
-                + "If you continue, the file will be saved as binary and will\r\n"
-                + "not be valid in the declared encoding.\r\n\r\n"
-                + "Save the file as binary with an invalid encoding?",
-                "File save failed",
-                win32con.MB_YESNO | win32con.MB_DEFBUTTON2,
-            )
-            if rc == win32con.IDYES:
-                try:
-                    self.SaveFile(fileName, encoding="latin-1")
-                except IOError as details:
-                    win32ui.MessageBox(
-                        "Error - could not save file\r\n\r\n%s" % details
-                    )
-                    return 0
-            else:
-                return 0
-        self.SetModifiedFlag(0)  # No longer dirty
-        self.bDeclinedReload = 0  # They probably want to know if it changes again!
-        win32ui.AddToRecentFileList(fileName)
-        self.SetPathName(fileName)
-        win32ui.SetStatusText("Ready")
-        self._DocumentStateChanged()
-        return 1
-
-    def FinalizeViewCreation(self, view):
-        ParentEditorDocument.FinalizeViewCreation(self, view)
-        if view == self.GetFirstView():
-            self._DocumentStateChanged()
-            if view.bFolding and GetEditorOption("Fold On Open", 0):
-                view.FoldTopLevelEvent()
-
-    def HookViewNotifications(self, view):
-        ParentEditorDocument.HookViewNotifications(self, view)
-
-    # Support for reloading the document from disk - presumably after some
-    # external application has modified it (or possibly source control has
-    # checked it out.
-    def ReloadDocument(self):
-        """Reloads the document from disk.  Assumes the file has
-        been saved and user has been asked if necessary - it just does it!
-        """
-        win32ui.SetStatusText("Reloading document.  Please wait...", 1)
-        self.SetModifiedFlag(0)
-        # Loop over all views, saving their state, then reload the document
-        views = self.GetAllViews()
-        states = []
-        for view in views:
-            try:
-                info = view._PrepareUserStateChange()
-            except AttributeError:  # Not our editor view?
-                info = None
-            states.append(info)
-        self.OnOpenDocument(self.GetPathName())
-        for view, info in zip(views, states):
-            if info is not None:
-                view._EndUserStateChange(info)
-        self._DocumentStateChanged()
-        win32ui.SetStatusText("Document reloaded.")
-
-    # Reloading the file
-    def CheckExternalDocumentUpdated(self):
-        if self.bDeclinedReload or not self.GetPathName():
-            return
-        try:
-            newstat = os.stat(self.GetPathName())
-        except os.error as exc:
-            if not self.bReportedFileNotFound:
-                print(
-                    "The file '%s' is open for editing, but\nchecking it for changes caused the error: %s"
-                    % (self.GetPathName(), exc.strerror)
-                )
-                self.bReportedFileNotFound = 1
-            return
-        if self.bReportedFileNotFound:
-            print(
-                "The file '%s' has re-appeared - continuing to watch for changes..."
-                % (self.GetPathName(),)
-            )
-            self.bReportedFileNotFound = (
-                0  # Once found again we want to start complaining.
-            )
-        changed = (
-            (self.fileStat is None)
-            or self.fileStat[0] != newstat[0]
-            or self.fileStat[6] != newstat[6]
-            or self.fileStat[8] != newstat[8]
-            or self.fileStat[9] != newstat[9]
-        )
-        if changed:
-            question = None
-            if self.IsModified():
-                question = (
-                    "%s\r\n\r\nThis file has been modified outside of the source editor.\r\nDo you want to reload it and LOSE THE CHANGES in the source editor?"
-                    % self.GetPathName()
-                )
-                mbStyle = win32con.MB_YESNO | win32con.MB_DEFBUTTON2  # Default to "No"
-            else:
-                if not self.bAutoReload:
-                    question = (
-                        "%s\r\n\r\nThis file has been modified outside of the source editor.\r\nDo you want to reload it?"
-                        % self.GetPathName()
-                    )
-                    mbStyle = win32con.MB_YESNO  # Default to "Yes"
-            if question:
-                rc = win32ui.MessageBox(question, None, mbStyle)
-                if rc != win32con.IDYES:
-                    self.bDeclinedReload = 1
-                    return
-            self.ReloadDocument()
-
-    def _DocumentStateChanged(self):
-        """Called whenever the documents state (on disk etc) has been changed
-        by the editor (eg, as the result of a save operation)
-        """
-        if self.GetPathName():
-            try:
-                self.fileStat = os.stat(self.GetPathName())
-            except os.error:
-                self.fileStat = None
-        else:
-            self.fileStat = None
-        self.watcherThread._DocumentStateChanged()
-        self._UpdateUIForState()
-        self._ApplyOptionalToViews("_UpdateUIForState")
-        self._ApplyOptionalToViews("SetReadOnly", self._IsReadOnly())
-        self._ApplyOptionalToViews("SCISetSavePoint")
-        # Allow the debugger to reset us too.
-        import pywin.debugger
-
-        if pywin.debugger.currentDebugger is not None:
-            pywin.debugger.currentDebugger.UpdateDocumentLineStates(self)
-
-    # Read-only document support - make it obvious to the user
-    # that the file is read-only.
-    def _IsReadOnly(self):
-        return self.fileStat is not None and (self.fileStat[0] & 128) == 0
-
-    def _UpdateUIForState(self):
-        """Change the title to reflect the state of the document -
-        eg ReadOnly, Dirty, etc
-        """
-        filename = self.GetPathName()
-        if not filename:
-            return  # New file - nothing to do
-        try:
-            # This seems necessary so the internal state of the window becomes
-            # "visible".  without it, it is still shown, but certain functions
-            # (such as updating the title) dont immediately work?
-            self.GetFirstView().ShowWindow(win32con.SW_SHOW)
-            title = win32ui.GetFileTitle(filename)
-        except win32ui.error:
-            title = filename
-        if self._IsReadOnly():
-            title = title + " (read-only)"
-        self.SetTitle(title)
-
-    def MakeDocumentWritable(self):
-        pretend_ss = 0  # Set to 1 to test this without source safe :-)
-        if not self.scModuleName and not pretend_ss:  # No Source Control support.
-            win32ui.SetStatusText(
-                "Document is read-only, and no source-control system is configured"
-            )
-            win32api.MessageBeep()
-            return 0
-
-        # We have source control support - check if the user wants to use it.
-        msg = "Would you like to check this file out?"
-        defButton = win32con.MB_YESNO
-        if self.IsModified():
-            msg = msg + "\r\n\r\nALL CHANGES IN THE EDITOR WILL BE LOST"
-            defButton = win32con.MB_YESNO
-        if win32ui.MessageBox(msg, None, defButton) != win32con.IDYES:
-            return 0
-
-        if pretend_ss:
-            print("We are only pretending to check it out!")
-            win32api.SetFileAttributes(
-                self.GetPathName(), win32con.FILE_ATTRIBUTE_NORMAL
-            )
-            self.ReloadDocument()
-            return 1
-
-        # Now call on the module to do it.
-        if self.scModule is None:
-            try:
-                self.scModule = __import__(self.scModuleName)
-                for part in self.scModuleName.split(".")[1:]:
-                    self.scModule = getattr(self.scModule, part)
-            except:
-                traceback.print_exc()
-                print("Error loading source control module.")
-                return 0
-
-        if self.scModule.CheckoutFile(self.GetPathName()):
-            self.ReloadDocument()
-            return 1
-        return 0
-
-    def CheckMakeDocumentWritable(self):
-        if self._IsReadOnly():
-            return self.MakeDocumentWritable()
-        return 1
-
-    def SaveModified(self):
-        # Called as the document is closed.  If we are about
-        # to prompt for a save, bring the document to the foreground.
-        if self.IsModified():
-            frame = self.GetFirstView().GetParentFrame()
-            try:
-                frame.MDIActivate()
-                frame.AutoRestore()
-            except:
-                print("Could not bring document to foreground")
-        return self._obj_.SaveModified()
-
-
-# NOTE - I DONT use the standard threading module,
-# as this waits for all threads to terminate at shutdown.
-# When using the debugger, it is possible shutdown will
-# occur without Pythonwin getting a complete shutdown,
-# so we deadlock at the end - threading is waiting for
-import pywin.mfc.thread
-import win32event
-
-
-class FileWatchingThread(pywin.mfc.thread.WinThread):
-    def __init__(self, doc):
-        self.doc = doc
-        self.adminEvent = win32event.CreateEvent(None, 0, 0, None)
-        self.stopEvent = win32event.CreateEvent(None, 0, 0, None)
-        self.watchEvent = None
-        pywin.mfc.thread.WinThread.__init__(self)
-
-    def _DocumentStateChanged(self):
-        win32event.SetEvent(self.adminEvent)
-
-    def RefreshEvent(self):
-        self.hwnd = self.doc.GetFirstView().GetSafeHwnd()
-        if self.watchEvent is not None:
-            win32api.FindCloseChangeNotification(self.watchEvent)
-            self.watchEvent = None
-        path = self.doc.GetPathName()
-        if path:
-            path = os.path.dirname(path)
-        if path:
-            filter = (
-                win32con.FILE_NOTIFY_CHANGE_FILE_NAME
-                | win32con.FILE_NOTIFY_CHANGE_ATTRIBUTES
-                | win32con.FILE_NOTIFY_CHANGE_LAST_WRITE
-            )
-            try:
-                self.watchEvent = win32api.FindFirstChangeNotification(path, 0, filter)
-            except win32api.error as exc:
-                print("Can not watch file", path, "for changes -", exc.strerror)
-
-    def SignalStop(self):
-        win32event.SetEvent(self.stopEvent)
-
-    def Run(self):
-        while 1:
-            handles = [self.stopEvent, self.adminEvent]
-            if self.watchEvent is not None:
-                handles.append(self.watchEvent)
-            rc = win32event.WaitForMultipleObjects(handles, 0, win32event.INFINITE)
-            if rc == win32event.WAIT_OBJECT_0:
-                break
-            elif rc == win32event.WAIT_OBJECT_0 + 1:
-                self.RefreshEvent()
-            else:
-                win32api.PostMessage(self.hwnd, MSG_CHECK_EXTERNAL_FILE, 0, 0)
-                try:
-                    # If the directory has been removed underneath us, we get this error.
-                    win32api.FindNextChangeNotification(self.watchEvent)
-                except win32api.error as exc:
-                    print(
-                        "Can not watch file",
-                        self.doc.GetPathName(),
-                        "for changes -",
-                        exc.strerror,
-                    )
-                    break
-
-        # close a circular reference
-        self.doc = None
-        if self.watchEvent:
-            win32api.FindCloseChangeNotification(self.watchEvent)
diff --git a/lib/pythonwin/pywin/framework/editor/editor.py b/lib/pythonwin/pywin/framework/editor/editor.py
deleted file mode 100644
index aa1f5385..00000000
--- a/lib/pythonwin/pywin/framework/editor/editor.py
+++ /dev/null
@@ -1,516 +0,0 @@
-#####################################################################
-#
-# editor.py
-#
-# A general purpose text editor, built on top of the win32ui edit
-# type, which is built on an MFC CEditView
-#
-#
-# We now support reloading of externally modified documented
-# (eg, presumably by some other process, such as source control or
-# another editor.
-# We also suport auto-loading of externally modified files.
-# - if the current document has not been modified in this
-# editor, but has been modified on disk, then the file
-# can be automatically reloaded.
-#
-# Note that it will _always_ prompt you if the file in the editor has been modified.
-
-
-import re
-
-import regex
-import win32api
-import win32con
-import win32ui
-from pywin.framework.editor import (
-    GetEditorFontOption,
-    GetEditorOption,
-    SetEditorFontOption,
-    SetEditorOption,
-    defaultCharacterFormat,
-)
-from pywin.mfc import afxres, dialog, docview
-
-patImport = regex.symcomp("import \(<name>.*\)")
-patIndent = regex.compile("^\\([ \t]*[~ \t]\\)")
-
-ID_LOCATE_FILE = 0xE200
-ID_GOTO_LINE = 0xE2001
-MSG_CHECK_EXTERNAL_FILE = (
-    win32con.WM_USER + 1999
-)  ## WARNING: Duplicated in document.py and coloreditor.py
-
-# Key Codes that modify the bufffer when Ctrl or Alt are NOT pressed.
-MODIFYING_VK_KEYS = [
-    win32con.VK_BACK,
-    win32con.VK_TAB,
-    win32con.VK_RETURN,
-    win32con.VK_SPACE,
-    win32con.VK_DELETE,
-]
-for k in range(48, 91):
-    MODIFYING_VK_KEYS.append(k)
-
-# Key Codes that modify the bufffer when Ctrl is pressed.
-MODIFYING_VK_KEYS_CTRL = [
-    win32con.VK_BACK,
-    win32con.VK_RETURN,
-    win32con.VK_SPACE,
-    win32con.VK_DELETE,
-]
-
-# Key Codes that modify the bufffer when Alt is pressed.
-MODIFYING_VK_KEYS_ALT = [
-    win32con.VK_BACK,
-    win32con.VK_RETURN,
-    win32con.VK_SPACE,
-    win32con.VK_DELETE,
-]
-
-
-# The editor itself starts here.
-# Using the MFC Document/View model, we have an EditorDocument, which is responsible for
-# managing the contents of the file, and a view which is responsible for rendering it.
-#
-# Due to a limitation in the Windows edit controls, we are limited to one view
-# per document, although nothing in this code assumes this (I hope!)
-
-isRichText = 1  # We are using the Rich Text control.  This has not been tested with value "0" for quite some time!
-
-# ParentEditorDocument=docview.Document
-from .document import EditorDocumentBase
-
-ParentEditorDocument = EditorDocumentBase
-
-
-class EditorDocument(ParentEditorDocument):
-    #
-    # File loading and saving operations
-    #
-    def OnOpenDocument(self, filename):
-        #
-        # handle Unix and PC text file format.
-        #
-
-        # Get the "long name" of the file name, as it may have been translated
-        # to short names by the shell.
-        self.SetPathName(filename)  # Must set this early!
-        # Now do the work!
-        self.BeginWaitCursor()
-        win32ui.SetStatusText("Loading file...", 1)
-        try:
-            f = open(filename, "rb")
-        except IOError:
-            win32ui.MessageBox(
-                filename
-                + "\nCan not find this file\nPlease verify that the correct path and file name are given"
-            )
-            self.EndWaitCursor()
-            return 0
-        raw = f.read()
-        f.close()
-        contents = self.TranslateLoadedData(raw)
-        rc = 0
-        try:
-            self.GetFirstView().SetWindowText(contents)
-            rc = 1
-        except TypeError:  # Null byte in file.
-            win32ui.MessageBox("This file contains NULL bytes, and can not be edited")
-            rc = 0
-
-        self.EndWaitCursor()
-        self.SetModifiedFlag(0)  # No longer dirty
-        self._DocumentStateChanged()
-        return rc
-
-    def TranslateLoadedData(self, data):
-        """Given raw data read from a file, massage it suitable for the edit window"""
-        # if a CR in the first 250 chars, then perform the expensive translate
-        if data[:250].find("\r") == -1:
-            win32ui.SetStatusText(
-                "Translating from Unix file format - please wait...", 1
-            )
-            return re.sub("\r*\n", "\r\n", data)
-        else:
-            return data
-
-    def SaveFile(self, fileName, encoding=None):
-        if isRichText:
-            view = self.GetFirstView()
-            view.SaveTextFile(fileName, encoding=encoding)
-        else:  # Old style edit view window.
-            self.GetFirstView().SaveFile(fileName)
-        try:
-            # Make sure line cache has updated info about me!
-            import linecache
-
-            linecache.checkcache()
-        except:
-            pass
-
-    #
-    # Color state stuff
-    #
-    def SetAllLineColors(self, color=None):
-        for view in self.GetAllViews():
-            view.SetAllLineColors(color)
-
-    def SetLineColor(self, lineNo, color):
-        "Color a line of all views"
-        for view in self.GetAllViews():
-            view.SetLineColor(lineNo, color)
-
-
-# 	def StreamTextOut(self, data): ### This seems unreliable???
-# 		self.saveFileHandle.write(data)
-# 		return 1 # keep em coming!
-
-# ParentEditorView=docview.EditView
-ParentEditorView = docview.RichEditView
-
-
-class EditorView(ParentEditorView):
-    def __init__(self, doc):
-        ParentEditorView.__init__(self, doc)
-        if isRichText:
-            self.SetWordWrap(win32ui.CRichEditView_WrapNone)
-
-        self.addToMRU = 1
-        self.HookHandlers()
-        self.bCheckingFile = 0
-
-        self.defCharFormat = GetEditorFontOption("Default Font", defaultCharacterFormat)
-
-        # Smart tabs override everything else if context can be worked out.
-        self.bSmartTabs = GetEditorOption("Smart Tabs", 1)
-
-        self.tabSize = GetEditorOption("Tab Size", 8)
-        self.indentSize = GetEditorOption("Indent Size", 8)
-        # If next indent is at a tab position, and useTabs is set, a tab will be inserted.
-        self.bUseTabs = GetEditorOption("Use Tabs", 1)
-
-    def OnInitialUpdate(self):
-        rc = self._obj_.OnInitialUpdate()
-        self.SetDefaultCharFormat(self.defCharFormat)
-        return rc
-
-    def CutCurLine(self):
-        curLine = self._obj_.LineFromChar()
-        nextLine = curLine + 1
-        start = self._obj_.LineIndex(curLine)
-        end = self._obj_.LineIndex(nextLine)
-        if end == 0:  # must be last line.
-            end = start + self.end.GetLineLength(curLine)
-        self._obj_.SetSel(start, end)
-        self._obj_.Cut()
-
-    def _PrepareUserStateChange(self):
-        "Return selection, lineindex, etc info, so it can be restored"
-        self.SetRedraw(0)
-        return self.GetModify(), self.GetSel(), self.GetFirstVisibleLine()
-
-    def _EndUserStateChange(self, info):
-        scrollOff = info[2] - self.GetFirstVisibleLine()
-        if scrollOff:
-            self.LineScroll(scrollOff)
-        self.SetSel(info[1])
-        self.SetModify(info[0])
-        self.SetRedraw(1)
-        self.InvalidateRect()
-        self.UpdateWindow()
-
-    def _UpdateUIForState(self):
-        self.SetReadOnly(self.GetDocument()._IsReadOnly())
-
-    def SetAllLineColors(self, color=None):
-        if isRichText:
-            info = self._PrepareUserStateChange()
-            try:
-                if color is None:
-                    color = self.defCharFormat[4]
-                self.SetSel(0, -1)
-                self.SetSelectionCharFormat((win32con.CFM_COLOR, 0, 0, 0, color))
-            finally:
-                self._EndUserStateChange(info)
-
-    def SetLineColor(self, lineNo, color):
-        "lineNo is the 1 based line number to set.  If color is None, default color is used."
-        if isRichText:
-            info = self._PrepareUserStateChange()
-            try:
-                if color is None:
-                    color = self.defCharFormat[4]
-                lineNo = lineNo - 1
-                startIndex = self.LineIndex(lineNo)
-                if startIndex != -1:
-                    self.SetSel(startIndex, self.LineIndex(lineNo + 1))
-                    self.SetSelectionCharFormat((win32con.CFM_COLOR, 0, 0, 0, color))
-            finally:
-                self._EndUserStateChange(info)
-
-    def Indent(self):
-        """Insert an indent to move the cursor to the next tab position.
-
-        Honors the tab size and 'use tabs' settings.  Assumes the cursor is already at the
-        position to be indented, and the selection is a single character (ie, not a block)
-        """
-        start, end = self._obj_.GetSel()
-        startLine = self._obj_.LineFromChar(start)
-        line = self._obj_.GetLine(startLine)
-        realCol = start - self._obj_.LineIndex(startLine)
-        # Calulate the next tab stop.
-        # Expand existing tabs.
-        curCol = 0
-        for ch in line[:realCol]:
-            if ch == "\t":
-                curCol = ((curCol / self.tabSize) + 1) * self.tabSize
-            else:
-                curCol = curCol + 1
-        nextColumn = ((curCol / self.indentSize) + 1) * self.indentSize
-        # 		print "curCol is", curCol, "nextColumn is", nextColumn
-        ins = None
-        if self.bSmartTabs:
-            # Look for some context.
-            if realCol == 0:  # Start of the line - see if the line above can tell us
-                lookLine = startLine - 1
-                while lookLine >= 0:
-                    check = self._obj_.GetLine(lookLine)[0:1]
-                    if check in ("\t", " "):
-                        ins = check
-                        break
-                    lookLine = lookLine - 1
-            else:  # See if the previous char can tell us
-                check = line[realCol - 1]
-                if check in ("\t", " "):
-                    ins = check
-
-        # Either smart tabs off, or not smart enough!
-        # Use the "old style" settings.
-        if ins is None:
-            if self.bUseTabs and nextColumn % self.tabSize == 0:
-                ins = "\t"
-            else:
-                ins = " "
-
-        if ins == " ":
-            # Calc the number of spaces to take us to the next stop
-            ins = ins * (nextColumn - curCol)
-
-        self._obj_.ReplaceSel(ins)
-
-    def BlockDent(self, isIndent, startLine, endLine):
-        "Indent/Undent all lines specified"
-        if not self.GetDocument().CheckMakeDocumentWritable():
-            return 0
-        tabSize = self.tabSize  # hard-code for now!
-        info = self._PrepareUserStateChange()
-        try:
-            for lineNo in range(startLine, endLine):
-                pos = self._obj_.LineIndex(lineNo)
-                self._obj_.SetSel(pos, pos)
-                if isIndent:
-                    self.Indent()
-                else:
-                    line = self._obj_.GetLine(lineNo)
-                    try:
-                        noToDel = 0
-                        if line[0] == "\t":
-                            noToDel = 1
-                        elif line[0] == " ":
-                            for noToDel in range(0, tabSize):
-                                if line[noToDel] != " ":
-                                    break
-                            else:
-                                noToDel = tabSize
-                        if noToDel:
-                            self._obj_.SetSel(pos, pos + noToDel)
-                            self._obj_.Clear()
-                    except IndexError:
-                        pass
-        finally:
-            self._EndUserStateChange(info)
-        self.GetDocument().SetModifiedFlag(1)  # Now dirty
-        self._obj_.SetSel(self.LineIndex(startLine), self.LineIndex(endLine))
-
-    def GotoLine(self, lineNo=None):
-        try:
-            if lineNo is None:
-                lineNo = int(input("Enter Line Number"))
-        except (ValueError, KeyboardInterrupt):
-            return 0
-        self.GetLineCount()  # Seems to be needed when file first opened???
-        charNo = self.LineIndex(lineNo - 1)
-        self.SetSel(charNo)
-
-    def HookHandlers(self):  # children can override, but should still call me!
-        # 		self.HookAllKeyStrokes(self.OnKey)
-        self.HookMessage(self.OnCheckExternalDocumentUpdated, MSG_CHECK_EXTERNAL_FILE)
-        self.HookMessage(self.OnRClick, win32con.WM_RBUTTONDOWN)
-        self.HookMessage(self.OnSetFocus, win32con.WM_SETFOCUS)
-        self.HookMessage(self.OnKeyDown, win32con.WM_KEYDOWN)
-        self.HookKeyStroke(self.OnKeyCtrlY, 25)  # ^Y
-        self.HookKeyStroke(self.OnKeyCtrlG, 7)  # ^G
-        self.HookKeyStroke(self.OnKeyTab, 9)  # TAB
-        self.HookKeyStroke(self.OnKeyEnter, 13)  # Enter
-        self.HookCommand(self.OnCmdLocateFile, ID_LOCATE_FILE)
-        self.HookCommand(self.OnCmdGotoLine, ID_GOTO_LINE)
-        self.HookCommand(self.OnEditPaste, afxres.ID_EDIT_PASTE)
-        self.HookCommand(self.OnEditCut, afxres.ID_EDIT_CUT)
-
-    # Hook Handlers
-    def OnSetFocus(self, msg):
-        # Even though we use file change notifications, we should be very sure about it here.
-        self.OnCheckExternalDocumentUpdated(msg)
-
-    def OnRClick(self, params):
-        menu = win32ui.CreatePopupMenu()
-
-        # look for a module name
-        line = self._obj_.GetLine().strip()
-        flags = win32con.MF_STRING | win32con.MF_ENABLED
-        if patImport.match(line) == len(line):
-            menu.AppendMenu(
-                flags, ID_LOCATE_FILE, "&Locate %s.py" % patImport.group("name")
-            )
-            menu.AppendMenu(win32con.MF_SEPARATOR)
-        menu.AppendMenu(flags, win32ui.ID_EDIT_UNDO, "&Undo")
-        menu.AppendMenu(win32con.MF_SEPARATOR)
-        menu.AppendMenu(flags, win32ui.ID_EDIT_CUT, "Cu&t")
-        menu.AppendMenu(flags, win32ui.ID_EDIT_COPY, "&Copy")
-        menu.AppendMenu(flags, win32ui.ID_EDIT_PASTE, "&Paste")
-        menu.AppendMenu(flags, win32con.MF_SEPARATOR)
-        menu.AppendMenu(flags, win32ui.ID_EDIT_SELECT_ALL, "&Select all")
-        menu.AppendMenu(flags, win32con.MF_SEPARATOR)
-        menu.AppendMenu(flags, ID_GOTO_LINE, "&Goto line...")
-        menu.TrackPopupMenu(params[5])
-        return 0
-
-    def OnCmdGotoLine(self, cmd, code):
-        self.GotoLine()
-        return 0
-
-    def OnCmdLocateFile(self, cmd, code):
-        modName = patImport.group("name")
-        if not modName:
-            return 0
-        import pywin.framework.scriptutils
-
-        fileName = pywin.framework.scriptutils.LocatePythonFile(modName)
-        if fileName is None:
-            win32ui.SetStatusText("Can't locate module %s" % modName)
-        else:
-            win32ui.GetApp().OpenDocumentFile(fileName)
-        return 0
-
-    # Key handlers
-    def OnKeyEnter(self, key):
-        if not self.GetDocument().CheckMakeDocumentWritable():
-            return 0
-        curLine = self._obj_.GetLine()
-        self._obj_.ReplaceSel("\r\n")  # insert the newline
-        # If the current line indicates the next should be indented,
-        # then copy the current indentation to this line.
-        res = patIndent.match(curLine, 0)
-        if res > 0 and curLine.strip():
-            curIndent = patIndent.group(1)
-            self._obj_.ReplaceSel(curIndent)
-        return 0  # dont pass on
-
-    def OnKeyCtrlY(self, key):
-        if not self.GetDocument().CheckMakeDocumentWritable():
-            return 0
-        self.CutCurLine()
-        return 0  # dont let him have it!
-
-    def OnKeyCtrlG(self, key):
-        self.GotoLine()
-        return 0  # dont let him have it!
-
-    def OnKeyTab(self, key):
-        if not self.GetDocument().CheckMakeDocumentWritable():
-            return 0
-        start, end = self._obj_.GetSel()
-        if start == end:  # normal TAB key
-            self.Indent()
-            return 0  # we handled this.
-
-        # Otherwise it is a block indent/dedent.
-        if start > end:
-            start, end = end, start  # swap them.
-        startLine = self._obj_.LineFromChar(start)
-        endLine = self._obj_.LineFromChar(end)
-
-        self.BlockDent(win32api.GetKeyState(win32con.VK_SHIFT) >= 0, startLine, endLine)
-        return 0
-
-    def OnEditPaste(self, id, code):
-        # Return 1 if we can make the file editable.(or it already is!)
-        return self.GetDocument().CheckMakeDocumentWritable()
-
-    def OnEditCut(self, id, code):
-        # Return 1 if we can make the file editable.(or it already is!)
-        return self.GetDocument().CheckMakeDocumentWritable()
-
-    def OnKeyDown(self, msg):
-        key = msg[2]
-        if win32api.GetKeyState(win32con.VK_CONTROL) & 0x8000:
-            modList = MODIFYING_VK_KEYS_CTRL
-        elif win32api.GetKeyState(win32con.VK_MENU) & 0x8000:
-            modList = MODIFYING_VK_KEYS_ALT
-        else:
-            modList = MODIFYING_VK_KEYS
-
-        if key in modList:
-            # Return 1 if we can make the file editable.(or it already is!)
-            return self.GetDocument().CheckMakeDocumentWritable()
-        return 1  # Pass it on OK
-
-    # 	def OnKey(self, key):
-    # 		return self.GetDocument().CheckMakeDocumentWritable()
-
-    def OnCheckExternalDocumentUpdated(self, msg):
-        if self._obj_ is None or self.bCheckingFile:
-            return
-        self.bCheckingFile = 1
-        self.GetDocument().CheckExternalDocumentUpdated()
-        self.bCheckingFile = 0
-
-
-from .template import EditorTemplateBase
-
-
-class EditorTemplate(EditorTemplateBase):
-    def __init__(
-        self, res=win32ui.IDR_TEXTTYPE, makeDoc=None, makeFrame=None, makeView=None
-    ):
-        if makeDoc is None:
-            makeDoc = EditorDocument
-        if makeView is None:
-            makeView = EditorView
-        EditorTemplateBase.__init__(self, res, makeDoc, makeFrame, makeView)
-
-    def _CreateDocTemplate(self, resourceId):
-        return win32ui.CreateRichEditDocTemplate(resourceId)
-
-    def CreateWin32uiDocument(self):
-        return self.DoCreateRichEditDoc()
-
-
-def Create(fileName=None, title=None, template=None):
-    return editorTemplate.OpenDocumentFile(fileName)
-
-
-from pywin.framework.editor import GetDefaultEditorModuleName
-
-prefModule = GetDefaultEditorModuleName()
-# Initialize only if this is the "default" editor.
-if __name__ == prefModule:
-    # For debugging purposes, when this module may be reloaded many times.
-    try:
-        win32ui.GetApp().RemoveDocTemplate(editorTemplate)
-    except (NameError, win32ui.error):
-        pass
-
-    editorTemplate = EditorTemplate()
-    win32ui.GetApp().AddDocTemplate(editorTemplate)
diff --git a/lib/pythonwin/pywin/framework/editor/frame.py b/lib/pythonwin/pywin/framework/editor/frame.py
deleted file mode 100644
index e927d16e..00000000
--- a/lib/pythonwin/pywin/framework/editor/frame.py
+++ /dev/null
@@ -1,74 +0,0 @@
-# frame.py - The MDI frame window for an editor.
-import pywin.framework.window
-import win32con
-import win32ui
-
-from . import ModuleBrowser
-
-
-class EditorFrame(pywin.framework.window.MDIChildWnd):
-    def OnCreateClient(self, cp, context):
-        # Create the default view as specified by the template (ie, the editor view)
-        view = context.template.MakeView(context.doc)
-        # Create the browser view.
-        browserView = ModuleBrowser.BrowserView(context.doc)
-        view2 = context.template.MakeView(context.doc)
-
-        splitter = win32ui.CreateSplitter()
-        style = win32con.WS_CHILD | win32con.WS_VISIBLE
-        splitter.CreateStatic(self, 1, 2, style, win32ui.AFX_IDW_PANE_FIRST)
-        sub_splitter = self.sub_splitter = win32ui.CreateSplitter()
-        sub_splitter.CreateStatic(splitter, 2, 1, style, win32ui.AFX_IDW_PANE_FIRST + 1)
-
-        # Note we must add the default view first, so that doc.GetFirstView() returns the editor view.
-        sub_splitter.CreateView(view, 1, 0, (0, 0))
-        splitter.CreateView(browserView, 0, 0, (0, 0))
-        sub_splitter.CreateView(view2, 0, 0, (0, 0))
-
-        ##        print "First view is", context.doc.GetFirstView()
-        ##        print "Views are", view, view2, browserView
-        ##        print "Parents are", view.GetParent(), view2.GetParent(), browserView.GetParent()
-        ##        print "Splitter is", splitter
-        ##        print "sub splitter is", sub_splitter
-        ## Old
-        ##        splitter.CreateStatic (self, 1, 2)
-        ##        splitter.CreateView(view, 0, 1, (0,0)) # size ignored.
-        ##        splitter.CreateView (browserView, 0, 0, (0, 0))
-
-        # Restrict the size of the browser splitter (and we can avoid filling
-        # it until it is shown)
-        splitter.SetColumnInfo(0, 10, 20)
-        # And the active view is our default view (so it gets initial focus)
-        self.SetActiveView(view)
-
-    def GetEditorView(self):
-        # In a multi-view (eg, splitter) environment, get
-        # an editor (ie, scintilla) view
-        # Look for the splitter opened the most!
-        if self.sub_splitter is None:
-            return self.GetDlgItem(win32ui.AFX_IDW_PANE_FIRST)
-        v1 = self.sub_splitter.GetPane(0, 0)
-        v2 = self.sub_splitter.GetPane(1, 0)
-        r1 = v1.GetWindowRect()
-        r2 = v2.GetWindowRect()
-        if r1[3] - r1[1] > r2[3] - r2[1]:
-            return v1
-        return v2
-
-    def GetBrowserView(self):
-        # XXX - should fix this :-)
-        return self.GetActiveDocument().GetAllViews()[1]
-
-    def OnClose(self):
-        doc = self.GetActiveDocument()
-        if not doc.SaveModified():
-            ## Cancel button selected from Save dialog, do not actually close
-            ## print 'close cancelled'
-            return 0
-        ## So the 'Save' dialog doesn't come up twice
-        doc._obj_.SetModifiedFlag(False)
-
-        # Must force the module browser to close itself here (OnDestroy for the view itself is too late!)
-        self.sub_splitter = None  # ensure no circles!
-        self.GetBrowserView().DestroyBrowser()
-        return self._obj_.OnClose()
diff --git a/lib/pythonwin/pywin/framework/editor/template.py b/lib/pythonwin/pywin/framework/editor/template.py
deleted file mode 100644
index 362a74a6..00000000
--- a/lib/pythonwin/pywin/framework/editor/template.py
+++ /dev/null
@@ -1,60 +0,0 @@
-import os
-
-import pywin.framework.window
-import win32api
-import win32ui
-from pywin.mfc import docview
-
-from . import frame
-
-ParentEditorTemplate = docview.DocTemplate
-
-
-class EditorTemplateBase(ParentEditorTemplate):
-    def __init__(
-        self, res=win32ui.IDR_TEXTTYPE, makeDoc=None, makeFrame=None, makeView=None
-    ):
-        if makeFrame is None:
-            makeFrame = frame.EditorFrame
-        ParentEditorTemplate.__init__(self, res, makeDoc, makeFrame, makeView)
-
-    def _CreateDocTemplate(self, resourceId):
-        assert 0, "You must override this"
-
-    def CreateWin32uiDocument(self):
-        assert 0, "You must override this"
-
-    def GetFileExtensions(self):
-        return ".txt", ".py"
-
-    def MatchDocType(self, fileName, fileType):
-        doc = self.FindOpenDocument(fileName)
-        if doc:
-            return doc
-        ext = os.path.splitext(fileName)[1].lower()
-        if ext in self.GetFileExtensions():
-            return win32ui.CDocTemplate_Confidence_yesAttemptNative
-        return win32ui.CDocTemplate_Confidence_maybeAttemptForeign
-
-    def InitialUpdateFrame(self, frame, doc, makeVisible=1):
-        self._obj_.InitialUpdateFrame(frame, doc, makeVisible)  # call default handler.
-        doc._UpdateUIForState()
-
-    def GetPythonPropertyPages(self):
-        """Returns a list of property pages"""
-        from . import configui
-
-        return [configui.EditorPropertyPage(), configui.EditorWhitespacePropertyPage()]
-
-    def OpenDocumentFile(self, filename, bMakeVisible=1):
-        if filename is not None:
-            try:
-                path = os.path.split(filename)[0]
-                # 				print "The editor is translating", `filename`,"to",
-                filename = win32api.FindFiles(filename)[0][8]
-                filename = os.path.join(path, filename)
-            # 				print `filename`
-            except (win32api.error, IndexError) as details:
-                pass
-        # 				print "Couldnt get the full filename!", details
-        return self._obj_.OpenDocumentFile(filename, bMakeVisible)
diff --git a/lib/pythonwin/pywin/framework/editor/vss.py b/lib/pythonwin/pywin/framework/editor/vss.py
deleted file mode 100644
index 718f83ee..00000000
--- a/lib/pythonwin/pywin/framework/editor/vss.py
+++ /dev/null
@@ -1,104 +0,0 @@
-# vss.py -- Source Control using Microsoft VSS.
-
-# Provides routines for checking files out of VSS.
-#
-# Uses an INI file very similar to how VB integrates with VSS - even
-# as far as using the same name.
-
-# The file must be named "Mssccprj.scc", and be in the format of
-# an INI file.  This file may be in a parent directory, in which
-# case the project name will be built from what is specified in the
-# ini file, plus the path from the INI file to the file itself.
-#
-# The INI file should have a [Python] section, and a
-# Project=Project Name
-#  and optionally
-# Database=??
-
-
-import os
-import sys
-import traceback
-
-import win32api
-import win32ui
-
-g_iniName = "Mssccprj.scc"  # Use the same INI name as VB!
-
-g_sourceSafe = None
-
-
-def FindVssProjectInfo(fullfname):
-    """Looks up the file system for an INI file describing the project.
-
-    Looking up the tree is for ni style packages.
-
-    Returns (projectName, pathToFileName) where pathToFileName contains
-    the path from the ini file to the actual file.
-    """
-    path, fnameonly = os.path.split(fullfname)
-    origPath = path
-    project = ""
-    retPaths = [fnameonly]
-    while not project:
-        iniName = os.path.join(path, g_iniName)
-        database = win32api.GetProfileVal("Python", "Database", "", iniName)
-        project = win32api.GetProfileVal("Python", "Project", "", iniName)
-        if project:
-            break
-        # No valid INI file in this directory - look up a level.
-        path, addpath = os.path.split(path)
-        if not addpath:  # Root?
-            break
-        retPaths.insert(0, addpath)
-    if not project:
-        win32ui.MessageBox(
-            "%s\r\n\r\nThis directory is not configured for Python/VSS" % origPath
-        )
-        return
-    return project, "/".join(retPaths), database
-
-
-def CheckoutFile(fileName):
-    global g_sourceSafe
-    import pythoncom
-
-    ok = 0
-    # Assumes the fileName has a complete path,
-    # and that the INI file can be found in that path
-    # (or a parent path if a ni style package)
-    try:
-        import win32com.client
-        import win32com.client.gencache
-
-        mod = win32com.client.gencache.EnsureModule(
-            "{783CD4E0-9D54-11CF-B8EE-00608CC9A71F}", 0, 5, 0
-        )
-        if mod is None:
-            win32ui.MessageBox(
-                "VSS does not appear to be installed.  The TypeInfo can not be created"
-            )
-            return ok
-
-        rc = FindVssProjectInfo(fileName)
-        if rc is None:
-            return
-        project, vssFname, database = rc
-        if g_sourceSafe is None:
-            g_sourceSafe = win32com.client.Dispatch("SourceSafe")
-            # SS seems a bit wierd.  It defaults the arguments as empty strings, but
-            # then complains when they are used - so we pass "Missing"
-            if not database:
-                database = pythoncom.Missing
-            g_sourceSafe.Open(database, pythoncom.Missing, pythoncom.Missing)
-        item = g_sourceSafe.VSSItem("$/%s/%s" % (project, vssFname))
-        item.Checkout(None, fileName)
-        ok = 1
-    except pythoncom.com_error as exc:
-        win32ui.MessageBox(exc.strerror, "Error checking out file")
-    except:
-        typ, val, tb = sys.exc_info()
-        traceback.print_exc()
-        win32ui.MessageBox("%s - %s" % (str(typ), str(val)), "Error checking out file")
-        tb = None  # Cleanup a cycle
-    return ok
diff --git a/lib/pythonwin/pywin/framework/help.py b/lib/pythonwin/pywin/framework/help.py
deleted file mode 100644
index ab664b4d..00000000
--- a/lib/pythonwin/pywin/framework/help.py
+++ /dev/null
@@ -1,173 +0,0 @@
-# help.py - help utilities for PythonWin.
-import os
-
-import regutil
-import win32api
-import win32con
-import win32ui
-
-htmlhelp_handle = None
-
-html_help_command_translators = {
-    win32con.HELP_CONTENTS: 1,  # HH_DISPLAY_TOC
-    win32con.HELP_CONTEXT: 15,  # HH_HELP_CONTEXT
-    win32con.HELP_FINDER: 1,  # HH_DISPLAY_TOC
-}
-
-
-def FinalizeHelp():
-    global htmlhelp_handle
-    if htmlhelp_handle is not None:
-        import win32help
-
-        try:
-            # frame = win32ui.GetMainFrame().GetSafeHwnd()
-            frame = 0
-            win32help.HtmlHelp(frame, None, win32help.HH_UNINITIALIZE, htmlhelp_handle)
-        except win32help.error:
-            print("Failed to finalize htmlhelp!")
-        htmlhelp_handle = None
-
-
-def OpenHelpFile(fileName, helpCmd=None, helpArg=None):
-    "Open a help file, given a full path"
-    # default help arg.
-    win32ui.DoWaitCursor(1)
-    try:
-        if helpCmd is None:
-            helpCmd = win32con.HELP_CONTENTS
-        ext = os.path.splitext(fileName)[1].lower()
-        if ext == ".hlp":
-            win32api.WinHelp(
-                win32ui.GetMainFrame().GetSafeHwnd(), fileName, helpCmd, helpArg
-            )
-        # XXX - using the htmlhelp API wreaks havoc with keyboard shortcuts
-        # so we disable it, forcing ShellExecute, which works fine (but
-        # doesn't close the help file when Pythonwin is closed.
-        # Tom Heller also points out http://www.microsoft.com/mind/0499/faq/faq0499.asp,
-        # which may or may not be related.
-        elif 0 and ext == ".chm":
-            import win32help
-
-            global htmlhelp_handle
-            helpCmd = html_help_command_translators.get(helpCmd, helpCmd)
-            # frame = win32ui.GetMainFrame().GetSafeHwnd()
-            frame = 0  # Dont want it overlapping ours!
-            if htmlhelp_handle is None:
-                htmlhelp_hwnd, htmlhelp_handle = win32help.HtmlHelp(
-                    frame, None, win32help.HH_INITIALIZE
-                )
-            win32help.HtmlHelp(frame, fileName, helpCmd, helpArg)
-        else:
-            # Hope that the extension is registered, and we know what to do!
-            win32api.ShellExecute(0, "open", fileName, None, "", win32con.SW_SHOW)
-        return fileName
-    finally:
-        win32ui.DoWaitCursor(-1)
-
-
-def ListAllHelpFiles():
-    ret = []
-    ret = _ListAllHelpFilesInRoot(win32con.HKEY_LOCAL_MACHINE)
-    # Ensure we don't get dups.
-    for item in _ListAllHelpFilesInRoot(win32con.HKEY_CURRENT_USER):
-        if item not in ret:
-            ret.append(item)
-    return ret
-
-
-def _ListAllHelpFilesInRoot(root):
-    """Returns a list of (helpDesc, helpFname) for all registered help files"""
-    import regutil
-
-    retList = []
-    try:
-        key = win32api.RegOpenKey(
-            root, regutil.BuildDefaultPythonKey() + "\\Help", 0, win32con.KEY_READ
-        )
-    except win32api.error as exc:
-        import winerror
-
-        if exc.winerror != winerror.ERROR_FILE_NOT_FOUND:
-            raise
-        return retList
-    try:
-        keyNo = 0
-        while 1:
-            try:
-                helpDesc = win32api.RegEnumKey(key, keyNo)
-                helpFile = win32api.RegQueryValue(key, helpDesc)
-                retList.append((helpDesc, helpFile))
-                keyNo = keyNo + 1
-            except win32api.error as exc:
-                import winerror
-
-                if exc.winerror != winerror.ERROR_NO_MORE_ITEMS:
-                    raise
-                break
-    finally:
-        win32api.RegCloseKey(key)
-    return retList
-
-
-def SelectAndRunHelpFile():
-    from pywin.dialogs import list
-
-    helpFiles = ListAllHelpFiles()
-    if len(helpFiles) == 1:
-        # only 1 help file registered - probably ours - no point asking
-        index = 0
-    else:
-        index = list.SelectFromLists("Select Help file", helpFiles, ["Title"])
-    if index is not None:
-        OpenHelpFile(helpFiles[index][1])
-
-
-helpIDMap = None
-
-
-def SetHelpMenuOtherHelp(mainMenu):
-    """Modifies the main Help Menu to handle all registered help files.
-    mainMenu -- The main menu to modify - usually from docTemplate.GetSharedMenu()
-    """
-
-    # Load all help files from the registry.
-    global helpIDMap
-    if helpIDMap is None:
-        helpIDMap = {}
-        cmdID = win32ui.ID_HELP_OTHER
-        excludeList = ["Main Python Documentation", "Pythonwin Reference"]
-        firstList = ListAllHelpFiles()
-        # We actually want to not only exclude these entries, but
-        # their help file names (as many entries may share the same name)
-        excludeFnames = []
-        for desc, fname in firstList:
-            if desc in excludeList:
-                excludeFnames.append(fname)
-
-        helpDescs = []
-        for desc, fname in firstList:
-            if fname not in excludeFnames:
-                helpIDMap[cmdID] = (desc, fname)
-                win32ui.GetMainFrame().HookCommand(HandleHelpOtherCommand, cmdID)
-                cmdID = cmdID + 1
-
-    helpMenu = mainMenu.GetSubMenu(
-        mainMenu.GetMenuItemCount() - 1
-    )  # Help menu always last.
-    otherHelpMenuPos = 2  # cant search for ID, as sub-menu has no ID.
-    otherMenu = helpMenu.GetSubMenu(otherHelpMenuPos)
-    while otherMenu.GetMenuItemCount():
-        otherMenu.DeleteMenu(0, win32con.MF_BYPOSITION)
-
-    if helpIDMap:
-        for id, (desc, fname) in helpIDMap.items():
-            otherMenu.AppendMenu(win32con.MF_ENABLED | win32con.MF_STRING, id, desc)
-    else:
-        helpMenu.EnableMenuItem(
-            otherHelpMenuPos, win32con.MF_BYPOSITION | win32con.MF_GRAYED
-        )
-
-
-def HandleHelpOtherCommand(cmd, code):
-    OpenHelpFile(helpIDMap[cmd][1])
diff --git a/lib/pythonwin/pywin/framework/interact.py b/lib/pythonwin/pywin/framework/interact.py
deleted file mode 100644
index 5f0b87f2..00000000
--- a/lib/pythonwin/pywin/framework/interact.py
+++ /dev/null
@@ -1,985 +0,0 @@
-##################################################################
-##
-## Interactive Shell Window
-##
-
-import array
-import code
-import os
-import string
-import sys
-import traceback
-
-import __main__
-import afxres
-import pywin.framework.app
-import pywin.scintilla.control
-import pywin.scintilla.formatter
-import pywin.scintilla.IDLEenvironment
-import win32api
-import win32clipboard
-import win32con
-import win32ui
-
-## sequential after ID_GOTO_LINE defined in editor.py
-ID_EDIT_COPY_CODE = 0xE2002
-ID_EDIT_EXEC_CLIPBOARD = 0x2003
-
-trace = pywin.scintilla.formatter.trace
-
-import re
-
-from . import winout
-
-# from IDLE.
-_is_block_opener = re.compile(r":\s*(#.*)?$").search
-_is_block_closer = re.compile(
-    r"""
-    \s*
-    ( return
-    | break
-    | continue
-    | raise
-    | pass
-    )
-    \b
-""",
-    re.VERBOSE,
-).match
-
-tracebackHeader = "Traceback (".encode("ascii")
-
-sectionProfile = "Interactive Window"
-valueFormatTitle = "FormatTitle"
-valueFormatInput = "FormatInput"
-valueFormatOutput = "FormatOutput"
-valueFormatOutputError = "FormatOutputError"
-
-# These are defaults only.  Values are read from the registry.
-formatTitle = (-536870897, 0, 220, 0, 16711680, 184, 34, "Arial")
-formatInput = (-402653169, 0, 200, 0, 0, 0, 49, "Courier New")
-formatOutput = (-402653169, 0, 200, 0, 8421376, 0, 49, "Courier New")
-formatOutputError = (-402653169, 0, 200, 0, 255, 0, 49, "Courier New")
-
-try:
-    sys.ps1
-except AttributeError:
-    sys.ps1 = ">>> "
-    sys.ps2 = "... "
-
-
-def LoadPreference(preference, default=""):
-    return win32ui.GetProfileVal(sectionProfile, preference, default)
-
-
-def SavePreference(prefName, prefValue):
-    win32ui.WriteProfileVal(sectionProfile, prefName, prefValue)
-
-
-def GetPromptPrefix(line):
-    ps1 = sys.ps1
-    if line[: len(ps1)] == ps1:
-        return ps1
-    ps2 = sys.ps2
-    if line[: len(ps2)] == ps2:
-        return ps2
-
-
-#############################################################
-#
-# Colorizer related code.
-#
-#############################################################
-STYLE_INTERACTIVE_EOL = "Interactive EOL"
-STYLE_INTERACTIVE_OUTPUT = "Interactive Output"
-STYLE_INTERACTIVE_PROMPT = "Interactive Prompt"
-STYLE_INTERACTIVE_BANNER = "Interactive Banner"
-STYLE_INTERACTIVE_ERROR = "Interactive Error"
-STYLE_INTERACTIVE_ERROR_FINALLINE = "Interactive Error (final line)"
-
-INTERACTIVE_STYLES = [
-    STYLE_INTERACTIVE_EOL,
-    STYLE_INTERACTIVE_OUTPUT,
-    STYLE_INTERACTIVE_PROMPT,
-    STYLE_INTERACTIVE_BANNER,
-    STYLE_INTERACTIVE_ERROR,
-    STYLE_INTERACTIVE_ERROR_FINALLINE,
-]
-
-FormatterParent = pywin.scintilla.formatter.PythonSourceFormatter
-
-
-class InteractiveFormatter(FormatterParent):
-    def __init__(self, scintilla):
-        FormatterParent.__init__(self, scintilla)
-        self.bannerDisplayed = False
-
-    def SetStyles(self):
-        FormatterParent.SetStyles(self)
-        Style = pywin.scintilla.formatter.Style
-        self.RegisterStyle(Style(STYLE_INTERACTIVE_EOL, STYLE_INTERACTIVE_PROMPT))
-        self.RegisterStyle(Style(STYLE_INTERACTIVE_PROMPT, formatInput))
-        self.RegisterStyle(Style(STYLE_INTERACTIVE_OUTPUT, formatOutput))
-        self.RegisterStyle(Style(STYLE_INTERACTIVE_BANNER, formatTitle))
-        self.RegisterStyle(Style(STYLE_INTERACTIVE_ERROR, formatOutputError))
-        self.RegisterStyle(
-            Style(STYLE_INTERACTIVE_ERROR_FINALLINE, STYLE_INTERACTIVE_ERROR)
-        )
-
-    def LoadPreference(self, name, default):
-        rc = win32ui.GetProfileVal("Format", name, default)
-        if rc == default:
-            rc = win32ui.GetProfileVal(sectionProfile, name, default)
-        return rc
-
-    def ColorizeInteractiveCode(self, cdoc, styleStart, stylePyStart):
-        lengthDoc = len(cdoc)
-        if lengthDoc == 0:
-            return
-        state = styleStart
-        # As per comments in Colorize(), we work with the raw utf8
-        # bytes. To avoid too muych py3k pain, we treat each utf8 byte
-        # as a latin-1 unicode character - we only use it to compare
-        # against ascii chars anyway...
-        chNext = cdoc[0:1].decode("latin-1")
-        startSeg = 0
-        i = 0
-        lastState = state  # debug only
-        while i < lengthDoc:
-            ch = chNext
-            chNext = cdoc[i + 1 : i + 2].decode("latin-1")
-
-            # 			trace("ch=%r, i=%d, next=%r, state=%s" % (ch, i, chNext, state))
-            if state == STYLE_INTERACTIVE_EOL:
-                if ch not in "\r\n":
-                    self.ColorSeg(startSeg, i - 1, state)
-                    startSeg = i
-                    if ch in (sys.ps1[0], sys.ps2[0]):
-                        state = STYLE_INTERACTIVE_PROMPT
-                    elif cdoc[i : i + len(tracebackHeader)] == tracebackHeader:
-                        state = STYLE_INTERACTIVE_ERROR
-                    else:
-                        state = STYLE_INTERACTIVE_OUTPUT
-            elif state == STYLE_INTERACTIVE_PROMPT:
-                if ch not in sys.ps1 + sys.ps2 + " ":
-                    self.ColorSeg(startSeg, i - 1, state)
-                    startSeg = i
-                    if ch in "\r\n":
-                        state = STYLE_INTERACTIVE_EOL
-                    else:
-                        state = stylePyStart  # Start coloring Python code.
-            elif state in (STYLE_INTERACTIVE_OUTPUT,):
-                if ch in "\r\n":
-                    self.ColorSeg(startSeg, i - 1, state)
-                    startSeg = i
-                    state = STYLE_INTERACTIVE_EOL
-            elif state == STYLE_INTERACTIVE_ERROR:
-                if ch in "\r\n" and chNext and chNext not in string.whitespace:
-                    # Everything including me
-                    self.ColorSeg(startSeg, i, state)
-                    startSeg = i + 1
-                    state = STYLE_INTERACTIVE_ERROR_FINALLINE
-                elif i == 0 and ch not in string.whitespace:
-                    # If we are coloring from the start of a line,
-                    # we need this better check for the last line
-                    # Color up to not including me
-                    self.ColorSeg(startSeg, i - 1, state)
-                    startSeg = i
-                    state = STYLE_INTERACTIVE_ERROR_FINALLINE
-            elif state == STYLE_INTERACTIVE_ERROR_FINALLINE:
-                if ch in "\r\n":
-                    self.ColorSeg(startSeg, i - 1, state)
-                    startSeg = i
-                    state = STYLE_INTERACTIVE_EOL
-            elif state == STYLE_INTERACTIVE_BANNER:
-                if ch in "\r\n" and (chNext == "" or chNext in ">["):
-                    # Everything including me
-                    self.ColorSeg(startSeg, i - 1, state)
-                    startSeg = i
-                    state = STYLE_INTERACTIVE_EOL
-            else:
-                # It is a PythonColorizer state - seek past the end of the line
-                # and ask the Python colorizer to color that.
-                end = startSeg
-                while end < lengthDoc and cdoc[end] not in "\r\n".encode("ascii"):
-                    end = end + 1
-                self.ColorizePythonCode(cdoc[:end], startSeg, state)
-                stylePyStart = self.GetStringStyle(end - 1)
-                if stylePyStart is None:
-                    stylePyStart = pywin.scintilla.formatter.STYLE_DEFAULT
-                else:
-                    stylePyStart = stylePyStart.name
-                startSeg = end
-                i = end - 1  # ready for increment.
-                chNext = cdoc[end : end + 1].decode("latin-1")
-                state = STYLE_INTERACTIVE_EOL
-            if lastState != state:
-                lastState = state
-            i = i + 1
-        # and the rest
-        if startSeg < i:
-            self.ColorSeg(startSeg, i - 1, state)
-
-    def Colorize(self, start=0, end=-1):
-        # scintilla's formatting is all done in terms of utf, so
-        # we work with utf8 bytes instead of unicode.  This magically
-        # works as any extended chars found in the utf8 don't change
-        # the semantics.
-        stringVal = self.scintilla.GetTextRange(start, end, decode=False)
-        styleStart = None
-        stylePyStart = None
-        if start > 1:
-            # Likely we are being asked to color from the start of the line.
-            # We find the last formatted character on the previous line.
-            # If TQString, we continue it.  Otherwise, we reset.
-            look = start - 1
-            while look and self.scintilla.SCIGetCharAt(look) in "\n\r":
-                look = look - 1
-            if look and look < start - 1:  # Did we find a char before the \n\r sets?
-                strstyle = self.GetStringStyle(look)
-                quote_char = None
-                if strstyle is not None:
-                    if strstyle.name == pywin.scintilla.formatter.STYLE_TQSSTRING:
-                        quote_char = "'"
-                    elif strstyle.name == pywin.scintilla.formatter.STYLE_TQDSTRING:
-                        quote_char = '"'
-                    if quote_char is not None:
-                        # It is a TQS.  If the TQS is not terminated, we
-                        # carry the style through.
-                        if look > 2:
-                            look_str = (
-                                self.scintilla.SCIGetCharAt(look - 2)
-                                + self.scintilla.SCIGetCharAt(look - 1)
-                                + self.scintilla.SCIGetCharAt(look)
-                            )
-                            if look_str != quote_char * 3:
-                                stylePyStart = strstyle.name
-        if stylePyStart is None:
-            stylePyStart = pywin.scintilla.formatter.STYLE_DEFAULT
-
-        if start > 0:
-            stylenum = self.scintilla.SCIGetStyleAt(start - 1)
-            styleStart = self.GetStyleByNum(stylenum).name
-        elif self.bannerDisplayed:
-            styleStart = STYLE_INTERACTIVE_EOL
-        else:
-            styleStart = STYLE_INTERACTIVE_BANNER
-            self.bannerDisplayed = True
-        self.scintilla.SCIStartStyling(start, 31)
-        self.style_buffer = array.array("b", (0,) * len(stringVal))
-        self.ColorizeInteractiveCode(stringVal, styleStart, stylePyStart)
-        self.scintilla.SCISetStylingEx(self.style_buffer)
-        self.style_buffer = None
-
-
-###############################################################
-#
-# This class handles the Python interactive interpreter.
-#
-# It uses a basic EditWindow, and does all the magic.
-# This is triggered by the enter key hander attached by the
-# start-up code.  It determines if a command is to be executed
-# or continued (ie, emit "... ") by snooping around the current
-# line, looking for the prompts
-#
-class PythonwinInteractiveInterpreter(code.InteractiveInterpreter):
-    def __init__(self, locals=None, globals=None):
-        if locals is None:
-            locals = __main__.__dict__
-        if globals is None:
-            globals = locals
-        self.globals = globals
-        code.InteractiveInterpreter.__init__(self, locals)
-
-    def showsyntaxerror(self, filename=None):
-        sys.stderr.write(
-            tracebackHeader.decode("ascii")
-        )  # So the color syntaxer recognises it.
-        code.InteractiveInterpreter.showsyntaxerror(self, filename)
-
-    def runcode(self, code):
-        try:
-            exec(code, self.globals, self.locals)
-        except SystemExit:
-            raise
-        except:
-            self.showtraceback()
-
-
-class InteractiveCore:
-    def __init__(self, banner=None):
-        self.banner = banner
-
-    # 		LoadFontPreferences()
-    def Init(self):
-        self.oldStdOut = self.oldStdErr = None
-
-        # 		self.SetWordWrap(win32ui.CRichEditView_WrapNone)
-        self.interp = PythonwinInteractiveInterpreter()
-
-        self.OutputGrab()  # Release at cleanup.
-
-        if self.GetTextLength() == 0:
-            if self.banner is None:
-                suffix = ""
-                if win32ui.debug:
-                    suffix = ", debug build"
-                sys.stderr.write(
-                    "PythonWin %s on %s%s.\n" % (sys.version, sys.platform, suffix)
-                )
-                sys.stderr.write(
-                    "Portions %s - see 'Help/About PythonWin' for further copyright information.\n"
-                    % (win32ui.copyright,)
-                )
-            else:
-                sys.stderr.write(banner)
-        rcfile = os.environ.get("PYTHONSTARTUP")
-        if rcfile:
-            import __main__
-
-            try:
-                exec(
-                    compile(
-                        open(rcfile, "rb").read(), rcfile, "exec", dont_inherit=True
-                    ),
-                    __main__.__dict__,
-                    __main__.__dict__,
-                )
-            except:
-                sys.stderr.write(
-                    ">>> \nError executing PYTHONSTARTUP script %r\n" % (rcfile)
-                )
-                traceback.print_exc(file=sys.stderr)
-        self.AppendToPrompt([])
-
-    def SetContext(self, globals, locals, name="Dbg"):
-        oldPrompt = sys.ps1
-        if globals is None:
-            # Reset
-            sys.ps1 = ">>> "
-            sys.ps2 = "... "
-            locals = globals = __main__.__dict__
-        else:
-            sys.ps1 = "[%s]>>> " % name
-            sys.ps2 = "[%s]... " % name
-        self.interp.locals = locals
-        self.interp.globals = globals
-        self.AppendToPrompt([], oldPrompt)
-
-    def GetContext(self):
-        return self.interp.globals, self.interp.locals
-
-    def DoGetLine(self, line=-1):
-        if line == -1:
-            line = self.LineFromChar()
-        line = self.GetLine(line)
-        while line and line[-1] in ("\r", "\n"):
-            line = line[:-1]
-        return line
-
-    def AppendToPrompt(self, bufLines, oldPrompt=None):
-        "Take a command and stick it at the end of the buffer (with python prompts inserted if required)."
-        self.flush()
-        lastLineNo = self.GetLineCount() - 1
-        line = self.DoGetLine(lastLineNo)
-        if oldPrompt and line == oldPrompt:
-            self.SetSel(self.GetTextLength() - len(oldPrompt), self.GetTextLength())
-            self.ReplaceSel(sys.ps1)
-        elif line != str(sys.ps1):
-            if len(line) != 0:
-                self.write("\n")
-            self.write(sys.ps1)
-        self.flush()
-        self.idle.text.mark_set("iomark", "end-1c")
-        if not bufLines:
-            return
-        terms = (["\n" + sys.ps2] * (len(bufLines) - 1)) + [""]
-        for bufLine, term in zip(bufLines, terms):
-            if bufLine.strip():
-                self.write(bufLine + term)
-        self.flush()
-
-    def EnsureNoPrompt(self):
-        # Get ready to write some text NOT at a Python prompt.
-        self.flush()
-        lastLineNo = self.GetLineCount() - 1
-        line = self.DoGetLine(lastLineNo)
-        if not line or line in (sys.ps1, sys.ps2):
-            self.SetSel(self.GetTextLength() - len(line), self.GetTextLength())
-            self.ReplaceSel("")
-        else:
-            # Just add a new line.
-            self.write("\n")
-
-    def _GetSubConfigNames(self):
-        return ["interactive"]  # Allow [Keys:Interactive] sections to be specific
-
-    def HookHandlers(self):
-        # Hook menu command (executed when a menu item with that ID is selected from a menu/toolbar
-        self.HookCommand(self.OnSelectBlock, win32ui.ID_EDIT_SELECT_BLOCK)
-        self.HookCommand(self.OnEditCopyCode, ID_EDIT_COPY_CODE)
-        self.HookCommand(self.OnEditExecClipboard, ID_EDIT_EXEC_CLIPBOARD)
-        mod = pywin.scintilla.IDLEenvironment.GetIDLEModule("IdleHistory")
-        if mod is not None:
-            self.history = mod.History(self.idle.text, "\n" + sys.ps2)
-        else:
-            self.history = None
-        # hack for now for event handling.
-
-    # GetBlockBoundary takes a line number, and will return the
-    # start and and line numbers of the block, and a flag indicating if the
-    # block is a Python code block.
-    # If the line specified has a Python prompt, then the lines are parsed
-    # backwards and forwards, and the flag is true.
-    # If the line does not start with a prompt, the block is searched forward
-    # and backward until a prompt _is_ found, and all lines in between without
-    # prompts are returned, and the flag is false.
-    def GetBlockBoundary(self, lineNo):
-        line = self.DoGetLine(lineNo)
-        maxLineNo = self.GetLineCount() - 1
-        prefix = GetPromptPrefix(line)
-        if prefix is None:  # Non code block
-            flag = 0
-            startLineNo = lineNo
-            while startLineNo > 0:
-                if GetPromptPrefix(self.DoGetLine(startLineNo - 1)) is not None:
-                    break  # there _is_ a prompt
-                startLineNo = startLineNo - 1
-            endLineNo = lineNo
-            while endLineNo < maxLineNo:
-                if GetPromptPrefix(self.DoGetLine(endLineNo + 1)) is not None:
-                    break  # there _is_ a prompt
-                endLineNo = endLineNo + 1
-        else:  # Code block
-            flag = 1
-            startLineNo = lineNo
-            while startLineNo > 0 and prefix != str(sys.ps1):
-                prefix = GetPromptPrefix(self.DoGetLine(startLineNo - 1))
-                if prefix is None:
-                    break
-                    # there is no prompt.
-                startLineNo = startLineNo - 1
-            endLineNo = lineNo
-            while endLineNo < maxLineNo:
-                prefix = GetPromptPrefix(self.DoGetLine(endLineNo + 1))
-                if prefix is None:
-                    break  # there is no prompt
-                if prefix == str(sys.ps1):
-                    break  # this is another command
-                endLineNo = endLineNo + 1
-                # continue until end of buffer, or no prompt
-        return (startLineNo, endLineNo, flag)
-
-    def ExtractCommand(self, lines):
-        start, end = lines
-        retList = []
-        while end >= start:
-            thisLine = self.DoGetLine(end)
-            promptLen = len(GetPromptPrefix(thisLine))
-            retList = [thisLine[promptLen:]] + retList
-            end = end - 1
-        return retList
-
-    def OutputGrab(self):
-        # 		import win32traceutil; return
-        self.oldStdOut = sys.stdout
-        self.oldStdErr = sys.stderr
-        sys.stdout = self
-        sys.stderr = self
-        self.flush()
-
-    def OutputRelease(self):
-        # a command may have overwritten these - only restore if not.
-        if self.oldStdOut is not None:
-            if sys.stdout == self:
-                sys.stdout = self.oldStdOut
-        if self.oldStdErr is not None:
-            if sys.stderr == self:
-                sys.stderr = self.oldStdErr
-        self.oldStdOut = None
-        self.oldStdErr = None
-        self.flush()
-
-    ###################################
-    #
-    # Message/Command/Key Hooks.
-    #
-    # Enter key handler
-    #
-    def ProcessEnterEvent(self, event):
-        # If autocompletion has been triggered, complete and do not process event
-        if self.SCIAutoCActive():
-            self.SCIAutoCComplete()
-            self.SCICancel()
-            return
-
-        self.SCICancel()
-        # First, check for an error message
-        haveGrabbedOutput = 0
-        if self.HandleSpecialLine():
-            return 0
-
-        lineNo = self.LineFromChar()
-        start, end, isCode = self.GetBlockBoundary(lineNo)
-        # If we are not in a code block just go to the prompt (or create a new one)
-        if not isCode:
-            self.AppendToPrompt([])
-            win32ui.SetStatusText(win32ui.LoadString(afxres.AFX_IDS_IDLEMESSAGE))
-            return
-
-        lines = self.ExtractCommand((start, end))
-
-        # If we are in a code-block, but it isnt at the end of the buffer
-        # then copy it to the end ready for editing and subsequent execution
-        if end != self.GetLineCount() - 1:
-            win32ui.SetStatusText("Press ENTER to execute command")
-            self.AppendToPrompt(lines)
-            self.SetSel(-2)
-            return
-
-        # If SHIFT held down, we want new code here and now!
-        bNeedIndent = (
-            win32api.GetKeyState(win32con.VK_SHIFT) < 0
-            or win32api.GetKeyState(win32con.VK_CONTROL) < 0
-        )
-        if bNeedIndent:
-            self.ReplaceSel("\n")
-        else:
-            self.SetSel(-2)
-            self.ReplaceSel("\n")
-            source = "\n".join(lines)
-            while source and source[-1] in "\t ":
-                source = source[:-1]
-            self.OutputGrab()  # grab the output for the command exec.
-            try:
-                if self.interp.runsource(
-                    source, "<interactive input>"
-                ):  # Need more input!
-                    bNeedIndent = 1
-                else:
-                    # If the last line isnt empty, append a newline
-                    if self.history is not None:
-                        self.history.history_store(source)
-                    self.AppendToPrompt([])
-                    win32ui.SetStatusText(
-                        win32ui.LoadString(afxres.AFX_IDS_IDLEMESSAGE)
-                    )
-            # 					win32ui.SetStatusText('Successfully executed statement')
-            finally:
-                self.OutputRelease()
-        if bNeedIndent:
-            win32ui.SetStatusText("Ready to continue the command")
-            # Now attempt correct indentation (should use IDLE?)
-            curLine = self.DoGetLine(lineNo)[len(sys.ps2) :]
-            pos = 0
-            indent = ""
-            while len(curLine) > pos and curLine[pos] in string.whitespace:
-                indent = indent + curLine[pos]
-                pos = pos + 1
-            if _is_block_opener(curLine):
-                indent = indent + "\t"
-            elif _is_block_closer(curLine):
-                indent = indent[:-1]
-            # use ReplaceSel to ensure it goes at the cursor rather than end of buffer.
-            self.ReplaceSel(sys.ps2 + indent)
-        return 0
-
-    # ESC key handler
-    def ProcessEscEvent(self, event):
-        # Implement a cancel.
-        if self.SCIAutoCActive() or self.SCICallTipActive():
-            self.SCICancel()
-        else:
-            win32ui.SetStatusText("Cancelled.")
-            self.AppendToPrompt(("",))
-        return 0
-
-    def OnSelectBlock(self, command, code):
-        lineNo = self.LineFromChar()
-        start, end, isCode = self.GetBlockBoundary(lineNo)
-        startIndex = self.LineIndex(start)
-        endIndex = self.LineIndex(end + 1) - 2  # skip \r + \n
-        if endIndex < 0:  # must be beyond end of buffer
-            endIndex = -2  # self.Length()
-        self.SetSel(startIndex, endIndex)
-
-    def OnEditCopyCode(self, command, code):
-        """Sanitizes code from interactive window, removing prompts and output,
-        and inserts it in the clipboard."""
-        code = self.GetSelText()
-        lines = code.splitlines()
-        out_lines = []
-        for line in lines:
-            if line.startswith(sys.ps1):
-                line = line[len(sys.ps1) :]
-                out_lines.append(line)
-            elif line.startswith(sys.ps2):
-                line = line[len(sys.ps2) :]
-                out_lines.append(line)
-        out_code = os.linesep.join(out_lines)
-        win32clipboard.OpenClipboard()
-        try:
-            win32clipboard.SetClipboardData(
-                win32clipboard.CF_UNICODETEXT, str(out_code)
-            )
-        finally:
-            win32clipboard.CloseClipboard()
-
-    def OnEditExecClipboard(self, command, code):
-        """Executes python code directly from the clipboard."""
-        win32clipboard.OpenClipboard()
-        try:
-            code = win32clipboard.GetClipboardData(win32clipboard.CF_UNICODETEXT)
-        finally:
-            win32clipboard.CloseClipboard()
-
-        code = code.replace("\r\n", "\n") + "\n"
-        try:
-            o = compile(code, "<clipboard>", "exec")
-            exec(o, __main__.__dict__)
-        except:
-            traceback.print_exc()
-
-    def GetRightMenuItems(self):
-        # Just override parents
-        ret = []
-        flags = 0
-        ret.append((flags, win32ui.ID_EDIT_UNDO, "&Undo"))
-        ret.append(win32con.MF_SEPARATOR)
-        ret.append((flags, win32ui.ID_EDIT_CUT, "Cu&t"))
-        ret.append((flags, win32ui.ID_EDIT_COPY, "&Copy"))
-
-        start, end = self.GetSel()
-        if start != end:
-            ret.append((flags, ID_EDIT_COPY_CODE, "Copy code without prompts"))
-        if win32clipboard.IsClipboardFormatAvailable(win32clipboard.CF_UNICODETEXT):
-            ret.append(
-                (flags, ID_EDIT_EXEC_CLIPBOARD, "Execute python code from clipboard")
-            )
-
-        ret.append((flags, win32ui.ID_EDIT_PASTE, "&Paste"))
-        ret.append(win32con.MF_SEPARATOR)
-        ret.append((flags, win32ui.ID_EDIT_SELECT_ALL, "&Select all"))
-        ret.append((flags, win32ui.ID_EDIT_SELECT_BLOCK, "Select &block"))
-        ret.append((flags, win32ui.ID_VIEW_WHITESPACE, "View &Whitespace"))
-        return ret
-
-    def MDINextEvent(self, event):
-        win32ui.GetMainFrame().MDINext(0)
-
-    def MDIPrevEvent(self, event):
-        win32ui.GetMainFrame().MDINext(0)
-
-    def WindowBackEvent(self, event):
-        parent = self.GetParentFrame()
-        if parent == win32ui.GetMainFrame():
-            # It is docked.
-            try:
-                wnd, isactive = parent.MDIGetActive()
-                wnd.SetFocus()
-            except win32ui.error:
-                # No MDI window active!
-                pass
-        else:
-            # Normal Window
-            try:
-                lastActive = self.GetParentFrame().lastActive
-                # If the window is invalid, reset it.
-                if lastActive is not None and (
-                    lastActive._obj_ is None or lastActive.GetSafeHwnd() == 0
-                ):
-                    lastActive = self.GetParentFrame().lastActive = None
-                    win32ui.SetStatusText("The last active Window has been closed.")
-            except AttributeError:
-                print("Can't find the last active window!")
-                lastActive = None
-            if lastActive is not None:
-                lastActive.MDIActivate()
-
-
-class InteractiveView(InteractiveCore, winout.WindowOutputView):
-    def __init__(self, doc):
-        InteractiveCore.__init__(self)
-        winout.WindowOutputView.__init__(self, doc)
-        self.encoding = pywin.default_scintilla_encoding
-
-    def _MakeColorizer(self):
-        return InteractiveFormatter(self)
-
-    def OnInitialUpdate(self):
-        winout.WindowOutputView.OnInitialUpdate(self)
-        self.SetWordWrap()
-        self.Init()
-
-    def HookHandlers(self):
-        winout.WindowOutputView.HookHandlers(self)
-        InteractiveCore.HookHandlers(self)
-
-
-class CInteractivePython(winout.WindowOutput):
-    def __init__(self, makeDoc=None, makeFrame=None):
-        self.IsFinalDestroy = 0
-        winout.WindowOutput.__init__(
-            self,
-            sectionProfile,
-            sectionProfile,
-            winout.flags.WQ_LINE,
-            1,
-            None,
-            makeDoc,
-            makeFrame,
-            InteractiveView,
-        )
-        self.Create()
-
-    def OnViewDestroy(self, view):
-        if self.IsFinalDestroy:
-            view.OutputRelease()
-        winout.WindowOutput.OnViewDestroy(self, view)
-
-    def Close(self):
-        self.IsFinalDestroy = 1
-        winout.WindowOutput.Close(self)
-
-
-class InteractiveFrame(winout.WindowOutputFrame):
-    def __init__(self):
-        self.lastActive = None
-        winout.WindowOutputFrame.__init__(self)
-
-    def OnMDIActivate(self, bActive, wndActive, wndDeactive):
-        if bActive:
-            self.lastActive = wndDeactive
-
-
-######################################################################
-##
-## Dockable Window Support
-##
-######################################################################
-ID_DOCKED_INTERACTIVE_CONTROLBAR = 0xE802
-
-DockedInteractiveViewParent = InteractiveView
-
-
-class DockedInteractiveView(DockedInteractiveViewParent):
-    def HookHandlers(self):
-        DockedInteractiveViewParent.HookHandlers(self)
-        self.HookMessage(self.OnSetFocus, win32con.WM_SETFOCUS)
-        self.HookMessage(self.OnKillFocus, win32con.WM_KILLFOCUS)
-
-    def OnSetFocus(self, msg):
-        self.GetParentFrame().SetActiveView(self)
-        return 1
-
-    def OnKillFocus(self, msg):
-        # If we are losing focus to another in this app, reset the main frame's active view.
-        hwnd = wparam = msg[2]
-        try:
-            wnd = win32ui.CreateWindowFromHandle(hwnd)
-            reset = wnd.GetTopLevelFrame() == self.GetTopLevelFrame()
-        except win32ui.error:
-            reset = 0  # Not my window
-        if reset:
-            self.GetParentFrame().SetActiveView(None)
-        return 1
-
-    def OnDestroy(self, msg):
-        newSize = self.GetWindowPlacement()[4]
-        pywin.framework.app.SaveWindowSize("Interactive Window", newSize, "docked")
-        try:
-            if self.GetParentFrame().GetActiveView == self:
-                self.GetParentFrame().SetActiveView(None)
-        except win32ui.error:
-            pass
-        try:
-            if win32ui.GetMainFrame().GetActiveView() == self:
-                win32ui.GetMainFrame().SetActiveView(None)
-        except win32ui.error:
-            pass
-        return DockedInteractiveViewParent.OnDestroy(self, msg)
-
-
-class CDockedInteractivePython(CInteractivePython):
-    def __init__(self, dockbar):
-        self.bFirstCreated = 0
-        self.dockbar = dockbar
-        CInteractivePython.__init__(self)
-
-    def NeedRecreateWindow(self):
-        if self.bCreating:
-            return 0
-        try:
-            frame = win32ui.GetMainFrame()
-            if frame.closing:
-                return 0  # Dieing!
-        except (win32ui.error, AttributeError):
-            return 0  # The app is dieing!
-        try:
-            cb = frame.GetControlBar(ID_DOCKED_INTERACTIVE_CONTROLBAR)
-            return not cb.IsWindowVisible()
-        except win32ui.error:
-            return 1  # Control bar does not exist!
-
-    def RecreateWindow(self):
-        try:
-            dockbar = win32ui.GetMainFrame().GetControlBar(
-                ID_DOCKED_INTERACTIVE_CONTROLBAR
-            )
-            win32ui.GetMainFrame().ShowControlBar(dockbar, 1, 1)
-        except win32ui.error:
-            CreateDockedInteractiveWindow()
-
-    def Create(self):
-        self.bCreating = 1
-        doc = InteractiveDocument(None, self.DoCreateDoc())
-        view = DockedInteractiveView(doc)
-        defRect = pywin.framework.app.LoadWindowSize("Interactive Window", "docked")
-        if defRect[2] - defRect[0] == 0:
-            defRect = 0, 0, 500, 200
-        style = win32con.WS_CHILD | win32con.WS_VISIBLE | win32con.WS_BORDER
-        id = 1050  # win32ui.AFX_IDW_PANE_FIRST
-        view.CreateWindow(self.dockbar, id, style, defRect)
-        view.OnInitialUpdate()
-        self.bFirstCreated = 1
-
-        self.currentView = doc.GetFirstView()
-        self.bCreating = 0
-        if self.title:
-            doc.SetTitle(self.title)
-
-
-# The factory we pass to the dockable window support.
-def InteractiveViewCreator(parent):
-    global edit
-    edit = CDockedInteractivePython(parent)
-    return edit.currentView
-
-
-def CreateDockedInteractiveWindow():
-    # Later, the DockingBar should be capable of hosting multiple
-    # children.
-    from pywin.docking.DockingBar import DockingBar
-
-    bar = DockingBar()
-    creator = InteractiveViewCreator
-    bar.CreateWindow(
-        win32ui.GetMainFrame(),
-        creator,
-        "Interactive Window",
-        ID_DOCKED_INTERACTIVE_CONTROLBAR,
-    )
-    bar.SetBarStyle(
-        bar.GetBarStyle()
-        | afxres.CBRS_TOOLTIPS
-        | afxres.CBRS_FLYBY
-        | afxres.CBRS_SIZE_DYNAMIC
-    )
-    bar.EnableDocking(afxres.CBRS_ALIGN_ANY)
-    win32ui.GetMainFrame().DockControlBar(bar, afxres.AFX_IDW_DOCKBAR_BOTTOM)
-
-
-######################################################################
-#
-# The public interface to this module.
-#
-######################################################################
-# No extra functionality now, but maybe later, so
-# publicize these names.
-InteractiveDocument = winout.WindowOutputDocument
-
-# We remember our one and only interactive window in the "edit" variable.
-edit = None
-
-
-def CreateInteractiveWindowUserPreference(makeDoc=None, makeFrame=None):
-    """Create some sort of interactive window if the user's preference say we should."""
-    bCreate = LoadPreference("Show at startup", 1)
-    if bCreate:
-        CreateInteractiveWindow(makeDoc, makeFrame)
-
-
-def CreateInteractiveWindow(makeDoc=None, makeFrame=None):
-    """Create a standard or docked interactive window unconditionally"""
-    assert edit is None, "Creating second interactive window!"
-    bDocking = LoadPreference("Docking", 0)
-    if bDocking:
-        CreateDockedInteractiveWindow()
-    else:
-        CreateMDIInteractiveWindow(makeDoc, makeFrame)
-    assert edit is not None, "Created interactive window, but did not set the global!"
-    edit.currentView.SetFocus()
-
-
-def CreateMDIInteractiveWindow(makeDoc=None, makeFrame=None):
-    """Create a standard (non-docked) interactive window unconditionally"""
-    global edit
-    if makeDoc is None:
-        makeDoc = InteractiveDocument
-    if makeFrame is None:
-        makeFrame = InteractiveFrame
-    edit = CInteractivePython(makeDoc=makeDoc, makeFrame=makeFrame)
-
-
-def DestroyInteractiveWindow():
-    """Destroy the interactive window.
-    This is different to Closing the window,
-    which may automatically re-appear.  Once destroyed, it can never be recreated,
-    and a complete new instance must be created (which the various other helper
-    functions will then do after making this call
-    """
-    global edit
-    if edit is not None and edit.currentView is not None:
-        if edit.currentView.GetParentFrame() == win32ui.GetMainFrame():
-            # It is docked - do nothing now (this is only called at shutdown!)
-            pass
-        else:
-            # It is a standard window - call Close on the container.
-            edit.Close()
-            edit = None
-
-
-def CloseInteractiveWindow():
-    """Close the interactive window, allowing it to be re-created on demand."""
-    global edit
-    if edit is not None and edit.currentView is not None:
-        if edit.currentView.GetParentFrame() == win32ui.GetMainFrame():
-            # It is docked, just hide the dock bar.
-            frame = win32ui.GetMainFrame()
-            cb = frame.GetControlBar(ID_DOCKED_INTERACTIVE_CONTROLBAR)
-            frame.ShowControlBar(cb, 0, 1)
-        else:
-            # It is a standard window - destroy the frame/view, allowing the object itself to remain.
-            edit.currentView.GetParentFrame().DestroyWindow()
-
-
-def ToggleInteractiveWindow():
-    """If the interactive window is visible, hide it, otherwise show it."""
-    if edit is None:
-        CreateInteractiveWindow()
-    else:
-        if edit.NeedRecreateWindow():
-            edit.RecreateWindow()
-        else:
-            # Close it, allowing a reopen.
-            CloseInteractiveWindow()
-
-
-def ShowInteractiveWindow():
-    """Shows (or creates if necessary) an interactive window"""
-    if edit is None:
-        CreateInteractiveWindow()
-    else:
-        if edit.NeedRecreateWindow():
-            edit.RecreateWindow()
-        else:
-            parent = edit.currentView.GetParentFrame()
-            if parent == win32ui.GetMainFrame():  # It is docked.
-                edit.currentView.SetFocus()
-            else:  # It is a "normal" window
-                edit.currentView.GetParentFrame().AutoRestore()
-                win32ui.GetMainFrame().MDIActivate(edit.currentView.GetParentFrame())
-
-
-def IsInteractiveWindowVisible():
-    return edit is not None and not edit.NeedRecreateWindow()
diff --git a/lib/pythonwin/pywin/framework/intpyapp.py b/lib/pythonwin/pywin/framework/intpyapp.py
deleted file mode 100644
index 48461dba..00000000
--- a/lib/pythonwin/pywin/framework/intpyapp.py
+++ /dev/null
@@ -1,555 +0,0 @@
-# intpyapp.py  - Interactive Python application class
-#
-import os
-import sys
-import traceback
-
-import __main__
-import commctrl
-import win32api
-import win32con
-import win32ui
-from pywin.mfc import afxres, dialog
-
-from . import app, dbgcommands
-
-lastLocateFileName = ".py"  # used in the "File/Locate" dialog...
-
-
-# todo - _SetupSharedMenu should be moved to a framework class.
-def _SetupSharedMenu_(self):
-    sharedMenu = self.GetSharedMenu()
-    from pywin.framework import toolmenu
-
-    toolmenu.SetToolsMenu(sharedMenu)
-    from pywin.framework import help
-
-    help.SetHelpMenuOtherHelp(sharedMenu)
-
-
-from pywin.mfc import docview
-
-docview.DocTemplate._SetupSharedMenu_ = _SetupSharedMenu_
-
-
-class MainFrame(app.MainFrame):
-    def OnCreate(self, createStruct):
-        self.closing = 0
-        if app.MainFrame.OnCreate(self, createStruct) == -1:
-            return -1
-        style = (
-            win32con.WS_CHILD
-            | afxres.CBRS_SIZE_DYNAMIC
-            | afxres.CBRS_TOP
-            | afxres.CBRS_TOOLTIPS
-            | afxres.CBRS_FLYBY
-        )
-
-        self.EnableDocking(afxres.CBRS_ALIGN_ANY)
-
-        tb = win32ui.CreateToolBar(self, style | win32con.WS_VISIBLE)
-        tb.ModifyStyle(0, commctrl.TBSTYLE_FLAT)
-        tb.LoadToolBar(win32ui.IDR_MAINFRAME)
-        tb.EnableDocking(afxres.CBRS_ALIGN_ANY)
-        tb.SetWindowText("Standard")
-        self.DockControlBar(tb)
-        # Any other packages which use toolbars
-        from pywin.debugger.debugger import PrepareControlBars
-
-        PrepareControlBars(self)
-        # Note "interact" also uses dockable windows, but they already happen
-
-        # And a "Tools" menu on the main frame.
-        menu = self.GetMenu()
-        from . import toolmenu
-
-        toolmenu.SetToolsMenu(menu, 2)
-        # And fix the "Help" menu on the main frame
-        from pywin.framework import help
-
-        help.SetHelpMenuOtherHelp(menu)
-
-    def OnClose(self):
-        try:
-            import pywin.debugger
-
-            if (
-                pywin.debugger.currentDebugger is not None
-                and pywin.debugger.currentDebugger.pumping
-            ):
-                try:
-                    pywin.debugger.currentDebugger.close(1)
-                except:
-                    traceback.print_exc()
-                return
-        except win32ui.error:
-            pass
-        self.closing = 1
-        self.SaveBarState("ToolbarDefault")
-        self.SetActiveView(None)  # Otherwise MFC's OnClose may _not_ prompt for save.
-
-        from pywin.framework import help
-
-        help.FinalizeHelp()
-
-        self.DestroyControlBar(afxres.AFX_IDW_TOOLBAR)
-        self.DestroyControlBar(win32ui.ID_VIEW_TOOLBAR_DBG)
-
-        return self._obj_.OnClose()
-
-    def DestroyControlBar(self, id):
-        try:
-            bar = self.GetControlBar(id)
-        except win32ui.error:
-            return
-        bar.DestroyWindow()
-
-    def OnCommand(self, wparam, lparam):
-        # By default, the current MDI child frame will process WM_COMMAND
-        # messages before any docked control bars - even if the control bar
-        # has focus.  This is a problem for the interactive window when docked.
-        # Therefore, we detect the situation of a view having the main frame
-        # as its parent, and assume it must be a docked view (which it will in an MDI app)
-        try:
-            v = (
-                self.GetActiveView()
-            )  # Raise an exception if none - good - then we want default handling
-            # Main frame _does_ have a current view (ie, a docking view) - see if it wants it.
-            if v.OnCommand(wparam, lparam):
-                return 1
-        except (win32ui.error, AttributeError):
-            pass
-        return self._obj_.OnCommand(wparam, lparam)
-
-
-class InteractivePythonApp(app.CApp):
-    # This works if necessary - just we dont need to override the Run method.
-    # 	def Run(self):
-    # 		return self._obj_.Run()
-
-    def HookCommands(self):
-        app.CApp.HookCommands(self)
-        dbgcommands.DebuggerCommandHandler().HookCommands()
-        self.HookCommand(self.OnViewBrowse, win32ui.ID_VIEW_BROWSE)
-        self.HookCommand(self.OnFileImport, win32ui.ID_FILE_IMPORT)
-        self.HookCommand(self.OnFileCheck, win32ui.ID_FILE_CHECK)
-        self.HookCommandUpdate(self.OnUpdateFileCheck, win32ui.ID_FILE_CHECK)
-        self.HookCommand(self.OnFileRun, win32ui.ID_FILE_RUN)
-        self.HookCommand(self.OnFileLocate, win32ui.ID_FILE_LOCATE)
-        self.HookCommand(self.OnInteractiveWindow, win32ui.ID_VIEW_INTERACTIVE)
-        self.HookCommandUpdate(
-            self.OnUpdateInteractiveWindow, win32ui.ID_VIEW_INTERACTIVE
-        )
-        self.HookCommand(self.OnViewOptions, win32ui.ID_VIEW_OPTIONS)
-        self.HookCommand(self.OnHelpIndex, afxres.ID_HELP_INDEX)
-        self.HookCommand(self.OnFileSaveAll, win32ui.ID_FILE_SAVE_ALL)
-        self.HookCommand(self.OnViewToolbarDbg, win32ui.ID_VIEW_TOOLBAR_DBG)
-        self.HookCommandUpdate(self.OnUpdateViewToolbarDbg, win32ui.ID_VIEW_TOOLBAR_DBG)
-
-    def CreateMainFrame(self):
-        return MainFrame()
-
-    def MakeExistingDDEConnection(self):
-        # Use DDE to connect to an existing instance
-        # Return None if no existing instance
-        try:
-            from . import intpydde
-        except ImportError:
-            # No dde support!
-            return None
-        conv = intpydde.CreateConversation(self.ddeServer)
-        try:
-            conv.ConnectTo("Pythonwin", "System")
-            return conv
-        except intpydde.error:
-            return None
-
-    def InitDDE(self):
-        # Do all the magic DDE handling.
-        # Returns TRUE if we have pumped the arguments to our
-        # remote DDE app, and we should terminate.
-        try:
-            from . import intpydde
-        except ImportError:
-            self.ddeServer = None
-            intpydde = None
-        if intpydde is not None:
-            self.ddeServer = intpydde.DDEServer(self)
-            self.ddeServer.Create("Pythonwin", intpydde.CBF_FAIL_SELFCONNECTIONS)
-            try:
-                # If there is an existing instance, pump the arguments to it.
-                connection = self.MakeExistingDDEConnection()
-                if connection is not None:
-                    connection.Exec("self.Activate()")
-                    if self.ProcessArgs(sys.argv, connection) is None:
-                        return 1
-            except:
-                # It is too early to 'print' an exception - we
-                # don't have stdout setup yet!
-                win32ui.DisplayTraceback(
-                    sys.exc_info(), " - error in DDE conversation with Pythonwin"
-                )
-                return 1
-
-    def InitInstance(self):
-        # Allow "/nodde" and "/new" to optimize this!
-        if (
-            "/nodde" not in sys.argv
-            and "/new" not in sys.argv
-            and "-nodde" not in sys.argv
-            and "-new" not in sys.argv
-        ):
-            if self.InitDDE():
-                return 1  # A remote DDE client is doing it for us!
-        else:
-            self.ddeServer = None
-
-        win32ui.SetRegistryKey(
-            "Python %s" % (sys.winver,)
-        )  # MFC automatically puts the main frame caption on!
-        app.CApp.InitInstance(self)
-
-        # Create the taskbar icon
-        win32ui.CreateDebuggerThread()
-
-        # Allow Pythonwin to host OCX controls.
-        win32ui.EnableControlContainer()
-
-        # Display the interactive window if the user wants it.
-        from . import interact
-
-        interact.CreateInteractiveWindowUserPreference()
-
-        # Load the modules we use internally.
-        self.LoadSystemModules()
-
-        # Load additional module the user may want.
-        self.LoadUserModules()
-
-        # Load the ToolBar state near the end of the init process, as
-        # there may be Toolbar IDs created by the user or other modules.
-        # By now all these modules should be loaded, so all the toolbar IDs loaded.
-        try:
-            self.frame.LoadBarState("ToolbarDefault")
-        except win32ui.error:
-            # MFC sucks.  It does essentially "GetDlgItem(x)->Something", so if the
-            # toolbar with ID x does not exist, MFC crashes!  Pythonwin has a trap for this
-            # but I need to investigate more how to prevent it (AFAIK, ensuring all the
-            # toolbars are created by now _should_ stop it!)
-            pass
-
-        # Finally process the command line arguments.
-        try:
-            self.ProcessArgs(sys.argv)
-        except:
-            # too early for printing anything.
-            win32ui.DisplayTraceback(
-                sys.exc_info(), " - error processing command line args"
-            )
-
-    def ExitInstance(self):
-        win32ui.DestroyDebuggerThread()
-        try:
-            from . import interact
-
-            interact.DestroyInteractiveWindow()
-        except:
-            pass
-        if self.ddeServer is not None:
-            self.ddeServer.Shutdown()
-            self.ddeServer = None
-        return app.CApp.ExitInstance(self)
-
-    def Activate(self):
-        # Bring to the foreground.  Mainly used when another app starts up, it asks
-        # this one to activate itself, then it terminates.
-        frame = win32ui.GetMainFrame()
-        frame.SetForegroundWindow()
-        if frame.GetWindowPlacement()[1] == win32con.SW_SHOWMINIMIZED:
-            frame.ShowWindow(win32con.SW_RESTORE)
-
-    def ProcessArgs(self, args, dde=None):
-        # If we are going to talk to a remote app via DDE, then
-        # activate it!
-        if (
-            len(args) < 1 or not args[0]
-        ):  # argv[0]=='' when started without args, just like Python.exe!
-            return
-
-        i = 0
-        while i < len(args):
-            argType = args[i]
-            i += 1
-            if argType.startswith("-"):
-                # Support dash options. Slash options are misinterpreted by python init
-                # as path and not finding usually 'C:\\' ends up in sys.path[0]
-                argType = "/" + argType[1:]
-            if not argType.startswith("/"):
-                argType = win32ui.GetProfileVal(
-                    "Python", "Default Arg Type", "/edit"
-                ).lower()
-                i -= 1  #  arg is /edit's parameter
-            par = i < len(args) and args[i] or "MISSING"
-            if argType in ("/nodde", "/new", "-nodde", "-new"):
-                # Already handled
-                pass
-            elif argType.startswith("/goto:"):
-                gotoline = int(argType[len("/goto:") :])
-                if dde:
-                    dde.Exec(
-                        "from pywin.framework import scriptutils\n"
-                        "ed = scriptutils.GetActiveEditControl()\n"
-                        "if ed: ed.SetSel(ed.LineIndex(%s - 1))" % gotoline
-                    )
-                else:
-                    from . import scriptutils
-
-                    ed = scriptutils.GetActiveEditControl()
-                    if ed:
-                        ed.SetSel(ed.LineIndex(gotoline - 1))
-            elif argType == "/edit":
-                # Load up the default application.
-                i += 1
-                fname = win32api.GetFullPathName(par)
-                if not os.path.isfile(fname):
-                    # if we don't catch this, OpenDocumentFile() (actually
-                    # PyCDocument.SetPathName() in
-                    # pywin.scintilla.document.CScintillaDocument.OnOpenDocument)
-                    # segfaults Pythonwin on recent PY3 builds (b228)
-                    win32ui.MessageBox(
-                        "No such file: %s\n\nCommand Line: %s"
-                        % (fname, win32api.GetCommandLine()),
-                        "Open file for edit",
-                        win32con.MB_ICONERROR,
-                    )
-                    continue
-                if dde:
-                    dde.Exec("win32ui.GetApp().OpenDocumentFile(%s)" % (repr(fname)))
-                else:
-                    win32ui.GetApp().OpenDocumentFile(par)
-            elif argType == "/rundlg":
-                if dde:
-                    dde.Exec(
-                        "from pywin.framework import scriptutils;scriptutils.RunScript(%r, %r, 1)"
-                        % (par, " ".join(args[i + 1 :]))
-                    )
-                else:
-                    from . import scriptutils
-
-                    scriptutils.RunScript(par, " ".join(args[i + 1 :]))
-                return
-            elif argType == "/run":
-                if dde:
-                    dde.Exec(
-                        "from pywin.framework import scriptutils;scriptutils.RunScript(%r, %r, 0)"
-                        % (par, " ".join(args[i + 1 :]))
-                    )
-                else:
-                    from . import scriptutils
-
-                    scriptutils.RunScript(par, " ".join(args[i + 1 :]), 0)
-                return
-            elif argType == "/app":
-                raise RuntimeError(
-                    "/app only supported for new instances of Pythonwin.exe"
-                )
-            elif argType == "/dde":  # Send arbitary command
-                if dde is not None:
-                    dde.Exec(par)
-                else:
-                    win32ui.MessageBox(
-                        "The /dde command can only be used\r\nwhen Pythonwin is already running"
-                    )
-                i += 1
-            else:
-                raise ValueError("Command line argument not recognised: %s" % argType)
-
-    def LoadSystemModules(self):
-        self.DoLoadModules("pywin.framework.editor,pywin.framework.stdin")
-
-    def LoadUserModules(self, moduleNames=None):
-        # Load the users modules.
-        if moduleNames is None:
-            default = "pywin.framework.sgrepmdi,pywin.framework.mdi_pychecker"
-            moduleNames = win32ui.GetProfileVal("Python", "Startup Modules", default)
-        self.DoLoadModules(moduleNames)
-
-    def DoLoadModules(self, moduleNames):  # ", sep string of module names.
-        if not moduleNames:
-            return
-        modules = moduleNames.split(",")
-        for module in modules:
-            try:
-                __import__(module)
-            except:  # Catch em all, else the app itself dies! 'ImportError:
-                traceback.print_exc()
-                msg = 'Startup import of user module "%s" failed' % module
-                print(msg)
-                win32ui.MessageBox(msg)
-
-    #
-    # DDE Callback
-    #
-    def OnDDECommand(self, command):
-        try:
-            exec(command + "\n")
-        except:
-            print("ERROR executing DDE command: ", command)
-            traceback.print_exc()
-            raise
-
-    #
-    # General handlers
-    #
-    def OnViewBrowse(self, id, code):
-        "Called when ViewBrowse message is received"
-        from pywin.tools import browser
-
-        obName = dialog.GetSimpleInput("Object", "__builtins__", "Browse Python Object")
-        if obName is None:
-            return
-        try:
-            browser.Browse(eval(obName, __main__.__dict__, __main__.__dict__))
-        except NameError:
-            win32ui.MessageBox("This is no object with this name")
-        except AttributeError:
-            win32ui.MessageBox("The object has no attribute of that name")
-        except:
-            traceback.print_exc()
-            win32ui.MessageBox("This object can not be browsed")
-
-    def OnFileImport(self, id, code):
-        "Called when a FileImport message is received. Import the current or specified file"
-        from . import scriptutils
-
-        scriptutils.ImportFile()
-
-    def OnFileCheck(self, id, code):
-        "Called when a FileCheck message is received. Check the current file."
-        from . import scriptutils
-
-        scriptutils.CheckFile()
-
-    def OnUpdateFileCheck(self, cmdui):
-        from . import scriptutils
-
-        cmdui.Enable(scriptutils.GetActiveFileName(0) is not None)
-
-    def OnFileRun(self, id, code):
-        "Called when a FileRun message is received."
-        from . import scriptutils
-
-        showDlg = win32api.GetKeyState(win32con.VK_SHIFT) >= 0
-        scriptutils.RunScript(None, None, showDlg)
-
-    def OnFileLocate(self, id, code):
-        from . import scriptutils
-
-        global lastLocateFileName  # save the new version away for next time...
-
-        name = dialog.GetSimpleInput(
-            "File name", lastLocateFileName, "Locate Python File"
-        )
-        if name is None:  # Cancelled.
-            return
-        lastLocateFileName = name
-        # if ".py" supplied, rip it off!
-        # should also check for .pys and .pyw
-        if lastLocateFileName[-3:].lower() == ".py":
-            lastLocateFileName = lastLocateFileName[:-3]
-        lastLocateFileName = lastLocateFileName.replace(".", "\\")
-        newName = scriptutils.LocatePythonFile(lastLocateFileName)
-        if newName is None:
-            win32ui.MessageBox("The file '%s' can not be located" % lastLocateFileName)
-        else:
-            win32ui.GetApp().OpenDocumentFile(newName)
-
-    # Display all the "options" proprety pages we can find
-    def OnViewOptions(self, id, code):
-        win32ui.InitRichEdit()
-        sheet = dialog.PropertySheet("Pythonwin Options")
-        # Add property pages we know about that need manual work.
-        from pywin.dialogs import ideoptions
-
-        sheet.AddPage(ideoptions.OptionsPropPage())
-
-        from . import toolmenu
-
-        sheet.AddPage(toolmenu.ToolMenuPropPage())
-
-        # Get other dynamic pages from templates.
-        pages = []
-        for template in self.GetDocTemplateList():
-            try:
-                # Dont actually call the function with the exception handler.
-                getter = template.GetPythonPropertyPages
-            except AttributeError:
-                # Template does not provide property pages!
-                continue
-            pages = pages + getter()
-
-        # Debugger template goes at the end
-        try:
-            from pywin.debugger import configui
-        except ImportError:
-            configui = None
-        if configui is not None:
-            pages.append(configui.DebuggerOptionsPropPage())
-        # Now simply add the pages, and display the dialog.
-        for page in pages:
-            sheet.AddPage(page)
-
-        if sheet.DoModal() == win32con.IDOK:
-            win32ui.SetStatusText("Applying configuration changes...", 1)
-            win32ui.DoWaitCursor(1)
-            # Tell every Window in our app that win.ini has changed!
-            win32ui.GetMainFrame().SendMessageToDescendants(
-                win32con.WM_WININICHANGE, 0, 0
-            )
-            win32ui.DoWaitCursor(0)
-
-    def OnInteractiveWindow(self, id, code):
-        # toggle the existing state.
-        from . import interact
-
-        interact.ToggleInteractiveWindow()
-
-    def OnUpdateInteractiveWindow(self, cmdui):
-        try:
-            interact = sys.modules["pywin.framework.interact"]
-            state = interact.IsInteractiveWindowVisible()
-        except KeyError:  # Interactive module hasnt ever been imported.
-            state = 0
-        cmdui.Enable()
-        cmdui.SetCheck(state)
-
-    def OnFileSaveAll(self, id, code):
-        # Only attempt to save editor documents.
-        from pywin.framework.editor import editorTemplate
-
-        num = 0
-        for doc in editorTemplate.GetDocumentList():
-            if doc.IsModified() and doc.GetPathName():
-                num = num = 1
-                doc.OnSaveDocument(doc.GetPathName())
-        win32ui.SetStatusText("%d documents saved" % num, 1)
-
-    def OnViewToolbarDbg(self, id, code):
-        if code == 0:
-            return not win32ui.GetMainFrame().OnBarCheck(id)
-
-    def OnUpdateViewToolbarDbg(self, cmdui):
-        win32ui.GetMainFrame().OnUpdateControlBarMenu(cmdui)
-        cmdui.Enable(1)
-
-    def OnHelpIndex(self, id, code):
-        from . import help
-
-        help.SelectAndRunHelpFile()
-
-
-# As per the comments in app.py, this use is depreciated.
-# app.AppBuilder = InteractivePythonApp
-
-# Now all we do is create the application
-thisApp = InteractivePythonApp()
diff --git a/lib/pythonwin/pywin/framework/intpydde.py b/lib/pythonwin/pywin/framework/intpydde.py
deleted file mode 100644
index 1f869b0f..00000000
--- a/lib/pythonwin/pywin/framework/intpydde.py
+++ /dev/null
@@ -1,60 +0,0 @@
-# DDE support for Pythonwin
-#
-# Seems to work fine (in the context that IE4 seems to have broken
-# DDE on _all_ NT4 machines I have tried, but only when a "Command Prompt" window
-# is open.  Strange, but true.  If you have problems with this, close all Command Prompts!
-
-
-import sys
-import traceback
-
-import win32api
-import win32ui
-from dde import *
-from pywin.mfc import object
-
-
-class DDESystemTopic(object.Object):
-    def __init__(self, app):
-        self.app = app
-        object.Object.__init__(self, CreateServerSystemTopic())
-
-    def Exec(self, data):
-        try:
-            # 			print "Executing", cmd
-            self.app.OnDDECommand(data)
-        except:
-            t, v, tb = sys.exc_info()
-            # The DDE Execution failed.
-            print("Error executing DDE command.")
-            traceback.print_exception(t, v, tb)
-            return 0
-
-
-class DDEServer(object.Object):
-    def __init__(self, app):
-        self.app = app
-        object.Object.__init__(self, CreateServer())
-        self.topic = self.item = None
-
-    def CreateSystemTopic(self):
-        return DDESystemTopic(self.app)
-
-    def Shutdown(self):
-        self._obj_.Shutdown()
-        self._obj_.Destroy()
-        if self.topic is not None:
-            self.topic.Destroy()
-            self.topic = None
-        if self.item is not None:
-            self.item.Destroy()
-            self.item = None
-
-    def OnCreate(self):
-        return 1
-
-    def Status(self, msg):
-        try:
-            win32ui.SetStatusText(msg)
-        except win32ui.error:
-            pass
diff --git a/lib/pythonwin/pywin/framework/mdi_pychecker.py b/lib/pythonwin/pywin/framework/mdi_pychecker.py
deleted file mode 100644
index c89f33b9..00000000
--- a/lib/pythonwin/pywin/framework/mdi_pychecker.py
+++ /dev/null
@@ -1,849 +0,0 @@
-######################################################################
-##
-## The Pychecker MDI Plug-In UserModule for Pythonwin
-##
-## contributed by Robert Kiendl
-##
-## Style is similar to (and inherited) from the SGrepMDI UserModule
-##
-## Usage:
-##
-## Start Pychecker on current file: Menu/File/New../Pychecker.
-## Use it: Jump to Pychecker warning source lines by double-click.
-## Auto-add "#$pycheck_no" / "#$pycheck_no=specific-re-pattern" tags
-## to source lines by context/right-mouse-click on warning lines.
-##
-## It requires pychecker installed and the pychecker.bat to be on
-## the PATH. Example pychecker.bat:
-##
-##   REM pychecker.bat
-##   C:\bin\python.exe C:\PYTHON23\Lib\site-packages\pychecker\checker.py %1 %2 %3 %4 %5 %6 %7 %8 %9
-##
-## Adding it as default module in PythonWin:
-##
-##  +++ ./intpyapp.py	2006-10-02 17:59:32.974161600 +0200
-##  @@ -272,7 +282,7 @@
-## 	def LoadUserModules(self, moduleNames = None):
-## 		# Load the users modules.
-## 		if moduleNames is None:
-##  -			default = "sgrepmdi"
-##  +			default = "sgrepmdi,mdi_pychecker"
-## 			moduleNames=win32ui.GetProfileVal('Python','Startup Modules',default)
-## 		self.DoLoadModules(moduleNames)
-##
-######################################################################
-
-import glob
-import os
-import re
-import sys
-import time
-
-import win32api
-import win32con
-import win32ui
-from pywin.mfc import dialog, docview, window
-
-from . import scriptutils
-
-
-def getsubdirs(d):
-    dlist = []
-    flist = glob.glob(d + "\\*")
-    for f in flist:
-        if os.path.isdir(f):
-            dlist.append(f)
-            dlist = dlist + getsubdirs(f)
-    return dlist
-
-
-class dirpath:
-    def __init__(self, str, recurse=0):
-        dp = str.split(";")
-        dirs = {}
-        for d in dp:
-            if os.path.isdir(d):
-                d = d.lower()
-                if d not in dirs:
-                    dirs[d] = None
-                    if recurse:
-                        subdirs = getsubdirs(d)
-                        for sd in subdirs:
-                            sd = sd.lower()
-                            if sd not in dirs:
-                                dirs[sd] = None
-            elif os.path.isfile(d):
-                pass
-            else:
-                x = None
-                if d in os.environ:
-                    x = dirpath(os.environ[d])
-                elif d[:5] == "HKEY_":
-                    keystr = d.split("\\")
-                    try:
-                        root = eval("win32con." + keystr[0])
-                    except:
-                        win32ui.MessageBox(
-                            "Can't interpret registry key name '%s'" % keystr[0]
-                        )
-                    try:
-                        subkey = "\\".join(keystr[1:])
-                        val = win32api.RegQueryValue(root, subkey)
-                        if val:
-                            x = dirpath(val)
-                        else:
-                            win32ui.MessageBox(
-                                "Registry path '%s' did not return a path entry" % d
-                            )
-                    except:
-                        win32ui.MessageBox(
-                            "Can't interpret registry key value: %s" % keystr[1:]
-                        )
-                else:
-                    win32ui.MessageBox("Directory '%s' not found" % d)
-                if x:
-                    for xd in x:
-                        if xd not in dirs:
-                            dirs[xd] = None
-                            if recurse:
-                                subdirs = getsubdirs(xd)
-                                for sd in subdirs:
-                                    sd = sd.lower()
-                                    if sd not in dirs:
-                                        dirs[sd] = None
-        self.dirs = []
-        for d in dirs.keys():
-            self.dirs.append(d)
-
-    def __getitem__(self, key):
-        return self.dirs[key]
-
-    def __len__(self):
-        return len(self.dirs)
-
-    def __setitem__(self, key, value):
-        self.dirs[key] = value
-
-    def __delitem__(self, key):
-        del self.dirs[key]
-
-    def __getslice__(self, lo, hi):
-        return self.dirs[lo:hi]
-
-    def __setslice__(self, lo, hi, seq):
-        self.dirs[lo:hi] = seq
-
-    def __delslice__(self, lo, hi):
-        del self.dirs[lo:hi]
-
-    def __add__(self, other):
-        if type(other) == type(self) or type(other) == type([]):
-            return self.dirs + other.dirs
-
-    def __radd__(self, other):
-        if type(other) == type(self) or type(other) == type([]):
-            return other.dirs + self.dirs
-
-
-# Group(1) is the filename, group(2) is the lineno.
-# regexGrepResult=regex.compile("^\\([a-zA-Z]:.*\\)(\\([0-9]+\\))")
-# regexGrep=re.compile(r"^([a-zA-Z]:[^(]*)\((\d+)\)")
-regexGrep = re.compile(r"^(..[^\(:]+)?[\(:](\d+)[\):]:?\s*(.*)")
-
-# these are the atom numbers defined by Windows for basic dialog controls
-
-BUTTON = 0x80
-EDIT = 0x81
-STATIC = 0x82
-LISTBOX = 0x83
-SCROLLBAR = 0x84
-COMBOBOX = 0x85
-
-
-class TheTemplate(docview.RichEditDocTemplate):
-    def __init__(self):
-        docview.RichEditDocTemplate.__init__(
-            self, win32ui.IDR_TEXTTYPE, TheDocument, TheFrame, TheView
-        )
-        self.SetDocStrings(
-            "\nPychecker\nPychecker\nPychecker params (*.pychecker)\n.pychecker\n\n\n"
-        )
-        win32ui.GetApp().AddDocTemplate(self)
-        self.docparams = None
-
-    def MatchDocType(self, fileName, fileType):
-        doc = self.FindOpenDocument(fileName)
-        if doc:
-            return doc
-        ext = os.path.splitext(fileName)[1].lower()
-        if ext == ".pychecker":
-            return win32ui.CDocTemplate_Confidence_yesAttemptNative
-        return win32ui.CDocTemplate_Confidence_noAttempt
-
-    def setParams(self, params):
-        self.docparams = params
-
-    def readParams(self):
-        tmp = self.docparams
-        self.docparams = None
-        return tmp
-
-
-class TheFrame(window.MDIChildWnd):
-    # The template and doc params will one day be removed.
-    def __init__(self, wnd=None):
-        window.MDIChildWnd.__init__(self, wnd)
-
-
-class TheDocument(docview.RichEditDoc):
-    def __init__(self, template):
-        docview.RichEditDoc.__init__(self, template)
-        self.dirpattern = ""
-        self.filpattern = ""
-        self.greppattern = ""
-        self.casesensitive = 1
-        self.recurse = 1
-        self.verbose = 0
-
-    def OnOpenDocument(self, fnm):
-        # this bizarre stuff with params is so right clicking in a result window
-        # and starting a new grep can communicate the default parameters to the
-        # new grep.
-        try:
-            params = open(fnm, "r").read()
-        except:
-            params = None
-        self.setInitParams(params)
-        return self.OnNewDocument()
-
-    def OnCloseDocument(self):
-        try:
-            win32ui.GetApp().DeleteIdleHandler(self.idleHandler)
-        except:
-            pass
-        return self._obj_.OnCloseDocument()
-
-    def saveInitParams(self):
-        # Only save the flags, not the text boxes.
-        paramstr = "\t\t\t%d\t%d" % (self.casesensitive, self.recurse)
-        win32ui.WriteProfileVal("Pychecker", "Params", paramstr)
-
-    def setInitParams(self, paramstr):
-        if paramstr is None:
-            paramstr = win32ui.GetProfileVal("Pychecker", "Params", "\t\t\t1\t0\t0")
-        params = paramstr.split("\t")
-        if len(params) < 3:
-            params = params + [""] * (3 - len(params))
-        if len(params) < 6:
-            params = params + [0] * (6 - len(params))
-        self.dirpattern = params[0]
-        self.filpattern = params[1]
-        self.greppattern = params[2] or "-#1000 --only"
-        self.casesensitive = int(params[3])
-        self.recurse = int(params[4])
-        self.verbose = int(params[5])
-        # setup some reasonable defaults.
-        if not self.dirpattern:
-            try:
-                editor = win32ui.GetMainFrame().MDIGetActive()[0].GetEditorView()
-                self.dirpattern = os.path.abspath(
-                    os.path.dirname(editor.GetDocument().GetPathName())
-                )
-            except (AttributeError, win32ui.error):
-                self.dirpattern = os.getcwd()
-        if not self.filpattern:
-            try:
-                editor = win32ui.GetMainFrame().MDIGetActive()[0].GetEditorView()
-                self.filpattern = editor.GetDocument().GetPathName()
-            except AttributeError:
-                self.filpattern = "*.py"
-
-    def OnNewDocument(self):
-        if self.dirpattern == "":
-            self.setInitParams(greptemplate.readParams())
-        d = TheDialog(
-            self.dirpattern,
-            self.filpattern,
-            self.greppattern,
-            self.casesensitive,
-            self.recurse,
-            self.verbose,
-        )
-        if d.DoModal() == win32con.IDOK:
-            self.dirpattern = d["dirpattern"]
-            self.filpattern = d["filpattern"]
-            self.greppattern = d["greppattern"]
-            # self.casesensitive = d['casesensitive']
-            # self.recurse = d['recursive']
-            # self.verbose = d['verbose']
-            self.doSearch()
-            self.saveInitParams()
-            return 1
-        return 0  # cancelled - return zero to stop frame creation.
-
-    def doSearch(self):
-        self.dp = dirpath(self.dirpattern, self.recurse)
-        self.SetTitle(
-            "Pychecker Run '%s' (options: %s)" % (self.filpattern, self.greppattern)
-        )
-        # self.text = []
-        self.GetFirstView().Append(
-            "#Pychecker Run in " + self.dirpattern + "  %s\n" % time.asctime()
-        )
-        if self.verbose:
-            self.GetFirstView().Append("#   =" + repr(self.dp.dirs) + "\n")
-        self.GetFirstView().Append("# Files   " + self.filpattern + "\n")
-        self.GetFirstView().Append("# Options " + self.greppattern + "\n")
-        self.fplist = self.filpattern.split(";")
-        self.GetFirstView().Append(
-            "# Running...  ( double click on result lines in order to jump to the source code ) \n"
-        )
-        win32ui.SetStatusText("Pychecker running.  Please wait...", 0)
-        self.dpndx = self.fpndx = 0
-        self.fndx = -1
-        if not self.dp:
-            self.GetFirstView().Append(
-                "# ERROR: '%s' does not resolve to any search locations"
-                % self.dirpattern
-            )
-            self.SetModifiedFlag(0)
-        else:
-            ##self.flist = glob.glob(self.dp[0]+'\\'+self.fplist[0])
-            import operator
-
-            self.flist = reduce(operator.add, list(map(glob.glob, self.fplist)))
-            # import pywin.debugger;pywin.debugger.set_trace()
-            self.startPycheckerRun()
-
-    def idleHandler(self, handler, count):
-        import time
-
-        time.sleep(0.001)
-        if self.result != None:
-            win32ui.GetApp().DeleteIdleHandler(self.idleHandler)
-            return 0
-        return 1  # more
-
-    def startPycheckerRun(self):
-        self.result = None
-        old = win32api.SetCursor(win32api.LoadCursor(0, win32con.IDC_APPSTARTING))
-        win32ui.GetApp().AddIdleHandler(self.idleHandler)
-        import _thread
-
-        _thread.start_new(self.threadPycheckerRun, ())
-        ##win32api.SetCursor(old)
-
-    def threadPycheckerRun(self):
-        result = ""
-        rc = -1
-        try:
-            options = self.greppattern
-            files = " ".join(self.flist)
-            # Recently MarkH has failed to run pychecker without it having
-            # been explicitly installed - so we assume it is and locate it
-            # from its default location.
-            # Step1 - get python.exe
-            py = os.path.join(sys.prefix, "python.exe")
-            if not os.path.isfile(py):
-                if "64 bit" in sys.version:
-                    py = os.path.join(sys.prefix, "PCBuild", "amd64", "python.exe")
-                else:
-                    py = os.path.join(sys.prefix, "PCBuild", "python.exe")
-            try:
-                py = win32api.GetShortPathName(py)
-            except win32api.error:
-                py = ""
-            # Find checker.py
-            import sysconfig
-
-            pychecker = os.path.join(
-                sysconfig.get_paths()["purelib"], "pychecker", "checker.py"
-            )
-            if not os.path.isfile(py):
-                result = "Can't find python.exe!\n"
-            elif not os.path.isfile(pychecker):
-                result = (
-                    "Can't find checker.py - please install pychecker "
-                    "(or run 'setup.py install' if you have the source version)\n"
-                )
-            else:
-                cmd = '%s "%s" %s %s 2>&1' % (py, pychecker, options, files)
-                ##fin,fout,ferr=os.popen3(cmd)
-                ##result=ferr.read()+fout.read()
-                result = os.popen(cmd).read()
-                ##rc=f.close()
-            self.GetFirstView().Append(result)
-        finally:
-            self.result = result
-            print("== Pychecker run finished ==")
-            self.GetFirstView().Append("\n" + "== Pychecker run finished ==")
-            self.SetModifiedFlag(0)
-
-    def _inactive_idleHandler(self, handler, count):
-        self.fndx = self.fndx + 1
-        if self.fndx < len(self.flist):
-            f = self.flist[self.fndx]
-            if self.verbose:
-                self.GetFirstView().Append("# .." + f + "\n")
-            win32ui.SetStatusText("Searching " + f, 0)
-            lines = open(f, "r").readlines()
-            for i in range(len(lines)):
-                line = lines[i]
-                if self.pat.search(line) != None:
-                    self.GetFirstView().Append(f + "(" + repr(i + 1) + ") " + line)
-        else:
-            self.fndx = -1
-            self.fpndx = self.fpndx + 1
-            if self.fpndx < len(self.fplist):
-                self.flist = glob.glob(
-                    self.dp[self.dpndx] + "\\" + self.fplist[self.fpndx]
-                )
-            else:
-                self.fpndx = 0
-                self.dpndx = self.dpndx + 1
-                if self.dpndx < len(self.dp):
-                    self.flist = glob.glob(
-                        self.dp[self.dpndx] + "\\" + self.fplist[self.fpndx]
-                    )
-                else:
-                    win32ui.SetStatusText("Search complete.", 0)
-                    self.SetModifiedFlag(0)  # default to not modified.
-                    try:
-                        win32ui.GetApp().DeleteIdleHandler(self.idleHandler)
-                    except:
-                        pass
-                    return 0
-        return 1
-
-    def GetParams(self):
-        return (
-            self.dirpattern
-            + "\t"
-            + self.filpattern
-            + "\t"
-            + self.greppattern
-            + "\t"
-            + repr(self.casesensitive)
-            + "\t"
-            + repr(self.recurse)
-            + "\t"
-            + repr(self.verbose)
-        )
-
-    def OnSaveDocument(self, filename):
-        #       print 'OnSaveDocument() filename=',filename
-        savefile = open(filename, "wb")
-        txt = self.GetParams() + "\n"
-        #       print 'writing',txt
-        savefile.write(txt)
-        savefile.close()
-        self.SetModifiedFlag(0)
-        return 1
-
-
-ID_OPEN_FILE = 0xE500
-ID_PYCHECKER = 0xE501
-ID_SAVERESULTS = 0x502
-ID_TRYAGAIN = 0x503
-ID_ADDCOMMENT = 0x504
-ID_ADDPYCHECKNO2 = 0x505
-
-
-class TheView(docview.RichEditView):
-    def __init__(self, doc):
-        docview.RichEditView.__init__(self, doc)
-        self.SetWordWrap(win32ui.CRichEditView_WrapNone)
-        self.HookHandlers()
-
-    def OnInitialUpdate(self):
-        rc = self._obj_.OnInitialUpdate()
-        format = (-402653169, 0, 200, 0, 0, 0, 49, "Courier New")
-        self.SetDefaultCharFormat(format)
-        return rc
-
-    def HookHandlers(self):
-        self.HookMessage(self.OnRClick, win32con.WM_RBUTTONDOWN)
-        self.HookCommand(self.OnCmdOpenFile, ID_OPEN_FILE)
-        self.HookCommand(self.OnCmdThe, ID_PYCHECKER)
-        self.HookCommand(self.OnCmdSave, ID_SAVERESULTS)
-        self.HookCommand(self.OnTryAgain, ID_TRYAGAIN)
-        self.HookCommand(self.OnAddComment, ID_ADDCOMMENT)
-        self.HookCommand(self.OnAddComment, ID_ADDPYCHECKNO2)
-        self.HookMessage(self.OnLDblClick, win32con.WM_LBUTTONDBLCLK)
-
-    def OnLDblClick(self, params):
-        line = self.GetLine()
-        regexGrepResult = regexGrep.match(line)
-        if regexGrepResult:
-            fname = regexGrepResult.group(1)
-            line = int(regexGrepResult.group(2))
-            scriptutils.JumpToDocument(fname, line)
-            return 0  # dont pass on
-        return 1  # pass it on by default.
-
-    def OnRClick(self, params):
-        menu = win32ui.CreatePopupMenu()
-        flags = win32con.MF_STRING | win32con.MF_ENABLED
-        lineno = self._obj_.LineFromChar(-1)  # selection or current line
-        line = self._obj_.GetLine(lineno)
-        regexGrepResult = regexGrep.match(line)
-        charstart, charend = self._obj_.GetSel()
-        if regexGrepResult:
-            self.fnm = regexGrepResult.group(1)
-            self.lnnum = int(regexGrepResult.group(2))
-            menu.AppendMenu(flags, ID_OPEN_FILE, "&Open " + self.fnm)
-            menu.AppendMenu(
-                flags, ID_ADDCOMMENT, "&Add to source: Comment Tag/#$pycheck_no .."
-            )
-            menu.AppendMenu(
-                flags,
-                ID_ADDPYCHECKNO2,
-                "&Add to source: Specific #$pycheck_no=%(errtext)s ..",
-            )
-            menu.AppendMenu(win32con.MF_SEPARATOR)
-        menu.AppendMenu(flags, ID_TRYAGAIN, "&Try Again")
-        menu.AppendMenu(flags, win32ui.ID_EDIT_CUT, "Cu&t")
-        menu.AppendMenu(flags, win32ui.ID_EDIT_COPY, "&Copy")
-        menu.AppendMenu(flags, win32ui.ID_EDIT_PASTE, "&Paste")
-        menu.AppendMenu(flags, win32con.MF_SEPARATOR)
-        menu.AppendMenu(flags, win32ui.ID_EDIT_SELECT_ALL, "&Select all")
-        menu.AppendMenu(flags, win32con.MF_SEPARATOR)
-        menu.AppendMenu(flags, ID_SAVERESULTS, "Sa&ve results")
-        menu.TrackPopupMenu(params[5])
-        return 0
-
-    def OnAddComment(self, cmd, code):
-        addspecific = cmd == ID_ADDPYCHECKNO2
-        _ = list(self.GetSel())
-        _.sort()
-        start, end = _
-        line_start, line_end = self.LineFromChar(start), self.LineFromChar(end)
-        first = 1
-        for i in range(line_start, line_end + 1):
-            line = self.GetLine(i)
-            m = regexGrep.match(line)
-            if m:
-                if first:
-                    first = 0
-                    cmnt = dialog.GetSimpleInput(
-                        "Add to %s lines" % (line_end - line_start + 1),
-                        addspecific
-                        and "  #$pycheck_no=%(errtext)s"
-                        or "  #$pycheck_no",
-                    )
-                    if not cmnt:
-                        return 0
-                ##import pywin.debugger;pywin.debugger.set_trace()
-                fname = m.group(1)
-                line = int(m.group(2))
-                view = scriptutils.JumpToDocument(fname, line)
-                pos = view.LineIndex(line) - 1
-                if view.GetTextRange(pos - 1, pos) in ("\r", "\n"):
-                    pos -= 1
-                view.SetSel(pos, pos)
-                errtext = m.group(3)
-                if start != end and line_start == line_end:
-                    errtext = self.GetSelText()
-                errtext = repr(re.escape(errtext).replace("\ ", " "))
-                view.ReplaceSel(addspecific and cmnt % locals() or cmnt)
-        return 0
-
-    def OnCmdOpenFile(self, cmd, code):
-        doc = win32ui.GetApp().OpenDocumentFile(self.fnm)
-        if doc:
-            vw = doc.GetFirstView()
-            # hope you have an editor that implements GotoLine()!
-            try:
-                vw.GotoLine(int(self.lnnum))
-            except:
-                pass
-        return 0
-
-    def OnCmdThe(self, cmd, code):
-        curparamsstr = self.GetDocument().GetParams()
-        params = curparamsstr.split("\t")
-        params[2] = self.sel
-        greptemplate.setParams("\t".join(params))
-        greptemplate.OpenDocumentFile()
-        return 0
-
-    def OnTryAgain(self, cmd, code):
-        greptemplate.setParams(self.GetDocument().GetParams())
-        greptemplate.OpenDocumentFile()
-        return 0
-
-    def OnCmdSave(self, cmd, code):
-        flags = win32con.OFN_OVERWRITEPROMPT
-        dlg = win32ui.CreateFileDialog(
-            0, None, None, flags, "Text Files (*.txt)|*.txt||", self
-        )
-        dlg.SetOFNTitle("Save Results As")
-        if dlg.DoModal() == win32con.IDOK:
-            pn = dlg.GetPathName()
-            self._obj_.SaveFile(pn)
-        return 0
-
-    def Append(self, strng):
-        numlines = self.GetLineCount()
-        endpos = self.LineIndex(numlines - 1) + len(self.GetLine(numlines - 1))
-        self.SetSel(endpos, endpos)
-        self.ReplaceSel(strng)
-
-
-class TheDialog(dialog.Dialog):
-    def __init__(self, dp, fp, gp, cs, r, v):
-        style = (
-            win32con.DS_MODALFRAME
-            | win32con.WS_POPUP
-            | win32con.WS_VISIBLE
-            | win32con.WS_CAPTION
-            | win32con.WS_SYSMENU
-            | win32con.DS_SETFONT
-        )
-        CS = win32con.WS_CHILD | win32con.WS_VISIBLE
-        tmp = [
-            ["Pychecker Run", (0, 0, 210, 90), style, None, (8, "MS Sans Serif")],
-        ]
-        tmp.append([STATIC, "Files:", -1, (7, 7, 50, 9), CS])
-        tmp.append(
-            [
-                EDIT,
-                gp,
-                103,
-                (52, 7, 144, 11),
-                CS | win32con.WS_TABSTOP | win32con.ES_AUTOHSCROLL | win32con.WS_BORDER,
-            ]
-        )
-        tmp.append([STATIC, "Directories:", -1, (7, 20, 50, 9), CS])
-        tmp.append(
-            [
-                EDIT,
-                dp,
-                102,
-                (52, 20, 128, 11),
-                CS | win32con.WS_TABSTOP | win32con.ES_AUTOHSCROLL | win32con.WS_BORDER,
-            ]
-        )
-        tmp.append(
-            [
-                BUTTON,
-                "...",
-                110,
-                (182, 20, 16, 11),
-                CS | win32con.BS_PUSHBUTTON | win32con.WS_TABSTOP,
-            ]
-        )
-        tmp.append([STATIC, "Options:", -1, (7, 33, 50, 9), CS])
-        tmp.append(
-            [
-                EDIT,
-                fp,
-                101,
-                (52, 33, 128, 11),
-                CS | win32con.WS_TABSTOP | win32con.ES_AUTOHSCROLL | win32con.WS_BORDER,
-            ]
-        )
-        tmp.append(
-            [
-                BUTTON,
-                "...",
-                111,
-                (182, 33, 16, 11),
-                CS | win32con.BS_PUSHBUTTON | win32con.WS_TABSTOP,
-            ]
-        )
-        # tmp.append([BUTTON,'Case sensitive',       104, (7,  45,  72,  9), CS | win32con.BS_AUTOCHECKBOX | win32con.BS_LEFTTEXT| win32con.WS_TABSTOP])
-        # tmp.append([BUTTON,'Subdirectories',       105, (7,  56,  72,  9), CS | win32con.BS_AUTOCHECKBOX | win32con.BS_LEFTTEXT| win32con.WS_TABSTOP])
-        # tmp.append([BUTTON,'Verbose',              106, (7,  67,  72,  9), CS | win32con.BS_AUTOCHECKBOX | win32con.BS_LEFTTEXT| win32con.WS_TABSTOP])
-        tmp.append(
-            [
-                BUTTON,
-                "OK",
-                win32con.IDOK,
-                (166, 53, 32, 12),
-                CS | win32con.BS_DEFPUSHBUTTON | win32con.WS_TABSTOP,
-            ]
-        )
-        tmp.append(
-            [
-                BUTTON,
-                "Cancel",
-                win32con.IDCANCEL,
-                (166, 67, 32, 12),
-                CS | win32con.BS_PUSHBUTTON | win32con.WS_TABSTOP,
-            ]
-        )
-        dialog.Dialog.__init__(self, tmp)
-        self.AddDDX(101, "greppattern")
-        self.AddDDX(102, "dirpattern")
-        self.AddDDX(103, "filpattern")
-        # self.AddDDX(104,'casesensitive')
-        # self.AddDDX(105,'recursive')
-        # self.AddDDX(106,'verbose')
-        self._obj_.data["greppattern"] = gp
-        self._obj_.data["dirpattern"] = dp
-        self._obj_.data["filpattern"] = fp
-        # self._obj_.data['casesensitive']  = cs
-        # self._obj_.data['recursive'] = r
-        # self._obj_.data['verbose']  = v
-        self.HookCommand(self.OnMoreDirectories, 110)
-        self.HookCommand(self.OnMoreFiles, 111)
-
-    def OnMoreDirectories(self, cmd, code):
-        self.getMore("Pychecker\\Directories", "dirpattern")
-
-    def OnMoreFiles(self, cmd, code):
-        self.getMore("Pychecker\\File Types", "filpattern")
-
-    def getMore(self, section, key):
-        self.UpdateData(1)
-        # get the items out of the ini file
-        ini = win32ui.GetProfileFileName()
-        secitems = win32api.GetProfileSection(section, ini)
-        items = []
-        for secitem in secitems:
-            items.append(secitem.split("=")[1])
-        dlg = TheParamsDialog(items)
-        if dlg.DoModal() == win32con.IDOK:
-            itemstr = ";".join(dlg.getItems())
-            self._obj_.data[key] = itemstr
-            # update the ini file with dlg.getNew()
-            i = 0
-            newitems = dlg.getNew()
-            if newitems:
-                items = items + newitems
-                for item in items:
-                    win32api.WriteProfileVal(section, repr(i), item, ini)
-                    i = i + 1
-            self.UpdateData(0)
-
-    def OnOK(self):
-        self.UpdateData(1)
-        for id, name in (
-            (101, "greppattern"),
-            (102, "dirpattern"),
-            (103, "filpattern"),
-        ):
-            if not self[name]:
-                self.GetDlgItem(id).SetFocus()
-                win32api.MessageBeep()
-                win32ui.SetStatusText("Please enter a value")
-                return
-        self._obj_.OnOK()
-
-
-class TheParamsDialog(dialog.Dialog):
-    def __init__(self, items):
-        self.items = items
-        self.newitems = []
-        style = (
-            win32con.DS_MODALFRAME
-            | win32con.WS_POPUP
-            | win32con.WS_VISIBLE
-            | win32con.WS_CAPTION
-            | win32con.WS_SYSMENU
-            | win32con.DS_SETFONT
-        )
-        CS = win32con.WS_CHILD | win32con.WS_VISIBLE
-        tmp = [
-            [
-                "Pychecker Parameters",
-                (0, 0, 205, 100),
-                style,
-                None,
-                (8, "MS Sans Serif"),
-            ],
-        ]
-        tmp.append(
-            [
-                LISTBOX,
-                "",
-                107,
-                (7, 7, 150, 72),
-                CS
-                | win32con.LBS_MULTIPLESEL
-                | win32con.LBS_STANDARD
-                | win32con.LBS_HASSTRINGS
-                | win32con.WS_TABSTOP
-                | win32con.LBS_NOTIFY,
-            ]
-        )
-        tmp.append(
-            [
-                BUTTON,
-                "OK",
-                win32con.IDOK,
-                (167, 7, 32, 12),
-                CS | win32con.BS_DEFPUSHBUTTON | win32con.WS_TABSTOP,
-            ]
-        )
-        tmp.append(
-            [
-                BUTTON,
-                "Cancel",
-                win32con.IDCANCEL,
-                (167, 23, 32, 12),
-                CS | win32con.BS_PUSHBUTTON | win32con.WS_TABSTOP,
-            ]
-        )
-        tmp.append([STATIC, "New:", -1, (2, 83, 15, 12), CS])
-        tmp.append(
-            [
-                EDIT,
-                "",
-                108,
-                (18, 83, 139, 12),
-                CS | win32con.WS_TABSTOP | win32con.ES_AUTOHSCROLL | win32con.WS_BORDER,
-            ]
-        )
-        tmp.append(
-            [
-                BUTTON,
-                "Add",
-                109,
-                (167, 83, 32, 12),
-                CS | win32con.BS_PUSHBUTTON | win32con.WS_TABSTOP,
-            ]
-        )
-        dialog.Dialog.__init__(self, tmp)
-        self.HookCommand(self.OnAddItem, 109)
-        self.HookCommand(self.OnListDoubleClick, 107)
-
-    def OnInitDialog(self):
-        lb = self.GetDlgItem(107)
-        for item in self.items:
-            lb.AddString(item)
-        return self._obj_.OnInitDialog()
-
-    def OnAddItem(self, cmd, code):
-        eb = self.GetDlgItem(108)
-        item = eb.GetLine(0)
-        self.newitems.append(item)
-        lb = self.GetDlgItem(107)
-        i = lb.AddString(item)
-        lb.SetSel(i, 1)
-        return 1
-
-    def OnListDoubleClick(self, cmd, code):
-        if code == win32con.LBN_DBLCLK:
-            self.OnOK()
-            return 1
-
-    def OnOK(self):
-        lb = self.GetDlgItem(107)
-        self.selections = lb.GetSelTextItems()
-        self._obj_.OnOK()
-
-    def getItems(self):
-        return self.selections
-
-    def getNew(self):
-        return self.newitems
-
-
-try:
-    win32ui.GetApp().RemoveDocTemplate(greptemplate)
-except NameError:
-    pass
-
-greptemplate = TheTemplate()
diff --git a/lib/pythonwin/pywin/framework/scriptutils.py b/lib/pythonwin/pywin/framework/scriptutils.py
deleted file mode 100644
index e5bc57c8..00000000
--- a/lib/pythonwin/pywin/framework/scriptutils.py
+++ /dev/null
@@ -1,688 +0,0 @@
-"""
-Various utilities for running/importing a script
-"""
-import bdb
-import linecache
-import os
-import sys
-import traceback
-
-import __main__
-import win32api
-import win32con
-import win32ui
-from pywin.mfc import dialog
-from pywin.mfc.docview import TreeView
-
-from .cmdline import ParseArgs
-
-RS_DEBUGGER_NONE = 0  # Dont run under the debugger.
-RS_DEBUGGER_STEP = 1  # Start stepping under the debugger
-RS_DEBUGGER_GO = 2  # Just run under the debugger, stopping only at break-points.
-RS_DEBUGGER_PM = 3  # Dont run under debugger, but do post-mortem analysis on exception.
-
-debugging_options = """No debugging
-Step-through in the debugger
-Run in the debugger
-Post-Mortem of unhandled exceptions""".split(
-    "\n"
-)
-
-byte_cr = "\r".encode("ascii")
-byte_lf = "\n".encode("ascii")
-byte_crlf = "\r\n".encode("ascii")
-
-
-# A dialog box for the "Run Script" command.
-class DlgRunScript(dialog.Dialog):
-    "A class for the 'run script' dialog"
-
-    def __init__(self, bHaveDebugger):
-        dialog.Dialog.__init__(self, win32ui.IDD_RUN_SCRIPT)
-        self.AddDDX(win32ui.IDC_EDIT1, "script")
-        self.AddDDX(win32ui.IDC_EDIT2, "args")
-        self.AddDDX(win32ui.IDC_COMBO1, "debuggingType", "i")
-        self.HookCommand(self.OnBrowse, win32ui.IDC_BUTTON2)
-        self.bHaveDebugger = bHaveDebugger
-
-    def OnInitDialog(self):
-        rc = dialog.Dialog.OnInitDialog(self)
-        cbo = self.GetDlgItem(win32ui.IDC_COMBO1)
-        for o in debugging_options:
-            cbo.AddString(o)
-        cbo.SetCurSel(self["debuggingType"])
-        if not self.bHaveDebugger:
-            cbo.EnableWindow(0)
-
-    def OnBrowse(self, id, code):
-        if code != 0:  # BN_CLICKED
-            return 1
-        openFlags = win32con.OFN_OVERWRITEPROMPT | win32con.OFN_FILEMUSTEXIST
-        dlg = win32ui.CreateFileDialog(
-            1, None, None, openFlags, "Python Scripts (*.py)|*.py||", self
-        )
-        dlg.SetOFNTitle("Run Script")
-        if dlg.DoModal() != win32con.IDOK:
-            return 0
-        self["script"] = dlg.GetPathName()
-        self.UpdateData(0)
-        return 0
-
-
-def GetDebugger():
-    """Get the default Python debugger.  Returns the debugger, or None.
-
-    It is assumed the debugger has a standard "pdb" defined interface.
-    Currently always returns the 'pywin.debugger' debugger, or None
-    (pdb is _not_ returned as it is not effective in this GUI environment)
-    """
-    try:
-        import pywin.debugger
-
-        return pywin.debugger
-    except ImportError:
-        return None
-
-
-def IsOnPythonPath(path):
-    "Given a path only, see if it is on the Pythonpath.  Assumes path is a full path spec."
-    # must check that the command line arg's path is in sys.path
-    for syspath in sys.path:
-        try:
-            # Python 1.5 and later allows an empty sys.path entry.
-            if syspath and win32ui.FullPath(syspath) == path:
-                return 1
-        except win32ui.error as details:
-            print(
-                "Warning: The sys.path entry '%s' is invalid\n%s" % (syspath, details)
-            )
-    return 0
-
-
-def GetPackageModuleName(fileName):
-    """Given a filename, return (module name, new path).
-    eg - given "c:\a\b\c\my.py", return ("b.c.my",None) if "c:\a" is on sys.path.
-    If no package found, will return ("my", "c:\a\b\c")
-    """
-    path, fname = os.path.split(fileName)
-    path = origPath = win32ui.FullPath(path)
-    fname = os.path.splitext(fname)[0]
-    modBits = []
-    newPathReturn = None
-    if not IsOnPythonPath(path):
-        # Module not directly on the search path - see if under a package.
-        while len(path) > 3:  # ie 'C:\'
-            path, modBit = os.path.split(path)
-            modBits.append(modBit)
-            # If on path, _and_ existing package of that name loaded.
-            if (
-                IsOnPythonPath(path)
-                and modBit in sys.modules
-                and (
-                    os.path.exists(os.path.join(path, modBit, "__init__.py"))
-                    or os.path.exists(os.path.join(path, modBit, "__init__.pyc"))
-                    or os.path.exists(os.path.join(path, modBit, "__init__.pyo"))
-                )
-            ):
-                modBits.reverse()
-                return ".".join(modBits) + "." + fname, newPathReturn
-            # Not found - look a level higher
-        else:
-            newPathReturn = origPath
-
-    return fname, newPathReturn
-
-
-def GetActiveView():
-    """Gets the edit control (eg, EditView) with the focus, or None"""
-    try:
-        childFrame, bIsMaximised = win32ui.GetMainFrame().MDIGetActive()
-        return childFrame.GetActiveView()
-    except win32ui.error:
-        return None
-
-
-def GetActiveEditControl():
-    view = GetActiveView()
-    if view is None:
-        return None
-    if hasattr(view, "SCIAddText"):  # Is it a scintilla control?
-        return view
-    try:
-        return view.GetRichEditCtrl()
-    except AttributeError:
-        pass
-    try:
-        return view.GetEditCtrl()
-    except AttributeError:
-        pass
-
-
-def GetActiveEditorDocument():
-    """Returns the active editor document and view, or (None,None) if no
-    active document or its not an editor document.
-    """
-    view = GetActiveView()
-    if view is None or isinstance(view, TreeView):
-        return (None, None)
-    doc = view.GetDocument()
-    if hasattr(doc, "MarkerAdd"):  # Is it an Editor document?
-        return doc, view
-    return (None, None)
-
-
-def GetActiveFileName(bAutoSave=1):
-    """Gets the file name for the active frame, saving it if necessary.
-
-    Returns None if it cant be found, or raises KeyboardInterrupt.
-    """
-    pathName = None
-    active = GetActiveView()
-    if active is None:
-        return None
-    try:
-        doc = active.GetDocument()
-        pathName = doc.GetPathName()
-
-        if bAutoSave and (
-            len(pathName) > 0
-            or doc.GetTitle()[:8] == "Untitled"
-            or doc.GetTitle()[:6] == "Script"
-        ):  # if not a special purpose window
-            if doc.IsModified():
-                try:
-                    doc.OnSaveDocument(pathName)
-                    pathName = doc.GetPathName()
-
-                    # clear the linecache buffer
-                    linecache.clearcache()
-
-                except win32ui.error:
-                    raise KeyboardInterrupt
-
-    except (win32ui.error, AttributeError):
-        pass
-    if not pathName:
-        return None
-    return pathName
-
-
-lastScript = ""
-lastArgs = ""
-lastDebuggingType = RS_DEBUGGER_NONE
-
-
-def RunScript(defName=None, defArgs=None, bShowDialog=1, debuggingType=None):
-    global lastScript, lastArgs, lastDebuggingType
-    _debugger_stop_frame_ = 1  # Magic variable so the debugger will hide me!
-
-    # Get the debugger - may be None!
-    debugger = GetDebugger()
-
-    if defName is None:
-        try:
-            pathName = GetActiveFileName()
-        except KeyboardInterrupt:
-            return  # User cancelled save.
-    else:
-        pathName = defName
-    if not pathName:
-        pathName = lastScript
-    if defArgs is None:
-        args = ""
-        if pathName == lastScript:
-            args = lastArgs
-    else:
-        args = defArgs
-    if debuggingType is None:
-        debuggingType = lastDebuggingType
-
-    if not pathName or bShowDialog:
-        dlg = DlgRunScript(debugger is not None)
-        dlg["script"] = pathName
-        dlg["args"] = args
-        dlg["debuggingType"] = debuggingType
-        if dlg.DoModal() != win32con.IDOK:
-            return
-        script = dlg["script"]
-        args = dlg["args"]
-        debuggingType = dlg["debuggingType"]
-        if not script:
-            return
-        if debuggingType == RS_DEBUGGER_GO and debugger is not None:
-            # This may surprise users - they select "Run under debugger", but
-            # it appears not to!  Only warn when they pick from the dialog!
-            # First - ensure the debugger is activated to pickup any break-points
-            # set in the editor.
-            try:
-                # Create the debugger, but _dont_ init the debugger GUI.
-                rd = debugger._GetCurrentDebugger()
-            except AttributeError:
-                rd = None
-            if rd is not None and len(rd.breaks) == 0:
-                msg = "There are no active break-points.\r\n\r\nSelecting this debug option without any\r\nbreak-points is unlikely to have the desired effect\r\nas the debugger is unlikely to be invoked..\r\n\r\nWould you like to step-through in the debugger instead?"
-                rc = win32ui.MessageBox(
-                    msg,
-                    win32ui.LoadString(win32ui.IDR_DEBUGGER),
-                    win32con.MB_YESNOCANCEL | win32con.MB_ICONINFORMATION,
-                )
-                if rc == win32con.IDCANCEL:
-                    return
-                if rc == win32con.IDYES:
-                    debuggingType = RS_DEBUGGER_STEP
-
-        lastDebuggingType = debuggingType
-        lastScript = script
-        lastArgs = args
-    else:
-        script = pathName
-
-    # try and open the script.
-    if (
-        len(os.path.splitext(script)[1]) == 0
-    ):  # check if no extension supplied, and give one.
-        script = script + ".py"
-    # If no path specified, try and locate the file
-    path, fnameonly = os.path.split(script)
-    if len(path) == 0:
-        try:
-            os.stat(fnameonly)  # See if it is OK as is...
-            script = fnameonly
-        except os.error:
-            fullScript = LocatePythonFile(script)
-            if fullScript is None:
-                win32ui.MessageBox("The file '%s' can not be located" % script)
-                return
-            script = fullScript
-    else:
-        path = win32ui.FullPath(path)
-        if not IsOnPythonPath(path):
-            sys.path.append(path)
-
-    # py3k fun: If we use text mode to open the file, we get \r\n
-    # translated so Python allows the syntax (good!), but we get back
-    # text already decoded from the default encoding (bad!) and Python
-    # ignores any encoding decls (bad!).  If we use binary mode we get
-    # the raw bytes and Python looks at the encoding (good!) but \r\n
-    # chars stay in place so Python throws a syntax error (bad!).
-    # So: so the binary thing and manually normalize \r\n.
-    try:
-        f = open(script, "rb")
-    except IOError as exc:
-        win32ui.MessageBox(
-            "The file could not be opened - %s (%d)" % (exc.strerror, exc.errno)
-        )
-        return
-
-    # Get the source-code - as above, normalize \r\n
-    code = f.read().replace(byte_crlf, byte_lf).replace(byte_cr, byte_lf) + byte_lf
-
-    # Remember and hack sys.argv for the script.
-    oldArgv = sys.argv
-    sys.argv = ParseArgs(args)
-    sys.argv.insert(0, script)
-    # sys.path[0] is the path of the script
-    oldPath0 = sys.path[0]
-    newPath0 = os.path.split(script)[0]
-    if not oldPath0:  # if sys.path[0] is empty
-        sys.path[0] = newPath0
-        insertedPath0 = 0
-    else:
-        sys.path.insert(0, newPath0)
-        insertedPath0 = 1
-    bWorked = 0
-    win32ui.DoWaitCursor(1)
-    base = os.path.split(script)[1]
-    # Allow windows to repaint before starting.
-    win32ui.PumpWaitingMessages()
-    win32ui.SetStatusText("Running script %s..." % base, 1)
-    exitCode = 0
-    from pywin.framework import interact
-
-    # Check the debugger flags
-    if debugger is None and (debuggingType != RS_DEBUGGER_NONE):
-        win32ui.MessageBox(
-            "No debugger is installed.  Debugging options have been ignored!"
-        )
-        debuggingType = RS_DEBUGGER_NONE
-
-    # Get a code object - ignore the debugger for this, as it is probably a syntax error
-    # at this point
-    try:
-        codeObject = compile(code, script, "exec")
-    except:
-        # Almost certainly a syntax error!
-        _HandlePythonFailure("run script", script)
-        # No code object which to run/debug.
-        return
-    __main__.__file__ = script
-    try:
-        if debuggingType == RS_DEBUGGER_STEP:
-            debugger.run(codeObject, __main__.__dict__, start_stepping=1)
-        elif debuggingType == RS_DEBUGGER_GO:
-            debugger.run(codeObject, __main__.__dict__, start_stepping=0)
-        else:
-            # Post mortem or no debugging
-            exec(codeObject, __main__.__dict__)
-        bWorked = 1
-    except bdb.BdbQuit:
-        # Dont print tracebacks when the debugger quit, but do print a message.
-        print("Debugging session cancelled.")
-        exitCode = 1
-        bWorked = 1
-    except SystemExit as code:
-        exitCode = code
-        bWorked = 1
-    except KeyboardInterrupt:
-        # Consider this successful, as we dont want the debugger.
-        # (but we do want a traceback!)
-        if interact.edit and interact.edit.currentView:
-            interact.edit.currentView.EnsureNoPrompt()
-        traceback.print_exc()
-        if interact.edit and interact.edit.currentView:
-            interact.edit.currentView.AppendToPrompt([])
-        bWorked = 1
-    except:
-        if interact.edit and interact.edit.currentView:
-            interact.edit.currentView.EnsureNoPrompt()
-        traceback.print_exc()
-        if interact.edit and interact.edit.currentView:
-            interact.edit.currentView.AppendToPrompt([])
-        if debuggingType == RS_DEBUGGER_PM:
-            debugger.pm()
-    del __main__.__file__
-    sys.argv = oldArgv
-    if insertedPath0:
-        del sys.path[0]
-    else:
-        sys.path[0] = oldPath0
-    f.close()
-    if bWorked:
-        win32ui.SetStatusText("Script '%s' returned exit code %s" % (script, exitCode))
-    else:
-        win32ui.SetStatusText("Exception raised while running script  %s" % base)
-    try:
-        sys.stdout.flush()
-    except AttributeError:
-        pass
-
-    win32ui.DoWaitCursor(0)
-
-
-def ImportFile():
-    """This code looks for the current window, and determines if it can be imported.  If not,
-    it will prompt for a file name, and allow it to be imported."""
-    try:
-        pathName = GetActiveFileName()
-    except KeyboardInterrupt:
-        pathName = None
-
-    if pathName is not None:
-        if os.path.splitext(pathName)[1].lower() not in (".py", ".pyw", ".pyx"):
-            pathName = None
-
-    if pathName is None:
-        openFlags = win32con.OFN_OVERWRITEPROMPT | win32con.OFN_FILEMUSTEXIST
-        dlg = win32ui.CreateFileDialog(
-            1, None, None, openFlags, "Python Scripts (*.py;*.pyw)|*.py;*.pyw;*.pyx||"
-        )
-        dlg.SetOFNTitle("Import Script")
-        if dlg.DoModal() != win32con.IDOK:
-            return 0
-
-        pathName = dlg.GetPathName()
-
-    # If already imported, dont look for package
-    path, modName = os.path.split(pathName)
-    modName, modExt = os.path.splitext(modName)
-    newPath = None
-    # note that some packages (*cough* email *cough*) use "lazy importers"
-    # meaning sys.modules can change as a side-effect of looking at
-    # module.__file__ - so we must take a copy (ie, items() in py2k,
-    # list(items()) in py3k)
-    for key, mod in list(sys.modules.items()):
-        if getattr(mod, "__file__", None):
-            fname = mod.__file__
-            base, ext = os.path.splitext(fname)
-            if ext.lower() in (".pyo", ".pyc"):
-                ext = ".py"
-            fname = base + ext
-            if win32ui.ComparePath(fname, pathName):
-                modName = key
-                break
-    else:  # for not broken
-        modName, newPath = GetPackageModuleName(pathName)
-        if newPath:
-            sys.path.append(newPath)
-
-    if modName in sys.modules:
-        bNeedReload = 1
-        what = "reload"
-    else:
-        what = "import"
-        bNeedReload = 0
-
-    win32ui.SetStatusText(what.capitalize() + "ing module...", 1)
-    win32ui.DoWaitCursor(1)
-    # 	win32ui.GetMainFrame().BeginWaitCursor()
-
-    try:
-        # always do an import, as it is cheap if it's already loaded.  This ensures
-        # it is in our name space.
-        codeObj = compile("import " + modName, "<auto import>", "exec")
-    except SyntaxError:
-        win32ui.SetStatusText('Invalid filename for import: "' + modName + '"')
-        return
-    try:
-        exec(codeObj, __main__.__dict__)
-        mod = sys.modules.get(modName)
-        if bNeedReload:
-            from importlib import reload
-
-            mod = reload(sys.modules[modName])
-        win32ui.SetStatusText(
-            "Successfully "
-            + what
-            + "ed module '"
-            + modName
-            + "': %s" % getattr(mod, "__file__", "<unkown file>")
-        )
-    except:
-        _HandlePythonFailure(what)
-    win32ui.DoWaitCursor(0)
-
-
-def CheckFile():
-    """This code looks for the current window, and gets Python to check it
-    without actually executing any code (ie, by compiling only)
-    """
-    try:
-        pathName = GetActiveFileName()
-    except KeyboardInterrupt:
-        return
-
-    what = "check"
-    win32ui.SetStatusText(what.capitalize() + "ing module...", 1)
-    win32ui.DoWaitCursor(1)
-    try:
-        f = open(pathName)
-    except IOError as details:
-        print("Cant open file '%s' - %s" % (pathName, details))
-        return
-    try:
-        code = f.read() + "\n"
-    finally:
-        f.close()
-    try:
-        codeObj = compile(code, pathName, "exec")
-        if RunTabNanny(pathName):
-            win32ui.SetStatusText(
-                "Python and the TabNanny successfully checked the file '"
-                + os.path.basename(pathName)
-                + "'"
-            )
-    except SyntaxError:
-        _HandlePythonFailure(what, pathName)
-    except:
-        traceback.print_exc()
-        _HandlePythonFailure(what)
-    win32ui.DoWaitCursor(0)
-
-
-def RunTabNanny(filename):
-    import io as io
-
-    tabnanny = FindTabNanny()
-    if tabnanny is None:
-        win32ui.MessageBox("The TabNanny is not around, so the children can run amok!")
-        return
-
-    # Capture the tab-nanny output
-    newout = io.StringIO()
-    old_out = sys.stderr, sys.stdout
-    sys.stderr = sys.stdout = newout
-    try:
-        tabnanny.check(filename)
-    finally:
-        # Restore output
-        sys.stderr, sys.stdout = old_out
-    data = newout.getvalue()
-    if data:
-        try:
-            lineno = data.split()[1]
-            lineno = int(lineno)
-            _JumpToPosition(filename, lineno)
-            try:  # Try and display whitespace
-                GetActiveEditControl().SCISetViewWS(1)
-            except:
-                pass
-            win32ui.SetStatusText("The TabNanny found trouble at line %d" % lineno)
-        except (IndexError, TypeError, ValueError):
-            print("The tab nanny complained, but I cant see where!")
-            print(data)
-        return 0
-    return 1
-
-
-def _JumpToPosition(fileName, lineno, col=1):
-    JumpToDocument(fileName, lineno, col)
-
-
-def JumpToDocument(fileName, lineno=0, col=1, nChars=0, bScrollToTop=0):
-    # Jump to the position in a file.
-    # If lineno is <= 0, dont move the position - just open/restore.
-    # if nChars > 0, select that many characters.
-    # if bScrollToTop, the specified line will be moved to the top of the window
-    #  (eg, bScrollToTop should be false when jumping to an error line to retain the
-    #  context, but true when jumping to a method defn, where we want the full body.
-    # Return the view which is editing the file, or None on error.
-    doc = win32ui.GetApp().OpenDocumentFile(fileName)
-    if doc is None:
-        return None
-    frame = doc.GetFirstView().GetParentFrame()
-    try:
-        view = frame.GetEditorView()
-        if frame.GetActiveView() != view:
-            frame.SetActiveView(view)
-        frame.AutoRestore()
-    except AttributeError:  # Not an editor frame??
-        view = doc.GetFirstView()
-    if lineno > 0:
-        charNo = view.LineIndex(lineno - 1)
-        start = charNo + col - 1
-        size = view.GetTextLength()
-        try:
-            view.EnsureCharsVisible(charNo)
-        except AttributeError:
-            print("Doesnt appear to be one of our views?")
-        view.SetSel(min(start, size), min(start + nChars, size))
-    if bScrollToTop:
-        curTop = view.GetFirstVisibleLine()
-        nScroll = (lineno - 1) - curTop
-        view.LineScroll(nScroll, 0)
-    view.SetFocus()
-    return view
-
-
-def _HandlePythonFailure(what, syntaxErrorPathName=None):
-    typ, details, tb = sys.exc_info()
-    if isinstance(details, SyntaxError):
-        try:
-            msg, (fileName, line, col, text) = details
-            if (not fileName or fileName == "<string>") and syntaxErrorPathName:
-                fileName = syntaxErrorPathName
-            _JumpToPosition(fileName, line, col)
-        except (TypeError, ValueError):
-            msg = str(details)
-        win32ui.SetStatusText("Failed to " + what + " - syntax error - %s" % msg)
-    else:
-        traceback.print_exc()
-        win32ui.SetStatusText("Failed to " + what + " - " + str(details))
-    tb = None  # Clean up a cycle.
-
-
-# Find the Python TabNanny in either the standard library or the Python Tools/Scripts directory.
-def FindTabNanny():
-    try:
-        return __import__("tabnanny")
-    except ImportError:
-        pass
-    # OK - not in the standard library - go looking.
-    filename = "tabnanny.py"
-    try:
-        path = win32api.RegQueryValue(
-            win32con.HKEY_LOCAL_MACHINE,
-            "SOFTWARE\\Python\\PythonCore\\%s\\InstallPath" % (sys.winver),
-        )
-    except win32api.error:
-        print("WARNING - The Python registry does not have an 'InstallPath' setting")
-        print("          The file '%s' can not be located" % (filename))
-        return None
-    fname = os.path.join(path, "Tools\\Scripts\\%s" % filename)
-    try:
-        os.stat(fname)
-    except os.error:
-        print(
-            "WARNING - The file '%s' can not be located in path '%s'" % (filename, path)
-        )
-        return None
-
-    tabnannyhome, tabnannybase = os.path.split(fname)
-    tabnannybase = os.path.splitext(tabnannybase)[0]
-    # Put tab nanny at the top of the path.
-    sys.path.insert(0, tabnannyhome)
-    try:
-        return __import__(tabnannybase)
-    finally:
-        # remove the tab-nanny from the path
-        del sys.path[0]
-
-
-def LocatePythonFile(fileName, bBrowseIfDir=1):
-    "Given a file name, return a fully qualified file name, or None"
-    # first look for the exact file as specified
-    if not os.path.isfile(fileName):
-        # Go looking!
-        baseName = fileName
-        for path in sys.path:
-            fileName = os.path.abspath(os.path.join(path, baseName))
-            if os.path.isdir(fileName):
-                if bBrowseIfDir:
-                    d = win32ui.CreateFileDialog(
-                        1, "*.py", None, 0, "Python Files (*.py)|*.py|All files|*.*"
-                    )
-                    d.SetOFNInitialDir(fileName)
-                    rc = d.DoModal()
-                    if rc == win32con.IDOK:
-                        fileName = d.GetPathName()
-                        break
-                    else:
-                        return None
-            else:
-                fileName = fileName + ".py"
-                if os.path.isfile(fileName):
-                    break  # Found it!
-
-        else:  # for not broken out of
-            return None
-    return win32ui.FullPath(fileName)
diff --git a/lib/pythonwin/pywin/framework/sgrepmdi.py b/lib/pythonwin/pywin/framework/sgrepmdi.py
deleted file mode 100644
index b7d938bb..00000000
--- a/lib/pythonwin/pywin/framework/sgrepmdi.py
+++ /dev/null
@@ -1,758 +0,0 @@
-# SGrepMDI is by Gordon McMillan (gmcm@hypernet.com)
-# It does basically what Find In Files does in MSVC with a couple enhancements.
-# - It saves any directories in the app's ini file (if you want to get rid
-# 	of them you'll have to edit the file)
-# - "Directories" can be directories,
-#  -	semicolon separated lists of "directories",
-#  -	environment variables that evaluate to "directories",
-#  -	registry path names that evaluate to "directories",
-#  -	all of which is recursive, so you can mix them all up.
-# - It is MDI, so you can 'nest' greps and return to earlier ones,
-# 	(ie, have multiple results open at the same time)
-# - Like FIF, double clicking a line opens an editor and takes you to the line.
-# - You can highlight text, right click and start a new grep with the selected
-# 	text as search pattern and same directories etc as before.
-# - You can save grep parameters (so you don't lose your hardearned pattern)
-# 	from File|Save
-# - You can save grep results by right clicking in the result window.
-# Hats off to Mark Hammond for providing an environment where I could cobble
-# something like this together in a couple evenings!
-
-import glob
-import os
-import re
-
-import win32api
-import win32con
-import win32ui
-from pywin.mfc import dialog, docview, window
-
-from . import scriptutils
-
-
-def getsubdirs(d):
-    dlist = []
-    flist = glob.glob(d + "\\*")
-    for f in flist:
-        if os.path.isdir(f):
-            dlist.append(f)
-            dlist = dlist + getsubdirs(f)
-    return dlist
-
-
-class dirpath:
-    def __init__(self, str, recurse=0):
-        dp = str.split(";")
-        dirs = {}
-        for d in dp:
-            if os.path.isdir(d):
-                d = d.lower()
-                if d not in dirs:
-                    dirs[d] = None
-                    if recurse:
-                        subdirs = getsubdirs(d)
-                        for sd in subdirs:
-                            sd = sd.lower()
-                            if sd not in dirs:
-                                dirs[sd] = None
-            elif os.path.isfile(d):
-                pass
-            else:
-                x = None
-                if d in os.environ:
-                    x = dirpath(os.environ[d])
-                elif d[:5] == "HKEY_":
-                    keystr = d.split("\\")
-                    try:
-                        root = eval("win32con." + keystr[0])
-                    except:
-                        win32ui.MessageBox(
-                            "Can't interpret registry key name '%s'" % keystr[0]
-                        )
-                    try:
-                        subkey = "\\".join(keystr[1:])
-                        val = win32api.RegQueryValue(root, subkey)
-                        if val:
-                            x = dirpath(val)
-                        else:
-                            win32ui.MessageBox(
-                                "Registry path '%s' did not return a path entry" % d
-                            )
-                    except:
-                        win32ui.MessageBox(
-                            "Can't interpret registry key value: %s" % keystr[1:]
-                        )
-                else:
-                    win32ui.MessageBox("Directory '%s' not found" % d)
-                if x:
-                    for xd in x:
-                        if xd not in dirs:
-                            dirs[xd] = None
-                            if recurse:
-                                subdirs = getsubdirs(xd)
-                                for sd in subdirs:
-                                    sd = sd.lower()
-                                    if sd not in dirs:
-                                        dirs[sd] = None
-        self.dirs = []
-        for d in list(dirs.keys()):
-            self.dirs.append(d)
-
-    def __getitem__(self, key):
-        return self.dirs[key]
-
-    def __len__(self):
-        return len(self.dirs)
-
-    def __setitem__(self, key, value):
-        self.dirs[key] = value
-
-    def __delitem__(self, key):
-        del self.dirs[key]
-
-    def __getslice__(self, lo, hi):
-        return self.dirs[lo:hi]
-
-    def __setslice__(self, lo, hi, seq):
-        self.dirs[lo:hi] = seq
-
-    def __delslice__(self, lo, hi):
-        del self.dirs[lo:hi]
-
-    def __add__(self, other):
-        if type(other) == type(self) or type(other) == type([]):
-            return self.dirs + other.dirs
-
-    def __radd__(self, other):
-        if type(other) == type(self) or type(other) == type([]):
-            return other.dirs + self.dirs
-
-
-# Group(1) is the filename, group(2) is the lineno.
-# regexGrepResult=regex.compile("^\\([a-zA-Z]:.*\\)(\\([0-9]+\\))")
-
-regexGrep = re.compile(r"^([a-zA-Z]:[^(]*)\(([0-9]+)\)")
-
-# these are the atom numbers defined by Windows for basic dialog controls
-
-BUTTON = 0x80
-EDIT = 0x81
-STATIC = 0x82
-LISTBOX = 0x83
-SCROLLBAR = 0x84
-COMBOBOX = 0x85
-
-
-class GrepTemplate(docview.RichEditDocTemplate):
-    def __init__(self):
-        docview.RichEditDocTemplate.__init__(
-            self, win32ui.IDR_TEXTTYPE, GrepDocument, GrepFrame, GrepView
-        )
-        self.SetDocStrings("\nGrep\nGrep\nGrep params (*.grep)\n.grep\n\n\n")
-        win32ui.GetApp().AddDocTemplate(self)
-        self.docparams = None
-
-    def MatchDocType(self, fileName, fileType):
-        doc = self.FindOpenDocument(fileName)
-        if doc:
-            return doc
-        ext = os.path.splitext(fileName)[1].lower()
-        if ext == ".grep":
-            return win32ui.CDocTemplate_Confidence_yesAttemptNative
-        return win32ui.CDocTemplate_Confidence_noAttempt
-
-    def setParams(self, params):
-        self.docparams = params
-
-    def readParams(self):
-        tmp = self.docparams
-        self.docparams = None
-        return tmp
-
-
-class GrepFrame(window.MDIChildWnd):
-    # The template and doc params will one day be removed.
-    def __init__(self, wnd=None):
-        window.MDIChildWnd.__init__(self, wnd)
-
-
-class GrepDocument(docview.RichEditDoc):
-    def __init__(self, template):
-        docview.RichEditDoc.__init__(self, template)
-        self.dirpattern = ""
-        self.filpattern = ""
-        self.greppattern = ""
-        self.casesensitive = 1
-        self.recurse = 1
-        self.verbose = 0
-
-    def OnOpenDocument(self, fnm):
-        # this bizarre stuff with params is so right clicking in a result window
-        # and starting a new grep can communicate the default parameters to the
-        # new grep.
-        try:
-            params = open(fnm, "r").read()
-        except:
-            params = None
-        self.setInitParams(params)
-        return self.OnNewDocument()
-
-    def OnCloseDocument(self):
-        try:
-            win32ui.GetApp().DeleteIdleHandler(self.SearchFile)
-        except:
-            pass
-        return self._obj_.OnCloseDocument()
-
-    def saveInitParams(self):
-        # Only save the flags, not the text boxes.
-        paramstr = "\t%s\t\t%d\t%d" % (
-            self.filpattern,
-            self.casesensitive,
-            self.recurse,
-        )
-        win32ui.WriteProfileVal("Grep", "Params", paramstr)
-
-    def setInitParams(self, paramstr):
-        if paramstr is None:
-            paramstr = win32ui.GetProfileVal("Grep", "Params", "\t\t\t1\t0\t0")
-        params = paramstr.split("\t")
-        if len(params) < 3:
-            params = params + [""] * (3 - len(params))
-        if len(params) < 6:
-            params = params + [0] * (6 - len(params))
-        self.dirpattern = params[0]
-        self.filpattern = params[1]
-        self.greppattern = params[2]
-        self.casesensitive = int(params[3])
-        self.recurse = int(params[4])
-        self.verbose = int(params[5])
-        # setup some reasonable defaults.
-        if not self.dirpattern:
-            try:
-                editor = win32ui.GetMainFrame().MDIGetActive()[0].GetEditorView()
-                self.dirpattern = os.path.abspath(
-                    os.path.dirname(editor.GetDocument().GetPathName())
-                )
-            except (AttributeError, win32ui.error):
-                self.dirpattern = os.getcwd()
-        if not self.filpattern:
-            self.filpattern = "*.py"
-
-    def OnNewDocument(self):
-        if self.dirpattern == "":
-            self.setInitParams(greptemplate.readParams())
-        d = GrepDialog(
-            self.dirpattern,
-            self.filpattern,
-            self.greppattern,
-            self.casesensitive,
-            self.recurse,
-            self.verbose,
-        )
-        if d.DoModal() == win32con.IDOK:
-            self.dirpattern = d["dirpattern"]
-            self.filpattern = d["filpattern"]
-            self.greppattern = d["greppattern"]
-            self.casesensitive = d["casesensitive"]
-            self.recurse = d["recursive"]
-            self.verbose = d["verbose"]
-            self.doSearch()
-            self.saveInitParams()
-            return 1
-        return 0  # cancelled - return zero to stop frame creation.
-
-    def doSearch(self):
-        self.dp = dirpath(self.dirpattern, self.recurse)
-        self.SetTitle("Grep for %s in %s" % (self.greppattern, self.filpattern))
-        # self.text = []
-        self.GetFirstView().Append("#Search " + self.dirpattern + "\n")
-        if self.verbose:
-            self.GetFirstView().Append("#   =" + repr(self.dp.dirs) + "\n")
-        self.GetFirstView().Append("# Files " + self.filpattern + "\n")
-        self.GetFirstView().Append("#   For " + self.greppattern + "\n")
-        self.fplist = self.filpattern.split(";")
-        if self.casesensitive:
-            self.pat = re.compile(self.greppattern)
-        else:
-            self.pat = re.compile(self.greppattern, re.IGNORECASE)
-        win32ui.SetStatusText("Searching.  Please wait...", 0)
-        self.dpndx = self.fpndx = 0
-        self.fndx = -1
-        if not self.dp:
-            self.GetFirstView().Append(
-                "# ERROR: '%s' does not resolve to any search locations"
-                % self.dirpattern
-            )
-            self.SetModifiedFlag(0)
-        else:
-            self.flist = glob.glob(self.dp[0] + "\\" + self.fplist[0])
-            win32ui.GetApp().AddIdleHandler(self.SearchFile)
-
-    def SearchFile(self, handler, count):
-        self.fndx = self.fndx + 1
-        if self.fndx < len(self.flist):
-            f = self.flist[self.fndx]
-            if self.verbose:
-                self.GetFirstView().Append("# .." + f + "\n")
-            # Directories may match the file type pattern, and files may be removed
-            #  while grep is running
-            if os.path.isfile(f):
-                win32ui.SetStatusText("Searching " + f, 0)
-                lines = open(f, "r").readlines()
-                for i in range(len(lines)):
-                    line = lines[i]
-                    if self.pat.search(line) != None:
-                        self.GetFirstView().Append(f + "(" + repr(i + 1) + ") " + line)
-        else:
-            self.fndx = -1
-            self.fpndx = self.fpndx + 1
-            if self.fpndx < len(self.fplist):
-                self.flist = glob.glob(
-                    self.dp[self.dpndx] + "\\" + self.fplist[self.fpndx]
-                )
-            else:
-                self.fpndx = 0
-                self.dpndx = self.dpndx + 1
-                if self.dpndx < len(self.dp):
-                    self.flist = glob.glob(
-                        self.dp[self.dpndx] + "\\" + self.fplist[self.fpndx]
-                    )
-                else:
-                    win32ui.SetStatusText("Search complete.", 0)
-                    self.SetModifiedFlag(0)  # default to not modified.
-                    try:
-                        win32ui.GetApp().DeleteIdleHandler(self.SearchFile)
-                    except:
-                        pass
-                    return 0
-        return 1
-
-    def GetParams(self):
-        return (
-            self.dirpattern
-            + "\t"
-            + self.filpattern
-            + "\t"
-            + self.greppattern
-            + "\t"
-            + repr(self.casesensitive)
-            + "\t"
-            + repr(self.recurse)
-            + "\t"
-            + repr(self.verbose)
-        )
-
-    def OnSaveDocument(self, filename):
-        # 		print 'OnSaveDocument() filename=',filename
-        savefile = open(filename, "wb")
-        txt = self.GetParams() + "\n"
-        # 		print 'writing',txt
-        savefile.write(txt)
-        savefile.close()
-        self.SetModifiedFlag(0)
-        return 1
-
-
-ID_OPEN_FILE = 0xE400
-ID_GREP = 0xE401
-ID_SAVERESULTS = 0x402
-ID_TRYAGAIN = 0x403
-
-
-class GrepView(docview.RichEditView):
-    def __init__(self, doc):
-        docview.RichEditView.__init__(self, doc)
-        self.SetWordWrap(win32ui.CRichEditView_WrapNone)
-        self.HookHandlers()
-
-    def OnInitialUpdate(self):
-        rc = self._obj_.OnInitialUpdate()
-        format = (-402653169, 0, 200, 0, 0, 0, 49, "Courier New")
-        self.SetDefaultCharFormat(format)
-        return rc
-
-    def HookHandlers(self):
-        self.HookMessage(self.OnRClick, win32con.WM_RBUTTONDOWN)
-        self.HookCommand(self.OnCmdOpenFile, ID_OPEN_FILE)
-        self.HookCommand(self.OnCmdGrep, ID_GREP)
-        self.HookCommand(self.OnCmdSave, ID_SAVERESULTS)
-        self.HookCommand(self.OnTryAgain, ID_TRYAGAIN)
-        self.HookMessage(self.OnLDblClick, win32con.WM_LBUTTONDBLCLK)
-
-    def OnLDblClick(self, params):
-        line = self.GetLine()
-        regexGrepResult = regexGrep.match(line)
-        if regexGrepResult:
-            fname = regexGrepResult.group(1)
-            line = int(regexGrepResult.group(2))
-            scriptutils.JumpToDocument(fname, line)
-            return 0  # dont pass on
-        return 1  # pass it on by default.
-
-    def OnRClick(self, params):
-        menu = win32ui.CreatePopupMenu()
-        flags = win32con.MF_STRING | win32con.MF_ENABLED
-        lineno = self._obj_.LineFromChar(-1)  # selection or current line
-        line = self._obj_.GetLine(lineno)
-        regexGrepResult = regexGrep.match(line)
-        if regexGrepResult:
-            self.fnm = regexGrepResult.group(1)
-            self.lnnum = int(regexGrepResult.group(2))
-            menu.AppendMenu(flags, ID_OPEN_FILE, "&Open " + self.fnm)
-            menu.AppendMenu(win32con.MF_SEPARATOR)
-        menu.AppendMenu(flags, ID_TRYAGAIN, "&Try Again")
-        charstart, charend = self._obj_.GetSel()
-        if charstart != charend:
-            linestart = self._obj_.LineIndex(lineno)
-            self.sel = line[charstart - linestart : charend - linestart]
-            menu.AppendMenu(flags, ID_GREP, "&Grep for " + self.sel)
-            menu.AppendMenu(win32con.MF_SEPARATOR)
-        menu.AppendMenu(flags, win32ui.ID_EDIT_CUT, "Cu&t")
-        menu.AppendMenu(flags, win32ui.ID_EDIT_COPY, "&Copy")
-        menu.AppendMenu(flags, win32ui.ID_EDIT_PASTE, "&Paste")
-        menu.AppendMenu(flags, win32con.MF_SEPARATOR)
-        menu.AppendMenu(flags, win32ui.ID_EDIT_SELECT_ALL, "&Select all")
-        menu.AppendMenu(flags, win32con.MF_SEPARATOR)
-        menu.AppendMenu(flags, ID_SAVERESULTS, "Sa&ve results")
-        menu.TrackPopupMenu(params[5])
-        return 0
-
-    def OnCmdOpenFile(self, cmd, code):
-        doc = win32ui.GetApp().OpenDocumentFile(self.fnm)
-        if doc:
-            vw = doc.GetFirstView()
-            # hope you have an editor that implements GotoLine()!
-            try:
-                vw.GotoLine(int(self.lnnum))
-            except:
-                pass
-        return 0
-
-    def OnCmdGrep(self, cmd, code):
-        if code != 0:
-            return 1
-        curparamsstr = self.GetDocument().GetParams()
-        params = curparamsstr.split("\t")
-        params[2] = self.sel
-        greptemplate.setParams("\t".join(params))
-        greptemplate.OpenDocumentFile()
-        return 0
-
-    def OnTryAgain(self, cmd, code):
-        if code != 0:
-            return 1
-        greptemplate.setParams(self.GetDocument().GetParams())
-        greptemplate.OpenDocumentFile()
-        return 0
-
-    def OnCmdSave(self, cmd, code):
-        if code != 0:
-            return 1
-        flags = win32con.OFN_OVERWRITEPROMPT
-        dlg = win32ui.CreateFileDialog(
-            0, None, None, flags, "Text Files (*.txt)|*.txt||", self
-        )
-        dlg.SetOFNTitle("Save Results As")
-        if dlg.DoModal() == win32con.IDOK:
-            pn = dlg.GetPathName()
-            self._obj_.SaveTextFile(pn)
-        return 0
-
-    def Append(self, strng):
-        numlines = self.GetLineCount()
-        endpos = self.LineIndex(numlines - 1) + len(self.GetLine(numlines - 1))
-        self.SetSel(endpos, endpos)
-        self.ReplaceSel(strng)
-
-
-class GrepDialog(dialog.Dialog):
-    def __init__(self, dp, fp, gp, cs, r, v):
-        style = (
-            win32con.DS_MODALFRAME
-            | win32con.WS_POPUP
-            | win32con.WS_VISIBLE
-            | win32con.WS_CAPTION
-            | win32con.WS_SYSMENU
-            | win32con.DS_SETFONT
-        )
-        CS = win32con.WS_CHILD | win32con.WS_VISIBLE
-        tmp = [
-            ["Grep", (0, 0, 210, 90), style, None, (8, "MS Sans Serif")],
-        ]
-        tmp.append([STATIC, "Grep For:", -1, (7, 7, 50, 9), CS])
-        tmp.append(
-            [
-                EDIT,
-                gp,
-                101,
-                (52, 7, 144, 11),
-                CS | win32con.WS_TABSTOP | win32con.ES_AUTOHSCROLL | win32con.WS_BORDER,
-            ]
-        )
-        tmp.append([STATIC, "Directories:", -1, (7, 20, 50, 9), CS])
-        tmp.append(
-            [
-                EDIT,
-                dp,
-                102,
-                (52, 20, 128, 11),
-                CS | win32con.WS_TABSTOP | win32con.ES_AUTOHSCROLL | win32con.WS_BORDER,
-            ]
-        )
-        tmp.append(
-            [
-                BUTTON,
-                "...",
-                110,
-                (182, 20, 16, 11),
-                CS | win32con.BS_PUSHBUTTON | win32con.WS_TABSTOP,
-            ]
-        )
-        tmp.append([STATIC, "File types:", -1, (7, 33, 50, 9), CS])
-        tmp.append(
-            [
-                EDIT,
-                fp,
-                103,
-                (52, 33, 128, 11),
-                CS | win32con.WS_TABSTOP | win32con.ES_AUTOHSCROLL | win32con.WS_BORDER,
-            ]
-        )
-        tmp.append(
-            [
-                BUTTON,
-                "...",
-                111,
-                (182, 33, 16, 11),
-                CS | win32con.BS_PUSHBUTTON | win32con.WS_TABSTOP,
-            ]
-        )
-        tmp.append(
-            [
-                BUTTON,
-                "Case sensitive",
-                104,
-                (7, 45, 72, 9),
-                CS
-                | win32con.BS_AUTOCHECKBOX
-                | win32con.BS_LEFTTEXT
-                | win32con.WS_TABSTOP,
-            ]
-        )
-        tmp.append(
-            [
-                BUTTON,
-                "Subdirectories",
-                105,
-                (7, 56, 72, 9),
-                CS
-                | win32con.BS_AUTOCHECKBOX
-                | win32con.BS_LEFTTEXT
-                | win32con.WS_TABSTOP,
-            ]
-        )
-        tmp.append(
-            [
-                BUTTON,
-                "Verbose",
-                106,
-                (7, 67, 72, 9),
-                CS
-                | win32con.BS_AUTOCHECKBOX
-                | win32con.BS_LEFTTEXT
-                | win32con.WS_TABSTOP,
-            ]
-        )
-        tmp.append(
-            [
-                BUTTON,
-                "OK",
-                win32con.IDOK,
-                (166, 53, 32, 12),
-                CS | win32con.BS_DEFPUSHBUTTON | win32con.WS_TABSTOP,
-            ]
-        )
-        tmp.append(
-            [
-                BUTTON,
-                "Cancel",
-                win32con.IDCANCEL,
-                (166, 67, 32, 12),
-                CS | win32con.BS_PUSHBUTTON | win32con.WS_TABSTOP,
-            ]
-        )
-        dialog.Dialog.__init__(self, tmp)
-        self.AddDDX(101, "greppattern")
-        self.AddDDX(102, "dirpattern")
-        self.AddDDX(103, "filpattern")
-        self.AddDDX(104, "casesensitive")
-        self.AddDDX(105, "recursive")
-        self.AddDDX(106, "verbose")
-        self._obj_.data["greppattern"] = gp
-        self._obj_.data["dirpattern"] = dp
-        self._obj_.data["filpattern"] = fp
-        self._obj_.data["casesensitive"] = cs
-        self._obj_.data["recursive"] = r
-        self._obj_.data["verbose"] = v
-        self.HookCommand(self.OnMoreDirectories, 110)
-        self.HookCommand(self.OnMoreFiles, 111)
-
-    def OnMoreDirectories(self, cmd, code):
-        if code != 0:
-            return 1
-        self.getMore("Grep\\Directories", "dirpattern")
-
-    def OnMoreFiles(self, cmd, code):
-        if code != 0:
-            return 1
-        self.getMore("Grep\\File Types", "filpattern")
-
-    def getMore(self, section, key):
-        self.UpdateData(1)
-        # get the items out of the ini file
-        ini = win32ui.GetProfileFileName()
-        secitems = win32api.GetProfileSection(section, ini)
-        items = []
-        for secitem in secitems:
-            items.append(secitem.split("=")[1])
-        dlg = GrepParamsDialog(items)
-        if dlg.DoModal() == win32con.IDOK:
-            itemstr = ";".join(dlg.getItems())
-            self._obj_.data[key] = itemstr
-            # update the ini file with dlg.getNew()
-            i = 0
-            newitems = dlg.getNew()
-            if newitems:
-                items = items + newitems
-                for item in items:
-                    win32api.WriteProfileVal(section, repr(i), item, ini)
-                    i = i + 1
-            self.UpdateData(0)
-
-    def OnOK(self):
-        self.UpdateData(1)
-        for id, name in (
-            (101, "greppattern"),
-            (102, "dirpattern"),
-            (103, "filpattern"),
-        ):
-            if not self[name]:
-                self.GetDlgItem(id).SetFocus()
-                win32api.MessageBeep()
-                win32ui.SetStatusText("Please enter a value")
-                return
-        self._obj_.OnOK()
-
-
-class GrepParamsDialog(dialog.Dialog):
-    def __init__(self, items):
-        self.items = items
-        self.newitems = []
-        style = (
-            win32con.DS_MODALFRAME
-            | win32con.WS_POPUP
-            | win32con.WS_VISIBLE
-            | win32con.WS_CAPTION
-            | win32con.WS_SYSMENU
-            | win32con.DS_SETFONT
-        )
-        CS = win32con.WS_CHILD | win32con.WS_VISIBLE
-        tmp = [
-            ["Grep Parameters", (0, 0, 205, 100), style, None, (8, "MS Sans Serif")],
-        ]
-        tmp.append(
-            [
-                LISTBOX,
-                "",
-                107,
-                (7, 7, 150, 72),
-                CS
-                | win32con.LBS_MULTIPLESEL
-                | win32con.LBS_STANDARD
-                | win32con.LBS_HASSTRINGS
-                | win32con.WS_TABSTOP
-                | win32con.LBS_NOTIFY,
-            ]
-        )
-        tmp.append(
-            [
-                BUTTON,
-                "OK",
-                win32con.IDOK,
-                (167, 7, 32, 12),
-                CS | win32con.BS_DEFPUSHBUTTON | win32con.WS_TABSTOP,
-            ]
-        )
-        tmp.append(
-            [
-                BUTTON,
-                "Cancel",
-                win32con.IDCANCEL,
-                (167, 23, 32, 12),
-                CS | win32con.BS_PUSHBUTTON | win32con.WS_TABSTOP,
-            ]
-        )
-        tmp.append([STATIC, "New:", -1, (2, 83, 15, 12), CS])
-        tmp.append(
-            [
-                EDIT,
-                "",
-                108,
-                (18, 83, 139, 12),
-                CS | win32con.WS_TABSTOP | win32con.ES_AUTOHSCROLL | win32con.WS_BORDER,
-            ]
-        )
-        tmp.append(
-            [
-                BUTTON,
-                "Add",
-                109,
-                (167, 83, 32, 12),
-                CS | win32con.BS_PUSHBUTTON | win32con.WS_TABSTOP,
-            ]
-        )
-        dialog.Dialog.__init__(self, tmp)
-        self.HookCommand(self.OnAddItem, 109)
-        self.HookCommand(self.OnListDoubleClick, 107)
-
-    def OnInitDialog(self):
-        lb = self.GetDlgItem(107)
-        for item in self.items:
-            lb.AddString(item)
-        return self._obj_.OnInitDialog()
-
-    def OnAddItem(self, cmd, code):
-        if code != 0:
-            return 1
-        eb = self.GetDlgItem(108)
-        item = eb.GetLine(0)
-        self.newitems.append(item)
-        lb = self.GetDlgItem(107)
-        i = lb.AddString(item)
-        lb.SetSel(i, 1)
-        return 1
-
-    def OnListDoubleClick(self, cmd, code):
-        if code == win32con.LBN_DBLCLK:
-            self.OnOK()
-            return 1
-
-    def OnOK(self):
-        lb = self.GetDlgItem(107)
-        self.selections = lb.GetSelTextItems()
-        self._obj_.OnOK()
-
-    def getItems(self):
-        return self.selections
-
-    def getNew(self):
-        return self.newitems
-
-
-try:
-    win32ui.GetApp().RemoveDocTemplate(greptemplate)
-except NameError:
-    pass
-
-greptemplate = GrepTemplate()
diff --git a/lib/pythonwin/pywin/framework/startup.py b/lib/pythonwin/pywin/framework/startup.py
deleted file mode 100644
index 4a732322..00000000
--- a/lib/pythonwin/pywin/framework/startup.py
+++ /dev/null
@@ -1,80 +0,0 @@
-# startup.py
-#
-"The main application startup code for PythonWin."
-
-#
-# This does the basic command line handling.
-
-# Keep this as short as possible, cos error output is only redirected if
-# this runs OK.  Errors in imported modules are much better - the messages go somewhere (not any more :-)
-
-import os
-import sys
-
-import win32api
-import win32ui
-
-if not sys.argv:
-    # Initialize sys.argv from commandline. When sys.argv is empty list (
-    # different from [''] meaning "no cmd line arguments" ), then C
-    # bootstrapping or another method of invocation failed to initialize
-    # sys.argv and it will be done here. ( This was a workaround for a bug in
-    # win32ui but is retained for other situations. )
-    argv = win32api.CommandLineToArgv(win32api.GetCommandLine())
-    sys.argv = argv[1:]
-    if os.getcwd() not in sys.path and "." not in sys.path:
-        sys.path.insert(0, os.getcwd())
-
-# You may wish to redirect error output somewhere useful if you have startup errors.
-# eg, 'import win32traceutil' will do this for you.
-# import win32traceutil # Just uncomment this line to see error output!
-
-# An old class I used to use - generally only useful if Pythonwin is running under MSVC
-# class DebugOutput:
-# 	softspace=1
-# 	def write(self,message):
-# 		win32ui.OutputDebug(message)
-# sys.stderr=sys.stdout=DebugOutput()
-
-# To fix a problem with Pythonwin when started from the Pythonwin directory,
-# we update the pywin path to ensure it is absolute.
-# If it is indeed relative, it will be relative to our current directory.
-# If its already absolute, then this will have no affect.
-import pywin
-import pywin.framework
-
-pywin.__path__[0] = win32ui.FullPath(pywin.__path__[0])
-pywin.framework.__path__[0] = win32ui.FullPath(pywin.framework.__path__[0])
-
-# make a few wierd sys values.  This is so later we can clobber sys.argv to trick
-# scripts when running under a GUI environment.
-
-moduleName = "pywin.framework.intpyapp"
-sys.appargvoffset = 0
-sys.appargv = sys.argv[:]
-# Must check for /app param here.
-if len(sys.argv) >= 2 and sys.argv[0].lower() in ("/app", "-app"):
-    from . import cmdline
-
-    moduleName = cmdline.FixArgFileName(sys.argv[1])
-    sys.appargvoffset = 2
-    newargv = sys.argv[sys.appargvoffset :]
-    # 	newargv.insert(0, sys.argv[0])
-    sys.argv = newargv
-
-# Import the application module.
-__import__(moduleName)
-
-try:
-    win32ui.GetApp()._obj_
-    # This worked - an app already exists - do nothing more
-except (AttributeError, win32ui.error):
-    # This means either no app object exists at all, or the one
-    # that does exist does not have a Python class (ie, was created
-    # by the host .EXE).  In this case, we do the "old style" init...
-    from . import app
-
-    if app.AppBuilder is None:
-        raise TypeError("No application object has been registered")
-
-    app.App = app.AppBuilder()
diff --git a/lib/pythonwin/pywin/framework/stdin.py b/lib/pythonwin/pywin/framework/stdin.py
deleted file mode 100644
index 2f3adcb6..00000000
--- a/lib/pythonwin/pywin/framework/stdin.py
+++ /dev/null
@@ -1,176 +0,0 @@
-# Copyright (c) 2000 David Abrahams. Permission to copy, use, modify, sell
-# and distribute this software is granted provided this copyright
-# notice appears in all copies. This software is provided "as is" without
-# express or implied warranty, and with no claim as to its suitability for
-# any purpose.
-"""Provides a class Stdin which can be used to emulate the regular old
-sys.stdin for the PythonWin interactive window. Right now it just pops
-up a raw_input() dialog. With luck, someone will integrate it into the
-actual PythonWin interactive window someday.
-
-WARNING: Importing this file automatically replaces sys.stdin with an
-instance of Stdin (below). This is useful because you can just open
-Stdin.py in PythonWin and hit the import button to get it set up right
-if you don't feel like changing PythonWin's source. To put things back
-the way they were, simply use this magic incantation:
-    import sys
-    sys.stdin = sys.stdin.real_file
-"""
-import sys
-
-try:
-    get_input_line = raw_input  # py2x
-except NameError:
-    get_input_line = input  # py3k
-
-
-class Stdin:
-    def __init__(self):
-        self.real_file = sys.stdin  # NOTE: Likely to be None in py3k
-        self.buffer = ""
-        self.closed = False
-
-    def __getattr__(self, name):
-        """Forward most functions to the real sys.stdin for absolute realism."""
-        if self.real_file is None:
-            raise AttributeError(name)
-        return getattr(self.real_file, name)
-
-    def isatty(self):
-        """Return 1 if the file is connected to a tty(-like) device, else 0."""
-        return 1
-
-    def read(self, size=-1):
-        """Read at most size bytes from the file (less if the read
-        hits EOF or no more data is immediately available on a pipe,
-        tty or similar device). If the size argument is negative or
-        omitted, read all data until EOF is reached. The bytes are
-        returned as a string object. An empty string is returned when
-        EOF is encountered immediately. (For certain files, like ttys,
-        it makes sense to continue reading after an EOF is hit.)"""
-        result_size = self.__get_lines(size)
-        return self.__extract_from_buffer(result_size)
-
-    def readline(self, size=-1):
-        """Read one entire line from the file. A trailing newline
-        character is kept in the string2.6 (but may be absent when a file ends
-        with an incomplete line). If the size argument is present and
-        non-negative, it is a maximum byte count (including the trailing
-        newline) and an incomplete line may be returned. An empty string is
-        returned when EOF is hit immediately. Note: unlike stdio's fgets(),
-        the returned string contains null characters ('\0') if they occurred
-        in the input.
-        """
-        maximum_result_size = self.__get_lines(size, lambda buffer: "\n" in buffer)
-
-        if "\n" in self.buffer[:maximum_result_size]:
-            result_size = self.buffer.find("\n", 0, maximum_result_size) + 1
-            assert result_size > 0
-        else:
-            result_size = maximum_result_size
-
-        return self.__extract_from_buffer(result_size)
-
-    def __extract_from_buffer(self, character_count):
-        """Remove the first character_count characters from the internal buffer and
-        return them.
-        """
-        result = self.buffer[:character_count]
-        self.buffer = self.buffer[character_count:]
-        return result
-
-    def __get_lines(self, desired_size, done_reading=lambda buffer: False):
-        """Keep adding lines to our internal buffer until done_reading(self.buffer)
-        is true or EOF has been reached or we have desired_size bytes in the buffer.
-        If desired_size < 0, we are never satisfied until we reach EOF. If done_reading
-        is not supplied, it is not consulted.
-
-        If desired_size < 0, returns the length of the internal buffer. Otherwise,
-        returns desired_size.
-        """
-        while not done_reading(self.buffer) and (
-            desired_size < 0 or len(self.buffer) < desired_size
-        ):
-            try:
-                self.__get_line()
-            except (
-                EOFError,
-                KeyboardInterrupt,
-            ):  # deal with cancellation of get_input_line dialog
-                desired_size = len(self.buffer)  # Be satisfied!
-
-        if desired_size < 0:
-            return len(self.buffer)
-        else:
-            return desired_size
-
-    def __get_line(self):
-        """Grab one line from get_input_line() and append it to the buffer."""
-        line = get_input_line()
-        print(">>>", line)  # echo input to console
-        self.buffer = self.buffer + line + "\n"
-
-    def readlines(self, *sizehint):
-        """Read until EOF using readline() and return a list containing the lines
-        thus read. If the optional sizehint argument is present, instead of
-        reading up to EOF, whole lines totalling approximately sizehint bytes
-        (possibly after rounding up to an internal buffer size) are read.
-        """
-        result = []
-        total_read = 0
-        while sizehint == () or total_read < sizehint[0]:
-            line = self.readline()
-            if line == "":
-                break
-            total_read = total_read + len(line)
-            result.append(line)
-        return result
-
-
-if __name__ == "__main__":
-    test_input = r"""this is some test
-input that I am hoping
-~
-will be very instructive
-and when I am done
-I will have tested everything.
-Twelve and twenty blackbirds
-baked in a pie. Patty cake
-patty cake so am I.
-~
-Thirty-five niggling idiots!
-Sell you soul to the devil, baby
-"""
-
-    def fake_raw_input(prompt=None):
-        """Replacement for raw_input() which pulls lines out of global test_input.
-        For testing only!
-        """
-        global test_input
-        if "\n" not in test_input:
-            end_of_line_pos = len(test_input)
-        else:
-            end_of_line_pos = test_input.find("\n")
-        result = test_input[:end_of_line_pos]
-        test_input = test_input[end_of_line_pos + 1 :]
-        if len(result) == 0 or result[0] == "~":
-            raise EOFError()
-        return result
-
-    get_input_line = fake_raw_input
-
-    # Some completely inadequate tests, just to make sure the code's not totally broken
-    try:
-        x = Stdin()
-        print(x.read())
-        print(x.readline())
-        print(x.read(12))
-        print(x.readline(47))
-        print(x.readline(3))
-        print(x.readlines())
-    finally:
-        get_input_line = raw_input
-else:
-    import sys
-
-    sys.stdin = Stdin()
diff --git a/lib/pythonwin/pywin/framework/toolmenu.py b/lib/pythonwin/pywin/framework/toolmenu.py
deleted file mode 100644
index 3f739e09..00000000
--- a/lib/pythonwin/pywin/framework/toolmenu.py
+++ /dev/null
@@ -1,284 +0,0 @@
-# toolmenu.py
-
-import sys
-
-import win32api
-import win32con
-import win32ui
-
-from . import app
-
-tools = {}
-idPos = 100
-
-# The default items should no tools menu exist in the INI file.
-defaultToolMenuItems = [
-    ("Browser", "win32ui.GetApp().OnViewBrowse(0,0)"),
-    (
-        "Browse PythonPath",
-        "from pywin.tools import browseProjects;browseProjects.Browse()",
-    ),
-    ("Edit Python Path", "from pywin.tools import regedit;regedit.EditRegistry()"),
-    ("COM Makepy utility", "from win32com.client import makepy;makepy.main()"),
-    (
-        "COM Browser",
-        "from win32com.client import combrowse;combrowse.main(modal=False)",
-    ),
-    (
-        "Trace Collector Debugging tool",
-        "from pywin.tools import TraceCollector;TraceCollector.MakeOutputWindow()",
-    ),
-]
-
-
-def LoadToolMenuItems():
-    # Load from the registry.
-    items = []
-    lookNo = 1
-    while 1:
-        menu = win32ui.GetProfileVal("Tools Menu\\%s" % lookNo, "", "")
-        if menu == "":
-            break
-        cmd = win32ui.GetProfileVal("Tools Menu\\%s" % lookNo, "Command", "")
-        items.append((menu, cmd))
-        lookNo = lookNo + 1
-
-    if len(items) == 0:
-        items = defaultToolMenuItems
-    return items
-
-
-def WriteToolMenuItems(items):
-    # Items is a list of (menu, command)
-    # Delete the entire registry tree.
-    try:
-        mainKey = win32ui.GetAppRegistryKey()
-        toolKey = win32api.RegOpenKey(mainKey, "Tools Menu")
-    except win32ui.error:
-        toolKey = None
-    if toolKey is not None:
-        while 1:
-            try:
-                subkey = win32api.RegEnumKey(toolKey, 0)
-            except win32api.error:
-                break
-            win32api.RegDeleteKey(toolKey, subkey)
-    # Keys are now removed - write the new ones.
-    # But first check if we have the defaults - and if so, dont write anything!
-    if items == defaultToolMenuItems:
-        return
-    itemNo = 1
-    for menu, cmd in items:
-        win32ui.WriteProfileVal("Tools Menu\\%s" % itemNo, "", menu)
-        win32ui.WriteProfileVal("Tools Menu\\%s" % itemNo, "Command", cmd)
-        itemNo = itemNo + 1
-
-
-def SetToolsMenu(menu, menuPos=None):
-    global tools
-    global idPos
-
-    # todo - check the menu does not already exist.
-    # Create the new menu
-    toolsMenu = win32ui.CreatePopupMenu()
-
-    # Load from the ini file.
-    items = LoadToolMenuItems()
-    for menuString, cmd in items:
-        tools[idPos] = (menuString, cmd, menuString)
-        toolsMenu.AppendMenu(
-            win32con.MF_ENABLED | win32con.MF_STRING, idPos, menuString
-        )
-        win32ui.GetMainFrame().HookCommand(HandleToolCommand, idPos)
-        idPos = idPos + 1
-
-    # Find the correct spot to insert the new tools menu.
-    if menuPos is None:
-        menuPos = menu.GetMenuItemCount() - 2
-        if menuPos < 0:
-            menuPos = 0
-
-    menu.InsertMenu(
-        menuPos,
-        win32con.MF_BYPOSITION
-        | win32con.MF_ENABLED
-        | win32con.MF_STRING
-        | win32con.MF_POPUP,
-        toolsMenu.GetHandle(),
-        "&Tools",
-    )
-
-
-def HandleToolCommand(cmd, code):
-    import re
-    import traceback
-
-    global tools
-    (menuString, pyCmd, desc) = tools[cmd]
-    win32ui.SetStatusText("Executing tool %s" % desc, 1)
-    pyCmd = re.sub("\\\\n", "\n", pyCmd)
-    win32ui.DoWaitCursor(1)
-    oldFlag = None
-    try:
-        oldFlag = sys.stdout.template.writeQueueing
-        sys.stdout.template.writeQueueing = 0
-    except (NameError, AttributeError):
-        pass
-
-    try:
-        exec("%s\n" % pyCmd)
-        worked = 1
-    except SystemExit:
-        # The program raised a SystemExit - ignore it.
-        worked = 1
-    except:
-        print("Failed to execute command:\n%s" % pyCmd)
-        traceback.print_exc()
-        worked = 0
-    if oldFlag is not None:
-        sys.stdout.template.writeQueueing = oldFlag
-    win32ui.DoWaitCursor(0)
-    if worked:
-        text = "Completed successfully."
-    else:
-        text = "Error executing %s." % desc
-    win32ui.SetStatusText(text, 1)
-
-
-# The property page for maintaing the items on the Tools menu.
-import commctrl
-from pywin.mfc import dialog
-
-if win32ui.UNICODE:
-    LVN_ENDLABELEDIT = commctrl.LVN_ENDLABELEDITW
-else:
-    LVN_ENDLABELEDIT = commctrl.LVN_ENDLABELEDITA
-
-
-class ToolMenuPropPage(dialog.PropertyPage):
-    def __init__(self):
-        self.bImChangingEditControls = 0  # Am I programatically changing the controls?
-        dialog.PropertyPage.__init__(self, win32ui.IDD_PP_TOOLMENU)
-
-    def OnInitDialog(self):
-        self.editMenuCommand = self.GetDlgItem(win32ui.IDC_EDIT2)
-        self.butNew = self.GetDlgItem(win32ui.IDC_BUTTON3)
-
-        # Now hook the change notification messages for the edit controls.
-        self.HookCommand(self.OnCommandEditControls, win32ui.IDC_EDIT1)
-        self.HookCommand(self.OnCommandEditControls, win32ui.IDC_EDIT2)
-
-        self.HookNotify(self.OnNotifyListControl, commctrl.LVN_ITEMCHANGED)
-        self.HookNotify(self.OnNotifyListControlEndLabelEdit, commctrl.LVN_ENDLABELEDIT)
-
-        # Hook the button clicks.
-        self.HookCommand(self.OnButtonNew, win32ui.IDC_BUTTON3)  # New Item
-        self.HookCommand(self.OnButtonDelete, win32ui.IDC_BUTTON4)  # Delete item
-        self.HookCommand(self.OnButtonMove, win32ui.IDC_BUTTON1)  # Move up
-        self.HookCommand(self.OnButtonMove, win32ui.IDC_BUTTON2)  # Move down
-
-        # Setup the columns in the list control
-        lc = self.GetDlgItem(win32ui.IDC_LIST1)
-        rect = lc.GetWindowRect()
-        cx = rect[2] - rect[0]
-        colSize = cx / 2 - win32api.GetSystemMetrics(win32con.SM_CXBORDER) - 1
-
-        item = commctrl.LVCFMT_LEFT, colSize, "Menu Text"
-        lc.InsertColumn(0, item)
-
-        item = commctrl.LVCFMT_LEFT, colSize, "Python Command"
-        lc.InsertColumn(1, item)
-
-        # Insert the existing tools menu
-        itemNo = 0
-        for desc, cmd in LoadToolMenuItems():
-            lc.InsertItem(itemNo, desc)
-            lc.SetItemText(itemNo, 1, cmd)
-            itemNo = itemNo + 1
-
-        self.listControl = lc
-        return dialog.PropertyPage.OnInitDialog(self)
-
-    def OnOK(self):
-        # Write the menu back to the registry.
-        items = []
-        itemLook = 0
-        while 1:
-            try:
-                text = self.listControl.GetItemText(itemLook, 0)
-                if not text:
-                    break
-                items.append((text, self.listControl.GetItemText(itemLook, 1)))
-            except win32ui.error:
-                # no more items!
-                break
-            itemLook = itemLook + 1
-        WriteToolMenuItems(items)
-        return self._obj_.OnOK()
-
-    def OnCommandEditControls(self, id, cmd):
-        # 		print "OnEditControls", id, cmd
-        if cmd == win32con.EN_CHANGE and not self.bImChangingEditControls:
-            itemNo = self.listControl.GetNextItem(-1, commctrl.LVNI_SELECTED)
-            newText = self.editMenuCommand.GetWindowText()
-            self.listControl.SetItemText(itemNo, 1, newText)
-
-        return 0
-
-    def OnNotifyListControlEndLabelEdit(self, id, cmd):
-        newText = self.listControl.GetEditControl().GetWindowText()
-        itemNo = self.listControl.GetNextItem(-1, commctrl.LVNI_SELECTED)
-        self.listControl.SetItemText(itemNo, 0, newText)
-
-    def OnNotifyListControl(self, id, cmd):
-        # 		print id, cmd
-        try:
-            itemNo = self.listControl.GetNextItem(-1, commctrl.LVNI_SELECTED)
-        except win32ui.error:  # No selection!
-            return
-
-        self.bImChangingEditControls = 1
-        try:
-            item = self.listControl.GetItem(itemNo, 1)
-            self.editMenuCommand.SetWindowText(item[4])
-        finally:
-            self.bImChangingEditControls = 0
-
-        return 0  # we have handled this!
-
-    def OnButtonNew(self, id, cmd):
-        if cmd == win32con.BN_CLICKED:
-            newIndex = self.listControl.GetItemCount()
-            self.listControl.InsertItem(newIndex, "Click to edit the text")
-            self.listControl.EnsureVisible(newIndex, 0)
-
-    def OnButtonMove(self, id, cmd):
-        if cmd == win32con.BN_CLICKED:
-            try:
-                itemNo = self.listControl.GetNextItem(-1, commctrl.LVNI_SELECTED)
-            except win32ui.error:
-                return
-            menu = self.listControl.GetItemText(itemNo, 0)
-            cmd = self.listControl.GetItemText(itemNo, 1)
-            if id == win32ui.IDC_BUTTON1:
-                # Move up
-                if itemNo > 0:
-                    self.listControl.DeleteItem(itemNo)
-                    # reinsert it.
-                    self.listControl.InsertItem(itemNo - 1, menu)
-                    self.listControl.SetItemText(itemNo - 1, 1, cmd)
-            else:
-                # Move down.
-                if itemNo < self.listControl.GetItemCount() - 1:
-                    self.listControl.DeleteItem(itemNo)
-                    # reinsert it.
-                    self.listControl.InsertItem(itemNo + 1, menu)
-                    self.listControl.SetItemText(itemNo + 1, 1, cmd)
-
-    def OnButtonDelete(self, id, cmd):
-        if cmd == win32con.BN_CLICKED:
-            try:
-                itemNo = self.listControl.GetNextItem(-1, commctrl.LVNI_SELECTED)
-            except win32ui.error:  # No selection!
-                return
-            self.listControl.DeleteItem(itemNo)
diff --git a/lib/pythonwin/pywin/framework/window.py b/lib/pythonwin/pywin/framework/window.py
deleted file mode 100644
index 58fd4d95..00000000
--- a/lib/pythonwin/pywin/framework/window.py
+++ /dev/null
@@ -1,14 +0,0 @@
-# Framework Window classes.
-
-# Most Pythonwin windows should use these classes rather than
-# the raw MFC ones if they want Pythonwin specific functionality.
-import pywin.mfc.window
-import win32con
-
-
-class MDIChildWnd(pywin.mfc.window.MDIChildWnd):
-    def AutoRestore(self):
-        "If the window is minimised or maximised, restore it."
-        p = self.GetWindowPlacement()
-        if p[1] == win32con.SW_MINIMIZE or p[1] == win32con.SW_SHOWMINIMIZED:
-            self.SetWindowPlacement(p[0], win32con.SW_RESTORE, p[2], p[3], p[4])
diff --git a/lib/pythonwin/pywin/framework/winout.py b/lib/pythonwin/pywin/framework/winout.py
deleted file mode 100644
index e78e959a..00000000
--- a/lib/pythonwin/pywin/framework/winout.py
+++ /dev/null
@@ -1,594 +0,0 @@
-# winout.py
-#
-# generic "output window"
-#
-# This Window will detect itself closing, and recreate next time output is
-# written to it.
-
-# This has the option of writing output at idle time (by hooking the
-# idle message, and queueing output) or writing as each
-# write is executed.
-# Updating the window directly gives a jerky appearance as many writes
-# take place between commands, and the windows scrolls, and updates etc
-# Updating at idle-time may defer all output of a long process, giving the
-# appearence nothing is happening.
-# There is a compromise "line" mode, which will output whenever
-# a complete line is available.
-
-# behaviour depends on self.writeQueueing
-
-# This module is thread safe - output can originate from any thread.  If any thread
-# other than the main thread attempts to print, it is always queued until next idle time
-
-import queue
-import re
-
-import win32api
-import win32con
-import win32ui
-from pywin.framework import app, window
-from pywin.mfc import docview
-
-debug = lambda msg: None
-
-##debug=win32ui.OutputDebugString
-##import win32trace;win32trace.InitWrite() # for debugging - delete me!
-##debug = win32trace.write
-
-
-class flags:
-    # queueing of output.
-    WQ_NONE = 0
-    WQ_LINE = 1
-    WQ_IDLE = 2
-
-
-# WindowOutputDocumentParent=docview.RichEditDoc
-# WindowOutputDocumentParent=docview.Document
-import pywin.scintilla.document
-from pywin import default_scintilla_encoding
-from pywin.scintilla import scintillacon
-
-WindowOutputDocumentParent = pywin.scintilla.document.CScintillaDocument
-
-
-class WindowOutputDocument(WindowOutputDocumentParent):
-    def SaveModified(self):
-        return 1  # say it is OK to destroy my document
-
-    def OnSaveDocument(self, fileName):
-        win32ui.SetStatusText("Saving file...", 1)
-        try:
-            self.SaveFile(fileName)
-        except IOError as details:
-            win32ui.MessageBox("Error - could not save file\r\n\r\n%s" % details)
-            return 0
-        win32ui.SetStatusText("Ready")
-        return 1
-
-
-class WindowOutputFrame(window.MDIChildWnd):
-    def __init__(self, wnd=None):
-        window.MDIChildWnd.__init__(self, wnd)
-        self.HookMessage(self.OnSizeMove, win32con.WM_SIZE)
-        self.HookMessage(self.OnSizeMove, win32con.WM_MOVE)
-
-    def LoadFrame(self, idResource, style, wndParent, context):
-        self.template = context.template
-        return self._obj_.LoadFrame(idResource, style, wndParent, context)
-
-    def PreCreateWindow(self, cc):
-        cc = self._obj_.PreCreateWindow(cc)
-        if (
-            self.template.defSize
-            and self.template.defSize[0] != self.template.defSize[1]
-        ):
-            rect = app.RectToCreateStructRect(self.template.defSize)
-            cc = cc[0], cc[1], cc[2], cc[3], rect, cc[5], cc[6], cc[7], cc[8]
-        return cc
-
-    def OnSizeMove(self, msg):
-        # so recreate maintains position.
-        # Need to map coordinates from the
-        # frame windows first child.
-        mdiClient = self.GetParent()
-        self.template.defSize = mdiClient.ScreenToClient(self.GetWindowRect())
-
-    def OnDestroy(self, message):
-        self.template.OnFrameDestroy(self)
-        return 1
-
-
-class WindowOutputViewImpl:
-    def __init__(self):
-        self.patErrorMessage = re.compile('\W*File "(.*)", line ([0-9]+)')
-        self.template = self.GetDocument().GetDocTemplate()
-
-    def HookHandlers(self):
-        # Hook for the right-click menu.
-        self.HookMessage(self.OnRClick, win32con.WM_RBUTTONDOWN)
-
-    def OnDestroy(self, msg):
-        self.template.OnViewDestroy(self)
-
-    def OnInitialUpdate(self):
-        self.RestoreKillBuffer()
-        self.SetSel(-2)  # end of buffer
-
-    def GetRightMenuItems(self):
-        ret = []
-        flags = win32con.MF_STRING | win32con.MF_ENABLED
-        ret.append((flags, win32ui.ID_EDIT_COPY, "&Copy"))
-        ret.append((flags, win32ui.ID_EDIT_SELECT_ALL, "&Select all"))
-        return ret
-
-    #
-    # Windows command handlers, virtuals, etc.
-    #
-    def OnRClick(self, params):
-        paramsList = self.GetRightMenuItems()
-        menu = win32ui.CreatePopupMenu()
-        for appendParams in paramsList:
-            if type(appendParams) != type(()):
-                appendParams = (appendParams,)
-            menu.AppendMenu(*appendParams)
-        menu.TrackPopupMenu(params[5])  # track at mouse position.
-        return 0
-
-    # as this is often used as an output window, exeptions will often
-    # be printed.  Therefore, we support this functionality at this level.
-    # Returns TRUE if the current line is an error message line, and will
-    # jump to it.  FALSE if no error (and no action taken)
-    def HandleSpecialLine(self):
-        from . import scriptutils
-
-        line = self.GetLine()
-        if line[:11] == "com_error: ":
-            # An OLE Exception - pull apart the exception
-            # and try and locate a help file.
-            try:
-                import win32api
-                import win32con
-
-                det = eval(line[line.find(":") + 1 :].strip())
-                win32ui.SetStatusText("Opening help file on OLE error...")
-                from . import help
-
-                help.OpenHelpFile(det[2][3], win32con.HELP_CONTEXT, det[2][4])
-                return 1
-            except win32api.error as details:
-                win32ui.SetStatusText(
-                    "The help file could not be opened - %s" % details.strerror
-                )
-                return 1
-            except:
-                win32ui.SetStatusText(
-                    "Line is a COM error, but no WinHelp details can be parsed"
-                )
-        # Look for a Python traceback.
-        matchResult = self.patErrorMessage.match(line)
-        if matchResult is None:
-            # No match - try the previous line
-            lineNo = self.LineFromChar()
-            if lineNo > 0:
-                line = self.GetLine(lineNo - 1)
-                matchResult = self.patErrorMessage.match(line)
-        if matchResult is not None:
-            # we have an error line.
-            fileName = matchResult.group(1)
-            if fileName[0] == "<":
-                win32ui.SetStatusText("Can not load this file")
-                return 1  # still was an error message.
-            else:
-                lineNoString = matchResult.group(2)
-                # Attempt to locate the file (in case it is a relative spec)
-                fileNameSpec = fileName
-                fileName = scriptutils.LocatePythonFile(fileName)
-                if fileName is None:
-                    # Dont force update, so it replaces the idle prompt.
-                    win32ui.SetStatusText(
-                        "Cant locate the file '%s'" % (fileNameSpec), 0
-                    )
-                    return 1
-
-                win32ui.SetStatusText(
-                    "Jumping to line " + lineNoString + " of file " + fileName, 1
-                )
-                if not scriptutils.JumpToDocument(fileName, int(lineNoString)):
-                    win32ui.SetStatusText("Could not open %s" % fileName)
-                    return 1  # still was an error message.
-                return 1
-        return 0  # not an error line
-
-    def write(self, msg):
-        return self.template.write(msg)
-
-    def writelines(self, lines):
-        for line in lines:
-            self.write(line)
-
-    def flush(self):
-        self.template.flush()
-
-
-class WindowOutputViewRTF(docview.RichEditView, WindowOutputViewImpl):
-    def __init__(self, doc):
-        docview.RichEditView.__init__(self, doc)
-        WindowOutputViewImpl.__init__(self)
-
-    def OnInitialUpdate(self):
-        WindowOutputViewImpl.OnInitialUpdate(self)
-        return docview.RichEditView.OnInitialUpdate(self)
-
-    def OnDestroy(self, msg):
-        WindowOutputViewImpl.OnDestroy(self, msg)
-        docview.RichEditView.OnDestroy(self, msg)
-
-    def HookHandlers(self):
-        WindowOutputViewImpl.HookHandlers(self)
-        # Hook for finding and locating error messages
-        self.HookMessage(self.OnLDoubleClick, win32con.WM_LBUTTONDBLCLK)
-
-    # 		docview.RichEditView.HookHandlers(self)
-
-    def OnLDoubleClick(self, params):
-        if self.HandleSpecialLine():
-            return 0  # dont pass on
-        return 1  # pass it on by default.
-
-    def RestoreKillBuffer(self):
-        if len(self.template.killBuffer):
-            self.StreamIn(win32con.SF_RTF, self._StreamRTFIn)
-            self.template.killBuffer = []
-
-    def SaveKillBuffer(self):
-        self.StreamOut(win32con.SF_RTFNOOBJS, self._StreamRTFOut)
-
-    def _StreamRTFOut(self, data):
-        self.template.killBuffer.append(data)
-        return 1  # keep em coming!
-
-    def _StreamRTFIn(self, bytes):
-        try:
-            item = self.template.killBuffer[0]
-            self.template.killBuffer.remove(item)
-            if bytes < len(item):
-                print("Warning - output buffer not big enough!")
-            return item
-        except IndexError:
-            return None
-
-    def dowrite(self, str):
-        self.SetSel(-2)
-        self.ReplaceSel(str)
-
-
-import pywin.scintilla.view
-
-
-class WindowOutputViewScintilla(
-    pywin.scintilla.view.CScintillaView, WindowOutputViewImpl
-):
-    def __init__(self, doc):
-        pywin.scintilla.view.CScintillaView.__init__(self, doc)
-        WindowOutputViewImpl.__init__(self)
-
-    def OnInitialUpdate(self):
-        pywin.scintilla.view.CScintillaView.OnInitialUpdate(self)
-        self.SCISetMarginWidth(3)
-        WindowOutputViewImpl.OnInitialUpdate(self)
-
-    def OnDestroy(self, msg):
-        WindowOutputViewImpl.OnDestroy(self, msg)
-        pywin.scintilla.view.CScintillaView.OnDestroy(self, msg)
-
-    def HookHandlers(self):
-        WindowOutputViewImpl.HookHandlers(self)
-        pywin.scintilla.view.CScintillaView.HookHandlers(self)
-        self.GetParent().HookNotify(
-            self.OnScintillaDoubleClick, scintillacon.SCN_DOUBLECLICK
-        )
-
-    ##		self.HookMessage(self.OnLDoubleClick,win32con.WM_LBUTTONDBLCLK)
-
-    def OnScintillaDoubleClick(self, std, extra):
-        self.HandleSpecialLine()
-
-    ##	def OnLDoubleClick(self,params):
-    ##			return 0	# never dont pass on
-
-    def RestoreKillBuffer(self):
-        assert len(self.template.killBuffer) in (0, 1), "Unexpected killbuffer contents"
-        if self.template.killBuffer:
-            self.SCIAddText(self.template.killBuffer[0])
-        self.template.killBuffer = []
-
-    def SaveKillBuffer(self):
-        self.template.killBuffer = [self.GetTextRange(0, -1)]
-
-    def dowrite(self, str):
-        end = self.GetTextLength()
-        atEnd = end == self.GetSel()[0]
-        self.SCIInsertText(str, end)
-        if atEnd:
-            self.SetSel(self.GetTextLength())
-
-    def SetWordWrap(self, bWrapOn=1):
-        if bWrapOn:
-            wrap_mode = scintillacon.SC_WRAP_WORD
-        else:
-            wrap_mode = scintillacon.SC_WRAP_NONE
-        self.SCISetWrapMode(wrap_mode)
-
-    def _MakeColorizer(self):
-        return None  # No colorizer for me!
-
-
-WindowOutputView = WindowOutputViewScintilla
-
-
-# The WindowOutput class is actually an MFC template.  This is a conventient way of
-# making sure that my state can exist beyond the life of the windows themselves.
-# This is primarily to support the functionality of a WindowOutput window automatically
-# being recreated if necessary when written to.
-class WindowOutput(docview.DocTemplate):
-    """Looks like a general Output Window - text can be written by the 'write' method.
-    Will auto-create itself on first write, and also on next write after being closed"""
-
-    softspace = 1
-
-    def __init__(
-        self,
-        title=None,
-        defSize=None,
-        queueing=flags.WQ_LINE,
-        bAutoRestore=1,
-        style=None,
-        makeDoc=None,
-        makeFrame=None,
-        makeView=None,
-    ):
-        """init the output window -
-        Params
-        title=None -- What is the title of the window
-        defSize=None -- What is the default size for the window - if this
-                        is a string, the size will be loaded from the ini file.
-        queueing = flags.WQ_LINE -- When should output be written
-        bAutoRestore=1 -- Should a minimized window be restored.
-        style -- Style for Window, or None for default.
-        makeDoc, makeFrame, makeView -- Classes for frame, view and window respectively.
-        """
-        if makeDoc is None:
-            makeDoc = WindowOutputDocument
-        if makeFrame is None:
-            makeFrame = WindowOutputFrame
-        if makeView is None:
-            makeView = WindowOutputViewScintilla
-        docview.DocTemplate.__init__(
-            self, win32ui.IDR_PYTHONTYPE, makeDoc, makeFrame, makeView
-        )
-        self.SetDocStrings("\nOutput\n\nText Documents (*.txt)\n.txt\n\n\n")
-        win32ui.GetApp().AddDocTemplate(self)
-        self.writeQueueing = queueing
-        self.errorCantRecreate = 0
-        self.killBuffer = []
-        self.style = style
-        self.bAutoRestore = bAutoRestore
-        self.title = title
-        self.bCreating = 0
-        self.interruptCount = 0
-        if type(defSize) == type(""):  # is a string - maintain size pos from ini file.
-            self.iniSizeSection = defSize
-            self.defSize = app.LoadWindowSize(defSize)
-            self.loadedSize = self.defSize
-        else:
-            self.iniSizeSection = None
-            self.defSize = defSize
-        self.currentView = None
-        self.outputQueue = queue.Queue(-1)
-        self.mainThreadId = win32api.GetCurrentThreadId()
-        self.idleHandlerSet = 0
-        self.SetIdleHandler()
-
-    def __del__(self):
-        self.Close()
-
-    def Create(self, title=None, style=None):
-        self.bCreating = 1
-        if title:
-            self.title = title
-        if style:
-            self.style = style
-        doc = self.OpenDocumentFile()
-        if doc is None:
-            return
-        self.currentView = doc.GetFirstView()
-        self.bCreating = 0
-        if self.title:
-            doc.SetTitle(self.title)
-
-    def Close(self):
-        self.RemoveIdleHandler()
-        try:
-            parent = self.currentView.GetParent()
-        except (AttributeError, win32ui.error):  # Already closed
-            return
-        parent.DestroyWindow()
-
-    def SetTitle(self, title):
-        self.title = title
-        if self.currentView:
-            self.currentView.GetDocument().SetTitle(self.title)
-
-    def OnViewDestroy(self, view):
-        self.currentView.SaveKillBuffer()
-        self.currentView = None
-
-    def OnFrameDestroy(self, frame):
-        if self.iniSizeSection:
-            # use GetWindowPlacement(), as it works even when min'd or max'd
-            newSize = frame.GetWindowPlacement()[4]
-            if self.loadedSize != newSize:
-                app.SaveWindowSize(self.iniSizeSection, newSize)
-
-    def SetIdleHandler(self):
-        if not self.idleHandlerSet:
-            debug("Idle handler set\n")
-            win32ui.GetApp().AddIdleHandler(self.QueueIdleHandler)
-            self.idleHandlerSet = 1
-
-    def RemoveIdleHandler(self):
-        if self.idleHandlerSet:
-            debug("Idle handler reset\n")
-            if win32ui.GetApp().DeleteIdleHandler(self.QueueIdleHandler) == 0:
-                debug("Error deleting idle handler\n")
-            self.idleHandlerSet = 0
-
-    def RecreateWindow(self):
-        if self.errorCantRecreate:
-            debug("Error = not trying again")
-            return 0
-        try:
-            # This will fail if app shutting down
-            win32ui.GetMainFrame().GetSafeHwnd()
-            self.Create()
-            return 1
-        except (win32ui.error, AttributeError):
-            self.errorCantRecreate = 1
-            debug("Winout can not recreate the Window!\n")
-            return 0
-
-    # this handles the idle message, and does the printing.
-    def QueueIdleHandler(self, handler, count):
-        try:
-            bEmpty = self.QueueFlush(20)
-            # If the queue is empty, then we are back to idle and restart interrupt logic.
-            if bEmpty:
-                self.interruptCount = 0
-        except KeyboardInterrupt:
-            # First interrupt since idle we just pass on.
-            # later ones we dump the queue and give up.
-            self.interruptCount = self.interruptCount + 1
-            if self.interruptCount > 1:
-                # Drop the queue quickly as the user is already annoyed :-)
-                self.outputQueue = queue.Queue(-1)
-                print("Interrupted.")
-                bEmpty = 1
-            else:
-                raise  # re-raise the error so the users exception filters up.
-        return not bEmpty  # More to do if not empty.
-
-    # Returns true if the Window needs to be recreated.
-    def NeedRecreateWindow(self):
-        try:
-            if self.currentView is not None and self.currentView.IsWindow():
-                return 0
-        except (
-            win32ui.error,
-            AttributeError,
-        ):  # Attribute error if the win32ui object has died.
-            pass
-        return 1
-
-    # Returns true if the Window is OK (either cos it was, or because it was recreated
-    def CheckRecreateWindow(self):
-        if self.bCreating:
-            return 1
-        if not self.NeedRecreateWindow():
-            return 1
-        if self.bAutoRestore:
-            if self.RecreateWindow():
-                return 1
-        return 0
-
-    def QueueFlush(self, max=None):
-        # Returns true if the queue is empty after the flush
-        # 		debug("Queueflush - %d, %d\n" % (max, self.outputQueue.qsize()))
-        if self.bCreating:
-            return 1
-        items = []
-        rc = 0
-        while max is None or max > 0:
-            try:
-                item = self.outputQueue.get_nowait()
-                items.append(item)
-            except queue.Empty:
-                rc = 1
-                break
-            if max is not None:
-                max = max - 1
-        if len(items) != 0:
-            if not self.CheckRecreateWindow():
-                debug(":Recreate failed!\n")
-                return 1  # In trouble - so say we have nothing to do.
-            win32ui.PumpWaitingMessages()  # Pump paint messages
-            self.currentView.dowrite("".join(items))
-        return rc
-
-    def HandleOutput(self, message):
-        # 		debug("QueueOutput on thread %d, flags %d with '%s'...\n" % (win32api.GetCurrentThreadId(), self.writeQueueing, message ))
-        self.outputQueue.put(message)
-        if win32api.GetCurrentThreadId() != self.mainThreadId:
-            pass
-        # 			debug("not my thread - ignoring queue options!\n")
-        elif self.writeQueueing == flags.WQ_LINE:
-            pos = message.rfind("\n")
-            if pos >= 0:
-                # 				debug("Line queueing - forcing flush\n")
-                self.QueueFlush()
-                return
-        elif self.writeQueueing == flags.WQ_NONE:
-            # 			debug("WQ_NONE - flushing!\n")
-            self.QueueFlush()
-            return
-        # Let our idle handler get it - wake it up
-        try:
-            win32ui.GetMainFrame().PostMessage(
-                win32con.WM_USER
-            )  # Kick main thread off.
-        except win32ui.error:
-            # This can happen as the app is shutting down, so we send it to the C++ debugger
-            win32api.OutputDebugString(message)
-
-    # delegate certain fns to my view.
-    def writelines(self, lines):
-        for line in lines:
-            self.write(line)
-
-    def write(self, message):
-        self.HandleOutput(message)
-
-    def flush(self):
-        self.QueueFlush()
-
-    def HandleSpecialLine(self):
-        self.currentView.HandleSpecialLine()
-
-
-def RTFWindowOutput(*args, **kw):
-    kw["makeView"] = WindowOutputViewRTF
-    return WindowOutput(*args, **kw)
-
-
-def thread_test(o):
-    for i in range(5):
-        o.write("Hi from thread %d\n" % (win32api.GetCurrentThreadId()))
-        win32api.Sleep(100)
-
-
-def test():
-    w = WindowOutput(queueing=flags.WQ_IDLE)
-    w.write("First bit of text\n")
-    import _thread
-
-    for i in range(5):
-        w.write("Hello from the main thread\n")
-        _thread.start_new(thread_test, (w,))
-    for i in range(2):
-        w.write("Hello from the main thread\n")
-        win32api.Sleep(50)
-    return w
-
-
-if __name__ == "__main__":
-    test()
diff --git a/lib/pythonwin/pywin/idle/AutoExpand.py b/lib/pythonwin/pywin/idle/AutoExpand.py
deleted file mode 100644
index 3b302ee9..00000000
--- a/lib/pythonwin/pywin/idle/AutoExpand.py
+++ /dev/null
@@ -1,95 +0,0 @@
-import re
-import string
-
-###$ event <<expand-word>>
-###$ win <Alt-slash>
-###$ unix <Alt-slash>
-
-
-class AutoExpand:
-    keydefs = {
-        "<<expand-word>>": ["<Alt-slash>"],
-    }
-
-    unix_keydefs = {
-        "<<expand-word>>": ["<Meta-slash>"],
-    }
-
-    menudefs = [
-        (
-            "edit",
-            [
-                ("E_xpand word", "<<expand-word>>"),
-            ],
-        ),
-    ]
-
-    wordchars = string.ascii_letters + string.digits + "_"
-
-    def __init__(self, editwin):
-        self.text = editwin.text
-        self.text.wordlist = None  # XXX what is this?
-        self.state = None
-
-    def expand_word_event(self, event):
-        curinsert = self.text.index("insert")
-        curline = self.text.get("insert linestart", "insert lineend")
-        if not self.state:
-            words = self.getwords()
-            index = 0
-        else:
-            words, index, insert, line = self.state
-            if insert != curinsert or line != curline:
-                words = self.getwords()
-                index = 0
-        if not words:
-            self.text.bell()
-            return "break"
-        word = self.getprevword()
-        self.text.delete("insert - %d chars" % len(word), "insert")
-        newword = words[index]
-        index = (index + 1) % len(words)
-        if index == 0:
-            self.text.bell()  # Warn we cycled around
-        self.text.insert("insert", newword)
-        curinsert = self.text.index("insert")
-        curline = self.text.get("insert linestart", "insert lineend")
-        self.state = words, index, curinsert, curline
-        return "break"
-
-    def getwords(self):
-        word = self.getprevword()
-        if not word:
-            return []
-        before = self.text.get("1.0", "insert wordstart")
-        wbefore = re.findall(r"\b" + word + r"\w+\b", before)
-        del before
-        after = self.text.get("insert wordend", "end")
-        wafter = re.findall(r"\b" + word + r"\w+\b", after)
-        del after
-        if not wbefore and not wafter:
-            return []
-        words = []
-        dict = {}
-        # search backwards through words before
-        wbefore.reverse()
-        for w in wbefore:
-            if dict.get(w):
-                continue
-            words.append(w)
-            dict[w] = w
-        # search onwards through words after
-        for w in wafter:
-            if dict.get(w):
-                continue
-            words.append(w)
-            dict[w] = w
-        words.append(word)
-        return words
-
-    def getprevword(self):
-        line = self.text.get("insert linestart", "insert")
-        i = len(line)
-        while i > 0 and line[i - 1] in self.wordchars:
-            i = i - 1
-        return line[i:]
diff --git a/lib/pythonwin/pywin/idle/AutoIndent.py b/lib/pythonwin/pywin/idle/AutoIndent.py
deleted file mode 100644
index c5adc5f8..00000000
--- a/lib/pythonwin/pywin/idle/AutoIndent.py
+++ /dev/null
@@ -1,547 +0,0 @@
-import sys
-import tokenize
-
-from pywin import default_scintilla_encoding
-
-from . import PyParse
-
-if sys.version_info < (3,):
-    # in py2k, tokenize() takes a 'token eater' callback, while
-    # generate_tokens is a generator that works with str objects.
-    token_generator = tokenize.generate_tokens
-else:
-    # in py3k tokenize() is the generator working with 'byte' objects, and
-    # token_generator is the 'undocumented b/w compat' function that
-    # theoretically works with str objects - but actually seems to fail)
-    token_generator = tokenize.tokenize
-
-
-class AutoIndent:
-    menudefs = [
-        (
-            "edit",
-            [
-                None,
-                ("_Indent region", "<<indent-region>>"),
-                ("_Dedent region", "<<dedent-region>>"),
-                ("Comment _out region", "<<comment-region>>"),
-                ("U_ncomment region", "<<uncomment-region>>"),
-                ("Tabify region", "<<tabify-region>>"),
-                ("Untabify region", "<<untabify-region>>"),
-                ("Toggle tabs", "<<toggle-tabs>>"),
-                ("New indent width", "<<change-indentwidth>>"),
-            ],
-        ),
-    ]
-
-    keydefs = {
-        "<<smart-backspace>>": ["<Key-BackSpace>"],
-        "<<newline-and-indent>>": ["<Key-Return>", "<KP_Enter>"],
-        "<<smart-indent>>": ["<Key-Tab>"],
-    }
-
-    windows_keydefs = {
-        "<<indent-region>>": ["<Control-bracketright>"],
-        "<<dedent-region>>": ["<Control-bracketleft>"],
-        "<<comment-region>>": ["<Alt-Key-3>"],
-        "<<uncomment-region>>": ["<Alt-Key-4>"],
-        "<<tabify-region>>": ["<Alt-Key-5>"],
-        "<<untabify-region>>": ["<Alt-Key-6>"],
-        "<<toggle-tabs>>": ["<Alt-Key-t>"],
-        "<<change-indentwidth>>": ["<Alt-Key-u>"],
-    }
-
-    unix_keydefs = {
-        "<<indent-region>>": [
-            "<Alt-bracketright>",
-            "<Meta-bracketright>",
-            "<Control-bracketright>",
-        ],
-        "<<dedent-region>>": [
-            "<Alt-bracketleft>",
-            "<Meta-bracketleft>",
-            "<Control-bracketleft>",
-        ],
-        "<<comment-region>>": ["<Alt-Key-3>", "<Meta-Key-3>"],
-        "<<uncomment-region>>": ["<Alt-Key-4>", "<Meta-Key-4>"],
-        "<<tabify-region>>": ["<Alt-Key-5>", "<Meta-Key-5>"],
-        "<<untabify-region>>": ["<Alt-Key-6>", "<Meta-Key-6>"],
-        "<<toggle-tabs>>": ["<Alt-Key-t>"],
-        "<<change-indentwidth>>": ["<Alt-Key-u>"],
-    }
-
-    # usetabs true  -> literal tab characters are used by indent and
-    #                  dedent cmds, possibly mixed with spaces if
-    #                  indentwidth is not a multiple of tabwidth
-    #         false -> tab characters are converted to spaces by indent
-    #                  and dedent cmds, and ditto TAB keystrokes
-    # indentwidth is the number of characters per logical indent level.
-    # tabwidth is the display width of a literal tab character.
-    # CAUTION:  telling Tk to use anything other than its default
-    # tab setting causes it to use an entirely different tabbing algorithm,
-    # treating tab stops as fixed distances from the left margin.
-    # Nobody expects this, so for now tabwidth should never be changed.
-    usetabs = 1
-    indentwidth = 4
-    tabwidth = 8  # for IDLE use, must remain 8 until Tk is fixed
-
-    # If context_use_ps1 is true, parsing searches back for a ps1 line;
-    # else searches for a popular (if, def, ...) Python stmt.
-    context_use_ps1 = 0
-
-    # When searching backwards for a reliable place to begin parsing,
-    # first start num_context_lines[0] lines back, then
-    # num_context_lines[1] lines back if that didn't work, and so on.
-    # The last value should be huge (larger than the # of lines in a
-    # conceivable file).
-    # Making the initial values larger slows things down more often.
-    num_context_lines = 50, 500, 5000000
-
-    def __init__(self, editwin):
-        self.editwin = editwin
-        self.text = editwin.text
-
-    def config(self, **options):
-        for key, value in options.items():
-            if key == "usetabs":
-                self.usetabs = value
-            elif key == "indentwidth":
-                self.indentwidth = value
-            elif key == "tabwidth":
-                self.tabwidth = value
-            elif key == "context_use_ps1":
-                self.context_use_ps1 = value
-            else:
-                raise KeyError("bad option name: %s" % repr(key))
-
-    # If ispythonsource and guess are true, guess a good value for
-    # indentwidth based on file content (if possible), and if
-    # indentwidth != tabwidth set usetabs false.
-    # In any case, adjust the Text widget's view of what a tab
-    # character means.
-
-    def set_indentation_params(self, ispythonsource, guess=1):
-        if guess and ispythonsource:
-            i = self.guess_indent()
-            if 2 <= i <= 8:
-                self.indentwidth = i
-            if self.indentwidth != self.tabwidth:
-                self.usetabs = 0
-
-        self.editwin.set_tabwidth(self.tabwidth)
-
-    def smart_backspace_event(self, event):
-        text = self.text
-        first, last = self.editwin.get_selection_indices()
-        if first and last:
-            text.delete(first, last)
-            text.mark_set("insert", first)
-            return "break"
-        # Delete whitespace left, until hitting a real char or closest
-        # preceding virtual tab stop.
-        chars = text.get("insert linestart", "insert")
-        if chars == "":
-            if text.compare("insert", ">", "1.0"):
-                # easy: delete preceding newline
-                text.delete("insert-1c")
-            else:
-                text.bell()  # at start of buffer
-            return "break"
-        if chars[-1] not in " \t":
-            # easy: delete preceding real char
-            text.delete("insert-1c")
-            return "break"
-        # Ick.  It may require *inserting* spaces if we back up over a
-        # tab character!  This is written to be clear, not fast.
-        have = len(chars.expandtabs(self.tabwidth))
-        assert have > 0
-        want = int((have - 1) / self.indentwidth) * self.indentwidth
-        ncharsdeleted = 0
-        while 1:
-            chars = chars[:-1]
-            ncharsdeleted = ncharsdeleted + 1
-            have = len(chars.expandtabs(self.tabwidth))
-            if have <= want or chars[-1] not in " \t":
-                break
-        text.undo_block_start()
-        text.delete("insert-%dc" % ncharsdeleted, "insert")
-        if have < want:
-            text.insert("insert", " " * (want - have))
-        text.undo_block_stop()
-        return "break"
-
-    def smart_indent_event(self, event):
-        # if intraline selection:
-        #     delete it
-        # elif multiline selection:
-        #     do indent-region & return
-        # indent one level
-        text = self.text
-        first, last = self.editwin.get_selection_indices()
-        text.undo_block_start()
-        try:
-            if first and last:
-                if index2line(first) != index2line(last):
-                    return self.indent_region_event(event)
-                text.delete(first, last)
-                text.mark_set("insert", first)
-            prefix = text.get("insert linestart", "insert")
-            raw, effective = classifyws(prefix, self.tabwidth)
-            if raw == len(prefix):
-                # only whitespace to the left
-                self.reindent_to(effective + self.indentwidth)
-            else:
-                if self.usetabs:
-                    pad = "\t"
-                else:
-                    effective = len(prefix.expandtabs(self.tabwidth))
-                    n = self.indentwidth
-                    pad = " " * (n - effective % n)
-                text.insert("insert", pad)
-            text.see("insert")
-            return "break"
-        finally:
-            text.undo_block_stop()
-
-    def newline_and_indent_event(self, event):
-        text = self.text
-        first, last = self.editwin.get_selection_indices()
-        text.undo_block_start()
-        try:
-            if first and last:
-                text.delete(first, last)
-                text.mark_set("insert", first)
-            line = text.get("insert linestart", "insert")
-            i, n = 0, len(line)
-            while i < n and line[i] in " \t":
-                i = i + 1
-            if i == n:
-                # the cursor is in or at leading indentation; just inject
-                # an empty line at the start and strip space from current line
-                text.delete("insert - %d chars" % i, "insert")
-                text.insert("insert linestart", "\n")
-                return "break"
-            indent = line[:i]
-            # strip whitespace before insert point
-            i = 0
-            while line and line[-1] in " \t":
-                line = line[:-1]
-                i = i + 1
-            if i:
-                text.delete("insert - %d chars" % i, "insert")
-            # strip whitespace after insert point
-            while text.get("insert") in " \t":
-                text.delete("insert")
-            # start new line
-            text.insert("insert", "\n")
-
-            # adjust indentation for continuations and block
-            # open/close first need to find the last stmt
-            lno = index2line(text.index("insert"))
-            y = PyParse.Parser(self.indentwidth, self.tabwidth)
-            for context in self.num_context_lines:
-                startat = max(lno - context, 1)
-                startatindex = repr(startat) + ".0"
-                rawtext = text.get(startatindex, "insert")
-                y.set_str(rawtext)
-                bod = y.find_good_parse_start(
-                    self.context_use_ps1, self._build_char_in_string_func(startatindex)
-                )
-                if bod is not None or startat == 1:
-                    break
-            y.set_lo(bod or 0)
-            c = y.get_continuation_type()
-            if c != PyParse.C_NONE:
-                # The current stmt hasn't ended yet.
-                if c == PyParse.C_STRING:
-                    # inside a string; just mimic the current indent
-                    text.insert("insert", indent)
-                elif c == PyParse.C_BRACKET:
-                    # line up with the first (if any) element of the
-                    # last open bracket structure; else indent one
-                    # level beyond the indent of the line with the
-                    # last open bracket
-                    self.reindent_to(y.compute_bracket_indent())
-                elif c == PyParse.C_BACKSLASH:
-                    # if more than one line in this stmt already, just
-                    # mimic the current indent; else if initial line
-                    # has a start on an assignment stmt, indent to
-                    # beyond leftmost =; else to beyond first chunk of
-                    # non-whitespace on initial line
-                    if y.get_num_lines_in_stmt() > 1:
-                        text.insert("insert", indent)
-                    else:
-                        self.reindent_to(y.compute_backslash_indent())
-                else:
-                    assert 0, "bogus continuation type " + repr(c)
-                return "break"
-
-            # This line starts a brand new stmt; indent relative to
-            # indentation of initial line of closest preceding
-            # interesting stmt.
-            indent = y.get_base_indent_string()
-            text.insert("insert", indent)
-            if y.is_block_opener():
-                self.smart_indent_event(event)
-            elif indent and y.is_block_closer():
-                self.smart_backspace_event(event)
-            return "break"
-        finally:
-            text.see("insert")
-            text.undo_block_stop()
-
-    auto_indent = newline_and_indent_event
-
-    # Our editwin provides a is_char_in_string function that works
-    # with a Tk text index, but PyParse only knows about offsets into
-    # a string. This builds a function for PyParse that accepts an
-    # offset.
-
-    def _build_char_in_string_func(self, startindex):
-        def inner(offset, _startindex=startindex, _icis=self.editwin.is_char_in_string):
-            return _icis(_startindex + "+%dc" % offset)
-
-        return inner
-
-    def indent_region_event(self, event):
-        head, tail, chars, lines = self.get_region()
-        for pos in range(len(lines)):
-            line = lines[pos]
-            if line:
-                raw, effective = classifyws(line, self.tabwidth)
-                effective = effective + self.indentwidth
-                lines[pos] = self._make_blanks(effective) + line[raw:]
-        self.set_region(head, tail, chars, lines)
-        return "break"
-
-    def dedent_region_event(self, event):
-        head, tail, chars, lines = self.get_region()
-        for pos in range(len(lines)):
-            line = lines[pos]
-            if line:
-                raw, effective = classifyws(line, self.tabwidth)
-                effective = max(effective - self.indentwidth, 0)
-                lines[pos] = self._make_blanks(effective) + line[raw:]
-        self.set_region(head, tail, chars, lines)
-        return "break"
-
-    def comment_region_event(self, event):
-        head, tail, chars, lines = self.get_region()
-        for pos in range(len(lines) - 1):
-            line = lines[pos]
-            lines[pos] = "##" + line
-        self.set_region(head, tail, chars, lines)
-
-    def uncomment_region_event(self, event):
-        head, tail, chars, lines = self.get_region()
-        for pos in range(len(lines)):
-            line = lines[pos]
-            if not line:
-                continue
-            if line[:2] == "##":
-                line = line[2:]
-            elif line[:1] == "#":
-                line = line[1:]
-            lines[pos] = line
-        self.set_region(head, tail, chars, lines)
-
-    def tabify_region_event(self, event):
-        head, tail, chars, lines = self.get_region()
-        tabwidth = self._asktabwidth()
-        for pos in range(len(lines)):
-            line = lines[pos]
-            if line:
-                raw, effective = classifyws(line, tabwidth)
-                ntabs, nspaces = divmod(effective, tabwidth)
-                lines[pos] = "\t" * ntabs + " " * nspaces + line[raw:]
-        self.set_region(head, tail, chars, lines)
-
-    def untabify_region_event(self, event):
-        head, tail, chars, lines = self.get_region()
-        tabwidth = self._asktabwidth()
-        for pos in range(len(lines)):
-            lines[pos] = lines[pos].expandtabs(tabwidth)
-        self.set_region(head, tail, chars, lines)
-
-    def toggle_tabs_event(self, event):
-        if self.editwin.askyesno(
-            "Toggle tabs",
-            "Turn tabs " + ("on", "off")[self.usetabs] + "?",
-            parent=self.text,
-        ):
-            self.usetabs = not self.usetabs
-        return "break"
-
-    # XXX this isn't bound to anything -- see class tabwidth comments
-    def change_tabwidth_event(self, event):
-        new = self._asktabwidth()
-        if new != self.tabwidth:
-            self.tabwidth = new
-            self.set_indentation_params(0, guess=0)
-        return "break"
-
-    def change_indentwidth_event(self, event):
-        new = self.editwin.askinteger(
-            "Indent width",
-            "New indent width (1-16)",
-            parent=self.text,
-            initialvalue=self.indentwidth,
-            minvalue=1,
-            maxvalue=16,
-        )
-        if new and new != self.indentwidth:
-            self.indentwidth = new
-        return "break"
-
-    def get_region(self):
-        text = self.text
-        first, last = self.editwin.get_selection_indices()
-        if first and last:
-            head = text.index(first + " linestart")
-            tail = text.index(last + "-1c lineend +1c")
-        else:
-            head = text.index("insert linestart")
-            tail = text.index("insert lineend +1c")
-        chars = text.get(head, tail)
-        lines = chars.split("\n")
-        return head, tail, chars, lines
-
-    def set_region(self, head, tail, chars, lines):
-        text = self.text
-        newchars = "\n".join(lines)
-        if newchars == chars:
-            text.bell()
-            return
-        text.tag_remove("sel", "1.0", "end")
-        text.mark_set("insert", head)
-        text.undo_block_start()
-        text.delete(head, tail)
-        text.insert(head, newchars)
-        text.undo_block_stop()
-        text.tag_add("sel", head, "insert")
-
-    # Make string that displays as n leading blanks.
-
-    def _make_blanks(self, n):
-        if self.usetabs:
-            ntabs, nspaces = divmod(n, self.tabwidth)
-            return "\t" * ntabs + " " * nspaces
-        else:
-            return " " * n
-
-    # Delete from beginning of line to insert point, then reinsert
-    # column logical (meaning use tabs if appropriate) spaces.
-
-    def reindent_to(self, column):
-        text = self.text
-        text.undo_block_start()
-        if text.compare("insert linestart", "!=", "insert"):
-            text.delete("insert linestart", "insert")
-        if column:
-            text.insert("insert", self._make_blanks(column))
-        text.undo_block_stop()
-
-    def _asktabwidth(self):
-        return (
-            self.editwin.askinteger(
-                "Tab width",
-                "Spaces per tab?",
-                parent=self.text,
-                initialvalue=self.tabwidth,
-                minvalue=1,
-                maxvalue=16,
-            )
-            or self.tabwidth
-        )
-
-    # Guess indentwidth from text content.
-    # Return guessed indentwidth.  This should not be believed unless
-    # it's in a reasonable range (e.g., it will be 0 if no indented
-    # blocks are found).
-
-    def guess_indent(self):
-        opener, indented = IndentSearcher(self.text, self.tabwidth).run()
-        if opener and indented:
-            raw, indentsmall = classifyws(opener, self.tabwidth)
-            raw, indentlarge = classifyws(indented, self.tabwidth)
-        else:
-            indentsmall = indentlarge = 0
-        return indentlarge - indentsmall
-
-
-# "line.col" -> line, as an int
-def index2line(index):
-    return int(float(index))
-
-
-# Look at the leading whitespace in s.
-# Return pair (# of leading ws characters,
-#              effective # of leading blanks after expanding
-#              tabs to width tabwidth)
-
-
-def classifyws(s, tabwidth):
-    raw = effective = 0
-    for ch in s:
-        if ch == " ":
-            raw = raw + 1
-            effective = effective + 1
-        elif ch == "\t":
-            raw = raw + 1
-            effective = (effective // tabwidth + 1) * tabwidth
-        else:
-            break
-    return raw, effective
-
-
-class IndentSearcher:
-    # .run() chews over the Text widget, looking for a block opener
-    # and the stmt following it.  Returns a pair,
-    #     (line containing block opener, line containing stmt)
-    # Either or both may be None.
-
-    def __init__(self, text, tabwidth):
-        self.text = text
-        self.tabwidth = tabwidth
-        self.i = self.finished = 0
-        self.blkopenline = self.indentedline = None
-
-    def readline(self):
-        if self.finished:
-            val = ""
-        else:
-            i = self.i = self.i + 1
-            mark = repr(i) + ".0"
-            if self.text.compare(mark, ">=", "end"):
-                val = ""
-            else:
-                val = self.text.get(mark, mark + " lineend+1c")
-        # hrm - not sure this is correct in py3k - the source code may have
-        # an encoding declared, but the data will *always* be in
-        # default_scintilla_encoding - so if anyone looks at the encoding decl
-        # in the source they will be wrong.  I think.  Maybe.  Or something...
-        return val.encode(default_scintilla_encoding)
-
-    def run(self):
-        OPENERS = ("class", "def", "for", "if", "try", "while")
-        INDENT = tokenize.INDENT
-        NAME = tokenize.NAME
-
-        save_tabsize = tokenize.tabsize
-        tokenize.tabsize = self.tabwidth
-        try:
-            try:
-                for typ, token, start, end, line in token_generator(self.readline):
-                    if typ == NAME and token in OPENERS:
-                        self.blkopenline = line
-                    elif typ == INDENT and self.blkopenline:
-                        self.indentedline = line
-                        break
-
-            except (tokenize.TokenError, IndentationError):
-                # since we cut off the tokenizer early, we can trigger
-                # spurious errors
-                pass
-        finally:
-            tokenize.tabsize = save_tabsize
-        return self.blkopenline, self.indentedline
diff --git a/lib/pythonwin/pywin/idle/CallTips.py b/lib/pythonwin/pywin/idle/CallTips.py
deleted file mode 100644
index cecc760a..00000000
--- a/lib/pythonwin/pywin/idle/CallTips.py
+++ /dev/null
@@ -1,219 +0,0 @@
-# CallTips.py - An IDLE extension that provides "Call Tips" - ie, a floating window that
-# displays parameter information as you open parens.
-
-import inspect
-import string
-import sys
-import traceback
-
-
-class CallTips:
-    menudefs = []
-
-    keydefs = {
-        "<<paren-open>>": ["<Key-parenleft>"],
-        "<<paren-close>>": ["<Key-parenright>"],
-        "<<check-calltip-cancel>>": ["<KeyRelease>"],
-        "<<calltip-cancel>>": ["<ButtonPress>", "<Key-Escape>"],
-    }
-
-    windows_keydefs = {}
-
-    unix_keydefs = {}
-
-    def __init__(self, editwin):
-        self.editwin = editwin
-        self.text = editwin.text
-        self.calltip = None
-        if hasattr(self.text, "make_calltip_window"):
-            self._make_calltip_window = self.text.make_calltip_window
-        else:
-            self._make_calltip_window = self._make_tk_calltip_window
-
-    def close(self):
-        self._make_calltip_window = None
-
-    # Makes a Tk based calltip window.  Used by IDLE, but not Pythonwin.
-    # See __init__ above for how this is used.
-    def _make_tk_calltip_window(self):
-        import CallTipWindow
-
-        return CallTipWindow.CallTip(self.text)
-
-    def _remove_calltip_window(self):
-        if self.calltip:
-            self.calltip.hidetip()
-            self.calltip = None
-
-    def paren_open_event(self, event):
-        self._remove_calltip_window()
-        arg_text = get_arg_text(self.get_object_at_cursor())
-        if arg_text:
-            self.calltip_start = self.text.index("insert")
-            self.calltip = self._make_calltip_window()
-            self.calltip.showtip(arg_text)
-        return ""  # so the event is handled normally.
-
-    def paren_close_event(self, event):
-        # Now just hides, but later we should check if other
-        # paren'd expressions remain open.
-        self._remove_calltip_window()
-        return ""  # so the event is handled normally.
-
-    def check_calltip_cancel_event(self, event):
-        if self.calltip:
-            # If we have moved before the start of the calltip,
-            # or off the calltip line, then cancel the tip.
-            # (Later need to be smarter about multi-line, etc)
-            if self.text.compare(
-                "insert", "<=", self.calltip_start
-            ) or self.text.compare("insert", ">", self.calltip_start + " lineend"):
-                self._remove_calltip_window()
-        return ""  # so the event is handled normally.
-
-    def calltip_cancel_event(self, event):
-        self._remove_calltip_window()
-        return ""  # so the event is handled normally.
-
-    def get_object_at_cursor(
-        self,
-        wordchars="._"
-        + string.ascii_uppercase
-        + string.ascii_lowercase
-        + string.digits,
-    ):
-        # XXX - This needs to be moved to a better place
-        # so the "." attribute lookup code can also use it.
-        text = self.text
-        chars = text.get("insert linestart", "insert")
-        i = len(chars)
-        while i and chars[i - 1] in wordchars:
-            i = i - 1
-        word = chars[i:]
-        if word:
-            # How is this for a hack!
-            import __main__
-
-            namespace = sys.modules.copy()
-            namespace.update(__main__.__dict__)
-            try:
-                return eval(word, namespace)
-            except:
-                pass
-        return None  # Can't find an object.
-
-
-def _find_constructor(class_ob):
-    # Given a class object, return a function object used for the
-    # constructor (ie, __init__() ) or None if we can't find one.
-    try:
-        return class_ob.__init__
-    except AttributeError:
-        for base in class_ob.__bases__:
-            rc = _find_constructor(base)
-            if rc is not None:
-                return rc
-    return None
-
-
-def get_arg_text(ob):
-    # Get a string describing the arguments for the given object.
-    argText = ""
-    if ob is not None:
-        if inspect.isclass(ob):
-            # Look for the highest __init__ in the class chain.
-            fob = _find_constructor(ob)
-            if fob is None:
-                fob = lambda: None
-        else:
-            fob = ob
-        if inspect.isfunction(fob) or inspect.ismethod(fob):
-            try:
-                argText = str(inspect.signature(fob))
-            except:
-                print("Failed to format the args")
-                traceback.print_exc()
-        # See if we can use the docstring
-        if hasattr(ob, "__doc__"):
-            doc = ob.__doc__
-            try:
-                doc = doc.strip()
-                pos = doc.find("\n")
-            except AttributeError:
-                ## New style classes may have __doc__ slot without actually
-                ## having a string assigned to it
-                pass
-            else:
-                if pos < 0 or pos > 70:
-                    pos = 70
-                if argText:
-                    argText = argText + "\n"
-                argText = argText + doc[:pos]
-
-    return argText
-
-
-#################################################
-#
-# Test code
-#
-if __name__ == "__main__":
-
-    def t1():
-        "()"
-
-    def t2(a, b=None):
-        "(a, b=None)"
-
-    def t3(a, *args):
-        "(a, *args)"
-
-    def t4(*args):
-        "(*args)"
-
-    def t5(a, *args):
-        "(a, *args)"
-
-    def t6(a, b=None, *args, **kw):
-        "(a, b=None, *args, **kw)"
-
-    class TC:
-        "(self, a=None, *b)"
-
-        def __init__(self, a=None, *b):
-            "(self, a=None, *b)"
-
-        def t1(self):
-            "(self)"
-
-        def t2(self, a, b=None):
-            "(self, a, b=None)"
-
-        def t3(self, a, *args):
-            "(self, a, *args)"
-
-        def t4(self, *args):
-            "(self, *args)"
-
-        def t5(self, a, *args):
-            "(self, a, *args)"
-
-        def t6(self, a, b=None, *args, **kw):
-            "(self, a, b=None, *args, **kw)"
-
-    def test(tests):
-        failed = []
-        for t in tests:
-            expected = t.__doc__ + "\n" + t.__doc__
-            if get_arg_text(t) != expected:
-                failed.append(t)
-                print(
-                    "%s - expected %s, but got %s"
-                    % (t, repr(expected), repr(get_arg_text(t)))
-                )
-        print("%d of %d tests failed" % (len(failed), len(tests)))
-
-    tc = TC()
-    tests = t1, t2, t3, t4, t5, t6, TC, tc.t1, tc.t2, tc.t3, tc.t4, tc.t5, tc.t6
-
-    test(tests)
diff --git a/lib/pythonwin/pywin/idle/FormatParagraph.py b/lib/pythonwin/pywin/idle/FormatParagraph.py
deleted file mode 100644
index 143c18ee..00000000
--- a/lib/pythonwin/pywin/idle/FormatParagraph.py
+++ /dev/null
@@ -1,166 +0,0 @@
-# Extension to format a paragraph
-
-# Does basic, standard text formatting, and also understands Python
-# comment blocks.  Thus, for editing Python source code, this
-# extension is really only suitable for reformatting these comment
-# blocks or triple-quoted strings.
-
-# Known problems with comment reformatting:
-# * If there is a selection marked, and the first line of the
-#   selection is not complete, the block will probably not be detected
-#   as comments, and will have the normal "text formatting" rules
-#   applied.
-# * If a comment block has leading whitespace that mixes tabs and
-#   spaces, they will not be considered part of the same block.
-# * Fancy comments, like this bulleted list, arent handled :-)
-
-import re
-
-
-class FormatParagraph:
-    menudefs = [
-        (
-            "edit",
-            [
-                ("Format Paragraph", "<<format-paragraph>>"),
-            ],
-        )
-    ]
-
-    keydefs = {
-        "<<format-paragraph>>": ["<Alt-q>"],
-    }
-
-    unix_keydefs = {
-        "<<format-paragraph>>": ["<Meta-q>"],
-    }
-
-    def __init__(self, editwin):
-        self.editwin = editwin
-
-    def close(self):
-        self.editwin = None
-
-    def format_paragraph_event(self, event):
-        text = self.editwin.text
-        first, last = self.editwin.get_selection_indices()
-        if first and last:
-            data = text.get(first, last)
-            comment_header = ""
-        else:
-            first, last, comment_header, data = find_paragraph(
-                text, text.index("insert")
-            )
-        if comment_header:
-            # Reformat the comment lines - convert to text sans header.
-            lines = data.split("\n")
-            lines = map(lambda st, l=len(comment_header): st[l:], lines)
-            data = "\n".join(lines)
-            # Reformat to 70 chars or a 20 char width, whichever is greater.
-            format_width = max(70 - len(comment_header), 20)
-            newdata = reformat_paragraph(data, format_width)
-            # re-split and re-insert the comment header.
-            newdata = newdata.split("\n")
-            # If the block ends in a \n, we dont want the comment
-            # prefix inserted after it. (Im not sure it makes sense to
-            # reformat a comment block that isnt made of complete
-            # lines, but whatever!)  Can't think of a clean soltution,
-            # so we hack away
-            block_suffix = ""
-            if not newdata[-1]:
-                block_suffix = "\n"
-                newdata = newdata[:-1]
-            builder = lambda item, prefix=comment_header: prefix + item
-            newdata = "\n".join([builder(d) for d in newdata]) + block_suffix
-        else:
-            # Just a normal text format
-            newdata = reformat_paragraph(data)
-        text.tag_remove("sel", "1.0", "end")
-        if newdata != data:
-            text.mark_set("insert", first)
-            text.undo_block_start()
-            text.delete(first, last)
-            text.insert(first, newdata)
-            text.undo_block_stop()
-        else:
-            text.mark_set("insert", last)
-        text.see("insert")
-
-
-def find_paragraph(text, mark):
-    lineno, col = list(map(int, mark.split(".")))
-    line = text.get("%d.0" % lineno, "%d.0 lineend" % lineno)
-    while text.compare("%d.0" % lineno, "<", "end") and is_all_white(line):
-        lineno = lineno + 1
-        line = text.get("%d.0" % lineno, "%d.0 lineend" % lineno)
-    first_lineno = lineno
-    comment_header = get_comment_header(line)
-    comment_header_len = len(comment_header)
-    while get_comment_header(line) == comment_header and not is_all_white(
-        line[comment_header_len:]
-    ):
-        lineno = lineno + 1
-        line = text.get("%d.0" % lineno, "%d.0 lineend" % lineno)
-    last = "%d.0" % lineno
-    # Search back to beginning of paragraph
-    lineno = first_lineno - 1
-    line = text.get("%d.0" % lineno, "%d.0 lineend" % lineno)
-    while (
-        lineno > 0
-        and get_comment_header(line) == comment_header
-        and not is_all_white(line[comment_header_len:])
-    ):
-        lineno = lineno - 1
-        line = text.get("%d.0" % lineno, "%d.0 lineend" % lineno)
-    first = "%d.0" % (lineno + 1)
-    return first, last, comment_header, text.get(first, last)
-
-
-def reformat_paragraph(data, limit=70):
-    lines = data.split("\n")
-    i = 0
-    n = len(lines)
-    while i < n and is_all_white(lines[i]):
-        i = i + 1
-    if i >= n:
-        return data
-    indent1 = get_indent(lines[i])
-    if i + 1 < n and not is_all_white(lines[i + 1]):
-        indent2 = get_indent(lines[i + 1])
-    else:
-        indent2 = indent1
-    new = lines[:i]
-    partial = indent1
-    while i < n and not is_all_white(lines[i]):
-        # XXX Should take double space after period (etc.) into account
-        words = re.split("(\s+)", lines[i])
-        for j in range(0, len(words), 2):
-            word = words[j]
-            if not word:
-                continue  # Can happen when line ends in whitespace
-            if len((partial + word).expandtabs()) > limit and partial != indent1:
-                new.append(partial.rstrip())
-                partial = indent2
-            partial = partial + word + " "
-            if j + 1 < len(words) and words[j + 1] != " ":
-                partial = partial + " "
-        i = i + 1
-    new.append(partial.rstrip())
-    # XXX Should reformat remaining paragraphs as well
-    new.extend(lines[i:])
-    return "\n".join(new)
-
-
-def is_all_white(line):
-    return re.match(r"^\s*$", line) is not None
-
-
-def get_indent(line):
-    return re.match(r"^(\s*)", line).group()
-
-
-def get_comment_header(line):
-    m = re.match(r"^(\s*#*)", line)
-    if m is None:
-        return ""
-    return m.group(1)
diff --git a/lib/pythonwin/pywin/idle/IdleHistory.py b/lib/pythonwin/pywin/idle/IdleHistory.py
deleted file mode 100644
index 24e69240..00000000
--- a/lib/pythonwin/pywin/idle/IdleHistory.py
+++ /dev/null
@@ -1,87 +0,0 @@
-class History:
-    def __init__(self, text, output_sep="\n"):
-        self.text = text
-        self.history = []
-        self.history_prefix = None
-        self.history_pointer = None
-        self.output_sep = output_sep
-        text.bind("<<history-previous>>", self.history_prev)
-        text.bind("<<history-next>>", self.history_next)
-
-    def history_next(self, event):
-        self.history_do(0)
-        return "break"
-
-    def history_prev(self, event):
-        self.history_do(1)
-        return "break"
-
-    def _get_source(self, start, end):
-        # Get source code from start index to end index.  Lines in the
-        # text control may be separated by sys.ps2 .
-        lines = self.text.get(start, end).split(self.output_sep)
-        return "\n".join(lines)
-
-    def _put_source(self, where, source):
-        output = self.output_sep.join(source.split("\n"))
-        self.text.insert(where, output)
-
-    def history_do(self, reverse):
-        nhist = len(self.history)
-        pointer = self.history_pointer
-        prefix = self.history_prefix
-        if pointer is not None and prefix is not None:
-            if (
-                self.text.compare("insert", "!=", "end-1c")
-                or self._get_source("iomark", "end-1c") != self.history[pointer]
-            ):
-                pointer = prefix = None
-        if pointer is None or prefix is None:
-            prefix = self._get_source("iomark", "end-1c")
-            if reverse:
-                pointer = nhist
-            else:
-                pointer = -1
-        nprefix = len(prefix)
-        while 1:
-            if reverse:
-                pointer = pointer - 1
-            else:
-                pointer = pointer + 1
-            if pointer < 0 or pointer >= nhist:
-                self.text.bell()
-                if self._get_source("iomark", "end-1c") != prefix:
-                    self.text.delete("iomark", "end-1c")
-                    self._put_source("iomark", prefix)
-                pointer = prefix = None
-                break
-            item = self.history[pointer]
-            if item[:nprefix] == prefix and len(item) > nprefix:
-                self.text.delete("iomark", "end-1c")
-                self._put_source("iomark", item)
-                break
-        self.text.mark_set("insert", "end-1c")
-        self.text.see("insert")
-        self.text.tag_remove("sel", "1.0", "end")
-        self.history_pointer = pointer
-        self.history_prefix = prefix
-
-    def history_store(self, source):
-        source = source.strip()
-        if len(source) > 2:
-            # avoid duplicates
-            try:
-                self.history.remove(source)
-            except ValueError:
-                pass
-            self.history.append(source)
-        self.history_pointer = None
-        self.history_prefix = None
-
-    def recall(self, s):
-        s = s.strip()
-        self.text.tag_remove("sel", "1.0", "end")
-        self.text.delete("iomark", "end-1c")
-        self.text.mark_set("insert", "end-1c")
-        self.text.insert("insert", s)
-        self.text.see("insert")
diff --git a/lib/pythonwin/pywin/idle/PyParse.py b/lib/pythonwin/pywin/idle/PyParse.py
deleted file mode 100644
index 173336ca..00000000
--- a/lib/pythonwin/pywin/idle/PyParse.py
+++ /dev/null
@@ -1,591 +0,0 @@
-import re
-import string
-import sys
-
-# Reason last stmt is continued (or C_NONE if it's not).
-C_NONE, C_BACKSLASH, C_STRING, C_BRACKET = list(range(4))
-
-if 0:  # for throwaway debugging output
-
-    def dump(*stuff):
-        sys.__stdout__.write(" ".join(map(str, stuff)) + "\n")
-
-
-# Find what looks like the start of a popular stmt.
-
-_synchre = re.compile(
-    r"""
-    ^
-    [ \t]*
-    (?: if
-    |   for
-    |   while
-    |   else
-    |   def
-    |   return
-    |   assert
-    |   break
-    |   class
-    |   continue
-    |   elif
-    |   try
-    |   except
-    |   raise
-    |   import
-    )
-    \b
-""",
-    re.VERBOSE | re.MULTILINE,
-).search
-
-# Match blank line or non-indenting comment line.
-
-_junkre = re.compile(
-    r"""
-    [ \t]*
-    (?: \# \S .* )?
-    \n
-""",
-    re.VERBOSE,
-).match
-
-# Match any flavor of string; the terminating quote is optional
-# so that we're robust in the face of incomplete program text.
-
-_match_stringre = re.compile(
-    r"""
-    \""" [^"\\]* (?:
-                     (?: \\. | "(?!"") )
-                     [^"\\]*
-                 )*
-    (?: \""" )?
-
-|   " [^"\\\n]* (?: \\. [^"\\\n]* )* "?
-
-|   ''' [^'\\]* (?:
-                   (?: \\. | '(?!'') )
-                   [^'\\]*
-                )*
-    (?: ''' )?
-
-|   ' [^'\\\n]* (?: \\. [^'\\\n]* )* '?
-""",
-    re.VERBOSE | re.DOTALL,
-).match
-
-# Match a line that starts with something interesting;
-# used to find the first item of a bracket structure.
-
-_itemre = re.compile(
-    r"""
-    [ \t]*
-    [^\s#\\]    # if we match, m.end()-1 is the interesting char
-""",
-    re.VERBOSE,
-).match
-
-# Match start of stmts that should be followed by a dedent.
-
-_closere = re.compile(
-    r"""
-    \s*
-    (?: return
-    |   break
-    |   continue
-    |   raise
-    |   pass
-    )
-    \b
-""",
-    re.VERBOSE,
-).match
-
-# Chew up non-special chars as quickly as possible.  If match is
-# successful, m.end() less 1 is the index of the last boring char
-# matched.  If match is unsuccessful, the string starts with an
-# interesting char.
-
-_chew_ordinaryre = re.compile(
-    r"""
-    [^[\](){}#'"\\]+
-""",
-    re.VERBOSE,
-).match
-
-# Build translation table to map uninteresting chars to "x", open
-# brackets to "(", and close brackets to ")".
-
-_tran = ["x"] * 256
-for ch in "({[":
-    _tran[ord(ch)] = "("
-for ch in ")}]":
-    _tran[ord(ch)] = ")"
-for ch in "\"'\\\n#":
-    _tran[ord(ch)] = ch
-# We are called with unicode strings, and str.translate is one of the few
-# py2k functions which can't 'do the right thing' - so take care to ensure
-# _tran is full of unicode...
-_tran = "".join(_tran)
-del ch
-
-
-class Parser:
-    def __init__(self, indentwidth, tabwidth):
-        self.indentwidth = indentwidth
-        self.tabwidth = tabwidth
-
-    def set_str(self, str):
-        assert len(str) == 0 or str[-1] == "\n", "Oops - have str %r" % (str,)
-        self.str = str
-        self.study_level = 0
-
-    # Return index of a good place to begin parsing, as close to the
-    # end of the string as possible.  This will be the start of some
-    # popular stmt like "if" or "def".  Return None if none found:
-    # the caller should pass more prior context then, if possible, or
-    # if not (the entire program text up until the point of interest
-    # has already been tried) pass 0 to set_lo.
-    #
-    # This will be reliable iff given a reliable is_char_in_string
-    # function, meaning that when it says "no", it's absolutely
-    # guaranteed that the char is not in a string.
-    #
-    # Ack, hack: in the shell window this kills us, because there's
-    # no way to tell the differences between output, >>> etc and
-    # user input.  Indeed, IDLE's first output line makes the rest
-    # look like it's in an unclosed paren!:
-    # Python 1.5.2 (#0, Apr 13 1999, ...
-
-    def find_good_parse_start(self, use_ps1, is_char_in_string=None):
-        str, pos = self.str, None
-        if use_ps1:
-            # shell window
-            ps1 = "\n" + sys.ps1
-            i = str.rfind(ps1)
-            if i >= 0:
-                pos = i + len(ps1)
-                # make it look like there's a newline instead
-                # of ps1 at the start -- hacking here once avoids
-                # repeated hackery later
-                self.str = str[: pos - 1] + "\n" + str[pos:]
-            return pos
-
-        # File window -- real work.
-        if not is_char_in_string:
-            # no clue -- make the caller pass everything
-            return None
-
-        # Peek back from the end for a good place to start,
-        # but don't try too often; pos will be left None, or
-        # bumped to a legitimate synch point.
-        limit = len(str)
-        for tries in range(5):
-            i = str.rfind(":\n", 0, limit)
-            if i < 0:
-                break
-            i = str.rfind("\n", 0, i) + 1  # start of colon line
-            m = _synchre(str, i, limit)
-            if m and not is_char_in_string(m.start()):
-                pos = m.start()
-                break
-            limit = i
-        if pos is None:
-            # Nothing looks like a block-opener, or stuff does
-            # but is_char_in_string keeps returning true; most likely
-            # we're in or near a giant string, the colorizer hasn't
-            # caught up enough to be helpful, or there simply *aren't*
-            # any interesting stmts.  In any of these cases we're
-            # going to have to parse the whole thing to be sure, so
-            # give it one last try from the start, but stop wasting
-            # time here regardless of the outcome.
-            m = _synchre(str)
-            if m and not is_char_in_string(m.start()):
-                pos = m.start()
-            return pos
-
-        # Peeking back worked; look forward until _synchre no longer
-        # matches.
-        i = pos + 1
-        while 1:
-            m = _synchre(str, i)
-            if m:
-                s, i = m.span()
-                if not is_char_in_string(s):
-                    pos = s
-            else:
-                break
-        return pos
-
-    # Throw away the start of the string.  Intended to be called with
-    # find_good_parse_start's result.
-
-    def set_lo(self, lo):
-        assert lo == 0 or self.str[lo - 1] == "\n"
-        if lo > 0:
-            self.str = self.str[lo:]
-
-    # As quickly as humanly possible <wink>, find the line numbers (0-
-    # based) of the non-continuation lines.
-    # Creates self.{goodlines, continuation}.
-
-    def _study1(self):
-        if self.study_level >= 1:
-            return
-        self.study_level = 1
-
-        # Map all uninteresting characters to "x", all open brackets
-        # to "(", all close brackets to ")", then collapse runs of
-        # uninteresting characters.  This can cut the number of chars
-        # by a factor of 10-40, and so greatly speed the following loop.
-        str = self.str
-        str = str.translate(_tran)
-        str = str.replace("xxxxxxxx", "x")
-        str = str.replace("xxxx", "x")
-        str = str.replace("xx", "x")
-        str = str.replace("xx", "x")
-        str = str.replace("\nx", "\n")
-        # note that replacing x\n with \n would be incorrect, because
-        # x may be preceded by a backslash
-
-        # March over the squashed version of the program, accumulating
-        # the line numbers of non-continued stmts, and determining
-        # whether & why the last stmt is a continuation.
-        continuation = C_NONE
-        level = lno = 0  # level is nesting level; lno is line number
-        self.goodlines = goodlines = [0]
-        push_good = goodlines.append
-        i, n = 0, len(str)
-        while i < n:
-            ch = str[i]
-            i = i + 1
-
-            # cases are checked in decreasing order of frequency
-            if ch == "x":
-                continue
-
-            if ch == "\n":
-                lno = lno + 1
-                if level == 0:
-                    push_good(lno)
-                    # else we're in an unclosed bracket structure
-                continue
-
-            if ch == "(":
-                level = level + 1
-                continue
-
-            if ch == ")":
-                if level:
-                    level = level - 1
-                    # else the program is invalid, but we can't complain
-                continue
-
-            if ch == '"' or ch == "'":
-                # consume the string
-                quote = ch
-                if str[i - 1 : i + 2] == quote * 3:
-                    quote = quote * 3
-                w = len(quote) - 1
-                i = i + w
-                while i < n:
-                    ch = str[i]
-                    i = i + 1
-
-                    if ch == "x":
-                        continue
-
-                    if str[i - 1 : i + w] == quote:
-                        i = i + w
-                        break
-
-                    if ch == "\n":
-                        lno = lno + 1
-                        if w == 0:
-                            # unterminated single-quoted string
-                            if level == 0:
-                                push_good(lno)
-                            break
-                        continue
-
-                    if ch == "\\":
-                        assert i < n
-                        if str[i] == "\n":
-                            lno = lno + 1
-                        i = i + 1
-                        continue
-
-                    # else comment char or paren inside string
-
-                else:
-                    # didn't break out of the loop, so we're still
-                    # inside a string
-                    continuation = C_STRING
-                continue  # with outer loop
-
-            if ch == "#":
-                # consume the comment
-                i = str.find("\n", i)
-                assert i >= 0
-                continue
-
-            assert ch == "\\"
-            assert i < n
-            if str[i] == "\n":
-                lno = lno + 1
-                if i + 1 == n:
-                    continuation = C_BACKSLASH
-            i = i + 1
-
-        # The last stmt may be continued for all 3 reasons.
-        # String continuation takes precedence over bracket
-        # continuation, which beats backslash continuation.
-        if continuation != C_STRING and level > 0:
-            continuation = C_BRACKET
-        self.continuation = continuation
-
-        # Push the final line number as a sentinel value, regardless of
-        # whether it's continued.
-        assert (continuation == C_NONE) == (goodlines[-1] == lno)
-        if goodlines[-1] != lno:
-            push_good(lno)
-
-    def get_continuation_type(self):
-        self._study1()
-        return self.continuation
-
-    # study1 was sufficient to determine the continuation status,
-    # but doing more requires looking at every character.  study2
-    # does this for the last interesting statement in the block.
-    # Creates:
-    #     self.stmt_start, stmt_end
-    #         slice indices of last interesting stmt
-    #     self.lastch
-    #         last non-whitespace character before optional trailing
-    #         comment
-    #     self.lastopenbracketpos
-    #         if continuation is C_BRACKET, index of last open bracket
-
-    def _study2(self):
-        _ws = string.whitespace
-        if self.study_level >= 2:
-            return
-        self._study1()
-        self.study_level = 2
-
-        # Set p and q to slice indices of last interesting stmt.
-        str, goodlines = self.str, self.goodlines
-        i = len(goodlines) - 1
-        p = len(str)  # index of newest line
-        while i:
-            assert p
-            # p is the index of the stmt at line number goodlines[i].
-            # Move p back to the stmt at line number goodlines[i-1].
-            q = p
-            for nothing in range(goodlines[i - 1], goodlines[i]):
-                # tricky: sets p to 0 if no preceding newline
-                p = str.rfind("\n", 0, p - 1) + 1
-            # The stmt str[p:q] isn't a continuation, but may be blank
-            # or a non-indenting comment line.
-            if _junkre(str, p):
-                i = i - 1
-            else:
-                break
-        if i == 0:
-            # nothing but junk!
-            assert p == 0
-            q = p
-        self.stmt_start, self.stmt_end = p, q
-
-        # Analyze this stmt, to find the last open bracket (if any)
-        # and last interesting character (if any).
-        lastch = ""
-        stack = []  # stack of open bracket indices
-        push_stack = stack.append
-        while p < q:
-            # suck up all except ()[]{}'"#\\
-            m = _chew_ordinaryre(str, p, q)
-            if m:
-                # we skipped at least one boring char
-                newp = m.end()
-                # back up over totally boring whitespace
-                i = newp - 1  # index of last boring char
-                while i >= p and str[i] in " \t\n":
-                    i = i - 1
-                if i >= p:
-                    lastch = str[i]
-                p = newp
-                if p >= q:
-                    break
-
-            ch = str[p]
-
-            if ch in "([{":
-                push_stack(p)
-                lastch = ch
-                p = p + 1
-                continue
-
-            if ch in ")]}":
-                if stack:
-                    del stack[-1]
-                lastch = ch
-                p = p + 1
-                continue
-
-            if ch == '"' or ch == "'":
-                # consume string
-                # Note that study1 did this with a Python loop, but
-                # we use a regexp here; the reason is speed in both
-                # cases; the string may be huge, but study1 pre-squashed
-                # strings to a couple of characters per line.  study1
-                # also needed to keep track of newlines, and we don't
-                # have to.
-                lastch = ch
-                p = _match_stringre(str, p, q).end()
-                continue
-
-            if ch == "#":
-                # consume comment and trailing newline
-                p = str.find("\n", p, q) + 1
-                assert p > 0
-                continue
-
-            assert ch == "\\"
-            p = p + 1  # beyond backslash
-            assert p < q
-            if str[p] != "\n":
-                # the program is invalid, but can't complain
-                lastch = ch + str[p]
-            p = p + 1  # beyond escaped char
-
-        # end while p < q:
-
-        self.lastch = lastch
-        if stack:
-            self.lastopenbracketpos = stack[-1]
-
-    # Assuming continuation is C_BRACKET, return the number
-    # of spaces the next line should be indented.
-
-    def compute_bracket_indent(self):
-        self._study2()
-        assert self.continuation == C_BRACKET
-        j = self.lastopenbracketpos
-        str = self.str
-        n = len(str)
-        origi = i = str.rfind("\n", 0, j) + 1
-        j = j + 1  # one beyond open bracket
-        # find first list item; set i to start of its line
-        while j < n:
-            m = _itemre(str, j)
-            if m:
-                j = m.end() - 1  # index of first interesting char
-                extra = 0
-                break
-            else:
-                # this line is junk; advance to next line
-                i = j = str.find("\n", j) + 1
-        else:
-            # nothing interesting follows the bracket;
-            # reproduce the bracket line's indentation + a level
-            j = i = origi
-            while str[j] in " \t":
-                j = j + 1
-            extra = self.indentwidth
-        return len(str[i:j].expandtabs(self.tabwidth)) + extra
-
-    # Return number of physical lines in last stmt (whether or not
-    # it's an interesting stmt!  this is intended to be called when
-    # continuation is C_BACKSLASH).
-
-    def get_num_lines_in_stmt(self):
-        self._study1()
-        goodlines = self.goodlines
-        return goodlines[-1] - goodlines[-2]
-
-    # Assuming continuation is C_BACKSLASH, return the number of spaces
-    # the next line should be indented.  Also assuming the new line is
-    # the first one following the initial line of the stmt.
-
-    def compute_backslash_indent(self):
-        self._study2()
-        assert self.continuation == C_BACKSLASH
-        str = self.str
-        i = self.stmt_start
-        while str[i] in " \t":
-            i = i + 1
-        startpos = i
-
-        # See whether the initial line starts an assignment stmt; i.e.,
-        # look for an = operator
-        endpos = str.find("\n", startpos) + 1
-        found = level = 0
-        while i < endpos:
-            ch = str[i]
-            if ch in "([{":
-                level = level + 1
-                i = i + 1
-            elif ch in ")]}":
-                if level:
-                    level = level - 1
-                i = i + 1
-            elif ch == '"' or ch == "'":
-                i = _match_stringre(str, i, endpos).end()
-            elif ch == "#":
-                break
-            elif (
-                level == 0
-                and ch == "="
-                and (i == 0 or str[i - 1] not in "=<>!")
-                and str[i + 1] != "="
-            ):
-                found = 1
-                break
-            else:
-                i = i + 1
-
-        if found:
-            # found a legit =, but it may be the last interesting
-            # thing on the line
-            i = i + 1  # move beyond the =
-            found = re.match(r"\s*\\", str[i:endpos]) is None
-
-        if not found:
-            # oh well ... settle for moving beyond the first chunk
-            # of non-whitespace chars
-            i = startpos
-            while str[i] not in " \t\n":
-                i = i + 1
-
-        return len(str[self.stmt_start : i].expandtabs(self.tabwidth)) + 1
-
-    # Return the leading whitespace on the initial line of the last
-    # interesting stmt.
-
-    def get_base_indent_string(self):
-        self._study2()
-        i, n = self.stmt_start, self.stmt_end
-        j = i
-        str = self.str
-        while j < n and str[j] in " \t":
-            j = j + 1
-        return str[i:j]
-
-    # Did the last interesting stmt open a block?
-
-    def is_block_opener(self):
-        self._study2()
-        return self.lastch == ":"
-
-    # Did the last interesting stmt close a block?
-
-    def is_block_closer(self):
-        self._study2()
-        return _closere(self.str, self.stmt_start) is not None
-
-    # index of last open bracket ({[, or None if none
-    lastopenbracketpos = None
-
-    def get_last_open_bracket_pos(self):
-        self._study2()
-        return self.lastopenbracketpos
diff --git a/lib/pythonwin/pywin/idle/__init__.py b/lib/pythonwin/pywin/idle/__init__.py
deleted file mode 100644
index b175d755..00000000
--- a/lib/pythonwin/pywin/idle/__init__.py
+++ /dev/null
@@ -1 +0,0 @@
-# This file denotes the directory as a Python package.
diff --git a/lib/pythonwin/pywin/mfc/__init__.py b/lib/pythonwin/pywin/mfc/__init__.py
deleted file mode 100644
index e69de29b..00000000
diff --git a/lib/pythonwin/pywin/mfc/activex.py b/lib/pythonwin/pywin/mfc/activex.py
deleted file mode 100644
index 596bbef5..00000000
--- a/lib/pythonwin/pywin/mfc/activex.py
+++ /dev/null
@@ -1,86 +0,0 @@
-"""Support for ActiveX control hosting in Pythonwin.
-"""
-import win32ui
-import win32uiole
-
-from . import window
-
-# XXX - we are still "classic style" classes in py2x, so we need can't yet
-# use 'type()' everywhere - revisit soon, as py2x will move to new-style too...
-try:
-    from types import ClassType as new_type
-except ImportError:
-    new_type = type  # py3k
-
-
-class Control(window.Wnd):
-    """An ActiveX control base class.  A new class must be derived from both
-    this class and the Events class.  See the demos for more details.
-    """
-
-    def __init__(self):
-        self.__dict__["_dispobj_"] = None
-        window.Wnd.__init__(self)
-
-    def _GetControlCLSID(self):
-        return self.CLSID
-
-    def _GetDispatchClass(self):
-        return self.default_interface
-
-    def _GetEventMap(self):
-        return self.default_source._dispid_to_func_
-
-    def CreateControl(self, windowTitle, style, rect, parent, id, lic_string=None):
-        clsid = str(self._GetControlCLSID())
-        self.__dict__["_obj_"] = win32ui.CreateControl(
-            clsid, windowTitle, style, rect, parent, id, None, False, lic_string
-        )
-        klass = self._GetDispatchClass()
-        dispobj = klass(win32uiole.GetIDispatchForWindow(self._obj_))
-        self.HookOleEvents()
-        self.__dict__["_dispobj_"] = dispobj
-
-    def HookOleEvents(self):
-        dict = self._GetEventMap()
-        for dispid, methodName in dict.items():
-            if hasattr(self, methodName):
-                self._obj_.HookOleEvent(getattr(self, methodName), dispid)
-
-    def __getattr__(self, attr):
-        # Delegate attributes to the windows and the Dispatch object for this class
-        try:
-            return window.Wnd.__getattr__(self, attr)
-        except AttributeError:
-            pass
-        return getattr(self._dispobj_, attr)
-
-    def __setattr__(self, attr, value):
-        if hasattr(self.__dict__, attr):
-            self.__dict__[attr] = value
-            return
-        try:
-            if self._dispobj_:
-                self._dispobj_.__setattr__(attr, value)
-                return
-        except AttributeError:
-            pass
-        self.__dict__[attr] = value
-
-
-def MakeControlClass(controlClass, name=None):
-    """Given a CoClass in a generated .py file, this function will return a Class
-    object which can be used as an OCX control.
-
-    This function is used when you do not want to handle any events from the OCX
-    control.  If you need events, then you should derive a class from both the
-    activex.Control class and the CoClass
-    """
-    if name is None:
-        name = controlClass.__name__
-    return new_type("OCX" + name, (Control, controlClass), {})
-
-
-def MakeControlInstance(controlClass, name=None):
-    """As for MakeControlClass(), but returns an instance of the class."""
-    return MakeControlClass(controlClass, name)()
diff --git a/lib/pythonwin/pywin/mfc/afxres.py b/lib/pythonwin/pywin/mfc/afxres.py
deleted file mode 100644
index 249211ff..00000000
--- a/lib/pythonwin/pywin/mfc/afxres.py
+++ /dev/null
@@ -1,501 +0,0 @@
-# Generated by h2py from stdin
-TCS_MULTILINE = 0x0200
-CBRS_ALIGN_LEFT = 0x1000
-CBRS_ALIGN_TOP = 0x2000
-CBRS_ALIGN_RIGHT = 0x4000
-CBRS_ALIGN_BOTTOM = 0x8000
-CBRS_ALIGN_ANY = 0xF000
-CBRS_BORDER_LEFT = 0x0100
-CBRS_BORDER_TOP = 0x0200
-CBRS_BORDER_RIGHT = 0x0400
-CBRS_BORDER_BOTTOM = 0x0800
-CBRS_BORDER_ANY = 0x0F00
-CBRS_TOOLTIPS = 0x0010
-CBRS_FLYBY = 0x0020
-CBRS_FLOAT_MULTI = 0x0040
-CBRS_BORDER_3D = 0x0080
-CBRS_HIDE_INPLACE = 0x0008
-CBRS_SIZE_DYNAMIC = 0x0004
-CBRS_SIZE_FIXED = 0x0002
-CBRS_FLOATING = 0x0001
-CBRS_GRIPPER = 0x00400000
-CBRS_ORIENT_HORZ = CBRS_ALIGN_TOP | CBRS_ALIGN_BOTTOM
-CBRS_ORIENT_VERT = CBRS_ALIGN_LEFT | CBRS_ALIGN_RIGHT
-CBRS_ORIENT_ANY = CBRS_ORIENT_HORZ | CBRS_ORIENT_VERT
-CBRS_ALL = 0xFFFF
-CBRS_NOALIGN = 0x00000000
-CBRS_LEFT = CBRS_ALIGN_LEFT | CBRS_BORDER_RIGHT
-CBRS_TOP = CBRS_ALIGN_TOP | CBRS_BORDER_BOTTOM
-CBRS_RIGHT = CBRS_ALIGN_RIGHT | CBRS_BORDER_LEFT
-CBRS_BOTTOM = CBRS_ALIGN_BOTTOM | CBRS_BORDER_TOP
-SBPS_NORMAL = 0x0000
-SBPS_NOBORDERS = 0x0100
-SBPS_POPOUT = 0x0200
-SBPS_OWNERDRAW = 0x1000
-SBPS_DISABLED = 0x04000000
-SBPS_STRETCH = 0x08000000
-ID_INDICATOR_EXT = 0xE700
-ID_INDICATOR_CAPS = 0xE701
-ID_INDICATOR_NUM = 0xE702
-ID_INDICATOR_SCRL = 0xE703
-ID_INDICATOR_OVR = 0xE704
-ID_INDICATOR_REC = 0xE705
-ID_INDICATOR_KANA = 0xE706
-ID_SEPARATOR = 0
-AFX_IDW_CONTROLBAR_FIRST = 0xE800
-AFX_IDW_CONTROLBAR_LAST = 0xE8FF
-AFX_IDW_TOOLBAR = 0xE800
-AFX_IDW_STATUS_BAR = 0xE801
-AFX_IDW_PREVIEW_BAR = 0xE802
-AFX_IDW_RESIZE_BAR = 0xE803
-AFX_IDW_DOCKBAR_TOP = 0xE81B
-AFX_IDW_DOCKBAR_LEFT = 0xE81C
-AFX_IDW_DOCKBAR_RIGHT = 0xE81D
-AFX_IDW_DOCKBAR_BOTTOM = 0xE81E
-AFX_IDW_DOCKBAR_FLOAT = 0xE81F
-
-
-def AFX_CONTROLBAR_MASK(nIDC):
-    return 1 << (nIDC - AFX_IDW_CONTROLBAR_FIRST)
-
-
-AFX_IDW_PANE_FIRST = 0xE900
-AFX_IDW_PANE_LAST = 0xE9FF
-AFX_IDW_HSCROLL_FIRST = 0xEA00
-AFX_IDW_VSCROLL_FIRST = 0xEA10
-AFX_IDW_SIZE_BOX = 0xEA20
-AFX_IDW_PANE_SAVE = 0xEA21
-AFX_IDS_APP_TITLE = 0xE000
-AFX_IDS_IDLEMESSAGE = 0xE001
-AFX_IDS_HELPMODEMESSAGE = 0xE002
-AFX_IDS_APP_TITLE_EMBEDDING = 0xE003
-AFX_IDS_COMPANY_NAME = 0xE004
-AFX_IDS_OBJ_TITLE_INPLACE = 0xE005
-ID_FILE_NEW = 0xE100
-ID_FILE_OPEN = 0xE101
-ID_FILE_CLOSE = 0xE102
-ID_FILE_SAVE = 0xE103
-ID_FILE_SAVE_AS = 0xE104
-ID_FILE_PAGE_SETUP = 0xE105
-ID_FILE_PRINT_SETUP = 0xE106
-ID_FILE_PRINT = 0xE107
-ID_FILE_PRINT_DIRECT = 0xE108
-ID_FILE_PRINT_PREVIEW = 0xE109
-ID_FILE_UPDATE = 0xE10A
-ID_FILE_SAVE_COPY_AS = 0xE10B
-ID_FILE_SEND_MAIL = 0xE10C
-ID_FILE_MRU_FIRST = 0xE110
-ID_FILE_MRU_FILE1 = 0xE110
-ID_FILE_MRU_FILE2 = 0xE111
-ID_FILE_MRU_FILE3 = 0xE112
-ID_FILE_MRU_FILE4 = 0xE113
-ID_FILE_MRU_FILE5 = 0xE114
-ID_FILE_MRU_FILE6 = 0xE115
-ID_FILE_MRU_FILE7 = 0xE116
-ID_FILE_MRU_FILE8 = 0xE117
-ID_FILE_MRU_FILE9 = 0xE118
-ID_FILE_MRU_FILE10 = 0xE119
-ID_FILE_MRU_FILE11 = 0xE11A
-ID_FILE_MRU_FILE12 = 0xE11B
-ID_FILE_MRU_FILE13 = 0xE11C
-ID_FILE_MRU_FILE14 = 0xE11D
-ID_FILE_MRU_FILE15 = 0xE11E
-ID_FILE_MRU_FILE16 = 0xE11F
-ID_FILE_MRU_LAST = 0xE11F
-ID_EDIT_CLEAR = 0xE120
-ID_EDIT_CLEAR_ALL = 0xE121
-ID_EDIT_COPY = 0xE122
-ID_EDIT_CUT = 0xE123
-ID_EDIT_FIND = 0xE124
-ID_EDIT_PASTE = 0xE125
-ID_EDIT_PASTE_LINK = 0xE126
-ID_EDIT_PASTE_SPECIAL = 0xE127
-ID_EDIT_REPEAT = 0xE128
-ID_EDIT_REPLACE = 0xE129
-ID_EDIT_SELECT_ALL = 0xE12A
-ID_EDIT_UNDO = 0xE12B
-ID_EDIT_REDO = 0xE12C
-ID_WINDOW_NEW = 0xE130
-ID_WINDOW_ARRANGE = 0xE131
-ID_WINDOW_CASCADE = 0xE132
-ID_WINDOW_TILE_HORZ = 0xE133
-ID_WINDOW_TILE_VERT = 0xE134
-ID_WINDOW_SPLIT = 0xE135
-AFX_IDM_WINDOW_FIRST = 0xE130
-AFX_IDM_WINDOW_LAST = 0xE13F
-AFX_IDM_FIRST_MDICHILD = 0xFF00
-ID_APP_ABOUT = 0xE140
-ID_APP_EXIT = 0xE141
-ID_HELP_INDEX = 0xE142
-ID_HELP_FINDER = 0xE143
-ID_HELP_USING = 0xE144
-ID_CONTEXT_HELP = 0xE145
-ID_HELP = 0xE146
-ID_DEFAULT_HELP = 0xE147
-ID_NEXT_PANE = 0xE150
-ID_PREV_PANE = 0xE151
-ID_FORMAT_FONT = 0xE160
-ID_OLE_INSERT_NEW = 0xE200
-ID_OLE_EDIT_LINKS = 0xE201
-ID_OLE_EDIT_CONVERT = 0xE202
-ID_OLE_EDIT_CHANGE_ICON = 0xE203
-ID_OLE_EDIT_PROPERTIES = 0xE204
-ID_OLE_VERB_FIRST = 0xE210
-ID_OLE_VERB_LAST = 0xE21F
-AFX_ID_PREVIEW_CLOSE = 0xE300
-AFX_ID_PREVIEW_NUMPAGE = 0xE301
-AFX_ID_PREVIEW_NEXT = 0xE302
-AFX_ID_PREVIEW_PREV = 0xE303
-AFX_ID_PREVIEW_PRINT = 0xE304
-AFX_ID_PREVIEW_ZOOMIN = 0xE305
-AFX_ID_PREVIEW_ZOOMOUT = 0xE306
-ID_VIEW_TOOLBAR = 0xE800
-ID_VIEW_STATUS_BAR = 0xE801
-ID_RECORD_FIRST = 0xE900
-ID_RECORD_LAST = 0xE901
-ID_RECORD_NEXT = 0xE902
-ID_RECORD_PREV = 0xE903
-IDC_STATIC = -1
-AFX_IDS_SCFIRST = 0xEF00
-AFX_IDS_SCSIZE = 0xEF00
-AFX_IDS_SCMOVE = 0xEF01
-AFX_IDS_SCMINIMIZE = 0xEF02
-AFX_IDS_SCMAXIMIZE = 0xEF03
-AFX_IDS_SCNEXTWINDOW = 0xEF04
-AFX_IDS_SCPREVWINDOW = 0xEF05
-AFX_IDS_SCCLOSE = 0xEF06
-AFX_IDS_SCRESTORE = 0xEF12
-AFX_IDS_SCTASKLIST = 0xEF13
-AFX_IDS_MDICHILD = 0xEF1F
-AFX_IDS_DESKACCESSORY = 0xEFDA
-AFX_IDS_OPENFILE = 0xF000
-AFX_IDS_SAVEFILE = 0xF001
-AFX_IDS_ALLFILTER = 0xF002
-AFX_IDS_UNTITLED = 0xF003
-AFX_IDS_SAVEFILECOPY = 0xF004
-AFX_IDS_PREVIEW_CLOSE = 0xF005
-AFX_IDS_UNNAMED_FILE = 0xF006
-AFX_IDS_ABOUT = 0xF010
-AFX_IDS_HIDE = 0xF011
-AFX_IDP_NO_ERROR_AVAILABLE = 0xF020
-AFX_IDS_NOT_SUPPORTED_EXCEPTION = 0xF021
-AFX_IDS_RESOURCE_EXCEPTION = 0xF022
-AFX_IDS_MEMORY_EXCEPTION = 0xF023
-AFX_IDS_USER_EXCEPTION = 0xF024
-AFX_IDS_PRINTONPORT = 0xF040
-AFX_IDS_ONEPAGE = 0xF041
-AFX_IDS_TWOPAGE = 0xF042
-AFX_IDS_PRINTPAGENUM = 0xF043
-AFX_IDS_PREVIEWPAGEDESC = 0xF044
-AFX_IDS_PRINTDEFAULTEXT = 0xF045
-AFX_IDS_PRINTDEFAULT = 0xF046
-AFX_IDS_PRINTFILTER = 0xF047
-AFX_IDS_PRINTCAPTION = 0xF048
-AFX_IDS_PRINTTOFILE = 0xF049
-AFX_IDS_OBJECT_MENUITEM = 0xF080
-AFX_IDS_EDIT_VERB = 0xF081
-AFX_IDS_ACTIVATE_VERB = 0xF082
-AFX_IDS_CHANGE_LINK = 0xF083
-AFX_IDS_AUTO = 0xF084
-AFX_IDS_MANUAL = 0xF085
-AFX_IDS_FROZEN = 0xF086
-AFX_IDS_ALL_FILES = 0xF087
-AFX_IDS_SAVE_MENU = 0xF088
-AFX_IDS_UPDATE_MENU = 0xF089
-AFX_IDS_SAVE_AS_MENU = 0xF08A
-AFX_IDS_SAVE_COPY_AS_MENU = 0xF08B
-AFX_IDS_EXIT_MENU = 0xF08C
-AFX_IDS_UPDATING_ITEMS = 0xF08D
-AFX_IDS_METAFILE_FORMAT = 0xF08E
-AFX_IDS_DIB_FORMAT = 0xF08F
-AFX_IDS_BITMAP_FORMAT = 0xF090
-AFX_IDS_LINKSOURCE_FORMAT = 0xF091
-AFX_IDS_EMBED_FORMAT = 0xF092
-AFX_IDS_PASTELINKEDTYPE = 0xF094
-AFX_IDS_UNKNOWNTYPE = 0xF095
-AFX_IDS_RTF_FORMAT = 0xF096
-AFX_IDS_TEXT_FORMAT = 0xF097
-AFX_IDS_INVALID_CURRENCY = 0xF098
-AFX_IDS_INVALID_DATETIME = 0xF099
-AFX_IDS_INVALID_DATETIMESPAN = 0xF09A
-AFX_IDP_INVALID_FILENAME = 0xF100
-AFX_IDP_FAILED_TO_OPEN_DOC = 0xF101
-AFX_IDP_FAILED_TO_SAVE_DOC = 0xF102
-AFX_IDP_ASK_TO_SAVE = 0xF103
-AFX_IDP_FAILED_TO_CREATE_DOC = 0xF104
-AFX_IDP_FILE_TOO_LARGE = 0xF105
-AFX_IDP_FAILED_TO_START_PRINT = 0xF106
-AFX_IDP_FAILED_TO_LAUNCH_HELP = 0xF107
-AFX_IDP_INTERNAL_FAILURE = 0xF108
-AFX_IDP_COMMAND_FAILURE = 0xF109
-AFX_IDP_FAILED_MEMORY_ALLOC = 0xF10A
-AFX_IDP_PARSE_INT = 0xF110
-AFX_IDP_PARSE_REAL = 0xF111
-AFX_IDP_PARSE_INT_RANGE = 0xF112
-AFX_IDP_PARSE_REAL_RANGE = 0xF113
-AFX_IDP_PARSE_STRING_SIZE = 0xF114
-AFX_IDP_PARSE_RADIO_BUTTON = 0xF115
-AFX_IDP_PARSE_BYTE = 0xF116
-AFX_IDP_PARSE_UINT = 0xF117
-AFX_IDP_PARSE_DATETIME = 0xF118
-AFX_IDP_PARSE_CURRENCY = 0xF119
-AFX_IDP_FAILED_INVALID_FORMAT = 0xF120
-AFX_IDP_FAILED_INVALID_PATH = 0xF121
-AFX_IDP_FAILED_DISK_FULL = 0xF122
-AFX_IDP_FAILED_ACCESS_READ = 0xF123
-AFX_IDP_FAILED_ACCESS_WRITE = 0xF124
-AFX_IDP_FAILED_IO_ERROR_READ = 0xF125
-AFX_IDP_FAILED_IO_ERROR_WRITE = 0xF126
-AFX_IDP_STATIC_OBJECT = 0xF180
-AFX_IDP_FAILED_TO_CONNECT = 0xF181
-AFX_IDP_SERVER_BUSY = 0xF182
-AFX_IDP_BAD_VERB = 0xF183
-AFX_IDP_FAILED_TO_NOTIFY = 0xF185
-AFX_IDP_FAILED_TO_LAUNCH = 0xF186
-AFX_IDP_ASK_TO_UPDATE = 0xF187
-AFX_IDP_FAILED_TO_UPDATE = 0xF188
-AFX_IDP_FAILED_TO_REGISTER = 0xF189
-AFX_IDP_FAILED_TO_AUTO_REGISTER = 0xF18A
-AFX_IDP_FAILED_TO_CONVERT = 0xF18B
-AFX_IDP_GET_NOT_SUPPORTED = 0xF18C
-AFX_IDP_SET_NOT_SUPPORTED = 0xF18D
-AFX_IDP_ASK_TO_DISCARD = 0xF18E
-AFX_IDP_FAILED_TO_CREATE = 0xF18F
-AFX_IDP_FAILED_MAPI_LOAD = 0xF190
-AFX_IDP_INVALID_MAPI_DLL = 0xF191
-AFX_IDP_FAILED_MAPI_SEND = 0xF192
-AFX_IDP_FILE_NONE = 0xF1A0
-AFX_IDP_FILE_GENERIC = 0xF1A1
-AFX_IDP_FILE_NOT_FOUND = 0xF1A2
-AFX_IDP_FILE_BAD_PATH = 0xF1A3
-AFX_IDP_FILE_TOO_MANY_OPEN = 0xF1A4
-AFX_IDP_FILE_ACCESS_DENIED = 0xF1A5
-AFX_IDP_FILE_INVALID_FILE = 0xF1A6
-AFX_IDP_FILE_REMOVE_CURRENT = 0xF1A7
-AFX_IDP_FILE_DIR_FULL = 0xF1A8
-AFX_IDP_FILE_BAD_SEEK = 0xF1A9
-AFX_IDP_FILE_HARD_IO = 0xF1AA
-AFX_IDP_FILE_SHARING = 0xF1AB
-AFX_IDP_FILE_LOCKING = 0xF1AC
-AFX_IDP_FILE_DISKFULL = 0xF1AD
-AFX_IDP_FILE_EOF = 0xF1AE
-AFX_IDP_ARCH_NONE = 0xF1B0
-AFX_IDP_ARCH_GENERIC = 0xF1B1
-AFX_IDP_ARCH_READONLY = 0xF1B2
-AFX_IDP_ARCH_ENDOFFILE = 0xF1B3
-AFX_IDP_ARCH_WRITEONLY = 0xF1B4
-AFX_IDP_ARCH_BADINDEX = 0xF1B5
-AFX_IDP_ARCH_BADCLASS = 0xF1B6
-AFX_IDP_ARCH_BADSCHEMA = 0xF1B7
-AFX_IDS_OCC_SCALEUNITS_PIXELS = 0xF1C0
-AFX_IDS_STATUS_FONT = 0xF230
-AFX_IDS_TOOLTIP_FONT = 0xF231
-AFX_IDS_UNICODE_FONT = 0xF232
-AFX_IDS_MINI_FONT = 0xF233
-AFX_IDP_SQL_FIRST = 0xF280
-AFX_IDP_SQL_CONNECT_FAIL = 0xF281
-AFX_IDP_SQL_RECORDSET_FORWARD_ONLY = 0xF282
-AFX_IDP_SQL_EMPTY_COLUMN_LIST = 0xF283
-AFX_IDP_SQL_FIELD_SCHEMA_MISMATCH = 0xF284
-AFX_IDP_SQL_ILLEGAL_MODE = 0xF285
-AFX_IDP_SQL_MULTIPLE_ROWS_AFFECTED = 0xF286
-AFX_IDP_SQL_NO_CURRENT_RECORD = 0xF287
-AFX_IDP_SQL_NO_ROWS_AFFECTED = 0xF288
-AFX_IDP_SQL_RECORDSET_READONLY = 0xF289
-AFX_IDP_SQL_SQL_NO_TOTAL = 0xF28A
-AFX_IDP_SQL_ODBC_LOAD_FAILED = 0xF28B
-AFX_IDP_SQL_DYNASET_NOT_SUPPORTED = 0xF28C
-AFX_IDP_SQL_SNAPSHOT_NOT_SUPPORTED = 0xF28D
-AFX_IDP_SQL_API_CONFORMANCE = 0xF28E
-AFX_IDP_SQL_SQL_CONFORMANCE = 0xF28F
-AFX_IDP_SQL_NO_DATA_FOUND = 0xF290
-AFX_IDP_SQL_ROW_UPDATE_NOT_SUPPORTED = 0xF291
-AFX_IDP_SQL_ODBC_V2_REQUIRED = 0xF292
-AFX_IDP_SQL_NO_POSITIONED_UPDATES = 0xF293
-AFX_IDP_SQL_LOCK_MODE_NOT_SUPPORTED = 0xF294
-AFX_IDP_SQL_DATA_TRUNCATED = 0xF295
-AFX_IDP_SQL_ROW_FETCH = 0xF296
-AFX_IDP_SQL_INCORRECT_ODBC = 0xF297
-AFX_IDP_SQL_UPDATE_DELETE_FAILED = 0xF298
-AFX_IDP_SQL_DYNAMIC_CURSOR_NOT_SUPPORTED = 0xF299
-AFX_IDP_DAO_FIRST = 0xF2A0
-AFX_IDP_DAO_ENGINE_INITIALIZATION = 0xF2A0
-AFX_IDP_DAO_DFX_BIND = 0xF2A1
-AFX_IDP_DAO_OBJECT_NOT_OPEN = 0xF2A2
-AFX_IDP_DAO_ROWTOOSHORT = 0xF2A3
-AFX_IDP_DAO_BADBINDINFO = 0xF2A4
-AFX_IDP_DAO_COLUMNUNAVAILABLE = 0xF2A5
-AFX_IDC_LISTBOX = 100
-AFX_IDC_CHANGE = 101
-AFX_IDC_PRINT_DOCNAME = 201
-AFX_IDC_PRINT_PRINTERNAME = 202
-AFX_IDC_PRINT_PORTNAME = 203
-AFX_IDC_PRINT_PAGENUM = 204
-ID_APPLY_NOW = 0x3021
-ID_WIZBACK = 0x3023
-ID_WIZNEXT = 0x3024
-ID_WIZFINISH = 0x3025
-AFX_IDC_TAB_CONTROL = 0x3020
-AFX_IDD_FILEOPEN = 28676
-AFX_IDD_FILESAVE = 28677
-AFX_IDD_FONT = 28678
-AFX_IDD_COLOR = 28679
-AFX_IDD_PRINT = 28680
-AFX_IDD_PRINTSETUP = 28681
-AFX_IDD_FIND = 28682
-AFX_IDD_REPLACE = 28683
-AFX_IDD_NEWTYPEDLG = 30721
-AFX_IDD_PRINTDLG = 30722
-AFX_IDD_PREVIEW_TOOLBAR = 30723
-AFX_IDD_PREVIEW_SHORTTOOLBAR = 30731
-AFX_IDD_INSERTOBJECT = 30724
-AFX_IDD_CHANGEICON = 30725
-AFX_IDD_CONVERT = 30726
-AFX_IDD_PASTESPECIAL = 30727
-AFX_IDD_EDITLINKS = 30728
-AFX_IDD_FILEBROWSE = 30729
-AFX_IDD_BUSY = 30730
-AFX_IDD_OBJECTPROPERTIES = 30732
-AFX_IDD_CHANGESOURCE = 30733
-AFX_IDC_CONTEXTHELP = 30977
-AFX_IDC_MAGNIFY = 30978
-AFX_IDC_SMALLARROWS = 30979
-AFX_IDC_HSPLITBAR = 30980
-AFX_IDC_VSPLITBAR = 30981
-AFX_IDC_NODROPCRSR = 30982
-AFX_IDC_TRACKNWSE = 30983
-AFX_IDC_TRACKNESW = 30984
-AFX_IDC_TRACKNS = 30985
-AFX_IDC_TRACKWE = 30986
-AFX_IDC_TRACK4WAY = 30987
-AFX_IDC_MOVE4WAY = 30988
-AFX_IDB_MINIFRAME_MENU = 30994
-AFX_IDB_CHECKLISTBOX_NT = 30995
-AFX_IDB_CHECKLISTBOX_95 = 30996
-AFX_IDR_PREVIEW_ACCEL = 30997
-AFX_IDI_STD_MDIFRAME = 31233
-AFX_IDI_STD_FRAME = 31234
-AFX_IDC_FONTPROP = 1000
-AFX_IDC_FONTNAMES = 1001
-AFX_IDC_FONTSTYLES = 1002
-AFX_IDC_FONTSIZES = 1003
-AFX_IDC_STRIKEOUT = 1004
-AFX_IDC_UNDERLINE = 1005
-AFX_IDC_SAMPLEBOX = 1006
-AFX_IDC_COLOR_BLACK = 1100
-AFX_IDC_COLOR_WHITE = 1101
-AFX_IDC_COLOR_RED = 1102
-AFX_IDC_COLOR_GREEN = 1103
-AFX_IDC_COLOR_BLUE = 1104
-AFX_IDC_COLOR_YELLOW = 1105
-AFX_IDC_COLOR_MAGENTA = 1106
-AFX_IDC_COLOR_CYAN = 1107
-AFX_IDC_COLOR_GRAY = 1108
-AFX_IDC_COLOR_LIGHTGRAY = 1109
-AFX_IDC_COLOR_DARKRED = 1110
-AFX_IDC_COLOR_DARKGREEN = 1111
-AFX_IDC_COLOR_DARKBLUE = 1112
-AFX_IDC_COLOR_LIGHTBROWN = 1113
-AFX_IDC_COLOR_DARKMAGENTA = 1114
-AFX_IDC_COLOR_DARKCYAN = 1115
-AFX_IDC_COLORPROP = 1116
-AFX_IDC_SYSTEMCOLORS = 1117
-AFX_IDC_PROPNAME = 1201
-AFX_IDC_PICTURE = 1202
-AFX_IDC_BROWSE = 1203
-AFX_IDC_CLEAR = 1204
-AFX_IDD_PROPPAGE_COLOR = 32257
-AFX_IDD_PROPPAGE_FONT = 32258
-AFX_IDD_PROPPAGE_PICTURE = 32259
-AFX_IDB_TRUETYPE = 32384
-AFX_IDS_PROPPAGE_UNKNOWN = 0xFE01
-AFX_IDS_COLOR_DESKTOP = 0xFE04
-AFX_IDS_COLOR_APPWORKSPACE = 0xFE05
-AFX_IDS_COLOR_WNDBACKGND = 0xFE06
-AFX_IDS_COLOR_WNDTEXT = 0xFE07
-AFX_IDS_COLOR_MENUBAR = 0xFE08
-AFX_IDS_COLOR_MENUTEXT = 0xFE09
-AFX_IDS_COLOR_ACTIVEBAR = 0xFE0A
-AFX_IDS_COLOR_INACTIVEBAR = 0xFE0B
-AFX_IDS_COLOR_ACTIVETEXT = 0xFE0C
-AFX_IDS_COLOR_INACTIVETEXT = 0xFE0D
-AFX_IDS_COLOR_ACTIVEBORDER = 0xFE0E
-AFX_IDS_COLOR_INACTIVEBORDER = 0xFE0F
-AFX_IDS_COLOR_WNDFRAME = 0xFE10
-AFX_IDS_COLOR_SCROLLBARS = 0xFE11
-AFX_IDS_COLOR_BTNFACE = 0xFE12
-AFX_IDS_COLOR_BTNSHADOW = 0xFE13
-AFX_IDS_COLOR_BTNTEXT = 0xFE14
-AFX_IDS_COLOR_BTNHIGHLIGHT = 0xFE15
-AFX_IDS_COLOR_DISABLEDTEXT = 0xFE16
-AFX_IDS_COLOR_HIGHLIGHT = 0xFE17
-AFX_IDS_COLOR_HIGHLIGHTTEXT = 0xFE18
-AFX_IDS_REGULAR = 0xFE19
-AFX_IDS_BOLD = 0xFE1A
-AFX_IDS_ITALIC = 0xFE1B
-AFX_IDS_BOLDITALIC = 0xFE1C
-AFX_IDS_SAMPLETEXT = 0xFE1D
-AFX_IDS_DISPLAYSTRING_FONT = 0xFE1E
-AFX_IDS_DISPLAYSTRING_COLOR = 0xFE1F
-AFX_IDS_DISPLAYSTRING_PICTURE = 0xFE20
-AFX_IDS_PICTUREFILTER = 0xFE21
-AFX_IDS_PICTYPE_UNKNOWN = 0xFE22
-AFX_IDS_PICTYPE_NONE = 0xFE23
-AFX_IDS_PICTYPE_BITMAP = 0xFE24
-AFX_IDS_PICTYPE_METAFILE = 0xFE25
-AFX_IDS_PICTYPE_ICON = 0xFE26
-AFX_IDS_COLOR_PPG = 0xFE28
-AFX_IDS_COLOR_PPG_CAPTION = 0xFE29
-AFX_IDS_FONT_PPG = 0xFE2A
-AFX_IDS_FONT_PPG_CAPTION = 0xFE2B
-AFX_IDS_PICTURE_PPG = 0xFE2C
-AFX_IDS_PICTURE_PPG_CAPTION = 0xFE2D
-AFX_IDS_PICTUREBROWSETITLE = 0xFE30
-AFX_IDS_BORDERSTYLE_0 = 0xFE31
-AFX_IDS_BORDERSTYLE_1 = 0xFE32
-AFX_IDS_VERB_EDIT = 0xFE40
-AFX_IDS_VERB_PROPERTIES = 0xFE41
-AFX_IDP_PICTURECANTOPEN = 0xFE83
-AFX_IDP_PICTURECANTLOAD = 0xFE84
-AFX_IDP_PICTURETOOLARGE = 0xFE85
-AFX_IDP_PICTUREREADFAILED = 0xFE86
-AFX_IDP_E_ILLEGALFUNCTIONCALL = 0xFEA0
-AFX_IDP_E_OVERFLOW = 0xFEA1
-AFX_IDP_E_OUTOFMEMORY = 0xFEA2
-AFX_IDP_E_DIVISIONBYZERO = 0xFEA3
-AFX_IDP_E_OUTOFSTRINGSPACE = 0xFEA4
-AFX_IDP_E_OUTOFSTACKSPACE = 0xFEA5
-AFX_IDP_E_BADFILENAMEORNUMBER = 0xFEA6
-AFX_IDP_E_FILENOTFOUND = 0xFEA7
-AFX_IDP_E_BADFILEMODE = 0xFEA8
-AFX_IDP_E_FILEALREADYOPEN = 0xFEA9
-AFX_IDP_E_DEVICEIOERROR = 0xFEAA
-AFX_IDP_E_FILEALREADYEXISTS = 0xFEAB
-AFX_IDP_E_BADRECORDLENGTH = 0xFEAC
-AFX_IDP_E_DISKFULL = 0xFEAD
-AFX_IDP_E_BADRECORDNUMBER = 0xFEAE
-AFX_IDP_E_BADFILENAME = 0xFEAF
-AFX_IDP_E_TOOMANYFILES = 0xFEB0
-AFX_IDP_E_DEVICEUNAVAILABLE = 0xFEB1
-AFX_IDP_E_PERMISSIONDENIED = 0xFEB2
-AFX_IDP_E_DISKNOTREADY = 0xFEB3
-AFX_IDP_E_PATHFILEACCESSERROR = 0xFEB4
-AFX_IDP_E_PATHNOTFOUND = 0xFEB5
-AFX_IDP_E_INVALIDPATTERNSTRING = 0xFEB6
-AFX_IDP_E_INVALIDUSEOFNULL = 0xFEB7
-AFX_IDP_E_INVALIDFILEFORMAT = 0xFEB8
-AFX_IDP_E_INVALIDPROPERTYVALUE = 0xFEB9
-AFX_IDP_E_INVALIDPROPERTYARRAYINDEX = 0xFEBA
-AFX_IDP_E_SETNOTSUPPORTEDATRUNTIME = 0xFEBB
-AFX_IDP_E_SETNOTSUPPORTED = 0xFEBC
-AFX_IDP_E_NEEDPROPERTYARRAYINDEX = 0xFEBD
-AFX_IDP_E_SETNOTPERMITTED = 0xFEBE
-AFX_IDP_E_GETNOTSUPPORTEDATRUNTIME = 0xFEBF
-AFX_IDP_E_GETNOTSUPPORTED = 0xFEC0
-AFX_IDP_E_PROPERTYNOTFOUND = 0xFEC1
-AFX_IDP_E_INVALIDCLIPBOARDFORMAT = 0xFEC2
-AFX_IDP_E_INVALIDPICTURE = 0xFEC3
-AFX_IDP_E_PRINTERERROR = 0xFEC4
-AFX_IDP_E_CANTSAVEFILETOTEMP = 0xFEC5
-AFX_IDP_E_SEARCHTEXTNOTFOUND = 0xFEC6
-AFX_IDP_E_REPLACEMENTSTOOLONG = 0xFEC7
diff --git a/lib/pythonwin/pywin/mfc/dialog.py b/lib/pythonwin/pywin/mfc/dialog.py
deleted file mode 100644
index 25fe1363..00000000
--- a/lib/pythonwin/pywin/mfc/dialog.py
+++ /dev/null
@@ -1,278 +0,0 @@
-""" \
-Base class for Dialogs.  Also contains a few useful utility functions
-"""
-# dialog.py
-# Python class for Dialog Boxes in PythonWin.
-
-import win32con
-import win32ui
-
-# sob - 2to3 doesn't see this as a relative import :(
-from pywin.mfc import window
-
-
-def dllFromDll(dllid):
-    "given a 'dll' (maybe a dll, filename, etc), return a DLL object"
-    if dllid == None:
-        return None
-    elif type("") == type(dllid):
-        return win32ui.LoadLibrary(dllid)
-    else:
-        try:
-            dllid.GetFileName()
-        except AttributeError:
-            raise TypeError("DLL parameter must be None, a filename or a dll object")
-        return dllid
-
-
-class Dialog(window.Wnd):
-    "Base class for a dialog"
-
-    def __init__(self, id, dllid=None):
-        """id is the resource ID, or a template
-        dllid may be None, a dll object, or a string with a dll name"""
-        # must take a reference to the DLL until InitDialog.
-        self.dll = dllFromDll(dllid)
-        if type(id) == type([]):  # a template
-            dlg = win32ui.CreateDialogIndirect(id)
-        else:
-            dlg = win32ui.CreateDialog(id, self.dll)
-        window.Wnd.__init__(self, dlg)
-        self.HookCommands()
-        self.bHaveInit = None
-
-    def HookCommands(self):
-        pass
-
-    def OnAttachedObjectDeath(self):
-        self.data = self._obj_.data
-        window.Wnd.OnAttachedObjectDeath(self)
-
-    # provide virtuals.
-    def OnOK(self):
-        self._obj_.OnOK()
-
-    def OnCancel(self):
-        self._obj_.OnCancel()
-
-    def OnInitDialog(self):
-        self.bHaveInit = 1
-        if self._obj_.data:
-            self._obj_.UpdateData(0)
-        return 1  # I did NOT set focus to a child window.
-
-    def OnDestroy(self, msg):
-        self.dll = None  # theoretically not needed if object destructs normally.
-
-    # DDX support
-    def AddDDX(self, *args):
-        self._obj_.datalist.append(args)
-
-    # Make a dialog object look like a dictionary for the DDX support
-    def __bool__(self):
-        return True
-
-    def __len__(self):
-        return len(self.data)
-
-    def __getitem__(self, key):
-        return self.data[key]
-
-    def __setitem__(self, key, item):
-        self._obj_.data[key] = item  # self.UpdateData(0)
-
-    def keys(self):
-        return list(self.data.keys())
-
-    def items(self):
-        return list(self.data.items())
-
-    def values(self):
-        return list(self.data.values())
-
-    # XXX - needs py3k work!
-    def has_key(self, key):
-        return key in self.data
-
-
-class PrintDialog(Dialog):
-    "Base class for a print dialog"
-
-    def __init__(
-        self,
-        pInfo,
-        dlgID,
-        printSetupOnly=0,
-        flags=(
-            win32ui.PD_ALLPAGES
-            | win32ui.PD_USEDEVMODECOPIES
-            | win32ui.PD_NOPAGENUMS
-            | win32ui.PD_HIDEPRINTTOFILE
-            | win32ui.PD_NOSELECTION
-        ),
-        parent=None,
-        dllid=None,
-    ):
-        self.dll = dllFromDll(dllid)
-        if type(dlgID) == type([]):  # a template
-            raise TypeError("dlgID parameter must be an integer resource ID")
-        dlg = win32ui.CreatePrintDialog(dlgID, printSetupOnly, flags, parent, self.dll)
-        window.Wnd.__init__(self, dlg)
-        self.HookCommands()
-        self.bHaveInit = None
-        self.pInfo = pInfo
-        # init values (if PrintSetup is called, values still available)
-        flags = pInfo.GetFlags()
-        self["toFile"] = flags & win32ui.PD_PRINTTOFILE != 0
-        self["direct"] = pInfo.GetDirect()
-        self["preview"] = pInfo.GetPreview()
-        self["continuePrinting"] = pInfo.GetContinuePrinting()
-        self["curPage"] = pInfo.GetCurPage()
-        self["numPreviewPages"] = pInfo.GetNumPreviewPages()
-        self["userData"] = pInfo.GetUserData()
-        self["draw"] = pInfo.GetDraw()
-        self["pageDesc"] = pInfo.GetPageDesc()
-        self["minPage"] = pInfo.GetMinPage()
-        self["maxPage"] = pInfo.GetMaxPage()
-        self["offsetPage"] = pInfo.GetOffsetPage()
-        self["fromPage"] = pInfo.GetFromPage()
-        self["toPage"] = pInfo.GetToPage()
-        # these values updated after OnOK
-        self["copies"] = 0
-        self["deviceName"] = ""
-        self["driverName"] = ""
-        self["printAll"] = 0
-        self["printCollate"] = 0
-        self["printRange"] = 0
-        self["printSelection"] = 0
-
-    def OnInitDialog(self):
-        self.pInfo.CreatePrinterDC()  # This also sets the hDC of the pInfo structure.
-        return self._obj_.OnInitDialog()
-
-    def OnCancel(self):
-        del self.pInfo
-
-    def OnOK(self):
-        """DoModal has finished. Can now access the users choices"""
-        self._obj_.OnOK()
-        pInfo = self.pInfo
-        # user values
-        flags = pInfo.GetFlags()
-        self["toFile"] = flags & win32ui.PD_PRINTTOFILE != 0
-        self["direct"] = pInfo.GetDirect()
-        self["preview"] = pInfo.GetPreview()
-        self["continuePrinting"] = pInfo.GetContinuePrinting()
-        self["curPage"] = pInfo.GetCurPage()
-        self["numPreviewPages"] = pInfo.GetNumPreviewPages()
-        self["userData"] = pInfo.GetUserData()
-        self["draw"] = pInfo.GetDraw()
-        self["pageDesc"] = pInfo.GetPageDesc()
-        self["minPage"] = pInfo.GetMinPage()
-        self["maxPage"] = pInfo.GetMaxPage()
-        self["offsetPage"] = pInfo.GetOffsetPage()
-        self["fromPage"] = pInfo.GetFromPage()
-        self["toPage"] = pInfo.GetToPage()
-        self["copies"] = pInfo.GetCopies()
-        self["deviceName"] = pInfo.GetDeviceName()
-        self["driverName"] = pInfo.GetDriverName()
-        self["printAll"] = pInfo.PrintAll()
-        self["printCollate"] = pInfo.PrintCollate()
-        self["printRange"] = pInfo.PrintRange()
-        self["printSelection"] = pInfo.PrintSelection()
-        del self.pInfo
-
-
-class PropertyPage(Dialog):
-    "Base class for a Property Page"
-
-    def __init__(self, id, dllid=None, caption=0):
-        """id is the resource ID
-        dllid may be None, a dll object, or a string with a dll name"""
-
-        self.dll = dllFromDll(dllid)
-        if self.dll:
-            oldRes = win32ui.SetResource(self.dll)
-        if type(id) == type([]):
-            dlg = win32ui.CreatePropertyPageIndirect(id)
-        else:
-            dlg = win32ui.CreatePropertyPage(id, caption)
-        if self.dll:
-            win32ui.SetResource(oldRes)
-        # dont call dialog init!
-        window.Wnd.__init__(self, dlg)
-        self.HookCommands()
-
-
-class PropertySheet(window.Wnd):
-    def __init__(self, caption, dll=None, pageList=None):  # parent=None, style,etc):
-        "Initialize a property sheet.  pageList is a list of ID's"
-        # must take a reference to the DLL until InitDialog.
-        self.dll = dllFromDll(dll)
-        self.sheet = win32ui.CreatePropertySheet(caption)
-        window.Wnd.__init__(self, self.sheet)
-        if not pageList is None:
-            self.AddPage(pageList)
-
-    def OnInitDialog(self):
-        return self._obj_.OnInitDialog()
-
-    def DoModal(self):
-        if self.dll:
-            oldRes = win32ui.SetResource(self.dll)
-        rc = self.sheet.DoModal()
-        if self.dll:
-            win32ui.SetResource(oldRes)
-        return rc
-
-    def AddPage(self, pages):
-        if self.dll:
-            oldRes = win32ui.SetResource(self.dll)
-        try:  # try list style access
-            pages[0]
-            isSeq = 1
-        except (TypeError, KeyError):
-            isSeq = 0
-        if isSeq:
-            for page in pages:
-                self.DoAddSinglePage(page)
-        else:
-            self.DoAddSinglePage(pages)
-        if self.dll:
-            win32ui.SetResource(oldRes)
-
-    def DoAddSinglePage(self, page):
-        "Page may be page, or int ID. Assumes DLL setup"
-        if type(page) == type(0):
-            self.sheet.AddPage(win32ui.CreatePropertyPage(page))
-        else:
-            self.sheet.AddPage(page)
-
-
-# define some app utility functions.
-def GetSimpleInput(prompt, defValue="", title=None):
-    """displays a dialog, and returns a string, or None if cancelled.
-    args prompt, defValue='', title=main frames title"""
-    # uses a simple dialog to return a string object.
-    if title is None:
-        title = win32ui.GetMainFrame().GetWindowText()
-    # 2to3 insists on converting 'Dialog.__init__' to 'tkinter.dialog...'
-    DlgBaseClass = Dialog
-
-    class DlgSimpleInput(DlgBaseClass):
-        def __init__(self, prompt, defValue, title):
-            self.title = title
-            DlgBaseClass.__init__(self, win32ui.IDD_SIMPLE_INPUT)
-            self.AddDDX(win32ui.IDC_EDIT1, "result")
-            self.AddDDX(win32ui.IDC_PROMPT1, "prompt")
-            self._obj_.data["result"] = defValue
-            self._obj_.data["prompt"] = prompt
-
-        def OnInitDialog(self):
-            self.SetWindowText(self.title)
-            return DlgBaseClass.OnInitDialog(self)
-
-    dlg = DlgSimpleInput(prompt, defValue, title)
-    if dlg.DoModal() != win32con.IDOK:
-        return None
-    return dlg["result"]
diff --git a/lib/pythonwin/pywin/mfc/docview.py b/lib/pythonwin/pywin/mfc/docview.py
deleted file mode 100644
index 7da91b46..00000000
--- a/lib/pythonwin/pywin/mfc/docview.py
+++ /dev/null
@@ -1,151 +0,0 @@
-# document and view classes for MFC.
-import win32ui
-
-from . import object, window
-
-
-class View(window.Wnd):
-    def __init__(self, initobj):
-        window.Wnd.__init__(self, initobj)
-
-    def OnInitialUpdate(self):
-        pass
-
-
-# Simple control based views.
-class CtrlView(View):
-    def __init__(self, doc, wndclass, style=0):
-        View.__init__(self, win32ui.CreateCtrlView(doc, wndclass, style))
-
-
-class EditView(CtrlView):
-    def __init__(self, doc):
-        View.__init__(self, win32ui.CreateEditView(doc))
-
-
-class RichEditView(CtrlView):
-    def __init__(self, doc):
-        View.__init__(self, win32ui.CreateRichEditView(doc))
-
-
-class ListView(CtrlView):
-    def __init__(self, doc):
-        View.__init__(self, win32ui.CreateListView(doc))
-
-
-class TreeView(CtrlView):
-    def __init__(self, doc):
-        View.__init__(self, win32ui.CreateTreeView(doc))
-
-
-# Other more advanced views.
-class ScrollView(View):
-    def __init__(self, doc):
-        View.__init__(self, win32ui.CreateView(doc))
-
-
-class FormView(View):
-    def __init__(self, doc, id):
-        View.__init__(self, win32ui.CreateFormView(doc, id))
-
-
-class Document(object.CmdTarget):
-    def __init__(self, template, docobj=None):
-        if docobj is None:
-            docobj = template.DoCreateDoc()
-        object.CmdTarget.__init__(self, docobj)
-
-
-class RichEditDoc(object.CmdTarget):
-    def __init__(self, template):
-        object.CmdTarget.__init__(self, template.DoCreateRichEditDoc())
-
-
-class CreateContext:
-    "A transient base class used as a CreateContext"
-
-    def __init__(self, template, doc=None):
-        self.template = template
-        self.doc = doc
-
-    def __del__(self):
-        self.close()
-
-    def close(self):
-        self.doc = None
-        self.template = None
-
-
-class DocTemplate(object.CmdTarget):
-    def __init__(
-        self, resourceId=None, MakeDocument=None, MakeFrame=None, MakeView=None
-    ):
-        if resourceId is None:
-            resourceId = win32ui.IDR_PYTHONTYPE
-        object.CmdTarget.__init__(self, self._CreateDocTemplate(resourceId))
-        self.MakeDocument = MakeDocument
-        self.MakeFrame = MakeFrame
-        self.MakeView = MakeView
-        self._SetupSharedMenu_()
-
-    def _SetupSharedMenu_(self):
-        pass  # to be overridden by each "app"
-
-    def _CreateDocTemplate(self, resourceId):
-        return win32ui.CreateDocTemplate(resourceId)
-
-    def __del__(self):
-        object.CmdTarget.__del__(self)
-
-    def CreateCreateContext(self, doc=None):
-        return CreateContext(self, doc)
-
-    def CreateNewFrame(self, doc):
-        makeFrame = self.MakeFrame
-        if makeFrame is None:
-            makeFrame = window.MDIChildWnd
-        wnd = makeFrame()
-        context = self.CreateCreateContext(doc)
-        wnd.LoadFrame(
-            self.GetResourceID(), -1, None, context
-        )  # triggers OnCreateClient...
-        return wnd
-
-    def CreateNewDocument(self):
-        makeDocument = self.MakeDocument
-        if makeDocument is None:
-            makeDocument = Document
-        return makeDocument(self)
-
-    def CreateView(self, frame, context):
-        makeView = self.MakeView
-        if makeView is None:
-            makeView = EditView
-        view = makeView(context.doc)
-        view.CreateWindow(frame)
-
-
-class RichEditDocTemplate(DocTemplate):
-    def __init__(
-        self, resourceId=None, MakeDocument=None, MakeFrame=None, MakeView=None
-    ):
-        if MakeView is None:
-            MakeView = RichEditView
-        if MakeDocument is None:
-            MakeDocument = RichEditDoc
-        DocTemplate.__init__(self, resourceId, MakeDocument, MakeFrame, MakeView)
-
-    def _CreateDocTemplate(self, resourceId):
-        return win32ui.CreateRichEditDocTemplate(resourceId)
-
-
-def t():
-    class FormTemplate(DocTemplate):
-        def CreateView(self, frame, context):
-            makeView = self.MakeView
-            # 			view = FormView(context.doc, win32ui.IDD_PROPDEMO1)
-            view = ListView(context.doc)
-            view.CreateWindow(frame)
-
-    t = FormTemplate()
-    return t.OpenDocumentFile(None)
diff --git a/lib/pythonwin/pywin/mfc/object.py b/lib/pythonwin/pywin/mfc/object.py
deleted file mode 100644
index 70138b6e..00000000
--- a/lib/pythonwin/pywin/mfc/object.py
+++ /dev/null
@@ -1,66 +0,0 @@
-# MFC base classes.
-
-import win32ui
-
-
-class Object:
-    def __init__(self, initObj=None):
-        self.__dict__["_obj_"] = initObj
-        # 		self._obj_ = initObj
-        if initObj is not None:
-            initObj.AttachObject(self)
-
-    def __del__(self):
-        self.close()
-
-    def __getattr__(
-        self, attr
-    ):  # Make this object look like the underlying win32ui one.
-        # During cleanup __dict__ is not available, causing recursive death.
-        if not attr.startswith("__"):
-            try:
-                o = self.__dict__["_obj_"]
-                if o is not None:
-                    return getattr(o, attr)
-                # Only raise this error for non "internal" names -
-                # Python may be calling __len__, __nonzero__, etc, so
-                # we dont want this exception
-                if attr[0] != "_" and attr[-1] != "_":
-                    raise win32ui.error("The MFC object has died.")
-            except KeyError:
-                # No _obj_ at all - dont report MFC object died when there isnt one!
-                pass
-        raise AttributeError(attr)
-
-    def OnAttachedObjectDeath(self):
-        # 		print "object", self.__class__.__name__, "dieing"
-        self._obj_ = None
-
-    def close(self):
-        if "_obj_" in self.__dict__:
-            if self._obj_ is not None:
-                self._obj_.AttachObject(None)
-                self._obj_ = None
-
-
-class CmdTarget(Object):
-    def __init__(self, initObj):
-        Object.__init__(self, initObj)
-
-    def HookNotifyRange(self, handler, firstID, lastID):
-        oldhandlers = []
-        for i in range(firstID, lastID + 1):
-            oldhandlers.append(self.HookNotify(handler, i))
-        return oldhandlers
-
-    def HookCommandRange(self, handler, firstID, lastID):
-        oldhandlers = []
-        for i in range(firstID, lastID + 1):
-            oldhandlers.append(self.HookCommand(handler, i))
-        return oldhandlers
-
-    def HookCommandUpdateRange(self, handler, firstID, lastID):
-        oldhandlers = []
-        for i in range(firstID, lastID + 1):
-            oldhandlers.append(self.HookCommandUpdate(handler, i))
-        return oldhandlers
diff --git a/lib/pythonwin/pywin/mfc/thread.py b/lib/pythonwin/pywin/mfc/thread.py
deleted file mode 100644
index 90a0a762..00000000
--- a/lib/pythonwin/pywin/mfc/thread.py
+++ /dev/null
@@ -1,25 +0,0 @@
-# Thread and application objects
-
-import win32ui
-
-from . import object
-
-
-class WinThread(object.CmdTarget):
-    def __init__(self, initObj=None):
-        if initObj is None:
-            initObj = win32ui.CreateThread()
-        object.CmdTarget.__init__(self, initObj)
-
-    def InitInstance(self):
-        pass  # Default None/0 return indicates success for InitInstance()
-
-    def ExitInstance(self):
-        pass
-
-
-class WinApp(WinThread):
-    def __init__(self, initApp=None):
-        if initApp is None:
-            initApp = win32ui.GetApp()
-        WinThread.__init__(self, initApp)
diff --git a/lib/pythonwin/pywin/mfc/window.py b/lib/pythonwin/pywin/mfc/window.py
deleted file mode 100644
index e52a7c1c..00000000
--- a/lib/pythonwin/pywin/mfc/window.py
+++ /dev/null
@@ -1,50 +0,0 @@
-# The MFCish window classes.
-import win32con
-import win32ui
-
-from . import object
-
-
-class Wnd(object.CmdTarget):
-    def __init__(self, initobj=None):
-        object.CmdTarget.__init__(self, initobj)
-        if self._obj_:
-            self._obj_.HookMessage(self.OnDestroy, win32con.WM_DESTROY)
-
-    def OnDestroy(self, msg):
-        pass
-
-
-# NOTE NOTE - This facility is currently disabled in Pythonwin!!!!!
-# Note - to process all messages for your window, add the following method
-# to a derived class.  This code provides default message handling (ie, is
-# identical, except presumably in speed, as if the method did not exist at
-# all, so presumably will be modified to test for specific messages to be
-# useful!
-# 	def WindowProc(self, msg, wParam, lParam):
-# 		rc, lResult = self._obj_.OnWndMsg(msg, wParam, lParam)
-# 		if not rc: lResult = self._obj_.DefWindowProc(msg, wParam, lParam)
-# 		return lResult
-
-
-class FrameWnd(Wnd):
-    def __init__(self, wnd):
-        Wnd.__init__(self, wnd)
-
-
-class MDIChildWnd(FrameWnd):
-    def __init__(self, wnd=None):
-        if wnd is None:
-            wnd = win32ui.CreateMDIChild()
-        FrameWnd.__init__(self, wnd)
-
-    def OnCreateClient(self, cp, context):
-        if context is not None and context.template is not None:
-            context.template.CreateView(self, context)
-
-
-class MDIFrameWnd(FrameWnd):
-    def __init__(self, wnd=None):
-        if wnd is None:
-            wnd = win32ui.CreateMDIFrame()
-        FrameWnd.__init__(self, wnd)
diff --git a/lib/pythonwin/pywin/scintilla/IDLEenvironment.py b/lib/pythonwin/pywin/scintilla/IDLEenvironment.py
deleted file mode 100644
index b1db5093..00000000
--- a/lib/pythonwin/pywin/scintilla/IDLEenvironment.py
+++ /dev/null
@@ -1,598 +0,0 @@
-# Code that allows Pythonwin to pretend it is IDLE
-# (at least as far as most IDLE extensions are concerned)
-
-import string
-import sys
-
-import win32api
-import win32con
-import win32ui
-from pywin import default_scintilla_encoding
-from pywin.mfc.dialog import GetSimpleInput
-
-wordchars = string.ascii_uppercase + string.ascii_lowercase + string.digits
-
-
-class TextError(Exception):  # When a TclError would normally be raised.
-    pass
-
-
-class EmptyRange(Exception):  # Internally raised.
-    pass
-
-
-def GetIDLEModule(module):
-    try:
-        # First get it from Pythonwin it is exists.
-        modname = "pywin.idle." + module
-        __import__(modname)
-    except ImportError as details:
-        msg = (
-            "The IDLE extension '%s' can not be located.\r\n\r\n"
-            "Please correct the installation and restart the"
-            " application.\r\n\r\n%s" % (module, details)
-        )
-        win32ui.MessageBox(msg)
-        return None
-    mod = sys.modules[modname]
-    mod.TclError = TextError  # A hack that can go soon!
-    return mod
-
-
-# A class that is injected into the IDLE auto-indent extension.
-# It allows for decent performance when opening a new file,
-# as auto-indent uses the tokenizer module to determine indents.
-# The default AutoIndent readline method works OK, but it goes through
-# this layer of Tk index indirection for every single line.  For large files
-# without indents (and even small files with indents :-) it was pretty slow!
-def fast_readline(self):
-    if self.finished:
-        val = ""
-    else:
-        if "_scint_lines" not in self.__dict__:
-            # XXX - note - assumes this is only called once the file is loaded!
-            self._scint_lines = self.text.edit.GetTextRange().split("\n")
-        sl = self._scint_lines
-        i = self.i = self.i + 1
-        if i >= len(sl):
-            val = ""
-        else:
-            val = sl[i] + "\n"
-    return val.encode(default_scintilla_encoding)
-
-
-try:
-    GetIDLEModule("AutoIndent").IndentSearcher.readline = fast_readline
-except AttributeError:  # GetIDLEModule may return None
-    pass
-
-
-# A class that attempts to emulate an IDLE editor window.
-# Construct with a Pythonwin view.
-class IDLEEditorWindow:
-    def __init__(self, edit):
-        self.edit = edit
-        self.text = TkText(edit)
-        self.extensions = {}
-        self.extension_menus = {}
-
-    def close(self):
-        self.edit = self.text = None
-        self.extension_menus = None
-        try:
-            for ext in self.extensions.values():
-                closer = getattr(ext, "close", None)
-                if closer is not None:
-                    closer()
-        finally:
-            self.extensions = {}
-
-    def IDLEExtension(self, extension):
-        ext = self.extensions.get(extension)
-        if ext is not None:
-            return ext
-        mod = GetIDLEModule(extension)
-        if mod is None:
-            return None
-        klass = getattr(mod, extension)
-        ext = self.extensions[extension] = klass(self)
-        # Find and bind all the events defined in the extension.
-        events = [item for item in dir(klass) if item[-6:] == "_event"]
-        for event in events:
-            name = "<<%s>>" % (event[:-6].replace("_", "-"),)
-            self.edit.bindings.bind(name, getattr(ext, event))
-        return ext
-
-    def GetMenuItems(self, menu_name):
-        # Get all menu items for the menu name (eg, "edit")
-        bindings = self.edit.bindings
-        ret = []
-        for ext in self.extensions.values():
-            menudefs = getattr(ext, "menudefs", [])
-            for name, items in menudefs:
-                if name == menu_name:
-                    for text, event in [item for item in items if item is not None]:
-                        text = text.replace("&", "&&")
-                        text = text.replace("_", "&")
-                        ret.append((text, event))
-        return ret
-
-    ######################################################################
-    # The IDLE "Virtual UI" methods that are exposed to the IDLE extensions.
-    #
-    def askinteger(
-        self, caption, prompt, parent=None, initialvalue=0, minvalue=None, maxvalue=None
-    ):
-        while 1:
-            rc = GetSimpleInput(prompt, str(initialvalue), caption)
-            if rc is None:
-                return 0  # Correct "cancel" semantics?
-            err = None
-            try:
-                rc = int(rc)
-            except ValueError:
-                err = "Please enter an integer"
-            if not err and minvalue is not None and rc < minvalue:
-                err = "Please enter an integer greater then or equal to %s" % (
-                    minvalue,
-                )
-            if not err and maxvalue is not None and rc > maxvalue:
-                err = "Please enter an integer less then or equal to %s" % (maxvalue,)
-            if err:
-                win32ui.MessageBox(err, caption, win32con.MB_OK)
-                continue
-            return rc
-
-    def askyesno(self, caption, prompt, parent=None):
-        return win32ui.MessageBox(prompt, caption, win32con.MB_YESNO) == win32con.IDYES
-
-    ######################################################################
-    # The IDLE "Virtual Text Widget" methods that are exposed to the IDLE extensions.
-    #
-
-    # Is character at text_index in a Python string?  Return 0 for
-    # "guaranteed no", true for anything else.
-    def is_char_in_string(self, text_index):
-        # A helper for the code analyser - we need internal knowledge of
-        # the colorizer to get this information
-        # This assumes the colorizer has got to this point!
-        text_index = self.text._getoffset(text_index)
-        c = self.text.edit._GetColorizer()
-        if c and c.GetStringStyle(text_index) is None:
-            return 0
-        return 1
-
-    # If a selection is defined in the text widget, return
-    # (start, end) as Tkinter text indices, otherwise return
-    # (None, None)
-    def get_selection_indices(self):
-        try:
-            first = self.text.index("sel.first")
-            last = self.text.index("sel.last")
-            return first, last
-        except TextError:
-            return None, None
-
-    def set_tabwidth(self, width):
-        self.edit.SCISetTabWidth(width)
-
-    def get_tabwidth(self):
-        return self.edit.GetTabWidth()
-
-
-# A class providing the generic "Call Tips" interface
-class CallTips:
-    def __init__(self, edit):
-        self.edit = edit
-
-    def showtip(self, tip_text):
-        self.edit.SCICallTipShow(tip_text)
-
-    def hidetip(self):
-        self.edit.SCICallTipCancel()
-
-
-########################################
-#
-# Helpers for the TkText emulation.
-def TkOffsetToIndex(offset, edit):
-    lineoff = 0
-    # May be 1 > actual end if we pretended there was a trailing '\n'
-    offset = min(offset, edit.GetTextLength())
-    line = edit.LineFromChar(offset)
-    lineIndex = edit.LineIndex(line)
-    return "%d.%d" % (line + 1, offset - lineIndex)
-
-
-def _NextTok(str, pos):
-    # Returns (token, endPos)
-    end = len(str)
-    if pos >= end:
-        return None, 0
-    while pos < end and str[pos] in string.whitespace:
-        pos = pos + 1
-    # Special case for +-
-    if str[pos] in "+-":
-        return str[pos], pos + 1
-    # Digits also a special case.
-    endPos = pos
-    while endPos < end and str[endPos] in string.digits + ".":
-        endPos = endPos + 1
-    if pos != endPos:
-        return str[pos:endPos], endPos
-    endPos = pos
-    while endPos < end and str[endPos] not in string.whitespace + string.digits + "+-":
-        endPos = endPos + 1
-    if pos != endPos:
-        return str[pos:endPos], endPos
-    return None, 0
-
-
-def TkIndexToOffset(bm, edit, marks):
-    base, nextTokPos = _NextTok(bm, 0)
-    if base is None:
-        raise ValueError("Empty bookmark ID!")
-    if base.find(".") > 0:
-        try:
-            line, col = base.split(".", 2)
-            if col == "first" or col == "last":
-                # Tag name
-                if line != "sel":
-                    raise ValueError("Tags arent here!")
-                sel = edit.GetSel()
-                if sel[0] == sel[1]:
-                    raise EmptyRange
-                if col == "first":
-                    pos = sel[0]
-                else:
-                    pos = sel[1]
-            else:
-                # Lines are 1 based for tkinter
-                line = int(line) - 1
-                if line > edit.GetLineCount():
-                    pos = edit.GetTextLength() + 1
-                else:
-                    pos = edit.LineIndex(line)
-                    if pos == -1:
-                        pos = edit.GetTextLength()
-                    pos = pos + int(col)
-        except (ValueError, IndexError):
-            raise ValueError("Unexpected literal in '%s'" % base)
-    elif base == "insert":
-        pos = edit.GetSel()[0]
-    elif base == "end":
-        pos = edit.GetTextLength()
-        # Pretend there is a trailing '\n' if necessary
-        if pos and edit.SCIGetCharAt(pos - 1) != "\n":
-            pos = pos + 1
-    else:
-        try:
-            pos = marks[base]
-        except KeyError:
-            raise ValueError("Unsupported base offset or undefined mark '%s'" % base)
-
-    while 1:
-        word, nextTokPos = _NextTok(bm, nextTokPos)
-        if word is None:
-            break
-        if word in ("+", "-"):
-            num, nextTokPos = _NextTok(bm, nextTokPos)
-            if num is None:
-                raise ValueError("+/- operator needs 2 args")
-            what, nextTokPos = _NextTok(bm, nextTokPos)
-            if what is None:
-                raise ValueError("+/- operator needs 2 args")
-            if what[0] != "c":
-                raise ValueError("+/- only supports chars")
-            if word == "+":
-                pos = pos + int(num)
-            else:
-                pos = pos - int(num)
-        elif word == "wordstart":
-            while pos > 0 and edit.SCIGetCharAt(pos - 1) in wordchars:
-                pos = pos - 1
-        elif word == "wordend":
-            end = edit.GetTextLength()
-            while pos < end and edit.SCIGetCharAt(pos) in wordchars:
-                pos = pos + 1
-        elif word == "linestart":
-            while pos > 0 and edit.SCIGetCharAt(pos - 1) not in "\n\r":
-                pos = pos - 1
-        elif word == "lineend":
-            end = edit.GetTextLength()
-            while pos < end and edit.SCIGetCharAt(pos) not in "\n\r":
-                pos = pos + 1
-        else:
-            raise ValueError("Unsupported relative offset '%s'" % word)
-    return max(pos, 0)  # Tkinter is tollerant of -ve indexes - we aren't
-
-
-# A class that resembles an IDLE (ie, a Tk) text widget.
-# Construct with an edit object (eg, an editor view)
-class TkText:
-    def __init__(self, edit):
-        self.calltips = None
-        self.edit = edit
-        self.marks = {}
-
-    ##	def __getattr__(self, attr):
-    ##		if attr=="tk": return self # So text.tk.call works.
-    ##		if attr=="master": return None # ditto!
-    ##		raise AttributeError, attr
-    ##	def __getitem__(self, item):
-    ##		if item=="tabs":
-    ##			size = self.edit.GetTabWidth()
-    ##			if size==8: return "" # Tk default
-    ##			return size # correct semantics?
-    ##		elif item=="font": # Used for measurements we dont need to do!
-    ##			return "Dont know the font"
-    ##		raise IndexError, "Invalid index '%s'" % item
-    def make_calltip_window(self):
-        if self.calltips is None:
-            self.calltips = CallTips(self.edit)
-        return self.calltips
-
-    def _getoffset(self, index):
-        return TkIndexToOffset(index, self.edit, self.marks)
-
-    def _getindex(self, off):
-        return TkOffsetToIndex(off, self.edit)
-
-    def _fix_indexes(self, start, end):
-        # first some magic to handle skipping over utf8 extended chars.
-        while start > 0 and ord(self.edit.SCIGetCharAt(start)) & 0xC0 == 0x80:
-            start -= 1
-        while (
-            end < self.edit.GetTextLength()
-            and ord(self.edit.SCIGetCharAt(end)) & 0xC0 == 0x80
-        ):
-            end += 1
-        # now handling fixing \r\n->\n disparities...
-        if (
-            start > 0
-            and self.edit.SCIGetCharAt(start) == "\n"
-            and self.edit.SCIGetCharAt(start - 1) == "\r"
-        ):
-            start = start - 1
-        if (
-            end < self.edit.GetTextLength()
-            and self.edit.SCIGetCharAt(end - 1) == "\r"
-            and self.edit.SCIGetCharAt(end) == "\n"
-        ):
-            end = end + 1
-        return start, end
-
-    ##	def get_tab_width(self):
-    ##		return self.edit.GetTabWidth()
-    ##	def call(self, *rest):
-    ##		# Crap to support Tk measurement hacks for tab widths
-    ##		if rest[0] != "font" or rest[1] != "measure":
-    ##			raise ValueError, "Unsupport call type"
-    ##		return len(rest[5])
-    ##	def configure(self, **kw):
-    ##		for name, val in kw.items():
-    ##			if name=="tabs":
-    ##				self.edit.SCISetTabWidth(int(val))
-    ##			else:
-    ##				raise ValueError, "Unsupported configuration item %s" % kw
-    def bind(self, binding, handler):
-        self.edit.bindings.bind(binding, handler)
-
-    def get(self, start, end=None):
-        try:
-            start = self._getoffset(start)
-            if end is None:
-                end = start + 1
-            else:
-                end = self._getoffset(end)
-        except EmptyRange:
-            return ""
-        # Simple semantic checks to conform to the Tk text interface
-        if end <= start:
-            return ""
-        max = self.edit.GetTextLength()
-        checkEnd = 0
-        if end > max:
-            end = max
-            checkEnd = 1
-        start, end = self._fix_indexes(start, end)
-        ret = self.edit.GetTextRange(start, end)
-        # pretend a trailing '\n' exists if necessary.
-        if checkEnd and (not ret or ret[-1] != "\n"):
-            ret = ret + "\n"
-        return ret.replace("\r", "")
-
-    def index(self, spec):
-        try:
-            return self._getindex(self._getoffset(spec))
-        except EmptyRange:
-            return ""
-
-    def insert(self, pos, text):
-        try:
-            pos = self._getoffset(pos)
-        except EmptyRange:
-            raise TextError("Empty range")
-        self.edit.SetSel((pos, pos))
-        # IDLE only deals with "\n" - we will be nicer
-
-        bits = text.split("\n")
-        self.edit.SCIAddText(bits[0])
-        for bit in bits[1:]:
-            self.edit.SCINewline()
-            self.edit.SCIAddText(bit)
-
-    def delete(self, start, end=None):
-        try:
-            start = self._getoffset(start)
-            if end is not None:
-                end = self._getoffset(end)
-        except EmptyRange:
-            raise TextError("Empty range")
-        # If end is specified and == start, then we must delete nothing.
-        if start == end:
-            return
-        # If end is not specified, delete one char
-        if end is None:
-            end = start + 1
-        else:
-            # Tk says not to delete in this case, but our control would.
-            if end < start:
-                return
-        if start == self.edit.GetTextLength():
-            return  # Nothing to delete.
-        old = self.edit.GetSel()[0]  # Lose a selection
-        # Hack for partial '\r\n' and UTF-8 char removal
-        start, end = self._fix_indexes(start, end)
-        self.edit.SetSel((start, end))
-        self.edit.Clear()
-        if old >= start and old < end:
-            old = start
-        elif old >= end:
-            old = old - (end - start)
-        self.edit.SetSel(old)
-
-    def bell(self):
-        win32api.MessageBeep()
-
-    def see(self, pos):
-        # Most commands we use in Scintilla actually force the selection
-        # to be seen, making this unnecessary.
-        pass
-
-    def mark_set(self, name, pos):
-        try:
-            pos = self._getoffset(pos)
-        except EmptyRange:
-            raise TextError("Empty range '%s'" % pos)
-        if name == "insert":
-            self.edit.SetSel(pos)
-        else:
-            self.marks[name] = pos
-
-    def tag_add(self, name, start, end):
-        if name != "sel":
-            raise ValueError("Only sel tag is supported")
-        try:
-            start = self._getoffset(start)
-            end = self._getoffset(end)
-        except EmptyRange:
-            raise TextError("Empty range")
-        self.edit.SetSel(start, end)
-
-    def tag_remove(self, name, start, end):
-        if name != "sel" or start != "1.0" or end != "end":
-            raise ValueError("Cant remove this tag")
-        # Turn the sel into a cursor
-        self.edit.SetSel(self.edit.GetSel()[0])
-
-    def compare(self, i1, op, i2):
-        try:
-            i1 = self._getoffset(i1)
-        except EmptyRange:
-            i1 = ""
-        try:
-            i2 = self._getoffset(i2)
-        except EmptyRange:
-            i2 = ""
-        return eval("%d%s%d" % (i1, op, i2))
-
-    def undo_block_start(self):
-        self.edit.SCIBeginUndoAction()
-
-    def undo_block_stop(self):
-        self.edit.SCIEndUndoAction()
-
-
-######################################################################
-#
-# Test related code.
-#
-######################################################################
-def TestCheck(index, edit, expected=None):
-    rc = TkIndexToOffset(index, edit, {})
-    if rc != expected:
-        print("ERROR: Index", index, ", expected", expected, "but got", rc)
-
-
-def TestGet(fr, to, t, expected):
-    got = t.get(fr, to)
-    if got != expected:
-        print(
-            "ERROR: get(%s, %s) expected %s, but got %s"
-            % (repr(fr), repr(to), repr(expected), repr(got))
-        )
-
-
-def test():
-    import pywin.framework.editor
-
-    d = pywin.framework.editor.editorTemplate.OpenDocumentFile(None)
-    e = d.GetFirstView()
-    t = TkText(e)
-    e.SCIAddText("hi there how\nare you today\r\nI hope you are well")
-    e.SetSel((4, 4))
-
-    skip = """
-	TestCheck("insert", e, 4)
-	TestCheck("insert wordstart", e, 3)
-	TestCheck("insert wordend", e, 8)
-	TestCheck("insert linestart", e, 0)
-	TestCheck("insert lineend", e, 12)
-	TestCheck("insert + 4 chars", e, 8)
-	TestCheck("insert +4c", e, 8)
-	TestCheck("insert - 2 chars", e, 2)
-	TestCheck("insert -2c", e, 2)
-	TestCheck("insert-2c", e, 2)
-	TestCheck("insert-2 c", e, 2)
-	TestCheck("insert- 2c", e, 2)
-	TestCheck("1.1", e, 1)
-	TestCheck("1.0", e, 0)
-	TestCheck("2.0", e, 13)
-	try:
-		TestCheck("sel.first", e, 0)
-		print "*** sel.first worked with an empty selection"
-	except TextError:
-		pass
-	e.SetSel((4,5))
-	TestCheck("sel.first- 2c", e, 2)
-	TestCheck("sel.last- 2c", e, 3)
-	"""
-    # Check EOL semantics
-    e.SetSel((4, 4))
-    TestGet("insert lineend", "insert lineend +1c", t, "\n")
-    e.SetSel((20, 20))
-    TestGet("insert lineend", "insert lineend +1c", t, "\n")
-    e.SetSel((35, 35))
-    TestGet("insert lineend", "insert lineend +1c", t, "\n")
-
-
-class IDLEWrapper:
-    def __init__(self, control):
-        self.text = control
-
-
-def IDLETest(extension):
-    import os
-    import sys
-
-    modname = "pywin.idle." + extension
-    __import__(modname)
-    mod = sys.modules[modname]
-    mod.TclError = TextError
-    klass = getattr(mod, extension)
-
-    # Create a new Scintilla Window.
-    import pywin.framework.editor
-
-    d = pywin.framework.editor.editorTemplate.OpenDocumentFile(None)
-    v = d.GetFirstView()
-    fname = os.path.splitext(__file__)[0] + ".py"
-    v.SCIAddText(open(fname).read())
-    d.SetModifiedFlag(0)
-    r = klass(IDLEWrapper(TkText(v)))
-    return r
-
-
-if __name__ == "__main__":
-    test()
diff --git a/lib/pythonwin/pywin/scintilla/__init__.py b/lib/pythonwin/pywin/scintilla/__init__.py
deleted file mode 100644
index 0981b622..00000000
--- a/lib/pythonwin/pywin/scintilla/__init__.py
+++ /dev/null
@@ -1 +0,0 @@
-# package init.
diff --git a/lib/pythonwin/pywin/scintilla/bindings.py b/lib/pythonwin/pywin/scintilla/bindings.py
deleted file mode 100644
index 785bd42a..00000000
--- a/lib/pythonwin/pywin/scintilla/bindings.py
+++ /dev/null
@@ -1,178 +0,0 @@
-import traceback
-
-import win32api
-import win32con
-import win32ui
-
-from . import IDLEenvironment, keycodes
-
-HANDLER_ARGS_GUESS = 0
-HANDLER_ARGS_NATIVE = 1
-HANDLER_ARGS_IDLE = 2
-HANDLER_ARGS_EXTENSION = 3
-
-next_id = 5000
-
-event_to_commands = {}  # dict of integer IDs to event names.
-command_to_events = {}  # dict of event names to int IDs
-
-
-def assign_command_id(event, id=0):
-    global next_id
-    if id == 0:
-        id = event_to_commands.get(event, 0)
-        if id == 0:
-            id = next_id
-            next_id = next_id + 1
-        # Only map the ones we allocated - specified ones are assumed to have a handler
-        command_to_events[id] = event
-    event_to_commands[event] = id
-    return id
-
-
-class SendCommandHandler:
-    def __init__(self, cmd):
-        self.cmd = cmd
-
-    def __call__(self, *args):
-        win32ui.GetMainFrame().SendMessage(win32con.WM_COMMAND, self.cmd)
-
-
-class Binding:
-    def __init__(self, handler, handler_args_type):
-        self.handler = handler
-        self.handler_args_type = handler_args_type
-
-
-class BindingsManager:
-    def __init__(self, parent_view):
-        self.parent_view = parent_view
-        self.bindings = {}  # dict of Binding instances.
-        self.keymap = {}
-
-    def prepare_configure(self):
-        self.keymap = {}
-
-    def complete_configure(self):
-        for id in command_to_events.keys():
-            self.parent_view.HookCommand(self._OnCommand, id)
-
-    def close(self):
-        self.parent_view = self.bindings = self.keymap = None
-
-    def report_error(self, problem):
-        try:
-            win32ui.SetStatusText(problem, 1)
-        except win32ui.error:
-            # No status bar!
-            print(problem)
-
-    def update_keymap(self, keymap):
-        self.keymap.update(keymap)
-
-    def bind(self, event, handler, handler_args_type=HANDLER_ARGS_GUESS, cid=0):
-        if handler is None:
-            handler = SendCommandHandler(cid)
-        self.bindings[event] = self._new_binding(handler, handler_args_type)
-        self.bind_command(event, cid)
-
-    def bind_command(self, event, id=0):
-        "Binds an event to a Windows control/command ID"
-        id = assign_command_id(event, id)
-        return id
-
-    def get_command_id(self, event):
-        id = event_to_commands.get(event)
-        if id is None:
-            # See if we even have an event of that name!?
-            if event not in self.bindings:
-                return None
-            id = self.bind_command(event)
-        return id
-
-    def _OnCommand(self, id, code):
-        event = command_to_events.get(id)
-        if event is None:
-            self.report_error("No event associated with event ID %d" % id)
-            return 1
-        return self.fire(event)
-
-    def _new_binding(self, event, handler_args_type):
-        return Binding(event, handler_args_type)
-
-    def _get_IDLE_handler(self, ext, handler):
-        try:
-            instance = self.parent_view.idle.IDLEExtension(ext)
-            name = handler.replace("-", "_") + "_event"
-            return getattr(instance, name)
-        except (ImportError, AttributeError):
-            msg = "Can not find event '%s' in IDLE extension '%s'" % (handler, ext)
-            self.report_error(msg)
-            return None
-
-    def fire(self, event, event_param=None):
-        # Fire the specified event.  Result is native Pythonwin result
-        # (ie, 1==pass one, 0 or None==handled)
-
-        # First look up the event directly - if there, we are set.
-        binding = self.bindings.get(event)
-        if binding is None:
-            # If possible, find it!
-            # A native method name
-            handler = getattr(self.parent_view, event + "Event", None)
-            if handler is None:
-                # Can't decide if I should report an error??
-                self.report_error("The event name '%s' can not be found." % event)
-                # Either way, just let the default handlers grab it.
-                return 1
-            binding = self._new_binding(handler, HANDLER_ARGS_NATIVE)
-            # Cache it.
-            self.bindings[event] = binding
-
-        handler_args_type = binding.handler_args_type
-        # Now actually fire it.
-        if handler_args_type == HANDLER_ARGS_GUESS:
-            # Can't be native, as natives are never added with "guess".
-            # Must be extension or IDLE.
-            if event[0] == "<":
-                handler_args_type = HANDLER_ARGS_IDLE
-            else:
-                handler_args_type = HANDLER_ARGS_EXTENSION
-        try:
-            if handler_args_type == HANDLER_ARGS_EXTENSION:
-                args = self.parent_view.idle, event_param
-            else:
-                args = (event_param,)
-            rc = binding.handler(*args)
-            if handler_args_type == HANDLER_ARGS_IDLE:
-                # Convert to our return code.
-                if rc in (None, "break"):
-                    rc = 0
-                else:
-                    rc = 1
-        except:
-            message = "Firing event '%s' failed." % event
-            print(message)
-            traceback.print_exc()
-            self.report_error(message)
-            rc = 1  # Let any default handlers have a go!
-        return rc
-
-    def fire_key_event(self, msg):
-        key = msg[2]
-        keyState = 0
-        if win32api.GetKeyState(win32con.VK_CONTROL) & 0x8000:
-            keyState = (
-                keyState | win32con.RIGHT_CTRL_PRESSED | win32con.LEFT_CTRL_PRESSED
-            )
-        if win32api.GetKeyState(win32con.VK_SHIFT) & 0x8000:
-            keyState = keyState | win32con.SHIFT_PRESSED
-        if win32api.GetKeyState(win32con.VK_MENU) & 0x8000:
-            keyState = keyState | win32con.LEFT_ALT_PRESSED | win32con.RIGHT_ALT_PRESSED
-        keyinfo = key, keyState
-        # Special hacks for the dead-char key on non-US keyboards.
-        # (XXX - which do not work :-(
-        event = self.keymap.get(keyinfo)
-        if event is None:
-            return 1
-        return self.fire(event, None)
diff --git a/lib/pythonwin/pywin/scintilla/config.py b/lib/pythonwin/pywin/scintilla/config.py
deleted file mode 100644
index 9a1b210e..00000000
--- a/lib/pythonwin/pywin/scintilla/config.py
+++ /dev/null
@@ -1,365 +0,0 @@
-# config.py - deals with loading configuration information.
-
-# Loads config data from a .cfg file.  Also caches the compiled
-# data back into a .cfc file.
-
-# If you are wondering how to avoid needing .cfg files (eg,
-# if you are freezing Pythonwin etc) I suggest you create a
-# .py file, and put the config info in a docstring.  Then
-# pass a CStringIO file (rather than a filename) to the
-# config manager.
-import glob
-import importlib.util
-import marshal
-import os
-import stat
-import sys
-import traceback
-import types
-
-import pywin
-import win32api
-
-from . import keycodes
-
-debugging = 0
-if debugging:
-    import win32traceutil  # Some trace statements fire before the interactive window is open.
-
-    def trace(*args):
-        sys.stderr.write(" ".join(map(str, args)) + "\n")
-
-else:
-    trace = lambda *args: None
-
-compiled_config_version = 3
-
-
-def split_line(line, lineno):
-    comment_pos = line.find("#")
-    if comment_pos >= 0:
-        line = line[:comment_pos]
-    sep_pos = line.rfind("=")
-    if sep_pos == -1:
-        if line.strip():
-            print("Warning: Line %d: %s is an invalid entry" % (lineno, repr(line)))
-            return None, None
-        return "", ""
-    return line[:sep_pos].strip(), line[sep_pos + 1 :].strip()
-
-
-def get_section_header(line):
-    # Returns the section if the line is a section header, else None
-    if line[0] == "[":
-        end = line.find("]")
-        if end == -1:
-            end = len(line)
-        rc = line[1:end].lower()
-        try:
-            i = rc.index(":")
-            return rc[:i], rc[i + 1 :]
-        except ValueError:
-            return rc, ""
-    return None, None
-
-
-def find_config_file(f):
-    return os.path.join(pywin.__path__[0], f + ".cfg")
-
-
-def find_config_files():
-    return [
-        os.path.split(x)[1]
-        for x in [
-            os.path.splitext(x)[0]
-            for x in glob.glob(os.path.join(pywin.__path__[0], "*.cfg"))
-        ]
-    ]
-
-
-class ConfigManager:
-    def __init__(self, f):
-        self.filename = "unknown"
-        self.last_error = None
-        self.key_to_events = {}
-        b_close = False
-        if hasattr(f, "readline"):
-            fp = f
-            self.filename = "<config string>"
-            compiled_name = None
-        else:
-            try:
-                f = find_config_file(f)
-                src_stat = os.stat(f)
-            except os.error:
-                self.report_error("Config file '%s' not found" % f)
-                return
-            self.filename = f
-            self.basename = os.path.basename(f)
-            trace("Loading configuration", self.basename)
-            compiled_name = os.path.splitext(f)[0] + ".cfc"
-            try:
-                cf = open(compiled_name, "rb")
-                try:
-                    ver = marshal.load(cf)
-                    ok = compiled_config_version == ver
-                    if ok:
-                        kblayoutname = marshal.load(cf)
-                        magic = marshal.load(cf)
-                        size = marshal.load(cf)
-                        mtime = marshal.load(cf)
-                        if (
-                            magic == importlib.util.MAGIC_NUMBER
-                            and win32api.GetKeyboardLayoutName() == kblayoutname
-                            and src_stat[stat.ST_MTIME] == mtime
-                            and src_stat[stat.ST_SIZE] == size
-                        ):
-                            self.cache = marshal.load(cf)
-                            trace("Configuration loaded cached", compiled_name)
-                            return  # We are ready to roll!
-                finally:
-                    cf.close()
-            except (os.error, IOError, EOFError):
-                pass
-            fp = open(f)
-            b_close = True
-        self.cache = {}
-        lineno = 1
-        line = fp.readline()
-        while line:
-            # Skip to the next section (maybe already there!)
-            section, subsection = get_section_header(line)
-            while line and section is None:
-                line = fp.readline()
-                if not line:
-                    break
-                lineno = lineno + 1
-                section, subsection = get_section_header(line)
-            if not line:
-                break
-
-            if section == "keys":
-                line, lineno = self._load_keys(subsection, fp, lineno)
-            elif section == "extensions":
-                line, lineno = self._load_extensions(subsection, fp, lineno)
-            elif section == "idle extensions":
-                line, lineno = self._load_idle_extensions(subsection, fp, lineno)
-            elif section == "general":
-                line, lineno = self._load_general(subsection, fp, lineno)
-            else:
-                self.report_error(
-                    "Unrecognised section header '%s:%s'" % (section, subsection)
-                )
-                line = fp.readline()
-                lineno = lineno + 1
-        if b_close:
-            fp.close()
-        # Check critical data.
-        if not self.cache.get("keys"):
-            self.report_error("No keyboard definitions were loaded")
-        if not self.last_error and compiled_name:
-            try:
-                cf = open(compiled_name, "wb")
-                marshal.dump(compiled_config_version, cf)
-                marshal.dump(win32api.GetKeyboardLayoutName(), cf)
-                marshal.dump(importlib.util.MAGIC_NUMBER, cf)
-                marshal.dump(src_stat[stat.ST_SIZE], cf)
-                marshal.dump(src_stat[stat.ST_MTIME], cf)
-                marshal.dump(self.cache, cf)
-                cf.close()
-            except (IOError, EOFError):
-                pass  # Ignore errors - may be read only.
-
-    def configure(self, editor, subsections=None):
-        # Execute the extension code, and find any events.
-        # First, we "recursively" connect any we are based on.
-        if subsections is None:
-            subsections = []
-        subsections = [""] + subsections
-        general = self.get_data("general")
-        if general:
-            parents = general.get("based on", [])
-            for parent in parents:
-                trace("Configuration based on", parent, "- loading.")
-                parent = self.__class__(parent)
-                parent.configure(editor, subsections)
-                if parent.last_error:
-                    self.report_error(parent.last_error)
-
-        bindings = editor.bindings
-        codeob = self.get_data("extension code")
-        if codeob is not None:
-            ns = {}
-            try:
-                exec(codeob, ns)
-            except:
-                traceback.print_exc()
-                self.report_error("Executing extension code failed")
-                ns = None
-            if ns:
-                num = 0
-                for name, func in list(ns.items()):
-                    if type(func) == types.FunctionType and name[:1] != "_":
-                        bindings.bind(name, func)
-                        num = num + 1
-                trace("Configuration Extension code loaded", num, "events")
-        # Load the idle extensions
-        for subsection in subsections:
-            for ext in self.get_data("idle extensions", {}).get(subsection, []):
-                try:
-                    editor.idle.IDLEExtension(ext)
-                    trace("Loaded IDLE extension", ext)
-                except:
-                    self.report_error("Can not load the IDLE extension '%s'" % ext)
-
-        # Now bind up the key-map (remembering a reverse map
-        subsection_keymap = self.get_data("keys")
-        num_bound = 0
-        for subsection in subsections:
-            keymap = subsection_keymap.get(subsection, {})
-            bindings.update_keymap(keymap)
-            num_bound = num_bound + len(keymap)
-        trace("Configuration bound", num_bound, "keys")
-
-    def get_key_binding(self, event, subsections=None):
-        if subsections is None:
-            subsections = []
-        subsections = [""] + subsections
-
-        subsection_keymap = self.get_data("keys")
-        for subsection in subsections:
-            map = self.key_to_events.get(subsection)
-            if map is None:  # Build it
-                map = {}
-                keymap = subsection_keymap.get(subsection, {})
-                for key_info, map_event in list(keymap.items()):
-                    map[map_event] = key_info
-                self.key_to_events[subsection] = map
-
-            info = map.get(event)
-            if info is not None:
-                return keycodes.make_key_name(info[0], info[1])
-        return None
-
-    def report_error(self, msg):
-        self.last_error = msg
-        print("Error in %s: %s" % (self.filename, msg))
-
-    def report_warning(self, msg):
-        print("Warning in %s: %s" % (self.filename, msg))
-
-    def _readline(self, fp, lineno, bStripComments=1):
-        line = fp.readline()
-        lineno = lineno + 1
-        if line:
-            bBreak = (
-                get_section_header(line)[0] is not None
-            )  # A new section is starting
-            if bStripComments and not bBreak:
-                pos = line.find("#")
-                if pos >= 0:
-                    line = line[:pos] + "\n"
-        else:
-            bBreak = 1
-        return line, lineno, bBreak
-
-    def get_data(self, name, default=None):
-        return self.cache.get(name, default)
-
-    def _save_data(self, name, data):
-        self.cache[name] = data
-        return data
-
-    def _load_general(self, sub_section, fp, lineno):
-        map = {}
-        while 1:
-            line, lineno, bBreak = self._readline(fp, lineno)
-            if bBreak:
-                break
-
-            key, val = split_line(line, lineno)
-            if not key:
-                continue
-            key = key.lower()
-            l = map.get(key, [])
-            l.append(val)
-            map[key] = l
-        self._save_data("general", map)
-        return line, lineno
-
-    def _load_keys(self, sub_section, fp, lineno):
-        # Builds a nested dictionary of
-        # (scancode, flags) = event_name
-        main_map = self.get_data("keys", {})
-        map = main_map.get(sub_section, {})
-        while 1:
-            line, lineno, bBreak = self._readline(fp, lineno)
-            if bBreak:
-                break
-
-            key, event = split_line(line, lineno)
-            if not event:
-                continue
-            sc, flag = keycodes.parse_key_name(key)
-            if sc is None:
-                self.report_warning("Line %d: Invalid key name '%s'" % (lineno, key))
-            else:
-                map[sc, flag] = event
-        main_map[sub_section] = map
-        self._save_data("keys", main_map)
-        return line, lineno
-
-    def _load_extensions(self, sub_section, fp, lineno):
-        start_lineno = lineno
-        lines = []
-        while 1:
-            line, lineno, bBreak = self._readline(fp, lineno, 0)
-            if bBreak:
-                break
-            lines.append(line)
-        try:
-            c = compile(
-                "\n" * start_lineno + "".join(lines),  # produces correct tracebacks
-                self.filename,
-                "exec",
-            )
-            self._save_data("extension code", c)
-        except SyntaxError as details:
-            errlineno = details.lineno + start_lineno
-            # Should handle syntax errors better here, and offset the lineno.
-            self.report_error(
-                "Compiling extension code failed:\r\nFile: %s\r\nLine %d\r\n%s"
-                % (details.filename, errlineno, details.msg)
-            )
-        return line, lineno
-
-    def _load_idle_extensions(self, sub_section, fp, lineno):
-        extension_map = self.get_data("idle extensions")
-        if extension_map is None:
-            extension_map = {}
-        extensions = []
-        while 1:
-            line, lineno, bBreak = self._readline(fp, lineno)
-            if bBreak:
-                break
-            line = line.strip()
-            if line:
-                extensions.append(line)
-        extension_map[sub_section] = extensions
-        self._save_data("idle extensions", extension_map)
-        return line, lineno
-
-
-def test():
-    import time
-
-    start = time.clock()
-    f = "default"
-    cm = ConfigManager(f)
-    map = cm.get_data("keys")
-    took = time.clock() - start
-    print("Loaded %s items in %.4f secs" % (len(map), took))
-
-
-if __name__ == "__main__":
-    test()
diff --git a/lib/pythonwin/pywin/scintilla/configui.py b/lib/pythonwin/pywin/scintilla/configui.py
deleted file mode 100644
index 8b6157b6..00000000
--- a/lib/pythonwin/pywin/scintilla/configui.py
+++ /dev/null
@@ -1,292 +0,0 @@
-import win32api
-import win32con
-import win32ui
-from pywin.mfc import dialog
-
-# Used to indicate that style should use default color
-from win32con import CLR_INVALID
-
-from . import scintillacon
-
-######################################################
-# Property Page for syntax formatting options
-
-# The standard 16 color VGA palette should always be possible
-paletteVGA = (
-    ("Black", win32api.RGB(0, 0, 0)),
-    ("Navy", win32api.RGB(0, 0, 128)),
-    ("Green", win32api.RGB(0, 128, 0)),
-    ("Cyan", win32api.RGB(0, 128, 128)),
-    ("Maroon", win32api.RGB(128, 0, 0)),
-    ("Purple", win32api.RGB(128, 0, 128)),
-    ("Olive", win32api.RGB(128, 128, 0)),
-    ("Gray", win32api.RGB(128, 128, 128)),
-    ("Silver", win32api.RGB(192, 192, 192)),
-    ("Blue", win32api.RGB(0, 0, 255)),
-    ("Lime", win32api.RGB(0, 255, 0)),
-    ("Aqua", win32api.RGB(0, 255, 255)),
-    ("Red", win32api.RGB(255, 0, 0)),
-    ("Fuchsia", win32api.RGB(255, 0, 255)),
-    ("Yellow", win32api.RGB(255, 255, 0)),
-    ("White", win32api.RGB(255, 255, 255)),
-    # and a few others will generally be possible.
-    ("DarkGrey", win32api.RGB(64, 64, 64)),
-    ("PurpleBlue", win32api.RGB(64, 64, 192)),
-    ("DarkGreen", win32api.RGB(0, 96, 0)),
-    ("DarkOlive", win32api.RGB(128, 128, 64)),
-    ("MediumBlue", win32api.RGB(0, 0, 192)),
-    ("DarkNavy", win32api.RGB(0, 0, 96)),
-    ("Magenta", win32api.RGB(96, 0, 96)),
-    ("OffWhite", win32api.RGB(255, 255, 220)),
-    ("LightPurple", win32api.RGB(220, 220, 255)),
-    ("<Default>", win32con.CLR_INVALID),
-)
-
-
-class ScintillaFormatPropertyPage(dialog.PropertyPage):
-    def __init__(self, scintillaClass=None, caption=0):
-        self.scintillaClass = scintillaClass
-        dialog.PropertyPage.__init__(self, win32ui.IDD_PP_FORMAT, caption=caption)
-
-    def OnInitDialog(self):
-        try:
-            if self.scintillaClass is None:
-                from . import control
-
-                sc = control.CScintillaEdit
-            else:
-                sc = self.scintillaClass
-
-            self.scintilla = sc()
-            style = win32con.WS_CHILD | win32con.WS_VISIBLE | win32con.ES_MULTILINE
-            # Convert the rect size
-            rect = self.MapDialogRect((5, 5, 120, 75))
-            self.scintilla.CreateWindow(style, rect, self, 111)
-            self.HookNotify(self.OnBraceMatch, scintillacon.SCN_CHECKBRACE)
-            self.scintilla.HookKeyStroke(self.OnEsc, 27)
-            self.scintilla.SCISetViewWS(1)
-            self.pos_bstart = self.pos_bend = self.pos_bbad = 0
-
-            colorizer = self.scintilla._GetColorizer()
-            text = colorizer.GetSampleText()
-            items = text.split("|", 2)
-            pos = len(items[0])
-            self.scintilla.SCIAddText("".join(items))
-            self.scintilla.SetSel(pos, pos)
-            self.scintilla.ApplyFormattingStyles()
-            self.styles = self.scintilla._GetColorizer().styles
-
-            self.cbo = self.GetDlgItem(win32ui.IDC_COMBO1)
-            for c in paletteVGA:
-                self.cbo.AddString(c[0])
-
-            self.cboBoldItalic = self.GetDlgItem(win32ui.IDC_COMBO2)
-            for item in ("Bold Italic", "Bold", "Italic", "Regular"):
-                self.cboBoldItalic.InsertString(0, item)
-
-            self.butIsDefault = self.GetDlgItem(win32ui.IDC_CHECK1)
-            self.butIsDefaultBackground = self.GetDlgItem(win32ui.IDC_CHECK2)
-            self.listbox = self.GetDlgItem(win32ui.IDC_LIST1)
-            self.HookCommand(self.OnListCommand, win32ui.IDC_LIST1)
-            names = list(self.styles.keys())
-            names.sort()
-            for name in names:
-                if self.styles[name].aliased is None:
-                    self.listbox.AddString(name)
-            self.listbox.SetCurSel(0)
-
-            idc = win32ui.IDC_RADIO1
-            if not self.scintilla._GetColorizer().bUseFixed:
-                idc = win32ui.IDC_RADIO2
-            self.GetDlgItem(idc).SetCheck(1)
-            self.UpdateUIForStyle(self.styles[names[0]])
-
-            self.scintilla.HookFormatter(self)
-            self.HookCommand(self.OnButDefaultFixedFont, win32ui.IDC_BUTTON1)
-            self.HookCommand(self.OnButDefaultPropFont, win32ui.IDC_BUTTON2)
-            self.HookCommand(self.OnButThisFont, win32ui.IDC_BUTTON3)
-            self.HookCommand(self.OnButUseDefaultFont, win32ui.IDC_CHECK1)
-            self.HookCommand(self.OnButThisBackground, win32ui.IDC_BUTTON4)
-            self.HookCommand(self.OnButUseDefaultBackground, win32ui.IDC_CHECK2)
-            self.HookCommand(self.OnStyleUIChanged, win32ui.IDC_COMBO1)
-            self.HookCommand(self.OnStyleUIChanged, win32ui.IDC_COMBO2)
-            self.HookCommand(self.OnButFixedOrDefault, win32ui.IDC_RADIO1)
-            self.HookCommand(self.OnButFixedOrDefault, win32ui.IDC_RADIO2)
-        except:
-            import traceback
-
-            traceback.print_exc()
-
-    def OnEsc(self, ch):
-        self.GetParent().EndDialog(win32con.IDCANCEL)
-
-    def OnBraceMatch(self, std, extra):
-        import pywin.scintilla.view
-
-        pywin.scintilla.view.DoBraceMatch(self.scintilla)
-
-    def GetSelectedStyle(self):
-        return self.styles[self.listbox.GetText(self.listbox.GetCurSel())]
-
-    def _DoButDefaultFont(self, extra_flags, attr):
-        baseFormat = getattr(self.scintilla._GetColorizer(), attr)
-        flags = (
-            extra_flags
-            | win32con.CF_SCREENFONTS
-            | win32con.CF_EFFECTS
-            | win32con.CF_FORCEFONTEXIST
-        )
-        d = win32ui.CreateFontDialog(baseFormat, flags, None, self)
-        if d.DoModal() == win32con.IDOK:
-            setattr(self.scintilla._GetColorizer(), attr, d.GetCharFormat())
-            self.OnStyleUIChanged(0, win32con.BN_CLICKED)
-
-    def OnButDefaultFixedFont(self, id, code):
-        if code == win32con.BN_CLICKED:
-            self._DoButDefaultFont(win32con.CF_FIXEDPITCHONLY, "baseFormatFixed")
-            return 1
-
-    def OnButDefaultPropFont(self, id, code):
-        if code == win32con.BN_CLICKED:
-            self._DoButDefaultFont(win32con.CF_SCALABLEONLY, "baseFormatProp")
-            return 1
-
-    def OnButFixedOrDefault(self, id, code):
-        if code == win32con.BN_CLICKED:
-            bUseFixed = id == win32ui.IDC_RADIO1
-            self.GetDlgItem(win32ui.IDC_RADIO1).GetCheck() != 0
-            self.scintilla._GetColorizer().bUseFixed = bUseFixed
-            self.scintilla.ApplyFormattingStyles(0)
-            return 1
-
-    def OnButThisFont(self, id, code):
-        if code == win32con.BN_CLICKED:
-            flags = (
-                win32con.CF_SCREENFONTS
-                | win32con.CF_EFFECTS
-                | win32con.CF_FORCEFONTEXIST
-            )
-            style = self.GetSelectedStyle()
-            # If the selected style is based on the default, we need to apply
-            # the default to it.
-            def_format = self.scintilla._GetColorizer().GetDefaultFormat()
-            format = style.GetCompleteFormat(def_format)
-            d = win32ui.CreateFontDialog(format, flags, None, self)
-            if d.DoModal() == win32con.IDOK:
-                style.format = d.GetCharFormat()
-                self.scintilla.ApplyFormattingStyles(0)
-            return 1
-
-    def OnButUseDefaultFont(self, id, code):
-        if code == win32con.BN_CLICKED:
-            isDef = self.butIsDefault.GetCheck()
-            self.GetDlgItem(win32ui.IDC_BUTTON3).EnableWindow(not isDef)
-            if isDef:  # Being reset to the default font.
-                style = self.GetSelectedStyle()
-                style.ForceAgainstDefault()
-                self.UpdateUIForStyle(style)
-                self.scintilla.ApplyFormattingStyles(0)
-            else:
-                # User wants to override default -
-                # do nothing!
-                pass
-
-    def OnButThisBackground(self, id, code):
-        if code == win32con.BN_CLICKED:
-            style = self.GetSelectedStyle()
-            bg = win32api.RGB(0xFF, 0xFF, 0xFF)
-            if style.background != CLR_INVALID:
-                bg = style.background
-            d = win32ui.CreateColorDialog(bg, 0, self)
-            if d.DoModal() == win32con.IDOK:
-                style.background = d.GetColor()
-                self.scintilla.ApplyFormattingStyles(0)
-            return 1
-
-    def OnButUseDefaultBackground(self, id, code):
-        if code == win32con.BN_CLICKED:
-            isDef = self.butIsDefaultBackground.GetCheck()
-            self.GetDlgItem(win32ui.IDC_BUTTON4).EnableWindow(not isDef)
-            if isDef:  # Being reset to the default color
-                style = self.GetSelectedStyle()
-                style.background = style.default_background
-                self.UpdateUIForStyle(style)
-                self.scintilla.ApplyFormattingStyles(0)
-            else:
-                # User wants to override default -
-                # do nothing!
-                pass
-
-    def OnListCommand(self, id, code):
-        if code == win32con.LBN_SELCHANGE:
-            style = self.GetSelectedStyle()
-            self.UpdateUIForStyle(style)
-        return 1
-
-    def UpdateUIForStyle(self, style):
-        format = style.format
-        sel = 0
-        for c in paletteVGA:
-            if format[4] == c[1]:
-                # 				print "Style", style.name, "is", c[0]
-                break
-            sel = sel + 1
-        else:
-            sel = -1
-        self.cbo.SetCurSel(sel)
-        self.butIsDefault.SetCheck(style.IsBasedOnDefault())
-        self.GetDlgItem(win32ui.IDC_BUTTON3).EnableWindow(not style.IsBasedOnDefault())
-
-        self.butIsDefaultBackground.SetCheck(
-            style.background == style.default_background
-        )
-        self.GetDlgItem(win32ui.IDC_BUTTON4).EnableWindow(
-            style.background != style.default_background
-        )
-
-        bold = format[1] & win32con.CFE_BOLD != 0
-        italic = format[1] & win32con.CFE_ITALIC != 0
-        self.cboBoldItalic.SetCurSel(bold * 2 + italic)
-
-    def OnStyleUIChanged(self, id, code):
-        if code in [win32con.BN_CLICKED, win32con.CBN_SELCHANGE]:
-            style = self.GetSelectedStyle()
-            self.ApplyUIFormatToStyle(style)
-            self.scintilla.ApplyFormattingStyles(0)
-            return 0
-        return 1
-
-    def ApplyUIFormatToStyle(self, style):
-        format = style.format
-        color = paletteVGA[self.cbo.GetCurSel()]
-        effect = 0
-        sel = self.cboBoldItalic.GetCurSel()
-        if sel == 0:
-            effect = 0
-        elif sel == 1:
-            effect = win32con.CFE_ITALIC
-        elif sel == 2:
-            effect = win32con.CFE_BOLD
-        else:
-            effect = win32con.CFE_BOLD | win32con.CFE_ITALIC
-        maskFlags = (
-            format[0] | win32con.CFM_COLOR | win32con.CFM_BOLD | win32con.CFM_ITALIC
-        )
-        style.format = (
-            maskFlags,
-            effect,
-            style.format[2],
-            style.format[3],
-            color[1],
-        ) + style.format[5:]
-
-    def OnOK(self):
-        self.scintilla._GetColorizer().SavePreferences()
-        return 1
-
-
-def test():
-    page = ColorEditorPropertyPage()
-    sheet = pywin.mfc.dialog.PropertySheet("Test")
-    sheet.AddPage(page)
-    sheet.CreateWindow()
diff --git a/lib/pythonwin/pywin/scintilla/control.py b/lib/pythonwin/pywin/scintilla/control.py
deleted file mode 100644
index 460b1686..00000000
--- a/lib/pythonwin/pywin/scintilla/control.py
+++ /dev/null
@@ -1,569 +0,0 @@
-# An Python interface to the Scintilla control.
-#
-# Exposes Python classes that allow you to use Scintilla as
-# a "standard" MFC edit control (eg, control.GetTextLength(), control.GetSel()
-# plus many Scintilla specific features (eg control.SCIAddStyledText())
-
-import array
-import os
-import struct
-
-import win32api
-import win32con
-import win32ui
-from pywin import default_scintilla_encoding
-from pywin.mfc import window
-
-from . import scintillacon
-
-# Load Scintilla.dll to get access to the control.
-# We expect to find this in the same directory as win32ui.pyd
-dllid = None
-if win32ui.debug:  # If running _d version of Pythonwin...
-    try:
-        dllid = win32api.LoadLibrary(
-            os.path.join(os.path.split(win32ui.__file__)[0], "Scintilla_d.DLL")
-        )
-    except (
-        win32api.error
-    ):  # Not there - we dont _need_ a debug ver, so ignore this error.
-        pass
-if dllid is None:
-    try:
-        dllid = win32api.LoadLibrary(
-            os.path.join(os.path.split(win32ui.__file__)[0], "Scintilla.DLL")
-        )
-    except win32api.error:
-        pass
-if dllid is None:
-    # Still not there - lets see if Windows can find it by searching?
-    dllid = win32api.LoadLibrary("Scintilla.DLL")
-
-# null_byte is str in py2k, bytes on py3k
-null_byte = "\0".encode("ascii")
-
-## These are from Richedit.h - need to add to win32con or commctrl
-EM_GETTEXTRANGE = 1099
-EM_EXLINEFROMCHAR = 1078
-EM_FINDTEXTEX = 1103
-EM_GETSELTEXT = 1086
-EM_EXSETSEL = win32con.WM_USER + 55
-
-
-class ScintillaNotification:
-    def __init__(self, **args):
-        self.__dict__.update(args)
-
-
-class ScintillaControlInterface:
-    def SCIUnpackNotifyMessage(self, msg):
-        format = "iiiiPiiiPPiiii"
-        bytes = win32ui.GetBytes(msg, struct.calcsize(format))
-        (
-            position,
-            ch,
-            modifiers,
-            modificationType,
-            text_ptr,
-            length,
-            linesAdded,
-            msg,
-            wParam,
-            lParam,
-            line,
-            foldLevelNow,
-            foldLevelPrev,
-            margin,
-        ) = struct.unpack(format, bytes)
-        return ScintillaNotification(
-            position=position,
-            ch=ch,
-            modifiers=modifiers,
-            modificationType=modificationType,
-            text_ptr=text_ptr,
-            length=length,
-            linesAdded=linesAdded,
-            msg=msg,
-            wParam=wParam,
-            lParam=lParam,
-            line=line,
-            foldLevelNow=foldLevelNow,
-            foldLevelPrev=foldLevelPrev,
-            margin=margin,
-        )
-
-    def SCIAddText(self, text):
-        self.SendMessage(
-            scintillacon.SCI_ADDTEXT, text.encode(default_scintilla_encoding)
-        )
-
-    def SCIAddStyledText(self, text, style=None):
-        # If style is None, text is assumed to be a "native" Scintilla buffer.
-        # If style is specified, text is a normal string, and the style is
-        # assumed to apply to the entire string.
-        if style is not None:
-            text = list(map(lambda char, style=style: char + chr(style), text))
-            text = "".join(text)
-        self.SendMessage(
-            scintillacon.SCI_ADDSTYLEDTEXT, text.encode(default_scintilla_encoding)
-        )
-
-    def SCIInsertText(self, text, pos=-1):
-        # SCIInsertText allows unicode or bytes - but if they are bytes,
-        # the caller must ensure it is encoded correctly.
-        if isinstance(text, str):
-            text = text.encode(default_scintilla_encoding)
-        self.SendScintilla(scintillacon.SCI_INSERTTEXT, pos, text + null_byte)
-
-    def SCISetSavePoint(self):
-        self.SendScintilla(scintillacon.SCI_SETSAVEPOINT)
-
-    def SCISetUndoCollection(self, collectFlag):
-        self.SendScintilla(scintillacon.SCI_SETUNDOCOLLECTION, collectFlag)
-
-    def SCIBeginUndoAction(self):
-        self.SendScintilla(scintillacon.SCI_BEGINUNDOACTION)
-
-    def SCIEndUndoAction(self):
-        self.SendScintilla(scintillacon.SCI_ENDUNDOACTION)
-
-    def SCIGetCurrentPos(self):
-        return self.SendScintilla(scintillacon.SCI_GETCURRENTPOS)
-
-    def SCIGetCharAt(self, pos):
-        # Must ensure char is unsigned!
-        return chr(self.SendScintilla(scintillacon.SCI_GETCHARAT, pos) & 0xFF)
-
-    def SCIGotoLine(self, line):
-        self.SendScintilla(scintillacon.SCI_GOTOLINE, line)
-
-    def SCIBraceMatch(self, pos, maxReStyle):
-        return self.SendScintilla(scintillacon.SCI_BRACEMATCH, pos, maxReStyle)
-
-    def SCIBraceHighlight(self, pos, posOpposite):
-        return self.SendScintilla(scintillacon.SCI_BRACEHIGHLIGHT, pos, posOpposite)
-
-    def SCIBraceBadHighlight(self, pos):
-        return self.SendScintilla(scintillacon.SCI_BRACEBADLIGHT, pos)
-
-    ####################################
-    # Styling
-    # 	def SCIColourise(self, start=0, end=-1):
-    #   NOTE - dependent on of we use builtin lexer, so handled below.
-    def SCIGetEndStyled(self):
-        return self.SendScintilla(scintillacon.SCI_GETENDSTYLED)
-
-    def SCIStyleSetFore(self, num, v):
-        return self.SendScintilla(scintillacon.SCI_STYLESETFORE, num, v)
-
-    def SCIStyleSetBack(self, num, v):
-        return self.SendScintilla(scintillacon.SCI_STYLESETBACK, num, v)
-
-    def SCIStyleSetEOLFilled(self, num, v):
-        return self.SendScintilla(scintillacon.SCI_STYLESETEOLFILLED, num, v)
-
-    def SCIStyleSetFont(self, num, name, characterset=0):
-        buff = (name + "\0").encode(default_scintilla_encoding)
-        self.SendScintilla(scintillacon.SCI_STYLESETFONT, num, buff)
-        self.SendScintilla(scintillacon.SCI_STYLESETCHARACTERSET, num, characterset)
-
-    def SCIStyleSetBold(self, num, bBold):
-        self.SendScintilla(scintillacon.SCI_STYLESETBOLD, num, bBold)
-
-    def SCIStyleSetItalic(self, num, bItalic):
-        self.SendScintilla(scintillacon.SCI_STYLESETITALIC, num, bItalic)
-
-    def SCIStyleSetSize(self, num, size):
-        self.SendScintilla(scintillacon.SCI_STYLESETSIZE, num, size)
-
-    def SCIGetViewWS(self):
-        return self.SendScintilla(scintillacon.SCI_GETVIEWWS)
-
-    def SCISetViewWS(self, val):
-        self.SendScintilla(scintillacon.SCI_SETVIEWWS, not (val == 0))
-        self.InvalidateRect()
-
-    def SCISetIndentationGuides(self, val):
-        self.SendScintilla(scintillacon.SCI_SETINDENTATIONGUIDES, val)
-
-    def SCIGetIndentationGuides(self):
-        return self.SendScintilla(scintillacon.SCI_GETINDENTATIONGUIDES)
-
-    def SCISetIndent(self, val):
-        self.SendScintilla(scintillacon.SCI_SETINDENT, val)
-
-    def SCIGetIndent(self, val):
-        return self.SendScintilla(scintillacon.SCI_GETINDENT)
-
-    def SCIGetViewEOL(self):
-        return self.SendScintilla(scintillacon.SCI_GETVIEWEOL)
-
-    def SCISetViewEOL(self, val):
-        self.SendScintilla(scintillacon.SCI_SETVIEWEOL, not (val == 0))
-        self.InvalidateRect()
-
-    def SCISetTabWidth(self, width):
-        self.SendScintilla(scintillacon.SCI_SETTABWIDTH, width, 0)
-
-    def SCIStartStyling(self, pos, mask):
-        self.SendScintilla(scintillacon.SCI_STARTSTYLING, pos, mask)
-
-    def SCISetStyling(self, pos, attr):
-        self.SendScintilla(scintillacon.SCI_SETSTYLING, pos, attr)
-
-    def SCISetStylingEx(self, ray):  # ray is an array.
-        address, length = ray.buffer_info()
-        self.SendScintilla(scintillacon.SCI_SETSTYLINGEX, length, address)
-
-    def SCIGetStyleAt(self, pos):
-        return self.SendScintilla(scintillacon.SCI_GETSTYLEAT, pos)
-
-    def SCISetMarginWidth(self, width):
-        self.SendScintilla(scintillacon.SCI_SETMARGINWIDTHN, 1, width)
-
-    def SCISetMarginWidthN(self, n, width):
-        self.SendScintilla(scintillacon.SCI_SETMARGINWIDTHN, n, width)
-
-    def SCISetFoldFlags(self, flags):
-        self.SendScintilla(scintillacon.SCI_SETFOLDFLAGS, flags)
-
-    # Markers
-    def SCIMarkerDefineAll(self, markerNum, markerType, fore, back):
-        self.SCIMarkerDefine(markerNum, markerType)
-        self.SCIMarkerSetFore(markerNum, fore)
-        self.SCIMarkerSetBack(markerNum, back)
-
-    def SCIMarkerDefine(self, markerNum, markerType):
-        self.SendScintilla(scintillacon.SCI_MARKERDEFINE, markerNum, markerType)
-
-    def SCIMarkerSetFore(self, markerNum, fore):
-        self.SendScintilla(scintillacon.SCI_MARKERSETFORE, markerNum, fore)
-
-    def SCIMarkerSetBack(self, markerNum, back):
-        self.SendScintilla(scintillacon.SCI_MARKERSETBACK, markerNum, back)
-
-    def SCIMarkerAdd(self, lineNo, markerNum):
-        self.SendScintilla(scintillacon.SCI_MARKERADD, lineNo, markerNum)
-
-    def SCIMarkerDelete(self, lineNo, markerNum):
-        self.SendScintilla(scintillacon.SCI_MARKERDELETE, lineNo, markerNum)
-
-    def SCIMarkerDeleteAll(self, markerNum=-1):
-        self.SendScintilla(scintillacon.SCI_MARKERDELETEALL, markerNum)
-
-    def SCIMarkerGet(self, lineNo):
-        return self.SendScintilla(scintillacon.SCI_MARKERGET, lineNo)
-
-    def SCIMarkerNext(self, lineNo, markerNum):
-        return self.SendScintilla(scintillacon.SCI_MARKERNEXT, lineNo, markerNum)
-
-    def SCICancel(self):
-        self.SendScintilla(scintillacon.SCI_CANCEL)
-
-    # AutoComplete
-    def SCIAutoCShow(self, text):
-        if type(text) in [type([]), type(())]:
-            text = " ".join(text)
-        buff = (text + "\0").encode(default_scintilla_encoding)
-        return self.SendScintilla(scintillacon.SCI_AUTOCSHOW, 0, buff)
-
-    def SCIAutoCCancel(self):
-        self.SendScintilla(scintillacon.SCI_AUTOCCANCEL)
-
-    def SCIAutoCActive(self):
-        return self.SendScintilla(scintillacon.SCI_AUTOCACTIVE)
-
-    def SCIAutoCComplete(self):
-        return self.SendScintilla(scintillacon.SCI_AUTOCCOMPLETE)
-
-    def SCIAutoCStops(self, stops):
-        buff = (stops + "\0").encode(default_scintilla_encoding)
-        self.SendScintilla(scintillacon.SCI_AUTOCSTOPS, 0, buff)
-
-    def SCIAutoCSetAutoHide(self, hide):
-        self.SendScintilla(scintillacon.SCI_AUTOCSETAUTOHIDE, hide)
-
-    def SCIAutoCSetFillups(self, fillups):
-        self.SendScintilla(scintillacon.SCI_AUTOCSETFILLUPS, fillups)
-
-    # Call tips
-    def SCICallTipShow(self, text, pos=-1):
-        if pos == -1:
-            pos = self.GetSel()[0]
-        buff = (text + "\0").encode(default_scintilla_encoding)
-        self.SendScintilla(scintillacon.SCI_CALLTIPSHOW, pos, buff)
-
-    def SCICallTipCancel(self):
-        self.SendScintilla(scintillacon.SCI_CALLTIPCANCEL)
-
-    def SCICallTipActive(self):
-        return self.SendScintilla(scintillacon.SCI_CALLTIPACTIVE)
-
-    def SCICallTipPosStart(self):
-        return self.SendScintilla(scintillacon.SCI_CALLTIPPOSSTART)
-
-    def SCINewline(self):
-        self.SendScintilla(scintillacon.SCI_NEWLINE)
-
-    # Lexer etc
-    def SCISetKeywords(self, keywords, kw_list_no=0):
-        buff = (keywords + "\0").encode(default_scintilla_encoding)
-        self.SendScintilla(scintillacon.SCI_SETKEYWORDS, kw_list_no, buff)
-
-    def SCISetProperty(self, name, value):
-        name_buff = array.array("b", (name + "\0").encode(default_scintilla_encoding))
-        val_buff = array.array(
-            "b", (str(value) + "\0").encode(default_scintilla_encoding)
-        )
-        address_name_buffer = name_buff.buffer_info()[0]
-        address_val_buffer = val_buff.buffer_info()[0]
-        self.SendScintilla(
-            scintillacon.SCI_SETPROPERTY, address_name_buffer, address_val_buffer
-        )
-
-    def SCISetStyleBits(self, nbits):
-        self.SendScintilla(scintillacon.SCI_SETSTYLEBITS, nbits)
-
-    # Folding
-    def SCIGetFoldLevel(self, lineno):
-        return self.SendScintilla(scintillacon.SCI_GETFOLDLEVEL, lineno)
-
-    def SCIToggleFold(self, lineno):
-        return self.SendScintilla(scintillacon.SCI_TOGGLEFOLD, lineno)
-
-    def SCIEnsureVisible(self, lineno):
-        self.SendScintilla(scintillacon.SCI_ENSUREVISIBLE, lineno)
-
-    def SCIGetFoldExpanded(self, lineno):
-        return self.SendScintilla(scintillacon.SCI_GETFOLDEXPANDED, lineno)
-
-    # right edge
-    def SCISetEdgeColumn(self, edge):
-        self.SendScintilla(scintillacon.SCI_SETEDGECOLUMN, edge)
-
-    def SCIGetEdgeColumn(self):
-        return self.SendScintilla(scintillacon.SCI_GETEDGECOLUMN)
-
-    def SCISetEdgeMode(self, mode):
-        self.SendScintilla(scintillacon.SCI_SETEDGEMODE, mode)
-
-    def SCIGetEdgeMode(self):
-        return self.SendScintilla(scintillacon.SCI_GETEDGEMODE)
-
-    def SCISetEdgeColor(self, color):
-        self.SendScintilla(scintillacon.SCI_SETEDGECOLOUR, color)
-
-    def SCIGetEdgeColor(self):
-        return self.SendScintilla(scintillacon.SCI_GETEDGECOLOR)
-
-    # Multi-doc
-    def SCIGetDocPointer(self):
-        return self.SendScintilla(scintillacon.SCI_GETDOCPOINTER)
-
-    def SCISetDocPointer(self, p):
-        return self.SendScintilla(scintillacon.SCI_SETDOCPOINTER, 0, p)
-
-    def SCISetWrapMode(self, mode):
-        return self.SendScintilla(scintillacon.SCI_SETWRAPMODE, mode)
-
-    def SCIGetWrapMode(self):
-        return self.SendScintilla(scintillacon.SCI_GETWRAPMODE)
-
-
-class CScintillaEditInterface(ScintillaControlInterface):
-    def close(self):
-        self.colorizer = None
-
-    def Clear(self):
-        self.SendScintilla(win32con.WM_CLEAR)
-
-    def FindText(self, flags, range, findText):
-        """LPARAM for EM_FINDTEXTEX:
-                typedef struct _findtextex {
-                CHARRANGE chrg;
-                LPCTSTR lpstrText;
-                CHARRANGE chrgText;} FINDTEXTEX;
-        typedef struct _charrange {
-                LONG cpMin;
-                LONG cpMax;} CHARRANGE;
-        """
-        findtextex_fmt = "llPll"
-        ## Scintilla does not handle unicode in EM_FINDTEXT msg (FINDTEXTEX struct)
-        txt_buff = (findText + "\0").encode(default_scintilla_encoding)
-        txt_array = array.array("b", txt_buff)
-        ft_buff = struct.pack(
-            findtextex_fmt, range[0], range[1], txt_array.buffer_info()[0], 0, 0
-        )
-        ft_array = array.array("b", ft_buff)
-        rc = self.SendScintilla(EM_FINDTEXTEX, flags, ft_array.buffer_info()[0])
-        ftUnpacked = struct.unpack(findtextex_fmt, ft_array)
-        return rc, (ftUnpacked[3], ftUnpacked[4])
-
-    def GetSel(self):
-        currentPos = self.SendScintilla(scintillacon.SCI_GETCURRENTPOS)
-        anchorPos = self.SendScintilla(scintillacon.SCI_GETANCHOR)
-        if currentPos < anchorPos:
-            return (currentPos, anchorPos)
-        else:
-            return (anchorPos, currentPos)
-        return currentPos
-
-    def GetSelText(self):
-        start, end = self.GetSel()
-        txtBuf = array.array("b", null_byte * (end - start + 1))
-        addressTxtBuf = txtBuf.buffer_info()[0]
-        # EM_GETSELTEXT is documented as returning the number of chars
-        # not including the NULL, but scintilla includes the NULL.  A
-        # quick glance at the scintilla impl doesn't make this
-        # obvious - the NULL is included in the 'selection' object
-        # and reflected in the length of that 'selection' object.
-        # I expect that is a bug in scintilla and may be fixed by now,
-        # but we just blindly assume that the last char is \0 and
-        # strip it.
-        self.SendScintilla(EM_GETSELTEXT, 0, addressTxtBuf)
-        return txtBuf.tobytes()[:-1].decode(default_scintilla_encoding)
-
-    def SetSel(self, start=0, end=None):
-        if type(start) == type(()):
-            assert (
-                end is None
-            ), "If you pass a point in the first param, the second must be None"
-            start, end = start
-        elif end is None:
-            end = start
-        if start < 0:
-            start = self.GetTextLength()
-        if end < 0:
-            end = self.GetTextLength()
-        assert start <= self.GetTextLength(), "The start postion is invalid (%d/%d)" % (
-            start,
-            self.GetTextLength(),
-        )
-        assert end <= self.GetTextLength(), "The end postion is invalid (%d/%d)" % (
-            end,
-            self.GetTextLength(),
-        )
-        cr = struct.pack("ll", start, end)
-        crBuff = array.array("b", cr)
-        addressCrBuff = crBuff.buffer_info()[0]
-        rc = self.SendScintilla(EM_EXSETSEL, 0, addressCrBuff)
-
-    def GetLineCount(self):
-        return self.SendScintilla(win32con.EM_GETLINECOUNT)
-
-    def LineFromChar(self, charPos=-1):
-        if charPos == -1:
-            charPos = self.GetSel()[0]
-        assert (
-            charPos >= 0 and charPos <= self.GetTextLength()
-        ), "The charPos postion (%s) is invalid (max=%s)" % (
-            charPos,
-            self.GetTextLength(),
-        )
-        # return self.SendScintilla(EM_EXLINEFROMCHAR, charPos)
-        # EM_EXLINEFROMCHAR puts charPos in lParam, not wParam
-        return self.SendScintilla(EM_EXLINEFROMCHAR, 0, charPos)
-
-    def LineIndex(self, line):
-        return self.SendScintilla(win32con.EM_LINEINDEX, line)
-
-    def ScrollCaret(self):
-        return self.SendScintilla(win32con.EM_SCROLLCARET)
-
-    def GetCurLineNumber(self):
-        return self.LineFromChar(self.SCIGetCurrentPos())
-
-    def GetTextLength(self):
-        return self.SendScintilla(scintillacon.SCI_GETTEXTLENGTH)
-
-    def GetTextRange(self, start=0, end=-1, decode=True):
-        if end == -1:
-            end = self.SendScintilla(scintillacon.SCI_GETTEXTLENGTH)
-        assert end >= start, "Negative index requested (%d/%d)" % (start, end)
-        assert (
-            start >= 0 and start <= self.GetTextLength()
-        ), "The start postion is invalid"
-        assert end >= 0 and end <= self.GetTextLength(), "The end postion is invalid"
-        initer = null_byte * (end - start + 1)
-        buff = array.array("b", initer)
-        addressBuffer = buff.buffer_info()[0]
-        tr = struct.pack("llP", start, end, addressBuffer)
-        trBuff = array.array("b", tr)
-        addressTrBuff = trBuff.buffer_info()[0]
-        num_bytes = self.SendScintilla(EM_GETTEXTRANGE, 0, addressTrBuff)
-        ret = buff.tobytes()[:num_bytes]
-        if decode:
-            ret = ret.decode(default_scintilla_encoding)
-        return ret
-
-    def ReplaceSel(self, str):
-        buff = (str + "\0").encode(default_scintilla_encoding)
-        self.SendScintilla(scintillacon.SCI_REPLACESEL, 0, buff)
-
-    def GetLine(self, line=-1):
-        if line == -1:
-            line = self.GetCurLineNumber()
-        start = self.LineIndex(line)
-        end = self.LineIndex(line + 1)
-        return self.GetTextRange(start, end)
-
-    def SetReadOnly(self, flag=1):
-        return self.SendScintilla(win32con.EM_SETREADONLY, flag)
-
-    def LineScroll(self, lines, cols=0):
-        return self.SendScintilla(win32con.EM_LINESCROLL, cols, lines)
-
-    def GetFirstVisibleLine(self):
-        return self.SendScintilla(win32con.EM_GETFIRSTVISIBLELINE)
-
-    def SetWordWrap(self, mode):
-        if mode != win32ui.CRichEditView_WrapNone:
-            raise ValueError("We dont support word-wrap (I dont think :-)")
-
-
-class CScintillaColorEditInterface(CScintillaEditInterface):
-    ################################
-    # Plug-in colorizer support
-    def _GetColorizer(self):
-        if not hasattr(self, "colorizer"):
-            self.colorizer = self._MakeColorizer()
-        return self.colorizer
-
-    def _MakeColorizer(self):
-        # Give parent a chance to hook.
-        parent_func = getattr(self.GetParentFrame(), "_MakeColorizer", None)
-        if parent_func is not None:
-            return parent_func()
-        from . import formatter
-
-        ##		return formatter.PythonSourceFormatter(self)
-        return formatter.BuiltinPythonSourceFormatter(self)
-
-    def Colorize(self, start=0, end=-1):
-        c = self._GetColorizer()
-        if c is not None:
-            c.Colorize(start, end)
-
-    def ApplyFormattingStyles(self, bReload=1):
-        c = self._GetColorizer()
-        if c is not None:
-            c.ApplyFormattingStyles(bReload)
-
-    # The Parent window will normally hook
-    def HookFormatter(self, parent=None):
-        c = self._GetColorizer()
-        if c is not None:  # No need if we have no color!
-            c.HookFormatter(parent)
-
-
-class CScintillaEdit(window.Wnd, CScintillaColorEditInterface):
-    def __init__(self, wnd=None):
-        if wnd is None:
-            wnd = win32ui.CreateWnd()
-        window.Wnd.__init__(self, wnd)
-
-    def SendScintilla(self, msg, w=0, l=0):
-        return self.SendMessage(msg, w, l)
-
-    def CreateWindow(self, style, rect, parent, id):
-        self._obj_.CreateWindow("Scintilla", "Scintilla", style, rect, parent, id, None)
diff --git a/lib/pythonwin/pywin/scintilla/document.py b/lib/pythonwin/pywin/scintilla/document.py
deleted file mode 100644
index cddb442c..00000000
--- a/lib/pythonwin/pywin/scintilla/document.py
+++ /dev/null
@@ -1,312 +0,0 @@
-import codecs
-import re
-import string
-
-import win32con
-import win32ui
-from pywin import default_scintilla_encoding
-from pywin.mfc import docview
-
-from . import scintillacon
-
-crlf_bytes = "\r\n".encode("ascii")
-lf_bytes = "\n".encode("ascii")
-
-# re from pep263 - but we use it both on bytes and strings.
-re_encoding_bytes = re.compile("coding[:=]\s*([-\w.]+)".encode("ascii"))
-re_encoding_text = re.compile("coding[:=]\s*([-\w.]+)")
-
-ParentScintillaDocument = docview.Document
-
-
-class CScintillaDocument(ParentScintillaDocument):
-    "A SyntEdit document."
-
-    def __init__(self, *args):
-        self.bom = None  # the BOM, if any, read from the file.
-        # the encoding we detected from the source.  Might have
-        # detected via the BOM or an encoding decl.  Note that in
-        # the latter case (ie, while self.bom is None), it can't be
-        # trusted - the user may have edited the encoding decl between
-        # open and save.
-        self.source_encoding = None
-        ParentScintillaDocument.__init__(self, *args)
-
-    def DeleteContents(self):
-        pass
-
-    def OnOpenDocument(self, filename):
-        # init data members
-        # print "Opening", filename
-        self.SetPathName(filename)  # Must set this early!
-        try:
-            # load the text as binary we can get smart
-            # about detecting any existing EOL conventions.
-            f = open(filename, "rb")
-            try:
-                self._LoadTextFromFile(f)
-            finally:
-                f.close()
-        except IOError:
-            rc = win32ui.MessageBox(
-                "Could not load the file from %s\n\nDo you want to create a new file?"
-                % filename,
-                "Pythonwin",
-                win32con.MB_YESNO | win32con.MB_ICONWARNING,
-            )
-            if rc == win32con.IDNO:
-                return 0
-            assert rc == win32con.IDYES, rc
-            try:
-                f = open(filename, "wb+")
-                try:
-                    self._LoadTextFromFile(f)
-                finally:
-                    f.close()
-            except IOError as e:
-                rc = win32ui.MessageBox("Cannot create the file %s" % filename)
-        return 1
-
-    def SaveFile(self, fileName, encoding=None):
-        view = self.GetFirstView()
-        ok = view.SaveTextFile(fileName, encoding=encoding)
-        if ok:
-            view.SCISetSavePoint()
-        return ok
-
-    def ApplyFormattingStyles(self):
-        self._ApplyOptionalToViews("ApplyFormattingStyles")
-
-    # #####################
-    # File related functions
-    # Helper to transfer text from the MFC document to the control.
-    def _LoadTextFromFile(self, f):
-        # detect EOL mode - we don't support \r only - so find the
-        # first '\n' and guess based on the char before.
-        l = f.readline()
-        l2 = f.readline()
-        # If line ends with \r\n or has no line ending, use CRLF.
-        if l.endswith(crlf_bytes) or not l.endswith(lf_bytes):
-            eol_mode = scintillacon.SC_EOL_CRLF
-        else:
-            eol_mode = scintillacon.SC_EOL_LF
-
-        # Detect the encoding - first look for a BOM, and if not found,
-        # look for a pep263 encoding declaration.
-        for bom, encoding in (
-            (codecs.BOM_UTF8, "utf8"),
-            (codecs.BOM_UTF16_LE, "utf_16_le"),
-            (codecs.BOM_UTF16_BE, "utf_16_be"),
-        ):
-            if l.startswith(bom):
-                self.bom = bom
-                self.source_encoding = encoding
-                l = l[len(bom) :]  # remove it.
-                break
-        else:
-            # no bom detected - look for pep263 encoding decl.
-            for look in (l, l2):
-                # Note we are looking at raw bytes here: so
-                # both the re itself uses bytes and the result
-                # is bytes - but we need the result as a string.
-                match = re_encoding_bytes.search(look)
-                if match is not None:
-                    self.source_encoding = match.group(1).decode("ascii")
-                    break
-
-        # reading by lines would be too slow?  Maybe we can use the
-        # incremental encoders? For now just stick with loading the
-        # entire file in memory.
-        text = l + l2 + f.read()
-
-        # Translate from source encoding to UTF-8 bytes for Scintilla
-        source_encoding = self.source_encoding
-        # If we don't know an encoding, try utf-8 - if that fails we will
-        # fallback to latin-1 to treat it as bytes...
-        if source_encoding is None:
-            source_encoding = "utf-8"
-        # we could optimize this by avoiding utf8 to-ing and from-ing,
-        # but then we would lose the ability to handle invalid utf8
-        # (and even then, the use of encoding aliases makes this tricky)
-        # To create an invalid utf8 file:
-        # >>> open(filename, "wb").write(codecs.BOM_UTF8+"bad \xa9har\r\n")
-        try:
-            dec = text.decode(source_encoding)
-        except UnicodeError:
-            print(
-                "WARNING: Failed to decode bytes from '%s' encoding - treating as latin1"
-                % source_encoding
-            )
-            dec = text.decode("latin1")
-        except LookupError:
-            print(
-                "WARNING: Invalid encoding '%s' specified - treating as latin1"
-                % source_encoding
-            )
-            dec = text.decode("latin1")
-        # and put it back as utf8 - this shouldn't fail.
-        text = dec.encode(default_scintilla_encoding)
-
-        view = self.GetFirstView()
-        if view.IsWindow():
-            # Turn off undo collection while loading
-            view.SendScintilla(scintillacon.SCI_SETUNDOCOLLECTION, 0, 0)
-            # Make sure the control isnt read-only
-            view.SetReadOnly(0)
-            view.SendScintilla(scintillacon.SCI_CLEARALL)
-            view.SendMessage(scintillacon.SCI_ADDTEXT, text)
-            view.SendScintilla(scintillacon.SCI_SETUNDOCOLLECTION, 1, 0)
-            view.SendScintilla(win32con.EM_EMPTYUNDOBUFFER, 0, 0)
-            # set EOL mode
-            view.SendScintilla(scintillacon.SCI_SETEOLMODE, eol_mode)
-
-    def _SaveTextToFile(self, view, filename, encoding=None):
-        s = view.GetTextRange()  # already decoded from scintilla's encoding
-        source_encoding = encoding
-        if source_encoding is None:
-            if self.bom:
-                source_encoding = self.source_encoding
-            else:
-                # no BOM - look for an encoding.
-                bits = re.split("[\r\n]+", s, 3)
-                for look in bits[:-1]:
-                    match = re_encoding_text.search(look)
-                    if match is not None:
-                        source_encoding = match.group(1)
-                        self.source_encoding = source_encoding
-                        break
-
-            if source_encoding is None:
-                source_encoding = "utf-8"
-
-        ## encode data before opening file so script is not lost if encoding fails
-        file_contents = s.encode(source_encoding)
-        # Open in binary mode as scintilla itself ensures the
-        # line endings are already appropriate
-        f = open(filename, "wb")
-        try:
-            if self.bom:
-                f.write(self.bom)
-            f.write(file_contents)
-        finally:
-            f.close()
-        self.SetModifiedFlag(0)
-
-    def FinalizeViewCreation(self, view):
-        pass
-
-    def HookViewNotifications(self, view):
-        parent = view.GetParentFrame()
-        parent.HookNotify(
-            ViewNotifyDelegate(self, "OnBraceMatch"), scintillacon.SCN_CHECKBRACE
-        )
-        parent.HookNotify(
-            ViewNotifyDelegate(self, "OnMarginClick"), scintillacon.SCN_MARGINCLICK
-        )
-        parent.HookNotify(
-            ViewNotifyDelegate(self, "OnNeedShown"), scintillacon.SCN_NEEDSHOWN
-        )
-
-        parent.HookNotify(
-            DocumentNotifyDelegate(self, "OnSavePointReached"),
-            scintillacon.SCN_SAVEPOINTREACHED,
-        )
-        parent.HookNotify(
-            DocumentNotifyDelegate(self, "OnSavePointLeft"),
-            scintillacon.SCN_SAVEPOINTLEFT,
-        )
-        parent.HookNotify(
-            DocumentNotifyDelegate(self, "OnModifyAttemptRO"),
-            scintillacon.SCN_MODIFYATTEMPTRO,
-        )
-        # Tell scintilla what characters should abort auto-complete.
-        view.SCIAutoCStops(string.whitespace + "()[]:;+-/*=\\?'!#@$%^&,<>\"'|")
-
-        if view != self.GetFirstView():
-            view.SCISetDocPointer(self.GetFirstView().SCIGetDocPointer())
-
-    def OnSavePointReached(self, std, extra):
-        self.SetModifiedFlag(0)
-
-    def OnSavePointLeft(self, std, extra):
-        self.SetModifiedFlag(1)
-
-    def OnModifyAttemptRO(self, std, extra):
-        self.MakeDocumentWritable()
-
-    # All Marker functions are 1 based.
-    def MarkerAdd(self, lineNo, marker):
-        self.GetEditorView().SCIMarkerAdd(lineNo - 1, marker)
-
-    def MarkerCheck(self, lineNo, marker):
-        v = self.GetEditorView()
-        lineNo = lineNo - 1  # Make 0 based
-        markerState = v.SCIMarkerGet(lineNo)
-        return markerState & (1 << marker) != 0
-
-    def MarkerToggle(self, lineNo, marker):
-        v = self.GetEditorView()
-        if self.MarkerCheck(lineNo, marker):
-            v.SCIMarkerDelete(lineNo - 1, marker)
-        else:
-            v.SCIMarkerAdd(lineNo - 1, marker)
-
-    def MarkerDelete(self, lineNo, marker):
-        self.GetEditorView().SCIMarkerDelete(lineNo - 1, marker)
-
-    def MarkerDeleteAll(self, marker):
-        self.GetEditorView().SCIMarkerDeleteAll(marker)
-
-    def MarkerGetNext(self, lineNo, marker):
-        return self.GetEditorView().SCIMarkerNext(lineNo - 1, 1 << marker) + 1
-
-    def MarkerAtLine(self, lineNo, marker):
-        markerState = self.GetEditorView().SCIMarkerGet(lineNo - 1)
-        return markerState & (1 << marker)
-
-    # Helper for reflecting functions to views.
-    def _ApplyToViews(self, funcName, *args):
-        for view in self.GetAllViews():
-            func = getattr(view, funcName)
-            func(*args)
-
-    def _ApplyOptionalToViews(self, funcName, *args):
-        for view in self.GetAllViews():
-            func = getattr(view, funcName, None)
-            if func is not None:
-                func(*args)
-
-    def GetEditorView(self):
-        # Find the first frame with a view,
-        # then ask it to give the editor view
-        # as it knows which one is "active"
-        try:
-            frame_gev = self.GetFirstView().GetParentFrame().GetEditorView
-        except AttributeError:
-            return self.GetFirstView()
-        return frame_gev()
-
-
-# Delegate to the correct view, based on the control that sent it.
-class ViewNotifyDelegate:
-    def __init__(self, doc, name):
-        self.doc = doc
-        self.name = name
-
-    def __call__(self, std, extra):
-        (hwndFrom, idFrom, code) = std
-        for v in self.doc.GetAllViews():
-            if v.GetSafeHwnd() == hwndFrom:
-                return getattr(v, self.name)(*(std, extra))
-
-
-# Delegate to the document, but only from a single view (as each view sends it seperately)
-class DocumentNotifyDelegate:
-    def __init__(self, doc, name):
-        self.doc = doc
-        self.delegate = getattr(doc, name)
-
-    def __call__(self, std, extra):
-        (hwndFrom, idFrom, code) = std
-        if hwndFrom == self.doc.GetEditorView().GetSafeHwnd():
-            self.delegate(*(std, extra))
diff --git a/lib/pythonwin/pywin/scintilla/find.py b/lib/pythonwin/pywin/scintilla/find.py
deleted file mode 100644
index e1d21a5b..00000000
--- a/lib/pythonwin/pywin/scintilla/find.py
+++ /dev/null
@@ -1,510 +0,0 @@
-# find.py - Find and Replace
-import afxres
-import win32api
-import win32con
-import win32ui
-from pywin.framework import scriptutils
-from pywin.mfc import dialog
-
-FOUND_NOTHING = 0
-FOUND_NORMAL = 1
-FOUND_LOOPED_BACK = 2
-FOUND_NEXT_FILE = 3
-
-
-class SearchParams:
-    def __init__(self, other=None):
-        if other is None:
-            self.__dict__["findText"] = ""
-            self.__dict__["replaceText"] = ""
-            self.__dict__["matchCase"] = 0
-            self.__dict__["matchWords"] = 0
-            self.__dict__["acrossFiles"] = 0
-            self.__dict__["remember"] = 1
-            self.__dict__["sel"] = (-1, -1)
-            self.__dict__["keepDialogOpen"] = 0
-        else:
-            self.__dict__.update(other.__dict__)
-
-    # Helper so we cant misspell attributes :-)
-    def __setattr__(self, attr, val):
-        if not hasattr(self, attr):
-            raise AttributeError(attr)
-        self.__dict__[attr] = val
-
-
-curDialog = None
-lastSearch = defaultSearch = SearchParams()
-searchHistory = []
-
-
-def ShowFindDialog():
-    _ShowDialog(FindDialog)
-
-
-def ShowReplaceDialog():
-    _ShowDialog(ReplaceDialog)
-
-
-def _ShowDialog(dlgClass):
-    global curDialog
-    if curDialog is not None:
-        if curDialog.__class__ != dlgClass:
-            curDialog.DestroyWindow()
-            curDialog = None
-        else:
-            curDialog.SetFocus()
-    if curDialog is None:
-        curDialog = dlgClass()
-        curDialog.CreateWindow()
-
-
-def FindNext():
-    params = SearchParams(lastSearch)
-    params.sel = (-1, -1)
-    if not params.findText:
-        ShowFindDialog()
-    else:
-        return _FindIt(None, params)
-
-
-def _GetControl(control=None):
-    if control is None:
-        control = scriptutils.GetActiveEditControl()
-    return control
-
-
-def _FindIt(control, searchParams):
-    global lastSearch, defaultSearch
-    control = _GetControl(control)
-    if control is None:
-        return FOUND_NOTHING
-
-    # Move to the next char, so we find the next one.
-    flags = 0
-    if searchParams.matchWords:
-        flags = flags | win32con.FR_WHOLEWORD
-    if searchParams.matchCase:
-        flags = flags | win32con.FR_MATCHCASE
-    if searchParams.sel == (-1, -1):
-        sel = control.GetSel()
-        # If the position is the same as we found last time,
-        # then we assume it is a "FindNext"
-        if sel == lastSearch.sel:
-            sel = sel[0] + 1, sel[0] + 1
-    else:
-        sel = searchParams.sel
-
-    if sel[0] == sel[1]:
-        sel = sel[0], control.GetTextLength()
-
-    rc = FOUND_NOTHING
-    # (Old edit control will fail here!)
-    posFind, foundSel = control.FindText(flags, sel, searchParams.findText)
-    lastSearch = SearchParams(searchParams)
-    if posFind >= 0:
-        rc = FOUND_NORMAL
-        lineno = control.LineFromChar(posFind)
-        control.SCIEnsureVisible(lineno)
-        control.SetSel(foundSel)
-        control.SetFocus()
-        win32ui.SetStatusText(win32ui.LoadString(afxres.AFX_IDS_IDLEMESSAGE))
-    if rc == FOUND_NOTHING and lastSearch.acrossFiles:
-        # Loop around all documents.  First find this document.
-        try:
-            try:
-                doc = control.GetDocument()
-            except AttributeError:
-                try:
-                    doc = control.GetParent().GetDocument()
-                except AttributeError:
-                    print("Cant find a document for the control!")
-                    doc = None
-            if doc is not None:
-                template = doc.GetDocTemplate()
-                alldocs = template.GetDocumentList()
-                mypos = lookpos = alldocs.index(doc)
-                while 1:
-                    lookpos = (lookpos + 1) % len(alldocs)
-                    if lookpos == mypos:
-                        break
-                    view = alldocs[lookpos].GetFirstView()
-                    posFind, foundSel = view.FindText(
-                        flags, (0, view.GetTextLength()), searchParams.findText
-                    )
-                    if posFind >= 0:
-                        nChars = foundSel[1] - foundSel[0]
-                        lineNo = view.LineFromChar(posFind)  # zero based.
-                        lineStart = view.LineIndex(lineNo)
-                        colNo = posFind - lineStart  # zero based.
-                        scriptutils.JumpToDocument(
-                            alldocs[lookpos].GetPathName(),
-                            lineNo + 1,
-                            colNo + 1,
-                            nChars,
-                        )
-                        rc = FOUND_NEXT_FILE
-                        break
-        except win32ui.error:
-            pass
-    if rc == FOUND_NOTHING:
-        # Loop around this control - attempt to find from the start of the control.
-        posFind, foundSel = control.FindText(
-            flags, (0, sel[0] - 1), searchParams.findText
-        )
-        if posFind >= 0:
-            control.SCIEnsureVisible(control.LineFromChar(foundSel[0]))
-            control.SetSel(foundSel)
-            control.SetFocus()
-            win32ui.SetStatusText("Not found! Searching from the top of the file.")
-            rc = FOUND_LOOPED_BACK
-        else:
-            lastSearch.sel = -1, -1
-            win32ui.SetStatusText("Can not find '%s'" % searchParams.findText)
-
-    if rc != FOUND_NOTHING:
-        lastSearch.sel = foundSel
-
-    if lastSearch.remember:
-        defaultSearch = lastSearch
-
-        # track search history
-        try:
-            ix = searchHistory.index(searchParams.findText)
-        except ValueError:
-            if len(searchHistory) > 50:
-                searchHistory[50:] = []
-        else:
-            del searchHistory[ix]
-        searchHistory.insert(0, searchParams.findText)
-
-    return rc
-
-
-def _ReplaceIt(control):
-    control = _GetControl(control)
-    statusText = "Can not find '%s'." % lastSearch.findText
-    rc = FOUND_NOTHING
-    if control is not None and lastSearch.sel != (-1, -1):
-        control.ReplaceSel(lastSearch.replaceText)
-        rc = FindNext()
-        if rc != FOUND_NOTHING:
-            statusText = win32ui.LoadString(afxres.AFX_IDS_IDLEMESSAGE)
-    win32ui.SetStatusText(statusText)
-    return rc
-
-
-class FindReplaceDialog(dialog.Dialog):
-    def __init__(self):
-        dialog.Dialog.__init__(self, self._GetDialogTemplate())
-        self.HookCommand(self.OnFindNext, 109)
-
-    def OnInitDialog(self):
-        self.editFindText = self.GetDlgItem(102)
-        self.butMatchWords = self.GetDlgItem(105)
-        self.butMatchCase = self.GetDlgItem(107)
-        self.butKeepDialogOpen = self.GetDlgItem(115)
-        self.butAcrossFiles = self.GetDlgItem(116)
-        self.butRemember = self.GetDlgItem(117)
-
-        self.editFindText.SetWindowText(defaultSearch.findText)
-        control = _GetControl()
-        # _GetControl only gets normal MDI windows; if the interactive
-        # window is docked and no document open, we get None.
-        if control:
-            # If we have a selection, default to that.
-            sel = control.GetSelText()
-            if len(sel) != 0:
-                self.editFindText.SetWindowText(sel)
-                if defaultSearch.remember:
-                    defaultSearch.findText = sel
-        for hist in searchHistory:
-            self.editFindText.AddString(hist)
-
-        if hasattr(self.editFindText, "SetEditSel"):
-            self.editFindText.SetEditSel(0, -1)
-        else:
-            self.editFindText.SetSel(0, -1)
-        self.butMatchWords.SetCheck(defaultSearch.matchWords)
-        self.butMatchCase.SetCheck(defaultSearch.matchCase)
-        self.butKeepDialogOpen.SetCheck(defaultSearch.keepDialogOpen)
-        self.butAcrossFiles.SetCheck(defaultSearch.acrossFiles)
-        self.butRemember.SetCheck(defaultSearch.remember)
-        return dialog.Dialog.OnInitDialog(self)
-
-    def OnDestroy(self, msg):
-        global curDialog
-        curDialog = None
-        return dialog.Dialog.OnDestroy(self, msg)
-
-    def DoFindNext(self):
-        params = SearchParams()
-        params.findText = self.editFindText.GetWindowText()
-        params.matchCase = self.butMatchCase.GetCheck()
-        params.matchWords = self.butMatchWords.GetCheck()
-        params.acrossFiles = self.butAcrossFiles.GetCheck()
-        params.remember = self.butRemember.GetCheck()
-        return _FindIt(None, params)
-
-    def OnFindNext(self, id, code):
-        if code != 0:  # BN_CLICKED
-            # 3d controls (python.exe + start_pythonwin.pyw) send
-            # other notification codes
-            return 1  #
-        if not self.editFindText.GetWindowText():
-            win32api.MessageBeep()
-            return 1
-        if self.DoFindNext() != FOUND_NOTHING:
-            if not self.butKeepDialogOpen.GetCheck():
-                self.DestroyWindow()
-
-
-class FindDialog(FindReplaceDialog):
-    def _GetDialogTemplate(self):
-        style = (
-            win32con.DS_MODALFRAME
-            | win32con.WS_POPUP
-            | win32con.WS_VISIBLE
-            | win32con.WS_CAPTION
-            | win32con.WS_SYSMENU
-            | win32con.DS_SETFONT
-        )
-        visible = win32con.WS_CHILD | win32con.WS_VISIBLE
-        dt = [
-            ["Find", (0, 2, 240, 75), style, None, (8, "MS Sans Serif")],
-            ["Static", "Fi&nd What:", 101, (5, 8, 40, 10), visible],
-            [
-                "ComboBox",
-                "",
-                102,
-                (50, 7, 120, 120),
-                visible
-                | win32con.WS_BORDER
-                | win32con.WS_TABSTOP
-                | win32con.WS_VSCROLL
-                | win32con.CBS_DROPDOWN
-                | win32con.CBS_AUTOHSCROLL,
-            ],
-            [
-                "Button",
-                "Match &whole word only",
-                105,
-                (5, 23, 100, 10),
-                visible | win32con.BS_AUTOCHECKBOX | win32con.WS_TABSTOP,
-            ],
-            [
-                "Button",
-                "Match &case",
-                107,
-                (5, 33, 100, 10),
-                visible | win32con.BS_AUTOCHECKBOX | win32con.WS_TABSTOP,
-            ],
-            [
-                "Button",
-                "Keep &dialog open",
-                115,
-                (5, 43, 100, 10),
-                visible | win32con.BS_AUTOCHECKBOX | win32con.WS_TABSTOP,
-            ],
-            [
-                "Button",
-                "Across &open files",
-                116,
-                (5, 52, 100, 10),
-                visible | win32con.BS_AUTOCHECKBOX | win32con.WS_TABSTOP,
-            ],
-            [
-                "Button",
-                "&Remember as default search",
-                117,
-                (5, 61, 150, 10),
-                visible | win32con.BS_AUTOCHECKBOX | win32con.WS_TABSTOP,
-            ],
-            [
-                "Button",
-                "&Find Next",
-                109,
-                (185, 5, 50, 14),
-                visible | win32con.BS_DEFPUSHBUTTON | win32con.WS_TABSTOP,
-            ],
-            [
-                "Button",
-                "Cancel",
-                win32con.IDCANCEL,
-                (185, 23, 50, 14),
-                visible | win32con.WS_TABSTOP,
-            ],
-        ]
-        return dt
-
-
-class ReplaceDialog(FindReplaceDialog):
-    def _GetDialogTemplate(self):
-        style = (
-            win32con.DS_MODALFRAME
-            | win32con.WS_POPUP
-            | win32con.WS_VISIBLE
-            | win32con.WS_CAPTION
-            | win32con.WS_SYSMENU
-            | win32con.DS_SETFONT
-        )
-        visible = win32con.WS_CHILD | win32con.WS_VISIBLE
-        dt = [
-            ["Replace", (0, 2, 240, 95), style, 0, (8, "MS Sans Serif")],
-            ["Static", "Fi&nd What:", 101, (5, 8, 40, 10), visible],
-            [
-                "ComboBox",
-                "",
-                102,
-                (60, 7, 110, 120),
-                visible
-                | win32con.WS_BORDER
-                | win32con.WS_TABSTOP
-                | win32con.WS_VSCROLL
-                | win32con.CBS_DROPDOWN
-                | win32con.CBS_AUTOHSCROLL,
-            ],
-            ["Static", "Re&place with:", 103, (5, 25, 50, 10), visible],
-            [
-                "ComboBox",
-                "",
-                104,
-                (60, 24, 110, 120),
-                visible
-                | win32con.WS_BORDER
-                | win32con.WS_TABSTOP
-                | win32con.WS_VSCROLL
-                | win32con.CBS_DROPDOWN
-                | win32con.CBS_AUTOHSCROLL,
-            ],
-            [
-                "Button",
-                "Match &whole word only",
-                105,
-                (5, 42, 100, 10),
-                visible | win32con.BS_AUTOCHECKBOX | win32con.WS_TABSTOP,
-            ],
-            [
-                "Button",
-                "Match &case",
-                107,
-                (5, 52, 100, 10),
-                visible | win32con.BS_AUTOCHECKBOX | win32con.WS_TABSTOP,
-            ],
-            [
-                "Button",
-                "Keep &dialog open",
-                115,
-                (5, 62, 100, 10),
-                visible | win32con.BS_AUTOCHECKBOX | win32con.WS_TABSTOP,
-            ],
-            [
-                "Button",
-                "Across &open files",
-                116,
-                (5, 72, 100, 10),
-                visible | win32con.BS_AUTOCHECKBOX | win32con.WS_TABSTOP,
-            ],
-            [
-                "Button",
-                "&Remember as default search",
-                117,
-                (5, 81, 150, 10),
-                visible | win32con.BS_AUTOCHECKBOX | win32con.WS_TABSTOP,
-            ],
-            [
-                "Button",
-                "&Find Next",
-                109,
-                (185, 5, 50, 14),
-                visible | win32con.BS_DEFPUSHBUTTON | win32con.WS_TABSTOP,
-            ],
-            [
-                "Button",
-                "&Replace",
-                110,
-                (185, 23, 50, 14),
-                visible | win32con.WS_TABSTOP,
-            ],
-            [
-                "Button",
-                "Replace &All",
-                111,
-                (185, 41, 50, 14),
-                visible | win32con.WS_TABSTOP,
-            ],
-            [
-                "Button",
-                "Cancel",
-                win32con.IDCANCEL,
-                (185, 59, 50, 14),
-                visible | win32con.WS_TABSTOP,
-            ],
-        ]
-        return dt
-
-    def OnInitDialog(self):
-        rc = FindReplaceDialog.OnInitDialog(self)
-        self.HookCommand(self.OnReplace, 110)
-        self.HookCommand(self.OnReplaceAll, 111)
-        self.HookMessage(self.OnActivate, win32con.WM_ACTIVATE)
-        self.editReplaceText = self.GetDlgItem(104)
-        self.editReplaceText.SetWindowText(lastSearch.replaceText)
-        if hasattr(self.editReplaceText, "SetEditSel"):
-            self.editReplaceText.SetEditSel(0, -1)
-        else:
-            self.editReplaceText.SetSel(0, -1)
-        self.butReplace = self.GetDlgItem(110)
-        self.butReplaceAll = self.GetDlgItem(111)
-        self.CheckButtonStates()
-        return rc  # 0 when focus set
-
-    def CheckButtonStates(self):
-        # We can do a "Replace" or "Replace All" if the current selection
-        # is the same as the search text.
-        ft = self.editFindText.GetWindowText()
-        control = _GetControl()
-        # 		bCanReplace = len(ft)>0 and control.GetSelText() == ft
-        bCanReplace = control is not None and lastSearch.sel == control.GetSel()
-        self.butReplace.EnableWindow(bCanReplace)
-
-    # 		self.butReplaceAll.EnableWindow(bCanReplace)
-
-    def OnActivate(self, msg):
-        wparam = msg[2]
-        fActive = win32api.LOWORD(wparam)
-        if fActive != win32con.WA_INACTIVE:
-            self.CheckButtonStates()
-
-    def OnFindNext(self, id, code):
-        if code != 0:
-            return 1
-        self.DoFindNext()
-        self.CheckButtonStates()
-
-    def OnReplace(self, id, code):
-        if code != 0:
-            return 1
-        lastSearch.replaceText = self.editReplaceText.GetWindowText()
-        _ReplaceIt(None)
-
-    def OnReplaceAll(self, id, code):
-        if code != 0:
-            return 1
-        control = _GetControl(None)
-        if control is not None:
-            control.SetSel(0)
-            num = 0
-            if self.DoFindNext() == FOUND_NORMAL:
-                num = 1
-                lastSearch.replaceText = self.editReplaceText.GetWindowText()
-                while _ReplaceIt(control) == FOUND_NORMAL:
-                    num = num + 1
-
-            win32ui.SetStatusText("Replaced %d occurrences" % num)
-            if num > 0 and not self.butKeepDialogOpen.GetCheck():
-                self.DestroyWindow()
-
-
-if __name__ == "__main__":
-    ShowFindDialog()
diff --git a/lib/pythonwin/pywin/scintilla/formatter.py b/lib/pythonwin/pywin/scintilla/formatter.py
deleted file mode 100644
index 56100ccf..00000000
--- a/lib/pythonwin/pywin/scintilla/formatter.py
+++ /dev/null
@@ -1,695 +0,0 @@
-# Does Python source formatting for Scintilla controls.
-import array
-import string
-
-import win32api
-import win32con
-import win32ui
-
-from . import scintillacon
-
-WM_KICKIDLE = 0x036A
-
-# Used to indicate that style should use default color
-from win32con import CLR_INVALID
-
-debugging = 0
-if debugging:
-    # Output must go to another process else the result of
-    # the printing itself will trigger again trigger a trace.
-
-    import win32trace
-    import win32traceutil
-
-    def trace(*args):
-        win32trace.write(" ".join(map(str, args)) + "\n")
-
-else:
-    trace = lambda *args: None
-
-
-class Style:
-    """Represents a single format"""
-
-    def __init__(self, name, format, background=CLR_INVALID):
-        self.name = name  # Name the format representes eg, "String", "Class"
-        # Default background for each style is only used when there are no
-        # saved settings (generally on first startup)
-        self.background = self.default_background = background
-        if type(format) == type(""):
-            self.aliased = format
-            self.format = None
-        else:
-            self.format = format
-            self.aliased = None
-        self.stylenum = None  # Not yet registered.
-
-    def IsBasedOnDefault(self):
-        return len(self.format) == 5
-
-    # If the currently extended font defintion matches the
-    # default format, restore the format to the "simple" format.
-    def NormalizeAgainstDefault(self, defaultFormat):
-        if self.IsBasedOnDefault():
-            return 0  # No more to do, and not changed.
-        bIsDefault = (
-            self.format[7] == defaultFormat[7] and self.format[2] == defaultFormat[2]
-        )
-        if bIsDefault:
-            self.ForceAgainstDefault()
-        return bIsDefault
-
-    def ForceAgainstDefault(self):
-        self.format = self.format[:5]
-
-    def GetCompleteFormat(self, defaultFormat):
-        # Get the complete style after applying any relevant defaults.
-        if len(self.format) == 5:  # It is a default one
-            fmt = self.format + defaultFormat[5:]
-        else:
-            fmt = self.format
-        flags = (
-            win32con.CFM_BOLD
-            | win32con.CFM_CHARSET
-            | win32con.CFM_COLOR
-            | win32con.CFM_FACE
-            | win32con.CFM_ITALIC
-            | win32con.CFM_SIZE
-        )
-        return (flags,) + fmt[1:]
-
-
-# The Formatter interface
-# used primarily when the actual formatting is done by Scintilla!
-class FormatterBase:
-    def __init__(self, scintilla):
-        self.scintilla = scintilla
-        self.baseFormatFixed = (-402653169, 0, 200, 0, 0, 0, 49, "Courier New")
-        self.baseFormatProp = (-402653169, 0, 200, 0, 0, 0, 49, "Arial")
-        self.bUseFixed = 1
-        self.styles = {}  # Indexed by name
-        self.styles_by_id = {}  # Indexed by allocated ID.
-        self.SetStyles()
-
-    def HookFormatter(self, parent=None):
-        raise NotImplementedError()
-
-    # Used by the IDLE extensions to quickly determine if a character is a string.
-    def GetStringStyle(self, pos):
-        try:
-            style = self.styles_by_id[self.scintilla.SCIGetStyleAt(pos)]
-        except KeyError:
-            # A style we dont know about - probably not even a .py file - can't be a string
-            return None
-        if style.name in self.string_style_names:
-            return style
-        return None
-
-    def RegisterStyle(self, style, stylenum):
-        assert stylenum is not None, "We must have a style number"
-        assert style.stylenum is None, "Style has already been registered"
-        assert stylenum not in self.styles, "We are reusing a style number!"
-        style.stylenum = stylenum
-        self.styles[style.name] = style
-        self.styles_by_id[stylenum] = style
-
-    def SetStyles(self):
-        raise NotImplementedError()
-
-    def GetSampleText(self):
-        return "Sample Text for the Format Dialog"
-
-    def GetDefaultFormat(self):
-        if self.bUseFixed:
-            return self.baseFormatFixed
-        return self.baseFormatProp
-
-    # Update the control with the new style format.
-    def _ReformatStyle(self, style):
-        ## Selection (background only for now)
-        ## Passing False for WPARAM to SCI_SETSELBACK is documented as resetting to scintilla default,
-        ## but does not work - selection background is not visible at all.
-        ## Default value in SPECIAL_STYLES taken from scintilla source.
-        if style.name == STYLE_SELECTION:
-            clr = style.background
-            self.scintilla.SendScintilla(scintillacon.SCI_SETSELBACK, True, clr)
-
-            ## Can't change font for selection, but could set color
-            ## However, the font color dropbox has no option for default, and thus would
-            ## always override syntax coloring
-            ## clr = style.format[4]
-            ## self.scintilla.SendScintilla(scintillacon.SCI_SETSELFORE, clr != CLR_INVALID, clr)
-            return
-
-        assert style.stylenum is not None, "Unregistered style."
-        # print "Reformat style", style.name, style.stylenum
-        scintilla = self.scintilla
-        stylenum = style.stylenum
-        # Now we have the style number, indirect for the actual style.
-        if style.aliased is not None:
-            style = self.styles[style.aliased]
-        f = style.format
-        if style.IsBasedOnDefault():
-            baseFormat = self.GetDefaultFormat()
-        else:
-            baseFormat = f
-        scintilla.SCIStyleSetFore(stylenum, f[4])
-        scintilla.SCIStyleSetFont(stylenum, baseFormat[7], baseFormat[5])
-        if f[1] & 1:
-            scintilla.SCIStyleSetBold(stylenum, 1)
-        else:
-            scintilla.SCIStyleSetBold(stylenum, 0)
-        if f[1] & 2:
-            scintilla.SCIStyleSetItalic(stylenum, 1)
-        else:
-            scintilla.SCIStyleSetItalic(stylenum, 0)
-        scintilla.SCIStyleSetSize(stylenum, int(baseFormat[2] / 20))
-        scintilla.SCIStyleSetEOLFilled(stylenum, 1)  # Only needed for unclosed strings.
-
-        ## Default style background to whitespace background if set,
-        ##	otherwise use system window color
-        bg = style.background
-        if bg == CLR_INVALID:
-            bg = self.styles[STYLE_DEFAULT].background
-        if bg == CLR_INVALID:
-            bg = win32api.GetSysColor(win32con.COLOR_WINDOW)
-        scintilla.SCIStyleSetBack(stylenum, bg)
-
-    def GetStyleByNum(self, stylenum):
-        return self.styles_by_id[stylenum]
-
-    def ApplyFormattingStyles(self, bReload=1):
-        if bReload:
-            self.LoadPreferences()
-        baseFormat = self.GetDefaultFormat()
-        defaultStyle = Style("default", baseFormat)
-        defaultStyle.stylenum = scintillacon.STYLE_DEFAULT
-        self._ReformatStyle(defaultStyle)
-        for style in list(self.styles.values()):
-            if style.aliased is None:
-                style.NormalizeAgainstDefault(baseFormat)
-            self._ReformatStyle(style)
-        self.scintilla.InvalidateRect()
-
-    # Some functions for loading and saving preferences.  By default
-    # an INI file (well, MFC maps this to the registry) is used.
-    def LoadPreferences(self):
-        self.baseFormatFixed = eval(
-            self.LoadPreference("Base Format Fixed", str(self.baseFormatFixed))
-        )
-        self.baseFormatProp = eval(
-            self.LoadPreference("Base Format Proportional", str(self.baseFormatProp))
-        )
-        self.bUseFixed = int(self.LoadPreference("Use Fixed", 1))
-
-        for style in list(self.styles.values()):
-            new = self.LoadPreference(style.name, str(style.format))
-            try:
-                style.format = eval(new)
-            except:
-                print("Error loading style data for", style.name)
-            # Use "vanilla" background hardcoded in PYTHON_STYLES if no settings in registry
-            style.background = int(
-                self.LoadPreference(
-                    style.name + " background", style.default_background
-                )
-            )
-
-    def LoadPreference(self, name, default):
-        return win32ui.GetProfileVal("Format", name, default)
-
-    def SavePreferences(self):
-        self.SavePreference("Base Format Fixed", str(self.baseFormatFixed))
-        self.SavePreference("Base Format Proportional", str(self.baseFormatProp))
-        self.SavePreference("Use Fixed", self.bUseFixed)
-        for style in list(self.styles.values()):
-            if style.aliased is None:
-                self.SavePreference(style.name, str(style.format))
-                bg_name = style.name + " background"
-                self.SavePreference(bg_name, style.background)
-
-    def SavePreference(self, name, value):
-        win32ui.WriteProfileVal("Format", name, value)
-
-
-# An abstract formatter
-# For all formatters we actually implement here.
-# (as opposed to those formatters built in to Scintilla)
-class Formatter(FormatterBase):
-    def __init__(self, scintilla):
-        self.bCompleteWhileIdle = 0
-        self.bHaveIdleHandler = 0  # Dont currently have an idle handle
-        self.nextstylenum = 0
-        FormatterBase.__init__(self, scintilla)
-
-    def HookFormatter(self, parent=None):
-        if parent is None:
-            parent = self.scintilla.GetParent()  # was GetParentFrame()!?
-        parent.HookNotify(self.OnStyleNeeded, scintillacon.SCN_STYLENEEDED)
-
-    def OnStyleNeeded(self, std, extra):
-        notify = self.scintilla.SCIUnpackNotifyMessage(extra)
-        endStyledChar = self.scintilla.SendScintilla(scintillacon.SCI_GETENDSTYLED)
-        lineEndStyled = self.scintilla.LineFromChar(endStyledChar)
-        endStyled = self.scintilla.LineIndex(lineEndStyled)
-        # print "enPosPaint %d endStyledChar %d lineEndStyled %d endStyled %d" % (endPosPaint, endStyledChar, lineEndStyled, endStyled)
-        self.Colorize(endStyled, notify.position)
-
-    def ColorSeg(self, start, end, styleName):
-        end = end + 1
-        # 		assert end-start>=0, "Can't have negative styling"
-        stylenum = self.styles[styleName].stylenum
-        while start < end:
-            self.style_buffer[start] = stylenum
-            start = start + 1
-        # self.scintilla.SCISetStyling(end - start + 1, stylenum)
-
-    def RegisterStyle(self, style, stylenum=None):
-        if stylenum is None:
-            stylenum = self.nextstylenum
-            self.nextstylenum = self.nextstylenum + 1
-        FormatterBase.RegisterStyle(self, style, stylenum)
-
-    def ColorizeString(self, str, charStart, styleStart):
-        raise RuntimeError("You must override this method")
-
-    def Colorize(self, start=0, end=-1):
-        scintilla = self.scintilla
-        # scintilla's formatting is all done in terms of utf, so
-        # we work with utf8 bytes instead of unicode.  This magically
-        # works as any extended chars found in the utf8 don't change
-        # the semantics.
-        stringVal = scintilla.GetTextRange(start, end, decode=False)
-        if start > 0:
-            stylenum = scintilla.SCIGetStyleAt(start - 1)
-            styleStart = self.GetStyleByNum(stylenum).name
-        else:
-            styleStart = None
-        # 		trace("Coloring", start, end, end-start, len(stringVal), styleStart, self.scintilla.SCIGetCharAt(start))
-        scintilla.SCIStartStyling(start, 31)
-        self.style_buffer = array.array("b", (0,) * len(stringVal))
-        self.ColorizeString(stringVal, styleStart)
-        scintilla.SCISetStylingEx(self.style_buffer)
-        self.style_buffer = None
-        # 		trace("After styling, end styled is", self.scintilla.SCIGetEndStyled())
-        if (
-            self.bCompleteWhileIdle
-            and not self.bHaveIdleHandler
-            and end != -1
-            and end < scintilla.GetTextLength()
-        ):
-            self.bHaveIdleHandler = 1
-            win32ui.GetApp().AddIdleHandler(self.DoMoreColoring)
-            # Kicking idle makes the app seem slower when initially repainting!
-
-    # 			win32ui.GetMainFrame().PostMessage(WM_KICKIDLE, 0, 0)
-
-    def DoMoreColoring(self, handler, count):
-        try:
-            scintilla = self.scintilla
-            endStyled = scintilla.SCIGetEndStyled()
-            lineStartStyled = scintilla.LineFromChar(endStyled)
-            start = scintilla.LineIndex(lineStartStyled)
-            end = scintilla.LineIndex(lineStartStyled + 1)
-            textlen = scintilla.GetTextLength()
-            if end < 0:
-                end = textlen
-
-            finished = end >= textlen
-            self.Colorize(start, end)
-        except (win32ui.error, AttributeError):
-            # Window may have closed before we finished - no big deal!
-            finished = 1
-
-        if finished:
-            self.bHaveIdleHandler = 0
-            win32ui.GetApp().DeleteIdleHandler(handler)
-        return not finished
-
-
-# A Formatter that knows how to format Python source
-from keyword import iskeyword, kwlist
-
-wordstarts = "_0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz"
-wordchars = "._0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz"
-operators = "%^&*()-+=|{}[]:;<>,/?!.~"
-
-STYLE_DEFAULT = "Whitespace"
-STYLE_COMMENT = "Comment"
-STYLE_COMMENT_BLOCK = "Comment Blocks"
-STYLE_NUMBER = "Number"
-STYLE_STRING = "String"
-STYLE_SQSTRING = "SQ String"
-STYLE_TQSSTRING = "TQS String"
-STYLE_TQDSTRING = "TQD String"
-STYLE_KEYWORD = "Keyword"
-STYLE_CLASS = "Class"
-STYLE_METHOD = "Method"
-STYLE_OPERATOR = "Operator"
-STYLE_IDENTIFIER = "Identifier"
-STYLE_BRACE = "Brace/Paren - matching"
-STYLE_BRACEBAD = "Brace/Paren - unmatched"
-STYLE_STRINGEOL = "String with no terminator"
-STYLE_LINENUMBER = "Line numbers"
-STYLE_INDENTGUIDE = "Indent guide"
-STYLE_SELECTION = "Selection"
-
-STRING_STYLES = [
-    STYLE_STRING,
-    STYLE_SQSTRING,
-    STYLE_TQSSTRING,
-    STYLE_TQDSTRING,
-    STYLE_STRINGEOL,
-]
-
-# These styles can have any ID - they are not special to scintilla itself.
-# However, if we use the built-in lexer, then we must use its style numbers
-# so in that case, they _are_ special.
-# (name, format, background, scintilla id)
-PYTHON_STYLES = [
-    (STYLE_DEFAULT, (0, 0, 200, 0, 0x808080), CLR_INVALID, scintillacon.SCE_P_DEFAULT),
-    (
-        STYLE_COMMENT,
-        (0, 2, 200, 0, 0x008000),
-        CLR_INVALID,
-        scintillacon.SCE_P_COMMENTLINE,
-    ),
-    (
-        STYLE_COMMENT_BLOCK,
-        (0, 2, 200, 0, 0x808080),
-        CLR_INVALID,
-        scintillacon.SCE_P_COMMENTBLOCK,
-    ),
-    (STYLE_NUMBER, (0, 0, 200, 0, 0x808000), CLR_INVALID, scintillacon.SCE_P_NUMBER),
-    (STYLE_STRING, (0, 0, 200, 0, 0x008080), CLR_INVALID, scintillacon.SCE_P_STRING),
-    (STYLE_SQSTRING, STYLE_STRING, CLR_INVALID, scintillacon.SCE_P_CHARACTER),
-    (STYLE_TQSSTRING, STYLE_STRING, CLR_INVALID, scintillacon.SCE_P_TRIPLE),
-    (STYLE_TQDSTRING, STYLE_STRING, CLR_INVALID, scintillacon.SCE_P_TRIPLEDOUBLE),
-    (STYLE_STRINGEOL, (0, 0, 200, 0, 0x000000), 0x008080, scintillacon.SCE_P_STRINGEOL),
-    (STYLE_KEYWORD, (0, 1, 200, 0, 0x800000), CLR_INVALID, scintillacon.SCE_P_WORD),
-    (STYLE_CLASS, (0, 1, 200, 0, 0xFF0000), CLR_INVALID, scintillacon.SCE_P_CLASSNAME),
-    (STYLE_METHOD, (0, 1, 200, 0, 0x808000), CLR_INVALID, scintillacon.SCE_P_DEFNAME),
-    (
-        STYLE_OPERATOR,
-        (0, 0, 200, 0, 0x000000),
-        CLR_INVALID,
-        scintillacon.SCE_P_OPERATOR,
-    ),
-    (
-        STYLE_IDENTIFIER,
-        (0, 0, 200, 0, 0x000000),
-        CLR_INVALID,
-        scintillacon.SCE_P_IDENTIFIER,
-    ),
-]
-
-# These styles _always_ have this specific style number, regardless of
-# internal or external formatter.
-SPECIAL_STYLES = [
-    (STYLE_BRACE, (0, 0, 200, 0, 0x000000), 0xFFFF80, scintillacon.STYLE_BRACELIGHT),
-    (STYLE_BRACEBAD, (0, 0, 200, 0, 0x000000), 0x8EA5F2, scintillacon.STYLE_BRACEBAD),
-    (
-        STYLE_LINENUMBER,
-        (0, 0, 200, 0, 0x000000),
-        win32api.GetSysColor(win32con.COLOR_3DFACE),
-        scintillacon.STYLE_LINENUMBER,
-    ),
-    (
-        STYLE_INDENTGUIDE,
-        (0, 0, 200, 0, 0x000000),
-        CLR_INVALID,
-        scintillacon.STYLE_INDENTGUIDE,
-    ),
-    ## Not actually a style; requires special handling to send appropriate messages to scintilla
-    (
-        STYLE_SELECTION,
-        (0, 0, 200, 0, CLR_INVALID),
-        win32api.RGB(0xC0, 0xC0, 0xC0),
-        999999,
-    ),
-]
-
-PythonSampleCode = """\
-# Some Python
-class Sample(Super):
-  def Fn(self):
-\tself.v = 1024
-dest = 'dest.html'
-x = func(a + 1)|)
-s = "I forget...
-## A large
-## comment block"""
-
-
-class PythonSourceFormatter(Formatter):
-    string_style_names = STRING_STYLES
-
-    def GetSampleText(self):
-        return PythonSampleCode
-
-    def LoadStyles(self):
-        pass
-
-    def SetStyles(self):
-        for name, format, bg, ignore in PYTHON_STYLES:
-            self.RegisterStyle(Style(name, format, bg))
-        for name, format, bg, sc_id in SPECIAL_STYLES:
-            self.RegisterStyle(Style(name, format, bg), sc_id)
-
-    def ClassifyWord(self, cdoc, start, end, prevWord):
-        word = cdoc[start : end + 1].decode("latin-1")
-        attr = STYLE_IDENTIFIER
-        if prevWord == "class":
-            attr = STYLE_CLASS
-        elif prevWord == "def":
-            attr = STYLE_METHOD
-        elif word[0] in string.digits:
-            attr = STYLE_NUMBER
-        elif iskeyword(word):
-            attr = STYLE_KEYWORD
-        self.ColorSeg(start, end, attr)
-        return word
-
-    def ColorizeString(self, str, styleStart):
-        if styleStart is None:
-            styleStart = STYLE_DEFAULT
-        return self.ColorizePythonCode(str, 0, styleStart)
-
-    def ColorizePythonCode(self, cdoc, charStart, styleStart):
-        # Straight translation of C++, should do better
-        lengthDoc = len(cdoc)
-        if lengthDoc <= charStart:
-            return
-        prevWord = ""
-        state = styleStart
-        chPrev = chPrev2 = chPrev3 = " "
-        chNext2 = chNext = cdoc[charStart : charStart + 1].decode("latin-1")
-        startSeg = i = charStart
-        while i < lengthDoc:
-            ch = chNext
-            chNext = " "
-            if i + 1 < lengthDoc:
-                chNext = cdoc[i + 1 : i + 2].decode("latin-1")
-            chNext2 = " "
-            if i + 2 < lengthDoc:
-                chNext2 = cdoc[i + 2 : i + 3].decode("latin-1")
-            if state == STYLE_DEFAULT:
-                if ch in wordstarts:
-                    self.ColorSeg(startSeg, i - 1, STYLE_DEFAULT)
-                    state = STYLE_KEYWORD
-                    startSeg = i
-                elif ch == "#":
-                    self.ColorSeg(startSeg, i - 1, STYLE_DEFAULT)
-                    if chNext == "#":
-                        state = STYLE_COMMENT_BLOCK
-                    else:
-                        state = STYLE_COMMENT
-                    startSeg = i
-                elif ch == '"':
-                    self.ColorSeg(startSeg, i - 1, STYLE_DEFAULT)
-                    startSeg = i
-                    state = STYLE_COMMENT
-                    if chNext == '"' and chNext2 == '"':
-                        i = i + 2
-                        state = STYLE_TQDSTRING
-                        ch = " "
-                        chPrev = " "
-                        chNext = " "
-                        if i + 1 < lengthDoc:
-                            chNext = cdoc[i + 1]
-                    else:
-                        state = STYLE_STRING
-                elif ch == "'":
-                    self.ColorSeg(startSeg, i - 1, STYLE_DEFAULT)
-                    startSeg = i
-                    state = STYLE_COMMENT
-                    if chNext == "'" and chNext2 == "'":
-                        i = i + 2
-                        state = STYLE_TQSSTRING
-                        ch = " "
-                        chPrev = " "
-                        chNext = " "
-                        if i + 1 < lengthDoc:
-                            chNext = cdoc[i + 1]
-                    else:
-                        state = STYLE_SQSTRING
-                elif ch in operators:
-                    self.ColorSeg(startSeg, i - 1, STYLE_DEFAULT)
-                    self.ColorSeg(i, i, STYLE_OPERATOR)
-                    startSeg = i + 1
-            elif state == STYLE_KEYWORD:
-                if ch not in wordchars:
-                    prevWord = self.ClassifyWord(cdoc, startSeg, i - 1, prevWord)
-                    state = STYLE_DEFAULT
-                    startSeg = i
-                    if ch == "#":
-                        if chNext == "#":
-                            state = STYLE_COMMENT_BLOCK
-                        else:
-                            state = STYLE_COMMENT
-                    elif ch == '"':
-                        if chNext == '"' and chNext2 == '"':
-                            i = i + 2
-                            state = STYLE_TQDSTRING
-                            ch = " "
-                            chPrev = " "
-                            chNext = " "
-                            if i + 1 < lengthDoc:
-                                chNext = cdoc[i + 1]
-                        else:
-                            state = STYLE_STRING
-                    elif ch == "'":
-                        if chNext == "'" and chNext2 == "'":
-                            i = i + 2
-                            state = STYLE_TQSSTRING
-                            ch = " "
-                            chPrev = " "
-                            chNext = " "
-                            if i + 1 < lengthDoc:
-                                chNext = cdoc[i + 1]
-                        else:
-                            state = STYLE_SQSTRING
-                    elif ch in operators:
-                        self.ColorSeg(startSeg, i, STYLE_OPERATOR)
-                        startSeg = i + 1
-            elif state == STYLE_COMMENT or state == STYLE_COMMENT_BLOCK:
-                if ch == "\r" or ch == "\n":
-                    self.ColorSeg(startSeg, i - 1, state)
-                    state = STYLE_DEFAULT
-                    startSeg = i
-            elif state == STYLE_STRING:
-                if ch == "\\":
-                    if chNext == '"' or chNext == "'" or chNext == "\\":
-                        i = i + 1
-                        ch = chNext
-                        chNext = " "
-                        if i + 1 < lengthDoc:
-                            chNext = cdoc[i + 1]
-                elif ch == '"':
-                    self.ColorSeg(startSeg, i, STYLE_STRING)
-                    state = STYLE_DEFAULT
-                    startSeg = i + 1
-            elif state == STYLE_SQSTRING:
-                if ch == "\\":
-                    if chNext == '"' or chNext == "'" or chNext == "\\":
-                        i = i + 1
-                        ch = chNext
-                        chNext = " "
-                        if i + 1 < lengthDoc:
-                            chNext = cdoc[i + 1]
-                elif ch == "'":
-                    self.ColorSeg(startSeg, i, STYLE_SQSTRING)
-                    state = STYLE_DEFAULT
-                    startSeg = i + 1
-            elif state == STYLE_TQSSTRING:
-                if ch == "'" and chPrev == "'" and chPrev2 == "'" and chPrev3 != "\\":
-                    self.ColorSeg(startSeg, i, STYLE_TQSSTRING)
-                    state = STYLE_DEFAULT
-                    startSeg = i + 1
-            elif (
-                state == STYLE_TQDSTRING
-                and ch == '"'
-                and chPrev == '"'
-                and chPrev2 == '"'
-                and chPrev3 != "\\"
-            ):
-                self.ColorSeg(startSeg, i, STYLE_TQDSTRING)
-                state = STYLE_DEFAULT
-                startSeg = i + 1
-            chPrev3 = chPrev2
-            chPrev2 = chPrev
-            chPrev = ch
-            i = i + 1
-        if startSeg < lengthDoc:
-            if state == STYLE_KEYWORD:
-                self.ClassifyWord(cdoc, startSeg, lengthDoc - 1, prevWord)
-            else:
-                self.ColorSeg(startSeg, lengthDoc - 1, state)
-
-
-# These taken from the SciTE properties file.
-source_formatter_extensions = [
-    (".py .pys .pyw".split(), scintillacon.SCLEX_PYTHON),
-    (".html .htm .asp .shtml".split(), scintillacon.SCLEX_HTML),
-    (
-        "c .cc .cpp .cxx .h .hh .hpp .hxx .idl .odl .php3 .phtml .inc .js".split(),
-        scintillacon.SCLEX_CPP,
-    ),
-    (".vbs .frm .ctl .cls".split(), scintillacon.SCLEX_VB),
-    (".pl .pm .cgi .pod".split(), scintillacon.SCLEX_PERL),
-    (".sql .spec .body .sps .spb .sf .sp".split(), scintillacon.SCLEX_SQL),
-    (".tex .sty".split(), scintillacon.SCLEX_LATEX),
-    (".xml .xul".split(), scintillacon.SCLEX_XML),
-    (".err".split(), scintillacon.SCLEX_ERRORLIST),
-    (".mak".split(), scintillacon.SCLEX_MAKEFILE),
-    (".bat .cmd".split(), scintillacon.SCLEX_BATCH),
-]
-
-
-class BuiltinSourceFormatter(FormatterBase):
-    # A class that represents a formatter built-in to Scintilla
-    def __init__(self, scintilla, ext):
-        self.ext = ext
-        FormatterBase.__init__(self, scintilla)
-
-    def Colorize(self, start=0, end=-1):
-        self.scintilla.SendScintilla(scintillacon.SCI_COLOURISE, start, end)
-
-    def RegisterStyle(self, style, stylenum=None):
-        assert style.stylenum is None, "Style has already been registered"
-        if stylenum is None:
-            stylenum = self.nextstylenum
-            self.nextstylenum = self.nextstylenum + 1
-        assert self.styles.get(stylenum) is None, "We are reusing a style number!"
-        style.stylenum = stylenum
-        self.styles[style.name] = style
-        self.styles_by_id[stylenum] = style
-
-    def HookFormatter(self, parent=None):
-        sc = self.scintilla
-        for exts, formatter in source_formatter_extensions:
-            if self.ext in exts:
-                formatter_use = formatter
-                break
-        else:
-            formatter_use = scintillacon.SCLEX_PYTHON
-        sc.SendScintilla(scintillacon.SCI_SETLEXER, formatter_use)
-        keywords = " ".join(kwlist)
-        sc.SCISetKeywords(keywords)
-
-
-class BuiltinPythonSourceFormatter(BuiltinSourceFormatter):
-    sci_lexer_name = scintillacon.SCLEX_PYTHON
-    string_style_names = STRING_STYLES
-
-    def __init__(self, sc, ext=".py"):
-        BuiltinSourceFormatter.__init__(self, sc, ext)
-
-    def SetStyles(self):
-        for name, format, bg, sc_id in PYTHON_STYLES:
-            self.RegisterStyle(Style(name, format, bg), sc_id)
-        for name, format, bg, sc_id in SPECIAL_STYLES:
-            self.RegisterStyle(Style(name, format, bg), sc_id)
-
-    def GetSampleText(self):
-        return PythonSampleCode
diff --git a/lib/pythonwin/pywin/scintilla/keycodes.py b/lib/pythonwin/pywin/scintilla/keycodes.py
deleted file mode 100644
index badcef3e..00000000
--- a/lib/pythonwin/pywin/scintilla/keycodes.py
+++ /dev/null
@@ -1,190 +0,0 @@
-import win32api
-import win32con
-import win32ui
-
-MAPVK_VK_TO_CHAR = 2
-
-key_name_to_vk = {}
-key_code_to_name = {}
-
-_better_names = {
-    "escape": "esc",
-    "return": "enter",
-    "back": "pgup",
-    "next": "pgdn",
-}
-
-
-def _fillvkmap():
-    # Pull the VK_names from win32con
-    names = [entry for entry in win32con.__dict__ if entry.startswith("VK_")]
-    for name in names:
-        code = getattr(win32con, name)
-        n = name[3:].lower()
-        key_name_to_vk[n] = code
-        if n in _better_names:
-            n = _better_names[n]
-            key_name_to_vk[n] = code
-        key_code_to_name[code] = n
-
-
-_fillvkmap()
-
-
-def get_vk(chardesc):
-    if len(chardesc) == 1:
-        # it is a character.
-        info = win32api.VkKeyScan(chardesc)
-        if info == -1:
-            # Note: returning None, None causes an error when keyboard layout is non-English, see the report below
-            # https://stackoverflow.com/questions/45138084/pythonwin-occasionally-gives-an-error-on-opening
-            return 0, 0
-        vk = win32api.LOBYTE(info)
-        state = win32api.HIBYTE(info)
-        modifiers = 0
-        if state & 0x1:
-            modifiers |= win32con.SHIFT_PRESSED
-        if state & 0x2:
-            modifiers |= win32con.LEFT_CTRL_PRESSED | win32con.RIGHT_CTRL_PRESSED
-        if state & 0x4:
-            modifiers |= win32con.LEFT_ALT_PRESSED | win32con.RIGHT_ALT_PRESSED
-        return vk, modifiers
-    # must be a 'key name'
-    return key_name_to_vk.get(chardesc.lower()), 0
-
-
-modifiers = {
-    "alt": win32con.LEFT_ALT_PRESSED | win32con.RIGHT_ALT_PRESSED,
-    "lalt": win32con.LEFT_ALT_PRESSED,
-    "ralt": win32con.RIGHT_ALT_PRESSED,
-    "ctrl": win32con.LEFT_CTRL_PRESSED | win32con.RIGHT_CTRL_PRESSED,
-    "ctl": win32con.LEFT_CTRL_PRESSED | win32con.RIGHT_CTRL_PRESSED,
-    "control": win32con.LEFT_CTRL_PRESSED | win32con.RIGHT_CTRL_PRESSED,
-    "lctrl": win32con.LEFT_CTRL_PRESSED,
-    "lctl": win32con.LEFT_CTRL_PRESSED,
-    "rctrl": win32con.RIGHT_CTRL_PRESSED,
-    "rctl": win32con.RIGHT_CTRL_PRESSED,
-    "shift": win32con.SHIFT_PRESSED,
-    "key": 0,  # ignore key tag.
-}
-
-
-def parse_key_name(name):
-    name = name + "-"  # Add a sentinal
-    start = pos = 0
-    max = len(name)
-    toks = []
-    while pos < max:
-        if name[pos] in "+-":
-            tok = name[start:pos]
-            # use the ascii lower() version of tok, so ascii chars require
-            # an explicit shift modifier - ie 'Ctrl+G' should be treated as
-            # 'ctrl+g' - 'ctrl+shift+g' would be needed if desired.
-            # This is mainly to avoid changing all the old keystroke defs
-            toks.append(tok.lower())
-            pos += 1  # skip the sep
-            start = pos
-        pos += 1
-    flags = 0
-    # do the modifiers
-    for tok in toks[:-1]:
-        mod = modifiers.get(tok.lower())
-        if mod is not None:
-            flags |= mod
-    # the key name
-    vk, this_flags = get_vk(toks[-1])
-    return vk, flags | this_flags
-
-
-_checks = [
-    [  # Shift
-        ("Shift", win32con.SHIFT_PRESSED),
-    ],
-    [  # Ctrl key
-        ("Ctrl", win32con.LEFT_CTRL_PRESSED | win32con.RIGHT_CTRL_PRESSED),
-        ("LCtrl", win32con.LEFT_CTRL_PRESSED),
-        ("RCtrl", win32con.RIGHT_CTRL_PRESSED),
-    ],
-    [  # Alt key
-        ("Alt", win32con.LEFT_ALT_PRESSED | win32con.RIGHT_ALT_PRESSED),
-        ("LAlt", win32con.LEFT_ALT_PRESSED),
-        ("RAlt", win32con.RIGHT_ALT_PRESSED),
-    ],
-]
-
-
-def make_key_name(vk, flags):
-    # Check alt keys.
-    flags_done = 0
-    parts = []
-    for moddata in _checks:
-        for name, checkflag in moddata:
-            if flags & checkflag:
-                parts.append(name)
-                flags_done = flags_done & checkflag
-                break
-    if flags_done & flags:
-        parts.append(hex(flags & ~flags_done))
-    # Now the key name.
-    if vk is None:
-        parts.append("<Unknown scan code>")
-    else:
-        try:
-            parts.append(key_code_to_name[vk])
-        except KeyError:
-            # Not in our virtual key map - ask Windows what character this
-            # key corresponds to.
-            scancode = win32api.MapVirtualKey(vk, MAPVK_VK_TO_CHAR)
-            parts.append(chr(scancode))
-    sep = "+"
-    if sep in parts:
-        sep = "-"
-    return sep.join([p.capitalize() for p in parts])
-
-
-def _psc(char):
-    sc, mods = get_vk(char)
-    print("Char %s -> %d -> %s" % (repr(char), sc, key_code_to_name.get(sc)))
-
-
-def test1():
-    for ch in """aA0/?[{}];:'"`~_-+=\\|,<.>/?""":
-        _psc(ch)
-    for code in ["Home", "End", "Left", "Right", "Up", "Down", "Menu", "Next"]:
-        _psc(code)
-
-
-def _pkn(n):
-    vk, flags = parse_key_name(n)
-    print("%s -> %s,%s -> %s" % (n, vk, flags, make_key_name(vk, flags)))
-
-
-def test2():
-    _pkn("ctrl+alt-shift+x")
-    _pkn("ctrl-home")
-    _pkn("Shift-+")
-    _pkn("Shift--")
-    _pkn("Shift+-")
-    _pkn("Shift++")
-    _pkn("LShift-+")
-    _pkn("ctl+home")
-    _pkn("ctl+enter")
-    _pkn("alt+return")
-    _pkn("Alt+/")
-    _pkn("Alt+BadKeyName")
-    _pkn("A")  # an ascii char - should be seen as 'a'
-    _pkn("a")
-    _pkn("Shift-A")
-    _pkn("Shift-a")
-    _pkn("a")
-    _pkn("(")
-    _pkn("Ctrl+(")
-    _pkn("Ctrl+Shift-8")
-    _pkn("Ctrl+*")
-    _pkn("{")
-    _pkn("!")
-    _pkn(".")
-
-
-if __name__ == "__main__":
-    test2()
diff --git a/lib/pythonwin/pywin/scintilla/scintillacon.py b/lib/pythonwin/pywin/scintilla/scintillacon.py
deleted file mode 100644
index e7657dc7..00000000
--- a/lib/pythonwin/pywin/scintilla/scintillacon.py
+++ /dev/null
@@ -1,2001 +0,0 @@
-# Generated by h2py from Include\scintilla.h
-
-
-# Included from BaseTsd.h
-def HandleToUlong(h):
-    return HandleToULong(h)
-
-
-def UlongToHandle(ul):
-    return ULongToHandle(ul)
-
-
-def UlongToPtr(ul):
-    return ULongToPtr(ul)
-
-
-def UintToPtr(ui):
-    return UIntToPtr(ui)
-
-
-INVALID_POSITION = -1
-SCI_START = 2000
-SCI_OPTIONAL_START = 3000
-SCI_LEXER_START = 4000
-SCI_ADDTEXT = 2001
-SCI_ADDSTYLEDTEXT = 2002
-SCI_INSERTTEXT = 2003
-SCI_CLEARALL = 2004
-SCI_CLEARDOCUMENTSTYLE = 2005
-SCI_GETLENGTH = 2006
-SCI_GETCHARAT = 2007
-SCI_GETCURRENTPOS = 2008
-SCI_GETANCHOR = 2009
-SCI_GETSTYLEAT = 2010
-SCI_REDO = 2011
-SCI_SETUNDOCOLLECTION = 2012
-SCI_SELECTALL = 2013
-SCI_SETSAVEPOINT = 2014
-SCI_GETSTYLEDTEXT = 2015
-SCI_CANREDO = 2016
-SCI_MARKERLINEFROMHANDLE = 2017
-SCI_MARKERDELETEHANDLE = 2018
-SCI_GETUNDOCOLLECTION = 2019
-SCWS_INVISIBLE = 0
-SCWS_VISIBLEALWAYS = 1
-SCWS_VISIBLEAFTERINDENT = 2
-SCI_GETVIEWWS = 2020
-SCI_SETVIEWWS = 2021
-SCI_POSITIONFROMPOINT = 2022
-SCI_POSITIONFROMPOINTCLOSE = 2023
-SCI_GOTOLINE = 2024
-SCI_GOTOPOS = 2025
-SCI_SETANCHOR = 2026
-SCI_GETCURLINE = 2027
-SCI_GETENDSTYLED = 2028
-SC_EOL_CRLF = 0
-SC_EOL_CR = 1
-SC_EOL_LF = 2
-SCI_CONVERTEOLS = 2029
-SCI_GETEOLMODE = 2030
-SCI_SETEOLMODE = 2031
-SCI_STARTSTYLING = 2032
-SCI_SETSTYLING = 2033
-SCI_GETBUFFEREDDRAW = 2034
-SCI_SETBUFFEREDDRAW = 2035
-SCI_SETTABWIDTH = 2036
-SCI_GETTABWIDTH = 2121
-SC_CP_UTF8 = 65001
-SC_CP_DBCS = 1
-SCI_SETCODEPAGE = 2037
-SCI_SETUSEPALETTE = 2039
-MARKER_MAX = 31
-SC_MARK_CIRCLE = 0
-SC_MARK_ROUNDRECT = 1
-SC_MARK_ARROW = 2
-SC_MARK_SMALLRECT = 3
-SC_MARK_SHORTARROW = 4
-SC_MARK_EMPTY = 5
-SC_MARK_ARROWDOWN = 6
-SC_MARK_MINUS = 7
-SC_MARK_PLUS = 8
-SC_MARK_VLINE = 9
-SC_MARK_LCORNER = 10
-SC_MARK_TCORNER = 11
-SC_MARK_BOXPLUS = 12
-SC_MARK_BOXPLUSCONNECTED = 13
-SC_MARK_BOXMINUS = 14
-SC_MARK_BOXMINUSCONNECTED = 15
-SC_MARK_LCORNERCURVE = 16
-SC_MARK_TCORNERCURVE = 17
-SC_MARK_CIRCLEPLUS = 18
-SC_MARK_CIRCLEPLUSCONNECTED = 19
-SC_MARK_CIRCLEMINUS = 20
-SC_MARK_CIRCLEMINUSCONNECTED = 21
-SC_MARK_BACKGROUND = 22
-SC_MARK_DOTDOTDOT = 23
-SC_MARK_ARROWS = 24
-SC_MARK_PIXMAP = 25
-SC_MARK_FULLRECT = 26
-SC_MARK_LEFTRECT = 27
-SC_MARK_CHARACTER = 10000
-SC_MARKNUM_FOLDEREND = 25
-SC_MARKNUM_FOLDEROPENMID = 26
-SC_MARKNUM_FOLDERMIDTAIL = 27
-SC_MARKNUM_FOLDERTAIL = 28
-SC_MARKNUM_FOLDERSUB = 29
-SC_MARKNUM_FOLDER = 30
-SC_MARKNUM_FOLDEROPEN = 31
-SC_MASK_FOLDERS = -33554432
-SCI_MARKERDEFINE = 2040
-SCI_MARKERSETFORE = 2041
-SCI_MARKERSETBACK = 2042
-SCI_MARKERADD = 2043
-SCI_MARKERDELETE = 2044
-SCI_MARKERDELETEALL = 2045
-SCI_MARKERGET = 2046
-SCI_MARKERNEXT = 2047
-SCI_MARKERPREVIOUS = 2048
-SCI_MARKERDEFINEPIXMAP = 2049
-SCI_MARKERADDSET = 2466
-SCI_MARKERSETALPHA = 2476
-SC_MARGIN_SYMBOL = 0
-SC_MARGIN_NUMBER = 1
-SC_MARGIN_BACK = 2
-SC_MARGIN_FORE = 3
-SCI_SETMARGINTYPEN = 2240
-SCI_GETMARGINTYPEN = 2241
-SCI_SETMARGINWIDTHN = 2242
-SCI_GETMARGINWIDTHN = 2243
-SCI_SETMARGINMASKN = 2244
-SCI_GETMARGINMASKN = 2245
-SCI_SETMARGINSENSITIVEN = 2246
-SCI_GETMARGINSENSITIVEN = 2247
-STYLE_DEFAULT = 32
-STYLE_LINENUMBER = 33
-STYLE_BRACELIGHT = 34
-STYLE_BRACEBAD = 35
-STYLE_CONTROLCHAR = 36
-STYLE_INDENTGUIDE = 37
-STYLE_CALLTIP = 38
-STYLE_LASTPREDEFINED = 39
-STYLE_MAX = 255
-SC_CHARSET_ANSI = 0
-SC_CHARSET_DEFAULT = 1
-SC_CHARSET_BALTIC = 186
-SC_CHARSET_CHINESEBIG5 = 136
-SC_CHARSET_EASTEUROPE = 238
-SC_CHARSET_GB2312 = 134
-SC_CHARSET_GREEK = 161
-SC_CHARSET_HANGUL = 129
-SC_CHARSET_MAC = 77
-SC_CHARSET_OEM = 255
-SC_CHARSET_RUSSIAN = 204
-SC_CHARSET_CYRILLIC = 1251
-SC_CHARSET_SHIFTJIS = 128
-SC_CHARSET_SYMBOL = 2
-SC_CHARSET_TURKISH = 162
-SC_CHARSET_JOHAB = 130
-SC_CHARSET_HEBREW = 177
-SC_CHARSET_ARABIC = 178
-SC_CHARSET_VIETNAMESE = 163
-SC_CHARSET_THAI = 222
-SC_CHARSET_8859_15 = 1000
-SCI_STYLECLEARALL = 2050
-SCI_STYLESETFORE = 2051
-SCI_STYLESETBACK = 2052
-SCI_STYLESETBOLD = 2053
-SCI_STYLESETITALIC = 2054
-SCI_STYLESETSIZE = 2055
-SCI_STYLESETFONT = 2056
-SCI_STYLESETEOLFILLED = 2057
-SCI_STYLERESETDEFAULT = 2058
-SCI_STYLESETUNDERLINE = 2059
-SC_CASE_MIXED = 0
-SC_CASE_UPPER = 1
-SC_CASE_LOWER = 2
-SCI_STYLEGETFORE = 2481
-SCI_STYLEGETBACK = 2482
-SCI_STYLEGETBOLD = 2483
-SCI_STYLEGETITALIC = 2484
-SCI_STYLEGETSIZE = 2485
-SCI_STYLEGETFONT = 2486
-SCI_STYLEGETEOLFILLED = 2487
-SCI_STYLEGETUNDERLINE = 2488
-SCI_STYLEGETCASE = 2489
-SCI_STYLEGETCHARACTERSET = 2490
-SCI_STYLEGETVISIBLE = 2491
-SCI_STYLEGETCHANGEABLE = 2492
-SCI_STYLEGETHOTSPOT = 2493
-SCI_STYLESETCASE = 2060
-SCI_STYLESETCHARACTERSET = 2066
-SCI_STYLESETHOTSPOT = 2409
-SCI_SETSELFORE = 2067
-SCI_SETSELBACK = 2068
-SCI_GETSELALPHA = 2477
-SCI_SETSELALPHA = 2478
-SCI_GETSELEOLFILLED = 2479
-SCI_SETSELEOLFILLED = 2480
-SCI_SETCARETFORE = 2069
-SCI_ASSIGNCMDKEY = 2070
-SCI_CLEARCMDKEY = 2071
-SCI_CLEARALLCMDKEYS = 2072
-SCI_SETSTYLINGEX = 2073
-SCI_STYLESETVISIBLE = 2074
-SCI_GETCARETPERIOD = 2075
-SCI_SETCARETPERIOD = 2076
-SCI_SETWORDCHARS = 2077
-SCI_BEGINUNDOACTION = 2078
-SCI_ENDUNDOACTION = 2079
-INDIC_PLAIN = 0
-INDIC_SQUIGGLE = 1
-INDIC_TT = 2
-INDIC_DIAGONAL = 3
-INDIC_STRIKE = 4
-INDIC_HIDDEN = 5
-INDIC_BOX = 6
-INDIC_ROUNDBOX = 7
-INDIC_MAX = 31
-INDIC_CONTAINER = 8
-INDIC0_MASK = 0x20
-INDIC1_MASK = 0x40
-INDIC2_MASK = 0x80
-INDICS_MASK = 0xE0
-SCI_INDICSETSTYLE = 2080
-SCI_INDICGETSTYLE = 2081
-SCI_INDICSETFORE = 2082
-SCI_INDICGETFORE = 2083
-SCI_INDICSETUNDER = 2510
-SCI_INDICGETUNDER = 2511
-SCI_SETWHITESPACEFORE = 2084
-SCI_SETWHITESPACEBACK = 2085
-SCI_SETSTYLEBITS = 2090
-SCI_GETSTYLEBITS = 2091
-SCI_SETLINESTATE = 2092
-SCI_GETLINESTATE = 2093
-SCI_GETMAXLINESTATE = 2094
-SCI_GETCARETLINEVISIBLE = 2095
-SCI_SETCARETLINEVISIBLE = 2096
-SCI_GETCARETLINEBACK = 2097
-SCI_SETCARETLINEBACK = 2098
-SCI_STYLESETCHANGEABLE = 2099
-SCI_AUTOCSHOW = 2100
-SCI_AUTOCCANCEL = 2101
-SCI_AUTOCACTIVE = 2102
-SCI_AUTOCPOSSTART = 2103
-SCI_AUTOCCOMPLETE = 2104
-SCI_AUTOCSTOPS = 2105
-SCI_AUTOCSETSEPARATOR = 2106
-SCI_AUTOCGETSEPARATOR = 2107
-SCI_AUTOCSELECT = 2108
-SCI_AUTOCSETCANCELATSTART = 2110
-SCI_AUTOCGETCANCELATSTART = 2111
-SCI_AUTOCSETFILLUPS = 2112
-SCI_AUTOCSETCHOOSESINGLE = 2113
-SCI_AUTOCGETCHOOSESINGLE = 2114
-SCI_AUTOCSETIGNORECASE = 2115
-SCI_AUTOCGETIGNORECASE = 2116
-SCI_USERLISTSHOW = 2117
-SCI_AUTOCSETAUTOHIDE = 2118
-SCI_AUTOCGETAUTOHIDE = 2119
-SCI_AUTOCSETDROPRESTOFWORD = 2270
-SCI_AUTOCGETDROPRESTOFWORD = 2271
-SCI_REGISTERIMAGE = 2405
-SCI_CLEARREGISTEREDIMAGES = 2408
-SCI_AUTOCGETTYPESEPARATOR = 2285
-SCI_AUTOCSETTYPESEPARATOR = 2286
-SCI_AUTOCSETMAXWIDTH = 2208
-SCI_AUTOCGETMAXWIDTH = 2209
-SCI_AUTOCSETMAXHEIGHT = 2210
-SCI_AUTOCGETMAXHEIGHT = 2211
-SCI_SETINDENT = 2122
-SCI_GETINDENT = 2123
-SCI_SETUSETABS = 2124
-SCI_GETUSETABS = 2125
-SCI_SETLINEINDENTATION = 2126
-SCI_GETLINEINDENTATION = 2127
-SCI_GETLINEINDENTPOSITION = 2128
-SCI_GETCOLUMN = 2129
-SCI_SETHSCROLLBAR = 2130
-SCI_GETHSCROLLBAR = 2131
-SC_IV_NONE = 0
-SC_IV_REAL = 1
-SC_IV_LOOKFORWARD = 2
-SC_IV_LOOKBOTH = 3
-SCI_SETINDENTATIONGUIDES = 2132
-SCI_GETINDENTATIONGUIDES = 2133
-SCI_SETHIGHLIGHTGUIDE = 2134
-SCI_GETHIGHLIGHTGUIDE = 2135
-SCI_GETLINEENDPOSITION = 2136
-SCI_GETCODEPAGE = 2137
-SCI_GETCARETFORE = 2138
-SCI_GETUSEPALETTE = 2139
-SCI_GETREADONLY = 2140
-SCI_SETCURRENTPOS = 2141
-SCI_SETSELECTIONSTART = 2142
-SCI_GETSELECTIONSTART = 2143
-SCI_SETSELECTIONEND = 2144
-SCI_GETSELECTIONEND = 2145
-SCI_SETPRINTMAGNIFICATION = 2146
-SCI_GETPRINTMAGNIFICATION = 2147
-SC_PRINT_NORMAL = 0
-SC_PRINT_INVERTLIGHT = 1
-SC_PRINT_BLACKONWHITE = 2
-SC_PRINT_COLOURONWHITE = 3
-SC_PRINT_COLOURONWHITEDEFAULTBG = 4
-SCI_SETPRINTCOLOURMODE = 2148
-SCI_GETPRINTCOLOURMODE = 2149
-SCFIND_WHOLEWORD = 2
-SCFIND_MATCHCASE = 4
-SCFIND_WORDSTART = 0x00100000
-SCFIND_REGEXP = 0x00200000
-SCFIND_POSIX = 0x00400000
-SCI_FINDTEXT = 2150
-SCI_FORMATRANGE = 2151
-SCI_GETFIRSTVISIBLELINE = 2152
-SCI_GETLINE = 2153
-SCI_GETLINECOUNT = 2154
-SCI_SETMARGINLEFT = 2155
-SCI_GETMARGINLEFT = 2156
-SCI_SETMARGINRIGHT = 2157
-SCI_GETMARGINRIGHT = 2158
-SCI_GETMODIFY = 2159
-SCI_SETSEL = 2160
-SCI_GETSELTEXT = 2161
-SCI_GETTEXTRANGE = 2162
-SCI_HIDESELECTION = 2163
-SCI_POINTXFROMPOSITION = 2164
-SCI_POINTYFROMPOSITION = 2165
-SCI_LINEFROMPOSITION = 2166
-SCI_POSITIONFROMLINE = 2167
-SCI_LINESCROLL = 2168
-SCI_SCROLLCARET = 2169
-SCI_REPLACESEL = 2170
-SCI_SETREADONLY = 2171
-SCI_NULL = 2172
-SCI_CANPASTE = 2173
-SCI_CANUNDO = 2174
-SCI_EMPTYUNDOBUFFER = 2175
-SCI_UNDO = 2176
-SCI_CUT = 2177
-SCI_COPY = 2178
-SCI_PASTE = 2179
-SCI_CLEAR = 2180
-SCI_SETTEXT = 2181
-SCI_GETTEXT = 2182
-SCI_GETTEXTLENGTH = 2183
-SCI_GETDIRECTFUNCTION = 2184
-SCI_GETDIRECTPOINTER = 2185
-SCI_SETOVERTYPE = 2186
-SCI_GETOVERTYPE = 2187
-SCI_SETCARETWIDTH = 2188
-SCI_GETCARETWIDTH = 2189
-SCI_SETTARGETSTART = 2190
-SCI_GETTARGETSTART = 2191
-SCI_SETTARGETEND = 2192
-SCI_GETTARGETEND = 2193
-SCI_REPLACETARGET = 2194
-SCI_REPLACETARGETRE = 2195
-SCI_SEARCHINTARGET = 2197
-SCI_SETSEARCHFLAGS = 2198
-SCI_GETSEARCHFLAGS = 2199
-SCI_CALLTIPSHOW = 2200
-SCI_CALLTIPCANCEL = 2201
-SCI_CALLTIPACTIVE = 2202
-SCI_CALLTIPPOSSTART = 2203
-SCI_CALLTIPSETHLT = 2204
-SCI_CALLTIPSETBACK = 2205
-SCI_CALLTIPSETFORE = 2206
-SCI_CALLTIPSETFOREHLT = 2207
-SCI_CALLTIPUSESTYLE = 2212
-SCI_VISIBLEFROMDOCLINE = 2220
-SCI_DOCLINEFROMVISIBLE = 2221
-SCI_WRAPCOUNT = 2235
-SC_FOLDLEVELBASE = 0x400
-SC_FOLDLEVELWHITEFLAG = 0x1000
-SC_FOLDLEVELHEADERFLAG = 0x2000
-SC_FOLDLEVELBOXHEADERFLAG = 0x4000
-SC_FOLDLEVELBOXFOOTERFLAG = 0x8000
-SC_FOLDLEVELCONTRACTED = 0x10000
-SC_FOLDLEVELUNINDENT = 0x20000
-SC_FOLDLEVELNUMBERMASK = 0x0FFF
-SCI_SETFOLDLEVEL = 2222
-SCI_GETFOLDLEVEL = 2223
-SCI_GETLASTCHILD = 2224
-SCI_GETFOLDPARENT = 2225
-SCI_SHOWLINES = 2226
-SCI_HIDELINES = 2227
-SCI_GETLINEVISIBLE = 2228
-SCI_SETFOLDEXPANDED = 2229
-SCI_GETFOLDEXPANDED = 2230
-SCI_TOGGLEFOLD = 2231
-SCI_ENSUREVISIBLE = 2232
-SC_FOLDFLAG_LINEBEFORE_EXPANDED = 0x0002
-SC_FOLDFLAG_LINEBEFORE_CONTRACTED = 0x0004
-SC_FOLDFLAG_LINEAFTER_EXPANDED = 0x0008
-SC_FOLDFLAG_LINEAFTER_CONTRACTED = 0x0010
-SC_FOLDFLAG_LEVELNUMBERS = 0x0040
-SC_FOLDFLAG_BOX = 0x0001
-SCI_SETFOLDFLAGS = 2233
-SCI_ENSUREVISIBLEENFORCEPOLICY = 2234
-SCI_SETTABINDENTS = 2260
-SCI_GETTABINDENTS = 2261
-SCI_SETBACKSPACEUNINDENTS = 2262
-SCI_GETBACKSPACEUNINDENTS = 2263
-SC_TIME_FOREVER = 10000000
-SCI_SETMOUSEDWELLTIME = 2264
-SCI_GETMOUSEDWELLTIME = 2265
-SCI_WORDSTARTPOSITION = 2266
-SCI_WORDENDPOSITION = 2267
-SC_WRAP_NONE = 0
-SC_WRAP_WORD = 1
-SC_WRAP_CHAR = 2
-SCI_SETWRAPMODE = 2268
-SCI_GETWRAPMODE = 2269
-SC_WRAPVISUALFLAG_NONE = 0x0000
-SC_WRAPVISUALFLAG_END = 0x0001
-SC_WRAPVISUALFLAG_START = 0x0002
-SCI_SETWRAPVISUALFLAGS = 2460
-SCI_GETWRAPVISUALFLAGS = 2461
-SC_WRAPVISUALFLAGLOC_DEFAULT = 0x0000
-SC_WRAPVISUALFLAGLOC_END_BY_TEXT = 0x0001
-SC_WRAPVISUALFLAGLOC_START_BY_TEXT = 0x0002
-SCI_SETWRAPVISUALFLAGSLOCATION = 2462
-SCI_GETWRAPVISUALFLAGSLOCATION = 2463
-SCI_SETWRAPSTARTINDENT = 2464
-SCI_GETWRAPSTARTINDENT = 2465
-SC_CACHE_NONE = 0
-SC_CACHE_CARET = 1
-SC_CACHE_PAGE = 2
-SC_CACHE_DOCUMENT = 3
-SCI_SETLAYOUTCACHE = 2272
-SCI_GETLAYOUTCACHE = 2273
-SCI_SETSCROLLWIDTH = 2274
-SCI_GETSCROLLWIDTH = 2275
-SCI_SETSCROLLWIDTHTRACKING = 2516
-SCI_GETSCROLLWIDTHTRACKING = 2517
-SCI_TEXTWIDTH = 2276
-SCI_SETENDATLASTLINE = 2277
-SCI_GETENDATLASTLINE = 2278
-SCI_TEXTHEIGHT = 2279
-SCI_SETVSCROLLBAR = 2280
-SCI_GETVSCROLLBAR = 2281
-SCI_APPENDTEXT = 2282
-SCI_GETTWOPHASEDRAW = 2283
-SCI_SETTWOPHASEDRAW = 2284
-SCI_TARGETFROMSELECTION = 2287
-SCI_LINESJOIN = 2288
-SCI_LINESSPLIT = 2289
-SCI_SETFOLDMARGINCOLOUR = 2290
-SCI_SETFOLDMARGINHICOLOUR = 2291
-SCI_LINEDOWN = 2300
-SCI_LINEDOWNEXTEND = 2301
-SCI_LINEUP = 2302
-SCI_LINEUPEXTEND = 2303
-SCI_CHARLEFT = 2304
-SCI_CHARLEFTEXTEND = 2305
-SCI_CHARRIGHT = 2306
-SCI_CHARRIGHTEXTEND = 2307
-SCI_WORDLEFT = 2308
-SCI_WORDLEFTEXTEND = 2309
-SCI_WORDRIGHT = 2310
-SCI_WORDRIGHTEXTEND = 2311
-SCI_HOME = 2312
-SCI_HOMEEXTEND = 2313
-SCI_LINEEND = 2314
-SCI_LINEENDEXTEND = 2315
-SCI_DOCUMENTSTART = 2316
-SCI_DOCUMENTSTARTEXTEND = 2317
-SCI_DOCUMENTEND = 2318
-SCI_DOCUMENTENDEXTEND = 2319
-SCI_PAGEUP = 2320
-SCI_PAGEUPEXTEND = 2321
-SCI_PAGEDOWN = 2322
-SCI_PAGEDOWNEXTEND = 2323
-SCI_EDITTOGGLEOVERTYPE = 2324
-SCI_CANCEL = 2325
-SCI_DELETEBACK = 2326
-SCI_TAB = 2327
-SCI_BACKTAB = 2328
-SCI_NEWLINE = 2329
-SCI_FORMFEED = 2330
-SCI_VCHOME = 2331
-SCI_VCHOMEEXTEND = 2332
-SCI_ZOOMIN = 2333
-SCI_ZOOMOUT = 2334
-SCI_DELWORDLEFT = 2335
-SCI_DELWORDRIGHT = 2336
-SCI_DELWORDRIGHTEND = 2518
-SCI_LINECUT = 2337
-SCI_LINEDELETE = 2338
-SCI_LINETRANSPOSE = 2339
-SCI_LINEDUPLICATE = 2404
-SCI_LOWERCASE = 2340
-SCI_UPPERCASE = 2341
-SCI_LINESCROLLDOWN = 2342
-SCI_LINESCROLLUP = 2343
-SCI_DELETEBACKNOTLINE = 2344
-SCI_HOMEDISPLAY = 2345
-SCI_HOMEDISPLAYEXTEND = 2346
-SCI_LINEENDDISPLAY = 2347
-SCI_LINEENDDISPLAYEXTEND = 2348
-SCI_HOMEWRAP = 2349
-SCI_HOMEWRAPEXTEND = 2450
-SCI_LINEENDWRAP = 2451
-SCI_LINEENDWRAPEXTEND = 2452
-SCI_VCHOMEWRAP = 2453
-SCI_VCHOMEWRAPEXTEND = 2454
-SCI_LINECOPY = 2455
-SCI_MOVECARETINSIDEVIEW = 2401
-SCI_LINELENGTH = 2350
-SCI_BRACEHIGHLIGHT = 2351
-SCI_BRACEBADLIGHT = 2352
-SCI_BRACEMATCH = 2353
-SCI_GETVIEWEOL = 2355
-SCI_SETVIEWEOL = 2356
-SCI_GETDOCPOINTER = 2357
-SCI_SETDOCPOINTER = 2358
-SCI_SETMODEVENTMASK = 2359
-EDGE_NONE = 0
-EDGE_LINE = 1
-EDGE_BACKGROUND = 2
-SCI_GETEDGECOLUMN = 2360
-SCI_SETEDGECOLUMN = 2361
-SCI_GETEDGEMODE = 2362
-SCI_SETEDGEMODE = 2363
-SCI_GETEDGECOLOUR = 2364
-SCI_SETEDGECOLOUR = 2365
-SCI_SEARCHANCHOR = 2366
-SCI_SEARCHNEXT = 2367
-SCI_SEARCHPREV = 2368
-SCI_LINESONSCREEN = 2370
-SCI_USEPOPUP = 2371
-SCI_SELECTIONISRECTANGLE = 2372
-SCI_SETZOOM = 2373
-SCI_GETZOOM = 2374
-SCI_CREATEDOCUMENT = 2375
-SCI_ADDREFDOCUMENT = 2376
-SCI_RELEASEDOCUMENT = 2377
-SCI_GETMODEVENTMASK = 2378
-SCI_SETFOCUS = 2380
-SCI_GETFOCUS = 2381
-SCI_SETSTATUS = 2382
-SCI_GETSTATUS = 2383
-SCI_SETMOUSEDOWNCAPTURES = 2384
-SCI_GETMOUSEDOWNCAPTURES = 2385
-SC_CURSORNORMAL = -1
-SC_CURSORWAIT = 4
-SCI_SETCURSOR = 2386
-SCI_GETCURSOR = 2387
-SCI_SETCONTROLCHARSYMBOL = 2388
-SCI_GETCONTROLCHARSYMBOL = 2389
-SCI_WORDPARTLEFT = 2390
-SCI_WORDPARTLEFTEXTEND = 2391
-SCI_WORDPARTRIGHT = 2392
-SCI_WORDPARTRIGHTEXTEND = 2393
-VISIBLE_SLOP = 0x01
-VISIBLE_STRICT = 0x04
-SCI_SETVISIBLEPOLICY = 2394
-SCI_DELLINELEFT = 2395
-SCI_DELLINERIGHT = 2396
-SCI_SETXOFFSET = 2397
-SCI_GETXOFFSET = 2398
-SCI_CHOOSECARETX = 2399
-SCI_GRABFOCUS = 2400
-CARET_SLOP = 0x01
-CARET_STRICT = 0x04
-CARET_JUMPS = 0x10
-CARET_EVEN = 0x08
-SCI_SETXCARETPOLICY = 2402
-SCI_SETYCARETPOLICY = 2403
-SCI_SETPRINTWRAPMODE = 2406
-SCI_GETPRINTWRAPMODE = 2407
-SCI_SETHOTSPOTACTIVEFORE = 2410
-SCI_GETHOTSPOTACTIVEFORE = 2494
-SCI_SETHOTSPOTACTIVEBACK = 2411
-SCI_GETHOTSPOTACTIVEBACK = 2495
-SCI_SETHOTSPOTACTIVEUNDERLINE = 2412
-SCI_GETHOTSPOTACTIVEUNDERLINE = 2496
-SCI_SETHOTSPOTSINGLELINE = 2421
-SCI_GETHOTSPOTSINGLELINE = 2497
-SCI_PARADOWN = 2413
-SCI_PARADOWNEXTEND = 2414
-SCI_PARAUP = 2415
-SCI_PARAUPEXTEND = 2416
-SCI_POSITIONBEFORE = 2417
-SCI_POSITIONAFTER = 2418
-SCI_COPYRANGE = 2419
-SCI_COPYTEXT = 2420
-SC_SEL_STREAM = 0
-SC_SEL_RECTANGLE = 1
-SC_SEL_LINES = 2
-SCI_SETSELECTIONMODE = 2422
-SCI_GETSELECTIONMODE = 2423
-SCI_GETLINESELSTARTPOSITION = 2424
-SCI_GETLINESELENDPOSITION = 2425
-SCI_LINEDOWNRECTEXTEND = 2426
-SCI_LINEUPRECTEXTEND = 2427
-SCI_CHARLEFTRECTEXTEND = 2428
-SCI_CHARRIGHTRECTEXTEND = 2429
-SCI_HOMERECTEXTEND = 2430
-SCI_VCHOMERECTEXTEND = 2431
-SCI_LINEENDRECTEXTEND = 2432
-SCI_PAGEUPRECTEXTEND = 2433
-SCI_PAGEDOWNRECTEXTEND = 2434
-SCI_STUTTEREDPAGEUP = 2435
-SCI_STUTTEREDPAGEUPEXTEND = 2436
-SCI_STUTTEREDPAGEDOWN = 2437
-SCI_STUTTEREDPAGEDOWNEXTEND = 2438
-SCI_WORDLEFTEND = 2439
-SCI_WORDLEFTENDEXTEND = 2440
-SCI_WORDRIGHTEND = 2441
-SCI_WORDRIGHTENDEXTEND = 2442
-SCI_SETWHITESPACECHARS = 2443
-SCI_SETCHARSDEFAULT = 2444
-SCI_AUTOCGETCURRENT = 2445
-SCI_ALLOCATE = 2446
-SCI_TARGETASUTF8 = 2447
-SCI_SETLENGTHFORENCODE = 2448
-SCI_ENCODEDFROMUTF8 = 2449
-SCI_FINDCOLUMN = 2456
-SCI_GETCARETSTICKY = 2457
-SCI_SETCARETSTICKY = 2458
-SCI_TOGGLECARETSTICKY = 2459
-SCI_SETPASTECONVERTENDINGS = 2467
-SCI_GETPASTECONVERTENDINGS = 2468
-SCI_SELECTIONDUPLICATE = 2469
-SC_ALPHA_TRANSPARENT = 0
-SC_ALPHA_OPAQUE = 255
-SC_ALPHA_NOALPHA = 256
-SCI_SETCARETLINEBACKALPHA = 2470
-SCI_GETCARETLINEBACKALPHA = 2471
-CARETSTYLE_INVISIBLE = 0
-CARETSTYLE_LINE = 1
-CARETSTYLE_BLOCK = 2
-SCI_SETCARETSTYLE = 2512
-SCI_GETCARETSTYLE = 2513
-SCI_SETINDICATORCURRENT = 2500
-SCI_GETINDICATORCURRENT = 2501
-SCI_SETINDICATORVALUE = 2502
-SCI_GETINDICATORVALUE = 2503
-SCI_INDICATORFILLRANGE = 2504
-SCI_INDICATORCLEARRANGE = 2505
-SCI_INDICATORALLONFOR = 2506
-SCI_INDICATORVALUEAT = 2507
-SCI_INDICATORSTART = 2508
-SCI_INDICATOREND = 2509
-SCI_SETPOSITIONCACHE = 2514
-SCI_GETPOSITIONCACHE = 2515
-SCI_COPYALLOWLINE = 2519
-SCI_GETCHARACTERPOINTER = 2520
-SCI_SETKEYSUNICODE = 2521
-SCI_GETKEYSUNICODE = 2522
-SCI_STARTRECORD = 3001
-SCI_STOPRECORD = 3002
-SCI_SETLEXER = 4001
-SCI_GETLEXER = 4002
-SCI_COLOURISE = 4003
-SCI_SETPROPERTY = 4004
-KEYWORDSET_MAX = 8
-SCI_SETKEYWORDS = 4005
-SCI_SETLEXERLANGUAGE = 4006
-SCI_LOADLEXERLIBRARY = 4007
-SCI_GETPROPERTY = 4008
-SCI_GETPROPERTYEXPANDED = 4009
-SCI_GETPROPERTYINT = 4010
-SCI_GETSTYLEBITSNEEDED = 4011
-SC_MOD_INSERTTEXT = 0x1
-SC_MOD_DELETETEXT = 0x2
-SC_MOD_CHANGESTYLE = 0x4
-SC_MOD_CHANGEFOLD = 0x8
-SC_PERFORMED_USER = 0x10
-SC_PERFORMED_UNDO = 0x20
-SC_PERFORMED_REDO = 0x40
-SC_MULTISTEPUNDOREDO = 0x80
-SC_LASTSTEPINUNDOREDO = 0x100
-SC_MOD_CHANGEMARKER = 0x200
-SC_MOD_BEFOREINSERT = 0x400
-SC_MOD_BEFOREDELETE = 0x800
-SC_MULTILINEUNDOREDO = 0x1000
-SC_STARTACTION = 0x2000
-SC_MOD_CHANGEINDICATOR = 0x4000
-SC_MOD_CHANGELINESTATE = 0x8000
-SC_MODEVENTMASKALL = 0xFFFF
-SCEN_CHANGE = 768
-SCEN_SETFOCUS = 512
-SCEN_KILLFOCUS = 256
-SCK_DOWN = 300
-SCK_UP = 301
-SCK_LEFT = 302
-SCK_RIGHT = 303
-SCK_HOME = 304
-SCK_END = 305
-SCK_PRIOR = 306
-SCK_NEXT = 307
-SCK_DELETE = 308
-SCK_INSERT = 309
-SCK_ESCAPE = 7
-SCK_BACK = 8
-SCK_TAB = 9
-SCK_RETURN = 13
-SCK_ADD = 310
-SCK_SUBTRACT = 311
-SCK_DIVIDE = 312
-SCK_WIN = 313
-SCK_RWIN = 314
-SCK_MENU = 315
-SCMOD_NORM = 0
-SCMOD_SHIFT = 1
-SCMOD_CTRL = 2
-SCMOD_ALT = 4
-SCN_STYLENEEDED = 2000
-SCN_CHARADDED = 2001
-SCN_SAVEPOINTREACHED = 2002
-SCN_SAVEPOINTLEFT = 2003
-SCN_MODIFYATTEMPTRO = 2004
-SCN_KEY = 2005
-SCN_DOUBLECLICK = 2006
-SCN_UPDATEUI = 2007
-SCN_MODIFIED = 2008
-SCN_MACRORECORD = 2009
-SCN_MARGINCLICK = 2010
-SCN_NEEDSHOWN = 2011
-SCN_PAINTED = 2013
-SCN_USERLISTSELECTION = 2014
-SCN_URIDROPPED = 2015
-SCN_DWELLSTART = 2016
-SCN_DWELLEND = 2017
-SCN_ZOOM = 2018
-SCN_HOTSPOTCLICK = 2019
-SCN_HOTSPOTDOUBLECLICK = 2020
-SCN_CALLTIPCLICK = 2021
-SCN_AUTOCSELECTION = 2022
-SCN_INDICATORCLICK = 2023
-SCN_INDICATORRELEASE = 2024
-SCN_AUTOCCANCELLED = 2025
-SCI_SETCARETPOLICY = 2369
-CARET_CENTER = 0x02
-CARET_XEVEN = 0x08
-CARET_XJUMPS = 0x10
-SCN_POSCHANGED = 2012
-SCN_CHECKBRACE = 2007
-# Generated by h2py from Include\scilexer.h
-SCLEX_CONTAINER = 0
-SCLEX_NULL = 1
-SCLEX_PYTHON = 2
-SCLEX_CPP = 3
-SCLEX_HTML = 4
-SCLEX_XML = 5
-SCLEX_PERL = 6
-SCLEX_SQL = 7
-SCLEX_VB = 8
-SCLEX_PROPERTIES = 9
-SCLEX_ERRORLIST = 10
-SCLEX_MAKEFILE = 11
-SCLEX_BATCH = 12
-SCLEX_XCODE = 13
-SCLEX_LATEX = 14
-SCLEX_LUA = 15
-SCLEX_DIFF = 16
-SCLEX_CONF = 17
-SCLEX_PASCAL = 18
-SCLEX_AVE = 19
-SCLEX_ADA = 20
-SCLEX_LISP = 21
-SCLEX_RUBY = 22
-SCLEX_EIFFEL = 23
-SCLEX_EIFFELKW = 24
-SCLEX_TCL = 25
-SCLEX_NNCRONTAB = 26
-SCLEX_BULLANT = 27
-SCLEX_VBSCRIPT = 28
-SCLEX_BAAN = 31
-SCLEX_MATLAB = 32
-SCLEX_SCRIPTOL = 33
-SCLEX_ASM = 34
-SCLEX_CPPNOCASE = 35
-SCLEX_FORTRAN = 36
-SCLEX_F77 = 37
-SCLEX_CSS = 38
-SCLEX_POV = 39
-SCLEX_LOUT = 40
-SCLEX_ESCRIPT = 41
-SCLEX_PS = 42
-SCLEX_NSIS = 43
-SCLEX_MMIXAL = 44
-SCLEX_CLW = 45
-SCLEX_CLWNOCASE = 46
-SCLEX_LOT = 47
-SCLEX_YAML = 48
-SCLEX_TEX = 49
-SCLEX_METAPOST = 50
-SCLEX_POWERBASIC = 51
-SCLEX_FORTH = 52
-SCLEX_ERLANG = 53
-SCLEX_OCTAVE = 54
-SCLEX_MSSQL = 55
-SCLEX_VERILOG = 56
-SCLEX_KIX = 57
-SCLEX_GUI4CLI = 58
-SCLEX_SPECMAN = 59
-SCLEX_AU3 = 60
-SCLEX_APDL = 61
-SCLEX_BASH = 62
-SCLEX_ASN1 = 63
-SCLEX_VHDL = 64
-SCLEX_CAML = 65
-SCLEX_BLITZBASIC = 66
-SCLEX_PUREBASIC = 67
-SCLEX_HASKELL = 68
-SCLEX_PHPSCRIPT = 69
-SCLEX_TADS3 = 70
-SCLEX_REBOL = 71
-SCLEX_SMALLTALK = 72
-SCLEX_FLAGSHIP = 73
-SCLEX_CSOUND = 74
-SCLEX_FREEBASIC = 75
-SCLEX_INNOSETUP = 76
-SCLEX_OPAL = 77
-SCLEX_SPICE = 78
-SCLEX_D = 79
-SCLEX_CMAKE = 80
-SCLEX_GAP = 81
-SCLEX_PLM = 82
-SCLEX_PROGRESS = 83
-SCLEX_ABAQUS = 84
-SCLEX_ASYMPTOTE = 85
-SCLEX_R = 86
-SCLEX_MAGIK = 87
-SCLEX_POWERSHELL = 88
-SCLEX_MYSQL = 89
-SCLEX_PO = 90
-SCLEX_AUTOMATIC = 1000
-SCE_P_DEFAULT = 0
-SCE_P_COMMENTLINE = 1
-SCE_P_NUMBER = 2
-SCE_P_STRING = 3
-SCE_P_CHARACTER = 4
-SCE_P_WORD = 5
-SCE_P_TRIPLE = 6
-SCE_P_TRIPLEDOUBLE = 7
-SCE_P_CLASSNAME = 8
-SCE_P_DEFNAME = 9
-SCE_P_OPERATOR = 10
-SCE_P_IDENTIFIER = 11
-SCE_P_COMMENTBLOCK = 12
-SCE_P_STRINGEOL = 13
-SCE_P_WORD2 = 14
-SCE_P_DECORATOR = 15
-SCE_C_DEFAULT = 0
-SCE_C_COMMENT = 1
-SCE_C_COMMENTLINE = 2
-SCE_C_COMMENTDOC = 3
-SCE_C_NUMBER = 4
-SCE_C_WORD = 5
-SCE_C_STRING = 6
-SCE_C_CHARACTER = 7
-SCE_C_UUID = 8
-SCE_C_PREPROCESSOR = 9
-SCE_C_OPERATOR = 10
-SCE_C_IDENTIFIER = 11
-SCE_C_STRINGEOL = 12
-SCE_C_VERBATIM = 13
-SCE_C_REGEX = 14
-SCE_C_COMMENTLINEDOC = 15
-SCE_C_WORD2 = 16
-SCE_C_COMMENTDOCKEYWORD = 17
-SCE_C_COMMENTDOCKEYWORDERROR = 18
-SCE_C_GLOBALCLASS = 19
-SCE_D_DEFAULT = 0
-SCE_D_COMMENT = 1
-SCE_D_COMMENTLINE = 2
-SCE_D_COMMENTDOC = 3
-SCE_D_COMMENTNESTED = 4
-SCE_D_NUMBER = 5
-SCE_D_WORD = 6
-SCE_D_WORD2 = 7
-SCE_D_WORD3 = 8
-SCE_D_TYPEDEF = 9
-SCE_D_STRING = 10
-SCE_D_STRINGEOL = 11
-SCE_D_CHARACTER = 12
-SCE_D_OPERATOR = 13
-SCE_D_IDENTIFIER = 14
-SCE_D_COMMENTLINEDOC = 15
-SCE_D_COMMENTDOCKEYWORD = 16
-SCE_D_COMMENTDOCKEYWORDERROR = 17
-SCE_TCL_DEFAULT = 0
-SCE_TCL_COMMENT = 1
-SCE_TCL_COMMENTLINE = 2
-SCE_TCL_NUMBER = 3
-SCE_TCL_WORD_IN_QUOTE = 4
-SCE_TCL_IN_QUOTE = 5
-SCE_TCL_OPERATOR = 6
-SCE_TCL_IDENTIFIER = 7
-SCE_TCL_SUBSTITUTION = 8
-SCE_TCL_SUB_BRACE = 9
-SCE_TCL_MODIFIER = 10
-SCE_TCL_EXPAND = 11
-SCE_TCL_WORD = 12
-SCE_TCL_WORD2 = 13
-SCE_TCL_WORD3 = 14
-SCE_TCL_WORD4 = 15
-SCE_TCL_WORD5 = 16
-SCE_TCL_WORD6 = 17
-SCE_TCL_WORD7 = 18
-SCE_TCL_WORD8 = 19
-SCE_TCL_COMMENT_BOX = 20
-SCE_TCL_BLOCK_COMMENT = 21
-SCE_H_DEFAULT = 0
-SCE_H_TAG = 1
-SCE_H_TAGUNKNOWN = 2
-SCE_H_ATTRIBUTE = 3
-SCE_H_ATTRIBUTEUNKNOWN = 4
-SCE_H_NUMBER = 5
-SCE_H_DOUBLESTRING = 6
-SCE_H_SINGLESTRING = 7
-SCE_H_OTHER = 8
-SCE_H_COMMENT = 9
-SCE_H_ENTITY = 10
-SCE_H_TAGEND = 11
-SCE_H_XMLSTART = 12
-SCE_H_XMLEND = 13
-SCE_H_SCRIPT = 14
-SCE_H_ASP = 15
-SCE_H_ASPAT = 16
-SCE_H_CDATA = 17
-SCE_H_QUESTION = 18
-SCE_H_VALUE = 19
-SCE_H_XCCOMMENT = 20
-SCE_H_SGML_DEFAULT = 21
-SCE_H_SGML_COMMAND = 22
-SCE_H_SGML_1ST_PARAM = 23
-SCE_H_SGML_DOUBLESTRING = 24
-SCE_H_SGML_SIMPLESTRING = 25
-SCE_H_SGML_ERROR = 26
-SCE_H_SGML_SPECIAL = 27
-SCE_H_SGML_ENTITY = 28
-SCE_H_SGML_COMMENT = 29
-SCE_H_SGML_1ST_PARAM_COMMENT = 30
-SCE_H_SGML_BLOCK_DEFAULT = 31
-SCE_HJ_START = 40
-SCE_HJ_DEFAULT = 41
-SCE_HJ_COMMENT = 42
-SCE_HJ_COMMENTLINE = 43
-SCE_HJ_COMMENTDOC = 44
-SCE_HJ_NUMBER = 45
-SCE_HJ_WORD = 46
-SCE_HJ_KEYWORD = 47
-SCE_HJ_DOUBLESTRING = 48
-SCE_HJ_SINGLESTRING = 49
-SCE_HJ_SYMBOLS = 50
-SCE_HJ_STRINGEOL = 51
-SCE_HJ_REGEX = 52
-SCE_HJA_START = 55
-SCE_HJA_DEFAULT = 56
-SCE_HJA_COMMENT = 57
-SCE_HJA_COMMENTLINE = 58
-SCE_HJA_COMMENTDOC = 59
-SCE_HJA_NUMBER = 60
-SCE_HJA_WORD = 61
-SCE_HJA_KEYWORD = 62
-SCE_HJA_DOUBLESTRING = 63
-SCE_HJA_SINGLESTRING = 64
-SCE_HJA_SYMBOLS = 65
-SCE_HJA_STRINGEOL = 66
-SCE_HJA_REGEX = 67
-SCE_HB_START = 70
-SCE_HB_DEFAULT = 71
-SCE_HB_COMMENTLINE = 72
-SCE_HB_NUMBER = 73
-SCE_HB_WORD = 74
-SCE_HB_STRING = 75
-SCE_HB_IDENTIFIER = 76
-SCE_HB_STRINGEOL = 77
-SCE_HBA_START = 80
-SCE_HBA_DEFAULT = 81
-SCE_HBA_COMMENTLINE = 82
-SCE_HBA_NUMBER = 83
-SCE_HBA_WORD = 84
-SCE_HBA_STRING = 85
-SCE_HBA_IDENTIFIER = 86
-SCE_HBA_STRINGEOL = 87
-SCE_HP_START = 90
-SCE_HP_DEFAULT = 91
-SCE_HP_COMMENTLINE = 92
-SCE_HP_NUMBER = 93
-SCE_HP_STRING = 94
-SCE_HP_CHARACTER = 95
-SCE_HP_WORD = 96
-SCE_HP_TRIPLE = 97
-SCE_HP_TRIPLEDOUBLE = 98
-SCE_HP_CLASSNAME = 99
-SCE_HP_DEFNAME = 100
-SCE_HP_OPERATOR = 101
-SCE_HP_IDENTIFIER = 102
-SCE_HPHP_COMPLEX_VARIABLE = 104
-SCE_HPA_START = 105
-SCE_HPA_DEFAULT = 106
-SCE_HPA_COMMENTLINE = 107
-SCE_HPA_NUMBER = 108
-SCE_HPA_STRING = 109
-SCE_HPA_CHARACTER = 110
-SCE_HPA_WORD = 111
-SCE_HPA_TRIPLE = 112
-SCE_HPA_TRIPLEDOUBLE = 113
-SCE_HPA_CLASSNAME = 114
-SCE_HPA_DEFNAME = 115
-SCE_HPA_OPERATOR = 116
-SCE_HPA_IDENTIFIER = 117
-SCE_HPHP_DEFAULT = 118
-SCE_HPHP_HSTRING = 119
-SCE_HPHP_SIMPLESTRING = 120
-SCE_HPHP_WORD = 121
-SCE_HPHP_NUMBER = 122
-SCE_HPHP_VARIABLE = 123
-SCE_HPHP_COMMENT = 124
-SCE_HPHP_COMMENTLINE = 125
-SCE_HPHP_HSTRING_VARIABLE = 126
-SCE_HPHP_OPERATOR = 127
-SCE_PL_DEFAULT = 0
-SCE_PL_ERROR = 1
-SCE_PL_COMMENTLINE = 2
-SCE_PL_POD = 3
-SCE_PL_NUMBER = 4
-SCE_PL_WORD = 5
-SCE_PL_STRING = 6
-SCE_PL_CHARACTER = 7
-SCE_PL_PUNCTUATION = 8
-SCE_PL_PREPROCESSOR = 9
-SCE_PL_OPERATOR = 10
-SCE_PL_IDENTIFIER = 11
-SCE_PL_SCALAR = 12
-SCE_PL_ARRAY = 13
-SCE_PL_HASH = 14
-SCE_PL_SYMBOLTABLE = 15
-SCE_PL_VARIABLE_INDEXER = 16
-SCE_PL_REGEX = 17
-SCE_PL_REGSUBST = 18
-SCE_PL_LONGQUOTE = 19
-SCE_PL_BACKTICKS = 20
-SCE_PL_DATASECTION = 21
-SCE_PL_HERE_DELIM = 22
-SCE_PL_HERE_Q = 23
-SCE_PL_HERE_QQ = 24
-SCE_PL_HERE_QX = 25
-SCE_PL_STRING_Q = 26
-SCE_PL_STRING_QQ = 27
-SCE_PL_STRING_QX = 28
-SCE_PL_STRING_QR = 29
-SCE_PL_STRING_QW = 30
-SCE_PL_POD_VERB = 31
-SCE_PL_SUB_PROTOTYPE = 40
-SCE_PL_FORMAT_IDENT = 41
-SCE_PL_FORMAT = 42
-SCE_RB_DEFAULT = 0
-SCE_RB_ERROR = 1
-SCE_RB_COMMENTLINE = 2
-SCE_RB_POD = 3
-SCE_RB_NUMBER = 4
-SCE_RB_WORD = 5
-SCE_RB_STRING = 6
-SCE_RB_CHARACTER = 7
-SCE_RB_CLASSNAME = 8
-SCE_RB_DEFNAME = 9
-SCE_RB_OPERATOR = 10
-SCE_RB_IDENTIFIER = 11
-SCE_RB_REGEX = 12
-SCE_RB_GLOBAL = 13
-SCE_RB_SYMBOL = 14
-SCE_RB_MODULE_NAME = 15
-SCE_RB_INSTANCE_VAR = 16
-SCE_RB_CLASS_VAR = 17
-SCE_RB_BACKTICKS = 18
-SCE_RB_DATASECTION = 19
-SCE_RB_HERE_DELIM = 20
-SCE_RB_HERE_Q = 21
-SCE_RB_HERE_QQ = 22
-SCE_RB_HERE_QX = 23
-SCE_RB_STRING_Q = 24
-SCE_RB_STRING_QQ = 25
-SCE_RB_STRING_QX = 26
-SCE_RB_STRING_QR = 27
-SCE_RB_STRING_QW = 28
-SCE_RB_WORD_DEMOTED = 29
-SCE_RB_STDIN = 30
-SCE_RB_STDOUT = 31
-SCE_RB_STDERR = 40
-SCE_RB_UPPER_BOUND = 41
-SCE_B_DEFAULT = 0
-SCE_B_COMMENT = 1
-SCE_B_NUMBER = 2
-SCE_B_KEYWORD = 3
-SCE_B_STRING = 4
-SCE_B_PREPROCESSOR = 5
-SCE_B_OPERATOR = 6
-SCE_B_IDENTIFIER = 7
-SCE_B_DATE = 8
-SCE_B_STRINGEOL = 9
-SCE_B_KEYWORD2 = 10
-SCE_B_KEYWORD3 = 11
-SCE_B_KEYWORD4 = 12
-SCE_B_CONSTANT = 13
-SCE_B_ASM = 14
-SCE_B_LABEL = 15
-SCE_B_ERROR = 16
-SCE_B_HEXNUMBER = 17
-SCE_B_BINNUMBER = 18
-SCE_PROPS_DEFAULT = 0
-SCE_PROPS_COMMENT = 1
-SCE_PROPS_SECTION = 2
-SCE_PROPS_ASSIGNMENT = 3
-SCE_PROPS_DEFVAL = 4
-SCE_PROPS_KEY = 5
-SCE_L_DEFAULT = 0
-SCE_L_COMMAND = 1
-SCE_L_TAG = 2
-SCE_L_MATH = 3
-SCE_L_COMMENT = 4
-SCE_LUA_DEFAULT = 0
-SCE_LUA_COMMENT = 1
-SCE_LUA_COMMENTLINE = 2
-SCE_LUA_COMMENTDOC = 3
-SCE_LUA_NUMBER = 4
-SCE_LUA_WORD = 5
-SCE_LUA_STRING = 6
-SCE_LUA_CHARACTER = 7
-SCE_LUA_LITERALSTRING = 8
-SCE_LUA_PREPROCESSOR = 9
-SCE_LUA_OPERATOR = 10
-SCE_LUA_IDENTIFIER = 11
-SCE_LUA_STRINGEOL = 12
-SCE_LUA_WORD2 = 13
-SCE_LUA_WORD3 = 14
-SCE_LUA_WORD4 = 15
-SCE_LUA_WORD5 = 16
-SCE_LUA_WORD6 = 17
-SCE_LUA_WORD7 = 18
-SCE_LUA_WORD8 = 19
-SCE_ERR_DEFAULT = 0
-SCE_ERR_PYTHON = 1
-SCE_ERR_GCC = 2
-SCE_ERR_MS = 3
-SCE_ERR_CMD = 4
-SCE_ERR_BORLAND = 5
-SCE_ERR_PERL = 6
-SCE_ERR_NET = 7
-SCE_ERR_LUA = 8
-SCE_ERR_CTAG = 9
-SCE_ERR_DIFF_CHANGED = 10
-SCE_ERR_DIFF_ADDITION = 11
-SCE_ERR_DIFF_DELETION = 12
-SCE_ERR_DIFF_MESSAGE = 13
-SCE_ERR_PHP = 14
-SCE_ERR_ELF = 15
-SCE_ERR_IFC = 16
-SCE_ERR_IFORT = 17
-SCE_ERR_ABSF = 18
-SCE_ERR_TIDY = 19
-SCE_ERR_JAVA_STACK = 20
-SCE_ERR_VALUE = 21
-SCE_BAT_DEFAULT = 0
-SCE_BAT_COMMENT = 1
-SCE_BAT_WORD = 2
-SCE_BAT_LABEL = 3
-SCE_BAT_HIDE = 4
-SCE_BAT_COMMAND = 5
-SCE_BAT_IDENTIFIER = 6
-SCE_BAT_OPERATOR = 7
-SCE_MAKE_DEFAULT = 0
-SCE_MAKE_COMMENT = 1
-SCE_MAKE_PREPROCESSOR = 2
-SCE_MAKE_IDENTIFIER = 3
-SCE_MAKE_OPERATOR = 4
-SCE_MAKE_TARGET = 5
-SCE_MAKE_IDEOL = 9
-SCE_DIFF_DEFAULT = 0
-SCE_DIFF_COMMENT = 1
-SCE_DIFF_COMMAND = 2
-SCE_DIFF_HEADER = 3
-SCE_DIFF_POSITION = 4
-SCE_DIFF_DELETED = 5
-SCE_DIFF_ADDED = 6
-SCE_DIFF_CHANGED = 7
-SCE_CONF_DEFAULT = 0
-SCE_CONF_COMMENT = 1
-SCE_CONF_NUMBER = 2
-SCE_CONF_IDENTIFIER = 3
-SCE_CONF_EXTENSION = 4
-SCE_CONF_PARAMETER = 5
-SCE_CONF_STRING = 6
-SCE_CONF_OPERATOR = 7
-SCE_CONF_IP = 8
-SCE_CONF_DIRECTIVE = 9
-SCE_AVE_DEFAULT = 0
-SCE_AVE_COMMENT = 1
-SCE_AVE_NUMBER = 2
-SCE_AVE_WORD = 3
-SCE_AVE_STRING = 6
-SCE_AVE_ENUM = 7
-SCE_AVE_STRINGEOL = 8
-SCE_AVE_IDENTIFIER = 9
-SCE_AVE_OPERATOR = 10
-SCE_AVE_WORD1 = 11
-SCE_AVE_WORD2 = 12
-SCE_AVE_WORD3 = 13
-SCE_AVE_WORD4 = 14
-SCE_AVE_WORD5 = 15
-SCE_AVE_WORD6 = 16
-SCE_ADA_DEFAULT = 0
-SCE_ADA_WORD = 1
-SCE_ADA_IDENTIFIER = 2
-SCE_ADA_NUMBER = 3
-SCE_ADA_DELIMITER = 4
-SCE_ADA_CHARACTER = 5
-SCE_ADA_CHARACTEREOL = 6
-SCE_ADA_STRING = 7
-SCE_ADA_STRINGEOL = 8
-SCE_ADA_LABEL = 9
-SCE_ADA_COMMENTLINE = 10
-SCE_ADA_ILLEGAL = 11
-SCE_BAAN_DEFAULT = 0
-SCE_BAAN_COMMENT = 1
-SCE_BAAN_COMMENTDOC = 2
-SCE_BAAN_NUMBER = 3
-SCE_BAAN_WORD = 4
-SCE_BAAN_STRING = 5
-SCE_BAAN_PREPROCESSOR = 6
-SCE_BAAN_OPERATOR = 7
-SCE_BAAN_IDENTIFIER = 8
-SCE_BAAN_STRINGEOL = 9
-SCE_BAAN_WORD2 = 10
-SCE_LISP_DEFAULT = 0
-SCE_LISP_COMMENT = 1
-SCE_LISP_NUMBER = 2
-SCE_LISP_KEYWORD = 3
-SCE_LISP_KEYWORD_KW = 4
-SCE_LISP_SYMBOL = 5
-SCE_LISP_STRING = 6
-SCE_LISP_STRINGEOL = 8
-SCE_LISP_IDENTIFIER = 9
-SCE_LISP_OPERATOR = 10
-SCE_LISP_SPECIAL = 11
-SCE_LISP_MULTI_COMMENT = 12
-SCE_EIFFEL_DEFAULT = 0
-SCE_EIFFEL_COMMENTLINE = 1
-SCE_EIFFEL_NUMBER = 2
-SCE_EIFFEL_WORD = 3
-SCE_EIFFEL_STRING = 4
-SCE_EIFFEL_CHARACTER = 5
-SCE_EIFFEL_OPERATOR = 6
-SCE_EIFFEL_IDENTIFIER = 7
-SCE_EIFFEL_STRINGEOL = 8
-SCE_NNCRONTAB_DEFAULT = 0
-SCE_NNCRONTAB_COMMENT = 1
-SCE_NNCRONTAB_TASK = 2
-SCE_NNCRONTAB_SECTION = 3
-SCE_NNCRONTAB_KEYWORD = 4
-SCE_NNCRONTAB_MODIFIER = 5
-SCE_NNCRONTAB_ASTERISK = 6
-SCE_NNCRONTAB_NUMBER = 7
-SCE_NNCRONTAB_STRING = 8
-SCE_NNCRONTAB_ENVIRONMENT = 9
-SCE_NNCRONTAB_IDENTIFIER = 10
-SCE_FORTH_DEFAULT = 0
-SCE_FORTH_COMMENT = 1
-SCE_FORTH_COMMENT_ML = 2
-SCE_FORTH_IDENTIFIER = 3
-SCE_FORTH_CONTROL = 4
-SCE_FORTH_KEYWORD = 5
-SCE_FORTH_DEFWORD = 6
-SCE_FORTH_PREWORD1 = 7
-SCE_FORTH_PREWORD2 = 8
-SCE_FORTH_NUMBER = 9
-SCE_FORTH_STRING = 10
-SCE_FORTH_LOCALE = 11
-SCE_MATLAB_DEFAULT = 0
-SCE_MATLAB_COMMENT = 1
-SCE_MATLAB_COMMAND = 2
-SCE_MATLAB_NUMBER = 3
-SCE_MATLAB_KEYWORD = 4
-SCE_MATLAB_STRING = 5
-SCE_MATLAB_OPERATOR = 6
-SCE_MATLAB_IDENTIFIER = 7
-SCE_MATLAB_DOUBLEQUOTESTRING = 8
-SCE_SCRIPTOL_DEFAULT = 0
-SCE_SCRIPTOL_WHITE = 1
-SCE_SCRIPTOL_COMMENTLINE = 2
-SCE_SCRIPTOL_PERSISTENT = 3
-SCE_SCRIPTOL_CSTYLE = 4
-SCE_SCRIPTOL_COMMENTBLOCK = 5
-SCE_SCRIPTOL_NUMBER = 6
-SCE_SCRIPTOL_STRING = 7
-SCE_SCRIPTOL_CHARACTER = 8
-SCE_SCRIPTOL_STRINGEOL = 9
-SCE_SCRIPTOL_KEYWORD = 10
-SCE_SCRIPTOL_OPERATOR = 11
-SCE_SCRIPTOL_IDENTIFIER = 12
-SCE_SCRIPTOL_TRIPLE = 13
-SCE_SCRIPTOL_CLASSNAME = 14
-SCE_SCRIPTOL_PREPROCESSOR = 15
-SCE_ASM_DEFAULT = 0
-SCE_ASM_COMMENT = 1
-SCE_ASM_NUMBER = 2
-SCE_ASM_STRING = 3
-SCE_ASM_OPERATOR = 4
-SCE_ASM_IDENTIFIER = 5
-SCE_ASM_CPUINSTRUCTION = 6
-SCE_ASM_MATHINSTRUCTION = 7
-SCE_ASM_REGISTER = 8
-SCE_ASM_DIRECTIVE = 9
-SCE_ASM_DIRECTIVEOPERAND = 10
-SCE_ASM_COMMENTBLOCK = 11
-SCE_ASM_CHARACTER = 12
-SCE_ASM_STRINGEOL = 13
-SCE_ASM_EXTINSTRUCTION = 14
-SCE_F_DEFAULT = 0
-SCE_F_COMMENT = 1
-SCE_F_NUMBER = 2
-SCE_F_STRING1 = 3
-SCE_F_STRING2 = 4
-SCE_F_STRINGEOL = 5
-SCE_F_OPERATOR = 6
-SCE_F_IDENTIFIER = 7
-SCE_F_WORD = 8
-SCE_F_WORD2 = 9
-SCE_F_WORD3 = 10
-SCE_F_PREPROCESSOR = 11
-SCE_F_OPERATOR2 = 12
-SCE_F_LABEL = 13
-SCE_F_CONTINUATION = 14
-SCE_CSS_DEFAULT = 0
-SCE_CSS_TAG = 1
-SCE_CSS_CLASS = 2
-SCE_CSS_PSEUDOCLASS = 3
-SCE_CSS_UNKNOWN_PSEUDOCLASS = 4
-SCE_CSS_OPERATOR = 5
-SCE_CSS_IDENTIFIER = 6
-SCE_CSS_UNKNOWN_IDENTIFIER = 7
-SCE_CSS_VALUE = 8
-SCE_CSS_COMMENT = 9
-SCE_CSS_ID = 10
-SCE_CSS_IMPORTANT = 11
-SCE_CSS_DIRECTIVE = 12
-SCE_CSS_DOUBLESTRING = 13
-SCE_CSS_SINGLESTRING = 14
-SCE_CSS_IDENTIFIER2 = 15
-SCE_CSS_ATTRIBUTE = 16
-SCE_CSS_IDENTIFIER3 = 17
-SCE_CSS_PSEUDOELEMENT = 18
-SCE_CSS_EXTENDED_IDENTIFIER = 19
-SCE_CSS_EXTENDED_PSEUDOCLASS = 20
-SCE_CSS_EXTENDED_PSEUDOELEMENT = 21
-SCE_POV_DEFAULT = 0
-SCE_POV_COMMENT = 1
-SCE_POV_COMMENTLINE = 2
-SCE_POV_NUMBER = 3
-SCE_POV_OPERATOR = 4
-SCE_POV_IDENTIFIER = 5
-SCE_POV_STRING = 6
-SCE_POV_STRINGEOL = 7
-SCE_POV_DIRECTIVE = 8
-SCE_POV_BADDIRECTIVE = 9
-SCE_POV_WORD2 = 10
-SCE_POV_WORD3 = 11
-SCE_POV_WORD4 = 12
-SCE_POV_WORD5 = 13
-SCE_POV_WORD6 = 14
-SCE_POV_WORD7 = 15
-SCE_POV_WORD8 = 16
-SCE_LOUT_DEFAULT = 0
-SCE_LOUT_COMMENT = 1
-SCE_LOUT_NUMBER = 2
-SCE_LOUT_WORD = 3
-SCE_LOUT_WORD2 = 4
-SCE_LOUT_WORD3 = 5
-SCE_LOUT_WORD4 = 6
-SCE_LOUT_STRING = 7
-SCE_LOUT_OPERATOR = 8
-SCE_LOUT_IDENTIFIER = 9
-SCE_LOUT_STRINGEOL = 10
-SCE_ESCRIPT_DEFAULT = 0
-SCE_ESCRIPT_COMMENT = 1
-SCE_ESCRIPT_COMMENTLINE = 2
-SCE_ESCRIPT_COMMENTDOC = 3
-SCE_ESCRIPT_NUMBER = 4
-SCE_ESCRIPT_WORD = 5
-SCE_ESCRIPT_STRING = 6
-SCE_ESCRIPT_OPERATOR = 7
-SCE_ESCRIPT_IDENTIFIER = 8
-SCE_ESCRIPT_BRACE = 9
-SCE_ESCRIPT_WORD2 = 10
-SCE_ESCRIPT_WORD3 = 11
-SCE_PS_DEFAULT = 0
-SCE_PS_COMMENT = 1
-SCE_PS_DSC_COMMENT = 2
-SCE_PS_DSC_VALUE = 3
-SCE_PS_NUMBER = 4
-SCE_PS_NAME = 5
-SCE_PS_KEYWORD = 6
-SCE_PS_LITERAL = 7
-SCE_PS_IMMEVAL = 8
-SCE_PS_PAREN_ARRAY = 9
-SCE_PS_PAREN_DICT = 10
-SCE_PS_PAREN_PROC = 11
-SCE_PS_TEXT = 12
-SCE_PS_HEXSTRING = 13
-SCE_PS_BASE85STRING = 14
-SCE_PS_BADSTRINGCHAR = 15
-SCE_NSIS_DEFAULT = 0
-SCE_NSIS_COMMENT = 1
-SCE_NSIS_STRINGDQ = 2
-SCE_NSIS_STRINGLQ = 3
-SCE_NSIS_STRINGRQ = 4
-SCE_NSIS_FUNCTION = 5
-SCE_NSIS_VARIABLE = 6
-SCE_NSIS_LABEL = 7
-SCE_NSIS_USERDEFINED = 8
-SCE_NSIS_SECTIONDEF = 9
-SCE_NSIS_SUBSECTIONDEF = 10
-SCE_NSIS_IFDEFINEDEF = 11
-SCE_NSIS_MACRODEF = 12
-SCE_NSIS_STRINGVAR = 13
-SCE_NSIS_NUMBER = 14
-SCE_NSIS_SECTIONGROUP = 15
-SCE_NSIS_PAGEEX = 16
-SCE_NSIS_FUNCTIONDEF = 17
-SCE_NSIS_COMMENTBOX = 18
-SCE_MMIXAL_LEADWS = 0
-SCE_MMIXAL_COMMENT = 1
-SCE_MMIXAL_LABEL = 2
-SCE_MMIXAL_OPCODE = 3
-SCE_MMIXAL_OPCODE_PRE = 4
-SCE_MMIXAL_OPCODE_VALID = 5
-SCE_MMIXAL_OPCODE_UNKNOWN = 6
-SCE_MMIXAL_OPCODE_POST = 7
-SCE_MMIXAL_OPERANDS = 8
-SCE_MMIXAL_NUMBER = 9
-SCE_MMIXAL_REF = 10
-SCE_MMIXAL_CHAR = 11
-SCE_MMIXAL_STRING = 12
-SCE_MMIXAL_REGISTER = 13
-SCE_MMIXAL_HEX = 14
-SCE_MMIXAL_OPERATOR = 15
-SCE_MMIXAL_SYMBOL = 16
-SCE_MMIXAL_INCLUDE = 17
-SCE_CLW_DEFAULT = 0
-SCE_CLW_LABEL = 1
-SCE_CLW_COMMENT = 2
-SCE_CLW_STRING = 3
-SCE_CLW_USER_IDENTIFIER = 4
-SCE_CLW_INTEGER_CONSTANT = 5
-SCE_CLW_REAL_CONSTANT = 6
-SCE_CLW_PICTURE_STRING = 7
-SCE_CLW_KEYWORD = 8
-SCE_CLW_COMPILER_DIRECTIVE = 9
-SCE_CLW_RUNTIME_EXPRESSIONS = 10
-SCE_CLW_BUILTIN_PROCEDURES_FUNCTION = 11
-SCE_CLW_STRUCTURE_DATA_TYPE = 12
-SCE_CLW_ATTRIBUTE = 13
-SCE_CLW_STANDARD_EQUATE = 14
-SCE_CLW_ERROR = 15
-SCE_CLW_DEPRECATED = 16
-SCE_LOT_DEFAULT = 0
-SCE_LOT_HEADER = 1
-SCE_LOT_BREAK = 2
-SCE_LOT_SET = 3
-SCE_LOT_PASS = 4
-SCE_LOT_FAIL = 5
-SCE_LOT_ABORT = 6
-SCE_YAML_DEFAULT = 0
-SCE_YAML_COMMENT = 1
-SCE_YAML_IDENTIFIER = 2
-SCE_YAML_KEYWORD = 3
-SCE_YAML_NUMBER = 4
-SCE_YAML_REFERENCE = 5
-SCE_YAML_DOCUMENT = 6
-SCE_YAML_TEXT = 7
-SCE_YAML_ERROR = 8
-SCE_YAML_OPERATOR = 9
-SCE_TEX_DEFAULT = 0
-SCE_TEX_SPECIAL = 1
-SCE_TEX_GROUP = 2
-SCE_TEX_SYMBOL = 3
-SCE_TEX_COMMAND = 4
-SCE_TEX_TEXT = 5
-SCE_METAPOST_DEFAULT = 0
-SCE_METAPOST_SPECIAL = 1
-SCE_METAPOST_GROUP = 2
-SCE_METAPOST_SYMBOL = 3
-SCE_METAPOST_COMMAND = 4
-SCE_METAPOST_TEXT = 5
-SCE_METAPOST_EXTRA = 6
-SCE_ERLANG_DEFAULT = 0
-SCE_ERLANG_COMMENT = 1
-SCE_ERLANG_VARIABLE = 2
-SCE_ERLANG_NUMBER = 3
-SCE_ERLANG_KEYWORD = 4
-SCE_ERLANG_STRING = 5
-SCE_ERLANG_OPERATOR = 6
-SCE_ERLANG_ATOM = 7
-SCE_ERLANG_FUNCTION_NAME = 8
-SCE_ERLANG_CHARACTER = 9
-SCE_ERLANG_MACRO = 10
-SCE_ERLANG_RECORD = 11
-SCE_ERLANG_SEPARATOR = 12
-SCE_ERLANG_NODE_NAME = 13
-SCE_ERLANG_UNKNOWN = 31
-SCE_MSSQL_DEFAULT = 0
-SCE_MSSQL_COMMENT = 1
-SCE_MSSQL_LINE_COMMENT = 2
-SCE_MSSQL_NUMBER = 3
-SCE_MSSQL_STRING = 4
-SCE_MSSQL_OPERATOR = 5
-SCE_MSSQL_IDENTIFIER = 6
-SCE_MSSQL_VARIABLE = 7
-SCE_MSSQL_COLUMN_NAME = 8
-SCE_MSSQL_STATEMENT = 9
-SCE_MSSQL_DATATYPE = 10
-SCE_MSSQL_SYSTABLE = 11
-SCE_MSSQL_GLOBAL_VARIABLE = 12
-SCE_MSSQL_FUNCTION = 13
-SCE_MSSQL_STORED_PROCEDURE = 14
-SCE_MSSQL_DEFAULT_PREF_DATATYPE = 15
-SCE_MSSQL_COLUMN_NAME_2 = 16
-SCE_V_DEFAULT = 0
-SCE_V_COMMENT = 1
-SCE_V_COMMENTLINE = 2
-SCE_V_COMMENTLINEBANG = 3
-SCE_V_NUMBER = 4
-SCE_V_WORD = 5
-SCE_V_STRING = 6
-SCE_V_WORD2 = 7
-SCE_V_WORD3 = 8
-SCE_V_PREPROCESSOR = 9
-SCE_V_OPERATOR = 10
-SCE_V_IDENTIFIER = 11
-SCE_V_STRINGEOL = 12
-SCE_V_USER = 19
-SCE_KIX_DEFAULT = 0
-SCE_KIX_COMMENT = 1
-SCE_KIX_STRING1 = 2
-SCE_KIX_STRING2 = 3
-SCE_KIX_NUMBER = 4
-SCE_KIX_VAR = 5
-SCE_KIX_MACRO = 6
-SCE_KIX_KEYWORD = 7
-SCE_KIX_FUNCTIONS = 8
-SCE_KIX_OPERATOR = 9
-SCE_KIX_IDENTIFIER = 31
-SCE_GC_DEFAULT = 0
-SCE_GC_COMMENTLINE = 1
-SCE_GC_COMMENTBLOCK = 2
-SCE_GC_GLOBAL = 3
-SCE_GC_EVENT = 4
-SCE_GC_ATTRIBUTE = 5
-SCE_GC_CONTROL = 6
-SCE_GC_COMMAND = 7
-SCE_GC_STRING = 8
-SCE_GC_OPERATOR = 9
-SCE_SN_DEFAULT = 0
-SCE_SN_CODE = 1
-SCE_SN_COMMENTLINE = 2
-SCE_SN_COMMENTLINEBANG = 3
-SCE_SN_NUMBER = 4
-SCE_SN_WORD = 5
-SCE_SN_STRING = 6
-SCE_SN_WORD2 = 7
-SCE_SN_WORD3 = 8
-SCE_SN_PREPROCESSOR = 9
-SCE_SN_OPERATOR = 10
-SCE_SN_IDENTIFIER = 11
-SCE_SN_STRINGEOL = 12
-SCE_SN_REGEXTAG = 13
-SCE_SN_SIGNAL = 14
-SCE_SN_USER = 19
-SCE_AU3_DEFAULT = 0
-SCE_AU3_COMMENT = 1
-SCE_AU3_COMMENTBLOCK = 2
-SCE_AU3_NUMBER = 3
-SCE_AU3_FUNCTION = 4
-SCE_AU3_KEYWORD = 5
-SCE_AU3_MACRO = 6
-SCE_AU3_STRING = 7
-SCE_AU3_OPERATOR = 8
-SCE_AU3_VARIABLE = 9
-SCE_AU3_SENT = 10
-SCE_AU3_PREPROCESSOR = 11
-SCE_AU3_SPECIAL = 12
-SCE_AU3_EXPAND = 13
-SCE_AU3_COMOBJ = 14
-SCE_AU3_UDF = 15
-SCE_APDL_DEFAULT = 0
-SCE_APDL_COMMENT = 1
-SCE_APDL_COMMENTBLOCK = 2
-SCE_APDL_NUMBER = 3
-SCE_APDL_STRING = 4
-SCE_APDL_OPERATOR = 5
-SCE_APDL_WORD = 6
-SCE_APDL_PROCESSOR = 7
-SCE_APDL_COMMAND = 8
-SCE_APDL_SLASHCOMMAND = 9
-SCE_APDL_STARCOMMAND = 10
-SCE_APDL_ARGUMENT = 11
-SCE_APDL_FUNCTION = 12
-SCE_SH_DEFAULT = 0
-SCE_SH_ERROR = 1
-SCE_SH_COMMENTLINE = 2
-SCE_SH_NUMBER = 3
-SCE_SH_WORD = 4
-SCE_SH_STRING = 5
-SCE_SH_CHARACTER = 6
-SCE_SH_OPERATOR = 7
-SCE_SH_IDENTIFIER = 8
-SCE_SH_SCALAR = 9
-SCE_SH_PARAM = 10
-SCE_SH_BACKTICKS = 11
-SCE_SH_HERE_DELIM = 12
-SCE_SH_HERE_Q = 13
-SCE_ASN1_DEFAULT = 0
-SCE_ASN1_COMMENT = 1
-SCE_ASN1_IDENTIFIER = 2
-SCE_ASN1_STRING = 3
-SCE_ASN1_OID = 4
-SCE_ASN1_SCALAR = 5
-SCE_ASN1_KEYWORD = 6
-SCE_ASN1_ATTRIBUTE = 7
-SCE_ASN1_DESCRIPTOR = 8
-SCE_ASN1_TYPE = 9
-SCE_ASN1_OPERATOR = 10
-SCE_VHDL_DEFAULT = 0
-SCE_VHDL_COMMENT = 1
-SCE_VHDL_COMMENTLINEBANG = 2
-SCE_VHDL_NUMBER = 3
-SCE_VHDL_STRING = 4
-SCE_VHDL_OPERATOR = 5
-SCE_VHDL_IDENTIFIER = 6
-SCE_VHDL_STRINGEOL = 7
-SCE_VHDL_KEYWORD = 8
-SCE_VHDL_STDOPERATOR = 9
-SCE_VHDL_ATTRIBUTE = 10
-SCE_VHDL_STDFUNCTION = 11
-SCE_VHDL_STDPACKAGE = 12
-SCE_VHDL_STDTYPE = 13
-SCE_VHDL_USERWORD = 14
-SCE_CAML_DEFAULT = 0
-SCE_CAML_IDENTIFIER = 1
-SCE_CAML_TAGNAME = 2
-SCE_CAML_KEYWORD = 3
-SCE_CAML_KEYWORD2 = 4
-SCE_CAML_KEYWORD3 = 5
-SCE_CAML_LINENUM = 6
-SCE_CAML_OPERATOR = 7
-SCE_CAML_NUMBER = 8
-SCE_CAML_CHAR = 9
-SCE_CAML_STRING = 11
-SCE_CAML_COMMENT = 12
-SCE_CAML_COMMENT1 = 13
-SCE_CAML_COMMENT2 = 14
-SCE_CAML_COMMENT3 = 15
-SCE_HA_DEFAULT = 0
-SCE_HA_IDENTIFIER = 1
-SCE_HA_KEYWORD = 2
-SCE_HA_NUMBER = 3
-SCE_HA_STRING = 4
-SCE_HA_CHARACTER = 5
-SCE_HA_CLASS = 6
-SCE_HA_MODULE = 7
-SCE_HA_CAPITAL = 8
-SCE_HA_DATA = 9
-SCE_HA_IMPORT = 10
-SCE_HA_OPERATOR = 11
-SCE_HA_INSTANCE = 12
-SCE_HA_COMMENTLINE = 13
-SCE_HA_COMMENTBLOCK = 14
-SCE_HA_COMMENTBLOCK2 = 15
-SCE_HA_COMMENTBLOCK3 = 16
-SCE_T3_DEFAULT = 0
-SCE_T3_X_DEFAULT = 1
-SCE_T3_PREPROCESSOR = 2
-SCE_T3_BLOCK_COMMENT = 3
-SCE_T3_LINE_COMMENT = 4
-SCE_T3_OPERATOR = 5
-SCE_T3_KEYWORD = 6
-SCE_T3_NUMBER = 7
-SCE_T3_IDENTIFIER = 8
-SCE_T3_S_STRING = 9
-SCE_T3_D_STRING = 10
-SCE_T3_X_STRING = 11
-SCE_T3_LIB_DIRECTIVE = 12
-SCE_T3_MSG_PARAM = 13
-SCE_T3_HTML_TAG = 14
-SCE_T3_HTML_DEFAULT = 15
-SCE_T3_HTML_STRING = 16
-SCE_T3_USER1 = 17
-SCE_T3_USER2 = 18
-SCE_T3_USER3 = 19
-SCE_T3_BRACE = 20
-SCE_REBOL_DEFAULT = 0
-SCE_REBOL_COMMENTLINE = 1
-SCE_REBOL_COMMENTBLOCK = 2
-SCE_REBOL_PREFACE = 3
-SCE_REBOL_OPERATOR = 4
-SCE_REBOL_CHARACTER = 5
-SCE_REBOL_QUOTEDSTRING = 6
-SCE_REBOL_BRACEDSTRING = 7
-SCE_REBOL_NUMBER = 8
-SCE_REBOL_PAIR = 9
-SCE_REBOL_TUPLE = 10
-SCE_REBOL_BINARY = 11
-SCE_REBOL_MONEY = 12
-SCE_REBOL_ISSUE = 13
-SCE_REBOL_TAG = 14
-SCE_REBOL_FILE = 15
-SCE_REBOL_EMAIL = 16
-SCE_REBOL_URL = 17
-SCE_REBOL_DATE = 18
-SCE_REBOL_TIME = 19
-SCE_REBOL_IDENTIFIER = 20
-SCE_REBOL_WORD = 21
-SCE_REBOL_WORD2 = 22
-SCE_REBOL_WORD3 = 23
-SCE_REBOL_WORD4 = 24
-SCE_REBOL_WORD5 = 25
-SCE_REBOL_WORD6 = 26
-SCE_REBOL_WORD7 = 27
-SCE_REBOL_WORD8 = 28
-SCE_SQL_DEFAULT = 0
-SCE_SQL_COMMENT = 1
-SCE_SQL_COMMENTLINE = 2
-SCE_SQL_COMMENTDOC = 3
-SCE_SQL_NUMBER = 4
-SCE_SQL_WORD = 5
-SCE_SQL_STRING = 6
-SCE_SQL_CHARACTER = 7
-SCE_SQL_SQLPLUS = 8
-SCE_SQL_SQLPLUS_PROMPT = 9
-SCE_SQL_OPERATOR = 10
-SCE_SQL_IDENTIFIER = 11
-SCE_SQL_SQLPLUS_COMMENT = 13
-SCE_SQL_COMMENTLINEDOC = 15
-SCE_SQL_WORD2 = 16
-SCE_SQL_COMMENTDOCKEYWORD = 17
-SCE_SQL_COMMENTDOCKEYWORDERROR = 18
-SCE_SQL_USER1 = 19
-SCE_SQL_USER2 = 20
-SCE_SQL_USER3 = 21
-SCE_SQL_USER4 = 22
-SCE_SQL_QUOTEDIDENTIFIER = 23
-SCE_ST_DEFAULT = 0
-SCE_ST_STRING = 1
-SCE_ST_NUMBER = 2
-SCE_ST_COMMENT = 3
-SCE_ST_SYMBOL = 4
-SCE_ST_BINARY = 5
-SCE_ST_BOOL = 6
-SCE_ST_SELF = 7
-SCE_ST_SUPER = 8
-SCE_ST_NIL = 9
-SCE_ST_GLOBAL = 10
-SCE_ST_RETURN = 11
-SCE_ST_SPECIAL = 12
-SCE_ST_KWSEND = 13
-SCE_ST_ASSIGN = 14
-SCE_ST_CHARACTER = 15
-SCE_ST_SPEC_SEL = 16
-SCE_FS_DEFAULT = 0
-SCE_FS_COMMENT = 1
-SCE_FS_COMMENTLINE = 2
-SCE_FS_COMMENTDOC = 3
-SCE_FS_COMMENTLINEDOC = 4
-SCE_FS_COMMENTDOCKEYWORD = 5
-SCE_FS_COMMENTDOCKEYWORDERROR = 6
-SCE_FS_KEYWORD = 7
-SCE_FS_KEYWORD2 = 8
-SCE_FS_KEYWORD3 = 9
-SCE_FS_KEYWORD4 = 10
-SCE_FS_NUMBER = 11
-SCE_FS_STRING = 12
-SCE_FS_PREPROCESSOR = 13
-SCE_FS_OPERATOR = 14
-SCE_FS_IDENTIFIER = 15
-SCE_FS_DATE = 16
-SCE_FS_STRINGEOL = 17
-SCE_FS_CONSTANT = 18
-SCE_FS_ASM = 19
-SCE_FS_LABEL = 20
-SCE_FS_ERROR = 21
-SCE_FS_HEXNUMBER = 22
-SCE_FS_BINNUMBER = 23
-SCE_CSOUND_DEFAULT = 0
-SCE_CSOUND_COMMENT = 1
-SCE_CSOUND_NUMBER = 2
-SCE_CSOUND_OPERATOR = 3
-SCE_CSOUND_INSTR = 4
-SCE_CSOUND_IDENTIFIER = 5
-SCE_CSOUND_OPCODE = 6
-SCE_CSOUND_HEADERSTMT = 7
-SCE_CSOUND_USERKEYWORD = 8
-SCE_CSOUND_COMMENTBLOCK = 9
-SCE_CSOUND_PARAM = 10
-SCE_CSOUND_ARATE_VAR = 11
-SCE_CSOUND_KRATE_VAR = 12
-SCE_CSOUND_IRATE_VAR = 13
-SCE_CSOUND_GLOBAL_VAR = 14
-SCE_CSOUND_STRINGEOL = 15
-SCE_INNO_DEFAULT = 0
-SCE_INNO_COMMENT = 1
-SCE_INNO_KEYWORD = 2
-SCE_INNO_PARAMETER = 3
-SCE_INNO_SECTION = 4
-SCE_INNO_PREPROC = 5
-SCE_INNO_PREPROC_INLINE = 6
-SCE_INNO_COMMENT_PASCAL = 7
-SCE_INNO_KEYWORD_PASCAL = 8
-SCE_INNO_KEYWORD_USER = 9
-SCE_INNO_STRING_DOUBLE = 10
-SCE_INNO_STRING_SINGLE = 11
-SCE_INNO_IDENTIFIER = 12
-SCE_OPAL_SPACE = 0
-SCE_OPAL_COMMENT_BLOCK = 1
-SCE_OPAL_COMMENT_LINE = 2
-SCE_OPAL_INTEGER = 3
-SCE_OPAL_KEYWORD = 4
-SCE_OPAL_SORT = 5
-SCE_OPAL_STRING = 6
-SCE_OPAL_PAR = 7
-SCE_OPAL_BOOL_CONST = 8
-SCE_OPAL_DEFAULT = 32
-SCE_SPICE_DEFAULT = 0
-SCE_SPICE_IDENTIFIER = 1
-SCE_SPICE_KEYWORD = 2
-SCE_SPICE_KEYWORD2 = 3
-SCE_SPICE_KEYWORD3 = 4
-SCE_SPICE_NUMBER = 5
-SCE_SPICE_DELIMITER = 6
-SCE_SPICE_VALUE = 7
-SCE_SPICE_COMMENTLINE = 8
-SCE_CMAKE_DEFAULT = 0
-SCE_CMAKE_COMMENT = 1
-SCE_CMAKE_STRINGDQ = 2
-SCE_CMAKE_STRINGLQ = 3
-SCE_CMAKE_STRINGRQ = 4
-SCE_CMAKE_COMMANDS = 5
-SCE_CMAKE_PARAMETERS = 6
-SCE_CMAKE_VARIABLE = 7
-SCE_CMAKE_USERDEFINED = 8
-SCE_CMAKE_WHILEDEF = 9
-SCE_CMAKE_FOREACHDEF = 10
-SCE_CMAKE_IFDEFINEDEF = 11
-SCE_CMAKE_MACRODEF = 12
-SCE_CMAKE_STRINGVAR = 13
-SCE_CMAKE_NUMBER = 14
-SCE_GAP_DEFAULT = 0
-SCE_GAP_IDENTIFIER = 1
-SCE_GAP_KEYWORD = 2
-SCE_GAP_KEYWORD2 = 3
-SCE_GAP_KEYWORD3 = 4
-SCE_GAP_KEYWORD4 = 5
-SCE_GAP_STRING = 6
-SCE_GAP_CHAR = 7
-SCE_GAP_OPERATOR = 8
-SCE_GAP_COMMENT = 9
-SCE_GAP_NUMBER = 10
-SCE_GAP_STRINGEOL = 11
-SCE_PLM_DEFAULT = 0
-SCE_PLM_COMMENT = 1
-SCE_PLM_STRING = 2
-SCE_PLM_NUMBER = 3
-SCE_PLM_IDENTIFIER = 4
-SCE_PLM_OPERATOR = 5
-SCE_PLM_CONTROL = 6
-SCE_PLM_KEYWORD = 7
-SCE_4GL_DEFAULT = 0
-SCE_4GL_NUMBER = 1
-SCE_4GL_WORD = 2
-SCE_4GL_STRING = 3
-SCE_4GL_CHARACTER = 4
-SCE_4GL_PREPROCESSOR = 5
-SCE_4GL_OPERATOR = 6
-SCE_4GL_IDENTIFIER = 7
-SCE_4GL_BLOCK = 8
-SCE_4GL_END = 9
-SCE_4GL_COMMENT1 = 10
-SCE_4GL_COMMENT2 = 11
-SCE_4GL_COMMENT3 = 12
-SCE_4GL_COMMENT4 = 13
-SCE_4GL_COMMENT5 = 14
-SCE_4GL_COMMENT6 = 15
-SCE_4GL_DEFAULT_ = 16
-SCE_4GL_NUMBER_ = 17
-SCE_4GL_WORD_ = 18
-SCE_4GL_STRING_ = 19
-SCE_4GL_CHARACTER_ = 20
-SCE_4GL_PREPROCESSOR_ = 21
-SCE_4GL_OPERATOR_ = 22
-SCE_4GL_IDENTIFIER_ = 23
-SCE_4GL_BLOCK_ = 24
-SCE_4GL_END_ = 25
-SCE_4GL_COMMENT1_ = 26
-SCE_4GL_COMMENT2_ = 27
-SCE_4GL_COMMENT3_ = 28
-SCE_4GL_COMMENT4_ = 29
-SCE_4GL_COMMENT5_ = 30
-SCE_4GL_COMMENT6_ = 31
-SCE_ABAQUS_DEFAULT = 0
-SCE_ABAQUS_COMMENT = 1
-SCE_ABAQUS_COMMENTBLOCK = 2
-SCE_ABAQUS_NUMBER = 3
-SCE_ABAQUS_STRING = 4
-SCE_ABAQUS_OPERATOR = 5
-SCE_ABAQUS_WORD = 6
-SCE_ABAQUS_PROCESSOR = 7
-SCE_ABAQUS_COMMAND = 8
-SCE_ABAQUS_SLASHCOMMAND = 9
-SCE_ABAQUS_STARCOMMAND = 10
-SCE_ABAQUS_ARGUMENT = 11
-SCE_ABAQUS_FUNCTION = 12
-SCE_ASY_DEFAULT = 0
-SCE_ASY_COMMENT = 1
-SCE_ASY_COMMENTLINE = 2
-SCE_ASY_NUMBER = 3
-SCE_ASY_WORD = 4
-SCE_ASY_STRING = 5
-SCE_ASY_CHARACTER = 6
-SCE_ASY_OPERATOR = 7
-SCE_ASY_IDENTIFIER = 8
-SCE_ASY_STRINGEOL = 9
-SCE_ASY_COMMENTLINEDOC = 10
-SCE_ASY_WORD2 = 11
-SCE_R_DEFAULT = 0
-SCE_R_COMMENT = 1
-SCE_R_KWORD = 2
-SCE_R_BASEKWORD = 3
-SCE_R_OTHERKWORD = 4
-SCE_R_NUMBER = 5
-SCE_R_STRING = 6
-SCE_R_STRING2 = 7
-SCE_R_OPERATOR = 8
-SCE_R_IDENTIFIER = 9
-SCE_R_INFIX = 10
-SCE_R_INFIXEOL = 11
-SCE_MAGIK_DEFAULT = 0
-SCE_MAGIK_COMMENT = 1
-SCE_MAGIK_HYPER_COMMENT = 16
-SCE_MAGIK_STRING = 2
-SCE_MAGIK_CHARACTER = 3
-SCE_MAGIK_NUMBER = 4
-SCE_MAGIK_IDENTIFIER = 5
-SCE_MAGIK_OPERATOR = 6
-SCE_MAGIK_FLOW = 7
-SCE_MAGIK_CONTAINER = 8
-SCE_MAGIK_BRACKET_BLOCK = 9
-SCE_MAGIK_BRACE_BLOCK = 10
-SCE_MAGIK_SQBRACKET_BLOCK = 11
-SCE_MAGIK_UNKNOWN_KEYWORD = 12
-SCE_MAGIK_KEYWORD = 13
-SCE_MAGIK_PRAGMA = 14
-SCE_MAGIK_SYMBOL = 15
-SCE_POWERSHELL_DEFAULT = 0
-SCE_POWERSHELL_COMMENT = 1
-SCE_POWERSHELL_STRING = 2
-SCE_POWERSHELL_CHARACTER = 3
-SCE_POWERSHELL_NUMBER = 4
-SCE_POWERSHELL_VARIABLE = 5
-SCE_POWERSHELL_OPERATOR = 6
-SCE_POWERSHELL_IDENTIFIER = 7
-SCE_POWERSHELL_KEYWORD = 8
-SCE_POWERSHELL_CMDLET = 9
-SCE_POWERSHELL_ALIAS = 10
-SCE_MYSQL_DEFAULT = 0
-SCE_MYSQL_COMMENT = 1
-SCE_MYSQL_COMMENTLINE = 2
-SCE_MYSQL_VARIABLE = 3
-SCE_MYSQL_SYSTEMVARIABLE = 4
-SCE_MYSQL_KNOWNSYSTEMVARIABLE = 5
-SCE_MYSQL_NUMBER = 6
-SCE_MYSQL_MAJORKEYWORD = 7
-SCE_MYSQL_KEYWORD = 8
-SCE_MYSQL_DATABASEOBJECT = 9
-SCE_MYSQL_PROCEDUREKEYWORD = 10
-SCE_MYSQL_STRING = 11
-SCE_MYSQL_SQSTRING = 12
-SCE_MYSQL_DQSTRING = 13
-SCE_MYSQL_OPERATOR = 14
-SCE_MYSQL_FUNCTION = 15
-SCE_MYSQL_IDENTIFIER = 16
-SCE_MYSQL_QUOTEDIDENTIFIER = 17
-SCE_MYSQL_USER1 = 18
-SCE_MYSQL_USER2 = 19
-SCE_MYSQL_USER3 = 20
-SCE_PO_DEFAULT = 0
-SCE_PO_COMMENT = 1
-SCE_PO_MSGID = 2
-SCE_PO_MSGID_TEXT = 3
-SCE_PO_MSGSTR = 4
-SCE_PO_MSGSTR_TEXT = 5
-SCE_PO_MSGCTXT = 6
-SCE_PO_MSGCTXT_TEXT = 7
-SCE_PO_FUZZY = 8
-SCLEX_ASP = 29
-SCLEX_PHP = 30
diff --git a/lib/pythonwin/pywin/scintilla/view.py b/lib/pythonwin/pywin/scintilla/view.py
deleted file mode 100644
index 3783666f..00000000
--- a/lib/pythonwin/pywin/scintilla/view.py
+++ /dev/null
@@ -1,832 +0,0 @@
-# A general purpose MFC CCtrlView view that uses Scintilla.
-
-import array
-import os
-import re
-import string
-import struct
-import sys
-
-import __main__  # for attribute lookup
-import afxres
-import win32con
-import win32ui
-from pywin.mfc import dialog, docview
-
-from . import IDLEenvironment  # IDLE emulation.
-from . import bindings, control, keycodes, scintillacon
-
-PRINTDLGORD = 1538
-IDC_PRINT_MAG_EDIT = 1010
-EM_FORMATRANGE = win32con.WM_USER + 57
-
-wordbreaks = "._" + string.ascii_uppercase + string.ascii_lowercase + string.digits
-
-patImport = re.compile("import (?P<name>.*)")
-
-_event_commands = [
-    # File menu
-    "win32ui.ID_FILE_LOCATE",
-    "win32ui.ID_FILE_CHECK",
-    "afxres.ID_FILE_CLOSE",
-    "afxres.ID_FILE_NEW",
-    "afxres.ID_FILE_OPEN",
-    "afxres.ID_FILE_SAVE",
-    "afxres.ID_FILE_SAVE_AS",
-    "win32ui.ID_FILE_SAVE_ALL",
-    # Edit menu
-    "afxres.ID_EDIT_UNDO",
-    "afxres.ID_EDIT_REDO",
-    "afxres.ID_EDIT_CUT",
-    "afxres.ID_EDIT_COPY",
-    "afxres.ID_EDIT_PASTE",
-    "afxres.ID_EDIT_SELECT_ALL",
-    "afxres.ID_EDIT_FIND",
-    "afxres.ID_EDIT_REPEAT",
-    "afxres.ID_EDIT_REPLACE",
-    # View menu
-    "win32ui.ID_VIEW_WHITESPACE",
-    "win32ui.ID_VIEW_FIXED_FONT",
-    "win32ui.ID_VIEW_BROWSE",
-    "win32ui.ID_VIEW_INTERACTIVE",
-    # Window menu
-    "afxres.ID_WINDOW_ARRANGE",
-    "afxres.ID_WINDOW_CASCADE",
-    "afxres.ID_WINDOW_NEW",
-    "afxres.ID_WINDOW_SPLIT",
-    "afxres.ID_WINDOW_TILE_HORZ",
-    "afxres.ID_WINDOW_TILE_VERT",
-    # Others
-    "afxres.ID_APP_EXIT",
-    "afxres.ID_APP_ABOUT",
-]
-
-_extra_event_commands = [
-    ("EditDelete", afxres.ID_EDIT_CLEAR),
-    ("LocateModule", win32ui.ID_FILE_LOCATE),
-    ("GotoLine", win32ui.ID_EDIT_GOTO_LINE),
-    ("DbgBreakpointToggle", win32ui.IDC_DBG_ADD),
-    ("DbgGo", win32ui.IDC_DBG_GO),
-    ("DbgStepOver", win32ui.IDC_DBG_STEPOVER),
-    ("DbgStep", win32ui.IDC_DBG_STEP),
-    ("DbgStepOut", win32ui.IDC_DBG_STEPOUT),
-    ("DbgBreakpointClearAll", win32ui.IDC_DBG_CLEAR),
-    ("DbgClose", win32ui.IDC_DBG_CLOSE),
-]
-
-event_commands = []
-
-
-def _CreateEvents():
-    for name in _event_commands:
-        val = eval(name)
-        name_parts = name.split("_")[1:]
-        name_parts = [p.capitalize() for p in name_parts]
-        event = "".join(name_parts)
-        event_commands.append((event, val))
-    for name, id in _extra_event_commands:
-        event_commands.append((name, id))
-
-
-_CreateEvents()
-del _event_commands
-del _extra_event_commands
-
-command_reflectors = [
-    (win32ui.ID_EDIT_UNDO, win32con.WM_UNDO),
-    (win32ui.ID_EDIT_REDO, scintillacon.SCI_REDO),
-    (win32ui.ID_EDIT_CUT, win32con.WM_CUT),
-    (win32ui.ID_EDIT_COPY, win32con.WM_COPY),
-    (win32ui.ID_EDIT_PASTE, win32con.WM_PASTE),
-    (win32ui.ID_EDIT_CLEAR, win32con.WM_CLEAR),
-    (win32ui.ID_EDIT_SELECT_ALL, scintillacon.SCI_SELECTALL),
-]
-
-
-def DoBraceMatch(control):
-    curPos = control.SCIGetCurrentPos()
-    charBefore = " "
-    if curPos:
-        charBefore = control.SCIGetCharAt(curPos - 1)
-    charAt = control.SCIGetCharAt(curPos)
-    braceAtPos = braceOpposite = -1
-    if charBefore in "[](){}":
-        braceAtPos = curPos - 1
-    if braceAtPos == -1:
-        if charAt in "[](){}":
-            braceAtPos = curPos
-    if braceAtPos != -1:
-        braceOpposite = control.SCIBraceMatch(braceAtPos, 0)
-    if braceAtPos != -1 and braceOpposite == -1:
-        control.SCIBraceBadHighlight(braceAtPos)
-    else:
-        # either clear them both or set them both.
-        control.SCIBraceHighlight(braceAtPos, braceOpposite)
-
-
-def _get_class_attributes(ob):
-    # Recurse into base classes looking for attributes
-    items = []
-    try:
-        items = items + dir(ob)
-        for i in ob.__bases__:
-            for item in _get_class_attributes(i):
-                if item not in items:
-                    items.append(item)
-    except AttributeError:
-        pass
-    return items
-
-
-# Supposed to look like an MFC CEditView, but
-# also supports IDLE extensions and other source code generic features.
-class CScintillaView(docview.CtrlView, control.CScintillaColorEditInterface):
-    def __init__(self, doc):
-        docview.CtrlView.__init__(
-            self,
-            doc,
-            "Scintilla",
-            win32con.WS_CHILD
-            | win32con.WS_VSCROLL
-            | win32con.WS_HSCROLL
-            | win32con.WS_CLIPCHILDREN
-            | win32con.WS_VISIBLE,
-        )
-        self._tabWidth = (
-            8  # Mirror of what we send to Scintilla - never change this directly
-        )
-        self.bAutoCompleteAttributes = 1
-        self.bShowCallTips = 1
-        self.bMatchBraces = 0  # Editor option will default this to true later!
-        self.bindings = bindings.BindingsManager(self)
-
-        self.idle = IDLEenvironment.IDLEEditorWindow(self)
-        self.idle.IDLEExtension("AutoExpand")
-        # SendScintilla is called so frequently it is worth optimizing.
-        self.SendScintilla = self._obj_.SendMessage
-
-    def _MakeColorizer(self):
-        ext = os.path.splitext(self.GetDocument().GetPathName())[1]
-        from . import formatter
-
-        return formatter.BuiltinPythonSourceFormatter(self, ext)
-
-    # 	def SendScintilla(self, msg, w=0, l=0):
-    # 		return self._obj_.SendMessage(msg, w, l)
-
-    def SCISetTabWidth(self, width):
-        # I need to remember the tab-width for the AutoIndent extension.  This may go.
-        self._tabWidth = width
-        control.CScintillaEditInterface.SCISetTabWidth(self, width)
-
-    def GetTabWidth(self):
-        return self._tabWidth
-
-    def HookHandlers(self):
-        # Create events for all the menu names.
-        for name, val in event_commands:
-            # 			handler = lambda id, code, tosend=val, parent=parent: parent.OnCommand(tosend, 0) and 0
-            self.bindings.bind(name, None, cid=val)
-
-        # Hook commands that do nothing other than send Scintilla messages.
-        for command, reflection in command_reflectors:
-            handler = (
-                lambda id, code, ss=self.SendScintilla, tosend=reflection: ss(tosend)
-                and 0
-            )
-            self.HookCommand(handler, command)
-
-        self.HookCommand(self.OnCmdViewWS, win32ui.ID_VIEW_WHITESPACE)
-        self.HookCommandUpdate(self.OnUpdateViewWS, win32ui.ID_VIEW_WHITESPACE)
-        self.HookCommand(
-            self.OnCmdViewIndentationGuides, win32ui.ID_VIEW_INDENTATIONGUIDES
-        )
-        self.HookCommandUpdate(
-            self.OnUpdateViewIndentationGuides, win32ui.ID_VIEW_INDENTATIONGUIDES
-        )
-        self.HookCommand(self.OnCmdViewRightEdge, win32ui.ID_VIEW_RIGHT_EDGE)
-        self.HookCommandUpdate(self.OnUpdateViewRightEdge, win32ui.ID_VIEW_RIGHT_EDGE)
-        self.HookCommand(self.OnCmdViewEOL, win32ui.ID_VIEW_EOL)
-        self.HookCommandUpdate(self.OnUpdateViewEOL, win32ui.ID_VIEW_EOL)
-        self.HookCommand(self.OnCmdViewFixedFont, win32ui.ID_VIEW_FIXED_FONT)
-        self.HookCommandUpdate(self.OnUpdateViewFixedFont, win32ui.ID_VIEW_FIXED_FONT)
-        self.HookCommand(self.OnCmdFileLocate, win32ui.ID_FILE_LOCATE)
-        self.HookCommand(self.OnCmdEditFind, win32ui.ID_EDIT_FIND)
-        self.HookCommand(self.OnCmdEditRepeat, win32ui.ID_EDIT_REPEAT)
-        self.HookCommand(self.OnCmdEditReplace, win32ui.ID_EDIT_REPLACE)
-        self.HookCommand(self.OnCmdGotoLine, win32ui.ID_EDIT_GOTO_LINE)
-        self.HookCommand(self.OnFilePrint, afxres.ID_FILE_PRINT)
-        self.HookCommand(self.OnFilePrint, afxres.ID_FILE_PRINT_DIRECT)
-        self.HookCommand(self.OnFilePrintPreview, win32ui.ID_FILE_PRINT_PREVIEW)
-        # Key bindings.
-        self.HookMessage(self.OnKeyDown, win32con.WM_KEYDOWN)
-        self.HookMessage(self.OnKeyDown, win32con.WM_SYSKEYDOWN)
-        # Hook wheeley mouse events
-        # 		self.HookMessage(self.OnMouseWheel, win32con.WM_MOUSEWHEEL)
-        self.HookFormatter()
-
-    def OnInitialUpdate(self):
-        doc = self.GetDocument()
-
-        # Enable Unicode
-        self.SendScintilla(scintillacon.SCI_SETCODEPAGE, scintillacon.SC_CP_UTF8, 0)
-        self.SendScintilla(scintillacon.SCI_SETKEYSUNICODE, 1, 0)
-
-        # Create margins
-        self.SendScintilla(
-            scintillacon.SCI_SETMARGINTYPEN, 1, scintillacon.SC_MARGIN_SYMBOL
-        )
-        self.SendScintilla(scintillacon.SCI_SETMARGINMASKN, 1, 0xF)
-        self.SendScintilla(
-            scintillacon.SCI_SETMARGINTYPEN, 2, scintillacon.SC_MARGIN_SYMBOL
-        )
-        self.SendScintilla(
-            scintillacon.SCI_SETMARGINMASKN, 2, scintillacon.SC_MASK_FOLDERS
-        )
-        self.SendScintilla(scintillacon.SCI_SETMARGINSENSITIVEN, 2, 1)
-
-        self.GetDocument().HookViewNotifications(
-            self
-        )  # is there an MFC way to grab this?
-        self.HookHandlers()
-
-        # Load the configuration information.
-        self.OnWinIniChange(None)
-
-        self.SetSel()
-
-        self.GetDocument().FinalizeViewCreation(
-            self
-        )  # is there an MFC way to grab this?
-
-    def _GetSubConfigNames(self):
-        return None  # By default we use only sections without sub-sections.
-
-    def OnWinIniChange(self, section=None):
-        self.bindings.prepare_configure()
-        try:
-            self.DoConfigChange()
-        finally:
-            self.bindings.complete_configure()
-
-    def DoConfigChange(self):
-        # Bit of a hack I dont kow what to do about - these should be "editor options"
-        from pywin.framework.editor import GetEditorOption
-
-        self.bAutoCompleteAttributes = GetEditorOption("Autocomplete Attributes", 1)
-        self.bShowCallTips = GetEditorOption("Show Call Tips", 1)
-        # Update the key map and extension data.
-        configManager.configure(self, self._GetSubConfigNames())
-        if configManager.last_error:
-            win32ui.MessageBox(configManager.last_error, "Configuration Error")
-        self.bMatchBraces = GetEditorOption("Match Braces", 1)
-        self.ApplyFormattingStyles(1)
-
-    def OnDestroy(self, msg):
-        self.bindings.close()
-        self.bindings = None
-        self.idle.close()
-        self.idle = None
-        control.CScintillaColorEditInterface.close(self)
-        return docview.CtrlView.OnDestroy(self, msg)
-
-    def OnMouseWheel(self, msg):
-        zDelta = msg[2] >> 16
-        vpos = self.GetScrollPos(win32con.SB_VERT)
-        vpos = vpos - zDelta / 40  # 3 lines per notch
-        self.SetScrollPos(win32con.SB_VERT, vpos)
-        self.SendScintilla(
-            win32con.WM_VSCROLL, (vpos << 16) | win32con.SB_THUMBPOSITION, 0
-        )
-
-    def OnBraceMatch(self, std, extra):
-        if not self.bMatchBraces:
-            return
-        DoBraceMatch(self)
-
-    def OnNeedShown(self, std, extra):
-        notify = self.SCIUnpackNotifyMessage(extra)
-        # OnNeedShown is called before an edit operation when
-        # text is folded (as it is possible the text insertion will happen
-        # in a folded region.)  As this happens _before_ the insert,
-        # we ignore the length (if we are at EOF, pos + length may
-        # actually be beyond the end of buffer)
-        self.EnsureCharsVisible(notify.position)
-
-    def EnsureCharsVisible(self, start, end=None):
-        if end is None:
-            end = start
-        lineStart = self.LineFromChar(min(start, end))
-        lineEnd = self.LineFromChar(max(start, end))
-        while lineStart <= lineEnd:
-            self.SCIEnsureVisible(lineStart)
-            lineStart = lineStart + 1
-
-    # Helper to add an event to a menu.
-    def AppendMenu(self, menu, text="", event=None, flags=None, checked=0):
-        if event is None:
-            assert flags is not None, "No event or custom flags!"
-            cmdid = 0
-        else:
-            cmdid = self.bindings.get_command_id(event)
-            if cmdid is None:
-                # No event of that name - no point displaying it.
-                print(
-                    'View.AppendMenu(): Unknown event "%s" specified for menu text "%s" - ignored'
-                    % (event, text)
-                )
-                return
-            keyname = configManager.get_key_binding(event, self._GetSubConfigNames())
-            if keyname is not None:
-                text = text + "\t" + keyname
-        if flags is None:
-            flags = win32con.MF_STRING | win32con.MF_ENABLED
-        if checked:
-            flags = flags | win32con.MF_CHECKED
-        menu.AppendMenu(flags, cmdid, text)
-
-    def OnKeyDown(self, msg):
-        return self.bindings.fire_key_event(msg)
-
-    def GotoEndOfFileEvent(self, event):
-        self.SetSel(-1)
-
-    def KeyDotEvent(self, event):
-        ## Don't trigger autocomplete if any text is selected
-        s, e = self.GetSel()
-        if s != e:
-            return 1
-        self.SCIAddText(".")
-        if self.bAutoCompleteAttributes:
-            self._AutoComplete()
-
-    # View Whitespace/EOL/Indentation UI.
-
-    def OnCmdViewWS(self, cmd, code):  # Handle the menu command
-        viewWS = self.SCIGetViewWS()
-        self.SCISetViewWS(not viewWS)
-
-    def OnUpdateViewWS(self, cmdui):  # Update the tick on the UI.
-        cmdui.SetCheck(self.SCIGetViewWS())
-        cmdui.Enable()
-
-    def OnCmdViewIndentationGuides(self, cmd, code):  # Handle the menu command
-        viewIG = self.SCIGetIndentationGuides()
-        self.SCISetIndentationGuides(not viewIG)
-
-    def OnUpdateViewIndentationGuides(self, cmdui):  # Update the tick on the UI.
-        cmdui.SetCheck(self.SCIGetIndentationGuides())
-        cmdui.Enable()
-
-    def OnCmdViewRightEdge(self, cmd, code):  # Handle the menu command
-        if self.SCIGetEdgeMode() == scintillacon.EDGE_NONE:
-            mode = scintillacon.EDGE_BACKGROUND
-        else:
-            mode = scintillacon.EDGE_NONE
-        self.SCISetEdgeMode(mode)
-
-    def OnUpdateViewRightEdge(self, cmdui):  # Update the tick on the UI.
-        cmdui.SetCheck(self.SCIGetEdgeMode() != scintillacon.EDGE_NONE)
-        cmdui.Enable()
-
-    def OnCmdViewEOL(self, cmd, code):  # Handle the menu command
-        viewEOL = self.SCIGetViewEOL()
-        self.SCISetViewEOL(not viewEOL)
-
-    def OnUpdateViewEOL(self, cmdui):  # Update the tick on the UI.
-        cmdui.SetCheck(self.SCIGetViewEOL())
-        cmdui.Enable()
-
-    def OnCmdViewFixedFont(self, cmd, code):  # Handle the menu command
-        self._GetColorizer().bUseFixed = not self._GetColorizer().bUseFixed
-        self.ApplyFormattingStyles(0)
-        # Ensure the selection is visible!
-        self.ScrollCaret()
-
-    def OnUpdateViewFixedFont(self, cmdui):  # Update the tick on the UI.
-        c = self._GetColorizer()
-        if c is not None:
-            cmdui.SetCheck(c.bUseFixed)
-        cmdui.Enable(c is not None)
-
-    def OnCmdEditFind(self, cmd, code):
-        from . import find
-
-        find.ShowFindDialog()
-
-    def OnCmdEditRepeat(self, cmd, code):
-        from . import find
-
-        find.FindNext()
-
-    def OnCmdEditReplace(self, cmd, code):
-        from . import find
-
-        find.ShowReplaceDialog()
-
-    def OnCmdFileLocate(self, cmd, id):
-        line = self.GetLine().strip()
-        import pywin.framework.scriptutils
-
-        m = patImport.match(line)
-        if m:
-            # Module name on this line - locate that!
-            modName = m.group("name")
-            fileName = pywin.framework.scriptutils.LocatePythonFile(modName)
-            if fileName is None:
-                win32ui.SetStatusText("Can't locate module %s" % modName)
-                return 1  # Let the default get it.
-            else:
-                win32ui.GetApp().OpenDocumentFile(fileName)
-        else:
-            # Just to a "normal" locate - let the default handler get it.
-            return 1
-        return 0
-
-    def OnCmdGotoLine(self, cmd, id):
-        try:
-            lineNo = int(input("Enter Line Number")) - 1
-        except (ValueError, KeyboardInterrupt):
-            return 0
-        self.SCIEnsureVisible(lineNo)
-        self.SCIGotoLine(lineNo)
-        return 0
-
-    def SaveTextFile(self, filename, encoding=None):
-        doc = self.GetDocument()
-        doc._SaveTextToFile(self, filename, encoding=encoding)
-        doc.SetModifiedFlag(0)
-        return 1
-
-    def _AutoComplete(self):
-        def list2dict(l):
-            ret = {}
-            for i in l:
-                ret[i] = None
-            return ret
-
-        self.SCIAutoCCancel()  # Cancel old auto-complete lists.
-        # First try and get an object without evaluating calls
-        ob = self._GetObjectAtPos(bAllowCalls=0)
-        # If that failed, try and process call or indexing to get the object.
-        if ob is None:
-            ob = self._GetObjectAtPos(bAllowCalls=1)
-        items_dict = {}
-        if ob is not None:
-            try:  # Catch unexpected errors when fetching attribute names from the object
-                # extra attributes of win32ui objects
-                if hasattr(ob, "_obj_"):
-                    try:
-                        items_dict.update(list2dict(dir(ob._obj_)))
-                    except AttributeError:
-                        pass  # object has no __dict__
-
-                # normal attributes
-                try:
-                    items_dict.update(list2dict(dir(ob)))
-                except AttributeError:
-                    pass  # object has no __dict__
-                if hasattr(ob, "__class__"):
-                    items_dict.update(list2dict(_get_class_attributes(ob.__class__)))
-                # The object may be a COM object with typelib support - lets see if we can get its props.
-                # (contributed by Stefan Migowsky)
-                try:
-                    # Get the automation attributes
-                    items_dict.update(ob.__class__._prop_map_get_)
-                    # See if there is an write only property
-                    # could be optimized
-                    items_dict.update(ob.__class__._prop_map_put_)
-                    # append to the already evaluated list
-                except AttributeError:
-                    pass
-                # The object might be a pure COM dynamic dispatch with typelib support - lets see if we can get its props.
-                if hasattr(ob, "_oleobj_"):
-                    try:
-                        for iTI in range(0, ob._oleobj_.GetTypeInfoCount()):
-                            typeInfo = ob._oleobj_.GetTypeInfo(iTI)
-                            self._UpdateWithITypeInfo(items_dict, typeInfo)
-                    except:
-                        pass
-            except:
-                win32ui.SetStatusText(
-                    "Error attempting to get object attributes - %s"
-                    % (repr(sys.exc_info()[0]),)
-                )
-
-        # ensure all keys are strings.
-        items = [str(k) for k in items_dict.keys()]
-        # All names that start with "_" go!
-        items = [k for k in items if not k.startswith("_")]
-
-        if not items:
-            # Heuristics a-la AutoExpand
-            # The idea is to find other usages of the current binding
-            # and assume, that it refers to the same object (or at least,
-            # to an object of the same type)
-            # Contributed by Vadim Chugunov [vadimch@yahoo.com]
-            left, right = self._GetWordSplit()
-            if left == "":  # Ignore standalone dots
-                return None
-            # We limit our search to the current class, if that
-            # information is available
-            minline, maxline, curclass = self._GetClassInfoFromBrowser()
-            endpos = self.LineIndex(maxline)
-            text = self.GetTextRange(self.LineIndex(minline), endpos)
-            try:
-                l = re.findall(r"\b" + left + "\.\w+", text)
-            except re.error:
-                # parens etc may make an invalid RE, but this code wouldnt
-                # benefit even if the RE did work :-)
-                l = []
-            prefix = len(left) + 1
-            unique = {}
-            for li in l:
-                unique[li[prefix:]] = 1
-            # Assuming traditional usage of self...
-            if curclass and left == "self":
-                self._UpdateWithClassMethods(unique, curclass)
-
-            items = [
-                word for word in unique.keys() if word[:2] != "__" or word[-2:] != "__"
-            ]
-            # Ignore the word currently to the right of the dot - probably a red-herring.
-            try:
-                items.remove(right[1:])
-            except ValueError:
-                pass
-        if items:
-            items.sort()
-            self.SCIAutoCSetAutoHide(0)
-            self.SCIAutoCShow(items)
-
-    def _UpdateWithITypeInfo(self, items_dict, typeInfo):
-        import pythoncom
-
-        typeInfos = [typeInfo]
-        # suppress IDispatch and IUnknown methods
-        inspectedIIDs = {pythoncom.IID_IDispatch: None}
-
-        while len(typeInfos) > 0:
-            typeInfo = typeInfos.pop()
-            typeAttr = typeInfo.GetTypeAttr()
-
-            if typeAttr.iid not in inspectedIIDs:
-                inspectedIIDs[typeAttr.iid] = None
-                for iFun in range(0, typeAttr.cFuncs):
-                    funDesc = typeInfo.GetFuncDesc(iFun)
-                    funName = typeInfo.GetNames(funDesc.memid)[0]
-                    if funName not in items_dict:
-                        items_dict[funName] = None
-
-                # Inspect the type info of all implemented types
-                # E.g. IShellDispatch5 implements IShellDispatch4 which implements IShellDispatch3 ...
-                for iImplType in range(0, typeAttr.cImplTypes):
-                    iRefType = typeInfo.GetRefTypeOfImplType(iImplType)
-                    refTypeInfo = typeInfo.GetRefTypeInfo(iRefType)
-                    typeInfos.append(refTypeInfo)
-
-    # TODO: This is kinda slow. Probably need some kind of cache
-    # here that is flushed upon file save
-    # Or maybe we don't need the superclass methods at all ?
-    def _UpdateWithClassMethods(self, dict, classinfo):
-        if not hasattr(classinfo, "methods"):
-            # No 'methods' - probably not what we think it is.
-            return
-        dict.update(classinfo.methods)
-        for super in classinfo.super:
-            if hasattr(super, "methods"):
-                self._UpdateWithClassMethods(dict, super)
-
-    # Find which class definition caret is currently in and return
-    # indexes of the the first and the last lines of that class definition
-    # Data is obtained from module browser (if enabled)
-    def _GetClassInfoFromBrowser(self, pos=-1):
-        minline = 0
-        maxline = self.GetLineCount() - 1
-        doc = self.GetParentFrame().GetActiveDocument()
-        browser = None
-        try:
-            if doc is not None:
-                browser = doc.GetAllViews()[1]
-        except IndexError:
-            pass
-        if browser is None:
-            return (minline, maxline, None)  # Current window has no browser
-        if not browser.list:
-            return (minline, maxline, None)  # Not initialized
-        path = self.GetDocument().GetPathName()
-        if not path:
-            return (minline, maxline, None)  # No current path
-
-        import pywin.framework.scriptutils
-
-        curmodule, path = pywin.framework.scriptutils.GetPackageModuleName(path)
-        try:
-            clbrdata = browser.list.root.clbrdata
-        except AttributeError:
-            return (minline, maxline, None)  # No class data for this module.
-        curline = self.LineFromChar(pos)
-        curclass = None
-        # Find out which class we are in
-        for item in clbrdata.values():
-            if item.module == curmodule:
-                item_lineno = (
-                    item.lineno - 1
-                )  # Scintilla counts lines from 0, whereas pyclbr - from 1
-                if minline < item_lineno <= curline:
-                    minline = item_lineno
-                    curclass = item
-                if curline < item_lineno < maxline:
-                    maxline = item_lineno
-        return (minline, maxline, curclass)
-
-    def _GetObjectAtPos(self, pos=-1, bAllowCalls=0):
-        left, right = self._GetWordSplit(pos, bAllowCalls)
-        if left:  # It is an attribute lookup
-            # How is this for a hack!
-            namespace = sys.modules.copy()
-            namespace.update(__main__.__dict__)
-            # Get the debugger's context.
-            try:
-                from pywin.framework import interact
-
-                if interact.edit is not None and interact.edit.currentView is not None:
-                    globs, locs = interact.edit.currentView.GetContext()[:2]
-                    if globs:
-                        namespace.update(globs)
-                    if locs:
-                        namespace.update(locs)
-            except ImportError:
-                pass
-            try:
-                return eval(left, namespace)
-            except:
-                pass
-        return None
-
-    def _GetWordSplit(self, pos=-1, bAllowCalls=0):
-        if pos == -1:
-            pos = self.GetSel()[0] - 1  # Character before current one
-        limit = self.GetTextLength()
-        before = []
-        after = []
-        index = pos - 1
-        wordbreaks_use = wordbreaks
-        if bAllowCalls:
-            wordbreaks_use = wordbreaks_use + "()[]"
-        while index >= 0:
-            char = self.SCIGetCharAt(index)
-            if char not in wordbreaks_use:
-                break
-            before.insert(0, char)
-            index = index - 1
-        index = pos
-        while index <= limit:
-            char = self.SCIGetCharAt(index)
-            if char not in wordbreaks_use:
-                break
-            after.append(char)
-            index = index + 1
-        return "".join(before), "".join(after)
-
-    def OnPrepareDC(self, dc, pInfo):
-        # 		print "OnPrepareDC for page", pInfo.GetCurPage(), "of", pInfo.GetFromPage(), "to", pInfo.GetToPage(), ", starts=", self.starts
-        if dc.IsPrinting():
-            # Check if we are beyond the end.
-            # (only do this when actually printing, else messes up print preview!)
-            if not pInfo.GetPreview() and self.starts is not None:
-                prevPage = pInfo.GetCurPage() - 1
-                if prevPage > 0 and self.starts[prevPage] >= self.GetTextLength():
-                    # All finished.
-                    pInfo.SetContinuePrinting(0)
-                    return
-            dc.SetMapMode(win32con.MM_TEXT)
-
-    def OnPreparePrinting(self, pInfo):
-        flags = (
-            win32ui.PD_USEDEVMODECOPIES | win32ui.PD_ALLPAGES | win32ui.PD_NOSELECTION
-        )  # Dont support printing just a selection.
-        # NOTE: Custom print dialogs are stopping the user's values from coming back :-(
-        # 		self.prtDlg = PrintDialog(pInfo, PRINTDLGORD, flags)
-        # 		pInfo.SetPrintDialog(self.prtDlg)
-        pInfo.SetMinPage(1)
-        # max page remains undefined for now.
-        pInfo.SetFromPage(1)
-        pInfo.SetToPage(1)
-        ret = self.DoPreparePrinting(pInfo)
-        return ret
-
-    def OnBeginPrinting(self, dc, pInfo):
-        self.starts = None
-        return self._obj_.OnBeginPrinting(dc, pInfo)
-
-    def CalculatePageRanges(self, dc, pInfo):
-        # Calculate page ranges and max page
-        self.starts = {0: 0}
-        metrics = dc.GetTextMetrics()
-        left, top, right, bottom = pInfo.GetDraw()
-        # Leave space at the top for the header.
-        rc = (left, top + int((9 * metrics["tmHeight"]) / 2), right, bottom)
-        pageStart = 0
-        maxPage = 0
-        textLen = self.GetTextLength()
-        while pageStart < textLen:
-            pageStart = self.FormatRange(dc, pageStart, textLen, rc, 0)
-            maxPage = maxPage + 1
-            self.starts[maxPage] = pageStart
-        # And a sentinal for one page past the end
-        self.starts[maxPage + 1] = textLen
-        # When actually printing, maxPage doesnt have any effect at this late state.
-        # but is needed to make the Print Preview work correctly.
-        pInfo.SetMaxPage(maxPage)
-
-    def OnFilePrintPreview(self, *arg):
-        self._obj_.OnFilePrintPreview()
-
-    def OnFilePrint(self, *arg):
-        self._obj_.OnFilePrint()
-
-    def FormatRange(self, dc, pageStart, lengthDoc, rc, draw):
-        """
-        typedef struct _formatrange {
-                HDC hdc;
-                HDC hdcTarget;
-                RECT rc;
-                RECT rcPage;
-                CHARRANGE chrg;} FORMATRANGE;
-        """
-        fmt = "PPIIIIIIIIll"
-        hdcRender = dc.GetHandleOutput()
-        hdcFormat = dc.GetHandleAttrib()
-        fr = struct.pack(
-            fmt,
-            hdcRender,
-            hdcFormat,
-            rc[0],
-            rc[1],
-            rc[2],
-            rc[3],
-            rc[0],
-            rc[1],
-            rc[2],
-            rc[3],
-            pageStart,
-            lengthDoc,
-        )
-        nextPageStart = self.SendScintilla(EM_FORMATRANGE, draw, fr)
-        return nextPageStart
-
-    def OnPrint(self, dc, pInfo):
-        metrics = dc.GetTextMetrics()
-        # 		print "dev", w, h, l, metrics['tmAscent'], metrics['tmDescent']
-        if self.starts is None:
-            self.CalculatePageRanges(dc, pInfo)
-        pageNum = pInfo.GetCurPage() - 1
-        # Setup the header of the page - docname on left, pagenum on right.
-        doc = self.GetDocument()
-        cxChar = metrics["tmAveCharWidth"]
-        cyChar = metrics["tmHeight"]
-        left, top, right, bottom = pInfo.GetDraw()
-        dc.TextOut(0, 2 * cyChar, doc.GetTitle())
-        pagenum_str = win32ui.LoadString(afxres.AFX_IDS_PRINTPAGENUM) % (pageNum + 1,)
-        dc.SetTextAlign(win32con.TA_RIGHT)
-        dc.TextOut(right, 2 * cyChar, pagenum_str)
-        dc.SetTextAlign(win32con.TA_LEFT)
-        top = top + int((7 * cyChar) / 2)
-        dc.MoveTo(left, top)
-        dc.LineTo(right, top)
-        top = top + cyChar
-        rc = (left, top, right, bottom)
-        nextPageStart = self.FormatRange(
-            dc, self.starts[pageNum], self.starts[pageNum + 1], rc, 1
-        )
-
-
-def LoadConfiguration():
-    global configManager
-    # Bit of a hack I dont kow what to do about?
-    from .config import ConfigManager
-
-    configName = rc = win32ui.GetProfileVal("Editor", "Keyboard Config", "default")
-    configManager = ConfigManager(configName)
-    if configManager.last_error:
-        bTryDefault = 0
-        msg = "Error loading configuration '%s'\n\n%s" % (
-            configName,
-            configManager.last_error,
-        )
-        if configName != "default":
-            msg = msg + "\n\nThe default configuration will be loaded."
-            bTryDefault = 1
-        win32ui.MessageBox(msg)
-        if bTryDefault:
-            configManager = ConfigManager("default")
-            if configManager.last_error:
-                win32ui.MessageBox(
-                    "Error loading configuration 'default'\n\n%s"
-                    % (configManager.last_error)
-                )
-
-
-configManager = None
-LoadConfiguration()
diff --git a/lib/pythonwin/pywin/tools/TraceCollector.py b/lib/pythonwin/pywin/tools/TraceCollector.py
deleted file mode 100644
index 5800488b..00000000
--- a/lib/pythonwin/pywin/tools/TraceCollector.py
+++ /dev/null
@@ -1,79 +0,0 @@
-# win32traceutil like utility for Pythonwin
-import _thread
-
-import win32api
-import win32event
-import win32trace
-from pywin.framework import winout
-
-outputWindow = None
-
-
-def CollectorThread(stopEvent, file):
-    win32trace.InitRead()
-    handle = win32trace.GetHandle()
-    # Run this thread at a lower priority to the main message-loop (and printing output)
-    # thread can keep up
-    import win32process
-
-    win32process.SetThreadPriority(
-        win32api.GetCurrentThread(), win32process.THREAD_PRIORITY_BELOW_NORMAL
-    )
-
-    try:
-        while 1:
-            rc = win32event.WaitForMultipleObjects(
-                (handle, stopEvent), 0, win32event.INFINITE
-            )
-            if rc == win32event.WAIT_OBJECT_0:
-                # About the only char we can't live with is \0!
-                file.write(win32trace.read().replace("\0", "<null>"))
-            else:
-                # Stop event
-                break
-    finally:
-        win32trace.TermRead()
-        print("Thread dieing")
-
-
-class WindowOutput(winout.WindowOutput):
-    def __init__(self, *args):
-        winout.WindowOutput.__init__(*(self,) + args)
-        self.hStopThread = win32event.CreateEvent(None, 0, 0, None)
-        _thread.start_new(CollectorThread, (self.hStopThread, self))
-
-    def _StopThread(self):
-        win32event.SetEvent(self.hStopThread)
-        self.hStopThread = None
-
-    def Close(self):
-        self._StopThread()
-        winout.WindowOutput.Close(self)
-        # 	def OnViewDestroy(self, frame):
-        # 		return winout.WindowOutput.OnViewDestroy(self, frame)
-        # 	def Create(self, title=None, style = None):
-        # 		rc = winout.WindowOutput.Create(self, title, style)
-        return rc
-
-
-def MakeOutputWindow():
-    # Note that it will not show until the first string written or
-    # you pass bShow = 1
-    global outputWindow
-    if outputWindow is None:
-        title = "Python Trace Collector"
-        # queueingFlag doesnt matter, as all output will come from new thread
-        outputWindow = WindowOutput(title, title)
-        # Let people know what this does!
-        msg = """\
-# This window will display output from any programs that import win32traceutil
-# win32com servers registered with '--debug' are in this category.
-"""
-        outputWindow.write(msg)
-    # force existing window open
-    outputWindow.write("")
-    return outputWindow
-
-
-if __name__ == "__main__":
-    MakeOutputWindow()
diff --git a/lib/pythonwin/pywin/tools/__init__.py b/lib/pythonwin/pywin/tools/__init__.py
deleted file mode 100644
index 8b137891..00000000
--- a/lib/pythonwin/pywin/tools/__init__.py
+++ /dev/null
@@ -1 +0,0 @@
-
diff --git a/lib/pythonwin/pywin/tools/browseProjects.py b/lib/pythonwin/pywin/tools/browseProjects.py
deleted file mode 100644
index e3255579..00000000
--- a/lib/pythonwin/pywin/tools/browseProjects.py
+++ /dev/null
@@ -1,324 +0,0 @@
-import glob
-import os
-import pyclbr
-
-import afxres
-import commctrl
-import pywin.framework.scriptutils
-import regutil
-import win32api
-import win32con
-import win32ui
-from pywin.mfc import dialog
-
-from . import hierlist
-
-
-class HLIErrorItem(hierlist.HierListItem):
-    def __init__(self, text):
-        self.text = text
-        hierlist.HierListItem.__init__(self)
-
-    def GetText(self):
-        return self.text
-
-
-class HLICLBRItem(hierlist.HierListItem):
-    def __init__(self, name, file, lineno, suffix=""):
-        # If the 'name' object itself has a .name, use it.  Not sure
-        # how this happens, but seems pyclbr related.
-        # See PyWin32 bug 817035
-        self.name = getattr(name, "name", name)
-        self.file = file
-        self.lineno = lineno
-        self.suffix = suffix
-
-    def __lt__(self, other):
-        return self.name < other.name
-
-    def __eq__(self, other):
-        return self.name == other.name
-
-    def GetText(self):
-        return self.name + self.suffix
-
-    def TakeDefaultAction(self):
-        if self.file:
-            pywin.framework.scriptutils.JumpToDocument(
-                self.file, self.lineno, bScrollToTop=1
-            )
-        else:
-            win32ui.SetStatusText("The source of this object is unknown")
-
-    def PerformItemSelected(self):
-        if self.file is None:
-            msg = "%s - source can not be located." % (self.name,)
-        else:
-            msg = "%s defined at line %d of %s" % (self.name, self.lineno, self.file)
-        win32ui.SetStatusText(msg)
-
-
-class HLICLBRClass(HLICLBRItem):
-    def __init__(self, clbrclass, suffix=""):
-        try:
-            name = clbrclass.name
-            file = clbrclass.file
-            lineno = clbrclass.lineno
-            self.super = clbrclass.super
-            self.methods = clbrclass.methods
-        except AttributeError:
-            name = clbrclass
-            file = lineno = None
-            self.super = []
-            self.methods = {}
-        HLICLBRItem.__init__(self, name, file, lineno, suffix)
-
-    def GetSubList(self):
-        ret = []
-        for c in self.super:
-            ret.append(HLICLBRClass(c, " (Parent class)"))
-        for meth, lineno in self.methods.items():
-            ret.append(HLICLBRMethod(meth, self.file, lineno, " (method)"))
-        return ret
-
-    def IsExpandable(self):
-        return len(self.methods) + len(self.super)
-
-    def GetBitmapColumn(self):
-        return 21
-
-
-class HLICLBRFunction(HLICLBRClass):
-    def GetBitmapColumn(self):
-        return 22
-
-
-class HLICLBRMethod(HLICLBRItem):
-    def GetBitmapColumn(self):
-        return 22
-
-
-class HLIModuleItem(hierlist.HierListItem):
-    def __init__(self, path):
-        hierlist.HierListItem.__init__(self)
-        self.path = path
-
-    def GetText(self):
-        return os.path.split(self.path)[1] + " (module)"
-
-    def IsExpandable(self):
-        return 1
-
-    def TakeDefaultAction(self):
-        win32ui.GetApp().OpenDocumentFile(self.path)
-
-    def GetBitmapColumn(self):
-        col = 4  # Default
-        try:
-            if win32api.GetFileAttributes(self.path) & win32con.FILE_ATTRIBUTE_READONLY:
-                col = 5
-        except win32api.error:
-            pass
-        return col
-
-    def GetSubList(self):
-        mod, path = pywin.framework.scriptutils.GetPackageModuleName(self.path)
-        win32ui.SetStatusText("Building class list - please wait...", 1)
-        win32ui.DoWaitCursor(1)
-        try:
-            try:
-                reader = pyclbr.readmodule_ex  # Post 1.5.2 interface.
-                extra_msg = " or functions"
-            except AttributeError:
-                reader = pyclbr.readmodule
-                extra_msg = ""
-            data = reader(mod, [path])
-            if data:
-                ret = []
-                for item in data.values():
-                    if (
-                        item.__class__ != pyclbr.Class
-                    ):  # ie, it is a pyclbr Function instance (only introduced post 1.5.2)
-                        ret.append(HLICLBRFunction(item, " (function)"))
-                    else:
-                        ret.append(HLICLBRClass(item, " (class)"))
-                ret.sort()
-                return ret
-            else:
-                return [HLIErrorItem("No Python classes%s in module." % (extra_msg,))]
-        finally:
-            win32ui.DoWaitCursor(0)
-            win32ui.SetStatusText(win32ui.LoadString(afxres.AFX_IDS_IDLEMESSAGE))
-
-
-def MakePathSubList(path):
-    ret = []
-    for filename in glob.glob(os.path.join(path, "*")):
-        if os.path.isdir(filename) and os.path.isfile(
-            os.path.join(filename, "__init__.py")
-        ):
-            ret.append(HLIDirectoryItem(filename, os.path.split(filename)[1]))
-        else:
-            if os.path.splitext(filename)[1].lower() in [".py", ".pyw"]:
-                ret.append(HLIModuleItem(filename))
-    return ret
-
-
-class HLIDirectoryItem(hierlist.HierListItem):
-    def __init__(self, path, displayName=None, bSubDirs=0):
-        hierlist.HierListItem.__init__(self)
-        self.path = path
-        self.bSubDirs = bSubDirs
-        if displayName:
-            self.displayName = displayName
-        else:
-            self.displayName = path
-
-    def IsExpandable(self):
-        return 1
-
-    def GetText(self):
-        return self.displayName
-
-    def GetSubList(self):
-        ret = MakePathSubList(self.path)
-        if (
-            os.path.split(self.path)[1] == "win32com"
-        ):  # Complete and utter hack for win32com.
-            try:
-                path = win32api.GetFullPathName(
-                    os.path.join(self.path, "..\\win32comext")
-                )
-                ret = ret + MakePathSubList(path)
-            except win32ui.error:
-                pass
-        return ret
-
-
-class HLIProjectRoot(hierlist.HierListItem):
-    def __init__(self, projectName, displayName=None):
-        hierlist.HierListItem.__init__(self)
-        self.projectName = projectName
-        self.displayName = displayName or projectName
-
-    def GetText(self):
-        return self.displayName
-
-    def IsExpandable(self):
-        return 1
-
-    def GetSubList(self):
-        paths = regutil.GetRegisteredNamedPath(self.projectName)
-        pathList = paths.split(";")
-        if len(pathList) == 1:  # Single dir - dont bother putting the dir in
-            ret = MakePathSubList(pathList[0])
-        else:
-            ret = list(map(HLIDirectoryItem, pathList))
-        return ret
-
-
-class HLIRoot(hierlist.HierListItem):
-    def __init__(self):
-        hierlist.HierListItem.__init__(self)
-
-    def IsExpandable(self):
-        return 1
-
-    def GetSubList(self):
-        keyStr = regutil.BuildDefaultPythonKey() + "\\PythonPath"
-        hKey = win32api.RegOpenKey(regutil.GetRootKey(), keyStr)
-        try:
-            ret = []
-            ret.append(HLIProjectRoot("", "Standard Python Library"))  # The core path.
-            index = 0
-            while 1:
-                try:
-                    ret.append(HLIProjectRoot(win32api.RegEnumKey(hKey, index)))
-                    index = index + 1
-                except win32api.error:
-                    break
-            return ret
-        finally:
-            win32api.RegCloseKey(hKey)
-
-
-class dynamic_browser(dialog.Dialog):
-    style = win32con.WS_OVERLAPPEDWINDOW | win32con.WS_VISIBLE
-    cs = (
-        win32con.WS_CHILD
-        | win32con.WS_VISIBLE
-        | commctrl.TVS_HASLINES
-        | commctrl.TVS_LINESATROOT
-        | commctrl.TVS_HASBUTTONS
-    )
-
-    dt = [
-        ["Python Projects", (0, 0, 200, 200), style, None, (8, "MS Sans Serif")],
-        ["SysTreeView32", None, win32ui.IDC_LIST1, (0, 0, 200, 200), cs],
-    ]
-
-    def __init__(self, hli_root):
-        dialog.Dialog.__init__(self, self.dt)
-        self.hier_list = hierlist.HierListWithItems(hli_root, win32ui.IDB_BROWSER_HIER)
-        self.HookMessage(self.on_size, win32con.WM_SIZE)
-
-    def OnInitDialog(self):
-        self.hier_list.HierInit(self)
-        return dialog.Dialog.OnInitDialog(self)
-
-    def on_size(self, params):
-        lparam = params[3]
-        w = win32api.LOWORD(lparam)
-        h = win32api.HIWORD(lparam)
-        self.GetDlgItem(win32ui.IDC_LIST1).MoveWindow((0, 0, w, h))
-
-
-def BrowseDialog():
-    root = HLIRoot()
-    if not root.IsExpandable():
-        raise TypeError(
-            "Browse() argument must have __dict__ attribute, or be a Browser supported type"
-        )
-
-    dlg = dynamic_browser(root)
-    dlg.CreateWindow()
-
-
-def DockableBrowserCreator(parent):
-    root = HLIRoot()
-    hl = hierlist.HierListWithItems(root, win32ui.IDB_BROWSER_HIER)
-
-    style = (
-        win32con.WS_CHILD
-        | win32con.WS_VISIBLE
-        | win32con.WS_BORDER
-        | commctrl.TVS_HASLINES
-        | commctrl.TVS_LINESATROOT
-        | commctrl.TVS_HASBUTTONS
-    )
-
-    control = win32ui.CreateTreeCtrl()
-    control.CreateWindow(style, (0, 0, 150, 300), parent, win32ui.IDC_LIST1)
-    list = hl.HierInit(parent, control)
-    return control
-
-
-def DockablePathBrowser():
-    import pywin.docking.DockingBar
-
-    bar = pywin.docking.DockingBar.DockingBar()
-    bar.CreateWindow(
-        win32ui.GetMainFrame(), DockableBrowserCreator, "Path Browser", 0x8E0A
-    )
-    bar.SetBarStyle(
-        bar.GetBarStyle()
-        | afxres.CBRS_TOOLTIPS
-        | afxres.CBRS_FLYBY
-        | afxres.CBRS_SIZE_DYNAMIC
-    )
-    bar.EnableDocking(afxres.CBRS_ALIGN_ANY)
-    win32ui.GetMainFrame().DockControlBar(bar)
-
-
-# The "default" entry point
-Browse = DockablePathBrowser
diff --git a/lib/pythonwin/pywin/tools/browser.py b/lib/pythonwin/pywin/tools/browser.py
deleted file mode 100644
index 9d9a193d..00000000
--- a/lib/pythonwin/pywin/tools/browser.py
+++ /dev/null
@@ -1,517 +0,0 @@
-# basic module browser.
-
-# usage:
-# >>> import browser
-# >>> browser.Browse()
-# or
-# >>> browser.Browse(your_module)
-import sys
-import types
-
-import __main__
-import win32ui
-from pywin.mfc import dialog
-
-from . import hierlist
-
-special_names = ["__doc__", "__name__", "__self__"]
-
-
-#
-# HierList items
-class HLIPythonObject(hierlist.HierListItem):
-    def __init__(self, myobject=None, name=None):
-        hierlist.HierListItem.__init__(self)
-        self.myobject = myobject
-        self.knownExpandable = None
-        if name:
-            self.name = name
-        else:
-            try:
-                self.name = myobject.__name__
-            except (AttributeError, TypeError):
-                try:
-                    r = repr(myobject)
-                    if len(r) > 20:
-                        r = r[:20] + "..."
-                    self.name = r
-                except (AttributeError, TypeError):
-                    self.name = "???"
-
-    def __lt__(self, other):
-        return self.name < other.name
-
-    def __eq__(self, other):
-        return self.name == other.name
-
-    def __repr__(self):
-        try:
-            type = self.GetHLIType()
-        except:
-            type = "Generic"
-        return (
-            "HLIPythonObject("
-            + type
-            + ") - name: "
-            + self.name
-            + " object: "
-            + repr(self.myobject)
-        )
-
-    def GetText(self):
-        try:
-            return str(self.name) + " (" + self.GetHLIType() + ")"
-        except AttributeError:
-            return str(self.name) + " = " + repr(self.myobject)
-
-    def InsertDocString(self, lst):
-        ob = None
-        try:
-            ob = self.myobject.__doc__
-        except (AttributeError, TypeError):
-            pass
-        # I don't quite grok descriptors enough to know how to
-        # best hook them up. Eg:
-        # >>> object.__getattribute__.__class__.__doc__
-        # <attribute '__doc__' of 'wrapper_descriptor' objects>
-        if ob and isinstance(ob, str):
-            lst.insert(0, HLIDocString(ob, "Doc"))
-
-    def GetSubList(self):
-        ret = []
-        try:
-            for key, ob in self.myobject.__dict__.items():
-                if key not in special_names:
-                    ret.append(MakeHLI(ob, key))
-        except (AttributeError, TypeError):
-            pass
-        try:
-            for name in self.myobject.__methods__:
-                ret.append(HLIMethod(name))  # no MakeHLI, as cant auto detect
-        except (AttributeError, TypeError):
-            pass
-        try:
-            for member in self.myobject.__members__:
-                if not member in special_names:
-                    ret.append(MakeHLI(getattr(self.myobject, member), member))
-        except (AttributeError, TypeError):
-            pass
-        ret.sort()
-        self.InsertDocString(ret)
-        return ret
-
-    # if the has a dict, it is expandable.
-    def IsExpandable(self):
-        if self.knownExpandable is None:
-            self.knownExpandable = self.CalculateIsExpandable()
-        return self.knownExpandable
-
-    def CalculateIsExpandable(self):
-        if hasattr(self.myobject, "__doc__"):
-            return 1
-        try:
-            for key in self.myobject.__dict__.keys():
-                if key not in special_names:
-                    return 1
-        except (AttributeError, TypeError):
-            pass
-        try:
-            self.myobject.__methods__
-            return 1
-        except (AttributeError, TypeError):
-            pass
-        try:
-            for item in self.myobject.__members__:
-                if item not in special_names:
-                    return 1
-        except (AttributeError, TypeError):
-            pass
-        return 0
-
-    def GetBitmapColumn(self):
-        if self.IsExpandable():
-            return 0
-        else:
-            return 4
-
-    def TakeDefaultAction(self):
-        ShowObject(self.myobject, self.name)
-
-
-class HLIDocString(HLIPythonObject):
-    def GetHLIType(self):
-        return "DocString"
-
-    def GetText(self):
-        return self.myobject.strip()
-
-    def IsExpandable(self):
-        return 0
-
-    def GetBitmapColumn(self):
-        return 6
-
-
-class HLIModule(HLIPythonObject):
-    def GetHLIType(self):
-        return "Module"
-
-
-class HLIFrame(HLIPythonObject):
-    def GetHLIType(self):
-        return "Stack Frame"
-
-
-class HLITraceback(HLIPythonObject):
-    def GetHLIType(self):
-        return "Traceback"
-
-
-class HLIClass(HLIPythonObject):
-    def GetHLIType(self):
-        return "Class"
-
-    def GetSubList(self):
-        ret = []
-        for base in self.myobject.__bases__:
-            ret.append(MakeHLI(base, "Base class: " + base.__name__))
-        ret = ret + HLIPythonObject.GetSubList(self)
-        return ret
-
-
-class HLIMethod(HLIPythonObject):
-    # myobject is just a string for methods.
-    def GetHLIType(self):
-        return "Method"
-
-    def GetText(self):
-        return "Method: " + self.myobject + "()"
-
-
-class HLICode(HLIPythonObject):
-    def GetHLIType(self):
-        return "Code"
-
-    def IsExpandable(self):
-        return self.myobject
-
-    def GetSubList(self):
-        ret = []
-        ret.append(MakeHLI(self.myobject.co_consts, "Constants (co_consts)"))
-        ret.append(MakeHLI(self.myobject.co_names, "Names (co_names)"))
-        ret.append(MakeHLI(self.myobject.co_filename, "Filename (co_filename)"))
-        ret.append(MakeHLI(self.myobject.co_argcount, "Number of args (co_argcount)"))
-        ret.append(MakeHLI(self.myobject.co_varnames, "Param names (co_varnames)"))
-
-        return ret
-
-
-class HLIInstance(HLIPythonObject):
-    def GetHLIType(self):
-        return "Instance"
-
-    def GetText(self):
-        return (
-            str(self.name)
-            + " (Instance of class "
-            + str(self.myobject.__class__.__name__)
-            + ")"
-        )
-
-    def IsExpandable(self):
-        return 1
-
-    def GetSubList(self):
-        ret = []
-        ret.append(MakeHLI(self.myobject.__class__))
-        ret = ret + HLIPythonObject.GetSubList(self)
-        return ret
-
-
-class HLIBuiltinFunction(HLIPythonObject):
-    def GetHLIType(self):
-        return "Builtin Function"
-
-
-class HLIFunction(HLIPythonObject):
-    def GetHLIType(self):
-        return "Function"
-
-    def IsExpandable(self):
-        return 1
-
-    def GetSubList(self):
-        ret = []
-        # 		ret.append( MakeHLI( self.myobject.func_argcount, "Arg Count" ))
-        try:
-            ret.append(MakeHLI(self.myobject.func_argdefs, "Arg Defs"))
-        except AttributeError:
-            pass
-        try:
-            code = self.myobject.__code__
-            globs = self.myobject.__globals__
-        except AttributeError:
-            # must be py2.5 or earlier...
-            code = self.myobject.func_code
-            globs = self.myobject.func_globals
-        ret.append(MakeHLI(code, "Code"))
-        ret.append(MakeHLI(globs, "Globals"))
-        self.InsertDocString(ret)
-        return ret
-
-
-class HLISeq(HLIPythonObject):
-    def GetHLIType(self):
-        return "Sequence (abstract!)"
-
-    def IsExpandable(self):
-        return len(self.myobject) > 0
-
-    def GetSubList(self):
-        ret = []
-        pos = 0
-        for item in self.myobject:
-            ret.append(MakeHLI(item, "[" + str(pos) + "]"))
-            pos = pos + 1
-        self.InsertDocString(ret)
-        return ret
-
-
-class HLIList(HLISeq):
-    def GetHLIType(self):
-        return "List"
-
-
-class HLITuple(HLISeq):
-    def GetHLIType(self):
-        return "Tuple"
-
-
-class HLIDict(HLIPythonObject):
-    def GetHLIType(self):
-        return "Dict"
-
-    def IsExpandable(self):
-        try:
-            self.myobject.__doc__
-            return 1
-        except (AttributeError, TypeError):
-            return len(self.myobject) > 0
-
-    def GetSubList(self):
-        ret = []
-        keys = list(self.myobject.keys())
-        keys.sort()
-        for key in keys:
-            ob = self.myobject[key]
-            ret.append(MakeHLI(ob, str(key)))
-        self.InsertDocString(ret)
-        return ret
-
-
-# In Python 1.6, strings and Unicode have builtin methods, but we dont really want to see these
-class HLIString(HLIPythonObject):
-    def IsExpandable(self):
-        return 0
-
-
-TypeMap = {
-    type: HLIClass,
-    types.FunctionType: HLIFunction,
-    tuple: HLITuple,
-    dict: HLIDict,
-    list: HLIList,
-    types.ModuleType: HLIModule,
-    types.CodeType: HLICode,
-    types.BuiltinFunctionType: HLIBuiltinFunction,
-    types.FrameType: HLIFrame,
-    types.TracebackType: HLITraceback,
-    str: HLIString,
-    int: HLIPythonObject,
-    bool: HLIPythonObject,
-    float: HLIPythonObject,
-}
-
-
-def MakeHLI(ob, name=None):
-    try:
-        cls = TypeMap[type(ob)]
-    except KeyError:
-        # hrmph - this check gets more and more bogus as Python
-        # improves.  Its possible we should just *always* use
-        # HLIInstance?
-        if hasattr(ob, "__class__"):  # 'new style' class
-            cls = HLIInstance
-        else:
-            cls = HLIPythonObject
-    return cls(ob, name)
-
-
-#########################################
-#
-# Dialog related.
-
-
-class DialogShowObject(dialog.Dialog):
-    def __init__(self, object, title):
-        self.object = object
-        self.title = title
-        dialog.Dialog.__init__(self, win32ui.IDD_LARGE_EDIT)
-
-    def OnInitDialog(self):
-        import re
-
-        self.SetWindowText(self.title)
-        self.edit = self.GetDlgItem(win32ui.IDC_EDIT1)
-        try:
-            strval = str(self.object)
-        except:
-            t, v, tb = sys.exc_info()
-            strval = "Exception getting object value\n\n%s:%s" % (t, v)
-            tb = None
-        strval = re.sub("\n", "\r\n", strval)
-        self.edit.ReplaceSel(strval)
-
-
-def ShowObject(object, title):
-    dlg = DialogShowObject(object, title)
-    dlg.DoModal()
-
-
-# And some mods for a sizable dialog from Sam Rushing!
-import commctrl
-import win32api
-import win32con
-
-
-class dynamic_browser(dialog.Dialog):
-    style = win32con.WS_OVERLAPPEDWINDOW | win32con.WS_VISIBLE
-    cs = (
-        win32con.WS_CHILD
-        | win32con.WS_VISIBLE
-        | commctrl.TVS_HASLINES
-        | commctrl.TVS_LINESATROOT
-        | commctrl.TVS_HASBUTTONS
-    )
-
-    dt = [
-        ["Python Object Browser", (0, 0, 200, 200), style, None, (8, "MS Sans Serif")],
-        ["SysTreeView32", None, win32ui.IDC_LIST1, (0, 0, 200, 200), cs],
-    ]
-
-    def __init__(self, hli_root):
-        dialog.Dialog.__init__(self, self.dt)
-        self.hier_list = hierlist.HierListWithItems(hli_root, win32ui.IDB_BROWSER_HIER)
-        self.HookMessage(self.on_size, win32con.WM_SIZE)
-
-    def OnInitDialog(self):
-        self.hier_list.HierInit(self)
-        return dialog.Dialog.OnInitDialog(self)
-
-    def OnOK(self):
-        self.hier_list.HierTerm()
-        self.hier_list = None
-        return self._obj_.OnOK()
-
-    def OnCancel(self):
-        self.hier_list.HierTerm()
-        self.hier_list = None
-        return self._obj_.OnCancel()
-
-    def on_size(self, params):
-        lparam = params[3]
-        w = win32api.LOWORD(lparam)
-        h = win32api.HIWORD(lparam)
-        self.GetDlgItem(win32ui.IDC_LIST1).MoveWindow((0, 0, w, h))
-
-
-def Browse(ob=__main__):
-    "Browse the argument, or the main dictionary"
-    root = MakeHLI(ob, "root")
-    if not root.IsExpandable():
-        raise TypeError(
-            "Browse() argument must have __dict__ attribute, or be a Browser supported type"
-        )
-
-    dlg = dynamic_browser(root)
-    dlg.CreateWindow()
-    return dlg
-
-
-#
-#
-# Classes for using the browser in an MDI window, rather than a dialog
-#
-from pywin.mfc import docview
-
-
-class BrowserTemplate(docview.DocTemplate):
-    def __init__(self):
-        docview.DocTemplate.__init__(
-            self, win32ui.IDR_PYTHONTYPE, BrowserDocument, None, BrowserView
-        )
-
-    def OpenObject(self, root):  # Use this instead of OpenDocumentFile.
-        # Look for existing open document
-        for doc in self.GetDocumentList():
-            if doc.root == root:
-                doc.GetFirstView().ActivateFrame()
-                return doc
-        # not found - new one.
-        doc = BrowserDocument(self, root)
-        frame = self.CreateNewFrame(doc)
-        doc.OnNewDocument()
-        self.InitialUpdateFrame(frame, doc, 1)
-        return doc
-
-
-class BrowserDocument(docview.Document):
-    def __init__(self, template, root):
-        docview.Document.__init__(self, template)
-        self.root = root
-        self.SetTitle("Browser: " + root.name)
-
-    def OnOpenDocument(self, name):
-        raise TypeError("This template can not open files")
-        return 0
-
-
-class BrowserView(docview.TreeView):
-    def OnInitialUpdate(self):
-        import commctrl
-
-        rc = self._obj_.OnInitialUpdate()
-        list = hierlist.HierListWithItems(
-            self.GetDocument().root,
-            win32ui.IDB_BROWSER_HIER,
-            win32ui.AFX_IDW_PANE_FIRST,
-        )
-        list.HierInit(self.GetParent())
-        list.SetStyle(
-            commctrl.TVS_HASLINES | commctrl.TVS_LINESATROOT | commctrl.TVS_HASBUTTONS
-        )
-        return rc
-
-
-template = None
-
-
-def MakeTemplate():
-    global template
-    if template is None:
-        template = (
-            BrowserTemplate()
-        )  # win32ui.IDR_PYTHONTYPE, BrowserDocument, None, BrowserView)
-
-
-def BrowseMDI(ob=__main__):
-    """Browse an object using an MDI window."""
-
-    MakeTemplate()
-    root = MakeHLI(ob, repr(ob))
-    if not root.IsExpandable():
-        raise TypeError(
-            "Browse() argument must have __dict__ attribute, or be a Browser supported type"
-        )
-
-    template.OpenObject(root)
diff --git a/lib/pythonwin/pywin/tools/hierlist.py b/lib/pythonwin/pywin/tools/hierlist.py
deleted file mode 100644
index a60b7324..00000000
--- a/lib/pythonwin/pywin/tools/hierlist.py
+++ /dev/null
@@ -1,367 +0,0 @@
-# hierlist
-#
-# IMPORTANT - Please read before using.
-
-# This module exposes an API for a Hierarchical Tree Control.
-# Previously, a custom tree control was included in Pythonwin which
-# has an API very similar to this.
-
-# The current control used is the common "Tree Control".  This module exists now
-# to provide an API similar to the old control, but for the new Tree control.
-
-# If you need to use the Tree Control, you may still find this API a reasonable
-# choice.  However, you should investigate using the tree control directly
-# to provide maximum flexibility (but with extra work).
-
-import sys
-
-import commctrl
-import win32api
-import win32con
-import win32ui
-from pywin.mfc import dialog, docview, object, window
-from win32api import RGB
-
-
-# helper to get the text of an arbitary item
-def GetItemText(item):
-    if type(item) == type(()) or type(item) == type([]):
-        use = item[0]
-    else:
-        use = item
-    if type(use) == type(""):
-        return use
-    else:
-        return repr(item)
-
-
-class HierDialog(dialog.Dialog):
-    def __init__(
-        self,
-        title,
-        hierList,
-        bitmapID=win32ui.IDB_HIERFOLDERS,
-        dlgID=win32ui.IDD_TREE,
-        dll=None,
-        childListBoxID=win32ui.IDC_LIST1,
-    ):
-        dialog.Dialog.__init__(self, dlgID, dll)  # reuse this dialog.
-        self.hierList = hierList
-        self.dlgID = dlgID
-        self.title = title
-
-    # 		self.childListBoxID = childListBoxID
-    def OnInitDialog(self):
-        self.SetWindowText(self.title)
-        self.hierList.HierInit(self)
-        return dialog.Dialog.OnInitDialog(self)
-
-
-class HierList(object.Object):
-    def __init__(
-        self, root, bitmapID=win32ui.IDB_HIERFOLDERS, listBoxId=None, bitmapMask=None
-    ):  # used to create object.
-        self.listControl = None
-        self.bitmapID = bitmapID
-        self.root = root
-        self.listBoxId = listBoxId
-        self.itemHandleMap = {}
-        self.filledItemHandlesMap = {}
-        self.bitmapMask = bitmapMask
-
-    def __getattr__(self, attr):
-        try:
-            return getattr(self.listControl, attr)
-        except AttributeError:
-            return object.Object.__getattr__(self, attr)
-
-    def ItemFromHandle(self, handle):
-        return self.itemHandleMap[handle]
-
-    def SetStyle(self, newStyle):
-        hwnd = self.listControl.GetSafeHwnd()
-        style = win32api.GetWindowLong(hwnd, win32con.GWL_STYLE)
-        win32api.SetWindowLong(hwnd, win32con.GWL_STYLE, (style | newStyle))
-
-    def HierInit(self, parent, listControl=None):  # Used when window first exists.
-        # this also calls "Create" on the listbox.
-        # params - id of listbbox, ID of bitmap, size of bitmaps
-        if self.bitmapMask is None:
-            bitmapMask = RGB(0, 0, 255)
-        else:
-            bitmapMask = self.bitmapMask
-        self.imageList = win32ui.CreateImageList(self.bitmapID, 16, 0, bitmapMask)
-        if listControl is None:
-            if self.listBoxId is None:
-                self.listBoxId = win32ui.IDC_LIST1
-            self.listControl = parent.GetDlgItem(self.listBoxId)
-        else:
-            self.listControl = listControl
-            lbid = listControl.GetDlgCtrlID()
-            assert self.listBoxId is None or self.listBoxId == lbid, (
-                "An invalid listbox control ID has been specified (specified as %s, but exists as %s)"
-                % (self.listBoxId, lbid)
-            )
-            self.listBoxId = lbid
-        self.listControl.SetImageList(self.imageList, commctrl.LVSIL_NORMAL)
-        # 		self.list.AttachObject(self)
-
-        ## ??? Need a better way to do this - either some way to detect if it's compiled with UNICODE
-        ##  defined, and/or a way to switch the constants based on UNICODE ???
-        if sys.version_info[0] < 3:
-            parent.HookNotify(self.OnTreeItemExpanding, commctrl.TVN_ITEMEXPANDINGA)
-            parent.HookNotify(self.OnTreeItemSelChanged, commctrl.TVN_SELCHANGEDA)
-        else:
-            parent.HookNotify(self.OnTreeItemExpanding, commctrl.TVN_ITEMEXPANDINGW)
-            parent.HookNotify(self.OnTreeItemSelChanged, commctrl.TVN_SELCHANGEDW)
-        parent.HookNotify(self.OnTreeItemDoubleClick, commctrl.NM_DBLCLK)
-        self.notify_parent = parent
-
-        if self.root:
-            self.AcceptRoot(self.root)
-
-    def DeleteAllItems(self):
-        self.listControl.DeleteAllItems()
-        self.root = None
-        self.itemHandleMap = {}
-        self.filledItemHandlesMap = {}
-
-    def HierTerm(self):
-        # Dont want notifies as we kill the list.
-        parent = self.notify_parent  # GetParentFrame()
-        if sys.version_info[0] < 3:
-            parent.HookNotify(None, commctrl.TVN_ITEMEXPANDINGA)
-            parent.HookNotify(None, commctrl.TVN_SELCHANGEDA)
-        else:
-            parent.HookNotify(None, commctrl.TVN_ITEMEXPANDINGW)
-            parent.HookNotify(None, commctrl.TVN_SELCHANGEDW)
-        parent.HookNotify(None, commctrl.NM_DBLCLK)
-
-        self.DeleteAllItems()
-        self.listControl = None
-        self.notify_parent = None  # Break a possible cycle
-
-    def OnTreeItemDoubleClick(self, info, extra):
-        (hwndFrom, idFrom, code) = info
-        if idFrom != self.listBoxId:
-            return None
-        item = self.itemHandleMap[self.listControl.GetSelectedItem()]
-        self.TakeDefaultAction(item)
-        return 1
-
-    def OnTreeItemExpanding(self, info, extra):
-        (hwndFrom, idFrom, code) = info
-        if idFrom != self.listBoxId:
-            return None
-        action, itemOld, itemNew, pt = extra
-        itemHandle = itemNew[0]
-        if itemHandle not in self.filledItemHandlesMap:
-            item = self.itemHandleMap[itemHandle]
-            self.AddSubList(itemHandle, self.GetSubList(item))
-            self.filledItemHandlesMap[itemHandle] = None
-        return 0
-
-    def OnTreeItemSelChanged(self, info, extra):
-        (hwndFrom, idFrom, code) = info
-        if idFrom != self.listBoxId:
-            return None
-        action, itemOld, itemNew, pt = extra
-        itemHandle = itemNew[0]
-        item = self.itemHandleMap[itemHandle]
-        self.PerformItemSelected(item)
-        return 1
-
-    def AddSubList(self, parentHandle, subItems):
-        for item in subItems:
-            self.AddItem(parentHandle, item)
-
-    def AddItem(self, parentHandle, item, hInsertAfter=commctrl.TVI_LAST):
-        text = self.GetText(item)
-        if self.IsExpandable(item):
-            cItems = 1  # Trick it !!
-        else:
-            cItems = 0
-        bitmapCol = self.GetBitmapColumn(item)
-        bitmapSel = self.GetSelectedBitmapColumn(item)
-        if bitmapSel is None:
-            bitmapSel = bitmapCol
-        ## if type(text) is str:
-        ##	text = text.encode("mbcs")
-        hitem = self.listControl.InsertItem(
-            parentHandle,
-            hInsertAfter,
-            (None, None, None, text, bitmapCol, bitmapSel, cItems, 0),
-        )
-        self.itemHandleMap[hitem] = item
-        return hitem
-
-    def _GetChildHandles(self, handle):
-        ret = []
-        try:
-            handle = self.listControl.GetChildItem(handle)
-            while 1:
-                ret.append(handle)
-                handle = self.listControl.GetNextItem(handle, commctrl.TVGN_NEXT)
-        except win32ui.error:
-            # out of children
-            pass
-        return ret
-
-    def Refresh(self, hparent=None):
-        # Attempt to refresh the given item's sub-entries, but maintain the tree state
-        # (ie, the selected item, expanded items, etc)
-        if hparent is None:
-            hparent = commctrl.TVI_ROOT
-        if hparent not in self.filledItemHandlesMap:
-            # This item has never been expanded, so no refresh can possibly be required.
-            return
-        root_item = self.itemHandleMap[hparent]
-        old_handles = self._GetChildHandles(hparent)
-        old_items = list(map(self.ItemFromHandle, old_handles))
-        new_items = self.GetSubList(root_item)
-        # Now an inefficient technique for synching the items.
-        inew = 0
-        hAfter = commctrl.TVI_FIRST
-        for iold in range(len(old_items)):
-            inewlook = inew
-            matched = 0
-            while inewlook < len(new_items):
-                if old_items[iold] == new_items[inewlook]:
-                    matched = 1
-                    break
-                inewlook = inewlook + 1
-            if matched:
-                # Insert the new items.
-                # 				print "Inserting after", old_items[iold], old_handles[iold]
-                for i in range(inew, inewlook):
-                    # 					print "Inserting index %d (%s)" % (i, new_items[i])
-                    hAfter = self.AddItem(hparent, new_items[i], hAfter)
-
-                inew = inewlook + 1
-                # And recursively refresh iold
-                hold = old_handles[iold]
-                if hold in self.filledItemHandlesMap:
-                    self.Refresh(hold)
-            else:
-                # Remove the deleted items.
-                # 				print "Deleting %d (%s)" % (iold, old_items[iold])
-                hdelete = old_handles[iold]
-                # First recurse and remove the children from the map.
-                for hchild in self._GetChildHandles(hdelete):
-                    del self.itemHandleMap[hchild]
-                    if hchild in self.filledItemHandlesMap:
-                        del self.filledItemHandlesMap[hchild]
-                self.listControl.DeleteItem(hdelete)
-            hAfter = old_handles[iold]
-        # Fill any remaining new items:
-        for newItem in new_items[inew:]:
-            # 			print "Inserting new item", newItem
-            self.AddItem(hparent, newItem)
-
-    def AcceptRoot(self, root):
-        self.listControl.DeleteAllItems()
-        self.itemHandleMap = {commctrl.TVI_ROOT: root}
-        self.filledItemHandlesMap = {commctrl.TVI_ROOT: root}
-        subItems = self.GetSubList(root)
-        self.AddSubList(0, subItems)
-
-    def GetBitmapColumn(self, item):
-        if self.IsExpandable(item):
-            return 0
-        else:
-            return 4
-
-    def GetSelectedBitmapColumn(self, item):
-        return 0
-
-    def CheckChangedChildren(self):
-        return self.listControl.CheckChangedChildren()
-
-    def GetText(self, item):
-        return GetItemText(item)
-
-    def PerformItemSelected(self, item):
-        try:
-            win32ui.SetStatusText("Selected " + self.GetText(item))
-        except win32ui.error:  # No status bar!
-            pass
-
-    def TakeDefaultAction(self, item):
-        win32ui.MessageBox("Got item " + self.GetText(item))
-
-
-##########################################################################
-#
-# Classes for use with seperate HierListItems.
-#
-#
-class HierListWithItems(HierList):
-    def __init__(
-        self, root, bitmapID=win32ui.IDB_HIERFOLDERS, listBoxID=None, bitmapMask=None
-    ):  # used to create object.
-        HierList.__init__(self, root, bitmapID, listBoxID, bitmapMask)
-
-    def DelegateCall(self, fn):
-        return fn()
-
-    def GetBitmapColumn(self, item):
-        rc = self.DelegateCall(item.GetBitmapColumn)
-        if rc is None:
-            rc = HierList.GetBitmapColumn(self, item)
-        return rc
-
-    def GetSelectedBitmapColumn(self, item):
-        return self.DelegateCall(item.GetSelectedBitmapColumn)
-
-    def IsExpandable(self, item):
-        return self.DelegateCall(item.IsExpandable)
-
-    def GetText(self, item):
-        return self.DelegateCall(item.GetText)
-
-    def GetSubList(self, item):
-        return self.DelegateCall(item.GetSubList)
-
-    def PerformItemSelected(self, item):
-        func = getattr(item, "PerformItemSelected", None)
-        if func is None:
-            return HierList.PerformItemSelected(self, item)
-        else:
-            return self.DelegateCall(func)
-
-    def TakeDefaultAction(self, item):
-        func = getattr(item, "TakeDefaultAction", None)
-        if func is None:
-            return HierList.TakeDefaultAction(self, item)
-        else:
-            return self.DelegateCall(func)
-
-
-# A hier list item - for use with a HierListWithItems
-class HierListItem:
-    def __init__(self):
-        pass
-
-    def GetText(self):
-        pass
-
-    def GetSubList(self):
-        pass
-
-    def IsExpandable(self):
-        pass
-
-    def GetBitmapColumn(self):
-        return None  # indicate he should do it.
-
-    def GetSelectedBitmapColumn(self):
-        return None  # same as other
-
-    # for py3k/rich-comp sorting compatibility.
-    def __lt__(self, other):
-        # we want unrelated items to be sortable...
-        return id(self) < id(other)
-
-    # for py3k/rich-comp equality compatibility.
-    def __eq__(self, other):
-        return False
diff --git a/lib/pythonwin/pywin/tools/regedit.py b/lib/pythonwin/pywin/tools/regedit.py
deleted file mode 100644
index b94d3050..00000000
--- a/lib/pythonwin/pywin/tools/regedit.py
+++ /dev/null
@@ -1,386 +0,0 @@
-# Regedit - a Registry Editor for Python
-
-import commctrl
-import regutil
-import win32api
-import win32con
-import win32ui
-from pywin.mfc import dialog, docview, window
-
-from . import hierlist
-
-
-def SafeApply(fn, args, err_desc=""):
-    try:
-        fn(*args)
-        return 1
-    except win32api.error as exc:
-        msg = "Error " + err_desc + "\r\n\r\n" + exc.strerror
-        win32ui.MessageBox(msg)
-        return 0
-
-
-class SplitterFrame(window.MDIChildWnd):
-    def __init__(self):
-        # call base CreateFrame
-        self.images = None
-        window.MDIChildWnd.__init__(self)
-
-    def OnCreateClient(self, cp, context):
-        splitter = win32ui.CreateSplitter()
-        doc = context.doc
-        frame_rect = self.GetWindowRect()
-        size = ((frame_rect[2] - frame_rect[0]), (frame_rect[3] - frame_rect[1]) // 2)
-        sub_size = (size[0] // 3, size[1])
-        splitter.CreateStatic(self, 1, 2)
-        # CTreeControl view
-        self.keysview = RegistryTreeView(doc)
-        # CListControl view
-        self.valuesview = RegistryValueView(doc)
-
-        splitter.CreatePane(self.keysview, 0, 0, (sub_size))
-        splitter.CreatePane(self.valuesview, 0, 1, (0, 0))  # size ignored.
-        splitter.SetRowInfo(0, size[1], 0)
-        # Setup items in the imagelist
-
-        return 1
-
-    def OnItemDoubleClick(self, info, extra):
-        (hwndFrom, idFrom, code) = info
-        if idFrom == win32ui.AFX_IDW_PANE_FIRST:
-            # Tree control
-            return None
-        elif idFrom == win32ui.AFX_IDW_PANE_FIRST + 1:
-            item = self.keysview.SelectedItem()
-            self.valuesview.EditValue(item)
-            return 0
-            # List control
-        else:
-            return None  # Pass it on
-
-    def PerformItemSelected(self, item):
-        return self.valuesview.UpdateForRegItem(item)
-
-    def OnDestroy(self, msg):
-        window.MDIChildWnd.OnDestroy(self, msg)
-        if self.images:
-            self.images.DeleteImageList()
-            self.images = None
-
-
-class RegistryTreeView(docview.TreeView):
-    def OnInitialUpdate(self):
-        rc = self._obj_.OnInitialUpdate()
-        self.frame = self.GetParent().GetParent()
-        self.hierList = hierlist.HierListWithItems(
-            self.GetHLIRoot(), win32ui.IDB_HIERFOLDERS, win32ui.AFX_IDW_PANE_FIRST
-        )
-        self.hierList.HierInit(self.frame, self.GetTreeCtrl())
-        self.hierList.SetStyle(
-            commctrl.TVS_HASLINES | commctrl.TVS_LINESATROOT | commctrl.TVS_HASBUTTONS
-        )
-        self.hierList.PerformItemSelected = self.PerformItemSelected
-
-        self.frame.HookNotify(self.frame.OnItemDoubleClick, commctrl.NM_DBLCLK)
-        self.frame.HookNotify(self.OnItemRightClick, commctrl.NM_RCLICK)
-
-    # 		self.HookMessage(self.OnItemRightClick, win32con.WM_RBUTTONUP)
-
-    def GetHLIRoot(self):
-        doc = self.GetDocument()
-        regroot = doc.root
-        subkey = doc.subkey
-        return HLIRegistryKey(regroot, subkey, "Root")
-
-    def OnItemRightClick(self, notify_data, extra):
-        # First select the item we right-clicked on.
-        pt = self.ScreenToClient(win32api.GetCursorPos())
-        flags, hItem = self.HitTest(pt)
-        if hItem == 0 or commctrl.TVHT_ONITEM & flags == 0:
-            return None
-        self.Select(hItem, commctrl.TVGN_CARET)
-
-        menu = win32ui.CreatePopupMenu()
-        menu.AppendMenu(win32con.MF_STRING | win32con.MF_ENABLED, 1000, "Add Key")
-        menu.AppendMenu(win32con.MF_STRING | win32con.MF_ENABLED, 1001, "Add Value")
-        menu.AppendMenu(win32con.MF_STRING | win32con.MF_ENABLED, 1002, "Delete Key")
-        self.HookCommand(self.OnAddKey, 1000)
-        self.HookCommand(self.OnAddValue, 1001)
-        self.HookCommand(self.OnDeleteKey, 1002)
-        menu.TrackPopupMenu(win32api.GetCursorPos())  # track at mouse position.
-        return None
-
-    def OnDeleteKey(self, command, code):
-        hitem = self.hierList.GetSelectedItem()
-        item = self.hierList.ItemFromHandle(hitem)
-        msg = "Are you sure you wish to delete the key '%s'?" % (item.keyName,)
-        id = win32ui.MessageBox(msg, None, win32con.MB_YESNO)
-        if id != win32con.IDYES:
-            return
-        if SafeApply(
-            win32api.RegDeleteKey, (item.keyRoot, item.keyName), "deleting registry key"
-        ):
-            # Get the items parent.
-            try:
-                hparent = self.GetParentItem(hitem)
-            except win32ui.error:
-                hparent = None
-            self.hierList.Refresh(hparent)
-
-    def OnAddKey(self, command, code):
-        from pywin.mfc import dialog
-
-        val = dialog.GetSimpleInput("New key name", "", "Add new key")
-        if val is None:
-            return  # cancelled.
-        hitem = self.hierList.GetSelectedItem()
-        item = self.hierList.ItemFromHandle(hitem)
-        if SafeApply(win32api.RegCreateKey, (item.keyRoot, item.keyName + "\\" + val)):
-            self.hierList.Refresh(hitem)
-
-    def OnAddValue(self, command, code):
-        from pywin.mfc import dialog
-
-        val = dialog.GetSimpleInput("New value", "", "Add new value")
-        if val is None:
-            return  # cancelled.
-        hitem = self.hierList.GetSelectedItem()
-        item = self.hierList.ItemFromHandle(hitem)
-        if SafeApply(
-            win32api.RegSetValue, (item.keyRoot, item.keyName, win32con.REG_SZ, val)
-        ):
-            # Simply re-select the current item to refresh the right spitter.
-            self.PerformItemSelected(item)
-
-    # 			self.Select(hitem, commctrl.TVGN_CARET)
-
-    def PerformItemSelected(self, item):
-        return self.frame.PerformItemSelected(item)
-
-    def SelectedItem(self):
-        return self.hierList.ItemFromHandle(self.hierList.GetSelectedItem())
-
-    def SearchSelectedItem(self):
-        handle = self.hierList.GetChildItem(0)
-        while 1:
-            # 			print "State is", self.hierList.GetItemState(handle, -1)
-            if self.hierList.GetItemState(handle, commctrl.TVIS_SELECTED):
-                # 				print "Item is ", self.hierList.ItemFromHandle(handle)
-                return self.hierList.ItemFromHandle(handle)
-            handle = self.hierList.GetNextSiblingItem(handle)
-
-
-class RegistryValueView(docview.ListView):
-    def OnInitialUpdate(self):
-        hwnd = self._obj_.GetSafeHwnd()
-        style = win32api.GetWindowLong(hwnd, win32con.GWL_STYLE)
-        win32api.SetWindowLong(
-            hwnd,
-            win32con.GWL_STYLE,
-            (style & ~commctrl.LVS_TYPEMASK) | commctrl.LVS_REPORT,
-        )
-
-        itemDetails = (commctrl.LVCFMT_LEFT, 100, "Name", 0)
-        self.InsertColumn(0, itemDetails)
-        itemDetails = (commctrl.LVCFMT_LEFT, 500, "Data", 0)
-        self.InsertColumn(1, itemDetails)
-
-    def UpdateForRegItem(self, item):
-        self.DeleteAllItems()
-        hkey = win32api.RegOpenKey(item.keyRoot, item.keyName)
-        try:
-            valNum = 0
-            ret = []
-            while 1:
-                try:
-                    res = win32api.RegEnumValue(hkey, valNum)
-                except win32api.error:
-                    break
-                name = res[0]
-                if not name:
-                    name = "(Default)"
-                self.InsertItem(valNum, name)
-                self.SetItemText(valNum, 1, str(res[1]))
-                valNum = valNum + 1
-        finally:
-            win32api.RegCloseKey(hkey)
-
-    def EditValue(self, item):
-        # Edit the current value
-        class EditDialog(dialog.Dialog):
-            def __init__(self, item):
-                self.item = item
-                dialog.Dialog.__init__(self, win32ui.IDD_LARGE_EDIT)
-
-            def OnInitDialog(self):
-                self.SetWindowText("Enter new value")
-                self.GetDlgItem(win32con.IDCANCEL).ShowWindow(win32con.SW_SHOW)
-                self.edit = self.GetDlgItem(win32ui.IDC_EDIT1)
-                # Modify the edit windows style
-                style = win32api.GetWindowLong(
-                    self.edit.GetSafeHwnd(), win32con.GWL_STYLE
-                )
-                style = style & (~win32con.ES_WANTRETURN)
-                win32api.SetWindowLong(
-                    self.edit.GetSafeHwnd(), win32con.GWL_STYLE, style
-                )
-                self.edit.SetWindowText(str(self.item))
-                self.edit.SetSel(-1)
-                return dialog.Dialog.OnInitDialog(self)
-
-            def OnDestroy(self, msg):
-                self.newvalue = self.edit.GetWindowText()
-
-        try:
-            index = self.GetNextItem(-1, commctrl.LVNI_SELECTED)
-        except win32ui.error:
-            return  # No item selected.
-
-        if index == 0:
-            keyVal = ""
-        else:
-            keyVal = self.GetItemText(index, 0)
-        # Query for a new value.
-        try:
-            newVal = self.GetItemsCurrentValue(item, keyVal)
-        except TypeError as details:
-            win32ui.MessageBox(details)
-            return
-
-        d = EditDialog(newVal)
-        if d.DoModal() == win32con.IDOK:
-            try:
-                self.SetItemsCurrentValue(item, keyVal, d.newvalue)
-            except win32api.error as exc:
-                win32ui.MessageBox("Error setting value\r\n\n%s" % exc.strerror)
-            self.UpdateForRegItem(item)
-
-    def GetItemsCurrentValue(self, item, valueName):
-        hkey = win32api.RegOpenKey(item.keyRoot, item.keyName)
-        try:
-            val, type = win32api.RegQueryValueEx(hkey, valueName)
-            if type != win32con.REG_SZ:
-                raise TypeError("Only strings can be edited")
-            return val
-        finally:
-            win32api.RegCloseKey(hkey)
-
-    def SetItemsCurrentValue(self, item, valueName, value):
-        # ** Assumes already checked is a string.
-        hkey = win32api.RegOpenKey(
-            item.keyRoot, item.keyName, 0, win32con.KEY_SET_VALUE
-        )
-        try:
-            win32api.RegSetValueEx(hkey, valueName, 0, win32con.REG_SZ, value)
-        finally:
-            win32api.RegCloseKey(hkey)
-
-
-class RegTemplate(docview.DocTemplate):
-    def __init__(self):
-        docview.DocTemplate.__init__(
-            self, win32ui.IDR_PYTHONTYPE, None, SplitterFrame, None
-        )
-
-    # 	def InitialUpdateFrame(self, frame, doc, makeVisible=1):
-    # 		self._obj_.InitialUpdateFrame(frame, doc, makeVisible) # call default handler.
-    # 		frame.InitialUpdateFrame(doc, makeVisible)
-
-    def OpenRegistryKey(
-        self, root=None, subkey=None
-    ):  # Use this instead of OpenDocumentFile.
-        # Look for existing open document
-        if root is None:
-            root = regutil.GetRootKey()
-        if subkey is None:
-            subkey = regutil.BuildDefaultPythonKey()
-        for doc in self.GetDocumentList():
-            if doc.root == root and doc.subkey == subkey:
-                doc.GetFirstView().ActivateFrame()
-                return doc
-        # not found - new one.
-        doc = RegDocument(self, root, subkey)
-        frame = self.CreateNewFrame(doc)
-        doc.OnNewDocument()
-        self.InitialUpdateFrame(frame, doc, 1)
-        return doc
-
-
-class RegDocument(docview.Document):
-    def __init__(self, template, root, subkey):
-        docview.Document.__init__(self, template)
-        self.root = root
-        self.subkey = subkey
-        self.SetTitle("Registry Editor: " + subkey)
-
-    def OnOpenDocument(self, name):
-        raise TypeError("This template can not open files")
-        return 0
-
-
-class HLIRegistryKey(hierlist.HierListItem):
-    def __init__(self, keyRoot, keyName, userName):
-        self.keyRoot = keyRoot
-        self.keyName = keyName
-        self.userName = userName
-        hierlist.HierListItem.__init__(self)
-
-    def __lt__(self, other):
-        return self.name < other.name
-
-    def __eq__(self, other):
-        return (
-            self.keyRoot == other.keyRoot
-            and self.keyName == other.keyName
-            and self.userName == other.userName
-        )
-
-    def __repr__(self):
-        return "<%s with root=%s, key=%s>" % (
-            self.__class__.__name__,
-            self.keyRoot,
-            self.keyName,
-        )
-
-    def GetText(self):
-        return self.userName
-
-    def IsExpandable(self):
-        # All keys are expandable, even if they currently have zero children.
-        return 1
-
-    ##		hkey = win32api.RegOpenKey(self.keyRoot, self.keyName)
-    ##		try:
-    ##			keys, vals, dt = win32api.RegQueryInfoKey(hkey)
-    ##			return (keys>0)
-    ##		finally:
-    ##			win32api.RegCloseKey(hkey)
-
-    def GetSubList(self):
-        hkey = win32api.RegOpenKey(self.keyRoot, self.keyName)
-        win32ui.DoWaitCursor(1)
-        try:
-            keyNum = 0
-            ret = []
-            while 1:
-                try:
-                    key = win32api.RegEnumKey(hkey, keyNum)
-                except win32api.error:
-                    break
-                ret.append(HLIRegistryKey(self.keyRoot, self.keyName + "\\" + key, key))
-                keyNum = keyNum + 1
-        finally:
-            win32api.RegCloseKey(hkey)
-            win32ui.DoWaitCursor(0)
-        return ret
-
-
-template = RegTemplate()
-
-
-def EditRegistry(root=None, key=None):
-    doc = template.OpenRegistryKey(root, key)
-
-
-if __name__ == "__main__":
-    EditRegistry()
diff --git a/lib/pythonwin/pywin/tools/regpy.py b/lib/pythonwin/pywin/tools/regpy.py
deleted file mode 100644
index 11ad63af..00000000
--- a/lib/pythonwin/pywin/tools/regpy.py
+++ /dev/null
@@ -1,81 +0,0 @@
-# (sort-of) Registry editor
-import commctrl
-import dialog
-import win32con
-import win32ui
-
-
-class RegistryControl:
-    def __init__(self, key):
-        self.key = key
-
-
-class RegEditPropertyPage(dialog.PropertyPage):
-    IDC_LISTVIEW = 1000
-
-    def GetTemplate(self):
-        "Return the template used to create this dialog"
-
-        w = 152  # Dialog width
-        h = 122  # Dialog height
-        SS_STD = win32con.WS_CHILD | win32con.WS_VISIBLE
-        FRAMEDLG_STD = win32con.WS_CAPTION | win32con.WS_SYSMENU
-        style = (
-            FRAMEDLG_STD
-            | win32con.WS_VISIBLE
-            | win32con.DS_SETFONT
-            | win32con.WS_MINIMIZEBOX
-        )
-        template = [
-            [self.caption, (0, 0, w, h), style, None, (8, "Helv")],
-        ]
-        lvStyle = (
-            SS_STD
-            | commctrl.LVS_EDITLABELS
-            | commctrl.LVS_REPORT
-            | commctrl.LVS_AUTOARRANGE
-            | commctrl.LVS_ALIGNLEFT
-            | win32con.WS_BORDER
-            | win32con.WS_TABSTOP
-        )
-        template.append(
-            ["SysListView32", "", self.IDC_LISTVIEW, (10, 10, 185, 100), lvStyle]
-        )
-        return template
-
-
-class RegistryPage(RegEditPropertyPage):
-    def __init__(self):
-        self.caption = "Path"
-        RegEditPropertyPage.__init__(self, self.GetTemplate())
-
-    def OnInitDialog(self):
-        self.listview = self.GetDlgItem(self.IDC_LISTVIEW)
-        RegEditPropertyPage.OnInitDialog(self)
-        # Setup the listview columns
-        itemDetails = (commctrl.LVCFMT_LEFT, 100, "App", 0)
-        self.listview.InsertColumn(0, itemDetails)
-        itemDetails = (commctrl.LVCFMT_LEFT, 1024, "Paths", 0)
-        self.listview.InsertColumn(1, itemDetails)
-
-        index = self.listview.InsertItem(0, "App")
-        self.listview.SetItemText(index, 1, "Path")
-
-
-class RegistrySheet(dialog.PropertySheet):
-    def __init__(self, title):
-        dialog.PropertySheet.__init__(self, title)
-        self.HookMessage(self.OnActivate, win32con.WM_ACTIVATE)
-
-    def OnActivate(self, msg):
-        print("OnAcivate")
-
-
-def t():
-    ps = RegistrySheet("Registry Settings")
-    ps.AddPage(RegistryPage())
-    ps.DoModal()
-
-
-if __name__ == "__main__":
-    t()
diff --git a/lib/pythonwin/start_pythonwin.pyw b/lib/pythonwin/start_pythonwin.pyw
deleted file mode 100644
index 0a1b2e60..00000000
--- a/lib/pythonwin/start_pythonwin.pyw
+++ /dev/null
@@ -1,19 +0,0 @@
-# A Python file that can be used to start Pythonwin, instead of using
-# pythonwin.exe
-import os
-import sys
-
-import win32ui
-
-import pywin.framework.intpyapp  # InteractivePythonApp()
-
-assert pywin.framework.intpyapp  # not unused
-# Pretend this script doesn't exist, or pythonwin tries to edit it
-sys.argv[:] = sys.argv[1:] or [""]  # like PySys_SetArgv(Ex)
-if sys.path[0] not in ("", ".", os.getcwd()):
-    sys.path.insert(0, os.getcwd())
-# And bootstrap the app.
-app = win32ui.GetApp()
-if not app.InitInstance():
-    # Run when not already handled by DDE
-    app.Run()
diff --git a/lib/pywin32.version.txt b/lib/pywin32.version.txt
deleted file mode 100644
index cd307095..00000000
--- a/lib/pywin32.version.txt
+++ /dev/null
@@ -1 +0,0 @@
-306
diff --git a/lib/tempora/timing.py b/lib/tempora/timing.py
index e74b8962..aed0d336 100644
--- a/lib/tempora/timing.py
+++ b/lib/tempora/timing.py
@@ -1,21 +1,22 @@
-import collections.abc
-import contextlib
 import datetime
 import functools
 import numbers
 import time
+import collections.abc
+import contextlib
 
 import jaraco.functools
 
 
 class Stopwatch:
     """
-    A simple stopwatch that starts automatically.
+    A simple stopwatch which starts automatically.
 
     >>> w = Stopwatch()
     >>> _1_sec = datetime.timedelta(seconds=1)
     >>> w.split() < _1_sec
     True
+    >>> import time
     >>> time.sleep(1.0)
     >>> w.split() >= _1_sec
     True
@@ -26,13 +27,13 @@ class Stopwatch:
     >>> w.split() < _1_sec
     True
 
-    Launch the Stopwatch in a context:
+    It should be possible to launch the Stopwatch in a context:
 
     >>> with Stopwatch() as watch:
     ...     assert isinstance(watch.split(), datetime.timedelta)
 
-    After exiting the context, the watch is stopped; read the
-    elapsed time directly:
+    In that case, the watch is stopped when the context is exited,
+    so to read the elapsed time:
 
     >>> watch.elapsed
     datetime.timedelta(...)
diff --git a/lib/typing_extensions.py b/lib/typing_extensions.py
index f3132ea4..ef42417c 100644
--- a/lib/typing_extensions.py
+++ b/lib/typing_extensions.py
@@ -2,12 +2,11 @@ import abc
 import collections
 import collections.abc
 import functools
-import inspect
 import operator
 import sys
 import types as _types
 import typing
-import warnings
+
 
 __all__ = [
     # Super-special typing primitives.
@@ -32,7 +31,6 @@ __all__ = [
     'Coroutine',
     'AsyncGenerator',
     'AsyncContextManager',
-    'Buffer',
     'ChainMap',
 
     # Concrete collection types.
@@ -45,13 +43,7 @@ __all__ = [
     'TypedDict',
 
     # Structural checks, a.k.a. protocols.
-    'SupportsAbs',
-    'SupportsBytes',
-    'SupportsComplex',
-    'SupportsFloat',
     'SupportsIndex',
-    'SupportsInt',
-    'SupportsRound',
 
     # One-off things.
     'Annotated',
@@ -59,17 +51,12 @@ __all__ = [
     'assert_type',
     'clear_overloads',
     'dataclass_transform',
-    'deprecated',
-    'Doc',
     'get_overloads',
     'final',
     'get_args',
     'get_origin',
-    'get_original_bases',
-    'get_protocol_members',
     'get_type_hints',
     'IntVar',
-    'is_protocol',
     'is_typeddict',
     'Literal',
     'NewType',
@@ -81,54 +68,12 @@ __all__ = [
     'runtime_checkable',
     'Text',
     'TypeAlias',
-    'TypeAliasType',
     'TypeGuard',
-    'TypeIs',
     'TYPE_CHECKING',
     'Never',
     'NoReturn',
-    'ReadOnly',
     'Required',
     'NotRequired',
-
-    # Pure aliases, have always been in typing
-    'AbstractSet',
-    'AnyStr',
-    'BinaryIO',
-    'Callable',
-    'Collection',
-    'Container',
-    'Dict',
-    'ForwardRef',
-    'FrozenSet',
-    'Generator',
-    'Generic',
-    'Hashable',
-    'IO',
-    'ItemsView',
-    'Iterable',
-    'Iterator',
-    'KeysView',
-    'List',
-    'Mapping',
-    'MappingView',
-    'Match',
-    'MutableMapping',
-    'MutableSequence',
-    'MutableSet',
-    'Optional',
-    'Pattern',
-    'Reversible',
-    'Sequence',
-    'Set',
-    'Sized',
-    'TextIO',
-    'Tuple',
-    'Union',
-    'ValuesView',
-    'cast',
-    'no_type_check',
-    'no_type_check_decorator',
 ]
 
 # for backward compatibility
@@ -138,13 +83,7 @@ GenericMeta = type
 # The functions below are modified copies of typing internal helpers.
 # They are needed by _ProtocolMeta and they provide support for PEP 646.
 
-
-class _Sentinel:
-    def __repr__(self):
-        return "<sentinel>"
-
-
-_marker = _Sentinel()
+_marker = object()
 
 
 def _check_generic(cls, parameters, elen=_marker):
@@ -245,13 +184,36 @@ else:
 
 ClassVar = typing.ClassVar
 
+# On older versions of typing there is an internal class named "Final".
+# 3.8+
+if hasattr(typing, 'Final') and sys.version_info[:2] >= (3, 7):
+    Final = typing.Final
+# 3.7
+else:
+    class _FinalForm(typing._SpecialForm, _root=True):
 
-class _ExtensionsSpecialForm(typing._SpecialForm, _root=True):
-    def __repr__(self):
-        return 'typing_extensions.' + self._name
+        def __repr__(self):
+            return 'typing_extensions.' + self._name
 
+        def __getitem__(self, parameters):
+            item = typing._type_check(parameters,
+                                      f'{self._name} accepts only a single type.')
+            return typing._GenericAlias(self, (item,))
 
-Final = typing.Final
+    Final = _FinalForm('Final',
+                       doc="""A special typing construct to indicate that a name
+                       cannot be re-assigned or overridden in a subclass.
+                       For example:
+
+                           MAX_SIZE: Final = 9000
+                           MAX_SIZE += 1  # Error reported by type checker
+
+                           class Connection:
+                               TIMEOUT: Final[int] = 10
+                           class FastConnector(Connection):
+                               TIMEOUT = 1  # Error reported by type checker
+
+                       There is no runtime checking of these properties.""")
 
 if sys.version_info >= (3, 11):
     final = typing.final
@@ -295,67 +257,21 @@ def IntVar(name):
     return typing.TypeVar(name)
 
 
-# A Literal bug was fixed in 3.11.0, 3.10.1 and 3.9.8
-if sys.version_info >= (3, 10, 1):
+# 3.8+:
+if hasattr(typing, 'Literal'):
     Literal = typing.Literal
+# 3.7:
 else:
-    def _flatten_literal_params(parameters):
-        """An internal helper for Literal creation: flatten Literals among parameters"""
-        params = []
-        for p in parameters:
-            if isinstance(p, _LiteralGenericAlias):
-                params.extend(p.__args__)
-            else:
-                params.append(p)
-        return tuple(params)
+    class _LiteralForm(typing._SpecialForm, _root=True):
 
-    def _value_and_type_iter(params):
-        for p in params:
-            yield p, type(p)
-
-    class _LiteralGenericAlias(typing._GenericAlias, _root=True):
-        def __eq__(self, other):
-            if not isinstance(other, _LiteralGenericAlias):
-                return NotImplemented
-            these_args_deduped = set(_value_and_type_iter(self.__args__))
-            other_args_deduped = set(_value_and_type_iter(other.__args__))
-            return these_args_deduped == other_args_deduped
-
-        def __hash__(self):
-            return hash(frozenset(_value_and_type_iter(self.__args__)))
-
-    class _LiteralForm(_ExtensionsSpecialForm, _root=True):
-        def __init__(self, doc: str):
-            self._name = 'Literal'
-            self._doc = self.__doc__ = doc
+        def __repr__(self):
+            return 'typing_extensions.' + self._name
 
         def __getitem__(self, parameters):
-            if not isinstance(parameters, tuple):
-                parameters = (parameters,)
+            return typing._GenericAlias(self, parameters)
 
-            parameters = _flatten_literal_params(parameters)
-
-            val_type_pairs = list(_value_and_type_iter(parameters))
-            try:
-                deduped_pairs = set(val_type_pairs)
-            except TypeError:
-                # unhashable parameters
-                pass
-            else:
-                # similar logic to typing._deduplicate on Python 3.9+
-                if len(deduped_pairs) < len(val_type_pairs):
-                    new_parameters = []
-                    for pair in val_type_pairs:
-                        if pair in deduped_pairs:
-                            new_parameters.append(pair[0])
-                            deduped_pairs.remove(pair)
-                    assert not deduped_pairs, deduped_pairs
-                    parameters = tuple(new_parameters)
-
-            return _LiteralGenericAlias(self, parameters)
-
-    Literal = _LiteralForm(doc="""\
-                           A type that can be used to indicate to type checkers
+    Literal = _LiteralForm('Literal',
+                           doc="""A type that can be used to indicate to type checkers
                            that the corresponding value has a value literally equivalent
                            to the provided parameter. For example:
 
@@ -369,7 +285,7 @@ else:
                            instead of a type.""")
 
 
-_overload_dummy = typing._overload_dummy
+_overload_dummy = typing._overload_dummy  # noqa
 
 
 if hasattr(typing, "get_overloads"):  # 3.11+
@@ -443,6 +359,8 @@ Type = typing.Type
 
 # Various ABCs mimicking those in collections.abc.
 # A few are simply re-exported for completeness.
+
+
 Awaitable = typing.Awaitable
 Coroutine = typing.Coroutine
 AsyncIterable = typing.AsyncIterable
@@ -451,343 +369,278 @@ Deque = typing.Deque
 ContextManager = typing.ContextManager
 AsyncContextManager = typing.AsyncContextManager
 DefaultDict = typing.DefaultDict
-OrderedDict = typing.OrderedDict
+
+# 3.7.2+
+if hasattr(typing, 'OrderedDict'):
+    OrderedDict = typing.OrderedDict
+# 3.7.0-3.7.2
+else:
+    OrderedDict = typing._alias(collections.OrderedDict, (KT, VT))
+
 Counter = typing.Counter
 ChainMap = typing.ChainMap
 AsyncGenerator = typing.AsyncGenerator
+NewType = typing.NewType
 Text = typing.Text
 TYPE_CHECKING = typing.TYPE_CHECKING
 
 
-_PROTO_ALLOWLIST = {
-    'collections.abc': [
-        'Callable', 'Awaitable', 'Iterable', 'Iterator', 'AsyncIterable',
-        'Hashable', 'Sized', 'Container', 'Collection', 'Reversible', 'Buffer',
-    ],
-    'contextlib': ['AbstractContextManager', 'AbstractAsyncContextManager'],
-    'typing_extensions': ['Buffer'],
-}
-
-
-_EXCLUDED_ATTRS = {
-    "__abstractmethods__", "__annotations__", "__weakref__", "_is_protocol",
-    "_is_runtime_protocol", "__dict__", "__slots__", "__parameters__",
-    "__orig_bases__", "__module__", "_MutableMapping__marker", "__doc__",
-    "__subclasshook__", "__orig_class__", "__init__", "__new__",
-    "__protocol_attrs__", "__non_callable_proto_members__",
-    "__match_args__",
-}
-
-if sys.version_info >= (3, 9):
-    _EXCLUDED_ATTRS.add("__class_getitem__")
-
-if sys.version_info >= (3, 12):
-    _EXCLUDED_ATTRS.add("__type_params__")
-
-_EXCLUDED_ATTRS = frozenset(_EXCLUDED_ATTRS)
+_PROTO_WHITELIST = ['Callable', 'Awaitable',
+                    'Iterable', 'Iterator', 'AsyncIterable', 'AsyncIterator',
+                    'Hashable', 'Sized', 'Container', 'Collection', 'Reversible',
+                    'ContextManager', 'AsyncContextManager']
 
 
 def _get_protocol_attrs(cls):
     attrs = set()
     for base in cls.__mro__[:-1]:  # without object
-        if base.__name__ in {'Protocol', 'Generic'}:
+        if base.__name__ in ('Protocol', 'Generic'):
             continue
         annotations = getattr(base, '__annotations__', {})
-        for attr in (*base.__dict__, *annotations):
-            if (not attr.startswith('_abc_') and attr not in _EXCLUDED_ATTRS):
+        for attr in list(base.__dict__.keys()) + list(annotations.keys()):
+            if (not attr.startswith('_abc_') and attr not in (
+                    '__abstractmethods__', '__annotations__', '__weakref__',
+                    '_is_protocol', '_is_runtime_protocol', '__dict__',
+                    '__args__', '__slots__',
+                    '__next_in_mro__', '__parameters__', '__origin__',
+                    '__orig_bases__', '__extra__', '__tree_hash__',
+                    '__doc__', '__subclasshook__', '__init__', '__new__',
+                    '__module__', '_MutableMapping__marker', '_gorg')):
                 attrs.add(attr)
     return attrs
 
 
-def _caller(depth=2):
-    try:
-        return sys._getframe(depth).f_globals.get('__name__', '__main__')
-    except (AttributeError, ValueError):  # For platforms without _getframe()
-        return None
+def _is_callable_members_only(cls):
+    return all(callable(getattr(cls, attr, None)) for attr in _get_protocol_attrs(cls))
 
 
-# `__match_args__` attribute was removed from protocol members in 3.13,
-# we want to backport this change to older Python versions.
-if sys.version_info >= (3, 13):
+def _maybe_adjust_parameters(cls):
+    """Helper function used in Protocol.__init_subclass__ and _TypedDictMeta.__new__.
+
+    The contents of this function are very similar
+    to logic found in typing.Generic.__init_subclass__
+    on the CPython main branch.
+    """
+    tvars = []
+    if '__orig_bases__' in cls.__dict__:
+        tvars = typing._collect_type_vars(cls.__orig_bases__)
+        # Look for Generic[T1, ..., Tn] or Protocol[T1, ..., Tn].
+        # If found, tvars must be a subset of it.
+        # If not found, tvars is it.
+        # Also check for and reject plain Generic,
+        # and reject multiple Generic[...] and/or Protocol[...].
+        gvars = None
+        for base in cls.__orig_bases__:
+            if (isinstance(base, typing._GenericAlias) and
+                    base.__origin__ in (typing.Generic, Protocol)):
+                # for error messages
+                the_base = base.__origin__.__name__
+                if gvars is not None:
+                    raise TypeError(
+                        "Cannot inherit from Generic[...]"
+                        " and/or Protocol[...] multiple types.")
+                gvars = base.__parameters__
+        if gvars is None:
+            gvars = tvars
+        else:
+            tvarset = set(tvars)
+            gvarset = set(gvars)
+            if not tvarset <= gvarset:
+                s_vars = ', '.join(str(t) for t in tvars if t not in gvarset)
+                s_args = ', '.join(str(g) for g in gvars)
+                raise TypeError(f"Some type variables ({s_vars}) are"
+                                f" not listed in {the_base}[{s_args}]")
+            tvars = gvars
+    cls.__parameters__ = tuple(tvars)
+
+
+# 3.8+
+if hasattr(typing, 'Protocol'):
     Protocol = typing.Protocol
+# 3.7
 else:
-    def _allow_reckless_class_checks(depth=3):
-        """Allow instance and class checks for special stdlib modules.
-        The abc and functools modules indiscriminately call isinstance() and
-        issubclass() on the whole MRO of a user class, which may contain protocols.
-        """
-        return _caller(depth) in {'abc', 'functools', None}
 
     def _no_init(self, *args, **kwargs):
         if type(self)._is_protocol:
             raise TypeError('Protocols cannot be instantiated')
 
-    def _type_check_issubclass_arg_1(arg):
-        """Raise TypeError if `arg` is not an instance of `type`
-        in `issubclass(arg, <protocol>)`.
-
-        In most cases, this is verified by type.__subclasscheck__.
-        Checking it again unnecessarily would slow down issubclass() checks,
-        so, we don't perform this check unless we absolutely have to.
-
-        For various error paths, however,
-        we want to ensure that *this* error message is shown to the user
-        where relevant, rather than a typing.py-specific error message.
-        """
-        if not isinstance(arg, type):
-            # Same error message as for issubclass(1, int).
-            raise TypeError('issubclass() arg 1 must be a class')
-
-    # Inheriting from typing._ProtocolMeta isn't actually desirable,
-    # but is necessary to allow typing.Protocol and typing_extensions.Protocol
-    # to mix without getting TypeErrors about "metaclass conflict"
-    class _ProtocolMeta(type(typing.Protocol)):
-        # This metaclass is somewhat unfortunate,
-        # but is necessary for several reasons...
-        #
-        # NOTE: DO NOT call super() in any methods in this class
-        # That would call the methods on typing._ProtocolMeta on Python 3.8-3.11
-        # and those are slow
-        def __new__(mcls, name, bases, namespace, **kwargs):
-            if name == "Protocol" and len(bases) < 2:
-                pass
-            elif {Protocol, typing.Protocol} & set(bases):
-                for base in bases:
-                    if not (
-                        base in {object, typing.Generic, Protocol, typing.Protocol}
-                        or base.__name__ in _PROTO_ALLOWLIST.get(base.__module__, [])
-                        or is_protocol(base)
-                    ):
-                        raise TypeError(
-                            f"Protocols can only inherit from other protocols, "
-                            f"got {base!r}"
-                        )
-            return abc.ABCMeta.__new__(mcls, name, bases, namespace, **kwargs)
-
-        def __init__(cls, *args, **kwargs):
-            abc.ABCMeta.__init__(cls, *args, **kwargs)
-            if getattr(cls, "_is_protocol", False):
-                cls.__protocol_attrs__ = _get_protocol_attrs(cls)
-
-        def __subclasscheck__(cls, other):
-            if cls is Protocol:
-                return type.__subclasscheck__(cls, other)
-            if (
-                getattr(cls, '_is_protocol', False)
-                and not _allow_reckless_class_checks()
-            ):
-                if not getattr(cls, '_is_runtime_protocol', False):
-                    _type_check_issubclass_arg_1(other)
-                    raise TypeError(
-                        "Instance and class checks can only be used with "
-                        "@runtime_checkable protocols"
-                    )
-                if (
-                    # this attribute is set by @runtime_checkable:
-                    cls.__non_callable_proto_members__
-                    and cls.__dict__.get("__subclasshook__") is _proto_hook
-                ):
-                    _type_check_issubclass_arg_1(other)
-                    non_method_attrs = sorted(cls.__non_callable_proto_members__)
-                    raise TypeError(
-                        "Protocols with non-method members don't support issubclass()."
-                        f" Non-method members: {str(non_method_attrs)[1:-1]}."
-                    )
-            return abc.ABCMeta.__subclasscheck__(cls, other)
-
+    class _ProtocolMeta(abc.ABCMeta):  # noqa: B024
+        # This metaclass is a bit unfortunate and exists only because of the lack
+        # of __instancehook__.
         def __instancecheck__(cls, instance):
             # We need this method for situations where attributes are
             # assigned in __init__.
-            if cls is Protocol:
-                return type.__instancecheck__(cls, instance)
-            if not getattr(cls, "_is_protocol", False):
-                # i.e., it's a concrete subclass of a protocol
-                return abc.ABCMeta.__instancecheck__(cls, instance)
-
-            if (
-                not getattr(cls, '_is_runtime_protocol', False) and
-                not _allow_reckless_class_checks()
-            ):
-                raise TypeError("Instance and class checks can only be used with"
-                                " @runtime_checkable protocols")
-
-            if abc.ABCMeta.__instancecheck__(cls, instance):
+            if ((not getattr(cls, '_is_protocol', False) or
+                 _is_callable_members_only(cls)) and
+                    issubclass(instance.__class__, cls)):
                 return True
+            if cls._is_protocol:
+                if all(hasattr(instance, attr) and
+                       (not callable(getattr(cls, attr, None)) or
+                        getattr(instance, attr) is not None)
+                       for attr in _get_protocol_attrs(cls)):
+                    return True
+            return super().__instancecheck__(instance)
 
-            for attr in cls.__protocol_attrs__:
-                try:
-                    val = inspect.getattr_static(instance, attr)
-                except AttributeError:
-                    break
-                # this attribute is set by @runtime_checkable:
-                if val is None and attr not in cls.__non_callable_proto_members__:
-                    break
-            else:
-                return True
+    class Protocol(metaclass=_ProtocolMeta):
+        # There is quite a lot of overlapping code with typing.Generic.
+        # Unfortunately it is hard to avoid this while these live in two different
+        # modules. The duplicated code will be removed when Protocol is moved to typing.
+        """Base class for protocol classes. Protocol classes are defined as::
 
-            return False
+            class Proto(Protocol):
+                def meth(self) -> int:
+                    ...
 
-        def __eq__(cls, other):
-            # Hack so that typing.Generic.__class_getitem__
-            # treats typing_extensions.Protocol
-            # as equivalent to typing.Protocol
-            if abc.ABCMeta.__eq__(cls, other) is True:
-                return True
-            return cls is Protocol and other is typing.Protocol
+        Such classes are primarily used with static type checkers that recognize
+        structural subtyping (static duck-typing), for example::
 
-        # This has to be defined, or the abc-module cache
-        # complains about classes with this metaclass being unhashable,
-        # if we define only __eq__!
-        def __hash__(cls) -> int:
-            return type.__hash__(cls)
+            class C:
+                def meth(self) -> int:
+                    return 0
 
-    @classmethod
-    def _proto_hook(cls, other):
-        if not cls.__dict__.get('_is_protocol', False):
-            return NotImplemented
+            def func(x: Proto) -> int:
+                return x.meth()
 
-        for attr in cls.__protocol_attrs__:
-            for base in other.__mro__:
-                # Check if the members appears in the class dictionary...
-                if attr in base.__dict__:
-                    if base.__dict__[attr] is None:
-                        return NotImplemented
-                    break
+            func(C())  # Passes static type check
 
-                # ...or in annotations, if it is a sub-protocol.
-                annotations = getattr(base, '__annotations__', {})
-                if (
-                    isinstance(annotations, collections.abc.Mapping)
-                    and attr in annotations
-                    and is_protocol(other)
-                ):
-                    break
-            else:
-                return NotImplemented
-        return True
+        See PEP 544 for details. Protocol classes decorated with
+        @typing_extensions.runtime act as simple-minded runtime protocol that checks
+        only the presence of given attributes, ignoring their type signatures.
 
-    class Protocol(typing.Generic, metaclass=_ProtocolMeta):
-        __doc__ = typing.Protocol.__doc__
+        Protocol classes can be generic, they are defined as::
+
+            class GenProto(Protocol[T]):
+                def meth(self) -> T:
+                    ...
+        """
         __slots__ = ()
         _is_protocol = True
-        _is_runtime_protocol = False
+
+        def __new__(cls, *args, **kwds):
+            if cls is Protocol:
+                raise TypeError("Type Protocol cannot be instantiated; "
+                                "it can only be used as a base class")
+            return super().__new__(cls)
+
+        @typing._tp_cache
+        def __class_getitem__(cls, params):
+            if not isinstance(params, tuple):
+                params = (params,)
+            if not params and cls is not typing.Tuple:
+                raise TypeError(
+                    f"Parameter list to {cls.__qualname__}[...] cannot be empty")
+            msg = "Parameters to generic types must be types."
+            params = tuple(typing._type_check(p, msg) for p in params)  # noqa
+            if cls is Protocol:
+                # Generic can only be subscripted with unique type variables.
+                if not all(isinstance(p, typing.TypeVar) for p in params):
+                    i = 0
+                    while isinstance(params[i], typing.TypeVar):
+                        i += 1
+                    raise TypeError(
+                        "Parameters to Protocol[...] must all be type variables."
+                        f" Parameter {i + 1} is {params[i]}")
+                if len(set(params)) != len(params):
+                    raise TypeError(
+                        "Parameters to Protocol[...] must all be unique")
+            else:
+                # Subscripting a regular Generic subclass.
+                _check_generic(cls, params, len(cls.__parameters__))
+            return typing._GenericAlias(cls, params)
 
         def __init_subclass__(cls, *args, **kwargs):
-            super().__init_subclass__(*args, **kwargs)
+            if '__orig_bases__' in cls.__dict__:
+                error = typing.Generic in cls.__orig_bases__
+            else:
+                error = typing.Generic in cls.__bases__
+            if error:
+                raise TypeError("Cannot inherit from plain Generic")
+            _maybe_adjust_parameters(cls)
 
             # Determine if this is a protocol or a concrete subclass.
-            if not cls.__dict__.get('_is_protocol', False):
+            if not cls.__dict__.get('_is_protocol', None):
                 cls._is_protocol = any(b is Protocol for b in cls.__bases__)
 
             # Set (or override) the protocol subclass hook.
+            def _proto_hook(other):
+                if not cls.__dict__.get('_is_protocol', None):
+                    return NotImplemented
+                if not getattr(cls, '_is_runtime_protocol', False):
+                    if sys._getframe(2).f_globals['__name__'] in ['abc', 'functools']:
+                        return NotImplemented
+                    raise TypeError("Instance and class checks can only be used with"
+                                    " @runtime protocols")
+                if not _is_callable_members_only(cls):
+                    if sys._getframe(2).f_globals['__name__'] in ['abc', 'functools']:
+                        return NotImplemented
+                    raise TypeError("Protocols with non-method members"
+                                    " don't support issubclass()")
+                if not isinstance(other, type):
+                    # Same error as for issubclass(1, int)
+                    raise TypeError('issubclass() arg 1 must be a class')
+                for attr in _get_protocol_attrs(cls):
+                    for base in other.__mro__:
+                        if attr in base.__dict__:
+                            if base.__dict__[attr] is None:
+                                return NotImplemented
+                            break
+                        annotations = getattr(base, '__annotations__', {})
+                        if (isinstance(annotations, typing.Mapping) and
+                                attr in annotations and
+                                isinstance(other, _ProtocolMeta) and
+                                other._is_protocol):
+                            break
+                    else:
+                        return NotImplemented
+                return True
             if '__subclasshook__' not in cls.__dict__:
                 cls.__subclasshook__ = _proto_hook
 
-            # Prohibit instantiation for protocol classes
-            if cls._is_protocol and cls.__init__ is Protocol.__init__:
-                cls.__init__ = _no_init
+            # We have nothing more to do for non-protocols.
+            if not cls._is_protocol:
+                return
+
+            # Check consistency of bases.
+            for base in cls.__bases__:
+                if not (base in (object, typing.Generic) or
+                        base.__module__ == 'collections.abc' and
+                        base.__name__ in _PROTO_WHITELIST or
+                        isinstance(base, _ProtocolMeta) and base._is_protocol):
+                    raise TypeError('Protocols can only inherit from other'
+                                    f' protocols, got {repr(base)}')
+            cls.__init__ = _no_init
 
 
-if sys.version_info >= (3, 13):
+# 3.8+
+if hasattr(typing, 'runtime_checkable'):
     runtime_checkable = typing.runtime_checkable
+# 3.7
 else:
     def runtime_checkable(cls):
-        """Mark a protocol class as a runtime protocol.
+        """Mark a protocol class as a runtime protocol, so that it
+        can be used with isinstance() and issubclass(). Raise TypeError
+        if applied to a non-protocol class.
 
-        Such protocol can be used with isinstance() and issubclass().
-        Raise TypeError if applied to a non-protocol class.
-        This allows a simple-minded structural check very similar to
-        one trick ponies in collections.abc such as Iterable.
-
-        For example::
-
-            @runtime_checkable
-            class Closable(Protocol):
-                def close(self): ...
-
-            assert isinstance(open('/some/file'), Closable)
-
-        Warning: this will check only the presence of the required methods,
-        not their type signatures!
+        This allows a simple-minded structural check very similar to the
+        one-offs in collections.abc such as Hashable.
         """
-        if not issubclass(cls, typing.Generic) or not getattr(cls, '_is_protocol', False):
+        if not isinstance(cls, _ProtocolMeta) or not cls._is_protocol:
             raise TypeError('@runtime_checkable can be only applied to protocol classes,'
-                            ' got %r' % cls)
+                            f' got {cls!r}')
         cls._is_runtime_protocol = True
-
-        # Only execute the following block if it's a typing_extensions.Protocol class.
-        # typing.Protocol classes don't need it.
-        if isinstance(cls, _ProtocolMeta):
-            # PEP 544 prohibits using issubclass()
-            # with protocols that have non-method members.
-            # See gh-113320 for why we compute this attribute here,
-            # rather than in `_ProtocolMeta.__init__`
-            cls.__non_callable_proto_members__ = set()
-            for attr in cls.__protocol_attrs__:
-                try:
-                    is_callable = callable(getattr(cls, attr, None))
-                except Exception as e:
-                    raise TypeError(
-                        f"Failed to determine whether protocol member {attr!r} "
-                        "is a method member"
-                    ) from e
-                else:
-                    if not is_callable:
-                        cls.__non_callable_proto_members__.add(attr)
-
         return cls
 
 
-# The "runtime" alias exists for backwards compatibility.
+# Exists for backwards compatibility.
 runtime = runtime_checkable
 
 
-# Our version of runtime-checkable protocols is faster on Python 3.8-3.11
-if sys.version_info >= (3, 12):
-    SupportsInt = typing.SupportsInt
-    SupportsFloat = typing.SupportsFloat
-    SupportsComplex = typing.SupportsComplex
-    SupportsBytes = typing.SupportsBytes
+# 3.8+
+if hasattr(typing, 'SupportsIndex'):
     SupportsIndex = typing.SupportsIndex
-    SupportsAbs = typing.SupportsAbs
-    SupportsRound = typing.SupportsRound
+# 3.7
 else:
-    @runtime_checkable
-    class SupportsInt(Protocol):
-        """An ABC with one abstract method __int__."""
-        __slots__ = ()
-
-        @abc.abstractmethod
-        def __int__(self) -> int:
-            pass
-
-    @runtime_checkable
-    class SupportsFloat(Protocol):
-        """An ABC with one abstract method __float__."""
-        __slots__ = ()
-
-        @abc.abstractmethod
-        def __float__(self) -> float:
-            pass
-
-    @runtime_checkable
-    class SupportsComplex(Protocol):
-        """An ABC with one abstract method __complex__."""
-        __slots__ = ()
-
-        @abc.abstractmethod
-        def __complex__(self) -> complex:
-            pass
-
-    @runtime_checkable
-    class SupportsBytes(Protocol):
-        """An ABC with one abstract method __bytes__."""
-        __slots__ = ()
-
-        @abc.abstractmethod
-        def __bytes__(self) -> bytes:
-            pass
-
     @runtime_checkable
     class SupportsIndex(Protocol):
         __slots__ = ()
@@ -796,45 +649,8 @@ else:
         def __index__(self) -> int:
             pass
 
-    @runtime_checkable
-    class SupportsAbs(Protocol[T_co]):
-        """
-        An ABC with one abstract method __abs__ that is covariant in its return type.
-        """
-        __slots__ = ()
 
-        @abc.abstractmethod
-        def __abs__(self) -> T_co:
-            pass
-
-    @runtime_checkable
-    class SupportsRound(Protocol[T_co]):
-        """
-        An ABC with one abstract method __round__ that is covariant in its return type.
-        """
-        __slots__ = ()
-
-        @abc.abstractmethod
-        def __round__(self, ndigits: int = 0) -> T_co:
-            pass
-
-
-def _ensure_subclassable(mro_entries):
-    def inner(func):
-        if sys.implementation.name == "pypy" and sys.version_info < (3, 9):
-            cls_dict = {
-                "__call__": staticmethod(func),
-                "__mro_entries__": staticmethod(mro_entries)
-            }
-            t = type(func.__name__, (), cls_dict)
-            return functools.update_wrapper(t(), func)
-        else:
-            func.__mro_entries__ = mro_entries
-            return func
-    return inner
-
-
-if hasattr(typing, "ReadOnly"):
+if hasattr(typing, "Required"):
     # The standard library TypedDict in Python 3.8 does not store runtime information
     # about which (if any) keys are optional.  See https://bugs.python.org/issue38834
     # The standard library TypedDict in Python 3.9.0/1 does not honour the "total"
@@ -842,164 +658,148 @@ if hasattr(typing, "ReadOnly"):
     # The standard library TypedDict below Python 3.11 does not store runtime
     # information about optional and required keys when using Required or NotRequired.
     # Generic TypedDicts are also impossible using typing.TypedDict on Python <3.11.
-    # Aaaand on 3.12 we add __orig_bases__ to TypedDict
-    # to enable better runtime introspection.
-    # On 3.13 we deprecate some odd ways of creating TypedDicts.
-    # PEP 705 proposes adding the ReadOnly[] qualifier.
     TypedDict = typing.TypedDict
     _TypedDictMeta = typing._TypedDictMeta
     is_typeddict = typing.is_typeddict
 else:
-    # 3.10.0 and later
-    _TAKES_MODULE = "module" in inspect.signature(typing._type_check).parameters
+    def _check_fails(cls, other):
+        try:
+            if sys._getframe(1).f_globals['__name__'] not in ['abc',
+                                                              'functools',
+                                                              'typing']:
+                # Typed dicts are only for static structural subtyping.
+                raise TypeError('TypedDict does not support instance and class checks')
+        except (AttributeError, ValueError):
+            pass
+        return False
 
-    def _get_typeddict_qualifiers(annotation_type):
-        while True:
-            annotation_origin = get_origin(annotation_type)
-            if annotation_origin is Annotated:
-                annotation_args = get_args(annotation_type)
-                if annotation_args:
-                    annotation_type = annotation_args[0]
-                else:
-                    break
-            elif annotation_origin is Required:
-                yield Required
-                annotation_type, = get_args(annotation_type)
-            elif annotation_origin is NotRequired:
-                yield NotRequired
-                annotation_type, = get_args(annotation_type)
-            elif annotation_origin is ReadOnly:
-                yield ReadOnly
-                annotation_type, = get_args(annotation_type)
-            else:
-                break
+    def _dict_new(*args, **kwargs):
+        if not args:
+            raise TypeError('TypedDict.__new__(): not enough arguments')
+        _, args = args[0], args[1:]  # allow the "cls" keyword be passed
+        return dict(*args, **kwargs)
+
+    _dict_new.__text_signature__ = '($cls, _typename, _fields=None, /, **kwargs)'
+
+    def _typeddict_new(*args, total=True, **kwargs):
+        if not args:
+            raise TypeError('TypedDict.__new__(): not enough arguments')
+        _, args = args[0], args[1:]  # allow the "cls" keyword be passed
+        if args:
+            typename, args = args[0], args[1:]  # allow the "_typename" keyword be passed
+        elif '_typename' in kwargs:
+            typename = kwargs.pop('_typename')
+            import warnings
+            warnings.warn("Passing '_typename' as keyword argument is deprecated",
+                          DeprecationWarning, stacklevel=2)
+        else:
+            raise TypeError("TypedDict.__new__() missing 1 required positional "
+                            "argument: '_typename'")
+        if args:
+            try:
+                fields, = args  # allow the "_fields" keyword be passed
+            except ValueError:
+                raise TypeError('TypedDict.__new__() takes from 2 to 3 '
+                                f'positional arguments but {len(args) + 2} '
+                                'were given')
+        elif '_fields' in kwargs and len(kwargs) == 1:
+            fields = kwargs.pop('_fields')
+            import warnings
+            warnings.warn("Passing '_fields' as keyword argument is deprecated",
+                          DeprecationWarning, stacklevel=2)
+        else:
+            fields = None
+
+        if fields is None:
+            fields = kwargs
+        elif kwargs:
+            raise TypeError("TypedDict takes either a dict or keyword arguments,"
+                            " but not both")
+
+        ns = {'__annotations__': dict(fields)}
+        try:
+            # Setting correct module is necessary to make typed dict classes pickleable.
+            ns['__module__'] = sys._getframe(1).f_globals.get('__name__', '__main__')
+        except (AttributeError, ValueError):
+            pass
+
+        return _TypedDictMeta(typename, (), ns, total=total)
+
+    _typeddict_new.__text_signature__ = ('($cls, _typename, _fields=None,'
+                                         ' /, *, total=True, **kwargs)')
 
     class _TypedDictMeta(type):
-        def __new__(cls, name, bases, ns, *, total=True, closed=False):
-            """Create new typed dict class object.
+        def __init__(cls, name, bases, ns, total=True):
+            super().__init__(name, bases, ns)
 
-            This method is called when TypedDict is subclassed,
-            or when TypedDict is instantiated. This way
-            TypedDict supports all three syntax forms described in its docstring.
-            Subclasses and instances of TypedDict return actual dictionaries.
-            """
-            for base in bases:
-                if type(base) is not _TypedDictMeta and base is not typing.Generic:
-                    raise TypeError('cannot inherit from both a TypedDict type '
-                                    'and a non-TypedDict base class')
+        def __new__(cls, name, bases, ns, total=True):
+            # Create new typed dict class object.
+            # This method is called directly when TypedDict is subclassed,
+            # or via _typeddict_new when TypedDict is instantiated. This way
+            # TypedDict supports all three syntaxes described in its docstring.
+            # Subclasses and instances of TypedDict return actual dictionaries
+            # via _dict_new.
+            ns['__new__'] = _typeddict_new if name == 'TypedDict' else _dict_new
+            # Don't insert typing.Generic into __bases__ here,
+            # or Generic.__init_subclass__ will raise TypeError
+            # in the super().__new__() call.
+            # Instead, monkey-patch __bases__ onto the class after it's been created.
+            tp_dict = super().__new__(cls, name, (dict,), ns)
 
-            if any(issubclass(b, typing.Generic) for b in bases):
-                generic_base = (typing.Generic,)
-            else:
-                generic_base = ()
-
-            # typing.py generally doesn't let you inherit from plain Generic, unless
-            # the name of the class happens to be "Protocol"
-            tp_dict = type.__new__(_TypedDictMeta, "Protocol", (*generic_base, dict), ns)
-            tp_dict.__name__ = name
-            if tp_dict.__qualname__ == "Protocol":
-                tp_dict.__qualname__ = name
-
-            if not hasattr(tp_dict, '__orig_bases__'):
-                tp_dict.__orig_bases__ = bases
+            if any(issubclass(base, typing.Generic) for base in bases):
+                tp_dict.__bases__ = (typing.Generic, dict)
+                _maybe_adjust_parameters(tp_dict)
 
             annotations = {}
             own_annotations = ns.get('__annotations__', {})
             msg = "TypedDict('Name', {f0: t0, f1: t1, ...}); each t must be a type"
-            if _TAKES_MODULE:
-                own_annotations = {
-                    n: typing._type_check(tp, msg, module=tp_dict.__module__)
-                    for n, tp in own_annotations.items()
-                }
-            else:
-                own_annotations = {
-                    n: typing._type_check(tp, msg)
-                    for n, tp in own_annotations.items()
-                }
+            own_annotations = {
+                n: typing._type_check(tp, msg) for n, tp in own_annotations.items()
+            }
             required_keys = set()
             optional_keys = set()
-            readonly_keys = set()
-            mutable_keys = set()
-            extra_items_type = None
 
             for base in bases:
-                base_dict = base.__dict__
-
-                annotations.update(base_dict.get('__annotations__', {}))
-                required_keys.update(base_dict.get('__required_keys__', ()))
-                optional_keys.update(base_dict.get('__optional_keys__', ()))
-                readonly_keys.update(base_dict.get('__readonly_keys__', ()))
-                mutable_keys.update(base_dict.get('__mutable_keys__', ()))
-                base_extra_items_type = base_dict.get('__extra_items__', None)
-                if base_extra_items_type is not None:
-                    extra_items_type = base_extra_items_type
-
-            if closed and extra_items_type is None:
-                extra_items_type = Never
-            if closed and "__extra_items__" in own_annotations:
-                annotation_type = own_annotations.pop("__extra_items__")
-                qualifiers = set(_get_typeddict_qualifiers(annotation_type))
-                if Required in qualifiers:
-                    raise TypeError(
-                        "Special key __extra_items__ does not support "
-                        "Required"
-                    )
-                if NotRequired in qualifiers:
-                    raise TypeError(
-                        "Special key __extra_items__ does not support "
-                        "NotRequired"
-                    )
-                extra_items_type = annotation_type
+                annotations.update(base.__dict__.get('__annotations__', {}))
+                required_keys.update(base.__dict__.get('__required_keys__', ()))
+                optional_keys.update(base.__dict__.get('__optional_keys__', ()))
 
             annotations.update(own_annotations)
             for annotation_key, annotation_type in own_annotations.items():
-                qualifiers = set(_get_typeddict_qualifiers(annotation_type))
+                annotation_origin = get_origin(annotation_type)
+                if annotation_origin is Annotated:
+                    annotation_args = get_args(annotation_type)
+                    if annotation_args:
+                        annotation_type = annotation_args[0]
+                        annotation_origin = get_origin(annotation_type)
 
-                if Required in qualifiers:
+                if annotation_origin is Required:
                     required_keys.add(annotation_key)
-                elif NotRequired in qualifiers:
+                elif annotation_origin is NotRequired:
                     optional_keys.add(annotation_key)
                 elif total:
                     required_keys.add(annotation_key)
                 else:
                     optional_keys.add(annotation_key)
-                if ReadOnly in qualifiers:
-                    mutable_keys.discard(annotation_key)
-                    readonly_keys.add(annotation_key)
-                else:
-                    mutable_keys.add(annotation_key)
-                    readonly_keys.discard(annotation_key)
 
             tp_dict.__annotations__ = annotations
             tp_dict.__required_keys__ = frozenset(required_keys)
             tp_dict.__optional_keys__ = frozenset(optional_keys)
-            tp_dict.__readonly_keys__ = frozenset(readonly_keys)
-            tp_dict.__mutable_keys__ = frozenset(mutable_keys)
             if not hasattr(tp_dict, '__total__'):
                 tp_dict.__total__ = total
-            tp_dict.__closed__ = closed
-            tp_dict.__extra_items__ = extra_items_type
             return tp_dict
 
-        __call__ = dict  # static method
+        __instancecheck__ = __subclasscheck__ = _check_fails
 
-        def __subclasscheck__(cls, other):
-            # Typed dicts are only for static structural subtyping.
-            raise TypeError('TypedDict does not support instance and class checks')
+    TypedDict = _TypedDictMeta('TypedDict', (dict,), {})
+    TypedDict.__module__ = __name__
+    TypedDict.__doc__ = \
+        """A simple typed name space. At runtime it is equivalent to a plain dict.
 
-        __instancecheck__ = __subclasscheck__
-
-    _TypedDict = type.__new__(_TypedDictMeta, 'TypedDict', (), {})
-
-    @_ensure_subclassable(lambda bases: (_TypedDict,))
-    def TypedDict(typename, fields=_marker, /, *, total=True, closed=False, **kwargs):
-        """A simple typed namespace. At runtime it is equivalent to a plain dict.
-
-        TypedDict creates a dictionary type such that a type checker will expect all
-        instances to have a certain set of keys, where each key is
+        TypedDict creates a dictionary type that expects all of its
+        instances to have a certain set of keys, with each key
         associated with a value of a consistent type. This expectation
-        is not checked at runtime.
-
+        is not checked at runtime but is only enforced by type checkers.
         Usage::
 
             class Point2D(TypedDict):
@@ -1014,71 +814,14 @@ else:
 
         The type info can be accessed via the Point2D.__annotations__ dict, and
         the Point2D.__required_keys__ and Point2D.__optional_keys__ frozensets.
-        TypedDict supports an additional equivalent form::
+        TypedDict supports two additional equivalent forms::
 
+            Point2D = TypedDict('Point2D', x=int, y=int, label=str)
             Point2D = TypedDict('Point2D', {'x': int, 'y': int, 'label': str})
 
-        By default, all keys must be present in a TypedDict. It is possible
-        to override this by specifying totality::
-
-            class Point2D(TypedDict, total=False):
-                x: int
-                y: int
-
-        This means that a Point2D TypedDict can have any of the keys omitted. A type
-        checker is only expected to support a literal False or True as the value of
-        the total argument. True is the default, and makes all items defined in the
-        class body be required.
-
-        The Required and NotRequired special forms can also be used to mark
-        individual keys as being required or not required::
-
-            class Point2D(TypedDict):
-                x: int  # the "x" key must always be present (Required is the default)
-                y: NotRequired[int]  # the "y" key can be omitted
-
-        See PEP 655 for more details on Required and NotRequired.
+        The class syntax is only supported in Python 3.6+, while two other
+        syntax forms work for Python 2.7 and 3.2+
         """
-        if fields is _marker or fields is None:
-            if fields is _marker:
-                deprecated_thing = "Failing to pass a value for the 'fields' parameter"
-            else:
-                deprecated_thing = "Passing `None` as the 'fields' parameter"
-
-            example = f"`{typename} = TypedDict({typename!r}, {{}})`"
-            deprecation_msg = (
-                f"{deprecated_thing} is deprecated and will be disallowed in "
-                "Python 3.15. To create a TypedDict class with 0 fields "
-                "using the functional syntax, pass an empty dictionary, e.g. "
-            ) + example + "."
-            warnings.warn(deprecation_msg, DeprecationWarning, stacklevel=2)
-            if closed is not False and closed is not True:
-                kwargs["closed"] = closed
-                closed = False
-            fields = kwargs
-        elif kwargs:
-            raise TypeError("TypedDict takes either a dict or keyword arguments,"
-                            " but not both")
-        if kwargs:
-            if sys.version_info >= (3, 13):
-                raise TypeError("TypedDict takes no keyword arguments")
-            warnings.warn(
-                "The kwargs-based syntax for TypedDict definitions is deprecated "
-                "in Python 3.11, will be removed in Python 3.13, and may not be "
-                "understood by third-party type checkers.",
-                DeprecationWarning,
-                stacklevel=2,
-            )
-
-        ns = {'__annotations__': dict(fields)}
-        module = _caller()
-        if module is not None:
-            # Setting correct module is necessary to make typed dict classes pickleable.
-            ns['__module__'] = module
-
-        td = _TypedDictMeta(typename, (), ns, total=total, closed=closed)
-        td.__orig_bases__ = (TypedDict,)
-        return td
 
     if hasattr(typing, "_TypedDictMeta"):
         _TYPEDDICT_TYPES = (typing._TypedDictMeta, _TypedDictMeta)
@@ -1096,17 +839,14 @@ else:
             is_typeddict(Film)  # => True
             is_typeddict(Union[list, str])  # => False
         """
-        # On 3.8, this would otherwise return True
-        if hasattr(typing, "TypedDict") and tp is typing.TypedDict:
-            return False
-        return isinstance(tp, _TYPEDDICT_TYPES)
+        return isinstance(tp, tuple(_TYPEDDICT_TYPES))
 
 
 if hasattr(typing, "assert_type"):
     assert_type = typing.assert_type
 
 else:
-    def assert_type(val, typ, /):
+    def assert_type(__val, __typ):
         """Assert (to the type checker) that the value is of the given type.
 
         When the type checker encounters a call to assert_type(), it
@@ -1119,12 +859,15 @@ else:
         At runtime this returns the first argument unchanged and otherwise
         does nothing.
         """
-        return val
+        return __val
 
 
-if hasattr(typing, "Required"):  # 3.11+
+if hasattr(typing, "Required"):
     get_type_hints = typing.get_type_hints
-else:  # <=3.10
+else:
+    import functools
+    import types
+
     # replaces _strip_annotations()
     def _strip_extras(t):
         """Strips Annotated, Required and NotRequired from a given type."""
@@ -1137,12 +880,12 @@ else:  # <=3.10
             if stripped_args == t.__args__:
                 return t
             return t.copy_with(stripped_args)
-        if hasattr(_types, "GenericAlias") and isinstance(t, _types.GenericAlias):
+        if hasattr(types, "GenericAlias") and isinstance(t, types.GenericAlias):
             stripped_args = tuple(_strip_extras(a) for a in t.__args__)
             if stripped_args == t.__args__:
                 return t
-            return _types.GenericAlias(t.__origin__, stripped_args)
-        if hasattr(_types, "UnionType") and isinstance(t, _types.UnionType):
+            return types.GenericAlias(t.__origin__, stripped_args)
+        if hasattr(types, "UnionType") and isinstance(t, types.UnionType):
             stripped_args = tuple(_strip_extras(a) for a in t.__args__)
             if stripped_args == t.__args__:
                 return t
@@ -1182,11 +925,11 @@ else:  # <=3.10
         - If two dict arguments are passed, they specify globals and
           locals, respectively.
         """
-        if hasattr(typing, "Annotated"):  # 3.9+
+        if hasattr(typing, "Annotated"):
             hint = typing.get_type_hints(
                 obj, globalns=globalns, localns=localns, include_extras=True
             )
-        else:  # 3.8
+        else:
             hint = typing.get_type_hints(obj, globalns=globalns, localns=localns)
         if include_extras:
             return hint
@@ -1199,7 +942,7 @@ if hasattr(typing, 'Annotated'):
     # Not exported and not a public API, but needed for get_origin() and get_args()
     # to work.
     _AnnotatedAlias = typing._AnnotatedAlias
-# 3.8
+# 3.7-3.8
 else:
     class _AnnotatedAlias(typing._GenericAlias, _root=True):
         """Runtime representation of an annotated type.
@@ -1304,7 +1047,7 @@ else:
 if sys.version_info[:2] >= (3, 10):
     get_origin = typing.get_origin
     get_args = typing.get_args
-# 3.8-3.9
+# 3.7-3.9
 else:
     try:
         # 3.9+
@@ -1369,7 +1112,11 @@ if hasattr(typing, 'TypeAlias'):
     TypeAlias = typing.TypeAlias
 # 3.9
 elif sys.version_info[:2] >= (3, 9):
-    @_ExtensionsSpecialForm
+    class _TypeAliasForm(typing._SpecialForm, _root=True):
+        def __repr__(self):
+            return 'typing_extensions.' + self._name
+
+    @_TypeAliasForm
     def TypeAlias(self, parameters):
         """Special marker indicating that an assignment should
         be recognized as a proper type alias definition by type
@@ -1382,89 +1129,68 @@ elif sys.version_info[:2] >= (3, 9):
         It's invalid when used anywhere except as in the example above.
         """
         raise TypeError(f"{self} is not subscriptable")
-# 3.8
+# 3.7-3.8
 else:
-    TypeAlias = _ExtensionsSpecialForm(
-        'TypeAlias',
-        doc="""Special marker indicating that an assignment should
-        be recognized as a proper type alias definition by type
-        checkers.
+    class _TypeAliasForm(typing._SpecialForm, _root=True):
+        def __repr__(self):
+            return 'typing_extensions.' + self._name
 
-        For example::
+    TypeAlias = _TypeAliasForm('TypeAlias',
+                               doc="""Special marker indicating that an assignment should
+                               be recognized as a proper type alias definition by type
+                               checkers.
 
-            Predicate: TypeAlias = Callable[..., bool]
+                               For example::
 
-        It's invalid when used anywhere except as in the example
-        above."""
-    )
+                                   Predicate: TypeAlias = Callable[..., bool]
 
-
-def _set_default(type_param, default):
-    if isinstance(default, (tuple, list)):
-        type_param.__default__ = tuple((typing._type_check(d, "Default must be a type")
-                                        for d in default))
-    elif default != _marker:
-        if isinstance(type_param, ParamSpec) and default is ...:  # ... not valid <3.11
-            type_param.__default__ = default
-        else:
-            type_param.__default__ = typing._type_check(default, "Default must be a type")
-    else:
-        type_param.__default__ = None
-
-
-def _set_module(typevarlike):
-    # for pickling:
-    def_mod = _caller(depth=3)
-    if def_mod != 'typing_extensions':
-        typevarlike.__module__ = def_mod
+                               It's invalid when used anywhere except as in the example
+                               above.""")
 
 
 class _DefaultMixin:
     """Mixin for TypeVarLike defaults."""
 
     __slots__ = ()
-    __init__ = _set_default
 
-
-# Classes using this metaclass must provide a _backported_typevarlike ClassVar
-class _TypeVarLikeMeta(type):
-    def __instancecheck__(cls, __instance: Any) -> bool:
-        return isinstance(__instance, cls._backported_typevarlike)
+    def __init__(self, default):
+        if isinstance(default, (tuple, list)):
+            self.__default__ = tuple((typing._type_check(d, "Default must be a type")
+                                      for d in default))
+        elif default:
+            self.__default__ = typing._type_check(default, "Default must be a type")
+        else:
+            self.__default__ = None
 
 
 # Add default and infer_variance parameters from PEP 696 and 695
-class TypeVar(metaclass=_TypeVarLikeMeta):
+class TypeVar(typing.TypeVar, _DefaultMixin, _root=True):
     """Type variable."""
 
-    _backported_typevarlike = typing.TypeVar
+    __module__ = 'typing'
 
-    def __new__(cls, name, *constraints, bound=None,
-                covariant=False, contravariant=False,
-                default=_marker, infer_variance=False):
-        if hasattr(typing, "TypeAliasType"):
-            # PEP 695 implemented (3.12+), can pass infer_variance to typing.TypeVar
-            typevar = typing.TypeVar(name, *constraints, bound=bound,
-                                     covariant=covariant, contravariant=contravariant,
-                                     infer_variance=infer_variance)
-        else:
-            typevar = typing.TypeVar(name, *constraints, bound=bound,
-                                     covariant=covariant, contravariant=contravariant)
-            if infer_variance and (covariant or contravariant):
-                raise ValueError("Variance cannot be specified with infer_variance.")
-            typevar.__infer_variance__ = infer_variance
-        _set_default(typevar, default)
-        _set_module(typevar)
-        return typevar
+    def __init__(self, name, *constraints, bound=None,
+                 covariant=False, contravariant=False,
+                 default=None, infer_variance=False):
+        super().__init__(name, *constraints, bound=bound, covariant=covariant,
+                         contravariant=contravariant)
+        _DefaultMixin.__init__(self, default)
+        self.__infer_variance__ = infer_variance
 
-    def __init_subclass__(cls) -> None:
-        raise TypeError(f"type '{__name__}.TypeVar' is not an acceptable base type")
+        # for pickling:
+        try:
+            def_mod = sys._getframe(1).f_globals.get('__name__', '__main__')
+        except (AttributeError, ValueError):
+            def_mod = None
+        if def_mod != 'typing_extensions':
+            self.__module__ = def_mod
 
 
 # Python 3.10+ has PEP 612
 if hasattr(typing, 'ParamSpecArgs'):
     ParamSpecArgs = typing.ParamSpecArgs
     ParamSpecKwargs = typing.ParamSpecKwargs
-# 3.8-3.9
+# 3.7-3.9
 else:
     class _Immutable:
         """Mixin to indicate that object should not be copied."""
@@ -1525,35 +1251,27 @@ else:
 # 3.10+
 if hasattr(typing, 'ParamSpec'):
 
-    # Add default parameter - PEP 696
-    class ParamSpec(metaclass=_TypeVarLikeMeta):
-        """Parameter specification."""
+    # Add default Parameter - PEP 696
+    class ParamSpec(typing.ParamSpec, _DefaultMixin, _root=True):
+        """Parameter specification variable."""
 
-        _backported_typevarlike = typing.ParamSpec
+        __module__ = 'typing'
 
-        def __new__(cls, name, *, bound=None,
-                    covariant=False, contravariant=False,
-                    infer_variance=False, default=_marker):
-            if hasattr(typing, "TypeAliasType"):
-                # PEP 695 implemented, can pass infer_variance to typing.TypeVar
-                paramspec = typing.ParamSpec(name, bound=bound,
-                                             covariant=covariant,
-                                             contravariant=contravariant,
-                                             infer_variance=infer_variance)
-            else:
-                paramspec = typing.ParamSpec(name, bound=bound,
-                                             covariant=covariant,
-                                             contravariant=contravariant)
-                paramspec.__infer_variance__ = infer_variance
+        def __init__(self, name, *, bound=None, covariant=False, contravariant=False,
+                     default=None):
+            super().__init__(name, bound=bound, covariant=covariant,
+                             contravariant=contravariant)
+            _DefaultMixin.__init__(self, default)
 
-            _set_default(paramspec, default)
-            _set_module(paramspec)
-            return paramspec
+            # for pickling:
+            try:
+                def_mod = sys._getframe(1).f_globals.get('__name__', '__main__')
+            except (AttributeError, ValueError):
+                def_mod = None
+            if def_mod != 'typing_extensions':
+                self.__module__ = def_mod
 
-        def __init_subclass__(cls) -> None:
-            raise TypeError(f"type '{__name__}.ParamSpec' is not an acceptable base type")
-
-# 3.8-3.9
+# 3.7-3.9
 else:
 
     # Inherits from list as a workaround for Callable checks in Python < 3.9.2.
@@ -1616,12 +1334,11 @@ else:
             return ParamSpecKwargs(self)
 
         def __init__(self, name, *, bound=None, covariant=False, contravariant=False,
-                     infer_variance=False, default=_marker):
+                     default=None):
             super().__init__([self])
             self.__name__ = name
             self.__covariant__ = bool(covariant)
             self.__contravariant__ = bool(contravariant)
-            self.__infer_variance__ = bool(infer_variance)
             if bound:
                 self.__bound__ = typing._type_check(bound, 'Bound must be a type.')
             else:
@@ -1629,14 +1346,15 @@ else:
             _DefaultMixin.__init__(self, default)
 
             # for pickling:
-            def_mod = _caller()
+            try:
+                def_mod = sys._getframe(1).f_globals.get('__name__', '__main__')
+            except (AttributeError, ValueError):
+                def_mod = None
             if def_mod != 'typing_extensions':
                 self.__module__ = def_mod
 
         def __repr__(self):
-            if self.__infer_variance__:
-                prefix = ''
-            elif self.__covariant__:
+            if self.__covariant__:
                 prefix = '+'
             elif self.__contravariant__:
                 prefix = '-'
@@ -1658,7 +1376,7 @@ else:
             pass
 
 
-# 3.8-3.9
+# 3.7-3.9
 if not hasattr(typing, 'Concatenate'):
     # Inherits from list as a workaround for Callable checks in Python < 3.9.2.
     class _ConcatenateGenericAlias(list):
@@ -1693,7 +1411,7 @@ if not hasattr(typing, 'Concatenate'):
             )
 
 
-# 3.8-3.9
+# 3.7-3.9
 @typing._tp_cache
 def _concatenate_getitem(self, parameters):
     if parameters == ():
@@ -1711,10 +1429,10 @@ def _concatenate_getitem(self, parameters):
 # 3.10+
 if hasattr(typing, 'Concatenate'):
     Concatenate = typing.Concatenate
-    _ConcatenateGenericAlias = typing._ConcatenateGenericAlias  # noqa: F811
+    _ConcatenateGenericAlias = typing._ConcatenateGenericAlias # noqa
 # 3.9
 elif sys.version_info[:2] >= (3, 9):
-    @_ExtensionsSpecialForm
+    @_TypeAliasForm
     def Concatenate(self, parameters):
         """Used in conjunction with ``ParamSpec`` and ``Callable`` to represent a
         higher order function which adds, removes or transforms parameters of a
@@ -1727,9 +1445,12 @@ elif sys.version_info[:2] >= (3, 9):
         See PEP 612 for detailed information.
         """
         return _concatenate_getitem(self, parameters)
-# 3.8
+# 3.7-8
 else:
-    class _ConcatenateForm(_ExtensionsSpecialForm, _root=True):
+    class _ConcatenateForm(typing._SpecialForm, _root=True):
+        def __repr__(self):
+            return 'typing_extensions.' + self._name
+
         def __getitem__(self, parameters):
             return _concatenate_getitem(self, parameters)
 
@@ -1751,7 +1472,11 @@ if hasattr(typing, 'TypeGuard'):
     TypeGuard = typing.TypeGuard
 # 3.9
 elif sys.version_info[:2] >= (3, 9):
-    @_ExtensionsSpecialForm
+    class _TypeGuardForm(typing._SpecialForm, _root=True):
+        def __repr__(self):
+            return 'typing_extensions.' + self._name
+
+    @_TypeGuardForm
     def TypeGuard(self, parameters):
         """Special typing form used to annotate the return type of a user-defined
         type guard function.  ``TypeGuard`` only accepts a single type argument.
@@ -1797,9 +1522,13 @@ elif sys.version_info[:2] >= (3, 9):
         """
         item = typing._type_check(parameters, f'{self} accepts only a single type.')
         return typing._GenericAlias(self, (item,))
-# 3.8
+# 3.7-3.8
 else:
-    class _TypeGuardForm(_ExtensionsSpecialForm, _root=True):
+    class _TypeGuardForm(typing._SpecialForm, _root=True):
+
+        def __repr__(self):
+            return 'typing_extensions.' + self._name
+
         def __getitem__(self, parameters):
             item = typing._type_check(parameters,
                                       f'{self._name} accepts only a single type')
@@ -1850,98 +1579,6 @@ else:
         PEP 647 (User-Defined Type Guards).
         """)
 
-# 3.13+
-if hasattr(typing, 'TypeIs'):
-    TypeIs = typing.TypeIs
-# 3.9
-elif sys.version_info[:2] >= (3, 9):
-    @_ExtensionsSpecialForm
-    def TypeIs(self, parameters):
-        """Special typing form used to annotate the return type of a user-defined
-        type narrower function.  ``TypeIs`` only accepts a single type argument.
-        At runtime, functions marked this way should return a boolean.
-
-        ``TypeIs`` aims to benefit *type narrowing* -- a technique used by static
-        type checkers to determine a more precise type of an expression within a
-        program's code flow.  Usually type narrowing is done by analyzing
-        conditional code flow and applying the narrowing to a block of code.  The
-        conditional expression here is sometimes referred to as a "type guard".
-
-        Sometimes it would be convenient to use a user-defined boolean function
-        as a type guard.  Such a function should use ``TypeIs[...]`` as its
-        return type to alert static type checkers to this intention.
-
-        Using  ``-> TypeIs`` tells the static type checker that for a given
-        function:
-
-        1. The return value is a boolean.
-        2. If the return value is ``True``, the type of its argument
-        is the intersection of the type inside ``TypeGuard`` and the argument's
-        previously known type.
-
-        For example::
-
-            def is_awaitable(val: object) -> TypeIs[Awaitable[Any]]:
-                return hasattr(val, '__await__')
-
-            def f(val: Union[int, Awaitable[int]]) -> int:
-                if is_awaitable(val):
-                    assert_type(val, Awaitable[int])
-                else:
-                    assert_type(val, int)
-
-        ``TypeIs`` also works with type variables.  For more information, see
-        PEP 742 (Narrowing types with TypeIs).
-        """
-        item = typing._type_check(parameters, f'{self} accepts only a single type.')
-        return typing._GenericAlias(self, (item,))
-# 3.8
-else:
-    class _TypeIsForm(_ExtensionsSpecialForm, _root=True):
-        def __getitem__(self, parameters):
-            item = typing._type_check(parameters,
-                                      f'{self._name} accepts only a single type')
-            return typing._GenericAlias(self, (item,))
-
-    TypeIs = _TypeIsForm(
-        'TypeIs',
-        doc="""Special typing form used to annotate the return type of a user-defined
-        type narrower function.  ``TypeIs`` only accepts a single type argument.
-        At runtime, functions marked this way should return a boolean.
-
-        ``TypeIs`` aims to benefit *type narrowing* -- a technique used by static
-        type checkers to determine a more precise type of an expression within a
-        program's code flow.  Usually type narrowing is done by analyzing
-        conditional code flow and applying the narrowing to a block of code.  The
-        conditional expression here is sometimes referred to as a "type guard".
-
-        Sometimes it would be convenient to use a user-defined boolean function
-        as a type guard.  Such a function should use ``TypeIs[...]`` as its
-        return type to alert static type checkers to this intention.
-
-        Using  ``-> TypeIs`` tells the static type checker that for a given
-        function:
-
-        1. The return value is a boolean.
-        2. If the return value is ``True``, the type of its argument
-        is the intersection of the type inside ``TypeGuard`` and the argument's
-        previously known type.
-
-        For example::
-
-            def is_awaitable(val: object) -> TypeIs[Awaitable[Any]]:
-                return hasattr(val, '__await__')
-
-            def f(val: Union[int, Awaitable[int]]) -> int:
-                if is_awaitable(val):
-                    assert_type(val, Awaitable[int])
-                else:
-                    assert_type(val, int)
-
-        ``TypeIs`` also works with type variables.  For more information, see
-        PEP 742 (Narrowing types with TypeIs).
-        """)
-
 
 # Vendored from cpython typing._SpecialFrom
 class _SpecialForm(typing._Final, _root=True):
@@ -1987,7 +1624,7 @@ class _SpecialForm(typing._Final, _root=True):
         return self._getitem(self, parameters)
 
 
-if hasattr(typing, "LiteralString"):  # 3.11+
+if hasattr(typing, "LiteralString"):
     LiteralString = typing.LiteralString
 else:
     @_SpecialForm
@@ -2010,7 +1647,7 @@ else:
         raise TypeError(f"{self} is not subscriptable")
 
 
-if hasattr(typing, "Self"):  # 3.11+
+if hasattr(typing, "Self"):
     Self = typing.Self
 else:
     @_SpecialForm
@@ -2031,7 +1668,7 @@ else:
         raise TypeError(f"{self} is not subscriptable")
 
 
-if hasattr(typing, "Never"):  # 3.11+
+if hasattr(typing, "Never"):
     Never = typing.Never
 else:
     @_SpecialForm
@@ -2061,10 +1698,14 @@ else:
         raise TypeError(f"{self} is not subscriptable")
 
 
-if hasattr(typing, 'Required'):  # 3.11+
+if hasattr(typing, 'Required'):
     Required = typing.Required
     NotRequired = typing.NotRequired
-elif sys.version_info[:2] >= (3, 9):  # 3.9-3.10
+elif sys.version_info[:2] >= (3, 9):
+    class _ExtensionsSpecialForm(typing._SpecialForm, _root=True):
+        def __repr__(self):
+            return 'typing_extensions.' + self._name
+
     @_ExtensionsSpecialForm
     def Required(self, parameters):
         """A special typing construct to mark a key of a total=False TypedDict
@@ -2102,8 +1743,11 @@ elif sys.version_info[:2] >= (3, 9):  # 3.9-3.10
         item = typing._type_check(parameters, f'{self._name} accepts only a single type.')
         return typing._GenericAlias(self, (item,))
 
-else:  # 3.8
-    class _RequiredForm(_ExtensionsSpecialForm, _root=True):
+else:
+    class _RequiredForm(typing._SpecialForm, _root=True):
+        def __repr__(self):
+            return 'typing_extensions.' + self._name
+
         def __getitem__(self, parameters):
             item = typing._type_check(parameters,
                                       f'{self._name} accepts only a single type.')
@@ -2142,129 +1786,59 @@ else:  # 3.8
         """)
 
 
-if hasattr(typing, 'ReadOnly'):
-    ReadOnly = typing.ReadOnly
-elif sys.version_info[:2] >= (3, 9):  # 3.9-3.12
-    @_ExtensionsSpecialForm
-    def ReadOnly(self, parameters):
-        """A special typing construct to mark an item of a TypedDict as read-only.
-
-        For example:
-
-            class Movie(TypedDict):
-                title: ReadOnly[str]
-                year: int
-
-            def mutate_movie(m: Movie) -> None:
-                m["year"] = 1992  # allowed
-                m["title"] = "The Matrix"  # typechecker error
-
-        There is no runtime checking for this property.
-        """
-        item = typing._type_check(parameters, f'{self._name} accepts only a single type.')
-        return typing._GenericAlias(self, (item,))
-
-else:  # 3.8
-    class _ReadOnlyForm(_ExtensionsSpecialForm, _root=True):
-        def __getitem__(self, parameters):
-            item = typing._type_check(parameters,
-                                      f'{self._name} accepts only a single type.')
-            return typing._GenericAlias(self, (item,))
-
-    ReadOnly = _ReadOnlyForm(
-        'ReadOnly',
-        doc="""A special typing construct to mark a key of a TypedDict as read-only.
-
-        For example:
-
-            class Movie(TypedDict):
-                title: ReadOnly[str]
-                year: int
-
-            def mutate_movie(m: Movie) -> None:
-                m["year"] = 1992  # allowed
-                m["title"] = "The Matrix"  # typechecker error
-
-        There is no runtime checking for this propery.
-        """)
-
-
-_UNPACK_DOC = """\
-Type unpack operator.
-
-The type unpack operator takes the child types from some container type,
-such as `tuple[int, str]` or a `TypeVarTuple`, and 'pulls them out'. For
-example:
-
-  # For some generic class `Foo`:
-  Foo[Unpack[tuple[int, str]]]  # Equivalent to Foo[int, str]
-
-  Ts = TypeVarTuple('Ts')
-  # Specifies that `Bar` is generic in an arbitrary number of types.
-  # (Think of `Ts` as a tuple of an arbitrary number of individual
-  #  `TypeVar`s, which the `Unpack` is 'pulling out' directly into the
-  #  `Generic[]`.)
-  class Bar(Generic[Unpack[Ts]]): ...
-  Bar[int]  # Valid
-  Bar[int, str]  # Also valid
-
-From Python 3.11, this can also be done using the `*` operator:
-
-    Foo[*tuple[int, str]]
-    class Bar(Generic[*Ts]): ...
-
-The operator can also be used along with a `TypedDict` to annotate
-`**kwargs` in a function signature. For instance:
-
-  class Movie(TypedDict):
-    name: str
-    year: int
-
-  # This function expects two keyword arguments - *name* of type `str` and
-  # *year* of type `int`.
-  def foo(**kwargs: Unpack[Movie]): ...
-
-Note that there is only some runtime checking of this operator. Not
-everything the runtime allows may be accepted by static type checkers.
-
-For more information, see PEP 646 and PEP 692.
-"""
-
-
-if sys.version_info >= (3, 12):  # PEP 692 changed the repr of Unpack[]
+if hasattr(typing, "Unpack"):  # 3.11+
     Unpack = typing.Unpack
-
-    def _is_unpack(obj):
-        return get_origin(obj) is Unpack
-
-elif sys.version_info[:2] >= (3, 9):  # 3.9+
-    class _UnpackSpecialForm(_ExtensionsSpecialForm, _root=True):
-        def __init__(self, getitem):
-            super().__init__(getitem)
-            self.__doc__ = _UNPACK_DOC
+elif sys.version_info[:2] >= (3, 9):
+    class _UnpackSpecialForm(typing._SpecialForm, _root=True):
+        def __repr__(self):
+            return 'typing_extensions.' + self._name
 
     class _UnpackAlias(typing._GenericAlias, _root=True):
         __class__ = typing.TypeVar
 
     @_UnpackSpecialForm
     def Unpack(self, parameters):
+        """A special typing construct to unpack a variadic type. For example:
+
+            Shape = TypeVarTuple('Shape')
+            Batch = NewType('Batch', int)
+
+            def add_batch_axis(
+                x: Array[Unpack[Shape]]
+            ) -> Array[Batch, Unpack[Shape]]: ...
+
+        """
         item = typing._type_check(parameters, f'{self._name} accepts only a single type.')
         return _UnpackAlias(self, (item,))
 
     def _is_unpack(obj):
         return isinstance(obj, _UnpackAlias)
 
-else:  # 3.8
+else:
     class _UnpackAlias(typing._GenericAlias, _root=True):
         __class__ = typing.TypeVar
 
-    class _UnpackForm(_ExtensionsSpecialForm, _root=True):
+    class _UnpackForm(typing._SpecialForm, _root=True):
+        def __repr__(self):
+            return 'typing_extensions.' + self._name
+
         def __getitem__(self, parameters):
             item = typing._type_check(parameters,
                                       f'{self._name} accepts only a single type.')
             return _UnpackAlias(self, (item,))
 
-    Unpack = _UnpackForm('Unpack', doc=_UNPACK_DOC)
+    Unpack = _UnpackForm(
+        'Unpack',
+        doc="""A special typing construct to unpack a variadic type. For example:
+
+            Shape = TypeVarTuple('Shape')
+            Batch = NewType('Batch', int)
+
+            def add_batch_axis(
+                x: Array[Unpack[Shape]]
+            ) -> Array[Batch, Unpack[Shape]]: ...
+
+        """)
 
     def _is_unpack(obj):
         return isinstance(obj, _UnpackAlias)
@@ -2272,22 +1846,23 @@ else:  # 3.8
 
 if hasattr(typing, "TypeVarTuple"):  # 3.11+
 
-    # Add default parameter - PEP 696
-    class TypeVarTuple(metaclass=_TypeVarLikeMeta):
+    # Add default Parameter - PEP 696
+    class TypeVarTuple(typing.TypeVarTuple, _DefaultMixin, _root=True):
         """Type variable tuple."""
 
-        _backported_typevarlike = typing.TypeVarTuple
+        def __init__(self, name, *, default=None):
+            super().__init__(name)
+            _DefaultMixin.__init__(self, default)
 
-        def __new__(cls, name, *, default=_marker):
-            tvt = typing.TypeVarTuple(name)
-            _set_default(tvt, default)
-            _set_module(tvt)
-            return tvt
+            # for pickling:
+            try:
+                def_mod = sys._getframe(1).f_globals.get('__name__', '__main__')
+            except (AttributeError, ValueError):
+                def_mod = None
+            if def_mod != 'typing_extensions':
+                self.__module__ = def_mod
 
-        def __init_subclass__(self, *args, **kwds):
-            raise TypeError("Cannot subclass special typing classes")
-
-else:  # <=3.10
+else:
     class TypeVarTuple(_DefaultMixin):
         """Type variable tuple.
 
@@ -2338,12 +1913,15 @@ else:  # <=3.10
         def __iter__(self):
             yield self.__unpacked__
 
-        def __init__(self, name, *, default=_marker):
+        def __init__(self, name, *, default=None):
             self.__name__ = name
             _DefaultMixin.__init__(self, default)
 
             # for pickling:
-            def_mod = _caller()
+            try:
+                def_mod = sys._getframe(1).f_globals.get('__name__', '__main__')
+            except (AttributeError, ValueError):
+                def_mod = None
             if def_mod != 'typing_extensions':
                 self.__module__ = def_mod
 
@@ -2366,10 +1944,10 @@ else:  # <=3.10
                 raise TypeError("Cannot subclass special typing classes")
 
 
-if hasattr(typing, "reveal_type"):  # 3.11+
+if hasattr(typing, "reveal_type"):
     reveal_type = typing.reveal_type
-else:  # <=3.10
-    def reveal_type(obj: T, /) -> T:
+else:
+    def reveal_type(__obj: T) -> T:
         """Reveal the inferred type of a variable.
 
         When a static type checker encounters a call to ``reveal_type()``,
@@ -2385,14 +1963,14 @@ else:  # <=3.10
         argument and returns it unchanged.
 
         """
-        print(f"Runtime type is {type(obj).__name__!r}", file=sys.stderr)
-        return obj
+        print(f"Runtime type is {type(__obj).__name__!r}", file=sys.stderr)
+        return __obj
 
 
-if hasattr(typing, "assert_never"):  # 3.11+
+if hasattr(typing, "assert_never"):
     assert_never = typing.assert_never
-else:  # <=3.10
-    def assert_never(arg: Never, /) -> Never:
+else:
+    def assert_never(__arg: Never) -> Never:
         """Assert to the type checker that a line of code is unreachable.
 
         Example::
@@ -2415,16 +1993,14 @@ else:  # <=3.10
         raise AssertionError("Expected code to be unreachable")
 
 
-if sys.version_info >= (3, 12):  # 3.12+
-    # dataclass_transform exists in 3.11 but lacks the frozen_default parameter
+if hasattr(typing, 'dataclass_transform'):
     dataclass_transform = typing.dataclass_transform
-else:  # <=3.11
+else:
     def dataclass_transform(
         *,
         eq_default: bool = True,
         order_default: bool = False,
         kw_only_default: bool = False,
-        frozen_default: bool = False,
         field_specifiers: typing.Tuple[
             typing.Union[typing.Type[typing.Any], typing.Callable[..., typing.Any]],
             ...
@@ -2481,8 +2057,6 @@ else:  # <=3.11
           assumed to be True or False if it is omitted by the caller.
         - ``kw_only_default`` indicates whether the ``kw_only`` parameter is
           assumed to be True or False if it is omitted by the caller.
-        - ``frozen_default`` indicates whether the ``frozen`` parameter is
-          assumed to be True or False if it is omitted by the caller.
         - ``field_specifiers`` specifies a static list of supported classes
           or functions that describe fields, similar to ``dataclasses.field()``.
 
@@ -2497,7 +2071,6 @@ else:  # <=3.11
                 "eq_default": eq_default,
                 "order_default": order_default,
                 "kw_only_default": kw_only_default,
-                "frozen_default": frozen_default,
                 "field_specifiers": field_specifiers,
                 "kwargs": kwargs,
             }
@@ -2505,18 +2078,18 @@ else:  # <=3.11
         return decorator
 
 
-if hasattr(typing, "override"):  # 3.12+
+if hasattr(typing, "override"):
     override = typing.override
-else:  # <=3.11
+else:
     _F = typing.TypeVar("_F", bound=typing.Callable[..., typing.Any])
 
-    def override(arg: _F, /) -> _F:
+    def override(__arg: _F) -> _F:
         """Indicate that a method is intended to override a method in a base class.
 
         Usage:
 
             class Base:
-                def method(self) -> None:
+                def method(self) -> None: ...
                     pass
 
             class Child(Base):
@@ -2529,156 +2102,10 @@ else:  # <=3.11
         This helps prevent bugs that may occur when a base class is changed
         without an equivalent change to a child class.
 
-        There is no runtime checking of these properties. The decorator
-        sets the ``__override__`` attribute to ``True`` on the decorated object
-        to allow runtime introspection.
-
         See PEP 698 for details.
 
         """
-        try:
-            arg.__override__ = True
-        except (AttributeError, TypeError):
-            # Skip the attribute silently if it is not writable.
-            # AttributeError happens if the object has __slots__ or a
-            # read-only property, TypeError if it's a builtin class.
-            pass
-        return arg
-
-
-if hasattr(warnings, "deprecated"):
-    deprecated = warnings.deprecated
-else:
-    _T = typing.TypeVar("_T")
-
-    class deprecated:
-        """Indicate that a class, function or overload is deprecated.
-
-        When this decorator is applied to an object, the type checker
-        will generate a diagnostic on usage of the deprecated object.
-
-        Usage:
-
-            @deprecated("Use B instead")
-            class A:
-                pass
-
-            @deprecated("Use g instead")
-            def f():
-                pass
-
-            @overload
-            @deprecated("int support is deprecated")
-            def g(x: int) -> int: ...
-            @overload
-            def g(x: str) -> int: ...
-
-        The warning specified by *category* will be emitted at runtime
-        on use of deprecated objects. For functions, that happens on calls;
-        for classes, on instantiation and on creation of subclasses.
-        If the *category* is ``None``, no warning is emitted at runtime.
-        The *stacklevel* determines where the
-        warning is emitted. If it is ``1`` (the default), the warning
-        is emitted at the direct caller of the deprecated object; if it
-        is higher, it is emitted further up the stack.
-        Static type checker behavior is not affected by the *category*
-        and *stacklevel* arguments.
-
-        The deprecation message passed to the decorator is saved in the
-        ``__deprecated__`` attribute on the decorated object.
-        If applied to an overload, the decorator
-        must be after the ``@overload`` decorator for the attribute to
-        exist on the overload as returned by ``get_overloads()``.
-
-        See PEP 702 for details.
-
-        """
-        def __init__(
-            self,
-            message: str,
-            /,
-            *,
-            category: typing.Optional[typing.Type[Warning]] = DeprecationWarning,
-            stacklevel: int = 1,
-        ) -> None:
-            if not isinstance(message, str):
-                raise TypeError(
-                    "Expected an object of type str for 'message', not "
-                    f"{type(message).__name__!r}"
-                )
-            self.message = message
-            self.category = category
-            self.stacklevel = stacklevel
-
-        def __call__(self, arg: _T, /) -> _T:
-            # Make sure the inner functions created below don't
-            # retain a reference to self.
-            msg = self.message
-            category = self.category
-            stacklevel = self.stacklevel
-            if category is None:
-                arg.__deprecated__ = msg
-                return arg
-            elif isinstance(arg, type):
-                import functools
-                from types import MethodType
-
-                original_new = arg.__new__
-
-                @functools.wraps(original_new)
-                def __new__(cls, *args, **kwargs):
-                    if cls is arg:
-                        warnings.warn(msg, category=category, stacklevel=stacklevel + 1)
-                    if original_new is not object.__new__:
-                        return original_new(cls, *args, **kwargs)
-                    # Mirrors a similar check in object.__new__.
-                    elif cls.__init__ is object.__init__ and (args or kwargs):
-                        raise TypeError(f"{cls.__name__}() takes no arguments")
-                    else:
-                        return original_new(cls)
-
-                arg.__new__ = staticmethod(__new__)
-
-                original_init_subclass = arg.__init_subclass__
-                # We need slightly different behavior if __init_subclass__
-                # is a bound method (likely if it was implemented in Python)
-                if isinstance(original_init_subclass, MethodType):
-                    original_init_subclass = original_init_subclass.__func__
-
-                    @functools.wraps(original_init_subclass)
-                    def __init_subclass__(*args, **kwargs):
-                        warnings.warn(msg, category=category, stacklevel=stacklevel + 1)
-                        return original_init_subclass(*args, **kwargs)
-
-                    arg.__init_subclass__ = classmethod(__init_subclass__)
-                # Or otherwise, which likely means it's a builtin such as
-                # object's implementation of __init_subclass__.
-                else:
-                    @functools.wraps(original_init_subclass)
-                    def __init_subclass__(*args, **kwargs):
-                        warnings.warn(msg, category=category, stacklevel=stacklevel + 1)
-                        return original_init_subclass(*args, **kwargs)
-
-                    arg.__init_subclass__ = __init_subclass__
-
-                arg.__deprecated__ = __new__.__deprecated__ = msg
-                __init_subclass__.__deprecated__ = msg
-                return arg
-            elif callable(arg):
-                import functools
-
-                @functools.wraps(arg)
-                def wrapper(*args, **kwargs):
-                    warnings.warn(msg, category=category, stacklevel=stacklevel + 1)
-                    return arg(*args, **kwargs)
-
-                arg.__deprecated__ = wrapper.__deprecated__ = msg
-                return wrapper
-            else:
-                raise TypeError(
-                    "@deprecated decorator with non-None category must be applied to "
-                    f"a class or callable, not {arg!r}"
-                )
+        return __arg
 
 
 # We have to do some monkey patching to deal with the dual nature of
@@ -2693,14 +2120,18 @@ if not hasattr(typing, "TypeVarTuple"):
     typing._check_generic = _check_generic
 
 
-# Backport typing.NamedTuple as it exists in Python 3.13.
+# Backport typing.NamedTuple as it exists in Python 3.11.
 # In 3.11, the ability to define generic `NamedTuple`s was supported.
 # This was explicitly disallowed in 3.9-3.10, and only half-worked in <=3.8.
-# On 3.12, we added __orig_bases__ to call-based NamedTuples
-# On 3.13, we deprecated kwargs-based NamedTuples
-if sys.version_info >= (3, 13):
+if sys.version_info >= (3, 11):
     NamedTuple = typing.NamedTuple
 else:
+    def _caller():
+        try:
+            return sys._getframe(2).f_globals.get('__name__', '__main__')
+        except (AttributeError, ValueError):  # For platforms without _getframe()
+            return None
+
     def _make_nmtuple(name, types, module, defaults=()):
         fields = [n for n, t in types]
         annotations = {n: typing._type_check(t, f"field {n} annotation must be a type")
@@ -2742,486 +2173,37 @@ else:
             )
             nm_tpl.__bases__ = bases
             if typing.Generic in bases:
-                if hasattr(typing, '_generic_class_getitem'):  # 3.12+
-                    nm_tpl.__class_getitem__ = classmethod(typing._generic_class_getitem)
-                else:
-                    class_getitem = typing.Generic.__class_getitem__.__func__
-                    nm_tpl.__class_getitem__ = classmethod(class_getitem)
+                class_getitem = typing.Generic.__class_getitem__.__func__
+                nm_tpl.__class_getitem__ = classmethod(class_getitem)
             # update from user namespace without overriding special namedtuple attributes
-            for key, val in ns.items():
+            for key in ns:
                 if key in _prohibited_namedtuple_fields:
                     raise AttributeError("Cannot overwrite NamedTuple attribute " + key)
-                elif key not in _special_namedtuple_fields:
-                    if key not in nm_tpl._fields:
-                        setattr(nm_tpl, key, ns[key])
-                    try:
-                        set_name = type(val).__set_name__
-                    except AttributeError:
-                        pass
-                    else:
-                        try:
-                            set_name(val, nm_tpl, key)
-                        except BaseException as e:
-                            msg = (
-                                f"Error calling __set_name__ on {type(val).__name__!r} "
-                                f"instance {key!r} in {typename!r}"
-                            )
-                            # BaseException.add_note() existed on py311,
-                            # but the __set_name__ machinery didn't start
-                            # using add_note() until py312.
-                            # Making sure exceptions are raised in the same way
-                            # as in "normal" classes seems most important here.
-                            if sys.version_info >= (3, 12):
-                                e.add_note(msg)
-                                raise
-                            else:
-                                raise RuntimeError(msg) from e
-
+                elif key not in _special_namedtuple_fields and key not in nm_tpl._fields:
+                    setattr(nm_tpl, key, ns[key])
             if typing.Generic in bases:
                 nm_tpl.__init_subclass__()
             return nm_tpl
 
+    def NamedTuple(__typename, __fields=None, **kwargs):
+        if __fields is None:
+            __fields = kwargs.items()
+        elif kwargs:
+            raise TypeError("Either list of fields or keywords"
+                            " can be provided to NamedTuple, not both")
+        return _make_nmtuple(__typename, __fields, module=_caller())
+
+    NamedTuple.__doc__ = typing.NamedTuple.__doc__
     _NamedTuple = type.__new__(_NamedTupleMeta, 'NamedTuple', (), {})
 
+    # On 3.8+, alter the signature so that it matches typing.NamedTuple.
+    # The signature of typing.NamedTuple on >=3.8 is invalid syntax in Python 3.7,
+    # so just leave the signature as it is on 3.7.
+    if sys.version_info >= (3, 8):
+        NamedTuple.__text_signature__ = '(typename, fields=None, /, **kwargs)'
+
     def _namedtuple_mro_entries(bases):
         assert NamedTuple in bases
         return (_NamedTuple,)
 
-    @_ensure_subclassable(_namedtuple_mro_entries)
-    def NamedTuple(typename, fields=_marker, /, **kwargs):
-        """Typed version of namedtuple.
-
-        Usage::
-
-            class Employee(NamedTuple):
-                name: str
-                id: int
-
-        This is equivalent to::
-
-            Employee = collections.namedtuple('Employee', ['name', 'id'])
-
-        The resulting class has an extra __annotations__ attribute, giving a
-        dict that maps field names to types.  (The field names are also in
-        the _fields attribute, which is part of the namedtuple API.)
-        An alternative equivalent functional syntax is also accepted::
-
-            Employee = NamedTuple('Employee', [('name', str), ('id', int)])
-        """
-        if fields is _marker:
-            if kwargs:
-                deprecated_thing = "Creating NamedTuple classes using keyword arguments"
-                deprecation_msg = (
-                    "{name} is deprecated and will be disallowed in Python {remove}. "
-                    "Use the class-based or functional syntax instead."
-                )
-            else:
-                deprecated_thing = "Failing to pass a value for the 'fields' parameter"
-                example = f"`{typename} = NamedTuple({typename!r}, [])`"
-                deprecation_msg = (
-                    "{name} is deprecated and will be disallowed in Python {remove}. "
-                    "To create a NamedTuple class with 0 fields "
-                    "using the functional syntax, "
-                    "pass an empty list, e.g. "
-                ) + example + "."
-        elif fields is None:
-            if kwargs:
-                raise TypeError(
-                    "Cannot pass `None` as the 'fields' parameter "
-                    "and also specify fields using keyword arguments"
-                )
-            else:
-                deprecated_thing = "Passing `None` as the 'fields' parameter"
-                example = f"`{typename} = NamedTuple({typename!r}, [])`"
-                deprecation_msg = (
-                    "{name} is deprecated and will be disallowed in Python {remove}. "
-                    "To create a NamedTuple class with 0 fields "
-                    "using the functional syntax, "
-                    "pass an empty list, e.g. "
-                ) + example + "."
-        elif kwargs:
-            raise TypeError("Either list of fields or keywords"
-                            " can be provided to NamedTuple, not both")
-        if fields is _marker or fields is None:
-            warnings.warn(
-                deprecation_msg.format(name=deprecated_thing, remove="3.15"),
-                DeprecationWarning,
-                stacklevel=2,
-            )
-            fields = kwargs.items()
-        nt = _make_nmtuple(typename, fields, module=_caller())
-        nt.__orig_bases__ = (NamedTuple,)
-        return nt
-
-
-if hasattr(collections.abc, "Buffer"):
-    Buffer = collections.abc.Buffer
-else:
-    class Buffer(abc.ABC):
-        """Base class for classes that implement the buffer protocol.
-
-        The buffer protocol allows Python objects to expose a low-level
-        memory buffer interface. Before Python 3.12, it is not possible
-        to implement the buffer protocol in pure Python code, or even
-        to check whether a class implements the buffer protocol. In
-        Python 3.12 and higher, the ``__buffer__`` method allows access
-        to the buffer protocol from Python code, and the
-        ``collections.abc.Buffer`` ABC allows checking whether a class
-        implements the buffer protocol.
-
-        To indicate support for the buffer protocol in earlier versions,
-        inherit from this ABC, either in a stub file or at runtime,
-        or use ABC registration. This ABC provides no methods, because
-        there is no Python-accessible methods shared by pre-3.12 buffer
-        classes. It is useful primarily for static checks.
-
-        """
-
-    # As a courtesy, register the most common stdlib buffer classes.
-    Buffer.register(memoryview)
-    Buffer.register(bytearray)
-    Buffer.register(bytes)
-
-
-# Backport of types.get_original_bases, available on 3.12+ in CPython
-if hasattr(_types, "get_original_bases"):
-    get_original_bases = _types.get_original_bases
-else:
-    def get_original_bases(cls, /):
-        """Return the class's "original" bases prior to modification by `__mro_entries__`.
-
-        Examples::
-
-            from typing import TypeVar, Generic
-            from typing_extensions import NamedTuple, TypedDict
-
-            T = TypeVar("T")
-            class Foo(Generic[T]): ...
-            class Bar(Foo[int], float): ...
-            class Baz(list[str]): ...
-            Eggs = NamedTuple("Eggs", [("a", int), ("b", str)])
-            Spam = TypedDict("Spam", {"a": int, "b": str})
-
-            assert get_original_bases(Bar) == (Foo[int], float)
-            assert get_original_bases(Baz) == (list[str],)
-            assert get_original_bases(Eggs) == (NamedTuple,)
-            assert get_original_bases(Spam) == (TypedDict,)
-            assert get_original_bases(int) == (object,)
-        """
-        try:
-            return cls.__dict__.get("__orig_bases__", cls.__bases__)
-        except AttributeError:
-            raise TypeError(
-                f'Expected an instance of type, not {type(cls).__name__!r}'
-            ) from None
-
-
-# NewType is a class on Python 3.10+, making it pickleable
-# The error message for subclassing instances of NewType was improved on 3.11+
-if sys.version_info >= (3, 11):
-    NewType = typing.NewType
-else:
-    class NewType:
-        """NewType creates simple unique types with almost zero
-        runtime overhead. NewType(name, tp) is considered a subtype of tp
-        by static type checkers. At runtime, NewType(name, tp) returns
-        a dummy callable that simply returns its argument. Usage::
-            UserId = NewType('UserId', int)
-            def name_by_id(user_id: UserId) -> str:
-                ...
-            UserId('user')          # Fails type check
-            name_by_id(42)          # Fails type check
-            name_by_id(UserId(42))  # OK
-            num = UserId(5) + 1     # type: int
-        """
-
-        def __call__(self, obj, /):
-            return obj
-
-        def __init__(self, name, tp):
-            self.__qualname__ = name
-            if '.' in name:
-                name = name.rpartition('.')[-1]
-            self.__name__ = name
-            self.__supertype__ = tp
-            def_mod = _caller()
-            if def_mod != 'typing_extensions':
-                self.__module__ = def_mod
-
-        def __mro_entries__(self, bases):
-            # We defined __mro_entries__ to get a better error message
-            # if a user attempts to subclass a NewType instance. bpo-46170
-            supercls_name = self.__name__
-
-            class Dummy:
-                def __init_subclass__(cls):
-                    subcls_name = cls.__name__
-                    raise TypeError(
-                        f"Cannot subclass an instance of NewType. "
-                        f"Perhaps you were looking for: "
-                        f"`{subcls_name} = NewType({subcls_name!r}, {supercls_name})`"
-                    )
-
-            return (Dummy,)
-
-        def __repr__(self):
-            return f'{self.__module__}.{self.__qualname__}'
-
-        def __reduce__(self):
-            return self.__qualname__
-
-        if sys.version_info >= (3, 10):
-            # PEP 604 methods
-            # It doesn't make sense to have these methods on Python <3.10
-
-            def __or__(self, other):
-                return typing.Union[self, other]
-
-            def __ror__(self, other):
-                return typing.Union[other, self]
-
-
-if hasattr(typing, "TypeAliasType"):
-    TypeAliasType = typing.TypeAliasType
-else:
-    def _is_unionable(obj):
-        """Corresponds to is_unionable() in unionobject.c in CPython."""
-        return obj is None or isinstance(obj, (
-            type,
-            _types.GenericAlias,
-            _types.UnionType,
-            TypeAliasType,
-        ))
-
-    class TypeAliasType:
-        """Create named, parameterized type aliases.
-
-        This provides a backport of the new `type` statement in Python 3.12:
-
-            type ListOrSet[T] = list[T] | set[T]
-
-        is equivalent to:
-
-            T = TypeVar("T")
-            ListOrSet = TypeAliasType("ListOrSet", list[T] | set[T], type_params=(T,))
-
-        The name ListOrSet can then be used as an alias for the type it refers to.
-
-        The type_params argument should contain all the type parameters used
-        in the value of the type alias. If the alias is not generic, this
-        argument is omitted.
-
-        Static type checkers should only support type aliases declared using
-        TypeAliasType that follow these rules:
-
-        - The first argument (the name) must be a string literal.
-        - The TypeAliasType instance must be immediately assigned to a variable
-          of the same name. (For example, 'X = TypeAliasType("Y", int)' is invalid,
-          as is 'X, Y = TypeAliasType("X", int), TypeAliasType("Y", int)').
-
-        """
-
-        def __init__(self, name: str, value, *, type_params=()):
-            if not isinstance(name, str):
-                raise TypeError("TypeAliasType name must be a string")
-            self.__value__ = value
-            self.__type_params__ = type_params
-
-            parameters = []
-            for type_param in type_params:
-                if isinstance(type_param, TypeVarTuple):
-                    parameters.extend(type_param)
-                else:
-                    parameters.append(type_param)
-            self.__parameters__ = tuple(parameters)
-            def_mod = _caller()
-            if def_mod != 'typing_extensions':
-                self.__module__ = def_mod
-            # Setting this attribute closes the TypeAliasType from further modification
-            self.__name__ = name
-
-        def __setattr__(self, name: str, value: object, /) -> None:
-            if hasattr(self, "__name__"):
-                self._raise_attribute_error(name)
-            super().__setattr__(name, value)
-
-        def __delattr__(self, name: str, /) -> Never:
-            self._raise_attribute_error(name)
-
-        def _raise_attribute_error(self, name: str) -> Never:
-            # Match the Python 3.12 error messages exactly
-            if name == "__name__":
-                raise AttributeError("readonly attribute")
-            elif name in {"__value__", "__type_params__", "__parameters__", "__module__"}:
-                raise AttributeError(
-                    f"attribute '{name}' of 'typing.TypeAliasType' objects "
-                    "is not writable"
-                )
-            else:
-                raise AttributeError(
-                    f"'typing.TypeAliasType' object has no attribute '{name}'"
-                )
-
-        def __repr__(self) -> str:
-            return self.__name__
-
-        def __getitem__(self, parameters):
-            if not isinstance(parameters, tuple):
-                parameters = (parameters,)
-            parameters = [
-                typing._type_check(
-                    item, f'Subscripting {self.__name__} requires a type.'
-                )
-                for item in parameters
-            ]
-            return typing._GenericAlias(self, tuple(parameters))
-
-        def __reduce__(self):
-            return self.__name__
-
-        def __init_subclass__(cls, *args, **kwargs):
-            raise TypeError(
-                "type 'typing_extensions.TypeAliasType' is not an acceptable base type"
-            )
-
-        # The presence of this method convinces typing._type_check
-        # that TypeAliasTypes are types.
-        def __call__(self):
-            raise TypeError("Type alias is not callable")
-
-        if sys.version_info >= (3, 10):
-            def __or__(self, right):
-                # For forward compatibility with 3.12, reject Unions
-                # that are not accepted by the built-in Union.
-                if not _is_unionable(right):
-                    return NotImplemented
-                return typing.Union[self, right]
-
-            def __ror__(self, left):
-                if not _is_unionable(left):
-                    return NotImplemented
-                return typing.Union[left, self]
-
-
-if hasattr(typing, "is_protocol"):
-    is_protocol = typing.is_protocol
-    get_protocol_members = typing.get_protocol_members
-else:
-    def is_protocol(tp: type, /) -> bool:
-        """Return True if the given type is a Protocol.
-
-        Example::
-
-            >>> from typing_extensions import Protocol, is_protocol
-            >>> class P(Protocol):
-            ...     def a(self) -> str: ...
-            ...     b: int
-            >>> is_protocol(P)
-            True
-            >>> is_protocol(int)
-            False
-        """
-        return (
-            isinstance(tp, type)
-            and getattr(tp, '_is_protocol', False)
-            and tp is not Protocol
-            and tp is not typing.Protocol
-        )
-
-    def get_protocol_members(tp: type, /) -> typing.FrozenSet[str]:
-        """Return the set of members defined in a Protocol.
-
-        Example::
-
-            >>> from typing_extensions import Protocol, get_protocol_members
-            >>> class P(Protocol):
-            ...     def a(self) -> str: ...
-            ...     b: int
-            >>> get_protocol_members(P)
-            frozenset({'a', 'b'})
-
-        Raise a TypeError for arguments that are not Protocols.
-        """
-        if not is_protocol(tp):
-            raise TypeError(f'{tp!r} is not a Protocol')
-        if hasattr(tp, '__protocol_attrs__'):
-            return frozenset(tp.__protocol_attrs__)
-        return frozenset(_get_protocol_attrs(tp))
-
-
-if hasattr(typing, "Doc"):
-    Doc = typing.Doc
-else:
-    class Doc:
-        """Define the documentation of a type annotation using ``Annotated``, to be
-         used in class attributes, function and method parameters, return values,
-         and variables.
-
-        The value should be a positional-only string literal to allow static tools
-        like editors and documentation generators to use it.
-
-        This complements docstrings.
-
-        The string value passed is available in the attribute ``documentation``.
-
-        Example::
-
-            >>> from typing_extensions import Annotated, Doc
-            >>> def hi(to: Annotated[str, Doc("Who to say hi to")]) -> None: ...
-        """
-        def __init__(self, documentation: str, /) -> None:
-            self.documentation = documentation
-
-        def __repr__(self) -> str:
-            return f"Doc({self.documentation!r})"
-
-        def __hash__(self) -> int:
-            return hash(self.documentation)
-
-        def __eq__(self, other: object) -> bool:
-            if not isinstance(other, Doc):
-                return NotImplemented
-            return self.documentation == other.documentation
-
-
-# Aliases for items that have always been in typing.
-# Explicitly assign these (rather than using `from typing import *` at the top),
-# so that we get a CI error if one of these is deleted from typing.py
-# in a future version of Python
-AbstractSet = typing.AbstractSet
-AnyStr = typing.AnyStr
-BinaryIO = typing.BinaryIO
-Callable = typing.Callable
-Collection = typing.Collection
-Container = typing.Container
-Dict = typing.Dict
-ForwardRef = typing.ForwardRef
-FrozenSet = typing.FrozenSet
-Generator = typing.Generator
-Generic = typing.Generic
-Hashable = typing.Hashable
-IO = typing.IO
-ItemsView = typing.ItemsView
-Iterable = typing.Iterable
-Iterator = typing.Iterator
-KeysView = typing.KeysView
-List = typing.List
-Mapping = typing.Mapping
-MappingView = typing.MappingView
-Match = typing.Match
-MutableMapping = typing.MutableMapping
-MutableSequence = typing.MutableSequence
-MutableSet = typing.MutableSet
-Optional = typing.Optional
-Pattern = typing.Pattern
-Reversible = typing.Reversible
-Sequence = typing.Sequence
-Set = typing.Set
-Sized = typing.Sized
-TextIO = typing.TextIO
-Tuple = typing.Tuple
-Union = typing.Union
-ValuesView = typing.ValuesView
-cast = typing.cast
-no_type_check = typing.no_type_check
-no_type_check_decorator = typing.no_type_check_decorator
+    NamedTuple.__mro_entries__ = _namedtuple_mro_entries
diff --git a/lib/win32/Demos/BackupRead_BackupWrite.py b/lib/win32/Demos/BackupRead_BackupWrite.py
deleted file mode 100644
index 0e9fc9f9..00000000
--- a/lib/win32/Demos/BackupRead_BackupWrite.py
+++ /dev/null
@@ -1,121 +0,0 @@
-## demonstrates using BackupRead and BackupWrite to copy all of a file's data streams
-
-
-import ntsecuritycon
-import pythoncom
-import pywintypes
-import win32api
-import win32con
-import win32file
-import win32security
-from pywin32_testutil import ob2memory, str2bytes
-from win32com import storagecon
-
-all_sd_info = (
-    win32security.DACL_SECURITY_INFORMATION
-    | win32security.DACL_SECURITY_INFORMATION
-    | win32security.OWNER_SECURITY_INFORMATION
-    | win32security.GROUP_SECURITY_INFORMATION
-)
-
-tempdir = win32api.GetTempPath()
-tempfile = win32api.GetTempFileName(tempdir, "bkr")[0]
-outfile = win32api.GetTempFileName(tempdir, "out")[0]
-print("Filename:", tempfile, "Output file:", outfile)
-
-f = open(tempfile, "w")
-f.write("some random junk" + "x" * 100)
-f.close()
-
-## add a couple of alternate data streams
-f = open(tempfile + ":streamdata", "w")
-f.write("data written to alternate stream" + "y" * 100)
-f.close()
-
-f = open(tempfile + ":anotherstream", "w")
-f.write("z" * 100)
-f.close()
-
-## add Summary Information, which is stored as a separate stream
-m = storagecon.STGM_READWRITE | storagecon.STGM_SHARE_EXCLUSIVE | storagecon.STGM_DIRECT
-pss = pythoncom.StgOpenStorageEx(
-    tempfile, m, storagecon.STGFMT_FILE, 0, pythoncom.IID_IPropertySetStorage, None
-)
-ps = pss.Create(
-    pythoncom.FMTID_SummaryInformation,
-    pythoncom.IID_IPropertyStorage,
-    0,
-    storagecon.STGM_READWRITE | storagecon.STGM_SHARE_EXCLUSIVE,
-)
-ps.WriteMultiple(
-    (storagecon.PIDSI_KEYWORDS, storagecon.PIDSI_COMMENTS), ("keywords", "comments")
-)
-ps = None
-pss = None
-
-## add a custom security descriptor to make sure we don't
-##   get a default that would always be the same for both files in temp dir
-new_sd = pywintypes.SECURITY_DESCRIPTOR()
-sid = win32security.LookupAccountName("", "EveryOne")[0]
-acl = pywintypes.ACL()
-acl.AddAccessAllowedAce(1, win32con.GENERIC_READ, sid)
-acl.AddAccessAllowedAce(1, ntsecuritycon.FILE_APPEND_DATA, sid)
-acl.AddAccessAllowedAce(1, win32con.GENERIC_WRITE, sid)
-acl.AddAccessAllowedAce(1, ntsecuritycon.FILE_ALL_ACCESS, sid)
-
-new_sd.SetSecurityDescriptorDacl(True, acl, False)
-win32security.SetFileSecurity(tempfile, win32security.DACL_SECURITY_INFORMATION, new_sd)
-
-
-sa = pywintypes.SECURITY_ATTRIBUTES()
-sa.bInheritHandle = True
-h = win32file.CreateFile(
-    tempfile,
-    win32con.GENERIC_ALL,
-    win32con.FILE_SHARE_READ,
-    sa,
-    win32con.OPEN_EXISTING,
-    win32file.FILE_FLAG_BACKUP_SEMANTICS,
-    None,
-)
-
-outh = win32file.CreateFile(
-    outfile,
-    win32con.GENERIC_ALL,
-    win32con.FILE_SHARE_READ | win32con.FILE_SHARE_WRITE,
-    sa,
-    win32con.OPEN_EXISTING,
-    win32file.FILE_FLAG_BACKUP_SEMANTICS,
-    None,
-)
-
-ctxt = 0
-outctxt = 0
-buf = None
-readsize = 100
-
-while 1:
-    bytes_read, buf, ctxt = win32file.BackupRead(h, readsize, buf, False, True, ctxt)
-    if bytes_read == 0:
-        break
-    bytes_written, outctxt = win32file.BackupWrite(
-        outh, bytes_read, buf, False, True, outctxt
-    )
-    print("Written:", bytes_written, "Context:", outctxt)
-win32file.BackupRead(h, 0, buf, True, True, ctxt)
-win32file.BackupWrite(outh, 0, str2bytes(""), True, True, outctxt)
-win32file.CloseHandle(h)
-win32file.CloseHandle(outh)
-
-assert open(tempfile).read() == open(outfile).read(), "File contents differ !"
-assert (
-    open(tempfile + ":streamdata").read() == open(outfile + ":streamdata").read()
-), "streamdata contents differ !"
-assert (
-    open(tempfile + ":anotherstream").read() == open(outfile + ":anotherstream").read()
-), "anotherstream contents differ !"
-assert (
-    ob2memory(win32security.GetFileSecurity(tempfile, all_sd_info))[:]
-    == ob2memory(win32security.GetFileSecurity(outfile, all_sd_info))[:]
-), "Security descriptors are different !"
-## also should check Summary Info programatically
diff --git a/lib/win32/Demos/BackupSeek_streamheaders.py b/lib/win32/Demos/BackupSeek_streamheaders.py
deleted file mode 100644
index 8b828d1d..00000000
--- a/lib/win32/Demos/BackupSeek_streamheaders.py
+++ /dev/null
@@ -1,137 +0,0 @@
-## demonstrates using BackupSeek to enumerate data streams for a file
-import struct
-
-import pythoncom
-import pywintypes
-import win32api
-import win32con
-import win32file
-from win32com import storagecon
-
-stream_types = {
-    win32con.BACKUP_DATA: "Standard data",
-    win32con.BACKUP_EA_DATA: "Extended attribute data",
-    win32con.BACKUP_SECURITY_DATA: "Security descriptor data",
-    win32con.BACKUP_ALTERNATE_DATA: "Alternative data streams",
-    win32con.BACKUP_LINK: "Hard link information",
-    win32con.BACKUP_PROPERTY_DATA: "Property data",
-    win32con.BACKUP_OBJECT_ID: "Objects identifiers",
-    win32con.BACKUP_REPARSE_DATA: "Reparse points",
-    win32con.BACKUP_SPARSE_BLOCK: "Sparse file",
-}
-
-tempdir = win32api.GetTempPath()
-tempfile = win32api.GetTempFileName(tempdir, "bkr")[0]
-print("Filename:", tempfile)
-
-f = open(tempfile, "w")
-f.write("some random junk" + "x" * 100)
-f.close()
-
-f = open(tempfile + ":streamdata", "w")
-f.write("data written to alternate stream" + "y" * 100)
-f.close()
-
-f = open(tempfile + ":anotherstream", "w")
-f.write("z" * 200)
-f.close()
-
-## add Summary Information, which is stored as a separate stream
-m = storagecon.STGM_READWRITE | storagecon.STGM_SHARE_EXCLUSIVE | storagecon.STGM_DIRECT
-pss = pythoncom.StgOpenStorageEx(
-    tempfile, m, storagecon.STGFMT_FILE, 0, pythoncom.IID_IPropertySetStorage, None
-)
-ps = pss.Create(
-    pythoncom.FMTID_SummaryInformation,
-    pythoncom.IID_IPropertyStorage,
-    0,
-    storagecon.STGM_READWRITE | storagecon.STGM_SHARE_EXCLUSIVE,
-)
-ps.WriteMultiple(
-    (storagecon.PIDSI_KEYWORDS, storagecon.PIDSI_COMMENTS), ("keywords", "comments")
-)
-ps = None
-pss = None
-
-sa = pywintypes.SECURITY_ATTRIBUTES()
-sa.bInheritHandle = False
-h = win32file.CreateFile(
-    tempfile,
-    win32con.GENERIC_ALL,
-    win32con.FILE_SHARE_READ,
-    sa,
-    win32con.OPEN_EXISTING,
-    win32file.FILE_FLAG_BACKUP_SEMANTICS,
-    None,
-)
-
-
-""" stream header:
-typedef struct _WIN32_STREAM_ID {
-    DWORD dwStreamId;  DWORD dwStreamAttributes;  LARGE_INTEGER Size;
-    DWORD dwStreamNameSize;  WCHAR cStreamName[ANYSIZE_ARRAY];
-}
-"""
-
-win32_stream_id_format = "LLQL"
-win32_stream_id_size = struct.calcsize(win32_stream_id_format)
-
-
-def parse_stream_header(h, ctxt, data):
-    stream_type, stream_attributes, stream_size, stream_name_size = struct.unpack(
-        win32_stream_id_format, data
-    )
-    print(
-        "\nType:",
-        stream_type,
-        stream_types[stream_type],
-        "Attributes:",
-        stream_attributes,
-        "Size:",
-        stream_size,
-        "Name len:",
-        stream_name_size,
-    )
-    if stream_name_size > 0:
-        ## ??? sdk says this size is in characters, but it appears to be number of bytes ???
-        bytes_read, stream_name_buf, ctxt = win32file.BackupRead(
-            h, stream_name_size, None, False, True, ctxt
-        )
-        stream_name = pywintypes.UnicodeFromRaw(stream_name_buf[:])
-    else:
-        stream_name = "Unnamed"
-    print("Name:" + stream_name)
-    return (
-        ctxt,
-        stream_type,
-        stream_attributes,
-        stream_size,
-        stream_name_size,
-        stream_name,
-    )
-
-
-ctxt = 0
-win32_stream_id_buf = (
-    None  ## gets rebound to a writable buffer on first call and reused
-)
-while 1:
-    bytes_read, win32_stream_id_buf, ctxt = win32file.BackupRead(
-        h, win32_stream_id_size, win32_stream_id_buf, False, True, ctxt
-    )
-    if bytes_read == 0:
-        break
-    (
-        ctxt,
-        stream_type,
-        stream_attributes,
-        stream_size,
-        stream_name_size,
-        stream_name,
-    ) = parse_stream_header(h, ctxt, win32_stream_id_buf[:])
-    if stream_size > 0:
-        bytes_moved = win32file.BackupSeek(h, stream_size, ctxt)
-        print("Moved: ", bytes_moved)
-
-win32file.BackupRead(h, win32_stream_id_size, win32_stream_id_buf, True, True, ctxt)
-win32file.CloseHandle(h)
diff --git a/lib/win32/Demos/CopyFileEx.py b/lib/win32/Demos/CopyFileEx.py
deleted file mode 100644
index cdac78e5..00000000
--- a/lib/win32/Demos/CopyFileEx.py
+++ /dev/null
@@ -1,57 +0,0 @@
-import win32api
-import win32file
-
-
-def ProgressRoutine(
-    TotalFileSize,
-    TotalBytesTransferred,
-    StreamSize,
-    StreamBytesTransferred,
-    StreamNumber,
-    CallbackReason,
-    SourceFile,
-    DestinationFile,
-    Data,
-):
-    print(Data)
-    print(
-        TotalFileSize,
-        TotalBytesTransferred,
-        StreamSize,
-        StreamBytesTransferred,
-        StreamNumber,
-        CallbackReason,
-        SourceFile,
-        DestinationFile,
-    )
-    ##if TotalBytesTransferred > 100000:
-    ##    return win32file.PROGRESS_STOP
-    return win32file.PROGRESS_CONTINUE
-
-
-temp_dir = win32api.GetTempPath()
-fsrc = win32api.GetTempFileName(temp_dir, "cfe")[0]
-fdst = win32api.GetTempFileName(temp_dir, "cfe")[0]
-print(fsrc, fdst)
-
-f = open(fsrc, "w")
-f.write("xxxxxxxxxxxxxxxx\n" * 32768)
-f.close()
-## add a couple of extra data streams
-f = open(fsrc + ":stream_y", "w")
-f.write("yyyyyyyyyyyyyyyy\n" * 32768)
-f.close()
-f = open(fsrc + ":stream_z", "w")
-f.write("zzzzzzzzzzzzzzzz\n" * 32768)
-f.close()
-
-operation_desc = "Copying " + fsrc + " to " + fdst
-win32file.CopyFileEx(
-    fsrc,
-    fdst,
-    ProgressRoutine,
-    Data=operation_desc,
-    Cancel=False,
-    CopyFlags=win32file.COPY_FILE_RESTARTABLE,
-    Transaction=None,
-)
diff --git a/lib/win32/Demos/CreateFileTransacted_MiniVersion.py b/lib/win32/Demos/CreateFileTransacted_MiniVersion.py
deleted file mode 100644
index fd600b59..00000000
--- a/lib/win32/Demos/CreateFileTransacted_MiniVersion.py
+++ /dev/null
@@ -1,123 +0,0 @@
-"""
-This demonstrates the creation of miniversions of a file during a transaction.
-The FSCTL_TXFS_CREATE_MINIVERSION control code saves any changes to a new
-miniversion (effectively a savepoint within a transaction).
-"""
-
-import os
-import struct
-
-import win32api
-import win32con
-import win32file
-import win32transaction
-import winerror
-import winioctlcon
-from pywin32_testutil import str2bytes  # py3k-friendly helper
-
-
-def demo():
-    """
-    Definition of buffer used with FSCTL_TXFS_CREATE_MINIVERSION:
-    typedef struct _TXFS_CREATE_MINIVERSION_INFO{
-        USHORT StructureVersion;
-        USHORT StructureLength;
-        ULONG BaseVersion;
-        USHORT MiniVersion;}
-    """
-    buf_fmt = "HHLH0L"  ## buffer size must include struct padding
-    buf_size = struct.calcsize(buf_fmt)
-
-    tempdir = win32api.GetTempPath()
-    tempfile = win32api.GetTempFileName(tempdir, "cft")[0]
-    print("Demonstrating transactions on tempfile", tempfile)
-    f = open(tempfile, "w")
-    f.write("This is original file.\n")
-    f.close()
-
-    trans = win32transaction.CreateTransaction(
-        Description="Test creating miniversions of a file"
-    )
-    hfile = win32file.CreateFileW(
-        tempfile,
-        win32con.GENERIC_READ | win32con.GENERIC_WRITE,
-        win32con.FILE_SHARE_READ | win32con.FILE_SHARE_WRITE,
-        None,
-        win32con.OPEN_EXISTING,
-        0,
-        None,
-        Transaction=trans,
-    )
-
-    win32file.WriteFile(hfile, str2bytes("This is first miniversion.\n"))
-    buf = win32file.DeviceIoControl(
-        hfile, winioctlcon.FSCTL_TXFS_CREATE_MINIVERSION, None, buf_size, None
-    )
-    struct_ver, struct_len, base_ver, ver_1 = struct.unpack(buf_fmt, buf)
-
-    win32file.SetFilePointer(hfile, 0, win32con.FILE_BEGIN)
-    win32file.WriteFile(hfile, str2bytes("This is second miniversion!\n"))
-    buf = win32file.DeviceIoControl(
-        hfile, winioctlcon.FSCTL_TXFS_CREATE_MINIVERSION, None, buf_size, None
-    )
-    struct_ver, struct_len, base_ver, ver_2 = struct.unpack(buf_fmt, buf)
-    hfile.Close()
-
-    ## miniversions can't be opened with write access
-    hfile_0 = win32file.CreateFileW(
-        tempfile,
-        win32con.GENERIC_READ,
-        win32con.FILE_SHARE_READ | win32con.FILE_SHARE_WRITE,
-        None,
-        win32con.OPEN_EXISTING,
-        0,
-        None,
-        Transaction=trans,
-        MiniVersion=base_ver,
-    )
-    print("version:", base_ver, win32file.ReadFile(hfile_0, 100))
-    hfile_0.Close()
-
-    hfile_1 = win32file.CreateFileW(
-        tempfile,
-        win32con.GENERIC_READ,
-        win32con.FILE_SHARE_READ | win32con.FILE_SHARE_WRITE,
-        None,
-        win32con.OPEN_EXISTING,
-        0,
-        None,
-        Transaction=trans,
-        MiniVersion=ver_1,
-    )
-    print("version:", ver_1, win32file.ReadFile(hfile_1, 100))
-    hfile_1.Close()
-
-    hfile_2 = win32file.CreateFileW(
-        tempfile,
-        win32con.GENERIC_READ,
-        win32con.FILE_SHARE_READ | win32con.FILE_SHARE_WRITE,
-        None,
-        win32con.OPEN_EXISTING,
-        0,
-        None,
-        Transaction=trans,
-        MiniVersion=ver_2,
-    )
-    print("version:", ver_2, win32file.ReadFile(hfile_2, 100))
-    hfile_2.Close()
-
-    ## MiniVersions are destroyed when transaction is committed or rolled back
-    win32transaction.CommitTransaction(trans)
-
-    os.unlink(tempfile)
-
-
-if __name__ == "__main__":
-    # When run on CI, this fails with NOT_SUPPORTED, so don't have that cause "failure"
-    try:
-        demo()
-    except win32file.error as e:
-        if e.winerror == winerror.ERROR_NOT_SUPPORTED:
-            print("These features are not supported by this filesystem.")
-        else:
-            raise
diff --git a/lib/win32/Demos/EvtFormatMessage.py b/lib/win32/Demos/EvtFormatMessage.py
deleted file mode 100644
index 12543869..00000000
--- a/lib/win32/Demos/EvtFormatMessage.py
+++ /dev/null
@@ -1,83 +0,0 @@
-import sys
-
-import win32evtlog
-
-
-def main():
-    path = "System"
-    num_events = 5
-    if len(sys.argv) > 2:
-        path = sys.argv[1]
-        num_events = int(sys.argv[2])
-    elif len(sys.argv) > 1:
-        path = sys.argv[1]
-
-    query = win32evtlog.EvtQuery(path, win32evtlog.EvtQueryForwardDirection)
-    events = win32evtlog.EvtNext(query, num_events)
-    context = win32evtlog.EvtCreateRenderContext(win32evtlog.EvtRenderContextSystem)
-
-    for i, event in enumerate(events, 1):
-        result = win32evtlog.EvtRender(
-            event, win32evtlog.EvtRenderEventValues, Context=context
-        )
-
-        print("Event {}".format(i))
-
-        level_value, level_variant = result[win32evtlog.EvtSystemLevel]
-        if level_variant != win32evtlog.EvtVarTypeNull:
-            if level_value == 1:
-                print("    Level: CRITICAL")
-            elif level_value == 2:
-                print("    Level: ERROR")
-            elif level_value == 3:
-                print("    Level: WARNING")
-            elif level_value == 4:
-                print("    Level: INFO")
-            elif level_value == 5:
-                print("    Level: VERBOSE")
-            else:
-                print("    Level: UNKNOWN")
-
-        time_created_value, time_created_variant = result[
-            win32evtlog.EvtSystemTimeCreated
-        ]
-        if time_created_variant != win32evtlog.EvtVarTypeNull:
-            print("    Timestamp: {}".format(time_created_value.isoformat()))
-
-        computer_value, computer_variant = result[win32evtlog.EvtSystemComputer]
-        if computer_variant != win32evtlog.EvtVarTypeNull:
-            print("    FQDN: {}".format(computer_value))
-
-        provider_name_value, provider_name_variant = result[
-            win32evtlog.EvtSystemProviderName
-        ]
-        if provider_name_variant != win32evtlog.EvtVarTypeNull:
-            print("    Provider: {}".format(provider_name_value))
-
-            try:
-                metadata = win32evtlog.EvtOpenPublisherMetadata(provider_name_value)
-            # pywintypes.error: (2, 'EvtOpenPublisherMetadata', 'The system cannot find the file specified.')
-            except Exception:
-                pass
-            else:
-                try:
-                    message = win32evtlog.EvtFormatMessage(
-                        metadata, event, win32evtlog.EvtFormatMessageEvent
-                    )
-                # pywintypes.error: (15027, 'EvtFormatMessage: allocated 0, need buffer of size 0', 'The message resource is present but the message was not found in the message table.')
-                except Exception:
-                    pass
-                else:
-                    try:
-                        print("    Message: {}".format(message))
-                    except UnicodeEncodeError:
-                        # Obscure error when run under subprocess.Popen(), presumably due to
-                        # not knowing the correct encoding for the console.
-                        # > UnicodeEncodeError: \'charmap\' codec can\'t encode character \'\\u200e\' in position 57: character maps to <undefined>\r\n'
-                        # Can't reproduce when running manually, so it seems more a subprocess.Popen()
-                        # than ours:
-                        print(" Failed to decode:", repr(message))
-
-
-if __name__ == "__main__":
-    main()
diff --git a/lib/win32/Demos/EvtSubscribe_pull.py b/lib/win32/Demos/EvtSubscribe_pull.py
deleted file mode 100644
index f4059796..00000000
--- a/lib/win32/Demos/EvtSubscribe_pull.py
+++ /dev/null
@@ -1,28 +0,0 @@
-## Demonstrates how to create a "pull" subscription
-import win32con
-import win32event
-import win32evtlog
-
-query_text = '*[System[Provider[@Name="Microsoft-Windows-Winlogon"]]]'
-
-h = win32event.CreateEvent(None, 0, 0, None)
-s = win32evtlog.EvtSubscribe(
-    "System",
-    win32evtlog.EvtSubscribeStartAtOldestRecord,
-    SignalEvent=h,
-    Query=query_text,
-)
-
-while 1:
-    while 1:
-        events = win32evtlog.EvtNext(s, 10)
-        if len(events) == 0:
-            break
-        ##for event in events:
-        ##	print(win32evtlog.EvtRender(event, win32evtlog.EvtRenderEventXml))
-        print("retrieved %s events" % len(events))
-    while 1:
-        print("waiting...")
-        w = win32event.WaitForSingleObjectEx(h, 2000, True)
-        if w == win32con.WAIT_OBJECT_0:
-            break
diff --git a/lib/win32/Demos/EvtSubscribe_push.py b/lib/win32/Demos/EvtSubscribe_push.py
deleted file mode 100644
index 519ef0d7..00000000
--- a/lib/win32/Demos/EvtSubscribe_push.py
+++ /dev/null
@@ -1,25 +0,0 @@
-## Demonstrates a "push" subscription with a callback function
-import win32evtlog
-
-query_text = '*[System[Provider[@Name="Microsoft-Windows-Winlogon"]]]'
-
-
-def c(reason, context, evt):
-    if reason == win32evtlog.EvtSubscribeActionError:
-        print("EvtSubscribeActionError")
-    elif reason == win32evtlog.EvtSubscribeActionDeliver:
-        print("EvtSubscribeActionDeliver")
-    else:
-        print("??? Unknown action ???", reason)
-    context.append(win32evtlog.EvtRender(evt, win32evtlog.EvtRenderEventXml))
-    return 0
-
-
-evttext = []
-s = win32evtlog.EvtSubscribe(
-    "System",
-    win32evtlog.EvtSubscribeStartAtOldestRecord,
-    Query="*",
-    Callback=c,
-    Context=evttext,
-)
diff --git a/lib/win32/Demos/FileSecurityTest.py b/lib/win32/Demos/FileSecurityTest.py
deleted file mode 100644
index 90c45483..00000000
--- a/lib/win32/Demos/FileSecurityTest.py
+++ /dev/null
@@ -1,137 +0,0 @@
-# Contributed by Kelly Kranabetter.
-import os
-import sys
-
-import ntsecuritycon
-import pywintypes
-import win32security
-import winerror
-
-# get security information
-# name=r"c:\autoexec.bat"
-# name= r"g:\!workgrp\lim"
-name = sys.argv[0]
-
-if not os.path.exists(name):
-    print(name, "does not exist!")
-    sys.exit()
-
-print("On file ", name, "\n")
-
-# get owner SID
-print("OWNER")
-try:
-    sd = win32security.GetFileSecurity(name, win32security.OWNER_SECURITY_INFORMATION)
-    sid = sd.GetSecurityDescriptorOwner()
-    print("  ", win32security.LookupAccountSid(None, sid))
-except pywintypes.error as exc:
-    # in automation and network shares we see:
-    # pywintypes.error: (1332, 'LookupAccountName', 'No mapping between account names and security IDs was done.')
-    if exc.winerror != winerror.ERROR_NONE_MAPPED:
-        raise
-    print("No owner information is available")
-
-# get group SID
-try:
-    print("GROUP")
-    sd = win32security.GetFileSecurity(name, win32security.GROUP_SECURITY_INFORMATION)
-    sid = sd.GetSecurityDescriptorGroup()
-    print("  ", win32security.LookupAccountSid(None, sid))
-except pywintypes.error as exc:
-    if exc.winerror != winerror.ERROR_NONE_MAPPED:
-        raise
-    print("No group information is available")
-
-# get ACEs
-sd = win32security.GetFileSecurity(name, win32security.DACL_SECURITY_INFORMATION)
-dacl = sd.GetSecurityDescriptorDacl()
-if dacl == None:
-    print("No Discretionary ACL")
-else:
-    for ace_no in range(0, dacl.GetAceCount()):
-        ace = dacl.GetAce(ace_no)
-        print("ACE", ace_no)
-
-        print("  -Type")
-        for i in (
-            "ACCESS_ALLOWED_ACE_TYPE",
-            "ACCESS_DENIED_ACE_TYPE",
-            "SYSTEM_AUDIT_ACE_TYPE",
-            "SYSTEM_ALARM_ACE_TYPE",
-        ):
-            if getattr(ntsecuritycon, i) == ace[0][0]:
-                print("    ", i)
-
-        print("  -Flags", hex(ace[0][1]))
-        for i in (
-            "OBJECT_INHERIT_ACE",
-            "CONTAINER_INHERIT_ACE",
-            "NO_PROPAGATE_INHERIT_ACE",
-            "INHERIT_ONLY_ACE",
-            "SUCCESSFUL_ACCESS_ACE_FLAG",
-            "FAILED_ACCESS_ACE_FLAG",
-        ):
-            if getattr(ntsecuritycon, i) & ace[0][1] == getattr(ntsecuritycon, i):
-                print("    ", i)
-
-        print("  -mask", hex(ace[1]))
-
-        # files and directories do permissions differently
-        permissions_file = (
-            "DELETE",
-            "READ_CONTROL",
-            "WRITE_DAC",
-            "WRITE_OWNER",
-            "SYNCHRONIZE",
-            "FILE_GENERIC_READ",
-            "FILE_GENERIC_WRITE",
-            "FILE_GENERIC_EXECUTE",
-            "FILE_DELETE_CHILD",
-        )
-        permissions_dir = (
-            "DELETE",
-            "READ_CONTROL",
-            "WRITE_DAC",
-            "WRITE_OWNER",
-            "SYNCHRONIZE",
-            "FILE_ADD_SUBDIRECTORY",
-            "FILE_ADD_FILE",
-            "FILE_DELETE_CHILD",
-            "FILE_LIST_DIRECTORY",
-            "FILE_TRAVERSE",
-            "FILE_READ_ATTRIBUTES",
-            "FILE_WRITE_ATTRIBUTES",
-            "FILE_READ_EA",
-            "FILE_WRITE_EA",
-        )
-        permissions_dir_inherit = (
-            "DELETE",
-            "READ_CONTROL",
-            "WRITE_DAC",
-            "WRITE_OWNER",
-            "SYNCHRONIZE",
-            "GENERIC_READ",
-            "GENERIC_WRITE",
-            "GENERIC_EXECUTE",
-            "GENERIC_ALL",
-        )
-        if os.path.isfile(name):
-            permissions = permissions_file
-        else:
-            permissions = permissions_dir
-            # directories also contain an ACE that is inherited by children (files) within them
-            if (
-                ace[0][1] & ntsecuritycon.OBJECT_INHERIT_ACE
-                == ntsecuritycon.OBJECT_INHERIT_ACE
-                and ace[0][1] & ntsecuritycon.INHERIT_ONLY_ACE
-                == ntsecuritycon.INHERIT_ONLY_ACE
-            ):
-                permissions = permissions_dir_inherit
-
-        calc_mask = 0  # calculate the mask so we can see if we are printing all of the permissions
-        for i in permissions:
-            if getattr(ntsecuritycon, i) & ace[1] == getattr(ntsecuritycon, i):
-                calc_mask = calc_mask | getattr(ntsecuritycon, i)
-                print("    ", i)
-        print("  ", "Calculated Check Mask=", hex(calc_mask))
-        print("  -SID\n    ", win32security.LookupAccountSid(None, ace[2]))
diff --git a/lib/win32/Demos/GetSaveFileName.py b/lib/win32/Demos/GetSaveFileName.py
deleted file mode 100644
index 28587505..00000000
--- a/lib/win32/Demos/GetSaveFileName.py
+++ /dev/null
@@ -1,43 +0,0 @@
-import os
-
-import win32con
-import win32gui
-
-filter = "Python Scripts\0*.py;*.pyw;*.pys\0Text files\0*.txt\0"
-customfilter = "Other file types\0*.*\0"
-
-fname, customfilter, flags = win32gui.GetSaveFileNameW(
-    InitialDir=os.environ["temp"],
-    Flags=win32con.OFN_ALLOWMULTISELECT | win32con.OFN_EXPLORER,
-    File="somefilename",
-    DefExt="py",
-    Title="GetSaveFileNameW",
-    Filter=filter,
-    CustomFilter=customfilter,
-    FilterIndex=1,
-)
-
-print("save file names:", repr(fname))
-print("filter used:", repr(customfilter))
-print("Flags:", flags)
-for k, v in list(win32con.__dict__.items()):
-    if k.startswith("OFN_") and flags & v:
-        print("\t" + k)
-
-fname, customfilter, flags = win32gui.GetOpenFileNameW(
-    InitialDir=os.environ["temp"],
-    Flags=win32con.OFN_ALLOWMULTISELECT | win32con.OFN_EXPLORER,
-    File="somefilename",
-    DefExt="py",
-    Title="GetOpenFileNameW",
-    Filter=filter,
-    CustomFilter=customfilter,
-    FilterIndex=0,
-)
-
-print("open file names:", repr(fname))
-print("filter used:", repr(customfilter))
-print("Flags:", flags)
-for k, v in list(win32con.__dict__.items()):
-    if k.startswith("OFN_") and flags & v:
-        print("\t" + k)
diff --git a/lib/win32/Demos/NetValidatePasswordPolicy.py b/lib/win32/Demos/NetValidatePasswordPolicy.py
deleted file mode 100644
index 86c3bc40..00000000
--- a/lib/win32/Demos/NetValidatePasswordPolicy.py
+++ /dev/null
@@ -1,127 +0,0 @@
-"""A demo of using win32net.NetValidatePasswordPolicy.
-
-Example usage:
-
-% NetValidatePasswordPolicy.py --password=foo change
-which might return:
-
-> Result of 'change' validation is 0: The operation completed successfully.
-
-or depending on the policy:
-
-> Result of 'change' validation is 2245: The password does not meet the
-> password policy requirements. Check the minimum password length,
-> password complexity and password history requirements.
-
-Adding --user doesn't seem to change the output (even the PasswordLastSet seen
-when '-f' is used doesn't depend on the username), but theoretically it will
-also check the password history for the specified user.
-
-% NetValidatePasswordPolicy.py auth
-
-which always (with and without '-m') seems to return:
-
-> Result of 'auth' validation is 2701: Password must change at next logon
-"""
-
-import optparse
-import sys
-from pprint import pprint
-
-import win32api
-import win32net
-import win32netcon
-
-
-def main():
-    parser = optparse.OptionParser(
-        "%prog [options] auth|change ...",
-        description="A win32net.NetValidatePasswordPolicy demo.",
-    )
-
-    parser.add_option(
-        "-u",
-        "--username",
-        action="store",
-        help="The username to pass to the function (only for the " "change command",
-    )
-
-    parser.add_option(
-        "-p",
-        "--password",
-        action="store",
-        help="The clear-text password to pass to the function "
-        "(only for the 'change' command)",
-    )
-
-    parser.add_option(
-        "-m",
-        "--password-matched",
-        action="store_false",
-        default=True,
-        help="Used to specify the password does NOT match (ie, "
-        "uses False for the PasswordMatch/PasswordMatched "
-        "arg, both 'auth' and 'change' commands)",
-    )
-
-    parser.add_option(
-        "-s",
-        "--server",
-        action="store",
-        help="The name of the server to execute the command on",
-    )
-
-    parser.add_option(
-        "-f",
-        "--show_fields",
-        action="store_true",
-        default=False,
-        help="Print the NET_VALIDATE_PERSISTED_FIELDS returned",
-    )
-
-    options, args = parser.parse_args()
-
-    if not args:
-        args = ["auth"]
-
-    for arg in args:
-        if arg == "auth":
-            input = {
-                "PasswordMatched": options.password_matched,
-            }
-            val_type = win32netcon.NetValidateAuthentication
-        elif arg == "change":
-            input = {
-                "ClearPassword": options.password,
-                "PasswordMatch": options.password_matched,
-                "UserAccountName": options.username,
-            }
-            val_type = win32netcon.NetValidatePasswordChange
-        else:
-            parser.error("Invalid arg - must be 'auth' or 'change'")
-
-        try:
-            fields, status = win32net.NetValidatePasswordPolicy(
-                options.server, None, val_type, input
-            )
-        except NotImplementedError:
-            print("NetValidatePasswordPolicy not implemented on this platform.")
-            return 1
-        except win32net.error as exc:
-            print("NetValidatePasswordPolicy failed: ", exc)
-            return 1
-
-        if options.show_fields:
-            print("NET_VALIDATE_PERSISTED_FIELDS fields:")
-            pprint(fields)
-
-        print(
-            "Result of %r validation is %d: %s"
-            % (arg, status, win32api.FormatMessage(status).strip())
-        )
-
-    return 0
-
-
-if __name__ == "__main__":
-    sys.exit(main())
diff --git a/lib/win32/Demos/OpenEncryptedFileRaw.py b/lib/win32/Demos/OpenEncryptedFileRaw.py
deleted file mode 100644
index aa0f2a7c..00000000
--- a/lib/win32/Demos/OpenEncryptedFileRaw.py
+++ /dev/null
@@ -1,67 +0,0 @@
-import os
-
-import win32api
-import win32file
-import winerror
-
-
-def ReadCallback(input_buffer, data, buflen):
-    fnamein, fnameout, f = data
-    ## print fnamein, fnameout, buflen
-    f.write(input_buffer)
-    ## python 2.3 throws an error if return value is a plain int
-    return winerror.ERROR_SUCCESS
-
-
-def WriteCallback(output_buffer, data, buflen):
-    fnamebackup, fnameout, f = data
-    file_data = f.read(buflen)
-    ## returning 0 as len terminates WriteEncryptedFileRaw
-    output_len = len(file_data)
-    output_buffer[:output_len] = file_data
-    return winerror.ERROR_SUCCESS, output_len
-
-
-tmp_dir = win32api.GetTempPath()
-dst_dir = win32api.GetTempFileName(tmp_dir, "oef")[0]
-os.remove(dst_dir)
-os.mkdir(dst_dir)
-print("Destination dir:", dst_dir)
-
-## create an encrypted file
-fname = win32api.GetTempFileName(dst_dir, "ref")[0]
-print("orig file:", fname)
-f = open(fname, "w")
-f.write("xxxxxxxxxxxxxxxx\n" * 32768)
-f.close()
-## add a couple of extra data streams
-f = open(fname + ":stream_y", "w")
-f.write("yyyyyyyyyyyyyyyy\n" * 32768)
-f.close()
-f = open(fname + ":stream_z", "w")
-f.write("zzzzzzzzzzzzzzzz\n" * 32768)
-f.close()
-win32file.EncryptFile(fname)
-
-## backup raw data of encrypted file
-bkup_fname = win32api.GetTempFileName(dst_dir, "bef")[0]
-print("backup file:", bkup_fname)
-f = open(bkup_fname, "wb")
-ctxt = win32file.OpenEncryptedFileRaw(fname, 0)
-try:
-    win32file.ReadEncryptedFileRaw(ReadCallback, (fname, bkup_fname, f), ctxt)
-finally:
-    ## if context is not closed, file remains locked even if calling process is killed
-    win32file.CloseEncryptedFileRaw(ctxt)
-    f.close()
-
-## restore data from backup to new encrypted file
-dst_fname = win32api.GetTempFileName(dst_dir, "wef")[0]
-print("restored file:", dst_fname)
-f = open(bkup_fname, "rb")
-ctxtout = win32file.OpenEncryptedFileRaw(dst_fname, win32file.CREATE_FOR_IMPORT)
-try:
-    win32file.WriteEncryptedFileRaw(WriteCallback, (bkup_fname, dst_fname, f), ctxtout)
-finally:
-    win32file.CloseEncryptedFileRaw(ctxtout)
-    f.close()
diff --git a/lib/win32/Demos/RegCreateKeyTransacted.py b/lib/win32/Demos/RegCreateKeyTransacted.py
deleted file mode 100644
index 687f07ae..00000000
--- a/lib/win32/Demos/RegCreateKeyTransacted.py
+++ /dev/null
@@ -1,60 +0,0 @@
-import win32api
-import win32con
-import win32transaction
-
-keyname = "Pywin32 test transacted registry functions"
-subkeyname = "test transacted subkey"
-classname = "Transacted Class"
-
-trans = win32transaction.CreateTransaction(Description="test RegCreateKeyTransacted")
-key, disp = win32api.RegCreateKeyEx(
-    win32con.HKEY_CURRENT_USER,
-    keyname,
-    samDesired=win32con.KEY_ALL_ACCESS,
-    Class=classname,
-)
-## clean up any existing keys
-for subk in win32api.RegEnumKeyExW(key):
-    win32api.RegDeleteKey(key, subk[0])
-
-## reopen key in transacted mode
-transacted_key = win32api.RegOpenKeyTransacted(
-    Key=win32con.HKEY_CURRENT_USER,
-    SubKey=keyname,
-    Transaction=trans,
-    samDesired=win32con.KEY_ALL_ACCESS,
-)
-subkey, disp = win32api.RegCreateKeyEx(
-    transacted_key,
-    subkeyname,
-    Transaction=trans,
-    samDesired=win32con.KEY_ALL_ACCESS,
-    Class=classname,
-)
-
-## Newly created key should not be visible from non-transacted handle
-subkeys = [s[0] for s in win32api.RegEnumKeyExW(key)]
-assert subkeyname not in subkeys
-
-transacted_subkeys = [s[0] for s in win32api.RegEnumKeyExW(transacted_key)]
-assert subkeyname in transacted_subkeys
-
-## Key should be visible to non-transacted handle after commit
-win32transaction.CommitTransaction(trans)
-subkeys = [s[0] for s in win32api.RegEnumKeyExW(key)]
-assert subkeyname in subkeys
-
-## test transacted delete
-del_trans = win32transaction.CreateTransaction(
-    Description="test RegDeleteKeyTransacted"
-)
-win32api.RegDeleteKeyEx(key, subkeyname, Transaction=del_trans)
-## subkey should still show up for non-transacted handle
-subkeys = [s[0] for s in win32api.RegEnumKeyExW(key)]
-assert subkeyname in subkeys
-## ... and should be gone after commit
-win32transaction.CommitTransaction(del_trans)
-subkeys = [s[0] for s in win32api.RegEnumKeyExW(key)]
-assert subkeyname not in subkeys
-
-win32api.RegDeleteKey(win32con.HKEY_CURRENT_USER, keyname)
diff --git a/lib/win32/Demos/RegRestoreKey.py b/lib/win32/Demos/RegRestoreKey.py
deleted file mode 100644
index 69ce32ea..00000000
--- a/lib/win32/Demos/RegRestoreKey.py
+++ /dev/null
@@ -1,71 +0,0 @@
-import os
-
-import ntsecuritycon
-import win32api
-import win32con
-import win32security
-import winnt
-
-temp_dir = win32api.GetTempPath()
-fname = win32api.GetTempFileName(temp_dir, "rsk")[0]
-print(fname)
-## file can't exist
-os.remove(fname)
-
-## enable backup and restore privs
-required_privs = (
-    (
-        win32security.LookupPrivilegeValue("", ntsecuritycon.SE_BACKUP_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", ntsecuritycon.SE_RESTORE_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-)
-ph = win32api.GetCurrentProcess()
-th = win32security.OpenProcessToken(
-    ph, win32con.TOKEN_READ | win32con.TOKEN_ADJUST_PRIVILEGES
-)
-adjusted_privs = win32security.AdjustTokenPrivileges(th, 0, required_privs)
-
-try:
-    sa = win32security.SECURITY_ATTRIBUTES()
-    my_sid = win32security.GetTokenInformation(th, ntsecuritycon.TokenUser)[0]
-    sa.SECURITY_DESCRIPTOR.SetSecurityDescriptorOwner(my_sid, 0)
-
-    k, disp = win32api.RegCreateKeyEx(
-        win32con.HKEY_CURRENT_USER,
-        "Python test key",
-        SecurityAttributes=sa,
-        samDesired=win32con.KEY_ALL_ACCESS,
-        Class="some class",
-        Options=0,
-    )
-    win32api.RegSetValue(k, None, win32con.REG_SZ, "Default value for python test key")
-
-    subk, disp = win32api.RegCreateKeyEx(
-        k,
-        "python test subkey",
-        SecurityAttributes=sa,
-        samDesired=win32con.KEY_ALL_ACCESS,
-        Class="some other class",
-        Options=0,
-    )
-    win32api.RegSetValue(subk, None, win32con.REG_SZ, "Default value for subkey")
-
-    win32api.RegSaveKeyEx(
-        k, fname, Flags=winnt.REG_STANDARD_FORMAT, SecurityAttributes=sa
-    )
-
-    restored_key, disp = win32api.RegCreateKeyEx(
-        win32con.HKEY_CURRENT_USER,
-        "Python test key(restored)",
-        SecurityAttributes=sa,
-        samDesired=win32con.KEY_ALL_ACCESS,
-        Class="restored class",
-        Options=0,
-    )
-    win32api.RegRestoreKey(restored_key, fname)
-finally:
-    win32security.AdjustTokenPrivileges(th, 0, adjusted_privs)
diff --git a/lib/win32/Demos/SystemParametersInfo.py b/lib/win32/Demos/SystemParametersInfo.py
deleted file mode 100644
index 55a331e6..00000000
--- a/lib/win32/Demos/SystemParametersInfo.py
+++ /dev/null
@@ -1,210 +0,0 @@
-import glob
-import os
-import time
-
-import win32api
-import win32con
-import win32gui
-
-## some of these tests will fail for systems prior to XP
-
-for pname in (
-    ## Set actions all take an unsigned int in pvParam
-    "SPI_GETMOUSESPEED",
-    "SPI_GETACTIVEWNDTRKTIMEOUT",
-    "SPI_GETCARETWIDTH",
-    "SPI_GETFOREGROUNDFLASHCOUNT",
-    "SPI_GETFOREGROUNDLOCKTIMEOUT",
-    ## Set actions all take an unsigned int in uiParam
-    "SPI_GETWHEELSCROLLLINES",
-    "SPI_GETKEYBOARDDELAY",
-    "SPI_GETKEYBOARDSPEED",
-    "SPI_GETMOUSEHOVERHEIGHT",
-    "SPI_GETMOUSEHOVERWIDTH",
-    "SPI_GETMOUSEHOVERTIME",
-    "SPI_GETSCREENSAVETIMEOUT",
-    "SPI_GETMENUSHOWDELAY",
-    "SPI_GETLOWPOWERTIMEOUT",
-    "SPI_GETPOWEROFFTIMEOUT",
-    "SPI_GETBORDER",
-    ## below are winxp only:
-    "SPI_GETFONTSMOOTHINGCONTRAST",
-    "SPI_GETFONTSMOOTHINGTYPE",
-    "SPI_GETFOCUSBORDERHEIGHT",
-    "SPI_GETFOCUSBORDERWIDTH",
-    "SPI_GETMOUSECLICKLOCKTIME",
-):
-    print(pname)
-    cget = getattr(win32con, pname)
-    cset = getattr(win32con, pname.replace("_GET", "_SET"))
-    orig_value = win32gui.SystemParametersInfo(cget)
-    print("\toriginal setting:", orig_value)
-    win32gui.SystemParametersInfo(cset, orig_value + 1)
-    new_value = win32gui.SystemParametersInfo(cget)
-    print("\tnew value:", new_value)
-    # On Vista, some of these values seem to be ignored.  So only "fail" if
-    # the new value isn't what we set or the original
-    if new_value != orig_value + 1:
-        assert new_value == orig_value
-        print("Strange - setting %s seems to have been ignored" % (pname,))
-    win32gui.SystemParametersInfo(cset, orig_value)
-    assert win32gui.SystemParametersInfo(cget) == orig_value
-
-
-# these take a boolean value in pvParam
-# change to opposite, check that it was changed and change back
-for pname in (
-    "SPI_GETFLATMENU",
-    "SPI_GETDROPSHADOW",
-    "SPI_GETKEYBOARDCUES",
-    "SPI_GETMENUFADE",
-    "SPI_GETCOMBOBOXANIMATION",
-    "SPI_GETCURSORSHADOW",
-    "SPI_GETGRADIENTCAPTIONS",
-    "SPI_GETHOTTRACKING",
-    "SPI_GETLISTBOXSMOOTHSCROLLING",
-    "SPI_GETMENUANIMATION",
-    "SPI_GETSELECTIONFADE",
-    "SPI_GETTOOLTIPANIMATION",
-    "SPI_GETTOOLTIPFADE",
-    "SPI_GETUIEFFECTS",
-    "SPI_GETACTIVEWINDOWTRACKING",
-    "SPI_GETACTIVEWNDTRKZORDER",
-):
-    print(pname)
-    cget = getattr(win32con, pname)
-    cset = getattr(win32con, pname.replace("_GET", "_SET"))
-    orig_value = win32gui.SystemParametersInfo(cget)
-    print(orig_value)
-    win32gui.SystemParametersInfo(cset, not orig_value)
-    new_value = win32gui.SystemParametersInfo(cget)
-    print(new_value)
-    assert orig_value != new_value
-    win32gui.SystemParametersInfo(cset, orig_value)
-    assert win32gui.SystemParametersInfo(cget) == orig_value
-
-
-# these take a boolean in uiParam
-#  could combine with above section now that SystemParametersInfo only takes a single parameter
-for pname in (
-    "SPI_GETFONTSMOOTHING",
-    "SPI_GETICONTITLEWRAP",
-    "SPI_GETBEEP",
-    "SPI_GETBLOCKSENDINPUTRESETS",
-    "SPI_GETKEYBOARDPREF",
-    "SPI_GETSCREENSAVEACTIVE",
-    "SPI_GETMENUDROPALIGNMENT",
-    "SPI_GETDRAGFULLWINDOWS",
-    "SPI_GETSHOWIMEUI",
-):
-    cget = getattr(win32con, pname)
-    cset = getattr(win32con, pname.replace("_GET", "_SET"))
-    orig_value = win32gui.SystemParametersInfo(cget)
-    win32gui.SystemParametersInfo(cset, not orig_value)
-    new_value = win32gui.SystemParametersInfo(cget)
-    # Some of these also can't be changed (eg, SPI_GETSCREENSAVEACTIVE) so
-    # don't actually get upset.
-    if orig_value != new_value:
-        print("successfully toggled", pname, "from", orig_value, "to", new_value)
-    else:
-        print("couldn't toggle", pname, "from", orig_value)
-    win32gui.SystemParametersInfo(cset, orig_value)
-    assert win32gui.SystemParametersInfo(cget) == orig_value
-
-
-print("SPI_GETICONTITLELOGFONT")
-lf = win32gui.SystemParametersInfo(win32con.SPI_GETICONTITLELOGFONT)
-orig_height = lf.lfHeight
-orig_italic = lf.lfItalic
-print("Height:", orig_height, "Italic:", orig_italic)
-lf.lfHeight += 2
-lf.lfItalic = not lf.lfItalic
-win32gui.SystemParametersInfo(win32con.SPI_SETICONTITLELOGFONT, lf)
-new_lf = win32gui.SystemParametersInfo(win32con.SPI_GETICONTITLELOGFONT)
-print("New Height:", new_lf.lfHeight, "New Italic:", new_lf.lfItalic)
-assert new_lf.lfHeight == orig_height + 2
-assert new_lf.lfItalic != orig_italic
-
-lf.lfHeight = orig_height
-lf.lfItalic = orig_italic
-win32gui.SystemParametersInfo(win32con.SPI_SETICONTITLELOGFONT, lf)
-new_lf = win32gui.SystemParametersInfo(win32con.SPI_GETICONTITLELOGFONT)
-assert new_lf.lfHeight == orig_height
-assert new_lf.lfItalic == orig_italic
-
-
-print("SPI_GETMOUSEHOVERWIDTH, SPI_GETMOUSEHOVERHEIGHT, SPI_GETMOUSEHOVERTIME")
-w = win32gui.SystemParametersInfo(win32con.SPI_GETMOUSEHOVERWIDTH)
-h = win32gui.SystemParametersInfo(win32con.SPI_GETMOUSEHOVERHEIGHT)
-t = win32gui.SystemParametersInfo(win32con.SPI_GETMOUSEHOVERTIME)
-print("w,h,t:", w, h, t)
-
-win32gui.SystemParametersInfo(win32con.SPI_SETMOUSEHOVERWIDTH, w + 1)
-win32gui.SystemParametersInfo(win32con.SPI_SETMOUSEHOVERHEIGHT, h + 2)
-win32gui.SystemParametersInfo(win32con.SPI_SETMOUSEHOVERTIME, t + 3)
-new_w = win32gui.SystemParametersInfo(win32con.SPI_GETMOUSEHOVERWIDTH)
-new_h = win32gui.SystemParametersInfo(win32con.SPI_GETMOUSEHOVERHEIGHT)
-new_t = win32gui.SystemParametersInfo(win32con.SPI_GETMOUSEHOVERTIME)
-print("new w,h,t:", new_w, new_h, new_t)
-assert new_w == w + 1
-assert new_h == h + 2
-assert new_t == t + 3
-
-win32gui.SystemParametersInfo(win32con.SPI_SETMOUSEHOVERWIDTH, w)
-win32gui.SystemParametersInfo(win32con.SPI_SETMOUSEHOVERHEIGHT, h)
-win32gui.SystemParametersInfo(win32con.SPI_SETMOUSEHOVERTIME, t)
-new_w = win32gui.SystemParametersInfo(win32con.SPI_GETMOUSEHOVERWIDTH)
-new_h = win32gui.SystemParametersInfo(win32con.SPI_GETMOUSEHOVERHEIGHT)
-new_t = win32gui.SystemParametersInfo(win32con.SPI_GETMOUSEHOVERTIME)
-assert new_w == w
-assert new_h == h
-assert new_t == t
-
-
-print("SPI_SETDOUBLECLKWIDTH, SPI_SETDOUBLECLKHEIGHT")
-x = win32api.GetSystemMetrics(win32con.SM_CXDOUBLECLK)
-y = win32api.GetSystemMetrics(win32con.SM_CYDOUBLECLK)
-print("x,y:", x, y)
-win32gui.SystemParametersInfo(win32con.SPI_SETDOUBLECLKWIDTH, x + 1)
-win32gui.SystemParametersInfo(win32con.SPI_SETDOUBLECLKHEIGHT, y + 2)
-new_x = win32api.GetSystemMetrics(win32con.SM_CXDOUBLECLK)
-new_y = win32api.GetSystemMetrics(win32con.SM_CYDOUBLECLK)
-print("new x,y:", new_x, new_y)
-assert new_x == x + 1
-assert new_y == y + 2
-win32gui.SystemParametersInfo(win32con.SPI_SETDOUBLECLKWIDTH, x)
-win32gui.SystemParametersInfo(win32con.SPI_SETDOUBLECLKHEIGHT, y)
-new_x = win32api.GetSystemMetrics(win32con.SM_CXDOUBLECLK)
-new_y = win32api.GetSystemMetrics(win32con.SM_CYDOUBLECLK)
-assert new_x == x
-assert new_y == y
-
-
-print("SPI_SETDRAGWIDTH, SPI_SETDRAGHEIGHT")
-dw = win32api.GetSystemMetrics(win32con.SM_CXDRAG)
-dh = win32api.GetSystemMetrics(win32con.SM_CYDRAG)
-print("dw,dh:", dw, dh)
-win32gui.SystemParametersInfo(win32con.SPI_SETDRAGWIDTH, dw + 1)
-win32gui.SystemParametersInfo(win32con.SPI_SETDRAGHEIGHT, dh + 2)
-new_dw = win32api.GetSystemMetrics(win32con.SM_CXDRAG)
-new_dh = win32api.GetSystemMetrics(win32con.SM_CYDRAG)
-print("new dw,dh:", new_dw, new_dh)
-assert new_dw == dw + 1
-assert new_dh == dh + 2
-win32gui.SystemParametersInfo(win32con.SPI_SETDRAGWIDTH, dw)
-win32gui.SystemParametersInfo(win32con.SPI_SETDRAGHEIGHT, dh)
-new_dw = win32api.GetSystemMetrics(win32con.SM_CXDRAG)
-new_dh = win32api.GetSystemMetrics(win32con.SM_CYDRAG)
-assert new_dw == dw
-assert new_dh == dh
-
-
-orig_wallpaper = win32gui.SystemParametersInfo(Action=win32con.SPI_GETDESKWALLPAPER)
-print("Original: ", orig_wallpaper)
-for bmp in glob.glob(os.path.join(os.environ["windir"], "*.bmp")):
-    print(bmp)
-    win32gui.SystemParametersInfo(win32con.SPI_SETDESKWALLPAPER, Param=bmp)
-    print(win32gui.SystemParametersInfo(Action=win32con.SPI_GETDESKWALLPAPER))
-    time.sleep(1)
-
-win32gui.SystemParametersInfo(win32con.SPI_SETDESKWALLPAPER, Param=orig_wallpaper)
diff --git a/lib/win32/Demos/c_extension/setup.py b/lib/win32/Demos/c_extension/setup.py
deleted file mode 100644
index 6f5cb417..00000000
--- a/lib/win32/Demos/c_extension/setup.py
+++ /dev/null
@@ -1,26 +0,0 @@
-# A sample distutils script to show to build your own
-# extension module which extends pywintypes or pythoncom.
-#
-# Use 'python setup.py build' to build this extension.
-import os
-from distutils.core import Extension, setup
-from sysconfig import get_paths
-
-sources = ["win32_extension.cpp"]
-lib_dir = get_paths()["platlib"]
-
-# Specify the directory where the PyWin32 .h and .lib files are installed.
-# If you are doing a win32com extension, you will also need to add
-# win32com\Include and win32com\Libs.
-ext = Extension(
-    "win32_extension",
-    sources,
-    include_dirs=[os.path.join(lib_dir, "win32", "include")],
-    library_dirs=[os.path.join(lib_dir, "win32", "libs")],
-)
-
-setup(
-    name="win32 extension sample",
-    version="0.1",
-    ext_modules=[ext],
-)
diff --git a/lib/win32/Demos/cerapi.py b/lib/win32/Demos/cerapi.py
deleted file mode 100644
index c5d93166..00000000
--- a/lib/win32/Demos/cerapi.py
+++ /dev/null
@@ -1,254 +0,0 @@
-# A demo of the Windows CE Remote API
-#
-# This connects to a CE device, and interacts with it.
-
-import getopt
-import os
-import sys
-
-import win32api
-import win32con
-import win32event
-import wincerapi
-
-
-def DumpPythonRegistry():
-    try:
-        h = wincerapi.CeRegOpenKeyEx(
-            win32con.HKEY_LOCAL_MACHINE,
-            "Software\\Python\\PythonCore\\%s\\PythonPath" % sys.winver,
-        )
-    except win32api.error:
-        print("The remote device does not appear to have Python installed")
-        return 0
-    path, typ = wincerapi.CeRegQueryValueEx(h, None)
-    print("The remote PythonPath is '%s'" % (str(path),))
-    h.Close()
-    return 1
-
-
-def DumpRegistry(root, level=0):
-    # A recursive dump of the remote registry to test most functions.
-    h = wincerapi.CeRegOpenKeyEx(win32con.HKEY_LOCAL_MACHINE, None)
-    level_prefix = " " * level
-    index = 0
-    # Enumerate values.
-    while 1:
-        try:
-            name, data, typ = wincerapi.CeRegEnumValue(root, index)
-        except win32api.error:
-            break
-        print("%s%s=%s" % (level_prefix, name, repr(str(data))))
-        index = index + 1
-    # Now enumerate all keys.
-    index = 0
-    while 1:
-        try:
-            name, klass = wincerapi.CeRegEnumKeyEx(root, index)
-        except win32api.error:
-            break
-        print("%s%s\\" % (level_prefix, name))
-        subkey = wincerapi.CeRegOpenKeyEx(root, name)
-        DumpRegistry(subkey, level + 1)
-        index = index + 1
-
-
-def DemoCopyFile():
-    # Create a file on the device, and write a string.
-    cefile = wincerapi.CeCreateFile(
-        "TestPython", win32con.GENERIC_WRITE, 0, None, win32con.OPEN_ALWAYS, 0, None
-    )
-    wincerapi.CeWriteFile(cefile, "Hello from Python")
-    cefile.Close()
-    # reopen the file and check the data.
-    cefile = wincerapi.CeCreateFile(
-        "TestPython", win32con.GENERIC_READ, 0, None, win32con.OPEN_EXISTING, 0, None
-    )
-    if wincerapi.CeReadFile(cefile, 100) != "Hello from Python":
-        print("Couldnt read the data from the device!")
-    cefile.Close()
-    # Delete the test file
-    wincerapi.CeDeleteFile("TestPython")
-    print("Created, wrote to, read from and deleted a test file!")
-
-
-def DemoCreateProcess():
-    try:
-        hp, ht, pid, tid = wincerapi.CeCreateProcess(
-            "Windows\\Python.exe", "", None, None, 0, 0, None, "", None
-        )
-
-        # Not necessary, except to see if handle closing raises an exception
-        # (if auto-closed, the error is suppressed)
-        hp.Close()
-        ht.Close()
-        print("Python is running on the remote device!")
-    except win32api.error as xxx_todo_changeme1:
-        (hr, fn, msg) = xxx_todo_changeme1.args
-        print("Couldnt execute remote process -", msg)
-
-
-def DumpRemoteMachineStatus():
-    (
-        ACLineStatus,
-        BatteryFlag,
-        BatteryLifePercent,
-        BatteryLifeTime,
-        BatteryFullLifeTime,
-        BackupBatteryFlag,
-        BackupBatteryLifePercent,
-        BackupBatteryLifeTime,
-        BackupBatteryLifeTime,
-    ) = wincerapi.CeGetSystemPowerStatusEx()
-    if ACLineStatus:
-        power = "AC"
-    else:
-        power = "battery"
-    if BatteryLifePercent == 255:
-        batPerc = "unknown"
-    else:
-        batPerc = BatteryLifePercent
-    print(
-        "The batteries are at %s%%, and is currently being powered by %s"
-        % (batPerc, power)
-    )
-
-    (
-        memLoad,
-        totalPhys,
-        availPhys,
-        totalPage,
-        availPage,
-        totalVirt,
-        availVirt,
-    ) = wincerapi.CeGlobalMemoryStatus()
-
-    print("The memory is %d%% utilized." % (memLoad))
-    print("%-20s%-10s%-10s" % ("", "Total", "Avail"))
-    print("%-20s%-10s%-10s" % ("Physical Memory", totalPhys, availPhys))
-    print("%-20s%-10s%-10s" % ("Virtual Memory", totalVirt, availVirt))
-    print("%-20s%-10s%-10s" % ("Paging file", totalPage, availPage))
-
-    storeSize, freeSize = wincerapi.CeGetStoreInformation()
-    print("%-20s%-10s%-10s" % ("File store", storeSize, freeSize))
-
-    print("The CE temp path is", wincerapi.CeGetTempPath())
-    print("The system info for the device is", wincerapi.CeGetSystemInfo())
-
-
-def DumpRemoteFolders():
-    # Dump all special folders possible.
-    for name, val in list(wincerapi.__dict__.items()):
-        if name[:6] == "CSIDL_":
-            try:
-                loc = str(wincerapi.CeGetSpecialFolderPath(val))
-                print("Folder %s is at %s" % (name, loc))
-            except win32api.error as details:
-                pass
-
-    # Get the shortcut targets for the "Start Menu"
-    print("Dumping start menu shortcuts...")
-    try:
-        startMenu = str(wincerapi.CeGetSpecialFolderPath(wincerapi.CSIDL_STARTMENU))
-    except win32api.error as details:
-        print("This device has no start menu!", details)
-        startMenu = None
-
-    if startMenu:
-        for fileAttr in wincerapi.CeFindFiles(os.path.join(startMenu, "*")):
-            fileName = fileAttr[8]
-            fullPath = os.path.join(startMenu, str(fileName))
-            try:
-                resolved = wincerapi.CeSHGetShortcutTarget(fullPath)
-            except win32api.error as xxx_todo_changeme:
-                (rc, fn, msg) = xxx_todo_changeme.args
-                resolved = "#Error - %s" % msg
-            print("%s->%s" % (fileName, resolved))
-
-    #       print "The start menu is at",
-    #       print wincerapi.CeSHGetShortcutTarget("\\Windows\\Start Menu\\Shortcut to Python.exe.lnk")
-
-
-def usage():
-    print("Options:")
-    print("-a - Execute all demos")
-    print("-p - Execute Python process on remote device")
-    print("-r - Dump the remote registry")
-    print("-f - Dump all remote special folder locations")
-    print("-s - Dont dump machine status")
-    print("-y - Perform asynch init of CE connection")
-
-
-def main():
-    async_init = bStartPython = bDumpRegistry = bDumpFolders = 0
-    bDumpStatus = 1
-    try:
-        opts, args = getopt.getopt(sys.argv[1:], "apr")
-    except getopt.error as why:
-        print("Invalid usage:", why)
-        usage()
-        return
-
-    for o, v in opts:
-        if o == "-a":
-            bStartPython = bDumpRegistry = bDumpStatus = bDumpFolders = asynch_init = 1
-        if o == "-p":
-            bStartPython = 1
-        if o == "-r":
-            bDumpRegistry = 1
-        if o == "-s":
-            bDumpStatus = 0
-        if o == "-f":
-            bDumpFolders = 1
-        if o == "-y":
-            print("Doing asynch init of CE connection")
-            async_init = 1
-
-    if async_init:
-        event, rc = wincerapi.CeRapiInitEx()
-        while 1:
-            rc = win32event.WaitForSingleObject(event, 500)
-            if rc == win32event.WAIT_OBJECT_0:
-                # We connected.
-                break
-            else:
-                print(
-                    "Waiting for Initialize to complete (picture a Cancel button here :)"
-                )
-    else:
-        wincerapi.CeRapiInit()
-    print("Connected to remote CE device.")
-    try:
-        verinfo = wincerapi.CeGetVersionEx()
-        print(
-            "The device is running windows CE version %d.%d - %s"
-            % (verinfo[0], verinfo[1], verinfo[4])
-        )
-
-        if bDumpStatus:
-            print("Dumping remote machine status")
-            DumpRemoteMachineStatus()
-
-        if bDumpRegistry:
-            print("Dumping remote registry...")
-            DumpRegistry(win32con.HKEY_LOCAL_MACHINE)
-
-        if bDumpFolders:
-            print("Dumping remote folder information")
-            DumpRemoteFolders()
-
-        DemoCopyFile()
-        if bStartPython:
-            print("Starting remote Python process")
-            if DumpPythonRegistry():
-                DemoCreateProcess()
-            else:
-                print("Not trying to start Python, as it's not installed")
-
-    finally:
-        wincerapi.CeRapiUninit()
-        print("Disconnected")
-
-
-if __name__ == "__main__":
-    main()
diff --git a/lib/win32/Demos/dde/ddeclient.py b/lib/win32/Demos/dde/ddeclient.py
deleted file mode 100644
index 32af3130..00000000
--- a/lib/win32/Demos/dde/ddeclient.py
+++ /dev/null
@@ -1,18 +0,0 @@
-# 'Request' example added jjk  11/20/98
-
-import dde
-import win32ui
-
-server = dde.CreateServer()
-server.Create("TestClient")
-
-conversation = dde.CreateConversation(server)
-
-conversation.ConnectTo("RunAny", "RunAnyCommand")
-conversation.Exec("DoSomething")
-conversation.Exec("DoSomethingElse")
-
-conversation.ConnectTo("RunAny", "ComputeStringLength")
-s = "abcdefghi"
-sl = conversation.Request(s)
-print('length of "%s" is %s' % (s, sl))
diff --git a/lib/win32/Demos/dde/ddeserver.py b/lib/win32/Demos/dde/ddeserver.py
deleted file mode 100644
index 0374827f..00000000
--- a/lib/win32/Demos/dde/ddeserver.py
+++ /dev/null
@@ -1,42 +0,0 @@
-# 'Request' example added jjk  11/20/98
-
-import dde
-import win32ui
-from pywin.mfc import object
-
-
-class MySystemTopic(object.Object):
-    def __init__(self):
-        object.Object.__init__(self, dde.CreateServerSystemTopic())
-
-    def Exec(self, cmd):
-        print("System Topic asked to exec", cmd)
-
-
-class MyOtherTopic(object.Object):
-    def __init__(self, topicName):
-        object.Object.__init__(self, dde.CreateTopic(topicName))
-
-    def Exec(self, cmd):
-        print("Other Topic asked to exec", cmd)
-
-
-class MyRequestTopic(object.Object):
-    def __init__(self, topicName):
-        topic = dde.CreateTopic(topicName)
-        topic.AddItem(dde.CreateStringItem(""))
-        object.Object.__init__(self, topic)
-
-    def Request(self, aString):
-        print("Request Topic asked to compute length of:", aString)
-        return str(len(aString))
-
-
-server = dde.CreateServer()
-server.AddTopic(MySystemTopic())
-server.AddTopic(MyOtherTopic("RunAnyCommand"))
-server.AddTopic(MyRequestTopic("ComputeStringLength"))
-server.Create("RunAny")
-
-while 1:
-    win32ui.PumpWaitingMessages(0, -1)
diff --git a/lib/win32/Demos/desktopmanager.py b/lib/win32/Demos/desktopmanager.py
deleted file mode 100644
index 6ffaf2a9..00000000
--- a/lib/win32/Demos/desktopmanager.py
+++ /dev/null
@@ -1,246 +0,0 @@
-# Demonstrates using a taskbar icon to create and navigate between desktops
-
-import _thread
-import io
-import time
-import traceback
-
-import pywintypes
-import win32api
-import win32con
-import win32gui
-import win32process
-import win32service
-
-## "Shell_TrayWnd" is class of system tray window, broadcasts "TaskbarCreated" when initialized
-
-
-def desktop_name_dlgproc(hwnd, msg, wparam, lparam):
-    """Handles messages from the desktop name dialog box"""
-    if msg in (win32con.WM_CLOSE, win32con.WM_DESTROY):
-        win32gui.DestroyWindow(hwnd)
-    elif msg == win32con.WM_COMMAND:
-        if wparam == win32con.IDOK:
-            desktop_name = win32gui.GetDlgItemText(hwnd, 72)
-            print("new desktop name: ", desktop_name)
-            win32gui.DestroyWindow(hwnd)
-            create_desktop(desktop_name)
-
-        elif wparam == win32con.IDCANCEL:
-            win32gui.DestroyWindow(hwnd)
-
-
-def get_new_desktop_name(parent_hwnd):
-    """Create a dialog box to ask the user for name of desktop to be created"""
-    msgs = {
-        win32con.WM_COMMAND: desktop_name_dlgproc,
-        win32con.WM_CLOSE: desktop_name_dlgproc,
-        win32con.WM_DESTROY: desktop_name_dlgproc,
-    }
-    # dlg item [type, caption, id, (x,y,cx,cy), style, ex style
-    style = (
-        win32con.WS_BORDER
-        | win32con.WS_VISIBLE
-        | win32con.WS_CAPTION
-        | win32con.WS_SYSMENU
-    )  ## |win32con.DS_SYSMODAL
-    h = win32gui.CreateDialogIndirect(
-        win32api.GetModuleHandle(None),
-        [
-            ["One ugly dialog box !", (100, 100, 200, 100), style, 0],
-            [
-                "Button",
-                "Create",
-                win32con.IDOK,
-                (10, 10, 30, 20),
-                win32con.WS_VISIBLE
-                | win32con.WS_TABSTOP
-                | win32con.BS_HOLLOW
-                | win32con.BS_DEFPUSHBUTTON,
-            ],
-            [
-                "Button",
-                "Never mind",
-                win32con.IDCANCEL,
-                (45, 10, 50, 20),
-                win32con.WS_VISIBLE | win32con.WS_TABSTOP | win32con.BS_HOLLOW,
-            ],
-            ["Static", "Desktop name:", 71, (10, 40, 70, 10), win32con.WS_VISIBLE],
-            ["Edit", "", 72, (75, 40, 90, 10), win32con.WS_VISIBLE],
-        ],
-        parent_hwnd,
-        msgs,
-    )  ## parent_hwnd, msgs)
-
-    win32gui.EnableWindow(h, True)
-    hcontrol = win32gui.GetDlgItem(h, 72)
-    win32gui.EnableWindow(hcontrol, True)
-    win32gui.SetFocus(hcontrol)
-
-
-def new_icon(hdesk, desktop_name):
-    """Runs as a thread on each desktop to create a new tray icon and handle its messages"""
-    global id
-    id = id + 1
-    hdesk.SetThreadDesktop()
-    ## apparently the threads can't use same hinst, so each needs its own window class
-    windowclassname = "PythonDesktopManager" + desktop_name
-    wc = win32gui.WNDCLASS()
-    wc.hInstance = win32api.GetModuleHandle(None)
-    wc.lpszClassName = windowclassname
-    wc.style = win32con.CS_VREDRAW | win32con.CS_HREDRAW | win32con.CS_GLOBALCLASS
-    wc.hCursor = win32gui.LoadCursor(0, win32con.IDC_ARROW)
-    wc.hbrBackground = win32con.COLOR_WINDOW
-    wc.lpfnWndProc = icon_wndproc
-    windowclass = win32gui.RegisterClass(wc)
-    style = win32con.WS_OVERLAPPED | win32con.WS_SYSMENU
-    hwnd = win32gui.CreateWindow(
-        windowclass,
-        "dm_" + desktop_name,
-        win32con.WS_SYSMENU,
-        0,
-        0,
-        win32con.CW_USEDEFAULT,
-        win32con.CW_USEDEFAULT,
-        0,
-        0,
-        wc.hInstance,
-        None,
-    )
-    win32gui.UpdateWindow(hwnd)
-    flags = win32gui.NIF_ICON | win32gui.NIF_MESSAGE | win32gui.NIF_TIP
-    notify_info = (
-        hwnd,
-        id,
-        flags,
-        win32con.WM_USER + 20,
-        hicon,
-        "Desktop Manager (%s)" % desktop_name,
-    )
-    window_info[hwnd] = notify_info
-    ## wait for explorer to initialize system tray for new desktop
-    tray_found = 0
-    while not tray_found:
-        try:
-            tray_found = win32gui.FindWindow("Shell_TrayWnd", None)
-        except win32gui.error:
-            traceback.print_exc
-            time.sleep(0.5)
-    win32gui.Shell_NotifyIcon(win32gui.NIM_ADD, notify_info)
-    win32gui.PumpMessages()
-
-
-def create_desktop(desktop_name, start_explorer=1):
-    """Creates a new desktop and spawns a thread running on it
-    Will also start a new icon thread on an existing desktop
-    """
-    sa = pywintypes.SECURITY_ATTRIBUTES()
-    sa.bInheritHandle = 1
-
-    try:
-        hdesk = win32service.CreateDesktop(
-            desktop_name, 0, win32con.MAXIMUM_ALLOWED, sa
-        )
-    except win32service.error:
-        traceback.print_exc()
-        errbuf = io.StringIO()
-        traceback.print_exc(None, errbuf)
-        win32api.MessageBox(0, errbuf.getvalue(), "Desktop creation failed")
-        return
-    if start_explorer:
-        s = win32process.STARTUPINFO()
-        s.lpDesktop = desktop_name
-        prc_info = win32process.CreateProcess(
-            None,
-            "Explorer.exe",
-            None,
-            None,
-            True,
-            win32con.CREATE_NEW_CONSOLE,
-            None,
-            "c:\\",
-            s,
-        )
-
-    th = _thread.start_new_thread(new_icon, (hdesk, desktop_name))
-    hdesk.SwitchDesktop()
-
-
-def icon_wndproc(hwnd, msg, wp, lp):
-    """Window proc for the tray icons"""
-    if lp == win32con.WM_LBUTTONDOWN:
-        ## popup menu won't disappear if you don't do this
-        win32gui.SetForegroundWindow(hwnd)
-
-        curr_desktop = win32service.OpenInputDesktop(0, True, win32con.MAXIMUM_ALLOWED)
-        curr_desktop_name = win32service.GetUserObjectInformation(
-            curr_desktop, win32con.UOI_NAME
-        )
-        winsta = win32service.GetProcessWindowStation()
-        desktops = winsta.EnumDesktops()
-        m = win32gui.CreatePopupMenu()
-        desktop_cnt = len(desktops)
-        ## *don't* create an item 0
-        for d in range(1, desktop_cnt + 1):
-            mf_flags = win32con.MF_STRING
-            ## if you switch to winlogon yourself, there's nothing there and you're stuck
-            if desktops[d - 1].lower() in ("winlogon", "disconnect"):
-                mf_flags = mf_flags | win32con.MF_GRAYED | win32con.MF_DISABLED
-            if desktops[d - 1] == curr_desktop_name:
-                mf_flags = mf_flags | win32con.MF_CHECKED
-            win32gui.AppendMenu(m, mf_flags, d, desktops[d - 1])
-        win32gui.AppendMenu(m, win32con.MF_STRING, desktop_cnt + 1, "Create new ...")
-        win32gui.AppendMenu(m, win32con.MF_STRING, desktop_cnt + 2, "Exit")
-
-        x, y = win32gui.GetCursorPos()
-        d = win32gui.TrackPopupMenu(
-            m,
-            win32con.TPM_LEFTBUTTON | win32con.TPM_RETURNCMD | win32con.TPM_NONOTIFY,
-            x,
-            y,
-            0,
-            hwnd,
-            None,
-        )
-        win32gui.PumpWaitingMessages()
-        win32gui.DestroyMenu(m)
-        if d == desktop_cnt + 1:  ## Create new
-            get_new_desktop_name(hwnd)
-        elif d == desktop_cnt + 2:  ## Exit
-            win32gui.PostQuitMessage(0)
-            win32gui.Shell_NotifyIcon(win32gui.NIM_DELETE, window_info[hwnd])
-            del window_info[hwnd]
-            origin_desktop.SwitchDesktop()
-        elif d > 0:
-            hdesk = win32service.OpenDesktop(
-                desktops[d - 1], 0, 0, win32con.MAXIMUM_ALLOWED
-            )
-            hdesk.SwitchDesktop()
-        return 0
-    else:
-        return win32gui.DefWindowProc(hwnd, msg, wp, lp)
-
-
-window_info = {}
-origin_desktop = win32service.OpenInputDesktop(0, True, win32con.MAXIMUM_ALLOWED)
-origin_desktop_name = win32service.GetUserObjectInformation(
-    origin_desktop, win32service.UOI_NAME
-)
-
-hinst = win32api.GetModuleHandle(None)
-try:
-    hicon = win32gui.LoadIcon(hinst, 1)  ## python.exe and pythonw.exe
-except win32gui.error:
-    hicon = win32gui.LoadIcon(hinst, 135)  ## pythonwin's icon
-id = 0
-
-create_desktop(str(origin_desktop_name), 0)
-
-## wait for first thread to initialize its icon
-while not window_info:
-    time.sleep(1)
-
-## exit when last tray icon goes away
-while window_info:
-    win32gui.PumpWaitingMessages()
-    time.sleep(3)
diff --git a/lib/win32/Demos/eventLogDemo.py b/lib/win32/Demos/eventLogDemo.py
deleted file mode 100644
index 8d4220b0..00000000
--- a/lib/win32/Demos/eventLogDemo.py
+++ /dev/null
@@ -1,142 +0,0 @@
-import win32api  # To translate NT Sids to account names.
-import win32con
-import win32evtlog
-import win32evtlogutil
-import win32security
-
-
-def ReadLog(computer, logType="Application", dumpEachRecord=0):
-    # read the entire log back.
-    h = win32evtlog.OpenEventLog(computer, logType)
-    numRecords = win32evtlog.GetNumberOfEventLogRecords(h)
-    #       print "There are %d records" % numRecords
-
-    num = 0
-    while 1:
-        objects = win32evtlog.ReadEventLog(
-            h,
-            win32evtlog.EVENTLOG_BACKWARDS_READ | win32evtlog.EVENTLOG_SEQUENTIAL_READ,
-            0,
-        )
-        if not objects:
-            break
-        for object in objects:
-            # get it for testing purposes, but dont print it.
-            msg = win32evtlogutil.SafeFormatMessage(object, logType)
-            if object.Sid is not None:
-                try:
-                    domain, user, typ = win32security.LookupAccountSid(
-                        computer, object.Sid
-                    )
-                    sidDesc = "%s/%s" % (domain, user)
-                except win32security.error:
-                    sidDesc = str(object.Sid)
-                user_desc = "Event associated with user %s" % (sidDesc,)
-            else:
-                user_desc = None
-            if dumpEachRecord:
-                print(
-                    "Event record from %r generated at %s"
-                    % (object.SourceName, object.TimeGenerated.Format())
-                )
-                if user_desc:
-                    print(user_desc)
-                try:
-                    print(msg)
-                except UnicodeError:
-                    print("(unicode error printing message: repr() follows...)")
-                    print(repr(msg))
-
-        num = num + len(objects)
-
-    if numRecords == num:
-        print("Successfully read all", numRecords, "records")
-    else:
-        print(
-            "Couldn't get all records - reported %d, but found %d" % (numRecords, num)
-        )
-        print(
-            "(Note that some other app may have written records while we were running!)"
-        )
-    win32evtlog.CloseEventLog(h)
-
-
-def usage():
-    print("Writes an event to the event log.")
-    print("-w : Dont write any test records.")
-    print("-r : Dont read the event log")
-    print("-c : computerName : Process the log on the specified computer")
-    print("-v : Verbose")
-    print("-t : LogType - Use the specified log - default = 'Application'")
-
-
-def test():
-    # check if running on Windows NT, if not, display notice and terminate
-    if win32api.GetVersion() & 0x80000000:
-        print("This sample only runs on NT")
-        return
-
-    import getopt
-    import sys
-
-    opts, args = getopt.getopt(sys.argv[1:], "rwh?c:t:v")
-    computer = None
-    do_read = do_write = 1
-
-    logType = "Application"
-    verbose = 0
-
-    if len(args) > 0:
-        print("Invalid args")
-        usage()
-        return 1
-    for opt, val in opts:
-        if opt == "-t":
-            logType = val
-        if opt == "-c":
-            computer = val
-        if opt in ["-h", "-?"]:
-            usage()
-            return
-        if opt == "-r":
-            do_read = 0
-        if opt == "-w":
-            do_write = 0
-        if opt == "-v":
-            verbose = verbose + 1
-    if do_write:
-        ph = win32api.GetCurrentProcess()
-        th = win32security.OpenProcessToken(ph, win32con.TOKEN_READ)
-        my_sid = win32security.GetTokenInformation(th, win32security.TokenUser)[0]
-
-        win32evtlogutil.ReportEvent(
-            logType,
-            2,
-            strings=["The message text for event 2", "Another insert"],
-            data="Raw\0Data".encode("ascii"),
-            sid=my_sid,
-        )
-        win32evtlogutil.ReportEvent(
-            logType,
-            1,
-            eventType=win32evtlog.EVENTLOG_WARNING_TYPE,
-            strings=["A warning", "An even more dire warning"],
-            data="Raw\0Data".encode("ascii"),
-            sid=my_sid,
-        )
-        win32evtlogutil.ReportEvent(
-            logType,
-            1,
-            eventType=win32evtlog.EVENTLOG_INFORMATION_TYPE,
-            strings=["An info", "Too much info"],
-            data="Raw\0Data".encode("ascii"),
-            sid=my_sid,
-        )
-        print("Successfully wrote 3 records to the log")
-
-    if do_read:
-        ReadLog(computer, logType, verbose > 0)
-
-
-if __name__ == "__main__":
-    test()
diff --git a/lib/win32/Demos/getfilever.py b/lib/win32/Demos/getfilever.py
deleted file mode 100644
index 721e72f3..00000000
--- a/lib/win32/Demos/getfilever.py
+++ /dev/null
@@ -1,33 +0,0 @@
-import os
-
-import win32api
-
-ver_strings = (
-    "Comments",
-    "InternalName",
-    "ProductName",
-    "CompanyName",
-    "LegalCopyright",
-    "ProductVersion",
-    "FileDescription",
-    "LegalTrademarks",
-    "PrivateBuild",
-    "FileVersion",
-    "OriginalFilename",
-    "SpecialBuild",
-)
-fname = os.environ["comspec"]
-d = win32api.GetFileVersionInfo(fname, "\\")
-## backslash as parm returns dictionary of numeric info corresponding to VS_FIXEDFILEINFO struc
-for n, v in d.items():
-    print(n, v)
-
-pairs = win32api.GetFileVersionInfo(fname, "\\VarFileInfo\\Translation")
-## \VarFileInfo\Translation returns list of available (language, codepage) pairs that can be used to retreive string info
-## any other must be of the form \StringfileInfo\%04X%04X\parm_name, middle two are language/codepage pair returned from above
-for lang, codepage in pairs:
-    print("lang: ", lang, "codepage:", codepage)
-    for ver_string in ver_strings:
-        str_info = "\\StringFileInfo\\%04X%04X\\%s" % (lang, codepage, ver_string)
-        ## print str_info
-        print(ver_string, repr(win32api.GetFileVersionInfo(fname, str_info)))
diff --git a/lib/win32/Demos/images/frowny.bmp b/lib/win32/Demos/images/frowny.bmp
deleted file mode 100644
index 43e7621e2e081bc6200523f459f6d803d3133eaa..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 3126
zcmds(J8#oa7>3`t#z~xu5<3kk2}&SQ1*JkPv}?r1z><}fm6e&5m6es1l|R5gsDy;7
zs^YGyR9sYXSM~AQUvzXrY!e)@U_G&%i=Ov<=X~cV*KTZ85no%pU*KyneHGB*6R+v_
z`bO{XcAotA0Og2EI|6mmLqNu8k>$((7k;1>!<FkaKYj?`AGMDTJBJ5n4&I!7`>Ox?
z#rc=}qvw0;`@8Wv4-jsU#cQ$s_2W+&5r69+`Xl0;oSgdkqxk)s|Mg4t^Ko_rtGKxL
z?9%R2V3lN7p?-+uh{*PPXppW*AW{~|7r`nV_+-8c^^ZiBj7akr(I%HgOhgZB1m$i7
zYB5cq3BMhI3faVf%yg7Dgg2ZYzxuaDOvK`TyJ;!^&0lpwG7-5hG8SP(1%0ykL;>q$
zri!>atwQ}bMNEYH%|!iixz#^Yh2;l4a!bUHFcak?AR$Ubo7P1@fD%dDdSS6kbo}bS
zEs_{v`?YCpf7;fw{SI7mM<g+#3YSzI5S^$nDkp&7AZfcBI7f8+>c1<J7-9Q$>)HOa
z1H|^jamhWA#0dC3Vw%?M?p2gX+8KpHolNIH_TLvtj8MN>Zqu~tPdf%@{N)<TwFe?5
z!a<*0MUPCZeKB9fCe{crBKBHDvky$iANwDQm<ZdS*tDh!+i$Oh?bnnmC=wHqxEAAh
zch6U0ALj6UqE7p+e!Gf%5ovy$ZjnbKOGa#<LF|$1v-%&4EE$pJ*OW=2LGnc)I+TL>
zk=viBKVKD#_@{H_uE1Rh;gRf)g4-i5d}5C?`<Zg%&tC3)emgxr=CO^4Hi`sZH6s3B
LYX36d^D_Ql#L5Rl

diff --git a/lib/win32/Demos/images/smiley.bmp b/lib/win32/Demos/images/smiley.bmp
deleted file mode 100644
index 12ed5dee2d1df987c6c3bd5d134e6075ff160c39..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 3126
zcmds&Ju^c=6o%hK=0=E&!GswKCJLi4Dq5pcXtY|bR;|@)wOXw|;2-!GzKyR5MqcOc
zxiTla?oC|L*m>{HW<Q>H&z`+E>zgZ8xUwSkf;_XyQ^1t8q$K0|L+h*avwtt35^J~~
z3pLRU#zg%(fxqAb6Hb!3DZISk`58}7cznde1Mcr}cZb_s+}z;$I$t(B_|0aPg)!*m
zsx*e?MQF9~@qzbuyuIP|71<UN#pNX~E_%sG!YA`sID@n(B8-Zr$uY7b{CpPaQ7C_&
z{H;Yw6lK&!OQdgMGWbn1yirjDQ6oGh<*$;y#WzsX6<*qaUoDP{w#W@~jci*erAsb!
zQW%Bn*C>>~O?no(v`e~mQW%Bd1CeNlY+L9e|DZB%lrFGQ1pHmHZK2cK2i5&X=>i*t
z;TKU7?UB~P%SCq!?;92H_sM=*7(R+6(E-^{i$V>Bn%*DfACmpFu>8shDkDdvXQ4^c
z+P)W>3p*NqY3Be@vVX@vCOr#F2-9sx!;iV;tIIOVBDK)9Hr?7|qv+t<{|h&uOj|2o
zqtLZB-P&WL=-}H|FNKfE3DF4|9@LNCi$#oz?9R2V{8RFm7HRy%#YLCTLQgE*x$V(8
z`J(8BpF~j_fXEf^(t5c-X(pB{cAwep82-i2PIo@Ob&t0;h*iX@qbx#HjrGGlTc&Lb
HJU9On!KEHb

diff --git a/lib/win32/Demos/mmapfile_demo.py b/lib/win32/Demos/mmapfile_demo.py
deleted file mode 100644
index 9068ce72..00000000
--- a/lib/win32/Demos/mmapfile_demo.py
+++ /dev/null
@@ -1,102 +0,0 @@
-import os
-import tempfile
-
-import mmapfile
-import win32api
-import winerror
-from pywin32_testutil import str2bytes
-
-system_info = win32api.GetSystemInfo()
-page_size = system_info[1]
-alloc_size = system_info[7]
-
-fname = tempfile.mktemp()
-mapping_name = os.path.split(fname)[1]
-fsize = 8 * page_size
-print(fname, fsize, mapping_name)
-
-m1 = mmapfile.mmapfile(File=fname, Name=mapping_name, MaximumSize=fsize)
-m1.seek(100)
-m1.write_byte(str2bytes("?"))
-m1.seek(-1, 1)
-assert m1.read_byte() == str2bytes("?")
-
-## A reopened named mapping should have exact same size as original mapping
-m2 = mmapfile.mmapfile(Name=mapping_name, File=None, MaximumSize=fsize * 2)
-assert m2.size() == m1.size()
-m1.seek(0, 0)
-m1.write(fsize * str2bytes("s"))
-assert m2.read(fsize) == fsize * str2bytes("s")
-
-move_src = 100
-move_dest = 500
-move_size = 150
-
-m2.seek(move_src, 0)
-assert m2.tell() == move_src
-m2.write(str2bytes("m") * move_size)
-m2.move(move_dest, move_src, move_size)
-m2.seek(move_dest, 0)
-assert m2.read(move_size) == str2bytes("m") * move_size
-##    m2.write('x'* (fsize+1))
-
-m2.close()
-m1.resize(fsize * 2)
-assert m1.size() == fsize * 2
-m1.seek(fsize)
-m1.write(str2bytes("w") * fsize)
-m1.flush()
-m1.close()
-os.remove(fname)
-
-
-## Test a file with size larger than 32 bits
-## need 10 GB free on drive where your temp folder lives
-fname_large = tempfile.mktemp()
-mapping_name = "Pywin32_large_mmap"
-offsetdata = str2bytes("This is start of offset")
-
-## Deliberately use odd numbers to test rounding logic
-fsize = (1024 * 1024 * 1024 * 10) + 333
-offset = (1024 * 1024 * 32) + 42
-view_size = (1024 * 1024 * 16) + 111
-
-## round mapping size and view size up to multiple of system page size
-if fsize % page_size:
-    fsize += page_size - (fsize % page_size)
-if view_size % page_size:
-    view_size += page_size - (view_size % page_size)
-## round offset down to multiple of allocation granularity
-offset -= offset % alloc_size
-
-m1 = None
-m2 = None
-try:
-    try:
-        m1 = mmapfile.mmapfile(fname_large, mapping_name, fsize, 0, offset * 2)
-    except mmapfile.error as exc:
-        # if we don't have enough disk-space, that's OK.
-        if exc.winerror != winerror.ERROR_DISK_FULL:
-            raise
-        print("skipping large file test - need", fsize, "available bytes.")
-    else:
-        m1.seek(offset)
-        m1.write(offsetdata)
-
-        ## When reopening an existing mapping without passing a file handle, you have
-        ##  to specify a positive size even though it's ignored
-        m2 = mmapfile.mmapfile(
-            File=None,
-            Name=mapping_name,
-            MaximumSize=1,
-            FileOffset=offset,
-            NumberOfBytesToMap=view_size,
-        )
-        assert m2.read(len(offsetdata)) == offsetdata
-finally:
-    if m1 is not None:
-        m1.close()
-    if m2 is not None:
-        m2.close()
-    if os.path.exists(fname_large):
-        os.remove(fname_large)
diff --git a/lib/win32/Demos/pipes/cat.py b/lib/win32/Demos/pipes/cat.py
deleted file mode 100644
index 13b6400a..00000000
--- a/lib/win32/Demos/pipes/cat.py
+++ /dev/null
@@ -1,17 +0,0 @@
-"""cat.py
-a version of unix cat, tweaked to show off runproc.py
-"""
-
-import sys
-
-data = sys.stdin.read(1)
-sys.stdout.write(data)
-sys.stdout.flush()
-while data:
-    data = sys.stdin.read(1)
-    sys.stdout.write(data)
-    sys.stdout.flush()
-# Just here to have something to read from stderr.
-sys.stderr.write("Blah...")
-
-# end of cat.py
diff --git a/lib/win32/Demos/pipes/runproc.py b/lib/win32/Demos/pipes/runproc.py
deleted file mode 100644
index 2ed02dd3..00000000
--- a/lib/win32/Demos/pipes/runproc.py
+++ /dev/null
@@ -1,114 +0,0 @@
-"""runproc.py
-
-start a process with three inherited pipes.
-Try to write to and read from those.
-"""
-
-import msvcrt
-import os
-
-import win32api
-import win32con
-import win32file
-import win32pipe
-import win32process
-import win32security
-
-
-class Process:
-    def run(self, cmdline):
-        # security attributes for pipes
-        sAttrs = win32security.SECURITY_ATTRIBUTES()
-        sAttrs.bInheritHandle = 1
-
-        # create pipes
-        hStdin_r, self.hStdin_w = win32pipe.CreatePipe(sAttrs, 0)
-        self.hStdout_r, hStdout_w = win32pipe.CreatePipe(sAttrs, 0)
-        self.hStderr_r, hStderr_w = win32pipe.CreatePipe(sAttrs, 0)
-
-        # set the info structure for the new process.
-        StartupInfo = win32process.STARTUPINFO()
-        StartupInfo.hStdInput = hStdin_r
-        StartupInfo.hStdOutput = hStdout_w
-        StartupInfo.hStdError = hStderr_w
-        StartupInfo.dwFlags = win32process.STARTF_USESTDHANDLES
-        # Mark doesn't support wShowWindow yet.
-        # StartupInfo.dwFlags = StartupInfo.dwFlags | win32process.STARTF_USESHOWWINDOW
-        # StartupInfo.wShowWindow = win32con.SW_HIDE
-
-        # Create new output read handles and the input write handle. Set
-        # the inheritance properties to FALSE. Otherwise, the child inherits
-        # the these handles; resulting in non-closeable handles to the pipes
-        # being created.
-        pid = win32api.GetCurrentProcess()
-
-        tmp = win32api.DuplicateHandle(
-            pid,
-            self.hStdin_w,
-            pid,
-            0,
-            0,  # non-inheritable!!
-            win32con.DUPLICATE_SAME_ACCESS,
-        )
-        # Close the inhertible version of the handle
-        win32file.CloseHandle(self.hStdin_w)
-        self.hStdin_w = tmp
-        tmp = win32api.DuplicateHandle(
-            pid,
-            self.hStdout_r,
-            pid,
-            0,
-            0,  # non-inheritable!
-            win32con.DUPLICATE_SAME_ACCESS,
-        )
-        # Close the inhertible version of the handle
-        win32file.CloseHandle(self.hStdout_r)
-        self.hStdout_r = tmp
-
-        # start the process.
-        hProcess, hThread, dwPid, dwTid = win32process.CreateProcess(
-            None,  # program
-            cmdline,  # command line
-            None,  # process security attributes
-            None,  # thread attributes
-            1,  # inherit handles, or USESTDHANDLES won't work.
-            # creation flags. Don't access the console.
-            0,  # Don't need anything here.
-            # If you're in a GUI app, you should use
-            # CREATE_NEW_CONSOLE here, or any subprocesses
-            # might fall victim to the problem described in:
-            # KB article: Q156755, cmd.exe requires
-            # an NT console in order to perform redirection..
-            None,  # no new environment
-            None,  # current directory (stay where we are)
-            StartupInfo,
-        )
-        # normally, we would save the pid etc. here...
-
-        # Child is launched. Close the parents copy of those pipe handles
-        # that only the child should have open.
-        # You need to make sure that no handles to the write end of the
-        # output pipe are maintained in this process or else the pipe will
-        # not close when the child process exits and the ReadFile will hang.
-        win32file.CloseHandle(hStderr_w)
-        win32file.CloseHandle(hStdout_w)
-        win32file.CloseHandle(hStdin_r)
-
-        self.stdin = os.fdopen(msvcrt.open_osfhandle(self.hStdin_w, 0), "wb")
-        self.stdin.write("hmmmmm\r\n")
-        self.stdin.flush()
-        self.stdin.close()
-
-        self.stdout = os.fdopen(msvcrt.open_osfhandle(self.hStdout_r, 0), "rb")
-        print("Read on stdout: ", repr(self.stdout.read()))
-
-        self.stderr = os.fdopen(msvcrt.open_osfhandle(self.hStderr_r, 0), "rb")
-        print("Read on stderr: ", repr(self.stderr.read()))
-
-
-if __name__ == "__main__":
-    p = Process()
-    exe = win32api.GetModuleFileName(0)
-    p.run(exe + " cat.py")
-
-# end of runproc.py
diff --git a/lib/win32/Demos/print_desktop.py b/lib/win32/Demos/print_desktop.py
deleted file mode 100644
index d06504e2..00000000
--- a/lib/win32/Demos/print_desktop.py
+++ /dev/null
@@ -1,113 +0,0 @@
-import pywintypes
-import win32api
-import win32con
-import win32gui
-import win32print
-
-pname = win32print.GetDefaultPrinter()
-print(pname)
-p = win32print.OpenPrinter(pname)
-print("Printer handle: ", p)
-print_processor = win32print.GetPrinter(p, 2)["pPrintProcessor"]
-## call with last parm set to 0 to get total size needed for printer's DEVMODE
-dmsize = win32print.DocumentProperties(0, p, pname, None, None, 0)
-## dmDriverExtra should be total size - fixed size
-driverextra = (
-    dmsize - pywintypes.DEVMODEType().Size
-)  ## need a better way to get DEVMODE.dmSize
-dm = pywintypes.DEVMODEType(driverextra)
-dm.Fields = dm.Fields | win32con.DM_ORIENTATION | win32con.DM_COPIES
-dm.Orientation = win32con.DMORIENT_LANDSCAPE
-dm.Copies = 2
-win32print.DocumentProperties(
-    0, p, pname, dm, dm, win32con.DM_IN_BUFFER | win32con.DM_OUT_BUFFER
-)
-
-pDC = win32gui.CreateDC(print_processor, pname, dm)
-printerwidth = win32print.GetDeviceCaps(pDC, win32con.PHYSICALWIDTH)
-printerheight = win32print.GetDeviceCaps(pDC, win32con.PHYSICALHEIGHT)
-
-hwnd = win32gui.GetDesktopWindow()
-l, t, r, b = win32gui.GetWindowRect(hwnd)
-desktopheight = b - t
-desktopwidth = r - l
-dDC = win32gui.GetWindowDC(hwnd)
-
-dcDC = win32gui.CreateCompatibleDC(dDC)
-dcBM = win32gui.CreateCompatibleBitmap(dDC, desktopwidth, desktopheight)
-win32gui.SelectObject(dcDC, dcBM)
-win32gui.StretchBlt(
-    dcDC,
-    0,
-    0,
-    desktopwidth,
-    desktopheight,
-    dDC,
-    0,
-    0,
-    desktopwidth,
-    desktopheight,
-    win32con.SRCCOPY,
-)
-
-pcDC = win32gui.CreateCompatibleDC(pDC)
-pcBM = win32gui.CreateCompatibleBitmap(pDC, printerwidth, printerheight)
-win32gui.SelectObject(pcDC, pcBM)
-win32gui.StretchBlt(
-    pcDC,
-    0,
-    0,
-    printerwidth,
-    printerheight,
-    dcDC,
-    0,
-    0,
-    desktopwidth,
-    desktopheight,
-    win32con.SRCCOPY,
-)
-
-win32print.StartDoc(pDC, ("desktop.bmp", None, None, 0))
-win32print.StartPage(pDC)
-win32gui.StretchBlt(
-    pDC,
-    0,
-    0,
-    int(printerwidth * 0.9),
-    int(printerheight * 0.9),
-    pcDC,
-    0,
-    0,
-    printerwidth,
-    printerheight,
-    win32con.SRCCOPY,
-)
-
-font = win32gui.LOGFONT()
-font.lfHeight = int(printerheight / 20)
-font.lfWidth = font.lfHeight
-font.lfWeight = 150
-font.lfItalic = 1
-font.lfUnderline = 1
-hf = win32gui.CreateFontIndirect(font)
-win32gui.SelectObject(pDC, hf)
-win32gui.SetBkMode(pDC, win32con.TRANSPARENT)
-win32gui.SetTextColor(pDC, win32api.RGB(0, 255, 0))
-win32gui.DrawText(
-    pDC,
-    "Printed by Python!",
-    -1,
-    (0, 0, int(printerwidth * 0.9), int(printerheight * 0.9)),
-    win32con.DT_RIGHT | win32con.DT_BOTTOM | win32con.DT_SINGLELINE,
-)
-win32print.EndPage(pDC)
-win32print.EndDoc(pDC)
-
-win32print.ClosePrinter(p)
-win32gui.DeleteObject(dcBM)
-win32gui.DeleteObject(pcBM)
-win32gui.DeleteObject(hf)
-win32gui.DeleteDC(dDC)
-win32gui.DeleteDC(dcDC)
-win32gui.DeleteDC(pDC)
-win32gui.DeleteDC(pcDC)
diff --git a/lib/win32/Demos/rastest.py b/lib/win32/Demos/rastest.py
deleted file mode 100644
index 669a2a80..00000000
--- a/lib/win32/Demos/rastest.py
+++ /dev/null
@@ -1,168 +0,0 @@
-# rastest.py - test/demonstrate the win32ras module.
-# Much of the code here contributed by Jethro Wright.
-
-import os
-import sys
-
-import win32ras
-
-# Build a little dictionary of RAS states to decent strings.
-# eg win32ras.RASCS_OpenPort -> "OpenPort"
-stateMap = {}
-for name, val in list(win32ras.__dict__.items()):
-    if name[:6] == "RASCS_":
-        stateMap[val] = name[6:]
-
-# Use a lock so the callback can tell the main thread when it is finished.
-import win32event
-
-callbackEvent = win32event.CreateEvent(None, 0, 0, None)
-
-
-def Callback(hras, msg, state, error, exterror):
-    #       print "Callback called with ", hras, msg, state, error, exterror
-    stateName = stateMap.get(state, "Unknown state?")
-    print("Status is %s (%04lx), error code is %d" % (stateName, state, error))
-    finished = state in [win32ras.RASCS_Connected]
-    if finished:
-        win32event.SetEvent(callbackEvent)
-    if error != 0 or int(state) == win32ras.RASCS_Disconnected:
-        #       we know for sure this is a good place to hangup....
-        print("Detected call failure: %s" % win32ras.GetErrorString(error))
-        HangUp(hras)
-        win32event.SetEvent(callbackEvent)
-
-
-def ShowConnections():
-    print("All phone-book entries:")
-    for (name,) in win32ras.EnumEntries():
-        print(" ", name)
-    print("Current Connections:")
-    for con in win32ras.EnumConnections():
-        print(" ", con)
-
-
-def EditEntry(entryName):
-    try:
-        win32ras.EditPhonebookEntry(0, None, entryName)
-    except win32ras.error as xxx_todo_changeme:
-        (rc, function, msg) = xxx_todo_changeme.args
-        print("Can not edit/find the RAS entry -", msg)
-
-
-def HangUp(hras):
-    #       trap potential, irrelevant errors from win32ras....
-    try:
-        win32ras.HangUp(hras)
-    except:
-        print("Tried to hang up gracefully on error, but didn't work....")
-    return None
-
-
-def Connect(entryName, bUseCallback):
-    if bUseCallback:
-        theCallback = Callback
-        win32event.ResetEvent(callbackEvent)
-    else:
-        theCallback = None
-    #       in order to *use* the username/password of a particular dun entry, one must
-    #       explicitly get those params under win95....
-    try:
-        dp, b = win32ras.GetEntryDialParams(None, entryName)
-    except:
-        print("Couldn't find DUN entry: %s" % entryName)
-    else:
-        hras, rc = win32ras.Dial(
-            None, None, (entryName, "", "", dp[3], dp[4], ""), theCallback
-        )
-        #       hras, rc = win32ras.Dial(None, None, (entryName, ),theCallback)
-        #       print hras, rc
-        if not bUseCallback and rc != 0:
-            print("Could not dial the RAS connection:", win32ras.GetErrorString(rc))
-            hras = HangUp(hras)
-        #       don't wait here if there's no need to....
-        elif (
-            bUseCallback
-            and win32event.WaitForSingleObject(callbackEvent, 60000)
-            != win32event.WAIT_OBJECT_0
-        ):
-            print("Gave up waiting for the process to complete!")
-            #       sdk docs state one must explcitly hangup, even if there's an error....
-            try:
-                cs = win32ras.GetConnectStatus(hras)
-            except:
-                #       on error, attempt a hang up anyway....
-                hras = HangUp(hras)
-            else:
-                if int(cs[0]) == win32ras.RASCS_Disconnected:
-                    hras = HangUp(hras)
-    return hras, rc
-
-
-def Disconnect(rasEntry):
-    # Need to find the entry
-    name = rasEntry.lower()
-    for hcon, entryName, devName, devType in win32ras.EnumConnections():
-        if entryName.lower() == name:
-            win32ras.HangUp(hcon)
-            print("Disconnected from", rasEntry)
-            break
-    else:
-        print("Could not find an open connection to", entryName)
-
-
-usage = """
-Usage: %s [-s] [-l] [-c connection] [-d connection]
--l : List phone-book entries and current connections.
--s : Show status while connecting/disconnecting (uses callbacks)
--c : Connect to the specified phonebook name.
--d : Disconnect from the specified phonebook name.
--e : Edit the specified phonebook entry.
-"""
-
-
-def main():
-    import getopt
-
-    try:
-        opts, args = getopt.getopt(sys.argv[1:], "slc:d:e:")
-    except getopt.error as why:
-        print(why)
-        print(
-            usage
-            % (
-                os.path.basename(
-                    sys.argv[0],
-                )
-            )
-        )
-        return
-
-    bCallback = 0
-    if args or not opts:
-        print(
-            usage
-            % (
-                os.path.basename(
-                    sys.argv[0],
-                )
-            )
-        )
-        return
-    for opt, val in opts:
-        if opt == "-s":
-            bCallback = 1
-        if opt == "-l":
-            ShowConnections()
-        if opt == "-c":
-            hras, rc = Connect(val, bCallback)
-            if hras != None:
-                print("hras: 0x%8lx, rc: 0x%04x" % (hras, rc))
-        if opt == "-d":
-            Disconnect(val)
-        if opt == "-e":
-            EditEntry(val)
-
-
-if __name__ == "__main__":
-    main()
diff --git a/lib/win32/Demos/security/GetTokenInformation.py b/lib/win32/Demos/security/GetTokenInformation.py
deleted file mode 100644
index 192c549e..00000000
--- a/lib/win32/Demos/security/GetTokenInformation.py
+++ /dev/null
@@ -1,110 +0,0 @@
-""" Lists various types of information about current user's access token,
-    including UAC status on Vista
-"""
-
-import pywintypes
-import win32api
-import win32con
-import win32security
-import winerror
-from security_enums import (
-    SECURITY_IMPERSONATION_LEVEL,
-    TOKEN_ELEVATION_TYPE,
-    TOKEN_GROUP_ATTRIBUTES,
-    TOKEN_PRIVILEGE_ATTRIBUTES,
-    TOKEN_TYPE,
-)
-
-
-def dump_token(th):
-    token_type = win32security.GetTokenInformation(th, win32security.TokenType)
-    print("TokenType:", token_type, TOKEN_TYPE.lookup_name(token_type))
-    if token_type == win32security.TokenImpersonation:
-        imp_lvl = win32security.GetTokenInformation(
-            th, win32security.TokenImpersonationLevel
-        )
-        print(
-            "TokenImpersonationLevel:",
-            imp_lvl,
-            SECURITY_IMPERSONATION_LEVEL.lookup_name(imp_lvl),
-        )
-
-    print(
-        "TokenSessionId:",
-        win32security.GetTokenInformation(th, win32security.TokenSessionId),
-    )
-
-    privs = win32security.GetTokenInformation(th, win32security.TokenPrivileges)
-    print("TokenPrivileges:")
-    for priv_luid, priv_flags in privs:
-        flag_names, unk = TOKEN_PRIVILEGE_ATTRIBUTES.lookup_flags(priv_flags)
-        flag_desc = " ".join(flag_names)
-        if unk:
-            flag_desc += "(" + str(unk) + ")"
-
-        priv_name = win32security.LookupPrivilegeName("", priv_luid)
-        priv_desc = win32security.LookupPrivilegeDisplayName("", priv_name)
-        print("\t", priv_name, priv_desc, priv_flags, flag_desc)
-
-    print("TokenGroups:")
-    groups = win32security.GetTokenInformation(th, win32security.TokenGroups)
-    for group_sid, group_attr in groups:
-        flag_names, unk = TOKEN_GROUP_ATTRIBUTES.lookup_flags(group_attr)
-        flag_desc = " ".join(flag_names)
-        if unk:
-            flag_desc += "(" + str(unk) + ")"
-        if group_attr & TOKEN_GROUP_ATTRIBUTES.SE_GROUP_LOGON_ID:
-            sid_desc = "Logon sid"
-        else:
-            sid_desc = win32security.LookupAccountSid("", group_sid)
-        print("\t", group_sid, sid_desc, group_attr, flag_desc)
-
-    ## Vista token information types, will throw (87, 'GetTokenInformation', 'The parameter is incorrect.') on earier OS
-    try:
-        is_elevated = win32security.GetTokenInformation(
-            th, win32security.TokenElevation
-        )
-        print("TokenElevation:", is_elevated)
-    except pywintypes.error as details:
-        if details.winerror != winerror.ERROR_INVALID_PARAMETER:
-            raise
-        return None
-    print(
-        "TokenHasRestrictions:",
-        win32security.GetTokenInformation(th, win32security.TokenHasRestrictions),
-    )
-    print(
-        "TokenMandatoryPolicy",
-        win32security.GetTokenInformation(th, win32security.TokenMandatoryPolicy),
-    )
-    print(
-        "TokenVirtualizationAllowed:",
-        win32security.GetTokenInformation(th, win32security.TokenVirtualizationAllowed),
-    )
-    print(
-        "TokenVirtualizationEnabled:",
-        win32security.GetTokenInformation(th, win32security.TokenVirtualizationEnabled),
-    )
-
-    elevation_type = win32security.GetTokenInformation(
-        th, win32security.TokenElevationType
-    )
-    print(
-        "TokenElevationType:",
-        elevation_type,
-        TOKEN_ELEVATION_TYPE.lookup_name(elevation_type),
-    )
-    if elevation_type != win32security.TokenElevationTypeDefault:
-        lt = win32security.GetTokenInformation(th, win32security.TokenLinkedToken)
-        print("TokenLinkedToken:", lt)
-    else:
-        lt = None
-    return lt
-
-
-ph = win32api.GetCurrentProcess()
-th = win32security.OpenProcessToken(ph, win32con.MAXIMUM_ALLOWED)
-lt = dump_token(th)
-if lt:
-    print("\n\nlinked token info:")
-    dump_token(lt)
diff --git a/lib/win32/Demos/security/account_rights.py b/lib/win32/Demos/security/account_rights.py
deleted file mode 100644
index 357b789a..00000000
--- a/lib/win32/Demos/security/account_rights.py
+++ /dev/null
@@ -1,51 +0,0 @@
-import ntsecuritycon
-import win32api
-import win32con
-import win32file
-import win32security
-from security_enums import ACCESS_MODE, ACE_FLAGS, TRUSTEE_FORM, TRUSTEE_TYPE
-
-new_privs = (
-    (
-        win32security.LookupPrivilegeValue("", ntsecuritycon.SE_SECURITY_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", ntsecuritycon.SE_CREATE_PERMANENT_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", "SeEnableDelegationPrivilege"),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),  ##doesn't seem to be in ntsecuritycon.py ?
-)
-
-ph = win32api.GetCurrentProcess()
-th = win32security.OpenProcessToken(
-    ph, win32security.TOKEN_ALL_ACCESS
-)  ##win32con.TOKEN_ADJUST_PRIVILEGES)
-win32security.AdjustTokenPrivileges(th, 0, new_privs)
-
-policy_handle = win32security.GetPolicyHandle("", win32security.POLICY_ALL_ACCESS)
-tmp_sid = win32security.LookupAccountName("", "tmp")[0]
-
-privs = [
-    ntsecuritycon.SE_DEBUG_NAME,
-    ntsecuritycon.SE_TCB_NAME,
-    ntsecuritycon.SE_RESTORE_NAME,
-    ntsecuritycon.SE_REMOTE_SHUTDOWN_NAME,
-]
-win32security.LsaAddAccountRights(policy_handle, tmp_sid, privs)
-
-privlist = win32security.LsaEnumerateAccountRights(policy_handle, tmp_sid)
-for priv in privlist:
-    print(priv)
-
-privs = [ntsecuritycon.SE_DEBUG_NAME, ntsecuritycon.SE_TCB_NAME]
-win32security.LsaRemoveAccountRights(policy_handle, tmp_sid, 0, privs)
-
-privlist = win32security.LsaEnumerateAccountRights(policy_handle, tmp_sid)
-for priv in privlist:
-    print(priv)
-
-win32security.LsaClose(policy_handle)
diff --git a/lib/win32/Demos/security/explicit_entries.py b/lib/win32/Demos/security/explicit_entries.py
deleted file mode 100644
index b04f4517..00000000
--- a/lib/win32/Demos/security/explicit_entries.py
+++ /dev/null
@@ -1,171 +0,0 @@
-import os
-
-import ntsecuritycon
-import win32api
-import win32con
-import win32file
-import win32security
-from security_enums import ACCESS_MODE, ACE_FLAGS, TRUSTEE_FORM, TRUSTEE_TYPE
-
-fname = os.path.join(win32api.GetTempPath(), "win32security_test.txt")
-f = open(fname, "w")
-f.write("Hello from Python\n")
-f.close()
-print("Testing on file", fname)
-
-new_privs = (
-    (
-        win32security.LookupPrivilegeValue("", ntsecuritycon.SE_SECURITY_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", ntsecuritycon.SE_SHUTDOWN_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", ntsecuritycon.SE_RESTORE_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", ntsecuritycon.SE_TAKE_OWNERSHIP_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", ntsecuritycon.SE_CREATE_PERMANENT_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", "SeEnableDelegationPrivilege"),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),  ##doesn't seem to be in ntsecuritycon.py ?
-)
-
-ph = win32api.GetCurrentProcess()
-th = win32security.OpenProcessToken(
-    ph, win32security.TOKEN_ALL_ACCESS
-)  ##win32con.TOKEN_ADJUST_PRIVILEGES)
-win32security.AdjustTokenPrivileges(th, 0, new_privs)
-
-all_security_info = (
-    win32security.OWNER_SECURITY_INFORMATION
-    | win32security.GROUP_SECURITY_INFORMATION
-    | win32security.DACL_SECURITY_INFORMATION
-    | win32security.SACL_SECURITY_INFORMATION
-)
-
-sd = win32security.GetFileSecurity(fname, all_security_info)
-
-old_sacl = sd.GetSecurityDescriptorSacl()
-if old_sacl == None:
-    old_sacl = win32security.ACL()
-old_dacl = sd.GetSecurityDescriptorDacl()
-if old_dacl == None:
-    old_dacl = win32security.ACL()
-
-my_sid = win32security.GetTokenInformation(th, ntsecuritycon.TokenUser)[0]
-tmp_sid = win32security.LookupAccountName("", "tmp")[0]
-pwr_sid = win32security.LookupAccountName("", "Power Users")[0]
-
-
-## MultipleTrustee,MultipleTrusteeOperation,TrusteeForm,TrusteeType,Identifier
-## first two are ignored
-my_trustee = {}
-my_trustee["MultipleTrustee"] = None
-my_trustee["MultipleTrusteeOperation"] = 0
-my_trustee["TrusteeForm"] = TRUSTEE_FORM.TRUSTEE_IS_SID
-my_trustee["TrusteeType"] = TRUSTEE_TYPE.TRUSTEE_IS_USER
-my_trustee["Identifier"] = my_sid
-
-tmp_trustee = {}
-tmp_trustee["MultipleTrustee"] = None
-tmp_trustee["MultipleTrusteeOperation"] = 0
-tmp_trustee["TrusteeForm"] = TRUSTEE_FORM.TRUSTEE_IS_NAME
-tmp_trustee["TrusteeType"] = TRUSTEE_TYPE.TRUSTEE_IS_USER
-tmp_trustee["Identifier"] = "rupole\\tmp"
-
-pwr_trustee = {}
-pwr_trustee["MultipleTrustee"] = None
-pwr_trustee["MultipleTrusteeOperation"] = 0
-pwr_trustee["TrusteeForm"] = TRUSTEE_FORM.TRUSTEE_IS_SID
-pwr_trustee["TrusteeType"] = TRUSTEE_TYPE.TRUSTEE_IS_USER
-pwr_trustee["Identifier"] = pwr_sid
-
-expl_list = []
-expl_list.append(
-    {
-        "Trustee": my_trustee,
-        "Inheritance": ACE_FLAGS.NO_INHERITANCE,
-        "AccessMode": ACCESS_MODE.SET_AUDIT_SUCCESS,  ##|ACCESS_MODE.SET_AUDIT_FAILURE,
-        "AccessPermissions": win32con.GENERIC_ALL,
-    }
-)
-
-expl_list.append(
-    {
-        "Trustee": my_trustee,
-        "Inheritance": ACE_FLAGS.NO_INHERITANCE,
-        "AccessMode": ACCESS_MODE.SET_AUDIT_FAILURE,
-        "AccessPermissions": win32con.GENERIC_ALL,
-    }
-)
-
-expl_list.append(
-    {
-        "Trustee": tmp_trustee,
-        "Inheritance": ACE_FLAGS.NO_INHERITANCE,
-        "AccessMode": ACCESS_MODE.SET_AUDIT_SUCCESS,
-        "AccessPermissions": win32con.GENERIC_ALL,
-    }
-)
-
-expl_list.append(
-    {
-        "Trustee": tmp_trustee,
-        "Inheritance": ACE_FLAGS.NO_INHERITANCE,
-        "AccessMode": ACCESS_MODE.SET_AUDIT_FAILURE,
-        "AccessPermissions": win32con.GENERIC_ALL,
-    }
-)
-old_sacl.SetEntriesInAcl(expl_list)
-
-expl_list = []
-expl_list.append(
-    {
-        "Trustee": tmp_trustee,
-        "Inheritance": ACE_FLAGS.NO_INHERITANCE,
-        "AccessMode": ACCESS_MODE.DENY_ACCESS,
-        "AccessPermissions": win32con.DELETE,
-    }
-)
-
-expl_list.append(
-    {
-        "Trustee": tmp_trustee,
-        "Inheritance": ACE_FLAGS.NO_INHERITANCE,
-        "AccessMode": ACCESS_MODE.GRANT_ACCESS,
-        "AccessPermissions": win32con.WRITE_OWNER,
-    }
-)
-expl_list.append(
-    {
-        "Trustee": pwr_trustee,
-        "Inheritance": ACE_FLAGS.NO_INHERITANCE,
-        "AccessMode": ACCESS_MODE.GRANT_ACCESS,
-        "AccessPermissions": win32con.GENERIC_READ,
-    }
-)
-expl_list.append(
-    {
-        "Trustee": my_trustee,
-        "Inheritance": ACE_FLAGS.NO_INHERITANCE,
-        "AccessMode": ACCESS_MODE.GRANT_ACCESS,
-        "AccessPermissions": win32con.GENERIC_ALL,
-    }
-)
-
-old_dacl.SetEntriesInAcl(expl_list)
-sd.SetSecurityDescriptorSacl(1, old_sacl, 1)
-sd.SetSecurityDescriptorDacl(1, old_dacl, 1)
-sd.SetSecurityDescriptorOwner(pwr_sid, 1)
-
-win32security.SetFileSecurity(fname, all_security_info, sd)
diff --git a/lib/win32/Demos/security/get_policy_info.py b/lib/win32/Demos/security/get_policy_info.py
deleted file mode 100644
index 1eba9cd0..00000000
--- a/lib/win32/Demos/security/get_policy_info.py
+++ /dev/null
@@ -1,42 +0,0 @@
-import ntsecuritycon
-import win32api
-import win32file
-import win32security
-
-policy_handle = win32security.GetPolicyHandle("rupole", win32security.POLICY_ALL_ACCESS)
-
-## mod_nbr, mod_time = win32security.LsaQueryInformationPolicy(policy_handle,win32security.PolicyModificationInformation)
-## print mod_nbr, mod_time
-
-(
-    domain_name,
-    dns_domain_name,
-    dns_forest_name,
-    domain_guid,
-    domain_sid,
-) = win32security.LsaQueryInformationPolicy(
-    policy_handle, win32security.PolicyDnsDomainInformation
-)
-print(domain_name, dns_domain_name, dns_forest_name, domain_guid, domain_sid)
-
-event_audit_info = win32security.LsaQueryInformationPolicy(
-    policy_handle, win32security.PolicyAuditEventsInformation
-)
-print(event_audit_info)
-
-domain_name, sid = win32security.LsaQueryInformationPolicy(
-    policy_handle, win32security.PolicyPrimaryDomainInformation
-)
-print(domain_name, sid)
-
-domain_name, sid = win32security.LsaQueryInformationPolicy(
-    policy_handle, win32security.PolicyAccountDomainInformation
-)
-print(domain_name, sid)
-
-server_role = win32security.LsaQueryInformationPolicy(
-    policy_handle, win32security.PolicyLsaServerRoleInformation
-)
-print("server role: ", server_role)
-
-win32security.LsaClose(policy_handle)
diff --git a/lib/win32/Demos/security/list_rights.py b/lib/win32/Demos/security/list_rights.py
deleted file mode 100644
index 780008a2..00000000
--- a/lib/win32/Demos/security/list_rights.py
+++ /dev/null
@@ -1,37 +0,0 @@
-import ntsecuritycon
-import win32api
-import win32con
-import win32file
-import win32security
-from security_enums import ACCESS_MODE, ACE_FLAGS, TRUSTEE_FORM, TRUSTEE_TYPE
-
-new_privs = (
-    (
-        win32security.LookupPrivilegeValue("", ntsecuritycon.SE_SECURITY_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", ntsecuritycon.SE_CREATE_PERMANENT_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", "SeEnableDelegationPrivilege"),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),  ##doesn't seem to be in ntsecuritycon.py ?
-)
-
-ph = win32api.GetCurrentProcess()
-th = win32security.OpenProcessToken(
-    ph, win32security.TOKEN_ALL_ACCESS
-)  ##win32con.TOKEN_ADJUST_PRIVILEGES)
-win32security.AdjustTokenPrivileges(th, 0, new_privs)
-
-policy_handle = win32security.GetPolicyHandle("", win32security.POLICY_ALL_ACCESS)
-
-sidlist = win32security.LsaEnumerateAccountsWithUserRight(
-    policy_handle, ntsecuritycon.SE_RESTORE_NAME
-)
-for sid in sidlist:
-    print(win32security.LookupAccountSid("", sid))
-
-win32security.LsaClose(policy_handle)
diff --git a/lib/win32/Demos/security/localized_names.py b/lib/win32/Demos/security/localized_names.py
deleted file mode 100644
index 30a0bde6..00000000
--- a/lib/win32/Demos/security/localized_names.py
+++ /dev/null
@@ -1,65 +0,0 @@
-# A Python port of the MS knowledge base article Q157234
-# "How to deal with localized and renamed user and group names"
-# http://support.microsoft.com/default.aspx?kbid=157234
-
-import sys
-
-import pywintypes
-from ntsecuritycon import *
-from win32net import NetUserModalsGet
-from win32security import LookupAccountSid
-
-
-def LookupAliasFromRid(TargetComputer, Rid):
-    # Sid is the same regardless of machine, since the well-known
-    # BUILTIN domain is referenced.
-    sid = pywintypes.SID()
-    sid.Initialize(SECURITY_NT_AUTHORITY, 2)
-
-    for i, r in enumerate((SECURITY_BUILTIN_DOMAIN_RID, Rid)):
-        sid.SetSubAuthority(i, r)
-
-    name, domain, typ = LookupAccountSid(TargetComputer, sid)
-    return name
-
-
-def LookupUserGroupFromRid(TargetComputer, Rid):
-    # get the account domain Sid on the target machine
-    # note: if you were looking up multiple sids based on the same
-    # account domain, only need to call this once.
-    umi2 = NetUserModalsGet(TargetComputer, 2)
-    domain_sid = umi2["domain_id"]
-
-    SubAuthorityCount = domain_sid.GetSubAuthorityCount()
-
-    # create and init new sid with acct domain Sid + acct Rid
-    sid = pywintypes.SID()
-    sid.Initialize(domain_sid.GetSidIdentifierAuthority(), SubAuthorityCount + 1)
-
-    # copy existing subauthorities from account domain Sid into
-    # new Sid
-    for i in range(SubAuthorityCount):
-        sid.SetSubAuthority(i, domain_sid.GetSubAuthority(i))
-
-    # append Rid to new Sid
-    sid.SetSubAuthority(SubAuthorityCount, Rid)
-
-    name, domain, typ = LookupAccountSid(TargetComputer, sid)
-    return name
-
-
-def main():
-    if len(sys.argv) == 2:
-        targetComputer = sys.argv[1]
-    else:
-        targetComputer = None
-
-    name = LookupUserGroupFromRid(targetComputer, DOMAIN_USER_RID_ADMIN)
-    print("'Administrator' user name = %s" % (name,))
-
-    name = LookupAliasFromRid(targetComputer, DOMAIN_ALIAS_RID_ADMINS)
-    print("'Administrators' local group/alias name = %s" % (name,))
-
-
-if __name__ == "__main__":
-    main()
diff --git a/lib/win32/Demos/security/lsaregevent.py b/lib/win32/Demos/security/lsaregevent.py
deleted file mode 100644
index 38e7adc9..00000000
--- a/lib/win32/Demos/security/lsaregevent.py
+++ /dev/null
@@ -1,14 +0,0 @@
-import win32event
-import win32security
-
-evt = win32event.CreateEvent(None, 0, 0, None)
-win32security.LsaRegisterPolicyChangeNotification(
-    win32security.PolicyNotifyAuditEventsInformation, evt
-)
-print("Waiting for you change Audit policy in Management console ...")
-ret_code = win32event.WaitForSingleObject(evt, 1000000000)
-## should come back when you change Audit policy in Management console ...
-print(ret_code)
-win32security.LsaUnregisterPolicyChangeNotification(
-    win32security.PolicyNotifyAuditEventsInformation, evt
-)
diff --git a/lib/win32/Demos/security/lsastore.py b/lib/win32/Demos/security/lsastore.py
deleted file mode 100644
index dd9ff384..00000000
--- a/lib/win32/Demos/security/lsastore.py
+++ /dev/null
@@ -1,12 +0,0 @@
-import win32security
-
-policy_handle = win32security.GetPolicyHandle("", win32security.POLICY_ALL_ACCESS)
-privatedata = "some sensitive data"
-keyname = "tmp"
-win32security.LsaStorePrivateData(policy_handle, keyname, privatedata)
-retrieveddata = win32security.LsaRetrievePrivateData(policy_handle, keyname)
-assert retrieveddata == privatedata
-
-## passing None deletes key
-win32security.LsaStorePrivateData(policy_handle, keyname, None)
-win32security.LsaClose(policy_handle)
diff --git a/lib/win32/Demos/security/query_information.py b/lib/win32/Demos/security/query_information.py
deleted file mode 100644
index 9fa3e4a9..00000000
--- a/lib/win32/Demos/security/query_information.py
+++ /dev/null
@@ -1,25 +0,0 @@
-import win32api
-import win32security
-import winerror
-from ntsecuritycon import *
-
-
-# This is a Python implementation of win32api.GetDomainName()
-def GetDomainName():
-    try:
-        tok = win32security.OpenThreadToken(win32api.GetCurrentThread(), TOKEN_QUERY, 1)
-    except win32api.error as details:
-        if details[0] != winerror.ERROR_NO_TOKEN:
-            raise
-        # attempt to open the process token, since no thread token
-        # exists
-        tok = win32security.OpenProcessToken(win32api.GetCurrentProcess(), TOKEN_QUERY)
-    sid, attr = win32security.GetTokenInformation(tok, TokenUser)
-    win32api.CloseHandle(tok)
-
-    name, dom, typ = win32security.LookupAccountSid(None, sid)
-    return dom
-
-
-if __name__ == "__main__":
-    print("Domain name is", GetDomainName())
diff --git a/lib/win32/Demos/security/regsave_sa.py b/lib/win32/Demos/security/regsave_sa.py
deleted file mode 100644
index 29a6ac10..00000000
--- a/lib/win32/Demos/security/regsave_sa.py
+++ /dev/null
@@ -1,61 +0,0 @@
-fname = "h:\\tmp.reg"
-
-import os
-
-import ntsecuritycon
-import pywintypes
-import win32api
-import win32con
-import win32security
-
-## regsave will not overwrite a file
-if os.path.isfile(fname):
-    os.remove(fname)
-
-new_privs = (
-    (
-        win32security.LookupPrivilegeValue("", ntsecuritycon.SE_SECURITY_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", ntsecuritycon.SE_TCB_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", ntsecuritycon.SE_BACKUP_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", ntsecuritycon.SE_RESTORE_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-)
-ph = win32api.GetCurrentProcess()
-th = win32security.OpenProcessToken(
-    ph, win32security.TOKEN_ALL_ACCESS | win32con.TOKEN_ADJUST_PRIVILEGES
-)
-win32security.AdjustTokenPrivileges(th, 0, new_privs)
-my_sid = win32security.GetTokenInformation(th, ntsecuritycon.TokenUser)[0]
-
-hklm = win32api.RegOpenKey(
-    win32con.HKEY_LOCAL_MACHINE, None, 0, win32con.KEY_ALL_ACCESS
-)
-skey = win32api.RegOpenKey(hklm, "SYSTEM", 0, win32con.KEY_ALL_ACCESS)
-
-sa = pywintypes.SECURITY_ATTRIBUTES()
-sd = pywintypes.SECURITY_DESCRIPTOR()
-sa.SECURITY_DESCRIPTOR = sd
-acl = pywintypes.ACL()
-
-pwr_sid = win32security.LookupAccountName("", "Power Users")[0]
-acl.AddAccessAllowedAce(
-    win32con.ACL_REVISION,
-    win32con.GENERIC_READ | win32con.ACCESS_SYSTEM_SECURITY,
-    my_sid,
-)
-sd.SetSecurityDescriptorDacl(1, acl, 0)
-sd.SetSecurityDescriptorOwner(pwr_sid, 0)
-sa.bInheritHandle = 1
-assert sa.SECURITY_DESCRIPTOR is sd
-
-win32api.RegSaveKey(skey, fname, sa)
diff --git a/lib/win32/Demos/security/regsecurity.py b/lib/win32/Demos/security/regsecurity.py
deleted file mode 100644
index 3bac65c0..00000000
--- a/lib/win32/Demos/security/regsecurity.py
+++ /dev/null
@@ -1,36 +0,0 @@
-import ntsecuritycon
-import win32api
-import win32con
-import win32security
-
-new_privs = (
-    (
-        win32security.LookupPrivilegeValue("", ntsecuritycon.SE_SECURITY_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", ntsecuritycon.SE_TCB_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-)
-ph = win32api.GetCurrentProcess()
-th = win32security.OpenProcessToken(
-    ph, win32security.TOKEN_ALL_ACCESS | win32con.TOKEN_ADJUST_PRIVILEGES
-)
-
-win32security.AdjustTokenPrivileges(th, 0, new_privs)
-hkey = win32api.RegOpenKey(
-    win32con.HKEY_LOCAL_MACHINE, None, 0, win32con.KEY_ALL_ACCESS
-)
-win32api.RegCreateKey(hkey, "SYSTEM\\NOTMP")
-notmpkey = win32api.RegOpenKey(
-    hkey, "SYSTEM\\notmp", 0, win32con.ACCESS_SYSTEM_SECURITY
-)
-
-tmp_sid = win32security.LookupAccountName("", "tmp")[0]
-sacl = win32security.ACL()
-sacl.AddAuditAccessAce(win32security.ACL_REVISION, win32con.GENERIC_ALL, tmp_sid, 1, 1)
-
-sd = win32security.SECURITY_DESCRIPTOR()
-sd.SetSecurityDescriptorSacl(1, sacl, 1)
-win32api.RegSetKeySecurity(notmpkey, win32con.SACL_SECURITY_INFORMATION, sd)
diff --git a/lib/win32/Demos/security/sa_inherit.py b/lib/win32/Demos/security/sa_inherit.py
deleted file mode 100644
index a2855e50..00000000
--- a/lib/win32/Demos/security/sa_inherit.py
+++ /dev/null
@@ -1,8 +0,0 @@
-import pywintypes
-import win32security
-
-sa = pywintypes.SECURITY_ATTRIBUTES()
-tmp_sid = win32security.LookupAccountName("", "tmp")[0]
-sa.SetSecurityDescriptorOwner(tmp_sid, 0)
-sid = sa.SECURITY_DESCRIPTOR.GetSecurityDescriptorOwner()
-print(win32security.LookupAccountSid("", sid))
diff --git a/lib/win32/Demos/security/security_enums.py b/lib/win32/Demos/security/security_enums.py
deleted file mode 100644
index ab3cc6d3..00000000
--- a/lib/win32/Demos/security/security_enums.py
+++ /dev/null
@@ -1,336 +0,0 @@
-import ntsecuritycon
-import win32security
-import winnt
-
-
-class Enum:
-    def __init__(self, *const_names):
-        """Accepts variable number of constant names that can be found in either
-        win32security, ntsecuritycon, or winnt."""
-        for const_name in const_names:
-            try:
-                const_val = getattr(win32security, const_name)
-            except AttributeError:
-                try:
-                    const_val = getattr(ntsecuritycon, const_name)
-                except AttributeError:
-                    try:
-                        const_val = getattr(winnt, const_name)
-                    except AttributeError:
-                        raise AttributeError(
-                            'Constant "%s" not found in win32security, ntsecuritycon, or winnt.'
-                            % const_name
-                        )
-            setattr(self, const_name, const_val)
-
-    def lookup_name(self, const_val):
-        """Looks up the name of a particular value."""
-        for k, v in self.__dict__.items():
-            if v == const_val:
-                return k
-        raise AttributeError("Value %s not found in enum" % const_val)
-
-    def lookup_flags(self, flags):
-        """Returns the names of all recognized flags in input, and any flags not found in the enum."""
-        flag_names = []
-        unknown_flags = flags
-        for k, v in self.__dict__.items():
-            if flags & v == v:
-                flag_names.append(k)
-                unknown_flags = unknown_flags & ~v
-        return flag_names, unknown_flags
-
-
-TOKEN_INFORMATION_CLASS = Enum(
-    "TokenUser",
-    "TokenGroups",
-    "TokenPrivileges",
-    "TokenOwner",
-    "TokenPrimaryGroup",
-    "TokenDefaultDacl",
-    "TokenSource",
-    "TokenType",
-    "TokenImpersonationLevel",
-    "TokenStatistics",
-    "TokenRestrictedSids",
-    "TokenSessionId",
-    "TokenGroupsAndPrivileges",
-    "TokenSessionReference",
-    "TokenSandBoxInert",
-    "TokenAuditPolicy",
-    "TokenOrigin",
-    "TokenElevationType",
-    "TokenLinkedToken",
-    "TokenElevation",
-    "TokenHasRestrictions",
-    "TokenAccessInformation",
-    "TokenVirtualizationAllowed",
-    "TokenVirtualizationEnabled",
-    "TokenIntegrityLevel",
-    "TokenUIAccess",
-    "TokenMandatoryPolicy",
-    "TokenLogonSid",
-)
-
-TOKEN_TYPE = Enum("TokenPrimary", "TokenImpersonation")
-
-TOKEN_ELEVATION_TYPE = Enum(
-    "TokenElevationTypeDefault", "TokenElevationTypeFull", "TokenElevationTypeLimited"
-)
-
-POLICY_AUDIT_EVENT_TYPE = Enum(
-    "AuditCategorySystem",
-    "AuditCategoryLogon",
-    "AuditCategoryObjectAccess",
-    "AuditCategoryPrivilegeUse",
-    "AuditCategoryDetailedTracking",
-    "AuditCategoryPolicyChange",
-    "AuditCategoryAccountManagement",
-    "AuditCategoryDirectoryServiceAccess",
-    "AuditCategoryAccountLogon",
-)
-
-POLICY_INFORMATION_CLASS = Enum(
-    "PolicyAuditLogInformation",
-    "PolicyAuditEventsInformation",
-    "PolicyPrimaryDomainInformation",
-    "PolicyPdAccountInformation",
-    "PolicyAccountDomainInformation",
-    "PolicyLsaServerRoleInformation",
-    "PolicyReplicaSourceInformation",
-    "PolicyDefaultQuotaInformation",
-    "PolicyModificationInformation",
-    "PolicyAuditFullSetInformation",
-    "PolicyAuditFullQueryInformation",
-    "PolicyDnsDomainInformation",
-)
-
-POLICY_LSA_SERVER_ROLE = Enum("PolicyServerRoleBackup", "PolicyServerRolePrimary")
-
-## access modes for opening a policy handle - this is not a real enum
-POLICY_ACCESS_MODES = Enum(
-    "POLICY_VIEW_LOCAL_INFORMATION",
-    "POLICY_VIEW_AUDIT_INFORMATION",
-    "POLICY_GET_PRIVATE_INFORMATION",
-    "POLICY_TRUST_ADMIN",
-    "POLICY_CREATE_ACCOUNT",
-    "POLICY_CREATE_SECRET",
-    "POLICY_CREATE_PRIVILEGE",
-    "POLICY_SET_DEFAULT_QUOTA_LIMITS",
-    "POLICY_SET_AUDIT_REQUIREMENTS",
-    "POLICY_AUDIT_LOG_ADMIN",
-    "POLICY_SERVER_ADMIN",
-    "POLICY_LOOKUP_NAMES",
-    "POLICY_NOTIFICATION",
-    "POLICY_ALL_ACCESS",
-    "POLICY_READ",
-    "POLICY_WRITE",
-    "POLICY_EXECUTE",
-)
-
-## EventAuditingOptions flags - not a real enum
-POLICY_AUDIT_EVENT_OPTIONS_FLAGS = Enum(
-    "POLICY_AUDIT_EVENT_UNCHANGED",
-    "POLICY_AUDIT_EVENT_SUCCESS",
-    "POLICY_AUDIT_EVENT_FAILURE",
-    "POLICY_AUDIT_EVENT_NONE",
-)
-
-# AceType in ACE_HEADER - not a real enum
-ACE_TYPE = Enum(
-    "ACCESS_MIN_MS_ACE_TYPE",
-    "ACCESS_ALLOWED_ACE_TYPE",
-    "ACCESS_DENIED_ACE_TYPE",
-    "SYSTEM_AUDIT_ACE_TYPE",
-    "SYSTEM_ALARM_ACE_TYPE",
-    "ACCESS_MAX_MS_V2_ACE_TYPE",
-    "ACCESS_ALLOWED_COMPOUND_ACE_TYPE",
-    "ACCESS_MAX_MS_V3_ACE_TYPE",
-    "ACCESS_MIN_MS_OBJECT_ACE_TYPE",
-    "ACCESS_ALLOWED_OBJECT_ACE_TYPE",
-    "ACCESS_DENIED_OBJECT_ACE_TYPE",
-    "SYSTEM_AUDIT_OBJECT_ACE_TYPE",
-    "SYSTEM_ALARM_OBJECT_ACE_TYPE",
-    "ACCESS_MAX_MS_OBJECT_ACE_TYPE",
-    "ACCESS_MAX_MS_V4_ACE_TYPE",
-    "ACCESS_MAX_MS_ACE_TYPE",
-    "ACCESS_ALLOWED_CALLBACK_ACE_TYPE",
-    "ACCESS_DENIED_CALLBACK_ACE_TYPE",
-    "ACCESS_ALLOWED_CALLBACK_OBJECT_ACE_TYPE",
-    "ACCESS_DENIED_CALLBACK_OBJECT_ACE_TYPE",
-    "SYSTEM_AUDIT_CALLBACK_ACE_TYPE",
-    "SYSTEM_ALARM_CALLBACK_ACE_TYPE",
-    "SYSTEM_AUDIT_CALLBACK_OBJECT_ACE_TYPE",
-    "SYSTEM_ALARM_CALLBACK_OBJECT_ACE_TYPE",
-    "SYSTEM_MANDATORY_LABEL_ACE_TYPE",
-    "ACCESS_MAX_MS_V5_ACE_TYPE",
-)
-
-# bit flags for AceFlags - not a real enum
-ACE_FLAGS = Enum(
-    "CONTAINER_INHERIT_ACE",
-    "FAILED_ACCESS_ACE_FLAG",
-    "INHERIT_ONLY_ACE",
-    "INHERITED_ACE",
-    "NO_PROPAGATE_INHERIT_ACE",
-    "OBJECT_INHERIT_ACE",
-    "SUCCESSFUL_ACCESS_ACE_FLAG",
-    "NO_INHERITANCE",
-    "SUB_CONTAINERS_AND_OBJECTS_INHERIT",
-    "SUB_CONTAINERS_ONLY_INHERIT",
-    "SUB_OBJECTS_ONLY_INHERIT",
-)
-
-# used in SetEntriesInAcl - very similar to ACE_TYPE
-ACCESS_MODE = Enum(
-    "NOT_USED_ACCESS",
-    "GRANT_ACCESS",
-    "SET_ACCESS",
-    "DENY_ACCESS",
-    "REVOKE_ACCESS",
-    "SET_AUDIT_SUCCESS",
-    "SET_AUDIT_FAILURE",
-)
-
-# Bit flags in PSECURITY_DESCRIPTOR->Control - not a real enum
-SECURITY_DESCRIPTOR_CONTROL_FLAGS = Enum(
-    "SE_DACL_AUTO_INHERITED",  ## win2k and up
-    "SE_SACL_AUTO_INHERITED",  ## win2k and up
-    "SE_DACL_PROTECTED",  ## win2k and up
-    "SE_SACL_PROTECTED",  ## win2k and up
-    "SE_DACL_DEFAULTED",
-    "SE_DACL_PRESENT",
-    "SE_GROUP_DEFAULTED",
-    "SE_OWNER_DEFAULTED",
-    "SE_SACL_PRESENT",
-    "SE_SELF_RELATIVE",
-    "SE_SACL_DEFAULTED",
-)
-
-# types of SID
-SID_NAME_USE = Enum(
-    "SidTypeUser",
-    "SidTypeGroup",
-    "SidTypeDomain",
-    "SidTypeAlias",
-    "SidTypeWellKnownGroup",
-    "SidTypeDeletedAccount",
-    "SidTypeInvalid",
-    "SidTypeUnknown",
-    "SidTypeComputer",
-    "SidTypeLabel",
-)
-
-## bit flags, not a real enum
-TOKEN_ACCESS_PRIVILEGES = Enum(
-    "TOKEN_ADJUST_DEFAULT",
-    "TOKEN_ADJUST_GROUPS",
-    "TOKEN_ADJUST_PRIVILEGES",
-    "TOKEN_ALL_ACCESS",
-    "TOKEN_ASSIGN_PRIMARY",
-    "TOKEN_DUPLICATE",
-    "TOKEN_EXECUTE",
-    "TOKEN_IMPERSONATE",
-    "TOKEN_QUERY",
-    "TOKEN_QUERY_SOURCE",
-    "TOKEN_READ",
-    "TOKEN_WRITE",
-)
-
-SECURITY_IMPERSONATION_LEVEL = Enum(
-    "SecurityAnonymous",
-    "SecurityIdentification",
-    "SecurityImpersonation",
-    "SecurityDelegation",
-)
-
-POLICY_SERVER_ENABLE_STATE = Enum("PolicyServerEnabled", "PolicyServerDisabled")
-
-POLICY_NOTIFICATION_INFORMATION_CLASS = Enum(
-    "PolicyNotifyAuditEventsInformation",
-    "PolicyNotifyAccountDomainInformation",
-    "PolicyNotifyServerRoleInformation",
-    "PolicyNotifyDnsDomainInformation",
-    "PolicyNotifyDomainEfsInformation",
-    "PolicyNotifyDomainKerberosTicketInformation",
-    "PolicyNotifyMachineAccountPasswordInformation",
-)
-
-TRUSTED_INFORMATION_CLASS = Enum(
-    "TrustedDomainNameInformation",
-    "TrustedControllersInformation",
-    "TrustedPosixOffsetInformation",
-    "TrustedPasswordInformation",
-    "TrustedDomainInformationBasic",
-    "TrustedDomainInformationEx",
-    "TrustedDomainAuthInformation",
-    "TrustedDomainFullInformation",
-    "TrustedDomainAuthInformationInternal",
-    "TrustedDomainFullInformationInternal",
-    "TrustedDomainInformationEx2Internal",
-    "TrustedDomainFullInformation2Internal",
-)
-
-TRUSTEE_FORM = Enum(
-    "TRUSTEE_IS_SID",
-    "TRUSTEE_IS_NAME",
-    "TRUSTEE_BAD_FORM",
-    "TRUSTEE_IS_OBJECTS_AND_SID",
-    "TRUSTEE_IS_OBJECTS_AND_NAME",
-)
-
-TRUSTEE_TYPE = Enum(
-    "TRUSTEE_IS_UNKNOWN",
-    "TRUSTEE_IS_USER",
-    "TRUSTEE_IS_GROUP",
-    "TRUSTEE_IS_DOMAIN",
-    "TRUSTEE_IS_ALIAS",
-    "TRUSTEE_IS_WELL_KNOWN_GROUP",
-    "TRUSTEE_IS_DELETED",
-    "TRUSTEE_IS_INVALID",
-    "TRUSTEE_IS_COMPUTER",
-)
-
-## SE_OBJECT_TYPE - securable objects
-SE_OBJECT_TYPE = Enum(
-    "SE_UNKNOWN_OBJECT_TYPE",
-    "SE_FILE_OBJECT",
-    "SE_SERVICE",
-    "SE_PRINTER",
-    "SE_REGISTRY_KEY",
-    "SE_LMSHARE",
-    "SE_KERNEL_OBJECT",
-    "SE_WINDOW_OBJECT",
-    "SE_DS_OBJECT",
-    "SE_DS_OBJECT_ALL",
-    "SE_PROVIDER_DEFINED_OBJECT",
-    "SE_WMIGUID_OBJECT",
-    "SE_REGISTRY_WOW64_32KEY",
-)
-
-PRIVILEGE_FLAGS = Enum(
-    "SE_PRIVILEGE_ENABLED_BY_DEFAULT",
-    "SE_PRIVILEGE_ENABLED",
-    "SE_PRIVILEGE_USED_FOR_ACCESS",
-)
-
-# Group flags used with TokenGroups
-TOKEN_GROUP_ATTRIBUTES = Enum(
-    "SE_GROUP_MANDATORY",
-    "SE_GROUP_ENABLED_BY_DEFAULT",
-    "SE_GROUP_ENABLED",
-    "SE_GROUP_OWNER",
-    "SE_GROUP_USE_FOR_DENY_ONLY",
-    "SE_GROUP_INTEGRITY",
-    "SE_GROUP_INTEGRITY_ENABLED",
-    "SE_GROUP_LOGON_ID",
-    "SE_GROUP_RESOURCE",
-)
-
-# Privilege flags returned by TokenPrivileges
-TOKEN_PRIVILEGE_ATTRIBUTES = Enum(
-    "SE_PRIVILEGE_ENABLED_BY_DEFAULT",
-    "SE_PRIVILEGE_ENABLED",
-    "SE_PRIVILEGE_REMOVED",
-    "SE_PRIVILEGE_USED_FOR_ACCESS",
-)
diff --git a/lib/win32/Demos/security/set_file_audit.py b/lib/win32/Demos/security/set_file_audit.py
deleted file mode 100644
index 324d7274..00000000
--- a/lib/win32/Demos/security/set_file_audit.py
+++ /dev/null
@@ -1,107 +0,0 @@
-import os
-
-import ntsecuritycon
-import win32api
-import win32con
-import win32file
-import win32security
-from win32security import (
-    ACL_REVISION_DS,
-    CONTAINER_INHERIT_ACE,
-    DACL_SECURITY_INFORMATION,
-    GROUP_SECURITY_INFORMATION,
-    OBJECT_INHERIT_ACE,
-    OWNER_SECURITY_INFORMATION,
-    PROTECTED_DACL_SECURITY_INFORMATION,
-    SACL_SECURITY_INFORMATION,
-    SE_FILE_OBJECT,
-)
-
-## SE_SECURITY_NAME needed to access SACL, SE_RESTORE_NAME needed to change owner to someone other than yourself
-new_privs = (
-    (
-        win32security.LookupPrivilegeValue("", ntsecuritycon.SE_SECURITY_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", ntsecuritycon.SE_RESTORE_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-)
-ph = win32api.GetCurrentProcess()
-th = win32security.OpenProcessToken(
-    ph, win32security.TOKEN_ALL_ACCESS | win32con.TOKEN_ADJUST_PRIVILEGES
-)
-modified_privs = win32security.AdjustTokenPrivileges(th, 0, new_privs)
-
-## look up a few sids that should be available on most systems
-my_sid = win32security.GetTokenInformation(th, ntsecuritycon.TokenUser)[0]
-pwr_sid = win32security.LookupAccountName("", "Power Users")[0]
-admin_sid = win32security.LookupAccountName("", "Administrators")[0]
-everyone_sid = win32security.LookupAccountName("", "EveryOne")[0]
-
-## create a dir and set security so Everyone has read permissions, and all files and subdirs inherit its ACLs
-temp_dir = win32api.GetTempPath()
-dir_name = win32api.GetTempFileName(temp_dir, "sfa")[0]
-os.remove(dir_name)
-os.mkdir(dir_name)
-dir_dacl = win32security.ACL()
-dir_dacl.AddAccessAllowedAceEx(
-    ACL_REVISION_DS,
-    CONTAINER_INHERIT_ACE | OBJECT_INHERIT_ACE,
-    win32con.GENERIC_READ,
-    everyone_sid,
-)
-## make sure current user has permissions on dir
-dir_dacl.AddAccessAllowedAceEx(
-    ACL_REVISION_DS,
-    CONTAINER_INHERIT_ACE | OBJECT_INHERIT_ACE,
-    win32con.GENERIC_ALL,
-    my_sid,
-)
-## keep dir from inheriting any permissions so it only has ACEs explicitely set here
-win32security.SetNamedSecurityInfo(
-    dir_name,
-    SE_FILE_OBJECT,
-    OWNER_SECURITY_INFORMATION
-    | GROUP_SECURITY_INFORMATION
-    | DACL_SECURITY_INFORMATION
-    | PROTECTED_DACL_SECURITY_INFORMATION,
-    pwr_sid,
-    pwr_sid,
-    dir_dacl,
-    None,
-)
-
-## Create a file in the dir and add some specific permissions to it
-fname = win32api.GetTempFileName(dir_name, "sfa")[0]
-print(fname)
-file_sd = win32security.GetNamedSecurityInfo(
-    fname, SE_FILE_OBJECT, DACL_SECURITY_INFORMATION | SACL_SECURITY_INFORMATION
-)
-file_dacl = file_sd.GetSecurityDescriptorDacl()
-file_sacl = file_sd.GetSecurityDescriptorSacl()
-
-if file_dacl is None:
-    file_dacl = win32security.ACL()
-if file_sacl is None:
-    file_sacl = win32security.ACL()
-
-file_dacl.AddAccessDeniedAce(file_dacl.GetAclRevision(), win32con.DELETE, admin_sid)
-file_dacl.AddAccessDeniedAce(file_dacl.GetAclRevision(), win32con.DELETE, my_sid)
-file_dacl.AddAccessAllowedAce(file_dacl.GetAclRevision(), win32con.GENERIC_ALL, pwr_sid)
-file_sacl.AddAuditAccessAce(
-    file_dacl.GetAclRevision(), win32con.GENERIC_ALL, my_sid, True, True
-)
-
-win32security.SetNamedSecurityInfo(
-    fname,
-    SE_FILE_OBJECT,
-    DACL_SECURITY_INFORMATION | SACL_SECURITY_INFORMATION,
-    None,
-    None,
-    file_dacl,
-    file_sacl,
-)
-
-win32security.AdjustTokenPrivileges(th, 0, modified_privs)
diff --git a/lib/win32/Demos/security/set_file_owner.py b/lib/win32/Demos/security/set_file_owner.py
deleted file mode 100644
index 5a384da0..00000000
--- a/lib/win32/Demos/security/set_file_owner.py
+++ /dev/null
@@ -1,74 +0,0 @@
-fname = r"h:\tmp.txt"
-
-import ntsecuritycon
-import win32api
-import win32con
-import win32file
-import win32security
-
-new_privs = (
-    (
-        win32security.LookupPrivilegeValue("", ntsecuritycon.SE_SECURITY_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", ntsecuritycon.SE_SHUTDOWN_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", ntsecuritycon.SE_TCB_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", ntsecuritycon.SE_RESTORE_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", ntsecuritycon.SE_TAKE_OWNERSHIP_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", ntsecuritycon.SE_CREATE_PERMANENT_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", "SeEnableDelegationPrivilege"),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),  ##doesn't seem to be in ntsecuritycon.py ?
-)
-
-ph = win32api.GetCurrentProcess()
-th = win32security.OpenProcessToken(
-    ph, win32security.TOKEN_ALL_ACCESS | win32con.TOKEN_ADJUST_PRIVILEGES
-)
-win32security.AdjustTokenPrivileges(th, 0, new_privs)
-
-all_security_info = (
-    win32security.OWNER_SECURITY_INFORMATION
-    | win32security.GROUP_SECURITY_INFORMATION
-    | win32security.DACL_SECURITY_INFORMATION
-    | win32security.SACL_SECURITY_INFORMATION
-)
-
-sd = win32security.GetFileSecurity(fname, all_security_info)
-old_dacl = sd.GetSecurityDescriptorDacl()
-old_sacl = sd.GetSecurityDescriptorSacl()
-old_group = sd.GetSecurityDescriptorGroup()
-
-new_sd = win32security.SECURITY_DESCRIPTOR()
-print(
-    "relative, valid, size: ",
-    new_sd.IsSelfRelative(),
-    new_sd.IsValid(),
-    new_sd.GetLength(),
-)
-
-my_sid = win32security.GetTokenInformation(th, ntsecuritycon.TokenUser)[0]
-tmp_sid = win32security.LookupAccountName("", "tmp")[0]
-
-new_sd.SetSecurityDescriptorSacl(1, old_sacl, 1)
-new_sd.SetSecurityDescriptorDacl(1, old_dacl, 1)
-new_sd.SetSecurityDescriptorOwner(tmp_sid, 0)
-new_sd.SetSecurityDescriptorGroup(old_group, 0)
-
-win32security.SetFileSecurity(fname, all_security_info, new_sd)
diff --git a/lib/win32/Demos/security/set_policy_info.py b/lib/win32/Demos/security/set_policy_info.py
deleted file mode 100644
index 5dd3cf81..00000000
--- a/lib/win32/Demos/security/set_policy_info.py
+++ /dev/null
@@ -1,28 +0,0 @@
-import ntsecuritycon
-import win32api
-import win32file
-import win32security
-
-policy_handle = win32security.GetPolicyHandle("rupole", win32security.POLICY_ALL_ACCESS)
-
-event_audit_info = win32security.LsaQueryInformationPolicy(
-    policy_handle, win32security.PolicyAuditEventsInformation
-)
-print(event_audit_info)
-
-new_audit_info = list(event_audit_info[1])
-new_audit_info[win32security.AuditCategoryPolicyChange] = (
-    win32security.POLICY_AUDIT_EVENT_SUCCESS | win32security.POLICY_AUDIT_EVENT_FAILURE
-)
-new_audit_info[win32security.AuditCategoryAccountLogon] = (
-    win32security.POLICY_AUDIT_EVENT_SUCCESS | win32security.POLICY_AUDIT_EVENT_FAILURE
-)
-new_audit_info[win32security.AuditCategoryLogon] = (
-    win32security.POLICY_AUDIT_EVENT_SUCCESS | win32security.POLICY_AUDIT_EVENT_FAILURE
-)
-
-win32security.LsaSetInformationPolicy(
-    policy_handle, win32security.PolicyAuditEventsInformation, (1, new_audit_info)
-)
-
-win32security.LsaClose(policy_handle)
diff --git a/lib/win32/Demos/security/setkernelobjectsecurity.py b/lib/win32/Demos/security/setkernelobjectsecurity.py
deleted file mode 100644
index 34c8f446..00000000
--- a/lib/win32/Demos/security/setkernelobjectsecurity.py
+++ /dev/null
@@ -1,135 +0,0 @@
-import win32api
-import win32con
-import win32process
-import win32security
-
-## You need SE_RESTORE_NAME to be able to set the owner of a security descriptor to anybody
-## other than yourself or your primary group.  Most admin logins don't have it by default, so
-## enabling it may fail
-new_privs = (
-    (
-        win32security.LookupPrivilegeValue("", win32security.SE_SECURITY_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", win32security.SE_TCB_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", win32security.SE_SHUTDOWN_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", win32security.SE_RESTORE_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", win32security.SE_TAKE_OWNERSHIP_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", win32security.SE_CREATE_PERMANENT_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", win32security.SE_ENABLE_DELEGATION_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", win32security.SE_CHANGE_NOTIFY_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", win32security.SE_DEBUG_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue(
-            "", win32security.SE_PROF_SINGLE_PROCESS_NAME
-        ),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", win32security.SE_SYSTEM_PROFILE_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", win32security.SE_LOCK_MEMORY_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-)
-
-all_info = (
-    win32security.OWNER_SECURITY_INFORMATION
-    | win32security.GROUP_SECURITY_INFORMATION
-    | win32security.DACL_SECURITY_INFORMATION
-    | win32security.SACL_SECURITY_INFORMATION
-)
-
-pid = win32api.GetCurrentProcessId()
-ph = win32api.OpenProcess(win32con.PROCESS_ALL_ACCESS, 0, pid)
-## PROCESS_ALL_ACCESS does not contain ACCESS_SYSTEM_SECURITY (neccessy to do SACLs)
-th = win32security.OpenProcessToken(
-    ph, win32security.TOKEN_ALL_ACCESS
-)  ##win32con.TOKEN_ADJUST_PRIVILEGES)
-old_privs = win32security.GetTokenInformation(th, win32security.TokenPrivileges)
-desired_privs = tuple((e[0], win32con.SE_PRIVILEGE_ENABLED) for e in old_privs)
-modified_privs = win32security.AdjustTokenPrivileges(
-    th, 0, desired_privs
-)  # Will (partially) fail for new_privs (unless they are a subset of current ones)
-gle = win32api.GetLastError()
-if gle != 0:
-    print("AdjustTokenPrivileges error:", gle)
-# print(modified_privs)
-my_sid = win32security.GetTokenInformation(th, win32security.TokenUser)[0]
-pwr_sid = win32security.LookupAccountName("", "Power Users")[0]
-## reopen process with ACCESS_SYSTEM_SECURITY now that sufficent privs are enabled
-ph = win32api.OpenProcess(
-    win32con.PROCESS_ALL_ACCESS | win32con.ACCESS_SYSTEM_SECURITY, 0, pid
-)
-
-sd = win32security.GetKernelObjectSecurity(ph, all_info)
-dacl = sd.GetSecurityDescriptorDacl()
-if dacl is None:
-    dacl = win32security.ACL()
-sacl = sd.GetSecurityDescriptorSacl()
-if sacl is None:
-    sacl = win32security.ACL()
-
-dacl_ace_cnt = dacl.GetAceCount()
-sacl_ace_cnt = sacl.GetAceCount()
-
-dacl.AddAccessAllowedAce(
-    dacl.GetAclRevision(), win32con.ACCESS_SYSTEM_SECURITY | win32con.WRITE_DAC, my_sid
-)
-sacl.AddAuditAccessAce(sacl.GetAclRevision(), win32con.GENERIC_ALL, my_sid, 1, 1)
-sd.SetSecurityDescriptorDacl(1, dacl, 0)
-sd.SetSecurityDescriptorSacl(1, sacl, 0)
-sd.SetSecurityDescriptorGroup(pwr_sid, 0)
-sd.SetSecurityDescriptorOwner(pwr_sid, 0)
-
-win32security.SetKernelObjectSecurity(ph, all_info, sd)
-new_sd = win32security.GetKernelObjectSecurity(ph, all_info)
-
-if new_sd.GetSecurityDescriptorDacl().GetAceCount() != dacl_ace_cnt + 1:
-    print("New dacl doesn" "t contain extra ace ????")
-if new_sd.GetSecurityDescriptorSacl().GetAceCount() != sacl_ace_cnt + 1:
-    print("New Sacl doesn" "t contain extra ace ????")
-if (
-    win32security.LookupAccountSid("", new_sd.GetSecurityDescriptorOwner())[0]
-    != "Power Users"
-):
-    print("Owner not successfully set to Power Users !!!!!")
-if (
-    win32security.LookupAccountSid("", new_sd.GetSecurityDescriptorGroup())[0]
-    != "Power Users"
-):
-    print("Group not successfully set to Power Users !!!!!")
-
-sd.SetSecurityDescriptorSacl(0, None, 0)
-win32security.SetKernelObjectSecurity(ph, win32security.SACL_SECURITY_INFORMATION, sd)
-new_sd_1 = win32security.GetKernelObjectSecurity(
-    ph, win32security.SACL_SECURITY_INFORMATION
-)
-if new_sd_1.GetSecurityDescriptorSacl() is not None:
-    print("Unable to set Sacl to NULL !!!!!!!!")
diff --git a/lib/win32/Demos/security/setnamedsecurityinfo.py b/lib/win32/Demos/security/setnamedsecurityinfo.py
deleted file mode 100644
index 8915a0df..00000000
--- a/lib/win32/Demos/security/setnamedsecurityinfo.py
+++ /dev/null
@@ -1,131 +0,0 @@
-import win32api
-import win32con
-import win32process
-import win32security
-
-fname, tmp = win32api.GetTempFileName(win32api.GetTempPath(), "tmp")
-print(fname)
-## You need SE_RESTORE_NAME to be able to set the owner of a security descriptor to anybody
-## other than yourself or your primary group.  Most admin logins don't have it by default, so
-## enabling it may fail
-new_privs = (
-    (
-        win32security.LookupPrivilegeValue("", win32security.SE_SECURITY_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", win32security.SE_TCB_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", win32security.SE_SHUTDOWN_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", win32security.SE_RESTORE_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", win32security.SE_TAKE_OWNERSHIP_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", win32security.SE_CREATE_PERMANENT_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", win32security.SE_ENABLE_DELEGATION_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", win32security.SE_CHANGE_NOTIFY_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", win32security.SE_DEBUG_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue(
-            "", win32security.SE_PROF_SINGLE_PROCESS_NAME
-        ),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", win32security.SE_SYSTEM_PROFILE_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", win32security.SE_LOCK_MEMORY_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-)
-
-all_info = (
-    win32security.OWNER_SECURITY_INFORMATION
-    | win32security.GROUP_SECURITY_INFORMATION
-    | win32security.DACL_SECURITY_INFORMATION
-    | win32security.SACL_SECURITY_INFORMATION
-)
-
-ph = win32process.GetCurrentProcess()
-th = win32security.OpenProcessToken(
-    ph, win32security.TOKEN_ALL_ACCESS
-)  ##win32con.TOKEN_ADJUST_PRIVILEGES)
-win32security.AdjustTokenPrivileges(th, 0, new_privs)
-my_sid = win32security.GetTokenInformation(th, win32security.TokenUser)[0]
-pwr_sid = win32security.LookupAccountName("", "Power Users")[0]
-
-sd = win32security.GetNamedSecurityInfo(fname, win32security.SE_FILE_OBJECT, all_info)
-dacl = sd.GetSecurityDescriptorDacl()
-if dacl is None:
-    dacl = win32security.ACL()
-sacl = sd.GetSecurityDescriptorSacl()
-if sacl is None:
-    sacl = win32security.ACL()
-
-dacl_ace_cnt = dacl.GetAceCount()
-sacl_ace_cnt = sacl.GetAceCount()
-
-dacl.AddAccessAllowedAce(
-    dacl.GetAclRevision(), win32con.ACCESS_SYSTEM_SECURITY | win32con.WRITE_DAC, my_sid
-)
-sacl.AddAuditAccessAce(sacl.GetAclRevision(), win32con.GENERIC_ALL, my_sid, 1, 1)
-
-win32security.SetNamedSecurityInfo(
-    fname, win32security.SE_FILE_OBJECT, all_info, pwr_sid, pwr_sid, dacl, sacl
-)
-new_sd = win32security.GetNamedSecurityInfo(
-    fname, win32security.SE_FILE_OBJECT, all_info
-)
-
-## could do additional checking to make sure added ACE contains expected info
-if new_sd.GetSecurityDescriptorDacl().GetAceCount() != dacl_ace_cnt + 1:
-    print("New dacl doesn" "t contain extra ace ????")
-if new_sd.GetSecurityDescriptorSacl().GetAceCount() != sacl_ace_cnt + 1:
-    print("New Sacl doesn" "t contain extra ace ????")
-if (
-    win32security.LookupAccountSid("", new_sd.GetSecurityDescriptorOwner())[0]
-    != "Power Users"
-):
-    print("Owner not successfully set to Power Users !!!!!")
-if (
-    win32security.LookupAccountSid("", new_sd.GetSecurityDescriptorGroup())[0]
-    != "Power Users"
-):
-    print("Group not successfully set to Power Users !!!!!")
-
-win32security.SetNamedSecurityInfo(
-    fname,
-    win32security.SE_FILE_OBJECT,
-    win32security.SACL_SECURITY_INFORMATION,
-    None,
-    None,
-    None,
-    None,
-)
-new_sd_1 = win32security.GetNamedSecurityInfo(
-    fname, win32security.SE_FILE_OBJECT, win32security.SACL_SECURITY_INFORMATION
-)
-if new_sd_1.GetSecurityDescriptorSacl() is not None:
-    print("Unable to set Sacl to NULL !!!!!!!!")
diff --git a/lib/win32/Demos/security/setsecurityinfo.py b/lib/win32/Demos/security/setsecurityinfo.py
deleted file mode 100644
index d784d950..00000000
--- a/lib/win32/Demos/security/setsecurityinfo.py
+++ /dev/null
@@ -1,132 +0,0 @@
-import win32api
-import win32con
-import win32process
-import win32security
-
-## You need SE_RESTORE_NAME to be able to set the owner of a security descriptor to anybody
-## other than yourself or your primary group.  Most admin logins don't have it by default, so
-## enabling it may fail
-new_privs = (
-    (
-        win32security.LookupPrivilegeValue("", win32security.SE_SECURITY_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", win32security.SE_TCB_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", win32security.SE_SHUTDOWN_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", win32security.SE_RESTORE_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", win32security.SE_TAKE_OWNERSHIP_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", win32security.SE_CREATE_PERMANENT_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", win32security.SE_ENABLE_DELEGATION_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", win32security.SE_CHANGE_NOTIFY_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", win32security.SE_DEBUG_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue(
-            "", win32security.SE_PROF_SINGLE_PROCESS_NAME
-        ),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", win32security.SE_SYSTEM_PROFILE_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", win32security.SE_LOCK_MEMORY_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-)
-
-all_info = (
-    win32security.OWNER_SECURITY_INFORMATION
-    | win32security.GROUP_SECURITY_INFORMATION
-    | win32security.DACL_SECURITY_INFORMATION
-    | win32security.SACL_SECURITY_INFORMATION
-)
-
-pid = win32api.GetCurrentProcessId()
-ph = win32api.OpenProcess(win32con.PROCESS_ALL_ACCESS, 0, pid)
-## PROCESS_ALL_ACCESS does not contain ACCESS_SYSTEM_SECURITY (neccessy to do SACLs)
-th = win32security.OpenProcessToken(
-    ph, win32security.TOKEN_ALL_ACCESS
-)  ##win32con.TOKEN_ADJUST_PRIVILEGES)
-old_privs = win32security.AdjustTokenPrivileges(th, 0, new_privs)
-my_sid = win32security.GetTokenInformation(th, win32security.TokenUser)[0]
-pwr_sid = win32security.LookupAccountName("", "Power Users")[0]
-## reopen process with ACCESS_SYSTEM_SECURITY now that sufficent privs are enabled
-ph = win32api.OpenProcess(
-    win32con.PROCESS_ALL_ACCESS | win32con.ACCESS_SYSTEM_SECURITY, 0, pid
-)
-
-sd = win32security.GetSecurityInfo(ph, win32security.SE_KERNEL_OBJECT, all_info)
-dacl = sd.GetSecurityDescriptorDacl()
-if dacl is None:
-    dacl = win32security.ACL()
-sacl = sd.GetSecurityDescriptorSacl()
-if sacl is None:
-    sacl = win32security.ACL()
-
-dacl_ace_cnt = dacl.GetAceCount()
-sacl_ace_cnt = sacl.GetAceCount()
-
-dacl.AddAccessAllowedAce(
-    dacl.GetAclRevision(), win32con.ACCESS_SYSTEM_SECURITY | win32con.WRITE_DAC, my_sid
-)
-sacl.AddAuditAccessAce(sacl.GetAclRevision(), win32con.GENERIC_ALL, my_sid, 1, 1)
-
-win32security.SetSecurityInfo(
-    ph, win32security.SE_KERNEL_OBJECT, all_info, pwr_sid, pwr_sid, dacl, sacl
-)
-new_sd = win32security.GetSecurityInfo(ph, win32security.SE_KERNEL_OBJECT, all_info)
-
-if new_sd.GetSecurityDescriptorDacl().GetAceCount() != dacl_ace_cnt + 1:
-    print("New dacl doesn" "t contain extra ace ????")
-if new_sd.GetSecurityDescriptorSacl().GetAceCount() != sacl_ace_cnt + 1:
-    print("New Sacl doesn" "t contain extra ace ????")
-if (
-    win32security.LookupAccountSid("", new_sd.GetSecurityDescriptorOwner())[0]
-    != "Power Users"
-):
-    print("Owner not successfully set to Power Users !!!!!")
-if (
-    win32security.LookupAccountSid("", new_sd.GetSecurityDescriptorGroup())[0]
-    != "Power Users"
-):
-    print("Group not successfully set to Power Users !!!!!")
-
-win32security.SetSecurityInfo(
-    ph,
-    win32security.SE_KERNEL_OBJECT,
-    win32security.SACL_SECURITY_INFORMATION,
-    None,
-    None,
-    None,
-    None,
-)
-new_sd_1 = win32security.GetSecurityInfo(
-    ph, win32security.SE_KERNEL_OBJECT, win32security.SACL_SECURITY_INFORMATION
-)
-if new_sd_1.GetSecurityDescriptorSacl() is not None:
-    print("Unable to set Sacl to NULL !!!!!!!!")
diff --git a/lib/win32/Demos/security/setuserobjectsecurity.py b/lib/win32/Demos/security/setuserobjectsecurity.py
deleted file mode 100644
index 668571f6..00000000
--- a/lib/win32/Demos/security/setuserobjectsecurity.py
+++ /dev/null
@@ -1,103 +0,0 @@
-import win32api
-import win32con
-import win32process
-import win32security
-
-new_privs = (
-    (
-        win32security.LookupPrivilegeValue("", win32security.SE_SECURITY_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", win32security.SE_TCB_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", win32security.SE_SHUTDOWN_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", win32security.SE_RESTORE_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", win32security.SE_TAKE_OWNERSHIP_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", win32security.SE_CREATE_PERMANENT_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", win32security.SE_ENABLE_DELEGATION_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", win32security.SE_CHANGE_NOTIFY_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", win32security.SE_DEBUG_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue(
-            "", win32security.SE_PROF_SINGLE_PROCESS_NAME
-        ),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", win32security.SE_SYSTEM_PROFILE_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-    (
-        win32security.LookupPrivilegeValue("", win32security.SE_LOCK_MEMORY_NAME),
-        win32con.SE_PRIVILEGE_ENABLED,
-    ),
-)
-
-all_info = (
-    win32security.OWNER_SECURITY_INFORMATION
-    | win32security.GROUP_SECURITY_INFORMATION
-    | win32security.DACL_SECURITY_INFORMATION
-    | win32security.SACL_SECURITY_INFORMATION
-)
-info = (
-    win32security.OWNER_SECURITY_INFORMATION
-    | win32security.GROUP_SECURITY_INFORMATION
-    | win32security.DACL_SECURITY_INFORMATION
-)
-
-ph = win32process.GetCurrentProcess()
-th = win32security.OpenProcessToken(
-    ph, win32security.TOKEN_ALL_ACCESS
-)  ##win32con.TOKEN_ADJUST_PRIVILEGES)
-win32security.AdjustTokenPrivileges(th, 0, new_privs)
-my_sid = win32security.GetTokenInformation(th, win32security.TokenUser)[0]
-pwr_sid = win32security.LookupAccountName("", "Power Users")[0]
-
-h = win32process.GetProcessWindowStation()
-sd = win32security.GetUserObjectSecurity(h, info)
-dacl = sd.GetSecurityDescriptorDacl()
-ace_cnt = dacl.GetAceCount()
-
-dacl.AddAccessAllowedAce(
-    dacl.GetAclRevision(), win32con.ACCESS_SYSTEM_SECURITY | win32con.WRITE_DAC, my_sid
-)
-sd.SetSecurityDescriptorDacl(1, dacl, 0)
-sd.SetSecurityDescriptorGroup(pwr_sid, 0)
-sd.SetSecurityDescriptorOwner(pwr_sid, 0)
-
-win32security.SetUserObjectSecurity(h, info, sd)
-new_sd = win32security.GetUserObjectSecurity(h, info)
-assert (
-    new_sd.GetSecurityDescriptorDacl().GetAceCount() == ace_cnt + 1
-), "Did not add an ace to the Dacl !!!!!!"
-assert (
-    win32security.LookupAccountSid("", new_sd.GetSecurityDescriptorOwner())[0]
-    == "Power Users"
-), "Owner not successfully set to Power Users !!!!!"
-assert (
-    win32security.LookupAccountSid("", new_sd.GetSecurityDescriptorGroup())[0]
-    == "Power Users"
-), "Group not successfully set to Power Users !!!!!"
diff --git a/lib/win32/Demos/security/sspi/fetch_url.py b/lib/win32/Demos/security/sspi/fetch_url.py
deleted file mode 100644
index 3b43b7e4..00000000
--- a/lib/win32/Demos/security/sspi/fetch_url.py
+++ /dev/null
@@ -1,160 +0,0 @@
-"""
-Fetches a URL from a web-server supporting NTLM authentication
-eg, IIS.
-
-If no arguments are specified, a default of http://localhost/localstart.asp
-is used.  This script does follow simple 302 redirections, so pointing at the
-root of an IIS server is should work.
-"""
-
-import http.client  # sorry, this demo needs 2.3+
-import optparse
-import urllib.error
-import urllib.parse
-import urllib.request
-from base64 import decodestring, encodestring
-
-from sspi import ClientAuth
-
-options = None  # set to optparse options object
-
-
-def open_url(host, url):
-    h = http.client.HTTPConnection(host)
-    #    h.set_debuglevel(9)
-    h.putrequest("GET", url)
-    h.endheaders()
-    resp = h.getresponse()
-    print("Initial response is", resp.status, resp.reason)
-    body = resp.read()
-    if resp.status == 302:  # object moved
-        url = "/" + resp.msg["location"]
-        resp.close()
-        h.putrequest("GET", url)
-        h.endheaders()
-        resp = h.getresponse()
-        print("After redirect response is", resp.status, resp.reason)
-    if options.show_headers:
-        print("Initial response headers:")
-        for name, val in list(resp.msg.items()):
-            print(" %s: %s" % (name, val))
-    if options.show_body:
-        print(body)
-    if resp.status == 401:
-        # 401: Unauthorized - here is where the real work starts
-        auth_info = None
-        if options.user or options.domain or options.password:
-            auth_info = options.user, options.domain, options.password
-        ca = ClientAuth("NTLM", auth_info=auth_info)
-        auth_scheme = ca.pkg_info["Name"]
-        data = None
-        while 1:
-            err, out_buf = ca.authorize(data)
-            data = out_buf[0].Buffer
-            # Encode it as base64 as required by HTTP
-            auth = encodestring(data).replace("\012", "")
-            h.putrequest("GET", url)
-            h.putheader("Authorization", auth_scheme + " " + auth)
-            h.putheader("Content-Length", "0")
-            h.endheaders()
-            resp = h.getresponse()
-            if options.show_headers:
-                print("Token dance headers:")
-                for name, val in list(resp.msg.items()):
-                    print(" %s: %s" % (name, val))
-
-            if err == 0:
-                break
-            else:
-                if resp.status != 401:
-                    print("Eeek - got response", resp.status)
-                    cl = resp.msg.get("content-length")
-                    if cl:
-                        print(repr(resp.read(int(cl))))
-                    else:
-                        print("no content!")
-
-                assert resp.status == 401, resp.status
-
-            assert not resp.will_close, "NTLM is per-connection - must not close"
-            schemes = [
-                s.strip() for s in resp.msg.get("WWW-Authenticate", "").split(",")
-            ]
-            for scheme in schemes:
-                if scheme.startswith(auth_scheme):
-                    data = decodestring(scheme[len(auth_scheme) + 1 :])
-                    break
-            else:
-                print(
-                    "Could not find scheme '%s' in schemes %r" % (auth_scheme, schemes)
-                )
-                break
-
-            resp.read()
-    print("Final response status is", resp.status, resp.reason)
-    if resp.status == 200:
-        # Worked!
-        # Check we can read it again without re-authenticating.
-        if resp.will_close:
-            print(
-                "EEEK - response will close, but NTLM is per connection - it must stay open"
-            )
-        body = resp.read()
-        if options.show_body:
-            print("Final response body:")
-            print(body)
-        h.putrequest("GET", url)
-        h.endheaders()
-        resp = h.getresponse()
-        print("Second fetch response is", resp.status, resp.reason)
-        if options.show_headers:
-            print("Second response headers:")
-            for name, val in list(resp.msg.items()):
-                print(" %s: %s" % (name, val))
-
-        resp.read(int(resp.msg.get("content-length", 0)))
-    elif resp.status == 500:
-        print("Error text")
-        print(resp.read())
-    else:
-        if options.show_body:
-            cl = resp.msg.get("content-length")
-            print(resp.read(int(cl)))
-
-
-if __name__ == "__main__":
-    parser = optparse.OptionParser(description=__doc__)
-
-    parser.add_option(
-        "",
-        "--show-body",
-        action="store_true",
-        help="print the body of each response as it is received",
-    )
-
-    parser.add_option(
-        "",
-        "--show-headers",
-        action="store_true",
-        help="print the headers of each response as it is received",
-    )
-
-    parser.add_option("", "--user", action="store", help="The username to login with")
-
-    parser.add_option(
-        "", "--password", action="store", help="The password to login with"
-    )
-
-    parser.add_option("", "--domain", action="store", help="The domain to login to")
-
-    options, args = parser.parse_args()
-    if not args:
-        print("Run with --help for usage details")
-        args = ["http://localhost/localstart.asp"]
-    for url in args:
-        scheme, netloc, path, params, query, fragment = urllib.parse.urlparse(url)
-        if (scheme != "http") or params or query or fragment:
-            parser.error("Scheme must be http, URL must be simple")
-
-        print("Opening '%s' from '%s'" % (path, netloc))
-        r = open_url(netloc, path)
diff --git a/lib/win32/Demos/security/sspi/simple_auth.py b/lib/win32/Demos/security/sspi/simple_auth.py
deleted file mode 100644
index cc0ce5cf..00000000
--- a/lib/win32/Demos/security/sspi/simple_auth.py
+++ /dev/null
@@ -1,72 +0,0 @@
-# A demo of basic SSPI authentication.
-# There is a 'client' context and a 'server' context - typically these will
-# be on different machines (here they are in the same process, but the same
-# concepts apply)
-import sspi
-import sspicon
-import win32api
-import win32security
-
-
-def lookup_ret_code(err):
-    for k, v in list(sspicon.__dict__.items()):
-        if k[0:6] in ("SEC_I_", "SEC_E_") and v == err:
-            return k
-
-
-"""
-pkg_name='Kerberos'
-sspiclient=SSPIClient(pkg_name, win32api.GetUserName(),  ## target spn is ourself
-    None, None,   ## use none for client name and authentication information for current context
-    ## u'username', (u'username',u'domain.com',u'passwd'),
-    sspicon.ISC_REQ_INTEGRITY|sspicon.ISC_REQ_SEQUENCE_DETECT|sspicon.ISC_REQ_REPLAY_DETECT|    \
-        sspicon.ISC_REQ_DELEGATE|sspicon.ISC_REQ_CONFIDENTIALITY|sspicon.ISC_REQ_USE_SESSION_KEY)
-sspiserver=SSPIServer(pkg_name, None,
-    sspicon.ASC_REQ_INTEGRITY|sspicon.ASC_REQ_SEQUENCE_DETECT|sspicon.ASC_REQ_REPLAY_DETECT|   \
-        sspicon.ASC_REQ_DELEGATE|sspicon.ASC_REQ_CONFIDENTIALITY|sspicon.ASC_REQ_STREAM|sspicon.ASC_REQ_USE_SESSION_KEY)
-"""
-
-pkg_name = "NTLM"
-
-# Setup the 2 contexts.
-sspiclient = sspi.ClientAuth(pkg_name)
-sspiserver = sspi.ServerAuth(pkg_name)
-
-# Perform the authentication dance, each loop exchanging more information
-# on the way to completing authentication.
-sec_buffer = None
-while 1:
-    err, sec_buffer = sspiclient.authorize(sec_buffer)
-    err, sec_buffer = sspiserver.authorize(sec_buffer)
-    if err == 0:
-        break
-
-# The server can now impersonate the client.  In this demo the 2 users will
-# always be the same.
-sspiserver.ctxt.ImpersonateSecurityContext()
-print("Impersonated user: ", win32api.GetUserNameEx(win32api.NameSamCompatible))
-sspiserver.ctxt.RevertSecurityContext()
-print("Reverted to self: ", win32api.GetUserName())
-
-pkg_size_info = sspiclient.ctxt.QueryContextAttributes(sspicon.SECPKG_ATTR_SIZES)
-# Now sign some data
-msg = "some data to be encrypted ......"
-
-sigsize = pkg_size_info["MaxSignature"]
-sigbuf = win32security.PySecBufferDescType()
-sigbuf.append(win32security.PySecBufferType(len(msg), sspicon.SECBUFFER_DATA))
-sigbuf.append(win32security.PySecBufferType(sigsize, sspicon.SECBUFFER_TOKEN))
-sigbuf[0].Buffer = msg
-sspiclient.ctxt.MakeSignature(0, sigbuf, 1)
-sspiserver.ctxt.VerifySignature(sigbuf, 1)
-
-# And finally encrypt some.
-trailersize = pkg_size_info["SecurityTrailer"]
-encbuf = win32security.PySecBufferDescType()
-encbuf.append(win32security.PySecBufferType(len(msg), sspicon.SECBUFFER_DATA))
-encbuf.append(win32security.PySecBufferType(trailersize, sspicon.SECBUFFER_TOKEN))
-encbuf[0].Buffer = msg
-sspiclient.ctxt.EncryptMessage(0, encbuf, 1)
-print("Encrypted data:", repr(encbuf[0].Buffer))
-sspiserver.ctxt.DecryptMessage(encbuf, 1)
-print("Unencrypted data:", encbuf[0].Buffer)
diff --git a/lib/win32/Demos/security/sspi/socket_server.py b/lib/win32/Demos/security/sspi/socket_server.py
deleted file mode 100644
index 4d606bb8..00000000
--- a/lib/win32/Demos/security/sspi/socket_server.py
+++ /dev/null
@@ -1,201 +0,0 @@
-"""A sample socket server and client using SSPI authentication and encryption.
-
-You must run with either 'client' or 'server' as arguments.  A server must be
-running before a client can connect.
-
-To use with Kerberos you should include in the client options
---target-spn=username, where 'username' is the user under which the server is
-being run.
-
-Running either the client or server as a different user can be informative.
-A command-line such as the following may be useful:
-`runas /user:{user} {fqp}\python.exe {fqp}\socket_server.py --wait client|server`
-
-{fqp} should specify the relevant fully-qualified path names.
-
-To use 'runas' with Kerberos, the client program will need to
-specify --target-spn with the username under which the *server* is running.
-
-See the SSPI documentation for more details.
-"""
-
-
-import http.client  # sorry, this demo needs 2.3+
-import optparse
-import socketserver
-import struct
-import traceback
-
-import sspi
-import win32api
-import win32security
-
-options = None  # set to optparse object.
-
-
-def GetUserName():
-    try:
-        return win32api.GetUserName()
-    except win32api.error as details:
-        # Seeing 'access denied' errors here for non-local users (presumably
-        # without permission to login locally).  Get the fully-qualified
-        # username, although a side-effect of these permission-denied errors
-        # is a lack of Python codecs - so printing the Unicode value fails.
-        # So just return the repr(), and avoid codecs completely.
-        return repr(win32api.GetUserNameEx(win32api.NameSamCompatible))
-
-
-# Send a simple "message" over a socket - send the number of bytes first,
-# then the string.  Ditto for receive.
-def _send_msg(s, m):
-    s.send(struct.pack("i", len(m)))
-    s.send(m)
-
-
-def _get_msg(s):
-    size_data = s.recv(struct.calcsize("i"))
-    if not size_data:
-        return None
-    cb = struct.unpack("i", size_data)[0]
-    return s.recv(cb)
-
-
-class SSPISocketServer(socketserver.TCPServer):
-    def __init__(self, *args, **kw):
-        socketserver.TCPServer.__init__(self, *args, **kw)
-        self.sa = sspi.ServerAuth(options.package)
-
-    def verify_request(self, sock, ca):
-        # Do the sspi auth dance
-        self.sa.reset()
-        while 1:
-            data = _get_msg(sock)
-            if data is None:
-                return False
-            try:
-                err, sec_buffer = self.sa.authorize(data)
-            except sspi.error as details:
-                print("FAILED to authorize client:", details)
-                return False
-
-            if err == 0:
-                break
-            _send_msg(sock, sec_buffer[0].Buffer)
-        return True
-
-    def process_request(self, request, client_address):
-        # An example using the connection once it is established.
-        print("The server is running as user", GetUserName())
-        self.sa.ctxt.ImpersonateSecurityContext()
-        try:
-            print("Having conversation with client as user", GetUserName())
-            while 1:
-                # we need to grab 2 bits of data - the encrypted data, and the
-                # 'key'
-                data = _get_msg(request)
-                key = _get_msg(request)
-                if data is None or key is None:
-                    break
-                data = self.sa.decrypt(data, key)
-                print("Client sent:", repr(data))
-        finally:
-            self.sa.ctxt.RevertSecurityContext()
-        self.close_request(request)
-        print("The server is back to user", GetUserName())
-
-
-def serve():
-    s = SSPISocketServer(("localhost", options.port), None)
-    print("Running test server...")
-    s.serve_forever()
-
-
-def sspi_client():
-    c = http.client.HTTPConnection("localhost", options.port)
-    c.connect()
-    # Do the auth dance.
-    ca = sspi.ClientAuth(options.package, targetspn=options.target_spn)
-    data = None
-    while 1:
-        err, out_buf = ca.authorize(data)
-        _send_msg(c.sock, out_buf[0].Buffer)
-        if err == 0:
-            break
-        data = _get_msg(c.sock)
-    print("Auth dance complete - sending a few encryted messages")
-    # Assume out data is sensitive - encrypt the message.
-    for data in "Hello from the client".split():
-        blob, key = ca.encrypt(data)
-        _send_msg(c.sock, blob)
-        _send_msg(c.sock, key)
-    c.sock.close()
-    print("Client completed.")
-
-
-if __name__ == "__main__":
-    parser = optparse.OptionParser("%prog [options] client|server", description=__doc__)
-
-    parser.add_option(
-        "",
-        "--package",
-        action="store",
-        default="NTLM",
-        help="The SSPI package to use (eg, Kerberos) - default is NTLM",
-    )
-
-    parser.add_option(
-        "",
-        "--target-spn",
-        action="store",
-        help="""The target security provider name to use. The
-                      string contents are security-package specific.  For
-                      example, 'Kerberos' or 'Negotiate' require the server
-                      principal name (SPN) (ie, the username) of the remote
-                      process.  For NTLM this must be blank.""",
-    )
-
-    parser.add_option(
-        "",
-        "--port",
-        action="store",
-        default="8181",
-        help="The port number to use (default=8181)",
-    )
-
-    parser.add_option(
-        "",
-        "--wait",
-        action="store_true",
-        help="""Cause the program to wait for input just before
-                              terminating. Useful when using via runas to see
-                              any error messages before termination.
-                           """,
-    )
-
-    options, args = parser.parse_args()
-    try:
-        options.port = int(options.port)
-    except (ValueError, TypeError):
-        parser.error("--port must be an integer")
-
-    try:
-        try:
-            if not args:
-                args = [""]
-            if args[0] == "client":
-                sspi_client()
-            elif args[0] == "server":
-                serve()
-            else:
-                parser.error(
-                    "You must supply 'client' or 'server' - " "use --help for details"
-                )
-        except KeyboardInterrupt:
-            pass
-        except SystemExit:
-            pass
-        except:
-            traceback.print_exc()
-    finally:
-        if options.wait:
-            input("Press enter to continue")
diff --git a/lib/win32/Demos/security/sspi/validate_password.py b/lib/win32/Demos/security/sspi/validate_password.py
deleted file mode 100644
index 40b6ad5b..00000000
--- a/lib/win32/Demos/security/sspi/validate_password.py
+++ /dev/null
@@ -1,41 +0,0 @@
-# Demonstrates how to validate a password.
-# See also MSKB article Q180548
-#
-# To use with Kerberos you need to jump through the 'targetspn' hoops.
-
-import sys
-
-import win32security
-from sspi import ClientAuth, ServerAuth
-
-
-def validate(username, password, domain=""):
-    auth_info = username, domain, password
-    ca = ClientAuth("NTLM", auth_info=auth_info)
-    sa = ServerAuth("NTLM")
-
-    data = err = None
-    while err != 0:
-        err, data = ca.authorize(data)
-        err, data = sa.authorize(data)
-    # If we get here without exception, we worked!
-
-
-if __name__ == "__main__":
-    if len(sys.argv) not in [2, 3, 4]:
-        print("Usage: %s username [password [domain]]" % (__file__,))
-        sys.exit(1)
-
-    # password and domain are optional!
-    password = None
-    if len(sys.argv) >= 3:
-        password = sys.argv[2]
-    domain = ""
-    if len(sys.argv) >= 4:
-        domain = sys.argv[3]
-    try:
-        validate(sys.argv[1], password, domain)
-        print("Validated OK")
-    except win32security.error as details:
-        hr, func, msg = details
-        print("Validation failed: %s (%d)" % (msg, hr))
diff --git a/lib/win32/Demos/service/nativePipeTestService.py b/lib/win32/Demos/service/nativePipeTestService.py
deleted file mode 100644
index 4ac05eba..00000000
--- a/lib/win32/Demos/service/nativePipeTestService.py
+++ /dev/null
@@ -1,63 +0,0 @@
-# This is an example of a service hosted by python.exe rather than
-# pythonservice.exe.
-
-# Note that it is very rare that using python.exe is a better option
-# than the default pythonservice.exe - the latter has better error handling
-# so that if Python itself can't be initialized or there are very early
-# import errors, you will get error details written to the event log.  When
-# using python.exe instead, you are forced to wait for the interpreter startup
-# and imports to succeed before you are able to effectively setup your own
-# error handling.
-
-# So in short, please make sure you *really* want to do this, otherwise just
-# stick with the default.
-
-import os
-import sys
-
-import servicemanager
-import win32serviceutil
-from pipeTestService import TestPipeService
-
-
-class NativeTestPipeService(TestPipeService):
-    _svc_name_ = "PyNativePipeTestService"
-    _svc_display_name_ = "Python Native Pipe Test Service"
-    _svc_description_ = "Tests Python.exe hosted services"
-    # tell win32serviceutil we have a custom executable and custom args
-    # so registration does the right thing.
-    _exe_name_ = sys.executable
-    _exe_args_ = '"' + os.path.abspath(sys.argv[0]) + '"'
-
-
-def main():
-    if len(sys.argv) == 1:
-        # service must be starting...
-        print("service is starting...")
-        print("(execute this script with '--help' if that isn't what you want)")
-
-        # for the sake of debugging etc, we use win32traceutil to see
-        # any unhandled exceptions and print statements.
-        import win32traceutil
-
-        print("service is still starting...")
-
-        servicemanager.Initialize()
-        servicemanager.PrepareToHostSingle(NativeTestPipeService)
-        # Now ask the service manager to fire things up for us...
-        servicemanager.StartServiceCtrlDispatcher()
-        print("service done!")
-    else:
-        win32serviceutil.HandleCommandLine(NativeTestPipeService)
-
-
-if __name__ == "__main__":
-    try:
-        main()
-    except (SystemExit, KeyboardInterrupt):
-        raise
-    except:
-        print("Something went bad!")
-        import traceback
-
-        traceback.print_exc()
diff --git a/lib/win32/Demos/service/pipeTestService.py b/lib/win32/Demos/service/pipeTestService.py
deleted file mode 100644
index 2efda606..00000000
--- a/lib/win32/Demos/service/pipeTestService.py
+++ /dev/null
@@ -1,184 +0,0 @@
-# A Demo of services and named pipes.
-
-# A multi-threaded service that simply echos back its input.
-
-# * Install as a service using "pipeTestService.py install"
-# * Use Control Panel to change the user name of the service
-#   to a real user name (ie, NOT the SystemAccount)
-# * Start the service.
-# * Run the "pipeTestServiceClient.py" program as the client pipe side.
-
-import _thread
-import traceback
-
-# Old versions of the service framework would not let you import this
-# module at the top-level.  Now you can, and can check 'Debugging()' and
-# 'RunningAsService()' to check your context.
-import pywintypes
-import servicemanager
-import win32con
-import win32service
-import win32serviceutil
-import winerror
-from ntsecuritycon import *
-from win32api import *
-
-# Use "import *" to keep this looking as much as a "normal" service
-# as possible.  Real code shouldn't do this.
-from win32event import *
-from win32file import *
-from win32pipe import *
-
-
-def ApplyIgnoreError(fn, args):
-    try:
-        return fn(*args)
-    except error:  # Ignore win32api errors.
-        return None
-
-
-class TestPipeService(win32serviceutil.ServiceFramework):
-    _svc_name_ = "PyPipeTestService"
-    _svc_display_name_ = "Python Pipe Test Service"
-    _svc_description_ = "Tests Python service framework by receiving and echoing messages over a named pipe"
-
-    def __init__(self, args):
-        win32serviceutil.ServiceFramework.__init__(self, args)
-        self.hWaitStop = CreateEvent(None, 0, 0, None)
-        self.overlapped = pywintypes.OVERLAPPED()
-        self.overlapped.hEvent = CreateEvent(None, 0, 0, None)
-        self.thread_handles = []
-
-    def CreatePipeSecurityObject(self):
-        # Create a security object giving World read/write access,
-        # but only "Owner" modify access.
-        sa = pywintypes.SECURITY_ATTRIBUTES()
-        sidEveryone = pywintypes.SID()
-        sidEveryone.Initialize(SECURITY_WORLD_SID_AUTHORITY, 1)
-        sidEveryone.SetSubAuthority(0, SECURITY_WORLD_RID)
-        sidCreator = pywintypes.SID()
-        sidCreator.Initialize(SECURITY_CREATOR_SID_AUTHORITY, 1)
-        sidCreator.SetSubAuthority(0, SECURITY_CREATOR_OWNER_RID)
-
-        acl = pywintypes.ACL()
-        acl.AddAccessAllowedAce(FILE_GENERIC_READ | FILE_GENERIC_WRITE, sidEveryone)
-        acl.AddAccessAllowedAce(FILE_ALL_ACCESS, sidCreator)
-
-        sa.SetSecurityDescriptorDacl(1, acl, 0)
-        return sa
-
-    # The functions executed in their own thread to process a client request.
-    def DoProcessClient(self, pipeHandle, tid):
-        try:
-            try:
-                # Create a loop, reading large data.  If we knew the data stream was
-                # was small, a simple ReadFile would do.
-                d = "".encode("ascii")  # ensure bytes on py2k and py3k...
-                hr = winerror.ERROR_MORE_DATA
-                while hr == winerror.ERROR_MORE_DATA:
-                    hr, thisd = ReadFile(pipeHandle, 256)
-                    d = d + thisd
-                print("Read", d)
-                ok = 1
-            except error:
-                # Client disconnection - do nothing
-                ok = 0
-
-            # A secure service would handle (and ignore!) errors writing to the
-            # pipe, but for the sake of this demo we dont (if only to see what errors
-            # we can get when our clients break at strange times :-)
-            if ok:
-                msg = (
-                    "%s (on thread %d) sent me %s"
-                    % (GetNamedPipeHandleState(pipeHandle, False, True)[4], tid, d)
-                ).encode("ascii")
-                WriteFile(pipeHandle, msg)
-        finally:
-            ApplyIgnoreError(DisconnectNamedPipe, (pipeHandle,))
-            ApplyIgnoreError(CloseHandle, (pipeHandle,))
-
-    def ProcessClient(self, pipeHandle):
-        try:
-            procHandle = GetCurrentProcess()
-            th = DuplicateHandle(
-                procHandle,
-                GetCurrentThread(),
-                procHandle,
-                0,
-                0,
-                win32con.DUPLICATE_SAME_ACCESS,
-            )
-            try:
-                self.thread_handles.append(th)
-                try:
-                    return self.DoProcessClient(pipeHandle, th)
-                except:
-                    traceback.print_exc()
-            finally:
-                self.thread_handles.remove(th)
-        except:
-            traceback.print_exc()
-
-    def SvcStop(self):
-        self.ReportServiceStatus(win32service.SERVICE_STOP_PENDING)
-        SetEvent(self.hWaitStop)
-
-    def SvcDoRun(self):
-        # Write an event log record - in debug mode we will also
-        # see this message printed.
-        servicemanager.LogMsg(
-            servicemanager.EVENTLOG_INFORMATION_TYPE,
-            servicemanager.PYS_SERVICE_STARTED,
-            (self._svc_name_, ""),
-        )
-
-        num_connections = 0
-        while 1:
-            pipeHandle = CreateNamedPipe(
-                "\\\\.\\pipe\\PyPipeTest",
-                PIPE_ACCESS_DUPLEX | FILE_FLAG_OVERLAPPED,
-                PIPE_TYPE_MESSAGE | PIPE_READMODE_BYTE,
-                PIPE_UNLIMITED_INSTANCES,  # max instances
-                0,
-                0,
-                6000,
-                self.CreatePipeSecurityObject(),
-            )
-            try:
-                hr = ConnectNamedPipe(pipeHandle, self.overlapped)
-            except error as details:
-                print("Error connecting pipe!", details)
-                CloseHandle(pipeHandle)
-                break
-            if hr == winerror.ERROR_PIPE_CONNECTED:
-                # Client is already connected - signal event
-                SetEvent(self.overlapped.hEvent)
-            rc = WaitForMultipleObjects(
-                (self.hWaitStop, self.overlapped.hEvent), 0, INFINITE
-            )
-            if rc == WAIT_OBJECT_0:
-                # Stop event
-                break
-            else:
-                # Pipe event - spawn thread to deal with it.
-                _thread.start_new_thread(self.ProcessClient, (pipeHandle,))
-                num_connections = num_connections + 1
-
-        # Sleep to ensure that any new threads are in the list, and then
-        # wait for all current threads to finish.
-        # What is a better way?
-        Sleep(500)
-        while self.thread_handles:
-            self.ReportServiceStatus(win32service.SERVICE_STOP_PENDING, 5000)
-            print("Waiting for %d threads to finish..." % (len(self.thread_handles)))
-            WaitForMultipleObjects(self.thread_handles, 1, 3000)
-        # Write another event log record.
-        servicemanager.LogMsg(
-            servicemanager.EVENTLOG_INFORMATION_TYPE,
-            servicemanager.PYS_SERVICE_STOPPED,
-            (self._svc_name_, " after processing %d connections" % (num_connections,)),
-        )
-
-
-if __name__ == "__main__":
-    win32serviceutil.HandleCommandLine(TestPipeService)
diff --git a/lib/win32/Demos/service/pipeTestServiceClient.py b/lib/win32/Demos/service/pipeTestServiceClient.py
deleted file mode 100644
index 98fdb3c9..00000000
--- a/lib/win32/Demos/service/pipeTestServiceClient.py
+++ /dev/null
@@ -1,156 +0,0 @@
-# A Test Program for pipeTestService.py
-#
-# Install and start the Pipe Test service, then run this test
-# either from the same machine, or from another using the "-s" param.
-#
-# Eg: pipeTestServiceClient.py -s server_name Hi There
-# Should work.
-
-import os
-import sys
-import traceback
-
-import pywintypes
-import win32api
-import winerror
-from win32event import *
-from win32file import *
-from win32pipe import *
-
-verbose = 0
-
-# def ReadFromPipe(pipeName):
-# Could (Should?) use CallNamedPipe, but this technique allows variable size
-# messages (whereas you must supply a buffer size for CallNamedPipe!
-#       hPipe = CreateFile(pipeName, GENERIC_WRITE, 0, None, OPEN_EXISTING, FILE_ATTRIBUTE_NORMAL, 0)
-#       more = 1
-#       while more:
-#               hr = ReadFile(hPipe, 256)
-#               if hr==0:
-#                       more = 0
-#               except win32api.error (hr, fn, desc):
-#                       if hr==winerror.ERROR_MORE_DATA:
-#                               data = dat
-#
-
-
-def CallPipe(fn, args):
-    ret = None
-    retryCount = 0
-    while retryCount < 8:  # Keep looping until user cancels.
-        retryCount = retryCount + 1
-        try:
-            return fn(*args)
-        except win32api.error as exc:
-            if exc.winerror == winerror.ERROR_PIPE_BUSY:
-                win32api.Sleep(5000)
-                continue
-            else:
-                raise
-
-    raise RuntimeError("Could not make a connection to the server")
-
-
-def testClient(server, msg):
-    if verbose:
-        print("Sending", msg)
-    data = CallPipe(
-        CallNamedPipe,
-        ("\\\\%s\\pipe\\PyPipeTest" % server, msg, 256, NMPWAIT_WAIT_FOREVER),
-    )
-    if verbose:
-        print("Server sent back '%s'" % data)
-    print("Sent and received a message!")
-
-
-def testLargeMessage(server, size=4096):
-    if verbose:
-        print("Sending message of size %d" % (size))
-    msg = "*" * size
-    data = CallPipe(
-        CallNamedPipe,
-        ("\\\\%s\\pipe\\PyPipeTest" % server, msg, 512, NMPWAIT_WAIT_FOREVER),
-    )
-    if len(data) - size:
-        print("Sizes are all wrong - send %d, got back %d" % (size, len(data)))
-
-
-def stressThread(server, numMessages, wait):
-    try:
-        try:
-            for i in range(numMessages):
-                r = CallPipe(
-                    CallNamedPipe,
-                    (
-                        "\\\\%s\\pipe\\PyPipeTest" % server,
-                        "#" * 512,
-                        1024,
-                        NMPWAIT_WAIT_FOREVER,
-                    ),
-                )
-        except:
-            traceback.print_exc()
-            print("Failed after %d messages" % i)
-    finally:
-        SetEvent(wait)
-
-
-def stressTestClient(server, numThreads, numMessages):
-    import _thread
-
-    thread_waits = []
-    for t_num in range(numThreads):
-        # Note I could just wait on thread handles (after calling DuplicateHandle)
-        # See the service itself for an example of waiting for the clients...
-        wait = CreateEvent(None, 0, 0, None)
-        thread_waits.append(wait)
-        _thread.start_new_thread(stressThread, (server, numMessages, wait))
-    # Wait for all threads to finish.
-    WaitForMultipleObjects(thread_waits, 1, INFINITE)
-
-
-def main():
-    import getopt
-    import sys
-
-    server = "."
-    thread_count = 0
-    msg_count = 500
-    try:
-        opts, args = getopt.getopt(sys.argv[1:], "s:t:m:vl")
-        for o, a in opts:
-            if o == "-s":
-                server = a
-            if o == "-m":
-                msg_count = int(a)
-            if o == "-t":
-                thread_count = int(a)
-            if o == "-v":
-                global verbose
-                verbose = 1
-            if o == "-l":
-                testLargeMessage(server)
-        msg = " ".join(args).encode("mbcs")
-    except getopt.error as msg:
-        print(msg)
-        my_name = os.path.split(sys.argv[0])[1]
-        print(
-            "Usage: %s [-v] [-s server] [-t thread_count=0] [-m msg_count=500] msg ..."
-            % my_name
-        )
-        print("       -v = verbose")
-        print(
-            "       Specifying a value for -t will stress test using that many threads."
-        )
-        return
-    testClient(server, msg)
-    if thread_count > 0:
-        print(
-            "Spawning %d threads each sending %d messages..."
-            % (thread_count, msg_count)
-        )
-        stressTestClient(server, thread_count, msg_count)
-
-
-if __name__ == "__main__":
-    main()
diff --git a/lib/win32/Demos/service/serviceEvents.py b/lib/win32/Demos/service/serviceEvents.py
deleted file mode 100644
index a62784f9..00000000
--- a/lib/win32/Demos/service/serviceEvents.py
+++ /dev/null
@@ -1,98 +0,0 @@
-# A Demo of a service that takes advantage of the additional notifications
-# available in later Windows versions.
-
-# Note that all output is written as event log entries - so you must install
-# and start the service, then look at the event log for messages as events
-# are generated.
-
-# Events are generated for USB device insertion and removal, power state
-# changes and hardware profile events - so try putting your computer to
-# sleep and waking it, inserting a memory stick, etc then check the event log
-
-# Most event notification support lives around win32gui
-import servicemanager
-import win32con
-import win32event
-import win32gui
-import win32gui_struct
-import win32service
-import win32serviceutil
-
-GUID_DEVINTERFACE_USB_DEVICE = "{A5DCBF10-6530-11D2-901F-00C04FB951ED}"
-
-
-class EventDemoService(win32serviceutil.ServiceFramework):
-    _svc_name_ = "PyServiceEventDemo"
-    _svc_display_name_ = "Python Service Event Demo"
-    _svc_description_ = (
-        "Demonstrates a Python service which takes advantage of the extra notifications"
-    )
-
-    def __init__(self, args):
-        win32serviceutil.ServiceFramework.__init__(self, args)
-        self.hWaitStop = win32event.CreateEvent(None, 0, 0, None)
-        # register for a device notification - we pass our service handle
-        # instead of a window handle.
-        filter = win32gui_struct.PackDEV_BROADCAST_DEVICEINTERFACE(
-            GUID_DEVINTERFACE_USB_DEVICE
-        )
-        self.hdn = win32gui.RegisterDeviceNotification(
-            self.ssh, filter, win32con.DEVICE_NOTIFY_SERVICE_HANDLE
-        )
-
-    # Override the base class so we can accept additional events.
-    def GetAcceptedControls(self):
-        # say we accept them all.
-        rc = win32serviceutil.ServiceFramework.GetAcceptedControls(self)
-        rc |= (
-            win32service.SERVICE_ACCEPT_PARAMCHANGE
-            | win32service.SERVICE_ACCEPT_NETBINDCHANGE
-            | win32service.SERVICE_CONTROL_DEVICEEVENT
-            | win32service.SERVICE_ACCEPT_HARDWAREPROFILECHANGE
-            | win32service.SERVICE_ACCEPT_POWEREVENT
-            | win32service.SERVICE_ACCEPT_SESSIONCHANGE
-        )
-        return rc
-
-    # All extra events are sent via SvcOtherEx (SvcOther remains as a
-    # function taking only the first args for backwards compat)
-    def SvcOtherEx(self, control, event_type, data):
-        # This is only showing a few of the extra events - see the MSDN
-        # docs for "HandlerEx callback" for more info.
-        if control == win32service.SERVICE_CONTROL_DEVICEEVENT:
-            info = win32gui_struct.UnpackDEV_BROADCAST(data)
-            msg = "A device event occurred: %x - %s" % (event_type, info)
-        elif control == win32service.SERVICE_CONTROL_HARDWAREPROFILECHANGE:
-            msg = "A hardware profile changed: type=%s, data=%s" % (event_type, data)
-        elif control == win32service.SERVICE_CONTROL_POWEREVENT:
-            msg = "A power event: setting %s" % data
-        elif control == win32service.SERVICE_CONTROL_SESSIONCHANGE:
-            # data is a single elt tuple, but this could potentially grow
-            # in the future if the win32 struct does
-            msg = "Session event: type=%s, data=%s" % (event_type, data)
-        else:
-            msg = "Other event: code=%d, type=%s, data=%s" % (control, event_type, data)
-
-        servicemanager.LogMsg(
-            servicemanager.EVENTLOG_INFORMATION_TYPE,
-            0xF000,  #  generic message
-            (msg, ""),
-        )
-
-    def SvcStop(self):
-        self.ReportServiceStatus(win32service.SERVICE_STOP_PENDING)
-        win32event.SetEvent(self.hWaitStop)
-
-    def SvcDoRun(self):
-        # do nothing at all - just wait to be stopped
-        win32event.WaitForSingleObject(self.hWaitStop, win32event.INFINITE)
-        # Write a stop message.
-        servicemanager.LogMsg(
-            servicemanager.EVENTLOG_INFORMATION_TYPE,
-            servicemanager.PYS_SERVICE_STOPPED,
-            (self._svc_name_, ""),
-        )
-
-
-if __name__ == "__main__":
-    win32serviceutil.HandleCommandLine(EventDemoService)
diff --git a/lib/win32/Demos/timer_demo.py b/lib/win32/Demos/timer_demo.py
deleted file mode 100644
index 61115f06..00000000
--- a/lib/win32/Demos/timer_demo.py
+++ /dev/null
@@ -1,72 +0,0 @@
-# -*- Mode: Python; tab-width: 4 -*-
-#
-
-# This module, and the timer.pyd core timer support, were written by
-# Sam Rushing (rushing@nightmare.com)
-
-import time
-
-# Timers are based on Windows messages.  So we need
-# to do the event-loop thing!
-import timer
-import win32event
-import win32gui
-
-# glork holds a simple counter for us.
-
-
-class glork:
-    def __init__(self, delay=1000, max=10):
-        self.x = 0
-        self.max = max
-        self.id = timer.set_timer(delay, self.increment)
-        # Could use the threading module, but this is
-        # a win32 extension test after all! :-)
-        self.event = win32event.CreateEvent(None, 0, 0, None)
-
-    def increment(self, id, time):
-        print("x = %d" % self.x)
-        self.x = self.x + 1
-        # if we've reached the max count,
-        # kill off the timer.
-        if self.x > self.max:
-            # we could have used 'self.id' here, too
-            timer.kill_timer(id)
-            win32event.SetEvent(self.event)
-
-
-# create a counter that will count from '1' thru '10', incrementing
-# once a second, and then stop.
-
-
-def demo(delay=1000, stop=10):
-    g = glork(delay, stop)
-    # Timers are message based - so we need
-    # To run a message loop while waiting for our timers
-    # to expire.
-    start_time = time.time()
-    while 1:
-        # We can't simply give a timeout of 30 seconds, as
-        # we may continouusly be recieving other input messages,
-        # and therefore never expire.
-        rc = win32event.MsgWaitForMultipleObjects(
-            (g.event,),  # list of objects
-            0,  # wait all
-            500,  # timeout
-            win32event.QS_ALLEVENTS,  # type of input
-        )
-        if rc == win32event.WAIT_OBJECT_0:
-            # Event signalled.
-            break
-        elif rc == win32event.WAIT_OBJECT_0 + 1:
-            # Message waiting.
-            if win32gui.PumpWaitingMessages():
-                raise RuntimeError("We got an unexpected WM_QUIT message!")
-        else:
-            # This wait timed-out.
-            if time.time() - start_time > 30:
-                raise RuntimeError("We timed out waiting for the timers to expire!")
-
-
-if __name__ == "__main__":
-    demo()
diff --git a/lib/win32/Demos/win32clipboardDemo.py b/lib/win32/Demos/win32clipboardDemo.py
deleted file mode 100644
index 1252ff7d..00000000
--- a/lib/win32/Demos/win32clipboardDemo.py
+++ /dev/null
@@ -1,145 +0,0 @@
-# win32clipboardDemo.py
-#
-# Demo/test of the win32clipboard module.
-
-import win32con
-from pywin32_testutil import str2bytes  # py3k-friendly helper
-from win32clipboard import *
-
-if not __debug__:
-    print("WARNING: The test code in this module uses assert")
-    print("This instance of Python has asserts disabled, so many tests will be skipped")
-
-cf_names = {}
-# Build map of CF_* constants to names.
-for name, val in list(win32con.__dict__.items()):
-    if name[:3] == "CF_" and name != "CF_SCREENFONTS":  # CF_SCREEN_FONTS==CF_TEXT!?!?
-        cf_names[val] = name
-
-
-def TestEmptyClipboard():
-    OpenClipboard()
-    try:
-        EmptyClipboard()
-        assert (
-            EnumClipboardFormats(0) == 0
-        ), "Clipboard formats were available after emptying it!"
-    finally:
-        CloseClipboard()
-
-
-def TestText():
-    OpenClipboard()
-    try:
-        text = "Hello from Python"
-        text_bytes = str2bytes(text)
-        SetClipboardText(text)
-        got = GetClipboardData(win32con.CF_TEXT)
-        # CF_TEXT always gives us 'bytes' back .
-        assert got == text_bytes, "Didnt get the correct result back - '%r'." % (got,)
-    finally:
-        CloseClipboard()
-
-    OpenClipboard()
-    try:
-        # CF_UNICODE text always gives unicode objects back.
-        got = GetClipboardData(win32con.CF_UNICODETEXT)
-        assert got == text, "Didnt get the correct result back - '%r'." % (got,)
-        assert type(got) == str, "Didnt get the correct result back - '%r'." % (got,)
-
-        # CF_OEMTEXT is a bytes-based format.
-        got = GetClipboardData(win32con.CF_OEMTEXT)
-        assert got == text_bytes, "Didnt get the correct result back - '%r'." % (got,)
-
-        # Unicode tests
-        EmptyClipboard()
-        text = "Hello from Python unicode"
-        text_bytes = str2bytes(text)
-        # Now set the Unicode value
-        SetClipboardData(win32con.CF_UNICODETEXT, text)
-        # Get it in Unicode.
-        got = GetClipboardData(win32con.CF_UNICODETEXT)
-        assert got == text, "Didnt get the correct result back - '%r'." % (got,)
-        assert type(got) == str, "Didnt get the correct result back - '%r'." % (got,)
-
-        # Close and open the clipboard to ensure auto-conversions take place.
-    finally:
-        CloseClipboard()
-
-    OpenClipboard()
-    try:
-        # Make sure I can still get the text as bytes
-        got = GetClipboardData(win32con.CF_TEXT)
-        assert got == text_bytes, "Didnt get the correct result back - '%r'." % (got,)
-        # Make sure we get back the correct types.
-        got = GetClipboardData(win32con.CF_UNICODETEXT)
-        assert type(got) == str, "Didnt get the correct result back - '%r'." % (got,)
-        got = GetClipboardData(win32con.CF_OEMTEXT)
-        assert got == text_bytes, "Didnt get the correct result back - '%r'." % (got,)
-        print("Clipboard text tests worked correctly")
-    finally:
-        CloseClipboard()
-
-
-def TestClipboardEnum():
-    OpenClipboard()
-    try:
-        # Enumerate over the clipboard types
-        enum = 0
-        while 1:
-            enum = EnumClipboardFormats(enum)
-            if enum == 0:
-                break
-            assert IsClipboardFormatAvailable(
-                enum
-            ), "Have format, but clipboard says it is not available!"
-            n = cf_names.get(enum, "")
-            if not n:
-                try:
-                    n = GetClipboardFormatName(enum)
-                except error:
-                    n = "unknown (%s)" % (enum,)
-
-            print("Have format", n)
-        print("Clipboard enumerator tests worked correctly")
-    finally:
-        CloseClipboard()
-
-
-class Foo:
-    def __init__(self, **kw):
-        self.__dict__.update(kw)
-
-    def __cmp__(self, other):
-        return cmp(self.__dict__, other.__dict__)
-
-    def __eq__(self, other):
-        return self.__dict__ == other.__dict__
-
-
-def TestCustomFormat():
-    OpenClipboard()
-    try:
-        # Just for the fun of it pickle Python objects through the clipboard
-        fmt = RegisterClipboardFormat("Python Pickle Format")
-        import pickle
-
-        pickled_object = Foo(a=1, b=2, Hi=3)
-        SetClipboardData(fmt, pickle.dumps(pickled_object))
-        # Now read it back.
-        data = GetClipboardData(fmt)
-        loaded_object = pickle.loads(data)
-        assert pickle.loads(data) == pickled_object, "Didnt get the correct data!"
-
-        print("Clipboard custom format tests worked correctly")
-    finally:
-        CloseClipboard()
-
-
-if __name__ == "__main__":
-    TestEmptyClipboard()
-    TestText()
-    TestCustomFormat()
-    TestClipboardEnum()
-    # And leave it empty at the end!
-    TestEmptyClipboard()
diff --git a/lib/win32/Demos/win32clipboard_bitmapdemo.py b/lib/win32/Demos/win32clipboard_bitmapdemo.py
deleted file mode 100644
index 7d453025..00000000
--- a/lib/win32/Demos/win32clipboard_bitmapdemo.py
+++ /dev/null
@@ -1,117 +0,0 @@
-import win32api
-import win32clipboard
-import win32con
-import win32gui
-
-
-class ViewerWindow:
-    def __init__(self):
-        self.hwndNextViewer = None
-
-    def OnPaint(self, hwnd, msg, wp, lp):
-        dc, ps = win32gui.BeginPaint(hwnd)
-        wndrect = win32gui.GetClientRect(hwnd)
-        wndwidth = wndrect[2] - wndrect[0]
-        wndheight = wndrect[3] - wndrect[1]
-        win32clipboard.OpenClipboard()
-        try:
-            try:
-                hbitmap = win32clipboard.GetClipboardData(win32clipboard.CF_BITMAP)
-            except TypeError:
-                font = win32gui.LOGFONT()
-                font.lfHeight = 15  # int(wndheight/20)
-                font.lfWidth = 15  # font.lfHeight
-                #            font.lfWeight=150
-                hf = win32gui.CreateFontIndirect(font)
-                win32gui.SelectObject(dc, hf)
-                win32gui.SetBkMode(dc, win32con.TRANSPARENT)
-                win32gui.SetTextColor(dc, win32api.RGB(0, 0, 0))
-                win32gui.DrawText(
-                    dc,
-                    "No bitmaps are in the clipboard\n(try pressing the PrtScn button)",
-                    -1,
-                    (0, 0, wndwidth, wndheight),
-                    win32con.DT_CENTER,
-                )
-            else:
-                bminfo = win32gui.GetObject(hbitmap)
-                dcDC = win32gui.CreateCompatibleDC(None)
-                win32gui.SelectObject(dcDC, hbitmap)
-                win32gui.StretchBlt(
-                    dc,
-                    0,
-                    0,
-                    wndwidth,
-                    wndheight,
-                    dcDC,
-                    0,
-                    0,
-                    bminfo.bmWidth,
-                    bminfo.bmHeight,
-                    win32con.SRCCOPY,
-                )
-                win32gui.DeleteDC(dcDC)
-                win32gui.EndPaint(hwnd, ps)
-        finally:
-            win32clipboard.CloseClipboard()
-        return 0
-
-    def OnDrawClipboard(self, hwnd, msg, wp, lp):
-        win32gui.InvalidateRect(hwnd, None, True)
-
-    def OnChangeCBChain(self, hwnd, msg, wp, lp):
-        # If the next window is closing, repair the chain.
-        if wp == self.hwndNextViewer:
-            self.hwndNextViewer = lp
-        # Otherwise, pass the message to the next link.
-        elif self.hwndNextViewer:
-            win32gui.SendMessage(self.hwndNextViewer, msg, wp, lp)
-
-    def OnCreate(self, hwnd, msg, wp, lp):
-        self.hwndNextViewer = win32gui.SetClipboardViewer(hwnd)
-
-    def OnClose(self, hwnd, msg, wp, lp):
-        win32clipboard.ChangeClipboardChain(hwnd, self.hwndNextViewer)
-        win32gui.DestroyWindow(hwnd)
-        win32gui.PostQuitMessage(0)
-
-    def go(self):
-        wndproc = {
-            win32con.WM_PAINT: self.OnPaint,
-            win32con.WM_CLOSE: self.OnClose,
-            win32con.WM_CREATE: self.OnCreate,
-            win32con.WM_DRAWCLIPBOARD: self.OnDrawClipboard,
-            win32con.WM_CHANGECBCHAIN: self.OnChangeCBChain,
-        }
-
-        wc = win32gui.WNDCLASS()
-        wc.lpszClassName = "test_win32clipboard_bmp"
-        wc.style = win32con.CS_GLOBALCLASS | win32con.CS_VREDRAW | win32con.CS_HREDRAW
-        wc.hbrBackground = win32con.COLOR_WINDOW + 1
-        wc.lpfnWndProc = wndproc
-        class_atom = win32gui.RegisterClass(wc)
-        hwnd = win32gui.CreateWindowEx(
-            0,
-            class_atom,
-            "ClipboardViewer",
-            win32con.WS_CAPTION
-            | win32con.WS_VISIBLE
-            | win32con.WS_THICKFRAME
-            | win32con.WS_SYSMENU,
-            100,
-            100,
-            900,
-            900,
-            0,
-            0,
-            0,
-            None,
-        )
-        win32clipboard.SetClipboardViewer(hwnd)
-        win32gui.PumpMessages()
-        win32gui.UnregisterClass(class_atom, None)
-
-
-if __name__ == "__main__":
-    w = ViewerWindow()
-    w.go()
diff --git a/lib/win32/Demos/win32comport_demo.py b/lib/win32/Demos/win32comport_demo.py
deleted file mode 100644
index c0be2391..00000000
--- a/lib/win32/Demos/win32comport_demo.py
+++ /dev/null
@@ -1,144 +0,0 @@
-# This is a simple serial port terminal demo.
-#
-# Its primary purpose is to demonstrate the native serial port access offered via
-# win32file.
-
-# It uses 3 threads:
-# - The main thread, which cranks up the other 2 threads, then simply waits for them to exit.
-# - The user-input thread - blocks waiting for a keyboard character, and when found sends it
-#   out the COM port.  If the character is Ctrl+C, it stops, signalling the COM port thread to stop.
-# - The COM port thread is simply listening for input on the COM port, and prints it to the screen.
-
-# This demo uses userlapped IO, so that none of the read or write operations actually block (however,
-# in this sample, the very next thing we do _is_ block - so it shows off the concepts even though it
-# doesnt exploit them.
-
-import msvcrt  # For the getch() function.
-import sys
-import threading
-
-import win32con  # constants.
-from win32event import *  # We use events and the WaitFor[Multiple]Objects functions.
-from win32file import *  # The base COM port and file IO functions.
-
-
-def FindModem():
-    # Snoop over the comports, seeing if it is likely we have a modem.
-    for i in range(1, 5):
-        port = "COM%d" % (i,)
-        try:
-            handle = CreateFile(
-                port,
-                win32con.GENERIC_READ | win32con.GENERIC_WRITE,
-                0,  # exclusive access
-                None,  # no security
-                win32con.OPEN_EXISTING,
-                win32con.FILE_ATTRIBUTE_NORMAL,
-                None,
-            )
-            # It appears that an available COM port will always success here,
-            # just return 0 for the status flags.  We only care that it has _any_ status
-            # flags (and therefore probably a real modem)
-            if GetCommModemStatus(handle) != 0:
-                return port
-        except error:
-            pass  # No port, or modem status failed.
-    return None
-
-
-# A basic synchronous COM port file-like object
-class SerialTTY:
-    def __init__(self, port):
-        if type(port) == type(0):
-            port = "COM%d" % (port,)
-        self.handle = CreateFile(
-            port,
-            win32con.GENERIC_READ | win32con.GENERIC_WRITE,
-            0,  # exclusive access
-            None,  # no security
-            win32con.OPEN_EXISTING,
-            win32con.FILE_ATTRIBUTE_NORMAL | win32con.FILE_FLAG_OVERLAPPED,
-            None,
-        )
-        # Tell the port we want a notification on each char.
-        SetCommMask(self.handle, EV_RXCHAR)
-        # Setup a 4k buffer
-        SetupComm(self.handle, 4096, 4096)
-        # Remove anything that was there
-        PurgeComm(
-            self.handle, PURGE_TXABORT | PURGE_RXABORT | PURGE_TXCLEAR | PURGE_RXCLEAR
-        )
-        # Setup for overlapped IO.
-        timeouts = 0xFFFFFFFF, 0, 1000, 0, 1000
-        SetCommTimeouts(self.handle, timeouts)
-        # Setup the connection info.
-        dcb = GetCommState(self.handle)
-        dcb.BaudRate = CBR_115200
-        dcb.ByteSize = 8
-        dcb.Parity = NOPARITY
-        dcb.StopBits = ONESTOPBIT
-        SetCommState(self.handle, dcb)
-        print("Connected to %s at %s baud" % (port, dcb.BaudRate))
-
-    def _UserInputReaderThread(self):
-        overlapped = OVERLAPPED()
-        overlapped.hEvent = CreateEvent(None, 1, 0, None)
-        try:
-            while 1:
-                ch = msvcrt.getch()
-                if ord(ch) == 3:
-                    break
-                WriteFile(self.handle, ch, overlapped)
-                # Wait for the write to complete.
-                WaitForSingleObject(overlapped.hEvent, INFINITE)
-        finally:
-            SetEvent(self.eventStop)
-
-    def _ComPortThread(self):
-        overlapped = OVERLAPPED()
-        overlapped.hEvent = CreateEvent(None, 1, 0, None)
-        while 1:
-            # XXX - note we could _probably_ just use overlapped IO on the win32file.ReadFile() statement
-            # XXX but this tests the COM stuff!
-            rc, mask = WaitCommEvent(self.handle, overlapped)
-            if rc == 0:  # Character already ready!
-                SetEvent(overlapped.hEvent)
-            rc = WaitForMultipleObjects(
-                [overlapped.hEvent, self.eventStop], 0, INFINITE
-            )
-            if rc == WAIT_OBJECT_0:
-                # Some input - read and print it
-                flags, comstat = ClearCommError(self.handle)
-                rc, data = ReadFile(self.handle, comstat.cbInQue, overlapped)
-                WaitForSingleObject(overlapped.hEvent, INFINITE)
-                sys.stdout.write(data)
-            else:
-                # Stop the thread!
-                # Just incase the user input thread uis still going, close it
-                sys.stdout.close()
-                break
-
-    def Run(self):
-        self.eventStop = CreateEvent(None, 0, 0, None)
-        # Start the reader and writer threads.
-        user_thread = threading.Thread(target=self._UserInputReaderThread)
-        user_thread.start()
-        com_thread = threading.Thread(target=self._ComPortThread)
-        com_thread.start()
-        user_thread.join()
-        com_thread.join()
-
-
-if __name__ == "__main__":
-    print("Serial port terminal demo - press Ctrl+C to exit")
-    if len(sys.argv) <= 1:
-        port = FindModem()
-        if port is None:
-            print("No COM port specified, and no modem could be found")
-            print("Please re-run this script with the name of a COM port (eg COM3)")
-            sys.exit(1)
-    else:
-        port = sys.argv[1]
-
-    tty = SerialTTY(port)
-    tty.Run()
diff --git a/lib/win32/Demos/win32console_demo.py b/lib/win32/Demos/win32console_demo.py
deleted file mode 100644
index bb9162bf..00000000
--- a/lib/win32/Demos/win32console_demo.py
+++ /dev/null
@@ -1,135 +0,0 @@
-import time
-
-import win32con
-import win32console
-
-virtual_keys = {}
-for k, v in list(win32con.__dict__.items()):
-    if k.startswith("VK_"):
-        virtual_keys[v] = k
-
-free_console = True
-try:
-    win32console.AllocConsole()
-except win32console.error as exc:
-    if exc.winerror != 5:
-        raise
-    ## only free console if one was created successfully
-    free_console = False
-
-stdout = win32console.GetStdHandle(win32console.STD_OUTPUT_HANDLE)
-stdin = win32console.GetStdHandle(win32console.STD_INPUT_HANDLE)
-newbuffer = win32console.CreateConsoleScreenBuffer()
-newbuffer.SetConsoleActiveScreenBuffer()
-newbuffer.SetConsoleTextAttribute(
-    win32console.FOREGROUND_RED
-    | win32console.FOREGROUND_INTENSITY
-    | win32console.BACKGROUND_GREEN
-    | win32console.BACKGROUND_INTENSITY
-)
-newbuffer.WriteConsole("This is a new screen buffer\n")
-
-## test setting screen buffer and window size
-## screen buffer size cannot be smaller than window size
-window_size = newbuffer.GetConsoleScreenBufferInfo()["Window"]
-coord = win32console.PyCOORDType(X=window_size.Right + 20, Y=window_size.Bottom + 20)
-newbuffer.SetConsoleScreenBufferSize(coord)
-
-window_size.Right += 10
-window_size.Bottom += 10
-newbuffer.SetConsoleWindowInfo(Absolute=True, ConsoleWindow=window_size)
-
-## write some records to the input queue
-x = win32console.PyINPUT_RECORDType(win32console.KEY_EVENT)
-x.Char = "X"
-x.KeyDown = True
-x.RepeatCount = 1
-x.VirtualKeyCode = 0x58
-x.ControlKeyState = win32con.SHIFT_PRESSED
-
-z = win32console.PyINPUT_RECORDType(win32console.KEY_EVENT)
-z.Char = "Z"
-z.KeyDown = True
-z.RepeatCount = 1
-z.VirtualKeyCode = 0x5A
-z.ControlKeyState = win32con.SHIFT_PRESSED
-
-stdin.WriteConsoleInput([x, z, x])
-
-newbuffer.SetConsoleTextAttribute(
-    win32console.FOREGROUND_RED
-    | win32console.FOREGROUND_INTENSITY
-    | win32console.BACKGROUND_GREEN
-    | win32console.BACKGROUND_INTENSITY
-)
-newbuffer.WriteConsole("Press some keys, click some characters with the mouse\n")
-
-newbuffer.SetConsoleTextAttribute(
-    win32console.FOREGROUND_BLUE
-    | win32console.FOREGROUND_INTENSITY
-    | win32console.BACKGROUND_RED
-    | win32console.BACKGROUND_INTENSITY
-)
-newbuffer.WriteConsole('Hit "End" key to quit\n')
-
-breakout = False
-while not breakout:
-    input_records = stdin.ReadConsoleInput(10)
-    for input_record in input_records:
-        if input_record.EventType == win32console.KEY_EVENT:
-            if input_record.KeyDown:
-                if input_record.Char == "\0":
-                    newbuffer.WriteConsole(
-                        virtual_keys.get(
-                            input_record.VirtualKeyCode,
-                            "VirtualKeyCode: %s" % input_record.VirtualKeyCode,
-                        )
-                    )
-                else:
-                    newbuffer.WriteConsole(input_record.Char)
-                if input_record.VirtualKeyCode == win32con.VK_END:
-                    breakout = True
-                    break
-        elif input_record.EventType == win32console.MOUSE_EVENT:
-            if input_record.EventFlags == 0:  ## 0 indicates a button event
-                if input_record.ButtonState != 0:  ## exclude button releases
-                    pos = input_record.MousePosition
-                    # switch the foreground and background colors of the character that was clicked
-                    attr = newbuffer.ReadConsoleOutputAttribute(
-                        Length=1, ReadCoord=pos
-                    )[0]
-                    new_attr = attr
-                    if attr & win32console.FOREGROUND_BLUE:
-                        new_attr = (
-                            new_attr & ~win32console.FOREGROUND_BLUE
-                        ) | win32console.BACKGROUND_BLUE
-                    if attr & win32console.FOREGROUND_RED:
-                        new_attr = (
-                            new_attr & ~win32console.FOREGROUND_RED
-                        ) | win32console.BACKGROUND_RED
-                    if attr & win32console.FOREGROUND_GREEN:
-                        new_attr = (
-                            new_attr & ~win32console.FOREGROUND_GREEN
-                        ) | win32console.BACKGROUND_GREEN
-
-                    if attr & win32console.BACKGROUND_BLUE:
-                        new_attr = (
-                            new_attr & ~win32console.BACKGROUND_BLUE
-                        ) | win32console.FOREGROUND_BLUE
-                    if attr & win32console.BACKGROUND_RED:
-                        new_attr = (
-                            new_attr & ~win32console.BACKGROUND_RED
-                        ) | win32console.FOREGROUND_RED
-                    if attr & win32console.BACKGROUND_GREEN:
-                        new_attr = (
-                            new_attr & ~win32console.BACKGROUND_GREEN
-                        ) | win32console.FOREGROUND_GREEN
-                    newbuffer.WriteConsoleOutputAttribute((new_attr,), pos)
-        else:
-            newbuffer.WriteConsole(str(input_record))
-    time.sleep(0.1)
-
-stdout.SetConsoleActiveScreenBuffer()
-newbuffer.Close()
-if free_console:
-    win32console.FreeConsole()
diff --git a/lib/win32/Demos/win32cred_demo.py b/lib/win32/Demos/win32cred_demo.py
deleted file mode 100644
index 3b49ca7c..00000000
--- a/lib/win32/Demos/win32cred_demo.py
+++ /dev/null
@@ -1,82 +0,0 @@
-"""
-Demonstrates prompting for credentials, saving, and loggging on with marshalled credential.
-Also shows how to load user's profile
-"""
-
-import win32api
-import win32con
-import win32cred
-import win32net
-import win32profile
-import win32security
-
-## Prompt for a username/pwd for local computer
-uiinfo = {
-    "MessageText": "Enter credentials for local machine",
-    "CaptionText": "win32cred_demo.py",
-}
-target, pwd, save = win32cred.CredUIPromptForCredentials(
-    TargetName=win32api.GetComputerName(),
-    AuthError=0,
-    Flags=win32cred.CREDUI_FLAGS_DO_NOT_PERSIST
-    | win32cred.CREDUI_FLAGS_SHOW_SAVE_CHECK_BOX,
-    Save=False,
-    UiInfo=uiinfo,
-)
-
-attrs = [
-    {"Keyword": "attr1", "Flags": 0, "Value": "unicode data"},
-    {"Keyword": "attr2", "Flags": 0, "Value": b"character data"},
-]
-cred = {
-    "Comment": "Created by win32cred_demo.py",
-    "UserName": target,
-    "TargetAlias": None,
-    "TargetName": target,
-    "CredentialBlob": pwd,
-    "Flags": win32cred.CRED_FLAGS_USERNAME_TARGET,
-    "Persist": win32cred.CRED_PERSIST_ENTERPRISE,
-    "Type": win32cred.CRED_TYPE_DOMAIN_PASSWORD,
-    "Attributes": attrs,
-}
-win32cred.CredWrite(cred)
-pwd = None
-print(win32cred.CredRead(target, win32cred.CRED_TYPE_DOMAIN_PASSWORD))
-
-## Marshal saved credential and use it to log on
-mc = win32cred.CredMarshalCredential(win32cred.UsernameTargetCredential, target)
-
-# As of pywin32 301 this no longer works for markh and unclear when it stopped, or
-# even if it ever did! # Fails in Python 2.7 too, so not a 3.x regression.
-try:
-    th = win32security.LogonUser(
-        mc,
-        None,
-        "",
-        win32con.LOGON32_LOGON_INTERACTIVE,
-        win32con.LOGON32_PROVIDER_DEFAULT,
-    )
-    win32security.ImpersonateLoggedOnUser(th)
-    print("GetUserName:", win32api.GetUserName())
-    win32security.RevertToSelf()
-
-    ## Load user's profile.  (first check if user has a roaming profile)
-    username, domain = win32cred.CredUIParseUserName(target)
-    user_info_4 = win32net.NetUserGetInfo(None, username, 4)
-    profilepath = user_info_4["profile"]
-    ## LoadUserProfile apparently doesn't like an empty string
-    if not profilepath:
-        profilepath = None
-
-    ## leave Flags in since 2.3 still chokes on some types of optional keyword args
-    hk = win32profile.LoadUserProfile(
-        th, {"UserName": username, "Flags": 0, "ProfilePath": profilepath}
-    )
-    ## Get user's environment variables in a form that can be passed to win32process.CreateProcessAsUser
-    env = win32profile.CreateEnvironmentBlock(th, False)
-
-    ## Cleanup should probably be in a finally block
-    win32profile.UnloadUserProfile(th, hk)
-    th.Close()
-except win32security.error as exc:
-    print("Failed to login for some reason", exc)
diff --git a/lib/win32/Demos/win32fileDemo.py b/lib/win32/Demos/win32fileDemo.py
deleted file mode 100644
index a8099925..00000000
--- a/lib/win32/Demos/win32fileDemo.py
+++ /dev/null
@@ -1,41 +0,0 @@
-# This is a "demo" of win32file - it used to be more a test case than a
-# demo, so has been moved to the test directory.
-
-import os
-
-# Please contribute your favourite simple little demo.
-import win32api
-import win32con
-import win32file
-
-
-# A very simple demo - note that this does no more than you can do with
-# builtin Python file objects, so for something as simple as this, you
-# generally *should* use builtin Python objects.  Only use win32file etc
-# when you need win32 specific features not available in Python.
-def SimpleFileDemo():
-    testName = os.path.join(win32api.GetTempPath(), "win32file_demo_test_file")
-    if os.path.exists(testName):
-        os.unlink(testName)
-    # Open the file for writing.
-    handle = win32file.CreateFile(
-        testName, win32file.GENERIC_WRITE, 0, None, win32con.CREATE_NEW, 0, None
-    )
-    test_data = "Hello\0there".encode("ascii")
-    win32file.WriteFile(handle, test_data)
-    handle.Close()
-    # Open it for reading.
-    handle = win32file.CreateFile(
-        testName, win32file.GENERIC_READ, 0, None, win32con.OPEN_EXISTING, 0, None
-    )
-    rc, data = win32file.ReadFile(handle, 1024)
-    handle.Close()
-    if data == test_data:
-        print("Successfully wrote and read a file")
-    else:
-        raise Exception("Got different data back???")
-    os.unlink(testName)
-
-
-if __name__ == "__main__":
-    SimpleFileDemo()
diff --git a/lib/win32/Demos/win32gui_demo.py b/lib/win32/Demos/win32gui_demo.py
deleted file mode 100644
index 41844a92..00000000
--- a/lib/win32/Demos/win32gui_demo.py
+++ /dev/null
@@ -1,177 +0,0 @@
-# The start of a win32gui generic demo.
-# Feel free to contribute more demos back ;-)
-
-import math
-import random
-import time
-
-import win32api
-import win32con
-import win32gui
-
-
-def _MyCallback(hwnd, extra):
-    hwnds, classes = extra
-    hwnds.append(hwnd)
-    classes[win32gui.GetClassName(hwnd)] = 1
-
-
-def TestEnumWindows():
-    windows = []
-    classes = {}
-    win32gui.EnumWindows(_MyCallback, (windows, classes))
-    print(
-        "Enumerated a total of %d windows with %d classes"
-        % (len(windows), len(classes))
-    )
-    if "tooltips_class32" not in classes:
-        print("Hrmmmm - I'm very surprised to not find a 'tooltips_class32' class.")
-
-
-def OnPaint_1(hwnd, msg, wp, lp):
-    dc, ps = win32gui.BeginPaint(hwnd)
-    win32gui.SetGraphicsMode(dc, win32con.GM_ADVANCED)
-    br = win32gui.CreateSolidBrush(win32api.RGB(255, 0, 0))
-    win32gui.SelectObject(dc, br)
-    angle = win32gui.GetWindowLong(hwnd, win32con.GWL_USERDATA)
-    win32gui.SetWindowLong(hwnd, win32con.GWL_USERDATA, angle + 2)
-    r_angle = angle * (math.pi / 180)
-    win32gui.SetWorldTransform(
-        dc,
-        {
-            "M11": math.cos(r_angle),
-            "M12": math.sin(r_angle),
-            "M21": math.sin(r_angle) * -1,
-            "M22": math.cos(r_angle),
-            "Dx": 250,
-            "Dy": 250,
-        },
-    )
-    win32gui.MoveToEx(dc, 250, 250)
-    win32gui.BeginPath(dc)
-    win32gui.Pie(dc, 10, 70, 200, 200, 350, 350, 75, 10)
-    win32gui.Chord(dc, 200, 200, 850, 0, 350, 350, 75, 10)
-    win32gui.LineTo(dc, 300, 300)
-    win32gui.LineTo(dc, 100, 20)
-    win32gui.LineTo(dc, 20, 100)
-    win32gui.LineTo(dc, 400, 0)
-    win32gui.LineTo(dc, 0, 400)
-    win32gui.EndPath(dc)
-    win32gui.StrokeAndFillPath(dc)
-    win32gui.EndPaint(hwnd, ps)
-    return 0
-
-
-wndproc_1 = {win32con.WM_PAINT: OnPaint_1}
-
-
-def OnPaint_2(hwnd, msg, wp, lp):
-    dc, ps = win32gui.BeginPaint(hwnd)
-    win32gui.SetGraphicsMode(dc, win32con.GM_ADVANCED)
-    l, t, r, b = win32gui.GetClientRect(hwnd)
-
-    for x in range(25):
-        vertices = (
-            {
-                "x": int(random.random() * r),
-                "y": int(random.random() * b),
-                "Red": int(random.random() * 0xFF00),
-                "Green": 0,
-                "Blue": 0,
-                "Alpha": 0,
-            },
-            {
-                "x": int(random.random() * r),
-                "y": int(random.random() * b),
-                "Red": 0,
-                "Green": int(random.random() * 0xFF00),
-                "Blue": 0,
-                "Alpha": 0,
-            },
-            {
-                "x": int(random.random() * r),
-                "y": int(random.random() * b),
-                "Red": 0,
-                "Green": 0,
-                "Blue": int(random.random() * 0xFF00),
-                "Alpha": 0,
-            },
-        )
-        mesh = ((0, 1, 2),)
-        win32gui.GradientFill(dc, vertices, mesh, win32con.GRADIENT_FILL_TRIANGLE)
-    win32gui.EndPaint(hwnd, ps)
-    return 0
-
-
-wndproc_2 = {win32con.WM_PAINT: OnPaint_2}
-
-
-def TestSetWorldTransform():
-    wc = win32gui.WNDCLASS()
-    wc.lpszClassName = "test_win32gui_1"
-    wc.style = win32con.CS_GLOBALCLASS | win32con.CS_VREDRAW | win32con.CS_HREDRAW
-    wc.hbrBackground = win32con.COLOR_WINDOW + 1
-    wc.lpfnWndProc = wndproc_1
-    class_atom = win32gui.RegisterClass(wc)
-    hwnd = win32gui.CreateWindow(
-        wc.lpszClassName,
-        "Spin the Lobster!",
-        win32con.WS_CAPTION | win32con.WS_VISIBLE,
-        100,
-        100,
-        900,
-        900,
-        0,
-        0,
-        0,
-        None,
-    )
-    for x in range(500):
-        win32gui.InvalidateRect(hwnd, None, True)
-        win32gui.PumpWaitingMessages()
-        time.sleep(0.01)
-    win32gui.DestroyWindow(hwnd)
-    win32gui.UnregisterClass(wc.lpszClassName, None)
-
-
-def TestGradientFill():
-    wc = win32gui.WNDCLASS()
-    wc.lpszClassName = "test_win32gui_2"
-    wc.style = win32con.CS_GLOBALCLASS | win32con.CS_VREDRAW | win32con.CS_HREDRAW
-    wc.hbrBackground = win32con.COLOR_WINDOW + 1
-    wc.lpfnWndProc = wndproc_2
-    class_atom = win32gui.RegisterClass(wc)
-    hwnd = win32gui.CreateWindowEx(
-        0,
-        class_atom,
-        "Kaleidoscope",
-        win32con.WS_CAPTION
-        | win32con.WS_VISIBLE
-        | win32con.WS_THICKFRAME
-        | win32con.WS_SYSMENU,
-        100,
-        100,
-        900,
-        900,
-        0,
-        0,
-        0,
-        None,
-    )
-    s = win32gui.GetWindowLong(hwnd, win32con.GWL_EXSTYLE)
-    win32gui.SetWindowLong(hwnd, win32con.GWL_EXSTYLE, s | win32con.WS_EX_LAYERED)
-    win32gui.SetLayeredWindowAttributes(hwnd, 0, 175, win32con.LWA_ALPHA)
-    for x in range(30):
-        win32gui.InvalidateRect(hwnd, None, True)
-        win32gui.PumpWaitingMessages()
-        time.sleep(0.3)
-    win32gui.DestroyWindow(hwnd)
-    win32gui.UnregisterClass(class_atom, None)
-
-
-print("Enumerating all windows...")
-TestEnumWindows()
-print("Testing drawing functions ...")
-TestSetWorldTransform()
-TestGradientFill()
-print("All tests done!")
diff --git a/lib/win32/Demos/win32gui_devicenotify.py b/lib/win32/Demos/win32gui_devicenotify.py
deleted file mode 100644
index 34ad8a25..00000000
--- a/lib/win32/Demos/win32gui_devicenotify.py
+++ /dev/null
@@ -1,107 +0,0 @@
-# Demo RegisterDeviceNotification etc.  Creates a hidden window to receive
-# notifications.  See serviceEvents.py for an example of a service doing
-# that.
-import sys
-import time
-
-import win32api
-import win32con
-import win32file
-import win32gui
-import win32gui_struct
-import winnt
-
-# These device GUIDs are from Ioevent.h in the Windows SDK.  Ideally they
-# could be collected somewhere for pywin32...
-GUID_DEVINTERFACE_USB_DEVICE = "{A5DCBF10-6530-11D2-901F-00C04FB951ED}"
-
-
-# WM_DEVICECHANGE message handler.
-def OnDeviceChange(hwnd, msg, wp, lp):
-    # Unpack the 'lp' into the appropriate DEV_BROADCAST_* structure,
-    # using the self-identifying data inside the DEV_BROADCAST_HDR.
-    info = win32gui_struct.UnpackDEV_BROADCAST(lp)
-    print("Device change notification:", wp, str(info))
-    if (
-        wp == win32con.DBT_DEVICEQUERYREMOVE
-        and info.devicetype == win32con.DBT_DEVTYP_HANDLE
-    ):
-        # Our handle is stored away in the structure - just close it
-        print("Device being removed - closing handle")
-        win32file.CloseHandle(info.handle)
-        # and cancel our notifications - if it gets plugged back in we get
-        # the same notification and try and close the same handle...
-        win32gui.UnregisterDeviceNotification(info.hdevnotify)
-    return True
-
-
-def TestDeviceNotifications(dir_names):
-    wc = win32gui.WNDCLASS()
-    wc.lpszClassName = "test_devicenotify"
-    wc.style = win32con.CS_GLOBALCLASS | win32con.CS_VREDRAW | win32con.CS_HREDRAW
-    wc.hbrBackground = win32con.COLOR_WINDOW + 1
-    wc.lpfnWndProc = {win32con.WM_DEVICECHANGE: OnDeviceChange}
-    class_atom = win32gui.RegisterClass(wc)
-    hwnd = win32gui.CreateWindow(
-        wc.lpszClassName,
-        "Testing some devices",
-        # no need for it to be visible.
-        win32con.WS_CAPTION,
-        100,
-        100,
-        900,
-        900,
-        0,
-        0,
-        0,
-        None,
-    )
-
-    hdevs = []
-    # Watch for all USB device notifications
-    filter = win32gui_struct.PackDEV_BROADCAST_DEVICEINTERFACE(
-        GUID_DEVINTERFACE_USB_DEVICE
-    )
-    hdev = win32gui.RegisterDeviceNotification(
-        hwnd, filter, win32con.DEVICE_NOTIFY_WINDOW_HANDLE
-    )
-    hdevs.append(hdev)
-    # and create handles for all specified directories
-    for d in dir_names:
-        hdir = win32file.CreateFile(
-            d,
-            winnt.FILE_LIST_DIRECTORY,
-            winnt.FILE_SHARE_READ | winnt.FILE_SHARE_WRITE | winnt.FILE_SHARE_DELETE,
-            None,  # security attributes
-            win32con.OPEN_EXISTING,
-            win32con.FILE_FLAG_BACKUP_SEMANTICS
-            | win32con.FILE_FLAG_OVERLAPPED,  # required privileges: SE_BACKUP_NAME and SE_RESTORE_NAME.
-            None,
-        )
-
-        filter = win32gui_struct.PackDEV_BROADCAST_HANDLE(hdir)
-        hdev = win32gui.RegisterDeviceNotification(
-            hwnd, filter, win32con.DEVICE_NOTIFY_WINDOW_HANDLE
-        )
-        hdevs.append(hdev)
-
-    # now start a message pump and wait for messages to be delivered.
-    print("Watching", len(hdevs), "handles - press Ctrl+C to terminate, or")
-    print("add and remove some USB devices...")
-    if not dir_names:
-        print("(Note you can also pass paths to watch on the command-line - eg,")
-        print("pass the root of an inserted USB stick to see events specific to")
-        print("that volume)")
-    while 1:
-        win32gui.PumpWaitingMessages()
-        time.sleep(0.01)
-    win32gui.DestroyWindow(hwnd)
-    win32gui.UnregisterClass(wc.lpszClassName, None)
-
-
-if __name__ == "__main__":
-    # optionally pass device/directory names to watch for notifications.
-    # Eg, plug in a USB device - assume it connects as E: - then execute:
-    # % win32gui_devicenotify.py E:
-    # Then remove and insert the device.
-    TestDeviceNotifications(sys.argv[1:])
diff --git a/lib/win32/Demos/win32gui_dialog.py b/lib/win32/Demos/win32gui_dialog.py
deleted file mode 100644
index e3b89ba9..00000000
--- a/lib/win32/Demos/win32gui_dialog.py
+++ /dev/null
@@ -1,458 +0,0 @@
-# A demo of a fairly complex dialog.
-#
-# Features:
-# * Uses a "dynamic dialog resource" to build the dialog.
-# * Uses a ListView control.
-# * Dynamically resizes content.
-# * Uses a second worker thread to fill the list.
-# * Demostrates support for windows XP themes.
-
-# If you are on Windows XP, and specify a '--noxp' argument, you will see:
-# * alpha-blend issues with icons
-# * The buttons are "old" style, rather than based on the XP theme.
-# Hence, using:
-#   import winxpgui as win32gui
-# is recommended.
-# Please report any problems.
-import sys
-
-if "--noxp" in sys.argv:
-    import win32gui
-else:
-    import winxpgui as win32gui
-
-import array
-import os
-import queue
-import struct
-
-import commctrl
-import win32api
-import win32con
-import win32gui_struct
-import winerror
-
-IDC_SEARCHTEXT = 1024
-IDC_BUTTON_SEARCH = 1025
-IDC_BUTTON_DISPLAY = 1026
-IDC_LISTBOX = 1027
-
-WM_SEARCH_RESULT = win32con.WM_USER + 512
-WM_SEARCH_FINISHED = win32con.WM_USER + 513
-
-
-class _WIN32MASKEDSTRUCT:
-    def __init__(self, **kw):
-        full_fmt = ""
-        for name, fmt, default, mask in self._struct_items_:
-            self.__dict__[name] = None
-            if fmt == "z":
-                full_fmt += "pi"
-            else:
-                full_fmt += fmt
-        for name, val in kw.items():
-            if name not in self.__dict__:
-                raise ValueError("LVITEM structures do not have an item '%s'" % (name,))
-            self.__dict__[name] = val
-
-    def __setattr__(self, attr, val):
-        if not attr.startswith("_") and attr not in self.__dict__:
-            raise AttributeError(attr)
-        self.__dict__[attr] = val
-
-    def toparam(self):
-        self._buffs = []
-        full_fmt = ""
-        vals = []
-        mask = 0
-        # calc the mask
-        for name, fmt, default, this_mask in self._struct_items_:
-            if this_mask is not None and self.__dict__.get(name) is not None:
-                mask |= this_mask
-        self.mask = mask
-        for name, fmt, default, this_mask in self._struct_items_:
-            val = self.__dict__[name]
-            if fmt == "z":
-                fmt = "Pi"
-                if val is None:
-                    vals.append(0)
-                    vals.append(0)
-                else:
-                    # Note this demo still works with byte strings.  An
-                    # alternate strategy would be to use unicode natively
-                    # and use the 'W' version of the messages - eg,
-                    # LVM_SETITEMW etc.
-                    val = val + "\0"
-                    if isinstance(val, str):
-                        val = val.encode("mbcs")
-                    str_buf = array.array("b", val)
-                    vals.append(str_buf.buffer_info()[0])
-                    vals.append(len(val))
-                    self._buffs.append(str_buf)  # keep alive during the call.
-            else:
-                if val is None:
-                    val = default
-                vals.append(val)
-            full_fmt += fmt
-        return struct.pack(*(full_fmt,) + tuple(vals))
-
-
-# NOTE: See the win32gui_struct module for an alternative way of dealing
-# with these structures
-class LVITEM(_WIN32MASKEDSTRUCT):
-    _struct_items_ = [
-        ("mask", "I", 0, None),
-        ("iItem", "i", 0, None),
-        ("iSubItem", "i", 0, None),
-        ("state", "I", 0, commctrl.LVIF_STATE),
-        ("stateMask", "I", 0, None),
-        ("text", "z", None, commctrl.LVIF_TEXT),
-        ("iImage", "i", 0, commctrl.LVIF_IMAGE),
-        ("lParam", "i", 0, commctrl.LVIF_PARAM),
-        ("iIdent", "i", 0, None),
-    ]
-
-
-class LVCOLUMN(_WIN32MASKEDSTRUCT):
-    _struct_items_ = [
-        ("mask", "I", 0, None),
-        ("fmt", "i", 0, commctrl.LVCF_FMT),
-        ("cx", "i", 0, commctrl.LVCF_WIDTH),
-        ("text", "z", None, commctrl.LVCF_TEXT),
-        ("iSubItem", "i", 0, commctrl.LVCF_SUBITEM),
-        ("iImage", "i", 0, commctrl.LVCF_IMAGE),
-        ("iOrder", "i", 0, commctrl.LVCF_ORDER),
-    ]
-
-
-class DemoWindowBase:
-    def __init__(self):
-        win32gui.InitCommonControls()
-        self.hinst = win32gui.dllhandle
-        self.list_data = {}
-
-    def _RegisterWndClass(self):
-        className = "PythonDocSearch"
-        message_map = {}
-        wc = win32gui.WNDCLASS()
-        wc.SetDialogProc()  # Make it a dialog class.
-        wc.hInstance = self.hinst
-        wc.lpszClassName = className
-        wc.style = win32con.CS_VREDRAW | win32con.CS_HREDRAW
-        wc.hCursor = win32gui.LoadCursor(0, win32con.IDC_ARROW)
-        wc.hbrBackground = win32con.COLOR_WINDOW + 1
-        wc.lpfnWndProc = message_map  # could also specify a wndproc.
-        # C code: wc.cbWndExtra = DLGWINDOWEXTRA + sizeof(HBRUSH) + (sizeof(COLORREF));
-        wc.cbWndExtra = win32con.DLGWINDOWEXTRA + struct.calcsize("Pi")
-        icon_flags = win32con.LR_LOADFROMFILE | win32con.LR_DEFAULTSIZE
-
-        ## py.ico went away in python 2.5, load from executable instead
-        this_app = win32api.GetModuleHandle(None)
-        try:
-            wc.hIcon = win32gui.LoadIcon(this_app, 1)  ## python.exe and pythonw.exe
-        except win32gui.error:
-            wc.hIcon = win32gui.LoadIcon(this_app, 135)  ## pythonwin's icon
-        try:
-            classAtom = win32gui.RegisterClass(wc)
-        except win32gui.error as err_info:
-            if err_info.winerror != winerror.ERROR_CLASS_ALREADY_EXISTS:
-                raise
-        return className
-
-    def _GetDialogTemplate(self, dlgClassName):
-        style = (
-            win32con.WS_THICKFRAME
-            | win32con.WS_POPUP
-            | win32con.WS_VISIBLE
-            | win32con.WS_CAPTION
-            | win32con.WS_SYSMENU
-            | win32con.DS_SETFONT
-            | win32con.WS_MINIMIZEBOX
-        )
-        cs = win32con.WS_CHILD | win32con.WS_VISIBLE
-        title = "Dynamic Dialog Demo"
-
-        # Window frame and title
-        dlg = [
-            [
-                title,
-                (0, 0, 210, 250),
-                style,
-                None,
-                (8, "MS Sans Serif"),
-                None,
-                dlgClassName,
-            ],
-        ]
-
-        # ID label and text box
-        dlg.append([130, "Enter something", -1, (5, 5, 200, 9), cs | win32con.SS_LEFT])
-        s = cs | win32con.WS_TABSTOP | win32con.WS_BORDER
-        dlg.append(["EDIT", None, IDC_SEARCHTEXT, (5, 15, 200, 12), s])
-
-        # Search/Display Buttons
-        # (x positions don't matter here)
-        s = cs | win32con.WS_TABSTOP
-        dlg.append(
-            [
-                128,
-                "Fill List",
-                IDC_BUTTON_SEARCH,
-                (5, 35, 50, 14),
-                s | win32con.BS_DEFPUSHBUTTON,
-            ]
-        )
-        s = win32con.BS_PUSHBUTTON | s
-        dlg.append([128, "Display", IDC_BUTTON_DISPLAY, (100, 35, 50, 14), s])
-
-        # List control.
-        # Can't make this work :(
-        ##        s = cs | win32con.WS_TABSTOP
-        ##        dlg.append(['SysListView32', "Title", IDC_LISTBOX, (5, 505, 200, 200), s])
-
-        return dlg
-
-    def _DoCreate(self, fn):
-        message_map = {
-            win32con.WM_SIZE: self.OnSize,
-            win32con.WM_COMMAND: self.OnCommand,
-            win32con.WM_NOTIFY: self.OnNotify,
-            win32con.WM_INITDIALOG: self.OnInitDialog,
-            win32con.WM_CLOSE: self.OnClose,
-            win32con.WM_DESTROY: self.OnDestroy,
-            WM_SEARCH_RESULT: self.OnSearchResult,
-            WM_SEARCH_FINISHED: self.OnSearchFinished,
-        }
-        dlgClassName = self._RegisterWndClass()
-        template = self._GetDialogTemplate(dlgClassName)
-        return fn(self.hinst, template, 0, message_map)
-
-    def _SetupList(self):
-        child_style = (
-            win32con.WS_CHILD
-            | win32con.WS_VISIBLE
-            | win32con.WS_BORDER
-            | win32con.WS_HSCROLL
-            | win32con.WS_VSCROLL
-        )
-        child_style |= (
-            commctrl.LVS_SINGLESEL | commctrl.LVS_SHOWSELALWAYS | commctrl.LVS_REPORT
-        )
-        self.hwndList = win32gui.CreateWindow(
-            "SysListView32",
-            None,
-            child_style,
-            0,
-            0,
-            100,
-            100,
-            self.hwnd,
-            IDC_LISTBOX,
-            self.hinst,
-            None,
-        )
-
-        child_ex_style = win32gui.SendMessage(
-            self.hwndList, commctrl.LVM_GETEXTENDEDLISTVIEWSTYLE, 0, 0
-        )
-        child_ex_style |= commctrl.LVS_EX_FULLROWSELECT
-        win32gui.SendMessage(
-            self.hwndList, commctrl.LVM_SETEXTENDEDLISTVIEWSTYLE, 0, child_ex_style
-        )
-
-        # Add an image list - use the builtin shell folder icon - this
-        # demonstrates the problem with alpha-blending of icons on XP if
-        # winxpgui is not used in place of win32gui.
-        il = win32gui.ImageList_Create(
-            win32api.GetSystemMetrics(win32con.SM_CXSMICON),
-            win32api.GetSystemMetrics(win32con.SM_CYSMICON),
-            commctrl.ILC_COLOR32 | commctrl.ILC_MASK,
-            1,  # initial size
-            0,
-        )  # cGrow
-
-        shell_dll = os.path.join(win32api.GetSystemDirectory(), "shell32.dll")
-        large, small = win32gui.ExtractIconEx(shell_dll, 4, 1)
-        win32gui.ImageList_ReplaceIcon(il, -1, small[0])
-        win32gui.DestroyIcon(small[0])
-        win32gui.DestroyIcon(large[0])
-        win32gui.SendMessage(
-            self.hwndList, commctrl.LVM_SETIMAGELIST, commctrl.LVSIL_SMALL, il
-        )
-
-        # Setup the list control columns.
-        lvc = LVCOLUMN(
-            mask=commctrl.LVCF_FMT
-            | commctrl.LVCF_WIDTH
-            | commctrl.LVCF_TEXT
-            | commctrl.LVCF_SUBITEM
-        )
-        lvc.fmt = commctrl.LVCFMT_LEFT
-        lvc.iSubItem = 1
-        lvc.text = "Title"
-        lvc.cx = 200
-        win32gui.SendMessage(self.hwndList, commctrl.LVM_INSERTCOLUMN, 0, lvc.toparam())
-        lvc.iSubItem = 0
-        lvc.text = "Order"
-        lvc.cx = 50
-        win32gui.SendMessage(self.hwndList, commctrl.LVM_INSERTCOLUMN, 0, lvc.toparam())
-
-        win32gui.UpdateWindow(self.hwnd)
-
-    def ClearListItems(self):
-        win32gui.SendMessage(self.hwndList, commctrl.LVM_DELETEALLITEMS)
-        self.list_data = {}
-
-    def AddListItem(self, data, *columns):
-        num_items = win32gui.SendMessage(self.hwndList, commctrl.LVM_GETITEMCOUNT)
-        item = LVITEM(text=columns[0], iItem=num_items)
-        new_index = win32gui.SendMessage(
-            self.hwndList, commctrl.LVM_INSERTITEM, 0, item.toparam()
-        )
-        col_no = 1
-        for col in columns[1:]:
-            item = LVITEM(text=col, iItem=new_index, iSubItem=col_no)
-            win32gui.SendMessage(self.hwndList, commctrl.LVM_SETITEM, 0, item.toparam())
-            col_no += 1
-        self.list_data[new_index] = data
-
-    def OnInitDialog(self, hwnd, msg, wparam, lparam):
-        self.hwnd = hwnd
-        # centre the dialog
-        desktop = win32gui.GetDesktopWindow()
-        l, t, r, b = win32gui.GetWindowRect(self.hwnd)
-        dt_l, dt_t, dt_r, dt_b = win32gui.GetWindowRect(desktop)
-        centre_x, centre_y = win32gui.ClientToScreen(
-            desktop, ((dt_r - dt_l) // 2, (dt_b - dt_t) // 2)
-        )
-        win32gui.MoveWindow(
-            hwnd, centre_x - (r // 2), centre_y - (b // 2), r - l, b - t, 0
-        )
-        self._SetupList()
-        l, t, r, b = win32gui.GetClientRect(self.hwnd)
-        self._DoSize(r - l, b - t, 1)
-
-    def _DoSize(self, cx, cy, repaint=1):
-        # right-justify the textbox.
-        ctrl = win32gui.GetDlgItem(self.hwnd, IDC_SEARCHTEXT)
-        l, t, r, b = win32gui.GetWindowRect(ctrl)
-        l, t = win32gui.ScreenToClient(self.hwnd, (l, t))
-        r, b = win32gui.ScreenToClient(self.hwnd, (r, b))
-        win32gui.MoveWindow(ctrl, l, t, cx - l - 5, b - t, repaint)
-        # The button.
-        ctrl = win32gui.GetDlgItem(self.hwnd, IDC_BUTTON_DISPLAY)
-        l, t, r, b = win32gui.GetWindowRect(ctrl)
-        l, t = win32gui.ScreenToClient(self.hwnd, (l, t))
-        r, b = win32gui.ScreenToClient(self.hwnd, (r, b))
-        list_y = b + 10
-        w = r - l
-        win32gui.MoveWindow(ctrl, cx - 5 - w, t, w, b - t, repaint)
-
-        # The list control
-        win32gui.MoveWindow(self.hwndList, 0, list_y, cx, cy - list_y, repaint)
-        # The last column of the list control.
-        new_width = cx - win32gui.SendMessage(
-            self.hwndList, commctrl.LVM_GETCOLUMNWIDTH, 0
-        )
-        win32gui.SendMessage(self.hwndList, commctrl.LVM_SETCOLUMNWIDTH, 1, new_width)
-
-    def OnSize(self, hwnd, msg, wparam, lparam):
-        x = win32api.LOWORD(lparam)
-        y = win32api.HIWORD(lparam)
-        self._DoSize(x, y)
-        return 1
-
-    def OnSearchResult(self, hwnd, msg, wparam, lparam):
-        try:
-            while 1:
-                params = self.result_queue.get(0)
-                self.AddListItem(*params)
-        except queue.Empty:
-            pass
-
-    def OnSearchFinished(self, hwnd, msg, wparam, lparam):
-        print("OnSearchFinished")
-
-    def OnNotify(self, hwnd, msg, wparam, lparam):
-        info = win32gui_struct.UnpackNMITEMACTIVATE(lparam)
-        if info.code == commctrl.NM_DBLCLK:
-            print("Double click on item", info.iItem + 1)
-        return 1
-
-    def OnCommand(self, hwnd, msg, wparam, lparam):
-        id = win32api.LOWORD(wparam)
-        if id == IDC_BUTTON_SEARCH:
-            self.ClearListItems()
-
-            def fill_slowly(q, hwnd):
-                import time
-
-                for i in range(20):
-                    q.put(("whatever", str(i + 1), "Search result " + str(i)))
-                    win32gui.PostMessage(hwnd, WM_SEARCH_RESULT, 0, 0)
-                    time.sleep(0.25)
-                win32gui.PostMessage(hwnd, WM_SEARCH_FINISHED, 0, 0)
-
-            import threading
-
-            self.result_queue = queue.Queue()
-            thread = threading.Thread(
-                target=fill_slowly, args=(self.result_queue, self.hwnd)
-            )
-            thread.start()
-        elif id == IDC_BUTTON_DISPLAY:
-            print("Display button selected")
-            sel = win32gui.SendMessage(
-                self.hwndList, commctrl.LVM_GETNEXTITEM, -1, commctrl.LVNI_SELECTED
-            )
-            print("The selected item is", sel + 1)
-
-    # These function differ based on how the window is used, so may be overridden
-    def OnClose(self, hwnd, msg, wparam, lparam):
-        raise NotImplementedError
-
-    def OnDestroy(self, hwnd, msg, wparam, lparam):
-        pass
-
-
-# An implementation suitable for use with the Win32 Window functions (ie, not
-# a true dialog)
-class DemoWindow(DemoWindowBase):
-    def CreateWindow(self):
-        # Create the window via CreateDialogBoxIndirect - it can then
-        # work as a "normal" window, once a message loop is established.
-        self._DoCreate(win32gui.CreateDialogIndirect)
-
-    def OnClose(self, hwnd, msg, wparam, lparam):
-        win32gui.DestroyWindow(hwnd)
-
-    # We need to arrange to a WM_QUIT message to be sent to our
-    # PumpMessages() loop.
-    def OnDestroy(self, hwnd, msg, wparam, lparam):
-        win32gui.PostQuitMessage(0)  # Terminate the app.
-
-
-# An implementation suitable for use with the Win32 Dialog functions.
-class DemoDialog(DemoWindowBase):
-    def DoModal(self):
-        return self._DoCreate(win32gui.DialogBoxIndirect)
-
-    def OnClose(self, hwnd, msg, wparam, lparam):
-        win32gui.EndDialog(hwnd, 0)
-
-
-def DemoModal():
-    w = DemoDialog()
-    w.DoModal()
-
-
-def DemoCreateWindow():
-    w = DemoWindow()
-    w.CreateWindow()
-    # PumpMessages runs until PostQuitMessage() is called by someone.
-    win32gui.PumpMessages()
-
-
-if __name__ == "__main__":
-    DemoModal()
-    DemoCreateWindow()
diff --git a/lib/win32/Demos/win32gui_menu.py b/lib/win32/Demos/win32gui_menu.py
deleted file mode 100644
index c462b062..00000000
--- a/lib/win32/Demos/win32gui_menu.py
+++ /dev/null
@@ -1,420 +0,0 @@
-# Demonstrates some advanced menu concepts using win32gui.
-# This creates a taskbar icon which has some fancy menus (but note that
-# selecting the menu items does nothing useful - see win32gui_taskbar.py
-# for examples of this.
-
-# NOTE: This is a work in progress.  Todo:
-# * The "Checked" menu items don't work correctly - I'm not sure why.
-# * No support for GetMenuItemInfo.
-
-# Based on Andy McKay's demo code.
-from win32api import *
-
-# Try and use XP features, so we get alpha-blending etc.
-try:
-    from winxpgui import *
-except ImportError:
-    from win32gui import *
-
-import array
-import os
-import struct
-import sys
-
-import win32con
-from win32gui_struct import *
-
-this_dir = os.path.split(sys.argv[0])[0]
-
-
-class MainWindow:
-    def __init__(self):
-        message_map = {
-            win32con.WM_DESTROY: self.OnDestroy,
-            win32con.WM_COMMAND: self.OnCommand,
-            win32con.WM_USER + 20: self.OnTaskbarNotify,
-            # owner-draw related handlers.
-            win32con.WM_MEASUREITEM: self.OnMeasureItem,
-            win32con.WM_DRAWITEM: self.OnDrawItem,
-        }
-        # Register the Window class.
-        wc = WNDCLASS()
-        hinst = wc.hInstance = GetModuleHandle(None)
-        wc.lpszClassName = "PythonTaskbarDemo"
-        wc.lpfnWndProc = message_map  # could also specify a wndproc.
-        classAtom = RegisterClass(wc)
-        # Create the Window.
-        style = win32con.WS_OVERLAPPED | win32con.WS_SYSMENU
-        self.hwnd = CreateWindow(
-            classAtom,
-            "Taskbar Demo",
-            style,
-            0,
-            0,
-            win32con.CW_USEDEFAULT,
-            win32con.CW_USEDEFAULT,
-            0,
-            0,
-            hinst,
-            None,
-        )
-        UpdateWindow(self.hwnd)
-        iconPathName = os.path.abspath(os.path.join(sys.prefix, "pyc.ico"))
-        # py2.5 includes the .ico files in the DLLs dir for some reason.
-        if not os.path.isfile(iconPathName):
-            iconPathName = os.path.abspath(
-                os.path.join(os.path.split(sys.executable)[0], "DLLs", "pyc.ico")
-            )
-        if not os.path.isfile(iconPathName):
-            # Look in the source tree.
-            iconPathName = os.path.abspath(
-                os.path.join(os.path.split(sys.executable)[0], "..\\PC\\pyc.ico")
-            )
-        if os.path.isfile(iconPathName):
-            icon_flags = win32con.LR_LOADFROMFILE | win32con.LR_DEFAULTSIZE
-            hicon = LoadImage(
-                hinst, iconPathName, win32con.IMAGE_ICON, 0, 0, icon_flags
-            )
-        else:
-            iconPathName = None
-            print("Can't find a Python icon file - using default")
-            hicon = LoadIcon(0, win32con.IDI_APPLICATION)
-        self.iconPathName = iconPathName
-
-        # Load up some information about menus needed by our owner-draw code.
-        # The font to use on the menu.
-        ncm = SystemParametersInfo(win32con.SPI_GETNONCLIENTMETRICS)
-        self.font_menu = CreateFontIndirect(ncm["lfMenuFont"])
-        # spacing for our ownerdraw menus - not sure exactly what constants
-        # should be used (and if you owner-draw all items on the menu, it
-        # doesn't matter!)
-        self.menu_icon_height = GetSystemMetrics(win32con.SM_CYMENU) - 4
-        self.menu_icon_width = self.menu_icon_height
-        self.icon_x_pad = 8  # space from end of icon to start of text.
-        # A map we use to stash away data we need for ownerdraw.  Keyed
-        # by integer ID - that ID will be set in dwTypeData of the menu item.
-        self.menu_item_map = {}
-
-        # Finally, create the menu
-        self.createMenu()
-
-        flags = NIF_ICON | NIF_MESSAGE | NIF_TIP
-        nid = (self.hwnd, 0, flags, win32con.WM_USER + 20, hicon, "Python Demo")
-        Shell_NotifyIcon(NIM_ADD, nid)
-        print("Please right-click on the Python icon in the taskbar")
-
-    def createMenu(self):
-        self.hmenu = menu = CreatePopupMenu()
-        # Create our 'Exit' item with the standard, ugly 'close' icon.
-        item, extras = PackMENUITEMINFO(
-            text="Exit", hbmpItem=win32con.HBMMENU_MBAR_CLOSE, wID=1000
-        )
-        InsertMenuItem(menu, 0, 1, item)
-        # Create a 'text only' menu via InsertMenuItem rather then
-        # AppendMenu, just to prove we can!
-        item, extras = PackMENUITEMINFO(text="Text only item", wID=1001)
-        InsertMenuItem(menu, 0, 1, item)
-
-        load_bmp_flags = win32con.LR_LOADFROMFILE | win32con.LR_LOADTRANSPARENT
-        # These images are "over sized", so we load them scaled.
-        hbmp = LoadImage(
-            0,
-            os.path.join(this_dir, "images/smiley.bmp"),
-            win32con.IMAGE_BITMAP,
-            20,
-            20,
-            load_bmp_flags,
-        )
-
-        # Create a top-level menu with a bitmap
-        item, extras = PackMENUITEMINFO(
-            text="Menu with bitmap", hbmpItem=hbmp, wID=1002
-        )
-        InsertMenuItem(menu, 0, 1, item)
-
-        # Owner-draw menus mainly from:
-        # http://windowssdk.msdn.microsoft.com/en-us/library/ms647558.aspx
-        # and:
-        # http://www.codeguru.com/cpp/controls/menu/bitmappedmenus/article.php/c165
-
-        # Create one with an icon - this is *lots* more work - we do it
-        # owner-draw!  The primary reason is to handle transparency better -
-        # converting to a bitmap causes the background to be incorrect when
-        # the menu item is selected.  I can't see a simpler way.
-        # First, load the icon we want to use.
-        ico_x = GetSystemMetrics(win32con.SM_CXSMICON)
-        ico_y = GetSystemMetrics(win32con.SM_CYSMICON)
-        if self.iconPathName:
-            hicon = LoadImage(
-                0,
-                self.iconPathName,
-                win32con.IMAGE_ICON,
-                ico_x,
-                ico_y,
-                win32con.LR_LOADFROMFILE,
-            )
-        else:
-            shell_dll = os.path.join(GetSystemDirectory(), "shell32.dll")
-            large, small = win32gui.ExtractIconEx(shell_dll, 4, 1)
-            hicon = small[0]
-            DestroyIcon(large[0])
-
-        # Stash away the text and hicon in our map, and add the owner-draw
-        # item to the menu.
-        index = 0
-        self.menu_item_map[index] = (hicon, "Menu with owner-draw icon")
-        item, extras = PackMENUITEMINFO(
-            fType=win32con.MFT_OWNERDRAW, dwItemData=index, wID=1009
-        )
-        InsertMenuItem(menu, 0, 1, item)
-
-        # Add another icon-based icon - but this time using HBMMENU_CALLBACK
-        # in the hbmpItem elt, so we only need to draw the icon (ie, not the
-        # text or checkmark)
-        index = 1
-        self.menu_item_map[index] = (hicon, None)
-        item, extras = PackMENUITEMINFO(
-            text="Menu with o-d icon 2",
-            dwItemData=index,
-            hbmpItem=win32con.HBMMENU_CALLBACK,
-            wID=1010,
-        )
-        InsertMenuItem(menu, 0, 1, item)
-
-        # Add another icon-based icon - this time by converting
-        # via bitmap.  Note the icon background when selected is ugly :(
-        hdcBitmap = CreateCompatibleDC(0)
-        hdcScreen = GetDC(0)
-        hbm = CreateCompatibleBitmap(hdcScreen, ico_x, ico_y)
-        hbmOld = SelectObject(hdcBitmap, hbm)
-        SetBkMode(hdcBitmap, win32con.TRANSPARENT)
-        # Fill the background.
-        brush = GetSysColorBrush(win32con.COLOR_MENU)
-        FillRect(hdcBitmap, (0, 0, 16, 16), brush)
-        # unclear if brush needs to be freed.  Best clue I can find is:
-        # "GetSysColorBrush returns a cached brush instead of allocating a new
-        # one." - implies no DeleteObject.
-        # draw the icon
-        DrawIconEx(hdcBitmap, 0, 0, hicon, ico_x, ico_y, 0, 0, win32con.DI_NORMAL)
-        SelectObject(hdcBitmap, hbmOld)
-        DeleteDC(hdcBitmap)
-        item, extras = PackMENUITEMINFO(
-            text="Menu with icon", hbmpItem=hbm.Detach(), wID=1011
-        )
-        InsertMenuItem(menu, 0, 1, item)
-
-        # Create a sub-menu, and put a few funky ones there.
-        self.sub_menu = sub_menu = CreatePopupMenu()
-        # A 'checkbox' menu.
-        item, extras = PackMENUITEMINFO(
-            fState=win32con.MFS_CHECKED, text="Checkbox menu", hbmpItem=hbmp, wID=1003
-        )
-        InsertMenuItem(sub_menu, 0, 1, item)
-        # A 'radio' menu.
-        InsertMenu(sub_menu, 0, win32con.MF_BYPOSITION, win32con.MF_SEPARATOR, None)
-        item, extras = PackMENUITEMINFO(
-            fType=win32con.MFT_RADIOCHECK,
-            fState=win32con.MFS_CHECKED,
-            text="Checkbox menu - bullet 1",
-            hbmpItem=hbmp,
-            wID=1004,
-        )
-        InsertMenuItem(sub_menu, 0, 1, item)
-        item, extras = PackMENUITEMINFO(
-            fType=win32con.MFT_RADIOCHECK,
-            fState=win32con.MFS_UNCHECKED,
-            text="Checkbox menu - bullet 2",
-            hbmpItem=hbmp,
-            wID=1005,
-        )
-        InsertMenuItem(sub_menu, 0, 1, item)
-        # And add the sub-menu to the top-level menu.
-        item, extras = PackMENUITEMINFO(text="Sub-Menu", hSubMenu=sub_menu)
-        InsertMenuItem(menu, 0, 1, item)
-
-        # Set 'Exit' as the default option.
-        SetMenuDefaultItem(menu, 1000, 0)
-
-    def OnDestroy(self, hwnd, msg, wparam, lparam):
-        nid = (self.hwnd, 0)
-        Shell_NotifyIcon(NIM_DELETE, nid)
-        PostQuitMessage(0)  # Terminate the app.
-
-    def OnTaskbarNotify(self, hwnd, msg, wparam, lparam):
-        if lparam == win32con.WM_RBUTTONUP:
-            print("You right clicked me.")
-            # display the menu at the cursor pos.
-            pos = GetCursorPos()
-            SetForegroundWindow(self.hwnd)
-            TrackPopupMenu(
-                self.hmenu, win32con.TPM_LEFTALIGN, pos[0], pos[1], 0, self.hwnd, None
-            )
-            PostMessage(self.hwnd, win32con.WM_NULL, 0, 0)
-        elif lparam == win32con.WM_LBUTTONDBLCLK:
-            print("You double-clicked me")
-            # find the default menu item and fire it.
-            cmd = GetMenuDefaultItem(self.hmenu, False, 0)
-            if cmd == -1:
-                print("Can't find a default!")
-            # and just pretend it came from the menu
-            self.OnCommand(hwnd, win32con.WM_COMMAND, cmd, 0)
-        return 1
-
-    def OnCommand(self, hwnd, msg, wparam, lparam):
-        id = LOWORD(wparam)
-        if id == 1000:
-            print("Goodbye")
-            DestroyWindow(self.hwnd)
-        elif id in (1003, 1004, 1005):
-            # Our 'checkbox' and 'radio' items
-            state = GetMenuState(self.sub_menu, id, win32con.MF_BYCOMMAND)
-            if state == -1:
-                raise RuntimeError("No item found")
-            if state & win32con.MF_CHECKED:
-                check_flags = win32con.MF_UNCHECKED
-                print("Menu was checked - unchecking")
-            else:
-                check_flags = win32con.MF_CHECKED
-                print("Menu was unchecked - checking")
-
-            if id == 1003:
-                # simple checkbox
-                rc = CheckMenuItem(
-                    self.sub_menu, id, win32con.MF_BYCOMMAND | check_flags
-                )
-            else:
-                # radio button - must pass the first and last IDs in the
-                # "group", and the ID in the group that is to be selected.
-                rc = CheckMenuRadioItem(
-                    self.sub_menu, 1004, 1005, id, win32con.MF_BYCOMMAND
-                )
-            # Get and check the new state - first the simple way...
-            new_state = GetMenuState(self.sub_menu, id, win32con.MF_BYCOMMAND)
-            if new_state & win32con.MF_CHECKED != check_flags:
-                raise RuntimeError("The new item didn't get the new checked state!")
-            # Now the long-winded way via GetMenuItemInfo...
-            buf, extras = EmptyMENUITEMINFO()
-            win32gui.GetMenuItemInfo(self.sub_menu, id, False, buf)
-            (
-                fType,
-                fState,
-                wID,
-                hSubMenu,
-                hbmpChecked,
-                hbmpUnchecked,
-                dwItemData,
-                text,
-                hbmpItem,
-            ) = UnpackMENUITEMINFO(buf)
-
-            if fState & win32con.MF_CHECKED != check_flags:
-                raise RuntimeError("The new item didn't get the new checked state!")
-        else:
-            print("OnCommand for ID", id)
-
-    # Owner-draw related functions.  We only have 1 owner-draw item, but
-    # we pretend we have more than that :)
-    def OnMeasureItem(self, hwnd, msg, wparam, lparam):
-        ## Last item of MEASUREITEMSTRUCT is a ULONG_PTR
-        fmt = "5iP"
-        buf = PyMakeBuffer(struct.calcsize(fmt), lparam)
-        data = struct.unpack(fmt, buf)
-        ctlType, ctlID, itemID, itemWidth, itemHeight, itemData = data
-
-        hicon, text = self.menu_item_map[itemData]
-        if text is None:
-            # Only drawing icon due to HBMMENU_CALLBACK
-            cx = self.menu_icon_width
-            cy = self.menu_icon_height
-        else:
-            # drawing the lot!
-            dc = GetDC(hwnd)
-            oldFont = SelectObject(dc, self.font_menu)
-            cx, cy = GetTextExtentPoint32(dc, text)
-            SelectObject(dc, oldFont)
-            ReleaseDC(hwnd, dc)
-
-            cx += GetSystemMetrics(win32con.SM_CXMENUCHECK)
-            cx += self.menu_icon_width + self.icon_x_pad
-
-            cy = GetSystemMetrics(win32con.SM_CYMENU)
-
-        new_data = struct.pack(fmt, ctlType, ctlID, itemID, cx, cy, itemData)
-        PySetMemory(lparam, new_data)
-        return True
-
-    def OnDrawItem(self, hwnd, msg, wparam, lparam):
-        ## lparam is a DRAWITEMSTRUCT
-        fmt = "5i2P4iP"
-        data = struct.unpack(fmt, PyGetMemory(lparam, struct.calcsize(fmt)))
-        (
-            ctlType,
-            ctlID,
-            itemID,
-            itemAction,
-            itemState,
-            hwndItem,
-            hDC,
-            left,
-            top,
-            right,
-            bot,
-            itemData,
-        ) = data
-
-        rect = left, top, right, bot
-        hicon, text = self.menu_item_map[itemData]
-
-        if text is None:
-            # This means the menu-item had HBMMENU_CALLBACK - so all we
-            # draw is the icon.  rect is the entire area we should use.
-            DrawIconEx(
-                hDC, left, top, hicon, right - left, bot - top, 0, 0, win32con.DI_NORMAL
-            )
-        else:
-            # If the user has selected the item, use the selected
-            # text and background colors to display the item.
-            selected = itemState & win32con.ODS_SELECTED
-            if selected:
-                crText = SetTextColor(hDC, GetSysColor(win32con.COLOR_HIGHLIGHTTEXT))
-                crBkgnd = SetBkColor(hDC, GetSysColor(win32con.COLOR_HIGHLIGHT))
-
-            each_pad = self.icon_x_pad // 2
-            x_icon = left + GetSystemMetrics(win32con.SM_CXMENUCHECK) + each_pad
-            x_text = x_icon + self.menu_icon_width + each_pad
-
-            # Draw text first, specifying a complete rect to fill - this sets
-            # up the background (but overwrites anything else already there!)
-            # Select the font, draw it, and restore the previous font.
-            hfontOld = SelectObject(hDC, self.font_menu)
-            ExtTextOut(hDC, x_text, top + 2, win32con.ETO_OPAQUE, rect, text)
-            SelectObject(hDC, hfontOld)
-
-            # Icon image next.  Icons are transparent - no need to handle
-            # selection specially.
-            DrawIconEx(
-                hDC,
-                x_icon,
-                top + 2,
-                hicon,
-                self.menu_icon_width,
-                self.menu_icon_height,
-                0,
-                0,
-                win32con.DI_NORMAL,
-            )
-
-            # Return the text and background colors to their
-            # normal state (not selected).
-            if selected:
-                SetTextColor(hDC, crText)
-                SetBkColor(hDC, crBkgnd)
-
-
-def main():
-    w = MainWindow()
-    PumpMessages()
-
-
-if __name__ == "__main__":
-    main()
diff --git a/lib/win32/Demos/win32gui_taskbar.py b/lib/win32/Demos/win32gui_taskbar.py
deleted file mode 100644
index 84d642a9..00000000
--- a/lib/win32/Demos/win32gui_taskbar.py
+++ /dev/null
@@ -1,141 +0,0 @@
-# Creates a task-bar icon.  Run from Python.exe to see the
-# messages printed.
-import os
-import sys
-
-import win32api
-import win32con
-import win32gui
-import winerror
-
-
-class MainWindow:
-    def __init__(self):
-        msg_TaskbarRestart = win32gui.RegisterWindowMessage("TaskbarCreated")
-        message_map = {
-            msg_TaskbarRestart: self.OnRestart,
-            win32con.WM_DESTROY: self.OnDestroy,
-            win32con.WM_COMMAND: self.OnCommand,
-            win32con.WM_USER + 20: self.OnTaskbarNotify,
-        }
-        # Register the Window class.
-        wc = win32gui.WNDCLASS()
-        hinst = wc.hInstance = win32api.GetModuleHandle(None)
-        wc.lpszClassName = "PythonTaskbarDemo"
-        wc.style = win32con.CS_VREDRAW | win32con.CS_HREDRAW
-        wc.hCursor = win32api.LoadCursor(0, win32con.IDC_ARROW)
-        wc.hbrBackground = win32con.COLOR_WINDOW
-        wc.lpfnWndProc = message_map  # could also specify a wndproc.
-
-        # Don't blow up if class already registered to make testing easier
-        try:
-            classAtom = win32gui.RegisterClass(wc)
-        except win32gui.error as err_info:
-            if err_info.winerror != winerror.ERROR_CLASS_ALREADY_EXISTS:
-                raise
-
-        # Create the Window.
-        style = win32con.WS_OVERLAPPED | win32con.WS_SYSMENU
-        self.hwnd = win32gui.CreateWindow(
-            wc.lpszClassName,
-            "Taskbar Demo",
-            style,
-            0,
-            0,
-            win32con.CW_USEDEFAULT,
-            win32con.CW_USEDEFAULT,
-            0,
-            0,
-            hinst,
-            None,
-        )
-        win32gui.UpdateWindow(self.hwnd)
-        self._DoCreateIcons()
-
-    def _DoCreateIcons(self):
-        # Try and find a custom icon
-        hinst = win32api.GetModuleHandle(None)
-        iconPathName = os.path.abspath(
-            os.path.join(os.path.split(sys.executable)[0], "pyc.ico")
-        )
-        if not os.path.isfile(iconPathName):
-            # Look in DLLs dir, a-la py 2.5
-            iconPathName = os.path.abspath(
-                os.path.join(os.path.split(sys.executable)[0], "DLLs", "pyc.ico")
-            )
-        if not os.path.isfile(iconPathName):
-            # Look in the source tree.
-            iconPathName = os.path.abspath(
-                os.path.join(os.path.split(sys.executable)[0], "..\\PC\\pyc.ico")
-            )
-        if os.path.isfile(iconPathName):
-            icon_flags = win32con.LR_LOADFROMFILE | win32con.LR_DEFAULTSIZE
-            hicon = win32gui.LoadImage(
-                hinst, iconPathName, win32con.IMAGE_ICON, 0, 0, icon_flags
-            )
-        else:
-            print("Can't find a Python icon file - using default")
-            hicon = win32gui.LoadIcon(0, win32con.IDI_APPLICATION)
-
-        flags = win32gui.NIF_ICON | win32gui.NIF_MESSAGE | win32gui.NIF_TIP
-        nid = (self.hwnd, 0, flags, win32con.WM_USER + 20, hicon, "Python Demo")
-        try:
-            win32gui.Shell_NotifyIcon(win32gui.NIM_ADD, nid)
-        except win32gui.error:
-            # This is common when windows is starting, and this code is hit
-            # before the taskbar has been created.
-            print("Failed to add the taskbar icon - is explorer running?")
-            # but keep running anyway - when explorer starts, we get the
-            # TaskbarCreated message.
-
-    def OnRestart(self, hwnd, msg, wparam, lparam):
-        self._DoCreateIcons()
-
-    def OnDestroy(self, hwnd, msg, wparam, lparam):
-        nid = (self.hwnd, 0)
-        win32gui.Shell_NotifyIcon(win32gui.NIM_DELETE, nid)
-        win32gui.PostQuitMessage(0)  # Terminate the app.
-
-    def OnTaskbarNotify(self, hwnd, msg, wparam, lparam):
-        if lparam == win32con.WM_LBUTTONUP:
-            print("You clicked me.")
-        elif lparam == win32con.WM_LBUTTONDBLCLK:
-            print("You double-clicked me - goodbye")
-            win32gui.DestroyWindow(self.hwnd)
-        elif lparam == win32con.WM_RBUTTONUP:
-            print("You right clicked me.")
-            menu = win32gui.CreatePopupMenu()
-            win32gui.AppendMenu(menu, win32con.MF_STRING, 1023, "Display Dialog")
-            win32gui.AppendMenu(menu, win32con.MF_STRING, 1024, "Say Hello")
-            win32gui.AppendMenu(menu, win32con.MF_STRING, 1025, "Exit program")
-            pos = win32gui.GetCursorPos()
-            # See http://msdn.microsoft.com/library/default.asp?url=/library/en-us/winui/menus_0hdi.asp
-            win32gui.SetForegroundWindow(self.hwnd)
-            win32gui.TrackPopupMenu(
-                menu, win32con.TPM_LEFTALIGN, pos[0], pos[1], 0, self.hwnd, None
-            )
-            win32gui.PostMessage(self.hwnd, win32con.WM_NULL, 0, 0)
-        return 1
-
-    def OnCommand(self, hwnd, msg, wparam, lparam):
-        id = win32api.LOWORD(wparam)
-        if id == 1023:
-            import win32gui_dialog
-
-            win32gui_dialog.DemoModal()
-        elif id == 1024:
-            print("Hello")
-        elif id == 1025:
-            print("Goodbye")
-            win32gui.DestroyWindow(self.hwnd)
-        else:
-            print("Unknown command -", id)
-
-
-def main():
-    w = MainWindow()
-    win32gui.PumpMessages()
-
-
-if __name__ == "__main__":
-    main()
diff --git a/lib/win32/Demos/win32netdemo.py b/lib/win32/Demos/win32netdemo.py
deleted file mode 100644
index 36c49542..00000000
--- a/lib/win32/Demos/win32netdemo.py
+++ /dev/null
@@ -1,274 +0,0 @@
-import getopt
-import sys
-import traceback
-
-import win32api
-import win32net
-import win32netcon
-import win32security
-
-verbose_level = 0
-
-server = None  # Run on local machine.
-
-
-def verbose(msg):
-    if verbose_level:
-        print(msg)
-
-
-def CreateUser():
-    "Creates a new test user, then deletes the user"
-    testName = "PyNetTestUser"
-    try:
-        win32net.NetUserDel(server, testName)
-        print("Warning - deleted user before creating it!")
-    except win32net.error:
-        pass
-
-    d = {}
-    d["name"] = testName
-    d["password"] = "deleteme"
-    d["priv"] = win32netcon.USER_PRIV_USER
-    d["comment"] = "Delete me - created by Python test code"
-    d["flags"] = win32netcon.UF_NORMAL_ACCOUNT | win32netcon.UF_SCRIPT
-    win32net.NetUserAdd(server, 1, d)
-    try:
-        try:
-            win32net.NetUserChangePassword(server, testName, "wrong", "new")
-            print("ERROR: NetUserChangePassword worked with a wrong password!")
-        except win32net.error:
-            pass
-        win32net.NetUserChangePassword(server, testName, "deleteme", "new")
-    finally:
-        win32net.NetUserDel(server, testName)
-    print("Created a user, changed their password, and deleted them!")
-
-
-def UserEnum():
-    "Enumerates all the local users"
-    resume = 0
-    nuser = 0
-    while 1:
-        data, total, resume = win32net.NetUserEnum(
-            server, 3, win32netcon.FILTER_NORMAL_ACCOUNT, resume
-        )
-        verbose(
-            "Call to NetUserEnum obtained %d entries of %d total" % (len(data), total)
-        )
-        for user in data:
-            verbose("Found user %s" % user["name"])
-            nuser = nuser + 1
-        if not resume:
-            break
-    assert nuser, "Could not find any users!"
-    print("Enumerated all the local users")
-
-
-def GroupEnum():
-    "Enumerates all the domain groups"
-    nmembers = 0
-    resume = 0
-    while 1:
-        data, total, resume = win32net.NetGroupEnum(server, 1, resume)
-        #               print "Call to NetGroupEnum obtained %d entries of %d total" % (len(data), total)
-        for group in data:
-            verbose("Found group %(name)s:%(comment)s " % group)
-            memberresume = 0
-            while 1:
-                memberdata, total, memberresume = win32net.NetGroupGetUsers(
-                    server, group["name"], 0, resume
-                )
-                for member in memberdata:
-                    verbose(" Member %(name)s" % member)
-                    nmembers = nmembers + 1
-                if memberresume == 0:
-                    break
-        if not resume:
-            break
-    assert nmembers, "Couldnt find a single member in a single group!"
-    print("Enumerated all the groups")
-
-
-def LocalGroupEnum():
-    "Enumerates all the local groups"
-    resume = 0
-    nmembers = 0
-    while 1:
-        data, total, resume = win32net.NetLocalGroupEnum(server, 1, resume)
-        for group in data:
-            verbose("Found group %(name)s:%(comment)s " % group)
-            memberresume = 0
-            while 1:
-                memberdata, total, memberresume = win32net.NetLocalGroupGetMembers(
-                    server, group["name"], 2, resume
-                )
-                for member in memberdata:
-                    # Just for the sake of it, we convert the SID to a username
-                    username, domain, type = win32security.LookupAccountSid(
-                        server, member["sid"]
-                    )
-                    nmembers = nmembers + 1
-                    verbose(" Member %s (%s)" % (username, member["domainandname"]))
-                if memberresume == 0:
-                    break
-        if not resume:
-            break
-    assert nmembers, "Couldnt find a single member in a single group!"
-    print("Enumerated all the local groups")
-
-
-def ServerEnum():
-    "Enumerates all servers on the network"
-    resume = 0
-    while 1:
-        data, total, resume = win32net.NetServerEnum(
-            server, 100, win32netcon.SV_TYPE_ALL, None, resume
-        )
-        for s in data:
-            verbose("Found server %s" % s["name"])
-            # Now loop over the shares.
-            shareresume = 0
-            while 1:
-                sharedata, total, shareresume = win32net.NetShareEnum(
-                    server, 2, shareresume
-                )
-                for share in sharedata:
-                    verbose(
-                        " %(netname)s (%(path)s):%(remark)s - in use by %(current_uses)d users"
-                        % share
-                    )
-                if not shareresume:
-                    break
-        if not resume:
-            break
-    print("Enumerated all the servers on the network")
-
-
-def LocalGroup(uname=None):
-    "Creates a local group, adds some members, deletes them, then removes the group"
-    level = 3
-    if uname is None:
-        uname = win32api.GetUserName()
-    if uname.find("\\") < 0:
-        uname = win32api.GetDomainName() + "\\" + uname
-    group = "python_test_group"
-    # delete the group if it already exists
-    try:
-        win32net.NetLocalGroupDel(server, group)
-        print("WARNING: existing local group '%s' has been deleted.")
-    except win32net.error:
-        pass
-    group_data = {"name": group}
-    win32net.NetLocalGroupAdd(server, 1, group_data)
-    try:
-        u = {"domainandname": uname}
-        win32net.NetLocalGroupAddMembers(server, group, level, [u])
-        mem, tot, res = win32net.NetLocalGroupGetMembers(server, group, level)
-        print("members are", mem)
-        if mem[0]["domainandname"] != uname:
-            print("ERROR: LocalGroup just added %s, but members are %r" % (uname, mem))
-        # Convert the list of dicts to a list of strings.
-        win32net.NetLocalGroupDelMembers(
-            server, group, [m["domainandname"] for m in mem]
-        )
-    finally:
-        win32net.NetLocalGroupDel(server, group)
-    print("Created a local group, added and removed members, then deleted the group")
-
-
-def GetInfo(userName=None):
-    "Dumps level 3 information about the current user"
-    if userName is None:
-        userName = win32api.GetUserName()
-    print("Dumping level 3 information about user")
-    info = win32net.NetUserGetInfo(server, userName, 3)
-    for key, val in list(info.items()):
-        verbose("%s=%s" % (key, val))
-
-
-def SetInfo(userName=None):
-    "Attempts to change the current users comment, then set it back"
-    if userName is None:
-        userName = win32api.GetUserName()
-    oldData = win32net.NetUserGetInfo(server, userName, 3)
-    try:
-        d = oldData.copy()
-        d["usr_comment"] = "Test comment"
-        win32net.NetUserSetInfo(server, userName, 3, d)
-        new = win32net.NetUserGetInfo(server, userName, 3)["usr_comment"]
-        if str(new) != "Test comment":
-            raise RuntimeError("Could not read the same comment back - got %s" % new)
-        print("Changed the data for the user")
-    finally:
-        win32net.NetUserSetInfo(server, userName, 3, oldData)
-
-
-def SetComputerInfo():
-    "Doesnt actually change anything, just make sure we could ;-)"
-    info = win32net.NetWkstaGetInfo(None, 502)
-    # *sob* - but we can't!  Why not!!!
-    # win32net.NetWkstaSetInfo(None, 502, info)
-
-
-def usage(tests):
-    import os
-
-    print("Usage: %s [-s server ] [-v] [Test ...]" % os.path.basename(sys.argv[0]))
-    print("  -v : Verbose - print more information")
-    print("  -s : server - execute the tests against the named server")
-    print("  -c : include the CreateUser test by default")
-    print("where Test is one of:")
-    for t in tests:
-        print(t.__name__, ":", t.__doc__)
-    print()
-    print("If not tests are specified, all tests are run")
-    sys.exit(1)
-
-
-def main():
-    tests = []
-    for ob in list(globals().values()):
-        if type(ob) == type(main) and ob.__doc__:
-            tests.append(ob)
-    opts, args = getopt.getopt(sys.argv[1:], "s:hvc")
-    create_user = False
-    for opt, val in opts:
-        if opt == "-s":
-            global server
-            server = val
-        if opt == "-h":
-            usage(tests)
-        if opt == "-v":
-            global verbose_level
-            verbose_level = verbose_level + 1
-        if opt == "-c":
-            create_user = True
-
-    if len(args) == 0:
-        print("Running all tests - use '-h' to see command-line options...")
-        dotests = tests
-        if not create_user:
-            dotests.remove(CreateUser)
-    else:
-        dotests = []
-        for arg in args:
-            for t in tests:
-                if t.__name__ == arg:
-                    dotests.append(t)
-                    break
-            else:
-                print("Test '%s' unknown - skipping" % arg)
-    if not len(dotests):
-        print("Nothing to do!")
-        usage(tests)
-    for test in dotests:
-        try:
-            test()
-        except:
-            print("Test %s failed" % test.__name__)
-            traceback.print_exc()
-
-
-if __name__ == "__main__":
-    main()
diff --git a/lib/win32/Demos/win32rcparser_demo.py b/lib/win32/Demos/win32rcparser_demo.py
deleted file mode 100644
index 6a41d453..00000000
--- a/lib/win32/Demos/win32rcparser_demo.py
+++ /dev/null
@@ -1,86 +0,0 @@
-# A demo of the win32rcparser module and using win32gui
-
-import os
-
-import commctrl
-import win32api
-import win32con
-import win32gui
-import win32rcparser
-
-this_dir = os.path.abspath(os.path.dirname(__file__))
-g_rcname = os.path.abspath(
-    os.path.join(this_dir, "..", "test", "win32rcparser", "test.rc")
-)
-
-if not os.path.isfile(g_rcname):
-    raise RuntimeError("Can't locate test.rc (should be at '%s')" % (g_rcname,))
-
-
-class DemoWindow:
-    def __init__(self, dlg_template):
-        self.dlg_template = dlg_template
-
-    def CreateWindow(self):
-        self._DoCreate(win32gui.CreateDialogIndirect)
-
-    def DoModal(self):
-        return self._DoCreate(win32gui.DialogBoxIndirect)
-
-    def _DoCreate(self, fn):
-        message_map = {
-            win32con.WM_INITDIALOG: self.OnInitDialog,
-            win32con.WM_CLOSE: self.OnClose,
-            win32con.WM_DESTROY: self.OnDestroy,
-            win32con.WM_COMMAND: self.OnCommand,
-        }
-        return fn(0, self.dlg_template, 0, message_map)
-
-    def OnInitDialog(self, hwnd, msg, wparam, lparam):
-        self.hwnd = hwnd
-        # centre the dialog
-        desktop = win32gui.GetDesktopWindow()
-        l, t, r, b = win32gui.GetWindowRect(self.hwnd)
-        dt_l, dt_t, dt_r, dt_b = win32gui.GetWindowRect(desktop)
-        centre_x, centre_y = win32gui.ClientToScreen(
-            desktop, ((dt_r - dt_l) // 2, (dt_b - dt_t) // 2)
-        )
-        win32gui.MoveWindow(
-            hwnd, centre_x - (r // 2), centre_y - (b // 2), r - l, b - t, 0
-        )
-
-    def OnCommand(self, hwnd, msg, wparam, lparam):
-        # Needed to make OK/Cancel work - no other controls are handled.
-        id = win32api.LOWORD(wparam)
-        if id in [win32con.IDOK, win32con.IDCANCEL]:
-            win32gui.EndDialog(hwnd, id)
-
-    def OnClose(self, hwnd, msg, wparam, lparam):
-        win32gui.EndDialog(hwnd, 0)
-
-    def OnDestroy(self, hwnd, msg, wparam, lparam):
-        pass
-
-
-def DemoModal():
-    # Load the .rc file.
-    resources = win32rcparser.Parse(g_rcname)
-    for id, ddef in resources.dialogs.items():
-        print("Displaying dialog", id)
-        w = DemoWindow(ddef)
-        w.DoModal()
-
-
-if __name__ == "__main__":
-    flags = 0
-    for flag in """ICC_DATE_CLASSES ICC_ANIMATE_CLASS ICC_ANIMATE_CLASS 
-                   ICC_BAR_CLASSES ICC_COOL_CLASSES ICC_DATE_CLASSES
-                   ICC_HOTKEY_CLASS ICC_INTERNET_CLASSES ICC_LISTVIEW_CLASSES
-                   ICC_PAGESCROLLER_CLASS ICC_PROGRESS_CLASS ICC_TAB_CLASSES
-                   ICC_TREEVIEW_CLASSES ICC_UPDOWN_CLASS ICC_USEREX_CLASSES
-                   ICC_WIN95_CLASSES  """.split():
-        flags |= getattr(commctrl, flag)
-    win32gui.InitCommonControlsEx(flags)
-    # Need to do this go get rich-edit working.
-    win32api.LoadLibrary("riched20.dll")
-    DemoModal()
diff --git a/lib/win32/Demos/win32servicedemo.py b/lib/win32/Demos/win32servicedemo.py
deleted file mode 100644
index 75967ef3..00000000
--- a/lib/win32/Demos/win32servicedemo.py
+++ /dev/null
@@ -1,23 +0,0 @@
-import win32con
-import win32service
-
-
-def EnumServices():
-    resume = 0
-    accessSCM = win32con.GENERIC_READ
-    accessSrv = win32service.SC_MANAGER_ALL_ACCESS
-
-    # Open Service Control Manager
-    hscm = win32service.OpenSCManager(None, None, accessSCM)
-
-    # Enumerate Service Control Manager DB
-
-    typeFilter = win32service.SERVICE_WIN32
-    stateFilter = win32service.SERVICE_STATE_ALL
-
-    statuses = win32service.EnumServicesStatus(hscm, typeFilter, stateFilter)
-    for short_name, desc, status in statuses:
-        print(short_name, desc, status)
-
-
-EnumServices()
diff --git a/lib/win32/Demos/win32ts_logoff_disconnected.py b/lib/win32/Demos/win32ts_logoff_disconnected.py
deleted file mode 100644
index be61e5d1..00000000
--- a/lib/win32/Demos/win32ts_logoff_disconnected.py
+++ /dev/null
@@ -1,24 +0,0 @@
-""" Finds any disconnected terminal service sessions and logs them off"""
-import pywintypes
-import win32ts
-import winerror
-
-sessions = win32ts.WTSEnumerateSessions(win32ts.WTS_CURRENT_SERVER_HANDLE)
-for session in sessions:
-    """
-    WTS_CONNECTSTATE_CLASS: WTSActive,WTSConnected,WTSConnectQuery,WTSShadow,WTSDisconnected,
-          WTSIdle,WTSListen,WTSReset,WTSDown,WTSInit
-    """
-    if session["State"] == win32ts.WTSDisconnected:
-        sessionid = session["SessionId"]
-        username = win32ts.WTSQuerySessionInformation(
-            win32ts.WTS_CURRENT_SERVER_HANDLE, sessionid, win32ts.WTSUserName
-        )
-        print("Logging off disconnected user:", username)
-        try:
-            win32ts.WTSLogoffSession(win32ts.WTS_CURRENT_SERVER_HANDLE, sessionid, True)
-        except pywintypes.error as e:
-            if e.winerror == winerror.ERROR_ACCESS_DENIED:
-                print("Can't kill that session:", e.strerror)
-            else:
-                raise
diff --git a/lib/win32/Demos/win32wnet/testwnet.py b/lib/win32/Demos/win32wnet/testwnet.py
deleted file mode 100644
index 3b21ac29..00000000
--- a/lib/win32/Demos/win32wnet/testwnet.py
+++ /dev/null
@@ -1,125 +0,0 @@
-import os
-
-import win32api
-import win32wnet
-from winnetwk import *
-
-possible_shares = []
-
-
-def _doDumpHandle(handle, level=0):
-    indent = " " * level
-    while 1:
-        items = win32wnet.WNetEnumResource(handle, 0)
-        if len(items) == 0:
-            break
-        for item in items:
-            try:
-                if item.dwDisplayType == RESOURCEDISPLAYTYPE_SHARE:
-                    print(indent + "Have share with name:", item.lpRemoteName)
-                    possible_shares.append(item)
-                elif item.dwDisplayType == RESOURCEDISPLAYTYPE_GENERIC:
-                    print(
-                        indent + "Have generic resource with name:", item.lpRemoteName
-                    )
-                else:
-                    # Try generic!
-                    print(indent + "Enumerating " + item.lpRemoteName, end=" ")
-                    k = win32wnet.WNetOpenEnum(
-                        RESOURCE_GLOBALNET, RESOURCETYPE_ANY, 0, item
-                    )
-                    print()
-                    _doDumpHandle(k, level + 1)
-                    win32wnet.WNetCloseEnum(
-                        k
-                    )  # could do k.Close(), but this is a good test!
-            except win32wnet.error as details:
-                print(indent + "Couldn't enumerate this resource: " + details.strerror)
-
-
-def TestOpenEnum():
-    print("Enumerating all resources on the network - this may take some time...")
-    handle = win32wnet.WNetOpenEnum(RESOURCE_GLOBALNET, RESOURCETYPE_ANY, 0, None)
-
-    try:
-        _doDumpHandle(handle)
-    finally:
-        handle.Close()
-    print("Finished dumping all resources.")
-
-
-def findUnusedDriveLetter():
-    existing = [
-        x[0].lower() for x in win32api.GetLogicalDriveStrings().split("\0") if x
-    ]
-    handle = win32wnet.WNetOpenEnum(RESOURCE_REMEMBERED, RESOURCETYPE_DISK, 0, None)
-    try:
-        while 1:
-            items = win32wnet.WNetEnumResource(handle, 0)
-            if len(items) == 0:
-                break
-            xtra = [i.lpLocalName[0].lower() for i in items if i.lpLocalName]
-            existing.extend(xtra)
-    finally:
-        handle.Close()
-    for maybe in "defghijklmnopqrstuvwxyz":
-        if maybe not in existing:
-            return maybe
-    raise RuntimeError("All drive mappings are taken?")
-
-
-def TestConnection():
-    if len(possible_shares) == 0:
-        print("Couldn't find any potential shares to connect to")
-        return
-    localName = findUnusedDriveLetter() + ":"
-    for share in possible_shares:
-        print("Attempting connection of", localName, "to", share.lpRemoteName)
-        try:
-            win32wnet.WNetAddConnection2(share.dwType, localName, share.lpRemoteName)
-        except win32wnet.error as details:
-            print("Couldn't connect: " + details.strerror)
-            continue
-        # Have a connection.
-        try:
-            fname = os.path.join(localName + "\\", os.listdir(localName + "\\")[0])
-            try:
-                print(
-                    "Universal name of '%s' is '%s'"
-                    % (fname, win32wnet.WNetGetUniversalName(fname))
-                )
-            except win32wnet.error as details:
-                print(
-                    "Couldn't get universal name of '%s': %s"
-                    % (fname, details.strerror)
-                )
-            print("User name for this connection is", win32wnet.WNetGetUser(localName))
-        finally:
-            win32wnet.WNetCancelConnection2(localName, 0, 0)
-        # and do it again, but this time by using the more modern
-        # NETRESOURCE way.
-        nr = win32wnet.NETRESOURCE()
-        nr.dwType = share.dwType
-        nr.lpLocalName = localName
-        nr.lpRemoteName = share.lpRemoteName
-        win32wnet.WNetAddConnection2(nr)
-        win32wnet.WNetCancelConnection2(localName, 0, 0)
-
-        # and one more time using WNetAddConnection3
-        win32wnet.WNetAddConnection3(0, nr)
-        win32wnet.WNetCancelConnection2(localName, 0, 0)
-
-        # Only do the first share that succeeds.
-        break
-
-
-def TestGetUser():
-    u = win32wnet.WNetGetUser()
-    print("Current global user is", repr(u))
-    if u != win32wnet.WNetGetUser(None):
-        raise RuntimeError("Default value didnt seem to work!")
-
-
-TestGetUser()
-TestOpenEnum()
-TestConnection()
diff --git a/lib/win32/Demos/win32wnet/winnetwk.py b/lib/win32/Demos/win32wnet/winnetwk.py
deleted file mode 100644
index 036e2ebf..00000000
--- a/lib/win32/Demos/win32wnet/winnetwk.py
+++ /dev/null
@@ -1,100 +0,0 @@
-# Generated by h2py from d:\mssdk\include\winnetwk.h
-WNNC_NET_MSNET = 0x00010000
-WNNC_NET_LANMAN = 0x00020000
-WNNC_NET_NETWARE = 0x00030000
-WNNC_NET_VINES = 0x00040000
-WNNC_NET_10NET = 0x00050000
-WNNC_NET_LOCUS = 0x00060000
-WNNC_NET_SUN_PC_NFS = 0x00070000
-WNNC_NET_LANSTEP = 0x00080000
-WNNC_NET_9TILES = 0x00090000
-WNNC_NET_LANTASTIC = 0x000A0000
-WNNC_NET_AS400 = 0x000B0000
-WNNC_NET_FTP_NFS = 0x000C0000
-WNNC_NET_PATHWORKS = 0x000D0000
-WNNC_NET_LIFENET = 0x000E0000
-WNNC_NET_POWERLAN = 0x000F0000
-WNNC_NET_BWNFS = 0x00100000
-WNNC_NET_COGENT = 0x00110000
-WNNC_NET_FARALLON = 0x00120000
-WNNC_NET_APPLETALK = 0x00130000
-WNNC_NET_INTERGRAPH = 0x00140000
-WNNC_NET_SYMFONET = 0x00150000
-WNNC_NET_CLEARCASE = 0x00160000
-WNNC_NET_FRONTIER = 0x00170000
-WNNC_NET_BMC = 0x00180000
-WNNC_NET_DCE = 0x00190000
-WNNC_NET_DECORB = 0x00200000
-WNNC_NET_PROTSTOR = 0x00210000
-WNNC_NET_FJ_REDIR = 0x00220000
-WNNC_NET_DISTINCT = 0x00230000
-WNNC_NET_TWINS = 0x00240000
-WNNC_NET_RDR2SAMPLE = 0x00250000
-RESOURCE_CONNECTED = 0x00000001
-RESOURCE_GLOBALNET = 0x00000002
-RESOURCE_REMEMBERED = 0x00000003
-RESOURCE_RECENT = 0x00000004
-RESOURCE_CONTEXT = 0x00000005
-RESOURCETYPE_ANY = 0x00000000
-RESOURCETYPE_DISK = 0x00000001
-RESOURCETYPE_PRINT = 0x00000002
-RESOURCETYPE_RESERVED = 0x00000008
-RESOURCETYPE_UNKNOWN = 0xFFFFFFFF
-RESOURCEUSAGE_CONNECTABLE = 0x00000001
-RESOURCEUSAGE_CONTAINER = 0x00000002
-RESOURCEUSAGE_NOLOCALDEVICE = 0x00000004
-RESOURCEUSAGE_SIBLING = 0x00000008
-RESOURCEUSAGE_ATTACHED = 0x00000010
-RESOURCEUSAGE_ALL = (
-    RESOURCEUSAGE_CONNECTABLE | RESOURCEUSAGE_CONTAINER | RESOURCEUSAGE_ATTACHED
-)
-RESOURCEUSAGE_RESERVED = 0x80000000
-RESOURCEDISPLAYTYPE_GENERIC = 0x00000000
-RESOURCEDISPLAYTYPE_DOMAIN = 0x00000001
-RESOURCEDISPLAYTYPE_SERVER = 0x00000002
-RESOURCEDISPLAYTYPE_SHARE = 0x00000003
-RESOURCEDISPLAYTYPE_FILE = 0x00000004
-RESOURCEDISPLAYTYPE_GROUP = 0x00000005
-RESOURCEDISPLAYTYPE_NETWORK = 0x00000006
-RESOURCEDISPLAYTYPE_ROOT = 0x00000007
-RESOURCEDISPLAYTYPE_SHAREADMIN = 0x00000008
-RESOURCEDISPLAYTYPE_DIRECTORY = 0x00000009
-RESOURCEDISPLAYTYPE_TREE = 0x0000000A
-RESOURCEDISPLAYTYPE_NDSCONTAINER = 0x0000000B
-NETPROPERTY_PERSISTENT = 1
-CONNECT_UPDATE_PROFILE = 0x00000001
-CONNECT_UPDATE_RECENT = 0x00000002
-CONNECT_TEMPORARY = 0x00000004
-CONNECT_INTERACTIVE = 0x00000008
-CONNECT_PROMPT = 0x00000010
-CONNECT_NEED_DRIVE = 0x00000020
-CONNECT_REFCOUNT = 0x00000040
-CONNECT_REDIRECT = 0x00000080
-CONNECT_LOCALDRIVE = 0x00000100
-CONNECT_CURRENT_MEDIA = 0x00000200
-CONNECT_DEFERRED = 0x00000400
-CONNECT_RESERVED = 0xFF000000
-CONNDLG_RO_PATH = 0x00000001
-CONNDLG_CONN_POINT = 0x00000002
-CONNDLG_USE_MRU = 0x00000004
-CONNDLG_HIDE_BOX = 0x00000008
-CONNDLG_PERSIST = 0x00000010
-CONNDLG_NOT_PERSIST = 0x00000020
-DISC_UPDATE_PROFILE = 0x00000001
-DISC_NO_FORCE = 0x00000040
-UNIVERSAL_NAME_INFO_LEVEL = 0x00000001
-REMOTE_NAME_INFO_LEVEL = 0x00000002
-WNFMT_MULTILINE = 0x01
-WNFMT_ABBREVIATED = 0x02
-WNFMT_INENUM = 0x10
-WNFMT_CONNECTION = 0x20
-NETINFO_DLL16 = 0x00000001
-NETINFO_DISKRED = 0x00000004
-NETINFO_PRINTERRED = 0x00000008
-RP_LOGON = 0x01
-RP_INIFILE = 0x02
-PP_DISPLAYERRORS = 0x01
-WNCON_FORNETCARD = 0x00000001
-WNCON_NOTROUTED = 0x00000002
-WNCON_SLOWLINK = 0x00000004
-WNCON_DYNAMIC = 0x00000008
diff --git a/lib/win32/Demos/winprocess.py b/lib/win32/Demos/winprocess.py
deleted file mode 100644
index 48f6fe71..00000000
--- a/lib/win32/Demos/winprocess.py
+++ /dev/null
@@ -1,230 +0,0 @@
-"""
-Windows Process Control
-
-winprocess.run launches a child process and returns the exit code.
-Optionally, it can:
-  redirect stdin, stdout & stderr to files
-  run the command as another user
-  limit the process's running time
-  control the process window (location, size, window state, desktop)
-Works on Windows NT, 2000 & XP. Requires Mark Hammond's win32
-extensions.
-
-This code is free for any purpose, with no warranty of any kind.
--- John B. Dell'Aquila <jbd@alum.mit.edu>
-"""
-
-import msvcrt
-import os
-
-import win32api
-import win32con
-import win32event
-import win32gui
-import win32process
-import win32security
-
-
-def logonUser(loginString):
-    """
-    Login as specified user and return handle.
-    loginString:  'Domain\nUser\nPassword'; for local
-        login use . or empty string as domain
-        e.g. '.\nadministrator\nsecret_password'
-    """
-    domain, user, passwd = loginString.split("\n")
-    return win32security.LogonUser(
-        user,
-        domain,
-        passwd,
-        win32con.LOGON32_LOGON_INTERACTIVE,
-        win32con.LOGON32_PROVIDER_DEFAULT,
-    )
-
-
-class Process:
-    """
-    A Windows process.
-    """
-
-    def __init__(
-        self,
-        cmd,
-        login=None,
-        hStdin=None,
-        hStdout=None,
-        hStderr=None,
-        show=1,
-        xy=None,
-        xySize=None,
-        desktop=None,
-    ):
-        """
-        Create a Windows process.
-        cmd:     command to run
-        login:   run as user 'Domain\nUser\nPassword'
-        hStdin, hStdout, hStderr:
-                 handles for process I/O; default is caller's stdin,
-                 stdout & stderr
-        show:    wShowWindow (0=SW_HIDE, 1=SW_NORMAL, ...)
-        xy:      window offset (x, y) of upper left corner in pixels
-        xySize:  window size (width, height) in pixels
-        desktop: lpDesktop - name of desktop e.g. 'winsta0\\default'
-                 None = inherit current desktop
-                 '' = create new desktop if necessary
-
-        User calling login requires additional privileges:
-          Act as part of the operating system [not needed on Windows XP]
-          Increase quotas
-          Replace a process level token
-        Login string must EITHER be an administrator's account
-        (ordinary user can't access current desktop - see Microsoft
-        Q165194) OR use desktop='' to run another desktop invisibly
-        (may be very slow to startup & finalize).
-        """
-        si = win32process.STARTUPINFO()
-        si.dwFlags = win32con.STARTF_USESTDHANDLES ^ win32con.STARTF_USESHOWWINDOW
-        if hStdin is None:
-            si.hStdInput = win32api.GetStdHandle(win32api.STD_INPUT_HANDLE)
-        else:
-            si.hStdInput = hStdin
-        if hStdout is None:
-            si.hStdOutput = win32api.GetStdHandle(win32api.STD_OUTPUT_HANDLE)
-        else:
-            si.hStdOutput = hStdout
-        if hStderr is None:
-            si.hStdError = win32api.GetStdHandle(win32api.STD_ERROR_HANDLE)
-        else:
-            si.hStdError = hStderr
-        si.wShowWindow = show
-        if xy is not None:
-            si.dwX, si.dwY = xy
-            si.dwFlags ^= win32con.STARTF_USEPOSITION
-        if xySize is not None:
-            si.dwXSize, si.dwYSize = xySize
-            si.dwFlags ^= win32con.STARTF_USESIZE
-        if desktop is not None:
-            si.lpDesktop = desktop
-        procArgs = (
-            None,  # appName
-            cmd,  # commandLine
-            None,  # processAttributes
-            None,  # threadAttributes
-            1,  # bInheritHandles
-            win32process.CREATE_NEW_CONSOLE,  # dwCreationFlags
-            None,  # newEnvironment
-            None,  # currentDirectory
-            si,
-        )  # startupinfo
-        if login is not None:
-            hUser = logonUser(login)
-            win32security.ImpersonateLoggedOnUser(hUser)
-            procHandles = win32process.CreateProcessAsUser(hUser, *procArgs)
-            win32security.RevertToSelf()
-        else:
-            procHandles = win32process.CreateProcess(*procArgs)
-        self.hProcess, self.hThread, self.PId, self.TId = procHandles
-
-    def wait(self, mSec=None):
-        """
-        Wait for process to finish or for specified number of
-        milliseconds to elapse.
-        """
-        if mSec is None:
-            mSec = win32event.INFINITE
-        return win32event.WaitForSingleObject(self.hProcess, mSec)
-
-    def kill(self, gracePeriod=5000):
-        """
-        Kill process. Try for an orderly shutdown via WM_CLOSE.  If
-        still running after gracePeriod (5 sec. default), terminate.
-        """
-        win32gui.EnumWindows(self.__close__, 0)
-        if self.wait(gracePeriod) != win32event.WAIT_OBJECT_0:
-            win32process.TerminateProcess(self.hProcess, 0)
-            win32api.Sleep(100)  # wait for resources to be released
-
-    def __close__(self, hwnd, dummy):
-        """
-        EnumWindows callback - sends WM_CLOSE to any window
-        owned by this process.
-        """
-        TId, PId = win32process.GetWindowThreadProcessId(hwnd)
-        if PId == self.PId:
-            win32gui.PostMessage(hwnd, win32con.WM_CLOSE, 0, 0)
-
-    def exitCode(self):
-        """
-        Return process exit code.
-        """
-        return win32process.GetExitCodeProcess(self.hProcess)
-
-
-def run(cmd, mSec=None, stdin=None, stdout=None, stderr=None, **kw):
-    """
-    Run cmd as a child process and return exit code.
-    mSec:  terminate cmd after specified number of milliseconds
-    stdin, stdout, stderr:
-           file objects for child I/O (use hStdin etc. to attach
-           handles instead of files); default is caller's stdin,
-           stdout & stderr;
-    kw:    see Process.__init__ for more keyword options
-    """
-    if stdin is not None:
-        kw["hStdin"] = msvcrt.get_osfhandle(stdin.fileno())
-    if stdout is not None:
-        kw["hStdout"] = msvcrt.get_osfhandle(stdout.fileno())
-    if stderr is not None:
-        kw["hStderr"] = msvcrt.get_osfhandle(stderr.fileno())
-    child = Process(cmd, **kw)
-    if child.wait(mSec) != win32event.WAIT_OBJECT_0:
-        child.kill()
-        raise WindowsError("process timeout exceeded")
-    return child.exitCode()
-
-
-if __name__ == "__main__":
-    # Pipe commands to a shell and display the output in notepad
-    print("Testing winprocess.py...")
-
-    import tempfile
-
-    timeoutSeconds = 15
-    cmdString = (
-        """\
-REM      Test of winprocess.py piping commands to a shell.\r
-REM      This 'notepad' process will terminate in %d seconds.\r
-vol\r
-net user\r
-_this_is_a_test_of_stderr_\r
-"""
-        % timeoutSeconds
-    )
-
-    cmd_name = tempfile.mktemp()
-    out_name = cmd_name + ".txt"
-    try:
-        cmd = open(cmd_name, "w+b")
-        out = open(out_name, "w+b")
-        cmd.write(cmdString.encode("mbcs"))
-        cmd.seek(0)
-        print(
-            "CMD.EXE exit code:",
-            run("cmd.exe", show=0, stdin=cmd, stdout=out, stderr=out),
-        )
-        cmd.close()
-        print(
-            "NOTEPAD exit code:",
-            run(
-                "notepad.exe %s" % out.name,
-                show=win32con.SW_MAXIMIZE,
-                mSec=timeoutSeconds * 1000,
-            ),
-        )
-        out.close()
-    finally:
-        for n in (cmd_name, out_name):
-            try:
-                os.unlink(cmd_name)
-            except os.error:
-                pass
diff --git a/lib/win32/include/PyWinTypes.h b/lib/win32/include/PyWinTypes.h
deleted file mode 100644
index edfdb0b6..00000000
--- a/lib/win32/include/PyWinTypes.h
+++ /dev/null
@@ -1,727 +0,0 @@
-
-#ifndef __PYWINTYPES_H__
-#define __PYWINTYPES_H__
-
-// If building under a GCC, tweak what we need.
-#if defined(__GNUC__) && defined(_POSIX_C_SOURCE)
-// python.h complains if _POSIX_C_SOURCE is already defined
-#undef _POSIX_C_SOURCE
-#endif
-
-// windows rpc.h defines "small" as "char" which breaks Python's accu.h,
-// so we undefine it before including python.
-#ifdef small
-#undef small
-#endif
-
-#include "Python.h"
-#include "structmember.h"
-#include "windows.h"
-
-// Helpers for our modules.
-// Some macros to help the pywin32 modules co-exist in py2x and py3k.
-// Creates and initializes local variables called 'module' and 'dict'.
-
-// Maybe these should all be removed - they existed to help in the py2->3
-// transition.
-// On one hand: the code would be cleaner if they were all just re-inlined?
-// On the other: high confidence everything uses the exact same patterns?
-// (Regardless, *some*, eg, PYWIN_MODULE_INIT_RETURN_* should be re-inlined!)
-
-// Use to define the function itself (ie, its name, linkage, params)
-#define PYWIN_MODULE_INIT_FUNC(module_name) extern "C" __declspec(dllexport) PyObject *PyInit_##module_name(void)
-
-// If the module needs to early-exit on an error condition.
-#define PYWIN_MODULE_INIT_RETURN_ERROR return NULL;
-
-// When the module has successfully initialized.
-#define PYWIN_MODULE_INIT_RETURN_SUCCESS return module;
-
-// To setup the module object itself and the module's dictionary.
-#define PYWIN_MODULE_INIT_PREPARE(module_name, functions, docstring)                                        \
-    PyObject *dict, *module;                                                                                \
-    static PyModuleDef module_name##_def = {PyModuleDef_HEAD_INIT, #module_name, docstring, -1, functions}; \
-    if (PyWinGlobals_Ensure() == -1)                                                                        \
-        return NULL;                                                                                        \
-    if (!(module = PyModule_Create(&module_name##_def)))                                                    \
-        return NULL;                                                                                        \
-    if (!(dict = PyModule_GetDict(module)))                                                                 \
-        return NULL;
-
-// Helpers for our types.
-// Macro to handle PyObject layout changes in Py3k
-#define PYWIN_OBJECT_HEAD PyVarObject_HEAD_INIT(NULL, 0)
-
-/* Attribute names are passed as Unicode in Py3k, so use a macro to
-    switch between string and unicode conversion.  This function is not
-    documented, but is used extensively in the Python codebase itself,
-    so it's reasonable to assume it won't disappear anytime soon.
-*/
-#define PYWIN_ATTR_CONVERT (char *)_PyUnicode_AsString
-
-typedef Py_ssize_t Py_hash_t;
-
-// This only enables runtime checks in debug builds - so we use
-// our own so we can enable it always should we desire...
-#define PyWin_SAFE_DOWNCAST Py_SAFE_DOWNCAST
-
-// Lars: for WAVEFORMATEX
-#include "mmsystem.h"
-
-#ifdef BUILD_PYWINTYPES
-/* We are building pywintypesxx.dll */
-#define PYWINTYPES_EXPORT __declspec(dllexport)
-#else
-/* This module uses pywintypesxx.dll */
-#define PYWINTYPES_EXPORT __declspec(dllimport)
-#if defined(_MSC_VER)
-#if defined(DEBUG) || defined(_DEBUG)
-#pragma comment(lib, "pywintypes_d.lib")
-#else
-#pragma comment(lib, "pywintypes.lib")
-#endif  // DEBUG/_DEBUG
-#endif  // _MSC_VER
-#endif  // BUILD_PYWINTYPES
-
-// Py3k uses memoryview object in place of buffer, and we don't yet.
-extern PYWINTYPES_EXPORT PyObject *PyBuffer_New(Py_ssize_t size);
-extern PYWINTYPES_EXPORT PyObject *PyBuffer_FromMemory(void *buf, Py_ssize_t size);
-
-// Formats a python traceback into a character string - result must be free()ed
-PYWINTYPES_EXPORT WCHAR *GetPythonTraceback(PyObject *exc_type, PyObject *exc_value, PyObject *exc_tb);
-
-#include <tchar.h>
-/*
-** Error/Exception handling
-*/
-extern PYWINTYPES_EXPORT PyObject *PyWinExc_ApiError;
-// Register a Windows DLL that contains the messages in the specified range.
-extern PYWINTYPES_EXPORT BOOL PyWin_RegisterErrorMessageModule(DWORD first, DWORD last, HINSTANCE hmod);
-// Get the previously registered hmodule for an error code.
-extern PYWINTYPES_EXPORT HINSTANCE PyWin_GetErrorMessageModule(DWORD err);
-
-/* A global function that sets an API style error (ie, (code, fn, errTest)) */
-PYWINTYPES_EXPORT PyObject *PyWin_SetAPIError(char *fnName, long err = 0);
-
-/* Basic COM Exception handling.  The main COM exception object
-   is actually defined here.  However, the most useful functions
-   for raising the exception are still in the COM package.  Therefore,
-   you can use the fn below to raise a basic COM exception - no fancy error
-   messages available, just the HRESULT.  It will, however, _be_ a COM
-   exception, and therefore trappable like any other COM exception
-*/
-extern PYWINTYPES_EXPORT PyObject *PyWinExc_COMError;
-PYWINTYPES_EXPORT PyObject *PyWin_SetBasicCOMError(HRESULT hr);
-
-// *************
-// strings, which are a bit of a mess!
-//
-// This has gone from 2.x ascii-only, to 2.x+3.x ascii-or-unicode, to 3.x unicode-only,
-// - this baggage means some strange APIs which convert to and from "char *" in various ways.
-//
-// A sizes/lengths are reported as a `DWORD` rather than a `Py_ssize_t`, that's what the callers
-// need. `Py_ssize_t` used as the "in" type.
-// (We also use this for UINT and ULONG, all of which are 32bit unsigned ints.)
-
-// Sometimes we need to downcast from a ssize_t to a DWORD
-inline bool PyWin_is_ssize_dword(Py_ssize_t val) {
-    return val <= MAXDWORD;
-}
-
-#define PYWIN_CHECK_SSIZE_DWORD(val, failResult) \
-    if (!PyWin_is_ssize_dword(val)) { \
-        PyErr_SetString(PyExc_ValueError, "value is larger than a DWORD"); \
-        return failResult; \
-    }
-
-// Almost all of these are roughly identical! But start with BSTR
-// Given a PyObject (string, Unicode, etc) create a "BSTR" with the value
-PYWINTYPES_EXPORT BOOL PyWinObject_AsBstr(PyObject *stringObject, BSTR *pResult, BOOL bNoneOK = FALSE,
-                                          DWORD *pResultLen = NULL);
-// And free it when finished.
-PYWINTYPES_EXPORT void PyWinObject_FreeBstr(BSTR pResult);
-
-PYWINTYPES_EXPORT PyObject *PyWinObject_FromBstr(const BSTR bstr, BOOL takeOwnership = FALSE);
-
-// Given a string or Unicode object, get WCHAR characters.
-PYWINTYPES_EXPORT BOOL PyWinObject_AsWCHAR(PyObject *stringObject, WCHAR **pResult, BOOL bNoneOK = FALSE,
-                                           DWORD *pResultLen = NULL);
-// And free it when finished.
-PYWINTYPES_EXPORT void PyWinObject_FreeWCHAR(WCHAR *pResult);
-
-inline BOOL PyWinObject_AsWCHAR(PyObject *stringObject, unsigned short **pResult, BOOL bNoneOK = FALSE,
-                                DWORD *pResultLen = NULL)
-{
-    return PyWinObject_AsWCHAR(stringObject, (WCHAR **)pResult, bNoneOK, pResultLen);
-}
-inline void PyWinObject_FreeWCHAR(unsigned short *pResult) { PyWinObject_FreeWCHAR((WCHAR *)pResult); }
-
-// A bit unfortunate, but used when we logically want a "string" but only have
-// a "char *" to put it in.
-// * accepts bytes but boesn't try to accept buffer-like objects.
-// * accepts unicode objects and converts via the code-page.
-PYWINTYPES_EXPORT BOOL PyWinObject_AsChars(PyObject *stringObject, char **pResult, BOOL bNoneOK = FALSE,
-                                           DWORD *pResultLen = NULL);
-// And free it when finished.
-PYWINTYPES_EXPORT void PyWinObject_FreeChars(char *pResult);
-
-// Automatically freed WCHAR that can be used anywhere WCHAR * is required
-class TmpWCHAR {
-   public:
-    WCHAR *tmp;  // (NULL after conversion error)
-    Py_ssize_t length;  // only set after successful auto-conversion; w/o trailing \0
-    PyObject *u;        // auxiliary slot for u2w()
-
-    TmpWCHAR() { tmp = NULL; }
-    TmpWCHAR(WCHAR *t) { tmp = t; }
-    TmpWCHAR(PyObject *ob) : tmp(NULL) { *this = ob; }
-    WCHAR *u2w() { return *this = u; }
-    WCHAR *operator=(PyObject *ob) {
-        if (tmp)
-            PyMem_Free(tmp);
-        if (ob == NULL)
-            tmp = NULL;  // (exception already has been set in this case)
-        else
-            tmp = PyUnicode_AsWideCharString(ob, &length);
-        return tmp;
-    }
-    WCHAR *operator=(WCHAR *t)
-    {
-        if (tmp)
-            PyMem_Free(tmp);
-        tmp = t;
-        return t;
-    }
-    WCHAR **operator&() { return &tmp; }
-    boolean operator==(WCHAR *t) { return tmp == t; }
-    operator WCHAR *() { return tmp; }
-    ~TmpWCHAR() { if (tmp) PyMem_Free(tmp); }
-   private:
-    // Block unwanted copy construction
-    TmpWCHAR(const TmpWCHAR& o);  // = delete;
-    const TmpWCHAR& operator=(const TmpWCHAR& o);  // = delete;
-};
-
-// More string helpers - how many do we need?
-// A couple which should die or be modernized and have some `char *` vs `wchar_t *` confusion.
-PYWINTYPES_EXPORT PyObject *PyWinCoreString_FromString(const char *str, Py_ssize_t len = (Py_ssize_t)-1);
-PYWINTYPES_EXPORT PyObject *PyWinCoreString_FromString(const WCHAR *str, Py_ssize_t len = (Py_ssize_t)-1);
-
-#define PyWinObject_FromWCHAR PyWinObject_FromOLECHAR
-
-PYWINTYPES_EXPORT PyObject *PyWinObject_FromOLECHAR(const OLECHAR *str);
-PYWINTYPES_EXPORT PyObject *PyWinObject_FromOLECHAR(const OLECHAR *str, Py_ssize_t numChars);
-
-#define PyWinObject_AsTCHAR PyWinObject_AsWCHAR
-#define PyWinObject_FreeTCHAR PyWinObject_FreeWCHAR
-#define PyWinObject_FromTCHAR PyWinObject_FromOLECHAR
-
-// String support for buffers allocated via CoTaskMemAlloc and CoTaskMemFree
-PYWINTYPES_EXPORT BOOL PyWinObject_AsTaskAllocatedWCHAR(PyObject *stringObject, WCHAR **ppResult, BOOL bNoneOK = FALSE);
-PYWINTYPES_EXPORT void PyWinObject_FreeTaskAllocatedWCHAR(WCHAR *str);
-
-// Copy null terminated string with same allocator as PyWinObject_AsWCHAR, etc
-// ? wot?
-PYWINTYPES_EXPORT WCHAR *PyWin_CopyString(const WCHAR *input);
-PYWINTYPES_EXPORT char *PyWin_CopyString(const char *input);
-
-// Some helpers for arrays of strings.
-//
-// Converts a series of consecutive null terminated strings into a list
-// ??? wot?
-PYWINTYPES_EXPORT PyObject *PyWinObject_FromMultipleString(WCHAR *multistring);
-PYWINTYPES_EXPORT PyObject *PyWinObject_FromMultipleString(char *multistring);
-// Converts a sequence of str/unicode objects into a series of consecutive null-terminated
-//	wide character strings with extra terminating null
-PYWINTYPES_EXPORT BOOL PyWinObject_AsMultipleString(PyObject *ob, WCHAR **pmultistring, BOOL bNoneOK = TRUE,
-                                                    DWORD *chars_returned = NULL);
-PYWINTYPES_EXPORT void PyWinObject_FreeMultipleString(WCHAR *pmultistring);
-
-// Convert a sequence of strings to an array of WCHAR pointers
-PYWINTYPES_EXPORT void PyWinObject_FreeWCHARArray(LPWSTR *wchars, DWORD str_cnt);
-PYWINTYPES_EXPORT BOOL PyWinObject_AsWCHARArray(PyObject *str_seq, LPWSTR **wchars, DWORD *str_cnt,
-                                                BOOL bNoneOK = FALSE);
-
-// Convert a sequence of string or unicode objects to an array of char *
-PYWINTYPES_EXPORT void PyWinObject_FreeCharArray(char **pchars, DWORD str_cnt);
-PYWINTYPES_EXPORT BOOL PyWinObject_AsCharArray(PyObject *str_seq, char ***pchars, DWORD *str_cnt, BOOL bNoneOK = FALSE);
-
-// Bytes/Buffer helpers.
-// replacement for PyWinObject_AsReadBuffer and PyWinObject_AsWriteBuffer
-class PYWINTYPES_EXPORT PyWinBufferView
-{
-public:
-    PyWinBufferView() { m_view.obj = NULL; }
-    PyWinBufferView(PyObject *ob, bool bWrite = false, bool bNoneOk = false) {
-        m_view.obj = NULL;
-        init(ob, bWrite, bNoneOk);
-    }
-    ~PyWinBufferView() { release(); }
-    bool init(PyObject *ob, bool bWrite = false, bool bNoneOk = false);
-    void release() {
-        if (m_view.obj != NULL && m_view.obj != Py_None) {
-            PyBuffer_Release(&m_view);  // sets view->obj = NULL
-        }
-    }
-    bool ok() { return m_view.obj != NULL; }
-    void* ptr() { return m_view.buf; }
-    DWORD len() { return static_cast<DWORD>(m_view.len); }
-
-private:
-    Py_buffer m_view;
-
-    // don't copy objects and don't use C++ >= 11 -> not implemented private
-    // copy ctor and assignment operator
-    PyWinBufferView(const PyWinBufferView& src);
-    PyWinBufferView& operator=(PyWinBufferView const &);
-};
-
-
-// For 64-bit python compatibility, convert sequence to tuple and check length fits in a DWORD
-PYWINTYPES_EXPORT PyObject *PyWinSequence_Tuple(PyObject *obseq, DWORD *len);
-
-// Pointers.
-// Substitute for Python's inconsistent PyLong_AsVoidPtr
-PYWINTYPES_EXPORT BOOL PyWinLong_AsVoidPtr(PyObject *ob, void **pptr);
-PYWINTYPES_EXPORT PyObject *PyWinLong_FromVoidPtr(const void *ptr);
-
-/*
-** LARGE_INTEGER objects
-*/
-// AsLARGE_INTEGER takes either int or long
-PYWINTYPES_EXPORT BOOL PyWinObject_AsLARGE_INTEGER(PyObject *ob, LARGE_INTEGER *pResult);
-PYWINTYPES_EXPORT BOOL PyWinObject_AsULARGE_INTEGER(PyObject *ob, ULARGE_INTEGER *pResult);
-PYWINTYPES_EXPORT PyObject *PyWinObject_FromLARGE_INTEGER(const LARGE_INTEGER &val);
-PYWINTYPES_EXPORT PyObject *PyWinObject_FromULARGE_INTEGER(const ULARGE_INTEGER &val);
-// Helpers that take a Py_LONG_LONG, but (a) have pywin32 consistent signatures
-// and (b) handle int *and* long (where Python only starts doing that in the
-// PyLong_* APIs post 2.4)
-// We also happen to know a LARGE_INTEGER is an __int64, so do it the easy way
-#define PyWinObject_AsPY_LONG_LONG(ob, pResult) PyWinObject_AsLARGE_INTEGER((ob), (LARGE_INTEGER *)(pResult))
-#define PyWinObject_AsUPY_LONG_LONG(ob, pResult) PyWinObject_AsULARGE_INTEGER((ob), (ULARGE_INTEGER *)(pResult))
-#define PyWinObject_FromPY_LONG_LONG(val) PyWinObject_FromLARGE_INTEGER((LARGE_INTEGER)val)
-#define PyWinObject_FromUPY_LONG_LONG(val) PyWinObject_FromULARGE_INTEGER((ULARGE_INTEGER)val)
-
-// A DWORD_PTR and ULONG_PTR appear to mean "integer long enough to hold a pointer"
-// It is *not* actually a pointer (but is the same size as a pointer)
-inline PyObject *PyWinObject_FromULONG_PTR(ULONG_PTR v) { return PyWinLong_FromVoidPtr((void *)v); }
-inline BOOL PyWinLong_AsULONG_PTR(PyObject *ob, ULONG_PTR *r) { return PyWinLong_AsVoidPtr(ob, (void **)r); }
-
-inline PyObject *PyWinObject_FromDWORD_PTR(DWORD_PTR v) { return PyLong_FromVoidPtr((void *)v); }
-inline BOOL PyWinLong_AsDWORD_PTR(PyObject *ob, DWORD_PTR *r) { return PyWinLong_AsVoidPtr(ob, (void **)r); }
-
-/*
-** OVERLAPPED Object and API
-*/
-class PyOVERLAPPED;                                      // forward declare
-extern PYWINTYPES_EXPORT PyTypeObject PyOVERLAPPEDType;  // the Type for PyOVERLAPPED
-#define PyOVERLAPPED_Check(ob) ((ob)->ob_type == &PyOVERLAPPEDType)
-PYWINTYPES_EXPORT BOOL PyWinObject_AsOVERLAPPED(PyObject *ob, OVERLAPPED **ppOverlapped, BOOL bNoneOK = TRUE);
-PYWINTYPES_EXPORT BOOL PyWinObject_AsPyOVERLAPPED(PyObject *ob, PyOVERLAPPED **ppOverlapped, BOOL bNoneOK = TRUE);
-PYWINTYPES_EXPORT PyObject *PyWinObject_FromOVERLAPPED(const OVERLAPPED *pOverlapped);
-
-// A global function that can work as a module method for making an OVERLAPPED object.
-PYWINTYPES_EXPORT PyObject *PyWinMethod_NewOVERLAPPED(PyObject *self, PyObject *args);
-
-#ifndef NO_PYWINTYPES_IID
-/*
-** IID/GUID support
-*/
-
-extern PYWINTYPES_EXPORT PyTypeObject PyIIDType;  // the Type for PyIID
-#define PyIID_Check(ob) ((ob)->ob_type == &PyIIDType)
-
-// Given an object repring a CLSID (either PyIID or string), fill the CLSID.
-PYWINTYPES_EXPORT BOOL PyWinObject_AsIID(PyObject *obCLSID, CLSID *clsid);
-
-// return a native PyIID object representing an IID
-PYWINTYPES_EXPORT PyObject *PyWinObject_FromIID(const IID &riid);
-
-// return a string/Unicode object representing an IID
-PYWINTYPES_EXPORT PyObject *PyWinCoreString_FromIID(const IID &riid);
-
-// A global function that can work as a module method for making an IID object.
-PYWINTYPES_EXPORT PyObject *PyWinMethod_NewIID(PyObject *self, PyObject *args);
-#endif /*NO_PYWINTYPES_IID */
-
-/*
-** TIME support
-**
-** We use a subclass of the builtin datetime.
-*/
-
-PYWINTYPES_EXPORT PyObject *PyWinObject_FromSYSTEMTIME(const SYSTEMTIME &t);
-PYWINTYPES_EXPORT PyObject *PyWinObject_FromFILETIME(const FILETIME &t);
-
-// Converts a TimeStamp, which is in 100 nanosecond units like a FILETIME
-// TimeStamp is actually defined as a LARGE_INTEGER, so this function will also
-// accept Windows security "TimeStamp" objects directly - however, we use a
-// LARGE_INTEGER prototype to avoid pulling in the windows security headers.
-PYWINTYPES_EXPORT PyObject *PyWinObject_FromTimeStamp(const LARGE_INTEGER &t);
-PYWINTYPES_EXPORT PyObject *PyWinTimeObject_Fromtime_t(time_t t);
-PYWINTYPES_EXPORT PyObject *PyWinObject_FromDATE(DATE t);
-
-PYWINTYPES_EXPORT BOOL PyWinObject_AsDATE(PyObject *ob, DATE *pDate);
-PYWINTYPES_EXPORT BOOL PyWinObject_AsFILETIME(PyObject *ob, FILETIME *pDate);
-PYWINTYPES_EXPORT BOOL PyWinObject_AsSYSTEMTIME(PyObject *ob, SYSTEMTIME *pDate);
-
-// A global function that can work as a module method for making a time object.
-PYWINTYPES_EXPORT PyObject *PyWinMethod_NewTime(PyObject *self, PyObject *args);
-PYWINTYPES_EXPORT PyObject *PyWinMethod_NewTimeStamp(PyObject *self, PyObject *args);
-
-PYWINTYPES_EXPORT BOOL PyWinTime_Check(PyObject *ob);
-
-// functions to return WIN32_FIND_DATA tuples, used in shell, win32api, and win32file
-PYWINTYPES_EXPORT PyObject *PyObject_FromWIN32_FIND_DATAW(WIN32_FIND_DATAW *pData);
-#define PyObject_FromWIN32_FIND_DATA PyObject_FromWIN32_FIND_DATAW
-
-// POINT tuple, used in win32api_display.cpp and win32gui.i
-PYWINTYPES_EXPORT BOOL PyWinObject_AsPOINT(PyObject *obpoint, LPPOINT ppoint);
-
-// IO_COUNTERS dict, used in win32process and win32job
-PYWINTYPES_EXPORT PyObject *PyWinObject_FromIO_COUNTERS(PIO_COUNTERS pioc);
-
-// Make an array of DWORD's from a sequence of Python ints
-PYWINTYPES_EXPORT BOOL PyWinObject_AsDWORDArray(PyObject *obdwords, DWORD **pdwords, DWORD *item_cnt,
-                                                BOOL bNoneOk = TRUE);
-
-// Conversion for resource id/name and class atom
-PYWINTYPES_EXPORT BOOL PyWinObject_AsResourceIdA(PyObject *ob, char **presource_id, BOOL bNoneOK = FALSE);
-PYWINTYPES_EXPORT void PyWinObject_FreeResourceIdA(char *resource_id);
-
-PYWINTYPES_EXPORT BOOL PyWinObject_AsResourceId(PyObject *ob, WCHAR **presource_id, BOOL bNoneOK = FALSE);
-PYWINTYPES_EXPORT void PyWinObject_FreeResourceId(WCHAR *resource_id);
-
-// WPARAM and LPARAM conversion.
-// Auto-freed WPARAM / LPARAM which ensure any memory referenced remains valid when a String or
-// Buffer object is used. Make sure the destructor is called with the GIL held.
-class PyWin_PARAMHolder {
-  protected:
-    WPARAM _pa;
-    // Holds *either* a PyWinBufferView (which will auto-free) *or* a "void *" that we
-    // will auto-free.
-    void *_pymem;
-    void _free() {
-        if (_pymem) {
-            PyMem_Free(_pymem);
-            _pymem = NULL;
-        }
-    }
-  public:
-    PyWinBufferView bufferView;
-
-    PyWin_PARAMHolder(WPARAM t=0):_pa(t),_pymem(NULL) {}
-    ~PyWin_PARAMHolder() {
-        _free();
-    }
-    WCHAR *set_allocated(WCHAR *t) {
-        assert(!bufferView.ok()); // should be one or the other.
-        _free();
-        _pymem = t;
-        _pa = (WPARAM)t;
-        return t;
-    }
-    // When init_buffer() fails, an appropriate Python error has been set too
-    bool init_buffer(PyObject *ob) {
-        assert(!_pymem); // should be one or the other!
-        _free();
-        if (!bufferView.init(ob)) {
-            return false;
-        }
-        _pa = (WPARAM)bufferView.ptr();
-        return true;
-    }
-
-    WPARAM operator=(WPARAM t) {
-        return _pa = t;
-    }
-    operator WPARAM() { return _pa; }
-    operator LPARAM() { return (LPARAM)_pa; }
-};
-
-PYWINTYPES_EXPORT BOOL PyWinObject_AsPARAM(PyObject *ob, PyWin_PARAMHolder *pparam);
-inline PyObject *PyWinObject_FromPARAM(WPARAM param) { return PyWinObject_FromULONG_PTR(param); }
-inline PyObject *PyWinObject_FromPARAM(LPARAM param) { return PyWinObject_FromULONG_PTR(param); }
-
-PYWINTYPES_EXPORT BOOL PyWinObject_AsSimplePARAM(PyObject *ob, WPARAM *pparam);
-inline BOOL PyWinObject_AsSimplePARAM(PyObject *ob, LPARAM *pparam) { return PyWinObject_AsSimplePARAM(ob, (WPARAM *)pparam); }
-
-// RECT conversions
-// @object PyRECT|Tuple of 4 ints defining a rectangle: (left, top, right, bottom)
-PYWINTYPES_EXPORT BOOL PyWinObject_AsRECT(PyObject *obrect, LPRECT prect);
-PYWINTYPES_EXPORT PyObject *PyWinObject_FromRECT(LPRECT prect);
-
-/*
-** SECURITY_ATTRIBUTES support
-*/
-extern PYWINTYPES_EXPORT PyTypeObject PySECURITY_ATTRIBUTESType;
-#define PySECURITY_ATTRIBUTES_Check(ob) ((ob)->ob_type == &PySECURITY_ATTRIBUTESType)
-extern PYWINTYPES_EXPORT PyTypeObject PyDEVMODEWType;
-
-PYWINTYPES_EXPORT PyObject *PyWinMethod_NewSECURITY_ATTRIBUTES(PyObject *self, PyObject *args);
-PYWINTYPES_EXPORT BOOL PyWinObject_AsSECURITY_ATTRIBUTES(PyObject *ob, SECURITY_ATTRIBUTES **ppSECURITY_ATTRIBUTES,
-                                                         BOOL bNoneOK = TRUE);
-PYWINTYPES_EXPORT PyObject *PyWinObject_FromSECURITY_ATTRIBUTES(const SECURITY_ATTRIBUTES &sa);
-PYWINTYPES_EXPORT BOOL PyWinObject_AsDEVMODE(PyObject *ob, PDEVMODEW *ppDEVMODE, BOOL bNoneOK);
-PYWINTYPES_EXPORT PyObject *PyWinObject_FromDEVMODE(PDEVMODEW);
-
-/*
-** WAVEFORMATEX support
-*/
-
-PYWINTYPES_EXPORT PyObject *PyWinMethod_NewWAVEFORMATEX(PyObject *self, PyObject *args);
-PYWINTYPES_EXPORT PyObject *PyWinObject_FromWAVEFROMATEX(const WAVEFORMATEX &wfx);
-PYWINTYPES_EXPORT BOOL PyWinObject_AsWAVEFORMATEX(PyObject *ob, WAVEFORMATEX **ppWAVEFORMATEX, BOOL bNoneOK = TRUE);
-extern PYWINTYPES_EXPORT PyTypeObject PyWAVEFORMATEXType;
-#define PyWAVEFORMATEX_Check(ob) ((ob)->ob_type == &PyWAVEFORMATEXType)
-
-/*
-** SECURITY_DESCRIPTOR support
-*/
-extern PYWINTYPES_EXPORT PyTypeObject PySECURITY_DESCRIPTORType;
-#define PySECURITY_DESCRIPTOR_Check(ob) ((ob)->ob_type == &PySECURITY_DESCRIPTORType)
-
-PYWINTYPES_EXPORT PyObject *PyWinMethod_NewSECURITY_DESCRIPTOR(PyObject *self, PyObject *args);
-PYWINTYPES_EXPORT BOOL PyWinObject_AsSECURITY_DESCRIPTOR(PyObject *ob, PSECURITY_DESCRIPTOR *ppSECURITY_DESCRIPTOR,
-                                                         BOOL bNoneOK = TRUE);
-PYWINTYPES_EXPORT PyObject *PyWinObject_FromSECURITY_DESCRIPTOR(PSECURITY_DESCRIPTOR psd);
-
-PYWINTYPES_EXPORT BOOL _MakeAbsoluteSD(PSECURITY_DESCRIPTOR psd_relative, PSECURITY_DESCRIPTOR *ppsd_absolute);
-PYWINTYPES_EXPORT void FreeAbsoluteSD(PSECURITY_DESCRIPTOR psd);
-
-/*
-** SID support
-*/
-extern PYWINTYPES_EXPORT PyTypeObject PySIDType;
-#define PySID_Check(ob) ((ob)->ob_type == &PySIDType)
-
-PYWINTYPES_EXPORT PyObject *PyWinMethod_NewSID(PyObject *self, PyObject *args);
-PYWINTYPES_EXPORT BOOL PyWinObject_AsSID(PyObject *ob, PSID *ppSID, BOOL bNoneOK = FALSE);
-PYWINTYPES_EXPORT PyObject *PyWinObject_FromSID(PSID pSID);
-
-/*
-** ACL support
-*/
-extern PYWINTYPES_EXPORT PyTypeObject PyACLType;
-#define PyACL_Check(ob) ((ob)->ob_type == &PyACLType)
-
-PYWINTYPES_EXPORT PyObject *PyWinMethod_NewACL(PyObject *self, PyObject *args);
-PYWINTYPES_EXPORT BOOL PyWinObject_AsACL(PyObject *ob, PACL *ppACL, BOOL bNoneOK = FALSE);
-
-/*
-** Win32 HANDLE wrapper - any handle closable by "CloseHandle()"
-*/
-extern PYWINTYPES_EXPORT PyTypeObject PyHANDLEType;  // the Type for PyHANDLE
-#define PyHANDLE_Check(ob) ((ob)->ob_type == &PyHANDLEType)
-
-// Convert an object to a HANDLE - None is always OK, as are ints, etc.
-PYWINTYPES_EXPORT BOOL PyWinObject_AsHANDLE(PyObject *ob, HANDLE *pRes);
-// For handles that use PyHANDLE.
-PYWINTYPES_EXPORT PyObject *PyWinObject_FromHANDLE(HANDLE h);
-// For handles that aren't returned as PyHANDLE or a subclass thereof (HDC, HWND, etc).
-// Return as python ints or longs
-PYWINTYPES_EXPORT PyObject *PyWinLong_FromHANDLE(HANDLE h);
-
-// A global function that can work as a module method for making a HANDLE object.
-PYWINTYPES_EXPORT PyObject *PyWinMethod_NewHANDLE(PyObject *self, PyObject *args);
-
-// A global function that does the right thing wrt closing a "handle".
-// The object can be either a PyHANDLE or an integer.
-// If result is FALSE, a Python error is all setup (cf PyHANDLE::Close(), which doesnt set the Python error)
-PYWINTYPES_EXPORT BOOL PyWinObject_CloseHANDLE(PyObject *obHandle);
-
-PYWINTYPES_EXPORT BOOL PyWinObject_AsHKEY(PyObject *ob, HKEY *pRes);
-PYWINTYPES_EXPORT PyObject *PyWinObject_FromHKEY(HKEY h);
-PYWINTYPES_EXPORT BOOL PyWinObject_CloseHKEY(PyObject *obHandle);
-
-// MSG structure keeps coming up...
-PYWINTYPES_EXPORT BOOL PyWinObject_AsMSG(PyObject *ob, MSG *pMsg);
-PYWINTYPES_EXPORT PyObject *PyWinObject_FromMSG(const MSG *pMsg);
-
-#include "winsock.h"
-/*
-** SOCKET support.
-*/
-PYWINTYPES_EXPORT
-BOOL PySocket_AsSOCKET
-    //-------------------------------------------------------------------------
-    // Helper function for dealing with socket arguments.
-    (PyObject *obSocket,
-     // [in] Python object being converted into a SOCKET handle.
-     SOCKET *ps
-     // [out] Returned socket handle
-    );
-
-/*
-** Other Utilities
-*/
-// ----------------------------------------------------------------------
-// WARNING - NEVER EVER USE new() ON THIS CLASS
-// This class can be used as a local variable, typically in a Python/C
-// function, and can be passed whereever a TCHAR/WCHAR is expected.
-// Typical Usage:
-// PyWin_AutoFreeBstr arg;
-// PyArg_ParseTuple("O", &obStr);
-// PyWinObject_AsAutoFreeBstr(obStr, &arg);
-// CallTheFunction(arg); // Will correctly pass BSTR/OLECHAR
-// -- when the function goes out of scope, the string owned by "arg" will
-// -- automatically be freed.
-// ----------------------------------------------------------------------
-class PYWINTYPES_EXPORT PyWin_AutoFreeBstr {
-   public:
-    PyWin_AutoFreeBstr(BSTR bstr = NULL);
-    ~PyWin_AutoFreeBstr();
-    void SetBstr(BSTR bstr);
-    operator BSTR() { return m_bstr; }
-
-   private:
-    BSTR m_bstr;
-};
-
-inline BOOL PyWinObject_AsAutoFreeBstr(PyObject *stringObject, PyWin_AutoFreeBstr *pResult, BOOL bNoneOK = FALSE)
-{
-    if (bNoneOK && stringObject == Py_None) {
-        pResult->SetBstr(NULL);
-        return TRUE;
-    }
-    BSTR bs;
-    if (!PyWinObject_AsBstr(stringObject, &bs, bNoneOK))
-        return FALSE;
-    pResult->SetBstr(bs);
-    return TRUE;
-}
-
-// ----------------------------------------------------------------------
-//
-// THREAD MANAGEMENT
-//
-
-// ### need to rename the PYCOM_ stuff soon...
-
-// We have 2 discrete locks in use (when no free-threaded is used, anyway).
-// The first type of lock is the global Python lock.  This is the standard lock
-// in use by Python, and must be used as documented by Python.  Specifically, no
-// 2 threads may _ever_ call _any_ Python code (including INCREF/DECREF) without
-// first having this thread lock.
-//
-// The second type of lock is a "global framework lock".  This lock is simply a
-// critical section, and used whenever 2 threads of C code need access to global
-// data.  This is different than the Python lock - this lock is used when no Python
-// code can ever be called by the threads, but the C code still needs thread-safety.
-
-// We also supply helper classes which make the usage of these locks a one-liner.
-
-// The "framework" lock, implemented as a critical section.
-PYWINTYPES_EXPORT void PyWin_AcquireGlobalLock(void);
-PYWINTYPES_EXPORT void PyWin_ReleaseGlobalLock(void);
-
-// Helper class for the DLL global lock.
-//
-// This class magically waits for the Win32/COM framework global lock, and releases it
-// when finished.
-// NEVER new one of these objects - only use on the stack!
-class CEnterLeaveFramework {
-   public:
-    CEnterLeaveFramework() { PyWin_AcquireGlobalLock(); }
-    ~CEnterLeaveFramework() { PyWin_ReleaseGlobalLock(); }
-};
-
-// Python thread-lock stuff.  Free-threading patches use different semantics, but
-// these are abstracted away here...
-#ifndef FORCE_NO_FREE_THREAD
-#ifdef WITH_FREE_THREAD
-#define PYCOM_USE_FREE_THREAD
-#endif
-#endif
-#ifdef PYCOM_USE_FREE_THREAD
-#include <threadstate.h>
-#else
-#include <pystate.h>
-#endif
-
-// Helper class for Enter/Leave Python
-//
-// This class magically waits for the Python global lock, and releases it
-// when finished.
-
-// Nested invocations will deadlock, so be careful.
-
-// NEVER new one of these objects - only use on the stack!
-#ifndef PYCOM_USE_FREE_THREAD
-extern PYWINTYPES_EXPORT PyInterpreterState *PyWin_InterpreterState;
-extern PYWINTYPES_EXPORT BOOL PyWinThreadState_Ensure();
-extern PYWINTYPES_EXPORT void PyWinThreadState_Free();
-extern PYWINTYPES_EXPORT void PyWinThreadState_Clear();
-extern PYWINTYPES_EXPORT void PyWinInterpreterLock_Acquire();
-extern PYWINTYPES_EXPORT void PyWinInterpreterLock_Release();
-
-extern PYWINTYPES_EXPORT int PyWinGlobals_Ensure();
-extern PYWINTYPES_EXPORT void PyWinGlobals_Free();
-#else
-#define PyWinThreadState_Ensure PyThreadState_Ensure
-#define PyWinThreadState_Free PyThreadState_Free
-#define PyWinThreadState_Clear PyThreadState_ClearExc
-
-#endif
-
-extern PYWINTYPES_EXPORT void PyWin_MakePendingCalls();
-
-class CEnterLeavePython {
-   public:
-    CEnterLeavePython() : released(TRUE) { acquire(); }
-    void acquire(void)
-    {
-        if (!released)
-            return;
-        state = PyGILState_Ensure();
-        released = FALSE;
-    }
-    ~CEnterLeavePython() { release(); }
-    void release(void)
-    {
-        if (!released) {
-            PyGILState_Release(state);
-            released = TRUE;
-        }
-    }
-
-   private:
-    PyGILState_STATE state;
-    BOOL released;
-};
-
-// A helper for simple exception handling.
-// try/__try
-#if defined(__MINGW32__) || defined(MAINWIN)
-#define PYWINTYPES_TRY try
-#else
-#define PYWINTYPES_TRY __try
-#endif /* MAINWIN */
-
-// catch/__except
-#if defined(__MINGW32__) || defined(MAINWIN)
-#define PYWINTYPES_EXCEPT catch (...)
-#else
-#define PYWINTYPES_EXCEPT __except (EXCEPTION_EXECUTE_HANDLER)
-#endif
-// End of exception helper macros.
-
-// Class to hold a temporary reference that decrements itself
-class TmpPyObject {
-   public:
-    PyObject *tmp;
-    TmpPyObject() { tmp = NULL; }
-    TmpPyObject(PyObject *ob) { tmp = ob; }
-    PyObject *operator=(PyObject *ob)
-    {
-        Py_XDECREF(tmp);
-        tmp = ob;
-        return tmp;
-    }
-
-    boolean operator==(PyObject *ob) { return tmp == ob; }
-    operator PyObject *() { return tmp; }
-    ~TmpPyObject() { Py_XDECREF(tmp); }
-};
-
-#endif  // __PYWINTYPES_H__
diff --git a/lib/win32/lib/afxres.py b/lib/win32/lib/afxres.py
deleted file mode 100644
index 249211ff..00000000
--- a/lib/win32/lib/afxres.py
+++ /dev/null
@@ -1,501 +0,0 @@
-# Generated by h2py from stdin
-TCS_MULTILINE = 0x0200
-CBRS_ALIGN_LEFT = 0x1000
-CBRS_ALIGN_TOP = 0x2000
-CBRS_ALIGN_RIGHT = 0x4000
-CBRS_ALIGN_BOTTOM = 0x8000
-CBRS_ALIGN_ANY = 0xF000
-CBRS_BORDER_LEFT = 0x0100
-CBRS_BORDER_TOP = 0x0200
-CBRS_BORDER_RIGHT = 0x0400
-CBRS_BORDER_BOTTOM = 0x0800
-CBRS_BORDER_ANY = 0x0F00
-CBRS_TOOLTIPS = 0x0010
-CBRS_FLYBY = 0x0020
-CBRS_FLOAT_MULTI = 0x0040
-CBRS_BORDER_3D = 0x0080
-CBRS_HIDE_INPLACE = 0x0008
-CBRS_SIZE_DYNAMIC = 0x0004
-CBRS_SIZE_FIXED = 0x0002
-CBRS_FLOATING = 0x0001
-CBRS_GRIPPER = 0x00400000
-CBRS_ORIENT_HORZ = CBRS_ALIGN_TOP | CBRS_ALIGN_BOTTOM
-CBRS_ORIENT_VERT = CBRS_ALIGN_LEFT | CBRS_ALIGN_RIGHT
-CBRS_ORIENT_ANY = CBRS_ORIENT_HORZ | CBRS_ORIENT_VERT
-CBRS_ALL = 0xFFFF
-CBRS_NOALIGN = 0x00000000
-CBRS_LEFT = CBRS_ALIGN_LEFT | CBRS_BORDER_RIGHT
-CBRS_TOP = CBRS_ALIGN_TOP | CBRS_BORDER_BOTTOM
-CBRS_RIGHT = CBRS_ALIGN_RIGHT | CBRS_BORDER_LEFT
-CBRS_BOTTOM = CBRS_ALIGN_BOTTOM | CBRS_BORDER_TOP
-SBPS_NORMAL = 0x0000
-SBPS_NOBORDERS = 0x0100
-SBPS_POPOUT = 0x0200
-SBPS_OWNERDRAW = 0x1000
-SBPS_DISABLED = 0x04000000
-SBPS_STRETCH = 0x08000000
-ID_INDICATOR_EXT = 0xE700
-ID_INDICATOR_CAPS = 0xE701
-ID_INDICATOR_NUM = 0xE702
-ID_INDICATOR_SCRL = 0xE703
-ID_INDICATOR_OVR = 0xE704
-ID_INDICATOR_REC = 0xE705
-ID_INDICATOR_KANA = 0xE706
-ID_SEPARATOR = 0
-AFX_IDW_CONTROLBAR_FIRST = 0xE800
-AFX_IDW_CONTROLBAR_LAST = 0xE8FF
-AFX_IDW_TOOLBAR = 0xE800
-AFX_IDW_STATUS_BAR = 0xE801
-AFX_IDW_PREVIEW_BAR = 0xE802
-AFX_IDW_RESIZE_BAR = 0xE803
-AFX_IDW_DOCKBAR_TOP = 0xE81B
-AFX_IDW_DOCKBAR_LEFT = 0xE81C
-AFX_IDW_DOCKBAR_RIGHT = 0xE81D
-AFX_IDW_DOCKBAR_BOTTOM = 0xE81E
-AFX_IDW_DOCKBAR_FLOAT = 0xE81F
-
-
-def AFX_CONTROLBAR_MASK(nIDC):
-    return 1 << (nIDC - AFX_IDW_CONTROLBAR_FIRST)
-
-
-AFX_IDW_PANE_FIRST = 0xE900
-AFX_IDW_PANE_LAST = 0xE9FF
-AFX_IDW_HSCROLL_FIRST = 0xEA00
-AFX_IDW_VSCROLL_FIRST = 0xEA10
-AFX_IDW_SIZE_BOX = 0xEA20
-AFX_IDW_PANE_SAVE = 0xEA21
-AFX_IDS_APP_TITLE = 0xE000
-AFX_IDS_IDLEMESSAGE = 0xE001
-AFX_IDS_HELPMODEMESSAGE = 0xE002
-AFX_IDS_APP_TITLE_EMBEDDING = 0xE003
-AFX_IDS_COMPANY_NAME = 0xE004
-AFX_IDS_OBJ_TITLE_INPLACE = 0xE005
-ID_FILE_NEW = 0xE100
-ID_FILE_OPEN = 0xE101
-ID_FILE_CLOSE = 0xE102
-ID_FILE_SAVE = 0xE103
-ID_FILE_SAVE_AS = 0xE104
-ID_FILE_PAGE_SETUP = 0xE105
-ID_FILE_PRINT_SETUP = 0xE106
-ID_FILE_PRINT = 0xE107
-ID_FILE_PRINT_DIRECT = 0xE108
-ID_FILE_PRINT_PREVIEW = 0xE109
-ID_FILE_UPDATE = 0xE10A
-ID_FILE_SAVE_COPY_AS = 0xE10B
-ID_FILE_SEND_MAIL = 0xE10C
-ID_FILE_MRU_FIRST = 0xE110
-ID_FILE_MRU_FILE1 = 0xE110
-ID_FILE_MRU_FILE2 = 0xE111
-ID_FILE_MRU_FILE3 = 0xE112
-ID_FILE_MRU_FILE4 = 0xE113
-ID_FILE_MRU_FILE5 = 0xE114
-ID_FILE_MRU_FILE6 = 0xE115
-ID_FILE_MRU_FILE7 = 0xE116
-ID_FILE_MRU_FILE8 = 0xE117
-ID_FILE_MRU_FILE9 = 0xE118
-ID_FILE_MRU_FILE10 = 0xE119
-ID_FILE_MRU_FILE11 = 0xE11A
-ID_FILE_MRU_FILE12 = 0xE11B
-ID_FILE_MRU_FILE13 = 0xE11C
-ID_FILE_MRU_FILE14 = 0xE11D
-ID_FILE_MRU_FILE15 = 0xE11E
-ID_FILE_MRU_FILE16 = 0xE11F
-ID_FILE_MRU_LAST = 0xE11F
-ID_EDIT_CLEAR = 0xE120
-ID_EDIT_CLEAR_ALL = 0xE121
-ID_EDIT_COPY = 0xE122
-ID_EDIT_CUT = 0xE123
-ID_EDIT_FIND = 0xE124
-ID_EDIT_PASTE = 0xE125
-ID_EDIT_PASTE_LINK = 0xE126
-ID_EDIT_PASTE_SPECIAL = 0xE127
-ID_EDIT_REPEAT = 0xE128
-ID_EDIT_REPLACE = 0xE129
-ID_EDIT_SELECT_ALL = 0xE12A
-ID_EDIT_UNDO = 0xE12B
-ID_EDIT_REDO = 0xE12C
-ID_WINDOW_NEW = 0xE130
-ID_WINDOW_ARRANGE = 0xE131
-ID_WINDOW_CASCADE = 0xE132
-ID_WINDOW_TILE_HORZ = 0xE133
-ID_WINDOW_TILE_VERT = 0xE134
-ID_WINDOW_SPLIT = 0xE135
-AFX_IDM_WINDOW_FIRST = 0xE130
-AFX_IDM_WINDOW_LAST = 0xE13F
-AFX_IDM_FIRST_MDICHILD = 0xFF00
-ID_APP_ABOUT = 0xE140
-ID_APP_EXIT = 0xE141
-ID_HELP_INDEX = 0xE142
-ID_HELP_FINDER = 0xE143
-ID_HELP_USING = 0xE144
-ID_CONTEXT_HELP = 0xE145
-ID_HELP = 0xE146
-ID_DEFAULT_HELP = 0xE147
-ID_NEXT_PANE = 0xE150
-ID_PREV_PANE = 0xE151
-ID_FORMAT_FONT = 0xE160
-ID_OLE_INSERT_NEW = 0xE200
-ID_OLE_EDIT_LINKS = 0xE201
-ID_OLE_EDIT_CONVERT = 0xE202
-ID_OLE_EDIT_CHANGE_ICON = 0xE203
-ID_OLE_EDIT_PROPERTIES = 0xE204
-ID_OLE_VERB_FIRST = 0xE210
-ID_OLE_VERB_LAST = 0xE21F
-AFX_ID_PREVIEW_CLOSE = 0xE300
-AFX_ID_PREVIEW_NUMPAGE = 0xE301
-AFX_ID_PREVIEW_NEXT = 0xE302
-AFX_ID_PREVIEW_PREV = 0xE303
-AFX_ID_PREVIEW_PRINT = 0xE304
-AFX_ID_PREVIEW_ZOOMIN = 0xE305
-AFX_ID_PREVIEW_ZOOMOUT = 0xE306
-ID_VIEW_TOOLBAR = 0xE800
-ID_VIEW_STATUS_BAR = 0xE801
-ID_RECORD_FIRST = 0xE900
-ID_RECORD_LAST = 0xE901
-ID_RECORD_NEXT = 0xE902
-ID_RECORD_PREV = 0xE903
-IDC_STATIC = -1
-AFX_IDS_SCFIRST = 0xEF00
-AFX_IDS_SCSIZE = 0xEF00
-AFX_IDS_SCMOVE = 0xEF01
-AFX_IDS_SCMINIMIZE = 0xEF02
-AFX_IDS_SCMAXIMIZE = 0xEF03
-AFX_IDS_SCNEXTWINDOW = 0xEF04
-AFX_IDS_SCPREVWINDOW = 0xEF05
-AFX_IDS_SCCLOSE = 0xEF06
-AFX_IDS_SCRESTORE = 0xEF12
-AFX_IDS_SCTASKLIST = 0xEF13
-AFX_IDS_MDICHILD = 0xEF1F
-AFX_IDS_DESKACCESSORY = 0xEFDA
-AFX_IDS_OPENFILE = 0xF000
-AFX_IDS_SAVEFILE = 0xF001
-AFX_IDS_ALLFILTER = 0xF002
-AFX_IDS_UNTITLED = 0xF003
-AFX_IDS_SAVEFILECOPY = 0xF004
-AFX_IDS_PREVIEW_CLOSE = 0xF005
-AFX_IDS_UNNAMED_FILE = 0xF006
-AFX_IDS_ABOUT = 0xF010
-AFX_IDS_HIDE = 0xF011
-AFX_IDP_NO_ERROR_AVAILABLE = 0xF020
-AFX_IDS_NOT_SUPPORTED_EXCEPTION = 0xF021
-AFX_IDS_RESOURCE_EXCEPTION = 0xF022
-AFX_IDS_MEMORY_EXCEPTION = 0xF023
-AFX_IDS_USER_EXCEPTION = 0xF024
-AFX_IDS_PRINTONPORT = 0xF040
-AFX_IDS_ONEPAGE = 0xF041
-AFX_IDS_TWOPAGE = 0xF042
-AFX_IDS_PRINTPAGENUM = 0xF043
-AFX_IDS_PREVIEWPAGEDESC = 0xF044
-AFX_IDS_PRINTDEFAULTEXT = 0xF045
-AFX_IDS_PRINTDEFAULT = 0xF046
-AFX_IDS_PRINTFILTER = 0xF047
-AFX_IDS_PRINTCAPTION = 0xF048
-AFX_IDS_PRINTTOFILE = 0xF049
-AFX_IDS_OBJECT_MENUITEM = 0xF080
-AFX_IDS_EDIT_VERB = 0xF081
-AFX_IDS_ACTIVATE_VERB = 0xF082
-AFX_IDS_CHANGE_LINK = 0xF083
-AFX_IDS_AUTO = 0xF084
-AFX_IDS_MANUAL = 0xF085
-AFX_IDS_FROZEN = 0xF086
-AFX_IDS_ALL_FILES = 0xF087
-AFX_IDS_SAVE_MENU = 0xF088
-AFX_IDS_UPDATE_MENU = 0xF089
-AFX_IDS_SAVE_AS_MENU = 0xF08A
-AFX_IDS_SAVE_COPY_AS_MENU = 0xF08B
-AFX_IDS_EXIT_MENU = 0xF08C
-AFX_IDS_UPDATING_ITEMS = 0xF08D
-AFX_IDS_METAFILE_FORMAT = 0xF08E
-AFX_IDS_DIB_FORMAT = 0xF08F
-AFX_IDS_BITMAP_FORMAT = 0xF090
-AFX_IDS_LINKSOURCE_FORMAT = 0xF091
-AFX_IDS_EMBED_FORMAT = 0xF092
-AFX_IDS_PASTELINKEDTYPE = 0xF094
-AFX_IDS_UNKNOWNTYPE = 0xF095
-AFX_IDS_RTF_FORMAT = 0xF096
-AFX_IDS_TEXT_FORMAT = 0xF097
-AFX_IDS_INVALID_CURRENCY = 0xF098
-AFX_IDS_INVALID_DATETIME = 0xF099
-AFX_IDS_INVALID_DATETIMESPAN = 0xF09A
-AFX_IDP_INVALID_FILENAME = 0xF100
-AFX_IDP_FAILED_TO_OPEN_DOC = 0xF101
-AFX_IDP_FAILED_TO_SAVE_DOC = 0xF102
-AFX_IDP_ASK_TO_SAVE = 0xF103
-AFX_IDP_FAILED_TO_CREATE_DOC = 0xF104
-AFX_IDP_FILE_TOO_LARGE = 0xF105
-AFX_IDP_FAILED_TO_START_PRINT = 0xF106
-AFX_IDP_FAILED_TO_LAUNCH_HELP = 0xF107
-AFX_IDP_INTERNAL_FAILURE = 0xF108
-AFX_IDP_COMMAND_FAILURE = 0xF109
-AFX_IDP_FAILED_MEMORY_ALLOC = 0xF10A
-AFX_IDP_PARSE_INT = 0xF110
-AFX_IDP_PARSE_REAL = 0xF111
-AFX_IDP_PARSE_INT_RANGE = 0xF112
-AFX_IDP_PARSE_REAL_RANGE = 0xF113
-AFX_IDP_PARSE_STRING_SIZE = 0xF114
-AFX_IDP_PARSE_RADIO_BUTTON = 0xF115
-AFX_IDP_PARSE_BYTE = 0xF116
-AFX_IDP_PARSE_UINT = 0xF117
-AFX_IDP_PARSE_DATETIME = 0xF118
-AFX_IDP_PARSE_CURRENCY = 0xF119
-AFX_IDP_FAILED_INVALID_FORMAT = 0xF120
-AFX_IDP_FAILED_INVALID_PATH = 0xF121
-AFX_IDP_FAILED_DISK_FULL = 0xF122
-AFX_IDP_FAILED_ACCESS_READ = 0xF123
-AFX_IDP_FAILED_ACCESS_WRITE = 0xF124
-AFX_IDP_FAILED_IO_ERROR_READ = 0xF125
-AFX_IDP_FAILED_IO_ERROR_WRITE = 0xF126
-AFX_IDP_STATIC_OBJECT = 0xF180
-AFX_IDP_FAILED_TO_CONNECT = 0xF181
-AFX_IDP_SERVER_BUSY = 0xF182
-AFX_IDP_BAD_VERB = 0xF183
-AFX_IDP_FAILED_TO_NOTIFY = 0xF185
-AFX_IDP_FAILED_TO_LAUNCH = 0xF186
-AFX_IDP_ASK_TO_UPDATE = 0xF187
-AFX_IDP_FAILED_TO_UPDATE = 0xF188
-AFX_IDP_FAILED_TO_REGISTER = 0xF189
-AFX_IDP_FAILED_TO_AUTO_REGISTER = 0xF18A
-AFX_IDP_FAILED_TO_CONVERT = 0xF18B
-AFX_IDP_GET_NOT_SUPPORTED = 0xF18C
-AFX_IDP_SET_NOT_SUPPORTED = 0xF18D
-AFX_IDP_ASK_TO_DISCARD = 0xF18E
-AFX_IDP_FAILED_TO_CREATE = 0xF18F
-AFX_IDP_FAILED_MAPI_LOAD = 0xF190
-AFX_IDP_INVALID_MAPI_DLL = 0xF191
-AFX_IDP_FAILED_MAPI_SEND = 0xF192
-AFX_IDP_FILE_NONE = 0xF1A0
-AFX_IDP_FILE_GENERIC = 0xF1A1
-AFX_IDP_FILE_NOT_FOUND = 0xF1A2
-AFX_IDP_FILE_BAD_PATH = 0xF1A3
-AFX_IDP_FILE_TOO_MANY_OPEN = 0xF1A4
-AFX_IDP_FILE_ACCESS_DENIED = 0xF1A5
-AFX_IDP_FILE_INVALID_FILE = 0xF1A6
-AFX_IDP_FILE_REMOVE_CURRENT = 0xF1A7
-AFX_IDP_FILE_DIR_FULL = 0xF1A8
-AFX_IDP_FILE_BAD_SEEK = 0xF1A9
-AFX_IDP_FILE_HARD_IO = 0xF1AA
-AFX_IDP_FILE_SHARING = 0xF1AB
-AFX_IDP_FILE_LOCKING = 0xF1AC
-AFX_IDP_FILE_DISKFULL = 0xF1AD
-AFX_IDP_FILE_EOF = 0xF1AE
-AFX_IDP_ARCH_NONE = 0xF1B0
-AFX_IDP_ARCH_GENERIC = 0xF1B1
-AFX_IDP_ARCH_READONLY = 0xF1B2
-AFX_IDP_ARCH_ENDOFFILE = 0xF1B3
-AFX_IDP_ARCH_WRITEONLY = 0xF1B4
-AFX_IDP_ARCH_BADINDEX = 0xF1B5
-AFX_IDP_ARCH_BADCLASS = 0xF1B6
-AFX_IDP_ARCH_BADSCHEMA = 0xF1B7
-AFX_IDS_OCC_SCALEUNITS_PIXELS = 0xF1C0
-AFX_IDS_STATUS_FONT = 0xF230
-AFX_IDS_TOOLTIP_FONT = 0xF231
-AFX_IDS_UNICODE_FONT = 0xF232
-AFX_IDS_MINI_FONT = 0xF233
-AFX_IDP_SQL_FIRST = 0xF280
-AFX_IDP_SQL_CONNECT_FAIL = 0xF281
-AFX_IDP_SQL_RECORDSET_FORWARD_ONLY = 0xF282
-AFX_IDP_SQL_EMPTY_COLUMN_LIST = 0xF283
-AFX_IDP_SQL_FIELD_SCHEMA_MISMATCH = 0xF284
-AFX_IDP_SQL_ILLEGAL_MODE = 0xF285
-AFX_IDP_SQL_MULTIPLE_ROWS_AFFECTED = 0xF286
-AFX_IDP_SQL_NO_CURRENT_RECORD = 0xF287
-AFX_IDP_SQL_NO_ROWS_AFFECTED = 0xF288
-AFX_IDP_SQL_RECORDSET_READONLY = 0xF289
-AFX_IDP_SQL_SQL_NO_TOTAL = 0xF28A
-AFX_IDP_SQL_ODBC_LOAD_FAILED = 0xF28B
-AFX_IDP_SQL_DYNASET_NOT_SUPPORTED = 0xF28C
-AFX_IDP_SQL_SNAPSHOT_NOT_SUPPORTED = 0xF28D
-AFX_IDP_SQL_API_CONFORMANCE = 0xF28E
-AFX_IDP_SQL_SQL_CONFORMANCE = 0xF28F
-AFX_IDP_SQL_NO_DATA_FOUND = 0xF290
-AFX_IDP_SQL_ROW_UPDATE_NOT_SUPPORTED = 0xF291
-AFX_IDP_SQL_ODBC_V2_REQUIRED = 0xF292
-AFX_IDP_SQL_NO_POSITIONED_UPDATES = 0xF293
-AFX_IDP_SQL_LOCK_MODE_NOT_SUPPORTED = 0xF294
-AFX_IDP_SQL_DATA_TRUNCATED = 0xF295
-AFX_IDP_SQL_ROW_FETCH = 0xF296
-AFX_IDP_SQL_INCORRECT_ODBC = 0xF297
-AFX_IDP_SQL_UPDATE_DELETE_FAILED = 0xF298
-AFX_IDP_SQL_DYNAMIC_CURSOR_NOT_SUPPORTED = 0xF299
-AFX_IDP_DAO_FIRST = 0xF2A0
-AFX_IDP_DAO_ENGINE_INITIALIZATION = 0xF2A0
-AFX_IDP_DAO_DFX_BIND = 0xF2A1
-AFX_IDP_DAO_OBJECT_NOT_OPEN = 0xF2A2
-AFX_IDP_DAO_ROWTOOSHORT = 0xF2A3
-AFX_IDP_DAO_BADBINDINFO = 0xF2A4
-AFX_IDP_DAO_COLUMNUNAVAILABLE = 0xF2A5
-AFX_IDC_LISTBOX = 100
-AFX_IDC_CHANGE = 101
-AFX_IDC_PRINT_DOCNAME = 201
-AFX_IDC_PRINT_PRINTERNAME = 202
-AFX_IDC_PRINT_PORTNAME = 203
-AFX_IDC_PRINT_PAGENUM = 204
-ID_APPLY_NOW = 0x3021
-ID_WIZBACK = 0x3023
-ID_WIZNEXT = 0x3024
-ID_WIZFINISH = 0x3025
-AFX_IDC_TAB_CONTROL = 0x3020
-AFX_IDD_FILEOPEN = 28676
-AFX_IDD_FILESAVE = 28677
-AFX_IDD_FONT = 28678
-AFX_IDD_COLOR = 28679
-AFX_IDD_PRINT = 28680
-AFX_IDD_PRINTSETUP = 28681
-AFX_IDD_FIND = 28682
-AFX_IDD_REPLACE = 28683
-AFX_IDD_NEWTYPEDLG = 30721
-AFX_IDD_PRINTDLG = 30722
-AFX_IDD_PREVIEW_TOOLBAR = 30723
-AFX_IDD_PREVIEW_SHORTTOOLBAR = 30731
-AFX_IDD_INSERTOBJECT = 30724
-AFX_IDD_CHANGEICON = 30725
-AFX_IDD_CONVERT = 30726
-AFX_IDD_PASTESPECIAL = 30727
-AFX_IDD_EDITLINKS = 30728
-AFX_IDD_FILEBROWSE = 30729
-AFX_IDD_BUSY = 30730
-AFX_IDD_OBJECTPROPERTIES = 30732
-AFX_IDD_CHANGESOURCE = 30733
-AFX_IDC_CONTEXTHELP = 30977
-AFX_IDC_MAGNIFY = 30978
-AFX_IDC_SMALLARROWS = 30979
-AFX_IDC_HSPLITBAR = 30980
-AFX_IDC_VSPLITBAR = 30981
-AFX_IDC_NODROPCRSR = 30982
-AFX_IDC_TRACKNWSE = 30983
-AFX_IDC_TRACKNESW = 30984
-AFX_IDC_TRACKNS = 30985
-AFX_IDC_TRACKWE = 30986
-AFX_IDC_TRACK4WAY = 30987
-AFX_IDC_MOVE4WAY = 30988
-AFX_IDB_MINIFRAME_MENU = 30994
-AFX_IDB_CHECKLISTBOX_NT = 30995
-AFX_IDB_CHECKLISTBOX_95 = 30996
-AFX_IDR_PREVIEW_ACCEL = 30997
-AFX_IDI_STD_MDIFRAME = 31233
-AFX_IDI_STD_FRAME = 31234
-AFX_IDC_FONTPROP = 1000
-AFX_IDC_FONTNAMES = 1001
-AFX_IDC_FONTSTYLES = 1002
-AFX_IDC_FONTSIZES = 1003
-AFX_IDC_STRIKEOUT = 1004
-AFX_IDC_UNDERLINE = 1005
-AFX_IDC_SAMPLEBOX = 1006
-AFX_IDC_COLOR_BLACK = 1100
-AFX_IDC_COLOR_WHITE = 1101
-AFX_IDC_COLOR_RED = 1102
-AFX_IDC_COLOR_GREEN = 1103
-AFX_IDC_COLOR_BLUE = 1104
-AFX_IDC_COLOR_YELLOW = 1105
-AFX_IDC_COLOR_MAGENTA = 1106
-AFX_IDC_COLOR_CYAN = 1107
-AFX_IDC_COLOR_GRAY = 1108
-AFX_IDC_COLOR_LIGHTGRAY = 1109
-AFX_IDC_COLOR_DARKRED = 1110
-AFX_IDC_COLOR_DARKGREEN = 1111
-AFX_IDC_COLOR_DARKBLUE = 1112
-AFX_IDC_COLOR_LIGHTBROWN = 1113
-AFX_IDC_COLOR_DARKMAGENTA = 1114
-AFX_IDC_COLOR_DARKCYAN = 1115
-AFX_IDC_COLORPROP = 1116
-AFX_IDC_SYSTEMCOLORS = 1117
-AFX_IDC_PROPNAME = 1201
-AFX_IDC_PICTURE = 1202
-AFX_IDC_BROWSE = 1203
-AFX_IDC_CLEAR = 1204
-AFX_IDD_PROPPAGE_COLOR = 32257
-AFX_IDD_PROPPAGE_FONT = 32258
-AFX_IDD_PROPPAGE_PICTURE = 32259
-AFX_IDB_TRUETYPE = 32384
-AFX_IDS_PROPPAGE_UNKNOWN = 0xFE01
-AFX_IDS_COLOR_DESKTOP = 0xFE04
-AFX_IDS_COLOR_APPWORKSPACE = 0xFE05
-AFX_IDS_COLOR_WNDBACKGND = 0xFE06
-AFX_IDS_COLOR_WNDTEXT = 0xFE07
-AFX_IDS_COLOR_MENUBAR = 0xFE08
-AFX_IDS_COLOR_MENUTEXT = 0xFE09
-AFX_IDS_COLOR_ACTIVEBAR = 0xFE0A
-AFX_IDS_COLOR_INACTIVEBAR = 0xFE0B
-AFX_IDS_COLOR_ACTIVETEXT = 0xFE0C
-AFX_IDS_COLOR_INACTIVETEXT = 0xFE0D
-AFX_IDS_COLOR_ACTIVEBORDER = 0xFE0E
-AFX_IDS_COLOR_INACTIVEBORDER = 0xFE0F
-AFX_IDS_COLOR_WNDFRAME = 0xFE10
-AFX_IDS_COLOR_SCROLLBARS = 0xFE11
-AFX_IDS_COLOR_BTNFACE = 0xFE12
-AFX_IDS_COLOR_BTNSHADOW = 0xFE13
-AFX_IDS_COLOR_BTNTEXT = 0xFE14
-AFX_IDS_COLOR_BTNHIGHLIGHT = 0xFE15
-AFX_IDS_COLOR_DISABLEDTEXT = 0xFE16
-AFX_IDS_COLOR_HIGHLIGHT = 0xFE17
-AFX_IDS_COLOR_HIGHLIGHTTEXT = 0xFE18
-AFX_IDS_REGULAR = 0xFE19
-AFX_IDS_BOLD = 0xFE1A
-AFX_IDS_ITALIC = 0xFE1B
-AFX_IDS_BOLDITALIC = 0xFE1C
-AFX_IDS_SAMPLETEXT = 0xFE1D
-AFX_IDS_DISPLAYSTRING_FONT = 0xFE1E
-AFX_IDS_DISPLAYSTRING_COLOR = 0xFE1F
-AFX_IDS_DISPLAYSTRING_PICTURE = 0xFE20
-AFX_IDS_PICTUREFILTER = 0xFE21
-AFX_IDS_PICTYPE_UNKNOWN = 0xFE22
-AFX_IDS_PICTYPE_NONE = 0xFE23
-AFX_IDS_PICTYPE_BITMAP = 0xFE24
-AFX_IDS_PICTYPE_METAFILE = 0xFE25
-AFX_IDS_PICTYPE_ICON = 0xFE26
-AFX_IDS_COLOR_PPG = 0xFE28
-AFX_IDS_COLOR_PPG_CAPTION = 0xFE29
-AFX_IDS_FONT_PPG = 0xFE2A
-AFX_IDS_FONT_PPG_CAPTION = 0xFE2B
-AFX_IDS_PICTURE_PPG = 0xFE2C
-AFX_IDS_PICTURE_PPG_CAPTION = 0xFE2D
-AFX_IDS_PICTUREBROWSETITLE = 0xFE30
-AFX_IDS_BORDERSTYLE_0 = 0xFE31
-AFX_IDS_BORDERSTYLE_1 = 0xFE32
-AFX_IDS_VERB_EDIT = 0xFE40
-AFX_IDS_VERB_PROPERTIES = 0xFE41
-AFX_IDP_PICTURECANTOPEN = 0xFE83
-AFX_IDP_PICTURECANTLOAD = 0xFE84
-AFX_IDP_PICTURETOOLARGE = 0xFE85
-AFX_IDP_PICTUREREADFAILED = 0xFE86
-AFX_IDP_E_ILLEGALFUNCTIONCALL = 0xFEA0
-AFX_IDP_E_OVERFLOW = 0xFEA1
-AFX_IDP_E_OUTOFMEMORY = 0xFEA2
-AFX_IDP_E_DIVISIONBYZERO = 0xFEA3
-AFX_IDP_E_OUTOFSTRINGSPACE = 0xFEA4
-AFX_IDP_E_OUTOFSTACKSPACE = 0xFEA5
-AFX_IDP_E_BADFILENAMEORNUMBER = 0xFEA6
-AFX_IDP_E_FILENOTFOUND = 0xFEA7
-AFX_IDP_E_BADFILEMODE = 0xFEA8
-AFX_IDP_E_FILEALREADYOPEN = 0xFEA9
-AFX_IDP_E_DEVICEIOERROR = 0xFEAA
-AFX_IDP_E_FILEALREADYEXISTS = 0xFEAB
-AFX_IDP_E_BADRECORDLENGTH = 0xFEAC
-AFX_IDP_E_DISKFULL = 0xFEAD
-AFX_IDP_E_BADRECORDNUMBER = 0xFEAE
-AFX_IDP_E_BADFILENAME = 0xFEAF
-AFX_IDP_E_TOOMANYFILES = 0xFEB0
-AFX_IDP_E_DEVICEUNAVAILABLE = 0xFEB1
-AFX_IDP_E_PERMISSIONDENIED = 0xFEB2
-AFX_IDP_E_DISKNOTREADY = 0xFEB3
-AFX_IDP_E_PATHFILEACCESSERROR = 0xFEB4
-AFX_IDP_E_PATHNOTFOUND = 0xFEB5
-AFX_IDP_E_INVALIDPATTERNSTRING = 0xFEB6
-AFX_IDP_E_INVALIDUSEOFNULL = 0xFEB7
-AFX_IDP_E_INVALIDFILEFORMAT = 0xFEB8
-AFX_IDP_E_INVALIDPROPERTYVALUE = 0xFEB9
-AFX_IDP_E_INVALIDPROPERTYARRAYINDEX = 0xFEBA
-AFX_IDP_E_SETNOTSUPPORTEDATRUNTIME = 0xFEBB
-AFX_IDP_E_SETNOTSUPPORTED = 0xFEBC
-AFX_IDP_E_NEEDPROPERTYARRAYINDEX = 0xFEBD
-AFX_IDP_E_SETNOTPERMITTED = 0xFEBE
-AFX_IDP_E_GETNOTSUPPORTEDATRUNTIME = 0xFEBF
-AFX_IDP_E_GETNOTSUPPORTED = 0xFEC0
-AFX_IDP_E_PROPERTYNOTFOUND = 0xFEC1
-AFX_IDP_E_INVALIDCLIPBOARDFORMAT = 0xFEC2
-AFX_IDP_E_INVALIDPICTURE = 0xFEC3
-AFX_IDP_E_PRINTERERROR = 0xFEC4
-AFX_IDP_E_CANTSAVEFILETOTEMP = 0xFEC5
-AFX_IDP_E_SEARCHTEXTNOTFOUND = 0xFEC6
-AFX_IDP_E_REPLACEMENTSTOOLONG = 0xFEC7
diff --git a/lib/win32/lib/commctrl.py b/lib/win32/lib/commctrl.py
deleted file mode 100644
index 26641e84..00000000
--- a/lib/win32/lib/commctrl.py
+++ /dev/null
@@ -1,1551 +0,0 @@
-# Generated by h2py from COMMCTRL.H
-WM_USER = 1024
-ICC_LISTVIEW_CLASSES = 1  # listview, header
-ICC_TREEVIEW_CLASSES = 2  # treeview, tooltips
-ICC_BAR_CLASSES = 4  # toolbar, statusbar, trackbar, tooltips
-ICC_TAB_CLASSES = 8  # tab, tooltips
-ICC_UPDOWN_CLASS = 16  # updown
-ICC_PROGRESS_CLASS = 32  # progress
-ICC_HOTKEY_CLASS = 64  # hotkey
-ICC_ANIMATE_CLASS = 128  # animate
-ICC_WIN95_CLASSES = 255
-ICC_DATE_CLASSES = 256  # month picker, date picker, time picker, updown
-ICC_USEREX_CLASSES = 512  # comboex
-ICC_COOL_CLASSES = 1024  # rebar (coolbar) control
-ICC_INTERNET_CLASSES = 2048
-ICC_PAGESCROLLER_CLASS = 4096  # page scroller
-ICC_NATIVEFNTCTL_CLASS = 8192  # native font control
-ODT_HEADER = 100
-ODT_TAB = 101
-ODT_LISTVIEW = 102
-PY_0U = 0
-NM_FIRST = PY_0U  # generic to all controls
-NM_LAST = PY_0U - 99
-LVN_FIRST = PY_0U - 100  # listview
-LVN_LAST = PY_0U - 199
-HDN_FIRST = PY_0U - 300  # header
-HDN_LAST = PY_0U - 399
-TVN_FIRST = PY_0U - 400  # treeview
-TVN_LAST = PY_0U - 499
-TTN_FIRST = PY_0U - 520  # tooltips
-TTN_LAST = PY_0U - 549
-TCN_FIRST = PY_0U - 550  # tab control
-TCN_LAST = PY_0U - 580
-CDN_FIRST = PY_0U - 601  # common dialog (new)
-CDN_LAST = PY_0U - 699
-TBN_FIRST = PY_0U - 700  # toolbar
-TBN_LAST = PY_0U - 720
-UDN_FIRST = PY_0U - 721  # updown
-UDN_LAST = PY_0U - 740
-MCN_FIRST = PY_0U - 750  # monthcal
-MCN_LAST = PY_0U - 759
-DTN_FIRST = PY_0U - 760  # datetimepick
-DTN_LAST = PY_0U - 799
-CBEN_FIRST = PY_0U - 800  # combo box ex
-CBEN_LAST = PY_0U - 830
-RBN_FIRST = PY_0U - 831  # rebar
-RBN_LAST = PY_0U - 859
-IPN_FIRST = PY_0U - 860  # internet address
-IPN_LAST = PY_0U - 879  # internet address
-SBN_FIRST = PY_0U - 880  # status bar
-SBN_LAST = PY_0U - 899
-PGN_FIRST = PY_0U - 900  # Pager Control
-PGN_LAST = PY_0U - 950
-LVM_FIRST = 4096  # ListView messages
-TV_FIRST = 4352  # TreeView messages
-HDM_FIRST = 4608  # Header messages
-TCM_FIRST = 4864  # Tab control messages
-PGM_FIRST = 5120  # Pager control messages
-CCM_FIRST = 8192  # Common control shared messages
-CCM_SETBKCOLOR = CCM_FIRST + 1  # lParam is bkColor
-CCM_SETCOLORSCHEME = CCM_FIRST + 2  # lParam is color scheme
-CCM_GETCOLORSCHEME = CCM_FIRST + 3  # fills in COLORSCHEME pointed to by lParam
-CCM_GETDROPTARGET = CCM_FIRST + 4
-CCM_SETUNICODEFORMAT = CCM_FIRST + 5
-CCM_GETUNICODEFORMAT = CCM_FIRST + 6
-INFOTIPSIZE = 1024
-NM_OUTOFMEMORY = NM_FIRST - 1
-NM_CLICK = NM_FIRST - 2  # uses NMCLICK struct
-NM_DBLCLK = NM_FIRST - 3
-NM_RETURN = NM_FIRST - 4
-NM_RCLICK = NM_FIRST - 5  # uses NMCLICK struct
-NM_RDBLCLK = NM_FIRST - 6
-NM_SETFOCUS = NM_FIRST - 7
-NM_KILLFOCUS = NM_FIRST - 8
-NM_CUSTOMDRAW = NM_FIRST - 12
-NM_HOVER = NM_FIRST - 13
-NM_NCHITTEST = NM_FIRST - 14  # uses NMMOUSE struct
-NM_KEYDOWN = NM_FIRST - 15  # uses NMKEY struct
-NM_RELEASEDCAPTURE = NM_FIRST - 16
-NM_SETCURSOR = NM_FIRST - 17  # uses NMMOUSE struct
-NM_CHAR = NM_FIRST - 18  # uses NMCHAR struct
-MSGF_COMMCTRL_BEGINDRAG = 16896
-MSGF_COMMCTRL_SIZEHEADER = 16897
-MSGF_COMMCTRL_DRAGSELECT = 16898
-MSGF_COMMCTRL_TOOLBARCUST = 16899
-CDRF_DODEFAULT = 0
-CDRF_NEWFONT = 2
-CDRF_SKIPDEFAULT = 4
-CDRF_NOTIFYPOSTPAINT = 16
-CDRF_NOTIFYITEMDRAW = 32
-CDRF_NOTIFYSUBITEMDRAW = 32  # flags are the same, we can distinguish by context
-CDRF_NOTIFYPOSTERASE = 64
-CDDS_PREPAINT = 1
-CDDS_POSTPAINT = 2
-CDDS_PREERASE = 3
-CDDS_POSTERASE = 4
-CDDS_ITEM = 65536
-CDDS_ITEMPREPAINT = CDDS_ITEM | CDDS_PREPAINT
-CDDS_ITEMPOSTPAINT = CDDS_ITEM | CDDS_POSTPAINT
-CDDS_ITEMPREERASE = CDDS_ITEM | CDDS_PREERASE
-CDDS_ITEMPOSTERASE = CDDS_ITEM | CDDS_POSTERASE
-CDDS_SUBITEM = 131072
-CDIS_SELECTED = 1
-CDIS_GRAYED = 2
-CDIS_DISABLED = 4
-CDIS_CHECKED = 8
-CDIS_FOCUS = 16
-CDIS_DEFAULT = 32
-CDIS_HOT = 64
-CDIS_MARKED = 128
-CDIS_INDETERMINATE = 256
-CLR_NONE = -1  # 0xFFFFFFFFL
-CLR_DEFAULT = -16777216  # 0xFF000000L
-ILC_MASK = 1
-ILC_COLOR = 0
-ILC_COLORDDB = 254
-ILC_COLOR4 = 4
-ILC_COLOR8 = 8
-ILC_COLOR16 = 16
-ILC_COLOR24 = 24
-ILC_COLOR32 = 32
-ILC_PALETTE = 2048  # (not implemented)
-ILD_NORMAL = 0
-ILD_TRANSPARENT = 1
-ILD_MASK = 16
-ILD_IMAGE = 32
-ILD_ROP = 64
-ILD_BLEND25 = 2
-ILD_BLEND50 = 4
-ILD_OVERLAYMASK = 3840
-ILD_SELECTED = ILD_BLEND50
-ILD_FOCUS = ILD_BLEND25
-ILD_BLEND = ILD_BLEND50
-CLR_HILIGHT = CLR_DEFAULT
-ILCF_MOVE = 0
-ILCF_SWAP = 1
-WC_HEADERA = "SysHeader32"
-WC_HEADER = WC_HEADERA
-HDS_HORZ = 0
-HDS_BUTTONS = 2
-HDS_HOTTRACK = 4
-HDS_HIDDEN = 8
-HDS_DRAGDROP = 64
-HDS_FULLDRAG = 128
-HDI_WIDTH = 1
-HDI_HEIGHT = HDI_WIDTH
-HDI_TEXT = 2
-HDI_FORMAT = 4
-HDI_LPARAM = 8
-HDI_BITMAP = 16
-HDI_IMAGE = 32
-HDI_DI_SETITEM = 64
-HDI_ORDER = 128
-HDF_LEFT = 0
-HDF_RIGHT = 1
-HDF_CENTER = 2
-HDF_JUSTIFYMASK = 3
-HDF_RTLREADING = 4
-HDF_OWNERDRAW = 32768
-HDF_STRING = 16384
-HDF_BITMAP = 8192
-HDF_BITMAP_ON_RIGHT = 4096
-HDF_IMAGE = 2048
-HDM_GETITEMCOUNT = HDM_FIRST + 0
-HDM_INSERTITEMA = HDM_FIRST + 1
-HDM_INSERTITEMW = HDM_FIRST + 10
-HDM_INSERTITEM = HDM_INSERTITEMA
-HDM_DELETEITEM = HDM_FIRST + 2
-HDM_GETITEMA = HDM_FIRST + 3
-HDM_GETITEMW = HDM_FIRST + 11
-HDM_GETITEM = HDM_GETITEMA
-HDM_SETITEMA = HDM_FIRST + 4
-HDM_SETITEMW = HDM_FIRST + 12
-HDM_SETITEM = HDM_SETITEMA
-HDM_LAYOUT = HDM_FIRST + 5
-HHT_NOWHERE = 1
-HHT_ONHEADER = 2
-HHT_ONDIVIDER = 4
-HHT_ONDIVOPEN = 8
-HHT_ABOVE = 256
-HHT_BELOW = 512
-HHT_TORIGHT = 1024
-HHT_TOLEFT = 2048
-HDM_HITTEST = HDM_FIRST + 6
-HDM_GETITEMRECT = HDM_FIRST + 7
-HDM_SETIMAGELIST = HDM_FIRST + 8
-HDM_GETIMAGELIST = HDM_FIRST + 9
-HDM_ORDERTOINDEX = HDM_FIRST + 15
-HDM_CREATEDRAGIMAGE = HDM_FIRST + 16  # wparam = which item (by index)
-HDM_GETORDERARRAY = HDM_FIRST + 17
-HDM_SETORDERARRAY = HDM_FIRST + 18
-HDM_SETHOTDIVIDER = HDM_FIRST + 19
-HDM_SETUNICODEFORMAT = CCM_SETUNICODEFORMAT
-HDM_GETUNICODEFORMAT = CCM_GETUNICODEFORMAT
-HDN_ITEMCHANGINGA = HDN_FIRST - 0
-HDN_ITEMCHANGINGW = HDN_FIRST - 20
-HDN_ITEMCHANGEDA = HDN_FIRST - 1
-HDN_ITEMCHANGEDW = HDN_FIRST - 21
-HDN_ITEMCLICKA = HDN_FIRST - 2
-HDN_ITEMCLICKW = HDN_FIRST - 22
-HDN_ITEMDBLCLICKA = HDN_FIRST - 3
-HDN_ITEMDBLCLICKW = HDN_FIRST - 23
-HDN_DIVIDERDBLCLICKA = HDN_FIRST - 5
-HDN_DIVIDERDBLCLICKW = HDN_FIRST - 25
-HDN_BEGINTRACKA = HDN_FIRST - 6
-HDN_BEGINTRACKW = HDN_FIRST - 26
-HDN_ENDTRACKA = HDN_FIRST - 7
-HDN_ENDTRACKW = HDN_FIRST - 27
-HDN_TRACKA = HDN_FIRST - 8
-HDN_TRACKW = HDN_FIRST - 28
-HDN_GETDISPINFOA = HDN_FIRST - 9
-HDN_GETDISPINFOW = HDN_FIRST - 29
-HDN_BEGINDRAG = HDN_FIRST - 10
-HDN_ENDDRAG = HDN_FIRST - 11
-HDN_ITEMCHANGING = HDN_ITEMCHANGINGA
-HDN_ITEMCHANGED = HDN_ITEMCHANGEDA
-HDN_ITEMCLICK = HDN_ITEMCLICKA
-HDN_ITEMDBLCLICK = HDN_ITEMDBLCLICKA
-HDN_DIVIDERDBLCLICK = HDN_DIVIDERDBLCLICKA
-HDN_BEGINTRACK = HDN_BEGINTRACKA
-HDN_ENDTRACK = HDN_ENDTRACKA
-HDN_TRACK = HDN_TRACKA
-HDN_GETDISPINFO = HDN_GETDISPINFOA
-TOOLBARCLASSNAMEA = "ToolbarWindow32"
-TOOLBARCLASSNAME = TOOLBARCLASSNAMEA
-CMB_MASKED = 2
-TBSTATE_CHECKED = 1
-TBSTATE_PRESSED = 2
-TBSTATE_ENABLED = 4
-TBSTATE_HIDDEN = 8
-TBSTATE_INDETERMINATE = 16
-TBSTATE_WRAP = 32
-TBSTATE_ELLIPSES = 64
-TBSTATE_MARKED = 128
-TBSTYLE_BUTTON = 0
-TBSTYLE_SEP = 1
-TBSTYLE_CHECK = 2
-TBSTYLE_GROUP = 4
-TBSTYLE_CHECKGROUP = TBSTYLE_GROUP | TBSTYLE_CHECK
-TBSTYLE_DROPDOWN = 8
-TBSTYLE_AUTOSIZE = 16  # automatically calculate the cx of the button
-TBSTYLE_NOPREFIX = 32  # if this button should not have accel prefix
-TBSTYLE_TOOLTIPS = 256
-TBSTYLE_WRAPABLE = 512
-TBSTYLE_ALTDRAG = 1024
-TBSTYLE_FLAT = 2048
-TBSTYLE_LIST = 4096
-TBSTYLE_CUSTOMERASE = 8192
-TBSTYLE_REGISTERDROP = 16384
-TBSTYLE_TRANSPARENT = 32768
-TBSTYLE_EX_DRAWDDARROWS = 1
-BTNS_BUTTON = TBSTYLE_BUTTON
-BTNS_SEP = TBSTYLE_SEP  # 0x0001
-BTNS_CHECK = TBSTYLE_CHECK  # 0x0002
-BTNS_GROUP = TBSTYLE_GROUP  # 0x0004
-BTNS_CHECKGROUP = TBSTYLE_CHECKGROUP  # (TBSTYLE_GROUP | TBSTYLE_CHECK)
-BTNS_DROPDOWN = TBSTYLE_DROPDOWN  # 0x0008
-BTNS_AUTOSIZE = TBSTYLE_AUTOSIZE  # 0x0010; automatically calculate the cx of the button
-BTNS_NOPREFIX = TBSTYLE_NOPREFIX  # 0x0020; this button should not have accel prefix
-BTNS_SHOWTEXT = (
-    64  # 0x0040              // ignored unless TBSTYLE_EX_MIXEDBUTTONS is set
-)
-BTNS_WHOLEDROPDOWN = (
-    128  # 0x0080          // draw drop-down arrow, but without split arrow section
-)
-TBCDRF_NOEDGES = 65536  # Don't draw button edges
-TBCDRF_HILITEHOTTRACK = 131072  # Use color of the button bk when hottracked
-TBCDRF_NOOFFSET = 262144  # Don't offset button if pressed
-TBCDRF_NOMARK = 524288  # Don't draw default highlight of image/text for TBSTATE_MARKED
-TBCDRF_NOETCHEDEFFECT = 1048576  # Don't draw etched effect for disabled items
-TB_ENABLEBUTTON = WM_USER + 1
-TB_CHECKBUTTON = WM_USER + 2
-TB_PRESSBUTTON = WM_USER + 3
-TB_HIDEBUTTON = WM_USER + 4
-TB_INDETERMINATE = WM_USER + 5
-TB_MARKBUTTON = WM_USER + 6
-TB_ISBUTTONENABLED = WM_USER + 9
-TB_ISBUTTONCHECKED = WM_USER + 10
-TB_ISBUTTONPRESSED = WM_USER + 11
-TB_ISBUTTONHIDDEN = WM_USER + 12
-TB_ISBUTTONINDETERMINATE = WM_USER + 13
-TB_ISBUTTONHIGHLIGHTED = WM_USER + 14
-TB_SETSTATE = WM_USER + 17
-TB_GETSTATE = WM_USER + 18
-TB_ADDBITMAP = WM_USER + 19
-HINST_COMMCTRL = -1
-IDB_STD_SMALL_COLOR = 0
-IDB_STD_LARGE_COLOR = 1
-IDB_VIEW_SMALL_COLOR = 4
-IDB_VIEW_LARGE_COLOR = 5
-IDB_HIST_SMALL_COLOR = 8
-IDB_HIST_LARGE_COLOR = 9
-STD_CUT = 0
-STD_COPY = 1
-STD_PASTE = 2
-STD_UNDO = 3
-STD_REDOW = 4
-STD_DELETE = 5
-STD_FILENEW = 6
-STD_FILEOPEN = 7
-STD_FILESAVE = 8
-STD_PRINTPRE = 9
-STD_PROPERTIES = 10
-STD_HELP = 11
-STD_FIND = 12
-STD_REPLACE = 13
-STD_PRINT = 14
-VIEW_LARGEICONS = 0
-VIEW_SMALLICONS = 1
-VIEW_LIST = 2
-VIEW_DETAILS = 3
-VIEW_SORTNAME = 4
-VIEW_SORTSIZE = 5
-VIEW_SORTDATE = 6
-VIEW_SORTTYPE = 7
-VIEW_PARENTFOLDER = 8
-VIEW_NETCONNECT = 9
-VIEW_NETDISCONNECT = 10
-VIEW_NEWFOLDER = 11
-VIEW_VIEWMENU = 12
-HIST_BACK = 0
-HIST_FORWARD = 1
-HIST_FAVORITES = 2
-HIST_ADDTOFAVORITES = 3
-HIST_VIEWTREE = 4
-TB_ADDBUTTONSA = WM_USER + 20
-TB_INSERTBUTTONA = WM_USER + 21
-TB_ADDBUTTONS = WM_USER + 20
-TB_INSERTBUTTON = WM_USER + 21
-TB_DELETEBUTTON = WM_USER + 22
-TB_GETBUTTON = WM_USER + 23
-TB_BUTTONCOUNT = WM_USER + 24
-TB_COMMANDTOINDEX = WM_USER + 25
-TB_SAVERESTOREA = WM_USER + 26
-TB_SAVERESTOREW = WM_USER + 76
-TB_CUSTOMIZE = WM_USER + 27
-TB_ADDSTRINGA = WM_USER + 28
-TB_ADDSTRINGW = WM_USER + 77
-TB_GETITEMRECT = WM_USER + 29
-TB_BUTTONSTRUCTSIZE = WM_USER + 30
-TB_SETBUTTONSIZE = WM_USER + 31
-TB_SETBITMAPSIZE = WM_USER + 32
-TB_AUTOSIZE = WM_USER + 33
-TB_GETTOOLTIPS = WM_USER + 35
-TB_SETTOOLTIPS = WM_USER + 36
-TB_SETPARENT = WM_USER + 37
-TB_SETROWS = WM_USER + 39
-TB_GETROWS = WM_USER + 40
-TB_SETCMDID = WM_USER + 42
-TB_CHANGEBITMAP = WM_USER + 43
-TB_GETBITMAP = WM_USER + 44
-TB_GETBUTTONTEXTA = WM_USER + 45
-TB_GETBUTTONTEXTW = WM_USER + 75
-TB_REPLACEBITMAP = WM_USER + 46
-TB_SETINDENT = WM_USER + 47
-TB_SETIMAGELIST = WM_USER + 48
-TB_GETIMAGELIST = WM_USER + 49
-TB_LOADIMAGES = WM_USER + 50
-TB_GETRECT = WM_USER + 51  # wParam is the Cmd instead of index
-TB_SETHOTIMAGELIST = WM_USER + 52
-TB_GETHOTIMAGELIST = WM_USER + 53
-TB_SETDISABLEDIMAGELIST = WM_USER + 54
-TB_GETDISABLEDIMAGELIST = WM_USER + 55
-TB_SETSTYLE = WM_USER + 56
-TB_GETSTYLE = WM_USER + 57
-TB_GETBUTTONSIZE = WM_USER + 58
-TB_SETBUTTONWIDTH = WM_USER + 59
-TB_SETMAXTEXTROWS = WM_USER + 60
-TB_GETTEXTROWS = WM_USER + 61
-TB_GETBUTTONTEXT = TB_GETBUTTONTEXTA
-TB_SAVERESTORE = TB_SAVERESTOREA
-TB_ADDSTRING = TB_ADDSTRINGA
-TB_GETOBJECT = WM_USER + 62  # wParam == IID, lParam void **ppv
-TB_GETHOTITEM = WM_USER + 71
-TB_SETHOTITEM = WM_USER + 72  # wParam == iHotItem
-TB_SETANCHORHIGHLIGHT = WM_USER + 73  # wParam == TRUE/FALSE
-TB_GETANCHORHIGHLIGHT = WM_USER + 74
-TB_MAPACCELERATORA = WM_USER + 78  # wParam == ch, lParam int * pidBtn
-TBIMHT_AFTER = 1  # TRUE = insert After iButton, otherwise before
-TBIMHT_BACKGROUND = 2  # TRUE iff missed buttons completely
-TB_GETINSERTMARK = WM_USER + 79  # lParam == LPTBINSERTMARK
-TB_SETINSERTMARK = WM_USER + 80  # lParam == LPTBINSERTMARK
-TB_INSERTMARKHITTEST = WM_USER + 81  # wParam == LPPOINT lParam == LPTBINSERTMARK
-TB_MOVEBUTTON = WM_USER + 82
-TB_GETMAXSIZE = WM_USER + 83  # lParam == LPSIZE
-TB_SETEXTENDEDSTYLE = WM_USER + 84  # For TBSTYLE_EX_*
-TB_GETEXTENDEDSTYLE = WM_USER + 85  # For TBSTYLE_EX_*
-TB_GETPADDING = WM_USER + 86
-TB_SETPADDING = WM_USER + 87
-TB_SETINSERTMARKCOLOR = WM_USER + 88
-TB_GETINSERTMARKCOLOR = WM_USER + 89
-TB_SETCOLORSCHEME = CCM_SETCOLORSCHEME  # lParam is color scheme
-TB_GETCOLORSCHEME = CCM_GETCOLORSCHEME  # fills in COLORSCHEME pointed to by lParam
-TB_SETUNICODEFORMAT = CCM_SETUNICODEFORMAT
-TB_GETUNICODEFORMAT = CCM_GETUNICODEFORMAT
-TB_MAPACCELERATORW = WM_USER + 90  # wParam == ch, lParam int * pidBtn
-TB_MAPACCELERATOR = TB_MAPACCELERATORA
-TBBF_LARGE = 1
-TB_GETBITMAPFLAGS = WM_USER + 41
-TBIF_IMAGE = 1
-TBIF_TEXT = 2
-TBIF_STATE = 4
-TBIF_STYLE = 8
-TBIF_LPARAM = 16
-TBIF_COMMAND = 32
-TBIF_SIZE = 64
-TB_GETBUTTONINFOW = WM_USER + 63
-TB_SETBUTTONINFOW = WM_USER + 64
-TB_GETBUTTONINFOA = WM_USER + 65
-TB_SETBUTTONINFOA = WM_USER + 66
-TB_INSERTBUTTONW = WM_USER + 67
-TB_ADDBUTTONSW = WM_USER + 68
-TB_HITTEST = WM_USER + 69
-TB_SETDRAWTEXTFLAGS = WM_USER + 70  # wParam == mask lParam == bit values
-TBN_GETBUTTONINFOA = TBN_FIRST - 0
-TBN_GETBUTTONINFOW = TBN_FIRST - 20
-TBN_BEGINDRAG = TBN_FIRST - 1
-TBN_ENDDRAG = TBN_FIRST - 2
-TBN_BEGINADJUST = TBN_FIRST - 3
-TBN_ENDADJUST = TBN_FIRST - 4
-TBN_RESET = TBN_FIRST - 5
-TBN_QUERYINSERT = TBN_FIRST - 6
-TBN_QUERYDELETE = TBN_FIRST - 7
-TBN_TOOLBARCHANGE = TBN_FIRST - 8
-TBN_CUSTHELP = TBN_FIRST - 9
-TBN_DROPDOWN = TBN_FIRST - 10
-TBN_GETOBJECT = TBN_FIRST - 12
-HICF_OTHER = 0
-HICF_MOUSE = 1  # Triggered by mouse
-HICF_ARROWKEYS = 2  # Triggered by arrow keys
-HICF_ACCELERATOR = 4  # Triggered by accelerator
-HICF_DUPACCEL = 8  # This accelerator is not unique
-HICF_ENTERING = 16  # idOld is invalid
-HICF_LEAVING = 32  # idNew is invalid
-HICF_RESELECT = 64  # hot item reselected
-TBN_HOTITEMCHANGE = TBN_FIRST - 13
-TBN_DRAGOUT = (
-    TBN_FIRST - 14
-)  # this is sent when the user clicks down on a button then drags off the button
-TBN_DELETINGBUTTON = TBN_FIRST - 15  # uses TBNOTIFY
-TBN_GETDISPINFOA = (
-    TBN_FIRST - 16
-)  # This is sent when the  toolbar needs  some display information
-TBN_GETDISPINFOW = (
-    TBN_FIRST - 17
-)  # This is sent when the  toolbar needs  some display information
-TBN_GETINFOTIPA = TBN_FIRST - 18
-TBN_GETINFOTIPW = TBN_FIRST - 19
-TBN_GETINFOTIP = TBN_GETINFOTIPA
-TBNF_IMAGE = 1
-TBNF_TEXT = 2
-TBNF_DI_SETITEM = 268435456
-TBN_GETDISPINFO = TBN_GETDISPINFOA
-TBDDRET_DEFAULT = 0
-TBDDRET_NODEFAULT = 1
-TBDDRET_TREATPRESSED = 2  # Treat as a standard press button
-TBN_GETBUTTONINFO = TBN_GETBUTTONINFOA
-REBARCLASSNAMEA = "ReBarWindow32"
-REBARCLASSNAME = REBARCLASSNAMEA
-RBIM_IMAGELIST = 1
-RBS_TOOLTIPS = 256
-RBS_VARHEIGHT = 512
-RBS_BANDBORDERS = 1024
-RBS_FIXEDORDER = 2048
-RBS_REGISTERDROP = 4096
-RBS_AUTOSIZE = 8192
-RBS_VERTICALGRIPPER = (
-    16384  # this always has the vertical gripper (default for horizontal mode)
-)
-RBS_DBLCLKTOGGLE = 32768
-RBBS_BREAK = 1  # break to new line
-RBBS_FIXEDSIZE = 2  # band can't be sized
-RBBS_CHILDEDGE = 4  # edge around top & bottom of child window
-RBBS_HIDDEN = 8  # don't show
-RBBS_NOVERT = 16  # don't show when vertical
-RBBS_FIXEDBMP = 32  # bitmap doesn't move during band resize
-RBBS_VARIABLEHEIGHT = 64  # allow autosizing of this child vertically
-RBBS_GRIPPERALWAYS = 128  # always show the gripper
-RBBS_NOGRIPPER = 256  # never show the gripper
-RBBIM_STYLE = 1
-RBBIM_COLORS = 2
-RBBIM_TEXT = 4
-RBBIM_IMAGE = 8
-RBBIM_CHILD = 16
-RBBIM_CHILDSIZE = 32
-RBBIM_SIZE = 64
-RBBIM_BACKGROUND = 128
-RBBIM_ID = 256
-RBBIM_IDEALSIZE = 512
-RBBIM_LPARAM = 1024
-RB_INSERTBANDA = WM_USER + 1
-RB_DELETEBAND = WM_USER + 2
-RB_GETBARINFO = WM_USER + 3
-RB_SETBARINFO = WM_USER + 4
-RB_SETBANDINFOA = WM_USER + 6
-RB_SETPARENT = WM_USER + 7
-RB_HITTEST = WM_USER + 8
-RB_GETRECT = WM_USER + 9
-RB_INSERTBANDW = WM_USER + 10
-RB_SETBANDINFOW = WM_USER + 11
-RB_GETBANDCOUNT = WM_USER + 12
-RB_GETROWCOUNT = WM_USER + 13
-RB_GETROWHEIGHT = WM_USER + 14
-RB_IDTOINDEX = WM_USER + 16  # wParam == id
-RB_GETTOOLTIPS = WM_USER + 17
-RB_SETTOOLTIPS = WM_USER + 18
-RB_SETBKCOLOR = WM_USER + 19  # sets the default BK color
-RB_GETBKCOLOR = WM_USER + 20  # defaults to CLR_NONE
-RB_SETTEXTCOLOR = WM_USER + 21
-RB_GETTEXTCOLOR = WM_USER + 22  # defaults to 0x00000000
-RB_SIZETORECT = (
-    WM_USER + 23
-)  # resize the rebar/break bands and such to this rect (lparam)
-RB_SETCOLORSCHEME = CCM_SETCOLORSCHEME  # lParam is color scheme
-RB_GETCOLORSCHEME = CCM_GETCOLORSCHEME  # fills in COLORSCHEME pointed to by lParam
-RB_INSERTBAND = RB_INSERTBANDA
-RB_SETBANDINFO = RB_SETBANDINFOA
-RB_BEGINDRAG = WM_USER + 24
-RB_ENDDRAG = WM_USER + 25
-RB_DRAGMOVE = WM_USER + 26
-RB_GETBARHEIGHT = WM_USER + 27
-RB_GETBANDINFOW = WM_USER + 28
-RB_GETBANDINFOA = WM_USER + 29
-RB_GETBANDINFO = RB_GETBANDINFOA
-RB_MINIMIZEBAND = WM_USER + 30
-RB_MAXIMIZEBAND = WM_USER + 31
-RB_GETDROPTARGET = CCM_GETDROPTARGET
-RB_GETBANDBORDERS = (
-    WM_USER + 34
-)  # returns in lparam = lprc the amount of edges added to band wparam
-RB_SHOWBAND = WM_USER + 35  # show/hide band
-RB_SETPALETTE = WM_USER + 37
-RB_GETPALETTE = WM_USER + 38
-RB_MOVEBAND = WM_USER + 39
-RB_SETUNICODEFORMAT = CCM_SETUNICODEFORMAT
-RB_GETUNICODEFORMAT = CCM_GETUNICODEFORMAT
-RBN_HEIGHTCHANGE = RBN_FIRST - 0
-RBN_GETOBJECT = RBN_FIRST - 1
-RBN_LAYOUTCHANGED = RBN_FIRST - 2
-RBN_AUTOSIZE = RBN_FIRST - 3
-RBN_BEGINDRAG = RBN_FIRST - 4
-RBN_ENDDRAG = RBN_FIRST - 5
-RBN_DELETINGBAND = RBN_FIRST - 6  # Uses NMREBAR
-RBN_DELETEDBAND = RBN_FIRST - 7  # Uses NMREBAR
-RBN_CHILDSIZE = RBN_FIRST - 8
-RBNM_ID = 1
-RBNM_STYLE = 2
-RBNM_LPARAM = 4
-RBHT_NOWHERE = 1
-RBHT_CAPTION = 2
-RBHT_CLIENT = 3
-RBHT_GRABBER = 4
-TOOLTIPS_CLASSA = "tooltips_class32"
-TOOLTIPS_CLASS = TOOLTIPS_CLASSA
-TTS_ALWAYSTIP = 1
-TTS_NOPREFIX = 2
-TTF_IDISHWND = 1
-TTF_CENTERTIP = 2
-TTF_RTLREADING = 4
-TTF_SUBCLASS = 16
-TTF_TRACK = 32
-TTF_ABSOLUTE = 128
-TTF_TRANSPARENT = 256
-TTF_DI_SETITEM = 32768  # valid only on the TTN_NEEDTEXT callback
-TTDT_AUTOMATIC = 0
-TTDT_RESHOW = 1
-TTDT_AUTOPOP = 2
-TTDT_INITIAL = 3
-TTM_ACTIVATE = WM_USER + 1
-TTM_SETDELAYTIME = WM_USER + 3
-TTM_ADDTOOLA = WM_USER + 4
-TTM_ADDTOOLW = WM_USER + 50
-TTM_DELTOOLA = WM_USER + 5
-TTM_DELTOOLW = WM_USER + 51
-TTM_NEWTOOLRECTA = WM_USER + 6
-TTM_NEWTOOLRECTW = WM_USER + 52
-TTM_RELAYEVENT = WM_USER + 7
-TTM_GETTOOLINFOA = WM_USER + 8
-TTM_GETTOOLINFOW = WM_USER + 53
-TTM_SETTOOLINFOA = WM_USER + 9
-TTM_SETTOOLINFOW = WM_USER + 54
-TTM_HITTESTA = WM_USER + 10
-TTM_HITTESTW = WM_USER + 55
-TTM_GETTEXTA = WM_USER + 11
-TTM_GETTEXTW = WM_USER + 56
-TTM_UPDATETIPTEXTA = WM_USER + 12
-TTM_UPDATETIPTEXTW = WM_USER + 57
-TTM_GETTOOLCOUNT = WM_USER + 13
-TTM_ENUMTOOLSA = WM_USER + 14
-TTM_ENUMTOOLSW = WM_USER + 58
-TTM_GETCURRENTTOOLA = WM_USER + 15
-TTM_GETCURRENTTOOLW = WM_USER + 59
-TTM_WINDOWFROMPOINT = WM_USER + 16
-TTM_TRACKACTIVATE = WM_USER + 17  # wParam = TRUE/FALSE start end  lparam = LPTOOLINFO
-TTM_TRACKPOSITION = WM_USER + 18  # lParam = dwPos
-TTM_SETTIPBKCOLOR = WM_USER + 19
-TTM_SETTIPTEXTCOLOR = WM_USER + 20
-TTM_GETDELAYTIME = WM_USER + 21
-TTM_GETTIPBKCOLOR = WM_USER + 22
-TTM_GETTIPTEXTCOLOR = WM_USER + 23
-TTM_SETMAXTIPWIDTH = WM_USER + 24
-TTM_GETMAXTIPWIDTH = WM_USER + 25
-TTM_SETMARGIN = WM_USER + 26  # lParam = lprc
-TTM_GETMARGIN = WM_USER + 27  # lParam = lprc
-TTM_POP = WM_USER + 28
-TTM_UPDATE = WM_USER + 29
-TTM_ADDTOOL = TTM_ADDTOOLA
-TTM_DELTOOL = TTM_DELTOOLA
-TTM_NEWTOOLRECT = TTM_NEWTOOLRECTA
-TTM_GETTOOLINFO = TTM_GETTOOLINFOA
-TTM_SETTOOLINFO = TTM_SETTOOLINFOA
-TTM_HITTEST = TTM_HITTESTA
-TTM_GETTEXT = TTM_GETTEXTA
-TTM_UPDATETIPTEXT = TTM_UPDATETIPTEXTA
-TTM_ENUMTOOLS = TTM_ENUMTOOLSA
-TTM_GETCURRENTTOOL = TTM_GETCURRENTTOOLA
-TTN_GETDISPINFOA = TTN_FIRST - 0
-TTN_GETDISPINFOW = TTN_FIRST - 10
-TTN_SHOW = TTN_FIRST - 1
-TTN_POP = TTN_FIRST - 2
-TTN_GETDISPINFO = TTN_GETDISPINFOA
-TTN_NEEDTEXT = TTN_GETDISPINFO
-TTN_NEEDTEXTA = TTN_GETDISPINFOA
-TTN_NEEDTEXTW = TTN_GETDISPINFOW
-SBARS_SIZEGRIP = 256
-SBARS_TOOLTIPS = 2048
-STATUSCLASSNAMEA = "msctls_statusbar32"
-STATUSCLASSNAME = STATUSCLASSNAMEA
-SB_SETTEXTA = WM_USER + 1
-SB_SETTEXTW = WM_USER + 11
-SB_GETTEXTA = WM_USER + 2
-SB_GETTEXTW = WM_USER + 13
-SB_GETTEXTLENGTHA = WM_USER + 3
-SB_GETTEXTLENGTHW = WM_USER + 12
-SB_GETTEXT = SB_GETTEXTA
-SB_SETTEXT = SB_SETTEXTA
-SB_GETTEXTLENGTH = SB_GETTEXTLENGTHA
-SB_SETPARTS = WM_USER + 4
-SB_GETPARTS = WM_USER + 6
-SB_GETBORDERS = WM_USER + 7
-SB_SETMINHEIGHT = WM_USER + 8
-SB_SIMPLE = WM_USER + 9
-SB_GETRECT = WM_USER + 10
-SB_ISSIMPLE = WM_USER + 14
-SB_SETICON = WM_USER + 15
-SB_SETTIPTEXTA = WM_USER + 16
-SB_SETTIPTEXTW = WM_USER + 17
-SB_GETTIPTEXTA = WM_USER + 18
-SB_GETTIPTEXTW = WM_USER + 19
-SB_GETICON = WM_USER + 20
-SB_SETTIPTEXT = SB_SETTIPTEXTA
-SB_GETTIPTEXT = SB_GETTIPTEXTA
-SB_SETUNICODEFORMAT = CCM_SETUNICODEFORMAT
-SB_GETUNICODEFORMAT = CCM_GETUNICODEFORMAT
-SBT_OWNERDRAW = 4096
-SBT_NOBORDERS = 256
-SBT_POPOUT = 512
-SBT_RTLREADING = 1024
-SBT_NOTABPARSING = 2048
-SBT_TOOLTIPS = 2048
-SB_SETBKCOLOR = CCM_SETBKCOLOR  # lParam = bkColor
-SBN_SIMPLEMODECHANGE = SBN_FIRST - 0
-TRACKBAR_CLASSA = "msctls_trackbar32"
-TRACKBAR_CLASS = TRACKBAR_CLASSA
-TBS_AUTOTICKS = 1
-TBS_VERT = 2
-TBS_HORZ = 0
-TBS_TOP = 4
-TBS_BOTTOM = 0
-TBS_LEFT = 4
-TBS_RIGHT = 0
-TBS_BOTH = 8
-TBS_NOTICKS = 16
-TBS_ENABLESELRANGE = 32
-TBS_FIXEDLENGTH = 64
-TBS_NOTHUMB = 128
-TBS_TOOLTIPS = 256
-TBM_GETPOS = WM_USER
-TBM_GETRANGEMIN = WM_USER + 1
-TBM_GETRANGEMAX = WM_USER + 2
-TBM_GETTIC = WM_USER + 3
-TBM_SETTIC = WM_USER + 4
-TBM_SETPOS = WM_USER + 5
-TBM_SETRANGE = WM_USER + 6
-TBM_SETRANGEMIN = WM_USER + 7
-TBM_SETRANGEMAX = WM_USER + 8
-TBM_CLEARTICS = WM_USER + 9
-TBM_SETSEL = WM_USER + 10
-TBM_SETSELSTART = WM_USER + 11
-TBM_SETSELEND = WM_USER + 12
-TBM_GETPTICS = WM_USER + 14
-TBM_GETTICPOS = WM_USER + 15
-TBM_GETNUMTICS = WM_USER + 16
-TBM_GETSELSTART = WM_USER + 17
-TBM_GETSELEND = WM_USER + 18
-TBM_CLEARSEL = WM_USER + 19
-TBM_SETTICFREQ = WM_USER + 20
-TBM_SETPAGESIZE = WM_USER + 21
-TBM_GETPAGESIZE = WM_USER + 22
-TBM_SETLINESIZE = WM_USER + 23
-TBM_GETLINESIZE = WM_USER + 24
-TBM_GETTHUMBRECT = WM_USER + 25
-TBM_GETCHANNELRECT = WM_USER + 26
-TBM_SETTHUMBLENGTH = WM_USER + 27
-TBM_GETTHUMBLENGTH = WM_USER + 28
-TBM_SETTOOLTIPS = WM_USER + 29
-TBM_GETTOOLTIPS = WM_USER + 30
-TBM_SETTIPSIDE = WM_USER + 31
-TBTS_TOP = 0
-TBTS_LEFT = 1
-TBTS_BOTTOM = 2
-TBTS_RIGHT = 3
-TBM_SETBUDDY = WM_USER + 32  # wparam = BOOL fLeft; (or right)
-TBM_GETBUDDY = WM_USER + 33  # wparam = BOOL fLeft; (or right)
-TBM_SETUNICODEFORMAT = CCM_SETUNICODEFORMAT
-TBM_GETUNICODEFORMAT = CCM_GETUNICODEFORMAT
-TB_LINEUP = 0
-TB_LINEDOWN = 1
-TB_PAGEUP = 2
-TB_PAGEDOWN = 3
-TB_THUMBPOSITION = 4
-TB_THUMBTRACK = 5
-TB_TOP = 6
-TB_BOTTOM = 7
-TB_ENDTRACK = 8
-TBCD_TICS = 1
-TBCD_THUMB = 2
-TBCD_CHANNEL = 3
-DL_BEGINDRAG = WM_USER + 133
-DL_DRAGGING = WM_USER + 134
-DL_DROPPED = WM_USER + 135
-DL_CANCELDRAG = WM_USER + 136
-DL_CURSORSET = 0
-DL_STOPCURSOR = 1
-DL_COPYCURSOR = 2
-DL_MOVECURSOR = 3
-DRAGLISTMSGSTRING = "commctrl_DragListMsg"
-UPDOWN_CLASSA = "msctls_updown32"
-UPDOWN_CLASS = UPDOWN_CLASSA
-UD_MAXVAL = 32767
-UD_MINVAL = -UD_MAXVAL
-UDS_WRAP = 1
-UDS_SETBUDDYINT = 2
-UDS_ALIGNRIGHT = 4
-UDS_ALIGNLEFT = 8
-UDS_AUTOBUDDY = 16
-UDS_ARROWKEYS = 32
-UDS_HORZ = 64
-UDS_NOTHOUSANDS = 128
-UDS_HOTTRACK = 256
-UDM_SETRANGE = WM_USER + 101
-UDM_GETRANGE = WM_USER + 102
-UDM_SETPOS = WM_USER + 103
-UDM_GETPOS = WM_USER + 104
-UDM_SETBUDDY = WM_USER + 105
-UDM_GETBUDDY = WM_USER + 106
-UDM_SETACCEL = WM_USER + 107
-UDM_GETACCEL = WM_USER + 108
-UDM_SETBASE = WM_USER + 109
-UDM_GETBASE = WM_USER + 110
-UDM_SETRANGE32 = WM_USER + 111
-UDM_GETRANGE32 = WM_USER + 112  # wParam & lParam are LPINT
-UDM_SETUNICODEFORMAT = CCM_SETUNICODEFORMAT
-UDM_GETUNICODEFORMAT = CCM_GETUNICODEFORMAT
-UDN_DELTAPOS = UDN_FIRST - 1
-PROGRESS_CLASSA = "msctls_progress32"
-PROGRESS_CLASS = PROGRESS_CLASSA
-PBS_SMOOTH = 1
-PBS_VERTICAL = 4
-PBM_SETRANGE = WM_USER + 1
-PBM_SETPOS = WM_USER + 2
-PBM_DELTAPOS = WM_USER + 3
-PBM_SETSTEP = WM_USER + 4
-PBM_STEPIT = WM_USER + 5
-PBM_SETRANGE32 = WM_USER + 6  # lParam = high, wParam = low
-PBM_GETRANGE = (
-    WM_USER + 7
-)  # wParam = return (TRUE ? low : high). lParam = PPBRANGE or NULL
-PBM_GETPOS = WM_USER + 8
-PBM_SETBARCOLOR = WM_USER + 9  # lParam = bar color
-PBM_SETBKCOLOR = CCM_SETBKCOLOR  # lParam = bkColor
-HOTKEYF_SHIFT = 1
-HOTKEYF_CONTROL = 2
-HOTKEYF_ALT = 4
-HOTKEYF_EXT = 8
-HKCOMB_NONE = 1
-HKCOMB_S = 2
-HKCOMB_C = 4
-HKCOMB_A = 8
-HKCOMB_SC = 16
-HKCOMB_SA = 32
-HKCOMB_CA = 64
-HKCOMB_SCA = 128
-HKM_SETHOTKEY = WM_USER + 1
-HKM_GETHOTKEY = WM_USER + 2
-HKM_SETRULES = WM_USER + 3
-HOTKEY_CLASSA = "msctls_hotkey32"
-HOTKEY_CLASS = HOTKEY_CLASSA
-CCS_TOP = 0x00000001
-CCS_NOMOVEY = 0x00000002
-CCS_BOTTOM = 0x00000003
-CCS_NORESIZE = 0x00000004
-CCS_NOPARENTALIGN = 0x00000008
-CCS_ADJUSTABLE = 0x00000020
-CCS_NODIVIDER = 0x00000040
-CCS_VERT = 0x00000080
-CCS_LEFT = CCS_VERT | CCS_TOP
-CCS_RIGHT = CCS_VERT | CCS_BOTTOM
-CCS_NOMOVEX = CCS_VERT | CCS_NOMOVEY
-WC_LISTVIEWA = "SysListView32"
-WC_LISTVIEW = WC_LISTVIEWA
-LVS_ICON = 0
-LVS_REPORT = 1
-LVS_SMALLICON = 2
-LVS_LIST = 3
-LVS_TYPEMASK = 3
-LVS_SINGLESEL = 4
-LVS_SHOWSELALWAYS = 8
-LVS_SORTASCENDING = 16
-LVS_SORTDESCENDING = 32
-LVS_SHAREIMAGELISTS = 64
-LVS_NOLABELWRAP = 128
-LVS_AUTOARRANGE = 256
-LVS_EDITLABELS = 512
-LVS_OWNERDATA = 4096
-LVS_NOSCROLL = 8192
-LVS_TYPESTYLEMASK = 64512
-LVS_ALIGNTOP = 0
-LVS_ALIGNLEFT = 2048
-LVS_ALIGNMASK = 3072
-LVS_OWNERDRAWFIXED = 1024
-LVS_NOCOLUMNHEADER = 16384
-LVS_NOSORTHEADER = 32768
-LVM_SETUNICODEFORMAT = CCM_SETUNICODEFORMAT
-LVM_GETUNICODEFORMAT = CCM_GETUNICODEFORMAT
-LVM_GETBKCOLOR = LVM_FIRST + 0
-LVM_SETBKCOLOR = LVM_FIRST + 1
-LVM_GETIMAGELIST = LVM_FIRST + 2
-LVSIL_NORMAL = 0
-LVSIL_SMALL = 1
-LVSIL_STATE = 2
-LVM_SETIMAGELIST = LVM_FIRST + 3
-LVM_GETITEMCOUNT = LVM_FIRST + 4
-LVIF_TEXT = 1
-LVIF_IMAGE = 2
-LVIF_PARAM = 4
-LVIF_STATE = 8
-LVIF_INDENT = 16
-LVIF_NORECOMPUTE = 2048
-LVIS_FOCUSED = 1
-LVIS_SELECTED = 2
-LVIS_CUT = 4
-LVIS_DROPHILITED = 8
-LVIS_ACTIVATING = 32
-LVIS_OVERLAYMASK = 3840
-LVIS_STATEIMAGEMASK = 61440
-I_INDENTCALLBACK = -1
-LPSTR_TEXTCALLBACKA = -1
-LPSTR_TEXTCALLBACK = LPSTR_TEXTCALLBACKA
-I_IMAGECALLBACK = -1
-LVM_GETITEMA = LVM_FIRST + 5
-LVM_GETITEMW = LVM_FIRST + 75
-LVM_GETITEM = LVM_GETITEMA
-LVM_SETITEMA = LVM_FIRST + 6
-LVM_SETITEMW = LVM_FIRST + 76
-LVM_SETITEM = LVM_SETITEMA
-LVM_INSERTITEMA = LVM_FIRST + 7
-LVM_INSERTITEMW = LVM_FIRST + 77
-LVM_INSERTITEM = LVM_INSERTITEMA
-LVM_DELETEITEM = LVM_FIRST + 8
-LVM_DELETEALLITEMS = LVM_FIRST + 9
-LVM_GETCALLBACKMASK = LVM_FIRST + 10
-LVM_SETCALLBACKMASK = LVM_FIRST + 11
-LVNI_ALL = 0
-LVNI_FOCUSED = 1
-LVNI_SELECTED = 2
-LVNI_CUT = 4
-LVNI_DROPHILITED = 8
-LVNI_ABOVE = 256
-LVNI_BELOW = 512
-LVNI_TOLEFT = 1024
-LVNI_TORIGHT = 2048
-LVM_GETNEXTITEM = LVM_FIRST + 12
-LVFI_PARAM = 1
-LVFI_STRING = 2
-LVFI_PARTIAL = 8
-LVFI_WRAP = 32
-LVFI_NEARESTXY = 64
-LVM_FINDITEMA = LVM_FIRST + 13
-LVM_FINDITEMW = LVM_FIRST + 83
-LVM_FINDITEM = LVM_FINDITEMA
-LVIR_BOUNDS = 0
-LVIR_ICON = 1
-LVIR_LABEL = 2
-LVIR_SELECTBOUNDS = 3
-LVM_GETITEMRECT = LVM_FIRST + 14
-LVM_SETITEMPOSITION = LVM_FIRST + 15
-LVM_GETITEMPOSITION = LVM_FIRST + 16
-LVM_GETSTRINGWIDTHA = LVM_FIRST + 17
-LVM_GETSTRINGWIDTHW = LVM_FIRST + 87
-LVM_GETSTRINGWIDTH = LVM_GETSTRINGWIDTHA
-LVHT_NOWHERE = 1
-LVHT_ONITEMICON = 2
-LVHT_ONITEMLABEL = 4
-LVHT_ONITEMSTATEICON = 8
-LVHT_ONITEM = LVHT_ONITEMICON | LVHT_ONITEMLABEL | LVHT_ONITEMSTATEICON
-LVHT_ABOVE = 8
-LVHT_BELOW = 16
-LVHT_TORIGHT = 32
-LVHT_TOLEFT = 64
-LVM_HITTEST = LVM_FIRST + 18
-LVM_ENSUREVISIBLE = LVM_FIRST + 19
-LVM_SCROLL = LVM_FIRST + 20
-LVM_REDRAWITEMS = LVM_FIRST + 21
-LVA_DEFAULT = 0
-LVA_ALIGNLEFT = 1
-LVA_ALIGNTOP = 2
-LVA_SNAPTOGRID = 5
-LVM_ARRANGE = LVM_FIRST + 22
-LVM_EDITLABELA = LVM_FIRST + 23
-LVM_EDITLABELW = LVM_FIRST + 118
-LVM_EDITLABEL = LVM_EDITLABELA
-LVM_GETEDITCONTROL = LVM_FIRST + 24
-LVCF_FMT = 1
-LVCF_WIDTH = 2
-LVCF_TEXT = 4
-LVCF_SUBITEM = 8
-LVCF_IMAGE = 16
-LVCF_ORDER = 32
-LVCFMT_LEFT = 0
-LVCFMT_RIGHT = 1
-LVCFMT_CENTER = 2
-LVCFMT_JUSTIFYMASK = 3
-LVCFMT_IMAGE = 2048
-LVCFMT_BITMAP_ON_RIGHT = 4096
-LVCFMT_COL_HAS_IMAGES = 32768
-LVM_GETCOLUMNA = LVM_FIRST + 25
-LVM_GETCOLUMNW = LVM_FIRST + 95
-LVM_GETCOLUMN = LVM_GETCOLUMNA
-LVM_SETCOLUMNA = LVM_FIRST + 26
-LVM_SETCOLUMNW = LVM_FIRST + 96
-LVM_SETCOLUMN = LVM_SETCOLUMNA
-LVM_INSERTCOLUMNA = LVM_FIRST + 27
-LVM_INSERTCOLUMNW = LVM_FIRST + 97
-LVM_INSERTCOLUMN = LVM_INSERTCOLUMNA
-LVM_DELETECOLUMN = LVM_FIRST + 28
-LVM_GETCOLUMNWIDTH = LVM_FIRST + 29
-LVSCW_AUTOSIZE = -1
-LVSCW_AUTOSIZE_USEHEADER = -2
-LVM_SETCOLUMNWIDTH = LVM_FIRST + 30
-LVM_GETHEADER = LVM_FIRST + 31
-LVM_CREATEDRAGIMAGE = LVM_FIRST + 33
-LVM_GETVIEWRECT = LVM_FIRST + 34
-LVM_GETTEXTCOLOR = LVM_FIRST + 35
-LVM_SETTEXTCOLOR = LVM_FIRST + 36
-LVM_GETTEXTBKCOLOR = LVM_FIRST + 37
-LVM_SETTEXTBKCOLOR = LVM_FIRST + 38
-LVM_GETTOPINDEX = LVM_FIRST + 39
-LVM_GETCOUNTPERPAGE = LVM_FIRST + 40
-LVM_GETORIGIN = LVM_FIRST + 41
-LVM_UPDATE = LVM_FIRST + 42
-LVM_SETITEMSTATE = LVM_FIRST + 43
-LVM_GETITEMSTATE = LVM_FIRST + 44
-LVM_GETITEMTEXTA = LVM_FIRST + 45
-LVM_GETITEMTEXTW = LVM_FIRST + 115
-LVM_GETITEMTEXT = LVM_GETITEMTEXTA
-LVM_SETITEMTEXTA = LVM_FIRST + 46
-LVM_SETITEMTEXTW = LVM_FIRST + 116
-LVM_SETITEMTEXT = LVM_SETITEMTEXTA
-LVSICF_NOINVALIDATEALL = 1
-LVSICF_NOSCROLL = 2
-LVM_SETITEMCOUNT = LVM_FIRST + 47
-LVM_SORTITEMS = LVM_FIRST + 48
-LVM_SETITEMPOSITION32 = LVM_FIRST + 49
-LVM_GETSELECTEDCOUNT = LVM_FIRST + 50
-LVM_GETITEMSPACING = LVM_FIRST + 51
-LVM_GETISEARCHSTRINGA = LVM_FIRST + 52
-LVM_GETISEARCHSTRINGW = LVM_FIRST + 117
-LVM_GETISEARCHSTRING = LVM_GETISEARCHSTRINGA
-LVM_SETICONSPACING = LVM_FIRST + 53
-LVM_SETEXTENDEDLISTVIEWSTYLE = LVM_FIRST + 54  # optional wParam == mask
-LVM_GETEXTENDEDLISTVIEWSTYLE = LVM_FIRST + 55
-LVS_EX_GRIDLINES = 1
-LVS_EX_SUBITEMIMAGES = 2
-LVS_EX_CHECKBOXES = 4
-LVS_EX_TRACKSELECT = 8
-LVS_EX_HEADERDRAGDROP = 16
-LVS_EX_FULLROWSELECT = 32  # applies to report mode only
-LVS_EX_ONECLICKACTIVATE = 64
-LVS_EX_TWOCLICKACTIVATE = 128
-LVS_EX_FLATSB = 256
-LVS_EX_REGIONAL = 512
-LVS_EX_INFOTIP = 1024  # listview does InfoTips for you
-LVS_EX_UNDERLINEHOT = 2048
-LVS_EX_UNDERLINECOLD = 4096
-LVS_EX_MULTIWORKAREAS = 8192
-LVM_GETSUBITEMRECT = LVM_FIRST + 56
-LVM_SUBITEMHITTEST = LVM_FIRST + 57
-LVM_SETCOLUMNORDERARRAY = LVM_FIRST + 58
-LVM_GETCOLUMNORDERARRAY = LVM_FIRST + 59
-LVM_SETHOTITEM = LVM_FIRST + 60
-LVM_GETHOTITEM = LVM_FIRST + 61
-LVM_SETHOTCURSOR = LVM_FIRST + 62
-LVM_GETHOTCURSOR = LVM_FIRST + 63
-LVM_APPROXIMATEVIEWRECT = LVM_FIRST + 64
-LV_MAX_WORKAREAS = 16
-LVM_SETWORKAREAS = LVM_FIRST + 65
-LVM_GETWORKAREAS = LVM_FIRST + 70
-LVM_GETNUMBEROFWORKAREAS = LVM_FIRST + 73
-LVM_GETSELECTIONMARK = LVM_FIRST + 66
-LVM_SETSELECTIONMARK = LVM_FIRST + 67
-LVM_SETHOVERTIME = LVM_FIRST + 71
-LVM_GETHOVERTIME = LVM_FIRST + 72
-LVM_SETTOOLTIPS = LVM_FIRST + 74
-LVM_GETTOOLTIPS = LVM_FIRST + 78
-LVBKIF_SOURCE_NONE = 0
-LVBKIF_SOURCE_HBITMAP = 1
-LVBKIF_SOURCE_URL = 2
-LVBKIF_SOURCE_MASK = 3
-LVBKIF_STYLE_NORMAL = 0
-LVBKIF_STYLE_TILE = 16
-LVBKIF_STYLE_MASK = 16
-LVM_SETBKIMAGEA = LVM_FIRST + 68
-LVM_SETBKIMAGEW = LVM_FIRST + 138
-LVM_GETBKIMAGEA = LVM_FIRST + 69
-LVM_GETBKIMAGEW = LVM_FIRST + 139
-LVKF_ALT = 1
-LVKF_CONTROL = 2
-LVKF_SHIFT = 4
-LVN_ITEMCHANGING = LVN_FIRST - 0
-LVN_ITEMCHANGED = LVN_FIRST - 1
-LVN_INSERTITEM = LVN_FIRST - 2
-LVN_DELETEITEM = LVN_FIRST - 3
-LVN_DELETEALLITEMS = LVN_FIRST - 4
-LVN_BEGINLABELEDITA = LVN_FIRST - 5
-LVN_BEGINLABELEDITW = LVN_FIRST - 75
-LVN_ENDLABELEDITA = LVN_FIRST - 6
-LVN_ENDLABELEDITW = LVN_FIRST - 76
-LVN_COLUMNCLICK = LVN_FIRST - 8
-LVN_BEGINDRAG = LVN_FIRST - 9
-LVN_BEGINRDRAG = LVN_FIRST - 11
-LVN_ODCACHEHINT = LVN_FIRST - 13
-LVN_ODFINDITEMA = LVN_FIRST - 52
-LVN_ODFINDITEMW = LVN_FIRST - 79
-LVN_ITEMACTIVATE = LVN_FIRST - 14
-LVN_ODSTATECHANGED = LVN_FIRST - 15
-LVN_ODFINDITEM = LVN_ODFINDITEMA
-LVN_HOTTRACK = LVN_FIRST - 21
-LVN_GETDISPINFOA = LVN_FIRST - 50
-LVN_GETDISPINFOW = LVN_FIRST - 77
-LVN_SETDISPINFOA = LVN_FIRST - 51
-LVN_SETDISPINFOW = LVN_FIRST - 78
-LVN_BEGINLABELEDIT = LVN_BEGINLABELEDITA
-LVN_ENDLABELEDIT = LVN_ENDLABELEDITA
-LVN_GETDISPINFO = LVN_GETDISPINFOA
-LVN_SETDISPINFO = LVN_SETDISPINFOA
-LVIF_DI_SETITEM = 4096
-LVN_KEYDOWN = LVN_FIRST - 55
-LVN_MARQUEEBEGIN = LVN_FIRST - 56
-LVGIT_UNFOLDED = 1
-LVN_GETINFOTIPA = LVN_FIRST - 57
-LVN_GETINFOTIPW = LVN_FIRST - 58
-LVN_GETINFOTIP = LVN_GETINFOTIPA
-WC_TREEVIEWA = "SysTreeView32"
-WC_TREEVIEW = WC_TREEVIEWA
-TVS_HASBUTTONS = 1
-TVS_HASLINES = 2
-TVS_LINESATROOT = 4
-TVS_EDITLABELS = 8
-TVS_DISABLEDRAGDROP = 16
-TVS_SHOWSELALWAYS = 32
-TVS_RTLREADING = 64
-TVS_NOTOOLTIPS = 128
-TVS_CHECKBOXES = 256
-TVS_TRACKSELECT = 512
-TVS_SINGLEEXPAND = 1024
-TVS_INFOTIP = 2048
-TVS_FULLROWSELECT = 4096
-TVS_NOSCROLL = 8192
-TVS_NONEVENHEIGHT = 16384
-TVIF_TEXT = 1
-TVIF_IMAGE = 2
-TVIF_PARAM = 4
-TVIF_STATE = 8
-TVIF_HANDLE = 16
-TVIF_SELECTEDIMAGE = 32
-TVIF_CHILDREN = 64
-TVIF_INTEGRAL = 128
-TVIS_SELECTED = 2
-TVIS_CUT = 4
-TVIS_DROPHILITED = 8
-TVIS_BOLD = 16
-TVIS_EXPANDED = 32
-TVIS_EXPANDEDONCE = 64
-TVIS_EXPANDPARTIAL = 128
-TVIS_OVERLAYMASK = 3840
-TVIS_STATEIMAGEMASK = 61440
-TVIS_USERMASK = 61440
-I_CHILDRENCALLBACK = -1
-TVI_ROOT = -65536
-TVI_FIRST = -65535
-TVI_LAST = -65534
-TVI_SORT = -65533
-TVM_INSERTITEMA = TV_FIRST + 0
-TVM_INSERTITEMW = TV_FIRST + 50
-TVM_INSERTITEM = TVM_INSERTITEMA
-TVM_DELETEITEM = TV_FIRST + 1
-TVM_EXPAND = TV_FIRST + 2
-TVE_COLLAPSE = 1
-TVE_EXPAND = 2
-TVE_TOGGLE = 3
-TVE_EXPANDPARTIAL = 16384
-TVE_COLLAPSERESET = 32768
-TVM_GETITEMRECT = TV_FIRST + 4
-TVM_GETCOUNT = TV_FIRST + 5
-TVM_GETINDENT = TV_FIRST + 6
-TVM_SETINDENT = TV_FIRST + 7
-TVM_GETIMAGELIST = TV_FIRST + 8
-TVSIL_NORMAL = 0
-TVSIL_STATE = 2
-TVM_SETIMAGELIST = TV_FIRST + 9
-TVM_GETNEXTITEM = TV_FIRST + 10
-TVGN_ROOT = 0
-TVGN_NEXT = 1
-TVGN_PREVIOUS = 2
-TVGN_PARENT = 3
-TVGN_CHILD = 4
-TVGN_FIRSTVISIBLE = 5
-TVGN_NEXTVISIBLE = 6
-TVGN_PREVIOUSVISIBLE = 7
-TVGN_DROPHILITE = 8
-TVGN_CARET = 9
-TVGN_LASTVISIBLE = 10
-TVM_SELECTITEM = TV_FIRST + 11
-TVM_GETITEMA = TV_FIRST + 12
-TVM_GETITEMW = TV_FIRST + 62
-TVM_GETITEM = TVM_GETITEMA
-TVM_SETITEMA = TV_FIRST + 13
-TVM_SETITEMW = TV_FIRST + 63
-TVM_SETITEM = TVM_SETITEMA
-TVM_EDITLABELA = TV_FIRST + 14
-TVM_EDITLABELW = TV_FIRST + 65
-TVM_EDITLABEL = TVM_EDITLABELA
-TVM_GETEDITCONTROL = TV_FIRST + 15
-TVM_GETVISIBLECOUNT = TV_FIRST + 16
-TVM_HITTEST = TV_FIRST + 17
-TVHT_NOWHERE = 1
-TVHT_ONITEMICON = 2
-TVHT_ONITEMLABEL = 4
-TVHT_ONITEMINDENT = 8
-TVHT_ONITEMBUTTON = 16
-TVHT_ONITEMRIGHT = 32
-TVHT_ONITEMSTATEICON = 64
-TVHT_ABOVE = 256
-TVHT_BELOW = 512
-TVHT_TORIGHT = 1024
-TVHT_TOLEFT = 2048
-TVHT_ONITEM = TVHT_ONITEMICON | TVHT_ONITEMLABEL | TVHT_ONITEMSTATEICON
-TVM_CREATEDRAGIMAGE = TV_FIRST + 18
-TVM_SORTCHILDREN = TV_FIRST + 19
-TVM_ENSUREVISIBLE = TV_FIRST + 20
-TVM_SORTCHILDRENCB = TV_FIRST + 21
-TVM_ENDEDITLABELNOW = TV_FIRST + 22
-TVM_GETISEARCHSTRINGA = TV_FIRST + 23
-TVM_GETISEARCHSTRINGW = TV_FIRST + 64
-TVM_GETISEARCHSTRING = TVM_GETISEARCHSTRINGA
-TVM_SETTOOLTIPS = TV_FIRST + 24
-TVM_GETTOOLTIPS = TV_FIRST + 25
-TVM_SETINSERTMARK = TV_FIRST + 26
-TVM_SETUNICODEFORMAT = CCM_SETUNICODEFORMAT
-TVM_GETUNICODEFORMAT = CCM_GETUNICODEFORMAT
-TVM_SETITEMHEIGHT = TV_FIRST + 27
-TVM_GETITEMHEIGHT = TV_FIRST + 28
-TVM_SETBKCOLOR = TV_FIRST + 29
-TVM_SETTEXTCOLOR = TV_FIRST + 30
-TVM_GETBKCOLOR = TV_FIRST + 31
-TVM_GETTEXTCOLOR = TV_FIRST + 32
-TVM_SETSCROLLTIME = TV_FIRST + 33
-TVM_GETSCROLLTIME = TV_FIRST + 34
-TVM_SETINSERTMARKCOLOR = TV_FIRST + 37
-TVM_GETINSERTMARKCOLOR = TV_FIRST + 38
-TVN_SELCHANGINGA = TVN_FIRST - 1
-TVN_SELCHANGINGW = TVN_FIRST - 50
-TVN_SELCHANGEDA = TVN_FIRST - 2
-TVN_SELCHANGEDW = TVN_FIRST - 51
-TVC_UNKNOWN = 0
-TVC_BYMOUSE = 1
-TVC_BYKEYBOARD = 2
-TVN_GETDISPINFOA = TVN_FIRST - 3
-TVN_GETDISPINFOW = TVN_FIRST - 52
-TVN_SETDISPINFOA = TVN_FIRST - 4
-TVN_SETDISPINFOW = TVN_FIRST - 53
-TVIF_DI_SETITEM = 4096
-TVN_ITEMEXPANDINGA = TVN_FIRST - 5
-TVN_ITEMEXPANDINGW = TVN_FIRST - 54
-TVN_ITEMEXPANDEDA = TVN_FIRST - 6
-TVN_ITEMEXPANDEDW = TVN_FIRST - 55
-TVN_BEGINDRAGA = TVN_FIRST - 7
-TVN_BEGINDRAGW = TVN_FIRST - 56
-TVN_BEGINRDRAGA = TVN_FIRST - 8
-TVN_BEGINRDRAGW = TVN_FIRST - 57
-TVN_DELETEITEMA = TVN_FIRST - 9
-TVN_DELETEITEMW = TVN_FIRST - 58
-TVN_BEGINLABELEDITA = TVN_FIRST - 10
-TVN_BEGINLABELEDITW = TVN_FIRST - 59
-TVN_ENDLABELEDITA = TVN_FIRST - 11
-TVN_ENDLABELEDITW = TVN_FIRST - 60
-TVN_KEYDOWN = TVN_FIRST - 12
-TVN_GETINFOTIPA = TVN_FIRST - 13
-TVN_GETINFOTIPW = TVN_FIRST - 14
-TVN_SINGLEEXPAND = TVN_FIRST - 15
-TVN_SELCHANGING = TVN_SELCHANGINGA
-TVN_SELCHANGED = TVN_SELCHANGEDA
-TVN_GETDISPINFO = TVN_GETDISPINFOA
-TVN_SETDISPINFO = TVN_SETDISPINFOA
-TVN_ITEMEXPANDING = TVN_ITEMEXPANDINGA
-TVN_ITEMEXPANDED = TVN_ITEMEXPANDEDA
-TVN_BEGINDRAG = TVN_BEGINDRAGA
-TVN_BEGINRDRAG = TVN_BEGINRDRAGA
-TVN_DELETEITEM = TVN_DELETEITEMA
-TVN_BEGINLABELEDIT = TVN_BEGINLABELEDITA
-TVN_ENDLABELEDIT = TVN_ENDLABELEDITA
-TVN_GETINFOTIP = TVN_GETINFOTIPA
-TVCDRF_NOIMAGES = 65536
-WC_COMBOBOXEXA = "ComboBoxEx32"
-WC_COMBOBOXEX = WC_COMBOBOXEXA
-CBEIF_TEXT = 1
-CBEIF_IMAGE = 2
-CBEIF_SELECTEDIMAGE = 4
-CBEIF_OVERLAY = 8
-CBEIF_INDENT = 16
-CBEIF_LPARAM = 32
-CBEIF_DI_SETITEM = 268435456
-CBEM_INSERTITEMA = WM_USER + 1
-CBEM_SETIMAGELIST = WM_USER + 2
-CBEM_GETIMAGELIST = WM_USER + 3
-CBEM_GETITEMA = WM_USER + 4
-CBEM_SETITEMA = WM_USER + 5
-# CBEM_DELETEITEM = CB_DELETESTRING
-CBEM_GETCOMBOCONTROL = WM_USER + 6
-CBEM_GETEDITCONTROL = WM_USER + 7
-CBEM_SETEXSTYLE = WM_USER + 8  # use  SETEXTENDEDSTYLE instead
-CBEM_SETEXTENDEDSTYLE = WM_USER + 14  # lparam == new style, wParam (optional) == mask
-CBEM_GETEXSTYLE = WM_USER + 9  # use GETEXTENDEDSTYLE instead
-CBEM_GETEXTENDEDSTYLE = WM_USER + 9
-CBEM_SETUNICODEFORMAT = CCM_SETUNICODEFORMAT
-CBEM_GETUNICODEFORMAT = CCM_GETUNICODEFORMAT
-CBEM_HASEDITCHANGED = WM_USER + 10
-CBEM_INSERTITEMW = WM_USER + 11
-CBEM_SETITEMW = WM_USER + 12
-CBEM_GETITEMW = WM_USER + 13
-CBEM_INSERTITEM = CBEM_INSERTITEMA
-CBEM_SETITEM = CBEM_SETITEMA
-CBEM_GETITEM = CBEM_GETITEMA
-CBES_EX_NOEDITIMAGE = 1
-CBES_EX_NOEDITIMAGEINDENT = 2
-CBES_EX_PATHWORDBREAKPROC = 4
-CBES_EX_NOSIZELIMIT = 8
-CBES_EX_CASESENSITIVE = 16
-CBEN_GETDISPINFO = CBEN_FIRST - 0
-CBEN_GETDISPINFOA = CBEN_FIRST - 0
-CBEN_INSERTITEM = CBEN_FIRST - 1
-CBEN_DELETEITEM = CBEN_FIRST - 2
-CBEN_BEGINEDIT = CBEN_FIRST - 4
-CBEN_ENDEDITA = CBEN_FIRST - 5
-CBEN_ENDEDITW = CBEN_FIRST - 6
-CBEN_GETDISPINFOW = CBEN_FIRST - 7
-CBEN_DRAGBEGINA = CBEN_FIRST - 8
-CBEN_DRAGBEGINW = CBEN_FIRST - 9
-CBEN_DRAGBEGIN = CBEN_DRAGBEGINA
-CBEN_ENDEDIT = CBEN_ENDEDITA
-CBENF_KILLFOCUS = 1
-CBENF_RETURN = 2
-CBENF_ESCAPE = 3
-CBENF_DROPDOWN = 4
-CBEMAXSTRLEN = 260
-WC_TABCONTROLA = "SysTabControl32"
-WC_TABCONTROL = WC_TABCONTROLA
-TCS_SCROLLOPPOSITE = 1  # assumes multiline tab
-TCS_BOTTOM = 2
-TCS_RIGHT = 2
-TCS_MULTISELECT = 4  # allow multi-select in button mode
-TCS_FLATBUTTONS = 8
-TCS_FORCEICONLEFT = 16
-TCS_FORCELABELLEFT = 32
-TCS_HOTTRACK = 64
-TCS_VERTICAL = 128
-TCS_TABS = 0
-TCS_BUTTONS = 256
-TCS_SINGLELINE = 0
-TCS_MULTILINE = 512
-TCS_RIGHTJUSTIFY = 0
-TCS_FIXEDWIDTH = 1024
-TCS_RAGGEDRIGHT = 2048
-TCS_FOCUSONBUTTONDOWN = 4096
-TCS_OWNERDRAWFIXED = 8192
-TCS_TOOLTIPS = 16384
-TCS_FOCUSNEVER = 32768
-TCS_EX_FLATSEPARATORS = 1
-TCS_EX_REGISTERDROP = 2
-TCM_GETIMAGELIST = TCM_FIRST + 2
-TCM_SETIMAGELIST = TCM_FIRST + 3
-TCM_GETITEMCOUNT = TCM_FIRST + 4
-TCIF_TEXT = 1
-TCIF_IMAGE = 2
-TCIF_RTLREADING = 4
-TCIF_PARAM = 8
-TCIF_STATE = 16
-TCIS_BUTTONPRESSED = 1
-TCIS_HIGHLIGHTED = 2
-TCM_GETITEMA = TCM_FIRST + 5
-TCM_GETITEMW = TCM_FIRST + 60
-TCM_GETITEM = TCM_GETITEMA
-TCM_SETITEMA = TCM_FIRST + 6
-TCM_SETITEMW = TCM_FIRST + 61
-TCM_SETITEM = TCM_SETITEMA
-TCM_INSERTITEMA = TCM_FIRST + 7
-TCM_INSERTITEMW = TCM_FIRST + 62
-TCM_INSERTITEM = TCM_INSERTITEMA
-TCM_DELETEITEM = TCM_FIRST + 8
-TCM_DELETEALLITEMS = TCM_FIRST + 9
-TCM_GETITEMRECT = TCM_FIRST + 10
-TCM_GETCURSEL = TCM_FIRST + 11
-TCM_SETCURSEL = TCM_FIRST + 12
-TCHT_NOWHERE = 1
-TCHT_ONITEMICON = 2
-TCHT_ONITEMLABEL = 4
-TCHT_ONITEM = TCHT_ONITEMICON | TCHT_ONITEMLABEL
-TCM_HITTEST = TCM_FIRST + 13
-TCM_SETITEMEXTRA = TCM_FIRST + 14
-TCM_ADJUSTRECT = TCM_FIRST + 40
-TCM_SETITEMSIZE = TCM_FIRST + 41
-TCM_REMOVEIMAGE = TCM_FIRST + 42
-TCM_SETPADDING = TCM_FIRST + 43
-TCM_GETROWCOUNT = TCM_FIRST + 44
-TCM_GETTOOLTIPS = TCM_FIRST + 45
-TCM_SETTOOLTIPS = TCM_FIRST + 46
-TCM_GETCURFOCUS = TCM_FIRST + 47
-TCM_SETCURFOCUS = TCM_FIRST + 48
-TCM_SETMINTABWIDTH = TCM_FIRST + 49
-TCM_DESELECTALL = TCM_FIRST + 50
-TCM_HIGHLIGHTITEM = TCM_FIRST + 51
-TCM_SETEXTENDEDSTYLE = TCM_FIRST + 52  # optional wParam == mask
-TCM_GETEXTENDEDSTYLE = TCM_FIRST + 53
-TCM_SETUNICODEFORMAT = CCM_SETUNICODEFORMAT
-TCM_GETUNICODEFORMAT = CCM_GETUNICODEFORMAT
-TCN_KEYDOWN = TCN_FIRST - 0
-ANIMATE_CLASSA = "SysAnimate32"
-ANIMATE_CLASS = ANIMATE_CLASSA
-ACS_CENTER = 1
-ACS_TRANSPARENT = 2
-ACS_AUTOPLAY = 4
-ACS_TIMER = 8  # don't use threads... use timers
-ACM_OPENA = WM_USER + 100
-ACM_OPENW = WM_USER + 103
-ACM_OPEN = ACM_OPENA
-ACM_PLAY = WM_USER + 101
-ACM_STOP = WM_USER + 102
-ACN_START = 1
-ACN_STOP = 2
-MONTHCAL_CLASSA = "SysMonthCal32"
-MONTHCAL_CLASS = MONTHCAL_CLASSA
-MCM_FIRST = 4096
-MCM_GETCURSEL = MCM_FIRST + 1
-MCM_SETCURSEL = MCM_FIRST + 2
-MCM_GETMAXSELCOUNT = MCM_FIRST + 3
-MCM_SETMAXSELCOUNT = MCM_FIRST + 4
-MCM_GETSELRANGE = MCM_FIRST + 5
-MCM_SETSELRANGE = MCM_FIRST + 6
-MCM_GETMONTHRANGE = MCM_FIRST + 7
-MCM_SETDAYSTATE = MCM_FIRST + 8
-MCM_GETMINREQRECT = MCM_FIRST + 9
-MCM_SETCOLOR = MCM_FIRST + 10
-MCM_GETCOLOR = MCM_FIRST + 11
-MCSC_BACKGROUND = 0  # the background color (between months)
-MCSC_TEXT = 1  # the dates
-MCSC_TITLEBK = 2  # background of the title
-MCSC_TITLETEXT = 3
-MCSC_MONTHBK = 4  # background within the month cal
-MCSC_TRAILINGTEXT = 5  # the text color of header & trailing days
-MCM_SETTODAY = MCM_FIRST + 12
-MCM_GETTODAY = MCM_FIRST + 13
-MCM_HITTEST = MCM_FIRST + 14
-MCHT_TITLE = 65536
-MCHT_CALENDAR = 131072
-MCHT_TODAYLINK = 196608
-MCHT_NEXT = 16777216  # these indicate that hitting
-MCHT_PREV = 33554432  # here will go to the next/prev month
-MCHT_NOWHERE = 0
-MCHT_TITLEBK = MCHT_TITLE
-MCHT_TITLEMONTH = MCHT_TITLE | 1
-MCHT_TITLEYEAR = MCHT_TITLE | 2
-MCHT_TITLEBTNNEXT = MCHT_TITLE | MCHT_NEXT | 3
-MCHT_TITLEBTNPREV = MCHT_TITLE | MCHT_PREV | 3
-MCHT_CALENDARBK = MCHT_CALENDAR
-MCHT_CALENDARDATE = MCHT_CALENDAR | 1
-MCHT_CALENDARDATENEXT = MCHT_CALENDARDATE | MCHT_NEXT
-MCHT_CALENDARDATEPREV = MCHT_CALENDARDATE | MCHT_PREV
-MCHT_CALENDARDAY = MCHT_CALENDAR | 2
-MCHT_CALENDARWEEKNUM = MCHT_CALENDAR | 3
-MCM_SETFIRSTDAYOFWEEK = MCM_FIRST + 15
-MCM_GETFIRSTDAYOFWEEK = MCM_FIRST + 16
-MCM_GETRANGE = MCM_FIRST + 17
-MCM_SETRANGE = MCM_FIRST + 18
-MCM_GETMONTHDELTA = MCM_FIRST + 19
-MCM_SETMONTHDELTA = MCM_FIRST + 20
-MCM_GETMAXTODAYWIDTH = MCM_FIRST + 21
-MCM_SETUNICODEFORMAT = CCM_SETUNICODEFORMAT
-MCM_GETUNICODEFORMAT = CCM_GETUNICODEFORMAT
-MCN_SELCHANGE = MCN_FIRST + 1
-MCN_GETDAYSTATE = MCN_FIRST + 3
-MCN_SELECT = MCN_FIRST + 4
-MCS_DAYSTATE = 1
-MCS_MULTISELECT = 2
-MCS_WEEKNUMBERS = 4
-MCS_NOTODAYCIRCLE = 8
-MCS_NOTODAY = 8
-GMR_VISIBLE = 0  # visible portion of display
-GMR_DAYSTATE = 1  # above plus the grayed out parts of
-DATETIMEPICK_CLASSA = "SysDateTimePick32"
-DATETIMEPICK_CLASS = DATETIMEPICK_CLASSA
-DTM_FIRST = 4096
-DTM_GETSYSTEMTIME = DTM_FIRST + 1
-DTM_SETSYSTEMTIME = DTM_FIRST + 2
-DTM_GETRANGE = DTM_FIRST + 3
-DTM_SETRANGE = DTM_FIRST + 4
-DTM_SETFORMATA = DTM_FIRST + 5
-DTM_SETFORMATW = DTM_FIRST + 50
-DTM_SETFORMAT = DTM_SETFORMATA
-DTM_SETMCCOLOR = DTM_FIRST + 6
-DTM_GETMCCOLOR = DTM_FIRST + 7
-DTM_GETMONTHCAL = DTM_FIRST + 8
-DTM_SETMCFONT = DTM_FIRST + 9
-DTM_GETMCFONT = DTM_FIRST + 10
-DTS_UPDOWN = 1  # use UPDOWN instead of MONTHCAL
-DTS_SHOWNONE = 2  # allow a NONE selection
-DTS_SHORTDATEFORMAT = (
-    0  # use the short date format (app must forward WM_WININICHANGE messages)
-)
-DTS_LONGDATEFORMAT = (
-    4  # use the long date format (app must forward WM_WININICHANGE messages)
-)
-DTS_TIMEFORMAT = 9  # use the time format (app must forward WM_WININICHANGE messages)
-DTS_APPCANPARSE = 16  # allow user entered strings (app MUST respond to DTN_USERSTRING)
-DTS_RIGHTALIGN = 32  # right-align popup instead of left-align it
-DTN_DATETIMECHANGE = DTN_FIRST + 1  # the systemtime has changed
-DTN_USERSTRINGA = DTN_FIRST + 2  # the user has entered a string
-DTN_USERSTRINGW = DTN_FIRST + 15
-DTN_USERSTRING = DTN_USERSTRINGW
-DTN_WMKEYDOWNA = DTN_FIRST + 3  # modify keydown on app format field (X)
-DTN_WMKEYDOWNW = DTN_FIRST + 16
-DTN_WMKEYDOWN = DTN_WMKEYDOWNA
-DTN_FORMATA = DTN_FIRST + 4  # query display for app format field (X)
-DTN_FORMATW = DTN_FIRST + 17
-DTN_FORMAT = DTN_FORMATA
-DTN_FORMATQUERYA = DTN_FIRST + 5  # query formatting info for app format field (X)
-DTN_FORMATQUERYW = DTN_FIRST + 18
-DTN_FORMATQUERY = DTN_FORMATQUERYA
-DTN_DROPDOWN = DTN_FIRST + 6  # MonthCal has dropped down
-DTN_CLOSEUP = DTN_FIRST + 7  # MonthCal is popping up
-GDTR_MIN = 1
-GDTR_MAX = 2
-GDT_ERROR = -1
-GDT_VALID = 0
-GDT_NONE = 1
-IPM_CLEARADDRESS = WM_USER + 100  # no parameters
-IPM_SETADDRESS = WM_USER + 101  # lparam = TCP/IP address
-IPM_GETADDRESS = (
-    WM_USER + 102
-)  # lresult = # of non black fields.  lparam = LPDWORD for TCP/IP address
-IPM_SETRANGE = WM_USER + 103  # wparam = field, lparam = range
-IPM_SETFOCUS = WM_USER + 104  # wparam = field
-IPM_ISBLANK = WM_USER + 105  # no parameters
-WC_IPADDRESSA = "SysIPAddress32"
-WC_IPADDRESS = WC_IPADDRESSA
-IPN_FIELDCHANGED = IPN_FIRST - 0
-WC_PAGESCROLLERA = "SysPager"
-WC_PAGESCROLLER = WC_PAGESCROLLERA
-PGS_VERT = 0
-PGS_HORZ = 1
-PGS_AUTOSCROLL = 2
-PGS_DRAGNDROP = 4
-PGF_INVISIBLE = 0  # Scroll button is not visible
-PGF_NORMAL = 1  # Scroll button is in normal state
-PGF_GRAYED = 2  # Scroll button is in grayed state
-PGF_DEPRESSED = 4  # Scroll button is in depressed state
-PGF_HOT = 8  # Scroll button is in hot state
-PGB_TOPORLEFT = 0
-PGB_BOTTOMORRIGHT = 1
-PGM_SETCHILD = PGM_FIRST + 1  # lParam == hwnd
-PGM_RECALCSIZE = PGM_FIRST + 2
-PGM_FORWARDMOUSE = PGM_FIRST + 3
-PGM_SETBKCOLOR = PGM_FIRST + 4
-PGM_GETBKCOLOR = PGM_FIRST + 5
-PGM_SETBORDER = PGM_FIRST + 6
-PGM_GETBORDER = PGM_FIRST + 7
-PGM_SETPOS = PGM_FIRST + 8
-PGM_GETPOS = PGM_FIRST + 9
-PGM_SETBUTTONSIZE = PGM_FIRST + 10
-PGM_GETBUTTONSIZE = PGM_FIRST + 11
-PGM_GETBUTTONSTATE = PGM_FIRST + 12
-PGM_GETDROPTARGET = CCM_GETDROPTARGET
-PGN_SCROLL = PGN_FIRST - 1
-PGF_SCROLLUP = 1
-PGF_SCROLLDOWN = 2
-PGF_SCROLLLEFT = 4
-PGF_SCROLLRIGHT = 8
-PGK_SHIFT = 1
-PGK_CONTROL = 2
-PGK_MENU = 4
-PGN_CALCSIZE = PGN_FIRST - 2
-PGF_CALCWIDTH = 1
-PGF_CALCHEIGHT = 2
-WC_NATIVEFONTCTLA = "NativeFontCtl"
-WC_NATIVEFONTCTL = WC_NATIVEFONTCTLA
-NFS_EDIT = 1
-NFS_STATIC = 2
-NFS_LISTCOMBO = 4
-NFS_BUTTON = 8
-NFS_ALL = 16
-WM_MOUSEHOVER = 673
-WM_MOUSELEAVE = 675
-TME_HOVER = 1
-TME_LEAVE = 2
-TME_QUERY = 1073741824
-TME_CANCEL = -2147483648
-HOVER_DEFAULT = -1
-WSB_PROP_CYVSCROLL = 0x00000001
-WSB_PROP_CXHSCROLL = 0x00000002
-WSB_PROP_CYHSCROLL = 0x00000004
-WSB_PROP_CXVSCROLL = 0x00000008
-WSB_PROP_CXHTHUMB = 0x00000010
-WSB_PROP_CYVTHUMB = 0x00000020
-WSB_PROP_VBKGCOLOR = 0x00000040
-WSB_PROP_HBKGCOLOR = 0x00000080
-WSB_PROP_VSTYLE = 0x00000100
-WSB_PROP_HSTYLE = 0x00000200
-WSB_PROP_WINSTYLE = 0x00000400
-WSB_PROP_PALETTE = 0x00000800
-WSB_PROP_MASK = 0x00000FFF
-FSB_FLAT_MODE = 2
-FSB_ENCARTA_MODE = 1
-FSB_REGULAR_MODE = 0
-
-
-def INDEXTOOVERLAYMASK(i):
-    return i << 8
-
-
-def INDEXTOSTATEIMAGEMASK(i):
-    return i << 12
diff --git a/lib/win32/lib/dbi.py b/lib/win32/lib/dbi.py
deleted file mode 100644
index c33d6721..00000000
--- a/lib/win32/lib/dbi.py
+++ /dev/null
@@ -1,27 +0,0 @@
-"""
-Skeleton replacement for removed dbi module.
-Use of objects created by this module should be replaced with native Python objects.
-Dates are now returned as datetime.datetime objects, but will still accept PyTime
-objects also.
-Raw data for binary fields should be passed as buffer objects for Python 2.x,
-and memoryview objects in Py3k.
-"""
-
-import warnings
-
-warnings.warn(
-    "dbi module is obsolete, code should now use native python datetime and buffer/memoryview objects",
-    DeprecationWarning,
-)
-
-import datetime
-
-dbDate = dbiDate = datetime.datetime
-
-try:
-    dbRaw = dbiRaw = buffer
-except NameError:
-    dbRaw = dbiRaw = memoryview
-
-# type names are still exported by odbc module
-from odbc import *
diff --git a/lib/win32/lib/mmsystem.py b/lib/win32/lib/mmsystem.py
deleted file mode 100644
index 4d36b5ef..00000000
--- a/lib/win32/lib/mmsystem.py
+++ /dev/null
@@ -1,954 +0,0 @@
-# Generated by h2py from d:/msdev/include/mmsystem.h
-MAXPNAMELEN = 32
-MAXERRORLENGTH = 256
-MAX_JOYSTICKOEMVXDNAME = 260
-MM_MICROSOFT = 1
-MM_MIDI_MAPPER = 1
-MM_WAVE_MAPPER = 2
-MM_SNDBLST_MIDIOUT = 3
-MM_SNDBLST_MIDIIN = 4
-MM_SNDBLST_SYNTH = 5
-MM_SNDBLST_WAVEOUT = 6
-MM_SNDBLST_WAVEIN = 7
-MM_ADLIB = 9
-MM_MPU401_MIDIOUT = 10
-MM_MPU401_MIDIIN = 11
-MM_PC_JOYSTICK = 12
-TIME_MS = 0x0001
-TIME_SAMPLES = 0x0002
-TIME_BYTES = 0x0004
-TIME_SMPTE = 0x0008
-TIME_MIDI = 0x0010
-TIME_TICKS = 0x0020
-MM_JOY1MOVE = 0x3A0
-MM_JOY2MOVE = 0x3A1
-MM_JOY1ZMOVE = 0x3A2
-MM_JOY2ZMOVE = 0x3A3
-MM_JOY1BUTTONDOWN = 0x3B5
-MM_JOY2BUTTONDOWN = 0x3B6
-MM_JOY1BUTTONUP = 0x3B7
-MM_JOY2BUTTONUP = 0x3B8
-MM_MCINOTIFY = 0x3B9
-MM_WOM_OPEN = 0x3BB
-MM_WOM_CLOSE = 0x3BC
-MM_WOM_DONE = 0x3BD
-MM_WIM_OPEN = 0x3BE
-MM_WIM_CLOSE = 0x3BF
-MM_WIM_DATA = 0x3C0
-MM_MIM_OPEN = 0x3C1
-MM_MIM_CLOSE = 0x3C2
-MM_MIM_DATA = 0x3C3
-MM_MIM_LONGDATA = 0x3C4
-MM_MIM_ERROR = 0x3C5
-MM_MIM_LONGERROR = 0x3C6
-MM_MOM_OPEN = 0x3C7
-MM_MOM_CLOSE = 0x3C8
-MM_MOM_DONE = 0x3C9
-MM_STREAM_OPEN = 0x3D4
-MM_STREAM_CLOSE = 0x3D5
-MM_STREAM_DONE = 0x3D6
-MM_STREAM_ERROR = 0x3D7
-MM_MOM_POSITIONCB = 0x3CA
-MM_MIM_MOREDATA = 0x3CC
-MM_MIXM_LINE_CHANGE = 0x3D0
-MM_MIXM_CONTROL_CHANGE = 0x3D1
-MMSYSERR_BASE = 0
-WAVERR_BASE = 32
-MIDIERR_BASE = 64
-TIMERR_BASE = 96
-JOYERR_BASE = 160
-MCIERR_BASE = 256
-MIXERR_BASE = 1024
-MCI_STRING_OFFSET = 512
-MCI_VD_OFFSET = 1024
-MCI_CD_OFFSET = 1088
-MCI_WAVE_OFFSET = 1152
-MCI_SEQ_OFFSET = 1216
-MMSYSERR_NOERROR = 0
-MMSYSERR_ERROR = MMSYSERR_BASE + 1
-MMSYSERR_BADDEVICEID = MMSYSERR_BASE + 2
-MMSYSERR_NOTENABLED = MMSYSERR_BASE + 3
-MMSYSERR_ALLOCATED = MMSYSERR_BASE + 4
-MMSYSERR_INVALHANDLE = MMSYSERR_BASE + 5
-MMSYSERR_NODRIVER = MMSYSERR_BASE + 6
-MMSYSERR_NOMEM = MMSYSERR_BASE + 7
-MMSYSERR_NOTSUPPORTED = MMSYSERR_BASE + 8
-MMSYSERR_BADERRNUM = MMSYSERR_BASE + 9
-MMSYSERR_INVALFLAG = MMSYSERR_BASE + 10
-MMSYSERR_INVALPARAM = MMSYSERR_BASE + 11
-MMSYSERR_HANDLEBUSY = MMSYSERR_BASE + 12
-MMSYSERR_INVALIDALIAS = MMSYSERR_BASE + 13
-MMSYSERR_BADDB = MMSYSERR_BASE + 14
-MMSYSERR_KEYNOTFOUND = MMSYSERR_BASE + 15
-MMSYSERR_READERROR = MMSYSERR_BASE + 16
-MMSYSERR_WRITEERROR = MMSYSERR_BASE + 17
-MMSYSERR_DELETEERROR = MMSYSERR_BASE + 18
-MMSYSERR_VALNOTFOUND = MMSYSERR_BASE + 19
-MMSYSERR_NODRIVERCB = MMSYSERR_BASE + 20
-MMSYSERR_LASTERROR = MMSYSERR_BASE + 20
-DRV_LOAD = 0x0001
-DRV_ENABLE = 0x0002
-DRV_OPEN = 0x0003
-DRV_CLOSE = 0x0004
-DRV_DISABLE = 0x0005
-DRV_FREE = 0x0006
-DRV_CONFIGURE = 0x0007
-DRV_QUERYCONFIGURE = 0x0008
-DRV_INSTALL = 0x0009
-DRV_REMOVE = 0x000A
-DRV_EXITSESSION = 0x000B
-DRV_POWER = 0x000F
-DRV_RESERVED = 0x0800
-DRV_USER = 0x4000
-DRVCNF_CANCEL = 0x0000
-DRVCNF_OK = 0x0001
-DRVCNF_RESTART = 0x0002
-DRV_CANCEL = DRVCNF_CANCEL
-DRV_OK = DRVCNF_OK
-DRV_RESTART = DRVCNF_RESTART
-DRV_MCI_FIRST = DRV_RESERVED
-DRV_MCI_LAST = DRV_RESERVED + 0xFFF
-CALLBACK_TYPEMASK = 0x00070000
-CALLBACK_NULL = 0x00000000
-CALLBACK_WINDOW = 0x00010000
-CALLBACK_TASK = 0x00020000
-CALLBACK_FUNCTION = 0x00030000
-CALLBACK_THREAD = CALLBACK_TASK
-CALLBACK_EVENT = 0x00050000
-SND_SYNC = 0x0000
-SND_ASYNC = 0x0001
-SND_NODEFAULT = 0x0002
-SND_MEMORY = 0x0004
-SND_LOOP = 0x0008
-SND_NOSTOP = 0x0010
-SND_NOWAIT = 0x00002000
-SND_ALIAS = 0x00010000
-SND_ALIAS_ID = 0x00110000
-SND_FILENAME = 0x00020000
-SND_RESOURCE = 0x00040004
-SND_PURGE = 0x0040
-SND_APPLICATION = 0x0080
-SND_ALIAS_START = 0
-WAVERR_BADFORMAT = WAVERR_BASE + 0
-WAVERR_STILLPLAYING = WAVERR_BASE + 1
-WAVERR_UNPREPARED = WAVERR_BASE + 2
-WAVERR_SYNC = WAVERR_BASE + 3
-WAVERR_LASTERROR = WAVERR_BASE + 3
-WOM_OPEN = MM_WOM_OPEN
-WOM_CLOSE = MM_WOM_CLOSE
-WOM_DONE = MM_WOM_DONE
-WIM_OPEN = MM_WIM_OPEN
-WIM_CLOSE = MM_WIM_CLOSE
-WIM_DATA = MM_WIM_DATA
-WAVE_MAPPER = -1  # 0xFFFFFFFF
-WAVE_FORMAT_QUERY = 0x0001
-WAVE_ALLOWSYNC = 0x0002
-WAVE_MAPPED = 0x0004
-WAVE_FORMAT_DIRECT = 0x0008
-WAVE_FORMAT_DIRECT_QUERY = WAVE_FORMAT_QUERY | WAVE_FORMAT_DIRECT
-WHDR_DONE = 0x00000001
-WHDR_PREPARED = 0x00000002
-WHDR_BEGINLOOP = 0x00000004
-WHDR_ENDLOOP = 0x00000008
-WHDR_INQUEUE = 0x00000010
-WAVECAPS_PITCH = 0x0001
-WAVECAPS_PLAYBACKRATE = 0x0002
-WAVECAPS_VOLUME = 0x0004
-WAVECAPS_LRVOLUME = 0x0008
-WAVECAPS_SYNC = 0x0010
-WAVECAPS_SAMPLEACCURATE = 0x0020
-WAVECAPS_DIRECTSOUND = 0x0040
-WAVE_INVALIDFORMAT = 0x00000000
-WAVE_FORMAT_1M08 = 0x00000001
-WAVE_FORMAT_1S08 = 0x00000002
-WAVE_FORMAT_1M16 = 0x00000004
-WAVE_FORMAT_1S16 = 0x00000008
-WAVE_FORMAT_2M08 = 0x00000010
-WAVE_FORMAT_2S08 = 0x00000020
-WAVE_FORMAT_2M16 = 0x00000040
-WAVE_FORMAT_2S16 = 0x00000080
-WAVE_FORMAT_4M08 = 0x00000100
-WAVE_FORMAT_4S08 = 0x00000200
-WAVE_FORMAT_4M16 = 0x00000400
-WAVE_FORMAT_4S16 = 0x00000800
-WAVE_FORMAT_PCM = 1
-WAVE_FORMAT_IEEE_FLOAT = 3
-MIDIERR_UNPREPARED = MIDIERR_BASE + 0
-MIDIERR_STILLPLAYING = MIDIERR_BASE + 1
-MIDIERR_NOMAP = MIDIERR_BASE + 2
-MIDIERR_NOTREADY = MIDIERR_BASE + 3
-MIDIERR_NODEVICE = MIDIERR_BASE + 4
-MIDIERR_INVALIDSETUP = MIDIERR_BASE + 5
-MIDIERR_BADOPENMODE = MIDIERR_BASE + 6
-MIDIERR_DONT_CONTINUE = MIDIERR_BASE + 7
-MIDIERR_LASTERROR = MIDIERR_BASE + 7
-MIDIPATCHSIZE = 128
-MIM_OPEN = MM_MIM_OPEN
-MIM_CLOSE = MM_MIM_CLOSE
-MIM_DATA = MM_MIM_DATA
-MIM_LONGDATA = MM_MIM_LONGDATA
-MIM_ERROR = MM_MIM_ERROR
-MIM_LONGERROR = MM_MIM_LONGERROR
-MOM_OPEN = MM_MOM_OPEN
-MOM_CLOSE = MM_MOM_CLOSE
-MOM_DONE = MM_MOM_DONE
-MIM_MOREDATA = MM_MIM_MOREDATA
-MOM_POSITIONCB = MM_MOM_POSITIONCB
-MIDI_IO_STATUS = 0x00000020
-MIDI_CACHE_ALL = 1
-MIDI_CACHE_BESTFIT = 2
-MIDI_CACHE_QUERY = 3
-MIDI_UNCACHE = 4
-MOD_MIDIPORT = 1
-MOD_SYNTH = 2
-MOD_SQSYNTH = 3
-MOD_FMSYNTH = 4
-MOD_MAPPER = 5
-MIDICAPS_VOLUME = 0x0001
-MIDICAPS_LRVOLUME = 0x0002
-MIDICAPS_CACHE = 0x0004
-MIDICAPS_STREAM = 0x0008
-MHDR_DONE = 0x00000001
-MHDR_PREPARED = 0x00000002
-MHDR_INQUEUE = 0x00000004
-MHDR_ISSTRM = 0x00000008
-MEVT_F_SHORT = 0x00000000
-MEVT_F_LONG = -2147483648  # 0x80000000
-MEVT_F_CALLBACK = 0x40000000
-
-
-def MEVT_EVENTTYPE(x):
-    return (BYTE)(((x) >> 24) & 0xFF)
-
-
-def MEVT_EVENTPARM(x):
-    return (DWORD)((x) & 0x00FFFFFF)
-
-
-MIDISTRM_ERROR = -2
-MIDIPROP_SET = -2147483648  # 0x80000000
-MIDIPROP_GET = 0x40000000
-MIDIPROP_TIMEDIV = 0x00000001
-MIDIPROP_TEMPO = 0x00000002
-AUXCAPS_CDAUDIO = 1
-AUXCAPS_AUXIN = 2
-AUXCAPS_VOLUME = 0x0001
-AUXCAPS_LRVOLUME = 0x0002
-MIXER_SHORT_NAME_CHARS = 16
-MIXER_LONG_NAME_CHARS = 64
-MIXERR_INVALLINE = MIXERR_BASE + 0
-MIXERR_INVALCONTROL = MIXERR_BASE + 1
-MIXERR_INVALVALUE = MIXERR_BASE + 2
-MIXERR_LASTERROR = MIXERR_BASE + 2
-MIXER_OBJECTF_HANDLE = -2147483648  # 0x80000000
-MIXER_OBJECTF_MIXER = 0x00000000
-MIXER_OBJECTF_HMIXER = MIXER_OBJECTF_HANDLE | MIXER_OBJECTF_MIXER
-MIXER_OBJECTF_WAVEOUT = 0x10000000
-MIXER_OBJECTF_HWAVEOUT = MIXER_OBJECTF_HANDLE | MIXER_OBJECTF_WAVEOUT
-MIXER_OBJECTF_WAVEIN = 0x20000000
-MIXER_OBJECTF_HWAVEIN = MIXER_OBJECTF_HANDLE | MIXER_OBJECTF_WAVEIN
-MIXER_OBJECTF_MIDIOUT = 0x30000000
-MIXER_OBJECTF_HMIDIOUT = MIXER_OBJECTF_HANDLE | MIXER_OBJECTF_MIDIOUT
-MIXER_OBJECTF_MIDIIN = 0x40000000
-MIXER_OBJECTF_HMIDIIN = MIXER_OBJECTF_HANDLE | MIXER_OBJECTF_MIDIIN
-MIXER_OBJECTF_AUX = 0x50000000
-MIXERLINE_LINEF_ACTIVE = 0x00000001
-MIXERLINE_LINEF_DISCONNECTED = 0x00008000
-MIXERLINE_LINEF_SOURCE = -2147483648  # 0x80000000
-MIXERLINE_COMPONENTTYPE_DST_FIRST = 0x00000000
-MIXERLINE_COMPONENTTYPE_DST_UNDEFINED = MIXERLINE_COMPONENTTYPE_DST_FIRST + 0
-MIXERLINE_COMPONENTTYPE_DST_DIGITAL = MIXERLINE_COMPONENTTYPE_DST_FIRST + 1
-MIXERLINE_COMPONENTTYPE_DST_LINE = MIXERLINE_COMPONENTTYPE_DST_FIRST + 2
-MIXERLINE_COMPONENTTYPE_DST_MONITOR = MIXERLINE_COMPONENTTYPE_DST_FIRST + 3
-MIXERLINE_COMPONENTTYPE_DST_SPEAKERS = MIXERLINE_COMPONENTTYPE_DST_FIRST + 4
-MIXERLINE_COMPONENTTYPE_DST_HEADPHONES = MIXERLINE_COMPONENTTYPE_DST_FIRST + 5
-MIXERLINE_COMPONENTTYPE_DST_TELEPHONE = MIXERLINE_COMPONENTTYPE_DST_FIRST + 6
-MIXERLINE_COMPONENTTYPE_DST_WAVEIN = MIXERLINE_COMPONENTTYPE_DST_FIRST + 7
-MIXERLINE_COMPONENTTYPE_DST_VOICEIN = MIXERLINE_COMPONENTTYPE_DST_FIRST + 8
-MIXERLINE_COMPONENTTYPE_DST_LAST = MIXERLINE_COMPONENTTYPE_DST_FIRST + 8
-MIXERLINE_COMPONENTTYPE_SRC_FIRST = 0x00001000
-MIXERLINE_COMPONENTTYPE_SRC_UNDEFINED = MIXERLINE_COMPONENTTYPE_SRC_FIRST + 0
-MIXERLINE_COMPONENTTYPE_SRC_DIGITAL = MIXERLINE_COMPONENTTYPE_SRC_FIRST + 1
-MIXERLINE_COMPONENTTYPE_SRC_LINE = MIXERLINE_COMPONENTTYPE_SRC_FIRST + 2
-MIXERLINE_COMPONENTTYPE_SRC_MICROPHONE = MIXERLINE_COMPONENTTYPE_SRC_FIRST + 3
-MIXERLINE_COMPONENTTYPE_SRC_SYNTHESIZER = MIXERLINE_COMPONENTTYPE_SRC_FIRST + 4
-MIXERLINE_COMPONENTTYPE_SRC_COMPACTDISC = MIXERLINE_COMPONENTTYPE_SRC_FIRST + 5
-MIXERLINE_COMPONENTTYPE_SRC_TELEPHONE = MIXERLINE_COMPONENTTYPE_SRC_FIRST + 6
-MIXERLINE_COMPONENTTYPE_SRC_PCSPEAKER = MIXERLINE_COMPONENTTYPE_SRC_FIRST + 7
-MIXERLINE_COMPONENTTYPE_SRC_WAVEOUT = MIXERLINE_COMPONENTTYPE_SRC_FIRST + 8
-MIXERLINE_COMPONENTTYPE_SRC_AUXILIARY = MIXERLINE_COMPONENTTYPE_SRC_FIRST + 9
-MIXERLINE_COMPONENTTYPE_SRC_ANALOG = MIXERLINE_COMPONENTTYPE_SRC_FIRST + 10
-MIXERLINE_COMPONENTTYPE_SRC_LAST = MIXERLINE_COMPONENTTYPE_SRC_FIRST + 10
-MIXERLINE_TARGETTYPE_UNDEFINED = 0
-MIXERLINE_TARGETTYPE_WAVEOUT = 1
-MIXERLINE_TARGETTYPE_WAVEIN = 2
-MIXERLINE_TARGETTYPE_MIDIOUT = 3
-MIXERLINE_TARGETTYPE_MIDIIN = 4
-MIXERLINE_TARGETTYPE_AUX = 5
-MIXER_GETLINEINFOF_DESTINATION = 0x00000000
-MIXER_GETLINEINFOF_SOURCE = 0x00000001
-MIXER_GETLINEINFOF_LINEID = 0x00000002
-MIXER_GETLINEINFOF_COMPONENTTYPE = 0x00000003
-MIXER_GETLINEINFOF_TARGETTYPE = 0x00000004
-MIXER_GETLINEINFOF_QUERYMASK = 0x0000000F
-MIXERCONTROL_CONTROLF_UNIFORM = 0x00000001
-MIXERCONTROL_CONTROLF_MULTIPLE = 0x00000002
-MIXERCONTROL_CONTROLF_DISABLED = -2147483648  # 0x80000000
-MIXERCONTROL_CT_CLASS_MASK = -268435456  # 0xF0000000
-MIXERCONTROL_CT_CLASS_CUSTOM = 0x00000000
-MIXERCONTROL_CT_CLASS_METER = 0x10000000
-MIXERCONTROL_CT_CLASS_SWITCH = 0x20000000
-MIXERCONTROL_CT_CLASS_NUMBER = 0x30000000
-MIXERCONTROL_CT_CLASS_SLIDER = 0x40000000
-MIXERCONTROL_CT_CLASS_FADER = 0x50000000
-MIXERCONTROL_CT_CLASS_TIME = 0x60000000
-MIXERCONTROL_CT_CLASS_LIST = 0x70000000
-MIXERCONTROL_CT_SUBCLASS_MASK = 0x0F000000
-MIXERCONTROL_CT_SC_SWITCH_BOOLEAN = 0x00000000
-MIXERCONTROL_CT_SC_SWITCH_BUTTON = 0x01000000
-MIXERCONTROL_CT_SC_METER_POLLED = 0x00000000
-MIXERCONTROL_CT_SC_TIME_MICROSECS = 0x00000000
-MIXERCONTROL_CT_SC_TIME_MILLISECS = 0x01000000
-MIXERCONTROL_CT_SC_LIST_SINGLE = 0x00000000
-MIXERCONTROL_CT_SC_LIST_MULTIPLE = 0x01000000
-MIXERCONTROL_CT_UNITS_MASK = 0x00FF0000
-MIXERCONTROL_CT_UNITS_CUSTOM = 0x00000000
-MIXERCONTROL_CT_UNITS_BOOLEAN = 0x00010000
-MIXERCONTROL_CT_UNITS_SIGNED = 0x00020000
-MIXERCONTROL_CT_UNITS_UNSIGNED = 0x00030000
-MIXERCONTROL_CT_UNITS_DECIBELS = 0x00040000
-MIXERCONTROL_CT_UNITS_PERCENT = 0x00050000
-MIXERCONTROL_CONTROLTYPE_CUSTOM = (
-    MIXERCONTROL_CT_CLASS_CUSTOM | MIXERCONTROL_CT_UNITS_CUSTOM
-)
-MIXERCONTROL_CONTROLTYPE_BOOLEANMETER = (
-    MIXERCONTROL_CT_CLASS_METER
-    | MIXERCONTROL_CT_SC_METER_POLLED
-    | MIXERCONTROL_CT_UNITS_BOOLEAN
-)
-MIXERCONTROL_CONTROLTYPE_SIGNEDMETER = (
-    MIXERCONTROL_CT_CLASS_METER
-    | MIXERCONTROL_CT_SC_METER_POLLED
-    | MIXERCONTROL_CT_UNITS_SIGNED
-)
-MIXERCONTROL_CONTROLTYPE_PEAKMETER = MIXERCONTROL_CONTROLTYPE_SIGNEDMETER + 1
-MIXERCONTROL_CONTROLTYPE_UNSIGNEDMETER = (
-    MIXERCONTROL_CT_CLASS_METER
-    | MIXERCONTROL_CT_SC_METER_POLLED
-    | MIXERCONTROL_CT_UNITS_UNSIGNED
-)
-MIXERCONTROL_CONTROLTYPE_BOOLEAN = (
-    MIXERCONTROL_CT_CLASS_SWITCH
-    | MIXERCONTROL_CT_SC_SWITCH_BOOLEAN
-    | MIXERCONTROL_CT_UNITS_BOOLEAN
-)
-MIXERCONTROL_CONTROLTYPE_ONOFF = MIXERCONTROL_CONTROLTYPE_BOOLEAN + 1
-MIXERCONTROL_CONTROLTYPE_MUTE = MIXERCONTROL_CONTROLTYPE_BOOLEAN + 2
-MIXERCONTROL_CONTROLTYPE_MONO = MIXERCONTROL_CONTROLTYPE_BOOLEAN + 3
-MIXERCONTROL_CONTROLTYPE_LOUDNESS = MIXERCONTROL_CONTROLTYPE_BOOLEAN + 4
-MIXERCONTROL_CONTROLTYPE_STEREOENH = MIXERCONTROL_CONTROLTYPE_BOOLEAN + 5
-MIXERCONTROL_CONTROLTYPE_BUTTON = (
-    MIXERCONTROL_CT_CLASS_SWITCH
-    | MIXERCONTROL_CT_SC_SWITCH_BUTTON
-    | MIXERCONTROL_CT_UNITS_BOOLEAN
-)
-MIXERCONTROL_CONTROLTYPE_DECIBELS = (
-    MIXERCONTROL_CT_CLASS_NUMBER | MIXERCONTROL_CT_UNITS_DECIBELS
-)
-MIXERCONTROL_CONTROLTYPE_SIGNED = (
-    MIXERCONTROL_CT_CLASS_NUMBER | MIXERCONTROL_CT_UNITS_SIGNED
-)
-MIXERCONTROL_CONTROLTYPE_UNSIGNED = (
-    MIXERCONTROL_CT_CLASS_NUMBER | MIXERCONTROL_CT_UNITS_UNSIGNED
-)
-MIXERCONTROL_CONTROLTYPE_PERCENT = (
-    MIXERCONTROL_CT_CLASS_NUMBER | MIXERCONTROL_CT_UNITS_PERCENT
-)
-MIXERCONTROL_CONTROLTYPE_SLIDER = (
-    MIXERCONTROL_CT_CLASS_SLIDER | MIXERCONTROL_CT_UNITS_SIGNED
-)
-MIXERCONTROL_CONTROLTYPE_PAN = MIXERCONTROL_CONTROLTYPE_SLIDER + 1
-MIXERCONTROL_CONTROLTYPE_QSOUNDPAN = MIXERCONTROL_CONTROLTYPE_SLIDER + 2
-MIXERCONTROL_CONTROLTYPE_FADER = (
-    MIXERCONTROL_CT_CLASS_FADER | MIXERCONTROL_CT_UNITS_UNSIGNED
-)
-MIXERCONTROL_CONTROLTYPE_VOLUME = MIXERCONTROL_CONTROLTYPE_FADER + 1
-MIXERCONTROL_CONTROLTYPE_BASS = MIXERCONTROL_CONTROLTYPE_FADER + 2
-MIXERCONTROL_CONTROLTYPE_TREBLE = MIXERCONTROL_CONTROLTYPE_FADER + 3
-MIXERCONTROL_CONTROLTYPE_EQUALIZER = MIXERCONTROL_CONTROLTYPE_FADER + 4
-MIXERCONTROL_CONTROLTYPE_SINGLESELECT = (
-    MIXERCONTROL_CT_CLASS_LIST
-    | MIXERCONTROL_CT_SC_LIST_SINGLE
-    | MIXERCONTROL_CT_UNITS_BOOLEAN
-)
-MIXERCONTROL_CONTROLTYPE_MUX = MIXERCONTROL_CONTROLTYPE_SINGLESELECT + 1
-MIXERCONTROL_CONTROLTYPE_MULTIPLESELECT = (
-    MIXERCONTROL_CT_CLASS_LIST
-    | MIXERCONTROL_CT_SC_LIST_MULTIPLE
-    | MIXERCONTROL_CT_UNITS_BOOLEAN
-)
-MIXERCONTROL_CONTROLTYPE_MIXER = MIXERCONTROL_CONTROLTYPE_MULTIPLESELECT + 1
-MIXERCONTROL_CONTROLTYPE_MICROTIME = (
-    MIXERCONTROL_CT_CLASS_TIME
-    | MIXERCONTROL_CT_SC_TIME_MICROSECS
-    | MIXERCONTROL_CT_UNITS_UNSIGNED
-)
-MIXERCONTROL_CONTROLTYPE_MILLITIME = (
-    MIXERCONTROL_CT_CLASS_TIME
-    | MIXERCONTROL_CT_SC_TIME_MILLISECS
-    | MIXERCONTROL_CT_UNITS_UNSIGNED
-)
-MIXER_GETLINECONTROLSF_ALL = 0x00000000
-MIXER_GETLINECONTROLSF_ONEBYID = 0x00000001
-MIXER_GETLINECONTROLSF_ONEBYTYPE = 0x00000002
-MIXER_GETLINECONTROLSF_QUERYMASK = 0x0000000F
-MIXER_GETCONTROLDETAILSF_VALUE = 0x00000000
-MIXER_GETCONTROLDETAILSF_LISTTEXT = 0x00000001
-MIXER_GETCONTROLDETAILSF_QUERYMASK = 0x0000000F
-MIXER_SETCONTROLDETAILSF_VALUE = 0x00000000
-MIXER_SETCONTROLDETAILSF_CUSTOM = 0x00000001
-MIXER_SETCONTROLDETAILSF_QUERYMASK = 0x0000000F
-TIMERR_NOERROR = 0
-TIMERR_NOCANDO = TIMERR_BASE + 1
-TIMERR_STRUCT = TIMERR_BASE + 33
-TIME_ONESHOT = 0x0000
-TIME_PERIODIC = 0x0001
-TIME_CALLBACK_FUNCTION = 0x0000
-TIME_CALLBACK_EVENT_SET = 0x0010
-TIME_CALLBACK_EVENT_PULSE = 0x0020
-JOYERR_NOERROR = 0
-JOYERR_PARMS = JOYERR_BASE + 5
-JOYERR_NOCANDO = JOYERR_BASE + 6
-JOYERR_UNPLUGGED = JOYERR_BASE + 7
-JOY_BUTTON1 = 0x0001
-JOY_BUTTON2 = 0x0002
-JOY_BUTTON3 = 0x0004
-JOY_BUTTON4 = 0x0008
-JOY_BUTTON1CHG = 0x0100
-JOY_BUTTON2CHG = 0x0200
-JOY_BUTTON3CHG = 0x0400
-JOY_BUTTON4CHG = 0x0800
-JOY_BUTTON5 = 0x00000010
-JOY_BUTTON6 = 0x00000020
-JOY_BUTTON7 = 0x00000040
-JOY_BUTTON8 = 0x00000080
-JOY_BUTTON9 = 0x00000100
-JOY_BUTTON10 = 0x00000200
-JOY_BUTTON11 = 0x00000400
-JOY_BUTTON12 = 0x00000800
-JOY_BUTTON13 = 0x00001000
-JOY_BUTTON14 = 0x00002000
-JOY_BUTTON15 = 0x00004000
-JOY_BUTTON16 = 0x00008000
-JOY_BUTTON17 = 0x00010000
-JOY_BUTTON18 = 0x00020000
-JOY_BUTTON19 = 0x00040000
-JOY_BUTTON20 = 0x00080000
-JOY_BUTTON21 = 0x00100000
-JOY_BUTTON22 = 0x00200000
-JOY_BUTTON23 = 0x00400000
-JOY_BUTTON24 = 0x00800000
-JOY_BUTTON25 = 0x01000000
-JOY_BUTTON26 = 0x02000000
-JOY_BUTTON27 = 0x04000000
-JOY_BUTTON28 = 0x08000000
-JOY_BUTTON29 = 0x10000000
-JOY_BUTTON30 = 0x20000000
-JOY_BUTTON31 = 0x40000000
-JOY_BUTTON32 = -2147483648  # 0x80000000
-JOY_POVFORWARD = 0
-JOY_POVRIGHT = 9000
-JOY_POVBACKWARD = 18000
-JOY_POVLEFT = 27000
-JOY_RETURNX = 0x00000001
-JOY_RETURNY = 0x00000002
-JOY_RETURNZ = 0x00000004
-JOY_RETURNR = 0x00000008
-JOY_RETURNU = 0x00000010
-JOY_RETURNV = 0x00000020
-JOY_RETURNPOV = 0x00000040
-JOY_RETURNBUTTONS = 0x00000080
-JOY_RETURNRAWDATA = 0x00000100
-JOY_RETURNPOVCTS = 0x00000200
-JOY_RETURNCENTERED = 0x00000400
-JOY_USEDEADZONE = 0x00000800
-JOY_RETURNALL = (
-    JOY_RETURNX
-    | JOY_RETURNY
-    | JOY_RETURNZ
-    | JOY_RETURNR
-    | JOY_RETURNU
-    | JOY_RETURNV
-    | JOY_RETURNPOV
-    | JOY_RETURNBUTTONS
-)
-JOY_CAL_READALWAYS = 0x00010000
-JOY_CAL_READXYONLY = 0x00020000
-JOY_CAL_READ3 = 0x00040000
-JOY_CAL_READ4 = 0x00080000
-JOY_CAL_READXONLY = 0x00100000
-JOY_CAL_READYONLY = 0x00200000
-JOY_CAL_READ5 = 0x00400000
-JOY_CAL_READ6 = 0x00800000
-JOY_CAL_READZONLY = 0x01000000
-JOY_CAL_READRONLY = 0x02000000
-JOY_CAL_READUONLY = 0x04000000
-JOY_CAL_READVONLY = 0x08000000
-JOYSTICKID1 = 0
-JOYSTICKID2 = 1
-JOYCAPS_HASZ = 0x0001
-JOYCAPS_HASR = 0x0002
-JOYCAPS_HASU = 0x0004
-JOYCAPS_HASV = 0x0008
-JOYCAPS_HASPOV = 0x0010
-JOYCAPS_POV4DIR = 0x0020
-JOYCAPS_POVCTS = 0x0040
-MMIOERR_BASE = 256
-MMIOERR_FILENOTFOUND = MMIOERR_BASE + 1
-MMIOERR_OUTOFMEMORY = MMIOERR_BASE + 2
-MMIOERR_CANNOTOPEN = MMIOERR_BASE + 3
-MMIOERR_CANNOTCLOSE = MMIOERR_BASE + 4
-MMIOERR_CANNOTREAD = MMIOERR_BASE + 5
-MMIOERR_CANNOTWRITE = MMIOERR_BASE + 6
-MMIOERR_CANNOTSEEK = MMIOERR_BASE + 7
-MMIOERR_CANNOTEXPAND = MMIOERR_BASE + 8
-MMIOERR_CHUNKNOTFOUND = MMIOERR_BASE + 9
-MMIOERR_UNBUFFERED = MMIOERR_BASE + 10
-MMIOERR_PATHNOTFOUND = MMIOERR_BASE + 11
-MMIOERR_ACCESSDENIED = MMIOERR_BASE + 12
-MMIOERR_SHARINGVIOLATION = MMIOERR_BASE + 13
-MMIOERR_NETWORKERROR = MMIOERR_BASE + 14
-MMIOERR_TOOMANYOPENFILES = MMIOERR_BASE + 15
-MMIOERR_INVALIDFILE = MMIOERR_BASE + 16
-CFSEPCHAR = ord("+")
-MMIO_RWMODE = 0x00000003
-MMIO_SHAREMODE = 0x00000070
-MMIO_CREATE = 0x00001000
-MMIO_PARSE = 0x00000100
-MMIO_DELETE = 0x00000200
-MMIO_EXIST = 0x00004000
-MMIO_ALLOCBUF = 0x00010000
-MMIO_GETTEMP = 0x00020000
-MMIO_DIRTY = 0x10000000
-MMIO_READ = 0x00000000
-MMIO_WRITE = 0x00000001
-MMIO_READWRITE = 0x00000002
-MMIO_COMPAT = 0x00000000
-MMIO_EXCLUSIVE = 0x00000010
-MMIO_DENYWRITE = 0x00000020
-MMIO_DENYREAD = 0x00000030
-MMIO_DENYNONE = 0x00000040
-MMIO_FHOPEN = 0x0010
-MMIO_EMPTYBUF = 0x0010
-MMIO_TOUPPER = 0x0010
-MMIO_INSTALLPROC = 0x00010000
-MMIO_GLOBALPROC = 0x10000000
-MMIO_REMOVEPROC = 0x00020000
-MMIO_UNICODEPROC = 0x01000000
-MMIO_FINDPROC = 0x00040000
-MMIO_FINDCHUNK = 0x0010
-MMIO_FINDRIFF = 0x0020
-MMIO_FINDLIST = 0x0040
-MMIO_CREATERIFF = 0x0020
-MMIO_CREATELIST = 0x0040
-MMIOM_READ = MMIO_READ
-MMIOM_WRITE = MMIO_WRITE
-MMIOM_SEEK = 2
-MMIOM_OPEN = 3
-MMIOM_CLOSE = 4
-MMIOM_WRITEFLUSH = 5
-MMIOM_RENAME = 6
-MMIOM_USER = 0x8000
-SEEK_SET = 0
-SEEK_CUR = 1
-SEEK_END = 2
-MMIO_DEFAULTBUFFER = 8192
-MCIERR_INVALID_DEVICE_ID = MCIERR_BASE + 1
-MCIERR_UNRECOGNIZED_KEYWORD = MCIERR_BASE + 3
-MCIERR_UNRECOGNIZED_COMMAND = MCIERR_BASE + 5
-MCIERR_HARDWARE = MCIERR_BASE + 6
-MCIERR_INVALID_DEVICE_NAME = MCIERR_BASE + 7
-MCIERR_OUT_OF_MEMORY = MCIERR_BASE + 8
-MCIERR_DEVICE_OPEN = MCIERR_BASE + 9
-MCIERR_CANNOT_LOAD_DRIVER = MCIERR_BASE + 10
-MCIERR_MISSING_COMMAND_STRING = MCIERR_BASE + 11
-MCIERR_PARAM_OVERFLOW = MCIERR_BASE + 12
-MCIERR_MISSING_STRING_ARGUMENT = MCIERR_BASE + 13
-MCIERR_BAD_INTEGER = MCIERR_BASE + 14
-MCIERR_PARSER_INTERNAL = MCIERR_BASE + 15
-MCIERR_DRIVER_INTERNAL = MCIERR_BASE + 16
-MCIERR_MISSING_PARAMETER = MCIERR_BASE + 17
-MCIERR_UNSUPPORTED_FUNCTION = MCIERR_BASE + 18
-MCIERR_FILE_NOT_FOUND = MCIERR_BASE + 19
-MCIERR_DEVICE_NOT_READY = MCIERR_BASE + 20
-MCIERR_INTERNAL = MCIERR_BASE + 21
-MCIERR_DRIVER = MCIERR_BASE + 22
-MCIERR_CANNOT_USE_ALL = MCIERR_BASE + 23
-MCIERR_MULTIPLE = MCIERR_BASE + 24
-MCIERR_EXTENSION_NOT_FOUND = MCIERR_BASE + 25
-MCIERR_OUTOFRANGE = MCIERR_BASE + 26
-MCIERR_FLAGS_NOT_COMPATIBLE = MCIERR_BASE + 28
-MCIERR_FILE_NOT_SAVED = MCIERR_BASE + 30
-MCIERR_DEVICE_TYPE_REQUIRED = MCIERR_BASE + 31
-MCIERR_DEVICE_LOCKED = MCIERR_BASE + 32
-MCIERR_DUPLICATE_ALIAS = MCIERR_BASE + 33
-MCIERR_BAD_CONSTANT = MCIERR_BASE + 34
-MCIERR_MUST_USE_SHAREABLE = MCIERR_BASE + 35
-MCIERR_MISSING_DEVICE_NAME = MCIERR_BASE + 36
-MCIERR_BAD_TIME_FORMAT = MCIERR_BASE + 37
-MCIERR_NO_CLOSING_QUOTE = MCIERR_BASE + 38
-MCIERR_DUPLICATE_FLAGS = MCIERR_BASE + 39
-MCIERR_INVALID_FILE = MCIERR_BASE + 40
-MCIERR_NULL_PARAMETER_BLOCK = MCIERR_BASE + 41
-MCIERR_UNNAMED_RESOURCE = MCIERR_BASE + 42
-MCIERR_NEW_REQUIRES_ALIAS = MCIERR_BASE + 43
-MCIERR_NOTIFY_ON_AUTO_OPEN = MCIERR_BASE + 44
-MCIERR_NO_ELEMENT_ALLOWED = MCIERR_BASE + 45
-MCIERR_NONAPPLICABLE_FUNCTION = MCIERR_BASE + 46
-MCIERR_ILLEGAL_FOR_AUTO_OPEN = MCIERR_BASE + 47
-MCIERR_FILENAME_REQUIRED = MCIERR_BASE + 48
-MCIERR_EXTRA_CHARACTERS = MCIERR_BASE + 49
-MCIERR_DEVICE_NOT_INSTALLED = MCIERR_BASE + 50
-MCIERR_GET_CD = MCIERR_BASE + 51
-MCIERR_SET_CD = MCIERR_BASE + 52
-MCIERR_SET_DRIVE = MCIERR_BASE + 53
-MCIERR_DEVICE_LENGTH = MCIERR_BASE + 54
-MCIERR_DEVICE_ORD_LENGTH = MCIERR_BASE + 55
-MCIERR_NO_INTEGER = MCIERR_BASE + 56
-MCIERR_WAVE_OUTPUTSINUSE = MCIERR_BASE + 64
-MCIERR_WAVE_SETOUTPUTINUSE = MCIERR_BASE + 65
-MCIERR_WAVE_INPUTSINUSE = MCIERR_BASE + 66
-MCIERR_WAVE_SETINPUTINUSE = MCIERR_BASE + 67
-MCIERR_WAVE_OUTPUTUNSPECIFIED = MCIERR_BASE + 68
-MCIERR_WAVE_INPUTUNSPECIFIED = MCIERR_BASE + 69
-MCIERR_WAVE_OUTPUTSUNSUITABLE = MCIERR_BASE + 70
-MCIERR_WAVE_SETOUTPUTUNSUITABLE = MCIERR_BASE + 71
-MCIERR_WAVE_INPUTSUNSUITABLE = MCIERR_BASE + 72
-MCIERR_WAVE_SETINPUTUNSUITABLE = MCIERR_BASE + 73
-MCIERR_SEQ_DIV_INCOMPATIBLE = MCIERR_BASE + 80
-MCIERR_SEQ_PORT_INUSE = MCIERR_BASE + 81
-MCIERR_SEQ_PORT_NONEXISTENT = MCIERR_BASE + 82
-MCIERR_SEQ_PORT_MAPNODEVICE = MCIERR_BASE + 83
-MCIERR_SEQ_PORT_MISCERROR = MCIERR_BASE + 84
-MCIERR_SEQ_TIMER = MCIERR_BASE + 85
-MCIERR_SEQ_PORTUNSPECIFIED = MCIERR_BASE + 86
-MCIERR_SEQ_NOMIDIPRESENT = MCIERR_BASE + 87
-MCIERR_NO_WINDOW = MCIERR_BASE + 90
-MCIERR_CREATEWINDOW = MCIERR_BASE + 91
-MCIERR_FILE_READ = MCIERR_BASE + 92
-MCIERR_FILE_WRITE = MCIERR_BASE + 93
-MCIERR_NO_IDENTITY = MCIERR_BASE + 94
-MCIERR_CUSTOM_DRIVER_BASE = MCIERR_BASE + 256
-MCI_FIRST = DRV_MCI_FIRST
-MCI_OPEN = 0x0803
-MCI_CLOSE = 0x0804
-MCI_ESCAPE = 0x0805
-MCI_PLAY = 0x0806
-MCI_SEEK = 0x0807
-MCI_STOP = 0x0808
-MCI_PAUSE = 0x0809
-MCI_INFO = 0x080A
-MCI_GETDEVCAPS = 0x080B
-MCI_SPIN = 0x080C
-MCI_SET = 0x080D
-MCI_STEP = 0x080E
-MCI_RECORD = 0x080F
-MCI_SYSINFO = 0x0810
-MCI_BREAK = 0x0811
-MCI_SAVE = 0x0813
-MCI_STATUS = 0x0814
-MCI_CUE = 0x0830
-MCI_REALIZE = 0x0840
-MCI_WINDOW = 0x0841
-MCI_PUT = 0x0842
-MCI_WHERE = 0x0843
-MCI_FREEZE = 0x0844
-MCI_UNFREEZE = 0x0845
-MCI_LOAD = 0x0850
-MCI_CUT = 0x0851
-MCI_COPY = 0x0852
-MCI_PASTE = 0x0853
-MCI_UPDATE = 0x0854
-MCI_RESUME = 0x0855
-MCI_DELETE = 0x0856
-MCI_USER_MESSAGES = DRV_MCI_FIRST + 0x400
-MCI_LAST = 0x0FFF
-MCI_DEVTYPE_VCR = 513
-MCI_DEVTYPE_VIDEODISC = 514
-MCI_DEVTYPE_OVERLAY = 515
-MCI_DEVTYPE_CD_AUDIO = 516
-MCI_DEVTYPE_DAT = 517
-MCI_DEVTYPE_SCANNER = 518
-MCI_DEVTYPE_ANIMATION = 519
-MCI_DEVTYPE_DIGITAL_VIDEO = 520
-MCI_DEVTYPE_OTHER = 521
-MCI_DEVTYPE_WAVEFORM_AUDIO = 522
-MCI_DEVTYPE_SEQUENCER = 523
-MCI_DEVTYPE_FIRST = MCI_DEVTYPE_VCR
-MCI_DEVTYPE_LAST = MCI_DEVTYPE_SEQUENCER
-MCI_DEVTYPE_FIRST_USER = 0x1000
-MCI_MODE_NOT_READY = MCI_STRING_OFFSET + 12
-MCI_MODE_STOP = MCI_STRING_OFFSET + 13
-MCI_MODE_PLAY = MCI_STRING_OFFSET + 14
-MCI_MODE_RECORD = MCI_STRING_OFFSET + 15
-MCI_MODE_SEEK = MCI_STRING_OFFSET + 16
-MCI_MODE_PAUSE = MCI_STRING_OFFSET + 17
-MCI_MODE_OPEN = MCI_STRING_OFFSET + 18
-MCI_FORMAT_MILLISECONDS = 0
-MCI_FORMAT_HMS = 1
-MCI_FORMAT_MSF = 2
-MCI_FORMAT_FRAMES = 3
-MCI_FORMAT_SMPTE_24 = 4
-MCI_FORMAT_SMPTE_25 = 5
-MCI_FORMAT_SMPTE_30 = 6
-MCI_FORMAT_SMPTE_30DROP = 7
-MCI_FORMAT_BYTES = 8
-MCI_FORMAT_SAMPLES = 9
-MCI_FORMAT_TMSF = 10
-
-
-def MCI_MSF_MINUTE(msf):
-    return (BYTE)(msf)
-
-
-def MCI_MSF_SECOND(msf):
-    return (BYTE)(((WORD)(msf)) >> 8)
-
-
-def MCI_MSF_FRAME(msf):
-    return (BYTE)((msf) >> 16)
-
-
-def MCI_TMSF_TRACK(tmsf):
-    return (BYTE)(tmsf)
-
-
-def MCI_TMSF_MINUTE(tmsf):
-    return (BYTE)(((WORD)(tmsf)) >> 8)
-
-
-def MCI_TMSF_SECOND(tmsf):
-    return (BYTE)((tmsf) >> 16)
-
-
-def MCI_TMSF_FRAME(tmsf):
-    return (BYTE)((tmsf) >> 24)
-
-
-def MCI_HMS_HOUR(hms):
-    return (BYTE)(hms)
-
-
-def MCI_HMS_MINUTE(hms):
-    return (BYTE)(((WORD)(hms)) >> 8)
-
-
-def MCI_HMS_SECOND(hms):
-    return (BYTE)((hms) >> 16)
-
-
-MCI_NOTIFY_SUCCESSFUL = 0x0001
-MCI_NOTIFY_SUPERSEDED = 0x0002
-MCI_NOTIFY_ABORTED = 0x0004
-MCI_NOTIFY_FAILURE = 0x0008
-MCI_NOTIFY = 0x00000001
-MCI_WAIT = 0x00000002
-MCI_FROM = 0x00000004
-MCI_TO = 0x00000008
-MCI_TRACK = 0x00000010
-MCI_OPEN_SHAREABLE = 0x00000100
-MCI_OPEN_ELEMENT = 0x00000200
-MCI_OPEN_ALIAS = 0x00000400
-MCI_OPEN_ELEMENT_ID = 0x00000800
-MCI_OPEN_TYPE_ID = 0x00001000
-MCI_OPEN_TYPE = 0x00002000
-MCI_SEEK_TO_START = 0x00000100
-MCI_SEEK_TO_END = 0x00000200
-MCI_STATUS_ITEM = 0x00000100
-MCI_STATUS_START = 0x00000200
-MCI_STATUS_LENGTH = 0x00000001
-MCI_STATUS_POSITION = 0x00000002
-MCI_STATUS_NUMBER_OF_TRACKS = 0x00000003
-MCI_STATUS_MODE = 0x00000004
-MCI_STATUS_MEDIA_PRESENT = 0x00000005
-MCI_STATUS_TIME_FORMAT = 0x00000006
-MCI_STATUS_READY = 0x00000007
-MCI_STATUS_CURRENT_TRACK = 0x00000008
-MCI_INFO_PRODUCT = 0x00000100
-MCI_INFO_FILE = 0x00000200
-MCI_INFO_MEDIA_UPC = 0x00000400
-MCI_INFO_MEDIA_IDENTITY = 0x00000800
-MCI_INFO_NAME = 0x00001000
-MCI_INFO_COPYRIGHT = 0x00002000
-MCI_GETDEVCAPS_ITEM = 0x00000100
-MCI_GETDEVCAPS_CAN_RECORD = 0x00000001
-MCI_GETDEVCAPS_HAS_AUDIO = 0x00000002
-MCI_GETDEVCAPS_HAS_VIDEO = 0x00000003
-MCI_GETDEVCAPS_DEVICE_TYPE = 0x00000004
-MCI_GETDEVCAPS_USES_FILES = 0x00000005
-MCI_GETDEVCAPS_COMPOUND_DEVICE = 0x00000006
-MCI_GETDEVCAPS_CAN_EJECT = 0x00000007
-MCI_GETDEVCAPS_CAN_PLAY = 0x00000008
-MCI_GETDEVCAPS_CAN_SAVE = 0x00000009
-MCI_SYSINFO_QUANTITY = 0x00000100
-MCI_SYSINFO_OPEN = 0x00000200
-MCI_SYSINFO_NAME = 0x00000400
-MCI_SYSINFO_INSTALLNAME = 0x00000800
-MCI_SET_DOOR_OPEN = 0x00000100
-MCI_SET_DOOR_CLOSED = 0x00000200
-MCI_SET_TIME_FORMAT = 0x00000400
-MCI_SET_AUDIO = 0x00000800
-MCI_SET_VIDEO = 0x00001000
-MCI_SET_ON = 0x00002000
-MCI_SET_OFF = 0x00004000
-MCI_SET_AUDIO_ALL = 0x00000000
-MCI_SET_AUDIO_LEFT = 0x00000001
-MCI_SET_AUDIO_RIGHT = 0x00000002
-MCI_BREAK_KEY = 0x00000100
-MCI_BREAK_HWND = 0x00000200
-MCI_BREAK_OFF = 0x00000400
-MCI_RECORD_INSERT = 0x00000100
-MCI_RECORD_OVERWRITE = 0x00000200
-MCI_SAVE_FILE = 0x00000100
-MCI_LOAD_FILE = 0x00000100
-MCI_VD_MODE_PARK = MCI_VD_OFFSET + 1
-MCI_VD_MEDIA_CLV = MCI_VD_OFFSET + 2
-MCI_VD_MEDIA_CAV = MCI_VD_OFFSET + 3
-MCI_VD_MEDIA_OTHER = MCI_VD_OFFSET + 4
-MCI_VD_FORMAT_TRACK = 0x4001
-MCI_VD_PLAY_REVERSE = 0x00010000
-MCI_VD_PLAY_FAST = 0x00020000
-MCI_VD_PLAY_SPEED = 0x00040000
-MCI_VD_PLAY_SCAN = 0x00080000
-MCI_VD_PLAY_SLOW = 0x00100000
-MCI_VD_SEEK_REVERSE = 0x00010000
-MCI_VD_STATUS_SPEED = 0x00004002
-MCI_VD_STATUS_FORWARD = 0x00004003
-MCI_VD_STATUS_MEDIA_TYPE = 0x00004004
-MCI_VD_STATUS_SIDE = 0x00004005
-MCI_VD_STATUS_DISC_SIZE = 0x00004006
-MCI_VD_GETDEVCAPS_CLV = 0x00010000
-MCI_VD_GETDEVCAPS_CAV = 0x00020000
-MCI_VD_SPIN_UP = 0x00010000
-MCI_VD_SPIN_DOWN = 0x00020000
-MCI_VD_GETDEVCAPS_CAN_REVERSE = 0x00004002
-MCI_VD_GETDEVCAPS_FAST_RATE = 0x00004003
-MCI_VD_GETDEVCAPS_SLOW_RATE = 0x00004004
-MCI_VD_GETDEVCAPS_NORMAL_RATE = 0x00004005
-MCI_VD_STEP_FRAMES = 0x00010000
-MCI_VD_STEP_REVERSE = 0x00020000
-MCI_VD_ESCAPE_STRING = 0x00000100
-MCI_CDA_STATUS_TYPE_TRACK = 0x00004001
-MCI_CDA_TRACK_AUDIO = MCI_CD_OFFSET + 0
-MCI_CDA_TRACK_OTHER = MCI_CD_OFFSET + 1
-MCI_WAVE_PCM = MCI_WAVE_OFFSET + 0
-MCI_WAVE_MAPPER = MCI_WAVE_OFFSET + 1
-MCI_WAVE_OPEN_BUFFER = 0x00010000
-MCI_WAVE_SET_FORMATTAG = 0x00010000
-MCI_WAVE_SET_CHANNELS = 0x00020000
-MCI_WAVE_SET_SAMPLESPERSEC = 0x00040000
-MCI_WAVE_SET_AVGBYTESPERSEC = 0x00080000
-MCI_WAVE_SET_BLOCKALIGN = 0x00100000
-MCI_WAVE_SET_BITSPERSAMPLE = 0x00200000
-MCI_WAVE_INPUT = 0x00400000
-MCI_WAVE_OUTPUT = 0x00800000
-MCI_WAVE_STATUS_FORMATTAG = 0x00004001
-MCI_WAVE_STATUS_CHANNELS = 0x00004002
-MCI_WAVE_STATUS_SAMPLESPERSEC = 0x00004003
-MCI_WAVE_STATUS_AVGBYTESPERSEC = 0x00004004
-MCI_WAVE_STATUS_BLOCKALIGN = 0x00004005
-MCI_WAVE_STATUS_BITSPERSAMPLE = 0x00004006
-MCI_WAVE_STATUS_LEVEL = 0x00004007
-MCI_WAVE_SET_ANYINPUT = 0x04000000
-MCI_WAVE_SET_ANYOUTPUT = 0x08000000
-MCI_WAVE_GETDEVCAPS_INPUTS = 0x00004001
-MCI_WAVE_GETDEVCAPS_OUTPUTS = 0x00004002
-MCI_SEQ_DIV_PPQN = 0 + MCI_SEQ_OFFSET
-MCI_SEQ_DIV_SMPTE_24 = 1 + MCI_SEQ_OFFSET
-MCI_SEQ_DIV_SMPTE_25 = 2 + MCI_SEQ_OFFSET
-MCI_SEQ_DIV_SMPTE_30DROP = 3 + MCI_SEQ_OFFSET
-MCI_SEQ_DIV_SMPTE_30 = 4 + MCI_SEQ_OFFSET
-MCI_SEQ_FORMAT_SONGPTR = 0x4001
-MCI_SEQ_FILE = 0x4002
-MCI_SEQ_MIDI = 0x4003
-MCI_SEQ_SMPTE = 0x4004
-MCI_SEQ_NONE = 65533
-MCI_SEQ_MAPPER = 65535
-MCI_SEQ_STATUS_TEMPO = 0x00004002
-MCI_SEQ_STATUS_PORT = 0x00004003
-MCI_SEQ_STATUS_SLAVE = 0x00004007
-MCI_SEQ_STATUS_MASTER = 0x00004008
-MCI_SEQ_STATUS_OFFSET = 0x00004009
-MCI_SEQ_STATUS_DIVTYPE = 0x0000400A
-MCI_SEQ_STATUS_NAME = 0x0000400B
-MCI_SEQ_STATUS_COPYRIGHT = 0x0000400C
-MCI_SEQ_SET_TEMPO = 0x00010000
-MCI_SEQ_SET_PORT = 0x00020000
-MCI_SEQ_SET_SLAVE = 0x00040000
-MCI_SEQ_SET_MASTER = 0x00080000
-MCI_SEQ_SET_OFFSET = 0x01000000
-MCI_ANIM_OPEN_WS = 0x00010000
-MCI_ANIM_OPEN_PARENT = 0x00020000
-MCI_ANIM_OPEN_NOSTATIC = 0x00040000
-MCI_ANIM_PLAY_SPEED = 0x00010000
-MCI_ANIM_PLAY_REVERSE = 0x00020000
-MCI_ANIM_PLAY_FAST = 0x00040000
-MCI_ANIM_PLAY_SLOW = 0x00080000
-MCI_ANIM_PLAY_SCAN = 0x00100000
-MCI_ANIM_STEP_REVERSE = 0x00010000
-MCI_ANIM_STEP_FRAMES = 0x00020000
-MCI_ANIM_STATUS_SPEED = 0x00004001
-MCI_ANIM_STATUS_FORWARD = 0x00004002
-MCI_ANIM_STATUS_HWND = 0x00004003
-MCI_ANIM_STATUS_HPAL = 0x00004004
-MCI_ANIM_STATUS_STRETCH = 0x00004005
-MCI_ANIM_INFO_TEXT = 0x00010000
-MCI_ANIM_GETDEVCAPS_CAN_REVERSE = 0x00004001
-MCI_ANIM_GETDEVCAPS_FAST_RATE = 0x00004002
-MCI_ANIM_GETDEVCAPS_SLOW_RATE = 0x00004003
-MCI_ANIM_GETDEVCAPS_NORMAL_RATE = 0x00004004
-MCI_ANIM_GETDEVCAPS_PALETTES = 0x00004006
-MCI_ANIM_GETDEVCAPS_CAN_STRETCH = 0x00004007
-MCI_ANIM_GETDEVCAPS_MAX_WINDOWS = 0x00004008
-MCI_ANIM_REALIZE_NORM = 0x00010000
-MCI_ANIM_REALIZE_BKGD = 0x00020000
-MCI_ANIM_WINDOW_HWND = 0x00010000
-MCI_ANIM_WINDOW_STATE = 0x00040000
-MCI_ANIM_WINDOW_TEXT = 0x00080000
-MCI_ANIM_WINDOW_ENABLE_STRETCH = 0x00100000
-MCI_ANIM_WINDOW_DISABLE_STRETCH = 0x00200000
-MCI_ANIM_WINDOW_DEFAULT = 0x00000000
-MCI_ANIM_RECT = 0x00010000
-MCI_ANIM_PUT_SOURCE = 0x00020000
-MCI_ANIM_PUT_DESTINATION = 0x00040000
-MCI_ANIM_WHERE_SOURCE = 0x00020000
-MCI_ANIM_WHERE_DESTINATION = 0x00040000
-MCI_ANIM_UPDATE_HDC = 0x00020000
-MCI_OVLY_OPEN_WS = 0x00010000
-MCI_OVLY_OPEN_PARENT = 0x00020000
-MCI_OVLY_STATUS_HWND = 0x00004001
-MCI_OVLY_STATUS_STRETCH = 0x00004002
-MCI_OVLY_INFO_TEXT = 0x00010000
-MCI_OVLY_GETDEVCAPS_CAN_STRETCH = 0x00004001
-MCI_OVLY_GETDEVCAPS_CAN_FREEZE = 0x00004002
-MCI_OVLY_GETDEVCAPS_MAX_WINDOWS = 0x00004003
-MCI_OVLY_WINDOW_HWND = 0x00010000
-MCI_OVLY_WINDOW_STATE = 0x00040000
-MCI_OVLY_WINDOW_TEXT = 0x00080000
-MCI_OVLY_WINDOW_ENABLE_STRETCH = 0x00100000
-MCI_OVLY_WINDOW_DISABLE_STRETCH = 0x00200000
-MCI_OVLY_WINDOW_DEFAULT = 0x00000000
-MCI_OVLY_RECT = 0x00010000
-MCI_OVLY_PUT_SOURCE = 0x00020000
-MCI_OVLY_PUT_DESTINATION = 0x00040000
-MCI_OVLY_PUT_FRAME = 0x00080000
-MCI_OVLY_PUT_VIDEO = 0x00100000
-MCI_OVLY_WHERE_SOURCE = 0x00020000
-MCI_OVLY_WHERE_DESTINATION = 0x00040000
-MCI_OVLY_WHERE_FRAME = 0x00080000
-MCI_OVLY_WHERE_VIDEO = 0x00100000
-SELECTDIB = 41
-
-
-def DIBINDEX(n):
-    return MAKELONG((n), 0x10FF)
diff --git a/lib/win32/lib/netbios.py b/lib/win32/lib/netbios.py
deleted file mode 100644
index dca4dee6..00000000
--- a/lib/win32/lib/netbios.py
+++ /dev/null
@@ -1,304 +0,0 @@
-import struct
-import sys
-
-import win32wnet
-
-# Constants generated by h2py from nb30.h
-NCBNAMSZ = 16
-MAX_LANA = 254
-NAME_FLAGS_MASK = 0x87
-GROUP_NAME = 0x80
-UNIQUE_NAME = 0x00
-REGISTERING = 0x00
-REGISTERED = 0x04
-DEREGISTERED = 0x05
-DUPLICATE = 0x06
-DUPLICATE_DEREG = 0x07
-LISTEN_OUTSTANDING = 0x01
-CALL_PENDING = 0x02
-SESSION_ESTABLISHED = 0x03
-HANGUP_PENDING = 0x04
-HANGUP_COMPLETE = 0x05
-SESSION_ABORTED = 0x06
-ALL_TRANSPORTS = "M\0\0\0"
-MS_NBF = "MNBF"
-NCBCALL = 0x10
-NCBLISTEN = 0x11
-NCBHANGUP = 0x12
-NCBSEND = 0x14
-NCBRECV = 0x15
-NCBRECVANY = 0x16
-NCBCHAINSEND = 0x17
-NCBDGSEND = 0x20
-NCBDGRECV = 0x21
-NCBDGSENDBC = 0x22
-NCBDGRECVBC = 0x23
-NCBADDNAME = 0x30
-NCBDELNAME = 0x31
-NCBRESET = 0x32
-NCBASTAT = 0x33
-NCBSSTAT = 0x34
-NCBCANCEL = 0x35
-NCBADDGRNAME = 0x36
-NCBENUM = 0x37
-NCBUNLINK = 0x70
-NCBSENDNA = 0x71
-NCBCHAINSENDNA = 0x72
-NCBLANSTALERT = 0x73
-NCBACTION = 0x77
-NCBFINDNAME = 0x78
-NCBTRACE = 0x79
-ASYNCH = 0x80
-NRC_GOODRET = 0x00
-NRC_BUFLEN = 0x01
-NRC_ILLCMD = 0x03
-NRC_CMDTMO = 0x05
-NRC_INCOMP = 0x06
-NRC_BADDR = 0x07
-NRC_SNUMOUT = 0x08
-NRC_NORES = 0x09
-NRC_SCLOSED = 0x0A
-NRC_CMDCAN = 0x0B
-NRC_DUPNAME = 0x0D
-NRC_NAMTFUL = 0x0E
-NRC_ACTSES = 0x0F
-NRC_LOCTFUL = 0x11
-NRC_REMTFUL = 0x12
-NRC_ILLNN = 0x13
-NRC_NOCALL = 0x14
-NRC_NOWILD = 0x15
-NRC_INUSE = 0x16
-NRC_NAMERR = 0x17
-NRC_SABORT = 0x18
-NRC_NAMCONF = 0x19
-NRC_IFBUSY = 0x21
-NRC_TOOMANY = 0x22
-NRC_BRIDGE = 0x23
-NRC_CANOCCR = 0x24
-NRC_CANCEL = 0x26
-NRC_DUPENV = 0x30
-NRC_ENVNOTDEF = 0x34
-NRC_OSRESNOTAV = 0x35
-NRC_MAXAPPS = 0x36
-NRC_NOSAPS = 0x37
-NRC_NORESOURCES = 0x38
-NRC_INVADDRESS = 0x39
-NRC_INVDDID = 0x3B
-NRC_LOCKFAIL = 0x3C
-NRC_OPENERR = 0x3F
-NRC_SYSTEM = 0x40
-NRC_PENDING = 0xFF
-
-
-UCHAR = "B"
-WORD = "H"
-DWORD = "I"
-USHORT = "H"
-ULONG = "I"
-
-ADAPTER_STATUS_ITEMS = [
-    ("6s", "adapter_address"),
-    (UCHAR, "rev_major"),
-    (UCHAR, "reserved0"),
-    (UCHAR, "adapter_type"),
-    (UCHAR, "rev_minor"),
-    (WORD, "duration"),
-    (WORD, "frmr_recv"),
-    (WORD, "frmr_xmit"),
-    (WORD, "iframe_recv_err"),
-    (WORD, "xmit_aborts"),
-    (DWORD, "xmit_success"),
-    (DWORD, "recv_success"),
-    (WORD, "iframe_xmit_err"),
-    (WORD, "recv_buff_unavail"),
-    (WORD, "t1_timeouts"),
-    (WORD, "ti_timeouts"),
-    (DWORD, "reserved1"),
-    (WORD, "free_ncbs"),
-    (WORD, "max_cfg_ncbs"),
-    (WORD, "max_ncbs"),
-    (WORD, "xmit_buf_unavail"),
-    (WORD, "max_dgram_size"),
-    (WORD, "pending_sess"),
-    (WORD, "max_cfg_sess"),
-    (WORD, "max_sess"),
-    (WORD, "max_sess_pkt_size"),
-    (WORD, "name_count"),
-]
-
-NAME_BUFFER_ITEMS = [
-    (str(NCBNAMSZ) + "s", "name"),
-    (UCHAR, "name_num"),
-    (UCHAR, "name_flags"),
-]
-
-SESSION_HEADER_ITEMS = [
-    (UCHAR, "sess_name"),
-    (UCHAR, "num_sess"),
-    (UCHAR, "rcv_dg_outstanding"),
-    (UCHAR, "rcv_any_outstanding"),
-]
-
-SESSION_BUFFER_ITEMS = [
-    (UCHAR, "lsn"),
-    (UCHAR, "state"),
-    (str(NCBNAMSZ) + "s", "local_name"),
-    (str(NCBNAMSZ) + "s", "remote_name"),
-    (UCHAR, "rcvs_outstanding"),
-    (UCHAR, "sends_outstanding"),
-]
-
-LANA_ENUM_ITEMS = [
-    ("B", "length"),  # Number of valid entries in lana[]
-    (str(MAX_LANA + 1) + "s", "lana"),
-]
-
-FIND_NAME_HEADER_ITEMS = [
-    (WORD, "node_count"),
-    (UCHAR, "reserved"),
-    (UCHAR, "unique_group"),
-]
-
-FIND_NAME_BUFFER_ITEMS = [
-    (UCHAR, "length"),
-    (UCHAR, "access_control"),
-    (UCHAR, "frame_control"),
-    ("6s", "destination_addr"),
-    ("6s", "source_addr"),
-    ("18s", "routing_info"),
-]
-
-ACTION_HEADER_ITEMS = [
-    (ULONG, "transport_id"),
-    (USHORT, "action_code"),
-    (USHORT, "reserved"),
-]
-
-del UCHAR, WORD, DWORD, USHORT, ULONG
-
-NCB = win32wnet.NCB
-
-
-def Netbios(ncb):
-    ob = ncb.Buffer
-    is_ours = hasattr(ob, "_pack")
-    if is_ours:
-        ob._pack()
-    try:
-        return win32wnet.Netbios(ncb)
-    finally:
-        if is_ours:
-            ob._unpack()
-
-
-class NCBStruct:
-    def __init__(self, items):
-        self._format = "".join([item[0] for item in items])
-        self._items = items
-        self._buffer_ = win32wnet.NCBBuffer(struct.calcsize(self._format))
-
-        for format, name in self._items:
-            if len(format) == 1:
-                if format == "c":
-                    val = "\0"
-                else:
-                    val = 0
-            else:
-                l = int(format[:-1])
-                val = "\0" * l
-            self.__dict__[name] = val
-
-    def _pack(self):
-        vals = []
-        for format, name in self._items:
-            try:
-                vals.append(self.__dict__[name])
-            except KeyError:
-                vals.append(None)
-
-        self._buffer_[:] = struct.pack(*(self._format,) + tuple(vals))
-
-    def _unpack(self):
-        items = struct.unpack(self._format, self._buffer_)
-        assert len(items) == len(self._items), "unexpected number of items to unpack!"
-        for (format, name), val in zip(self._items, items):
-            self.__dict__[name] = val
-
-    def __setattr__(self, attr, val):
-        if attr not in self.__dict__ and attr[0] != "_":
-            for format, attr_name in self._items:
-                if attr == attr_name:
-                    break
-            else:
-                raise AttributeError(attr)
-        self.__dict__[attr] = val
-
-
-def ADAPTER_STATUS():
-    return NCBStruct(ADAPTER_STATUS_ITEMS)
-
-
-def NAME_BUFFER():
-    return NCBStruct(NAME_BUFFER_ITEMS)
-
-
-def SESSION_HEADER():
-    return NCBStruct(SESSION_HEADER_ITEMS)
-
-
-def SESSION_BUFFER():
-    return NCBStruct(SESSION_BUFFER_ITEMS)
-
-
-def LANA_ENUM():
-    return NCBStruct(LANA_ENUM_ITEMS)
-
-
-def FIND_NAME_HEADER():
-    return NCBStruct(FIND_NAME_HEADER_ITEMS)
-
-
-def FIND_NAME_BUFFER():
-    return NCBStruct(FIND_NAME_BUFFER_ITEMS)
-
-
-def ACTION_HEADER():
-    return NCBStruct(ACTION_HEADER_ITEMS)
-
-
-def byte_to_int(b):
-    """Given an element in a binary buffer, return its integer value"""
-    if sys.version_info >= (3, 0):
-        # a byte is already an int in py3k
-        return b
-    return ord(b)  # its a char from a string in py2k.
-
-
-if __name__ == "__main__":
-    # code ported from "HOWTO: Get the MAC Address for an Ethernet Adapter"
-    # MS KB ID: Q118623
-    ncb = NCB()
-    ncb.Command = NCBENUM
-    la_enum = LANA_ENUM()
-    ncb.Buffer = la_enum
-    rc = Netbios(ncb)
-    if rc != 0:
-        raise RuntimeError("Unexpected result %d" % (rc,))
-    for i in range(la_enum.length):
-        ncb.Reset()
-        ncb.Command = NCBRESET
-        ncb.Lana_num = byte_to_int(la_enum.lana[i])
-        rc = Netbios(ncb)
-        if rc != 0:
-            raise RuntimeError("Unexpected result %d" % (rc,))
-        ncb.Reset()
-        ncb.Command = NCBASTAT
-        ncb.Lana_num = byte_to_int(la_enum.lana[i])
-        ncb.Callname = "*               ".encode("ascii")  # ensure bytes on py2x and 3k
-        adapter = ADAPTER_STATUS()
-        ncb.Buffer = adapter
-        Netbios(ncb)
-        print("Adapter address:", end=" ")
-        for ch in adapter.adapter_address:
-            print("%02x" % (byte_to_int(ch),), end=" ")
-        print()
diff --git a/lib/win32/lib/ntsecuritycon.py b/lib/win32/lib/ntsecuritycon.py
deleted file mode 100644
index 4d5b2ed5..00000000
--- a/lib/win32/lib/ntsecuritycon.py
+++ /dev/null
@@ -1,731 +0,0 @@
-# Hacked from winnt.h
-
-DELETE = 65536
-READ_CONTROL = 131072
-WRITE_DAC = 262144
-WRITE_OWNER = 524288
-SYNCHRONIZE = 1048576
-STANDARD_RIGHTS_REQUIRED = 983040
-STANDARD_RIGHTS_READ = READ_CONTROL
-STANDARD_RIGHTS_WRITE = READ_CONTROL
-STANDARD_RIGHTS_EXECUTE = READ_CONTROL
-STANDARD_RIGHTS_ALL = 2031616
-SPECIFIC_RIGHTS_ALL = 65535
-ACCESS_SYSTEM_SECURITY = 16777216
-MAXIMUM_ALLOWED = 33554432
-GENERIC_READ = -2147483648
-GENERIC_WRITE = 1073741824
-GENERIC_EXECUTE = 536870912
-GENERIC_ALL = 268435456
-
-# file security permissions
-FILE_READ_DATA = 1
-FILE_LIST_DIRECTORY = 1
-FILE_WRITE_DATA = 2
-FILE_ADD_FILE = 2
-FILE_APPEND_DATA = 4
-FILE_ADD_SUBDIRECTORY = 4
-FILE_CREATE_PIPE_INSTANCE = 4
-FILE_READ_EA = 8
-FILE_WRITE_EA = 16
-FILE_EXECUTE = 32
-FILE_TRAVERSE = 32
-FILE_DELETE_CHILD = 64
-FILE_READ_ATTRIBUTES = 128
-FILE_WRITE_ATTRIBUTES = 256
-FILE_ALL_ACCESS = STANDARD_RIGHTS_REQUIRED | SYNCHRONIZE | 511
-FILE_GENERIC_READ = (
-    STANDARD_RIGHTS_READ
-    | FILE_READ_DATA
-    | FILE_READ_ATTRIBUTES
-    | FILE_READ_EA
-    | SYNCHRONIZE
-)
-FILE_GENERIC_WRITE = (
-    STANDARD_RIGHTS_WRITE
-    | FILE_WRITE_DATA
-    | FILE_WRITE_ATTRIBUTES
-    | FILE_WRITE_EA
-    | FILE_APPEND_DATA
-    | SYNCHRONIZE
-)
-FILE_GENERIC_EXECUTE = (
-    STANDARD_RIGHTS_EXECUTE | FILE_READ_ATTRIBUTES | FILE_EXECUTE | SYNCHRONIZE
-)
-
-
-SECURITY_NULL_SID_AUTHORITY = (0, 0, 0, 0, 0, 0)
-SECURITY_WORLD_SID_AUTHORITY = (0, 0, 0, 0, 0, 1)
-SECURITY_LOCAL_SID_AUTHORITY = (0, 0, 0, 0, 0, 2)
-SECURITY_CREATOR_SID_AUTHORITY = (0, 0, 0, 0, 0, 3)
-SECURITY_NON_UNIQUE_AUTHORITY = (0, 0, 0, 0, 0, 4)
-SECURITY_RESOURCE_MANAGER_AUTHORITY = (0, 0, 0, 0, 0, 9)
-
-SECURITY_NULL_RID = 0
-SECURITY_WORLD_RID = 0
-SECURITY_LOCAL_RID = 0x00000000
-
-SECURITY_CREATOR_OWNER_RID = 0
-SECURITY_CREATOR_GROUP_RID = 1
-
-SECURITY_CREATOR_OWNER_SERVER_RID = 2
-SECURITY_CREATOR_GROUP_SERVER_RID = 3
-SECURITY_CREATOR_OWNER_RIGHTS_RID = 4
-
-# NT well-known SIDs
-SECURITY_NT_AUTHORITY = (0, 0, 0, 0, 0, 5)
-
-SECURITY_DIALUP_RID = 1
-SECURITY_NETWORK_RID = 2
-SECURITY_BATCH_RID = 3
-SECURITY_INTERACTIVE_RID = 4
-SECURITY_SERVICE_RID = 6
-SECURITY_ANONYMOUS_LOGON_RID = 7
-SECURITY_PROXY_RID = 8
-SECURITY_SERVER_LOGON_RID = 9
-
-SECURITY_LOGON_IDS_RID = 5
-SECURITY_LOGON_IDS_RID_COUNT = 3
-
-SECURITY_LOCAL_SYSTEM_RID = 18
-
-SECURITY_NT_NON_UNIQUE = 21
-
-SECURITY_BUILTIN_DOMAIN_RID = 32
-
-# well-known domain relative sub-authority values (RIDs)...
-DOMAIN_USER_RID_ADMIN = 500
-DOMAIN_USER_RID_GUEST = 501
-DOMAIN_USER_RID_KRBTGT = 502
-DOMAIN_USER_RID_MAX = 999
-
-# well-known groups ...
-DOMAIN_GROUP_RID_ADMINS = 512
-DOMAIN_GROUP_RID_USERS = 513
-DOMAIN_GROUP_RID_GUESTS = 514
-DOMAIN_GROUP_RID_COMPUTERS = 515
-DOMAIN_GROUP_RID_CONTROLLERS = 516
-DOMAIN_GROUP_RID_CERT_ADMINS = 517
-DOMAIN_GROUP_RID_SCHEMA_ADMINS = 518
-DOMAIN_GROUP_RID_ENTERPRISE_ADMINS = 519
-DOMAIN_GROUP_RID_POLICY_ADMINS = 520
-DOMAIN_GROUP_RID_READONLY_CONTROLLERS = 521
-
-# well-known aliases ...
-DOMAIN_ALIAS_RID_ADMINS = 544
-DOMAIN_ALIAS_RID_USERS = 545
-DOMAIN_ALIAS_RID_GUESTS = 546
-DOMAIN_ALIAS_RID_POWER_USERS = 547
-DOMAIN_ALIAS_RID_ACCOUNT_OPS = 548
-DOMAIN_ALIAS_RID_SYSTEM_OPS = 549
-DOMAIN_ALIAS_RID_PRINT_OPS = 550
-DOMAIN_ALIAS_RID_BACKUP_OPS = 551
-DOMAIN_ALIAS_RID_REPLICATOR = 552
-DOMAIN_ALIAS_RID_RAS_SERVERS = 553
-DOMAIN_ALIAS_RID_PREW2KCOMPACCESS = 554
-DOMAIN_ALIAS_RID_REMOTE_DESKTOP_USERS = 555
-DOMAIN_ALIAS_RID_NETWORK_CONFIGURATION_OPS = 556
-DOMAIN_ALIAS_RID_INCOMING_FOREST_TRUST_BUILDERS = 557
-DOMAIN_ALIAS_RID_MONITORING_USERS = 558
-DOMAIN_ALIAS_RID_LOGGING_USERS = 559
-DOMAIN_ALIAS_RID_AUTHORIZATIONACCESS = 560
-DOMAIN_ALIAS_RID_TS_LICENSE_SERVERS = 561
-DOMAIN_ALIAS_RID_DCOM_USERS = 562
-DOMAIN_ALIAS_RID_IUSERS = 568
-DOMAIN_ALIAS_RID_CRYPTO_OPERATORS = 569
-DOMAIN_ALIAS_RID_CACHEABLE_PRINCIPALS_GROUP = 571
-DOMAIN_ALIAS_RID_NON_CACHEABLE_PRINCIPALS_GROUP = 572
-DOMAIN_ALIAS_RID_EVENT_LOG_READERS_GROUP = 573
-
-SECURITY_MANDATORY_LABEL_AUTHORITY = (0, 0, 0, 0, 0, 16)
-SECURITY_MANDATORY_UNTRUSTED_RID = 0x00000000
-SECURITY_MANDATORY_LOW_RID = 0x00001000
-SECURITY_MANDATORY_MEDIUM_RID = 0x00002000
-SECURITY_MANDATORY_HIGH_RID = 0x00003000
-SECURITY_MANDATORY_SYSTEM_RID = 0x00004000
-SECURITY_MANDATORY_PROTECTED_PROCESS_RID = 0x00005000
-SECURITY_MANDATORY_MAXIMUM_USER_RID = SECURITY_MANDATORY_SYSTEM_RID
-
-SYSTEM_LUID = (999, 0)
-ANONYMOUS_LOGON_LUID = (998, 0)
-LOCALSERVICE_LUID = (997, 0)
-NETWORKSERVICE_LUID = (996, 0)
-IUSER_LUID = (995, 0)
-
-# Group attributes
-
-SE_GROUP_MANDATORY = 1
-SE_GROUP_ENABLED_BY_DEFAULT = 2
-SE_GROUP_ENABLED = 4
-SE_GROUP_OWNER = 8
-SE_GROUP_USE_FOR_DENY_ONLY = 16
-SE_GROUP_INTEGRITY = 32
-SE_GROUP_INTEGRITY_ENABLED = 64
-SE_GROUP_RESOURCE = 536870912
-SE_GROUP_LOGON_ID = -1073741824
-
-
-# User attributes
-# (None yet defined.)
-
-# ACE types
-ACCESS_MIN_MS_ACE_TYPE = 0
-ACCESS_ALLOWED_ACE_TYPE = 0
-ACCESS_DENIED_ACE_TYPE = 1
-SYSTEM_AUDIT_ACE_TYPE = 2
-SYSTEM_ALARM_ACE_TYPE = 3
-ACCESS_MAX_MS_V2_ACE_TYPE = 3
-ACCESS_ALLOWED_COMPOUND_ACE_TYPE = 4
-ACCESS_MAX_MS_V3_ACE_TYPE = 4
-ACCESS_MIN_MS_OBJECT_ACE_TYPE = 5
-ACCESS_ALLOWED_OBJECT_ACE_TYPE = 5
-ACCESS_DENIED_OBJECT_ACE_TYPE = 6
-SYSTEM_AUDIT_OBJECT_ACE_TYPE = 7
-SYSTEM_ALARM_OBJECT_ACE_TYPE = 8
-ACCESS_MAX_MS_OBJECT_ACE_TYPE = 8
-ACCESS_MAX_MS_V4_ACE_TYPE = 8
-ACCESS_MAX_MS_ACE_TYPE = 8
-ACCESS_ALLOWED_CALLBACK_ACE_TYPE = 9
-ACCESS_DENIED_CALLBACK_ACE_TYPE = 10
-ACCESS_ALLOWED_CALLBACK_OBJECT_ACE_TYPE = 11
-ACCESS_DENIED_CALLBACK_OBJECT_ACE_TYPE = 12
-SYSTEM_AUDIT_CALLBACK_ACE_TYPE = 13
-SYSTEM_ALARM_CALLBACK_ACE_TYPE = 14
-SYSTEM_AUDIT_CALLBACK_OBJECT_ACE_TYPE = 15
-SYSTEM_ALARM_CALLBACK_OBJECT_ACE_TYPE = 16
-SYSTEM_MANDATORY_LABEL_ACE_TYPE = 17
-ACCESS_MAX_MS_V5_ACE_TYPE = 17
-
-#  The following are the inherit flags that go into the AceFlags field
-#  of an Ace header.
-
-OBJECT_INHERIT_ACE = 1
-CONTAINER_INHERIT_ACE = 2
-NO_PROPAGATE_INHERIT_ACE = 4
-INHERIT_ONLY_ACE = 8
-VALID_INHERIT_FLAGS = 15
-
-
-SUCCESSFUL_ACCESS_ACE_FLAG = 64
-FAILED_ACCESS_ACE_FLAG = 128
-
-SE_OWNER_DEFAULTED = 1
-SE_GROUP_DEFAULTED = 2
-SE_DACL_PRESENT = 4
-SE_DACL_DEFAULTED = 8
-SE_SACL_PRESENT = 16
-SE_SACL_DEFAULTED = 32
-SE_SELF_RELATIVE = 32768
-
-
-SE_PRIVILEGE_ENABLED_BY_DEFAULT = 1
-SE_PRIVILEGE_ENABLED = 2
-SE_PRIVILEGE_USED_FOR_ACCESS = -2147483648
-
-PRIVILEGE_SET_ALL_NECESSARY = 1
-
-#               NT Defined Privileges
-
-SE_CREATE_TOKEN_NAME = "SeCreateTokenPrivilege"
-SE_ASSIGNPRIMARYTOKEN_NAME = "SeAssignPrimaryTokenPrivilege"
-SE_LOCK_MEMORY_NAME = "SeLockMemoryPrivilege"
-SE_INCREASE_QUOTA_NAME = "SeIncreaseQuotaPrivilege"
-SE_UNSOLICITED_INPUT_NAME = "SeUnsolicitedInputPrivilege"
-SE_MACHINE_ACCOUNT_NAME = "SeMachineAccountPrivilege"
-SE_TCB_NAME = "SeTcbPrivilege"
-SE_SECURITY_NAME = "SeSecurityPrivilege"
-SE_TAKE_OWNERSHIP_NAME = "SeTakeOwnershipPrivilege"
-SE_LOAD_DRIVER_NAME = "SeLoadDriverPrivilege"
-SE_SYSTEM_PROFILE_NAME = "SeSystemProfilePrivilege"
-SE_SYSTEMTIME_NAME = "SeSystemtimePrivilege"
-SE_PROF_SINGLE_PROCESS_NAME = "SeProfileSingleProcessPrivilege"
-SE_INC_BASE_PRIORITY_NAME = "SeIncreaseBasePriorityPrivilege"
-SE_CREATE_PAGEFILE_NAME = "SeCreatePagefilePrivilege"
-SE_CREATE_PERMANENT_NAME = "SeCreatePermanentPrivilege"
-SE_BACKUP_NAME = "SeBackupPrivilege"
-SE_RESTORE_NAME = "SeRestorePrivilege"
-SE_SHUTDOWN_NAME = "SeShutdownPrivilege"
-SE_DEBUG_NAME = "SeDebugPrivilege"
-SE_AUDIT_NAME = "SeAuditPrivilege"
-SE_SYSTEM_ENVIRONMENT_NAME = "SeSystemEnvironmentPrivilege"
-SE_CHANGE_NOTIFY_NAME = "SeChangeNotifyPrivilege"
-SE_REMOTE_SHUTDOWN_NAME = "SeRemoteShutdownPrivilege"
-
-
-# Enum SECURITY_IMPERSONATION_LEVEL:
-SecurityAnonymous = 0
-SecurityIdentification = 1
-SecurityImpersonation = 2
-SecurityDelegation = 3
-
-SECURITY_MAX_IMPERSONATION_LEVEL = SecurityDelegation
-
-DEFAULT_IMPERSONATION_LEVEL = SecurityImpersonation
-
-TOKEN_ASSIGN_PRIMARY = 1
-TOKEN_DUPLICATE = 2
-TOKEN_IMPERSONATE = 4
-TOKEN_QUERY = 8
-TOKEN_QUERY_SOURCE = 16
-TOKEN_ADJUST_PRIVILEGES = 32
-TOKEN_ADJUST_GROUPS = 64
-TOKEN_ADJUST_DEFAULT = 128
-
-TOKEN_ALL_ACCESS = (
-    STANDARD_RIGHTS_REQUIRED
-    | TOKEN_ASSIGN_PRIMARY
-    | TOKEN_DUPLICATE
-    | TOKEN_IMPERSONATE
-    | TOKEN_QUERY
-    | TOKEN_QUERY_SOURCE
-    | TOKEN_ADJUST_PRIVILEGES
-    | TOKEN_ADJUST_GROUPS
-    | TOKEN_ADJUST_DEFAULT
-)
-
-
-TOKEN_READ = STANDARD_RIGHTS_READ | TOKEN_QUERY
-
-
-TOKEN_WRITE = (
-    STANDARD_RIGHTS_WRITE
-    | TOKEN_ADJUST_PRIVILEGES
-    | TOKEN_ADJUST_GROUPS
-    | TOKEN_ADJUST_DEFAULT
-)
-
-TOKEN_EXECUTE = STANDARD_RIGHTS_EXECUTE
-
-SidTypeUser = 1
-SidTypeGroup = 2
-SidTypeDomain = 3
-SidTypeAlias = 4
-SidTypeWellKnownGroup = 5
-SidTypeDeletedAccount = 6
-SidTypeInvalid = 7
-SidTypeUnknown = 8
-SidTypeComputer = 9
-SidTypeLabel = 10
-
-# Token types
-TokenPrimary = 1
-TokenImpersonation = 2
-
-# TOKEN_INFORMATION_CLASS, used with Get/SetTokenInformation
-TokenUser = 1
-TokenGroups = 2
-TokenPrivileges = 3
-TokenOwner = 4
-TokenPrimaryGroup = 5
-TokenDefaultDacl = 6
-TokenSource = 7
-TokenType = 8
-TokenImpersonationLevel = 9
-TokenStatistics = 10
-TokenRestrictedSids = 11
-TokenSessionId = 12
-TokenGroupsAndPrivileges = 13
-TokenSessionReference = 14
-TokenSandBoxInert = 15
-TokenAuditPolicy = 16
-TokenOrigin = 17
-TokenElevationType = 18
-TokenLinkedToken = 19
-TokenElevation = 20
-TokenHasRestrictions = 21
-TokenAccessInformation = 22
-TokenVirtualizationAllowed = 23
-TokenVirtualizationEnabled = 24
-TokenIntegrityLevel = 25
-TokenUIAccess = 26
-TokenMandatoryPolicy = 27
-TokenLogonSid = 28
-
-# DirectoryService related constants.
-# Generated by h2py from NtDsAPI.h
-DS_BEHAVIOR_WIN2000 = 0
-DS_BEHAVIOR_WIN2003_WITH_MIXED_DOMAINS = 1
-DS_BEHAVIOR_WIN2003 = 2
-DS_SYNCED_EVENT_NAME = "NTDSInitialSyncsCompleted"
-ACTRL_DS_OPEN = 0x00000000
-ACTRL_DS_CREATE_CHILD = 0x00000001
-ACTRL_DS_DELETE_CHILD = 0x00000002
-ACTRL_DS_LIST = 0x00000004
-ACTRL_DS_SELF = 0x00000008
-ACTRL_DS_READ_PROP = 0x00000010
-ACTRL_DS_WRITE_PROP = 0x00000020
-ACTRL_DS_DELETE_TREE = 0x00000040
-ACTRL_DS_LIST_OBJECT = 0x00000080
-ACTRL_DS_CONTROL_ACCESS = 0x00000100
-NTDSAPI_BIND_ALLOW_DELEGATION = 0x00000001
-DS_REPSYNC_ASYNCHRONOUS_OPERATION = 0x00000001
-DS_REPSYNC_WRITEABLE = 0x00000002
-DS_REPSYNC_PERIODIC = 0x00000004
-DS_REPSYNC_INTERSITE_MESSAGING = 0x00000008
-DS_REPSYNC_ALL_SOURCES = 0x00000010
-DS_REPSYNC_FULL = 0x00000020
-DS_REPSYNC_URGENT = 0x00000040
-DS_REPSYNC_NO_DISCARD = 0x00000080
-DS_REPSYNC_FORCE = 0x00000100
-DS_REPSYNC_ADD_REFERENCE = 0x00000200
-DS_REPSYNC_NEVER_COMPLETED = 0x00000400
-DS_REPSYNC_TWO_WAY = 0x00000800
-DS_REPSYNC_NEVER_NOTIFY = 0x00001000
-DS_REPSYNC_INITIAL = 0x00002000
-DS_REPSYNC_USE_COMPRESSION = 0x00004000
-DS_REPSYNC_ABANDONED = 0x00008000
-DS_REPSYNC_INITIAL_IN_PROGRESS = 0x00010000
-DS_REPSYNC_PARTIAL_ATTRIBUTE_SET = 0x00020000
-DS_REPSYNC_REQUEUE = 0x00040000
-DS_REPSYNC_NOTIFICATION = 0x00080000
-DS_REPSYNC_ASYNCHRONOUS_REPLICA = 0x00100000
-DS_REPSYNC_CRITICAL = 0x00200000
-DS_REPSYNC_FULL_IN_PROGRESS = 0x00400000
-DS_REPSYNC_PREEMPTED = 0x00800000
-DS_REPADD_ASYNCHRONOUS_OPERATION = 0x00000001
-DS_REPADD_WRITEABLE = 0x00000002
-DS_REPADD_INITIAL = 0x00000004
-DS_REPADD_PERIODIC = 0x00000008
-DS_REPADD_INTERSITE_MESSAGING = 0x00000010
-DS_REPADD_ASYNCHRONOUS_REPLICA = 0x00000020
-DS_REPADD_DISABLE_NOTIFICATION = 0x00000040
-DS_REPADD_DISABLE_PERIODIC = 0x00000080
-DS_REPADD_USE_COMPRESSION = 0x00000100
-DS_REPADD_NEVER_NOTIFY = 0x00000200
-DS_REPADD_TWO_WAY = 0x00000400
-DS_REPADD_CRITICAL = 0x00000800
-DS_REPDEL_ASYNCHRONOUS_OPERATION = 0x00000001
-DS_REPDEL_WRITEABLE = 0x00000002
-DS_REPDEL_INTERSITE_MESSAGING = 0x00000004
-DS_REPDEL_IGNORE_ERRORS = 0x00000008
-DS_REPDEL_LOCAL_ONLY = 0x00000010
-DS_REPDEL_NO_SOURCE = 0x00000020
-DS_REPDEL_REF_OK = 0x00000040
-DS_REPMOD_ASYNCHRONOUS_OPERATION = 0x00000001
-DS_REPMOD_WRITEABLE = 0x00000002
-DS_REPMOD_UPDATE_FLAGS = 0x00000001
-DS_REPMOD_UPDATE_ADDRESS = 0x00000002
-DS_REPMOD_UPDATE_SCHEDULE = 0x00000004
-DS_REPMOD_UPDATE_RESULT = 0x00000008
-DS_REPMOD_UPDATE_TRANSPORT = 0x00000010
-DS_REPUPD_ASYNCHRONOUS_OPERATION = 0x00000001
-DS_REPUPD_WRITEABLE = 0x00000002
-DS_REPUPD_ADD_REFERENCE = 0x00000004
-DS_REPUPD_DELETE_REFERENCE = 0x00000008
-DS_INSTANCETYPE_IS_NC_HEAD = 0x00000001
-DS_INSTANCETYPE_NC_IS_WRITEABLE = 0x00000004
-DS_INSTANCETYPE_NC_COMING = 0x00000010
-DS_INSTANCETYPE_NC_GOING = 0x00000020
-NTDSDSA_OPT_IS_GC = 1 << 0
-NTDSDSA_OPT_DISABLE_INBOUND_REPL = 1 << 1
-NTDSDSA_OPT_DISABLE_OUTBOUND_REPL = 1 << 2
-NTDSDSA_OPT_DISABLE_NTDSCONN_XLATE = 1 << 3
-NTDSCONN_OPT_IS_GENERATED = 1 << 0
-NTDSCONN_OPT_TWOWAY_SYNC = 1 << 1
-NTDSCONN_OPT_OVERRIDE_NOTIFY_DEFAULT = 1 << 2
-NTDSCONN_OPT_USE_NOTIFY = 1 << 3
-NTDSCONN_OPT_DISABLE_INTERSITE_COMPRESSION = 1 << 4
-NTDSCONN_OPT_USER_OWNED_SCHEDULE = 1 << 5
-NTDSCONN_KCC_NO_REASON = 0
-NTDSCONN_KCC_GC_TOPOLOGY = 1 << 0
-NTDSCONN_KCC_RING_TOPOLOGY = 1 << 1
-NTDSCONN_KCC_MINIMIZE_HOPS_TOPOLOGY = 1 << 2
-NTDSCONN_KCC_STALE_SERVERS_TOPOLOGY = 1 << 3
-NTDSCONN_KCC_OSCILLATING_CONNECTION_TOPOLOGY = 1 << 4
-NTDSCONN_KCC_INTERSITE_GC_TOPOLOGY = 1 << 5
-NTDSCONN_KCC_INTERSITE_TOPOLOGY = 1 << 6
-NTDSCONN_KCC_SERVER_FAILOVER_TOPOLOGY = 1 << 7
-NTDSCONN_KCC_SITE_FAILOVER_TOPOLOGY = 1 << 8
-NTDSCONN_KCC_REDUNDANT_SERVER_TOPOLOGY = 1 << 9
-FRSCONN_PRIORITY_MASK = 0x70000000
-FRSCONN_MAX_PRIORITY = 0x8
-NTDSCONN_OPT_IGNORE_SCHEDULE_MASK = -2147483648
-
-NTDSSETTINGS_OPT_IS_AUTO_TOPOLOGY_DISABLED = 1 << 0
-NTDSSETTINGS_OPT_IS_TOPL_CLEANUP_DISABLED = 1 << 1
-NTDSSETTINGS_OPT_IS_TOPL_MIN_HOPS_DISABLED = 1 << 2
-NTDSSETTINGS_OPT_IS_TOPL_DETECT_STALE_DISABLED = 1 << 3
-NTDSSETTINGS_OPT_IS_INTER_SITE_AUTO_TOPOLOGY_DISABLED = 1 << 4
-NTDSSETTINGS_OPT_IS_GROUP_CACHING_ENABLED = 1 << 5
-NTDSSETTINGS_OPT_FORCE_KCC_WHISTLER_BEHAVIOR = 1 << 6
-NTDSSETTINGS_OPT_FORCE_KCC_W2K_ELECTION = 1 << 7
-NTDSSETTINGS_OPT_IS_RAND_BH_SELECTION_DISABLED = 1 << 8
-NTDSSETTINGS_OPT_IS_SCHEDULE_HASHING_ENABLED = 1 << 9
-NTDSSETTINGS_OPT_IS_REDUNDANT_SERVER_TOPOLOGY_ENABLED = 1 << 10
-NTDSSETTINGS_DEFAULT_SERVER_REDUNDANCY = 2
-NTDSTRANSPORT_OPT_IGNORE_SCHEDULES = 1 << 0
-NTDSTRANSPORT_OPT_BRIDGES_REQUIRED = 1 << 1
-NTDSSITECONN_OPT_USE_NOTIFY = 1 << 0
-NTDSSITECONN_OPT_TWOWAY_SYNC = 1 << 1
-NTDSSITECONN_OPT_DISABLE_COMPRESSION = 1 << 2
-NTDSSITELINK_OPT_USE_NOTIFY = 1 << 0
-NTDSSITELINK_OPT_TWOWAY_SYNC = 1 << 1
-NTDSSITELINK_OPT_DISABLE_COMPRESSION = 1 << 2
-GUID_USERS_CONTAINER_A = "a9d1ca15768811d1aded00c04fd8d5cd"
-GUID_COMPUTRS_CONTAINER_A = "aa312825768811d1aded00c04fd8d5cd"
-GUID_SYSTEMS_CONTAINER_A = "ab1d30f3768811d1aded00c04fd8d5cd"
-GUID_DOMAIN_CONTROLLERS_CONTAINER_A = "a361b2ffffd211d1aa4b00c04fd7d83a"
-GUID_INFRASTRUCTURE_CONTAINER_A = "2fbac1870ade11d297c400c04fd8d5cd"
-GUID_DELETED_OBJECTS_CONTAINER_A = "18e2ea80684f11d2b9aa00c04f79f805"
-GUID_LOSTANDFOUND_CONTAINER_A = "ab8153b7768811d1aded00c04fd8d5cd"
-GUID_FOREIGNSECURITYPRINCIPALS_CONTAINER_A = "22b70c67d56e4efb91e9300fca3dc1aa"
-GUID_PROGRAM_DATA_CONTAINER_A = "09460c08ae1e4a4ea0f64aee7daa1e5a"
-GUID_MICROSOFT_PROGRAM_DATA_CONTAINER_A = "f4be92a4c777485e878e9421d53087db"
-GUID_NTDS_QUOTAS_CONTAINER_A = "6227f0af1fc2410d8e3bb10615bb5b0f"
-GUID_USERS_CONTAINER_BYTE = (
-    "\xa9\xd1\xca\x15\x76\x88\x11\xd1\xad\xed\x00\xc0\x4f\xd8\xd5\xcd"
-)
-GUID_COMPUTRS_CONTAINER_BYTE = (
-    "\xaa\x31\x28\x25\x76\x88\x11\xd1\xad\xed\x00\xc0\x4f\xd8\xd5\xcd"
-)
-GUID_SYSTEMS_CONTAINER_BYTE = (
-    "\xab\x1d\x30\xf3\x76\x88\x11\xd1\xad\xed\x00\xc0\x4f\xd8\xd5\xcd"
-)
-GUID_DOMAIN_CONTROLLERS_CONTAINER_BYTE = (
-    "\xa3\x61\xb2\xff\xff\xd2\x11\xd1\xaa\x4b\x00\xc0\x4f\xd7\xd8\x3a"
-)
-GUID_INFRASTRUCTURE_CONTAINER_BYTE = (
-    "\x2f\xba\xc1\x87\x0a\xde\x11\xd2\x97\xc4\x00\xc0\x4f\xd8\xd5\xcd"
-)
-GUID_DELETED_OBJECTS_CONTAINER_BYTE = (
-    "\x18\xe2\xea\x80\x68\x4f\x11\xd2\xb9\xaa\x00\xc0\x4f\x79\xf8\x05"
-)
-GUID_LOSTANDFOUND_CONTAINER_BYTE = (
-    "\xab\x81\x53\xb7\x76\x88\x11\xd1\xad\xed\x00\xc0\x4f\xd8\xd5\xcd"
-)
-GUID_FOREIGNSECURITYPRINCIPALS_CONTAINER_BYTE = (
-    "\x22\xb7\x0c\x67\xd5\x6e\x4e\xfb\x91\xe9\x30\x0f\xca\x3d\xc1\xaa"
-)
-GUID_PROGRAM_DATA_CONTAINER_BYTE = (
-    "\x09\x46\x0c\x08\xae\x1e\x4a\x4e\xa0\xf6\x4a\xee\x7d\xaa\x1e\x5a"
-)
-GUID_MICROSOFT_PROGRAM_DATA_CONTAINER_BYTE = (
-    "\xf4\xbe\x92\xa4\xc7\x77\x48\x5e\x87\x8e\x94\x21\xd5\x30\x87\xdb"
-)
-GUID_NTDS_QUOTAS_CONTAINER_BYTE = (
-    "\x62\x27\xf0\xaf\x1f\xc2\x41\x0d\x8e\x3b\xb1\x06\x15\xbb\x5b\x0f"
-)
-DS_REPSYNCALL_NO_OPTIONS = 0x00000000
-DS_REPSYNCALL_ABORT_IF_SERVER_UNAVAILABLE = 0x00000001
-DS_REPSYNCALL_SYNC_ADJACENT_SERVERS_ONLY = 0x00000002
-DS_REPSYNCALL_ID_SERVERS_BY_DN = 0x00000004
-DS_REPSYNCALL_DO_NOT_SYNC = 0x00000008
-DS_REPSYNCALL_SKIP_INITIAL_CHECK = 0x00000010
-DS_REPSYNCALL_PUSH_CHANGES_OUTWARD = 0x00000020
-DS_REPSYNCALL_CROSS_SITE_BOUNDARIES = 0x00000040
-DS_LIST_DSA_OBJECT_FOR_SERVER = 0
-DS_LIST_DNS_HOST_NAME_FOR_SERVER = 1
-DS_LIST_ACCOUNT_OBJECT_FOR_SERVER = 2
-DS_ROLE_SCHEMA_OWNER = 0
-DS_ROLE_DOMAIN_OWNER = 1
-DS_ROLE_PDC_OWNER = 2
-DS_ROLE_RID_OWNER = 3
-DS_ROLE_INFRASTRUCTURE_OWNER = 4
-DS_SCHEMA_GUID_NOT_FOUND = 0
-DS_SCHEMA_GUID_ATTR = 1
-DS_SCHEMA_GUID_ATTR_SET = 2
-DS_SCHEMA_GUID_CLASS = 3
-DS_SCHEMA_GUID_CONTROL_RIGHT = 4
-DS_KCC_FLAG_ASYNC_OP = 1 << 0
-DS_KCC_FLAG_DAMPED = 1 << 1
-DS_EXIST_ADVISORY_MODE = 0x1
-DS_REPL_INFO_FLAG_IMPROVE_LINKED_ATTRS = 0x00000001
-DS_REPL_NBR_WRITEABLE = 0x00000010
-DS_REPL_NBR_SYNC_ON_STARTUP = 0x00000020
-DS_REPL_NBR_DO_SCHEDULED_SYNCS = 0x00000040
-DS_REPL_NBR_USE_ASYNC_INTERSITE_TRANSPORT = 0x00000080
-DS_REPL_NBR_TWO_WAY_SYNC = 0x00000200
-DS_REPL_NBR_RETURN_OBJECT_PARENTS = 0x00000800
-DS_REPL_NBR_FULL_SYNC_IN_PROGRESS = 0x00010000
-DS_REPL_NBR_FULL_SYNC_NEXT_PACKET = 0x00020000
-DS_REPL_NBR_NEVER_SYNCED = 0x00200000
-DS_REPL_NBR_PREEMPTED = 0x01000000
-DS_REPL_NBR_IGNORE_CHANGE_NOTIFICATIONS = 0x04000000
-DS_REPL_NBR_DISABLE_SCHEDULED_SYNC = 0x08000000
-DS_REPL_NBR_COMPRESS_CHANGES = 0x10000000
-DS_REPL_NBR_NO_CHANGE_NOTIFICATIONS = 0x20000000
-DS_REPL_NBR_PARTIAL_ATTRIBUTE_SET = 0x40000000
-DS_REPL_NBR_MODIFIABLE_MASK = (
-    DS_REPL_NBR_SYNC_ON_STARTUP
-    | DS_REPL_NBR_DO_SCHEDULED_SYNCS
-    | DS_REPL_NBR_TWO_WAY_SYNC
-    | DS_REPL_NBR_IGNORE_CHANGE_NOTIFICATIONS
-    | DS_REPL_NBR_DISABLE_SCHEDULED_SYNC
-    | DS_REPL_NBR_COMPRESS_CHANGES
-    | DS_REPL_NBR_NO_CHANGE_NOTIFICATIONS
-)
-
-# from enum DS_NAME_FORMAT
-DS_UNKNOWN_NAME = 0
-DS_FQDN_1779_NAME = 1
-DS_NT4_ACCOUNT_NAME = 2
-DS_DISPLAY_NAME = 3
-DS_UNIQUE_ID_NAME = 6
-DS_CANONICAL_NAME = 7
-DS_USER_PRINCIPAL_NAME = 8
-DS_CANONICAL_NAME_EX = 9
-DS_SERVICE_PRINCIPAL_NAME = 10
-DS_SID_OR_SID_HISTORY_NAME = 11
-DS_DNS_DOMAIN_NAME = 12
-
-DS_DOMAIN_SIMPLE_NAME = DS_USER_PRINCIPAL_NAME
-DS_ENTERPRISE_SIMPLE_NAME = DS_USER_PRINCIPAL_NAME
-
-# from enum DS_NAME_FLAGS
-DS_NAME_NO_FLAGS = 0x0
-DS_NAME_FLAG_SYNTACTICAL_ONLY = 0x1
-DS_NAME_FLAG_EVAL_AT_DC = 0x2
-DS_NAME_FLAG_GCVERIFY = 0x4
-DS_NAME_FLAG_TRUST_REFERRAL = 0x8
-
-# from enum DS_NAME_ERROR
-DS_NAME_NO_ERROR = 0
-DS_NAME_ERROR_RESOLVING = 1
-DS_NAME_ERROR_NOT_FOUND = 2
-DS_NAME_ERROR_NOT_UNIQUE = 3
-DS_NAME_ERROR_NO_MAPPING = 4
-DS_NAME_ERROR_DOMAIN_ONLY = 5
-DS_NAME_ERROR_NO_SYNTACTICAL_MAPPING = 6
-DS_NAME_ERROR_TRUST_REFERRAL = 7
-
-
-# from enum DS_SPN_NAME_TYPE
-DS_SPN_DNS_HOST = 0
-DS_SPN_DN_HOST = 1
-DS_SPN_NB_HOST = 2
-DS_SPN_DOMAIN = 3
-DS_SPN_NB_DOMAIN = 4
-DS_SPN_SERVICE = 5
-
-# from enum DS_SPN_WRITE_OP
-DS_SPN_ADD_SPN_OP = 0
-DS_SPN_REPLACE_SPN_OP = 1
-DS_SPN_DELETE_SPN_OP = 2
-
-# Generated by h2py from DsGetDC.h
-DS_FORCE_REDISCOVERY = 0x00000001
-DS_DIRECTORY_SERVICE_REQUIRED = 0x00000010
-DS_DIRECTORY_SERVICE_PREFERRED = 0x00000020
-DS_GC_SERVER_REQUIRED = 0x00000040
-DS_PDC_REQUIRED = 0x00000080
-DS_BACKGROUND_ONLY = 0x00000100
-DS_IP_REQUIRED = 0x00000200
-DS_KDC_REQUIRED = 0x00000400
-DS_TIMESERV_REQUIRED = 0x00000800
-DS_WRITABLE_REQUIRED = 0x00001000
-DS_GOOD_TIMESERV_PREFERRED = 0x00002000
-DS_AVOID_SELF = 0x00004000
-DS_ONLY_LDAP_NEEDED = 0x00008000
-DS_IS_FLAT_NAME = 0x00010000
-DS_IS_DNS_NAME = 0x00020000
-DS_RETURN_DNS_NAME = 0x40000000
-DS_RETURN_FLAT_NAME = -2147483648
-DSGETDC_VALID_FLAGS = (
-    DS_FORCE_REDISCOVERY
-    | DS_DIRECTORY_SERVICE_REQUIRED
-    | DS_DIRECTORY_SERVICE_PREFERRED
-    | DS_GC_SERVER_REQUIRED
-    | DS_PDC_REQUIRED
-    | DS_BACKGROUND_ONLY
-    | DS_IP_REQUIRED
-    | DS_KDC_REQUIRED
-    | DS_TIMESERV_REQUIRED
-    | DS_WRITABLE_REQUIRED
-    | DS_GOOD_TIMESERV_PREFERRED
-    | DS_AVOID_SELF
-    | DS_ONLY_LDAP_NEEDED
-    | DS_IS_FLAT_NAME
-    | DS_IS_DNS_NAME
-    | DS_RETURN_FLAT_NAME
-    | DS_RETURN_DNS_NAME
-)
-DS_INET_ADDRESS = 1
-DS_NETBIOS_ADDRESS = 2
-DS_PDC_FLAG = 0x00000001
-DS_GC_FLAG = 0x00000004
-DS_LDAP_FLAG = 0x00000008
-DS_DS_FLAG = 0x00000010
-DS_KDC_FLAG = 0x00000020
-DS_TIMESERV_FLAG = 0x00000040
-DS_CLOSEST_FLAG = 0x00000080
-DS_WRITABLE_FLAG = 0x00000100
-DS_GOOD_TIMESERV_FLAG = 0x00000200
-DS_NDNC_FLAG = 0x00000400
-DS_PING_FLAGS = 0x0000FFFF
-DS_DNS_CONTROLLER_FLAG = 0x20000000
-DS_DNS_DOMAIN_FLAG = 0x40000000
-DS_DNS_FOREST_FLAG = -2147483648
-DS_DOMAIN_IN_FOREST = 0x0001
-DS_DOMAIN_DIRECT_OUTBOUND = 0x0002
-DS_DOMAIN_TREE_ROOT = 0x0004
-DS_DOMAIN_PRIMARY = 0x0008
-DS_DOMAIN_NATIVE_MODE = 0x0010
-DS_DOMAIN_DIRECT_INBOUND = 0x0020
-DS_DOMAIN_VALID_FLAGS = (
-    DS_DOMAIN_IN_FOREST
-    | DS_DOMAIN_DIRECT_OUTBOUND
-    | DS_DOMAIN_TREE_ROOT
-    | DS_DOMAIN_PRIMARY
-    | DS_DOMAIN_NATIVE_MODE
-    | DS_DOMAIN_DIRECT_INBOUND
-)
-DS_GFTI_UPDATE_TDO = 0x1
-DS_GFTI_VALID_FLAGS = 0x1
-DS_ONLY_DO_SITE_NAME = 0x01
-DS_NOTIFY_AFTER_SITE_RECORDS = 0x02
-DS_OPEN_VALID_OPTION_FLAGS = DS_ONLY_DO_SITE_NAME | DS_NOTIFY_AFTER_SITE_RECORDS
-DS_OPEN_VALID_FLAGS = (
-    DS_FORCE_REDISCOVERY
-    | DS_ONLY_LDAP_NEEDED
-    | DS_KDC_REQUIRED
-    | DS_PDC_REQUIRED
-    | DS_GC_SERVER_REQUIRED
-    | DS_WRITABLE_REQUIRED
-)
-
-## from aclui.h
-# SI_OBJECT_INFO.dwFlags
-SI_EDIT_PERMS = 0x00000000
-SI_EDIT_OWNER = 0x00000001
-SI_EDIT_AUDITS = 0x00000002
-SI_CONTAINER = 0x00000004
-SI_READONLY = 0x00000008
-SI_ADVANCED = 0x00000010
-SI_RESET = 0x00000020
-SI_OWNER_READONLY = 0x00000040
-SI_EDIT_PROPERTIES = 0x00000080
-SI_OWNER_RECURSE = 0x00000100
-SI_NO_ACL_PROTECT = 0x00000200
-SI_NO_TREE_APPLY = 0x00000400
-SI_PAGE_TITLE = 0x00000800
-SI_SERVER_IS_DC = 0x00001000
-SI_RESET_DACL_TREE = 0x00004000
-SI_RESET_SACL_TREE = 0x00008000
-SI_OBJECT_GUID = 0x00010000
-SI_EDIT_EFFECTIVE = 0x00020000
-SI_RESET_DACL = 0x00040000
-SI_RESET_SACL = 0x00080000
-SI_RESET_OWNER = 0x00100000
-SI_NO_ADDITIONAL_PERMISSION = 0x00200000
-SI_MAY_WRITE = 0x10000000
-SI_EDIT_ALL = SI_EDIT_PERMS | SI_EDIT_OWNER | SI_EDIT_AUDITS
-SI_AUDITS_ELEVATION_REQUIRED = 0x02000000
-SI_VIEW_ONLY = 0x00400000
-SI_OWNER_ELEVATION_REQUIRED = 0x04000000
-SI_PERMS_ELEVATION_REQUIRED = 0x01000000
-
-# SI_ACCESS.dwFlags
-SI_ACCESS_SPECIFIC = 0x00010000
-SI_ACCESS_GENERAL = 0x00020000
-SI_ACCESS_CONTAINER = 0x00040000
-SI_ACCESS_PROPERTY = 0x00080000
-
-# SI_PAGE_TYPE enum
-SI_PAGE_PERM = 0
-SI_PAGE_ADVPERM = 1
-SI_PAGE_AUDIT = 2
-SI_PAGE_OWNER = 3
-SI_PAGE_EFFECTIVE = 4
-
-CFSTR_ACLUI_SID_INFO_LIST = "CFSTR_ACLUI_SID_INFO_LIST"
-PSPCB_SI_INITDIALOG = 1025  ## WM_USER+1
diff --git a/lib/win32/lib/pywin32_bootstrap.py b/lib/win32/lib/pywin32_bootstrap.py
deleted file mode 100644
index fbc4f7be..00000000
--- a/lib/win32/lib/pywin32_bootstrap.py
+++ /dev/null
@@ -1,29 +0,0 @@
-# Imported by pywin32.pth to bootstrap the pywin32 environment in "portable"
-# environments or any other case where the post-install script isn't run.
-#
-# In short, there's a directory installed by pywin32 named 'pywin32_system32'
-# with some important DLLs which need to be found by Python when some pywin32
-# modules are imported.
-# If Python has `os.add_dll_directory()`, we need to call it with this path.
-# Otherwise, we add this path to PATH.
-
-
-try:
-    import pywin32_system32
-except ImportError:  # Python ≥3.6: replace ImportError with ModuleNotFoundError
-    pass
-else:
-    import os
-
-    # We're guaranteed only that __path__: Iterable[str]
-    # https://docs.python.org/3/reference/import.html#__path__
-    for path in pywin32_system32.__path__:
-        if os.path.isdir(path):
-            if hasattr(os, "add_dll_directory"):
-                os.add_dll_directory(path)
-            # This is to ensure the pywin32 path is in the beginning to find the
-            # pywin32 DLLs first and prevent other PATH entries to shadow them
-            elif not os.environ["PATH"].startswith(path):
-                os.environ["PATH"] = os.environ["PATH"].replace(os.pathsep + path, "")
-                os.environ["PATH"] = path + os.pathsep + os.environ["PATH"]
-            break
diff --git a/lib/win32/lib/pywin32_testutil.py b/lib/win32/lib/pywin32_testutil.py
deleted file mode 100644
index 41566a8e..00000000
--- a/lib/win32/lib/pywin32_testutil.py
+++ /dev/null
@@ -1,327 +0,0 @@
-# Utilities for the pywin32 tests
-import gc
-import os
-import site
-import sys
-import unittest
-
-import winerror
-
-##
-## General purpose utilities for the test suite.
-##
-
-
-# The test suite has lots of string constants containing binary data, but
-# the strings are used in various "bytes" contexts.
-def str2bytes(sval):
-    if sys.version_info < (3, 0) and isinstance(sval, str):
-        sval = sval.decode("latin1")
-    return sval.encode("latin1")
-
-
-# Sometimes we want to pass a string that should explicitly be treated as
-# a memory blob.
-def str2memory(sval):
-    if sys.version_info < (3, 0):
-        return buffer(sval)
-    # py3k.
-    return memoryview(sval.encode("latin1"))
-
-
-# Sometimes we want to pass an object that exposes its memory
-def ob2memory(ob):
-    if sys.version_info < (3, 0):
-        return buffer(ob)
-    # py3k.
-    return memoryview(ob)
-
-
-##
-## unittest related stuff
-##
-
-
-# This is a specialized TestCase adaptor which wraps a real test.
-class LeakTestCase(unittest.TestCase):
-    """An 'adaptor' which takes another test.  In debug builds we execute the
-    test once to remove one-off side-effects, then capture the total
-    reference count, then execute the test a few times.  If the total
-    refcount at the end is greater than we first captured, we have a leak!
-
-    In release builds the test is executed just once, as normal.
-
-    Generally used automatically by the test runner - you can safely
-    ignore this.
-    """
-
-    def __init__(self, real_test):
-        unittest.TestCase.__init__(self)
-        self.real_test = real_test
-        self.num_test_cases = 1
-        self.num_leak_iters = 2  # seems to be enough!
-        if hasattr(sys, "gettotalrefcount"):
-            self.num_test_cases = self.num_test_cases + self.num_leak_iters
-
-    def countTestCases(self):
-        return self.num_test_cases
-
-    def __call__(self, result=None):
-        # For the COM suite's sake, always ensure we don't leak
-        # gateways/interfaces
-        from pythoncom import _GetGatewayCount, _GetInterfaceCount
-
-        gc.collect()
-        ni = _GetInterfaceCount()
-        ng = _GetGatewayCount()
-        self.real_test(result)
-        # Failed - no point checking anything else
-        if result.shouldStop or not result.wasSuccessful():
-            return
-        self._do_leak_tests(result)
-        gc.collect()
-        lost_i = _GetInterfaceCount() - ni
-        lost_g = _GetGatewayCount() - ng
-        if lost_i or lost_g:
-            msg = "%d interface objects and %d gateway objects leaked" % (
-                lost_i,
-                lost_g,
-            )
-            exc = AssertionError(msg)
-            result.addFailure(self.real_test, (exc.__class__, exc, None))
-
-    def runTest(self):
-        assert 0, "not used"
-
-    def _do_leak_tests(self, result=None):
-        try:
-            gtrc = sys.gettotalrefcount
-        except AttributeError:
-            return  # can't do leak tests in this build
-        # Assume already called once, to prime any caches etc
-        gc.collect()
-        trc = gtrc()
-        for i in range(self.num_leak_iters):
-            self.real_test(result)
-            if result.shouldStop:
-                break
-        del i  # created after we remembered the refcount!
-        # int division here means one or 2 stray references won't force
-        # failure, but one per loop
-        gc.collect()
-        lost = (gtrc() - trc) // self.num_leak_iters
-        if lost < 0:
-            msg = "LeakTest: %s appeared to gain %d references!!" % (
-                self.real_test,
-                -lost,
-            )
-            result.addFailure(self.real_test, (AssertionError, msg, None))
-        if lost > 0:
-            msg = "LeakTest: %s lost %d references" % (self.real_test, lost)
-            exc = AssertionError(msg)
-            result.addFailure(self.real_test, (exc.__class__, exc, None))
-
-
-class TestLoader(unittest.TestLoader):
-    def loadTestsFromTestCase(self, testCaseClass):
-        """Return a suite of all tests cases contained in testCaseClass"""
-        leak_tests = []
-        for name in self.getTestCaseNames(testCaseClass):
-            real_test = testCaseClass(name)
-            leak_test = self._getTestWrapper(real_test)
-            leak_tests.append(leak_test)
-        return self.suiteClass(leak_tests)
-
-    def fixupTestsForLeakTests(self, test):
-        if isinstance(test, unittest.TestSuite):
-            test._tests = [self.fixupTestsForLeakTests(t) for t in test._tests]
-            return test
-        else:
-            # just a normal test case.
-            return self._getTestWrapper(test)
-
-    def _getTestWrapper(self, test):
-        # one or 2 tests in the COM test suite set this...
-        no_leak_tests = getattr(test, "no_leak_tests", False)
-        if no_leak_tests:
-            print("Test says it doesn't want leak tests!")
-            return test
-        return LeakTestCase(test)
-
-    def loadTestsFromModule(self, mod):
-        if hasattr(mod, "suite"):
-            tests = mod.suite()
-        else:
-            tests = unittest.TestLoader.loadTestsFromModule(self, mod)
-        return self.fixupTestsForLeakTests(tests)
-
-    def loadTestsFromName(self, name, module=None):
-        test = unittest.TestLoader.loadTestsFromName(self, name, module)
-        if isinstance(test, unittest.TestSuite):
-            pass  # hmmm? print "Don't wrap suites yet!", test._tests
-        elif isinstance(test, unittest.TestCase):
-            test = self._getTestWrapper(test)
-        else:
-            print("XXX - what is", test)
-        return test
-
-
-# Lots of classes necessary to support one simple feature: we want a 3rd
-# test result state - "SKIPPED" - to indicate that the test wasn't able
-# to be executed for various reasons.  Inspired by bzr's tests, but it
-# has other concepts, such as "Expected Failure", which we don't bother
-# with.
-
-# win32 error codes that probably mean we need to be elevated (ie, if we
-# aren't elevated, we treat these error codes as 'skipped')
-non_admin_error_codes = [
-    winerror.ERROR_ACCESS_DENIED,
-    winerror.ERROR_PRIVILEGE_NOT_HELD,
-]
-
-_is_admin = None
-
-
-def check_is_admin():
-    global _is_admin
-    if _is_admin is None:
-        import pythoncom
-        from win32com.shell.shell import IsUserAnAdmin
-
-        try:
-            _is_admin = IsUserAnAdmin()
-        except pythoncom.com_error as exc:
-            if exc.hresult != winerror.E_NOTIMPL:
-                raise
-            # not impl on this platform - must be old - assume is admin
-            _is_admin = True
-    return _is_admin
-
-
-# Find a test "fixture" (eg, binary test file) expected to be very close to
-# the test being run.
-# If the tests are being run from the "installed" version, then these fixtures
-# probably don't exist - the test is "skipped".
-# But it's fatal if we think we might be running from a pywin32 source tree.
-def find_test_fixture(basename, extra_dir="."):
-    # look for the test file in various places
-    candidates = [
-        os.path.dirname(sys.argv[0]),
-        extra_dir,
-        ".",
-    ]
-    for candidate in candidates:
-        fname = os.path.join(candidate, basename)
-        if os.path.isfile(fname):
-            return fname
-    else:
-        # Can't find it - see if this is expected or not.
-        # This module is typically always in the installed dir, so use argv[0]
-        this_file = os.path.normcase(os.path.abspath(sys.argv[0]))
-        dirs_to_check = site.getsitepackages()[:]
-        if site.USER_SITE:
-            dirs_to_check.append(site.USER_SITE)
-
-        for d in dirs_to_check:
-            d = os.path.normcase(d)
-            if os.path.commonprefix([this_file, d]) == d:
-                # looks like we are in an installed Python, so skip the text.
-                raise TestSkipped(f"Can't find test fixture '{fname}'")
-        # Looks like we are running from source, so this is fatal.
-        raise RuntimeError(f"Can't find test fixture '{fname}'")
-
-
-# If this exception is raised by a test, the test is reported as a 'skip'
-class TestSkipped(Exception):
-    pass
-
-
-# This appears to have been "upgraded" to non-private in 3.11
-try:
-    TextTestResult = unittest._TextTestResult
-except AttributeError:
-    TextTestResult = unittest.TextTestResult
-
-
-# The 'TestResult' subclass that records the failures and has the special
-# handling for the TestSkipped exception.
-class TestResult(TextTestResult):
-    def __init__(self, *args, **kw):
-        super(TestResult, self).__init__(*args, **kw)
-        self.skips = {}  # count of skips for each reason.
-
-    def addError(self, test, err):
-        """Called when an error has occurred. 'err' is a tuple of values as
-        returned by sys.exc_info().
-        """
-        # translate a couple of 'well-known' exceptions into 'skipped'
-        import pywintypes
-
-        exc_val = err[1]
-        # translate ERROR_ACCESS_DENIED for non-admin users to be skipped.
-        # (access denied errors for an admin user aren't expected.)
-        if (
-            isinstance(exc_val, pywintypes.error)
-            and exc_val.winerror in non_admin_error_codes
-            and not check_is_admin()
-        ):
-            exc_val = TestSkipped(exc_val)
-        # and COM errors due to objects not being registered (the com test
-        # suite will attempt to catch this and handle it itself if the user
-        # is admin)
-        elif isinstance(exc_val, pywintypes.com_error) and exc_val.hresult in [
-            winerror.CO_E_CLASSSTRING,
-            winerror.REGDB_E_CLASSNOTREG,
-            winerror.TYPE_E_LIBNOTREGISTERED,
-        ]:
-            exc_val = TestSkipped(exc_val)
-        # NotImplemented generally means the platform doesn't support the
-        # functionality.
-        elif isinstance(exc_val, NotImplementedError):
-            exc_val = TestSkipped(NotImplementedError)
-
-        if isinstance(exc_val, TestSkipped):
-            reason = exc_val.args[0]
-            # if the reason itself is another exception, get its args.
-            try:
-                reason = tuple(reason.args)
-            except (AttributeError, TypeError):
-                pass
-            self.skips.setdefault(reason, 0)
-            self.skips[reason] += 1
-            if self.showAll:
-                self.stream.writeln("SKIP (%s)" % (reason,))
-            elif self.dots:
-                self.stream.write("S")
-                self.stream.flush()
-            return
-        super(TestResult, self).addError(test, err)
-
-    def printErrors(self):
-        super(TestResult, self).printErrors()
-        for reason, num_skipped in self.skips.items():
-            self.stream.writeln("SKIPPED: %d tests - %s" % (num_skipped, reason))
-
-
-# TestRunner subclass necessary just to get our TestResult hooked up.
-class TestRunner(unittest.TextTestRunner):
-    def _makeResult(self):
-        return TestResult(self.stream, self.descriptions, self.verbosity)
-
-
-# TestProgream subclass necessary just to get our TestRunner hooked up,
-# which is necessary to get our TestResult hooked up *sob*
-class TestProgram(unittest.TestProgram):
-    def runTests(self):
-        # clobber existing runner - *sob* - it shouldn't be this hard
-        self.testRunner = TestRunner(verbosity=self.verbosity)
-        unittest.TestProgram.runTests(self)
-
-
-# A convenient entry-point - if used, 'SKIPPED' exceptions will be supressed.
-def testmain(*args, **kw):
-    new_kw = kw.copy()
-    if "testLoader" not in new_kw:
-        new_kw["testLoader"] = TestLoader()
-    program_class = new_kw.get("testProgram", TestProgram)
-    program_class(*args, **new_kw)
diff --git a/lib/win32/lib/pywintypes.py b/lib/win32/lib/pywintypes.py
deleted file mode 100644
index 115c4f82..00000000
--- a/lib/win32/lib/pywintypes.py
+++ /dev/null
@@ -1,126 +0,0 @@
-# Magic utility that "redirects" to pywintypesxx.dll
-import importlib.machinery
-import importlib.util
-import os
-import sys
-
-
-def __import_pywin32_system_module__(modname, globs):
-    # This has been through a number of iterations.  The problem: how to
-    # locate pywintypesXX.dll when it may be in a number of places, and how
-    # to avoid ever loading it twice.  This problem is compounded by the
-    # fact that the "right" way to do this requires win32api, but this
-    # itself requires pywintypesXX.
-    # And the killer problem is that someone may have done 'import win32api'
-    # before this code is called.  In that case Windows will have already
-    # loaded pywintypesXX as part of loading win32api - but by the time
-    # we get here, we may locate a different one.  This appears to work, but
-    # then starts raising bizarre TypeErrors complaining that something
-    # is not a pywintypes type when it clearly is!
-
-    # So in what we hope is the last major iteration of this, we now
-    # rely on a _win32sysloader module, implemented in C but not relying
-    # on pywintypesXX.dll.  It then can check if the DLL we are looking for
-    # lib is already loaded.
-    # See if this is a debug build.
-    suffix = "_d" if "_d.pyd" in importlib.machinery.EXTENSION_SUFFIXES else ""
-    filename = "%s%d%d%s.dll" % (
-        modname,
-        sys.version_info[0],
-        sys.version_info[1],
-        suffix,
-    )
-    if hasattr(sys, "frozen"):
-        # If we are running from a frozen program (py2exe, McMillan, freeze)
-        # then we try and load the DLL from our sys.path
-        # XXX - This path may also benefit from _win32sysloader?  However,
-        # MarkH has never seen the DLL load problem with py2exe programs...
-        for look in sys.path:
-            # If the sys.path entry is a (presumably) .zip file, use the
-            # directory
-            if os.path.isfile(look):
-                look = os.path.dirname(look)
-            found = os.path.join(look, filename)
-            if os.path.isfile(found):
-                break
-        else:
-            raise ImportError(
-                "Module '%s' isn't in frozen sys.path %s" % (modname, sys.path)
-            )
-    else:
-        # First see if it already in our process - if so, we must use that.
-        import _win32sysloader
-
-        found = _win32sysloader.GetModuleFilename(filename)
-        if found is None:
-            # We ask Windows to load it next.  This is in an attempt to
-            # get the exact same module loaded should pywintypes be imported
-            # first (which is how we are here) or if, eg, win32api was imported
-            # first thereby implicitly loading the DLL.
-
-            # Sadly though, it doesn't quite work - if pywintypesxx.dll
-            # is in system32 *and* the executable's directory, on XP SP2, an
-            # import of win32api will cause Windows to load pywintypes
-            # from system32, where LoadLibrary for that name will
-            # load the one in the exe's dir.
-            # That shouldn't really matter though, so long as we only ever
-            # get one loaded.
-            found = _win32sysloader.LoadModule(filename)
-        if found is None:
-            # Windows can't find it - which although isn't relevent here,
-            # means that we *must* be the first win32 import, as an attempt
-            # to import win32api etc would fail when Windows attempts to
-            # locate the DLL.
-            # This is most likely to happen for "non-admin" installs, where
-            # we can't put the files anywhere else on the global path.
-
-            # If there is a version in our Python directory, use that
-            if os.path.isfile(os.path.join(sys.prefix, filename)):
-                found = os.path.join(sys.prefix, filename)
-        if found is None:
-            # Not in the Python directory?  Maybe we were installed via
-            # easy_install...
-            if os.path.isfile(os.path.join(os.path.dirname(__file__), filename)):
-                found = os.path.join(os.path.dirname(__file__), filename)
-
-        # There are 2 site-packages directories - one "global" and one "user".
-        # We could be in either, or both (but with different versions!). Factors include
-        # virtualenvs, post-install script being run or not, `setup.py install` flags, etc.
-
-        # In a worst-case, it means, say 'python -c "import win32api"'
-        # will not work but 'python -c "import pywintypes, win32api"' will,
-        # but it's better than nothing.
-
-        # We use the same logic as pywin32_bootstrap to find potential location for the dll
-        # Simply import pywin32_system32 and look in the paths in pywin32_system32.__path__
-
-        if found is None:
-            import pywin32_system32
-
-            for path in pywin32_system32.__path__:
-                maybe = os.path.join(path, filename)
-                if os.path.isfile(maybe):
-                    found = maybe
-                    break
-
-        if found is None:
-            # give up in disgust.
-            raise ImportError("No system module '%s' (%s)" % (modname, filename))
-    # After importing the module, sys.modules is updated to the DLL we just
-    # loaded - which isn't what we want. So we update sys.modules to refer to
-    # this module, and update our globals from it.
-    old_mod = sys.modules[modname]
-    # Load the DLL.
-    loader = importlib.machinery.ExtensionFileLoader(modname, found)
-    spec = importlib.machinery.ModuleSpec(name=modname, loader=loader, origin=found)
-    mod = importlib.util.module_from_spec(spec)
-    spec.loader.exec_module(mod)
-
-    # Check the sys.modules[] behaviour we describe above is true...
-    assert sys.modules[modname] is mod
-    # as above - re-reset to the *old* module object then update globs.
-    sys.modules[modname] = old_mod
-    globs.update(mod.__dict__)
-
-
-__import_pywin32_system_module__("pywintypes", globals())
diff --git a/lib/win32/lib/rasutil.py b/lib/win32/lib/rasutil.py
deleted file mode 100644
index fb71b4fc..00000000
--- a/lib/win32/lib/rasutil.py
+++ /dev/null
@@ -1,40 +0,0 @@
-import win32ras
-
-stateStrings = {
-    win32ras.RASCS_OpenPort: "OpenPort",
-    win32ras.RASCS_PortOpened: "PortOpened",
-    win32ras.RASCS_ConnectDevice: "ConnectDevice",
-    win32ras.RASCS_DeviceConnected: "DeviceConnected",
-    win32ras.RASCS_AllDevicesConnected: "AllDevicesConnected",
-    win32ras.RASCS_Authenticate: "Authenticate",
-    win32ras.RASCS_AuthNotify: "AuthNotify",
-    win32ras.RASCS_AuthRetry: "AuthRetry",
-    win32ras.RASCS_AuthCallback: "AuthCallback",
-    win32ras.RASCS_AuthChangePassword: "AuthChangePassword",
-    win32ras.RASCS_AuthProject: "AuthProject",
-    win32ras.RASCS_AuthLinkSpeed: "AuthLinkSpeed",
-    win32ras.RASCS_AuthAck: "AuthAck",
-    win32ras.RASCS_ReAuthenticate: "ReAuthenticate",
-    win32ras.RASCS_Authenticated: "Authenticated",
-    win32ras.RASCS_PrepareForCallback: "PrepareForCallback",
-    win32ras.RASCS_WaitForModemReset: "WaitForModemReset",
-    win32ras.RASCS_WaitForCallback: "WaitForCallback",
-    win32ras.RASCS_Projected: "Projected",
-    win32ras.RASCS_StartAuthentication: "StartAuthentication",
-    win32ras.RASCS_CallbackComplete: "CallbackComplete",
-    win32ras.RASCS_LogonNetwork: "LogonNetwork",
-    win32ras.RASCS_Interactive: "Interactive",
-    win32ras.RASCS_RetryAuthentication: "RetryAuthentication",
-    win32ras.RASCS_CallbackSetByCaller: "CallbackSetByCaller",
-    win32ras.RASCS_PasswordExpired: "PasswordExpired",
-    win32ras.RASCS_Connected: "Connected",
-    win32ras.RASCS_Disconnected: "Disconnected",
-}
-
-
-def TestCallback(hras, msg, state, error, exterror):
-    print("Callback called with ", hras, msg, stateStrings[state], error, exterror)
-
-
-def test(rasName="_ Divert Off"):
-    return win32ras.Dial(None, None, (rasName,), TestCallback)
diff --git a/lib/win32/lib/regcheck.py b/lib/win32/lib/regcheck.py
deleted file mode 100644
index c07b77b7..00000000
--- a/lib/win32/lib/regcheck.py
+++ /dev/null
@@ -1,162 +0,0 @@
-# This module is very old and useless in this day and age!  It will be
-# removed in a few years (ie, 2009 or so...)
-
-import warnings
-
-warnings.warn(
-    "The regcheck module has been pending deprecation since build 210",
-    category=PendingDeprecationWarning,
-)
-
-import os
-import sys
-
-import regutil
-import win32api
-import win32con
-
-
-def CheckRegisteredExe(exename):
-    try:
-        os.stat(
-            win32api.RegQueryValue(
-                regutil.GetRootKey(), regutil.GetAppPathsKey() + "\\" + exename
-            )
-        )
-    # 	except SystemError:
-    except (os.error, win32api.error):
-        print("Registration of %s - Not registered correctly" % exename)
-
-
-def CheckPathString(pathString):
-    for path in pathString.split(";"):
-        if not os.path.isdir(path):
-            return "'%s' is not a valid directory!" % path
-    return None
-
-
-def CheckPythonPaths(verbose):
-    if verbose:
-        print("Python Paths:")
-    # Check the core path
-    if verbose:
-        print("\tCore Path:", end=" ")
-    try:
-        appPath = win32api.RegQueryValue(
-            regutil.GetRootKey(), regutil.BuildDefaultPythonKey() + "\\PythonPath"
-        )
-    except win32api.error as exc:
-        print("** does not exist - ", exc.strerror)
-    problem = CheckPathString(appPath)
-    if problem:
-        print(problem)
-    else:
-        if verbose:
-            print(appPath)
-
-    key = win32api.RegOpenKey(
-        regutil.GetRootKey(),
-        regutil.BuildDefaultPythonKey() + "\\PythonPath",
-        0,
-        win32con.KEY_READ,
-    )
-    try:
-        keyNo = 0
-        while 1:
-            try:
-                appName = win32api.RegEnumKey(key, keyNo)
-                appPath = win32api.RegQueryValue(key, appName)
-                if verbose:
-                    print("\t" + appName + ":", end=" ")
-                if appPath:
-                    problem = CheckPathString(appPath)
-                    if problem:
-                        print(problem)
-                    else:
-                        if verbose:
-                            print(appPath)
-                else:
-                    if verbose:
-                        print("(empty)")
-                keyNo = keyNo + 1
-            except win32api.error:
-                break
-    finally:
-        win32api.RegCloseKey(key)
-
-
-def CheckHelpFiles(verbose):
-    if verbose:
-        print("Help Files:")
-    try:
-        key = win32api.RegOpenKey(
-            regutil.GetRootKey(),
-            regutil.BuildDefaultPythonKey() + "\\Help",
-            0,
-            win32con.KEY_READ,
-        )
-    except win32api.error as exc:
-        import winerror
-
-        if exc.winerror != winerror.ERROR_FILE_NOT_FOUND:
-            raise
-        return
-
-    try:
-        keyNo = 0
-        while 1:
-            try:
-                helpDesc = win32api.RegEnumKey(key, keyNo)
-                helpFile = win32api.RegQueryValue(key, helpDesc)
-                if verbose:
-                    print("\t" + helpDesc + ":", end=" ")
-                # query the os section.
-                try:
-                    os.stat(helpFile)
-                    if verbose:
-                        print(helpFile)
-                except os.error:
-                    print("** Help file %s does not exist" % helpFile)
-                keyNo = keyNo + 1
-            except win32api.error as exc:
-                import winerror
-
-                if exc.winerror != winerror.ERROR_NO_MORE_ITEMS:
-                    raise
-                break
-    finally:
-        win32api.RegCloseKey(key)
-
-
-def CheckRegisteredModules(verbose):
-    # Check out all registered modules.
-    k = regutil.BuildDefaultPythonKey() + "\\Modules"
-    try:
-        keyhandle = win32api.RegOpenKey(regutil.GetRootKey(), k)
-        print("WARNING: 'Modules' registry entry is deprectated and evil!")
-    except win32api.error as exc:
-        import winerror
-
-        if exc.winerror != winerror.ERROR_FILE_NOT_FOUND:
-            raise
-        return
-
-
-def CheckRegistry(verbose=0):
-    # check the registered modules
-    if verbose and "pythonpath" in os.environ:
-        print("Warning - PythonPath in environment - please check it!")
-    # Check out all paths on sys.path
-
-    CheckPythonPaths(verbose)
-    CheckHelpFiles(verbose)
-    CheckRegisteredModules(verbose)
-    CheckRegisteredExe("Python.exe")
-
-
-if __name__ == "__main__":
-    if len(sys.argv) > 1 and sys.argv[1] == "-q":
-        verbose = 0
-    else:
-        verbose = 1
-    CheckRegistry(verbose)
diff --git a/lib/win32/lib/regutil.py b/lib/win32/lib/regutil.py
deleted file mode 100644
index 1abdd551..00000000
--- a/lib/win32/lib/regutil.py
+++ /dev/null
@@ -1,397 +0,0 @@
-# Some registry helpers.
-import os
-import sys
-
-import win32api
-import win32con
-
-error = "Registry utility error"
-
-# A .py file has a CLSID associated with it (why? - dunno!)
-CLSIDPyFile = "{b51df050-06ae-11cf-ad3b-524153480001}"
-
-RegistryIDPyFile = "Python.File"  # The registry "file type" of a .py file
-RegistryIDPycFile = "Python.CompiledFile"  # The registry "file type" of a .pyc file
-
-
-def BuildDefaultPythonKey():
-    """Builds a string containing the path to the current registry key.
-
-    The Python registry key contains the Python version.  This function
-    uses the version of the DLL used by the current process to get the
-    registry key currently in use.
-    """
-    return "Software\\Python\\PythonCore\\" + sys.winver
-
-
-def GetRootKey():
-    """Retrieves the Registry root in use by Python."""
-    keyname = BuildDefaultPythonKey()
-    try:
-        k = win32api.RegOpenKey(win32con.HKEY_CURRENT_USER, keyname)
-        k.close()
-        return win32con.HKEY_CURRENT_USER
-    except win32api.error:
-        return win32con.HKEY_LOCAL_MACHINE
-
-
-def GetRegistryDefaultValue(subkey, rootkey=None):
-    """A helper to return the default value for a key in the registry."""
-    if rootkey is None:
-        rootkey = GetRootKey()
-    return win32api.RegQueryValue(rootkey, subkey)
-
-
-def SetRegistryDefaultValue(subKey, value, rootkey=None):
-    """A helper to set the default value for a key in the registry"""
-    if rootkey is None:
-        rootkey = GetRootKey()
-    if type(value) == str:
-        typeId = win32con.REG_SZ
-    elif type(value) == int:
-        typeId = win32con.REG_DWORD
-    else:
-        raise TypeError("Value must be string or integer - was passed " + repr(value))
-
-    win32api.RegSetValue(rootkey, subKey, typeId, value)
-
-
-def GetAppPathsKey():
-    return "Software\\Microsoft\\Windows\\CurrentVersion\\App Paths"
-
-
-def RegisterPythonExe(exeFullPath, exeAlias=None, exeAppPath=None):
-    """Register a .exe file that uses Python.
-
-    Registers the .exe with the OS.  This allows the specified .exe to
-    be run from the command-line or start button without using the full path,
-    and also to setup application specific path (ie, os.environ['PATH']).
-
-    Currently the exeAppPath is not supported, so this function is general
-    purpose, and not specific to Python at all.  Later, exeAppPath may provide
-    a reasonable default that is used.
-
-    exeFullPath -- The full path to the .exe
-    exeAlias = None -- An alias for the exe - if none, the base portion
-              of the filename is used.
-    exeAppPath -- Not supported.
-    """
-    # Note - Dont work on win32s (but we dont care anymore!)
-    if exeAppPath:
-        raise error("Do not support exeAppPath argument currently")
-    if exeAlias is None:
-        exeAlias = os.path.basename(exeFullPath)
-    win32api.RegSetValue(
-        GetRootKey(), GetAppPathsKey() + "\\" + exeAlias, win32con.REG_SZ, exeFullPath
-    )
-
-
-def GetRegisteredExe(exeAlias):
-    """Get a registered .exe"""
-    return win32api.RegQueryValue(GetRootKey(), GetAppPathsKey() + "\\" + exeAlias)
-
-
-def UnregisterPythonExe(exeAlias):
-    """Unregister a .exe file that uses Python."""
-    try:
-        win32api.RegDeleteKey(GetRootKey(), GetAppPathsKey() + "\\" + exeAlias)
-    except win32api.error as exc:
-        import winerror
-
-        if exc.winerror != winerror.ERROR_FILE_NOT_FOUND:
-            raise
-        return
-
-
-def RegisterNamedPath(name, path):
-    """Register a named path - ie, a named PythonPath entry."""
-    keyStr = BuildDefaultPythonKey() + "\\PythonPath"
-    if name:
-        keyStr = keyStr + "\\" + name
-    win32api.RegSetValue(GetRootKey(), keyStr, win32con.REG_SZ, path)
-
-
-def UnregisterNamedPath(name):
-    """Unregister a named path - ie, a named PythonPath entry."""
-    keyStr = BuildDefaultPythonKey() + "\\PythonPath\\" + name
-    try:
-        win32api.RegDeleteKey(GetRootKey(), keyStr)
-    except win32api.error as exc:
-        import winerror
-
-        if exc.winerror != winerror.ERROR_FILE_NOT_FOUND:
-            raise
-        return
-
-
-def GetRegisteredNamedPath(name):
-    """Get a registered named path, or None if it doesnt exist."""
-    keyStr = BuildDefaultPythonKey() + "\\PythonPath"
-    if name:
-        keyStr = keyStr + "\\" + name
-    try:
-        return win32api.RegQueryValue(GetRootKey(), keyStr)
-    except win32api.error as exc:
-        import winerror
-
-        if exc.winerror != winerror.ERROR_FILE_NOT_FOUND:
-            raise
-        return None
-
-
-def RegisterModule(modName, modPath):
-    """Register an explicit module in the registry.  This forces the Python import
-    mechanism to locate this module directly, without a sys.path search.  Thus
-    a registered module need not appear in sys.path at all.
-
-    modName -- The name of the module, as used by import.
-    modPath -- The full path and file name of the module.
-    """
-    try:
-        import os
-
-        os.stat(modPath)
-    except os.error:
-        print("Warning: Registering non-existant module %s" % modPath)
-    win32api.RegSetValue(
-        GetRootKey(),
-        BuildDefaultPythonKey() + "\\Modules\\%s" % modName,
-        win32con.REG_SZ,
-        modPath,
-    )
-
-
-def UnregisterModule(modName):
-    """Unregister an explicit module in the registry.
-
-    modName -- The name of the module, as used by import.
-    """
-    try:
-        win32api.RegDeleteKey(
-            GetRootKey(), BuildDefaultPythonKey() + "\\Modules\\%s" % modName
-        )
-    except win32api.error as exc:
-        import winerror
-
-        if exc.winerror != winerror.ERROR_FILE_NOT_FOUND:
-            raise
-
-
-def GetRegisteredHelpFile(helpDesc):
-    """Given a description, return the registered entry."""
-    try:
-        return GetRegistryDefaultValue(BuildDefaultPythonKey() + "\\Help\\" + helpDesc)
-    except win32api.error:
-        try:
-            return GetRegistryDefaultValue(
-                BuildDefaultPythonKey() + "\\Help\\" + helpDesc,
-                win32con.HKEY_CURRENT_USER,
-            )
-        except win32api.error:
-            pass
-    return None
-
-
-def RegisterHelpFile(helpFile, helpPath, helpDesc=None, bCheckFile=1):
-    """Register a help file in the registry.
-
-      Note that this used to support writing to the Windows Help
-      key, however this is no longer done, as it seems to be incompatible.
-
-    helpFile -- the base name of the help file.
-    helpPath -- the path to the help file
-    helpDesc -- A description for the help file.  If None, the helpFile param is used.
-    bCheckFile -- A flag indicating if the file existence should be checked.
-    """
-    if helpDesc is None:
-        helpDesc = helpFile
-    fullHelpFile = os.path.join(helpPath, helpFile)
-    try:
-        if bCheckFile:
-            os.stat(fullHelpFile)
-    except os.error:
-        raise ValueError("Help file does not exist")
-    # Now register with Python itself.
-    win32api.RegSetValue(
-        GetRootKey(),
-        BuildDefaultPythonKey() + "\\Help\\%s" % helpDesc,
-        win32con.REG_SZ,
-        fullHelpFile,
-    )
-
-
-def UnregisterHelpFile(helpFile, helpDesc=None):
-    """Unregister a help file in the registry.
-
-    helpFile -- the base name of the help file.
-    helpDesc -- A description for the help file.  If None, the helpFile param is used.
-    """
-    key = win32api.RegOpenKey(
-        win32con.HKEY_LOCAL_MACHINE,
-        "Software\\Microsoft\\Windows\\Help",
-        0,
-        win32con.KEY_ALL_ACCESS,
-    )
-    try:
-        try:
-            win32api.RegDeleteValue(key, helpFile)
-        except win32api.error as exc:
-            import winerror
-
-            if exc.winerror != winerror.ERROR_FILE_NOT_FOUND:
-                raise
-    finally:
-        win32api.RegCloseKey(key)
-
-    # Now de-register with Python itself.
-    if helpDesc is None:
-        helpDesc = helpFile
-    try:
-        win32api.RegDeleteKey(
-            GetRootKey(), BuildDefaultPythonKey() + "\\Help\\%s" % helpDesc
-        )
-    except win32api.error as exc:
-        import winerror
-
-        if exc.winerror != winerror.ERROR_FILE_NOT_FOUND:
-            raise
-
-
-def RegisterCoreDLL(coredllName=None):
-    """Registers the core DLL in the registry.
-
-    If no params are passed, the name of the Python DLL used in
-    the current process is used and registered.
-    """
-    if coredllName is None:
-        coredllName = win32api.GetModuleFileName(sys.dllhandle)
-        # must exist!
-    else:
-        try:
-            os.stat(coredllName)
-        except os.error:
-            print("Warning: Registering non-existant core DLL %s" % coredllName)
-
-    hKey = win32api.RegCreateKey(GetRootKey(), BuildDefaultPythonKey())
-    try:
-        win32api.RegSetValue(hKey, "Dll", win32con.REG_SZ, coredllName)
-    finally:
-        win32api.RegCloseKey(hKey)
-    # Lastly, setup the current version to point to me.
-    win32api.RegSetValue(
-        GetRootKey(),
-        "Software\\Python\\PythonCore\\CurrentVersion",
-        win32con.REG_SZ,
-        sys.winver,
-    )
-
-
-def RegisterFileExtensions(defPyIcon, defPycIcon, runCommand):
-    """Register the core Python file extensions.
-
-    defPyIcon -- The default icon to use for .py files, in 'fname,offset' format.
-    defPycIcon -- The default icon to use for .pyc files, in 'fname,offset' format.
-    runCommand -- The command line to use for running .py files
-    """
-    # Register the file extensions.
-    pythonFileId = RegistryIDPyFile
-    win32api.RegSetValue(
-        win32con.HKEY_CLASSES_ROOT, ".py", win32con.REG_SZ, pythonFileId
-    )
-    win32api.RegSetValue(
-        win32con.HKEY_CLASSES_ROOT, pythonFileId, win32con.REG_SZ, "Python File"
-    )
-    win32api.RegSetValue(
-        win32con.HKEY_CLASSES_ROOT,
-        "%s\\CLSID" % pythonFileId,
-        win32con.REG_SZ,
-        CLSIDPyFile,
-    )
-    win32api.RegSetValue(
-        win32con.HKEY_CLASSES_ROOT,
-        "%s\\DefaultIcon" % pythonFileId,
-        win32con.REG_SZ,
-        defPyIcon,
-    )
-    base = "%s\\Shell" % RegistryIDPyFile
-    win32api.RegSetValue(
-        win32con.HKEY_CLASSES_ROOT, base + "\\Open", win32con.REG_SZ, "Run"
-    )
-    win32api.RegSetValue(
-        win32con.HKEY_CLASSES_ROOT,
-        base + "\\Open\\Command",
-        win32con.REG_SZ,
-        runCommand,
-    )
-
-    # Register the .PYC.
-    pythonFileId = RegistryIDPycFile
-    win32api.RegSetValue(
-        win32con.HKEY_CLASSES_ROOT, ".pyc", win32con.REG_SZ, pythonFileId
-    )
-    win32api.RegSetValue(
-        win32con.HKEY_CLASSES_ROOT,
-        pythonFileId,
-        win32con.REG_SZ,
-        "Compiled Python File",
-    )
-    win32api.RegSetValue(
-        win32con.HKEY_CLASSES_ROOT,
-        "%s\\DefaultIcon" % pythonFileId,
-        win32con.REG_SZ,
-        defPycIcon,
-    )
-    base = "%s\\Shell" % pythonFileId
-    win32api.RegSetValue(
-        win32con.HKEY_CLASSES_ROOT, base + "\\Open", win32con.REG_SZ, "Run"
-    )
-    win32api.RegSetValue(
-        win32con.HKEY_CLASSES_ROOT,
-        base + "\\Open\\Command",
-        win32con.REG_SZ,
-        runCommand,
-    )
-
-
-def RegisterShellCommand(shellCommand, exeCommand, shellUserCommand=None):
-    # Last param for "Open" - for a .py file to be executed by the command line
-    # or shell execute (eg, just entering "foo.py"), the Command must be "Open",
-    # but you may associate a different name for the right-click menu.
-    # In our case, normally we have "Open=Run"
-    base = "%s\\Shell" % RegistryIDPyFile
-    if shellUserCommand:
-        win32api.RegSetValue(
-            win32con.HKEY_CLASSES_ROOT,
-            base + "\\%s" % (shellCommand),
-            win32con.REG_SZ,
-            shellUserCommand,
-        )
-
-    win32api.RegSetValue(
-        win32con.HKEY_CLASSES_ROOT,
-        base + "\\%s\\Command" % (shellCommand),
-        win32con.REG_SZ,
-        exeCommand,
-    )
-
-
-def RegisterDDECommand(shellCommand, ddeApp, ddeTopic, ddeCommand):
-    base = "%s\\Shell" % RegistryIDPyFile
-    win32api.RegSetValue(
-        win32con.HKEY_CLASSES_ROOT,
-        base + "\\%s\\ddeexec" % (shellCommand),
-        win32con.REG_SZ,
-        ddeCommand,
-    )
-    win32api.RegSetValue(
-        win32con.HKEY_CLASSES_ROOT,
-        base + "\\%s\\ddeexec\\Application" % (shellCommand),
-        win32con.REG_SZ,
-        ddeApp,
-    )
-    win32api.RegSetValue(
-        win32con.HKEY_CLASSES_ROOT,
-        base + "\\%s\\ddeexec\\Topic" % (shellCommand),
-        win32con.REG_SZ,
-        ddeTopic,
-    )
diff --git a/lib/win32/lib/sspi.py b/lib/win32/lib/sspi.py
deleted file mode 100644
index 22c0e4a0..00000000
--- a/lib/win32/lib/sspi.py
+++ /dev/null
@@ -1,412 +0,0 @@
-"""
-Helper classes for SSPI authentication via the win32security module.
-
-SSPI authentication involves a token-exchange "dance", the exact details
-of which depends on the authentication provider used.  There are also
-a number of complex flags and constants that need to be used - in most
-cases, there are reasonable defaults.
-
-These classes attempt to hide these details from you until you really need
-to know.  They are not designed to handle all cases, just the common ones.
-If you need finer control than offered here, just use the win32security
-functions directly.
-"""
-# Based on Roger Upole's sspi demos.
-# $Id$
-import sspicon
-import win32security
-
-error = win32security.error
-
-
-class _BaseAuth(object):
-    def __init__(self):
-        self.reset()
-
-    def reset(self):
-        """Reset everything to an unauthorized state"""
-        self.ctxt = None
-        self.authenticated = False
-        self.initiator_name = None
-        self.service_name = None
-
-        # The next seq_num for an encrypt/sign operation
-        self.next_seq_num = 0
-
-    def _get_next_seq_num(self):
-        """Get the next sequence number for a transmission.  Default
-        implementation is to increment a counter
-        """
-        ret = self.next_seq_num
-        self.next_seq_num = self.next_seq_num + 1
-        return ret
-
-    def encrypt(self, data):
-        """Encrypt a string, returning a tuple of (encrypted_data, trailer).
-        These can be passed to decrypt to get back the original string.
-        """
-        pkg_size_info = self.ctxt.QueryContextAttributes(sspicon.SECPKG_ATTR_SIZES)
-        trailersize = pkg_size_info["SecurityTrailer"]
-
-        encbuf = win32security.PySecBufferDescType()
-        encbuf.append(win32security.PySecBufferType(len(data), sspicon.SECBUFFER_DATA))
-        encbuf.append(
-            win32security.PySecBufferType(trailersize, sspicon.SECBUFFER_TOKEN)
-        )
-        encbuf[0].Buffer = data
-        self.ctxt.EncryptMessage(0, encbuf, self._get_next_seq_num())
-        return encbuf[0].Buffer, encbuf[1].Buffer
-
-    def decrypt(self, data, trailer):
-        """Decrypt a previously encrypted string, returning the orignal data"""
-        encbuf = win32security.PySecBufferDescType()
-        encbuf.append(win32security.PySecBufferType(len(data), sspicon.SECBUFFER_DATA))
-        encbuf.append(
-            win32security.PySecBufferType(len(trailer), sspicon.SECBUFFER_TOKEN)
-        )
-        encbuf[0].Buffer = data
-        encbuf[1].Buffer = trailer
-        self.ctxt.DecryptMessage(encbuf, self._get_next_seq_num())
-        return encbuf[0].Buffer
-
-    def sign(self, data):
-        """sign a string suitable for transmission, returning the signature.
-        Passing the data and signature to verify will determine if the data
-        is unchanged.
-        """
-        pkg_size_info = self.ctxt.QueryContextAttributes(sspicon.SECPKG_ATTR_SIZES)
-        sigsize = pkg_size_info["MaxSignature"]
-        sigbuf = win32security.PySecBufferDescType()
-        sigbuf.append(win32security.PySecBufferType(len(data), sspicon.SECBUFFER_DATA))
-        sigbuf.append(win32security.PySecBufferType(sigsize, sspicon.SECBUFFER_TOKEN))
-        sigbuf[0].Buffer = data
-
-        self.ctxt.MakeSignature(0, sigbuf, self._get_next_seq_num())
-        return sigbuf[1].Buffer
-
-    def verify(self, data, sig):
-        """Verifies data and its signature.  If verification fails, an sspi.error
-        will be raised.
-        """
-        sigbuf = win32security.PySecBufferDescType()
-        sigbuf.append(win32security.PySecBufferType(len(data), sspicon.SECBUFFER_DATA))
-        sigbuf.append(win32security.PySecBufferType(len(sig), sspicon.SECBUFFER_TOKEN))
-
-        sigbuf[0].Buffer = data
-        sigbuf[1].Buffer = sig
-        self.ctxt.VerifySignature(sigbuf, self._get_next_seq_num())
-
-    def unwrap(self, token):
-        """
-        GSSAPI's unwrap with SSPI.
-        https://docs.microsoft.com/en-us/windows/win32/secauthn/sspi-kerberos-interoperability-with-gssapi
-
-        Usable mainly with Kerberos SSPI package, but this is not enforced.
-
-        Return the clear text, and a boolean that is True if the token was encrypted.
-        """
-        buffer = win32security.PySecBufferDescType()
-        # This buffer will contain a "stream", which is the token coming from the other side
-        buffer.append(
-            win32security.PySecBufferType(len(token), sspicon.SECBUFFER_STREAM)
-        )
-        buffer[0].Buffer = token
-
-        # This buffer will receive the clear, or just unwrapped text if no encryption was used.
-        # Will be resized by the lib.
-        buffer.append(win32security.PySecBufferType(0, sspicon.SECBUFFER_DATA))
-
-        pfQOP = self.ctxt.DecryptMessage(buffer, self._get_next_seq_num())
-
-        r = buffer[1].Buffer
-        return r, not (pfQOP == sspicon.SECQOP_WRAP_NO_ENCRYPT)
-
-    def wrap(self, msg, encrypt=False):
-        """
-        GSSAPI's wrap with SSPI.
-        https://docs.microsoft.com/en-us/windows/win32/secauthn/sspi-kerberos-interoperability-with-gssapi
-
-        Usable mainly with Kerberos SSPI package, but this is not enforced.
-
-        Wrap a message to be sent to the other side. Encrypted if encrypt is True.
-        """
-
-        size_info = self.ctxt.QueryContextAttributes(sspicon.SECPKG_ATTR_SIZES)
-        trailer_size = size_info["SecurityTrailer"]
-        block_size = size_info["BlockSize"]
-
-        buffer = win32security.PySecBufferDescType()
-
-        # This buffer will contain unencrypted data to wrap, and maybe encrypt.
-        buffer.append(win32security.PySecBufferType(len(msg), sspicon.SECBUFFER_DATA))
-        buffer[0].Buffer = msg
-
-        # Will receive the token that forms the beginning of the msg
-        buffer.append(
-            win32security.PySecBufferType(trailer_size, sspicon.SECBUFFER_TOKEN)
-        )
-
-        # The trailer is needed in case of block encryption
-        buffer.append(
-            win32security.PySecBufferType(block_size, sspicon.SECBUFFER_PADDING)
-        )
-
-        fQOP = 0 if encrypt else sspicon.SECQOP_WRAP_NO_ENCRYPT
-        self.ctxt.EncryptMessage(fQOP, buffer, self._get_next_seq_num())
-
-        # Sec token, then data, then padding
-        r = buffer[1].Buffer + buffer[0].Buffer + buffer[2].Buffer
-        return r
-
-    def _amend_ctx_name(self):
-        """Adds initiator and service names in the security context for ease of use"""
-        if not self.authenticated:
-            raise ValueError("Sec context is not completely authenticated")
-
-        try:
-            names = self.ctxt.QueryContextAttributes(sspicon.SECPKG_ATTR_NATIVE_NAMES)
-        except error:
-            # The SSP doesn't provide these attributes.
-            pass
-        else:
-            self.initiator_name, self.service_name = names
-
-
-class ClientAuth(_BaseAuth):
-    """Manages the client side of an SSPI authentication handshake"""
-
-    def __init__(
-        self,
-        pkg_name,  # Name of the package to used.
-        client_name=None,  # User for whom credentials are used.
-        auth_info=None,  # or a tuple of (username, domain, password)
-        targetspn=None,  # Target security context provider name.
-        scflags=None,  # security context flags
-        datarep=sspicon.SECURITY_NETWORK_DREP,
-    ):
-        if scflags is None:
-            scflags = (
-                sspicon.ISC_REQ_INTEGRITY
-                | sspicon.ISC_REQ_SEQUENCE_DETECT
-                | sspicon.ISC_REQ_REPLAY_DETECT
-                | sspicon.ISC_REQ_CONFIDENTIALITY
-            )
-        self.scflags = scflags
-        self.datarep = datarep
-        self.targetspn = targetspn
-        self.pkg_info = win32security.QuerySecurityPackageInfo(pkg_name)
-        (
-            self.credentials,
-            self.credentials_expiry,
-        ) = win32security.AcquireCredentialsHandle(
-            client_name,
-            self.pkg_info["Name"],
-            sspicon.SECPKG_CRED_OUTBOUND,
-            None,
-            auth_info,
-        )
-        _BaseAuth.__init__(self)
-
-    def authorize(self, sec_buffer_in):
-        """Perform *one* step of the client authentication process. Pass None for the first round"""
-        if (
-            sec_buffer_in is not None
-            and type(sec_buffer_in) != win32security.PySecBufferDescType
-        ):
-            # User passed us the raw data - wrap it into a SecBufferDesc
-            sec_buffer_new = win32security.PySecBufferDescType()
-            tokenbuf = win32security.PySecBufferType(
-                self.pkg_info["MaxToken"], sspicon.SECBUFFER_TOKEN
-            )
-            tokenbuf.Buffer = sec_buffer_in
-            sec_buffer_new.append(tokenbuf)
-            sec_buffer_in = sec_buffer_new
-        sec_buffer_out = win32security.PySecBufferDescType()
-        tokenbuf = win32security.PySecBufferType(
-            self.pkg_info["MaxToken"], sspicon.SECBUFFER_TOKEN
-        )
-        sec_buffer_out.append(tokenbuf)
-        ## input context handle should be NULL on first call
-        ctxtin = self.ctxt
-        if self.ctxt is None:
-            self.ctxt = win32security.PyCtxtHandleType()
-        err, attr, exp = win32security.InitializeSecurityContext(
-            self.credentials,
-            ctxtin,
-            self.targetspn,
-            self.scflags,
-            self.datarep,
-            sec_buffer_in,
-            self.ctxt,
-            sec_buffer_out,
-        )
-        # Stash these away incase someone needs to know the state from the
-        # final call.
-        self.ctxt_attr = attr
-        self.ctxt_expiry = exp
-
-        if err in (sspicon.SEC_I_COMPLETE_NEEDED, sspicon.SEC_I_COMPLETE_AND_CONTINUE):
-            self.ctxt.CompleteAuthToken(sec_buffer_out)
-
-        self.authenticated = err == 0
-        if self.authenticated:
-            self._amend_ctx_name()
-
-        return err, sec_buffer_out
-
-
-class ServerAuth(_BaseAuth):
-    """Manages the server side of an SSPI authentication handshake"""
-
-    def __init__(
-        self, pkg_name, spn=None, scflags=None, datarep=sspicon.SECURITY_NETWORK_DREP
-    ):
-        self.spn = spn
-        self.datarep = datarep
-
-        if scflags is None:
-            scflags = (
-                sspicon.ASC_REQ_INTEGRITY
-                | sspicon.ASC_REQ_SEQUENCE_DETECT
-                | sspicon.ASC_REQ_REPLAY_DETECT
-                | sspicon.ASC_REQ_CONFIDENTIALITY
-            )
-        # Should we default to sspicon.KerbAddExtraCredentialsMessage
-        # if pkg_name=='Kerberos'?
-        self.scflags = scflags
-
-        self.pkg_info = win32security.QuerySecurityPackageInfo(pkg_name)
-
-        (
-            self.credentials,
-            self.credentials_expiry,
-        ) = win32security.AcquireCredentialsHandle(
-            spn, self.pkg_info["Name"], sspicon.SECPKG_CRED_INBOUND, None, None
-        )
-        _BaseAuth.__init__(self)
-
-    def authorize(self, sec_buffer_in):
-        """Perform *one* step of the server authentication process."""
-        if (
-            sec_buffer_in is not None
-            and type(sec_buffer_in) != win32security.PySecBufferDescType
-        ):
-            # User passed us the raw data - wrap it into a SecBufferDesc
-            sec_buffer_new = win32security.PySecBufferDescType()
-            tokenbuf = win32security.PySecBufferType(
-                self.pkg_info["MaxToken"], sspicon.SECBUFFER_TOKEN
-            )
-            tokenbuf.Buffer = sec_buffer_in
-            sec_buffer_new.append(tokenbuf)
-            sec_buffer_in = sec_buffer_new
-
-        sec_buffer_out = win32security.PySecBufferDescType()
-        tokenbuf = win32security.PySecBufferType(
-            self.pkg_info["MaxToken"], sspicon.SECBUFFER_TOKEN
-        )
-        sec_buffer_out.append(tokenbuf)
-        ## input context handle is None initially, then handle returned from last call thereafter
-        ctxtin = self.ctxt
-        if self.ctxt is None:
-            self.ctxt = win32security.PyCtxtHandleType()
-        err, attr, exp = win32security.AcceptSecurityContext(
-            self.credentials,
-            ctxtin,
-            sec_buffer_in,
-            self.scflags,
-            self.datarep,
-            self.ctxt,
-            sec_buffer_out,
-        )
-
-        # Stash these away incase someone needs to know the state from the
-        # final call.
-        self.ctxt_attr = attr
-        self.ctxt_expiry = exp
-
-        if err in (sspicon.SEC_I_COMPLETE_NEEDED, sspicon.SEC_I_COMPLETE_AND_CONTINUE):
-            self.ctxt.CompleteAuthToken(sec_buffer_out)
-
-        self.authenticated = err == 0
-        if self.authenticated:
-            self._amend_ctx_name()
-
-        return err, sec_buffer_out
-
-
-if __name__ == "__main__":
-    # This is the security package (the security support provider / the security backend)
-    # we want to use for this example.
-    ssp = "Kerberos"  # or "NTLM" or "Negotiate" which enable negotiation between
-    # Kerberos (prefered) and NTLM (if not supported on the other side).
-
-    flags = (
-        sspicon.ISC_REQ_MUTUAL_AUTH
-        | sspicon.ISC_REQ_INTEGRITY  # mutual authentication
-        | sspicon.ISC_REQ_SEQUENCE_DETECT  # check for integrity
-        | sspicon.ISC_REQ_CONFIDENTIALITY  # enable out-of-order messages
-        | sspicon.ISC_REQ_REPLAY_DETECT  # request confidentiality  # request replay detection
-    )
-
-    # Get our identity, mandatory for the Kerberos case *for this example*
-    # Kerberos cannot be used if we don't tell it the target we want
-    # to authenticate to.
-    cred_handle, exp = win32security.AcquireCredentialsHandle(
-        None, ssp, sspicon.SECPKG_CRED_INBOUND, None, None
-    )
-    cred = cred_handle.QueryCredentialsAttributes(sspicon.SECPKG_CRED_ATTR_NAMES)
-    print("We are:", cred)
-
-    # Setup the 2 contexts. In real life, only one is needed: the other one is
-    # created in the process we want to communicate with.
-    sspiclient = ClientAuth(ssp, scflags=flags, targetspn=cred)
-    sspiserver = ServerAuth(ssp, scflags=flags)
-
-    print(
-        "SSP : %s (%s)" % (sspiclient.pkg_info["Name"], sspiclient.pkg_info["Comment"])
-    )
-
-    # Perform the authentication dance, each loop exchanging more information
-    # on the way to completing authentication.
-    sec_buffer = None
-    client_step = 0
-    server_step = 0
-    while not (sspiclient.authenticated) or len(sec_buffer[0].Buffer):
-        client_step += 1
-        err, sec_buffer = sspiclient.authorize(sec_buffer)
-        print("Client step %s" % client_step)
-        if sspiserver.authenticated and len(sec_buffer[0].Buffer) == 0:
-            break
-
-        server_step += 1
-        err, sec_buffer = sspiserver.authorize(sec_buffer)
-        print("Server step %s" % server_step)
-
-    # Authentication process is finished.
-    print("Initiator name from the service side:", sspiserver.initiator_name)
-    print("Service name from the client side:   ", sspiclient.service_name)
-
-    data = "hello".encode("ascii")  # py3k-friendly
-
-    # Simple signature, not compatible with GSSAPI.
-    sig = sspiclient.sign(data)
-    sspiserver.verify(data, sig)
-
-    # Encryption
-    encrypted, sig = sspiclient.encrypt(data)
-    decrypted = sspiserver.decrypt(encrypted, sig)
-    assert decrypted == data
-
-    # GSSAPI wrapping, no encryption (NTLM always encrypts)
-    wrapped = sspiclient.wrap(data)
-    unwrapped, was_encrypted = sspiserver.unwrap(wrapped)
-    print("encrypted ?", was_encrypted)
-    assert data == unwrapped
-
-    # GSSAPI wrapping, with encryption
-    wrapped = sspiserver.wrap(data, encrypt=True)
-    unwrapped, was_encrypted = sspiclient.unwrap(wrapped)
-    print("encrypted ?", was_encrypted)
-    assert data == unwrapped
-
-    print("cool!")
diff --git a/lib/win32/lib/sspicon.py b/lib/win32/lib/sspicon.py
deleted file mode 100644
index 12f7482d..00000000
--- a/lib/win32/lib/sspicon.py
+++ /dev/null
@@ -1,477 +0,0 @@
-# Generated by h2py from c:\microsoft sdk\include\sspi.h
-ISSP_LEVEL = 32
-ISSP_MODE = 1
-
-
-def SEC_SUCCESS(Status):
-    return (Status) >= 0
-
-
-SECPKG_FLAG_INTEGRITY = 1
-SECPKG_FLAG_PRIVACY = 2
-SECPKG_FLAG_TOKEN_ONLY = 4
-SECPKG_FLAG_DATAGRAM = 8
-SECPKG_FLAG_CONNECTION = 16
-SECPKG_FLAG_MULTI_REQUIRED = 32
-SECPKG_FLAG_CLIENT_ONLY = 64
-SECPKG_FLAG_EXTENDED_ERROR = 128
-SECPKG_FLAG_IMPERSONATION = 256
-SECPKG_FLAG_ACCEPT_WIN32_NAME = 512
-SECPKG_FLAG_STREAM = 1024
-SECPKG_FLAG_NEGOTIABLE = 2048
-SECPKG_FLAG_GSS_COMPATIBLE = 4096
-SECPKG_FLAG_LOGON = 8192
-SECPKG_FLAG_ASCII_BUFFERS = 16384
-SECPKG_FLAG_FRAGMENT = 32768
-SECPKG_FLAG_MUTUAL_AUTH = 65536
-SECPKG_FLAG_DELEGATION = 131072
-SECPKG_FLAG_READONLY_WITH_CHECKSUM = 262144
-SECPKG_ID_NONE = 65535
-
-SECBUFFER_VERSION = 0
-SECBUFFER_EMPTY = 0
-SECBUFFER_DATA = 1
-SECBUFFER_TOKEN = 2
-SECBUFFER_PKG_PARAMS = 3
-SECBUFFER_MISSING = 4
-SECBUFFER_EXTRA = 5
-SECBUFFER_STREAM_TRAILER = 6
-SECBUFFER_STREAM_HEADER = 7
-SECBUFFER_NEGOTIATION_INFO = 8
-SECBUFFER_PADDING = 9
-SECBUFFER_STREAM = 10
-SECBUFFER_MECHLIST = 11
-SECBUFFER_MECHLIST_SIGNATURE = 12
-SECBUFFER_TARGET = 13
-SECBUFFER_CHANNEL_BINDINGS = 14
-SECBUFFER_ATTRMASK = -268435456
-SECBUFFER_READONLY = -2147483648
-SECBUFFER_READONLY_WITH_CHECKSUM = 268435456
-SECBUFFER_RESERVED = 1610612736
-
-SECURITY_NATIVE_DREP = 16
-SECURITY_NETWORK_DREP = 0
-
-SECPKG_CRED_INBOUND = 1
-SECPKG_CRED_OUTBOUND = 2
-SECPKG_CRED_BOTH = 3
-SECPKG_CRED_DEFAULT = 4
-SECPKG_CRED_RESERVED = -268435456
-
-ISC_REQ_DELEGATE = 1
-ISC_REQ_MUTUAL_AUTH = 2
-ISC_REQ_REPLAY_DETECT = 4
-ISC_REQ_SEQUENCE_DETECT = 8
-ISC_REQ_CONFIDENTIALITY = 16
-ISC_REQ_USE_SESSION_KEY = 32
-ISC_REQ_PROMPT_FOR_CREDS = 64
-ISC_REQ_USE_SUPPLIED_CREDS = 128
-ISC_REQ_ALLOCATE_MEMORY = 256
-ISC_REQ_USE_DCE_STYLE = 512
-ISC_REQ_DATAGRAM = 1024
-ISC_REQ_CONNECTION = 2048
-ISC_REQ_CALL_LEVEL = 4096
-ISC_REQ_FRAGMENT_SUPPLIED = 8192
-ISC_REQ_EXTENDED_ERROR = 16384
-ISC_REQ_STREAM = 32768
-ISC_REQ_INTEGRITY = 65536
-ISC_REQ_IDENTIFY = 131072
-ISC_REQ_NULL_SESSION = 262144
-ISC_REQ_MANUAL_CRED_VALIDATION = 524288
-ISC_REQ_RESERVED1 = 1048576
-ISC_REQ_FRAGMENT_TO_FIT = 2097152
-ISC_REQ_HTTP = 0x10000000
-ISC_RET_DELEGATE = 1
-ISC_RET_MUTUAL_AUTH = 2
-ISC_RET_REPLAY_DETECT = 4
-ISC_RET_SEQUENCE_DETECT = 8
-ISC_RET_CONFIDENTIALITY = 16
-ISC_RET_USE_SESSION_KEY = 32
-ISC_RET_USED_COLLECTED_CREDS = 64
-ISC_RET_USED_SUPPLIED_CREDS = 128
-ISC_RET_ALLOCATED_MEMORY = 256
-ISC_RET_USED_DCE_STYLE = 512
-ISC_RET_DATAGRAM = 1024
-ISC_RET_CONNECTION = 2048
-ISC_RET_INTERMEDIATE_RETURN = 4096
-ISC_RET_CALL_LEVEL = 8192
-ISC_RET_EXTENDED_ERROR = 16384
-ISC_RET_STREAM = 32768
-ISC_RET_INTEGRITY = 65536
-ISC_RET_IDENTIFY = 131072
-ISC_RET_NULL_SESSION = 262144
-ISC_RET_MANUAL_CRED_VALIDATION = 524288
-ISC_RET_RESERVED1 = 1048576
-ISC_RET_FRAGMENT_ONLY = 2097152
-
-ASC_REQ_DELEGATE = 1
-ASC_REQ_MUTUAL_AUTH = 2
-ASC_REQ_REPLAY_DETECT = 4
-ASC_REQ_SEQUENCE_DETECT = 8
-ASC_REQ_CONFIDENTIALITY = 16
-ASC_REQ_USE_SESSION_KEY = 32
-ASC_REQ_ALLOCATE_MEMORY = 256
-ASC_REQ_USE_DCE_STYLE = 512
-ASC_REQ_DATAGRAM = 1024
-ASC_REQ_CONNECTION = 2048
-ASC_REQ_CALL_LEVEL = 4096
-ASC_REQ_EXTENDED_ERROR = 32768
-ASC_REQ_STREAM = 65536
-ASC_REQ_INTEGRITY = 131072
-ASC_REQ_LICENSING = 262144
-ASC_REQ_IDENTIFY = 524288
-ASC_REQ_ALLOW_NULL_SESSION = 1048576
-ASC_REQ_ALLOW_NON_USER_LOGONS = 2097152
-ASC_REQ_ALLOW_CONTEXT_REPLAY = 4194304
-ASC_REQ_FRAGMENT_TO_FIT = 8388608
-ASC_REQ_FRAGMENT_SUPPLIED = 8192
-ASC_REQ_NO_TOKEN = 16777216
-ASC_RET_DELEGATE = 1
-ASC_RET_MUTUAL_AUTH = 2
-ASC_RET_REPLAY_DETECT = 4
-ASC_RET_SEQUENCE_DETECT = 8
-ASC_RET_CONFIDENTIALITY = 16
-ASC_RET_USE_SESSION_KEY = 32
-ASC_RET_ALLOCATED_MEMORY = 256
-ASC_RET_USED_DCE_STYLE = 512
-ASC_RET_DATAGRAM = 1024
-ASC_RET_CONNECTION = 2048
-ASC_RET_CALL_LEVEL = 8192
-ASC_RET_THIRD_LEG_FAILED = 16384
-ASC_RET_EXTENDED_ERROR = 32768
-ASC_RET_STREAM = 65536
-ASC_RET_INTEGRITY = 131072
-ASC_RET_LICENSING = 262144
-ASC_RET_IDENTIFY = 524288
-ASC_RET_NULL_SESSION = 1048576
-ASC_RET_ALLOW_NON_USER_LOGONS = 2097152
-ASC_RET_ALLOW_CONTEXT_REPLAY = 4194304
-ASC_RET_FRAGMENT_ONLY = 8388608
-
-SECPKG_CRED_ATTR_NAMES = 1
-SECPKG_ATTR_SIZES = 0
-SECPKG_ATTR_NAMES = 1
-SECPKG_ATTR_LIFESPAN = 2
-SECPKG_ATTR_DCE_INFO = 3
-SECPKG_ATTR_STREAM_SIZES = 4
-SECPKG_ATTR_KEY_INFO = 5
-SECPKG_ATTR_AUTHORITY = 6
-SECPKG_ATTR_PROTO_INFO = 7
-SECPKG_ATTR_PASSWORD_EXPIRY = 8
-SECPKG_ATTR_SESSION_KEY = 9
-SECPKG_ATTR_PACKAGE_INFO = 10
-SECPKG_ATTR_USER_FLAGS = 11
-SECPKG_ATTR_NEGOTIATION_INFO = 12
-SECPKG_ATTR_NATIVE_NAMES = 13
-SECPKG_ATTR_FLAGS = 14
-SECPKG_ATTR_USE_VALIDATED = 15
-SECPKG_ATTR_CREDENTIAL_NAME = 16
-SECPKG_ATTR_TARGET_INFORMATION = 17
-SECPKG_ATTR_ACCESS_TOKEN = 18
-SECPKG_ATTR_TARGET = 19
-SECPKG_ATTR_AUTHENTICATION_ID = 20
-
-## attributes from schannel.h
-SECPKG_ATTR_REMOTE_CERT_CONTEXT = 83
-SECPKG_ATTR_LOCAL_CERT_CONTEXT = 84
-SECPKG_ATTR_ROOT_STORE = 85
-SECPKG_ATTR_SUPPORTED_ALGS = 86
-SECPKG_ATTR_CIPHER_STRENGTHS = 87
-SECPKG_ATTR_SUPPORTED_PROTOCOLS = 88
-SECPKG_ATTR_ISSUER_LIST_EX = 89
-SECPKG_ATTR_CONNECTION_INFO = 90
-SECPKG_ATTR_EAP_KEY_BLOCK = 91
-SECPKG_ATTR_MAPPED_CRED_ATTR = 92
-SECPKG_ATTR_SESSION_INFO = 93
-SECPKG_ATTR_APP_DATA = 94
-
-SECPKG_NEGOTIATION_COMPLETE = 0
-SECPKG_NEGOTIATION_OPTIMISTIC = 1
-SECPKG_NEGOTIATION_IN_PROGRESS = 2
-SECPKG_NEGOTIATION_DIRECT = 3
-SECPKG_NEGOTIATION_TRY_MULTICRED = 4
-SECPKG_CONTEXT_EXPORT_RESET_NEW = 1
-SECPKG_CONTEXT_EXPORT_DELETE_OLD = 2
-SECQOP_WRAP_NO_ENCRYPT = -2147483647
-SECURITY_ENTRYPOINT_ANSIW = "InitSecurityInterfaceW"
-SECURITY_ENTRYPOINT_ANSIA = "InitSecurityInterfaceA"
-SECURITY_ENTRYPOINT16 = "INITSECURITYINTERFACEA"
-SECURITY_ENTRYPOINT = SECURITY_ENTRYPOINT16
-SECURITY_ENTRYPOINT_ANSI = SECURITY_ENTRYPOINT16
-SECURITY_SUPPORT_PROVIDER_INTERFACE_VERSION = 1
-SECURITY_SUPPORT_PROVIDER_INTERFACE_VERSION_2 = 2
-SASL_OPTION_SEND_SIZE = 1
-SASL_OPTION_RECV_SIZE = 2
-SASL_OPTION_AUTHZ_STRING = 3
-SASL_OPTION_AUTHZ_PROCESSING = 4
-SEC_WINNT_AUTH_IDENTITY_ANSI = 1
-SEC_WINNT_AUTH_IDENTITY_UNICODE = 2
-SEC_WINNT_AUTH_IDENTITY_VERSION = 512
-SEC_WINNT_AUTH_IDENTITY_MARSHALLED = 4
-SEC_WINNT_AUTH_IDENTITY_ONLY = 8
-SECPKG_OPTIONS_TYPE_UNKNOWN = 0
-SECPKG_OPTIONS_TYPE_LSA = 1
-SECPKG_OPTIONS_TYPE_SSPI = 2
-SECPKG_OPTIONS_PERMANENT = 1
-
-SEC_E_INSUFFICIENT_MEMORY = -2146893056
-SEC_E_INVALID_HANDLE = -2146893055
-SEC_E_UNSUPPORTED_FUNCTION = -2146893054
-SEC_E_TARGET_UNKNOWN = -2146893053
-SEC_E_INTERNAL_ERROR = -2146893052
-SEC_E_SECPKG_NOT_FOUND = -2146893051
-SEC_E_NOT_OWNER = -2146893050
-SEC_E_CANNOT_INSTALL = -2146893049
-SEC_E_INVALID_TOKEN = -2146893048
-SEC_E_CANNOT_PACK = -2146893047
-SEC_E_QOP_NOT_SUPPORTED = -2146893046
-SEC_E_NO_IMPERSONATION = -2146893045
-SEC_E_LOGON_DENIED = -2146893044
-SEC_E_UNKNOWN_CREDENTIALS = -2146893043
-SEC_E_NO_CREDENTIALS = -2146893042
-SEC_E_MESSAGE_ALTERED = -2146893041
-SEC_E_OUT_OF_SEQUENCE = -2146893040
-SEC_E_NO_AUTHENTICATING_AUTHORITY = -2146893039
-SEC_I_CONTINUE_NEEDED = 590610
-SEC_I_COMPLETE_NEEDED = 590611
-SEC_I_COMPLETE_AND_CONTINUE = 590612
-SEC_I_LOCAL_LOGON = 590613
-SEC_E_BAD_PKGID = -2146893034
-SEC_E_CONTEXT_EXPIRED = -2146893033
-SEC_I_CONTEXT_EXPIRED = 590615
-SEC_E_INCOMPLETE_MESSAGE = -2146893032
-SEC_E_INCOMPLETE_CREDENTIALS = -2146893024
-SEC_E_BUFFER_TOO_SMALL = -2146893023
-SEC_I_INCOMPLETE_CREDENTIALS = 590624
-SEC_I_RENEGOTIATE = 590625
-SEC_E_WRONG_PRINCIPAL = -2146893022
-SEC_I_NO_LSA_CONTEXT = 590627
-SEC_E_TIME_SKEW = -2146893020
-SEC_E_UNTRUSTED_ROOT = -2146893019
-SEC_E_ILLEGAL_MESSAGE = -2146893018
-SEC_E_CERT_UNKNOWN = -2146893017
-SEC_E_CERT_EXPIRED = -2146893016
-SEC_E_ENCRYPT_FAILURE = -2146893015
-SEC_E_DECRYPT_FAILURE = -2146893008
-SEC_E_ALGORITHM_MISMATCH = -2146893007
-SEC_E_SECURITY_QOS_FAILED = -2146893006
-SEC_E_UNFINISHED_CONTEXT_DELETED = -2146893005
-SEC_E_NO_TGT_REPLY = -2146893004
-SEC_E_NO_IP_ADDRESSES = -2146893003
-SEC_E_WRONG_CREDENTIAL_HANDLE = -2146893002
-SEC_E_CRYPTO_SYSTEM_INVALID = -2146893001
-SEC_E_MAX_REFERRALS_EXCEEDED = -2146893000
-SEC_E_MUST_BE_KDC = -2146892999
-SEC_E_STRONG_CRYPTO_NOT_SUPPORTED = -2146892998
-SEC_E_TOO_MANY_PRINCIPALS = -2146892997
-SEC_E_NO_PA_DATA = -2146892996
-SEC_E_PKINIT_NAME_MISMATCH = -2146892995
-SEC_E_SMARTCARD_LOGON_REQUIRED = -2146892994
-SEC_E_SHUTDOWN_IN_PROGRESS = -2146892993
-SEC_E_KDC_INVALID_REQUEST = -2146892992
-SEC_E_KDC_UNABLE_TO_REFER = -2146892991
-SEC_E_KDC_UNKNOWN_ETYPE = -2146892990
-SEC_E_UNSUPPORTED_PREAUTH = -2146892989
-SEC_E_DELEGATION_REQUIRED = -2146892987
-SEC_E_BAD_BINDINGS = -2146892986
-SEC_E_MULTIPLE_ACCOUNTS = -2146892985
-SEC_E_NO_KERB_KEY = -2146892984
-
-ERROR_IPSEC_QM_POLICY_EXISTS = 13000
-ERROR_IPSEC_QM_POLICY_NOT_FOUND = 13001
-ERROR_IPSEC_QM_POLICY_IN_USE = 13002
-ERROR_IPSEC_MM_POLICY_EXISTS = 13003
-ERROR_IPSEC_MM_POLICY_NOT_FOUND = 13004
-ERROR_IPSEC_MM_POLICY_IN_USE = 13005
-ERROR_IPSEC_MM_FILTER_EXISTS = 13006
-ERROR_IPSEC_MM_FILTER_NOT_FOUND = 13007
-ERROR_IPSEC_TRANSPORT_FILTER_EXISTS = 13008
-ERROR_IPSEC_TRANSPORT_FILTER_NOT_FOUND = 13009
-ERROR_IPSEC_MM_AUTH_EXISTS = 13010
-ERROR_IPSEC_MM_AUTH_NOT_FOUND = 13011
-ERROR_IPSEC_MM_AUTH_IN_USE = 13012
-ERROR_IPSEC_DEFAULT_MM_POLICY_NOT_FOUND = 13013
-ERROR_IPSEC_DEFAULT_MM_AUTH_NOT_FOUND = 13014
-ERROR_IPSEC_DEFAULT_QM_POLICY_NOT_FOUND = 13015
-ERROR_IPSEC_TUNNEL_FILTER_EXISTS = 13016
-ERROR_IPSEC_TUNNEL_FILTER_NOT_FOUND = 13017
-ERROR_IPSEC_MM_FILTER_PENDING_DELETION = 13018
-ERROR_IPSEC_TRANSPORT_FILTER_PENDING_DELETION = 13019
-ERROR_IPSEC_TUNNEL_FILTER_PENDING_DELETION = 13020
-ERROR_IPSEC_MM_POLICY_PENDING_DELETION = 13021
-ERROR_IPSEC_MM_AUTH_PENDING_DELETION = 13022
-ERROR_IPSEC_QM_POLICY_PENDING_DELETION = 13023
-WARNING_IPSEC_MM_POLICY_PRUNED = 13024
-WARNING_IPSEC_QM_POLICY_PRUNED = 13025
-ERROR_IPSEC_IKE_NEG_STATUS_BEGIN = 13800
-ERROR_IPSEC_IKE_AUTH_FAIL = 13801
-ERROR_IPSEC_IKE_ATTRIB_FAIL = 13802
-ERROR_IPSEC_IKE_NEGOTIATION_PENDING = 13803
-ERROR_IPSEC_IKE_GENERAL_PROCESSING_ERROR = 13804
-ERROR_IPSEC_IKE_TIMED_OUT = 13805
-ERROR_IPSEC_IKE_NO_CERT = 13806
-ERROR_IPSEC_IKE_SA_DELETED = 13807
-ERROR_IPSEC_IKE_SA_REAPED = 13808
-ERROR_IPSEC_IKE_MM_ACQUIRE_DROP = 13809
-ERROR_IPSEC_IKE_QM_ACQUIRE_DROP = 13810
-ERROR_IPSEC_IKE_QUEUE_DROP_MM = 13811
-ERROR_IPSEC_IKE_QUEUE_DROP_NO_MM = 13812
-ERROR_IPSEC_IKE_DROP_NO_RESPONSE = 13813
-ERROR_IPSEC_IKE_MM_DELAY_DROP = 13814
-ERROR_IPSEC_IKE_QM_DELAY_DROP = 13815
-ERROR_IPSEC_IKE_ERROR = 13816
-ERROR_IPSEC_IKE_CRL_FAILED = 13817
-ERROR_IPSEC_IKE_INVALID_KEY_USAGE = 13818
-ERROR_IPSEC_IKE_INVALID_CERT_TYPE = 13819
-ERROR_IPSEC_IKE_NO_PRIVATE_KEY = 13820
-ERROR_IPSEC_IKE_DH_FAIL = 13822
-ERROR_IPSEC_IKE_INVALID_HEADER = 13824
-ERROR_IPSEC_IKE_NO_POLICY = 13825
-ERROR_IPSEC_IKE_INVALID_SIGNATURE = 13826
-ERROR_IPSEC_IKE_KERBEROS_ERROR = 13827
-ERROR_IPSEC_IKE_NO_PUBLIC_KEY = 13828
-ERROR_IPSEC_IKE_PROCESS_ERR = 13829
-ERROR_IPSEC_IKE_PROCESS_ERR_SA = 13830
-ERROR_IPSEC_IKE_PROCESS_ERR_PROP = 13831
-ERROR_IPSEC_IKE_PROCESS_ERR_TRANS = 13832
-ERROR_IPSEC_IKE_PROCESS_ERR_KE = 13833
-ERROR_IPSEC_IKE_PROCESS_ERR_ID = 13834
-ERROR_IPSEC_IKE_PROCESS_ERR_CERT = 13835
-ERROR_IPSEC_IKE_PROCESS_ERR_CERT_REQ = 13836
-ERROR_IPSEC_IKE_PROCESS_ERR_HASH = 13837
-ERROR_IPSEC_IKE_PROCESS_ERR_SIG = 13838
-ERROR_IPSEC_IKE_PROCESS_ERR_NONCE = 13839
-ERROR_IPSEC_IKE_PROCESS_ERR_NOTIFY = 13840
-ERROR_IPSEC_IKE_PROCESS_ERR_DELETE = 13841
-ERROR_IPSEC_IKE_PROCESS_ERR_VENDOR = 13842
-ERROR_IPSEC_IKE_INVALID_PAYLOAD = 13843
-ERROR_IPSEC_IKE_LOAD_SOFT_SA = 13844
-ERROR_IPSEC_IKE_SOFT_SA_TORN_DOWN = 13845
-ERROR_IPSEC_IKE_INVALID_COOKIE = 13846
-ERROR_IPSEC_IKE_NO_PEER_CERT = 13847
-ERROR_IPSEC_IKE_PEER_CRL_FAILED = 13848
-ERROR_IPSEC_IKE_POLICY_CHANGE = 13849
-ERROR_IPSEC_IKE_NO_MM_POLICY = 13850
-ERROR_IPSEC_IKE_NOTCBPRIV = 13851
-ERROR_IPSEC_IKE_SECLOADFAIL = 13852
-ERROR_IPSEC_IKE_FAILSSPINIT = 13853
-ERROR_IPSEC_IKE_FAILQUERYSSP = 13854
-ERROR_IPSEC_IKE_SRVACQFAIL = 13855
-ERROR_IPSEC_IKE_SRVQUERYCRED = 13856
-ERROR_IPSEC_IKE_GETSPIFAIL = 13857
-ERROR_IPSEC_IKE_INVALID_FILTER = 13858
-ERROR_IPSEC_IKE_OUT_OF_MEMORY = 13859
-ERROR_IPSEC_IKE_ADD_UPDATE_KEY_FAILED = 13860
-ERROR_IPSEC_IKE_INVALID_POLICY = 13861
-ERROR_IPSEC_IKE_UNKNOWN_DOI = 13862
-ERROR_IPSEC_IKE_INVALID_SITUATION = 13863
-ERROR_IPSEC_IKE_DH_FAILURE = 13864
-ERROR_IPSEC_IKE_INVALID_GROUP = 13865
-ERROR_IPSEC_IKE_ENCRYPT = 13866
-ERROR_IPSEC_IKE_DECRYPT = 13867
-ERROR_IPSEC_IKE_POLICY_MATCH = 13868
-ERROR_IPSEC_IKE_UNSUPPORTED_ID = 13869
-ERROR_IPSEC_IKE_INVALID_HASH = 13870
-ERROR_IPSEC_IKE_INVALID_HASH_ALG = 13871
-ERROR_IPSEC_IKE_INVALID_HASH_SIZE = 13872
-ERROR_IPSEC_IKE_INVALID_ENCRYPT_ALG = 13873
-ERROR_IPSEC_IKE_INVALID_AUTH_ALG = 13874
-ERROR_IPSEC_IKE_INVALID_SIG = 13875
-ERROR_IPSEC_IKE_LOAD_FAILED = 13876
-ERROR_IPSEC_IKE_RPC_DELETE = 13877
-ERROR_IPSEC_IKE_BENIGN_REINIT = 13878
-ERROR_IPSEC_IKE_INVALID_RESPONDER_LIFETIME_NOTIFY = 13879
-ERROR_IPSEC_IKE_INVALID_CERT_KEYLEN = 13881
-ERROR_IPSEC_IKE_MM_LIMIT = 13882
-ERROR_IPSEC_IKE_NEGOTIATION_DISABLED = 13883
-ERROR_IPSEC_IKE_NEG_STATUS_END = 13884
-CRYPT_E_MSG_ERROR = -2146889727
-CRYPT_E_UNKNOWN_ALGO = -2146889726
-CRYPT_E_OID_FORMAT = -2146889725
-CRYPT_E_INVALID_MSG_TYPE = -2146889724
-CRYPT_E_UNEXPECTED_ENCODING = -2146889723
-CRYPT_E_AUTH_ATTR_MISSING = -2146889722
-CRYPT_E_HASH_VALUE = -2146889721
-CRYPT_E_INVALID_INDEX = -2146889720
-CRYPT_E_ALREADY_DECRYPTED = -2146889719
-CRYPT_E_NOT_DECRYPTED = -2146889718
-CRYPT_E_RECIPIENT_NOT_FOUND = -2146889717
-CRYPT_E_CONTROL_TYPE = -2146889716
-CRYPT_E_ISSUER_SERIALNUMBER = -2146889715
-CRYPT_E_SIGNER_NOT_FOUND = -2146889714
-CRYPT_E_ATTRIBUTES_MISSING = -2146889713
-CRYPT_E_STREAM_MSG_NOT_READY = -2146889712
-CRYPT_E_STREAM_INSUFFICIENT_DATA = -2146889711
-CRYPT_I_NEW_PROTECTION_REQUIRED = 593938
-CRYPT_E_BAD_LEN = -2146885631
-CRYPT_E_BAD_ENCODE = -2146885630
-CRYPT_E_FILE_ERROR = -2146885629
-CRYPT_E_NOT_FOUND = -2146885628
-CRYPT_E_EXISTS = -2146885627
-CRYPT_E_NO_PROVIDER = -2146885626
-CRYPT_E_SELF_SIGNED = -2146885625
-CRYPT_E_DELETED_PREV = -2146885624
-CRYPT_E_NO_MATCH = -2146885623
-CRYPT_E_UNEXPECTED_MSG_TYPE = -2146885622
-CRYPT_E_NO_KEY_PROPERTY = -2146885621
-CRYPT_E_NO_DECRYPT_CERT = -2146885620
-CRYPT_E_BAD_MSG = -2146885619
-CRYPT_E_NO_SIGNER = -2146885618
-CRYPT_E_PENDING_CLOSE = -2146885617
-CRYPT_E_REVOKED = -2146885616
-CRYPT_E_NO_REVOCATION_DLL = -2146885615
-CRYPT_E_NO_REVOCATION_CHECK = -2146885614
-CRYPT_E_REVOCATION_OFFLINE = -2146885613
-CRYPT_E_NOT_IN_REVOCATION_DATABASE = -2146885612
-CRYPT_E_INVALID_NUMERIC_STRING = -2146885600
-CRYPT_E_INVALID_PRINTABLE_STRING = -2146885599
-CRYPT_E_INVALID_IA5_STRING = -2146885598
-CRYPT_E_INVALID_X500_STRING = -2146885597
-CRYPT_E_NOT_CHAR_STRING = -2146885596
-CRYPT_E_FILERESIZED = -2146885595
-CRYPT_E_SECURITY_SETTINGS = -2146885594
-CRYPT_E_NO_VERIFY_USAGE_DLL = -2146885593
-CRYPT_E_NO_VERIFY_USAGE_CHECK = -2146885592
-CRYPT_E_VERIFY_USAGE_OFFLINE = -2146885591
-CRYPT_E_NOT_IN_CTL = -2146885590
-CRYPT_E_NO_TRUSTED_SIGNER = -2146885589
-CRYPT_E_MISSING_PUBKEY_PARA = -2146885588
-CRYPT_E_OSS_ERROR = -2146881536
-
-## Kerberos message types for LsaCallAuthenticationPackage (from ntsecapi.h)
-KerbDebugRequestMessage = 0
-KerbQueryTicketCacheMessage = 1
-KerbChangeMachinePasswordMessage = 2
-KerbVerifyPacMessage = 3
-KerbRetrieveTicketMessage = 4
-KerbUpdateAddressesMessage = 5
-KerbPurgeTicketCacheMessage = 6
-KerbChangePasswordMessage = 7
-KerbRetrieveEncodedTicketMessage = 8
-KerbDecryptDataMessage = 9
-KerbAddBindingCacheEntryMessage = 10
-KerbSetPasswordMessage = 11
-KerbSetPasswordExMessage = 12
-KerbVerifyCredentialsMessage = 13
-KerbQueryTicketCacheExMessage = 14
-KerbPurgeTicketCacheExMessage = 15
-KerbRefreshSmartcardCredentialsMessage = 16
-KerbAddExtraCredentialsMessage = 17
-KerbQuerySupplementalCredentialsMessage = 18
-
-## messages used with msv1_0 from ntsecapi.h
-MsV1_0Lm20ChallengeRequest = 0
-MsV1_0Lm20GetChallengeResponse = 1
-MsV1_0EnumerateUsers = 2
-MsV1_0GetUserInfo = 3
-MsV1_0ReLogonUsers = 4
-MsV1_0ChangePassword = 5
-MsV1_0ChangeCachedPassword = 6
-MsV1_0GenericPassthrough = 7
-MsV1_0CacheLogon = 8
-MsV1_0SubAuth = 9
-MsV1_0DeriveCredential = 10
-MsV1_0CacheLookup = 11
-MsV1_0SetProcessOption = 12
-
-SEC_E_OK = 0
diff --git a/lib/win32/lib/win2kras.py b/lib/win32/lib/win2kras.py
deleted file mode 100644
index f1c18b3a..00000000
--- a/lib/win32/lib/win2kras.py
+++ /dev/null
@@ -1,7 +0,0 @@
-# win2kras used to be an extension module with wrapped the "new" RAS functions
-# in Windows 2000, so win32ras could still be used on NT/etc.
-# I think in 2021 we can be confident pywin32 is not used on earlier OSs, so
-# that functionality is now in win32ras.
-#
-# This exists just to avoid breaking old scripts.
-from win32ras import *
diff --git a/lib/win32/lib/win32con.py b/lib/win32/lib/win32con.py
deleted file mode 100644
index 9916ba4a..00000000
--- a/lib/win32/lib/win32con.py
+++ /dev/null
@@ -1,5083 +0,0 @@
-# Generated by h2py from commdlg.h (plus modifications 4jan98)
-WINVER = 1280
-WM_USER = 1024
-PY_0U = 0
-OFN_READONLY = 1
-OFN_OVERWRITEPROMPT = 2
-OFN_HIDEREADONLY = 4
-OFN_NOCHANGEDIR = 8
-OFN_SHOWHELP = 16
-OFN_ENABLEHOOK = 32
-OFN_ENABLETEMPLATE = 64
-OFN_ENABLETEMPLATEHANDLE = 128
-OFN_NOVALIDATE = 256
-OFN_ALLOWMULTISELECT = 512
-OFN_EXTENSIONDIFFERENT = 1024
-OFN_PATHMUSTEXIST = 2048
-OFN_FILEMUSTEXIST = 4096
-OFN_CREATEPROMPT = 8192
-OFN_SHAREAWARE = 16384
-OFN_NOREADONLYRETURN = 32768
-OFN_NOTESTFILECREATE = 65536
-OFN_NONETWORKBUTTON = 131072
-OFN_NOLONGNAMES = 262144
-OFN_EXPLORER = 524288  # new look commdlg
-OFN_NODEREFERENCELINKS = 1048576
-OFN_LONGNAMES = 2097152  # force long names for 3.x modules
-OFN_ENABLEINCLUDENOTIFY = 4194304  # send include message to callback
-OFN_ENABLESIZING = 8388608
-OFN_DONTADDTORECENT = 33554432
-OFN_FORCESHOWHIDDEN = 268435456  # Show All files including System and hidden files
-OFN_EX_NOPLACESBAR = 1
-OFN_SHAREFALLTHROUGH = 2
-OFN_SHARENOWARN = 1
-OFN_SHAREWARN = 0
-CDN_FIRST = PY_0U - 601
-CDN_LAST = PY_0U - 699
-CDN_INITDONE = CDN_FIRST - 0
-CDN_SELCHANGE = CDN_FIRST - 1
-CDN_FOLDERCHANGE = CDN_FIRST - 2
-CDN_SHAREVIOLATION = CDN_FIRST - 3
-CDN_HELP = CDN_FIRST - 4
-CDN_FILEOK = CDN_FIRST - 5
-CDN_TYPECHANGE = CDN_FIRST - 6
-CDN_INCLUDEITEM = CDN_FIRST - 7
-CDM_FIRST = WM_USER + 100
-CDM_LAST = WM_USER + 200
-CDM_GETSPEC = CDM_FIRST + 0
-CDM_GETFILEPATH = CDM_FIRST + 1
-CDM_GETFOLDERPATH = CDM_FIRST + 2
-CDM_GETFOLDERIDLIST = CDM_FIRST + 3
-CDM_SETCONTROLTEXT = CDM_FIRST + 4
-CDM_HIDECONTROL = CDM_FIRST + 5
-CDM_SETDEFEXT = CDM_FIRST + 6
-CC_RGBINIT = 1
-CC_FULLOPEN = 2
-CC_PREVENTFULLOPEN = 4
-CC_SHOWHELP = 8
-CC_ENABLEHOOK = 16
-CC_ENABLETEMPLATE = 32
-CC_ENABLETEMPLATEHANDLE = 64
-CC_SOLIDCOLOR = 128
-CC_ANYCOLOR = 256
-FR_DOWN = 1
-FR_WHOLEWORD = 2
-FR_MATCHCASE = 4
-FR_FINDNEXT = 8
-FR_REPLACE = 16
-FR_REPLACEALL = 32
-FR_DIALOGTERM = 64
-FR_SHOWHELP = 128
-FR_ENABLEHOOK = 256
-FR_ENABLETEMPLATE = 512
-FR_NOUPDOWN = 1024
-FR_NOMATCHCASE = 2048
-FR_NOWHOLEWORD = 4096
-FR_ENABLETEMPLATEHANDLE = 8192
-FR_HIDEUPDOWN = 16384
-FR_HIDEMATCHCASE = 32768
-FR_HIDEWHOLEWORD = 65536
-CF_SCREENFONTS = 1
-CF_PRINTERFONTS = 2
-CF_BOTH = CF_SCREENFONTS | CF_PRINTERFONTS
-CF_SHOWHELP = 4
-CF_ENABLEHOOK = 8
-CF_ENABLETEMPLATE = 16
-CF_ENABLETEMPLATEHANDLE = 32
-CF_INITTOLOGFONTSTRUCT = 64
-CF_USESTYLE = 128
-CF_EFFECTS = 256
-CF_APPLY = 512
-CF_ANSIONLY = 1024
-CF_SCRIPTSONLY = CF_ANSIONLY
-CF_NOVECTORFONTS = 2048
-CF_NOOEMFONTS = CF_NOVECTORFONTS
-CF_NOSIMULATIONS = 4096
-CF_LIMITSIZE = 8192
-CF_FIXEDPITCHONLY = 16384
-CF_WYSIWYG = 32768  # must also have CF_SCREENFONTS & CF_PRINTERFONTS
-CF_FORCEFONTEXIST = 65536
-CF_SCALABLEONLY = 131072
-CF_TTONLY = 262144
-CF_NOFACESEL = 524288
-CF_NOSTYLESEL = 1048576
-CF_NOSIZESEL = 2097152
-CF_SELECTSCRIPT = 4194304
-CF_NOSCRIPTSEL = 8388608
-CF_NOVERTFONTS = 16777216
-SIMULATED_FONTTYPE = 32768
-PRINTER_FONTTYPE = 16384
-SCREEN_FONTTYPE = 8192
-BOLD_FONTTYPE = 256
-ITALIC_FONTTYPE = 512
-REGULAR_FONTTYPE = 1024
-OPENTYPE_FONTTYPE = 65536
-TYPE1_FONTTYPE = 131072
-DSIG_FONTTYPE = 262144
-WM_CHOOSEFONT_GETLOGFONT = WM_USER + 1
-WM_CHOOSEFONT_SETLOGFONT = WM_USER + 101
-WM_CHOOSEFONT_SETFLAGS = WM_USER + 102
-LBSELCHSTRINGA = "commdlg_LBSelChangedNotify"
-SHAREVISTRINGA = "commdlg_ShareViolation"
-FILEOKSTRINGA = "commdlg_FileNameOK"
-COLOROKSTRINGA = "commdlg_ColorOK"
-SETRGBSTRINGA = "commdlg_SetRGBColor"
-HELPMSGSTRINGA = "commdlg_help"
-FINDMSGSTRINGA = "commdlg_FindReplace"
-LBSELCHSTRING = LBSELCHSTRINGA
-SHAREVISTRING = SHAREVISTRINGA
-FILEOKSTRING = FILEOKSTRINGA
-COLOROKSTRING = COLOROKSTRINGA
-SETRGBSTRING = SETRGBSTRINGA
-HELPMSGSTRING = HELPMSGSTRINGA
-FINDMSGSTRING = FINDMSGSTRINGA
-CD_LBSELNOITEMS = -1
-CD_LBSELCHANGE = 0
-CD_LBSELSUB = 1
-CD_LBSELADD = 2
-PD_ALLPAGES = 0
-PD_SELECTION = 1
-PD_PAGENUMS = 2
-PD_NOSELECTION = 4
-PD_NOPAGENUMS = 8
-PD_COLLATE = 16
-PD_PRINTTOFILE = 32
-PD_PRINTSETUP = 64
-PD_NOWARNING = 128
-PD_RETURNDC = 256
-PD_RETURNIC = 512
-PD_RETURNDEFAULT = 1024
-PD_SHOWHELP = 2048
-PD_ENABLEPRINTHOOK = 4096
-PD_ENABLESETUPHOOK = 8192
-PD_ENABLEPRINTTEMPLATE = 16384
-PD_ENABLESETUPTEMPLATE = 32768
-PD_ENABLEPRINTTEMPLATEHANDLE = 65536
-PD_ENABLESETUPTEMPLATEHANDLE = 131072
-PD_USEDEVMODECOPIES = 262144
-PD_DISABLEPRINTTOFILE = 524288
-PD_HIDEPRINTTOFILE = 1048576
-PD_NONETWORKBUTTON = 2097152
-DN_DEFAULTPRN = 1
-WM_PSD_PAGESETUPDLG = WM_USER
-WM_PSD_FULLPAGERECT = WM_USER + 1
-WM_PSD_MINMARGINRECT = WM_USER + 2
-WM_PSD_MARGINRECT = WM_USER + 3
-WM_PSD_GREEKTEXTRECT = WM_USER + 4
-WM_PSD_ENVSTAMPRECT = WM_USER + 5
-WM_PSD_YAFULLPAGERECT = WM_USER + 6
-PSD_DEFAULTMINMARGINS = 0  # default (printer's)
-PSD_INWININIINTLMEASURE = 0  # 1st of 4 possible
-PSD_MINMARGINS = 1  # use caller's
-PSD_MARGINS = 2  # use caller's
-PSD_INTHOUSANDTHSOFINCHES = 4  # 2nd of 4 possible
-PSD_INHUNDREDTHSOFMILLIMETERS = 8  # 3rd of 4 possible
-PSD_DISABLEMARGINS = 16
-PSD_DISABLEPRINTER = 32
-PSD_NOWARNING = 128  # must be same as PD_*
-PSD_DISABLEORIENTATION = 256
-PSD_RETURNDEFAULT = 1024  # must be same as PD_*
-PSD_DISABLEPAPER = 512
-PSD_SHOWHELP = 2048  # must be same as PD_*
-PSD_ENABLEPAGESETUPHOOK = 8192  # must be same as PD_*
-PSD_ENABLEPAGESETUPTEMPLATE = 32768  # must be same as PD_*
-PSD_ENABLEPAGESETUPTEMPLATEHANDLE = 131072  # must be same as PD_*
-PSD_ENABLEPAGEPAINTHOOK = 262144
-PSD_DISABLEPAGEPAINTING = 524288
-PSD_NONETWORKBUTTON = 2097152  # must be same as PD_*
-
-# Generated by h2py from winreg.h
-HKEY_CLASSES_ROOT = -2147483648
-HKEY_CURRENT_USER = -2147483647
-HKEY_LOCAL_MACHINE = -2147483646
-HKEY_USERS = -2147483645
-HKEY_PERFORMANCE_DATA = -2147483644
-HKEY_CURRENT_CONFIG = -2147483643
-HKEY_DYN_DATA = -2147483642
-HKEY_PERFORMANCE_TEXT = -2147483568  # ?? 4Jan98
-HKEY_PERFORMANCE_NLSTEXT = -2147483552  # ?? 4Jan98
-
-# Generated by h2py from winuser.h
-HWND_BROADCAST = 65535
-HWND_DESKTOP = 0
-HWND_TOP = 0
-HWND_BOTTOM = 1
-HWND_TOPMOST = -1
-HWND_NOTOPMOST = -2
-HWND_MESSAGE = -3
-
-# winuser.h line 4601
-SM_CXSCREEN = 0
-SM_CYSCREEN = 1
-SM_CXVSCROLL = 2
-SM_CYHSCROLL = 3
-SM_CYCAPTION = 4
-SM_CXBORDER = 5
-SM_CYBORDER = 6
-SM_CXDLGFRAME = 7
-SM_CYDLGFRAME = 8
-SM_CYVTHUMB = 9
-SM_CXHTHUMB = 10
-SM_CXICON = 11
-SM_CYICON = 12
-SM_CXCURSOR = 13
-SM_CYCURSOR = 14
-SM_CYMENU = 15
-SM_CXFULLSCREEN = 16
-SM_CYFULLSCREEN = 17
-SM_CYKANJIWINDOW = 18
-SM_MOUSEPRESENT = 19
-SM_CYVSCROLL = 20
-SM_CXHSCROLL = 21
-SM_DEBUG = 22
-SM_SWAPBUTTON = 23
-SM_RESERVED1 = 24
-SM_RESERVED2 = 25
-SM_RESERVED3 = 26
-SM_RESERVED4 = 27
-SM_CXMIN = 28
-SM_CYMIN = 29
-SM_CXSIZE = 30
-SM_CYSIZE = 31
-SM_CXFRAME = 32
-SM_CYFRAME = 33
-SM_CXMINTRACK = 34
-SM_CYMINTRACK = 35
-SM_CXDOUBLECLK = 36
-SM_CYDOUBLECLK = 37
-SM_CXICONSPACING = 38
-SM_CYICONSPACING = 39
-SM_MENUDROPALIGNMENT = 40
-SM_PENWINDOWS = 41
-SM_DBCSENABLED = 42
-SM_CMOUSEBUTTONS = 43
-SM_CXFIXEDFRAME = SM_CXDLGFRAME
-SM_CYFIXEDFRAME = SM_CYDLGFRAME
-SM_CXSIZEFRAME = SM_CXFRAME
-SM_CYSIZEFRAME = SM_CYFRAME
-SM_SECURE = 44
-SM_CXEDGE = 45
-SM_CYEDGE = 46
-SM_CXMINSPACING = 47
-SM_CYMINSPACING = 48
-SM_CXSMICON = 49
-SM_CYSMICON = 50
-SM_CYSMCAPTION = 51
-SM_CXSMSIZE = 52
-SM_CYSMSIZE = 53
-SM_CXMENUSIZE = 54
-SM_CYMENUSIZE = 55
-SM_ARRANGE = 56
-SM_CXMINIMIZED = 57
-SM_CYMINIMIZED = 58
-SM_CXMAXTRACK = 59
-SM_CYMAXTRACK = 60
-SM_CXMAXIMIZED = 61
-SM_CYMAXIMIZED = 62
-SM_NETWORK = 63
-SM_CLEANBOOT = 67
-SM_CXDRAG = 68
-SM_CYDRAG = 69
-SM_SHOWSOUNDS = 70
-SM_CXMENUCHECK = 71
-SM_CYMENUCHECK = 72
-SM_SLOWMACHINE = 73
-SM_MIDEASTENABLED = 74
-SM_MOUSEWHEELPRESENT = 75
-SM_XVIRTUALSCREEN = 76
-SM_YVIRTUALSCREEN = 77
-SM_CXVIRTUALSCREEN = 78
-SM_CYVIRTUALSCREEN = 79
-SM_CMONITORS = 80
-SM_SAMEDISPLAYFORMAT = 81
-SM_CMETRICS = 83
-MNC_IGNORE = 0
-MNC_CLOSE = 1
-MNC_EXECUTE = 2
-MNC_SELECT = 3
-MNS_NOCHECK = -2147483648
-MNS_MODELESS = 1073741824
-MNS_DRAGDROP = 536870912
-MNS_AUTODISMISS = 268435456
-MNS_NOTIFYBYPOS = 134217728
-MNS_CHECKORBMP = 67108864
-MIM_MAXHEIGHT = 1
-MIM_BACKGROUND = 2
-MIM_HELPID = 4
-MIM_MENUDATA = 8
-MIM_STYLE = 16
-MIM_APPLYTOSUBMENUS = -2147483648
-MND_CONTINUE = 0
-MND_ENDMENU = 1
-MNGOF_GAP = 3
-MNGO_NOINTERFACE = 0
-MNGO_NOERROR = 1
-MIIM_STATE = 1
-MIIM_ID = 2
-MIIM_SUBMENU = 4
-MIIM_CHECKMARKS = 8
-MIIM_TYPE = 16
-MIIM_DATA = 32
-MIIM_STRING = 64
-MIIM_BITMAP = 128
-MIIM_FTYPE = 256
-HBMMENU_CALLBACK = -1
-HBMMENU_SYSTEM = 1
-HBMMENU_MBAR_RESTORE = 2
-HBMMENU_MBAR_MINIMIZE = 3
-HBMMENU_MBAR_CLOSE = 5
-HBMMENU_MBAR_CLOSE_D = 6
-HBMMENU_MBAR_MINIMIZE_D = 7
-HBMMENU_POPUP_CLOSE = 8
-HBMMENU_POPUP_RESTORE = 9
-HBMMENU_POPUP_MAXIMIZE = 10
-HBMMENU_POPUP_MINIMIZE = 11
-GMDI_USEDISABLED = 1
-GMDI_GOINTOPOPUPS = 2
-TPM_LEFTBUTTON = 0
-TPM_RIGHTBUTTON = 2
-TPM_LEFTALIGN = 0
-TPM_CENTERALIGN = 4
-TPM_RIGHTALIGN = 8
-TPM_TOPALIGN = 0
-TPM_VCENTERALIGN = 16
-TPM_BOTTOMALIGN = 32
-TPM_HORIZONTAL = 0
-TPM_VERTICAL = 64
-TPM_NONOTIFY = 128
-TPM_RETURNCMD = 256
-TPM_RECURSE = 1
-DOF_EXECUTABLE = 32769
-DOF_DOCUMENT = 32770
-DOF_DIRECTORY = 32771
-DOF_MULTIPLE = 32772
-DOF_PROGMAN = 1
-DOF_SHELLDATA = 2
-DO_DROPFILE = 1162627398
-DO_PRINTFILE = 1414419024
-DT_TOP = 0
-DT_LEFT = 0
-DT_CENTER = 1
-DT_RIGHT = 2
-DT_VCENTER = 4
-DT_BOTTOM = 8
-DT_WORDBREAK = 16
-DT_SINGLELINE = 32
-DT_EXPANDTABS = 64
-DT_TABSTOP = 128
-DT_NOCLIP = 256
-DT_EXTERNALLEADING = 512
-DT_CALCRECT = 1024
-DT_NOPREFIX = 2048
-DT_INTERNAL = 4096
-DT_EDITCONTROL = 8192
-DT_PATH_ELLIPSIS = 16384
-DT_END_ELLIPSIS = 32768
-DT_MODIFYSTRING = 65536
-DT_RTLREADING = 131072
-DT_WORD_ELLIPSIS = 262144
-DST_COMPLEX = 0
-DST_TEXT = 1
-DST_PREFIXTEXT = 2
-DST_ICON = 3
-DST_BITMAP = 4
-DSS_NORMAL = 0
-DSS_UNION = 16
-DSS_DISABLED = 32
-DSS_MONO = 128
-DSS_RIGHT = 32768
-DCX_WINDOW = 1
-DCX_CACHE = 2
-DCX_NORESETATTRS = 4
-DCX_CLIPCHILDREN = 8
-DCX_CLIPSIBLINGS = 16
-DCX_PARENTCLIP = 32
-DCX_EXCLUDERGN = 64
-DCX_INTERSECTRGN = 128
-DCX_EXCLUDEUPDATE = 256
-DCX_INTERSECTUPDATE = 512
-DCX_LOCKWINDOWUPDATE = 1024
-DCX_VALIDATE = 2097152
-CUDR_NORMAL = 0
-CUDR_NOSNAPTOGRID = 1
-CUDR_NORESOLVEPOSITIONS = 2
-CUDR_NOCLOSEGAPS = 4
-CUDR_NEGATIVECOORDS = 8
-CUDR_NOPRIMARY = 16
-RDW_INVALIDATE = 1
-RDW_INTERNALPAINT = 2
-RDW_ERASE = 4
-RDW_VALIDATE = 8
-RDW_NOINTERNALPAINT = 16
-RDW_NOERASE = 32
-RDW_NOCHILDREN = 64
-RDW_ALLCHILDREN = 128
-RDW_UPDATENOW = 256
-RDW_ERASENOW = 512
-RDW_FRAME = 1024
-RDW_NOFRAME = 2048
-SW_SCROLLCHILDREN = 1
-SW_INVALIDATE = 2
-SW_ERASE = 4
-SW_SMOOTHSCROLL = 16  # Use smooth scrolling
-ESB_ENABLE_BOTH = 0
-ESB_DISABLE_BOTH = 3
-ESB_DISABLE_LEFT = 1
-ESB_DISABLE_RIGHT = 2
-ESB_DISABLE_UP = 1
-ESB_DISABLE_DOWN = 2
-ESB_DISABLE_LTUP = ESB_DISABLE_LEFT
-ESB_DISABLE_RTDN = ESB_DISABLE_RIGHT
-HELPINFO_WINDOW = 1
-HELPINFO_MENUITEM = 2
-MB_OK = 0
-MB_OKCANCEL = 1
-MB_ABORTRETRYIGNORE = 2
-MB_YESNOCANCEL = 3
-MB_YESNO = 4
-MB_RETRYCANCEL = 5
-MB_ICONHAND = 16
-MB_ICONQUESTION = 32
-MB_ICONEXCLAMATION = 48
-MB_ICONASTERISK = 64
-MB_ICONWARNING = MB_ICONEXCLAMATION
-MB_ICONERROR = MB_ICONHAND
-MB_ICONINFORMATION = MB_ICONASTERISK
-MB_ICONSTOP = MB_ICONHAND
-MB_DEFBUTTON1 = 0
-MB_DEFBUTTON2 = 256
-MB_DEFBUTTON3 = 512
-MB_DEFBUTTON4 = 768
-MB_APPLMODAL = 0
-MB_SYSTEMMODAL = 4096
-MB_TASKMODAL = 8192
-MB_HELP = 16384
-MB_NOFOCUS = 32768
-MB_SETFOREGROUND = 65536
-MB_DEFAULT_DESKTOP_ONLY = 131072
-MB_TOPMOST = 262144
-MB_RIGHT = 524288
-MB_RTLREADING = 1048576
-MB_SERVICE_NOTIFICATION = 2097152
-MB_TYPEMASK = 15
-MB_USERICON = 128
-MB_ICONMASK = 240
-MB_DEFMASK = 3840
-MB_MODEMASK = 12288
-MB_MISCMASK = 49152
-# winuser.h line 6373
-CWP_ALL = 0
-CWP_SKIPINVISIBLE = 1
-CWP_SKIPDISABLED = 2
-CWP_SKIPTRANSPARENT = 4
-CTLCOLOR_MSGBOX = 0
-CTLCOLOR_EDIT = 1
-CTLCOLOR_LISTBOX = 2
-CTLCOLOR_BTN = 3
-CTLCOLOR_DLG = 4
-CTLCOLOR_SCROLLBAR = 5
-CTLCOLOR_STATIC = 6
-CTLCOLOR_MAX = 7
-COLOR_SCROLLBAR = 0
-COLOR_BACKGROUND = 1
-COLOR_ACTIVECAPTION = 2
-COLOR_INACTIVECAPTION = 3
-COLOR_MENU = 4
-COLOR_WINDOW = 5
-COLOR_WINDOWFRAME = 6
-COLOR_MENUTEXT = 7
-COLOR_WINDOWTEXT = 8
-COLOR_CAPTIONTEXT = 9
-COLOR_ACTIVEBORDER = 10
-COLOR_INACTIVEBORDER = 11
-COLOR_APPWORKSPACE = 12
-COLOR_HIGHLIGHT = 13
-COLOR_HIGHLIGHTTEXT = 14
-COLOR_BTNFACE = 15
-COLOR_BTNSHADOW = 16
-COLOR_GRAYTEXT = 17
-COLOR_BTNTEXT = 18
-COLOR_INACTIVECAPTIONTEXT = 19
-COLOR_BTNHIGHLIGHT = 20
-COLOR_3DDKSHADOW = 21
-COLOR_3DLIGHT = 22
-COLOR_INFOTEXT = 23
-COLOR_INFOBK = 24
-COLOR_HOTLIGHT = 26
-COLOR_GRADIENTACTIVECAPTION = 27
-COLOR_GRADIENTINACTIVECAPTION = 28
-COLOR_DESKTOP = COLOR_BACKGROUND
-COLOR_3DFACE = COLOR_BTNFACE
-COLOR_3DSHADOW = COLOR_BTNSHADOW
-COLOR_3DHIGHLIGHT = COLOR_BTNHIGHLIGHT
-COLOR_3DHILIGHT = COLOR_BTNHIGHLIGHT
-COLOR_BTNHILIGHT = COLOR_BTNHIGHLIGHT
-GW_HWNDFIRST = 0
-GW_HWNDLAST = 1
-GW_HWNDNEXT = 2
-GW_HWNDPREV = 3
-GW_OWNER = 4
-GW_CHILD = 5
-GW_ENABLEDPOPUP = 6
-GW_MAX = 6
-MF_INSERT = 0
-MF_CHANGE = 128
-MF_APPEND = 256
-MF_DELETE = 512
-MF_REMOVE = 4096
-MF_BYCOMMAND = 0
-MF_BYPOSITION = 1024
-MF_SEPARATOR = 2048
-MF_ENABLED = 0
-MF_GRAYED = 1
-MF_DISABLED = 2
-MF_UNCHECKED = 0
-MF_CHECKED = 8
-MF_USECHECKBITMAPS = 512
-MF_STRING = 0
-MF_BITMAP = 4
-MF_OWNERDRAW = 256
-MF_POPUP = 16
-MF_MENUBARBREAK = 32
-MF_MENUBREAK = 64
-MF_UNHILITE = 0
-MF_HILITE = 128
-MF_DEFAULT = 4096
-MF_SYSMENU = 8192
-MF_HELP = 16384
-MF_RIGHTJUSTIFY = 16384
-MF_MOUSESELECT = 32768
-MF_END = 128
-MFT_STRING = MF_STRING
-MFT_BITMAP = MF_BITMAP
-MFT_MENUBARBREAK = MF_MENUBARBREAK
-MFT_MENUBREAK = MF_MENUBREAK
-MFT_OWNERDRAW = MF_OWNERDRAW
-MFT_RADIOCHECK = 512
-MFT_SEPARATOR = MF_SEPARATOR
-MFT_RIGHTORDER = 8192
-MFT_RIGHTJUSTIFY = MF_RIGHTJUSTIFY
-MFS_GRAYED = 3
-MFS_DISABLED = MFS_GRAYED
-MFS_CHECKED = MF_CHECKED
-MFS_HILITE = MF_HILITE
-MFS_ENABLED = MF_ENABLED
-MFS_UNCHECKED = MF_UNCHECKED
-MFS_UNHILITE = MF_UNHILITE
-MFS_DEFAULT = MF_DEFAULT
-MFS_MASK = 4235
-MFS_HOTTRACKDRAWN = 268435456
-MFS_CACHEDBMP = 536870912
-MFS_BOTTOMGAPDROP = 1073741824
-MFS_TOPGAPDROP = -2147483648
-MFS_GAPDROP = -1073741824
-SC_SIZE = 61440
-SC_MOVE = 61456
-SC_MINIMIZE = 61472
-SC_MAXIMIZE = 61488
-SC_NEXTWINDOW = 61504
-SC_PREVWINDOW = 61520
-SC_CLOSE = 61536
-SC_VSCROLL = 61552
-SC_HSCROLL = 61568
-SC_MOUSEMENU = 61584
-SC_KEYMENU = 61696
-SC_ARRANGE = 61712
-SC_RESTORE = 61728
-SC_TASKLIST = 61744
-SC_SCREENSAVE = 61760
-SC_HOTKEY = 61776
-SC_DEFAULT = 61792
-SC_MONITORPOWER = 61808
-SC_CONTEXTHELP = 61824
-SC_SEPARATOR = 61455
-SC_ICON = SC_MINIMIZE
-SC_ZOOM = SC_MAXIMIZE
-IDC_ARROW = 32512
-IDC_IBEAM = 32513
-IDC_WAIT = 32514
-IDC_CROSS = 32515
-IDC_UPARROW = 32516
-IDC_SIZE = 32640  # OBSOLETE: use IDC_SIZEALL
-IDC_ICON = 32641  # OBSOLETE: use IDC_ARROW
-IDC_SIZENWSE = 32642
-IDC_SIZENESW = 32643
-IDC_SIZEWE = 32644
-IDC_SIZENS = 32645
-IDC_SIZEALL = 32646
-IDC_NO = 32648
-IDC_HAND = 32649
-IDC_APPSTARTING = 32650
-IDC_HELP = 32651
-IMAGE_BITMAP = 0
-IMAGE_ICON = 1
-IMAGE_CURSOR = 2
-IMAGE_ENHMETAFILE = 3
-LR_DEFAULTCOLOR = 0
-LR_MONOCHROME = 1
-LR_COLOR = 2
-LR_COPYRETURNORG = 4
-LR_COPYDELETEORG = 8
-LR_LOADFROMFILE = 16
-LR_LOADTRANSPARENT = 32
-LR_DEFAULTSIZE = 64
-LR_LOADREALSIZE = 128
-LR_LOADMAP3DCOLORS = 4096
-LR_CREATEDIBSECTION = 8192
-LR_COPYFROMRESOURCE = 16384
-LR_SHARED = 32768
-DI_MASK = 1
-DI_IMAGE = 2
-DI_NORMAL = 3
-DI_COMPAT = 4
-DI_DEFAULTSIZE = 8
-RES_ICON = 1
-RES_CURSOR = 2
-OBM_CLOSE = 32754
-OBM_UPARROW = 32753
-OBM_DNARROW = 32752
-OBM_RGARROW = 32751
-OBM_LFARROW = 32750
-OBM_REDUCE = 32749
-OBM_ZOOM = 32748
-OBM_RESTORE = 32747
-OBM_REDUCED = 32746
-OBM_ZOOMD = 32745
-OBM_RESTORED = 32744
-OBM_UPARROWD = 32743
-OBM_DNARROWD = 32742
-OBM_RGARROWD = 32741
-OBM_LFARROWD = 32740
-OBM_MNARROW = 32739
-OBM_COMBO = 32738
-OBM_UPARROWI = 32737
-OBM_DNARROWI = 32736
-OBM_RGARROWI = 32735
-OBM_LFARROWI = 32734
-OBM_OLD_CLOSE = 32767
-OBM_SIZE = 32766
-OBM_OLD_UPARROW = 32765
-OBM_OLD_DNARROW = 32764
-OBM_OLD_RGARROW = 32763
-OBM_OLD_LFARROW = 32762
-OBM_BTSIZE = 32761
-OBM_CHECK = 32760
-OBM_CHECKBOXES = 32759
-OBM_BTNCORNERS = 32758
-OBM_OLD_REDUCE = 32757
-OBM_OLD_ZOOM = 32756
-OBM_OLD_RESTORE = 32755
-OCR_NORMAL = 32512
-OCR_IBEAM = 32513
-OCR_WAIT = 32514
-OCR_CROSS = 32515
-OCR_UP = 32516
-OCR_SIZE = 32640
-OCR_ICON = 32641
-OCR_SIZENWSE = 32642
-OCR_SIZENESW = 32643
-OCR_SIZEWE = 32644
-OCR_SIZENS = 32645
-OCR_SIZEALL = 32646
-OCR_ICOCUR = 32647
-OCR_NO = 32648
-OCR_HAND = 32649
-OCR_APPSTARTING = 32650
-# winuser.h line 7455
-OIC_SAMPLE = 32512
-OIC_HAND = 32513
-OIC_QUES = 32514
-OIC_BANG = 32515
-OIC_NOTE = 32516
-OIC_WINLOGO = 32517
-OIC_WARNING = OIC_BANG
-OIC_ERROR = OIC_HAND
-OIC_INFORMATION = OIC_NOTE
-ORD_LANGDRIVER = 1
-IDI_APPLICATION = 32512
-IDI_HAND = 32513
-IDI_QUESTION = 32514
-IDI_EXCLAMATION = 32515
-IDI_ASTERISK = 32516
-IDI_WINLOGO = 32517
-IDI_WARNING = IDI_EXCLAMATION
-IDI_ERROR = IDI_HAND
-IDI_INFORMATION = IDI_ASTERISK
-IDOK = 1
-IDCANCEL = 2
-IDABORT = 3
-IDRETRY = 4
-IDIGNORE = 5
-IDYES = 6
-IDNO = 7
-IDCLOSE = 8
-IDHELP = 9
-ES_LEFT = 0
-ES_CENTER = 1
-ES_RIGHT = 2
-ES_MULTILINE = 4
-ES_UPPERCASE = 8
-ES_LOWERCASE = 16
-ES_PASSWORD = 32
-ES_AUTOVSCROLL = 64
-ES_AUTOHSCROLL = 128
-ES_NOHIDESEL = 256
-ES_OEMCONVERT = 1024
-ES_READONLY = 2048
-ES_WANTRETURN = 4096
-ES_NUMBER = 8192
-EN_SETFOCUS = 256
-EN_KILLFOCUS = 512
-EN_CHANGE = 768
-EN_UPDATE = 1024
-EN_ERRSPACE = 1280
-EN_MAXTEXT = 1281
-EN_HSCROLL = 1537
-EN_VSCROLL = 1538
-EC_LEFTMARGIN = 1
-EC_RIGHTMARGIN = 2
-EC_USEFONTINFO = 65535
-EMSIS_COMPOSITIONSTRING = 1
-EIMES_GETCOMPSTRATONCE = 1
-EIMES_CANCELCOMPSTRINFOCUS = 2
-EIMES_COMPLETECOMPSTRKILLFOCUS = 4
-EM_GETSEL = 176
-EM_SETSEL = 177
-EM_GETRECT = 178
-EM_SETRECT = 179
-EM_SETRECTNP = 180
-EM_SCROLL = 181
-EM_LINESCROLL = 182
-EM_SCROLLCARET = 183
-EM_GETMODIFY = 184
-EM_SETMODIFY = 185
-EM_GETLINECOUNT = 186
-EM_LINEINDEX = 187
-EM_SETHANDLE = 188
-EM_GETHANDLE = 189
-EM_GETTHUMB = 190
-EM_LINELENGTH = 193
-EM_REPLACESEL = 194
-EM_GETLINE = 196
-EM_LIMITTEXT = 197
-EM_CANUNDO = 198
-EM_UNDO = 199
-EM_FMTLINES = 200
-EM_LINEFROMCHAR = 201
-EM_SETTABSTOPS = 203
-EM_SETPASSWORDCHAR = 204
-EM_EMPTYUNDOBUFFER = 205
-EM_GETFIRSTVISIBLELINE = 206
-EM_SETREADONLY = 207
-EM_SETWORDBREAKPROC = 208
-EM_GETWORDBREAKPROC = 209
-EM_GETPASSWORDCHAR = 210
-EM_SETMARGINS = 211
-EM_GETMARGINS = 212
-EM_SETLIMITTEXT = EM_LIMITTEXT
-EM_GETLIMITTEXT = 213
-EM_POSFROMCHAR = 214
-EM_CHARFROMPOS = 215
-EM_SETIMESTATUS = 216
-EM_GETIMESTATUS = 217
-WB_LEFT = 0
-WB_RIGHT = 1
-WB_ISDELIMITER = 2
-BS_PUSHBUTTON = 0
-BS_DEFPUSHBUTTON = 1
-BS_CHECKBOX = 2
-BS_AUTOCHECKBOX = 3
-BS_RADIOBUTTON = 4
-BS_3STATE = 5
-BS_AUTO3STATE = 6
-BS_GROUPBOX = 7
-BS_USERBUTTON = 8
-BS_AUTORADIOBUTTON = 9
-BS_OWNERDRAW = 11
-BS_LEFTTEXT = 32
-BS_TEXT = 0
-BS_ICON = 64
-BS_BITMAP = 128
-BS_LEFT = 256
-BS_RIGHT = 512
-BS_CENTER = 768
-BS_TOP = 1024
-BS_BOTTOM = 2048
-BS_VCENTER = 3072
-BS_PUSHLIKE = 4096
-BS_MULTILINE = 8192
-BS_NOTIFY = 16384
-BS_FLAT = 32768
-BS_RIGHTBUTTON = BS_LEFTTEXT
-BN_CLICKED = 0
-BN_PAINT = 1
-BN_HILITE = 2
-BN_UNHILITE = 3
-BN_DISABLE = 4
-BN_DOUBLECLICKED = 5
-BN_PUSHED = BN_HILITE
-BN_UNPUSHED = BN_UNHILITE
-BN_DBLCLK = BN_DOUBLECLICKED
-BN_SETFOCUS = 6
-BN_KILLFOCUS = 7
-BM_GETCHECK = 240
-BM_SETCHECK = 241
-BM_GETSTATE = 242
-BM_SETSTATE = 243
-BM_SETSTYLE = 244
-BM_CLICK = 245
-BM_GETIMAGE = 246
-BM_SETIMAGE = 247
-BST_UNCHECKED = 0
-BST_CHECKED = 1
-BST_INDETERMINATE = 2
-BST_PUSHED = 4
-BST_FOCUS = 8
-SS_LEFT = 0
-SS_CENTER = 1
-SS_RIGHT = 2
-SS_ICON = 3
-SS_BLACKRECT = 4
-SS_GRAYRECT = 5
-SS_WHITERECT = 6
-SS_BLACKFRAME = 7
-SS_GRAYFRAME = 8
-SS_WHITEFRAME = 9
-SS_USERITEM = 10
-SS_SIMPLE = 11
-SS_LEFTNOWORDWRAP = 12
-SS_BITMAP = 14
-SS_OWNERDRAW = 13
-SS_ENHMETAFILE = 15
-SS_ETCHEDHORZ = 16
-SS_ETCHEDVERT = 17
-SS_ETCHEDFRAME = 18
-SS_TYPEMASK = 31
-SS_NOPREFIX = 128
-SS_NOTIFY = 256
-SS_CENTERIMAGE = 512
-SS_RIGHTJUST = 1024
-SS_REALSIZEIMAGE = 2048
-SS_SUNKEN = 4096
-SS_ENDELLIPSIS = 16384
-SS_PATHELLIPSIS = 32768
-SS_WORDELLIPSIS = 49152
-SS_ELLIPSISMASK = 49152
-STM_SETICON = 368
-STM_GETICON = 369
-STM_SETIMAGE = 370
-STM_GETIMAGE = 371
-STN_CLICKED = 0
-STN_DBLCLK = 1
-STN_ENABLE = 2
-STN_DISABLE = 3
-STM_MSGMAX = 372
-DWL_MSGRESULT = 0
-DWL_DLGPROC = 4
-DWL_USER = 8
-DDL_READWRITE = 0
-DDL_READONLY = 1
-DDL_HIDDEN = 2
-DDL_SYSTEM = 4
-DDL_DIRECTORY = 16
-DDL_ARCHIVE = 32
-DDL_POSTMSGS = 8192
-DDL_DRIVES = 16384
-DDL_EXCLUSIVE = 32768
-
-# from winuser.h line 153
-RT_CURSOR = 1
-RT_BITMAP = 2
-RT_ICON = 3
-RT_MENU = 4
-RT_DIALOG = 5
-RT_STRING = 6
-RT_FONTDIR = 7
-RT_FONT = 8
-RT_ACCELERATOR = 9
-RT_RCDATA = 10
-RT_MESSAGETABLE = 11
-DIFFERENCE = 11
-RT_GROUP_CURSOR = RT_CURSOR + DIFFERENCE
-RT_GROUP_ICON = RT_ICON + DIFFERENCE
-RT_VERSION = 16
-RT_DLGINCLUDE = 17
-RT_PLUGPLAY = 19
-RT_VXD = 20
-RT_ANICURSOR = 21
-RT_ANIICON = 22
-RT_HTML = 23
-# from winuser.h line 218
-SB_HORZ = 0
-SB_VERT = 1
-SB_CTL = 2
-SB_BOTH = 3
-SB_LINEUP = 0
-SB_LINELEFT = 0
-SB_LINEDOWN = 1
-SB_LINERIGHT = 1
-SB_PAGEUP = 2
-SB_PAGELEFT = 2
-SB_PAGEDOWN = 3
-SB_PAGERIGHT = 3
-SB_THUMBPOSITION = 4
-SB_THUMBTRACK = 5
-SB_TOP = 6
-SB_LEFT = 6
-SB_BOTTOM = 7
-SB_RIGHT = 7
-SB_ENDSCROLL = 8
-SW_HIDE = 0
-SW_SHOWNORMAL = 1
-SW_NORMAL = 1
-SW_SHOWMINIMIZED = 2
-SW_SHOWMAXIMIZED = 3
-SW_MAXIMIZE = 3
-SW_SHOWNOACTIVATE = 4
-SW_SHOW = 5
-SW_MINIMIZE = 6
-SW_SHOWMINNOACTIVE = 7
-SW_SHOWNA = 8
-SW_RESTORE = 9
-SW_SHOWDEFAULT = 10
-SW_FORCEMINIMIZE = 11
-SW_MAX = 11
-HIDE_WINDOW = 0
-SHOW_OPENWINDOW = 1
-SHOW_ICONWINDOW = 2
-SHOW_FULLSCREEN = 3
-SHOW_OPENNOACTIVATE = 4
-SW_PARENTCLOSING = 1
-SW_OTHERZOOM = 2
-SW_PARENTOPENING = 3
-SW_OTHERUNZOOM = 4
-AW_HOR_POSITIVE = 1
-AW_HOR_NEGATIVE = 2
-AW_VER_POSITIVE = 4
-AW_VER_NEGATIVE = 8
-AW_CENTER = 16
-AW_HIDE = 65536
-AW_ACTIVATE = 131072
-AW_SLIDE = 262144
-AW_BLEND = 524288
-KF_EXTENDED = 256
-KF_DLGMODE = 2048
-KF_MENUMODE = 4096
-KF_ALTDOWN = 8192
-KF_REPEAT = 16384
-KF_UP = 32768
-VK_LBUTTON = 1
-VK_RBUTTON = 2
-VK_CANCEL = 3
-VK_MBUTTON = 4
-VK_BACK = 8
-VK_TAB = 9
-VK_CLEAR = 12
-VK_RETURN = 13
-VK_SHIFT = 16
-VK_CONTROL = 17
-VK_MENU = 18
-VK_PAUSE = 19
-VK_CAPITAL = 20
-VK_KANA = 21
-VK_HANGEUL = 21  # old name - should be here for compatibility
-VK_HANGUL = 21
-VK_JUNJA = 23
-VK_FINAL = 24
-VK_HANJA = 25
-VK_KANJI = 25
-VK_ESCAPE = 27
-VK_CONVERT = 28
-VK_NONCONVERT = 29
-VK_ACCEPT = 30
-VK_MODECHANGE = 31
-VK_SPACE = 32
-VK_PRIOR = 33
-VK_NEXT = 34
-VK_END = 35
-VK_HOME = 36
-VK_LEFT = 37
-VK_UP = 38
-VK_RIGHT = 39
-VK_DOWN = 40
-VK_SELECT = 41
-VK_PRINT = 42
-VK_EXECUTE = 43
-VK_SNAPSHOT = 44
-VK_INSERT = 45
-VK_DELETE = 46
-VK_HELP = 47
-VK_LWIN = 91
-VK_RWIN = 92
-VK_APPS = 93
-VK_NUMPAD0 = 96
-VK_NUMPAD1 = 97
-VK_NUMPAD2 = 98
-VK_NUMPAD3 = 99
-VK_NUMPAD4 = 100
-VK_NUMPAD5 = 101
-VK_NUMPAD6 = 102
-VK_NUMPAD7 = 103
-VK_NUMPAD8 = 104
-VK_NUMPAD9 = 105
-VK_MULTIPLY = 106
-VK_ADD = 107
-VK_SEPARATOR = 108
-VK_SUBTRACT = 109
-VK_DECIMAL = 110
-VK_DIVIDE = 111
-VK_F1 = 112
-VK_F2 = 113
-VK_F3 = 114
-VK_F4 = 115
-VK_F5 = 116
-VK_F6 = 117
-VK_F7 = 118
-VK_F8 = 119
-VK_F9 = 120
-VK_F10 = 121
-VK_F11 = 122
-VK_F12 = 123
-VK_F13 = 124
-VK_F14 = 125
-VK_F15 = 126
-VK_F16 = 127
-VK_F17 = 128
-VK_F18 = 129
-VK_F19 = 130
-VK_F20 = 131
-VK_F21 = 132
-VK_F22 = 133
-VK_F23 = 134
-VK_F24 = 135
-VK_NUMLOCK = 144
-VK_SCROLL = 145
-VK_LSHIFT = 160
-VK_RSHIFT = 161
-VK_LCONTROL = 162
-VK_RCONTROL = 163
-VK_LMENU = 164
-VK_RMENU = 165
-VK_PROCESSKEY = 229
-VK_ATTN = 246
-VK_CRSEL = 247
-VK_EXSEL = 248
-VK_EREOF = 249
-VK_PLAY = 250
-VK_ZOOM = 251
-VK_NONAME = 252
-VK_PA1 = 253
-VK_OEM_CLEAR = 254
-# multi-media related "keys"
-MOUSEEVENTF_XDOWN = 0x0080
-MOUSEEVENTF_XUP = 0x0100
-MOUSEEVENTF_WHEEL = 0x0800
-VK_XBUTTON1 = 0x05
-VK_XBUTTON2 = 0x06
-VK_VOLUME_MUTE = 0xAD
-VK_VOLUME_DOWN = 0xAE
-VK_VOLUME_UP = 0xAF
-VK_MEDIA_NEXT_TRACK = 0xB0
-VK_MEDIA_PREV_TRACK = 0xB1
-VK_MEDIA_PLAY_PAUSE = 0xB3
-VK_BROWSER_BACK = 0xA6
-VK_BROWSER_FORWARD = 0xA7
-WH_MIN = -1
-WH_MSGFILTER = -1
-WH_JOURNALRECORD = 0
-WH_JOURNALPLAYBACK = 1
-WH_KEYBOARD = 2
-WH_GETMESSAGE = 3
-WH_CALLWNDPROC = 4
-WH_CBT = 5
-WH_SYSMSGFILTER = 6
-WH_MOUSE = 7
-WH_HARDWARE = 8
-WH_DEBUG = 9
-WH_SHELL = 10
-WH_FOREGROUNDIDLE = 11
-WH_CALLWNDPROCRET = 12
-WH_KEYBOARD_LL = 13
-WH_MOUSE_LL = 14
-WH_MAX = 14
-WH_MINHOOK = WH_MIN
-WH_MAXHOOK = WH_MAX
-HC_ACTION = 0
-HC_GETNEXT = 1
-HC_SKIP = 2
-HC_NOREMOVE = 3
-HC_NOREM = HC_NOREMOVE
-HC_SYSMODALON = 4
-HC_SYSMODALOFF = 5
-HCBT_MOVESIZE = 0
-HCBT_MINMAX = 1
-HCBT_QS = 2
-HCBT_CREATEWND = 3
-HCBT_DESTROYWND = 4
-HCBT_ACTIVATE = 5
-HCBT_CLICKSKIPPED = 6
-HCBT_KEYSKIPPED = 7
-HCBT_SYSCOMMAND = 8
-HCBT_SETFOCUS = 9
-MSGF_DIALOGBOX = 0
-MSGF_MESSAGEBOX = 1
-MSGF_MENU = 2
-# MSGF_MOVE = 3
-# MSGF_SIZE = 4
-MSGF_SCROLLBAR = 5
-MSGF_NEXTWINDOW = 6
-# MSGF_MAINLOOP = 8
-MSGF_MAX = 8
-MSGF_USER = 4096
-HSHELL_WINDOWCREATED = 1
-HSHELL_WINDOWDESTROYED = 2
-HSHELL_ACTIVATESHELLWINDOW = 3
-HSHELL_WINDOWACTIVATED = 4
-HSHELL_GETMINRECT = 5
-HSHELL_REDRAW = 6
-HSHELL_TASKMAN = 7
-HSHELL_LANGUAGE = 8
-HSHELL_ACCESSIBILITYSTATE = 11
-ACCESS_STICKYKEYS = 1
-ACCESS_FILTERKEYS = 2
-ACCESS_MOUSEKEYS = 3
-# winuser.h line 624
-LLKHF_EXTENDED = 1
-LLKHF_INJECTED = 16
-LLKHF_ALTDOWN = 32
-LLKHF_UP = 128
-LLKHF_LOWER_IL_INJECTED = 2
-LLMHF_INJECTED = 1
-LLMHF_LOWER_IL_INJECTED = 2
-# line 692
-HKL_PREV = 0
-HKL_NEXT = 1
-KLF_ACTIVATE = 1
-KLF_SUBSTITUTE_OK = 2
-KLF_UNLOADPREVIOUS = 4
-KLF_REORDER = 8
-KLF_REPLACELANG = 16
-KLF_NOTELLSHELL = 128
-KLF_SETFORPROCESS = 256
-KL_NAMELENGTH = 9
-DESKTOP_READOBJECTS = 1
-DESKTOP_CREATEWINDOW = 2
-DESKTOP_CREATEMENU = 4
-DESKTOP_HOOKCONTROL = 8
-DESKTOP_JOURNALRECORD = 16
-DESKTOP_JOURNALPLAYBACK = 32
-DESKTOP_ENUMERATE = 64
-DESKTOP_WRITEOBJECTS = 128
-DESKTOP_SWITCHDESKTOP = 256
-DF_ALLOWOTHERACCOUNTHOOK = 1
-WINSTA_ENUMDESKTOPS = 1
-WINSTA_READATTRIBUTES = 2
-WINSTA_ACCESSCLIPBOARD = 4
-WINSTA_CREATEDESKTOP = 8
-WINSTA_WRITEATTRIBUTES = 16
-WINSTA_ACCESSGLOBALATOMS = 32
-WINSTA_EXITWINDOWS = 64
-WINSTA_ENUMERATE = 256
-WINSTA_READSCREEN = 512
-WSF_VISIBLE = 1
-UOI_FLAGS = 1
-UOI_NAME = 2
-UOI_TYPE = 3
-UOI_USER_SID = 4
-GWL_WNDPROC = -4
-GWL_HINSTANCE = -6
-GWL_HWNDPARENT = -8
-GWL_STYLE = -16
-GWL_EXSTYLE = -20
-GWL_USERDATA = -21
-GWL_ID = -12
-GCL_MENUNAME = -8
-GCL_HBRBACKGROUND = -10
-GCL_HCURSOR = -12
-GCL_HICON = -14
-GCL_HMODULE = -16
-GCL_CBWNDEXTRA = -18
-GCL_CBCLSEXTRA = -20
-GCL_WNDPROC = -24
-GCL_STYLE = -26
-GCW_ATOM = -32
-GCL_HICONSM = -34
-# line 1291
-WM_NULL = 0
-WM_CREATE = 1
-WM_DESTROY = 2
-WM_MOVE = 3
-WM_SIZE = 5
-WM_ACTIVATE = 6
-WA_INACTIVE = 0
-WA_ACTIVE = 1
-WA_CLICKACTIVE = 2
-WM_SETFOCUS = 7
-WM_KILLFOCUS = 8
-WM_ENABLE = 10
-WM_SETREDRAW = 11
-WM_SETTEXT = 12
-WM_GETTEXT = 13
-WM_GETTEXTLENGTH = 14
-WM_PAINT = 15
-WM_CLOSE = 16
-WM_QUERYENDSESSION = 17
-WM_QUIT = 18
-WM_QUERYOPEN = 19
-WM_ERASEBKGND = 20
-WM_SYSCOLORCHANGE = 21
-WM_ENDSESSION = 22
-WM_SHOWWINDOW = 24
-WM_WININICHANGE = 26
-WM_SETTINGCHANGE = WM_WININICHANGE
-WM_DEVMODECHANGE = 27
-WM_ACTIVATEAPP = 28
-WM_FONTCHANGE = 29
-WM_TIMECHANGE = 30
-WM_CANCELMODE = 31
-WM_SETCURSOR = 32
-WM_MOUSEACTIVATE = 33
-WM_CHILDACTIVATE = 34
-WM_QUEUESYNC = 35
-WM_GETMINMAXINFO = 36
-WM_PAINTICON = 38
-WM_ICONERASEBKGND = 39
-WM_NEXTDLGCTL = 40
-WM_SPOOLERSTATUS = 42
-WM_DRAWITEM = 43
-WM_MEASUREITEM = 44
-WM_DELETEITEM = 45
-WM_VKEYTOITEM = 46
-WM_CHARTOITEM = 47
-WM_SETFONT = 48
-WM_GETFONT = 49
-WM_SETHOTKEY = 50
-WM_GETHOTKEY = 51
-WM_QUERYDRAGICON = 55
-WM_COMPAREITEM = 57
-WM_GETOBJECT = 61
-WM_COMPACTING = 65
-WM_COMMNOTIFY = 68
-WM_WINDOWPOSCHANGING = 70
-WM_WINDOWPOSCHANGED = 71
-WM_POWER = 72
-PWR_OK = 1
-PWR_FAIL = -1
-PWR_SUSPENDREQUEST = 1
-PWR_SUSPENDRESUME = 2
-PWR_CRITICALRESUME = 3
-WM_COPYDATA = 74
-WM_CANCELJOURNAL = 75
-WM_NOTIFY = 78
-WM_INPUTLANGCHANGEREQUEST = 80
-WM_INPUTLANGCHANGE = 81
-WM_TCARD = 82
-WM_HELP = 83
-WM_USERCHANGED = 84
-WM_NOTIFYFORMAT = 85
-NFR_ANSI = 1
-NFR_UNICODE = 2
-NF_QUERY = 3
-NF_REQUERY = 4
-WM_CONTEXTMENU = 123
-WM_STYLECHANGING = 124
-WM_STYLECHANGED = 125
-WM_DISPLAYCHANGE = 126
-WM_GETICON = 127
-WM_SETICON = 128
-WM_NCCREATE = 129
-WM_NCDESTROY = 130
-WM_NCCALCSIZE = 131
-WM_NCHITTEST = 132
-WM_NCPAINT = 133
-WM_NCACTIVATE = 134
-WM_GETDLGCODE = 135
-WM_SYNCPAINT = 136
-WM_NCMOUSEMOVE = 160
-WM_NCLBUTTONDOWN = 161
-WM_NCLBUTTONUP = 162
-WM_NCLBUTTONDBLCLK = 163
-WM_NCRBUTTONDOWN = 164
-WM_NCRBUTTONUP = 165
-WM_NCRBUTTONDBLCLK = 166
-WM_NCMBUTTONDOWN = 167
-WM_NCMBUTTONUP = 168
-WM_NCMBUTTONDBLCLK = 169
-WM_KEYFIRST = 256
-WM_KEYDOWN = 256
-WM_KEYUP = 257
-WM_CHAR = 258
-WM_DEADCHAR = 259
-WM_SYSKEYDOWN = 260
-WM_SYSKEYUP = 261
-WM_SYSCHAR = 262
-WM_SYSDEADCHAR = 263
-WM_KEYLAST = 264
-WM_IME_STARTCOMPOSITION = 269
-WM_IME_ENDCOMPOSITION = 270
-WM_IME_COMPOSITION = 271
-WM_IME_KEYLAST = 271
-WM_INITDIALOG = 272
-WM_COMMAND = 273
-WM_SYSCOMMAND = 274
-WM_TIMER = 275
-WM_HSCROLL = 276
-WM_VSCROLL = 277
-WM_INITMENU = 278
-WM_INITMENUPOPUP = 279
-WM_MENUSELECT = 287
-WM_MENUCHAR = 288
-WM_ENTERIDLE = 289
-WM_MENURBUTTONUP = 290
-WM_MENUDRAG = 291
-WM_MENUGETOBJECT = 292
-WM_UNINITMENUPOPUP = 293
-WM_MENUCOMMAND = 294
-WM_CTLCOLORMSGBOX = 306
-WM_CTLCOLOREDIT = 307
-WM_CTLCOLORLISTBOX = 308
-WM_CTLCOLORBTN = 309
-WM_CTLCOLORDLG = 310
-WM_CTLCOLORSCROLLBAR = 311
-WM_CTLCOLORSTATIC = 312
-WM_MOUSEFIRST = 512
-WM_MOUSEMOVE = 512
-WM_LBUTTONDOWN = 513
-WM_LBUTTONUP = 514
-WM_LBUTTONDBLCLK = 515
-WM_RBUTTONDOWN = 516
-WM_RBUTTONUP = 517
-WM_RBUTTONDBLCLK = 518
-WM_MBUTTONDOWN = 519
-WM_MBUTTONUP = 520
-WM_MBUTTONDBLCLK = 521
-WM_MOUSEWHEEL = 522
-WM_MOUSELAST = 522
-WHEEL_DELTA = 120  # Value for rolling one detent
-WHEEL_PAGESCROLL = -1  # Scroll one page
-WM_PARENTNOTIFY = 528
-MENULOOP_WINDOW = 0
-MENULOOP_POPUP = 1
-WM_ENTERMENULOOP = 529
-WM_EXITMENULOOP = 530
-WM_NEXTMENU = 531
-WM_SIZING = 532
-WM_CAPTURECHANGED = 533
-WM_MOVING = 534
-WM_POWERBROADCAST = 536
-PBT_APMQUERYSUSPEND = 0
-PBT_APMQUERYSTANDBY = 1
-PBT_APMQUERYSUSPENDFAILED = 2
-PBT_APMQUERYSTANDBYFAILED = 3
-PBT_APMSUSPEND = 4
-PBT_APMSTANDBY = 5
-PBT_APMRESUMECRITICAL = 6
-PBT_APMRESUMESUSPEND = 7
-PBT_APMRESUMESTANDBY = 8
-PBTF_APMRESUMEFROMFAILURE = 1
-PBT_APMBATTERYLOW = 9
-PBT_APMPOWERSTATUSCHANGE = 10
-PBT_APMOEMEVENT = 11
-PBT_APMRESUMEAUTOMATIC = 18
-WM_DEVICECHANGE = 537
-WM_MDICREATE = 544
-WM_MDIDESTROY = 545
-WM_MDIACTIVATE = 546
-WM_MDIRESTORE = 547
-WM_MDINEXT = 548
-WM_MDIMAXIMIZE = 549
-WM_MDITILE = 550
-WM_MDICASCADE = 551
-WM_MDIICONARRANGE = 552
-WM_MDIGETACTIVE = 553
-WM_MDISETMENU = 560
-WM_ENTERSIZEMOVE = 561
-WM_EXITSIZEMOVE = 562
-WM_DROPFILES = 563
-WM_MDIREFRESHMENU = 564
-WM_IME_SETCONTEXT = 641
-WM_IME_NOTIFY = 642
-WM_IME_CONTROL = 643
-WM_IME_COMPOSITIONFULL = 644
-WM_IME_SELECT = 645
-WM_IME_CHAR = 646
-WM_IME_REQUEST = 648
-WM_IME_KEYDOWN = 656
-WM_IME_KEYUP = 657
-WM_MOUSEHOVER = 673
-WM_MOUSELEAVE = 675
-WM_CUT = 768
-WM_COPY = 769
-WM_PASTE = 770
-WM_CLEAR = 771
-WM_UNDO = 772
-WM_RENDERFORMAT = 773
-WM_RENDERALLFORMATS = 774
-WM_DESTROYCLIPBOARD = 775
-WM_DRAWCLIPBOARD = 776
-WM_PAINTCLIPBOARD = 777
-WM_VSCROLLCLIPBOARD = 778
-WM_SIZECLIPBOARD = 779
-WM_ASKCBFORMATNAME = 780
-WM_CHANGECBCHAIN = 781
-WM_HSCROLLCLIPBOARD = 782
-WM_QUERYNEWPALETTE = 783
-WM_PALETTEISCHANGING = 784
-WM_PALETTECHANGED = 785
-WM_HOTKEY = 786
-WM_PRINT = 791
-WM_PRINTCLIENT = 792
-WM_HANDHELDFIRST = 856
-WM_HANDHELDLAST = 863
-WM_AFXFIRST = 864
-WM_AFXLAST = 895
-WM_PENWINFIRST = 896
-WM_PENWINLAST = 911
-WM_APP = 32768
-WMSZ_LEFT = 1
-WMSZ_RIGHT = 2
-WMSZ_TOP = 3
-WMSZ_TOPLEFT = 4
-WMSZ_TOPRIGHT = 5
-WMSZ_BOTTOM = 6
-WMSZ_BOTTOMLEFT = 7
-WMSZ_BOTTOMRIGHT = 8
-# ST_BEGINSWP = 0
-# ST_ENDSWP = 1
-HTERROR = -2
-HTTRANSPARENT = -1
-HTNOWHERE = 0
-HTCLIENT = 1
-HTCAPTION = 2
-HTSYSMENU = 3
-HTGROWBOX = 4
-HTSIZE = HTGROWBOX
-HTMENU = 5
-HTHSCROLL = 6
-HTVSCROLL = 7
-HTMINBUTTON = 8
-HTMAXBUTTON = 9
-HTLEFT = 10
-HTRIGHT = 11
-HTTOP = 12
-HTTOPLEFT = 13
-HTTOPRIGHT = 14
-HTBOTTOM = 15
-HTBOTTOMLEFT = 16
-HTBOTTOMRIGHT = 17
-HTBORDER = 18
-HTREDUCE = HTMINBUTTON
-HTZOOM = HTMAXBUTTON
-HTSIZEFIRST = HTLEFT
-HTSIZELAST = HTBOTTOMRIGHT
-HTOBJECT = 19
-HTCLOSE = 20
-HTHELP = 21
-SMTO_NORMAL = 0
-SMTO_BLOCK = 1
-SMTO_ABORTIFHUNG = 2
-SMTO_NOTIMEOUTIFNOTHUNG = 8
-MA_ACTIVATE = 1
-MA_ACTIVATEANDEAT = 2
-MA_NOACTIVATE = 3
-MA_NOACTIVATEANDEAT = 4
-ICON_SMALL = 0
-ICON_BIG = 1
-SIZE_RESTORED = 0
-SIZE_MINIMIZED = 1
-SIZE_MAXIMIZED = 2
-SIZE_MAXSHOW = 3
-SIZE_MAXHIDE = 4
-SIZENORMAL = SIZE_RESTORED
-SIZEICONIC = SIZE_MINIMIZED
-SIZEFULLSCREEN = SIZE_MAXIMIZED
-SIZEZOOMSHOW = SIZE_MAXSHOW
-SIZEZOOMHIDE = SIZE_MAXHIDE
-WVR_ALIGNTOP = 16
-WVR_ALIGNLEFT = 32
-WVR_ALIGNBOTTOM = 64
-WVR_ALIGNRIGHT = 128
-WVR_HREDRAW = 256
-WVR_VREDRAW = 512
-WVR_REDRAW = WVR_HREDRAW | WVR_VREDRAW
-WVR_VALIDRECTS = 1024
-MK_LBUTTON = 1
-MK_RBUTTON = 2
-MK_SHIFT = 4
-MK_CONTROL = 8
-MK_MBUTTON = 16
-TME_HOVER = 1
-TME_LEAVE = 2
-TME_QUERY = 1073741824
-TME_CANCEL = -2147483648
-HOVER_DEFAULT = -1
-WS_OVERLAPPED = 0
-WS_POPUP = -2147483648
-WS_CHILD = 1073741824
-WS_MINIMIZE = 536870912
-WS_VISIBLE = 268435456
-WS_DISABLED = 134217728
-WS_CLIPSIBLINGS = 67108864
-WS_CLIPCHILDREN = 33554432
-WS_MAXIMIZE = 16777216
-WS_CAPTION = 12582912
-WS_BORDER = 8388608
-WS_DLGFRAME = 4194304
-WS_VSCROLL = 2097152
-WS_HSCROLL = 1048576
-WS_SYSMENU = 524288
-WS_THICKFRAME = 262144
-WS_GROUP = 131072
-WS_TABSTOP = 65536
-WS_MINIMIZEBOX = 131072
-WS_MAXIMIZEBOX = 65536
-WS_TILED = WS_OVERLAPPED
-WS_ICONIC = WS_MINIMIZE
-WS_SIZEBOX = WS_THICKFRAME
-WS_OVERLAPPEDWINDOW = (
-    WS_OVERLAPPED
-    | WS_CAPTION
-    | WS_SYSMENU
-    | WS_THICKFRAME
-    | WS_MINIMIZEBOX
-    | WS_MAXIMIZEBOX
-)
-WS_POPUPWINDOW = WS_POPUP | WS_BORDER | WS_SYSMENU
-WS_CHILDWINDOW = WS_CHILD
-WS_TILEDWINDOW = WS_OVERLAPPEDWINDOW
-WS_EX_DLGMODALFRAME = 1
-WS_EX_NOPARENTNOTIFY = 4
-WS_EX_TOPMOST = 8
-WS_EX_ACCEPTFILES = 16
-WS_EX_TRANSPARENT = 32
-WS_EX_MDICHILD = 64
-WS_EX_TOOLWINDOW = 128
-WS_EX_WINDOWEDGE = 256
-WS_EX_CLIENTEDGE = 512
-WS_EX_CONTEXTHELP = 1024
-WS_EX_RIGHT = 4096
-WS_EX_LEFT = 0
-WS_EX_RTLREADING = 8192
-WS_EX_LTRREADING = 0
-WS_EX_LEFTSCROLLBAR = 16384
-WS_EX_RIGHTSCROLLBAR = 0
-WS_EX_CONTROLPARENT = 65536
-WS_EX_STATICEDGE = 131072
-WS_EX_APPWINDOW = 262144
-WS_EX_OVERLAPPEDWINDOW = WS_EX_WINDOWEDGE | WS_EX_CLIENTEDGE
-WS_EX_PALETTEWINDOW = WS_EX_WINDOWEDGE | WS_EX_TOOLWINDOW | WS_EX_TOPMOST
-WS_EX_LAYERED = 0x00080000
-WS_EX_NOINHERITLAYOUT = 0x00100000
-WS_EX_LAYOUTRTL = 0x00400000
-WS_EX_COMPOSITED = 0x02000000
-WS_EX_NOACTIVATE = 0x08000000
-
-CS_VREDRAW = 1
-CS_HREDRAW = 2
-# CS_KEYCVTWINDOW = 0x0004
-CS_DBLCLKS = 8
-CS_OWNDC = 32
-CS_CLASSDC = 64
-CS_PARENTDC = 128
-# CS_NOKEYCVT = 0x0100
-CS_NOCLOSE = 512
-CS_SAVEBITS = 2048
-CS_BYTEALIGNCLIENT = 4096
-CS_BYTEALIGNWINDOW = 8192
-CS_GLOBALCLASS = 16384
-CS_IME = 65536
-PRF_CHECKVISIBLE = 1
-PRF_NONCLIENT = 2
-PRF_CLIENT = 4
-PRF_ERASEBKGND = 8
-PRF_CHILDREN = 16
-PRF_OWNED = 32
-BDR_RAISEDOUTER = 1
-BDR_SUNKENOUTER = 2
-BDR_RAISEDINNER = 4
-BDR_SUNKENINNER = 8
-BDR_OUTER = 3
-BDR_INNER = 12
-# BDR_RAISED = 0x0005
-# BDR_SUNKEN = 0x000a
-EDGE_RAISED = BDR_RAISEDOUTER | BDR_RAISEDINNER
-EDGE_SUNKEN = BDR_SUNKENOUTER | BDR_SUNKENINNER
-EDGE_ETCHED = BDR_SUNKENOUTER | BDR_RAISEDINNER
-EDGE_BUMP = BDR_RAISEDOUTER | BDR_SUNKENINNER
-
-# winuser.h line 2879
-ISMEX_NOSEND = 0
-ISMEX_SEND = 1
-ISMEX_NOTIFY = 2
-ISMEX_CALLBACK = 4
-ISMEX_REPLIED = 8
-CW_USEDEFAULT = -2147483648
-FLASHW_STOP = 0
-FLASHW_CAPTION = 1
-FLASHW_TRAY = 2
-FLASHW_ALL = FLASHW_CAPTION | FLASHW_TRAY
-FLASHW_TIMER = 4
-FLASHW_TIMERNOFG = 12
-
-# winuser.h line 7963
-DS_ABSALIGN = 1
-DS_SYSMODAL = 2
-DS_LOCALEDIT = 32
-DS_SETFONT = 64
-DS_MODALFRAME = 128
-DS_NOIDLEMSG = 256
-DS_SETFOREGROUND = 512
-DS_3DLOOK = 4
-DS_FIXEDSYS = 8
-DS_NOFAILCREATE = 16
-DS_CONTROL = 1024
-DS_CENTER = 2048
-DS_CENTERMOUSE = 4096
-DS_CONTEXTHELP = 8192
-DM_GETDEFID = WM_USER + 0
-DM_SETDEFID = WM_USER + 1
-DM_REPOSITION = WM_USER + 2
-# PSM_PAGEINFO = (WM_USER+100)
-# PSM_SHEETINFO = (WM_USER+101)
-# PSI_SETACTIVE = 0x0001
-# PSI_KILLACTIVE = 0x0002
-# PSI_APPLY = 0x0003
-# PSI_RESET = 0x0004
-# PSI_HASHELP = 0x0005
-# PSI_HELP = 0x0006
-# PSI_CHANGED = 0x0001
-# PSI_GUISTART = 0x0002
-# PSI_REBOOT = 0x0003
-# PSI_GETSIBLINGS = 0x0004
-DC_HASDEFID = 21323
-DLGC_WANTARROWS = 1
-DLGC_WANTTAB = 2
-DLGC_WANTALLKEYS = 4
-DLGC_WANTMESSAGE = 4
-DLGC_HASSETSEL = 8
-DLGC_DEFPUSHBUTTON = 16
-DLGC_UNDEFPUSHBUTTON = 32
-DLGC_RADIOBUTTON = 64
-DLGC_WANTCHARS = 128
-DLGC_STATIC = 256
-DLGC_BUTTON = 8192
-LB_CTLCODE = 0
-LB_OKAY = 0
-LB_ERR = -1
-LB_ERRSPACE = -2
-LBN_ERRSPACE = -2
-LBN_SELCHANGE = 1
-LBN_DBLCLK = 2
-LBN_SELCANCEL = 3
-LBN_SETFOCUS = 4
-LBN_KILLFOCUS = 5
-LB_ADDSTRING = 384
-LB_INSERTSTRING = 385
-LB_DELETESTRING = 386
-LB_SELITEMRANGEEX = 387
-LB_RESETCONTENT = 388
-LB_SETSEL = 389
-LB_SETCURSEL = 390
-LB_GETSEL = 391
-LB_GETCURSEL = 392
-LB_GETTEXT = 393
-LB_GETTEXTLEN = 394
-LB_GETCOUNT = 395
-LB_SELECTSTRING = 396
-LB_DIR = 397
-LB_GETTOPINDEX = 398
-LB_FINDSTRING = 399
-LB_GETSELCOUNT = 400
-LB_GETSELITEMS = 401
-LB_SETTABSTOPS = 402
-LB_GETHORIZONTALEXTENT = 403
-LB_SETHORIZONTALEXTENT = 404
-LB_SETCOLUMNWIDTH = 405
-LB_ADDFILE = 406
-LB_SETTOPINDEX = 407
-LB_GETITEMRECT = 408
-LB_GETITEMDATA = 409
-LB_SETITEMDATA = 410
-LB_SELITEMRANGE = 411
-LB_SETANCHORINDEX = 412
-LB_GETANCHORINDEX = 413
-LB_SETCARETINDEX = 414
-LB_GETCARETINDEX = 415
-LB_SETITEMHEIGHT = 416
-LB_GETITEMHEIGHT = 417
-LB_FINDSTRINGEXACT = 418
-LB_SETLOCALE = 421
-LB_GETLOCALE = 422
-LB_SETCOUNT = 423
-LB_INITSTORAGE = 424
-LB_ITEMFROMPOINT = 425
-LB_MSGMAX = 432
-LBS_NOTIFY = 1
-LBS_SORT = 2
-LBS_NOREDRAW = 4
-LBS_MULTIPLESEL = 8
-LBS_OWNERDRAWFIXED = 16
-LBS_OWNERDRAWVARIABLE = 32
-LBS_HASSTRINGS = 64
-LBS_USETABSTOPS = 128
-LBS_NOINTEGRALHEIGHT = 256
-LBS_MULTICOLUMN = 512
-LBS_WANTKEYBOARDINPUT = 1024
-LBS_EXTENDEDSEL = 2048
-LBS_DISABLENOSCROLL = 4096
-LBS_NODATA = 8192
-LBS_NOSEL = 16384
-LBS_STANDARD = LBS_NOTIFY | LBS_SORT | WS_VSCROLL | WS_BORDER
-CB_OKAY = 0
-CB_ERR = -1
-CB_ERRSPACE = -2
-CBN_ERRSPACE = -1
-CBN_SELCHANGE = 1
-CBN_DBLCLK = 2
-CBN_SETFOCUS = 3
-CBN_KILLFOCUS = 4
-CBN_EDITCHANGE = 5
-CBN_EDITUPDATE = 6
-CBN_DROPDOWN = 7
-CBN_CLOSEUP = 8
-CBN_SELENDOK = 9
-CBN_SELENDCANCEL = 10
-CBS_SIMPLE = 1
-CBS_DROPDOWN = 2
-CBS_DROPDOWNLIST = 3
-CBS_OWNERDRAWFIXED = 16
-CBS_OWNERDRAWVARIABLE = 32
-CBS_AUTOHSCROLL = 64
-CBS_OEMCONVERT = 128
-CBS_SORT = 256
-CBS_HASSTRINGS = 512
-CBS_NOINTEGRALHEIGHT = 1024
-CBS_DISABLENOSCROLL = 2048
-CBS_UPPERCASE = 8192
-CBS_LOWERCASE = 16384
-CB_GETEDITSEL = 320
-CB_LIMITTEXT = 321
-CB_SETEDITSEL = 322
-CB_ADDSTRING = 323
-CB_DELETESTRING = 324
-CB_DIR = 325
-CB_GETCOUNT = 326
-CB_GETCURSEL = 327
-CB_GETLBTEXT = 328
-CB_GETLBTEXTLEN = 329
-CB_INSERTSTRING = 330
-CB_RESETCONTENT = 331
-CB_FINDSTRING = 332
-CB_SELECTSTRING = 333
-CB_SETCURSEL = 334
-CB_SHOWDROPDOWN = 335
-CB_GETITEMDATA = 336
-CB_SETITEMDATA = 337
-CB_GETDROPPEDCONTROLRECT = 338
-CB_SETITEMHEIGHT = 339
-CB_GETITEMHEIGHT = 340
-CB_SETEXTENDEDUI = 341
-CB_GETEXTENDEDUI = 342
-CB_GETDROPPEDSTATE = 343
-CB_FINDSTRINGEXACT = 344
-CB_SETLOCALE = 345
-CB_GETLOCALE = 346
-CB_GETTOPINDEX = 347
-CB_SETTOPINDEX = 348
-CB_GETHORIZONTALEXTENT = 349
-CB_SETHORIZONTALEXTENT = 350
-CB_GETDROPPEDWIDTH = 351
-CB_SETDROPPEDWIDTH = 352
-CB_INITSTORAGE = 353
-CB_MSGMAX = 354
-SBS_HORZ = 0
-SBS_VERT = 1
-SBS_TOPALIGN = 2
-SBS_LEFTALIGN = 2
-SBS_BOTTOMALIGN = 4
-SBS_RIGHTALIGN = 4
-SBS_SIZEBOXTOPLEFTALIGN = 2
-SBS_SIZEBOXBOTTOMRIGHTALIGN = 4
-SBS_SIZEBOX = 8
-SBS_SIZEGRIP = 16
-SBM_SETPOS = 224
-SBM_GETPOS = 225
-SBM_SETRANGE = 226
-SBM_SETRANGEREDRAW = 230
-SBM_GETRANGE = 227
-SBM_ENABLE_ARROWS = 228
-SBM_SETSCROLLINFO = 233
-SBM_GETSCROLLINFO = 234
-SIF_RANGE = 1
-SIF_PAGE = 2
-SIF_POS = 4
-SIF_DISABLENOSCROLL = 8
-SIF_TRACKPOS = 16
-SIF_ALL = SIF_RANGE | SIF_PAGE | SIF_POS | SIF_TRACKPOS
-MDIS_ALLCHILDSTYLES = 1
-MDITILE_VERTICAL = 0
-MDITILE_HORIZONTAL = 1
-MDITILE_SKIPDISABLED = 2
-MDITILE_ZORDER = 4
-
-IMC_GETCANDIDATEPOS = 7
-IMC_SETCANDIDATEPOS = 8
-IMC_GETCOMPOSITIONFONT = 9
-IMC_SETCOMPOSITIONFONT = 10
-IMC_GETCOMPOSITIONWINDOW = 11
-IMC_SETCOMPOSITIONWINDOW = 12
-IMC_GETSTATUSWINDOWPOS = 15
-IMC_SETSTATUSWINDOWPOS = 16
-IMC_CLOSESTATUSWINDOW = 33
-IMC_OPENSTATUSWINDOW = 34
-# Generated by h2py from \msvc20\include\winnt.h
-# hacked and split by mhammond.
-DELETE = 65536
-READ_CONTROL = 131072
-WRITE_DAC = 262144
-WRITE_OWNER = 524288
-SYNCHRONIZE = 1048576
-STANDARD_RIGHTS_REQUIRED = 983040
-STANDARD_RIGHTS_READ = READ_CONTROL
-STANDARD_RIGHTS_WRITE = READ_CONTROL
-STANDARD_RIGHTS_EXECUTE = READ_CONTROL
-STANDARD_RIGHTS_ALL = 2031616
-SPECIFIC_RIGHTS_ALL = 65535
-ACCESS_SYSTEM_SECURITY = 16777216
-MAXIMUM_ALLOWED = 33554432
-GENERIC_READ = -2147483648
-GENERIC_WRITE = 1073741824
-GENERIC_EXECUTE = 536870912
-GENERIC_ALL = 268435456
-
-SERVICE_KERNEL_DRIVER = 1
-SERVICE_FILE_SYSTEM_DRIVER = 2
-SERVICE_ADAPTER = 4
-SERVICE_RECOGNIZER_DRIVER = 8
-SERVICE_DRIVER = (
-    SERVICE_KERNEL_DRIVER | SERVICE_FILE_SYSTEM_DRIVER | SERVICE_RECOGNIZER_DRIVER
-)
-SERVICE_WIN32_OWN_PROCESS = 16
-SERVICE_WIN32_SHARE_PROCESS = 32
-SERVICE_WIN32 = SERVICE_WIN32_OWN_PROCESS | SERVICE_WIN32_SHARE_PROCESS
-SERVICE_INTERACTIVE_PROCESS = 256
-SERVICE_TYPE_ALL = (
-    SERVICE_WIN32 | SERVICE_ADAPTER | SERVICE_DRIVER | SERVICE_INTERACTIVE_PROCESS
-)
-SERVICE_BOOT_START = 0
-SERVICE_SYSTEM_START = 1
-SERVICE_AUTO_START = 2
-SERVICE_DEMAND_START = 3
-SERVICE_DISABLED = 4
-SERVICE_ERROR_IGNORE = 0
-SERVICE_ERROR_NORMAL = 1
-SERVICE_ERROR_SEVERE = 2
-SERVICE_ERROR_CRITICAL = 3
-TAPE_ERASE_SHORT = 0
-TAPE_ERASE_LONG = 1
-TAPE_LOAD = 0
-TAPE_UNLOAD = 1
-TAPE_TENSION = 2
-TAPE_LOCK = 3
-TAPE_UNLOCK = 4
-TAPE_FORMAT = 5
-TAPE_SETMARKS = 0
-TAPE_FILEMARKS = 1
-TAPE_SHORT_FILEMARKS = 2
-TAPE_LONG_FILEMARKS = 3
-TAPE_ABSOLUTE_POSITION = 0
-TAPE_LOGICAL_POSITION = 1
-TAPE_PSEUDO_LOGICAL_POSITION = 2
-TAPE_REWIND = 0
-TAPE_ABSOLUTE_BLOCK = 1
-TAPE_LOGICAL_BLOCK = 2
-TAPE_PSEUDO_LOGICAL_BLOCK = 3
-TAPE_SPACE_END_OF_DATA = 4
-TAPE_SPACE_RELATIVE_BLOCKS = 5
-TAPE_SPACE_FILEMARKS = 6
-TAPE_SPACE_SEQUENTIAL_FMKS = 7
-TAPE_SPACE_SETMARKS = 8
-TAPE_SPACE_SEQUENTIAL_SMKS = 9
-TAPE_DRIVE_FIXED = 1
-TAPE_DRIVE_SELECT = 2
-TAPE_DRIVE_INITIATOR = 4
-TAPE_DRIVE_ERASE_SHORT = 16
-TAPE_DRIVE_ERASE_LONG = 32
-TAPE_DRIVE_ERASE_BOP_ONLY = 64
-TAPE_DRIVE_ERASE_IMMEDIATE = 128
-TAPE_DRIVE_TAPE_CAPACITY = 256
-TAPE_DRIVE_TAPE_REMAINING = 512
-TAPE_DRIVE_FIXED_BLOCK = 1024
-TAPE_DRIVE_VARIABLE_BLOCK = 2048
-TAPE_DRIVE_WRITE_PROTECT = 4096
-TAPE_DRIVE_EOT_WZ_SIZE = 8192
-TAPE_DRIVE_ECC = 65536
-TAPE_DRIVE_COMPRESSION = 131072
-TAPE_DRIVE_PADDING = 262144
-TAPE_DRIVE_REPORT_SMKS = 524288
-TAPE_DRIVE_GET_ABSOLUTE_BLK = 1048576
-TAPE_DRIVE_GET_LOGICAL_BLK = 2097152
-TAPE_DRIVE_SET_EOT_WZ_SIZE = 4194304
-TAPE_DRIVE_LOAD_UNLOAD = -2147483647
-TAPE_DRIVE_TENSION = -2147483646
-TAPE_DRIVE_LOCK_UNLOCK = -2147483644
-TAPE_DRIVE_REWIND_IMMEDIATE = -2147483640
-TAPE_DRIVE_SET_BLOCK_SIZE = -2147483632
-TAPE_DRIVE_LOAD_UNLD_IMMED = -2147483616
-TAPE_DRIVE_TENSION_IMMED = -2147483584
-TAPE_DRIVE_LOCK_UNLK_IMMED = -2147483520
-TAPE_DRIVE_SET_ECC = -2147483392
-TAPE_DRIVE_SET_COMPRESSION = -2147483136
-TAPE_DRIVE_SET_PADDING = -2147482624
-TAPE_DRIVE_SET_REPORT_SMKS = -2147481600
-TAPE_DRIVE_ABSOLUTE_BLK = -2147479552
-TAPE_DRIVE_ABS_BLK_IMMED = -2147475456
-TAPE_DRIVE_LOGICAL_BLK = -2147467264
-TAPE_DRIVE_LOG_BLK_IMMED = -2147450880
-TAPE_DRIVE_END_OF_DATA = -2147418112
-TAPE_DRIVE_RELATIVE_BLKS = -2147352576
-TAPE_DRIVE_FILEMARKS = -2147221504
-TAPE_DRIVE_SEQUENTIAL_FMKS = -2146959360
-TAPE_DRIVE_SETMARKS = -2146435072
-TAPE_DRIVE_SEQUENTIAL_SMKS = -2145386496
-TAPE_DRIVE_REVERSE_POSITION = -2143289344
-TAPE_DRIVE_SPACE_IMMEDIATE = -2139095040
-TAPE_DRIVE_WRITE_SETMARKS = -2130706432
-TAPE_DRIVE_WRITE_FILEMARKS = -2113929216
-TAPE_DRIVE_WRITE_SHORT_FMKS = -2080374784
-TAPE_DRIVE_WRITE_LONG_FMKS = -2013265920
-TAPE_DRIVE_WRITE_MARK_IMMED = -1879048192
-TAPE_DRIVE_FORMAT = -1610612736
-TAPE_DRIVE_FORMAT_IMMEDIATE = -1073741824
-TAPE_FIXED_PARTITIONS = 0
-TAPE_SELECT_PARTITIONS = 1
-TAPE_INITIATOR_PARTITIONS = 2
-# Generated by h2py from \msvc20\include\winnt.h
-# hacked and split by mhammond.
-
-APPLICATION_ERROR_MASK = 536870912
-ERROR_SEVERITY_SUCCESS = 0
-ERROR_SEVERITY_INFORMATIONAL = 1073741824
-ERROR_SEVERITY_WARNING = -2147483648
-ERROR_SEVERITY_ERROR = -1073741824
-MINCHAR = 128
-MAXCHAR = 127
-MINSHORT = 32768
-MAXSHORT = 32767
-MINLONG = -2147483648
-MAXLONG = 2147483647
-MAXBYTE = 255
-MAXWORD = 65535
-MAXDWORD = -1
-LANG_NEUTRAL = 0
-LANG_BULGARIAN = 2
-LANG_CHINESE = 4
-LANG_CROATIAN = 26
-LANG_CZECH = 5
-LANG_DANISH = 6
-LANG_DUTCH = 19
-LANG_ENGLISH = 9
-LANG_FINNISH = 11
-LANG_FRENCH = 12
-LANG_GERMAN = 7
-LANG_GREEK = 8
-LANG_HUNGARIAN = 14
-LANG_ICELANDIC = 15
-LANG_ITALIAN = 16
-LANG_JAPANESE = 17
-LANG_KOREAN = 18
-LANG_NORWEGIAN = 20
-LANG_POLISH = 21
-LANG_PORTUGUESE = 22
-LANG_ROMANIAN = 24
-LANG_RUSSIAN = 25
-LANG_SLOVAK = 27
-LANG_SLOVENIAN = 36
-LANG_SPANISH = 10
-LANG_SWEDISH = 29
-LANG_TURKISH = 31
-SUBLANG_NEUTRAL = 0
-SUBLANG_DEFAULT = 1
-SUBLANG_SYS_DEFAULT = 2
-SUBLANG_CHINESE_TRADITIONAL = 1
-SUBLANG_CHINESE_SIMPLIFIED = 2
-SUBLANG_CHINESE_HONGKONG = 3
-SUBLANG_CHINESE_SINGAPORE = 4
-SUBLANG_DUTCH = 1
-SUBLANG_DUTCH_BELGIAN = 2
-SUBLANG_ENGLISH_US = 1
-SUBLANG_ENGLISH_UK = 2
-SUBLANG_ENGLISH_AUS = 3
-SUBLANG_ENGLISH_CAN = 4
-SUBLANG_ENGLISH_NZ = 5
-SUBLANG_ENGLISH_EIRE = 6
-SUBLANG_FRENCH = 1
-SUBLANG_FRENCH_BELGIAN = 2
-SUBLANG_FRENCH_CANADIAN = 3
-SUBLANG_FRENCH_SWISS = 4
-SUBLANG_GERMAN = 1
-SUBLANG_GERMAN_SWISS = 2
-SUBLANG_GERMAN_AUSTRIAN = 3
-SUBLANG_ITALIAN = 1
-SUBLANG_ITALIAN_SWISS = 2
-SUBLANG_NORWEGIAN_BOKMAL = 1
-SUBLANG_NORWEGIAN_NYNORSK = 2
-SUBLANG_PORTUGUESE = 2
-SUBLANG_PORTUGUESE_BRAZILIAN = 1
-SUBLANG_SPANISH = 1
-SUBLANG_SPANISH_MEXICAN = 2
-SUBLANG_SPANISH_MODERN = 3
-SORT_DEFAULT = 0
-SORT_JAPANESE_XJIS = 0
-SORT_JAPANESE_UNICODE = 1
-SORT_CHINESE_BIG5 = 0
-SORT_CHINESE_UNICODE = 1
-SORT_KOREAN_KSC = 0
-SORT_KOREAN_UNICODE = 1
-
-
-def PRIMARYLANGID(lgid):
-    return (lgid) & 1023
-
-
-def SUBLANGID(lgid):
-    return (lgid) >> 10
-
-
-NLS_VALID_LOCALE_MASK = 1048575
-CONTEXT_PORTABLE_32BIT = 1048576
-CONTEXT_ALPHA = 131072
-CONTEXT_CONTROL = CONTEXT_ALPHA | 1
-CONTEXT_FLOATING_POINT = CONTEXT_ALPHA | 2
-CONTEXT_INTEGER = CONTEXT_ALPHA | 4
-CONTEXT_FULL = CONTEXT_CONTROL | CONTEXT_FLOATING_POINT | CONTEXT_INTEGER
-SIZE_OF_80387_REGISTERS = 80
-CONTEXT_FULL = CONTEXT_CONTROL | CONTEXT_FLOATING_POINT | CONTEXT_INTEGER
-CONTEXT_CONTROL = 1
-CONTEXT_FLOATING_POINT = 2
-CONTEXT_INTEGER = 4
-CONTEXT_FULL = CONTEXT_CONTROL | CONTEXT_FLOATING_POINT | CONTEXT_INTEGER
-PROCESS_TERMINATE = 1
-PROCESS_CREATE_THREAD = 2
-PROCESS_VM_OPERATION = 8
-PROCESS_VM_READ = 16
-PROCESS_VM_WRITE = 32
-PROCESS_DUP_HANDLE = 64
-PROCESS_CREATE_PROCESS = 128
-PROCESS_SET_QUOTA = 256
-PROCESS_SET_INFORMATION = 512
-PROCESS_QUERY_INFORMATION = 1024
-PROCESS_SUSPEND_RESUME = 2048
-PROCESS_QUERY_LIMITED_INFORMATION = 4096
-PROCESS_SET_LIMITED_INFORMATION = 8192
-PROCESS_ALL_ACCESS = STANDARD_RIGHTS_REQUIRED | SYNCHRONIZE | 4095
-THREAD_TERMINATE = 1
-THREAD_SUSPEND_RESUME = 2
-THREAD_GET_CONTEXT = 8
-THREAD_SET_CONTEXT = 16
-THREAD_SET_INFORMATION = 32
-THREAD_QUERY_INFORMATION = 64
-THREAD_SET_THREAD_TOKEN = 128
-THREAD_IMPERSONATE = 256
-THREAD_DIRECT_IMPERSONATION = 512
-THREAD_SET_LIMITED_INFORMATION = 1024
-THREAD_QUERY_LIMITED_INFORMATION = 2048
-THREAD_RESUME = 4096
-TLS_MINIMUM_AVAILABLE = 64
-EVENT_MODIFY_STATE = 2
-MUTANT_QUERY_STATE = 1
-SEMAPHORE_MODIFY_STATE = 2
-TIME_ZONE_ID_UNKNOWN = 0
-TIME_ZONE_ID_STANDARD = 1
-TIME_ZONE_ID_DAYLIGHT = 2
-PROCESSOR_INTEL_386 = 386
-PROCESSOR_INTEL_486 = 486
-PROCESSOR_INTEL_PENTIUM = 586
-PROCESSOR_INTEL_860 = 860
-PROCESSOR_MIPS_R2000 = 2000
-PROCESSOR_MIPS_R3000 = 3000
-PROCESSOR_MIPS_R4000 = 4000
-PROCESSOR_ALPHA_21064 = 21064
-PROCESSOR_PPC_601 = 601
-PROCESSOR_PPC_603 = 603
-PROCESSOR_PPC_604 = 604
-PROCESSOR_PPC_620 = 620
-SECTION_QUERY = 1
-SECTION_MAP_WRITE = 2
-SECTION_MAP_READ = 4
-SECTION_MAP_EXECUTE = 8
-SECTION_EXTEND_SIZE = 16
-PAGE_NOACCESS = 1
-PAGE_READONLY = 2
-PAGE_READWRITE = 4
-PAGE_WRITECOPY = 8
-PAGE_EXECUTE = 16
-PAGE_EXECUTE_READ = 32
-PAGE_EXECUTE_READWRITE = 64
-PAGE_EXECUTE_WRITECOPY = 128
-PAGE_GUARD = 256
-PAGE_NOCACHE = 512
-MEM_COMMIT = 4096
-MEM_RESERVE = 8192
-MEM_DECOMMIT = 16384
-MEM_RELEASE = 32768
-MEM_FREE = 65536
-MEM_PRIVATE = 131072
-MEM_MAPPED = 262144
-MEM_TOP_DOWN = 1048576
-
-# Generated by h2py from \msvc20\include\winnt.h
-# hacked and split by mhammond.
-SEC_FILE = 8388608
-SEC_IMAGE = 16777216
-SEC_RESERVE = 67108864
-SEC_COMMIT = 134217728
-SEC_NOCACHE = 268435456
-MEM_IMAGE = SEC_IMAGE
-FILE_SHARE_READ = 1
-FILE_SHARE_WRITE = 2
-FILE_SHARE_DELETE = 4
-FILE_ATTRIBUTE_READONLY = 1
-FILE_ATTRIBUTE_HIDDEN = 2
-FILE_ATTRIBUTE_SYSTEM = 4
-FILE_ATTRIBUTE_DIRECTORY = 16
-FILE_ATTRIBUTE_ARCHIVE = 32
-FILE_ATTRIBUTE_DEVICE = 64
-FILE_ATTRIBUTE_NORMAL = 128
-FILE_ATTRIBUTE_TEMPORARY = 256
-FILE_ATTRIBUTE_SPARSE_FILE = 512
-FILE_ATTRIBUTE_REPARSE_POINT = 1024
-FILE_ATTRIBUTE_COMPRESSED = 2048
-FILE_ATTRIBUTE_OFFLINE = 4096
-FILE_ATTRIBUTE_NOT_CONTENT_INDEXED = 8192
-FILE_ATTRIBUTE_ENCRYPTED = 16384
-FILE_ATTRIBUTE_VIRTUAL = 65536
-# These FILE_ATTRIBUTE_* flags  are apparently old definitions from Windows 95
-# and conflict with current values above - but they live on for b/w compat...
-FILE_ATTRIBUTE_ATOMIC_WRITE = 512
-FILE_ATTRIBUTE_XACTION_WRITE = 1024
-
-FILE_NOTIFY_CHANGE_FILE_NAME = 1
-FILE_NOTIFY_CHANGE_DIR_NAME = 2
-FILE_NOTIFY_CHANGE_ATTRIBUTES = 4
-FILE_NOTIFY_CHANGE_SIZE = 8
-FILE_NOTIFY_CHANGE_LAST_WRITE = 16
-FILE_NOTIFY_CHANGE_SECURITY = 256
-FILE_CASE_SENSITIVE_SEARCH = 1
-FILE_CASE_PRESERVED_NAMES = 2
-FILE_UNICODE_ON_DISK = 4
-FILE_PERSISTENT_ACLS = 8
-FILE_FILE_COMPRESSION = 16
-FILE_NAMED_STREAMS = 262144
-FILE_PERSISTENT_ACLS = 0x00000008
-FILE_READ_ONLY_VOLUME = 0x00080000
-FILE_SEQUENTIAL_WRITE_ONCE = 0x00100000
-FILE_SUPPORTS_ENCRYPTION = 0x00020000
-FILE_SUPPORTS_EXTENDED_ATTRIBUTES = 0x00800000
-FILE_SUPPORTS_HARD_LINKS = 0x00400000
-FILE_SUPPORTS_OBJECT_IDS = 0x00010000
-FILE_SUPPORTS_OPEN_BY_FILE_ID = 0x01000000
-FILE_SUPPORTS_REPARSE_POINTS = 0x00000080
-FILE_SUPPORTS_SPARSE_FILES = 0x00000040
-FILE_SUPPORTS_TRANSACTIONS = 0x00200000
-FILE_SUPPORTS_USN_JOURNAL = 0x02000000
-FILE_UNICODE_ON_DISK = 0x00000004
-FILE_VOLUME_IS_COMPRESSED = 0x00008000
-FILE_VOLUME_QUOTAS = 0x00000020
-FILE_VOLUME_IS_COMPRESSED = 32768
-IO_COMPLETION_MODIFY_STATE = 2
-DUPLICATE_CLOSE_SOURCE = 1
-DUPLICATE_SAME_ACCESS = 2
-SID_MAX_SUB_AUTHORITIES = 15
-SECURITY_NULL_RID = 0
-SECURITY_WORLD_RID = 0
-SECURITY_LOCAL_RID = 0x00000000
-SECURITY_CREATOR_OWNER_RID = 0
-SECURITY_CREATOR_GROUP_RID = 1
-SECURITY_DIALUP_RID = 1
-SECURITY_NETWORK_RID = 2
-SECURITY_BATCH_RID = 3
-SECURITY_INTERACTIVE_RID = 4
-SECURITY_SERVICE_RID = 6
-SECURITY_ANONYMOUS_LOGON_RID = 7
-SECURITY_LOGON_IDS_RID = 5
-SECURITY_LOGON_IDS_RID_COUNT = 3
-SECURITY_LOCAL_SYSTEM_RID = 18
-SECURITY_NT_NON_UNIQUE = 21
-SECURITY_BUILTIN_DOMAIN_RID = 32
-DOMAIN_USER_RID_ADMIN = 500
-DOMAIN_USER_RID_GUEST = 501
-DOMAIN_GROUP_RID_ADMINS = 512
-DOMAIN_GROUP_RID_USERS = 513
-DOMAIN_GROUP_RID_GUESTS = 514
-DOMAIN_ALIAS_RID_ADMINS = 544
-DOMAIN_ALIAS_RID_USERS = 545
-DOMAIN_ALIAS_RID_GUESTS = 546
-DOMAIN_ALIAS_RID_POWER_USERS = 547
-DOMAIN_ALIAS_RID_ACCOUNT_OPS = 548
-DOMAIN_ALIAS_RID_SYSTEM_OPS = 549
-DOMAIN_ALIAS_RID_PRINT_OPS = 550
-DOMAIN_ALIAS_RID_BACKUP_OPS = 551
-DOMAIN_ALIAS_RID_REPLICATOR = 552
-SE_GROUP_MANDATORY = 1
-SE_GROUP_ENABLED_BY_DEFAULT = 2
-SE_GROUP_ENABLED = 4
-SE_GROUP_OWNER = 8
-SE_GROUP_LOGON_ID = -1073741824
-ACL_REVISION = 2
-ACL_REVISION1 = 1
-ACL_REVISION2 = 2
-ACCESS_ALLOWED_ACE_TYPE = 0
-ACCESS_DENIED_ACE_TYPE = 1
-SYSTEM_AUDIT_ACE_TYPE = 2
-SYSTEM_ALARM_ACE_TYPE = 3
-OBJECT_INHERIT_ACE = 1
-CONTAINER_INHERIT_ACE = 2
-NO_PROPAGATE_INHERIT_ACE = 4
-INHERIT_ONLY_ACE = 8
-VALID_INHERIT_FLAGS = 15
-SUCCESSFUL_ACCESS_ACE_FLAG = 64
-FAILED_ACCESS_ACE_FLAG = 128
-SECURITY_DESCRIPTOR_REVISION = 1
-SECURITY_DESCRIPTOR_REVISION1 = 1
-SECURITY_DESCRIPTOR_MIN_LENGTH = 20
-SE_OWNER_DEFAULTED = 1
-SE_GROUP_DEFAULTED = 2
-SE_DACL_PRESENT = 4
-SE_DACL_DEFAULTED = 8
-SE_SACL_PRESENT = 16
-SE_SACL_DEFAULTED = 32
-SE_SELF_RELATIVE = 32768
-SE_PRIVILEGE_ENABLED_BY_DEFAULT = 1
-SE_PRIVILEGE_ENABLED = 2
-SE_PRIVILEGE_USED_FOR_ACCESS = -2147483648
-PRIVILEGE_SET_ALL_NECESSARY = 1
-SE_CREATE_TOKEN_NAME = "SeCreateTokenPrivilege"
-SE_ASSIGNPRIMARYTOKEN_NAME = "SeAssignPrimaryTokenPrivilege"
-SE_LOCK_MEMORY_NAME = "SeLockMemoryPrivilege"
-SE_INCREASE_QUOTA_NAME = "SeIncreaseQuotaPrivilege"
-SE_UNSOLICITED_INPUT_NAME = "SeUnsolicitedInputPrivilege"
-SE_MACHINE_ACCOUNT_NAME = "SeMachineAccountPrivilege"
-SE_TCB_NAME = "SeTcbPrivilege"
-SE_SECURITY_NAME = "SeSecurityPrivilege"
-SE_TAKE_OWNERSHIP_NAME = "SeTakeOwnershipPrivilege"
-SE_LOAD_DRIVER_NAME = "SeLoadDriverPrivilege"
-SE_SYSTEM_PROFILE_NAME = "SeSystemProfilePrivilege"
-SE_SYSTEMTIME_NAME = "SeSystemtimePrivilege"
-SE_PROF_SINGLE_PROCESS_NAME = "SeProfileSingleProcessPrivilege"
-SE_INC_BASE_PRIORITY_NAME = "SeIncreaseBasePriorityPrivilege"
-SE_CREATE_PAGEFILE_NAME = "SeCreatePagefilePrivilege"
-SE_CREATE_PERMANENT_NAME = "SeCreatePermanentPrivilege"
-SE_BACKUP_NAME = "SeBackupPrivilege"
-SE_RESTORE_NAME = "SeRestorePrivilege"
-SE_SHUTDOWN_NAME = "SeShutdownPrivilege"
-SE_DEBUG_NAME = "SeDebugPrivilege"
-SE_AUDIT_NAME = "SeAuditPrivilege"
-SE_SYSTEM_ENVIRONMENT_NAME = "SeSystemEnvironmentPrivilege"
-SE_CHANGE_NOTIFY_NAME = "SeChangeNotifyPrivilege"
-SE_REMOTE_SHUTDOWN_NAME = "SeRemoteShutdownPrivilege"
-
-TOKEN_ASSIGN_PRIMARY = 1
-TOKEN_DUPLICATE = 2
-TOKEN_IMPERSONATE = 4
-TOKEN_QUERY = 8
-TOKEN_QUERY_SOURCE = 16
-TOKEN_ADJUST_PRIVILEGES = 32
-TOKEN_ADJUST_GROUPS = 64
-TOKEN_ADJUST_DEFAULT = 128
-TOKEN_ADJUST_SESSIONID = 256
-TOKEN_ALL_ACCESS = (
-    STANDARD_RIGHTS_REQUIRED
-    | TOKEN_ASSIGN_PRIMARY
-    | TOKEN_DUPLICATE
-    | TOKEN_IMPERSONATE
-    | TOKEN_QUERY
-    | TOKEN_QUERY_SOURCE
-    | TOKEN_ADJUST_PRIVILEGES
-    | TOKEN_ADJUST_GROUPS
-    | TOKEN_ADJUST_DEFAULT
-    | TOKEN_ADJUST_SESSIONID
-)
-TOKEN_READ = STANDARD_RIGHTS_READ | TOKEN_QUERY
-TOKEN_WRITE = (
-    STANDARD_RIGHTS_WRITE
-    | TOKEN_ADJUST_PRIVILEGES
-    | TOKEN_ADJUST_GROUPS
-    | TOKEN_ADJUST_DEFAULT
-)
-TOKEN_EXECUTE = STANDARD_RIGHTS_EXECUTE
-TOKEN_SOURCE_LENGTH = 8
-
-KEY_QUERY_VALUE = 1
-KEY_SET_VALUE = 2
-KEY_CREATE_SUB_KEY = 4
-KEY_ENUMERATE_SUB_KEYS = 8
-KEY_NOTIFY = 16
-KEY_CREATE_LINK = 32
-KEY_WOW64_32KEY = 512
-KEY_WOW64_64KEY = 256
-KEY_WOW64_RES = 768
-KEY_READ = (
-    STANDARD_RIGHTS_READ | KEY_QUERY_VALUE | KEY_ENUMERATE_SUB_KEYS | KEY_NOTIFY
-) & (~SYNCHRONIZE)
-KEY_WRITE = (STANDARD_RIGHTS_WRITE | KEY_SET_VALUE | KEY_CREATE_SUB_KEY) & (
-    ~SYNCHRONIZE
-)
-KEY_EXECUTE = (KEY_READ) & (~SYNCHRONIZE)
-KEY_ALL_ACCESS = (
-    STANDARD_RIGHTS_ALL
-    | KEY_QUERY_VALUE
-    | KEY_SET_VALUE
-    | KEY_CREATE_SUB_KEY
-    | KEY_ENUMERATE_SUB_KEYS
-    | KEY_NOTIFY
-    | KEY_CREATE_LINK
-) & (~SYNCHRONIZE)
-REG_NOTIFY_CHANGE_ATTRIBUTES = 2
-REG_NOTIFY_CHANGE_SECURITY = 8
-REG_RESOURCE_REQUIREMENTS_LIST = 10
-REG_NONE = 0  # No value type
-REG_SZ = 1  # Unicode nul terminated string
-REG_EXPAND_SZ = 2  # Unicode nul terminated string
-# (with environment variable references)
-REG_BINARY = 3  # Free form binary
-REG_DWORD = 4  # 32-bit number
-REG_DWORD_LITTLE_ENDIAN = 4  # 32-bit number (same as REG_DWORD)
-REG_DWORD_BIG_ENDIAN = 5  # 32-bit number
-REG_LINK = 6  # Symbolic Link (unicode)
-REG_MULTI_SZ = 7  # Multiple Unicode strings
-REG_RESOURCE_LIST = 8  # Resource list in the resource map
-REG_FULL_RESOURCE_DESCRIPTOR = 9  # Resource list in the hardware description
-REG_RESOURCE_REQUIREMENTS_LIST = 10
-REG_QWORD = 11  # 64-bit number
-REG_QWORD_LITTLE_ENDIAN = 11  # 64-bit number (same as REG_QWORD)
-
-
-# Generated by h2py from \msvc20\include\winnt.h
-# hacked and split by mhammond.
-# Included from string.h
-_NLSCMPERROR = 2147483647
-NULL = 0
-HEAP_NO_SERIALIZE = 1
-HEAP_GROWABLE = 2
-HEAP_GENERATE_EXCEPTIONS = 4
-HEAP_ZERO_MEMORY = 8
-HEAP_REALLOC_IN_PLACE_ONLY = 16
-HEAP_TAIL_CHECKING_ENABLED = 32
-HEAP_FREE_CHECKING_ENABLED = 64
-HEAP_DISABLE_COALESCE_ON_FREE = 128
-IS_TEXT_UNICODE_ASCII16 = 1
-IS_TEXT_UNICODE_REVERSE_ASCII16 = 16
-IS_TEXT_UNICODE_STATISTICS = 2
-IS_TEXT_UNICODE_REVERSE_STATISTICS = 32
-IS_TEXT_UNICODE_CONTROLS = 4
-IS_TEXT_UNICODE_REVERSE_CONTROLS = 64
-IS_TEXT_UNICODE_SIGNATURE = 8
-IS_TEXT_UNICODE_REVERSE_SIGNATURE = 128
-IS_TEXT_UNICODE_ILLEGAL_CHARS = 256
-IS_TEXT_UNICODE_ODD_LENGTH = 512
-IS_TEXT_UNICODE_DBCS_LEADBYTE = 1024
-IS_TEXT_UNICODE_NULL_BYTES = 4096
-IS_TEXT_UNICODE_UNICODE_MASK = 15
-IS_TEXT_UNICODE_REVERSE_MASK = 240
-IS_TEXT_UNICODE_NOT_UNICODE_MASK = 3840
-IS_TEXT_UNICODE_NOT_ASCII_MASK = 61440
-COMPRESSION_FORMAT_NONE = 0
-COMPRESSION_FORMAT_DEFAULT = 1
-COMPRESSION_FORMAT_LZNT1 = 2
-COMPRESSION_ENGINE_STANDARD = 0
-COMPRESSION_ENGINE_MAXIMUM = 256
-MESSAGE_RESOURCE_UNICODE = 1
-RTL_CRITSECT_TYPE = 0
-RTL_RESOURCE_TYPE = 1
-DLL_PROCESS_ATTACH = 1
-DLL_THREAD_ATTACH = 2
-DLL_THREAD_DETACH = 3
-DLL_PROCESS_DETACH = 0
-EVENTLOG_SEQUENTIAL_READ = 0x0001
-EVENTLOG_SEEK_READ = 0x0002
-EVENTLOG_FORWARDS_READ = 0x0004
-EVENTLOG_BACKWARDS_READ = 0x0008
-EVENTLOG_SUCCESS = 0x0000
-EVENTLOG_ERROR_TYPE = 1
-EVENTLOG_WARNING_TYPE = 2
-EVENTLOG_INFORMATION_TYPE = 4
-EVENTLOG_AUDIT_SUCCESS = 8
-EVENTLOG_AUDIT_FAILURE = 16
-EVENTLOG_START_PAIRED_EVENT = 1
-EVENTLOG_END_PAIRED_EVENT = 2
-EVENTLOG_END_ALL_PAIRED_EVENTS = 4
-EVENTLOG_PAIRED_EVENT_ACTIVE = 8
-EVENTLOG_PAIRED_EVENT_INACTIVE = 16
-# Generated by h2py from \msvc20\include\winnt.h
-# hacked and split by mhammond.
-OWNER_SECURITY_INFORMATION = 0x00000001
-GROUP_SECURITY_INFORMATION = 0x00000002
-DACL_SECURITY_INFORMATION = 0x00000004
-SACL_SECURITY_INFORMATION = 0x00000008
-IMAGE_SIZEOF_FILE_HEADER = 20
-IMAGE_FILE_MACHINE_UNKNOWN = 0
-IMAGE_NUMBEROF_DIRECTORY_ENTRIES = 16
-IMAGE_SIZEOF_ROM_OPTIONAL_HEADER = 56
-IMAGE_SIZEOF_STD_OPTIONAL_HEADER = 28
-IMAGE_SIZEOF_NT_OPTIONAL_HEADER = 224
-IMAGE_NT_OPTIONAL_HDR_MAGIC = 267
-IMAGE_ROM_OPTIONAL_HDR_MAGIC = 263
-IMAGE_SIZEOF_SHORT_NAME = 8
-IMAGE_SIZEOF_SECTION_HEADER = 40
-IMAGE_SIZEOF_SYMBOL = 18
-IMAGE_SYM_CLASS_NULL = 0
-IMAGE_SYM_CLASS_AUTOMATIC = 1
-IMAGE_SYM_CLASS_EXTERNAL = 2
-IMAGE_SYM_CLASS_STATIC = 3
-IMAGE_SYM_CLASS_REGISTER = 4
-IMAGE_SYM_CLASS_EXTERNAL_DEF = 5
-IMAGE_SYM_CLASS_LABEL = 6
-IMAGE_SYM_CLASS_UNDEFINED_LABEL = 7
-IMAGE_SYM_CLASS_MEMBER_OF_STRUCT = 8
-IMAGE_SYM_CLASS_ARGUMENT = 9
-IMAGE_SYM_CLASS_STRUCT_TAG = 10
-IMAGE_SYM_CLASS_MEMBER_OF_UNION = 11
-IMAGE_SYM_CLASS_UNION_TAG = 12
-IMAGE_SYM_CLASS_TYPE_DEFINITION = 13
-IMAGE_SYM_CLASS_UNDEFINED_STATIC = 14
-IMAGE_SYM_CLASS_ENUM_TAG = 15
-IMAGE_SYM_CLASS_MEMBER_OF_ENUM = 16
-IMAGE_SYM_CLASS_REGISTER_PARAM = 17
-IMAGE_SYM_CLASS_BIT_FIELD = 18
-IMAGE_SYM_CLASS_BLOCK = 100
-IMAGE_SYM_CLASS_FUNCTION = 101
-IMAGE_SYM_CLASS_END_OF_STRUCT = 102
-IMAGE_SYM_CLASS_FILE = 103
-IMAGE_SYM_CLASS_SECTION = 104
-IMAGE_SYM_CLASS_WEAK_EXTERNAL = 105
-N_BTMASK = 15
-N_TMASK = 48
-N_TMASK1 = 192
-N_TMASK2 = 240
-N_BTSHFT = 4
-N_TSHIFT = 2
-IMAGE_SIZEOF_AUX_SYMBOL = 18
-IMAGE_COMDAT_SELECT_NODUPLICATES = 1
-IMAGE_COMDAT_SELECT_ANY = 2
-IMAGE_COMDAT_SELECT_SAME_SIZE = 3
-IMAGE_COMDAT_SELECT_EXACT_MATCH = 4
-IMAGE_COMDAT_SELECT_ASSOCIATIVE = 5
-IMAGE_WEAK_EXTERN_SEARCH_NOLIBRARY = 1
-IMAGE_WEAK_EXTERN_SEARCH_LIBRARY = 2
-IMAGE_WEAK_EXTERN_SEARCH_ALIAS = 3
-IMAGE_SIZEOF_RELOCATION = 10
-IMAGE_REL_I386_SECTION = 10
-IMAGE_REL_I386_SECREL = 11
-IMAGE_REL_MIPS_REFHALF = 1
-IMAGE_REL_MIPS_REFWORD = 2
-IMAGE_REL_MIPS_JMPADDR = 3
-IMAGE_REL_MIPS_REFHI = 4
-IMAGE_REL_MIPS_REFLO = 5
-IMAGE_REL_MIPS_GPREL = 6
-IMAGE_REL_MIPS_LITERAL = 7
-IMAGE_REL_MIPS_SECTION = 10
-IMAGE_REL_MIPS_SECREL = 11
-IMAGE_REL_MIPS_REFWORDNB = 34
-IMAGE_REL_MIPS_PAIR = 37
-IMAGE_REL_ALPHA_ABSOLUTE = 0
-IMAGE_REL_ALPHA_REFLONG = 1
-IMAGE_REL_ALPHA_REFQUAD = 2
-IMAGE_REL_ALPHA_GPREL32 = 3
-IMAGE_REL_ALPHA_LITERAL = 4
-IMAGE_REL_ALPHA_LITUSE = 5
-IMAGE_REL_ALPHA_GPDISP = 6
-IMAGE_REL_ALPHA_BRADDR = 7
-IMAGE_REL_ALPHA_HINT = 8
-IMAGE_REL_ALPHA_INLINE_REFLONG = 9
-IMAGE_REL_ALPHA_REFHI = 10
-IMAGE_REL_ALPHA_REFLO = 11
-IMAGE_REL_ALPHA_PAIR = 12
-IMAGE_REL_ALPHA_MATCH = 13
-IMAGE_REL_ALPHA_SECTION = 14
-IMAGE_REL_ALPHA_SECREL = 15
-IMAGE_REL_ALPHA_REFLONGNB = 16
-IMAGE_SIZEOF_BASE_RELOCATION = 8
-IMAGE_REL_BASED_ABSOLUTE = 0
-IMAGE_REL_BASED_HIGH = 1
-IMAGE_REL_BASED_LOW = 2
-IMAGE_REL_BASED_HIGHLOW = 3
-IMAGE_REL_BASED_HIGHADJ = 4
-IMAGE_REL_BASED_MIPS_JMPADDR = 5
-IMAGE_SIZEOF_LINENUMBER = 6
-IMAGE_ARCHIVE_START_SIZE = 8
-IMAGE_ARCHIVE_START = "!<arch>\n"
-IMAGE_ARCHIVE_END = "`\n"
-IMAGE_ARCHIVE_PAD = "\n"
-IMAGE_ARCHIVE_LINKER_MEMBER = "/               "
-IMAGE_ARCHIVE_LONGNAMES_MEMBER = "//              "
-IMAGE_SIZEOF_ARCHIVE_MEMBER_HDR = 60
-IMAGE_ORDINAL_FLAG = -2147483648
-
-
-def IMAGE_SNAP_BY_ORDINAL(Ordinal):
-    return (Ordinal & IMAGE_ORDINAL_FLAG) != 0
-
-
-def IMAGE_ORDINAL(Ordinal):
-    return Ordinal & 65535
-
-
-IMAGE_RESOURCE_NAME_IS_STRING = -2147483648
-IMAGE_RESOURCE_DATA_IS_DIRECTORY = -2147483648
-IMAGE_DEBUG_TYPE_UNKNOWN = 0
-IMAGE_DEBUG_TYPE_COFF = 1
-IMAGE_DEBUG_TYPE_CODEVIEW = 2
-IMAGE_DEBUG_TYPE_FPO = 3
-IMAGE_DEBUG_TYPE_MISC = 4
-IMAGE_DEBUG_TYPE_EXCEPTION = 5
-IMAGE_DEBUG_TYPE_FIXUP = 6
-IMAGE_DEBUG_TYPE_OMAP_TO_SRC = 7
-IMAGE_DEBUG_TYPE_OMAP_FROM_SRC = 8
-FRAME_FPO = 0
-FRAME_TRAP = 1
-FRAME_TSS = 2
-SIZEOF_RFPO_DATA = 16
-IMAGE_DEBUG_MISC_EXENAME = 1
-IMAGE_SEPARATE_DEBUG_SIGNATURE = 18756
-# Generated by h2py from \msvcnt\include\wingdi.h
-# hacked and split manually by mhammond.
-NEWFRAME = 1
-ABORTDOC = 2
-NEXTBAND = 3
-SETCOLORTABLE = 4
-GETCOLORTABLE = 5
-FLUSHOUTPUT = 6
-DRAFTMODE = 7
-QUERYESCSUPPORT = 8
-SETABORTPROC = 9
-STARTDOC = 10
-ENDDOC = 11
-GETPHYSPAGESIZE = 12
-GETPRINTINGOFFSET = 13
-GETSCALINGFACTOR = 14
-MFCOMMENT = 15
-GETPENWIDTH = 16
-SETCOPYCOUNT = 17
-SELECTPAPERSOURCE = 18
-DEVICEDATA = 19
-PASSTHROUGH = 19
-GETTECHNOLGY = 20
-GETTECHNOLOGY = 20
-SETLINECAP = 21
-SETLINEJOIN = 22
-SETMITERLIMIT = 23
-BANDINFO = 24
-DRAWPATTERNRECT = 25
-GETVECTORPENSIZE = 26
-GETVECTORBRUSHSIZE = 27
-ENABLEDUPLEX = 28
-GETSETPAPERBINS = 29
-GETSETPRINTORIENT = 30
-ENUMPAPERBINS = 31
-SETDIBSCALING = 32
-EPSPRINTING = 33
-ENUMPAPERMETRICS = 34
-GETSETPAPERMETRICS = 35
-POSTSCRIPT_DATA = 37
-POSTSCRIPT_IGNORE = 38
-MOUSETRAILS = 39
-GETDEVICEUNITS = 42
-GETEXTENDEDTEXTMETRICS = 256
-GETEXTENTTABLE = 257
-GETPAIRKERNTABLE = 258
-GETTRACKKERNTABLE = 259
-EXTTEXTOUT = 512
-GETFACENAME = 513
-DOWNLOADFACE = 514
-ENABLERELATIVEWIDTHS = 768
-ENABLEPAIRKERNING = 769
-SETKERNTRACK = 770
-SETALLJUSTVALUES = 771
-SETCHARSET = 772
-STRETCHBLT = 2048
-GETSETSCREENPARAMS = 3072
-BEGIN_PATH = 4096
-CLIP_TO_PATH = 4097
-END_PATH = 4098
-EXT_DEVICE_CAPS = 4099
-RESTORE_CTM = 4100
-SAVE_CTM = 4101
-SET_ARC_DIRECTION = 4102
-SET_BACKGROUND_COLOR = 4103
-SET_POLY_MODE = 4104
-SET_SCREEN_ANGLE = 4105
-SET_SPREAD = 4106
-TRANSFORM_CTM = 4107
-SET_CLIP_BOX = 4108
-SET_BOUNDS = 4109
-SET_MIRROR_MODE = 4110
-OPENCHANNEL = 4110
-DOWNLOADHEADER = 4111
-CLOSECHANNEL = 4112
-POSTSCRIPT_PASSTHROUGH = 4115
-ENCAPSULATED_POSTSCRIPT = 4116
-SP_NOTREPORTED = 16384
-SP_ERROR = -1
-SP_APPABORT = -2
-SP_USERABORT = -3
-SP_OUTOFDISK = -4
-SP_OUTOFMEMORY = -5
-PR_JOBSTATUS = 0
-
-## GDI object types
-OBJ_PEN = 1
-OBJ_BRUSH = 2
-OBJ_DC = 3
-OBJ_METADC = 4
-OBJ_PAL = 5
-OBJ_FONT = 6
-OBJ_BITMAP = 7
-OBJ_REGION = 8
-OBJ_METAFILE = 9
-OBJ_MEMDC = 10
-OBJ_EXTPEN = 11
-OBJ_ENHMETADC = 12
-OBJ_ENHMETAFILE = 13
-OBJ_COLORSPACE = 14
-
-MWT_IDENTITY = 1
-MWT_LEFTMULTIPLY = 2
-MWT_RIGHTMULTIPLY = 3
-MWT_MIN = MWT_IDENTITY
-MWT_MAX = MWT_RIGHTMULTIPLY
-BI_RGB = 0
-BI_RLE8 = 1
-BI_RLE4 = 2
-BI_BITFIELDS = 3
-TMPF_FIXED_PITCH = 1
-TMPF_VECTOR = 2
-TMPF_DEVICE = 8
-TMPF_TRUETYPE = 4
-NTM_REGULAR = 64
-NTM_BOLD = 32
-NTM_ITALIC = 1
-LF_FACESIZE = 32
-LF_FULLFACESIZE = 64
-OUT_DEFAULT_PRECIS = 0
-OUT_STRING_PRECIS = 1
-OUT_CHARACTER_PRECIS = 2
-OUT_STROKE_PRECIS = 3
-OUT_TT_PRECIS = 4
-OUT_DEVICE_PRECIS = 5
-OUT_RASTER_PRECIS = 6
-OUT_TT_ONLY_PRECIS = 7
-OUT_OUTLINE_PRECIS = 8
-CLIP_DEFAULT_PRECIS = 0
-CLIP_CHARACTER_PRECIS = 1
-CLIP_STROKE_PRECIS = 2
-CLIP_MASK = 15
-CLIP_LH_ANGLES = 1 << 4
-CLIP_TT_ALWAYS = 2 << 4
-CLIP_EMBEDDED = 8 << 4
-DEFAULT_QUALITY = 0
-DRAFT_QUALITY = 1
-PROOF_QUALITY = 2
-NONANTIALIASED_QUALITY = 3
-ANTIALIASED_QUALITY = 4
-CLEARTYPE_QUALITY = 5
-CLEARTYPE_NATURAL_QUALITY = 6
-DEFAULT_PITCH = 0
-FIXED_PITCH = 1
-VARIABLE_PITCH = 2
-ANSI_CHARSET = 0
-DEFAULT_CHARSET = 1
-SYMBOL_CHARSET = 2
-SHIFTJIS_CHARSET = 128
-HANGEUL_CHARSET = 129
-CHINESEBIG5_CHARSET = 136
-OEM_CHARSET = 255
-JOHAB_CHARSET = 130
-HEBREW_CHARSET = 177
-ARABIC_CHARSET = 178
-GREEK_CHARSET = 161
-TURKISH_CHARSET = 162
-VIETNAMESE_CHARSET = 163
-THAI_CHARSET = 222
-EASTEUROPE_CHARSET = 238
-RUSSIAN_CHARSET = 204
-MAC_CHARSET = 77
-BALTIC_CHARSET = 186
-FF_DONTCARE = 0 << 4
-FF_ROMAN = 1 << 4
-FF_SWISS = 2 << 4
-FF_MODERN = 3 << 4
-FF_SCRIPT = 4 << 4
-FF_DECORATIVE = 5 << 4
-FW_DONTCARE = 0
-FW_THIN = 100
-FW_EXTRALIGHT = 200
-FW_LIGHT = 300
-FW_NORMAL = 400
-FW_MEDIUM = 500
-FW_SEMIBOLD = 600
-FW_BOLD = 700
-FW_EXTRABOLD = 800
-FW_HEAVY = 900
-FW_ULTRALIGHT = FW_EXTRALIGHT
-FW_REGULAR = FW_NORMAL
-FW_DEMIBOLD = FW_SEMIBOLD
-FW_ULTRABOLD = FW_EXTRABOLD
-FW_BLACK = FW_HEAVY
-# Generated by h2py from \msvcnt\include\wingdi.h
-# hacked and split manually by mhammond.
-BS_SOLID = 0
-BS_NULL = 1
-BS_HOLLOW = BS_NULL
-BS_HATCHED = 2
-BS_PATTERN = 3
-BS_INDEXED = 4
-BS_DIBPATTERN = 5
-BS_DIBPATTERNPT = 6
-BS_PATTERN8X8 = 7
-BS_DIBPATTERN8X8 = 8
-HS_HORIZONTAL = 0
-HS_VERTICAL = 1
-HS_FDIAGONAL = 2
-HS_BDIAGONAL = 3
-HS_CROSS = 4
-HS_DIAGCROSS = 5
-HS_FDIAGONAL1 = 6
-HS_BDIAGONAL1 = 7
-HS_SOLID = 8
-HS_DENSE1 = 9
-HS_DENSE2 = 10
-HS_DENSE3 = 11
-HS_DENSE4 = 12
-HS_DENSE5 = 13
-HS_DENSE6 = 14
-HS_DENSE7 = 15
-HS_DENSE8 = 16
-HS_NOSHADE = 17
-HS_HALFTONE = 18
-HS_SOLIDCLR = 19
-HS_DITHEREDCLR = 20
-HS_SOLIDTEXTCLR = 21
-HS_DITHEREDTEXTCLR = 22
-HS_SOLIDBKCLR = 23
-HS_DITHEREDBKCLR = 24
-HS_API_MAX = 25
-PS_SOLID = 0
-PS_DASH = 1
-PS_DOT = 2
-PS_DASHDOT = 3
-PS_DASHDOTDOT = 4
-PS_NULL = 5
-PS_INSIDEFRAME = 6
-PS_USERSTYLE = 7
-PS_ALTERNATE = 8
-PS_STYLE_MASK = 15
-PS_ENDCAP_ROUND = 0
-PS_ENDCAP_SQUARE = 256
-PS_ENDCAP_FLAT = 512
-PS_ENDCAP_MASK = 3840
-PS_JOIN_ROUND = 0
-PS_JOIN_BEVEL = 4096
-PS_JOIN_MITER = 8192
-PS_JOIN_MASK = 61440
-PS_COSMETIC = 0
-PS_GEOMETRIC = 65536
-PS_TYPE_MASK = 983040
-AD_COUNTERCLOCKWISE = 1
-AD_CLOCKWISE = 2
-DRIVERVERSION = 0
-TECHNOLOGY = 2
-HORZSIZE = 4
-VERTSIZE = 6
-HORZRES = 8
-VERTRES = 10
-BITSPIXEL = 12
-PLANES = 14
-NUMBRUSHES = 16
-NUMPENS = 18
-NUMMARKERS = 20
-NUMFONTS = 22
-NUMCOLORS = 24
-PDEVICESIZE = 26
-CURVECAPS = 28
-LINECAPS = 30
-POLYGONALCAPS = 32
-TEXTCAPS = 34
-CLIPCAPS = 36
-RASTERCAPS = 38
-ASPECTX = 40
-ASPECTY = 42
-ASPECTXY = 44
-LOGPIXELSX = 88
-LOGPIXELSY = 90
-SIZEPALETTE = 104
-NUMRESERVED = 106
-COLORRES = 108
-
-PHYSICALWIDTH = 110
-PHYSICALHEIGHT = 111
-PHYSICALOFFSETX = 112
-PHYSICALOFFSETY = 113
-SCALINGFACTORX = 114
-SCALINGFACTORY = 115
-VREFRESH = 116
-DESKTOPVERTRES = 117
-DESKTOPHORZRES = 118
-BLTALIGNMENT = 119
-SHADEBLENDCAPS = 120
-COLORMGMTCAPS = 121
-
-DT_PLOTTER = 0
-DT_RASDISPLAY = 1
-DT_RASPRINTER = 2
-DT_RASCAMERA = 3
-DT_CHARSTREAM = 4
-DT_METAFILE = 5
-DT_DISPFILE = 6
-CC_NONE = 0
-CC_CIRCLES = 1
-CC_PIE = 2
-CC_CHORD = 4
-CC_ELLIPSES = 8
-CC_WIDE = 16
-CC_STYLED = 32
-CC_WIDESTYLED = 64
-CC_INTERIORS = 128
-CC_ROUNDRECT = 256
-LC_NONE = 0
-LC_POLYLINE = 2
-LC_MARKER = 4
-LC_POLYMARKER = 8
-LC_WIDE = 16
-LC_STYLED = 32
-LC_WIDESTYLED = 64
-LC_INTERIORS = 128
-PC_NONE = 0
-PC_POLYGON = 1
-PC_RECTANGLE = 2
-PC_WINDPOLYGON = 4
-PC_TRAPEZOID = 4
-PC_SCANLINE = 8
-PC_WIDE = 16
-PC_STYLED = 32
-PC_WIDESTYLED = 64
-PC_INTERIORS = 128
-CP_NONE = 0
-CP_RECTANGLE = 1
-CP_REGION = 2
-TC_OP_CHARACTER = 1
-TC_OP_STROKE = 2
-TC_CP_STROKE = 4
-TC_CR_90 = 8
-TC_CR_ANY = 16
-TC_SF_X_YINDEP = 32
-TC_SA_DOUBLE = 64
-TC_SA_INTEGER = 128
-TC_SA_CONTIN = 256
-TC_EA_DOUBLE = 512
-TC_IA_ABLE = 1024
-TC_UA_ABLE = 2048
-TC_SO_ABLE = 4096
-TC_RA_ABLE = 8192
-TC_VA_ABLE = 16384
-TC_RESERVED = 32768
-TC_SCROLLBLT = 65536
-RC_BITBLT = 1
-RC_BANDING = 2
-RC_SCALING = 4
-RC_BITMAP64 = 8
-RC_GDI20_OUTPUT = 16
-RC_GDI20_STATE = 32
-RC_SAVEBITMAP = 64
-RC_DI_BITMAP = 128
-RC_PALETTE = 256
-RC_DIBTODEV = 512
-RC_BIGFONT = 1024
-RC_STRETCHBLT = 2048
-RC_FLOODFILL = 4096
-RC_STRETCHDIB = 8192
-RC_OP_DX_OUTPUT = 16384
-RC_DEVBITS = 32768
-DIB_RGB_COLORS = 0
-DIB_PAL_COLORS = 1
-DIB_PAL_INDICES = 2
-DIB_PAL_PHYSINDICES = 2
-DIB_PAL_LOGINDICES = 4
-SYSPAL_ERROR = 0
-SYSPAL_STATIC = 1
-SYSPAL_NOSTATIC = 2
-CBM_CREATEDIB = 2
-CBM_INIT = 4
-FLOODFILLBORDER = 0
-FLOODFILLSURFACE = 1
-CCHDEVICENAME = 32
-CCHFORMNAME = 32
-# Generated by h2py from \msvcnt\include\wingdi.h
-# hacked and split manually by mhammond.
-
-# DEVMODE.dmFields
-DM_SPECVERSION = 800
-DM_ORIENTATION = 1
-DM_PAPERSIZE = 2
-DM_PAPERLENGTH = 4
-DM_PAPERWIDTH = 8
-DM_SCALE = 16
-DM_POSITION = 32
-DM_NUP = 64
-DM_DISPLAYORIENTATION = 128
-DM_COPIES = 256
-DM_DEFAULTSOURCE = 512
-DM_PRINTQUALITY = 1024
-DM_COLOR = 2048
-DM_DUPLEX = 4096
-DM_YRESOLUTION = 8192
-DM_TTOPTION = 16384
-DM_COLLATE = 32768
-DM_FORMNAME = 65536
-DM_LOGPIXELS = 131072
-DM_BITSPERPEL = 262144
-DM_PELSWIDTH = 524288
-DM_PELSHEIGHT = 1048576
-DM_DISPLAYFLAGS = 2097152
-DM_DISPLAYFREQUENCY = 4194304
-DM_ICMMETHOD = 8388608
-DM_ICMINTENT = 16777216
-DM_MEDIATYPE = 33554432
-DM_DITHERTYPE = 67108864
-DM_PANNINGWIDTH = 134217728
-DM_PANNINGHEIGHT = 268435456
-DM_DISPLAYFIXEDOUTPUT = 536870912
-
-# DEVMODE.dmOrientation
-DMORIENT_PORTRAIT = 1
-DMORIENT_LANDSCAPE = 2
-
-# DEVMODE.dmDisplayOrientation
-DMDO_DEFAULT = 0
-DMDO_90 = 1
-DMDO_180 = 2
-DMDO_270 = 3
-
-# DEVMODE.dmDisplayFixedOutput
-DMDFO_DEFAULT = 0
-DMDFO_STRETCH = 1
-DMDFO_CENTER = 2
-
-# DEVMODE.dmPaperSize
-DMPAPER_LETTER = 1
-DMPAPER_LETTERSMALL = 2
-DMPAPER_TABLOID = 3
-DMPAPER_LEDGER = 4
-DMPAPER_LEGAL = 5
-DMPAPER_STATEMENT = 6
-DMPAPER_EXECUTIVE = 7
-DMPAPER_A3 = 8
-DMPAPER_A4 = 9
-DMPAPER_A4SMALL = 10
-DMPAPER_A5 = 11
-DMPAPER_B4 = 12
-DMPAPER_B5 = 13
-DMPAPER_FOLIO = 14
-DMPAPER_QUARTO = 15
-DMPAPER_10X14 = 16
-DMPAPER_11X17 = 17
-DMPAPER_NOTE = 18
-DMPAPER_ENV_9 = 19
-DMPAPER_ENV_10 = 20
-DMPAPER_ENV_11 = 21
-DMPAPER_ENV_12 = 22
-DMPAPER_ENV_14 = 23
-DMPAPER_CSHEET = 24
-DMPAPER_DSHEET = 25
-DMPAPER_ESHEET = 26
-DMPAPER_ENV_DL = 27
-DMPAPER_ENV_C5 = 28
-DMPAPER_ENV_C3 = 29
-DMPAPER_ENV_C4 = 30
-DMPAPER_ENV_C6 = 31
-DMPAPER_ENV_C65 = 32
-DMPAPER_ENV_B4 = 33
-DMPAPER_ENV_B5 = 34
-DMPAPER_ENV_B6 = 35
-DMPAPER_ENV_ITALY = 36
-DMPAPER_ENV_MONARCH = 37
-DMPAPER_ENV_PERSONAL = 38
-DMPAPER_FANFOLD_US = 39
-DMPAPER_FANFOLD_STD_GERMAN = 40
-DMPAPER_FANFOLD_LGL_GERMAN = 41
-DMPAPER_ISO_B4 = 42
-DMPAPER_JAPANESE_POSTCARD = 43
-DMPAPER_9X11 = 44
-DMPAPER_10X11 = 45
-DMPAPER_15X11 = 46
-DMPAPER_ENV_INVITE = 47
-DMPAPER_RESERVED_48 = 48
-DMPAPER_RESERVED_49 = 49
-DMPAPER_LETTER_EXTRA = 50
-DMPAPER_LEGAL_EXTRA = 51
-DMPAPER_TABLOID_EXTRA = 52
-DMPAPER_A4_EXTRA = 53
-DMPAPER_LETTER_TRANSVERSE = 54
-DMPAPER_A4_TRANSVERSE = 55
-DMPAPER_LETTER_EXTRA_TRANSVERSE = 56
-DMPAPER_A_PLUS = 57
-DMPAPER_B_PLUS = 58
-DMPAPER_LETTER_PLUS = 59
-DMPAPER_A4_PLUS = 60
-DMPAPER_A5_TRANSVERSE = 61
-DMPAPER_B5_TRANSVERSE = 62
-DMPAPER_A3_EXTRA = 63
-DMPAPER_A5_EXTRA = 64
-DMPAPER_B5_EXTRA = 65
-DMPAPER_A2 = 66
-DMPAPER_A3_TRANSVERSE = 67
-DMPAPER_A3_EXTRA_TRANSVERSE = 68
-DMPAPER_DBL_JAPANESE_POSTCARD = 69
-DMPAPER_A6 = 70
-DMPAPER_JENV_KAKU2 = 71
-DMPAPER_JENV_KAKU3 = 72
-DMPAPER_JENV_CHOU3 = 73
-DMPAPER_JENV_CHOU4 = 74
-DMPAPER_LETTER_ROTATED = 75
-DMPAPER_A3_ROTATED = 76
-DMPAPER_A4_ROTATED = 77
-DMPAPER_A5_ROTATED = 78
-DMPAPER_B4_JIS_ROTATED = 79
-DMPAPER_B5_JIS_ROTATED = 80
-DMPAPER_JAPANESE_POSTCARD_ROTATED = 81
-DMPAPER_DBL_JAPANESE_POSTCARD_ROTATED = 82
-DMPAPER_A6_ROTATED = 83
-DMPAPER_JENV_KAKU2_ROTATED = 84
-DMPAPER_JENV_KAKU3_ROTATED = 85
-DMPAPER_JENV_CHOU3_ROTATED = 86
-DMPAPER_JENV_CHOU4_ROTATED = 87
-DMPAPER_B6_JIS = 88
-DMPAPER_B6_JIS_ROTATED = 89
-DMPAPER_12X11 = 90
-DMPAPER_JENV_YOU4 = 91
-DMPAPER_JENV_YOU4_ROTATED = 92
-DMPAPER_P16K = 93
-DMPAPER_P32K = 94
-DMPAPER_P32KBIG = 95
-DMPAPER_PENV_1 = 96
-DMPAPER_PENV_2 = 97
-DMPAPER_PENV_3 = 98
-DMPAPER_PENV_4 = 99
-DMPAPER_PENV_5 = 100
-DMPAPER_PENV_6 = 101
-DMPAPER_PENV_7 = 102
-DMPAPER_PENV_8 = 103
-DMPAPER_PENV_9 = 104
-DMPAPER_PENV_10 = 105
-DMPAPER_P16K_ROTATED = 106
-DMPAPER_P32K_ROTATED = 107
-DMPAPER_P32KBIG_ROTATED = 108
-DMPAPER_PENV_1_ROTATED = 109
-DMPAPER_PENV_2_ROTATED = 110
-DMPAPER_PENV_3_ROTATED = 111
-DMPAPER_PENV_4_ROTATED = 112
-DMPAPER_PENV_5_ROTATED = 113
-DMPAPER_PENV_6_ROTATED = 114
-DMPAPER_PENV_7_ROTATED = 115
-DMPAPER_PENV_8_ROTATED = 116
-DMPAPER_PENV_9_ROTATED = 117
-DMPAPER_PENV_10_ROTATED = 118
-DMPAPER_LAST = DMPAPER_PENV_10_ROTATED
-DMPAPER_USER = 256
-
-# DEVMODE.dmDefaultSource
-DMBIN_UPPER = 1
-DMBIN_ONLYONE = 1
-DMBIN_LOWER = 2
-DMBIN_MIDDLE = 3
-DMBIN_MANUAL = 4
-DMBIN_ENVELOPE = 5
-DMBIN_ENVMANUAL = 6
-DMBIN_AUTO = 7
-DMBIN_TRACTOR = 8
-DMBIN_SMALLFMT = 9
-DMBIN_LARGEFMT = 10
-DMBIN_LARGECAPACITY = 11
-DMBIN_CASSETTE = 14
-DMBIN_FORMSOURCE = 15
-DMBIN_LAST = DMBIN_FORMSOURCE
-DMBIN_USER = 256
-
-# DEVMODE.dmPrintQuality
-DMRES_DRAFT = -1
-DMRES_LOW = -2
-DMRES_MEDIUM = -3
-DMRES_HIGH = -4
-
-# DEVMODE.dmColor
-DMCOLOR_MONOCHROME = 1
-DMCOLOR_COLOR = 2
-
-# DEVMODE.dmDuplex
-DMDUP_SIMPLEX = 1
-DMDUP_VERTICAL = 2
-DMDUP_HORIZONTAL = 3
-
-# DEVMODE.dmTTOption
-DMTT_BITMAP = 1
-DMTT_DOWNLOAD = 2
-DMTT_SUBDEV = 3
-DMTT_DOWNLOAD_OUTLINE = 4
-
-# DEVMODE.dmCollate
-DMCOLLATE_FALSE = 0
-DMCOLLATE_TRUE = 1
-
-# DEVMODE.dmDisplayFlags
-DM_GRAYSCALE = 1
-DM_INTERLACED = 2
-
-# DEVMODE.dmICMMethod
-DMICMMETHOD_NONE = 1
-DMICMMETHOD_SYSTEM = 2
-DMICMMETHOD_DRIVER = 3
-DMICMMETHOD_DEVICE = 4
-DMICMMETHOD_USER = 256
-
-# DEVMODE.dmICMIntent
-DMICM_SATURATE = 1
-DMICM_CONTRAST = 2
-DMICM_COLORIMETRIC = 3
-DMICM_ABS_COLORIMETRIC = 4
-DMICM_USER = 256
-
-# DEVMODE.dmMediaType
-DMMEDIA_STANDARD = 1
-DMMEDIA_TRANSPARENCY = 2
-DMMEDIA_GLOSSY = 3
-DMMEDIA_USER = 256
-
-# DEVMODE.dmDitherType
-DMDITHER_NONE = 1
-DMDITHER_COARSE = 2
-DMDITHER_FINE = 3
-DMDITHER_LINEART = 4
-DMDITHER_ERRORDIFFUSION = 5
-DMDITHER_RESERVED6 = 6
-DMDITHER_RESERVED7 = 7
-DMDITHER_RESERVED8 = 8
-DMDITHER_RESERVED9 = 9
-DMDITHER_GRAYSCALE = 10
-DMDITHER_USER = 256
-
-# DEVMODE.dmNup
-DMNUP_SYSTEM = 1
-DMNUP_ONEUP = 2
-
-# used with ExtEscape
-FEATURESETTING_NUP = 0
-FEATURESETTING_OUTPUT = 1
-FEATURESETTING_PSLEVEL = 2
-FEATURESETTING_CUSTPAPER = 3
-FEATURESETTING_MIRROR = 4
-FEATURESETTING_NEGATIVE = 5
-FEATURESETTING_PROTOCOL = 6
-FEATURESETTING_PRIVATE_BEGIN = 0x1000
-FEATURESETTING_PRIVATE_END = 0x1FFF
-
-RDH_RECTANGLES = 1
-GGO_METRICS = 0
-GGO_BITMAP = 1
-GGO_NATIVE = 2
-TT_POLYGON_TYPE = 24
-TT_PRIM_LINE = 1
-TT_PRIM_QSPLINE = 2
-TT_AVAILABLE = 1
-TT_ENABLED = 2
-DM_UPDATE = 1
-DM_COPY = 2
-DM_PROMPT = 4
-DM_MODIFY = 8
-DM_IN_BUFFER = DM_MODIFY
-DM_IN_PROMPT = DM_PROMPT
-DM_OUT_BUFFER = DM_COPY
-DM_OUT_DEFAULT = DM_UPDATE
-
-# DISPLAY_DEVICE.StateFlags
-DISPLAY_DEVICE_ATTACHED_TO_DESKTOP = 1
-DISPLAY_DEVICE_MULTI_DRIVER = 2
-DISPLAY_DEVICE_PRIMARY_DEVICE = 4
-DISPLAY_DEVICE_MIRRORING_DRIVER = 8
-DISPLAY_DEVICE_VGA_COMPATIBLE = 16
-DISPLAY_DEVICE_REMOVABLE = 32
-DISPLAY_DEVICE_MODESPRUNED = 134217728
-DISPLAY_DEVICE_REMOTE = 67108864
-DISPLAY_DEVICE_DISCONNECT = 33554432
-
-# DeviceCapabilities types
-DC_FIELDS = 1
-DC_PAPERS = 2
-DC_PAPERSIZE = 3
-DC_MINEXTENT = 4
-DC_MAXEXTENT = 5
-DC_BINS = 6
-DC_DUPLEX = 7
-DC_SIZE = 8
-DC_EXTRA = 9
-DC_VERSION = 10
-DC_DRIVER = 11
-DC_BINNAMES = 12
-DC_ENUMRESOLUTIONS = 13
-DC_FILEDEPENDENCIES = 14
-DC_TRUETYPE = 15
-DC_PAPERNAMES = 16
-DC_ORIENTATION = 17
-DC_COPIES = 18
-DC_BINADJUST = 19
-DC_EMF_COMPLIANT = 20
-DC_DATATYPE_PRODUCED = 21
-DC_COLLATE = 22
-DC_MANUFACTURER = 23
-DC_MODEL = 24
-DC_PERSONALITY = 25
-DC_PRINTRATE = 26
-DC_PRINTRATEUNIT = 27
-DC_PRINTERMEM = 28
-DC_MEDIAREADY = 29
-DC_STAPLE = 30
-DC_PRINTRATEPPM = 31
-DC_COLORDEVICE = 32
-DC_NUP = 33
-DC_MEDIATYPENAMES = 34
-DC_MEDIATYPES = 35
-
-PRINTRATEUNIT_PPM = 1
-PRINTRATEUNIT_CPS = 2
-PRINTRATEUNIT_LPM = 3
-PRINTRATEUNIT_IPM = 4
-
-# TrueType constants
-DCTT_BITMAP = 1
-DCTT_DOWNLOAD = 2
-DCTT_SUBDEV = 4
-DCTT_DOWNLOAD_OUTLINE = 8
-
-DCBA_FACEUPNONE = 0
-DCBA_FACEUPCENTER = 1
-DCBA_FACEUPLEFT = 2
-DCBA_FACEUPRIGHT = 3
-DCBA_FACEDOWNNONE = 256
-DCBA_FACEDOWNCENTER = 257
-DCBA_FACEDOWNLEFT = 258
-DCBA_FACEDOWNRIGHT = 259
-
-CA_NEGATIVE = 1
-CA_LOG_FILTER = 2
-ILLUMINANT_DEVICE_DEFAULT = 0
-ILLUMINANT_A = 1
-ILLUMINANT_B = 2
-ILLUMINANT_C = 3
-ILLUMINANT_D50 = 4
-ILLUMINANT_D55 = 5
-ILLUMINANT_D65 = 6
-ILLUMINANT_D75 = 7
-ILLUMINANT_F2 = 8
-ILLUMINANT_MAX_INDEX = ILLUMINANT_F2
-ILLUMINANT_TUNGSTEN = ILLUMINANT_A
-ILLUMINANT_DAYLIGHT = ILLUMINANT_C
-ILLUMINANT_FLUORESCENT = ILLUMINANT_F2
-ILLUMINANT_NTSC = ILLUMINANT_C
-
-# Generated by h2py from \msvcnt\include\wingdi.h
-# hacked and split manually by mhammond.
-FONTMAPPER_MAX = 10
-ENHMETA_SIGNATURE = 1179469088
-ENHMETA_STOCK_OBJECT = -2147483648
-EMR_HEADER = 1
-EMR_POLYBEZIER = 2
-EMR_POLYGON = 3
-EMR_POLYLINE = 4
-EMR_POLYBEZIERTO = 5
-EMR_POLYLINETO = 6
-EMR_POLYPOLYLINE = 7
-EMR_POLYPOLYGON = 8
-EMR_SETWINDOWEXTEX = 9
-EMR_SETWINDOWORGEX = 10
-EMR_SETVIEWPORTEXTEX = 11
-EMR_SETVIEWPORTORGEX = 12
-EMR_SETBRUSHORGEX = 13
-EMR_EOF = 14
-EMR_SETPIXELV = 15
-EMR_SETMAPPERFLAGS = 16
-EMR_SETMAPMODE = 17
-EMR_SETBKMODE = 18
-EMR_SETPOLYFILLMODE = 19
-EMR_SETROP2 = 20
-EMR_SETSTRETCHBLTMODE = 21
-EMR_SETTEXTALIGN = 22
-EMR_SETCOLORADJUSTMENT = 23
-EMR_SETTEXTCOLOR = 24
-EMR_SETBKCOLOR = 25
-EMR_OFFSETCLIPRGN = 26
-EMR_MOVETOEX = 27
-EMR_SETMETARGN = 28
-EMR_EXCLUDECLIPRECT = 29
-EMR_INTERSECTCLIPRECT = 30
-EMR_SCALEVIEWPORTEXTEX = 31
-EMR_SCALEWINDOWEXTEX = 32
-EMR_SAVEDC = 33
-EMR_RESTOREDC = 34
-EMR_SETWORLDTRANSFORM = 35
-EMR_MODIFYWORLDTRANSFORM = 36
-EMR_SELECTOBJECT = 37
-EMR_CREATEPEN = 38
-EMR_CREATEBRUSHINDIRECT = 39
-EMR_DELETEOBJECT = 40
-EMR_ANGLEARC = 41
-EMR_ELLIPSE = 42
-EMR_RECTANGLE = 43
-EMR_ROUNDRECT = 44
-EMR_ARC = 45
-EMR_CHORD = 46
-EMR_PIE = 47
-EMR_SELECTPALETTE = 48
-EMR_CREATEPALETTE = 49
-EMR_SETPALETTEENTRIES = 50
-EMR_RESIZEPALETTE = 51
-EMR_REALIZEPALETTE = 52
-EMR_EXTFLOODFILL = 53
-EMR_LINETO = 54
-EMR_ARCTO = 55
-EMR_POLYDRAW = 56
-EMR_SETARCDIRECTION = 57
-EMR_SETMITERLIMIT = 58
-EMR_BEGINPATH = 59
-EMR_ENDPATH = 60
-EMR_CLOSEFIGURE = 61
-EMR_FILLPATH = 62
-EMR_STROKEANDFILLPATH = 63
-EMR_STROKEPATH = 64
-EMR_FLATTENPATH = 65
-EMR_WIDENPATH = 66
-EMR_SELECTCLIPPATH = 67
-EMR_ABORTPATH = 68
-EMR_GDICOMMENT = 70
-EMR_FILLRGN = 71
-EMR_FRAMERGN = 72
-EMR_INVERTRGN = 73
-EMR_PAINTRGN = 74
-EMR_EXTSELECTCLIPRGN = 75
-EMR_BITBLT = 76
-EMR_STRETCHBLT = 77
-EMR_MASKBLT = 78
-EMR_PLGBLT = 79
-EMR_SETDIBITSTODEVICE = 80
-EMR_STRETCHDIBITS = 81
-EMR_EXTCREATEFONTINDIRECTW = 82
-EMR_EXTTEXTOUTA = 83
-EMR_EXTTEXTOUTW = 84
-EMR_POLYBEZIER16 = 85
-EMR_POLYGON16 = 86
-EMR_POLYLINE16 = 87
-EMR_POLYBEZIERTO16 = 88
-EMR_POLYLINETO16 = 89
-EMR_POLYPOLYLINE16 = 90
-EMR_POLYPOLYGON16 = 91
-EMR_POLYDRAW16 = 92
-EMR_CREATEMONOBRUSH = 93
-EMR_CREATEDIBPATTERNBRUSHPT = 94
-EMR_EXTCREATEPEN = 95
-EMR_POLYTEXTOUTA = 96
-EMR_POLYTEXTOUTW = 97
-EMR_MIN = 1
-EMR_MAX = 97
-# Generated by h2py from \msvcnt\include\wingdi.h
-# hacked and split manually by mhammond.
-PANOSE_COUNT = 10
-PAN_FAMILYTYPE_INDEX = 0
-PAN_SERIFSTYLE_INDEX = 1
-PAN_WEIGHT_INDEX = 2
-PAN_PROPORTION_INDEX = 3
-PAN_CONTRAST_INDEX = 4
-PAN_STROKEVARIATION_INDEX = 5
-PAN_ARMSTYLE_INDEX = 6
-PAN_LETTERFORM_INDEX = 7
-PAN_MIDLINE_INDEX = 8
-PAN_XHEIGHT_INDEX = 9
-PAN_CULTURE_LATIN = 0
-PAN_ANY = 0
-PAN_NO_FIT = 1
-PAN_FAMILY_TEXT_DISPLAY = 2
-PAN_FAMILY_SCRIPT = 3
-PAN_FAMILY_DECORATIVE = 4
-PAN_FAMILY_PICTORIAL = 5
-PAN_SERIF_COVE = 2
-PAN_SERIF_OBTUSE_COVE = 3
-PAN_SERIF_SQUARE_COVE = 4
-PAN_SERIF_OBTUSE_SQUARE_COVE = 5
-PAN_SERIF_SQUARE = 6
-PAN_SERIF_THIN = 7
-PAN_SERIF_BONE = 8
-PAN_SERIF_EXAGGERATED = 9
-PAN_SERIF_TRIANGLE = 10
-PAN_SERIF_NORMAL_SANS = 11
-PAN_SERIF_OBTUSE_SANS = 12
-PAN_SERIF_PERP_SANS = 13
-PAN_SERIF_FLARED = 14
-PAN_SERIF_ROUNDED = 15
-PAN_WEIGHT_VERY_LIGHT = 2
-PAN_WEIGHT_LIGHT = 3
-PAN_WEIGHT_THIN = 4
-PAN_WEIGHT_BOOK = 5
-PAN_WEIGHT_MEDIUM = 6
-PAN_WEIGHT_DEMI = 7
-PAN_WEIGHT_BOLD = 8
-PAN_WEIGHT_HEAVY = 9
-PAN_WEIGHT_BLACK = 10
-PAN_WEIGHT_NORD = 11
-PAN_PROP_OLD_STYLE = 2
-PAN_PROP_MODERN = 3
-PAN_PROP_EVEN_WIDTH = 4
-PAN_PROP_EXPANDED = 5
-PAN_PROP_CONDENSED = 6
-PAN_PROP_VERY_EXPANDED = 7
-PAN_PROP_VERY_CONDENSED = 8
-PAN_PROP_MONOSPACED = 9
-PAN_CONTRAST_NONE = 2
-PAN_CONTRAST_VERY_LOW = 3
-PAN_CONTRAST_LOW = 4
-PAN_CONTRAST_MEDIUM_LOW = 5
-PAN_CONTRAST_MEDIUM = 6
-PAN_CONTRAST_MEDIUM_HIGH = 7
-PAN_CONTRAST_HIGH = 8
-PAN_CONTRAST_VERY_HIGH = 9
-PAN_STROKE_GRADUAL_DIAG = 2
-PAN_STROKE_GRADUAL_TRAN = 3
-PAN_STROKE_GRADUAL_VERT = 4
-PAN_STROKE_GRADUAL_HORZ = 5
-PAN_STROKE_RAPID_VERT = 6
-PAN_STROKE_RAPID_HORZ = 7
-PAN_STROKE_INSTANT_VERT = 8
-PAN_STRAIGHT_ARMS_HORZ = 2
-PAN_STRAIGHT_ARMS_WEDGE = 3
-PAN_STRAIGHT_ARMS_VERT = 4
-PAN_STRAIGHT_ARMS_SINGLE_SERIF = 5
-PAN_STRAIGHT_ARMS_DOUBLE_SERIF = 6
-PAN_BENT_ARMS_HORZ = 7
-PAN_BENT_ARMS_WEDGE = 8
-PAN_BENT_ARMS_VERT = 9
-PAN_BENT_ARMS_SINGLE_SERIF = 10
-PAN_BENT_ARMS_DOUBLE_SERIF = 11
-PAN_LETT_NORMAL_CONTACT = 2
-PAN_LETT_NORMAL_WEIGHTED = 3
-PAN_LETT_NORMAL_BOXED = 4
-PAN_LETT_NORMAL_FLATTENED = 5
-PAN_LETT_NORMAL_ROUNDED = 6
-PAN_LETT_NORMAL_OFF_CENTER = 7
-PAN_LETT_NORMAL_SQUARE = 8
-PAN_LETT_OBLIQUE_CONTACT = 9
-PAN_LETT_OBLIQUE_WEIGHTED = 10
-PAN_LETT_OBLIQUE_BOXED = 11
-PAN_LETT_OBLIQUE_FLATTENED = 12
-PAN_LETT_OBLIQUE_ROUNDED = 13
-PAN_LETT_OBLIQUE_OFF_CENTER = 14
-PAN_LETT_OBLIQUE_SQUARE = 15
-PAN_MIDLINE_STANDARD_TRIMMED = 2
-PAN_MIDLINE_STANDARD_POINTED = 3
-PAN_MIDLINE_STANDARD_SERIFED = 4
-PAN_MIDLINE_HIGH_TRIMMED = 5
-PAN_MIDLINE_HIGH_POINTED = 6
-PAN_MIDLINE_HIGH_SERIFED = 7
-PAN_MIDLINE_CONSTANT_TRIMMED = 8
-PAN_MIDLINE_CONSTANT_POINTED = 9
-PAN_MIDLINE_CONSTANT_SERIFED = 10
-PAN_MIDLINE_LOW_TRIMMED = 11
-PAN_MIDLINE_LOW_POINTED = 12
-PAN_MIDLINE_LOW_SERIFED = 13
-PAN_XHEIGHT_CONSTANT_SMALL = 2
-PAN_XHEIGHT_CONSTANT_STD = 3
-PAN_XHEIGHT_CONSTANT_LARGE = 4
-PAN_XHEIGHT_DUCKING_SMALL = 5
-PAN_XHEIGHT_DUCKING_STD = 6
-PAN_XHEIGHT_DUCKING_LARGE = 7
-ELF_VENDOR_SIZE = 4
-ELF_VERSION = 0
-ELF_CULTURE_LATIN = 0
-RASTER_FONTTYPE = 1
-DEVICE_FONTTYPE = 2
-TRUETYPE_FONTTYPE = 4
-
-
-def PALETTEINDEX(i):
-    return 16777216 | (i)
-
-
-PC_RESERVED = 1
-PC_EXPLICIT = 2
-PC_NOCOLLAPSE = 4
-
-
-def GetRValue(rgb):
-    return rgb & 0xFF
-
-
-def GetGValue(rgb):
-    return (rgb >> 8) & 0xFF
-
-
-def GetBValue(rgb):
-    return (rgb >> 16) & 0xFF
-
-
-TRANSPARENT = 1
-OPAQUE = 2
-BKMODE_LAST = 2
-GM_COMPATIBLE = 1
-GM_ADVANCED = 2
-GM_LAST = 2
-PT_CLOSEFIGURE = 1
-PT_LINETO = 2
-PT_BEZIERTO = 4
-PT_MOVETO = 6
-MM_TEXT = 1
-MM_LOMETRIC = 2
-MM_HIMETRIC = 3
-MM_LOENGLISH = 4
-MM_HIENGLISH = 5
-MM_TWIPS = 6
-MM_ISOTROPIC = 7
-MM_ANISOTROPIC = 8
-MM_MIN = MM_TEXT
-MM_MAX = MM_ANISOTROPIC
-MM_MAX_FIXEDSCALE = MM_TWIPS
-ABSOLUTE = 1
-RELATIVE = 2
-WHITE_BRUSH = 0
-LTGRAY_BRUSH = 1
-GRAY_BRUSH = 2
-DKGRAY_BRUSH = 3
-BLACK_BRUSH = 4
-NULL_BRUSH = 5
-HOLLOW_BRUSH = NULL_BRUSH
-WHITE_PEN = 6
-BLACK_PEN = 7
-NULL_PEN = 8
-OEM_FIXED_FONT = 10
-ANSI_FIXED_FONT = 11
-ANSI_VAR_FONT = 12
-SYSTEM_FONT = 13
-DEVICE_DEFAULT_FONT = 14
-DEFAULT_PALETTE = 15
-SYSTEM_FIXED_FONT = 16
-STOCK_LAST = 16
-CLR_INVALID = -1
-
-DC_BRUSH = 18
-DC_PEN = 19
-
-# Exception/Status codes from winuser.h and winnt.h
-STATUS_WAIT_0 = 0
-STATUS_ABANDONED_WAIT_0 = 128
-STATUS_USER_APC = 192
-STATUS_TIMEOUT = 258
-STATUS_PENDING = 259
-STATUS_SEGMENT_NOTIFICATION = 1073741829
-STATUS_GUARD_PAGE_VIOLATION = -2147483647
-STATUS_DATATYPE_MISALIGNMENT = -2147483646
-STATUS_BREAKPOINT = -2147483645
-STATUS_SINGLE_STEP = -2147483644
-STATUS_ACCESS_VIOLATION = -1073741819
-STATUS_IN_PAGE_ERROR = -1073741818
-STATUS_INVALID_HANDLE = -1073741816
-STATUS_NO_MEMORY = -1073741801
-STATUS_ILLEGAL_INSTRUCTION = -1073741795
-STATUS_NONCONTINUABLE_EXCEPTION = -1073741787
-STATUS_INVALID_DISPOSITION = -1073741786
-STATUS_ARRAY_BOUNDS_EXCEEDED = -1073741684
-STATUS_FLOAT_DENORMAL_OPERAND = -1073741683
-STATUS_FLOAT_DIVIDE_BY_ZERO = -1073741682
-STATUS_FLOAT_INEXACT_RESULT = -1073741681
-STATUS_FLOAT_INVALID_OPERATION = -1073741680
-STATUS_FLOAT_OVERFLOW = -1073741679
-STATUS_FLOAT_STACK_CHECK = -1073741678
-STATUS_FLOAT_UNDERFLOW = -1073741677
-STATUS_INTEGER_DIVIDE_BY_ZERO = -1073741676
-STATUS_INTEGER_OVERFLOW = -1073741675
-STATUS_PRIVILEGED_INSTRUCTION = -1073741674
-STATUS_STACK_OVERFLOW = -1073741571
-STATUS_CONTROL_C_EXIT = -1073741510
-
-
-WAIT_FAILED = -1
-WAIT_OBJECT_0 = STATUS_WAIT_0 + 0
-
-WAIT_ABANDONED = STATUS_ABANDONED_WAIT_0 + 0
-WAIT_ABANDONED_0 = STATUS_ABANDONED_WAIT_0 + 0
-
-WAIT_TIMEOUT = STATUS_TIMEOUT
-WAIT_IO_COMPLETION = STATUS_USER_APC
-STILL_ACTIVE = STATUS_PENDING
-EXCEPTION_ACCESS_VIOLATION = STATUS_ACCESS_VIOLATION
-EXCEPTION_DATATYPE_MISALIGNMENT = STATUS_DATATYPE_MISALIGNMENT
-EXCEPTION_BREAKPOINT = STATUS_BREAKPOINT
-EXCEPTION_SINGLE_STEP = STATUS_SINGLE_STEP
-EXCEPTION_ARRAY_BOUNDS_EXCEEDED = STATUS_ARRAY_BOUNDS_EXCEEDED
-EXCEPTION_FLT_DENORMAL_OPERAND = STATUS_FLOAT_DENORMAL_OPERAND
-EXCEPTION_FLT_DIVIDE_BY_ZERO = STATUS_FLOAT_DIVIDE_BY_ZERO
-EXCEPTION_FLT_INEXACT_RESULT = STATUS_FLOAT_INEXACT_RESULT
-EXCEPTION_FLT_INVALID_OPERATION = STATUS_FLOAT_INVALID_OPERATION
-EXCEPTION_FLT_OVERFLOW = STATUS_FLOAT_OVERFLOW
-EXCEPTION_FLT_STACK_CHECK = STATUS_FLOAT_STACK_CHECK
-EXCEPTION_FLT_UNDERFLOW = STATUS_FLOAT_UNDERFLOW
-EXCEPTION_INT_DIVIDE_BY_ZERO = STATUS_INTEGER_DIVIDE_BY_ZERO
-EXCEPTION_INT_OVERFLOW = STATUS_INTEGER_OVERFLOW
-EXCEPTION_PRIV_INSTRUCTION = STATUS_PRIVILEGED_INSTRUCTION
-EXCEPTION_IN_PAGE_ERROR = STATUS_IN_PAGE_ERROR
-EXCEPTION_ILLEGAL_INSTRUCTION = STATUS_ILLEGAL_INSTRUCTION
-EXCEPTION_NONCONTINUABLE_EXCEPTION = STATUS_NONCONTINUABLE_EXCEPTION
-EXCEPTION_STACK_OVERFLOW = STATUS_STACK_OVERFLOW
-EXCEPTION_INVALID_DISPOSITION = STATUS_INVALID_DISPOSITION
-EXCEPTION_GUARD_PAGE = STATUS_GUARD_PAGE_VIOLATION
-EXCEPTION_INVALID_HANDLE = STATUS_INVALID_HANDLE
-CONTROL_C_EXIT = STATUS_CONTROL_C_EXIT
-
-# winuser.h line 8594
-# constants used with SystemParametersInfo
-SPI_GETBEEP = 1
-SPI_SETBEEP = 2
-SPI_GETMOUSE = 3
-SPI_SETMOUSE = 4
-SPI_GETBORDER = 5
-SPI_SETBORDER = 6
-SPI_GETKEYBOARDSPEED = 10
-SPI_SETKEYBOARDSPEED = 11
-SPI_LANGDRIVER = 12
-SPI_ICONHORIZONTALSPACING = 13
-SPI_GETSCREENSAVETIMEOUT = 14
-SPI_SETSCREENSAVETIMEOUT = 15
-SPI_GETSCREENSAVEACTIVE = 16
-SPI_SETSCREENSAVEACTIVE = 17
-SPI_GETGRIDGRANULARITY = 18
-SPI_SETGRIDGRANULARITY = 19
-SPI_SETDESKWALLPAPER = 20
-SPI_SETDESKPATTERN = 21
-SPI_GETKEYBOARDDELAY = 22
-SPI_SETKEYBOARDDELAY = 23
-SPI_ICONVERTICALSPACING = 24
-SPI_GETICONTITLEWRAP = 25
-SPI_SETICONTITLEWRAP = 26
-SPI_GETMENUDROPALIGNMENT = 27
-SPI_SETMENUDROPALIGNMENT = 28
-SPI_SETDOUBLECLKWIDTH = 29
-SPI_SETDOUBLECLKHEIGHT = 30
-SPI_GETICONTITLELOGFONT = 31
-SPI_SETDOUBLECLICKTIME = 32
-SPI_SETMOUSEBUTTONSWAP = 33
-SPI_SETICONTITLELOGFONT = 34
-SPI_GETFASTTASKSWITCH = 35
-SPI_SETFASTTASKSWITCH = 36
-SPI_SETDRAGFULLWINDOWS = 37
-SPI_GETDRAGFULLWINDOWS = 38
-SPI_GETNONCLIENTMETRICS = 41
-SPI_SETNONCLIENTMETRICS = 42
-SPI_GETMINIMIZEDMETRICS = 43
-SPI_SETMINIMIZEDMETRICS = 44
-SPI_GETICONMETRICS = 45
-SPI_SETICONMETRICS = 46
-SPI_SETWORKAREA = 47
-SPI_GETWORKAREA = 48
-SPI_SETPENWINDOWS = 49
-SPI_GETFILTERKEYS = 50
-SPI_SETFILTERKEYS = 51
-SPI_GETTOGGLEKEYS = 52
-SPI_SETTOGGLEKEYS = 53
-SPI_GETMOUSEKEYS = 54
-SPI_SETMOUSEKEYS = 55
-SPI_GETSHOWSOUNDS = 56
-SPI_SETSHOWSOUNDS = 57
-SPI_GETSTICKYKEYS = 58
-SPI_SETSTICKYKEYS = 59
-SPI_GETACCESSTIMEOUT = 60
-SPI_SETACCESSTIMEOUT = 61
-SPI_GETSERIALKEYS = 62
-SPI_SETSERIALKEYS = 63
-SPI_GETSOUNDSENTRY = 64
-SPI_SETSOUNDSENTRY = 65
-SPI_GETHIGHCONTRAST = 66
-SPI_SETHIGHCONTRAST = 67
-SPI_GETKEYBOARDPREF = 68
-SPI_SETKEYBOARDPREF = 69
-SPI_GETSCREENREADER = 70
-SPI_SETSCREENREADER = 71
-SPI_GETANIMATION = 72
-SPI_SETANIMATION = 73
-SPI_GETFONTSMOOTHING = 74
-SPI_SETFONTSMOOTHING = 75
-SPI_SETDRAGWIDTH = 76
-SPI_SETDRAGHEIGHT = 77
-SPI_SETHANDHELD = 78
-SPI_GETLOWPOWERTIMEOUT = 79
-SPI_GETPOWEROFFTIMEOUT = 80
-SPI_SETLOWPOWERTIMEOUT = 81
-SPI_SETPOWEROFFTIMEOUT = 82
-SPI_GETLOWPOWERACTIVE = 83
-SPI_GETPOWEROFFACTIVE = 84
-SPI_SETLOWPOWERACTIVE = 85
-SPI_SETPOWEROFFACTIVE = 86
-SPI_SETCURSORS = 87
-SPI_SETICONS = 88
-SPI_GETDEFAULTINPUTLANG = 89
-SPI_SETDEFAULTINPUTLANG = 90
-SPI_SETLANGTOGGLE = 91
-SPI_GETWINDOWSEXTENSION = 92
-SPI_SETMOUSETRAILS = 93
-SPI_GETMOUSETRAILS = 94
-SPI_GETSNAPTODEFBUTTON = 95
-SPI_SETSNAPTODEFBUTTON = 96
-SPI_SETSCREENSAVERRUNNING = 97
-SPI_SCREENSAVERRUNNING = SPI_SETSCREENSAVERRUNNING
-SPI_GETMOUSEHOVERWIDTH = 98
-SPI_SETMOUSEHOVERWIDTH = 99
-SPI_GETMOUSEHOVERHEIGHT = 100
-SPI_SETMOUSEHOVERHEIGHT = 101
-SPI_GETMOUSEHOVERTIME = 102
-SPI_SETMOUSEHOVERTIME = 103
-SPI_GETWHEELSCROLLLINES = 104
-SPI_SETWHEELSCROLLLINES = 105
-SPI_GETMENUSHOWDELAY = 106
-SPI_SETMENUSHOWDELAY = 107
-
-SPI_GETSHOWIMEUI = 110
-SPI_SETSHOWIMEUI = 111
-SPI_GETMOUSESPEED = 112
-SPI_SETMOUSESPEED = 113
-SPI_GETSCREENSAVERRUNNING = 114
-SPI_GETDESKWALLPAPER = 115
-
-SPI_GETACTIVEWINDOWTRACKING = 4096
-SPI_SETACTIVEWINDOWTRACKING = 4097
-SPI_GETMENUANIMATION = 4098
-SPI_SETMENUANIMATION = 4099
-SPI_GETCOMBOBOXANIMATION = 4100
-SPI_SETCOMBOBOXANIMATION = 4101
-SPI_GETLISTBOXSMOOTHSCROLLING = 4102
-SPI_SETLISTBOXSMOOTHSCROLLING = 4103
-SPI_GETGRADIENTCAPTIONS = 4104
-SPI_SETGRADIENTCAPTIONS = 4105
-SPI_GETKEYBOARDCUES = 4106
-SPI_SETKEYBOARDCUES = 4107
-SPI_GETMENUUNDERLINES = 4106
-SPI_SETMENUUNDERLINES = 4107
-SPI_GETACTIVEWNDTRKZORDER = 4108
-SPI_SETACTIVEWNDTRKZORDER = 4109
-SPI_GETHOTTRACKING = 4110
-SPI_SETHOTTRACKING = 4111
-
-SPI_GETMENUFADE = 4114
-SPI_SETMENUFADE = 4115
-SPI_GETSELECTIONFADE = 4116
-SPI_SETSELECTIONFADE = 4117
-SPI_GETTOOLTIPANIMATION = 4118
-SPI_SETTOOLTIPANIMATION = 4119
-SPI_GETTOOLTIPFADE = 4120
-SPI_SETTOOLTIPFADE = 4121
-SPI_GETCURSORSHADOW = 4122
-SPI_SETCURSORSHADOW = 4123
-SPI_GETMOUSESONAR = 4124
-SPI_SETMOUSESONAR = 4125
-SPI_GETMOUSECLICKLOCK = 4126
-SPI_SETMOUSECLICKLOCK = 4127
-SPI_GETMOUSEVANISH = 4128
-SPI_SETMOUSEVANISH = 4129
-SPI_GETFLATMENU = 4130
-SPI_SETFLATMENU = 4131
-SPI_GETDROPSHADOW = 4132
-SPI_SETDROPSHADOW = 4133
-SPI_GETBLOCKSENDINPUTRESETS = 4134
-SPI_SETBLOCKSENDINPUTRESETS = 4135
-SPI_GETUIEFFECTS = 4158
-SPI_SETUIEFFECTS = 4159
-
-SPI_GETFOREGROUNDLOCKTIMEOUT = 8192
-SPI_SETFOREGROUNDLOCKTIMEOUT = 8193
-SPI_GETACTIVEWNDTRKTIMEOUT = 8194
-SPI_SETACTIVEWNDTRKTIMEOUT = 8195
-SPI_GETFOREGROUNDFLASHCOUNT = 8196
-SPI_SETFOREGROUNDFLASHCOUNT = 8197
-SPI_GETCARETWIDTH = 8198
-SPI_SETCARETWIDTH = 8199
-SPI_GETMOUSECLICKLOCKTIME = 8200
-SPI_SETMOUSECLICKLOCKTIME = 8201
-SPI_GETFONTSMOOTHINGTYPE = 8202
-SPI_SETFONTSMOOTHINGTYPE = 8203
-SPI_GETFONTSMOOTHINGCONTRAST = 8204
-SPI_SETFONTSMOOTHINGCONTRAST = 8205
-SPI_GETFOCUSBORDERWIDTH = 8206
-SPI_SETFOCUSBORDERWIDTH = 8207
-SPI_GETFOCUSBORDERHEIGHT = 8208
-SPI_SETFOCUSBORDERHEIGHT = 8209
-SPI_GETFONTSMOOTHINGORIENTATION = 8210
-SPI_SETFONTSMOOTHINGORIENTATION = 8211
-
-# fWinIni flags for SystemParametersInfo
-SPIF_UPDATEINIFILE = 1
-SPIF_SENDWININICHANGE = 2
-SPIF_SENDCHANGE = SPIF_SENDWININICHANGE
-
-# used with SystemParametersInfo and SPI_GETFONTSMOOTHINGTYPE/SPI_SETFONTSMOOTHINGTYPE
-FE_FONTSMOOTHINGSTANDARD = 1
-FE_FONTSMOOTHINGCLEARTYPE = 2
-FE_FONTSMOOTHINGDOCKING = 32768
-
-METRICS_USEDEFAULT = -1
-ARW_BOTTOMLEFT = 0
-ARW_BOTTOMRIGHT = 1
-ARW_TOPLEFT = 2
-ARW_TOPRIGHT = 3
-ARW_STARTMASK = 3
-ARW_STARTRIGHT = 1
-ARW_STARTTOP = 2
-ARW_LEFT = 0
-ARW_RIGHT = 0
-ARW_UP = 4
-ARW_DOWN = 4
-ARW_HIDE = 8
-# ARW_VALID = 0x000F
-SERKF_SERIALKEYSON = 1
-SERKF_AVAILABLE = 2
-SERKF_INDICATOR = 4
-HCF_HIGHCONTRASTON = 1
-HCF_AVAILABLE = 2
-HCF_HOTKEYACTIVE = 4
-HCF_CONFIRMHOTKEY = 8
-HCF_HOTKEYSOUND = 16
-HCF_INDICATOR = 32
-HCF_HOTKEYAVAILABLE = 64
-CDS_UPDATEREGISTRY = 1
-CDS_TEST = 2
-CDS_FULLSCREEN = 4
-CDS_GLOBAL = 8
-CDS_SET_PRIMARY = 16
-CDS_RESET = 1073741824
-CDS_SETRECT = 536870912
-CDS_NORESET = 268435456
-
-# return values from ChangeDisplaySettings and ChangeDisplaySettingsEx
-DISP_CHANGE_SUCCESSFUL = 0
-DISP_CHANGE_RESTART = 1
-DISP_CHANGE_FAILED = -1
-DISP_CHANGE_BADMODE = -2
-DISP_CHANGE_NOTUPDATED = -3
-DISP_CHANGE_BADFLAGS = -4
-DISP_CHANGE_BADPARAM = -5
-DISP_CHANGE_BADDUALVIEW = -6
-
-ENUM_CURRENT_SETTINGS = -1
-ENUM_REGISTRY_SETTINGS = -2
-FKF_FILTERKEYSON = 1
-FKF_AVAILABLE = 2
-FKF_HOTKEYACTIVE = 4
-FKF_CONFIRMHOTKEY = 8
-FKF_HOTKEYSOUND = 16
-FKF_INDICATOR = 32
-FKF_CLICKON = 64
-SKF_STICKYKEYSON = 1
-SKF_AVAILABLE = 2
-SKF_HOTKEYACTIVE = 4
-SKF_CONFIRMHOTKEY = 8
-SKF_HOTKEYSOUND = 16
-SKF_INDICATOR = 32
-SKF_AUDIBLEFEEDBACK = 64
-SKF_TRISTATE = 128
-SKF_TWOKEYSOFF = 256
-SKF_LALTLATCHED = 268435456
-SKF_LCTLLATCHED = 67108864
-SKF_LSHIFTLATCHED = 16777216
-SKF_RALTLATCHED = 536870912
-SKF_RCTLLATCHED = 134217728
-SKF_RSHIFTLATCHED = 33554432
-SKF_LWINLATCHED = 1073741824
-SKF_RWINLATCHED = -2147483648
-SKF_LALTLOCKED = 1048576
-SKF_LCTLLOCKED = 262144
-SKF_LSHIFTLOCKED = 65536
-SKF_RALTLOCKED = 2097152
-SKF_RCTLLOCKED = 524288
-SKF_RSHIFTLOCKED = 131072
-SKF_LWINLOCKED = 4194304
-SKF_RWINLOCKED = 8388608
-MKF_MOUSEKEYSON = 1
-MKF_AVAILABLE = 2
-MKF_HOTKEYACTIVE = 4
-MKF_CONFIRMHOTKEY = 8
-MKF_HOTKEYSOUND = 16
-MKF_INDICATOR = 32
-MKF_MODIFIERS = 64
-MKF_REPLACENUMBERS = 128
-MKF_LEFTBUTTONSEL = 268435456
-MKF_RIGHTBUTTONSEL = 536870912
-MKF_LEFTBUTTONDOWN = 16777216
-MKF_RIGHTBUTTONDOWN = 33554432
-MKF_MOUSEMODE = -2147483648
-ATF_TIMEOUTON = 1
-ATF_ONOFFFEEDBACK = 2
-SSGF_NONE = 0
-SSGF_DISPLAY = 3
-SSTF_NONE = 0
-SSTF_CHARS = 1
-SSTF_BORDER = 2
-SSTF_DISPLAY = 3
-SSWF_NONE = 0
-SSWF_TITLE = 1
-SSWF_WINDOW = 2
-SSWF_DISPLAY = 3
-SSWF_CUSTOM = 4
-SSF_SOUNDSENTRYON = 1
-SSF_AVAILABLE = 2
-SSF_INDICATOR = 4
-TKF_TOGGLEKEYSON = 1
-TKF_AVAILABLE = 2
-TKF_HOTKEYACTIVE = 4
-TKF_CONFIRMHOTKEY = 8
-TKF_HOTKEYSOUND = 16
-TKF_INDICATOR = 32
-SLE_ERROR = 1
-SLE_MINORERROR = 2
-SLE_WARNING = 3
-MONITOR_DEFAULTTONULL = 0
-MONITOR_DEFAULTTOPRIMARY = 1
-MONITOR_DEFAULTTONEAREST = 2
-MONITORINFOF_PRIMARY = 1
-CCHDEVICENAME = 32
-CHILDID_SELF = 0
-INDEXID_OBJECT = 0
-INDEXID_CONTAINER = 0
-OBJID_WINDOW = 0
-OBJID_SYSMENU = -1
-OBJID_TITLEBAR = -2
-OBJID_MENU = -3
-OBJID_CLIENT = -4
-OBJID_VSCROLL = -5
-OBJID_HSCROLL = -6
-OBJID_SIZEGRIP = -7
-OBJID_CARET = -8
-OBJID_CURSOR = -9
-OBJID_ALERT = -10
-OBJID_SOUND = -11
-EVENT_MIN = 1
-EVENT_MAX = 2147483647
-EVENT_SYSTEM_SOUND = 1
-EVENT_SYSTEM_ALERT = 2
-EVENT_SYSTEM_FOREGROUND = 3
-EVENT_SYSTEM_MENUSTART = 4
-EVENT_SYSTEM_MENUEND = 5
-EVENT_SYSTEM_MENUPOPUPSTART = 6
-EVENT_SYSTEM_MENUPOPUPEND = 7
-EVENT_SYSTEM_CAPTURESTART = 8
-EVENT_SYSTEM_CAPTUREEND = 9
-EVENT_SYSTEM_MOVESIZESTART = 10
-EVENT_SYSTEM_MOVESIZEEND = 11
-EVENT_SYSTEM_CONTEXTHELPSTART = 12
-EVENT_SYSTEM_CONTEXTHELPEND = 13
-EVENT_SYSTEM_DRAGDROPSTART = 14
-EVENT_SYSTEM_DRAGDROPEND = 15
-EVENT_SYSTEM_DIALOGSTART = 16
-EVENT_SYSTEM_DIALOGEND = 17
-EVENT_SYSTEM_SCROLLINGSTART = 18
-EVENT_SYSTEM_SCROLLINGEND = 19
-EVENT_SYSTEM_SWITCHSTART = 20
-EVENT_SYSTEM_SWITCHEND = 21
-EVENT_SYSTEM_MINIMIZESTART = 22
-EVENT_SYSTEM_MINIMIZEEND = 23
-EVENT_OBJECT_CREATE = 32768
-EVENT_OBJECT_DESTROY = 32769
-EVENT_OBJECT_SHOW = 32770
-EVENT_OBJECT_HIDE = 32771
-EVENT_OBJECT_REORDER = 32772
-EVENT_OBJECT_FOCUS = 32773
-EVENT_OBJECT_SELECTION = 32774
-EVENT_OBJECT_SELECTIONADD = 32775
-EVENT_OBJECT_SELECTIONREMOVE = 32776
-EVENT_OBJECT_SELECTIONWITHIN = 32777
-EVENT_OBJECT_STATECHANGE = 32778
-EVENT_OBJECT_LOCATIONCHANGE = 32779
-EVENT_OBJECT_NAMECHANGE = 32780
-EVENT_OBJECT_DESCRIPTIONCHANGE = 32781
-EVENT_OBJECT_VALUECHANGE = 32782
-EVENT_OBJECT_PARENTCHANGE = 32783
-EVENT_OBJECT_HELPCHANGE = 32784
-EVENT_OBJECT_DEFACTIONCHANGE = 32785
-EVENT_OBJECT_ACCELERATORCHANGE = 32786
-SOUND_SYSTEM_STARTUP = 1
-SOUND_SYSTEM_SHUTDOWN = 2
-SOUND_SYSTEM_BEEP = 3
-SOUND_SYSTEM_ERROR = 4
-SOUND_SYSTEM_QUESTION = 5
-SOUND_SYSTEM_WARNING = 6
-SOUND_SYSTEM_INFORMATION = 7
-SOUND_SYSTEM_MAXIMIZE = 8
-SOUND_SYSTEM_MINIMIZE = 9
-SOUND_SYSTEM_RESTOREUP = 10
-SOUND_SYSTEM_RESTOREDOWN = 11
-SOUND_SYSTEM_APPSTART = 12
-SOUND_SYSTEM_FAULT = 13
-SOUND_SYSTEM_APPEND = 14
-SOUND_SYSTEM_MENUCOMMAND = 15
-SOUND_SYSTEM_MENUPOPUP = 16
-CSOUND_SYSTEM = 16
-ALERT_SYSTEM_INFORMATIONAL = 1
-ALERT_SYSTEM_WARNING = 2
-ALERT_SYSTEM_ERROR = 3
-ALERT_SYSTEM_QUERY = 4
-ALERT_SYSTEM_CRITICAL = 5
-CALERT_SYSTEM = 6
-WINEVENT_OUTOFCONTEXT = 0
-WINEVENT_SKIPOWNTHREAD = 1
-WINEVENT_SKIPOWNPROCESS = 2
-WINEVENT_INCONTEXT = 4
-GUI_CARETBLINKING = 1
-GUI_INMOVESIZE = 2
-GUI_INMENUMODE = 4
-GUI_SYSTEMMENUMODE = 8
-GUI_POPUPMENUMODE = 16
-STATE_SYSTEM_UNAVAILABLE = 1
-STATE_SYSTEM_SELECTED = 2
-STATE_SYSTEM_FOCUSED = 4
-STATE_SYSTEM_PRESSED = 8
-STATE_SYSTEM_CHECKED = 16
-STATE_SYSTEM_MIXED = 32
-STATE_SYSTEM_READONLY = 64
-STATE_SYSTEM_HOTTRACKED = 128
-STATE_SYSTEM_DEFAULT = 256
-STATE_SYSTEM_EXPANDED = 512
-STATE_SYSTEM_COLLAPSED = 1024
-STATE_SYSTEM_BUSY = 2048
-STATE_SYSTEM_FLOATING = 4096
-STATE_SYSTEM_MARQUEED = 8192
-STATE_SYSTEM_ANIMATED = 16384
-STATE_SYSTEM_INVISIBLE = 32768
-STATE_SYSTEM_OFFSCREEN = 65536
-STATE_SYSTEM_SIZEABLE = 131072
-STATE_SYSTEM_MOVEABLE = 262144
-STATE_SYSTEM_SELFVOICING = 524288
-STATE_SYSTEM_FOCUSABLE = 1048576
-STATE_SYSTEM_SELECTABLE = 2097152
-STATE_SYSTEM_LINKED = 4194304
-STATE_SYSTEM_TRAVERSED = 8388608
-STATE_SYSTEM_MULTISELECTABLE = 16777216
-STATE_SYSTEM_EXTSELECTABLE = 33554432
-STATE_SYSTEM_ALERT_LOW = 67108864
-STATE_SYSTEM_ALERT_MEDIUM = 134217728
-STATE_SYSTEM_ALERT_HIGH = 268435456
-STATE_SYSTEM_VALID = 536870911
-CCHILDREN_TITLEBAR = 5
-CCHILDREN_SCROLLBAR = 5
-CURSOR_SHOWING = 1
-WS_ACTIVECAPTION = 1
-GA_MIC = 1
-GA_PARENT = 1
-GA_ROOT = 2
-GA_ROOTOWNER = 3
-GA_MAC = 4
-
-# winuser.h line 1979
-BF_LEFT = 1
-BF_TOP = 2
-BF_RIGHT = 4
-BF_BOTTOM = 8
-BF_TOPLEFT = BF_TOP | BF_LEFT
-BF_TOPRIGHT = BF_TOP | BF_RIGHT
-BF_BOTTOMLEFT = BF_BOTTOM | BF_LEFT
-BF_BOTTOMRIGHT = BF_BOTTOM | BF_RIGHT
-BF_RECT = BF_LEFT | BF_TOP | BF_RIGHT | BF_BOTTOM
-BF_DIAGONAL = 16
-BF_DIAGONAL_ENDTOPRIGHT = BF_DIAGONAL | BF_TOP | BF_RIGHT
-BF_DIAGONAL_ENDTOPLEFT = BF_DIAGONAL | BF_TOP | BF_LEFT
-BF_DIAGONAL_ENDBOTTOMLEFT = BF_DIAGONAL | BF_BOTTOM | BF_LEFT
-BF_DIAGONAL_ENDBOTTOMRIGHT = BF_DIAGONAL | BF_BOTTOM | BF_RIGHT
-BF_MIDDLE = 2048
-BF_SOFT = 4096
-BF_ADJUST = 8192
-BF_FLAT = 16384
-BF_MONO = 32768
-DFC_CAPTION = 1
-DFC_MENU = 2
-DFC_SCROLL = 3
-DFC_BUTTON = 4
-DFC_POPUPMENU = 5
-DFCS_CAPTIONCLOSE = 0
-DFCS_CAPTIONMIN = 1
-DFCS_CAPTIONMAX = 2
-DFCS_CAPTIONRESTORE = 3
-DFCS_CAPTIONHELP = 4
-DFCS_MENUARROW = 0
-DFCS_MENUCHECK = 1
-DFCS_MENUBULLET = 2
-DFCS_MENUARROWRIGHT = 4
-DFCS_SCROLLUP = 0
-DFCS_SCROLLDOWN = 1
-DFCS_SCROLLLEFT = 2
-DFCS_SCROLLRIGHT = 3
-DFCS_SCROLLCOMBOBOX = 5
-DFCS_SCROLLSIZEGRIP = 8
-DFCS_SCROLLSIZEGRIPRIGHT = 16
-DFCS_BUTTONCHECK = 0
-DFCS_BUTTONRADIOIMAGE = 1
-DFCS_BUTTONRADIOMASK = 2
-DFCS_BUTTONRADIO = 4
-DFCS_BUTTON3STATE = 8
-DFCS_BUTTONPUSH = 16
-DFCS_INACTIVE = 256
-DFCS_PUSHED = 512
-DFCS_CHECKED = 1024
-DFCS_TRANSPARENT = 2048
-DFCS_HOT = 4096
-DFCS_ADJUSTRECT = 8192
-DFCS_FLAT = 16384
-DFCS_MONO = 32768
-DC_ACTIVE = 1
-DC_SMALLCAP = 2
-DC_ICON = 4
-DC_TEXT = 8
-DC_INBUTTON = 16
-DC_GRADIENT = 32
-IDANI_OPEN = 1
-IDANI_CLOSE = 2
-IDANI_CAPTION = 3
-CF_TEXT = 1
-CF_BITMAP = 2
-CF_METAFILEPICT = 3
-CF_SYLK = 4
-CF_DIF = 5
-CF_TIFF = 6
-CF_OEMTEXT = 7
-CF_DIB = 8
-CF_PALETTE = 9
-CF_PENDATA = 10
-CF_RIFF = 11
-CF_WAVE = 12
-CF_UNICODETEXT = 13
-CF_ENHMETAFILE = 14
-CF_HDROP = 15
-CF_LOCALE = 16
-CF_DIBV5 = 17
-CF_MAX = 18
-CF_OWNERDISPLAY = 128
-CF_DSPTEXT = 129
-CF_DSPBITMAP = 130
-CF_DSPMETAFILEPICT = 131
-CF_DSPENHMETAFILE = 142
-CF_PRIVATEFIRST = 512
-CF_PRIVATELAST = 767
-CF_GDIOBJFIRST = 768
-CF_GDIOBJLAST = 1023
-FVIRTKEY = 1
-FNOINVERT = 2
-FSHIFT = 4
-FCONTROL = 8
-FALT = 16
-WPF_SETMINPOSITION = 1
-WPF_RESTORETOMAXIMIZED = 2
-ODT_MENU = 1
-ODT_LISTBOX = 2
-ODT_COMBOBOX = 3
-ODT_BUTTON = 4
-ODT_STATIC = 5
-ODA_DRAWENTIRE = 1
-ODA_SELECT = 2
-ODA_FOCUS = 4
-ODS_SELECTED = 1
-ODS_GRAYED = 2
-ODS_DISABLED = 4
-ODS_CHECKED = 8
-ODS_FOCUS = 16
-ODS_DEFAULT = 32
-ODS_COMBOBOXEDIT = 4096
-ODS_HOTLIGHT = 64
-ODS_INACTIVE = 128
-PM_NOREMOVE = 0
-PM_REMOVE = 1
-PM_NOYIELD = 2
-MOD_ALT = 1
-MOD_CONTROL = 2
-MOD_SHIFT = 4
-MOD_WIN = 8
-IDHOT_SNAPWINDOW = -1
-IDHOT_SNAPDESKTOP = -2
-# EW_RESTARTWINDOWS = 0x0042
-# EW_REBOOTSYSTEM = 0x0043
-# EW_EXITANDEXECAPP = 0x0044
-ENDSESSION_LOGOFF = -2147483648
-EWX_LOGOFF = 0
-EWX_SHUTDOWN = 1
-EWX_REBOOT = 2
-EWX_FORCE = 4
-EWX_POWEROFF = 8
-EWX_FORCEIFHUNG = 16
-BSM_ALLCOMPONENTS = 0
-BSM_VXDS = 1
-BSM_NETDRIVER = 2
-BSM_INSTALLABLEDRIVERS = 4
-BSM_APPLICATIONS = 8
-BSM_ALLDESKTOPS = 16
-BSF_QUERY = 1
-BSF_IGNORECURRENTTASK = 2
-BSF_FLUSHDISK = 4
-BSF_NOHANG = 8
-BSF_POSTMESSAGE = 16
-BSF_FORCEIFHUNG = 32
-BSF_NOTIMEOUTIFNOTHUNG = 64
-BROADCAST_QUERY_DENY = 1112363332  # Return this value to deny a query.
-
-DBWF_LPARAMPOINTER = 32768
-
-# winuser.h line 3232
-SWP_NOSIZE = 1
-SWP_NOMOVE = 2
-SWP_NOZORDER = 4
-SWP_NOREDRAW = 8
-SWP_NOACTIVATE = 16
-SWP_FRAMECHANGED = 32
-SWP_SHOWWINDOW = 64
-SWP_HIDEWINDOW = 128
-SWP_NOCOPYBITS = 256
-SWP_NOOWNERZORDER = 512
-SWP_NOSENDCHANGING = 1024
-SWP_DRAWFRAME = SWP_FRAMECHANGED
-SWP_NOREPOSITION = SWP_NOOWNERZORDER
-SWP_DEFERERASE = 8192
-SWP_ASYNCWINDOWPOS = 16384
-
-DLGWINDOWEXTRA = 30
-# winuser.h line 4249
-KEYEVENTF_EXTENDEDKEY = 1
-KEYEVENTF_KEYUP = 2
-# if(_WIN32_WINNT >= 0x0500)
-KEYEVENTF_UNICODE = 4
-KEYEVENTF_SCANCODE = 8
-# endif /* _WIN32_WINNT >= 0x0500 */
-MOUSEEVENTF_MOVE = 1
-MOUSEEVENTF_LEFTDOWN = 2
-MOUSEEVENTF_LEFTUP = 4
-MOUSEEVENTF_RIGHTDOWN = 8
-MOUSEEVENTF_RIGHTUP = 16
-MOUSEEVENTF_MIDDLEDOWN = 32
-MOUSEEVENTF_MIDDLEUP = 64
-MOUSEEVENTF_XDOWN = 128
-MOUSEEVENTF_XUP = 256
-MOUSEEVENTF_WHEEL = 2048
-# if (_WIN32_WINNT >= 0x0600)
-MOUSEEVENTF_HWHEEL = 4096
-# endif
-# if(WINVER >= 0x0600)
-MOUSEEVENTF_MOVE_NOCOALESCE = 8192
-# endif /* WINVER >= 0x0600 */
-MOUSEEVENTF_VIRTUALDESK = 16384
-MOUSEEVENTF_ABSOLUTE = 32768
-INPUT_MOUSE = 0
-INPUT_KEYBOARD = 1
-INPUT_HARDWARE = 2
-MWMO_WAITALL = 1
-MWMO_ALERTABLE = 2
-MWMO_INPUTAVAILABLE = 4
-QS_KEY = 1
-QS_MOUSEMOVE = 2
-QS_MOUSEBUTTON = 4
-QS_POSTMESSAGE = 8
-QS_TIMER = 16
-QS_PAINT = 32
-QS_SENDMESSAGE = 64
-QS_HOTKEY = 128
-QS_MOUSE = QS_MOUSEMOVE | QS_MOUSEBUTTON
-QS_INPUT = QS_MOUSE | QS_KEY
-QS_ALLEVENTS = QS_INPUT | QS_POSTMESSAGE | QS_TIMER | QS_PAINT | QS_HOTKEY
-QS_ALLINPUT = (
-    QS_INPUT | QS_POSTMESSAGE | QS_TIMER | QS_PAINT | QS_HOTKEY | QS_SENDMESSAGE
-)
-
-
-IMN_CLOSESTATUSWINDOW = 1
-IMN_OPENSTATUSWINDOW = 2
-IMN_CHANGECANDIDATE = 3
-IMN_CLOSECANDIDATE = 4
-IMN_OPENCANDIDATE = 5
-IMN_SETCONVERSIONMODE = 6
-IMN_SETSENTENCEMODE = 7
-IMN_SETOPENSTATUS = 8
-IMN_SETCANDIDATEPOS = 9
-IMN_SETCOMPOSITIONFONT = 10
-IMN_SETCOMPOSITIONWINDOW = 11
-IMN_SETSTATUSWINDOWPOS = 12
-IMN_GUIDELINE = 13
-IMN_PRIVATE = 14
-
-# winuser.h line 8518
-HELP_CONTEXT = 1
-HELP_QUIT = 2
-HELP_INDEX = 3
-HELP_CONTENTS = 3
-HELP_HELPONHELP = 4
-HELP_SETINDEX = 5
-HELP_SETCONTENTS = 5
-HELP_CONTEXTPOPUP = 8
-HELP_FORCEFILE = 9
-HELP_KEY = 257
-HELP_COMMAND = 258
-HELP_PARTIALKEY = 261
-HELP_MULTIKEY = 513
-HELP_SETWINPOS = 515
-HELP_CONTEXTMENU = 10
-HELP_FINDER = 11
-HELP_WM_HELP = 12
-HELP_SETPOPUP_POS = 13
-HELP_TCARD = 32768
-HELP_TCARD_DATA = 16
-HELP_TCARD_OTHER_CALLER = 17
-IDH_NO_HELP = 28440
-IDH_MISSING_CONTEXT = 28441  # Control doesn't have matching help context
-IDH_GENERIC_HELP_BUTTON = 28442  # Property sheet help button
-IDH_OK = 28443
-IDH_CANCEL = 28444
-IDH_HELP = 28445
-GR_GDIOBJECTS = 0  # Count of GDI objects
-GR_USEROBJECTS = 1  # Count of USER objects
-# Generated by h2py from \msvcnt\include\wingdi.h
-# manually added (missed by generation some how!
-SRCCOPY = 13369376  # dest = source
-SRCPAINT = 15597702  # dest = source OR dest
-SRCAND = 8913094  # dest = source AND dest
-SRCINVERT = 6684742  # dest = source XOR dest
-SRCERASE = 4457256  # dest = source AND (NOT dest )
-NOTSRCCOPY = 3342344  # dest = (NOT source)
-NOTSRCERASE = 1114278  # dest = (NOT src) AND (NOT dest)
-MERGECOPY = 12583114  # dest = (source AND pattern)
-MERGEPAINT = 12255782  # dest = (NOT source) OR dest
-PATCOPY = 15728673  # dest = pattern
-PATPAINT = 16452105  # dest = DPSnoo
-PATINVERT = 5898313  # dest = pattern XOR dest
-DSTINVERT = 5570569  # dest = (NOT dest)
-BLACKNESS = 66  # dest = BLACK
-WHITENESS = 16711778  # dest = WHITE
-
-# hacked and split manually by mhammond.
-R2_BLACK = 1
-R2_NOTMERGEPEN = 2
-R2_MASKNOTPEN = 3
-R2_NOTCOPYPEN = 4
-R2_MASKPENNOT = 5
-R2_NOT = 6
-R2_XORPEN = 7
-R2_NOTMASKPEN = 8
-R2_MASKPEN = 9
-R2_NOTXORPEN = 10
-R2_NOP = 11
-R2_MERGENOTPEN = 12
-R2_COPYPEN = 13
-R2_MERGEPENNOT = 14
-R2_MERGEPEN = 15
-R2_WHITE = 16
-R2_LAST = 16
-GDI_ERROR = -1
-ERROR = 0
-NULLREGION = 1
-SIMPLEREGION = 2
-COMPLEXREGION = 3
-RGN_ERROR = ERROR
-RGN_AND = 1
-RGN_OR = 2
-RGN_XOR = 3
-RGN_DIFF = 4
-RGN_COPY = 5
-RGN_MIN = RGN_AND
-RGN_MAX = RGN_COPY
-
-## Stretching modes used with Get/SetStretchBltMode
-BLACKONWHITE = 1
-WHITEONBLACK = 2
-COLORONCOLOR = 3
-HALFTONE = 4
-MAXSTRETCHBLTMODE = 4
-STRETCH_ANDSCANS = BLACKONWHITE
-STRETCH_ORSCANS = WHITEONBLACK
-STRETCH_DELETESCANS = COLORONCOLOR
-STRETCH_HALFTONE = HALFTONE
-
-ALTERNATE = 1
-WINDING = 2
-POLYFILL_LAST = 2
-
-## flags used with SetLayout
-LAYOUT_RTL = 1
-LAYOUT_BTT = 2
-LAYOUT_VBH = 4
-LAYOUT_ORIENTATIONMASK = LAYOUT_RTL | LAYOUT_BTT | LAYOUT_VBH
-LAYOUT_BITMAPORIENTATIONPRESERVED = 8
-
-TA_NOUPDATECP = 0
-TA_UPDATECP = 1
-TA_LEFT = 0
-TA_RIGHT = 2
-TA_CENTER = 6
-TA_TOP = 0
-TA_BOTTOM = 8
-TA_BASELINE = 24
-TA_MASK = TA_BASELINE + TA_CENTER + TA_UPDATECP
-VTA_BASELINE = TA_BASELINE
-VTA_LEFT = TA_BOTTOM
-VTA_RIGHT = TA_TOP
-VTA_CENTER = TA_CENTER
-VTA_BOTTOM = TA_RIGHT
-VTA_TOP = TA_LEFT
-ETO_GRAYED = 1
-ETO_OPAQUE = 2
-ETO_CLIPPED = 4
-ASPECT_FILTERING = 1
-DCB_RESET = 1
-DCB_ACCUMULATE = 2
-DCB_DIRTY = DCB_ACCUMULATE
-DCB_SET = DCB_RESET | DCB_ACCUMULATE
-DCB_ENABLE = 4
-DCB_DISABLE = 8
-META_SETBKCOLOR = 513
-META_SETBKMODE = 258
-META_SETMAPMODE = 259
-META_SETROP2 = 260
-META_SETRELABS = 261
-META_SETPOLYFILLMODE = 262
-META_SETSTRETCHBLTMODE = 263
-META_SETTEXTCHAREXTRA = 264
-META_SETTEXTCOLOR = 521
-META_SETTEXTJUSTIFICATION = 522
-META_SETWINDOWORG = 523
-META_SETWINDOWEXT = 524
-META_SETVIEWPORTORG = 525
-META_SETVIEWPORTEXT = 526
-META_OFFSETWINDOWORG = 527
-META_SCALEWINDOWEXT = 1040
-META_OFFSETVIEWPORTORG = 529
-META_SCALEVIEWPORTEXT = 1042
-META_LINETO = 531
-META_MOVETO = 532
-META_EXCLUDECLIPRECT = 1045
-META_INTERSECTCLIPRECT = 1046
-META_ARC = 2071
-META_ELLIPSE = 1048
-META_FLOODFILL = 1049
-META_PIE = 2074
-META_RECTANGLE = 1051
-META_ROUNDRECT = 1564
-META_PATBLT = 1565
-META_SAVEDC = 30
-META_SETPIXEL = 1055
-META_OFFSETCLIPRGN = 544
-META_TEXTOUT = 1313
-META_BITBLT = 2338
-META_STRETCHBLT = 2851
-META_POLYGON = 804
-META_POLYLINE = 805
-META_ESCAPE = 1574
-META_RESTOREDC = 295
-META_FILLREGION = 552
-META_FRAMEREGION = 1065
-META_INVERTREGION = 298
-META_PAINTREGION = 299
-META_SELECTCLIPREGION = 300
-META_SELECTOBJECT = 301
-META_SETTEXTALIGN = 302
-META_CHORD = 2096
-META_SETMAPPERFLAGS = 561
-META_EXTTEXTOUT = 2610
-META_SETDIBTODEV = 3379
-META_SELECTPALETTE = 564
-META_REALIZEPALETTE = 53
-META_ANIMATEPALETTE = 1078
-META_SETPALENTRIES = 55
-META_POLYPOLYGON = 1336
-META_RESIZEPALETTE = 313
-META_DIBBITBLT = 2368
-META_DIBSTRETCHBLT = 2881
-META_DIBCREATEPATTERNBRUSH = 322
-META_STRETCHDIB = 3907
-META_EXTFLOODFILL = 1352
-META_DELETEOBJECT = 496
-META_CREATEPALETTE = 247
-META_CREATEPATTERNBRUSH = 505
-META_CREATEPENINDIRECT = 762
-META_CREATEFONTINDIRECT = 763
-META_CREATEBRUSHINDIRECT = 764
-META_CREATEREGION = 1791
-FILE_BEGIN = 0
-FILE_CURRENT = 1
-FILE_END = 2
-FILE_FLAG_WRITE_THROUGH = -2147483648
-FILE_FLAG_OVERLAPPED = 1073741824
-FILE_FLAG_NO_BUFFERING = 536870912
-FILE_FLAG_RANDOM_ACCESS = 268435456
-FILE_FLAG_SEQUENTIAL_SCAN = 134217728
-FILE_FLAG_DELETE_ON_CLOSE = 67108864
-FILE_FLAG_BACKUP_SEMANTICS = 33554432
-FILE_FLAG_POSIX_SEMANTICS = 16777216
-CREATE_NEW = 1
-CREATE_ALWAYS = 2
-OPEN_EXISTING = 3
-OPEN_ALWAYS = 4
-TRUNCATE_EXISTING = 5
-PIPE_ACCESS_INBOUND = 1
-PIPE_ACCESS_OUTBOUND = 2
-PIPE_ACCESS_DUPLEX = 3
-PIPE_CLIENT_END = 0
-PIPE_SERVER_END = 1
-PIPE_WAIT = 0
-PIPE_NOWAIT = 1
-PIPE_READMODE_BYTE = 0
-PIPE_READMODE_MESSAGE = 2
-PIPE_TYPE_BYTE = 0
-PIPE_TYPE_MESSAGE = 4
-PIPE_UNLIMITED_INSTANCES = 255
-SECURITY_CONTEXT_TRACKING = 262144
-SECURITY_EFFECTIVE_ONLY = 524288
-SECURITY_SQOS_PRESENT = 1048576
-SECURITY_VALID_SQOS_FLAGS = 2031616
-DTR_CONTROL_DISABLE = 0
-DTR_CONTROL_ENABLE = 1
-DTR_CONTROL_HANDSHAKE = 2
-RTS_CONTROL_DISABLE = 0
-RTS_CONTROL_ENABLE = 1
-RTS_CONTROL_HANDSHAKE = 2
-RTS_CONTROL_TOGGLE = 3
-GMEM_FIXED = 0
-GMEM_MOVEABLE = 2
-GMEM_NOCOMPACT = 16
-GMEM_NODISCARD = 32
-GMEM_ZEROINIT = 64
-GMEM_MODIFY = 128
-GMEM_DISCARDABLE = 256
-GMEM_NOT_BANKED = 4096
-GMEM_SHARE = 8192
-GMEM_DDESHARE = 8192
-GMEM_NOTIFY = 16384
-GMEM_LOWER = GMEM_NOT_BANKED
-GMEM_VALID_FLAGS = 32626
-GMEM_INVALID_HANDLE = 32768
-GHND = GMEM_MOVEABLE | GMEM_ZEROINIT
-GPTR = GMEM_FIXED | GMEM_ZEROINIT
-GMEM_DISCARDED = 16384
-GMEM_LOCKCOUNT = 255
-LMEM_FIXED = 0
-LMEM_MOVEABLE = 2
-LMEM_NOCOMPACT = 16
-LMEM_NODISCARD = 32
-LMEM_ZEROINIT = 64
-LMEM_MODIFY = 128
-LMEM_DISCARDABLE = 3840
-LMEM_VALID_FLAGS = 3954
-LMEM_INVALID_HANDLE = 32768
-LHND = LMEM_MOVEABLE | LMEM_ZEROINIT
-LPTR = LMEM_FIXED | LMEM_ZEROINIT
-NONZEROLHND = LMEM_MOVEABLE
-NONZEROLPTR = LMEM_FIXED
-LMEM_DISCARDED = 16384
-LMEM_LOCKCOUNT = 255
-DEBUG_PROCESS = 1
-DEBUG_ONLY_THIS_PROCESS = 2
-CREATE_SUSPENDED = 4
-DETACHED_PROCESS = 8
-CREATE_NEW_CONSOLE = 16
-NORMAL_PRIORITY_CLASS = 32
-IDLE_PRIORITY_CLASS = 64
-HIGH_PRIORITY_CLASS = 128
-REALTIME_PRIORITY_CLASS = 256
-CREATE_NEW_PROCESS_GROUP = 512
-CREATE_UNICODE_ENVIRONMENT = 1024
-CREATE_SEPARATE_WOW_VDM = 2048
-CREATE_SHARED_WOW_VDM = 4096
-CREATE_DEFAULT_ERROR_MODE = 67108864
-CREATE_NO_WINDOW = 134217728
-PROFILE_USER = 268435456
-PROFILE_KERNEL = 536870912
-PROFILE_SERVER = 1073741824
-THREAD_BASE_PRIORITY_LOWRT = 15
-THREAD_BASE_PRIORITY_MAX = 2
-THREAD_BASE_PRIORITY_MIN = -2
-THREAD_BASE_PRIORITY_IDLE = -15
-THREAD_PRIORITY_LOWEST = THREAD_BASE_PRIORITY_MIN
-THREAD_PRIORITY_BELOW_NORMAL = THREAD_PRIORITY_LOWEST + 1
-THREAD_PRIORITY_HIGHEST = THREAD_BASE_PRIORITY_MAX
-THREAD_PRIORITY_ABOVE_NORMAL = THREAD_PRIORITY_HIGHEST - 1
-THREAD_PRIORITY_ERROR_RETURN = MAXLONG
-THREAD_PRIORITY_TIME_CRITICAL = THREAD_BASE_PRIORITY_LOWRT
-THREAD_PRIORITY_IDLE = THREAD_BASE_PRIORITY_IDLE
-THREAD_PRIORITY_NORMAL = 0
-THREAD_MODE_BACKGROUND_BEGIN = 0x00010000
-THREAD_MODE_BACKGROUND_END = 0x00020000
-
-EXCEPTION_DEBUG_EVENT = 1
-CREATE_THREAD_DEBUG_EVENT = 2
-CREATE_PROCESS_DEBUG_EVENT = 3
-EXIT_THREAD_DEBUG_EVENT = 4
-EXIT_PROCESS_DEBUG_EVENT = 5
-LOAD_DLL_DEBUG_EVENT = 6
-UNLOAD_DLL_DEBUG_EVENT = 7
-OUTPUT_DEBUG_STRING_EVENT = 8
-RIP_EVENT = 9
-DRIVE_UNKNOWN = 0
-DRIVE_NO_ROOT_DIR = 1
-DRIVE_REMOVABLE = 2
-DRIVE_FIXED = 3
-DRIVE_REMOTE = 4
-DRIVE_CDROM = 5
-DRIVE_RAMDISK = 6
-FILE_TYPE_UNKNOWN = 0
-FILE_TYPE_DISK = 1
-FILE_TYPE_CHAR = 2
-FILE_TYPE_PIPE = 3
-FILE_TYPE_REMOTE = 32768
-NOPARITY = 0
-ODDPARITY = 1
-EVENPARITY = 2
-MARKPARITY = 3
-SPACEPARITY = 4
-ONESTOPBIT = 0
-ONE5STOPBITS = 1
-TWOSTOPBITS = 2
-CBR_110 = 110
-CBR_300 = 300
-CBR_600 = 600
-CBR_1200 = 1200
-CBR_2400 = 2400
-CBR_4800 = 4800
-CBR_9600 = 9600
-CBR_14400 = 14400
-CBR_19200 = 19200
-CBR_38400 = 38400
-CBR_56000 = 56000
-CBR_57600 = 57600
-CBR_115200 = 115200
-CBR_128000 = 128000
-CBR_256000 = 256000
-S_QUEUEEMPTY = 0
-S_THRESHOLD = 1
-S_ALLTHRESHOLD = 2
-S_NORMAL = 0
-S_LEGATO = 1
-S_STACCATO = 2
-NMPWAIT_WAIT_FOREVER = -1
-NMPWAIT_NOWAIT = 1
-NMPWAIT_USE_DEFAULT_WAIT = 0
-OF_READ = 0
-OF_WRITE = 1
-OF_READWRITE = 2
-OF_SHARE_COMPAT = 0
-OF_SHARE_EXCLUSIVE = 16
-OF_SHARE_DENY_WRITE = 32
-OF_SHARE_DENY_READ = 48
-OF_SHARE_DENY_NONE = 64
-OF_PARSE = 256
-OF_DELETE = 512
-OF_VERIFY = 1024
-OF_CANCEL = 2048
-OF_CREATE = 4096
-OF_PROMPT = 8192
-OF_EXIST = 16384
-OF_REOPEN = 32768
-OFS_MAXPATHNAME = 128
-MAXINTATOM = 49152
-
-# winbase.h
-PROCESS_HEAP_REGION = 1
-PROCESS_HEAP_UNCOMMITTED_RANGE = 2
-PROCESS_HEAP_ENTRY_BUSY = 4
-PROCESS_HEAP_ENTRY_MOVEABLE = 16
-PROCESS_HEAP_ENTRY_DDESHARE = 32
-SCS_32BIT_BINARY = 0
-SCS_DOS_BINARY = 1
-SCS_WOW_BINARY = 2
-SCS_PIF_BINARY = 3
-SCS_POSIX_BINARY = 4
-SCS_OS216_BINARY = 5
-SEM_FAILCRITICALERRORS = 1
-SEM_NOGPFAULTERRORBOX = 2
-SEM_NOALIGNMENTFAULTEXCEPT = 4
-SEM_NOOPENFILEERRORBOX = 32768
-LOCKFILE_FAIL_IMMEDIATELY = 1
-LOCKFILE_EXCLUSIVE_LOCK = 2
-HANDLE_FLAG_INHERIT = 1
-HANDLE_FLAG_PROTECT_FROM_CLOSE = 2
-HINSTANCE_ERROR = 32
-GET_TAPE_MEDIA_INFORMATION = 0
-GET_TAPE_DRIVE_INFORMATION = 1
-SET_TAPE_MEDIA_INFORMATION = 0
-SET_TAPE_DRIVE_INFORMATION = 1
-FORMAT_MESSAGE_ALLOCATE_BUFFER = 256
-FORMAT_MESSAGE_IGNORE_INSERTS = 512
-FORMAT_MESSAGE_FROM_STRING = 1024
-FORMAT_MESSAGE_FROM_HMODULE = 2048
-FORMAT_MESSAGE_FROM_SYSTEM = 4096
-FORMAT_MESSAGE_ARGUMENT_ARRAY = 8192
-FORMAT_MESSAGE_MAX_WIDTH_MASK = 255
-BACKUP_INVALID = 0
-BACKUP_DATA = 1
-BACKUP_EA_DATA = 2
-BACKUP_SECURITY_DATA = 3
-BACKUP_ALTERNATE_DATA = 4
-BACKUP_LINK = 5
-BACKUP_PROPERTY_DATA = 6
-BACKUP_OBJECT_ID = 7
-BACKUP_REPARSE_DATA = 8
-BACKUP_SPARSE_BLOCK = 9
-
-STREAM_NORMAL_ATTRIBUTE = 0
-STREAM_MODIFIED_WHEN_READ = 1
-STREAM_CONTAINS_SECURITY = 2
-STREAM_CONTAINS_PROPERTIES = 4
-STARTF_USESHOWWINDOW = 1
-STARTF_USESIZE = 2
-STARTF_USEPOSITION = 4
-STARTF_USECOUNTCHARS = 8
-STARTF_USEFILLATTRIBUTE = 16
-STARTF_FORCEONFEEDBACK = 64
-STARTF_FORCEOFFFEEDBACK = 128
-STARTF_USESTDHANDLES = 256
-STARTF_USEHOTKEY = 512
-SHUTDOWN_NORETRY = 1
-DONT_RESOLVE_DLL_REFERENCES = 1
-LOAD_LIBRARY_AS_DATAFILE = 2
-LOAD_WITH_ALTERED_SEARCH_PATH = 8
-DDD_RAW_TARGET_PATH = 1
-DDD_REMOVE_DEFINITION = 2
-DDD_EXACT_MATCH_ON_REMOVE = 4
-MOVEFILE_REPLACE_EXISTING = 1
-MOVEFILE_COPY_ALLOWED = 2
-MOVEFILE_DELAY_UNTIL_REBOOT = 4
-MAX_COMPUTERNAME_LENGTH = 15
-LOGON32_LOGON_INTERACTIVE = 2
-LOGON32_LOGON_NETWORK = 3
-LOGON32_LOGON_BATCH = 4
-LOGON32_LOGON_SERVICE = 5
-LOGON32_LOGON_UNLOCK = 7
-LOGON32_LOGON_NETWORK_CLEARTEXT = 8
-LOGON32_LOGON_NEW_CREDENTIALS = 9
-LOGON32_PROVIDER_DEFAULT = 0
-LOGON32_PROVIDER_WINNT35 = 1
-LOGON32_PROVIDER_WINNT40 = 2
-LOGON32_PROVIDER_WINNT50 = 3
-VER_PLATFORM_WIN32s = 0
-VER_PLATFORM_WIN32_WINDOWS = 1
-VER_PLATFORM_WIN32_NT = 2
-TC_NORMAL = 0
-TC_HARDERR = 1
-TC_GP_TRAP = 2
-TC_SIGNAL = 3
-AC_LINE_OFFLINE = 0
-AC_LINE_ONLINE = 1
-AC_LINE_BACKUP_POWER = 2
-AC_LINE_UNKNOWN = 255
-BATTERY_FLAG_HIGH = 1
-BATTERY_FLAG_LOW = 2
-BATTERY_FLAG_CRITICAL = 4
-BATTERY_FLAG_CHARGING = 8
-BATTERY_FLAG_NO_BATTERY = 128
-BATTERY_FLAG_UNKNOWN = 255
-BATTERY_PERCENTAGE_UNKNOWN = 255
-BATTERY_LIFE_UNKNOWN = -1
-
-# Generated by h2py from d:\msdev\include\richedit.h
-cchTextLimitDefault = 32767
-WM_CONTEXTMENU = 123
-WM_PRINTCLIENT = 792
-EN_MSGFILTER = 1792
-EN_REQUESTRESIZE = 1793
-EN_SELCHANGE = 1794
-EN_DROPFILES = 1795
-EN_PROTECTED = 1796
-EN_CORRECTTEXT = 1797
-EN_STOPNOUNDO = 1798
-EN_IMECHANGE = 1799
-EN_SAVECLIPBOARD = 1800
-EN_OLEOPFAILED = 1801
-ENM_NONE = 0
-ENM_CHANGE = 1
-ENM_UPDATE = 2
-ENM_SCROLL = 4
-ENM_KEYEVENTS = 65536
-ENM_MOUSEEVENTS = 131072
-ENM_REQUESTRESIZE = 262144
-ENM_SELCHANGE = 524288
-ENM_DROPFILES = 1048576
-ENM_PROTECTED = 2097152
-ENM_CORRECTTEXT = 4194304
-ENM_IMECHANGE = 8388608
-ES_SAVESEL = 32768
-ES_SUNKEN = 16384
-ES_DISABLENOSCROLL = 8192
-ES_SELECTIONBAR = 16777216
-ES_EX_NOCALLOLEINIT = 16777216
-ES_VERTICAL = 4194304
-ES_NOIME = 524288
-ES_SELFIME = 262144
-ECO_AUTOWORDSELECTION = 1
-ECO_AUTOVSCROLL = 64
-ECO_AUTOHSCROLL = 128
-ECO_NOHIDESEL = 256
-ECO_READONLY = 2048
-ECO_WANTRETURN = 4096
-ECO_SAVESEL = 32768
-ECO_SELECTIONBAR = 16777216
-ECO_VERTICAL = 4194304
-ECOOP_SET = 1
-ECOOP_OR = 2
-ECOOP_AND = 3
-ECOOP_XOR = 4
-WB_CLASSIFY = 3
-WB_MOVEWORDLEFT = 4
-WB_MOVEWORDRIGHT = 5
-WB_LEFTBREAK = 6
-WB_RIGHTBREAK = 7
-WB_MOVEWORDPREV = 4
-WB_MOVEWORDNEXT = 5
-WB_PREVBREAK = 6
-WB_NEXTBREAK = 7
-PC_FOLLOWING = 1
-PC_LEADING = 2
-PC_OVERFLOW = 3
-PC_DELIMITER = 4
-WBF_WORDWRAP = 16
-WBF_WORDBREAK = 32
-WBF_OVERFLOW = 64
-WBF_LEVEL1 = 128
-WBF_LEVEL2 = 256
-WBF_CUSTOM = 512
-CFM_BOLD = 1
-CFM_ITALIC = 2
-CFM_UNDERLINE = 4
-CFM_STRIKEOUT = 8
-CFM_PROTECTED = 16
-CFM_SIZE = -2147483648
-CFM_COLOR = 1073741824
-CFM_FACE = 536870912
-CFM_OFFSET = 268435456
-CFM_CHARSET = 134217728
-CFE_BOLD = 1
-CFE_ITALIC = 2
-CFE_UNDERLINE = 4
-CFE_STRIKEOUT = 8
-CFE_PROTECTED = 16
-CFE_AUTOCOLOR = 1073741824
-yHeightCharPtsMost = 1638
-SCF_SELECTION = 1
-SCF_WORD = 2
-SF_TEXT = 1
-SF_RTF = 2
-SF_RTFNOOBJS = 3
-SF_TEXTIZED = 4
-SFF_SELECTION = 32768
-SFF_PLAINRTF = 16384
-MAX_TAB_STOPS = 32
-lDefaultTab = 720
-PFM_STARTINDENT = 1
-PFM_RIGHTINDENT = 2
-PFM_OFFSET = 4
-PFM_ALIGNMENT = 8
-PFM_TABSTOPS = 16
-PFM_NUMBERING = 32
-PFM_OFFSETINDENT = -2147483648
-PFN_BULLET = 1
-PFA_LEFT = 1
-PFA_RIGHT = 2
-PFA_CENTER = 3
-WM_NOTIFY = 78
-SEL_EMPTY = 0
-SEL_TEXT = 1
-SEL_OBJECT = 2
-SEL_MULTICHAR = 4
-SEL_MULTIOBJECT = 8
-OLEOP_DOVERB = 1
-CF_RTF = "Rich Text Format"
-CF_RTFNOOBJS = "Rich Text Format Without Objects"
-CF_RETEXTOBJ = "RichEdit Text and Objects"
-
-# From wincon.h
-RIGHT_ALT_PRESSED = 1  # the right alt key is pressed.
-LEFT_ALT_PRESSED = 2  # the left alt key is pressed.
-RIGHT_CTRL_PRESSED = 4  # the right ctrl key is pressed.
-LEFT_CTRL_PRESSED = 8  # the left ctrl key is pressed.
-SHIFT_PRESSED = 16  # the shift key is pressed.
-NUMLOCK_ON = 32  # the numlock light is on.
-SCROLLLOCK_ON = 64  # the scrolllock light is on.
-CAPSLOCK_ON = 128  # the capslock light is on.
-ENHANCED_KEY = 256  # the key is enhanced.
-NLS_DBCSCHAR = 65536  # DBCS for JPN: SBCS/DBCS mode.
-NLS_ALPHANUMERIC = 0  # DBCS for JPN: Alphanumeric mode.
-NLS_KATAKANA = 131072  # DBCS for JPN: Katakana mode.
-NLS_HIRAGANA = 262144  # DBCS for JPN: Hiragana mode.
-NLS_ROMAN = 4194304  # DBCS for JPN: Roman/Noroman mode.
-NLS_IME_CONVERSION = 8388608  # DBCS for JPN: IME conversion.
-NLS_IME_DISABLE = 536870912  # DBCS for JPN: IME enable/disable.
-
-FROM_LEFT_1ST_BUTTON_PRESSED = 1
-RIGHTMOST_BUTTON_PRESSED = 2
-FROM_LEFT_2ND_BUTTON_PRESSED = 4
-FROM_LEFT_3RD_BUTTON_PRESSED = 8
-FROM_LEFT_4TH_BUTTON_PRESSED = 16
-
-CTRL_C_EVENT = 0
-CTRL_BREAK_EVENT = 1
-CTRL_CLOSE_EVENT = 2
-CTRL_LOGOFF_EVENT = 5
-CTRL_SHUTDOWN_EVENT = 6
-
-MOUSE_MOVED = 1
-DOUBLE_CLICK = 2
-MOUSE_WHEELED = 4
-
-# property sheet window messages from prsht.h
-PSM_SETCURSEL = WM_USER + 101
-PSM_REMOVEPAGE = WM_USER + 102
-PSM_ADDPAGE = WM_USER + 103
-PSM_CHANGED = WM_USER + 104
-PSM_RESTARTWINDOWS = WM_USER + 105
-PSM_REBOOTSYSTEM = WM_USER + 106
-PSM_CANCELTOCLOSE = WM_USER + 107
-PSM_QUERYSIBLINGS = WM_USER + 108
-PSM_UNCHANGED = WM_USER + 109
-PSM_APPLY = WM_USER + 110
-PSM_SETTITLEA = WM_USER + 111
-PSM_SETTITLEW = WM_USER + 120
-PSM_SETWIZBUTTONS = WM_USER + 112
-PSM_PRESSBUTTON = WM_USER + 113
-PSM_SETCURSELID = WM_USER + 114
-PSM_SETFINISHTEXTA = WM_USER + 115
-PSM_SETFINISHTEXTW = WM_USER + 121
-PSM_GETTABCONTROL = WM_USER + 116
-PSM_ISDIALOGMESSAGE = WM_USER + 117
-PSM_GETCURRENTPAGEHWND = WM_USER + 118
-PSM_INSERTPAGE = WM_USER + 119
-PSM_SETHEADERTITLEA = WM_USER + 125
-PSM_SETHEADERTITLEW = WM_USER + 126
-PSM_SETHEADERSUBTITLEA = WM_USER + 127
-PSM_SETHEADERSUBTITLEW = WM_USER + 128
-PSM_HWNDTOINDEX = WM_USER + 129
-PSM_INDEXTOHWND = WM_USER + 130
-PSM_PAGETOINDEX = WM_USER + 131
-PSM_INDEXTOPAGE = WM_USER + 132
-PSM_IDTOINDEX = WM_USER + 133
-PSM_INDEXTOID = WM_USER + 134
-PSM_GETRESULT = WM_USER + 135
-PSM_RECALCPAGESIZES = WM_USER + 136
-
-# GetUserNameEx/GetComputerNameEx
-NameUnknown = 0
-NameFullyQualifiedDN = 1
-NameSamCompatible = 2
-NameDisplay = 3
-NameUniqueId = 6
-NameCanonical = 7
-NameUserPrincipal = 8
-NameCanonicalEx = 9
-NameServicePrincipal = 10
-NameDnsDomain = 12
-
-ComputerNameNetBIOS = 0
-ComputerNameDnsHostname = 1
-ComputerNameDnsDomain = 2
-ComputerNameDnsFullyQualified = 3
-ComputerNamePhysicalNetBIOS = 4
-ComputerNamePhysicalDnsHostname = 5
-ComputerNamePhysicalDnsDomain = 6
-ComputerNamePhysicalDnsFullyQualified = 7
-
-LWA_COLORKEY = 0x00000001
-LWA_ALPHA = 0x00000002
-ULW_COLORKEY = 0x00000001
-ULW_ALPHA = 0x00000002
-ULW_OPAQUE = 0x00000004
-
-# WinDef.h
-TRUE = 1
-FALSE = 0
-MAX_PATH = 260
-# WinGDI.h
-AC_SRC_OVER = 0
-AC_SRC_ALPHA = 1
-GRADIENT_FILL_RECT_H = 0
-GRADIENT_FILL_RECT_V = 1
-GRADIENT_FILL_TRIANGLE = 2
-GRADIENT_FILL_OP_FLAG = 255
-
-## flags used with Get/SetSystemFileCacheSize
-MM_WORKING_SET_MAX_HARD_ENABLE = 1
-MM_WORKING_SET_MAX_HARD_DISABLE = 2
-MM_WORKING_SET_MIN_HARD_ENABLE = 4
-MM_WORKING_SET_MIN_HARD_DISABLE = 8
-
-## Flags for GetFinalPathNameByHandle
-VOLUME_NAME_DOS = 0
-VOLUME_NAME_GUID = 1
-VOLUME_NAME_NT = 2
-VOLUME_NAME_NONE = 4
-FILE_NAME_NORMALIZED = 0
-FILE_NAME_OPENED = 8
-
-DEVICE_NOTIFY_WINDOW_HANDLE = 0x00000000
-DEVICE_NOTIFY_SERVICE_HANDLE = 0x00000001
-
-# From Dbt.h
-# Generated by h2py from Dbt.h
-WM_DEVICECHANGE = 0x0219
-BSF_QUERY = 0x00000001
-BSF_IGNORECURRENTTASK = 0x00000002
-BSF_FLUSHDISK = 0x00000004
-BSF_NOHANG = 0x00000008
-BSF_POSTMESSAGE = 0x00000010
-BSF_FORCEIFHUNG = 0x00000020
-BSF_NOTIMEOUTIFNOTHUNG = 0x00000040
-BSF_MSGSRV32ISOK = -2147483648
-BSF_MSGSRV32ISOK_BIT = 31
-BSM_ALLCOMPONENTS = 0x00000000
-BSM_VXDS = 0x00000001
-BSM_NETDRIVER = 0x00000002
-BSM_INSTALLABLEDRIVERS = 0x00000004
-BSM_APPLICATIONS = 0x00000008
-DBT_APPYBEGIN = 0x0000
-DBT_APPYEND = 0x0001
-DBT_DEVNODES_CHANGED = 0x0007
-DBT_QUERYCHANGECONFIG = 0x0017
-DBT_CONFIGCHANGED = 0x0018
-DBT_CONFIGCHANGECANCELED = 0x0019
-DBT_MONITORCHANGE = 0x001B
-DBT_SHELLLOGGEDON = 0x0020
-DBT_CONFIGMGAPI32 = 0x0022
-DBT_VXDINITCOMPLETE = 0x0023
-DBT_VOLLOCKQUERYLOCK = 0x8041
-DBT_VOLLOCKLOCKTAKEN = 0x8042
-DBT_VOLLOCKLOCKFAILED = 0x8043
-DBT_VOLLOCKQUERYUNLOCK = 0x8044
-DBT_VOLLOCKLOCKRELEASED = 0x8045
-DBT_VOLLOCKUNLOCKFAILED = 0x8046
-LOCKP_ALLOW_WRITES = 0x01
-LOCKP_FAIL_WRITES = 0x00
-LOCKP_FAIL_MEM_MAPPING = 0x02
-LOCKP_ALLOW_MEM_MAPPING = 0x00
-LOCKP_USER_MASK = 0x03
-LOCKP_LOCK_FOR_FORMAT = 0x04
-LOCKF_LOGICAL_LOCK = 0x00
-LOCKF_PHYSICAL_LOCK = 0x01
-DBT_NO_DISK_SPACE = 0x0047
-DBT_LOW_DISK_SPACE = 0x0048
-DBT_CONFIGMGPRIVATE = 0x7FFF
-DBT_DEVICEARRIVAL = 0x8000
-DBT_DEVICEQUERYREMOVE = 0x8001
-DBT_DEVICEQUERYREMOVEFAILED = 0x8002
-DBT_DEVICEREMOVEPENDING = 0x8003
-DBT_DEVICEREMOVECOMPLETE = 0x8004
-DBT_DEVICETYPESPECIFIC = 0x8005
-DBT_CUSTOMEVENT = 0x8006
-DBT_DEVTYP_OEM = 0x00000000
-DBT_DEVTYP_DEVNODE = 0x00000001
-DBT_DEVTYP_VOLUME = 0x00000002
-DBT_DEVTYP_PORT = 0x00000003
-DBT_DEVTYP_NET = 0x00000004
-DBT_DEVTYP_DEVICEINTERFACE = 0x00000005
-DBT_DEVTYP_HANDLE = 0x00000006
-DBTF_MEDIA = 0x0001
-DBTF_NET = 0x0002
-DBTF_RESOURCE = 0x00000001
-DBTF_XPORT = 0x00000002
-DBTF_SLOWNET = 0x00000004
-DBT_VPOWERDAPI = 0x8100
-DBT_USERDEFINED = 0xFFFF
diff --git a/lib/win32/lib/win32cryptcon.py b/lib/win32/lib/win32cryptcon.py
deleted file mode 100644
index 8d71996a..00000000
--- a/lib/win32/lib/win32cryptcon.py
+++ /dev/null
@@ -1,1925 +0,0 @@
-# Generated by h2py from WinCrypt.h
-def GET_ALG_CLASS(x):
-    return x & (7 << 13)
-
-
-def GET_ALG_TYPE(x):
-    return x & (15 << 9)
-
-
-def GET_ALG_SID(x):
-    return x & (511)
-
-
-ALG_CLASS_ANY = 0
-ALG_CLASS_SIGNATURE = 1 << 13
-ALG_CLASS_MSG_ENCRYPT = 2 << 13
-ALG_CLASS_DATA_ENCRYPT = 3 << 13
-ALG_CLASS_HASH = 4 << 13
-ALG_CLASS_KEY_EXCHANGE = 5 << 13
-ALG_CLASS_ALL = 7 << 13
-ALG_TYPE_ANY = 0
-ALG_TYPE_DSS = 1 << 9
-ALG_TYPE_RSA = 2 << 9
-ALG_TYPE_BLOCK = 3 << 9
-ALG_TYPE_STREAM = 4 << 9
-ALG_TYPE_DH = 5 << 9
-ALG_TYPE_SECURECHANNEL = 6 << 9
-ALG_SID_ANY = 0
-ALG_SID_RSA_ANY = 0
-ALG_SID_RSA_PKCS = 1
-ALG_SID_RSA_MSATWORK = 2
-ALG_SID_RSA_ENTRUST = 3
-ALG_SID_RSA_PGP = 4
-ALG_SID_DSS_ANY = 0
-ALG_SID_DSS_PKCS = 1
-ALG_SID_DSS_DMS = 2
-ALG_SID_DES = 1
-ALG_SID_3DES = 3
-ALG_SID_DESX = 4
-ALG_SID_IDEA = 5
-ALG_SID_CAST = 6
-ALG_SID_SAFERSK64 = 7
-ALG_SID_SAFERSK128 = 8
-ALG_SID_3DES_112 = 9
-ALG_SID_CYLINK_MEK = 12
-ALG_SID_RC5 = 13
-ALG_SID_AES_128 = 14
-ALG_SID_AES_192 = 15
-ALG_SID_AES_256 = 16
-ALG_SID_AES = 17
-ALG_SID_SKIPJACK = 10
-ALG_SID_TEK = 11
-CRYPT_MODE_CBCI = 6
-CRYPT_MODE_CFBP = 7
-CRYPT_MODE_OFBP = 8
-CRYPT_MODE_CBCOFM = 9
-CRYPT_MODE_CBCOFMI = 10
-ALG_SID_RC2 = 2
-ALG_SID_RC4 = 1
-ALG_SID_SEAL = 2
-ALG_SID_DH_SANDF = 1
-ALG_SID_DH_EPHEM = 2
-ALG_SID_AGREED_KEY_ANY = 3
-ALG_SID_KEA = 4
-ALG_SID_MD2 = 1
-ALG_SID_MD4 = 2
-ALG_SID_MD5 = 3
-ALG_SID_SHA = 4
-ALG_SID_SHA1 = 4
-ALG_SID_MAC = 5
-ALG_SID_RIPEMD = 6
-ALG_SID_RIPEMD160 = 7
-ALG_SID_SSL3SHAMD5 = 8
-ALG_SID_HMAC = 9
-ALG_SID_TLS1PRF = 10
-ALG_SID_HASH_REPLACE_OWF = 11
-ALG_SID_SHA_256 = 12
-ALG_SID_SHA_384 = 13
-ALG_SID_SHA_512 = 14
-ALG_SID_SSL3_MASTER = 1
-ALG_SID_SCHANNEL_MASTER_HASH = 2
-ALG_SID_SCHANNEL_MAC_KEY = 3
-ALG_SID_PCT1_MASTER = 4
-ALG_SID_SSL2_MASTER = 5
-ALG_SID_TLS1_MASTER = 6
-ALG_SID_SCHANNEL_ENC_KEY = 7
-ALG_SID_EXAMPLE = 80
-CALG_MD2 = ALG_CLASS_HASH | ALG_TYPE_ANY | ALG_SID_MD2
-CALG_MD4 = ALG_CLASS_HASH | ALG_TYPE_ANY | ALG_SID_MD4
-CALG_MD5 = ALG_CLASS_HASH | ALG_TYPE_ANY | ALG_SID_MD5
-CALG_SHA = ALG_CLASS_HASH | ALG_TYPE_ANY | ALG_SID_SHA
-CALG_SHA1 = ALG_CLASS_HASH | ALG_TYPE_ANY | ALG_SID_SHA1
-CALG_MAC = ALG_CLASS_HASH | ALG_TYPE_ANY | ALG_SID_MAC
-CALG_RSA_SIGN = ALG_CLASS_SIGNATURE | ALG_TYPE_RSA | ALG_SID_RSA_ANY
-CALG_DSS_SIGN = ALG_CLASS_SIGNATURE | ALG_TYPE_DSS | ALG_SID_DSS_ANY
-CALG_NO_SIGN = ALG_CLASS_SIGNATURE | ALG_TYPE_ANY | ALG_SID_ANY
-CALG_RSA_KEYX = ALG_CLASS_KEY_EXCHANGE | ALG_TYPE_RSA | ALG_SID_RSA_ANY
-CALG_DES = ALG_CLASS_DATA_ENCRYPT | ALG_TYPE_BLOCK | ALG_SID_DES
-CALG_3DES_112 = ALG_CLASS_DATA_ENCRYPT | ALG_TYPE_BLOCK | ALG_SID_3DES_112
-CALG_3DES = ALG_CLASS_DATA_ENCRYPT | ALG_TYPE_BLOCK | ALG_SID_3DES
-CALG_DESX = ALG_CLASS_DATA_ENCRYPT | ALG_TYPE_BLOCK | ALG_SID_DESX
-CALG_RC2 = ALG_CLASS_DATA_ENCRYPT | ALG_TYPE_BLOCK | ALG_SID_RC2
-CALG_RC4 = ALG_CLASS_DATA_ENCRYPT | ALG_TYPE_STREAM | ALG_SID_RC4
-CALG_SEAL = ALG_CLASS_DATA_ENCRYPT | ALG_TYPE_STREAM | ALG_SID_SEAL
-CALG_DH_SF = ALG_CLASS_KEY_EXCHANGE | ALG_TYPE_DH | ALG_SID_DH_SANDF
-CALG_DH_EPHEM = ALG_CLASS_KEY_EXCHANGE | ALG_TYPE_DH | ALG_SID_DH_EPHEM
-CALG_AGREEDKEY_ANY = ALG_CLASS_KEY_EXCHANGE | ALG_TYPE_DH | ALG_SID_AGREED_KEY_ANY
-CALG_KEA_KEYX = ALG_CLASS_KEY_EXCHANGE | ALG_TYPE_DH | ALG_SID_KEA
-CALG_HUGHES_MD5 = ALG_CLASS_KEY_EXCHANGE | ALG_TYPE_ANY | ALG_SID_MD5
-CALG_SKIPJACK = ALG_CLASS_DATA_ENCRYPT | ALG_TYPE_BLOCK | ALG_SID_SKIPJACK
-CALG_TEK = ALG_CLASS_DATA_ENCRYPT | ALG_TYPE_BLOCK | ALG_SID_TEK
-CALG_CYLINK_MEK = ALG_CLASS_DATA_ENCRYPT | ALG_TYPE_BLOCK | ALG_SID_CYLINK_MEK
-CALG_SSL3_SHAMD5 = ALG_CLASS_HASH | ALG_TYPE_ANY | ALG_SID_SSL3SHAMD5
-CALG_SSL3_MASTER = ALG_CLASS_MSG_ENCRYPT | ALG_TYPE_SECURECHANNEL | ALG_SID_SSL3_MASTER
-CALG_SCHANNEL_MASTER_HASH = (
-    ALG_CLASS_MSG_ENCRYPT | ALG_TYPE_SECURECHANNEL | ALG_SID_SCHANNEL_MASTER_HASH
-)
-CALG_SCHANNEL_MAC_KEY = (
-    ALG_CLASS_MSG_ENCRYPT | ALG_TYPE_SECURECHANNEL | ALG_SID_SCHANNEL_MAC_KEY
-)
-CALG_SCHANNEL_ENC_KEY = (
-    ALG_CLASS_MSG_ENCRYPT | ALG_TYPE_SECURECHANNEL | ALG_SID_SCHANNEL_ENC_KEY
-)
-CALG_PCT1_MASTER = ALG_CLASS_MSG_ENCRYPT | ALG_TYPE_SECURECHANNEL | ALG_SID_PCT1_MASTER
-CALG_SSL2_MASTER = ALG_CLASS_MSG_ENCRYPT | ALG_TYPE_SECURECHANNEL | ALG_SID_SSL2_MASTER
-CALG_TLS1_MASTER = ALG_CLASS_MSG_ENCRYPT | ALG_TYPE_SECURECHANNEL | ALG_SID_TLS1_MASTER
-CALG_RC5 = ALG_CLASS_DATA_ENCRYPT | ALG_TYPE_BLOCK | ALG_SID_RC5
-CALG_HMAC = ALG_CLASS_HASH | ALG_TYPE_ANY | ALG_SID_HMAC
-CALG_TLS1PRF = ALG_CLASS_HASH | ALG_TYPE_ANY | ALG_SID_TLS1PRF
-CALG_HASH_REPLACE_OWF = ALG_CLASS_HASH | ALG_TYPE_ANY | ALG_SID_HASH_REPLACE_OWF
-CALG_AES_128 = ALG_CLASS_DATA_ENCRYPT | ALG_TYPE_BLOCK | ALG_SID_AES_128
-CALG_AES_192 = ALG_CLASS_DATA_ENCRYPT | ALG_TYPE_BLOCK | ALG_SID_AES_192
-CALG_AES_256 = ALG_CLASS_DATA_ENCRYPT | ALG_TYPE_BLOCK | ALG_SID_AES_256
-CALG_AES = ALG_CLASS_DATA_ENCRYPT | ALG_TYPE_BLOCK | ALG_SID_AES
-CALG_SHA_256 = ALG_CLASS_HASH | ALG_TYPE_ANY | ALG_SID_SHA_256
-CALG_SHA_384 = ALG_CLASS_HASH | ALG_TYPE_ANY | ALG_SID_SHA_384
-CALG_SHA_512 = ALG_CLASS_HASH | ALG_TYPE_ANY | ALG_SID_SHA_512
-CRYPT_VERIFYCONTEXT = -268435456
-CRYPT_NEWKEYSET = 0x00000008
-CRYPT_DELETEKEYSET = 0x00000010
-CRYPT_MACHINE_KEYSET = 0x00000020
-CRYPT_SILENT = 0x00000040
-CRYPT_EXPORTABLE = 0x00000001
-CRYPT_USER_PROTECTED = 0x00000002
-CRYPT_CREATE_SALT = 0x00000004
-CRYPT_UPDATE_KEY = 0x00000008
-CRYPT_NO_SALT = 0x00000010
-CRYPT_PREGEN = 0x00000040
-CRYPT_RECIPIENT = 0x00000010
-CRYPT_INITIATOR = 0x00000040
-CRYPT_ONLINE = 0x00000080
-CRYPT_SF = 0x00000100
-CRYPT_CREATE_IV = 0x00000200
-CRYPT_KEK = 0x00000400
-CRYPT_DATA_KEY = 0x00000800
-CRYPT_VOLATILE = 0x00001000
-CRYPT_SGCKEY = 0x00002000
-CRYPT_ARCHIVABLE = 0x00004000
-RSA1024BIT_KEY = 0x04000000
-CRYPT_SERVER = 0x00000400
-KEY_LENGTH_MASK = -65536
-CRYPT_Y_ONLY = 0x00000001
-CRYPT_SSL2_FALLBACK = 0x00000002
-CRYPT_DESTROYKEY = 0x00000004
-CRYPT_OAEP = 0x00000040
-CRYPT_BLOB_VER3 = 0x00000080
-CRYPT_IPSEC_HMAC_KEY = 0x00000100
-CRYPT_DECRYPT_RSA_NO_PADDING_CHECK = 0x00000020
-CRYPT_SECRETDIGEST = 0x00000001
-CRYPT_OWF_REPL_LM_HASH = 0x00000001
-CRYPT_LITTLE_ENDIAN = 0x00000001
-CRYPT_NOHASHOID = 0x00000001
-CRYPT_TYPE2_FORMAT = 0x00000002
-CRYPT_X931_FORMAT = 0x00000004
-CRYPT_MACHINE_DEFAULT = 0x00000001
-CRYPT_USER_DEFAULT = 0x00000002
-CRYPT_DELETE_DEFAULT = 0x00000004
-SIMPLEBLOB = 0x1
-PUBLICKEYBLOB = 0x6
-PRIVATEKEYBLOB = 0x7
-PLAINTEXTKEYBLOB = 0x8
-OPAQUEKEYBLOB = 0x9
-PUBLICKEYBLOBEX = 0xA
-SYMMETRICWRAPKEYBLOB = 0xB
-AT_KEYEXCHANGE = 1
-AT_SIGNATURE = 2
-CRYPT_USERDATA = 1
-KP_IV = 1
-KP_SALT = 2
-KP_PADDING = 3
-KP_MODE = 4
-KP_MODE_BITS = 5
-KP_PERMISSIONS = 6
-KP_ALGID = 7
-KP_BLOCKLEN = 8
-KP_KEYLEN = 9
-KP_SALT_EX = 10
-KP_P = 11
-KP_G = 12
-KP_Q = 13
-KP_X = 14
-KP_Y = 15
-KP_RA = 16
-KP_RB = 17
-KP_INFO = 18
-KP_EFFECTIVE_KEYLEN = 19
-KP_SCHANNEL_ALG = 20
-KP_CLIENT_RANDOM = 21
-KP_SERVER_RANDOM = 22
-KP_RP = 23
-KP_PRECOMP_MD5 = 24
-KP_PRECOMP_SHA = 25
-KP_CERTIFICATE = 26
-KP_CLEAR_KEY = 27
-KP_PUB_EX_LEN = 28
-KP_PUB_EX_VAL = 29
-KP_KEYVAL = 30
-KP_ADMIN_PIN = 31
-KP_KEYEXCHANGE_PIN = 32
-KP_SIGNATURE_PIN = 33
-KP_PREHASH = 34
-KP_ROUNDS = 35
-KP_OAEP_PARAMS = 36
-KP_CMS_KEY_INFO = 37
-KP_CMS_DH_KEY_INFO = 38
-KP_PUB_PARAMS = 39
-KP_VERIFY_PARAMS = 40
-KP_HIGHEST_VERSION = 41
-KP_GET_USE_COUNT = 42
-PKCS5_PADDING = 1
-RANDOM_PADDING = 2
-ZERO_PADDING = 3
-CRYPT_MODE_CBC = 1
-CRYPT_MODE_ECB = 2
-CRYPT_MODE_OFB = 3
-CRYPT_MODE_CFB = 4
-CRYPT_MODE_CTS = 5
-CRYPT_ENCRYPT = 0x0001
-CRYPT_DECRYPT = 0x0002
-CRYPT_EXPORT = 0x0004
-CRYPT_READ = 0x0008
-CRYPT_WRITE = 0x0010
-CRYPT_MAC = 0x0020
-CRYPT_EXPORT_KEY = 0x0040
-CRYPT_IMPORT_KEY = 0x0080
-CRYPT_ARCHIVE = 0x0100
-HP_ALGID = 0x0001
-HP_HASHVAL = 0x0002
-HP_HASHSIZE = 0x0004
-HP_HMAC_INFO = 0x0005
-HP_TLS1PRF_LABEL = 0x0006
-HP_TLS1PRF_SEED = 0x0007
-
-CRYPT_FAILED = 0
-CRYPT_SUCCEED = 1
-
-
-def RCRYPT_SUCCEEDED(rt):
-    return (rt) == CRYPT_SUCCEED
-
-
-def RCRYPT_FAILED(rt):
-    return (rt) == CRYPT_FAILED
-
-
-PP_ENUMALGS = 1
-PP_ENUMCONTAINERS = 2
-PP_IMPTYPE = 3
-PP_NAME = 4
-PP_VERSION = 5
-PP_CONTAINER = 6
-PP_CHANGE_PASSWORD = 7
-PP_KEYSET_SEC_DESCR = 8
-PP_CERTCHAIN = 9
-PP_KEY_TYPE_SUBTYPE = 10
-PP_PROVTYPE = 16
-PP_KEYSTORAGE = 17
-PP_APPLI_CERT = 18
-PP_SYM_KEYSIZE = 19
-PP_SESSION_KEYSIZE = 20
-PP_UI_PROMPT = 21
-PP_ENUMALGS_EX = 22
-PP_ENUMMANDROOTS = 25
-PP_ENUMELECTROOTS = 26
-PP_KEYSET_TYPE = 27
-PP_ADMIN_PIN = 31
-PP_KEYEXCHANGE_PIN = 32
-PP_SIGNATURE_PIN = 33
-PP_SIG_KEYSIZE_INC = 34
-PP_KEYX_KEYSIZE_INC = 35
-PP_UNIQUE_CONTAINER = 36
-PP_SGC_INFO = 37
-PP_USE_HARDWARE_RNG = 38
-PP_KEYSPEC = 39
-PP_ENUMEX_SIGNING_PROT = 40
-PP_CRYPT_COUNT_KEY_USE = 41
-CRYPT_FIRST = 1
-CRYPT_NEXT = 2
-CRYPT_SGC_ENUM = 4
-CRYPT_IMPL_HARDWARE = 1
-CRYPT_IMPL_SOFTWARE = 2
-CRYPT_IMPL_MIXED = 3
-CRYPT_IMPL_UNKNOWN = 4
-CRYPT_IMPL_REMOVABLE = 8
-CRYPT_SEC_DESCR = 0x00000001
-CRYPT_PSTORE = 0x00000002
-CRYPT_UI_PROMPT = 0x00000004
-CRYPT_FLAG_PCT1 = 0x0001
-CRYPT_FLAG_SSL2 = 0x0002
-CRYPT_FLAG_SSL3 = 0x0004
-CRYPT_FLAG_TLS1 = 0x0008
-CRYPT_FLAG_IPSEC = 0x0010
-CRYPT_FLAG_SIGNING = 0x0020
-CRYPT_SGC = 0x0001
-CRYPT_FASTSGC = 0x0002
-PP_CLIENT_HWND = 1
-PP_CONTEXT_INFO = 11
-PP_KEYEXCHANGE_KEYSIZE = 12
-PP_SIGNATURE_KEYSIZE = 13
-PP_KEYEXCHANGE_ALG = 14
-PP_SIGNATURE_ALG = 15
-PP_DELETEKEY = 24
-PROV_RSA_FULL = 1
-PROV_RSA_SIG = 2
-PROV_DSS = 3
-PROV_FORTEZZA = 4
-PROV_MS_EXCHANGE = 5
-PROV_SSL = 6
-PROV_RSA_SCHANNEL = 12
-PROV_DSS_DH = 13
-PROV_EC_ECDSA_SIG = 14
-PROV_EC_ECNRA_SIG = 15
-PROV_EC_ECDSA_FULL = 16
-PROV_EC_ECNRA_FULL = 17
-PROV_DH_SCHANNEL = 18
-PROV_SPYRUS_LYNKS = 20
-PROV_RNG = 21
-PROV_INTEL_SEC = 22
-PROV_REPLACE_OWF = 23
-PROV_RSA_AES = 24
-MS_DEF_PROV_A = "Microsoft Base Cryptographic Provider v1.0"
-MS_DEF_PROV = MS_DEF_PROV_A
-MS_ENHANCED_PROV_A = "Microsoft Enhanced Cryptographic Provider v1.0"
-MS_ENHANCED_PROV = MS_ENHANCED_PROV_A
-MS_STRONG_PROV_A = "Microsoft Strong Cryptographic Provider"
-MS_STRONG_PROV = MS_STRONG_PROV_A
-MS_DEF_RSA_SIG_PROV_A = "Microsoft RSA Signature Cryptographic Provider"
-MS_DEF_RSA_SIG_PROV = MS_DEF_RSA_SIG_PROV_A
-MS_DEF_RSA_SCHANNEL_PROV_A = "Microsoft RSA SChannel Cryptographic Provider"
-MS_DEF_RSA_SCHANNEL_PROV = MS_DEF_RSA_SCHANNEL_PROV_A
-MS_DEF_DSS_PROV_A = "Microsoft Base DSS Cryptographic Provider"
-MS_DEF_DSS_PROV = MS_DEF_DSS_PROV_A
-MS_DEF_DSS_DH_PROV_A = "Microsoft Base DSS and Diffie-Hellman Cryptographic Provider"
-MS_DEF_DSS_DH_PROV = MS_DEF_DSS_DH_PROV_A
-MS_ENH_DSS_DH_PROV_A = (
-    "Microsoft Enhanced DSS and Diffie-Hellman Cryptographic Provider"
-)
-MS_ENH_DSS_DH_PROV = MS_ENH_DSS_DH_PROV_A
-MS_DEF_DH_SCHANNEL_PROV_A = "Microsoft DH SChannel Cryptographic Provider"
-MS_DEF_DH_SCHANNEL_PROV = MS_DEF_DH_SCHANNEL_PROV_A
-MS_SCARD_PROV_A = "Microsoft Base Smart Card Crypto Provider"
-MS_SCARD_PROV = MS_SCARD_PROV_A
-MS_ENH_RSA_AES_PROV_A = "Microsoft Enhanced RSA and AES Cryptographic Provider"
-MS_ENH_RSA_AES_PROV = MS_ENH_RSA_AES_PROV_A
-MAXUIDLEN = 64
-EXPO_OFFLOAD_REG_VALUE = "ExpoOffload"
-EXPO_OFFLOAD_FUNC_NAME = "OffloadModExpo"
-szKEY_CRYPTOAPI_PRIVATE_KEY_OPTIONS = "Software\\Policies\\Microsoft\\Cryptography"
-szFORCE_KEY_PROTECTION = "ForceKeyProtection"
-dwFORCE_KEY_PROTECTION_DISABLED = 0x0
-dwFORCE_KEY_PROTECTION_USER_SELECT = 0x1
-dwFORCE_KEY_PROTECTION_HIGH = 0x2
-szKEY_CACHE_ENABLED = "CachePrivateKeys"
-szKEY_CACHE_SECONDS = "PrivateKeyLifetimeSeconds"
-CUR_BLOB_VERSION = 2
-SCHANNEL_MAC_KEY = 0x00000000
-SCHANNEL_ENC_KEY = 0x00000001
-INTERNATIONAL_USAGE = 0x00000001
-szOID_RSA = "1.2.840.113549"
-szOID_PKCS = "1.2.840.113549.1"
-szOID_RSA_HASH = "1.2.840.113549.2"
-szOID_RSA_ENCRYPT = "1.2.840.113549.3"
-szOID_PKCS_1 = "1.2.840.113549.1.1"
-szOID_PKCS_2 = "1.2.840.113549.1.2"
-szOID_PKCS_3 = "1.2.840.113549.1.3"
-szOID_PKCS_4 = "1.2.840.113549.1.4"
-szOID_PKCS_5 = "1.2.840.113549.1.5"
-szOID_PKCS_6 = "1.2.840.113549.1.6"
-szOID_PKCS_7 = "1.2.840.113549.1.7"
-szOID_PKCS_8 = "1.2.840.113549.1.8"
-szOID_PKCS_9 = "1.2.840.113549.1.9"
-szOID_PKCS_10 = "1.2.840.113549.1.10"
-szOID_PKCS_12 = "1.2.840.113549.1.12"
-szOID_RSA_RSA = "1.2.840.113549.1.1.1"
-szOID_RSA_MD2RSA = "1.2.840.113549.1.1.2"
-szOID_RSA_MD4RSA = "1.2.840.113549.1.1.3"
-szOID_RSA_MD5RSA = "1.2.840.113549.1.1.4"
-szOID_RSA_SHA1RSA = "1.2.840.113549.1.1.5"
-szOID_RSA_SETOAEP_RSA = "1.2.840.113549.1.1.6"
-szOID_RSA_DH = "1.2.840.113549.1.3.1"
-szOID_RSA_data = "1.2.840.113549.1.7.1"
-szOID_RSA_signedData = "1.2.840.113549.1.7.2"
-szOID_RSA_envelopedData = "1.2.840.113549.1.7.3"
-szOID_RSA_signEnvData = "1.2.840.113549.1.7.4"
-szOID_RSA_digestedData = "1.2.840.113549.1.7.5"
-szOID_RSA_hashedData = "1.2.840.113549.1.7.5"
-szOID_RSA_encryptedData = "1.2.840.113549.1.7.6"
-szOID_RSA_emailAddr = "1.2.840.113549.1.9.1"
-szOID_RSA_unstructName = "1.2.840.113549.1.9.2"
-szOID_RSA_contentType = "1.2.840.113549.1.9.3"
-szOID_RSA_messageDigest = "1.2.840.113549.1.9.4"
-szOID_RSA_signingTime = "1.2.840.113549.1.9.5"
-szOID_RSA_counterSign = "1.2.840.113549.1.9.6"
-szOID_RSA_challengePwd = "1.2.840.113549.1.9.7"
-szOID_RSA_unstructAddr = "1.2.840.113549.1.9.8"
-szOID_RSA_extCertAttrs = "1.2.840.113549.1.9.9"
-szOID_RSA_certExtensions = "1.2.840.113549.1.9.14"
-szOID_RSA_SMIMECapabilities = "1.2.840.113549.1.9.15"
-szOID_RSA_preferSignedData = "1.2.840.113549.1.9.15.1"
-szOID_RSA_SMIMEalg = "1.2.840.113549.1.9.16.3"
-szOID_RSA_SMIMEalgESDH = "1.2.840.113549.1.9.16.3.5"
-szOID_RSA_SMIMEalgCMS3DESwrap = "1.2.840.113549.1.9.16.3.6"
-szOID_RSA_SMIMEalgCMSRC2wrap = "1.2.840.113549.1.9.16.3.7"
-szOID_RSA_MD2 = "1.2.840.113549.2.2"
-szOID_RSA_MD4 = "1.2.840.113549.2.4"
-szOID_RSA_MD5 = "1.2.840.113549.2.5"
-szOID_RSA_RC2CBC = "1.2.840.113549.3.2"
-szOID_RSA_RC4 = "1.2.840.113549.3.4"
-szOID_RSA_DES_EDE3_CBC = "1.2.840.113549.3.7"
-szOID_RSA_RC5_CBCPad = "1.2.840.113549.3.9"
-szOID_ANSI_X942 = "1.2.840.10046"
-szOID_ANSI_X942_DH = "1.2.840.10046.2.1"
-szOID_X957 = "1.2.840.10040"
-szOID_X957_DSA = "1.2.840.10040.4.1"
-szOID_X957_SHA1DSA = "1.2.840.10040.4.3"
-szOID_DS = "2.5"
-szOID_DSALG = "2.5.8"
-szOID_DSALG_CRPT = "2.5.8.1"
-szOID_DSALG_HASH = "2.5.8.2"
-szOID_DSALG_SIGN = "2.5.8.3"
-szOID_DSALG_RSA = "2.5.8.1.1"
-szOID_OIW = "1.3.14"
-szOID_OIWSEC = "1.3.14.3.2"
-szOID_OIWSEC_md4RSA = "1.3.14.3.2.2"
-szOID_OIWSEC_md5RSA = "1.3.14.3.2.3"
-szOID_OIWSEC_md4RSA2 = "1.3.14.3.2.4"
-szOID_OIWSEC_desECB = "1.3.14.3.2.6"
-szOID_OIWSEC_desCBC = "1.3.14.3.2.7"
-szOID_OIWSEC_desOFB = "1.3.14.3.2.8"
-szOID_OIWSEC_desCFB = "1.3.14.3.2.9"
-szOID_OIWSEC_desMAC = "1.3.14.3.2.10"
-szOID_OIWSEC_rsaSign = "1.3.14.3.2.11"
-szOID_OIWSEC_dsa = "1.3.14.3.2.12"
-szOID_OIWSEC_shaDSA = "1.3.14.3.2.13"
-szOID_OIWSEC_mdc2RSA = "1.3.14.3.2.14"
-szOID_OIWSEC_shaRSA = "1.3.14.3.2.15"
-szOID_OIWSEC_dhCommMod = "1.3.14.3.2.16"
-szOID_OIWSEC_desEDE = "1.3.14.3.2.17"
-szOID_OIWSEC_sha = "1.3.14.3.2.18"
-szOID_OIWSEC_mdc2 = "1.3.14.3.2.19"
-szOID_OIWSEC_dsaComm = "1.3.14.3.2.20"
-szOID_OIWSEC_dsaCommSHA = "1.3.14.3.2.21"
-szOID_OIWSEC_rsaXchg = "1.3.14.3.2.22"
-szOID_OIWSEC_keyHashSeal = "1.3.14.3.2.23"
-szOID_OIWSEC_md2RSASign = "1.3.14.3.2.24"
-szOID_OIWSEC_md5RSASign = "1.3.14.3.2.25"
-szOID_OIWSEC_sha1 = "1.3.14.3.2.26"
-szOID_OIWSEC_dsaSHA1 = "1.3.14.3.2.27"
-szOID_OIWSEC_dsaCommSHA1 = "1.3.14.3.2.28"
-szOID_OIWSEC_sha1RSASign = "1.3.14.3.2.29"
-szOID_OIWDIR = "1.3.14.7.2"
-szOID_OIWDIR_CRPT = "1.3.14.7.2.1"
-szOID_OIWDIR_HASH = "1.3.14.7.2.2"
-szOID_OIWDIR_SIGN = "1.3.14.7.2.3"
-szOID_OIWDIR_md2 = "1.3.14.7.2.2.1"
-szOID_OIWDIR_md2RSA = "1.3.14.7.2.3.1"
-szOID_INFOSEC = "2.16.840.1.101.2.1"
-szOID_INFOSEC_sdnsSignature = "2.16.840.1.101.2.1.1.1"
-szOID_INFOSEC_mosaicSignature = "2.16.840.1.101.2.1.1.2"
-szOID_INFOSEC_sdnsConfidentiality = "2.16.840.1.101.2.1.1.3"
-szOID_INFOSEC_mosaicConfidentiality = "2.16.840.1.101.2.1.1.4"
-szOID_INFOSEC_sdnsIntegrity = "2.16.840.1.101.2.1.1.5"
-szOID_INFOSEC_mosaicIntegrity = "2.16.840.1.101.2.1.1.6"
-szOID_INFOSEC_sdnsTokenProtection = "2.16.840.1.101.2.1.1.7"
-szOID_INFOSEC_mosaicTokenProtection = "2.16.840.1.101.2.1.1.8"
-szOID_INFOSEC_sdnsKeyManagement = "2.16.840.1.101.2.1.1.9"
-szOID_INFOSEC_mosaicKeyManagement = "2.16.840.1.101.2.1.1.10"
-szOID_INFOSEC_sdnsKMandSig = "2.16.840.1.101.2.1.1.11"
-szOID_INFOSEC_mosaicKMandSig = "2.16.840.1.101.2.1.1.12"
-szOID_INFOSEC_SuiteASignature = "2.16.840.1.101.2.1.1.13"
-szOID_INFOSEC_SuiteAConfidentiality = "2.16.840.1.101.2.1.1.14"
-szOID_INFOSEC_SuiteAIntegrity = "2.16.840.1.101.2.1.1.15"
-szOID_INFOSEC_SuiteATokenProtection = "2.16.840.1.101.2.1.1.16"
-szOID_INFOSEC_SuiteAKeyManagement = "2.16.840.1.101.2.1.1.17"
-szOID_INFOSEC_SuiteAKMandSig = "2.16.840.1.101.2.1.1.18"
-szOID_INFOSEC_mosaicUpdatedSig = "2.16.840.1.101.2.1.1.19"
-szOID_INFOSEC_mosaicKMandUpdSig = "2.16.840.1.101.2.1.1.20"
-szOID_INFOSEC_mosaicUpdatedInteg = "2.16.840.1.101.2.1.1.21"
-szOID_COMMON_NAME = "2.5.4.3"
-szOID_SUR_NAME = "2.5.4.4"
-szOID_DEVICE_SERIAL_NUMBER = "2.5.4.5"
-szOID_COUNTRY_NAME = "2.5.4.6"
-szOID_LOCALITY_NAME = "2.5.4.7"
-szOID_STATE_OR_PROVINCE_NAME = "2.5.4.8"
-szOID_STREET_ADDRESS = "2.5.4.9"
-szOID_ORGANIZATION_NAME = "2.5.4.10"
-szOID_ORGANIZATIONAL_UNIT_NAME = "2.5.4.11"
-szOID_TITLE = "2.5.4.12"
-szOID_DESCRIPTION = "2.5.4.13"
-szOID_SEARCH_GUIDE = "2.5.4.14"
-szOID_BUSINESS_CATEGORY = "2.5.4.15"
-szOID_POSTAL_ADDRESS = "2.5.4.16"
-szOID_POSTAL_CODE = "2.5.4.17"
-szOID_POST_OFFICE_BOX = "2.5.4.18"
-szOID_PHYSICAL_DELIVERY_OFFICE_NAME = "2.5.4.19"
-szOID_TELEPHONE_NUMBER = "2.5.4.20"
-szOID_TELEX_NUMBER = "2.5.4.21"
-szOID_TELETEXT_TERMINAL_IDENTIFIER = "2.5.4.22"
-szOID_FACSIMILE_TELEPHONE_NUMBER = "2.5.4.23"
-szOID_X21_ADDRESS = "2.5.4.24"
-szOID_INTERNATIONAL_ISDN_NUMBER = "2.5.4.25"
-szOID_REGISTERED_ADDRESS = "2.5.4.26"
-szOID_DESTINATION_INDICATOR = "2.5.4.27"
-szOID_PREFERRED_DELIVERY_METHOD = "2.5.4.28"
-szOID_PRESENTATION_ADDRESS = "2.5.4.29"
-szOID_SUPPORTED_APPLICATION_CONTEXT = "2.5.4.30"
-szOID_MEMBER = "2.5.4.31"
-szOID_OWNER = "2.5.4.32"
-szOID_ROLE_OCCUPANT = "2.5.4.33"
-szOID_SEE_ALSO = "2.5.4.34"
-szOID_USER_PASSWORD = "2.5.4.35"
-szOID_USER_CERTIFICATE = "2.5.4.36"
-szOID_CA_CERTIFICATE = "2.5.4.37"
-szOID_AUTHORITY_REVOCATION_LIST = "2.5.4.38"
-szOID_CERTIFICATE_REVOCATION_LIST = "2.5.4.39"
-szOID_CROSS_CERTIFICATE_PAIR = "2.5.4.40"
-szOID_GIVEN_NAME = "2.5.4.42"
-szOID_INITIALS = "2.5.4.43"
-szOID_DN_QUALIFIER = "2.5.4.46"
-szOID_DOMAIN_COMPONENT = "0.9.2342.19200300.100.1.25"
-szOID_PKCS_12_FRIENDLY_NAME_ATTR = "1.2.840.113549.1.9.20"
-szOID_PKCS_12_LOCAL_KEY_ID = "1.2.840.113549.1.9.21"
-szOID_PKCS_12_KEY_PROVIDER_NAME_ATTR = "1.3.6.1.4.1.311.17.1"
-szOID_LOCAL_MACHINE_KEYSET = "1.3.6.1.4.1.311.17.2"
-szOID_KEYID_RDN = "1.3.6.1.4.1.311.10.7.1"
-CERT_RDN_ANY_TYPE = 0
-CERT_RDN_ENCODED_BLOB = 1
-CERT_RDN_OCTET_STRING = 2
-CERT_RDN_NUMERIC_STRING = 3
-CERT_RDN_PRINTABLE_STRING = 4
-CERT_RDN_TELETEX_STRING = 5
-CERT_RDN_T61_STRING = 5
-CERT_RDN_VIDEOTEX_STRING = 6
-CERT_RDN_IA5_STRING = 7
-CERT_RDN_GRAPHIC_STRING = 8
-CERT_RDN_VISIBLE_STRING = 9
-CERT_RDN_ISO646_STRING = 9
-CERT_RDN_GENERAL_STRING = 10
-CERT_RDN_UNIVERSAL_STRING = 11
-CERT_RDN_INT4_STRING = 11
-CERT_RDN_BMP_STRING = 12
-CERT_RDN_UNICODE_STRING = 12
-CERT_RDN_UTF8_STRING = 13
-CERT_RDN_TYPE_MASK = 0x000000FF
-CERT_RDN_FLAGS_MASK = -16777216
-CERT_RDN_ENABLE_T61_UNICODE_FLAG = -2147483648
-CERT_RDN_ENABLE_UTF8_UNICODE_FLAG = 0x20000000
-CERT_RDN_DISABLE_CHECK_TYPE_FLAG = 0x40000000
-CERT_RDN_DISABLE_IE4_UTF8_FLAG = 0x01000000
-CERT_RSA_PUBLIC_KEY_OBJID = szOID_RSA_RSA
-CERT_DEFAULT_OID_PUBLIC_KEY_SIGN = szOID_RSA_RSA
-CERT_DEFAULT_OID_PUBLIC_KEY_XCHG = szOID_RSA_RSA
-CERT_V1 = 0
-CERT_V2 = 1
-CERT_V3 = 2
-CERT_INFO_VERSION_FLAG = 1
-CERT_INFO_SERIAL_NUMBER_FLAG = 2
-CERT_INFO_SIGNATURE_ALGORITHM_FLAG = 3
-CERT_INFO_ISSUER_FLAG = 4
-CERT_INFO_NOT_BEFORE_FLAG = 5
-CERT_INFO_NOT_AFTER_FLAG = 6
-CERT_INFO_SUBJECT_FLAG = 7
-CERT_INFO_SUBJECT_PUBLIC_KEY_INFO_FLAG = 8
-CERT_INFO_ISSUER_UNIQUE_ID_FLAG = 9
-CERT_INFO_SUBJECT_UNIQUE_ID_FLAG = 10
-CERT_INFO_EXTENSION_FLAG = 11
-CRL_V1 = 0
-CRL_V2 = 1
-CERT_REQUEST_V1 = 0
-CERT_KEYGEN_REQUEST_V1 = 0
-CTL_V1 = 0
-CERT_ENCODING_TYPE_MASK = 0x0000FFFF
-CMSG_ENCODING_TYPE_MASK = -65536
-
-
-def GET_CERT_ENCODING_TYPE(X):
-    return X & CERT_ENCODING_TYPE_MASK
-
-
-def GET_CMSG_ENCODING_TYPE(X):
-    return X & CMSG_ENCODING_TYPE_MASK
-
-
-CRYPT_ASN_ENCODING = 0x00000001
-CRYPT_NDR_ENCODING = 0x00000002
-X509_ASN_ENCODING = 0x00000001
-X509_NDR_ENCODING = 0x00000002
-PKCS_7_ASN_ENCODING = 0x00010000
-PKCS_7_NDR_ENCODING = 0x00020000
-CRYPT_FORMAT_STR_MULTI_LINE = 0x0001
-CRYPT_FORMAT_STR_NO_HEX = 0x0010
-CRYPT_FORMAT_SIMPLE = 0x0001
-CRYPT_FORMAT_X509 = 0x0002
-CRYPT_FORMAT_OID = 0x0004
-CRYPT_FORMAT_RDN_SEMICOLON = 0x0100
-CRYPT_FORMAT_RDN_CRLF = 0x0200
-CRYPT_FORMAT_RDN_UNQUOTE = 0x0400
-CRYPT_FORMAT_RDN_REVERSE = 0x0800
-CRYPT_FORMAT_COMMA = 0x1000
-CRYPT_FORMAT_SEMICOLON = CRYPT_FORMAT_RDN_SEMICOLON
-CRYPT_FORMAT_CRLF = CRYPT_FORMAT_RDN_CRLF
-CRYPT_ENCODE_NO_SIGNATURE_BYTE_REVERSAL_FLAG = 0x8
-CRYPT_ENCODE_ALLOC_FLAG = 0x8000
-CRYPT_UNICODE_NAME_ENCODE_ENABLE_T61_UNICODE_FLAG = CERT_RDN_ENABLE_T61_UNICODE_FLAG
-CRYPT_UNICODE_NAME_ENCODE_ENABLE_UTF8_UNICODE_FLAG = CERT_RDN_ENABLE_UTF8_UNICODE_FLAG
-CRYPT_UNICODE_NAME_ENCODE_DISABLE_CHECK_TYPE_FLAG = CERT_RDN_DISABLE_CHECK_TYPE_FLAG
-CRYPT_SORTED_CTL_ENCODE_HASHED_SUBJECT_IDENTIFIER_FLAG = 0x10000
-CRYPT_DECODE_NOCOPY_FLAG = 0x1
-CRYPT_DECODE_TO_BE_SIGNED_FLAG = 0x2
-CRYPT_DECODE_SHARE_OID_STRING_FLAG = 0x4
-CRYPT_DECODE_NO_SIGNATURE_BYTE_REVERSAL_FLAG = 0x8
-CRYPT_DECODE_ALLOC_FLAG = 0x8000
-CRYPT_UNICODE_NAME_DECODE_DISABLE_IE4_UTF8_FLAG = CERT_RDN_DISABLE_IE4_UTF8_FLAG
-
-CRYPT_ENCODE_DECODE_NONE = 0
-X509_CERT = 1
-X509_CERT_TO_BE_SIGNED = 2
-X509_CERT_CRL_TO_BE_SIGNED = 3
-X509_CERT_REQUEST_TO_BE_SIGNED = 4
-X509_EXTENSIONS = 5
-X509_NAME_VALUE = 6
-X509_NAME = 7
-X509_PUBLIC_KEY_INFO = 8
-X509_AUTHORITY_KEY_ID = 9
-X509_KEY_ATTRIBUTES = 10
-X509_KEY_USAGE_RESTRICTION = 11
-X509_ALTERNATE_NAME = 12
-X509_BASIC_CONSTRAINTS = 13
-X509_KEY_USAGE = 14
-X509_BASIC_CONSTRAINTS2 = 15
-X509_CERT_POLICIES = 16
-PKCS_UTC_TIME = 17
-PKCS_TIME_REQUEST = 18
-RSA_CSP_PUBLICKEYBLOB = 19
-X509_UNICODE_NAME = 20
-X509_KEYGEN_REQUEST_TO_BE_SIGNED = 21
-PKCS_ATTRIBUTE = 22
-PKCS_CONTENT_INFO_SEQUENCE_OF_ANY = 23
-X509_UNICODE_NAME_VALUE = 24
-X509_ANY_STRING = X509_NAME_VALUE
-X509_UNICODE_ANY_STRING = X509_UNICODE_NAME_VALUE
-X509_OCTET_STRING = 25
-X509_BITS = 26
-X509_INTEGER = 27
-X509_MULTI_BYTE_INTEGER = 28
-X509_ENUMERATED = 29
-X509_CHOICE_OF_TIME = 30
-X509_AUTHORITY_KEY_ID2 = 31
-X509_AUTHORITY_INFO_ACCESS = 32
-X509_SUBJECT_INFO_ACCESS = X509_AUTHORITY_INFO_ACCESS
-X509_CRL_REASON_CODE = X509_ENUMERATED
-PKCS_CONTENT_INFO = 33
-X509_SEQUENCE_OF_ANY = 34
-X509_CRL_DIST_POINTS = 35
-X509_ENHANCED_KEY_USAGE = 36
-PKCS_CTL = 37
-X509_MULTI_BYTE_UINT = 38
-X509_DSS_PUBLICKEY = X509_MULTI_BYTE_UINT
-X509_DSS_PARAMETERS = 39
-X509_DSS_SIGNATURE = 40
-PKCS_RC2_CBC_PARAMETERS = 41
-PKCS_SMIME_CAPABILITIES = 42
-X509_QC_STATEMENTS_EXT = 42
-PKCS_RSA_PRIVATE_KEY = 43
-PKCS_PRIVATE_KEY_INFO = 44
-PKCS_ENCRYPTED_PRIVATE_KEY_INFO = 45
-X509_PKIX_POLICY_QUALIFIER_USERNOTICE = 46
-X509_DH_PUBLICKEY = X509_MULTI_BYTE_UINT
-X509_DH_PARAMETERS = 47
-PKCS_ATTRIBUTES = 48
-PKCS_SORTED_CTL = 49
-X509_ECC_SIGNATURE = 47
-X942_DH_PARAMETERS = 50
-X509_BITS_WITHOUT_TRAILING_ZEROES = 51
-X942_OTHER_INFO = 52
-X509_CERT_PAIR = 53
-X509_ISSUING_DIST_POINT = 54
-X509_NAME_CONSTRAINTS = 55
-X509_POLICY_MAPPINGS = 56
-X509_POLICY_CONSTRAINTS = 57
-X509_CROSS_CERT_DIST_POINTS = 58
-CMC_DATA = 59
-CMC_RESPONSE = 60
-CMC_STATUS = 61
-CMC_ADD_EXTENSIONS = 62
-CMC_ADD_ATTRIBUTES = 63
-X509_CERTIFICATE_TEMPLATE = 64
-OCSP_SIGNED_REQUEST = 65
-OCSP_REQUEST = 66
-OCSP_RESPONSE = 67
-OCSP_BASIC_SIGNED_RESPONSE = 68
-OCSP_BASIC_RESPONSE = 69
-X509_LOGOTYPE_EXT = 70
-X509_BIOMETRIC_EXT = 71
-CNG_RSA_PUBLIC_KEY_BLOB = 72
-X509_OBJECT_IDENTIFIER = 73
-X509_ALGORITHM_IDENTIFIER = 74
-PKCS_RSA_SSA_PSS_PARAMETERS = 75
-PKCS_RSAES_OAEP_PARAMETERS = 76
-ECC_CMS_SHARED_INFO = 77
-TIMESTAMP_REQUEST = 78
-TIMESTAMP_RESPONSE = 79
-TIMESTAMP_INFO = 80
-X509_CERT_BUNDLE = 81
-PKCS7_SIGNER_INFO = 500
-CMS_SIGNER_INFO = 501
-
-szOID_AUTHORITY_KEY_IDENTIFIER = "2.5.29.1"
-szOID_KEY_ATTRIBUTES = "2.5.29.2"
-szOID_CERT_POLICIES_95 = "2.5.29.3"
-szOID_KEY_USAGE_RESTRICTION = "2.5.29.4"
-szOID_SUBJECT_ALT_NAME = "2.5.29.7"
-szOID_ISSUER_ALT_NAME = "2.5.29.8"
-szOID_BASIC_CONSTRAINTS = "2.5.29.10"
-szOID_KEY_USAGE = "2.5.29.15"
-szOID_PRIVATEKEY_USAGE_PERIOD = "2.5.29.16"
-szOID_BASIC_CONSTRAINTS2 = "2.5.29.19"
-szOID_CERT_POLICIES = "2.5.29.32"
-szOID_ANY_CERT_POLICY = "2.5.29.32.0"
-szOID_AUTHORITY_KEY_IDENTIFIER2 = "2.5.29.35"
-szOID_SUBJECT_KEY_IDENTIFIER = "2.5.29.14"
-szOID_SUBJECT_ALT_NAME2 = "2.5.29.17"
-szOID_ISSUER_ALT_NAME2 = "2.5.29.18"
-szOID_CRL_REASON_CODE = "2.5.29.21"
-szOID_REASON_CODE_HOLD = "2.5.29.23"
-szOID_CRL_DIST_POINTS = "2.5.29.31"
-szOID_ENHANCED_KEY_USAGE = "2.5.29.37"
-szOID_CRL_NUMBER = "2.5.29.20"
-szOID_DELTA_CRL_INDICATOR = "2.5.29.27"
-szOID_ISSUING_DIST_POINT = "2.5.29.28"
-szOID_FRESHEST_CRL = "2.5.29.46"
-szOID_NAME_CONSTRAINTS = "2.5.29.30"
-szOID_POLICY_MAPPINGS = "2.5.29.33"
-szOID_LEGACY_POLICY_MAPPINGS = "2.5.29.5"
-szOID_POLICY_CONSTRAINTS = "2.5.29.36"
-szOID_RENEWAL_CERTIFICATE = "1.3.6.1.4.1.311.13.1"
-szOID_ENROLLMENT_NAME_VALUE_PAIR = "1.3.6.1.4.1.311.13.2.1"
-szOID_ENROLLMENT_CSP_PROVIDER = "1.3.6.1.4.1.311.13.2.2"
-szOID_OS_VERSION = "1.3.6.1.4.1.311.13.2.3"
-szOID_ENROLLMENT_AGENT = "1.3.6.1.4.1.311.20.2.1"
-szOID_PKIX = "1.3.6.1.5.5.7"
-szOID_PKIX_PE = "1.3.6.1.5.5.7.1"
-szOID_AUTHORITY_INFO_ACCESS = "1.3.6.1.5.5.7.1.1"
-szOID_CERT_EXTENSIONS = "1.3.6.1.4.1.311.2.1.14"
-szOID_NEXT_UPDATE_LOCATION = "1.3.6.1.4.1.311.10.2"
-szOID_REMOVE_CERTIFICATE = "1.3.6.1.4.1.311.10.8.1"
-szOID_CROSS_CERT_DIST_POINTS = "1.3.6.1.4.1.311.10.9.1"
-szOID_CTL = "1.3.6.1.4.1.311.10.1"
-szOID_SORTED_CTL = "1.3.6.1.4.1.311.10.1.1"
-szOID_SERIALIZED = "1.3.6.1.4.1.311.10.3.3.1"
-szOID_NT_PRINCIPAL_NAME = "1.3.6.1.4.1.311.20.2.3"
-szOID_PRODUCT_UPDATE = "1.3.6.1.4.1.311.31.1"
-szOID_ANY_APPLICATION_POLICY = "1.3.6.1.4.1.311.10.12.1"
-szOID_AUTO_ENROLL_CTL_USAGE = "1.3.6.1.4.1.311.20.1"
-szOID_ENROLL_CERTTYPE_EXTENSION = "1.3.6.1.4.1.311.20.2"
-szOID_CERT_MANIFOLD = "1.3.6.1.4.1.311.20.3"
-szOID_CERTSRV_CA_VERSION = "1.3.6.1.4.1.311.21.1"
-szOID_CERTSRV_PREVIOUS_CERT_HASH = "1.3.6.1.4.1.311.21.2"
-szOID_CRL_VIRTUAL_BASE = "1.3.6.1.4.1.311.21.3"
-szOID_CRL_NEXT_PUBLISH = "1.3.6.1.4.1.311.21.4"
-szOID_KP_CA_EXCHANGE = "1.3.6.1.4.1.311.21.5"
-szOID_KP_KEY_RECOVERY_AGENT = "1.3.6.1.4.1.311.21.6"
-szOID_CERTIFICATE_TEMPLATE = "1.3.6.1.4.1.311.21.7"
-szOID_ENTERPRISE_OID_ROOT = "1.3.6.1.4.1.311.21.8"
-szOID_RDN_DUMMY_SIGNER = "1.3.6.1.4.1.311.21.9"
-szOID_APPLICATION_CERT_POLICIES = "1.3.6.1.4.1.311.21.10"
-szOID_APPLICATION_POLICY_MAPPINGS = "1.3.6.1.4.1.311.21.11"
-szOID_APPLICATION_POLICY_CONSTRAINTS = "1.3.6.1.4.1.311.21.12"
-szOID_ARCHIVED_KEY_ATTR = "1.3.6.1.4.1.311.21.13"
-szOID_CRL_SELF_CDP = "1.3.6.1.4.1.311.21.14"
-szOID_REQUIRE_CERT_CHAIN_POLICY = "1.3.6.1.4.1.311.21.15"
-szOID_ARCHIVED_KEY_CERT_HASH = "1.3.6.1.4.1.311.21.16"
-szOID_ISSUED_CERT_HASH = "1.3.6.1.4.1.311.21.17"
-szOID_DS_EMAIL_REPLICATION = "1.3.6.1.4.1.311.21.19"
-szOID_REQUEST_CLIENT_INFO = "1.3.6.1.4.1.311.21.20"
-szOID_ENCRYPTED_KEY_HASH = "1.3.6.1.4.1.311.21.21"
-szOID_CERTSRV_CROSSCA_VERSION = "1.3.6.1.4.1.311.21.22"
-szOID_NTDS_REPLICATION = "1.3.6.1.4.1.311.25.1"
-szOID_SUBJECT_DIR_ATTRS = "2.5.29.9"
-szOID_PKIX_KP = "1.3.6.1.5.5.7.3"
-szOID_PKIX_KP_SERVER_AUTH = "1.3.6.1.5.5.7.3.1"
-szOID_PKIX_KP_CLIENT_AUTH = "1.3.6.1.5.5.7.3.2"
-szOID_PKIX_KP_CODE_SIGNING = "1.3.6.1.5.5.7.3.3"
-szOID_PKIX_KP_EMAIL_PROTECTION = "1.3.6.1.5.5.7.3.4"
-szOID_PKIX_KP_IPSEC_END_SYSTEM = "1.3.6.1.5.5.7.3.5"
-szOID_PKIX_KP_IPSEC_TUNNEL = "1.3.6.1.5.5.7.3.6"
-szOID_PKIX_KP_IPSEC_USER = "1.3.6.1.5.5.7.3.7"
-szOID_PKIX_KP_TIMESTAMP_SIGNING = "1.3.6.1.5.5.7.3.8"
-szOID_IPSEC_KP_IKE_INTERMEDIATE = "1.3.6.1.5.5.8.2.2"
-szOID_KP_CTL_USAGE_SIGNING = "1.3.6.1.4.1.311.10.3.1"
-szOID_KP_TIME_STAMP_SIGNING = "1.3.6.1.4.1.311.10.3.2"
-szOID_SERVER_GATED_CRYPTO = "1.3.6.1.4.1.311.10.3.3"
-szOID_SGC_NETSCAPE = "2.16.840.1.113730.4.1"
-szOID_KP_EFS = "1.3.6.1.4.1.311.10.3.4"
-szOID_EFS_RECOVERY = "1.3.6.1.4.1.311.10.3.4.1"
-szOID_WHQL_CRYPTO = "1.3.6.1.4.1.311.10.3.5"
-szOID_NT5_CRYPTO = "1.3.6.1.4.1.311.10.3.6"
-szOID_OEM_WHQL_CRYPTO = "1.3.6.1.4.1.311.10.3.7"
-szOID_EMBEDDED_NT_CRYPTO = "1.3.6.1.4.1.311.10.3.8"
-szOID_ROOT_LIST_SIGNER = "1.3.6.1.4.1.311.10.3.9"
-szOID_KP_QUALIFIED_SUBORDINATION = "1.3.6.1.4.1.311.10.3.10"
-szOID_KP_KEY_RECOVERY = "1.3.6.1.4.1.311.10.3.11"
-szOID_KP_DOCUMENT_SIGNING = "1.3.6.1.4.1.311.10.3.12"
-szOID_KP_LIFETIME_SIGNING = "1.3.6.1.4.1.311.10.3.13"
-szOID_KP_MOBILE_DEVICE_SOFTWARE = "1.3.6.1.4.1.311.10.3.14"
-szOID_DRM = "1.3.6.1.4.1.311.10.5.1"
-szOID_DRM_INDIVIDUALIZATION = "1.3.6.1.4.1.311.10.5.2"
-szOID_LICENSES = "1.3.6.1.4.1.311.10.6.1"
-szOID_LICENSE_SERVER = "1.3.6.1.4.1.311.10.6.2"
-szOID_KP_SMARTCARD_LOGON = "1.3.6.1.4.1.311.20.2.2"
-szOID_YESNO_TRUST_ATTR = "1.3.6.1.4.1.311.10.4.1"
-szOID_PKIX_POLICY_QUALIFIER_CPS = "1.3.6.1.5.5.7.2.1"
-szOID_PKIX_POLICY_QUALIFIER_USERNOTICE = "1.3.6.1.5.5.7.2.2"
-szOID_CERT_POLICIES_95_QUALIFIER1 = "2.16.840.1.113733.1.7.1.1"
-CERT_UNICODE_RDN_ERR_INDEX_MASK = 0x3FF
-CERT_UNICODE_RDN_ERR_INDEX_SHIFT = 22
-CERT_UNICODE_ATTR_ERR_INDEX_MASK = 0x003F
-CERT_UNICODE_ATTR_ERR_INDEX_SHIFT = 16
-CERT_UNICODE_VALUE_ERR_INDEX_MASK = 0x0000FFFF
-CERT_UNICODE_VALUE_ERR_INDEX_SHIFT = 0
-CERT_DIGITAL_SIGNATURE_KEY_USAGE = 0x80
-CERT_NON_REPUDIATION_KEY_USAGE = 0x40
-CERT_KEY_ENCIPHERMENT_KEY_USAGE = 0x20
-CERT_DATA_ENCIPHERMENT_KEY_USAGE = 0x10
-CERT_KEY_AGREEMENT_KEY_USAGE = 0x08
-CERT_KEY_CERT_SIGN_KEY_USAGE = 0x04
-CERT_OFFLINE_CRL_SIGN_KEY_USAGE = 0x02
-CERT_CRL_SIGN_KEY_USAGE = 0x02
-CERT_ENCIPHER_ONLY_KEY_USAGE = 0x01
-CERT_DECIPHER_ONLY_KEY_USAGE = 0x80
-CERT_ALT_NAME_OTHER_NAME = 1
-CERT_ALT_NAME_RFC822_NAME = 2
-CERT_ALT_NAME_DNS_NAME = 3
-CERT_ALT_NAME_X400_ADDRESS = 4
-CERT_ALT_NAME_DIRECTORY_NAME = 5
-CERT_ALT_NAME_EDI_PARTY_NAME = 6
-CERT_ALT_NAME_URL = 7
-CERT_ALT_NAME_IP_ADDRESS = 8
-CERT_ALT_NAME_REGISTERED_ID = 9
-CERT_ALT_NAME_ENTRY_ERR_INDEX_MASK = 0xFF
-CERT_ALT_NAME_ENTRY_ERR_INDEX_SHIFT = 16
-CERT_ALT_NAME_VALUE_ERR_INDEX_MASK = 0x0000FFFF
-CERT_ALT_NAME_VALUE_ERR_INDEX_SHIFT = 0
-CERT_CA_SUBJECT_FLAG = 0x80
-CERT_END_ENTITY_SUBJECT_FLAG = 0x40
-szOID_PKIX_ACC_DESCR = "1.3.6.1.5.5.7.48"
-szOID_PKIX_OCSP = "1.3.6.1.5.5.7.48.1"
-szOID_PKIX_CA_ISSUERS = "1.3.6.1.5.5.7.48.2"
-CRL_REASON_UNSPECIFIED = 0
-CRL_REASON_KEY_COMPROMISE = 1
-CRL_REASON_CA_COMPROMISE = 2
-CRL_REASON_AFFILIATION_CHANGED = 3
-CRL_REASON_SUPERSEDED = 4
-CRL_REASON_CESSATION_OF_OPERATION = 5
-CRL_REASON_CERTIFICATE_HOLD = 6
-CRL_REASON_REMOVE_FROM_CRL = 8
-CRL_DIST_POINT_NO_NAME = 0
-CRL_DIST_POINT_FULL_NAME = 1
-CRL_DIST_POINT_ISSUER_RDN_NAME = 2
-CRL_REASON_UNUSED_FLAG = 0x80
-CRL_REASON_KEY_COMPROMISE_FLAG = 0x40
-CRL_REASON_CA_COMPROMISE_FLAG = 0x20
-CRL_REASON_AFFILIATION_CHANGED_FLAG = 0x10
-CRL_REASON_SUPERSEDED_FLAG = 0x08
-CRL_REASON_CESSATION_OF_OPERATION_FLAG = 0x04
-CRL_REASON_CERTIFICATE_HOLD_FLAG = 0x02
-CRL_DIST_POINT_ERR_INDEX_MASK = 0x7F
-CRL_DIST_POINT_ERR_INDEX_SHIFT = 24
-
-CRL_DIST_POINT_ERR_CRL_ISSUER_BIT = -2147483648
-
-CROSS_CERT_DIST_POINT_ERR_INDEX_MASK = 0xFF
-CROSS_CERT_DIST_POINT_ERR_INDEX_SHIFT = 24
-
-CERT_EXCLUDED_SUBTREE_BIT = -2147483648
-
-SORTED_CTL_EXT_FLAGS_OFFSET = 0 * 4
-SORTED_CTL_EXT_COUNT_OFFSET = 1 * 4
-SORTED_CTL_EXT_MAX_COLLISION_OFFSET = 2 * 4
-SORTED_CTL_EXT_HASH_BUCKET_OFFSET = 3 * 4
-SORTED_CTL_EXT_HASHED_SUBJECT_IDENTIFIER_FLAG = 0x1
-CERT_DSS_R_LEN = 20
-CERT_DSS_S_LEN = 20
-CERT_DSS_SIGNATURE_LEN = CERT_DSS_R_LEN + CERT_DSS_S_LEN
-CERT_MAX_ASN_ENCODED_DSS_SIGNATURE_LEN = 2 + 2 * (2 + 20 + 1)
-CRYPT_X942_COUNTER_BYTE_LENGTH = 4
-CRYPT_X942_KEY_LENGTH_BYTE_LENGTH = 4
-CRYPT_X942_PUB_INFO_BYTE_LENGTH = 512 / 8
-CRYPT_RC2_40BIT_VERSION = 160
-CRYPT_RC2_56BIT_VERSION = 52
-CRYPT_RC2_64BIT_VERSION = 120
-CRYPT_RC2_128BIT_VERSION = 58
-szOID_VERISIGN_PRIVATE_6_9 = "2.16.840.1.113733.1.6.9"
-szOID_VERISIGN_ONSITE_JURISDICTION_HASH = "2.16.840.1.113733.1.6.11"
-szOID_VERISIGN_BITSTRING_6_13 = "2.16.840.1.113733.1.6.13"
-szOID_VERISIGN_ISS_STRONG_CRYPTO = "2.16.840.1.113733.1.8.1"
-szOID_NETSCAPE = "2.16.840.1.113730"
-szOID_NETSCAPE_CERT_EXTENSION = "2.16.840.1.113730.1"
-szOID_NETSCAPE_CERT_TYPE = "2.16.840.1.113730.1.1"
-szOID_NETSCAPE_BASE_URL = "2.16.840.1.113730.1.2"
-szOID_NETSCAPE_REVOCATION_URL = "2.16.840.1.113730.1.3"
-szOID_NETSCAPE_CA_REVOCATION_URL = "2.16.840.1.113730.1.4"
-szOID_NETSCAPE_CERT_RENEWAL_URL = "2.16.840.1.113730.1.7"
-szOID_NETSCAPE_CA_POLICY_URL = "2.16.840.1.113730.1.8"
-szOID_NETSCAPE_SSL_SERVER_NAME = "2.16.840.1.113730.1.12"
-szOID_NETSCAPE_COMMENT = "2.16.840.1.113730.1.13"
-szOID_NETSCAPE_DATA_TYPE = "2.16.840.1.113730.2"
-szOID_NETSCAPE_CERT_SEQUENCE = "2.16.840.1.113730.2.5"
-NETSCAPE_SSL_CLIENT_AUTH_CERT_TYPE = 0x80
-NETSCAPE_SSL_SERVER_AUTH_CERT_TYPE = 0x40
-NETSCAPE_SMIME_CERT_TYPE = 0x20
-NETSCAPE_SIGN_CERT_TYPE = 0x10
-NETSCAPE_SSL_CA_CERT_TYPE = 0x04
-NETSCAPE_SMIME_CA_CERT_TYPE = 0x02
-NETSCAPE_SIGN_CA_CERT_TYPE = 0x01
-szOID_CT_PKI_DATA = "1.3.6.1.5.5.7.12.2"
-szOID_CT_PKI_RESPONSE = "1.3.6.1.5.5.7.12.3"
-szOID_PKIX_NO_SIGNATURE = "1.3.6.1.5.5.7.6.2"
-szOID_CMC = "1.3.6.1.5.5.7.7"
-szOID_CMC_STATUS_INFO = "1.3.6.1.5.5.7.7.1"
-szOID_CMC_IDENTIFICATION = "1.3.6.1.5.5.7.7.2"
-szOID_CMC_IDENTITY_PROOF = "1.3.6.1.5.5.7.7.3"
-szOID_CMC_DATA_RETURN = "1.3.6.1.5.5.7.7.4"
-szOID_CMC_TRANSACTION_ID = "1.3.6.1.5.5.7.7.5"
-szOID_CMC_SENDER_NONCE = "1.3.6.1.5.5.7.7.6"
-szOID_CMC_RECIPIENT_NONCE = "1.3.6.1.5.5.7.7.7"
-szOID_CMC_ADD_EXTENSIONS = "1.3.6.1.5.5.7.7.8"
-szOID_CMC_ENCRYPTED_POP = "1.3.6.1.5.5.7.7.9"
-szOID_CMC_DECRYPTED_POP = "1.3.6.1.5.5.7.7.10"
-szOID_CMC_LRA_POP_WITNESS = "1.3.6.1.5.5.7.7.11"
-szOID_CMC_GET_CERT = "1.3.6.1.5.5.7.7.15"
-szOID_CMC_GET_CRL = "1.3.6.1.5.5.7.7.16"
-szOID_CMC_REVOKE_REQUEST = "1.3.6.1.5.5.7.7.17"
-szOID_CMC_REG_INFO = "1.3.6.1.5.5.7.7.18"
-szOID_CMC_RESPONSE_INFO = "1.3.6.1.5.5.7.7.19"
-szOID_CMC_QUERY_PENDING = "1.3.6.1.5.5.7.7.21"
-szOID_CMC_ID_POP_LINK_RANDOM = "1.3.6.1.5.5.7.7.22"
-szOID_CMC_ID_POP_LINK_WITNESS = "1.3.6.1.5.5.7.7.23"
-szOID_CMC_ID_CONFIRM_CERT_ACCEPTANCE = "1.3.6.1.5.5.7.7.24"
-szOID_CMC_ADD_ATTRIBUTES = "1.3.6.1.4.1.311.10.10.1"
-CMC_TAGGED_CERT_REQUEST_CHOICE = 1
-CMC_OTHER_INFO_NO_CHOICE = 0
-CMC_OTHER_INFO_FAIL_CHOICE = 1
-CMC_OTHER_INFO_PEND_CHOICE = 2
-CMC_STATUS_SUCCESS = 0
-CMC_STATUS_FAILED = 2
-CMC_STATUS_PENDING = 3
-CMC_STATUS_NO_SUPPORT = 4
-CMC_STATUS_CONFIRM_REQUIRED = 5
-CMC_FAIL_BAD_ALG = 0
-CMC_FAIL_BAD_MESSAGE_CHECK = 1
-CMC_FAIL_BAD_REQUEST = 2
-CMC_FAIL_BAD_TIME = 3
-CMC_FAIL_BAD_CERT_ID = 4
-CMC_FAIL_UNSUPORTED_EXT = 5
-CMC_FAIL_MUST_ARCHIVE_KEYS = 6
-CMC_FAIL_BAD_IDENTITY = 7
-CMC_FAIL_POP_REQUIRED = 8
-CMC_FAIL_POP_FAILED = 9
-CMC_FAIL_NO_KEY_REUSE = 10
-CMC_FAIL_INTERNAL_CA_ERROR = 11
-CMC_FAIL_TRY_LATER = 12
-CRYPT_OID_ENCODE_OBJECT_FUNC = "CryptDllEncodeObject"
-CRYPT_OID_DECODE_OBJECT_FUNC = "CryptDllDecodeObject"
-CRYPT_OID_ENCODE_OBJECT_EX_FUNC = "CryptDllEncodeObjectEx"
-CRYPT_OID_DECODE_OBJECT_EX_FUNC = "CryptDllDecodeObjectEx"
-CRYPT_OID_CREATE_COM_OBJECT_FUNC = "CryptDllCreateCOMObject"
-CRYPT_OID_VERIFY_REVOCATION_FUNC = "CertDllVerifyRevocation"
-CRYPT_OID_VERIFY_CTL_USAGE_FUNC = "CertDllVerifyCTLUsage"
-CRYPT_OID_FORMAT_OBJECT_FUNC = "CryptDllFormatObject"
-CRYPT_OID_FIND_OID_INFO_FUNC = "CryptDllFindOIDInfo"
-CRYPT_OID_FIND_LOCALIZED_NAME_FUNC = "CryptDllFindLocalizedName"
-
-CRYPT_OID_REGPATH = "Software\\Microsoft\\Cryptography\\OID"
-CRYPT_OID_REG_ENCODING_TYPE_PREFIX = "EncodingType "
-CRYPT_OID_REG_DLL_VALUE_NAME = "Dll"
-CRYPT_OID_REG_FUNC_NAME_VALUE_NAME = "FuncName"
-CRYPT_OID_REG_FUNC_NAME_VALUE_NAME_A = "FuncName"
-CRYPT_OID_REG_FLAGS_VALUE_NAME = "CryptFlags"
-CRYPT_DEFAULT_OID = "DEFAULT"
-CRYPT_INSTALL_OID_FUNC_BEFORE_FLAG = 1
-CRYPT_GET_INSTALLED_OID_FUNC_FLAG = 0x1
-CRYPT_REGISTER_FIRST_INDEX = 0
-CRYPT_REGISTER_LAST_INDEX = -1
-CRYPT_MATCH_ANY_ENCODING_TYPE = -1
-CRYPT_HASH_ALG_OID_GROUP_ID = 1
-CRYPT_ENCRYPT_ALG_OID_GROUP_ID = 2
-CRYPT_PUBKEY_ALG_OID_GROUP_ID = 3
-CRYPT_SIGN_ALG_OID_GROUP_ID = 4
-CRYPT_RDN_ATTR_OID_GROUP_ID = 5
-CRYPT_EXT_OR_ATTR_OID_GROUP_ID = 6
-CRYPT_ENHKEY_USAGE_OID_GROUP_ID = 7
-CRYPT_POLICY_OID_GROUP_ID = 8
-CRYPT_TEMPLATE_OID_GROUP_ID = 9
-CRYPT_LAST_OID_GROUP_ID = 9
-CRYPT_FIRST_ALG_OID_GROUP_ID = CRYPT_HASH_ALG_OID_GROUP_ID
-CRYPT_LAST_ALG_OID_GROUP_ID = CRYPT_SIGN_ALG_OID_GROUP_ID
-CRYPT_OID_INHIBIT_SIGNATURE_FORMAT_FLAG = 0x1
-CRYPT_OID_USE_PUBKEY_PARA_FOR_PKCS7_FLAG = 0x2
-CRYPT_OID_NO_NULL_ALGORITHM_PARA_FLAG = 0x4
-CRYPT_OID_INFO_OID_KEY = 1
-CRYPT_OID_INFO_NAME_KEY = 2
-CRYPT_OID_INFO_ALGID_KEY = 3
-CRYPT_OID_INFO_SIGN_KEY = 4
-CRYPT_INSTALL_OID_INFO_BEFORE_FLAG = 1
-CRYPT_LOCALIZED_NAME_ENCODING_TYPE = 0
-CRYPT_LOCALIZED_NAME_OID = "LocalizedNames"
-szOID_PKCS_7_DATA = "1.2.840.113549.1.7.1"
-szOID_PKCS_7_SIGNED = "1.2.840.113549.1.7.2"
-szOID_PKCS_7_ENVELOPED = "1.2.840.113549.1.7.3"
-szOID_PKCS_7_SIGNEDANDENVELOPED = "1.2.840.113549.1.7.4"
-szOID_PKCS_7_DIGESTED = "1.2.840.113549.1.7.5"
-szOID_PKCS_7_ENCRYPTED = "1.2.840.113549.1.7.6"
-szOID_PKCS_9_CONTENT_TYPE = "1.2.840.113549.1.9.3"
-szOID_PKCS_9_MESSAGE_DIGEST = "1.2.840.113549.1.9.4"
-CMSG_DATA = 1
-CMSG_SIGNED = 2
-CMSG_ENVELOPED = 3
-CMSG_SIGNED_AND_ENVELOPED = 4
-CMSG_HASHED = 5
-CMSG_ENCRYPTED = 6
-
-CMSG_ALL_FLAGS = -1
-CMSG_DATA_FLAG = 1 << CMSG_DATA
-CMSG_SIGNED_FLAG = 1 << CMSG_SIGNED
-CMSG_ENVELOPED_FLAG = 1 << CMSG_ENVELOPED
-CMSG_SIGNED_AND_ENVELOPED_FLAG = 1 << CMSG_SIGNED_AND_ENVELOPED
-CMSG_HASHED_FLAG = 1 << CMSG_HASHED
-CMSG_ENCRYPTED_FLAG = 1 << CMSG_ENCRYPTED
-CERT_ID_ISSUER_SERIAL_NUMBER = 1
-CERT_ID_KEY_IDENTIFIER = 2
-CERT_ID_SHA1_HASH = 3
-CMSG_KEY_AGREE_EPHEMERAL_KEY_CHOICE = 1
-CMSG_KEY_AGREE_STATIC_KEY_CHOICE = 2
-CMSG_MAIL_LIST_HANDLE_KEY_CHOICE = 1
-CMSG_KEY_TRANS_RECIPIENT = 1
-CMSG_KEY_AGREE_RECIPIENT = 2
-CMSG_MAIL_LIST_RECIPIENT = 3
-CMSG_SP3_COMPATIBLE_ENCRYPT_FLAG = -2147483648
-CMSG_RC4_NO_SALT_FLAG = 0x40000000
-CMSG_INDEFINITE_LENGTH = -1
-CMSG_BARE_CONTENT_FLAG = 0x00000001
-CMSG_LENGTH_ONLY_FLAG = 0x00000002
-CMSG_DETACHED_FLAG = 0x00000004
-CMSG_AUTHENTICATED_ATTRIBUTES_FLAG = 0x00000008
-CMSG_CONTENTS_OCTETS_FLAG = 0x00000010
-CMSG_MAX_LENGTH_FLAG = 0x00000020
-CMSG_CMS_ENCAPSULATED_CONTENT_FLAG = 0x00000040
-CMSG_CRYPT_RELEASE_CONTEXT_FLAG = 0x00008000
-CMSG_TYPE_PARAM = 1
-CMSG_CONTENT_PARAM = 2
-CMSG_BARE_CONTENT_PARAM = 3
-CMSG_INNER_CONTENT_TYPE_PARAM = 4
-CMSG_SIGNER_COUNT_PARAM = 5
-CMSG_SIGNER_INFO_PARAM = 6
-CMSG_SIGNER_CERT_INFO_PARAM = 7
-CMSG_SIGNER_HASH_ALGORITHM_PARAM = 8
-CMSG_SIGNER_AUTH_ATTR_PARAM = 9
-CMSG_SIGNER_UNAUTH_ATTR_PARAM = 10
-CMSG_CERT_COUNT_PARAM = 11
-CMSG_CERT_PARAM = 12
-CMSG_CRL_COUNT_PARAM = 13
-CMSG_CRL_PARAM = 14
-CMSG_ENVELOPE_ALGORITHM_PARAM = 15
-CMSG_RECIPIENT_COUNT_PARAM = 17
-CMSG_RECIPIENT_INDEX_PARAM = 18
-CMSG_RECIPIENT_INFO_PARAM = 19
-CMSG_HASH_ALGORITHM_PARAM = 20
-CMSG_HASH_DATA_PARAM = 21
-CMSG_COMPUTED_HASH_PARAM = 22
-CMSG_ENCRYPT_PARAM = 26
-CMSG_ENCRYPTED_DIGEST = 27
-CMSG_ENCODED_SIGNER = 28
-CMSG_ENCODED_MESSAGE = 29
-CMSG_VERSION_PARAM = 30
-CMSG_ATTR_CERT_COUNT_PARAM = 31
-CMSG_ATTR_CERT_PARAM = 32
-CMSG_CMS_RECIPIENT_COUNT_PARAM = 33
-CMSG_CMS_RECIPIENT_INDEX_PARAM = 34
-CMSG_CMS_RECIPIENT_ENCRYPTED_KEY_INDEX_PARAM = 35
-CMSG_CMS_RECIPIENT_INFO_PARAM = 36
-CMSG_UNPROTECTED_ATTR_PARAM = 37
-CMSG_SIGNER_CERT_ID_PARAM = 38
-CMSG_CMS_SIGNER_INFO_PARAM = 39
-CMSG_SIGNED_DATA_V1 = 1
-CMSG_SIGNED_DATA_V3 = 3
-CMSG_SIGNED_DATA_PKCS_1_5_VERSION = CMSG_SIGNED_DATA_V1
-CMSG_SIGNED_DATA_CMS_VERSION = CMSG_SIGNED_DATA_V3
-CMSG_SIGNER_INFO_V1 = 1
-CMSG_SIGNER_INFO_V3 = 3
-CMSG_SIGNER_INFO_PKCS_1_5_VERSION = CMSG_SIGNER_INFO_V1
-CMSG_SIGNER_INFO_CMS_VERSION = CMSG_SIGNER_INFO_V3
-CMSG_HASHED_DATA_V0 = 0
-CMSG_HASHED_DATA_V2 = 2
-CMSG_HASHED_DATA_PKCS_1_5_VERSION = CMSG_HASHED_DATA_V0
-CMSG_HASHED_DATA_CMS_VERSION = CMSG_HASHED_DATA_V2
-CMSG_ENVELOPED_DATA_V0 = 0
-CMSG_ENVELOPED_DATA_V2 = 2
-CMSG_ENVELOPED_DATA_PKCS_1_5_VERSION = CMSG_ENVELOPED_DATA_V0
-CMSG_ENVELOPED_DATA_CMS_VERSION = CMSG_ENVELOPED_DATA_V2
-CMSG_KEY_AGREE_ORIGINATOR_CERT = 1
-CMSG_KEY_AGREE_ORIGINATOR_PUBLIC_KEY = 2
-CMSG_ENVELOPED_RECIPIENT_V0 = 0
-CMSG_ENVELOPED_RECIPIENT_V2 = 2
-CMSG_ENVELOPED_RECIPIENT_V3 = 3
-CMSG_ENVELOPED_RECIPIENT_V4 = 4
-CMSG_KEY_TRANS_PKCS_1_5_VERSION = CMSG_ENVELOPED_RECIPIENT_V0
-CMSG_KEY_TRANS_CMS_VERSION = CMSG_ENVELOPED_RECIPIENT_V2
-CMSG_KEY_AGREE_VERSION = CMSG_ENVELOPED_RECIPIENT_V3
-CMSG_MAIL_LIST_VERSION = CMSG_ENVELOPED_RECIPIENT_V4
-CMSG_CTRL_VERIFY_SIGNATURE = 1
-CMSG_CTRL_DECRYPT = 2
-CMSG_CTRL_VERIFY_HASH = 5
-CMSG_CTRL_ADD_SIGNER = 6
-CMSG_CTRL_DEL_SIGNER = 7
-CMSG_CTRL_ADD_SIGNER_UNAUTH_ATTR = 8
-CMSG_CTRL_DEL_SIGNER_UNAUTH_ATTR = 9
-CMSG_CTRL_ADD_CERT = 10
-CMSG_CTRL_DEL_CERT = 11
-CMSG_CTRL_ADD_CRL = 12
-CMSG_CTRL_DEL_CRL = 13
-CMSG_CTRL_ADD_ATTR_CERT = 14
-CMSG_CTRL_DEL_ATTR_CERT = 15
-CMSG_CTRL_KEY_TRANS_DECRYPT = 16
-CMSG_CTRL_KEY_AGREE_DECRYPT = 17
-CMSG_CTRL_MAIL_LIST_DECRYPT = 18
-CMSG_CTRL_VERIFY_SIGNATURE_EX = 19
-CMSG_CTRL_ADD_CMS_SIGNER_INFO = 20
-CMSG_VERIFY_SIGNER_PUBKEY = 1
-CMSG_VERIFY_SIGNER_CERT = 2
-CMSG_VERIFY_SIGNER_CHAIN = 3
-CMSG_VERIFY_SIGNER_NULL = 4
-CMSG_OID_GEN_ENCRYPT_KEY_FUNC = "CryptMsgDllGenEncryptKey"
-CMSG_OID_EXPORT_ENCRYPT_KEY_FUNC = "CryptMsgDllExportEncryptKey"
-CMSG_OID_IMPORT_ENCRYPT_KEY_FUNC = "CryptMsgDllImportEncryptKey"
-CMSG_CONTENT_ENCRYPT_PAD_ENCODED_LEN_FLAG = 0x00000001
-CMSG_DEFAULT_INSTALLABLE_FUNC_OID = 1
-CMSG_CONTENT_ENCRYPT_FREE_PARA_FLAG = 0x00000001
-CMSG_CONTENT_ENCRYPT_RELEASE_CONTEXT_FLAG = 0x00008000
-CMSG_OID_GEN_CONTENT_ENCRYPT_KEY_FUNC = "CryptMsgDllGenContentEncryptKey"
-CMSG_KEY_TRANS_ENCRYPT_FREE_PARA_FLAG = 0x00000001
-CMSG_OID_EXPORT_KEY_TRANS_FUNC = "CryptMsgDllExportKeyTrans"
-CMSG_KEY_AGREE_ENCRYPT_FREE_PARA_FLAG = 0x00000001
-CMSG_KEY_AGREE_ENCRYPT_FREE_MATERIAL_FLAG = 0x00000002
-CMSG_KEY_AGREE_ENCRYPT_FREE_PUBKEY_ALG_FLAG = 0x00000004
-CMSG_KEY_AGREE_ENCRYPT_FREE_PUBKEY_PARA_FLAG = 0x00000008
-CMSG_KEY_AGREE_ENCRYPT_FREE_PUBKEY_BITS_FLAG = 0x00000010
-CMSG_OID_EXPORT_KEY_AGREE_FUNC = "CryptMsgDllExportKeyAgree"
-CMSG_MAIL_LIST_ENCRYPT_FREE_PARA_FLAG = 0x00000001
-CMSG_OID_EXPORT_MAIL_LIST_FUNC = "CryptMsgDllExportMailList"
-CMSG_OID_IMPORT_KEY_TRANS_FUNC = "CryptMsgDllImportKeyTrans"
-CMSG_OID_IMPORT_KEY_AGREE_FUNC = "CryptMsgDllImportKeyAgree"
-CMSG_OID_IMPORT_MAIL_LIST_FUNC = "CryptMsgDllImportMailList"
-
-# Certificate property id's used with CertGetCertificateContextProperty
-CERT_KEY_PROV_HANDLE_PROP_ID = 1
-CERT_KEY_PROV_INFO_PROP_ID = 2
-CERT_SHA1_HASH_PROP_ID = 3
-CERT_MD5_HASH_PROP_ID = 4
-CERT_HASH_PROP_ID = CERT_SHA1_HASH_PROP_ID
-CERT_KEY_CONTEXT_PROP_ID = 5
-CERT_KEY_SPEC_PROP_ID = 6
-CERT_IE30_RESERVED_PROP_ID = 7
-CERT_PUBKEY_HASH_RESERVED_PROP_ID = 8
-CERT_ENHKEY_USAGE_PROP_ID = 9
-CERT_CTL_USAGE_PROP_ID = CERT_ENHKEY_USAGE_PROP_ID
-CERT_NEXT_UPDATE_LOCATION_PROP_ID = 10
-CERT_FRIENDLY_NAME_PROP_ID = 11
-CERT_PVK_FILE_PROP_ID = 12
-CERT_DESCRIPTION_PROP_ID = 13
-CERT_ACCESS_STATE_PROP_ID = 14
-CERT_SIGNATURE_HASH_PROP_ID = 15
-CERT_SMART_CARD_DATA_PROP_ID = 16
-CERT_EFS_PROP_ID = 17
-CERT_FORTEZZA_DATA_PROP_ID = 18
-CERT_ARCHIVED_PROP_ID = 19
-CERT_KEY_IDENTIFIER_PROP_ID = 20
-CERT_AUTO_ENROLL_PROP_ID = 21
-CERT_PUBKEY_ALG_PARA_PROP_ID = 22
-CERT_CROSS_CERT_DIST_POINTS_PROP_ID = 23
-CERT_ISSUER_PUBLIC_KEY_MD5_HASH_PROP_ID = 24
-CERT_SUBJECT_PUBLIC_KEY_MD5_HASH_PROP_ID = 25
-CERT_ENROLLMENT_PROP_ID = 26
-CERT_DATE_STAMP_PROP_ID = 27
-CERT_ISSUER_SERIAL_NUMBER_MD5_HASH_PROP_ID = 28
-CERT_SUBJECT_NAME_MD5_HASH_PROP_ID = 29
-CERT_EXTENDED_ERROR_INFO_PROP_ID = 30
-CERT_RENEWAL_PROP_ID = 64
-CERT_ARCHIVED_KEY_HASH_PROP_ID = 65
-CERT_AUTO_ENROLL_RETRY_PROP_ID = 66
-CERT_AIA_URL_RETRIEVED_PROP_ID = 67
-CERT_AUTHORITY_INFO_ACCESS_PROP_ID = 68
-CERT_BACKED_UP_PROP_ID = 69
-CERT_OCSP_RESPONSE_PROP_ID = 70
-CERT_REQUEST_ORIGINATOR_PROP_ID = 71
-CERT_SOURCE_LOCATION_PROP_ID = 72
-CERT_SOURCE_URL_PROP_ID = 73
-CERT_NEW_KEY_PROP_ID = 74
-CERT_OCSP_CACHE_PREFIX_PROP_ID = 75
-CERT_SMART_CARD_ROOT_INFO_PROP_ID = 76
-CERT_NO_AUTO_EXPIRE_CHECK_PROP_ID = 77
-CERT_NCRYPT_KEY_HANDLE_PROP_ID = 78
-CERT_HCRYPTPROV_OR_NCRYPT_KEY_HANDLE_PROP_ID = 79
-CERT_SUBJECT_INFO_ACCESS_PROP_ID = 80
-CERT_CA_OCSP_AUTHORITY_INFO_ACCESS_PROP_ID = 81
-CERT_CA_DISABLE_CRL_PROP_ID = 82
-CERT_ROOT_PROGRAM_CERT_POLICIES_PROP_ID = 83
-CERT_ROOT_PROGRAM_NAME_CONSTRAINTS_PROP_ID = 84
-CERT_SUBJECT_OCSP_AUTHORITY_INFO_ACCESS_PROP_ID = 85
-CERT_SUBJECT_DISABLE_CRL_PROP_ID = 86
-CERT_CEP_PROP_ID = 87
-CERT_SIGN_HASH_CNG_ALG_PROP_ID = 89
-CERT_SCARD_PIN_ID_PROP_ID = 90
-CERT_SCARD_PIN_INFO_PROP_ID = 91
-CERT_FIRST_RESERVED_PROP_ID = 92
-CERT_LAST_RESERVED_PROP_ID = 0x00007FFF
-CERT_FIRST_USER_PROP_ID = 0x00008000
-CERT_LAST_USER_PROP_ID = 0x0000FFFF
-
-szOID_CERT_PROP_ID_PREFIX = "1.3.6.1.4.1.311.10.11."
-szOID_CERT_KEY_IDENTIFIER_PROP_ID = "1.3.6.1.4.1.311.10.11.20"
-szOID_CERT_ISSUER_SERIAL_NUMBER_MD5_HASH_PROP_ID = "1.3.6.1.4.1.311.10.11.28"
-szOID_CERT_SUBJECT_NAME_MD5_HASH_PROP_ID = "1.3.6.1.4.1.311.10.11.29"
-CERT_ACCESS_STATE_WRITE_PERSIST_FLAG = 0x1
-CERT_ACCESS_STATE_SYSTEM_STORE_FLAG = 0x2
-CERT_ACCESS_STATE_LM_SYSTEM_STORE_FLAG = 0x4
-CERT_SET_KEY_PROV_HANDLE_PROP_ID = 0x00000001
-CERT_SET_KEY_CONTEXT_PROP_ID = 0x00000001
-sz_CERT_STORE_PROV_MEMORY = "Memory"
-sz_CERT_STORE_PROV_FILENAME_W = "File"
-sz_CERT_STORE_PROV_FILENAME = sz_CERT_STORE_PROV_FILENAME_W
-sz_CERT_STORE_PROV_SYSTEM_W = "System"
-sz_CERT_STORE_PROV_SYSTEM = sz_CERT_STORE_PROV_SYSTEM_W
-sz_CERT_STORE_PROV_PKCS7 = "PKCS7"
-sz_CERT_STORE_PROV_SERIALIZED = "Serialized"
-sz_CERT_STORE_PROV_COLLECTION = "Collection"
-sz_CERT_STORE_PROV_SYSTEM_REGISTRY_W = "SystemRegistry"
-sz_CERT_STORE_PROV_SYSTEM_REGISTRY = sz_CERT_STORE_PROV_SYSTEM_REGISTRY_W
-sz_CERT_STORE_PROV_PHYSICAL_W = "Physical"
-sz_CERT_STORE_PROV_PHYSICAL = sz_CERT_STORE_PROV_PHYSICAL_W
-sz_CERT_STORE_PROV_SMART_CARD_W = "SmartCard"
-sz_CERT_STORE_PROV_SMART_CARD = sz_CERT_STORE_PROV_SMART_CARD_W
-sz_CERT_STORE_PROV_LDAP_W = "Ldap"
-sz_CERT_STORE_PROV_LDAP = sz_CERT_STORE_PROV_LDAP_W
-CERT_STORE_SIGNATURE_FLAG = 0x00000001
-CERT_STORE_TIME_VALIDITY_FLAG = 0x00000002
-CERT_STORE_REVOCATION_FLAG = 0x00000004
-CERT_STORE_NO_CRL_FLAG = 0x00010000
-CERT_STORE_NO_ISSUER_FLAG = 0x00020000
-CERT_STORE_BASE_CRL_FLAG = 0x00000100
-CERT_STORE_DELTA_CRL_FLAG = 0x00000200
-CERT_STORE_NO_CRYPT_RELEASE_FLAG = 0x00000001
-CERT_STORE_SET_LOCALIZED_NAME_FLAG = 0x00000002
-CERT_STORE_DEFER_CLOSE_UNTIL_LAST_FREE_FLAG = 0x00000004
-CERT_STORE_DELETE_FLAG = 0x00000010
-CERT_STORE_UNSAFE_PHYSICAL_FLAG = 0x00000020
-CERT_STORE_SHARE_STORE_FLAG = 0x00000040
-CERT_STORE_SHARE_CONTEXT_FLAG = 0x00000080
-CERT_STORE_MANIFOLD_FLAG = 0x00000100
-CERT_STORE_ENUM_ARCHIVED_FLAG = 0x00000200
-CERT_STORE_UPDATE_KEYID_FLAG = 0x00000400
-CERT_STORE_BACKUP_RESTORE_FLAG = 0x00000800
-CERT_STORE_READONLY_FLAG = 0x00008000
-CERT_STORE_OPEN_EXISTING_FLAG = 0x00004000
-CERT_STORE_CREATE_NEW_FLAG = 0x00002000
-CERT_STORE_MAXIMUM_ALLOWED_FLAG = 0x00001000
-CERT_SYSTEM_STORE_MASK = -65536
-CERT_SYSTEM_STORE_RELOCATE_FLAG = -2147483648
-CERT_SYSTEM_STORE_UNPROTECTED_FLAG = 0x40000000
-CERT_SYSTEM_STORE_LOCATION_MASK = 0x00FF0000
-CERT_SYSTEM_STORE_LOCATION_SHIFT = 16
-CERT_SYSTEM_STORE_CURRENT_USER_ID = 1
-CERT_SYSTEM_STORE_LOCAL_MACHINE_ID = 2
-CERT_SYSTEM_STORE_CURRENT_SERVICE_ID = 4
-CERT_SYSTEM_STORE_SERVICES_ID = 5
-CERT_SYSTEM_STORE_USERS_ID = 6
-CERT_SYSTEM_STORE_CURRENT_USER_GROUP_POLICY_ID = 7
-CERT_SYSTEM_STORE_LOCAL_MACHINE_GROUP_POLICY_ID = 8
-CERT_SYSTEM_STORE_LOCAL_MACHINE_ENTERPRISE_ID = 9
-CERT_SYSTEM_STORE_CURRENT_USER = (
-    CERT_SYSTEM_STORE_CURRENT_USER_ID << CERT_SYSTEM_STORE_LOCATION_SHIFT
-)
-CERT_SYSTEM_STORE_LOCAL_MACHINE = (
-    CERT_SYSTEM_STORE_LOCAL_MACHINE_ID << CERT_SYSTEM_STORE_LOCATION_SHIFT
-)
-CERT_SYSTEM_STORE_CURRENT_SERVICE = (
-    CERT_SYSTEM_STORE_CURRENT_SERVICE_ID << CERT_SYSTEM_STORE_LOCATION_SHIFT
-)
-CERT_SYSTEM_STORE_SERVICES = (
-    CERT_SYSTEM_STORE_SERVICES_ID << CERT_SYSTEM_STORE_LOCATION_SHIFT
-)
-CERT_SYSTEM_STORE_USERS = CERT_SYSTEM_STORE_USERS_ID << CERT_SYSTEM_STORE_LOCATION_SHIFT
-CERT_SYSTEM_STORE_CURRENT_USER_GROUP_POLICY = (
-    CERT_SYSTEM_STORE_CURRENT_USER_GROUP_POLICY_ID << CERT_SYSTEM_STORE_LOCATION_SHIFT
-)
-CERT_SYSTEM_STORE_LOCAL_MACHINE_GROUP_POLICY = (
-    CERT_SYSTEM_STORE_LOCAL_MACHINE_GROUP_POLICY_ID << CERT_SYSTEM_STORE_LOCATION_SHIFT
-)
-CERT_SYSTEM_STORE_LOCAL_MACHINE_ENTERPRISE = (
-    CERT_SYSTEM_STORE_LOCAL_MACHINE_ENTERPRISE_ID << CERT_SYSTEM_STORE_LOCATION_SHIFT
-)
-CERT_PROT_ROOT_DISABLE_CURRENT_USER_FLAG = 0x1
-CERT_PROT_ROOT_INHIBIT_ADD_AT_INIT_FLAG = 0x2
-CERT_PROT_ROOT_INHIBIT_PURGE_LM_FLAG = 0x4
-CERT_PROT_ROOT_DISABLE_LM_AUTH_FLAG = 0x8
-CERT_PROT_ROOT_ONLY_LM_GPT_FLAG = 0x8
-CERT_PROT_ROOT_DISABLE_NT_AUTH_REQUIRED_FLAG = 0x10
-CERT_PROT_ROOT_DISABLE_NOT_DEFINED_NAME_CONSTRAINT_FLAG = 0x20
-CERT_TRUST_PUB_ALLOW_TRUST_MASK = 0x00000003
-CERT_TRUST_PUB_ALLOW_END_USER_TRUST = 0x00000000
-CERT_TRUST_PUB_ALLOW_MACHINE_ADMIN_TRUST = 0x00000001
-CERT_TRUST_PUB_ALLOW_ENTERPRISE_ADMIN_TRUST = 0x00000002
-CERT_TRUST_PUB_CHECK_PUBLISHER_REV_FLAG = 0x00000100
-CERT_TRUST_PUB_CHECK_TIMESTAMP_REV_FLAG = 0x00000200
-
-CERT_AUTH_ROOT_AUTO_UPDATE_LOCAL_MACHINE_REGPATH = (
-    r"Software\Microsoft\SystemCertificates\AuthRoot\AutoUpdate"
-)
-CERT_AUTH_ROOT_AUTO_UPDATE_DISABLE_UNTRUSTED_ROOT_LOGGING_FLAG = 0x1
-CERT_AUTH_ROOT_AUTO_UPDATE_DISABLE_PARTIAL_CHAIN_LOGGING_FLAG = 0x2
-CERT_AUTH_ROOT_AUTO_UPDATE_ROOT_DIR_URL_VALUE_NAME = "RootDirUrl"
-CERT_AUTH_ROOT_AUTO_UPDATE_SYNC_DELTA_TIME_VALUE_NAME = "SyncDeltaTime"
-CERT_AUTH_ROOT_AUTO_UPDATE_FLAGS_VALUE_NAME = "Flags"
-CERT_AUTH_ROOT_CTL_FILENAME = "authroot.stl"
-CERT_AUTH_ROOT_CTL_FILENAME_A = "authroot.stl"
-CERT_AUTH_ROOT_CAB_FILENAME = "authrootstl.cab"
-CERT_AUTH_ROOT_SEQ_FILENAME = "authrootseq.txt"
-CERT_AUTH_ROOT_CERT_EXT = ".crt"
-
-CERT_GROUP_POLICY_SYSTEM_STORE_REGPATH = (
-    r"Software\Policies\Microsoft\SystemCertificates"
-)
-CERT_EFSBLOB_REGPATH = CERT_GROUP_POLICY_SYSTEM_STORE_REGPATH + r"\EFS"
-CERT_EFSBLOB_VALUE_NAME = "EFSBlob"
-CERT_PROT_ROOT_FLAGS_REGPATH = (
-    CERT_GROUP_POLICY_SYSTEM_STORE_REGPATH + r"\Root\ProtectedRoots"
-)
-CERT_PROT_ROOT_FLAGS_VALUE_NAME = "Flags"
-CERT_TRUST_PUB_SAFER_GROUP_POLICY_REGPATH = (
-    CERT_GROUP_POLICY_SYSTEM_STORE_REGPATH + r"\TrustedPublisher\Safer"
-)
-CERT_LOCAL_MACHINE_SYSTEM_STORE_REGPATH = r"Software\Microsoft\SystemCertificates"
-CERT_TRUST_PUB_SAFER_LOCAL_MACHINE_REGPATH = (
-    CERT_LOCAL_MACHINE_SYSTEM_STORE_REGPATH + r"\TrustedPublisher\Safer"
-)
-CERT_TRUST_PUB_AUTHENTICODE_FLAGS_VALUE_NAME = "AuthenticodeFlags"
-CERT_OCM_SUBCOMPONENTS_LOCAL_MACHINE_REGPATH = (
-    r"SOFTWARE\Microsoft\Windows\CurrentVersion\Setup\OC Manager\Subcomponents"
-)
-CERT_OCM_SUBCOMPONENTS_ROOT_AUTO_UPDATE_VALUE_NAME = r"RootAutoUpdate"
-CERT_DISABLE_ROOT_AUTO_UPDATE_REGPATH = (
-    CERT_GROUP_POLICY_SYSTEM_STORE_REGPATH + r"\AuthRoot"
-)
-CERT_DISABLE_ROOT_AUTO_UPDATE_VALUE_NAME = "DisableRootAutoUpdate"
-CERT_AUTH_ROOT_AUTO_UPDATE_LOCAL_MACHINE_REGPATH = (
-    CERT_LOCAL_MACHINE_SYSTEM_STORE_REGPATH + r"\AuthRoot\AutoUpdate"
-)
-
-CERT_REGISTRY_STORE_REMOTE_FLAG = 0x10000
-CERT_REGISTRY_STORE_SERIALIZED_FLAG = 0x20000
-CERT_REGISTRY_STORE_CLIENT_GPT_FLAG = -2147483648
-CERT_REGISTRY_STORE_LM_GPT_FLAG = 0x01000000
-CERT_REGISTRY_STORE_ROAMING_FLAG = 0x40000
-CERT_REGISTRY_STORE_MY_IE_DIRTY_FLAG = 0x80000
-CERT_IE_DIRTY_FLAGS_REGPATH = r"Software\Microsoft\Cryptography\IEDirtyFlags"
-
-CERT_FILE_STORE_COMMIT_ENABLE_FLAG = 0x10000
-CERT_LDAP_STORE_SIGN_FLAG = 0x10000
-CERT_LDAP_STORE_AREC_EXCLUSIVE_FLAG = 0x20000
-CERT_LDAP_STORE_OPENED_FLAG = 0x40000
-CERT_LDAP_STORE_UNBIND_FLAG = 0x80000
-CRYPT_OID_OPEN_STORE_PROV_FUNC = "CertDllOpenStoreProv"
-
-CERT_STORE_PROV_EXTERNAL_FLAG = 0x1
-CERT_STORE_PROV_DELETED_FLAG = 0x2
-CERT_STORE_PROV_NO_PERSIST_FLAG = 0x4
-CERT_STORE_PROV_SYSTEM_STORE_FLAG = 0x8
-CERT_STORE_PROV_LM_SYSTEM_STORE_FLAG = 0x10
-CERT_STORE_PROV_CLOSE_FUNC = 0
-CERT_STORE_PROV_READ_CERT_FUNC = 1
-CERT_STORE_PROV_WRITE_CERT_FUNC = 2
-CERT_STORE_PROV_DELETE_CERT_FUNC = 3
-CERT_STORE_PROV_SET_CERT_PROPERTY_FUNC = 4
-CERT_STORE_PROV_READ_CRL_FUNC = 5
-CERT_STORE_PROV_WRITE_CRL_FUNC = 6
-CERT_STORE_PROV_DELETE_CRL_FUNC = 7
-CERT_STORE_PROV_SET_CRL_PROPERTY_FUNC = 8
-CERT_STORE_PROV_READ_CTL_FUNC = 9
-CERT_STORE_PROV_WRITE_CTL_FUNC = 10
-CERT_STORE_PROV_DELETE_CTL_FUNC = 11
-CERT_STORE_PROV_SET_CTL_PROPERTY_FUNC = 12
-CERT_STORE_PROV_CONTROL_FUNC = 13
-CERT_STORE_PROV_FIND_CERT_FUNC = 14
-CERT_STORE_PROV_FREE_FIND_CERT_FUNC = 15
-CERT_STORE_PROV_GET_CERT_PROPERTY_FUNC = 16
-CERT_STORE_PROV_FIND_CRL_FUNC = 17
-CERT_STORE_PROV_FREE_FIND_CRL_FUNC = 18
-CERT_STORE_PROV_GET_CRL_PROPERTY_FUNC = 19
-CERT_STORE_PROV_FIND_CTL_FUNC = 20
-CERT_STORE_PROV_FREE_FIND_CTL_FUNC = 21
-CERT_STORE_PROV_GET_CTL_PROPERTY_FUNC = 22
-CERT_STORE_PROV_WRITE_ADD_FLAG = 0x1
-CERT_STORE_SAVE_AS_STORE = 1
-CERT_STORE_SAVE_AS_PKCS7 = 2
-CERT_STORE_SAVE_TO_FILE = 1
-CERT_STORE_SAVE_TO_MEMORY = 2
-CERT_STORE_SAVE_TO_FILENAME_A = 3
-CERT_STORE_SAVE_TO_FILENAME_W = 4
-CERT_STORE_SAVE_TO_FILENAME = CERT_STORE_SAVE_TO_FILENAME_W
-CERT_CLOSE_STORE_FORCE_FLAG = 0x00000001
-CERT_CLOSE_STORE_CHECK_FLAG = 0x00000002
-CERT_COMPARE_MASK = 0xFFFF
-CERT_COMPARE_SHIFT = 16
-CERT_COMPARE_ANY = 0
-CERT_COMPARE_SHA1_HASH = 1
-CERT_COMPARE_NAME = 2
-CERT_COMPARE_ATTR = 3
-CERT_COMPARE_MD5_HASH = 4
-CERT_COMPARE_PROPERTY = 5
-CERT_COMPARE_PUBLIC_KEY = 6
-CERT_COMPARE_HASH = CERT_COMPARE_SHA1_HASH
-CERT_COMPARE_NAME_STR_A = 7
-CERT_COMPARE_NAME_STR_W = 8
-CERT_COMPARE_KEY_SPEC = 9
-CERT_COMPARE_ENHKEY_USAGE = 10
-CERT_COMPARE_CTL_USAGE = CERT_COMPARE_ENHKEY_USAGE
-CERT_COMPARE_SUBJECT_CERT = 11
-CERT_COMPARE_ISSUER_OF = 12
-CERT_COMPARE_EXISTING = 13
-CERT_COMPARE_SIGNATURE_HASH = 14
-CERT_COMPARE_KEY_IDENTIFIER = 15
-CERT_COMPARE_CERT_ID = 16
-CERT_COMPARE_CROSS_CERT_DIST_POINTS = 17
-CERT_COMPARE_PUBKEY_MD5_HASH = 18
-CERT_FIND_ANY = CERT_COMPARE_ANY << CERT_COMPARE_SHIFT
-CERT_FIND_SHA1_HASH = CERT_COMPARE_SHA1_HASH << CERT_COMPARE_SHIFT
-CERT_FIND_MD5_HASH = CERT_COMPARE_MD5_HASH << CERT_COMPARE_SHIFT
-CERT_FIND_SIGNATURE_HASH = CERT_COMPARE_SIGNATURE_HASH << CERT_COMPARE_SHIFT
-CERT_FIND_KEY_IDENTIFIER = CERT_COMPARE_KEY_IDENTIFIER << CERT_COMPARE_SHIFT
-CERT_FIND_HASH = CERT_FIND_SHA1_HASH
-CERT_FIND_PROPERTY = CERT_COMPARE_PROPERTY << CERT_COMPARE_SHIFT
-CERT_FIND_PUBLIC_KEY = CERT_COMPARE_PUBLIC_KEY << CERT_COMPARE_SHIFT
-CERT_FIND_SUBJECT_NAME = (
-    CERT_COMPARE_NAME << CERT_COMPARE_SHIFT | CERT_INFO_SUBJECT_FLAG
-)
-CERT_FIND_SUBJECT_ATTR = (
-    CERT_COMPARE_ATTR << CERT_COMPARE_SHIFT | CERT_INFO_SUBJECT_FLAG
-)
-CERT_FIND_ISSUER_NAME = CERT_COMPARE_NAME << CERT_COMPARE_SHIFT | CERT_INFO_ISSUER_FLAG
-CERT_FIND_ISSUER_ATTR = CERT_COMPARE_ATTR << CERT_COMPARE_SHIFT | CERT_INFO_ISSUER_FLAG
-CERT_FIND_SUBJECT_STR_A = (
-    CERT_COMPARE_NAME_STR_A << CERT_COMPARE_SHIFT | CERT_INFO_SUBJECT_FLAG
-)
-CERT_FIND_SUBJECT_STR_W = (
-    CERT_COMPARE_NAME_STR_W << CERT_COMPARE_SHIFT | CERT_INFO_SUBJECT_FLAG
-)
-CERT_FIND_SUBJECT_STR = CERT_FIND_SUBJECT_STR_W
-CERT_FIND_ISSUER_STR_A = (
-    CERT_COMPARE_NAME_STR_A << CERT_COMPARE_SHIFT | CERT_INFO_ISSUER_FLAG
-)
-CERT_FIND_ISSUER_STR_W = (
-    CERT_COMPARE_NAME_STR_W << CERT_COMPARE_SHIFT | CERT_INFO_ISSUER_FLAG
-)
-CERT_FIND_ISSUER_STR = CERT_FIND_ISSUER_STR_W
-CERT_FIND_KEY_SPEC = CERT_COMPARE_KEY_SPEC << CERT_COMPARE_SHIFT
-CERT_FIND_ENHKEY_USAGE = CERT_COMPARE_ENHKEY_USAGE << CERT_COMPARE_SHIFT
-CERT_FIND_CTL_USAGE = CERT_FIND_ENHKEY_USAGE
-CERT_FIND_SUBJECT_CERT = CERT_COMPARE_SUBJECT_CERT << CERT_COMPARE_SHIFT
-CERT_FIND_ISSUER_OF = CERT_COMPARE_ISSUER_OF << CERT_COMPARE_SHIFT
-CERT_FIND_EXISTING = CERT_COMPARE_EXISTING << CERT_COMPARE_SHIFT
-CERT_FIND_CERT_ID = CERT_COMPARE_CERT_ID << CERT_COMPARE_SHIFT
-CERT_FIND_CROSS_CERT_DIST_POINTS = (
-    CERT_COMPARE_CROSS_CERT_DIST_POINTS << CERT_COMPARE_SHIFT
-)
-CERT_FIND_PUBKEY_MD5_HASH = CERT_COMPARE_PUBKEY_MD5_HASH << CERT_COMPARE_SHIFT
-CERT_FIND_OPTIONAL_ENHKEY_USAGE_FLAG = 0x1
-CERT_FIND_EXT_ONLY_ENHKEY_USAGE_FLAG = 0x2
-CERT_FIND_PROP_ONLY_ENHKEY_USAGE_FLAG = 0x4
-CERT_FIND_NO_ENHKEY_USAGE_FLAG = 0x8
-CERT_FIND_OR_ENHKEY_USAGE_FLAG = 0x10
-CERT_FIND_VALID_ENHKEY_USAGE_FLAG = 0x20
-CERT_FIND_OPTIONAL_CTL_USAGE_FLAG = CERT_FIND_OPTIONAL_ENHKEY_USAGE_FLAG
-CERT_FIND_EXT_ONLY_CTL_USAGE_FLAG = CERT_FIND_EXT_ONLY_ENHKEY_USAGE_FLAG
-CERT_FIND_PROP_ONLY_CTL_USAGE_FLAG = CERT_FIND_PROP_ONLY_ENHKEY_USAGE_FLAG
-CERT_FIND_NO_CTL_USAGE_FLAG = CERT_FIND_NO_ENHKEY_USAGE_FLAG
-CERT_FIND_OR_CTL_USAGE_FLAG = CERT_FIND_OR_ENHKEY_USAGE_FLAG
-CERT_FIND_VALID_CTL_USAGE_FLAG = CERT_FIND_VALID_ENHKEY_USAGE_FLAG
-CERT_SET_PROPERTY_IGNORE_PERSIST_ERROR_FLAG = -2147483648
-CERT_SET_PROPERTY_INHIBIT_PERSIST_FLAG = 0x40000000
-CTL_ENTRY_FROM_PROP_CHAIN_FLAG = 0x1
-CRL_FIND_ANY = 0
-CRL_FIND_ISSUED_BY = 1
-CRL_FIND_EXISTING = 2
-CRL_FIND_ISSUED_FOR = 3
-CRL_FIND_ISSUED_BY_AKI_FLAG = 0x1
-CRL_FIND_ISSUED_BY_SIGNATURE_FLAG = 0x2
-CRL_FIND_ISSUED_BY_DELTA_FLAG = 0x4
-CRL_FIND_ISSUED_BY_BASE_FLAG = 0x8
-CERT_STORE_ADD_NEW = 1
-CERT_STORE_ADD_USE_EXISTING = 2
-CERT_STORE_ADD_REPLACE_EXISTING = 3
-CERT_STORE_ADD_ALWAYS = 4
-CERT_STORE_ADD_REPLACE_EXISTING_INHERIT_PROPERTIES = 5
-CERT_STORE_ADD_NEWER = 6
-CERT_STORE_ADD_NEWER_INHERIT_PROPERTIES = 7
-CERT_STORE_CERTIFICATE_CONTEXT = 1
-CERT_STORE_CRL_CONTEXT = 2
-CERT_STORE_CTL_CONTEXT = 3
-
-CERT_STORE_ALL_CONTEXT_FLAG = -1
-CERT_STORE_CERTIFICATE_CONTEXT_FLAG = 1 << CERT_STORE_CERTIFICATE_CONTEXT
-CERT_STORE_CRL_CONTEXT_FLAG = 1 << CERT_STORE_CRL_CONTEXT
-CERT_STORE_CTL_CONTEXT_FLAG = 1 << CERT_STORE_CTL_CONTEXT
-CTL_ANY_SUBJECT_TYPE = 1
-CTL_CERT_SUBJECT_TYPE = 2
-CTL_FIND_ANY = 0
-CTL_FIND_SHA1_HASH = 1
-CTL_FIND_MD5_HASH = 2
-CTL_FIND_USAGE = 3
-CTL_FIND_SUBJECT = 4
-CTL_FIND_EXISTING = 5
-CTL_FIND_NO_LIST_ID_CBDATA = -1
-CTL_FIND_SAME_USAGE_FLAG = 0x1
-CERT_STORE_CTRL_RESYNC = 1
-CERT_STORE_CTRL_NOTIFY_CHANGE = 2
-CERT_STORE_CTRL_COMMIT = 3
-CERT_STORE_CTRL_AUTO_RESYNC = 4
-CERT_STORE_CTRL_CANCEL_NOTIFY = 5
-CERT_STORE_CTRL_INHIBIT_DUPLICATE_HANDLE_FLAG = 0x1
-CERT_STORE_CTRL_COMMIT_FORCE_FLAG = 0x1
-CERT_STORE_CTRL_COMMIT_CLEAR_FLAG = 0x2
-CERT_STORE_LOCALIZED_NAME_PROP_ID = 0x1000
-CERT_CREATE_CONTEXT_NOCOPY_FLAG = 0x1
-CERT_CREATE_CONTEXT_SORTED_FLAG = 0x2
-CERT_CREATE_CONTEXT_NO_HCRYPTMSG_FLAG = 0x4
-CERT_CREATE_CONTEXT_NO_ENTRY_FLAG = 0x8
-
-CERT_PHYSICAL_STORE_ADD_ENABLE_FLAG = 0x1
-CERT_PHYSICAL_STORE_OPEN_DISABLE_FLAG = 0x2
-CERT_PHYSICAL_STORE_REMOTE_OPEN_DISABLE_FLAG = 0x4
-CERT_PHYSICAL_STORE_INSERT_COMPUTER_NAME_ENABLE_FLAG = 0x8
-CERT_PHYSICAL_STORE_PREDEFINED_ENUM_FLAG = 0x1
-
-# Names of physical cert stores
-CERT_PHYSICAL_STORE_DEFAULT_NAME = ".Default"
-CERT_PHYSICAL_STORE_GROUP_POLICY_NAME = ".GroupPolicy"
-CERT_PHYSICAL_STORE_LOCAL_MACHINE_NAME = ".LocalMachine"
-CERT_PHYSICAL_STORE_DS_USER_CERTIFICATE_NAME = ".UserCertificate"
-CERT_PHYSICAL_STORE_LOCAL_MACHINE_GROUP_POLICY_NAME = ".LocalMachineGroupPolicy"
-CERT_PHYSICAL_STORE_ENTERPRISE_NAME = ".Enterprise"
-CERT_PHYSICAL_STORE_AUTH_ROOT_NAME = ".AuthRoot"
-CERT_PHYSICAL_STORE_SMART_CARD_NAME = ".SmartCard"
-
-CRYPT_OID_OPEN_SYSTEM_STORE_PROV_FUNC = "CertDllOpenSystemStoreProv"
-CRYPT_OID_REGISTER_SYSTEM_STORE_FUNC = "CertDllRegisterSystemStore"
-CRYPT_OID_UNREGISTER_SYSTEM_STORE_FUNC = "CertDllUnregisterSystemStore"
-CRYPT_OID_ENUM_SYSTEM_STORE_FUNC = "CertDllEnumSystemStore"
-CRYPT_OID_REGISTER_PHYSICAL_STORE_FUNC = "CertDllRegisterPhysicalStore"
-CRYPT_OID_UNREGISTER_PHYSICAL_STORE_FUNC = "CertDllUnregisterPhysicalStore"
-CRYPT_OID_ENUM_PHYSICAL_STORE_FUNC = "CertDllEnumPhysicalStore"
-CRYPT_OID_SYSTEM_STORE_LOCATION_VALUE_NAME = "SystemStoreLocation"
-
-CMSG_TRUSTED_SIGNER_FLAG = 0x1
-CMSG_SIGNER_ONLY_FLAG = 0x2
-CMSG_USE_SIGNER_INDEX_FLAG = 0x4
-CMSG_CMS_ENCAPSULATED_CTL_FLAG = 0x00008000
-CMSG_ENCODE_SORTED_CTL_FLAG = 0x1
-CMSG_ENCODE_HASHED_SUBJECT_IDENTIFIER_FLAG = 0x2
-CERT_VERIFY_INHIBIT_CTL_UPDATE_FLAG = 0x1
-CERT_VERIFY_TRUSTED_SIGNERS_FLAG = 0x2
-CERT_VERIFY_NO_TIME_CHECK_FLAG = 0x4
-CERT_VERIFY_ALLOW_MORE_USAGE_FLAG = 0x8
-CERT_VERIFY_UPDATED_CTL_FLAG = 0x1
-CERT_CONTEXT_REVOCATION_TYPE = 1
-CERT_VERIFY_REV_CHAIN_FLAG = 0x00000001
-CERT_VERIFY_CACHE_ONLY_BASED_REVOCATION = 0x00000002
-CERT_VERIFY_REV_ACCUMULATIVE_TIMEOUT_FLAG = 0x00000004
-CERT_UNICODE_IS_RDN_ATTRS_FLAG = 0x1
-CERT_CASE_INSENSITIVE_IS_RDN_ATTRS_FLAG = 0x2
-CRYPT_VERIFY_CERT_SIGN_SUBJECT_BLOB = 1
-CRYPT_VERIFY_CERT_SIGN_SUBJECT_CERT = 2
-CRYPT_VERIFY_CERT_SIGN_SUBJECT_CRL = 3
-CRYPT_VERIFY_CERT_SIGN_ISSUER_PUBKEY = 1
-CRYPT_VERIFY_CERT_SIGN_ISSUER_CERT = 2
-CRYPT_VERIFY_CERT_SIGN_ISSUER_CHAIN = 3
-CRYPT_VERIFY_CERT_SIGN_ISSUER_NULL = 4
-CRYPT_DEFAULT_CONTEXT_AUTO_RELEASE_FLAG = 0x00000001
-CRYPT_DEFAULT_CONTEXT_PROCESS_FLAG = 0x00000002
-CRYPT_DEFAULT_CONTEXT_CERT_SIGN_OID = 1
-CRYPT_DEFAULT_CONTEXT_MULTI_CERT_SIGN_OID = 2
-CRYPT_OID_EXPORT_PUBLIC_KEY_INFO_FUNC = "CryptDllExportPublicKeyInfoEx"
-CRYPT_OID_IMPORT_PUBLIC_KEY_INFO_FUNC = "CryptDllImportPublicKeyInfoEx"
-CRYPT_ACQUIRE_CACHE_FLAG = 0x00000001
-CRYPT_ACQUIRE_USE_PROV_INFO_FLAG = 0x00000002
-CRYPT_ACQUIRE_COMPARE_KEY_FLAG = 0x00000004
-CRYPT_ACQUIRE_SILENT_FLAG = 0x00000040
-CRYPT_FIND_USER_KEYSET_FLAG = 0x00000001
-CRYPT_FIND_MACHINE_KEYSET_FLAG = 0x00000002
-CRYPT_FIND_SILENT_KEYSET_FLAG = 0x00000040
-CRYPT_OID_IMPORT_PRIVATE_KEY_INFO_FUNC = "CryptDllImportPrivateKeyInfoEx"
-CRYPT_OID_EXPORT_PRIVATE_KEY_INFO_FUNC = "CryptDllExportPrivateKeyInfoEx"
-CRYPT_DELETE_KEYSET = CRYPT_DELETEKEYSET
-CERT_SIMPLE_NAME_STR = 1
-CERT_OID_NAME_STR = 2
-CERT_X500_NAME_STR = 3
-CERT_NAME_STR_SEMICOLON_FLAG = 0x40000000
-CERT_NAME_STR_NO_PLUS_FLAG = 0x20000000
-CERT_NAME_STR_NO_QUOTING_FLAG = 0x10000000
-CERT_NAME_STR_CRLF_FLAG = 0x08000000
-CERT_NAME_STR_COMMA_FLAG = 0x04000000
-CERT_NAME_STR_REVERSE_FLAG = 0x02000000
-CERT_NAME_STR_DISABLE_IE4_UTF8_FLAG = 0x00010000
-CERT_NAME_STR_ENABLE_T61_UNICODE_FLAG = 0x00020000
-CERT_NAME_STR_ENABLE_UTF8_UNICODE_FLAG = 0x00040000
-CERT_NAME_EMAIL_TYPE = 1
-CERT_NAME_RDN_TYPE = 2
-CERT_NAME_ATTR_TYPE = 3
-CERT_NAME_SIMPLE_DISPLAY_TYPE = 4
-CERT_NAME_FRIENDLY_DISPLAY_TYPE = 5
-CERT_NAME_DNS_TYPE = 6
-CERT_NAME_URL_TYPE = 7
-CERT_NAME_UPN_TYPE = 8
-CERT_NAME_ISSUER_FLAG = 0x1
-CERT_NAME_DISABLE_IE4_UTF8_FLAG = 0x00010000
-CRYPT_MESSAGE_BARE_CONTENT_OUT_FLAG = 0x00000001
-CRYPT_MESSAGE_ENCAPSULATED_CONTENT_OUT_FLAG = 0x00000002
-CRYPT_MESSAGE_KEYID_SIGNER_FLAG = 0x00000004
-CRYPT_MESSAGE_SILENT_KEYSET_FLAG = 0x00000040
-CRYPT_MESSAGE_KEYID_RECIPIENT_FLAG = 0x4
-CERT_QUERY_OBJECT_FILE = 0x00000001
-CERT_QUERY_OBJECT_BLOB = 0x00000002
-CERT_QUERY_CONTENT_CERT = 1
-CERT_QUERY_CONTENT_CTL = 2
-CERT_QUERY_CONTENT_CRL = 3
-CERT_QUERY_CONTENT_SERIALIZED_STORE = 4
-CERT_QUERY_CONTENT_SERIALIZED_CERT = 5
-CERT_QUERY_CONTENT_SERIALIZED_CTL = 6
-CERT_QUERY_CONTENT_SERIALIZED_CRL = 7
-CERT_QUERY_CONTENT_PKCS7_SIGNED = 8
-CERT_QUERY_CONTENT_PKCS7_UNSIGNED = 9
-CERT_QUERY_CONTENT_PKCS7_SIGNED_EMBED = 10
-CERT_QUERY_CONTENT_PKCS10 = 11
-CERT_QUERY_CONTENT_PFX = 12
-CERT_QUERY_CONTENT_CERT_PAIR = 13
-CERT_QUERY_CONTENT_FLAG_CERT = 1 << CERT_QUERY_CONTENT_CERT
-CERT_QUERY_CONTENT_FLAG_CTL = 1 << CERT_QUERY_CONTENT_CTL
-CERT_QUERY_CONTENT_FLAG_CRL = 1 << CERT_QUERY_CONTENT_CRL
-CERT_QUERY_CONTENT_FLAG_SERIALIZED_STORE = 1 << CERT_QUERY_CONTENT_SERIALIZED_STORE
-CERT_QUERY_CONTENT_FLAG_SERIALIZED_CERT = 1 << CERT_QUERY_CONTENT_SERIALIZED_CERT
-CERT_QUERY_CONTENT_FLAG_SERIALIZED_CTL = 1 << CERT_QUERY_CONTENT_SERIALIZED_CTL
-CERT_QUERY_CONTENT_FLAG_SERIALIZED_CRL = 1 << CERT_QUERY_CONTENT_SERIALIZED_CRL
-CERT_QUERY_CONTENT_FLAG_PKCS7_SIGNED = 1 << CERT_QUERY_CONTENT_PKCS7_SIGNED
-CERT_QUERY_CONTENT_FLAG_PKCS7_UNSIGNED = 1 << CERT_QUERY_CONTENT_PKCS7_UNSIGNED
-CERT_QUERY_CONTENT_FLAG_PKCS7_SIGNED_EMBED = 1 << CERT_QUERY_CONTENT_PKCS7_SIGNED_EMBED
-CERT_QUERY_CONTENT_FLAG_PKCS10 = 1 << CERT_QUERY_CONTENT_PKCS10
-CERT_QUERY_CONTENT_FLAG_PFX = 1 << CERT_QUERY_CONTENT_PFX
-CERT_QUERY_CONTENT_FLAG_CERT_PAIR = 1 << CERT_QUERY_CONTENT_CERT_PAIR
-CERT_QUERY_CONTENT_FLAG_ALL = (
-    CERT_QUERY_CONTENT_FLAG_CERT
-    | CERT_QUERY_CONTENT_FLAG_CTL
-    | CERT_QUERY_CONTENT_FLAG_CRL
-    | CERT_QUERY_CONTENT_FLAG_SERIALIZED_STORE
-    | CERT_QUERY_CONTENT_FLAG_SERIALIZED_CERT
-    | CERT_QUERY_CONTENT_FLAG_SERIALIZED_CTL
-    | CERT_QUERY_CONTENT_FLAG_SERIALIZED_CRL
-    | CERT_QUERY_CONTENT_FLAG_PKCS7_SIGNED
-    | CERT_QUERY_CONTENT_FLAG_PKCS7_UNSIGNED
-    | CERT_QUERY_CONTENT_FLAG_PKCS7_SIGNED_EMBED
-    | CERT_QUERY_CONTENT_FLAG_PKCS10
-    | CERT_QUERY_CONTENT_FLAG_PFX
-    | CERT_QUERY_CONTENT_FLAG_CERT_PAIR
-)
-CERT_QUERY_FORMAT_BINARY = 1
-CERT_QUERY_FORMAT_BASE64_ENCODED = 2
-CERT_QUERY_FORMAT_ASN_ASCII_HEX_ENCODED = 3
-CERT_QUERY_FORMAT_FLAG_BINARY = 1 << CERT_QUERY_FORMAT_BINARY
-CERT_QUERY_FORMAT_FLAG_BASE64_ENCODED = 1 << CERT_QUERY_FORMAT_BASE64_ENCODED
-CERT_QUERY_FORMAT_FLAG_ASN_ASCII_HEX_ENCODED = (
-    1 << CERT_QUERY_FORMAT_ASN_ASCII_HEX_ENCODED
-)
-CERT_QUERY_FORMAT_FLAG_ALL = (
-    CERT_QUERY_FORMAT_FLAG_BINARY
-    | CERT_QUERY_FORMAT_FLAG_BASE64_ENCODED
-    | CERT_QUERY_FORMAT_FLAG_ASN_ASCII_HEX_ENCODED
-)
-
-CREDENTIAL_OID_PASSWORD_CREDENTIALS_A = 1
-CREDENTIAL_OID_PASSWORD_CREDENTIALS_W = 2
-CREDENTIAL_OID_PASSWORD_CREDENTIALS = CREDENTIAL_OID_PASSWORD_CREDENTIALS_W
-
-SCHEME_OID_RETRIEVE_ENCODED_OBJECT_FUNC = "SchemeDllRetrieveEncodedObject"
-SCHEME_OID_RETRIEVE_ENCODED_OBJECTW_FUNC = "SchemeDllRetrieveEncodedObjectW"
-CONTEXT_OID_CREATE_OBJECT_CONTEXT_FUNC = "ContextDllCreateObjectContext"
-CONTEXT_OID_CERTIFICATE = 1
-CONTEXT_OID_CRL = 2
-CONTEXT_OID_CTL = 3
-CONTEXT_OID_PKCS7 = 4
-CONTEXT_OID_CAPI2_ANY = 5
-CONTEXT_OID_OCSP_RESP = 6
-
-CRYPT_RETRIEVE_MULTIPLE_OBJECTS = 0x00000001
-CRYPT_CACHE_ONLY_RETRIEVAL = 0x00000002
-CRYPT_WIRE_ONLY_RETRIEVAL = 0x00000004
-CRYPT_DONT_CACHE_RESULT = 0x00000008
-CRYPT_ASYNC_RETRIEVAL = 0x00000010
-CRYPT_STICKY_CACHE_RETRIEVAL = 0x00001000
-CRYPT_LDAP_SCOPE_BASE_ONLY_RETRIEVAL = 0x00002000
-CRYPT_OFFLINE_CHECK_RETRIEVAL = 0x00004000
-CRYPT_LDAP_INSERT_ENTRY_ATTRIBUTE = 0x00008000
-CRYPT_LDAP_SIGN_RETRIEVAL = 0x00010000
-CRYPT_NO_AUTH_RETRIEVAL = 0x00020000
-CRYPT_LDAP_AREC_EXCLUSIVE_RETRIEVAL = 0x00040000
-CRYPT_AIA_RETRIEVAL = 0x00080000
-CRYPT_VERIFY_CONTEXT_SIGNATURE = 0x00000020
-CRYPT_VERIFY_DATA_HASH = 0x00000040
-CRYPT_KEEP_TIME_VALID = 0x00000080
-CRYPT_DONT_VERIFY_SIGNATURE = 0x00000100
-CRYPT_DONT_CHECK_TIME_VALIDITY = 0x00000200
-CRYPT_CHECK_FRESHNESS_TIME_VALIDITY = 0x00000400
-CRYPT_ACCUMULATIVE_TIMEOUT = 0x00000800
-CRYPT_PARAM_ASYNC_RETRIEVAL_COMPLETION = 1
-CRYPT_PARAM_CANCEL_ASYNC_RETRIEVAL = 2
-CRYPT_GET_URL_FROM_PROPERTY = 0x00000001
-CRYPT_GET_URL_FROM_EXTENSION = 0x00000002
-CRYPT_GET_URL_FROM_UNAUTH_ATTRIBUTE = 0x00000004
-CRYPT_GET_URL_FROM_AUTH_ATTRIBUTE = 0x00000008
-URL_OID_GET_OBJECT_URL_FUNC = "UrlDllGetObjectUrl"
-TIME_VALID_OID_GET_OBJECT_FUNC = "TimeValidDllGetObject"
-TIME_VALID_OID_FLUSH_OBJECT_FUNC = "TimeValidDllFlushObject"
-
-TIME_VALID_OID_GET_CTL = 1
-TIME_VALID_OID_GET_CRL = 2
-TIME_VALID_OID_GET_CRL_FROM_CERT = 3
-TIME_VALID_OID_GET_FRESHEST_CRL_FROM_CERT = 4
-TIME_VALID_OID_GET_FRESHEST_CRL_FROM_CRL = 5
-
-TIME_VALID_OID_FLUSH_CTL = 1
-TIME_VALID_OID_FLUSH_CRL = 2
-TIME_VALID_OID_FLUSH_CRL_FROM_CERT = 3
-TIME_VALID_OID_FLUSH_FRESHEST_CRL_FROM_CERT = 4
-TIME_VALID_OID_FLUSH_FRESHEST_CRL_FROM_CRL = 5
-
-CRYPTPROTECT_PROMPT_ON_UNPROTECT = 0x1
-CRYPTPROTECT_PROMPT_ON_PROTECT = 0x2
-CRYPTPROTECT_PROMPT_RESERVED = 0x04
-CRYPTPROTECT_PROMPT_STRONG = 0x08
-CRYPTPROTECT_PROMPT_REQUIRE_STRONG = 0x10
-CRYPTPROTECT_UI_FORBIDDEN = 0x1
-CRYPTPROTECT_LOCAL_MACHINE = 0x4
-CRYPTPROTECT_CRED_SYNC = 0x8
-CRYPTPROTECT_AUDIT = 0x10
-CRYPTPROTECT_NO_RECOVERY = 0x20
-CRYPTPROTECT_VERIFY_PROTECTION = 0x40
-CRYPTPROTECT_CRED_REGENERATE = 0x80
-CRYPTPROTECT_FIRST_RESERVED_FLAGVAL = 0x0FFFFFFF
-CRYPTPROTECT_LAST_RESERVED_FLAGVAL = -1
-CRYPTPROTECTMEMORY_BLOCK_SIZE = 16
-CRYPTPROTECTMEMORY_SAME_PROCESS = 0x00
-CRYPTPROTECTMEMORY_CROSS_PROCESS = 0x01
-CRYPTPROTECTMEMORY_SAME_LOGON = 0x02
-CERT_CREATE_SELFSIGN_NO_SIGN = 1
-CERT_CREATE_SELFSIGN_NO_KEY_INFO = 2
-CRYPT_KEYID_MACHINE_FLAG = 0x00000020
-CRYPT_KEYID_ALLOC_FLAG = 0x00008000
-CRYPT_KEYID_DELETE_FLAG = 0x00000010
-CRYPT_KEYID_SET_NEW_FLAG = 0x00002000
-CERT_CHAIN_MAX_AIA_URL_COUNT_IN_CERT_DEFAULT = 5
-CERT_CHAIN_MAX_AIA_URL_RETRIEVAL_COUNT_PER_CHAIN_DEFAULT = 10
-CERT_CHAIN_MAX_AIA_URL_RETRIEVAL_BYTE_COUNT_DEFAULT = 100000
-CERT_CHAIN_MAX_AIA_URL_RETRIEVAL_CERT_COUNT_DEFAULT = 10
-CERT_CHAIN_CACHE_END_CERT = 0x00000001
-CERT_CHAIN_THREAD_STORE_SYNC = 0x00000002
-CERT_CHAIN_CACHE_ONLY_URL_RETRIEVAL = 0x00000004
-CERT_CHAIN_USE_LOCAL_MACHINE_STORE = 0x00000008
-CERT_CHAIN_ENABLE_CACHE_AUTO_UPDATE = 0x00000010
-CERT_CHAIN_ENABLE_SHARE_STORE = 0x00000020
-CERT_TRUST_NO_ERROR = 0x00000000
-CERT_TRUST_IS_NOT_TIME_VALID = 0x00000001
-CERT_TRUST_IS_NOT_TIME_NESTED = 0x00000002
-CERT_TRUST_IS_REVOKED = 0x00000004
-CERT_TRUST_IS_NOT_SIGNATURE_VALID = 0x00000008
-CERT_TRUST_IS_NOT_VALID_FOR_USAGE = 0x00000010
-CERT_TRUST_IS_UNTRUSTED_ROOT = 0x00000020
-CERT_TRUST_REVOCATION_STATUS_UNKNOWN = 0x00000040
-CERT_TRUST_IS_CYCLIC = 0x00000080
-CERT_TRUST_INVALID_EXTENSION = 0x00000100
-CERT_TRUST_INVALID_POLICY_CONSTRAINTS = 0x00000200
-CERT_TRUST_INVALID_BASIC_CONSTRAINTS = 0x00000400
-CERT_TRUST_INVALID_NAME_CONSTRAINTS = 0x00000800
-CERT_TRUST_HAS_NOT_SUPPORTED_NAME_CONSTRAINT = 0x00001000
-CERT_TRUST_HAS_NOT_DEFINED_NAME_CONSTRAINT = 0x00002000
-CERT_TRUST_HAS_NOT_PERMITTED_NAME_CONSTRAINT = 0x00004000
-CERT_TRUST_HAS_EXCLUDED_NAME_CONSTRAINT = 0x00008000
-CERT_TRUST_IS_OFFLINE_REVOCATION = 0x01000000
-CERT_TRUST_NO_ISSUANCE_CHAIN_POLICY = 0x02000000
-CERT_TRUST_IS_PARTIAL_CHAIN = 0x00010000
-CERT_TRUST_CTL_IS_NOT_TIME_VALID = 0x00020000
-CERT_TRUST_CTL_IS_NOT_SIGNATURE_VALID = 0x00040000
-CERT_TRUST_CTL_IS_NOT_VALID_FOR_USAGE = 0x00080000
-CERT_TRUST_HAS_EXACT_MATCH_ISSUER = 0x00000001
-CERT_TRUST_HAS_KEY_MATCH_ISSUER = 0x00000002
-CERT_TRUST_HAS_NAME_MATCH_ISSUER = 0x00000004
-CERT_TRUST_IS_SELF_SIGNED = 0x00000008
-CERT_TRUST_HAS_PREFERRED_ISSUER = 0x00000100
-CERT_TRUST_HAS_ISSUANCE_CHAIN_POLICY = 0x00000200
-CERT_TRUST_HAS_VALID_NAME_CONSTRAINTS = 0x00000400
-CERT_TRUST_IS_COMPLEX_CHAIN = 0x00010000
-USAGE_MATCH_TYPE_AND = 0x00000000
-USAGE_MATCH_TYPE_OR = 0x00000001
-CERT_CHAIN_REVOCATION_CHECK_END_CERT = 0x10000000
-CERT_CHAIN_REVOCATION_CHECK_CHAIN = 0x20000000
-CERT_CHAIN_REVOCATION_CHECK_CHAIN_EXCLUDE_ROOT = 0x40000000
-CERT_CHAIN_REVOCATION_CHECK_CACHE_ONLY = -2147483648
-CERT_CHAIN_REVOCATION_ACCUMULATIVE_TIMEOUT = 0x08000000
-CERT_CHAIN_DISABLE_PASS1_QUALITY_FILTERING = 0x00000040
-CERT_CHAIN_RETURN_LOWER_QUALITY_CONTEXTS = 0x00000080
-CERT_CHAIN_DISABLE_AUTH_ROOT_AUTO_UPDATE = 0x00000100
-CERT_CHAIN_TIMESTAMP_TIME = 0x00000200
-REVOCATION_OID_CRL_REVOCATION = 1
-CERT_CHAIN_FIND_BY_ISSUER = 1
-CERT_CHAIN_FIND_BY_ISSUER_COMPARE_KEY_FLAG = 0x0001
-CERT_CHAIN_FIND_BY_ISSUER_COMPLEX_CHAIN_FLAG = 0x0002
-CERT_CHAIN_FIND_BY_ISSUER_CACHE_ONLY_URL_FLAG = 0x0004
-CERT_CHAIN_FIND_BY_ISSUER_LOCAL_MACHINE_FLAG = 0x0008
-CERT_CHAIN_FIND_BY_ISSUER_NO_KEY_FLAG = 0x4000
-CERT_CHAIN_FIND_BY_ISSUER_CACHE_ONLY_FLAG = 0x8000
-CERT_CHAIN_POLICY_IGNORE_NOT_TIME_VALID_FLAG = 0x00000001
-CERT_CHAIN_POLICY_IGNORE_CTL_NOT_TIME_VALID_FLAG = 0x00000002
-CERT_CHAIN_POLICY_IGNORE_NOT_TIME_NESTED_FLAG = 0x00000004
-CERT_CHAIN_POLICY_IGNORE_INVALID_BASIC_CONSTRAINTS_FLAG = 0x00000008
-CERT_CHAIN_POLICY_IGNORE_ALL_NOT_TIME_VALID_FLAGS = (
-    CERT_CHAIN_POLICY_IGNORE_NOT_TIME_VALID_FLAG
-    | CERT_CHAIN_POLICY_IGNORE_CTL_NOT_TIME_VALID_FLAG
-    | CERT_CHAIN_POLICY_IGNORE_NOT_TIME_NESTED_FLAG
-)
-CERT_CHAIN_POLICY_ALLOW_UNKNOWN_CA_FLAG = 0x00000010
-CERT_CHAIN_POLICY_IGNORE_WRONG_USAGE_FLAG = 0x00000020
-CERT_CHAIN_POLICY_IGNORE_INVALID_NAME_FLAG = 0x00000040
-CERT_CHAIN_POLICY_IGNORE_INVALID_POLICY_FLAG = 0x00000080
-CERT_CHAIN_POLICY_IGNORE_END_REV_UNKNOWN_FLAG = 0x00000100
-CERT_CHAIN_POLICY_IGNORE_CTL_SIGNER_REV_UNKNOWN_FLAG = 0x00000200
-CERT_CHAIN_POLICY_IGNORE_CA_REV_UNKNOWN_FLAG = 0x00000400
-CERT_CHAIN_POLICY_IGNORE_ROOT_REV_UNKNOWN_FLAG = 0x00000800
-CERT_CHAIN_POLICY_IGNORE_ALL_REV_UNKNOWN_FLAGS = (
-    CERT_CHAIN_POLICY_IGNORE_END_REV_UNKNOWN_FLAG
-    | CERT_CHAIN_POLICY_IGNORE_CTL_SIGNER_REV_UNKNOWN_FLAG
-    | CERT_CHAIN_POLICY_IGNORE_CA_REV_UNKNOWN_FLAG
-    | CERT_CHAIN_POLICY_IGNORE_ROOT_REV_UNKNOWN_FLAG
-)
-CERT_CHAIN_POLICY_ALLOW_TESTROOT_FLAG = 0x00008000
-CERT_CHAIN_POLICY_TRUST_TESTROOT_FLAG = 0x00004000
-CRYPT_OID_VERIFY_CERTIFICATE_CHAIN_POLICY_FUNC = "CertDllVerifyCertificateChainPolicy"
-AUTHTYPE_CLIENT = 1
-AUTHTYPE_SERVER = 2
-BASIC_CONSTRAINTS_CERT_CHAIN_POLICY_CA_FLAG = -2147483648
-BASIC_CONSTRAINTS_CERT_CHAIN_POLICY_END_ENTITY_FLAG = 0x40000000
-MICROSOFT_ROOT_CERT_CHAIN_POLICY_ENABLE_TEST_ROOT_FLAG = 0x00010000
-CRYPT_STRING_BASE64HEADER = 0x00000000
-CRYPT_STRING_BASE64 = 0x00000001
-CRYPT_STRING_BINARY = 0x00000002
-CRYPT_STRING_BASE64REQUESTHEADER = 0x00000003
-CRYPT_STRING_HEX = 0x00000004
-CRYPT_STRING_HEXASCII = 0x00000005
-CRYPT_STRING_BASE64_ANY = 0x00000006
-CRYPT_STRING_ANY = 0x00000007
-CRYPT_STRING_HEX_ANY = 0x00000008
-CRYPT_STRING_BASE64X509CRLHEADER = 0x00000009
-CRYPT_STRING_HEXADDR = 0x0000000A
-CRYPT_STRING_HEXASCIIADDR = 0x0000000B
-CRYPT_STRING_NOCR = -2147483648
-CRYPT_USER_KEYSET = 0x00001000
-PKCS12_IMPORT_RESERVED_MASK = -65536
-REPORT_NO_PRIVATE_KEY = 0x0001
-REPORT_NOT_ABLE_TO_EXPORT_PRIVATE_KEY = 0x0002
-EXPORT_PRIVATE_KEYS = 0x0004
-PKCS12_EXPORT_RESERVED_MASK = -65536
-
-# Certificate store provider types used with CertOpenStore
-CERT_STORE_PROV_MSG = 1
-CERT_STORE_PROV_MEMORY = 2
-CERT_STORE_PROV_FILE = 3
-CERT_STORE_PROV_REG = 4
-CERT_STORE_PROV_PKCS7 = 5
-CERT_STORE_PROV_SERIALIZED = 6
-CERT_STORE_PROV_FILENAME = 8
-CERT_STORE_PROV_SYSTEM = 10
-CERT_STORE_PROV_COLLECTION = 11
-CERT_STORE_PROV_SYSTEM_REGISTRY = 13
-CERT_STORE_PROV_PHYSICAL = 14
-CERT_STORE_PROV_SMART_CARD = 15
-CERT_STORE_PROV_LDAP = 16
-
-URL_OID_CERTIFICATE_ISSUER = 1
-URL_OID_CERTIFICATE_CRL_DIST_POINT = 2
-URL_OID_CTL_ISSUER = 3
-URL_OID_CTL_NEXT_UPDATE = 4
-URL_OID_CRL_ISSUER = 5
-URL_OID_CERTIFICATE_FRESHEST_CRL = 6
-URL_OID_CRL_FRESHEST_CRL = 7
-URL_OID_CROSS_CERT_DIST_POINT = 8
-URL_OID_CERTIFICATE_OCSP = 9
-URL_OID_CERTIFICATE_OCSP_AND_CRL_DIST_POINT = 10
-URL_OID_CERTIFICATE_CRL_DIST_POINT_AND_OCSP = 11
-URL_OID_CROSS_CERT_SUBJECT_INFO_ACCESS = 12
-URL_OID_CERTIFICATE_ONLY_OCSP = 13
diff --git a/lib/win32/lib/win32evtlogutil.py b/lib/win32/lib/win32evtlogutil.py
deleted file mode 100644
index 78e231c9..00000000
--- a/lib/win32/lib/win32evtlogutil.py
+++ /dev/null
@@ -1,229 +0,0 @@
-"""Event Log Utilities - helper for win32evtlog.pyd
-"""
-
-import win32api
-import win32con
-import win32evtlog
-import winerror
-
-error = win32api.error  # The error the evtlog module raises.
-
-langid = win32api.MAKELANGID(win32con.LANG_NEUTRAL, win32con.SUBLANG_NEUTRAL)
-
-
-def AddSourceToRegistry(
-    appName,
-    msgDLL=None,
-    eventLogType="Application",
-    eventLogFlags=None,
-    categoryDLL=None,
-    categoryCount=0,
-):
-    """Add a source of messages to the event log.
-
-    Allows Python program to register a custom source of messages in the
-    registry.  You must also provide the DLL name that has the message table, so the
-    full message text appears in the event log.
-
-    Note that the win32evtlog.pyd file has a number of string entries with just "%1"
-    built in, so many Python programs can simply use this DLL.  Disadvantages are that
-    you do not get language translation, and the full text is stored in the event log,
-    blowing the size of the log up.
-    """
-
-    # When an application uses the RegisterEventSource or OpenEventLog
-    # function to get a handle of an event log, the event logging service
-    # searches for the specified source name in the registry. You can add a
-    # new source name to the registry by opening a new registry subkey
-    # under the Application key and adding registry values to the new
-    # subkey.
-
-    if msgDLL is None:
-        msgDLL = win32evtlog.__file__
-    # Create a new key for our application
-    hkey = win32api.RegCreateKey(
-        win32con.HKEY_LOCAL_MACHINE,
-        "SYSTEM\\CurrentControlSet\\Services\\EventLog\\%s\\%s"
-        % (eventLogType, appName),
-    )
-
-    # Add the Event-ID message-file name to the subkey.
-    win32api.RegSetValueEx(
-        hkey,
-        "EventMessageFile",  # value name \
-        0,  # reserved \
-        win32con.REG_EXPAND_SZ,  # value type \
-        msgDLL,
-    )
-
-    # Set the supported types flags and add it to the subkey.
-    if eventLogFlags is None:
-        eventLogFlags = (
-            win32evtlog.EVENTLOG_ERROR_TYPE
-            | win32evtlog.EVENTLOG_WARNING_TYPE
-            | win32evtlog.EVENTLOG_INFORMATION_TYPE
-        )
-    win32api.RegSetValueEx(
-        hkey,  # subkey handle \
-        "TypesSupported",  # value name \
-        0,  # reserved \
-        win32con.REG_DWORD,  # value type \
-        eventLogFlags,
-    )
-
-    if categoryCount > 0:
-        # Optionally, you can specify a message file that contains the categories
-        if categoryDLL is None:
-            categoryDLL = win32evtlog.__file__
-        win32api.RegSetValueEx(
-            hkey,  # subkey handle \
-            "CategoryMessageFile",  # value name \
-            0,  # reserved \
-            win32con.REG_EXPAND_SZ,  # value type \
-            categoryDLL,
-        )
-
-        win32api.RegSetValueEx(
-            hkey,  # subkey handle \
-            "CategoryCount",  # value name \
-            0,  # reserved \
-            win32con.REG_DWORD,  # value type \
-            categoryCount,
-        )
-    win32api.RegCloseKey(hkey)
-
-
-def RemoveSourceFromRegistry(appName, eventLogType="Application"):
-    """Removes a source of messages from the event log."""
-
-    # Delete our key
-    try:
-        win32api.RegDeleteKey(
-            win32con.HKEY_LOCAL_MACHINE,
-            "SYSTEM\\CurrentControlSet\\Services\\EventLog\\%s\\%s"
-            % (eventLogType, appName),
-        )
-    except win32api.error as exc:
-        if exc.winerror != winerror.ERROR_FILE_NOT_FOUND:
-            raise
-
-
-def ReportEvent(
-    appName,
-    eventID,
-    eventCategory=0,
-    eventType=win32evtlog.EVENTLOG_ERROR_TYPE,
-    strings=None,
-    data=None,
-    sid=None,
-):
-    """Report an event for a previously added event source."""
-    # Get a handle to the Application event log
-    hAppLog = win32evtlog.RegisterEventSource(None, appName)
-
-    # Now report the event, which will add this event to the event log */
-    win32evtlog.ReportEvent(
-        hAppLog,  # event-log handle \
-        eventType,
-        eventCategory,
-        eventID,
-        sid,
-        strings,
-        data,
-    )
-
-    win32evtlog.DeregisterEventSource(hAppLog)
-
-
-def FormatMessage(eventLogRecord, logType="Application"):
-    """Given a tuple from ReadEventLog, and optionally where the event
-    record came from, load the message, and process message inserts.
-
-    Note that this function may raise win32api.error.  See also the
-    function SafeFormatMessage which will return None if the message can
-    not be processed.
-    """
-
-    # From the event log source name, we know the name of the registry
-    # key to look under for the name of the message DLL that contains
-    # the messages we need to extract with FormatMessage. So first get
-    # the event log source name...
-    keyName = "SYSTEM\\CurrentControlSet\\Services\\EventLog\\%s\\%s" % (
-        logType,
-        eventLogRecord.SourceName,
-    )
-
-    # Now open this key and get the EventMessageFile value, which is
-    # the name of the message DLL.
-    handle = win32api.RegOpenKey(win32con.HKEY_LOCAL_MACHINE, keyName)
-    try:
-        dllNames = win32api.RegQueryValueEx(handle, "EventMessageFile")[0].split(";")
-        # Win2k etc appear to allow multiple DLL names
-        data = None
-        for dllName in dllNames:
-            try:
-                # Expand environment variable strings in the message DLL path name,
-                # in case any are there.
-                dllName = win32api.ExpandEnvironmentStrings(dllName)
-
-                dllHandle = win32api.LoadLibraryEx(
-                    dllName, 0, win32con.LOAD_LIBRARY_AS_DATAFILE
-                )
-                try:
-                    data = win32api.FormatMessageW(
-                        win32con.FORMAT_MESSAGE_FROM_HMODULE,
-                        dllHandle,
-                        eventLogRecord.EventID,
-                        langid,
-                        eventLogRecord.StringInserts,
-                    )
-                finally:
-                    win32api.FreeLibrary(dllHandle)
-            except win32api.error:
-                pass  # Not in this DLL - try the next
-            if data is not None:
-                break
-    finally:
-        win32api.RegCloseKey(handle)
-    return data or ""  # Don't want "None" ever being returned.
-
-
-def SafeFormatMessage(eventLogRecord, logType=None):
-    """As for FormatMessage, except returns an error message if
-    the message can not be processed.
-    """
-    if logType is None:
-        logType = "Application"
-    try:
-        return FormatMessage(eventLogRecord, logType)
-    except win32api.error:
-        if eventLogRecord.StringInserts is None:
-            desc = ""
-        else:
-            desc = ", ".join(eventLogRecord.StringInserts)
-        return (
-            "<The description for Event ID ( %d ) in Source ( %r ) could not be found. It contains the following insertion string(s):%r.>"
-            % (
-                winerror.HRESULT_CODE(eventLogRecord.EventID),
-                eventLogRecord.SourceName,
-                desc,
-            )
-        )
-
-
-def FeedEventLogRecords(
-    feeder, machineName=None, logName="Application", readFlags=None
-):
-    if readFlags is None:
-        readFlags = (
-            win32evtlog.EVENTLOG_BACKWARDS_READ | win32evtlog.EVENTLOG_SEQUENTIAL_READ
-        )
-    h = win32evtlog.OpenEventLog(machineName, logName)
-    try:
-        while 1:
-            objects = win32evtlog.ReadEventLog(h, readFlags, 0)
-            if not objects:
-                break
-            map(lambda item, feeder=feeder: feeder(*(item,)), objects)
-    finally:
-        win32evtlog.CloseEventLog(h)
diff --git a/lib/win32/lib/win32gui_struct.py b/lib/win32/lib/win32gui_struct.py
deleted file mode 100644
index 86623ae3..00000000
--- a/lib/win32/lib/win32gui_struct.py
+++ /dev/null
@@ -1,999 +0,0 @@
-# This is a work in progress - see Demos/win32gui_menu.py
-
-# win32gui_struct.py - helpers for working with various win32gui structures.
-# As win32gui is "light-weight", it does not define objects for all possible
-# win32 structures - in general, "buffer" objects are passed around - it is
-# the callers responsibility to pack the buffer in the correct format.
-#
-# This module defines some helpers for the commonly used structures.
-#
-# In general, each structure has 3 functions:
-#
-# buffer, extras = PackSTRUCTURE(items, ...)
-# item, ... = UnpackSTRUCTURE(buffer)
-# buffer, extras = EmtpySTRUCTURE(...)
-#
-# 'extras' is always items that must be held along with the buffer, as the
-# buffer refers to these object's memory.
-# For structures that support a 'mask', this mask is hidden from the user - if
-# 'None' is passed, the mask flag will not be set, or on return, None will
-# be returned for the value if the mask is not set.
-#
-# NOTE: I considered making these structures look like real classes, and
-# support 'attributes' etc - however, ctypes already has a good structure
-# mechanism - I think it makes more sense to support ctype structures
-# at the win32gui level, then there will be no need for this module at all.
-# XXX - the above makes sense in terms of what is built and passed to
-# win32gui (ie, the Pack* functions) - but doesn't make as much sense for
-# the Unpack* functions, where the aim is user convenience.
-
-import array
-import struct
-import sys
-
-import commctrl
-import pywintypes
-import win32con
-import win32gui
-
-is64bit = "64 bit" in sys.version
-
-try:
-    from collections import namedtuple
-
-    def _MakeResult(names_str, values):
-        names = names_str.split()
-        nt = namedtuple(names[0], names[1:])
-        return nt(*values)
-
-except ImportError:
-    # no namedtuple support - just return the values as a normal tuple.
-    def _MakeResult(names_str, values):
-        return values
-
-
-_nmhdr_fmt = "PPi"
-if is64bit:
-    # When the item past the NMHDR gets aligned (eg, when it is a struct)
-    # we need this many bytes padding.
-    _nmhdr_align_padding = "xxxx"
-else:
-    _nmhdr_align_padding = ""
-
-# Encode a string suitable for passing in a win32gui related structure
-# If win32gui is built with UNICODE defined (ie, py3k), then functions
-# like InsertMenuItem are actually calling InsertMenuItemW etc, so all
-# strings will need to be unicode.
-if win32gui.UNICODE:
-
-    def _make_text_buffer(text):
-        # XXX - at this stage win32gui.UNICODE is only True in py3k,
-        # and in py3k is makes sense to reject bytes.
-        if not isinstance(text, str):
-            raise TypeError("MENUITEMINFO text must be unicode")
-        data = (text + "\0").encode("utf-16le")
-        return array.array("b", data)
-
-else:
-
-    def _make_text_buffer(text):
-        if isinstance(text, str):
-            text = text.encode("mbcs")
-        return array.array("b", text + "\0")
-
-
-# make an 'empty' buffer, ready for filling with cch characters.
-def _make_empty_text_buffer(cch):
-    return _make_text_buffer("\0" * cch)
-
-
-if sys.version_info < (3, 0):
-
-    def _make_memory(ob):
-        return str(buffer(ob))
-
-    def _make_bytes(sval):
-        return sval
-
-else:
-
-    def _make_memory(ob):
-        return bytes(memoryview(ob))
-
-    def _make_bytes(sval):
-        return sval.encode("ascii")
-
-
-# Generic WM_NOTIFY unpacking
-def UnpackWMNOTIFY(lparam):
-    format = "PPi"
-    buf = win32gui.PyGetMemory(lparam, struct.calcsize(format))
-    return _MakeResult("WMNOTIFY hwndFrom idFrom code", struct.unpack(format, buf))
-
-
-def UnpackNMITEMACTIVATE(lparam):
-    format = _nmhdr_fmt + _nmhdr_align_padding
-    if is64bit:
-        # the struct module doesn't handle this correctly as some of the items
-        # are actually structs in structs, which get individually aligned.
-        format = format + "iiiiiiixxxxP"
-    else:
-        format = format + "iiiiiiiP"
-    buf = win32gui.PyMakeBuffer(struct.calcsize(format), lparam)
-    return _MakeResult(
-        "NMITEMACTIVATE hwndFrom idFrom code iItem iSubItem uNewState uOldState uChanged actionx actiony lParam",
-        struct.unpack(format, buf),
-    )
-
-
-# MENUITEMINFO struct
-# http://msdn.microsoft.com/library/default.asp?url=/library/en-us/winui/WinUI/WindowsUserInterface/Resources/Menus/MenuReference/MenuStructures/MENUITEMINFO.asp
-# We use the struct module to pack and unpack strings as MENUITEMINFO
-# structures.  We also have special handling for the 'fMask' item in that
-# structure to avoid the caller needing to explicitly check validity
-# (None is used if the mask excludes/should exclude the value)
-_menuiteminfo_fmt = "5i5PiP"
-
-
-def PackMENUITEMINFO(
-    fType=None,
-    fState=None,
-    wID=None,
-    hSubMenu=None,
-    hbmpChecked=None,
-    hbmpUnchecked=None,
-    dwItemData=None,
-    text=None,
-    hbmpItem=None,
-    dwTypeData=None,
-):
-    # 'extras' are objects the caller must keep a reference to (as their
-    # memory is used) for the lifetime of the INFO item.
-    extras = []
-    # ack - dwItemData and dwTypeData were confused for a while...
-    assert (
-        dwItemData is None or dwTypeData is None
-    ), "sorry - these were confused - you probably want dwItemData"
-    # if we are a long way past 209, then we can nuke the above...
-    if dwTypeData is not None:
-        import warnings
-
-        warnings.warn("PackMENUITEMINFO: please use dwItemData instead of dwTypeData")
-    if dwItemData is None:
-        dwItemData = dwTypeData or 0
-
-    fMask = 0
-    if fType is None:
-        fType = 0
-    else:
-        fMask |= win32con.MIIM_FTYPE
-    if fState is None:
-        fState = 0
-    else:
-        fMask |= win32con.MIIM_STATE
-    if wID is None:
-        wID = 0
-    else:
-        fMask |= win32con.MIIM_ID
-    if hSubMenu is None:
-        hSubMenu = 0
-    else:
-        fMask |= win32con.MIIM_SUBMENU
-    if hbmpChecked is None:
-        assert hbmpUnchecked is None, "neither or both checkmark bmps must be given"
-        hbmpChecked = hbmpUnchecked = 0
-    else:
-        assert hbmpUnchecked is not None, "neither or both checkmark bmps must be given"
-        fMask |= win32con.MIIM_CHECKMARKS
-    if dwItemData is None:
-        dwItemData = 0
-    else:
-        fMask |= win32con.MIIM_DATA
-    if hbmpItem is None:
-        hbmpItem = 0
-    else:
-        fMask |= win32con.MIIM_BITMAP
-    if text is not None:
-        fMask |= win32con.MIIM_STRING
-        str_buf = _make_text_buffer(text)
-        cch = len(text)
-        # We are taking address of strbuf - it must not die until windows
-        # has finished with our structure.
-        lptext = str_buf.buffer_info()[0]
-        extras.append(str_buf)
-    else:
-        lptext = 0
-        cch = 0
-    # Create the struct.
-    # 'P' format does not accept PyHANDLE's !
-    item = struct.pack(
-        _menuiteminfo_fmt,
-        struct.calcsize(_menuiteminfo_fmt),  # cbSize
-        fMask,
-        fType,
-        fState,
-        wID,
-        int(hSubMenu),
-        int(hbmpChecked),
-        int(hbmpUnchecked),
-        dwItemData,
-        lptext,
-        cch,
-        int(hbmpItem),
-    )
-    # Now copy the string to a writable buffer, so that the result
-    # could be passed to a 'Get' function
-    return array.array("b", item), extras
-
-
-def UnpackMENUITEMINFO(s):
-    (
-        cb,
-        fMask,
-        fType,
-        fState,
-        wID,
-        hSubMenu,
-        hbmpChecked,
-        hbmpUnchecked,
-        dwItemData,
-        lptext,
-        cch,
-        hbmpItem,
-    ) = struct.unpack(_menuiteminfo_fmt, s)
-    assert cb == len(s)
-    if fMask & win32con.MIIM_FTYPE == 0:
-        fType = None
-    if fMask & win32con.MIIM_STATE == 0:
-        fState = None
-    if fMask & win32con.MIIM_ID == 0:
-        wID = None
-    if fMask & win32con.MIIM_SUBMENU == 0:
-        hSubMenu = None
-    if fMask & win32con.MIIM_CHECKMARKS == 0:
-        hbmpChecked = hbmpUnchecked = None
-    if fMask & win32con.MIIM_DATA == 0:
-        dwItemData = None
-    if fMask & win32con.MIIM_BITMAP == 0:
-        hbmpItem = None
-    if fMask & win32con.MIIM_STRING:
-        text = win32gui.PyGetString(lptext, cch)
-    else:
-        text = None
-    return _MakeResult(
-        "MENUITEMINFO fType fState wID hSubMenu hbmpChecked "
-        "hbmpUnchecked dwItemData text hbmpItem",
-        (
-            fType,
-            fState,
-            wID,
-            hSubMenu,
-            hbmpChecked,
-            hbmpUnchecked,
-            dwItemData,
-            text,
-            hbmpItem,
-        ),
-    )
-
-
-def EmptyMENUITEMINFO(mask=None, text_buf_size=512):
-    # text_buf_size is number of *characters* - not necessarily no of bytes.
-    extra = []
-    if mask is None:
-        mask = (
-            win32con.MIIM_BITMAP
-            | win32con.MIIM_CHECKMARKS
-            | win32con.MIIM_DATA
-            | win32con.MIIM_FTYPE
-            | win32con.MIIM_ID
-            | win32con.MIIM_STATE
-            | win32con.MIIM_STRING
-            | win32con.MIIM_SUBMENU
-        )
-        # Note: No MIIM_TYPE - this screws win2k/98.
-
-    if mask & win32con.MIIM_STRING:
-        text_buffer = _make_empty_text_buffer(text_buf_size)
-        extra.append(text_buffer)
-        text_addr, _ = text_buffer.buffer_info()
-    else:
-        text_addr = text_buf_size = 0
-
-    # Now copy the string to a writable buffer, so that the result
-    # could be passed to a 'Get' function
-    buf = struct.pack(
-        _menuiteminfo_fmt,
-        struct.calcsize(_menuiteminfo_fmt),  # cbSize
-        mask,
-        0,  # fType,
-        0,  # fState,
-        0,  # wID,
-        0,  # hSubMenu,
-        0,  # hbmpChecked,
-        0,  # hbmpUnchecked,
-        0,  # dwItemData,
-        text_addr,
-        text_buf_size,
-        0,  # hbmpItem
-    )
-    return array.array("b", buf), extra
-
-
-# MENUINFO struct
-_menuinfo_fmt = "iiiiPiP"
-
-
-def PackMENUINFO(
-    dwStyle=None,
-    cyMax=None,
-    hbrBack=None,
-    dwContextHelpID=None,
-    dwMenuData=None,
-    fMask=0,
-):
-    if dwStyle is None:
-        dwStyle = 0
-    else:
-        fMask |= win32con.MIM_STYLE
-    if cyMax is None:
-        cyMax = 0
-    else:
-        fMask |= win32con.MIM_MAXHEIGHT
-    if hbrBack is None:
-        hbrBack = 0
-    else:
-        fMask |= win32con.MIM_BACKGROUND
-    if dwContextHelpID is None:
-        dwContextHelpID = 0
-    else:
-        fMask |= win32con.MIM_HELPID
-    if dwMenuData is None:
-        dwMenuData = 0
-    else:
-        fMask |= win32con.MIM_MENUDATA
-    # Create the struct.
-    item = struct.pack(
-        _menuinfo_fmt,
-        struct.calcsize(_menuinfo_fmt),  # cbSize
-        fMask,
-        dwStyle,
-        cyMax,
-        hbrBack,
-        dwContextHelpID,
-        dwMenuData,
-    )
-    return array.array("b", item)
-
-
-def UnpackMENUINFO(s):
-    (cb, fMask, dwStyle, cyMax, hbrBack, dwContextHelpID, dwMenuData) = struct.unpack(
-        _menuinfo_fmt, s
-    )
-    assert cb == len(s)
-    if fMask & win32con.MIM_STYLE == 0:
-        dwStyle = None
-    if fMask & win32con.MIM_MAXHEIGHT == 0:
-        cyMax = None
-    if fMask & win32con.MIM_BACKGROUND == 0:
-        hbrBack = None
-    if fMask & win32con.MIM_HELPID == 0:
-        dwContextHelpID = None
-    if fMask & win32con.MIM_MENUDATA == 0:
-        dwMenuData = None
-    return _MakeResult(
-        "MENUINFO dwStyle cyMax hbrBack dwContextHelpID dwMenuData",
-        (dwStyle, cyMax, hbrBack, dwContextHelpID, dwMenuData),
-    )
-
-
-def EmptyMENUINFO(mask=None):
-    if mask is None:
-        mask = (
-            win32con.MIM_STYLE
-            | win32con.MIM_MAXHEIGHT
-            | win32con.MIM_BACKGROUND
-            | win32con.MIM_HELPID
-            | win32con.MIM_MENUDATA
-        )
-
-    buf = struct.pack(
-        _menuinfo_fmt,
-        struct.calcsize(_menuinfo_fmt),  # cbSize
-        mask,
-        0,  # dwStyle
-        0,  # cyMax
-        0,  # hbrBack,
-        0,  # dwContextHelpID,
-        0,  # dwMenuData,
-    )
-    return array.array("b", buf)
-
-
-##########################################################################
-#
-# Tree View structure support - TVITEM, TVINSERTSTRUCT and TVDISPINFO
-#
-##########################################################################
-
-# XXX - Note that the following implementation of TreeView structures is ripped
-# XXX - from the SpamBayes project.  It may not quite work correctly yet - I
-# XXX - intend checking them later - but having them is better than not at all!
-
-_tvitem_fmt = "iPiiPiiiiP"
-
-
-# Helpers for the ugly win32 structure packing/unpacking
-# XXX - Note that functions using _GetMaskAndVal run 3x faster if they are
-# 'inlined' into the function - see PackLVITEM.  If the profiler points at
-# _GetMaskAndVal(), you should nuke it (patches welcome once they have been
-# tested)
-def _GetMaskAndVal(val, default, mask, flag):
-    if val is None:
-        return mask, default
-    else:
-        if flag is not None:
-            mask |= flag
-        return mask, val
-
-
-def PackTVINSERTSTRUCT(parent, insertAfter, tvitem):
-    tvitem_buf, extra = PackTVITEM(*tvitem)
-    tvitem_buf = tvitem_buf.tobytes()
-    format = "PP%ds" % len(tvitem_buf)
-    return struct.pack(format, parent, insertAfter, tvitem_buf), extra
-
-
-def PackTVITEM(hitem, state, stateMask, text, image, selimage, citems, param):
-    extra = []  # objects we must keep references to
-    mask = 0
-    mask, hitem = _GetMaskAndVal(hitem, 0, mask, commctrl.TVIF_HANDLE)
-    mask, state = _GetMaskAndVal(state, 0, mask, commctrl.TVIF_STATE)
-    if not mask & commctrl.TVIF_STATE:
-        stateMask = 0
-    mask, text = _GetMaskAndVal(text, None, mask, commctrl.TVIF_TEXT)
-    mask, image = _GetMaskAndVal(image, 0, mask, commctrl.TVIF_IMAGE)
-    mask, selimage = _GetMaskAndVal(selimage, 0, mask, commctrl.TVIF_SELECTEDIMAGE)
-    mask, citems = _GetMaskAndVal(citems, 0, mask, commctrl.TVIF_CHILDREN)
-    mask, param = _GetMaskAndVal(param, 0, mask, commctrl.TVIF_PARAM)
-    if text is None:
-        text_addr = text_len = 0
-    else:
-        text_buffer = _make_text_buffer(text)
-        text_len = len(text)
-        extra.append(text_buffer)
-        text_addr, _ = text_buffer.buffer_info()
-    buf = struct.pack(
-        _tvitem_fmt,
-        mask,
-        hitem,
-        state,
-        stateMask,
-        text_addr,
-        text_len,  # text
-        image,
-        selimage,
-        citems,
-        param,
-    )
-    return array.array("b", buf), extra
-
-
-# Make a new buffer suitable for querying hitem's attributes.
-def EmptyTVITEM(hitem, mask=None, text_buf_size=512):
-    extra = []  # objects we must keep references to
-    if mask is None:
-        mask = (
-            commctrl.TVIF_HANDLE
-            | commctrl.TVIF_STATE
-            | commctrl.TVIF_TEXT
-            | commctrl.TVIF_IMAGE
-            | commctrl.TVIF_SELECTEDIMAGE
-            | commctrl.TVIF_CHILDREN
-            | commctrl.TVIF_PARAM
-        )
-    if mask & commctrl.TVIF_TEXT:
-        text_buffer = _make_empty_text_buffer(text_buf_size)
-        extra.append(text_buffer)
-        text_addr, _ = text_buffer.buffer_info()
-    else:
-        text_addr = text_buf_size = 0
-    buf = struct.pack(
-        _tvitem_fmt, mask, hitem, 0, 0, text_addr, text_buf_size, 0, 0, 0, 0  # text
-    )
-    return array.array("b", buf), extra
-
-
-def UnpackTVITEM(buffer):
-    (
-        item_mask,
-        item_hItem,
-        item_state,
-        item_stateMask,
-        item_textptr,
-        item_cchText,
-        item_image,
-        item_selimage,
-        item_cChildren,
-        item_param,
-    ) = struct.unpack(_tvitem_fmt, buffer)
-    # ensure only items listed by the mask are valid (except we assume the
-    # handle is always valid - some notifications (eg, TVN_ENDLABELEDIT) set a
-    # mask that doesn't include the handle, but the docs explicity say it is.)
-    if not (item_mask & commctrl.TVIF_TEXT):
-        item_textptr = item_cchText = None
-    if not (item_mask & commctrl.TVIF_CHILDREN):
-        item_cChildren = None
-    if not (item_mask & commctrl.TVIF_IMAGE):
-        item_image = None
-    if not (item_mask & commctrl.TVIF_PARAM):
-        item_param = None
-    if not (item_mask & commctrl.TVIF_SELECTEDIMAGE):
-        item_selimage = None
-    if not (item_mask & commctrl.TVIF_STATE):
-        item_state = item_stateMask = None
-
-    if item_textptr:
-        text = win32gui.PyGetString(item_textptr)
-    else:
-        text = None
-    return _MakeResult(
-        "TVITEM item_hItem item_state item_stateMask "
-        "text item_image item_selimage item_cChildren item_param",
-        (
-            item_hItem,
-            item_state,
-            item_stateMask,
-            text,
-            item_image,
-            item_selimage,
-            item_cChildren,
-            item_param,
-        ),
-    )
-
-
-# Unpack the lparm from a "TVNOTIFY" message
-def UnpackTVNOTIFY(lparam):
-    item_size = struct.calcsize(_tvitem_fmt)
-    format = _nmhdr_fmt + _nmhdr_align_padding
-    if is64bit:
-        format = format + "ixxxx"
-    else:
-        format = format + "i"
-    format = format + "%ds%ds" % (item_size, item_size)
-    buf = win32gui.PyGetMemory(lparam, struct.calcsize(format))
-    hwndFrom, id, code, action, buf_old, buf_new = struct.unpack(format, buf)
-    item_old = UnpackTVITEM(buf_old)
-    item_new = UnpackTVITEM(buf_new)
-    return _MakeResult(
-        "TVNOTIFY hwndFrom id code action item_old item_new",
-        (hwndFrom, id, code, action, item_old, item_new),
-    )
-
-
-def UnpackTVDISPINFO(lparam):
-    item_size = struct.calcsize(_tvitem_fmt)
-    format = "PPi%ds" % (item_size,)
-    buf = win32gui.PyGetMemory(lparam, struct.calcsize(format))
-    hwndFrom, id, code, buf_item = struct.unpack(format, buf)
-    item = UnpackTVITEM(buf_item)
-    return _MakeResult("TVDISPINFO hwndFrom id code item", (hwndFrom, id, code, item))
-
-
-#
-# List view items
-_lvitem_fmt = "iiiiiPiiPi"
-
-
-def PackLVITEM(
-    item=None,
-    subItem=None,
-    state=None,
-    stateMask=None,
-    text=None,
-    image=None,
-    param=None,
-    indent=None,
-):
-    extra = []  # objects we must keep references to
-    mask = 0
-    # _GetMaskAndVal adds quite a bit of overhead to this function.
-    if item is None:
-        item = 0  # No mask for item
-    if subItem is None:
-        subItem = 0  # No mask for sibItem
-    if state is None:
-        state = 0
-        stateMask = 0
-    else:
-        mask |= commctrl.LVIF_STATE
-        if stateMask is None:
-            stateMask = state
-
-    if image is None:
-        image = 0
-    else:
-        mask |= commctrl.LVIF_IMAGE
-    if param is None:
-        param = 0
-    else:
-        mask |= commctrl.LVIF_PARAM
-    if indent is None:
-        indent = 0
-    else:
-        mask |= commctrl.LVIF_INDENT
-
-    if text is None:
-        text_addr = text_len = 0
-    else:
-        mask |= commctrl.LVIF_TEXT
-        text_buffer = _make_text_buffer(text)
-        text_len = len(text)
-        extra.append(text_buffer)
-        text_addr, _ = text_buffer.buffer_info()
-    buf = struct.pack(
-        _lvitem_fmt,
-        mask,
-        item,
-        subItem,
-        state,
-        stateMask,
-        text_addr,
-        text_len,  # text
-        image,
-        param,
-        indent,
-    )
-    return array.array("b", buf), extra
-
-
-def UnpackLVITEM(buffer):
-    (
-        item_mask,
-        item_item,
-        item_subItem,
-        item_state,
-        item_stateMask,
-        item_textptr,
-        item_cchText,
-        item_image,
-        item_param,
-        item_indent,
-    ) = struct.unpack(_lvitem_fmt, buffer)
-    # ensure only items listed by the mask are valid
-    if not (item_mask & commctrl.LVIF_TEXT):
-        item_textptr = item_cchText = None
-    if not (item_mask & commctrl.LVIF_IMAGE):
-        item_image = None
-    if not (item_mask & commctrl.LVIF_PARAM):
-        item_param = None
-    if not (item_mask & commctrl.LVIF_INDENT):
-        item_indent = None
-    if not (item_mask & commctrl.LVIF_STATE):
-        item_state = item_stateMask = None
-
-    if item_textptr:
-        text = win32gui.PyGetString(item_textptr)
-    else:
-        text = None
-    return _MakeResult(
-        "LVITEM item_item item_subItem item_state "
-        "item_stateMask text item_image item_param item_indent",
-        (
-            item_item,
-            item_subItem,
-            item_state,
-            item_stateMask,
-            text,
-            item_image,
-            item_param,
-            item_indent,
-        ),
-    )
-
-
-# Unpack an "LVNOTIFY" message
-def UnpackLVDISPINFO(lparam):
-    item_size = struct.calcsize(_lvitem_fmt)
-    format = _nmhdr_fmt + _nmhdr_align_padding + ("%ds" % (item_size,))
-    buf = win32gui.PyGetMemory(lparam, struct.calcsize(format))
-    hwndFrom, id, code, buf_item = struct.unpack(format, buf)
-    item = UnpackLVITEM(buf_item)
-    return _MakeResult("LVDISPINFO hwndFrom id code item", (hwndFrom, id, code, item))
-
-
-def UnpackLVNOTIFY(lparam):
-    format = _nmhdr_fmt + _nmhdr_align_padding + "7i"
-    if is64bit:
-        format = format + "xxxx"  # point needs padding.
-    format = format + "P"
-    buf = win32gui.PyGetMemory(lparam, struct.calcsize(format))
-    (
-        hwndFrom,
-        id,
-        code,
-        item,
-        subitem,
-        newstate,
-        oldstate,
-        changed,
-        pt_x,
-        pt_y,
-        lparam,
-    ) = struct.unpack(format, buf)
-    return _MakeResult(
-        "UnpackLVNOTIFY hwndFrom id code item subitem "
-        "newstate oldstate changed pt lparam",
-        (
-            hwndFrom,
-            id,
-            code,
-            item,
-            subitem,
-            newstate,
-            oldstate,
-            changed,
-            (pt_x, pt_y),
-            lparam,
-        ),
-    )
-
-
-# Make a new buffer suitable for querying an items attributes.
-def EmptyLVITEM(item, subitem, mask=None, text_buf_size=512):
-    extra = []  # objects we must keep references to
-    if mask is None:
-        mask = (
-            commctrl.LVIF_IMAGE
-            | commctrl.LVIF_INDENT
-            | commctrl.LVIF_TEXT
-            | commctrl.LVIF_PARAM
-            | commctrl.LVIF_STATE
-        )
-    if mask & commctrl.LVIF_TEXT:
-        text_buffer = _make_empty_text_buffer(text_buf_size)
-        extra.append(text_buffer)
-        text_addr, _ = text_buffer.buffer_info()
-    else:
-        text_addr = text_buf_size = 0
-    buf = struct.pack(
-        _lvitem_fmt,
-        mask,
-        item,
-        subitem,
-        0,
-        0,
-        text_addr,
-        text_buf_size,  # text
-        0,
-        0,
-        0,
-    )
-    return array.array("b", buf), extra
-
-
-# List view column structure
-_lvcolumn_fmt = "iiiPiiii"
-
-
-def PackLVCOLUMN(fmt=None, cx=None, text=None, subItem=None, image=None, order=None):
-    extra = []  # objects we must keep references to
-    mask = 0
-    mask, fmt = _GetMaskAndVal(fmt, 0, mask, commctrl.LVCF_FMT)
-    mask, cx = _GetMaskAndVal(cx, 0, mask, commctrl.LVCF_WIDTH)
-    mask, text = _GetMaskAndVal(text, None, mask, commctrl.LVCF_TEXT)
-    mask, subItem = _GetMaskAndVal(subItem, 0, mask, commctrl.LVCF_SUBITEM)
-    mask, image = _GetMaskAndVal(image, 0, mask, commctrl.LVCF_IMAGE)
-    mask, order = _GetMaskAndVal(order, 0, mask, commctrl.LVCF_ORDER)
-    if text is None:
-        text_addr = text_len = 0
-    else:
-        text_buffer = _make_text_buffer(text)
-        extra.append(text_buffer)
-        text_addr, _ = text_buffer.buffer_info()
-        text_len = len(text)
-    buf = struct.pack(
-        _lvcolumn_fmt, mask, fmt, cx, text_addr, text_len, subItem, image, order  # text
-    )
-    return array.array("b", buf), extra
-
-
-def UnpackLVCOLUMN(lparam):
-    mask, fmt, cx, text_addr, text_size, subItem, image, order = struct.unpack(
-        _lvcolumn_fmt, lparam
-    )
-    # ensure only items listed by the mask are valid
-    if not (mask & commctrl.LVCF_FMT):
-        fmt = None
-    if not (mask & commctrl.LVCF_WIDTH):
-        cx = None
-    if not (mask & commctrl.LVCF_TEXT):
-        text_addr = text_size = None
-    if not (mask & commctrl.LVCF_SUBITEM):
-        subItem = None
-    if not (mask & commctrl.LVCF_IMAGE):
-        image = None
-    if not (mask & commctrl.LVCF_ORDER):
-        order = None
-    if text_addr:
-        text = win32gui.PyGetString(text_addr)
-    else:
-        text = None
-    return _MakeResult(
-        "LVCOLUMN fmt cx text subItem image order",
-        (fmt, cx, text, subItem, image, order),
-    )
-
-
-# Make a new buffer suitable for querying an items attributes.
-def EmptyLVCOLUMN(mask=None, text_buf_size=512):
-    extra = []  # objects we must keep references to
-    if mask is None:
-        mask = (
-            commctrl.LVCF_FMT
-            | commctrl.LVCF_WIDTH
-            | commctrl.LVCF_TEXT
-            | commctrl.LVCF_SUBITEM
-            | commctrl.LVCF_IMAGE
-            | commctrl.LVCF_ORDER
-        )
-    if mask & commctrl.LVCF_TEXT:
-        text_buffer = _make_empty_text_buffer(text_buf_size)
-        extra.append(text_buffer)
-        text_addr, _ = text_buffer.buffer_info()
-    else:
-        text_addr = text_buf_size = 0
-    buf = struct.pack(
-        _lvcolumn_fmt, mask, 0, 0, text_addr, text_buf_size, 0, 0, 0  # text
-    )
-    return array.array("b", buf), extra
-
-
-# List view hit-test.
-def PackLVHITTEST(pt):
-    format = "iiiii"
-    buf = struct.pack(format, pt[0], pt[1], 0, 0, 0)
-    return array.array("b", buf), None
-
-
-def UnpackLVHITTEST(buf):
-    format = "iiiii"
-    x, y, flags, item, subitem = struct.unpack(format, buf)
-    return _MakeResult(
-        "LVHITTEST pt flags item subitem", ((x, y), flags, item, subitem)
-    )
-
-
-def PackHDITEM(
-    cxy=None, text=None, hbm=None, fmt=None, param=None, image=None, order=None
-):
-    extra = []  # objects we must keep references to
-    mask = 0
-    mask, cxy = _GetMaskAndVal(cxy, 0, mask, commctrl.HDI_HEIGHT)
-    mask, text = _GetMaskAndVal(text, None, mask, commctrl.LVCF_TEXT)
-    mask, hbm = _GetMaskAndVal(hbm, 0, mask, commctrl.HDI_BITMAP)
-    mask, fmt = _GetMaskAndVal(fmt, 0, mask, commctrl.HDI_FORMAT)
-    mask, param = _GetMaskAndVal(param, 0, mask, commctrl.HDI_LPARAM)
-    mask, image = _GetMaskAndVal(image, 0, mask, commctrl.HDI_IMAGE)
-    mask, order = _GetMaskAndVal(order, 0, mask, commctrl.HDI_ORDER)
-
-    if text is None:
-        text_addr = text_len = 0
-    else:
-        text_buffer = _make_text_buffer(text)
-        extra.append(text_buffer)
-        text_addr, _ = text_buffer.buffer_info()
-        text_len = len(text)
-
-    format = "iiPPiiPiiii"
-    buf = struct.pack(
-        format, mask, cxy, text_addr, hbm, text_len, fmt, param, image, order, 0, 0
-    )
-    return array.array("b", buf), extra
-
-
-# Device notification stuff
-
-
-# Generic function for packing a DEV_BROADCAST_* structure - generally used
-# by the other PackDEV_BROADCAST_* functions in this module.
-def PackDEV_BROADCAST(devicetype, rest_fmt, rest_data, extra_data=_make_bytes("")):
-    # It seems a requirement is 4 byte alignment, even for the 'BYTE data[1]'
-    # field (eg, that would make DEV_BROADCAST_HANDLE 41 bytes, but we must
-    # be 44.
-    extra_data += _make_bytes("\0" * (4 - len(extra_data) % 4))
-    format = "iii" + rest_fmt
-    full_size = struct.calcsize(format) + len(extra_data)
-    data = (full_size, devicetype, 0) + rest_data
-    return struct.pack(format, *data) + extra_data
-
-
-def PackDEV_BROADCAST_HANDLE(
-    handle,
-    hdevnotify=0,
-    guid=_make_bytes("\0" * 16),
-    name_offset=0,
-    data=_make_bytes("\0"),
-):
-    return PackDEV_BROADCAST(
-        win32con.DBT_DEVTYP_HANDLE,
-        "PP16sl",
-        (int(handle), int(hdevnotify), _make_memory(guid), name_offset),
-        data,
-    )
-
-
-def PackDEV_BROADCAST_VOLUME(unitmask, flags):
-    return PackDEV_BROADCAST(win32con.DBT_DEVTYP_VOLUME, "II", (unitmask, flags))
-
-
-def PackDEV_BROADCAST_DEVICEINTERFACE(classguid, name=""):
-    if win32gui.UNICODE:
-        # This really means "is py3k?" - so not accepting bytes is OK
-        if not isinstance(name, str):
-            raise TypeError("Must provide unicode for the name")
-        name = name.encode("utf-16le")
-    else:
-        # py2k was passed a unicode object - encode as mbcs.
-        if isinstance(name, str):
-            name = name.encode("mbcs")
-
-    # 16 bytes for the IID followed by \0 term'd string.
-    rest_fmt = "16s%ds" % len(name)
-    # _make_memory(iid) hoops necessary to get the raw IID bytes.
-    rest_data = (_make_memory(pywintypes.IID(classguid)), name)
-    return PackDEV_BROADCAST(win32con.DBT_DEVTYP_DEVICEINTERFACE, rest_fmt, rest_data)
-
-
-# An object returned by UnpackDEV_BROADCAST.
-class DEV_BROADCAST_INFO:
-    def __init__(self, devicetype, **kw):
-        self.devicetype = devicetype
-        self.__dict__.update(kw)
-
-    def __str__(self):
-        return "DEV_BROADCAST_INFO:" + str(self.__dict__)
-
-
-# Support for unpacking the 'lparam'
-def UnpackDEV_BROADCAST(lparam):
-    if lparam == 0:
-        return None
-    hdr_format = "iii"
-    hdr_size = struct.calcsize(hdr_format)
-    hdr_buf = win32gui.PyGetMemory(lparam, hdr_size)
-    size, devtype, reserved = struct.unpack("iii", hdr_buf)
-    # Due to x64 alignment issues, we need to use the full format string over
-    # the entire buffer.  ie, on x64:
-    # calcsize('iiiP') != calcsize('iii')+calcsize('P')
-    buf = win32gui.PyGetMemory(lparam, size)
-
-    extra = x = {}
-    if devtype == win32con.DBT_DEVTYP_HANDLE:
-        # 2 handles, a GUID, a LONG and possibly an array following...
-        fmt = hdr_format + "PP16sl"
-        (
-            _,
-            _,
-            _,
-            x["handle"],
-            x["hdevnotify"],
-            guid_bytes,
-            x["nameoffset"],
-        ) = struct.unpack(fmt, buf[: struct.calcsize(fmt)])
-        x["eventguid"] = pywintypes.IID(guid_bytes, True)
-    elif devtype == win32con.DBT_DEVTYP_DEVICEINTERFACE:
-        fmt = hdr_format + "16s"
-        _, _, _, guid_bytes = struct.unpack(fmt, buf[: struct.calcsize(fmt)])
-        x["classguid"] = pywintypes.IID(guid_bytes, True)
-        x["name"] = win32gui.PyGetString(lparam + struct.calcsize(fmt))
-    elif devtype == win32con.DBT_DEVTYP_VOLUME:
-        # int mask and flags
-        fmt = hdr_format + "II"
-        _, _, _, x["unitmask"], x["flags"] = struct.unpack(
-            fmt, buf[: struct.calcsize(fmt)]
-        )
-    else:
-        raise NotImplementedError("unknown device type %d" % (devtype,))
-    return DEV_BROADCAST_INFO(devtype, **extra)
diff --git a/lib/win32/lib/win32inetcon.py b/lib/win32/lib/win32inetcon.py
deleted file mode 100644
index b6e8e672..00000000
--- a/lib/win32/lib/win32inetcon.py
+++ /dev/null
@@ -1,1086 +0,0 @@
-# Generated by h2py from \mssdk\include\WinInet.h
-
-INTERNET_INVALID_PORT_NUMBER = 0
-INTERNET_DEFAULT_PORT = 0
-INTERNET_DEFAULT_FTP_PORT = 21
-INTERNET_DEFAULT_GOPHER_PORT = 70
-INTERNET_DEFAULT_HTTP_PORT = 80
-INTERNET_DEFAULT_HTTPS_PORT = 443
-INTERNET_DEFAULT_SOCKS_PORT = 1080
-INTERNET_MAX_HOST_NAME_LENGTH = 256
-INTERNET_MAX_USER_NAME_LENGTH = 128
-INTERNET_MAX_PASSWORD_LENGTH = 128
-INTERNET_MAX_PORT_NUMBER_LENGTH = 5
-INTERNET_MAX_PORT_NUMBER_VALUE = 65535
-INTERNET_MAX_PATH_LENGTH = 2048
-INTERNET_MAX_SCHEME_LENGTH = 32
-INTERNET_KEEP_ALIVE_ENABLED = 1
-INTERNET_KEEP_ALIVE_DISABLED = 0
-INTERNET_REQFLAG_FROM_CACHE = 0x00000001
-INTERNET_REQFLAG_ASYNC = 0x00000002
-INTERNET_REQFLAG_VIA_PROXY = 0x00000004
-INTERNET_REQFLAG_NO_HEADERS = 0x00000008
-INTERNET_REQFLAG_PASSIVE = 0x00000010
-INTERNET_REQFLAG_CACHE_WRITE_DISABLED = 0x00000040
-INTERNET_REQFLAG_NET_TIMEOUT = 0x00000080
-INTERNET_FLAG_RELOAD = -2147483648
-INTERNET_FLAG_RAW_DATA = 0x40000000
-INTERNET_FLAG_EXISTING_CONNECT = 0x20000000
-INTERNET_FLAG_ASYNC = 0x10000000
-INTERNET_FLAG_PASSIVE = 0x08000000
-INTERNET_FLAG_NO_CACHE_WRITE = 0x04000000
-INTERNET_FLAG_DONT_CACHE = INTERNET_FLAG_NO_CACHE_WRITE
-INTERNET_FLAG_MAKE_PERSISTENT = 0x02000000
-INTERNET_FLAG_FROM_CACHE = 0x01000000
-INTERNET_FLAG_OFFLINE = INTERNET_FLAG_FROM_CACHE
-INTERNET_FLAG_SECURE = 0x00800000
-INTERNET_FLAG_KEEP_CONNECTION = 0x00400000
-INTERNET_FLAG_NO_AUTO_REDIRECT = 0x00200000
-INTERNET_FLAG_READ_PREFETCH = 0x00100000
-INTERNET_FLAG_NO_COOKIES = 0x00080000
-INTERNET_FLAG_NO_AUTH = 0x00040000
-INTERNET_FLAG_RESTRICTED_ZONE = 0x00020000
-INTERNET_FLAG_CACHE_IF_NET_FAIL = 0x00010000
-INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTP = 0x00008000
-INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTPS = 0x00004000
-INTERNET_FLAG_IGNORE_CERT_DATE_INVALID = 0x00002000
-INTERNET_FLAG_IGNORE_CERT_CN_INVALID = 0x00001000
-INTERNET_FLAG_RESYNCHRONIZE = 0x00000800
-INTERNET_FLAG_HYPERLINK = 0x00000400
-INTERNET_FLAG_NO_UI = 0x00000200
-INTERNET_FLAG_PRAGMA_NOCACHE = 0x00000100
-INTERNET_FLAG_CACHE_ASYNC = 0x00000080
-INTERNET_FLAG_FORMS_SUBMIT = 0x00000040
-INTERNET_FLAG_FWD_BACK = 0x00000020
-INTERNET_FLAG_NEED_FILE = 0x00000010
-INTERNET_FLAG_MUST_CACHE_REQUEST = INTERNET_FLAG_NEED_FILE
-SECURITY_INTERNET_MASK = (
-    INTERNET_FLAG_IGNORE_CERT_CN_INVALID
-    | INTERNET_FLAG_IGNORE_CERT_DATE_INVALID
-    | INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTPS
-    | INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTP
-)
-INTERNET_ERROR_MASK_INSERT_CDROM = 0x1
-INTERNET_ERROR_MASK_COMBINED_SEC_CERT = 0x2
-INTERNET_ERROR_MASK_NEED_MSN_SSPI_PKG = 0x4
-INTERNET_ERROR_MASK_LOGIN_FAILURE_DISPLAY_ENTITY_BODY = 0x8
-WININET_API_FLAG_ASYNC = 0x00000001
-WININET_API_FLAG_SYNC = 0x00000004
-WININET_API_FLAG_USE_CONTEXT = 0x00000008
-INTERNET_NO_CALLBACK = 0
-IDSI_FLAG_KEEP_ALIVE = 0x00000001
-IDSI_FLAG_SECURE = 0x00000002
-IDSI_FLAG_PROXY = 0x00000004
-IDSI_FLAG_TUNNEL = 0x00000008
-INTERNET_PER_CONN_FLAGS = 1
-INTERNET_PER_CONN_PROXY_SERVER = 2
-INTERNET_PER_CONN_PROXY_BYPASS = 3
-INTERNET_PER_CONN_AUTOCONFIG_URL = 4
-INTERNET_PER_CONN_AUTODISCOVERY_FLAGS = 5
-INTERNET_PER_CONN_AUTOCONFIG_SECONDARY_URL = 6
-INTERNET_PER_CONN_AUTOCONFIG_RELOAD_DELAY_MINS = 7
-INTERNET_PER_CONN_AUTOCONFIG_LAST_DETECT_TIME = 8
-INTERNET_PER_CONN_AUTOCONFIG_LAST_DETECT_URL = 9
-PROXY_TYPE_DIRECT = 0x00000001
-PROXY_TYPE_PROXY = 0x00000002
-PROXY_TYPE_AUTO_PROXY_URL = 0x00000004
-PROXY_TYPE_AUTO_DETECT = 0x00000008
-AUTO_PROXY_FLAG_USER_SET = 0x00000001
-AUTO_PROXY_FLAG_ALWAYS_DETECT = 0x00000002
-AUTO_PROXY_FLAG_DETECTION_RUN = 0x00000004
-AUTO_PROXY_FLAG_MIGRATED = 0x00000008
-AUTO_PROXY_FLAG_DONT_CACHE_PROXY_RESULT = 0x00000010
-AUTO_PROXY_FLAG_CACHE_INIT_RUN = 0x00000020
-AUTO_PROXY_FLAG_DETECTION_SUSPECT = 0x00000040
-ISO_FORCE_DISCONNECTED = 0x00000001
-INTERNET_RFC1123_FORMAT = 0
-INTERNET_RFC1123_BUFSIZE = 30
-ICU_ESCAPE = -2147483648
-ICU_ESCAPE_AUTHORITY = 0x00002000
-ICU_REJECT_USERPWD = 0x00004000
-ICU_USERNAME = 0x40000000
-ICU_NO_ENCODE = 0x20000000
-ICU_DECODE = 0x10000000
-ICU_NO_META = 0x08000000
-ICU_ENCODE_SPACES_ONLY = 0x04000000
-ICU_BROWSER_MODE = 0x02000000
-ICU_ENCODE_PERCENT = 0x00001000
-INTERNET_OPEN_TYPE_PRECONFIG = 0
-INTERNET_OPEN_TYPE_DIRECT = 1
-INTERNET_OPEN_TYPE_PROXY = 3
-INTERNET_OPEN_TYPE_PRECONFIG_WITH_NO_AUTOPROXY = 4
-PRE_CONFIG_INTERNET_ACCESS = INTERNET_OPEN_TYPE_PRECONFIG
-LOCAL_INTERNET_ACCESS = INTERNET_OPEN_TYPE_DIRECT
-CERN_PROXY_INTERNET_ACCESS = INTERNET_OPEN_TYPE_PROXY
-INTERNET_SERVICE_FTP = 1
-INTERNET_SERVICE_GOPHER = 2
-INTERNET_SERVICE_HTTP = 3
-IRF_ASYNC = WININET_API_FLAG_ASYNC
-IRF_SYNC = WININET_API_FLAG_SYNC
-IRF_USE_CONTEXT = WININET_API_FLAG_USE_CONTEXT
-IRF_NO_WAIT = 0x00000008
-ISO_GLOBAL = 0x00000001
-ISO_REGISTRY = 0x00000002
-ISO_VALID_FLAGS = ISO_GLOBAL | ISO_REGISTRY
-INTERNET_OPTION_CALLBACK = 1
-INTERNET_OPTION_CONNECT_TIMEOUT = 2
-INTERNET_OPTION_CONNECT_RETRIES = 3
-INTERNET_OPTION_CONNECT_BACKOFF = 4
-INTERNET_OPTION_SEND_TIMEOUT = 5
-INTERNET_OPTION_CONTROL_SEND_TIMEOUT = INTERNET_OPTION_SEND_TIMEOUT
-INTERNET_OPTION_RECEIVE_TIMEOUT = 6
-INTERNET_OPTION_CONTROL_RECEIVE_TIMEOUT = INTERNET_OPTION_RECEIVE_TIMEOUT
-INTERNET_OPTION_DATA_SEND_TIMEOUT = 7
-INTERNET_OPTION_DATA_RECEIVE_TIMEOUT = 8
-INTERNET_OPTION_HANDLE_TYPE = 9
-INTERNET_OPTION_LISTEN_TIMEOUT = 11
-INTERNET_OPTION_READ_BUFFER_SIZE = 12
-INTERNET_OPTION_WRITE_BUFFER_SIZE = 13
-INTERNET_OPTION_ASYNC_ID = 15
-INTERNET_OPTION_ASYNC_PRIORITY = 16
-INTERNET_OPTION_PARENT_HANDLE = 21
-INTERNET_OPTION_KEEP_CONNECTION = 22
-INTERNET_OPTION_REQUEST_FLAGS = 23
-INTERNET_OPTION_EXTENDED_ERROR = 24
-INTERNET_OPTION_OFFLINE_MODE = 26
-INTERNET_OPTION_CACHE_STREAM_HANDLE = 27
-INTERNET_OPTION_USERNAME = 28
-INTERNET_OPTION_PASSWORD = 29
-INTERNET_OPTION_ASYNC = 30
-INTERNET_OPTION_SECURITY_FLAGS = 31
-INTERNET_OPTION_SECURITY_CERTIFICATE_STRUCT = 32
-INTERNET_OPTION_DATAFILE_NAME = 33
-INTERNET_OPTION_URL = 34
-INTERNET_OPTION_SECURITY_CERTIFICATE = 35
-INTERNET_OPTION_SECURITY_KEY_BITNESS = 36
-INTERNET_OPTION_REFRESH = 37
-INTERNET_OPTION_PROXY = 38
-INTERNET_OPTION_SETTINGS_CHANGED = 39
-INTERNET_OPTION_VERSION = 40
-INTERNET_OPTION_USER_AGENT = 41
-INTERNET_OPTION_END_BROWSER_SESSION = 42
-INTERNET_OPTION_PROXY_USERNAME = 43
-INTERNET_OPTION_PROXY_PASSWORD = 44
-INTERNET_OPTION_CONTEXT_VALUE = 45
-INTERNET_OPTION_CONNECT_LIMIT = 46
-INTERNET_OPTION_SECURITY_SELECT_CLIENT_CERT = 47
-INTERNET_OPTION_POLICY = 48
-INTERNET_OPTION_DISCONNECTED_TIMEOUT = 49
-INTERNET_OPTION_CONNECTED_STATE = 50
-INTERNET_OPTION_IDLE_STATE = 51
-INTERNET_OPTION_OFFLINE_SEMANTICS = 52
-INTERNET_OPTION_SECONDARY_CACHE_KEY = 53
-INTERNET_OPTION_CALLBACK_FILTER = 54
-INTERNET_OPTION_CONNECT_TIME = 55
-INTERNET_OPTION_SEND_THROUGHPUT = 56
-INTERNET_OPTION_RECEIVE_THROUGHPUT = 57
-INTERNET_OPTION_REQUEST_PRIORITY = 58
-INTERNET_OPTION_HTTP_VERSION = 59
-INTERNET_OPTION_RESET_URLCACHE_SESSION = 60
-INTERNET_OPTION_ERROR_MASK = 62
-INTERNET_OPTION_FROM_CACHE_TIMEOUT = 63
-INTERNET_OPTION_BYPASS_EDITED_ENTRY = 64
-INTERNET_OPTION_DIAGNOSTIC_SOCKET_INFO = 67
-INTERNET_OPTION_CODEPAGE = 68
-INTERNET_OPTION_CACHE_TIMESTAMPS = 69
-INTERNET_OPTION_DISABLE_AUTODIAL = 70
-INTERNET_OPTION_MAX_CONNS_PER_SERVER = 73
-INTERNET_OPTION_MAX_CONNS_PER_1_0_SERVER = 74
-INTERNET_OPTION_PER_CONNECTION_OPTION = 75
-INTERNET_OPTION_DIGEST_AUTH_UNLOAD = 76
-INTERNET_OPTION_IGNORE_OFFLINE = 77
-INTERNET_OPTION_IDENTITY = 78
-INTERNET_OPTION_REMOVE_IDENTITY = 79
-INTERNET_OPTION_ALTER_IDENTITY = 80
-INTERNET_OPTION_SUPPRESS_BEHAVIOR = 81
-INTERNET_OPTION_AUTODIAL_MODE = 82
-INTERNET_OPTION_AUTODIAL_CONNECTION = 83
-INTERNET_OPTION_CLIENT_CERT_CONTEXT = 84
-INTERNET_OPTION_AUTH_FLAGS = 85
-INTERNET_OPTION_COOKIES_3RD_PARTY = 86
-INTERNET_OPTION_DISABLE_PASSPORT_AUTH = 87
-INTERNET_OPTION_SEND_UTF8_SERVERNAME_TO_PROXY = 88
-INTERNET_OPTION_EXEMPT_CONNECTION_LIMIT = 89
-INTERNET_OPTION_ENABLE_PASSPORT_AUTH = 90
-INTERNET_OPTION_HIBERNATE_INACTIVE_WORKER_THREADS = 91
-INTERNET_OPTION_ACTIVATE_WORKER_THREADS = 92
-INTERNET_OPTION_RESTORE_WORKER_THREAD_DEFAULTS = 93
-INTERNET_OPTION_SOCKET_SEND_BUFFER_LENGTH = 94
-INTERNET_OPTION_PROXY_SETTINGS_CHANGED = 95
-INTERNET_FIRST_OPTION = INTERNET_OPTION_CALLBACK
-INTERNET_LAST_OPTION = INTERNET_OPTION_PROXY_SETTINGS_CHANGED
-INTERNET_PRIORITY_FOREGROUND = 1000
-INTERNET_HANDLE_TYPE_INTERNET = 1
-INTERNET_HANDLE_TYPE_CONNECT_FTP = 2
-INTERNET_HANDLE_TYPE_CONNECT_GOPHER = 3
-INTERNET_HANDLE_TYPE_CONNECT_HTTP = 4
-INTERNET_HANDLE_TYPE_FTP_FIND = 5
-INTERNET_HANDLE_TYPE_FTP_FIND_HTML = 6
-INTERNET_HANDLE_TYPE_FTP_FILE = 7
-INTERNET_HANDLE_TYPE_FTP_FILE_HTML = 8
-INTERNET_HANDLE_TYPE_GOPHER_FIND = 9
-INTERNET_HANDLE_TYPE_GOPHER_FIND_HTML = 10
-INTERNET_HANDLE_TYPE_GOPHER_FILE = 11
-INTERNET_HANDLE_TYPE_GOPHER_FILE_HTML = 12
-INTERNET_HANDLE_TYPE_HTTP_REQUEST = 13
-INTERNET_HANDLE_TYPE_FILE_REQUEST = 14
-AUTH_FLAG_DISABLE_NEGOTIATE = 0x00000001
-AUTH_FLAG_ENABLE_NEGOTIATE = 0x00000002
-SECURITY_FLAG_SECURE = 0x00000001
-SECURITY_FLAG_STRENGTH_WEAK = 0x10000000
-SECURITY_FLAG_STRENGTH_MEDIUM = 0x40000000
-SECURITY_FLAG_STRENGTH_STRONG = 0x20000000
-SECURITY_FLAG_UNKNOWNBIT = -2147483648
-SECURITY_FLAG_FORTEZZA = 0x08000000
-SECURITY_FLAG_NORMALBITNESS = SECURITY_FLAG_STRENGTH_WEAK
-SECURITY_FLAG_SSL = 0x00000002
-SECURITY_FLAG_SSL3 = 0x00000004
-SECURITY_FLAG_PCT = 0x00000008
-SECURITY_FLAG_PCT4 = 0x00000010
-SECURITY_FLAG_IETFSSL4 = 0x00000020
-SECURITY_FLAG_40BIT = SECURITY_FLAG_STRENGTH_WEAK
-SECURITY_FLAG_128BIT = SECURITY_FLAG_STRENGTH_STRONG
-SECURITY_FLAG_56BIT = SECURITY_FLAG_STRENGTH_MEDIUM
-SECURITY_FLAG_IGNORE_REVOCATION = 0x00000080
-SECURITY_FLAG_IGNORE_UNKNOWN_CA = 0x00000100
-SECURITY_FLAG_IGNORE_WRONG_USAGE = 0x00000200
-SECURITY_FLAG_IGNORE_CERT_CN_INVALID = INTERNET_FLAG_IGNORE_CERT_CN_INVALID
-SECURITY_FLAG_IGNORE_CERT_DATE_INVALID = INTERNET_FLAG_IGNORE_CERT_DATE_INVALID
-SECURITY_FLAG_IGNORE_CERT_WRONG_USAGE = 0x00000200
-SECURITY_FLAG_IGNORE_REDIRECT_TO_HTTPS = INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTPS
-SECURITY_FLAG_IGNORE_REDIRECT_TO_HTTP = INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTP
-SECURITY_SET_MASK = (
-    SECURITY_FLAG_IGNORE_REVOCATION
-    | SECURITY_FLAG_IGNORE_UNKNOWN_CA
-    | SECURITY_FLAG_IGNORE_CERT_CN_INVALID
-    | SECURITY_FLAG_IGNORE_CERT_DATE_INVALID
-    | SECURITY_FLAG_IGNORE_WRONG_USAGE
-)
-AUTODIAL_MODE_NEVER = 1
-AUTODIAL_MODE_ALWAYS = 2
-AUTODIAL_MODE_NO_NETWORK_PRESENT = 4
-INTERNET_STATUS_RESOLVING_NAME = 10
-INTERNET_STATUS_NAME_RESOLVED = 11
-INTERNET_STATUS_CONNECTING_TO_SERVER = 20
-INTERNET_STATUS_CONNECTED_TO_SERVER = 21
-INTERNET_STATUS_SENDING_REQUEST = 30
-INTERNET_STATUS_REQUEST_SENT = 31
-INTERNET_STATUS_RECEIVING_RESPONSE = 40
-INTERNET_STATUS_RESPONSE_RECEIVED = 41
-INTERNET_STATUS_CTL_RESPONSE_RECEIVED = 42
-INTERNET_STATUS_PREFETCH = 43
-INTERNET_STATUS_CLOSING_CONNECTION = 50
-INTERNET_STATUS_CONNECTION_CLOSED = 51
-INTERNET_STATUS_HANDLE_CREATED = 60
-INTERNET_STATUS_HANDLE_CLOSING = 70
-INTERNET_STATUS_DETECTING_PROXY = 80
-INTERNET_STATUS_REQUEST_COMPLETE = 100
-INTERNET_STATUS_REDIRECT = 110
-INTERNET_STATUS_INTERMEDIATE_RESPONSE = 120
-INTERNET_STATUS_USER_INPUT_REQUIRED = 140
-INTERNET_STATUS_STATE_CHANGE = 200
-INTERNET_STATUS_COOKIE_SENT = 320
-INTERNET_STATUS_COOKIE_RECEIVED = 321
-INTERNET_STATUS_PRIVACY_IMPACTED = 324
-INTERNET_STATUS_P3P_HEADER = 325
-INTERNET_STATUS_P3P_POLICYREF = 326
-INTERNET_STATUS_COOKIE_HISTORY = 327
-INTERNET_STATE_CONNECTED = 0x00000001
-INTERNET_STATE_DISCONNECTED = 0x00000002
-INTERNET_STATE_DISCONNECTED_BY_USER = 0x00000010
-INTERNET_STATE_IDLE = 0x00000100
-INTERNET_STATE_BUSY = 0x00000200
-FTP_TRANSFER_TYPE_UNKNOWN = 0x00000000
-FTP_TRANSFER_TYPE_ASCII = 0x00000001
-FTP_TRANSFER_TYPE_BINARY = 0x00000002
-FTP_TRANSFER_TYPE_MASK = FTP_TRANSFER_TYPE_ASCII | FTP_TRANSFER_TYPE_BINARY
-MAX_GOPHER_DISPLAY_TEXT = 128
-MAX_GOPHER_SELECTOR_TEXT = 256
-MAX_GOPHER_HOST_NAME = INTERNET_MAX_HOST_NAME_LENGTH
-MAX_GOPHER_LOCATOR_LENGTH = (
-    1
-    + MAX_GOPHER_DISPLAY_TEXT
-    + 1
-    + MAX_GOPHER_SELECTOR_TEXT
-    + 1
-    + MAX_GOPHER_HOST_NAME
-    + 1
-    + INTERNET_MAX_PORT_NUMBER_LENGTH
-    + 1
-    + 1
-    + 2
-)
-GOPHER_TYPE_TEXT_FILE = 0x00000001
-GOPHER_TYPE_DIRECTORY = 0x00000002
-GOPHER_TYPE_CSO = 0x00000004
-GOPHER_TYPE_ERROR = 0x00000008
-GOPHER_TYPE_MAC_BINHEX = 0x00000010
-GOPHER_TYPE_DOS_ARCHIVE = 0x00000020
-GOPHER_TYPE_UNIX_UUENCODED = 0x00000040
-GOPHER_TYPE_INDEX_SERVER = 0x00000080
-GOPHER_TYPE_TELNET = 0x00000100
-GOPHER_TYPE_BINARY = 0x00000200
-GOPHER_TYPE_REDUNDANT = 0x00000400
-GOPHER_TYPE_TN3270 = 0x00000800
-GOPHER_TYPE_GIF = 0x00001000
-GOPHER_TYPE_IMAGE = 0x00002000
-GOPHER_TYPE_BITMAP = 0x00004000
-GOPHER_TYPE_MOVIE = 0x00008000
-GOPHER_TYPE_SOUND = 0x00010000
-GOPHER_TYPE_HTML = 0x00020000
-GOPHER_TYPE_PDF = 0x00040000
-GOPHER_TYPE_CALENDAR = 0x00080000
-GOPHER_TYPE_INLINE = 0x00100000
-GOPHER_TYPE_UNKNOWN = 0x20000000
-GOPHER_TYPE_ASK = 0x40000000
-GOPHER_TYPE_GOPHER_PLUS = -2147483648
-GOPHER_TYPE_FILE_MASK = (
-    GOPHER_TYPE_TEXT_FILE
-    | GOPHER_TYPE_MAC_BINHEX
-    | GOPHER_TYPE_DOS_ARCHIVE
-    | GOPHER_TYPE_UNIX_UUENCODED
-    | GOPHER_TYPE_BINARY
-    | GOPHER_TYPE_GIF
-    | GOPHER_TYPE_IMAGE
-    | GOPHER_TYPE_BITMAP
-    | GOPHER_TYPE_MOVIE
-    | GOPHER_TYPE_SOUND
-    | GOPHER_TYPE_HTML
-    | GOPHER_TYPE_PDF
-    | GOPHER_TYPE_CALENDAR
-    | GOPHER_TYPE_INLINE
-)
-MAX_GOPHER_CATEGORY_NAME = 128
-MAX_GOPHER_ATTRIBUTE_NAME = 128
-MIN_GOPHER_ATTRIBUTE_LENGTH = 256
-GOPHER_ATTRIBUTE_ID_BASE = -1412641792
-GOPHER_CATEGORY_ID_ALL = GOPHER_ATTRIBUTE_ID_BASE + 1
-GOPHER_CATEGORY_ID_INFO = GOPHER_ATTRIBUTE_ID_BASE + 2
-GOPHER_CATEGORY_ID_ADMIN = GOPHER_ATTRIBUTE_ID_BASE + 3
-GOPHER_CATEGORY_ID_VIEWS = GOPHER_ATTRIBUTE_ID_BASE + 4
-GOPHER_CATEGORY_ID_ABSTRACT = GOPHER_ATTRIBUTE_ID_BASE + 5
-GOPHER_CATEGORY_ID_VERONICA = GOPHER_ATTRIBUTE_ID_BASE + 6
-GOPHER_CATEGORY_ID_ASK = GOPHER_ATTRIBUTE_ID_BASE + 7
-GOPHER_CATEGORY_ID_UNKNOWN = GOPHER_ATTRIBUTE_ID_BASE + 8
-GOPHER_ATTRIBUTE_ID_ALL = GOPHER_ATTRIBUTE_ID_BASE + 9
-GOPHER_ATTRIBUTE_ID_ADMIN = GOPHER_ATTRIBUTE_ID_BASE + 10
-GOPHER_ATTRIBUTE_ID_MOD_DATE = GOPHER_ATTRIBUTE_ID_BASE + 11
-GOPHER_ATTRIBUTE_ID_TTL = GOPHER_ATTRIBUTE_ID_BASE + 12
-GOPHER_ATTRIBUTE_ID_SCORE = GOPHER_ATTRIBUTE_ID_BASE + 13
-GOPHER_ATTRIBUTE_ID_RANGE = GOPHER_ATTRIBUTE_ID_BASE + 14
-GOPHER_ATTRIBUTE_ID_SITE = GOPHER_ATTRIBUTE_ID_BASE + 15
-GOPHER_ATTRIBUTE_ID_ORG = GOPHER_ATTRIBUTE_ID_BASE + 16
-GOPHER_ATTRIBUTE_ID_LOCATION = GOPHER_ATTRIBUTE_ID_BASE + 17
-GOPHER_ATTRIBUTE_ID_GEOG = GOPHER_ATTRIBUTE_ID_BASE + 18
-GOPHER_ATTRIBUTE_ID_TIMEZONE = GOPHER_ATTRIBUTE_ID_BASE + 19
-GOPHER_ATTRIBUTE_ID_PROVIDER = GOPHER_ATTRIBUTE_ID_BASE + 20
-GOPHER_ATTRIBUTE_ID_VERSION = GOPHER_ATTRIBUTE_ID_BASE + 21
-GOPHER_ATTRIBUTE_ID_ABSTRACT = GOPHER_ATTRIBUTE_ID_BASE + 22
-GOPHER_ATTRIBUTE_ID_VIEW = GOPHER_ATTRIBUTE_ID_BASE + 23
-GOPHER_ATTRIBUTE_ID_TREEWALK = GOPHER_ATTRIBUTE_ID_BASE + 24
-GOPHER_ATTRIBUTE_ID_UNKNOWN = GOPHER_ATTRIBUTE_ID_BASE + 25
-HTTP_MAJOR_VERSION = 1
-HTTP_MINOR_VERSION = 0
-HTTP_VERSIONA = "HTTP/1.0"
-HTTP_VERSION = HTTP_VERSIONA
-HTTP_QUERY_MIME_VERSION = 0
-HTTP_QUERY_CONTENT_TYPE = 1
-HTTP_QUERY_CONTENT_TRANSFER_ENCODING = 2
-HTTP_QUERY_CONTENT_ID = 3
-HTTP_QUERY_CONTENT_DESCRIPTION = 4
-HTTP_QUERY_CONTENT_LENGTH = 5
-HTTP_QUERY_CONTENT_LANGUAGE = 6
-HTTP_QUERY_ALLOW = 7
-HTTP_QUERY_PUBLIC = 8
-HTTP_QUERY_DATE = 9
-HTTP_QUERY_EXPIRES = 10
-HTTP_QUERY_LAST_MODIFIED = 11
-HTTP_QUERY_MESSAGE_ID = 12
-HTTP_QUERY_URI = 13
-HTTP_QUERY_DERIVED_FROM = 14
-HTTP_QUERY_COST = 15
-HTTP_QUERY_LINK = 16
-HTTP_QUERY_PRAGMA = 17
-HTTP_QUERY_VERSION = 18
-HTTP_QUERY_STATUS_CODE = 19
-HTTP_QUERY_STATUS_TEXT = 20
-HTTP_QUERY_RAW_HEADERS = 21
-HTTP_QUERY_RAW_HEADERS_CRLF = 22
-HTTP_QUERY_CONNECTION = 23
-HTTP_QUERY_ACCEPT = 24
-HTTP_QUERY_ACCEPT_CHARSET = 25
-HTTP_QUERY_ACCEPT_ENCODING = 26
-HTTP_QUERY_ACCEPT_LANGUAGE = 27
-HTTP_QUERY_AUTHORIZATION = 28
-HTTP_QUERY_CONTENT_ENCODING = 29
-HTTP_QUERY_FORWARDED = 30
-HTTP_QUERY_FROM = 31
-HTTP_QUERY_IF_MODIFIED_SINCE = 32
-HTTP_QUERY_LOCATION = 33
-HTTP_QUERY_ORIG_URI = 34
-HTTP_QUERY_REFERER = 35
-HTTP_QUERY_RETRY_AFTER = 36
-HTTP_QUERY_SERVER = 37
-HTTP_QUERY_TITLE = 38
-HTTP_QUERY_USER_AGENT = 39
-HTTP_QUERY_WWW_AUTHENTICATE = 40
-HTTP_QUERY_PROXY_AUTHENTICATE = 41
-HTTP_QUERY_ACCEPT_RANGES = 42
-HTTP_QUERY_SET_COOKIE = 43
-HTTP_QUERY_COOKIE = 44
-HTTP_QUERY_REQUEST_METHOD = 45
-HTTP_QUERY_REFRESH = 46
-HTTP_QUERY_CONTENT_DISPOSITION = 47
-HTTP_QUERY_AGE = 48
-HTTP_QUERY_CACHE_CONTROL = 49
-HTTP_QUERY_CONTENT_BASE = 50
-HTTP_QUERY_CONTENT_LOCATION = 51
-HTTP_QUERY_CONTENT_MD5 = 52
-HTTP_QUERY_CONTENT_RANGE = 53
-HTTP_QUERY_ETAG = 54
-HTTP_QUERY_HOST = 55
-HTTP_QUERY_IF_MATCH = 56
-HTTP_QUERY_IF_NONE_MATCH = 57
-HTTP_QUERY_IF_RANGE = 58
-HTTP_QUERY_IF_UNMODIFIED_SINCE = 59
-HTTP_QUERY_MAX_FORWARDS = 60
-HTTP_QUERY_PROXY_AUTHORIZATION = 61
-HTTP_QUERY_RANGE = 62
-HTTP_QUERY_TRANSFER_ENCODING = 63
-HTTP_QUERY_UPGRADE = 64
-HTTP_QUERY_VARY = 65
-HTTP_QUERY_VIA = 66
-HTTP_QUERY_WARNING = 67
-HTTP_QUERY_EXPECT = 68
-HTTP_QUERY_PROXY_CONNECTION = 69
-HTTP_QUERY_UNLESS_MODIFIED_SINCE = 70
-HTTP_QUERY_ECHO_REQUEST = 71
-HTTP_QUERY_ECHO_REPLY = 72
-HTTP_QUERY_ECHO_HEADERS = 73
-HTTP_QUERY_ECHO_HEADERS_CRLF = 74
-HTTP_QUERY_PROXY_SUPPORT = 75
-HTTP_QUERY_AUTHENTICATION_INFO = 76
-HTTP_QUERY_PASSPORT_URLS = 77
-HTTP_QUERY_PASSPORT_CONFIG = 78
-HTTP_QUERY_MAX = 78
-HTTP_QUERY_CUSTOM = 65535
-HTTP_QUERY_FLAG_REQUEST_HEADERS = -2147483648
-HTTP_QUERY_FLAG_SYSTEMTIME = 0x40000000
-HTTP_QUERY_FLAG_NUMBER = 0x20000000
-HTTP_QUERY_FLAG_COALESCE = 0x10000000
-HTTP_QUERY_MODIFIER_FLAGS_MASK = (
-    HTTP_QUERY_FLAG_REQUEST_HEADERS
-    | HTTP_QUERY_FLAG_SYSTEMTIME
-    | HTTP_QUERY_FLAG_NUMBER
-    | HTTP_QUERY_FLAG_COALESCE
-)
-HTTP_QUERY_HEADER_MASK = ~HTTP_QUERY_MODIFIER_FLAGS_MASK
-HTTP_STATUS_CONTINUE = 100
-HTTP_STATUS_SWITCH_PROTOCOLS = 101
-HTTP_STATUS_OK = 200
-HTTP_STATUS_CREATED = 201
-HTTP_STATUS_ACCEPTED = 202
-HTTP_STATUS_PARTIAL = 203
-HTTP_STATUS_NO_CONTENT = 204
-HTTP_STATUS_RESET_CONTENT = 205
-HTTP_STATUS_PARTIAL_CONTENT = 206
-HTTP_STATUS_WEBDAV_MULTI_STATUS = 207
-HTTP_STATUS_AMBIGUOUS = 300
-HTTP_STATUS_MOVED = 301
-HTTP_STATUS_REDIRECT = 302
-HTTP_STATUS_REDIRECT_METHOD = 303
-HTTP_STATUS_NOT_MODIFIED = 304
-HTTP_STATUS_USE_PROXY = 305
-HTTP_STATUS_REDIRECT_KEEP_VERB = 307
-HTTP_STATUS_BAD_REQUEST = 400
-HTTP_STATUS_DENIED = 401
-HTTP_STATUS_PAYMENT_REQ = 402
-HTTP_STATUS_FORBIDDEN = 403
-HTTP_STATUS_NOT_FOUND = 404
-HTTP_STATUS_BAD_METHOD = 405
-HTTP_STATUS_NONE_ACCEPTABLE = 406
-HTTP_STATUS_PROXY_AUTH_REQ = 407
-HTTP_STATUS_REQUEST_TIMEOUT = 408
-HTTP_STATUS_CONFLICT = 409
-HTTP_STATUS_GONE = 410
-HTTP_STATUS_LENGTH_REQUIRED = 411
-HTTP_STATUS_PRECOND_FAILED = 412
-HTTP_STATUS_REQUEST_TOO_LARGE = 413
-HTTP_STATUS_URI_TOO_LONG = 414
-HTTP_STATUS_UNSUPPORTED_MEDIA = 415
-HTTP_STATUS_RETRY_WITH = 449
-HTTP_STATUS_SERVER_ERROR = 500
-HTTP_STATUS_NOT_SUPPORTED = 501
-HTTP_STATUS_BAD_GATEWAY = 502
-HTTP_STATUS_SERVICE_UNAVAIL = 503
-HTTP_STATUS_GATEWAY_TIMEOUT = 504
-HTTP_STATUS_VERSION_NOT_SUP = 505
-HTTP_STATUS_FIRST = HTTP_STATUS_CONTINUE
-HTTP_STATUS_LAST = HTTP_STATUS_VERSION_NOT_SUP
-HTTP_ADDREQ_INDEX_MASK = 0x0000FFFF
-HTTP_ADDREQ_FLAGS_MASK = -65536
-HTTP_ADDREQ_FLAG_ADD_IF_NEW = 0x10000000
-HTTP_ADDREQ_FLAG_ADD = 0x20000000
-HTTP_ADDREQ_FLAG_COALESCE_WITH_COMMA = 0x40000000
-HTTP_ADDREQ_FLAG_COALESCE_WITH_SEMICOLON = 0x01000000
-HTTP_ADDREQ_FLAG_COALESCE = HTTP_ADDREQ_FLAG_COALESCE_WITH_COMMA
-HTTP_ADDREQ_FLAG_REPLACE = -2147483648
-HSR_ASYNC = WININET_API_FLAG_ASYNC
-HSR_SYNC = WININET_API_FLAG_SYNC
-HSR_USE_CONTEXT = WININET_API_FLAG_USE_CONTEXT
-HSR_INITIATE = 0x00000008
-HSR_DOWNLOAD = 0x00000010
-HSR_CHUNKED = 0x00000020
-INTERNET_COOKIE_IS_SECURE = 0x01
-INTERNET_COOKIE_IS_SESSION = 0x02
-INTERNET_COOKIE_THIRD_PARTY = 0x10
-INTERNET_COOKIE_PROMPT_REQUIRED = 0x20
-INTERNET_COOKIE_EVALUATE_P3P = 0x40
-INTERNET_COOKIE_APPLY_P3P = 0x80
-INTERNET_COOKIE_P3P_ENABLED = 0x100
-INTERNET_COOKIE_IS_RESTRICTED = 0x200
-INTERNET_COOKIE_IE6 = 0x400
-INTERNET_COOKIE_IS_LEGACY = 0x800
-FLAG_ICC_FORCE_CONNECTION = 0x00000001
-FLAGS_ERROR_UI_FILTER_FOR_ERRORS = 0x01
-FLAGS_ERROR_UI_FLAGS_CHANGE_OPTIONS = 0x02
-FLAGS_ERROR_UI_FLAGS_GENERATE_DATA = 0x04
-FLAGS_ERROR_UI_FLAGS_NO_UI = 0x08
-FLAGS_ERROR_UI_SERIALIZE_DIALOGS = 0x10
-INTERNET_ERROR_BASE = 12000
-ERROR_INTERNET_OUT_OF_HANDLES = INTERNET_ERROR_BASE + 1
-ERROR_INTERNET_TIMEOUT = INTERNET_ERROR_BASE + 2
-ERROR_INTERNET_EXTENDED_ERROR = INTERNET_ERROR_BASE + 3
-ERROR_INTERNET_INTERNAL_ERROR = INTERNET_ERROR_BASE + 4
-ERROR_INTERNET_INVALID_URL = INTERNET_ERROR_BASE + 5
-ERROR_INTERNET_UNRECOGNIZED_SCHEME = INTERNET_ERROR_BASE + 6
-ERROR_INTERNET_NAME_NOT_RESOLVED = INTERNET_ERROR_BASE + 7
-ERROR_INTERNET_PROTOCOL_NOT_FOUND = INTERNET_ERROR_BASE + 8
-ERROR_INTERNET_INVALID_OPTION = INTERNET_ERROR_BASE + 9
-ERROR_INTERNET_BAD_OPTION_LENGTH = INTERNET_ERROR_BASE + 10
-ERROR_INTERNET_OPTION_NOT_SETTABLE = INTERNET_ERROR_BASE + 11
-ERROR_INTERNET_SHUTDOWN = INTERNET_ERROR_BASE + 12
-ERROR_INTERNET_INCORRECT_USER_NAME = INTERNET_ERROR_BASE + 13
-ERROR_INTERNET_INCORRECT_PASSWORD = INTERNET_ERROR_BASE + 14
-ERROR_INTERNET_LOGIN_FAILURE = INTERNET_ERROR_BASE + 15
-ERROR_INTERNET_INVALID_OPERATION = INTERNET_ERROR_BASE + 16
-ERROR_INTERNET_OPERATION_CANCELLED = INTERNET_ERROR_BASE + 17
-ERROR_INTERNET_INCORRECT_HANDLE_TYPE = INTERNET_ERROR_BASE + 18
-ERROR_INTERNET_INCORRECT_HANDLE_STATE = INTERNET_ERROR_BASE + 19
-ERROR_INTERNET_NOT_PROXY_REQUEST = INTERNET_ERROR_BASE + 20
-ERROR_INTERNET_REGISTRY_VALUE_NOT_FOUND = INTERNET_ERROR_BASE + 21
-ERROR_INTERNET_BAD_REGISTRY_PARAMETER = INTERNET_ERROR_BASE + 22
-ERROR_INTERNET_NO_DIRECT_ACCESS = INTERNET_ERROR_BASE + 23
-ERROR_INTERNET_NO_CONTEXT = INTERNET_ERROR_BASE + 24
-ERROR_INTERNET_NO_CALLBACK = INTERNET_ERROR_BASE + 25
-ERROR_INTERNET_REQUEST_PENDING = INTERNET_ERROR_BASE + 26
-ERROR_INTERNET_INCORRECT_FORMAT = INTERNET_ERROR_BASE + 27
-ERROR_INTERNET_ITEM_NOT_FOUND = INTERNET_ERROR_BASE + 28
-ERROR_INTERNET_CANNOT_CONNECT = INTERNET_ERROR_BASE + 29
-ERROR_INTERNET_CONNECTION_ABORTED = INTERNET_ERROR_BASE + 30
-ERROR_INTERNET_CONNECTION_RESET = INTERNET_ERROR_BASE + 31
-ERROR_INTERNET_FORCE_RETRY = INTERNET_ERROR_BASE + 32
-ERROR_INTERNET_INVALID_PROXY_REQUEST = INTERNET_ERROR_BASE + 33
-ERROR_INTERNET_NEED_UI = INTERNET_ERROR_BASE + 34
-ERROR_INTERNET_HANDLE_EXISTS = INTERNET_ERROR_BASE + 36
-ERROR_INTERNET_SEC_CERT_DATE_INVALID = INTERNET_ERROR_BASE + 37
-ERROR_INTERNET_SEC_CERT_CN_INVALID = INTERNET_ERROR_BASE + 38
-ERROR_INTERNET_HTTP_TO_HTTPS_ON_REDIR = INTERNET_ERROR_BASE + 39
-ERROR_INTERNET_HTTPS_TO_HTTP_ON_REDIR = INTERNET_ERROR_BASE + 40
-ERROR_INTERNET_MIXED_SECURITY = INTERNET_ERROR_BASE + 41
-ERROR_INTERNET_CHG_POST_IS_NON_SECURE = INTERNET_ERROR_BASE + 42
-ERROR_INTERNET_POST_IS_NON_SECURE = INTERNET_ERROR_BASE + 43
-ERROR_INTERNET_CLIENT_AUTH_CERT_NEEDED = INTERNET_ERROR_BASE + 44
-ERROR_INTERNET_INVALID_CA = INTERNET_ERROR_BASE + 45
-ERROR_INTERNET_CLIENT_AUTH_NOT_SETUP = INTERNET_ERROR_BASE + 46
-ERROR_INTERNET_ASYNC_THREAD_FAILED = INTERNET_ERROR_BASE + 47
-ERROR_INTERNET_REDIRECT_SCHEME_CHANGE = INTERNET_ERROR_BASE + 48
-ERROR_INTERNET_DIALOG_PENDING = INTERNET_ERROR_BASE + 49
-ERROR_INTERNET_RETRY_DIALOG = INTERNET_ERROR_BASE + 50
-ERROR_INTERNET_HTTPS_HTTP_SUBMIT_REDIR = INTERNET_ERROR_BASE + 52
-ERROR_INTERNET_INSERT_CDROM = INTERNET_ERROR_BASE + 53
-ERROR_INTERNET_FORTEZZA_LOGIN_NEEDED = INTERNET_ERROR_BASE + 54
-ERROR_INTERNET_SEC_CERT_ERRORS = INTERNET_ERROR_BASE + 55
-ERROR_INTERNET_SEC_CERT_NO_REV = INTERNET_ERROR_BASE + 56
-ERROR_INTERNET_SEC_CERT_REV_FAILED = INTERNET_ERROR_BASE + 57
-ERROR_FTP_TRANSFER_IN_PROGRESS = INTERNET_ERROR_BASE + 110
-ERROR_FTP_DROPPED = INTERNET_ERROR_BASE + 111
-ERROR_FTP_NO_PASSIVE_MODE = INTERNET_ERROR_BASE + 112
-ERROR_GOPHER_PROTOCOL_ERROR = INTERNET_ERROR_BASE + 130
-ERROR_GOPHER_NOT_FILE = INTERNET_ERROR_BASE + 131
-ERROR_GOPHER_DATA_ERROR = INTERNET_ERROR_BASE + 132
-ERROR_GOPHER_END_OF_DATA = INTERNET_ERROR_BASE + 133
-ERROR_GOPHER_INVALID_LOCATOR = INTERNET_ERROR_BASE + 134
-ERROR_GOPHER_INCORRECT_LOCATOR_TYPE = INTERNET_ERROR_BASE + 135
-ERROR_GOPHER_NOT_GOPHER_PLUS = INTERNET_ERROR_BASE + 136
-ERROR_GOPHER_ATTRIBUTE_NOT_FOUND = INTERNET_ERROR_BASE + 137
-ERROR_GOPHER_UNKNOWN_LOCATOR = INTERNET_ERROR_BASE + 138
-ERROR_HTTP_HEADER_NOT_FOUND = INTERNET_ERROR_BASE + 150
-ERROR_HTTP_DOWNLEVEL_SERVER = INTERNET_ERROR_BASE + 151
-ERROR_HTTP_INVALID_SERVER_RESPONSE = INTERNET_ERROR_BASE + 152
-ERROR_HTTP_INVALID_HEADER = INTERNET_ERROR_BASE + 153
-ERROR_HTTP_INVALID_QUERY_REQUEST = INTERNET_ERROR_BASE + 154
-ERROR_HTTP_HEADER_ALREADY_EXISTS = INTERNET_ERROR_BASE + 155
-ERROR_HTTP_REDIRECT_FAILED = INTERNET_ERROR_BASE + 156
-ERROR_HTTP_NOT_REDIRECTED = INTERNET_ERROR_BASE + 160
-ERROR_HTTP_COOKIE_NEEDS_CONFIRMATION = INTERNET_ERROR_BASE + 161
-ERROR_HTTP_COOKIE_DECLINED = INTERNET_ERROR_BASE + 162
-ERROR_HTTP_REDIRECT_NEEDS_CONFIRMATION = INTERNET_ERROR_BASE + 168
-ERROR_INTERNET_SECURITY_CHANNEL_ERROR = INTERNET_ERROR_BASE + 157
-ERROR_INTERNET_UNABLE_TO_CACHE_FILE = INTERNET_ERROR_BASE + 158
-ERROR_INTERNET_TCPIP_NOT_INSTALLED = INTERNET_ERROR_BASE + 159
-ERROR_INTERNET_DISCONNECTED = INTERNET_ERROR_BASE + 163
-ERROR_INTERNET_SERVER_UNREACHABLE = INTERNET_ERROR_BASE + 164
-ERROR_INTERNET_PROXY_SERVER_UNREACHABLE = INTERNET_ERROR_BASE + 165
-ERROR_INTERNET_BAD_AUTO_PROXY_SCRIPT = INTERNET_ERROR_BASE + 166
-ERROR_INTERNET_UNABLE_TO_DOWNLOAD_SCRIPT = INTERNET_ERROR_BASE + 167
-ERROR_INTERNET_SEC_INVALID_CERT = INTERNET_ERROR_BASE + 169
-ERROR_INTERNET_SEC_CERT_REVOKED = INTERNET_ERROR_BASE + 170
-ERROR_INTERNET_FAILED_DUETOSECURITYCHECK = INTERNET_ERROR_BASE + 171
-ERROR_INTERNET_NOT_INITIALIZED = INTERNET_ERROR_BASE + 172
-ERROR_INTERNET_NEED_MSN_SSPI_PKG = INTERNET_ERROR_BASE + 173
-ERROR_INTERNET_LOGIN_FAILURE_DISPLAY_ENTITY_BODY = INTERNET_ERROR_BASE + 174
-INTERNET_ERROR_LAST = ERROR_INTERNET_LOGIN_FAILURE_DISPLAY_ENTITY_BODY
-NORMAL_CACHE_ENTRY = 0x00000001
-STICKY_CACHE_ENTRY = 0x00000004
-EDITED_CACHE_ENTRY = 0x00000008
-TRACK_OFFLINE_CACHE_ENTRY = 0x00000010
-TRACK_ONLINE_CACHE_ENTRY = 0x00000020
-SPARSE_CACHE_ENTRY = 0x00010000
-COOKIE_CACHE_ENTRY = 0x00100000
-URLHISTORY_CACHE_ENTRY = 0x00200000
-URLCACHE_FIND_DEFAULT_FILTER = (
-    NORMAL_CACHE_ENTRY
-    | COOKIE_CACHE_ENTRY
-    | URLHISTORY_CACHE_ENTRY
-    | TRACK_OFFLINE_CACHE_ENTRY
-    | TRACK_ONLINE_CACHE_ENTRY
-    | STICKY_CACHE_ENTRY
-)
-CACHEGROUP_ATTRIBUTE_GET_ALL = -1
-CACHEGROUP_ATTRIBUTE_BASIC = 0x00000001
-CACHEGROUP_ATTRIBUTE_FLAG = 0x00000002
-CACHEGROUP_ATTRIBUTE_TYPE = 0x00000004
-CACHEGROUP_ATTRIBUTE_QUOTA = 0x00000008
-CACHEGROUP_ATTRIBUTE_GROUPNAME = 0x00000010
-CACHEGROUP_ATTRIBUTE_STORAGE = 0x00000020
-CACHEGROUP_FLAG_NONPURGEABLE = 0x00000001
-CACHEGROUP_FLAG_GIDONLY = 0x00000004
-CACHEGROUP_FLAG_FLUSHURL_ONDELETE = 0x00000002
-CACHEGROUP_SEARCH_ALL = 0x00000000
-CACHEGROUP_SEARCH_BYURL = 0x00000001
-CACHEGROUP_TYPE_INVALID = 0x00000001
-CACHEGROUP_READWRITE_MASK = (
-    CACHEGROUP_ATTRIBUTE_TYPE
-    | CACHEGROUP_ATTRIBUTE_QUOTA
-    | CACHEGROUP_ATTRIBUTE_GROUPNAME
-    | CACHEGROUP_ATTRIBUTE_STORAGE
-)
-GROUPNAME_MAX_LENGTH = 120
-GROUP_OWNER_STORAGE_SIZE = 4
-CACHE_ENTRY_ATTRIBUTE_FC = 0x00000004
-CACHE_ENTRY_HITRATE_FC = 0x00000010
-CACHE_ENTRY_MODTIME_FC = 0x00000040
-CACHE_ENTRY_EXPTIME_FC = 0x00000080
-CACHE_ENTRY_ACCTIME_FC = 0x00000100
-CACHE_ENTRY_SYNCTIME_FC = 0x00000200
-CACHE_ENTRY_HEADERINFO_FC = 0x00000400
-CACHE_ENTRY_EXEMPT_DELTA_FC = 0x00000800
-INTERNET_CACHE_GROUP_ADD = 0
-INTERNET_CACHE_GROUP_REMOVE = 1
-INTERNET_DIAL_FORCE_PROMPT = 0x2000
-INTERNET_DIAL_SHOW_OFFLINE = 0x4000
-INTERNET_DIAL_UNATTENDED = 0x8000
-INTERENT_GOONLINE_REFRESH = 0x00000001
-INTERENT_GOONLINE_MASK = 0x00000001
-INTERNET_AUTODIAL_FORCE_ONLINE = 1
-INTERNET_AUTODIAL_FORCE_UNATTENDED = 2
-INTERNET_AUTODIAL_FAILIFSECURITYCHECK = 4
-INTERNET_AUTODIAL_OVERRIDE_NET_PRESENT = 8
-INTERNET_AUTODIAL_FLAGS_MASK = (
-    INTERNET_AUTODIAL_FORCE_ONLINE
-    | INTERNET_AUTODIAL_FORCE_UNATTENDED
-    | INTERNET_AUTODIAL_FAILIFSECURITYCHECK
-    | INTERNET_AUTODIAL_OVERRIDE_NET_PRESENT
-)
-PROXY_AUTO_DETECT_TYPE_DHCP = 1
-PROXY_AUTO_DETECT_TYPE_DNS_A = 2
-INTERNET_CONNECTION_MODEM = 0x01
-INTERNET_CONNECTION_LAN = 0x02
-INTERNET_CONNECTION_PROXY = 0x04
-INTERNET_CONNECTION_MODEM_BUSY = 0x08
-INTERNET_RAS_INSTALLED = 0x10
-INTERNET_CONNECTION_OFFLINE = 0x20
-INTERNET_CONNECTION_CONFIGURED = 0x40
-INTERNET_CUSTOMDIAL_CONNECT = 0
-INTERNET_CUSTOMDIAL_UNATTENDED = 1
-INTERNET_CUSTOMDIAL_DISCONNECT = 2
-INTERNET_CUSTOMDIAL_SHOWOFFLINE = 4
-INTERNET_CUSTOMDIAL_SAFE_FOR_UNATTENDED = 1
-INTERNET_CUSTOMDIAL_WILL_SUPPLY_STATE = 2
-INTERNET_CUSTOMDIAL_CAN_HANGUP = 4
-INTERNET_DIALSTATE_DISCONNECTED = 1
-INTERNET_IDENTITY_FLAG_PRIVATE_CACHE = 0x01
-INTERNET_IDENTITY_FLAG_SHARED_CACHE = 0x02
-INTERNET_IDENTITY_FLAG_CLEAR_DATA = 0x04
-INTERNET_IDENTITY_FLAG_CLEAR_COOKIES = 0x08
-INTERNET_IDENTITY_FLAG_CLEAR_HISTORY = 0x10
-INTERNET_IDENTITY_FLAG_CLEAR_CONTENT = 0x20
-INTERNET_SUPPRESS_RESET_ALL = 0x00
-INTERNET_SUPPRESS_COOKIE_POLICY = 0x01
-INTERNET_SUPPRESS_COOKIE_POLICY_RESET = 0x02
-PRIVACY_TEMPLATE_NO_COOKIES = 0
-PRIVACY_TEMPLATE_HIGH = 1
-PRIVACY_TEMPLATE_MEDIUM_HIGH = 2
-PRIVACY_TEMPLATE_MEDIUM = 3
-PRIVACY_TEMPLATE_MEDIUM_LOW = 4
-PRIVACY_TEMPLATE_LOW = 5
-PRIVACY_TEMPLATE_CUSTOM = 100
-PRIVACY_TEMPLATE_ADVANCED = 101
-PRIVACY_TEMPLATE_MAX = PRIVACY_TEMPLATE_LOW
-PRIVACY_TYPE_FIRST_PARTY = 0
-PRIVACY_TYPE_THIRD_PARTY = 1
-
-# Generated by h2py from winhttp.h
-WINHTTP_FLAG_ASYNC = 0x10000000
-WINHTTP_FLAG_SECURE = 0x00800000
-WINHTTP_FLAG_ESCAPE_PERCENT = 0x00000004
-WINHTTP_FLAG_NULL_CODEPAGE = 0x00000008
-WINHTTP_FLAG_BYPASS_PROXY_CACHE = 0x00000100
-WINHTTP_FLAG_REFRESH = WINHTTP_FLAG_BYPASS_PROXY_CACHE
-WINHTTP_FLAG_ESCAPE_DISABLE = 0x00000040
-WINHTTP_FLAG_ESCAPE_DISABLE_QUERY = 0x00000080
-INTERNET_SCHEME_HTTP = 1
-INTERNET_SCHEME_HTTPS = 2
-WINHTTP_AUTOPROXY_AUTO_DETECT = 0x00000001
-WINHTTP_AUTOPROXY_CONFIG_URL = 0x00000002
-WINHTTP_AUTOPROXY_RUN_INPROCESS = 0x00010000
-WINHTTP_AUTOPROXY_RUN_OUTPROCESS_ONLY = 0x00020000
-WINHTTP_AUTO_DETECT_TYPE_DHCP = 0x00000001
-WINHTTP_AUTO_DETECT_TYPE_DNS_A = 0x00000002
-WINHTTP_TIME_FORMAT_BUFSIZE = 62
-WINHTTP_ACCESS_TYPE_DEFAULT_PROXY = 0
-WINHTTP_ACCESS_TYPE_NO_PROXY = 1
-WINHTTP_ACCESS_TYPE_NAMED_PROXY = 3
-WINHTTP_OPTION_CALLBACK = 1
-WINHTTP_OPTION_RESOLVE_TIMEOUT = 2
-WINHTTP_OPTION_CONNECT_TIMEOUT = 3
-WINHTTP_OPTION_CONNECT_RETRIES = 4
-WINHTTP_OPTION_SEND_TIMEOUT = 5
-WINHTTP_OPTION_RECEIVE_TIMEOUT = 6
-WINHTTP_OPTION_RECEIVE_RESPONSE_TIMEOUT = 7
-WINHTTP_OPTION_HANDLE_TYPE = 9
-WINHTTP_OPTION_READ_BUFFER_SIZE = 12
-WINHTTP_OPTION_WRITE_BUFFER_SIZE = 13
-WINHTTP_OPTION_PARENT_HANDLE = 21
-WINHTTP_OPTION_EXTENDED_ERROR = 24
-WINHTTP_OPTION_SECURITY_FLAGS = 31
-WINHTTP_OPTION_SECURITY_CERTIFICATE_STRUCT = 32
-WINHTTP_OPTION_URL = 34
-WINHTTP_OPTION_SECURITY_KEY_BITNESS = 36
-WINHTTP_OPTION_PROXY = 38
-WINHTTP_OPTION_USER_AGENT = 41
-WINHTTP_OPTION_CONTEXT_VALUE = 45
-WINHTTP_OPTION_CLIENT_CERT_CONTEXT = 47
-WINHTTP_OPTION_REQUEST_PRIORITY = 58
-WINHTTP_OPTION_HTTP_VERSION = 59
-WINHTTP_OPTION_DISABLE_FEATURE = 63
-WINHTTP_OPTION_CODEPAGE = 68
-WINHTTP_OPTION_MAX_CONNS_PER_SERVER = 73
-WINHTTP_OPTION_MAX_CONNS_PER_1_0_SERVER = 74
-WINHTTP_OPTION_AUTOLOGON_POLICY = 77
-WINHTTP_OPTION_SERVER_CERT_CONTEXT = 78
-WINHTTP_OPTION_ENABLE_FEATURE = 79
-WINHTTP_OPTION_WORKER_THREAD_COUNT = 80
-WINHTTP_OPTION_PASSPORT_COBRANDING_TEXT = 81
-WINHTTP_OPTION_PASSPORT_COBRANDING_URL = 82
-WINHTTP_OPTION_CONFIGURE_PASSPORT_AUTH = 83
-WINHTTP_OPTION_SECURE_PROTOCOLS = 84
-WINHTTP_OPTION_ENABLETRACING = 85
-WINHTTP_OPTION_PASSPORT_SIGN_OUT = 86
-WINHTTP_OPTION_PASSPORT_RETURN_URL = 87
-WINHTTP_OPTION_REDIRECT_POLICY = 88
-WINHTTP_OPTION_MAX_HTTP_AUTOMATIC_REDIRECTS = 89
-WINHTTP_OPTION_MAX_HTTP_STATUS_CONTINUE = 90
-WINHTTP_OPTION_MAX_RESPONSE_HEADER_SIZE = 91
-WINHTTP_OPTION_MAX_RESPONSE_DRAIN_SIZE = 92
-WINHTTP_OPTION_CONNECTION_INFO = 93
-WINHTTP_OPTION_CLIENT_CERT_ISSUER_LIST = 94
-WINHTTP_OPTION_SPN = 96
-WINHTTP_OPTION_GLOBAL_PROXY_CREDS = 97
-WINHTTP_OPTION_GLOBAL_SERVER_CREDS = 98
-WINHTTP_OPTION_UNLOAD_NOTIFY_EVENT = 99
-WINHTTP_OPTION_REJECT_USERPWD_IN_URL = 100
-WINHTTP_OPTION_USE_GLOBAL_SERVER_CREDENTIALS = 101
-WINHTTP_LAST_OPTION = WINHTTP_OPTION_USE_GLOBAL_SERVER_CREDENTIALS
-WINHTTP_OPTION_USERNAME = 0x1000
-WINHTTP_OPTION_PASSWORD = 0x1001
-WINHTTP_OPTION_PROXY_USERNAME = 0x1002
-WINHTTP_OPTION_PROXY_PASSWORD = 0x1003
-WINHTTP_CONNS_PER_SERVER_UNLIMITED = -1
-WINHTTP_AUTOLOGON_SECURITY_LEVEL_MEDIUM = 0
-WINHTTP_AUTOLOGON_SECURITY_LEVEL_LOW = 1
-WINHTTP_AUTOLOGON_SECURITY_LEVEL_HIGH = 2
-WINHTTP_AUTOLOGON_SECURITY_LEVEL_DEFAULT = WINHTTP_AUTOLOGON_SECURITY_LEVEL_MEDIUM
-WINHTTP_OPTION_REDIRECT_POLICY_NEVER = 0
-WINHTTP_OPTION_REDIRECT_POLICY_DISALLOW_HTTPS_TO_HTTP = 1
-WINHTTP_OPTION_REDIRECT_POLICY_ALWAYS = 2
-WINHTTP_OPTION_REDIRECT_POLICY_LAST = WINHTTP_OPTION_REDIRECT_POLICY_ALWAYS
-WINHTTP_OPTION_REDIRECT_POLICY_DEFAULT = (
-    WINHTTP_OPTION_REDIRECT_POLICY_DISALLOW_HTTPS_TO_HTTP
-)
-WINHTTP_DISABLE_PASSPORT_AUTH = 0x00000000
-WINHTTP_ENABLE_PASSPORT_AUTH = 0x10000000
-WINHTTP_DISABLE_PASSPORT_KEYRING = 0x20000000
-WINHTTP_ENABLE_PASSPORT_KEYRING = 0x40000000
-WINHTTP_DISABLE_COOKIES = 0x00000001
-WINHTTP_DISABLE_REDIRECTS = 0x00000002
-WINHTTP_DISABLE_AUTHENTICATION = 0x00000004
-WINHTTP_DISABLE_KEEP_ALIVE = 0x00000008
-WINHTTP_ENABLE_SSL_REVOCATION = 0x00000001
-WINHTTP_ENABLE_SSL_REVERT_IMPERSONATION = 0x00000002
-WINHTTP_DISABLE_SPN_SERVER_PORT = 0x00000000
-WINHTTP_ENABLE_SPN_SERVER_PORT = 0x00000001
-WINHTTP_OPTION_SPN_MASK = WINHTTP_ENABLE_SPN_SERVER_PORT
-WINHTTP_HANDLE_TYPE_SESSION = 1
-WINHTTP_HANDLE_TYPE_CONNECT = 2
-WINHTTP_HANDLE_TYPE_REQUEST = 3
-WINHTTP_AUTH_SCHEME_BASIC = 0x00000001
-WINHTTP_AUTH_SCHEME_NTLM = 0x00000002
-WINHTTP_AUTH_SCHEME_PASSPORT = 0x00000004
-WINHTTP_AUTH_SCHEME_DIGEST = 0x00000008
-WINHTTP_AUTH_SCHEME_NEGOTIATE = 0x00000010
-WINHTTP_AUTH_TARGET_SERVER = 0x00000000
-WINHTTP_AUTH_TARGET_PROXY = 0x00000001
-WINHTTP_CALLBACK_STATUS_FLAG_CERT_REV_FAILED = 0x00000001
-WINHTTP_CALLBACK_STATUS_FLAG_INVALID_CERT = 0x00000002
-WINHTTP_CALLBACK_STATUS_FLAG_CERT_REVOKED = 0x00000004
-WINHTTP_CALLBACK_STATUS_FLAG_INVALID_CA = 0x00000008
-WINHTTP_CALLBACK_STATUS_FLAG_CERT_CN_INVALID = 0x00000010
-WINHTTP_CALLBACK_STATUS_FLAG_CERT_DATE_INVALID = 0x00000020
-WINHTTP_CALLBACK_STATUS_FLAG_CERT_WRONG_USAGE = 0x00000040
-WINHTTP_CALLBACK_STATUS_FLAG_SECURITY_CHANNEL_ERROR = -2147483648
-WINHTTP_FLAG_SECURE_PROTOCOL_SSL2 = 0x00000008
-WINHTTP_FLAG_SECURE_PROTOCOL_SSL3 = 0x00000020
-WINHTTP_FLAG_SECURE_PROTOCOL_TLS1 = 0x00000080
-WINHTTP_FLAG_SECURE_PROTOCOL_ALL = (
-    WINHTTP_FLAG_SECURE_PROTOCOL_SSL2
-    | WINHTTP_FLAG_SECURE_PROTOCOL_SSL3
-    | WINHTTP_FLAG_SECURE_PROTOCOL_TLS1
-)
-WINHTTP_CALLBACK_STATUS_RESOLVING_NAME = 0x00000001
-WINHTTP_CALLBACK_STATUS_NAME_RESOLVED = 0x00000002
-WINHTTP_CALLBACK_STATUS_CONNECTING_TO_SERVER = 0x00000004
-WINHTTP_CALLBACK_STATUS_CONNECTED_TO_SERVER = 0x00000008
-WINHTTP_CALLBACK_STATUS_SENDING_REQUEST = 0x00000010
-WINHTTP_CALLBACK_STATUS_REQUEST_SENT = 0x00000020
-WINHTTP_CALLBACK_STATUS_RECEIVING_RESPONSE = 0x00000040
-WINHTTP_CALLBACK_STATUS_RESPONSE_RECEIVED = 0x00000080
-WINHTTP_CALLBACK_STATUS_CLOSING_CONNECTION = 0x00000100
-WINHTTP_CALLBACK_STATUS_CONNECTION_CLOSED = 0x00000200
-WINHTTP_CALLBACK_STATUS_HANDLE_CREATED = 0x00000400
-WINHTTP_CALLBACK_STATUS_HANDLE_CLOSING = 0x00000800
-WINHTTP_CALLBACK_STATUS_DETECTING_PROXY = 0x00001000
-WINHTTP_CALLBACK_STATUS_REDIRECT = 0x00004000
-WINHTTP_CALLBACK_STATUS_INTERMEDIATE_RESPONSE = 0x00008000
-WINHTTP_CALLBACK_STATUS_SECURE_FAILURE = 0x00010000
-WINHTTP_CALLBACK_STATUS_HEADERS_AVAILABLE = 0x00020000
-WINHTTP_CALLBACK_STATUS_DATA_AVAILABLE = 0x00040000
-WINHTTP_CALLBACK_STATUS_READ_COMPLETE = 0x00080000
-WINHTTP_CALLBACK_STATUS_WRITE_COMPLETE = 0x00100000
-WINHTTP_CALLBACK_STATUS_REQUEST_ERROR = 0x00200000
-WINHTTP_CALLBACK_STATUS_SENDREQUEST_COMPLETE = 0x00400000
-API_RECEIVE_RESPONSE = 1
-API_QUERY_DATA_AVAILABLE = 2
-API_READ_DATA = 3
-API_WRITE_DATA = 4
-API_SEND_REQUEST = 5
-WINHTTP_CALLBACK_FLAG_RESOLVE_NAME = (
-    WINHTTP_CALLBACK_STATUS_RESOLVING_NAME | WINHTTP_CALLBACK_STATUS_NAME_RESOLVED
-)
-WINHTTP_CALLBACK_FLAG_CONNECT_TO_SERVER = (
-    WINHTTP_CALLBACK_STATUS_CONNECTING_TO_SERVER
-    | WINHTTP_CALLBACK_STATUS_CONNECTED_TO_SERVER
-)
-WINHTTP_CALLBACK_FLAG_SEND_REQUEST = (
-    WINHTTP_CALLBACK_STATUS_SENDING_REQUEST | WINHTTP_CALLBACK_STATUS_REQUEST_SENT
-)
-WINHTTP_CALLBACK_FLAG_RECEIVE_RESPONSE = (
-    WINHTTP_CALLBACK_STATUS_RECEIVING_RESPONSE
-    | WINHTTP_CALLBACK_STATUS_RESPONSE_RECEIVED
-)
-WINHTTP_CALLBACK_FLAG_CLOSE_CONNECTION = (
-    WINHTTP_CALLBACK_STATUS_CLOSING_CONNECTION
-    | WINHTTP_CALLBACK_STATUS_CONNECTION_CLOSED
-)
-WINHTTP_CALLBACK_FLAG_HANDLES = (
-    WINHTTP_CALLBACK_STATUS_HANDLE_CREATED | WINHTTP_CALLBACK_STATUS_HANDLE_CLOSING
-)
-WINHTTP_CALLBACK_FLAG_DETECTING_PROXY = WINHTTP_CALLBACK_STATUS_DETECTING_PROXY
-WINHTTP_CALLBACK_FLAG_REDIRECT = WINHTTP_CALLBACK_STATUS_REDIRECT
-WINHTTP_CALLBACK_FLAG_INTERMEDIATE_RESPONSE = (
-    WINHTTP_CALLBACK_STATUS_INTERMEDIATE_RESPONSE
-)
-WINHTTP_CALLBACK_FLAG_SECURE_FAILURE = WINHTTP_CALLBACK_STATUS_SECURE_FAILURE
-WINHTTP_CALLBACK_FLAG_SENDREQUEST_COMPLETE = (
-    WINHTTP_CALLBACK_STATUS_SENDREQUEST_COMPLETE
-)
-WINHTTP_CALLBACK_FLAG_HEADERS_AVAILABLE = WINHTTP_CALLBACK_STATUS_HEADERS_AVAILABLE
-WINHTTP_CALLBACK_FLAG_DATA_AVAILABLE = WINHTTP_CALLBACK_STATUS_DATA_AVAILABLE
-WINHTTP_CALLBACK_FLAG_READ_COMPLETE = WINHTTP_CALLBACK_STATUS_READ_COMPLETE
-WINHTTP_CALLBACK_FLAG_WRITE_COMPLETE = WINHTTP_CALLBACK_STATUS_WRITE_COMPLETE
-WINHTTP_CALLBACK_FLAG_REQUEST_ERROR = WINHTTP_CALLBACK_STATUS_REQUEST_ERROR
-WINHTTP_CALLBACK_FLAG_ALL_COMPLETIONS = (
-    WINHTTP_CALLBACK_STATUS_SENDREQUEST_COMPLETE
-    | WINHTTP_CALLBACK_STATUS_HEADERS_AVAILABLE
-    | WINHTTP_CALLBACK_STATUS_DATA_AVAILABLE
-    | WINHTTP_CALLBACK_STATUS_READ_COMPLETE
-    | WINHTTP_CALLBACK_STATUS_WRITE_COMPLETE
-    | WINHTTP_CALLBACK_STATUS_REQUEST_ERROR
-)
-WINHTTP_CALLBACK_FLAG_ALL_NOTIFICATIONS = -1
-WINHTTP_QUERY_MIME_VERSION = 0
-WINHTTP_QUERY_CONTENT_TYPE = 1
-WINHTTP_QUERY_CONTENT_TRANSFER_ENCODING = 2
-WINHTTP_QUERY_CONTENT_ID = 3
-WINHTTP_QUERY_CONTENT_DESCRIPTION = 4
-WINHTTP_QUERY_CONTENT_LENGTH = 5
-WINHTTP_QUERY_CONTENT_LANGUAGE = 6
-WINHTTP_QUERY_ALLOW = 7
-WINHTTP_QUERY_PUBLIC = 8
-WINHTTP_QUERY_DATE = 9
-WINHTTP_QUERY_EXPIRES = 10
-WINHTTP_QUERY_LAST_MODIFIED = 11
-WINHTTP_QUERY_MESSAGE_ID = 12
-WINHTTP_QUERY_URI = 13
-WINHTTP_QUERY_DERIVED_FROM = 14
-WINHTTP_QUERY_COST = 15
-WINHTTP_QUERY_LINK = 16
-WINHTTP_QUERY_PRAGMA = 17
-WINHTTP_QUERY_VERSION = 18
-WINHTTP_QUERY_STATUS_CODE = 19
-WINHTTP_QUERY_STATUS_TEXT = 20
-WINHTTP_QUERY_RAW_HEADERS = 21
-WINHTTP_QUERY_RAW_HEADERS_CRLF = 22
-WINHTTP_QUERY_CONNECTION = 23
-WINHTTP_QUERY_ACCEPT = 24
-WINHTTP_QUERY_ACCEPT_CHARSET = 25
-WINHTTP_QUERY_ACCEPT_ENCODING = 26
-WINHTTP_QUERY_ACCEPT_LANGUAGE = 27
-WINHTTP_QUERY_AUTHORIZATION = 28
-WINHTTP_QUERY_CONTENT_ENCODING = 29
-WINHTTP_QUERY_FORWARDED = 30
-WINHTTP_QUERY_FROM = 31
-WINHTTP_QUERY_IF_MODIFIED_SINCE = 32
-WINHTTP_QUERY_LOCATION = 33
-WINHTTP_QUERY_ORIG_URI = 34
-WINHTTP_QUERY_REFERER = 35
-WINHTTP_QUERY_RETRY_AFTER = 36
-WINHTTP_QUERY_SERVER = 37
-WINHTTP_QUERY_TITLE = 38
-WINHTTP_QUERY_USER_AGENT = 39
-WINHTTP_QUERY_WWW_AUTHENTICATE = 40
-WINHTTP_QUERY_PROXY_AUTHENTICATE = 41
-WINHTTP_QUERY_ACCEPT_RANGES = 42
-WINHTTP_QUERY_SET_COOKIE = 43
-WINHTTP_QUERY_COOKIE = 44
-WINHTTP_QUERY_REQUEST_METHOD = 45
-WINHTTP_QUERY_REFRESH = 46
-WINHTTP_QUERY_CONTENT_DISPOSITION = 47
-WINHTTP_QUERY_AGE = 48
-WINHTTP_QUERY_CACHE_CONTROL = 49
-WINHTTP_QUERY_CONTENT_BASE = 50
-WINHTTP_QUERY_CONTENT_LOCATION = 51
-WINHTTP_QUERY_CONTENT_MD5 = 52
-WINHTTP_QUERY_CONTENT_RANGE = 53
-WINHTTP_QUERY_ETAG = 54
-WINHTTP_QUERY_HOST = 55
-WINHTTP_QUERY_IF_MATCH = 56
-WINHTTP_QUERY_IF_NONE_MATCH = 57
-WINHTTP_QUERY_IF_RANGE = 58
-WINHTTP_QUERY_IF_UNMODIFIED_SINCE = 59
-WINHTTP_QUERY_MAX_FORWARDS = 60
-WINHTTP_QUERY_PROXY_AUTHORIZATION = 61
-WINHTTP_QUERY_RANGE = 62
-WINHTTP_QUERY_TRANSFER_ENCODING = 63
-WINHTTP_QUERY_UPGRADE = 64
-WINHTTP_QUERY_VARY = 65
-WINHTTP_QUERY_VIA = 66
-WINHTTP_QUERY_WARNING = 67
-WINHTTP_QUERY_EXPECT = 68
-WINHTTP_QUERY_PROXY_CONNECTION = 69
-WINHTTP_QUERY_UNLESS_MODIFIED_SINCE = 70
-WINHTTP_QUERY_PROXY_SUPPORT = 75
-WINHTTP_QUERY_AUTHENTICATION_INFO = 76
-WINHTTP_QUERY_PASSPORT_URLS = 77
-WINHTTP_QUERY_PASSPORT_CONFIG = 78
-WINHTTP_QUERY_MAX = 78
-WINHTTP_QUERY_CUSTOM = 65535
-WINHTTP_QUERY_FLAG_REQUEST_HEADERS = -2147483648
-WINHTTP_QUERY_FLAG_SYSTEMTIME = 0x40000000
-WINHTTP_QUERY_FLAG_NUMBER = 0x20000000
-WINHTTP_ADDREQ_INDEX_MASK = 0x0000FFFF
-WINHTTP_ADDREQ_FLAGS_MASK = -65536
-WINHTTP_ADDREQ_FLAG_ADD_IF_NEW = 0x10000000
-WINHTTP_ADDREQ_FLAG_ADD = 0x20000000
-WINHTTP_ADDREQ_FLAG_COALESCE_WITH_COMMA = 0x40000000
-WINHTTP_ADDREQ_FLAG_COALESCE_WITH_SEMICOLON = 0x01000000
-WINHTTP_ADDREQ_FLAG_COALESCE = WINHTTP_ADDREQ_FLAG_COALESCE_WITH_COMMA
-WINHTTP_ADDREQ_FLAG_REPLACE = -2147483648
-WINHTTP_IGNORE_REQUEST_TOTAL_LENGTH = 0
-WINHTTP_ERROR_BASE = 12000
-ERROR_WINHTTP_OUT_OF_HANDLES = WINHTTP_ERROR_BASE + 1
-ERROR_WINHTTP_TIMEOUT = WINHTTP_ERROR_BASE + 2
-ERROR_WINHTTP_INTERNAL_ERROR = WINHTTP_ERROR_BASE + 4
-ERROR_WINHTTP_INVALID_URL = WINHTTP_ERROR_BASE + 5
-ERROR_WINHTTP_UNRECOGNIZED_SCHEME = WINHTTP_ERROR_BASE + 6
-ERROR_WINHTTP_NAME_NOT_RESOLVED = WINHTTP_ERROR_BASE + 7
-ERROR_WINHTTP_INVALID_OPTION = WINHTTP_ERROR_BASE + 9
-ERROR_WINHTTP_OPTION_NOT_SETTABLE = WINHTTP_ERROR_BASE + 11
-ERROR_WINHTTP_SHUTDOWN = WINHTTP_ERROR_BASE + 12
-ERROR_WINHTTP_LOGIN_FAILURE = WINHTTP_ERROR_BASE + 15
-ERROR_WINHTTP_OPERATION_CANCELLED = WINHTTP_ERROR_BASE + 17
-ERROR_WINHTTP_INCORRECT_HANDLE_TYPE = WINHTTP_ERROR_BASE + 18
-ERROR_WINHTTP_INCORRECT_HANDLE_STATE = WINHTTP_ERROR_BASE + 19
-ERROR_WINHTTP_CANNOT_CONNECT = WINHTTP_ERROR_BASE + 29
-ERROR_WINHTTP_CONNECTION_ERROR = WINHTTP_ERROR_BASE + 30
-ERROR_WINHTTP_RESEND_REQUEST = WINHTTP_ERROR_BASE + 32
-ERROR_WINHTTP_CLIENT_AUTH_CERT_NEEDED = WINHTTP_ERROR_BASE + 44
-ERROR_WINHTTP_CANNOT_CALL_BEFORE_OPEN = WINHTTP_ERROR_BASE + 100
-ERROR_WINHTTP_CANNOT_CALL_BEFORE_SEND = WINHTTP_ERROR_BASE + 101
-ERROR_WINHTTP_CANNOT_CALL_AFTER_SEND = WINHTTP_ERROR_BASE + 102
-ERROR_WINHTTP_CANNOT_CALL_AFTER_OPEN = WINHTTP_ERROR_BASE + 103
-ERROR_WINHTTP_HEADER_NOT_FOUND = WINHTTP_ERROR_BASE + 150
-ERROR_WINHTTP_INVALID_SERVER_RESPONSE = WINHTTP_ERROR_BASE + 152
-ERROR_WINHTTP_INVALID_HEADER = WINHTTP_ERROR_BASE + 153
-ERROR_WINHTTP_INVALID_QUERY_REQUEST = WINHTTP_ERROR_BASE + 154
-ERROR_WINHTTP_HEADER_ALREADY_EXISTS = WINHTTP_ERROR_BASE + 155
-ERROR_WINHTTP_REDIRECT_FAILED = WINHTTP_ERROR_BASE + 156
-ERROR_WINHTTP_AUTO_PROXY_SERVICE_ERROR = WINHTTP_ERROR_BASE + 178
-ERROR_WINHTTP_BAD_AUTO_PROXY_SCRIPT = WINHTTP_ERROR_BASE + 166
-ERROR_WINHTTP_UNABLE_TO_DOWNLOAD_SCRIPT = WINHTTP_ERROR_BASE + 167
-ERROR_WINHTTP_NOT_INITIALIZED = WINHTTP_ERROR_BASE + 172
-ERROR_WINHTTP_SECURE_FAILURE = WINHTTP_ERROR_BASE + 175
-ERROR_WINHTTP_SECURE_CERT_DATE_INVALID = WINHTTP_ERROR_BASE + 37
-ERROR_WINHTTP_SECURE_CERT_CN_INVALID = WINHTTP_ERROR_BASE + 38
-ERROR_WINHTTP_SECURE_INVALID_CA = WINHTTP_ERROR_BASE + 45
-ERROR_WINHTTP_SECURE_CERT_REV_FAILED = WINHTTP_ERROR_BASE + 57
-ERROR_WINHTTP_SECURE_CHANNEL_ERROR = WINHTTP_ERROR_BASE + 157
-ERROR_WINHTTP_SECURE_INVALID_CERT = WINHTTP_ERROR_BASE + 169
-ERROR_WINHTTP_SECURE_CERT_REVOKED = WINHTTP_ERROR_BASE + 170
-ERROR_WINHTTP_SECURE_CERT_WRONG_USAGE = WINHTTP_ERROR_BASE + 179
-ERROR_WINHTTP_AUTODETECTION_FAILED = WINHTTP_ERROR_BASE + 180
-ERROR_WINHTTP_HEADER_COUNT_EXCEEDED = WINHTTP_ERROR_BASE + 181
-ERROR_WINHTTP_HEADER_SIZE_OVERFLOW = WINHTTP_ERROR_BASE + 182
-ERROR_WINHTTP_CHUNKED_ENCODING_HEADER_SIZE_OVERFLOW = WINHTTP_ERROR_BASE + 183
-ERROR_WINHTTP_RESPONSE_DRAIN_OVERFLOW = WINHTTP_ERROR_BASE + 184
-ERROR_WINHTTP_CLIENT_CERT_NO_PRIVATE_KEY = WINHTTP_ERROR_BASE + 185
-ERROR_WINHTTP_CLIENT_CERT_NO_ACCESS_PRIVATE_KEY = WINHTTP_ERROR_BASE + 186
-WINHTTP_ERROR_LAST = WINHTTP_ERROR_BASE + 186
-
-WINHTTP_NO_PROXY_NAME = None
-WINHTTP_NO_PROXY_BYPASS = None
-WINHTTP_NO_REFERER = None
-WINHTTP_DEFAULT_ACCEPT_TYPES = None
-WINHTTP_NO_ADDITIONAL_HEADERS = None
-WINHTTP_NO_REQUEST_DATA = None
diff --git a/lib/win32/lib/win32netcon.py b/lib/win32/lib/win32netcon.py
deleted file mode 100644
index 63e97a14..00000000
--- a/lib/win32/lib/win32netcon.py
+++ /dev/null
@@ -1,627 +0,0 @@
-# Generated by h2py from lmaccess.h
-
-# Included from lmcons.h
-CNLEN = 15
-LM20_CNLEN = 15
-DNLEN = CNLEN
-LM20_DNLEN = LM20_CNLEN
-UNCLEN = CNLEN + 2
-LM20_UNCLEN = LM20_CNLEN + 2
-NNLEN = 80
-LM20_NNLEN = 12
-RMLEN = UNCLEN + 1 + NNLEN
-LM20_RMLEN = LM20_UNCLEN + 1 + LM20_NNLEN
-SNLEN = 80
-LM20_SNLEN = 15
-STXTLEN = 256
-LM20_STXTLEN = 63
-PATHLEN = 256
-LM20_PATHLEN = 256
-DEVLEN = 80
-LM20_DEVLEN = 8
-EVLEN = 16
-UNLEN = 256
-LM20_UNLEN = 20
-GNLEN = UNLEN
-LM20_GNLEN = LM20_UNLEN
-PWLEN = 256
-LM20_PWLEN = 14
-SHPWLEN = 8
-CLTYPE_LEN = 12
-MAXCOMMENTSZ = 256
-LM20_MAXCOMMENTSZ = 48
-QNLEN = NNLEN
-LM20_QNLEN = LM20_NNLEN
-ALERTSZ = 128
-NETBIOS_NAME_LEN = 16
-CRYPT_KEY_LEN = 7
-CRYPT_TXT_LEN = 8
-ENCRYPTED_PWLEN = 16
-SESSION_PWLEN = 24
-SESSION_CRYPT_KLEN = 21
-PARMNUM_ALL = 0
-PARM_ERROR_NONE = 0
-PARMNUM_BASE_INFOLEVEL = 1000
-NULL = 0
-PLATFORM_ID_DOS = 300
-PLATFORM_ID_OS2 = 400
-PLATFORM_ID_NT = 500
-PLATFORM_ID_OSF = 600
-PLATFORM_ID_VMS = 700
-MAX_LANMAN_MESSAGE_ID = 5799
-UF_SCRIPT = 1
-UF_ACCOUNTDISABLE = 2
-UF_HOMEDIR_REQUIRED = 8
-UF_LOCKOUT = 16
-UF_PASSWD_NOTREQD = 32
-UF_PASSWD_CANT_CHANGE = 64
-UF_TEMP_DUPLICATE_ACCOUNT = 256
-UF_NORMAL_ACCOUNT = 512
-UF_INTERDOMAIN_TRUST_ACCOUNT = 2048
-UF_WORKSTATION_TRUST_ACCOUNT = 4096
-UF_SERVER_TRUST_ACCOUNT = 8192
-UF_MACHINE_ACCOUNT_MASK = (
-    UF_INTERDOMAIN_TRUST_ACCOUNT
-    | UF_WORKSTATION_TRUST_ACCOUNT
-    | UF_SERVER_TRUST_ACCOUNT
-)
-UF_ACCOUNT_TYPE_MASK = (
-    UF_TEMP_DUPLICATE_ACCOUNT
-    | UF_NORMAL_ACCOUNT
-    | UF_INTERDOMAIN_TRUST_ACCOUNT
-    | UF_WORKSTATION_TRUST_ACCOUNT
-    | UF_SERVER_TRUST_ACCOUNT
-)
-UF_DONT_EXPIRE_PASSWD = 65536
-UF_MNS_LOGON_ACCOUNT = 131072
-UF_SETTABLE_BITS = (
-    UF_SCRIPT
-    | UF_ACCOUNTDISABLE
-    | UF_LOCKOUT
-    | UF_HOMEDIR_REQUIRED
-    | UF_PASSWD_NOTREQD
-    | UF_PASSWD_CANT_CHANGE
-    | UF_ACCOUNT_TYPE_MASK
-    | UF_DONT_EXPIRE_PASSWD
-    | UF_MNS_LOGON_ACCOUNT
-)
-FILTER_TEMP_DUPLICATE_ACCOUNT = 1
-FILTER_NORMAL_ACCOUNT = 2
-FILTER_INTERDOMAIN_TRUST_ACCOUNT = 8
-FILTER_WORKSTATION_TRUST_ACCOUNT = 16
-FILTER_SERVER_TRUST_ACCOUNT = 32
-LG_INCLUDE_INDIRECT = 1
-AF_OP_PRINT = 1
-AF_OP_COMM = 2
-AF_OP_SERVER = 4
-AF_OP_ACCOUNTS = 8
-AF_SETTABLE_BITS = AF_OP_PRINT | AF_OP_COMM | AF_OP_SERVER | AF_OP_ACCOUNTS
-UAS_ROLE_STANDALONE = 0
-UAS_ROLE_MEMBER = 1
-UAS_ROLE_BACKUP = 2
-UAS_ROLE_PRIMARY = 3
-USER_NAME_PARMNUM = 1
-USER_PASSWORD_PARMNUM = 3
-USER_PASSWORD_AGE_PARMNUM = 4
-USER_PRIV_PARMNUM = 5
-USER_HOME_DIR_PARMNUM = 6
-USER_COMMENT_PARMNUM = 7
-USER_FLAGS_PARMNUM = 8
-USER_SCRIPT_PATH_PARMNUM = 9
-USER_AUTH_FLAGS_PARMNUM = 10
-USER_FULL_NAME_PARMNUM = 11
-USER_USR_COMMENT_PARMNUM = 12
-USER_PARMS_PARMNUM = 13
-USER_WORKSTATIONS_PARMNUM = 14
-USER_LAST_LOGON_PARMNUM = 15
-USER_LAST_LOGOFF_PARMNUM = 16
-USER_ACCT_EXPIRES_PARMNUM = 17
-USER_MAX_STORAGE_PARMNUM = 18
-USER_UNITS_PER_WEEK_PARMNUM = 19
-USER_LOGON_HOURS_PARMNUM = 20
-USER_PAD_PW_COUNT_PARMNUM = 21
-USER_NUM_LOGONS_PARMNUM = 22
-USER_LOGON_SERVER_PARMNUM = 23
-USER_COUNTRY_CODE_PARMNUM = 24
-USER_CODE_PAGE_PARMNUM = 25
-USER_PRIMARY_GROUP_PARMNUM = 51
-USER_PROFILE = 52
-USER_PROFILE_PARMNUM = 52
-USER_HOME_DIR_DRIVE_PARMNUM = 53
-USER_NAME_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_NAME_PARMNUM
-USER_PASSWORD_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_PASSWORD_PARMNUM
-USER_PASSWORD_AGE_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_PASSWORD_AGE_PARMNUM
-USER_PRIV_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_PRIV_PARMNUM
-USER_HOME_DIR_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_HOME_DIR_PARMNUM
-USER_COMMENT_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_COMMENT_PARMNUM
-USER_FLAGS_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_FLAGS_PARMNUM
-USER_SCRIPT_PATH_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_SCRIPT_PATH_PARMNUM
-USER_AUTH_FLAGS_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_AUTH_FLAGS_PARMNUM
-USER_FULL_NAME_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_FULL_NAME_PARMNUM
-USER_USR_COMMENT_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_USR_COMMENT_PARMNUM
-USER_PARMS_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_PARMS_PARMNUM
-USER_WORKSTATIONS_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_WORKSTATIONS_PARMNUM
-USER_LAST_LOGON_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_LAST_LOGON_PARMNUM
-USER_LAST_LOGOFF_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_LAST_LOGOFF_PARMNUM
-USER_ACCT_EXPIRES_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_ACCT_EXPIRES_PARMNUM
-USER_MAX_STORAGE_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_MAX_STORAGE_PARMNUM
-USER_UNITS_PER_WEEK_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_UNITS_PER_WEEK_PARMNUM
-USER_LOGON_HOURS_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_LOGON_HOURS_PARMNUM
-USER_PAD_PW_COUNT_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_PAD_PW_COUNT_PARMNUM
-USER_NUM_LOGONS_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_NUM_LOGONS_PARMNUM
-USER_LOGON_SERVER_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_LOGON_SERVER_PARMNUM
-USER_COUNTRY_CODE_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_COUNTRY_CODE_PARMNUM
-USER_CODE_PAGE_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_CODE_PAGE_PARMNUM
-USER_PRIMARY_GROUP_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_PRIMARY_GROUP_PARMNUM
-USER_HOME_DIR_DRIVE_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + USER_HOME_DIR_DRIVE_PARMNUM
-NULL_USERSETINFO_PASSWD = "              "
-UNITS_PER_DAY = 24
-UNITS_PER_WEEK = UNITS_PER_DAY * 7
-USER_PRIV_MASK = 3
-USER_PRIV_GUEST = 0
-USER_PRIV_USER = 1
-USER_PRIV_ADMIN = 2
-MAX_PASSWD_LEN = PWLEN
-DEF_MIN_PWLEN = 6
-DEF_PWUNIQUENESS = 5
-DEF_MAX_PWHIST = 8
-DEF_MAX_BADPW = 0
-VALIDATED_LOGON = 0
-PASSWORD_EXPIRED = 2
-NON_VALIDATED_LOGON = 3
-VALID_LOGOFF = 1
-MODALS_MIN_PASSWD_LEN_PARMNUM = 1
-MODALS_MAX_PASSWD_AGE_PARMNUM = 2
-MODALS_MIN_PASSWD_AGE_PARMNUM = 3
-MODALS_FORCE_LOGOFF_PARMNUM = 4
-MODALS_PASSWD_HIST_LEN_PARMNUM = 5
-MODALS_ROLE_PARMNUM = 6
-MODALS_PRIMARY_PARMNUM = 7
-MODALS_DOMAIN_NAME_PARMNUM = 8
-MODALS_DOMAIN_ID_PARMNUM = 9
-MODALS_LOCKOUT_DURATION_PARMNUM = 10
-MODALS_LOCKOUT_OBSERVATION_WINDOW_PARMNUM = 11
-MODALS_LOCKOUT_THRESHOLD_PARMNUM = 12
-MODALS_MIN_PASSWD_LEN_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + MODALS_MIN_PASSWD_LEN_PARMNUM
-MODALS_MAX_PASSWD_AGE_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + MODALS_MAX_PASSWD_AGE_PARMNUM
-MODALS_MIN_PASSWD_AGE_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + MODALS_MIN_PASSWD_AGE_PARMNUM
-MODALS_FORCE_LOGOFF_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + MODALS_FORCE_LOGOFF_PARMNUM
-MODALS_PASSWD_HIST_LEN_INFOLEVEL = (
-    PARMNUM_BASE_INFOLEVEL + MODALS_PASSWD_HIST_LEN_PARMNUM
-)
-MODALS_ROLE_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + MODALS_ROLE_PARMNUM
-MODALS_PRIMARY_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + MODALS_PRIMARY_PARMNUM
-MODALS_DOMAIN_NAME_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + MODALS_DOMAIN_NAME_PARMNUM
-MODALS_DOMAIN_ID_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + MODALS_DOMAIN_ID_PARMNUM
-GROUPIDMASK = 32768
-GROUP_ALL_PARMNUM = 0
-GROUP_NAME_PARMNUM = 1
-GROUP_COMMENT_PARMNUM = 2
-GROUP_ATTRIBUTES_PARMNUM = 3
-GROUP_ALL_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + GROUP_ALL_PARMNUM
-GROUP_NAME_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + GROUP_NAME_PARMNUM
-GROUP_COMMENT_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + GROUP_COMMENT_PARMNUM
-GROUP_ATTRIBUTES_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + GROUP_ATTRIBUTES_PARMNUM
-LOCALGROUP_NAME_PARMNUM = 1
-LOCALGROUP_COMMENT_PARMNUM = 2
-MAXPERMENTRIES = 64
-ACCESS_NONE = 0
-ACCESS_READ = 1
-ACCESS_WRITE = 2
-ACCESS_CREATE = 4
-ACCESS_EXEC = 8
-ACCESS_DELETE = 16
-ACCESS_ATRIB = 32
-ACCESS_PERM = 64
-ACCESS_GROUP = 32768
-ACCESS_AUDIT = 1
-ACCESS_SUCCESS_OPEN = 16
-ACCESS_SUCCESS_WRITE = 32
-ACCESS_SUCCESS_DELETE = 64
-ACCESS_SUCCESS_ACL = 128
-ACCESS_SUCCESS_MASK = 240
-ACCESS_FAIL_OPEN = 256
-ACCESS_FAIL_WRITE = 512
-ACCESS_FAIL_DELETE = 1024
-ACCESS_FAIL_ACL = 2048
-ACCESS_FAIL_MASK = 3840
-ACCESS_FAIL_SHIFT = 4
-ACCESS_RESOURCE_NAME_PARMNUM = 1
-ACCESS_ATTR_PARMNUM = 2
-ACCESS_COUNT_PARMNUM = 3
-ACCESS_ACCESS_LIST_PARMNUM = 4
-ACCESS_RESOURCE_NAME_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + ACCESS_RESOURCE_NAME_PARMNUM
-ACCESS_ATTR_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + ACCESS_ATTR_PARMNUM
-ACCESS_COUNT_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + ACCESS_COUNT_PARMNUM
-ACCESS_ACCESS_LIST_INFOLEVEL = PARMNUM_BASE_INFOLEVEL + ACCESS_ACCESS_LIST_PARMNUM
-ACCESS_LETTERS = "RWCXDAP         "
-NETLOGON_CONTROL_QUERY = 1
-NETLOGON_CONTROL_REPLICATE = 2
-NETLOGON_CONTROL_SYNCHRONIZE = 3
-NETLOGON_CONTROL_PDC_REPLICATE = 4
-NETLOGON_CONTROL_REDISCOVER = 5
-NETLOGON_CONTROL_TC_QUERY = 6
-NETLOGON_CONTROL_TRANSPORT_NOTIFY = 7
-NETLOGON_CONTROL_FIND_USER = 8
-NETLOGON_CONTROL_UNLOAD_NETLOGON_DLL = 65531
-NETLOGON_CONTROL_BACKUP_CHANGE_LOG = 65532
-NETLOGON_CONTROL_TRUNCATE_LOG = 65533
-NETLOGON_CONTROL_SET_DBFLAG = 65534
-NETLOGON_CONTROL_BREAKPOINT = 65535
-NETLOGON_REPLICATION_NEEDED = 1
-NETLOGON_REPLICATION_IN_PROGRESS = 2
-NETLOGON_FULL_SYNC_REPLICATION = 4
-NETLOGON_REDO_NEEDED = 8
-
-######################
-# Manual stuff
-
-TEXT = lambda x: x
-
-MAX_PREFERRED_LENGTH = -1
-PARM_ERROR_UNKNOWN = -1
-MESSAGE_FILENAME = TEXT("NETMSG")
-OS2MSG_FILENAME = TEXT("BASE")
-HELP_MSG_FILENAME = TEXT("NETH")
-BACKUP_MSG_FILENAME = TEXT("BAK.MSG")
-TIMEQ_FOREVER = -1
-USER_MAXSTORAGE_UNLIMITED = -1
-USER_NO_LOGOFF = -1
-DEF_MAX_PWAGE = TIMEQ_FOREVER
-DEF_MIN_PWAGE = 0
-DEF_FORCE_LOGOFF = -1
-ONE_DAY = 1 * 24 * 3600
-GROUP_SPECIALGRP_USERS = "USERS"
-GROUP_SPECIALGRP_ADMINS = "ADMINS"
-GROUP_SPECIALGRP_GUESTS = "GUESTS"
-GROUP_SPECIALGRP_LOCAL = "LOCAL"
-ACCESS_ALL = (
-    ACCESS_READ
-    | ACCESS_WRITE
-    | ACCESS_CREATE
-    | ACCESS_EXEC
-    | ACCESS_DELETE
-    | ACCESS_ATRIB
-    | ACCESS_PERM
-)
-
-# From lmserver.h
-SV_PLATFORM_ID_OS2 = 400
-SV_PLATFORM_ID_NT = 500
-MAJOR_VERSION_MASK = 15
-SV_TYPE_WORKSTATION = 1
-SV_TYPE_SERVER = 2
-SV_TYPE_SQLSERVER = 4
-SV_TYPE_DOMAIN_CTRL = 8
-SV_TYPE_DOMAIN_BAKCTRL = 16
-SV_TYPE_TIME_SOURCE = 32
-SV_TYPE_AFP = 64
-SV_TYPE_NOVELL = 128
-SV_TYPE_DOMAIN_MEMBER = 256
-SV_TYPE_PRINTQ_SERVER = 512
-SV_TYPE_DIALIN_SERVER = 1024
-SV_TYPE_XENIX_SERVER = 2048
-SV_TYPE_SERVER_UNIX = SV_TYPE_XENIX_SERVER
-SV_TYPE_NT = 4096
-SV_TYPE_WFW = 8192
-SV_TYPE_SERVER_MFPN = 16384
-SV_TYPE_SERVER_NT = 32768
-SV_TYPE_POTENTIAL_BROWSER = 65536
-SV_TYPE_BACKUP_BROWSER = 131072
-SV_TYPE_MASTER_BROWSER = 262144
-SV_TYPE_DOMAIN_MASTER = 524288
-SV_TYPE_SERVER_OSF = 1048576
-SV_TYPE_SERVER_VMS = 2097152
-SV_TYPE_WINDOWS = 4194304
-SV_TYPE_DFS = 8388608
-SV_TYPE_CLUSTER_NT = 16777216
-SV_TYPE_DCE = 268435456
-SV_TYPE_ALTERNATE_XPORT = 536870912
-SV_TYPE_LOCAL_LIST_ONLY = 1073741824
-SV_TYPE_DOMAIN_ENUM = -2147483648
-SV_TYPE_ALL = -1
-SV_NODISC = -1
-SV_USERSECURITY = 1
-SV_SHARESECURITY = 0
-SV_HIDDEN = 1
-SV_VISIBLE = 0
-SV_PLATFORM_ID_PARMNUM = 101
-SV_NAME_PARMNUM = 102
-SV_VERSION_MAJOR_PARMNUM = 103
-SV_VERSION_MINOR_PARMNUM = 104
-SV_TYPE_PARMNUM = 105
-SV_COMMENT_PARMNUM = 5
-SV_USERS_PARMNUM = 107
-SV_DISC_PARMNUM = 10
-SV_HIDDEN_PARMNUM = 16
-SV_ANNOUNCE_PARMNUM = 17
-SV_ANNDELTA_PARMNUM = 18
-SV_USERPATH_PARMNUM = 112
-SV_ULIST_MTIME_PARMNUM = 401
-SV_GLIST_MTIME_PARMNUM = 402
-SV_ALIST_MTIME_PARMNUM = 403
-SV_ALERTS_PARMNUM = 11
-SV_SECURITY_PARMNUM = 405
-SV_NUMADMIN_PARMNUM = 406
-SV_LANMASK_PARMNUM = 407
-SV_GUESTACC_PARMNUM = 408
-SV_CHDEVQ_PARMNUM = 410
-SV_CHDEVJOBS_PARMNUM = 411
-SV_CONNECTIONS_PARMNUM = 412
-SV_SHARES_PARMNUM = 413
-SV_OPENFILES_PARMNUM = 414
-SV_SESSREQS_PARMNUM = 417
-SV_ACTIVELOCKS_PARMNUM = 419
-SV_NUMREQBUF_PARMNUM = 420
-SV_NUMBIGBUF_PARMNUM = 422
-SV_NUMFILETASKS_PARMNUM = 423
-SV_ALERTSCHED_PARMNUM = 37
-SV_ERRORALERT_PARMNUM = 38
-SV_LOGONALERT_PARMNUM = 39
-SV_ACCESSALERT_PARMNUM = 40
-SV_DISKALERT_PARMNUM = 41
-SV_NETIOALERT_PARMNUM = 42
-SV_MAXAUDITSZ_PARMNUM = 43
-SV_SRVHEURISTICS_PARMNUM = 431
-SV_SESSOPENS_PARMNUM = 501
-SV_SESSVCS_PARMNUM = 502
-SV_OPENSEARCH_PARMNUM = 503
-SV_SIZREQBUF_PARMNUM = 504
-SV_INITWORKITEMS_PARMNUM = 505
-SV_MAXWORKITEMS_PARMNUM = 506
-SV_RAWWORKITEMS_PARMNUM = 507
-SV_IRPSTACKSIZE_PARMNUM = 508
-SV_MAXRAWBUFLEN_PARMNUM = 509
-SV_SESSUSERS_PARMNUM = 510
-SV_SESSCONNS_PARMNUM = 511
-SV_MAXNONPAGEDMEMORYUSAGE_PARMNUM = 512
-SV_MAXPAGEDMEMORYUSAGE_PARMNUM = 513
-SV_ENABLESOFTCOMPAT_PARMNUM = 514
-SV_ENABLEFORCEDLOGOFF_PARMNUM = 515
-SV_TIMESOURCE_PARMNUM = 516
-SV_ACCEPTDOWNLEVELAPIS_PARMNUM = 517
-SV_LMANNOUNCE_PARMNUM = 518
-SV_DOMAIN_PARMNUM = 519
-SV_MAXCOPYREADLEN_PARMNUM = 520
-SV_MAXCOPYWRITELEN_PARMNUM = 521
-SV_MINKEEPSEARCH_PARMNUM = 522
-SV_MAXKEEPSEARCH_PARMNUM = 523
-SV_MINKEEPCOMPLSEARCH_PARMNUM = 524
-SV_MAXKEEPCOMPLSEARCH_PARMNUM = 525
-SV_THREADCOUNTADD_PARMNUM = 526
-SV_NUMBLOCKTHREADS_PARMNUM = 527
-SV_SCAVTIMEOUT_PARMNUM = 528
-SV_MINRCVQUEUE_PARMNUM = 529
-SV_MINFREEWORKITEMS_PARMNUM = 530
-SV_XACTMEMSIZE_PARMNUM = 531
-SV_THREADPRIORITY_PARMNUM = 532
-SV_MAXMPXCT_PARMNUM = 533
-SV_OPLOCKBREAKWAIT_PARMNUM = 534
-SV_OPLOCKBREAKRESPONSEWAIT_PARMNUM = 535
-SV_ENABLEOPLOCKS_PARMNUM = 536
-SV_ENABLEOPLOCKFORCECLOSE_PARMNUM = 537
-SV_ENABLEFCBOPENS_PARMNUM = 538
-SV_ENABLERAW_PARMNUM = 539
-SV_ENABLESHAREDNETDRIVES_PARMNUM = 540
-SV_MINFREECONNECTIONS_PARMNUM = 541
-SV_MAXFREECONNECTIONS_PARMNUM = 542
-SV_INITSESSTABLE_PARMNUM = 543
-SV_INITCONNTABLE_PARMNUM = 544
-SV_INITFILETABLE_PARMNUM = 545
-SV_INITSEARCHTABLE_PARMNUM = 546
-SV_ALERTSCHEDULE_PARMNUM = 547
-SV_ERRORTHRESHOLD_PARMNUM = 548
-SV_NETWORKERRORTHRESHOLD_PARMNUM = 549
-SV_DISKSPACETHRESHOLD_PARMNUM = 550
-SV_MAXLINKDELAY_PARMNUM = 552
-SV_MINLINKTHROUGHPUT_PARMNUM = 553
-SV_LINKINFOVALIDTIME_PARMNUM = 554
-SV_SCAVQOSINFOUPDATETIME_PARMNUM = 555
-SV_MAXWORKITEMIDLETIME_PARMNUM = 556
-SV_MAXRAWWORKITEMS_PARMNUM = 557
-SV_PRODUCTTYPE_PARMNUM = 560
-SV_SERVERSIZE_PARMNUM = 561
-SV_CONNECTIONLESSAUTODISC_PARMNUM = 562
-SV_SHARINGVIOLATIONRETRIES_PARMNUM = 563
-SV_SHARINGVIOLATIONDELAY_PARMNUM = 564
-SV_MAXGLOBALOPENSEARCH_PARMNUM = 565
-SV_REMOVEDUPLICATESEARCHES_PARMNUM = 566
-SV_LOCKVIOLATIONRETRIES_PARMNUM = 567
-SV_LOCKVIOLATIONOFFSET_PARMNUM = 568
-SV_LOCKVIOLATIONDELAY_PARMNUM = 569
-SV_MDLREADSWITCHOVER_PARMNUM = 570
-SV_CACHEDOPENLIMIT_PARMNUM = 571
-SV_CRITICALTHREADS_PARMNUM = 572
-SV_RESTRICTNULLSESSACCESS_PARMNUM = 573
-SV_ENABLEWFW311DIRECTIPX_PARMNUM = 574
-SV_OTHERQUEUEAFFINITY_PARMNUM = 575
-SV_QUEUESAMPLESECS_PARMNUM = 576
-SV_BALANCECOUNT_PARMNUM = 577
-SV_PREFERREDAFFINITY_PARMNUM = 578
-SV_MAXFREERFCBS_PARMNUM = 579
-SV_MAXFREEMFCBS_PARMNUM = 580
-SV_MAXFREELFCBS_PARMNUM = 581
-SV_MAXFREEPAGEDPOOLCHUNKS_PARMNUM = 582
-SV_MINPAGEDPOOLCHUNKSIZE_PARMNUM = 583
-SV_MAXPAGEDPOOLCHUNKSIZE_PARMNUM = 584
-SV_SENDSFROMPREFERREDPROCESSOR_PARMNUM = 585
-SV_MAXTHREADSPERQUEUE_PARMNUM = 586
-SV_CACHEDDIRECTORYLIMIT_PARMNUM = 587
-SV_MAXCOPYLENGTH_PARMNUM = 588
-SV_ENABLEBULKTRANSFER_PARMNUM = 589
-SV_ENABLECOMPRESSION_PARMNUM = 590
-SV_AUTOSHAREWKS_PARMNUM = 591
-SV_AUTOSHARESERVER_PARMNUM = 592
-SV_ENABLESECURITYSIGNATURE_PARMNUM = 593
-SV_REQUIRESECURITYSIGNATURE_PARMNUM = 594
-SV_MINCLIENTBUFFERSIZE_PARMNUM = 595
-SV_CONNECTIONNOSESSIONSTIMEOUT_PARMNUM = 596
-SVI1_NUM_ELEMENTS = 5
-SVI2_NUM_ELEMENTS = 40
-SVI3_NUM_ELEMENTS = 44
-SW_AUTOPROF_LOAD_MASK = 1
-SW_AUTOPROF_SAVE_MASK = 2
-SV_MAX_SRV_HEUR_LEN = 32
-SV_USERS_PER_LICENSE = 5
-SVTI2_REMAP_PIPE_NAMES = 2
-
-# Generated by h2py from lmshare.h
-SHARE_NETNAME_PARMNUM = 1
-SHARE_TYPE_PARMNUM = 3
-SHARE_REMARK_PARMNUM = 4
-SHARE_PERMISSIONS_PARMNUM = 5
-SHARE_MAX_USES_PARMNUM = 6
-SHARE_CURRENT_USES_PARMNUM = 7
-SHARE_PATH_PARMNUM = 8
-SHARE_PASSWD_PARMNUM = 9
-SHARE_FILE_SD_PARMNUM = 501
-SHI1_NUM_ELEMENTS = 4
-SHI2_NUM_ELEMENTS = 10
-STYPE_DISKTREE = 0
-STYPE_PRINTQ = 1
-STYPE_DEVICE = 2
-STYPE_IPC = 3
-STYPE_SPECIAL = -2147483648
-SHI1005_FLAGS_DFS = 1
-SHI1005_FLAGS_DFS_ROOT = 2
-COW_PERMACHINE = 4
-COW_PERUSER = 8
-CSC_CACHEABLE = 16
-CSC_NOFLOWOPS = 32
-CSC_AUTO_INWARD = 64
-CSC_AUTO_OUTWARD = 128
-SHI1005_VALID_FLAGS_SET = (
-    CSC_CACHEABLE
-    | CSC_NOFLOWOPS
-    | CSC_AUTO_INWARD
-    | CSC_AUTO_OUTWARD
-    | COW_PERMACHINE
-    | COW_PERUSER
-)
-SHI1007_VALID_FLAGS_SET = SHI1005_VALID_FLAGS_SET
-SESS_GUEST = 1
-SESS_NOENCRYPTION = 2
-SESI1_NUM_ELEMENTS = 8
-SESI2_NUM_ELEMENTS = 9
-PERM_FILE_READ = 1
-PERM_FILE_WRITE = 2
-PERM_FILE_CREATE = 4
-
-# Generated by h2py from d:\mssdk\include\winnetwk.h
-WNNC_NET_MSNET = 65536
-WNNC_NET_LANMAN = 131072
-WNNC_NET_NETWARE = 196608
-WNNC_NET_VINES = 262144
-WNNC_NET_10NET = 327680
-WNNC_NET_LOCUS = 393216
-WNNC_NET_SUN_PC_NFS = 458752
-WNNC_NET_LANSTEP = 524288
-WNNC_NET_9TILES = 589824
-WNNC_NET_LANTASTIC = 655360
-WNNC_NET_AS400 = 720896
-WNNC_NET_FTP_NFS = 786432
-WNNC_NET_PATHWORKS = 851968
-WNNC_NET_LIFENET = 917504
-WNNC_NET_POWERLAN = 983040
-WNNC_NET_BWNFS = 1048576
-WNNC_NET_COGENT = 1114112
-WNNC_NET_FARALLON = 1179648
-WNNC_NET_APPLETALK = 1245184
-WNNC_NET_INTERGRAPH = 1310720
-WNNC_NET_SYMFONET = 1376256
-WNNC_NET_CLEARCASE = 1441792
-WNNC_NET_FRONTIER = 1507328
-WNNC_NET_BMC = 1572864
-WNNC_NET_DCE = 1638400
-WNNC_NET_DECORB = 2097152
-WNNC_NET_PROTSTOR = 2162688
-WNNC_NET_FJ_REDIR = 2228224
-WNNC_NET_DISTINCT = 2293760
-WNNC_NET_TWINS = 2359296
-WNNC_NET_RDR2SAMPLE = 2424832
-RESOURCE_CONNECTED = 1
-RESOURCE_GLOBALNET = 2
-RESOURCE_REMEMBERED = 3
-RESOURCE_RECENT = 4
-RESOURCE_CONTEXT = 5
-RESOURCETYPE_ANY = 0
-RESOURCETYPE_DISK = 1
-RESOURCETYPE_PRINT = 2
-RESOURCETYPE_RESERVED = 8
-RESOURCETYPE_UNKNOWN = -1
-RESOURCEUSAGE_CONNECTABLE = 1
-RESOURCEUSAGE_CONTAINER = 2
-RESOURCEUSAGE_NOLOCALDEVICE = 4
-RESOURCEUSAGE_SIBLING = 8
-RESOURCEUSAGE_ATTACHED = 16
-RESOURCEUSAGE_ALL = (
-    RESOURCEUSAGE_CONNECTABLE | RESOURCEUSAGE_CONTAINER | RESOURCEUSAGE_ATTACHED
-)
-RESOURCEUSAGE_RESERVED = -2147483648
-RESOURCEDISPLAYTYPE_GENERIC = 0
-RESOURCEDISPLAYTYPE_DOMAIN = 1
-RESOURCEDISPLAYTYPE_SERVER = 2
-RESOURCEDISPLAYTYPE_SHARE = 3
-RESOURCEDISPLAYTYPE_FILE = 4
-RESOURCEDISPLAYTYPE_GROUP = 5
-RESOURCEDISPLAYTYPE_NETWORK = 6
-RESOURCEDISPLAYTYPE_ROOT = 7
-RESOURCEDISPLAYTYPE_SHAREADMIN = 8
-RESOURCEDISPLAYTYPE_DIRECTORY = 9
-RESOURCEDISPLAYTYPE_TREE = 10
-RESOURCEDISPLAYTYPE_NDSCONTAINER = 11
-NETPROPERTY_PERSISTENT = 1
-CONNECT_UPDATE_PROFILE = 1
-CONNECT_UPDATE_RECENT = 2
-CONNECT_TEMPORARY = 4
-CONNECT_INTERACTIVE = 8
-CONNECT_PROMPT = 16
-CONNECT_NEED_DRIVE = 32
-CONNECT_REFCOUNT = 64
-CONNECT_REDIRECT = 128
-CONNECT_LOCALDRIVE = 256
-CONNECT_CURRENT_MEDIA = 512
-CONNECT_DEFERRED = 1024
-CONNECT_RESERVED = -16777216
-CONNDLG_RO_PATH = 1
-CONNDLG_CONN_POINT = 2
-CONNDLG_USE_MRU = 4
-CONNDLG_HIDE_BOX = 8
-CONNDLG_PERSIST = 16
-CONNDLG_NOT_PERSIST = 32
-DISC_UPDATE_PROFILE = 1
-DISC_NO_FORCE = 64
-UNIVERSAL_NAME_INFO_LEVEL = 1
-REMOTE_NAME_INFO_LEVEL = 2
-WNFMT_MULTILINE = 1
-WNFMT_ABBREVIATED = 2
-WNFMT_INENUM = 16
-WNFMT_CONNECTION = 32
-NETINFO_DLL16 = 1
-NETINFO_DISKRED = 4
-NETINFO_PRINTERRED = 8
-RP_LOGON = 1
-RP_INIFILE = 2
-PP_DISPLAYERRORS = 1
-WNCON_FORNETCARD = 1
-WNCON_NOTROUTED = 2
-WNCON_SLOWLINK = 4
-WNCON_DYNAMIC = 8
-
-## NETSETUP_NAME_TYPE, used with NetValidateName
-NetSetupUnknown = 0
-NetSetupMachine = 1
-NetSetupWorkgroup = 2
-NetSetupDomain = 3
-NetSetupNonExistentDomain = 4
-NetSetupDnsMachine = 5
-
-## NETSETUP_JOIN_STATUS, use with NetGetJoinInformation
-NetSetupUnknownStatus = 0
-NetSetupUnjoined = 1
-NetSetupWorkgroupName = 2
-NetSetupDomainName = 3
-
-NetValidateAuthentication = 1
-NetValidatePasswordChange = 2
-NetValidatePasswordReset = 3
diff --git a/lib/win32/lib/win32pdhquery.py b/lib/win32/lib/win32pdhquery.py
deleted file mode 100644
index a48db08a..00000000
--- a/lib/win32/lib/win32pdhquery.py
+++ /dev/null
@@ -1,571 +0,0 @@
-"""
-Performance Data Helper (PDH) Query Classes
-
-Wrapper classes for end-users and high-level access to the PDH query
-mechanisms.  PDH is a win32-specific mechanism for accessing the
-performance data made available by the system.  The Python for Windows
-PDH module does not implement the "Registry" interface, implementing
-the more straightforward Query-based mechanism.
-
-The basic idea of a PDH Query is an object which can query the system
-about the status of any number of "counters."  The counters are paths
-to a particular piece of performance data.  For instance, the path 
-'\\Memory\\Available Bytes' describes just about exactly what it says
-it does, the amount of free memory on the default computer expressed 
-in Bytes.  These paths can be considerably more complex than this, 
-but part of the point of this wrapper module is to hide that
-complexity from the end-user/programmer.
-
-EXAMPLE: A more complex Path
-	'\\\\RAISTLIN\\PhysicalDisk(_Total)\\Avg. Disk Bytes/Read'
-	Raistlin --> Computer Name
-	PhysicalDisk --> Object Name
-	_Total --> The particular Instance (in this case, all instances, i.e. all drives)
-	Avg. Disk Bytes/Read --> The piece of data being monitored.
-
-EXAMPLE: Collecting Data with a Query
-	As an example, the following code implements a logger which allows the
-	user to choose what counters they would like to log, and logs those
-	counters for 30 seconds, at two-second intervals.
-	
-	query = Query()
-	query.addcounterbybrowsing()
-	query.collectdatafor(30,2)
-	
-	The data is now stored in a list of lists as:
-	query.curresults
-	
-	The counters(paths) which were used to collect the data are:
-	query.curpaths
-	
-	You can use the win32pdh.ParseCounterPath(path) utility function
-	to turn the paths into more easily read values for your task, or
-	write the data to a file, or do whatever you want with it.
-
-OTHER NOTABLE METHODS:
-	query.collectdatawhile(period) # start a logging thread for collecting data
-	query.collectdatawhile_stop() # signal the logging thread to stop logging
-	query.collectdata() # run the query only once
-	query.addperfcounter(object, counter, machine=None) # add a standard performance counter
-	query.addinstcounter(object, counter,machine=None,objtype = 'Process',volatile=1,format = win32pdh.PDH_FMT_LONG) # add a possibly volatile counter
-
-### Known bugs and limitations ###
-Due to a problem with threading under the PythonWin interpreter, there
-will be no data logged if the PythonWin window is not the foreground
-application.  Workaround: scripts using threading should be run in the
-python.exe interpreter.
-
-The volatile-counter handlers are possibly buggy, they haven't been
-tested to any extent.  The wrapper Query makes it safe to pass invalid
-paths (a -1 will be returned, or the Query will be totally ignored,
-depending on the missing element), so you should be able to work around
-the error by including all possible paths and filtering out the -1's.
-
-There is no way I know of to stop a thread which is currently sleeping,
-so you have to wait until the thread in collectdatawhile is activated
-again.  This might become a problem in situations where the collection
-period is multiple minutes (or hours, or whatever).
-
-Should make the win32pdh.ParseCounter function available to the Query
-classes as a method or something similar, so that it can be accessed
-by programmes that have just picked up an instance from somewhere.
-
-Should explicitly mention where QueryErrors can be raised, and create a
-full test set to see if there are any uncaught win32api.error's still
-hanging around.
-
-When using the python.exe interpreter, the addcounterbybrowsing-
-generated browser window is often hidden behind other windows.  No known
-workaround other than Alt-tabing to reach the browser window.
-
-### Other References ###
-The win32pdhutil module (which should be in the %pythonroot%/win32/lib 
-directory) provides quick-and-dirty utilities for one-off access to
-variables from the PDH.  Almost everything in that module can be done
-with a Query object, but it provides task-oriented functions for a
-number of common one-off tasks.
-
-If you can access the MS Developers Network Library, you can find
-information about the PDH API as MS describes it.  For a background article,
-try:
-http://msdn.microsoft.com/library/en-us/dnperfmo/html/msdn_pdhlib.asp
-
-The reference guide for the PDH API was last spotted at:
-http://msdn.microsoft.com/library/en-us/perfmon/base/using_the_pdh_interface.asp
-
-
-In general the Python version of the API is just a wrapper around the
-Query-based version of this API (as far as I can see), so you can learn what
-you need to from there.  From what I understand, the MSDN Online 
-resources are available for the price of signing up for them.  I can't
-guarantee how long that's supposed to last. (Or anything for that
-matter).
-http://premium.microsoft.com/isapi/devonly/prodinfo/msdnprod/msdnlib.idc?theURL=/msdn/library/sdkdoc/perfdata_4982.htm
-
-The eventual plan is for my (Mike Fletcher's) Starship account to include
-a section on NT Administration, and the Query is the first project
-in this plan.  There should be an article describing the creation of
-a simple logger there, but the example above is 90% of the work of
-that project, so don't sweat it if you don't find anything there.
-(currently the account hasn't been set up).
-http://starship.skyport.net/crew/mcfletch/
-
-If you need to contact me immediately, (why I can't imagine), you can
-email me at mcfletch@golden.net, or just post your question to the
-Python newsgroup with a catchy subject line.
-news:comp.lang.python
-
-### Other Stuff ###
-The Query classes are by Mike Fletcher, with the working code
-being corruptions of Mark Hammonds win32pdhutil module.
-
-Use at your own risk, no warranties, no guarantees, no assurances,
-if you use it, you accept the risk of using it, etceteras.
-
-"""
-# Feb 12, 98 - MH added "rawaddcounter" so caller can get exception details.
-
-import _thread
-import copy
-import time
-
-import win32api
-import win32pdh
-
-
-class BaseQuery:
-    """
-    Provides wrapped access to the Performance Data Helper query
-    objects, generally you should use the child class Query
-    unless you have need of doing weird things :)
-
-    This class supports two major working paradigms.  In the first,
-    you open the query, and run it as many times as you need, closing
-    the query when you're done with it.  This is suitable for static
-    queries (ones where processes being monitored don't disappear).
-
-    In the second, you allow the query to be opened each time and
-    closed afterward.  This causes the base query object to be
-    destroyed after each call.  Suitable for dynamic queries (ones
-    which watch processes which might be closed while watching.)
-    """
-
-    def __init__(self, paths=None):
-        """
-        The PDH Query object is initialised with a single, optional
-        list argument, that must be properly formatted PDH Counter
-        paths.  Generally this list will only be provided by the class
-        when it is being unpickled (removed from storage).  Normal
-        use is to call the class with no arguments and use the various
-        addcounter functions (particularly, for end user's, the use of
-        addcounterbybrowsing is the most common approach)  You might
-        want to provide the list directly if you want to hard-code the
-        elements with which your query deals (and thereby avoid the
-        overhead of unpickling the class).
-        """
-        self.counters = []
-        if paths:
-            self.paths = paths
-        else:
-            self.paths = []
-        self._base = None
-        self.active = 0
-        self.curpaths = []
-
-    def addcounterbybrowsing(
-        self, flags=win32pdh.PERF_DETAIL_WIZARD, windowtitle="Python Browser"
-    ):
-        """
-        Adds possibly multiple paths to the paths attribute of the query,
-        does this by calling the standard counter browsing dialogue.  Within
-        this dialogue, find the counter you want to log, and click: Add,
-        repeat for every path you want to log, then click on close.  The
-        paths are appended to the non-volatile paths list for this class,
-        subclasses may create a function which parses the paths and decides
-        (via heuristics) whether to add the path to the volatile or non-volatile
-        path list.
-        e.g.:
-                query.addcounter()
-        """
-        win32pdh.BrowseCounters(None, 0, self.paths.append, flags, windowtitle)
-
-    def rawaddcounter(self, object, counter, instance=None, inum=-1, machine=None):
-        """
-        Adds a single counter path, without catching any exceptions.
-
-        See addcounter for details.
-        """
-        path = win32pdh.MakeCounterPath(
-            (machine, object, instance, None, inum, counter)
-        )
-        self.paths.append(path)
-
-    def addcounter(self, object, counter, instance=None, inum=-1, machine=None):
-        """
-        Adds a single counter path to the paths attribute.  Normally
-        this will be called by a child class' speciality functions,
-        rather than being called directly by the user. (Though it isn't
-        hard to call manually, since almost everything is given a default)
-        This method is only functional when the query is closed (or hasn't
-        yet been opened).  This is to prevent conflict in multi-threaded
-        query applications).
-        e.g.:
-                query.addcounter('Memory','Available Bytes')
-        """
-        if not self.active:
-            try:
-                self.rawaddcounter(object, counter, instance, inum, machine)
-                return 0
-            except win32api.error:
-                return -1
-        else:
-            return -1
-
-    def open(self):
-        """
-        Build the base query object for this wrapper,
-        then add all of the counters required for the query.
-        Raise a QueryError if we can't complete the functions.
-        If we are already open, then do nothing.
-        """
-        if not self.active:  # to prevent having multiple open queries
-            # curpaths are made accessible here because of the possibility of volatile paths
-            # which may be dynamically altered by subclasses.
-            self.curpaths = copy.copy(self.paths)
-            try:
-                base = win32pdh.OpenQuery()
-                for path in self.paths:
-                    try:
-                        self.counters.append(win32pdh.AddCounter(base, path))
-                    except win32api.error:  # we passed a bad path
-                        self.counters.append(0)
-                        pass
-                self._base = base
-                self.active = 1
-                return 0  # open succeeded
-            except:  # if we encounter any errors, kill the Query
-                try:
-                    self.killbase(base)
-                except NameError:  # failed in creating query
-                    pass
-                self.active = 0
-                self.curpaths = []
-                raise QueryError(self)
-        return 1  # already open
-
-    def killbase(self, base=None):
-        """
-        ### This is not a public method
-        Mission critical function to kill the win32pdh objects held
-        by this object.  User's should generally use the close method
-        instead of this method, in case a sub-class has overridden
-        close to provide some special functionality.
-        """
-        # Kill Pythonic references to the objects in this object's namespace
-        self._base = None
-        counters = self.counters
-        self.counters = []
-        # we don't kill the curpaths for convenience, this allows the
-        # user to close a query and still access the last paths
-        self.active = 0
-        # Now call the delete functions on all of the objects
-        try:
-            map(win32pdh.RemoveCounter, counters)
-        except:
-            pass
-        try:
-            win32pdh.CloseQuery(base)
-        except:
-            pass
-        del counters
-        del base
-
-    def close(self):
-        """
-        Makes certain that the underlying query object has been closed,
-        and that all counters have been removed from it.  This is
-        important for reference counting.
-        You should only need to call close if you have previously called
-        open.  The collectdata methods all can handle opening and
-        closing the query.  Calling close multiple times is acceptable.
-        """
-        try:
-            self.killbase(self._base)
-        except AttributeError:
-            self.killbase()
-
-    __del__ = close
-
-    def collectdata(self, format=win32pdh.PDH_FMT_LONG):
-        """
-        Returns the formatted current values for the Query
-        """
-        if self._base:  # we are currently open, don't change this
-            return self.collectdataslave(format)
-        else:  # need to open and then close the _base, should be used by one-offs and elements tracking application instances
-            self.open()  # will raise QueryError if couldn't open the query
-            temp = self.collectdataslave(format)
-            self.close()  # will always close
-            return temp
-
-    def collectdataslave(self, format=win32pdh.PDH_FMT_LONG):
-        """
-        ### Not a public method
-        Called only when the Query is known to be open, runs over
-        the whole set of counters, appending results to the temp,
-        returns the values as a list.
-        """
-        try:
-            win32pdh.CollectQueryData(self._base)
-            temp = []
-            for counter in self.counters:
-                ok = 0
-                try:
-                    if counter:
-                        temp.append(
-                            win32pdh.GetFormattedCounterValue(counter, format)[1]
-                        )
-                        ok = 1
-                except win32api.error:
-                    pass
-                if not ok:
-                    temp.append(-1)  # a better way to signal failure???
-            return temp
-        except (
-            win32api.error
-        ):  # will happen if, for instance, no counters are part of the query and we attempt to collect data for it.
-            return [-1] * len(self.counters)
-
-    # pickle functions
-    def __getinitargs__(self):
-        """
-        ### Not a public method
-        """
-        return (self.paths,)
-
-
-class Query(BaseQuery):
-    """
-    Performance Data Helper(PDH) Query object:
-
-    Provides a wrapper around the native PDH query object which
-    allows for query reuse, query storage, and general maintenance
-    functions (adding counter paths in various ways being the most
-    obvious ones).
-    """
-
-    def __init__(self, *args, **namedargs):
-        """
-        The PDH Query object is initialised with a single, optional
-        list argument, that must be properly formatted PDH Counter
-        paths.  Generally this list will only be provided by the class
-        when it is being unpickled (removed from storage).  Normal
-        use is to call the class with no arguments and use the various
-        addcounter functions (particularly, for end user's, the use of
-        addcounterbybrowsing is the most common approach)  You might
-        want to provide the list directly if you want to hard-code the
-        elements with which your query deals (and thereby avoid the
-        overhead of unpickling the class).
-        """
-        self.volatilecounters = []
-        BaseQuery.__init__(*(self,) + args, **namedargs)
-
-    def addperfcounter(self, object, counter, machine=None):
-        """
-        A "Performance Counter" is a stable, known, common counter,
-        such as Memory, or Processor.  The use of addperfcounter by
-        end-users is deprecated, since the use of
-        addcounterbybrowsing is considerably more flexible and general.
-        It is provided here to allow the easy development of scripts
-        which need to access variables so common we know them by name
-        (such as Memory|Available Bytes), and to provide symmetry with
-        the add inst counter method.
-        usage:
-                query.addperfcounter('Memory', 'Available Bytes')
-        It is just as easy to access addcounter directly, the following
-        has an identicle effect.
-                query.addcounter('Memory', 'Available Bytes')
-        """
-        BaseQuery.addcounter(self, object=object, counter=counter, machine=machine)
-
-    def addinstcounter(
-        self,
-        object,
-        counter,
-        machine=None,
-        objtype="Process",
-        volatile=1,
-        format=win32pdh.PDH_FMT_LONG,
-    ):
-        """
-        The purpose of using an instcounter is to track particular
-        instances of a counter object (e.g. a single processor, a single
-        running copy of a process).  For instance, to track all python.exe
-        instances, you would need merely to ask:
-                query.addinstcounter('python','Virtual Bytes')
-        You can find the names of the objects and their available counters
-        by doing an addcounterbybrowsing() call on a query object (or by
-        looking in performance monitor's add dialog.)
-
-        Beyond merely rearranging the call arguments to make more sense,
-        if the volatile flag is true, the instcounters also recalculate
-        the paths of the available instances on every call to open the
-        query.
-        """
-        if volatile:
-            self.volatilecounters.append((object, counter, machine, objtype, format))
-        else:
-            self.paths[len(self.paths) :] = self.getinstpaths(
-                object, counter, machine, objtype, format
-            )
-
-    def getinstpaths(
-        self,
-        object,
-        counter,
-        machine=None,
-        objtype="Process",
-        format=win32pdh.PDH_FMT_LONG,
-    ):
-        """
-        ### Not an end-user function
-        Calculate the paths for an instance object. Should alter
-        to allow processing for lists of object-counter pairs.
-        """
-        items, instances = win32pdh.EnumObjectItems(None, None, objtype, -1)
-        # find out how many instances of this element we have...
-        instances.sort()
-        try:
-            cur = instances.index(object)
-        except ValueError:
-            return []  # no instances of this object
-        temp = [object]
-        try:
-            while instances[cur + 1] == object:
-                temp.append(object)
-                cur = cur + 1
-        except IndexError:  # if we went over the end
-            pass
-        paths = []
-        for ind in range(len(temp)):
-            # can this raise an error?
-            paths.append(
-                win32pdh.MakeCounterPath(
-                    (machine, "Process", object, None, ind, counter)
-                )
-            )
-        return paths  # should also return the number of elements for naming purposes
-
-    def open(self, *args, **namedargs):
-        """
-        Explicitly open a query:
-        When you are needing to make multiple calls to the same query,
-        it is most efficient to open the query, run all of the calls,
-        then close the query, instead of having the collectdata method
-        automatically open and close the query each time it runs.
-        There are currently no arguments to open.
-        """
-        # do all the normal opening stuff, self._base is now the query object
-        BaseQuery.open(*(self,) + args, **namedargs)
-        # should rewrite getinstpaths to take a single tuple
-        paths = []
-        for tup in self.volatilecounters:
-            paths[len(paths) :] = self.getinstpaths(*tup)
-        for path in paths:
-            try:
-                self.counters.append(win32pdh.AddCounter(self._base, path))
-                self.curpaths.append(
-                    path
-                )  # if we fail on the line above, this path won't be in the table or the counters
-            except win32api.error:
-                pass  # again, what to do with a malformed path???
-
-    def collectdatafor(self, totalperiod, period=1):
-        """
-        Non-threaded collection of performance data:
-        This method allows you to specify the total period for which you would
-        like to run the Query, and the time interval between individual
-        runs.  The collected data is stored in query.curresults at the
-        _end_ of the run.  The pathnames for the query are stored in
-        query.curpaths.
-        e.g.:
-                query.collectdatafor(30,2)
-        Will collect data for 30seconds at 2 second intervals
-        """
-        tempresults = []
-        try:
-            self.open()
-            for ind in range(totalperiod / period):
-                tempresults.append(self.collectdata())
-                time.sleep(period)
-            self.curresults = tempresults
-        finally:
-            self.close()
-
-    def collectdatawhile(self, period=1):
-        """
-        Threaded collection of performance data:
-        This method sets up a simple semaphor system for signalling
-        when you would like to start and stop a threaded data collection
-        method.  The collection runs every period seconds until the
-        semaphor attribute is set to a non-true value (which normally
-        should be done by calling query.collectdatawhile_stop() .)
-        e.g.:
-                query.collectdatawhile(2)
-                # starts the query running, returns control to the caller immediately
-                # is collecting data every two seconds.
-                # do whatever you want to do while the thread runs, then call:
-                query.collectdatawhile_stop()
-                # when you want to deal with the data.  It is generally a good idea
-                # to sleep for period seconds yourself, since the query will not copy
-                # the required data until the next iteration:
-                time.sleep(2)
-                # now you can access the data from the attributes of the query
-                query.curresults
-                query.curpaths
-        """
-        self.collectdatawhile_active = 1
-        _thread.start_new_thread(self.collectdatawhile_slave, (period,))
-
-    def collectdatawhile_stop(self):
-        """
-        Signals the collectdatawhile slave thread to stop collecting data
-        on the next logging iteration.
-        """
-        self.collectdatawhile_active = 0
-
-    def collectdatawhile_slave(self, period):
-        """
-        ### Not a public function
-        Does the threaded work of collecting the data and storing it
-        in an attribute of the class.
-        """
-        tempresults = []
-        try:
-            self.open()  # also sets active, so can't be changed.
-            while self.collectdatawhile_active:
-                tempresults.append(self.collectdata())
-                time.sleep(period)
-            self.curresults = tempresults
-        finally:
-            self.close()
-
-    # pickle functions
-    def __getinitargs__(self):
-        return (self.paths,)
-
-    def __getstate__(self):
-        return self.volatilecounters
-
-    def __setstate__(self, volatilecounters):
-        self.volatilecounters = volatilecounters
-
-
-class QueryError:
-    def __init__(self, query):
-        self.query = query
-
-    def __repr__(self):
-        return "<Query Error in %s>" % repr(self.query)
-
-    __str__ = __repr__
diff --git a/lib/win32/lib/win32pdhutil.py b/lib/win32/lib/win32pdhutil.py
deleted file mode 100644
index 7795dd90..00000000
--- a/lib/win32/lib/win32pdhutil.py
+++ /dev/null
@@ -1,210 +0,0 @@
-"""Utilities for the win32 Performance Data Helper module
-
-Example:
-  To get a single bit of data:
-  >>> import win32pdhutil
-  >>> win32pdhutil.GetPerformanceAttributes("Memory", "Available Bytes")
-  6053888
-  >>> win32pdhutil.FindPerformanceAttributesByName("python", counter="Virtual Bytes")
-  [22278144]
-
-  First example returns data which is not associated with any specific instance.
-
-  The second example reads data for a specific instance - hence the list return -
-  it would return one result for each instance of Python running.
-
-  In general, it can be tricky finding exactly the "name" of the data you wish to query.
-  Although you can use <om win32pdh.EnumObjectItems>(None,None,(eg)"Memory", -1) to do this,
-  the easiest way is often to simply use PerfMon to find out the names.
-"""
-
-import time
-
-import win32pdh
-
-error = win32pdh.error
-
-# Handle some localization issues.
-# see http://support.microsoft.com/default.aspx?scid=http://support.microsoft.com:80/support/kb/articles/Q287/1/59.asp&NoWebContent=1
-# Build a map of english_counter_name: counter_id
-counter_english_map = {}
-
-
-def find_pdh_counter_localized_name(english_name, machine_name=None):
-    if not counter_english_map:
-        import win32api
-        import win32con
-
-        counter_reg_value = win32api.RegQueryValueEx(
-            win32con.HKEY_PERFORMANCE_DATA, "Counter 009"
-        )
-        counter_list = counter_reg_value[0]
-        for i in range(0, len(counter_list) - 1, 2):
-            try:
-                counter_id = int(counter_list[i])
-            except ValueError:
-                continue
-            counter_english_map[counter_list[i + 1].lower()] = counter_id
-    return win32pdh.LookupPerfNameByIndex(
-        machine_name, counter_english_map[english_name.lower()]
-    )
-
-
-def GetPerformanceAttributes(
-    object, counter, instance=None, inum=-1, format=win32pdh.PDH_FMT_LONG, machine=None
-):
-    # NOTE: Many counters require 2 samples to give accurate results,
-    # including "% Processor Time" (as by definition, at any instant, a
-    # thread's CPU usage is either 0 or 100).  To read counters like this,
-    # you should copy this function, but keep the counter open, and call
-    # CollectQueryData() each time you need to know.
-    # See http://support.microsoft.com/default.aspx?scid=kb;EN-US;q262938
-    # and http://msdn.microsoft.com/library/en-us/dnperfmo/html/perfmonpt2.asp
-    # My older explanation for this was that the "AddCounter" process forced
-    # the CPU to 100%, but the above makes more sense :)
-    path = win32pdh.MakeCounterPath((machine, object, instance, None, inum, counter))
-    hq = win32pdh.OpenQuery()
-    try:
-        hc = win32pdh.AddCounter(hq, path)
-        try:
-            win32pdh.CollectQueryData(hq)
-            type, val = win32pdh.GetFormattedCounterValue(hc, format)
-            return val
-        finally:
-            win32pdh.RemoveCounter(hc)
-    finally:
-        win32pdh.CloseQuery(hq)
-
-
-def FindPerformanceAttributesByName(
-    instanceName,
-    object=None,
-    counter=None,
-    format=win32pdh.PDH_FMT_LONG,
-    machine=None,
-    bRefresh=0,
-):
-    """Find performance attributes by (case insensitive) instance name.
-
-    Given a process name, return a list with the requested attributes.
-    Most useful for returning a tuple of PIDs given a process name.
-    """
-    if object is None:
-        object = find_pdh_counter_localized_name("Process", machine)
-    if counter is None:
-        counter = find_pdh_counter_localized_name("ID Process", machine)
-    if bRefresh:  # PDH docs say this is how you do a refresh.
-        win32pdh.EnumObjects(None, machine, 0, 1)
-    instanceName = instanceName.lower()
-    items, instances = win32pdh.EnumObjectItems(None, None, object, -1)
-    # Track multiple instances.
-    instance_dict = {}
-    for instance in instances:
-        try:
-            instance_dict[instance] = instance_dict[instance] + 1
-        except KeyError:
-            instance_dict[instance] = 0
-
-    ret = []
-    for instance, max_instances in instance_dict.items():
-        for inum in range(max_instances + 1):
-            if instance.lower() == instanceName:
-                ret.append(
-                    GetPerformanceAttributes(
-                        object, counter, instance, inum, format, machine
-                    )
-                )
-    return ret
-
-
-def ShowAllProcesses():
-    object = find_pdh_counter_localized_name("Process")
-    items, instances = win32pdh.EnumObjectItems(
-        None, None, object, win32pdh.PERF_DETAIL_WIZARD
-    )
-    # Need to track multiple instances of the same name.
-    instance_dict = {}
-    for instance in instances:
-        try:
-            instance_dict[instance] = instance_dict[instance] + 1
-        except KeyError:
-            instance_dict[instance] = 0
-
-    # Bit of a hack to get useful info.
-    items = [find_pdh_counter_localized_name("ID Process")] + items[:5]
-    print("Process Name", ",".join(items))
-    for instance, max_instances in instance_dict.items():
-        for inum in range(max_instances + 1):
-            hq = win32pdh.OpenQuery()
-            hcs = []
-            for item in items:
-                path = win32pdh.MakeCounterPath(
-                    (None, object, instance, None, inum, item)
-                )
-                hcs.append(win32pdh.AddCounter(hq, path))
-            win32pdh.CollectQueryData(hq)
-            # as per http://support.microsoft.com/default.aspx?scid=kb;EN-US;q262938, some "%" based
-            # counters need two collections
-            time.sleep(0.01)
-            win32pdh.CollectQueryData(hq)
-            print("%-15s\t" % (instance[:15]), end=" ")
-            for hc in hcs:
-                type, val = win32pdh.GetFormattedCounterValue(hc, win32pdh.PDH_FMT_LONG)
-                print("%5d" % (val), end=" ")
-                win32pdh.RemoveCounter(hc)
-            print()
-            win32pdh.CloseQuery(hq)
-
-
-# NOTE: This BrowseCallback doesn't seem to work on Vista for markh.
-# XXX - look at why!?
-# Some counters on Vista require elevation, and callback would previously
-# clear exceptions without printing them.
-def BrowseCallBackDemo(counters):
-    ## BrowseCounters can now return multiple counter paths
-    for counter in counters:
-        (
-            machine,
-            object,
-            instance,
-            parentInstance,
-            index,
-            counterName,
-        ) = win32pdh.ParseCounterPath(counter)
-
-        result = GetPerformanceAttributes(
-            object, counterName, instance, index, win32pdh.PDH_FMT_DOUBLE, machine
-        )
-        print("Value of '%s' is" % counter, result)
-        print(
-            "Added '%s' on object '%s' (machine %s), instance %s(%d)-parent of %s"
-            % (counterName, object, machine, instance, index, parentInstance)
-        )
-    return 0
-
-
-def browse(
-    callback=BrowseCallBackDemo,
-    title="Python Browser",
-    level=win32pdh.PERF_DETAIL_WIZARD,
-):
-    win32pdh.BrowseCounters(None, 0, callback, level, title, ReturnMultiple=True)
-
-
-if __name__ == "__main__":
-    ShowAllProcesses()
-    # Show how to get a couple of attributes by name.
-    counter = find_pdh_counter_localized_name("Virtual Bytes")
-    print(
-        "Virtual Bytes = ", FindPerformanceAttributesByName("python", counter=counter)
-    )
-    print(
-        "Available Bytes = ",
-        GetPerformanceAttributes(
-            find_pdh_counter_localized_name("Memory"),
-            find_pdh_counter_localized_name("Available Bytes"),
-        ),
-    )
-    # And a browser.
-    print("Browsing for counters...")
-    browse()
diff --git a/lib/win32/lib/win32rcparser.py b/lib/win32/lib/win32rcparser.py
deleted file mode 100644
index effe1429..00000000
--- a/lib/win32/lib/win32rcparser.py
+++ /dev/null
@@ -1,677 +0,0 @@
-# Windows dialog .RC file parser, by Adam Walker.
-
-# This module was adapted from the spambayes project, and is Copyright
-# 2003/2004 The Python Software Foundation and is covered by the Python
-# Software Foundation license.
-"""
-This is a parser for Windows .rc files, which are text files which define
-dialogs and other Windows UI resources.
-"""
-__author__ = "Adam Walker"
-__version__ = "0.11"
-
-import os
-import pprint
-import shlex
-import stat
-import sys
-
-import commctrl
-import win32con
-
-_controlMap = {
-    "DEFPUSHBUTTON": 0x80,
-    "PUSHBUTTON": 0x80,
-    "Button": 0x80,
-    "GROUPBOX": 0x80,
-    "Static": 0x82,
-    "CTEXT": 0x82,
-    "RTEXT": 0x82,
-    "LTEXT": 0x82,
-    "LISTBOX": 0x83,
-    "SCROLLBAR": 0x84,
-    "COMBOBOX": 0x85,
-    "EDITTEXT": 0x81,
-    "ICON": 0x82,
-    "RICHEDIT": "RichEdit20A",
-}
-
-# These are "default styles" for certain controls - ie, Visual Studio assumes
-# the styles will be applied, and emits a "NOT {STYLE_NAME}" if it is to be
-# disabled.  These defaults have been determined by experimentation, so may
-# not be completely accurate (most notably, some styles and/or control-types
-# may be missing.
-_addDefaults = {
-    "EDITTEXT": win32con.WS_BORDER | win32con.WS_TABSTOP,
-    "GROUPBOX": win32con.BS_GROUPBOX,
-    "LTEXT": win32con.SS_LEFT,
-    "DEFPUSHBUTTON": win32con.BS_DEFPUSHBUTTON | win32con.WS_TABSTOP,
-    "PUSHBUTTON": win32con.WS_TABSTOP,
-    "CTEXT": win32con.SS_CENTER,
-    "RTEXT": win32con.SS_RIGHT,
-    "ICON": win32con.SS_ICON,
-    "LISTBOX": win32con.LBS_NOTIFY,
-}
-
-defaultControlStyle = win32con.WS_CHILD | win32con.WS_VISIBLE
-defaultControlStyleEx = 0
-
-
-class DialogDef:
-    name = ""
-    id = 0
-    style = 0
-    styleEx = None
-    caption = ""
-    font = "MS Sans Serif"
-    fontSize = 8
-    x = 0
-    y = 0
-    w = 0
-    h = 0
-    template = None
-
-    def __init__(self, n, i):
-        self.name = n
-        self.id = i
-        self.styles = []
-        self.stylesEx = []
-        self.controls = []
-        # print "dialog def for ",self.name, self.id
-
-    def createDialogTemplate(self):
-        t = None
-        self.template = [
-            [
-                self.caption,
-                (self.x, self.y, self.w, self.h),
-                self.style,
-                self.styleEx,
-                (self.fontSize, self.font),
-            ]
-        ]
-        # Add the controls
-        for control in self.controls:
-            self.template.append(control.createDialogTemplate())
-        return self.template
-
-
-class ControlDef:
-    id = ""
-    controlType = ""
-    subType = ""
-    idNum = 0
-    style = defaultControlStyle
-    styleEx = defaultControlStyleEx
-    label = ""
-    x = 0
-    y = 0
-    w = 0
-    h = 0
-
-    def __init__(self):
-        self.styles = []
-        self.stylesEx = []
-
-    def toString(self):
-        s = (
-            "<Control id:"
-            + self.id
-            + " controlType:"
-            + self.controlType
-            + " subType:"
-            + self.subType
-            + " idNum:"
-            + str(self.idNum)
-            + " style:"
-            + str(self.style)
-            + " styles:"
-            + str(self.styles)
-            + " label:"
-            + self.label
-            + " x:"
-            + str(self.x)
-            + " y:"
-            + str(self.y)
-            + " w:"
-            + str(self.w)
-            + " h:"
-            + str(self.h)
-            + ">"
-        )
-        return s
-
-    def createDialogTemplate(self):
-        ct = self.controlType
-        if "CONTROL" == ct:
-            ct = self.subType
-        if ct in _controlMap:
-            ct = _controlMap[ct]
-        t = [
-            ct,
-            self.label,
-            self.idNum,
-            (self.x, self.y, self.w, self.h),
-            self.style,
-            self.styleEx,
-        ]
-        # print t
-        return t
-
-
-class StringDef:
-    def __init__(self, id, idNum, value):
-        self.id = id
-        self.idNum = idNum
-        self.value = value
-
-    def __repr__(self):
-        return "StringDef(%r, %r, %r)" % (self.id, self.idNum, self.value)
-
-
-class RCParser:
-    next_id = 1001
-    dialogs = {}
-    _dialogs = {}
-    debugEnabled = False
-    token = ""
-
-    def __init__(self):
-        self.ungot = False
-        self.ids = {"IDC_STATIC": -1}
-        self.names = {-1: "IDC_STATIC"}
-        self.bitmaps = {}
-        self.stringTable = {}
-        self.icons = {}
-
-    def debug(self, *args):
-        if self.debugEnabled:
-            print(args)
-
-    def getToken(self):
-        if self.ungot:
-            self.ungot = False
-            self.debug("getToken returns (ungot):", self.token)
-            return self.token
-        self.token = self.lex.get_token()
-        self.debug("getToken returns:", self.token)
-        if self.token == "":
-            self.token = None
-        return self.token
-
-    def ungetToken(self):
-        self.ungot = True
-
-    def getCheckToken(self, expected):
-        tok = self.getToken()
-        assert tok == expected, "Expected token '%s', but got token '%s'!" % (
-            expected,
-            tok,
-        )
-        return tok
-
-    def getCommaToken(self):
-        return self.getCheckToken(",")
-
-    # Return the *current* token as a number, only consuming a token
-    # if it is the negative-sign.
-    def currentNumberToken(self):
-        mult = 1
-        if self.token == "-":
-            mult = -1
-            self.getToken()
-        return int(self.token) * mult
-
-    # Return the *current* token as a string literal (ie, self.token will be a
-    # quote.  consumes all tokens until the end of the string
-    def currentQuotedString(self):
-        # Handle quoted strings - pity shlex doesn't handle it.
-        assert self.token.startswith('"'), self.token
-        bits = [self.token]
-        while 1:
-            tok = self.getToken()
-            if not tok.startswith('"'):
-                self.ungetToken()
-                break
-            bits.append(tok)
-        sval = "".join(bits)[1:-1]  # Remove end quotes.
-        # Fixup quotes in the body, and all (some?) quoted characters back
-        # to their raw value.
-        for i, o in ('""', '"'), ("\\r", "\r"), ("\\n", "\n"), ("\\t", "\t"):
-            sval = sval.replace(i, o)
-        return sval
-
-    def load(self, rcstream):
-        """
-        RCParser.loadDialogs(rcFileName) -> None
-        Load the dialog information into the parser. Dialog Definations can then be accessed
-        using the "dialogs" dictionary member (name->DialogDef). The "ids" member contains the dictionary of id->name.
-        The "names" member contains the dictionary of name->id
-        """
-        self.open(rcstream)
-        self.getToken()
-        while self.token != None:
-            self.parse()
-            self.getToken()
-
-    def open(self, rcstream):
-        self.lex = shlex.shlex(rcstream)
-        self.lex.commenters = "//#"
-
-    def parseH(self, file):
-        lex = shlex.shlex(file)
-        lex.commenters = "//"
-        token = " "
-        while token is not None:
-            token = lex.get_token()
-            if token == "" or token is None:
-                token = None
-            else:
-                if token == "define":
-                    n = lex.get_token()
-                    i = int(lex.get_token())
-                    self.ids[n] = i
-                    if i in self.names:
-                        # Dupe ID really isn't a problem - most consumers
-                        # want to go from name->id, and this is OK.
-                        # It means you can't go from id->name though.
-                        pass
-                        # ignore AppStudio special ones
-                        # if not n.startswith("_APS_"):
-                        #    print "Duplicate id",i,"for",n,"is", self.names[i]
-                    else:
-                        self.names[i] = n
-                    if self.next_id <= i:
-                        self.next_id = i + 1
-
-    def parse(self):
-        noid_parsers = {
-            "STRINGTABLE": self.parse_stringtable,
-        }
-
-        id_parsers = {
-            "DIALOG": self.parse_dialog,
-            "DIALOGEX": self.parse_dialog,
-            #            "TEXTINCLUDE":      self.parse_textinclude,
-            "BITMAP": self.parse_bitmap,
-            "ICON": self.parse_icon,
-        }
-        deep = 0
-        base_token = self.token
-        rp = noid_parsers.get(base_token)
-        if rp is not None:
-            rp()
-        else:
-            # Not something we parse that isn't prefixed by an ID
-            # See if it is an ID prefixed item - if it is, our token
-            # is the resource ID.
-            resource_id = self.token
-            self.getToken()
-            if self.token is None:
-                return
-
-            if "BEGIN" == self.token:
-                # A 'BEGIN' for a structure we don't understand - skip to the
-                # matching 'END'
-                deep = 1
-                while deep != 0 and self.token is not None:
-                    self.getToken()
-                    self.debug("Zooming over", self.token)
-                    if "BEGIN" == self.token:
-                        deep += 1
-                    elif "END" == self.token:
-                        deep -= 1
-            else:
-                rp = id_parsers.get(self.token)
-                if rp is not None:
-                    self.debug("Dispatching '%s'" % (self.token,))
-                    rp(resource_id)
-                else:
-                    # We don't know what the resource type is, but we
-                    # have already consumed the next, which can cause problems,
-                    # so push it back.
-                    self.debug("Skipping top-level '%s'" % base_token)
-                    self.ungetToken()
-
-    def addId(self, id_name):
-        if id_name in self.ids:
-            id = self.ids[id_name]
-        else:
-            # IDOK, IDCANCEL etc are special - if a real resource has this value
-            for n in ["IDOK", "IDCANCEL", "IDYES", "IDNO", "IDABORT"]:
-                if id_name == n:
-                    v = getattr(win32con, n)
-                    self.ids[n] = v
-                    self.names[v] = n
-                    return v
-            id = self.next_id
-            self.next_id += 1
-            self.ids[id_name] = id
-            self.names[id] = id_name
-        return id
-
-    def lang(self):
-        while (
-            self.token[0:4] == "LANG"
-            or self.token[0:7] == "SUBLANG"
-            or self.token == ","
-        ):
-            self.getToken()
-
-    def parse_textinclude(self, res_id):
-        while self.getToken() != "BEGIN":
-            pass
-        while 1:
-            if self.token == "END":
-                break
-            s = self.getToken()
-
-    def parse_stringtable(self):
-        while self.getToken() != "BEGIN":
-            pass
-        while 1:
-            self.getToken()
-            if self.token == "END":
-                break
-            sid = self.token
-            self.getToken()
-            sd = StringDef(sid, self.addId(sid), self.currentQuotedString())
-            self.stringTable[sid] = sd
-
-    def parse_bitmap(self, name):
-        return self.parse_bitmap_or_icon(name, self.bitmaps)
-
-    def parse_icon(self, name):
-        return self.parse_bitmap_or_icon(name, self.icons)
-
-    def parse_bitmap_or_icon(self, name, dic):
-        self.getToken()
-        while not self.token.startswith('"'):
-            self.getToken()
-        bmf = self.token[1:-1]  # quotes
-        dic[name] = bmf
-
-    def parse_dialog(self, name):
-        dlg = DialogDef(name, self.addId(name))
-        assert len(dlg.controls) == 0
-        self._dialogs[name] = dlg
-        extras = []
-        self.getToken()
-        while not self.token.isdigit():
-            self.debug("extra", self.token)
-            extras.append(self.token)
-            self.getToken()
-        dlg.x = int(self.token)
-        self.getCommaToken()
-        self.getToken()  # number
-        dlg.y = int(self.token)
-        self.getCommaToken()
-        self.getToken()  # number
-        dlg.w = int(self.token)
-        self.getCommaToken()
-        self.getToken()  # number
-        dlg.h = int(self.token)
-        self.getToken()
-        while not (self.token == None or self.token == "" or self.token == "END"):
-            if self.token == "STYLE":
-                self.dialogStyle(dlg)
-            elif self.token == "EXSTYLE":
-                self.dialogExStyle(dlg)
-            elif self.token == "CAPTION":
-                self.dialogCaption(dlg)
-            elif self.token == "FONT":
-                self.dialogFont(dlg)
-            elif self.token == "BEGIN":
-                self.controls(dlg)
-            else:
-                break
-        self.dialogs[name] = dlg.createDialogTemplate()
-
-    def dialogStyle(self, dlg):
-        dlg.style, dlg.styles = self.styles([], win32con.DS_SETFONT)
-
-    def dialogExStyle(self, dlg):
-        self.getToken()
-        dlg.styleEx, dlg.stylesEx = self.styles([], 0)
-
-    def styles(self, defaults, defaultStyle):
-        list = defaults
-        style = defaultStyle
-
-        if "STYLE" == self.token:
-            self.getToken()
-        i = 0
-        Not = False
-        while (
-            (i % 2 == 1 and ("|" == self.token or "NOT" == self.token)) or (i % 2 == 0)
-        ) and not self.token == None:
-            Not = False
-            if "NOT" == self.token:
-                Not = True
-                self.getToken()
-            i += 1
-            if self.token != "|":
-                if self.token in win32con.__dict__:
-                    value = getattr(win32con, self.token)
-                else:
-                    if self.token in commctrl.__dict__:
-                        value = getattr(commctrl, self.token)
-                    else:
-                        value = 0
-                if Not:
-                    list.append("NOT " + self.token)
-                    self.debug("styles add Not", self.token, value)
-                    style &= ~value
-                else:
-                    list.append(self.token)
-                    self.debug("styles add", self.token, value)
-                    style |= value
-            self.getToken()
-        self.debug("style is ", style)
-
-        return style, list
-
-    def dialogCaption(self, dlg):
-        if "CAPTION" == self.token:
-            self.getToken()
-        self.token = self.token[1:-1]
-        self.debug("Caption is:", self.token)
-        dlg.caption = self.token
-        self.getToken()
-
-    def dialogFont(self, dlg):
-        if "FONT" == self.token:
-            self.getToken()
-        dlg.fontSize = int(self.token)
-        self.getCommaToken()
-        self.getToken()  # Font name
-        dlg.font = self.token[1:-1]  # it's quoted
-        self.getToken()
-        while "BEGIN" != self.token:
-            self.getToken()
-
-    def controls(self, dlg):
-        if self.token == "BEGIN":
-            self.getToken()
-        # All controls look vaguely like:
-        # TYPE [text, ] Control_id, l, t, r, b [, style]
-        # .rc parser documents all control types as:
-        # CHECKBOX, COMBOBOX, CONTROL, CTEXT, DEFPUSHBUTTON, EDITTEXT, GROUPBOX,
-        # ICON, LISTBOX, LTEXT, PUSHBUTTON, RADIOBUTTON, RTEXT, SCROLLBAR
-        without_text = ["EDITTEXT", "COMBOBOX", "LISTBOX", "SCROLLBAR"]
-        while self.token != "END":
-            control = ControlDef()
-            control.controlType = self.token
-            self.getToken()
-            if control.controlType not in without_text:
-                if self.token[0:1] == '"':
-                    control.label = self.currentQuotedString()
-                # Some funny controls, like icons and picture controls use
-                # the "window text" as extra resource ID (ie, the ID of the
-                # icon itself).  This may be either a literal, or an ID string.
-                elif self.token == "-" or self.token.isdigit():
-                    control.label = str(self.currentNumberToken())
-                else:
-                    # An ID - use the numeric equiv.
-                    control.label = str(self.addId(self.token))
-                self.getCommaToken()
-                self.getToken()
-            # Control IDs may be "names" or literal ints
-            if self.token == "-" or self.token.isdigit():
-                control.id = self.currentNumberToken()
-                control.idNum = control.id
-            else:
-                # name of an ID
-                control.id = self.token
-                control.idNum = self.addId(control.id)
-            self.getCommaToken()
-
-            if control.controlType == "CONTROL":
-                self.getToken()
-                control.subType = self.token[1:-1]
-                thisDefaultStyle = defaultControlStyle | _addDefaults.get(
-                    control.subType, 0
-                )
-                # Styles
-                self.getCommaToken()
-                self.getToken()
-                control.style, control.styles = self.styles([], thisDefaultStyle)
-            else:
-                thisDefaultStyle = defaultControlStyle | _addDefaults.get(
-                    control.controlType, 0
-                )
-                # incase no style is specified.
-                control.style = thisDefaultStyle
-            # Rect
-            control.x = int(self.getToken())
-            self.getCommaToken()
-            control.y = int(self.getToken())
-            self.getCommaToken()
-            control.w = int(self.getToken())
-            self.getCommaToken()
-            self.getToken()
-            control.h = int(self.token)
-            self.getToken()
-            if self.token == ",":
-                self.getToken()
-                control.style, control.styles = self.styles([], thisDefaultStyle)
-            if self.token == ",":
-                self.getToken()
-                control.styleEx, control.stylesEx = self.styles(
-                    [], defaultControlStyleEx
-                )
-            # print control.toString()
-            dlg.controls.append(control)
-
-
-def ParseStreams(rc_file, h_file):
-    rcp = RCParser()
-    if h_file:
-        rcp.parseH(h_file)
-    try:
-        rcp.load(rc_file)
-    except:
-        lex = getattr(rcp, "lex", None)
-        if lex:
-            print("ERROR parsing dialogs at line", lex.lineno)
-            print("Next 10 tokens are:")
-            for i in range(10):
-                print(lex.get_token(), end=" ")
-            print()
-        raise
-    return rcp
-
-
-def Parse(rc_name, h_name=None):
-    if h_name:
-        h_file = open(h_name, "r")
-    else:
-        # See if same basename as the .rc
-        h_name = rc_name[:-2] + "h"
-        try:
-            h_file = open(h_name, "r")
-        except IOError:
-            # See if MSVC default of 'resource.h' in the same dir.
-            h_name = os.path.join(os.path.dirname(rc_name), "resource.h")
-            try:
-                h_file = open(h_name, "r")
-            except IOError:
-                # .h files are optional anyway
-                h_file = None
-    rc_file = open(rc_name, "r")
-    try:
-        return ParseStreams(rc_file, h_file)
-    finally:
-        if h_file is not None:
-            h_file.close()
-        rc_file.close()
-    return rcp
-
-
-def GenerateFrozenResource(rc_name, output_name, h_name=None):
-    """Converts an .rc windows resource source file into a python source file
-    with the same basic public interface as the rest of this module.
-    Particularly useful for py2exe or other 'freeze' type solutions,
-    where a frozen .py file can be used inplace of a real .rc file.
-    """
-    rcp = Parse(rc_name, h_name)
-    in_stat = os.stat(rc_name)
-
-    out = open(output_name, "wt")
-    out.write("#%s\n" % output_name)
-    out.write("#This is a generated file. Please edit %s instead.\n" % rc_name)
-    out.write("__version__=%r\n" % __version__)
-    out.write(
-        "_rc_size_=%d\n_rc_mtime_=%d\n"
-        % (in_stat[stat.ST_SIZE], in_stat[stat.ST_MTIME])
-    )
-
-    out.write("class StringDef:\n")
-    out.write("\tdef __init__(self, id, idNum, value):\n")
-    out.write("\t\tself.id = id\n")
-    out.write("\t\tself.idNum = idNum\n")
-    out.write("\t\tself.value = value\n")
-    out.write("\tdef __repr__(self):\n")
-    out.write(
-        '\t\treturn "StringDef(%r, %r, %r)" % (self.id, self.idNum, self.value)\n'
-    )
-
-    out.write("class FakeParser:\n")
-
-    for name in "dialogs", "ids", "names", "bitmaps", "icons", "stringTable":
-        out.write("\t%s = \\\n" % (name,))
-        pprint.pprint(getattr(rcp, name), out)
-        out.write("\n")
-
-    out.write("def Parse(s):\n")
-    out.write("\treturn FakeParser()\n")
-    out.close()
-
-
-if __name__ == "__main__":
-    if len(sys.argv) <= 1:
-        print(__doc__)
-        print()
-        print("See test_win32rcparser.py, and the win32rcparser directory (both")
-        print("in the test suite) for an example of this module's usage.")
-    else:
-        import pprint
-
-        filename = sys.argv[1]
-        if "-v" in sys.argv:
-            RCParser.debugEnabled = 1
-        print("Dumping all resources in '%s'" % filename)
-        resources = Parse(filename)
-        for id, ddef in resources.dialogs.items():
-            print("Dialog %s (%d controls)" % (id, len(ddef)))
-            pprint.pprint(ddef)
-            print()
-        for id, sdef in resources.stringTable.items():
-            print("String %s=%r" % (id, sdef.value))
-            print()
-        for id, sdef in resources.bitmaps.items():
-            print("Bitmap %s=%r" % (id, sdef))
-            print()
-        for id, sdef in resources.icons.items():
-            print("Icon %s=%r" % (id, sdef))
-            print()
diff --git a/lib/win32/lib/win32serviceutil.py b/lib/win32/lib/win32serviceutil.py
deleted file mode 100644
index fb187530..00000000
--- a/lib/win32/lib/win32serviceutil.py
+++ /dev/null
@@ -1,1071 +0,0 @@
-# General purpose service utilities, both for standard Python scripts,
-# and for for Python programs which run as services...
-#
-# Note that most utility functions here will raise win32api.error's
-# (which is win32service.error, pywintypes.error, etc)
-# when things go wrong - eg, not enough permissions to hit the
-# registry etc.
-
-import importlib
-import os
-import sys
-import warnings
-
-import pywintypes
-import win32api
-import win32con
-import win32service
-import winerror
-
-_d = "_d" if "_d.pyd" in importlib.machinery.EXTENSION_SUFFIXES else ""
-error = RuntimeError
-
-
-# Returns the full path to an executable for hosting a Python service - typically
-# 'pythonservice.exe'
-# * If you pass a param and it exists as a file, you'll get the abs path back
-# * Otherwise we'll use the param instead of 'pythonservice.exe', and we will
-#   look for it.
-def LocatePythonServiceExe(exe=None):
-    if not exe and hasattr(sys, "frozen"):
-        # If py2exe etc calls this with no exe, default is current exe,
-        # and all setup is their problem :)
-        return sys.executable
-
-    if exe and os.path.isfile(exe):
-        return win32api.GetFullPathName(exe)
-
-    # We are confused if we aren't now looking for our default. But if that
-    # exists as specified we assume it's good.
-    exe = f"pythonservice{_d}.exe"
-    if os.path.isfile(exe):
-        return win32api.GetFullPathName(exe)
-
-    # Now we are searching for the .exe
-    # We are going to want it here.
-    correct = os.path.join(sys.exec_prefix, exe)
-    # Even if that file already exists, we copy the one installed by pywin32
-    # in-case it was upgraded.
-    # pywin32 installed it next to win32service.pyd (but we can't run it from there)
-    maybe = os.path.join(os.path.dirname(win32service.__file__), exe)
-    if os.path.exists(maybe):
-        print(f"copying host exe '{maybe}' -> '{correct}'")
-        win32api.CopyFile(maybe, correct)
-
-    if not os.path.exists(correct):
-        raise error(f"Can't find '{correct}'")
-
-    # If pywintypes.dll isn't next to us, or at least next to pythonXX.dll,
-    # there's a good chance the service will not run. That's usually copied by
-    # `pywin32_postinstall`, but putting it next to the python DLL seems
-    # reasonable.
-    # (Unlike the .exe above, we don't unconditionally copy this, and possibly
-    # copy it to a different place. Doesn't seem a good reason for that!?)
-    python_dll = win32api.GetModuleFileName(sys.dllhandle)
-    pyw = f"pywintypes{sys.version_info[0]}{sys.version_info[1]}{_d}.dll"
-    correct_pyw = os.path.join(os.path.dirname(python_dll), pyw)
-
-    if not os.path.exists(correct_pyw):
-        print(f"copying helper dll '{pywintypes.__file__}' -> '{correct_pyw}'")
-        win32api.CopyFile(pywintypes.__file__, correct_pyw)
-
-    return correct
-
-
-def _GetServiceShortName(longName):
-    # looks up a services name
-    # from the display name
-    # Thanks to Andy McKay for this code.
-    access = (
-        win32con.KEY_READ | win32con.KEY_ENUMERATE_SUB_KEYS | win32con.KEY_QUERY_VALUE
-    )
-    hkey = win32api.RegOpenKey(
-        win32con.HKEY_LOCAL_MACHINE, "SYSTEM\\CurrentControlSet\\Services", 0, access
-    )
-    num = win32api.RegQueryInfoKey(hkey)[0]
-    longName = longName.lower()
-    # loop through number of subkeys
-    for x in range(0, num):
-        # find service name, open subkey
-        svc = win32api.RegEnumKey(hkey, x)
-        skey = win32api.RegOpenKey(hkey, svc, 0, access)
-        try:
-            # find display name
-            thisName = str(win32api.RegQueryValueEx(skey, "DisplayName")[0])
-            if thisName.lower() == longName:
-                return svc
-        except win32api.error:
-            # in case there is no key called DisplayName
-            pass
-    return None
-
-
-# Open a service given either it's long or short name.
-def SmartOpenService(hscm, name, access):
-    try:
-        return win32service.OpenService(hscm, name, access)
-    except win32api.error as details:
-        if details.winerror not in [
-            winerror.ERROR_SERVICE_DOES_NOT_EXIST,
-            winerror.ERROR_INVALID_NAME,
-        ]:
-            raise
-    name = win32service.GetServiceKeyName(hscm, name)
-    return win32service.OpenService(hscm, name, access)
-
-
-def LocateSpecificServiceExe(serviceName):
-    # Return the .exe name of any service.
-    hkey = win32api.RegOpenKey(
-        win32con.HKEY_LOCAL_MACHINE,
-        "SYSTEM\\CurrentControlSet\\Services\\%s" % (serviceName),
-        0,
-        win32con.KEY_ALL_ACCESS,
-    )
-    try:
-        return win32api.RegQueryValueEx(hkey, "ImagePath")[0]
-    finally:
-        hkey.Close()
-
-
-def InstallPerfmonForService(serviceName, iniName, dllName=None):
-    # If no DLL name, look it up in the INI file name
-    if not dllName:  # May be empty string!
-        dllName = win32api.GetProfileVal("Python", "dll", "", iniName)
-    # Still not found - look for the standard one in the same dir as win32service.pyd
-    if not dllName:
-        try:
-            tryName = os.path.join(
-                os.path.split(win32service.__file__)[0], "perfmondata.dll"
-            )
-            if os.path.isfile(tryName):
-                dllName = tryName
-        except AttributeError:
-            # Frozen app? - anyway, can't find it!
-            pass
-    if not dllName:
-        raise ValueError("The name of the performance DLL must be available")
-    dllName = win32api.GetFullPathName(dllName)
-    # Now setup all the required "Performance" entries.
-    hkey = win32api.RegOpenKey(
-        win32con.HKEY_LOCAL_MACHINE,
-        "SYSTEM\\CurrentControlSet\\Services\\%s" % (serviceName),
-        0,
-        win32con.KEY_ALL_ACCESS,
-    )
-    try:
-        subKey = win32api.RegCreateKey(hkey, "Performance")
-        try:
-            win32api.RegSetValueEx(subKey, "Library", 0, win32con.REG_SZ, dllName)
-            win32api.RegSetValueEx(
-                subKey, "Open", 0, win32con.REG_SZ, "OpenPerformanceData"
-            )
-            win32api.RegSetValueEx(
-                subKey, "Close", 0, win32con.REG_SZ, "ClosePerformanceData"
-            )
-            win32api.RegSetValueEx(
-                subKey, "Collect", 0, win32con.REG_SZ, "CollectPerformanceData"
-            )
-        finally:
-            win32api.RegCloseKey(subKey)
-    finally:
-        win32api.RegCloseKey(hkey)
-    # Now do the "Lodctr" thang...
-
-    try:
-        import perfmon
-
-        path, fname = os.path.split(iniName)
-        oldPath = os.getcwd()
-        if path:
-            os.chdir(path)
-        try:
-            perfmon.LoadPerfCounterTextStrings("python.exe " + fname)
-        finally:
-            os.chdir(oldPath)
-    except win32api.error as details:
-        print("The service was installed OK, but the performance monitor")
-        print("data could not be loaded.", details)
-
-
-def _GetCommandLine(exeName, exeArgs):
-    if exeArgs is not None:
-        return exeName + " " + exeArgs
-    else:
-        return exeName
-
-
-def InstallService(
-    pythonClassString,
-    serviceName,
-    displayName,
-    startType=None,
-    errorControl=None,
-    bRunInteractive=0,
-    serviceDeps=None,
-    userName=None,
-    password=None,
-    exeName=None,
-    perfMonIni=None,
-    perfMonDll=None,
-    exeArgs=None,
-    description=None,
-    delayedstart=None,
-):
-    # Handle the default arguments.
-    if startType is None:
-        startType = win32service.SERVICE_DEMAND_START
-    serviceType = win32service.SERVICE_WIN32_OWN_PROCESS
-    if bRunInteractive:
-        serviceType = serviceType | win32service.SERVICE_INTERACTIVE_PROCESS
-    if errorControl is None:
-        errorControl = win32service.SERVICE_ERROR_NORMAL
-
-    exeName = '"%s"' % LocatePythonServiceExe(exeName)
-    commandLine = _GetCommandLine(exeName, exeArgs)
-    hscm = win32service.OpenSCManager(None, None, win32service.SC_MANAGER_ALL_ACCESS)
-    try:
-        hs = win32service.CreateService(
-            hscm,
-            serviceName,
-            displayName,
-            win32service.SERVICE_ALL_ACCESS,  # desired access
-            serviceType,  # service type
-            startType,
-            errorControl,  # error control type
-            commandLine,
-            None,
-            0,
-            serviceDeps,
-            userName,
-            password,
-        )
-        if description is not None:
-            try:
-                win32service.ChangeServiceConfig2(
-                    hs, win32service.SERVICE_CONFIG_DESCRIPTION, description
-                )
-            except NotImplementedError:
-                pass  ## ChangeServiceConfig2 and description do not exist on NT
-        if delayedstart is not None:
-            try:
-                win32service.ChangeServiceConfig2(
-                    hs,
-                    win32service.SERVICE_CONFIG_DELAYED_AUTO_START_INFO,
-                    delayedstart,
-                )
-            except (win32service.error, NotImplementedError):
-                ## delayed start only exists on Vista and later - warn only when trying to set delayed to True
-                warnings.warn("Delayed Start not available on this system")
-        win32service.CloseServiceHandle(hs)
-    finally:
-        win32service.CloseServiceHandle(hscm)
-    InstallPythonClassString(pythonClassString, serviceName)
-    # If I have performance monitor info to install, do that.
-    if perfMonIni is not None:
-        InstallPerfmonForService(serviceName, perfMonIni, perfMonDll)
-
-
-def ChangeServiceConfig(
-    pythonClassString,
-    serviceName,
-    startType=None,
-    errorControl=None,
-    bRunInteractive=0,
-    serviceDeps=None,
-    userName=None,
-    password=None,
-    exeName=None,
-    displayName=None,
-    perfMonIni=None,
-    perfMonDll=None,
-    exeArgs=None,
-    description=None,
-    delayedstart=None,
-):
-    # Before doing anything, remove any perfmon counters.
-    try:
-        import perfmon
-
-        perfmon.UnloadPerfCounterTextStrings("python.exe " + serviceName)
-    except (ImportError, win32api.error):
-        pass
-
-    # The EXE location may have changed
-    exeName = '"%s"' % LocatePythonServiceExe(exeName)
-
-    # Handle the default arguments.
-    if startType is None:
-        startType = win32service.SERVICE_NO_CHANGE
-    if errorControl is None:
-        errorControl = win32service.SERVICE_NO_CHANGE
-
-    hscm = win32service.OpenSCManager(None, None, win32service.SC_MANAGER_ALL_ACCESS)
-    serviceType = win32service.SERVICE_WIN32_OWN_PROCESS
-    if bRunInteractive:
-        serviceType = serviceType | win32service.SERVICE_INTERACTIVE_PROCESS
-    commandLine = _GetCommandLine(exeName, exeArgs)
-    try:
-        hs = SmartOpenService(hscm, serviceName, win32service.SERVICE_ALL_ACCESS)
-        try:
-            win32service.ChangeServiceConfig(
-                hs,
-                serviceType,  # service type
-                startType,
-                errorControl,  # error control type
-                commandLine,
-                None,
-                0,
-                serviceDeps,
-                userName,
-                password,
-                displayName,
-            )
-            if description is not None:
-                try:
-                    win32service.ChangeServiceConfig2(
-                        hs, win32service.SERVICE_CONFIG_DESCRIPTION, description
-                    )
-                except NotImplementedError:
-                    pass  ## ChangeServiceConfig2 and description do not exist on NT
-            if delayedstart is not None:
-                try:
-                    win32service.ChangeServiceConfig2(
-                        hs,
-                        win32service.SERVICE_CONFIG_DELAYED_AUTO_START_INFO,
-                        delayedstart,
-                    )
-                except (win32service.error, NotImplementedError):
-                    ## Delayed start only exists on Vista and later.  On Nt, will raise NotImplementedError since ChangeServiceConfig2
-                    ## doensn't exist.  On Win2k and XP, will fail with ERROR_INVALID_LEVEL
-                    ## Warn only if trying to set delayed to True
-                    if delayedstart:
-                        warnings.warn("Delayed Start not available on this system")
-        finally:
-            win32service.CloseServiceHandle(hs)
-    finally:
-        win32service.CloseServiceHandle(hscm)
-    InstallPythonClassString(pythonClassString, serviceName)
-    # If I have performance monitor info to install, do that.
-    if perfMonIni is not None:
-        InstallPerfmonForService(serviceName, perfMonIni, perfMonDll)
-
-
-def InstallPythonClassString(pythonClassString, serviceName):
-    # Now setup our Python specific entries.
-    if pythonClassString:
-        key = win32api.RegCreateKey(
-            win32con.HKEY_LOCAL_MACHINE,
-            "System\\CurrentControlSet\\Services\\%s\\PythonClass" % serviceName,
-        )
-        try:
-            win32api.RegSetValue(key, None, win32con.REG_SZ, pythonClassString)
-        finally:
-            win32api.RegCloseKey(key)
-
-
-# Utility functions for Services, to allow persistant properties.
-def SetServiceCustomOption(serviceName, option, value):
-    try:
-        serviceName = serviceName._svc_name_
-    except AttributeError:
-        pass
-    key = win32api.RegCreateKey(
-        win32con.HKEY_LOCAL_MACHINE,
-        "System\\CurrentControlSet\\Services\\%s\\Parameters" % serviceName,
-    )
-    try:
-        if type(value) == type(0):
-            win32api.RegSetValueEx(key, option, 0, win32con.REG_DWORD, value)
-        else:
-            win32api.RegSetValueEx(key, option, 0, win32con.REG_SZ, value)
-    finally:
-        win32api.RegCloseKey(key)
-
-
-def GetServiceCustomOption(serviceName, option, defaultValue=None):
-    # First param may also be a service class/instance.
-    # This allows services to pass "self"
-    try:
-        serviceName = serviceName._svc_name_
-    except AttributeError:
-        pass
-    key = win32api.RegCreateKey(
-        win32con.HKEY_LOCAL_MACHINE,
-        "System\\CurrentControlSet\\Services\\%s\\Parameters" % serviceName,
-    )
-    try:
-        try:
-            return win32api.RegQueryValueEx(key, option)[0]
-        except win32api.error:  # No value.
-            return defaultValue
-    finally:
-        win32api.RegCloseKey(key)
-
-
-def RemoveService(serviceName):
-    try:
-        import perfmon
-
-        perfmon.UnloadPerfCounterTextStrings("python.exe " + serviceName)
-    except (ImportError, win32api.error):
-        pass
-
-    hscm = win32service.OpenSCManager(None, None, win32service.SC_MANAGER_ALL_ACCESS)
-    try:
-        hs = SmartOpenService(hscm, serviceName, win32service.SERVICE_ALL_ACCESS)
-        win32service.DeleteService(hs)
-        win32service.CloseServiceHandle(hs)
-    finally:
-        win32service.CloseServiceHandle(hscm)
-
-    import win32evtlogutil
-
-    try:
-        win32evtlogutil.RemoveSourceFromRegistry(serviceName)
-    except win32api.error:
-        pass
-
-
-def ControlService(serviceName, code, machine=None):
-    hscm = win32service.OpenSCManager(machine, None, win32service.SC_MANAGER_ALL_ACCESS)
-    try:
-        hs = SmartOpenService(hscm, serviceName, win32service.SERVICE_ALL_ACCESS)
-        try:
-            status = win32service.ControlService(hs, code)
-        finally:
-            win32service.CloseServiceHandle(hs)
-    finally:
-        win32service.CloseServiceHandle(hscm)
-    return status
-
-
-def __FindSvcDeps(findName):
-    if type(findName) is pywintypes.UnicodeType:
-        findName = str(findName)
-    dict = {}
-    k = win32api.RegOpenKey(
-        win32con.HKEY_LOCAL_MACHINE, "SYSTEM\\CurrentControlSet\\Services"
-    )
-    num = 0
-    while 1:
-        try:
-            svc = win32api.RegEnumKey(k, num)
-        except win32api.error:
-            break
-        num = num + 1
-        sk = win32api.RegOpenKey(k, svc)
-        try:
-            deps, typ = win32api.RegQueryValueEx(sk, "DependOnService")
-        except win32api.error:
-            deps = ()
-        for dep in deps:
-            dep = dep.lower()
-            dep_on = dict.get(dep, [])
-            dep_on.append(svc)
-            dict[dep] = dep_on
-
-    return __ResolveDeps(findName, dict)
-
-
-def __ResolveDeps(findName, dict):
-    items = dict.get(findName.lower(), [])
-    retList = []
-    for svc in items:
-        retList.insert(0, svc)
-        retList = __ResolveDeps(svc, dict) + retList
-    return retList
-
-
-def WaitForServiceStatus(serviceName, status, waitSecs, machine=None):
-    """Waits for the service to return the specified status.  You
-    should have already requested the service to enter that state"""
-    for i in range(waitSecs * 4):
-        now_status = QueryServiceStatus(serviceName, machine)[1]
-        if now_status == status:
-            break
-        win32api.Sleep(250)
-    else:
-        raise pywintypes.error(
-            winerror.ERROR_SERVICE_REQUEST_TIMEOUT,
-            "QueryServiceStatus",
-            win32api.FormatMessage(winerror.ERROR_SERVICE_REQUEST_TIMEOUT)[:-2],
-        )
-
-
-def __StopServiceWithTimeout(hs, waitSecs=30):
-    try:
-        status = win32service.ControlService(hs, win32service.SERVICE_CONTROL_STOP)
-    except pywintypes.error as exc:
-        if exc.winerror != winerror.ERROR_SERVICE_NOT_ACTIVE:
-            raise
-    for i in range(waitSecs):
-        status = win32service.QueryServiceStatus(hs)
-        if status[1] == win32service.SERVICE_STOPPED:
-            break
-        win32api.Sleep(1000)
-    else:
-        raise pywintypes.error(
-            winerror.ERROR_SERVICE_REQUEST_TIMEOUT,
-            "ControlService",
-            win32api.FormatMessage(winerror.ERROR_SERVICE_REQUEST_TIMEOUT)[:-2],
-        )
-
-
-def StopServiceWithDeps(serviceName, machine=None, waitSecs=30):
-    # Stop a service recursively looking for dependant services
-    hscm = win32service.OpenSCManager(machine, None, win32service.SC_MANAGER_ALL_ACCESS)
-    try:
-        deps = __FindSvcDeps(serviceName)
-        for dep in deps:
-            hs = win32service.OpenService(hscm, dep, win32service.SERVICE_ALL_ACCESS)
-            try:
-                __StopServiceWithTimeout(hs, waitSecs)
-            finally:
-                win32service.CloseServiceHandle(hs)
-        # Now my service!
-        hs = win32service.OpenService(
-            hscm, serviceName, win32service.SERVICE_ALL_ACCESS
-        )
-        try:
-            __StopServiceWithTimeout(hs, waitSecs)
-        finally:
-            win32service.CloseServiceHandle(hs)
-
-    finally:
-        win32service.CloseServiceHandle(hscm)
-
-
-def StopService(serviceName, machine=None):
-    return ControlService(serviceName, win32service.SERVICE_CONTROL_STOP, machine)
-
-
-def StartService(serviceName, args=None, machine=None):
-    hscm = win32service.OpenSCManager(machine, None, win32service.SC_MANAGER_ALL_ACCESS)
-    try:
-        hs = SmartOpenService(hscm, serviceName, win32service.SERVICE_ALL_ACCESS)
-        try:
-            win32service.StartService(hs, args)
-        finally:
-            win32service.CloseServiceHandle(hs)
-    finally:
-        win32service.CloseServiceHandle(hscm)
-
-
-def RestartService(serviceName, args=None, waitSeconds=30, machine=None):
-    "Stop the service, and then start it again (with some tolerance for allowing it to stop.)"
-    try:
-        StopService(serviceName, machine)
-    except pywintypes.error as exc:
-        # Allow only "service not running" error
-        if exc.winerror != winerror.ERROR_SERVICE_NOT_ACTIVE:
-            raise
-    # Give it a few goes, as the service may take time to stop
-    for i in range(waitSeconds):
-        try:
-            StartService(serviceName, args, machine)
-            break
-        except pywintypes.error as exc:
-            if exc.winerror != winerror.ERROR_SERVICE_ALREADY_RUNNING:
-                raise
-            win32api.Sleep(1000)
-    else:
-        print("Gave up waiting for the old service to stop!")
-
-
-def _DebugCtrlHandler(evt):
-    if evt in (win32con.CTRL_C_EVENT, win32con.CTRL_BREAK_EVENT):
-        assert g_debugService
-        print("Stopping debug service.")
-        g_debugService.SvcStop()
-        return True
-    return False
-
-
-def DebugService(cls, argv=[]):
-    # Run a service in "debug" mode.  Re-implements what pythonservice.exe
-    # does when it sees a "-debug" param.
-    # Currently only used by "frozen" (ie, py2exe) programs (but later may
-    # end up being used for all services should we ever remove
-    # pythonservice.exe)
-    import servicemanager
-
-    global g_debugService
-
-    print("Debugging service %s - press Ctrl+C to stop." % (cls._svc_name_,))
-    servicemanager.Debugging(True)
-    servicemanager.PrepareToHostSingle(cls)
-    g_debugService = cls(argv)
-    # Setup a ctrl+c handler to simulate a "stop"
-    win32api.SetConsoleCtrlHandler(_DebugCtrlHandler, True)
-    try:
-        g_debugService.SvcRun()
-    finally:
-        win32api.SetConsoleCtrlHandler(_DebugCtrlHandler, False)
-        servicemanager.Debugging(False)
-        g_debugService = None
-
-
-def GetServiceClassString(cls, argv=None):
-    if argv is None:
-        argv = sys.argv
-    import pickle
-
-    modName = pickle.whichmodule(cls, cls.__name__)
-    if modName == "__main__":
-        try:
-            fname = win32api.GetFullPathName(argv[0])
-            path = os.path.split(fname)[0]
-            # Eaaaahhhh - sometimes this will be a short filename, which causes
-            # problems with 1.5.1 and the silly filename case rule.
-            filelist = win32api.FindFiles(fname)
-            # win32api.FindFiles will not detect files in a zip or exe. If list is empty,
-            # skip the test and hope the file really exists.
-            if len(filelist) != 0:
-                # Get the long name
-                fname = os.path.join(path, filelist[0][8])
-        except win32api.error:
-            raise error(
-                "Could not resolve the path name '%s' to a full path" % (argv[0])
-            )
-        modName = os.path.splitext(fname)[0]
-    return modName + "." + cls.__name__
-
-
-def QueryServiceStatus(serviceName, machine=None):
-    hscm = win32service.OpenSCManager(machine, None, win32service.SC_MANAGER_CONNECT)
-    try:
-        hs = SmartOpenService(hscm, serviceName, win32service.SERVICE_QUERY_STATUS)
-        try:
-            status = win32service.QueryServiceStatus(hs)
-        finally:
-            win32service.CloseServiceHandle(hs)
-    finally:
-        win32service.CloseServiceHandle(hscm)
-    return status
-
-
-def usage():
-    try:
-        fname = os.path.split(sys.argv[0])[1]
-    except:
-        fname = sys.argv[0]
-    print(
-        "Usage: '%s [options] install|update|remove|start [...]|stop|restart [...]|debug [...]'"
-        % fname
-    )
-    print("Options for 'install' and 'update' commands only:")
-    print(" --username domain\\username : The Username the service is to run under")
-    print(" --password password : The password for the username")
-    print(
-        " --startup [manual|auto|disabled|delayed] : How the service starts, default = manual"
-    )
-    print(" --interactive : Allow the service to interact with the desktop.")
-    print(
-        " --perfmonini file: .ini file to use for registering performance monitor data"
-    )
-    print(" --perfmondll file: .dll file to use when querying the service for")
-    print("   performance data, default = perfmondata.dll")
-    print("Options for 'start' and 'stop' commands only:")
-    print(" --wait seconds: Wait for the service to actually start or stop.")
-    print("                 If you specify --wait with the 'stop' option, the service")
-    print("                 and all dependent services will be stopped, each waiting")
-    print("                 the specified period.")
-    sys.exit(1)
-
-
-def HandleCommandLine(
-    cls,
-    serviceClassString=None,
-    argv=None,
-    customInstallOptions="",
-    customOptionHandler=None,
-):
-    """Utility function allowing services to process the command line.
-
-    Allows standard commands such as 'start', 'stop', 'debug', 'install' etc.
-
-    Install supports 'standard' command line options prefixed with '--', such as
-    --username, --password, etc.  In addition,
-    the function allows custom command line options to be handled by the calling function.
-    """
-    err = 0
-
-    if argv is None:
-        argv = sys.argv
-
-    if len(argv) <= 1:
-        usage()
-
-    serviceName = cls._svc_name_
-    serviceDisplayName = cls._svc_display_name_
-    if serviceClassString is None:
-        serviceClassString = GetServiceClassString(cls)
-
-    # Pull apart the command line
-    import getopt
-
-    try:
-        opts, args = getopt.getopt(
-            argv[1:],
-            customInstallOptions,
-            [
-                "password=",
-                "username=",
-                "startup=",
-                "perfmonini=",
-                "perfmondll=",
-                "interactive",
-                "wait=",
-            ],
-        )
-    except getopt.error as details:
-        print(details)
-        usage()
-    userName = None
-    password = None
-    perfMonIni = perfMonDll = None
-    startup = None
-    delayedstart = None
-    interactive = None
-    waitSecs = 0
-    for opt, val in opts:
-        if opt == "--username":
-            userName = val
-        elif opt == "--password":
-            password = val
-        elif opt == "--perfmonini":
-            perfMonIni = val
-        elif opt == "--perfmondll":
-            perfMonDll = val
-        elif opt == "--interactive":
-            interactive = 1
-        elif opt == "--startup":
-            map = {
-                "manual": win32service.SERVICE_DEMAND_START,
-                "auto": win32service.SERVICE_AUTO_START,
-                "delayed": win32service.SERVICE_AUTO_START,  ## ChangeServiceConfig2 called later
-                "disabled": win32service.SERVICE_DISABLED,
-            }
-            try:
-                startup = map[val.lower()]
-            except KeyError:
-                print("'%s' is not a valid startup option" % val)
-            if val.lower() == "delayed":
-                delayedstart = True
-            elif val.lower() == "auto":
-                delayedstart = False
-            ## else no change
-        elif opt == "--wait":
-            try:
-                waitSecs = int(val)
-            except ValueError:
-                print("--wait must specify an integer number of seconds.")
-                usage()
-
-    arg = args[0]
-    knownArg = 0
-    # First we process all arguments which pass additional args on
-    if arg == "start":
-        knownArg = 1
-        print("Starting service %s" % (serviceName))
-        try:
-            StartService(serviceName, args[1:])
-            if waitSecs:
-                WaitForServiceStatus(
-                    serviceName, win32service.SERVICE_RUNNING, waitSecs
-                )
-        except win32service.error as exc:
-            print("Error starting service: %s" % exc.strerror)
-            err = exc.winerror
-
-    elif arg == "restart":
-        knownArg = 1
-        print("Restarting service %s" % (serviceName))
-        RestartService(serviceName, args[1:])
-        if waitSecs:
-            WaitForServiceStatus(serviceName, win32service.SERVICE_RUNNING, waitSecs)
-
-    elif arg == "debug":
-        knownArg = 1
-        if not hasattr(sys, "frozen"):
-            # non-frozen services use pythonservice.exe which handles a
-            # -debug option
-            svcArgs = " ".join(args[1:])
-            try:
-                exeName = LocateSpecificServiceExe(serviceName)
-            except win32api.error as exc:
-                if exc.winerror == winerror.ERROR_FILE_NOT_FOUND:
-                    print("The service does not appear to be installed.")
-                    print("Please install the service before debugging it.")
-                    sys.exit(1)
-                raise
-            try:
-                os.system("%s -debug %s %s" % (exeName, serviceName, svcArgs))
-            # ^C is used to kill the debug service.  Sometimes Python also gets
-            # interrupted - ignore it...
-            except KeyboardInterrupt:
-                pass
-        else:
-            # py2exe services don't use pythonservice - so we simulate
-            # debugging here.
-            DebugService(cls, args)
-
-    if not knownArg and len(args) != 1:
-        usage()  # the rest of the cmds don't take addn args
-
-    if arg == "install":
-        knownArg = 1
-        try:
-            serviceDeps = cls._svc_deps_
-        except AttributeError:
-            serviceDeps = None
-        try:
-            exeName = cls._exe_name_
-        except AttributeError:
-            exeName = None  # Default to PythonService.exe
-        try:
-            exeArgs = cls._exe_args_
-        except AttributeError:
-            exeArgs = None
-        try:
-            description = cls._svc_description_
-        except AttributeError:
-            description = None
-        print("Installing service %s" % (serviceName,))
-        # Note that we install the service before calling the custom option
-        # handler, so if the custom handler fails, we have an installed service (from NT's POV)
-        # but is unlikely to work, as the Python code controlling it failed.  Therefore
-        # we remove the service if the first bit works, but the second doesnt!
-        try:
-            InstallService(
-                serviceClassString,
-                serviceName,
-                serviceDisplayName,
-                serviceDeps=serviceDeps,
-                startType=startup,
-                bRunInteractive=interactive,
-                userName=userName,
-                password=password,
-                exeName=exeName,
-                perfMonIni=perfMonIni,
-                perfMonDll=perfMonDll,
-                exeArgs=exeArgs,
-                description=description,
-                delayedstart=delayedstart,
-            )
-            if customOptionHandler:
-                customOptionHandler(*(opts,))
-            print("Service installed")
-        except win32service.error as exc:
-            if exc.winerror == winerror.ERROR_SERVICE_EXISTS:
-                arg = "update"  # Fall through to the "update" param!
-            else:
-                print(
-                    "Error installing service: %s (%d)" % (exc.strerror, exc.winerror)
-                )
-                err = exc.winerror
-        except ValueError as msg:  # Can be raised by custom option handler.
-            print("Error installing service: %s" % str(msg))
-            err = -1
-            # xxx - maybe I should remove after _any_ failed install - however,
-            # xxx - it may be useful to help debug to leave the service as it failed.
-            # xxx - We really _must_ remove as per the comments above...
-            # As we failed here, remove the service, so the next installation
-            # attempt works.
-            try:
-                RemoveService(serviceName)
-            except win32api.error:
-                print("Warning - could not remove the partially installed service.")
-
-    if arg == "update":
-        knownArg = 1
-        try:
-            serviceDeps = cls._svc_deps_
-        except AttributeError:
-            serviceDeps = None
-        try:
-            exeName = cls._exe_name_
-        except AttributeError:
-            exeName = None  # Default to PythonService.exe
-        try:
-            exeArgs = cls._exe_args_
-        except AttributeError:
-            exeArgs = None
-        try:
-            description = cls._svc_description_
-        except AttributeError:
-            description = None
-        print("Changing service configuration")
-        try:
-            ChangeServiceConfig(
-                serviceClassString,
-                serviceName,
-                serviceDeps=serviceDeps,
-                startType=startup,
-                bRunInteractive=interactive,
-                userName=userName,
-                password=password,
-                exeName=exeName,
-                displayName=serviceDisplayName,
-                perfMonIni=perfMonIni,
-                perfMonDll=perfMonDll,
-                exeArgs=exeArgs,
-                description=description,
-                delayedstart=delayedstart,
-            )
-            if customOptionHandler:
-                customOptionHandler(*(opts,))
-            print("Service updated")
-        except win32service.error as exc:
-            print(
-                "Error changing service configuration: %s (%d)"
-                % (exc.strerror, exc.winerror)
-            )
-            err = exc.winerror
-
-    elif arg == "remove":
-        knownArg = 1
-        print("Removing service %s" % (serviceName))
-        try:
-            RemoveService(serviceName)
-            print("Service removed")
-        except win32service.error as exc:
-            print("Error removing service: %s (%d)" % (exc.strerror, exc.winerror))
-            err = exc.winerror
-    elif arg == "stop":
-        knownArg = 1
-        print("Stopping service %s" % (serviceName))
-        try:
-            if waitSecs:
-                StopServiceWithDeps(serviceName, waitSecs=waitSecs)
-            else:
-                StopService(serviceName)
-        except win32service.error as exc:
-            print("Error stopping service: %s (%d)" % (exc.strerror, exc.winerror))
-            err = exc.winerror
-    if not knownArg:
-        err = -1
-        print("Unknown command - '%s'" % arg)
-        usage()
-    return err
-
-
-#
-# Useful base class to build services from.
-#
-class ServiceFramework:
-    # Required Attributes:
-    # _svc_name_ = The service name
-    # _svc_display_name_ = The service display name
-
-    # Optional Attributes:
-    _svc_deps_ = None  # sequence of service names on which this depends
-    _exe_name_ = None  # Default to PythonService.exe
-    _exe_args_ = None  # Default to no arguments
-    _svc_description_ = (
-        None  # Only exists on Windows 2000 or later, ignored on windows NT
-    )
-
-    def __init__(self, args):
-        import servicemanager
-
-        self.ssh = servicemanager.RegisterServiceCtrlHandler(
-            args[0], self.ServiceCtrlHandlerEx, True
-        )
-        servicemanager.SetEventSourceName(self._svc_name_)
-        self.checkPoint = 0
-
-    def GetAcceptedControls(self):
-        # Setup the service controls we accept based on our attributes. Note
-        # that if you need to handle controls via SvcOther[Ex](), you must
-        # override this.
-        accepted = 0
-        if hasattr(self, "SvcStop"):
-            accepted = accepted | win32service.SERVICE_ACCEPT_STOP
-        if hasattr(self, "SvcPause") and hasattr(self, "SvcContinue"):
-            accepted = accepted | win32service.SERVICE_ACCEPT_PAUSE_CONTINUE
-        if hasattr(self, "SvcShutdown"):
-            accepted = accepted | win32service.SERVICE_ACCEPT_SHUTDOWN
-        return accepted
-
-    def ReportServiceStatus(
-        self, serviceStatus, waitHint=5000, win32ExitCode=0, svcExitCode=0
-    ):
-        if self.ssh is None:  # Debugging!
-            return
-        if serviceStatus == win32service.SERVICE_START_PENDING:
-            accepted = 0
-        else:
-            accepted = self.GetAcceptedControls()
-
-        if serviceStatus in [
-            win32service.SERVICE_RUNNING,
-            win32service.SERVICE_STOPPED,
-        ]:
-            checkPoint = 0
-        else:
-            self.checkPoint = self.checkPoint + 1
-            checkPoint = self.checkPoint
-
-        # Now report the status to the control manager
-        status = (
-            win32service.SERVICE_WIN32_OWN_PROCESS,
-            serviceStatus,
-            accepted,  # dwControlsAccepted,
-            win32ExitCode,  # dwWin32ExitCode;
-            svcExitCode,  # dwServiceSpecificExitCode;
-            checkPoint,  # dwCheckPoint;
-            waitHint,
-        )
-        win32service.SetServiceStatus(self.ssh, status)
-
-    def SvcInterrogate(self):
-        # Assume we are running, and everyone is happy.
-        self.ReportServiceStatus(win32service.SERVICE_RUNNING)
-
-    def SvcOther(self, control):
-        try:
-            print("Unknown control status - %d" % control)
-        except IOError:
-            # services may not have a valid stdout!
-            pass
-
-    def ServiceCtrlHandler(self, control):
-        return self.ServiceCtrlHandlerEx(control, 0, None)
-
-    # The 'Ex' functions, which take additional params
-    def SvcOtherEx(self, control, event_type, data):
-        # The default here is to call self.SvcOther as that is the old behaviour.
-        # If you want to take advantage of the extra data, override this method
-        return self.SvcOther(control)
-
-    def ServiceCtrlHandlerEx(self, control, event_type, data):
-        if control == win32service.SERVICE_CONTROL_STOP:
-            return self.SvcStop()
-        elif control == win32service.SERVICE_CONTROL_PAUSE:
-            return self.SvcPause()
-        elif control == win32service.SERVICE_CONTROL_CONTINUE:
-            return self.SvcContinue()
-        elif control == win32service.SERVICE_CONTROL_INTERROGATE:
-            return self.SvcInterrogate()
-        elif control == win32service.SERVICE_CONTROL_SHUTDOWN:
-            return self.SvcShutdown()
-        else:
-            return self.SvcOtherEx(control, event_type, data)
-
-    def SvcRun(self):
-        # This is the entry point the C framework calls when the Service is
-        # started. Your Service class should implement SvcDoRun().
-        # Or you can override this method for more control over the Service
-        # statuses reported to the SCM.
-
-        # If this method raises an exception, the C framework will detect this
-        # and report a SERVICE_STOPPED status with a non-zero error code.
-
-        self.ReportServiceStatus(win32service.SERVICE_RUNNING)
-        self.SvcDoRun()
-        # Once SvcDoRun terminates, the service has stopped.
-        # We tell the SCM the service is still stopping - the C framework
-        # will automatically tell the SCM it has stopped when this returns.
-        self.ReportServiceStatus(win32service.SERVICE_STOP_PENDING)
diff --git a/lib/win32/lib/win32timezone.py b/lib/win32/lib/win32timezone.py
deleted file mode 100644
index 569ea9b9..00000000
--- a/lib/win32/lib/win32timezone.py
+++ /dev/null
@@ -1,1023 +0,0 @@
-# -*- coding: UTF-8 -*-
-
-"""
-win32timezone:
-    Module for handling datetime.tzinfo time zones using the windows
-registry for time zone information.  The time zone names are dependent
-on the registry entries defined by the operating system.
-
-    This module may be tested using the doctest module.
-
-    Written by Jason R. Coombs (jaraco@jaraco.com).
-    Copyright © 2003-2012.
-    All Rights Reserved.
-
-    This module is licenced for use in Mark Hammond's pywin32
-library under the same terms as the pywin32 library.
-
-    To use this time zone module with the datetime module, simply pass
-the TimeZoneInfo object to the datetime constructor.  For example,
-
->>> import win32timezone, datetime
->>> assert 'Mountain Standard Time' in win32timezone.TimeZoneInfo.get_sorted_time_zone_names()
->>> MST = win32timezone.TimeZoneInfo('Mountain Standard Time')
->>> now = datetime.datetime.now(MST)
-
-    The now object is now a time-zone aware object, and daylight savings-
-aware methods may be called on it.
-
->>> now.utcoffset() in (datetime.timedelta(-1, 61200), datetime.timedelta(-1, 64800))
-True
-
-(note that the result of utcoffset call will be different based on when now was
-generated, unless standard time is always used)
-
->>> now = datetime.datetime.now(TimeZoneInfo('Mountain Standard Time', True))
->>> now.utcoffset()
-datetime.timedelta(days=-1, seconds=61200)
-
->>> aug2 = datetime.datetime(2003, 8, 2, tzinfo = MST)
->>> tuple(aug2.utctimetuple())
-(2003, 8, 2, 6, 0, 0, 5, 214, 0)
->>> nov2 = datetime.datetime(2003, 11, 25, tzinfo = MST)
->>> tuple(nov2.utctimetuple())
-(2003, 11, 25, 7, 0, 0, 1, 329, 0)
-
-To convert from one timezone to another, just use the astimezone method.
-
->>> aug2.isoformat()
-'2003-08-02T00:00:00-06:00'
->>> aug2est = aug2.astimezone(win32timezone.TimeZoneInfo('Eastern Standard Time'))
->>> aug2est.isoformat()
-'2003-08-02T02:00:00-04:00'
-
-calling the displayName member will return the display name as set in the
-registry.
-
->>> est = win32timezone.TimeZoneInfo('Eastern Standard Time')
->>> str(est.displayName)
-'(UTC-05:00) Eastern Time (US & Canada)'
-
->>> gmt = win32timezone.TimeZoneInfo('GMT Standard Time', True)
->>> str(gmt.displayName)
-'(UTC+00:00) Dublin, Edinburgh, Lisbon, London'
-
-To get the complete list of available time zone keys,
->>> zones = win32timezone.TimeZoneInfo.get_all_time_zones()
-
-If you want to get them in an order that's sorted longitudinally
->>> zones = win32timezone.TimeZoneInfo.get_sorted_time_zones()
-
-TimeZoneInfo now supports being pickled and comparison
->>> import pickle
->>> tz = win32timezone.TimeZoneInfo('China Standard Time')
->>> tz == pickle.loads(pickle.dumps(tz))
-True
-
-It's possible to construct a TimeZoneInfo from a TimeZoneDescription
-including the currently-defined zone.
->>> tz = win32timezone.TimeZoneInfo(TimeZoneDefinition.current())
->>> tz == pickle.loads(pickle.dumps(tz))
-True
-
->>> aest = win32timezone.TimeZoneInfo('AUS Eastern Standard Time')
->>> est = win32timezone.TimeZoneInfo('E. Australia Standard Time')
->>> dt = datetime.datetime(2006, 11, 11, 1, 0, 0, tzinfo = aest)
->>> estdt = dt.astimezone(est)
->>> estdt.strftime('%Y-%m-%d %H:%M:%S')
-'2006-11-11 00:00:00'
-
->>> dt = datetime.datetime(2007, 1, 12, 1, 0, 0, tzinfo = aest)
->>> estdt = dt.astimezone(est)
->>> estdt.strftime('%Y-%m-%d %H:%M:%S')
-'2007-01-12 00:00:00'
-
->>> dt = datetime.datetime(2007, 6, 13, 1, 0, 0, tzinfo = aest)
->>> estdt = dt.astimezone(est)
->>> estdt.strftime('%Y-%m-%d %H:%M:%S')
-'2007-06-13 01:00:00'
-
-Microsoft now has a patch for handling time zones in 2007 (see
-http://support.microsoft.com/gp/cp_dst)
-
-As a result, patched systems will give an incorrect result for
-dates prior to the designated year except for Vista and its
-successors, which have dynamic time zone support.
->>> nov2_pre_change = datetime.datetime(2003, 11, 2, tzinfo = MST)
->>> old_response = (2003, 11, 2, 7, 0, 0, 6, 306, 0)
->>> incorrect_patch_response = (2003, 11, 2, 6, 0, 0, 6, 306, 0)
->>> pre_response = nov2_pre_change.utctimetuple()
->>> pre_response in (old_response, incorrect_patch_response)
-True
-
-Furthermore, unpatched systems pre-Vista will give an incorrect
-result for dates after 2007.
->>> nov2_post_change = datetime.datetime(2007, 11, 2, tzinfo = MST)
->>> incorrect_unpatched_response = (2007, 11, 2, 7, 0, 0, 4, 306, 0)
->>> new_response = (2007, 11, 2, 6, 0, 0, 4, 306, 0)
->>> post_response = nov2_post_change.utctimetuple()
->>> post_response in (new_response, incorrect_unpatched_response)
-True
-
-
-There is a function you can call to get some capabilities of the time
-zone data.
->>> caps = GetTZCapabilities()
->>> isinstance(caps, dict)
-True
->>> 'MissingTZPatch' in caps
-True
->>> 'DynamicTZSupport' in caps
-True
-
->>> both_dates_correct = (pre_response == old_response and post_response == new_response)
->>> old_dates_wrong = (pre_response == incorrect_patch_response)
->>> new_dates_wrong = (post_response == incorrect_unpatched_response)
-
->>> caps['DynamicTZSupport'] == both_dates_correct
-True
-
->>> (not caps['DynamicTZSupport'] and caps['MissingTZPatch']) == new_dates_wrong
-True
-
->>> (not caps['DynamicTZSupport'] and not caps['MissingTZPatch']) == old_dates_wrong
-True
-
-This test helps ensure language support for unicode characters
->>> x = TIME_ZONE_INFORMATION(0, u'français')
-
-
-Test conversion from one time zone to another at a DST boundary
-===============================================================
-
->>> tz_hi = TimeZoneInfo('Hawaiian Standard Time')
->>> tz_pac = TimeZoneInfo('Pacific Standard Time')
->>> time_before = datetime.datetime(2011, 11, 5, 15, 59, 59, tzinfo=tz_hi)
->>> tz_hi.utcoffset(time_before)
-datetime.timedelta(days=-1, seconds=50400)
->>> tz_hi.dst(time_before)
-datetime.timedelta(0)
-
-Hawaii doesn't need dynamic TZ info
->>> getattr(tz_hi, 'dynamicInfo', None)
-
-Here's a time that gave some trouble as reported in #3523104
-because one minute later, the equivalent UTC time changes from DST
-in the U.S.
->>> dt_hi = datetime.datetime(2011, 11, 5, 15, 59, 59, 0, tzinfo=tz_hi)
->>> dt_hi.timetuple()
-time.struct_time(tm_year=2011, tm_mon=11, tm_mday=5, tm_hour=15, tm_min=59, tm_sec=59, tm_wday=5, tm_yday=309, tm_isdst=0)
->>> dt_hi.utctimetuple()
-time.struct_time(tm_year=2011, tm_mon=11, tm_mday=6, tm_hour=1, tm_min=59, tm_sec=59, tm_wday=6, tm_yday=310, tm_isdst=0)
-
-Convert the time to pacific time.
->>> dt_pac = dt_hi.astimezone(tz_pac)
->>> dt_pac.timetuple()
-time.struct_time(tm_year=2011, tm_mon=11, tm_mday=5, tm_hour=18, tm_min=59, tm_sec=59, tm_wday=5, tm_yday=309, tm_isdst=1)
-
-Notice that the UTC time is almost 2am.
->>> dt_pac.utctimetuple()
-time.struct_time(tm_year=2011, tm_mon=11, tm_mday=6, tm_hour=1, tm_min=59, tm_sec=59, tm_wday=6, tm_yday=310, tm_isdst=0)
-
-Now do the same tests one minute later in Hawaii.
->>> time_after = datetime.datetime(2011, 11, 5, 16, 0, 0, 0, tzinfo=tz_hi)
->>> tz_hi.utcoffset(time_after)
-datetime.timedelta(days=-1, seconds=50400)
->>> tz_hi.dst(time_before)
-datetime.timedelta(0)
-
->>> dt_hi = datetime.datetime(2011, 11, 5, 16, 0, 0, 0, tzinfo=tz_hi)
->>> print(dt_hi.timetuple())
-time.struct_time(tm_year=2011, tm_mon=11, tm_mday=5, tm_hour=16, tm_min=0, tm_sec=0, tm_wday=5, tm_yday=309, tm_isdst=0)
->>> print(dt_hi.utctimetuple())
-time.struct_time(tm_year=2011, tm_mon=11, tm_mday=6, tm_hour=2, tm_min=0, tm_sec=0, tm_wday=6, tm_yday=310, tm_isdst=0)
-
-According to the docs, this is what astimezone does.
->>> utc = (dt_hi - dt_hi.utcoffset()).replace(tzinfo=tz_pac)
->>> utc
-datetime.datetime(2011, 11, 6, 2, 0, tzinfo=TimeZoneInfo('Pacific Standard Time'))
->>> tz_pac.fromutc(utc) == dt_hi.astimezone(tz_pac)
-True
->>> tz_pac.fromutc(utc)
-datetime.datetime(2011, 11, 5, 19, 0, tzinfo=TimeZoneInfo('Pacific Standard Time'))
-
-Make sure the converted time is correct.
->>> dt_pac = dt_hi.astimezone(tz_pac)
->>> dt_pac.timetuple()
-time.struct_time(tm_year=2011, tm_mon=11, tm_mday=5, tm_hour=19, tm_min=0, tm_sec=0, tm_wday=5, tm_yday=309, tm_isdst=1)
->>> dt_pac.utctimetuple()
-time.struct_time(tm_year=2011, tm_mon=11, tm_mday=6, tm_hour=2, tm_min=0, tm_sec=0, tm_wday=6, tm_yday=310, tm_isdst=0)
-
-Check some internal methods
->>> tz_pac._getStandardBias(datetime.datetime(2011, 1, 1))
-datetime.timedelta(seconds=28800)
->>> tz_pac._getDaylightBias(datetime.datetime(2011, 1, 1))
-datetime.timedelta(seconds=25200)
-
-Test the offsets
->>> offset = tz_pac.utcoffset(datetime.datetime(2011, 11, 6, 2, 0))
->>> offset == datetime.timedelta(hours=-8)
-True
->>> dst_offset = tz_pac.dst(datetime.datetime(2011, 11, 6, 2, 0) + offset)
->>> dst_offset == datetime.timedelta(hours=1)
-True
->>> (offset + dst_offset) == datetime.timedelta(hours=-7)
-True
-
-
-Test offsets that occur right at the DST changeover
->>> datetime.datetime.utcfromtimestamp(1320570000).replace(
-...     tzinfo=TimeZoneInfo.utc()).astimezone(tz_pac)
-datetime.datetime(2011, 11, 6, 1, 0, tzinfo=TimeZoneInfo('Pacific Standard Time'))
-
-"""
-__author__ = "Jason R. Coombs <jaraco@jaraco.com>"
-
-import datetime
-import logging
-import operator
-import re
-import struct
-import winreg
-from itertools import count
-
-import win32api
-
-log = logging.getLogger(__file__)
-
-
-# A couple of objects for working with objects as if they were native C-type
-# structures.
-class _SimpleStruct(object):
-    _fields_ = None  # must be overridden by subclasses
-
-    def __init__(self, *args, **kw):
-        for i, (name, typ) in enumerate(self._fields_):
-            def_arg = None
-            if i < len(args):
-                def_arg = args[i]
-            if name in kw:
-                def_arg = kw[name]
-            if def_arg is not None:
-                if not isinstance(def_arg, tuple):
-                    def_arg = (def_arg,)
-            else:
-                def_arg = ()
-            if len(def_arg) == 1 and isinstance(def_arg[0], typ):
-                # already an object of this type.
-                # XXX - should copy.copy???
-                def_val = def_arg[0]
-            else:
-                def_val = typ(*def_arg)
-            setattr(self, name, def_val)
-
-    def field_names(self):
-        return [f[0] for f in self._fields_]
-
-    def __eq__(self, other):
-        if not hasattr(other, "_fields_"):
-            return False
-        if self._fields_ != other._fields_:
-            return False
-        for name, _ in self._fields_:
-            if getattr(self, name) != getattr(other, name):
-                return False
-        return True
-
-    def __ne__(self, other):
-        return not self.__eq__(other)
-
-
-class SYSTEMTIME(_SimpleStruct):
-    _fields_ = [
-        ("year", int),
-        ("month", int),
-        ("day_of_week", int),
-        ("day", int),
-        ("hour", int),
-        ("minute", int),
-        ("second", int),
-        ("millisecond", int),
-    ]
-
-
-class TIME_ZONE_INFORMATION(_SimpleStruct):
-    _fields_ = [
-        ("bias", int),
-        ("standard_name", str),
-        ("standard_start", SYSTEMTIME),
-        ("standard_bias", int),
-        ("daylight_name", str),
-        ("daylight_start", SYSTEMTIME),
-        ("daylight_bias", int),
-    ]
-
-
-class DYNAMIC_TIME_ZONE_INFORMATION(_SimpleStruct):
-    _fields_ = TIME_ZONE_INFORMATION._fields_ + [
-        ("key_name", str),
-        ("dynamic_daylight_time_disabled", bool),
-    ]
-
-
-class TimeZoneDefinition(DYNAMIC_TIME_ZONE_INFORMATION):
-    """
-    A time zone definition class based on the win32
-    DYNAMIC_TIME_ZONE_INFORMATION structure.
-
-    Describes a bias against UTC (bias), and two dates at which a separate
-    additional bias applies (standard_bias and daylight_bias).
-    """
-
-    def __init__(self, *args, **kwargs):
-        """
-        Try to construct a TimeZoneDefinition from
-        a) [DYNAMIC_]TIME_ZONE_INFORMATION args
-        b) another TimeZoneDefinition
-        c) a byte structure (using _from_bytes)
-        """
-        try:
-            super(TimeZoneDefinition, self).__init__(*args, **kwargs)
-            return
-        except (TypeError, ValueError):
-            pass
-
-        try:
-            self.__init_from_other(*args, **kwargs)
-            return
-        except TypeError:
-            pass
-
-        try:
-            self.__init_from_bytes(*args, **kwargs)
-            return
-        except TypeError:
-            pass
-
-        raise TypeError("Invalid arguments for %s" % self.__class__)
-
-    def __init_from_bytes(
-        self,
-        bytes,
-        standard_name="",
-        daylight_name="",
-        key_name="",
-        daylight_disabled=False,
-    ):
-        format = "3l8h8h"
-        components = struct.unpack(format, bytes)
-        bias, standard_bias, daylight_bias = components[:3]
-        standard_start = SYSTEMTIME(*components[3:11])
-        daylight_start = SYSTEMTIME(*components[11:19])
-        super(TimeZoneDefinition, self).__init__(
-            bias,
-            standard_name,
-            standard_start,
-            standard_bias,
-            daylight_name,
-            daylight_start,
-            daylight_bias,
-            key_name,
-            daylight_disabled,
-        )
-
-    def __init_from_other(self, other):
-        if not isinstance(other, TIME_ZONE_INFORMATION):
-            raise TypeError("Not a TIME_ZONE_INFORMATION")
-        for name in other.field_names():
-            # explicitly get the value from the underlying structure
-            value = super(TimeZoneDefinition, other).__getattribute__(other, name)
-            setattr(self, name, value)
-        # consider instead of the loop above just copying the memory directly
-        # size = max(ctypes.sizeof(DYNAMIC_TIME_ZONE_INFO), ctypes.sizeof(other))
-        # ctypes.memmove(ctypes.addressof(self), other, size)
-
-    def __getattribute__(self, attr):
-        value = super(TimeZoneDefinition, self).__getattribute__(attr)
-        if "bias" in attr:
-            value = datetime.timedelta(minutes=value)
-        return value
-
-    @classmethod
-    def current(class_):
-        "Windows Platform SDK GetTimeZoneInformation"
-        code, tzi = win32api.GetTimeZoneInformation(True)
-        return code, class_(*tzi)
-
-    def set(self):
-        tzi = tuple(getattr(self, n) for n, t in self._fields_)
-        win32api.SetTimeZoneInformation(tzi)
-
-    def copy(self):
-        # XXX - this is no longer a copy!
-        return self.__class__(self)
-
-    def locate_daylight_start(self, year):
-        return self._locate_day(year, self.daylight_start)
-
-    def locate_standard_start(self, year):
-        return self._locate_day(year, self.standard_start)
-
-    @staticmethod
-    def _locate_day(year, cutoff):
-        """
-        Takes a SYSTEMTIME object, such as retrieved from a TIME_ZONE_INFORMATION
-        structure or call to GetTimeZoneInformation and interprets it based on the given
-        year to identify the actual day.
-
-        This method is necessary because the SYSTEMTIME structure refers to a day by its
-        day of the week and week of the month (e.g. 4th saturday in March).
-
-        >>> SATURDAY = 6
-        >>> MARCH = 3
-        >>> st = SYSTEMTIME(2000, MARCH, SATURDAY, 4, 0, 0, 0, 0)
-
-        # according to my calendar, the 4th Saturday in March in 2009 was the 28th
-        >>> expected_date = datetime.datetime(2009, 3, 28)
-        >>> TimeZoneDefinition._locate_day(2009, st) == expected_date
-        True
-        """
-        # MS stores Sunday as 0, Python datetime stores Monday as zero
-        target_weekday = (cutoff.day_of_week + 6) % 7
-        # For SYSTEMTIMEs relating to time zone inforamtion, cutoff.day
-        #  is the week of the month
-        week_of_month = cutoff.day
-        # so the following is the first day of that week
-        day = (week_of_month - 1) * 7 + 1
-        result = datetime.datetime(
-            year,
-            cutoff.month,
-            day,
-            cutoff.hour,
-            cutoff.minute,
-            cutoff.second,
-            cutoff.millisecond,
-        )
-        # now the result is the correct week, but not necessarily the correct day of the week
-        days_to_go = (target_weekday - result.weekday()) % 7
-        result += datetime.timedelta(days_to_go)
-        # if we selected a day in the month following the target month,
-        #  move back a week or two.
-        # This is necessary because Microsoft defines the fifth week in a month
-        #  to be the last week in a month and adding the time delta might have
-        #  pushed the result into the next month.
-        while result.month == cutoff.month + 1:
-            result -= datetime.timedelta(weeks=1)
-        return result
-
-
-class TimeZoneInfo(datetime.tzinfo):
-    """
-    Main class for handling Windows time zones.
-    Usage:
-        TimeZoneInfo(<Time Zone Standard Name>, [<Fix Standard Time>])
-
-    If <Fix Standard Time> evaluates to True, daylight savings time is
-    calculated in the same way as standard time.
-
-    >>> tzi = TimeZoneInfo('Pacific Standard Time')
-    >>> march31 = datetime.datetime(2000,3,31)
-
-    We know that time zone definitions haven't changed from 2007
-    to 2012, so regardless of whether dynamic info is available,
-    there should be consistent results for these years.
-    >>> subsequent_years = [march31.replace(year=year)
-    ...     for year in range(2007, 2013)]
-    >>> offsets = set(tzi.utcoffset(year) for year in subsequent_years)
-    >>> len(offsets)
-    1
-    """
-
-    # this key works for WinNT+, but not for the Win95 line.
-    tzRegKey = r"SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones"
-
-    def __init__(self, param=None, fix_standard_time=False):
-        if isinstance(param, TimeZoneDefinition):
-            self._LoadFromTZI(param)
-        if isinstance(param, str):
-            self.timeZoneName = param
-            self._LoadInfoFromKey()
-        self.fixedStandardTime = fix_standard_time
-
-    def _FindTimeZoneKey(self):
-        """Find the registry key for the time zone name (self.timeZoneName)."""
-        # for multi-language compatability, match the time zone name in the
-        # "Std" key of the time zone key.
-        zoneNames = dict(self._get_indexed_time_zone_keys("Std"))
-        # Also match the time zone key name itself, to be compatible with
-        # English-based hard-coded time zones.
-        timeZoneName = zoneNames.get(self.timeZoneName, self.timeZoneName)
-        key = _RegKeyDict.open(winreg.HKEY_LOCAL_MACHINE, self.tzRegKey)
-        try:
-            result = key.subkey(timeZoneName)
-        except Exception:
-            raise ValueError("Timezone Name %s not found." % timeZoneName)
-        return result
-
-    def _LoadInfoFromKey(self):
-        """Loads the information from an opened time zone registry key
-        into relevant fields of this TZI object"""
-        key = self._FindTimeZoneKey()
-        self.displayName = key["Display"]
-        self.standardName = key["Std"]
-        self.daylightName = key["Dlt"]
-        self.staticInfo = TimeZoneDefinition(key["TZI"])
-        self._LoadDynamicInfoFromKey(key)
-
-    def _LoadFromTZI(self, tzi):
-        self.timeZoneName = tzi.standard_name
-        self.displayName = "Unknown"
-        self.standardName = tzi.standard_name
-        self.daylightName = tzi.daylight_name
-        self.staticInfo = tzi
-
-    def _LoadDynamicInfoFromKey(self, key):
-        """
-        >>> tzi = TimeZoneInfo('Central Standard Time')
-
-        Here's how the RangeMap is supposed to work:
-        >>> m = RangeMap(zip([2006,2007], 'BC'),
-        ...     sort_params = dict(reverse=True),
-        ...     key_match_comparator=operator.ge)
-        >>> m.get(2000, 'A')
-        'A'
-        >>> m[2006]
-        'B'
-        >>> m[2007]
-        'C'
-        >>> m[2008]
-        'C'
-
-        >>> m[RangeMap.last_item]
-        'B'
-
-        >>> m.get(2008, m[RangeMap.last_item])
-        'C'
-
-
-        Now test the dynamic info (but fallback to our simple RangeMap
-        on systems that don't have dynamicInfo).
-
-        >>> dinfo = getattr(tzi, 'dynamicInfo', m)
-        >>> 2007 in dinfo
-        True
-        >>> 2008 in dinfo
-        False
-        >>> dinfo[2007] == dinfo[2008] == dinfo[2012]
-        True
-        """
-        try:
-            info = key.subkey("Dynamic DST")
-        except WindowsError:
-            return
-        del info["FirstEntry"]
-        del info["LastEntry"]
-        years = map(int, list(info.keys()))
-        values = map(TimeZoneDefinition, list(info.values()))
-        # create a range mapping that searches by descending year and matches
-        # if the target year is greater or equal.
-        self.dynamicInfo = RangeMap(
-            zip(years, values),
-            sort_params=dict(reverse=True),
-            key_match_comparator=operator.ge,
-        )
-
-    def __repr__(self):
-        result = "%s(%s" % (self.__class__.__name__, repr(self.timeZoneName))
-        if self.fixedStandardTime:
-            result += ", True"
-        result += ")"
-        return result
-
-    def __str__(self):
-        return self.displayName
-
-    def tzname(self, dt):
-        winInfo = self.getWinInfo(dt)
-        if self.dst(dt) == winInfo.daylight_bias:
-            result = self.daylightName
-        elif self.dst(dt) == winInfo.standard_bias:
-            result = self.standardName
-        return result
-
-    def getWinInfo(self, targetYear):
-        """
-        Return the most relevant "info" for this time zone
-        in the target year.
-        """
-        if not hasattr(self, "dynamicInfo") or not self.dynamicInfo:
-            return self.staticInfo
-        # Find the greatest year entry in self.dynamicInfo which is for
-        #  a year greater than or equal to our targetYear. If not found,
-        #  default to the earliest year.
-        return self.dynamicInfo.get(targetYear, self.dynamicInfo[RangeMap.last_item])
-
-    def _getStandardBias(self, dt):
-        winInfo = self.getWinInfo(dt.year)
-        return winInfo.bias + winInfo.standard_bias
-
-    def _getDaylightBias(self, dt):
-        winInfo = self.getWinInfo(dt.year)
-        return winInfo.bias + winInfo.daylight_bias
-
-    def utcoffset(self, dt):
-        "Calculates the utcoffset according to the datetime.tzinfo spec"
-        if dt is None:
-            return
-        winInfo = self.getWinInfo(dt.year)
-        return -winInfo.bias + self.dst(dt)
-
-    def dst(self, dt):
-        """
-        Calculate the daylight savings offset according to the
-        datetime.tzinfo spec.
-        """
-        if dt is None:
-            return
-        winInfo = self.getWinInfo(dt.year)
-        if not self.fixedStandardTime and self._inDaylightSavings(dt):
-            result = winInfo.daylight_bias
-        else:
-            result = winInfo.standard_bias
-        return -result
-
-    def _inDaylightSavings(self, dt):
-        dt = dt.replace(tzinfo=None)
-        winInfo = self.getWinInfo(dt.year)
-        try:
-            dstStart = self.GetDSTStartTime(dt.year)
-            dstEnd = self.GetDSTEndTime(dt.year)
-
-            # at the end of DST, when clocks are moved back, there's a period
-            #  of daylight_bias where it's ambiguous whether we're in DST or
-            #  not.
-            dstEndAdj = dstEnd + winInfo.daylight_bias
-
-            # the same thing could theoretically happen at the start of DST
-            #  if there's a standard_bias (which I suspect is always 0).
-            dstStartAdj = dstStart + winInfo.standard_bias
-
-            if dstStart < dstEnd:
-                in_dst = dstStartAdj <= dt < dstEndAdj
-            else:
-                # in the southern hemisphere, daylight savings time
-                #  typically ends before it begins in a given year.
-                in_dst = not (dstEndAdj < dt <= dstStartAdj)
-        except ValueError:
-            # there was an error parsing the time zone, which is normal when a
-            #  start and end time are not specified.
-            in_dst = False
-
-        return in_dst
-
-    def GetDSTStartTime(self, year):
-        "Given a year, determines the time when daylight savings time starts"
-        return self.getWinInfo(year).locate_daylight_start(year)
-
-    def GetDSTEndTime(self, year):
-        "Given a year, determines the time when daylight savings ends."
-        return self.getWinInfo(year).locate_standard_start(year)
-
-    def __cmp__(self, other):
-        return cmp(self.__dict__, other.__dict__)
-
-    def __eq__(self, other):
-        return self.__dict__ == other.__dict__
-
-    def __ne__(self, other):
-        return self.__dict__ != other.__dict__
-
-    @classmethod
-    def local(class_):
-        """Returns the local time zone as defined by the operating system in the
-        registry.
-        >>> localTZ = TimeZoneInfo.local()
-        >>> now_local = datetime.datetime.now(localTZ)
-        >>> now_UTC = datetime.datetime.utcnow()
-        >>> (now_UTC - now_local) < datetime.timedelta(seconds = 5)
-        Traceback (most recent call last):
-        ...
-        TypeError: can't subtract offset-naive and offset-aware datetimes
-
-        >>> now_UTC = now_UTC.replace(tzinfo = TimeZoneInfo('GMT Standard Time', True))
-
-        Now one can compare the results of the two offset aware values
-        >>> (now_UTC - now_local) < datetime.timedelta(seconds = 5)
-        True
-        """
-        code, info = TimeZoneDefinition.current()
-        # code is 0 if daylight savings is disabled or not defined
-        #  code is 1 or 2 if daylight savings is enabled, 2 if currently active
-        fix_standard_time = not code
-        # note that although the given information is sufficient
-        # to construct a WinTZI object, it's
-        # not sufficient to represent the time zone in which
-        # the current user is operating due
-        # to dynamic time zones.
-        return class_(info, fix_standard_time)
-
-    @classmethod
-    def utc(class_):
-        """Returns a time-zone representing UTC.
-
-        Same as TimeZoneInfo('GMT Standard Time', True) but caches the result
-        for performance.
-
-        >>> isinstance(TimeZoneInfo.utc(), TimeZoneInfo)
-        True
-        """
-        if "_tzutc" not in class_.__dict__:
-            setattr(class_, "_tzutc", class_("GMT Standard Time", True))
-        return class_._tzutc
-
-    # helper methods for accessing the timezone info from the registry
-    @staticmethod
-    def _get_time_zone_key(subkey=None):
-        "Return the registry key that stores time zone details"
-        key = _RegKeyDict.open(winreg.HKEY_LOCAL_MACHINE, TimeZoneInfo.tzRegKey)
-        if subkey:
-            key = key.subkey(subkey)
-        return key
-
-    @staticmethod
-    def _get_time_zone_key_names():
-        "Returns the names of the (registry keys of the) time zones"
-        return TimeZoneInfo._get_time_zone_key().subkeys()
-
-    @staticmethod
-    def _get_indexed_time_zone_keys(index_key="Index"):
-        """
-        Get the names of the registry keys indexed by a value in that key,
-        ignoring any keys for which that value is empty or missing.
-        """
-        key_names = list(TimeZoneInfo._get_time_zone_key_names())
-
-        def get_index_value(key_name):
-            key = TimeZoneInfo._get_time_zone_key(key_name)
-            return key.get(index_key)
-
-        values = map(get_index_value, key_names)
-
-        return (
-            (value, key_name) for value, key_name in zip(values, key_names) if value
-        )
-
-    @staticmethod
-    def get_sorted_time_zone_names():
-        """
-        Return a list of time zone names that can
-        be used to initialize TimeZoneInfo instances.
-        """
-        tzs = TimeZoneInfo.get_sorted_time_zones()
-        return [tz.standardName for tz in tzs]
-
-    @staticmethod
-    def get_all_time_zones():
-        return [TimeZoneInfo(n) for n in TimeZoneInfo._get_time_zone_key_names()]
-
-    @staticmethod
-    def get_sorted_time_zones(key=None):
-        """
-        Return the time zones sorted by some key.
-        key must be a function that takes a TimeZoneInfo object and returns
-        a value suitable for sorting on.
-        The key defaults to the bias (descending), as is done in Windows
-        (see http://blogs.msdn.com/michkap/archive/2006/12/22/1350684.aspx)
-        """
-        key = key or (lambda tzi: -tzi.staticInfo.bias)
-        zones = TimeZoneInfo.get_all_time_zones()
-        zones.sort(key=key)
-        return zones
-
-
-class _RegKeyDict(dict):
-    def __init__(self, key):
-        dict.__init__(self)
-        self.key = key
-        self.__load_values()
-
-    @classmethod
-    def open(cls, *args, **kargs):
-        return _RegKeyDict(winreg.OpenKeyEx(*args, **kargs))
-
-    def subkey(self, name):
-        return _RegKeyDict(winreg.OpenKeyEx(self.key, name))
-
-    def __load_values(self):
-        pairs = [(n, v) for (n, v, t) in self._enumerate_reg_values(self.key)]
-        self.update(pairs)
-
-    def subkeys(self):
-        return self._enumerate_reg_keys(self.key)
-
-    @staticmethod
-    def _enumerate_reg_values(key):
-        return _RegKeyDict._enumerate_reg(key, winreg.EnumValue)
-
-    @staticmethod
-    def _enumerate_reg_keys(key):
-        return _RegKeyDict._enumerate_reg(key, winreg.EnumKey)
-
-    @staticmethod
-    def _enumerate_reg(key, func):
-        "Enumerates an open registry key as an iterable generator"
-        try:
-            for index in count():
-                yield func(key, index)
-        except WindowsError:
-            pass
-
-
-def utcnow():
-    """
-    Return the UTC time now with timezone awareness as enabled
-    by this module
-    >>> now = utcnow()
-    """
-    now = datetime.datetime.utcnow()
-    now = now.replace(tzinfo=TimeZoneInfo.utc())
-    return now
-
-
-def now():
-    """
-    Return the local time now with timezone awareness as enabled
-    by this module
-    >>> now_local = now()
-    """
-    return datetime.datetime.now(TimeZoneInfo.local())
-
-
-def GetTZCapabilities():
-    """
-    Run a few known tests to determine the capabilities of
-    the time zone database on this machine.
-    Note Dynamic Time Zone support is not available on any
-    platform at this time; this
-    is a limitation of this library, not the platform."""
-    tzi = TimeZoneInfo("Mountain Standard Time")
-    MissingTZPatch = datetime.datetime(2007, 11, 2, tzinfo=tzi).utctimetuple() != (
-        2007,
-        11,
-        2,
-        6,
-        0,
-        0,
-        4,
-        306,
-        0,
-    )
-    DynamicTZSupport = not MissingTZPatch and datetime.datetime(
-        2003, 11, 2, tzinfo=tzi
-    ).utctimetuple() == (2003, 11, 2, 7, 0, 0, 6, 306, 0)
-    del tzi
-    return locals()
-
-
-class DLLHandleCache(object):
-    def __init__(self):
-        self.__cache = {}
-
-    def __getitem__(self, filename):
-        key = filename.lower()
-        return self.__cache.setdefault(key, win32api.LoadLibrary(key))
-
-
-DLLCache = DLLHandleCache()
-
-
-def resolveMUITimeZone(spec):
-    """Resolve a multilingual user interface resource for the time zone name
-    >>> #some pre-amble for the doc-tests to be py2k and py3k aware)
-    >>> try: unicode and None
-    ... except NameError: unicode=str
-    ...
-    >>> import sys
-    >>> result = resolveMUITimeZone('@tzres.dll,-110')
-    >>> expectedResultType = [type(None),unicode][sys.getwindowsversion() >= (6,)]
-    >>> type(result) is expectedResultType
-    True
-
-    spec should be of the format @path,-stringID[;comment]
-    see http://msdn2.microsoft.com/en-us/library/ms725481.aspx for details
-    """
-    pattern = re.compile(r"@(?P<dllname>.*),-(?P<index>\d+)(?:;(?P<comment>.*))?")
-    matcher = pattern.match(spec)
-    assert matcher, "Could not parse MUI spec"
-
-    try:
-        handle = DLLCache[matcher.groupdict()["dllname"]]
-        result = win32api.LoadString(handle, int(matcher.groupdict()["index"]))
-    except win32api.error:
-        result = None
-    return result
-
-
-# from jaraco.util.dictlib 5.3.1
-class RangeMap(dict):
-    """
-    A dictionary-like object that uses the keys as bounds for a range.
-    Inclusion of the value for that range is determined by the
-    key_match_comparator, which defaults to less-than-or-equal.
-    A value is returned for a key if it is the first key that matches in
-    the sorted list of keys.
-
-    One may supply keyword parameters to be passed to the sort function used
-    to sort keys (i.e. cmp [python 2 only], keys, reverse) as sort_params.
-
-    Let's create a map that maps 1-3 -> 'a', 4-6 -> 'b'
-    >>> r = RangeMap({3: 'a', 6: 'b'})  # boy, that was easy
-    >>> r[1], r[2], r[3], r[4], r[5], r[6]
-    ('a', 'a', 'a', 'b', 'b', 'b')
-
-    Even float values should work so long as the comparison operator
-    supports it.
-    >>> r[4.5]
-    'b'
-
-    But you'll notice that the way rangemap is defined, it must be open-ended on one side.
-    >>> r[0]
-    'a'
-    >>> r[-1]
-    'a'
-
-    One can close the open-end of the RangeMap by using undefined_value
-    >>> r = RangeMap({0: RangeMap.undefined_value, 3: 'a', 6: 'b'})
-    >>> r[0]
-    Traceback (most recent call last):
-    ...
-    KeyError: 0
-
-    One can get the first or last elements in the range by using RangeMap.Item
-    >>> last_item = RangeMap.Item(-1)
-    >>> r[last_item]
-    'b'
-
-    .last_item is a shortcut for Item(-1)
-    >>> r[RangeMap.last_item]
-    'b'
-
-    Sometimes it's useful to find the bounds for a RangeMap
-    >>> r.bounds()
-    (0, 6)
-
-    RangeMap supports .get(key, default)
-    >>> r.get(0, 'not found')
-    'not found'
-
-    >>> r.get(7, 'not found')
-    'not found'
-
-    """
-
-    def __init__(self, source, sort_params={}, key_match_comparator=operator.le):
-        dict.__init__(self, source)
-        self.sort_params = sort_params
-        self.match = key_match_comparator
-
-    def __getitem__(self, item):
-        sorted_keys = sorted(list(self.keys()), **self.sort_params)
-        if isinstance(item, RangeMap.Item):
-            result = self.__getitem__(sorted_keys[item])
-        else:
-            key = self._find_first_match_(sorted_keys, item)
-            result = dict.__getitem__(self, key)
-            if result is RangeMap.undefined_value:
-                raise KeyError(key)
-        return result
-
-    def get(self, key, default=None):
-        """
-        Return the value for key if key is in the dictionary, else default.
-        If default is not given, it defaults to None, so that this method
-        never raises a KeyError.
-        """
-        try:
-            return self[key]
-        except KeyError:
-            return default
-
-    def _find_first_match_(self, keys, item):
-        def is_match(k):
-            return self.match(item, k)
-
-        matches = list(filter(is_match, keys))
-        if matches:
-            return matches[0]
-        raise KeyError(item)
-
-    def bounds(self):
-        sorted_keys = sorted(list(self.keys()), **self.sort_params)
-        return (
-            sorted_keys[RangeMap.first_item],
-            sorted_keys[RangeMap.last_item],
-        )
-
-    # some special values for the RangeMap
-    undefined_value = type(str("RangeValueUndefined"), (object,), {})()
-
-    class Item(int):
-        pass
-
-    first_item = Item(0)
-    last_item = Item(-1)
diff --git a/lib/win32/lib/win32traceutil.py b/lib/win32/lib/win32traceutil.py
deleted file mode 100644
index 0eb38423..00000000
--- a/lib/win32/lib/win32traceutil.py
+++ /dev/null
@@ -1,59 +0,0 @@
-# This is a helper for the win32trace module
-
-# If imported from a normal Python program, it sets up sys.stdout and sys.stderr
-# so output goes to the collector.
-
-# If run from the command line, it creates a collector loop.
-
-# Eg:
-# C:>start win32traceutil.py (or python.exe win32traceutil.py)
-# will start a process with a (pretty much) blank screen.
-#
-# then, switch to a DOS prompt, and type:
-# C:>python.exe
-# Python 1.4 etc...
-# >>> import win32traceutil
-# Redirecting output to win32trace remote collector
-# >>> print "Hello"
-# >>>
-# And the output will appear in the first collector process.
-
-# Note - the client or the collector can be started first.
-# There is a 0x20000 byte buffer.  If this gets full, it is reset, and new
-# output appended from the start.
-
-import win32trace
-
-
-def RunAsCollector():
-    import sys
-
-    try:
-        import win32api
-
-        win32api.SetConsoleTitle("Python Trace Collector")
-    except:
-        pass  # Oh well!
-    win32trace.InitRead()
-    print("Collecting Python Trace Output...")
-    try:
-        while 1:
-            # a short timeout means ctrl+c works next time we wake...
-            sys.stdout.write(win32trace.blockingread(500))
-    except KeyboardInterrupt:
-        print("Ctrl+C")
-
-
-def SetupForPrint():
-    win32trace.InitWrite()
-    try:  # Under certain servers, sys.stdout may be invalid.
-        print("Redirecting output to win32trace remote collector")
-    except:
-        pass
-    win32trace.setprint()  # this works in an rexec environment.
-
-
-if __name__ == "__main__":
-    RunAsCollector()
-else:
-    SetupForPrint()
diff --git a/lib/win32/lib/win32verstamp.py b/lib/win32/lib/win32verstamp.py
deleted file mode 100644
index dea032b0..00000000
--- a/lib/win32/lib/win32verstamp.py
+++ /dev/null
@@ -1,236 +0,0 @@
-""" Stamp a Win32 binary with version information.
-"""
-
-import glob
-import optparse
-import os
-import struct
-import sys
-
-from win32api import BeginUpdateResource, EndUpdateResource, UpdateResource
-
-VS_FFI_SIGNATURE = -17890115  # 0xFEEF04BD
-VS_FFI_STRUCVERSION = 0x00010000
-VS_FFI_FILEFLAGSMASK = 0x0000003F
-VOS_NT_WINDOWS32 = 0x00040004
-
-null_byte = "\0".encode("ascii")  # str in py2k, bytes in py3k
-
-
-#
-# Set VS_FF_PRERELEASE and DEBUG if Debug
-#
-def file_flags(debug):
-    if debug:
-        return 3  # VS_FF_DEBUG | VS_FF_PRERELEASE
-    return 0
-
-
-def file_type(is_dll):
-    if is_dll:
-        return 2  # VFT_DLL
-    return 1  # VFT_APP
-
-
-def VS_FIXEDFILEINFO(maj, min, sub, build, debug=0, is_dll=1):
-    return struct.pack(
-        "lllllllllllll",
-        VS_FFI_SIGNATURE,  # dwSignature
-        VS_FFI_STRUCVERSION,  # dwStrucVersion
-        (maj << 16) | min,  # dwFileVersionMS
-        (sub << 16) | build,  # dwFileVersionLS
-        (maj << 16) | min,  # dwProductVersionMS
-        (sub << 16) | build,  # dwProductVersionLS
-        VS_FFI_FILEFLAGSMASK,  # dwFileFlagsMask
-        file_flags(debug),  # dwFileFlags
-        VOS_NT_WINDOWS32,  # dwFileOS
-        file_type(is_dll),  # dwFileType
-        0x00000000,  # dwFileSubtype
-        0x00000000,  # dwFileDateMS
-        0x00000000,  # dwFileDateLS
-    )
-
-
-def nullterm(s):
-    # get raw bytes for a NULL terminated unicode string.
-    if sys.version_info[:2] < (3, 7):
-        return (str(s) + "\0").encode("unicode-internal")
-    else:
-        return (str(s) + "\0").encode("utf-16le")
-
-
-def pad32(s, extra=2):
-    # extra is normally 2 to deal with wLength
-    l = 4 - ((len(s) + extra) & 3)
-    if l < 4:
-        return s + (null_byte * l)
-    return s
-
-
-def addlen(s):
-    return struct.pack("h", len(s) + 2) + s
-
-
-def String(key, value):
-    key = nullterm(key)
-    value = nullterm(value)
-    result = struct.pack("hh", len(value) // 2, 1)  # wValueLength, wType
-    result = result + key
-    result = pad32(result) + value
-    return addlen(result)
-
-
-def StringTable(key, data):
-    key = nullterm(key)
-    result = struct.pack("hh", 0, 1)  # wValueLength, wType
-    result = result + key
-    for k, v in data.items():
-        result = result + String(k, v)
-        result = pad32(result)
-    return addlen(result)
-
-
-def StringFileInfo(data):
-    result = struct.pack("hh", 0, 1)  # wValueLength, wType
-    result = result + nullterm("StringFileInfo")
-    #  result = pad32(result) + StringTable('040904b0', data)
-    result = pad32(result) + StringTable("040904E4", data)
-    return addlen(result)
-
-
-def Var(key, value):
-    result = struct.pack("hh", len(value), 0)  # wValueLength, wType
-    result = result + nullterm(key)
-    result = pad32(result) + value
-    return addlen(result)
-
-
-def VarFileInfo(data):
-    result = struct.pack("hh", 0, 1)  # wValueLength, wType
-    result = result + nullterm("VarFileInfo")
-    result = pad32(result)
-    for k, v in data.items():
-        result = result + Var(k, v)
-    return addlen(result)
-
-
-def VS_VERSION_INFO(maj, min, sub, build, sdata, vdata, debug=0, is_dll=1):
-    ffi = VS_FIXEDFILEINFO(maj, min, sub, build, debug, is_dll)
-    result = struct.pack("hh", len(ffi), 0)  # wValueLength, wType
-    result = result + nullterm("VS_VERSION_INFO")
-    result = pad32(result) + ffi
-    result = pad32(result) + StringFileInfo(sdata) + VarFileInfo(vdata)
-    return addlen(result)
-
-
-def stamp(pathname, options):
-    # For some reason, the API functions report success if the file is open
-    # but doesnt work!  Try and open the file for writing, just to see if it is
-    # likely the stamp will work!
-    try:
-        f = open(pathname, "a+b")
-        f.close()
-    except IOError as why:
-        print("WARNING: File %s could not be opened - %s" % (pathname, why))
-
-    ver = options.version
-    try:
-        bits = [int(i) for i in ver.split(".")]
-        vmaj, vmin, vsub, vbuild = bits
-    except (IndexError, TypeError, ValueError):
-        raise ValueError("--version must be a.b.c.d (all integers) - got %r" % ver)
-
-    ifn = options.internal_name
-    if not ifn:
-        ifn = os.path.basename(pathname)
-    ofn = options.original_filename
-    if ofn is None:
-        ofn = os.path.basename(pathname)
-
-    sdata = {
-        "Comments": options.comments,
-        "CompanyName": options.company,
-        "FileDescription": options.description,
-        "FileVersion": ver,
-        "InternalName": ifn,
-        "LegalCopyright": options.copyright,
-        "LegalTrademarks": options.trademarks,
-        "OriginalFilename": ofn,
-        "ProductName": options.product,
-        "ProductVersion": ver,
-    }
-    vdata = {
-        "Translation": struct.pack("hh", 0x409, 1252),
-    }
-    is_dll = options.dll
-    if is_dll is None:
-        is_dll = os.path.splitext(pathname)[1].lower() in ".dll .pyd".split()
-    is_debug = options.debug
-    if is_debug is None:
-        is_debug = os.path.splitext(pathname)[0].lower().endswith("_d")
-    # convert None to blank strings
-    for k, v in list(sdata.items()):
-        if v is None:
-            sdata[k] = ""
-    vs = VS_VERSION_INFO(vmaj, vmin, vsub, vbuild, sdata, vdata, is_debug, is_dll)
-
-    h = BeginUpdateResource(pathname, 0)
-    UpdateResource(h, 16, 1, vs)
-    EndUpdateResource(h, 0)
-
-    if options.verbose:
-        print("Stamped:", pathname)
-
-
-if __name__ == "__main__":
-    parser = optparse.OptionParser("%prog [options] filespec ...", description=__doc__)
-
-    parser.add_option(
-        "-q",
-        "--quiet",
-        action="store_false",
-        dest="verbose",
-        default=True,
-        help="don't print status messages to stdout",
-    )
-    parser.add_option(
-        "", "--version", default="0.0.0.0", help="The version number as m.n.s.b"
-    )
-    parser.add_option(
-        "",
-        "--dll",
-        help="""Stamp the file as a DLL.  Default is to look at the
-                            file extension for .dll or .pyd.""",
-    )
-    parser.add_option("", "--debug", help="""Stamp the file as a debug binary.""")
-    parser.add_option("", "--product", help="""The product name to embed.""")
-    parser.add_option("", "--company", help="""The company name to embed.""")
-    parser.add_option("", "--trademarks", help="The trademark string to embed.")
-    parser.add_option("", "--comments", help="The comments string to embed.")
-    parser.add_option(
-        "", "--copyright", help="""The copyright message string to embed."""
-    )
-    parser.add_option(
-        "", "--description", metavar="DESC", help="The description to embed."
-    )
-    parser.add_option(
-        "",
-        "--internal-name",
-        metavar="NAME",
-        help="""The internal filename to embed. If not specified
-                         the base filename is used.""",
-    )
-    parser.add_option(
-        "",
-        "--original-filename",
-        help="""The original filename to embed. If not specified
-                            the base filename is used.""",
-    )
-
-    options, args = parser.parse_args()
-    if not args:
-        parser.error("You must supply a file to stamp.  Use --help for details.")
-
-    for g in args:
-        for f in glob.glob(g):
-            stamp(f, options)
diff --git a/lib/win32/lib/winerror.py b/lib/win32/lib/winerror.py
deleted file mode 100644
index d7697dbd..00000000
--- a/lib/win32/lib/winerror.py
+++ /dev/null
@@ -1,3039 +0,0 @@
-"""Error related constants for win32
-
-Generated by h2py from winerror.h
-"""
-# Few extras added manually...
-TRUST_E_PROVIDER_UNKNOWN = -2146762751
-TRUST_E_ACTION_UNKNOWN = -2146762750
-TRUST_E_SUBJECT_FORM_UNKNOWN = -2146762749
-TRUST_E_SUBJECT_NOT_TRUSTED = -2146762748
-# up to here...
-
-FACILITY_WINRM = 51
-FACILITY_WINDOWSUPDATE = 36
-FACILITY_WINDOWS_DEFENDER = 80
-FACILITY_WINDOWS_CE = 24
-FACILITY_WINDOWS = 8
-FACILITY_URT = 19
-FACILITY_UMI = 22
-FACILITY_TPM_SOFTWARE = 41
-FACILITY_TPM_SERVICES = 40
-FACILITY_SXS = 23
-FACILITY_STORAGE = 3
-FACILITY_STATE_MANAGEMENT = 34
-FACILITY_SSPI = 9
-FACILITY_SCARD = 16
-FACILITY_SHELL = 39
-FACILITY_SETUPAPI = 15
-FACILITY_SECURITY = 9
-FACILITY_RPC = 1
-FACILITY_PLA = 48
-FACILITY_WIN32 = 7
-FACILITY_CONTROL = 10
-FACILITY_NULL = 0
-FACILITY_NDIS = 52
-FACILITY_METADIRECTORY = 35
-FACILITY_MSMQ = 14
-FACILITY_MEDIASERVER = 13
-FACILITY_INTERNET = 12
-FACILITY_ITF = 4
-FACILITY_USERMODE_HYPERVISOR = 53
-FACILITY_HTTP = 25
-FACILITY_GRAPHICS = 38
-FACILITY_FWP = 50
-FACILITY_FVE = 49
-FACILITY_USERMODE_FILTER_MANAGER = 31
-FACILITY_DPLAY = 21
-FACILITY_DISPATCH = 2
-FACILITY_DIRECTORYSERVICE = 37
-FACILITY_CONFIGURATION = 33
-FACILITY_COMPLUS = 17
-FACILITY_USERMODE_COMMONLOG = 26
-FACILITY_CMI = 54
-FACILITY_CERT = 11
-FACILITY_BACKGROUNDCOPY = 32
-FACILITY_ACS = 20
-FACILITY_AAF = 18
-ERROR_SUCCESS = 0
-NO_ERROR = 0
-S_OK = 0
-S_FALSE = 1
-ERROR_INVALID_FUNCTION = 1
-ERROR_FILE_NOT_FOUND = 2
-ERROR_PATH_NOT_FOUND = 3
-ERROR_TOO_MANY_OPEN_FILES = 4
-ERROR_ACCESS_DENIED = 5
-ERROR_INVALID_HANDLE = 6
-ERROR_ARENA_TRASHED = 7
-ERROR_NOT_ENOUGH_MEMORY = 8
-ERROR_INVALID_BLOCK = 9
-ERROR_BAD_ENVIRONMENT = 10
-ERROR_BAD_FORMAT = 11
-ERROR_INVALID_ACCESS = 12
-ERROR_INVALID_DATA = 13
-ERROR_OUTOFMEMORY = 14
-ERROR_INVALID_DRIVE = 15
-ERROR_CURRENT_DIRECTORY = 16
-ERROR_NOT_SAME_DEVICE = 17
-ERROR_NO_MORE_FILES = 18
-ERROR_WRITE_PROTECT = 19
-ERROR_BAD_UNIT = 20
-ERROR_NOT_READY = 21
-ERROR_BAD_COMMAND = 22
-ERROR_CRC = 23
-ERROR_BAD_LENGTH = 24
-ERROR_SEEK = 25
-ERROR_NOT_DOS_DISK = 26
-ERROR_SECTOR_NOT_FOUND = 27
-ERROR_OUT_OF_PAPER = 28
-ERROR_WRITE_FAULT = 29
-ERROR_READ_FAULT = 30
-ERROR_GEN_FAILURE = 31
-ERROR_SHARING_VIOLATION = 32
-ERROR_LOCK_VIOLATION = 33
-ERROR_WRONG_DISK = 34
-ERROR_SHARING_BUFFER_EXCEEDED = 36
-ERROR_HANDLE_EOF = 38
-ERROR_HANDLE_DISK_FULL = 39
-ERROR_NOT_SUPPORTED = 50
-ERROR_REM_NOT_LIST = 51
-ERROR_DUP_NAME = 52
-ERROR_BAD_NETPATH = 53
-ERROR_NETWORK_BUSY = 54
-ERROR_DEV_NOT_EXIST = 55
-ERROR_TOO_MANY_CMDS = 56
-ERROR_ADAP_HDW_ERR = 57
-ERROR_BAD_NET_RESP = 58
-ERROR_UNEXP_NET_ERR = 59
-ERROR_BAD_REM_ADAP = 60
-ERROR_PRINTQ_FULL = 61
-ERROR_NO_SPOOL_SPACE = 62
-ERROR_PRINT_CANCELLED = 63
-ERROR_NETNAME_DELETED = 64
-ERROR_NETWORK_ACCESS_DENIED = 65
-ERROR_BAD_DEV_TYPE = 66
-ERROR_BAD_NET_NAME = 67
-ERROR_TOO_MANY_NAMES = 68
-ERROR_TOO_MANY_SESS = 69
-ERROR_SHARING_PAUSED = 70
-ERROR_REQ_NOT_ACCEP = 71
-ERROR_REDIR_PAUSED = 72
-ERROR_FILE_EXISTS = 80
-ERROR_CANNOT_MAKE = 82
-ERROR_FAIL_I24 = 83
-ERROR_OUT_OF_STRUCTURES = 84
-ERROR_ALREADY_ASSIGNED = 85
-ERROR_INVALID_PASSWORD = 86
-ERROR_INVALID_PARAMETER = 87
-ERROR_NET_WRITE_FAULT = 88
-ERROR_NO_PROC_SLOTS = 89
-ERROR_TOO_MANY_SEMAPHORES = 100
-ERROR_EXCL_SEM_ALREADY_OWNED = 101
-ERROR_SEM_IS_SET = 102
-ERROR_TOO_MANY_SEM_REQUESTS = 103
-ERROR_INVALID_AT_INTERRUPT_TIME = 104
-ERROR_SEM_OWNER_DIED = 105
-ERROR_SEM_USER_LIMIT = 106
-ERROR_DISK_CHANGE = 107
-ERROR_DRIVE_LOCKED = 108
-ERROR_BROKEN_PIPE = 109
-ERROR_OPEN_FAILED = 110
-ERROR_BUFFER_OVERFLOW = 111
-ERROR_DISK_FULL = 112
-ERROR_NO_MORE_SEARCH_HANDLES = 113
-ERROR_INVALID_TARGET_HANDLE = 114
-ERROR_INVALID_CATEGORY = 117
-ERROR_INVALID_VERIFY_SWITCH = 118
-ERROR_BAD_DRIVER_LEVEL = 119
-ERROR_CALL_NOT_IMPLEMENTED = 120
-ERROR_SEM_TIMEOUT = 121
-ERROR_INSUFFICIENT_BUFFER = 122
-ERROR_INVALID_NAME = 123
-ERROR_INVALID_LEVEL = 124
-ERROR_NO_VOLUME_LABEL = 125
-ERROR_MOD_NOT_FOUND = 126
-ERROR_PROC_NOT_FOUND = 127
-ERROR_WAIT_NO_CHILDREN = 128
-ERROR_CHILD_NOT_COMPLETE = 129
-ERROR_DIRECT_ACCESS_HANDLE = 130
-ERROR_NEGATIVE_SEEK = 131
-ERROR_SEEK_ON_DEVICE = 132
-ERROR_IS_JOIN_TARGET = 133
-ERROR_IS_JOINED = 134
-ERROR_IS_SUBSTED = 135
-ERROR_NOT_JOINED = 136
-ERROR_NOT_SUBSTED = 137
-ERROR_JOIN_TO_JOIN = 138
-ERROR_SUBST_TO_SUBST = 139
-ERROR_JOIN_TO_SUBST = 140
-ERROR_SUBST_TO_JOIN = 141
-ERROR_BUSY_DRIVE = 142
-ERROR_SAME_DRIVE = 143
-ERROR_DIR_NOT_ROOT = 144
-ERROR_DIR_NOT_EMPTY = 145
-ERROR_IS_SUBST_PATH = 146
-ERROR_IS_JOIN_PATH = 147
-ERROR_PATH_BUSY = 148
-ERROR_IS_SUBST_TARGET = 149
-ERROR_SYSTEM_TRACE = 150
-ERROR_INVALID_EVENT_COUNT = 151
-ERROR_TOO_MANY_MUXWAITERS = 152
-ERROR_INVALID_LIST_FORMAT = 153
-ERROR_LABEL_TOO_LONG = 154
-ERROR_TOO_MANY_TCBS = 155
-ERROR_SIGNAL_REFUSED = 156
-ERROR_DISCARDED = 157
-ERROR_NOT_LOCKED = 158
-ERROR_BAD_THREADID_ADDR = 159
-ERROR_BAD_ARGUMENTS = 160
-ERROR_BAD_PATHNAME = 161
-ERROR_SIGNAL_PENDING = 162
-ERROR_MAX_THRDS_REACHED = 164
-ERROR_LOCK_FAILED = 167
-ERROR_BUSY = 170
-ERROR_CANCEL_VIOLATION = 173
-ERROR_ATOMIC_LOCKS_NOT_SUPPORTED = 174
-ERROR_INVALID_SEGMENT_NUMBER = 180
-ERROR_INVALID_ORDINAL = 182
-ERROR_ALREADY_EXISTS = 183
-ERROR_INVALID_FLAG_NUMBER = 186
-ERROR_SEM_NOT_FOUND = 187
-ERROR_INVALID_STARTING_CODESEG = 188
-ERROR_INVALID_STACKSEG = 189
-ERROR_INVALID_MODULETYPE = 190
-ERROR_INVALID_EXE_SIGNATURE = 191
-ERROR_EXE_MARKED_INVALID = 192
-ERROR_BAD_EXE_FORMAT = 193
-ERROR_ITERATED_DATA_EXCEEDS_64k = 194
-ERROR_INVALID_MINALLOCSIZE = 195
-ERROR_DYNLINK_FROM_INVALID_RING = 196
-ERROR_IOPL_NOT_ENABLED = 197
-ERROR_INVALID_SEGDPL = 198
-ERROR_AUTODATASEG_EXCEEDS_64k = 199
-ERROR_RING2SEG_MUST_BE_MOVABLE = 200
-ERROR_RELOC_CHAIN_XEEDS_SEGLIM = 201
-ERROR_INFLOOP_IN_RELOC_CHAIN = 202
-ERROR_ENVVAR_NOT_FOUND = 203
-ERROR_NO_SIGNAL_SENT = 205
-ERROR_FILENAME_EXCED_RANGE = 206
-ERROR_RING2_STACK_IN_USE = 207
-ERROR_META_EXPANSION_TOO_LONG = 208
-ERROR_INVALID_SIGNAL_NUMBER = 209
-ERROR_THREAD_1_INACTIVE = 210
-ERROR_LOCKED = 212
-ERROR_TOO_MANY_MODULES = 214
-ERROR_NESTING_NOT_ALLOWED = 215
-ERROR_EXE_MACHINE_TYPE_MISMATCH = 216
-ERROR_EXE_CANNOT_MODIFY_SIGNED_BINARY = 217
-ERROR_EXE_CANNOT_MODIFY_STRONG_SIGNED_BINARY = 218
-ERROR_FILE_CHECKED_OUT = 220
-ERROR_CHECKOUT_REQUIRED = 221
-ERROR_BAD_FILE_TYPE = 222
-ERROR_FILE_TOO_LARGE = 223
-ERROR_FORMS_AUTH_REQUIRED = 224
-ERROR_VIRUS_INFECTED = 225
-ERROR_VIRUS_DELETED = 226
-ERROR_PIPE_LOCAL = 229
-ERROR_BAD_PIPE = 230
-ERROR_PIPE_BUSY = 231
-ERROR_NO_DATA = 232
-ERROR_PIPE_NOT_CONNECTED = 233
-ERROR_MORE_DATA = 234
-ERROR_VC_DISCONNECTED = 240
-ERROR_INVALID_EA_NAME = 254
-ERROR_EA_LIST_INCONSISTENT = 255
-WAIT_TIMEOUT = 258
-ERROR_NO_MORE_ITEMS = 259
-ERROR_CANNOT_COPY = 266
-ERROR_DIRECTORY = 267
-ERROR_EAS_DIDNT_FIT = 275
-ERROR_EA_FILE_CORRUPT = 276
-ERROR_EA_TABLE_FULL = 277
-ERROR_INVALID_EA_HANDLE = 278
-ERROR_EAS_NOT_SUPPORTED = 282
-ERROR_NOT_OWNER = 288
-ERROR_TOO_MANY_POSTS = 298
-ERROR_PARTIAL_COPY = 299
-ERROR_OPLOCK_NOT_GRANTED = 300
-ERROR_INVALID_OPLOCK_PROTOCOL = 301
-ERROR_DISK_TOO_FRAGMENTED = 302
-ERROR_DELETE_PENDING = 303
-ERROR_MR_MID_NOT_FOUND = 317
-ERROR_SCOPE_NOT_FOUND = 318
-ERROR_FAIL_NOACTION_REBOOT = 350
-ERROR_FAIL_SHUTDOWN = 351
-ERROR_FAIL_RESTART = 352
-ERROR_MAX_SESSIONS_REACHED = 353
-ERROR_THREAD_MODE_ALREADY_BACKGROUND = 400
-ERROR_THREAD_MODE_NOT_BACKGROUND = 401
-ERROR_PROCESS_MODE_ALREADY_BACKGROUND = 402
-ERROR_PROCESS_MODE_NOT_BACKGROUND = 403
-ERROR_INVALID_ADDRESS = 487
-ERROR_USER_PROFILE_LOAD = 500
-ERROR_ARITHMETIC_OVERFLOW = 534
-ERROR_PIPE_CONNECTED = 535
-ERROR_PIPE_LISTENING = 536
-ERROR_VERIFIER_STOP = 537
-ERROR_ABIOS_ERROR = 538
-ERROR_WX86_WARNING = 539
-ERROR_WX86_ERROR = 540
-ERROR_TIMER_NOT_CANCELED = 541
-ERROR_UNWIND = 542
-ERROR_BAD_STACK = 543
-ERROR_INVALID_UNWIND_TARGET = 544
-ERROR_INVALID_PORT_ATTRIBUTES = 545
-ERROR_PORT_MESSAGE_TOO_LONG = 546
-ERROR_INVALID_QUOTA_LOWER = 547
-ERROR_DEVICE_ALREADY_ATTACHED = 548
-ERROR_INSTRUCTION_MISALIGNMENT = 549
-ERROR_PROFILING_NOT_STARTED = 550
-ERROR_PROFILING_NOT_STOPPED = 551
-ERROR_COULD_NOT_INTERPRET = 552
-ERROR_PROFILING_AT_LIMIT = 553
-ERROR_CANT_WAIT = 554
-ERROR_CANT_TERMINATE_SELF = 555
-ERROR_UNEXPECTED_MM_CREATE_ERR = 556
-ERROR_UNEXPECTED_MM_MAP_ERROR = 557
-ERROR_UNEXPECTED_MM_EXTEND_ERR = 558
-ERROR_BAD_FUNCTION_TABLE = 559
-ERROR_NO_GUID_TRANSLATION = 560
-ERROR_INVALID_LDT_SIZE = 561
-ERROR_INVALID_LDT_OFFSET = 563
-ERROR_INVALID_LDT_DESCRIPTOR = 564
-ERROR_TOO_MANY_THREADS = 565
-ERROR_THREAD_NOT_IN_PROCESS = 566
-ERROR_PAGEFILE_QUOTA_EXCEEDED = 567
-ERROR_LOGON_SERVER_CONFLICT = 568
-ERROR_SYNCHRONIZATION_REQUIRED = 569
-ERROR_NET_OPEN_FAILED = 570
-ERROR_IO_PRIVILEGE_FAILED = 571
-ERROR_CONTROL_C_EXIT = 572
-ERROR_MISSING_SYSTEMFILE = 573
-ERROR_UNHANDLED_EXCEPTION = 574
-ERROR_APP_INIT_FAILURE = 575
-ERROR_PAGEFILE_CREATE_FAILED = 576
-ERROR_INVALID_IMAGE_HASH = 577
-ERROR_NO_PAGEFILE = 578
-ERROR_ILLEGAL_FLOAT_CONTEXT = 579
-ERROR_NO_EVENT_PAIR = 580
-ERROR_DOMAIN_CTRLR_CONFIG_ERROR = 581
-ERROR_ILLEGAL_CHARACTER = 582
-ERROR_UNDEFINED_CHARACTER = 583
-ERROR_FLOPPY_VOLUME = 584
-ERROR_BIOS_FAILED_TO_CONNECT_INTERRUPT = 585
-ERROR_BACKUP_CONTROLLER = 586
-ERROR_MUTANT_LIMIT_EXCEEDED = 587
-ERROR_FS_DRIVER_REQUIRED = 588
-ERROR_CANNOT_LOAD_REGISTRY_FILE = 589
-ERROR_DEBUG_ATTACH_FAILED = 590
-ERROR_SYSTEM_PROCESS_TERMINATED = 591
-ERROR_DATA_NOT_ACCEPTED = 592
-ERROR_VDM_HARD_ERROR = 593
-ERROR_DRIVER_CANCEL_TIMEOUT = 594
-ERROR_REPLY_MESSAGE_MISMATCH = 595
-ERROR_LOST_WRITEBEHIND_DATA = 596
-ERROR_CLIENT_SERVER_PARAMETERS_INVALID = 597
-ERROR_NOT_TINY_STREAM = 598
-ERROR_STACK_OVERFLOW_READ = 599
-ERROR_CONVERT_TO_LARGE = 600
-ERROR_FOUND_OUT_OF_SCOPE = 601
-ERROR_ALLOCATE_BUCKET = 602
-ERROR_MARSHALL_OVERFLOW = 603
-ERROR_INVALID_VARIANT = 604
-ERROR_BAD_COMPRESSION_BUFFER = 605
-ERROR_AUDIT_FAILED = 606
-ERROR_TIMER_RESOLUTION_NOT_SET = 607
-ERROR_INSUFFICIENT_LOGON_INFO = 608
-ERROR_BAD_DLL_ENTRYPOINT = 609
-ERROR_BAD_SERVICE_ENTRYPOINT = 610
-ERROR_IP_ADDRESS_CONFLICT1 = 611
-ERROR_IP_ADDRESS_CONFLICT2 = 612
-ERROR_REGISTRY_QUOTA_LIMIT = 613
-ERROR_NO_CALLBACK_ACTIVE = 614
-ERROR_PWD_TOO_SHORT = 615
-ERROR_PWD_TOO_RECENT = 616
-ERROR_PWD_HISTORY_CONFLICT = 617
-ERROR_UNSUPPORTED_COMPRESSION = 618
-ERROR_INVALID_HW_PROFILE = 619
-ERROR_INVALID_PLUGPLAY_DEVICE_PATH = 620
-ERROR_QUOTA_LIST_INCONSISTENT = 621
-ERROR_EVALUATION_EXPIRATION = 622
-ERROR_ILLEGAL_DLL_RELOCATION = 623
-ERROR_DLL_INIT_FAILED_LOGOFF = 624
-ERROR_VALIDATE_CONTINUE = 625
-ERROR_NO_MORE_MATCHES = 626
-ERROR_RANGE_LIST_CONFLICT = 627
-ERROR_SERVER_SID_MISMATCH = 628
-ERROR_CANT_ENABLE_DENY_ONLY = 629
-ERROR_FLOAT_MULTIPLE_FAULTS = 630
-ERROR_FLOAT_MULTIPLE_TRAPS = 631
-ERROR_NOINTERFACE = 632
-ERROR_DRIVER_FAILED_SLEEP = 633
-ERROR_CORRUPT_SYSTEM_FILE = 634
-ERROR_COMMITMENT_MINIMUM = 635
-ERROR_PNP_RESTART_ENUMERATION = 636
-ERROR_SYSTEM_IMAGE_BAD_SIGNATURE = 637
-ERROR_PNP_REBOOT_REQUIRED = 638
-ERROR_INSUFFICIENT_POWER = 639
-ERROR_MULTIPLE_FAULT_VIOLATION = 640
-ERROR_SYSTEM_SHUTDOWN = 641
-ERROR_PORT_NOT_SET = 642
-ERROR_DS_VERSION_CHECK_FAILURE = 643
-ERROR_RANGE_NOT_FOUND = 644
-ERROR_NOT_SAFE_MODE_DRIVER = 646
-ERROR_FAILED_DRIVER_ENTRY = 647
-ERROR_DEVICE_ENUMERATION_ERROR = 648
-ERROR_MOUNT_POINT_NOT_RESOLVED = 649
-ERROR_INVALID_DEVICE_OBJECT_PARAMETER = 650
-ERROR_MCA_OCCURED = 651
-ERROR_DRIVER_DATABASE_ERROR = 652
-ERROR_SYSTEM_HIVE_TOO_LARGE = 653
-ERROR_DRIVER_FAILED_PRIOR_UNLOAD = 654
-ERROR_VOLSNAP_PREPARE_HIBERNATE = 655
-ERROR_HIBERNATION_FAILURE = 656
-ERROR_FILE_SYSTEM_LIMITATION = 665
-ERROR_ASSERTION_FAILURE = 668
-ERROR_ACPI_ERROR = 669
-ERROR_WOW_ASSERTION = 670
-ERROR_PNP_BAD_MPS_TABLE = 671
-ERROR_PNP_TRANSLATION_FAILED = 672
-ERROR_PNP_IRQ_TRANSLATION_FAILED = 673
-ERROR_PNP_INVALID_ID = 674
-ERROR_WAKE_SYSTEM_DEBUGGER = 675
-ERROR_HANDLES_CLOSED = 676
-ERROR_EXTRANEOUS_INFORMATION = 677
-ERROR_RXACT_COMMIT_NECESSARY = 678
-ERROR_MEDIA_CHECK = 679
-ERROR_GUID_SUBSTITUTION_MADE = 680
-ERROR_STOPPED_ON_SYMLINK = 681
-ERROR_LONGJUMP = 682
-ERROR_PLUGPLAY_QUERY_VETOED = 683
-ERROR_UNWIND_CONSOLIDATE = 684
-ERROR_REGISTRY_HIVE_RECOVERED = 685
-ERROR_DLL_MIGHT_BE_INSECURE = 686
-ERROR_DLL_MIGHT_BE_INCOMPATIBLE = 687
-ERROR_DBG_EXCEPTION_NOT_HANDLED = 688
-ERROR_DBG_REPLY_LATER = 689
-ERROR_DBG_UNABLE_TO_PROVIDE_HANDLE = 690
-ERROR_DBG_TERMINATE_THREAD = 691
-ERROR_DBG_TERMINATE_PROCESS = 692
-ERROR_DBG_CONTROL_C = 693
-ERROR_DBG_PRINTEXCEPTION_C = 694
-ERROR_DBG_RIPEXCEPTION = 695
-ERROR_DBG_CONTROL_BREAK = 696
-ERROR_DBG_COMMAND_EXCEPTION = 697
-ERROR_OBJECT_NAME_EXISTS = 698
-ERROR_THREAD_WAS_SUSPENDED = 699
-ERROR_IMAGE_NOT_AT_BASE = 700
-ERROR_RXACT_STATE_CREATED = 701
-ERROR_SEGMENT_NOTIFICATION = 702
-ERROR_BAD_CURRENT_DIRECTORY = 703
-ERROR_FT_READ_RECOVERY_FROM_BACKUP = 704
-ERROR_FT_WRITE_RECOVERY = 705
-ERROR_IMAGE_MACHINE_TYPE_MISMATCH = 706
-ERROR_RECEIVE_PARTIAL = 707
-ERROR_RECEIVE_EXPEDITED = 708
-ERROR_RECEIVE_PARTIAL_EXPEDITED = 709
-ERROR_EVENT_DONE = 710
-ERROR_EVENT_PENDING = 711
-ERROR_CHECKING_FILE_SYSTEM = 712
-ERROR_FATAL_APP_EXIT = 713
-ERROR_PREDEFINED_HANDLE = 714
-ERROR_WAS_UNLOCKED = 715
-ERROR_SERVICE_NOTIFICATION = 716
-ERROR_WAS_LOCKED = 717
-ERROR_LOG_HARD_ERROR = 718
-ERROR_ALREADY_WIN32 = 719
-ERROR_IMAGE_MACHINE_TYPE_MISMATCH_EXE = 720
-ERROR_NO_YIELD_PERFORMED = 721
-ERROR_TIMER_RESUME_IGNORED = 722
-ERROR_ARBITRATION_UNHANDLED = 723
-ERROR_CARDBUS_NOT_SUPPORTED = 724
-ERROR_MP_PROCESSOR_MISMATCH = 725
-ERROR_HIBERNATED = 726
-ERROR_RESUME_HIBERNATION = 727
-ERROR_FIRMWARE_UPDATED = 728
-ERROR_DRIVERS_LEAKING_LOCKED_PAGES = 729
-ERROR_WAKE_SYSTEM = 730
-ERROR_WAIT_1 = 731
-ERROR_WAIT_2 = 732
-ERROR_WAIT_3 = 733
-ERROR_WAIT_63 = 734
-ERROR_ABANDONED_WAIT_0 = 735
-ERROR_ABANDONED_WAIT_63 = 736
-ERROR_USER_APC = 737
-ERROR_KERNEL_APC = 738
-ERROR_ALERTED = 739
-ERROR_ELEVATION_REQUIRED = 740
-ERROR_REPARSE = 741
-ERROR_OPLOCK_BREAK_IN_PROGRESS = 742
-ERROR_VOLUME_MOUNTED = 743
-ERROR_RXACT_COMMITTED = 744
-ERROR_NOTIFY_CLEANUP = 745
-ERROR_PRIMARY_TRANSPORT_CONNECT_FAILED = 746
-ERROR_PAGE_FAULT_TRANSITION = 747
-ERROR_PAGE_FAULT_DEMAND_ZERO = 748
-ERROR_PAGE_FAULT_COPY_ON_WRITE = 749
-ERROR_PAGE_FAULT_GUARD_PAGE = 750
-ERROR_PAGE_FAULT_PAGING_FILE = 751
-ERROR_CACHE_PAGE_LOCKED = 752
-ERROR_CRASH_DUMP = 753
-ERROR_BUFFER_ALL_ZEROS = 754
-ERROR_REPARSE_OBJECT = 755
-ERROR_RESOURCE_REQUIREMENTS_CHANGED = 756
-ERROR_TRANSLATION_COMPLETE = 757
-ERROR_NOTHING_TO_TERMINATE = 758
-ERROR_PROCESS_NOT_IN_JOB = 759
-ERROR_PROCESS_IN_JOB = 760
-ERROR_VOLSNAP_HIBERNATE_READY = 761
-ERROR_FSFILTER_OP_COMPLETED_SUCCESSFULLY = 762
-ERROR_INTERRUPT_VECTOR_ALREADY_CONNECTED = 763
-ERROR_INTERRUPT_STILL_CONNECTED = 764
-ERROR_WAIT_FOR_OPLOCK = 765
-ERROR_DBG_EXCEPTION_HANDLED = 766
-ERROR_DBG_CONTINUE = 767
-ERROR_CALLBACK_POP_STACK = 768
-ERROR_COMPRESSION_DISABLED = 769
-ERROR_CANTFETCHBACKWARDS = 770
-ERROR_CANTSCROLLBACKWARDS = 771
-ERROR_ROWSNOTRELEASED = 772
-ERROR_BAD_ACCESSOR_FLAGS = 773
-ERROR_ERRORS_ENCOUNTERED = 774
-ERROR_NOT_CAPABLE = 775
-ERROR_REQUEST_OUT_OF_SEQUENCE = 776
-ERROR_VERSION_PARSE_ERROR = 777
-ERROR_BADSTARTPOSITION = 778
-ERROR_MEMORY_HARDWARE = 779
-ERROR_DISK_REPAIR_DISABLED = 780
-ERROR_INSUFFICIENT_RESOURCE_FOR_SPECIFIED_SHARED_SECTION_SIZE = 781
-ERROR_SYSTEM_POWERSTATE_TRANSITION = 782
-ERROR_SYSTEM_POWERSTATE_COMPLEX_TRANSITION = 783
-ERROR_MCA_EXCEPTION = 784
-ERROR_ACCESS_AUDIT_BY_POLICY = 785
-ERROR_ACCESS_DISABLED_NO_SAFER_UI_BY_POLICY = 786
-ERROR_ABANDON_HIBERFILE = 787
-ERROR_LOST_WRITEBEHIND_DATA_NETWORK_DISCONNECTED = 788
-ERROR_LOST_WRITEBEHIND_DATA_NETWORK_SERVER_ERROR = 789
-ERROR_LOST_WRITEBEHIND_DATA_LOCAL_DISK_ERROR = 790
-ERROR_BAD_MCFG_TABLE = 791
-ERROR_EA_ACCESS_DENIED = 994
-ERROR_OPERATION_ABORTED = 995
-ERROR_IO_INCOMPLETE = 996
-ERROR_IO_PENDING = 997
-ERROR_NOACCESS = 998
-ERROR_SWAPERROR = 999
-ERROR_STACK_OVERFLOW = 1001
-ERROR_INVALID_MESSAGE = 1002
-ERROR_CAN_NOT_COMPLETE = 1003
-ERROR_INVALID_FLAGS = 1004
-ERROR_UNRECOGNIZED_VOLUME = 1005
-ERROR_FILE_INVALID = 1006
-ERROR_FULLSCREEN_MODE = 1007
-ERROR_NO_TOKEN = 1008
-ERROR_BADDB = 1009
-ERROR_BADKEY = 1010
-ERROR_CANTOPEN = 1011
-ERROR_CANTREAD = 1012
-ERROR_CANTWRITE = 1013
-ERROR_REGISTRY_RECOVERED = 1014
-ERROR_REGISTRY_CORRUPT = 1015
-ERROR_REGISTRY_IO_FAILED = 1016
-ERROR_NOT_REGISTRY_FILE = 1017
-ERROR_KEY_DELETED = 1018
-ERROR_NO_LOG_SPACE = 1019
-ERROR_KEY_HAS_CHILDREN = 1020
-ERROR_CHILD_MUST_BE_VOLATILE = 1021
-ERROR_NOTIFY_ENUM_DIR = 1022
-ERROR_DEPENDENT_SERVICES_RUNNING = 1051
-ERROR_INVALID_SERVICE_CONTROL = 1052
-ERROR_SERVICE_REQUEST_TIMEOUT = 1053
-ERROR_SERVICE_NO_THREAD = 1054
-ERROR_SERVICE_DATABASE_LOCKED = 1055
-ERROR_SERVICE_ALREADY_RUNNING = 1056
-ERROR_INVALID_SERVICE_ACCOUNT = 1057
-ERROR_SERVICE_DISABLED = 1058
-ERROR_CIRCULAR_DEPENDENCY = 1059
-ERROR_SERVICE_DOES_NOT_EXIST = 1060
-ERROR_SERVICE_CANNOT_ACCEPT_CTRL = 1061
-ERROR_SERVICE_NOT_ACTIVE = 1062
-ERROR_FAILED_SERVICE_CONTROLLER_CONNECT = 1063
-ERROR_EXCEPTION_IN_SERVICE = 1064
-ERROR_DATABASE_DOES_NOT_EXIST = 1065
-ERROR_SERVICE_SPECIFIC_ERROR = 1066
-ERROR_PROCESS_ABORTED = 1067
-ERROR_SERVICE_DEPENDENCY_FAIL = 1068
-ERROR_SERVICE_LOGON_FAILED = 1069
-ERROR_SERVICE_START_HANG = 1070
-ERROR_INVALID_SERVICE_LOCK = 1071
-ERROR_SERVICE_MARKED_FOR_DELETE = 1072
-ERROR_SERVICE_EXISTS = 1073
-ERROR_ALREADY_RUNNING_LKG = 1074
-ERROR_SERVICE_DEPENDENCY_DELETED = 1075
-ERROR_BOOT_ALREADY_ACCEPTED = 1076
-ERROR_SERVICE_NEVER_STARTED = 1077
-ERROR_DUPLICATE_SERVICE_NAME = 1078
-ERROR_DIFFERENT_SERVICE_ACCOUNT = 1079
-ERROR_CANNOT_DETECT_DRIVER_FAILURE = 1080
-ERROR_CANNOT_DETECT_PROCESS_ABORT = 1081
-ERROR_NO_RECOVERY_PROGRAM = 1082
-ERROR_SERVICE_NOT_IN_EXE = 1083
-ERROR_NOT_SAFEBOOT_SERVICE = 1084
-ERROR_END_OF_MEDIA = 1100
-ERROR_FILEMARK_DETECTED = 1101
-ERROR_BEGINNING_OF_MEDIA = 1102
-ERROR_SETMARK_DETECTED = 1103
-ERROR_NO_DATA_DETECTED = 1104
-ERROR_PARTITION_FAILURE = 1105
-ERROR_INVALID_BLOCK_LENGTH = 1106
-ERROR_DEVICE_NOT_PARTITIONED = 1107
-ERROR_UNABLE_TO_LOCK_MEDIA = 1108
-ERROR_UNABLE_TO_UNLOAD_MEDIA = 1109
-ERROR_MEDIA_CHANGED = 1110
-ERROR_BUS_RESET = 1111
-ERROR_NO_MEDIA_IN_DRIVE = 1112
-ERROR_NO_UNICODE_TRANSLATION = 1113
-ERROR_DLL_INIT_FAILED = 1114
-ERROR_SHUTDOWN_IN_PROGRESS = 1115
-ERROR_NO_SHUTDOWN_IN_PROGRESS = 1116
-ERROR_IO_DEVICE = 1117
-ERROR_SERIAL_NO_DEVICE = 1118
-ERROR_IRQ_BUSY = 1119
-ERROR_MORE_WRITES = 1120
-ERROR_COUNTER_TIMEOUT = 1121
-ERROR_FLOPPY_ID_MARK_NOT_FOUND = 1122
-ERROR_FLOPPY_WRONG_CYLINDER = 1123
-ERROR_FLOPPY_UNKNOWN_ERROR = 1124
-ERROR_FLOPPY_BAD_REGISTERS = 1125
-ERROR_DISK_RECALIBRATE_FAILED = 1126
-ERROR_DISK_OPERATION_FAILED = 1127
-ERROR_DISK_RESET_FAILED = 1128
-ERROR_EOM_OVERFLOW = 1129
-ERROR_NOT_ENOUGH_SERVER_MEMORY = 1130
-ERROR_POSSIBLE_DEADLOCK = 1131
-ERROR_MAPPED_ALIGNMENT = 1132
-ERROR_SET_POWER_STATE_VETOED = 1140
-ERROR_SET_POWER_STATE_FAILED = 1141
-ERROR_TOO_MANY_LINKS = 1142
-ERROR_OLD_WIN_VERSION = 1150
-ERROR_APP_WRONG_OS = 1151
-ERROR_SINGLE_INSTANCE_APP = 1152
-ERROR_RMODE_APP = 1153
-ERROR_INVALID_DLL = 1154
-ERROR_NO_ASSOCIATION = 1155
-ERROR_DDE_FAIL = 1156
-ERROR_DLL_NOT_FOUND = 1157
-ERROR_NO_MORE_USER_HANDLES = 1158
-ERROR_MESSAGE_SYNC_ONLY = 1159
-ERROR_SOURCE_ELEMENT_EMPTY = 1160
-ERROR_DESTINATION_ELEMENT_FULL = 1161
-ERROR_ILLEGAL_ELEMENT_ADDRESS = 1162
-ERROR_MAGAZINE_NOT_PRESENT = 1163
-ERROR_DEVICE_REINITIALIZATION_NEEDED = 1164
-ERROR_DEVICE_REQUIRES_CLEANING = 1165
-ERROR_DEVICE_DOOR_OPEN = 1166
-ERROR_DEVICE_NOT_CONNECTED = 1167
-ERROR_NOT_FOUND = 1168
-ERROR_NO_MATCH = 1169
-ERROR_SET_NOT_FOUND = 1170
-ERROR_POINT_NOT_FOUND = 1171
-ERROR_NO_TRACKING_SERVICE = 1172
-ERROR_NO_VOLUME_ID = 1173
-ERROR_CONNECTED_OTHER_PASSWORD = 2108
-ERROR_BAD_USERNAME = 2202
-ERROR_NOT_CONNECTED = 2250
-ERROR_OPEN_FILES = 2401
-ERROR_ACTIVE_CONNECTIONS = 2402
-ERROR_DEVICE_IN_USE = 2404
-ERROR_BAD_DEVICE = 1200
-ERROR_CONNECTION_UNAVAIL = 1201
-ERROR_DEVICE_ALREADY_REMEMBERED = 1202
-ERROR_NO_NET_OR_BAD_PATH = 1203
-ERROR_BAD_PROVIDER = 1204
-ERROR_CANNOT_OPEN_PROFILE = 1205
-ERROR_BAD_PROFILE = 1206
-ERROR_NOT_CONTAINER = 1207
-ERROR_EXTENDED_ERROR = 1208
-ERROR_INVALID_GROUPNAME = 1209
-ERROR_INVALID_COMPUTERNAME = 1210
-ERROR_INVALID_EVENTNAME = 1211
-ERROR_INVALID_DOMAINNAME = 1212
-ERROR_INVALID_SERVICENAME = 1213
-ERROR_INVALID_NETNAME = 1214
-ERROR_INVALID_SHARENAME = 1215
-ERROR_INVALID_PASSWORDNAME = 1216
-ERROR_INVALID_MESSAGENAME = 1217
-ERROR_INVALID_MESSAGEDEST = 1218
-ERROR_SESSION_CREDENTIAL_CONFLICT = 1219
-ERROR_REMOTE_SESSION_LIMIT_EXCEEDED = 1220
-ERROR_DUP_DOMAINNAME = 1221
-ERROR_NO_NETWORK = 1222
-ERROR_CANCELLED = 1223
-ERROR_USER_MAPPED_FILE = 1224
-ERROR_CONNECTION_REFUSED = 1225
-ERROR_GRACEFUL_DISCONNECT = 1226
-ERROR_ADDRESS_ALREADY_ASSOCIATED = 1227
-ERROR_ADDRESS_NOT_ASSOCIATED = 1228
-ERROR_CONNECTION_INVALID = 1229
-ERROR_CONNECTION_ACTIVE = 1230
-ERROR_NETWORK_UNREACHABLE = 1231
-ERROR_HOST_UNREACHABLE = 1232
-ERROR_PROTOCOL_UNREACHABLE = 1233
-ERROR_PORT_UNREACHABLE = 1234
-ERROR_REQUEST_ABORTED = 1235
-ERROR_CONNECTION_ABORTED = 1236
-ERROR_RETRY = 1237
-ERROR_CONNECTION_COUNT_LIMIT = 1238
-ERROR_LOGIN_TIME_RESTRICTION = 1239
-ERROR_LOGIN_WKSTA_RESTRICTION = 1240
-ERROR_INCORRECT_ADDRESS = 1241
-ERROR_ALREADY_REGISTERED = 1242
-ERROR_SERVICE_NOT_FOUND = 1243
-ERROR_NOT_AUTHENTICATED = 1244
-ERROR_NOT_LOGGED_ON = 1245
-ERROR_CONTINUE = 1246
-ERROR_ALREADY_INITIALIZED = 1247
-ERROR_NO_MORE_DEVICES = 1248
-ERROR_NO_SUCH_SITE = 1249
-ERROR_DOMAIN_CONTROLLER_EXISTS = 1250
-ERROR_DS_NOT_INSTALLED = 1251
-ERROR_NOT_ALL_ASSIGNED = 1300
-ERROR_SOME_NOT_MAPPED = 1301
-ERROR_NO_QUOTAS_FOR_ACCOUNT = 1302
-ERROR_LOCAL_USER_SESSION_KEY = 1303
-ERROR_NULL_LM_PASSWORD = 1304
-ERROR_UNKNOWN_REVISION = 1305
-ERROR_REVISION_MISMATCH = 1306
-ERROR_INVALID_OWNER = 1307
-ERROR_INVALID_PRIMARY_GROUP = 1308
-ERROR_NO_IMPERSONATION_TOKEN = 1309
-ERROR_CANT_DISABLE_MANDATORY = 1310
-ERROR_NO_LOGON_SERVERS = 1311
-ERROR_NO_SUCH_LOGON_SESSION = 1312
-ERROR_NO_SUCH_PRIVILEGE = 1313
-ERROR_PRIVILEGE_NOT_HELD = 1314
-ERROR_INVALID_ACCOUNT_NAME = 1315
-ERROR_USER_EXISTS = 1316
-ERROR_NO_SUCH_USER = 1317
-ERROR_GROUP_EXISTS = 1318
-ERROR_NO_SUCH_GROUP = 1319
-ERROR_MEMBER_IN_GROUP = 1320
-ERROR_MEMBER_NOT_IN_GROUP = 1321
-ERROR_LAST_ADMIN = 1322
-ERROR_WRONG_PASSWORD = 1323
-ERROR_ILL_FORMED_PASSWORD = 1324
-ERROR_PASSWORD_RESTRICTION = 1325
-ERROR_LOGON_FAILURE = 1326
-ERROR_ACCOUNT_RESTRICTION = 1327
-ERROR_INVALID_LOGON_HOURS = 1328
-ERROR_INVALID_WORKSTATION = 1329
-ERROR_PASSWORD_EXPIRED = 1330
-ERROR_ACCOUNT_DISABLED = 1331
-ERROR_NONE_MAPPED = 1332
-ERROR_TOO_MANY_LUIDS_REQUESTED = 1333
-ERROR_LUIDS_EXHAUSTED = 1334
-ERROR_INVALID_SUB_AUTHORITY = 1335
-ERROR_INVALID_ACL = 1336
-ERROR_INVALID_SID = 1337
-ERROR_INVALID_SECURITY_DESCR = 1338
-ERROR_BAD_INHERITANCE_ACL = 1340
-ERROR_SERVER_DISABLED = 1341
-ERROR_SERVER_NOT_DISABLED = 1342
-ERROR_INVALID_ID_AUTHORITY = 1343
-ERROR_ALLOTTED_SPACE_EXCEEDED = 1344
-ERROR_INVALID_GROUP_ATTRIBUTES = 1345
-ERROR_BAD_IMPERSONATION_LEVEL = 1346
-ERROR_CANT_OPEN_ANONYMOUS = 1347
-ERROR_BAD_VALIDATION_CLASS = 1348
-ERROR_BAD_TOKEN_TYPE = 1349
-ERROR_NO_SECURITY_ON_OBJECT = 1350
-ERROR_CANT_ACCESS_DOMAIN_INFO = 1351
-ERROR_INVALID_SERVER_STATE = 1352
-ERROR_INVALID_DOMAIN_STATE = 1353
-ERROR_INVALID_DOMAIN_ROLE = 1354
-ERROR_NO_SUCH_DOMAIN = 1355
-ERROR_DOMAIN_EXISTS = 1356
-ERROR_DOMAIN_LIMIT_EXCEEDED = 1357
-ERROR_INTERNAL_DB_CORRUPTION = 1358
-ERROR_INTERNAL_ERROR = 1359
-ERROR_GENERIC_NOT_MAPPED = 1360
-ERROR_BAD_DESCRIPTOR_FORMAT = 1361
-ERROR_NOT_LOGON_PROCESS = 1362
-ERROR_LOGON_SESSION_EXISTS = 1363
-ERROR_NO_SUCH_PACKAGE = 1364
-ERROR_BAD_LOGON_SESSION_STATE = 1365
-ERROR_LOGON_SESSION_COLLISION = 1366
-ERROR_INVALID_LOGON_TYPE = 1367
-ERROR_CANNOT_IMPERSONATE = 1368
-ERROR_RXACT_INVALID_STATE = 1369
-ERROR_RXACT_COMMIT_FAILURE = 1370
-ERROR_SPECIAL_ACCOUNT = 1371
-ERROR_SPECIAL_GROUP = 1372
-ERROR_SPECIAL_USER = 1373
-ERROR_MEMBERS_PRIMARY_GROUP = 1374
-ERROR_TOKEN_ALREADY_IN_USE = 1375
-ERROR_NO_SUCH_ALIAS = 1376
-ERROR_MEMBER_NOT_IN_ALIAS = 1377
-ERROR_MEMBER_IN_ALIAS = 1378
-ERROR_ALIAS_EXISTS = 1379
-ERROR_LOGON_NOT_GRANTED = 1380
-ERROR_TOO_MANY_SECRETS = 1381
-ERROR_SECRET_TOO_LONG = 1382
-ERROR_INTERNAL_DB_ERROR = 1383
-ERROR_TOO_MANY_CONTEXT_IDS = 1384
-ERROR_LOGON_TYPE_NOT_GRANTED = 1385
-ERROR_NT_CROSS_ENCRYPTION_REQUIRED = 1386
-ERROR_NO_SUCH_MEMBER = 1387
-ERROR_INVALID_MEMBER = 1388
-ERROR_TOO_MANY_SIDS = 1389
-ERROR_LM_CROSS_ENCRYPTION_REQUIRED = 1390
-ERROR_NO_INHERITANCE = 1391
-ERROR_FILE_CORRUPT = 1392
-ERROR_DISK_CORRUPT = 1393
-ERROR_NO_USER_SESSION_KEY = 1394
-ERROR_LICENSE_QUOTA_EXCEEDED = 1395
-ERROR_INVALID_WINDOW_HANDLE = 1400
-ERROR_INVALID_MENU_HANDLE = 1401
-ERROR_INVALID_CURSOR_HANDLE = 1402
-ERROR_INVALID_ACCEL_HANDLE = 1403
-ERROR_INVALID_HOOK_HANDLE = 1404
-ERROR_INVALID_DWP_HANDLE = 1405
-ERROR_TLW_WITH_WSCHILD = 1406
-ERROR_CANNOT_FIND_WND_CLASS = 1407
-ERROR_WINDOW_OF_OTHER_THREAD = 1408
-ERROR_HOTKEY_ALREADY_REGISTERED = 1409
-ERROR_CLASS_ALREADY_EXISTS = 1410
-ERROR_CLASS_DOES_NOT_EXIST = 1411
-ERROR_CLASS_HAS_WINDOWS = 1412
-ERROR_INVALID_INDEX = 1413
-ERROR_INVALID_ICON_HANDLE = 1414
-ERROR_PRIVATE_DIALOG_INDEX = 1415
-ERROR_LISTBOX_ID_NOT_FOUND = 1416
-ERROR_NO_WILDCARD_CHARACTERS = 1417
-ERROR_CLIPBOARD_NOT_OPEN = 1418
-ERROR_HOTKEY_NOT_REGISTERED = 1419
-ERROR_WINDOW_NOT_DIALOG = 1420
-ERROR_CONTROL_ID_NOT_FOUND = 1421
-ERROR_INVALID_COMBOBOX_MESSAGE = 1422
-ERROR_WINDOW_NOT_COMBOBOX = 1423
-ERROR_INVALID_EDIT_HEIGHT = 1424
-ERROR_DC_NOT_FOUND = 1425
-ERROR_INVALID_HOOK_FILTER = 1426
-ERROR_INVALID_FILTER_PROC = 1427
-ERROR_HOOK_NEEDS_HMOD = 1428
-ERROR_GLOBAL_ONLY_HOOK = 1429
-ERROR_JOURNAL_HOOK_SET = 1430
-ERROR_HOOK_NOT_INSTALLED = 1431
-ERROR_INVALID_LB_MESSAGE = 1432
-ERROR_SETCOUNT_ON_BAD_LB = 1433
-ERROR_LB_WITHOUT_TABSTOPS = 1434
-ERROR_DESTROY_OBJECT_OF_OTHER_THREAD = 1435
-ERROR_CHILD_WINDOW_MENU = 1436
-ERROR_NO_SYSTEM_MENU = 1437
-ERROR_INVALID_MSGBOX_STYLE = 1438
-ERROR_INVALID_SPI_VALUE = 1439
-ERROR_SCREEN_ALREADY_LOCKED = 1440
-ERROR_HWNDS_HAVE_DIFF_PARENT = 1441
-ERROR_NOT_CHILD_WINDOW = 1442
-ERROR_INVALID_GW_COMMAND = 1443
-ERROR_INVALID_THREAD_ID = 1444
-ERROR_NON_MDICHILD_WINDOW = 1445
-ERROR_POPUP_ALREADY_ACTIVE = 1446
-ERROR_NO_SCROLLBARS = 1447
-ERROR_INVALID_SCROLLBAR_RANGE = 1448
-ERROR_INVALID_SHOWWIN_COMMAND = 1449
-ERROR_NO_SYSTEM_RESOURCES = 1450
-ERROR_NONPAGED_SYSTEM_RESOURCES = 1451
-ERROR_PAGED_SYSTEM_RESOURCES = 1452
-ERROR_WORKING_SET_QUOTA = 1453
-ERROR_PAGEFILE_QUOTA = 1454
-ERROR_COMMITMENT_LIMIT = 1455
-ERROR_MENU_ITEM_NOT_FOUND = 1456
-ERROR_INVALID_KEYBOARD_HANDLE = 1457
-ERROR_HOOK_TYPE_NOT_ALLOWED = 1458
-ERROR_REQUIRES_INTERACTIVE_WINDOWSTATION = 1459
-ERROR_TIMEOUT = 1460
-ERROR_INVALID_MONITOR_HANDLE = 1461
-ERROR_INCORRECT_SIZE = 1462
-ERROR_SYMLINK_CLASS_DISABLED = 1463
-ERROR_SYMLINK_NOT_SUPPORTED = 1464
-ERROR_XML_PARSE_ERROR = 1465
-ERROR_XMLDSIG_ERROR = 1466
-ERROR_RESTART_APPLICATION = 1467
-ERROR_WRONG_COMPARTMENT = 1468
-ERROR_AUTHIP_FAILURE = 1469
-ERROR_EVENTLOG_FILE_CORRUPT = 1500
-ERROR_EVENTLOG_CANT_START = 1501
-ERROR_LOG_FILE_FULL = 1502
-ERROR_EVENTLOG_FILE_CHANGED = 1503
-ERROR_EVENTLOG_FILE_CORRUPT = 1500
-ERROR_EVENTLOG_CANT_START = 1501
-ERROR_LOG_FILE_FULL = 1502
-ERROR_INSTALL_SERVICE = 1601
-ERROR_INSTALL_USEREXIT = 1602
-ERROR_INSTALL_FAILURE = 1603
-ERROR_INSTALL_SUSPEND = 1604
-ERROR_UNKNOWN_PRODUCT = 1605
-ERROR_UNKNOWN_FEATURE = 1606
-ERROR_UNKNOWN_COMPONENT = 1607
-ERROR_UNKNOWN_PROPERTY = 1608
-ERROR_INVALID_HANDLE_STATE = 1609
-ERROR_BAD_CONFIGURATION = 1610
-ERROR_INDEX_ABSENT = 1611
-ERROR_INSTALL_SOURCE_ABSENT = 1612
-ERROR_BAD_DATABASE_VERSION = 1613
-ERROR_PRODUCT_UNINSTALLED = 1614
-ERROR_BAD_QUERY_SYNTAX = 1615
-ERROR_INVALID_FIELD = 1616
-ERROR_DEVICE_REMOVED = 1617
-ERROR_INSTALL_ALREADY_RUNNING = 1618
-ERROR_INSTALL_PACKAGE_OPEN_FAILED = 1619
-ERROR_INSTALL_PACKAGE_INVALID = 1620
-ERROR_INSTALL_UI_FAILURE = 1621
-ERROR_INSTALL_LOG_FAILURE = 1622
-ERROR_INSTALL_LANGUAGE_UNSUPPORTED = 1623
-ERROR_INSTALL_TRANSFORM_FAILURE = 1624
-ERROR_INSTALL_PACKAGE_REJECTED = 1625
-ERROR_FUNCTION_NOT_CALLED = 1626
-ERROR_FUNCTION_FAILED = 1627
-ERROR_INVALID_TABLE = 1628
-ERROR_DATATYPE_MISMATCH = 1629
-ERROR_UNSUPPORTED_TYPE = 1630
-ERROR_CREATE_FAILED = 1631
-ERROR_INSTALL_TEMP_UNWRITABLE = 1632
-ERROR_INSTALL_PLATFORM_UNSUPPORTED = 1633
-ERROR_INSTALL_NOTUSED = 1634
-ERROR_PATCH_PACKAGE_OPEN_FAILED = 1635
-ERROR_PATCH_PACKAGE_INVALID = 1636
-ERROR_PATCH_PACKAGE_UNSUPPORTED = 1637
-ERROR_PRODUCT_VERSION = 1638
-ERROR_INVALID_COMMAND_LINE = 1639
-ERROR_INSTALL_REMOTE_DISALLOWED = 1640
-ERROR_SUCCESS_REBOOT_INITIATED = 1641
-ERROR_PATCH_TARGET_NOT_FOUND = 1642
-ERROR_PATCH_PACKAGE_REJECTED = 1643
-ERROR_INSTALL_TRANSFORM_REJECTED = 1644
-ERROR_INSTALL_REMOTE_PROHIBITED = 1645
-ERROR_PATCH_REMOVAL_UNSUPPORTED = 1646
-ERROR_UNKNOWN_PATCH = 1647
-ERROR_PATCH_NO_SEQUENCE = 1648
-ERROR_PATCH_REMOVAL_DISALLOWED = 1649
-ERROR_INVALID_PATCH_XML = 1650
-ERROR_PATCH_MANAGED_ADVERTISED_PRODUCT = 1651
-ERROR_INSTALL_SERVICE_SAFEBOOT = 1652
-RPC_S_INVALID_STRING_BINDING = 1700
-RPC_S_WRONG_KIND_OF_BINDING = 1701
-RPC_S_INVALID_BINDING = 1702
-RPC_S_PROTSEQ_NOT_SUPPORTED = 1703
-RPC_S_INVALID_RPC_PROTSEQ = 1704
-RPC_S_INVALID_STRING_UUID = 1705
-RPC_S_INVALID_ENDPOINT_FORMAT = 1706
-RPC_S_INVALID_NET_ADDR = 1707
-RPC_S_NO_ENDPOINT_FOUND = 1708
-RPC_S_INVALID_TIMEOUT = 1709
-RPC_S_OBJECT_NOT_FOUND = 1710
-RPC_S_ALREADY_REGISTERED = 1711
-RPC_S_TYPE_ALREADY_REGISTERED = 1712
-RPC_S_ALREADY_LISTENING = 1713
-RPC_S_NO_PROTSEQS_REGISTERED = 1714
-RPC_S_NOT_LISTENING = 1715
-RPC_S_UNKNOWN_MGR_TYPE = 1716
-RPC_S_UNKNOWN_IF = 1717
-RPC_S_NO_BINDINGS = 1718
-RPC_S_NO_PROTSEQS = 1719
-RPC_S_CANT_CREATE_ENDPOINT = 1720
-RPC_S_OUT_OF_RESOURCES = 1721
-RPC_S_SERVER_UNAVAILABLE = 1722
-RPC_S_SERVER_TOO_BUSY = 1723
-RPC_S_INVALID_NETWORK_OPTIONS = 1724
-RPC_S_NO_CALL_ACTIVE = 1725
-RPC_S_CALL_FAILED = 1726
-RPC_S_CALL_FAILED_DNE = 1727
-RPC_S_PROTOCOL_ERROR = 1728
-RPC_S_PROXY_ACCESS_DENIED = 1729
-RPC_S_UNSUPPORTED_TRANS_SYN = 1730
-RPC_S_UNSUPPORTED_TYPE = 1732
-RPC_S_INVALID_TAG = 1733
-RPC_S_INVALID_BOUND = 1734
-RPC_S_NO_ENTRY_NAME = 1735
-RPC_S_INVALID_NAME_SYNTAX = 1736
-RPC_S_UNSUPPORTED_NAME_SYNTAX = 1737
-RPC_S_UUID_NO_ADDRESS = 1739
-RPC_S_DUPLICATE_ENDPOINT = 1740
-RPC_S_UNKNOWN_AUTHN_TYPE = 1741
-RPC_S_MAX_CALLS_TOO_SMALL = 1742
-RPC_S_STRING_TOO_LONG = 1743
-RPC_S_PROTSEQ_NOT_FOUND = 1744
-RPC_S_PROCNUM_OUT_OF_RANGE = 1745
-RPC_S_BINDING_HAS_NO_AUTH = 1746
-RPC_S_UNKNOWN_AUTHN_SERVICE = 1747
-RPC_S_UNKNOWN_AUTHN_LEVEL = 1748
-RPC_S_INVALID_AUTH_IDENTITY = 1749
-RPC_S_UNKNOWN_AUTHZ_SERVICE = 1750
-EPT_S_INVALID_ENTRY = 1751
-EPT_S_CANT_PERFORM_OP = 1752
-EPT_S_NOT_REGISTERED = 1753
-RPC_S_NOTHING_TO_EXPORT = 1754
-RPC_S_INCOMPLETE_NAME = 1755
-RPC_S_INVALID_VERS_OPTION = 1756
-RPC_S_NO_MORE_MEMBERS = 1757
-RPC_S_NOT_ALL_OBJS_UNEXPORTED = 1758
-RPC_S_INTERFACE_NOT_FOUND = 1759
-RPC_S_ENTRY_ALREADY_EXISTS = 1760
-RPC_S_ENTRY_NOT_FOUND = 1761
-RPC_S_NAME_SERVICE_UNAVAILABLE = 1762
-RPC_S_INVALID_NAF_ID = 1763
-RPC_S_CANNOT_SUPPORT = 1764
-RPC_S_NO_CONTEXT_AVAILABLE = 1765
-RPC_S_INTERNAL_ERROR = 1766
-RPC_S_ZERO_DIVIDE = 1767
-RPC_S_ADDRESS_ERROR = 1768
-RPC_S_FP_DIV_ZERO = 1769
-RPC_S_FP_UNDERFLOW = 1770
-RPC_S_FP_OVERFLOW = 1771
-RPC_X_NO_MORE_ENTRIES = 1772
-RPC_X_SS_CHAR_TRANS_OPEN_FAIL = 1773
-RPC_X_SS_CHAR_TRANS_SHORT_FILE = 1774
-RPC_X_SS_IN_NULL_CONTEXT = 1775
-RPC_X_SS_CONTEXT_DAMAGED = 1777
-RPC_X_SS_HANDLES_MISMATCH = 1778
-RPC_X_SS_CANNOT_GET_CALL_HANDLE = 1779
-RPC_X_NULL_REF_POINTER = 1780
-RPC_X_ENUM_VALUE_OUT_OF_RANGE = 1781
-RPC_X_BYTE_COUNT_TOO_SMALL = 1782
-RPC_X_BAD_STUB_DATA = 1783
-ERROR_INVALID_USER_BUFFER = 1784
-ERROR_UNRECOGNIZED_MEDIA = 1785
-ERROR_NO_TRUST_LSA_SECRET = 1786
-ERROR_NO_TRUST_SAM_ACCOUNT = 1787
-ERROR_TRUSTED_DOMAIN_FAILURE = 1788
-ERROR_TRUSTED_RELATIONSHIP_FAILURE = 1789
-ERROR_TRUST_FAILURE = 1790
-RPC_S_CALL_IN_PROGRESS = 1791
-ERROR_NETLOGON_NOT_STARTED = 1792
-ERROR_ACCOUNT_EXPIRED = 1793
-ERROR_REDIRECTOR_HAS_OPEN_HANDLES = 1794
-ERROR_PRINTER_DRIVER_ALREADY_INSTALLED = 1795
-ERROR_UNKNOWN_PORT = 1796
-ERROR_UNKNOWN_PRINTER_DRIVER = 1797
-ERROR_UNKNOWN_PRINTPROCESSOR = 1798
-ERROR_INVALID_SEPARATOR_FILE = 1799
-ERROR_INVALID_PRIORITY = 1800
-ERROR_INVALID_PRINTER_NAME = 1801
-ERROR_PRINTER_ALREADY_EXISTS = 1802
-ERROR_INVALID_PRINTER_COMMAND = 1803
-ERROR_INVALID_DATATYPE = 1804
-ERROR_INVALID_ENVIRONMENT = 1805
-RPC_S_NO_MORE_BINDINGS = 1806
-ERROR_NOLOGON_INTERDOMAIN_TRUST_ACCOUNT = 1807
-ERROR_NOLOGON_WORKSTATION_TRUST_ACCOUNT = 1808
-ERROR_NOLOGON_SERVER_TRUST_ACCOUNT = 1809
-ERROR_DOMAIN_TRUST_INCONSISTENT = 1810
-ERROR_SERVER_HAS_OPEN_HANDLES = 1811
-ERROR_RESOURCE_DATA_NOT_FOUND = 1812
-ERROR_RESOURCE_TYPE_NOT_FOUND = 1813
-ERROR_RESOURCE_NAME_NOT_FOUND = 1814
-ERROR_RESOURCE_LANG_NOT_FOUND = 1815
-ERROR_NOT_ENOUGH_QUOTA = 1816
-RPC_S_NO_INTERFACES = 1817
-RPC_S_CALL_CANCELLED = 1818
-RPC_S_BINDING_INCOMPLETE = 1819
-RPC_S_COMM_FAILURE = 1820
-RPC_S_UNSUPPORTED_AUTHN_LEVEL = 1821
-RPC_S_NO_PRINC_NAME = 1822
-RPC_S_NOT_RPC_ERROR = 1823
-RPC_S_UUID_LOCAL_ONLY = 1824
-RPC_S_SEC_PKG_ERROR = 1825
-RPC_S_NOT_CANCELLED = 1826
-RPC_X_INVALID_ES_ACTION = 1827
-RPC_X_WRONG_ES_VERSION = 1828
-RPC_X_WRONG_STUB_VERSION = 1829
-RPC_X_INVALID_PIPE_OBJECT = 1830
-RPC_X_WRONG_PIPE_ORDER = 1831
-RPC_X_WRONG_PIPE_VERSION = 1832
-RPC_S_GROUP_MEMBER_NOT_FOUND = 1898
-EPT_S_CANT_CREATE = 1899
-RPC_S_INVALID_OBJECT = 1900
-ERROR_INVALID_TIME = 1901
-ERROR_INVALID_FORM_NAME = 1902
-ERROR_INVALID_FORM_SIZE = 1903
-ERROR_ALREADY_WAITING = 1904
-ERROR_PRINTER_DELETED = 1905
-ERROR_INVALID_PRINTER_STATE = 1906
-ERROR_PASSWORD_MUST_CHANGE = 1907
-ERROR_DOMAIN_CONTROLLER_NOT_FOUND = 1908
-ERROR_ACCOUNT_LOCKED_OUT = 1909
-OR_INVALID_OXID = 1910
-OR_INVALID_OID = 1911
-OR_INVALID_SET = 1912
-RPC_S_SEND_INCOMPLETE = 1913
-RPC_S_INVALID_ASYNC_HANDLE = 1914
-RPC_S_INVALID_ASYNC_CALL = 1915
-RPC_X_PIPE_CLOSED = 1916
-RPC_X_PIPE_DISCIPLINE_ERROR = 1917
-RPC_X_PIPE_EMPTY = 1918
-ERROR_NO_SITENAME = 1919
-ERROR_CANT_ACCESS_FILE = 1920
-ERROR_CANT_RESOLVE_FILENAME = 1921
-RPC_S_ENTRY_TYPE_MISMATCH = 1922
-RPC_S_NOT_ALL_OBJS_EXPORTED = 1923
-RPC_S_INTERFACE_NOT_EXPORTED = 1924
-RPC_S_PROFILE_NOT_ADDED = 1925
-RPC_S_PRF_ELT_NOT_ADDED = 1926
-RPC_S_PRF_ELT_NOT_REMOVED = 1927
-RPC_S_GRP_ELT_NOT_ADDED = 1928
-RPC_S_GRP_ELT_NOT_REMOVED = 1929
-ERROR_KM_DRIVER_BLOCKED = 1930
-ERROR_CONTEXT_EXPIRED = 1931
-ERROR_PER_USER_TRUST_QUOTA_EXCEEDED = 1932
-ERROR_ALL_USER_TRUST_QUOTA_EXCEEDED = 1933
-ERROR_USER_DELETE_TRUST_QUOTA_EXCEEDED = 1934
-ERROR_AUTHENTICATION_FIREWALL_FAILED = 1935
-ERROR_REMOTE_PRINT_CONNECTIONS_BLOCKED = 1936
-ERROR_NTLM_BLOCKED = 1937
-ERROR_INVALID_PIXEL_FORMAT = 2000
-ERROR_BAD_DRIVER = 2001
-ERROR_INVALID_WINDOW_STYLE = 2002
-ERROR_METAFILE_NOT_SUPPORTED = 2003
-ERROR_TRANSFORM_NOT_SUPPORTED = 2004
-ERROR_CLIPPING_NOT_SUPPORTED = 2005
-ERROR_INVALID_CMM = 2010
-ERROR_INVALID_PROFILE = 2011
-ERROR_TAG_NOT_FOUND = 2012
-ERROR_TAG_NOT_PRESENT = 2013
-ERROR_DUPLICATE_TAG = 2014
-ERROR_PROFILE_NOT_ASSOCIATED_WITH_DEVICE = 2015
-ERROR_PROFILE_NOT_FOUND = 2016
-ERROR_INVALID_COLORSPACE = 2017
-ERROR_ICM_NOT_ENABLED = 2018
-ERROR_DELETING_ICM_XFORM = 2019
-ERROR_INVALID_TRANSFORM = 2020
-ERROR_COLORSPACE_MISMATCH = 2021
-ERROR_INVALID_COLORINDEX = 2022
-ERROR_PROFILE_DOES_NOT_MATCH_DEVICE = 2023
-ERROR_CONNECTED_OTHER_PASSWORD = 2108
-ERROR_CONNECTED_OTHER_PASSWORD_DEFAULT = 2109
-ERROR_BAD_USERNAME = 2202
-ERROR_NOT_CONNECTED = 2250
-ERROR_INVALID_CMM = 2300
-ERROR_INVALID_PROFILE = 2301
-ERROR_TAG_NOT_FOUND = 2302
-ERROR_TAG_NOT_PRESENT = 2303
-ERROR_DUPLICATE_TAG = 2304
-ERROR_PROFILE_NOT_ASSOCIATED_WITH_DEVICE = 2305
-ERROR_PROFILE_NOT_FOUND = 2306
-ERROR_INVALID_COLORSPACE = 2307
-ERROR_ICM_NOT_ENABLED = 2308
-ERROR_DELETING_ICM_XFORM = 2309
-ERROR_INVALID_TRANSFORM = 2310
-ERROR_OPEN_FILES = 2401
-ERROR_ACTIVE_CONNECTIONS = 2402
-ERROR_DEVICE_IN_USE = 2404
-ERROR_UNKNOWN_PRINT_MONITOR = 3000
-ERROR_PRINTER_DRIVER_IN_USE = 3001
-ERROR_SPOOL_FILE_NOT_FOUND = 3002
-ERROR_SPL_NO_STARTDOC = 3003
-ERROR_SPL_NO_ADDJOB = 3004
-ERROR_PRINT_PROCESSOR_ALREADY_INSTALLED = 3005
-ERROR_PRINT_MONITOR_ALREADY_INSTALLED = 3006
-ERROR_INVALID_PRINT_MONITOR = 3007
-ERROR_PRINT_MONITOR_IN_USE = 3008
-ERROR_PRINTER_HAS_JOBS_QUEUED = 3009
-ERROR_SUCCESS_REBOOT_REQUIRED = 3010
-ERROR_SUCCESS_RESTART_REQUIRED = 3011
-ERROR_PRINTER_NOT_FOUND = 3012
-ERROR_PRINTER_DRIVER_WARNED = 3013
-ERROR_PRINTER_DRIVER_BLOCKED = 3014
-ERROR_PRINTER_DRIVER_PACKAGE_IN_USE = 3015
-ERROR_CORE_DRIVER_PACKAGE_NOT_FOUND = 3016
-ERROR_FAIL_REBOOT_REQUIRED = 3017
-ERROR_FAIL_REBOOT_INITIATED = 3018
-ERROR_PRINTER_DRIVER_DOWNLOAD_NEEDED = 3019
-ERROR_PRINT_JOB_RESTART_REQUIRED = 3020
-ERROR_IO_REISSUE_AS_CACHED = 3950
-ERROR_WINS_INTERNAL = 4000
-ERROR_CAN_NOT_DEL_LOCAL_WINS = 4001
-ERROR_STATIC_INIT = 4002
-ERROR_INC_BACKUP = 4003
-ERROR_FULL_BACKUP = 4004
-ERROR_REC_NON_EXISTENT = 4005
-ERROR_RPL_NOT_ALLOWED = 4006
-ERROR_DHCP_ADDRESS_CONFLICT = 4100
-ERROR_WMI_GUID_NOT_FOUND = 4200
-ERROR_WMI_INSTANCE_NOT_FOUND = 4201
-ERROR_WMI_ITEMID_NOT_FOUND = 4202
-ERROR_WMI_TRY_AGAIN = 4203
-ERROR_WMI_DP_NOT_FOUND = 4204
-ERROR_WMI_UNRESOLVED_INSTANCE_REF = 4205
-ERROR_WMI_ALREADY_ENABLED = 4206
-ERROR_WMI_GUID_DISCONNECTED = 4207
-ERROR_WMI_SERVER_UNAVAILABLE = 4208
-ERROR_WMI_DP_FAILED = 4209
-ERROR_WMI_INVALID_MOF = 4210
-ERROR_WMI_INVALID_REGINFO = 4211
-ERROR_WMI_ALREADY_DISABLED = 4212
-ERROR_WMI_READ_ONLY = 4213
-ERROR_WMI_SET_FAILURE = 4214
-ERROR_INVALID_MEDIA = 4300
-ERROR_INVALID_LIBRARY = 4301
-ERROR_INVALID_MEDIA_POOL = 4302
-ERROR_DRIVE_MEDIA_MISMATCH = 4303
-ERROR_MEDIA_OFFLINE = 4304
-ERROR_LIBRARY_OFFLINE = 4305
-ERROR_EMPTY = 4306
-ERROR_NOT_EMPTY = 4307
-ERROR_MEDIA_UNAVAILABLE = 4308
-ERROR_RESOURCE_DISABLED = 4309
-ERROR_INVALID_CLEANER = 4310
-ERROR_UNABLE_TO_CLEAN = 4311
-ERROR_OBJECT_NOT_FOUND = 4312
-ERROR_DATABASE_FAILURE = 4313
-ERROR_DATABASE_FULL = 4314
-ERROR_MEDIA_INCOMPATIBLE = 4315
-ERROR_RESOURCE_NOT_PRESENT = 4316
-ERROR_INVALID_OPERATION = 4317
-ERROR_MEDIA_NOT_AVAILABLE = 4318
-ERROR_DEVICE_NOT_AVAILABLE = 4319
-ERROR_REQUEST_REFUSED = 4320
-ERROR_INVALID_DRIVE_OBJECT = 4321
-ERROR_LIBRARY_FULL = 4322
-ERROR_MEDIUM_NOT_ACCESSIBLE = 4323
-ERROR_UNABLE_TO_LOAD_MEDIUM = 4324
-ERROR_UNABLE_TO_INVENTORY_DRIVE = 4325
-ERROR_UNABLE_TO_INVENTORY_SLOT = 4326
-ERROR_UNABLE_TO_INVENTORY_TRANSPORT = 4327
-ERROR_TRANSPORT_FULL = 4328
-ERROR_CONTROLLING_IEPORT = 4329
-ERROR_UNABLE_TO_EJECT_MOUNTED_MEDIA = 4330
-ERROR_CLEANER_SLOT_SET = 4331
-ERROR_CLEANER_SLOT_NOT_SET = 4332
-ERROR_CLEANER_CARTRIDGE_SPENT = 4333
-ERROR_UNEXPECTED_OMID = 4334
-ERROR_CANT_DELETE_LAST_ITEM = 4335
-ERROR_MESSAGE_EXCEEDS_MAX_SIZE = 4336
-ERROR_VOLUME_CONTAINS_SYS_FILES = 4337
-ERROR_INDIGENOUS_TYPE = 4338
-ERROR_NO_SUPPORTING_DRIVES = 4339
-ERROR_CLEANER_CARTRIDGE_INSTALLED = 4340
-ERROR_IEPORT_FULL = 4341
-ERROR_FILE_OFFLINE = 4350
-ERROR_REMOTE_STORAGE_NOT_ACTIVE = 4351
-ERROR_REMOTE_STORAGE_MEDIA_ERROR = 4352
-ERROR_NOT_A_REPARSE_POINT = 4390
-ERROR_REPARSE_ATTRIBUTE_CONFLICT = 4391
-ERROR_INVALID_REPARSE_DATA = 4392
-ERROR_REPARSE_TAG_INVALID = 4393
-ERROR_REPARSE_TAG_MISMATCH = 4394
-ERROR_VOLUME_NOT_SIS_ENABLED = 4500
-ERROR_DEPENDENT_RESOURCE_EXISTS = 5001
-ERROR_DEPENDENCY_NOT_FOUND = 5002
-ERROR_DEPENDENCY_ALREADY_EXISTS = 5003
-ERROR_RESOURCE_NOT_ONLINE = 5004
-ERROR_HOST_NODE_NOT_AVAILABLE = 5005
-ERROR_RESOURCE_NOT_AVAILABLE = 5006
-ERROR_RESOURCE_NOT_FOUND = 5007
-ERROR_SHUTDOWN_CLUSTER = 5008
-ERROR_CANT_EVICT_ACTIVE_NODE = 5009
-ERROR_OBJECT_ALREADY_EXISTS = 5010
-ERROR_OBJECT_IN_LIST = 5011
-ERROR_GROUP_NOT_AVAILABLE = 5012
-ERROR_GROUP_NOT_FOUND = 5013
-ERROR_GROUP_NOT_ONLINE = 5014
-ERROR_HOST_NODE_NOT_RESOURCE_OWNER = 5015
-ERROR_HOST_NODE_NOT_GROUP_OWNER = 5016
-ERROR_RESMON_CREATE_FAILED = 5017
-ERROR_RESMON_ONLINE_FAILED = 5018
-ERROR_RESOURCE_ONLINE = 5019
-ERROR_QUORUM_RESOURCE = 5020
-ERROR_NOT_QUORUM_CAPABLE = 5021
-ERROR_CLUSTER_SHUTTING_DOWN = 5022
-ERROR_INVALID_STATE = 5023
-ERROR_RESOURCE_PROPERTIES_STORED = 5024
-ERROR_NOT_QUORUM_CLASS = 5025
-ERROR_CORE_RESOURCE = 5026
-ERROR_QUORUM_RESOURCE_ONLINE_FAILED = 5027
-ERROR_QUORUMLOG_OPEN_FAILED = 5028
-ERROR_CLUSTERLOG_CORRUPT = 5029
-ERROR_CLUSTERLOG_RECORD_EXCEEDS_MAXSIZE = 5030
-ERROR_CLUSTERLOG_EXCEEDS_MAXSIZE = 5031
-ERROR_CLUSTERLOG_CHKPOINT_NOT_FOUND = 5032
-ERROR_CLUSTERLOG_NOT_ENOUGH_SPACE = 5033
-ERROR_QUORUM_OWNER_ALIVE = 5034
-ERROR_NETWORK_NOT_AVAILABLE = 5035
-ERROR_NODE_NOT_AVAILABLE = 5036
-ERROR_ALL_NODES_NOT_AVAILABLE = 5037
-ERROR_RESOURCE_FAILED = 5038
-ERROR_CLUSTER_INVALID_NODE = 5039
-ERROR_CLUSTER_NODE_EXISTS = 5040
-ERROR_CLUSTER_JOIN_IN_PROGRESS = 5041
-ERROR_CLUSTER_NODE_NOT_FOUND = 5042
-ERROR_CLUSTER_LOCAL_NODE_NOT_FOUND = 5043
-ERROR_CLUSTER_NETWORK_EXISTS = 5044
-ERROR_CLUSTER_NETWORK_NOT_FOUND = 5045
-ERROR_CLUSTER_NETINTERFACE_EXISTS = 5046
-ERROR_CLUSTER_NETINTERFACE_NOT_FOUND = 5047
-ERROR_CLUSTER_INVALID_REQUEST = 5048
-ERROR_CLUSTER_INVALID_NETWORK_PROVIDER = 5049
-ERROR_CLUSTER_NODE_DOWN = 5050
-ERROR_CLUSTER_NODE_UNREACHABLE = 5051
-ERROR_CLUSTER_NODE_NOT_MEMBER = 5052
-ERROR_CLUSTER_JOIN_NOT_IN_PROGRESS = 5053
-ERROR_CLUSTER_INVALID_NETWORK = 5054
-ERROR_CLUSTER_NODE_UP = 5056
-ERROR_CLUSTER_IPADDR_IN_USE = 5057
-ERROR_CLUSTER_NODE_NOT_PAUSED = 5058
-ERROR_CLUSTER_NO_SECURITY_CONTEXT = 5059
-ERROR_CLUSTER_NETWORK_NOT_INTERNAL = 5060
-ERROR_CLUSTER_NODE_ALREADY_UP = 5061
-ERROR_CLUSTER_NODE_ALREADY_DOWN = 5062
-ERROR_CLUSTER_NETWORK_ALREADY_ONLINE = 5063
-ERROR_CLUSTER_NETWORK_ALREADY_OFFLINE = 5064
-ERROR_CLUSTER_NODE_ALREADY_MEMBER = 5065
-ERROR_CLUSTER_LAST_INTERNAL_NETWORK = 5066
-ERROR_CLUSTER_NETWORK_HAS_DEPENDENTS = 5067
-ERROR_INVALID_OPERATION_ON_QUORUM = 5068
-ERROR_DEPENDENCY_NOT_ALLOWED = 5069
-ERROR_CLUSTER_NODE_PAUSED = 5070
-ERROR_NODE_CANT_HOST_RESOURCE = 5071
-ERROR_CLUSTER_NODE_NOT_READY = 5072
-ERROR_CLUSTER_NODE_SHUTTING_DOWN = 5073
-ERROR_CLUSTER_JOIN_ABORTED = 5074
-ERROR_CLUSTER_INCOMPATIBLE_VERSIONS = 5075
-ERROR_CLUSTER_MAXNUM_OF_RESOURCES_EXCEEDED = 5076
-ERROR_CLUSTER_SYSTEM_CONFIG_CHANGED = 5077
-ERROR_CLUSTER_RESOURCE_TYPE_NOT_FOUND = 5078
-ERROR_CLUSTER_RESTYPE_NOT_SUPPORTED = 5079
-ERROR_CLUSTER_RESNAME_NOT_FOUND = 5080
-ERROR_CLUSTER_NO_RPC_PACKAGES_REGISTERED = 5081
-ERROR_CLUSTER_OWNER_NOT_IN_PREFLIST = 5082
-ERROR_CLUSTER_DATABASE_SEQMISMATCH = 5083
-ERROR_RESMON_INVALID_STATE = 5084
-ERROR_CLUSTER_GUM_NOT_LOCKER = 5085
-ERROR_QUORUM_DISK_NOT_FOUND = 5086
-ERROR_DATABASE_BACKUP_CORRUPT = 5087
-ERROR_CLUSTER_NODE_ALREADY_HAS_DFS_ROOT = 5088
-ERROR_RESOURCE_PROPERTY_UNCHANGEABLE = 5089
-ERROR_CLUSTER_MEMBERSHIP_INVALID_STATE = 5890
-ERROR_CLUSTER_QUORUMLOG_NOT_FOUND = 5891
-ERROR_CLUSTER_MEMBERSHIP_HALT = 5892
-ERROR_CLUSTER_INSTANCE_ID_MISMATCH = 5893
-ERROR_CLUSTER_NETWORK_NOT_FOUND_FOR_IP = 5894
-ERROR_CLUSTER_PROPERTY_DATA_TYPE_MISMATCH = 5895
-ERROR_CLUSTER_EVICT_WITHOUT_CLEANUP = 5896
-ERROR_CLUSTER_PARAMETER_MISMATCH = 5897
-ERROR_NODE_CANNOT_BE_CLUSTERED = 5898
-ERROR_CLUSTER_WRONG_OS_VERSION = 5899
-ERROR_CLUSTER_CANT_CREATE_DUP_CLUSTER_NAME = 5900
-ERROR_CLUSCFG_ALREADY_COMMITTED = 5901
-ERROR_CLUSCFG_ROLLBACK_FAILED = 5902
-ERROR_CLUSCFG_SYSTEM_DISK_DRIVE_LETTER_CONFLICT = 5903
-ERROR_CLUSTER_OLD_VERSION = 5904
-ERROR_CLUSTER_MISMATCHED_COMPUTER_ACCT_NAME = 5905
-ERROR_CLUSTER_NO_NET_ADAPTERS = 5906
-ERROR_CLUSTER_POISONED = 5907
-ERROR_CLUSTER_GROUP_MOVING = 5908
-ERROR_CLUSTER_RESOURCE_TYPE_BUSY = 5909
-ERROR_RESOURCE_CALL_TIMED_OUT = 5910
-ERROR_INVALID_CLUSTER_IPV6_ADDRESS = 5911
-ERROR_CLUSTER_INTERNAL_INVALID_FUNCTION = 5912
-ERROR_CLUSTER_PARAMETER_OUT_OF_BOUNDS = 5913
-ERROR_CLUSTER_PARTIAL_SEND = 5914
-ERROR_CLUSTER_REGISTRY_INVALID_FUNCTION = 5915
-ERROR_CLUSTER_INVALID_STRING_TERMINATION = 5916
-ERROR_CLUSTER_INVALID_STRING_FORMAT = 5917
-ERROR_CLUSTER_DATABASE_TRANSACTION_IN_PROGRESS = 5918
-ERROR_CLUSTER_DATABASE_TRANSACTION_NOT_IN_PROGRESS = 5919
-ERROR_CLUSTER_NULL_DATA = 5920
-ERROR_CLUSTER_PARTIAL_READ = 5921
-ERROR_CLUSTER_PARTIAL_WRITE = 5922
-ERROR_CLUSTER_CANT_DESERIALIZE_DATA = 5923
-ERROR_DEPENDENT_RESOURCE_PROPERTY_CONFLICT = 5924
-ERROR_CLUSTER_NO_QUORUM = 5925
-ERROR_CLUSTER_INVALID_IPV6_NETWORK = 5926
-ERROR_CLUSTER_INVALID_IPV6_TUNNEL_NETWORK = 5927
-ERROR_QUORUM_NOT_ALLOWED_IN_THIS_GROUP = 5928
-ERROR_DEPENDENCY_TREE_TOO_COMPLEX = 5929
-ERROR_EXCEPTION_IN_RESOURCE_CALL = 5930
-ERROR_CLUSTER_RHS_FAILED_INITIALIZATION = 5931
-ERROR_CLUSTER_NOT_INSTALLED = 5932
-ERROR_CLUSTER_RESOURCES_MUST_BE_ONLINE_ON_THE_SAME_NODE = 5933
-ERROR_ENCRYPTION_FAILED = 6000
-ERROR_DECRYPTION_FAILED = 6001
-ERROR_FILE_ENCRYPTED = 6002
-ERROR_NO_RECOVERY_POLICY = 6003
-ERROR_NO_EFS = 6004
-ERROR_WRONG_EFS = 6005
-ERROR_NO_USER_KEYS = 6006
-ERROR_FILE_NOT_ENCRYPTED = 6007
-ERROR_NOT_EXPORT_FORMAT = 6008
-ERROR_FILE_READ_ONLY = 6009
-ERROR_DIR_EFS_DISALLOWED = 6010
-ERROR_EFS_SERVER_NOT_TRUSTED = 6011
-ERROR_BAD_RECOVERY_POLICY = 6012
-ERROR_EFS_ALG_BLOB_TOO_BIG = 6013
-ERROR_VOLUME_NOT_SUPPORT_EFS = 6014
-ERROR_EFS_DISABLED = 6015
-ERROR_EFS_VERSION_NOT_SUPPORT = 6016
-ERROR_CS_ENCRYPTION_INVALID_SERVER_RESPONSE = 6017
-ERROR_CS_ENCRYPTION_UNSUPPORTED_SERVER = 6018
-ERROR_CS_ENCRYPTION_EXISTING_ENCRYPTED_FILE = 6019
-ERROR_CS_ENCRYPTION_NEW_ENCRYPTED_FILE = 6020
-ERROR_CS_ENCRYPTION_FILE_NOT_CSE = 6021
-ERROR_NO_BROWSER_SERVERS_FOUND = 6118
-ERROR_LOG_SECTOR_INVALID = 6600
-ERROR_LOG_SECTOR_PARITY_INVALID = 6601
-ERROR_LOG_SECTOR_REMAPPED = 6602
-ERROR_LOG_BLOCK_INCOMPLETE = 6603
-ERROR_LOG_INVALID_RANGE = 6604
-ERROR_LOG_BLOCKS_EXHAUSTED = 6605
-ERROR_LOG_READ_CONTEXT_INVALID = 6606
-ERROR_LOG_RESTART_INVALID = 6607
-ERROR_LOG_BLOCK_VERSION = 6608
-ERROR_LOG_BLOCK_INVALID = 6609
-ERROR_LOG_READ_MODE_INVALID = 6610
-ERROR_LOG_NO_RESTART = 6611
-ERROR_LOG_METADATA_CORRUPT = 6612
-ERROR_LOG_METADATA_INVALID = 6613
-ERROR_LOG_METADATA_INCONSISTENT = 6614
-ERROR_LOG_RESERVATION_INVALID = 6615
-ERROR_LOG_CANT_DELETE = 6616
-ERROR_LOG_CONTAINER_LIMIT_EXCEEDED = 6617
-ERROR_LOG_START_OF_LOG = 6618
-ERROR_LOG_POLICY_ALREADY_INSTALLED = 6619
-ERROR_LOG_POLICY_NOT_INSTALLED = 6620
-ERROR_LOG_POLICY_INVALID = 6621
-ERROR_LOG_POLICY_CONFLICT = 6622
-ERROR_LOG_PINNED_ARCHIVE_TAIL = 6623
-ERROR_LOG_RECORD_NONEXISTENT = 6624
-ERROR_LOG_RECORDS_RESERVED_INVALID = 6625
-ERROR_LOG_SPACE_RESERVED_INVALID = 6626
-ERROR_LOG_TAIL_INVALID = 6627
-ERROR_LOG_FULL = 6628
-ERROR_COULD_NOT_RESIZE_LOG = 6629
-ERROR_LOG_MULTIPLEXED = 6630
-ERROR_LOG_DEDICATED = 6631
-ERROR_LOG_ARCHIVE_NOT_IN_PROGRESS = 6632
-ERROR_LOG_ARCHIVE_IN_PROGRESS = 6633
-ERROR_LOG_EPHEMERAL = 6634
-ERROR_LOG_NOT_ENOUGH_CONTAINERS = 6635
-ERROR_LOG_CLIENT_ALREADY_REGISTERED = 6636
-ERROR_LOG_CLIENT_NOT_REGISTERED = 6637
-ERROR_LOG_FULL_HANDLER_IN_PROGRESS = 6638
-ERROR_LOG_CONTAINER_READ_FAILED = 6639
-ERROR_LOG_CONTAINER_WRITE_FAILED = 6640
-ERROR_LOG_CONTAINER_OPEN_FAILED = 6641
-ERROR_LOG_CONTAINER_STATE_INVALID = 6642
-ERROR_LOG_STATE_INVALID = 6643
-ERROR_LOG_PINNED = 6644
-ERROR_LOG_METADATA_FLUSH_FAILED = 6645
-ERROR_LOG_INCONSISTENT_SECURITY = 6646
-ERROR_LOG_APPENDED_FLUSH_FAILED = 6647
-ERROR_LOG_PINNED_RESERVATION = 6648
-ERROR_INVALID_TRANSACTION = 6700
-ERROR_TRANSACTION_NOT_ACTIVE = 6701
-ERROR_TRANSACTION_REQUEST_NOT_VALID = 6702
-ERROR_TRANSACTION_NOT_REQUESTED = 6703
-ERROR_TRANSACTION_ALREADY_ABORTED = 6704
-ERROR_TRANSACTION_ALREADY_COMMITTED = 6705
-ERROR_TM_INITIALIZATION_FAILED = 6706
-ERROR_RESOURCEMANAGER_READ_ONLY = 6707
-ERROR_TRANSACTION_NOT_JOINED = 6708
-ERROR_TRANSACTION_SUPERIOR_EXISTS = 6709
-ERROR_CRM_PROTOCOL_ALREADY_EXISTS = 6710
-ERROR_TRANSACTION_PROPAGATION_FAILED = 6711
-ERROR_CRM_PROTOCOL_NOT_FOUND = 6712
-ERROR_TRANSACTION_INVALID_MARSHALL_BUFFER = 6713
-ERROR_CURRENT_TRANSACTION_NOT_VALID = 6714
-ERROR_TRANSACTION_NOT_FOUND = 6715
-ERROR_RESOURCEMANAGER_NOT_FOUND = 6716
-ERROR_ENLISTMENT_NOT_FOUND = 6717
-ERROR_TRANSACTIONMANAGER_NOT_FOUND = 6718
-ERROR_TRANSACTIONMANAGER_NOT_ONLINE = 6719
-ERROR_TRANSACTIONMANAGER_RECOVERY_NAME_COLLISION = 6720
-ERROR_TRANSACTION_NOT_ROOT = 6721
-ERROR_TRANSACTION_OBJECT_EXPIRED = 6722
-ERROR_TRANSACTION_RESPONSE_NOT_ENLISTED = 6723
-ERROR_TRANSACTION_RECORD_TOO_LONG = 6724
-ERROR_IMPLICIT_TRANSACTION_NOT_SUPPORTED = 6725
-ERROR_TRANSACTION_INTEGRITY_VIOLATED = 6726
-ERROR_TRANSACTIONAL_CONFLICT = 6800
-ERROR_RM_NOT_ACTIVE = 6801
-ERROR_RM_METADATA_CORRUPT = 6802
-ERROR_DIRECTORY_NOT_RM = 6803
-ERROR_TRANSACTIONS_UNSUPPORTED_REMOTE = 6805
-ERROR_LOG_RESIZE_INVALID_SIZE = 6806
-ERROR_OBJECT_NO_LONGER_EXISTS = 6807
-ERROR_STREAM_MINIVERSION_NOT_FOUND = 6808
-ERROR_STREAM_MINIVERSION_NOT_VALID = 6809
-ERROR_MINIVERSION_INACCESSIBLE_FROM_SPECIFIED_TRANSACTION = 6810
-ERROR_CANT_OPEN_MINIVERSION_WITH_MODIFY_INTENT = 6811
-ERROR_CANT_CREATE_MORE_STREAM_MINIVERSIONS = 6812
-ERROR_REMOTE_FILE_VERSION_MISMATCH = 6814
-ERROR_HANDLE_NO_LONGER_VALID = 6815
-ERROR_NO_TXF_METADATA = 6816
-ERROR_LOG_CORRUPTION_DETECTED = 6817
-ERROR_CANT_RECOVER_WITH_HANDLE_OPEN = 6818
-ERROR_RM_DISCONNECTED = 6819
-ERROR_ENLISTMENT_NOT_SUPERIOR = 6820
-ERROR_RECOVERY_NOT_NEEDED = 6821
-ERROR_RM_ALREADY_STARTED = 6822
-ERROR_FILE_IDENTITY_NOT_PERSISTENT = 6823
-ERROR_CANT_BREAK_TRANSACTIONAL_DEPENDENCY = 6824
-ERROR_CANT_CROSS_RM_BOUNDARY = 6825
-ERROR_TXF_DIR_NOT_EMPTY = 6826
-ERROR_INDOUBT_TRANSACTIONS_EXIST = 6827
-ERROR_TM_VOLATILE = 6828
-ERROR_ROLLBACK_TIMER_EXPIRED = 6829
-ERROR_TXF_ATTRIBUTE_CORRUPT = 6830
-ERROR_EFS_NOT_ALLOWED_IN_TRANSACTION = 6831
-ERROR_TRANSACTIONAL_OPEN_NOT_ALLOWED = 6832
-ERROR_LOG_GROWTH_FAILED = 6833
-ERROR_TRANSACTED_MAPPING_UNSUPPORTED_REMOTE = 6834
-ERROR_TXF_METADATA_ALREADY_PRESENT = 6835
-ERROR_TRANSACTION_SCOPE_CALLBACKS_NOT_SET = 6836
-ERROR_TRANSACTION_REQUIRED_PROMOTION = 6837
-ERROR_CANNOT_EXECUTE_FILE_IN_TRANSACTION = 6838
-ERROR_TRANSACTIONS_NOT_FROZEN = 6839
-ERROR_TRANSACTION_FREEZE_IN_PROGRESS = 6840
-ERROR_NOT_SNAPSHOT_VOLUME = 6841
-ERROR_NO_SAVEPOINT_WITH_OPEN_FILES = 6842
-ERROR_DATA_LOST_REPAIR = 6843
-ERROR_SPARSE_NOT_ALLOWED_IN_TRANSACTION = 6844
-ERROR_TM_IDENTITY_MISMATCH = 6845
-ERROR_FLOATED_SECTION = 6846
-ERROR_CANNOT_ACCEPT_TRANSACTED_WORK = 6847
-ERROR_CANNOT_ABORT_TRANSACTIONS = 6848
-ERROR_BAD_CLUSTERS = 6849
-ERROR_COMPRESSION_NOT_ALLOWED_IN_TRANSACTION = 6850
-ERROR_VOLUME_DIRTY = 6851
-ERROR_NO_LINK_TRACKING_IN_TRANSACTION = 6852
-ERROR_OPERATION_NOT_SUPPORTED_IN_TRANSACTION = 6853
-ERROR_CTX_WINSTATION_NAME_INVALID = 7001
-ERROR_CTX_INVALID_PD = 7002
-ERROR_CTX_PD_NOT_FOUND = 7003
-ERROR_CTX_WD_NOT_FOUND = 7004
-ERROR_CTX_CANNOT_MAKE_EVENTLOG_ENTRY = 7005
-ERROR_CTX_SERVICE_NAME_COLLISION = 7006
-ERROR_CTX_CLOSE_PENDING = 7007
-ERROR_CTX_NO_OUTBUF = 7008
-ERROR_CTX_MODEM_INF_NOT_FOUND = 7009
-ERROR_CTX_INVALID_MODEMNAME = 7010
-ERROR_CTX_MODEM_RESPONSE_ERROR = 7011
-ERROR_CTX_MODEM_RESPONSE_TIMEOUT = 7012
-ERROR_CTX_MODEM_RESPONSE_NO_CARRIER = 7013
-ERROR_CTX_MODEM_RESPONSE_NO_DIALTONE = 7014
-ERROR_CTX_MODEM_RESPONSE_BUSY = 7015
-ERROR_CTX_MODEM_RESPONSE_VOICE = 7016
-ERROR_CTX_TD_ERROR = 7017
-ERROR_CTX_WINSTATION_NOT_FOUND = 7022
-ERROR_CTX_WINSTATION_ALREADY_EXISTS = 7023
-ERROR_CTX_WINSTATION_BUSY = 7024
-ERROR_CTX_BAD_VIDEO_MODE = 7025
-ERROR_CTX_GRAPHICS_INVALID = 7035
-ERROR_CTX_LOGON_DISABLED = 7037
-ERROR_CTX_NOT_CONSOLE = 7038
-ERROR_CTX_CLIENT_QUERY_TIMEOUT = 7040
-ERROR_CTX_CONSOLE_DISCONNECT = 7041
-ERROR_CTX_CONSOLE_CONNECT = 7042
-ERROR_CTX_SHADOW_DENIED = 7044
-ERROR_CTX_WINSTATION_ACCESS_DENIED = 7045
-ERROR_CTX_INVALID_WD = 7049
-ERROR_CTX_SHADOW_INVALID = 7050
-ERROR_CTX_SHADOW_DISABLED = 7051
-ERROR_CTX_CLIENT_LICENSE_IN_USE = 7052
-ERROR_CTX_CLIENT_LICENSE_NOT_SET = 7053
-ERROR_CTX_LICENSE_NOT_AVAILABLE = 7054
-ERROR_CTX_LICENSE_CLIENT_INVALID = 7055
-ERROR_CTX_LICENSE_EXPIRED = 7056
-ERROR_CTX_SHADOW_NOT_RUNNING = 7057
-ERROR_CTX_SHADOW_ENDED_BY_MODE_CHANGE = 7058
-ERROR_ACTIVATION_COUNT_EXCEEDED = 7059
-ERROR_CTX_WINSTATIONS_DISABLED = 7060
-ERROR_CTX_ENCRYPTION_LEVEL_REQUIRED = 7061
-ERROR_CTX_SESSION_IN_USE = 7062
-ERROR_CTX_NO_FORCE_LOGOFF = 7063
-ERROR_CTX_ACCOUNT_RESTRICTION = 7064
-ERROR_RDP_PROTOCOL_ERROR = 7065
-ERROR_CTX_CDM_CONNECT = 7066
-ERROR_CTX_CDM_DISCONNECT = 7067
-ERROR_CTX_SECURITY_LAYER_ERROR = 7068
-ERROR_TS_INCOMPATIBLE_SESSIONS = 7069
-FRS_ERR_INVALID_API_SEQUENCE = 8001
-FRS_ERR_STARTING_SERVICE = 8002
-FRS_ERR_STOPPING_SERVICE = 8003
-FRS_ERR_INTERNAL_API = 8004
-FRS_ERR_INTERNAL = 8005
-FRS_ERR_SERVICE_COMM = 8006
-FRS_ERR_INSUFFICIENT_PRIV = 8007
-FRS_ERR_AUTHENTICATION = 8008
-FRS_ERR_PARENT_INSUFFICIENT_PRIV = 8009
-FRS_ERR_PARENT_AUTHENTICATION = 8010
-FRS_ERR_CHILD_TO_PARENT_COMM = 8011
-FRS_ERR_PARENT_TO_CHILD_COMM = 8012
-FRS_ERR_SYSVOL_POPULATE = 8013
-FRS_ERR_SYSVOL_POPULATE_TIMEOUT = 8014
-FRS_ERR_SYSVOL_IS_BUSY = 8015
-FRS_ERR_SYSVOL_DEMOTE = 8016
-FRS_ERR_INVALID_SERVICE_PARAMETER = 8017
-DS_S_SUCCESS = NO_ERROR
-ERROR_DS_NOT_INSTALLED = 8200
-ERROR_DS_MEMBERSHIP_EVALUATED_LOCALLY = 8201
-ERROR_DS_NO_ATTRIBUTE_OR_VALUE = 8202
-ERROR_DS_INVALID_ATTRIBUTE_SYNTAX = 8203
-ERROR_DS_ATTRIBUTE_TYPE_UNDEFINED = 8204
-ERROR_DS_ATTRIBUTE_OR_VALUE_EXISTS = 8205
-ERROR_DS_BUSY = 8206
-ERROR_DS_UNAVAILABLE = 8207
-ERROR_DS_NO_RIDS_ALLOCATED = 8208
-ERROR_DS_NO_MORE_RIDS = 8209
-ERROR_DS_INCORRECT_ROLE_OWNER = 8210
-ERROR_DS_RIDMGR_INIT_ERROR = 8211
-ERROR_DS_OBJ_CLASS_VIOLATION = 8212
-ERROR_DS_CANT_ON_NON_LEAF = 8213
-ERROR_DS_CANT_ON_RDN = 8214
-ERROR_DS_CANT_MOD_OBJ_CLASS = 8215
-ERROR_DS_CROSS_DOM_MOVE_ERROR = 8216
-ERROR_DS_GC_NOT_AVAILABLE = 8217
-ERROR_SHARED_POLICY = 8218
-ERROR_POLICY_OBJECT_NOT_FOUND = 8219
-ERROR_POLICY_ONLY_IN_DS = 8220
-ERROR_PROMOTION_ACTIVE = 8221
-ERROR_NO_PROMOTION_ACTIVE = 8222
-ERROR_DS_OPERATIONS_ERROR = 8224
-ERROR_DS_PROTOCOL_ERROR = 8225
-ERROR_DS_TIMELIMIT_EXCEEDED = 8226
-ERROR_DS_SIZELIMIT_EXCEEDED = 8227
-ERROR_DS_ADMIN_LIMIT_EXCEEDED = 8228
-ERROR_DS_COMPARE_FALSE = 8229
-ERROR_DS_COMPARE_TRUE = 8230
-ERROR_DS_AUTH_METHOD_NOT_SUPPORTED = 8231
-ERROR_DS_STRONG_AUTH_REQUIRED = 8232
-ERROR_DS_INAPPROPRIATE_AUTH = 8233
-ERROR_DS_AUTH_UNKNOWN = 8234
-ERROR_DS_REFERRAL = 8235
-ERROR_DS_UNAVAILABLE_CRIT_EXTENSION = 8236
-ERROR_DS_CONFIDENTIALITY_REQUIRED = 8237
-ERROR_DS_INAPPROPRIATE_MATCHING = 8238
-ERROR_DS_CONSTRAINT_VIOLATION = 8239
-ERROR_DS_NO_SUCH_OBJECT = 8240
-ERROR_DS_ALIAS_PROBLEM = 8241
-ERROR_DS_INVALID_DN_SYNTAX = 8242
-ERROR_DS_IS_LEAF = 8243
-ERROR_DS_ALIAS_DEREF_PROBLEM = 8244
-ERROR_DS_UNWILLING_TO_PERFORM = 8245
-ERROR_DS_LOOP_DETECT = 8246
-ERROR_DS_NAMING_VIOLATION = 8247
-ERROR_DS_OBJECT_RESULTS_TOO_LARGE = 8248
-ERROR_DS_AFFECTS_MULTIPLE_DSAS = 8249
-ERROR_DS_SERVER_DOWN = 8250
-ERROR_DS_LOCAL_ERROR = 8251
-ERROR_DS_ENCODING_ERROR = 8252
-ERROR_DS_DECODING_ERROR = 8253
-ERROR_DS_FILTER_UNKNOWN = 8254
-ERROR_DS_PARAM_ERROR = 8255
-ERROR_DS_NOT_SUPPORTED = 8256
-ERROR_DS_NO_RESULTS_RETURNED = 8257
-ERROR_DS_CONTROL_NOT_FOUND = 8258
-ERROR_DS_CLIENT_LOOP = 8259
-ERROR_DS_REFERRAL_LIMIT_EXCEEDED = 8260
-ERROR_DS_SORT_CONTROL_MISSING = 8261
-ERROR_DS_OFFSET_RANGE_ERROR = 8262
-ERROR_DS_ROOT_MUST_BE_NC = 8301
-ERROR_DS_ADD_REPLICA_INHIBITED = 8302
-ERROR_DS_ATT_NOT_DEF_IN_SCHEMA = 8303
-ERROR_DS_MAX_OBJ_SIZE_EXCEEDED = 8304
-ERROR_DS_OBJ_STRING_NAME_EXISTS = 8305
-ERROR_DS_NO_RDN_DEFINED_IN_SCHEMA = 8306
-ERROR_DS_RDN_DOESNT_MATCH_SCHEMA = 8307
-ERROR_DS_NO_REQUESTED_ATTS_FOUND = 8308
-ERROR_DS_USER_BUFFER_TO_SMALL = 8309
-ERROR_DS_ATT_IS_NOT_ON_OBJ = 8310
-ERROR_DS_ILLEGAL_MOD_OPERATION = 8311
-ERROR_DS_OBJ_TOO_LARGE = 8312
-ERROR_DS_BAD_INSTANCE_TYPE = 8313
-ERROR_DS_MASTERDSA_REQUIRED = 8314
-ERROR_DS_OBJECT_CLASS_REQUIRED = 8315
-ERROR_DS_MISSING_REQUIRED_ATT = 8316
-ERROR_DS_ATT_NOT_DEF_FOR_CLASS = 8317
-ERROR_DS_ATT_ALREADY_EXISTS = 8318
-ERROR_DS_CANT_ADD_ATT_VALUES = 8320
-ERROR_DS_SINGLE_VALUE_CONSTRAINT = 8321
-ERROR_DS_RANGE_CONSTRAINT = 8322
-ERROR_DS_ATT_VAL_ALREADY_EXISTS = 8323
-ERROR_DS_CANT_REM_MISSING_ATT = 8324
-ERROR_DS_CANT_REM_MISSING_ATT_VAL = 8325
-ERROR_DS_ROOT_CANT_BE_SUBREF = 8326
-ERROR_DS_NO_CHAINING = 8327
-ERROR_DS_NO_CHAINED_EVAL = 8328
-ERROR_DS_NO_PARENT_OBJECT = 8329
-ERROR_DS_PARENT_IS_AN_ALIAS = 8330
-ERROR_DS_CANT_MIX_MASTER_AND_REPS = 8331
-ERROR_DS_CHILDREN_EXIST = 8332
-ERROR_DS_OBJ_NOT_FOUND = 8333
-ERROR_DS_ALIASED_OBJ_MISSING = 8334
-ERROR_DS_BAD_NAME_SYNTAX = 8335
-ERROR_DS_ALIAS_POINTS_TO_ALIAS = 8336
-ERROR_DS_CANT_DEREF_ALIAS = 8337
-ERROR_DS_OUT_OF_SCOPE = 8338
-ERROR_DS_OBJECT_BEING_REMOVED = 8339
-ERROR_DS_CANT_DELETE_DSA_OBJ = 8340
-ERROR_DS_GENERIC_ERROR = 8341
-ERROR_DS_DSA_MUST_BE_INT_MASTER = 8342
-ERROR_DS_CLASS_NOT_DSA = 8343
-ERROR_DS_INSUFF_ACCESS_RIGHTS = 8344
-ERROR_DS_ILLEGAL_SUPERIOR = 8345
-ERROR_DS_ATTRIBUTE_OWNED_BY_SAM = 8346
-ERROR_DS_NAME_TOO_MANY_PARTS = 8347
-ERROR_DS_NAME_TOO_LONG = 8348
-ERROR_DS_NAME_VALUE_TOO_LONG = 8349
-ERROR_DS_NAME_UNPARSEABLE = 8350
-ERROR_DS_NAME_TYPE_UNKNOWN = 8351
-ERROR_DS_NOT_AN_OBJECT = 8352
-ERROR_DS_SEC_DESC_TOO_SHORT = 8353
-ERROR_DS_SEC_DESC_INVALID = 8354
-ERROR_DS_NO_DELETED_NAME = 8355
-ERROR_DS_SUBREF_MUST_HAVE_PARENT = 8356
-ERROR_DS_NCNAME_MUST_BE_NC = 8357
-ERROR_DS_CANT_ADD_SYSTEM_ONLY = 8358
-ERROR_DS_CLASS_MUST_BE_CONCRETE = 8359
-ERROR_DS_INVALID_DMD = 8360
-ERROR_DS_OBJ_GUID_EXISTS = 8361
-ERROR_DS_NOT_ON_BACKLINK = 8362
-ERROR_DS_NO_CROSSREF_FOR_NC = 8363
-ERROR_DS_SHUTTING_DOWN = 8364
-ERROR_DS_UNKNOWN_OPERATION = 8365
-ERROR_DS_INVALID_ROLE_OWNER = 8366
-ERROR_DS_COULDNT_CONTACT_FSMO = 8367
-ERROR_DS_CROSS_NC_DN_RENAME = 8368
-ERROR_DS_CANT_MOD_SYSTEM_ONLY = 8369
-ERROR_DS_REPLICATOR_ONLY = 8370
-ERROR_DS_OBJ_CLASS_NOT_DEFINED = 8371
-ERROR_DS_OBJ_CLASS_NOT_SUBCLASS = 8372
-ERROR_DS_NAME_REFERENCE_INVALID = 8373
-ERROR_DS_CROSS_REF_EXISTS = 8374
-ERROR_DS_CANT_DEL_MASTER_CROSSREF = 8375
-ERROR_DS_SUBTREE_NOTIFY_NOT_NC_HEAD = 8376
-ERROR_DS_NOTIFY_FILTER_TOO_COMPLEX = 8377
-ERROR_DS_DUP_RDN = 8378
-ERROR_DS_DUP_OID = 8379
-ERROR_DS_DUP_MAPI_ID = 8380
-ERROR_DS_DUP_SCHEMA_ID_GUID = 8381
-ERROR_DS_DUP_LDAP_DISPLAY_NAME = 8382
-ERROR_DS_SEMANTIC_ATT_TEST = 8383
-ERROR_DS_SYNTAX_MISMATCH = 8384
-ERROR_DS_EXISTS_IN_MUST_HAVE = 8385
-ERROR_DS_EXISTS_IN_MAY_HAVE = 8386
-ERROR_DS_NONEXISTENT_MAY_HAVE = 8387
-ERROR_DS_NONEXISTENT_MUST_HAVE = 8388
-ERROR_DS_AUX_CLS_TEST_FAIL = 8389
-ERROR_DS_NONEXISTENT_POSS_SUP = 8390
-ERROR_DS_SUB_CLS_TEST_FAIL = 8391
-ERROR_DS_BAD_RDN_ATT_ID_SYNTAX = 8392
-ERROR_DS_EXISTS_IN_AUX_CLS = 8393
-ERROR_DS_EXISTS_IN_SUB_CLS = 8394
-ERROR_DS_EXISTS_IN_POSS_SUP = 8395
-ERROR_DS_RECALCSCHEMA_FAILED = 8396
-ERROR_DS_TREE_DELETE_NOT_FINISHED = 8397
-ERROR_DS_CANT_DELETE = 8398
-ERROR_DS_ATT_SCHEMA_REQ_ID = 8399
-ERROR_DS_BAD_ATT_SCHEMA_SYNTAX = 8400
-ERROR_DS_CANT_CACHE_ATT = 8401
-ERROR_DS_CANT_CACHE_CLASS = 8402
-ERROR_DS_CANT_REMOVE_ATT_CACHE = 8403
-ERROR_DS_CANT_REMOVE_CLASS_CACHE = 8404
-ERROR_DS_CANT_RETRIEVE_DN = 8405
-ERROR_DS_MISSING_SUPREF = 8406
-ERROR_DS_CANT_RETRIEVE_INSTANCE = 8407
-ERROR_DS_CODE_INCONSISTENCY = 8408
-ERROR_DS_DATABASE_ERROR = 8409
-ERROR_DS_GOVERNSID_MISSING = 8410
-ERROR_DS_MISSING_EXPECTED_ATT = 8411
-ERROR_DS_NCNAME_MISSING_CR_REF = 8412
-ERROR_DS_SECURITY_CHECKING_ERROR = 8413
-ERROR_DS_SCHEMA_NOT_LOADED = 8414
-ERROR_DS_SCHEMA_ALLOC_FAILED = 8415
-ERROR_DS_ATT_SCHEMA_REQ_SYNTAX = 8416
-ERROR_DS_GCVERIFY_ERROR = 8417
-ERROR_DS_DRA_SCHEMA_MISMATCH = 8418
-ERROR_DS_CANT_FIND_DSA_OBJ = 8419
-ERROR_DS_CANT_FIND_EXPECTED_NC = 8420
-ERROR_DS_CANT_FIND_NC_IN_CACHE = 8421
-ERROR_DS_CANT_RETRIEVE_CHILD = 8422
-ERROR_DS_SECURITY_ILLEGAL_MODIFY = 8423
-ERROR_DS_CANT_REPLACE_HIDDEN_REC = 8424
-ERROR_DS_BAD_HIERARCHY_FILE = 8425
-ERROR_DS_BUILD_HIERARCHY_TABLE_FAILED = 8426
-ERROR_DS_CONFIG_PARAM_MISSING = 8427
-ERROR_DS_COUNTING_AB_INDICES_FAILED = 8428
-ERROR_DS_HIERARCHY_TABLE_MALLOC_FAILED = 8429
-ERROR_DS_INTERNAL_FAILURE = 8430
-ERROR_DS_UNKNOWN_ERROR = 8431
-ERROR_DS_ROOT_REQUIRES_CLASS_TOP = 8432
-ERROR_DS_REFUSING_FSMO_ROLES = 8433
-ERROR_DS_MISSING_FSMO_SETTINGS = 8434
-ERROR_DS_UNABLE_TO_SURRENDER_ROLES = 8435
-ERROR_DS_DRA_GENERIC = 8436
-ERROR_DS_DRA_INVALID_PARAMETER = 8437
-ERROR_DS_DRA_BUSY = 8438
-ERROR_DS_DRA_BAD_DN = 8439
-ERROR_DS_DRA_BAD_NC = 8440
-ERROR_DS_DRA_DN_EXISTS = 8441
-ERROR_DS_DRA_INTERNAL_ERROR = 8442
-ERROR_DS_DRA_INCONSISTENT_DIT = 8443
-ERROR_DS_DRA_CONNECTION_FAILED = 8444
-ERROR_DS_DRA_BAD_INSTANCE_TYPE = 8445
-ERROR_DS_DRA_OUT_OF_MEM = 8446
-ERROR_DS_DRA_MAIL_PROBLEM = 8447
-ERROR_DS_DRA_REF_ALREADY_EXISTS = 8448
-ERROR_DS_DRA_REF_NOT_FOUND = 8449
-ERROR_DS_DRA_OBJ_IS_REP_SOURCE = 8450
-ERROR_DS_DRA_DB_ERROR = 8451
-ERROR_DS_DRA_NO_REPLICA = 8452
-ERROR_DS_DRA_ACCESS_DENIED = 8453
-ERROR_DS_DRA_NOT_SUPPORTED = 8454
-ERROR_DS_DRA_RPC_CANCELLED = 8455
-ERROR_DS_DRA_SOURCE_DISABLED = 8456
-ERROR_DS_DRA_SINK_DISABLED = 8457
-ERROR_DS_DRA_NAME_COLLISION = 8458
-ERROR_DS_DRA_SOURCE_REINSTALLED = 8459
-ERROR_DS_DRA_MISSING_PARENT = 8460
-ERROR_DS_DRA_PREEMPTED = 8461
-ERROR_DS_DRA_ABANDON_SYNC = 8462
-ERROR_DS_DRA_SHUTDOWN = 8463
-ERROR_DS_DRA_INCOMPATIBLE_PARTIAL_SET = 8464
-ERROR_DS_DRA_SOURCE_IS_PARTIAL_REPLICA = 8465
-ERROR_DS_DRA_EXTN_CONNECTION_FAILED = 8466
-ERROR_DS_INSTALL_SCHEMA_MISMATCH = 8467
-ERROR_DS_DUP_LINK_ID = 8468
-ERROR_DS_NAME_ERROR_RESOLVING = 8469
-ERROR_DS_NAME_ERROR_NOT_FOUND = 8470
-ERROR_DS_NAME_ERROR_NOT_UNIQUE = 8471
-ERROR_DS_NAME_ERROR_NO_MAPPING = 8472
-ERROR_DS_NAME_ERROR_DOMAIN_ONLY = 8473
-ERROR_DS_NAME_ERROR_NO_SYNTACTICAL_MAPPING = 8474
-ERROR_DS_CONSTRUCTED_ATT_MOD = 8475
-ERROR_DS_WRONG_OM_OBJ_CLASS = 8476
-ERROR_DS_DRA_REPL_PENDING = 8477
-ERROR_DS_DS_REQUIRED = 8478
-ERROR_DS_INVALID_LDAP_DISPLAY_NAME = 8479
-ERROR_DS_NON_BASE_SEARCH = 8480
-ERROR_DS_CANT_RETRIEVE_ATTS = 8481
-ERROR_DS_BACKLINK_WITHOUT_LINK = 8482
-ERROR_DS_EPOCH_MISMATCH = 8483
-ERROR_DS_SRC_NAME_MISMATCH = 8484
-ERROR_DS_SRC_AND_DST_NC_IDENTICAL = 8485
-ERROR_DS_DST_NC_MISMATCH = 8486
-ERROR_DS_NOT_AUTHORITIVE_FOR_DST_NC = 8487
-ERROR_DS_SRC_GUID_MISMATCH = 8488
-ERROR_DS_CANT_MOVE_DELETED_OBJECT = 8489
-ERROR_DS_PDC_OPERATION_IN_PROGRESS = 8490
-ERROR_DS_CROSS_DOMAIN_CLEANUP_REQD = 8491
-ERROR_DS_ILLEGAL_XDOM_MOVE_OPERATION = 8492
-ERROR_DS_CANT_WITH_ACCT_GROUP_MEMBERSHPS = 8493
-ERROR_DS_NC_MUST_HAVE_NC_PARENT = 8494
-ERROR_DS_CR_IMPOSSIBLE_TO_VALIDATE = 8495
-ERROR_DS_DST_DOMAIN_NOT_NATIVE = 8496
-ERROR_DS_MISSING_INFRASTRUCTURE_CONTAINER = 8497
-ERROR_DS_CANT_MOVE_ACCOUNT_GROUP = 8498
-ERROR_DS_CANT_MOVE_RESOURCE_GROUP = 8499
-ERROR_DS_INVALID_SEARCH_FLAG = 8500
-ERROR_DS_NO_TREE_DELETE_ABOVE_NC = 8501
-ERROR_DS_COULDNT_LOCK_TREE_FOR_DELETE = 8502
-ERROR_DS_COULDNT_IDENTIFY_OBJECTS_FOR_TREE_DELETE = 8503
-ERROR_DS_SAM_INIT_FAILURE = 8504
-ERROR_DS_SENSITIVE_GROUP_VIOLATION = 8505
-ERROR_DS_CANT_MOD_PRIMARYGROUPID = 8506
-ERROR_DS_ILLEGAL_BASE_SCHEMA_MOD = 8507
-ERROR_DS_NONSAFE_SCHEMA_CHANGE = 8508
-ERROR_DS_SCHEMA_UPDATE_DISALLOWED = 8509
-ERROR_DS_CANT_CREATE_UNDER_SCHEMA = 8510
-ERROR_DS_INSTALL_NO_SRC_SCH_VERSION = 8511
-ERROR_DS_INSTALL_NO_SCH_VERSION_IN_INIFILE = 8512
-ERROR_DS_INVALID_GROUP_TYPE = 8513
-ERROR_DS_NO_NEST_GLOBALGROUP_IN_MIXEDDOMAIN = 8514
-ERROR_DS_NO_NEST_LOCALGROUP_IN_MIXEDDOMAIN = 8515
-ERROR_DS_GLOBAL_CANT_HAVE_LOCAL_MEMBER = 8516
-ERROR_DS_GLOBAL_CANT_HAVE_UNIVERSAL_MEMBER = 8517
-ERROR_DS_UNIVERSAL_CANT_HAVE_LOCAL_MEMBER = 8518
-ERROR_DS_GLOBAL_CANT_HAVE_CROSSDOMAIN_MEMBER = 8519
-ERROR_DS_LOCAL_CANT_HAVE_CROSSDOMAIN_LOCAL_MEMBER = 8520
-ERROR_DS_HAVE_PRIMARY_MEMBERS = 8521
-ERROR_DS_STRING_SD_CONVERSION_FAILED = 8522
-ERROR_DS_NAMING_MASTER_GC = 8523
-ERROR_DS_DNS_LOOKUP_FAILURE = 8524
-ERROR_DS_COULDNT_UPDATE_SPNS = 8525
-ERROR_DS_CANT_RETRIEVE_SD = 8526
-ERROR_DS_KEY_NOT_UNIQUE = 8527
-ERROR_DS_WRONG_LINKED_ATT_SYNTAX = 8528
-ERROR_DS_SAM_NEED_BOOTKEY_PASSWORD = 8529
-ERROR_DS_SAM_NEED_BOOTKEY_FLOPPY = 8530
-ERROR_DS_CANT_START = 8531
-ERROR_DS_INIT_FAILURE = 8532
-ERROR_DS_NO_PKT_PRIVACY_ON_CONNECTION = 8533
-ERROR_DS_SOURCE_DOMAIN_IN_FOREST = 8534
-ERROR_DS_DESTINATION_DOMAIN_NOT_IN_FOREST = 8535
-ERROR_DS_DESTINATION_AUDITING_NOT_ENABLED = 8536
-ERROR_DS_CANT_FIND_DC_FOR_SRC_DOMAIN = 8537
-ERROR_DS_SRC_OBJ_NOT_GROUP_OR_USER = 8538
-ERROR_DS_SRC_SID_EXISTS_IN_FOREST = 8539
-ERROR_DS_SRC_AND_DST_OBJECT_CLASS_MISMATCH = 8540
-ERROR_SAM_INIT_FAILURE = 8541
-ERROR_DS_DRA_SCHEMA_INFO_SHIP = 8542
-ERROR_DS_DRA_SCHEMA_CONFLICT = 8543
-ERROR_DS_DRA_EARLIER_SCHEMA_CONFLICT = 8544
-ERROR_DS_DRA_OBJ_NC_MISMATCH = 8545
-ERROR_DS_NC_STILL_HAS_DSAS = 8546
-ERROR_DS_GC_REQUIRED = 8547
-ERROR_DS_LOCAL_MEMBER_OF_LOCAL_ONLY = 8548
-ERROR_DS_NO_FPO_IN_UNIVERSAL_GROUPS = 8549
-ERROR_DS_CANT_ADD_TO_GC = 8550
-ERROR_DS_NO_CHECKPOINT_WITH_PDC = 8551
-ERROR_DS_SOURCE_AUDITING_NOT_ENABLED = 8552
-ERROR_DS_CANT_CREATE_IN_NONDOMAIN_NC = 8553
-ERROR_DS_INVALID_NAME_FOR_SPN = 8554
-ERROR_DS_FILTER_USES_CONTRUCTED_ATTRS = 8555
-ERROR_DS_UNICODEPWD_NOT_IN_QUOTES = 8556
-ERROR_DS_MACHINE_ACCOUNT_QUOTA_EXCEEDED = 8557
-ERROR_DS_MUST_BE_RUN_ON_DST_DC = 8558
-ERROR_DS_SRC_DC_MUST_BE_SP4_OR_GREATER = 8559
-ERROR_DS_CANT_TREE_DELETE_CRITICAL_OBJ = 8560
-ERROR_DS_INIT_FAILURE_CONSOLE = 8561
-ERROR_DS_SAM_INIT_FAILURE_CONSOLE = 8562
-ERROR_DS_FOREST_VERSION_TOO_HIGH = 8563
-ERROR_DS_DOMAIN_VERSION_TOO_HIGH = 8564
-ERROR_DS_FOREST_VERSION_TOO_LOW = 8565
-ERROR_DS_DOMAIN_VERSION_TOO_LOW = 8566
-ERROR_DS_INCOMPATIBLE_VERSION = 8567
-ERROR_DS_LOW_DSA_VERSION = 8568
-ERROR_DS_NO_BEHAVIOR_VERSION_IN_MIXEDDOMAIN = 8569
-ERROR_DS_NOT_SUPPORTED_SORT_ORDER = 8570
-ERROR_DS_NAME_NOT_UNIQUE = 8571
-ERROR_DS_MACHINE_ACCOUNT_CREATED_PRENT4 = 8572
-ERROR_DS_OUT_OF_VERSION_STORE = 8573
-ERROR_DS_INCOMPATIBLE_CONTROLS_USED = 8574
-ERROR_DS_NO_REF_DOMAIN = 8575
-ERROR_DS_RESERVED_LINK_ID = 8576
-ERROR_DS_LINK_ID_NOT_AVAILABLE = 8577
-ERROR_DS_AG_CANT_HAVE_UNIVERSAL_MEMBER = 8578
-ERROR_DS_MODIFYDN_DISALLOWED_BY_INSTANCE_TYPE = 8579
-ERROR_DS_NO_OBJECT_MOVE_IN_SCHEMA_NC = 8580
-ERROR_DS_MODIFYDN_DISALLOWED_BY_FLAG = 8581
-ERROR_DS_MODIFYDN_WRONG_GRANDPARENT = 8582
-ERROR_DS_NAME_ERROR_TRUST_REFERRAL = 8583
-ERROR_NOT_SUPPORTED_ON_STANDARD_SERVER = 8584
-ERROR_DS_CANT_ACCESS_REMOTE_PART_OF_AD = 8585
-ERROR_DS_CR_IMPOSSIBLE_TO_VALIDATE_V2 = 8586
-ERROR_DS_THREAD_LIMIT_EXCEEDED = 8587
-ERROR_DS_NOT_CLOSEST = 8588
-ERROR_DS_CANT_DERIVE_SPN_WITHOUT_SERVER_REF = 8589
-ERROR_DS_SINGLE_USER_MODE_FAILED = 8590
-ERROR_DS_NTDSCRIPT_SYNTAX_ERROR = 8591
-ERROR_DS_NTDSCRIPT_PROCESS_ERROR = 8592
-ERROR_DS_DIFFERENT_REPL_EPOCHS = 8593
-ERROR_DS_DRS_EXTENSIONS_CHANGED = 8594
-ERROR_DS_REPLICA_SET_CHANGE_NOT_ALLOWED_ON_DISABLED_CR = 8595
-ERROR_DS_NO_MSDS_INTID = 8596
-ERROR_DS_DUP_MSDS_INTID = 8597
-ERROR_DS_EXISTS_IN_RDNATTID = 8598
-ERROR_DS_AUTHORIZATION_FAILED = 8599
-ERROR_DS_INVALID_SCRIPT = 8600
-ERROR_DS_REMOTE_CROSSREF_OP_FAILED = 8601
-ERROR_DS_CROSS_REF_BUSY = 8602
-ERROR_DS_CANT_DERIVE_SPN_FOR_DELETED_DOMAIN = 8603
-ERROR_DS_CANT_DEMOTE_WITH_WRITEABLE_NC = 8604
-ERROR_DS_DUPLICATE_ID_FOUND = 8605
-ERROR_DS_INSUFFICIENT_ATTR_TO_CREATE_OBJECT = 8606
-ERROR_DS_GROUP_CONVERSION_ERROR = 8607
-ERROR_DS_CANT_MOVE_APP_BASIC_GROUP = 8608
-ERROR_DS_CANT_MOVE_APP_QUERY_GROUP = 8609
-ERROR_DS_ROLE_NOT_VERIFIED = 8610
-ERROR_DS_WKO_CONTAINER_CANNOT_BE_SPECIAL = 8611
-ERROR_DS_DOMAIN_RENAME_IN_PROGRESS = 8612
-ERROR_DS_EXISTING_AD_CHILD_NC = 8613
-ERROR_DS_REPL_LIFETIME_EXCEEDED = 8614
-ERROR_DS_DISALLOWED_IN_SYSTEM_CONTAINER = 8615
-ERROR_DS_LDAP_SEND_QUEUE_FULL = 8616
-ERROR_DS_DRA_OUT_SCHEDULE_WINDOW = 8617
-ERROR_DS_POLICY_NOT_KNOWN = 8618
-ERROR_NO_SITE_SETTINGS_OBJECT = 8619
-ERROR_NO_SECRETS = 8620
-ERROR_NO_WRITABLE_DC_FOUND = 8621
-ERROR_DS_NO_SERVER_OBJECT = 8622
-ERROR_DS_NO_NTDSA_OBJECT = 8623
-ERROR_DS_NON_ASQ_SEARCH = 8624
-ERROR_DS_AUDIT_FAILURE = 8625
-ERROR_DS_INVALID_SEARCH_FLAG_SUBTREE = 8626
-ERROR_DS_INVALID_SEARCH_FLAG_TUPLE = 8627
-ERROR_DS_HIERARCHY_TABLE_TOO_DEEP = 8628
-
-SEVERITY_SUCCESS = 0
-SEVERITY_ERROR = 1
-
-
-def HRESULT_FROM_WIN32(scode):
-    return -2147024896 | (scode & 65535)
-
-
-def SUCCEEDED(Status):
-    return (Status) >= 0
-
-
-def FAILED(Status):
-    return Status < 0
-
-
-def HRESULT_CODE(hr):
-    return (hr) & 65535
-
-
-def SCODE_CODE(sc):
-    return (sc) & 65535
-
-
-def HRESULT_FACILITY(hr):
-    return ((hr) >> 16) & 8191
-
-
-def SCODE_FACILITY(sc):
-    return ((sc) >> 16) & 8191
-
-
-def HRESULT_SEVERITY(hr):
-    return ((hr) >> 31) & 1
-
-
-def SCODE_SEVERITY(sc):
-    return ((sc) >> 31) & 1
-
-
-FACILITY_NT_BIT = 268435456
-
-
-def HRESULT_FROM_NT(x):
-    return x | FACILITY_NT_BIT
-
-
-def GetScode(hr):
-    return hr
-
-
-def ResultFromScode(sc):
-    return sc
-
-
-NOERROR = 0
-E_UNEXPECTED = -2147418113
-E_NOTIMPL = -2147467263
-E_OUTOFMEMORY = -2147024882
-E_INVALIDARG = -2147024809
-E_NOINTERFACE = -2147467262
-E_POINTER = -2147467261
-E_HANDLE = -2147024890
-E_ABORT = -2147467260
-E_FAIL = -2147467259
-E_ACCESSDENIED = -2147024891
-win16_E_NOTIMPL = -2147483647
-win16_E_OUTOFMEMORY = -2147483646
-win16_E_INVALIDARG = -2147483645
-win16_E_NOINTERFACE = -2147483644
-win16_E_POINTER = -2147483643
-win16_E_HANDLE = -2147483642
-win16_E_ABORT = -2147483641
-win16_E_FAIL = -2147483640
-win16_E_ACCESSDENIED = -2147483639
-E_PENDING = -2147483638
-CO_E_INIT_TLS = -2147467258
-CO_E_INIT_SHARED_ALLOCATOR = -2147467257
-CO_E_INIT_MEMORY_ALLOCATOR = -2147467256
-CO_E_INIT_CLASS_CACHE = -2147467255
-CO_E_INIT_RPC_CHANNEL = -2147467254
-CO_E_INIT_TLS_SET_CHANNEL_CONTROL = -2147467253
-CO_E_INIT_TLS_CHANNEL_CONTROL = -2147467252
-CO_E_INIT_UNACCEPTED_USER_ALLOCATOR = -2147467251
-CO_E_INIT_SCM_MUTEX_EXISTS = -2147467250
-CO_E_INIT_SCM_FILE_MAPPING_EXISTS = -2147467249
-CO_E_INIT_SCM_MAP_VIEW_OF_FILE = -2147467248
-CO_E_INIT_SCM_EXEC_FAILURE = -2147467247
-CO_E_INIT_ONLY_SINGLE_THREADED = -2147467246
-CO_E_CANT_REMOTE = -2147467245
-CO_E_BAD_SERVER_NAME = -2147467244
-CO_E_WRONG_SERVER_IDENTITY = -2147467243
-CO_E_OLE1DDE_DISABLED = -2147467242
-CO_E_RUNAS_SYNTAX = -2147467241
-CO_E_CREATEPROCESS_FAILURE = -2147467240
-CO_E_RUNAS_CREATEPROCESS_FAILURE = -2147467239
-CO_E_RUNAS_LOGON_FAILURE = -2147467238
-CO_E_LAUNCH_PERMSSION_DENIED = -2147467237
-CO_E_START_SERVICE_FAILURE = -2147467236
-CO_E_REMOTE_COMMUNICATION_FAILURE = -2147467235
-CO_E_SERVER_START_TIMEOUT = -2147467234
-CO_E_CLSREG_INCONSISTENT = -2147467233
-CO_E_IIDREG_INCONSISTENT = -2147467232
-CO_E_NOT_SUPPORTED = -2147467231
-CO_E_RELOAD_DLL = -2147467230
-CO_E_MSI_ERROR = -2147467229
-
-OLE_E_FIRST = -2147221504
-OLE_E_LAST = -2147221249
-OLE_S_FIRST = 262144
-OLE_S_LAST = 262399
-
-OLE_E_OLEVERB = -2147221504
-OLE_E_ADVF = -2147221503
-OLE_E_ENUM_NOMORE = -2147221502
-OLE_E_ADVISENOTSUPPORTED = -2147221501
-OLE_E_NOCONNECTION = -2147221500
-OLE_E_NOTRUNNING = -2147221499
-OLE_E_NOCACHE = -2147221498
-OLE_E_BLANK = -2147221497
-OLE_E_CLASSDIFF = -2147221496
-OLE_E_CANT_GETMONIKER = -2147221495
-OLE_E_CANT_BINDTOSOURCE = -2147221494
-OLE_E_STATIC = -2147221493
-OLE_E_PROMPTSAVECANCELLED = -2147221492
-OLE_E_INVALIDRECT = -2147221491
-OLE_E_WRONGCOMPOBJ = -2147221490
-OLE_E_INVALIDHWND = -2147221489
-OLE_E_NOT_INPLACEACTIVE = -2147221488
-OLE_E_CANTCONVERT = -2147221487
-OLE_E_NOSTORAGE = -2147221486
-DV_E_FORMATETC = -2147221404
-DV_E_DVTARGETDEVICE = -2147221403
-DV_E_STGMEDIUM = -2147221402
-DV_E_STATDATA = -2147221401
-DV_E_LINDEX = -2147221400
-DV_E_TYMED = -2147221399
-DV_E_CLIPFORMAT = -2147221398
-DV_E_DVASPECT = -2147221397
-DV_E_DVTARGETDEVICE_SIZE = -2147221396
-DV_E_NOIVIEWOBJECT = -2147221395
-DRAGDROP_E_FIRST = -2147221248
-DRAGDROP_E_LAST = -2147221233
-DRAGDROP_S_FIRST = 262400
-DRAGDROP_S_LAST = 262415
-DRAGDROP_E_NOTREGISTERED = -2147221248
-DRAGDROP_E_ALREADYREGISTERED = -2147221247
-DRAGDROP_E_INVALIDHWND = -2147221246
-CLASSFACTORY_E_FIRST = -2147221232
-CLASSFACTORY_E_LAST = -2147221217
-CLASSFACTORY_S_FIRST = 262416
-CLASSFACTORY_S_LAST = 262431
-CLASS_E_NOAGGREGATION = -2147221232
-CLASS_E_CLASSNOTAVAILABLE = -2147221231
-CLASS_E_NOTLICENSED = -2147221230
-MARSHAL_E_FIRST = -2147221216
-MARSHAL_E_LAST = -2147221201
-MARSHAL_S_FIRST = 262432
-MARSHAL_S_LAST = 262447
-DATA_E_FIRST = -2147221200
-DATA_E_LAST = -2147221185
-DATA_S_FIRST = 262448
-DATA_S_LAST = 262463
-VIEW_E_FIRST = -2147221184
-VIEW_E_LAST = -2147221169
-VIEW_S_FIRST = 262464
-VIEW_S_LAST = 262479
-VIEW_E_DRAW = -2147221184
-REGDB_E_FIRST = -2147221168
-REGDB_E_LAST = -2147221153
-REGDB_S_FIRST = 262480
-REGDB_S_LAST = 262495
-REGDB_E_READREGDB = -2147221168
-REGDB_E_WRITEREGDB = -2147221167
-REGDB_E_KEYMISSING = -2147221166
-REGDB_E_INVALIDVALUE = -2147221165
-REGDB_E_CLASSNOTREG = -2147221164
-REGDB_E_IIDNOTREG = -2147221163
-CAT_E_FIRST = -2147221152
-CAT_E_LAST = -2147221151
-CAT_E_CATIDNOEXIST = -2147221152
-CAT_E_NODESCRIPTION = -2147221151
-CS_E_FIRST = -2147221148
-CS_E_LAST = -2147221144
-CS_E_PACKAGE_NOTFOUND = -2147221148
-CS_E_NOT_DELETABLE = -2147221147
-CS_E_CLASS_NOTFOUND = -2147221146
-CS_E_INVALID_VERSION = -2147221145
-CS_E_NO_CLASSSTORE = -2147221144
-CACHE_E_FIRST = -2147221136
-CACHE_E_LAST = -2147221121
-CACHE_S_FIRST = 262512
-CACHE_S_LAST = 262527
-CACHE_E_NOCACHE_UPDATED = -2147221136
-OLEOBJ_E_FIRST = -2147221120
-OLEOBJ_E_LAST = -2147221105
-OLEOBJ_S_FIRST = 262528
-OLEOBJ_S_LAST = 262543
-OLEOBJ_E_NOVERBS = -2147221120
-OLEOBJ_E_INVALIDVERB = -2147221119
-CLIENTSITE_E_FIRST = -2147221104
-CLIENTSITE_E_LAST = -2147221089
-CLIENTSITE_S_FIRST = 262544
-CLIENTSITE_S_LAST = 262559
-INPLACE_E_NOTUNDOABLE = -2147221088
-INPLACE_E_NOTOOLSPACE = -2147221087
-INPLACE_E_FIRST = -2147221088
-INPLACE_E_LAST = -2147221073
-INPLACE_S_FIRST = 262560
-INPLACE_S_LAST = 262575
-ENUM_E_FIRST = -2147221072
-ENUM_E_LAST = -2147221057
-ENUM_S_FIRST = 262576
-ENUM_S_LAST = 262591
-CONVERT10_E_FIRST = -2147221056
-CONVERT10_E_LAST = -2147221041
-CONVERT10_S_FIRST = 262592
-CONVERT10_S_LAST = 262607
-CONVERT10_E_OLESTREAM_GET = -2147221056
-CONVERT10_E_OLESTREAM_PUT = -2147221055
-CONVERT10_E_OLESTREAM_FMT = -2147221054
-CONVERT10_E_OLESTREAM_BITMAP_TO_DIB = -2147221053
-CONVERT10_E_STG_FMT = -2147221052
-CONVERT10_E_STG_NO_STD_STREAM = -2147221051
-CONVERT10_E_STG_DIB_TO_BITMAP = -2147221050
-CLIPBRD_E_FIRST = -2147221040
-CLIPBRD_E_LAST = -2147221025
-CLIPBRD_S_FIRST = 262608
-CLIPBRD_S_LAST = 262623
-CLIPBRD_E_CANT_OPEN = -2147221040
-CLIPBRD_E_CANT_EMPTY = -2147221039
-CLIPBRD_E_CANT_SET = -2147221038
-CLIPBRD_E_BAD_DATA = -2147221037
-CLIPBRD_E_CANT_CLOSE = -2147221036
-MK_E_FIRST = -2147221024
-MK_E_LAST = -2147221009
-MK_S_FIRST = 262624
-MK_S_LAST = 262639
-MK_E_CONNECTMANUALLY = -2147221024
-MK_E_EXCEEDEDDEADLINE = -2147221023
-MK_E_NEEDGENERIC = -2147221022
-MK_E_UNAVAILABLE = -2147221021
-MK_E_SYNTAX = -2147221020
-MK_E_NOOBJECT = -2147221019
-MK_E_INVALIDEXTENSION = -2147221018
-MK_E_INTERMEDIATEINTERFACENOTSUPPORTED = -2147221017
-MK_E_NOTBINDABLE = -2147221016
-MK_E_NOTBOUND = -2147221015
-MK_E_CANTOPENFILE = -2147221014
-MK_E_MUSTBOTHERUSER = -2147221013
-MK_E_NOINVERSE = -2147221012
-MK_E_NOSTORAGE = -2147221011
-MK_E_NOPREFIX = -2147221010
-MK_E_ENUMERATION_FAILED = -2147221009
-CO_E_FIRST = -2147221008
-CO_E_LAST = -2147220993
-CO_S_FIRST = 262640
-CO_S_LAST = 262655
-CO_E_NOTINITIALIZED = -2147221008
-CO_E_ALREADYINITIALIZED = -2147221007
-CO_E_CANTDETERMINECLASS = -2147221006
-CO_E_CLASSSTRING = -2147221005
-CO_E_IIDSTRING = -2147221004
-CO_E_APPNOTFOUND = -2147221003
-CO_E_APPSINGLEUSE = -2147221002
-CO_E_ERRORINAPP = -2147221001
-CO_E_DLLNOTFOUND = -2147221000
-CO_E_ERRORINDLL = -2147220999
-CO_E_WRONGOSFORAPP = -2147220998
-CO_E_OBJNOTREG = -2147220997
-CO_E_OBJISREG = -2147220996
-CO_E_OBJNOTCONNECTED = -2147220995
-CO_E_APPDIDNTREG = -2147220994
-CO_E_RELEASED = -2147220993
-CO_E_FAILEDTOIMPERSONATE = -2147220992
-CO_E_FAILEDTOGETSECCTX = -2147220991
-CO_E_FAILEDTOOPENTHREADTOKEN = -2147220990
-CO_E_FAILEDTOGETTOKENINFO = -2147220989
-CO_E_TRUSTEEDOESNTMATCHCLIENT = -2147220988
-CO_E_FAILEDTOQUERYCLIENTBLANKET = -2147220987
-CO_E_FAILEDTOSETDACL = -2147220986
-CO_E_ACCESSCHECKFAILED = -2147220985
-CO_E_NETACCESSAPIFAILED = -2147220984
-CO_E_WRONGTRUSTEENAMESYNTAX = -2147220983
-CO_E_INVALIDSID = -2147220982
-CO_E_CONVERSIONFAILED = -2147220981
-CO_E_NOMATCHINGSIDFOUND = -2147220980
-CO_E_LOOKUPACCSIDFAILED = -2147220979
-CO_E_NOMATCHINGNAMEFOUND = -2147220978
-CO_E_LOOKUPACCNAMEFAILED = -2147220977
-CO_E_SETSERLHNDLFAILED = -2147220976
-CO_E_FAILEDTOGETWINDIR = -2147220975
-CO_E_PATHTOOLONG = -2147220974
-CO_E_FAILEDTOGENUUID = -2147220973
-CO_E_FAILEDTOCREATEFILE = -2147220972
-CO_E_FAILEDTOCLOSEHANDLE = -2147220971
-CO_E_EXCEEDSYSACLLIMIT = -2147220970
-CO_E_ACESINWRONGORDER = -2147220969
-CO_E_INCOMPATIBLESTREAMVERSION = -2147220968
-CO_E_FAILEDTOOPENPROCESSTOKEN = -2147220967
-CO_E_DECODEFAILED = -2147220966
-CO_E_ACNOTINITIALIZED = -2147220965
-OLE_S_USEREG = 262144
-OLE_S_STATIC = 262145
-OLE_S_MAC_CLIPFORMAT = 262146
-DRAGDROP_S_DROP = 262400
-DRAGDROP_S_CANCEL = 262401
-DRAGDROP_S_USEDEFAULTCURSORS = 262402
-DATA_S_SAMEFORMATETC = 262448
-VIEW_S_ALREADY_FROZEN = 262464
-CACHE_S_FORMATETC_NOTSUPPORTED = 262512
-CACHE_S_SAMECACHE = 262513
-CACHE_S_SOMECACHES_NOTUPDATED = 262514
-OLEOBJ_S_INVALIDVERB = 262528
-OLEOBJ_S_CANNOT_DOVERB_NOW = 262529
-OLEOBJ_S_INVALIDHWND = 262530
-INPLACE_S_TRUNCATED = 262560
-CONVERT10_S_NO_PRESENTATION = 262592
-MK_S_REDUCED_TO_SELF = 262626
-MK_S_ME = 262628
-MK_S_HIM = 262629
-MK_S_US = 262630
-MK_S_MONIKERALREADYREGISTERED = 262631
-CO_E_CLASS_CREATE_FAILED = -2146959359
-CO_E_SCM_ERROR = -2146959358
-CO_E_SCM_RPC_FAILURE = -2146959357
-CO_E_BAD_PATH = -2146959356
-CO_E_SERVER_EXEC_FAILURE = -2146959355
-CO_E_OBJSRV_RPC_FAILURE = -2146959354
-MK_E_NO_NORMALIZED = -2146959353
-CO_E_SERVER_STOPPING = -2146959352
-MEM_E_INVALID_ROOT = -2146959351
-MEM_E_INVALID_LINK = -2146959344
-MEM_E_INVALID_SIZE = -2146959343
-CO_S_NOTALLINTERFACES = 524306
-DISP_E_UNKNOWNINTERFACE = -2147352575
-DISP_E_MEMBERNOTFOUND = -2147352573
-DISP_E_PARAMNOTFOUND = -2147352572
-DISP_E_TYPEMISMATCH = -2147352571
-DISP_E_UNKNOWNNAME = -2147352570
-DISP_E_NONAMEDARGS = -2147352569
-DISP_E_BADVARTYPE = -2147352568
-DISP_E_EXCEPTION = -2147352567
-DISP_E_OVERFLOW = -2147352566
-DISP_E_BADINDEX = -2147352565
-DISP_E_UNKNOWNLCID = -2147352564
-DISP_E_ARRAYISLOCKED = -2147352563
-DISP_E_BADPARAMCOUNT = -2147352562
-DISP_E_PARAMNOTOPTIONAL = -2147352561
-DISP_E_BADCALLEE = -2147352560
-DISP_E_NOTACOLLECTION = -2147352559
-DISP_E_DIVBYZERO = -2147352558
-TYPE_E_BUFFERTOOSMALL = -2147319786
-TYPE_E_FIELDNOTFOUND = -2147319785
-TYPE_E_INVDATAREAD = -2147319784
-TYPE_E_UNSUPFORMAT = -2147319783
-TYPE_E_REGISTRYACCESS = -2147319780
-TYPE_E_LIBNOTREGISTERED = -2147319779
-TYPE_E_UNDEFINEDTYPE = -2147319769
-TYPE_E_QUALIFIEDNAMEDISALLOWED = -2147319768
-TYPE_E_INVALIDSTATE = -2147319767
-TYPE_E_WRONGTYPEKIND = -2147319766
-TYPE_E_ELEMENTNOTFOUND = -2147319765
-TYPE_E_AMBIGUOUSNAME = -2147319764
-TYPE_E_NAMECONFLICT = -2147319763
-TYPE_E_UNKNOWNLCID = -2147319762
-TYPE_E_DLLFUNCTIONNOTFOUND = -2147319761
-TYPE_E_BADMODULEKIND = -2147317571
-TYPE_E_SIZETOOBIG = -2147317563
-TYPE_E_DUPLICATEID = -2147317562
-TYPE_E_INVALIDID = -2147317553
-TYPE_E_TYPEMISMATCH = -2147316576
-TYPE_E_OUTOFBOUNDS = -2147316575
-TYPE_E_IOERROR = -2147316574
-TYPE_E_CANTCREATETMPFILE = -2147316573
-TYPE_E_CANTLOADLIBRARY = -2147312566
-TYPE_E_INCONSISTENTPROPFUNCS = -2147312509
-TYPE_E_CIRCULARTYPE = -2147312508
-STG_E_INVALIDFUNCTION = -2147287039
-STG_E_FILENOTFOUND = -2147287038
-STG_E_PATHNOTFOUND = -2147287037
-STG_E_TOOMANYOPENFILES = -2147287036
-STG_E_ACCESSDENIED = -2147287035
-STG_E_INVALIDHANDLE = -2147287034
-STG_E_INSUFFICIENTMEMORY = -2147287032
-STG_E_INVALIDPOINTER = -2147287031
-STG_E_NOMOREFILES = -2147287022
-STG_E_DISKISWRITEPROTECTED = -2147287021
-STG_E_SEEKERROR = -2147287015
-STG_E_WRITEFAULT = -2147287011
-STG_E_READFAULT = -2147287010
-STG_E_SHAREVIOLATION = -2147287008
-STG_E_LOCKVIOLATION = -2147287007
-STG_E_FILEALREADYEXISTS = -2147286960
-STG_E_INVALIDPARAMETER = -2147286953
-STG_E_MEDIUMFULL = -2147286928
-STG_E_PROPSETMISMATCHED = -2147286800
-STG_E_ABNORMALAPIEXIT = -2147286790
-STG_E_INVALIDHEADER = -2147286789
-STG_E_INVALIDNAME = -2147286788
-STG_E_UNKNOWN = -2147286787
-STG_E_UNIMPLEMENTEDFUNCTION = -2147286786
-STG_E_INVALIDFLAG = -2147286785
-STG_E_INUSE = -2147286784
-STG_E_NOTCURRENT = -2147286783
-STG_E_REVERTED = -2147286782
-STG_E_CANTSAVE = -2147286781
-STG_E_OLDFORMAT = -2147286780
-STG_E_OLDDLL = -2147286779
-STG_E_SHAREREQUIRED = -2147286778
-STG_E_NOTFILEBASEDSTORAGE = -2147286777
-STG_E_EXTANTMARSHALLINGS = -2147286776
-STG_E_DOCFILECORRUPT = -2147286775
-STG_E_BADBASEADDRESS = -2147286768
-STG_E_INCOMPLETE = -2147286527
-STG_E_TERMINATED = -2147286526
-STG_S_CONVERTED = 197120
-STG_S_BLOCK = 197121
-STG_S_RETRYNOW = 197122
-STG_S_MONITORING = 197123
-STG_S_MULTIPLEOPENS = 197124
-STG_S_CONSOLIDATIONFAILED = 197125
-STG_S_CANNOTCONSOLIDATE = 197126
-RPC_E_CALL_REJECTED = -2147418111
-RPC_E_CALL_CANCELED = -2147418110
-RPC_E_CANTPOST_INSENDCALL = -2147418109
-RPC_E_CANTCALLOUT_INASYNCCALL = -2147418108
-RPC_E_CANTCALLOUT_INEXTERNALCALL = -2147418107
-RPC_E_CONNECTION_TERMINATED = -2147418106
-RPC_E_SERVER_DIED = -2147418105
-RPC_E_CLIENT_DIED = -2147418104
-RPC_E_INVALID_DATAPACKET = -2147418103
-RPC_E_CANTTRANSMIT_CALL = -2147418102
-RPC_E_CLIENT_CANTMARSHAL_DATA = -2147418101
-RPC_E_CLIENT_CANTUNMARSHAL_DATA = -2147418100
-RPC_E_SERVER_CANTMARSHAL_DATA = -2147418099
-RPC_E_SERVER_CANTUNMARSHAL_DATA = -2147418098
-RPC_E_INVALID_DATA = -2147418097
-RPC_E_INVALID_PARAMETER = -2147418096
-RPC_E_CANTCALLOUT_AGAIN = -2147418095
-RPC_E_SERVER_DIED_DNE = -2147418094
-RPC_E_SYS_CALL_FAILED = -2147417856
-RPC_E_OUT_OF_RESOURCES = -2147417855
-RPC_E_ATTEMPTED_MULTITHREAD = -2147417854
-RPC_E_NOT_REGISTERED = -2147417853
-RPC_E_FAULT = -2147417852
-RPC_E_SERVERFAULT = -2147417851
-RPC_E_CHANGED_MODE = -2147417850
-RPC_E_INVALIDMETHOD = -2147417849
-RPC_E_DISCONNECTED = -2147417848
-RPC_E_RETRY = -2147417847
-RPC_E_SERVERCALL_RETRYLATER = -2147417846
-RPC_E_SERVERCALL_REJECTED = -2147417845
-RPC_E_INVALID_CALLDATA = -2147417844
-RPC_E_CANTCALLOUT_ININPUTSYNCCALL = -2147417843
-RPC_E_WRONG_THREAD = -2147417842
-RPC_E_THREAD_NOT_INIT = -2147417841
-RPC_E_VERSION_MISMATCH = -2147417840
-RPC_E_INVALID_HEADER = -2147417839
-RPC_E_INVALID_EXTENSION = -2147417838
-RPC_E_INVALID_IPID = -2147417837
-RPC_E_INVALID_OBJECT = -2147417836
-RPC_S_CALLPENDING = -2147417835
-RPC_S_WAITONTIMER = -2147417834
-RPC_E_CALL_COMPLETE = -2147417833
-RPC_E_UNSECURE_CALL = -2147417832
-RPC_E_TOO_LATE = -2147417831
-RPC_E_NO_GOOD_SECURITY_PACKAGES = -2147417830
-RPC_E_ACCESS_DENIED = -2147417829
-RPC_E_REMOTE_DISABLED = -2147417828
-RPC_E_INVALID_OBJREF = -2147417827
-RPC_E_NO_CONTEXT = -2147417826
-RPC_E_TIMEOUT = -2147417825
-RPC_E_NO_SYNC = -2147417824
-RPC_E_UNEXPECTED = -2147352577
-NTE_BAD_UID = -2146893823
-NTE_BAD_HASH = -2146893822
-NTE_BAD_KEY = -2146893821
-NTE_BAD_LEN = -2146893820
-NTE_BAD_DATA = -2146893819
-NTE_BAD_SIGNATURE = -2146893818
-NTE_BAD_VER = -2146893817
-NTE_BAD_ALGID = -2146893816
-NTE_BAD_FLAGS = -2146893815
-NTE_BAD_TYPE = -2146893814
-NTE_BAD_KEY_STATE = -2146893813
-NTE_BAD_HASH_STATE = -2146893812
-NTE_NO_KEY = -2146893811
-NTE_NO_MEMORY = -2146893810
-NTE_EXISTS = -2146893809
-NTE_PERM = -2146893808
-NTE_NOT_FOUND = -2146893807
-NTE_DOUBLE_ENCRYPT = -2146893806
-NTE_BAD_PROVIDER = -2146893805
-NTE_BAD_PROV_TYPE = -2146893804
-NTE_BAD_PUBLIC_KEY = -2146893803
-NTE_BAD_KEYSET = -2146893802
-NTE_PROV_TYPE_NOT_DEF = -2146893801
-NTE_PROV_TYPE_ENTRY_BAD = -2146893800
-NTE_KEYSET_NOT_DEF = -2146893799
-NTE_KEYSET_ENTRY_BAD = -2146893798
-NTE_PROV_TYPE_NO_MATCH = -2146893797
-NTE_SIGNATURE_FILE_BAD = -2146893796
-NTE_PROVIDER_DLL_FAIL = -2146893795
-NTE_PROV_DLL_NOT_FOUND = -2146893794
-NTE_BAD_KEYSET_PARAM = -2146893793
-NTE_FAIL = -2146893792
-NTE_SYS_ERR = -2146893791
-CRYPT_E_MSG_ERROR = -2146889727
-CRYPT_E_UNKNOWN_ALGO = -2146889726
-CRYPT_E_OID_FORMAT = -2146889725
-CRYPT_E_INVALID_MSG_TYPE = -2146889724
-CRYPT_E_UNEXPECTED_ENCODING = -2146889723
-CRYPT_E_AUTH_ATTR_MISSING = -2146889722
-CRYPT_E_HASH_VALUE = -2146889721
-CRYPT_E_INVALID_INDEX = -2146889720
-CRYPT_E_ALREADY_DECRYPTED = -2146889719
-CRYPT_E_NOT_DECRYPTED = -2146889718
-CRYPT_E_RECIPIENT_NOT_FOUND = -2146889717
-CRYPT_E_CONTROL_TYPE = -2146889716
-CRYPT_E_ISSUER_SERIALNUMBER = -2146889715
-CRYPT_E_SIGNER_NOT_FOUND = -2146889714
-CRYPT_E_ATTRIBUTES_MISSING = -2146889713
-CRYPT_E_STREAM_MSG_NOT_READY = -2146889712
-CRYPT_E_STREAM_INSUFFICIENT_DATA = -2146889711
-CRYPT_E_BAD_LEN = -2146885631
-CRYPT_E_BAD_ENCODE = -2146885630
-CRYPT_E_FILE_ERROR = -2146885629
-CRYPT_E_NOT_FOUND = -2146885628
-CRYPT_E_EXISTS = -2146885627
-CRYPT_E_NO_PROVIDER = -2146885626
-CRYPT_E_SELF_SIGNED = -2146885625
-CRYPT_E_DELETED_PREV = -2146885624
-CRYPT_E_NO_MATCH = -2146885623
-CRYPT_E_UNEXPECTED_MSG_TYPE = -2146885622
-CRYPT_E_NO_KEY_PROPERTY = -2146885621
-CRYPT_E_NO_DECRYPT_CERT = -2146885620
-CRYPT_E_BAD_MSG = -2146885619
-CRYPT_E_NO_SIGNER = -2146885618
-CRYPT_E_PENDING_CLOSE = -2146885617
-CRYPT_E_REVOKED = -2146885616
-CRYPT_E_NO_REVOCATION_DLL = -2146885615
-CRYPT_E_NO_REVOCATION_CHECK = -2146885614
-CRYPT_E_REVOCATION_OFFLINE = -2146885613
-CRYPT_E_NOT_IN_REVOCATION_DATABASE = -2146885612
-CRYPT_E_INVALID_NUMERIC_STRING = -2146885600
-CRYPT_E_INVALID_PRINTABLE_STRING = -2146885599
-CRYPT_E_INVALID_IA5_STRING = -2146885598
-CRYPT_E_INVALID_X500_STRING = -2146885597
-CRYPT_E_NOT_CHAR_STRING = -2146885596
-CRYPT_E_FILERESIZED = -2146885595
-CRYPT_E_SECURITY_SETTINGS = -2146885594
-CRYPT_E_NO_VERIFY_USAGE_DLL = -2146885593
-CRYPT_E_NO_VERIFY_USAGE_CHECK = -2146885592
-CRYPT_E_VERIFY_USAGE_OFFLINE = -2146885591
-CRYPT_E_NOT_IN_CTL = -2146885590
-CRYPT_E_NO_TRUSTED_SIGNER = -2146885589
-CRYPT_E_OSS_ERROR = -2146881536
-CERTSRV_E_BAD_REQUESTSUBJECT = -2146877439
-CERTSRV_E_NO_REQUEST = -2146877438
-CERTSRV_E_BAD_REQUESTSTATUS = -2146877437
-CERTSRV_E_PROPERTY_EMPTY = -2146877436
-CERTDB_E_JET_ERROR = -2146873344
-TRUST_E_SYSTEM_ERROR = -2146869247
-TRUST_E_NO_SIGNER_CERT = -2146869246
-TRUST_E_COUNTER_SIGNER = -2146869245
-TRUST_E_CERT_SIGNATURE = -2146869244
-TRUST_E_TIME_STAMP = -2146869243
-TRUST_E_BAD_DIGEST = -2146869232
-TRUST_E_BASIC_CONSTRAINTS = -2146869223
-TRUST_E_FINANCIAL_CRITERIA = -2146869218
-NTE_OP_OK = 0
-TRUST_E_PROVIDER_UNKNOWN = -2146762751
-TRUST_E_ACTION_UNKNOWN = -2146762750
-TRUST_E_SUBJECT_FORM_UNKNOWN = -2146762749
-TRUST_E_SUBJECT_NOT_TRUSTED = -2146762748
-DIGSIG_E_ENCODE = -2146762747
-DIGSIG_E_DECODE = -2146762746
-DIGSIG_E_EXTENSIBILITY = -2146762745
-DIGSIG_E_CRYPTO = -2146762744
-PERSIST_E_SIZEDEFINITE = -2146762743
-PERSIST_E_SIZEINDEFINITE = -2146762742
-PERSIST_E_NOTSELFSIZING = -2146762741
-TRUST_E_NOSIGNATURE = -2146762496
-CERT_E_EXPIRED = -2146762495
-CERT_E_VALIDITYPERIODNESTING = -2146762494
-CERT_E_ROLE = -2146762493
-CERT_E_PATHLENCONST = -2146762492
-CERT_E_CRITICAL = -2146762491
-CERT_E_PURPOSE = -2146762490
-CERT_E_ISSUERCHAINING = -2146762489
-CERT_E_MALFORMED = -2146762488
-CERT_E_UNTRUSTEDROOT = -2146762487
-CERT_E_CHAINING = -2146762486
-TRUST_E_FAIL = -2146762485
-CERT_E_REVOKED = -2146762484
-CERT_E_UNTRUSTEDTESTROOT = -2146762483
-CERT_E_REVOCATION_FAILURE = -2146762482
-CERT_E_CN_NO_MATCH = -2146762481
-CERT_E_WRONG_USAGE = -2146762480
-SPAPI_E_EXPECTED_SECTION_NAME = -2146500608
-SPAPI_E_BAD_SECTION_NAME_LINE = -2146500607
-SPAPI_E_SECTION_NAME_TOO_LONG = -2146500606
-SPAPI_E_GENERAL_SYNTAX = -2146500605
-SPAPI_E_WRONG_INF_STYLE = -2146500352
-SPAPI_E_SECTION_NOT_FOUND = -2146500351
-SPAPI_E_LINE_NOT_FOUND = -2146500350
-SPAPI_E_NO_ASSOCIATED_CLASS = -2146500096
-SPAPI_E_CLASS_MISMATCH = -2146500095
-SPAPI_E_DUPLICATE_FOUND = -2146500094
-SPAPI_E_NO_DRIVER_SELECTED = -2146500093
-SPAPI_E_KEY_DOES_NOT_EXIST = -2146500092
-SPAPI_E_INVALID_DEVINST_NAME = -2146500091
-SPAPI_E_INVALID_CLASS = -2146500090
-SPAPI_E_DEVINST_ALREADY_EXISTS = -2146500089
-SPAPI_E_DEVINFO_NOT_REGISTERED = -2146500088
-SPAPI_E_INVALID_REG_PROPERTY = -2146500087
-SPAPI_E_NO_INF = -2146500086
-SPAPI_E_NO_SUCH_DEVINST = -2146500085
-SPAPI_E_CANT_LOAD_CLASS_ICON = -2146500084
-SPAPI_E_INVALID_CLASS_INSTALLER = -2146500083
-SPAPI_E_DI_DO_DEFAULT = -2146500082
-SPAPI_E_DI_NOFILECOPY = -2146500081
-SPAPI_E_INVALID_HWPROFILE = -2146500080
-SPAPI_E_NO_DEVICE_SELECTED = -2146500079
-SPAPI_E_DEVINFO_LIST_LOCKED = -2146500078
-SPAPI_E_DEVINFO_DATA_LOCKED = -2146500077
-SPAPI_E_DI_BAD_PATH = -2146500076
-SPAPI_E_NO_CLASSINSTALL_PARAMS = -2146500075
-SPAPI_E_FILEQUEUE_LOCKED = -2146500074
-SPAPI_E_BAD_SERVICE_INSTALLSECT = -2146500073
-SPAPI_E_NO_CLASS_DRIVER_LIST = -2146500072
-SPAPI_E_NO_ASSOCIATED_SERVICE = -2146500071
-SPAPI_E_NO_DEFAULT_DEVICE_INTERFACE = -2146500070
-SPAPI_E_DEVICE_INTERFACE_ACTIVE = -2146500069
-SPAPI_E_DEVICE_INTERFACE_REMOVED = -2146500068
-SPAPI_E_BAD_INTERFACE_INSTALLSECT = -2146500067
-SPAPI_E_NO_SUCH_INTERFACE_CLASS = -2146500066
-SPAPI_E_INVALID_REFERENCE_STRING = -2146500065
-SPAPI_E_INVALID_MACHINENAME = -2146500064
-SPAPI_E_REMOTE_COMM_FAILURE = -2146500063
-SPAPI_E_MACHINE_UNAVAILABLE = -2146500062
-SPAPI_E_NO_CONFIGMGR_SERVICES = -2146500061
-SPAPI_E_INVALID_PROPPAGE_PROVIDER = -2146500060
-SPAPI_E_NO_SUCH_DEVICE_INTERFACE = -2146500059
-SPAPI_E_DI_POSTPROCESSING_REQUIRED = -2146500058
-SPAPI_E_INVALID_COINSTALLER = -2146500057
-SPAPI_E_NO_COMPAT_DRIVERS = -2146500056
-SPAPI_E_NO_DEVICE_ICON = -2146500055
-SPAPI_E_INVALID_INF_LOGCONFIG = -2146500054
-SPAPI_E_DI_DONT_INSTALL = -2146500053
-SPAPI_E_INVALID_FILTER_DRIVER = -2146500052
-SPAPI_E_ERROR_NOT_INSTALLED = -2146496512
-
-# Directory storage
-ERROR_DS_NOT_INSTALLED = 8200
-ERROR_DS_MEMBERSHIP_EVALUATED_LOCALLY = 8201
-ERROR_DS_NO_ATTRIBUTE_OR_VALUE = 8202
-ERROR_DS_INVALID_ATTRIBUTE_SYNTAX = 8203
-ERROR_DS_ATTRIBUTE_TYPE_UNDEFINED = 8204
-ERROR_DS_ATTRIBUTE_OR_VALUE_EXISTS = 8205
-ERROR_DS_BUSY = 8206
-ERROR_DS_UNAVAILABLE = 8207
-ERROR_DS_NO_RIDS_ALLOCATED = 8208
-ERROR_DS_NO_MORE_RIDS = 8209
-ERROR_DS_INCORRECT_ROLE_OWNER = 8210
-ERROR_DS_RIDMGR_INIT_ERROR = 8211
-ERROR_DS_OBJ_CLASS_VIOLATION = 8212
-ERROR_DS_CANT_ON_NON_LEAF = 8213
-ERROR_DS_CANT_ON_RDN = 8214
-ERROR_DS_CANT_MOD_OBJ_CLASS = 8215
-ERROR_DS_CROSS_DOM_MOVE_ERROR = 8216
-ERROR_DS_GC_NOT_AVAILABLE = 8217
-ERROR_SHARED_POLICY = 8218
-ERROR_POLICY_OBJECT_NOT_FOUND = 8219
-ERROR_POLICY_ONLY_IN_DS = 8220
-ERROR_PROMOTION_ACTIVE = 8221
-ERROR_NO_PROMOTION_ACTIVE = 8222
-ERROR_DS_OPERATIONS_ERROR = 8224
-ERROR_DS_PROTOCOL_ERROR = 8225
-ERROR_DS_TIMELIMIT_EXCEEDED = 8226
-ERROR_DS_SIZELIMIT_EXCEEDED = 8227
-ERROR_DS_ADMIN_LIMIT_EXCEEDED = 8228
-ERROR_DS_COMPARE_FALSE = 8229
-ERROR_DS_COMPARE_TRUE = 8230
-ERROR_DS_AUTH_METHOD_NOT_SUPPORTED = 8231
-ERROR_DS_STRONG_AUTH_REQUIRED = 8232
-ERROR_DS_INAPPROPRIATE_AUTH = 8233
-ERROR_DS_AUTH_UNKNOWN = 8234
-ERROR_DS_REFERRAL = 8235
-ERROR_DS_UNAVAILABLE_CRIT_EXTENSION = 8236
-ERROR_DS_CONFIDENTIALITY_REQUIRED = 8237
-ERROR_DS_INAPPROPRIATE_MATCHING = 8238
-ERROR_DS_CONSTRAINT_VIOLATION = 8239
-ERROR_DS_NO_SUCH_OBJECT = 8240
-ERROR_DS_ALIAS_PROBLEM = 8241
-ERROR_DS_INVALID_DN_SYNTAX = 8242
-ERROR_DS_IS_LEAF = 8243
-ERROR_DS_ALIAS_DEREF_PROBLEM = 8244
-ERROR_DS_UNWILLING_TO_PERFORM = 8245
-ERROR_DS_LOOP_DETECT = 8246
-ERROR_DS_NAMING_VIOLATION = 8247
-ERROR_DS_OBJECT_RESULTS_TOO_LARGE = 8248
-ERROR_DS_AFFECTS_MULTIPLE_DSAS = 8249
-ERROR_DS_SERVER_DOWN = 8250
-ERROR_DS_LOCAL_ERROR = 8251
-ERROR_DS_ENCODING_ERROR = 8252
-ERROR_DS_DECODING_ERROR = 8253
-ERROR_DS_FILTER_UNKNOWN = 8254
-ERROR_DS_PARAM_ERROR = 8255
-ERROR_DS_NOT_SUPPORTED = 8256
-ERROR_DS_NO_RESULTS_RETURNED = 8257
-ERROR_DS_CONTROL_NOT_FOUND = 8258
-ERROR_DS_CLIENT_LOOP = 8259
-ERROR_DS_REFERRAL_LIMIT_EXCEEDED = 8260
-ERROR_DS_SORT_CONTROL_MISSING = 8261
-ERROR_DS_OFFSET_RANGE_ERROR = 8262
-ERROR_DS_ROOT_MUST_BE_NC = 8301
-ERROR_DS_ADD_REPLICA_INHIBITED = 8302
-ERROR_DS_ATT_NOT_DEF_IN_SCHEMA = 8303
-ERROR_DS_MAX_OBJ_SIZE_EXCEEDED = 8304
-ERROR_DS_OBJ_STRING_NAME_EXISTS = 8305
-ERROR_DS_NO_RDN_DEFINED_IN_SCHEMA = 8306
-ERROR_DS_RDN_DOESNT_MATCH_SCHEMA = 8307
-ERROR_DS_NO_REQUESTED_ATTS_FOUND = 8308
-ERROR_DS_USER_BUFFER_TO_SMALL = 8309
-ERROR_DS_ATT_IS_NOT_ON_OBJ = 8310
-ERROR_DS_ILLEGAL_MOD_OPERATION = 8311
-ERROR_DS_OBJ_TOO_LARGE = 8312
-ERROR_DS_BAD_INSTANCE_TYPE = 8313
-ERROR_DS_MASTERDSA_REQUIRED = 8314
-ERROR_DS_OBJECT_CLASS_REQUIRED = 8315
-ERROR_DS_MISSING_REQUIRED_ATT = 8316
-ERROR_DS_ATT_NOT_DEF_FOR_CLASS = 8317
-ERROR_DS_ATT_ALREADY_EXISTS = 8318
-ERROR_DS_CANT_ADD_ATT_VALUES = 8320
-ERROR_DS_SINGLE_VALUE_CONSTRAINT = 8321
-ERROR_DS_RANGE_CONSTRAINT = 8322
-ERROR_DS_ATT_VAL_ALREADY_EXISTS = 8323
-ERROR_DS_CANT_REM_MISSING_ATT = 8324
-ERROR_DS_CANT_REM_MISSING_ATT_VAL = 8325
-ERROR_DS_ROOT_CANT_BE_SUBREF = 8326
-ERROR_DS_NO_CHAINING = 8327
-ERROR_DS_NO_CHAINED_EVAL = 8328
-ERROR_DS_NO_PARENT_OBJECT = 8329
-ERROR_DS_PARENT_IS_AN_ALIAS = 8330
-ERROR_DS_CANT_MIX_MASTER_AND_REPS = 8331
-ERROR_DS_CHILDREN_EXIST = 8332
-ERROR_DS_OBJ_NOT_FOUND = 8333
-ERROR_DS_ALIASED_OBJ_MISSING = 8334
-ERROR_DS_BAD_NAME_SYNTAX = 8335
-ERROR_DS_ALIAS_POINTS_TO_ALIAS = 8336
-ERROR_DS_CANT_DEREF_ALIAS = 8337
-ERROR_DS_OUT_OF_SCOPE = 8338
-ERROR_DS_OBJECT_BEING_REMOVED = 8339
-ERROR_DS_CANT_DELETE_DSA_OBJ = 8340
-ERROR_DS_GENERIC_ERROR = 8341
-ERROR_DS_DSA_MUST_BE_INT_MASTER = 8342
-ERROR_DS_CLASS_NOT_DSA = 8343
-ERROR_DS_INSUFF_ACCESS_RIGHTS = 8344
-ERROR_DS_ILLEGAL_SUPERIOR = 8345
-ERROR_DS_ATTRIBUTE_OWNED_BY_SAM = 8346
-ERROR_DS_NAME_TOO_MANY_PARTS = 8347
-ERROR_DS_NAME_TOO_LONG = 8348
-ERROR_DS_NAME_VALUE_TOO_LONG = 8349
-ERROR_DS_NAME_UNPARSEABLE = 8350
-ERROR_DS_NAME_TYPE_UNKNOWN = 8351
-ERROR_DS_NOT_AN_OBJECT = 8352
-ERROR_DS_SEC_DESC_TOO_SHORT = 8353
-ERROR_DS_SEC_DESC_INVALID = 8354
-ERROR_DS_NO_DELETED_NAME = 8355
-ERROR_DS_SUBREF_MUST_HAVE_PARENT = 8356
-ERROR_DS_NCNAME_MUST_BE_NC = 8357
-ERROR_DS_CANT_ADD_SYSTEM_ONLY = 8358
-ERROR_DS_CLASS_MUST_BE_CONCRETE = 8359
-ERROR_DS_INVALID_DMD = 8360
-ERROR_DS_OBJ_GUID_EXISTS = 8361
-ERROR_DS_NOT_ON_BACKLINK = 8362
-ERROR_DS_NO_CROSSREF_FOR_NC = 8363
-ERROR_DS_SHUTTING_DOWN = 8364
-ERROR_DS_UNKNOWN_OPERATION = 8365
-ERROR_DS_INVALID_ROLE_OWNER = 8366
-ERROR_DS_COULDNT_CONTACT_FSMO = 8367
-ERROR_DS_CROSS_NC_DN_RENAME = 8368
-ERROR_DS_CANT_MOD_SYSTEM_ONLY = 8369
-ERROR_DS_REPLICATOR_ONLY = 8370
-ERROR_DS_OBJ_CLASS_NOT_DEFINED = 8371
-ERROR_DS_OBJ_CLASS_NOT_SUBCLASS = 8372
-ERROR_DS_NAME_REFERENCE_INVALID = 8373
-ERROR_DS_CROSS_REF_EXISTS = 8374
-ERROR_DS_CANT_DEL_MASTER_CROSSREF = 8375
-ERROR_DS_SUBTREE_NOTIFY_NOT_NC_HEAD = 8376
-ERROR_DS_NOTIFY_FILTER_TOO_COMPLEX = 8377
-ERROR_DS_DUP_RDN = 8378
-ERROR_DS_DUP_OID = 8379
-ERROR_DS_DUP_MAPI_ID = 8380
-ERROR_DS_DUP_SCHEMA_ID_GUID = 8381
-ERROR_DS_DUP_LDAP_DISPLAY_NAME = 8382
-ERROR_DS_SEMANTIC_ATT_TEST = 8383
-ERROR_DS_SYNTAX_MISMATCH = 8384
-ERROR_DS_EXISTS_IN_MUST_HAVE = 8385
-ERROR_DS_EXISTS_IN_MAY_HAVE = 8386
-ERROR_DS_NONEXISTENT_MAY_HAVE = 8387
-ERROR_DS_NONEXISTENT_MUST_HAVE = 8388
-ERROR_DS_AUX_CLS_TEST_FAIL = 8389
-ERROR_DS_NONEXISTENT_POSS_SUP = 8390
-ERROR_DS_SUB_CLS_TEST_FAIL = 8391
-ERROR_DS_BAD_RDN_ATT_ID_SYNTAX = 8392
-ERROR_DS_EXISTS_IN_AUX_CLS = 8393
-ERROR_DS_EXISTS_IN_SUB_CLS = 8394
-ERROR_DS_EXISTS_IN_POSS_SUP = 8395
-ERROR_DS_RECALCSCHEMA_FAILED = 8396
-ERROR_DS_TREE_DELETE_NOT_FINISHED = 8397
-ERROR_DS_CANT_DELETE = 8398
-ERROR_DS_ATT_SCHEMA_REQ_ID = 8399
-ERROR_DS_BAD_ATT_SCHEMA_SYNTAX = 8400
-ERROR_DS_CANT_CACHE_ATT = 8401
-ERROR_DS_CANT_CACHE_CLASS = 8402
-ERROR_DS_CANT_REMOVE_ATT_CACHE = 8403
-ERROR_DS_CANT_REMOVE_CLASS_CACHE = 8404
-ERROR_DS_CANT_RETRIEVE_DN = 8405
-ERROR_DS_MISSING_SUPREF = 8406
-ERROR_DS_CANT_RETRIEVE_INSTANCE = 8407
-ERROR_DS_CODE_INCONSISTENCY = 8408
-ERROR_DS_DATABASE_ERROR = 8409
-ERROR_DS_GOVERNSID_MISSING = 8410
-ERROR_DS_MISSING_EXPECTED_ATT = 8411
-ERROR_DS_NCNAME_MISSING_CR_REF = 8412
-ERROR_DS_SECURITY_CHECKING_ERROR = 8413
-ERROR_DS_SCHEMA_NOT_LOADED = 8414
-ERROR_DS_SCHEMA_ALLOC_FAILED = 8415
-ERROR_DS_ATT_SCHEMA_REQ_SYNTAX = 8416
-ERROR_DS_GCVERIFY_ERROR = 8417
-ERROR_DS_DRA_SCHEMA_MISMATCH = 8418
-ERROR_DS_CANT_FIND_DSA_OBJ = 8419
-ERROR_DS_CANT_FIND_EXPECTED_NC = 8420
-ERROR_DS_CANT_FIND_NC_IN_CACHE = 8421
-ERROR_DS_CANT_RETRIEVE_CHILD = 8422
-ERROR_DS_SECURITY_ILLEGAL_MODIFY = 8423
-ERROR_DS_CANT_REPLACE_HIDDEN_REC = 8424
-ERROR_DS_BAD_HIERARCHY_FILE = 8425
-ERROR_DS_BUILD_HIERARCHY_TABLE_FAILED = 8426
-ERROR_DS_CONFIG_PARAM_MISSING = 8427
-ERROR_DS_COUNTING_AB_INDICES_FAILED = 8428
-ERROR_DS_HIERARCHY_TABLE_MALLOC_FAILED = 8429
-ERROR_DS_INTERNAL_FAILURE = 8430
-ERROR_DS_UNKNOWN_ERROR = 8431
-ERROR_DS_ROOT_REQUIRES_CLASS_TOP = 8432
-ERROR_DS_REFUSING_FSMO_ROLES = 8433
-ERROR_DS_MISSING_FSMO_SETTINGS = 8434
-ERROR_DS_UNABLE_TO_SURRENDER_ROLES = 8435
-ERROR_DS_DRA_GENERIC = 8436
-ERROR_DS_DRA_INVALID_PARAMETER = 8437
-ERROR_DS_DRA_BUSY = 8438
-ERROR_DS_DRA_BAD_DN = 8439
-ERROR_DS_DRA_BAD_NC = 8440
-ERROR_DS_DRA_DN_EXISTS = 8441
-ERROR_DS_DRA_INTERNAL_ERROR = 8442
-ERROR_DS_DRA_INCONSISTENT_DIT = 8443
-ERROR_DS_DRA_CONNECTION_FAILED = 8444
-ERROR_DS_DRA_BAD_INSTANCE_TYPE = 8445
-ERROR_DS_DRA_OUT_OF_MEM = 8446
-ERROR_DS_DRA_MAIL_PROBLEM = 8447
-ERROR_DS_DRA_REF_ALREADY_EXISTS = 8448
-ERROR_DS_DRA_REF_NOT_FOUND = 8449
-ERROR_DS_DRA_OBJ_IS_REP_SOURCE = 8450
-ERROR_DS_DRA_DB_ERROR = 8451
-ERROR_DS_DRA_NO_REPLICA = 8452
-ERROR_DS_DRA_ACCESS_DENIED = 8453
-ERROR_DS_DRA_NOT_SUPPORTED = 8454
-ERROR_DS_DRA_RPC_CANCELLED = 8455
-ERROR_DS_DRA_SOURCE_DISABLED = 8456
-ERROR_DS_DRA_SINK_DISABLED = 8457
-ERROR_DS_DRA_NAME_COLLISION = 8458
-ERROR_DS_DRA_SOURCE_REINSTALLED = 8459
-ERROR_DS_DRA_MISSING_PARENT = 8460
-ERROR_DS_DRA_PREEMPTED = 8461
-ERROR_DS_DRA_ABANDON_SYNC = 8462
-ERROR_DS_DRA_SHUTDOWN = 8463
-ERROR_DS_DRA_INCOMPATIBLE_PARTIAL_SET = 8464
-ERROR_DS_DRA_SOURCE_IS_PARTIAL_REPLICA = 8465
-ERROR_DS_DRA_EXTN_CONNECTION_FAILED = 8466
-ERROR_DS_INSTALL_SCHEMA_MISMATCH = 8467
-ERROR_DS_DUP_LINK_ID = 8468
-ERROR_DS_NAME_ERROR_RESOLVING = 8469
-ERROR_DS_NAME_ERROR_NOT_FOUND = 8470
-ERROR_DS_NAME_ERROR_NOT_UNIQUE = 8471
-ERROR_DS_NAME_ERROR_NO_MAPPING = 8472
-ERROR_DS_NAME_ERROR_DOMAIN_ONLY = 8473
-ERROR_DS_NAME_ERROR_NO_SYNTACTICAL_MAPPING = 8474
-ERROR_DS_CONSTRUCTED_ATT_MOD = 8475
-ERROR_DS_WRONG_OM_OBJ_CLASS = 8476
-ERROR_DS_DRA_REPL_PENDING = 8477
-ERROR_DS_DS_REQUIRED = 8478
-ERROR_DS_INVALID_LDAP_DISPLAY_NAME = 8479
-ERROR_DS_NON_BASE_SEARCH = 8480
-ERROR_DS_CANT_RETRIEVE_ATTS = 8481
-ERROR_DS_BACKLINK_WITHOUT_LINK = 8482
-ERROR_DS_EPOCH_MISMATCH = 8483
-ERROR_DS_SRC_NAME_MISMATCH = 8484
-ERROR_DS_SRC_AND_DST_NC_IDENTICAL = 8485
-ERROR_DS_DST_NC_MISMATCH = 8486
-ERROR_DS_NOT_AUTHORITIVE_FOR_DST_NC = 8487
-ERROR_DS_SRC_GUID_MISMATCH = 8488
-ERROR_DS_CANT_MOVE_DELETED_OBJECT = 8489
-ERROR_DS_PDC_OPERATION_IN_PROGRESS = 8490
-ERROR_DS_CROSS_DOMAIN_CLEANUP_REQD = 8491
-ERROR_DS_ILLEGAL_XDOM_MOVE_OPERATION = 8492
-ERROR_DS_CANT_WITH_ACCT_GROUP_MEMBERSHPS = 8493
-ERROR_DS_NC_MUST_HAVE_NC_PARENT = 8494
-ERROR_DS_CR_IMPOSSIBLE_TO_VALIDATE = 8495
-ERROR_DS_DST_DOMAIN_NOT_NATIVE = 8496
-ERROR_DS_MISSING_INFRASTRUCTURE_CONTAINER = 8497
-ERROR_DS_CANT_MOVE_ACCOUNT_GROUP = 8498
-ERROR_DS_CANT_MOVE_RESOURCE_GROUP = 8499
-ERROR_DS_INVALID_SEARCH_FLAG = 8500
-ERROR_DS_NO_TREE_DELETE_ABOVE_NC = 8501
-ERROR_DS_COULDNT_LOCK_TREE_FOR_DELETE = 8502
-ERROR_DS_COULDNT_IDENTIFY_OBJECTS_FOR_TREE_DELETE = 8503
-ERROR_DS_SAM_INIT_FAILURE = 8504
-ERROR_DS_SENSITIVE_GROUP_VIOLATION = 8505
-ERROR_DS_CANT_MOD_PRIMARYGROUPID = 8506
-ERROR_DS_ILLEGAL_BASE_SCHEMA_MOD = 8507
-ERROR_DS_NONSAFE_SCHEMA_CHANGE = 8508
-ERROR_DS_SCHEMA_UPDATE_DISALLOWED = 8509
-ERROR_DS_CANT_CREATE_UNDER_SCHEMA = 8510
-ERROR_DS_INSTALL_NO_SRC_SCH_VERSION = 8511
-ERROR_DS_INSTALL_NO_SCH_VERSION_IN_INIFILE = 8512
-ERROR_DS_INVALID_GROUP_TYPE = 8513
-ERROR_DS_NO_NEST_GLOBALGROUP_IN_MIXEDDOMAIN = 8514
-ERROR_DS_NO_NEST_LOCALGROUP_IN_MIXEDDOMAIN = 8515
-ERROR_DS_GLOBAL_CANT_HAVE_LOCAL_MEMBER = 8516
-ERROR_DS_GLOBAL_CANT_HAVE_UNIVERSAL_MEMBER = 8517
-ERROR_DS_UNIVERSAL_CANT_HAVE_LOCAL_MEMBER = 8518
-ERROR_DS_GLOBAL_CANT_HAVE_CROSSDOMAIN_MEMBER = 8519
-ERROR_DS_LOCAL_CANT_HAVE_CROSSDOMAIN_LOCAL_MEMBER = 8520
-ERROR_DS_HAVE_PRIMARY_MEMBERS = 8521
-ERROR_DS_STRING_SD_CONVERSION_FAILED = 8522
-ERROR_DS_NAMING_MASTER_GC = 8523
-ERROR_DS_DNS_LOOKUP_FAILURE = 8524
-ERROR_DS_COULDNT_UPDATE_SPNS = 8525
-ERROR_DS_CANT_RETRIEVE_SD = 8526
-ERROR_DS_KEY_NOT_UNIQUE = 8527
-ERROR_DS_WRONG_LINKED_ATT_SYNTAX = 8528
-ERROR_DS_SAM_NEED_BOOTKEY_PASSWORD = 8529
-ERROR_DS_SAM_NEED_BOOTKEY_FLOPPY = 8530
-ERROR_DS_CANT_START = 8531
-ERROR_DS_INIT_FAILURE = 8532
-ERROR_DS_NO_PKT_PRIVACY_ON_CONNECTION = 8533
-ERROR_DS_SOURCE_DOMAIN_IN_FOREST = 8534
-ERROR_DS_DESTINATION_DOMAIN_NOT_IN_FOREST = 8535
-ERROR_DS_DESTINATION_AUDITING_NOT_ENABLED = 8536
-ERROR_DS_CANT_FIND_DC_FOR_SRC_DOMAIN = 8537
-ERROR_DS_SRC_OBJ_NOT_GROUP_OR_USER = 8538
-ERROR_DS_SRC_SID_EXISTS_IN_FOREST = 8539
-ERROR_DS_SRC_AND_DST_OBJECT_CLASS_MISMATCH = 8540
-ERROR_SAM_INIT_FAILURE = 8541
-ERROR_DS_DRA_SCHEMA_INFO_SHIP = 8542
-ERROR_DS_DRA_SCHEMA_CONFLICT = 8543
-ERROR_DS_DRA_EARLIER_SCHEMA_CONFLICT = 8544
-ERROR_DS_DRA_OBJ_NC_MISMATCH = 8545
-ERROR_DS_NC_STILL_HAS_DSAS = 8546
-ERROR_DS_GC_REQUIRED = 8547
-ERROR_DS_LOCAL_MEMBER_OF_LOCAL_ONLY = 8548
-ERROR_DS_NO_FPO_IN_UNIVERSAL_GROUPS = 8549
-ERROR_DS_CANT_ADD_TO_GC = 8550
-ERROR_DS_NO_CHECKPOINT_WITH_PDC = 8551
-ERROR_DS_SOURCE_AUDITING_NOT_ENABLED = 8552
-ERROR_DS_CANT_CREATE_IN_NONDOMAIN_NC = 8553
-ERROR_DS_INVALID_NAME_FOR_SPN = 8554
-ERROR_DS_FILTER_USES_CONTRUCTED_ATTRS = 8555
-ERROR_DS_UNICODEPWD_NOT_IN_QUOTES = 8556
-ERROR_DS_MACHINE_ACCOUNT_QUOTA_EXCEEDED = 8557
-ERROR_DS_MUST_BE_RUN_ON_DST_DC = 8558
-ERROR_DS_SRC_DC_MUST_BE_SP4_OR_GREATER = 8559
-ERROR_DS_CANT_TREE_DELETE_CRITICAL_OBJ = 8560
-ERROR_DS_INIT_FAILURE_CONSOLE = 8561
-ERROR_DS_SAM_INIT_FAILURE_CONSOLE = 8562
-ERROR_DS_FOREST_VERSION_TOO_HIGH = 8563
-ERROR_DS_DOMAIN_VERSION_TOO_HIGH = 8564
-ERROR_DS_FOREST_VERSION_TOO_LOW = 8565
-ERROR_DS_DOMAIN_VERSION_TOO_LOW = 8566
-ERROR_DS_INCOMPATIBLE_VERSION = 8567
-ERROR_DS_LOW_DSA_VERSION = 8568
-ERROR_DS_NO_BEHAVIOR_VERSION_IN_MIXEDDOMAIN = 8569
-ERROR_DS_NOT_SUPPORTED_SORT_ORDER = 8570
-ERROR_DS_NAME_NOT_UNIQUE = 8571
-ERROR_DS_MACHINE_ACCOUNT_CREATED_PRENT4 = 8572
-ERROR_DS_OUT_OF_VERSION_STORE = 8573
-ERROR_DS_INCOMPATIBLE_CONTROLS_USED = 8574
-ERROR_DS_NO_REF_DOMAIN = 8575
-ERROR_DS_RESERVED_LINK_ID = 8576
-ERROR_DS_LINK_ID_NOT_AVAILABLE = 8577
-ERROR_DS_AG_CANT_HAVE_UNIVERSAL_MEMBER = 8578
-ERROR_DS_MODIFYDN_DISALLOWED_BY_INSTANCE_TYPE = 8579
-ERROR_DS_NO_OBJECT_MOVE_IN_SCHEMA_NC = 8580
-ERROR_DS_MODIFYDN_DISALLOWED_BY_FLAG = 8581
-ERROR_DS_MODIFYDN_WRONG_GRANDPARENT = 8582
-ERROR_DS_NAME_ERROR_TRUST_REFERRAL = 8583
-ERROR_NOT_SUPPORTED_ON_STANDARD_SERVER = 8584
-ERROR_DS_CANT_ACCESS_REMOTE_PART_OF_AD = 8585
-ERROR_DS_CR_IMPOSSIBLE_TO_VALIDATE_V2 = 8586
-ERROR_DS_THREAD_LIMIT_EXCEEDED = 8587
-ERROR_DS_NOT_CLOSEST = 8588
-ERROR_DS_CANT_DERIVE_SPN_WITHOUT_SERVER_REF = 8589
-ERROR_DS_SINGLE_USER_MODE_FAILED = 8590
-ERROR_DS_NTDSCRIPT_SYNTAX_ERROR = 8591
-ERROR_DS_NTDSCRIPT_PROCESS_ERROR = 8592
-ERROR_DS_DIFFERENT_REPL_EPOCHS = 8593
-ERROR_DS_DRS_EXTENSIONS_CHANGED = 8594
-ERROR_DS_REPLICA_SET_CHANGE_NOT_ALLOWED_ON_DISABLED_CR = 8595
-ERROR_DS_NO_MSDS_INTID = 8596
-ERROR_DS_DUP_MSDS_INTID = 8597
-ERROR_DS_EXISTS_IN_RDNATTID = 8598
-ERROR_DS_AUTHORIZATION_FAILED = 8599
-ERROR_DS_INVALID_SCRIPT = 8600
-ERROR_DS_REMOTE_CROSSREF_OP_FAILED = 8601
-ERROR_DS_CROSS_REF_BUSY = 8602
-ERROR_DS_CANT_DERIVE_SPN_FOR_DELETED_DOMAIN = 8603
-ERROR_DS_CANT_DEMOTE_WITH_WRITEABLE_NC = 8604
-ERROR_DS_DUPLICATE_ID_FOUND = 8605
-ERROR_DS_INSUFFICIENT_ATTR_TO_CREATE_OBJECT = 8606
-ERROR_DS_GROUP_CONVERSION_ERROR = 8607
-ERROR_DS_CANT_MOVE_APP_BASIC_GROUP = 8608
-ERROR_DS_CANT_MOVE_APP_QUERY_GROUP = 8609
-ERROR_DS_ROLE_NOT_VERIFIED = 8610
-ERROR_DS_WKO_CONTAINER_CANNOT_BE_SPECIAL = 8611
-ERROR_DS_DOMAIN_RENAME_IN_PROGRESS = 8612
-ERROR_DS_EXISTING_AD_CHILD_NC = 8613
-ERROR_DS_REPL_LIFETIME_EXCEEDED = 8614
-ERROR_DS_DISALLOWED_IN_SYSTEM_CONTAINER = 8615
-ERROR_DS_LDAP_SEND_QUEUE_FULL = 8616
-ERROR_DS_DRA_OUT_SCHEDULE_WINDOW = 8617
-
-# Common dialog box error codes from cderr.h
-CDERR_DIALOGFAILURE = 65535
-CDERR_GENERALCODES = 0
-CDERR_STRUCTSIZE = 1
-CDERR_INITIALIZATION = 2
-CDERR_NOTEMPLATE = 3
-CDERR_NOHINSTANCE = 4
-CDERR_LOADSTRFAILURE = 5
-CDERR_FINDRESFAILURE = 6
-CDERR_LOADRESFAILURE = 7
-CDERR_LOCKRESFAILURE = 8
-CDERR_MEMALLOCFAILURE = 9
-CDERR_MEMLOCKFAILURE = 10
-CDERR_NOHOOK = 11
-CDERR_REGISTERMSGFAIL = 12
-PDERR_PRINTERCODES = 4096
-PDERR_SETUPFAILURE = 4097
-PDERR_PARSEFAILURE = 4098
-PDERR_RETDEFFAILURE = 4099
-PDERR_LOADDRVFAILURE = 4100
-PDERR_GETDEVMODEFAIL = 4101
-PDERR_INITFAILURE = 4102
-PDERR_NODEVICES = 4103
-PDERR_NODEFAULTPRN = 4104
-PDERR_DNDMMISMATCH = 4105
-PDERR_CREATEICFAILURE = 4106
-PDERR_PRINTERNOTFOUND = 4107
-PDERR_DEFAULTDIFFERENT = 4108
-CFERR_CHOOSEFONTCODES = 8192
-CFERR_NOFONTS = 8193
-CFERR_MAXLESSTHANMIN = 8194
-FNERR_FILENAMECODES = 12288
-FNERR_SUBCLASSFAILURE = 12289
-FNERR_INVALIDFILENAME = 12290
-FNERR_BUFFERTOOSMALL = 12291
-FRERR_FINDREPLACECODES = 16384
-FRERR_BUFFERLENGTHZERO = 16385
-CCERR_CHOOSECOLORCODES = 20480
diff --git a/lib/win32/lib/winioctlcon.py b/lib/win32/lib/winioctlcon.py
deleted file mode 100644
index 5c555947..00000000
--- a/lib/win32/lib/winioctlcon.py
+++ /dev/null
@@ -1,1079 +0,0 @@
-## flags, enums, guids used with DeviceIoControl from WinIoCtl.h
-
-import pywintypes
-from ntsecuritycon import FILE_READ_DATA, FILE_WRITE_DATA
-
-
-def CTL_CODE(DeviceType, Function, Method, Access):
-    return (DeviceType << 16) | (Access << 14) | (Function << 2) | Method
-
-
-def DEVICE_TYPE_FROM_CTL_CODE(ctrlCode):
-    return (ctrlCode & 0xFFFF0000) >> 16
-
-
-FILE_DEVICE_BEEP = 0x00000001
-FILE_DEVICE_CD_ROM = 0x00000002
-FILE_DEVICE_CD_ROM_FILE_SYSTEM = 0x00000003
-FILE_DEVICE_CONTROLLER = 0x00000004
-FILE_DEVICE_DATALINK = 0x00000005
-FILE_DEVICE_DFS = 0x00000006
-FILE_DEVICE_DISK = 0x00000007
-FILE_DEVICE_DISK_FILE_SYSTEM = 0x00000008
-FILE_DEVICE_FILE_SYSTEM = 0x00000009
-FILE_DEVICE_INPORT_PORT = 0x0000000A
-FILE_DEVICE_KEYBOARD = 0x0000000B
-FILE_DEVICE_MAILSLOT = 0x0000000C
-FILE_DEVICE_MIDI_IN = 0x0000000D
-FILE_DEVICE_MIDI_OUT = 0x0000000E
-FILE_DEVICE_MOUSE = 0x0000000F
-FILE_DEVICE_MULTI_UNC_PROVIDER = 0x00000010
-FILE_DEVICE_NAMED_PIPE = 0x00000011
-FILE_DEVICE_NETWORK = 0x00000012
-FILE_DEVICE_NETWORK_BROWSER = 0x00000013
-FILE_DEVICE_NETWORK_FILE_SYSTEM = 0x00000014
-FILE_DEVICE_NULL = 0x00000015
-FILE_DEVICE_PARALLEL_PORT = 0x00000016
-FILE_DEVICE_PHYSICAL_NETCARD = 0x00000017
-FILE_DEVICE_PRINTER = 0x00000018
-FILE_DEVICE_SCANNER = 0x00000019
-FILE_DEVICE_SERIAL_MOUSE_PORT = 0x0000001A
-FILE_DEVICE_SERIAL_PORT = 0x0000001B
-FILE_DEVICE_SCREEN = 0x0000001C
-FILE_DEVICE_SOUND = 0x0000001D
-FILE_DEVICE_STREAMS = 0x0000001E
-FILE_DEVICE_TAPE = 0x0000001F
-FILE_DEVICE_TAPE_FILE_SYSTEM = 0x00000020
-FILE_DEVICE_TRANSPORT = 0x00000021
-FILE_DEVICE_UNKNOWN = 0x00000022
-FILE_DEVICE_VIDEO = 0x00000023
-FILE_DEVICE_VIRTUAL_DISK = 0x00000024
-FILE_DEVICE_WAVE_IN = 0x00000025
-FILE_DEVICE_WAVE_OUT = 0x00000026
-FILE_DEVICE_8042_PORT = 0x00000027
-FILE_DEVICE_NETWORK_REDIRECTOR = 0x00000028
-FILE_DEVICE_BATTERY = 0x00000029
-FILE_DEVICE_BUS_EXTENDER = 0x0000002A
-FILE_DEVICE_MODEM = 0x0000002B
-FILE_DEVICE_VDM = 0x0000002C
-FILE_DEVICE_MASS_STORAGE = 0x0000002D
-FILE_DEVICE_SMB = 0x0000002E
-FILE_DEVICE_KS = 0x0000002F
-FILE_DEVICE_CHANGER = 0x00000030
-FILE_DEVICE_SMARTCARD = 0x00000031
-FILE_DEVICE_ACPI = 0x00000032
-FILE_DEVICE_DVD = 0x00000033
-FILE_DEVICE_FULLSCREEN_VIDEO = 0x00000034
-FILE_DEVICE_DFS_FILE_SYSTEM = 0x00000035
-FILE_DEVICE_DFS_VOLUME = 0x00000036
-FILE_DEVICE_SERENUM = 0x00000037
-FILE_DEVICE_TERMSRV = 0x00000038
-FILE_DEVICE_KSEC = 0x00000039
-FILE_DEVICE_FIPS = 0x0000003A
-FILE_DEVICE_INFINIBAND = 0x0000003B
-
-METHOD_BUFFERED = 0
-METHOD_IN_DIRECT = 1
-METHOD_OUT_DIRECT = 2
-METHOD_NEITHER = 3
-METHOD_DIRECT_TO_HARDWARE = METHOD_IN_DIRECT
-METHOD_DIRECT_FROM_HARDWARE = METHOD_OUT_DIRECT
-FILE_ANY_ACCESS = 0
-FILE_SPECIAL_ACCESS = FILE_ANY_ACCESS
-FILE_READ_ACCESS = 0x0001
-FILE_WRITE_ACCESS = 0x0002
-IOCTL_STORAGE_BASE = FILE_DEVICE_MASS_STORAGE
-RECOVERED_WRITES_VALID = 0x00000001
-UNRECOVERED_WRITES_VALID = 0x00000002
-RECOVERED_READS_VALID = 0x00000004
-UNRECOVERED_READS_VALID = 0x00000008
-WRITE_COMPRESSION_INFO_VALID = 0x00000010
-READ_COMPRESSION_INFO_VALID = 0x00000020
-TAPE_RETURN_STATISTICS = 0
-TAPE_RETURN_ENV_INFO = 1
-TAPE_RESET_STATISTICS = 2
-MEDIA_ERASEABLE = 0x00000001
-MEDIA_WRITE_ONCE = 0x00000002
-MEDIA_READ_ONLY = 0x00000004
-MEDIA_READ_WRITE = 0x00000008
-MEDIA_WRITE_PROTECTED = 0x00000100
-MEDIA_CURRENTLY_MOUNTED = 0x80000000
-IOCTL_DISK_BASE = FILE_DEVICE_DISK
-PARTITION_ENTRY_UNUSED = 0x00
-PARTITION_FAT_12 = 0x01
-PARTITION_XENIX_1 = 0x02
-PARTITION_XENIX_2 = 0x03
-PARTITION_FAT_16 = 0x04
-PARTITION_EXTENDED = 0x05
-PARTITION_HUGE = 0x06
-PARTITION_IFS = 0x07
-PARTITION_OS2BOOTMGR = 0x0A
-PARTITION_FAT32 = 0x0B
-PARTITION_FAT32_XINT13 = 0x0C
-PARTITION_XINT13 = 0x0E
-PARTITION_XINT13_EXTENDED = 0x0F
-PARTITION_PREP = 0x41
-PARTITION_LDM = 0x42
-PARTITION_UNIX = 0x63
-VALID_NTFT = 0xC0
-PARTITION_NTFT = 0x80
-
-GPT_ATTRIBUTE_PLATFORM_REQUIRED = 0x0000000000000001
-GPT_BASIC_DATA_ATTRIBUTE_NO_DRIVE_LETTER = 0x8000000000000000
-GPT_BASIC_DATA_ATTRIBUTE_HIDDEN = 0x4000000000000000
-GPT_BASIC_DATA_ATTRIBUTE_SHADOW_COPY = 0x2000000000000000
-GPT_BASIC_DATA_ATTRIBUTE_READ_ONLY = 0x1000000000000000
-
-HIST_NO_OF_BUCKETS = 24
-DISK_LOGGING_START = 0
-DISK_LOGGING_STOP = 1
-DISK_LOGGING_DUMP = 2
-DISK_BINNING = 3
-CAP_ATA_ID_CMD = 1
-CAP_ATAPI_ID_CMD = 2
-CAP_SMART_CMD = 4
-ATAPI_ID_CMD = 0xA1
-ID_CMD = 0xEC
-SMART_CMD = 0xB0
-SMART_CYL_LOW = 0x4F
-SMART_CYL_HI = 0xC2
-SMART_NO_ERROR = 0
-SMART_IDE_ERROR = 1
-SMART_INVALID_FLAG = 2
-SMART_INVALID_COMMAND = 3
-SMART_INVALID_BUFFER = 4
-SMART_INVALID_DRIVE = 5
-SMART_INVALID_IOCTL = 6
-SMART_ERROR_NO_MEM = 7
-SMART_INVALID_REGISTER = 8
-SMART_NOT_SUPPORTED = 9
-SMART_NO_IDE_DEVICE = 10
-SMART_OFFLINE_ROUTINE_OFFLINE = 0
-SMART_SHORT_SELFTEST_OFFLINE = 1
-SMART_EXTENDED_SELFTEST_OFFLINE = 2
-SMART_ABORT_OFFLINE_SELFTEST = 127
-SMART_SHORT_SELFTEST_CAPTIVE = 129
-SMART_EXTENDED_SELFTEST_CAPTIVE = 130
-READ_ATTRIBUTE_BUFFER_SIZE = 512
-IDENTIFY_BUFFER_SIZE = 512
-READ_THRESHOLD_BUFFER_SIZE = 512
-SMART_LOG_SECTOR_SIZE = 512
-READ_ATTRIBUTES = 0xD0
-READ_THRESHOLDS = 0xD1
-ENABLE_DISABLE_AUTOSAVE = 0xD2
-SAVE_ATTRIBUTE_VALUES = 0xD3
-EXECUTE_OFFLINE_DIAGS = 0xD4
-SMART_READ_LOG = 0xD5
-SMART_WRITE_LOG = 0xD6
-ENABLE_SMART = 0xD8
-DISABLE_SMART = 0xD9
-RETURN_SMART_STATUS = 0xDA
-ENABLE_DISABLE_AUTO_OFFLINE = 0xDB
-IOCTL_CHANGER_BASE = FILE_DEVICE_CHANGER
-MAX_VOLUME_ID_SIZE = 36
-MAX_VOLUME_TEMPLATE_SIZE = 40
-VENDOR_ID_LENGTH = 8
-PRODUCT_ID_LENGTH = 16
-REVISION_LENGTH = 4
-SERIAL_NUMBER_LENGTH = 32
-CHANGER_BAR_CODE_SCANNER_INSTALLED = 0x00000001
-CHANGER_INIT_ELEM_STAT_WITH_RANGE = 0x00000002
-CHANGER_CLOSE_IEPORT = 0x00000004
-CHANGER_OPEN_IEPORT = 0x00000008
-CHANGER_STATUS_NON_VOLATILE = 0x00000010
-CHANGER_EXCHANGE_MEDIA = 0x00000020
-CHANGER_CLEANER_SLOT = 0x00000040
-CHANGER_LOCK_UNLOCK = 0x00000080
-CHANGER_CARTRIDGE_MAGAZINE = 0x00000100
-CHANGER_MEDIUM_FLIP = 0x00000200
-CHANGER_POSITION_TO_ELEMENT = 0x00000400
-CHANGER_REPORT_IEPORT_STATE = 0x00000800
-CHANGER_STORAGE_DRIVE = 0x00001000
-CHANGER_STORAGE_IEPORT = 0x00002000
-CHANGER_STORAGE_SLOT = 0x00004000
-CHANGER_STORAGE_TRANSPORT = 0x00008000
-CHANGER_DRIVE_CLEANING_REQUIRED = 0x00010000
-CHANGER_PREDISMOUNT_EJECT_REQUIRED = 0x00020000
-CHANGER_CLEANER_ACCESS_NOT_VALID = 0x00040000
-CHANGER_PREMOUNT_EJECT_REQUIRED = 0x00080000
-CHANGER_VOLUME_IDENTIFICATION = 0x00100000
-CHANGER_VOLUME_SEARCH = 0x00200000
-CHANGER_VOLUME_ASSERT = 0x00400000
-CHANGER_VOLUME_REPLACE = 0x00800000
-CHANGER_VOLUME_UNDEFINE = 0x01000000
-CHANGER_SERIAL_NUMBER_VALID = 0x04000000
-CHANGER_DEVICE_REINITIALIZE_CAPABLE = 0x08000000
-CHANGER_KEYPAD_ENABLE_DISABLE = 0x10000000
-CHANGER_DRIVE_EMPTY_ON_DOOR_ACCESS = 0x20000000
-
-CHANGER_RESERVED_BIT = 0x80000000
-CHANGER_PREDISMOUNT_ALIGN_TO_SLOT = 0x80000001
-CHANGER_PREDISMOUNT_ALIGN_TO_DRIVE = 0x80000002
-CHANGER_CLEANER_AUTODISMOUNT = 0x80000004
-CHANGER_TRUE_EXCHANGE_CAPABLE = 0x80000008
-CHANGER_SLOTS_USE_TRAYS = 0x80000010
-CHANGER_RTN_MEDIA_TO_ORIGINAL_ADDR = 0x80000020
-CHANGER_CLEANER_OPS_NOT_SUPPORTED = 0x80000040
-CHANGER_IEPORT_USER_CONTROL_OPEN = 0x80000080
-CHANGER_IEPORT_USER_CONTROL_CLOSE = 0x80000100
-CHANGER_MOVE_EXTENDS_IEPORT = 0x80000200
-CHANGER_MOVE_RETRACTS_IEPORT = 0x80000400
-
-
-CHANGER_TO_TRANSPORT = 0x01
-CHANGER_TO_SLOT = 0x02
-CHANGER_TO_IEPORT = 0x04
-CHANGER_TO_DRIVE = 0x08
-LOCK_UNLOCK_IEPORT = 0x01
-LOCK_UNLOCK_DOOR = 0x02
-LOCK_UNLOCK_KEYPAD = 0x04
-LOCK_ELEMENT = 0
-UNLOCK_ELEMENT = 1
-EXTEND_IEPORT = 2
-RETRACT_IEPORT = 3
-ELEMENT_STATUS_FULL = 0x00000001
-ELEMENT_STATUS_IMPEXP = 0x00000002
-ELEMENT_STATUS_EXCEPT = 0x00000004
-ELEMENT_STATUS_ACCESS = 0x00000008
-ELEMENT_STATUS_EXENAB = 0x00000010
-ELEMENT_STATUS_INENAB = 0x00000020
-ELEMENT_STATUS_PRODUCT_DATA = 0x00000040
-ELEMENT_STATUS_LUN_VALID = 0x00001000
-ELEMENT_STATUS_ID_VALID = 0x00002000
-ELEMENT_STATUS_NOT_BUS = 0x00008000
-ELEMENT_STATUS_INVERT = 0x00400000
-ELEMENT_STATUS_SVALID = 0x00800000
-ELEMENT_STATUS_PVOLTAG = 0x10000000
-ELEMENT_STATUS_AVOLTAG = 0x20000000
-ERROR_LABEL_UNREADABLE = 0x00000001
-ERROR_LABEL_QUESTIONABLE = 0x00000002
-ERROR_SLOT_NOT_PRESENT = 0x00000004
-ERROR_DRIVE_NOT_INSTALLED = 0x00000008
-ERROR_TRAY_MALFUNCTION = 0x00000010
-ERROR_INIT_STATUS_NEEDED = 0x00000011
-ERROR_UNHANDLED_ERROR = 0xFFFFFFFF
-SEARCH_ALL = 0x0
-SEARCH_PRIMARY = 0x1
-SEARCH_ALTERNATE = 0x2
-SEARCH_ALL_NO_SEQ = 0x4
-SEARCH_PRI_NO_SEQ = 0x5
-SEARCH_ALT_NO_SEQ = 0x6
-ASSERT_PRIMARY = 0x8
-ASSERT_ALTERNATE = 0x9
-REPLACE_PRIMARY = 0xA
-REPLACE_ALTERNATE = 0xB
-UNDEFINE_PRIMARY = 0xC
-UNDEFINE_ALTERNATE = 0xD
-USN_PAGE_SIZE = 0x1000
-USN_REASON_DATA_OVERWRITE = 0x00000001
-USN_REASON_DATA_EXTEND = 0x00000002
-USN_REASON_DATA_TRUNCATION = 0x00000004
-USN_REASON_NAMED_DATA_OVERWRITE = 0x00000010
-USN_REASON_NAMED_DATA_EXTEND = 0x00000020
-USN_REASON_NAMED_DATA_TRUNCATION = 0x00000040
-USN_REASON_FILE_CREATE = 0x00000100
-USN_REASON_FILE_DELETE = 0x00000200
-USN_REASON_EA_CHANGE = 0x00000400
-USN_REASON_SECURITY_CHANGE = 0x00000800
-USN_REASON_RENAME_OLD_NAME = 0x00001000
-USN_REASON_RENAME_NEW_NAME = 0x00002000
-USN_REASON_INDEXABLE_CHANGE = 0x00004000
-USN_REASON_BASIC_INFO_CHANGE = 0x00008000
-USN_REASON_HARD_LINK_CHANGE = 0x00010000
-USN_REASON_COMPRESSION_CHANGE = 0x00020000
-USN_REASON_ENCRYPTION_CHANGE = 0x00040000
-USN_REASON_OBJECT_ID_CHANGE = 0x00080000
-USN_REASON_REPARSE_POINT_CHANGE = 0x00100000
-USN_REASON_STREAM_CHANGE = 0x00200000
-USN_REASON_TRANSACTED_CHANGE = 0x00400000
-USN_REASON_CLOSE = 0x80000000
-USN_DELETE_FLAG_DELETE = 0x00000001
-USN_DELETE_FLAG_NOTIFY = 0x00000002
-USN_DELETE_VALID_FLAGS = 0x00000003
-USN_SOURCE_DATA_MANAGEMENT = 0x00000001
-USN_SOURCE_AUXILIARY_DATA = 0x00000002
-USN_SOURCE_REPLICATION_MANAGEMENT = 0x00000004
-
-MARK_HANDLE_PROTECT_CLUSTERS = 1
-MARK_HANDLE_TXF_SYSTEM_LOG = 4
-MARK_HANDLE_NOT_TXF_SYSTEM_LOG = 8
-
-VOLUME_IS_DIRTY = 0x00000001
-VOLUME_UPGRADE_SCHEDULED = 0x00000002
-VOLUME_SESSION_OPEN = 4
-
-FILE_PREFETCH_TYPE_FOR_CREATE = 1
-FILE_PREFETCH_TYPE_FOR_DIRENUM = 2
-FILE_PREFETCH_TYPE_FOR_CREATE_EX = 3
-FILE_PREFETCH_TYPE_FOR_DIRENUM_EX = 4
-FILE_PREFETCH_TYPE_MAX = 4
-
-FILESYSTEM_STATISTICS_TYPE_NTFS = 1
-FILESYSTEM_STATISTICS_TYPE_FAT = 2
-FILE_SET_ENCRYPTION = 0x00000001
-FILE_CLEAR_ENCRYPTION = 0x00000002
-STREAM_SET_ENCRYPTION = 0x00000003
-STREAM_CLEAR_ENCRYPTION = 0x00000004
-MAXIMUM_ENCRYPTION_VALUE = 0x00000004
-ENCRYPTION_FORMAT_DEFAULT = 0x01
-COMPRESSION_FORMAT_SPARSE = 0x4000
-COPYFILE_SIS_LINK = 0x0001
-COPYFILE_SIS_REPLACE = 0x0002
-COPYFILE_SIS_FLAGS = 0x0003
-
-WMI_DISK_GEOMETRY_GUID = pywintypes.IID("{25007F51-57C2-11D1-A528-00A0C9062910}")
-GUID_DEVINTERFACE_CDROM = pywintypes.IID("{53F56308-B6BF-11D0-94F2-00A0C91EFB8B}")
-GUID_DEVINTERFACE_FLOPPY = pywintypes.IID("{53F56311-B6BF-11D0-94F2-00A0C91EFB8B}")
-GUID_DEVINTERFACE_SERENUM_BUS_ENUMERATOR = pywintypes.IID(
-    "{4D36E978-E325-11CE-BFC1-08002BE10318}"
-)
-GUID_DEVINTERFACE_COMPORT = pywintypes.IID("{86E0D1E0-8089-11D0-9CE4-08003E301F73}")
-GUID_DEVINTERFACE_DISK = pywintypes.IID("{53F56307-B6BF-11D0-94F2-00A0C91EFB8B}")
-GUID_DEVINTERFACE_STORAGEPORT = pywintypes.IID("{2ACCFE60-C130-11D2-B082-00A0C91EFB8B}")
-GUID_DEVINTERFACE_CDCHANGER = pywintypes.IID("{53F56312-B6BF-11D0-94F2-00A0C91EFB8B}")
-GUID_DEVINTERFACE_PARTITION = pywintypes.IID("{53F5630A-B6BF-11D0-94F2-00A0C91EFB8B}")
-GUID_DEVINTERFACE_VOLUME = pywintypes.IID("{53F5630D-B6BF-11D0-94F2-00A0C91EFB8B}")
-GUID_DEVINTERFACE_WRITEONCEDISK = pywintypes.IID(
-    "{53F5630C-B6BF-11D0-94F2-00A0C91EFB8B}"
-)
-GUID_DEVINTERFACE_TAPE = pywintypes.IID("{53F5630B-B6BF-11D0-94F2-00A0C91EFB8B}")
-GUID_DEVINTERFACE_MEDIUMCHANGER = pywintypes.IID(
-    "{53F56310-B6BF-11D0-94F2-00A0C91EFB8B}"
-)
-GUID_SERENUM_BUS_ENUMERATOR = GUID_DEVINTERFACE_SERENUM_BUS_ENUMERATOR
-GUID_CLASS_COMPORT = GUID_DEVINTERFACE_COMPORT
-
-DiskClassGuid = GUID_DEVINTERFACE_DISK
-CdRomClassGuid = GUID_DEVINTERFACE_CDROM
-PartitionClassGuid = GUID_DEVINTERFACE_PARTITION
-TapeClassGuid = GUID_DEVINTERFACE_TAPE
-WriteOnceDiskClassGuid = GUID_DEVINTERFACE_WRITEONCEDISK
-VolumeClassGuid = GUID_DEVINTERFACE_VOLUME
-MediumChangerClassGuid = GUID_DEVINTERFACE_MEDIUMCHANGER
-FloppyClassGuid = GUID_DEVINTERFACE_FLOPPY
-CdChangerClassGuid = GUID_DEVINTERFACE_CDCHANGER
-StoragePortClassGuid = GUID_DEVINTERFACE_STORAGEPORT
-
-
-IOCTL_STORAGE_CHECK_VERIFY = CTL_CODE(
-    IOCTL_STORAGE_BASE, 0x0200, METHOD_BUFFERED, FILE_READ_ACCESS
-)
-IOCTL_STORAGE_CHECK_VERIFY2 = CTL_CODE(
-    IOCTL_STORAGE_BASE, 0x0200, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-IOCTL_STORAGE_MEDIA_REMOVAL = CTL_CODE(
-    IOCTL_STORAGE_BASE, 0x0201, METHOD_BUFFERED, FILE_READ_ACCESS
-)
-IOCTL_STORAGE_EJECT_MEDIA = CTL_CODE(
-    IOCTL_STORAGE_BASE, 0x0202, METHOD_BUFFERED, FILE_READ_ACCESS
-)
-IOCTL_STORAGE_LOAD_MEDIA = CTL_CODE(
-    IOCTL_STORAGE_BASE, 0x0203, METHOD_BUFFERED, FILE_READ_ACCESS
-)
-IOCTL_STORAGE_LOAD_MEDIA2 = CTL_CODE(
-    IOCTL_STORAGE_BASE, 0x0203, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-IOCTL_STORAGE_RESERVE = CTL_CODE(
-    IOCTL_STORAGE_BASE, 0x0204, METHOD_BUFFERED, FILE_READ_ACCESS
-)
-IOCTL_STORAGE_RELEASE = CTL_CODE(
-    IOCTL_STORAGE_BASE, 0x0205, METHOD_BUFFERED, FILE_READ_ACCESS
-)
-IOCTL_STORAGE_FIND_NEW_DEVICES = CTL_CODE(
-    IOCTL_STORAGE_BASE, 0x0206, METHOD_BUFFERED, FILE_READ_ACCESS
-)
-IOCTL_STORAGE_EJECTION_CONTROL = CTL_CODE(
-    IOCTL_STORAGE_BASE, 0x0250, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-IOCTL_STORAGE_MCN_CONTROL = CTL_CODE(
-    IOCTL_STORAGE_BASE, 0x0251, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-IOCTL_STORAGE_GET_MEDIA_TYPES = CTL_CODE(
-    IOCTL_STORAGE_BASE, 0x0300, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-IOCTL_STORAGE_GET_MEDIA_TYPES_EX = CTL_CODE(
-    IOCTL_STORAGE_BASE, 0x0301, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-IOCTL_STORAGE_GET_MEDIA_SERIAL_NUMBER = CTL_CODE(
-    IOCTL_STORAGE_BASE, 0x0304, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-IOCTL_STORAGE_GET_HOTPLUG_INFO = CTL_CODE(
-    IOCTL_STORAGE_BASE, 0x0305, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-IOCTL_STORAGE_SET_HOTPLUG_INFO = CTL_CODE(
-    IOCTL_STORAGE_BASE, 0x0306, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS
-)
-IOCTL_STORAGE_RESET_BUS = CTL_CODE(
-    IOCTL_STORAGE_BASE, 0x0400, METHOD_BUFFERED, FILE_READ_ACCESS
-)
-IOCTL_STORAGE_RESET_DEVICE = CTL_CODE(
-    IOCTL_STORAGE_BASE, 0x0401, METHOD_BUFFERED, FILE_READ_ACCESS
-)
-IOCTL_STORAGE_BREAK_RESERVATION = CTL_CODE(
-    IOCTL_STORAGE_BASE, 0x0405, METHOD_BUFFERED, FILE_READ_ACCESS
-)
-IOCTL_STORAGE_GET_DEVICE_NUMBER = CTL_CODE(
-    IOCTL_STORAGE_BASE, 0x0420, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-IOCTL_STORAGE_PREDICT_FAILURE = CTL_CODE(
-    IOCTL_STORAGE_BASE, 0x0440, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-IOCTL_DISK_GET_DRIVE_GEOMETRY = CTL_CODE(
-    IOCTL_DISK_BASE, 0x0000, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-IOCTL_DISK_GET_PARTITION_INFO = CTL_CODE(
-    IOCTL_DISK_BASE, 0x0001, METHOD_BUFFERED, FILE_READ_ACCESS
-)
-IOCTL_DISK_SET_PARTITION_INFO = CTL_CODE(
-    IOCTL_DISK_BASE, 0x0002, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS
-)
-IOCTL_DISK_GET_DRIVE_LAYOUT = CTL_CODE(
-    IOCTL_DISK_BASE, 0x0003, METHOD_BUFFERED, FILE_READ_ACCESS
-)
-IOCTL_DISK_SET_DRIVE_LAYOUT = CTL_CODE(
-    IOCTL_DISK_BASE, 0x0004, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS
-)
-IOCTL_DISK_VERIFY = CTL_CODE(IOCTL_DISK_BASE, 0x0005, METHOD_BUFFERED, FILE_ANY_ACCESS)
-IOCTL_DISK_FORMAT_TRACKS = CTL_CODE(
-    IOCTL_DISK_BASE, 0x0006, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS
-)
-IOCTL_DISK_REASSIGN_BLOCKS = CTL_CODE(
-    IOCTL_DISK_BASE, 0x0007, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS
-)
-IOCTL_DISK_PERFORMANCE = CTL_CODE(
-    IOCTL_DISK_BASE, 0x0008, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-IOCTL_DISK_IS_WRITABLE = CTL_CODE(
-    IOCTL_DISK_BASE, 0x0009, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-IOCTL_DISK_LOGGING = CTL_CODE(IOCTL_DISK_BASE, 0x000A, METHOD_BUFFERED, FILE_ANY_ACCESS)
-IOCTL_DISK_FORMAT_TRACKS_EX = CTL_CODE(
-    IOCTL_DISK_BASE, 0x000B, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS
-)
-IOCTL_DISK_HISTOGRAM_STRUCTURE = CTL_CODE(
-    IOCTL_DISK_BASE, 0x000C, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-IOCTL_DISK_HISTOGRAM_DATA = CTL_CODE(
-    IOCTL_DISK_BASE, 0x000D, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-IOCTL_DISK_HISTOGRAM_RESET = CTL_CODE(
-    IOCTL_DISK_BASE, 0x000E, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-IOCTL_DISK_REQUEST_STRUCTURE = CTL_CODE(
-    IOCTL_DISK_BASE, 0x000F, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-IOCTL_DISK_REQUEST_DATA = CTL_CODE(
-    IOCTL_DISK_BASE, 0x0010, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-IOCTL_DISK_PERFORMANCE_OFF = CTL_CODE(
-    IOCTL_DISK_BASE, 0x0018, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-IOCTL_DISK_CONTROLLER_NUMBER = CTL_CODE(
-    IOCTL_DISK_BASE, 0x0011, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-SMART_GET_VERSION = CTL_CODE(IOCTL_DISK_BASE, 0x0020, METHOD_BUFFERED, FILE_READ_ACCESS)
-SMART_SEND_DRIVE_COMMAND = CTL_CODE(
-    IOCTL_DISK_BASE, 0x0021, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS
-)
-SMART_RCV_DRIVE_DATA = CTL_CODE(
-    IOCTL_DISK_BASE, 0x0022, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS
-)
-IOCTL_DISK_GET_PARTITION_INFO_EX = CTL_CODE(
-    IOCTL_DISK_BASE, 0x0012, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-IOCTL_DISK_SET_PARTITION_INFO_EX = CTL_CODE(
-    IOCTL_DISK_BASE, 0x0013, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS
-)
-IOCTL_DISK_GET_DRIVE_LAYOUT_EX = CTL_CODE(
-    IOCTL_DISK_BASE, 0x0014, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-IOCTL_DISK_SET_DRIVE_LAYOUT_EX = CTL_CODE(
-    IOCTL_DISK_BASE, 0x0015, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS
-)
-IOCTL_DISK_CREATE_DISK = CTL_CODE(
-    IOCTL_DISK_BASE, 0x0016, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS
-)
-IOCTL_DISK_GET_LENGTH_INFO = CTL_CODE(
-    IOCTL_DISK_BASE, 0x0017, METHOD_BUFFERED, FILE_READ_ACCESS
-)
-IOCTL_DISK_GET_DRIVE_GEOMETRY_EX = CTL_CODE(
-    IOCTL_DISK_BASE, 0x0028, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-IOCTL_DISK_REASSIGN_BLOCKS_EX = CTL_CODE(
-    IOCTL_DISK_BASE, 0x0029, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS
-)
-
-IOCTL_DISK_UPDATE_DRIVE_SIZE = CTL_CODE(
-    IOCTL_DISK_BASE, 0x0032, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS
-)
-IOCTL_DISK_GROW_PARTITION = CTL_CODE(
-    IOCTL_DISK_BASE, 0x0034, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS
-)
-IOCTL_DISK_GET_CACHE_INFORMATION = CTL_CODE(
-    IOCTL_DISK_BASE, 0x0035, METHOD_BUFFERED, FILE_READ_ACCESS
-)
-IOCTL_DISK_SET_CACHE_INFORMATION = CTL_CODE(
-    IOCTL_DISK_BASE, 0x0036, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS
-)
-
-OBSOLETE_IOCTL_STORAGE_RESET_BUS = CTL_CODE(
-    IOCTL_STORAGE_BASE, 0x0400, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS
-)
-OBSOLETE_IOCTL_STORAGE_RESET_DEVICE = CTL_CODE(
-    IOCTL_STORAGE_BASE, 0x0401, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS
-)
-## the original define no longer exists in winioctl.h
-OBSOLETE_DISK_GET_WRITE_CACHE_STATE = CTL_CODE(
-    IOCTL_DISK_BASE, 0x0037, METHOD_BUFFERED, FILE_READ_ACCESS
-)
-IOCTL_DISK_GET_WRITE_CACHE_STATE = OBSOLETE_DISK_GET_WRITE_CACHE_STATE
-
-
-IOCTL_DISK_DELETE_DRIVE_LAYOUT = CTL_CODE(
-    IOCTL_DISK_BASE, 0x0040, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS
-)
-IOCTL_DISK_UPDATE_PROPERTIES = CTL_CODE(
-    IOCTL_DISK_BASE, 0x0050, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-IOCTL_DISK_FORMAT_DRIVE = CTL_CODE(
-    IOCTL_DISK_BASE, 0x00F3, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS
-)
-IOCTL_DISK_SENSE_DEVICE = CTL_CODE(
-    IOCTL_DISK_BASE, 0x00F8, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-IOCTL_DISK_CHECK_VERIFY = CTL_CODE(
-    IOCTL_DISK_BASE, 0x0200, METHOD_BUFFERED, FILE_READ_ACCESS
-)
-IOCTL_DISK_MEDIA_REMOVAL = CTL_CODE(
-    IOCTL_DISK_BASE, 0x0201, METHOD_BUFFERED, FILE_READ_ACCESS
-)
-IOCTL_DISK_EJECT_MEDIA = CTL_CODE(
-    IOCTL_DISK_BASE, 0x0202, METHOD_BUFFERED, FILE_READ_ACCESS
-)
-IOCTL_DISK_LOAD_MEDIA = CTL_CODE(
-    IOCTL_DISK_BASE, 0x0203, METHOD_BUFFERED, FILE_READ_ACCESS
-)
-IOCTL_DISK_RESERVE = CTL_CODE(
-    IOCTL_DISK_BASE, 0x0204, METHOD_BUFFERED, FILE_READ_ACCESS
-)
-IOCTL_DISK_RELEASE = CTL_CODE(
-    IOCTL_DISK_BASE, 0x0205, METHOD_BUFFERED, FILE_READ_ACCESS
-)
-IOCTL_DISK_FIND_NEW_DEVICES = CTL_CODE(
-    IOCTL_DISK_BASE, 0x0206, METHOD_BUFFERED, FILE_READ_ACCESS
-)
-IOCTL_DISK_GET_MEDIA_TYPES = CTL_CODE(
-    IOCTL_DISK_BASE, 0x0300, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-
-DISK_HISTOGRAM_SIZE = 72
-HISTOGRAM_BUCKET_SIZE = 8
-
-IOCTL_CHANGER_GET_PARAMETERS = CTL_CODE(
-    IOCTL_CHANGER_BASE, 0x0000, METHOD_BUFFERED, FILE_READ_ACCESS
-)
-IOCTL_CHANGER_GET_STATUS = CTL_CODE(
-    IOCTL_CHANGER_BASE, 0x0001, METHOD_BUFFERED, FILE_READ_ACCESS
-)
-IOCTL_CHANGER_GET_PRODUCT_DATA = CTL_CODE(
-    IOCTL_CHANGER_BASE, 0x0002, METHOD_BUFFERED, FILE_READ_ACCESS
-)
-IOCTL_CHANGER_SET_ACCESS = CTL_CODE(
-    IOCTL_CHANGER_BASE, 0x0004, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS
-)
-IOCTL_CHANGER_GET_ELEMENT_STATUS = CTL_CODE(
-    IOCTL_CHANGER_BASE, 0x0005, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS
-)
-IOCTL_CHANGER_INITIALIZE_ELEMENT_STATUS = CTL_CODE(
-    IOCTL_CHANGER_BASE, 0x0006, METHOD_BUFFERED, FILE_READ_ACCESS
-)
-IOCTL_CHANGER_SET_POSITION = CTL_CODE(
-    IOCTL_CHANGER_BASE, 0x0007, METHOD_BUFFERED, FILE_READ_ACCESS
-)
-IOCTL_CHANGER_EXCHANGE_MEDIUM = CTL_CODE(
-    IOCTL_CHANGER_BASE, 0x0008, METHOD_BUFFERED, FILE_READ_ACCESS
-)
-IOCTL_CHANGER_MOVE_MEDIUM = CTL_CODE(
-    IOCTL_CHANGER_BASE, 0x0009, METHOD_BUFFERED, FILE_READ_ACCESS
-)
-IOCTL_CHANGER_REINITIALIZE_TRANSPORT = CTL_CODE(
-    IOCTL_CHANGER_BASE, 0x000A, METHOD_BUFFERED, FILE_READ_ACCESS
-)
-IOCTL_CHANGER_QUERY_VOLUME_TAGS = CTL_CODE(
-    IOCTL_CHANGER_BASE, 0x000B, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS
-)
-IOCTL_SERIAL_LSRMST_INSERT = CTL_CODE(
-    FILE_DEVICE_SERIAL_PORT, 31, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-IOCTL_SERENUM_EXPOSE_HARDWARE = CTL_CODE(
-    FILE_DEVICE_SERENUM, 128, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-IOCTL_SERENUM_REMOVE_HARDWARE = CTL_CODE(
-    FILE_DEVICE_SERENUM, 129, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-IOCTL_SERENUM_PORT_DESC = CTL_CODE(
-    FILE_DEVICE_SERENUM, 130, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-IOCTL_SERENUM_GET_PORT_NAME = CTL_CODE(
-    FILE_DEVICE_SERENUM, 131, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-
-## ??? can't find where FILE_DEVICE_AVIO is defined ???
-## IOCTL_AVIO_ALLOCATE_STREAM = CTL_CODE(FILE_DEVICE_AVIO, 1, METHOD_BUFFERED, FILE_SPECIAL_ACCESS)
-## IOCTL_AVIO_FREE_STREAM = CTL_CODE(FILE_DEVICE_AVIO, 2, METHOD_BUFFERED, FILE_SPECIAL_ACCESS)
-## IOCTL_AVIO_MODIFY_STREAM = CTL_CODE(FILE_DEVICE_AVIO, 3, METHOD_BUFFERED, FILE_SPECIAL_ACCESS)
-
-SERIAL_LSRMST_ESCAPE = 0x00
-SERIAL_LSRMST_LSR_DATA = 0x01
-SERIAL_LSRMST_LSR_NODATA = 0x02
-SERIAL_LSRMST_MST = 0x03
-SERIAL_IOC_FCR_FIFO_ENABLE = 0x00000001
-SERIAL_IOC_FCR_RCVR_RESET = 0x00000002
-SERIAL_IOC_FCR_XMIT_RESET = 0x00000004
-SERIAL_IOC_FCR_DMA_MODE = 0x00000008
-SERIAL_IOC_FCR_RES1 = 0x00000010
-SERIAL_IOC_FCR_RES2 = 0x00000020
-SERIAL_IOC_FCR_RCVR_TRIGGER_LSB = 0x00000040
-SERIAL_IOC_FCR_RCVR_TRIGGER_MSB = 0x00000080
-SERIAL_IOC_MCR_DTR = 0x00000001
-SERIAL_IOC_MCR_RTS = 0x00000002
-SERIAL_IOC_MCR_OUT1 = 0x00000004
-SERIAL_IOC_MCR_OUT2 = 0x00000008
-SERIAL_IOC_MCR_LOOP = 0x00000010
-FSCTL_REQUEST_OPLOCK_LEVEL_1 = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 0, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-FSCTL_REQUEST_OPLOCK_LEVEL_2 = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 1, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-FSCTL_REQUEST_BATCH_OPLOCK = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 2, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-FSCTL_OPLOCK_BREAK_ACKNOWLEDGE = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 3, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-FSCTL_OPBATCH_ACK_CLOSE_PENDING = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 4, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-FSCTL_OPLOCK_BREAK_NOTIFY = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 5, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-FSCTL_LOCK_VOLUME = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 6, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-FSCTL_UNLOCK_VOLUME = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 7, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-FSCTL_DISMOUNT_VOLUME = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 8, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-FSCTL_IS_VOLUME_MOUNTED = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 10, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-FSCTL_IS_PATHNAME_VALID = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 11, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-FSCTL_MARK_VOLUME_DIRTY = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 12, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-FSCTL_QUERY_RETRIEVAL_POINTERS = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 14, METHOD_NEITHER, FILE_ANY_ACCESS
-)
-FSCTL_GET_COMPRESSION = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 15, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-FSCTL_SET_COMPRESSION = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 16, METHOD_BUFFERED, FILE_READ_DATA | FILE_WRITE_DATA
-)
-FSCTL_MARK_AS_SYSTEM_HIVE = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 19, METHOD_NEITHER, FILE_ANY_ACCESS
-)
-FSCTL_OPLOCK_BREAK_ACK_NO_2 = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 20, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-FSCTL_INVALIDATE_VOLUMES = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 21, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-FSCTL_QUERY_FAT_BPB = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 22, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-FSCTL_REQUEST_FILTER_OPLOCK = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 23, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-FSCTL_FILESYSTEM_GET_STATISTICS = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 24, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-FSCTL_GET_NTFS_VOLUME_DATA = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 25, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-FSCTL_GET_NTFS_FILE_RECORD = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 26, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-FSCTL_GET_VOLUME_BITMAP = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 27, METHOD_NEITHER, FILE_ANY_ACCESS
-)
-FSCTL_GET_RETRIEVAL_POINTERS = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 28, METHOD_NEITHER, FILE_ANY_ACCESS
-)
-FSCTL_MOVE_FILE = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 29, METHOD_BUFFERED, FILE_SPECIAL_ACCESS
-)
-FSCTL_IS_VOLUME_DIRTY = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 30, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-FSCTL_ALLOW_EXTENDED_DASD_IO = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 32, METHOD_NEITHER, FILE_ANY_ACCESS
-)
-FSCTL_FIND_FILES_BY_SID = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 35, METHOD_NEITHER, FILE_ANY_ACCESS
-)
-FSCTL_SET_OBJECT_ID = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 38, METHOD_BUFFERED, FILE_SPECIAL_ACCESS
-)
-FSCTL_GET_OBJECT_ID = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 39, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-FSCTL_DELETE_OBJECT_ID = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 40, METHOD_BUFFERED, FILE_SPECIAL_ACCESS
-)
-FSCTL_SET_REPARSE_POINT = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 41, METHOD_BUFFERED, FILE_SPECIAL_ACCESS
-)
-FSCTL_GET_REPARSE_POINT = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 42, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-FSCTL_DELETE_REPARSE_POINT = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 43, METHOD_BUFFERED, FILE_SPECIAL_ACCESS
-)
-FSCTL_ENUM_USN_DATA = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 44, METHOD_NEITHER, FILE_ANY_ACCESS
-)
-FSCTL_SECURITY_ID_CHECK = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 45, METHOD_NEITHER, FILE_READ_DATA
-)
-FSCTL_READ_USN_JOURNAL = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 46, METHOD_NEITHER, FILE_ANY_ACCESS
-)
-FSCTL_SET_OBJECT_ID_EXTENDED = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 47, METHOD_BUFFERED, FILE_SPECIAL_ACCESS
-)
-FSCTL_CREATE_OR_GET_OBJECT_ID = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 48, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-FSCTL_SET_SPARSE = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 49, METHOD_BUFFERED, FILE_SPECIAL_ACCESS
-)
-FSCTL_SET_ZERO_DATA = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 50, METHOD_BUFFERED, FILE_WRITE_DATA
-)
-FSCTL_QUERY_ALLOCATED_RANGES = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 51, METHOD_NEITHER, FILE_READ_DATA
-)
-FSCTL_SET_ENCRYPTION = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 53, METHOD_NEITHER, FILE_ANY_ACCESS
-)
-FSCTL_ENCRYPTION_FSCTL_IO = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 54, METHOD_NEITHER, FILE_ANY_ACCESS
-)
-FSCTL_WRITE_RAW_ENCRYPTED = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 55, METHOD_NEITHER, FILE_SPECIAL_ACCESS
-)
-FSCTL_READ_RAW_ENCRYPTED = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 56, METHOD_NEITHER, FILE_SPECIAL_ACCESS
-)
-FSCTL_CREATE_USN_JOURNAL = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 57, METHOD_NEITHER, FILE_ANY_ACCESS
-)
-FSCTL_READ_FILE_USN_DATA = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 58, METHOD_NEITHER, FILE_ANY_ACCESS
-)
-FSCTL_WRITE_USN_CLOSE_RECORD = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 59, METHOD_NEITHER, FILE_ANY_ACCESS
-)
-FSCTL_EXTEND_VOLUME = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 60, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-FSCTL_QUERY_USN_JOURNAL = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 61, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-FSCTL_DELETE_USN_JOURNAL = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 62, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-FSCTL_MARK_HANDLE = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 63, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-FSCTL_SIS_COPYFILE = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 64, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-FSCTL_SIS_LINK_FILES = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 65, METHOD_BUFFERED, FILE_READ_DATA | FILE_WRITE_DATA
-)
-FSCTL_HSM_MSG = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 66, METHOD_BUFFERED, FILE_READ_DATA | FILE_WRITE_DATA
-)
-FSCTL_HSM_DATA = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 68, METHOD_NEITHER, FILE_READ_DATA | FILE_WRITE_DATA
-)
-FSCTL_RECALL_FILE = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 69, METHOD_NEITHER, FILE_ANY_ACCESS
-)
-FSCTL_READ_FROM_PLEX = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 71, METHOD_OUT_DIRECT, FILE_READ_DATA
-)
-FSCTL_FILE_PREFETCH = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 72, METHOD_BUFFERED, FILE_SPECIAL_ACCESS
-)
-FSCTL_MAKE_MEDIA_COMPATIBLE = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 76, METHOD_BUFFERED, FILE_WRITE_DATA
-)
-FSCTL_SET_DEFECT_MANAGEMENT = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 77, METHOD_BUFFERED, FILE_WRITE_DATA
-)
-FSCTL_QUERY_SPARING_INFO = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 78, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-FSCTL_QUERY_ON_DISK_VOLUME_INFO = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 79, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-FSCTL_SET_VOLUME_COMPRESSION_STATE = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 80, METHOD_BUFFERED, FILE_SPECIAL_ACCESS
-)
-FSCTL_TXFS_MODIFY_RM = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 81, METHOD_BUFFERED, FILE_WRITE_DATA
-)
-FSCTL_TXFS_QUERY_RM_INFORMATION = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 82, METHOD_BUFFERED, FILE_READ_DATA
-)
-FSCTL_TXFS_ROLLFORWARD_REDO = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 84, METHOD_BUFFERED, FILE_WRITE_DATA
-)
-FSCTL_TXFS_ROLLFORWARD_UNDO = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 85, METHOD_BUFFERED, FILE_WRITE_DATA
-)
-FSCTL_TXFS_START_RM = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 86, METHOD_BUFFERED, FILE_WRITE_DATA
-)
-FSCTL_TXFS_SHUTDOWN_RM = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 87, METHOD_BUFFERED, FILE_WRITE_DATA
-)
-FSCTL_TXFS_READ_BACKUP_INFORMATION = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 88, METHOD_BUFFERED, FILE_READ_DATA
-)
-FSCTL_TXFS_WRITE_BACKUP_INFORMATION = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 89, METHOD_BUFFERED, FILE_WRITE_DATA
-)
-FSCTL_TXFS_CREATE_SECONDARY_RM = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 90, METHOD_BUFFERED, FILE_WRITE_DATA
-)
-FSCTL_TXFS_GET_METADATA_INFO = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 91, METHOD_BUFFERED, FILE_READ_DATA
-)
-FSCTL_TXFS_GET_TRANSACTED_VERSION = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 92, METHOD_BUFFERED, FILE_READ_DATA
-)
-FSCTL_TXFS_CREATE_MINIVERSION = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 95, METHOD_BUFFERED, FILE_WRITE_DATA
-)
-FSCTL_TXFS_TRANSACTION_ACTIVE = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 99, METHOD_BUFFERED, FILE_READ_DATA
-)
-FSCTL_SET_ZERO_ON_DEALLOCATION = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 101, METHOD_BUFFERED, FILE_SPECIAL_ACCESS
-)
-FSCTL_SET_REPAIR = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 102, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-FSCTL_GET_REPAIR = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 103, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-FSCTL_WAIT_FOR_REPAIR = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 104, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-FSCTL_INITIATE_REPAIR = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 106, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-FSCTL_CSC_INTERNAL = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 107, METHOD_NEITHER, FILE_ANY_ACCESS
-)
-FSCTL_SHRINK_VOLUME = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 108, METHOD_BUFFERED, FILE_SPECIAL_ACCESS
-)
-FSCTL_SET_SHORT_NAME_BEHAVIOR = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 109, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-FSCTL_DFSR_SET_GHOST_HANDLE_STATE = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 110, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-FSCTL_TXFS_LIST_TRANSACTION_LOCKED_FILES = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 120, METHOD_BUFFERED, FILE_READ_DATA
-)
-FSCTL_TXFS_LIST_TRANSACTIONS = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 121, METHOD_BUFFERED, FILE_READ_DATA
-)
-FSCTL_QUERY_PAGEFILE_ENCRYPTION = CTL_CODE(
-    FILE_DEVICE_FILE_SYSTEM, 122, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-
-IOCTL_VOLUME_BASE = ord("V")
-IOCTL_VOLUME_GET_VOLUME_DISK_EXTENTS = CTL_CODE(
-    IOCTL_VOLUME_BASE, 0, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-IOCTL_VOLUME_ONLINE = CTL_CODE(
-    IOCTL_VOLUME_BASE, 2, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS
-)
-IOCTL_VOLUME_OFFLINE = CTL_CODE(
-    IOCTL_VOLUME_BASE, 3, METHOD_BUFFERED, FILE_READ_ACCESS | FILE_WRITE_ACCESS
-)
-IOCTL_VOLUME_IS_CLUSTERED = CTL_CODE(
-    IOCTL_VOLUME_BASE, 12, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-IOCTL_VOLUME_GET_GPT_ATTRIBUTES = CTL_CODE(
-    IOCTL_VOLUME_BASE, 14, METHOD_BUFFERED, FILE_ANY_ACCESS
-)
-
-## enums
-## STORAGE_MEDIA_TYPE
-DDS_4mm = 32
-MiniQic = 33
-Travan = 34
-QIC = 35
-MP_8mm = 36
-AME_8mm = 37
-AIT1_8mm = 38
-DLT = 39
-NCTP = 40
-IBM_3480 = 41
-IBM_3490E = 42
-IBM_Magstar_3590 = 43
-IBM_Magstar_MP = 44
-STK_DATA_D3 = 45
-SONY_DTF = 46
-DV_6mm = 47
-DMI = 48
-SONY_D2 = 49
-CLEANER_CARTRIDGE = 50
-CD_ROM = 51
-CD_R = 52
-CD_RW = 53
-DVD_ROM = 54
-DVD_R = 55
-DVD_RW = 56
-MO_3_RW = 57
-MO_5_WO = 58
-MO_5_RW = 59
-MO_5_LIMDOW = 60
-PC_5_WO = 61
-PC_5_RW = 62
-PD_5_RW = 63
-ABL_5_WO = 64
-PINNACLE_APEX_5_RW = 65
-SONY_12_WO = 66
-PHILIPS_12_WO = 67
-HITACHI_12_WO = 68
-CYGNET_12_WO = 69
-KODAK_14_WO = 70
-MO_NFR_525 = 71
-NIKON_12_RW = 72
-IOMEGA_ZIP = 73
-IOMEGA_JAZ = 74
-SYQUEST_EZ135 = 75
-SYQUEST_EZFLYER = 76
-SYQUEST_SYJET = 77
-AVATAR_F2 = 78
-MP2_8mm = 79
-DST_S = 80
-DST_M = 81
-DST_L = 82
-VXATape_1 = 83
-VXATape_2 = 84
-STK_9840 = 85
-LTO_Ultrium = 86
-LTO_Accelis = 87
-DVD_RAM = 88
-AIT_8mm = 89
-ADR_1 = 90
-ADR_2 = 91
-STK_9940 = 92
-
-## STORAGE_BUS_TYPE
-BusTypeUnknown = 0
-BusTypeScsi = 1
-BusTypeAtapi = 2
-BusTypeAta = 3
-BusType1394 = 4
-BusTypeSsa = 5
-BusTypeFibre = 6
-BusTypeUsb = 7
-BusTypeRAID = 8
-BusTypeiScsi = 9
-BusTypeSas = 10
-BusTypeSata = 11
-BusTypeMaxReserved = 127
-
-## MEDIA_TYPE
-Unknown = 0
-F5_1Pt2_512 = 1
-F3_1Pt44_512 = 2
-F3_2Pt88_512 = 3
-F3_20Pt8_512 = 4
-F3_720_512 = 5
-F5_360_512 = 6
-F5_320_512 = 7
-F5_320_1024 = 8
-F5_180_512 = 9
-F5_160_512 = 10
-RemovableMedia = 11
-FixedMedia = 12
-F3_120M_512 = 13
-F3_640_512 = 14
-F5_640_512 = 15
-F5_720_512 = 16
-F3_1Pt2_512 = 17
-F3_1Pt23_1024 = 18
-F5_1Pt23_1024 = 19
-F3_128Mb_512 = 20
-F3_230Mb_512 = 21
-F8_256_128 = 22
-F3_200Mb_512 = 23
-F3_240M_512 = 24
-F3_32M_512 = 25
-
-## PARTITION_STYLE
-PARTITION_STYLE_MBR = 0
-PARTITION_STYLE_GPT = 1
-PARTITION_STYLE_RAW = 2
-
-## DETECTION_TYPE
-DetectNone = 0
-DetectInt13 = 1
-DetectExInt13 = 2
-
-## DISK_CACHE_RETENTION_PRIORITY
-EqualPriority = 0
-KeepPrefetchedData = 1
-KeepReadData = 2
-
-## DISK_WRITE_CACHE_STATE - ?????? this enum has disappeared from winioctl.h in windows 2003 SP1 sdk ??????
-DiskWriteCacheNormal = 0
-DiskWriteCacheForceDisable = 1
-DiskWriteCacheDisableNotSupported = 2
-
-## BIN_TYPES
-RequestSize = 0
-RequestLocation = 1
-
-## CHANGER_DEVICE_PROBLEM_TYPE
-DeviceProblemNone = 0
-DeviceProblemHardware = 1
-DeviceProblemCHMError = 2
-DeviceProblemDoorOpen = 3
-DeviceProblemCalibrationError = 4
-DeviceProblemTargetFailure = 5
-DeviceProblemCHMMoveError = 6
-DeviceProblemCHMZeroError = 7
-DeviceProblemCartridgeInsertError = 8
-DeviceProblemPositionError = 9
-DeviceProblemSensorError = 10
-DeviceProblemCartridgeEjectError = 11
-DeviceProblemGripperError = 12
-DeviceProblemDriveError = 13
diff --git a/lib/win32/lib/winnt.py b/lib/win32/lib/winnt.py
deleted file mode 100644
index 2848794a..00000000
--- a/lib/win32/lib/winnt.py
+++ /dev/null
@@ -1,1371 +0,0 @@
-# Generated by h2py from \mssdk\include\winnt.h
-
-APPLICATION_ERROR_MASK = 536870912
-ERROR_SEVERITY_SUCCESS = 0
-ERROR_SEVERITY_INFORMATIONAL = 1073741824
-ERROR_SEVERITY_WARNING = -2147483648
-ERROR_SEVERITY_ERROR = -1073741824
-MINCHAR = 128
-MAXCHAR = 127
-MINSHORT = 32768
-MAXSHORT = 32767
-MINLONG = -2147483648
-MAXLONG = 2147483647
-MAXBYTE = 255
-MAXWORD = 65535
-MAXDWORD = -1
-LANG_NEUTRAL = 0
-LANG_AFRIKAANS = 54
-LANG_ALBANIAN = 28
-LANG_ARABIC = 1
-LANG_BASQUE = 45
-LANG_BELARUSIAN = 35
-LANG_BULGARIAN = 2
-LANG_CATALAN = 3
-LANG_CHINESE = 4
-LANG_CROATIAN = 26
-LANG_CZECH = 5
-LANG_DANISH = 6
-LANG_DUTCH = 19
-LANG_ENGLISH = 9
-LANG_ESTONIAN = 37
-LANG_FAEROESE = 56
-LANG_FARSI = 41
-LANG_FINNISH = 11
-LANG_FRENCH = 12
-LANG_GERMAN = 7
-LANG_GREEK = 8
-LANG_HEBREW = 13
-LANG_HINDI = 57
-LANG_HUNGARIAN = 14
-LANG_ICELANDIC = 15
-LANG_INDONESIAN = 33
-LANG_ITALIAN = 16
-LANG_JAPANESE = 17
-LANG_KOREAN = 18
-LANG_LATVIAN = 38
-LANG_LITHUANIAN = 39
-LANG_MACEDONIAN = 47
-LANG_MALAY = 62
-LANG_NORWEGIAN = 20
-LANG_POLISH = 21
-LANG_PORTUGUESE = 22
-LANG_ROMANIAN = 24
-LANG_RUSSIAN = 25
-LANG_SERBIAN = 26
-LANG_SLOVAK = 27
-LANG_SLOVENIAN = 36
-LANG_SPANISH = 10
-LANG_SWAHILI = 65
-LANG_SWEDISH = 29
-LANG_THAI = 30
-LANG_TURKISH = 31
-LANG_UKRAINIAN = 34
-LANG_VIETNAMESE = 42
-SUBLANG_NEUTRAL = 0
-SUBLANG_DEFAULT = 1
-SUBLANG_SYS_DEFAULT = 2
-SUBLANG_ARABIC_SAUDI_ARABIA = 1
-SUBLANG_ARABIC_IRAQ = 2
-SUBLANG_ARABIC_EGYPT = 3
-SUBLANG_ARABIC_LIBYA = 4
-SUBLANG_ARABIC_ALGERIA = 5
-SUBLANG_ARABIC_MOROCCO = 6
-SUBLANG_ARABIC_TUNISIA = 7
-SUBLANG_ARABIC_OMAN = 8
-SUBLANG_ARABIC_YEMEN = 9
-SUBLANG_ARABIC_SYRIA = 10
-SUBLANG_ARABIC_JORDAN = 11
-SUBLANG_ARABIC_LEBANON = 12
-SUBLANG_ARABIC_KUWAIT = 13
-SUBLANG_ARABIC_UAE = 14
-SUBLANG_ARABIC_BAHRAIN = 15
-SUBLANG_ARABIC_QATAR = 16
-SUBLANG_CHINESE_TRADITIONAL = 1
-SUBLANG_CHINESE_SIMPLIFIED = 2
-SUBLANG_CHINESE_HONGKONG = 3
-SUBLANG_CHINESE_SINGAPORE = 4
-SUBLANG_CHINESE_MACAU = 5
-SUBLANG_DUTCH = 1
-SUBLANG_DUTCH_BELGIAN = 2
-SUBLANG_ENGLISH_US = 1
-SUBLANG_ENGLISH_UK = 2
-SUBLANG_ENGLISH_AUS = 3
-SUBLANG_ENGLISH_CAN = 4
-SUBLANG_ENGLISH_NZ = 5
-SUBLANG_ENGLISH_EIRE = 6
-SUBLANG_ENGLISH_SOUTH_AFRICA = 7
-SUBLANG_ENGLISH_JAMAICA = 8
-SUBLANG_ENGLISH_CARIBBEAN = 9
-SUBLANG_ENGLISH_BELIZE = 10
-SUBLANG_ENGLISH_TRINIDAD = 11
-SUBLANG_ENGLISH_ZIMBABWE = 12
-SUBLANG_ENGLISH_PHILIPPINES = 13
-SUBLANG_FRENCH = 1
-SUBLANG_FRENCH_BELGIAN = 2
-SUBLANG_FRENCH_CANADIAN = 3
-SUBLANG_FRENCH_SWISS = 4
-SUBLANG_FRENCH_LUXEMBOURG = 5
-SUBLANG_FRENCH_MONACO = 6
-SUBLANG_GERMAN = 1
-SUBLANG_GERMAN_SWISS = 2
-SUBLANG_GERMAN_AUSTRIAN = 3
-SUBLANG_GERMAN_LUXEMBOURG = 4
-SUBLANG_GERMAN_LIECHTENSTEIN = 5
-SUBLANG_ITALIAN = 1
-SUBLANG_ITALIAN_SWISS = 2
-SUBLANG_KOREAN = 1
-SUBLANG_KOREAN_JOHAB = 2
-SUBLANG_LITHUANIAN = 1
-SUBLANG_LITHUANIAN_CLASSIC = 2
-SUBLANG_MALAY_MALAYSIA = 1
-SUBLANG_MALAY_BRUNEI_DARUSSALAM = 2
-SUBLANG_NORWEGIAN_BOKMAL = 1
-SUBLANG_NORWEGIAN_NYNORSK = 2
-SUBLANG_PORTUGUESE = 2
-SUBLANG_PORTUGUESE_BRAZILIAN = 1
-SUBLANG_SERBIAN_LATIN = 2
-SUBLANG_SERBIAN_CYRILLIC = 3
-SUBLANG_SPANISH = 1
-SUBLANG_SPANISH_MEXICAN = 2
-SUBLANG_SPANISH_MODERN = 3
-SUBLANG_SPANISH_GUATEMALA = 4
-SUBLANG_SPANISH_COSTA_RICA = 5
-SUBLANG_SPANISH_PANAMA = 6
-SUBLANG_SPANISH_DOMINICAN_REPUBLIC = 7
-SUBLANG_SPANISH_VENEZUELA = 8
-SUBLANG_SPANISH_COLOMBIA = 9
-SUBLANG_SPANISH_PERU = 10
-SUBLANG_SPANISH_ARGENTINA = 11
-SUBLANG_SPANISH_ECUADOR = 12
-SUBLANG_SPANISH_CHILE = 13
-SUBLANG_SPANISH_URUGUAY = 14
-SUBLANG_SPANISH_PARAGUAY = 15
-SUBLANG_SPANISH_BOLIVIA = 16
-SUBLANG_SPANISH_EL_SALVADOR = 17
-SUBLANG_SPANISH_HONDURAS = 18
-SUBLANG_SPANISH_NICARAGUA = 19
-SUBLANG_SPANISH_PUERTO_RICO = 20
-SUBLANG_SWEDISH = 1
-SUBLANG_SWEDISH_FINLAND = 2
-SORT_DEFAULT = 0
-SORT_JAPANESE_XJIS = 0
-SORT_JAPANESE_UNICODE = 1
-SORT_CHINESE_BIG5 = 0
-SORT_CHINESE_PRCP = 0
-SORT_CHINESE_UNICODE = 1
-SORT_CHINESE_PRC = 2
-SORT_KOREAN_KSC = 0
-SORT_KOREAN_UNICODE = 1
-SORT_GERMAN_PHONE_BOOK = 1
-
-
-def PRIMARYLANGID(lgid):
-    return (WORD)(lgid) & 1023
-
-
-def SUBLANGID(lgid):
-    return (WORD)(lgid) >> 10
-
-
-NLS_VALID_LOCALE_MASK = 1048575
-
-
-def LANGIDFROMLCID(lcid):
-    return (WORD)(lcid)
-
-
-def SORTIDFROMLCID(lcid):
-    return (WORD)((((DWORD)(lcid)) & NLS_VALID_LOCALE_MASK) >> 16)
-
-
-def UNREFERENCED_PARAMETER(P):
-    return P
-
-
-def DBG_UNREFERENCED_PARAMETER(P):
-    return P
-
-
-def DBG_UNREFERENCED_LOCAL_VARIABLE(V):
-    return V
-
-
-def UNREFERENCED_PARAMETER(P):
-    return
-
-
-def DBG_UNREFERENCED_PARAMETER(P):
-    return
-
-
-def DBG_UNREFERENCED_LOCAL_VARIABLE(V):
-    return
-
-
-MAXIMUM_WAIT_OBJECTS = 64
-MAXIMUM_SUSPEND_COUNT = MAXCHAR
-
-EXCEPTION_NONCONTINUABLE = 1
-EXCEPTION_MAXIMUM_PARAMETERS = 15
-PROCESS_TERMINATE = 1
-PROCESS_CREATE_THREAD = 2
-PROCESS_VM_OPERATION = 8
-PROCESS_VM_READ = 16
-PROCESS_VM_WRITE = 32
-PROCESS_DUP_HANDLE = 64
-PROCESS_CREATE_PROCESS = 128
-PROCESS_SET_QUOTA = 256
-PROCESS_SET_INFORMATION = 512
-PROCESS_QUERY_INFORMATION = 1024
-PROCESS_SUSPEND_RESUME = 2048
-PROCESS_QUERY_LIMITED_INFORMATION = 4096
-PROCESS_SET_LIMITED_INFORMATION = 8192
-MAXIMUM_PROCESSORS = 32
-THREAD_TERMINATE = 1
-THREAD_SUSPEND_RESUME = 2
-THREAD_GET_CONTEXT = 8
-THREAD_SET_CONTEXT = 16
-THREAD_SET_INFORMATION = 32
-THREAD_QUERY_INFORMATION = 64
-THREAD_SET_THREAD_TOKEN = 128
-THREAD_IMPERSONATE = 256
-THREAD_DIRECT_IMPERSONATION = 512
-THREAD_SET_LIMITED_INFORMATION = 1024
-THREAD_QUERY_LIMITED_INFORMATION = 2048
-THREAD_RESUME = 4096
-JOB_OBJECT_ASSIGN_PROCESS = 1
-JOB_OBJECT_SET_ATTRIBUTES = 2
-JOB_OBJECT_QUERY = 4
-JOB_OBJECT_TERMINATE = 8
-TLS_MINIMUM_AVAILABLE = 64
-THREAD_BASE_PRIORITY_LOWRT = 15
-THREAD_BASE_PRIORITY_MAX = 2
-THREAD_BASE_PRIORITY_MIN = -2
-THREAD_BASE_PRIORITY_IDLE = -15
-JOB_OBJECT_LIMIT_WORKINGSET = 1
-JOB_OBJECT_LIMIT_PROCESS_TIME = 2
-JOB_OBJECT_LIMIT_JOB_TIME = 4
-JOB_OBJECT_LIMIT_ACTIVE_PROCESS = 8
-JOB_OBJECT_LIMIT_AFFINITY = 16
-JOB_OBJECT_LIMIT_PRIORITY_CLASS = 32
-JOB_OBJECT_LIMIT_VALID_FLAGS = 63
-EVENT_MODIFY_STATE = 2
-MUTANT_QUERY_STATE = 1
-SEMAPHORE_MODIFY_STATE = 2
-TIME_ZONE_ID_UNKNOWN = 0
-TIME_ZONE_ID_STANDARD = 1
-TIME_ZONE_ID_DAYLIGHT = 2
-PROCESSOR_INTEL_386 = 386
-PROCESSOR_INTEL_486 = 486
-PROCESSOR_INTEL_PENTIUM = 586
-PROCESSOR_MIPS_R4000 = 4000
-PROCESSOR_ALPHA_21064 = 21064
-PROCESSOR_HITACHI_SH3 = 10003
-PROCESSOR_HITACHI_SH3E = 10004
-PROCESSOR_HITACHI_SH4 = 10005
-PROCESSOR_MOTOROLA_821 = 821
-PROCESSOR_ARM_7TDMI = 70001
-PROCESSOR_ARCHITECTURE_INTEL = 0
-PROCESSOR_ARCHITECTURE_MIPS = 1
-PROCESSOR_ARCHITECTURE_ALPHA = 2
-PROCESSOR_ARCHITECTURE_PPC = 3
-PROCESSOR_ARCHITECTURE_SH = 4
-PROCESSOR_ARCHITECTURE_ARM = 5
-PROCESSOR_ARCHITECTURE_IA64 = 6
-PROCESSOR_ARCHITECTURE_ALPHA64 = 7
-PROCESSOR_ARCHITECTURE_MSIL = 8
-PROCESSOR_ARCHITECTURE_AMD64 = 9
-PROCESSOR_ARCHITECTURE_IA32_ON_WIN64 = 10
-PROCESSOR_ARCHITECTURE_UNKNOWN = 65535
-PF_FLOATING_POINT_PRECISION_ERRATA = 0
-PF_FLOATING_POINT_EMULATED = 1
-PF_COMPARE_EXCHANGE_DOUBLE = 2
-PF_MMX_INSTRUCTIONS_AVAILABLE = 3
-PF_PPC_MOVEMEM_64BIT_OK = 4
-PF_ALPHA_BYTE_INSTRUCTIONS = 5
-SECTION_QUERY = 1
-SECTION_MAP_WRITE = 2
-SECTION_MAP_READ = 4
-SECTION_MAP_EXECUTE = 8
-SECTION_EXTEND_SIZE = 16
-PAGE_NOACCESS = 1
-PAGE_READONLY = 2
-PAGE_READWRITE = 4
-PAGE_WRITECOPY = 8
-PAGE_EXECUTE = 16
-PAGE_EXECUTE_READ = 32
-PAGE_EXECUTE_READWRITE = 64
-PAGE_EXECUTE_WRITECOPY = 128
-PAGE_GUARD = 256
-PAGE_NOCACHE = 512
-MEM_COMMIT = 4096
-MEM_RESERVE = 8192
-MEM_DECOMMIT = 16384
-MEM_RELEASE = 32768
-MEM_FREE = 65536
-MEM_PRIVATE = 131072
-MEM_MAPPED = 262144
-MEM_RESET = 524288
-MEM_TOP_DOWN = 1048576
-MEM_4MB_PAGES = -2147483648
-SEC_FILE = 8388608
-SEC_IMAGE = 16777216
-SEC_VLM = 33554432
-SEC_RESERVE = 67108864
-SEC_COMMIT = 134217728
-SEC_NOCACHE = 268435456
-MEM_IMAGE = SEC_IMAGE
-FILE_READ_DATA = 1
-FILE_LIST_DIRECTORY = 1
-FILE_WRITE_DATA = 2
-FILE_ADD_FILE = 2
-FILE_APPEND_DATA = 4
-FILE_ADD_SUBDIRECTORY = 4
-FILE_CREATE_PIPE_INSTANCE = 4
-FILE_READ_EA = 8
-FILE_WRITE_EA = 16
-FILE_EXECUTE = 32
-FILE_TRAVERSE = 32
-FILE_DELETE_CHILD = 64
-FILE_READ_ATTRIBUTES = 128
-FILE_WRITE_ATTRIBUTES = 256
-FILE_SHARE_READ = 1
-FILE_SHARE_WRITE = 2
-FILE_SHARE_DELETE = 4
-FILE_ATTRIBUTE_READONLY = 1
-FILE_ATTRIBUTE_HIDDEN = 2
-FILE_ATTRIBUTE_SYSTEM = 4
-FILE_ATTRIBUTE_DIRECTORY = 16
-FILE_ATTRIBUTE_ARCHIVE = 32
-FILE_ATTRIBUTE_DEVICE = 64
-FILE_ATTRIBUTE_NORMAL = 128
-FILE_ATTRIBUTE_TEMPORARY = 256
-FILE_ATTRIBUTE_SPARSE_FILE = 512
-FILE_ATTRIBUTE_REPARSE_POINT = 1024
-FILE_ATTRIBUTE_COMPRESSED = 2048
-FILE_ATTRIBUTE_OFFLINE = 4096
-FILE_ATTRIBUTE_NOT_CONTENT_INDEXED = 8192
-FILE_ATTRIBUTE_ENCRYPTED = 16384
-FILE_ATTRIBUTE_VIRTUAL = 65536
-FILE_NOTIFY_CHANGE_FILE_NAME = 1
-FILE_NOTIFY_CHANGE_DIR_NAME = 2
-FILE_NOTIFY_CHANGE_ATTRIBUTES = 4
-FILE_NOTIFY_CHANGE_SIZE = 8
-FILE_NOTIFY_CHANGE_LAST_WRITE = 16
-FILE_NOTIFY_CHANGE_LAST_ACCESS = 32
-FILE_NOTIFY_CHANGE_CREATION = 64
-FILE_NOTIFY_CHANGE_SECURITY = 256
-FILE_ACTION_ADDED = 1
-FILE_ACTION_REMOVED = 2
-FILE_ACTION_MODIFIED = 3
-FILE_ACTION_RENAMED_OLD_NAME = 4
-FILE_ACTION_RENAMED_NEW_NAME = 5
-FILE_CASE_SENSITIVE_SEARCH = 1
-FILE_CASE_PRESERVED_NAMES = 2
-FILE_UNICODE_ON_DISK = 4
-FILE_PERSISTENT_ACLS = 8
-FILE_FILE_COMPRESSION = 16
-FILE_VOLUME_QUOTAS = 32
-FILE_SUPPORTS_SPARSE_FILES = 64
-FILE_SUPPORTS_REPARSE_POINTS = 128
-FILE_SUPPORTS_REMOTE_STORAGE = 256
-FILE_VOLUME_IS_COMPRESSED = 32768
-FILE_SUPPORTS_OBJECT_IDS = 65536
-FILE_SUPPORTS_ENCRYPTION = 131072
-
-MAXIMUM_REPARSE_DATA_BUFFER_SIZE = 16 * 1024
-IO_REPARSE_TAG_RESERVED_ZERO = 0
-IO_REPARSE_TAG_RESERVED_ONE = 1
-IO_REPARSE_TAG_SYMBOLIC_LINK = 2
-IO_REPARSE_TAG_NSS = 5
-IO_REPARSE_TAG_FILTER_MANAGER = -2147483637
-IO_REPARSE_TAG_DFS = -2147483638
-IO_REPARSE_TAG_SIS = -2147483641
-IO_REPARSE_TAG_MOUNT_POINT = -1610612733
-IO_REPARSE_TAG_HSM = -1073741820
-IO_REPARSE_TAG_NSSRECOVER = 8
-IO_REPARSE_TAG_RESERVED_MS_RANGE = 256
-IO_REPARSE_TAG_RESERVED_RANGE = IO_REPARSE_TAG_RESERVED_ONE
-IO_COMPLETION_MODIFY_STATE = 2
-
-DUPLICATE_CLOSE_SOURCE = 1
-DUPLICATE_SAME_ACCESS = 2
-DELETE = 65536
-READ_CONTROL = 131072
-WRITE_DAC = 262144
-WRITE_OWNER = 524288
-SYNCHRONIZE = 1048576
-STANDARD_RIGHTS_REQUIRED = 983040
-STANDARD_RIGHTS_READ = READ_CONTROL
-STANDARD_RIGHTS_WRITE = READ_CONTROL
-STANDARD_RIGHTS_EXECUTE = READ_CONTROL
-STANDARD_RIGHTS_ALL = 2031616
-SPECIFIC_RIGHTS_ALL = 65535
-IO_COMPLETION_ALL_ACCESS = STANDARD_RIGHTS_REQUIRED | SYNCHRONIZE | 0x3
-ACCESS_SYSTEM_SECURITY = 16777216
-MAXIMUM_ALLOWED = 33554432
-GENERIC_READ = -2147483648
-GENERIC_WRITE = 1073741824
-GENERIC_EXECUTE = 536870912
-GENERIC_ALL = 268435456
-
-# Included from pshpack4.h
-
-# Included from poppack.h
-SID_REVISION = 1
-SID_MAX_SUB_AUTHORITIES = 15
-SID_RECOMMENDED_SUB_AUTHORITIES = 1
-
-SidTypeUser = 1
-SidTypeGroup = 2
-SidTypeDomain = 3
-SidTypeAlias = 4
-SidTypeWellKnownGroup = 5
-SidTypeDeletedAccount = 6
-SidTypeInvalid = 7
-SidTypeUnknown = 8
-
-SECURITY_NULL_RID = 0
-SECURITY_WORLD_RID = 0
-SECURITY_LOCAL_RID = 0x00000000
-SECURITY_CREATOR_OWNER_RID = 0
-SECURITY_CREATOR_GROUP_RID = 1
-SECURITY_CREATOR_OWNER_SERVER_RID = 2
-SECURITY_CREATOR_GROUP_SERVER_RID = 3
-SECURITY_DIALUP_RID = 1
-SECURITY_NETWORK_RID = 2
-SECURITY_BATCH_RID = 3
-SECURITY_INTERACTIVE_RID = 4
-SECURITY_SERVICE_RID = 6
-SECURITY_ANONYMOUS_LOGON_RID = 7
-SECURITY_PROXY_RID = 8
-SECURITY_SERVER_LOGON_RID = 9
-SECURITY_PRINCIPAL_SELF_RID = 10
-SECURITY_AUTHENTICATED_USER_RID = 11
-SECURITY_LOGON_IDS_RID = 5
-SECURITY_LOGON_IDS_RID_COUNT = 3
-SECURITY_LOCAL_SYSTEM_RID = 18
-SECURITY_NT_NON_UNIQUE = 21
-SECURITY_BUILTIN_DOMAIN_RID = 32
-DOMAIN_USER_RID_ADMIN = 500
-DOMAIN_USER_RID_GUEST = 501
-DOMAIN_GROUP_RID_ADMINS = 512
-DOMAIN_GROUP_RID_USERS = 513
-DOMAIN_GROUP_RID_GUESTS = 514
-DOMAIN_ALIAS_RID_ADMINS = 544
-DOMAIN_ALIAS_RID_USERS = 545
-DOMAIN_ALIAS_RID_GUESTS = 546
-DOMAIN_ALIAS_RID_POWER_USERS = 547
-DOMAIN_ALIAS_RID_ACCOUNT_OPS = 548
-DOMAIN_ALIAS_RID_SYSTEM_OPS = 549
-DOMAIN_ALIAS_RID_PRINT_OPS = 550
-DOMAIN_ALIAS_RID_BACKUP_OPS = 551
-DOMAIN_ALIAS_RID_REPLICATOR = 552
-SE_GROUP_MANDATORY = 1
-SE_GROUP_ENABLED_BY_DEFAULT = 2
-SE_GROUP_ENABLED = 4
-SE_GROUP_OWNER = 8
-SE_GROUP_LOGON_ID = -1073741824
-ACL_REVISION = 2
-ACL_REVISION_DS = 4
-ACL_REVISION1 = 1
-ACL_REVISION2 = 2
-ACL_REVISION3 = 3
-ACL_REVISION4 = 4
-MAX_ACL_REVISION = ACL_REVISION4
-
-## ACE types
-ACCESS_MIN_MS_ACE_TYPE = 0
-ACCESS_ALLOWED_ACE_TYPE = 0
-ACCESS_DENIED_ACE_TYPE = 1
-SYSTEM_AUDIT_ACE_TYPE = 2
-SYSTEM_ALARM_ACE_TYPE = 3
-ACCESS_MAX_MS_V2_ACE_TYPE = 3
-ACCESS_ALLOWED_COMPOUND_ACE_TYPE = 4
-ACCESS_MAX_MS_V3_ACE_TYPE = 4
-ACCESS_MIN_MS_OBJECT_ACE_TYPE = 5
-ACCESS_ALLOWED_OBJECT_ACE_TYPE = 5
-ACCESS_DENIED_OBJECT_ACE_TYPE = 6
-SYSTEM_AUDIT_OBJECT_ACE_TYPE = 7
-SYSTEM_ALARM_OBJECT_ACE_TYPE = 8
-ACCESS_MAX_MS_OBJECT_ACE_TYPE = 8
-ACCESS_MAX_MS_V4_ACE_TYPE = 8
-ACCESS_MAX_MS_ACE_TYPE = 8
-ACCESS_ALLOWED_CALLBACK_ACE_TYPE = 9
-ACCESS_DENIED_CALLBACK_ACE_TYPE = 10
-ACCESS_ALLOWED_CALLBACK_OBJECT_ACE_TYPE = 11
-ACCESS_DENIED_CALLBACK_OBJECT_ACE_TYPE = 12
-SYSTEM_AUDIT_CALLBACK_ACE_TYPE = 13
-SYSTEM_ALARM_CALLBACK_ACE_TYPE = 14
-SYSTEM_AUDIT_CALLBACK_OBJECT_ACE_TYPE = 15
-SYSTEM_ALARM_CALLBACK_OBJECT_ACE_TYPE = 16
-SYSTEM_MANDATORY_LABEL_ACE_TYPE = 17
-ACCESS_MAX_MS_V5_ACE_TYPE = 17
-
-## ACE inheritance flags
-OBJECT_INHERIT_ACE = 1
-CONTAINER_INHERIT_ACE = 2
-NO_PROPAGATE_INHERIT_ACE = 4
-INHERIT_ONLY_ACE = 8
-INHERITED_ACE = 16
-VALID_INHERIT_FLAGS = 31
-
-
-SUCCESSFUL_ACCESS_ACE_FLAG = 64
-FAILED_ACCESS_ACE_FLAG = 128
-ACE_OBJECT_TYPE_PRESENT = 1
-ACE_INHERITED_OBJECT_TYPE_PRESENT = 2
-SECURITY_DESCRIPTOR_REVISION = 1
-SECURITY_DESCRIPTOR_REVISION1 = 1
-SECURITY_DESCRIPTOR_MIN_LENGTH = 20
-SE_OWNER_DEFAULTED = 1
-SE_GROUP_DEFAULTED = 2
-SE_DACL_PRESENT = 4
-SE_DACL_DEFAULTED = 8
-SE_SACL_PRESENT = 16
-SE_SACL_DEFAULTED = 32
-SE_DACL_AUTO_INHERIT_REQ = 256
-SE_SACL_AUTO_INHERIT_REQ = 512
-SE_DACL_AUTO_INHERITED = 1024
-SE_SACL_AUTO_INHERITED = 2048
-SE_DACL_PROTECTED = 4096
-SE_SACL_PROTECTED = 8192
-SE_SELF_RELATIVE = 32768
-ACCESS_OBJECT_GUID = 0
-ACCESS_PROPERTY_SET_GUID = 1
-ACCESS_PROPERTY_GUID = 2
-ACCESS_MAX_LEVEL = 4
-AUDIT_ALLOW_NO_PRIVILEGE = 1
-ACCESS_DS_SOURCE_A = "Directory Service"
-ACCESS_DS_OBJECT_TYPE_NAME_A = "Directory Service Object"
-SE_PRIVILEGE_ENABLED_BY_DEFAULT = 1
-SE_PRIVILEGE_ENABLED = 2
-SE_PRIVILEGE_USED_FOR_ACCESS = -2147483648
-PRIVILEGE_SET_ALL_NECESSARY = 1
-
-SE_CREATE_TOKEN_NAME = "SeCreateTokenPrivilege"
-SE_ASSIGNPRIMARYTOKEN_NAME = "SeAssignPrimaryTokenPrivilege"
-SE_LOCK_MEMORY_NAME = "SeLockMemoryPrivilege"
-SE_INCREASE_QUOTA_NAME = "SeIncreaseQuotaPrivilege"
-SE_UNSOLICITED_INPUT_NAME = "SeUnsolicitedInputPrivilege"
-SE_MACHINE_ACCOUNT_NAME = "SeMachineAccountPrivilege"
-SE_TCB_NAME = "SeTcbPrivilege"
-SE_SECURITY_NAME = "SeSecurityPrivilege"
-SE_TAKE_OWNERSHIP_NAME = "SeTakeOwnershipPrivilege"
-SE_LOAD_DRIVER_NAME = "SeLoadDriverPrivilege"
-SE_SYSTEM_PROFILE_NAME = "SeSystemProfilePrivilege"
-SE_SYSTEMTIME_NAME = "SeSystemtimePrivilege"
-SE_PROF_SINGLE_PROCESS_NAME = "SeProfileSingleProcessPrivilege"
-SE_INC_BASE_PRIORITY_NAME = "SeIncreaseBasePriorityPrivilege"
-SE_CREATE_PAGEFILE_NAME = "SeCreatePagefilePrivilege"
-SE_CREATE_PERMANENT_NAME = "SeCreatePermanentPrivilege"
-SE_BACKUP_NAME = "SeBackupPrivilege"
-SE_RESTORE_NAME = "SeRestorePrivilege"
-SE_SHUTDOWN_NAME = "SeShutdownPrivilege"
-SE_DEBUG_NAME = "SeDebugPrivilege"
-SE_AUDIT_NAME = "SeAuditPrivilege"
-SE_SYSTEM_ENVIRONMENT_NAME = "SeSystemEnvironmentPrivilege"
-SE_CHANGE_NOTIFY_NAME = "SeChangeNotifyPrivilege"
-SE_REMOTE_SHUTDOWN_NAME = "SeRemoteShutdownPrivilege"
-TOKEN_ASSIGN_PRIMARY = 1
-TOKEN_DUPLICATE = 2
-TOKEN_IMPERSONATE = 4
-TOKEN_QUERY = 8
-TOKEN_QUERY_SOURCE = 16
-TOKEN_ADJUST_PRIVILEGES = 32
-TOKEN_ADJUST_GROUPS = 64
-TOKEN_ADJUST_DEFAULT = 128
-TOKEN_ALL_ACCESS = (
-    STANDARD_RIGHTS_REQUIRED
-    | TOKEN_ASSIGN_PRIMARY
-    | TOKEN_DUPLICATE
-    | TOKEN_IMPERSONATE
-    | TOKEN_QUERY
-    | TOKEN_QUERY_SOURCE
-    | TOKEN_ADJUST_PRIVILEGES
-    | TOKEN_ADJUST_GROUPS
-    | TOKEN_ADJUST_DEFAULT
-)
-TOKEN_READ = STANDARD_RIGHTS_READ | TOKEN_QUERY
-TOKEN_WRITE = (
-    STANDARD_RIGHTS_WRITE
-    | TOKEN_ADJUST_PRIVILEGES
-    | TOKEN_ADJUST_GROUPS
-    | TOKEN_ADJUST_DEFAULT
-)
-TOKEN_EXECUTE = STANDARD_RIGHTS_EXECUTE
-TOKEN_SOURCE_LENGTH = 8
-
-# Token types
-TokenPrimary = 1
-TokenImpersonation = 2
-
-# TOKEN_INFORMATION_CLASS, used with Get/SetTokenInformation
-TokenUser = 1
-TokenGroups = 2
-TokenPrivileges = 3
-TokenOwner = 4
-TokenPrimaryGroup = 5
-TokenDefaultDacl = 6
-TokenSource = 7
-TokenType = 8
-TokenImpersonationLevel = 9
-TokenStatistics = 10
-TokenRestrictedSids = 11
-TokenSessionId = 12
-TokenGroupsAndPrivileges = 13
-TokenSessionReference = 14
-TokenSandBoxInert = 15
-TokenAuditPolicy = 16
-TokenOrigin = 17
-TokenElevationType = 18
-TokenLinkedToken = 19
-TokenElevation = 20
-TokenHasRestrictions = 21
-TokenAccessInformation = 22
-TokenVirtualizationAllowed = 23
-TokenVirtualizationEnabled = 24
-TokenIntegrityLevel = 25
-TokenUIAccess = 26
-TokenMandatoryPolicy = 27
-TokenLogonSid = 28
-
-OWNER_SECURITY_INFORMATION = 0x00000001
-GROUP_SECURITY_INFORMATION = 0x00000002
-DACL_SECURITY_INFORMATION = 0x00000004
-SACL_SECURITY_INFORMATION = 0x00000008
-LABEL_SECURITY_INFORMATION = 0x00000010
-
-IMAGE_DOS_SIGNATURE = 23117
-IMAGE_OS2_SIGNATURE = 17742
-IMAGE_OS2_SIGNATURE_LE = 17740
-IMAGE_VXD_SIGNATURE = 17740
-IMAGE_NT_SIGNATURE = 17744
-IMAGE_SIZEOF_FILE_HEADER = 20
-IMAGE_FILE_RELOCS_STRIPPED = 1
-IMAGE_FILE_EXECUTABLE_IMAGE = 2
-IMAGE_FILE_LINE_NUMS_STRIPPED = 4
-IMAGE_FILE_LOCAL_SYMS_STRIPPED = 8
-IMAGE_FILE_AGGRESIVE_WS_TRIM = 16
-IMAGE_FILE_LARGE_ADDRESS_AWARE = 32
-IMAGE_FILE_BYTES_REVERSED_LO = 128
-IMAGE_FILE_32BIT_MACHINE = 256
-IMAGE_FILE_DEBUG_STRIPPED = 512
-IMAGE_FILE_REMOVABLE_RUN_FROM_SWAP = 1024
-IMAGE_FILE_NET_RUN_FROM_SWAP = 2048
-IMAGE_FILE_SYSTEM = 4096
-IMAGE_FILE_DLL = 8192
-IMAGE_FILE_UP_SYSTEM_ONLY = 16384
-IMAGE_FILE_BYTES_REVERSED_HI = 32768
-IMAGE_FILE_MACHINE_UNKNOWN = 0
-IMAGE_FILE_MACHINE_I386 = 332
-IMAGE_FILE_MACHINE_R3000 = 354
-IMAGE_FILE_MACHINE_R4000 = 358
-IMAGE_FILE_MACHINE_R10000 = 360
-IMAGE_FILE_MACHINE_WCEMIPSV2 = 361
-IMAGE_FILE_MACHINE_ALPHA = 388
-IMAGE_FILE_MACHINE_POWERPC = 496
-IMAGE_FILE_MACHINE_SH3 = 418
-IMAGE_FILE_MACHINE_SH3E = 420
-IMAGE_FILE_MACHINE_SH4 = 422
-IMAGE_FILE_MACHINE_ARM = 448
-IMAGE_NUMBEROF_DIRECTORY_ENTRIES = 16
-IMAGE_SIZEOF_ROM_OPTIONAL_HEADER = 56
-IMAGE_SIZEOF_STD_OPTIONAL_HEADER = 28
-IMAGE_SIZEOF_NT_OPTIONAL_HEADER = 224
-IMAGE_NT_OPTIONAL_HDR_MAGIC = 267
-IMAGE_ROM_OPTIONAL_HDR_MAGIC = 263
-IMAGE_SUBSYSTEM_UNKNOWN = 0
-IMAGE_SUBSYSTEM_NATIVE = 1
-IMAGE_SUBSYSTEM_WINDOWS_GUI = 2
-IMAGE_SUBSYSTEM_WINDOWS_CUI = 3
-IMAGE_SUBSYSTEM_WINDOWS_CE_GUI = 4
-IMAGE_SUBSYSTEM_OS2_CUI = 5
-IMAGE_SUBSYSTEM_POSIX_CUI = 7
-IMAGE_SUBSYSTEM_RESERVED8 = 8
-IMAGE_DLLCHARACTERISTICS_WDM_DRIVER = 8192
-IMAGE_DIRECTORY_ENTRY_EXPORT = 0
-IMAGE_DIRECTORY_ENTRY_IMPORT = 1
-IMAGE_DIRECTORY_ENTRY_RESOURCE = 2
-IMAGE_DIRECTORY_ENTRY_EXCEPTION = 3
-IMAGE_DIRECTORY_ENTRY_SECURITY = 4
-IMAGE_DIRECTORY_ENTRY_BASERELOC = 5
-IMAGE_DIRECTORY_ENTRY_DEBUG = 6
-IMAGE_DIRECTORY_ENTRY_COPYRIGHT = 7
-IMAGE_DIRECTORY_ENTRY_GLOBALPTR = 8
-IMAGE_DIRECTORY_ENTRY_TLS = 9
-IMAGE_DIRECTORY_ENTRY_LOAD_CONFIG = 10
-IMAGE_DIRECTORY_ENTRY_BOUND_IMPORT = 11
-IMAGE_DIRECTORY_ENTRY_IAT = 12
-IMAGE_SIZEOF_SHORT_NAME = 8
-IMAGE_SIZEOF_SECTION_HEADER = 40
-IMAGE_SCN_TYPE_NO_PAD = 8
-IMAGE_SCN_CNT_CODE = 32
-IMAGE_SCN_CNT_INITIALIZED_DATA = 64
-IMAGE_SCN_CNT_UNINITIALIZED_DATA = 128
-IMAGE_SCN_LNK_OTHER = 256
-IMAGE_SCN_LNK_INFO = 512
-IMAGE_SCN_LNK_REMOVE = 2048
-IMAGE_SCN_LNK_COMDAT = 4096
-IMAGE_SCN_MEM_FARDATA = 32768
-IMAGE_SCN_MEM_PURGEABLE = 131072
-IMAGE_SCN_MEM_16BIT = 131072
-IMAGE_SCN_MEM_LOCKED = 262144
-IMAGE_SCN_MEM_PRELOAD = 524288
-IMAGE_SCN_ALIGN_1BYTES = 1048576
-IMAGE_SCN_ALIGN_2BYTES = 2097152
-IMAGE_SCN_ALIGN_4BYTES = 3145728
-IMAGE_SCN_ALIGN_8BYTES = 4194304
-IMAGE_SCN_ALIGN_16BYTES = 5242880
-IMAGE_SCN_ALIGN_32BYTES = 6291456
-IMAGE_SCN_ALIGN_64BYTES = 7340032
-IMAGE_SCN_LNK_NRELOC_OVFL = 16777216
-IMAGE_SCN_MEM_DISCARDABLE = 33554432
-IMAGE_SCN_MEM_NOT_CACHED = 67108864
-IMAGE_SCN_MEM_NOT_PAGED = 134217728
-IMAGE_SCN_MEM_SHARED = 268435456
-IMAGE_SCN_MEM_EXECUTE = 536870912
-IMAGE_SCN_MEM_READ = 1073741824
-IMAGE_SCN_MEM_WRITE = -2147483648
-IMAGE_SCN_SCALE_INDEX = 1
-IMAGE_SIZEOF_SYMBOL = 18
-IMAGE_SYM_TYPE_NULL = 0
-IMAGE_SYM_TYPE_VOID = 1
-IMAGE_SYM_TYPE_CHAR = 2
-IMAGE_SYM_TYPE_SHORT = 3
-IMAGE_SYM_TYPE_INT = 4
-IMAGE_SYM_TYPE_LONG = 5
-IMAGE_SYM_TYPE_FLOAT = 6
-IMAGE_SYM_TYPE_DOUBLE = 7
-IMAGE_SYM_TYPE_STRUCT = 8
-IMAGE_SYM_TYPE_UNION = 9
-IMAGE_SYM_TYPE_ENUM = 10
-IMAGE_SYM_TYPE_MOE = 11
-IMAGE_SYM_TYPE_BYTE = 12
-IMAGE_SYM_TYPE_WORD = 13
-IMAGE_SYM_TYPE_UINT = 14
-IMAGE_SYM_TYPE_DWORD = 15
-IMAGE_SYM_TYPE_PCODE = 32768
-IMAGE_SYM_DTYPE_NULL = 0
-IMAGE_SYM_DTYPE_POINTER = 1
-IMAGE_SYM_DTYPE_FUNCTION = 2
-IMAGE_SYM_DTYPE_ARRAY = 3
-IMAGE_SYM_CLASS_NULL = 0
-IMAGE_SYM_CLASS_AUTOMATIC = 1
-IMAGE_SYM_CLASS_EXTERNAL = 2
-IMAGE_SYM_CLASS_STATIC = 3
-IMAGE_SYM_CLASS_REGISTER = 4
-IMAGE_SYM_CLASS_EXTERNAL_DEF = 5
-IMAGE_SYM_CLASS_LABEL = 6
-IMAGE_SYM_CLASS_UNDEFINED_LABEL = 7
-IMAGE_SYM_CLASS_MEMBER_OF_STRUCT = 8
-IMAGE_SYM_CLASS_ARGUMENT = 9
-IMAGE_SYM_CLASS_STRUCT_TAG = 10
-IMAGE_SYM_CLASS_MEMBER_OF_UNION = 11
-IMAGE_SYM_CLASS_UNION_TAG = 12
-IMAGE_SYM_CLASS_TYPE_DEFINITION = 13
-IMAGE_SYM_CLASS_UNDEFINED_STATIC = 14
-IMAGE_SYM_CLASS_ENUM_TAG = 15
-IMAGE_SYM_CLASS_MEMBER_OF_ENUM = 16
-IMAGE_SYM_CLASS_REGISTER_PARAM = 17
-IMAGE_SYM_CLASS_BIT_FIELD = 18
-IMAGE_SYM_CLASS_FAR_EXTERNAL = 68
-IMAGE_SYM_CLASS_BLOCK = 100
-IMAGE_SYM_CLASS_FUNCTION = 101
-IMAGE_SYM_CLASS_END_OF_STRUCT = 102
-IMAGE_SYM_CLASS_FILE = 103
-IMAGE_SYM_CLASS_SECTION = 104
-IMAGE_SYM_CLASS_WEAK_EXTERNAL = 105
-N_BTMASK = 15
-N_TMASK = 48
-N_TMASK1 = 192
-N_TMASK2 = 240
-N_BTSHFT = 4
-N_TSHIFT = 2
-
-
-def BTYPE(x):
-    return (x) & N_BTMASK
-
-
-def ISPTR(x):
-    return ((x) & N_TMASK) == (IMAGE_SYM_DTYPE_POINTER << N_BTSHFT)
-
-
-def ISFCN(x):
-    return ((x) & N_TMASK) == (IMAGE_SYM_DTYPE_FUNCTION << N_BTSHFT)
-
-
-def ISARY(x):
-    return ((x) & N_TMASK) == (IMAGE_SYM_DTYPE_ARRAY << N_BTSHFT)
-
-
-def INCREF(x):
-    return (
-        (((x) & ~N_BTMASK) << N_TSHIFT)
-        | (IMAGE_SYM_DTYPE_POINTER << N_BTSHFT)
-        | ((x) & N_BTMASK)
-    )
-
-
-def DECREF(x):
-    return (((x) >> N_TSHIFT) & ~N_BTMASK) | ((x) & N_BTMASK)
-
-
-IMAGE_SIZEOF_AUX_SYMBOL = 18
-IMAGE_COMDAT_SELECT_NODUPLICATES = 1
-IMAGE_COMDAT_SELECT_ANY = 2
-IMAGE_COMDAT_SELECT_SAME_SIZE = 3
-IMAGE_COMDAT_SELECT_EXACT_MATCH = 4
-IMAGE_COMDAT_SELECT_ASSOCIATIVE = 5
-IMAGE_COMDAT_SELECT_LARGEST = 6
-IMAGE_COMDAT_SELECT_NEWEST = 7
-IMAGE_WEAK_EXTERN_SEARCH_NOLIBRARY = 1
-IMAGE_WEAK_EXTERN_SEARCH_LIBRARY = 2
-IMAGE_WEAK_EXTERN_SEARCH_ALIAS = 3
-IMAGE_SIZEOF_RELOCATION = 10
-IMAGE_REL_I386_ABSOLUTE = 0
-IMAGE_REL_I386_DIR16 = 1
-IMAGE_REL_I386_REL16 = 2
-IMAGE_REL_I386_DIR32 = 6
-IMAGE_REL_I386_DIR32NB = 7
-IMAGE_REL_I386_SEG12 = 9
-IMAGE_REL_I386_SECTION = 10
-IMAGE_REL_I386_SECREL = 11
-IMAGE_REL_I386_REL32 = 20
-IMAGE_REL_MIPS_ABSOLUTE = 0
-IMAGE_REL_MIPS_REFHALF = 1
-IMAGE_REL_MIPS_REFWORD = 2
-IMAGE_REL_MIPS_JMPADDR = 3
-IMAGE_REL_MIPS_REFHI = 4
-IMAGE_REL_MIPS_REFLO = 5
-IMAGE_REL_MIPS_GPREL = 6
-IMAGE_REL_MIPS_LITERAL = 7
-IMAGE_REL_MIPS_SECTION = 10
-IMAGE_REL_MIPS_SECREL = 11
-IMAGE_REL_MIPS_SECRELLO = 12
-IMAGE_REL_MIPS_SECRELHI = 13
-IMAGE_REL_MIPS_REFWORDNB = 34
-IMAGE_REL_MIPS_PAIR = 37
-IMAGE_REL_ALPHA_ABSOLUTE = 0
-IMAGE_REL_ALPHA_REFLONG = 1
-IMAGE_REL_ALPHA_REFQUAD = 2
-IMAGE_REL_ALPHA_GPREL32 = 3
-IMAGE_REL_ALPHA_LITERAL = 4
-IMAGE_REL_ALPHA_LITUSE = 5
-IMAGE_REL_ALPHA_GPDISP = 6
-IMAGE_REL_ALPHA_BRADDR = 7
-IMAGE_REL_ALPHA_HINT = 8
-IMAGE_REL_ALPHA_INLINE_REFLONG = 9
-IMAGE_REL_ALPHA_REFHI = 10
-IMAGE_REL_ALPHA_REFLO = 11
-IMAGE_REL_ALPHA_PAIR = 12
-IMAGE_REL_ALPHA_MATCH = 13
-IMAGE_REL_ALPHA_SECTION = 14
-IMAGE_REL_ALPHA_SECREL = 15
-IMAGE_REL_ALPHA_REFLONGNB = 16
-IMAGE_REL_ALPHA_SECRELLO = 17
-IMAGE_REL_ALPHA_SECRELHI = 18
-IMAGE_REL_PPC_ABSOLUTE = 0
-IMAGE_REL_PPC_ADDR64 = 1
-IMAGE_REL_PPC_ADDR32 = 2
-IMAGE_REL_PPC_ADDR24 = 3
-IMAGE_REL_PPC_ADDR16 = 4
-IMAGE_REL_PPC_ADDR14 = 5
-IMAGE_REL_PPC_REL24 = 6
-IMAGE_REL_PPC_REL14 = 7
-IMAGE_REL_PPC_TOCREL16 = 8
-IMAGE_REL_PPC_TOCREL14 = 9
-IMAGE_REL_PPC_ADDR32NB = 10
-IMAGE_REL_PPC_SECREL = 11
-IMAGE_REL_PPC_SECTION = 12
-IMAGE_REL_PPC_IFGLUE = 13
-IMAGE_REL_PPC_IMGLUE = 14
-IMAGE_REL_PPC_SECREL16 = 15
-IMAGE_REL_PPC_REFHI = 16
-IMAGE_REL_PPC_REFLO = 17
-IMAGE_REL_PPC_PAIR = 18
-IMAGE_REL_PPC_SECRELLO = 19
-IMAGE_REL_PPC_SECRELHI = 20
-IMAGE_REL_PPC_TYPEMASK = 255
-IMAGE_REL_PPC_NEG = 256
-IMAGE_REL_PPC_BRTAKEN = 512
-IMAGE_REL_PPC_BRNTAKEN = 1024
-IMAGE_REL_PPC_TOCDEFN = 2048
-IMAGE_REL_SH3_ABSOLUTE = 0
-IMAGE_REL_SH3_DIRECT16 = 1
-IMAGE_REL_SH3_DIRECT32 = 2
-IMAGE_REL_SH3_DIRECT8 = 3
-IMAGE_REL_SH3_DIRECT8_WORD = 4
-IMAGE_REL_SH3_DIRECT8_LONG = 5
-IMAGE_REL_SH3_DIRECT4 = 6
-IMAGE_REL_SH3_DIRECT4_WORD = 7
-IMAGE_REL_SH3_DIRECT4_LONG = 8
-IMAGE_REL_SH3_PCREL8_WORD = 9
-IMAGE_REL_SH3_PCREL8_LONG = 10
-IMAGE_REL_SH3_PCREL12_WORD = 11
-IMAGE_REL_SH3_STARTOF_SECTION = 12
-IMAGE_REL_SH3_SIZEOF_SECTION = 13
-IMAGE_REL_SH3_SECTION = 14
-IMAGE_REL_SH3_SECREL = 15
-IMAGE_REL_SH3_DIRECT32_NB = 16
-IMAGE_SIZEOF_LINENUMBER = 6
-IMAGE_SIZEOF_BASE_RELOCATION = 8
-IMAGE_REL_BASED_ABSOLUTE = 0
-IMAGE_REL_BASED_HIGH = 1
-IMAGE_REL_BASED_LOW = 2
-IMAGE_REL_BASED_HIGHLOW = 3
-IMAGE_REL_BASED_HIGHADJ = 4
-IMAGE_REL_BASED_MIPS_JMPADDR = 5
-IMAGE_REL_BASED_SECTION = 6
-IMAGE_REL_BASED_REL32 = 7
-IMAGE_ARCHIVE_START_SIZE = 8
-IMAGE_ARCHIVE_START = "!<arch>\n"
-IMAGE_ARCHIVE_END = "`\n"
-IMAGE_ARCHIVE_PAD = "\n"
-IMAGE_ARCHIVE_LINKER_MEMBER = "/               "
-IMAGE_SIZEOF_ARCHIVE_MEMBER_HDR = 60
-IMAGE_ORDINAL_FLAG = -2147483648
-
-
-def IMAGE_SNAP_BY_ORDINAL(Ordina):
-    return (Ordinal & IMAGE_ORDINAL_FLAG) != 0
-
-
-def IMAGE_ORDINAL(Ordina):
-    return Ordinal & 65535
-
-
-IMAGE_RESOURCE_NAME_IS_STRING = -2147483648
-IMAGE_RESOURCE_DATA_IS_DIRECTORY = -2147483648
-IMAGE_DEBUG_TYPE_UNKNOWN = 0
-IMAGE_DEBUG_TYPE_COFF = 1
-IMAGE_DEBUG_TYPE_CODEVIEW = 2
-IMAGE_DEBUG_TYPE_FPO = 3
-IMAGE_DEBUG_TYPE_MISC = 4
-IMAGE_DEBUG_TYPE_EXCEPTION = 5
-IMAGE_DEBUG_TYPE_FIXUP = 6
-IMAGE_DEBUG_TYPE_OMAP_TO_SRC = 7
-IMAGE_DEBUG_TYPE_OMAP_FROM_SRC = 8
-IMAGE_DEBUG_TYPE_BORLAND = 9
-FRAME_FPO = 0
-FRAME_TRAP = 1
-FRAME_TSS = 2
-FRAME_NONFPO = 3
-SIZEOF_RFPO_DATA = 16
-IMAGE_DEBUG_MISC_EXENAME = 1
-IMAGE_SEPARATE_DEBUG_SIGNATURE = 18756
-IMAGE_SEPARATE_DEBUG_FLAGS_MASK = 32768
-IMAGE_SEPARATE_DEBUG_MISMATCH = 32768
-
-# Included from string.h
-_NLSCMPERROR = 2147483647
-NULL = 0
-HEAP_NO_SERIALIZE = 1
-HEAP_GROWABLE = 2
-HEAP_GENERATE_EXCEPTIONS = 4
-HEAP_ZERO_MEMORY = 8
-HEAP_REALLOC_IN_PLACE_ONLY = 16
-HEAP_TAIL_CHECKING_ENABLED = 32
-HEAP_FREE_CHECKING_ENABLED = 64
-HEAP_DISABLE_COALESCE_ON_FREE = 128
-HEAP_CREATE_ALIGN_16 = 65536
-HEAP_CREATE_ENABLE_TRACING = 131072
-HEAP_MAXIMUM_TAG = 4095
-HEAP_PSEUDO_TAG_FLAG = 32768
-HEAP_TAG_SHIFT = 16
-IS_TEXT_UNICODE_ASCII16 = 1
-IS_TEXT_UNICODE_REVERSE_ASCII16 = 16
-IS_TEXT_UNICODE_STATISTICS = 2
-IS_TEXT_UNICODE_REVERSE_STATISTICS = 32
-IS_TEXT_UNICODE_CONTROLS = 4
-IS_TEXT_UNICODE_REVERSE_CONTROLS = 64
-IS_TEXT_UNICODE_SIGNATURE = 8
-IS_TEXT_UNICODE_REVERSE_SIGNATURE = 128
-IS_TEXT_UNICODE_ILLEGAL_CHARS = 256
-IS_TEXT_UNICODE_ODD_LENGTH = 512
-IS_TEXT_UNICODE_DBCS_LEADBYTE = 1024
-IS_TEXT_UNICODE_NULL_BYTES = 4096
-IS_TEXT_UNICODE_UNICODE_MASK = 15
-IS_TEXT_UNICODE_REVERSE_MASK = 240
-IS_TEXT_UNICODE_NOT_UNICODE_MASK = 3840
-IS_TEXT_UNICODE_NOT_ASCII_MASK = 61440
-COMPRESSION_FORMAT_NONE = 0
-COMPRESSION_FORMAT_DEFAULT = 1
-COMPRESSION_FORMAT_LZNT1 = 2
-COMPRESSION_ENGINE_STANDARD = 0
-COMPRESSION_ENGINE_MAXIMUM = 256
-MESSAGE_RESOURCE_UNICODE = 1
-RTL_CRITSECT_TYPE = 0
-RTL_RESOURCE_TYPE = 1
-SEF_DACL_AUTO_INHERIT = 1
-SEF_SACL_AUTO_INHERIT = 2
-SEF_DEFAULT_DESCRIPTOR_FOR_OBJECT = 4
-SEF_AVOID_PRIVILEGE_CHECK = 8
-DLL_PROCESS_ATTACH = 1
-DLL_THREAD_ATTACH = 2
-DLL_THREAD_DETACH = 3
-DLL_PROCESS_DETACH = 0
-EVENTLOG_SEQUENTIAL_READ = 0x0001
-EVENTLOG_SEEK_READ = 0x0002
-EVENTLOG_FORWARDS_READ = 0x0004
-EVENTLOG_BACKWARDS_READ = 0x0008
-EVENTLOG_SUCCESS = 0x0000
-EVENTLOG_ERROR_TYPE = 1
-EVENTLOG_WARNING_TYPE = 2
-EVENTLOG_INFORMATION_TYPE = 4
-EVENTLOG_AUDIT_SUCCESS = 8
-EVENTLOG_AUDIT_FAILURE = 16
-EVENTLOG_START_PAIRED_EVENT = 1
-EVENTLOG_END_PAIRED_EVENT = 2
-EVENTLOG_END_ALL_PAIRED_EVENTS = 4
-EVENTLOG_PAIRED_EVENT_ACTIVE = 8
-EVENTLOG_PAIRED_EVENT_INACTIVE = 16
-KEY_QUERY_VALUE = 1
-KEY_SET_VALUE = 2
-KEY_CREATE_SUB_KEY = 4
-KEY_ENUMERATE_SUB_KEYS = 8
-KEY_NOTIFY = 16
-KEY_CREATE_LINK = 32
-KEY_READ = (
-    STANDARD_RIGHTS_READ | KEY_QUERY_VALUE | KEY_ENUMERATE_SUB_KEYS | KEY_NOTIFY
-) & (~SYNCHRONIZE)
-KEY_WRITE = (STANDARD_RIGHTS_WRITE | KEY_SET_VALUE | KEY_CREATE_SUB_KEY) & (
-    ~SYNCHRONIZE
-)
-KEY_EXECUTE = (KEY_READ) & (~SYNCHRONIZE)
-KEY_ALL_ACCESS = (
-    STANDARD_RIGHTS_ALL
-    | KEY_QUERY_VALUE
-    | KEY_SET_VALUE
-    | KEY_CREATE_SUB_KEY
-    | KEY_ENUMERATE_SUB_KEYS
-    | KEY_NOTIFY
-    | KEY_CREATE_LINK
-) & (~SYNCHRONIZE)
-REG_OPTION_RESERVED = 0
-REG_OPTION_NON_VOLATILE = 0
-REG_OPTION_VOLATILE = 1
-REG_OPTION_CREATE_LINK = 2
-REG_OPTION_BACKUP_RESTORE = 4
-REG_OPTION_OPEN_LINK = 8
-REG_LEGAL_OPTION = (
-    REG_OPTION_RESERVED
-    | REG_OPTION_NON_VOLATILE
-    | REG_OPTION_VOLATILE
-    | REG_OPTION_CREATE_LINK
-    | REG_OPTION_BACKUP_RESTORE
-    | REG_OPTION_OPEN_LINK
-)
-
-## dispositions returned from RegCreateKeyEx
-REG_CREATED_NEW_KEY = 1
-REG_OPENED_EXISTING_KEY = 2
-
-## flags used with RegSaveKeyEx
-REG_STANDARD_FORMAT = 1
-REG_LATEST_FORMAT = 2
-REG_NO_COMPRESSION = 4
-
-## flags used with RegRestoreKey
-REG_WHOLE_HIVE_VOLATILE = 1
-REG_REFRESH_HIVE = 2
-REG_NO_LAZY_FLUSH = 4
-REG_FORCE_RESTORE = 8
-
-REG_NOTIFY_CHANGE_NAME = 1
-REG_NOTIFY_CHANGE_ATTRIBUTES = 2
-REG_NOTIFY_CHANGE_LAST_SET = 4
-REG_NOTIFY_CHANGE_SECURITY = 8
-REG_LEGAL_CHANGE_FILTER = (
-    REG_NOTIFY_CHANGE_NAME
-    | REG_NOTIFY_CHANGE_ATTRIBUTES
-    | REG_NOTIFY_CHANGE_LAST_SET
-    | REG_NOTIFY_CHANGE_SECURITY
-)
-REG_NONE = 0
-REG_SZ = 1
-REG_EXPAND_SZ = 2
-REG_BINARY = 3
-REG_DWORD = 4
-REG_DWORD_LITTLE_ENDIAN = 4
-REG_DWORD_BIG_ENDIAN = 5
-REG_LINK = 6
-REG_MULTI_SZ = 7
-REG_RESOURCE_LIST = 8
-REG_FULL_RESOURCE_DESCRIPTOR = 9
-REG_RESOURCE_REQUIREMENTS_LIST = 10
-SERVICE_KERNEL_DRIVER = 1
-SERVICE_FILE_SYSTEM_DRIVER = 2
-SERVICE_ADAPTER = 4
-SERVICE_RECOGNIZER_DRIVER = 8
-SERVICE_DRIVER = (
-    SERVICE_KERNEL_DRIVER | SERVICE_FILE_SYSTEM_DRIVER | SERVICE_RECOGNIZER_DRIVER
-)
-SERVICE_WIN32_OWN_PROCESS = 16
-SERVICE_WIN32_SHARE_PROCESS = 32
-SERVICE_WIN32 = SERVICE_WIN32_OWN_PROCESS | SERVICE_WIN32_SHARE_PROCESS
-SERVICE_INTERACTIVE_PROCESS = 256
-SERVICE_TYPE_ALL = (
-    SERVICE_WIN32 | SERVICE_ADAPTER | SERVICE_DRIVER | SERVICE_INTERACTIVE_PROCESS
-)
-SERVICE_BOOT_START = 0
-SERVICE_SYSTEM_START = 1
-SERVICE_AUTO_START = 2
-SERVICE_DEMAND_START = 3
-SERVICE_DISABLED = 4
-SERVICE_ERROR_IGNORE = 0
-SERVICE_ERROR_NORMAL = 1
-SERVICE_ERROR_SEVERE = 2
-SERVICE_ERROR_CRITICAL = 3
-TAPE_ERASE_SHORT = 0
-TAPE_ERASE_LONG = 1
-TAPE_LOAD = 0
-TAPE_UNLOAD = 1
-TAPE_TENSION = 2
-TAPE_LOCK = 3
-TAPE_UNLOCK = 4
-TAPE_FORMAT = 5
-TAPE_SETMARKS = 0
-TAPE_FILEMARKS = 1
-TAPE_SHORT_FILEMARKS = 2
-TAPE_LONG_FILEMARKS = 3
-TAPE_ABSOLUTE_POSITION = 0
-TAPE_LOGICAL_POSITION = 1
-TAPE_PSEUDO_LOGICAL_POSITION = 2
-TAPE_REWIND = 0
-TAPE_ABSOLUTE_BLOCK = 1
-TAPE_LOGICAL_BLOCK = 2
-TAPE_PSEUDO_LOGICAL_BLOCK = 3
-TAPE_SPACE_END_OF_DATA = 4
-TAPE_SPACE_RELATIVE_BLOCKS = 5
-TAPE_SPACE_FILEMARKS = 6
-TAPE_SPACE_SEQUENTIAL_FMKS = 7
-TAPE_SPACE_SETMARKS = 8
-TAPE_SPACE_SEQUENTIAL_SMKS = 9
-TAPE_DRIVE_FIXED = 1
-TAPE_DRIVE_SELECT = 2
-TAPE_DRIVE_INITIATOR = 4
-TAPE_DRIVE_ERASE_SHORT = 16
-TAPE_DRIVE_ERASE_LONG = 32
-TAPE_DRIVE_ERASE_BOP_ONLY = 64
-TAPE_DRIVE_ERASE_IMMEDIATE = 128
-TAPE_DRIVE_TAPE_CAPACITY = 256
-TAPE_DRIVE_TAPE_REMAINING = 512
-TAPE_DRIVE_FIXED_BLOCK = 1024
-TAPE_DRIVE_VARIABLE_BLOCK = 2048
-TAPE_DRIVE_WRITE_PROTECT = 4096
-TAPE_DRIVE_EOT_WZ_SIZE = 8192
-TAPE_DRIVE_ECC = 65536
-TAPE_DRIVE_COMPRESSION = 131072
-TAPE_DRIVE_PADDING = 262144
-TAPE_DRIVE_REPORT_SMKS = 524288
-TAPE_DRIVE_GET_ABSOLUTE_BLK = 1048576
-TAPE_DRIVE_GET_LOGICAL_BLK = 2097152
-TAPE_DRIVE_SET_EOT_WZ_SIZE = 4194304
-TAPE_DRIVE_EJECT_MEDIA = 16777216
-TAPE_DRIVE_RESERVED_BIT = -2147483648
-TAPE_DRIVE_LOAD_UNLOAD = -2147483647
-TAPE_DRIVE_TENSION = -2147483646
-TAPE_DRIVE_LOCK_UNLOCK = -2147483644
-TAPE_DRIVE_REWIND_IMMEDIATE = -2147483640
-TAPE_DRIVE_SET_BLOCK_SIZE = -2147483632
-TAPE_DRIVE_LOAD_UNLD_IMMED = -2147483616
-TAPE_DRIVE_TENSION_IMMED = -2147483584
-TAPE_DRIVE_LOCK_UNLK_IMMED = -2147483520
-TAPE_DRIVE_SET_ECC = -2147483392
-TAPE_DRIVE_SET_COMPRESSION = -2147483136
-TAPE_DRIVE_SET_PADDING = -2147482624
-TAPE_DRIVE_SET_REPORT_SMKS = -2147481600
-TAPE_DRIVE_ABSOLUTE_BLK = -2147479552
-TAPE_DRIVE_ABS_BLK_IMMED = -2147475456
-TAPE_DRIVE_LOGICAL_BLK = -2147467264
-TAPE_DRIVE_LOG_BLK_IMMED = -2147450880
-TAPE_DRIVE_END_OF_DATA = -2147418112
-TAPE_DRIVE_RELATIVE_BLKS = -2147352576
-TAPE_DRIVE_FILEMARKS = -2147221504
-TAPE_DRIVE_SEQUENTIAL_FMKS = -2146959360
-TAPE_DRIVE_SETMARKS = -2146435072
-TAPE_DRIVE_SEQUENTIAL_SMKS = -2145386496
-TAPE_DRIVE_REVERSE_POSITION = -2143289344
-TAPE_DRIVE_SPACE_IMMEDIATE = -2139095040
-TAPE_DRIVE_WRITE_SETMARKS = -2130706432
-TAPE_DRIVE_WRITE_FILEMARKS = -2113929216
-TAPE_DRIVE_WRITE_SHORT_FMKS = -2080374784
-TAPE_DRIVE_WRITE_LONG_FMKS = -2013265920
-TAPE_DRIVE_WRITE_MARK_IMMED = -1879048192
-TAPE_DRIVE_FORMAT = -1610612736
-TAPE_DRIVE_FORMAT_IMMEDIATE = -1073741824
-TAPE_DRIVE_HIGH_FEATURES = -2147483648
-TAPE_FIXED_PARTITIONS = 0
-TAPE_SELECT_PARTITIONS = 1
-TAPE_INITIATOR_PARTITIONS = 2
-
-TRANSACTIONMANAGER_QUERY_INFORMATION = 0x0001
-TRANSACTIONMANAGER_SET_INFORMATION = 0x0002
-TRANSACTIONMANAGER_RECOVER = 0x0004
-TRANSACTIONMANAGER_RENAME = 0x0008
-TRANSACTIONMANAGER_CREATE_RM = 0x0010
-TRANSACTIONMANAGER_BIND_TRANSACTION = 0x0020
-TRANSACTIONMANAGER_GENERIC_READ = (
-    STANDARD_RIGHTS_READ | TRANSACTIONMANAGER_QUERY_INFORMATION
-)
-TRANSACTIONMANAGER_GENERIC_WRITE = (
-    STANDARD_RIGHTS_WRITE
-    | TRANSACTIONMANAGER_SET_INFORMATION
-    | TRANSACTIONMANAGER_RECOVER
-    | TRANSACTIONMANAGER_RENAME
-    | TRANSACTIONMANAGER_CREATE_RM
-)
-TRANSACTIONMANAGER_GENERIC_EXECUTE = STANDARD_RIGHTS_EXECUTE
-TRANSACTIONMANAGER_ALL_ACCESS = (
-    STANDARD_RIGHTS_REQUIRED
-    | TRANSACTIONMANAGER_GENERIC_READ
-    | TRANSACTIONMANAGER_GENERIC_WRITE
-    | TRANSACTIONMANAGER_GENERIC_EXECUTE
-    | TRANSACTIONMANAGER_BIND_TRANSACTION
-)
-
-TRANSACTION_QUERY_INFORMATION = 0x0001
-TRANSACTION_SET_INFORMATION = 0x0002
-TRANSACTION_ENLIST = 0x0004
-TRANSACTION_COMMIT = 0x0008
-TRANSACTION_ROLLBACK = 0x0010
-TRANSACTION_PROPAGATE = 0x0020
-TRANSACTION_SAVEPOINT = 0x0040
-TRANSACTION_MARSHALL = TRANSACTION_QUERY_INFORMATION
-TRANSACTION_GENERIC_READ = (
-    STANDARD_RIGHTS_READ | TRANSACTION_QUERY_INFORMATION | SYNCHRONIZE
-)
-TRANSACTION_GENERIC_WRITE = (
-    STANDARD_RIGHTS_WRITE
-    | TRANSACTION_SET_INFORMATION
-    | TRANSACTION_COMMIT
-    | TRANSACTION_ENLIST
-    | TRANSACTION_ROLLBACK
-    | TRANSACTION_PROPAGATE
-    | TRANSACTION_SAVEPOINT
-    | SYNCHRONIZE
-)
-TRANSACTION_GENERIC_EXECUTE = (
-    STANDARD_RIGHTS_EXECUTE | TRANSACTION_COMMIT | TRANSACTION_ROLLBACK | SYNCHRONIZE
-)
-TRANSACTION_ALL_ACCESS = (
-    STANDARD_RIGHTS_REQUIRED
-    | TRANSACTION_GENERIC_READ
-    | TRANSACTION_GENERIC_WRITE
-    | TRANSACTION_GENERIC_EXECUTE
-)
-TRANSACTION_RESOURCE_MANAGER_RIGHTS = (
-    TRANSACTION_GENERIC_READ
-    | STANDARD_RIGHTS_WRITE
-    | TRANSACTION_SET_INFORMATION
-    | TRANSACTION_ENLIST
-    | TRANSACTION_ROLLBACK
-    | TRANSACTION_PROPAGATE
-    | SYNCHRONIZE
-)
-
-RESOURCEMANAGER_QUERY_INFORMATION = 0x0001
-RESOURCEMANAGER_SET_INFORMATION = 0x0002
-RESOURCEMANAGER_RECOVER = 0x0004
-RESOURCEMANAGER_ENLIST = 0x0008
-RESOURCEMANAGER_GET_NOTIFICATION = 0x0010
-RESOURCEMANAGER_REGISTER_PROTOCOL = 0x0020
-RESOURCEMANAGER_COMPLETE_PROPAGATION = 0x0040
-RESOURCEMANAGER_GENERIC_READ = (
-    STANDARD_RIGHTS_READ | RESOURCEMANAGER_QUERY_INFORMATION | SYNCHRONIZE
-)
-RESOURCEMANAGER_GENERIC_WRITE = (
-    STANDARD_RIGHTS_WRITE
-    | RESOURCEMANAGER_SET_INFORMATION
-    | RESOURCEMANAGER_RECOVER
-    | RESOURCEMANAGER_ENLIST
-    | RESOURCEMANAGER_GET_NOTIFICATION
-    | RESOURCEMANAGER_REGISTER_PROTOCOL
-    | RESOURCEMANAGER_COMPLETE_PROPAGATION
-    | SYNCHRONIZE
-)
-RESOURCEMANAGER_GENERIC_EXECUTE = (
-    STANDARD_RIGHTS_EXECUTE
-    | RESOURCEMANAGER_RECOVER
-    | RESOURCEMANAGER_ENLIST
-    | RESOURCEMANAGER_GET_NOTIFICATION
-    | RESOURCEMANAGER_COMPLETE_PROPAGATION
-    | SYNCHRONIZE
-)
-RESOURCEMANAGER_ALL_ACCESS = (
-    STANDARD_RIGHTS_REQUIRED
-    | RESOURCEMANAGER_GENERIC_READ
-    | RESOURCEMANAGER_GENERIC_WRITE
-    | RESOURCEMANAGER_GENERIC_EXECUTE
-)
-
-ENLISTMENT_QUERY_INFORMATION = 0x0001
-ENLISTMENT_SET_INFORMATION = 0x0002
-ENLISTMENT_RECOVER = 0x0004
-ENLISTMENT_SUBORDINATE_RIGHTS = 0x0008
-ENLISTMENT_SUPERIOR_RIGHTS = 0x0010
-ENLISTMENT_GENERIC_READ = STANDARD_RIGHTS_READ | ENLISTMENT_QUERY_INFORMATION
-ENLISTMENT_GENERIC_WRITE = (
-    STANDARD_RIGHTS_WRITE
-    | ENLISTMENT_SET_INFORMATION
-    | ENLISTMENT_RECOVER
-    | ENLISTMENT_SUBORDINATE_RIGHTS
-    | ENLISTMENT_SUPERIOR_RIGHTS
-)
-ENLISTMENT_GENERIC_EXECUTE = (
-    STANDARD_RIGHTS_EXECUTE
-    | ENLISTMENT_RECOVER
-    | ENLISTMENT_SUBORDINATE_RIGHTS
-    | ENLISTMENT_SUPERIOR_RIGHTS
-)
-ENLISTMENT_ALL_ACCESS = (
-    STANDARD_RIGHTS_REQUIRED
-    | ENLISTMENT_GENERIC_READ
-    | ENLISTMENT_GENERIC_WRITE
-    | ENLISTMENT_GENERIC_EXECUTE
-)
-
-
-## TRANSACTION_OUTCOME enum
-TransactionOutcomeUndetermined = 1
-TransactionOutcomeCommitted = 2
-TransactionOutcomeAborted = 3
-
-## TRANSACTION_STATE enum
-TransactionStateNormal = 1
-TransactionStateIndoubt = 2
-TransactionStateCommittedNotify = 3
-
-## TRANSACTION_INFORMATION_CLASS enum
-TransactionBasicInformation = 0
-TransactionPropertiesInformation = 1
-TransactionEnlistmentInformation = 2
-TransactionFullInformation = 3
-
-## TRANSACTIONMANAGER_INFORMATION_CLASS enum
-TransactionManagerBasicInformation = 0
-TransactionManagerLogInformation = 1
-TransactionManagerLogPathInformation = 2
-TransactionManagerOnlineProbeInformation = 3
-
-## RESOURCEMANAGER_INFORMATION_CLASS ENUM
-ResourceManagerBasicInformation = 0
-ResourceManagerCompletionInformation = 1
-ResourceManagerFullInformation = 2
-ResourceManagerNameInformation = 3
-
-## ENLISTMENT_INFORMATION_CLASS enum
-EnlistmentBasicInformation = 0
-EnlistmentRecoveryInformation = 1
-EnlistmentFullInformation = 2
-EnlistmentNameInformation = 3
-
-## KTMOBJECT_TYPE enum
-KTMOBJECT_TRANSACTION = 0
-KTMOBJECT_TRANSACTION_MANAGER = 1
-KTMOBJECT_RESOURCE_MANAGER = 2
-KTMOBJECT_ENLISTMENT = 3
-KTMOBJECT_INVALID = 4
diff --git a/lib/win32/lib/winperf.py b/lib/win32/lib/winperf.py
deleted file mode 100644
index 403f67c1..00000000
--- a/lib/win32/lib/winperf.py
+++ /dev/null
@@ -1,236 +0,0 @@
-# Generated by h2py from winperf.h
-PERF_DATA_VERSION = 1
-PERF_DATA_REVISION = 1
-PERF_NO_INSTANCES = -1
-PERF_SIZE_DWORD = 0x00000000
-PERF_SIZE_LARGE = 0x00000100
-PERF_SIZE_ZERO = 0x00000200
-PERF_SIZE_VARIABLE_LEN = 0x00000300
-PERF_TYPE_NUMBER = 0x00000000
-PERF_TYPE_COUNTER = 0x00000400
-PERF_TYPE_TEXT = 0x00000800
-PERF_TYPE_ZERO = 0x00000C00
-PERF_NUMBER_HEX = 0x00000000
-PERF_NUMBER_DECIMAL = 0x00010000
-PERF_NUMBER_DEC_1000 = 0x00020000
-PERF_COUNTER_VALUE = 0x00000000
-PERF_COUNTER_RATE = 0x00010000
-PERF_COUNTER_FRACTION = 0x00020000
-PERF_COUNTER_BASE = 0x00030000
-PERF_COUNTER_ELAPSED = 0x00040000
-PERF_COUNTER_QUEUELEN = 0x00050000
-PERF_COUNTER_HISTOGRAM = 0x00060000
-PERF_TEXT_UNICODE = 0x00000000
-PERF_TEXT_ASCII = 0x00010000
-PERF_TIMER_TICK = 0x00000000
-PERF_TIMER_100NS = 0x00100000
-PERF_OBJECT_TIMER = 0x00200000
-PERF_DELTA_COUNTER = 0x00400000
-PERF_DELTA_BASE = 0x00800000
-PERF_INVERSE_COUNTER = 0x01000000
-PERF_MULTI_COUNTER = 0x02000000
-PERF_DISPLAY_NO_SUFFIX = 0x00000000
-PERF_DISPLAY_PER_SEC = 0x10000000
-PERF_DISPLAY_PERCENT = 0x20000000
-PERF_DISPLAY_SECONDS = 0x30000000
-PERF_DISPLAY_NOSHOW = 0x40000000
-PERF_COUNTER_COUNTER = (
-    PERF_SIZE_DWORD
-    | PERF_TYPE_COUNTER
-    | PERF_COUNTER_RATE
-    | PERF_TIMER_TICK
-    | PERF_DELTA_COUNTER
-    | PERF_DISPLAY_PER_SEC
-)
-PERF_COUNTER_TIMER = (
-    PERF_SIZE_LARGE
-    | PERF_TYPE_COUNTER
-    | PERF_COUNTER_RATE
-    | PERF_TIMER_TICK
-    | PERF_DELTA_COUNTER
-    | PERF_DISPLAY_PERCENT
-)
-PERF_COUNTER_QUEUELEN_TYPE = (
-    PERF_SIZE_DWORD
-    | PERF_TYPE_COUNTER
-    | PERF_COUNTER_QUEUELEN
-    | PERF_TIMER_TICK
-    | PERF_DELTA_COUNTER
-    | PERF_DISPLAY_NO_SUFFIX
-)
-PERF_COUNTER_LARGE_QUEUELEN_TYPE = (
-    PERF_SIZE_LARGE
-    | PERF_TYPE_COUNTER
-    | PERF_COUNTER_QUEUELEN
-    | PERF_TIMER_TICK
-    | PERF_DELTA_COUNTER
-    | PERF_DISPLAY_NO_SUFFIX
-)
-PERF_COUNTER_BULK_COUNT = (
-    PERF_SIZE_LARGE
-    | PERF_TYPE_COUNTER
-    | PERF_COUNTER_RATE
-    | PERF_TIMER_TICK
-    | PERF_DELTA_COUNTER
-    | PERF_DISPLAY_PER_SEC
-)
-PERF_COUNTER_TEXT = (
-    PERF_SIZE_VARIABLE_LEN | PERF_TYPE_TEXT | PERF_TEXT_UNICODE | PERF_DISPLAY_NO_SUFFIX
-)
-PERF_COUNTER_RAWCOUNT = (
-    PERF_SIZE_DWORD | PERF_TYPE_NUMBER | PERF_NUMBER_DECIMAL | PERF_DISPLAY_NO_SUFFIX
-)
-PERF_COUNTER_LARGE_RAWCOUNT = (
-    PERF_SIZE_LARGE | PERF_TYPE_NUMBER | PERF_NUMBER_DECIMAL | PERF_DISPLAY_NO_SUFFIX
-)
-PERF_COUNTER_RAWCOUNT_HEX = (
-    PERF_SIZE_DWORD | PERF_TYPE_NUMBER | PERF_NUMBER_HEX | PERF_DISPLAY_NO_SUFFIX
-)
-PERF_COUNTER_LARGE_RAWCOUNT_HEX = (
-    PERF_SIZE_LARGE | PERF_TYPE_NUMBER | PERF_NUMBER_HEX | PERF_DISPLAY_NO_SUFFIX
-)
-PERF_SAMPLE_FRACTION = (
-    PERF_SIZE_DWORD
-    | PERF_TYPE_COUNTER
-    | PERF_COUNTER_FRACTION
-    | PERF_DELTA_COUNTER
-    | PERF_DELTA_BASE
-    | PERF_DISPLAY_PERCENT
-)
-PERF_SAMPLE_COUNTER = (
-    PERF_SIZE_DWORD
-    | PERF_TYPE_COUNTER
-    | PERF_COUNTER_RATE
-    | PERF_TIMER_TICK
-    | PERF_DELTA_COUNTER
-    | PERF_DISPLAY_NO_SUFFIX
-)
-PERF_COUNTER_NODATA = PERF_SIZE_ZERO | PERF_DISPLAY_NOSHOW
-PERF_COUNTER_TIMER_INV = (
-    PERF_SIZE_LARGE
-    | PERF_TYPE_COUNTER
-    | PERF_COUNTER_RATE
-    | PERF_TIMER_TICK
-    | PERF_DELTA_COUNTER
-    | PERF_INVERSE_COUNTER
-    | PERF_DISPLAY_PERCENT
-)
-PERF_SAMPLE_BASE = (
-    PERF_SIZE_DWORD
-    | PERF_TYPE_COUNTER
-    | PERF_COUNTER_BASE
-    | PERF_DISPLAY_NOSHOW
-    | 0x00000001
-)
-PERF_AVERAGE_TIMER = (
-    PERF_SIZE_DWORD | PERF_TYPE_COUNTER | PERF_COUNTER_FRACTION | PERF_DISPLAY_SECONDS
-)
-PERF_AVERAGE_BASE = (
-    PERF_SIZE_DWORD
-    | PERF_TYPE_COUNTER
-    | PERF_COUNTER_BASE
-    | PERF_DISPLAY_NOSHOW
-    | 0x00000002
-)
-PERF_AVERAGE_BULK = (
-    PERF_SIZE_LARGE | PERF_TYPE_COUNTER | PERF_COUNTER_FRACTION | PERF_DISPLAY_NOSHOW
-)
-PERF_100NSEC_TIMER = (
-    PERF_SIZE_LARGE
-    | PERF_TYPE_COUNTER
-    | PERF_COUNTER_RATE
-    | PERF_TIMER_100NS
-    | PERF_DELTA_COUNTER
-    | PERF_DISPLAY_PERCENT
-)
-PERF_100NSEC_TIMER_INV = (
-    PERF_SIZE_LARGE
-    | PERF_TYPE_COUNTER
-    | PERF_COUNTER_RATE
-    | PERF_TIMER_100NS
-    | PERF_DELTA_COUNTER
-    | PERF_INVERSE_COUNTER
-    | PERF_DISPLAY_PERCENT
-)
-PERF_COUNTER_MULTI_TIMER = (
-    PERF_SIZE_LARGE
-    | PERF_TYPE_COUNTER
-    | PERF_COUNTER_RATE
-    | PERF_DELTA_COUNTER
-    | PERF_TIMER_TICK
-    | PERF_MULTI_COUNTER
-    | PERF_DISPLAY_PERCENT
-)
-PERF_COUNTER_MULTI_TIMER_INV = (
-    PERF_SIZE_LARGE
-    | PERF_TYPE_COUNTER
-    | PERF_COUNTER_RATE
-    | PERF_DELTA_COUNTER
-    | PERF_MULTI_COUNTER
-    | PERF_TIMER_TICK
-    | PERF_INVERSE_COUNTER
-    | PERF_DISPLAY_PERCENT
-)
-PERF_COUNTER_MULTI_BASE = (
-    PERF_SIZE_LARGE
-    | PERF_TYPE_COUNTER
-    | PERF_COUNTER_BASE
-    | PERF_MULTI_COUNTER
-    | PERF_DISPLAY_NOSHOW
-)
-PERF_100NSEC_MULTI_TIMER = (
-    PERF_SIZE_LARGE
-    | PERF_TYPE_COUNTER
-    | PERF_DELTA_COUNTER
-    | PERF_COUNTER_RATE
-    | PERF_TIMER_100NS
-    | PERF_MULTI_COUNTER
-    | PERF_DISPLAY_PERCENT
-)
-PERF_100NSEC_MULTI_TIMER_INV = (
-    PERF_SIZE_LARGE
-    | PERF_TYPE_COUNTER
-    | PERF_DELTA_COUNTER
-    | PERF_COUNTER_RATE
-    | PERF_TIMER_100NS
-    | PERF_MULTI_COUNTER
-    | PERF_INVERSE_COUNTER
-    | PERF_DISPLAY_PERCENT
-)
-PERF_RAW_FRACTION = (
-    PERF_SIZE_DWORD | PERF_TYPE_COUNTER | PERF_COUNTER_FRACTION | PERF_DISPLAY_PERCENT
-)
-PERF_RAW_BASE = (
-    PERF_SIZE_DWORD
-    | PERF_TYPE_COUNTER
-    | PERF_COUNTER_BASE
-    | PERF_DISPLAY_NOSHOW
-    | 0x00000003
-)
-PERF_ELAPSED_TIME = (
-    PERF_SIZE_LARGE
-    | PERF_TYPE_COUNTER
-    | PERF_COUNTER_ELAPSED
-    | PERF_OBJECT_TIMER
-    | PERF_DISPLAY_SECONDS
-)
-PERF_COUNTER_HISTOGRAM_TYPE = -2147483648  # 0x80000000
-PERF_COUNTER_DELTA = (
-    PERF_SIZE_DWORD
-    | PERF_TYPE_COUNTER
-    | PERF_COUNTER_VALUE
-    | PERF_DELTA_COUNTER
-    | PERF_DISPLAY_NO_SUFFIX
-)
-PERF_COUNTER_LARGE_DELTA = (
-    PERF_SIZE_LARGE
-    | PERF_TYPE_COUNTER
-    | PERF_COUNTER_VALUE
-    | PERF_DELTA_COUNTER
-    | PERF_DISPLAY_NO_SUFFIX
-)
-PERF_DETAIL_NOVICE = 100
-PERF_DETAIL_ADVANCED = 200
-PERF_DETAIL_EXPERT = 300
-PERF_DETAIL_WIZARD = 400
-PERF_NO_UNIQUE_ID = -1
diff --git a/lib/win32/lib/winxptheme.py b/lib/win32/lib/winxptheme.py
deleted file mode 100644
index 3f61c3de..00000000
--- a/lib/win32/lib/winxptheme.py
+++ /dev/null
@@ -1,7 +0,0 @@
-"""A useful wrapper around the "_winxptheme" module.
-
-Originally used when we couldn't be sure Windows XP apis were going to
-be available. In 2022, it's safe to assume they are, so this is just a wrapper
-around _winxptheme.
-"""
-from _winxptheme import *
diff --git a/lib/win32/license.txt b/lib/win32/license.txt
deleted file mode 100644
index fa340d74..00000000
--- a/lib/win32/license.txt
+++ /dev/null
@@ -1,30 +0,0 @@
-Unless stated in the specfic source file, this work is
-Copyright (c) 1994-2008, Mark Hammond 
-All rights reserved.
-
-Redistribution and use in source and binary forms, with or without 
-modification, are permitted provided that the following conditions 
-are met:
-
-Redistributions of source code must retain the above copyright notice, 
-this list of conditions and the following disclaimer.
-
-Redistributions in binary form must reproduce the above copyright 
-notice, this list of conditions and the following disclaimer in 
-the documentation and/or other materials provided with the distribution.
-
-Neither name of Mark Hammond nor the name of contributors may be used 
-to endorse or promote products derived from this software without 
-specific prior written permission. 
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS
-IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
-TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
-PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR
-CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
-EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
-PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
-PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
-NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
-SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 
diff --git a/lib/win32/scripts/ControlService.py b/lib/win32/scripts/ControlService.py
deleted file mode 100644
index d2281add..00000000
--- a/lib/win32/scripts/ControlService.py
+++ /dev/null
@@ -1,594 +0,0 @@
-# ControlService.py
-#
-# A simple app which duplicates some of the functionality in the
-# Services applet of the control panel.
-#
-# Suggested enhancements (in no particular order):
-#
-# 1. When changing the service status, continue to query the status
-# of the service until the status change is complete.  Use this
-# information to put up some kind of a progress dialog like the CP
-# applet does.  Unlike the CP, allow canceling out in the event that
-# the status change hangs.
-# 2. When starting or stopping a service with dependencies, alert
-# the user about the dependent services, then start (or stop) all
-# dependent services as appropriate.
-# 3. Allow toggling between service view and device view
-# 4. Allow configuration of other service parameters such as startup
-# name and password.
-# 5. Allow connection to remote SCMs.  This is just a matter of
-# reconnecting to the SCM on the remote machine; the rest of the
-# code should still work the same.
-# 6. Either implement the startup parameters or get rid of the editbox.
-# 7. Either implement or get rid of "H/W Profiles".
-# 8. Either implement or get rid of "Help".
-# 9. Improve error handling.  Ideally, this would also include falling
-# back to lower levels of functionality for users with less rights.
-# Right now, we always try to get all the rights and fail when we can't
-
-
-import win32con
-import win32service
-import win32ui
-from pywin.mfc import dialog
-
-
-class StartupDlg(dialog.Dialog):
-    IDC_LABEL = 127
-    IDC_DEVICE = 128
-    IDC_BOOT = 129
-    IDC_SYSTEM = 130
-    IDC_AUTOMATIC = 131
-    IDC_MANUAL = 132
-    IDC_DISABLED = 133
-
-    def __init__(self, displayname, service):
-        dialog.Dialog.__init__(self, self.GetResource())
-        self.name = displayname
-        self.service = service
-
-    def __del__(self):
-        win32service.CloseServiceHandle(self.service)
-
-    def OnInitDialog(self):
-        cfg = win32service.QueryServiceConfig(self.service)
-        self.GetDlgItem(self.IDC_BOOT + cfg[1]).SetCheck(1)
-
-        status = win32service.QueryServiceStatus(self.service)
-        if (status[0] & win32service.SERVICE_KERNEL_DRIVER) or (
-            status[0] & win32service.SERVICE_FILE_SYSTEM_DRIVER
-        ):
-            # driver
-            self.GetDlgItem(self.IDC_LABEL).SetWindowText("Device:")
-        else:
-            # service
-            self.GetDlgItem(self.IDC_LABEL).SetWindowText("Service:")
-            self.GetDlgItem(self.IDC_BOOT).EnableWindow(0)
-            self.GetDlgItem(self.IDC_SYSTEM).EnableWindow(0)
-        self.GetDlgItem(self.IDC_DEVICE).SetWindowText(str(self.name))
-
-        return dialog.Dialog.OnInitDialog(self)
-
-    def OnOK(self):
-        self.BeginWaitCursor()
-        starttype = (
-            self.GetCheckedRadioButton(self.IDC_BOOT, self.IDC_DISABLED) - self.IDC_BOOT
-        )
-        try:
-            win32service.ChangeServiceConfig(
-                self.service,
-                win32service.SERVICE_NO_CHANGE,
-                starttype,
-                win32service.SERVICE_NO_CHANGE,
-                None,
-                None,
-                0,
-                None,
-                None,
-                None,
-                None,
-            )
-        except:
-            self.MessageBox(
-                "Unable to change startup configuration",
-                None,
-                win32con.MB_ICONEXCLAMATION,
-            )
-        self.EndWaitCursor()
-        return dialog.Dialog.OnOK(self)
-
-    def GetResource(self):
-        style = (
-            win32con.WS_POPUP
-            | win32con.DS_SETFONT
-            | win32con.WS_SYSMENU
-            | win32con.WS_CAPTION
-            | win32con.WS_VISIBLE
-            | win32con.DS_MODALFRAME
-        )
-        exstyle = None
-        t = [
-            ["Service Startup", (6, 18, 188, 107), style, exstyle, (8, "MS Shell Dlg")],
-        ]
-        t.append(
-            [
-                130,
-                "Device:",
-                self.IDC_LABEL,
-                (6, 7, 40, 8),
-                win32con.WS_VISIBLE | win32con.WS_CHILD | win32con.SS_LEFT,
-            ]
-        )
-        t.append(
-            [
-                130,
-                "",
-                self.IDC_DEVICE,
-                (48, 7, 134, 8),
-                win32con.WS_VISIBLE | win32con.WS_CHILD | win32con.SS_LEFT,
-            ]
-        )
-        t.append(
-            [
-                128,
-                "Startup Type",
-                -1,
-                (6, 21, 130, 80),
-                win32con.WS_VISIBLE
-                | win32con.WS_CHILD
-                | win32con.WS_GROUP
-                | win32con.BS_GROUPBOX,
-            ]
-        )
-        t.append(
-            [
-                128,
-                "&Boot",
-                self.IDC_BOOT,
-                (12, 33, 39, 10),
-                win32con.WS_VISIBLE
-                | win32con.WS_CHILD
-                | win32con.WS_TABSTOP
-                | win32con.BS_AUTORADIOBUTTON,
-            ]
-        )
-        t.append(
-            [
-                128,
-                "&System",
-                self.IDC_SYSTEM,
-                (12, 46, 39, 10),
-                win32con.WS_VISIBLE
-                | win32con.WS_CHILD
-                | win32con.WS_TABSTOP
-                | win32con.BS_AUTORADIOBUTTON,
-            ]
-        )
-        t.append(
-            [
-                128,
-                "&Automatic",
-                self.IDC_AUTOMATIC,
-                (12, 59, 118, 10),
-                win32con.WS_VISIBLE
-                | win32con.WS_CHILD
-                | win32con.WS_TABSTOP
-                | win32con.BS_AUTORADIOBUTTON,
-            ]
-        )
-        t.append(
-            [
-                128,
-                "&Manual",
-                self.IDC_MANUAL,
-                (12, 72, 118, 10),
-                win32con.WS_VISIBLE
-                | win32con.WS_CHILD
-                | win32con.WS_TABSTOP
-                | win32con.BS_AUTORADIOBUTTON,
-            ]
-        )
-        t.append(
-            [
-                128,
-                "&Disabled",
-                self.IDC_DISABLED,
-                (12, 85, 118, 10),
-                win32con.WS_VISIBLE
-                | win32con.WS_CHILD
-                | win32con.WS_TABSTOP
-                | win32con.BS_AUTORADIOBUTTON,
-            ]
-        )
-        t.append(
-            [
-                128,
-                "OK",
-                win32con.IDOK,
-                (142, 25, 40, 14),
-                win32con.WS_VISIBLE
-                | win32con.WS_CHILD
-                | win32con.WS_TABSTOP
-                | win32con.WS_GROUP
-                | win32con.BS_DEFPUSHBUTTON,
-            ]
-        )
-        t.append(
-            [
-                128,
-                "Cancel",
-                win32con.IDCANCEL,
-                (142, 43, 40, 14),
-                win32con.WS_VISIBLE
-                | win32con.WS_CHILD
-                | win32con.WS_TABSTOP
-                | win32con.BS_PUSHBUTTON,
-            ]
-        )
-        t.append(
-            [
-                128,
-                "&Help",
-                win32con.IDHELP,
-                (142, 61, 40, 14),
-                win32con.WS_VISIBLE
-                | win32con.WS_CHILD
-                | win32con.WS_TABSTOP
-                | win32con.BS_PUSHBUTTON,
-            ]
-        )
-        return t
-
-
-class ServiceDlg(dialog.Dialog):
-    IDC_LIST = 128
-    IDC_START = 129
-    IDC_STOP = 130
-    IDC_PAUSE = 131
-    IDC_CONTINUE = 132
-    IDC_STARTUP = 133
-    IDC_PROFILES = 134
-    IDC_PARAMS = 135
-
-    def __init__(self, machineName=""):
-        dialog.Dialog.__init__(self, self.GetResource())
-        self.HookCommand(self.OnListEvent, self.IDC_LIST)
-        self.HookCommand(self.OnStartCmd, self.IDC_START)
-        self.HookCommand(self.OnStopCmd, self.IDC_STOP)
-        self.HookCommand(self.OnPauseCmd, self.IDC_PAUSE)
-        self.HookCommand(self.OnContinueCmd, self.IDC_CONTINUE)
-        self.HookCommand(self.OnStartupCmd, self.IDC_STARTUP)
-        self.machineName = machineName
-        self.scm = win32service.OpenSCManager(
-            self.machineName, None, win32service.SC_MANAGER_ALL_ACCESS
-        )
-
-    def __del__(self):
-        win32service.CloseServiceHandle(self.scm)
-
-    def OnInitDialog(self):
-        self.listCtrl = self.GetDlgItem(self.IDC_LIST)
-        self.listCtrl.SetTabStops([158, 200])
-        if self.machineName:
-            self.SetWindowText("Services on %s" % self.machineName)
-        self.ReloadData()
-        return dialog.Dialog.OnInitDialog(self)
-
-    def ReloadData(self):
-        service = self.GetSelService()
-        self.listCtrl.SetRedraw(0)
-        self.listCtrl.ResetContent()
-        svcs = win32service.EnumServicesStatus(self.scm)
-        i = 0
-        self.data = []
-        for svc in svcs:
-            try:
-                status = (
-                    "Unknown",
-                    "Stopped",
-                    "Starting",
-                    "Stopping",
-                    "Running",
-                    "Continuing",
-                    "Pausing",
-                    "Paused",
-                )[svc[2][1]]
-            except:
-                status = "Unknown"
-            s = win32service.OpenService(
-                self.scm, svc[0], win32service.SERVICE_ALL_ACCESS
-            )
-            cfg = win32service.QueryServiceConfig(s)
-            try:
-                startup = ("Boot", "System", "Automatic", "Manual", "Disabled")[cfg[1]]
-            except:
-                startup = "Unknown"
-            win32service.CloseServiceHandle(s)
-
-            # svc[2][2] control buttons
-            pos = self.listCtrl.AddString(str(svc[1]) + "\t" + status + "\t" + startup)
-            self.listCtrl.SetItemData(pos, i)
-            self.data.append(
-                tuple(svc[2])
-                + (
-                    svc[1],
-                    svc[0],
-                )
-            )
-            i = i + 1
-
-            if service and service[1] == svc[0]:
-                self.listCtrl.SetCurSel(pos)
-        self.OnListEvent(self.IDC_LIST, win32con.LBN_SELCHANGE)
-        self.listCtrl.SetRedraw(1)
-
-    def OnListEvent(self, id, code):
-        if code == win32con.LBN_SELCHANGE or code == win32con.LBN_SELCANCEL:
-            pos = self.listCtrl.GetCurSel()
-            if pos >= 0:
-                data = self.data[self.listCtrl.GetItemData(pos)][2]
-                canstart = (
-                    self.data[self.listCtrl.GetItemData(pos)][1]
-                    == win32service.SERVICE_STOPPED
-                )
-            else:
-                data = 0
-                canstart = 0
-            self.GetDlgItem(self.IDC_START).EnableWindow(canstart)
-            self.GetDlgItem(self.IDC_STOP).EnableWindow(
-                data & win32service.SERVICE_ACCEPT_STOP
-            )
-            self.GetDlgItem(self.IDC_PAUSE).EnableWindow(
-                data & win32service.SERVICE_ACCEPT_PAUSE_CONTINUE
-            )
-            self.GetDlgItem(self.IDC_CONTINUE).EnableWindow(
-                data & win32service.SERVICE_ACCEPT_PAUSE_CONTINUE
-            )
-
-    def GetSelService(self):
-        pos = self.listCtrl.GetCurSel()
-        if pos < 0:
-            return None
-        pos = self.listCtrl.GetItemData(pos)
-        return self.data[pos][-2:]
-
-    def OnStartCmd(self, id, code):
-        service = self.GetSelService()
-        if not service:
-            return
-        s = win32service.OpenService(
-            self.scm, service[1], win32service.SERVICE_ALL_ACCESS
-        )
-        win32service.StartService(s, None)
-        win32service.CloseServiceHandle(s)
-        self.ReloadData()
-
-    def OnStopCmd(self, id, code):
-        service = self.GetSelService()
-        if not service:
-            return
-        s = win32service.OpenService(
-            self.scm, service[1], win32service.SERVICE_ALL_ACCESS
-        )
-        win32service.ControlService(s, win32service.SERVICE_CONTROL_STOP)
-        win32service.CloseServiceHandle(s)
-        self.ReloadData()
-
-    def OnPauseCmd(self, id, code):
-        service = self.GetSelService()
-        if not service:
-            return
-        s = win32service.OpenService(
-            self.scm, service[1], win32service.SERVICE_ALL_ACCESS
-        )
-        win32service.ControlService(s, win32service.SERVICE_CONTROL_PAUSE)
-        win32service.CloseServiceHandle(s)
-        self.ReloadData()
-
-    def OnContinueCmd(self, id, code):
-        service = self.GetSelService()
-        if not service:
-            return
-        s = win32service.OpenService(
-            self.scm, service[1], win32service.SERVICE_ALL_ACCESS
-        )
-        win32service.ControlService(s, win32service.SERVICE_CONTROL_CONTINUE)
-        win32service.CloseServiceHandle(s)
-        self.ReloadData()
-
-    def OnStartupCmd(self, id, code):
-        service = self.GetSelService()
-        if not service:
-            return
-        s = win32service.OpenService(
-            self.scm, service[1], win32service.SERVICE_ALL_ACCESS
-        )
-        if StartupDlg(service[0], s).DoModal() == win32con.IDOK:
-            self.ReloadData()
-
-    def GetResource(self):
-        style = (
-            win32con.WS_POPUP
-            | win32con.DS_SETFONT
-            | win32con.WS_SYSMENU
-            | win32con.WS_CAPTION
-            | win32con.WS_VISIBLE
-            | win32con.DS_MODALFRAME
-        )
-        exstyle = None
-        t = [
-            ["Services", (16, 16, 333, 157), style, exstyle, (8, "MS Shell Dlg")],
-        ]
-        t.append(
-            [
-                130,
-                "Ser&vice",
-                -1,
-                (6, 6, 70, 8),
-                win32con.WS_VISIBLE | win32con.WS_CHILD | win32con.SS_LEFT,
-            ]
-        )
-        t.append(
-            [
-                130,
-                "Status",
-                -1,
-                (164, 6, 42, 8),
-                win32con.WS_VISIBLE | win32con.WS_CHILD | win32con.SS_LEFT,
-            ]
-        )
-        t.append(
-            [
-                130,
-                "Startup",
-                -1,
-                (206, 6, 50, 8),
-                win32con.WS_VISIBLE | win32con.WS_CHILD | win32con.SS_LEFT,
-            ]
-        )
-        t.append(
-            [
-                131,
-                "",
-                self.IDC_LIST,
-                (6, 16, 255, 106),
-                win32con.LBS_USETABSTOPS
-                | win32con.LBS_SORT
-                | win32con.LBS_NOINTEGRALHEIGHT
-                | win32con.WS_BORDER
-                | win32con.WS_CHILD
-                | win32con.WS_VISIBLE
-                | win32con.WS_TABSTOP
-                | win32con.LBS_NOTIFY
-                | win32con.WS_VSCROLL,
-            ]
-        )
-        t.append(
-            [
-                128,
-                "Close",
-                win32con.IDOK,
-                (267, 6, 60, 14),
-                win32con.WS_VISIBLE
-                | win32con.WS_CHILD
-                | win32con.WS_GROUP
-                | win32con.WS_TABSTOP
-                | win32con.BS_DEFPUSHBUTTON,
-            ]
-        )
-        t.append(
-            [
-                128,
-                "&Start",
-                self.IDC_START,
-                (267, 27, 60, 14),
-                win32con.WS_VISIBLE
-                | win32con.WS_CHILD
-                | win32con.WS_TABSTOP
-                | win32con.BS_PUSHBUTTON,
-            ]
-        )
-        t.append(
-            [
-                128,
-                "S&top",
-                self.IDC_STOP,
-                (267, 44, 60, 14),
-                win32con.WS_VISIBLE
-                | win32con.WS_CHILD
-                | win32con.WS_TABSTOP
-                | win32con.BS_PUSHBUTTON,
-            ]
-        )
-        t.append(
-            [
-                128,
-                "&Pause",
-                self.IDC_PAUSE,
-                (267, 61, 60, 14),
-                win32con.WS_VISIBLE
-                | win32con.WS_CHILD
-                | win32con.WS_TABSTOP
-                | win32con.BS_PUSHBUTTON,
-            ]
-        )
-        t.append(
-            [
-                128,
-                "&Continue",
-                self.IDC_CONTINUE,
-                (267, 78, 60, 14),
-                win32con.WS_VISIBLE
-                | win32con.WS_CHILD
-                | win32con.WS_TABSTOP
-                | win32con.BS_PUSHBUTTON,
-            ]
-        )
-        t.append(
-            [
-                128,
-                "Sta&rtup...",
-                self.IDC_STARTUP,
-                (267, 99, 60, 14),
-                win32con.WS_VISIBLE
-                | win32con.WS_CHILD
-                | win32con.WS_TABSTOP
-                | win32con.BS_PUSHBUTTON,
-            ]
-        )
-        t.append(
-            [
-                128,
-                "H&W Profiles...",
-                self.IDC_PROFILES,
-                (267, 116, 60, 14),
-                win32con.WS_VISIBLE
-                | win32con.WS_CHILD
-                | win32con.WS_TABSTOP
-                | win32con.BS_PUSHBUTTON,
-            ]
-        )
-        t.append(
-            [
-                128,
-                "&Help",
-                win32con.IDHELP,
-                (267, 137, 60, 14),
-                win32con.WS_VISIBLE
-                | win32con.WS_CHILD
-                | win32con.WS_TABSTOP
-                | win32con.BS_PUSHBUTTON,
-            ]
-        )
-        t.append(
-            [
-                130,
-                "St&artup Parameters:",
-                -1,
-                (6, 128, 70, 8),
-                win32con.WS_VISIBLE | win32con.WS_CHILD | win32con.SS_LEFT,
-            ]
-        )
-        t.append(
-            [
-                129,
-                "",
-                self.IDC_PARAMS,
-                (6, 139, 247, 12),
-                win32con.WS_VISIBLE
-                | win32con.WS_CHILD
-                | win32con.WS_GROUP
-                | win32con.WS_BORDER
-                | win32con.ES_AUTOHSCROLL,
-            ]
-        )
-        return t
-
-
-if __name__ == "__main__":
-    import sys
-
-    machine = ""
-    if len(sys.argv) > 1:
-        machine = sys.argv[1]
-    ServiceDlg(machine).DoModal()
diff --git a/lib/win32/scripts/VersionStamp/BrandProject.py b/lib/win32/scripts/VersionStamp/BrandProject.py
deleted file mode 100644
index cc78d8d9..00000000
--- a/lib/win32/scripts/VersionStamp/BrandProject.py
+++ /dev/null
@@ -1,98 +0,0 @@
-# BrandProject.py
-#
-# Brand a VSS project with a "build number", then optionally
-# stamp DLL/EXE files with version information.
-
-import os
-import string
-import sys
-
-import bulkstamp
-import vssutil
-import win32api
-
-
-def BrandProject(
-    vssProjectName,
-    descFile,
-    stampPath,
-    filesToSubstitute,
-    buildDesc=None,
-    auto=0,
-    bRebrand=0,
-):
-    # vssProjectName -- The name of the VSS project to brand.
-    # descFile -- A test file containing descriptions of the files in the release.
-    # stampPath -- The full path to where the files referenced in descFile can be found.
-    path = win32api.GetFullPathName(stampPath)
-
-    build = vssutil.MakeNewBuildNo(vssProjectName, buildDesc, auto, bRebrand)
-    if build is None:
-        print("Cancelled")
-        return
-
-    bulkstamp.scan(build, stampPath, descFile)
-    for infile, outfile in filesToSubstitute:
-        SubstituteVSSInFile(vssProjectName, infile, outfile)
-    return 1
-
-
-def usage(msg):
-    print(msg)
-    print(
-        """\
-%s Usage:
-%s [options] vssProject descFile stampPath
-
-Automatically brand a VSS project with an automatically incremented
-build number, and stamp DLL/EXE files with the build number.
-
-Checks that no files are checked out in the project, and finds the last
-build number, and suggests the next number.
-
-Options:
--a     - Auto increment the build number, and brand (otherwise prompt
-         for the build number after looking for the previous)
--r     - Restamp the files with the existing build number.
--d     - A description for the VSS Label.
--f infile=outfile - Substitute special VSS labels in the specified text
-                    file with the text extracted from VSS.
-"""
-        % (os.path.basename(sys.argv[0]), os.path.basename(sys.argv[0]))
-    )
-    sys.exit(1)
-
-
-if __name__ == "__main__":
-    try:
-        import getopt
-
-        opts, args = getopt.getopt(sys.argv[1:], "af:d:r")
-    except getopts.error as msg:
-        usage(msg)
-    bAuto = bRebrand = 0
-    stampFiles = []
-    desc = None
-    for opt, val in opts:
-        if opt == "-a":
-            bAuto = 1
-        if opt == "-f":
-            infile, outfile = string.split(val, "=", 2)
-            stampFiles.append((infile, outfile))
-        if opt == "-d":
-            desc = val
-        if opt == "-r":
-            bRebrand = 1
-    if len(args) < 3:
-        usage("You must specify the required arguments")
-    vssProjectName = "$\\" + args[0]
-    descFile = args[1]
-    path = args[2]
-    try:
-        os.stat(descFile)
-    except IOError:
-        usage("The description file '%s' can not be found" % (descFile))
-    if not os.path.isdir(path):
-        usage("The path to the files to stamp '%s' does not exist" % (path))
-
-    BrandProject(vssProjectName, descFile, path, stampFiles, desc, bAuto, bRebrand)
diff --git a/lib/win32/scripts/VersionStamp/bulkstamp.py b/lib/win32/scripts/VersionStamp/bulkstamp.py
deleted file mode 100644
index 44f2a63e..00000000
--- a/lib/win32/scripts/VersionStamp/bulkstamp.py
+++ /dev/null
@@ -1,149 +0,0 @@
-#
-# bulkstamp.py:
-#    Stamp versions on all files that can be found in a given tree.
-#
-# USAGE: python bulkstamp.py <version> <root directory> <descriptions>
-#
-# Example: python bulkstamp.py 103 ..\win32\Build\ desc.txt
-#
-# <version> corresponds to the build number. It will be concatenated with
-# the major and minor version numbers found in the description file.
-#
-# Description information is pulled from an input text file with lines of
-# the form:
-#
-#    <basename> <white space> <description>
-#
-# For example:
-#
-#    PyWinTypes.dll Common types for Python on Win32
-#    etc
-#
-# The product's name, major, and minor versions are specified as:
-#
-#    name <white space> <value>
-#    major <white space> <value>
-#    minor <white space> <value>
-#
-# The tags are case-sensitive.
-#
-# Any line beginning with "#" will be ignored. Empty lines are okay.
-#
-
-import fnmatch
-import os
-import sys
-
-import verstamp
-import win32api
-
-numStamped = 0
-
-g_patterns = [
-    "*.dll",
-    "*.pyd",
-    "*.exe",
-    "*.ocx",
-]
-
-
-def walk(arg, dirname, names):
-    global numStamped
-    vars, debug, descriptions = arg
-    for name in names:
-        for pat in g_patterns:
-            if fnmatch.fnmatch(name, pat):
-                # Handle the "_d" thing.
-                pathname = os.path.join(dirname, name)
-                base, ext = os.path.splitext(name)
-                if base[-2:] == "_d":
-                    name = base[:-2] + ext
-                is_dll = ext.lower() != ".exe"
-                if os.path.normcase(name) in descriptions:
-                    desc = descriptions[os.path.normcase(name)]
-                    try:
-                        verstamp.stamp(vars, pathname, desc, is_dll=is_dll)
-                        numStamped = numStamped + 1
-                    except win32api.error as exc:
-                        print(
-                            "Could not stamp",
-                            pathname,
-                            "Error",
-                            exc.winerror,
-                            "-",
-                            exc.strerror,
-                        )
-                else:
-                    print("WARNING: description not provided for:", name)
-                    # skip branding this - assume already branded or handled elsewhere
-
-
-#        print "Stamped", pathname
-
-
-def load_descriptions(fname, vars):
-    retvars = {}
-    descriptions = {}
-
-    lines = open(fname, "r").readlines()
-
-    for i in range(len(lines)):
-        line = lines[i].strip()
-        if line != "" and line[0] != "#":
-            idx1 = line.find(" ")
-            idx2 = line.find("\t")
-            if idx1 == -1 or idx2 < idx1:
-                idx1 = idx2
-            if idx1 == -1:
-                print("ERROR: bad syntax in description file at line %d." % (i + 1))
-                sys.exit(1)
-
-            key = line[:idx1]
-            val = line[idx1:].strip()
-            if key in vars:
-                retvars[key] = val
-            else:
-                descriptions[key] = val
-
-    if "product" not in retvars:
-        print("ERROR: description file is missing the product name.")
-        sys.exit(1)
-    if "major" not in retvars:
-        print("ERROR: description file is missing the major version number.")
-        sys.exit(1)
-    if "minor" not in retvars:
-        print("ERROR: description file is missing the minor version number.")
-        sys.exit(1)
-
-    return retvars, descriptions
-
-
-def scan(build, root, desc, **custom_vars):
-    global numStamped
-    numStamped = 0
-    try:
-        build = int(build)
-    except ValueError:
-        print("ERROR: build number is not a number: %s" % build)
-        sys.exit(1)
-
-    debug = 0  ### maybe fix this one day
-
-    varList = ["major", "minor", "sub", "company", "copyright", "trademarks", "product"]
-
-    vars, descriptions = load_descriptions(desc, varList)
-    vars["build"] = build
-    vars.update(custom_vars)
-
-    arg = vars, debug, descriptions
-    os.path.walk(root, walk, arg)
-
-    print("Stamped %d files." % (numStamped))
-
-
-if __name__ == "__main__":
-    if len(sys.argv) != 4:
-        print("ERROR: incorrect invocation. See script's header comments.")
-        sys.exit(1)
-
-    scan(*tuple(sys.argv[1:]))
diff --git a/lib/win32/scripts/VersionStamp/vssutil.py b/lib/win32/scripts/VersionStamp/vssutil.py
deleted file mode 100644
index 6679ebc9..00000000
--- a/lib/win32/scripts/VersionStamp/vssutil.py
+++ /dev/null
@@ -1,204 +0,0 @@
-import string
-import time
-import traceback
-
-import pythoncom
-import win32com.client
-import win32com.client.gencache
-import win32con
-
-constants = win32com.client.constants
-
-win32com.client.gencache.EnsureModule("{783CD4E0-9D54-11CF-B8EE-00608CC9A71F}", 0, 5, 0)
-
-error = "vssutil error"
-
-
-def GetSS():
-    ss = win32com.client.Dispatch("SourceSafe")
-    # SS seems a bit weird.  It defaults the arguments as empty strings, but
-    # then complains when they are used - so we pass "Missing"
-    ss.Open(pythoncom.Missing, pythoncom.Missing, pythoncom.Missing)
-    return ss
-
-
-def test(projectName):
-    ss = GetSS()
-    project = ss.VSSItem(projectName)
-
-    for item in project.GetVersions(constants.VSSFLAG_RECURSYES):
-        print(item.VSSItem.Name, item.VersionNumber, item.Action)
-
-
-# 	item=i.Versions[0].VSSItem
-# 	for h in i.Versions:
-# 		print `h.Comment`, h.Action, h.VSSItem.Name
-
-
-def SubstituteInString(inString, evalEnv):
-    substChar = "$"
-    fields = string.split(inString, substChar)
-    newFields = []
-    for i in range(len(fields)):
-        didSubst = 0
-        strVal = fields[i]
-        if i % 2 != 0:
-            try:
-                strVal = eval(strVal, evalEnv[0], evalEnv[1])
-                newFields.append(strVal)
-                didSubst = 1
-            except:
-                traceback.print_exc()
-                print("Could not substitute", strVal)
-        if not didSubst:
-            newFields.append(strVal)
-    return string.join(map(str, newFields), "")
-
-
-def SubstituteInFile(inName, outName, evalEnv):
-    inFile = open(inName, "r")
-    try:
-        outFile = open(outName, "w")
-        try:
-            while 1:
-                line = inFile.read()
-                if not line:
-                    break
-                outFile.write(SubstituteInString(line, evalEnv))
-        finally:
-            outFile.close()
-    finally:
-        inFile.close()
-
-
-def VssLog(project, linePrefix="", noLabels=5, maxItems=150):
-    lines = []
-    num = 0
-    labelNum = 0
-    for i in project.GetVersions(constants.VSSFLAG_RECURSYES):
-        num = num + 1
-        if num > maxItems:
-            break
-        commentDesc = itemDesc = ""
-        if i.Action[:5] == "Added":
-            continue
-        if len(i.Label):
-            labelNum = labelNum + 1
-            itemDesc = i.Action
-        else:
-            itemDesc = i.VSSItem.Name
-            if str(itemDesc[-4:]) == ".dsp":
-                continue
-        if i.Comment:
-            commentDesc = "\n%s\t%s" % (linePrefix, i.Comment)
-        lines.append(
-            "%s%s\t%s%s"
-            % (
-                linePrefix,
-                time.asctime(time.localtime(int(i.Date))),
-                itemDesc,
-                commentDesc,
-            )
-        )
-        if labelNum > noLabels:
-            break
-    return string.join(lines, "\n")
-
-
-def SubstituteVSSInFile(projectName, inName, outName):
-    import win32api
-
-    if win32api.GetFullPathName(inName) == win32api.GetFullPathName(outName):
-        raise RuntimeError("The input and output filenames can not be the same")
-    sourceSafe = GetSS()
-    project = sourceSafe.VSSItem(projectName)
-    # Find the last label
-    label = None
-    for version in project.Versions:
-        if version.Label:
-            break
-    else:
-        print("Couldnt find a label in the sourcesafe project!")
-        return
-    # Setup some local helpers for the conversion strings.
-    vss_label = version.Label
-    vss_date = time.asctime(time.localtime(int(version.Date)))
-    now = time.asctime(time.localtime(time.time()))
-    SubstituteInFile(inName, outName, (locals(), globals()))
-
-
-def CountCheckouts(item):
-    num = 0
-    if item.Type == constants.VSSITEM_PROJECT:
-        for sub in item.Items:
-            num = num + CountCheckouts(sub)
-    else:
-        if item.IsCheckedOut:
-            num = num + 1
-    return num
-
-
-def GetLastBuildNo(project):
-    i = GetSS().VSSItem(project)
-    # Find the last label
-    lab = None
-    for version in i.Versions:
-        lab = str(version.Label)
-        if lab:
-            return lab
-    return None
-
-
-def MakeNewBuildNo(project, buildDesc=None, auto=0, bRebrand=0):
-    if buildDesc is None:
-        buildDesc = "Created by Python"
-    ss = GetSS()
-    i = ss.VSSItem(project)
-    num = CountCheckouts(i)
-    if num > 0:
-        msg = (
-            "This project has %d items checked out\r\n\r\nDo you still want to continue?"
-            % num
-        )
-        import win32ui
-
-        if win32ui.MessageBox(msg, project, win32con.MB_YESNO) != win32con.IDYES:
-            return
-
-    oldBuild = buildNo = GetLastBuildNo(project)
-    if buildNo is None:
-        buildNo = "1"
-        oldBuild = "<None>"
-    else:
-        try:
-            buildNo = string.atoi(buildNo)
-            if not bRebrand:
-                buildNo = buildNo + 1
-            buildNo = str(buildNo)
-        except ValueError:
-            raise error("The previous label could not be incremented: %s" % (oldBuild))
-
-    if not auto:
-        from pywin.mfc import dialog
-
-        buildNo = dialog.GetSimpleInput(
-            "Enter new build number", buildNo, "%s - Prev: %s" % (project, oldBuild)
-        )
-        if buildNo is None:
-            return
-    i.Label(buildNo, "Build %s: %s" % (buildNo, buildDesc))
-    if auto:
-        print("Branded project %s with label %s" % (project, buildNo))
-    return buildNo
-
-
-if __name__ == "__main__":
-    # 	UpdateWiseExeName("PyWiseTest.wse", "PyWiseTest-10.exe")
-
-    # 	MakeVersion()
-    # 	test(tp)
-    # 	MakeNewBuildNo(tp)
-    tp = "\\Python\\Python Win32 Extensions"
-    SubstituteVSSInFile(
-        tp, "d:\\src\\pythonex\\win32\\win32.txt", "d:\\temp\\win32.txt"
-    )
diff --git a/lib/win32/scripts/backupEventLog.py b/lib/win32/scripts/backupEventLog.py
deleted file mode 100644
index bc7d53fe..00000000
--- a/lib/win32/scripts/backupEventLog.py
+++ /dev/null
@@ -1,46 +0,0 @@
-# Generate a base file name
-import os
-import time
-
-import win32api
-import win32evtlog
-
-
-def BackupClearLog(logType):
-    datePrefix = time.strftime("%Y%m%d", time.localtime(time.time()))
-    fileExists = 1
-    retry = 0
-    while fileExists:
-        if retry == 0:
-            index = ""
-        else:
-            index = "-%d" % retry
-        try:
-            fname = os.path.join(
-                win32api.GetTempPath(),
-                "%s%s-%s" % (datePrefix, index, logType) + ".evt",
-            )
-            os.stat(fname)
-        except os.error:
-            fileExists = 0
-        retry = retry + 1
-    # OK - have unique file name.
-    try:
-        hlog = win32evtlog.OpenEventLog(None, logType)
-    except win32evtlogutil.error as details:
-        print("Could not open the event log", details)
-        return
-    try:
-        if win32evtlog.GetNumberOfEventLogRecords(hlog) == 0:
-            print("No records in event log %s - not backed up" % logType)
-            return
-        win32evtlog.ClearEventLog(hlog, fname)
-        print("Backed up %s log to %s" % (logType, fname))
-    finally:
-        win32evtlog.CloseEventLog(hlog)
-
-
-if __name__ == "__main__":
-    BackupClearLog("Application")
-    BackupClearLog("System")
-    BackupClearLog("Security")
diff --git a/lib/win32/scripts/ce/pysynch.py b/lib/win32/scripts/ce/pysynch.py
deleted file mode 100644
index 7a44e082..00000000
--- a/lib/win32/scripts/ce/pysynch.py
+++ /dev/null
@@ -1,290 +0,0 @@
-# Simple CE synchronisation utility with Python features.
-
-import fnmatch
-import getopt
-import os
-import string
-import sys
-
-import win32api
-import win32con
-import win32file
-import wincerapi
-
-
-class InvalidUsage(Exception):
-    pass
-
-
-def print_error(api_exc, msg):
-    hr, fn, errmsg = api_exc
-    print("%s - %s(%d)" % (msg, errmsg, hr))
-
-
-def GetFileAttributes(file, local=1):
-    if local:
-        return win32api.GetFileAttributes(file)
-    else:
-        return wincerapi.CeGetFileAttributes(file)
-
-
-def FindFiles(spec, local=1):
-    if local:
-        return win32api.FindFiles(spec)
-    else:
-        return wincerapi.CeFindFiles(spec)
-
-
-def isdir(name, local=1):
-    try:
-        attr = GetFileAttributes(name, local)
-        return attr & win32con.FILE_ATTRIBUTE_DIRECTORY
-    except win32api.error:
-        return 0
-
-
-def CopyFileToCe(src_name, dest_name, progress=None):
-    sh = win32file.CreateFile(
-        src_name, win32con.GENERIC_READ, 0, None, win32con.OPEN_EXISTING, 0, None
-    )
-    bytes = 0
-    try:
-        dh = wincerapi.CeCreateFile(
-            dest_name, win32con.GENERIC_WRITE, 0, None, win32con.OPEN_ALWAYS, 0, None
-        )
-        try:
-            while 1:
-                hr, data = win32file.ReadFile(sh, 2048)
-                if not data:
-                    break
-                wincerapi.CeWriteFile(dh, data)
-                bytes = bytes + len(data)
-                if progress is not None:
-                    progress(bytes)
-        finally:
-            pass
-            dh.Close()
-    finally:
-        sh.Close()
-    return bytes
-
-
-def BuildFileList(spec, local, recurse, filter, filter_args, recursed_path=""):
-    files = []
-    if isdir(spec, local):
-        path = spec
-        raw_spec = "*"
-    else:
-        path, raw_spec = os.path.split(spec)
-    if recurse:
-        # Need full scan, to get sub-direcetories.
-        infos = FindFiles(os.path.join(path, "*"), local)
-    else:
-        infos = FindFiles(os.path.join(path, raw_spec), local)
-    for info in infos:
-        src_name = str(info[8])
-        full_src_name = os.path.join(path, src_name)
-        if local:  # Can't do this for CE!
-            full_src_name = win32api.GetFullPathName(full_src_name)
-        if isdir(full_src_name, local):
-            if recurse and src_name not in [".", ".."]:
-                new_spec = os.path.join(full_src_name, raw_spec)
-                files = files + BuildFileList(
-                    new_spec,
-                    local,
-                    1,
-                    filter,
-                    filter_args,
-                    os.path.join(recursed_path, src_name),
-                )
-        if fnmatch.fnmatch(src_name, raw_spec):
-            rel_name = os.path.join(recursed_path, src_name)
-            filter_data = filter(full_src_name, rel_name, info, local, filter_args)
-            if filter_data is not None:
-                files.append((full_src_name, info, filter_data))
-    return files
-
-
-def _copyfilter(full_name, rel_name, info, local, bMaintainDir):
-    if isdir(full_name, local):
-        return
-    if bMaintainDir:
-        return rel_name
-    return os.path.split(rel_name)[1]
-
-
-import pywin.dialogs.status
-import win32ui
-
-
-class FileCopyProgressDialog(pywin.dialogs.status.CStatusProgressDialog):
-    def CopyProgress(self, bytes):
-        self.Set(bytes / 1024)
-
-
-def copy(args):
-    """copy src [src ...],  dest
-    Copy files to/from the CE device
-    """
-    bRecurse = bVerbose = 0
-    bMaintainDir = 1
-    try:
-        opts, args = getopt.getopt(args, "rv")
-    except getopt.error as details:
-        raise InvalidUsage(details)
-    for o, v in opts:
-        if o == "-r":
-            bRecuse = 1
-        elif o == "-v":
-            bVerbose = 1
-
-    if len(args) < 2:
-        raise InvalidUsage("Must specify a source and destination")
-
-    src = args[:-1]
-    dest = args[-1]
-    # See if WCE: leading anywhere indicates a direction.
-    if string.find(src[0], "WCE:") == 0:
-        bToDevice = 0
-    elif string.find(dest, "WCE:") == 0:
-        bToDevice = 1
-    else:
-        # Assume copy to device.
-        bToDevice = 1
-
-    if not isdir(dest, not bToDevice):
-        print("%s does not indicate a directory")
-
-    files = []  # List of FQ (from_name, to_name)
-    num_files = 0
-    num_bytes = 0
-    dialog = FileCopyProgressDialog("Copying files")
-    dialog.CreateWindow(win32ui.GetMainFrame())
-    if bToDevice:
-        for spec in src:
-            new = BuildFileList(spec, 1, bRecurse, _copyfilter, bMaintainDir)
-            if not new:
-                print("Warning: '%s' did not match any files" % (spec))
-            files = files + new
-
-        for full_src, src_info, dest_info in files:
-            dest_name = os.path.join(dest, dest_info)
-            size = src_info[5]
-            print("Size=", size)
-            if bVerbose:
-                print(full_src, "->", dest_name, "- ", end=" ")
-            dialog.SetText(dest_name)
-            dialog.Set(0, size / 1024)
-            bytes = CopyFileToCe(full_src, dest_name, dialog.CopyProgress)
-            num_bytes = num_bytes + bytes
-            if bVerbose:
-                print(bytes, "bytes")
-            num_files = num_files + 1
-    dialog.Close()
-    print("%d files copied (%d bytes)" % (num_files, num_bytes))
-
-
-def _dirfilter(*args):
-    return args[1]
-
-
-def dir(args):
-    """dir directory_name ...
-    Perform a directory listing on the remote device
-    """
-    bRecurse = 0
-    try:
-        opts, args = getopt.getopt(args, "r")
-    except getopt.error as details:
-        raise InvalidUsage(details)
-    for o, v in opts:
-        if o == "-r":
-            bRecurse = 1
-    for arg in args:
-        print("Directory of WCE:%s" % arg)
-        files = BuildFileList(arg, 0, bRecurse, _dirfilter, None)
-        total_size = 0
-        for full_name, info, rel_name in files:
-            date_str = info[3].Format("%d-%b-%Y %H:%M")
-            attr_string = "     "
-            if info[0] & win32con.FILE_ATTRIBUTE_DIRECTORY:
-                attr_string = "<DIR>"
-            print("%s  %s %10d %s" % (date_str, attr_string, info[5], rel_name))
-            total_size = total_size + info[5]
-        print(" " * 14 + "%3d files, %10d bytes" % (len(files), total_size))
-
-
-def run(args):
-    """run program [args]
-    Starts the specified program on the remote device.
-    """
-    prog_args = []
-    for arg in args:
-        if " " in arg:
-            prog_args.append('"' + arg + '"')
-        else:
-            prog_args.append(arg)
-    prog_args = string.join(prog_args, " ")
-    wincerapi.CeCreateProcess(prog_args, "", None, None, 0, 0, None, "", None)
-
-
-def delete(args):
-    """delete file, ...
-    Delete one or more remote files
-    """
-    for arg in args:
-        try:
-            wincerapi.CeDeleteFile(arg)
-            print("Deleted: %s" % arg)
-        except win32api.error as details:
-            print_error(details, "Error deleting '%s'" % arg)
-
-
-def DumpCommands():
-    print("%-10s - %s" % ("Command", "Description"))
-    print("%-10s - %s" % ("-------", "-----------"))
-    for name, item in list(globals().items()):
-        if type(item) == type(DumpCommands):
-            doc = getattr(item, "__doc__", "")
-            if doc:
-                lines = string.split(doc, "\n")
-                print("%-10s - %s" % (name, lines[0]))
-                for line in lines[1:]:
-                    if line:
-                        print(" " * 8, line)
-
-
-def main():
-    if len(sys.argv) < 2:
-        print("You must specify a command!")
-        DumpCommands()
-        return
-    command = sys.argv[1]
-    fn = globals().get(command)
-    if fn is None:
-        print("Unknown command:", command)
-        DumpCommands()
-        return
-
-    wincerapi.CeRapiInit()
-    try:
-        verinfo = wincerapi.CeGetVersionEx()
-        print(
-            "Connected to device, CE version %d.%d %s"
-            % (verinfo[0], verinfo[1], verinfo[4])
-        )
-        try:
-            fn(sys.argv[2:])
-        except InvalidUsage as msg:
-            print("Invalid syntax -", msg)
-            print(fn.__doc__)
-
-    finally:
-        try:
-            wincerapi.CeRapiUninit()
-        except win32api.error as details:
-            print_error(details, "Error disconnecting")
-
-
-if __name__ == "__main__":
-    main()
diff --git a/lib/win32/scripts/killProcName.py b/lib/win32/scripts/killProcName.py
deleted file mode 100644
index c9b399ff..00000000
--- a/lib/win32/scripts/killProcName.py
+++ /dev/null
@@ -1,62 +0,0 @@
-# Kills a process by process name
-#
-# Uses the Performance Data Helper to locate the PID, then kills it.
-# Will only kill the process if there is only one process of that name
-# (eg, attempting to kill "Python.exe" will only work if there is only
-# one Python.exe running.  (Note that the current process does not
-# count - ie, if Python.exe is hosting this script, you can still kill
-# another Python.exe (as long as there is only one other Python.exe)
-
-# Really just a demo for the win32pdh(util) module, which allows you
-# to get all sorts of information about a running process and many
-# other aspects of your system.
-
-import sys
-
-import win32api
-import win32con
-import win32pdhutil
-
-
-def killProcName(procname):
-    # Change suggested by Dan Knierim, who found that this performed a
-    # "refresh", allowing us to kill processes created since this was run
-    # for the first time.
-    try:
-        win32pdhutil.GetPerformanceAttributes("Process", "ID Process", procname)
-    except:
-        pass
-
-    pids = win32pdhutil.FindPerformanceAttributesByName(procname)
-
-    # If _my_ pid in there, remove it!
-    try:
-        pids.remove(win32api.GetCurrentProcessId())
-    except ValueError:
-        pass
-
-    if len(pids) == 0:
-        result = "Can't find %s" % procname
-    elif len(pids) > 1:
-        result = "Found too many %s's - pids=`%s`" % (procname, pids)
-    else:
-        handle = win32api.OpenProcess(win32con.PROCESS_TERMINATE, 0, pids[0])
-        win32api.TerminateProcess(handle, 0)
-        win32api.CloseHandle(handle)
-        result = ""
-
-    return result
-
-
-if __name__ == "__main__":
-    if len(sys.argv) > 1:
-        for procname in sys.argv[1:]:
-            result = killProcName(procname)
-            if result:
-                print(result)
-                print("Dumping all processes...")
-                win32pdhutil.ShowAllProcesses()
-            else:
-                print("Killed %s" % procname)
-    else:
-        print("Usage: killProcName.py procname ...")
diff --git a/lib/win32/scripts/rasutil.py b/lib/win32/scripts/rasutil.py
deleted file mode 100644
index e5a8922d..00000000
--- a/lib/win32/scripts/rasutil.py
+++ /dev/null
@@ -1,97 +0,0 @@
-# A demo of using the RAS API from Python
-import sys
-
-import win32ras
-
-
-# The error raised if we can not
-class ConnectionError(Exception):
-    pass
-
-
-def Connect(rasEntryName, numRetries=5):
-    """Make a connection to the specified RAS entry.
-
-    Returns a tuple of (bool, handle) on success.
-    - bool is 1 if a new connection was established, or 0 is a connection already existed.
-    - handle is a RAS HANDLE that can be passed to Disconnect() to end the connection.
-
-    Raises a ConnectionError if the connection could not be established.
-    """
-    assert numRetries > 0
-    for info in win32ras.EnumConnections():
-        if info[1].lower() == rasEntryName.lower():
-            print("Already connected to", rasEntryName)
-            return 0, info[0]
-
-    dial_params, have_pw = win32ras.GetEntryDialParams(None, rasEntryName)
-    if not have_pw:
-        print("Error: The password is not saved for this connection")
-        print(
-            "Please connect manually selecting the 'save password' option and try again"
-        )
-        sys.exit(1)
-
-    print("Connecting to", rasEntryName, "...")
-    retryCount = numRetries
-    while retryCount > 0:
-        rasHandle, errCode = win32ras.Dial(None, None, dial_params, None)
-        if win32ras.IsHandleValid(rasHandle):
-            bValid = 1
-            break
-        print("Retrying...")
-        win32api.Sleep(5000)
-        retryCount = retryCount - 1
-
-    if errCode:
-        raise ConnectionError(errCode, win32ras.GetErrorString(errCode))
-    return 1, rasHandle
-
-
-def Disconnect(handle):
-    if type(handle) == type(""):  # have they passed a connection name?
-        for info in win32ras.EnumConnections():
-            if info[1].lower() == handle.lower():
-                handle = info[0]
-                break
-        else:
-            raise ConnectionError(0, "Not connected to entry '%s'" % handle)
-
-    win32ras.HangUp(handle)
-
-
-usage = """rasutil.py - Utilities for using RAS
-
-Usage:
-  rasutil [-r retryCount] [-c rasname] [-d rasname]
-  
-  -r retryCount - Number of times to retry the RAS connection
-  -c rasname - Connect to the phonebook entry specified by rasname
-  -d rasname - Disconnect from the phonebook entry specified by rasname
-"""
-
-
-def Usage(why):
-    print(why)
-    print(usage)
-    sys.exit(1)
-
-
-if __name__ == "__main__":
-    import getopt
-
-    try:
-        opts, args = getopt.getopt(sys.argv[1:], "r:c:d:")
-    except getopt.error as why:
-        Usage(why)
-    retries = 5
-    if len(args) != 0:
-        Usage("Invalid argument")
-
-    for opt, val in opts:
-        if opt == "-c":
-            Connect(val, retries)
-        if opt == "-d":
-            Disconnect(val)
-        if opt == "-r":
-            retries = int(val)
diff --git a/lib/win32/scripts/regsetup.py b/lib/win32/scripts/regsetup.py
deleted file mode 100644
index 885698e1..00000000
--- a/lib/win32/scripts/regsetup.py
+++ /dev/null
@@ -1,612 +0,0 @@
-# A tool to setup the Python registry.
-
-
-class error(Exception):
-    pass
-
-
-import sys  # at least we can count on this!
-
-
-def FileExists(fname):
-    """Check if a file exists.  Returns true or false."""
-    import os
-
-    try:
-        os.stat(fname)
-        return 1
-    except os.error as details:
-        return 0
-
-
-def IsPackageDir(path, packageName, knownFileName):
-    """Given a path, a ni package name, and possibly a known file name in
-    the root of the package, see if this path is good.
-    """
-    import os
-
-    if knownFileName is None:
-        knownFileName = "."
-    return FileExists(os.path.join(os.path.join(path, packageName), knownFileName))
-
-
-def IsDebug():
-    """Return "_d" if we're running a debug version.
-
-    This is to be used within DLL names when locating them.
-    """
-    import importlib.machinery
-
-    return "_d" if "_d.pyd" in importlib.machinery.EXTENSION_SUFFIXES else ""
-
-
-def FindPackagePath(packageName, knownFileName, searchPaths):
-    """Find a package.
-
-    Given a ni style package name, check the package is registered.
-
-    First place looked is the registry for an existing entry.  Then
-    the searchPaths are searched.
-    """
-    import os
-
-    import regutil
-
-    pathLook = regutil.GetRegisteredNamedPath(packageName)
-    if pathLook and IsPackageDir(pathLook, packageName, knownFileName):
-        return pathLook, None  # The currently registered one is good.
-    # Search down the search paths.
-    for pathLook in searchPaths:
-        if IsPackageDir(pathLook, packageName, knownFileName):
-            # Found it
-            ret = os.path.abspath(pathLook)
-            return ret, ret
-    raise error("The package %s can not be located" % packageName)
-
-
-def FindHelpPath(helpFile, helpDesc, searchPaths):
-    # See if the current registry entry is OK
-    import os
-
-    import win32api
-    import win32con
-
-    try:
-        key = win32api.RegOpenKey(
-            win32con.HKEY_LOCAL_MACHINE,
-            "Software\\Microsoft\\Windows\\Help",
-            0,
-            win32con.KEY_ALL_ACCESS,
-        )
-        try:
-            try:
-                path = win32api.RegQueryValueEx(key, helpDesc)[0]
-                if FileExists(os.path.join(path, helpFile)):
-                    return os.path.abspath(path)
-            except win32api.error:
-                pass  # no registry entry.
-        finally:
-            key.Close()
-    except win32api.error:
-        pass
-    for pathLook in searchPaths:
-        if FileExists(os.path.join(pathLook, helpFile)):
-            return os.path.abspath(pathLook)
-        pathLook = os.path.join(pathLook, "Help")
-        if FileExists(os.path.join(pathLook, helpFile)):
-            return os.path.abspath(pathLook)
-    raise error("The help file %s can not be located" % helpFile)
-
-
-def FindAppPath(appName, knownFileName, searchPaths):
-    """Find an application.
-
-    First place looked is the registry for an existing entry.  Then
-    the searchPaths are searched.
-    """
-    # Look in the first path.
-    import os
-
-    import regutil
-
-    regPath = regutil.GetRegisteredNamedPath(appName)
-    if regPath:
-        pathLook = regPath.split(";")[0]
-    if regPath and FileExists(os.path.join(pathLook, knownFileName)):
-        return None  # The currently registered one is good.
-    # Search down the search paths.
-    for pathLook in searchPaths:
-        if FileExists(os.path.join(pathLook, knownFileName)):
-            # Found it
-            return os.path.abspath(pathLook)
-    raise error(
-        "The file %s can not be located for application %s" % (knownFileName, appName)
-    )
-
-
-def FindPythonExe(exeAlias, possibleRealNames, searchPaths):
-    """Find an exe.
-
-    Returns the full path to the .exe, and a boolean indicating if the current
-    registered entry is OK.  We don't trust the already registered version even
-    if it exists - it may be wrong (ie, for a different Python version)
-    """
-    import os
-    import sys
-
-    import regutil
-    import win32api
-
-    if possibleRealNames is None:
-        possibleRealNames = exeAlias
-    # Look first in Python's home.
-    found = os.path.join(sys.prefix, possibleRealNames)
-    if not FileExists(found):  # for developers
-        if "64 bit" in sys.version:
-            found = os.path.join(sys.prefix, "PCBuild", "amd64", possibleRealNames)
-        else:
-            found = os.path.join(sys.prefix, "PCBuild", possibleRealNames)
-    if not FileExists(found):
-        found = LocateFileName(possibleRealNames, searchPaths)
-
-    registered_ok = 0
-    try:
-        registered = win32api.RegQueryValue(
-            regutil.GetRootKey(), regutil.GetAppPathsKey() + "\\" + exeAlias
-        )
-        registered_ok = found == registered
-    except win32api.error:
-        pass
-    return found, registered_ok
-
-
-def QuotedFileName(fname):
-    """Given a filename, return a quoted version if necessary"""
-
-    import regutil
-
-    try:
-        fname.index(" ")  # Other chars forcing quote?
-        return '"%s"' % fname
-    except ValueError:
-        # No space in name.
-        return fname
-
-
-def LocateFileName(fileNamesString, searchPaths):
-    """Locate a file name, anywhere on the search path.
-
-    If the file can not be located, prompt the user to find it for us
-    (using a common OpenFile dialog)
-
-    Raises KeyboardInterrupt if the user cancels.
-    """
-    import os
-
-    import regutil
-
-    fileNames = fileNamesString.split(";")
-    for path in searchPaths:
-        for fileName in fileNames:
-            try:
-                retPath = os.path.join(path, fileName)
-                os.stat(retPath)
-                break
-            except os.error:
-                retPath = None
-        if retPath:
-            break
-    else:
-        fileName = fileNames[0]
-        try:
-            import win32con
-            import win32ui
-        except ImportError:
-            raise error(
-                "Need to locate the file %s, but the win32ui module is not available\nPlease run the program again, passing as a parameter the path to this file."
-                % fileName
-            )
-        # Display a common dialog to locate the file.
-        flags = win32con.OFN_FILEMUSTEXIST
-        ext = os.path.splitext(fileName)[1]
-        filter = "Files of requested type (*%s)|*%s||" % (ext, ext)
-        dlg = win32ui.CreateFileDialog(1, None, fileName, flags, filter, None)
-        dlg.SetOFNTitle("Locate " + fileName)
-        if dlg.DoModal() != win32con.IDOK:
-            raise KeyboardInterrupt("User cancelled the process")
-        retPath = dlg.GetPathName()
-    return os.path.abspath(retPath)
-
-
-def LocatePath(fileName, searchPaths):
-    """Like LocateFileName, but returns a directory only."""
-    import os
-
-    return os.path.abspath(os.path.split(LocateFileName(fileName, searchPaths))[0])
-
-
-def LocateOptionalPath(fileName, searchPaths):
-    """Like LocatePath, but returns None if the user cancels."""
-    try:
-        return LocatePath(fileName, searchPaths)
-    except KeyboardInterrupt:
-        return None
-
-
-def LocateOptionalFileName(fileName, searchPaths=None):
-    """Like LocateFileName, but returns None if the user cancels."""
-    try:
-        return LocateFileName(fileName, searchPaths)
-    except KeyboardInterrupt:
-        return None
-
-
-def LocatePythonCore(searchPaths):
-    """Locate and validate the core Python directories.  Returns a list
-    of paths that should be used as the core (ie, un-named) portion of
-    the Python path.
-    """
-    import os
-
-    import regutil
-
-    currentPath = regutil.GetRegisteredNamedPath(None)
-    if currentPath:
-        presearchPaths = currentPath.split(";")
-    else:
-        presearchPaths = [os.path.abspath(".")]
-    libPath = None
-    for path in presearchPaths:
-        if FileExists(os.path.join(path, "os.py")):
-            libPath = path
-            break
-    if libPath is None and searchPaths is not None:
-        libPath = LocatePath("os.py", searchPaths)
-    if libPath is None:
-        raise error("The core Python library could not be located.")
-
-    corePath = None
-    suffix = IsDebug()
-    for path in presearchPaths:
-        if FileExists(os.path.join(path, "unicodedata%s.pyd" % suffix)):
-            corePath = path
-            break
-    if corePath is None and searchPaths is not None:
-        corePath = LocatePath("unicodedata%s.pyd" % suffix, searchPaths)
-    if corePath is None:
-        raise error("The core Python path could not be located.")
-
-    installPath = os.path.abspath(os.path.join(libPath, ".."))
-    return installPath, [libPath, corePath]
-
-
-def FindRegisterPackage(packageName, knownFile, searchPaths, registryAppName=None):
-    """Find and Register a package.
-
-    Assumes the core registry setup correctly.
-
-    In addition, if the location located by the package is already
-    in the **core** path, then an entry is registered, but no path.
-    (no other paths are checked, as the application whose path was used
-    may later be uninstalled.  This should not happen with the core)
-    """
-
-    import regutil
-
-    if not packageName:
-        raise error("A package name must be supplied")
-    corePaths = regutil.GetRegisteredNamedPath(None).split(";")
-    if not searchPaths:
-        searchPaths = corePaths
-    registryAppName = registryAppName or packageName
-    try:
-        pathLook, pathAdd = FindPackagePath(packageName, knownFile, searchPaths)
-        if pathAdd is not None:
-            if pathAdd in corePaths:
-                pathAdd = ""
-            regutil.RegisterNamedPath(registryAppName, pathAdd)
-        return pathLook
-    except error as details:
-        print(
-            "*** The %s package could not be registered - %s" % (packageName, details)
-        )
-        print(
-            "*** Please ensure you have passed the correct paths on the command line."
-        )
-        print(
-            "*** - For packages, you should pass a path to the packages parent directory,"
-        )
-        print("*** - and not the package directory itself...")
-
-
-def FindRegisterApp(appName, knownFiles, searchPaths):
-    """Find and Register a package.
-
-    Assumes the core registry setup correctly.
-
-    """
-
-    import regutil
-
-    if type(knownFiles) == type(""):
-        knownFiles = [knownFiles]
-    paths = []
-    try:
-        for knownFile in knownFiles:
-            pathLook = FindAppPath(appName, knownFile, searchPaths)
-            if pathLook:
-                paths.append(pathLook)
-    except error as details:
-        print("*** ", details)
-        return
-
-    regutil.RegisterNamedPath(appName, ";".join(paths))
-
-
-def FindRegisterPythonExe(exeAlias, searchPaths, actualFileNames=None):
-    """Find and Register a Python exe (not necessarily *the* python.exe)
-
-    Assumes the core registry setup correctly.
-    """
-
-    import regutil
-
-    fname, ok = FindPythonExe(exeAlias, actualFileNames, searchPaths)
-    if not ok:
-        regutil.RegisterPythonExe(fname, exeAlias)
-    return fname
-
-
-def FindRegisterHelpFile(helpFile, searchPaths, helpDesc=None):
-    import regutil
-
-    try:
-        pathLook = FindHelpPath(helpFile, helpDesc, searchPaths)
-    except error as details:
-        print("*** ", details)
-        return
-    #       print "%s found at %s" % (helpFile, pathLook)
-    regutil.RegisterHelpFile(helpFile, pathLook, helpDesc)
-
-
-def SetupCore(searchPaths):
-    """Setup the core Python information in the registry.
-
-    This function makes no assumptions about the current state of sys.path.
-
-    After this function has completed, you should have access to the standard
-    Python library, and the standard Win32 extensions
-    """
-
-    import sys
-
-    for path in searchPaths:
-        sys.path.append(path)
-
-    import os
-
-    import regutil
-    import win32api
-    import win32con
-
-    installPath, corePaths = LocatePythonCore(searchPaths)
-    # Register the core Pythonpath.
-    print(corePaths)
-    regutil.RegisterNamedPath(None, ";".join(corePaths))
-
-    # Register the install path.
-    hKey = win32api.RegCreateKey(regutil.GetRootKey(), regutil.BuildDefaultPythonKey())
-    try:
-        # Core Paths.
-        win32api.RegSetValue(hKey, "InstallPath", win32con.REG_SZ, installPath)
-    finally:
-        win32api.RegCloseKey(hKey)
-
-    # Register the win32 core paths.
-    win32paths = (
-        os.path.abspath(os.path.split(win32api.__file__)[0])
-        + ";"
-        + os.path.abspath(
-            os.path.split(LocateFileName("win32con.py;win32con.pyc", sys.path))[0]
-        )
-    )
-
-    # Python has builtin support for finding a "DLLs" directory, but
-    # not a PCBuild.  Having it in the core paths means it is ignored when
-    # an EXE not in the Python dir is hosting us - so we add it as a named
-    # value
-    check = os.path.join(sys.prefix, "PCBuild")
-    if "64 bit" in sys.version:
-        check = os.path.join(check, "amd64")
-    if os.path.isdir(check):
-        regutil.RegisterNamedPath("PCBuild", check)
-
-
-def RegisterShellInfo(searchPaths):
-    """Registers key parts of the Python installation with the Windows Shell.
-
-    Assumes a valid, minimal Python installation exists
-    (ie, SetupCore() has been previously successfully run)
-    """
-    import regutil
-    import win32con
-
-    suffix = IsDebug()
-    # Set up a pointer to the .exe's
-    exePath = FindRegisterPythonExe("Python%s.exe" % suffix, searchPaths)
-    regutil.SetRegistryDefaultValue(".py", "Python.File", win32con.HKEY_CLASSES_ROOT)
-    regutil.RegisterShellCommand("Open", QuotedFileName(exePath) + ' "%1" %*', "&Run")
-    regutil.SetRegistryDefaultValue(
-        "Python.File\\DefaultIcon", "%s,0" % exePath, win32con.HKEY_CLASSES_ROOT
-    )
-
-    FindRegisterHelpFile("Python.hlp", searchPaths, "Main Python Documentation")
-    FindRegisterHelpFile("ActivePython.chm", searchPaths, "Main Python Documentation")
-
-    # We consider the win32 core, as it contains all the win32 api type
-    # stuff we need.
-
-
-#       FindRegisterApp("win32", ["win32con.pyc", "win32api%s.pyd" % suffix], searchPaths)
-
-usage = (
-    """\
-regsetup.py - Setup/maintain the registry for Python apps.
-
-Run without options, (but possibly search paths) to repair a totally broken
-python registry setup.  This should allow other options to work.
-
-Usage:   %s [options ...] paths ...
--p packageName  -- Find and register a package.  Looks in the paths for
-                   a sub-directory with the name of the package, and
-                   adds a path entry for the package.
--a appName      -- Unconditionally add an application name to the path.
-                   A new path entry is create with the app name, and the
-                   paths specified are added to the registry.
--c              -- Add the specified paths to the core Pythonpath.
-                   If a path appears on the core path, and a package also
-                   needs that same path, the package will not bother
-                   registering it.  Therefore, By adding paths to the
-                   core path, you can avoid packages re-registering the same path.
--m filename     -- Find and register the specific file name as a module.
-                   Do not include a path on the filename!
---shell         -- Register everything with the Win95/NT shell.
---upackage name -- Unregister the package
---uapp name     -- Unregister the app (identical to --upackage)
---umodule name  -- Unregister the module
-
---description   -- Print a description of the usage.
---examples      -- Print examples of usage.
-"""
-    % sys.argv[0]
-)
-
-description = """\
-If no options are processed, the program attempts to validate and set
-the standard Python path to the point where the standard library is
-available.  This can be handy if you move Python to a new drive/sub-directory,
-in which case most of the options would fail (as they need at least string.py,
-os.py etc to function.)
-Running without options should repair Python well enough to run with
-the other options.
-
-paths are search paths that the program will use to seek out a file.
-For example, when registering the core Python, you may wish to
-provide paths to non-standard places to look for the Python help files,
-library files, etc.
-
-See also the "regcheck.py" utility which will check and dump the contents
-of the registry.
-"""
-
-examples = """\
-Examples:
-"regsetup c:\\wierd\\spot\\1 c:\\wierd\\spot\\2"
-Attempts to setup the core Python.  Looks in some standard places,
-as well as the 2 wierd spots to locate the core Python files (eg, Python.exe,
-python14.dll, the standard library and Win32 Extensions.
-
-"regsetup -a myappname . .\subdir"
-Registers a new Pythonpath entry named myappname, with "C:\\I\\AM\\HERE" and
-"C:\\I\\AM\\HERE\subdir" added to the path (ie, all args are converted to
-absolute paths)
-
-"regsetup -c c:\\my\\python\\files"
-Unconditionally add "c:\\my\\python\\files" to the 'core' Python path.
-
-"regsetup -m some.pyd \\windows\\system"
-Register the module some.pyd in \\windows\\system as a registered
-module.  This will allow some.pyd to be imported, even though the
-windows system directory is not (usually!) on the Python Path.
-
-"regsetup --umodule some"
-Unregister the module "some".  This means normal import rules then apply
-for that module.
-"""
-
-if __name__ == "__main__":
-    if len(sys.argv) > 1 and sys.argv[1] in ["/?", "-?", "-help", "-h"]:
-        print(usage)
-    elif len(sys.argv) == 1 or not sys.argv[1][0] in ["/", "-"]:
-        # No args, or useful args.
-        searchPath = sys.path[:]
-        for arg in sys.argv[1:]:
-            searchPath.append(arg)
-        # Good chance we are being run from the "regsetup.py" directory.
-        # Typically this will be "\somewhere\win32\Scripts" and the
-        # "somewhere" and "..\Lib" should also be searched.
-        searchPath.append("..\\Build")
-        searchPath.append("..\\Lib")
-        searchPath.append("..")
-        searchPath.append("..\\..")
-
-        # for developers:
-        # also search somewhere\lib, ..\build, and ..\..\build
-        searchPath.append("..\\..\\lib")
-        searchPath.append("..\\build")
-        if "64 bit" in sys.version:
-            searchPath.append("..\\..\\pcbuild\\amd64")
-        else:
-            searchPath.append("..\\..\\pcbuild")
-
-        print("Attempting to setup/repair the Python core")
-
-        SetupCore(searchPath)
-        RegisterShellInfo(searchPath)
-        FindRegisterHelpFile("PyWin32.chm", searchPath, "Pythonwin Reference")
-        # Check the registry.
-        print("Registration complete - checking the registry...")
-        import regcheck
-
-        regcheck.CheckRegistry()
-    else:
-        searchPaths = []
-        import getopt
-
-        opts, args = getopt.getopt(
-            sys.argv[1:],
-            "p:a:m:c",
-            ["shell", "upackage=", "uapp=", "umodule=", "description", "examples"],
-        )
-        for arg in args:
-            searchPaths.append(arg)
-        for o, a in opts:
-            if o == "--description":
-                print(description)
-            if o == "--examples":
-                print(examples)
-            if o == "--shell":
-                print("Registering the Python core.")
-                RegisterShellInfo(searchPaths)
-            if o == "-p":
-                print("Registering package", a)
-                FindRegisterPackage(a, None, searchPaths)
-            if o in ["--upackage", "--uapp"]:
-                import regutil
-
-                print("Unregistering application/package", a)
-                regutil.UnregisterNamedPath(a)
-            if o == "-a":
-                import regutil
-
-                path = ";".join(searchPaths)
-                print("Registering application", a, "to path", path)
-                regutil.RegisterNamedPath(a, path)
-            if o == "-c":
-                if not len(searchPaths):
-                    raise error("-c option must provide at least one additional path")
-                import regutil
-                import win32api
-
-                currentPaths = regutil.GetRegisteredNamedPath(None).split(";")
-                oldLen = len(currentPaths)
-                for newPath in searchPaths:
-                    if newPath not in currentPaths:
-                        currentPaths.append(newPath)
-                if len(currentPaths) != oldLen:
-                    print(
-                        "Registering %d new core paths" % (len(currentPaths) - oldLen)
-                    )
-                    regutil.RegisterNamedPath(None, ";".join(currentPaths))
-                else:
-                    print("All specified paths are already registered.")
diff --git a/lib/win32/scripts/setup_d.py b/lib/win32/scripts/setup_d.py
deleted file mode 100644
index babd8359..00000000
--- a/lib/win32/scripts/setup_d.py
+++ /dev/null
@@ -1,110 +0,0 @@
-# Install and register pythonxx_d.dll, pywintypesxx_d.dll and pythoncomxx_d.dll
-#
-# Assumes the _d files can be found in the same directory as this script
-# or in the cwd.
-
-import os
-import shutil
-import sys
-import winreg
-
-import win32api
-
-
-def usage_and_die(rc):
-    print()
-    print("This script is designed to copy and register the Python debug")
-    print("binaries.  It looks for pythonxx_d.dll, pythoncomxx_d.dll etc,")
-    print("and installs them to work correctly with Python debug builds.")
-    print()
-    print("You will generally find this script in the. zip file that")
-    print("included these _d files.  Please run this script from")
-    print("that directory")
-    sys.exit(rc)
-
-
-if win32api.__file__.find("_d") > 0:
-    print("This scripts appears to be running a DEBUG version of Python.")
-    print("Please run it using a normal release build (python.exe)")
-    usage_and_die(1)
-
-try:
-    import pythoncom
-except ImportError as details:
-    print("Could not import the release version of pythoncom")
-    print("The error details are: %s" % (details,))
-    print("Please correct this error and rerun the script")
-    usage_and_die(2)
-
-try:
-    import pywintypes
-except ImportError as details:
-    print("Could not import the release version of pywintypes")
-    print("The error details are: %s" % (details,))
-    print("Please correct this error and rerun the script")
-    usage_and_die(2)
-
-
-def _docopy(src, dest):
-    orig_src = src
-    if not os.path.isfile(src):
-        src = os.path.join(os.path.split(sys.argv[0])[0], src)
-        print(
-            "Can not find %s or %s to copy"
-            % (os.path.abspath(orig_src), os.path.abspath(src))
-        )
-        return 0
-    try:
-        shutil.copy(src, dest)
-        print("Copied %s -> %s" % (src, dest))
-        return 1
-    except:
-        print("Error copying '%s' -> '%s'" % (src, dest))
-        print(str(sys.exc_info[1]))
-        usage_and_die(3)
-
-
-def _doregister(mod_name, dll_name):
-    assert os.path.isfile(dll_name), "Shouldn't get here if the file doesn't exist!"
-    try:
-        key = winreg.OpenKey(
-            winreg.HKEY_LOCAL_MACHINE,
-            "Software\\Python\\PythonCore\\%s\\Modules\\%s" % (sys.winver, mod_name),
-        )
-    except winreg.error:
-        try:
-            key = winreg.OpenKey(
-                winreg.HKEY_LOCAL_MACHINE,
-                "Software\\Python\\PythonCore\\%s\\Modules\\%s"
-                % (sys.winver, mod_name),
-            )
-        except winreg.error:
-            print(
-                "Could not find the existing '%s' module registered in the registry"
-                % (mod_name,)
-            )
-            usage_and_die(4)
-    # Create the debug key.
-    sub_key = winreg.CreateKey(key, "Debug")
-    winreg.SetValue(sub_key, None, winreg.REG_SZ, dll_name)
-    print("Registered '%s' in the registry" % (dll_name,))
-
-
-def _domodule(mod_name, release_mod_filename):
-    path, fname = os.path.split(release_mod_filename)
-    base, ext = os.path.splitext(fname)
-    new_fname = base + "_d" + ext
-    if _docopy(new_fname, path):
-        _doregister(mod_name, os.path.abspath(os.path.join(path, new_fname)))
-
-
-# First the main Python DLL.
-path, fname = path, fname = os.path.split(win32api.GetModuleFileName(sys.dllhandle))
-base, ext = os.path.splitext(fname)
-_docopy(base + "_d" + ext, path)
-
-# Then pythoncom and pywintypes.
-_domodule("pythoncom", pythoncom.__file__)
-_domodule("pywintypes", pywintypes.__file__)
-
-print("System _d files were setup.")
diff --git a/lib/win32/test/handles.py b/lib/win32/test/handles.py
deleted file mode 100644
index ad607353..00000000
--- a/lib/win32/test/handles.py
+++ /dev/null
@@ -1,171 +0,0 @@
-import sys
-import unittest
-
-import pywintypes
-import win32api
-
-
-# A class that will never die vie refcounting, but will die via GC.
-class Cycle:
-    def __init__(self, handle):
-        self.cycle = self
-        self.handle = handle
-
-
-class PyHandleTestCase(unittest.TestCase):
-    def testCleanup1(self):
-        # We used to clobber all outstanding exceptions.
-        def f1(invalidate):
-            import win32event
-
-            h = win32event.CreateEvent(None, 0, 0, None)
-            if invalidate:
-                win32api.CloseHandle(int(h))
-            1 / 0
-            # If we invalidated, then the object destruction code will attempt
-            # to close an invalid handle.  We don't wan't an exception in
-            # this case
-
-        def f2(invalidate):
-            """This function should throw an IOError."""
-            try:
-                f1(invalidate)
-            except ZeroDivisionError as exc:
-                raise IOError("raise 2")
-
-        self.assertRaises(IOError, f2, False)
-        # Now do it again, but so the auto object destruction
-        # actually fails.
-        self.assertRaises(IOError, f2, True)
-
-    def testCleanup2(self):
-        # Cause an exception during object destruction.
-        # The worst this does is cause an ".XXX undetected error (why=3)"
-        # So avoiding that is the goal
-        import win32event
-
-        h = win32event.CreateEvent(None, 0, 0, None)
-        # Close the handle underneath the object.
-        win32api.CloseHandle(int(h))
-        # Object destructor runs with the implicit close failing
-        h = None
-
-    def testCleanup3(self):
-        # And again with a class - no __del__
-        import win32event
-
-        class Test:
-            def __init__(self):
-                self.h = win32event.CreateEvent(None, 0, 0, None)
-                win32api.CloseHandle(int(self.h))
-
-        t = Test()
-        t = None
-
-    def testCleanupGood(self):
-        # And check that normal error semantics *do* work.
-        import win32event
-
-        h = win32event.CreateEvent(None, 0, 0, None)
-        win32api.CloseHandle(int(h))
-        self.assertRaises(win32api.error, h.Close)
-        # A following Close is documented as working
-        h.Close()
-
-    def testInvalid(self):
-        h = pywintypes.HANDLE(-2)
-        try:
-            h.Close()
-            # Ideally, we'd:
-            #     self.assertRaises(win32api.error, h.Close)
-            # and everywhere markh has tried, that would pass - but not on
-            # github automation, where the .Close apparently works fine.
-            # (same for -1. Using 0 appears to work fine everywhere)
-            # There still seems value in testing it though, so we just accept
-            # either working or failing.
-        except win32api.error:
-            pass
-
-    def testOtherHandle(self):
-        h = pywintypes.HANDLE(1)
-        h2 = pywintypes.HANDLE(h)
-        self.assertEqual(h, h2)
-        # but the above doesn't really test everything - we want a way to
-        # pass the handle directly into PyWinLong_AsVoidPtr.  One way to
-        # to that is to abuse win32api.GetProcAddress() - the 2nd param
-        # is passed to PyWinLong_AsVoidPtr() if its not a string.
-        # passing a handle value of '1' should work - there is something
-        # at that ordinal
-        win32api.GetProcAddress(sys.dllhandle, h)
-
-    def testHandleInDict(self):
-        h = pywintypes.HANDLE(1)
-        d = dict(foo=h)
-        self.assertEqual(d["foo"], h)
-
-    def testHandleInDictThenInt(self):
-        h = pywintypes.HANDLE(1)
-        d = dict(foo=h)
-        self.assertEqual(d["foo"], 1)
-
-    def testHandleCompareNone(self):
-        h = pywintypes.HANDLE(1)
-        self.assertNotEqual(h, None)
-        self.assertNotEqual(None, h)
-        # ensure we use both __eq__ and __ne__ ops
-        self.assertFalse(h == None)
-        self.assertTrue(h != None)
-
-    def testHandleCompareInt(self):
-        h = pywintypes.HANDLE(1)
-        self.assertNotEqual(h, 0)
-        self.assertEqual(h, 1)
-        # ensure we use both __eq__ and __ne__ ops
-        self.assertTrue(h == 1)
-        self.assertTrue(1 == h)
-        self.assertFalse(h != 1)
-        self.assertFalse(1 != h)
-        self.assertFalse(h == 0)
-        self.assertFalse(0 == h)
-        self.assertTrue(h != 0)
-        self.assertTrue(0 != h)
-
-    def testHandleNonZero(self):
-        h = pywintypes.HANDLE(0)
-        self.assertFalse(h)
-
-        h = pywintypes.HANDLE(1)
-        self.assertTrue(h)
-
-    def testLong(self):
-        # sys.maxint+1 should always be a 'valid' handle, treated as an
-        # unsigned int, even though it is a long. Although pywin32 should not
-        # directly create such longs, using struct.unpack() with a P format
-        # may well return them. eg:
-        # >>> struct.unpack("P", struct.pack("P", -1))
-        # (4294967295L,)
-        try:
-            big = sys.maxsize
-        except AttributeError:
-            big = sys.maxint
-        pywintypes.HANDLE(big + 1)
-
-    def testGC(self):
-        # This used to provoke:
-        # Fatal Python error: unexpected exception during garbage collection
-        def make():
-            h = pywintypes.HANDLE(-2)
-            c = Cycle(h)
-
-        import gc
-
-        make()
-        gc.collect()
-
-    def testTypes(self):
-        self.assertRaises(TypeError, pywintypes.HANDLE, "foo")
-        self.assertRaises(TypeError, pywintypes.HANDLE, ())
-
-
-if __name__ == "__main__":
-    unittest.main()
diff --git a/lib/win32/test/test_clipboard.py b/lib/win32/test/test_clipboard.py
deleted file mode 100644
index 843435b6..00000000
--- a/lib/win32/test/test_clipboard.py
+++ /dev/null
@@ -1,127 +0,0 @@
-# General test module for win32api - please add some :)
-import array
-import os
-import sys
-import unittest
-
-import pywintypes
-import win32con
-import win32gui
-from pywin32_testutil import str2bytes
-from win32clipboard import *
-
-custom_format_name = "PythonClipboardTestFormat"
-
-
-class CrashingTestCase(unittest.TestCase):
-    def test_722082(self):
-        class crasher(object):
-            pass
-
-        obj = crasher()
-        OpenClipboard()
-        try:
-            EmptyClipboard()
-            # This used to crash - now correctly raises type error.
-            self.assertRaises(TypeError, SetClipboardData, 0, obj)
-        finally:
-            CloseClipboard()
-
-
-class TestBitmap(unittest.TestCase):
-    def setUp(self):
-        self.bmp_handle = None
-        try:
-            this_file = __file__
-        except NameError:
-            this_file = sys.argv[0]
-        this_dir = os.path.dirname(this_file)
-        self.bmp_name = os.path.join(
-            os.path.abspath(this_dir), "..", "Demos", "images", "smiley.bmp"
-        )
-        self.assertTrue(os.path.isfile(self.bmp_name), self.bmp_name)
-        flags = win32con.LR_DEFAULTSIZE | win32con.LR_LOADFROMFILE
-        self.bmp_handle = win32gui.LoadImage(
-            0, self.bmp_name, win32con.IMAGE_BITMAP, 0, 0, flags
-        )
-        self.assertTrue(self.bmp_handle, "Failed to get a bitmap handle")
-
-    def tearDown(self):
-        if self.bmp_handle:
-            win32gui.DeleteObject(self.bmp_handle)
-
-    def test_bitmap_roundtrip(self):
-        OpenClipboard()
-        try:
-            SetClipboardData(win32con.CF_BITMAP, self.bmp_handle)
-            got_handle = GetClipboardDataHandle(win32con.CF_BITMAP)
-            self.assertEqual(got_handle, self.bmp_handle)
-        finally:
-            CloseClipboard()
-
-
-class TestStrings(unittest.TestCase):
-    def setUp(self):
-        OpenClipboard()
-
-    def tearDown(self):
-        CloseClipboard()
-
-    def test_unicode(self):
-        val = "test-\a9har"
-        SetClipboardData(win32con.CF_UNICODETEXT, val)
-        self.assertEqual(GetClipboardData(win32con.CF_UNICODETEXT), val)
-
-    def test_unicode_text(self):
-        val = "test-val"
-        SetClipboardText(val)
-        # GetClipboardData doesn't to auto string conversions - so on py3k,
-        # CF_TEXT returns bytes.
-        expected = str2bytes(val)
-        self.assertEqual(GetClipboardData(win32con.CF_TEXT), expected)
-        SetClipboardText(val, win32con.CF_UNICODETEXT)
-        self.assertEqual(GetClipboardData(win32con.CF_UNICODETEXT), val)
-
-    def test_string(self):
-        val = str2bytes("test")
-        SetClipboardData(win32con.CF_TEXT, val)
-        self.assertEqual(GetClipboardData(win32con.CF_TEXT), val)
-
-
-class TestGlobalMemory(unittest.TestCase):
-    def setUp(self):
-        OpenClipboard()
-
-    def tearDown(self):
-        CloseClipboard()
-
-    def test_mem(self):
-        val = str2bytes("test")
-        expected = str2bytes("test\0")
-        SetClipboardData(win32con.CF_TEXT, val)
-        # Get the raw data - this will include the '\0'
-        raw_data = GetGlobalMemory(GetClipboardDataHandle(win32con.CF_TEXT))
-        self.assertEqual(expected, raw_data)
-
-    def test_bad_mem(self):
-        self.assertRaises(pywintypes.error, GetGlobalMemory, 0)
-        self.assertRaises(pywintypes.error, GetGlobalMemory, -1)
-        if sys.getwindowsversion()[0] <= 5:
-            # For some reason, the value '1' dies from a 64bit process, but
-            # "works" (ie, gives the correct exception) from a 32bit process.
-            # just silently skip this value on Vista.
-            self.assertRaises(pywintypes.error, GetGlobalMemory, 1)
-
-    def test_custom_mem(self):
-        test_data = str2bytes("hello\x00\xff")
-        test_buffer = array.array("b", test_data)
-        cf = RegisterClipboardFormat(custom_format_name)
-        self.assertEqual(custom_format_name, GetClipboardFormatName(cf))
-        SetClipboardData(cf, test_buffer)
-        hglobal = GetClipboardDataHandle(cf)
-        data = GetGlobalMemory(hglobal)
-        self.assertEqual(data, test_data)
-
-
-if __name__ == "__main__":
-    unittest.main()
diff --git a/lib/win32/test/test_exceptions.py b/lib/win32/test/test_exceptions.py
deleted file mode 100644
index 33101107..00000000
--- a/lib/win32/test/test_exceptions.py
+++ /dev/null
@@ -1,223 +0,0 @@
-"""Test pywin32's error semantics"""
-import sys
-import unittest
-
-import pythoncom
-import pywintypes
-import win32api
-import win32file
-import winerror
-
-
-class TestBase(unittest.TestCase):
-    def _testExceptionIndex(self, exc, index, expected):
-        # check the exception itself can be indexed if not py3k
-        if sys.version_info < (3,):
-            self.assertEqual(exc[index], expected)
-        # and that exception.args can is the same.
-        self.assertEqual(exc.args[index], expected)
-
-
-class TestAPISimple(TestBase):
-    def _getInvalidHandleException(self):
-        try:
-            win32api.CloseHandle(1)
-        except win32api.error as exc:
-            return exc
-        self.fail("Didn't get invalid-handle exception.")
-
-    def testSimple(self):
-        self.assertRaises(pywintypes.error, win32api.CloseHandle, 1)
-
-    def testErrnoIndex(self):
-        exc = self._getInvalidHandleException()
-        self._testExceptionIndex(exc, 0, winerror.ERROR_INVALID_HANDLE)
-
-    def testFuncIndex(self):
-        exc = self._getInvalidHandleException()
-        self._testExceptionIndex(exc, 1, "CloseHandle")
-
-    def testMessageIndex(self):
-        exc = self._getInvalidHandleException()
-        expected = win32api.FormatMessage(winerror.ERROR_INVALID_HANDLE).rstrip()
-        self._testExceptionIndex(exc, 2, expected)
-
-    def testUnpack(self):
-        try:
-            win32api.CloseHandle(1)
-            self.fail("expected exception!")
-        except win32api.error as exc:
-            self.assertEqual(exc.winerror, winerror.ERROR_INVALID_HANDLE)
-            self.assertEqual(exc.funcname, "CloseHandle")
-            expected_msg = win32api.FormatMessage(
-                winerror.ERROR_INVALID_HANDLE
-            ).rstrip()
-            self.assertEqual(exc.strerror, expected_msg)
-
-    def testAsStr(self):
-        exc = self._getInvalidHandleException()
-        err_msg = win32api.FormatMessage(winerror.ERROR_INVALID_HANDLE).rstrip()
-        # early on the result actually *was* a tuple - it must always look like one
-        err_tuple = (winerror.ERROR_INVALID_HANDLE, "CloseHandle", err_msg)
-        self.assertEqual(str(exc), str(err_tuple))
-
-    def testAsTuple(self):
-        exc = self._getInvalidHandleException()
-        err_msg = win32api.FormatMessage(winerror.ERROR_INVALID_HANDLE).rstrip()
-        # early on the result actually *was* a tuple - it must be able to be one
-        err_tuple = (winerror.ERROR_INVALID_HANDLE, "CloseHandle", err_msg)
-        if sys.version_info < (3,):
-            self.assertEqual(tuple(exc), err_tuple)
-        else:
-            self.assertEqual(exc.args, err_tuple)
-
-    def testClassName(self):
-        exc = self._getInvalidHandleException()
-        # The error class has always been named 'error'.  That's not ideal :(
-        self.assertEqual(exc.__class__.__name__, "error")
-
-    def testIdentity(self):
-        exc = self._getInvalidHandleException()
-        self.assertTrue(exc.__class__ is pywintypes.error)
-
-    def testBaseClass(self):
-        self.assertEqual(pywintypes.error.__bases__, (Exception,))
-
-    def testAttributes(self):
-        exc = self._getInvalidHandleException()
-        err_msg = win32api.FormatMessage(winerror.ERROR_INVALID_HANDLE).rstrip()
-        self.assertEqual(exc.winerror, winerror.ERROR_INVALID_HANDLE)
-        self.assertEqual(exc.strerror, err_msg)
-        self.assertEqual(exc.funcname, "CloseHandle")
-
-    # some tests for 'insane' args.
-    def testStrangeArgsNone(self):
-        try:
-            raise pywintypes.error()
-            self.fail("Expected exception")
-        except pywintypes.error as exc:
-            self.assertEqual(exc.args, ())
-            self.assertEqual(exc.winerror, None)
-            self.assertEqual(exc.funcname, None)
-            self.assertEqual(exc.strerror, None)
-
-    def testStrangeArgsNotEnough(self):
-        try:
-            raise pywintypes.error("foo")
-            self.fail("Expected exception")
-        except pywintypes.error as exc:
-            assert exc.args[0] == "foo"
-            # 'winerror' always args[0]
-            self.assertEqual(exc.winerror, "foo")
-            self.assertEqual(exc.funcname, None)
-            self.assertEqual(exc.strerror, None)
-
-    def testStrangeArgsTooMany(self):
-        try:
-            raise pywintypes.error("foo", "bar", "you", "never", "kn", 0)
-            self.fail("Expected exception")
-        except pywintypes.error as exc:
-            self.assertEqual(exc.args[0], "foo")
-            self.assertEqual(exc.args[-1], 0)
-            self.assertEqual(exc.winerror, "foo")
-            self.assertEqual(exc.funcname, "bar")
-            self.assertEqual(exc.strerror, "you")
-
-
-class TestCOMSimple(TestBase):
-    def _getException(self):
-        try:
-            pythoncom.StgOpenStorage("foo", None, 0)
-        except pythoncom.com_error as exc:
-            return exc
-        self.fail("Didn't get storage exception.")
-
-    def testIs(self):
-        self.assertTrue(pythoncom.com_error is pywintypes.com_error)
-
-    def testSimple(self):
-        self.assertRaises(pythoncom.com_error, pythoncom.StgOpenStorage, "foo", None, 0)
-
-    def testErrnoIndex(self):
-        exc = self._getException()
-        self._testExceptionIndex(exc, 0, winerror.STG_E_INVALIDFLAG)
-
-    def testMessageIndex(self):
-        exc = self._getException()
-        expected = win32api.FormatMessage(winerror.STG_E_INVALIDFLAG).rstrip()
-        self._testExceptionIndex(exc, 1, expected)
-
-    def testAsStr(self):
-        exc = self._getException()
-        err_msg = win32api.FormatMessage(winerror.STG_E_INVALIDFLAG).rstrip()
-        # early on the result actually *was* a tuple - it must always look like one
-        err_tuple = (winerror.STG_E_INVALIDFLAG, err_msg, None, None)
-        self.assertEqual(str(exc), str(err_tuple))
-
-    def testAsTuple(self):
-        exc = self._getException()
-        err_msg = win32api.FormatMessage(winerror.STG_E_INVALIDFLAG).rstrip()
-        # early on the result actually *was* a tuple - it must be able to be one
-        err_tuple = (winerror.STG_E_INVALIDFLAG, err_msg, None, None)
-        if sys.version_info < (3,):
-            self.assertEqual(tuple(exc), err_tuple)
-        else:
-            self.assertEqual(exc.args, err_tuple)
-
-    def testClassName(self):
-        exc = self._getException()
-        self.assertEqual(exc.__class__.__name__, "com_error")
-
-    def testIdentity(self):
-        exc = self._getException()
-        self.assertTrue(exc.__class__ is pywintypes.com_error)
-
-    def testBaseClass(self):
-        exc = self._getException()
-        self.assertEqual(pywintypes.com_error.__bases__, (Exception,))
-
-    def testAttributes(self):
-        exc = self._getException()
-        err_msg = win32api.FormatMessage(winerror.STG_E_INVALIDFLAG).rstrip()
-        self.assertEqual(exc.hresult, winerror.STG_E_INVALIDFLAG)
-        self.assertEqual(exc.strerror, err_msg)
-        self.assertEqual(exc.argerror, None)
-        self.assertEqual(exc.excepinfo, None)
-
-    def testStrangeArgsNone(self):
-        try:
-            raise pywintypes.com_error()
-            self.fail("Expected exception")
-        except pywintypes.com_error as exc:
-            self.assertEqual(exc.args, ())
-            self.assertEqual(exc.hresult, None)
-            self.assertEqual(exc.strerror, None)
-            self.assertEqual(exc.argerror, None)
-            self.assertEqual(exc.excepinfo, None)
-
-    def testStrangeArgsNotEnough(self):
-        try:
-            raise pywintypes.com_error("foo")
-            self.fail("Expected exception")
-        except pywintypes.com_error as exc:
-            self.assertEqual(exc.args[0], "foo")
-            self.assertEqual(exc.hresult, "foo")
-            self.assertEqual(exc.strerror, None)
-            self.assertEqual(exc.excepinfo, None)
-            self.assertEqual(exc.argerror, None)
-
-    def testStrangeArgsTooMany(self):
-        try:
-            raise pywintypes.com_error("foo", "bar", "you", "never", "kn", 0)
-            self.fail("Expected exception")
-        except pywintypes.com_error as exc:
-            self.assertEqual(exc.args[0], "foo")
-            self.assertEqual(exc.args[-1], 0)
-            self.assertEqual(exc.hresult, "foo")
-            self.assertEqual(exc.strerror, "bar")
-            self.assertEqual(exc.excepinfo, "you")
-            self.assertEqual(exc.argerror, "never")
-
-
-if __name__ == "__main__":
-    unittest.main()
diff --git a/lib/win32/test/test_odbc.py b/lib/win32/test/test_odbc.py
deleted file mode 100644
index ef2b4516..00000000
--- a/lib/win32/test/test_odbc.py
+++ /dev/null
@@ -1,267 +0,0 @@
-# odbc test suite kindly contributed by Frank Millman.
-import os
-import sys
-import tempfile
-import unittest
-
-import odbc
-import pythoncom
-from pywin32_testutil import TestSkipped, str2bytes, str2memory
-from win32com.client import constants
-
-# We use the DAO ODBC driver
-from win32com.client.gencache import EnsureDispatch
-
-
-class TestStuff(unittest.TestCase):
-    def setUp(self):
-        self.tablename = "pywin32test_users"
-        self.db_filename = None
-        self.conn = self.cur = None
-        try:
-            # Test any database if a connection string is supplied...
-            conn_str = os.environ["TEST_ODBC_CONNECTION_STRING"]
-        except KeyError:
-            # Create a local MSAccess DB for testing.
-            self.db_filename = tempfile.NamedTemporaryFile().name + ".mdb"
-
-            # Create a brand-new database - what is the story with these?
-            for suffix in (".36", ".35", ".30"):
-                try:
-                    dbe = EnsureDispatch("DAO.DBEngine" + suffix)
-                    break
-                except pythoncom.com_error:
-                    pass
-            else:
-                raise TestSkipped("Can't find a DB engine")
-
-            workspace = dbe.Workspaces(0)
-
-            newdb = workspace.CreateDatabase(
-                self.db_filename, constants.dbLangGeneral, constants.dbEncrypt
-            )
-
-            newdb.Close()
-
-            conn_str = "Driver={Microsoft Access Driver (*.mdb)};dbq=%s;Uid=;Pwd=;" % (
-                self.db_filename,
-            )
-        ## print 'Connection string:', conn_str
-        self.conn = odbc.odbc(conn_str)
-        # And we expect a 'users' table for these tests.
-        self.cur = self.conn.cursor()
-        ## self.cur.setoutputsize(1000)
-        try:
-            self.cur.execute("""drop table %s""" % self.tablename)
-        except (odbc.error, odbc.progError):
-            pass
-
-        ## This needs to be adjusted for sql server syntax for unicode fields
-        ##  - memo -> TEXT
-        ##  - varchar -> nvarchar
-        self.assertEqual(
-            self.cur.execute(
-                """create table %s (
-                    userid varchar(25),
-                    username varchar(25),
-                    bitfield bit,
-                    intfield integer,
-                    floatfield float,
-                    datefield datetime,
-                    rawfield varbinary(100),
-                    longtextfield memo,
-                    longbinaryfield image
-            )"""
-                % self.tablename
-            ),
-            -1,
-        )
-
-    def tearDown(self):
-        if self.cur is not None:
-            try:
-                self.cur.execute("""drop table %s""" % self.tablename)
-            except (odbc.error, odbc.progError) as why:
-                print("Failed to delete test table %s" % self.tablename, why)
-
-            self.cur.close()
-            self.cur = None
-        if self.conn is not None:
-            self.conn.close()
-            self.conn = None
-        if self.db_filename is not None:
-            try:
-                os.unlink(self.db_filename)
-            except OSError:
-                pass
-
-    def test_insert_select(self, userid="Frank", username="Frank Millman"):
-        self.assertEqual(
-            self.cur.execute(
-                "insert into %s (userid, username) \
-            values (?,?)"
-                % self.tablename,
-                [userid, username],
-            ),
-            1,
-        )
-        self.assertEqual(
-            self.cur.execute(
-                "select * from %s \
-            where userid = ?"
-                % self.tablename,
-                [userid.lower()],
-            ),
-            0,
-        )
-        self.assertEqual(
-            self.cur.execute(
-                "select * from %s \
-            where username = ?"
-                % self.tablename,
-                [username.lower()],
-            ),
-            0,
-        )
-
-    def test_insert_select_unicode(self, userid="Frank", username="Frank Millman"):
-        self.assertEqual(
-            self.cur.execute(
-                "insert into %s (userid, username)\
-            values (?,?)"
-                % self.tablename,
-                [userid, username],
-            ),
-            1,
-        )
-        self.assertEqual(
-            self.cur.execute(
-                "select * from %s \
-            where userid = ?"
-                % self.tablename,
-                [userid.lower()],
-            ),
-            0,
-        )
-        self.assertEqual(
-            self.cur.execute(
-                "select * from %s \
-            where username = ?"
-                % self.tablename,
-                [username.lower()],
-            ),
-            0,
-        )
-
-    def test_insert_select_unicode_ext(self):
-        userid = "t-\xe0\xf2"
-        username = "test-\xe0\xf2 name"
-        self.test_insert_select_unicode(userid, username)
-
-    def _test_val(self, fieldName, value):
-        for x in range(100):
-            self.cur.execute("delete from %s where userid='Frank'" % self.tablename)
-            self.assertEqual(
-                self.cur.execute(
-                    "insert into %s (userid, %s) values (?,?)"
-                    % (self.tablename, fieldName),
-                    ["Frank", value],
-                ),
-                1,
-            )
-            self.cur.execute(
-                "select %s from %s where userid = ?" % (fieldName, self.tablename),
-                ["Frank"],
-            )
-            rows = self.cur.fetchmany()
-            self.assertEqual(1, len(rows))
-            row = rows[0]
-            self.assertEqual(row[0], value)
-
-    def testBit(self):
-        self._test_val("bitfield", 1)
-        self._test_val("bitfield", 0)
-
-    def testInt(self):
-        self._test_val("intfield", 1)
-        self._test_val("intfield", 0)
-        try:
-            big = sys.maxsize
-        except AttributeError:
-            big = sys.maxint
-        self._test_val("intfield", big)
-
-    def testFloat(self):
-        self._test_val("floatfield", 1.01)
-        self._test_val("floatfield", 0)
-
-    def testVarchar(
-        self,
-    ):
-        self._test_val("username", "foo")
-
-    def testLongVarchar(self):
-        """Test a long text field in excess of internal cursor data size (65536)"""
-        self._test_val("longtextfield", "abc" * 70000)
-
-    def testLongBinary(self):
-        """Test a long raw field in excess of internal cursor data size (65536)"""
-        self._test_val("longbinaryfield", str2memory("\0\1\2" * 70000))
-
-    def testRaw(self):
-        ## Test binary data
-        self._test_val("rawfield", str2memory("\1\2\3\4\0\5\6\7\8"))
-
-    def test_widechar(self):
-        """Test a unicode character that would be mangled if bound as plain character.
-        For example, previously the below was returned as ascii 'a'
-        """
-        self._test_val("username", "\u0101")
-
-    def testDates(self):
-        import datetime
-
-        for v in ((1900, 12, 25, 23, 39, 59),):
-            d = datetime.datetime(*v)
-            self._test_val("datefield", d)
-
-    def test_set_nonzero_length(self):
-        self.assertEqual(
-            self.cur.execute(
-                "insert into %s (userid,username) " "values (?,?)" % self.tablename,
-                ["Frank", "Frank Millman"],
-            ),
-            1,
-        )
-        self.assertEqual(
-            self.cur.execute("update %s set username = ?" % self.tablename, ["Frank"]),
-            1,
-        )
-        self.assertEqual(self.cur.execute("select * from %s" % self.tablename), 0)
-        self.assertEqual(len(self.cur.fetchone()[1]), 5)
-
-    def test_set_zero_length(self):
-        self.assertEqual(
-            self.cur.execute(
-                "insert into %s (userid,username) " "values (?,?)" % self.tablename,
-                [str2bytes("Frank"), ""],
-            ),
-            1,
-        )
-        self.assertEqual(self.cur.execute("select * from %s" % self.tablename), 0)
-        self.assertEqual(len(self.cur.fetchone()[1]), 0)
-
-    def test_set_zero_length_unicode(self):
-        self.assertEqual(
-            self.cur.execute(
-                "insert into %s (userid,username) " "values (?,?)" % self.tablename,
-                ["Frank", ""],
-            ),
-            1,
-        )
-        self.assertEqual(self.cur.execute("select * from %s" % self.tablename), 0)
-        self.assertEqual(len(self.cur.fetchone()[1]), 0)
-
-
-if __name__ == "__main__":
-    unittest.main()
diff --git a/lib/win32/test/test_pywintypes.py b/lib/win32/test/test_pywintypes.py
deleted file mode 100644
index bbd9d882..00000000
--- a/lib/win32/test/test_pywintypes.py
+++ /dev/null
@@ -1,116 +0,0 @@
-import datetime
-import operator
-import sys
-import time
-import unittest
-
-import pywintypes
-from pywin32_testutil import ob2memory, str2bytes
-
-
-class TestCase(unittest.TestCase):
-    def testPyTimeFormat(self):
-        struct_current = time.localtime()
-        pytime_current = pywintypes.Time(struct_current)
-        # try and test all the standard parts of the format
-        # Note we used to include '%Z' testing, but that was pretty useless as
-        # it always returned the local timezone.
-        format_strings = "%a %A %b %B %c %d %H %I %j %m %M %p %S %U %w %W %x %X %y %Y"
-        for fmt in format_strings.split():
-            v1 = pytime_current.Format(fmt)
-            v2 = time.strftime(fmt, struct_current)
-            self.assertEqual(v1, v2, "format %s failed - %r != %r" % (fmt, v1, v2))
-
-    def testPyTimePrint(self):
-        # This used to crash with an invalid, or too early time.
-        # We don't really want to check that it does cause a ValueError
-        # (as hopefully this wont be true forever).  So either working, or
-        # ValueError is OK.
-        try:
-            t = pywintypes.Time(-2)
-            t.Format()
-        except ValueError:
-            return
-
-    def testTimeInDict(self):
-        d = {}
-        d["t1"] = pywintypes.Time(1)
-        self.assertEqual(d["t1"], pywintypes.Time(1))
-
-    def testPyTimeCompare(self):
-        t1 = pywintypes.Time(100)
-        t1_2 = pywintypes.Time(100)
-        t2 = pywintypes.Time(101)
-
-        self.assertEqual(t1, t1_2)
-        self.assertTrue(t1 <= t1_2)
-        self.assertTrue(t1_2 >= t1)
-
-        self.assertNotEqual(t1, t2)
-        self.assertTrue(t1 < t2)
-        self.assertTrue(t2 > t1)
-
-    def testPyTimeCompareOther(self):
-        t1 = pywintypes.Time(100)
-        t2 = None
-        self.assertNotEqual(t1, t2)
-
-    def testTimeTuple(self):
-        now = datetime.datetime.now()  # has usec...
-        # timetuple() lost usec - pt must be <=...
-        pt = pywintypes.Time(now.timetuple())
-        # *sob* - only if we have a datetime object can we compare like this.
-        if isinstance(pt, datetime.datetime):
-            self.assertTrue(pt <= now)
-
-    def testTimeTuplems(self):
-        now = datetime.datetime.now()  # has usec...
-        tt = now.timetuple() + (now.microsecond // 1000,)
-        pt = pywintypes.Time(tt)
-        # we can't compare if using the old type, as it loses all sub-second res.
-        if isinstance(pt, datetime.datetime):
-            # but even with datetime, we lose sub-millisecond.
-            expectedDelta = datetime.timedelta(milliseconds=1)
-            self.assertTrue(-expectedDelta < (now - pt) < expectedDelta)
-
-    def testPyTimeFromTime(self):
-        t1 = pywintypes.Time(time.time())
-        self.assertTrue(pywintypes.Time(t1) is t1)
-
-    def testPyTimeTooLarge(self):
-        MAX_TIMESTAMP = 0x7FFFFFFFFFFFFFFF  # used by some API function to mean "never"
-        ts = pywintypes.TimeStamp(MAX_TIMESTAMP)
-        self.assertEqual(ts, datetime.datetime.max)
-
-    def testGUID(self):
-        s = "{00020400-0000-0000-C000-000000000046}"
-        iid = pywintypes.IID(s)
-        iid2 = pywintypes.IID(ob2memory(iid), True)
-        self.assertEqual(iid, iid2)
-        self.assertRaises(
-            ValueError, pywintypes.IID, str2bytes("00"), True
-        )  # too short
-        self.assertRaises(TypeError, pywintypes.IID, 0, True)  # no buffer
-
-    def testGUIDRichCmp(self):
-        s = "{00020400-0000-0000-C000-000000000046}"
-        iid = pywintypes.IID(s)
-        self.assertFalse(s == None)
-        self.assertFalse(None == s)
-        self.assertTrue(s != None)
-        self.assertTrue(None != s)
-        if sys.version_info > (3, 0):
-            self.assertRaises(TypeError, operator.gt, None, s)
-            self.assertRaises(TypeError, operator.gt, s, None)
-            self.assertRaises(TypeError, operator.lt, None, s)
-            self.assertRaises(TypeError, operator.lt, s, None)
-
-    def testGUIDInDict(self):
-        s = "{00020400-0000-0000-C000-000000000046}"
-        iid = pywintypes.IID(s)
-        d = dict(item=iid)
-        self.assertEqual(d["item"], iid)
-
-
-if __name__ == "__main__":
-    unittest.main()
diff --git a/lib/win32/test/test_security.py b/lib/win32/test/test_security.py
deleted file mode 100644
index 42a82a13..00000000
--- a/lib/win32/test/test_security.py
+++ /dev/null
@@ -1,166 +0,0 @@
-# Tests for the win32security module.
-import unittest
-
-import ntsecuritycon
-import pywintypes
-import win32api
-import win32con
-import win32security
-import winerror
-from pywin32_testutil import TestSkipped, ob2memory, testmain
-
-
-class SecurityTests(unittest.TestCase):
-    def setUp(self):
-        self.pwr_sid = win32security.LookupAccountName("", "Power Users")[0]
-        try:
-            self.admin_sid = win32security.LookupAccountName("", "Administrator")[0]
-        except pywintypes.error as exc:
-            # in automation we see:
-            # pywintypes.error: (1332, 'LookupAccountName', 'No mapping between account names and security IDs was done.')
-            if exc.winerror != winerror.ERROR_NONE_MAPPED:
-                raise
-            self.admin_sid = None
-
-    def tearDown(self):
-        pass
-
-    def testEqual(self):
-        if self.admin_sid is None:
-            raise TestSkipped("No 'Administrator' account is available")
-        self.assertEqual(
-            win32security.LookupAccountName("", "Administrator")[0],
-            win32security.LookupAccountName("", "Administrator")[0],
-        )
-
-    def testNESID(self):
-        self.assertTrue(self.pwr_sid == self.pwr_sid)
-        if self.admin_sid:
-            self.assertTrue(self.pwr_sid != self.admin_sid)
-
-    def testNEOther(self):
-        self.assertTrue(self.pwr_sid != None)
-        self.assertTrue(None != self.pwr_sid)
-        self.assertFalse(self.pwr_sid == None)
-        self.assertFalse(None == self.pwr_sid)
-        self.assertNotEqual(None, self.pwr_sid)
-
-    def testSIDInDict(self):
-        d = dict(foo=self.pwr_sid)
-        self.assertEqual(d["foo"], self.pwr_sid)
-
-    def testBuffer(self):
-        if self.admin_sid is None:
-            raise TestSkipped("No 'Administrator' account is available")
-        self.assertEqual(
-            ob2memory(win32security.LookupAccountName("", "Administrator")[0]),
-            ob2memory(win32security.LookupAccountName("", "Administrator")[0]),
-        )
-
-    def testMemory(self):
-        pwr_sid = self.pwr_sid
-        admin_sid = self.admin_sid
-        sd1 = win32security.SECURITY_DESCRIPTOR()
-        sd2 = win32security.SECURITY_DESCRIPTOR()
-        sd3 = win32security.SECURITY_DESCRIPTOR()
-        dacl = win32security.ACL()
-        dacl.AddAccessAllowedAce(
-            win32security.ACL_REVISION, win32con.GENERIC_READ, pwr_sid
-        )
-        if admin_sid is not None:
-            dacl.AddAccessAllowedAce(
-                win32security.ACL_REVISION, win32con.GENERIC_ALL, admin_sid
-            )
-        sd4 = win32security.SECURITY_DESCRIPTOR()
-        sacl = win32security.ACL()
-        if admin_sid is not None:
-            sacl.AddAuditAccessAce(
-                win32security.ACL_REVISION, win32con.DELETE, admin_sid, 1, 1
-            )
-        sacl.AddAuditAccessAce(
-            win32security.ACL_REVISION, win32con.GENERIC_ALL, pwr_sid, 1, 1
-        )
-        for x in range(0, 200000):
-            if admin_sid is not None:
-                sd1.SetSecurityDescriptorOwner(admin_sid, 0)
-            sd2.SetSecurityDescriptorGroup(pwr_sid, 0)
-            sd3.SetSecurityDescriptorDacl(1, dacl, 0)
-            sd4.SetSecurityDescriptorSacl(1, sacl, 0)
-
-
-class DomainTests(unittest.TestCase):
-    def setUp(self):
-        self.ds_handle = None
-        try:
-            # saving the handle means the other test itself should bind faster.
-            self.ds_handle = win32security.DsBind()
-        except win32security.error as exc:
-            if exc.winerror != winerror.ERROR_NO_SUCH_DOMAIN:
-                raise
-            raise TestSkipped(exc)
-
-    def tearDown(self):
-        if self.ds_handle is not None:
-            self.ds_handle.close()
-
-
-class TestDS(DomainTests):
-    def testDsGetDcName(self):
-        # Not sure what we can actually test here!  At least calling it
-        # does something :)
-        win32security.DsGetDcName()
-
-    def testDsListServerInfo(self):
-        # again, not checking much, just exercising the code.
-        h = win32security.DsBind()
-        for status, ignore, site in win32security.DsListSites(h):
-            for status, ignore, server in win32security.DsListServersInSite(h, site):
-                info = win32security.DsListInfoForServer(h, server)
-            for status, ignore, domain in win32security.DsListDomainsInSite(h, site):
-                pass
-
-    def testDsCrackNames(self):
-        h = win32security.DsBind()
-        fmt_offered = ntsecuritycon.DS_FQDN_1779_NAME
-        name = win32api.GetUserNameEx(fmt_offered)
-        result = win32security.DsCrackNames(h, 0, fmt_offered, fmt_offered, (name,))
-        self.assertEqual(name, result[0][2])
-
-    def testDsCrackNamesSyntax(self):
-        # Do a syntax check only - that allows us to avoid binding.
-        # But must use DS_CANONICAL_NAME (or _EX)
-        expected = win32api.GetUserNameEx(win32api.NameCanonical)
-        fmt_offered = ntsecuritycon.DS_FQDN_1779_NAME
-        name = win32api.GetUserNameEx(fmt_offered)
-        result = win32security.DsCrackNames(
-            None,
-            ntsecuritycon.DS_NAME_FLAG_SYNTACTICAL_ONLY,
-            fmt_offered,
-            ntsecuritycon.DS_CANONICAL_NAME,
-            (name,),
-        )
-        self.assertEqual(expected, result[0][2])
-
-
-class TestTranslate(DomainTests):
-    def _testTranslate(self, fmt_from, fmt_to):
-        name = win32api.GetUserNameEx(fmt_from)
-        expected = win32api.GetUserNameEx(fmt_to)
-        got = win32security.TranslateName(name, fmt_from, fmt_to)
-        self.assertEqual(got, expected)
-
-    def testTranslate1(self):
-        self._testTranslate(win32api.NameFullyQualifiedDN, win32api.NameSamCompatible)
-
-    def testTranslate2(self):
-        self._testTranslate(win32api.NameSamCompatible, win32api.NameFullyQualifiedDN)
-
-    def testTranslate3(self):
-        self._testTranslate(win32api.NameFullyQualifiedDN, win32api.NameUniqueId)
-
-    def testTranslate4(self):
-        self._testTranslate(win32api.NameUniqueId, win32api.NameFullyQualifiedDN)
-
-
-if __name__ == "__main__":
-    testmain()
diff --git a/lib/win32/test/test_sspi.py b/lib/win32/test/test_sspi.py
deleted file mode 100644
index 5d349d4d..00000000
--- a/lib/win32/test/test_sspi.py
+++ /dev/null
@@ -1,231 +0,0 @@
-# Some tests of the win32security sspi functions.
-# Stolen from Roger's original test_sspi.c, a version of which is in "Demos"
-# See also the other SSPI demos.
-import re
-import unittest
-
-import sspi
-import sspicon
-import win32api
-import win32security
-from pywin32_testutil import TestSkipped, str2bytes, testmain
-
-
-# It is quite likely that the Kerberos tests will fail due to not being
-# installed.  The NTLM tests do *not* get the same behaviour as they should
-# always be there.
-def applyHandlingSkips(func, *args):
-    try:
-        return func(*args)
-    except win32api.error as exc:
-        if exc.winerror in [
-            sspicon.SEC_E_NO_CREDENTIALS,
-            sspicon.SEC_E_NO_AUTHENTICATING_AUTHORITY,
-        ]:
-            raise TestSkipped(exc)
-        raise
-
-
-class TestSSPI(unittest.TestCase):
-    def assertRaisesHRESULT(self, hr, func, *args):
-        try:
-            return func(*args)
-            raise RuntimeError("expecting %s failure" % (hr,))
-        except win32security.error as exc:
-            self.assertEqual(exc.winerror, hr)
-
-    def _doAuth(self, pkg_name):
-        sspiclient = sspi.ClientAuth(pkg_name, targetspn=win32api.GetUserName())
-        sspiserver = sspi.ServerAuth(pkg_name)
-
-        sec_buffer = None
-        err = 1
-        while err != 0:
-            err, sec_buffer = sspiclient.authorize(sec_buffer)
-            err, sec_buffer = sspiserver.authorize(sec_buffer)
-        return sspiclient, sspiserver
-
-    def _doTestImpersonate(self, pkg_name):
-        # Just for the sake of code exercising!
-        sspiclient, sspiserver = self._doAuth(pkg_name)
-        sspiserver.ctxt.ImpersonateSecurityContext()
-        sspiserver.ctxt.RevertSecurityContext()
-
-    def testImpersonateKerberos(self):
-        applyHandlingSkips(self._doTestImpersonate, "Kerberos")
-
-    def testImpersonateNTLM(self):
-        self._doTestImpersonate("NTLM")
-
-    def _doTestEncrypt(self, pkg_name):
-        sspiclient, sspiserver = self._doAuth(pkg_name)
-
-        pkg_size_info = sspiclient.ctxt.QueryContextAttributes(
-            sspicon.SECPKG_ATTR_SIZES
-        )
-        msg = str2bytes("some data to be encrypted ......")
-
-        trailersize = pkg_size_info["SecurityTrailer"]
-        encbuf = win32security.PySecBufferDescType()
-        encbuf.append(win32security.PySecBufferType(len(msg), sspicon.SECBUFFER_DATA))
-        encbuf.append(
-            win32security.PySecBufferType(trailersize, sspicon.SECBUFFER_TOKEN)
-        )
-        encbuf[0].Buffer = msg
-        sspiclient.ctxt.EncryptMessage(0, encbuf, 1)
-        sspiserver.ctxt.DecryptMessage(encbuf, 1)
-        self.assertEqual(msg, encbuf[0].Buffer)
-        # and test the higher-level functions
-        data_in = str2bytes("hello")
-        data, sig = sspiclient.encrypt(data_in)
-        self.assertEqual(sspiserver.decrypt(data, sig), data_in)
-
-        data, sig = sspiserver.encrypt(data_in)
-        self.assertEqual(sspiclient.decrypt(data, sig), data_in)
-
-    def _doTestEncryptStream(self, pkg_name):
-        # Test out the SSPI/GSSAPI interop wrapping examples at
-        # https://docs.microsoft.com/en-us/windows/win32/secauthn/sspi-kerberos-interoperability-with-gssapi
-
-        sspiclient, sspiserver = self._doAuth(pkg_name)
-
-        pkg_size_info = sspiclient.ctxt.QueryContextAttributes(
-            sspicon.SECPKG_ATTR_SIZES
-        )
-        msg = str2bytes("some data to be encrypted ......")
-
-        trailersize = pkg_size_info["SecurityTrailer"]
-        blocksize = pkg_size_info["BlockSize"]
-        encbuf = win32security.PySecBufferDescType()
-        encbuf.append(
-            win32security.PySecBufferType(trailersize, sspicon.SECBUFFER_TOKEN)
-        )
-        encbuf.append(win32security.PySecBufferType(len(msg), sspicon.SECBUFFER_DATA))
-        encbuf.append(
-            win32security.PySecBufferType(blocksize, sspicon.SECBUFFER_PADDING)
-        )
-        encbuf[1].Buffer = msg
-        sspiclient.ctxt.EncryptMessage(0, encbuf, 1)
-
-        encmsg = encbuf[0].Buffer + encbuf[1].Buffer + encbuf[2].Buffer
-        decbuf = win32security.PySecBufferDescType()
-        decbuf.append(
-            win32security.PySecBufferType(len(encmsg), sspicon.SECBUFFER_STREAM)
-        )
-        decbuf.append(win32security.PySecBufferType(0, sspicon.SECBUFFER_DATA))
-        decbuf[0].Buffer = encmsg
-
-        sspiserver.ctxt.DecryptMessage(decbuf, 1)
-        self.assertEqual(msg, decbuf[1].Buffer)
-
-    def testEncryptNTLM(self):
-        self._doTestEncrypt("NTLM")
-
-    def testEncryptStreamNTLM(self):
-        self._doTestEncryptStream("NTLM")
-
-    def testEncryptKerberos(self):
-        applyHandlingSkips(self._doTestEncrypt, "Kerberos")
-
-    def testEncryptStreamKerberos(self):
-        applyHandlingSkips(self._doTestEncryptStream, "Kerberos")
-
-    def _doTestSign(self, pkg_name):
-        sspiclient, sspiserver = self._doAuth(pkg_name)
-
-        pkg_size_info = sspiclient.ctxt.QueryContextAttributes(
-            sspicon.SECPKG_ATTR_SIZES
-        )
-        msg = str2bytes("some data to be encrypted ......")
-
-        sigsize = pkg_size_info["MaxSignature"]
-        sigbuf = win32security.PySecBufferDescType()
-        sigbuf.append(win32security.PySecBufferType(len(msg), sspicon.SECBUFFER_DATA))
-        sigbuf.append(win32security.PySecBufferType(sigsize, sspicon.SECBUFFER_TOKEN))
-        sigbuf[0].Buffer = msg
-        sspiclient.ctxt.MakeSignature(0, sigbuf, 0)
-        sspiserver.ctxt.VerifySignature(sigbuf, 0)
-        # and test the higher-level functions
-        sspiclient.next_seq_num = 1
-        sspiserver.next_seq_num = 1
-        data = str2bytes("hello")
-        key = sspiclient.sign(data)
-        sspiserver.verify(data, key)
-        key = sspiclient.sign(data)
-        self.assertRaisesHRESULT(
-            sspicon.SEC_E_MESSAGE_ALTERED, sspiserver.verify, data + data, key
-        )
-
-        # and the other way
-        key = sspiserver.sign(data)
-        sspiclient.verify(data, key)
-        key = sspiserver.sign(data)
-        self.assertRaisesHRESULT(
-            sspicon.SEC_E_MESSAGE_ALTERED, sspiclient.verify, data + data, key
-        )
-
-    def testSignNTLM(self):
-        self._doTestSign("NTLM")
-
-    def testSignKerberos(self):
-        applyHandlingSkips(self._doTestSign, "Kerberos")
-
-    def _testSequenceSign(self):
-        # Only Kerberos supports sequence detection.
-        sspiclient, sspiserver = self._doAuth("Kerberos")
-        key = sspiclient.sign(b"hello")
-        sspiclient.sign(b"hello")
-        self.assertRaisesHRESULT(
-            sspicon.SEC_E_OUT_OF_SEQUENCE, sspiserver.verify, b"hello", key
-        )
-
-    def testSequenceSign(self):
-        applyHandlingSkips(self._testSequenceSign)
-
-    def _testSequenceEncrypt(self):
-        # Only Kerberos supports sequence detection.
-        sspiclient, sspiserver = self._doAuth("Kerberos")
-        blob, key = sspiclient.encrypt(b"hello")
-        blob, key = sspiclient.encrypt(b"hello")
-        self.assertRaisesHRESULT(
-            sspicon.SEC_E_OUT_OF_SEQUENCE, sspiserver.decrypt, blob, key
-        )
-
-    def testSequenceEncrypt(self):
-        applyHandlingSkips(self._testSequenceEncrypt)
-
-    def testSecBufferRepr(self):
-        desc = win32security.PySecBufferDescType()
-        assert re.match(
-            "PySecBufferDesc\(ulVersion: 0 \| cBuffers: 0 \| pBuffers: 0x[\da-fA-F]{8,16}\)",
-            repr(desc),
-        )
-
-        buffer1 = win32security.PySecBufferType(0, sspicon.SECBUFFER_TOKEN)
-        assert re.match(
-            "PySecBuffer\(cbBuffer: 0 \| BufferType: 2 \| pvBuffer: 0x[\da-fA-F]{8,16}\)",
-            repr(buffer1),
-        )
-        "PySecBuffer(cbBuffer: 0 | BufferType: 2 | pvBuffer: 0x000001B8CC6D8020)"
-        desc.append(buffer1)
-
-        assert re.match(
-            "PySecBufferDesc\(ulVersion: 0 \| cBuffers: 1 \| pBuffers: 0x[\da-fA-F]{8,16}\)",
-            repr(desc),
-        )
-
-        buffer2 = win32security.PySecBufferType(4, sspicon.SECBUFFER_DATA)
-        assert re.match(
-            "PySecBuffer\(cbBuffer: 4 \| BufferType: 1 \| pvBuffer: 0x[\da-fA-F]{8,16}\)",
-            repr(buffer2),
-        )
-        desc.append(buffer2)
-
-        assert re.match(
-            "PySecBufferDesc\(ulVersion: 0 \| cBuffers: 2 \| pBuffers: 0x[\da-fA-F]{8,16}\)",
-            repr(desc),
-        )
-
-
-if __name__ == "__main__":
-    testmain()
diff --git a/lib/win32/test/test_win32api.py b/lib/win32/test/test_win32api.py
deleted file mode 100644
index 58ac1597..00000000
--- a/lib/win32/test/test_win32api.py
+++ /dev/null
@@ -1,268 +0,0 @@
-# General test module for win32api - please add some :)
-
-import datetime
-import os
-import sys
-import tempfile
-import unittest
-
-import win32api
-import win32con
-import win32event
-import winerror
-from pywin32_testutil import TestSkipped, str2bytes
-
-
-class CurrentUserTestCase(unittest.TestCase):
-    def testGetCurrentUser(self):
-        domain = win32api.GetDomainName()
-        if domain == "NT AUTHORITY":
-            # Running as a service account, so the comparison will fail
-            raise TestSkipped("running as service account")
-        name = "%s\\%s" % (domain, win32api.GetUserName())
-        self.assertEqual(name, win32api.GetUserNameEx(win32api.NameSamCompatible))
-
-
-class TestTime(unittest.TestCase):
-    def testTimezone(self):
-        # GetTimeZoneInformation
-        rc, tzinfo = win32api.GetTimeZoneInformation()
-        if rc == win32con.TIME_ZONE_ID_DAYLIGHT:
-            tz_str = tzinfo[4]
-            tz_time = tzinfo[5]
-        else:
-            tz_str = tzinfo[1]
-            tz_time = tzinfo[2]
-        # for the sake of code exercise but don't output
-        tz_str.encode()
-        if not isinstance(tz_time, datetime.datetime) and not isinstance(
-            tz_time, tuple
-        ):
-            tz_time.Format()
-
-    def TestDateFormat(self):
-        DATE_LONGDATE = 2
-        date_flags = DATE_LONGDATE
-        win32api.GetDateFormat(0, date_flags, None)
-        win32api.GetDateFormat(0, date_flags, 0)
-        win32api.GetDateFormat(0, date_flags, datetime.datetime.now())
-        win32api.GetDateFormat(0, date_flags, time.time())
-
-    def TestTimeFormat(self):
-        win32api.GetTimeFormat(0, 0, None)
-        win32api.GetTimeFormat(0, 0, 0)
-        win32api.GetTimeFormat(0, 0, datetime.datetime.now())
-        win32api.GetTimeFormat(0, 0, time.time())
-
-
-class Registry(unittest.TestCase):
-    key_name = r"PythonTestHarness\Whatever"
-
-    def test1(self):
-        # This used to leave a stale exception behind.
-        def reg_operation():
-            hkey = win32api.RegCreateKey(win32con.HKEY_CURRENT_USER, self.key_name)
-            x = 3 / 0  # or a statement like: raise 'error'
-
-        # do the test
-        try:
-            try:
-                try:
-                    reg_operation()
-                except:
-                    1 / 0  # Force exception
-            finally:
-                win32api.RegDeleteKey(win32con.HKEY_CURRENT_USER, self.key_name)
-        except ZeroDivisionError:
-            pass
-
-    def testValues(self):
-        key_name = r"PythonTestHarness\win32api"
-        ## tuples containing value name, value type, data
-        values = (
-            (None, win32con.REG_SZ, "This is default unnamed value"),
-            ("REG_SZ", win32con.REG_SZ, "REG_SZ text data"),
-            ("REG_EXPAND_SZ", win32con.REG_EXPAND_SZ, "%systemdir%"),
-            ## REG_MULTI_SZ value needs to be a list since strings are returned as a list
-            (
-                "REG_MULTI_SZ",
-                win32con.REG_MULTI_SZ,
-                ["string 1", "string 2", "string 3", "string 4"],
-            ),
-            ("REG_MULTI_SZ_empty", win32con.REG_MULTI_SZ, []),
-            ("REG_DWORD", win32con.REG_DWORD, 666),
-            ("REG_QWORD_INT", win32con.REG_QWORD, 99),
-            ("REG_QWORD", win32con.REG_QWORD, 2**33),
-            (
-                "REG_BINARY",
-                win32con.REG_BINARY,
-                str2bytes("\x00\x01\x02\x03\x04\x05\x06\x07\x08\x01\x00"),
-            ),
-        )
-
-        hkey = win32api.RegCreateKey(win32con.HKEY_CURRENT_USER, key_name)
-        for value_name, reg_type, data in values:
-            win32api.RegSetValueEx(hkey, value_name, None, reg_type, data)
-
-        for value_name, orig_type, orig_data in values:
-            data, typ = win32api.RegQueryValueEx(hkey, value_name)
-            self.assertEqual(typ, orig_type)
-            self.assertEqual(data, orig_data)
-
-    def testNotifyChange(self):
-        def change():
-            hkey = win32api.RegCreateKey(win32con.HKEY_CURRENT_USER, self.key_name)
-            try:
-                win32api.RegSetValue(hkey, None, win32con.REG_SZ, "foo")
-            finally:
-                win32api.RegDeleteKey(win32con.HKEY_CURRENT_USER, self.key_name)
-
-        evt = win32event.CreateEvent(None, 0, 0, None)
-        ## REG_NOTIFY_CHANGE_LAST_SET - values
-        ## REG_CHANGE_NOTIFY_NAME - keys
-        ## REG_NOTIFY_CHANGE_SECURITY - security descriptor
-        ## REG_NOTIFY_CHANGE_ATTRIBUTES
-        win32api.RegNotifyChangeKeyValue(
-            win32con.HKEY_CURRENT_USER,
-            1,
-            win32api.REG_NOTIFY_CHANGE_LAST_SET,
-            evt,
-            True,
-        )
-        ret_code = win32event.WaitForSingleObject(evt, 0)
-        # Should be no change.
-        self.assertTrue(ret_code == win32con.WAIT_TIMEOUT)
-        change()
-        # Our event should now be in a signalled state.
-        ret_code = win32event.WaitForSingleObject(evt, 0)
-        self.assertTrue(ret_code == win32con.WAIT_OBJECT_0)
-
-
-class FileNames(unittest.TestCase):
-    def testShortLongPathNames(self):
-        try:
-            me = __file__
-        except NameError:
-            me = sys.argv[0]
-        fname = os.path.abspath(me).lower()
-        short_name = win32api.GetShortPathName(fname).lower()
-        long_name = win32api.GetLongPathName(short_name).lower()
-        self.assertTrue(
-            long_name == fname,
-            "Expected long name ('%s') to be original name ('%s')" % (long_name, fname),
-        )
-        self.assertEqual(long_name, win32api.GetLongPathNameW(short_name).lower())
-        long_name = win32api.GetLongPathNameW(short_name).lower()
-        self.assertTrue(
-            type(long_name) == str,
-            "GetLongPathNameW returned type '%s'" % (type(long_name),),
-        )
-        self.assertTrue(
-            long_name == fname,
-            "Expected long name ('%s') to be original name ('%s')" % (long_name, fname),
-        )
-
-    def testShortUnicodeNames(self):
-        try:
-            me = __file__
-        except NameError:
-            me = sys.argv[0]
-        fname = os.path.abspath(me).lower()
-        # passing unicode should cause GetShortPathNameW to be called.
-        short_name = win32api.GetShortPathName(str(fname)).lower()
-        self.assertTrue(isinstance(short_name, str))
-        long_name = win32api.GetLongPathName(short_name).lower()
-        self.assertTrue(
-            long_name == fname,
-            "Expected long name ('%s') to be original name ('%s')" % (long_name, fname),
-        )
-        self.assertEqual(long_name, win32api.GetLongPathNameW(short_name).lower())
-        long_name = win32api.GetLongPathNameW(short_name).lower()
-        self.assertTrue(
-            type(long_name) == str,
-            "GetLongPathNameW returned type '%s'" % (type(long_name),),
-        )
-        self.assertTrue(
-            long_name == fname,
-            "Expected long name ('%s') to be original name ('%s')" % (long_name, fname),
-        )
-
-    def testLongLongPathNames(self):
-        # We need filename where the FQN is > 256 - simplest way is to create a
-        # 250 character directory in the cwd (except - cwd may be on a drive
-        # not supporting \\\\?\\ (eg, network share) - so use temp.
-        import win32file
-
-        basename = "a" * 250
-        # but we need to ensure we use the 'long' version of the
-        # temp dir for later comparison.
-        long_temp_dir = win32api.GetLongPathNameW(tempfile.gettempdir())
-        fname = "\\\\?\\" + os.path.join(long_temp_dir, basename)
-        try:
-            win32file.CreateDirectoryW(fname, None)
-        except win32api.error as details:
-            if details.winerror != winerror.ERROR_ALREADY_EXISTS:
-                raise
-        try:
-            # GetFileAttributes automatically calls GetFileAttributesW when
-            # passed unicode
-            try:
-                attr = win32api.GetFileAttributes(fname)
-            except win32api.error as details:
-                if details.winerror != winerror.ERROR_FILENAME_EXCED_RANGE:
-                    raise
-
-            attr = win32api.GetFileAttributes(str(fname))
-            self.assertTrue(attr & win32con.FILE_ATTRIBUTE_DIRECTORY, attr)
-
-            long_name = win32api.GetLongPathNameW(fname)
-            self.assertEqual(long_name.lower(), fname.lower())
-        finally:
-            win32file.RemoveDirectory(fname)
-
-
-class FormatMessage(unittest.TestCase):
-    def test_FromString(self):
-        msg = "Hello %1, how are you %2?"
-        inserts = ["Mark", "today"]
-        result = win32api.FormatMessage(
-            win32con.FORMAT_MESSAGE_FROM_STRING,
-            msg,  # source
-            0,  # ID
-            0,  # LangID
-            inserts,
-        )
-        self.assertEqual(result, "Hello Mark, how are you today?")
-
-
-class Misc(unittest.TestCase):
-    def test_last_error(self):
-        for x in (0, 1, -1, winerror.TRUST_E_PROVIDER_UNKNOWN):
-            win32api.SetLastError(x)
-            self.assertEqual(x, win32api.GetLastError())
-
-    def testVkKeyScan(self):
-        # hopefully ' ' doesn't depend on the locale!
-        self.assertEqual(win32api.VkKeyScan(" "), 32)
-
-    def testVkKeyScanEx(self):
-        # hopefully ' ' doesn't depend on the locale!
-        self.assertEqual(win32api.VkKeyScanEx(" ", 0), 32)
-
-    def testGetSystemPowerStatus(self):
-        # Dummy
-        sps = win32api.GetSystemPowerStatus()
-        self.assertIsInstance(sps, dict)
-        test_keys = (
-            "ACLineStatus",
-            "BatteryFlag",
-            "BatteryLifePercent",
-            "SystemStatusFlag",
-            "BatteryLifeTime",
-            "BatteryFullLifeTime",
-        )
-        self.assertEqual(set(test_keys), set(sps.keys()))
-
-
-if __name__ == "__main__":
-    unittest.main()
diff --git a/lib/win32/test/test_win32crypt.py b/lib/win32/test/test_win32crypt.py
deleted file mode 100644
index 4d1fa712..00000000
--- a/lib/win32/test/test_win32crypt.py
+++ /dev/null
@@ -1,129 +0,0 @@
-# Test module for win32crypt
-
-import contextlib
-import unittest
-from typing import Any, Iterator
-
-import win32crypt
-from pywin32_testutil import TestSkipped, find_test_fixture, testmain
-from win32cryptcon import *
-
-
-class Crypt(unittest.TestCase):
-    def testSimple(self):
-        data = b"My test data"
-        entropy = None
-        desc = "My description"
-        flags = 0
-        ps = None
-        blob = win32crypt.CryptProtectData(data, desc, entropy, None, ps, flags)
-        got_desc, got_data = win32crypt.CryptUnprotectData(
-            blob, entropy, None, ps, flags
-        )
-        self.assertEqual(data, got_data)
-        self.assertEqual(desc, got_desc)
-
-    def testEntropy(self):
-        data = b"My test data"
-        entropy = b"My test entropy"
-        desc = "My description"
-        flags = 0
-        ps = None
-        blob = win32crypt.CryptProtectData(data, desc, entropy, None, ps, flags)
-        got_desc, got_data = win32crypt.CryptUnprotectData(
-            blob, entropy, None, ps, flags
-        )
-        self.assertEqual(data, got_data)
-        self.assertEqual(desc, got_desc)
-
-
-# via https://github.com/mhammond/pywin32/issues/1859
-_LOCAL_MACHINE = "LocalMachine"
-_CURRENT_USER = "CurrentUser"
-
-
-@contextlib.contextmanager
-def open_windows_certstore(store_name: str, store_location: str) -> Iterator[Any]:
-    """Open a windows certificate store
-
-    :param store_name: store name
-    :param store_location: store location
-    :return: handle to cert store
-    """
-    handle = None
-    try:
-        handle = win32crypt.CertOpenStore(
-            CERT_STORE_PROV_SYSTEM,
-            0,
-            None,
-            CERT_SYSTEM_STORE_LOCAL_MACHINE
-            if store_location == _LOCAL_MACHINE
-            else CERT_SYSTEM_STORE_CURRENT_USER,
-            store_name,
-        )
-        yield handle
-    finally:
-        if handle is not None:
-            handle.CertCloseStore()
-
-
-class TestCerts(unittest.TestCase):
-    def readCertFile(self, file_name):
-        with open(find_test_fixture(file_name), "rb") as f:
-            buf = bytearray(f.read())
-            return win32crypt.CryptQueryObject(
-                CERT_QUERY_OBJECT_BLOB,
-                buf,
-                CERT_QUERY_CONTENT_FLAG_CERT,
-                CERT_QUERY_FORMAT_FLAG_ALL,
-                0,
-            )
-
-    def testReadCertFiles(self):
-        # readCertFile has Python read the file and load it as a blob.
-        # win32crypt can read the file directly - let's check that works too
-        # (ideally we'd compare the 2 approaches etc, but the objects don't support
-        # equality checks etc, so this will do for now.)
-        # No need to do this for different filenames!
-        filename = "win32crypt_testcert_base64.cer"
-        cert = win32crypt.CryptQueryObject(
-            CERT_QUERY_OBJECT_FILE,
-            find_test_fixture(filename),
-            CERT_QUERY_CONTENT_FLAG_CERT,
-            CERT_QUERY_FORMAT_FLAG_ALL,
-            0,
-        )
-        self.assertEqual(cert["FormatType"], CERT_QUERY_FORMAT_BASE64_ENCODED)
-        self.assertEqual(cert["ContentType"], CERT_QUERY_CONTENT_CERT)
-
-    def checkCertFile(self, filename, expected_format):
-        cert = self.readCertFile(filename)
-        self.assertEqual(cert["FormatType"], expected_format)
-        self.assertEqual(cert["ContentType"], CERT_QUERY_CONTENT_CERT)
-
-        with open_windows_certstore(_CURRENT_USER, "Temp") as store:
-            context = store.CertAddCertificateContextToStore(
-                cert["Context"], CERT_STORE_ADD_REPLACE_EXISTING
-            )
-            # Getting 2 certs here - main thing is we get 1!
-            self.assertTrue(len(store.CertEnumCertificatesInStore()))
-            self.assertFalse(len(store.CertEnumCTLsInStore()))
-            context.CertFreeCertificateContext()
-            try:
-                context.CertFreeCertificateContext()
-            except ValueError:
-                pass
-            else:
-                raise RuntimeError("should not be able to close the context twice")
-
-    def testCertBase64(self):
-        self.checkCertFile(
-            "win32crypt_testcert_base64.cer", CERT_QUERY_FORMAT_BASE64_ENCODED
-        )
-
-    def testCertBinary(self):
-        self.checkCertFile("win32crypt_testcert_bin.cer", CERT_QUERY_FORMAT_BINARY)
-
-
-if __name__ == "__main__":
-    testmain()
diff --git a/lib/win32/test/test_win32event.py b/lib/win32/test/test_win32event.py
deleted file mode 100644
index 9e6efa3f..00000000
--- a/lib/win32/test/test_win32event.py
+++ /dev/null
@@ -1,119 +0,0 @@
-import unittest
-
-import pywintypes
-import win32event
-
-
-class TestWaitableTimer(unittest.TestCase):
-    def testWaitableFire(self):
-        h = win32event.CreateWaitableTimer(None, 0, None)
-        dt = -160  # 160 ns.
-        win32event.SetWaitableTimer(h, dt, 0, None, None, 0)
-        rc = win32event.WaitForSingleObject(h, 1000)
-        self.assertEqual(rc, win32event.WAIT_OBJECT_0)
-
-    def testCreateWaitableTimerEx(self):
-        h = win32event.CreateWaitableTimerEx(
-            None,
-            None,
-            win32event.CREATE_WAITABLE_TIMER_HIGH_RESOLUTION,
-            win32event.TIMER_ALL_ACCESS,
-        )
-        dt = -160  # 160 ns.
-        win32event.SetWaitableTimer(h, dt, 0, None, None, 0)
-        rc = win32event.WaitForSingleObject(h, 1000)
-        self.assertEqual(rc, win32event.WAIT_OBJECT_0)
-
-    def testWaitableTrigger(self):
-        h = win32event.CreateWaitableTimer(None, 0, None)
-        # for the sake of this, pass a long that doesn't fit in an int.
-        dt = -2000000000
-        win32event.SetWaitableTimer(h, dt, 0, None, None, 0)
-        rc = win32event.WaitForSingleObject(h, 10)  # 10 ms.
-        self.assertEqual(rc, win32event.WAIT_TIMEOUT)
-
-    def testWaitableError(self):
-        h = win32event.CreateWaitableTimer(None, 0, None)
-        h.close()
-        self.assertRaises(
-            pywintypes.error, win32event.SetWaitableTimer, h, -42, 0, None, None, 0
-        )
-
-
-class TestWaitFunctions(unittest.TestCase):
-    def testMsgWaitForMultipleObjects(self):
-        # this function used to segfault when called with an empty list
-        res = win32event.MsgWaitForMultipleObjects([], 0, 0, 0)
-        self.assertEqual(res, win32event.WAIT_TIMEOUT)
-
-    def testMsgWaitForMultipleObjects2(self):
-        # test with non-empty list
-        event = win32event.CreateEvent(None, 0, 0, None)
-        res = win32event.MsgWaitForMultipleObjects([event], 0, 0, 0)
-        self.assertEqual(res, win32event.WAIT_TIMEOUT)
-
-    def testMsgWaitForMultipleObjectsEx(self):
-        # this function used to segfault when called with an empty list
-        res = win32event.MsgWaitForMultipleObjectsEx([], 0, 0, 0)
-        self.assertEqual(res, win32event.WAIT_TIMEOUT)
-
-    def testMsgWaitForMultipleObjectsEx2(self):
-        # test with non-empty list
-        event = win32event.CreateEvent(None, 0, 0, None)
-        res = win32event.MsgWaitForMultipleObjectsEx([event], 0, 0, 0)
-        self.assertEqual(res, win32event.WAIT_TIMEOUT)
-
-
-class TestEvent(unittest.TestCase):
-    def assertSignaled(self, event):
-        self.assertEqual(
-            win32event.WaitForSingleObject(event, 0), win32event.WAIT_OBJECT_0
-        )
-
-    def assertNotSignaled(self, event):
-        self.assertEqual(
-            win32event.WaitForSingleObject(event, 0), win32event.WAIT_TIMEOUT
-        )
-
-    def testCreateEvent(self):
-        event = win32event.CreateEvent(None, False, False, None)
-        self.assertNotSignaled(event)
-        event = win32event.CreateEvent(None, False, True, None)
-        self.assertSignaled(event)
-        self.assertNotSignaled(event)
-        event = win32event.CreateEvent(None, True, True, None)
-        self.assertSignaled(event)
-        self.assertSignaled(event)
-
-    def testSetEvent(self):
-        event = win32event.CreateEvent(None, True, False, None)
-        self.assertNotSignaled(event)
-        res = win32event.SetEvent(event)
-        self.assertEqual(res, None)
-        self.assertSignaled(event)
-        event.close()
-        self.assertRaises(pywintypes.error, win32event.SetEvent, event)
-
-    def testResetEvent(self):
-        event = win32event.CreateEvent(None, True, True, None)
-        self.assertSignaled(event)
-        res = win32event.ResetEvent(event)
-        self.assertEqual(res, None)
-        self.assertNotSignaled(event)
-        event.close()
-        self.assertRaises(pywintypes.error, win32event.ResetEvent, event)
-
-
-class TestMutex(unittest.TestCase):
-    def testReleaseMutex(self):
-        mutex = win32event.CreateMutex(None, True, None)
-        res = win32event.ReleaseMutex(mutex)
-        self.assertEqual(res, None)
-        res = win32event.WaitForSingleObject(mutex, 0)
-        self.assertEqual(res, win32event.WAIT_OBJECT_0)
-        mutex.close()
-        self.assertRaises(pywintypes.error, win32event.ReleaseMutex, mutex)
-
-
-if __name__ == "__main__":
-    unittest.main()
diff --git a/lib/win32/test/test_win32file.py b/lib/win32/test/test_win32file.py
deleted file mode 100644
index da998032..00000000
--- a/lib/win32/test/test_win32file.py
+++ /dev/null
@@ -1,1085 +0,0 @@
-import datetime
-import os
-import random
-import shutil
-import socket
-import tempfile
-import threading
-import time
-import unittest
-
-import ntsecuritycon
-import pywintypes
-import win32api
-import win32con
-import win32event
-import win32file
-import win32pipe
-import win32timezone
-import winerror
-from pywin32_testutil import TestSkipped, str2bytes, testmain
-
-try:
-    set
-except NameError:
-    from sets import Set as set
-
-
-class TestReadBuffer(unittest.TestCase):
-    def testLen(self):
-        buffer = win32file.AllocateReadBuffer(1)
-        self.assertEqual(len(buffer), 1)
-
-    def testSimpleIndex(self):
-        buffer = win32file.AllocateReadBuffer(1)
-        buffer[0] = 0xFF
-        self.assertEqual(buffer[0], 0xFF)
-
-    def testSimpleSlice(self):
-        buffer = win32file.AllocateReadBuffer(2)
-        val = str2bytes("\0\0")
-        buffer[:2] = val
-        self.assertEqual(buffer[0:2], val)
-
-
-class TestSimpleOps(unittest.TestCase):
-    def testSimpleFiles(self):
-        fd, filename = tempfile.mkstemp()
-        os.close(fd)
-        os.unlink(filename)
-        handle = win32file.CreateFile(
-            filename, win32file.GENERIC_WRITE, 0, None, win32con.CREATE_NEW, 0, None
-        )
-        test_data = str2bytes("Hello\0there")
-        try:
-            win32file.WriteFile(handle, test_data)
-            handle.Close()
-            # Try and open for read
-            handle = win32file.CreateFile(
-                filename,
-                win32file.GENERIC_READ,
-                0,
-                None,
-                win32con.OPEN_EXISTING,
-                0,
-                None,
-            )
-            rc, data = win32file.ReadFile(handle, 1024)
-            self.assertEqual(data, test_data)
-        finally:
-            handle.Close()
-            try:
-                os.unlink(filename)
-            except os.error:
-                pass
-
-    # A simple test using normal read/write operations.
-    def testMoreFiles(self):
-        # Create a file in the %TEMP% directory.
-        testName = os.path.join(win32api.GetTempPath(), "win32filetest.dat")
-        desiredAccess = win32file.GENERIC_READ | win32file.GENERIC_WRITE
-        # Set a flag to delete the file automatically when it is closed.
-        fileFlags = win32file.FILE_FLAG_DELETE_ON_CLOSE
-        h = win32file.CreateFile(
-            testName,
-            desiredAccess,
-            win32file.FILE_SHARE_READ,
-            None,
-            win32file.CREATE_ALWAYS,
-            fileFlags,
-            0,
-        )
-
-        # Write a known number of bytes to the file.
-        data = str2bytes("z") * 1025
-
-        win32file.WriteFile(h, data)
-
-        self.assertTrue(
-            win32file.GetFileSize(h) == len(data),
-            "WARNING: Written file does not have the same size as the length of the data in it!",
-        )
-
-        # Ensure we can read the data back.
-        win32file.SetFilePointer(h, 0, win32file.FILE_BEGIN)
-        hr, read_data = win32file.ReadFile(
-            h, len(data) + 10
-        )  # + 10 to get anything extra
-        self.assertTrue(hr == 0, "Readfile returned %d" % hr)
-
-        self.assertTrue(read_data == data, "Read data is not what we wrote!")
-
-        # Now truncate the file at 1/2 its existing size.
-        newSize = len(data) // 2
-        win32file.SetFilePointer(h, newSize, win32file.FILE_BEGIN)
-        win32file.SetEndOfFile(h)
-        self.assertEqual(win32file.GetFileSize(h), newSize)
-
-        # GetFileAttributesEx/GetFileAttributesExW tests.
-        self.assertEqual(
-            win32file.GetFileAttributesEx(testName),
-            win32file.GetFileAttributesExW(testName),
-        )
-
-        attr, ct, at, wt, size = win32file.GetFileAttributesEx(testName)
-        self.assertTrue(
-            size == newSize,
-            "Expected GetFileAttributesEx to return the same size as GetFileSize()",
-        )
-        self.assertTrue(
-            attr == win32file.GetFileAttributes(testName),
-            "Expected GetFileAttributesEx to return the same attributes as GetFileAttributes",
-        )
-
-        h = None  # Close the file by removing the last reference to the handle!
-
-        self.assertTrue(
-            not os.path.isfile(testName), "After closing the file, it still exists!"
-        )
-
-    def testFilePointer(self):
-        # via [ 979270 ] SetFilePointer fails with negative offset
-
-        # Create a file in the %TEMP% directory.
-        filename = os.path.join(win32api.GetTempPath(), "win32filetest.dat")
-
-        f = win32file.CreateFile(
-            filename,
-            win32file.GENERIC_READ | win32file.GENERIC_WRITE,
-            0,
-            None,
-            win32file.CREATE_ALWAYS,
-            win32file.FILE_ATTRIBUTE_NORMAL,
-            0,
-        )
-        try:
-            # Write some data
-            data = str2bytes("Some data")
-            (res, written) = win32file.WriteFile(f, data)
-
-            self.assertFalse(res)
-            self.assertEqual(written, len(data))
-
-            # Move at the beginning and read the data
-            win32file.SetFilePointer(f, 0, win32file.FILE_BEGIN)
-            (res, s) = win32file.ReadFile(f, len(data))
-
-            self.assertFalse(res)
-            self.assertEqual(s, data)
-
-            # Move at the end and read the data
-            win32file.SetFilePointer(f, -len(data), win32file.FILE_END)
-            (res, s) = win32file.ReadFile(f, len(data))
-
-            self.assertFalse(res)
-            self.assertEqual(s, data)
-        finally:
-            f.Close()
-            os.unlink(filename)
-
-    def testFileTimesTimezones(self):
-        filename = tempfile.mktemp("-testFileTimes")
-        # now() is always returning a timestamp with microseconds but the
-        # file APIs all have zero microseconds, so some comparisons fail.
-        now_utc = win32timezone.utcnow().replace(microsecond=0)
-        now_local = now_utc.astimezone(win32timezone.TimeZoneInfo.local())
-        h = win32file.CreateFile(
-            filename,
-            win32file.GENERIC_READ | win32file.GENERIC_WRITE,
-            0,
-            None,
-            win32file.CREATE_ALWAYS,
-            0,
-            0,
-        )
-        try:
-            win32file.SetFileTime(h, now_utc, now_utc, now_utc)
-            ct, at, wt = win32file.GetFileTime(h)
-            self.assertEqual(now_local, ct)
-            self.assertEqual(now_local, at)
-            self.assertEqual(now_local, wt)
-            # and the reverse - set local, check against utc
-            win32file.SetFileTime(h, now_local, now_local, now_local)
-            ct, at, wt = win32file.GetFileTime(h)
-            self.assertEqual(now_utc, ct)
-            self.assertEqual(now_utc, at)
-            self.assertEqual(now_utc, wt)
-        finally:
-            h.close()
-            os.unlink(filename)
-
-    def testFileTimes(self):
-        from win32timezone import TimeZoneInfo
-
-        # now() is always returning a timestamp with microseconds but the
-        # file APIs all have zero microseconds, so some comparisons fail.
-        now = datetime.datetime.now(tz=TimeZoneInfo.utc()).replace(microsecond=0)
-        nowish = now + datetime.timedelta(seconds=1)
-        later = now + datetime.timedelta(seconds=120)
-
-        filename = tempfile.mktemp("-testFileTimes")
-        # Windows docs the 'last time' isn't valid until the last write
-        # handle is closed - so create the file, then re-open it to check.
-        open(filename, "w").close()
-        f = win32file.CreateFile(
-            filename,
-            win32file.GENERIC_READ | win32file.GENERIC_WRITE,
-            0,
-            None,
-            win32con.OPEN_EXISTING,
-            0,
-            None,
-        )
-        try:
-            ct, at, wt = win32file.GetFileTime(f)
-            self.assertTrue(
-                ct >= now,
-                "File was created in the past - now=%s, created=%s" % (now, ct),
-            )
-            self.assertTrue(now <= ct <= nowish, (now, ct))
-            self.assertTrue(
-                wt >= now,
-                "File was written-to in the past now=%s, written=%s" % (now, wt),
-            )
-            self.assertTrue(now <= wt <= nowish, (now, wt))
-
-            # Now set the times.
-            win32file.SetFileTime(f, later, later, later, UTCTimes=True)
-            # Get them back.
-            ct, at, wt = win32file.GetFileTime(f)
-            # XXX - the builtin PyTime type appears to be out by a dst offset.
-            # just ignore that type here...
-            self.assertEqual(ct, later)
-            self.assertEqual(at, later)
-            self.assertEqual(wt, later)
-
-        finally:
-            f.Close()
-            os.unlink(filename)
-
-
-class TestGetFileInfoByHandleEx(unittest.TestCase):
-    __handle = __filename = None
-
-    def setUp(self):
-        fd, self.__filename = tempfile.mkstemp()
-        os.close(fd)
-
-    def tearDown(self):
-        if self.__handle is not None:
-            self.__handle.Close()
-        if self.__filename is not None:
-            try:
-                os.unlink(self.__filename)
-            except OSError:
-                pass
-        self.__handle = self.__filename = None
-
-    def testFileBasicInfo(self):
-        attr = win32file.GetFileAttributes(self.__filename)
-        f = win32file.CreateFile(
-            self.__filename,
-            win32file.GENERIC_READ,
-            0,
-            None,
-            win32con.OPEN_EXISTING,
-            0,
-            None,
-        )
-        self.__handle = f
-        ct, at, wt = win32file.GetFileTime(f)
-
-        # bug #752: this throws ERROR_BAD_LENGTH (24) in x86 binaries of build 221
-        basic_info = win32file.GetFileInformationByHandleEx(f, win32file.FileBasicInfo)
-
-        self.assertEqual(ct, basic_info["CreationTime"])
-        self.assertEqual(at, basic_info["LastAccessTime"])
-        self.assertEqual(wt, basic_info["LastWriteTime"])
-        self.assertEqual(attr, basic_info["FileAttributes"])
-
-
-class TestOverlapped(unittest.TestCase):
-    def testSimpleOverlapped(self):
-        # Create a file in the %TEMP% directory.
-        import win32event
-
-        testName = os.path.join(win32api.GetTempPath(), "win32filetest.dat")
-        desiredAccess = win32file.GENERIC_WRITE
-        overlapped = pywintypes.OVERLAPPED()
-        evt = win32event.CreateEvent(None, 0, 0, None)
-        overlapped.hEvent = evt
-        # Create the file and write shit-loads of data to it.
-        h = win32file.CreateFile(
-            testName, desiredAccess, 0, None, win32file.CREATE_ALWAYS, 0, 0
-        )
-        chunk_data = str2bytes("z") * 0x8000
-        num_loops = 512
-        expected_size = num_loops * len(chunk_data)
-        for i in range(num_loops):
-            win32file.WriteFile(h, chunk_data, overlapped)
-            win32event.WaitForSingleObject(overlapped.hEvent, win32event.INFINITE)
-            overlapped.Offset = overlapped.Offset + len(chunk_data)
-        h.Close()
-        # Now read the data back overlapped
-        overlapped = pywintypes.OVERLAPPED()
-        evt = win32event.CreateEvent(None, 0, 0, None)
-        overlapped.hEvent = evt
-        desiredAccess = win32file.GENERIC_READ
-        h = win32file.CreateFile(
-            testName, desiredAccess, 0, None, win32file.OPEN_EXISTING, 0, 0
-        )
-        buffer = win32file.AllocateReadBuffer(0xFFFF)
-        while 1:
-            try:
-                hr, data = win32file.ReadFile(h, buffer, overlapped)
-                win32event.WaitForSingleObject(overlapped.hEvent, win32event.INFINITE)
-                overlapped.Offset = overlapped.Offset + len(data)
-                if not data is buffer:
-                    self.fail(
-                        "Unexpected result from ReadFile - should be the same buffer we passed it"
-                    )
-            except win32api.error:
-                break
-        h.Close()
-
-    def testCompletionPortsMultiple(self):
-        # Mainly checking that we can "associate" an existing handle.  This
-        # failed in build 203.
-        ioport = win32file.CreateIoCompletionPort(
-            win32file.INVALID_HANDLE_VALUE, 0, 0, 0
-        )
-        socks = []
-        for PORT in range(9123, 9125):
-            sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
-            sock.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
-            sock.bind(("", PORT))
-            sock.listen(1)
-            socks.append(sock)
-            new = win32file.CreateIoCompletionPort(sock.fileno(), ioport, PORT, 0)
-            assert new is ioport
-        for s in socks:
-            s.close()
-        hv = int(ioport)
-        ioport = new = None
-        # The handle itself should be closed now (unless we leak references!)
-        # Check that.
-        try:
-            win32file.CloseHandle(hv)
-            raise RuntimeError("Expected close to fail!")
-        except win32file.error as details:
-            self.assertEqual(details.winerror, winerror.ERROR_INVALID_HANDLE)
-
-    def testCompletionPortsQueued(self):
-        class Foo:
-            pass
-
-        io_req_port = win32file.CreateIoCompletionPort(-1, None, 0, 0)
-        overlapped = pywintypes.OVERLAPPED()
-        overlapped.object = Foo()
-        win32file.PostQueuedCompletionStatus(io_req_port, 0, 99, overlapped)
-        errCode, bytes, key, overlapped = win32file.GetQueuedCompletionStatus(
-            io_req_port, win32event.INFINITE
-        )
-        self.assertEqual(errCode, 0)
-        self.assertTrue(isinstance(overlapped.object, Foo))
-
-    def _IOCPServerThread(self, handle, port, drop_overlapped_reference):
-        overlapped = pywintypes.OVERLAPPED()
-        win32pipe.ConnectNamedPipe(handle, overlapped)
-        if drop_overlapped_reference:
-            # Be naughty - the overlapped object is now dead, but
-            # GetQueuedCompletionStatus will still find it.  Our check of
-            # reference counting should catch that error.
-            overlapped = None
-            # even if we fail, be sure to close the handle; prevents hangs
-            # on Vista 64...
-            try:
-                self.assertRaises(
-                    RuntimeError, win32file.GetQueuedCompletionStatus, port, -1
-                )
-            finally:
-                handle.Close()
-            return
-
-        result = win32file.GetQueuedCompletionStatus(port, -1)
-        ol2 = result[-1]
-        self.assertTrue(ol2 is overlapped)
-        data = win32file.ReadFile(handle, 512)[1]
-        win32file.WriteFile(handle, data)
-
-    def testCompletionPortsNonQueued(self, test_overlapped_death=0):
-        # In 204 we had a reference count bug when OVERLAPPED objects were
-        # associated with a completion port other than via
-        # PostQueuedCompletionStatus.  This test is based on the reproduction
-        # reported with that bug.
-        # Create the pipe.
-        BUFSIZE = 512
-        pipe_name = r"\\.\pipe\pywin32_test_pipe"
-        handle = win32pipe.CreateNamedPipe(
-            pipe_name,
-            win32pipe.PIPE_ACCESS_DUPLEX | win32file.FILE_FLAG_OVERLAPPED,
-            win32pipe.PIPE_TYPE_MESSAGE
-            | win32pipe.PIPE_READMODE_MESSAGE
-            | win32pipe.PIPE_WAIT,
-            1,
-            BUFSIZE,
-            BUFSIZE,
-            win32pipe.NMPWAIT_WAIT_FOREVER,
-            None,
-        )
-        # Create an IOCP and associate it with the handle.
-        port = win32file.CreateIoCompletionPort(-1, 0, 0, 0)
-        win32file.CreateIoCompletionPort(handle, port, 1, 0)
-
-        t = threading.Thread(
-            target=self._IOCPServerThread, args=(handle, port, test_overlapped_death)
-        )
-        t.setDaemon(True)  # avoid hanging entire test suite on failure.
-        t.start()
-        try:
-            time.sleep(0.1)  # let thread do its thing.
-            try:
-                win32pipe.CallNamedPipe(
-                    r"\\.\pipe\pywin32_test_pipe", str2bytes("Hello there"), BUFSIZE, 0
-                )
-            except win32pipe.error:
-                # Testing for overlapped death causes this
-                if not test_overlapped_death:
-                    raise
-        finally:
-            if not test_overlapped_death:
-                handle.Close()
-            t.join(3)
-            self.assertFalse(t.is_alive(), "thread didn't finish")
-
-    def testCompletionPortsNonQueuedBadReference(self):
-        self.testCompletionPortsNonQueued(True)
-
-    def testHashable(self):
-        overlapped = pywintypes.OVERLAPPED()
-        d = {}
-        d[overlapped] = "hello"
-        self.assertEqual(d[overlapped], "hello")
-
-    def testComparable(self):
-        overlapped = pywintypes.OVERLAPPED()
-        self.assertEqual(overlapped, overlapped)
-        # ensure we explicitly test the operators.
-        self.assertTrue(overlapped == overlapped)
-        self.assertFalse(overlapped != overlapped)
-
-    def testComparable2(self):
-        # 2 overlapped objects compare equal if their contents are the same.
-        overlapped1 = pywintypes.OVERLAPPED()
-        overlapped2 = pywintypes.OVERLAPPED()
-        self.assertEqual(overlapped1, overlapped2)
-        # ensure we explicitly test the operators.
-        self.assertTrue(overlapped1 == overlapped2)
-        self.assertFalse(overlapped1 != overlapped2)
-        # now change something in one of them - should no longer be equal.
-        overlapped1.hEvent = 1
-        self.assertNotEqual(overlapped1, overlapped2)
-        # ensure we explicitly test the operators.
-        self.assertFalse(overlapped1 == overlapped2)
-        self.assertTrue(overlapped1 != overlapped2)
-
-
-class TestSocketExtensions(unittest.TestCase):
-    def acceptWorker(self, port, running_event, stopped_event):
-        listener = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
-        listener.bind(("", port))
-        listener.listen(200)
-
-        # create accept socket
-        accepter = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
-        # An overlapped
-        overlapped = pywintypes.OVERLAPPED()
-        overlapped.hEvent = win32event.CreateEvent(None, 0, 0, None)
-        # accept the connection.
-        # We used to allow strings etc to be passed here, and they would be
-        # modified!  Obviously this is evil :)
-        buffer = " " * 1024  # EVIL - SHOULD NOT BE ALLOWED.
-        self.assertRaises(
-            TypeError, win32file.AcceptEx, listener, accepter, buffer, overlapped
-        )
-
-        # This is the correct way to allocate the buffer...
-        buffer = win32file.AllocateReadBuffer(1024)
-        rc = win32file.AcceptEx(listener, accepter, buffer, overlapped)
-        self.assertEqual(rc, winerror.ERROR_IO_PENDING)
-        # Set the event to say we are all ready
-        running_event.set()
-        # and wait for the connection.
-        rc = win32event.WaitForSingleObject(overlapped.hEvent, 2000)
-        if rc == win32event.WAIT_TIMEOUT:
-            self.fail("timed out waiting for a connection")
-        nbytes = win32file.GetOverlappedResult(listener.fileno(), overlapped, False)
-        # fam, loc, rem = win32file.GetAcceptExSockaddrs(accepter, buffer)
-        accepter.send(buffer[:nbytes])
-        # NOT set in a finally - this means *successfully* stopped!
-        stopped_event.set()
-
-    def testAcceptEx(self):
-        port = 4680
-        running = threading.Event()
-        stopped = threading.Event()
-        t = threading.Thread(target=self.acceptWorker, args=(port, running, stopped))
-        t.start()
-        running.wait(2)
-        if not running.isSet():
-            self.fail("AcceptEx Worker thread failed to start")
-        s = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
-        s.connect(("127.0.0.1", port))
-        win32file.WSASend(s, str2bytes("hello"), None)
-        overlapped = pywintypes.OVERLAPPED()
-        overlapped.hEvent = win32event.CreateEvent(None, 0, 0, None)
-        # Like above - WSARecv used to allow strings as the receive buffer!!
-        buffer = " " * 10
-        self.assertRaises(TypeError, win32file.WSARecv, s, buffer, overlapped)
-        # This one should work :)
-        buffer = win32file.AllocateReadBuffer(10)
-        win32file.WSARecv(s, buffer, overlapped)
-        nbytes = win32file.GetOverlappedResult(s.fileno(), overlapped, True)
-        got = buffer[:nbytes]
-        self.assertEqual(got, str2bytes("hello"))
-        # thread should have stopped
-        stopped.wait(2)
-        if not stopped.isSet():
-            self.fail("AcceptEx Worker thread failed to successfully stop")
-
-
-class TestFindFiles(unittest.TestCase):
-    def testIter(self):
-        dir = os.path.join(os.getcwd(), "*")
-        files = win32file.FindFilesW(dir)
-        set1 = set()
-        set1.update(files)
-        set2 = set()
-        for file in win32file.FindFilesIterator(dir):
-            set2.add(file)
-        assert len(set2) > 5, "This directory has less than 5 files!?"
-        self.assertEqual(set1, set2)
-
-    def testBadDir(self):
-        dir = os.path.join(os.getcwd(), "a dir that doesnt exist", "*")
-        self.assertRaises(win32file.error, win32file.FindFilesIterator, dir)
-
-    def testEmptySpec(self):
-        spec = os.path.join(os.getcwd(), "*.foo_bar")
-        num = 0
-        for i in win32file.FindFilesIterator(spec):
-            num += 1
-        self.assertEqual(0, num)
-
-    def testEmptyDir(self):
-        test_path = os.path.join(win32api.GetTempPath(), "win32file_test_directory")
-        try:
-            # Note: previously used shutil.rmtree, but when looking for
-            # reference count leaks, that function showed leaks!  os.rmdir
-            # doesn't have that problem.
-            os.rmdir(test_path)
-        except os.error:
-            pass
-        os.mkdir(test_path)
-        try:
-            num = 0
-            for i in win32file.FindFilesIterator(os.path.join(test_path, "*")):
-                num += 1
-            # Expecting "." and ".." only
-            self.assertEqual(2, num)
-        finally:
-            os.rmdir(test_path)
-
-
-class TestDirectoryChanges(unittest.TestCase):
-    num_test_dirs = 1
-
-    def setUp(self):
-        self.watcher_threads = []
-        self.watcher_thread_changes = []
-        self.dir_names = []
-        self.dir_handles = []
-        for i in range(self.num_test_dirs):
-            td = tempfile.mktemp("-test-directory-changes-%d" % i)
-            os.mkdir(td)
-            self.dir_names.append(td)
-            hdir = win32file.CreateFile(
-                td,
-                ntsecuritycon.FILE_LIST_DIRECTORY,
-                win32con.FILE_SHARE_READ,
-                None,  # security desc
-                win32con.OPEN_EXISTING,
-                win32con.FILE_FLAG_BACKUP_SEMANTICS | win32con.FILE_FLAG_OVERLAPPED,
-                None,
-            )
-            self.dir_handles.append(hdir)
-
-            changes = []
-            t = threading.Thread(
-                target=self._watcherThreadOverlapped, args=(td, hdir, changes)
-            )
-            t.start()
-            self.watcher_threads.append(t)
-            self.watcher_thread_changes.append(changes)
-
-    def _watcherThread(self, dn, dh, changes):
-        # A synchronous version:
-        # XXX - not used - I was having a whole lot of problems trying to
-        # get this to work.  Specifically:
-        # * ReadDirectoryChangesW without an OVERLAPPED blocks infinitely.
-        # * If another thread attempts to close the handle while
-        #   ReadDirectoryChangesW is waiting on it, the ::CloseHandle() method
-        #   blocks (which has nothing to do with the GIL - it is correctly
-        #   managed)
-        # Which ends up with no way to kill the thread!
-        flags = win32con.FILE_NOTIFY_CHANGE_FILE_NAME
-        while 1:
-            try:
-                print("waiting", dh)
-                changes = win32file.ReadDirectoryChangesW(
-                    dh, 8192, False, flags  # sub-tree
-                )
-                print("got", changes)
-            except:
-                raise
-            changes.extend(changes)
-
-    def _watcherThreadOverlapped(self, dn, dh, changes):
-        flags = win32con.FILE_NOTIFY_CHANGE_FILE_NAME
-        buf = win32file.AllocateReadBuffer(8192)
-        overlapped = pywintypes.OVERLAPPED()
-        overlapped.hEvent = win32event.CreateEvent(None, 0, 0, None)
-        while 1:
-            win32file.ReadDirectoryChangesW(
-                dh, buf, False, flags, overlapped  # sub-tree
-            )
-            # Wait for our event, or for 5 seconds.
-            rc = win32event.WaitForSingleObject(overlapped.hEvent, 5000)
-            if rc == win32event.WAIT_OBJECT_0:
-                # got some data!  Must use GetOverlappedResult to find out
-                # how much is valid!  0 generally means the handle has
-                # been closed.  Blocking is OK here, as the event has
-                # already been set.
-                nbytes = win32file.GetOverlappedResult(dh, overlapped, True)
-                if nbytes:
-                    bits = win32file.FILE_NOTIFY_INFORMATION(buf, nbytes)
-                    changes.extend(bits)
-                else:
-                    # This is "normal" exit - our 'tearDown' closes the
-                    # handle.
-                    # print "looks like dir handle was closed!"
-                    return
-            else:
-                print("ERROR: Watcher thread timed-out!")
-                return  # kill the thread!
-
-    def tearDown(self):
-        # be careful about raising errors at teardown!
-        for h in self.dir_handles:
-            # See comments in _watcherThread above - this appears to
-            # deadlock if a synchronous ReadDirectoryChangesW is waiting...
-            # (No such problems with an asynch ReadDirectoryChangesW)
-            h.Close()
-        for dn in self.dir_names:
-            try:
-                shutil.rmtree(dn)
-            except OSError:
-                print("FAILED to remove directory", dn)
-
-        for t in self.watcher_threads:
-            # closing dir handle should have killed threads!
-            t.join(5)
-            if t.is_alive():
-                print("FAILED to wait for thread termination")
-
-    def stablize(self):
-        time.sleep(0.5)
-
-    def testSimple(self):
-        self.stablize()
-        for dn in self.dir_names:
-            fn = os.path.join(dn, "test_file")
-            open(fn, "w").close()
-
-        self.stablize()
-        changes = self.watcher_thread_changes[0]
-        self.assertEqual(changes, [(1, "test_file")])
-
-    def testSmall(self):
-        self.stablize()
-        for dn in self.dir_names:
-            fn = os.path.join(dn, "x")
-            open(fn, "w").close()
-
-        self.stablize()
-        changes = self.watcher_thread_changes[0]
-        self.assertEqual(changes, [(1, "x")])
-
-
-class TestEncrypt(unittest.TestCase):
-    def testEncrypt(self):
-        fname = tempfile.mktemp("win32file_test")
-        f = open(fname, "wb")
-        f.write(str2bytes("hello"))
-        f.close()
-        f = None
-        try:
-            try:
-                win32file.EncryptFile(fname)
-            except win32file.error as details:
-                if details.winerror != winerror.ERROR_ACCESS_DENIED:
-                    raise
-                print("It appears this is not NTFS - cant encrypt/decrypt")
-            win32file.DecryptFile(fname)
-        finally:
-            if f is not None:
-                f.close()
-            os.unlink(fname)
-
-
-class TestConnect(unittest.TestCase):
-    def connect_thread_runner(self, expect_payload, giveup_event):
-        # As Windows 2000 doesn't do ConnectEx, we need to use a non-blocking
-        # accept, as our test connection may never come.  May as well use
-        # AcceptEx for this...
-        listener = socket.socket()
-        self.addr = ("localhost", random.randint(10000, 64000))
-        listener.bind(self.addr)
-        listener.listen(1)
-
-        # create accept socket
-        accepter = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
-        # An overlapped
-        overlapped = pywintypes.OVERLAPPED()
-        overlapped.hEvent = win32event.CreateEvent(None, 0, 0, None)
-        # accept the connection.
-        if expect_payload:
-            buf_size = 1024
-        else:
-            # when we don't expect data we must be careful to only pass the
-            # exact number of bytes for the endpoint data...
-            buf_size = win32file.CalculateSocketEndPointSize(listener)
-
-        buffer = win32file.AllocateReadBuffer(buf_size)
-        win32file.AcceptEx(listener, accepter, buffer, overlapped)
-        # wait for the connection or our test to fail.
-        events = giveup_event, overlapped.hEvent
-        rc = win32event.WaitForMultipleObjects(events, False, 2000)
-        if rc == win32event.WAIT_TIMEOUT:
-            self.fail("timed out waiting for a connection")
-        if rc == win32event.WAIT_OBJECT_0:
-            # Our main thread running the test failed and will never connect.
-            return
-        # must be a connection.
-        nbytes = win32file.GetOverlappedResult(listener.fileno(), overlapped, False)
-        if expect_payload:
-            self.request = buffer[:nbytes]
-        accepter.send(str2bytes("some expected response"))
-
-    def test_connect_with_payload(self):
-        giveup_event = win32event.CreateEvent(None, 0, 0, None)
-        t = threading.Thread(
-            target=self.connect_thread_runner, args=(True, giveup_event)
-        )
-        t.start()
-        time.sleep(0.1)
-        s2 = socket.socket()
-        ol = pywintypes.OVERLAPPED()
-        s2.bind(("0.0.0.0", 0))  # connectex requires the socket be bound beforehand
-        try:
-            win32file.ConnectEx(s2, self.addr, ol, str2bytes("some expected request"))
-        except win32file.error as exc:
-            win32event.SetEvent(giveup_event)
-            if exc.winerror == 10022:  # WSAEINVAL
-                raise TestSkipped("ConnectEx is not available on this platform")
-            raise  # some error error we don't expect.
-        # We occasionally see ERROR_CONNECTION_REFUSED in automation
-        try:
-            win32file.GetOverlappedResult(s2.fileno(), ol, 1)
-        except win32file.error as exc:
-            win32event.SetEvent(giveup_event)
-            if exc.winerror == winerror.ERROR_CONNECTION_REFUSED:
-                raise TestSkipped("Assuming ERROR_CONNECTION_REFUSED is transient")
-            raise
-        ol = pywintypes.OVERLAPPED()
-        buff = win32file.AllocateReadBuffer(1024)
-        win32file.WSARecv(s2, buff, ol, 0)
-        length = win32file.GetOverlappedResult(s2.fileno(), ol, 1)
-        self.response = buff[:length]
-        self.assertEqual(self.response, str2bytes("some expected response"))
-        self.assertEqual(self.request, str2bytes("some expected request"))
-        t.join(5)
-        self.assertFalse(t.is_alive(), "worker thread didn't terminate")
-
-    def test_connect_without_payload(self):
-        giveup_event = win32event.CreateEvent(None, 0, 0, None)
-        t = threading.Thread(
-            target=self.connect_thread_runner, args=(False, giveup_event)
-        )
-        t.start()
-        time.sleep(0.1)
-        s2 = socket.socket()
-        ol = pywintypes.OVERLAPPED()
-        s2.bind(("0.0.0.0", 0))  # connectex requires the socket be bound beforehand
-        try:
-            win32file.ConnectEx(s2, self.addr, ol)
-        except win32file.error as exc:
-            win32event.SetEvent(giveup_event)
-            if exc.winerror == 10022:  # WSAEINVAL
-                raise TestSkipped("ConnectEx is not available on this platform")
-            raise  # some error error we don't expect.
-        # We occasionally see ERROR_CONNECTION_REFUSED in automation
-        try:
-            win32file.GetOverlappedResult(s2.fileno(), ol, 1)
-        except win32file.error as exc:
-            win32event.SetEvent(giveup_event)
-            if exc.winerror == winerror.ERROR_CONNECTION_REFUSED:
-                raise TestSkipped("Assuming ERROR_CONNECTION_REFUSED is transient")
-            raise
-
-        ol = pywintypes.OVERLAPPED()
-        buff = win32file.AllocateReadBuffer(1024)
-        win32file.WSARecv(s2, buff, ol, 0)
-        length = win32file.GetOverlappedResult(s2.fileno(), ol, 1)
-        self.response = buff[:length]
-        self.assertEqual(self.response, str2bytes("some expected response"))
-        t.join(5)
-        self.assertFalse(t.is_alive(), "worker thread didn't terminate")
-
-
-class TestTransmit(unittest.TestCase):
-    def test_transmit(self):
-        import binascii
-
-        bytes = os.urandom(1024 * 1024)
-        val = binascii.hexlify(bytes)
-        val_length = len(val)
-        f = tempfile.TemporaryFile()
-        f.write(val)
-
-        def runner():
-            s1 = socket.socket()
-            # binding fails occasionally on github CI with:
-            # OSError: [WinError 10013] An attempt was made to access a socket in a way forbidden by its access permissions
-            # which probably just means the random port is already in use, so
-            # let that happen a few times.
-            for i in range(5):
-                self.addr = ("localhost", random.randint(10000, 64000))
-                try:
-                    s1.bind(self.addr)
-                    break
-                except os.error as exc:
-                    if exc.winerror != 10013:
-                        raise
-                    print("Failed to use port", self.addr, "trying another random one")
-            else:
-                raise RuntimeError("Failed to find an available port to bind to.")
-            s1.listen(1)
-            cli, addr = s1.accept()
-            buf = 1
-            self.request = []
-            while buf:
-                buf = cli.recv(1024 * 100)
-                self.request.append(buf)
-
-        th = threading.Thread(target=runner)
-        th.start()
-        time.sleep(0.5)
-        s2 = socket.socket()
-        s2.connect(self.addr)
-
-        length = 0
-        aaa = str2bytes("[AAA]")
-        bbb = str2bytes("[BBB]")
-        ccc = str2bytes("[CCC]")
-        ddd = str2bytes("[DDD]")
-        empty = str2bytes("")
-        ol = pywintypes.OVERLAPPED()
-        f.seek(0)
-        win32file.TransmitFile(
-            s2, win32file._get_osfhandle(f.fileno()), val_length, 0, ol, 0
-        )
-        length += win32file.GetOverlappedResult(s2.fileno(), ol, 1)
-
-        ol = pywintypes.OVERLAPPED()
-        f.seek(0)
-        win32file.TransmitFile(
-            s2, win32file._get_osfhandle(f.fileno()), val_length, 0, ol, 0, aaa, bbb
-        )
-        length += win32file.GetOverlappedResult(s2.fileno(), ol, 1)
-
-        ol = pywintypes.OVERLAPPED()
-        f.seek(0)
-        win32file.TransmitFile(
-            s2, win32file._get_osfhandle(f.fileno()), val_length, 0, ol, 0, empty, empty
-        )
-        length += win32file.GetOverlappedResult(s2.fileno(), ol, 1)
-
-        ol = pywintypes.OVERLAPPED()
-        f.seek(0)
-        win32file.TransmitFile(
-            s2, win32file._get_osfhandle(f.fileno()), val_length, 0, ol, 0, None, ccc
-        )
-        length += win32file.GetOverlappedResult(s2.fileno(), ol, 1)
-
-        ol = pywintypes.OVERLAPPED()
-        f.seek(0)
-        win32file.TransmitFile(
-            s2, win32file._get_osfhandle(f.fileno()), val_length, 0, ol, 0, ddd
-        )
-        length += win32file.GetOverlappedResult(s2.fileno(), ol, 1)
-
-        s2.close()
-        th.join()
-        buf = str2bytes("").join(self.request)
-        self.assertEqual(length, len(buf))
-        expected = val + aaa + val + bbb + val + val + ccc + ddd + val
-        self.assertEqual(type(expected), type(buf))
-        self.assertEqual(expected, buf)
-
-
-class TestWSAEnumNetworkEvents(unittest.TestCase):
-    def test_basics(self):
-        s = socket.socket()
-        e = win32event.CreateEvent(None, 1, 0, None)
-        win32file.WSAEventSelect(s, e, 0)
-        self.assertEqual(win32file.WSAEnumNetworkEvents(s), {})
-        self.assertEqual(win32file.WSAEnumNetworkEvents(s, e), {})
-        self.assertRaises(TypeError, win32file.WSAEnumNetworkEvents, s, e, 3)
-        self.assertRaises(TypeError, win32file.WSAEnumNetworkEvents, s, "spam")
-        self.assertRaises(TypeError, win32file.WSAEnumNetworkEvents, "spam", e)
-        self.assertRaises(TypeError, win32file.WSAEnumNetworkEvents, "spam")
-        f = open("NUL")
-        h = win32file._get_osfhandle(f.fileno())
-        self.assertRaises(win32file.error, win32file.WSAEnumNetworkEvents, h)
-        self.assertRaises(win32file.error, win32file.WSAEnumNetworkEvents, s, h)
-        try:
-            win32file.WSAEnumNetworkEvents(h)
-        except win32file.error as e:
-            self.assertEqual(e.winerror, win32file.WSAENOTSOCK)
-        try:
-            win32file.WSAEnumNetworkEvents(s, h)
-        except win32file.error as e:
-            # According to the docs it would seem reasonable that
-            # this would fail with WSAEINVAL, but it doesn't.
-            self.assertEqual(e.winerror, win32file.WSAENOTSOCK)
-
-    def test_functional(self):
-        # This is not really a unit test, but it does exercise the code
-        # quite well and can serve as an example of WSAEventSelect and
-        # WSAEnumNetworkEvents usage.
-        port = socket.socket()
-        port.setblocking(0)
-        port_event = win32event.CreateEvent(None, 0, 0, None)
-        win32file.WSAEventSelect(
-            port, port_event, win32file.FD_ACCEPT | win32file.FD_CLOSE
-        )
-        port.bind(("127.0.0.1", 0))
-        port.listen(10)
-
-        client = socket.socket()
-        client.setblocking(0)
-        client_event = win32event.CreateEvent(None, 0, 0, None)
-        win32file.WSAEventSelect(
-            client,
-            client_event,
-            win32file.FD_CONNECT
-            | win32file.FD_READ
-            | win32file.FD_WRITE
-            | win32file.FD_CLOSE,
-        )
-        err = client.connect_ex(port.getsockname())
-        self.assertEqual(err, win32file.WSAEWOULDBLOCK)
-
-        res = win32event.WaitForSingleObject(port_event, 1000)
-        self.assertEqual(res, win32event.WAIT_OBJECT_0)
-        events = win32file.WSAEnumNetworkEvents(port, port_event)
-        self.assertEqual(events, {win32file.FD_ACCEPT: 0})
-
-        server, addr = port.accept()
-        server.setblocking(0)
-        server_event = win32event.CreateEvent(None, 1, 0, None)
-        win32file.WSAEventSelect(
-            server,
-            server_event,
-            win32file.FD_READ | win32file.FD_WRITE | win32file.FD_CLOSE,
-        )
-        res = win32event.WaitForSingleObject(server_event, 1000)
-        self.assertEqual(res, win32event.WAIT_OBJECT_0)
-        events = win32file.WSAEnumNetworkEvents(server, server_event)
-        self.assertEqual(events, {win32file.FD_WRITE: 0})
-
-        res = win32event.WaitForSingleObject(client_event, 1000)
-        self.assertEqual(res, win32event.WAIT_OBJECT_0)
-        events = win32file.WSAEnumNetworkEvents(client, client_event)
-        self.assertEqual(events, {win32file.FD_CONNECT: 0, win32file.FD_WRITE: 0})
-        sent = 0
-        data = str2bytes("x") * 16 * 1024
-        while sent < 16 * 1024 * 1024:
-            try:
-                sent += client.send(data)
-            except socket.error as e:
-                if e.args[0] == win32file.WSAEINTR:
-                    continue
-                elif e.args[0] in (win32file.WSAEWOULDBLOCK, win32file.WSAENOBUFS):
-                    break
-                else:
-                    raise
-        else:
-            self.fail("could not find socket buffer limit")
-
-        events = win32file.WSAEnumNetworkEvents(client)
-        self.assertEqual(events, {})
-
-        res = win32event.WaitForSingleObject(server_event, 1000)
-        self.assertEqual(res, win32event.WAIT_OBJECT_0)
-        events = win32file.WSAEnumNetworkEvents(server, server_event)
-        self.assertEqual(events, {win32file.FD_READ: 0})
-
-        received = 0
-        while received < sent:
-            try:
-                received += len(server.recv(16 * 1024))
-            except socket.error as e:
-                if e.args[0] in [win32file.WSAEINTR, win32file.WSAEWOULDBLOCK]:
-                    continue
-                else:
-                    raise
-
-        self.assertEqual(received, sent)
-        events = win32file.WSAEnumNetworkEvents(server)
-        self.assertEqual(events, {})
-
-        res = win32event.WaitForSingleObject(client_event, 1000)
-        self.assertEqual(res, win32event.WAIT_OBJECT_0)
-        events = win32file.WSAEnumNetworkEvents(client, client_event)
-        self.assertEqual(events, {win32file.FD_WRITE: 0})
-
-        client.shutdown(socket.SHUT_WR)
-        res = win32event.WaitForSingleObject(server_event, 1000)
-        self.assertEqual(res, win32event.WAIT_OBJECT_0)
-        # strange timing issues...
-        for i in range(5):
-            events = win32file.WSAEnumNetworkEvents(server, server_event)
-            if events:
-                break
-            win32api.Sleep(100)
-        else:
-            raise AssertionError("failed to get events")
-        self.assertEqual(events, {win32file.FD_CLOSE: 0})
-        events = win32file.WSAEnumNetworkEvents(client)
-        self.assertEqual(events, {})
-
-        server.close()
-        res = win32event.WaitForSingleObject(client_event, 1000)
-        self.assertEqual(res, win32event.WAIT_OBJECT_0)
-        events = win32file.WSAEnumNetworkEvents(client, client_event)
-        self.assertEqual(events, {win32file.FD_CLOSE: 0})
-
-        client.close()
-        events = win32file.WSAEnumNetworkEvents(port)
-        self.assertEqual(events, {})
-
-
-if __name__ == "__main__":
-    testmain()
diff --git a/lib/win32/test/test_win32gui.py b/lib/win32/test/test_win32gui.py
deleted file mode 100644
index ad96bd43..00000000
--- a/lib/win32/test/test_win32gui.py
+++ /dev/null
@@ -1,65 +0,0 @@
-# tests for win32gui
-import array
-import operator
-import unittest
-
-import pywin32_testutil
-import win32gui
-
-
-class TestPyGetString(unittest.TestCase):
-    def test_get_string(self):
-        # test invalid addresses cause a ValueError rather than crash!
-        self.assertRaises(ValueError, win32gui.PyGetString, 0)
-        self.assertRaises(ValueError, win32gui.PyGetString, 1)
-        self.assertRaises(ValueError, win32gui.PyGetString, 1, 1)
-
-
-class TestPyGetMemory(unittest.TestCase):
-    def test_ob(self):
-        # Check the PyGetMemory result and a bytes string can be compared
-        test_data = b"\0\1\2\3\4\5\6"
-        c = array.array("b", test_data)
-        addr, buflen = c.buffer_info()
-        got = win32gui.PyGetMemory(addr, buflen)
-        self.assertEqual(len(got), len(test_data))
-        self.assertEqual(bytes(got), test_data)
-
-    def test_memory_index(self):
-        # Check we can index into the buffer object returned by PyGetMemory
-        test_data = b"\0\1\2\3\4\5\6"
-        c = array.array("b", test_data)
-        addr, buflen = c.buffer_info()
-        got = win32gui.PyGetMemory(addr, buflen)
-        self.assertEqual(got[0], 0)
-
-    def test_memory_slice(self):
-        # Check we can slice the buffer object returned by PyGetMemory
-        test_data = b"\0\1\2\3\4\5\6"
-        c = array.array("b", test_data)
-        addr, buflen = c.buffer_info()
-        got = win32gui.PyGetMemory(addr, buflen)
-        self.assertEqual(list(got[0:3]), [0, 1, 2])
-
-    def test_real_view(self):
-        # Do the PyGetMemory, then change the original memory, then ensure
-        # the initial object we fetched sees the new value.
-        test_data = b"\0\1\2\3\4\5\6"
-        c = array.array("b", test_data)
-        addr, buflen = c.buffer_info()
-        got = win32gui.PyGetMemory(addr, buflen)
-        self.assertEqual(got[0], 0)
-        c[0] = 1
-        self.assertEqual(got[0], 1)
-
-    def test_memory_not_writable(self):
-        # Check the buffer object fetched by PyGetMemory isn't writable.
-        test_data = b"\0\1\2\3\4\5\6"
-        c = array.array("b", test_data)
-        addr, buflen = c.buffer_info()
-        got = win32gui.PyGetMemory(addr, buflen)
-        self.assertRaises(TypeError, operator.setitem, got, 0, 1)
-
-
-if __name__ == "__main__":
-    unittest.main()
diff --git a/lib/win32/test/test_win32guistruct.py b/lib/win32/test/test_win32guistruct.py
deleted file mode 100644
index 063cea3a..00000000
--- a/lib/win32/test/test_win32guistruct.py
+++ /dev/null
@@ -1,330 +0,0 @@
-import array
-import unittest
-
-import pythoncom
-import win32con
-import win32gui
-import win32gui_struct
-
-
-class TestBase(unittest.TestCase):
-    def assertDictEquals(self, d, **kw):
-        checked = dict()
-        for n, v in kw.items():
-            self.assertEqual(v, d[n], "'%s' doesn't match: %r != %r" % (n, v, d[n]))
-            checked[n] = True
-        checked_keys = list(checked.keys())
-        passed_keys = list(kw.keys())
-        checked_keys.sort()
-        passed_keys.sort()
-        self.assertEqual(checked_keys, passed_keys)
-
-
-class TestMenuItemInfo(TestBase):
-    def _testPackUnpack(self, text):
-        vals = dict(
-            fType=win32con.MFT_MENUBARBREAK,
-            fState=win32con.MFS_CHECKED,
-            wID=123,
-            hSubMenu=1234,
-            hbmpChecked=12345,
-            hbmpUnchecked=123456,
-            dwItemData=1234567,
-            text=text,
-            hbmpItem=321,
-        )
-        mii, extras = win32gui_struct.PackMENUITEMINFO(**vals)
-        (
-            fType,
-            fState,
-            wID,
-            hSubMenu,
-            hbmpChecked,
-            hbmpUnchecked,
-            dwItemData,
-            text,
-            hbmpItem,
-        ) = win32gui_struct.UnpackMENUITEMINFO(mii)
-        self.assertDictEquals(
-            vals,
-            fType=fType,
-            fState=fState,
-            wID=wID,
-            hSubMenu=hSubMenu,
-            hbmpChecked=hbmpChecked,
-            hbmpUnchecked=hbmpUnchecked,
-            dwItemData=dwItemData,
-            text=text,
-            hbmpItem=hbmpItem,
-        )
-
-    def testPackUnpack(self):
-        self._testPackUnpack("Hello")
-
-    def testPackUnpackNone(self):
-        self._testPackUnpack(None)
-
-    def testEmptyMenuItemInfo(self):
-        mii, extra = win32gui_struct.EmptyMENUITEMINFO()
-        (
-            fType,
-            fState,
-            wID,
-            hSubMenu,
-            hbmpChecked,
-            hbmpUnchecked,
-            dwItemData,
-            text,
-            hbmpItem,
-        ) = win32gui_struct.UnpackMENUITEMINFO(mii)
-        self.assertEqual(fType, 0)
-        self.assertEqual(fState, 0)
-        self.assertEqual(wID, 0)
-        self.assertEqual(hSubMenu, 0)
-        self.assertEqual(hbmpChecked, 0)
-        self.assertEqual(hbmpUnchecked, 0)
-        self.assertEqual(dwItemData, 0)
-        self.assertEqual(hbmpItem, 0)
-        # it's not clear if UnpackMENUITEMINFO() should ignore cch, instead
-        # assuming it is a buffer size rather than 'current length' - but it
-        # never has (and this gives us every \0 in the string), and actually
-        # helps us test the unicode/str semantics.
-        self.assertEqual(text, "\0" * len(text))
-
-
-class TestMenuInfo(TestBase):
-    def testPackUnpack(self):
-        vals = dict(dwStyle=1, cyMax=2, hbrBack=3, dwContextHelpID=4, dwMenuData=5)
-
-        mi = win32gui_struct.PackMENUINFO(**vals)
-        (
-            dwStyle,
-            cyMax,
-            hbrBack,
-            dwContextHelpID,
-            dwMenuData,
-        ) = win32gui_struct.UnpackMENUINFO(mi)
-
-        self.assertDictEquals(
-            vals,
-            dwStyle=dwStyle,
-            cyMax=cyMax,
-            hbrBack=hbrBack,
-            dwContextHelpID=dwContextHelpID,
-            dwMenuData=dwMenuData,
-        )
-
-    def testEmptyMenuItemInfo(self):
-        mi = win32gui_struct.EmptyMENUINFO()
-        (
-            dwStyle,
-            cyMax,
-            hbrBack,
-            dwContextHelpID,
-            dwMenuData,
-        ) = win32gui_struct.UnpackMENUINFO(mi)
-        self.assertEqual(dwStyle, 0)
-        self.assertEqual(cyMax, 0)
-        self.assertEqual(hbrBack, 0)
-        self.assertEqual(dwContextHelpID, 0)
-        self.assertEqual(dwMenuData, 0)
-
-
-class TestTreeViewItem(TestBase):
-    def _testPackUnpack(self, text):
-        vals = dict(
-            hitem=1,
-            state=2,
-            stateMask=3,
-            text=text,
-            image=4,
-            selimage=5,
-            citems=6,
-            param=7,
-        )
-
-        ti, extra = win32gui_struct.PackTVITEM(**vals)
-        (
-            hitem,
-            state,
-            stateMask,
-            text,
-            image,
-            selimage,
-            citems,
-            param,
-        ) = win32gui_struct.UnpackTVITEM(ti)
-
-        self.assertDictEquals(
-            vals,
-            hitem=hitem,
-            state=state,
-            stateMask=stateMask,
-            text=text,
-            image=image,
-            selimage=selimage,
-            citems=citems,
-            param=param,
-        )
-
-    def testPackUnpack(self):
-        self._testPackUnpack("Hello")
-
-    def testPackUnpackNone(self):
-        self._testPackUnpack(None)
-
-    def testEmpty(self):
-        ti, extras = win32gui_struct.EmptyTVITEM(0)
-        (
-            hitem,
-            state,
-            stateMask,
-            text,
-            image,
-            selimage,
-            citems,
-            param,
-        ) = win32gui_struct.UnpackTVITEM(ti)
-        self.assertEqual(hitem, 0)
-        self.assertEqual(state, 0)
-        self.assertEqual(stateMask, 0)
-        self.assertEqual(text, "")
-        self.assertEqual(image, 0)
-        self.assertEqual(selimage, 0)
-        self.assertEqual(citems, 0)
-        self.assertEqual(param, 0)
-
-
-class TestListViewItem(TestBase):
-    def _testPackUnpack(self, text):
-        vals = dict(
-            item=None,
-            subItem=None,
-            state=1,
-            stateMask=2,
-            text=text,
-            image=3,
-            param=4,
-            indent=5,
-        )
-
-        ti, extra = win32gui_struct.PackLVITEM(**vals)
-        (
-            item,
-            subItem,
-            state,
-            stateMask,
-            text,
-            image,
-            param,
-            indent,
-        ) = win32gui_struct.UnpackLVITEM(ti)
-
-        # patch expected values.
-        vals["item"] = 0
-        vals["subItem"] = 0
-        self.assertDictEquals(
-            vals,
-            item=item,
-            subItem=subItem,
-            state=state,
-            stateMask=stateMask,
-            text=text,
-            image=image,
-            param=param,
-            indent=indent,
-        )
-
-    def testPackUnpack(self):
-        self._testPackUnpack("Hello")
-
-    def testPackUnpackNone(self):
-        self._testPackUnpack(None)
-
-    def testEmpty(self):
-        ti, extras = win32gui_struct.EmptyLVITEM(1, 2)
-        (
-            item,
-            subItem,
-            state,
-            stateMask,
-            text,
-            image,
-            param,
-            indent,
-        ) = win32gui_struct.UnpackLVITEM(ti)
-        self.assertEqual(item, 1)
-        self.assertEqual(subItem, 2)
-        self.assertEqual(state, 0)
-        self.assertEqual(stateMask, 0)
-        self.assertEqual(text, "")
-        self.assertEqual(image, 0)
-        self.assertEqual(param, 0)
-        self.assertEqual(indent, 0)
-
-
-class TestLVColumn(TestBase):
-    def _testPackUnpack(self, text):
-        vals = dict(fmt=1, cx=2, text=text, subItem=3, image=4, order=5)
-
-        ti, extra = win32gui_struct.PackLVCOLUMN(**vals)
-        fmt, cx, text, subItem, image, order = win32gui_struct.UnpackLVCOLUMN(ti)
-
-        self.assertDictEquals(
-            vals, fmt=fmt, cx=cx, text=text, subItem=subItem, image=image, order=order
-        )
-
-    def testPackUnpack(self):
-        self._testPackUnpack("Hello")
-
-    def testPackUnpackNone(self):
-        self._testPackUnpack(None)
-
-    def testEmpty(self):
-        ti, extras = win32gui_struct.EmptyLVCOLUMN()
-        fmt, cx, text, subItem, image, order = win32gui_struct.UnpackLVCOLUMN(ti)
-        self.assertEqual(fmt, 0)
-        self.assertEqual(cx, 0)
-        self.assertEqual(text, "")
-        self.assertEqual(subItem, 0)
-        self.assertEqual(image, 0)
-        self.assertEqual(order, 0)
-
-
-class TestDEV_BROADCAST_HANDLE(TestBase):
-    def testPackUnpack(self):
-        s = win32gui_struct.PackDEV_BROADCAST_HANDLE(123)
-        c = array.array("b", s)
-        got = win32gui_struct.UnpackDEV_BROADCAST(c.buffer_info()[0])
-        self.assertEqual(got.handle, 123)
-
-    def testGUID(self):
-        s = win32gui_struct.PackDEV_BROADCAST_HANDLE(123, guid=pythoncom.IID_IUnknown)
-        c = array.array("b", s)
-        got = win32gui_struct.UnpackDEV_BROADCAST(c.buffer_info()[0])
-        self.assertEqual(got.handle, 123)
-        self.assertEqual(got.eventguid, pythoncom.IID_IUnknown)
-
-
-class TestDEV_BROADCAST_DEVICEINTERFACE(TestBase):
-    def testPackUnpack(self):
-        s = win32gui_struct.PackDEV_BROADCAST_DEVICEINTERFACE(
-            pythoncom.IID_IUnknown, "hello"
-        )
-        c = array.array("b", s)
-        got = win32gui_struct.UnpackDEV_BROADCAST(c.buffer_info()[0])
-        self.assertEqual(got.classguid, pythoncom.IID_IUnknown)
-        self.assertEqual(got.name, "hello")
-
-
-class TestDEV_BROADCAST_VOLUME(TestBase):
-    def testPackUnpack(self):
-        s = win32gui_struct.PackDEV_BROADCAST_VOLUME(123, 456)
-        c = array.array("b", s)
-        got = win32gui_struct.UnpackDEV_BROADCAST(c.buffer_info()[0])
-        self.assertEqual(got.unitmask, 123)
-        self.assertEqual(got.flags, 456)
-
-
-if __name__ == "__main__":
-    unittest.main()
diff --git a/lib/win32/test/test_win32inet.py b/lib/win32/test/test_win32inet.py
deleted file mode 100644
index 044ef8e6..00000000
--- a/lib/win32/test/test_win32inet.py
+++ /dev/null
@@ -1,93 +0,0 @@
-import unittest
-
-import winerror
-from pywin32_testutil import str2bytes  # py3k-friendly helper
-from pywin32_testutil import TestSkipped, testmain
-from win32inet import *
-from win32inetcon import *
-
-
-class CookieTests(unittest.TestCase):
-    def testCookies(self):
-        data = "TestData=Test"
-        InternetSetCookie("http://www.python.org", None, data)
-        got = InternetGetCookie("http://www.python.org", None)
-        # handle that there might already be cookies for the domain.
-        bits = map(lambda x: x.strip(), got.split(";"))
-        self.assertTrue(data in bits)
-
-    def testCookiesEmpty(self):
-        try:
-            InternetGetCookie("http://site-with-no-cookie.python.org", None)
-            self.fail("expected win32 exception")
-        except error as exc:
-            self.assertEqual(exc.winerror, winerror.ERROR_NO_MORE_ITEMS)
-
-
-class UrlTests(unittest.TestCase):
-    def testSimpleCanonicalize(self):
-        ret = InternetCanonicalizeUrl("foo bar")
-        self.assertEqual(ret, "foo%20bar")
-
-    def testLongCanonicalize(self):
-        # a 4k URL causes the underlying API to request a bigger buffer"
-        big = "x" * 2048
-        ret = InternetCanonicalizeUrl(big + " " + big)
-        self.assertEqual(ret, big + "%20" + big)
-
-
-class TestNetwork(unittest.TestCase):
-    def setUp(self):
-        self.hi = InternetOpen("test", INTERNET_OPEN_TYPE_DIRECT, None, None, 0)
-
-    def tearDown(self):
-        self.hi.Close()
-
-    def testPythonDotOrg(self):
-        hdl = InternetOpenUrl(
-            self.hi, "http://www.python.org", None, INTERNET_FLAG_EXISTING_CONNECT
-        )
-        chunks = []
-        while 1:
-            chunk = InternetReadFile(hdl, 1024)
-            if not chunk:
-                break
-            chunks.append(chunk)
-        data = str2bytes("").join(chunks)
-        assert data.find(str2bytes("Python")) > 0, repr(
-            data
-        )  # This must appear somewhere on the main page!
-
-    def testFtpCommand(self):
-        # ftp.python.org doesn't exist.  ftp.gnu.org is what Python's urllib
-        # test code uses.
-        # (As of 2020 it doesn't! Unsurprisingly, it's difficult to find a good
-        # test server. This test sometimes works, but often doesn't - so handle
-        # failure here as a "skip")
-        try:
-            hcon = InternetConnect(
-                self.hi,
-                "ftp.gnu.org",
-                INTERNET_INVALID_PORT_NUMBER,
-                None,
-                None,  # username/password
-                INTERNET_SERVICE_FTP,
-                0,
-                0,
-            )
-            try:
-                hftp = FtpCommand(hcon, True, FTP_TRANSFER_TYPE_ASCII, "NLST", 0)
-                try:
-                    print("Connected - response info is", InternetGetLastResponseInfo())
-                    got = InternetReadFile(hftp, 2048)
-                    print("Read", len(got), "bytes")
-                finally:
-                    hftp.Close()
-            finally:
-                hcon.Close()
-        except error as e:
-            raise TestSkipped(e)
-
-
-if __name__ == "__main__":
-    testmain()
diff --git a/lib/win32/test/test_win32net.py b/lib/win32/test/test_win32net.py
deleted file mode 100644
index 93071963..00000000
--- a/lib/win32/test/test_win32net.py
+++ /dev/null
@@ -1,24 +0,0 @@
-import unittest
-
-import win32net
-import win32netcon
-
-
-class TestCase(unittest.TestCase):
-    def testGroupsGoodResume(self, server=None):
-        res = 0
-        level = 0  # setting it to 1 will provide more detailed info
-        while True:
-            (user_list, total, res) = win32net.NetGroupEnum(server, level, res)
-            for i in user_list:
-                pass
-            if not res:
-                break
-
-    def testGroupsBadResume(self, server=None):
-        res = 1  # Can't pass this first time round.
-        self.assertRaises(win32net.error, win32net.NetGroupEnum, server, 0, res)
-
-
-if __name__ == "__main__":
-    unittest.main()
diff --git a/lib/win32/test/test_win32pipe.py b/lib/win32/test/test_win32pipe.py
deleted file mode 100644
index cbe647dd..00000000
--- a/lib/win32/test/test_win32pipe.py
+++ /dev/null
@@ -1,153 +0,0 @@
-import threading
-import time
-import unittest
-
-import pywintypes
-import win32con
-import win32event
-import win32file
-import win32pipe
-import winerror
-from pywin32_testutil import str2bytes  # py3k-friendly helper
-
-
-class PipeTests(unittest.TestCase):
-    pipename = "\\\\.\\pipe\\python_test_pipe"
-
-    def _serverThread(self, pipe_handle, event, wait_time):
-        # just do one connection and terminate.
-        hr = win32pipe.ConnectNamedPipe(pipe_handle)
-        self.assertTrue(
-            hr in (0, winerror.ERROR_PIPE_CONNECTED), "Got error code 0x%x" % (hr,)
-        )
-        hr, got = win32file.ReadFile(pipe_handle, 100)
-        self.assertEqual(got, str2bytes("foo\0bar"))
-        time.sleep(wait_time)
-        win32file.WriteFile(pipe_handle, str2bytes("bar\0foo"))
-        pipe_handle.Close()
-        event.set()
-
-    def startPipeServer(self, event, wait_time=0):
-        openMode = win32pipe.PIPE_ACCESS_DUPLEX
-        pipeMode = win32pipe.PIPE_TYPE_MESSAGE | win32pipe.PIPE_WAIT
-
-        sa = pywintypes.SECURITY_ATTRIBUTES()
-        sa.SetSecurityDescriptorDacl(1, None, 0)
-
-        pipe_handle = win32pipe.CreateNamedPipe(
-            self.pipename,
-            openMode,
-            pipeMode,
-            win32pipe.PIPE_UNLIMITED_INSTANCES,
-            0,
-            0,
-            2000,
-            sa,
-        )
-
-        threading.Thread(
-            target=self._serverThread, args=(pipe_handle, event, wait_time)
-        ).start()
-
-    def testCallNamedPipe(self):
-        event = threading.Event()
-        self.startPipeServer(event)
-
-        got = win32pipe.CallNamedPipe(
-            self.pipename, str2bytes("foo\0bar"), 1024, win32pipe.NMPWAIT_WAIT_FOREVER
-        )
-        self.assertEqual(got, str2bytes("bar\0foo"))
-        event.wait(5)
-        self.assertTrue(event.isSet(), "Pipe server thread didn't terminate")
-
-    def testTransactNamedPipeBlocking(self):
-        event = threading.Event()
-        self.startPipeServer(event)
-        open_mode = win32con.GENERIC_READ | win32con.GENERIC_WRITE
-
-        hpipe = win32file.CreateFile(
-            self.pipename,
-            open_mode,
-            0,  # no sharing
-            None,  # default security
-            win32con.OPEN_EXISTING,
-            0,  # win32con.FILE_FLAG_OVERLAPPED,
-            None,
-        )
-
-        # set to message mode.
-        win32pipe.SetNamedPipeHandleState(
-            hpipe, win32pipe.PIPE_READMODE_MESSAGE, None, None
-        )
-
-        hr, got = win32pipe.TransactNamedPipe(hpipe, str2bytes("foo\0bar"), 1024, None)
-        self.assertEqual(got, str2bytes("bar\0foo"))
-        event.wait(5)
-        self.assertTrue(event.isSet(), "Pipe server thread didn't terminate")
-
-    def testTransactNamedPipeBlockingBuffer(self):
-        # Like testTransactNamedPipeBlocking, but a pre-allocated buffer is
-        # passed (not really that useful, but it exercises the code path)
-        event = threading.Event()
-        self.startPipeServer(event)
-        open_mode = win32con.GENERIC_READ | win32con.GENERIC_WRITE
-
-        hpipe = win32file.CreateFile(
-            self.pipename,
-            open_mode,
-            0,  # no sharing
-            None,  # default security
-            win32con.OPEN_EXISTING,
-            0,  # win32con.FILE_FLAG_OVERLAPPED,
-            None,
-        )
-
-        # set to message mode.
-        win32pipe.SetNamedPipeHandleState(
-            hpipe, win32pipe.PIPE_READMODE_MESSAGE, None, None
-        )
-
-        buffer = win32file.AllocateReadBuffer(1024)
-        hr, got = win32pipe.TransactNamedPipe(
-            hpipe, str2bytes("foo\0bar"), buffer, None
-        )
-        self.assertEqual(got, str2bytes("bar\0foo"))
-        event.wait(5)
-        self.assertTrue(event.isSet(), "Pipe server thread didn't terminate")
-
-    def testTransactNamedPipeAsync(self):
-        event = threading.Event()
-        overlapped = pywintypes.OVERLAPPED()
-        overlapped.hEvent = win32event.CreateEvent(None, 0, 0, None)
-        self.startPipeServer(event, 0.5)
-        open_mode = win32con.GENERIC_READ | win32con.GENERIC_WRITE
-
-        hpipe = win32file.CreateFile(
-            self.pipename,
-            open_mode,
-            0,  # no sharing
-            None,  # default security
-            win32con.OPEN_EXISTING,
-            win32con.FILE_FLAG_OVERLAPPED,
-            None,
-        )
-
-        # set to message mode.
-        win32pipe.SetNamedPipeHandleState(
-            hpipe, win32pipe.PIPE_READMODE_MESSAGE, None, None
-        )
-
-        buffer = win32file.AllocateReadBuffer(1024)
-        hr, got = win32pipe.TransactNamedPipe(
-            hpipe, str2bytes("foo\0bar"), buffer, overlapped
-        )
-        self.assertEqual(hr, winerror.ERROR_IO_PENDING)
-        nbytes = win32file.GetOverlappedResult(hpipe, overlapped, True)
-        got = buffer[:nbytes]
-        self.assertEqual(got, str2bytes("bar\0foo"))
-        event.wait(5)
-        self.assertTrue(event.isSet(), "Pipe server thread didn't terminate")
-
-
-if __name__ == "__main__":
-    unittest.main()
diff --git a/lib/win32/test/test_win32print.py b/lib/win32/test/test_win32print.py
deleted file mode 100644
index 71fd2c03..00000000
--- a/lib/win32/test/test_win32print.py
+++ /dev/null
@@ -1,24 +0,0 @@
-# Tests (scarce) for win32print module
-
-import unittest
-
-import win32print as wprn
-
-
-class Win32PrintTestCase(unittest.TestCase):
-    def setUp(self):
-        self.printer_idx = 0
-        self.printer_levels_all = list(range(1, 10))
-        self.local_printers = wprn.EnumPrinters(wprn.PRINTER_ENUM_LOCAL, None, 1)
-
-    def test_printer_levels_read_dummy(self):
-        if not self.local_printers:
-            print("Test didn't run (no local printers)!")
-            return
-        ph = wprn.OpenPrinter(self.local_printers[self.printer_idx][2])
-        for level in self.printer_levels_all:
-            wprn.GetPrinter(ph, level)
-
-
-if __name__ == "__main__":
-    unittest.main()
diff --git a/lib/win32/test/test_win32profile.py b/lib/win32/test/test_win32profile.py
deleted file mode 100644
index 84dc83bc..00000000
--- a/lib/win32/test/test_win32profile.py
+++ /dev/null
@@ -1,18 +0,0 @@
-"""Test win32profile"""
-import os
-import unittest
-
-import win32profile
-
-
-class Tester(unittest.TestCase):
-    def test_environment(self):
-        os.environ["FOO"] = "bar=baz"
-        env = win32profile.GetEnvironmentStrings()
-        assert "FOO" in env
-        assert env["FOO"] == "bar=baz"
-        assert os.environ["FOO"] == "bar=baz"
-
-
-if __name__ == "__main__":
-    unittest.main()
diff --git a/lib/win32/test/test_win32rcparser.py b/lib/win32/test/test_win32rcparser.py
deleted file mode 100644
index 6eae6884..00000000
--- a/lib/win32/test/test_win32rcparser.py
+++ /dev/null
@@ -1,70 +0,0 @@
-import os
-import tempfile
-import unittest
-
-import win32con
-import win32rcparser
-
-
-class TestParser(unittest.TestCase):
-    def setUp(self):
-        rc_file = os.path.join(os.path.dirname(__file__), "win32rcparser", "test.rc")
-        self.resources = win32rcparser.Parse(rc_file)
-
-    def testStrings(self):
-        for sid, expected in (
-            ("IDS_TEST_STRING4", "Test 'single quoted' string"),
-            ("IDS_TEST_STRING1", 'Test "quoted" string'),
-            ("IDS_TEST_STRING3", 'String with single " quote'),
-            ("IDS_TEST_STRING2", "Test string"),
-        ):
-            got = self.resources.stringTable[sid].value
-            self.assertEqual(got, expected)
-
-    def testStandardIds(self):
-        for idc in "IDOK IDCANCEL".split():
-            correct = getattr(win32con, idc)
-            self.assertEqual(self.resources.names[correct], idc)
-            self.assertEqual(self.resources.ids[idc], correct)
-
-    def testTabStop(self):
-        d = self.resources.dialogs["IDD_TEST_DIALOG2"]
-        tabstop_names = ["IDC_EDIT1", "IDOK"]  # should have WS_TABSTOP
-        tabstop_ids = [self.resources.ids[name] for name in tabstop_names]
-        notabstop_names = ["IDC_EDIT2"]  # should have WS_TABSTOP
-        notabstop_ids = [self.resources.ids[name] for name in notabstop_names]
-        num_ok = 0
-        for cdef in d[1:]:  # skip dlgdef
-            # print cdef
-            cid = cdef[2]
-            style = cdef[-2]
-            styleex = cdef[-1]
-            if cid in tabstop_ids:
-                self.assertEqual(style & win32con.WS_TABSTOP, win32con.WS_TABSTOP)
-                num_ok += 1
-            elif cid in notabstop_ids:
-                self.assertEqual(style & win32con.WS_TABSTOP, 0)
-                num_ok += 1
-        self.assertEqual(num_ok, len(tabstop_ids) + len(notabstop_ids))
-
-
-class TestGenerated(TestParser):
-    def setUp(self):
-        # don't call base!
-        rc_file = os.path.join(os.path.dirname(__file__), "win32rcparser", "test.rc")
-        py_file = tempfile.mktemp("test_win32rcparser.py")
-        try:
-            win32rcparser.GenerateFrozenResource(rc_file, py_file)
-            py_source = open(py_file).read()
-        finally:
-            if os.path.isfile(py_file):
-                os.unlink(py_file)
-
-        # poor-man's import :)
-        globs = {}
-        exec(py_source, globs, globs)
-        self.resources = globs["FakeParser"]()
-
-
-if __name__ == "__main__":
-    unittest.main()
diff --git a/lib/win32/test/test_win32timezone.py b/lib/win32/test/test_win32timezone.py
deleted file mode 100644
index 6dba51ed..00000000
--- a/lib/win32/test/test_win32timezone.py
+++ /dev/null
@@ -1,27 +0,0 @@
-# Test module for win32timezone
-
-import doctest
-import sys
-import unittest
-
-import win32timezone
-
-
-class Win32TimeZoneTest(unittest.TestCase):
-    def testWin32TZ(self):
-        # On 3.7 and later, the repr() for datetime objects changed to use kwargs - eg,
-        # eg, `datetime.timedelta(0, 10800)` is now `datetime.timedelta(seconds=10800)`.
-        # So we just skip the tests on 3.5 and 3.6
-        if sys.version_info < (3, 7):
-            from pywin32_testutil import TestSkipped
-
-            raise TestSkipped(
-                "The repr() for datetime objects makes this test fail in 3.5 and 3.6"
-            )
-
-        failed, total = doctest.testmod(win32timezone, verbose=False)
-        self.assertFalse(failed)
-
-
-if __name__ == "__main__":
-    unittest.main()
diff --git a/lib/win32/test/test_win32trace.py b/lib/win32/test/test_win32trace.py
deleted file mode 100644
index 8b241cbb..00000000
--- a/lib/win32/test/test_win32trace.py
+++ /dev/null
@@ -1,369 +0,0 @@
-import os
-import sys
-import threading
-import time
-import unittest
-
-import win32trace
-from pywin32_testutil import TestSkipped
-
-if __name__ == "__main__":
-    this_file = sys.argv[0]
-else:
-    this_file = __file__
-
-
-def SkipIfCI():
-    # This test often fails in CI, probably when it is being run multiple times
-    # (ie, for different Python versions)
-    # Github actions always have a `CI` variable.
-    if "CI" in os.environ:
-        raise TestSkipped("We skip this test on CI")
-
-
-def CheckNoOtherReaders():
-    win32trace.write("Hi")
-    time.sleep(0.05)
-    if win32trace.read() != "Hi":
-        # Reset everything so following tests still fail with this error!
-        win32trace.TermRead()
-        win32trace.TermWrite()
-        raise RuntimeError(
-            "An existing win32trace reader appears to be "
-            "running - please stop this process and try again"
-        )
-
-
-class TestInitOps(unittest.TestCase):
-    def setUp(self):
-        SkipIfCI()
-        # clear old data
-        win32trace.InitRead()
-        win32trace.read()
-        win32trace.TermRead()
-
-    def tearDown(self):
-        try:
-            win32trace.TermRead()
-        except win32trace.error:
-            pass
-        try:
-            win32trace.TermWrite()
-        except win32trace.error:
-            pass
-
-    def testInitTermRead(self):
-        self.assertRaises(win32trace.error, win32trace.read)
-        win32trace.InitRead()
-        result = win32trace.read()
-        self.assertEqual(result, "")
-        win32trace.TermRead()
-        self.assertRaises(win32trace.error, win32trace.read)
-
-        win32trace.InitRead()
-        self.assertRaises(win32trace.error, win32trace.InitRead)
-        win32trace.InitWrite()
-        self.assertRaises(win32trace.error, win32trace.InitWrite)
-        win32trace.TermWrite()
-        win32trace.TermRead()
-
-    def testInitTermWrite(self):
-        self.assertRaises(win32trace.error, win32trace.write, "Hei")
-        win32trace.InitWrite()
-        win32trace.write("Johan Galtung")
-        win32trace.TermWrite()
-        self.assertRaises(win32trace.error, win32trace.write, "Hei")
-
-    def testTermSematics(self):
-        win32trace.InitWrite()
-        win32trace.write("Ta da")
-
-        # if we both Write and Read are terminated at the same time,
-        # we lose the data as the win32 object is closed.  Note that
-        # if another writer is running, we do *not* lose the data - so
-        # test for either the correct data or an empty string
-        win32trace.TermWrite()
-        win32trace.InitRead()
-        self.assertTrue(win32trace.read() in ("Ta da", ""))
-        win32trace.TermRead()
-
-        # we keep the data because we init read before terminating write
-        win32trace.InitWrite()
-        win32trace.write("Ta da")
-        win32trace.InitRead()
-        win32trace.TermWrite()
-        self.assertEqual("Ta da", win32trace.read())
-        win32trace.TermRead()
-
-
-class BasicSetupTearDown(unittest.TestCase):
-    def setUp(self):
-        SkipIfCI()
-        win32trace.InitRead()
-        # If any other writers are running (even if not actively writing),
-        # terminating the module will *not* close the handle, meaning old data
-        # will remain. This can cause other tests to fail.
-        win32trace.read()
-        win32trace.InitWrite()
-
-    def tearDown(self):
-        win32trace.TermWrite()
-        win32trace.TermRead()
-
-
-class TestModuleOps(BasicSetupTearDown):
-    def testRoundTrip(self):
-        win32trace.write("Syver Enstad")
-        syverEnstad = win32trace.read()
-        self.assertEqual("Syver Enstad", syverEnstad)
-
-    def testRoundTripUnicode(self):
-        win32trace.write("\xa9opyright Syver Enstad")
-        syverEnstad = win32trace.read()
-        # str objects are always returned in py2k (latin-1 encoding was used
-        # on unicode objects)
-        self.assertEqual("\xa9opyright Syver Enstad", syverEnstad)
-
-    def testBlockingRead(self):
-        win32trace.write("Syver Enstad")
-        self.assertEqual("Syver Enstad", win32trace.blockingread())
-
-    def testBlockingReadUnicode(self):
-        win32trace.write("\xa9opyright Syver Enstad")
-        # str objects are always returned in py2k (latin-1 encoding was used
-        # on unicode objects)
-        self.assertEqual("\xa9opyright Syver Enstad", win32trace.blockingread())
-
-    def testFlush(self):
-        win32trace.flush()
-
-
-class TestTraceObjectOps(BasicSetupTearDown):
-    def testInit(self):
-        win32trace.TermRead()
-        win32trace.TermWrite()
-        traceObject = win32trace.GetTracer()
-        self.assertRaises(win32trace.error, traceObject.read)
-        self.assertRaises(win32trace.error, traceObject.write, "")
-        win32trace.InitRead()
-        win32trace.InitWrite()
-        self.assertEqual("", traceObject.read())
-        traceObject.write("Syver")
-
-    def testFlush(self):
-        traceObject = win32trace.GetTracer()
-        traceObject.flush()
-
-    def testIsatty(self):
-        tracer = win32trace.GetTracer()
-        assert tracer.isatty() == False
-
-    def testRoundTrip(self):
-        traceObject = win32trace.GetTracer()
-        traceObject.write("Syver Enstad")
-        self.assertEqual("Syver Enstad", traceObject.read())
-
-
-class WriterThread(threading.Thread):
-    def run(self):
-        self.writeCount = 0
-        for each in range(self.BucketCount):
-            win32trace.write(str(each))
-        self.writeCount = self.BucketCount
-
-    def verifyWritten(self):
-        return self.writeCount == self.BucketCount
-
-
-class TestMultipleThreadsWriting(unittest.TestCase):
-    # FullBucket is the thread count
-    FullBucket = 50
-    BucketCount = 9  # buckets must be a single digit number (ie. less than 10)
-
-    def setUp(self):
-        SkipIfCI()
-        WriterThread.BucketCount = self.BucketCount
-        win32trace.InitRead()
-        win32trace.read()  # clear any old data.
-        win32trace.InitWrite()
-        CheckNoOtherReaders()
-        self.threads = [WriterThread() for each in range(self.FullBucket)]
-        self.buckets = list(range(self.BucketCount))
-        for each in self.buckets:
-            self.buckets[each] = 0
-
-    def tearDown(self):
-        win32trace.TermRead()
-        win32trace.TermWrite()
-
-    def areBucketsFull(self):
-        bucketsAreFull = True
-        for each in self.buckets:
-            assert each <= self.FullBucket, each
-            if each != self.FullBucket:
-                bucketsAreFull = False
-                break
-        return bucketsAreFull
-
-    def read(self):
-        while 1:
-            readString = win32trace.blockingread()
-            for ch in readString:
-                integer = int(ch)
-                count = self.buckets[integer]
-                assert count != -1
-                self.buckets[integer] = count + 1
-                if self.buckets[integer] == self.FullBucket:
-                    if self.areBucketsFull():
-                        return
-
-    def testThreads(self):
-        for each in self.threads:
-            each.start()
-        self.read()
-        for each in self.threads:
-            each.join()
-        for each in self.threads:
-            assert each.verifyWritten()
-        assert self.areBucketsFull()
-
-
-class TestHugeChunks(unittest.TestCase):
-    # BiggestChunk is the size where we stop stressing the writer
-    BiggestChunk = 2**16  # 256k should do it.
-
-    def setUp(self):
-        SkipIfCI()
-        win32trace.InitRead()
-        win32trace.read()  # clear any old data
-        win32trace.InitWrite()
-
-    def testHugeChunks(self):
-        data = "*" * 1023 + "\n"
-        while len(data) <= self.BiggestChunk:
-            win32trace.write(data)
-            data = data + data
-        # If we made it here, we passed.
-
-    def tearDown(self):
-        win32trace.TermRead()
-        win32trace.TermWrite()
-
-
-import win32event
-import win32process
-
-
-class TraceWriteProcess:
-    def __init__(self, threadCount):
-        self.exitCode = -1
-        self.threadCount = threadCount
-
-    def start(self):
-        procHandle, threadHandle, procId, threadId = win32process.CreateProcess(
-            None,  # appName
-            'python.exe "%s" /run_test_process %s %s'
-            % (this_file, self.BucketCount, self.threadCount),
-            None,  # process security
-            None,  # thread security
-            0,  # inherit handles
-            win32process.NORMAL_PRIORITY_CLASS,
-            None,  # new environment
-            None,  # Current directory
-            win32process.STARTUPINFO(),  # startup info
-        )
-        self.processHandle = procHandle
-
-    def join(self):
-        win32event.WaitForSingleObject(self.processHandle, win32event.INFINITE)
-        self.exitCode = win32process.GetExitCodeProcess(self.processHandle)
-
-    def verifyWritten(self):
-        return self.exitCode == 0
-
-
-class TestOutofProcess(unittest.TestCase):
-    BucketCount = 9
-    FullBucket = 50
-
-    def setUp(self):
-        SkipIfCI()
-        win32trace.InitRead()
-        TraceWriteProcess.BucketCount = self.BucketCount
-        self.setUpWriters()
-        self.buckets = list(range(self.BucketCount))
-        for each in self.buckets:
-            self.buckets[each] = 0
-
-    def tearDown(self):
-        win32trace.TermRead()
-
-    def setUpWriters(self):
-        self.processes = []
-        # 5 processes, quot threads in each process
-        quot, remainder = divmod(self.FullBucket, 5)
-        for each in range(5):
-            self.processes.append(TraceWriteProcess(quot))
-        if remainder:
-            self.processes.append(TraceWriteProcess(remainder))
-
-    def areBucketsFull(self):
-        bucketsAreFull = True
-        for each in self.buckets:
-            assert each <= self.FullBucket, each
-            if each != self.FullBucket:
-                bucketsAreFull = False
-                break
-        return bucketsAreFull
-
-    def read(self):
-        while 1:
-            readString = win32trace.blockingread()
-            for ch in readString:
-                integer = int(ch)
-                count = self.buckets[integer]
-                assert count != -1
-                self.buckets[integer] = count + 1
-                if self.buckets[integer] == self.FullBucket:
-                    if self.areBucketsFull():
-                        return
-
-    def testProcesses(self):
-        for each in self.processes:
-            each.start()
-        self.read()
-        for each in self.processes:
-            each.join()
-        for each in self.processes:
-            assert each.verifyWritten()
-        assert self.areBucketsFull()
-
-
-def _RunAsTestProcess():
-    # Run as an external process by the main tests.
-    WriterThread.BucketCount = int(sys.argv[2])
-    threadCount = int(sys.argv[3])
-    threads = [WriterThread() for each in range(threadCount)]
-    win32trace.InitWrite()
-    for t in threads:
-        t.start()
-    for t in threads:
-        t.join()
-    for t in threads:
-        if not t.verifyWritten():
-            sys.exit(-1)
-
-
-if __name__ == "__main__":
-    if sys.argv[1:2] == ["/run_test_process"]:
-        _RunAsTestProcess()
-        sys.exit(0)
-    # If some other win32traceutil reader is running, these tests fail
-    # badly (as the other reader sometimes sees the output!)
-    win32trace.InitRead()
-    win32trace.InitWrite()
-    CheckNoOtherReaders()
-    # reset state so test env is back to normal
-    win32trace.TermRead()
-    win32trace.TermWrite()
-    unittest.main()
diff --git a/lib/win32/test/test_win32wnet.py b/lib/win32/test/test_win32wnet.py
deleted file mode 100644
index 04ad8a4d..00000000
--- a/lib/win32/test/test_win32wnet.py
+++ /dev/null
@@ -1,175 +0,0 @@
-import unittest
-
-import netbios
-import win32api
-import win32wnet
-from pywin32_testutil import str2bytes
-
-RESOURCE_CONNECTED = 0x00000001
-RESOURCE_GLOBALNET = 0x00000002
-RESOURCE_REMEMBERED = 0x00000003
-RESOURCE_RECENT = 0x00000004
-RESOURCE_CONTEXT = 0x00000005
-RESOURCETYPE_ANY = 0x00000000
-RESOURCETYPE_DISK = 0x00000001
-RESOURCETYPE_PRINT = 0x00000002
-RESOURCETYPE_RESERVED = 0x00000008
-RESOURCETYPE_UNKNOWN = 0xFFFFFFFF
-RESOURCEUSAGE_CONNECTABLE = 0x00000001
-RESOURCEUSAGE_CONTAINER = 0x00000002
-RESOURCEDISPLAYTYPE_GENERIC = 0x00000000
-RESOURCEDISPLAYTYPE_DOMAIN = 0x00000001
-RESOURCEDISPLAYTYPE_SERVER = 0x00000002
-RESOURCEDISPLAYTYPE_SHARE = 0x00000003
-
-
-NETRESOURCE_attributes = [
-    ("dwScope", int),
-    ("dwType", int),
-    ("dwDisplayType", int),
-    ("dwUsage", int),
-    ("lpLocalName", str),
-    ("lpRemoteName", str),
-    ("lpComment", str),
-    ("lpProvider", str),
-]
-
-NCB_attributes = [
-    ("Command", int),
-    ("Retcode", int),
-    ("Lsn", int),
-    ("Num", int),
-    #    ("Bufflen", int), - read-only
-    ("Callname", str),
-    ("Name", str),
-    ("Rto", int),
-    ("Sto", int),
-    ("Lana_num", int),
-    ("Cmd_cplt", int),
-    ("Event", int),
-    ("Post", int),
-]
-
-
-class TestCase(unittest.TestCase):
-    def testGetUser(self):
-        self.assertEqual(win32api.GetUserName(), win32wnet.WNetGetUser())
-
-    def _checkItemAttributes(self, item, attrs):
-        for attr, typ in attrs:
-            val = getattr(item, attr)
-            if typ is int:
-                self.assertTrue(
-                    type(val) in (int,), "Attr %r has value %r" % (attr, val)
-                )
-                new_val = val + 1
-            elif typ is str:
-                if val is not None:
-                    # on py2k, must be string or unicode.  py3k must be string or bytes.
-                    self.assertTrue(
-                        type(val) in (str, str), "Attr %r has value %r" % (attr, val)
-                    )
-                    new_val = val + " new value"
-                else:
-                    new_val = "new value"
-            else:
-                self.fail("Don't know what %s is" % (typ,))
-            # set the attribute just to make sure we can.
-            setattr(item, attr, new_val)
-
-    def testNETRESOURCE(self):
-        nr = win32wnet.NETRESOURCE()
-        self._checkItemAttributes(nr, NETRESOURCE_attributes)
-
-    def testWNetEnumResource(self):
-        handle = win32wnet.WNetOpenEnum(RESOURCE_GLOBALNET, RESOURCETYPE_ANY, 0, None)
-        try:
-            while 1:
-                items = win32wnet.WNetEnumResource(handle, 0)
-                if len(items) == 0:
-                    break
-                for item in items:
-                    self._checkItemAttributes(item, NETRESOURCE_attributes)
-        finally:
-            handle.Close()
-
-    def testNCB(self):
-        ncb = win32wnet.NCB()
-        self._checkItemAttributes(ncb, NCB_attributes)
-
-    def testNetbios(self):
-        # taken from the demo code in netbios.py
-        ncb = win32wnet.NCB()
-        ncb.Command = netbios.NCBENUM
-        la_enum = netbios.LANA_ENUM()
-        ncb.Buffer = la_enum
-        rc = win32wnet.Netbios(ncb)
-        self.assertEqual(rc, 0)
-        for i in range(la_enum.length):
-            ncb.Reset()
-            ncb.Command = netbios.NCBRESET
-            ncb.Lana_num = netbios.byte_to_int(la_enum.lana[i])
-            rc = Netbios(ncb)
-            self.assertEqual(rc, 0)
-            ncb.Reset()
-            ncb.Command = netbios.NCBASTAT
-            ncb.Lana_num = byte_to_int(la_enum.lana[i])
-            ncb.Callname = str2bytes("*               ")  # ensure bytes on py2x and 3k
-            adapter = netbios.ADAPTER_STATUS()
-            ncb.Buffer = adapter
-            Netbios(ncb)
-            # expect 6 bytes in the mac address.
-            self.assertTrue(len(adapter.adapter_address), 6)
-
-    def iterConnectableShares(self):
-        nr = win32wnet.NETRESOURCE()
-        nr.dwScope = RESOURCE_GLOBALNET
-        nr.dwUsage = RESOURCEUSAGE_CONTAINER
-        nr.lpRemoteName = "\\\\" + win32api.GetComputerName()
-
-        handle = win32wnet.WNetOpenEnum(RESOURCE_GLOBALNET, RESOURCETYPE_ANY, 0, nr)
-        while 1:
-            items = win32wnet.WNetEnumResource(handle, 0)
-            if len(items) == 0:
-                break
-            for item in items:
-                if item.dwDisplayType == RESOURCEDISPLAYTYPE_SHARE:
-                    yield item
-
-    def findUnusedDriveLetter(self):
-        existing = [
-            x[0].lower() for x in win32api.GetLogicalDriveStrings().split("\0") if x
-        ]
-        handle = win32wnet.WNetOpenEnum(RESOURCE_REMEMBERED, RESOURCETYPE_DISK, 0, None)
-        try:
-            while 1:
-                items = win32wnet.WNetEnumResource(handle, 0)
-                if len(items) == 0:
-                    break
-                xtra = [i.lpLocalName[0].lower() for i in items if i.lpLocalName]
-                existing.extend(xtra)
-        finally:
-            handle.Close()
-        for maybe in "defghijklmnopqrstuvwxyz":
-            if maybe not in existing:
-                return maybe
-        self.fail("All drive mappings are taken?")
-
-    def testAddConnection(self):
-        localName = self.findUnusedDriveLetter() + ":"
-        for share in self.iterConnectableShares():
-            share.lpLocalName = localName
-            win32wnet.WNetAddConnection2(share)
-            win32wnet.WNetCancelConnection2(localName, 0, 0)
-            break
-
-    def testAddConnectionOld(self):
-        localName = self.findUnusedDriveLetter() + ":"
-        for share in self.iterConnectableShares():
-            win32wnet.WNetAddConnection2(share.dwType, localName, share.lpRemoteName)
-            win32wnet.WNetCancelConnection2(localName, 0, 0)
-            break
-
-
-if __name__ == "__main__":
-    unittest.main()
diff --git a/lib/win32/test/testall.py b/lib/win32/test/testall.py
deleted file mode 100644
index d3df2630..00000000
--- a/lib/win32/test/testall.py
+++ /dev/null
@@ -1,230 +0,0 @@
-import os
-import re
-import sys
-import traceback
-import unittest
-
-import pywin32_testutil
-
-# A list of demos that depend on user-interface of *any* kind.  Tests listed
-# here are not suitable for unattended testing.
-ui_demos = """GetSaveFileName print_desktop win32cred_demo win32gui_demo
-              win32gui_dialog win32gui_menu win32gui_taskbar
-              win32rcparser_demo winprocess win32console_demo
-              win32clipboard_bitmapdemo
-              win32gui_devicenotify
-              NetValidatePasswordPolicy""".split()
-# Other demos known as 'bad' (or at least highly unlikely to work)
-# cerapi: no CE module is built (CE via pywin32 appears dead)
-# desktopmanager: hangs (well, hangs for 60secs or so...)
-# EvtSubscribe_*: must be run together:
-# SystemParametersInfo: a couple of the params cause markh to hang, and there's
-# no great reason to adjust (twice!) all those system settings!
-bad_demos = """cerapi desktopmanager win32comport_demo
-               EvtSubscribe_pull EvtSubscribe_push
-               SystemParametersInfo
-            """.split()
-
-argvs = {
-    "rastest": ("-l",),
-}
-
-no_user_interaction = True
-
-# re to pull apart an exception line into the exception type and the args.
-re_exception = re.compile("([a-zA-Z0-9_.]*): (.*)$")
-
-
-def find_exception_in_output(data):
-    have_traceback = False
-    for line in data.splitlines():
-        line = line.decode("ascii")  # not sure what the correct encoding is...
-        if line.startswith("Traceback ("):
-            have_traceback = True
-            continue
-        if line.startswith(" "):
-            continue
-        if have_traceback:
-            # first line not starting with a space since the traceback.
-            # must be the exception!
-            m = re_exception.match(line)
-            if m:
-                exc_type, args = m.groups()
-                # get hacky - get the *real* exception object from the name.
-                bits = exc_type.split(".", 1)
-                if len(bits) > 1:
-                    mod = __import__(bits[0])
-                    exc = getattr(mod, bits[1])
-                else:
-                    # probably builtin
-                    exc = eval(bits[0])
-            else:
-                # hrm - probably just an exception with no args
-                try:
-                    exc = eval(line.strip())
-                    args = "()"
-                except:
-                    return None
-            # try and turn the args into real args.
-            try:
-                args = eval(args)
-            except:
-                pass
-            if not isinstance(args, tuple):
-                args = (args,)
-            # try and instantiate the exception.
-            try:
-                ret = exc(*args)
-            except:
-                ret = None
-            return ret
-        # apparently not - keep looking...
-        have_traceback = False
-
-
-class TestRunner:
-    def __init__(self, argv):
-        self.argv = argv
-        self.__name__ = "Test Runner for cmdline {}".format(argv)
-
-    def __call__(self):
-        import subprocess
-
-        p = subprocess.Popen(
-            self.argv, stdout=subprocess.PIPE, stderr=subprocess.STDOUT
-        )
-        output, _ = p.communicate()
-        rc = p.returncode
-
-        if rc:
-            base = os.path.basename(self.argv[1])
-            # See if we can detect and reconstruct an exception in the output.
-            reconstituted = find_exception_in_output(output)
-            if reconstituted is not None:
-                raise reconstituted
-            raise AssertionError(
-                "%s failed with exit code %s.  Output is:\n%s" % (base, rc, output)
-            )
-
-
-def get_demo_tests():
-    import win32api
-
-    ret = []
-    demo_dir = os.path.abspath(os.path.join(os.path.dirname(__file__), "..", "Demos"))
-    assert os.path.isdir(demo_dir), demo_dir
-    for name in os.listdir(demo_dir):
-        base, ext = os.path.splitext(name)
-        if base in ui_demos and no_user_interaction:
-            continue
-        # Skip any other files than .py and bad tests in any case
-        if ext != ".py" or base in bad_demos:
-            continue
-        argv = (sys.executable, os.path.join(demo_dir, base + ".py")) + argvs.get(
-            base, ()
-        )
-        ret.append(
-            unittest.FunctionTestCase(
-                TestRunner(argv), description="win32/demos/" + name
-            )
-        )
-    return ret
-
-
-def import_all():
-    # Some hacks for import order - dde depends on win32ui
-    try:
-        import win32ui
-    except ImportError:
-        pass  # 'what-ev-a....'
-
-    import win32api
-
-    dir = os.path.dirname(win32api.__file__)
-    num = 0
-    is_debug = os.path.basename(win32api.__file__).endswith("_d")
-    for name in os.listdir(dir):
-        base, ext = os.path.splitext(name)
-        # handle `modname.cp310-win_amd64.pyd` etc
-        base = base.split(".")[0]
-        if (
-            (ext == ".pyd")
-            and name != "_winxptheme.pyd"
-            and (
-                is_debug
-                and base.endswith("_d")
-                or not is_debug
-                and not base.endswith("_d")
-            )
-        ):
-            try:
-                __import__(base)
-            except:
-                print("FAILED to import", name)
-                raise
-            num += 1
-
-
-def suite():
-    # Loop over all .py files here, except me :)
-    try:
-        me = __file__
-    except NameError:
-        me = sys.argv[0]
-    me = os.path.abspath(me)
-    files = os.listdir(os.path.dirname(me))
-    suite = unittest.TestSuite()
-    suite.addTest(unittest.FunctionTestCase(import_all))
-    for file in files:
-        base, ext = os.path.splitext(file)
-        if ext == ".py" and os.path.basename(me) != file:
-            try:
-                mod = __import__(base)
-            except:
-                print("FAILED to import test module %r" % base)
-                traceback.print_exc()
-                continue
-            if hasattr(mod, "suite"):
-                test = mod.suite()
-            else:
-                test = unittest.defaultTestLoader.loadTestsFromModule(mod)
-            suite.addTest(test)
-    for test in get_demo_tests():
-        suite.addTest(test)
-    return suite
-
-
-class CustomLoader(pywin32_testutil.TestLoader):
-    def loadTestsFromModule(self, module):
-        return self.fixupTestsForLeakTests(suite())
-
-
-if __name__ == "__main__":
-    import argparse
-
-    parser = argparse.ArgumentParser(description="Test runner for PyWin32/win32")
-    parser.add_argument(
-        "-no-user-interaction",
-        default=False,
-        action="store_true",
-        help="(This is now the default - use `-user-interaction` to include them)",
-    )
-
-    parser.add_argument(
-        "-user-interaction",
-        action="store_true",
-        help="Include tests which require user interaction",
-    )
-
-    parsed_args, remains = parser.parse_known_args()
-
-    if parsed_args.no_user_interaction:
-        print(
-            "Note: -no-user-interaction is now the default, run with `-user-interaction` to include them."
-        )
-
-    no_user_interaction = not parsed_args.user_interaction
-
-    sys.argv = [sys.argv[0]] + remains
-
-    pywin32_testutil.testmain(testLoader=CustomLoader())
diff --git a/lib/win32/test/win32rcparser/python.bmp b/lib/win32/test/win32rcparser/python.bmp
deleted file mode 100644
index f674769727da6c39c007001d43f89e1b5ca88f89..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 778
zcmaKqJ5B>J5QYa#6Q}SQ=qN3@b4ky2sP_mdXhIW9?tFz%>;X8;v{dGw8Sg_YgyZMu
ze>{)P>zj9^?H%(A#`72t^rZabQI|iai3pvh$rjAm(mc;t<)Uk+-ere@pCCCO8q2+0
zP*`sU<5o++Uin}ywN`v<3XO4VH6`>EIP{g_EG_!7u#^qSEbrnC*g}G{!-&I&2Lp(l
zqFa~~2N5w+U}Lw=DzvakY;QNbnB+wZS=i47evk=VZh2fK0f%sgP+~cKW<b9PH5R&3
zZh;|GV`HZa<svVtu`sT+lFx(~SB4t30^wfgp+ohuACARV60eO~*)xZdRM_wQica93
zv9gp=t1UND7*pKki?16=%eUz|-_Lhv9~V?}>-=^8c4qiL6WgN>*^DBuwjG&RY~t8_
JbPk9A+AsNib7BAh

diff --git a/lib/win32/test/win32rcparser/python.ico b/lib/win32/test/win32rcparser/python.ico
deleted file mode 100644
index f714eea446e4b6bd28f9e0f1c8f75f6c81fba9c6..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 766
zcmaJ<J5Izf5Pe=FBD_dYA-YXTX~|tGI*vifH7s#~ZJ~<f&R19pAAmC;N=nKtq8;AE
z3Cf}slRSIgn~yzF0K=zkuc7v}0&ck95iM~~7@TnhB4ej5GRR1bb>m8xh$y8nAma-W
z^$0#H>2kty>X)hwIrlE-S<5+vz&A`n&h*v18|y+>sjix$aZle8p4@4^r5n6eZnc>@
zG>`3+P&u~b2-=|v7s{bGs2nePG0P+8gx8LOTO>dQCQJqF(DmA(7NnHmI`9r7=bX7`
z!W?&ubNbFr2j~zfBlk1694)bC>aTGXW{#1EPUo#Q3jUW;)Gsjwb=$3Xc0uvBe*c&M
z&1daA>)3`jT()1f=0DJg9L%!}boam$VF^QEz=~*YKd>1d<JBR4Hd4Hma%rTT6Dvs6
a-{}a3+)!s88u`YCeMR=>7=z`x4<bL`9-Qj{

diff --git a/lib/win32/test/win32rcparser/test.h b/lib/win32/test/win32rcparser/test.h
deleted file mode 100644
index 0d19cefe..00000000
--- a/lib/win32/test/win32rcparser/test.h
+++ /dev/null
@@ -1,46 +0,0 @@
-//{{NO_DEPENDENCIES}}
-// Microsoft Developer Studio generated include file.
-// Used by test.rc
-//
-#define IDS_TEST_STRING1 51
-#define IDS_TEST_STRING2 52
-#define IDS_TEST_STRING3 53
-#define IDS_TEST_STRING4 54
-#define IDS_TEST_STRING5 55
-#define IDS_TEST_STRING6 56
-#define IDS_TEST_STRING7 57
-#define IDD_TEST_DIALOG1 101
-#define IDD_TEST_DIALOG2 102
-#define IDB_PYTHON 103
-#define IDI_PYTHON 105
-#define IDD_TEST_DIALOG3 105
-#define IDC_EDIT1 1000
-#define IDC_CHECK1 1001
-#define IDC_EDIT2 1001
-#define IDC_COMBO1 1002
-#define IDC_SPIN1 1003
-#define IDC_PROGRESS1 1004
-#define IDC_SLIDER1 1005
-#define IDC_LIST1 1006
-#define IDC_TREE1 1007
-#define IDC_TAB1 1008
-#define IDC_ANIMATE1 1009
-#define IDC_RICHEDIT1 1010
-#define IDC_DATETIMEPICKER1 1011
-#define IDC_MONTHCALENDAR1 1012
-#define IDC_SCROLLBAR1 1013
-#define IDC_SCROLLBAR2 1014
-#define IDC_LIST2 1015
-#define IDC_HELLO 1016
-#define IDC_HELLO2 1017
-
-// Next default values for new objects
-//
-#ifdef APSTUDIO_INVOKED
-#ifndef APSTUDIO_READONLY_SYMBOLS
-#define _APS_NEXT_RESOURCE_VALUE 107
-#define _APS_NEXT_COMMAND_VALUE 40002
-#define _APS_NEXT_CONTROL_VALUE 1018
-#define _APS_NEXT_SYMED_VALUE 101
-#endif
-#endif
diff --git a/lib/win32/test/win32rcparser/test.rc b/lib/win32/test/win32rcparser/test.rc
deleted file mode 100644
index 9e4c7080..00000000
--- a/lib/win32/test/win32rcparser/test.rc
+++ /dev/null
@@ -1,216 +0,0 @@
-//Microsoft Developer Studio generated resource script.
-//
-#include "test.h"
-
-#define APSTUDIO_READONLY_SYMBOLS
-/////////////////////////////////////////////////////////////////////////////
-//
-// Generated from the TEXTINCLUDE 2 resource.
-//
-#include "afxres.h"
-
-/////////////////////////////////////////////////////////////////////////////
-#undef APSTUDIO_READONLY_SYMBOLS
-
-/////////////////////////////////////////////////////////////////////////////
-// English (Australia) resources
-
-#if !defined(AFX_RESOURCE_DLL) || defined(AFX_TARG_ENA)
-#ifdef _WIN32
-LANGUAGE LANG_ENGLISH, SUBLANG_ENGLISH_AUS
-#pragma code_page(1252)
-#endif //_WIN32
-
-#ifdef APSTUDIO_INVOKED
-/////////////////////////////////////////////////////////////////////////////
-//
-// TEXTINCLUDE
-//
-
-1 TEXTINCLUDE DISCARDABLE 
-BEGIN
-    "test.h\0"
-END
-
-2 TEXTINCLUDE DISCARDABLE 
-BEGIN
-    "#include ""afxres.h""\r\n"
-    "\0"
-END
-
-3 TEXTINCLUDE DISCARDABLE 
-BEGIN
-    "\r\n"
-    "\0"
-END
-
-#endif    // APSTUDIO_INVOKED
-
-
-/////////////////////////////////////////////////////////////////////////////
-//
-// Dialog
-//
-
-IDD_TEST_DIALOG1 DIALOG DISCARDABLE  0, 0, 186, 95
-STYLE DS_MODALFRAME | WS_POPUP | WS_CAPTION | WS_SYSMENU
-CAPTION "Test Dialog"
-FONT 8, "MS Sans Serif"
-BEGIN
-    DEFPUSHBUTTON   "OK",IDOK,129,7,50,14
-    PUSHBUTTON      "Cancel",IDCANCEL,129,24,50,14
-    ICON            IDI_PYTHON,IDC_STATIC,142,47,21,20
-    LTEXT           "An icon",IDC_STATIC,140,70,34,9
-END
-
-IDD_TEST_DIALOG2 DIALOG DISCARDABLE  0, 0, 186, 95
-STYLE DS_MODALFRAME | WS_POPUP | WS_CAPTION | WS_SYSMENU
-CAPTION "Test Dialog"
-FONT 8, "MS Sans Serif"
-BEGIN
-    DEFPUSHBUTTON   "OK",IDOK,129,7,50,14
-    PUSHBUTTON      "Cancel",IDCANCEL,129,24,50,14,NOT WS_TABSTOP
-    CONTROL         103,IDC_STATIC,"Static",SS_BITMAP,139,49,32,32
-    LTEXT           "A bitmap",IDC_STATIC,135,72,34,9
-    EDITTEXT        IDC_EDIT1,59,7,59,14,ES_AUTOHSCROLL
-    EDITTEXT        IDC_EDIT2,59,31,60,15,ES_AUTOHSCROLL | NOT WS_TABSTOP
-    LTEXT           "Tabstop",IDC_STATIC,7,9,43,10
-    LTEXT           "Not Tabstop",IDC_STATIC,7,33,43,10
-END
-
-IDD_TEST_DIALOG3 DIALOGEX 0, 0, 232, 310
-STYLE DS_MODALFRAME | WS_POPUP | WS_CAPTION | WS_SYSMENU
-CAPTION "Dialog"
-FONT 8, "MS Sans Serif", 0, 0, 0x1
-BEGIN
-    GROUPBOX        "Frame",IDC_STATIC,7,7,218,41
-    LTEXT           "Left Static",IDC_STATIC,16,17,73,11
-    EDITTEXT        IDC_EDIT1,103,15,112,12,ES_AUTOHSCROLL
-    LTEXT           "Right Static",IDC_STATIC,16,30,73,11,0,WS_EX_RIGHT
-    CONTROL         "",IDC_RICHEDIT1,"RICHEDIT",ES_AUTOHSCROLL | WS_BORDER | 
-                    WS_TABSTOP,103,31,113,14
-    CONTROL         "Check1",IDC_CHECK1,"Button",BS_AUTOCHECKBOX | 
-                    WS_TABSTOP,7,52,68,12
-    COMBOBOX        IDC_COMBO1,85,52,82,35,CBS_DROPDOWNLIST | CBS_SORT | 
-                    WS_VSCROLL | WS_TABSTOP
-    CONTROL         "Spin1",IDC_SPIN1,"msctls_updown32",UDS_ARROWKEYS,7,71,
-                    14,22
-    CONTROL         "Progress1",IDC_PROGRESS1,"msctls_progress32",WS_BORDER,
-                    39,72,153,13
-    SCROLLBAR       IDC_SCROLLBAR2,207,55,13,57,SBS_VERT
-    CONTROL         "Slider1",IDC_SLIDER1,"msctls_trackbar32",TBS_BOTH | 
-                    TBS_NOTICKS | WS_TABSTOP,35,91,159,7
-    SCROLLBAR       IDC_SCROLLBAR1,37,102,155,11
-    CONTROL         "Tab1",IDC_TAB1,"SysTabControl32",0x0,7,120,217,43
-    CONTROL         "Animate1",IDC_ANIMATE1,"SysAnimate32",WS_BORDER | 
-                    WS_TABSTOP,7,171,46,42
-    CONTROL         "List1",IDC_LIST1,"SysListView32",WS_BORDER | WS_TABSTOP,
-                    63,171,53,43
-    CONTROL         "Tree1",IDC_TREE1,"SysTreeView32",WS_BORDER | WS_TABSTOP,
-                    126,171,50,43
-    CONTROL         "MonthCalendar1",IDC_MONTHCALENDAR1,"SysMonthCal32",
-                    MCS_NOTODAY | WS_TABSTOP,7,219,140,84
-    CONTROL         "DateTimePicker1",IDC_DATETIMEPICKER1,"SysDateTimePick32",
-                    DTS_RIGHTALIGN | WS_TABSTOP,174,221,51,15
-    DEFPUSHBUTTON   "OK",IDOK,175,289,50,14
-    PUSHBUTTON      "Hello",IDC_HELLO,175,271,50,14
-    PUSHBUTTON      "Hello",IDC_HELLO2,175,240,50,26,BS_ICON
-    LISTBOX         IDC_LIST2,184,171,40,45,LBS_SORT | LBS_NOINTEGRALHEIGHT | 
-                    WS_VSCROLL | WS_TABSTOP
-END
-
-
-/////////////////////////////////////////////////////////////////////////////
-//
-// DESIGNINFO
-//
-
-#ifdef APSTUDIO_INVOKED
-GUIDELINES DESIGNINFO DISCARDABLE 
-BEGIN
-    IDD_TEST_DIALOG1, DIALOG
-    BEGIN
-        LEFTMARGIN, 7
-        RIGHTMARGIN, 179
-        TOPMARGIN, 7
-        BOTTOMMARGIN, 88
-    END
-
-    IDD_TEST_DIALOG2, DIALOG
-    BEGIN
-        LEFTMARGIN, 7
-        RIGHTMARGIN, 179
-        TOPMARGIN, 7
-        BOTTOMMARGIN, 88
-    END
-
-    IDD_TEST_DIALOG3, DIALOG
-    BEGIN
-        LEFTMARGIN, 7
-        RIGHTMARGIN, 225
-        TOPMARGIN, 7
-        BOTTOMMARGIN, 303
-    END
-END
-#endif    // APSTUDIO_INVOKED
-
-
-/////////////////////////////////////////////////////////////////////////////
-//
-// Icon
-//
-
-// Icon with lowest ID value placed first to ensure application icon
-// remains consistent on all systems.
-IDI_PYTHON              ICON    DISCARDABLE     "python.ico"
-
-/////////////////////////////////////////////////////////////////////////////
-//
-// Bitmap
-//
-
-IDB_PYTHON              BITMAP  DISCARDABLE     "python.bmp"
-
-/////////////////////////////////////////////////////////////////////////////
-//
-// Dialog Info
-//
-
-IDD_TEST_DIALOG3 DLGINIT
-BEGIN
-    IDC_COMBO1, 0x403, 6, 0
-0x7449, 0x6d65, 0x0031, 
-    IDC_COMBO1, 0x403, 6, 0
-0x7449, 0x6d65, 0x0032, 
-    0
-END
-
-
-/////////////////////////////////////////////////////////////////////////////
-//
-// String Table
-//
-
-STRINGTABLE DISCARDABLE 
-BEGIN
-    IDS_TEST_STRING1        "Test ""quoted"" string"
-    IDS_TEST_STRING2        "Test string"
-    IDS_TEST_STRING3        "String with single "" quote"
-    IDS_TEST_STRING4        "Test 'single quoted' string"
-END
-
-#endif    // English (Australia) resources
-/////////////////////////////////////////////////////////////////////////////
-
-
-
-#ifndef APSTUDIO_INVOKED
-/////////////////////////////////////////////////////////////////////////////
-//
-// Generated from the TEXTINCLUDE 3 resource.
-//
-
-
-/////////////////////////////////////////////////////////////////////////////
-#endif    // not APSTUDIO_INVOKED
-
diff --git a/lib/win32com/HTML/GeneratedSupport.html b/lib/win32com/HTML/GeneratedSupport.html
deleted file mode 100644
index b6fa50f7..00000000
--- a/lib/win32com/HTML/GeneratedSupport.html
+++ /dev/null
@@ -1,104 +0,0 @@
-<HTML>
-<HEAD>
-<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=windows-1252">
-<META NAME="Generator" CONTENT="Microsoft Word 97">
-<TITLE>Generated Python COM Support</TITLE>
-<META NAME="Version" CONTENT="8.0.3410">
-<META NAME="Date" CONTENT="10/11/96">
-<META NAME="Template" CONTENT="D:\Program Files\Microsoft Office\Office\html.dot">
-</HEAD>
-<BODY TEXT="#000000" LINK="#0000ff" VLINK="#800080" BGCOLOR="#ffffff">
-
-<P><IMG SRC="image/pycom_blowing.gif" WIDTH=549 HEIGHT=99 ALT="Python and COM - Blowing the others away"></P>
-<H1>Generated Python COM Support</H1>
-<P>This file describes how the Python COM extensions support "generated files". The information contained here is for expert Python users, and people who need to take advantage of the advanced features of the support. More general information is available in the <A HREF="QuickStartClientCom.html">Quick Start to Client Side COM</A> documentation.</P>
-<H2>Introduction</H2>
-<P>Generated Python COM support means that a .py file exists behind a particular COM object. This .py file is created by a generation process from a COM type library.</P>
-<P>This documentation talks about the process of the creation of the .py files.</P>
-<H2>Design Goals</H2>
-<P>The main design goal is that the Python programmer need not know much about the type library they wish to work with. They need not know the name of a specific Python module to use a type library. COM uses an IID, version and LCID to identify a type library. Therefore, the Python programmer only need know this information to obtain a Python module.</P>
-<H2>How to generate support files</H2>
-<P>Support files can be generated either "off-line" by the makepy utility, or in custom Python code.</P>
-<P>Using makepy is in many ways far simpler - you simply pick the type library and you are ready to go! The <A HREF="QuickStartClientCom.html">Quick Start to Client Side COM</A> documentation describes this process.</P>
-<P>Often however, you will want to use code to ensure the type library has been processed. This document describes that process.</P>
-<H2>Usage</H2>
-<P>The win32com.client.gencache module implements all functionality. As described above, if you wish to generate support from code, you need to know the IID, version and LCID of the type library.</P>
-<P>The following functions are defined. The best examples of their usage is probably in the Pythonwin OCX Demos, and the COM Test Suite (particularly testMSOffice.py)</P>
-<P>Note that the gencache.py file supports being run from the command line, and provides some utilities for managing the cache. Run the file to see usage options.</P>
-<H2>Using makepy to help with the runtime generation</H2>
-<P>makepy supports a "-i" option, to print information about a type library.  When you select a type library, makepy will print out 2 lines of code that you cant paste into your application.  This will then allow your module to generate the makepy .py file at runtime, but will only take you a few seconds!</P>
-<H2>win32com.client.gencache functions</H2>
-<H3>def MakeModuleForTypelib(typelibCLSID, lcid, major, minor, progressInstance = None):</H3>
-<P>Generate support for a type library.</P>
-<P>Given the IID, LCID and version information for a type library, generate and import the necessary support files.</P>
-<B><P>Returns</P>
-</B><P>The Python module. No exceptions are caught.</P>
-<B><P>Params</P>
-</B><I><P>typelibCLSID</I><BR>
-IID of the type library.</P>
-<I><P>major</I><BR>
-Integer major version.</P>
-<I><P>minor</I><BR>
-Integer minor version.</P>
-<I><P>lcid</I><BR>
-Integer LCID for the library.</P>
-<I><P>progressInstance</I><BR>
-A class instance to use as the progress indicator, or None to use the default GUI one.&nbsp;</P>
-<H3>def EnsureModule(typelibCLSID, lcid, major, minor, progressInstance = None):</H3>
-<P>Ensure Python support is loaded for a type library, generating if necessary.</P>
-<P>Given the IID, LCID and version information for a type library, check and if necessary generate, then import the necessary support files.</P>
-<P>Returns:</P>
-<P>The Python module. No exceptions are caught during the generate process.</P>
-<B><P>Params</P>
-</B><I><P>typelibCLSID</I><BR>
-IID of the type library.</P>
-<I><P>major</I><BR>
-Integer major version.</P>
-<I><P>minor</I><BR>
-Integer minor version.</P>
-<I><P>lcid</I><BR>
-Integer LCID for the library.</P>
-<I><P>progressInstance</I><BR>
-A class instance to use as the progress indicator, or None to use the default GUI one.&nbsp;</P>
-<P>&nbsp;</P>
-<H3>def GetClassForProgID(<I>progid</I>):</H3>
-<P>Get a Python class for a Program ID</P>
-<P>Given a Program ID, return a Python class which wraps the COM object</P>
-<B><P>Returns</P>
-</B><P>The Python class, or None if no module is available.</P>
-<B><P>Params</P>
-</B><I><P>progid<BR>
-</I>A COM ProgramID or IID (eg, "Word.Application")</P>
-<P>&nbsp;</P>
-<H3>def GetModuleForProgID(progid):</H3>
-<P>Get a Python module for a Program ID</P>
-<P>Given a Program ID, return a Python module which contains the class which wraps the COM object.</P>
-<B><P>Returns</P>
-</B><P>The Python module, or None if no module is available.</P>
-<B><P>Params:</P>
-</B><I><P>progid <BR>
-</I>A COM ProgramID or IID (eg, "Word.Application")</P>
-<P>&nbsp;</P>
-<H3>def GetModuleForCLSID(clsid):</H3>
-<P>Get a Python module for a CLSID</P>
-<P>Given a CLSID, return a Python module which contains the class which wraps the COM object.</P>
-<B><P>Returns</P>
-</B><P>The Python module, or None if no module is available.</P>
-<B><P>Params</P>
-</B><I><P>progid<BR>
-</I>A COM CLSID (ie, not the description)</P>
-<P>&nbsp;</P>
-<H3>def GetModuleForTypelib(typelibCLSID, lcid, major, minor):</H3>
-<P>Get a Python module for a type library ID</P>
-<B><P>Returns</P>
-</B><P>An imported Python module, else None</P>
-<B><P>Params</B>:</P>
-<I><P>typelibCLSID</I><BR>
-IID of the type library.</P>
-<I><P>major</I><BR>
-Integer major version.</P>
-<I><P>minor</I><BR>
-Integer minor version</P>
-<I><P>lcid</I><BR>
-Integer LCID for the library.</P></BODY>
-</HTML>
diff --git a/lib/win32com/HTML/PythonCOM.html b/lib/win32com/HTML/PythonCOM.html
deleted file mode 100644
index ed48a897..00000000
--- a/lib/win32com/HTML/PythonCOM.html
+++ /dev/null
@@ -1,90 +0,0 @@
-<HTML>
-<HEAD>
-<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=windows-1252">
-<META NAME="Generator" CONTENT="Microsoft Word 97">
-<TITLE>Untitled</TITLE>
-<META NAME="Template" CONTENT="D:\Program Files\Microsoft Office\Office\html.dot">
-</HEAD>
-<BODY LINK="#0000ff" VLINK="#800080">
-
-<H1><IMG SRC="image/pycom_blowing.gif" WIDTH=549 HEIGHT=99 ALT="Python and COM - Blowing the others away"></H1>
-<H1>Python and COM - Implementation Details </H1>
-<H2>Introduction </H2>
-<P>This document describes the technical implementation of the COM support in Python. It is primarily concerned with the underlying C++ interface to COM, although general Python issues are touched. </P>
-<P>This document is targeted at people who wish to maintain/enhance the standard COM support (typically by writing extension modules). For information on using Python and COM from a Python programmers perspective, please see the <A HREF="docindex.html">documentation index</A>. </P>
-<H2>General COM Support. </H2>
-<P>COM support in Python can be broken into 2 general areas - C++ support, and Python support. C++ support exists in the core PythonCOM module (plus any PythonCOM extension modules). Python support exists in the .py files that accompany the core module. </P>
-<H2>Naming Conventions </H2>
-<P>The naming conventions used by Python code will be: </P>
-
-<UL>
-<LI>The Python "New Import" (ni) module will be used, allowing packages, or nested modules. </LI>
-<LI>The package name will be "win32com". </LI>
-<LI>The core module name will be "pythoncom" (ie, "win32com.pythoncom") </LI></UL>
-
-<P>The rest of the naming conventions are yet to be worked out. </P>
-<H2>Core COM support. </H2>
-<P>This section is involved with the core C++ support in "pythoncom". </P>
-<P>The organisation of PythonCOM support falls into 3 discrete areas. </P>
-<H3>COM Client Support </H3>
-<P>This is the ability to manipulate other COM objects via their exposed interface. This includes use of IDispatch (eg using Python to start Microsoft Word, open a file, and print it.) but also all client side IUnknown derived objects fall into this category, including ITypeLib and IConnectionPoint support. </P>
-<H3>COM Server Support </H3>
-<P>This is ability for Python to create COM Servers, which can be manipulated by another COM client. This includes server side IDispatch (eg, Visual Basic starting a Python interpreter, and asking it to evaluate some code) but also all supported server side IUnknown derived classes. </P>
-<H3>Python/COM type and value conversion </H3>
-<P>This is internal code used by the above areas to managed the conversion to and from Python/COM types and values. This includes code to convert an arbitrary Python object into a COM variant, manages return types, and a few other helpers. </P>
-<H2>COM Structures and Python Types </H2>
-<P>OLE supports many C level structures for the COM API, which must be mapped to Python. </P>
-<H3>VARIANT </H3>
-<P>Variants are never exposed as such to Python programs. The internal framework always converts all variants to and from Python types. In some cases, type descriptions may be used, which force specific mappings, although in general the automatic conversion works fine. </P>
-<H3>TYPEDESC </H3>
-<P>A tuple, containing the elements of the C union. This union will be correctly decoded by the support code. </P>
-<H3>ELEMDESC </H3>
-<P>A tuple of TYPEDESC and PARAMDESC objects. </P>
-<H3>FUNCDESC </H3>
-<P>A funcdesc is a large and unwieldy tuple. Documentation to be supplied. </P>
-<H3>IID/CLSID </H3>
-<P>A native IID in Python is a special type, defined in pythoncom. Whenever a CLSID/IID is required, typically either an object, a tuple of type "iii(iiiiiiii)" or string can be used. </P>
-<P>Helper functions are available to convert to and from IID/CLSID and strings. </P>
-<H2>COM Framework </H2>
-<P>Both client and server side support have a specific framework in place to assist in supporting the widest possible set of interfaces. The framework allows external extension DLLs to be written, which extend the interfaces available to the Python user. </P>
-<P>This allows the core PythonCOM module to support a wide set of common interfaces, and other extensions to support anything obscure. </P>
-<H3>Client Framework </H3>
-<H4>QueryInterface and Types </H4>
-<P>When the only support required by Python is IDispatch, everything is simple - every object returned from QueryInterface is a PyIDispatch object. But this does not extend to other types, such as ITypeLib, IConnectionPoint etc., which are required for full COM support. </P>
-<P>For example, consider the following C++ psuedo-code: </P>
-<CODE><P>IConnectionPoint *conPt;<BR>
-someIDispatch-&gt;QueryInterface(IID_IConnectionPoint, (void **)&amp;conPt);<BR>
-// Note the IID_ and type of the * could be anything!</CODE> </P>
-<P>This cast, and knowledge of a specific IID_* to type must be simulated in Python. </P>
-<P>Python/COM will therefore maintain a map of UID's to Python type objects. Whenever QueryInterface is called, Python will lookup this map, to determine if the object type is supported. If the object is supported, then an object of that type will be returned. If the object is not supported, then a PyIUnknown object will be returned. </P>
-<P>Note that PyIDispatch will be supported by the core engine. Therefore: </P>
-<CODE><P>&gt;&gt;&gt; disp=someobj.QueryInterface(win32com.IID_Dispatch) </P>
-</CODE><P>will return a PyIDispatch object, whereas </P>
-<CODE><P>&gt;&gt;&gt; unk=someobj.QueryInterface(SomeUnknownIID) # returns PyIUnknown<BR>
-&gt;&gt;&gt; disp=unk.QueryInterface(win32com.IID_Dispatch) <BR>
-&gt;&gt;&gt; unk.Release() # Clean up now, rather than waiting for unk death.</CODE> </P>
-<P>Is needed to convert to an IDispatch object. </P>
-<H4>Core Support </H4>
-<P>The core COM support module will support the IUnknown, IDispatch, ITypeInfo, ITypeLib and IConnectionPointContainer and IConnectionPoint interfaces. This implies the core COM module supports 6 different OLE client object types, mapped to the 6 IID_*'s representing the objects. (The IConnection* objects allow for Python to repsond to COM events) </P>
-<P>A psuedo-inheritance scheme is used. The Python types are all derived from the Python IUnknown type (PyIUnknown). Therefore all IUnknown methods are automatically available to all types, just as it should be. The PyIUnknown type manages all object reference counts and destruction. </P>
-<H4>Extensibility </H4>
-<P>To provide the above functionality, a Python map is provided, which maps from a GUID to a Python type object. </P>
-<P>The advantage of this scheme is an external extension modules can hook into the core support. For example, imagine the following code: </P>
-<CODE><P>&gt;&gt;&gt; import myextracom # external .pyd supporting some interface.<BR>
-# myextracom.pyd will do the equivilent of</CODE> </P>
-<CODE><P># pythoncom.mapSupportedTypes(myextracom.IID_Extra, myextracom.ExtraType) <BR>
-&gt;&gt;&gt; someobj.QueryInterface(myextracom.IID_Extra)</CODE> </P>
-<P>Would correctly return an object defined in the extension module. </P>
-<H3>Server Framework </H3>
-<H4>General Framework </H4>
-<P>A server framework has been put in place which provides the following features: </P>
-<P>All Interfaces provide VTBL support - this means that the Servers exposed by Python are callable from C++ and other compiled languages. </P>
-<P>Supports full "inproc" servers. This means that no external .EXE is needed making Python COM servers available in almost all cases. </P>
-<P>An extensible model which allows for extension modules to provide server support for interfaces defined in that module. A map is provided which maps from a GUID to a function pointer which creates the interface. </P>
-<H3>Python and Variant Types Conversion </H3>
-<P>In general, Python and COM are both "type-less". COM is type-less via the VARIANT object, which supports many types, and Python is type-less due to its object model. </P>
-<P>There are a number of areas where Python and OLE clash. </P>
-<H4>Parameters and conversions. </H4>
-<P>For simple calls, there are 2 helpers available which will convert to and from PyObjects and VARIANTS. The call to convert a Python object to a VARIANT is simple in that it returns a VARIANT of the most appropriate type for the Python object - ie, the type of the Python object determines the resulting VARIANT type. </P>
-<P>There are also more complex conversion routines available, wrapped in a C++ helper class. Typically, these helpers are used whenever a specific variant type is known (eg, when an ITypeInfo is available for the object being used). In this case, all efforts are made to convert the Python type to the requested variant type - ie, in this situation, the VARIANT type determines how the Python object is coerced. In addition, this code supports the use of "ByRef" and pointer paramaters, providing and freeing any buffers necessary for the call. </P></BODY>
-</HTML>
diff --git a/lib/win32com/HTML/QuickStartClientCom.html b/lib/win32com/HTML/QuickStartClientCom.html
deleted file mode 100644
index f3a02742..00000000
--- a/lib/win32com/HTML/QuickStartClientCom.html
+++ /dev/null
@@ -1,82 +0,0 @@
-<HTML>
-<HEAD>
-<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=windows-1252">
-<META NAME="Generator" CONTENT="Microsoft Word 97">
-<TITLE>Quick Start to Client side COM and Python</TITLE>
-<META NAME="Template" CONTENT="D:\Program Files\Microsoft Office\Office\html.dot">
-</HEAD>
-<BODY LINK="#0000ff" VLINK="#800080">
-
-<H1>Quick Start to Client side COM and Python</H1>
-<H2>Introduction</H2>
-<P>This documents how to quickly start using COM from Python. It is not a thorough discussion of the COM system, or of the concepts introduced by COM.</P>
-<P>Other good information on COM can be found in various conference tutorials - please see <A HREF="http://starship.python.net/crew/mhammond/conferences">the collection of Mark's conference tutorials</A></P>
-<P>For information on implementing COM objects using Python, please see <A HREF="http://www.python.org/windows/win32com/QuickStartServerCom.html">a Quick Start to Server side COM and Python</A></P>
-<P>In this document we discuss the following topics:</P>
-
-<UL>
-<LI><A HREF="#Using">Using a COM object from Python</A> </LI>
-<LI><A HREF="#WhatObjects">How do I know which objects are available?</A> </LI>
-<LI><A HREF="#StaticDispatch">Static Dispatch/Type Safe objects (using the new improved makepy.py)</A></LI>
-<LI><A HREF="#UsingComConstants">Using COM Constants with makepy.</A></LI></UL>
-
-<H2>Quick Start</H2>
-<H3><A NAME="Using">To use a COM object from Python</A></H3>
-<CODE><P>import win32com.client<BR>
-o = win32com.client.Dispatch("Object.Name")<BR>
-o.Method()<BR>
-o.property = "New Value"<BR>
-print o.property</P>
-</CODE><P>Example</P>
-<CODE><P>o = win32com.client.Dispatch("Excel.Application")<BR>
-o.Visible = 1<BR>
-o.Workbooks.Add() # for office 97 � 95 a bit different!<BR>
-o.Cells(1,1).Value = "Hello"</CODE> </P>
-<P>And we will see the word "Hello" appear in the top cell. </P>
-<H3><A NAME="WhatObjects">How do I know which methods and properties are available?</A></H3>
-<P>Good question. This is hard! You need to use the documentation with the products, or possibly a COM browser. Note however that COM browsers typically rely on these objects registering themselves in certain ways, and many objects to not do this. You are just expected to know.</P>
-<H4>The Python COM browser</H4>
-<P>PythonCOM comes with a basic COM browser that may show you the information you need. Note that this package requires Pythonwin (ie, the MFC GUI environment) to be installed for this to work.</P>
-<P>There are far better COM browsers available - I tend to use the one that comes with MSVC, or this one!</P>
-<P>To run the browser, simply select it from the Pythonwin <I>Tools</I> menu, or double-click on the file <I>win32com\client\combrowse.py</I></P>
-<H2><A NAME="StaticDispatch">Static Dispatch (or Type Safe) objects</A></H2>
-<P>In the above examples, if we printed the '<CODE>repr(o)</CODE>' object above, it would have resulted in</P>
-<CODE><P>&lt;COMObject Excel.Application&gt;</P>
-</CODE><P>This reflects that the object is a generic COM object that Python has no special knowledge of (other than the name you used to create it!). This is known as a "dynamic dispatch" object, as all knowledge is built dynamically. The win32com package also has the concept of <I>static dispatch</I> objects, which gives Python up-front knowledge about the objects that it is working with (including arguments, argument types, etc)</P>
-<P>In a nutshell, Static Dispatch involves the generation of a .py file that contains support for the specific object. For more overview information, please see the documentation references above.</P>
-<P>The generation and management of the .py files is somewhat automatic, and involves one of 2 steps:</P>
-
-<UL>
-<LI>Using <I>makepy.py</I> to select a COM library. This process is very similar to Visual Basic, where you select from a list of all objects installed on your system, and once selected the objects are magically useable. </LI></UL>
-
-<P>or</P>
-
-<UL>
-<LI>Use explicit code to check for, and possibly generate, support at run-time. This is very powerful, as it allows the developer to avoid ensuring the user has selected the appropriate type library. This option is extremely powerful for OCX users, as it allows Python code to sub-class an OCX control, but the actual sub-class can be generated at run-time.  Use <I>makepy.py</I> with a </I>-i</I> option to see how to include this support in your Python code.</LI></UL>
-
-<P>The <I>win32com.client.gencache</I> module manages these generated files. This module has <A HREF="GeneratedSupport.html">some documentation of its own</A>, but you probably don't need to know the gory details!</P>
-<H3>How do I get at the generated module?</H3>
-<P>You will notice that the generated file name is long and cryptic - obviously not designed for humans to work with! So how do you get at the module object for the generated code?</P>
-<P>Hopefully, the answer is <I>you shouldn't need to</I>.  All generated file support is generally available directly via <I>win32com.client.Dispatch</I> and <I>win32com.client.constants</I>.  But should you ever really need the Python module object, the win32com.client.gencache module has functions specifically for this. The functions GetModuleForCLSID and GetModuleForProgID both return Python module objects that you can use in your code. See the docstrings in the gencache code for more details.</P>
-<H3>To generate Python Sources supporting a COM object</H3>
-<H4>Example using Microsoft Office 97.</H4>
-<P>Either:</P>
-
-<UL>
-<LI>Run '<CODE>win32com\client\makepy.py</CODE>' (eg, run it from the command window, or double-click on it) and a list will be presented. Select the Type Library '<CODE>Microsoft Word 8.0 Object Library</CODE>' </LI>
-<LI>From a command prompt, run the command '<CODE>makepy.py "Microsoft Word 8.0 Object Library"</CODE>' (include the double quotes). This simply avoids the selection process. </LI>
-<LI>If you desire, you can also use explicit code to generate it just before you need to use it at runtime.  Run <CODE>'makepy.py -i "Microsoft Word 8.0 Object Library"</CODE>' (include the double quotes) to see how to do this.</LI></UL>
-
-<P>And that is it! Nothing more needed. No special import statements needed! Now, you simply need say</P>
-<CODE><P>&gt;&gt;&gt; import win32com.client</P>
-<P>&gt;&gt;&gt; w=win32com.client.Dispatch("Word.Application")</P>
-<P>&gt;&gt;&gt; w.Visible=1</P>
-<P>&gt;&gt;&gt; w</P>
-<P>&lt;win32com.gen_py.Microsoft Word 8.0 Object Library._Application&gt;</P>
-</CODE><P>Note that now Python knows the explicit type of the object.</P>
-<H3><A NAME="UsingComConstants">Using COM Constants</A></H3>
-<P>Makepy automatically installs all generated constants from a type library in an object called <I>win32com.clients.constants</I>.  You do not need to do anything special to make these constants work, other than create the object itself (ie, in the example above, the constants relating to <I>Word</I> would automatically be available after the <CODE>w=win32com.client.Dispatch("Word.Application</CODE>") statement<CODE>.</P>
-</CODE><P>For example, immediately after executing the code above, you could execute the following:</P>
-<CODE><P>&gt;&gt;&gt; w.WindowState = win32com.client.constants.wdWindowStateMinimize</P>
-</CODE><P>and Word will Minimize.</P></BODY>
-</HTML>
diff --git a/lib/win32com/HTML/QuickStartServerCom.html b/lib/win32com/HTML/QuickStartServerCom.html
deleted file mode 100644
index b956daaf..00000000
--- a/lib/win32com/HTML/QuickStartServerCom.html
+++ /dev/null
@@ -1,195 +0,0 @@
-<HTML>
-<HEAD>
-<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=windows-1252">
-<META NAME="Generator" CONTENT="Microsoft Word 97">
-<TITLE>Quick Start to Server Side COM and Python</TITLE>
-<META NAME="Version" CONTENT="8.0.3410">
-<META NAME="Date" CONTENT="10/11/96">
-<META NAME="Template" CONTENT="D:\Program Files\Microsoft Office\Office\html.dot">
-</HEAD>
-<BODY TEXT="#000000" LINK="#0000ff" VLINK="#800080" BGCOLOR="#ffffff">
-
-<H1>Quick Start to Server side COM and Python</H1>
-<H2>Introduction</H2>
-<P>This documents how to quickly start implementing COM objects in Python. It is not a thorough discussion of the COM system, or of the concepts introduced by COM.</P>
-<P>For more details information on Python and COM, please see the <A HREF="http://www.python.org/windows/win32com/COMTutorial/index.htm">COM Tutorial given by Greg Stein and Mark Hammond at SPAM 6 (HTML format)</A> or download the same tutorial <A HREF="http://www.python.org/windows/win32com/COMTutorial.ppt">in PowerPoint format.</A></P>
-<P>For information on using external COM objects from Python, please see <A HREF="QuickStartClientCom.html">a Quick Start to Client side COM and Python</A>.</P>
-<P>In this document we discuss the <A HREF="#core">core functionality</A>, <A HREF="#Registering">registering the server</A>, <A HREF="#testing">testing the class</A>, <A HREF="#debugging">debugging the class</A>, <A HREF="#Exception">exception handling</A> and <A HREF="#Policies">server policies</A> (phew!)</P>
-<H2><A NAME="core">Implement the core functionality</A></H2>
-<H3><A NAME="Using">Implement a stand-alone Python class with your functionality</A></H3>
-<CODE><P>class HelloWorld:</P><DIR>
-<DIR>
-
-<P>def __init__(self):</P><DIR>
-<DIR>
-
-<P>self.softspace = 1</P>
-<P>self.noCalls = 0</P></DIR>
-</DIR>
-
-<P>def Hello(self, who):</P><DIR>
-<DIR>
-
-<P>self.noCalls = self.noCalls + 1</P>
-<P># insert "softspace" number of spaces</P>
-<P>return "Hello" + " " * self.softspace + who</P></DIR>
-</DIR>
-</DIR>
-</DIR>
-
-</CODE><P>This is obviously a very simple server. In particular, custom error handling would be needed for a production class server. In addition, there are some contrived properties just for demonstration purposes.</P>
-<H3>Make Unicode concessions</H3>
-<P>At this stage, Python and Unicode don�t really work well together. All strings which come from COM will actually be Unicode objects rather than string objects.</P>
-<P>To make this code work in a COM environment, the last line of the "Hello" method must become:</P><DIR>
-<DIR>
-<DIR>
-<DIR>
-
-<CODE><P>return "Hello" + " " * self.softspace + str(who)</P></DIR>
-</DIR>
-</DIR>
-</DIR>
-
-</CODE><P>Note the conversion of the "who" to "str(who)". This forces the Unicode object into a native Python string object.</P>
-<P>For details on how to debug COM Servers to find this sort of error, please see <A HREF="#debugging">debugging the class</A></P>
-<H3>Annotate the class with win32com specific attributes</H3>
-<P>This is not a complete list of names, simply a list of properties used by this sample.</P>
-<TABLE CELLSPACING=0 BORDER=0 CELLPADDING=7 WIDTH=637>
-<TR><TD WIDTH="34%" VALIGN="TOP">
-<P><B>Property Name</B></TD>
-<TD WIDTH="66%" VALIGN="TOP">
-<B><P>Description</B></TD>
-</TR>
-<TR><TD WIDTH="34%" VALIGN="TOP">
-<P>_public_methods_</TD>
-<TD WIDTH="66%" VALIGN="TOP">
-<P>List of all method names exposed to remote COM clients</TD>
-</TR>
-<TR><TD WIDTH="34%" VALIGN="TOP">
-<P>_public_attrs_</TD>
-<TD WIDTH="66%" VALIGN="TOP">
-<P>List of all attribute names exposed to remote COM clients</TD>
-</TR>
-<TR><TD WIDTH="34%" VALIGN="TOP" HEIGHT=5>
-<P>_readonly_attrs_</TD>
-<TD WIDTH="66%" VALIGN="TOP" HEIGHT=5>
-<P>List of all attributes which can be accessed, but not set.</TD>
-</TR>
-</TABLE>
-
-<P>We change the class header to become:</P>
-<CODE><P>class HelloWorld:</P><DIR>
-<DIR>
-
-<P>_public_methods_ = ['Hello']</P>
-<P>_public_attrs_ = ['softspace', 'noCalls']</P>
-<P>_readonly_attrs_ = ['noCalls']</P>
-<P>def __init__(self):</P>
-<P>[Same from here�]</P></DIR>
-</DIR>
-
-</CODE><H3><A NAME="Registering">Registering and assigning a CLSID for the object</A></H3>
-<P>COM requires that all objects use a unique CLSID and be registered under a "user friendly" name. This documents the process.</P>
-<H4>Generating the CLSID</H4>
-<P>Microsoft Visual C++ comes with various tools for generating CLSID's, which are quite suitable. Alternatively, the pythoncom module exports the function CreateGuid() to generate these identifiers.</P>
-<CODE><P>&gt;&gt;&gt; import pythoncom<BR>
-&gt;&gt;&gt; print pythoncom.CreateGuid()<BR>
-{7CC9F362-486D-11D1-BB48-0000E838A65F}</P>
-</CODE><P>Obviously the GUID that you get will be different than that displayed here.</P>
-<H4>Preparing for registration of the Class</H4>
-<P>The win32com package allows yet more annotations to be applied to a class, allowing registration to be effected with 2 lines in your source file. The registration annotations used by this sample are:</P>
-<TABLE CELLSPACING=0 BORDER=0 CELLPADDING=7 WIDTH=636>
-<TR><TD WIDTH="34%" VALIGN="TOP">
-<P><B>Property Name</B></TD>
-<TD WIDTH="66%" VALIGN="TOP">
-<B><P>Description</B></TD>
-</TR>
-<TR><TD WIDTH="34%" VALIGN="TOP">
-<P>_reg_clsid_</TD>
-<TD WIDTH="66%" VALIGN="TOP">
-<P>The CLSID of the COM object</TD>
-</TR>
-<TR><TD WIDTH="34%" VALIGN="TOP">
-<P>_reg_progid_</TD>
-<TD WIDTH="66%" VALIGN="TOP">
-<P>The "program ID", or Name, of the COM Server. This is the name the user usually uses to instantiate the object</TD>
-</TR>
-<TR><TD WIDTH="34%" VALIGN="TOP" HEIGHT=5>
-<P>_reg_desc_</TD>
-<TD WIDTH="66%" VALIGN="TOP" HEIGHT=5>
-<P>Optional: The description of the COM Server. Used primarily for COM browsers.  If not specified, the _reg_progid_ is used as the description.</TD>
-</TR>
-<TR><TD WIDTH="34%" VALIGN="TOP" HEIGHT=5>
-<P>_reg_class_spec_</TD>
-<TD WIDTH="66%" VALIGN="TOP" HEIGHT=5>
-<P>Optional: A string which represents how Python can create the class instance. The string is of format<BR>
-[package.subpackage.]module.class</P>
-<P>The portion up to the class name must be valid for Python to "import", and the class portion must be a valid attribute in the specified class.</P>
-<P>This is optional from build 124 of Pythoncom., and has been removed from this sample.</TD>
-</TR>
-<TR><TD WIDTH="34%" VALIGN="TOP" HEIGHT=5>
-<P>_reg_remove_keys_</TD>
-<TD WIDTH="66%" VALIGN="TOP" HEIGHT=5>
-<P>Optional: A list of tuples of extra registry keys to be removed when uninstalling the server. Each tuple is of format ("key", root), where key is a string, and root is one of the win32con.HKEY_* constants (this item is optional, defaulting to HKEY_CLASSES_ROOT)</TD>
-</TR>
-</TABLE>
-
-<P>Note there are quite a few other keys available. Also note that these annotations are <I>not</I> required - they just make registration simple. Helper functions in the module <CODE>win32com.server.register</CODE> allow you to explicitly specify each of these attributes without attaching them to the class.</P>
-<P>The header of our class now becomes:</P>
-<CODE><P>class HelloWorld:</P><DIR>
-<DIR>
-
-<P>_reg_clsid_ = "{7CC9F362-486D-11D1-BB48-0000E838A65F}"</P>
-<P>_reg_desc_ = "Python Test COM Server"</P>
-<P>_reg_progid_ = "Python.TestServer"</P>
-<P>_public_methods_ = ['Hello']</P>
-<P>[same from here]</P></DIR>
-</DIR>
-
-</CODE><H4>Registering the Class</H4>
-<P>The idiom that most Python COM Servers use is that they register themselves when run as a script (ie, when executed from the command line.) Thus the standard "<CODE>if __name__=='__main___':</CODE>" technique works well.</P>
-<P>win32com.server.register contains a number of helper functions. The easiest to use is "<CODE>UseCommandLine</CODE>".</P>
-<P>Registration becomes as simple as:</P>
-<CODE><P>if __name__=='__main__':<BR>
-&#9;# ni only for 1.4!<BR>
-&#9;import ni, win32com.server.register <BR>
-&#9;win32com.server.register.UseCommandLine(HelloWorld)</P>
-</CODE><P>Running the script will register our test server.</P>
-<H2><A NAME="testing">Testing our Class</A></H2>
-<P>For the purposes of this demonstration, we will test the class using Visual Basic. This code should run under any version of Visual Basic, including VBA found in Microsoft Office. Any COM compliant package could be used alternatively. VB has been used just to prove there is no "smoke and mirrors. For information on how to test the server using Python, please see the <A HREF="QuickStartClientCom.html">Quick Start to Client side COM</A> documentation.</P>
-<P>This is not a tutorial in VB. The code is just presented! Run it, and it will work!</P>
-<H2><A NAME="debugging">Debugging the COM Server</A></H2>
-<P>When things go wrong in COM Servers, there is often nowhere useful for the Python traceback to go, even if such a traceback is generated.</P>
-<P>Rather than discuss how it works, I will just present the procedure to debug your server:</P>
-<B><P>To register a debug version of your class</B>, run the script (as above) but pass in a "<CODE>--debug</CODE>" parameter. Eg, for the server above, use the command line "<CODE>testcomserver.py --debug</CODE>".</P>
-<B><P>To see the debug output generated</B> (and any print statements you may choose to add!) you can simply select the "Remote Debug Trace Collector" from the Pythonwin Tools menu, or run the script "win32traceutil.py" from Windows Explorer or a Command Prompt.</P>
-<H2><A NAME="Exception">Exception Handling </A></H2>
-<P>Servers need to be able to provide exception information to their client. In some cases, it may be a simple return code (such as E_NOTIMPLEMENTED), but often it can contain much richer information, describing the error on detail, and even a help file and topic where more information can be found. </P>
-<P>We use Python class based exceptions to provide this information. The COM framework will examine the exception, and look for certain known attributes. These attributes will be copied across to the COM exception, and passed back to the client. </P>
-<P>The following attributes are supported, and correspond to the equivalent entry in the COM Exception structure:<BR>
-<CODE>scode, code, description, source, helpfile and helpcontext</P>
-</CODE><P>To make working with exceptions easier, there is a helper module "win32com.server.exception.py", which defines a single class. An example of its usage would be: </P>
-<CODE><P>raise COMException(desc="Must be a string",scode=winerror.E_INVALIDARG,helpfile="myhelp.hlp",...)</CODE> </P>
-<P>(Note the <CODE>COMException class supports (and translates) "desc" as a shortcut for "description", but the framework requires "description")</P>
-</CODE><H2><A NAME="Policies">Server Policies</A></H2>
-<P>This is information about how it all hangs together. The casual COM author need not know this. </P>
-<P>Whenever a Python Server needs to be created, the C++ framework first instantiates a "policy" object. This "policy" object is the gatekeeper for the COM Server - it is responsible for creating the underlying Python object that is the server (ie, your object), and also for translating the underlying COM requests for the object. </P>
-<P>This policy object handles all of the underlying COM functionality. For example, COM requires all methods and properties to have unique numeric ID's associated with them. The policy object manages the creation of these ID's for the underlying Python methods and attributes. Similarly, when the client whishes to call a method with ID 123, the policy object translates this back to the actual method, and makes the call. </P>
-<P>It should be noted that the operation of the "policy" object could be dictated by the Python object - the policy object has many defaults, but the actual Python class can always dictate its operation. </P>
-<H3>Default Policy attributes </H3>
-<P>The default policy object has a few special attributes that define who the object is exposed to COM. The example above shows the _public_methods attribute, but this section describes all such attributes in detail. </P>
-<H5>_public_methods_ </H5>
-<P>Required list of strings, containing the names of all methods to be exposed to COM. It is possible this will be enhanced in the future (eg, possibly '*' will be recognised to say all methods, or some other ideas�) </P>
-<H5>_public_attrs_ </H5>
-<P>Optional list of strings containing all attribute names to be exposed, both for reading and writing. The attribute names must be valid instance variables. </P>
-<H5>_readonly_attrs_ </H5>
-<P>Optional list of strings defining the name of attributes exposed read-only. </P>
-<H5>_com_interfaces_ </H5>
-<P>Optional list of IIDs exposed by this object. If this attribute is missing, IID_IDispatch is assumed (ie, if not supplied, the COM object will be created as a normal Automation object.</P>
-<P>and actual instance attributes: </P>
-<P>_dynamic_ : optional method </P>
-<P>_value_ : optional attribute </P>
-<P>_query_interface_ : optional method </P>
-<P>_NewEnum : optional method </P>
-<P>_Evaluate : optional method </P></BODY>
-</HTML>
diff --git a/lib/win32com/HTML/docindex.html b/lib/win32com/HTML/docindex.html
deleted file mode 100644
index fff74de8..00000000
--- a/lib/win32com/HTML/docindex.html
+++ /dev/null
@@ -1,22 +0,0 @@
-<HTML>
-<HEAD>
-<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=windows-1252">
-<META NAME="Generator" CONTENT="Microsoft Word 97">
-<TITLE>win32com Documentation Index</TITLE>
-<META NAME="Template" CONTENT="D:\Program Files\Microsoft Office\Office\html.dot">
-</HEAD>
-<BODY LINK="#0000ff" VLINK="#800080">
-
-<H1><IMG SRC="image/pycom_blowing.gif" WIDTH=549 HEIGHT=99 ALT="Python and COM - Blowing the others away"></H1>
-<H1>PythonCOM Documentation Index</H1>
-<P>The following documentation is available</P>
-<P><A HREF="QuickStartClientCom.html">A Quick Start to Client Side COM</A> (including makepy)</P>
-<P><A HREF="QuickStartServerCom.html">A Quick Start to Server Side COM</A></P>
-<P><A HREF="GeneratedSupport.html">Information on generated Python files (ie, what makepy generates)</A></P>
-<P><A HREF="variant.html">An advanced VARIANT object which can give more control over parameter types</A></P>
-<P><A HREF="package.html">A brief description of the win32com package structure</A></P>
-<P><A HREF="PythonCOM.html">Python COM Implementation documentation</A></P>
-<P><A HREF="misc.html">Misc stuff I don�t know where to put anywhere else</A></P>
-<H3>ActiveX Scripting</H3>
-<P><A HREF="../../win32comext/axscript/demos/client/ie/demo.htm">ActiveX Scripting Demos</A></P></BODY>
-</HTML>
diff --git a/lib/win32com/HTML/image/BTN_HomePage.gif b/lib/win32com/HTML/image/BTN_HomePage.gif
deleted file mode 100644
index 5767fa0f96e5de4af525ae1846df1bb633b8f5ab..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 211
zcmZ?wbhEHb^kNWZSoELa|NsAI&YW>^abZ9Oia%Kx85sUE=zxSlY8{woaO}GC&)}3~
zGw<WHJ?+nLE$dzIwDi$ZHmBWjOdrmb<le84eO~i^`+)~p?uTYrElXJ`;j}RA;0kWF
z&ynjR!a_686xrRAn>gE1sdstEs|deknL!7$W%f0_p0=az{QKYk1EVXNBTHJ^lbSkO
zs-2sZvco3ySoP<pdF96DWY3ys<y73SJR^3N_T0Qx3kv(X?IyN%t>3a}>-GRn25SI#
C6I&7h

diff --git a/lib/win32com/HTML/image/BTN_ManualTop.gif b/lib/win32com/HTML/image/BTN_ManualTop.gif
deleted file mode 100644
index 4200880a26eedc3e0c545ddef7a099fe71c9a8c6..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 215
zcmZ?wbhEHb^kNWZSoELa|NsAI&YW>^abZ9Oia%Kx85sUE=zxSlY8{y8aO}GC&)}3~
zGcWV&o}WLai5J}xjZ1K!HT}URU54`|x%Vq{PgK7DFE+hloAFw&`8^({QBr~Prg(ZR
z^{YIv=3BVS#y<O%UVBnY{r#6^%ye0P{at2h#<6Md3*Xk9fB*Y`Lql0bOKN&+M`U|v
zkE6bEdr*o)LV{h%gt8p}0@aME^F3U`3?{}en(MW2`HD)$+S1;rX)(>4wlCebWA}Pa
G25SJ-f?Hq!

diff --git a/lib/win32com/HTML/image/BTN_NextPage.gif b/lib/win32com/HTML/image/BTN_NextPage.gif
deleted file mode 100644
index 3d055fea0ecae9b27417820e2f8bdc1febf84b61..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 218
zcmZ?wbhEHbbY~D|SoELa|NsAI&YW>^abZ9Oia%Kx85sUE=zxSlY8{y8bL_hF&*0R{
zroCk>Ys=ryW^apR<6F_0=yZD>(}r^;x%VsNj#Rz>Z!O(l7BsPM@x+&tKV6C0qFCT{
z)ic~T)weS%tbF}V(ZeF5`gbCyABpUaWt#EE`}@5|{yXZ<zyJNep`o~>r6jqv!>+xv
zCo!oxLf$G<HNK!fT2W@|?5P=f899scr;B&z%w3qiFhzAzlukfVPsj#?iWysWSuEeZ
JkBO7P8UP@bTay3)

diff --git a/lib/win32com/HTML/image/BTN_PrevPage.gif b/lib/win32com/HTML/image/BTN_PrevPage.gif
deleted file mode 100644
index 955eae6c307d6559694540c8e288969f1ed0bd90..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 216
zcmZ?wbhEHbbY~D|SoELa|NsAI&YW>^abZ9Oia%Kx85sUE=zxSlY8{y8a_qYE&*0R{
zrmafPPaprfK%8fhMcI7Uy4M*+jSL4$a_?8HJHA=>&4C3I!Y^NmTYipvX2`TC-B~#v
zYuT1x;_Ve#S~S!7jqBo8#pyAj!MSl$W9}BN&se*;?8%<G^Y4HEZzwKnE=_7_Pi&G&
z?dUCv?9t4Ln-tbo<({cGDL;Ld=G@8MU50MaX&Nh5&GA&QXzRA`b51bWuzAO}B|G;p
IaWYr~03X3y`2YX_

diff --git a/lib/win32com/HTML/image/blank.gif b/lib/win32com/HTML/image/blank.gif
deleted file mode 100644
index a58ecfec72dd68f9c3d9a9ecba35c05db442bc8d..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 864
zcmZ?wbhEHbbY~D|`2L^az<~n{qhK@yMrsHs{$ybU`CSJ@fbxU`hb;pmhm6OD1qYis
zgtcN$Y*=`>T|n7uj>pDDN4q7Av+kVOxcGR#f^(OQ=cXkmCu;<+iaEJy>FMbP$*1O2
J8Y(bY0|3G!By<1(

diff --git a/lib/win32com/HTML/image/pycom_blowing.gif b/lib/win32com/HTML/image/pycom_blowing.gif
deleted file mode 100644
index 0d65a2928962860cf8b675b5192a43b165f31350..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 20926
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
Ab^rhX

diff --git a/lib/win32com/HTML/image/pythoncom.gif b/lib/win32com/HTML/image/pythoncom.gif
deleted file mode 100644
index 6b5020a1d7de11d55f66cf6713bde897898e1f8e..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 5767
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

diff --git a/lib/win32com/HTML/image/www_icon.gif b/lib/win32com/HTML/image/www_icon.gif
deleted file mode 100644
index 4239d2c3111ddbdf914bde329ee6e11e65038676..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 275
zcmZ?wbhEHb)L_tHIK%(~`}XZ)n8EP;`Ev$_|6l<Sq4<-9k%57cK?lSEsbyfkA+hVu
zKZ8@AtM^*GKD#^KL8EQHvQS1>SL%v=`X?C;6z`Za=9tuQ@4U_D{9Cfn^znvEn`L|V
z%|Cak#BQSIi=ZH0ro}6DmzYZ|IK^VZ*XuWX`JK<VedA}}F8L8LFKPDM%E}~OlZukI
zI<1Ump4R;G3GEa6(|Qyp&FGxP%ruRwZ|3Ahd2<W%QdcZrQMY=|Qo)q96Q*ol?IgUh
zHZ#(^ymsBZ>6TjVfd>yA4vUC9u5daqNPoT0MbGovk_^}Pn4aa2y>wTW;eq87-6zkU
XtM)#5_xjDpPoKYh{r3GMCxbNr)TwuZ

diff --git a/lib/win32com/HTML/index.html b/lib/win32com/HTML/index.html
deleted file mode 100644
index 2ab0176a..00000000
--- a/lib/win32com/HTML/index.html
+++ /dev/null
@@ -1,31 +0,0 @@
-<HTML>
-<HEAD>
-<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=windows-1252">
-<META NAME="Generator" CONTENT="Microsoft Word 97">
-<TITLE>win32com</TITLE>
-<META NAME="Template" CONTENT="C:\Program Files\Microsoft Office\Office\html.dot">
-</HEAD>
-<BODY TEXT="#000000" LINK="#0000ff" VLINK="#0000ff">
-<DIR>
-
-<P><!-- Enclose the entire page in UL, so bullets don't indent. --></P>
-<H1><IMG SRC="image/pycom_blowing.gif" WIDTH=549 HEIGHT=99></H1>
-<H2>Python and COM</H2>
-<H3>Introduction</H3>
-<P>Python has an excellent interface to COM (also known variously as OLE2, ActiveX, etc).</P>
-<P>The Python COM package can be used to interface to almost any COM program (such as the MS-Office suite), write servers that can be hosted by any COM client (such as Visual Basic or C++), and has even been used to provide the core ActiveX Scripting Support. </P>
-
-
-<UL>
-<LI>Note that win32com is now released in the win32all installation package. The <A HREF="../win32all/win32all.exe">installation EXE can be downloaded</A>, or you <A HREF="../win32all/">can jump to the win32all readme</A> for more details. </LI>
-<LI>Here is the <A HREF="win32com_src.zip">win32com source code</A> in a zip file. </LI></UL>
-</DIR>
-<DIR>
-
-<H3>Documentation</H3>
-<P><A HREF="ActiveXScripting.html">Preliminary Active Scripting and Debugging documentation</A> is available.</P>
-<P>2 Quick-Start guides have been provided, which also contain other links. See the <A HREF="QuickStartClientCom.html">Quick Start for Client side COM</A> and the <A HREF="QuickStartServerCom.html">Quick Start for Server side COM</A> </P>
-</P></DIR>
-</DIR>
-</BODY>
-</HTML>
diff --git a/lib/win32com/HTML/misc.html b/lib/win32com/HTML/misc.html
deleted file mode 100644
index 4374d221..00000000
--- a/lib/win32com/HTML/misc.html
+++ /dev/null
@@ -1,18 +0,0 @@
-<HTML>
-<HEAD>
-<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=windows-1252">
-<META NAME="Generator" CONTENT="Microsoft Word 97">
-<TITLE>Misc win32com Stuff</TITLE>
-<META NAME="Version" CONTENT="8.0.3410">
-<META NAME="Date" CONTENT="10/11/96">
-<META NAME="Template" CONTENT="D:\Program Files\Microsoft Office\Office\HTML.DOT">
-</HEAD>
-<BODY TEXT="#000000" BGCOLOR="#ffffff">
-
-<H1>Misc stuff I don�t know where to put anywhere else</H1>
-<H4>Client Side Dispatch</H4>
-<P>Using win32com.client.Dispatch automatically invokes all the win32com client side "smarts", including automatic usage of generated .py files etc.</P>
-<P>If you wish to avoid that, and use truly "dynamic" objects (ie, there is generated .py support available, but you wish to avoid it), you can use win32com.client.dynamic.Dispatch</P>
-<B><P>_print_details_() method</B><BR>
-If win32com.client.dynamic.Dispatch is used, the objects have a _print_details_() method available, which prints all relevant knowledge about an object (for example, all methods and properties). For objects that do not expose runtime type information, _print_details_ may not list anything.</P></BODY>
-</HTML>
diff --git a/lib/win32com/HTML/package.html b/lib/win32com/HTML/package.html
deleted file mode 100644
index e98f0875..00000000
--- a/lib/win32com/HTML/package.html
+++ /dev/null
@@ -1,37 +0,0 @@
-<HTML>
-<HEAD>
-<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=windows-1252">
-<META NAME="Generator" CONTENT="Microsoft Word 97">
-<TITLE>The win32com package</TITLE>
-<META NAME="Template" CONTENT="D:\Program Files\Microsoft Office\Office\html.dot">
-</HEAD>
-<BODY LINK="#0000ff" VLINK="#800080">
-
-<H1><IMG SRC="image/pycom_blowing.gif" WIDTH=549 HEIGHT=99 ALT="Python and COM - Blowing the others away"></H1>
-<H1>The win32com package </H1>
-<FONT SIZE=2><P>This document describes the win32com package in general terms.</FONT> </P>
-<FONT SIZE=2><P>The COM support can be thought of as existing in 2 main portions - the C++ support code (the core PythonCOM module), and helper code, implemented in Python. The total package is known as "win32com".</FONT> </P>
-<FONT SIZE=2><P>The win32com support is stand-alone. It does not require Pythonwin.</FONT> </P>
-<H2>The win32com package </H2>
-<FONT SIZE=2><P>To facilitate an orderly framework, the Python "ni" module has been used, and the entire package is known as "win32com". As is normal for such packages, win32com itself does not provide any functionality. Some of the modules are described below:</FONT> </P>
-
-<UL>
-<B><FONT SIZE=2><LI>win32com.pythoncom - core C++ support</B>. <BR>
-This module is rarely used directly by programmers - instead the other "helper" module are used, which themselves draw on the core pythoncom services.</FONT> </LI>
-<B><FONT SIZE=2><LI>win32com.client package<BR>
-</B>Support for COM clients used by Python. Some of the modules in this package allow for dynamic usage of COM clients, a module for generating .py files for certain COM servers, etc.</FONT> </LI>
-<B><FONT SIZE=2><LI>win32com.server package<BR>
-</B>Support for COM servers written in Python. The modules in this package provide most of the underlying framework for magically turning Python classes into COM servers, exposing the correct public methods, registering your server in the registry, etc. </LI>
-<B><LI>win32com.axscript<BR>
-</B>ActiveX Scripting implementation for Python.</FONT> </LI>
-<B><FONT SIZE=2><LI>win32com.axdebug<BR>
-</B>Active Debugging implementation for Python</FONT> </LI>
-<B><FONT SIZE=2><LI>win32com.mapi<BR>
-</B>Utilities for working with MAPI and the Microsoft Exchange Server</LI></UL>
-
-</FONT><P>&nbsp;</P>
-<H2>The pythoncom module </H2>
-<FONT SIZE=2><P>The pythoncom module is the underlying C++ support for all COM related objects. In general, Python programmers will not use this module directly, but use win32com helper classes and functions. </P>
-<P>This module exposes a C++ like interface to COM - there are objects implemented in pythoncom that have methods "QueryInterface()", "Invoke()", just like the C++ API. If you are using COM in C++, you would not call a method directly, you would use pObject-&gt;Invoke( �, MethodId, argArray�). Similarly, if you are using pythoncom directly, you must also use the Invoke method to call an object's exposed method.</FONT> </P>
-<FONT SIZE=2><P>There are some Python wrappers for hiding this raw interface, meaning you should almost never need to use the pythoncom module directly. These helpers translate a "natural" looking interface (eg, obj.SomeMethod()) into the underlying Invoke call.</P></FONT></BODY>
-</HTML>
diff --git a/lib/win32com/HTML/variant.html b/lib/win32com/HTML/variant.html
deleted file mode 100644
index 2631203e..00000000
--- a/lib/win32com/HTML/variant.html
+++ /dev/null
@@ -1,162 +0,0 @@
-<HTML>
-<HEAD>
-    <TITLE>win32com.client.VARIANT</TITLE>
-</HEAD>
-<BODY>
-
-<H2>Introduction</H2>
-<p>
-win32com attempts to provide a seamless COM interface and hide many COM 
-implementation details, including the use of COM VARIANT structures.  This 
-means that in most cases, you just call a COM object using normal Python 
-objects as parameters and get back normal Python objects as results.
-</p>
-
-<p>
-However, in some cases this doesn't work very well, particularly when using
-"dynamic" (aka late-bound) objects, or when using "makepy" (aka early-bound)
-objects which only declare a parameter is a VARIANT.
-</p>
-
-<p>
-The <code>win32com.client.VARIANT</code> object is designed to overcome these 
-problems.
-</p>
-
-<h2>Drawbacks</h2>
-The primary issue with this approach is that the programmer must learn more 
-about COM VARIANTs than otherwise - they need to know concepts such as 
-variants being <em>byref</em>, holding arrays, or that some may hold 32bit 
-unsigned integers while others hold 64bit signed ints, and they need to 
-understand this in the context of a single method call.  In short, this is
-a relatively advanced feature.  The good news though is that use of these
-objects should never cause your program to hard-crash - the worst you should
-expect are Python or COM exceptions being thrown.
-
-<h2>The VARIANT object</h2>
-
-The VARIANT object lives in <code>win32com.client</code>.  The constructor 
-takes 2 parameters - the 'variant type' and the value.  The 'variant type' is 
-an integer and can be one or more of the <code>pythoncom.VT_*</code> values,
-possibly or'd together.
-
-<p>For example, to create a VARIANT object which defines a byref array of 
-32bit integers, you could use:
-
-<pre>
->>> from win32com.client import VARIANT
->>> import pythoncom
->>> v = VARIANT(pythoncom.VT_BYREF | pythoncom.VT_ARRAY | pythoncom.VT_I4,
-...             [1,2,3,4])
->>> v
-win32com.client.VARIANT(24579, [1, 2, 3, 4])
->>>
-</pre>
-
-This variable can then be used whereever a COM VARIANT is expected.
-
-<h2>Example usage with dynamic objects.</h2>
-
-For this example we will use the COM object used for win32com testing, 
-<code>PyCOMTest.PyCOMTest</code>.  This object defines a method which is
-defined in IDL as:
-<pre>
-HRESULT DoubleInOutString([in,out] BSTR *str);
-</pre>
-
-As you can see, it takes a single string parameter which is also used as
-an "out" parameter - the single parameter will be updated after the call.
-The implementation of the method simply "doubles" the string.
-
-<p>If the object has a type-library, this method works fine with makepy
-generated support.  For example:
-
-<pre>
->>> from win32com.client.gencache import EnsureDispatch
->>> ob = EnsureDispatch("PyCOMTest.PyCOMTest")
->>> ob.DoubleInOutString("Hello")
-u'HelloHello'
->>>
-</pre>
-
-However, if makepy support is not available the method does not work as
-expected.  For the next example we will use <code>DumbDispatch</code> to
-simulate the object not having a type-library.
-
-<pre>
->>> import win32com.client.dynamic
->>> ob = win32com.client.dynamic.DumbDispatch("PyCOMTest.PyCOMTest")
->>> ob.DoubleInOutString("Hello")
->>>
-</pre>
-
-As you can see, no result came back from the function.  This is because
-win32com has no type information available to use, so doesn't know the
-parameter should be passed as a <code>byref</code> parameter.  To work
-around this, we can use the <code>VARIANT</code> object.
-
-<p>The following example explicitly creates a VARIANT object with a
-variant type of a byref string and a value 'Hello'.  After making the
-call with this VARIANT the value is updated.
-
-<pre>
->>> import win32com.client.dynamic
->>> from win32com.client import VARIANT
->>> import pythoncom
->>> ob = win32com.client.dynamic.DumbDispatch("PyCOMTest.PyCOMTest")
->>> variant = VARIANT(pythoncom.VT_BYREF | pythoncom.VT_BSTR, "Hello")
->>> variant.value # check the value before the call.
-'Hello'
->>> ob.DoubleInOutString(variant)
->>> variant.value
-u'HelloHello'
->>>
-</pre>
-
-<h2>Usage with generated objects</h2>
-
-In most cases, objects with makepy support (ie, 'generated' objects) don't 
-need to use the VARIANT object - the type information means win32com can guess
-the right thing to pass.  However, in some cases the VARIANT object can still
-be useful.
-
-Imagine a poorly specified object with IDL like:
-
-<pre>
-HRESULT DoSomething([in] VARIANT value);
-</pre>
-
-But also imagine that the object has a limitation that if the parameter is an 
-integer, it must be a 32bit unsigned value - any other integer representation
-will fail.
-
-<p>If you just pass a regular Python integer to this function, it will 
-generally be passed as a 32bit signed integer and given the limitation above,
-will fail.  The VARIANT object allows you to work around the limitation - just
-create a variant object <code>VARIANT(pythoncom.VT_UI4, int_value)</code> and 
-pass that - the function will then be called with the explicit type you 
-specified and will succeed.
-
-<p>Note that you can not use a VARIANT object to override the types described
-in a type library.  If a makepy generated class specifies that a VT_UI2 is 
-expected, attempting to pass a VARIANT object will fail.  In this case you 
-would need to hack around the problem.  For example, imagine <code>ob</code>
-was a COM object which a method called <code>foo</code> and you wanted to 
-override the type declaration for <code>foo</code> by passing a VARIANT.
-You could do something like:
-
-<pre>
->>> import win32com.client.dynamic
->>> from win32com.client import VARIANT
->>> import pythoncom
->>> dumbob = win32com.client.dynamic.DumbDispatch(ob)
->>> variant = VARIANT(pythoncom.VT_BYREF | pythoncom.VT_BSTR, "Hello")
->>> dumbob.foo(variant)
-</pre>
-
-The code above converts the makepy supported <code>ob</code> into a
-'dumb' (ie, non-makepy supported) version of the object, which will then
-allow you to use VARIANT objects for the problematic methods.
-
-</BODY>
-</HTML>
diff --git a/lib/win32com/License.txt b/lib/win32com/License.txt
deleted file mode 100644
index 6c1884e9..00000000
--- a/lib/win32com/License.txt
+++ /dev/null
@@ -1,30 +0,0 @@
-Unless stated in the specfic source file, this work is
-Copyright (c) 1996-2008, Greg Stein and Mark Hammond.
-All rights reserved.
-
-Redistribution and use in source and binary forms, with or without 
-modification, are permitted provided that the following conditions 
-are met:
-
-Redistributions of source code must retain the above copyright notice, 
-this list of conditions and the following disclaimer.
-
-Redistributions in binary form must reproduce the above copyright 
-notice, this list of conditions and the following disclaimer in 
-the documentation and/or other materials provided with the distribution.
-
-Neither names of Greg Stein, Mark Hammond nor the name of contributors may be used 
-to endorse or promote products derived from this software without 
-specific prior written permission. 
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS
-IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
-TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
-PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR
-CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
-EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
-PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
-PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
-NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
-SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 
diff --git a/lib/win32com/__init__.py b/lib/win32com/__init__.py
deleted file mode 100644
index 4832d9e1..00000000
--- a/lib/win32com/__init__.py
+++ /dev/null
@@ -1,132 +0,0 @@
-#
-# Initialization for the win32com package
-#
-
-import os
-import sys
-
-import pythoncom
-import win32api
-
-# flag if we are in a "frozen" build.
-_frozen = getattr(sys, "frozen", 1 == 0)
-# pythoncom dumbly defaults this to zero - we believe sys.frozen over it.
-if _frozen and not getattr(pythoncom, "frozen", 0):
-    pythoncom.frozen = sys.frozen
-
-# Add support for an external "COM Extensions" path.
-#  Concept is that you can register a seperate path to be used for
-#  COM extensions, outside of the win32com directory.  These modules, however,
-#  look identical to win32com built-in modules.
-#  This is the technique that we use for the "standard" COM extensions.
-#  eg "win32com.mapi" or "win32com.axscript" both work, even though they do not
-#  live under the main win32com directory.
-__gen_path__ = ""
-__build_path__ = None
-### TODO - Load _all_ \\Extensions subkeys - for now, we only read the default
-### Modules will work if loaded into "win32comext" path.
-
-
-def SetupEnvironment():
-    HKEY_LOCAL_MACHINE = -2147483646  # Avoid pulling in win32con for just these...
-    KEY_QUERY_VALUE = 0x1
-    # Open the root key once, as this is quite slow on NT.
-    try:
-        keyName = "SOFTWARE\\Python\\PythonCore\\%s\\PythonPath\\win32com" % sys.winver
-        key = win32api.RegOpenKey(HKEY_LOCAL_MACHINE, keyName, 0, KEY_QUERY_VALUE)
-    except (win32api.error, AttributeError):
-        key = None
-
-    try:
-        found = 0
-        if key is not None:
-            try:
-                __path__.append(win32api.RegQueryValue(key, "Extensions"))
-                found = 1
-            except win32api.error:
-                # Nothing registered
-                pass
-        if not found:
-            try:
-                __path__.append(
-                    win32api.GetFullPathName(__path__[0] + "\\..\\win32comext")
-                )
-            except win32api.error:
-                # Give up in disgust!
-                pass
-
-        # For the sake of developers, we also look up a "BuildPath" key
-        # If extension modules add support, we can load their .pyd's from a completely
-        # different directory (see the comments below)
-        try:
-            if key is not None:
-                global __build_path__
-                __build_path__ = win32api.RegQueryValue(key, "BuildPath")
-                __path__.append(__build_path__)
-        except win32api.error:
-            # __build_path__ neednt be defined.
-            pass
-        global __gen_path__
-        if key is not None:
-            try:
-                __gen_path__ = win32api.RegQueryValue(key, "GenPath")
-            except win32api.error:
-                pass
-    finally:
-        if key is not None:
-            key.Close()
-
-
-# A Helper for developers.  A sub-package's __init__ can call this help function,
-# which allows the .pyd files for the extension to live in a special "Build" directory
-# (which the win32com developers do!)
-def __PackageSupportBuildPath__(package_path):
-    # See if we have a special directory for the binaries (for developers)
-    if not _frozen and __build_path__:
-        package_path.append(__build_path__)
-
-
-if not _frozen:
-    SetupEnvironment()
-
-# If we don't have a special __gen_path__, see if we have a gen_py as a
-# normal module and use that (ie, "win32com.gen_py" may already exist as
-# a package.
-if not __gen_path__:
-    try:
-        import win32com.gen_py
-
-        # hrmph - 3.3 throws: TypeError: '_NamespacePath' object does not support indexing
-        # attempting to get __path__[0] - but I can't quickly repro this stand-alone.
-        # Work around it by using an iterator.
-        __gen_path__ = next(iter(sys.modules["win32com.gen_py"].__path__))
-    except ImportError:
-        # If a win32com\gen_py directory already exists, then we use it
-        # (gencache doesn't insist it have an __init__, but our __import__
-        # above does!
-        __gen_path__ = os.path.abspath(os.path.join(__path__[0], "gen_py"))
-        if not os.path.isdir(__gen_path__):
-            # We used to dynamically create a directory under win32com -
-            # but this sucks.  If the dir doesn't already exist, we we
-            # create a version specific directory under the user temp
-            # directory.
-            __gen_path__ = os.path.join(
-                win32api.GetTempPath(),
-                "gen_py",
-                "%d.%d" % (sys.version_info[0], sys.version_info[1]),
-            )
-
-# we must have a __gen_path__, but may not have a gen_py module -
-# set that up.
-if "win32com.gen_py" not in sys.modules:
-    # Create a "win32com.gen_py", but with a custom __path__
-    import types
-
-    gen_py = types.ModuleType("win32com.gen_py")
-    gen_py.__path__ = [__gen_path__]
-    sys.modules[gen_py.__name__] = gen_py
-    del types
-gen_py = sys.modules["win32com.gen_py"]
-
-# get rid of these for module users
-del os, sys, win32api, pythoncom
diff --git a/lib/win32com/client/CLSIDToClass.py b/lib/win32com/client/CLSIDToClass.py
deleted file mode 100644
index fde32743..00000000
--- a/lib/win32com/client/CLSIDToClass.py
+++ /dev/null
@@ -1,57 +0,0 @@
-"""Manages a dictionary of CLSID strings to Python classes.
-
-Primary use of this module is to allow modules generated by
-makepy.py to share classes.  @makepy@ automatically generates code
-which interacts with this module.  You should never need to reference
-this module directly.
-
-This module only provides support for modules which have been previously
-been imported.  The gencache module provides some support for loading modules
-on demand - once done, this module supports it...
-
-As an example, the MSACCESS.TLB type library makes reference to the
-CLSID of the Database object, as defined in DAO3032.DLL.  This
-allows code using the MSAccess wrapper to natively use Databases.
-
-This obviously applies to all cooperating objects, not just DAO and
-Access.
-"""
-mapCLSIDToClass = {}
-
-
-def RegisterCLSID(clsid, pythonClass):
-    """Register a class that wraps a CLSID
-
-    This function allows a CLSID to be globally associated with a class.
-    Certain module will automatically convert an IDispatch object to an
-    instance of the associated class.
-    """
-
-    mapCLSIDToClass[str(clsid)] = pythonClass
-
-
-def RegisterCLSIDsFromDict(dict):
-    """Register a dictionary of CLSID's and classes.
-
-    This module performs the same function as @RegisterCLSID@, but for
-    an entire dictionary of associations.
-
-    Typically called by makepy generated modules at import time.
-    """
-    mapCLSIDToClass.update(dict)
-
-
-def GetClass(clsid):
-    """Given a CLSID, return the globally associated class.
-
-    clsid -- a string CLSID representation to check.
-    """
-    return mapCLSIDToClass[clsid]
-
-
-def HasClass(clsid):
-    """Determines if the CLSID has an associated class.
-
-    clsid -- the string CLSID to check
-    """
-    return clsid in mapCLSIDToClass
diff --git a/lib/win32com/client/__init__.py b/lib/win32com/client/__init__.py
deleted file mode 100644
index 91b4b303..00000000
--- a/lib/win32com/client/__init__.py
+++ /dev/null
@@ -1,714 +0,0 @@
-# This module exists to create the "best" dispatch object for a given
-# object.  If "makepy" support for a given object is detected, it is
-# used, otherwise a dynamic dispatch object.
-
-# Note that if the unknown dispatch object then returns a known
-# dispatch object, the known class will be used.  This contrasts
-# with dynamic.Dispatch behaviour, where dynamic objects are always used.
-
-import sys
-
-import pythoncom
-import pywintypes
-
-from . import dynamic, gencache
-
-_PyIDispatchType = pythoncom.TypeIIDs[pythoncom.IID_IDispatch]
-
-
-def __WrapDispatch(
-    dispatch,
-    userName=None,
-    resultCLSID=None,
-    typeinfo=None,
-    UnicodeToString=None,
-    clsctx=pythoncom.CLSCTX_SERVER,
-    WrapperClass=None,
-):
-    """
-    Helper function to return a makepy generated class for a CLSID if it exists,
-    otherwise cope by using CDispatch.
-    """
-    assert UnicodeToString is None, "this is deprecated and will go away"
-    if resultCLSID is None:
-        try:
-            typeinfo = dispatch.GetTypeInfo()
-            if (
-                typeinfo is not None
-            ):  # Some objects return NULL, some raise exceptions...
-                resultCLSID = str(typeinfo.GetTypeAttr()[0])
-        except (pythoncom.com_error, AttributeError):
-            pass
-    if resultCLSID is not None:
-        from . import gencache
-
-        # Attempt to load generated module support
-        # This may load the module, and make it available
-        klass = gencache.GetClassForCLSID(resultCLSID)
-        if klass is not None:
-            return klass(dispatch)
-
-    # Return a "dynamic" object - best we can do!
-    if WrapperClass is None:
-        WrapperClass = CDispatch
-    return dynamic.Dispatch(dispatch, userName, WrapperClass, typeinfo, clsctx=clsctx)
-
-
-def GetObject(Pathname=None, Class=None, clsctx=None):
-    """
-    Mimic VB's GetObject() function.
-
-    ob = GetObject(Class = "ProgID") or GetObject(Class = clsid) will
-    connect to an already running instance of the COM object.
-
-    ob = GetObject(r"c:\blah\blah\foo.xls") (aka the COM moniker syntax)
-    will return a ready to use Python wrapping of the required COM object.
-
-    Note: You must specifiy one or the other of these arguments. I know
-    this isn't pretty, but it is what VB does. Blech. If you don't
-    I'll throw ValueError at you. :)
-
-    This will most likely throw pythoncom.com_error if anything fails.
-    """
-    if clsctx is None:
-        clsctx = pythoncom.CLSCTX_ALL
-
-    if (Pathname is None and Class is None) or (
-        Pathname is not None and Class is not None
-    ):
-        raise ValueError(
-            "You must specify a value for Pathname or Class, but not both."
-        )
-
-    if Class is not None:
-        return GetActiveObject(Class, clsctx)
-    else:
-        return Moniker(Pathname, clsctx)
-
-
-def GetActiveObject(Class, clsctx=pythoncom.CLSCTX_ALL):
-    """
-    Python friendly version of GetObject's ProgID/CLSID functionality.
-    """
-    resultCLSID = pywintypes.IID(Class)
-    dispatch = pythoncom.GetActiveObject(resultCLSID)
-    dispatch = dispatch.QueryInterface(pythoncom.IID_IDispatch)
-    return __WrapDispatch(dispatch, Class, resultCLSID=resultCLSID, clsctx=clsctx)
-
-
-def Moniker(Pathname, clsctx=pythoncom.CLSCTX_ALL):
-    """
-    Python friendly version of GetObject's moniker functionality.
-    """
-    moniker, i, bindCtx = pythoncom.MkParseDisplayName(Pathname)
-    dispatch = moniker.BindToObject(bindCtx, None, pythoncom.IID_IDispatch)
-    return __WrapDispatch(dispatch, Pathname, clsctx=clsctx)
-
-
-def Dispatch(
-    dispatch,
-    userName=None,
-    resultCLSID=None,
-    typeinfo=None,
-    UnicodeToString=None,
-    clsctx=pythoncom.CLSCTX_SERVER,
-):
-    """Creates a Dispatch based COM object."""
-    assert UnicodeToString is None, "this is deprecated and will go away"
-    dispatch, userName = dynamic._GetGoodDispatchAndUserName(dispatch, userName, clsctx)
-    return __WrapDispatch(dispatch, userName, resultCLSID, typeinfo, clsctx=clsctx)
-
-
-def DispatchEx(
-    clsid,
-    machine=None,
-    userName=None,
-    resultCLSID=None,
-    typeinfo=None,
-    UnicodeToString=None,
-    clsctx=None,
-):
-    """Creates a Dispatch based COM object on a specific machine."""
-    assert UnicodeToString is None, "this is deprecated and will go away"
-    # If InProc is registered, DCOM will use it regardless of the machine name
-    # (and regardless of the DCOM config for the object.)  So unless the user
-    # specifies otherwise, we exclude inproc apps when a remote machine is used.
-    if clsctx is None:
-        clsctx = pythoncom.CLSCTX_SERVER
-        if machine is not None:
-            clsctx = clsctx & ~pythoncom.CLSCTX_INPROC
-    if machine is None:
-        serverInfo = None
-    else:
-        serverInfo = (machine,)
-    if userName is None:
-        userName = clsid
-    dispatch = pythoncom.CoCreateInstanceEx(
-        clsid, None, clsctx, serverInfo, (pythoncom.IID_IDispatch,)
-    )[0]
-    return Dispatch(dispatch, userName, resultCLSID, typeinfo, clsctx=clsctx)
-
-
-class CDispatch(dynamic.CDispatch):
-    """
-    The dynamic class used as a last resort.
-    The purpose of this overriding of dynamic.CDispatch is to perpetuate the policy
-    of using the makepy generated wrapper Python class instead of dynamic.CDispatch
-    if/when possible.
-    """
-
-    def _wrap_dispatch_(
-        self, ob, userName=None, returnCLSID=None, UnicodeToString=None
-    ):
-        assert UnicodeToString is None, "this is deprecated and will go away"
-        return Dispatch(ob, userName, returnCLSID, None)
-
-    def __dir__(self):
-        return dynamic.CDispatch.__dir__(self)
-
-
-def CastTo(ob, target, typelib=None):
-    """'Cast' a COM object to another interface"""
-    # todo - should support target being an IID
-    mod = None
-    if (
-        typelib is not None
-    ):  # caller specified target typelib (TypelibSpec). See e.g. selecttlb.EnumTlbs().
-        mod = gencache.MakeModuleForTypelib(
-            typelib.clsid, typelib.lcid, int(typelib.major, 16), int(typelib.minor, 16)
-        )
-        if not hasattr(mod, target):
-            raise ValueError(
-                "The interface name '%s' does not appear in the "
-                "specified library %r" % (target, typelib.ver_desc)
-            )
-
-    elif hasattr(target, "index"):  # string like
-        # for now, we assume makepy for this to work.
-        if "CLSID" not in ob.__class__.__dict__:
-            # Eeek - no makepy support - try and build it.
-            ob = gencache.EnsureDispatch(ob)
-        if "CLSID" not in ob.__class__.__dict__:
-            raise ValueError("Must be a makepy-able object for this to work")
-        clsid = ob.CLSID
-        # Lots of hoops to support "demand-build" - ie, generating
-        # code for an interface first time it is used.  We assume the
-        # interface name exists in the same library as the object.
-        # This is generally the case - only referenced typelibs may be
-        # a problem, and we can handle that later.  Maybe <wink>
-        # So get the generated module for the library itself, then
-        # find the interface CLSID there.
-        mod = gencache.GetModuleForCLSID(clsid)
-        # Get the 'root' module.
-        mod = gencache.GetModuleForTypelib(
-            mod.CLSID, mod.LCID, mod.MajorVersion, mod.MinorVersion
-        )
-        # Find the CLSID of the target
-        target_clsid = mod.NamesToIIDMap.get(target)
-        if target_clsid is None:
-            raise ValueError(
-                "The interface name '%s' does not appear in the "
-                "same library as object '%r'" % (target, ob)
-            )
-        mod = gencache.GetModuleForCLSID(target_clsid)
-    if mod is not None:
-        target_class = getattr(mod, target)
-        # resolve coclass to interface
-        target_class = getattr(target_class, "default_interface", target_class)
-        return target_class(ob)  # auto QI magic happens
-    raise ValueError
-
-
-class Constants:
-    """A container for generated COM constants."""
-
-    def __init__(self):
-        self.__dicts__ = []  # A list of dictionaries
-
-    def __getattr__(self, a):
-        for d in self.__dicts__:
-            if a in d:
-                return d[a]
-        raise AttributeError(a)
-
-
-# And create an instance.
-constants = Constants()
-
-
-# A helpers for DispatchWithEvents - this becomes __setattr__ for the
-# temporary class.
-def _event_setattr_(self, attr, val):
-    try:
-        # Does the COM object have an attribute of this name?
-        self.__class__.__bases__[0].__setattr__(self, attr, val)
-    except AttributeError:
-        # Otherwise just stash it away in the instance.
-        self.__dict__[attr] = val
-
-
-# An instance of this "proxy" is created to break the COM circular references
-# that exist (ie, when we connect to the COM events, COM keeps a reference
-# to the object.  Thus, the Event connection must be manually broken before
-# our object can die.  This solves the problem by manually breaking the connection
-# to the real object as the proxy dies.
-class EventsProxy:
-    def __init__(self, ob):
-        self.__dict__["_obj_"] = ob
-
-    def __del__(self):
-        try:
-            # If there is a COM error on disconnection we should
-            # just ignore it - object probably already shut down...
-            self._obj_.close()
-        except pythoncom.com_error:
-            pass
-
-    def __getattr__(self, attr):
-        return getattr(self._obj_, attr)
-
-    def __setattr__(self, attr, val):
-        setattr(self._obj_, attr, val)
-
-
-def DispatchWithEvents(clsid, user_event_class):
-    """Create a COM object that can fire events to a user defined class.
-    clsid -- The ProgID or CLSID of the object to create.
-    user_event_class -- A Python class object that responds to the events.
-
-    This requires makepy support for the COM object being created.  If
-    this support does not exist it will be automatically generated by
-    this function.  If the object does not support makepy, a TypeError
-    exception will be raised.
-
-    The result is a class instance that both represents the COM object
-    and handles events from the COM object.
-
-    It is important to note that the returned instance is not a direct
-    instance of the user_event_class, but an instance of a temporary
-    class object that derives from three classes:
-    * The makepy generated class for the COM object
-    * The makepy generated class for the COM events
-    * The user_event_class as passed to this function.
-
-    If this is not suitable, see the getevents function for an alternative
-    technique of handling events.
-
-    Object Lifetimes:  Whenever the object returned from this function is
-    cleaned-up by Python, the events will be disconnected from
-    the COM object.  This is almost always what should happen,
-    but see the documentation for getevents() for more details.
-
-    Example:
-
-    >>> class IEEvents:
-    ...    def OnVisible(self, visible):
-    ...       print "Visible changed:", visible
-    ...
-    >>> ie = DispatchWithEvents("InternetExplorer.Application", IEEvents)
-    >>> ie.Visible = 1
-    Visible changed: 1
-    >>>
-    """
-    # Create/Get the object.
-    disp = Dispatch(clsid)
-    if not disp.__class__.__dict__.get(
-        "CLSID"
-    ):  # Eeek - no makepy support - try and build it.
-        try:
-            ti = disp._oleobj_.GetTypeInfo()
-            disp_clsid = ti.GetTypeAttr()[0]
-            tlb, index = ti.GetContainingTypeLib()
-            tla = tlb.GetLibAttr()
-            gencache.EnsureModule(tla[0], tla[1], tla[3], tla[4], bValidateFile=0)
-            # Get the class from the module.
-            disp_class = gencache.GetClassForProgID(str(disp_clsid))
-        except pythoncom.com_error:
-            raise TypeError(
-                "This COM object can not automate the makepy process - please run makepy manually for this object"
-            )
-    else:
-        disp_class = disp.__class__
-    # If the clsid was an object, get the clsid
-    clsid = disp_class.CLSID
-    # Create a new class that derives from 3 classes - the dispatch class, the event sink class and the user class.
-    # XXX - we are still "classic style" classes in py2x, so we need can't yet
-    # use 'type()' everywhere - revisit soon, as py2x will move to new-style too...
-    try:
-        from types import ClassType as new_type
-    except ImportError:
-        new_type = type  # py3k
-    events_class = getevents(clsid)
-    if events_class is None:
-        raise ValueError("This COM object does not support events.")
-    result_class = new_type(
-        "COMEventClass",
-        (disp_class, events_class, user_event_class),
-        {"__setattr__": _event_setattr_},
-    )
-    instance = result_class(
-        disp._oleobj_
-    )  # This only calls the first base class __init__.
-    events_class.__init__(instance, instance)
-    if hasattr(user_event_class, "__init__"):
-        user_event_class.__init__(instance)
-    return EventsProxy(instance)
-
-
-def WithEvents(disp, user_event_class):
-    """Similar to DispatchWithEvents - except that the returned
-    object is *not* also usable as the original Dispatch object - that is
-    the returned object is not dispatchable.
-
-    The difference is best summarised by example.
-
-    >>> class IEEvents:
-    ...    def OnVisible(self, visible):
-    ...       print "Visible changed:", visible
-    ...
-    >>> ie = Dispatch("InternetExplorer.Application")
-    >>> ie_events = WithEvents(ie, IEEvents)
-    >>> ie.Visible = 1
-    Visible changed: 1
-
-    Compare with the code sample for DispatchWithEvents, where you get a
-    single object that is both the interface and the event handler.  Note that
-    the event handler instance will *not* be able to use 'self.' to refer to
-    IE's methods and properties.
-
-    This is mainly useful where using DispatchWithEvents causes
-    circular reference problems that the simple proxy doesn't deal with
-    """
-    disp = Dispatch(disp)
-    if not disp.__class__.__dict__.get(
-        "CLSID"
-    ):  # Eeek - no makepy support - try and build it.
-        try:
-            ti = disp._oleobj_.GetTypeInfo()
-            disp_clsid = ti.GetTypeAttr()[0]
-            tlb, index = ti.GetContainingTypeLib()
-            tla = tlb.GetLibAttr()
-            gencache.EnsureModule(tla[0], tla[1], tla[3], tla[4], bValidateFile=0)
-            # Get the class from the module.
-            disp_class = gencache.GetClassForProgID(str(disp_clsid))
-        except pythoncom.com_error:
-            raise TypeError(
-                "This COM object can not automate the makepy process - please run makepy manually for this object"
-            )
-    else:
-        disp_class = disp.__class__
-    # Get the clsid
-    clsid = disp_class.CLSID
-    # Create a new class that derives from 2 classes - the event sink
-    # class and the user class.
-    try:
-        from types import ClassType as new_type
-    except ImportError:
-        new_type = type  # py3k
-    events_class = getevents(clsid)
-    if events_class is None:
-        raise ValueError("This COM object does not support events.")
-    result_class = new_type("COMEventClass", (events_class, user_event_class), {})
-    instance = result_class(disp)  # This only calls the first base class __init__.
-    if hasattr(user_event_class, "__init__"):
-        user_event_class.__init__(instance)
-    return instance
-
-
-def getevents(clsid):
-    """Determine the default outgoing interface for a class, given
-    either a clsid or progid. It returns a class - you can
-    conveniently derive your own handler from this class and implement
-    the appropriate methods.
-
-    This method relies on the classes produced by makepy. You must use
-    either makepy or the gencache module to ensure that the
-    appropriate support classes have been generated for the com server
-    that you will be handling events from.
-
-    Beware of COM circular references.  When the Events class is connected
-    to the COM object, the COM object itself keeps a reference to the Python
-    events class.  Thus, neither the Events instance or the COM object will
-    ever die by themselves.  The 'close' method on the events instance
-    must be called to break this chain and allow standard Python collection
-    rules to manage object lifetimes.  Note that DispatchWithEvents() does
-    work around this problem by the use of a proxy object, but if you use
-    the getevents() function yourself, you must make your own arrangements
-    to manage this circular reference issue.
-
-    Beware of creating Python circular references: this will happen if your
-    handler has a reference to an object that has a reference back to
-    the event source. Call the 'close' method to break the chain.
-
-    Example:
-
-    >>>win32com.client.gencache.EnsureModule('{EAB22AC0-30C1-11CF-A7EB-0000C05BAE0B}',0,1,1)
-    <module 'win32com.gen_py.....
-    >>>
-    >>> class InternetExplorerEvents(win32com.client.getevents("InternetExplorer.Application.1")):
-    ...    def OnVisible(self, Visible):
-    ...        print "Visibility changed: ", Visible
-    ...
-    >>>
-    >>> ie=win32com.client.Dispatch("InternetExplorer.Application.1")
-    >>> events=InternetExplorerEvents(ie)
-    >>> ie.Visible=1
-    Visibility changed:  1
-    >>>
-    """
-
-    # find clsid given progid or clsid
-    clsid = str(pywintypes.IID(clsid))
-    # return default outgoing interface for that class
-    klass = gencache.GetClassForCLSID(clsid)
-    try:
-        return klass.default_source
-    except AttributeError:
-        # See if we have a coclass for the interfaces.
-        try:
-            return gencache.GetClassForCLSID(klass.coclass_clsid).default_source
-        except AttributeError:
-            return None
-
-
-# A Record object, as used by the COM struct support
-def Record(name, object):
-    """Creates a new record object, given the name of the record,
-    and an object from the same type library.
-
-    Example usage would be:
-      app = win32com.client.Dispatch("Some.Application")
-      point = win32com.client.Record("SomeAppPoint", app)
-      point.x = 0
-      point.y = 0
-      app.MoveTo(point)
-    """
-    # XXX - to do - probably should allow "object" to already be a module object.
-    from . import gencache
-
-    object = gencache.EnsureDispatch(object)
-    module = sys.modules[object.__class__.__module__]
-    # to allow us to work correctly with "demand generated" code,
-    # we must use the typelib CLSID to obtain the module
-    # (otherwise we get the sub-module for the object, which
-    # does not hold the records)
-    # thus, package may be module, or may be module's parent if demand generated.
-    package = gencache.GetModuleForTypelib(
-        module.CLSID, module.LCID, module.MajorVersion, module.MinorVersion
-    )
-    try:
-        struct_guid = package.RecordMap[name]
-    except KeyError:
-        raise ValueError(
-            "The structure '%s' is not defined in module '%s'" % (name, package)
-        )
-    return pythoncom.GetRecordFromGuids(
-        module.CLSID, module.MajorVersion, module.MinorVersion, module.LCID, struct_guid
-    )
-
-
-############################################
-# The base of all makepy generated classes
-############################################
-class DispatchBaseClass:
-    def __init__(self, oobj=None):
-        if oobj is None:
-            oobj = pythoncom.new(self.CLSID)
-        elif isinstance(oobj, DispatchBaseClass):
-            try:
-                oobj = oobj._oleobj_.QueryInterface(
-                    self.CLSID, pythoncom.IID_IDispatch
-                )  # Must be a valid COM instance
-            except pythoncom.com_error as details:
-                import winerror
-
-                # Some stupid objects fail here, even tho it is _already_ IDispatch!!??
-                # Eg, Lotus notes.
-                # So just let it use the existing object if E_NOINTERFACE
-                if details.hresult != winerror.E_NOINTERFACE:
-                    raise
-                oobj = oobj._oleobj_
-        self.__dict__["_oleobj_"] = oobj  # so we dont call __setattr__
-
-    def __dir__(self):
-        lst = (
-            list(self.__dict__.keys())
-            + dir(self.__class__)
-            + list(self._prop_map_get_.keys())
-            + list(self._prop_map_put_.keys())
-        )
-        try:
-            lst += [p.Name for p in self.Properties_]
-        except AttributeError:
-            pass
-        return list(set(lst))
-
-    # Provide a prettier name than the CLSID
-    def __repr__(self):
-        # Need to get the docstring for the module for this class.
-        try:
-            mod_doc = sys.modules[self.__class__.__module__].__doc__
-            if mod_doc:
-                mod_name = "win32com.gen_py." + mod_doc
-            else:
-                mod_name = sys.modules[self.__class__.__module__].__name__
-        except KeyError:
-            mod_name = "win32com.gen_py.unknown"
-        return "<%s.%s instance at 0x%s>" % (
-            mod_name,
-            self.__class__.__name__,
-            id(self),
-        )
-
-    # Delegate comparison to the oleobjs, as they know how to do identity.
-    def __eq__(self, other):
-        other = getattr(other, "_oleobj_", other)
-        return self._oleobj_ == other
-
-    def __ne__(self, other):
-        other = getattr(other, "_oleobj_", other)
-        return self._oleobj_ != other
-
-    def _ApplyTypes_(self, dispid, wFlags, retType, argTypes, user, resultCLSID, *args):
-        return self._get_good_object_(
-            self._oleobj_.InvokeTypes(dispid, 0, wFlags, retType, argTypes, *args),
-            user,
-            resultCLSID,
-        )
-
-    def __getattr__(self, attr):
-        args = self._prop_map_get_.get(attr)
-        if args is None:
-            raise AttributeError(
-                "'%s' object has no attribute '%s'" % (repr(self), attr)
-            )
-        return self._ApplyTypes_(*args)
-
-    def __setattr__(self, attr, value):
-        if attr in self.__dict__:
-            self.__dict__[attr] = value
-            return
-        try:
-            args, defArgs = self._prop_map_put_[attr]
-        except KeyError:
-            raise AttributeError(
-                "'%s' object has no attribute '%s'" % (repr(self), attr)
-            )
-        self._oleobj_.Invoke(*(args + (value,) + defArgs))
-
-    def _get_good_single_object_(self, obj, obUserName=None, resultCLSID=None):
-        return _get_good_single_object_(obj, obUserName, resultCLSID)
-
-    def _get_good_object_(self, obj, obUserName=None, resultCLSID=None):
-        return _get_good_object_(obj, obUserName, resultCLSID)
-
-
-# XXX - These should be consolidated with dynamic.py versions.
-def _get_good_single_object_(obj, obUserName=None, resultCLSID=None):
-    if _PyIDispatchType == type(obj):
-        return Dispatch(obj, obUserName, resultCLSID)
-    return obj
-
-
-def _get_good_object_(obj, obUserName=None, resultCLSID=None):
-    if obj is None:
-        return None
-    elif isinstance(obj, tuple):
-        obUserNameTuple = (obUserName,) * len(obj)
-        resultCLSIDTuple = (resultCLSID,) * len(obj)
-        return tuple(map(_get_good_object_, obj, obUserNameTuple, resultCLSIDTuple))
-    else:
-        return _get_good_single_object_(obj, obUserName, resultCLSID)
-
-
-class CoClassBaseClass:
-    def __init__(self, oobj=None):
-        if oobj is None:
-            oobj = pythoncom.new(self.CLSID)
-        dispobj = self.__dict__["_dispobj_"] = self.default_interface(oobj)
-        # See comments below re the special methods.
-        for maybe in [
-            "__call__",
-            "__str__",
-            "__int__",
-            "__iter__",
-            "__len__",
-            "__nonzero__",
-        ]:
-            if hasattr(dispobj, maybe):
-                setattr(self, maybe, getattr(self, "__maybe" + maybe))
-
-    def __repr__(self):
-        return "<win32com.gen_py.%s.%s>" % (__doc__, self.__class__.__name__)
-
-    def __getattr__(self, attr):
-        d = self.__dict__["_dispobj_"]
-        if d is not None:
-            return getattr(d, attr)
-        raise AttributeError(attr)
-
-    def __setattr__(self, attr, value):
-        if attr in self.__dict__:
-            self.__dict__[attr] = value
-            return
-        try:
-            d = self.__dict__["_dispobj_"]
-            if d is not None:
-                d.__setattr__(attr, value)
-                return
-        except AttributeError:
-            pass
-        self.__dict__[attr] = value
-
-        # Special methods don't use __getattr__ etc, so explicitly delegate here.
-        # Note however, that not all are safe to let bubble up - things like
-        # `bool(ob)` will break if the object defines __int__ but then raises an
-        # attribute error - eg, see #1753.
-        # It depends on what the wrapped COM object actually defines whether these
-        # will exist on the underlying object, so __init__ explicitly checks if they
-        # do and if so, wires them up.
-
-    def __maybe__call__(self, *args, **kwargs):
-        return self.__dict__["_dispobj_"].__call__(*args, **kwargs)
-
-    def __maybe__str__(self, *args):
-        return self.__dict__["_dispobj_"].__str__(*args)
-
-    def __maybe__int__(self, *args):
-        return self.__dict__["_dispobj_"].__int__(*args)
-
-    def __maybe__iter__(self):
-        return self.__dict__["_dispobj_"].__iter__()
-
-    def __maybe__len__(self):
-        return self.__dict__["_dispobj_"].__len__()
-
-    def __maybe__nonzero__(self):
-        return self.__dict__["_dispobj_"].__nonzero__()
-
-
-# A very simple VARIANT class.  Only to be used with poorly-implemented COM
-# objects.  If an object accepts an arg which is a simple "VARIANT", but still
-# is very pickly about the actual variant type (eg, isn't happy with a VT_I4,
-# which it would get from a Python integer), you can use this to force a
-# particular VT.
-class VARIANT(object):
-    def __init__(self, vt, value):
-        self.varianttype = vt
-        self._value = value
-
-    # 'value' is a property so when set by pythoncom it gets any magic wrapping
-    # which normally happens for result objects
-    def _get_value(self):
-        return self._value
-
-    def _set_value(self, newval):
-        self._value = _get_good_object_(newval)
-
-    def _del_value(self):
-        del self._value
-
-    value = property(_get_value, _set_value, _del_value)
-
-    def __repr__(self):
-        return "win32com.client.VARIANT(%r, %r)" % (self.varianttype, self._value)
diff --git a/lib/win32com/client/build.py b/lib/win32com/client/build.py
deleted file mode 100644
index ce4e2e4a..00000000
--- a/lib/win32com/client/build.py
+++ /dev/null
@@ -1,789 +0,0 @@
-"""Contains knowledge to build a COM object definition.
-
-This module is used by both the @dynamic@ and @makepy@ modules to build
-all knowledge of a COM object.
-
-This module contains classes which contain the actual knowledge of the object.
-This include parameter and return type information, the COM dispid and CLSID, etc.
-
-Other modules may use this information to generate .py files, use the information
-dynamically, or possibly even generate .html documentation for objects.
-"""
-
-#
-# NOTES: DispatchItem and MapEntry used by dynamic.py.
-#        the rest is used by makepy.py
-#
-#        OleItem, DispatchItem, MapEntry, BuildCallList() is used by makepy
-
-import datetime
-import string
-import sys
-from keyword import iskeyword
-
-import pythoncom
-import winerror
-from pywintypes import TimeType
-
-
-# It isn't really clear what the quoting rules are in a C/IDL string and
-# literals like a quote char and backslashes makes life a little painful to
-# always render the string perfectly - so just punt and fall-back to a repr()
-def _makeDocString(s):
-    if sys.version_info < (3,):
-        s = s.encode("mbcs")
-    return repr(s)
-
-
-error = "PythonCOM.Client.Build error"
-
-
-class NotSupportedException(Exception):
-    pass  # Raised when we cant support a param type.
-
-
-DropIndirection = "DropIndirection"
-
-NoTranslateTypes = [
-    pythoncom.VT_BOOL,
-    pythoncom.VT_CLSID,
-    pythoncom.VT_CY,
-    pythoncom.VT_DATE,
-    pythoncom.VT_DECIMAL,
-    pythoncom.VT_EMPTY,
-    pythoncom.VT_ERROR,
-    pythoncom.VT_FILETIME,
-    pythoncom.VT_HRESULT,
-    pythoncom.VT_I1,
-    pythoncom.VT_I2,
-    pythoncom.VT_I4,
-    pythoncom.VT_I8,
-    pythoncom.VT_INT,
-    pythoncom.VT_NULL,
-    pythoncom.VT_R4,
-    pythoncom.VT_R8,
-    pythoncom.VT_NULL,
-    pythoncom.VT_STREAM,
-    pythoncom.VT_UI1,
-    pythoncom.VT_UI2,
-    pythoncom.VT_UI4,
-    pythoncom.VT_UI8,
-    pythoncom.VT_UINT,
-    pythoncom.VT_VOID,
-]
-
-NoTranslateMap = {}
-for v in NoTranslateTypes:
-    NoTranslateMap[v] = None
-
-
-class MapEntry:
-    "Simple holder for named attibutes - items in a map."
-
-    def __init__(
-        self,
-        desc_or_id,
-        names=None,
-        doc=None,
-        resultCLSID=pythoncom.IID_NULL,
-        resultDoc=None,
-        hidden=0,
-    ):
-        if type(desc_or_id) == type(0):
-            self.dispid = desc_or_id
-            self.desc = None
-        else:
-            self.dispid = desc_or_id[0]
-            self.desc = desc_or_id
-
-        self.names = names
-        self.doc = doc
-        self.resultCLSID = resultCLSID
-        self.resultDocumentation = resultDoc
-        self.wasProperty = (
-            0  # Have I been transformed into a function so I can pass args?
-        )
-        self.hidden = hidden
-
-    def __repr__(self):
-        return (
-            "MapEntry(dispid={s.dispid}, desc={s.desc}, names={s.names}, doc={s.doc!r}, "
-            "resultCLSID={s.resultCLSID}, resultDocumentation={s.resultDocumentation}, "
-            "wasProperty={s.wasProperty}, hidden={s.hidden}"
-        ).format(s=self)
-
-    def GetResultCLSID(self):
-        rc = self.resultCLSID
-        if rc == pythoncom.IID_NULL:
-            return None
-        return rc
-
-    # Return a string, suitable for output - either "'{...}'" or "None"
-    def GetResultCLSIDStr(self):
-        rc = self.GetResultCLSID()
-        if rc is None:
-            return "None"
-        return repr(
-            str(rc)
-        )  # Convert the IID object to a string, then to a string in a string.
-
-    def GetResultName(self):
-        if self.resultDocumentation is None:
-            return None
-        return self.resultDocumentation[0]
-
-
-class OleItem:
-    typename = "OleItem"
-
-    def __init__(self, doc=None):
-        self.doc = doc
-        if self.doc:
-            self.python_name = MakePublicAttributeName(self.doc[0])
-        else:
-            self.python_name = None
-        self.bWritten = 0
-        self.bIsDispatch = 0
-        self.bIsSink = 0
-        self.clsid = None
-        self.co_class = None
-
-
-class DispatchItem(OleItem):
-    typename = "DispatchItem"
-
-    def __init__(self, typeinfo=None, attr=None, doc=None, bForUser=1):
-        OleItem.__init__(self, doc)
-        self.propMap = {}
-        self.propMapGet = {}
-        self.propMapPut = {}
-        self.mapFuncs = {}
-        self.defaultDispatchName = None
-        self.hidden = 0
-
-        if typeinfo:
-            self.Build(typeinfo, attr, bForUser)
-
-    def _propMapPutCheck_(self, key, item):
-        ins, outs, opts = self.CountInOutOptArgs(item.desc[2])
-        if ins > 1:  # if a Put property takes more than 1 arg:
-            if opts + 1 == ins or ins == item.desc[6] + 1:
-                newKey = "Set" + key
-                deleteExisting = 0  # This one is still OK
-            else:
-                deleteExisting = 1  # No good to us
-                if key in self.mapFuncs or key in self.propMapGet:
-                    newKey = "Set" + key
-                else:
-                    newKey = key
-            item.wasProperty = 1
-            self.mapFuncs[newKey] = item
-            if deleteExisting:
-                del self.propMapPut[key]
-
-    def _propMapGetCheck_(self, key, item):
-        ins, outs, opts = self.CountInOutOptArgs(item.desc[2])
-        if ins > 0:  # if a Get property takes _any_ in args:
-            if item.desc[6] == ins or ins == opts:
-                newKey = "Get" + key
-                deleteExisting = 0  # This one is still OK
-            else:
-                deleteExisting = 1  # No good to us
-                if key in self.mapFuncs:
-                    newKey = "Get" + key
-                else:
-                    newKey = key
-            item.wasProperty = 1
-            self.mapFuncs[newKey] = item
-            if deleteExisting:
-                del self.propMapGet[key]
-
-    def _AddFunc_(self, typeinfo, fdesc, bForUser):
-        assert fdesc.desckind == pythoncom.DESCKIND_FUNCDESC
-        id = fdesc.memid
-        funcflags = fdesc.wFuncFlags
-        try:
-            names = typeinfo.GetNames(id)
-            name = names[0]
-        except pythoncom.ole_error:
-            name = ""
-            names = None
-
-        doc = None
-        try:
-            if bForUser:
-                doc = typeinfo.GetDocumentation(id)
-        except pythoncom.ole_error:
-            pass
-
-        if id == 0 and name:
-            self.defaultDispatchName = name
-
-        invkind = fdesc.invkind
-
-        # We need to translate any Alias', Enums, structs etc in result and args
-        typerepr, flag, defval = fdesc.rettype
-        # 		sys.stderr.write("%s result - %s -> " % (name, typerepr))
-        typerepr, resultCLSID, resultDoc = _ResolveType(typerepr, typeinfo)
-        # 		sys.stderr.write("%s\n" % (typerepr,))
-        fdesc.rettype = typerepr, flag, defval, resultCLSID
-        # Translate any Alias or Enums in argument list.
-        argList = []
-        for argDesc in fdesc.args:
-            typerepr, flag, defval = argDesc
-            # 			sys.stderr.write("%s arg - %s -> " % (name, typerepr))
-            arg_type, arg_clsid, arg_doc = _ResolveType(typerepr, typeinfo)
-            argDesc = arg_type, flag, defval, arg_clsid
-            # 			sys.stderr.write("%s\n" % (argDesc[0],))
-            argList.append(argDesc)
-        fdesc.args = tuple(argList)
-
-        hidden = (funcflags & pythoncom.FUNCFLAG_FHIDDEN) != 0
-        if invkind == pythoncom.INVOKE_PROPERTYGET:
-            map = self.propMapGet
-        # This is not the best solution, but I dont think there is
-        # one without specific "set" syntax.
-        # If there is a single PUT or PUTREF, it will function as a property.
-        # If there are both, then the PUT remains a property, and the PUTREF
-        # gets transformed into a function.
-        # (in vb, PUT=="obj=other_obj", PUTREF="set obj=other_obj
-        elif invkind in (pythoncom.INVOKE_PROPERTYPUT, pythoncom.INVOKE_PROPERTYPUTREF):
-            # Special case
-            existing = self.propMapPut.get(name, None)
-            if existing is not None:
-                if existing.desc[4] == pythoncom.INVOKE_PROPERTYPUT:  # Keep this one
-                    map = self.mapFuncs
-                    name = "Set" + name
-                else:  # Existing becomes a func.
-                    existing.wasProperty = 1
-                    self.mapFuncs["Set" + name] = existing
-                    map = self.propMapPut  # existing gets overwritten below.
-            else:
-                map = self.propMapPut  # first time weve seen it.
-
-        elif invkind == pythoncom.INVOKE_FUNC:
-            map = self.mapFuncs
-        else:
-            map = None
-        if not map is None:
-            # 				if map.has_key(name):
-            # 					sys.stderr.write("Warning - overwriting existing method/attribute %s\n" % name)
-            map[name] = MapEntry(fdesc, names, doc, resultCLSID, resultDoc, hidden)
-            # any methods that can't be reached via DISPATCH we return None
-            # for, so dynamic dispatch doesnt see it.
-            if fdesc.funckind != pythoncom.FUNC_DISPATCH:
-                return None
-            return (name, map)
-        return None
-
-    def _AddVar_(self, typeinfo, vardesc, bForUser):
-        ### need pythoncom.VARFLAG_FRESTRICTED ...
-        ### then check it
-        assert vardesc.desckind == pythoncom.DESCKIND_VARDESC
-
-        if vardesc.varkind == pythoncom.VAR_DISPATCH:
-            id = vardesc.memid
-            names = typeinfo.GetNames(id)
-            # Translate any Alias or Enums in result.
-            typerepr, flags, defval = vardesc.elemdescVar
-            typerepr, resultCLSID, resultDoc = _ResolveType(typerepr, typeinfo)
-            vardesc.elemdescVar = typerepr, flags, defval
-            doc = None
-            try:
-                if bForUser:
-                    doc = typeinfo.GetDocumentation(id)
-            except pythoncom.ole_error:
-                pass
-
-            # handle the enumerator specially
-            map = self.propMap
-            # Check if the element is hidden.
-            hidden = (vardesc.wVarFlags & 0x40) != 0  # VARFLAG_FHIDDEN
-            map[names[0]] = MapEntry(
-                vardesc, names, doc, resultCLSID, resultDoc, hidden
-            )
-            return (names[0], map)
-        else:
-            return None
-
-    def Build(self, typeinfo, attr, bForUser=1):
-        self.clsid = attr[0]
-        self.bIsDispatch = (attr.wTypeFlags & pythoncom.TYPEFLAG_FDISPATCHABLE) != 0
-        if typeinfo is None:
-            return
-        # Loop over all methods
-        for j in range(attr[6]):
-            fdesc = typeinfo.GetFuncDesc(j)
-            self._AddFunc_(typeinfo, fdesc, bForUser)
-
-        # Loop over all variables (ie, properties)
-        for j in range(attr[7]):
-            fdesc = typeinfo.GetVarDesc(j)
-            self._AddVar_(typeinfo, fdesc, bForUser)
-
-        # Now post-process the maps.  For any "Get" or "Set" properties
-        # that have arguments, we must turn them into methods.  If a method
-        # of the same name already exists, change the name.
-        for key, item in list(self.propMapGet.items()):
-            self._propMapGetCheck_(key, item)
-
-        for key, item in list(self.propMapPut.items()):
-            self._propMapPutCheck_(key, item)
-
-    def CountInOutOptArgs(self, argTuple):
-        "Return tuple counting in/outs/OPTS.  Sum of result may not be len(argTuple), as some args may be in/out."
-        ins = out = opts = 0
-        for argCheck in argTuple:
-            inOut = argCheck[1]
-            if inOut == 0:
-                ins = ins + 1
-                out = out + 1
-            else:
-                if inOut & pythoncom.PARAMFLAG_FIN:
-                    ins = ins + 1
-                if inOut & pythoncom.PARAMFLAG_FOPT:
-                    opts = opts + 1
-                if inOut & pythoncom.PARAMFLAG_FOUT:
-                    out = out + 1
-        return ins, out, opts
-
-    def MakeFuncMethod(self, entry, name, bMakeClass=1):
-        # If we have a type description, and not varargs...
-        if entry.desc is not None and (len(entry.desc) < 6 or entry.desc[6] != -1):
-            return self.MakeDispatchFuncMethod(entry, name, bMakeClass)
-        else:
-            return self.MakeVarArgsFuncMethod(entry, name, bMakeClass)
-
-    def MakeDispatchFuncMethod(self, entry, name, bMakeClass=1):
-        fdesc = entry.desc
-        doc = entry.doc
-        names = entry.names
-        ret = []
-        if bMakeClass:
-            linePrefix = "\t"
-            defNamedOptArg = "defaultNamedOptArg"
-            defNamedNotOptArg = "defaultNamedNotOptArg"
-            defUnnamedArg = "defaultUnnamedArg"
-        else:
-            linePrefix = ""
-            defNamedOptArg = "pythoncom.Missing"
-            defNamedNotOptArg = "pythoncom.Missing"
-            defUnnamedArg = "pythoncom.Missing"
-        defOutArg = "pythoncom.Missing"
-        id = fdesc[0]
-
-        s = (
-            linePrefix
-            + "def "
-            + name
-            + "(self"
-            + BuildCallList(
-                fdesc,
-                names,
-                defNamedOptArg,
-                defNamedNotOptArg,
-                defUnnamedArg,
-                defOutArg,
-            )
-            + "):"
-        )
-        ret.append(s)
-        if doc and doc[1]:
-            ret.append(linePrefix + "\t" + _makeDocString(doc[1]))
-
-        resclsid = entry.GetResultCLSID()
-        if resclsid:
-            resclsid = "'%s'" % resclsid
-        else:
-            resclsid = "None"
-        # Strip the default values from the arg desc
-        retDesc = fdesc[8][:2]
-        argsDesc = tuple([what[:2] for what in fdesc[2]])
-        # The runtime translation of the return types is expensive, so when we know the
-        # return type of the function, there is no need to check the type at runtime.
-        # To qualify, this function must return a "simple" type, and have no byref args.
-        # Check if we have byrefs or anything in the args which mean we still need a translate.
-        param_flags = [what[1] for what in fdesc[2]]
-        bad_params = [
-            flag
-            for flag in param_flags
-            if flag & (pythoncom.PARAMFLAG_FOUT | pythoncom.PARAMFLAG_FRETVAL) != 0
-        ]
-        s = None
-        if len(bad_params) == 0 and len(retDesc) == 2 and retDesc[1] == 0:
-            rd = retDesc[0]
-            if rd in NoTranslateMap:
-                s = "%s\treturn self._oleobj_.InvokeTypes(%d, LCID, %s, %s, %s%s)" % (
-                    linePrefix,
-                    id,
-                    fdesc[4],
-                    retDesc,
-                    argsDesc,
-                    _BuildArgList(fdesc, names),
-                )
-            elif rd in [pythoncom.VT_DISPATCH, pythoncom.VT_UNKNOWN]:
-                s = "%s\tret = self._oleobj_.InvokeTypes(%d, LCID, %s, %s, %s%s)\n" % (
-                    linePrefix,
-                    id,
-                    fdesc[4],
-                    retDesc,
-                    repr(argsDesc),
-                    _BuildArgList(fdesc, names),
-                )
-                s = s + "%s\tif ret is not None:\n" % (linePrefix,)
-                if rd == pythoncom.VT_UNKNOWN:
-                    s = s + "%s\t\t# See if this IUnknown is really an IDispatch\n" % (
-                        linePrefix,
-                    )
-                    s = s + "%s\t\ttry:\n" % (linePrefix,)
-                    s = (
-                        s
-                        + "%s\t\t\tret = ret.QueryInterface(pythoncom.IID_IDispatch)\n"
-                        % (linePrefix,)
-                    )
-                    s = s + "%s\t\texcept pythoncom.error:\n" % (linePrefix,)
-                    s = s + "%s\t\t\treturn ret\n" % (linePrefix,)
-                s = s + "%s\t\tret = Dispatch(ret, %s, %s)\n" % (
-                    linePrefix,
-                    repr(name),
-                    resclsid,
-                )
-                s = s + "%s\treturn ret" % (linePrefix)
-            elif rd == pythoncom.VT_BSTR:
-                s = "%s\t# Result is a Unicode object\n" % (linePrefix,)
-                s = (
-                    s
-                    + "%s\treturn self._oleobj_.InvokeTypes(%d, LCID, %s, %s, %s%s)"
-                    % (
-                        linePrefix,
-                        id,
-                        fdesc[4],
-                        retDesc,
-                        repr(argsDesc),
-                        _BuildArgList(fdesc, names),
-                    )
-                )
-            # else s remains None
-        if s is None:
-            s = "%s\treturn self._ApplyTypes_(%d, %s, %s, %s, %s, %s%s)" % (
-                linePrefix,
-                id,
-                fdesc[4],
-                retDesc,
-                argsDesc,
-                repr(name),
-                resclsid,
-                _BuildArgList(fdesc, names),
-            )
-
-        ret.append(s)
-        ret.append("")
-        return ret
-
-    def MakeVarArgsFuncMethod(self, entry, name, bMakeClass=1):
-        fdesc = entry.desc
-        names = entry.names
-        doc = entry.doc
-        ret = []
-        argPrefix = "self"
-        if bMakeClass:
-            linePrefix = "\t"
-        else:
-            linePrefix = ""
-        ret.append(linePrefix + "def " + name + "(" + argPrefix + ", *args):")
-        if doc and doc[1]:
-            ret.append(linePrefix + "\t" + _makeDocString(doc[1]))
-        if fdesc:
-            invoketype = fdesc[4]
-        else:
-            invoketype = pythoncom.DISPATCH_METHOD
-        s = linePrefix + "\treturn self._get_good_object_(self._oleobj_.Invoke(*(("
-        ret.append(
-            s + str(entry.dispid) + ",0,%d,1)+args)),'%s')" % (invoketype, names[0])
-        )
-        ret.append("")
-        return ret
-
-
-# Note - "DispatchItem" poorly named - need a new intermediate class.
-class VTableItem(DispatchItem):
-    def Build(self, typeinfo, attr, bForUser=1):
-        DispatchItem.Build(self, typeinfo, attr, bForUser)
-        assert typeinfo is not None, "Cant build vtables without type info!"
-
-        meth_list = (
-            list(self.mapFuncs.values())
-            + list(self.propMapGet.values())
-            + list(self.propMapPut.values())
-        )
-        meth_list.sort(key=lambda m: m.desc[7])
-
-        # Now turn this list into the run-time representation
-        # (ready for immediate use or writing to gencache)
-        self.vtableFuncs = []
-        for entry in meth_list:
-            self.vtableFuncs.append((entry.names, entry.dispid, entry.desc))
-
-
-# A Lazy dispatch item - builds an item on request using info from
-# an ITypeComp.  The dynamic module makes the called to build each item,
-# and also holds the references to the typeinfo and typecomp.
-class LazyDispatchItem(DispatchItem):
-    typename = "LazyDispatchItem"
-
-    def __init__(self, attr, doc):
-        self.clsid = attr[0]
-        DispatchItem.__init__(self, None, attr, doc, 0)
-
-
-typeSubstMap = {
-    pythoncom.VT_INT: pythoncom.VT_I4,
-    pythoncom.VT_UINT: pythoncom.VT_UI4,
-    pythoncom.VT_HRESULT: pythoncom.VT_I4,
-}
-
-
-def _ResolveType(typerepr, itypeinfo):
-    # Resolve VT_USERDEFINED (often aliases or typed IDispatches)
-
-    if type(typerepr) == tuple:
-        indir_vt, subrepr = typerepr
-        if indir_vt == pythoncom.VT_PTR:
-            # If it is a VT_PTR to a VT_USERDEFINED that is an IDispatch/IUnknown,
-            # then it resolves to simply the object.
-            # Otherwise, it becomes a ByRef of the resolved type
-            # We need to drop an indirection level on pointer to user defined interfaces.
-            # eg, (VT_PTR, (VT_USERDEFINED, somehandle)) needs to become VT_DISPATCH
-            # only when "somehandle" is an object.
-            # but (VT_PTR, (VT_USERDEFINED, otherhandle)) doesnt get the indirection dropped.
-            was_user = type(subrepr) == tuple and subrepr[0] == pythoncom.VT_USERDEFINED
-            subrepr, sub_clsid, sub_doc = _ResolveType(subrepr, itypeinfo)
-            if was_user and subrepr in [
-                pythoncom.VT_DISPATCH,
-                pythoncom.VT_UNKNOWN,
-                pythoncom.VT_RECORD,
-            ]:
-                # Drop the VT_PTR indirection
-                return subrepr, sub_clsid, sub_doc
-            # Change PTR indirection to byref
-            return subrepr | pythoncom.VT_BYREF, sub_clsid, sub_doc
-        if indir_vt == pythoncom.VT_SAFEARRAY:
-            # resolve the array element, and convert to VT_ARRAY
-            subrepr, sub_clsid, sub_doc = _ResolveType(subrepr, itypeinfo)
-            return pythoncom.VT_ARRAY | subrepr, sub_clsid, sub_doc
-        if indir_vt == pythoncom.VT_CARRAY:  # runtime has no support for this yet.
-            # resolve the array element, and convert to VT_CARRAY
-            # sheesh - return _something_
-            return pythoncom.VT_CARRAY, None, None
-        if indir_vt == pythoncom.VT_USERDEFINED:
-            try:
-                resultTypeInfo = itypeinfo.GetRefTypeInfo(subrepr)
-            except pythoncom.com_error as details:
-                if details.hresult in [
-                    winerror.TYPE_E_CANTLOADLIBRARY,
-                    winerror.TYPE_E_LIBNOTREGISTERED,
-                ]:
-                    # an unregistered interface
-                    return pythoncom.VT_UNKNOWN, None, None
-                raise
-
-            resultAttr = resultTypeInfo.GetTypeAttr()
-            typeKind = resultAttr.typekind
-            if typeKind == pythoncom.TKIND_ALIAS:
-                tdesc = resultAttr.tdescAlias
-                return _ResolveType(tdesc, resultTypeInfo)
-            elif typeKind in [pythoncom.TKIND_ENUM, pythoncom.TKIND_MODULE]:
-                # For now, assume Long
-                return pythoncom.VT_I4, None, None
-
-            elif typeKind == pythoncom.TKIND_DISPATCH:
-                clsid = resultTypeInfo.GetTypeAttr()[0]
-                retdoc = resultTypeInfo.GetDocumentation(-1)
-                return pythoncom.VT_DISPATCH, clsid, retdoc
-
-            elif typeKind in [pythoncom.TKIND_INTERFACE, pythoncom.TKIND_COCLASS]:
-                # XXX - should probably get default interface for CO_CLASS???
-                clsid = resultTypeInfo.GetTypeAttr()[0]
-                retdoc = resultTypeInfo.GetDocumentation(-1)
-                return pythoncom.VT_UNKNOWN, clsid, retdoc
-
-            elif typeKind == pythoncom.TKIND_RECORD:
-                return pythoncom.VT_RECORD, None, None
-            raise NotSupportedException("Can not resolve alias or user-defined type")
-    return typeSubstMap.get(typerepr, typerepr), None, None
-
-
-def _BuildArgList(fdesc, names):
-    "Builds list of args to the underlying Invoke method."
-    # Word has TypeInfo for Insert() method, but says "no args"
-    numArgs = max(fdesc[6], len(fdesc[2]))
-    names = list(names)
-    while None in names:
-        i = names.index(None)
-        names[i] = "arg%d" % (i,)
-    # We've seen 'source safe' libraries offer the name of 'ret' params in
-    # 'names' - although we can't reproduce this, it would be insane to offer
-    # more args than we have arg infos for - hence the upper limit on names...
-    names = list(map(MakePublicAttributeName, names[1 : (numArgs + 1)]))
-    name_num = 0
-    while len(names) < numArgs:
-        names.append("arg%d" % (len(names),))
-    # As per BuildCallList(), avoid huge lines.
-    # Hack a "\n" at the end of every 5th name - "strides" would be handy
-    # here but don't exist in 2.2
-    for i in range(0, len(names), 5):
-        names[i] = names[i] + "\n\t\t\t"
-    return "," + ", ".join(names)
-
-
-valid_identifier_chars = string.ascii_letters + string.digits + "_"
-
-
-def demunge_leading_underscores(className):
-    i = 0
-    while className[i] == "_":
-        i += 1
-    assert i >= 2, "Should only be here with names starting with '__'"
-    return className[i - 1 :] + className[: i - 1]
-
-
-# Given a "public name" (eg, the name of a class, function, etc)
-# make sure it is a legal (and reasonable!) Python name.
-def MakePublicAttributeName(className, is_global=False):
-    # Given a class attribute that needs to be public, convert it to a
-    # reasonable name.
-    # Also need to be careful that the munging doesnt
-    # create duplicates - eg, just removing a leading "_" is likely to cause
-    # a clash.
-    # if is_global is True, then the name is a global variable that may
-    # overwrite a builtin - eg, "None"
-    if className[:2] == "__":
-        return demunge_leading_underscores(className)
-    elif className == "None":
-        # assign to None is evil (and SyntaxError in 2.4, even though
-        # iskeyword says False there) - note that if it was a global
-        # it would get picked up below
-        className = "NONE"
-    elif iskeyword(className):
-        # most keywords are lower case (except True, False etc in py3k)
-        ret = className.capitalize()
-        # but those which aren't get forced upper.
-        if ret == className:
-            ret = ret.upper()
-        return ret
-    elif is_global and hasattr(__builtins__, className):
-        # builtins may be mixed case.  If capitalizing it doesn't change it,
-        # force to all uppercase (eg, "None", "True" become "NONE", "TRUE"
-        ret = className.capitalize()
-        if ret == className:  # didn't change - force all uppercase.
-            ret = ret.upper()
-        return ret
-    # Strip non printable chars
-    return "".join([char for char in className if char in valid_identifier_chars])
-
-
-# Given a default value passed by a type library, return a string with
-# an appropriate repr() for the type.
-# Takes a raw ELEMDESC and returns a repr string, or None
-# (NOTE: The string itself may be '"None"', which is valid, and different to None.
-# XXX - To do: Dates are probably screwed, but can they come in?
-def MakeDefaultArgRepr(defArgVal):
-    try:
-        inOut = defArgVal[1]
-    except IndexError:
-        # something strange - assume is in param.
-        inOut = pythoncom.PARAMFLAG_FIN
-
-    if inOut & pythoncom.PARAMFLAG_FHASDEFAULT:
-        # times need special handling...
-        val = defArgVal[2]
-        if isinstance(val, datetime.datetime):
-            # VARIANT <-> SYSTEMTIME conversions always lose any sub-second
-            # resolution, so just use a 'timetuple' here.
-            return repr(tuple(val.utctimetuple()))
-        if type(val) is TimeType:
-            # must be the 'old' pywintypes time object...
-            year = val.year
-            month = val.month
-            day = val.day
-            hour = val.hour
-            minute = val.minute
-            second = val.second
-            msec = val.msec
-            return (
-                "pywintypes.Time((%(year)d, %(month)d, %(day)d, %(hour)d, %(minute)d, %(second)d,0,0,0,%(msec)d))"
-                % locals()
-            )
-        return repr(val)
-    return None
-
-
-def BuildCallList(
-    fdesc,
-    names,
-    defNamedOptArg,
-    defNamedNotOptArg,
-    defUnnamedArg,
-    defOutArg,
-    is_comment=False,
-):
-    "Builds a Python declaration for a method."
-    # Names[0] is the func name - param names are from 1.
-    numArgs = len(fdesc[2])
-    numOptArgs = fdesc[6]
-    strval = ""
-    if numOptArgs == -1:  # Special value that says "var args after here"
-        firstOptArg = numArgs
-        numArgs = numArgs - 1
-    else:
-        firstOptArg = numArgs - numOptArgs
-    for arg in range(numArgs):
-        try:
-            argName = names[arg + 1]
-            namedArg = argName is not None
-        except IndexError:
-            namedArg = 0
-        if not namedArg:
-            argName = "arg%d" % (arg)
-        thisdesc = fdesc[2][arg]
-        # See if the IDL specified a default value
-        defArgVal = MakeDefaultArgRepr(thisdesc)
-        if defArgVal is None:
-            # Out params always get their special default
-            if (
-                thisdesc[1] & (pythoncom.PARAMFLAG_FOUT | pythoncom.PARAMFLAG_FIN)
-                == pythoncom.PARAMFLAG_FOUT
-            ):
-                defArgVal = defOutArg
-            else:
-                # Unnamed arg - always allow default values.
-                if namedArg:
-                    # Is a named argument
-                    if arg >= firstOptArg:
-                        defArgVal = defNamedOptArg
-                    else:
-                        defArgVal = defNamedNotOptArg
-                else:
-                    defArgVal = defUnnamedArg
-
-        argName = MakePublicAttributeName(argName)
-        # insanely long lines with an 'encoding' flag crashes python 2.4.0
-        # keep 5 args per line
-        # This may still fail if the arg names are insane, but that seems
-        # unlikely.  See also _BuildArgList()
-        if (arg + 1) % 5 == 0:
-            strval = strval + "\n"
-            if is_comment:
-                strval = strval + "#"
-            strval = strval + "\t\t\t"
-        strval = strval + ", " + argName
-        if defArgVal:
-            strval = strval + "=" + defArgVal
-    if numOptArgs == -1:
-        strval = strval + ", *" + names[-1]
-
-    return strval
-
-
-if __name__ == "__main__":
-    print("Use 'makepy.py' to generate Python code - this module is just a helper")
diff --git a/lib/win32com/client/combrowse.py b/lib/win32com/client/combrowse.py
deleted file mode 100644
index 10eeaedf..00000000
--- a/lib/win32com/client/combrowse.py
+++ /dev/null
@@ -1,619 +0,0 @@
-"""A utility for browsing COM objects.
-
- Usage:
-
-  Command Prompt
-
-    Use the command *"python.exe combrowse.py"*.  This will display
-    display a fairly small, modal dialog.
-
-  Pythonwin
-
-    Use the "Run Script" menu item, and this will create the browser in an
-    MDI window.  This window can be fully resized.
-
- Details
-
-   This module allows browsing of registered Type Libraries, COM categories,
-   and running COM objects.  The display is similar to the Pythonwin object
-   browser, and displays the objects in a hierarchical window.
-
-   Note that this module requires the win32ui (ie, Pythonwin) distribution to
-   work.
-
-"""
-import sys
-
-import pythoncom
-import win32api
-import win32con
-import win32ui
-from pywin.tools import browser
-from win32com.client import util
-
-
-class HLIRoot(browser.HLIPythonObject):
-    def __init__(self, title):
-        super().__init__(name=title)
-
-    def GetSubList(self):
-        return [
-            HLIHeadingCategory(),
-            HLI_IEnumMoniker(
-                pythoncom.GetRunningObjectTable().EnumRunning(), "Running Objects"
-            ),
-            HLIHeadingRegisterdTypeLibs(),
-        ]
-
-    def __cmp__(self, other):
-        return cmp(self.name, other.name)
-
-
-class HLICOM(browser.HLIPythonObject):
-    def GetText(self):
-        return self.name
-
-    def CalculateIsExpandable(self):
-        return 1
-
-
-class HLICLSID(HLICOM):
-    def __init__(self, myobject, name=None):
-        if type(myobject) == type(""):
-            myobject = pythoncom.MakeIID(myobject)
-        if name is None:
-            try:
-                name = pythoncom.ProgIDFromCLSID(myobject)
-            except pythoncom.com_error:
-                name = str(myobject)
-            name = "IID: " + name
-        HLICOM.__init__(self, myobject, name)
-
-    def CalculateIsExpandable(self):
-        return 0
-
-    def GetSubList(self):
-        return []
-
-
-class HLI_Interface(HLICOM):
-    pass
-
-
-class HLI_Enum(HLI_Interface):
-    def GetBitmapColumn(self):
-        return 0  # Always a folder.
-
-    def CalculateIsExpandable(self):
-        if self.myobject is not None:
-            rc = len(self.myobject.Next(1)) > 0
-            self.myobject.Reset()
-        else:
-            rc = 0
-        return rc
-
-    pass
-
-
-class HLI_IEnumMoniker(HLI_Enum):
-    def GetSubList(self):
-        ctx = pythoncom.CreateBindCtx()
-        ret = []
-        for mon in util.Enumerator(self.myobject):
-            ret.append(HLI_IMoniker(mon, mon.GetDisplayName(ctx, None)))
-        return ret
-
-
-class HLI_IMoniker(HLI_Interface):
-    def GetSubList(self):
-        ret = []
-        ret.append(browser.MakeHLI(self.myobject.Hash(), "Hash Value"))
-        subenum = self.myobject.Enum(1)
-        ret.append(HLI_IEnumMoniker(subenum, "Sub Monikers"))
-        return ret
-
-
-class HLIHeadingCategory(HLICOM):
-    "A tree heading for registered categories"
-
-    def GetText(self):
-        return "Registered Categories"
-
-    def GetSubList(self):
-        catinf = pythoncom.CoCreateInstance(
-            pythoncom.CLSID_StdComponentCategoriesMgr,
-            None,
-            pythoncom.CLSCTX_INPROC,
-            pythoncom.IID_ICatInformation,
-        )
-        enum = util.Enumerator(catinf.EnumCategories())
-        ret = []
-        try:
-            for catid, lcid, desc in enum:
-                ret.append(HLICategory((catid, lcid, desc)))
-        except pythoncom.com_error:
-            # Registered categories occasionally seem to give spurious errors.
-            pass  # Use what we already have.
-        return ret
-
-
-class HLICategory(HLICOM):
-    "An actual Registered Category"
-
-    def GetText(self):
-        desc = self.myobject[2]
-        if not desc:
-            desc = "(unnamed category)"
-        return desc
-
-    def GetSubList(self):
-        win32ui.DoWaitCursor(1)
-        catid, lcid, desc = self.myobject
-        catinf = pythoncom.CoCreateInstance(
-            pythoncom.CLSID_StdComponentCategoriesMgr,
-            None,
-            pythoncom.CLSCTX_INPROC,
-            pythoncom.IID_ICatInformation,
-        )
-        ret = []
-        for clsid in util.Enumerator(catinf.EnumClassesOfCategories((catid,), ())):
-            ret.append(HLICLSID(clsid))
-        win32ui.DoWaitCursor(0)
-
-        return ret
-
-
-class HLIHelpFile(HLICOM):
-    def CalculateIsExpandable(self):
-        return 0
-
-    def GetText(self):
-        import os
-
-        fname, ctx = self.myobject
-        base = os.path.split(fname)[1]
-        return "Help reference in %s" % (base)
-
-    def TakeDefaultAction(self):
-        fname, ctx = self.myobject
-        if ctx:
-            cmd = win32con.HELP_CONTEXT
-        else:
-            cmd = win32con.HELP_FINDER
-        win32api.WinHelp(win32ui.GetMainFrame().GetSafeHwnd(), fname, cmd, ctx)
-
-    def GetBitmapColumn(self):
-        return 6
-
-
-class HLIRegisteredTypeLibrary(HLICOM):
-    def GetSubList(self):
-        import os
-
-        clsidstr, versionStr = self.myobject
-        collected = []
-        helpPath = ""
-        key = win32api.RegOpenKey(
-            win32con.HKEY_CLASSES_ROOT, "TypeLib\\%s\\%s" % (clsidstr, versionStr)
-        )
-        win32ui.DoWaitCursor(1)
-        try:
-            num = 0
-            while 1:
-                try:
-                    subKey = win32api.RegEnumKey(key, num)
-                except win32api.error:
-                    break
-                hSubKey = win32api.RegOpenKey(key, subKey)
-                try:
-                    value, typ = win32api.RegQueryValueEx(hSubKey, None)
-                    if typ == win32con.REG_EXPAND_SZ:
-                        value = win32api.ExpandEnvironmentStrings(value)
-                except win32api.error:
-                    value = ""
-                if subKey == "HELPDIR":
-                    helpPath = value
-                elif subKey == "Flags":
-                    flags = value
-                else:
-                    try:
-                        lcid = int(subKey)
-                        lcidkey = win32api.RegOpenKey(key, subKey)
-                        # Enumerate the platforms
-                        lcidnum = 0
-                        while 1:
-                            try:
-                                platform = win32api.RegEnumKey(lcidkey, lcidnum)
-                            except win32api.error:
-                                break
-                            try:
-                                hplatform = win32api.RegOpenKey(lcidkey, platform)
-                                fname, typ = win32api.RegQueryValueEx(hplatform, None)
-                                if typ == win32con.REG_EXPAND_SZ:
-                                    fname = win32api.ExpandEnvironmentStrings(fname)
-                            except win32api.error:
-                                fname = ""
-                            collected.append((lcid, platform, fname))
-                            lcidnum = lcidnum + 1
-                        win32api.RegCloseKey(lcidkey)
-                    except ValueError:
-                        pass
-                num = num + 1
-        finally:
-            win32ui.DoWaitCursor(0)
-            win32api.RegCloseKey(key)
-        # Now, loop over my collected objects, adding a TypeLib and a HelpFile
-        ret = []
-        #               if helpPath: ret.append(browser.MakeHLI(helpPath, "Help Path"))
-        ret.append(HLICLSID(clsidstr))
-        for lcid, platform, fname in collected:
-            extraDescs = []
-            if platform != "win32":
-                extraDescs.append(platform)
-            if lcid:
-                extraDescs.append("locale=%s" % lcid)
-            extraDesc = ""
-            if extraDescs:
-                extraDesc = " (%s)" % ", ".join(extraDescs)
-            ret.append(HLITypeLib(fname, "Type Library" + extraDesc))
-        ret.sort()
-        return ret
-
-
-class HLITypeLibEntry(HLICOM):
-    def GetText(self):
-        tlb, index = self.myobject
-        name, doc, ctx, helpFile = tlb.GetDocumentation(index)
-        try:
-            typedesc = HLITypeKinds[tlb.GetTypeInfoType(index)][1]
-        except KeyError:
-            typedesc = "Unknown!"
-        return name + " - " + typedesc
-
-    def GetSubList(self):
-        tlb, index = self.myobject
-        name, doc, ctx, helpFile = tlb.GetDocumentation(index)
-        ret = []
-        if doc:
-            ret.append(browser.HLIDocString(doc, "Doc"))
-        if helpFile:
-            ret.append(HLIHelpFile((helpFile, ctx)))
-        return ret
-
-
-class HLICoClass(HLITypeLibEntry):
-    def GetSubList(self):
-        ret = HLITypeLibEntry.GetSubList(self)
-        tlb, index = self.myobject
-        typeinfo = tlb.GetTypeInfo(index)
-        attr = typeinfo.GetTypeAttr()
-        for j in range(attr[8]):
-            flags = typeinfo.GetImplTypeFlags(j)
-            refType = typeinfo.GetRefTypeInfo(typeinfo.GetRefTypeOfImplType(j))
-            refAttr = refType.GetTypeAttr()
-            ret.append(
-                browser.MakeHLI(refAttr[0], "Name=%s, Flags = %d" % (refAttr[0], flags))
-            )
-        return ret
-
-
-class HLITypeLibMethod(HLITypeLibEntry):
-    def __init__(self, ob, name=None):
-        self.entry_type = "Method"
-        HLITypeLibEntry.__init__(self, ob, name)
-
-    def GetSubList(self):
-        ret = HLITypeLibEntry.GetSubList(self)
-        tlb, index = self.myobject
-        typeinfo = tlb.GetTypeInfo(index)
-        attr = typeinfo.GetTypeAttr()
-        for i in range(attr[7]):
-            ret.append(HLITypeLibProperty((typeinfo, i)))
-        for i in range(attr[6]):
-            ret.append(HLITypeLibFunction((typeinfo, i)))
-        return ret
-
-
-class HLITypeLibEnum(HLITypeLibEntry):
-    def __init__(self, myitem):
-        typelib, index = myitem
-        typeinfo = typelib.GetTypeInfo(index)
-        self.id = typeinfo.GetVarDesc(index)[0]
-        name = typeinfo.GetNames(self.id)[0]
-        HLITypeLibEntry.__init__(self, myitem, name)
-
-    def GetText(self):
-        return self.name + " - Enum/Module"
-
-    def GetSubList(self):
-        ret = []
-        typelib, index = self.myobject
-        typeinfo = typelib.GetTypeInfo(index)
-        attr = typeinfo.GetTypeAttr()
-        for j in range(attr[7]):
-            vdesc = typeinfo.GetVarDesc(j)
-            name = typeinfo.GetNames(vdesc[0])[0]
-            ret.append(browser.MakeHLI(vdesc[1], name))
-        return ret
-
-
-class HLITypeLibProperty(HLICOM):
-    def __init__(self, myitem):
-        typeinfo, index = myitem
-        self.id = typeinfo.GetVarDesc(index)[0]
-        name = typeinfo.GetNames(self.id)[0]
-        HLICOM.__init__(self, myitem, name)
-
-    def GetText(self):
-        return self.name + " - Property"
-
-    def GetSubList(self):
-        ret = []
-        typeinfo, index = self.myobject
-        names = typeinfo.GetNames(self.id)
-        if len(names) > 1:
-            ret.append(browser.MakeHLI(names[1:], "Named Params"))
-        vd = typeinfo.GetVarDesc(index)
-        ret.append(browser.MakeHLI(self.id, "Dispatch ID"))
-        ret.append(browser.MakeHLI(vd[1], "Value"))
-        ret.append(browser.MakeHLI(vd[2], "Elem Desc"))
-        ret.append(browser.MakeHLI(vd[3], "Var Flags"))
-        ret.append(browser.MakeHLI(vd[4], "Var Kind"))
-        return ret
-
-
-class HLITypeLibFunction(HLICOM):
-    funckinds = {
-        pythoncom.FUNC_VIRTUAL: "Virtual",
-        pythoncom.FUNC_PUREVIRTUAL: "Pure Virtual",
-        pythoncom.FUNC_STATIC: "Static",
-        pythoncom.FUNC_DISPATCH: "Dispatch",
-    }
-    invokekinds = {
-        pythoncom.INVOKE_FUNC: "Function",
-        pythoncom.INVOKE_PROPERTYGET: "Property Get",
-        pythoncom.INVOKE_PROPERTYPUT: "Property Put",
-        pythoncom.INVOKE_PROPERTYPUTREF: "Property Put by reference",
-    }
-    funcflags = [
-        (pythoncom.FUNCFLAG_FRESTRICTED, "Restricted"),
-        (pythoncom.FUNCFLAG_FSOURCE, "Source"),
-        (pythoncom.FUNCFLAG_FBINDABLE, "Bindable"),
-        (pythoncom.FUNCFLAG_FREQUESTEDIT, "Request Edit"),
-        (pythoncom.FUNCFLAG_FDISPLAYBIND, "Display Bind"),
-        (pythoncom.FUNCFLAG_FDEFAULTBIND, "Default Bind"),
-        (pythoncom.FUNCFLAG_FHIDDEN, "Hidden"),
-        (pythoncom.FUNCFLAG_FUSESGETLASTERROR, "Uses GetLastError"),
-    ]
-
-    vartypes = {
-        pythoncom.VT_EMPTY: "Empty",
-        pythoncom.VT_NULL: "NULL",
-        pythoncom.VT_I2: "Integer 2",
-        pythoncom.VT_I4: "Integer 4",
-        pythoncom.VT_R4: "Real 4",
-        pythoncom.VT_R8: "Real 8",
-        pythoncom.VT_CY: "CY",
-        pythoncom.VT_DATE: "Date",
-        pythoncom.VT_BSTR: "String",
-        pythoncom.VT_DISPATCH: "IDispatch",
-        pythoncom.VT_ERROR: "Error",
-        pythoncom.VT_BOOL: "BOOL",
-        pythoncom.VT_VARIANT: "Variant",
-        pythoncom.VT_UNKNOWN: "IUnknown",
-        pythoncom.VT_DECIMAL: "Decimal",
-        pythoncom.VT_I1: "Integer 1",
-        pythoncom.VT_UI1: "Unsigned integer 1",
-        pythoncom.VT_UI2: "Unsigned integer 2",
-        pythoncom.VT_UI4: "Unsigned integer 4",
-        pythoncom.VT_I8: "Integer 8",
-        pythoncom.VT_UI8: "Unsigned integer 8",
-        pythoncom.VT_INT: "Integer",
-        pythoncom.VT_UINT: "Unsigned integer",
-        pythoncom.VT_VOID: "Void",
-        pythoncom.VT_HRESULT: "HRESULT",
-        pythoncom.VT_PTR: "Pointer",
-        pythoncom.VT_SAFEARRAY: "SafeArray",
-        pythoncom.VT_CARRAY: "C Array",
-        pythoncom.VT_USERDEFINED: "User Defined",
-        pythoncom.VT_LPSTR: "Pointer to string",
-        pythoncom.VT_LPWSTR: "Pointer to Wide String",
-        pythoncom.VT_FILETIME: "File time",
-        pythoncom.VT_BLOB: "Blob",
-        pythoncom.VT_STREAM: "IStream",
-        pythoncom.VT_STORAGE: "IStorage",
-        pythoncom.VT_STORED_OBJECT: "Stored object",
-        pythoncom.VT_STREAMED_OBJECT: "Streamed object",
-        pythoncom.VT_BLOB_OBJECT: "Blob object",
-        pythoncom.VT_CF: "CF",
-        pythoncom.VT_CLSID: "CLSID",
-    }
-
-    type_flags = [
-        (pythoncom.VT_VECTOR, "Vector"),
-        (pythoncom.VT_ARRAY, "Array"),
-        (pythoncom.VT_BYREF, "ByRef"),
-        (pythoncom.VT_RESERVED, "Reserved"),
-    ]
-
-    def __init__(self, myitem):
-        typeinfo, index = myitem
-        self.id = typeinfo.GetFuncDesc(index)[0]
-        name = typeinfo.GetNames(self.id)[0]
-        HLICOM.__init__(self, myitem, name)
-
-    def GetText(self):
-        return self.name + " - Function"
-
-    def MakeReturnTypeName(self, typ):
-        justtyp = typ & pythoncom.VT_TYPEMASK
-        try:
-            typname = self.vartypes[justtyp]
-        except KeyError:
-            typname = "?Bad type?"
-        for flag, desc in self.type_flags:
-            if flag & typ:
-                typname = "%s(%s)" % (desc, typname)
-        return typname
-
-    def MakeReturnType(self, returnTypeDesc):
-        if type(returnTypeDesc) == type(()):
-            first = returnTypeDesc[0]
-            result = self.MakeReturnType(first)
-            if first != pythoncom.VT_USERDEFINED:
-                result = result + " " + self.MakeReturnType(returnTypeDesc[1])
-            return result
-        else:
-            return self.MakeReturnTypeName(returnTypeDesc)
-
-    def GetSubList(self):
-        ret = []
-        typeinfo, index = self.myobject
-        names = typeinfo.GetNames(self.id)
-        ret.append(browser.MakeHLI(self.id, "Dispatch ID"))
-        if len(names) > 1:
-            ret.append(browser.MakeHLI(", ".join(names[1:]), "Named Params"))
-        fd = typeinfo.GetFuncDesc(index)
-        if fd[1]:
-            ret.append(browser.MakeHLI(fd[1], "Possible result values"))
-        if fd[8]:
-            typ, flags, default = fd[8]
-            val = self.MakeReturnType(typ)
-            if flags:
-                val = "%s (Flags=%d, default=%s)" % (val, flags, default)
-            ret.append(browser.MakeHLI(val, "Return Type"))
-
-        for argDesc in fd[2]:
-            typ, flags, default = argDesc
-            val = self.MakeReturnType(typ)
-            if flags:
-                val = "%s (Flags=%d)" % (val, flags)
-            if default is not None:
-                val = "%s (Default=%s)" % (val, default)
-            ret.append(browser.MakeHLI(val, "Argument"))
-
-        try:
-            fkind = self.funckinds[fd[3]]
-        except KeyError:
-            fkind = "Unknown"
-        ret.append(browser.MakeHLI(fkind, "Function Kind"))
-        try:
-            ikind = self.invokekinds[fd[4]]
-        except KeyError:
-            ikind = "Unknown"
-        ret.append(browser.MakeHLI(ikind, "Invoke Kind"))
-        # 5 = call conv
-        # 5 = offset vtbl
-        ret.append(browser.MakeHLI(fd[6], "Number Optional Params"))
-        flagDescs = []
-        for flag, desc in self.funcflags:
-            if flag & fd[9]:
-                flagDescs.append(desc)
-        if flagDescs:
-            ret.append(browser.MakeHLI(", ".join(flagDescs), "Function Flags"))
-        return ret
-
-
-HLITypeKinds = {
-    pythoncom.TKIND_ENUM: (HLITypeLibEnum, "Enumeration"),
-    pythoncom.TKIND_RECORD: (HLITypeLibEntry, "Record"),
-    pythoncom.TKIND_MODULE: (HLITypeLibEnum, "Module"),
-    pythoncom.TKIND_INTERFACE: (HLITypeLibMethod, "Interface"),
-    pythoncom.TKIND_DISPATCH: (HLITypeLibMethod, "Dispatch"),
-    pythoncom.TKIND_COCLASS: (HLICoClass, "CoClass"),
-    pythoncom.TKIND_ALIAS: (HLITypeLibEntry, "Alias"),
-    pythoncom.TKIND_UNION: (HLITypeLibEntry, "Union"),
-}
-
-
-class HLITypeLib(HLICOM):
-    def GetSubList(self):
-        ret = []
-        ret.append(browser.MakeHLI(self.myobject, "Filename"))
-        try:
-            tlb = pythoncom.LoadTypeLib(self.myobject)
-        except pythoncom.com_error:
-            return [browser.MakeHLI("%s can not be loaded" % self.myobject)]
-
-        for i in range(tlb.GetTypeInfoCount()):
-            try:
-                ret.append(HLITypeKinds[tlb.GetTypeInfoType(i)][0]((tlb, i)))
-            except pythoncom.com_error:
-                ret.append(browser.MakeHLI("The type info can not be loaded!"))
-        ret.sort()
-        return ret
-
-
-class HLIHeadingRegisterdTypeLibs(HLICOM):
-    "A tree heading for registered type libraries"
-
-    def GetText(self):
-        return "Registered Type Libraries"
-
-    def GetSubList(self):
-        # Explicit lookup in the registry.
-        ret = []
-        key = win32api.RegOpenKey(win32con.HKEY_CLASSES_ROOT, "TypeLib")
-        win32ui.DoWaitCursor(1)
-        try:
-            num = 0
-            while 1:
-                try:
-                    keyName = win32api.RegEnumKey(key, num)
-                except win32api.error:
-                    break
-                # Enumerate all version info
-                subKey = win32api.RegOpenKey(key, keyName)
-                name = None
-                try:
-                    subNum = 0
-                    bestVersion = 0.0
-                    while 1:
-                        try:
-                            versionStr = win32api.RegEnumKey(subKey, subNum)
-                        except win32api.error:
-                            break
-                        try:
-                            versionFlt = float(versionStr)
-                        except ValueError:
-                            versionFlt = 0  # ????
-                        if versionFlt > bestVersion:
-                            bestVersion = versionFlt
-                            name = win32api.RegQueryValue(subKey, versionStr)
-                        subNum = subNum + 1
-                finally:
-                    win32api.RegCloseKey(subKey)
-                if name is not None:
-                    ret.append(HLIRegisteredTypeLibrary((keyName, versionStr), name))
-                num = num + 1
-        finally:
-            win32api.RegCloseKey(key)
-            win32ui.DoWaitCursor(0)
-        ret.sort()
-        return ret
-
-
-def main(modal=True, mdi=False):
-    from pywin.tools import hierlist
-
-    root = HLIRoot("COM Browser")
-    if mdi and "pywin.framework.app" in sys.modules:
-        # do it in a MDI window
-        browser.MakeTemplate()
-        browser.template.OpenObject(root)
-    else:
-        dlg = browser.dynamic_browser(root)
-        if modal:
-            dlg.DoModal()
-        else:
-            dlg.CreateWindow()
-            dlg.ShowWindow()
-
-
-if __name__ == "__main__":
-    main(modal=win32api.GetConsoleTitle())
-
-    ni = pythoncom._GetInterfaceCount()
-    ng = pythoncom._GetGatewayCount()
-    if ni or ng:
-        print("Warning - exiting with %d/%d objects alive" % (ni, ng))
diff --git a/lib/win32com/client/connect.py b/lib/win32com/client/connect.py
deleted file mode 100644
index 24788204..00000000
--- a/lib/win32com/client/connect.py
+++ /dev/null
@@ -1,48 +0,0 @@
-"""Utilities for working with Connections"""
-import pythoncom
-import win32com.server.util
-
-
-class SimpleConnection:
-    "A simple, single connection object"
-
-    def __init__(self, coInstance=None, eventInstance=None, eventCLSID=None, debug=0):
-        self.cp = None
-        self.cookie = None
-        self.debug = debug
-        if not coInstance is None:
-            self.Connect(coInstance, eventInstance, eventCLSID)
-
-    def __del__(self):
-        try:
-            self.Disconnect()
-        except pythoncom.error:
-            # Ignore disconnection as we are torn down.
-            pass
-
-    def _wrap(self, obj):
-        useDispatcher = None
-        if self.debug:
-            from win32com.server import dispatcher
-
-            useDispatcher = dispatcher.DefaultDebugDispatcher
-        return win32com.server.util.wrap(obj, useDispatcher=useDispatcher)
-
-    def Connect(self, coInstance, eventInstance, eventCLSID=None):
-        try:
-            oleobj = coInstance._oleobj_
-        except AttributeError:
-            oleobj = coInstance
-        cpc = oleobj.QueryInterface(pythoncom.IID_IConnectionPointContainer)
-        if eventCLSID is None:
-            eventCLSID = eventInstance.CLSID
-        comEventInstance = self._wrap(eventInstance)
-        self.cp = cpc.FindConnectionPoint(eventCLSID)
-        self.cookie = self.cp.Advise(comEventInstance)
-
-    def Disconnect(self):
-        if not self.cp is None:
-            if self.cookie:
-                self.cp.Unadvise(self.cookie)
-                self.cookie = None
-            self.cp = None
diff --git a/lib/win32com/client/dynamic.py b/lib/win32com/client/dynamic.py
deleted file mode 100644
index 449ad928..00000000
--- a/lib/win32com/client/dynamic.py
+++ /dev/null
@@ -1,708 +0,0 @@
-"""Support for dynamic COM client support.
-
-Introduction
- Dynamic COM client support is the ability to use a COM server without
- prior knowledge of the server.  This can be used to talk to almost all
- COM servers, including much of MS Office.
-
- In general, you should not use this module directly - see below.
-
-Example
- >>> import win32com.client
- >>> xl = win32com.client.Dispatch("Excel.Application")
- # The line above invokes the functionality of this class.
- # xl is now an object we can use to talk to Excel.
- >>> xl.Visible = 1 # The Excel window becomes visible.
-
-"""
-import traceback
-import types
-
-import pythoncom  # Needed as code we eval() references it.
-import win32com.client
-import winerror
-from pywintypes import IIDType
-
-from . import build
-
-debugging = 0  # General debugging
-debugging_attr = 0  # Debugging dynamic attribute lookups.
-
-LCID = 0x0
-
-# These errors generally mean the property or method exists,
-# but can't be used in this context - eg, property instead of a method, etc.
-# Used to determine if we have a real error or not.
-ERRORS_BAD_CONTEXT = [
-    winerror.DISP_E_MEMBERNOTFOUND,
-    winerror.DISP_E_BADPARAMCOUNT,
-    winerror.DISP_E_PARAMNOTOPTIONAL,
-    winerror.DISP_E_TYPEMISMATCH,
-    winerror.E_INVALIDARG,
-]
-
-ALL_INVOKE_TYPES = [
-    pythoncom.INVOKE_PROPERTYGET,
-    pythoncom.INVOKE_PROPERTYPUT,
-    pythoncom.INVOKE_PROPERTYPUTREF,
-    pythoncom.INVOKE_FUNC,
-]
-
-
-def debug_print(*args):
-    if debugging:
-        for arg in args:
-            print(arg, end=" ")
-        print()
-
-
-def debug_attr_print(*args):
-    if debugging_attr:
-        for arg in args:
-            print(arg, end=" ")
-        print()
-
-
-def MakeMethod(func, inst, cls):
-    return types.MethodType(func, inst)
-
-
-# get the type objects for IDispatch and IUnknown
-PyIDispatchType = pythoncom.TypeIIDs[pythoncom.IID_IDispatch]
-PyIUnknownType = pythoncom.TypeIIDs[pythoncom.IID_IUnknown]
-
-_GoodDispatchTypes = (str, IIDType)
-_defaultDispatchItem = build.DispatchItem
-
-
-def _GetGoodDispatch(IDispatch, clsctx=pythoncom.CLSCTX_SERVER):
-    # quick return for most common case
-    if isinstance(IDispatch, PyIDispatchType):
-        return IDispatch
-    if isinstance(IDispatch, _GoodDispatchTypes):
-        try:
-            IDispatch = pythoncom.connect(IDispatch)
-        except pythoncom.ole_error:
-            IDispatch = pythoncom.CoCreateInstance(
-                IDispatch, None, clsctx, pythoncom.IID_IDispatch
-            )
-    else:
-        # may already be a wrapped class.
-        IDispatch = getattr(IDispatch, "_oleobj_", IDispatch)
-    return IDispatch
-
-
-def _GetGoodDispatchAndUserName(IDispatch, userName, clsctx):
-    # Get a dispatch object, and a 'user name' (ie, the name as
-    # displayed to the user in repr() etc.
-    if userName is None:
-        if isinstance(IDispatch, str):
-            userName = IDispatch
-        ## ??? else userName remains None ???
-    else:
-        userName = str(userName)
-    return (_GetGoodDispatch(IDispatch, clsctx), userName)
-
-
-def _GetDescInvokeType(entry, invoke_type):
-    # determine the wFlags argument passed as input to IDispatch::Invoke
-    # Only ever called by __getattr__ and __setattr__ from dynamic objects!
-    # * `entry` is a MapEntry with whatever typeinfo we have about the property we are getting/setting.
-    # * `invoke_type` is either INVOKE_PROPERTYGET | INVOKE_PROPERTYSET and really just
-    #   means "called by __getattr__" or "called by __setattr__"
-    if not entry or not entry.desc:
-        return invoke_type
-
-    if entry.desc.desckind == pythoncom.DESCKIND_VARDESC:
-        return invoke_type
-
-    # So it's a FUNCDESC - just use what it specifies.
-    return entry.desc.invkind
-
-
-def Dispatch(
-    IDispatch,
-    userName=None,
-    createClass=None,
-    typeinfo=None,
-    UnicodeToString=None,
-    clsctx=pythoncom.CLSCTX_SERVER,
-):
-    assert UnicodeToString is None, "this is deprecated and will go away"
-    IDispatch, userName = _GetGoodDispatchAndUserName(IDispatch, userName, clsctx)
-    if createClass is None:
-        createClass = CDispatch
-    lazydata = None
-    try:
-        if typeinfo is None:
-            typeinfo = IDispatch.GetTypeInfo()
-        if typeinfo is not None:
-            try:
-                # try for a typecomp
-                typecomp = typeinfo.GetTypeComp()
-                lazydata = typeinfo, typecomp
-            except pythoncom.com_error:
-                pass
-    except pythoncom.com_error:
-        typeinfo = None
-    olerepr = MakeOleRepr(IDispatch, typeinfo, lazydata)
-    return createClass(IDispatch, olerepr, userName, lazydata=lazydata)
-
-
-def MakeOleRepr(IDispatch, typeinfo, typecomp):
-    olerepr = None
-    if typeinfo is not None:
-        try:
-            attr = typeinfo.GetTypeAttr()
-            # If the type info is a special DUAL interface, magically turn it into
-            # a DISPATCH typeinfo.
-            if (
-                attr[5] == pythoncom.TKIND_INTERFACE
-                and attr[11] & pythoncom.TYPEFLAG_FDUAL
-            ):
-                # Get corresponding Disp interface;
-                # -1 is a special value which does this for us.
-                href = typeinfo.GetRefTypeOfImplType(-1)
-                typeinfo = typeinfo.GetRefTypeInfo(href)
-                attr = typeinfo.GetTypeAttr()
-            if typecomp is None:
-                olerepr = build.DispatchItem(typeinfo, attr, None, 0)
-            else:
-                olerepr = build.LazyDispatchItem(attr, None)
-        except pythoncom.ole_error:
-            pass
-    if olerepr is None:
-        olerepr = build.DispatchItem()
-    return olerepr
-
-
-def DumbDispatch(
-    IDispatch,
-    userName=None,
-    createClass=None,
-    UnicodeToString=None,
-    clsctx=pythoncom.CLSCTX_SERVER,
-):
-    "Dispatch with no type info"
-    assert UnicodeToString is None, "this is deprecated and will go away"
-    IDispatch, userName = _GetGoodDispatchAndUserName(IDispatch, userName, clsctx)
-    if createClass is None:
-        createClass = CDispatch
-    return createClass(IDispatch, build.DispatchItem(), userName)
-
-
-class CDispatch:
-    def __init__(
-        self, IDispatch, olerepr, userName=None, UnicodeToString=None, lazydata=None
-    ):
-        assert UnicodeToString is None, "this is deprecated and will go away"
-        if userName is None:
-            userName = "<unknown>"
-        self.__dict__["_oleobj_"] = IDispatch
-        self.__dict__["_username_"] = userName
-        self.__dict__["_olerepr_"] = olerepr
-        self.__dict__["_mapCachedItems_"] = {}
-        self.__dict__["_builtMethods_"] = {}
-        self.__dict__["_enum_"] = None
-        self.__dict__["_unicode_to_string_"] = None
-        self.__dict__["_lazydata_"] = lazydata
-
-    def __call__(self, *args):
-        "Provide 'default dispatch' COM functionality - allow instance to be called"
-        if self._olerepr_.defaultDispatchName:
-            invkind, dispid = self._find_dispatch_type_(
-                self._olerepr_.defaultDispatchName
-            )
-        else:
-            invkind, dispid = (
-                pythoncom.DISPATCH_METHOD | pythoncom.DISPATCH_PROPERTYGET,
-                pythoncom.DISPID_VALUE,
-            )
-        if invkind is not None:
-            allArgs = (dispid, LCID, invkind, 1) + args
-            return self._get_good_object_(
-                self._oleobj_.Invoke(*allArgs), self._olerepr_.defaultDispatchName, None
-            )
-        raise TypeError("This dispatch object does not define a default method")
-
-    def __bool__(self):
-        return True  # ie "if object:" should always be "true" - without this, __len__ is tried.
-        # _Possibly_ want to defer to __len__ if available, but Im not sure this is
-        # desirable???
-
-    def __repr__(self):
-        return "<COMObject %s>" % (self._username_)
-
-    def __str__(self):
-        # __str__ is used when the user does "print object", so we gracefully
-        # fall back to the __repr__ if the object has no default method.
-        try:
-            return str(self.__call__())
-        except pythoncom.com_error as details:
-            if details.hresult not in ERRORS_BAD_CONTEXT:
-                raise
-            return self.__repr__()
-
-    def __dir__(self):
-        lst = list(self.__dict__.keys()) + dir(self.__class__) + self._dir_ole_()
-        try:
-            lst += [p.Name for p in self.Properties_]
-        except AttributeError:
-            pass
-        return list(set(lst))
-
-    def _dir_ole_(self):
-        items_dict = {}
-        for iTI in range(0, self._oleobj_.GetTypeInfoCount()):
-            typeInfo = self._oleobj_.GetTypeInfo(iTI)
-            self._UpdateWithITypeInfo_(items_dict, typeInfo)
-        return list(items_dict.keys())
-
-    def _UpdateWithITypeInfo_(self, items_dict, typeInfo):
-        typeInfos = [typeInfo]
-        # suppress IDispatch and IUnknown methods
-        inspectedIIDs = {pythoncom.IID_IDispatch: None}
-
-        while len(typeInfos) > 0:
-            typeInfo = typeInfos.pop()
-            typeAttr = typeInfo.GetTypeAttr()
-
-            if typeAttr.iid not in inspectedIIDs:
-                inspectedIIDs[typeAttr.iid] = None
-                for iFun in range(0, typeAttr.cFuncs):
-                    funDesc = typeInfo.GetFuncDesc(iFun)
-                    funName = typeInfo.GetNames(funDesc.memid)[0]
-                    if funName not in items_dict:
-                        items_dict[funName] = None
-
-                # Inspect the type info of all implemented types
-                # E.g. IShellDispatch5 implements IShellDispatch4 which implements IShellDispatch3 ...
-                for iImplType in range(0, typeAttr.cImplTypes):
-                    iRefType = typeInfo.GetRefTypeOfImplType(iImplType)
-                    refTypeInfo = typeInfo.GetRefTypeInfo(iRefType)
-                    typeInfos.append(refTypeInfo)
-
-    # Delegate comparison to the oleobjs, as they know how to do identity.
-    def __eq__(self, other):
-        other = getattr(other, "_oleobj_", other)
-        return self._oleobj_ == other
-
-    def __ne__(self, other):
-        other = getattr(other, "_oleobj_", other)
-        return self._oleobj_ != other
-
-    def __int__(self):
-        return int(self.__call__())
-
-    def __len__(self):
-        invkind, dispid = self._find_dispatch_type_("Count")
-        if invkind:
-            return self._oleobj_.Invoke(dispid, LCID, invkind, 1)
-        raise TypeError("This dispatch object does not define a Count method")
-
-    def _NewEnum(self):
-        try:
-            invkind = pythoncom.DISPATCH_METHOD | pythoncom.DISPATCH_PROPERTYGET
-            enum = self._oleobj_.InvokeTypes(
-                pythoncom.DISPID_NEWENUM, LCID, invkind, (13, 10), ()
-            )
-        except pythoncom.com_error:
-            return None  # no enumerator for this object.
-        from . import util
-
-        return util.WrapEnum(enum, None)
-
-    def __getitem__(self, index):  # syver modified
-        # Improved __getitem__ courtesy Syver Enstad
-        # Must check _NewEnum before Item, to ensure b/w compat.
-        if isinstance(index, int):
-            if self.__dict__["_enum_"] is None:
-                self.__dict__["_enum_"] = self._NewEnum()
-            if self.__dict__["_enum_"] is not None:
-                return self._get_good_object_(self._enum_.__getitem__(index))
-        # See if we have an "Item" method/property we can use (goes hand in hand with Count() above!)
-        invkind, dispid = self._find_dispatch_type_("Item")
-        if invkind is not None:
-            return self._get_good_object_(
-                self._oleobj_.Invoke(dispid, LCID, invkind, 1, index)
-            )
-        raise TypeError("This object does not support enumeration")
-
-    def __setitem__(self, index, *args):
-        # XXX - todo - We should support calling Item() here too!
-        # 		print "__setitem__ with", index, args
-        if self._olerepr_.defaultDispatchName:
-            invkind, dispid = self._find_dispatch_type_(
-                self._olerepr_.defaultDispatchName
-            )
-        else:
-            invkind, dispid = (
-                pythoncom.DISPATCH_PROPERTYPUT | pythoncom.DISPATCH_PROPERTYPUTREF,
-                pythoncom.DISPID_VALUE,
-            )
-        if invkind is not None:
-            allArgs = (dispid, LCID, invkind, 0, index) + args
-            return self._get_good_object_(
-                self._oleobj_.Invoke(*allArgs), self._olerepr_.defaultDispatchName, None
-            )
-        raise TypeError("This dispatch object does not define a default method")
-
-    def _find_dispatch_type_(self, methodName):
-        if methodName in self._olerepr_.mapFuncs:
-            item = self._olerepr_.mapFuncs[methodName]
-            return item.desc[4], item.dispid
-
-        if methodName in self._olerepr_.propMapGet:
-            item = self._olerepr_.propMapGet[methodName]
-            return item.desc[4], item.dispid
-
-        try:
-            dispid = self._oleobj_.GetIDsOfNames(0, methodName)
-        except:  ### what error?
-            return None, None
-        return pythoncom.DISPATCH_METHOD | pythoncom.DISPATCH_PROPERTYGET, dispid
-
-    def _ApplyTypes_(self, dispid, wFlags, retType, argTypes, user, resultCLSID, *args):
-        result = self._oleobj_.InvokeTypes(
-            *(dispid, LCID, wFlags, retType, argTypes) + args
-        )
-        return self._get_good_object_(result, user, resultCLSID)
-
-    def _wrap_dispatch_(
-        self, ob, userName=None, returnCLSID=None, UnicodeToString=None
-    ):
-        # Given a dispatch object, wrap it in a class
-        assert UnicodeToString is None, "this is deprecated and will go away"
-        return Dispatch(ob, userName)
-
-    def _get_good_single_object_(self, ob, userName=None, ReturnCLSID=None):
-        if isinstance(ob, PyIDispatchType):
-            # make a new instance of (probably this) class.
-            return self._wrap_dispatch_(ob, userName, ReturnCLSID)
-        if isinstance(ob, PyIUnknownType):
-            try:
-                ob = ob.QueryInterface(pythoncom.IID_IDispatch)
-            except pythoncom.com_error:
-                # It is an IUnknown, but not an IDispatch, so just let it through.
-                return ob
-            return self._wrap_dispatch_(ob, userName, ReturnCLSID)
-        return ob
-
-    def _get_good_object_(self, ob, userName=None, ReturnCLSID=None):
-        """Given an object (usually the retval from a method), make it a good object to return.
-        Basically checks if it is a COM object, and wraps it up.
-        Also handles the fact that a retval may be a tuple of retvals"""
-        if ob is None:  # Quick exit!
-            return None
-        elif isinstance(ob, tuple):
-            return tuple(
-                map(
-                    lambda o, s=self, oun=userName, rc=ReturnCLSID: s._get_good_single_object_(
-                        o, oun, rc
-                    ),
-                    ob,
-                )
-            )
-        else:
-            return self._get_good_single_object_(ob)
-
-    def _make_method_(self, name):
-        "Make a method object - Assumes in olerepr funcmap"
-        methodName = build.MakePublicAttributeName(name)  # translate keywords etc.
-        methodCodeList = self._olerepr_.MakeFuncMethod(
-            self._olerepr_.mapFuncs[name], methodName, 0
-        )
-        methodCode = "\n".join(methodCodeList)
-        try:
-            # 			print "Method code for %s is:\n" % self._username_, methodCode
-            # 			self._print_details_()
-            codeObject = compile(methodCode, "<COMObject %s>" % self._username_, "exec")
-            # Exec the code object
-            tempNameSpace = {}
-            # "Dispatch" in the exec'd code is win32com.client.Dispatch, not ours.
-            globNameSpace = globals().copy()
-            globNameSpace["Dispatch"] = win32com.client.Dispatch
-            exec(
-                codeObject, globNameSpace, tempNameSpace
-            )  # self.__dict__, self.__dict__
-            name = methodName
-            # Save the function in map.
-            fn = self._builtMethods_[name] = tempNameSpace[name]
-            newMeth = MakeMethod(fn, self, self.__class__)
-            return newMeth
-        except:
-            debug_print("Error building OLE definition for code ", methodCode)
-            traceback.print_exc()
-        return None
-
-    def _Release_(self):
-        """Cleanup object - like a close - to force cleanup when you dont
-        want to rely on Python's reference counting."""
-        for childCont in self._mapCachedItems_.values():
-            childCont._Release_()
-        self._mapCachedItems_ = {}
-        if self._oleobj_:
-            self._oleobj_.Release()
-            self.__dict__["_oleobj_"] = None
-        if self._olerepr_:
-            self.__dict__["_olerepr_"] = None
-        self._enum_ = None
-
-    def _proc_(self, name, *args):
-        """Call the named method as a procedure, rather than function.
-        Mainly used by Word.Basic, which whinges about such things."""
-        try:
-            item = self._olerepr_.mapFuncs[name]
-            dispId = item.dispid
-            return self._get_good_object_(
-                self._oleobj_.Invoke(*(dispId, LCID, item.desc[4], 0) + (args))
-            )
-        except KeyError:
-            raise AttributeError(name)
-
-    def _print_details_(self):
-        "Debug routine - dumps what it knows about an object."
-        print("AxDispatch container", self._username_)
-        try:
-            print("Methods:")
-            for method in self._olerepr_.mapFuncs.keys():
-                print("\t", method)
-            print("Props:")
-            for prop, entry in self._olerepr_.propMap.items():
-                print("\t%s = 0x%x - %s" % (prop, entry.dispid, repr(entry)))
-            print("Get Props:")
-            for prop, entry in self._olerepr_.propMapGet.items():
-                print("\t%s = 0x%x - %s" % (prop, entry.dispid, repr(entry)))
-            print("Put Props:")
-            for prop, entry in self._olerepr_.propMapPut.items():
-                print("\t%s = 0x%x - %s" % (prop, entry.dispid, repr(entry)))
-        except:
-            traceback.print_exc()
-
-    def __LazyMap__(self, attr):
-        try:
-            if self._LazyAddAttr_(attr):
-                debug_attr_print(
-                    "%s.__LazyMap__(%s) added something" % (self._username_, attr)
-                )
-                return 1
-        except AttributeError:
-            return 0
-
-    # Using the typecomp, lazily create a new attribute definition.
-    def _LazyAddAttr_(self, attr):
-        if self._lazydata_ is None:
-            return 0
-        res = 0
-        typeinfo, typecomp = self._lazydata_
-        olerepr = self._olerepr_
-        # We need to explicitly check each invoke type individually - simply
-        # specifying '0' will bind to "any member", which may not be the one
-        # we are actually after (ie, we may be after prop_get, but returned
-        # the info for the prop_put.)
-        for i in ALL_INVOKE_TYPES:
-            try:
-                x, t = typecomp.Bind(attr, i)
-                # Support 'Get' and 'Set' properties - see
-                # bug 1587023
-                if x == 0 and attr[:3] in ("Set", "Get"):
-                    x, t = typecomp.Bind(attr[3:], i)
-                if x == pythoncom.DESCKIND_FUNCDESC:  # it's a FUNCDESC
-                    r = olerepr._AddFunc_(typeinfo, t, 0)
-                elif x == pythoncom.DESCKIND_VARDESC:  # it's a VARDESC
-                    r = olerepr._AddVar_(typeinfo, t, 0)
-                else:  # not found or TYPEDESC/IMPLICITAPP
-                    r = None
-                if not r is None:
-                    key, map = r[0], r[1]
-                    item = map[key]
-                    if map == olerepr.propMapPut:
-                        olerepr._propMapPutCheck_(key, item)
-                    elif map == olerepr.propMapGet:
-                        olerepr._propMapGetCheck_(key, item)
-                    res = 1
-            except:
-                pass
-        return res
-
-    def _FlagAsMethod(self, *methodNames):
-        """Flag these attribute names as being methods.
-        Some objects do not correctly differentiate methods and
-        properties, leading to problems when calling these methods.
-
-        Specifically, trying to say: ob.SomeFunc()
-        may yield an exception "None object is not callable"
-        In this case, an attempt to fetch the *property* has worked
-        and returned None, rather than indicating it is really a method.
-        Calling: ob._FlagAsMethod("SomeFunc")
-        should then allow this to work.
-        """
-        for name in methodNames:
-            details = build.MapEntry(self.__AttrToID__(name), (name,))
-            self._olerepr_.mapFuncs[name] = details
-
-    def __AttrToID__(self, attr):
-        debug_attr_print(
-            "Calling GetIDsOfNames for property %s in Dispatch container %s"
-            % (attr, self._username_)
-        )
-        return self._oleobj_.GetIDsOfNames(0, attr)
-
-    def __getattr__(self, attr):
-        if attr == "__iter__":
-            # We can't handle this as a normal method, as if the attribute
-            # exists, then it must return an iterable object.
-            try:
-                invkind = pythoncom.DISPATCH_METHOD | pythoncom.DISPATCH_PROPERTYGET
-                enum = self._oleobj_.InvokeTypes(
-                    pythoncom.DISPID_NEWENUM, LCID, invkind, (13, 10), ()
-                )
-            except pythoncom.com_error:
-                raise AttributeError("This object can not function as an iterator")
-
-            # We must return a callable object.
-            class Factory:
-                def __init__(self, ob):
-                    self.ob = ob
-
-                def __call__(self):
-                    import win32com.client.util
-
-                    return win32com.client.util.Iterator(self.ob)
-
-            return Factory(enum)
-
-        if attr.startswith("_") and attr.endswith("_"):  # Fast-track.
-            raise AttributeError(attr)
-        # If a known method, create new instance and return.
-        try:
-            return MakeMethod(self._builtMethods_[attr], self, self.__class__)
-        except KeyError:
-            pass
-        # XXX - Note that we current are case sensitive in the method.
-        # debug_attr_print("GetAttr called for %s on DispatchContainer %s" % (attr,self._username_))
-        # First check if it is in the method map.  Note that an actual method
-        # must not yet exist, (otherwise we would not be here).  This
-        # means we create the actual method object - which also means
-        # this code will never be asked for that method name again.
-        if attr in self._olerepr_.mapFuncs:
-            return self._make_method_(attr)
-
-        # Delegate to property maps/cached items
-        retEntry = None
-        if self._olerepr_ and self._oleobj_:
-            # first check general property map, then specific "put" map.
-            retEntry = self._olerepr_.propMap.get(attr)
-            if retEntry is None:
-                retEntry = self._olerepr_.propMapGet.get(attr)
-            # Not found so far - See what COM says.
-            if retEntry is None:
-                try:
-                    if self.__LazyMap__(attr):
-                        if attr in self._olerepr_.mapFuncs:
-                            return self._make_method_(attr)
-                        retEntry = self._olerepr_.propMap.get(attr)
-                        if retEntry is None:
-                            retEntry = self._olerepr_.propMapGet.get(attr)
-                    if retEntry is None:
-                        retEntry = build.MapEntry(self.__AttrToID__(attr), (attr,))
-                except pythoncom.ole_error:
-                    pass  # No prop by that name - retEntry remains None.
-
-        if retEntry is not None:  # see if in my cache
-            try:
-                ret = self._mapCachedItems_[retEntry.dispid]
-                debug_attr_print("Cached items has attribute!", ret)
-                return ret
-            except (KeyError, AttributeError):
-                debug_attr_print("Attribute %s not in cache" % attr)
-
-        # If we are still here, and have a retEntry, get the OLE item
-        if retEntry is not None:
-            invoke_type = _GetDescInvokeType(retEntry, pythoncom.INVOKE_PROPERTYGET)
-            debug_attr_print(
-                "Getting property Id 0x%x from OLE object" % retEntry.dispid
-            )
-            try:
-                ret = self._oleobj_.Invoke(retEntry.dispid, 0, invoke_type, 1)
-            except pythoncom.com_error as details:
-                if details.hresult in ERRORS_BAD_CONTEXT:
-                    # May be a method.
-                    self._olerepr_.mapFuncs[attr] = retEntry
-                    return self._make_method_(attr)
-                raise
-            debug_attr_print("OLE returned ", ret)
-            return self._get_good_object_(ret)
-
-        # no where else to look.
-        raise AttributeError("%s.%s" % (self._username_, attr))
-
-    def __setattr__(self, attr, value):
-        if (
-            attr in self.__dict__
-        ):  # Fast-track - if already in our dict, just make the assignment.
-            # XXX - should maybe check method map - if someone assigns to a method,
-            # it could mean something special (not sure what, tho!)
-            self.__dict__[attr] = value
-            return
-        # Allow property assignment.
-        debug_attr_print(
-            "SetAttr called for %s.%s=%s on DispatchContainer"
-            % (self._username_, attr, repr(value))
-        )
-
-        if self._olerepr_:
-            # Check the "general" property map.
-            if attr in self._olerepr_.propMap:
-                entry = self._olerepr_.propMap[attr]
-                invoke_type = _GetDescInvokeType(entry, pythoncom.INVOKE_PROPERTYPUT)
-                self._oleobj_.Invoke(entry.dispid, 0, invoke_type, 0, value)
-                return
-            # Check the specific "put" map.
-            if attr in self._olerepr_.propMapPut:
-                entry = self._olerepr_.propMapPut[attr]
-                invoke_type = _GetDescInvokeType(entry, pythoncom.INVOKE_PROPERTYPUT)
-                self._oleobj_.Invoke(entry.dispid, 0, invoke_type, 0, value)
-                return
-
-        # Try the OLE Object
-        if self._oleobj_:
-            if self.__LazyMap__(attr):
-                # Check the "general" property map.
-                if attr in self._olerepr_.propMap:
-                    entry = self._olerepr_.propMap[attr]
-                    invoke_type = _GetDescInvokeType(
-                        entry, pythoncom.INVOKE_PROPERTYPUT
-                    )
-                    self._oleobj_.Invoke(entry.dispid, 0, invoke_type, 0, value)
-                    return
-                # Check the specific "put" map.
-                if attr in self._olerepr_.propMapPut:
-                    entry = self._olerepr_.propMapPut[attr]
-                    invoke_type = _GetDescInvokeType(
-                        entry, pythoncom.INVOKE_PROPERTYPUT
-                    )
-                    self._oleobj_.Invoke(entry.dispid, 0, invoke_type, 0, value)
-                    return
-            try:
-                entry = build.MapEntry(self.__AttrToID__(attr), (attr,))
-            except pythoncom.com_error:
-                # No attribute of that name
-                entry = None
-            if entry is not None:
-                try:
-                    invoke_type = _GetDescInvokeType(
-                        entry, pythoncom.INVOKE_PROPERTYPUT
-                    )
-                    self._oleobj_.Invoke(entry.dispid, 0, invoke_type, 0, value)
-                    self._olerepr_.propMap[attr] = entry
-                    debug_attr_print(
-                        "__setattr__ property %s (id=0x%x) in Dispatch container %s"
-                        % (attr, entry.dispid, self._username_)
-                    )
-                    return
-                except pythoncom.com_error:
-                    pass
-        raise AttributeError(
-            "Property '%s.%s' can not be set." % (self._username_, attr)
-        )
diff --git a/lib/win32com/client/gencache.py b/lib/win32com/client/gencache.py
deleted file mode 100644
index 99e9c6cb..00000000
--- a/lib/win32com/client/gencache.py
+++ /dev/null
@@ -1,799 +0,0 @@
-"""Manages the cache of generated Python code.
-
-Description
-  This file manages the cache of generated Python code.  When run from the
-  command line, it also provides a number of options for managing that cache.
-
-Implementation
-  Each typelib is generated into a filename of format "{guid}x{lcid}x{major}x{minor}.py"
-
-  An external persistant dictionary maps from all known IIDs in all known type libraries
-  to the type library itself.
-
-  Thus, whenever Python code knows the IID of an object, it can find the IID, LCID and version of
-  the type library which supports it.  Given this information, it can find the Python module
-  with the support.
-
-  If necessary, this support can be generated on the fly.
-
-Hacks, to do, etc
-  Currently just uses a pickled dictionary, but should used some sort of indexed file.
-  Maybe an OLE2 compound file, or a bsddb file?
-"""
-import glob
-import os
-import sys
-from importlib import reload
-
-import pythoncom
-import pywintypes
-import win32com
-import win32com.client
-
-from . import CLSIDToClass
-
-bForDemandDefault = 0  # Default value of bForDemand - toggle this to change the world - see also makepy.py
-
-# The global dictionary
-clsidToTypelib = {}
-
-# If we have a different version of the typelib generated, this
-# maps the "requested version" to the "generated version".
-versionRedirectMap = {}
-
-# There is no reason we *must* be readonly in a .zip, but we are now,
-# Rather than check for ".zip" or other tricks, PEP302 defines
-# a "__loader__" attribute, so we use that.
-# (Later, it may become necessary to check if the __loader__ can update files,
-# as a .zip loader potentially could - but punt all that until a need arises)
-is_readonly = is_zip = hasattr(win32com, "__loader__") and hasattr(
-    win32com.__loader__, "archive"
-)
-
-# A dictionary of ITypeLibrary objects for demand generation explicitly handed to us
-# Keyed by usual clsid, lcid, major, minor
-demandGeneratedTypeLibraries = {}
-
-import pickle as pickle
-
-
-def __init__():
-    # Initialize the module.  Called once explicitly at module import below.
-    try:
-        _LoadDicts()
-    except IOError:
-        Rebuild()
-
-
-pickleVersion = 1
-
-
-def _SaveDicts():
-    if is_readonly:
-        raise RuntimeError(
-            "Trying to write to a readonly gencache ('%s')!" % win32com.__gen_path__
-        )
-    f = open(os.path.join(GetGeneratePath(), "dicts.dat"), "wb")
-    try:
-        p = pickle.Pickler(f)
-        p.dump(pickleVersion)
-        p.dump(clsidToTypelib)
-    finally:
-        f.close()
-
-
-def _LoadDicts():
-    # Load the dictionary from a .zip file if that is where we live.
-    if is_zip:
-        import io as io
-
-        loader = win32com.__loader__
-        arc_path = loader.archive
-        dicts_path = os.path.join(win32com.__gen_path__, "dicts.dat")
-        if dicts_path.startswith(arc_path):
-            dicts_path = dicts_path[len(arc_path) + 1 :]
-        else:
-            # Hm. See below.
-            return
-        try:
-            data = loader.get_data(dicts_path)
-        except AttributeError:
-            # The __loader__ has no get_data method.  See below.
-            return
-        except IOError:
-            # Our gencache is in a .zip file (and almost certainly readonly)
-            # but no dicts file.  That actually needn't be fatal for a frozen
-            # application.  Assuming they call "EnsureModule" with the same
-            # typelib IDs they have been frozen with, that EnsureModule will
-            # correctly re-build the dicts on the fly.  However, objects that
-            # rely on the gencache but have not done an EnsureModule will
-            # fail (but their apps are likely to fail running from source
-            # with a clean gencache anyway, as then they would be getting
-            # Dynamic objects until the cache is built - so the best answer
-            # for these apps is to call EnsureModule, rather than freezing
-            # the dict)
-            return
-        f = io.BytesIO(data)
-    else:
-        # NOTE: IOError on file open must be caught by caller.
-        f = open(os.path.join(win32com.__gen_path__, "dicts.dat"), "rb")
-    try:
-        p = pickle.Unpickler(f)
-        version = p.load()
-        global clsidToTypelib
-        clsidToTypelib = p.load()
-        versionRedirectMap.clear()
-    finally:
-        f.close()
-
-
-def GetGeneratedFileName(clsid, lcid, major, minor):
-    """Given the clsid, lcid, major and  minor for a type lib, return
-    the file name (no extension) providing this support.
-    """
-    return str(clsid).upper()[1:-1] + "x%sx%sx%s" % (lcid, major, minor)
-
-
-def SplitGeneratedFileName(fname):
-    """Reverse of GetGeneratedFileName()"""
-    return tuple(fname.split("x", 4))
-
-
-def GetGeneratePath():
-    """Returns the name of the path to generate to.
-    Checks the directory is OK.
-    """
-    assert not is_readonly, "Why do you want the genpath for a readonly store?"
-    try:
-        os.makedirs(win32com.__gen_path__)
-        # os.mkdir(win32com.__gen_path__)
-    except os.error:
-        pass
-    try:
-        fname = os.path.join(win32com.__gen_path__, "__init__.py")
-        os.stat(fname)
-    except os.error:
-        f = open(fname, "w")
-        f.write(
-            "# Generated file - this directory may be deleted to reset the COM cache...\n"
-        )
-        f.write("import win32com\n")
-        f.write(
-            "if __path__[:-1] != win32com.__gen_path__: __path__.append(win32com.__gen_path__)\n"
-        )
-        f.close()
-
-    return win32com.__gen_path__
-
-
-#
-# The helpers for win32com.client.Dispatch and OCX clients.
-#
-def GetClassForProgID(progid):
-    """Get a Python class for a Program ID
-
-    Given a Program ID, return a Python class which wraps the COM object
-
-    Returns the Python class, or None if no module is available.
-
-    Params
-    progid -- A COM ProgramID or IID (eg, "Word.Application")
-    """
-    clsid = pywintypes.IID(progid)  # This auto-converts named to IDs.
-    return GetClassForCLSID(clsid)
-
-
-def GetClassForCLSID(clsid):
-    """Get a Python class for a CLSID
-
-    Given a CLSID, return a Python class which wraps the COM object
-
-    Returns the Python class, or None if no module is available.
-
-    Params
-    clsid -- A COM CLSID (or string repr of one)
-    """
-    # first, take a short-cut - we may already have generated support ready-to-roll.
-    clsid = str(clsid)
-    if CLSIDToClass.HasClass(clsid):
-        return CLSIDToClass.GetClass(clsid)
-    mod = GetModuleForCLSID(clsid)
-    if mod is None:
-        return None
-    try:
-        return CLSIDToClass.GetClass(clsid)
-    except KeyError:
-        return None
-
-
-def GetModuleForProgID(progid):
-    """Get a Python module for a Program ID
-
-    Given a Program ID, return a Python module which contains the
-    class which wraps the COM object.
-
-    Returns the Python module, or None if no module is available.
-
-    Params
-    progid -- A COM ProgramID or IID (eg, "Word.Application")
-    """
-    try:
-        iid = pywintypes.IID(progid)
-    except pywintypes.com_error:
-        return None
-    return GetModuleForCLSID(iid)
-
-
-def GetModuleForCLSID(clsid):
-    """Get a Python module for a CLSID
-
-    Given a CLSID, return a Python module which contains the
-    class which wraps the COM object.
-
-    Returns the Python module, or None if no module is available.
-
-    Params
-    progid -- A COM CLSID (ie, not the description)
-    """
-    clsid_str = str(clsid)
-    try:
-        typelibCLSID, lcid, major, minor = clsidToTypelib[clsid_str]
-    except KeyError:
-        return None
-
-    try:
-        mod = GetModuleForTypelib(typelibCLSID, lcid, major, minor)
-    except ImportError:
-        mod = None
-    if mod is not None:
-        sub_mod = mod.CLSIDToPackageMap.get(clsid_str)
-        if sub_mod is None:
-            sub_mod = mod.VTablesToPackageMap.get(clsid_str)
-        if sub_mod is not None:
-            sub_mod_name = mod.__name__ + "." + sub_mod
-            try:
-                __import__(sub_mod_name)
-            except ImportError:
-                info = typelibCLSID, lcid, major, minor
-                # Force the generation.  If this typelibrary has explicitly been added,
-                # use it (it may not be registered, causing a lookup by clsid to fail)
-                if info in demandGeneratedTypeLibraries:
-                    info = demandGeneratedTypeLibraries[info]
-                from . import makepy
-
-                makepy.GenerateChildFromTypeLibSpec(sub_mod, info)
-                # Generate does an import...
-            mod = sys.modules[sub_mod_name]
-    return mod
-
-
-def GetModuleForTypelib(typelibCLSID, lcid, major, minor):
-    """Get a Python module for a type library ID
-
-    Given the CLSID of a typelibrary, return an imported Python module,
-    else None
-
-    Params
-    typelibCLSID -- IID of the type library.
-    major -- Integer major version.
-    minor -- Integer minor version
-    lcid -- Integer LCID for the library.
-    """
-    modName = GetGeneratedFileName(typelibCLSID, lcid, major, minor)
-    mod = _GetModule(modName)
-    # If the import worked, it doesn't mean we have actually added this
-    # module to our cache though - check that here.
-    if "_in_gencache_" not in mod.__dict__:
-        AddModuleToCache(typelibCLSID, lcid, major, minor)
-        assert "_in_gencache_" in mod.__dict__
-    return mod
-
-
-def MakeModuleForTypelib(
-    typelibCLSID,
-    lcid,
-    major,
-    minor,
-    progressInstance=None,
-    bForDemand=bForDemandDefault,
-    bBuildHidden=1,
-):
-    """Generate support for a type library.
-
-    Given the IID, LCID and version information for a type library, generate
-    and import the necessary support files.
-
-    Returns the Python module.  No exceptions are caught.
-
-    Params
-    typelibCLSID -- IID of the type library.
-    major -- Integer major version.
-    minor -- Integer minor version.
-    lcid -- Integer LCID for the library.
-    progressInstance -- Instance to use as progress indicator, or None to
-                        use the GUI progress bar.
-    """
-    from . import makepy
-
-    makepy.GenerateFromTypeLibSpec(
-        (typelibCLSID, lcid, major, minor),
-        progressInstance=progressInstance,
-        bForDemand=bForDemand,
-        bBuildHidden=bBuildHidden,
-    )
-    return GetModuleForTypelib(typelibCLSID, lcid, major, minor)
-
-
-def MakeModuleForTypelibInterface(
-    typelib_ob, progressInstance=None, bForDemand=bForDemandDefault, bBuildHidden=1
-):
-    """Generate support for a type library.
-
-    Given a PyITypeLib interface generate and import the necessary support files.  This is useful
-    for getting makepy support for a typelibrary that is not registered - the caller can locate
-    and load the type library itself, rather than relying on COM to find it.
-
-    Returns the Python module.
-
-    Params
-    typelib_ob -- The type library itself
-    progressInstance -- Instance to use as progress indicator, or None to
-                        use the GUI progress bar.
-    """
-    from . import makepy
-
-    try:
-        makepy.GenerateFromTypeLibSpec(
-            typelib_ob,
-            progressInstance=progressInstance,
-            bForDemand=bForDemandDefault,
-            bBuildHidden=bBuildHidden,
-        )
-    except pywintypes.com_error:
-        return None
-    tla = typelib_ob.GetLibAttr()
-    guid = tla[0]
-    lcid = tla[1]
-    major = tla[3]
-    minor = tla[4]
-    return GetModuleForTypelib(guid, lcid, major, minor)
-
-
-def EnsureModuleForTypelibInterface(
-    typelib_ob, progressInstance=None, bForDemand=bForDemandDefault, bBuildHidden=1
-):
-    """Check we have support for a type library, generating if not.
-
-    Given a PyITypeLib interface generate and import the necessary
-    support files if necessary. This is useful for getting makepy support
-    for a typelibrary that is not registered - the caller can locate and
-    load the type library itself, rather than relying on COM to find it.
-
-    Returns the Python module.
-
-    Params
-    typelib_ob -- The type library itself
-    progressInstance -- Instance to use as progress indicator, or None to
-                        use the GUI progress bar.
-    """
-    tla = typelib_ob.GetLibAttr()
-    guid = tla[0]
-    lcid = tla[1]
-    major = tla[3]
-    minor = tla[4]
-
-    # If demand generated, save the typelib interface away for later use
-    if bForDemand:
-        demandGeneratedTypeLibraries[(str(guid), lcid, major, minor)] = typelib_ob
-
-    try:
-        return GetModuleForTypelib(guid, lcid, major, minor)
-    except ImportError:
-        pass
-    # Generate it.
-    return MakeModuleForTypelibInterface(
-        typelib_ob, progressInstance, bForDemand, bBuildHidden
-    )
-
-
-def ForgetAboutTypelibInterface(typelib_ob):
-    """Drop any references to a typelib previously added with EnsureModuleForTypelibInterface and forDemand"""
-    tla = typelib_ob.GetLibAttr()
-    guid = tla[0]
-    lcid = tla[1]
-    major = tla[3]
-    minor = tla[4]
-    info = str(guid), lcid, major, minor
-    try:
-        del demandGeneratedTypeLibraries[info]
-    except KeyError:
-        # Not worth raising an exception - maybe they dont know we only remember for demand generated, etc.
-        print(
-            "ForgetAboutTypelibInterface:: Warning - type library with info %s is not being remembered!"
-            % (info,)
-        )
-    # and drop any version redirects to it
-    for key, val in list(versionRedirectMap.items()):
-        if val == info:
-            del versionRedirectMap[key]
-
-
-def EnsureModule(
-    typelibCLSID,
-    lcid,
-    major,
-    minor,
-    progressInstance=None,
-    bValidateFile=not is_readonly,
-    bForDemand=bForDemandDefault,
-    bBuildHidden=1,
-):
-    """Ensure Python support is loaded for a type library, generating if necessary.
-
-    Given the IID, LCID and version information for a type library, check and if
-    necessary (re)generate, then import the necessary support files. If we regenerate the file, there
-    is no way to totally snuff out all instances of the old module in Python, and thus we will regenerate the file more than necessary,
-    unless makepy/genpy is modified accordingly.
-
-
-    Returns the Python module.  No exceptions are caught during the generate process.
-
-    Params
-    typelibCLSID -- IID of the type library.
-    major -- Integer major version.
-    minor -- Integer minor version
-    lcid -- Integer LCID for the library.
-    progressInstance -- Instance to use as progress indicator, or None to
-                        use the GUI progress bar.
-    bValidateFile -- Whether or not to perform cache validation or not
-    bForDemand -- Should a complete generation happen now, or on demand?
-    bBuildHidden -- Should hidden members/attributes etc be generated?
-    """
-    bReloadNeeded = 0
-    try:
-        try:
-            module = GetModuleForTypelib(typelibCLSID, lcid, major, minor)
-        except ImportError:
-            # If we get an ImportError
-            # We may still find a valid cache file under a different MinorVersion #
-            # (which windows will search out for us)
-            # print "Loading reg typelib", typelibCLSID, major, minor, lcid
-            module = None
-            try:
-                tlbAttr = pythoncom.LoadRegTypeLib(
-                    typelibCLSID, major, minor, lcid
-                ).GetLibAttr()
-                # if the above line doesn't throw a pythoncom.com_error, check if
-                # it is actually a different lib than we requested, and if so, suck it in
-                if tlbAttr[1] != lcid or tlbAttr[4] != minor:
-                    # print "Trying 2nd minor #", tlbAttr[1], tlbAttr[3], tlbAttr[4]
-                    try:
-                        module = GetModuleForTypelib(
-                            typelibCLSID, tlbAttr[1], tlbAttr[3], tlbAttr[4]
-                        )
-                    except ImportError:
-                        # We don't have a module, but we do have a better minor
-                        # version - remember that.
-                        minor = tlbAttr[4]
-                # else module remains None
-            except pythoncom.com_error:
-                # couldn't load any typelib - mod remains None
-                pass
-        if module is not None and bValidateFile:
-            assert not is_readonly, "Can't validate in a read-only gencache"
-            try:
-                typLibPath = pythoncom.QueryPathOfRegTypeLib(
-                    typelibCLSID, major, minor, lcid
-                )
-                # windows seems to add an extra \0 (via the underlying BSTR)
-                # The mainwin toolkit does not add this erroneous \0
-                if typLibPath[-1] == "\0":
-                    typLibPath = typLibPath[:-1]
-                suf = getattr(os.path, "supports_unicode_filenames", 0)
-                if not suf:
-                    # can't pass unicode filenames directly - convert
-                    try:
-                        typLibPath = typLibPath.encode(sys.getfilesystemencoding())
-                    except AttributeError:  # no sys.getfilesystemencoding
-                        typLibPath = str(typLibPath)
-                tlbAttributes = pythoncom.LoadRegTypeLib(
-                    typelibCLSID, major, minor, lcid
-                ).GetLibAttr()
-            except pythoncom.com_error:
-                # We have a module, but no type lib - we should still
-                # run with what we have though - the typelib may not be
-                # deployed here.
-                bValidateFile = 0
-        if module is not None and bValidateFile:
-            assert not is_readonly, "Can't validate in a read-only gencache"
-            filePathPrefix = "%s\\%s" % (
-                GetGeneratePath(),
-                GetGeneratedFileName(typelibCLSID, lcid, major, minor),
-            )
-            filePath = filePathPrefix + ".py"
-            filePathPyc = filePathPrefix + ".py"
-            if __debug__:
-                filePathPyc = filePathPyc + "c"
-            else:
-                filePathPyc = filePathPyc + "o"
-            # Verify that type library is up to date.
-            # If we have a differing MinorVersion or genpy has bumped versions, update the file
-            from . import genpy
-
-            if (
-                module.MinorVersion != tlbAttributes[4]
-                or genpy.makepy_version != module.makepy_version
-            ):
-                # print "Version skew: %d, %d" % (module.MinorVersion, tlbAttributes[4])
-                # try to erase the bad file from the cache
-                try:
-                    os.unlink(filePath)
-                except os.error:
-                    pass
-                try:
-                    os.unlink(filePathPyc)
-                except os.error:
-                    pass
-                if os.path.isdir(filePathPrefix):
-                    import shutil
-
-                    shutil.rmtree(filePathPrefix)
-                minor = tlbAttributes[4]
-                module = None
-                bReloadNeeded = 1
-            else:
-                minor = module.MinorVersion
-                filePathPrefix = "%s\\%s" % (
-                    GetGeneratePath(),
-                    GetGeneratedFileName(typelibCLSID, lcid, major, minor),
-                )
-                filePath = filePathPrefix + ".py"
-                filePathPyc = filePathPrefix + ".pyc"
-                # print "Trying py stat: ", filePath
-                fModTimeSet = 0
-                try:
-                    pyModTime = os.stat(filePath)[8]
-                    fModTimeSet = 1
-                except os.error as e:
-                    # If .py file fails, try .pyc file
-                    # print "Trying pyc stat", filePathPyc
-                    try:
-                        pyModTime = os.stat(filePathPyc)[8]
-                        fModTimeSet = 1
-                    except os.error as e:
-                        pass
-                # print "Trying stat typelib", pyModTime
-                # print str(typLibPath)
-                typLibModTime = os.stat(typLibPath)[8]
-                if fModTimeSet and (typLibModTime > pyModTime):
-                    bReloadNeeded = 1
-                    module = None
-    except (ImportError, os.error):
-        module = None
-    if module is None:
-        # We need to build an item.  If we are in a read-only cache, we
-        # can't/don't want to do this - so before giving up, check for
-        # a different minor version in our cache - according to COM, this is OK
-        if is_readonly:
-            key = str(typelibCLSID), lcid, major, minor
-            # If we have been asked before, get last result.
-            try:
-                return versionRedirectMap[key]
-            except KeyError:
-                pass
-            # Find other candidates.
-            items = []
-            for desc in GetGeneratedInfos():
-                if key[0] == desc[0] and key[1] == desc[1] and key[2] == desc[2]:
-                    items.append(desc)
-            if items:
-                # Items are all identical, except for last tuple element
-                # We want the latest minor version we have - so just sort and grab last
-                items.sort()
-                new_minor = items[-1][3]
-                ret = GetModuleForTypelib(typelibCLSID, lcid, major, new_minor)
-            else:
-                ret = None
-            # remember and return
-            versionRedirectMap[key] = ret
-            return ret
-        # print "Rebuilding: ", major, minor
-        module = MakeModuleForTypelib(
-            typelibCLSID,
-            lcid,
-            major,
-            minor,
-            progressInstance,
-            bForDemand=bForDemand,
-            bBuildHidden=bBuildHidden,
-        )
-        # If we replaced something, reload it
-        if bReloadNeeded:
-            module = reload(module)
-            AddModuleToCache(typelibCLSID, lcid, major, minor)
-    return module
-
-
-def EnsureDispatch(
-    prog_id, bForDemand=1
-):  # New fn, so we default the new demand feature to on!
-    """Given a COM prog_id, return an object that is using makepy support, building if necessary"""
-    disp = win32com.client.Dispatch(prog_id)
-    if not disp.__dict__.get("CLSID"):  # Eeek - no makepy support - try and build it.
-        try:
-            ti = disp._oleobj_.GetTypeInfo()
-            disp_clsid = ti.GetTypeAttr()[0]
-            tlb, index = ti.GetContainingTypeLib()
-            tla = tlb.GetLibAttr()
-            mod = EnsureModule(tla[0], tla[1], tla[3], tla[4], bForDemand=bForDemand)
-            GetModuleForCLSID(disp_clsid)
-            # Get the class from the module.
-            from . import CLSIDToClass
-
-            disp_class = CLSIDToClass.GetClass(str(disp_clsid))
-            disp = disp_class(disp._oleobj_)
-        except pythoncom.com_error:
-            raise TypeError(
-                "This COM object can not automate the makepy process - please run makepy manually for this object"
-            )
-    return disp
-
-
-def AddModuleToCache(
-    typelibclsid, lcid, major, minor, verbose=1, bFlushNow=not is_readonly
-):
-    """Add a newly generated file to the cache dictionary."""
-    fname = GetGeneratedFileName(typelibclsid, lcid, major, minor)
-    mod = _GetModule(fname)
-    # if mod._in_gencache_ is already true, then we are reloading this
-    # module - this doesn't mean anything special though!
-    mod._in_gencache_ = 1
-    info = str(typelibclsid), lcid, major, minor
-    dict_modified = False
-
-    def SetTypelibForAllClsids(dict):
-        nonlocal dict_modified
-        for clsid, cls in dict.items():
-            if clsidToTypelib.get(clsid) != info:
-                clsidToTypelib[clsid] = info
-                dict_modified = True
-
-    SetTypelibForAllClsids(mod.CLSIDToClassMap)
-    SetTypelibForAllClsids(mod.CLSIDToPackageMap)
-    SetTypelibForAllClsids(mod.VTablesToClassMap)
-    SetTypelibForAllClsids(mod.VTablesToPackageMap)
-
-    # If this lib was previously redirected, drop it
-    if info in versionRedirectMap:
-        del versionRedirectMap[info]
-    if bFlushNow and dict_modified:
-        _SaveDicts()
-
-
-def GetGeneratedInfos():
-    zip_pos = win32com.__gen_path__.find(".zip\\")
-    if zip_pos >= 0:
-        import zipfile
-
-        zip_file = win32com.__gen_path__[: zip_pos + 4]
-        zip_path = win32com.__gen_path__[zip_pos + 5 :].replace("\\", "/")
-        zf = zipfile.ZipFile(zip_file)
-        infos = {}
-        for n in zf.namelist():
-            if not n.startswith(zip_path):
-                continue
-            base = n[len(zip_path) + 1 :].split("/")[0]
-            try:
-                iid, lcid, major, minor = base.split("x")
-                lcid = int(lcid)
-                major = int(major)
-                minor = int(minor)
-                iid = pywintypes.IID("{" + iid + "}")
-            except ValueError:
-                continue
-            except pywintypes.com_error:
-                # invalid IID
-                continue
-            infos[(iid, lcid, major, minor)] = 1
-        zf.close()
-        return list(infos.keys())
-    else:
-        # on the file system
-        files = glob.glob(win32com.__gen_path__ + "\\*")
-        ret = []
-        for file in files:
-            if not os.path.isdir(file) and not os.path.splitext(file)[1] == ".py":
-                continue
-            name = os.path.splitext(os.path.split(file)[1])[0]
-            try:
-                iid, lcid, major, minor = name.split("x")
-                iid = pywintypes.IID("{" + iid + "}")
-                lcid = int(lcid)
-                major = int(major)
-                minor = int(minor)
-            except ValueError:
-                continue
-            except pywintypes.com_error:
-                # invalid IID
-                continue
-            ret.append((iid, lcid, major, minor))
-        return ret
-
-
-def _GetModule(fname):
-    """Given the name of a module in the gen_py directory, import and return it."""
-    mod_name = "win32com.gen_py.%s" % fname
-    mod = __import__(mod_name)
-    return sys.modules[mod_name]
-
-
-def Rebuild(verbose=1):
-    """Rebuild the cache indexes from the file system."""
-    clsidToTypelib.clear()
-    infos = GetGeneratedInfos()
-    if verbose and len(infos):  # Dont bother reporting this when directory is empty!
-        print("Rebuilding cache of generated files for COM support...")
-    for info in infos:
-        iid, lcid, major, minor = info
-        if verbose:
-            print("Checking", GetGeneratedFileName(*info))
-        try:
-            AddModuleToCache(iid, lcid, major, minor, verbose, 0)
-        except:
-            print(
-                "Could not add module %s - %s: %s"
-                % (info, sys.exc_info()[0], sys.exc_info()[1])
-            )
-    if verbose and len(infos):  # Dont bother reporting this when directory is empty!
-        print("Done.")
-    _SaveDicts()
-
-
-def _Dump():
-    print("Cache is in directory", win32com.__gen_path__)
-    # Build a unique dir
-    d = {}
-    for clsid, (typelibCLSID, lcid, major, minor) in clsidToTypelib.items():
-        d[typelibCLSID, lcid, major, minor] = None
-    for typelibCLSID, lcid, major, minor in d.keys():
-        mod = GetModuleForTypelib(typelibCLSID, lcid, major, minor)
-        print("%s - %s" % (mod.__doc__, typelibCLSID))
-
-
-# Boot up
-__init__()
-
-
-def usage():
-    usageString = """\
-	  Usage: gencache [-q] [-d] [-r]
-
-			 -q         - Quiet
-			 -d         - Dump the cache (typelibrary description and filename).
-			 -r         - Rebuild the cache dictionary from the existing .py files
-	"""
-    print(usageString)
-    sys.exit(1)
-
-
-if __name__ == "__main__":
-    import getopt
-
-    try:
-        opts, args = getopt.getopt(sys.argv[1:], "qrd")
-    except getopt.error as message:
-        print(message)
-        usage()
-
-    # we only have options - complain about real args, or none at all!
-    if len(sys.argv) == 1 or args:
-        print(usage())
-
-    verbose = 1
-    for opt, val in opts:
-        if opt == "-d":  # Dump
-            _Dump()
-        if opt == "-r":
-            Rebuild(verbose)
-        if opt == "-q":
-            verbose = 0
diff --git a/lib/win32com/client/genpy.py b/lib/win32com/client/genpy.py
deleted file mode 100644
index 3eba075f..00000000
--- a/lib/win32com/client/genpy.py
+++ /dev/null
@@ -1,1411 +0,0 @@
-"""genpy.py - The worker for makepy.  See makepy.py for more details
-
-This code was moved simply to speed Python in normal circumstances.  As the makepy.py
-is normally run from the command line, it reparses the code each time.  Now makepy
-is nothing more than the command line handler and public interface.
-
-The makepy command line etc handling is also getting large enough in its own right!
-"""
-
-# NOTE - now supports a "demand" mechanism - the top-level is a package, and
-# each class etc can be made individually.
-# This should eventually become the default.
-# Then the old non-package technique should be removed.
-# There should be no b/w compat issues, and will just help clean the code.
-# This will be done once the new "demand" mechanism gets a good workout.
-import os
-import sys
-import time
-
-import pythoncom
-import win32com
-
-from . import build
-
-error = "makepy.error"
-makepy_version = "0.5.01"  # Written to generated file.
-
-GEN_FULL = "full"
-GEN_DEMAND_BASE = "demand(base)"
-GEN_DEMAND_CHILD = "demand(child)"
-
-# This map is used purely for the users benefit -it shows the
-# raw, underlying type of Alias/Enums, etc.  The COM implementation
-# does not use this map at runtime - all Alias/Enum have already
-# been translated.
-mapVTToTypeString = {
-    pythoncom.VT_I2: "types.IntType",
-    pythoncom.VT_I4: "types.IntType",
-    pythoncom.VT_R4: "types.FloatType",
-    pythoncom.VT_R8: "types.FloatType",
-    pythoncom.VT_BSTR: "types.StringType",
-    pythoncom.VT_BOOL: "types.IntType",
-    pythoncom.VT_VARIANT: "types.TypeType",
-    pythoncom.VT_I1: "types.IntType",
-    pythoncom.VT_UI1: "types.IntType",
-    pythoncom.VT_UI2: "types.IntType",
-    pythoncom.VT_UI4: "types.IntType",
-    pythoncom.VT_I8: "types.LongType",
-    pythoncom.VT_UI8: "types.LongType",
-    pythoncom.VT_INT: "types.IntType",
-    pythoncom.VT_DATE: "pythoncom.PyTimeType",
-    pythoncom.VT_UINT: "types.IntType",
-}
-
-
-# Given a propget function's arg desc, return the default parameters for all
-# params bar the first.  Eg, then Python does a:
-# object.Property = "foo"
-# Python can only pass the "foo" value.  If the property has
-# multiple args, and the rest have default values, this allows
-# Python to correctly pass those defaults.
-def MakeDefaultArgsForPropertyPut(argsDesc):
-    ret = []
-    for desc in argsDesc[1:]:
-        default = build.MakeDefaultArgRepr(desc)
-        if default is None:
-            break
-        ret.append(default)
-    return tuple(ret)
-
-
-def MakeMapLineEntry(dispid, wFlags, retType, argTypes, user, resultCLSID):
-    # Strip the default value
-    argTypes = tuple([what[:2] for what in argTypes])
-    return '(%s, %d, %s, %s, "%s", %s)' % (
-        dispid,
-        wFlags,
-        retType[:2],
-        argTypes,
-        user,
-        resultCLSID,
-    )
-
-
-def MakeEventMethodName(eventName):
-    if eventName[:2] == "On":
-        return eventName
-    else:
-        return "On" + eventName
-
-
-def WriteSinkEventMap(obj, stream):
-    print("\t_dispid_to_func_ = {", file=stream)
-    for name, entry in (
-        list(obj.propMapGet.items())
-        + list(obj.propMapPut.items())
-        + list(obj.mapFuncs.items())
-    ):
-        fdesc = entry.desc
-        print(
-            '\t\t%9d : "%s",' % (fdesc.memid, MakeEventMethodName(entry.names[0])),
-            file=stream,
-        )
-    print("\t\t}", file=stream)
-
-
-# MI is used to join my writable helpers, and the OLE
-# classes.
-class WritableItem:
-    # __cmp__ used for sorting in py2x...
-    def __cmp__(self, other):
-        "Compare for sorting"
-        ret = cmp(self.order, other.order)
-        if ret == 0 and self.doc:
-            ret = cmp(self.doc[0], other.doc[0])
-        return ret
-
-    # ... but not used in py3k - __lt__ minimum needed there
-    def __lt__(self, other):  # py3k variant
-        if self.order == other.order:
-            return self.doc < other.doc
-        return self.order < other.order
-
-    def __repr__(self):
-        return "OleItem: doc=%s, order=%d" % (repr(self.doc), self.order)
-
-
-class RecordItem(build.OleItem, WritableItem):
-    order = 9
-    typename = "RECORD"
-
-    def __init__(self, typeInfo, typeAttr, doc=None, bForUser=1):
-        ##    sys.stderr.write("Record %s: size %s\n" % (doc,typeAttr.cbSizeInstance))
-        ##    sys.stderr.write(" cVars = %s\n" % (typeAttr.cVars,))
-        ##    for i in range(typeAttr.cVars):
-        ##        vdesc = typeInfo.GetVarDesc(i)
-        ##        sys.stderr.write(" Var %d has value %s, type %d, desc=%s\n" % (i, vdesc.value, vdesc.varkind, vdesc.elemdescVar))
-        ##        sys.stderr.write(" Doc is %s\n" % (typeInfo.GetDocumentation(vdesc.memid),))
-
-        build.OleItem.__init__(self, doc)
-        self.clsid = typeAttr[0]
-
-    def WriteClass(self, generator):
-        pass
-
-
-# Given an enum, write all aliases for it.
-# (no longer necessary for new style code, but still used for old code.
-def WriteAliasesForItem(item, aliasItems, stream):
-    for alias in aliasItems.values():
-        if item.doc and alias.aliasDoc and (alias.aliasDoc[0] == item.doc[0]):
-            alias.WriteAliasItem(aliasItems, stream)
-
-
-class AliasItem(build.OleItem, WritableItem):
-    order = 2
-    typename = "ALIAS"
-
-    def __init__(self, typeinfo, attr, doc=None, bForUser=1):
-        build.OleItem.__init__(self, doc)
-
-        ai = attr[14]
-        self.attr = attr
-        if type(ai) == type(()) and type(ai[1]) == type(
-            0
-        ):  # XXX - This is a hack - why tuples?  Need to resolve?
-            href = ai[1]
-            alinfo = typeinfo.GetRefTypeInfo(href)
-            self.aliasDoc = alinfo.GetDocumentation(-1)
-            self.aliasAttr = alinfo.GetTypeAttr()
-        else:
-            self.aliasDoc = None
-            self.aliasAttr = None
-
-    def WriteAliasItem(self, aliasDict, stream):
-        # we could have been written as part of an alias dependency
-        if self.bWritten:
-            return
-
-        if self.aliasDoc:
-            depName = self.aliasDoc[0]
-            if depName in aliasDict:
-                aliasDict[depName].WriteAliasItem(aliasDict, stream)
-            print(self.doc[0] + " = " + depName, file=stream)
-        else:
-            ai = self.attr[14]
-            if type(ai) == type(0):
-                try:
-                    typeStr = mapVTToTypeString[ai]
-                    print("# %s=%s" % (self.doc[0], typeStr), file=stream)
-                except KeyError:
-                    print(
-                        self.doc[0] + " = None # Can't convert alias info " + str(ai),
-                        file=stream,
-                    )
-        print(file=stream)
-        self.bWritten = 1
-
-
-class EnumerationItem(build.OleItem, WritableItem):
-    order = 1
-    typename = "ENUMERATION"
-
-    def __init__(self, typeinfo, attr, doc=None, bForUser=1):
-        build.OleItem.__init__(self, doc)
-
-        self.clsid = attr[0]
-        self.mapVars = {}
-        typeFlags = attr[11]
-        self.hidden = (
-            typeFlags & pythoncom.TYPEFLAG_FHIDDEN
-            or typeFlags & pythoncom.TYPEFLAG_FRESTRICTED
-        )
-
-        for j in range(attr[7]):
-            vdesc = typeinfo.GetVarDesc(j)
-            name = typeinfo.GetNames(vdesc[0])[0]
-            self.mapVars[name] = build.MapEntry(vdesc)
-
-    ##  def WriteEnumerationHeaders(self, aliasItems, stream):
-    ##    enumName = self.doc[0]
-    ##    print >> stream "%s=constants # Compatibility with previous versions." % (enumName)
-    ##    WriteAliasesForItem(self, aliasItems)
-
-    def WriteEnumerationItems(self, stream):
-        num = 0
-        enumName = self.doc[0]
-        # Write in name alpha order
-        names = list(self.mapVars.keys())
-        names.sort()
-        for name in names:
-            entry = self.mapVars[name]
-            vdesc = entry.desc
-            if vdesc[4] == pythoncom.VAR_CONST:
-                val = vdesc[1]
-
-                use = repr(val)
-                # Make sure the repr of the value is valid python syntax
-                # still could cause an error on import if it contains a module or type name
-                # not available in the global namespace
-                try:
-                    compile(use, "<makepy>", "eval")
-                except SyntaxError:
-                    # At least add the repr as a string, so it can be investigated further
-                    # Sanitize it, in case the repr contains its own quotes.  (??? line breaks too ???)
-                    use = use.replace('"', "'")
-                    use = (
-                        '"'
-                        + use
-                        + '"'
-                        + " # This VARIANT type cannot be converted automatically"
-                    )
-                print(
-                    "\t%-30s=%-10s # from enum %s"
-                    % (build.MakePublicAttributeName(name, True), use, enumName),
-                    file=stream,
-                )
-                num += 1
-        return num
-
-
-class VTableItem(build.VTableItem, WritableItem):
-    order = 4
-
-    def WriteClass(self, generator):
-        self.WriteVTableMap(generator)
-        self.bWritten = 1
-
-    def WriteVTableMap(self, generator):
-        stream = generator.file
-        print(
-            "%s_vtables_dispatch_ = %d" % (self.python_name, self.bIsDispatch),
-            file=stream,
-        )
-        print("%s_vtables_ = [" % (self.python_name,), file=stream)
-        for v in self.vtableFuncs:
-            names, dispid, desc = v
-            assert desc.desckind == pythoncom.DESCKIND_FUNCDESC
-            arg_reprs = []
-            # more hoops so we don't generate huge lines.
-            item_num = 0
-            print("\t((", end=" ", file=stream)
-            for name in names:
-                print(repr(name), ",", end=" ", file=stream)
-                item_num = item_num + 1
-                if item_num % 5 == 0:
-                    print("\n\t\t\t", end=" ", file=stream)
-            print(
-                "), %d, (%r, %r, [" % (dispid, desc.memid, desc.scodeArray),
-                end=" ",
-                file=stream,
-            )
-            for arg in desc.args:
-                item_num = item_num + 1
-                if item_num % 5 == 0:
-                    print("\n\t\t\t", end=" ", file=stream)
-                defval = build.MakeDefaultArgRepr(arg)
-                if arg[3] is None:
-                    arg3_repr = None
-                else:
-                    arg3_repr = repr(arg[3])
-                print(
-                    repr((arg[0], arg[1], defval, arg3_repr)), ",", end=" ", file=stream
-                )
-            print("],", end=" ", file=stream)
-            print(repr(desc.funckind), ",", end=" ", file=stream)
-            print(repr(desc.invkind), ",", end=" ", file=stream)
-            print(repr(desc.callconv), ",", end=" ", file=stream)
-            print(repr(desc.cParamsOpt), ",", end=" ", file=stream)
-            print(repr(desc.oVft), ",", end=" ", file=stream)
-            print(repr(desc.rettype), ",", end=" ", file=stream)
-            print(repr(desc.wFuncFlags), ",", end=" ", file=stream)
-            print(")),", file=stream)
-        print("]", file=stream)
-        print(file=stream)
-
-
-class DispatchItem(build.DispatchItem, WritableItem):
-    order = 3
-
-    def __init__(self, typeinfo, attr, doc=None):
-        build.DispatchItem.__init__(self, typeinfo, attr, doc)
-        self.type_attr = attr
-        self.coclass_clsid = None
-
-    def WriteClass(self, generator):
-        if (
-            not self.bIsDispatch
-            and not self.type_attr.typekind == pythoncom.TKIND_DISPATCH
-        ):
-            return
-        # This is pretty screwey - now we have vtable support we
-        # should probably rethink this (ie, maybe write both sides for sinks, etc)
-        if self.bIsSink:
-            self.WriteEventSinkClassHeader(generator)
-            self.WriteCallbackClassBody(generator)
-        else:
-            self.WriteClassHeader(generator)
-            self.WriteClassBody(generator)
-        print(file=generator.file)
-        self.bWritten = 1
-
-    def WriteClassHeader(self, generator):
-        generator.checkWriteDispatchBaseClass()
-        doc = self.doc
-        stream = generator.file
-        print("class " + self.python_name + "(DispatchBaseClass):", file=stream)
-        if doc[1]:
-            print("\t" + build._makeDocString(doc[1]), file=stream)
-        try:
-            progId = pythoncom.ProgIDFromCLSID(self.clsid)
-            print(
-                "\t# This class is creatable by the name '%s'" % (progId), file=stream
-            )
-        except pythoncom.com_error:
-            pass
-        print("\tCLSID = " + repr(self.clsid), file=stream)
-        if self.coclass_clsid is None:
-            print("\tcoclass_clsid = None", file=stream)
-        else:
-            print("\tcoclass_clsid = " + repr(self.coclass_clsid), file=stream)
-        print(file=stream)
-        self.bWritten = 1
-
-    def WriteEventSinkClassHeader(self, generator):
-        generator.checkWriteEventBaseClass()
-        doc = self.doc
-        stream = generator.file
-        print("class " + self.python_name + ":", file=stream)
-        if doc[1]:
-            print("\t" + build._makeDocString(doc[1]), file=stream)
-        try:
-            progId = pythoncom.ProgIDFromCLSID(self.clsid)
-            print(
-                "\t# This class is creatable by the name '%s'" % (progId), file=stream
-            )
-        except pythoncom.com_error:
-            pass
-        print("\tCLSID = CLSID_Sink = " + repr(self.clsid), file=stream)
-        if self.coclass_clsid is None:
-            print("\tcoclass_clsid = None", file=stream)
-        else:
-            print("\tcoclass_clsid = " + repr(self.coclass_clsid), file=stream)
-        print("\t_public_methods_ = [] # For COM Server support", file=stream)
-        WriteSinkEventMap(self, stream)
-        print(file=stream)
-        print("\tdef __init__(self, oobj = None):", file=stream)
-        print("\t\tif oobj is None:", file=stream)
-        print("\t\t\tself._olecp = None", file=stream)
-        print("\t\telse:", file=stream)
-        print("\t\t\timport win32com.server.util", file=stream)
-        print(
-            "\t\t\tfrom win32com.server.policy import EventHandlerPolicy", file=stream
-        )
-        print(
-            "\t\t\tcpc=oobj._oleobj_.QueryInterface(pythoncom.IID_IConnectionPointContainer)",
-            file=stream,
-        )
-        print("\t\t\tcp=cpc.FindConnectionPoint(self.CLSID_Sink)", file=stream)
-        print(
-            "\t\t\tcookie=cp.Advise(win32com.server.util.wrap(self, usePolicy=EventHandlerPolicy))",
-            file=stream,
-        )
-        print("\t\t\tself._olecp,self._olecp_cookie = cp,cookie", file=stream)
-        print("\tdef __del__(self):", file=stream)
-        print("\t\ttry:", file=stream)
-        print("\t\t\tself.close()", file=stream)
-        print("\t\texcept pythoncom.com_error:", file=stream)
-        print("\t\t\tpass", file=stream)
-        print("\tdef close(self):", file=stream)
-        print("\t\tif self._olecp is not None:", file=stream)
-        print(
-            "\t\t\tcp,cookie,self._olecp,self._olecp_cookie = self._olecp,self._olecp_cookie,None,None",
-            file=stream,
-        )
-        print("\t\t\tcp.Unadvise(cookie)", file=stream)
-        print("\tdef _query_interface_(self, iid):", file=stream)
-        print("\t\timport win32com.server.util", file=stream)
-        print(
-            "\t\tif iid==self.CLSID_Sink: return win32com.server.util.wrap(self)",
-            file=stream,
-        )
-        print(file=stream)
-        self.bWritten = 1
-
-    def WriteCallbackClassBody(self, generator):
-        stream = generator.file
-        print("\t# Event Handlers", file=stream)
-        print(
-            "\t# If you create handlers, they should have the following prototypes:",
-            file=stream,
-        )
-        for name, entry in (
-            list(self.propMapGet.items())
-            + list(self.propMapPut.items())
-            + list(self.mapFuncs.items())
-        ):
-            fdesc = entry.desc
-            methName = MakeEventMethodName(entry.names[0])
-            print(
-                "#\tdef "
-                + methName
-                + "(self"
-                + build.BuildCallList(
-                    fdesc,
-                    entry.names,
-                    "defaultNamedOptArg",
-                    "defaultNamedNotOptArg",
-                    "defaultUnnamedArg",
-                    "pythoncom.Missing",
-                    is_comment=True,
-                )
-                + "):",
-                file=stream,
-            )
-            if entry.doc and entry.doc[1]:
-                print("#\t\t" + build._makeDocString(entry.doc[1]), file=stream)
-        print(file=stream)
-        self.bWritten = 1
-
-    def WriteClassBody(self, generator):
-        stream = generator.file
-        # Write in alpha order.
-        names = list(self.mapFuncs.keys())
-        names.sort()
-        specialItems = {
-            "count": None,
-            "item": None,
-            "value": None,
-            "_newenum": None,
-        }  # If found, will end up with (entry, invoke_tupe)
-        itemCount = None
-        for name in names:
-            entry = self.mapFuncs[name]
-            assert entry.desc.desckind == pythoncom.DESCKIND_FUNCDESC
-            # skip [restricted] methods, unless it is the
-            # enumerator (which, being part of the "system",
-            # we know about and can use)
-            dispid = entry.desc.memid
-            if (
-                entry.desc.wFuncFlags & pythoncom.FUNCFLAG_FRESTRICTED
-                and dispid != pythoncom.DISPID_NEWENUM
-            ):
-                continue
-            # If not accessible via IDispatch, then we can't use it here.
-            if entry.desc.funckind != pythoncom.FUNC_DISPATCH:
-                continue
-            if dispid == pythoncom.DISPID_VALUE:
-                lkey = "value"
-            elif dispid == pythoncom.DISPID_NEWENUM:
-                specialItems["_newenum"] = (entry, entry.desc.invkind, None)
-                continue  # Dont build this one now!
-            else:
-                lkey = name.lower()
-            if (
-                lkey in specialItems and specialItems[lkey] is None
-            ):  # remember if a special one.
-                specialItems[lkey] = (entry, entry.desc.invkind, None)
-            if generator.bBuildHidden or not entry.hidden:
-                if entry.GetResultName():
-                    print("\t# Result is of type " + entry.GetResultName(), file=stream)
-                if entry.wasProperty:
-                    print(
-                        "\t# The method %s is actually a property, but must be used as a method to correctly pass the arguments"
-                        % name,
-                        file=stream,
-                    )
-                ret = self.MakeFuncMethod(entry, build.MakePublicAttributeName(name))
-                for line in ret:
-                    print(line, file=stream)
-        print("\t_prop_map_get_ = {", file=stream)
-        names = list(self.propMap.keys())
-        names.sort()
-        for key in names:
-            entry = self.propMap[key]
-            if generator.bBuildHidden or not entry.hidden:
-                resultName = entry.GetResultName()
-                if resultName:
-                    print(
-                        "\t\t# Property '%s' is an object of type '%s'"
-                        % (key, resultName),
-                        file=stream,
-                    )
-                lkey = key.lower()
-                details = entry.desc
-                resultDesc = details[2]
-                argDesc = ()
-                mapEntry = MakeMapLineEntry(
-                    details.memid,
-                    pythoncom.DISPATCH_PROPERTYGET,
-                    resultDesc,
-                    argDesc,
-                    key,
-                    entry.GetResultCLSIDStr(),
-                )
-
-                if details.memid == pythoncom.DISPID_VALUE:
-                    lkey = "value"
-                elif details.memid == pythoncom.DISPID_NEWENUM:
-                    lkey = "_newenum"
-                else:
-                    lkey = key.lower()
-                if (
-                    lkey in specialItems and specialItems[lkey] is None
-                ):  # remember if a special one.
-                    specialItems[lkey] = (
-                        entry,
-                        pythoncom.DISPATCH_PROPERTYGET,
-                        mapEntry,
-                    )
-                    # All special methods, except _newenum, are written
-                    # "normally".  This is a mess!
-                    if details.memid == pythoncom.DISPID_NEWENUM:
-                        continue
-
-                print(
-                    '\t\t"%s": %s,' % (build.MakePublicAttributeName(key), mapEntry),
-                    file=stream,
-                )
-        names = list(self.propMapGet.keys())
-        names.sort()
-        for key in names:
-            entry = self.propMapGet[key]
-            if generator.bBuildHidden or not entry.hidden:
-                if entry.GetResultName():
-                    print(
-                        "\t\t# Method '%s' returns object of type '%s'"
-                        % (key, entry.GetResultName()),
-                        file=stream,
-                    )
-                details = entry.desc
-                assert details.desckind == pythoncom.DESCKIND_FUNCDESC
-                lkey = key.lower()
-                argDesc = details[2]
-                resultDesc = details[8]
-                mapEntry = MakeMapLineEntry(
-                    details[0],
-                    pythoncom.DISPATCH_PROPERTYGET,
-                    resultDesc,
-                    argDesc,
-                    key,
-                    entry.GetResultCLSIDStr(),
-                )
-                if details.memid == pythoncom.DISPID_VALUE:
-                    lkey = "value"
-                elif details.memid == pythoncom.DISPID_NEWENUM:
-                    lkey = "_newenum"
-                else:
-                    lkey = key.lower()
-                if (
-                    lkey in specialItems and specialItems[lkey] is None
-                ):  # remember if a special one.
-                    specialItems[lkey] = (
-                        entry,
-                        pythoncom.DISPATCH_PROPERTYGET,
-                        mapEntry,
-                    )
-                    # All special methods, except _newenum, are written
-                    # "normally".  This is a mess!
-                    if details.memid == pythoncom.DISPID_NEWENUM:
-                        continue
-                print(
-                    '\t\t"%s": %s,' % (build.MakePublicAttributeName(key), mapEntry),
-                    file=stream,
-                )
-
-        print("\t}", file=stream)
-
-        print("\t_prop_map_put_ = {", file=stream)
-        # These are "Invoke" args
-        names = list(self.propMap.keys())
-        names.sort()
-        for key in names:
-            entry = self.propMap[key]
-            if generator.bBuildHidden or not entry.hidden:
-                lkey = key.lower()
-                details = entry.desc
-                # If default arg is None, write an empty tuple
-                defArgDesc = build.MakeDefaultArgRepr(details[2])
-                if defArgDesc is None:
-                    defArgDesc = ""
-                else:
-                    defArgDesc = defArgDesc + ","
-                print(
-                    '\t\t"%s" : ((%s, LCID, %d, 0),(%s)),'
-                    % (
-                        build.MakePublicAttributeName(key),
-                        details[0],
-                        pythoncom.DISPATCH_PROPERTYPUT,
-                        defArgDesc,
-                    ),
-                    file=stream,
-                )
-
-        names = list(self.propMapPut.keys())
-        names.sort()
-        for key in names:
-            entry = self.propMapPut[key]
-            if generator.bBuildHidden or not entry.hidden:
-                details = entry.desc
-                defArgDesc = MakeDefaultArgsForPropertyPut(details[2])
-                print(
-                    '\t\t"%s": ((%s, LCID, %d, 0),%s),'
-                    % (
-                        build.MakePublicAttributeName(key),
-                        details[0],
-                        details[4],
-                        defArgDesc,
-                    ),
-                    file=stream,
-                )
-        print("\t}", file=stream)
-
-        if specialItems["value"]:
-            entry, invoketype, propArgs = specialItems["value"]
-            if propArgs is None:
-                typename = "method"
-                ret = self.MakeFuncMethod(entry, "__call__")
-            else:
-                typename = "property"
-                ret = [
-                    "\tdef __call__(self):\n\t\treturn self._ApplyTypes_(*%s)"
-                    % propArgs
-                ]
-            print(
-                "\t# Default %s for this class is '%s'" % (typename, entry.names[0]),
-                file=stream,
-            )
-            for line in ret:
-                print(line, file=stream)
-            print("\tdef __str__(self, *args):", file=stream)
-            print("\t\treturn str(self.__call__(*args))", file=stream)
-            print("\tdef __int__(self, *args):", file=stream)
-            print("\t\treturn int(self.__call__(*args))", file=stream)
-
-        # _NewEnum (DISPID_NEWENUM) does not appear in typelib for many office objects,
-        # but it can still be retrieved at runtime, so  always create __iter__.
-        # Also, some of those same objects use 1-based indexing, causing the old-style
-        # __getitem__ iteration to fail for index 0 where the dynamic iteration succeeds.
-        if specialItems["_newenum"]:
-            enumEntry, invoketype, propArgs = specialItems["_newenum"]
-            assert enumEntry.desc.desckind == pythoncom.DESCKIND_FUNCDESC
-            invkind = enumEntry.desc.invkind
-            # ??? Wouldn't this be the resultCLSID for the iterator itself, rather than the resultCLSID
-            #  for the result of each Next() call, which is what it's used for ???
-            resultCLSID = enumEntry.GetResultCLSIDStr()
-        else:
-            invkind = pythoncom.DISPATCH_METHOD | pythoncom.DISPATCH_PROPERTYGET
-            resultCLSID = "None"
-        # If we dont have a good CLSID for the enum result, assume it is the same as the Item() method.
-        if resultCLSID == "None" and "Item" in self.mapFuncs:
-            resultCLSID = self.mapFuncs["Item"].GetResultCLSIDStr()
-        print("\tdef __iter__(self):", file=stream)
-        print('\t\t"Return a Python iterator for this object"', file=stream)
-        print("\t\ttry:", file=stream)
-        print(
-            "\t\t\tob = self._oleobj_.InvokeTypes(%d,LCID,%d,(13, 10),())"
-            % (pythoncom.DISPID_NEWENUM, invkind),
-            file=stream,
-        )
-        print("\t\texcept pythoncom.error:", file=stream)
-        print(
-            '\t\t\traise TypeError("This object does not support enumeration")',
-            file=stream,
-        )
-        # Iterator is wrapped as PyIEnumVariant, and each result of __next__ is Dispatch'ed if necessary
-        print(
-            "\t\treturn win32com.client.util.Iterator(ob, %s)" % resultCLSID,
-            file=stream,
-        )
-
-        if specialItems["item"]:
-            entry, invoketype, propArgs = specialItems["item"]
-            resultCLSID = entry.GetResultCLSIDStr()
-            print(
-                "\t#This class has Item property/method which allows indexed access with the object[key] syntax.",
-                file=stream,
-            )
-            print(
-                "\t#Some objects will accept a string or other type of key in addition to integers.",
-                file=stream,
-            )
-            print(
-                "\t#Note that many Office objects do not use zero-based indexing.",
-                file=stream,
-            )
-            print("\tdef __getitem__(self, key):", file=stream)
-            print(
-                '\t\treturn self._get_good_object_(self._oleobj_.Invoke(*(%d, LCID, %d, 1, key)), "Item", %s)'
-                % (entry.desc.memid, invoketype, resultCLSID),
-                file=stream,
-            )
-
-        if specialItems["count"]:
-            entry, invoketype, propArgs = specialItems["count"]
-            if propArgs is None:
-                typename = "method"
-                ret = self.MakeFuncMethod(entry, "__len__")
-            else:
-                typename = "property"
-                ret = [
-                    "\tdef __len__(self):\n\t\treturn self._ApplyTypes_(*%s)" % propArgs
-                ]
-            print(
-                "\t#This class has Count() %s - allow len(ob) to provide this"
-                % (typename),
-                file=stream,
-            )
-            for line in ret:
-                print(line, file=stream)
-            # Also include a __nonzero__
-            print(
-                "\t#This class has a __len__ - this is needed so 'if object:' always returns TRUE.",
-                file=stream,
-            )
-            print("\tdef __nonzero__(self):", file=stream)
-            print("\t\treturn True", file=stream)
-
-
-class CoClassItem(build.OleItem, WritableItem):
-    order = 5
-    typename = "COCLASS"
-
-    def __init__(self, typeinfo, attr, doc=None, sources=[], interfaces=[], bForUser=1):
-        build.OleItem.__init__(self, doc)
-        self.clsid = attr[0]
-        self.sources = sources
-        self.interfaces = interfaces
-        self.bIsDispatch = 1  # Pretend it is so it is written to the class map.
-
-    def WriteClass(self, generator):
-        generator.checkWriteCoClassBaseClass()
-        doc = self.doc
-        stream = generator.file
-        if generator.generate_type == GEN_DEMAND_CHILD:
-            # Some special imports we must setup.
-            referenced_items = []
-            for ref, flag in self.sources:
-                referenced_items.append(ref)
-            for ref, flag in self.interfaces:
-                referenced_items.append(ref)
-            print("import sys", file=stream)
-            for ref in referenced_items:
-                print(
-                    "__import__('%s.%s')" % (generator.base_mod_name, ref.python_name),
-                    file=stream,
-                )
-                print(
-                    "%s = sys.modules['%s.%s'].%s"
-                    % (
-                        ref.python_name,
-                        generator.base_mod_name,
-                        ref.python_name,
-                        ref.python_name,
-                    ),
-                    file=stream,
-                )
-                # And pretend we have written it - the name is now available as if we had!
-                ref.bWritten = 1
-        try:
-            progId = pythoncom.ProgIDFromCLSID(self.clsid)
-            print("# This CoClass is known by the name '%s'" % (progId), file=stream)
-        except pythoncom.com_error:
-            pass
-        print(
-            "class %s(CoClassBaseClass): # A CoClass" % (self.python_name), file=stream
-        )
-        if doc and doc[1]:
-            print("\t# " + doc[1], file=stream)
-        print("\tCLSID = %r" % (self.clsid,), file=stream)
-        print("\tcoclass_sources = [", file=stream)
-        defItem = None
-        for item, flag in self.sources:
-            if flag & pythoncom.IMPLTYPEFLAG_FDEFAULT:
-                defItem = item
-            # If we have written a Python class, reference the name -
-            # otherwise just the IID.
-            if item.bWritten:
-                key = item.python_name
-            else:
-                key = repr(str(item.clsid))  # really the iid.
-            print("\t\t%s," % (key), file=stream)
-        print("\t]", file=stream)
-        if defItem:
-            if defItem.bWritten:
-                defName = defItem.python_name
-            else:
-                defName = repr(str(defItem.clsid))  # really the iid.
-            print("\tdefault_source = %s" % (defName,), file=stream)
-        print("\tcoclass_interfaces = [", file=stream)
-        defItem = None
-        for item, flag in self.interfaces:
-            if flag & pythoncom.IMPLTYPEFLAG_FDEFAULT:  # and dual:
-                defItem = item
-            # If we have written a class, reference its name, otherwise the IID
-            if item.bWritten:
-                key = item.python_name
-            else:
-                key = repr(str(item.clsid))  # really the iid.
-            print("\t\t%s," % (key,), file=stream)
-        print("\t]", file=stream)
-        if defItem:
-            if defItem.bWritten:
-                defName = defItem.python_name
-            else:
-                defName = repr(str(defItem.clsid))  # really the iid.
-            print("\tdefault_interface = %s" % (defName,), file=stream)
-        self.bWritten = 1
-        print(file=stream)
-
-
-class GeneratorProgress:
-    def __init__(self):
-        pass
-
-    def Starting(self, tlb_desc):
-        """Called when the process starts."""
-        self.tlb_desc = tlb_desc
-
-    def Finished(self):
-        """Called when the process is complete."""
-
-    def SetDescription(self, desc, maxticks=None):
-        """We are entering a major step.  If maxticks, then this
-        is how many ticks we expect to make until finished
-        """
-
-    def Tick(self, desc=None):
-        """Minor progress step.  Can provide new description if necessary"""
-
-    def VerboseProgress(self, desc):
-        """Verbose/Debugging output."""
-
-    def LogWarning(self, desc):
-        """If a warning is generated"""
-
-    def LogBeginGenerate(self, filename):
-        pass
-
-    def Close(self):
-        pass
-
-
-class Generator:
-    def __init__(
-        self,
-        typelib,
-        sourceFilename,
-        progressObject,
-        bBuildHidden=1,
-        bUnicodeToString=None,
-    ):
-        assert bUnicodeToString is None, "this is deprecated and will go away"
-        self.bHaveWrittenDispatchBaseClass = 0
-        self.bHaveWrittenCoClassBaseClass = 0
-        self.bHaveWrittenEventBaseClass = 0
-        self.typelib = typelib
-        self.sourceFilename = sourceFilename
-        self.bBuildHidden = bBuildHidden
-        self.progress = progressObject
-        # These 2 are later additions and most of the code still 'print's...
-        self.file = None
-
-    def CollectOleItemInfosFromType(self):
-        ret = []
-        for i in range(self.typelib.GetTypeInfoCount()):
-            info = self.typelib.GetTypeInfo(i)
-            infotype = self.typelib.GetTypeInfoType(i)
-            doc = self.typelib.GetDocumentation(i)
-            attr = info.GetTypeAttr()
-            ret.append((info, infotype, doc, attr))
-        return ret
-
-    def _Build_CoClass(self, type_info_tuple):
-        info, infotype, doc, attr = type_info_tuple
-        # find the source and dispinterfaces for the coclass
-        child_infos = []
-        for j in range(attr[8]):
-            flags = info.GetImplTypeFlags(j)
-            try:
-                refType = info.GetRefTypeInfo(info.GetRefTypeOfImplType(j))
-            except pythoncom.com_error:
-                # Can't load a dependent typelib?
-                continue
-            refAttr = refType.GetTypeAttr()
-            child_infos.append(
-                (
-                    info,
-                    refAttr.typekind,
-                    refType,
-                    refType.GetDocumentation(-1),
-                    refAttr,
-                    flags,
-                )
-            )
-
-        # Done generating children - now the CoClass itself.
-        newItem = CoClassItem(info, attr, doc)
-        return newItem, child_infos
-
-    def _Build_CoClassChildren(self, coclass, coclass_info, oleItems, vtableItems):
-        sources = {}
-        interfaces = {}
-        for info, info_type, refType, doc, refAttr, flags in coclass_info:
-            #          sys.stderr.write("Attr typeflags for coclass referenced object %s=%d (%d), typekind=%d\n" % (name, refAttr.wTypeFlags, refAttr.wTypeFlags & pythoncom.TYPEFLAG_FDUAL,refAttr.typekind))
-            if refAttr.typekind == pythoncom.TKIND_DISPATCH or (
-                refAttr.typekind == pythoncom.TKIND_INTERFACE
-                and refAttr[11] & pythoncom.TYPEFLAG_FDISPATCHABLE
-            ):
-                clsid = refAttr[0]
-                if clsid in oleItems:
-                    dispItem = oleItems[clsid]
-                else:
-                    dispItem = DispatchItem(refType, refAttr, doc)
-                    oleItems[dispItem.clsid] = dispItem
-                dispItem.coclass_clsid = coclass.clsid
-                if flags & pythoncom.IMPLTYPEFLAG_FSOURCE:
-                    dispItem.bIsSink = 1
-                    sources[dispItem.clsid] = (dispItem, flags)
-                else:
-                    interfaces[dispItem.clsid] = (dispItem, flags)
-                # If dual interface, make do that too.
-                if clsid not in vtableItems and refAttr[11] & pythoncom.TYPEFLAG_FDUAL:
-                    refType = refType.GetRefTypeInfo(refType.GetRefTypeOfImplType(-1))
-                    refAttr = refType.GetTypeAttr()
-                    assert (
-                        refAttr.typekind == pythoncom.TKIND_INTERFACE
-                    ), "must be interface bynow!"
-                    vtableItem = VTableItem(refType, refAttr, doc)
-                    vtableItems[clsid] = vtableItem
-        coclass.sources = list(sources.values())
-        coclass.interfaces = list(interfaces.values())
-
-    def _Build_Interface(self, type_info_tuple):
-        info, infotype, doc, attr = type_info_tuple
-        oleItem = vtableItem = None
-        if infotype == pythoncom.TKIND_DISPATCH or (
-            infotype == pythoncom.TKIND_INTERFACE
-            and attr[11] & pythoncom.TYPEFLAG_FDISPATCHABLE
-        ):
-            oleItem = DispatchItem(info, attr, doc)
-            # If this DISPATCH interface dual, then build that too.
-            if attr.wTypeFlags & pythoncom.TYPEFLAG_FDUAL:
-                # Get the vtable interface
-                refhtype = info.GetRefTypeOfImplType(-1)
-                info = info.GetRefTypeInfo(refhtype)
-                attr = info.GetTypeAttr()
-                infotype = pythoncom.TKIND_INTERFACE
-            else:
-                infotype = None
-        assert infotype in [
-            None,
-            pythoncom.TKIND_INTERFACE,
-        ], "Must be a real interface at this point"
-        if infotype == pythoncom.TKIND_INTERFACE:
-            vtableItem = VTableItem(info, attr, doc)
-        return oleItem, vtableItem
-
-    def BuildOleItemsFromType(self):
-        assert (
-            self.bBuildHidden
-        ), "This code doesnt look at the hidden flag - I thought everyone set it true!?!?!"
-        oleItems = {}
-        enumItems = {}
-        recordItems = {}
-        vtableItems = {}
-
-        for type_info_tuple in self.CollectOleItemInfosFromType():
-            info, infotype, doc, attr = type_info_tuple
-            clsid = attr[0]
-            if infotype == pythoncom.TKIND_ENUM or infotype == pythoncom.TKIND_MODULE:
-                newItem = EnumerationItem(info, attr, doc)
-                enumItems[newItem.doc[0]] = newItem
-            # We never hide interfaces (MSAccess, for example, nominates interfaces as
-            # hidden, assuming that you only ever use them via the CoClass)
-            elif infotype in [pythoncom.TKIND_DISPATCH, pythoncom.TKIND_INTERFACE]:
-                if clsid not in oleItems:
-                    oleItem, vtableItem = self._Build_Interface(type_info_tuple)
-                    oleItems[clsid] = oleItem  # Even "None" goes in here.
-                    if vtableItem is not None:
-                        vtableItems[clsid] = vtableItem
-            elif (
-                infotype == pythoncom.TKIND_RECORD or infotype == pythoncom.TKIND_UNION
-            ):
-                newItem = RecordItem(info, attr, doc)
-                recordItems[newItem.clsid] = newItem
-            elif infotype == pythoncom.TKIND_ALIAS:
-                # We dont care about alias' - handled intrinsicly.
-                continue
-            elif infotype == pythoncom.TKIND_COCLASS:
-                newItem, child_infos = self._Build_CoClass(type_info_tuple)
-                self._Build_CoClassChildren(newItem, child_infos, oleItems, vtableItems)
-                oleItems[newItem.clsid] = newItem
-            else:
-                self.progress.LogWarning("Unknown TKIND found: %d" % infotype)
-
-        return oleItems, enumItems, recordItems, vtableItems
-
-    def open_writer(self, filename, encoding="mbcs"):
-        # A place to put code to open a file with the appropriate encoding.
-        # Does *not* set self.file - just opens and returns a file.
-        # Actually returns a handle to a temp file - finish_writer then deletes
-        # the filename asked for and puts everything back in place.  This
-        # is so errors don't leave a 1/2 generated file around causing bizarre
-        # errors later, and so that multiple processes writing the same file
-        # don't step on each others' toes.
-        # Could be a classmethod one day...
-        temp_filename = self.get_temp_filename(filename)
-        return open(temp_filename, "wt", encoding=encoding)
-
-    def finish_writer(self, filename, f, worked):
-        f.close()
-        try:
-            os.unlink(filename)
-        except os.error:
-            pass
-        temp_filename = self.get_temp_filename(filename)
-        if worked:
-            try:
-                os.rename(temp_filename, filename)
-            except os.error:
-                # If we are really unlucky, another process may have written the
-                # file in between our calls to os.unlink and os.rename. So try
-                # again, but only once.
-                # There are still some race conditions, but they seem difficult to
-                # fix, and they probably occur much less frequently:
-                # * The os.rename failure could occur more than once if more than
-                #   two processes are involved.
-                # * In between os.unlink and os.rename, another process could try
-                #   to import the module, having seen that it already exists.
-                # * If another process starts a COM server while we are still
-                #   generating __init__.py, that process sees that the folder
-                #   already exists and assumes that __init__.py is already there
-                #   as well.
-                try:
-                    os.unlink(filename)
-                except os.error:
-                    pass
-                os.rename(temp_filename, filename)
-        else:
-            os.unlink(temp_filename)
-
-    def get_temp_filename(self, filename):
-        return "%s.%d.temp" % (filename, os.getpid())
-
-    def generate(self, file, is_for_demand=0):
-        if is_for_demand:
-            self.generate_type = GEN_DEMAND_BASE
-        else:
-            self.generate_type = GEN_FULL
-        self.file = file
-        self.do_generate()
-        self.file = None
-        self.progress.Finished()
-
-    def do_gen_file_header(self):
-        la = self.typelib.GetLibAttr()
-        moduleDoc = self.typelib.GetDocumentation(-1)
-        docDesc = ""
-        if moduleDoc[1]:
-            docDesc = moduleDoc[1]
-
-        # Reset all the 'per file' state
-        self.bHaveWrittenDispatchBaseClass = 0
-        self.bHaveWrittenCoClassBaseClass = 0
-        self.bHaveWrittenEventBaseClass = 0
-        # You must provide a file correctly configured for writing unicode.
-        # We assert this is it may indicate somewhere in pywin32 that needs
-        # upgrading.
-        assert self.file.encoding, self.file
-        encoding = self.file.encoding  # or "mbcs"
-
-        print("# -*- coding: %s -*-" % (encoding,), file=self.file)
-        print("# Created by makepy.py version %s" % (makepy_version,), file=self.file)
-        print(
-            "# By python version %s" % (sys.version.replace("\n", "-"),), file=self.file
-        )
-        if self.sourceFilename:
-            print(
-                "# From type library '%s'" % (os.path.split(self.sourceFilename)[1],),
-                file=self.file,
-            )
-        print("# On %s" % time.ctime(time.time()), file=self.file)
-
-        print(build._makeDocString(docDesc), file=self.file)
-
-        print("makepy_version =", repr(makepy_version), file=self.file)
-        print("python_version = 0x%x" % (sys.hexversion,), file=self.file)
-        print(file=self.file)
-        print(
-            "import win32com.client.CLSIDToClass, pythoncom, pywintypes", file=self.file
-        )
-        print("import win32com.client.util", file=self.file)
-        print("from pywintypes import IID", file=self.file)
-        print("from win32com.client import Dispatch", file=self.file)
-        print(file=self.file)
-        print(
-            "# The following 3 lines may need tweaking for the particular server",
-            file=self.file,
-        )
-        print(
-            "# Candidates are pythoncom.Missing, .Empty and .ArgNotFound",
-            file=self.file,
-        )
-        print("defaultNamedOptArg=pythoncom.Empty", file=self.file)
-        print("defaultNamedNotOptArg=pythoncom.Empty", file=self.file)
-        print("defaultUnnamedArg=pythoncom.Empty", file=self.file)
-        print(file=self.file)
-        print("CLSID = " + repr(la[0]), file=self.file)
-        print("MajorVersion = " + str(la[3]), file=self.file)
-        print("MinorVersion = " + str(la[4]), file=self.file)
-        print("LibraryFlags = " + str(la[5]), file=self.file)
-        print("LCID = " + hex(la[1]), file=self.file)
-        print(file=self.file)
-
-    def do_generate(self):
-        moduleDoc = self.typelib.GetDocumentation(-1)
-        stream = self.file
-        docDesc = ""
-        if moduleDoc[1]:
-            docDesc = moduleDoc[1]
-        self.progress.Starting(docDesc)
-        self.progress.SetDescription("Building definitions from type library...")
-
-        self.do_gen_file_header()
-
-        oleItems, enumItems, recordItems, vtableItems = self.BuildOleItemsFromType()
-
-        self.progress.SetDescription(
-            "Generating...", len(oleItems) + len(enumItems) + len(vtableItems)
-        )
-
-        # Generate the constants and their support.
-        if enumItems:
-            print("class constants:", file=stream)
-            items = list(enumItems.values())
-            items.sort()
-            num_written = 0
-            for oleitem in items:
-                num_written += oleitem.WriteEnumerationItems(stream)
-                self.progress.Tick()
-            if not num_written:
-                print("\tpass", file=stream)
-            print(file=stream)
-
-        if self.generate_type == GEN_FULL:
-            items = [l for l in oleItems.values() if l is not None]
-            items.sort()
-            for oleitem in items:
-                self.progress.Tick()
-                oleitem.WriteClass(self)
-
-            items = list(vtableItems.values())
-            items.sort()
-            for oleitem in items:
-                self.progress.Tick()
-                oleitem.WriteClass(self)
-        else:
-            self.progress.Tick(len(oleItems) + len(vtableItems))
-
-        print("RecordMap = {", file=stream)
-        for record in recordItems.values():
-            if record.clsid == pythoncom.IID_NULL:
-                print(
-                    "\t###%s: %s, # Record disabled because it doesn't have a non-null GUID"
-                    % (repr(record.doc[0]), repr(str(record.clsid))),
-                    file=stream,
-                )
-            else:
-                print(
-                    "\t%s: %s," % (repr(record.doc[0]), repr(str(record.clsid))),
-                    file=stream,
-                )
-        print("}", file=stream)
-        print(file=stream)
-
-        # Write out _all_ my generated CLSID's in the map
-        if self.generate_type == GEN_FULL:
-            print("CLSIDToClassMap = {", file=stream)
-            for item in oleItems.values():
-                if item is not None and item.bWritten:
-                    print(
-                        "\t'%s' : %s," % (str(item.clsid), item.python_name),
-                        file=stream,
-                    )
-            print("}", file=stream)
-            print("CLSIDToPackageMap = {}", file=stream)
-            print(
-                "win32com.client.CLSIDToClass.RegisterCLSIDsFromDict( CLSIDToClassMap )",
-                file=stream,
-            )
-            print("VTablesToPackageMap = {}", file=stream)
-            print("VTablesToClassMap = {", file=stream)
-            for item in vtableItems.values():
-                print("\t'%s' : '%s'," % (item.clsid, item.python_name), file=stream)
-            print("}", file=stream)
-            print(file=stream)
-
-        else:
-            print("CLSIDToClassMap = {}", file=stream)
-            print("CLSIDToPackageMap = {", file=stream)
-            for item in oleItems.values():
-                if item is not None:
-                    print(
-                        "\t'%s' : %s," % (str(item.clsid), repr(item.python_name)),
-                        file=stream,
-                    )
-            print("}", file=stream)
-            print("VTablesToClassMap = {}", file=stream)
-            print("VTablesToPackageMap = {", file=stream)
-            for item in vtableItems.values():
-                print("\t'%s' : '%s'," % (item.clsid, item.python_name), file=stream)
-            print("}", file=stream)
-            print(file=stream)
-
-        print(file=stream)
-        # Bit of a hack - build a temp map of iteItems + vtableItems - coClasses
-        map = {}
-        for item in oleItems.values():
-            if item is not None and not isinstance(item, CoClassItem):
-                map[item.python_name] = item.clsid
-        for item in vtableItems.values():  # No nones or CoClasses in this map
-            map[item.python_name] = item.clsid
-
-        print("NamesToIIDMap = {", file=stream)
-        for name, iid in map.items():
-            print("\t'%s' : '%s'," % (name, iid), file=stream)
-        print("}", file=stream)
-        print(file=stream)
-
-        if enumItems:
-            print(
-                "win32com.client.constants.__dicts__.append(constants.__dict__)",
-                file=stream,
-            )
-        print(file=stream)
-
-    def generate_child(self, child, dir):
-        "Generate a single child.  May force a few children to be built as we generate deps"
-        self.generate_type = GEN_DEMAND_CHILD
-
-        la = self.typelib.GetLibAttr()
-        lcid = la[1]
-        clsid = la[0]
-        major = la[3]
-        minor = la[4]
-        self.base_mod_name = (
-            "win32com.gen_py." + str(clsid)[1:-1] + "x%sx%sx%s" % (lcid, major, minor)
-        )
-        try:
-            # Process the type library's CoClass objects, looking for the
-            # specified name, or where a child has the specified name.
-            # This ensures that all interesting things (including event interfaces)
-            # are generated correctly.
-            oleItems = {}
-            vtableItems = {}
-            infos = self.CollectOleItemInfosFromType()
-            found = 0
-            for type_info_tuple in infos:
-                info, infotype, doc, attr = type_info_tuple
-                if infotype == pythoncom.TKIND_COCLASS:
-                    coClassItem, child_infos = self._Build_CoClass(type_info_tuple)
-                    found = build.MakePublicAttributeName(doc[0]) == child
-                    if not found:
-                        # OK, check the child interfaces
-                        for (
-                            info,
-                            info_type,
-                            refType,
-                            doc,
-                            refAttr,
-                            flags,
-                        ) in child_infos:
-                            if build.MakePublicAttributeName(doc[0]) == child:
-                                found = 1
-                                break
-                    if found:
-                        oleItems[coClassItem.clsid] = coClassItem
-                        self._Build_CoClassChildren(
-                            coClassItem, child_infos, oleItems, vtableItems
-                        )
-                        break
-            if not found:
-                # Doesn't appear in a class defn - look in the interface objects for it
-                for type_info_tuple in infos:
-                    info, infotype, doc, attr = type_info_tuple
-                    if infotype in [
-                        pythoncom.TKIND_INTERFACE,
-                        pythoncom.TKIND_DISPATCH,
-                    ]:
-                        if build.MakePublicAttributeName(doc[0]) == child:
-                            found = 1
-                            oleItem, vtableItem = self._Build_Interface(type_info_tuple)
-                            oleItems[clsid] = oleItem  # Even "None" goes in here.
-                            if vtableItem is not None:
-                                vtableItems[clsid] = vtableItem
-
-            assert (
-                found
-            ), "Cant find the '%s' interface in the CoClasses, or the interfaces" % (
-                child,
-            )
-            # Make a map of iid: dispitem, vtableitem)
-            items = {}
-            for key, value in oleItems.items():
-                items[key] = (value, None)
-            for key, value in vtableItems.items():
-                existing = items.get(key, None)
-                if existing is not None:
-                    new_val = existing[0], value
-                else:
-                    new_val = None, value
-                items[key] = new_val
-
-            self.progress.SetDescription("Generating...", len(items))
-            for oleitem, vtableitem in items.values():
-                an_item = oleitem or vtableitem
-                assert not self.file, "already have a file?"
-                # like makepy.py, we gen to a .temp file so failure doesn't
-                # leave a 1/2 generated mess.
-                out_name = os.path.join(dir, an_item.python_name) + ".py"
-                worked = False
-                self.file = self.open_writer(out_name)
-                try:
-                    if oleitem is not None:
-                        self.do_gen_child_item(oleitem)
-                    if vtableitem is not None:
-                        self.do_gen_child_item(vtableitem)
-                    self.progress.Tick()
-                    worked = True
-                finally:
-                    self.finish_writer(out_name, self.file, worked)
-                    self.file = None
-        finally:
-            self.progress.Finished()
-
-    def do_gen_child_item(self, oleitem):
-        moduleDoc = self.typelib.GetDocumentation(-1)
-        docDesc = ""
-        if moduleDoc[1]:
-            docDesc = moduleDoc[1]
-        self.progress.Starting(docDesc)
-        self.progress.SetDescription("Building definitions from type library...")
-        self.do_gen_file_header()
-        oleitem.WriteClass(self)
-        if oleitem.bWritten:
-            print(
-                'win32com.client.CLSIDToClass.RegisterCLSID( "%s", %s )'
-                % (oleitem.clsid, oleitem.python_name),
-                file=self.file,
-            )
-
-    def checkWriteDispatchBaseClass(self):
-        if not self.bHaveWrittenDispatchBaseClass:
-            print("from win32com.client import DispatchBaseClass", file=self.file)
-            self.bHaveWrittenDispatchBaseClass = 1
-
-    def checkWriteCoClassBaseClass(self):
-        if not self.bHaveWrittenCoClassBaseClass:
-            print("from win32com.client import CoClassBaseClass", file=self.file)
-            self.bHaveWrittenCoClassBaseClass = 1
-
-    def checkWriteEventBaseClass(self):
-        # Not a base class as such...
-        if not self.bHaveWrittenEventBaseClass:
-            # Nothing to do any more!
-            self.bHaveWrittenEventBaseClass = 1
-
-
-if __name__ == "__main__":
-    print("This is a worker module.  Please use makepy to generate Python files.")
diff --git a/lib/win32com/client/makepy.py b/lib/win32com/client/makepy.py
deleted file mode 100644
index 041f18a4..00000000
--- a/lib/win32com/client/makepy.py
+++ /dev/null
@@ -1,459 +0,0 @@
-# Originally written by Curt Hagenlocher, and various bits
-# and pieces by Mark Hammond (and now Greg Stein has had
-# a go too :-)
-
-# Note that the main worker code has been moved to genpy.py
-# As this is normally run from the command line, it reparses the code each time.
-# Now this is nothing more than the command line handler and public interface.
-
-# XXX - TO DO
-# XXX - Greg and Mark have some ideas for a revamp - just no
-#       time - if you want to help, contact us for details.
-#       Main idea is to drop the classes exported and move to a more
-#       traditional data driven model.
-
-"""Generate a .py file from an OLE TypeLibrary file.
-
-
- This module is concerned only with the actual writing of
- a .py file.  It draws on the @build@ module, which builds
- the knowledge of a COM interface.
-
-"""
-usageHelp = """ \
-
-Usage:
-
-  makepy.py [-i] [-v|q] [-h] [-u] [-o output_file] [-d] [typelib, ...]
-
-  -i    -- Show information for the specified typelib.
-
-  -v    -- Verbose output.
-
-  -q    -- Quiet output.
-
-  -h    -- Do not generate hidden methods.
-
-  -u    -- Python 1.5 and earlier: Do NOT convert all Unicode objects to
-           strings.
-
-           Python 1.6 and later: Convert all Unicode objects to strings.
-
-  -o    -- Create output in a specified output file.  If the path leading
-           to the file does not exist, any missing directories will be
-           created.
-           NOTE: -o cannot be used with -d.  This will generate an error.
-
-  -d    -- Generate the base code now and the class code on demand.
-           Recommended for large type libraries.
-
-  typelib -- A TLB, DLL, OCX or anything containing COM type information.
-             If a typelib is not specified, a window containing a textbox
-             will open from which you can select a registered type
-             library.
-
-Examples:
-
-  makepy.py -d
-
-    Presents a list of registered type libraries from which you can make
-    a selection.
-
-  makepy.py -d "Microsoft Excel 8.0 Object Library"
-
-    Generate support for the type library with the specified description
-    (in this case, the MS Excel object model).
-
-"""
-
-import importlib
-import os
-import sys
-
-import pythoncom
-from win32com.client import Dispatch, gencache, genpy, selecttlb
-
-bForDemandDefault = 0  # Default value of bForDemand - toggle this to change the world - see also gencache.py
-
-error = "makepy.error"
-
-
-def usage():
-    sys.stderr.write(usageHelp)
-    sys.exit(2)
-
-
-def ShowInfo(spec):
-    if not spec:
-        tlbSpec = selecttlb.SelectTlb(excludeFlags=selecttlb.FLAG_HIDDEN)
-        if tlbSpec is None:
-            return
-        try:
-            tlb = pythoncom.LoadRegTypeLib(
-                tlbSpec.clsid, tlbSpec.major, tlbSpec.minor, tlbSpec.lcid
-            )
-        except pythoncom.com_error:  # May be badly registered.
-            sys.stderr.write(
-                "Warning - could not load registered typelib '%s'\n" % (tlbSpec.clsid)
-            )
-            tlb = None
-
-        infos = [(tlb, tlbSpec)]
-    else:
-        infos = GetTypeLibsForSpec(spec)
-    for tlb, tlbSpec in infos:
-        desc = tlbSpec.desc
-        if desc is None:
-            if tlb is None:
-                desc = "<Could not load typelib %s>" % (tlbSpec.dll)
-            else:
-                desc = tlb.GetDocumentation(-1)[0]
-        print(desc)
-        print(
-            " %s, lcid=%s, major=%s, minor=%s"
-            % (tlbSpec.clsid, tlbSpec.lcid, tlbSpec.major, tlbSpec.minor)
-        )
-        print(" >>> # Use these commands in Python code to auto generate .py support")
-        print(" >>> from win32com.client import gencache")
-        print(
-            " >>> gencache.EnsureModule('%s', %s, %s, %s)"
-            % (tlbSpec.clsid, tlbSpec.lcid, tlbSpec.major, tlbSpec.minor)
-        )
-
-
-class SimpleProgress(genpy.GeneratorProgress):
-    """A simple progress class prints its output to stderr"""
-
-    def __init__(self, verboseLevel):
-        self.verboseLevel = verboseLevel
-
-    def Close(self):
-        pass
-
-    def Finished(self):
-        if self.verboseLevel > 1:
-            sys.stderr.write("Generation complete..\n")
-
-    def SetDescription(self, desc, maxticks=None):
-        if self.verboseLevel:
-            sys.stderr.write(desc + "\n")
-
-    def Tick(self, desc=None):
-        pass
-
-    def VerboseProgress(self, desc, verboseLevel=2):
-        if self.verboseLevel >= verboseLevel:
-            sys.stderr.write(desc + "\n")
-
-    def LogBeginGenerate(self, filename):
-        self.VerboseProgress("Generating to %s" % filename, 1)
-
-    def LogWarning(self, desc):
-        self.VerboseProgress("WARNING: " + desc, 1)
-
-
-class GUIProgress(SimpleProgress):
-    def __init__(self, verboseLevel):
-        # Import some modules we need to we can trap failure now.
-        import pywin  # nopycln: import
-        import win32ui
-
-        SimpleProgress.__init__(self, verboseLevel)
-        self.dialog = None
-
-    def Close(self):
-        if self.dialog is not None:
-            self.dialog.Close()
-            self.dialog = None
-
-    def Starting(self, tlb_desc):
-        SimpleProgress.Starting(self, tlb_desc)
-        if self.dialog is None:
-            from pywin.dialogs import status
-
-            self.dialog = status.ThreadedStatusProgressDialog(tlb_desc)
-        else:
-            self.dialog.SetTitle(tlb_desc)
-
-    def SetDescription(self, desc, maxticks=None):
-        self.dialog.SetText(desc)
-        if maxticks:
-            self.dialog.SetMaxTicks(maxticks)
-
-    def Tick(self, desc=None):
-        self.dialog.Tick()
-        if desc is not None:
-            self.dialog.SetText(desc)
-
-
-def GetTypeLibsForSpec(arg):
-    """Given an argument on the command line (either a file name, library
-    description, or ProgID of an object) return a list of actual typelibs
-    to use."""
-    typelibs = []
-    try:
-        try:
-            tlb = pythoncom.LoadTypeLib(arg)
-            spec = selecttlb.TypelibSpec(None, 0, 0, 0)
-            spec.FromTypelib(tlb, arg)
-            typelibs.append((tlb, spec))
-        except pythoncom.com_error:
-            # See if it is a description
-            tlbs = selecttlb.FindTlbsWithDescription(arg)
-            if len(tlbs) == 0:
-                # Maybe it is the name of a COM object?
-                try:
-                    ob = Dispatch(arg)
-                    # and if so, it must support typelib info
-                    tlb, index = ob._oleobj_.GetTypeInfo().GetContainingTypeLib()
-                    spec = selecttlb.TypelibSpec(None, 0, 0, 0)
-                    spec.FromTypelib(tlb)
-                    tlbs.append(spec)
-                except pythoncom.com_error:
-                    pass
-            if len(tlbs) == 0:
-                print("Could not locate a type library matching '%s'" % (arg))
-            for spec in tlbs:
-                # Version numbers not always reliable if enumerated from registry.
-                # (as some libs use hex, other's dont.  Both examples from MS, of course.)
-                if spec.dll is None:
-                    tlb = pythoncom.LoadRegTypeLib(
-                        spec.clsid, spec.major, spec.minor, spec.lcid
-                    )
-                else:
-                    tlb = pythoncom.LoadTypeLib(spec.dll)
-
-                # We have a typelib, but it may not be exactly what we specified
-                # (due to automatic version matching of COM).  So we query what we really have!
-                attr = tlb.GetLibAttr()
-                spec.major = attr[3]
-                spec.minor = attr[4]
-                spec.lcid = attr[1]
-                typelibs.append((tlb, spec))
-        return typelibs
-    except pythoncom.com_error:
-        t, v, tb = sys.exc_info()
-        sys.stderr.write("Unable to load type library from '%s' - %s\n" % (arg, v))
-        tb = None  # Storing tb in a local is a cycle!
-        sys.exit(1)
-
-
-def GenerateFromTypeLibSpec(
-    typelibInfo,
-    file=None,
-    verboseLevel=None,
-    progressInstance=None,
-    bUnicodeToString=None,
-    bForDemand=bForDemandDefault,
-    bBuildHidden=1,
-):
-    assert bUnicodeToString is None, "this is deprecated and will go away"
-    if verboseLevel is None:
-        verboseLevel = 0  # By default, we use no gui and no verbose level!
-
-    if bForDemand and file is not None:
-        raise RuntimeError(
-            "You can only perform a demand-build when the output goes to the gen_py directory"
-        )
-    if isinstance(typelibInfo, tuple):
-        # Tuple
-        typelibCLSID, lcid, major, minor = typelibInfo
-        tlb = pythoncom.LoadRegTypeLib(typelibCLSID, major, minor, lcid)
-        spec = selecttlb.TypelibSpec(typelibCLSID, lcid, major, minor)
-        spec.FromTypelib(tlb, str(typelibCLSID))
-        typelibs = [(tlb, spec)]
-    elif isinstance(typelibInfo, selecttlb.TypelibSpec):
-        if typelibInfo.dll is None:
-            # Version numbers not always reliable if enumerated from registry.
-            tlb = pythoncom.LoadRegTypeLib(
-                typelibInfo.clsid,
-                typelibInfo.major,
-                typelibInfo.minor,
-                typelibInfo.lcid,
-            )
-        else:
-            tlb = pythoncom.LoadTypeLib(typelibInfo.dll)
-        typelibs = [(tlb, typelibInfo)]
-    elif hasattr(typelibInfo, "GetLibAttr"):
-        # A real typelib object!
-        # Could also use isinstance(typelibInfo, PyITypeLib) instead, but PyITypeLib is not directly exposed by pythoncom.
-        # 	pythoncom.TypeIIDs[pythoncom.IID_ITypeLib] seems to work
-        tla = typelibInfo.GetLibAttr()
-        guid = tla[0]
-        lcid = tla[1]
-        major = tla[3]
-        minor = tla[4]
-        spec = selecttlb.TypelibSpec(guid, lcid, major, minor)
-        typelibs = [(typelibInfo, spec)]
-    else:
-        typelibs = GetTypeLibsForSpec(typelibInfo)
-
-    if progressInstance is None:
-        progressInstance = SimpleProgress(verboseLevel)
-    progress = progressInstance
-
-    bToGenDir = file is None
-
-    for typelib, info in typelibs:
-        gen = genpy.Generator(typelib, info.dll, progress, bBuildHidden=bBuildHidden)
-
-        if file is None:
-            this_name = gencache.GetGeneratedFileName(
-                info.clsid, info.lcid, info.major, info.minor
-            )
-            full_name = os.path.join(gencache.GetGeneratePath(), this_name)
-            if bForDemand:
-                try:
-                    os.unlink(full_name + ".py")
-                except os.error:
-                    pass
-                try:
-                    os.unlink(full_name + ".pyc")
-                except os.error:
-                    pass
-                try:
-                    os.unlink(full_name + ".pyo")
-                except os.error:
-                    pass
-                if not os.path.isdir(full_name):
-                    os.mkdir(full_name)
-                outputName = os.path.join(full_name, "__init__.py")
-            else:
-                outputName = full_name + ".py"
-            fileUse = gen.open_writer(outputName)
-            progress.LogBeginGenerate(outputName)
-        else:
-            fileUse = file
-
-        worked = False
-        try:
-            gen.generate(fileUse, bForDemand)
-            worked = True
-        finally:
-            if file is None:
-                gen.finish_writer(outputName, fileUse, worked)
-        importlib.invalidate_caches()
-        if bToGenDir:
-            progress.SetDescription("Importing module")
-            gencache.AddModuleToCache(info.clsid, info.lcid, info.major, info.minor)
-
-    progress.Close()
-
-
-def GenerateChildFromTypeLibSpec(
-    child, typelibInfo, verboseLevel=None, progressInstance=None, bUnicodeToString=None
-):
-    assert bUnicodeToString is None, "this is deprecated and will go away"
-    if verboseLevel is None:
-        verboseLevel = (
-            0  # By default, we use no gui, and no verbose level for the children.
-        )
-    if type(typelibInfo) == type(()):
-        typelibCLSID, lcid, major, minor = typelibInfo
-        tlb = pythoncom.LoadRegTypeLib(typelibCLSID, major, minor, lcid)
-    else:
-        tlb = typelibInfo
-        tla = typelibInfo.GetLibAttr()
-        typelibCLSID = tla[0]
-        lcid = tla[1]
-        major = tla[3]
-        minor = tla[4]
-    spec = selecttlb.TypelibSpec(typelibCLSID, lcid, major, minor)
-    spec.FromTypelib(tlb, str(typelibCLSID))
-    typelibs = [(tlb, spec)]
-
-    if progressInstance is None:
-        progressInstance = SimpleProgress(verboseLevel)
-    progress = progressInstance
-
-    for typelib, info in typelibs:
-        dir_name = gencache.GetGeneratedFileName(
-            info.clsid, info.lcid, info.major, info.minor
-        )
-        dir_path_name = os.path.join(gencache.GetGeneratePath(), dir_name)
-        progress.LogBeginGenerate(dir_path_name)
-
-        gen = genpy.Generator(typelib, info.dll, progress)
-        gen.generate_child(child, dir_path_name)
-        progress.SetDescription("Importing module")
-        importlib.invalidate_caches()
-        __import__("win32com.gen_py." + dir_name + "." + child)
-    progress.Close()
-
-
-def main():
-    import getopt
-
-    hiddenSpec = 1
-    outputName = None
-    verboseLevel = 1
-    doit = 1
-    bForDemand = bForDemandDefault
-    try:
-        opts, args = getopt.getopt(sys.argv[1:], "vo:huiqd")
-        for o, v in opts:
-            if o == "-h":
-                hiddenSpec = 0
-            elif o == "-o":
-                outputName = v
-            elif o == "-v":
-                verboseLevel = verboseLevel + 1
-            elif o == "-q":
-                verboseLevel = verboseLevel - 1
-            elif o == "-i":
-                if len(args) == 0:
-                    ShowInfo(None)
-                else:
-                    for arg in args:
-                        ShowInfo(arg)
-                doit = 0
-            elif o == "-d":
-                bForDemand = not bForDemand
-
-    except (getopt.error, error) as msg:
-        sys.stderr.write(str(msg) + "\n")
-        usage()
-
-    if bForDemand and outputName is not None:
-        sys.stderr.write("Can not use -d and -o together\n")
-        usage()
-
-    if not doit:
-        return 0
-    if len(args) == 0:
-        rc = selecttlb.SelectTlb()
-        if rc is None:
-            sys.exit(1)
-        args = [rc]
-
-    if outputName is not None:
-        path = os.path.dirname(outputName)
-        if path != "" and not os.path.exists(path):
-            os.makedirs(path)
-        if sys.version_info > (3, 0):
-            f = open(outputName, "wt", encoding="mbcs")
-        else:
-            import codecs  # not available in py3k.
-
-            f = codecs.open(outputName, "w", "mbcs")
-    else:
-        f = None
-
-    for arg in args:
-        GenerateFromTypeLibSpec(
-            arg,
-            f,
-            verboseLevel=verboseLevel,
-            bForDemand=bForDemand,
-            bBuildHidden=hiddenSpec,
-        )
-
-    if f:
-        f.close()
-
-
-if __name__ == "__main__":
-    rc = main()
-    if rc:
-        sys.exit(rc)
-    sys.exit(0)
diff --git a/lib/win32com/client/selecttlb.py b/lib/win32com/client/selecttlb.py
deleted file mode 100644
index bb21a429..00000000
--- a/lib/win32com/client/selecttlb.py
+++ /dev/null
@@ -1,183 +0,0 @@
-"""Utilities for selecting and enumerating the Type Libraries installed on the system
-"""
-
-import pythoncom
-import win32api
-import win32con
-
-
-class TypelibSpec:
-    def __init__(self, clsid, lcid, major, minor, flags=0):
-        self.clsid = str(clsid)
-        self.lcid = int(lcid)
-        # We avoid assuming 'major' or 'minor' are integers - when
-        # read from the registry there is some confusion about if
-        # they are base 10 or base 16 (they *should* be base 16, but
-        # how they are written is beyond our control.)
-        self.major = major
-        self.minor = minor
-        self.dll = None
-        self.desc = None
-        self.ver_desc = None
-        self.flags = flags
-
-    # For the SelectList
-    def __getitem__(self, item):
-        if item == 0:
-            return self.ver_desc
-        raise IndexError("Cant index me!")
-
-    def __lt__(self, other):  # rich-cmp/py3k-friendly version
-        me = (
-            (self.ver_desc or "").lower(),
-            (self.desc or "").lower(),
-            self.major,
-            self.minor,
-        )
-        them = (
-            (other.ver_desc or "").lower(),
-            (other.desc or "").lower(),
-            other.major,
-            other.minor,
-        )
-        return me < them
-
-    def __eq__(self, other):  # rich-cmp/py3k-friendly version
-        return (
-            (self.ver_desc or "").lower() == (other.ver_desc or "").lower()
-            and (self.desc or "").lower() == (other.desc or "").lower()
-            and self.major == other.major
-            and self.minor == other.minor
-        )
-
-    def Resolve(self):
-        if self.dll is None:
-            return 0
-        tlb = pythoncom.LoadTypeLib(self.dll)
-        self.FromTypelib(tlb, None)
-        return 1
-
-    def FromTypelib(self, typelib, dllName=None):
-        la = typelib.GetLibAttr()
-        self.clsid = str(la[0])
-        self.lcid = la[1]
-        self.major = la[3]
-        self.minor = la[4]
-        if dllName:
-            self.dll = dllName
-
-
-def EnumKeys(root):
-    index = 0
-    ret = []
-    while 1:
-        try:
-            item = win32api.RegEnumKey(root, index)
-        except win32api.error:
-            break
-        try:
-            # Note this doesn't handle REG_EXPAND_SZ, but the implementation
-            # here doesn't need to - that is handled as the data is read.
-            val = win32api.RegQueryValue(root, item)
-        except win32api.error:
-            val = ""  # code using this assumes a string.
-
-        ret.append((item, val))
-        index = index + 1
-    return ret
-
-
-FLAG_RESTRICTED = 1
-FLAG_CONTROL = 2
-FLAG_HIDDEN = 4
-
-
-def EnumTlbs(excludeFlags=0):
-    """Return a list of TypelibSpec objects, one for each registered library."""
-    key = win32api.RegOpenKey(win32con.HKEY_CLASSES_ROOT, "Typelib")
-    iids = EnumKeys(key)
-    results = []
-    for iid, crap in iids:
-        try:
-            key2 = win32api.RegOpenKey(key, str(iid))
-        except win32api.error:
-            # A few good reasons for this, including "access denied".
-            continue
-        for version, tlbdesc in EnumKeys(key2):
-            major_minor = version.split(".", 1)
-            if len(major_minor) < 2:
-                major_minor.append("0")
-            # For some reason, this code used to assume the values were hex.
-            # This seems to not be true - particularly for CDO 1.21
-            # *sigh* - it appears there are no rules here at all, so when we need
-            # to know the info, we must load the tlb by filename and request it.
-            # The Resolve() method on the TypelibSpec does this.
-            # For this reason, keep the version numbers as strings - that
-            # way we can't be wrong!  Let code that really needs an int to work
-            # out what to do.  FWIW, http://support.microsoft.com/kb/816970 is
-            # pretty clear that they *should* be hex.
-            major = major_minor[0]
-            minor = major_minor[1]
-            key3 = win32api.RegOpenKey(key2, str(version))
-            try:
-                # The "FLAGS" are at this point
-                flags = int(win32api.RegQueryValue(key3, "FLAGS"))
-            except (win32api.error, ValueError):
-                flags = 0
-            if flags & excludeFlags == 0:
-                for lcid, crap in EnumKeys(key3):
-                    try:
-                        lcid = int(lcid)
-                    except ValueError:  # not an LCID entry
-                        continue
-                    # Check for both "{lcid}\win32" and "{lcid}\win64" keys.
-                    try:
-                        key4 = win32api.RegOpenKey(key3, "%s\\win32" % (lcid,))
-                    except win32api.error:
-                        try:
-                            key4 = win32api.RegOpenKey(key3, "%s\\win64" % (lcid,))
-                        except win32api.error:
-                            continue
-                    try:
-                        dll, typ = win32api.RegQueryValueEx(key4, None)
-                        if typ == win32con.REG_EXPAND_SZ:
-                            dll = win32api.ExpandEnvironmentStrings(dll)
-                    except win32api.error:
-                        dll = None
-                    spec = TypelibSpec(iid, lcid, major, minor, flags)
-                    spec.dll = dll
-                    spec.desc = tlbdesc
-                    spec.ver_desc = tlbdesc + " (" + version + ")"
-                    results.append(spec)
-    return results
-
-
-def FindTlbsWithDescription(desc):
-    """Find all installed type libraries with the specified description"""
-    ret = []
-    items = EnumTlbs()
-    for item in items:
-        if item.desc == desc:
-            ret.append(item)
-    return ret
-
-
-def SelectTlb(title="Select Library", excludeFlags=0):
-    """Display a list of all the type libraries, and select one.   Returns None if cancelled"""
-    import pywin.dialogs.list
-
-    items = EnumTlbs(excludeFlags)
-    # fixup versions - we assume hex (see __init__ above)
-    for i in items:
-        i.major = int(i.major, 16)
-        i.minor = int(i.minor, 16)
-    items.sort()
-    rc = pywin.dialogs.list.SelectFromLists(title, items, ["Type Library"])
-    if rc is None:
-        return None
-    return items[rc]
-
-
-# Test code.
-if __name__ == "__main__":
-    print(SelectTlb().__dict__)
diff --git a/lib/win32com/client/tlbrowse.py b/lib/win32com/client/tlbrowse.py
deleted file mode 100644
index acc00281..00000000
--- a/lib/win32com/client/tlbrowse.py
+++ /dev/null
@@ -1,279 +0,0 @@
-import commctrl
-import pythoncom
-import win32api
-import win32con
-import win32ui
-from pywin.mfc import dialog
-
-
-class TLBrowserException(Exception):
-    "TypeLib browser internal error"
-
-
-error = TLBrowserException
-
-FRAMEDLG_STD = win32con.WS_CAPTION | win32con.WS_SYSMENU
-SS_STD = win32con.WS_CHILD | win32con.WS_VISIBLE
-BS_STD = SS_STD | win32con.WS_TABSTOP
-ES_STD = BS_STD | win32con.WS_BORDER
-LBS_STD = (
-    ES_STD | win32con.LBS_NOTIFY | win32con.LBS_NOINTEGRALHEIGHT | win32con.WS_VSCROLL
-)
-CBS_STD = ES_STD | win32con.CBS_NOINTEGRALHEIGHT | win32con.WS_VSCROLL
-
-typekindmap = {
-    pythoncom.TKIND_ENUM: "Enumeration",
-    pythoncom.TKIND_RECORD: "Record",
-    pythoncom.TKIND_MODULE: "Module",
-    pythoncom.TKIND_INTERFACE: "Interface",
-    pythoncom.TKIND_DISPATCH: "Dispatch",
-    pythoncom.TKIND_COCLASS: "CoClass",
-    pythoncom.TKIND_ALIAS: "Alias",
-    pythoncom.TKIND_UNION: "Union",
-}
-
-TypeBrowseDialog_Parent = dialog.Dialog
-
-
-class TypeBrowseDialog(TypeBrowseDialog_Parent):
-    "Browse a type library"
-
-    IDC_TYPELIST = 1000
-    IDC_MEMBERLIST = 1001
-    IDC_PARAMLIST = 1002
-    IDC_LISTVIEW = 1003
-
-    def __init__(self, typefile=None):
-        TypeBrowseDialog_Parent.__init__(self, self.GetTemplate())
-        try:
-            if typefile:
-                self.tlb = pythoncom.LoadTypeLib(typefile)
-            else:
-                self.tlb = None
-        except pythoncom.ole_error:
-            self.MessageBox("The file does not contain type information")
-            self.tlb = None
-        self.HookCommand(self.CmdTypeListbox, self.IDC_TYPELIST)
-        self.HookCommand(self.CmdMemberListbox, self.IDC_MEMBERLIST)
-
-    def OnAttachedObjectDeath(self):
-        self.tlb = None
-        self.typeinfo = None
-        self.attr = None
-        return TypeBrowseDialog_Parent.OnAttachedObjectDeath(self)
-
-    def _SetupMenu(self):
-        menu = win32ui.CreateMenu()
-        flags = win32con.MF_STRING | win32con.MF_ENABLED
-        menu.AppendMenu(flags, win32ui.ID_FILE_OPEN, "&Open...")
-        menu.AppendMenu(flags, win32con.IDCANCEL, "&Close")
-        mainMenu = win32ui.CreateMenu()
-        mainMenu.AppendMenu(flags | win32con.MF_POPUP, menu.GetHandle(), "&File")
-        self.SetMenu(mainMenu)
-        self.HookCommand(self.OnFileOpen, win32ui.ID_FILE_OPEN)
-
-    def OnFileOpen(self, id, code):
-        openFlags = win32con.OFN_OVERWRITEPROMPT | win32con.OFN_FILEMUSTEXIST
-        fspec = "Type Libraries (*.tlb, *.olb)|*.tlb;*.olb|OCX Files (*.ocx)|*.ocx|DLL's (*.dll)|*.dll|All Files (*.*)|*.*||"
-        dlg = win32ui.CreateFileDialog(1, None, None, openFlags, fspec)
-        if dlg.DoModal() == win32con.IDOK:
-            try:
-                self.tlb = pythoncom.LoadTypeLib(dlg.GetPathName())
-            except pythoncom.ole_error:
-                self.MessageBox("The file does not contain type information")
-                self.tlb = None
-            self._SetupTLB()
-
-    def OnInitDialog(self):
-        self._SetupMenu()
-        self.typelb = self.GetDlgItem(self.IDC_TYPELIST)
-        self.memberlb = self.GetDlgItem(self.IDC_MEMBERLIST)
-        self.paramlb = self.GetDlgItem(self.IDC_PARAMLIST)
-        self.listview = self.GetDlgItem(self.IDC_LISTVIEW)
-
-        # Setup the listview columns
-        itemDetails = (commctrl.LVCFMT_LEFT, 100, "Item", 0)
-        self.listview.InsertColumn(0, itemDetails)
-        itemDetails = (commctrl.LVCFMT_LEFT, 1024, "Details", 0)
-        self.listview.InsertColumn(1, itemDetails)
-
-        if self.tlb is None:
-            self.OnFileOpen(None, None)
-        else:
-            self._SetupTLB()
-        return TypeBrowseDialog_Parent.OnInitDialog(self)
-
-    def _SetupTLB(self):
-        self.typelb.ResetContent()
-        self.memberlb.ResetContent()
-        self.paramlb.ResetContent()
-        self.typeinfo = None
-        self.attr = None
-        if self.tlb is None:
-            return
-        n = self.tlb.GetTypeInfoCount()
-        for i in range(n):
-            self.typelb.AddString(self.tlb.GetDocumentation(i)[0])
-
-    def _SetListviewTextItems(self, items):
-        self.listview.DeleteAllItems()
-        index = -1
-        for item in items:
-            index = self.listview.InsertItem(index + 1, item[0])
-            data = item[1]
-            if data is None:
-                data = ""
-            self.listview.SetItemText(index, 1, data)
-
-    def SetupAllInfoTypes(self):
-        infos = self._GetMainInfoTypes() + self._GetMethodInfoTypes()
-        self._SetListviewTextItems(infos)
-
-    def _GetMainInfoTypes(self):
-        pos = self.typelb.GetCurSel()
-        if pos < 0:
-            return []
-        docinfo = self.tlb.GetDocumentation(pos)
-        infos = [("GUID", str(self.attr[0]))]
-        infos.append(("Help File", docinfo[3]))
-        infos.append(("Help Context", str(docinfo[2])))
-        try:
-            infos.append(("Type Kind", typekindmap[self.tlb.GetTypeInfoType(pos)]))
-        except:
-            pass
-
-        info = self.tlb.GetTypeInfo(pos)
-        attr = info.GetTypeAttr()
-        infos.append(("Attributes", str(attr)))
-
-        for j in range(attr[8]):
-            flags = info.GetImplTypeFlags(j)
-            refInfo = info.GetRefTypeInfo(info.GetRefTypeOfImplType(j))
-            doc = refInfo.GetDocumentation(-1)
-            attr = refInfo.GetTypeAttr()
-            typeKind = attr[5]
-            typeFlags = attr[11]
-
-            desc = doc[0]
-            desc = desc + ", Flags=0x%x, typeKind=0x%x, typeFlags=0x%x" % (
-                flags,
-                typeKind,
-                typeFlags,
-            )
-            if flags & pythoncom.IMPLTYPEFLAG_FSOURCE:
-                desc = desc + "(Source)"
-            infos.append(("Implements", desc))
-
-        return infos
-
-    def _GetMethodInfoTypes(self):
-        pos = self.memberlb.GetCurSel()
-        if pos < 0:
-            return []
-
-        realPos, isMethod = self._GetRealMemberPos(pos)
-        ret = []
-        if isMethod:
-            funcDesc = self.typeinfo.GetFuncDesc(realPos)
-            id = funcDesc[0]
-            ret.append(("Func Desc", str(funcDesc)))
-        else:
-            id = self.typeinfo.GetVarDesc(realPos)[0]
-
-        docinfo = self.typeinfo.GetDocumentation(id)
-        ret.append(("Help String", docinfo[1]))
-        ret.append(("Help Context", str(docinfo[2])))
-        return ret
-
-    def CmdTypeListbox(self, id, code):
-        if code == win32con.LBN_SELCHANGE:
-            pos = self.typelb.GetCurSel()
-            if pos >= 0:
-                self.memberlb.ResetContent()
-                self.typeinfo = self.tlb.GetTypeInfo(pos)
-                self.attr = self.typeinfo.GetTypeAttr()
-                for i in range(self.attr[7]):
-                    id = self.typeinfo.GetVarDesc(i)[0]
-                    self.memberlb.AddString(self.typeinfo.GetNames(id)[0])
-                for i in range(self.attr[6]):
-                    id = self.typeinfo.GetFuncDesc(i)[0]
-                    self.memberlb.AddString(self.typeinfo.GetNames(id)[0])
-                self.SetupAllInfoTypes()
-            return 1
-
-    def _GetRealMemberPos(self, pos):
-        pos = self.memberlb.GetCurSel()
-        if pos >= self.attr[7]:
-            return pos - self.attr[7], 1
-        elif pos >= 0:
-            return pos, 0
-        else:
-            raise error("The position is not valid")
-
-    def CmdMemberListbox(self, id, code):
-        if code == win32con.LBN_SELCHANGE:
-            self.paramlb.ResetContent()
-            pos = self.memberlb.GetCurSel()
-            realPos, isMethod = self._GetRealMemberPos(pos)
-            if isMethod:
-                id = self.typeinfo.GetFuncDesc(realPos)[0]
-                names = self.typeinfo.GetNames(id)
-                for i in range(len(names)):
-                    if i > 0:
-                        self.paramlb.AddString(names[i])
-            self.SetupAllInfoTypes()
-            return 1
-
-    def GetTemplate(self):
-        "Return the template used to create this dialog"
-
-        w = 272  # Dialog width
-        h = 192  # Dialog height
-        style = (
-            FRAMEDLG_STD
-            | win32con.WS_VISIBLE
-            | win32con.DS_SETFONT
-            | win32con.WS_MINIMIZEBOX
-        )
-        template = [
-            ["Type Library Browser", (0, 0, w, h), style, None, (8, "Helv")],
-        ]
-        template.append([130, "&Type", -1, (10, 10, 62, 9), SS_STD | win32con.SS_LEFT])
-        template.append([131, None, self.IDC_TYPELIST, (10, 20, 80, 80), LBS_STD])
-        template.append(
-            [130, "&Members", -1, (100, 10, 62, 9), SS_STD | win32con.SS_LEFT]
-        )
-        template.append([131, None, self.IDC_MEMBERLIST, (100, 20, 80, 80), LBS_STD])
-        template.append(
-            [130, "&Parameters", -1, (190, 10, 62, 9), SS_STD | win32con.SS_LEFT]
-        )
-        template.append([131, None, self.IDC_PARAMLIST, (190, 20, 75, 80), LBS_STD])
-
-        lvStyle = (
-            SS_STD
-            | commctrl.LVS_REPORT
-            | commctrl.LVS_AUTOARRANGE
-            | commctrl.LVS_ALIGNLEFT
-            | win32con.WS_BORDER
-            | win32con.WS_TABSTOP
-        )
-        template.append(
-            ["SysListView32", "", self.IDC_LISTVIEW, (10, 110, 255, 65), lvStyle]
-        )
-
-        return template
-
-
-if __name__ == "__main__":
-    import sys
-
-    fname = None
-    try:
-        fname = sys.argv[1]
-    except:
-        pass
-    dlg = TypeBrowseDialog(fname)
-    if win32api.GetConsoleTitle():  # empty string w/o console
-        dlg.DoModal()
-    else:
-        dlg.CreateWindow(win32ui.GetMainFrame())
diff --git a/lib/win32com/client/util.py b/lib/win32com/client/util.py
deleted file mode 100644
index c5762951..00000000
--- a/lib/win32com/client/util.py
+++ /dev/null
@@ -1,102 +0,0 @@
-"""General client side utilities.
-
-This module contains utility functions, used primarily by advanced COM
-programmers, or other COM modules.
-"""
-import pythoncom
-from win32com.client import Dispatch, _get_good_object_
-
-PyIDispatchType = pythoncom.TypeIIDs[pythoncom.IID_IDispatch]
-
-
-def WrapEnum(ob, resultCLSID=None):
-    """Wrap an object in a VARIANT enumerator.
-
-    All VT_DISPATCHs returned by the enumerator are converted to wrapper objects
-    (which may be either a class instance, or a dynamic.Dispatch type object).
-
-    """
-    if type(ob) != pythoncom.TypeIIDs[pythoncom.IID_IEnumVARIANT]:
-        ob = ob.QueryInterface(pythoncom.IID_IEnumVARIANT)
-    return EnumVARIANT(ob, resultCLSID)
-
-
-class Enumerator:
-    """A class that provides indexed access into an Enumerator
-
-    By wrapping a PyIEnum* object in this class, you can perform
-    natural looping and indexing into the Enumerator.
-
-    Looping is very efficient, but it should be noted that although random
-    access is supported, the underlying object is still an enumerator, so
-    this will force many reset-and-seek operations to find the requested index.
-
-    """
-
-    def __init__(self, enum):
-        self._oleobj_ = enum  # a PyIEnumVARIANT
-        self.index = -1
-
-    def __getitem__(self, index):
-        return self.__GetIndex(index)
-
-    def __call__(self, index):
-        return self.__GetIndex(index)
-
-    def __GetIndex(self, index):
-        if type(index) != type(0):
-            raise TypeError("Only integer indexes are supported for enumerators")
-        # NOTE
-        # In this context, self.index is users purely as a flag to say
-        # "am I still in sequence".  The user may call Next() or Reset() if they
-        # so choose, in which case self.index will not be correct (although we
-        # still want to stay in sequence)
-        if index != self.index + 1:
-            # Index requested out of sequence.
-            self._oleobj_.Reset()
-            if index:
-                self._oleobj_.Skip(
-                    index
-                )  # if asked for item 1, must skip 1, Python always zero based.
-        self.index = index
-        result = self._oleobj_.Next(1)
-        if len(result):
-            return self._make_retval_(result[0])
-        raise IndexError("list index out of range")
-
-    def Next(self, count=1):
-        ret = self._oleobj_.Next(count)
-        realRets = []
-        for r in ret:
-            realRets.append(self._make_retval_(r))
-        return tuple(realRets)  # Convert back to tuple.
-
-    def Reset(self):
-        return self._oleobj_.Reset()
-
-    def Clone(self):
-        return self.__class__(self._oleobj_.Clone(), self.resultCLSID)
-
-    def _make_retval_(self, result):
-        return result
-
-
-class EnumVARIANT(Enumerator):
-    def __init__(self, enum, resultCLSID=None):
-        self.resultCLSID = resultCLSID
-        Enumerator.__init__(self, enum)
-
-    def _make_retval_(self, result):
-        return _get_good_object_(result, resultCLSID=self.resultCLSID)
-
-
-class Iterator:
-    def __init__(self, enum, resultCLSID=None):
-        self.resultCLSID = resultCLSID
-        self._iter_ = iter(enum.QueryInterface(pythoncom.IID_IEnumVARIANT))
-
-    def __iter__(self):
-        return self
-
-    def __next__(self):
-        return _get_good_object_(next(self._iter_), resultCLSID=self.resultCLSID)
diff --git a/lib/win32com/demos/__init__.py b/lib/win32com/demos/__init__.py
deleted file mode 100644
index e69de29b..00000000
diff --git a/lib/win32com/demos/connect.py b/lib/win32com/demos/connect.py
deleted file mode 100644
index ed7f51c9..00000000
--- a/lib/win32com/demos/connect.py
+++ /dev/null
@@ -1,100 +0,0 @@
-# Implements _both_ a connectable client, and a connectable server.
-#
-# Note that we cheat just a little - the Server in this demo is not created
-# via Normal COM - this means we can avoid registering the server.
-# However, the server _is_ accessed as a COM object - just the creation
-# is cheated on - so this is still working as a fully-fledged server.
-
-import pythoncom
-import win32com.server.connect
-import win32com.server.util
-from pywin32_testutil import str2bytes
-from win32com.server.exception import Exception
-
-# This is the IID of the Events interface both Client and Server support.
-IID_IConnectDemoEvents = pythoncom.MakeIID("{A4988850-49C3-11d0-AE5D-52342E000000}")
-
-# The server which implements
-# Create a connectable class, that has a single public method
-# 'DoIt', which echos to a single sink 'DoneIt'
-
-
-class ConnectableServer(win32com.server.connect.ConnectableServer):
-    _public_methods_ = [
-        "DoIt"
-    ] + win32com.server.connect.ConnectableServer._public_methods_
-    _connect_interfaces_ = [IID_IConnectDemoEvents]
-
-    # The single public method that the client can call on us
-    # (ie, as a normal COM server, this exposes just this single method.
-    def DoIt(self, arg):
-        # Simply broadcast a notification.
-        self._BroadcastNotify(self.NotifyDoneIt, (arg,))
-
-    def NotifyDoneIt(self, interface, arg):
-        interface.Invoke(1000, 0, pythoncom.DISPATCH_METHOD, 1, arg)
-
-
-# Here is the client side of the connection world.
-# Define a COM object which implements the methods defined by the
-# IConnectDemoEvents interface.
-class ConnectableClient:
-    # This is another cheat - I _know_ the server defines the "DoneIt" event
-    # as DISPID==1000 - I also know from the implementation details of COM
-    # that the first method in _public_methods_ gets 1000.
-    # Normally some explicit DISPID->Method mapping is required.
-    _public_methods_ = ["OnDoneIt"]
-
-    def __init__(self):
-        self.last_event_arg = None
-
-    # A client must implement QI, and respond to a query for the Event interface.
-    # In addition, it must provide a COM object (which server.util.wrap) does.
-    def _query_interface_(self, iid):
-        import win32com.server.util
-
-        # Note that this seems like a necessary hack.  I am responding to IID_IConnectDemoEvents
-        # but only creating an IDispatch gateway object.
-        if iid == IID_IConnectDemoEvents:
-            return win32com.server.util.wrap(self)
-
-    # And here is our event method which gets called.
-    def OnDoneIt(self, arg):
-        self.last_event_arg = arg
-
-
-def CheckEvent(server, client, val, verbose):
-    client.last_event_arg = None
-    server.DoIt(val)
-    if client.last_event_arg != val:
-        raise RuntimeError("Sent %r, but got back %r" % (val, client.last_event_arg))
-    if verbose:
-        print("Sent and received %r" % val)
-
-
-# A simple test script for all this.
-# In the real world, it is likely that the code controlling the server
-# will be in the same class as that getting the notifications.
-def test(verbose=0):
-    import win32com.client.connect
-    import win32com.client.dynamic
-    import win32com.server.policy
-
-    server = win32com.client.dynamic.Dispatch(
-        win32com.server.util.wrap(ConnectableServer())
-    )
-    connection = win32com.client.connect.SimpleConnection()
-    client = ConnectableClient()
-    connection.Connect(server, client, IID_IConnectDemoEvents)
-    CheckEvent(server, client, "Hello", verbose)
-    CheckEvent(server, client, str2bytes("Here is a null>\x00<"), verbose)
-    CheckEvent(server, client, "Here is a null>\x00<", verbose)
-    val = "test-\xe0\xf2"  # 2 extended characters.
-    CheckEvent(server, client, val, verbose)
-    if verbose:
-        print("Everything seemed to work!")
-    # Aggressive memory leak checking (ie, do nothing!) :-)  All should cleanup OK???
-
-
-if __name__ == "__main__":
-    test(1)
diff --git a/lib/win32com/demos/dump_clipboard.py b/lib/win32com/demos/dump_clipboard.py
deleted file mode 100644
index 534d540a..00000000
--- a/lib/win32com/demos/dump_clipboard.py
+++ /dev/null
@@ -1,74 +0,0 @@
-import pythoncom
-import win32con
-
-formats = """CF_TEXT CF_BITMAP CF_METAFILEPICT CF_SYLK CF_DIF CF_TIFF
-            CF_OEMTEXT CF_DIB CF_PALETTE CF_PENDATA CF_RIFF CF_WAVE
-            CF_UNICODETEXT CF_ENHMETAFILE CF_HDROP CF_LOCALE CF_MAX
-            CF_OWNERDISPLAY CF_DSPTEXT CF_DSPBITMAP CF_DSPMETAFILEPICT
-            CF_DSPENHMETAFILE""".split()
-format_name_map = {}
-for f in formats:
-    val = getattr(win32con, f)
-    format_name_map[val] = f
-
-tymeds = [attr for attr in pythoncom.__dict__.keys() if attr.startswith("TYMED_")]
-
-
-def DumpClipboard():
-    do = pythoncom.OleGetClipboard()
-    print("Dumping all clipboard formats...")
-    for fe in do.EnumFormatEtc():
-        fmt, td, aspect, index, tymed = fe
-        tymeds_this = [
-            getattr(pythoncom, t) for t in tymeds if tymed & getattr(pythoncom, t)
-        ]
-        print("Clipboard format", format_name_map.get(fmt, str(fmt)))
-        for t_this in tymeds_this:
-            # As we are enumerating there should be no need to call
-            # QueryGetData, but we do anyway!
-            fetc_query = fmt, td, aspect, index, t_this
-            try:
-                do.QueryGetData(fetc_query)
-            except pythoncom.com_error:
-                print("Eeek - QGD indicated failure for tymed", t_this)
-            # now actually get it.
-            try:
-                medium = do.GetData(fetc_query)
-            except pythoncom.com_error as exc:
-                print("Failed to get the clipboard data:", exc)
-                continue
-            if medium.tymed == pythoncom.TYMED_GDI:
-                data = "GDI handle %d" % medium.data
-            elif medium.tymed == pythoncom.TYMED_MFPICT:
-                data = "METAFILE handle %d" % medium.data
-            elif medium.tymed == pythoncom.TYMED_ENHMF:
-                data = "ENHMETAFILE handle %d" % medium.data
-            elif medium.tymed == pythoncom.TYMED_HGLOBAL:
-                data = "%d bytes via HGLOBAL" % len(medium.data)
-            elif medium.tymed == pythoncom.TYMED_FILE:
-                data = "filename '%s'" % data
-            elif medium.tymed == pythoncom.TYMED_ISTREAM:
-                stream = medium.data
-                stream.Seek(0, 0)
-                bytes = 0
-                while 1:
-                    chunk = stream.Read(4096)
-                    if not chunk:
-                        break
-                    bytes += len(chunk)
-                data = "%d bytes via IStream" % bytes
-            elif medium.tymed == pythoncom.TYMED_ISTORAGE:
-                data = "a IStorage"
-            else:
-                data = "*** unknown tymed!"
-            print(" -> got", data)
-    do = None
-
-
-if __name__ == "__main__":
-    DumpClipboard()
-    if pythoncom._GetInterfaceCount() + pythoncom._GetGatewayCount():
-        print(
-            "XXX - Leaving with %d/%d COM objects alive"
-            % (pythoncom._GetInterfaceCount(), pythoncom._GetGatewayCount())
-        )
diff --git a/lib/win32com/demos/eventsApartmentThreaded.py b/lib/win32com/demos/eventsApartmentThreaded.py
deleted file mode 100644
index ae8e70fa..00000000
--- a/lib/win32com/demos/eventsApartmentThreaded.py
+++ /dev/null
@@ -1,98 +0,0 @@
-# A sample originally provided by Richard Bell, and modified by Mark Hammond.
-
-# This sample demonstrates how to use COM events in an aparment-threaded
-# world.  In this world, COM itself ensures that all calls to and events
-# from an object happen on the same thread that created the object, even
-# if they originated from different threads.  For this cross-thread
-# marshalling to work, this main thread *must* run a "message-loop" (ie,
-# a loop fetching and dispatching Windows messages).  Without such message
-# processing, dead-locks can occur.
-
-# See also eventsFreeThreaded.py for how to do this in a free-threaded
-# world where these marshalling considerations do not exist.
-
-# NOTE: This example uses Internet Explorer, but it should not be considerd
-# a "best-practices" for writing against IE events, but for working with
-# events in general. For example:
-# * The first OnDocumentComplete event is not a reliable indicator that the
-#   URL has completed loading
-# * As we are demonstrating the most efficient way of handling events, when
-#   running this sample you will see an IE Windows briefly appear, but
-#   vanish without ever being repainted.
-
-import time
-
-# sys.coinit_flags not set, so pythoncom initializes apartment-threaded.
-import pythoncom
-import win32api
-import win32com.client
-import win32event
-
-
-class ExplorerEvents:
-    def __init__(self):
-        self.event = win32event.CreateEvent(None, 0, 0, None)
-
-    def OnDocumentComplete(self, pDisp=pythoncom.Empty, URL=pythoncom.Empty):
-        thread = win32api.GetCurrentThreadId()
-        print("OnDocumentComplete event processed on thread %d" % thread)
-        # Set the event our main thread is waiting on.
-        win32event.SetEvent(self.event)
-
-    def OnQuit(self):
-        thread = win32api.GetCurrentThreadId()
-        print("OnQuit event processed on thread %d" % thread)
-        win32event.SetEvent(self.event)
-
-
-def WaitWhileProcessingMessages(event, timeout=2):
-    start = time.perf_counter()
-    while True:
-        # Wake 4 times a second - we can't just specify the
-        # full timeout here, as then it would reset for every
-        # message we process.
-        rc = win32event.MsgWaitForMultipleObjects(
-            (event,), 0, 250, win32event.QS_ALLEVENTS
-        )
-        if rc == win32event.WAIT_OBJECT_0:
-            # event signalled - stop now!
-            return True
-        if (time.perf_counter() - start) > timeout:
-            # Timeout expired.
-            return False
-        # must be a message.
-        pythoncom.PumpWaitingMessages()
-
-
-def TestExplorerEvents():
-    iexplore = win32com.client.DispatchWithEvents(
-        "InternetExplorer.Application", ExplorerEvents
-    )
-
-    thread = win32api.GetCurrentThreadId()
-    print("TestExplorerEvents created IE object on thread %d" % thread)
-
-    iexplore.Visible = 1
-    try:
-        iexplore.Navigate(win32api.GetFullPathName("..\\readme.html"))
-    except pythoncom.com_error as details:
-        print("Warning - could not open the test HTML file", details)
-
-    # Wait for the event to be signalled while pumping messages.
-    if not WaitWhileProcessingMessages(iexplore.event):
-        print("Document load event FAILED to fire!!!")
-
-    iexplore.Quit()
-    #
-    # Give IE a chance to shutdown, else it can get upset on fast machines.
-    # Note, Quit generates events.  Although this test does NOT catch them
-    # it is NECESSARY to pump messages here instead of a sleep so that the Quit
-    # happens properly!
-    if not WaitWhileProcessingMessages(iexplore.event):
-        print("OnQuit event FAILED to fire!!!")
-
-    iexplore = None
-
-
-if __name__ == "__main__":
-    TestExplorerEvents()
diff --git a/lib/win32com/demos/eventsFreeThreaded.py b/lib/win32com/demos/eventsFreeThreaded.py
deleted file mode 100644
index 2fc04d82..00000000
--- a/lib/win32com/demos/eventsFreeThreaded.py
+++ /dev/null
@@ -1,92 +0,0 @@
-# A sample originally provided by Richard Bell, and modified by Mark Hammond.
-
-# This sample demonstrates how to use COM events in a free-threaded world.
-# In this world, there is no need to marshall calls across threads, so
-# no message loops are needed at all.  This means regular cross-thread
-# sychronization can be used.  In this sample we just wait on win32 event
-# objects.
-
-# See also ieEventsApartmentThreaded.py for how to do this in an
-# aparment-threaded world, where thread-marshalling complicates things.
-
-# NOTE: This example uses Internet Explorer, but it should not be considerd
-# a "best-practices" for writing against IE events, but for working with
-# events in general. For example:
-# * The first OnDocumentComplete event is not a reliable indicator that the
-#   URL has completed loading
-# * As we are demonstrating the most efficient way of handling events, when
-#   running this sample you will see an IE Windows briefly appear, but
-#   vanish without ever being repainted.
-
-import sys
-
-sys.coinit_flags = 0  # specify free threading
-
-
-import pythoncom
-import win32api
-import win32com.client
-import win32event
-
-
-# The print statements indicate that COM has actually started another thread
-# and will deliver the events to that thread (ie, the events do not actually
-# fire on our main thread.
-class ExplorerEvents:
-    def __init__(self):
-        # We reuse this event for all events.
-        self.event = win32event.CreateEvent(None, 0, 0, None)
-
-    def OnDocumentComplete(self, pDisp=pythoncom.Empty, URL=pythoncom.Empty):
-        #
-        # Caution:  Since the main thread and events thread(s) are different
-        # it may be necessary to serialize access to shared data.  Because
-        # this is a simple test case, that is not required here.  Your
-        # situation may be different.   Caveat programmer.
-        #
-        thread = win32api.GetCurrentThreadId()
-        print("OnDocumentComplete event processed on thread %d" % thread)
-        # Set the event our main thread is waiting on.
-        win32event.SetEvent(self.event)
-
-    def OnQuit(self):
-        thread = win32api.GetCurrentThreadId()
-        print("OnQuit event processed on thread %d" % thread)
-        win32event.SetEvent(self.event)
-
-
-def TestExplorerEvents():
-    iexplore = win32com.client.DispatchWithEvents(
-        "InternetExplorer.Application", ExplorerEvents
-    )
-
-    thread = win32api.GetCurrentThreadId()
-    print("TestExplorerEvents created IE object on thread %d" % thread)
-
-    iexplore.Visible = 1
-    try:
-        iexplore.Navigate(win32api.GetFullPathName("..\\readme.html"))
-    except pythoncom.com_error as details:
-        print("Warning - could not open the test HTML file", details)
-
-    # In this free-threaded example, we can simply wait until an event has
-    # been set - we will give it 2 seconds before giving up.
-    rc = win32event.WaitForSingleObject(iexplore.event, 2000)
-    if rc != win32event.WAIT_OBJECT_0:
-        print("Document load event FAILED to fire!!!")
-
-    iexplore.Quit()
-    # Now we can do the same thing to wait for exit!
-    # Although Quit generates events, in this free-threaded world we
-    # do *not* need to run any message pumps.
-
-    rc = win32event.WaitForSingleObject(iexplore.event, 2000)
-    if rc != win32event.WAIT_OBJECT_0:
-        print("OnQuit event FAILED to fire!!!")
-
-    iexplore = None
-    print("Finished the IE event sample!")
-
-
-if __name__ == "__main__":
-    TestExplorerEvents()
diff --git a/lib/win32com/demos/excelAddin.py b/lib/win32com/demos/excelAddin.py
deleted file mode 100644
index 96f6cff8..00000000
--- a/lib/win32com/demos/excelAddin.py
+++ /dev/null
@@ -1,170 +0,0 @@
-# A demo plugin for Microsoft Excel
-#
-# This addin simply adds a new button to the main Excel toolbar,
-# and displays a message box when clicked.  Thus, it demonstrates
-# how to plug in to Excel itself, and hook Excel events.
-#
-#
-# To register the addin, simply execute:
-#   excelAddin.py
-# This will install the COM server, and write the necessary
-# AddIn key to Excel
-#
-# To unregister completely:
-#   excelAddin.py --unregister
-#
-# To debug, execute:
-#   excelAddin.py --debug
-#
-# Then open Pythonwin, and select "Tools->Trace Collector Debugging Tool"
-# Restart excel, and you should see some output generated.
-#
-# NOTE: If the AddIn fails with an error, Excel will re-register
-# the addin to not automatically load next time Excel starts.  To
-# correct this, simply re-register the addin (see above)
-#
-# Author <ekoome@yahoo.com> Eric Koome
-# Copyright (c) 2003 Wavecom Inc.  All rights reserved
-#
-# Redistribution and use in source and binary forms, with or without
-# modification, are permitted provided that the following conditions
-# are met:
-#
-# 1. Redistributions of source code must retain the above copyright
-#    notice, this list of conditions and the following disclaimer.
-#
-# THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
-# WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
-# OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
-# DISCLAIMED.  IN NO EVENT SHALL ERIC KOOME OR
-# ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
-# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
-# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
-# USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
-# ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
-# OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
-# OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
-# SUCH DAMAGE.
-
-import sys
-
-import pythoncom
-from win32com import universal
-from win32com.client import Dispatch, DispatchWithEvents, constants, gencache
-from win32com.server.exception import COMException
-
-# Support for COM objects we use.
-gencache.EnsureModule(
-    "{00020813-0000-0000-C000-000000000046}", 0, 1, 3, bForDemand=True
-)  # Excel 9
-gencache.EnsureModule(
-    "{2DF8D04C-5BFA-101B-BDE5-00AA0044DE52}", 0, 2, 1, bForDemand=True
-)  # Office 9
-
-# The TLB defining the interfaces we implement
-universal.RegisterInterfaces(
-    "{AC0714F2-3D04-11D1-AE7D-00A0C90F26F4}", 0, 1, 0, ["_IDTExtensibility2"]
-)
-
-
-class ButtonEvent:
-    def OnClick(self, button, cancel):
-        import win32con  # Possible, but not necessary, to use a Pythonwin GUI
-        import win32ui
-
-        win32ui.MessageBox("Hello from Python", "Python Test", win32con.MB_OKCANCEL)
-        return cancel
-
-
-class ExcelAddin:
-    _com_interfaces_ = ["_IDTExtensibility2"]
-    _public_methods_ = []
-    _reg_clsctx_ = pythoncom.CLSCTX_INPROC_SERVER
-    _reg_clsid_ = "{C5482ECA-F559-45A0-B078-B2036E6F011A}"
-    _reg_progid_ = "Python.Test.ExcelAddin"
-    _reg_policy_spec_ = "win32com.server.policy.EventHandlerPolicy"
-
-    def __init__(self):
-        self.appHostApp = None
-
-    def OnConnection(self, application, connectMode, addin, custom):
-        print("OnConnection", application, connectMode, addin, custom)
-        try:
-            self.appHostApp = application
-            cbcMyBar = self.appHostApp.CommandBars.Add(
-                Name="PythonBar",
-                Position=constants.msoBarTop,
-                MenuBar=constants.msoBarTypeNormal,
-                Temporary=True,
-            )
-            btnMyButton = cbcMyBar.Controls.Add(
-                Type=constants.msoControlButton, Parameter="Greetings"
-            )
-            btnMyButton = self.toolbarButton = DispatchWithEvents(
-                btnMyButton, ButtonEvent
-            )
-            btnMyButton.Style = constants.msoButtonCaption
-            btnMyButton.BeginGroup = True
-            btnMyButton.Caption = "&Python"
-            btnMyButton.TooltipText = "Python rules the World"
-            btnMyButton.Width = "34"
-            cbcMyBar.Visible = True
-        except pythoncom.com_error as xxx_todo_changeme:
-            (hr, msg, exc, arg) = xxx_todo_changeme.args
-            print("The Excel call failed with code %d: %s" % (hr, msg))
-            if exc is None:
-                print("There is no extended error information")
-            else:
-                wcode, source, text, helpFile, helpId, scode = exc
-                print("The source of the error is", source)
-                print("The error message is", text)
-                print("More info can be found in %s (id=%d)" % (helpFile, helpId))
-
-    def OnDisconnection(self, mode, custom):
-        print("OnDisconnection")
-        self.appHostApp.CommandBars("PythonBar").Delete
-        self.appHostApp = None
-
-    def OnAddInsUpdate(self, custom):
-        print("OnAddInsUpdate", custom)
-
-    def OnStartupComplete(self, custom):
-        print("OnStartupComplete", custom)
-
-    def OnBeginShutdown(self, custom):
-        print("OnBeginShutdown", custom)
-
-
-def RegisterAddin(klass):
-    import winreg
-
-    key = winreg.CreateKey(
-        winreg.HKEY_CURRENT_USER, "Software\\Microsoft\\Office\\Excel\\Addins"
-    )
-    subkey = winreg.CreateKey(key, klass._reg_progid_)
-    winreg.SetValueEx(subkey, "CommandLineSafe", 0, winreg.REG_DWORD, 0)
-    winreg.SetValueEx(subkey, "LoadBehavior", 0, winreg.REG_DWORD, 3)
-    winreg.SetValueEx(subkey, "Description", 0, winreg.REG_SZ, "Excel Addin")
-    winreg.SetValueEx(subkey, "FriendlyName", 0, winreg.REG_SZ, "A Simple Excel Addin")
-
-
-def UnregisterAddin(klass):
-    import winreg
-
-    try:
-        winreg.DeleteKey(
-            winreg.HKEY_CURRENT_USER,
-            "Software\\Microsoft\\Office\\Excel\\Addins\\" + klass._reg_progid_,
-        )
-    except WindowsError:
-        pass
-
-
-if __name__ == "__main__":
-    import win32com.server.register
-
-    win32com.server.register.UseCommandLine(ExcelAddin)
-    if "--unregister" in sys.argv:
-        UnregisterAddin(ExcelAddin)
-    else:
-        RegisterAddin(ExcelAddin)
diff --git a/lib/win32com/demos/excelRTDServer.py b/lib/win32com/demos/excelRTDServer.py
deleted file mode 100644
index c50e1ac7..00000000
--- a/lib/win32com/demos/excelRTDServer.py
+++ /dev/null
@@ -1,434 +0,0 @@
-"""Excel IRTDServer implementation.
-
-This module is a functional example of how to implement the IRTDServer interface
-in python, using the pywin32 extensions. Further details, about this interface
-and it can be found at:
-     http://msdn.microsoft.com/library/default.asp?url=/library/en-us/dnexcl2k2/html/odc_xlrtdfaq.asp
-"""
-
-# Copyright (c) 2003-2004 by Chris Nilsson <chris@slort.org>
-#
-# By obtaining, using, and/or copying this software and/or its
-# associated documentation, you agree that you have read, understood,
-# and will comply with the following terms and conditions:
-#
-# Permission to use, copy, modify, and distribute this software and
-# its associated documentation for any purpose and without fee is
-# hereby granted, provided that the above copyright notice appears in
-# all copies, and that both that copyright notice and this permission
-# notice appear in supporting documentation, and that the name of
-# Christopher Nilsson (the author) not be used in advertising or publicity
-# pertaining to distribution of the software without specific, written
-# prior permission.
-#
-# THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD
-# TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANT-
-# ABILITY AND FITNESS.  IN NO EVENT SHALL THE AUTHOR
-# BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY
-# DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
-# WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS
-# ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
-# OF THIS SOFTWARE.
-
-import datetime  # For the example classes...
-import threading
-
-import pythoncom
-import win32com.client
-from win32com import universal
-from win32com.client import gencache
-from win32com.server.exception import COMException
-
-# Typelib info for version 10 - aka Excel XP.
-# This is the minimum version of excel that we can work with as this is when
-# Microsoft introduced these interfaces.
-EXCEL_TLB_GUID = "{00020813-0000-0000-C000-000000000046}"
-EXCEL_TLB_LCID = 0
-EXCEL_TLB_MAJOR = 1
-EXCEL_TLB_MINOR = 4
-
-# Import the excel typelib to make sure we've got early-binding going on.
-# The "ByRef" parameters we use later won't work without this.
-gencache.EnsureModule(EXCEL_TLB_GUID, EXCEL_TLB_LCID, EXCEL_TLB_MAJOR, EXCEL_TLB_MINOR)
-
-# Tell pywin to import these extra interfaces.
-# --
-# QUESTION: Why? The interfaces seem to descend from IDispatch, so
-# I'd have thought, for example, calling callback.UpdateNotify() (on the
-# IRTDUpdateEvent callback excel gives us) would work without molestation.
-# But the callback needs to be cast to a "real" IRTDUpdateEvent type. Hmm...
-# This is where my small knowledge of the pywin framework / COM gets hazy.
-# --
-# Again, we feed in the Excel typelib as the source of these interfaces.
-universal.RegisterInterfaces(
-    EXCEL_TLB_GUID,
-    EXCEL_TLB_LCID,
-    EXCEL_TLB_MAJOR,
-    EXCEL_TLB_MINOR,
-    ["IRtdServer", "IRTDUpdateEvent"],
-)
-
-
-class ExcelRTDServer(object):
-    """Base RTDServer class.
-
-    Provides most of the features needed to implement the IRtdServer interface.
-    Manages topic adding, removal, and packing up the values for excel.
-
-    Shouldn't be instanciated directly.
-
-    Instead, descendant classes should override the CreateTopic() method.
-    Topic objects only need to provide a GetValue() function to play nice here.
-    The values given need to be atomic (eg. string, int, float... etc).
-
-    Also note: nothing has been done within this class to ensure that we get
-    time to check our topics for updates. I've left that up to the subclass
-    since the ways, and needs, of refreshing your topics will vary greatly. For
-    example, the sample implementation uses a timer thread to wake itself up.
-    Whichever way you choose to do it, your class needs to be able to wake up
-    occaisionally, since excel will never call your class without being asked to
-    first.
-
-    Excel will communicate with our object in this order:
-      1. Excel instanciates our object and calls ServerStart, providing us with
-         an IRTDUpdateEvent callback object.
-      2. Excel calls ConnectData when it wants to subscribe to a new "topic".
-      3. When we have new data to provide, we call the UpdateNotify method of the
-         callback object we were given.
-      4. Excel calls our RefreshData method, and receives a 2d SafeArray (row-major)
-         containing the Topic ids in the 1st dim, and the topic values in the
-         2nd dim.
-      5. When not needed anymore, Excel will call our DisconnectData to
-         unsubscribe from a topic.
-      6. When there are no more topics left, Excel will call our ServerTerminate
-         method to kill us.
-
-    Throughout, at undetermined periods, Excel will call our Heartbeat
-    method to see if we're still alive. It must return a non-zero value, or
-    we'll be killed.
-
-    NOTE: By default, excel will at most call RefreshData once every 2 seconds.
-          This is a setting that needs to be changed excel-side. To change this,
-          you can set the throttle interval like this in the excel VBA object model:
-            Application.RTD.ThrottleInterval = 1000 ' milliseconds
-    """
-
-    _com_interfaces_ = ["IRtdServer"]
-    _public_methods_ = [
-        "ConnectData",
-        "DisconnectData",
-        "Heartbeat",
-        "RefreshData",
-        "ServerStart",
-        "ServerTerminate",
-    ]
-    _reg_clsctx_ = pythoncom.CLSCTX_INPROC_SERVER
-    # _reg_clsid_ = "# subclass must provide this class attribute"
-    # _reg_desc_ = "# subclass should provide this description"
-    # _reg_progid_ = "# subclass must provide this class attribute"
-
-    ALIVE = 1
-    NOT_ALIVE = 0
-
-    def __init__(self):
-        """Constructor"""
-        super(ExcelRTDServer, self).__init__()
-        self.IsAlive = self.ALIVE
-        self.__callback = None
-        self.topics = {}
-
-    def SignalExcel(self):
-        """Use the callback we were given to tell excel new data is available."""
-        if self.__callback is None:
-            raise COMException(desc="Callback excel provided is Null")
-        self.__callback.UpdateNotify()
-
-    def ConnectData(self, TopicID, Strings, GetNewValues):
-        """Creates a new topic out of the Strings excel gives us."""
-        try:
-            self.topics[TopicID] = self.CreateTopic(Strings)
-        except Exception as why:
-            raise COMException(desc=str(why))
-        GetNewValues = True
-        result = self.topics[TopicID]
-        if result is None:
-            result = "# %s: Waiting for update" % self.__class__.__name__
-        else:
-            result = result.GetValue()
-
-        # fire out internal event...
-        self.OnConnectData(TopicID)
-
-        # GetNewValues as per interface is ByRef, so we need to pass it back too.
-        return result, GetNewValues
-
-    def DisconnectData(self, TopicID):
-        """Deletes the given topic."""
-        self.OnDisconnectData(TopicID)
-
-        if TopicID in self.topics:
-            self.topics[TopicID] = None
-            del self.topics[TopicID]
-
-    def Heartbeat(self):
-        """Called by excel to see if we're still here."""
-        return self.IsAlive
-
-    def RefreshData(self, TopicCount):
-        """Packs up the topic values. Called by excel when it's ready for an update.
-
-        Needs to:
-          * Return the current number of topics, via the "ByRef" TopicCount
-          * Return a 2d SafeArray of the topic data.
-            - 1st dim: topic numbers
-            - 2nd dim: topic values
-
-        We could do some caching, instead of repacking everytime...
-        But this works for demonstration purposes."""
-        TopicCount = len(self.topics)
-        self.OnRefreshData()
-
-        # Grow the lists, so we don't need a heap of calls to append()
-        results = [[None] * TopicCount, [None] * TopicCount]
-
-        # Excel expects a 2-dimensional array. The first dim contains the
-        # topic numbers, and the second contains the values for the topics.
-        # In true VBA style (yuck), we need to pack the array in row-major format,
-        # which looks like:
-        #   ( (topic_num1, topic_num2, ..., topic_numN), \
-        #     (topic_val1, topic_val2, ..., topic_valN) )
-        for idx, topicdata in enumerate(self.topics.items()):
-            topicNum, topic = topicdata
-            results[0][idx] = topicNum
-            results[1][idx] = topic.GetValue()
-
-        # TopicCount is meant to be passed to us ByRef, so return it as well, as per
-        # the way pywin32 handles ByRef arguments.
-        return tuple(results), TopicCount
-
-    def ServerStart(self, CallbackObject):
-        """Excel has just created us... We take its callback for later, and set up shop."""
-        self.IsAlive = self.ALIVE
-
-        if CallbackObject is None:
-            raise COMException(desc="Excel did not provide a callback")
-
-        # Need to "cast" the raw PyIDispatch object to the IRTDUpdateEvent interface
-        IRTDUpdateEventKlass = win32com.client.CLSIDToClass.GetClass(
-            "{A43788C1-D91B-11D3-8F39-00C04F3651B8}"
-        )
-        self.__callback = IRTDUpdateEventKlass(CallbackObject)
-
-        self.OnServerStart()
-
-        return self.IsAlive
-
-    def ServerTerminate(self):
-        """Called when excel no longer wants us."""
-        self.IsAlive = self.NOT_ALIVE  # On next heartbeat, excel will free us
-        self.OnServerTerminate()
-
-    def CreateTopic(self, TopicStrings=None):
-        """Topic factory method. Subclass must override.
-
-        Topic objects need to provide:
-          * GetValue() method which returns an atomic value.
-
-        Will raise NotImplemented if not overridden.
-        """
-        raise NotImplemented("Subclass must implement")
-
-    # Overridable class events...
-    def OnConnectData(self, TopicID):
-        """Called when a new topic has been created, at excel's request."""
-        pass
-
-    def OnDisconnectData(self, TopicID):
-        """Called when a topic is about to be deleted, at excel's request."""
-        pass
-
-    def OnRefreshData(self):
-        """Called when excel has requested all current topic data."""
-        pass
-
-    def OnServerStart(self):
-        """Called when excel has instanciated us."""
-        pass
-
-    def OnServerTerminate(self):
-        """Called when excel is about to destroy us."""
-        pass
-
-
-class RTDTopic(object):
-    """Base RTD Topic.
-    Only method required by our RTDServer implementation is GetValue().
-    The others are more for convenience."""
-
-    def __init__(self, TopicStrings):
-        super(RTDTopic, self).__init__()
-        self.TopicStrings = TopicStrings
-        self.__currentValue = None
-        self.__dirty = False
-
-    def Update(self, sender):
-        """Called by the RTD Server.
-        Gives us a chance to check if our topic data needs to be
-        changed (eg. check a file, quiz a database, etc)."""
-        raise NotImplemented("subclass must implement")
-
-    def Reset(self):
-        """Call when this topic isn't considered "dirty" anymore."""
-        self.__dirty = False
-
-    def GetValue(self):
-        return self.__currentValue
-
-    def SetValue(self, value):
-        self.__dirty = True
-        self.__currentValue = value
-
-    def HasChanged(self):
-        return self.__dirty
-
-
-# -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
-
-######################################
-# Example classes
-######################################
-
-
-class TimeServer(ExcelRTDServer):
-    """Example Time RTD server.
-
-    Sends time updates back to excel.
-
-    example of use, in an excel sheet:
-      =RTD("Python.RTD.TimeServer","","seconds","5")
-
-    This will cause a timestamp string to fill the cell, and update its value
-    every 5 seconds (or as close as possible depending on how busy excel is).
-
-    The empty string parameter denotes the com server is running on the local
-    machine. Otherwise, put in the hostname to look on. For more info
-    on this, lookup the Excel help for its "RTD" worksheet function.
-
-    Obviously, you'd want to wrap this kind of thing in a friendlier VBA
-    function.
-
-    Also, remember that the RTD function accepts a maximum of 28 arguments!
-    If you want to pass more, you may need to concatenate arguments into one
-    string, and have your topic parse them appropriately.
-    """
-
-    # win32com.server setup attributes...
-    # Never copy the _reg_clsid_ value in your own classes!
-    _reg_clsid_ = "{EA7F2CF1-11A2-45E4-B2D5-68E240DB8CB1}"
-    _reg_progid_ = "Python.RTD.TimeServer"
-    _reg_desc_ = "Python class implementing Excel IRTDServer -- feeds time"
-
-    # other class attributes...
-    INTERVAL = 0.5  # secs. Threaded timer will wake us up at this interval.
-
-    def __init__(self):
-        super(TimeServer, self).__init__()
-
-        # Simply timer thread to ensure we get to update our topics, and
-        # tell excel about any changes. This is a pretty basic and dirty way to
-        # do this. Ideally, there should be some sort of waitable (eg. either win32
-        # event, socket data event...) and be kicked off by that event triggering.
-        # As soon as we set up shop here, we _must_ return control back to excel.
-        # (ie. we can't block and do our own thing...)
-        self.ticker = threading.Timer(self.INTERVAL, self.Update)
-
-    def OnServerStart(self):
-        self.ticker.start()
-
-    def OnServerTerminate(self):
-        if not self.ticker.finished.isSet():
-            self.ticker.cancel()  # Cancel our wake-up thread. Excel has killed us.
-
-    def Update(self):
-        # Get our wake-up thread ready...
-        self.ticker = threading.Timer(self.INTERVAL, self.Update)
-        try:
-            # Check if any of our topics have new info to pass on
-            if len(self.topics):
-                refresh = False
-                for topic in self.topics.values():
-                    topic.Update(self)
-                    if topic.HasChanged():
-                        refresh = True
-                    topic.Reset()
-
-                if refresh:
-                    self.SignalExcel()
-        finally:
-            self.ticker.start()  # Make sure we get to run again
-
-    def CreateTopic(self, TopicStrings=None):
-        """Topic factory. Builds a TimeTopic object out of the given TopicStrings."""
-        return TimeTopic(TopicStrings)
-
-
-class TimeTopic(RTDTopic):
-    """Example topic for example RTD server.
-
-    Will accept some simple commands to alter how long to delay value updates.
-
-    Commands:
-      * seconds, delay_in_seconds
-      * minutes, delay_in_minutes
-      * hours, delay_in_hours
-    """
-
-    def __init__(self, TopicStrings):
-        super(TimeTopic, self).__init__(TopicStrings)
-        try:
-            self.cmd, self.delay = self.TopicStrings
-        except Exception as E:
-            # We could simply return a "# ERROR" type string as the
-            # topic value, but explosions like this should be able to get handled by
-            # the VBA-side "On Error" stuff.
-            raise ValueError("Invalid topic strings: %s" % str(TopicStrings))
-
-        # self.cmd = str(self.cmd)
-        self.delay = float(self.delay)
-
-        # setup our initial value
-        self.checkpoint = self.timestamp()
-        self.SetValue(str(self.checkpoint))
-
-    def timestamp(self):
-        return datetime.datetime.now()
-
-    def Update(self, sender):
-        now = self.timestamp()
-        delta = now - self.checkpoint
-        refresh = False
-        if self.cmd == "seconds":
-            if delta.seconds >= self.delay:
-                refresh = True
-        elif self.cmd == "minutes":
-            if delta.minutes >= self.delay:
-                refresh = True
-        elif self.cmd == "hours":
-            if delta.hours >= self.delay:
-                refresh = True
-        else:
-            self.SetValue("#Unknown command: " + self.cmd)
-
-        if refresh:
-            self.SetValue(str(now))
-            self.checkpoint = now
-
-
-if __name__ == "__main__":
-    import win32com.server.register
-
-    # Register/Unregister TimeServer example
-    # eg. at the command line: excelrtd.py --register
-    # Then type in an excel cell something like:
-    # =RTD("Python.RTD.TimeServer","","seconds","5")
-    win32com.server.register.UseCommandLine(TimeServer)
diff --git a/lib/win32com/demos/iebutton.py b/lib/win32com/demos/iebutton.py
deleted file mode 100644
index bc3ce99b..00000000
--- a/lib/win32com/demos/iebutton.py
+++ /dev/null
@@ -1,217 +0,0 @@
-# -*- coding: latin-1 -*-
-
-# PyWin32 Internet Explorer Button
-#
-# written by Leonard Ritter (paniq@gmx.net)
-# and Robert F�rtsch (info@robert-foertsch.com)
-
-
-"""
-This sample implements a simple IE Button COM server
-with access to the IWebBrowser2 interface.
-
-To demonstrate:
-* Execute this script to register the server.
-* Open Pythonwin's Tools -> Trace Collector Debugging Tool, so you can
-  see the output of 'print' statements in this demo.
-* Open a new IE instance.  The toolbar should have a new "scissors" icon,
-  with tooltip text "IE Button" - this is our new button - click it.
-* Switch back to the Pythonwin window - you should see:
-   IOleCommandTarget::Exec called.
-  This is the button being clicked.  Extending this to do something more
-  useful is left as an exercise.
-
-Contribtions to this sample to make it a little "friendlier" welcome!
-"""
-
-# imports section
-
-import pythoncom
-import win32api
-import win32com
-import win32com.server.register
-from win32com import universal
-from win32com.client import Dispatch, DispatchWithEvents, constants, gencache, getevents
-
-# This demo uses 'print' - use win32traceutil to see it if we have no
-# console.
-try:
-    win32api.GetConsoleTitle()
-except win32api.error:
-    import win32traceutil
-
-import array
-
-from win32com.axcontrol import axcontrol
-
-# ensure we know the ms internet controls typelib so we have access to IWebBrowser2 later on
-win32com.client.gencache.EnsureModule("{EAB22AC0-30C1-11CF-A7EB-0000C05BAE0B}", 0, 1, 1)
-
-
-#
-IObjectWithSite_methods = ["SetSite", "GetSite"]
-IOleCommandTarget_methods = ["Exec", "QueryStatus"]
-
-_iebutton_methods_ = IOleCommandTarget_methods + IObjectWithSite_methods
-_iebutton_com_interfaces_ = [
-    axcontrol.IID_IOleCommandTarget,
-    axcontrol.IID_IObjectWithSite,  # IObjectWithSite
-]
-
-
-class Stub:
-    """
-    this class serves as a method stub,
-    outputting debug info whenever the object
-    is being called.
-    """
-
-    def __init__(self, name):
-        self.name = name
-
-    def __call__(self, *args):
-        print("STUB: ", self.name, args)
-
-
-class IEButton:
-    """
-    The actual COM server class
-    """
-
-    _com_interfaces_ = _iebutton_com_interfaces_
-    _public_methods_ = _iebutton_methods_
-    _reg_clsctx_ = pythoncom.CLSCTX_INPROC_SERVER
-    _button_text_ = "IE Button"
-    _tool_tip_ = "An example implementation for an IE Button."
-    _icon_ = ""
-    _hot_icon_ = ""
-
-    def __init__(self):
-        # put stubs for non-implemented methods
-        for method in self._public_methods_:
-            if not hasattr(self, method):
-                print("providing default stub for %s" % method)
-                setattr(self, method, Stub(method))
-
-    def QueryStatus(self, pguidCmdGroup, prgCmds, cmdtextf):
-        # 'cmdtextf' is the 'cmdtextf' element from the OLECMDTEXT structure,
-        # or None if a NULL pointer was passed.
-        result = []
-        for id, flags in prgCmds:
-            flags |= axcontrol.OLECMDF_SUPPORTED | axcontrol.OLECMDF_ENABLED
-            result.append((id, flags))
-        if cmdtextf is None:
-            cmdtext = None  # must return None if nothing requested.
-        # IE never seems to want any text - this code is here for
-        # demo purposes only
-        elif cmdtextf == axcontrol.OLECMDTEXTF_NAME:
-            cmdtext = "IEButton Name"
-        else:
-            cmdtext = "IEButton State"
-        return result, cmdtext
-
-    def Exec(self, pguidCmdGroup, nCmdID, nCmdExecOpt, pvaIn):
-        print(pguidCmdGroup, nCmdID, nCmdExecOpt, pvaIn)
-        print("IOleCommandTarget::Exec called.")
-        # self.webbrowser.ShowBrowserBar(GUID_IETOOLBAR, not is_ietoolbar_visible())
-
-    def SetSite(self, unknown):
-        if unknown:
-            # first get a command target
-            cmdtarget = unknown.QueryInterface(axcontrol.IID_IOleCommandTarget)
-            # then travel over to a service provider
-            serviceprovider = cmdtarget.QueryInterface(pythoncom.IID_IServiceProvider)
-            # finally ask for the internet explorer application, returned as a dispatch object
-            self.webbrowser = win32com.client.Dispatch(
-                serviceprovider.QueryService(
-                    "{0002DF05-0000-0000-C000-000000000046}", pythoncom.IID_IDispatch
-                )
-            )
-        else:
-            # lose all references
-            self.webbrowser = None
-
-    def GetClassID(self):
-        return self._reg_clsid_
-
-
-def register(classobj):
-    import winreg
-
-    subKeyCLSID = (
-        "SOFTWARE\\Microsoft\\Internet Explorer\\Extensions\\%38s"
-        % classobj._reg_clsid_
-    )
-    try:
-        hKey = winreg.CreateKey(winreg.HKEY_LOCAL_MACHINE, subKeyCLSID)
-        subKey = winreg.SetValueEx(
-            hKey, "ButtonText", 0, winreg.REG_SZ, classobj._button_text_
-        )
-        winreg.SetValueEx(
-            hKey, "ClsidExtension", 0, winreg.REG_SZ, classobj._reg_clsid_
-        )  # reg value for calling COM object
-        winreg.SetValueEx(
-            hKey, "CLSID", 0, winreg.REG_SZ, "{1FBA04EE-3024-11D2-8F1F-0000F87ABD16}"
-        )  # CLSID for button that sends command to COM object
-        winreg.SetValueEx(hKey, "Default Visible", 0, winreg.REG_SZ, "Yes")
-        winreg.SetValueEx(hKey, "ToolTip", 0, winreg.REG_SZ, classobj._tool_tip_)
-        winreg.SetValueEx(hKey, "Icon", 0, winreg.REG_SZ, classobj._icon_)
-        winreg.SetValueEx(hKey, "HotIcon", 0, winreg.REG_SZ, classobj._hot_icon_)
-    except WindowsError:
-        print("Couldn't set standard toolbar reg keys.")
-    else:
-        print("Set standard toolbar reg keys.")
-
-
-def unregister(classobj):
-    import winreg
-
-    subKeyCLSID = (
-        "SOFTWARE\\Microsoft\\Internet Explorer\\Extensions\\%38s"
-        % classobj._reg_clsid_
-    )
-    try:
-        hKey = winreg.CreateKey(winreg.HKEY_LOCAL_MACHINE, subKeyCLSID)
-        subKey = winreg.DeleteValue(hKey, "ButtonText")
-        winreg.DeleteValue(hKey, "ClsidExtension")  # for calling COM object
-        winreg.DeleteValue(hKey, "CLSID")
-        winreg.DeleteValue(hKey, "Default Visible")
-        winreg.DeleteValue(hKey, "ToolTip")
-        winreg.DeleteValue(hKey, "Icon")
-        winreg.DeleteValue(hKey, "HotIcon")
-        winreg.DeleteKey(winreg.HKEY_LOCAL_MACHINE, subKeyCLSID)
-    except WindowsError:
-        print("Couldn't delete Standard toolbar regkey.")
-    else:
-        print("Deleted Standard toolbar regkey.")
-
-
-#
-# test implementation
-#
-
-
-class PyWin32InternetExplorerButton(IEButton):
-    _reg_clsid_ = "{104B66A9-9E68-49D1-A3F5-94754BE9E0E6}"
-    _reg_progid_ = "PyWin32.IEButton"
-    _reg_desc_ = "Test Button"
-    _button_text_ = "IE Button"
-    _tool_tip_ = "An example implementation for an IE Button."
-    _icon_ = ""
-    _hot_icon_ = _icon_
-
-
-def DllRegisterServer():
-    register(PyWin32InternetExplorerButton)
-
-
-def DllUnregisterServer():
-    unregister(PyWin32InternetExplorerButton)
-
-
-if __name__ == "__main__":
-    win32com.server.register.UseCommandLine(
-        PyWin32InternetExplorerButton,
-        finalize_register=DllRegisterServer,
-        finalize_unregister=DllUnregisterServer,
-    )
diff --git a/lib/win32com/demos/ietoolbar.py b/lib/win32com/demos/ietoolbar.py
deleted file mode 100644
index 084db3c1..00000000
--- a/lib/win32com/demos/ietoolbar.py
+++ /dev/null
@@ -1,376 +0,0 @@
-# -*- coding: latin-1 -*-
-
-# PyWin32 Internet Explorer Toolbar
-#
-# written by Leonard Ritter (paniq@gmx.net)
-# and Robert F�rtsch (info@robert-foertsch.com)
-
-
-"""
-This sample implements a simple IE Toolbar COM server
-supporting Windows XP styles and access to
-the IWebBrowser2 interface.
-
-It also demonstrates how to hijack the parent window
-to catch WM_COMMAND messages.
-"""
-
-# imports section
-import sys
-import winreg
-
-import pythoncom
-import win32com
-from win32com import universal
-from win32com.axcontrol import axcontrol
-from win32com.client import Dispatch, DispatchWithEvents, constants, gencache, getevents
-from win32com.shell import shell
-from win32com.shell.shellcon import *
-
-try:
-    # try to get styles (winxp)
-    import winxpgui as win32gui
-except:
-    # import default module (win2k and lower)
-    import win32gui
-
-import array
-import struct
-
-import commctrl
-import win32con
-import win32ui
-
-# ensure we know the ms internet controls typelib so we have access to IWebBrowser2 later on
-win32com.client.gencache.EnsureModule("{EAB22AC0-30C1-11CF-A7EB-0000C05BAE0B}", 0, 1, 1)
-
-#
-IDeskBand_methods = ["GetBandInfo"]
-IDockingWindow_methods = ["ShowDW", "CloseDW", "ResizeBorderDW"]
-IOleWindow_methods = ["GetWindow", "ContextSensitiveHelp"]
-IInputObject_methods = ["UIActivateIO", "HasFocusIO", "TranslateAcceleratorIO"]
-IObjectWithSite_methods = ["SetSite", "GetSite"]
-IPersistStream_methods = ["GetClassID", "IsDirty", "Load", "Save", "GetSizeMax"]
-
-_ietoolbar_methods_ = (
-    IDeskBand_methods
-    + IDockingWindow_methods
-    + IOleWindow_methods
-    + IInputObject_methods
-    + IObjectWithSite_methods
-    + IPersistStream_methods
-)
-_ietoolbar_com_interfaces_ = [
-    shell.IID_IDeskBand,  # IDeskBand
-    axcontrol.IID_IObjectWithSite,  # IObjectWithSite
-    pythoncom.IID_IPersistStream,
-    axcontrol.IID_IOleCommandTarget,
-]
-
-
-class WIN32STRUCT:
-    def __init__(self, **kw):
-        full_fmt = ""
-        for name, fmt, default in self._struct_items_:
-            self.__dict__[name] = None
-            if fmt == "z":
-                full_fmt += "pi"
-            else:
-                full_fmt += fmt
-        for name, val in kw.items():
-            self.__dict__[name] = val
-
-    def __setattr__(self, attr, val):
-        if not attr.startswith("_") and attr not in self.__dict__:
-            raise AttributeError(attr)
-        self.__dict__[attr] = val
-
-    def toparam(self):
-        self._buffs = []
-        full_fmt = ""
-        vals = []
-        for name, fmt, default in self._struct_items_:
-            val = self.__dict__[name]
-            if fmt == "z":
-                fmt = "Pi"
-                if val is None:
-                    vals.append(0)
-                    vals.append(0)
-                else:
-                    str_buf = array.array("c", val + "\0")
-                    vals.append(str_buf.buffer_info()[0])
-                    vals.append(len(val))
-                    self._buffs.append(str_buf)  # keep alive during the call.
-            else:
-                if val is None:
-                    val = default
-                vals.append(val)
-            full_fmt += fmt
-        return struct.pack(*(full_fmt,) + tuple(vals))
-
-
-class TBBUTTON(WIN32STRUCT):
-    _struct_items_ = [
-        ("iBitmap", "i", 0),
-        ("idCommand", "i", 0),
-        ("fsState", "B", 0),
-        ("fsStyle", "B", 0),
-        ("bReserved", "H", 0),
-        ("dwData", "I", 0),
-        ("iString", "z", None),
-    ]
-
-
-class Stub:
-    """
-    this class serves as a method stub,
-    outputting debug info whenever the object
-    is being called.
-    """
-
-    def __init__(self, name):
-        self.name = name
-
-    def __call__(self, *args):
-        print("STUB: ", self.name, args)
-
-
-class IEToolbarCtrl:
-    """
-    a tiny wrapper for our winapi-based
-    toolbar control implementation.
-    """
-
-    def __init__(self, hwndparent):
-        styles = (
-            win32con.WS_CHILD
-            | win32con.WS_VISIBLE
-            | win32con.WS_CLIPSIBLINGS
-            | win32con.WS_CLIPCHILDREN
-            | commctrl.TBSTYLE_LIST
-            | commctrl.TBSTYLE_FLAT
-            | commctrl.TBSTYLE_TRANSPARENT
-            | commctrl.CCS_TOP
-            | commctrl.CCS_NODIVIDER
-            | commctrl.CCS_NORESIZE
-            | commctrl.CCS_NOPARENTALIGN
-        )
-        self.hwnd = win32gui.CreateWindow(
-            "ToolbarWindow32",
-            None,
-            styles,
-            0,
-            0,
-            100,
-            100,
-            hwndparent,
-            0,
-            win32gui.dllhandle,
-            None,
-        )
-        win32gui.SendMessage(self.hwnd, commctrl.TB_BUTTONSTRUCTSIZE, 20, 0)
-
-    def ShowWindow(self, mode):
-        win32gui.ShowWindow(self.hwnd, mode)
-
-    def AddButtons(self, *buttons):
-        tbbuttons = ""
-        for button in buttons:
-            tbbuttons += button.toparam()
-        return win32gui.SendMessage(
-            self.hwnd, commctrl.TB_ADDBUTTONS, len(buttons), tbbuttons
-        )
-
-    def GetSafeHwnd(self):
-        return self.hwnd
-
-
-class IEToolbar:
-    """
-    The actual COM server class
-    """
-
-    _com_interfaces_ = _ietoolbar_com_interfaces_
-    _public_methods_ = _ietoolbar_methods_
-    _reg_clsctx_ = pythoncom.CLSCTX_INPROC_SERVER
-    # if you copy and modify this example, be sure to change the clsid below
-    _reg_clsid_ = "{F21202A2-959A-4149-B1C3-68B9013F3335}"
-    _reg_progid_ = "PyWin32.IEToolbar"
-    _reg_desc_ = "PyWin32 IE Toolbar"
-
-    def __init__(self):
-        # put stubs for non-implemented methods
-        for method in self._public_methods_:
-            if not hasattr(self, method):
-                print("providing default stub for %s" % method)
-                setattr(self, method, Stub(method))
-
-    def GetWindow(self):
-        return self.toolbar.GetSafeHwnd()
-
-    def Load(self, stream):
-        # called when the toolbar is loaded
-        pass
-
-    def Save(self, pStream, fClearDirty):
-        # called when the toolbar shall save its information
-        pass
-
-    def CloseDW(self, dwReserved):
-        del self.toolbar
-
-    def ShowDW(self, bShow):
-        if bShow:
-            self.toolbar.ShowWindow(win32con.SW_SHOW)
-        else:
-            self.toolbar.ShowWindow(win32con.SW_HIDE)
-
-    def on_first_button(self):
-        print("first!")
-        self.webbrowser.Navigate2("http://starship.python.net/crew/mhammond/")
-
-    def on_second_button(self):
-        print("second!")
-
-    def on_third_button(self):
-        print("third!")
-
-    def toolbar_command_handler(self, args):
-        hwnd, message, wparam, lparam, time, point = args
-        if lparam == self.toolbar.GetSafeHwnd():
-            self._command_map[wparam]()
-
-    def SetSite(self, unknown):
-        if unknown:
-            # retrieve the parent window interface for this site
-            olewindow = unknown.QueryInterface(pythoncom.IID_IOleWindow)
-            # ask the window for its handle
-            hwndparent = olewindow.GetWindow()
-
-            # first get a command target
-            cmdtarget = unknown.QueryInterface(axcontrol.IID_IOleCommandTarget)
-            # then travel over to a service provider
-            serviceprovider = cmdtarget.QueryInterface(pythoncom.IID_IServiceProvider)
-            # finally ask for the internet explorer application, returned as a dispatch object
-            self.webbrowser = win32com.client.Dispatch(
-                serviceprovider.QueryService(
-                    "{0002DF05-0000-0000-C000-000000000046}", pythoncom.IID_IDispatch
-                )
-            )
-
-            # now create and set up the toolbar
-            self.toolbar = IEToolbarCtrl(hwndparent)
-
-            buttons = [
-                ("Visit PyWin32 Homepage", self.on_first_button),
-                ("Another Button", self.on_second_button),
-                ("Yet Another Button", self.on_third_button),
-            ]
-
-            self._command_map = {}
-            # wrap our parent window so we can hook message handlers
-            window = win32ui.CreateWindowFromHandle(hwndparent)
-
-            # add the buttons
-            for i in range(len(buttons)):
-                button = TBBUTTON()
-                name, func = buttons[i]
-                id = 0x4444 + i
-                button.iBitmap = -2
-                button.idCommand = id
-                button.fsState = commctrl.TBSTATE_ENABLED
-                button.fsStyle = commctrl.TBSTYLE_BUTTON
-                button.iString = name
-                self._command_map[0x4444 + i] = func
-                self.toolbar.AddButtons(button)
-                window.HookMessage(self.toolbar_command_handler, win32con.WM_COMMAND)
-        else:
-            # lose all references
-            self.webbrowser = None
-
-    def GetClassID(self):
-        return self._reg_clsid_
-
-    def GetBandInfo(self, dwBandId, dwViewMode, dwMask):
-        ptMinSize = (0, 24)
-        ptMaxSize = (2000, 24)
-        ptIntegral = (0, 0)
-        ptActual = (2000, 24)
-        wszTitle = "PyWin32 IE Toolbar"
-        dwModeFlags = DBIMF_VARIABLEHEIGHT
-        crBkgnd = 0
-        return (
-            ptMinSize,
-            ptMaxSize,
-            ptIntegral,
-            ptActual,
-            wszTitle,
-            dwModeFlags,
-            crBkgnd,
-        )
-
-
-# used for HKLM install
-def DllInstall(bInstall, cmdLine):
-    comclass = IEToolbar
-
-
-# register plugin
-def DllRegisterServer():
-    comclass = IEToolbar
-
-    # register toolbar with IE
-    try:
-        print("Trying to register Toolbar.\n")
-        hkey = winreg.CreateKey(
-            winreg.HKEY_LOCAL_MACHINE, "SOFTWARE\\Microsoft\\Internet Explorer\\Toolbar"
-        )
-        subKey = winreg.SetValueEx(
-            hkey, comclass._reg_clsid_, 0, winreg.REG_BINARY, "\0"
-        )
-    except WindowsError:
-        print(
-            "Couldn't set registry value.\nhkey: %d\tCLSID: %s\n"
-            % (hkey, comclass._reg_clsid_)
-        )
-    else:
-        print(
-            "Set registry value.\nhkey: %d\tCLSID: %s\n" % (hkey, comclass._reg_clsid_)
-        )
-    # TODO: implement reg settings for standard toolbar button
-
-
-# unregister plugin
-def DllUnregisterServer():
-    comclass = IEToolbar
-
-    # unregister toolbar from internet explorer
-    try:
-        print("Trying to unregister Toolbar.\n")
-        hkey = winreg.CreateKey(
-            winreg.HKEY_LOCAL_MACHINE, "SOFTWARE\\Microsoft\\Internet Explorer\\Toolbar"
-        )
-        winreg.DeleteValue(hkey, comclass._reg_clsid_)
-    except WindowsError:
-        print(
-            "Couldn't delete registry value.\nhkey: %d\tCLSID: %s\n"
-            % (hkey, comclass._reg_clsid_)
-        )
-    else:
-        print("Deleting reg key succeeded.\n")
-
-
-# entry point
-if __name__ == "__main__":
-    import win32com.server.register
-
-    win32com.server.register.UseCommandLine(IEToolbar)
-
-    # parse actual command line option
-    if "--unregister" in sys.argv:
-        DllUnregisterServer()
-    else:
-        DllRegisterServer()
-else:
-    # import trace utility for remote debugging
-    import win32traceutil
diff --git a/lib/win32com/demos/outlookAddin.py b/lib/win32com/demos/outlookAddin.py
deleted file mode 100644
index 9433596d..00000000
--- a/lib/win32com/demos/outlookAddin.py
+++ /dev/null
@@ -1,138 +0,0 @@
-# A demo plugin for Microsoft Outlook (NOT Outlook Express)
-#
-# This addin simply adds a new button to the main Outlook toolbar,
-# and displays a message box when clicked.  Thus, it demonstrates
-# how to plug in to Outlook itself, and hook outlook events.
-#
-# Additionally, each time a new message arrives in the Inbox, a message
-# is printed with the subject of the message.
-#
-# To register the addin, simply execute:
-#   outlookAddin.py
-# This will install the COM server, and write the necessary
-# AddIn key to Outlook
-#
-# To unregister completely:
-#   outlookAddin.py --unregister
-#
-# To debug, execute:
-#   outlookAddin.py --debug
-#
-# Then open Pythonwin, and select "Tools->Trace Collector Debugging Tool"
-# Restart Outlook, and you should see some output generated.
-#
-# NOTE: If the AddIn fails with an error, Outlook will re-register
-# the addin to not automatically load next time Outlook starts.  To
-# correct this, simply re-register the addin (see above)
-
-import sys
-
-import pythoncom
-from win32com import universal
-from win32com.client import DispatchWithEvents, constants, gencache
-from win32com.server.exception import COMException
-
-# Support for COM objects we use.
-gencache.EnsureModule(
-    "{00062FFF-0000-0000-C000-000000000046}", 0, 9, 0, bForDemand=True
-)  # Outlook 9
-gencache.EnsureModule(
-    "{2DF8D04C-5BFA-101B-BDE5-00AA0044DE52}", 0, 2, 1, bForDemand=True
-)  # Office 9
-
-# The TLB defining the interfaces we implement
-universal.RegisterInterfaces(
-    "{AC0714F2-3D04-11D1-AE7D-00A0C90F26F4}", 0, 1, 0, ["_IDTExtensibility2"]
-)
-
-
-class ButtonEvent:
-    def OnClick(self, button, cancel):
-        import win32ui  # Possible, but not necessary, to use a Pythonwin GUI
-
-        win32ui.MessageBox("Hello from Python")
-        return cancel
-
-
-class FolderEvent:
-    def OnItemAdd(self, item):
-        try:
-            print("An item was added to the inbox with subject:", item.Subject)
-        except AttributeError:
-            print(
-                "An item was added to the inbox, but it has no subject! - ", repr(item)
-            )
-
-
-class OutlookAddin:
-    _com_interfaces_ = ["_IDTExtensibility2"]
-    _public_methods_ = []
-    _reg_clsctx_ = pythoncom.CLSCTX_INPROC_SERVER
-    _reg_clsid_ = "{0F47D9F3-598B-4d24-B7E3-92AC15ED27E2}"
-    _reg_progid_ = "Python.Test.OutlookAddin"
-    _reg_policy_spec_ = "win32com.server.policy.EventHandlerPolicy"
-
-    def OnConnection(self, application, connectMode, addin, custom):
-        print("OnConnection", application, connectMode, addin, custom)
-        # ActiveExplorer may be none when started without a UI (eg, WinCE synchronisation)
-        activeExplorer = application.ActiveExplorer()
-        if activeExplorer is not None:
-            bars = activeExplorer.CommandBars
-            toolbar = bars.Item("Standard")
-            item = toolbar.Controls.Add(Type=constants.msoControlButton, Temporary=True)
-            # Hook events for the item
-            item = self.toolbarButton = DispatchWithEvents(item, ButtonEvent)
-            item.Caption = "Python"
-            item.TooltipText = "Click for Python"
-            item.Enabled = True
-
-        # And now, for the sake of demonstration, setup a hook for all new messages
-        inbox = application.Session.GetDefaultFolder(constants.olFolderInbox)
-        self.inboxItems = DispatchWithEvents(inbox.Items, FolderEvent)
-
-    def OnDisconnection(self, mode, custom):
-        print("OnDisconnection")
-
-    def OnAddInsUpdate(self, custom):
-        print("OnAddInsUpdate", custom)
-
-    def OnStartupComplete(self, custom):
-        print("OnStartupComplete", custom)
-
-    def OnBeginShutdown(self, custom):
-        print("OnBeginShutdown", custom)
-
-
-def RegisterAddin(klass):
-    import winreg
-
-    key = winreg.CreateKey(
-        winreg.HKEY_CURRENT_USER, "Software\\Microsoft\\Office\\Outlook\\Addins"
-    )
-    subkey = winreg.CreateKey(key, klass._reg_progid_)
-    winreg.SetValueEx(subkey, "CommandLineSafe", 0, winreg.REG_DWORD, 0)
-    winreg.SetValueEx(subkey, "LoadBehavior", 0, winreg.REG_DWORD, 3)
-    winreg.SetValueEx(subkey, "Description", 0, winreg.REG_SZ, klass._reg_progid_)
-    winreg.SetValueEx(subkey, "FriendlyName", 0, winreg.REG_SZ, klass._reg_progid_)
-
-
-def UnregisterAddin(klass):
-    import winreg
-
-    try:
-        winreg.DeleteKey(
-            winreg.HKEY_CURRENT_USER,
-            "Software\\Microsoft\\Office\\Outlook\\Addins\\" + klass._reg_progid_,
-        )
-    except WindowsError:
-        pass
-
-
-if __name__ == "__main__":
-    import win32com.server.register
-
-    win32com.server.register.UseCommandLine(OutlookAddin)
-    if "--unregister" in sys.argv:
-        UnregisterAddin(OutlookAddin)
-    else:
-        RegisterAddin(OutlookAddin)
diff --git a/lib/win32com/demos/trybag.py b/lib/win32com/demos/trybag.py
deleted file mode 100644
index 3d3918b6..00000000
--- a/lib/win32com/demos/trybag.py
+++ /dev/null
@@ -1,77 +0,0 @@
-import pythoncom
-from win32com.server import exception, util
-
-VT_EMPTY = pythoncom.VT_EMPTY
-
-
-class Bag:
-    _public_methods_ = ["Read", "Write"]
-    _com_interfaces_ = [pythoncom.IID_IPropertyBag]
-
-    def __init__(self):
-        self.data = {}
-
-    def Read(self, propName, varType, errorLog):
-        print("read: name=", propName, "type=", varType)
-        if propName not in self.data:
-            if errorLog:
-                hr = 0x80070057
-                exc = pythoncom.com_error(0, "Bag.Read", "no such item", None, 0, hr)
-                errorLog.AddError(propName, exc)
-            raise exception.Exception(scode=hr)
-        return self.data[propName]
-
-    def Write(self, propName, value):
-        print("write: name=", propName, "value=", value)
-        self.data[propName] = value
-
-
-class Target:
-    _public_methods_ = ["GetClassID", "InitNew", "Load", "Save"]
-    _com_interfaces_ = [pythoncom.IID_IPersist, pythoncom.IID_IPersistPropertyBag]
-
-    def GetClassID(self):
-        raise exception.Exception(scode=0x80004005)  # E_FAIL
-
-    def InitNew(self):
-        pass
-
-    def Load(self, bag, log):
-        print(bag.Read("prop1", VT_EMPTY, log))
-        print(bag.Read("prop2", VT_EMPTY, log))
-        try:
-            print(bag.Read("prop3", VT_EMPTY, log))
-        except exception.Exception:
-            pass
-
-    def Save(self, bag, clearDirty, saveAllProps):
-        bag.Write("prop1", "prop1.hello")
-        bag.Write("prop2", "prop2.there")
-
-
-class Log:
-    _public_methods_ = ["AddError"]
-    _com_interfaces_ = [pythoncom.IID_IErrorLog]
-
-    def AddError(self, propName, excepInfo):
-        print("error: propName=", propName, "error=", excepInfo)
-
-
-def test():
-    bag = Bag()
-    target = Target()
-    log = Log()
-
-    target.Save(bag, 1, 1)
-    target.Load(bag, log)
-
-    comBag = util.wrap(bag, pythoncom.IID_IPropertyBag)
-    comTarget = util.wrap(target, pythoncom.IID_IPersistPropertyBag)
-    comLog = util.wrap(log, pythoncom.IID_IErrorLog)
-
-    comTarget.Save(comBag, 1, 1)
-    comTarget.Load(comBag, comLog)
-
-
-if __name__ == "__main__":
-    test()
diff --git a/lib/win32com/include/PythonCOM.h b/lib/win32com/include/PythonCOM.h
deleted file mode 100644
index e7599717..00000000
--- a/lib/win32com/include/PythonCOM.h
+++ /dev/null
@@ -1,766 +0,0 @@
-/* PythonCOM.h
-
- Main header for Python COM support.
-
- This file is involved mainly with client side COM support for
- Python.
-
- Most COM work put together by Greg Stein and Mark Hammond, with a
- few others starting to come out of the closet.
-
-
- --------------------------------------------------------------------
- Thread State Rules
- ------------------
- These rules apply to PythonCOM in general, and not just to
- the client side.
-
- The rules are quite simple, but it is critical they be followed.
- In general, errors here will be picked up quite quickly, as Python
- will raise a Fatal Error.  However, the Release() issue in particular
- may keep a number of problems well hidden.
-
- Interfaces:
- -----------
- Before making ANY call out to COM, you MUST release the Python lock.
- This is true to ANY call whatsoever, including the COM call in question,
- but also any calls to "->Release();"
-
- This is normally achieved with the calls
- PY_INTERFACE_PRECALL and PY_INTERFACE_POSTCALL, which release
- and acquire the Python lock.
-
- Gateways:
- ---------
- Before doing anything related to Python, gateways MUST acquire the
- Python lock, and must release it before returning.
-
- This is normally achieved with PY_GATEWAY_METHOD at the top of a
- gateway method.  This macro resolves to a class, which automatically does
- the right thing.
-
- Release:
- --------
- As mentioned above for Interfaces, EVERY call to Release() must be done
- with the Python lock released.  This is expanded here.
-
- This is very important, but an error may not be noticed.  The problem will
- only be seen when the Release() is on a Python object and the Release() is the
- final one for the object.  In this case, the Python object will attempt to
- acquire the Python lock before destroying itself, and Python will raise a
- fatal error.
-
- In many many cases, you will not notice this error, but someday, someone will
- implement the other side in Python, and suddenly FatalErrors will start
- appearing.  Make sure you get this right.
-
- Eg, this code is correct:
-   PY_INTERFACE_PRECALL;
-   pSomeObj->SomeFunction(pSomeOtherObject);
-   pSomeOtherObject->Release();
-   PY_INTERFACE_POSTCALL;
-
- However, this code is WRONG, but will RARELY FAIL.
-   PY_INTERFACE_PRECALL;
-   pSomeObj->SomeFunction(pSomeOtherObject);
-   PY_INTERFACE_POSTCALL;
-   pSomeOtherObject->Release();
---------------------------------------------------------------------
-*/
-#ifndef __PYTHONCOM_H__
-#define __PYTHONCOM_H__
-
-// #define _DEBUG_LIFETIMES // Trace COM object lifetimes.
-
-#ifdef FREEZE_PYTHONCOM
-/* The pythoncom module is being included in a frozen .EXE/.DLL */
-#define PYCOM_EXPORT
-#else
-#ifdef BUILD_PYTHONCOM
-/* We are building pythoncomxx.dll */
-#define PYCOM_EXPORT __declspec(dllexport)
-#else
-/* This module uses pythoncomxx.dll */
-#define PYCOM_EXPORT __declspec(dllimport)
-#ifndef _DEBUG
-#pragma comment(lib, "pythoncom.lib")
-#else
-#pragma comment(lib, "pythoncom_d.lib")
-#endif
-#endif
-#endif
-
-#ifdef MS_WINCE
-// List of interfaces not supported by CE.
-#define NO_PYCOM_IDISPATCHEX
-#define NO_PYCOM_IPROVIDECLASSINFO
-#define NO_PYCOM_IENUMGUID
-#define NO_PYCOM_IENUMCATEGORYINFO
-#define NO_PYCOM_ICATINFORMATION
-#define NO_PYCOM_ICATREGISTER
-#define NO_PYCOM_ISERVICEPROVIDER
-#define NO_PYCOM_IPROPERTYSTORAGE
-#define NO_PYCOM_IPROPERTYSETSTORAGE
-#define NO_PYCOM_ENUMSTATPROPSTG
-
-#include "ocidl.h"
-#include "oleauto.h"
-
-#endif  // MS_WINCE
-
-#ifdef __MINGW32__
-// Special Mingw32 considerations.
-#define NO_PYCOM_ENUMSTATPROPSTG
-#define __try try
-#define __except catch
-#include <olectl.h>
-
-#endif  // __MINGW32__
-
-#include <PyWinTypes.h>  // Standard Win32 Types
-
-#ifndef NO_PYCOM_IDISPATCHEX
-#include <dispex.h>  // New header for IDispatchEx interface.
-#endif               // NO_PYCOM_IDISPATCHEX
-
-#if defined(MAINWIN)
-// Mainwin seems to have 1/2 the VT_RECORD infrastructure in place
-#if !defined(VT_RECORD)
-#define VT_RECORD 36
-#define V_RECORDINFO(X) ((X)->brecVal.pRecInfo)
-#define V_RECORD(X) ((X)->brecVal.pvRecord)
-#else
-#pragma message(                                       \
-    "MAINWIN appears to have grown correct VT_RECORD " \
-    "support. Please update PythonCOM.h accordingly")
-#endif  // VT_RECORD
-#endif  // MAINWIN
-
-class PyIUnknown;
-// To make life interesting/complicated, I use C++ classes for
-// all Python objects.  The main advantage is that I can derive
-// a PyIDispatch object from a PyIUnknown, etc.  This provides a
-// clean C++ interface, and "automatically" provides all base
-// Python methods to "derived" Python types.
-//
-// Main disadvantage is that any extension DLLs will need to include
-// these headers, and link with this .lib
-//
-// Base class for (most of) the type objects.
-
-class PYCOM_EXPORT PyComTypeObject : public PyTypeObject {
-   public:
-    PyComTypeObject(const char *name, PyComTypeObject *pBaseType, Py_ssize_t typeSize, struct PyMethodDef *methodList,
-                    PyIUnknown *(*thector)(IUnknown *));
-    ~PyComTypeObject();
-
-    // is the given object an interface type object? (e.g. PyIUnknown)
-    static BOOL is_interface_type(PyObject *ob);
-
-   public:
-    PyIUnknown *(*ctor)(IUnknown *);
-};
-
-// A type used for interfaces that can automatically provide enumerators
-// (ie, they themselves aren't enumerable, but do have a suitable default
-// method that returns a PyIEnum object
-class PYCOM_EXPORT PyComEnumProviderTypeObject : public PyComTypeObject {
-   public:
-    PyComEnumProviderTypeObject(const char *name, PyComTypeObject *pBaseType, Py_ssize_t typeSize,
-                                struct PyMethodDef *methodList, PyIUnknown *(*thector)(IUnknown *),
-                                const char *enum_method_name);
-    static PyObject *iter(PyObject *self);
-    const char *enum_method_name;
-};
-
-// A type used for PyIEnum interfaces
-class PYCOM_EXPORT PyComEnumTypeObject : public PyComTypeObject {
-   public:
-    static PyObject *iter(PyObject *self);
-    static PyObject *iternext(PyObject *self);
-    PyComEnumTypeObject(const char *name, PyComTypeObject *pBaseType, Py_ssize_t typeSize, struct PyMethodDef *methodList,
-                        PyIUnknown *(*thector)(IUnknown *));
-};
-
-// Very very base class - not COM specific - Should exist in the
-// Python core somewhere, IMO.
-class PYCOM_EXPORT PyIBase : public PyObject {
-   public:
-    // virtuals for Python support
-    virtual PyObject *getattr(char *name);
-    virtual int setattr(char *name, PyObject *v);
-    virtual PyObject *repr();
-    virtual int compare(PyObject *other)
-    {
-        if (this == other)
-            return 0;
-        if (this < other)
-            return -1;
-        return 1;
-    }
-    // These iter are a little special, in that returning NULL means
-    // use the implementation in the type
-    virtual PyObject *iter() { return NULL; }
-    virtual PyObject *iternext() { return NULL; }
-
-   protected:
-    PyIBase();
-    virtual ~PyIBase();
-
-   public:
-    static BOOL is_object(PyObject *, PyComTypeObject *which);
-    BOOL is_object(PyComTypeObject *which);
-    static void dealloc(PyObject *ob);
-    static PyObject *repr(PyObject *ob);
-    static PyObject *getattro(PyObject *self, PyObject *name);
-    static int setattro(PyObject *op, PyObject *obname, PyObject *v);
-    static int cmp(PyObject *ob1, PyObject *ob2);
-    static PyObject *richcmp(PyObject *ob1, PyObject *ob2, int op);
-};
-
-/* Special Type objects */
-extern PYCOM_EXPORT PyTypeObject PyOleEmptyType;        // equivalent to VT_EMPTY
-extern PYCOM_EXPORT PyTypeObject PyOleMissingType;      // special Python handling.
-extern PYCOM_EXPORT PyTypeObject PyOleArgNotFoundType;  // special VT_ERROR value
-extern PYCOM_EXPORT PyTypeObject PyOleNothingType;      // special VT_ERROR value
-
-// ALL of these set an appropriate Python error on bad return.
-
-// Given a Python object that is a registered COM type, return a given
-// interface pointer on its underlying object, with a new reference added.
-PYCOM_EXPORT BOOL PyCom_InterfaceFromPyObject(PyObject *ob, REFIID iid, LPVOID *ppv, BOOL bNoneOK = TRUE);
-
-// As above, but allows instance with "_oleobj_" attribute.
-PYCOM_EXPORT BOOL PyCom_InterfaceFromPyInstanceOrObject(PyObject *ob, REFIID iid, LPVOID *ppv, BOOL bNoneOK = TRUE);
-
-// Release an arbitary COM pointer.
-// NOTE: the PRECALL/POSTCALL stuff is probably not strictly necessary
-// since the PyGILSTATE stuff has been in place (and even then, it only
-// mattered when it was the last Release() on a Python implemented object)
-#define PYCOM_RELEASE(pUnk)        \
-    {                              \
-        if (pUnk) {                \
-            PY_INTERFACE_PRECALL;  \
-            (pUnk)->Release();     \
-            PY_INTERFACE_POSTCALL; \
-        }                          \
-    }
-
-// Given an IUnknown and an Interface ID, create and return an object
-// of the appropriate type. eg IID_Unknown->PyIUnknown,
-// IID_IDispatch->PyIDispatch, etc.
-// Uses a map that external extension DLLs can populate with their IID/type.
-// Under the principal of least surprise, this will return Py_None is punk is NULL.
-//  Otherwise, a valid PyI*, but with NULL m_obj (and therefore totally useless)
-//  object would be created.
-// BOOL bAddRef indicates if a COM reference count should be added to the IUnknown.
-//  This depends purely on the context in which it is called.  If the IUnknown is obtained
-//  from a function that creates a new ref (eg, CoCreateInstance()) then you should use
-//  FALSE.  If you receive the pointer as (eg) a param to a gateway function, then
-//  you normally need to pass TRUE, as this is truly a new reference.
-//  *** ALWAYS take the time to get this right. ***
-PYCOM_EXPORT PyObject *PyCom_PyObjectFromIUnknown(IUnknown *punk, REFIID riid, BOOL bAddRef = FALSE);
-
-// VARIANT <-> PyObject conversion utilities.
-PYCOM_EXPORT BOOL PyCom_VariantFromPyObject(PyObject *obj, VARIANT *var);
-PYCOM_EXPORT PyObject *PyCom_PyObjectFromVariant(const VARIANT *var);
-
-// PROPVARIANT
-PYCOM_EXPORT PyObject *PyObject_FromPROPVARIANT(PROPVARIANT *pVar);
-PYCOM_EXPORT PyObject *PyObject_FromPROPVARIANTs(PROPVARIANT *pVars, ULONG cVars);
-PYCOM_EXPORT BOOL PyObject_AsPROPVARIANT(PyObject *ob, PROPVARIANT *pVar);
-
-// Other conversion helpers...
-PYCOM_EXPORT PyObject *PyCom_PyObjectFromSTATSTG(STATSTG *pStat);
-PYCOM_EXPORT BOOL PyCom_PyObjectAsSTATSTG(PyObject *ob, STATSTG *pStat, DWORD flags = 0);
-PYCOM_EXPORT BOOL PyCom_SAFEARRAYFromPyObject(PyObject *obj, SAFEARRAY **ppSA, VARENUM vt = VT_VARIANT);
-PYCOM_EXPORT PyObject *PyCom_PyObjectFromSAFEARRAY(SAFEARRAY *psa, VARENUM vt = VT_VARIANT);
-#ifndef NO_PYCOM_STGOPTIONS
-PYCOM_EXPORT BOOL PyCom_PyObjectAsSTGOPTIONS(PyObject *obstgoptions, STGOPTIONS **ppstgoptions, TmpWCHAR *tmpw_shelve);
-#endif
-PYCOM_EXPORT PyObject *PyCom_PyObjectFromSTATPROPSETSTG(STATPROPSETSTG *pStat);
-PYCOM_EXPORT BOOL PyCom_PyObjectAsSTATPROPSETSTG(PyObject *, STATPROPSETSTG *);
-
-// Currency support.
-PYCOM_EXPORT PyObject *PyObject_FromCurrency(CURRENCY &cy);
-PYCOM_EXPORT BOOL PyObject_AsCurrency(PyObject *ob, CURRENCY *pcy);
-
-// OLEMENUGROUPWIDTHS are used by axcontrol, shell, etc
-PYCOM_EXPORT BOOL PyObject_AsOLEMENUGROUPWIDTHS(PyObject *oblpMenuWidths, OLEMENUGROUPWIDTHS *pWidths);
-PYCOM_EXPORT PyObject *PyObject_FromOLEMENUGROUPWIDTHS(const OLEMENUGROUPWIDTHS *pWidths);
-
-/* Functions for Initializing COM, and also letting the core know about it!
- */
-PYCOM_EXPORT HRESULT PyCom_CoInitializeEx(LPVOID reserved, DWORD dwInit);
-PYCOM_EXPORT HRESULT PyCom_CoInitialize(LPVOID reserved);
-PYCOM_EXPORT void PyCom_CoUninitialize();
-
-///////////////////////////////////////////////////////////////////
-// Error related functions
-
-// Client related functions - generally called by interfaces before
-// they return NULL back to Python to indicate the error.
-// All these functions return NULL so interfaces can generally
-// just "return PyCom_BuildPyException(hr, punk, IID_IWhatever)"
-
-// Uses the HRESULT, and IErrorInfo interfaces if available to
-// create and set a pythoncom.com_error.
-PYCOM_EXPORT PyObject *PyCom_BuildPyException(HRESULT hr, IUnknown *pUnk = NULL, REFIID iid = IID_NULL);
-
-// Uses the HRESULT and an EXCEPINFO structure to create and
-// set a pythoncom.com_error.
-PYCOM_EXPORT PyObject *PyCom_BuildPyExceptionFromEXCEPINFO(HRESULT hr, EXCEPINFO *pexcepInfo, UINT nArgErr = (UINT)-1);
-
-// Sets a pythoncom.internal_error - no one should ever see these!
-PYCOM_EXPORT PyObject *PyCom_BuildInternalPyException(char *msg);
-
-// Log an error to a Python logger object if one can be found, or
-// to stderr if no log available.
-// If logProvider is not NULL, we will call a "_GetLogger_()" method on it.
-// If logProvider is NULL, we attempt to fetch "win32com.logger".
-// If they do not exist, return None, or raise an error fetching them
-// (or even writing to them once fetched), the message still goes to stderr.
-// NOTE: By default, win32com does *not* provide a logger, so default is that
-// all errors are written to stdout.
-// This will *not* write a record if a COM Server error is current.
-PYCOM_EXPORT void PyCom_LoggerNonServerException(PyObject *logProvider, const WCHAR *fmt, ...);
-
-// Write an error record, including exception.  This will write an error
-// record even if a COM server error is current.
-PYCOM_EXPORT void PyCom_LoggerException(PyObject *logProvider, const WCHAR *fmt, ...);
-
-// Write a warning record - in general this does *not* mean a call failed, but
-// still is something in the programmers control that they should change.
-// XXX - if an exception is pending when this is called, the traceback will
-// also be written.  This is undesirable and will be changed should this
-// start being a problem.
-PYCOM_EXPORT void PyCom_LoggerWarning(PyObject *logProvider, const WCHAR *fmt, ...);
-
-// Server related error functions
-// These are supplied so that any Python errors we detect can be
-// converted into COM error information.  The HRESULT returned should
-// be returned by the COM function, and these functions also set the
-// IErrorInfo interfaces, so the caller can extract more detailed
-// information about the Python exception.
-
-// Set a COM exception, logging the exception if not an explicitly raised 'server' exception
-PYCOM_EXPORT HRESULT PyCom_SetAndLogCOMErrorFromPyException(const char *methodName, REFIID riid /* = IID_NULL */);
-PYCOM_EXPORT HRESULT PyCom_SetAndLogCOMErrorFromPyExceptionEx(PyObject *provider, const char *methodName,
-                                                              REFIID riid /* = IID_NULL */);
-
-// Used in gateways to SetErrorInfo() with a simple HRESULT, then return it.
-// The description is generally only useful for debugging purposes,
-// and if you are debugging via a server that supports IErrorInfo (like Python :-)
-// NOTE: this function is usuable from outside the Python context
-PYCOM_EXPORT HRESULT PyCom_SetCOMErrorFromSimple(HRESULT hr, REFIID riid = IID_NULL, const WCHAR *description = NULL);
-
-// Used in gateways to check if an IEnum*'s Next() or Clone() method worked.
-PYCOM_EXPORT HRESULT PyCom_CheckIEnumNextResult(HRESULT hr, REFIID riid);
-
-// Used in gateways when an enumerator expected a sequence but didn't get it.
-PYCOM_EXPORT HRESULT PyCom_HandleIEnumNoSequence(REFIID riid);
-
-// Used in gateways to SetErrorInfo() the current Python exception, and
-// (assuming not a server error explicitly raised) also logs an error
-// to stdout/win32com.logger.
-// NOTE: this function assumes GIL held
-PYCOM_EXPORT HRESULT PyCom_SetCOMErrorFromPyException(REFIID riid = IID_NULL);
-
-// A couple of EXCEPINFO helpers - could be private to IDispatch
-// if it wasnt for the AXScript support (and ITypeInfo if we get around to that :-)
-// These functions do not set any error states to either Python or
-// COM - they simply convert to/from PyObjects and EXCEPINFOs
-
-// Use the current Python exception to fill an EXCEPINFO structure.
-PYCOM_EXPORT void PyCom_ExcepInfoFromPyException(EXCEPINFO *pExcepInfo);
-
-// Fill in an EXCEPINFO structure from a Python instance or tuple object.
-// (ie, similar to the above, except the Python exception object is specified,
-// rather than using the "current"
-PYCOM_EXPORT BOOL PyCom_ExcepInfoFromPyObject(PyObject *obExcepInfo, EXCEPINFO *pexcepInfo, HRESULT *phresult = NULL);
-
-// Create a Python object holding the exception information.  The exception
-// information is *not* freed by this function.  Python exceptions are
-// raised and NULL is returned if an error occurs.
-PYCOM_EXPORT PyObject *PyCom_PyObjectFromExcepInfo(const EXCEPINFO *pexcepInfo);
-
-///////////////////////////////////////////////////////////////////
-//
-// External C++ helpers - these helpers are for other DLLs which
-// may need similar functionality, but dont want to duplicate all
-
-// This helper is for an application that has an IDispatch, and COM arguments
-// and wants to call a Python function.  It is assumed the caller can map the IDispatch
-// to a Python object, so the Python handler is passed.
-// Args:
-//   handler : A Python callable object.
-//   dispparms : the COM arguments.
-//   pVarResult : The variant for the return value of the Python call.
-//   pexcepinfo : Exception info the helper may fill out.
-//   puArgErr : Argument error the helper may fill out on exception
-//   addnArgs : Any additional arguments to the Python function.  May be NULL.
-// If addnArgs is NULL, then it is assumed the Python call should be native -
-// ie, the COM args are packed as normal Python args to the call.
-// If addnArgs is NOT NULL, it is assumed the Python function itself is
-// a helper.  This Python function will be called with 2 arguments - both
-// tuples - first one is the COM args, second is the addn args.
-PYCOM_EXPORT BOOL PyCom_MakeOlePythonCall(PyObject *handler, DISPPARAMS FAR *params, VARIANT FAR *pVarResult,
-                                          EXCEPINFO FAR *pexcepinfo, UINT FAR *puArgErr, PyObject *addnlArgs);
-
-/////////////////////////////////////////////////////////////////////////////
-// Various special purpose singletons
-class PYCOM_EXPORT PyOleEmpty : public PyObject {
-   public:
-    PyOleEmpty();
-};
-
-class PYCOM_EXPORT PyOleMissing : public PyObject {
-   public:
-    PyOleMissing();
-};
-
-class PYCOM_EXPORT PyOleArgNotFound : public PyObject {
-   public:
-    PyOleArgNotFound();
-};
-
-class PYCOM_EXPORT PyOleNothing : public PyObject {
-   public:
-    PyOleNothing();
-};
-
-// We need to dynamically create C++ Python objects
-// These helpers allow each type object to create it.
-#define MAKE_PYCOM_CTOR(classname) \
-    static PyIUnknown *PyObConstruct(IUnknown *pInitObj) { return new classname(pInitObj); }
-#define MAKE_PYCOM_CTOR_ERRORINFO(classname, iid)                                                       \
-    static PyIUnknown *PyObConstruct(IUnknown *pInitObj) { return new classname(pInitObj); }            \
-    static PyObject *SetPythonCOMError(PyObject *self, HRESULT hr)                                      \
-    {                                                                                                   \
-        return PyCom_BuildPyException(hr, GetI(self), iid);                                             \
-    }
-#define GET_PYCOM_CTOR(classname) classname::PyObConstruct
-
-// Macros that interfaces should use.  PY_INTERFACE_METHOD at the top of the method
-// The other 2 wrap directly around the underlying method call.
-#define PY_INTERFACE_METHOD
-// Identical to Py_BEGIN_ALLOW_THREADS except no { !!!
-#define PY_INTERFACE_PRECALL PyThreadState *_save = PyEval_SaveThread();
-#define PY_INTERFACE_POSTCALL PyEval_RestoreThread(_save);
-
-/////////////////////////////////////////////////////////////////////////////
-// class PyIUnknown
-class PYCOM_EXPORT PyIUnknown : public PyIBase {
-   public:
-    MAKE_PYCOM_CTOR(PyIUnknown);
-    virtual PyObject *repr();
-    virtual int compare(PyObject *other);
-
-    static IUnknown *GetI(PyObject *self);
-    IUnknown *m_obj;
-    static char *szErrMsgObjectReleased;
-    static void SafeRelease(PyIUnknown *ob);
-    static PyComTypeObject type;
-
-    // The Python methods
-    static PyObject *QueryInterface(PyObject *self, PyObject *args);
-    static PyObject *SafeRelease(PyObject *self, PyObject *args);
-
-   protected:
-    PyIUnknown(IUnknown *punk);
-    ~PyIUnknown();
-};
-
-/////////////////////////////////////////////////////////////////////////////
-// class PyIDispatch
-
-class PYCOM_EXPORT PyIDispatch : public PyIUnknown {
-   public:
-    MAKE_PYCOM_CTOR(PyIDispatch);
-    static IDispatch *GetI(PyObject *self);
-    static PyComTypeObject type;
-
-    // The Python methods
-    static PyObject *Invoke(PyObject *self, PyObject *args);
-    static PyObject *InvokeTypes(PyObject *self, PyObject *args);
-    static PyObject *GetIDsOfNames(PyObject *self, PyObject *args);
-    static PyObject *GetTypeInfo(PyObject *self, PyObject *args);
-    static PyObject *GetTypeInfoCount(PyObject *self, PyObject *args);
-
-   protected:
-    PyIDispatch(IUnknown *pdisp);
-    ~PyIDispatch();
-};
-
-#ifndef NO_PYCOM_IDISPATCHEX
-/////////////////////////////////////////////////////////////////////////////
-// class PyIDispatchEx
-
-class PYCOM_EXPORT PyIDispatchEx : public PyIDispatch {
-   public:
-    MAKE_PYCOM_CTOR_ERRORINFO(PyIDispatchEx, IID_IDispatchEx);
-    static IDispatchEx *GetI(PyObject *self);
-    static PyComTypeObject type;
-
-    // The Python methods
-    static PyObject *GetDispID(PyObject *self, PyObject *args);
-    static PyObject *InvokeEx(PyObject *self, PyObject *args);
-    static PyObject *DeleteMemberByName(PyObject *self, PyObject *args);
-    static PyObject *DeleteMemberByDispID(PyObject *self, PyObject *args);
-    static PyObject *GetMemberProperties(PyObject *self, PyObject *args);
-    static PyObject *GetMemberName(PyObject *self, PyObject *args);
-    static PyObject *GetNextDispID(PyObject *self, PyObject *args);
-
-   protected:
-    PyIDispatchEx(IUnknown *pdisp);
-    ~PyIDispatchEx();
-};
-#endif  // NO_PYCOM_IDISPATCHEX
-
-/////////////////////////////////////////////////////////////////////////////
-// class PyIClassFactory
-
-class PYCOM_EXPORT PyIClassFactory : public PyIUnknown {
-   public:
-    MAKE_PYCOM_CTOR(PyIClassFactory);
-    static IClassFactory *GetI(PyObject *self);
-    static PyComTypeObject type;
-
-    // The Python methods
-    static PyObject *CreateInstance(PyObject *self, PyObject *args);
-    static PyObject *LockServer(PyObject *self, PyObject *args);
-
-   protected:
-    PyIClassFactory(IUnknown *pdisp);
-    ~PyIClassFactory();
-};
-
-#ifndef NO_PYCOM_IPROVIDECLASSINFO
-
-/////////////////////////////////////////////////////////////////////////////
-// class PyIProvideTypeInfo
-
-class PYCOM_EXPORT PyIProvideClassInfo : public PyIUnknown {
-   public:
-    MAKE_PYCOM_CTOR(PyIProvideClassInfo);
-    static IProvideClassInfo *GetI(PyObject *self);
-    static PyComTypeObject type;
-
-    // The Python methods
-    static PyObject *GetClassInfo(PyObject *self, PyObject *args);
-
-   protected:
-    PyIProvideClassInfo(IUnknown *pdisp);
-    ~PyIProvideClassInfo();
-};
-
-class PYCOM_EXPORT PyIProvideClassInfo2 : public PyIProvideClassInfo {
-   public:
-    MAKE_PYCOM_CTOR(PyIProvideClassInfo2);
-    static IProvideClassInfo2 *GetI(PyObject *self);
-    static PyComTypeObject type;
-
-    // The Python methods
-    static PyObject *GetGUID(PyObject *self, PyObject *args);
-
-   protected:
-    PyIProvideClassInfo2(IUnknown *pdisp);
-    ~PyIProvideClassInfo2();
-};
-#endif  // NO_PYCOM_IPROVIDECLASSINFO
-
-/////////////////////////////////////////////////////////////////////////////
-// class PyITypeInfo
-class PYCOM_EXPORT PyITypeInfo : public PyIUnknown {
-   public:
-    MAKE_PYCOM_CTOR(PyITypeInfo);
-    static PyComTypeObject type;
-    static ITypeInfo *GetI(PyObject *self);
-
-    PyObject *GetContainingTypeLib();
-    PyObject *GetDocumentation(MEMBERID);
-    PyObject *GetRefTypeInfo(HREFTYPE href);
-    PyObject *GetRefTypeOfImplType(int index);
-    PyObject *GetFuncDesc(int pos);
-    PyObject *GetIDsOfNames(OLECHAR FAR *FAR *, int);
-    PyObject *GetNames(MEMBERID);
-    PyObject *GetTypeAttr();
-    PyObject *GetVarDesc(int pos);
-    PyObject *GetImplTypeFlags(int index);
-    PyObject *GetTypeComp();
-
-   protected:
-    PyITypeInfo(IUnknown *);
-    ~PyITypeInfo();
-};
-
-/////////////////////////////////////////////////////////////////////////////
-// class PyITypeComp
-class PYCOM_EXPORT PyITypeComp : public PyIUnknown {
-   public:
-    MAKE_PYCOM_CTOR(PyITypeComp);
-    static PyComTypeObject type;
-    static ITypeComp *GetI(PyObject *self);
-
-    PyObject *Bind(OLECHAR *szName, unsigned short wflags);
-    PyObject *BindType(OLECHAR *szName);
-
-   protected:
-    PyITypeComp(IUnknown *);
-    ~PyITypeComp();
-};
-
-/////////////////////////////////////////////////////////////////////////////
-// class CPyTypeLib
-
-class PYCOM_EXPORT PyITypeLib : public PyIUnknown {
-   public:
-    MAKE_PYCOM_CTOR(PyITypeLib);
-    static PyComTypeObject type;
-    static ITypeLib *GetI(PyObject *self);
-
-    PyObject *GetLibAttr();
-    PyObject *GetDocumentation(int pos);
-    PyObject *GetTypeInfo(int pos);
-    PyObject *GetTypeInfoCount();
-    PyObject *GetTypeInfoOfGuid(REFGUID guid);
-    PyObject *GetTypeInfoType(int pos);
-    PyObject *GetTypeComp();
-
-   protected:
-    PyITypeLib(IUnknown *);
-    ~PyITypeLib();
-};
-
-/////////////////////////////////////////////////////////////////////////////
-// class PyIConnectionPoint
-
-class PYCOM_EXPORT PyIConnectionPoint : public PyIUnknown {
-   public:
-    MAKE_PYCOM_CTOR_ERRORINFO(PyIConnectionPoint, IID_IConnectionPoint);
-    static PyComTypeObject type;
-    static IConnectionPoint *GetI(PyObject *self);
-
-    static PyObject *GetConnectionInterface(PyObject *self, PyObject *args);
-    static PyObject *GetConnectionPointContainer(PyObject *self, PyObject *args);
-    static PyObject *Advise(PyObject *self, PyObject *args);
-    static PyObject *Unadvise(PyObject *self, PyObject *args);
-    static PyObject *EnumConnections(PyObject *self, PyObject *args);
-
-   protected:
-    PyIConnectionPoint(IUnknown *);
-    ~PyIConnectionPoint();
-};
-
-class PYCOM_EXPORT PyIConnectionPointContainer : public PyIUnknown {
-   public:
-    MAKE_PYCOM_CTOR_ERRORINFO(PyIConnectionPointContainer, IID_IConnectionPointContainer);
-    static PyComTypeObject type;
-    static IConnectionPointContainer *GetI(PyObject *self);
-
-    static PyObject *EnumConnectionPoints(PyObject *self, PyObject *args);
-    static PyObject *FindConnectionPoint(PyObject *self, PyObject *args);
-
-   protected:
-    PyIConnectionPointContainer(IUnknown *);
-    ~PyIConnectionPointContainer();
-};
-
-/////////////////////////////////////////////////////////////////////////////
-// class PythonOleArgHelper
-//
-// A PythonOleArgHelper is used primarily to help out Python helpers
-// which need to convert from a Python object when the specific OLE
-// type is known - eg, when a TypeInfo is available.
-//
-// The type of conversion determines who owns what buffers etc.  I wish BYREF didnt exist :-)
-typedef enum {
-    // We dont know what sort of conversion it is yet.
-    POAH_CONVERT_UNKNOWN,
-    // A PyObject is given, we convert to a VARIANT, make the COM call, then BYREFs back to a PyObject
-    // ie, this is typically a "normal" COM call, where Python initiates the call
-    POAH_CONVERT_FROM_PYOBJECT,
-    // A VARIANT is given, we convert to a PyObject, make the Python call, then BYREFs back to a VARIANT.
-    // ie, this is typically handling a COM event, where COM itself initiates the call.
-    POAH_CONVERT_FROM_VARIANT,
-} POAH_CONVERT_DIRECTION;
-
-class PYCOM_EXPORT PythonOleArgHelper {
-   public:
-    PythonOleArgHelper();
-    ~PythonOleArgHelper();
-    BOOL ParseTypeInformation(PyObject *reqdObjectTuple);
-
-    // Using this call with reqdObject != NULL will check the existing
-    // VT_ of the variant.  If not VT_EMPTY, then the result will be coerced to
-    // that type.  This contrasts with PyCom_PyObjectToVariant which just
-    // uses the Python type to determine the variant type.
-    BOOL MakeObjToVariant(PyObject *obj, VARIANT *var, PyObject *reqdObjectTuple = NULL);
-    PyObject *MakeVariantToObj(VARIANT *var);
-
-    VARTYPE m_reqdType;
-    BOOL m_bParsedTypeInfo;
-    BOOL m_bIsOut;
-    POAH_CONVERT_DIRECTION m_convertDirection;
-    PyObject *m_pyVariant;  // if non-null, a win32com.client.VARIANT
-    union {
-        void *m_pValueHolder;
-        short m_sBuf;
-        long m_lBuf;
-        LONGLONG m_llBuf;
-        VARIANT_BOOL m_boolBuf;
-        double m_dBuf;
-        float m_fBuf;
-        IDispatch *m_dispBuf;
-        IUnknown *m_unkBuf;
-        SAFEARRAY *m_arrayBuf;
-        VARIANT *m_varBuf;
-        DATE m_dateBuf;
-        CY m_cyBuf;
-    };
-};
-
-/////////////////////////////////////////////////////////////////////////////
-// global functions and variables
-PYCOM_EXPORT BOOL MakePythonArgumentTuples(PyObject **pArgs, PythonOleArgHelper **ppHelpers, PyObject **pNamedArgs,
-                                           PythonOleArgHelper **ppNamedHelpers, DISPPARAMS FAR *params);
-
-// Convert a Python object to a BSTR - allow embedded NULLs, None, etc.
-PYCOM_EXPORT BOOL PyCom_BstrFromPyObject(PyObject *stringObject, BSTR *pResult, BOOL bNoneOK = FALSE);
-
-// MakeBstrToObj - convert a BSTR into a Python string.
-//
-// ONLY USE THIS FOR TRUE BSTR's - Use the fn below for OLECHAR *'s.
-// NOTE - does not use standard macros, so NULLs get through!
-PYCOM_EXPORT PyObject *MakeBstrToObj(const BSTR bstr);
-
-// Size info is available (eg, a fn returns a string and also fills in a size variable)
-PYCOM_EXPORT PyObject *MakeOLECHARToObj(const OLECHAR *str, int numChars);
-
-// No size info avail.
-PYCOM_EXPORT PyObject *MakeOLECHARToObj(const OLECHAR *str);
-
-PYCOM_EXPORT void PyCom_LogF(const WCHAR *fmt, ...);
-
-// Generic conversion from python sequence to VT_VECTOR array
-// Resulting array must be freed with CoTaskMemFree
-template <typename arraytype>
-BOOL SeqToVector(PyObject *ob, arraytype **pA, ULONG *pcount, BOOL (*converter)(PyObject *, arraytype *))
-{
-    TmpPyObject seq = PyWinSequence_Tuple(ob, pcount);
-    if (seq == NULL)
-        return FALSE;
-    *pA = (arraytype *)CoTaskMemAlloc(*pcount * sizeof(arraytype));
-    if (*pA == NULL) {
-        PyErr_NoMemory();
-        return FALSE;
-    }
-    for (ULONG i = 0; i < *pcount; i++) {
-        PyObject *item = PyTuple_GET_ITEM((PyObject *)seq, i);
-        if (!(*converter)(item, &(*pA)[i]))
-            return FALSE;
-    }
-    return TRUE;
-}
-
-#endif  // __PYTHONCOM_H__
diff --git a/lib/win32com/include/PythonCOMRegister.h b/lib/win32com/include/PythonCOMRegister.h
deleted file mode 100644
index ab960f53..00000000
--- a/lib/win32com/include/PythonCOMRegister.h
+++ /dev/null
@@ -1,84 +0,0 @@
-// Support for PythonCOM and its extensions to register the interfaces,
-// gateways and IIDs it supports.
-//
-// The module can simply declare an array of type PyCom_InterfaceSupportInfo, then
-// use the macros to populate it.
-//
-// See Register.cpp and AXScript.cpp for examples on its use.
-
-#ifndef __PYTHONCOMREGISTER_H__
-#define __PYTHONCOMREGISTER_H__
-
-#include "PythonCOMServer.h"  // Need defns in this file...
-
-typedef struct {
-    const GUID *pGUID;             // The supported IID - required
-    const char *interfaceName;     // Name of the interface - required
-    const char *iidName;           // Name of the IID that goes into the dict. - required
-    PyTypeObject *pTypeOb;         // the type object for client PyI* side - NULL for server only support.
-    pfnPyGatewayConstructor ctor;  // Gateway (PyG*) interface constructor - NULL for client only support
-
-} PyCom_InterfaceSupportInfo;
-
-#define PYCOM_INTERFACE_IID_ONLY(ifc)                   \
-    {                                                   \
-        &IID_I##ifc, "I" #ifc, "IID_I" #ifc, NULL, NULL \
-    }
-#define PYCOM_INTERFACE_CLSID_ONLY(ifc)                        \
-    {                                                          \
-        &CLSID_##ifc, "CLSID_" #ifc, "CLSID_" #ifc, NULL, NULL \
-    }
-#define PYCOM_INTERFACE_CATID_ONLY(ifc)                        \
-    {                                                          \
-        &CATID_##ifc, "CATID_" #ifc, "CATID_" #ifc, NULL, NULL \
-    }
-#define PYCOM_INTERFACE_CLIENT_ONLY(ifc)                           \
-    {                                                              \
-        &IID_I##ifc, "I" #ifc, "IID_I" #ifc, &PyI##ifc::type, NULL \
-    }
-#define PYCOM_INTERFACE_SERVER_ONLY(ifc)                                        \
-    {                                                                           \
-        &IID_I##ifc, "I" #ifc, "IID_I" #ifc, NULL, GET_PYGATEWAY_CTOR(PyG##ifc) \
-    }
-#define PYCOM_INTERFACE_FULL(ifc)                                                          \
-    {                                                                                      \
-        &IID_I##ifc, "I" #ifc, "IID_I" #ifc, &PyI##ifc::type, GET_PYGATEWAY_CTOR(PyG##ifc) \
-    }
-
-// Versions that use __uuidof() to get the IID, which seems to avoid the need
-// to link with a lib holding the IIDs.  Note that almost all extensions
-// build with __uuidof() being the default; the build failed at 'shell' - so
-// we could consider making this the default and making the 'explicit' version
-// above the special case.
-#define PYCOM_INTERFACE_IID_ONLY_UUIDOF(ifc)                  \
-    {                                                         \
-        &__uuidof(I##ifc), "I" #ifc, "IID_I" #ifc, NULL, NULL \
-    }
-#define PYCOM_INTERFACE_CLIENT_ONLY_UUIDOF(ifc)                          \
-    {                                                                    \
-        &__uuidof(I##ifc), "I" #ifc, "IID_I" #ifc, &PyI##ifc::type, NULL \
-    }
-#define PYCOM_INTERFACE_SERVER_ONLY_UUIDOF(ifc)                                       \
-    {                                                                                 \
-        &__uuidof(I##ifc), "I" #ifc, "IID_I" #ifc, NULL, GET_PYGATEWAY_CTOR(PyG##ifc) \
-    }
-#define PYCOM_INTERFACE_FULL_UUIDOF(ifc)                                                         \
-    {                                                                                            \
-        &__uuidof(I##ifc), "I" #ifc, "IID_I" #ifc, &PyI##ifc::type, GET_PYGATEWAY_CTOR(PyG##ifc) \
-    }
-
-// Prototypes for the register functions
-
-// Register a PythonCOM extension module
-PYCOM_EXPORT int PyCom_RegisterExtensionSupport(PyObject *dict, const PyCom_InterfaceSupportInfo *pInterfaces,
-                                                int numEntries);
-
-// THESE SHOULD NO LONGER BE USED.  Instead, use the functions above passing an
-// array of PyCom_InterfaceSupportInfo objects.
-
-PYCOM_EXPORT int PyCom_RegisterClientType(PyTypeObject *typeOb, const GUID *guid);
-
-HRESULT PYCOM_EXPORT PyCom_RegisterGatewayObject(REFIID iid, pfnPyGatewayConstructor ctor, const char *interfaceName);
-PYCOM_EXPORT int PyCom_IsGatewayRegistered(REFIID iid);
-
-#endif /* __PYTHONCOMREGISTER_H__ */
diff --git a/lib/win32com/include/PythonCOMServer.h b/lib/win32com/include/PythonCOMServer.h
deleted file mode 100644
index d263b3ad..00000000
--- a/lib/win32com/include/PythonCOMServer.h
+++ /dev/null
@@ -1,176 +0,0 @@
-#ifndef __PYTHONCOMSERVER_H__
-#define __PYTHONCOMSERVER_H__
-
-// PythonCOMServer.h :Server side COM support
-
-#include <Python.h>
-
-#define DLLAcquireGlobalLock PyWin_AcquireGlobalLock
-#define DLLReleaseGlobalLock PyWin_ReleaseGlobalLock
-
-void PYCOM_EXPORT PyCom_DLLAddRef(void);
-void PYCOM_EXPORT PyCom_DLLReleaseRef(void);
-
-// Use this macro at the start of all gateway methods.
-#define PY_GATEWAY_METHOD CEnterLeavePython _celp
-
-class PyGatewayBase;
-// Gateway constructors.
-// Each gateway must be able to be created from a "gateway constructor".  This
-// is simply a function that takes a Python instance as as argument, and returns
-// a gateway object of the correct type.  The MAKE_PYGATEWAY_CTOR is a helper that
-// will embed such a constructor in the class - however, this is not necessary -
-// _any_ function of the correct signature can be used.
-
-typedef HRESULT (*pfnPyGatewayConstructor)(PyObject *PythonInstance, PyGatewayBase *, void **ppResult, REFIID iid);
-HRESULT PyCom_MakeRegisteredGatewayObject(REFIID iid, PyObject *instance, PyGatewayBase *base, void **ppv);
-
-// A version of the above which support classes being derived from
-// other than IUnknown
-#define PYGATEWAY_MAKE_SUPPORT2(classname, IInterface, theIID, gatewaybaseclass)                                 \
-   public:                                                                                                       \
-    static HRESULT PyGatewayConstruct(PyObject *pPyInstance, PyGatewayBase *unkBase, void **ppResult,            \
-                                                 REFIID iid)                                                     \
-    {                                                                                                            \
-        if (ppResult == NULL)                                                                                    \
-            return E_INVALIDARG;                                                                                 \
-        classname *newob = new classname(pPyInstance);                                                           \
-        newob->m_pBaseObject = unkBase;                                                                          \
-        if (unkBase)                                                                                             \
-            unkBase->AddRef();                                                                                   \
-        *ppResult = newob->ThisAsIID(iid);                                                                       \
-        return *ppResult ? S_OK : E_OUTOFMEMORY;                                                                 \
-    }                                                                                                            \
-                                                                                                                 \
-   protected:                                                                                                    \
-    virtual IID GetIID(void) { return theIID; }                                                                  \
-    virtual void *ThisAsIID(IID iid)                                                                             \
-    {                                                                                                            \
-        if (this == NULL)                                                                                        \
-            return NULL;                                                                                         \
-        if (iid == theIID)                                                                                       \
-            return (IInterface *)this;                                                                           \
-        else                                                                                                     \
-            return gatewaybaseclass::ThisAsIID(iid);                                                             \
-    }                                                                                                            \
-    STDMETHOD_(ULONG, AddRef)(void) { return gatewaybaseclass::AddRef(); }                                       \
-    STDMETHOD_(ULONG, Release)(void) { return gatewaybaseclass::Release(); }                                     \
-    STDMETHOD(QueryInterface)(REFIID iid, void **obj) { return gatewaybaseclass::QueryInterface(iid, obj); };
-
-// This is the "old" version to use, or use it if you derive
-// directly from PyGatewayBase
-#define PYGATEWAY_MAKE_SUPPORT(classname, IInterface, theIID) \
-    PYGATEWAY_MAKE_SUPPORT2(classname, IInterface, theIID, PyGatewayBase)
-
-#define GET_PYGATEWAY_CTOR(classname) classname::PyGatewayConstruct
-
-#ifdef _MSC_VER
-// Disable an OK warning...
-#pragma warning(disable : 4275)
-// warning C4275: non dll-interface struct 'IDispatch' used as base for dll-interface class 'PyGatewayBase'
-#endif  // _MSC_VER
-
-// Helper interface for fetching a Python object from a gateway
-
-extern const GUID IID_IInternalUnwrapPythonObject;
-
-interface IInternalUnwrapPythonObject : public IUnknown
-{
-   public:
-    STDMETHOD(Unwrap)(PyObject * *ppPyObject) = 0;
-};
-
-/////////////////////////////////////////////////////////////////////////////
-// PyGatewayBase
-//
-// Base class for all gateways.
-//
-class PYCOM_EXPORT PyGatewayBase :
-#ifndef NO_PYCOM_IDISPATCHEX
-    public IDispatchEx,  // IDispatch comes along for the ride!
-#else
-    public IDispatch,  // No IDispatchEx - must explicitely use IDispatch
-#endif
-    public ISupportErrorInfo,
-    public IInternalUnwrapPythonObject {
-   protected:
-    PyGatewayBase(PyObject *instance);
-    virtual ~PyGatewayBase();
-
-    // Invoke the Python method (via the policy object)
-    STDMETHOD(InvokeViaPolicy)(const char *szMethodName, PyObject **ppResult = NULL, const char *szFormat = NULL, ...);
-
-   public:
-    // IUnknown
-    STDMETHOD_(ULONG, AddRef)(void);
-    STDMETHOD_(ULONG, Release)(void);
-    STDMETHOD(QueryInterface)(REFIID iid, void **obj);
-
-    // IDispatch
-    STDMETHOD(GetTypeInfoCount)(UINT FAR *pctInfo);
-    STDMETHOD(GetTypeInfo)(UINT itinfo, LCID lcid, ITypeInfo FAR *FAR *pptInfo);
-    STDMETHOD(GetIDsOfNames)(REFIID refiid, OLECHAR FAR *FAR *rgszNames, UINT cNames, LCID lcid, DISPID FAR *rgdispid);
-    STDMETHOD(Invoke)
-    (DISPID dispid, REFIID riid, LCID lcid, WORD wFlags, DISPPARAMS FAR *params, VARIANT FAR *pVarResult,
-     EXCEPINFO FAR *pexcepinfo, UINT FAR *puArgErr);
-
-    // IDispatchEx
-#ifndef NO_PYCOM_IDISPATCHEX
-    STDMETHOD(GetDispID)(BSTR bstrName, DWORD grfdex, DISPID *pid);
-    STDMETHOD(InvokeEx)
-    (DISPID id, LCID lcid, WORD wFlags, DISPPARAMS *pdp, VARIANT *pvarRes, EXCEPINFO *pei, IServiceProvider *pspCaller);
-    STDMETHOD(DeleteMemberByName)(BSTR bstr, DWORD grfdex);
-    STDMETHOD(DeleteMemberByDispID)(DISPID id);
-    STDMETHOD(GetMemberProperties)(DISPID id, DWORD grfdexFetch, DWORD *pgrfdex);
-    STDMETHOD(GetMemberName)(DISPID id, BSTR *pbstrName);
-    STDMETHOD(GetNextDispID)(DWORD grfdex, DISPID id, DISPID *pid);
-    STDMETHOD(GetNameSpaceParent)(IUnknown **ppunk);
-#endif  // NO_PYCOM_IDISPATCHEX
-    // ISupportErrorInfo
-    STDMETHOD(InterfaceSupportsErrorInfo)(REFIID riid);
-
-    // IInternalUnwrapPythonObject
-    STDMETHOD(Unwrap)(PyObject **ppPyObject);
-
-    // Basically just PYGATEWAY_MAKE_SUPPORT(PyGatewayBase, IDispatch, IID_IDispatch);
-    // but with special handling as its the base class.
-    static HRESULT PyGatewayConstruct(PyObject *pPyInstance, PyGatewayBase *gatewayBase, void **ppResult,
-                                                     REFIID iid)
-    {
-        if (ppResult == NULL)
-            return E_INVALIDARG;
-        PyGatewayBase *obNew = new PyGatewayBase(pPyInstance);
-        obNew->m_pBaseObject = gatewayBase;
-        if (gatewayBase)
-            gatewayBase->AddRef();
-        *ppResult = (IDispatch *)obNew;
-        return *ppResult ? S_OK : E_OUTOFMEMORY;
-    }
-    // Currently this is used only for ISupportErrorInfo,
-    // so hopefully this will never be called in this base class.
-    // (however, this is not a rule, so we wont assert or anything!)
-    virtual IID GetIID(void) { return IID_IUnknown; }
-    virtual void *ThisAsIID(IID iid);
-    // End of PYGATEWAY_MAKE_SUPPORT
-    PyObject *m_pPyObject;
-    PyGatewayBase *m_pBaseObject;
-
-   private:
-    LONG m_cRef;
-};
-
-#ifdef _MSC_VER
-#pragma warning(default : 4275)
-#endif  // _MSC_VER
-
-// B/W compat hack for gateways.
-#define PyCom_HandlePythonFailureToCOM() \
-    PyCom_SetAndLogCOMErrorFromPyExceptionEx(this->m_pPyObject, "<unknown>", GetIID())
-
-// F/W compat hack for gateways!  Must be careful about updating
-// PyGatewayBase vtable, so a slightly older pythoncomXX.dll will work
-// with slightly later extensions.  So use a #define.
-#define MAKE_PYCOM_GATEWAY_FAILURE_CODE(method_name) \
-    PyCom_SetAndLogCOMErrorFromPyExceptionEx(this->m_pPyObject, method_name, GetIID())
-
-#endif /* __PYTHONCOMSERVER_H__ */
diff --git a/lib/win32com/makegw/__init__.py b/lib/win32com/makegw/__init__.py
deleted file mode 100644
index 6178c97c..00000000
--- a/lib/win32com/makegw/__init__.py
+++ /dev/null
@@ -1 +0,0 @@
-# indicates a python package.
diff --git a/lib/win32com/makegw/makegw.py b/lib/win32com/makegw/makegw.py
deleted file mode 100644
index 8d2e83d6..00000000
--- a/lib/win32com/makegw/makegw.py
+++ /dev/null
@@ -1,560 +0,0 @@
-"""Utility functions for writing out gateway C++ files
-
-  This module will generate a C++/Python binding for a specific COM
-  interface.
-  
-  At this stage, no command line interface exists.  You must start Python, 
-  import this module,  change to the directory where the generated code should
-  be written, and run the public function.
-  
-  This module is capable of generating both 'Interfaces' (ie, Python
-  client side support for the interface) and 'Gateways' (ie, Python
-  server side support for the interface).  Many COM interfaces are useful
-  both as Client and Server.  Other interfaces, however, really only make
-  sense to implement one side or the other.  For example, it would be pointless
-  for Python to implement Server side for 'IRunningObjectTable', unless we were
-  implementing core COM for an operating system in Python (hey - now there's an idea!)
-  
-  Most COM interface code is totally boiler-plate - it consists of
-  converting arguments, dispatching the call to Python, and processing
-  any result values.
-  
-  This module automates the generation of such code.  It has the ability to
-  parse a .H file generated by the MIDL tool (ie, almost all COM .h files)
-  and build almost totally complete C++ code.
-  
-  The module understands some of the well known data types, and how to
-  convert them.  There are only a couple of places where hand-editing is
-  necessary, as detailed below:
-
-  unsupported types -- If a type is not known, the generator will
-  pretty much ignore it, but write a comment to the generated code.  You
-  may want to add custom support for this type.  In some cases, C++ compile errors
-  will result.  These are intentional - generating code to remove these errors would
-  imply a false sense of security that the generator has done the right thing.
-
-  other return policies -- By default, Python never sees the return SCODE from
-  a COM function.  The interface usually returns None if OK, else a COM exception
-  if "FAILED(scode)" is TRUE.  You may need to change this if:
-  * EXCEPINFO is passed to the COM function.  This is not detected and handled
-  * For some reason Python should always see the result SCODE, even if it
-    did fail or succeed.  For example, some functions return a BOOLEAN result
-    in the SCODE, meaning Python should always see it.
-  * FAILED(scode) for the interface still has valid data to return (by default,
-    the code generated does not process the return values, and raise an exception
-    to Python/COM
-  
-"""
-
-import re
-
-from . import makegwparse
-
-
-def make_framework_support(
-    header_file_name, interface_name, bMakeInterface=1, bMakeGateway=1
-):
-    """Generate C++ code for a Python Interface and Gateway
-
-    header_file_name -- The full path to the .H file which defines the interface.
-    interface_name -- The name of the interface to search for, and to generate.
-    bMakeInterface = 1 -- Should interface (ie, client) support be generated.
-    bMakeGatewayInterface = 1 -- Should gateway (ie, server) support be generated.
-
-    This method will write a .cpp and .h file into the current directory,
-    (using the name of the interface to build the file name.
-
-    """
-    fin = open(header_file_name)
-    try:
-        interface = makegwparse.parse_interface_info(interface_name, fin)
-    finally:
-        fin.close()
-
-    if bMakeInterface and bMakeGateway:
-        desc = "Interface and Gateway"
-    elif bMakeInterface and not bMakeGateway:
-        desc = "Interface"
-    else:
-        desc = "Gateway"
-    if interface.name[:5] == "IEnum":  # IEnum - use my really simple template-based one
-        import win32com.makegw.makegwenum
-
-        ifc_cpp_writer = win32com.makegw.makegwenum._write_enumifc_cpp
-        gw_cpp_writer = win32com.makegw.makegwenum._write_enumgw_cpp
-    else:  # Use my harder working ones.
-        ifc_cpp_writer = _write_ifc_cpp
-        gw_cpp_writer = _write_gw_cpp
-
-    fout = open("Py%s.cpp" % interface.name, "w")
-    try:
-        fout.write(
-            """\
-// This file implements the %s %s for Python.
-// Generated by makegw.py
-
-#include "shell_pch.h"
-"""
-            % (interface.name, desc)
-        )
-        #    if bMakeGateway:
-        #      fout.write('#include "PythonCOMServer.h"\n')
-        #    if interface.base not in ["IUnknown", "IDispatch"]:
-        #      fout.write('#include "Py%s.h"\n' % interface.base)
-        fout.write(
-            '#include "Py%s.h"\n\n// @doc - This file contains autoduck documentation\n'
-            % interface.name
-        )
-        if bMakeInterface:
-            ifc_cpp_writer(fout, interface)
-        if bMakeGateway:
-            gw_cpp_writer(fout, interface)
-    finally:
-        fout.close()
-    fout = open("Py%s.h" % interface.name, "w")
-    try:
-        fout.write(
-            """\
-// This file declares the %s %s for Python.
-// Generated by makegw.py
-"""
-            % (interface.name, desc)
-        )
-
-        if bMakeInterface:
-            _write_ifc_h(fout, interface)
-        if bMakeGateway:
-            _write_gw_h(fout, interface)
-    finally:
-        fout.close()
-
-
-###########################################################################
-#
-# INTERNAL FUNCTIONS
-#
-#
-
-
-def _write_ifc_h(f, interface):
-    f.write(
-        """\
-// ---------------------------------------------------
-//
-// Interface Declaration
-
-class Py%s : public Py%s
-{
-public:
-	MAKE_PYCOM_CTOR(Py%s);
-	static %s *GetI(PyObject *self);
-	static PyComTypeObject type;
-
-	// The Python methods
-"""
-        % (interface.name, interface.base, interface.name, interface.name)
-    )
-    for method in interface.methods:
-        f.write(
-            "\tstatic PyObject *%s(PyObject *self, PyObject *args);\n" % method.name
-        )
-    f.write(
-        """\
-
-protected:
-	Py%s(IUnknown *pdisp);
-	~Py%s();
-};
-"""
-        % (interface.name, interface.name)
-    )
-
-
-def _write_ifc_cpp(f, interface):
-    name = interface.name
-    f.write(
-        """\
-// ---------------------------------------------------
-//
-// Interface Implementation
-
-Py%(name)s::Py%(name)s(IUnknown *pdisp):
-	Py%(base)s(pdisp)
-{
-	ob_type = &type;
-}
-
-Py%(name)s::~Py%(name)s()
-{
-}
-
-/* static */ %(name)s *Py%(name)s::GetI(PyObject *self)
-{
-	return (%(name)s *)Py%(base)s::GetI(self);
-}
-
-"""
-        % (interface.__dict__)
-    )
-
-    ptr = re.sub("[a-z]", "", interface.name)
-    strdict = {"interfacename": interface.name, "ptr": ptr}
-    for method in interface.methods:
-        strdict["method"] = method.name
-        f.write(
-            """\
-// @pymethod |Py%(interfacename)s|%(method)s|Description of %(method)s.
-PyObject *Py%(interfacename)s::%(method)s(PyObject *self, PyObject *args)
-{
-	%(interfacename)s *p%(ptr)s = GetI(self);
-	if ( p%(ptr)s == NULL )
-		return NULL;
-"""
-            % strdict
-        )
-        argsParseTuple = (
-            argsCOM
-        ) = (
-            formatChars
-        ) = codePost = codePobjects = codeCobjects = cleanup = cleanup_gil = ""
-        needConversion = 0
-        #    if method.name=="Stat": import win32dbg;win32dbg.brk()
-        for arg in method.args:
-            try:
-                argCvt = makegwparse.make_arg_converter(arg)
-                if arg.HasAttribute("in"):
-                    val = argCvt.GetFormatChar()
-                    if val:
-                        f.write("\t" + argCvt.GetAutoduckString() + "\n")
-                        formatChars = formatChars + val
-                        argsParseTuple = (
-                            argsParseTuple + ", " + argCvt.GetParseTupleArg()
-                        )
-                        codePobjects = (
-                            codePobjects + argCvt.DeclareParseArgTupleInputConverter()
-                        )
-                        codePost = codePost + argCvt.GetParsePostCode()
-                        needConversion = needConversion or argCvt.NeedUSES_CONVERSION()
-                        cleanup = cleanup + argCvt.GetInterfaceArgCleanup()
-                        cleanup_gil = cleanup_gil + argCvt.GetInterfaceArgCleanupGIL()
-                comArgName, comArgDeclString = argCvt.GetInterfaceCppObjectInfo()
-                if comArgDeclString:  # If we should declare a variable
-                    codeCobjects = codeCobjects + "\t%s;\n" % (comArgDeclString)
-                argsCOM = argsCOM + ", " + comArgName
-            except makegwparse.error_not_supported as why:
-                f.write(
-                    '// *** The input argument %s of type "%s" was not processed ***\n//     Please check the conversion function is appropriate and exists!\n'
-                    % (arg.name, arg.raw_type)
-                )
-
-                f.write(
-                    "\t%s %s;\n\tPyObject *ob%s;\n" % (arg.type, arg.name, arg.name)
-                )
-                f.write(
-                    "\t// @pyparm <o Py%s>|%s||Description for %s\n"
-                    % (arg.type, arg.name, arg.name)
-                )
-                codePost = (
-                    codePost
-                    + "\tif (bPythonIsHappy && !PyObject_As%s( ob%s, &%s )) bPythonIsHappy = FALSE;\n"
-                    % (arg.type, arg.name, arg.name)
-                )
-
-                formatChars = formatChars + "O"
-                argsParseTuple = argsParseTuple + ", &ob%s" % (arg.name)
-
-                argsCOM = argsCOM + ", " + arg.name
-                cleanup = cleanup + "\tPyObject_Free%s(%s);\n" % (arg.type, arg.name)
-
-        if needConversion:
-            f.write("\tUSES_CONVERSION;\n")
-        f.write(codePobjects)
-        f.write(codeCobjects)
-        f.write(
-            '\tif ( !PyArg_ParseTuple(args, "%s:%s"%s) )\n\t\treturn NULL;\n'
-            % (formatChars, method.name, argsParseTuple)
-        )
-        if codePost:
-            f.write("\tBOOL bPythonIsHappy = TRUE;\n")
-            f.write(codePost)
-            f.write("\tif (!bPythonIsHappy) return NULL;\n")
-        strdict["argsCOM"] = argsCOM[1:]
-        strdict["cleanup"] = cleanup
-        strdict["cleanup_gil"] = cleanup_gil
-        f.write(
-            """	HRESULT hr;
-	PY_INTERFACE_PRECALL;
-	hr = p%(ptr)s->%(method)s(%(argsCOM)s );
-%(cleanup)s
-	PY_INTERFACE_POSTCALL;
-%(cleanup_gil)s
-	if ( FAILED(hr) )
-		return PyCom_BuildPyException(hr, p%(ptr)s, IID_%(interfacename)s );
-"""
-            % strdict
-        )
-        codePre = codePost = formatChars = codeVarsPass = codeDecl = ""
-        for arg in method.args:
-            if not arg.HasAttribute("out"):
-                continue
-            try:
-                argCvt = makegwparse.make_arg_converter(arg)
-                formatChar = argCvt.GetFormatChar()
-                if formatChar:
-                    formatChars = formatChars + formatChar
-                    codePre = codePre + argCvt.GetBuildForInterfacePreCode()
-                    codePost = codePost + argCvt.GetBuildForInterfacePostCode()
-                    codeVarsPass = codeVarsPass + ", " + argCvt.GetBuildValueArg()
-                    codeDecl = codeDecl + argCvt.DeclareParseArgTupleInputConverter()
-            except makegwparse.error_not_supported as why:
-                f.write(
-                    '// *** The output argument %s of type "%s" was not processed ***\n//     %s\n'
-                    % (arg.name, arg.raw_type, why)
-                )
-                continue
-        if formatChars:
-            f.write(
-                '%s\n%s\tPyObject *pyretval = Py_BuildValue("%s"%s);\n%s\treturn pyretval;'
-                % (codeDecl, codePre, formatChars, codeVarsPass, codePost)
-            )
-        else:
-            f.write("\tPy_INCREF(Py_None);\n\treturn Py_None;\n")
-        f.write("\n}\n\n")
-
-    f.write("// @object Py%s|Description of the interface\n" % (name))
-    f.write("static struct PyMethodDef Py%s_methods[] =\n{\n" % name)
-    for method in interface.methods:
-        f.write(
-            '\t{ "%s", Py%s::%s, 1 }, // @pymeth %s|Description of %s\n'
-            % (method.name, interface.name, method.name, method.name, method.name)
-        )
-
-    interfacebase = interface.base
-    f.write(
-        """\
-	{ NULL }
-};
-
-PyComTypeObject Py%(name)s::type("Py%(name)s",
-		&Py%(interfacebase)s::type,
-		sizeof(Py%(name)s),
-		Py%(name)s_methods,
-		GET_PYCOM_CTOR(Py%(name)s));
-"""
-        % locals()
-    )
-
-
-def _write_gw_h(f, interface):
-    if interface.name[0] == "I":
-        gname = "PyG" + interface.name[1:]
-    else:
-        gname = "PyG" + interface.name
-    name = interface.name
-    if interface.base == "IUnknown" or interface.base == "IDispatch":
-        base_name = "PyGatewayBase"
-    else:
-        if interface.base[0] == "I":
-            base_name = "PyG" + interface.base[1:]
-        else:
-            base_name = "PyG" + interface.base
-    f.write(
-        """\
-// ---------------------------------------------------
-//
-// Gateway Declaration
-
-class %s : public %s, public %s
-{
-protected:
-	%s(PyObject *instance) : %s(instance) { ; }
-	PYGATEWAY_MAKE_SUPPORT2(%s, %s, IID_%s, %s)
-
-"""
-        % (gname, base_name, name, gname, base_name, gname, name, name, base_name)
-    )
-    if interface.base != "IUnknown":
-        f.write(
-            "\t// %s\n\t// *** Manually add %s method decls here\n\n"
-            % (interface.base, interface.base)
-        )
-    else:
-        f.write("\n\n")
-
-    f.write("\t// %s\n" % name)
-
-    for method in interface.methods:
-        f.write("\tSTDMETHOD(%s)(\n" % method.name)
-        if method.args:
-            for arg in method.args[:-1]:
-                f.write("\t\t%s,\n" % (arg.GetRawDeclaration()))
-            arg = method.args[-1]
-            f.write("\t\t%s);\n\n" % (arg.GetRawDeclaration()))
-        else:
-            f.write("\t\tvoid);\n\n")
-
-    f.write("};\n")
-    f.close()
-
-
-def _write_gw_cpp(f, interface):
-    if interface.name[0] == "I":
-        gname = "PyG" + interface.name[1:]
-    else:
-        gname = "PyG" + interface.name
-    name = interface.name
-    if interface.base == "IUnknown" or interface.base == "IDispatch":
-        base_name = "PyGatewayBase"
-    else:
-        if interface.base[0] == "I":
-            base_name = "PyG" + interface.base[1:]
-        else:
-            base_name = "PyG" + interface.base
-    f.write(
-        """\
-// ---------------------------------------------------
-//
-// Gateway Implementation
-"""
-        % {"name": name, "gname": gname, "base_name": base_name}
-    )
-
-    for method in interface.methods:
-        f.write(
-            """\
-STDMETHODIMP %s::%s(
-"""
-            % (gname, method.name)
-        )
-
-        if method.args:
-            for arg in method.args[:-1]:
-                inoutstr = "][".join(arg.inout)
-                f.write("\t\t/* [%s] */ %s,\n" % (inoutstr, arg.GetRawDeclaration()))
-
-            arg = method.args[-1]
-            inoutstr = "][".join(arg.inout)
-            f.write("\t\t/* [%s] */ %s)\n" % (inoutstr, arg.GetRawDeclaration()))
-        else:
-            f.write("\t\tvoid)\n")
-
-        f.write("{\n\tPY_GATEWAY_METHOD;\n")
-        cout = 0
-        codePre = codePost = codeVars = ""
-        argStr = ""
-        needConversion = 0
-        formatChars = ""
-        if method.args:
-            for arg in method.args:
-                if arg.HasAttribute("out"):
-                    cout = cout + 1
-                    if arg.indirectionLevel == 2:
-                        f.write("\tif (%s==NULL) return E_POINTER;\n" % arg.name)
-                if arg.HasAttribute("in"):
-                    try:
-                        argCvt = makegwparse.make_arg_converter(arg)
-                        argCvt.SetGatewayMode()
-                        formatchar = argCvt.GetFormatChar()
-                        needConversion = needConversion or argCvt.NeedUSES_CONVERSION()
-
-                        if formatchar:
-                            formatChars = formatChars + formatchar
-                            codeVars = (
-                                codeVars + argCvt.DeclareParseArgTupleInputConverter()
-                            )
-                            argStr = argStr + ", " + argCvt.GetBuildValueArg()
-                        codePre = codePre + argCvt.GetBuildForGatewayPreCode()
-                        codePost = codePost + argCvt.GetBuildForGatewayPostCode()
-                    except makegwparse.error_not_supported as why:
-                        f.write(
-                            '// *** The input argument %s of type "%s" was not processed ***\n//   - Please ensure this conversion function exists, and is appropriate\n//   - %s\n'
-                            % (arg.name, arg.raw_type, why)
-                        )
-                        f.write(
-                            "\tPyObject *ob%s = PyObject_From%s(%s);\n"
-                            % (arg.name, arg.type, arg.name)
-                        )
-                        f.write(
-                            '\tif (ob%s==NULL) return MAKE_PYCOM_GATEWAY_FAILURE_CODE("%s");\n'
-                            % (arg.name, method.name)
-                        )
-                        codePost = codePost + "\tPy_DECREF(ob%s);\n" % arg.name
-                        formatChars = formatChars + "O"
-                        argStr = argStr + ", ob%s" % (arg.name)
-
-        if needConversion:
-            f.write("\tUSES_CONVERSION;\n")
-        f.write(codeVars)
-        f.write(codePre)
-        if cout:
-            f.write("\tPyObject *result;\n")
-            resStr = "&result"
-        else:
-            resStr = "NULL"
-
-        if formatChars:
-            fullArgStr = '%s, "%s"%s' % (resStr, formatChars, argStr)
-        else:
-            fullArgStr = resStr
-
-        f.write('\tHRESULT hr=InvokeViaPolicy("%s", %s);\n' % (method.name, fullArgStr))
-        f.write(codePost)
-        if cout:
-            f.write("\tif (FAILED(hr)) return hr;\n")
-            f.write(
-                "\t// Process the Python results, and convert back to the real params\n"
-            )
-            # process the output arguments.
-            formatChars = codePobjects = codePost = argsParseTuple = ""
-            needConversion = 0
-            for arg in method.args:
-                if not arg.HasAttribute("out"):
-                    continue
-                try:
-                    argCvt = makegwparse.make_arg_converter(arg)
-                    argCvt.SetGatewayMode()
-                    val = argCvt.GetFormatChar()
-                    if val:
-                        formatChars = formatChars + val
-                        argsParseTuple = (
-                            argsParseTuple + ", " + argCvt.GetParseTupleArg()
-                        )
-                        codePobjects = (
-                            codePobjects + argCvt.DeclareParseArgTupleInputConverter()
-                        )
-                        codePost = codePost + argCvt.GetParsePostCode()
-                        needConversion = needConversion or argCvt.NeedUSES_CONVERSION()
-                except makegwparse.error_not_supported as why:
-                    f.write(
-                        '// *** The output argument %s of type "%s" was not processed ***\n//     %s\n'
-                        % (arg.name, arg.raw_type, why)
-                    )
-
-            if formatChars:  # If I have any to actually process.
-                if len(formatChars) == 1:
-                    parseFn = "PyArg_Parse"
-                else:
-                    parseFn = "PyArg_ParseTuple"
-                if codePobjects:
-                    f.write(codePobjects)
-                f.write(
-                    '\tif (!%s(result, "%s" %s))\n\t\treturn MAKE_PYCOM_GATEWAY_FAILURE_CODE("%s");\n'
-                    % (parseFn, formatChars, argsParseTuple, method.name)
-                )
-            if codePost:
-                f.write("\tBOOL bPythonIsHappy = TRUE;\n")
-                f.write(codePost)
-                f.write(
-                    '\tif (!bPythonIsHappy) hr = MAKE_PYCOM_GATEWAY_FAILURE_CODE("%s");\n'
-                    % method.name
-                )
-            f.write("\tPy_DECREF(result);\n")
-        f.write("\treturn hr;\n}\n\n")
-
-
-def test():
-    # 	make_framework_support("d:\\msdev\\include\\objidl.h", "ILockBytes")
-    make_framework_support("d:\\msdev\\include\\objidl.h", "IStorage")
-
-
-# 	make_framework_support("d:\\msdev\\include\\objidl.h", "IEnumSTATSTG")
diff --git a/lib/win32com/makegw/makegwenum.py b/lib/win32com/makegw/makegwenum.py
deleted file mode 100644
index 39c9b2d1..00000000
--- a/lib/win32com/makegw/makegwenum.py
+++ /dev/null
@@ -1,331 +0,0 @@
-"""Utility file for generating PyIEnum support.
-
-This is almost a 'template' file.  It simplay contains almost full
-C++ source code for PyIEnum* support, and the Python code simply
-substitutes the appropriate interface name.
-
-This module is notmally not used directly - the @makegw@ module
-automatically calls this.
-"""
-#
-# INTERNAL FUNCTIONS
-#
-#
-import string
-
-
-def is_interface_enum(enumtype):
-    return not (enumtype[0] in string.uppercase and enumtype[2] in string.uppercase)
-
-
-def _write_enumifc_cpp(f, interface):
-    enumtype = interface.name[5:]
-    if is_interface_enum(enumtype):
-        # Assume an interface.
-        enum_interface = "I" + enumtype[:-1]
-        converter = (
-            "PyObject *ob = PyCom_PyObjectFromIUnknown(rgVar[i], IID_%(enum_interface)s, FALSE);"
-            % locals()
-        )
-        arraydeclare = (
-            "%(enum_interface)s **rgVar = new %(enum_interface)s *[celt];" % locals()
-        )
-    else:
-        # Enum of a simple structure
-        converter = (
-            "PyObject *ob = PyCom_PyObjectFrom%(enumtype)s(&rgVar[i]);" % locals()
-        )
-        arraydeclare = "%(enumtype)s *rgVar = new %(enumtype)s[celt];" % locals()
-
-    f.write(
-        """
-// ---------------------------------------------------
-//
-// Interface Implementation
-
-PyIEnum%(enumtype)s::PyIEnum%(enumtype)s(IUnknown *pdisp):
-	PyIUnknown(pdisp)
-{
-	ob_type = &type;
-}
-
-PyIEnum%(enumtype)s::~PyIEnum%(enumtype)s()
-{
-}
-
-/* static */ IEnum%(enumtype)s *PyIEnum%(enumtype)s::GetI(PyObject *self)
-{
-	return (IEnum%(enumtype)s *)PyIUnknown::GetI(self);
-}
-
-// @pymethod object|PyIEnum%(enumtype)s|Next|Retrieves a specified number of items in the enumeration sequence.
-PyObject *PyIEnum%(enumtype)s::Next(PyObject *self, PyObject *args)
-{
-	long celt = 1;
-	// @pyparm int|num|1|Number of items to retrieve.
-	if ( !PyArg_ParseTuple(args, "|l:Next", &celt) )
-		return NULL;
-
-	IEnum%(enumtype)s *pIE%(enumtype)s = GetI(self);
-	if ( pIE%(enumtype)s == NULL )
-		return NULL;
-
-	%(arraydeclare)s
-	if ( rgVar == NULL ) {
-		PyErr_SetString(PyExc_MemoryError, "allocating result %(enumtype)ss");
-		return NULL;
-	}
-
-	int i;
-/*	for ( i = celt; i--; )
-		// *** possibly init each structure element???
-*/
-
-	ULONG celtFetched = 0;
-	PY_INTERFACE_PRECALL;
-	HRESULT hr = pIE%(enumtype)s->Next(celt, rgVar, &celtFetched);
-	PY_INTERFACE_POSTCALL;
-	if (  HRESULT_CODE(hr) != ERROR_NO_MORE_ITEMS && FAILED(hr) )
-	{
-		delete [] rgVar;
-		return PyCom_BuildPyException(hr,pIE%(enumtype)s, IID_IE%(enumtype)s);
-	}
-
-	PyObject *result = PyTuple_New(celtFetched);
-	if ( result != NULL )
-	{
-		for ( i = celtFetched; i--; )
-		{
-			%(converter)s
-			if ( ob == NULL )
-			{
-				Py_DECREF(result);
-				result = NULL;
-				break;
-			}
-			PyTuple_SET_ITEM(result, i, ob);
-		}
-	}
-
-/*	for ( i = celtFetched; i--; )
-		// *** possibly cleanup each structure element???
-*/
-	delete [] rgVar;
-	return result;
-}
-
-// @pymethod |PyIEnum%(enumtype)s|Skip|Skips over the next specified elementes.
-PyObject *PyIEnum%(enumtype)s::Skip(PyObject *self, PyObject *args)
-{
-	long celt;
-	if ( !PyArg_ParseTuple(args, "l:Skip", &celt) )
-		return NULL;
-
-	IEnum%(enumtype)s *pIE%(enumtype)s = GetI(self);
-	if ( pIE%(enumtype)s == NULL )
-		return NULL;
-
-	PY_INTERFACE_PRECALL;
-	HRESULT hr = pIE%(enumtype)s->Skip(celt);
-	PY_INTERFACE_POSTCALL;
-	if ( FAILED(hr) )
-		return PyCom_BuildPyException(hr, pIE%(enumtype)s, IID_IE%(enumtype)s);
-
-	Py_INCREF(Py_None);
-	return Py_None;
-}
-
-// @pymethod |PyIEnum%(enumtype)s|Reset|Resets the enumeration sequence to the beginning.
-PyObject *PyIEnum%(enumtype)s::Reset(PyObject *self, PyObject *args)
-{
-	if ( !PyArg_ParseTuple(args, ":Reset") )
-		return NULL;
-
-	IEnum%(enumtype)s *pIE%(enumtype)s = GetI(self);
-	if ( pIE%(enumtype)s == NULL )
-		return NULL;
-
-	PY_INTERFACE_PRECALL;
-	HRESULT hr = pIE%(enumtype)s->Reset();
-	PY_INTERFACE_POSTCALL;
-	if ( FAILED(hr) )
-		return PyCom_BuildPyException(hr, pIE%(enumtype)s, IID_IE%(enumtype)s);
-
-	Py_INCREF(Py_None);
-	return Py_None;
-}
-
-// @pymethod <o PyIEnum%(enumtype)s>|PyIEnum%(enumtype)s|Clone|Creates another enumerator that contains the same enumeration state as the current one
-PyObject *PyIEnum%(enumtype)s::Clone(PyObject *self, PyObject *args)
-{
-	if ( !PyArg_ParseTuple(args, ":Clone") )
-		return NULL;
-
-	IEnum%(enumtype)s *pIE%(enumtype)s = GetI(self);
-	if ( pIE%(enumtype)s == NULL )
-		return NULL;
-
-	IEnum%(enumtype)s *pClone;
-	PY_INTERFACE_PRECALL;
-	HRESULT hr = pIE%(enumtype)s->Clone(&pClone);
-	PY_INTERFACE_POSTCALL;
-	if ( FAILED(hr) )
-		return PyCom_BuildPyException(hr, pIE%(enumtype)s, IID_IE%(enumtype)s);
-
-	return PyCom_PyObjectFromIUnknown(pClone, IID_IEnum%(enumtype)s, FALSE);
-}
-
-// @object PyIEnum%(enumtype)s|A Python interface to IEnum%(enumtype)s
-static struct PyMethodDef PyIEnum%(enumtype)s_methods[] =
-{
-	{ "Next", PyIEnum%(enumtype)s::Next, 1 },    // @pymeth Next|Retrieves a specified number of items in the enumeration sequence.
-	{ "Skip", PyIEnum%(enumtype)s::Skip, 1 },	// @pymeth Skip|Skips over the next specified elementes.
-	{ "Reset", PyIEnum%(enumtype)s::Reset, 1 },	// @pymeth Reset|Resets the enumeration sequence to the beginning.
-	{ "Clone", PyIEnum%(enumtype)s::Clone, 1 },	// @pymeth Clone|Creates another enumerator that contains the same enumeration state as the current one.
-	{ NULL }
-};
-
-PyComEnumTypeObject PyIEnum%(enumtype)s::type("PyIEnum%(enumtype)s",
-		&PyIUnknown::type,
-		sizeof(PyIEnum%(enumtype)s),
-		PyIEnum%(enumtype)s_methods,
-		GET_PYCOM_CTOR(PyIEnum%(enumtype)s));
-"""
-        % locals()
-    )
-
-
-def _write_enumgw_cpp(f, interface):
-    enumtype = interface.name[5:]
-    if is_interface_enum(enumtype):
-        # Assume an interface.
-        enum_interface = "I" + enumtype[:-1]
-        converter = (
-            "if ( !PyCom_InterfaceFromPyObject(ob, IID_%(enum_interface)s, (void **)&rgVar[i], FALSE) )"
-            % locals()
-        )
-        argdeclare = "%(enum_interface)s __RPC_FAR * __RPC_FAR *rgVar" % locals()
-    else:
-        argdeclare = "%(enumtype)s __RPC_FAR *rgVar" % locals()
-        converter = "if ( !PyCom_PyObjectAs%(enumtype)s(ob, &rgVar[i]) )" % locals()
-    f.write(
-        """
-// ---------------------------------------------------
-//
-// Gateway Implementation
-
-// Std delegation
-STDMETHODIMP_(ULONG) PyGEnum%(enumtype)s::AddRef(void) {return PyGatewayBase::AddRef();}
-STDMETHODIMP_(ULONG) PyGEnum%(enumtype)s::Release(void) {return PyGatewayBase::Release();}
-STDMETHODIMP PyGEnum%(enumtype)s::QueryInterface(REFIID iid, void ** obj) {return PyGatewayBase::QueryInterface(iid, obj);}
-STDMETHODIMP PyGEnum%(enumtype)s::GetTypeInfoCount(UINT FAR* pctInfo) {return PyGatewayBase::GetTypeInfoCount(pctInfo);}
-STDMETHODIMP PyGEnum%(enumtype)s::GetTypeInfo(UINT itinfo, LCID lcid, ITypeInfo FAR* FAR* pptInfo) {return PyGatewayBase::GetTypeInfo(itinfo, lcid, pptInfo);}
-STDMETHODIMP PyGEnum%(enumtype)s::GetIDsOfNames(REFIID refiid, OLECHAR FAR* FAR* rgszNames, UINT cNames, LCID lcid, DISPID FAR* rgdispid) {return PyGatewayBase::GetIDsOfNames( refiid, rgszNames, cNames, lcid, rgdispid);}
-STDMETHODIMP PyGEnum%(enumtype)s::Invoke(DISPID dispid, REFIID riid, LCID lcid, WORD wFlags, DISPPARAMS FAR* params, VARIANT FAR* pVarResult, EXCEPINFO FAR* pexcepinfo, UINT FAR* puArgErr) {return PyGatewayBase::Invoke( dispid, riid, lcid, wFlags, params, pVarResult, pexcepinfo, puArgErr);}
-
-STDMETHODIMP PyGEnum%(enumtype)s::Next( 
-            /* [in] */ ULONG celt,
-            /* [length_is][size_is][out] */ %(argdeclare)s,
-            /* [out] */ ULONG __RPC_FAR *pCeltFetched)
-{
-	PY_GATEWAY_METHOD;
-	PyObject *result;
-	HRESULT hr = InvokeViaPolicy("Next", &result, "i", celt);
-	if ( FAILED(hr) )
-		return hr;
-
-	if ( !PySequence_Check(result) )
-		goto error;
-	int len;
-	len = PyObject_Length(result);
-	if ( len == -1 )
-		goto error;
-	if ( len > (int)celt)
-		len = celt;
-
-	if ( pCeltFetched )
-		*pCeltFetched = len;
-
-	int i;
-	for ( i = 0; i < len; ++i )
-	{
-		PyObject *ob = PySequence_GetItem(result, i);
-		if ( ob == NULL )
-			goto error;
-
-		%(converter)s
-		{
-			Py_DECREF(result);
-			return PyCom_SetCOMErrorFromPyException(IID_IEnum%(enumtype)s);
-		}
-	}
-
-	Py_DECREF(result);
-
-	return len < (int)celt ? S_FALSE : S_OK;
-
-  error:
-	PyErr_Clear();	// just in case
-	Py_DECREF(result);
-	return PyCom_HandleIEnumNoSequence(IID_IEnum%(enumtype)s);
-}
-
-STDMETHODIMP PyGEnum%(enumtype)s::Skip( 
-            /* [in] */ ULONG celt)
-{
-	PY_GATEWAY_METHOD;
-	return InvokeViaPolicy("Skip", NULL, "i", celt);
-}
-
-STDMETHODIMP PyGEnum%(enumtype)s::Reset(void)
-{
-	PY_GATEWAY_METHOD;
-	return InvokeViaPolicy("Reset");
-}
-
-STDMETHODIMP PyGEnum%(enumtype)s::Clone( 
-            /* [out] */ IEnum%(enumtype)s __RPC_FAR *__RPC_FAR *ppEnum)
-{
-	PY_GATEWAY_METHOD;
-	PyObject * result;
-	HRESULT hr = InvokeViaPolicy("Clone", &result);
-	if ( FAILED(hr) )
-		return hr;
-
-	/*
-	** Make sure we have the right kind of object: we should have some kind
-	** of IUnknown subclass wrapped into a PyIUnknown instance.
-	*/
-	if ( !PyIBase::is_object(result, &PyIUnknown::type) )
-	{
-		/* the wrong kind of object was returned to us */
-		Py_DECREF(result);
-		return PyCom_SetCOMErrorFromSimple(E_FAIL, IID_IEnum%(enumtype)s);
-	}
-
-	/*
-	** Get the IUnknown out of the thing. note that the Python ob maintains
-	** a reference, so we don't have to explicitly AddRef() here.
-	*/
-	IUnknown *punk = ((PyIUnknown *)result)->m_obj;
-	if ( !punk )
-	{
-		/* damn. the object was released. */
-		Py_DECREF(result);
-		return PyCom_SetCOMErrorFromSimple(E_FAIL, IID_IEnum%(enumtype)s);
-	}
-
-	/*
-	** Get the interface we want. note it is returned with a refcount.
-	** This QI is actually going to instantiate a PyGEnum%(enumtype)s.
-	*/
-	hr = punk->QueryInterface(IID_IEnum%(enumtype)s, (LPVOID *)ppEnum);
-
-	/* done with the result; this DECREF is also for <punk> */
-	Py_DECREF(result);
-
-	return PyCom_CheckIEnumNextResult(hr, IID_IEnum%(enumtype)s);
-}
-"""
-        % locals()
-    )
diff --git a/lib/win32com/makegw/makegwparse.py b/lib/win32com/makegw/makegwparse.py
deleted file mode 100644
index 59512f48..00000000
--- a/lib/win32com/makegw/makegwparse.py
+++ /dev/null
@@ -1,1008 +0,0 @@
-"""Utilities for makegw - Parse a header file to build an interface
-
- This module contains the core code for parsing a header file describing a
- COM interface, and building it into an "Interface" structure.
-
- Each Interface has methods, and each method has arguments.
-
- Each argument knows how to use Py_BuildValue or Py_ParseTuple to
- exchange itself with Python.
- 
- See the @win32com.makegw@ module for information in building a COM
- interface
-"""
-import re
-import traceback
-
-
-class error_not_found(Exception):
-    def __init__(self, msg="The requested item could not be found"):
-        super(error_not_found, self).__init__(msg)
-
-
-class error_not_supported(Exception):
-    def __init__(self, msg="The required functionality is not supported"):
-        super(error_not_supported, self).__init__(msg)
-
-
-VERBOSE = 0
-DEBUG = 0
-
-## NOTE : For interfaces as params to work correctly, you must
-## make sure any PythonCOM extensions which expose the interface are loaded
-## before generating.
-
-
-class ArgFormatter:
-    """An instance for a specific type of argument.	 Knows how to convert itself"""
-
-    def __init__(self, arg, builtinIndirection, declaredIndirection=0):
-        # print 'init:', arg.name, builtinIndirection, declaredIndirection, arg.indirectionLevel
-        self.arg = arg
-        self.builtinIndirection = builtinIndirection
-        self.declaredIndirection = declaredIndirection
-        self.gatewayMode = 0
-
-    def _IndirectPrefix(self, indirectionFrom, indirectionTo):
-        """Given the indirection level I was declared at (0=Normal, 1=*, 2=**)
-        return a string prefix so I can pass to a function with the
-        required indirection (where the default is the indirection of the method's param.
-
-        eg, assuming my arg has indirection level of 2, if this function was passed 1
-        it would return "&", so that a variable declared with indirection of 1
-        can be prefixed with this to turn it into the indirection level required of 2
-        """
-        dif = indirectionFrom - indirectionTo
-        if dif == 0:
-            return ""
-        elif dif == -1:
-            return "&"
-        elif dif == 1:
-            return "*"
-        else:
-            return "?? (%d)" % (dif,)
-            raise error_not_supported("Can't indirect this far - please fix me :-)")
-
-    def GetIndirectedArgName(self, indirectFrom, indirectionTo):
-        # print 'get:',self.arg.name, indirectFrom,self._GetDeclaredIndirection() + self.builtinIndirection, indirectionTo, self.arg.indirectionLevel
-
-        if indirectFrom is None:
-            ### ACK! this does not account for [in][out] variables.
-            ### when this method is called, we need to know which
-            indirectFrom = self._GetDeclaredIndirection() + self.builtinIndirection
-
-        return self._IndirectPrefix(indirectFrom, indirectionTo) + self.arg.name
-
-    def GetBuildValueArg(self):
-        "Get the argument to be passes to Py_BuildValue"
-        return self.arg.name
-
-    def GetParseTupleArg(self):
-        "Get the argument to be passed to PyArg_ParseTuple"
-        if self.gatewayMode:
-            # use whatever they were declared with
-            return self.GetIndirectedArgName(None, 1)
-        # local declarations have just their builtin indirection
-        return self.GetIndirectedArgName(self.builtinIndirection, 1)
-
-    def GetInterfaceCppObjectInfo(self):
-        """Provide information about the C++ object used.
-
-        Simple variables (such as integers) can declare their type (eg an integer)
-        and use it as the target of both PyArg_ParseTuple and the COM function itself.
-
-        More complex types require a PyObject * declared as the target of PyArg_ParseTuple,
-        then some conversion routine to the C++ object which is actually passed to COM.
-
-        This method provides the name, and optionally the type of that C++ variable.
-        If the type if provided, the caller will likely generate a variable declaration.
-        The name must always be returned.
-
-        Result is a tuple of (variableName, [DeclareType|None|""])
-        """
-
-        # the first return element is the variable to be passed as
-        # 	 an argument to an interface method. the variable was
-        # 	 declared with only its builtin indirection level. when
-        # 	 we pass it, we'll need to pass in whatever amount of
-        # 	 indirection was applied (plus the builtin amount)
-        # the second return element is the variable declaration; it
-        # 	 should simply be builtin indirection
-        return self.GetIndirectedArgName(
-            self.builtinIndirection, self.arg.indirectionLevel + self.builtinIndirection
-        ), "%s %s" % (self.GetUnconstType(), self.arg.name)
-
-    def GetInterfaceArgCleanup(self):
-        "Return cleanup code for C++ args passed to the interface method."
-        if DEBUG:
-            return "/* GetInterfaceArgCleanup output goes here: %s */\n" % self.arg.name
-        else:
-            return ""
-
-    def GetInterfaceArgCleanupGIL(self):
-        """Return cleanup code for C++ args passed to the interface
-        method that must be executed with the GIL held"""
-        if DEBUG:
-            return (
-                "/* GetInterfaceArgCleanup (GIL held) output goes here: %s */\n"
-                % self.arg.name
-            )
-        else:
-            return ""
-
-    def GetUnconstType(self):
-        return self.arg.unc_type
-
-    def SetGatewayMode(self):
-        self.gatewayMode = 1
-
-    def _GetDeclaredIndirection(self):
-        return self.arg.indirectionLevel
-        print("declared:", self.arg.name, self.gatewayMode)
-        if self.gatewayMode:
-            return self.arg.indirectionLevel
-        else:
-            return self.declaredIndirection
-
-    def DeclareParseArgTupleInputConverter(self):
-        "Declare the variable used as the PyArg_ParseTuple param for a gateway"
-        # Only declare it??
-        # if self.arg.indirectionLevel==0:
-        # 	return "\t%s %s;\n" % (self.arg.type, self.arg.name)
-        # else:
-        if DEBUG:
-            return (
-                "/* Declare ParseArgTupleInputConverter goes here: %s */\n"
-                % self.arg.name
-            )
-        else:
-            return ""
-
-    def GetParsePostCode(self):
-        "Get a string of C++ code to be executed after (ie, to finalise) the PyArg_ParseTuple conversion"
-        if DEBUG:
-            return "/* GetParsePostCode code goes here: %s */\n" % self.arg.name
-        else:
-            return ""
-
-    def GetBuildForInterfacePreCode(self):
-        "Get a string of C++ code to be executed before (ie, to initialise) the Py_BuildValue conversion for Interfaces"
-        if DEBUG:
-            return "/* GetBuildForInterfacePreCode goes here: %s */\n" % self.arg.name
-        else:
-            return ""
-
-    def GetBuildForGatewayPreCode(self):
-        "Get a string of C++ code to be executed before (ie, to initialise) the Py_BuildValue conversion for Gateways"
-        s = self.GetBuildForInterfacePreCode()  # Usually the same
-        if DEBUG:
-            if s[:4] == "/* G":
-                s = "/* GetBuildForGatewayPreCode goes here: %s */\n" % self.arg.name
-        return s
-
-    def GetBuildForInterfacePostCode(self):
-        "Get a string of C++ code to be executed after (ie, to finalise) the Py_BuildValue conversion for Interfaces"
-        if DEBUG:
-            return "/* GetBuildForInterfacePostCode goes here: %s */\n" % self.arg.name
-        return ""
-
-    def GetBuildForGatewayPostCode(self):
-        "Get a string of C++ code to be executed after (ie, to finalise) the Py_BuildValue conversion for Gateways"
-        s = self.GetBuildForInterfacePostCode()  # Usually the same
-        if DEBUG:
-            if s[:4] == "/* G":
-                s = "/* GetBuildForGatewayPostCode goes here: %s */\n" % self.arg.name
-        return s
-
-    def GetAutoduckString(self):
-        return "// @pyparm %s|%s||Description for %s" % (
-            self._GetPythonTypeDesc(),
-            self.arg.name,
-            self.arg.name,
-        )
-
-    def _GetPythonTypeDesc(self):
-        "Returns a string with the description of the type.	 Used for doco purposes"
-        return None
-
-    def NeedUSES_CONVERSION(self):
-        "Determines if this arg forces a USES_CONVERSION macro"
-        return 0
-
-
-# Special formatter for floats since they're smaller than Python floats.
-class ArgFormatterFloat(ArgFormatter):
-    def GetFormatChar(self):
-        return "f"
-
-    def DeclareParseArgTupleInputConverter(self):
-        # Declare a double variable
-        return "\tdouble dbl%s;\n" % self.arg.name
-
-    def GetParseTupleArg(self):
-        return "&dbl" + self.arg.name
-
-    def _GetPythonTypeDesc(self):
-        return "float"
-
-    def GetBuildValueArg(self):
-        return "&dbl" + self.arg.name
-
-    def GetBuildForInterfacePreCode(self):
-        return "\tdbl" + self.arg.name + " = " + self.arg.name + ";\n"
-
-    def GetBuildForGatewayPreCode(self):
-        return (
-            "\tdbl%s = " % self.arg.name
-            + self._IndirectPrefix(self._GetDeclaredIndirection(), 0)
-            + self.arg.name
-            + ";\n"
-        )
-
-    def GetParsePostCode(self):
-        s = "\t"
-        if self.gatewayMode:
-            s = s + self._IndirectPrefix(self._GetDeclaredIndirection(), 0)
-        s = s + self.arg.name
-        s = s + " = (float)dbl%s;\n" % self.arg.name
-        return s
-
-
-# Special formatter for Shorts because they're
-# a different size than Python ints!
-class ArgFormatterShort(ArgFormatter):
-    def GetFormatChar(self):
-        return "i"
-
-    def DeclareParseArgTupleInputConverter(self):
-        # Declare a double variable
-        return "\tINT i%s;\n" % self.arg.name
-
-    def GetParseTupleArg(self):
-        return "&i" + self.arg.name
-
-    def _GetPythonTypeDesc(self):
-        return "int"
-
-    def GetBuildValueArg(self):
-        return "&i" + self.arg.name
-
-    def GetBuildForInterfacePreCode(self):
-        return "\ti" + self.arg.name + " = " + self.arg.name + ";\n"
-
-    def GetBuildForGatewayPreCode(self):
-        return (
-            "\ti%s = " % self.arg.name
-            + self._IndirectPrefix(self._GetDeclaredIndirection(), 0)
-            + self.arg.name
-            + ";\n"
-        )
-
-    def GetParsePostCode(self):
-        s = "\t"
-        if self.gatewayMode:
-            s = s + self._IndirectPrefix(self._GetDeclaredIndirection(), 0)
-        s = s + self.arg.name
-        s = s + " = i%s;\n" % self.arg.name
-        return s
-
-
-# for types which are 64bits on AMD64 - eg, HWND
-class ArgFormatterLONG_PTR(ArgFormatter):
-    def GetFormatChar(self):
-        return "O"
-
-    def DeclareParseArgTupleInputConverter(self):
-        # Declare a PyObject variable
-        return "\tPyObject *ob%s;\n" % self.arg.name
-
-    def GetParseTupleArg(self):
-        return "&ob" + self.arg.name
-
-    def _GetPythonTypeDesc(self):
-        return "int/long"
-
-    def GetBuildValueArg(self):
-        return "ob" + self.arg.name
-
-    def GetBuildForInterfacePostCode(self):
-        return "\tPy_XDECREF(ob%s);\n" % self.arg.name
-
-    def GetParsePostCode(self):
-        return (
-            "\tif (bPythonIsHappy && !PyWinLong_AsULONG_PTR(ob%s, (ULONG_PTR *)%s)) bPythonIsHappy = FALSE;\n"
-            % (self.arg.name, self.GetIndirectedArgName(None, 2))
-        )
-
-    def GetBuildForInterfacePreCode(self):
-        notdirected = self.GetIndirectedArgName(None, 1)
-        return "\tob%s = PyWinObject_FromULONG_PTR(%s);\n" % (
-            self.arg.name,
-            notdirected,
-        )
-
-    def GetBuildForGatewayPostCode(self):
-        return "\tPy_XDECREF(ob%s);\n" % self.arg.name
-
-
-class ArgFormatterPythonCOM(ArgFormatter):
-    """An arg formatter for types exposed in the PythonCOM module"""
-
-    def GetFormatChar(self):
-        return "O"
-
-    # def GetInterfaceCppObjectInfo(self):
-    # 	return ArgFormatter.GetInterfaceCppObjectInfo(self)[0], \
-    # 		"%s %s%s" % (self.arg.unc_type, "*" * self._GetDeclaredIndirection(), self.arg.name)
-    def DeclareParseArgTupleInputConverter(self):
-        # Declare a PyObject variable
-        return "\tPyObject *ob%s;\n" % self.arg.name
-
-    def GetParseTupleArg(self):
-        return "&ob" + self.arg.name
-
-    def _GetPythonTypeDesc(self):
-        return "<o Py%s>" % self.arg.type
-
-    def GetBuildValueArg(self):
-        return "ob" + self.arg.name
-
-    def GetBuildForInterfacePostCode(self):
-        return "\tPy_XDECREF(ob%s);\n" % self.arg.name
-
-
-class ArgFormatterBSTR(ArgFormatterPythonCOM):
-    def _GetPythonTypeDesc(self):
-        return "<o unicode>"
-
-    def GetParsePostCode(self):
-        return (
-            "\tif (bPythonIsHappy && !PyWinObject_AsBstr(ob%s, %s)) bPythonIsHappy = FALSE;\n"
-            % (self.arg.name, self.GetIndirectedArgName(None, 2))
-        )
-
-    def GetBuildForInterfacePreCode(self):
-        notdirected = self.GetIndirectedArgName(None, 1)
-        return "\tob%s = MakeBstrToObj(%s);\n" % (self.arg.name, notdirected)
-
-    def GetBuildForInterfacePostCode(self):
-        return "\tSysFreeString(%s);\n" % (
-            self.arg.name,
-        ) + ArgFormatterPythonCOM.GetBuildForInterfacePostCode(self)
-
-    def GetBuildForGatewayPostCode(self):
-        return "\tPy_XDECREF(ob%s);\n" % self.arg.name
-
-
-class ArgFormatterOLECHAR(ArgFormatterPythonCOM):
-    def _GetPythonTypeDesc(self):
-        return "<o unicode>"
-
-    def GetUnconstType(self):
-        if self.arg.type[:3] == "LPC":
-            return self.arg.type[:2] + self.arg.type[3:]
-        else:
-            return self.arg.unc_type
-
-    def GetParsePostCode(self):
-        return (
-            "\tif (bPythonIsHappy && !PyWinObject_AsBstr(ob%s, %s)) bPythonIsHappy = FALSE;\n"
-            % (self.arg.name, self.GetIndirectedArgName(None, 2))
-        )
-
-    def GetInterfaceArgCleanup(self):
-        return "\tSysFreeString(%s);\n" % self.GetIndirectedArgName(None, 1)
-
-    def GetBuildForInterfacePreCode(self):
-        # the variable was declared with just its builtin indirection
-        notdirected = self.GetIndirectedArgName(self.builtinIndirection, 1)
-        return "\tob%s = MakeOLECHARToObj(%s);\n" % (self.arg.name, notdirected)
-
-    def GetBuildForInterfacePostCode(self):
-        # memory returned into an OLECHAR should be freed
-        return "\tCoTaskMemFree(%s);\n" % (
-            self.arg.name,
-        ) + ArgFormatterPythonCOM.GetBuildForInterfacePostCode(self)
-
-    def GetBuildForGatewayPostCode(self):
-        return "\tPy_XDECREF(ob%s);\n" % self.arg.name
-
-
-class ArgFormatterTCHAR(ArgFormatterPythonCOM):
-    def _GetPythonTypeDesc(self):
-        return "string/<o unicode>"
-
-    def GetUnconstType(self):
-        if self.arg.type[:3] == "LPC":
-            return self.arg.type[:2] + self.arg.type[3:]
-        else:
-            return self.arg.unc_type
-
-    def GetParsePostCode(self):
-        return (
-            "\tif (bPythonIsHappy && !PyWinObject_AsTCHAR(ob%s, %s)) bPythonIsHappy = FALSE;\n"
-            % (self.arg.name, self.GetIndirectedArgName(None, 2))
-        )
-
-    def GetInterfaceArgCleanup(self):
-        return "\tPyWinObject_FreeTCHAR(%s);\n" % self.GetIndirectedArgName(None, 1)
-
-    def GetBuildForInterfacePreCode(self):
-        # the variable was declared with just its builtin indirection
-        notdirected = self.GetIndirectedArgName(self.builtinIndirection, 1)
-        return "\tob%s = PyWinObject_FromTCHAR(%s);\n" % (self.arg.name, notdirected)
-
-    def GetBuildForInterfacePostCode(self):
-        return "// ??? - TCHAR post code\n"
-
-    def GetBuildForGatewayPostCode(self):
-        return "\tPy_XDECREF(ob%s);\n" % self.arg.name
-
-
-class ArgFormatterIID(ArgFormatterPythonCOM):
-    def _GetPythonTypeDesc(self):
-        return "<o PyIID>"
-
-    def GetParsePostCode(self):
-        return "\tif (!PyWinObject_AsIID(ob%s, &%s)) bPythonIsHappy = FALSE;\n" % (
-            self.arg.name,
-            self.arg.name,
-        )
-
-    def GetBuildForInterfacePreCode(self):
-        # 		notdirected = self.GetIndirectedArgName(self.arg.indirectionLevel, 0)
-        notdirected = self.GetIndirectedArgName(None, 0)
-        return "\tob%s = PyWinObject_FromIID(%s);\n" % (self.arg.name, notdirected)
-
-    def GetInterfaceCppObjectInfo(self):
-        return self.arg.name, "IID %s" % (self.arg.name)
-
-
-class ArgFormatterTime(ArgFormatterPythonCOM):
-    def __init__(self, arg, builtinIndirection, declaredIndirection=0):
-        # we don't want to declare LPSYSTEMTIME / LPFILETIME objects
-        if arg.indirectionLevel == 0 and arg.unc_type[:2] == "LP":
-            arg.unc_type = arg.unc_type[2:]
-            # reduce the builtin and increment the declaration
-            arg.indirectionLevel = arg.indirectionLevel + 1
-            builtinIndirection = 0
-        ArgFormatterPythonCOM.__init__(
-            self, arg, builtinIndirection, declaredIndirection
-        )
-
-    def _GetPythonTypeDesc(self):
-        return "<o PyDateTime>"
-
-    def GetParsePostCode(self):
-        # variable was declared with only the builtinIndirection
-        ### NOTE: this is an [in] ... so use only builtin
-        return (
-            '\tif (!PyTime_Check(ob%s)) {\n\t\tPyErr_SetString(PyExc_TypeError, "The argument must be a PyTime object");\n\t\tbPythonIsHappy = FALSE;\n\t}\n\tif (!((PyTime *)ob%s)->GetTime(%s)) bPythonIsHappy = FALSE;\n'
-            % (
-                self.arg.name,
-                self.arg.name,
-                self.GetIndirectedArgName(self.builtinIndirection, 1),
-            )
-        )
-
-    def GetBuildForInterfacePreCode(self):
-        ### use just the builtinIndirection again...
-        notdirected = self.GetIndirectedArgName(self.builtinIndirection, 0)
-        return "\tob%s = new PyTime(%s);\n" % (self.arg.name, notdirected)
-
-    def GetBuildForInterfacePostCode(self):
-        ### hack to determine if we need to free stuff
-        ret = ""
-        if self.builtinIndirection + self.arg.indirectionLevel > 1:
-            # memory returned into an OLECHAR should be freed
-            ret = "\tCoTaskMemFree(%s);\n" % self.arg.name
-        return ret + ArgFormatterPythonCOM.GetBuildForInterfacePostCode(self)
-
-
-class ArgFormatterSTATSTG(ArgFormatterPythonCOM):
-    def _GetPythonTypeDesc(self):
-        return "<o STATSTG>"
-
-    def GetParsePostCode(self):
-        return (
-            "\tif (!PyCom_PyObjectAsSTATSTG(ob%s, %s, 0/*flags*/)) bPythonIsHappy = FALSE;\n"
-            % (self.arg.name, self.GetIndirectedArgName(None, 1))
-        )
-
-    def GetBuildForInterfacePreCode(self):
-        notdirected = self.GetIndirectedArgName(None, 1)
-        return (
-            "\tob%s = PyCom_PyObjectFromSTATSTG(%s);\n\t// STATSTG doco says our responsibility to free\n\tif ((%s).pwcsName) CoTaskMemFree((%s).pwcsName);\n"
-            % (
-                self.arg.name,
-                self.GetIndirectedArgName(None, 1),
-                notdirected,
-                notdirected,
-            )
-        )
-
-
-class ArgFormatterGeneric(ArgFormatterPythonCOM):
-    def _GetPythonTypeDesc(self):
-        return "<o %s>" % self.arg.type
-
-    def GetParsePostCode(self):
-        return "\tif (!PyObject_As%s(ob%s, &%s) bPythonIsHappy = FALSE;\n" % (
-            self.arg.type,
-            self.arg.name,
-            self.GetIndirectedArgName(None, 1),
-        )
-
-    def GetInterfaceArgCleanup(self):
-        return "\tPyObject_Free%s(%s);\n" % (self.arg.type, self.arg.name)
-
-    def GetBuildForInterfacePreCode(self):
-        notdirected = self.GetIndirectedArgName(None, 1)
-        return "\tob%s = PyObject_From%s(%s);\n" % (
-            self.arg.name,
-            self.arg.type,
-            self.GetIndirectedArgName(None, 1),
-        )
-
-
-class ArgFormatterIDLIST(ArgFormatterPythonCOM):
-    def _GetPythonTypeDesc(self):
-        return "<o PyIDL>"
-
-    def GetParsePostCode(self):
-        return (
-            "\tif (bPythonIsHappy && !PyObject_AsPIDL(ob%s, &%s)) bPythonIsHappy = FALSE;\n"
-            % (self.arg.name, self.GetIndirectedArgName(None, 1))
-        )
-
-    def GetInterfaceArgCleanup(self):
-        return "\tPyObject_FreePIDL(%s);\n" % (self.arg.name,)
-
-    def GetBuildForInterfacePreCode(self):
-        notdirected = self.GetIndirectedArgName(None, 1)
-        return "\tob%s = PyObject_FromPIDL(%s);\n" % (
-            self.arg.name,
-            self.GetIndirectedArgName(None, 1),
-        )
-
-
-class ArgFormatterHANDLE(ArgFormatterPythonCOM):
-    def _GetPythonTypeDesc(self):
-        return "<o PyHANDLE>"
-
-    def GetParsePostCode(self):
-        return (
-            "\tif (!PyWinObject_AsHANDLE(ob%s, &%s, FALSE) bPythonIsHappy = FALSE;\n"
-            % (self.arg.name, self.GetIndirectedArgName(None, 1))
-        )
-
-    def GetBuildForInterfacePreCode(self):
-        notdirected = self.GetIndirectedArgName(None, 1)
-        return "\tob%s = PyWinObject_FromHANDLE(%s);\n" % (
-            self.arg.name,
-            self.GetIndirectedArgName(None, 0),
-        )
-
-
-class ArgFormatterLARGE_INTEGER(ArgFormatterPythonCOM):
-    def GetKeyName(self):
-        return "LARGE_INTEGER"
-
-    def _GetPythonTypeDesc(self):
-        return "<o %s>" % self.GetKeyName()
-
-    def GetParsePostCode(self):
-        return "\tif (!PyWinObject_As%s(ob%s, %s)) bPythonIsHappy = FALSE;\n" % (
-            self.GetKeyName(),
-            self.arg.name,
-            self.GetIndirectedArgName(None, 1),
-        )
-
-    def GetBuildForInterfacePreCode(self):
-        notdirected = self.GetIndirectedArgName(None, 0)
-        return "\tob%s = PyWinObject_From%s(%s);\n" % (
-            self.arg.name,
-            self.GetKeyName(),
-            notdirected,
-        )
-
-
-class ArgFormatterULARGE_INTEGER(ArgFormatterLARGE_INTEGER):
-    def GetKeyName(self):
-        return "ULARGE_INTEGER"
-
-
-class ArgFormatterInterface(ArgFormatterPythonCOM):
-    def GetInterfaceCppObjectInfo(self):
-        return self.GetIndirectedArgName(1, self.arg.indirectionLevel), "%s * %s" % (
-            self.GetUnconstType(),
-            self.arg.name,
-        )
-
-    def GetParsePostCode(self):
-        # This gets called for out params in gateway mode
-        if self.gatewayMode:
-            sArg = self.GetIndirectedArgName(None, 2)
-        else:
-            # vs. in params for interface mode.
-            sArg = self.GetIndirectedArgName(1, 2)
-        return (
-            "\tif (bPythonIsHappy && !PyCom_InterfaceFromPyInstanceOrObject(ob%s, IID_%s, (void **)%s, TRUE /* bNoneOK */))\n\t\t bPythonIsHappy = FALSE;\n"
-            % (self.arg.name, self.arg.type, sArg)
-        )
-
-    def GetBuildForInterfacePreCode(self):
-        return "\tob%s = PyCom_PyObjectFromIUnknown(%s, IID_%s, FALSE);\n" % (
-            self.arg.name,
-            self.arg.name,
-            self.arg.type,
-        )
-
-    def GetBuildForGatewayPreCode(self):
-        sPrefix = self._IndirectPrefix(self._GetDeclaredIndirection(), 1)
-        return "\tob%s = PyCom_PyObjectFromIUnknown(%s%s, IID_%s, TRUE);\n" % (
-            self.arg.name,
-            sPrefix,
-            self.arg.name,
-            self.arg.type,
-        )
-
-    def GetInterfaceArgCleanup(self):
-        return "\tif (%s) %s->Release();\n" % (self.arg.name, self.arg.name)
-
-
-class ArgFormatterVARIANT(ArgFormatterPythonCOM):
-    def GetParsePostCode(self):
-        return (
-            "\tif ( !PyCom_VariantFromPyObject(ob%s, %s) )\n\t\tbPythonIsHappy = FALSE;\n"
-            % (self.arg.name, self.GetIndirectedArgName(None, 1))
-        )
-
-    def GetBuildForGatewayPreCode(self):
-        notdirected = self.GetIndirectedArgName(None, 1)
-        return "\tob%s = PyCom_PyObjectFromVariant(%s);\n" % (
-            self.arg.name,
-            notdirected,
-        )
-
-    def GetBuildForGatewayPostCode(self):
-        return "\tPy_XDECREF(ob%s);\n" % self.arg.name
-
-        # Key :		, Python Type Description, ParseTuple format char
-
-
-ConvertSimpleTypes = {
-    "BOOL": ("BOOL", "int", "i"),
-    "UINT": ("UINT", "int", "i"),
-    "BYTE": ("BYTE", "int", "i"),
-    "INT": ("INT", "int", "i"),
-    "DWORD": ("DWORD", "int", "l"),
-    "HRESULT": ("HRESULT", "int", "l"),
-    "ULONG": ("ULONG", "int", "l"),
-    "LONG": ("LONG", "int", "l"),
-    "int": ("int", "int", "i"),
-    "long": ("long", "int", "l"),
-    "DISPID": ("DISPID", "long", "l"),
-    "APPBREAKFLAGS": ("int", "int", "i"),
-    "BREAKRESUMEACTION": ("int", "int", "i"),
-    "ERRORRESUMEACTION": ("int", "int", "i"),
-    "BREAKREASON": ("int", "int", "i"),
-    "BREAKPOINT_STATE": ("int", "int", "i"),
-    "BREAKRESUME_ACTION": ("int", "int", "i"),
-    "SOURCE_TEXT_ATTR": ("int", "int", "i"),
-    "TEXT_DOC_ATTR": ("int", "int", "i"),
-    "QUERYOPTION": ("int", "int", "i"),
-    "PARSEACTION": ("int", "int", "i"),
-}
-
-
-class ArgFormatterSimple(ArgFormatter):
-    """An arg formatter for simple integer etc types"""
-
-    def GetFormatChar(self):
-        return ConvertSimpleTypes[self.arg.type][2]
-
-    def _GetPythonTypeDesc(self):
-        return ConvertSimpleTypes[self.arg.type][1]
-
-
-AllConverters = {
-    "const OLECHAR": (ArgFormatterOLECHAR, 0, 1),
-    "WCHAR": (ArgFormatterOLECHAR, 0, 1),
-    "OLECHAR": (ArgFormatterOLECHAR, 0, 1),
-    "LPCOLESTR": (ArgFormatterOLECHAR, 1, 1),
-    "LPOLESTR": (ArgFormatterOLECHAR, 1, 1),
-    "LPCWSTR": (ArgFormatterOLECHAR, 1, 1),
-    "LPWSTR": (ArgFormatterOLECHAR, 1, 1),
-    "LPCSTR": (ArgFormatterOLECHAR, 1, 1),
-    "LPTSTR": (ArgFormatterTCHAR, 1, 1),
-    "LPCTSTR": (ArgFormatterTCHAR, 1, 1),
-    "HANDLE": (ArgFormatterHANDLE, 0),
-    "BSTR": (ArgFormatterBSTR, 1, 0),
-    "const IID": (ArgFormatterIID, 0),
-    "CLSID": (ArgFormatterIID, 0),
-    "IID": (ArgFormatterIID, 0),
-    "GUID": (ArgFormatterIID, 0),
-    "const GUID": (ArgFormatterIID, 0),
-    "const IID": (ArgFormatterIID, 0),
-    "REFCLSID": (ArgFormatterIID, 0),
-    "REFIID": (ArgFormatterIID, 0),
-    "REFGUID": (ArgFormatterIID, 0),
-    "const FILETIME": (ArgFormatterTime, 0),
-    "const SYSTEMTIME": (ArgFormatterTime, 0),
-    "const LPSYSTEMTIME": (ArgFormatterTime, 1, 1),
-    "LPSYSTEMTIME": (ArgFormatterTime, 1, 1),
-    "FILETIME": (ArgFormatterTime, 0),
-    "SYSTEMTIME": (ArgFormatterTime, 0),
-    "STATSTG": (ArgFormatterSTATSTG, 0),
-    "LARGE_INTEGER": (ArgFormatterLARGE_INTEGER, 0),
-    "ULARGE_INTEGER": (ArgFormatterULARGE_INTEGER, 0),
-    "VARIANT": (ArgFormatterVARIANT, 0),
-    "float": (ArgFormatterFloat, 0),
-    "single": (ArgFormatterFloat, 0),
-    "short": (ArgFormatterShort, 0),
-    "WORD": (ArgFormatterShort, 0),
-    "VARIANT_BOOL": (ArgFormatterShort, 0),
-    "HWND": (ArgFormatterLONG_PTR, 1),
-    "HMENU": (ArgFormatterLONG_PTR, 1),
-    "HOLEMENU": (ArgFormatterLONG_PTR, 1),
-    "HICON": (ArgFormatterLONG_PTR, 1),
-    "HDC": (ArgFormatterLONG_PTR, 1),
-    "LPARAM": (ArgFormatterLONG_PTR, 1),
-    "WPARAM": (ArgFormatterLONG_PTR, 1),
-    "LRESULT": (ArgFormatterLONG_PTR, 1),
-    "UINT": (ArgFormatterShort, 0),
-    "SVSIF": (ArgFormatterShort, 0),
-    "Control": (ArgFormatterInterface, 0, 1),
-    "DataObject": (ArgFormatterInterface, 0, 1),
-    "_PropertyBag": (ArgFormatterInterface, 0, 1),
-    "AsyncProp": (ArgFormatterInterface, 0, 1),
-    "DataSource": (ArgFormatterInterface, 0, 1),
-    "DataFormat": (ArgFormatterInterface, 0, 1),
-    "void **": (ArgFormatterInterface, 2, 2),
-    "ITEMIDLIST": (ArgFormatterIDLIST, 0, 0),
-    "LPITEMIDLIST": (ArgFormatterIDLIST, 0, 1),
-    "LPCITEMIDLIST": (ArgFormatterIDLIST, 0, 1),
-    "const ITEMIDLIST": (ArgFormatterIDLIST, 0, 1),
-}
-
-# Auto-add all the simple types
-for key in ConvertSimpleTypes.keys():
-    AllConverters[key] = ArgFormatterSimple, 0
-
-
-def make_arg_converter(arg):
-    try:
-        clz = AllConverters[arg.type][0]
-        bin = AllConverters[arg.type][1]
-        decl = 0
-        if len(AllConverters[arg.type]) > 2:
-            decl = AllConverters[arg.type][2]
-        return clz(arg, bin, decl)
-    except KeyError:
-        if arg.type[0] == "I":
-            return ArgFormatterInterface(arg, 0, 1)
-
-        raise error_not_supported(
-            "The type '%s' (%s) is unknown." % (arg.type, arg.name)
-        )
-
-
-#############################################################
-#
-# The instances that represent the args, methods and interface
-class Argument:
-    """A representation of an argument to a COM method
-
-    This class contains information about a specific argument to a method.
-    In addition, methods exist so that an argument knows how to convert itself
-    to/from Python arguments.
-    """
-
-    # 									  in,out					  type			  name			 [	]
-    # 								   --------------				--------	  ------------		------
-    regex = re.compile(r"/\* \[([^\]]*.*?)] \*/[ \t](.*[* ]+)(\w+)(\[ *])?[\),]")
-
-    def __init__(self, good_interface_names):
-        self.good_interface_names = good_interface_names
-        self.inout = self.name = self.type = None
-        self.const = 0
-        self.arrayDecl = 0
-
-    def BuildFromFile(self, file):
-        """Parse and build my data from a file
-
-        Reads the next line in the file, and matches it as an argument
-        description.  If not a valid argument line, an error_not_found exception
-        is raised.
-        """
-        line = file.readline()
-        mo = self.regex.search(line)
-        if not mo:
-            raise error_not_found
-        self.name = mo.group(3)
-        self.inout = mo.group(1).split("][")
-        typ = mo.group(2).strip()
-        self.raw_type = typ
-        self.indirectionLevel = 0
-        if mo.group(4):  # Has "[ ]" decl
-            self.arrayDecl = 1
-            try:
-                pos = typ.rindex("__RPC_FAR")
-                self.indirectionLevel = self.indirectionLevel + 1
-                typ = typ[:pos].strip()
-            except ValueError:
-                pass
-
-        typ = typ.replace("__RPC_FAR", "")
-        while 1:
-            try:
-                pos = typ.rindex("*")
-                self.indirectionLevel = self.indirectionLevel + 1
-                typ = typ[:pos].strip()
-            except ValueError:
-                break
-        self.type = typ
-        if self.type[:6] == "const ":
-            self.unc_type = self.type[6:]
-        else:
-            self.unc_type = self.type
-
-        if VERBOSE:
-            print(
-                "	   Arg %s of type %s%s (%s)"
-                % (self.name, self.type, "*" * self.indirectionLevel, self.inout)
-            )
-
-    def HasAttribute(self, typ):
-        """Determines if the argument has the specific attribute.
-
-        Argument attributes are specified in the header file, such as
-        "[in][out][retval]" etc.  You can pass a specific string (eg "out")
-        to find if this attribute was specified for the argument
-        """
-        return typ in self.inout
-
-    def GetRawDeclaration(self):
-        ret = "%s %s" % (self.raw_type, self.name)
-        if self.arrayDecl:
-            ret = ret + "[]"
-        return ret
-
-
-class Method:
-    """A representation of a C++ method on a COM interface
-
-    This class contains information about a specific method, as well as
-    a list of all @Argument@s
-    """
-
-    # 										 options	 ret type callconv	 name
-    # 								   ----------------- -------- -------- --------
-    regex = re.compile(r"virtual (/\*.*?\*/ )?(.*?) (.*?) (.*?)\(\w?")
-
-    def __init__(self, good_interface_names):
-        self.good_interface_names = good_interface_names
-        self.name = self.result = self.callconv = None
-        self.args = []
-
-    def BuildFromFile(self, file):
-        """Parse and build my data from a file
-
-        Reads the next line in the file, and matches it as a method
-        description.  If not a valid method line, an error_not_found exception
-        is raised.
-        """
-        line = file.readline()
-        mo = self.regex.search(line)
-        if not mo:
-            raise error_not_found
-        self.name = mo.group(4)
-        self.result = mo.group(2)
-        if self.result != "HRESULT":
-            if self.result == "DWORD":  # DWORD is for old old stuff?
-                print(
-                    "Warning: Old style interface detected - compilation errors likely!"
-                )
-            else:
-                print(
-                    "Method %s - Only HRESULT return types are supported." % self.name
-                )
-            # 				raise error_not_supported,		if VERBOSE:
-            print("	 Method %s %s(" % (self.result, self.name))
-        while 1:
-            arg = Argument(self.good_interface_names)
-            try:
-                arg.BuildFromFile(file)
-                self.args.append(arg)
-            except error_not_found:
-                break
-
-
-class Interface:
-    """A representation of a C++ COM Interface
-
-    This class contains information about a specific interface, as well as
-    a list of all @Method@s
-    """
-
-    # 									  name				 base
-    # 									 --------		   --------
-    regex = re.compile("(interface|) ([^ ]*) : public (.*)$")
-
-    def __init__(self, mo):
-        self.methods = []
-        self.name = mo.group(2)
-        self.base = mo.group(3)
-        if VERBOSE:
-            print("Interface %s : public %s" % (self.name, self.base))
-
-    def BuildMethods(self, file):
-        """Build all sub-methods for this interface"""
-        # skip the next 2 lines.
-        file.readline()
-        file.readline()
-        while 1:
-            try:
-                method = Method([self.name])
-                method.BuildFromFile(file)
-                self.methods.append(method)
-            except error_not_found:
-                break
-
-
-def find_interface(interfaceName, file):
-    """Find and return an interface in a file
-
-    Given an interface name and file, search for the specified interface.
-
-    Upon return, the interface itself has been built,
-    but not the methods.
-    """
-    interface = None
-    line = file.readline()
-    while line:
-        mo = Interface.regex.search(line)
-        if mo:
-            name = mo.group(2)
-            print(name)
-            AllConverters[name] = (ArgFormatterInterface, 0, 1)
-            if name == interfaceName:
-                interface = Interface(mo)
-                interface.BuildMethods(file)
-        line = file.readline()
-    if interface:
-        return interface
-    raise error_not_found
-
-
-def parse_interface_info(interfaceName, file):
-    """Find, parse and return an interface in a file
-
-    Given an interface name and file, search for the specified interface.
-
-    Upon return, the interface itself is fully built,
-    """
-    try:
-        return find_interface(interfaceName, file)
-    except re.error:
-        traceback.print_exc()
-        print("The interface could not be built, as the regular expression failed!")
-
-
-def test():
-    f = open("d:\\msdev\\include\\objidl.h")
-    try:
-        parse_interface_info("IPersistStream", f)
-    finally:
-        f.close()
-
-
-def test_regex(r, text):
-    res = r.search(text, 0)
-    if res == -1:
-        print("** Not found")
-    else:
-        print(
-            "%d\n%s\n%s\n%s\n%s" % (res, r.group(1), r.group(2), r.group(3), r.group(4))
-        )
diff --git a/lib/win32com/olectl.py b/lib/win32com/olectl.py
deleted file mode 100644
index 50ec6f74..00000000
--- a/lib/win32com/olectl.py
+++ /dev/null
@@ -1,70 +0,0 @@
-"""Constants used by COM Controls
-
-  Hand created version of OLECTL.H constants.
-"""
-
-import winerror
-
-FACILITY_CONTROL = 0xA
-
-
-def MAKE_SCODE(sev, fac, code):
-    return int((int(-sev) << 31) | ((fac) << 16) | ((code)))
-
-
-def STD_CTL_SCODE(n):
-    return MAKE_SCODE(winerror.SEVERITY_ERROR, FACILITY_CONTROL, n)
-
-
-CTL_E_ILLEGALFUNCTIONCALL = STD_CTL_SCODE(5)
-CTL_E_OVERFLOW = STD_CTL_SCODE(6)
-CTL_E_OUTOFMEMORY = STD_CTL_SCODE(7)
-CTL_E_DIVISIONBYZERO = STD_CTL_SCODE(11)
-CTL_E_OUTOFSTRINGSPACE = STD_CTL_SCODE(14)
-CTL_E_OUTOFSTACKSPACE = STD_CTL_SCODE(28)
-CTL_E_BADFILENAMEORNUMBER = STD_CTL_SCODE(52)
-CTL_E_FILENOTFOUND = STD_CTL_SCODE(53)
-CTL_E_BADFILEMODE = STD_CTL_SCODE(54)
-CTL_E_FILEALREADYOPEN = STD_CTL_SCODE(55)
-CTL_E_DEVICEIOERROR = STD_CTL_SCODE(57)
-CTL_E_FILEALREADYEXISTS = STD_CTL_SCODE(58)
-CTL_E_BADRECORDLENGTH = STD_CTL_SCODE(59)
-CTL_E_DISKFULL = STD_CTL_SCODE(61)
-CTL_E_BADRECORDNUMBER = STD_CTL_SCODE(63)
-CTL_E_BADFILENAME = STD_CTL_SCODE(64)
-CTL_E_TOOMANYFILES = STD_CTL_SCODE(67)
-CTL_E_DEVICEUNAVAILABLE = STD_CTL_SCODE(68)
-CTL_E_PERMISSIONDENIED = STD_CTL_SCODE(70)
-CTL_E_DISKNOTREADY = STD_CTL_SCODE(71)
-CTL_E_PATHFILEACCESSERROR = STD_CTL_SCODE(75)
-CTL_E_PATHNOTFOUND = STD_CTL_SCODE(76)
-CTL_E_INVALIDPATTERNSTRING = STD_CTL_SCODE(93)
-CTL_E_INVALIDUSEOFNULL = STD_CTL_SCODE(94)
-CTL_E_INVALIDFILEFORMAT = STD_CTL_SCODE(321)
-CTL_E_INVALIDPROPERTYVALUE = STD_CTL_SCODE(380)
-CTL_E_INVALIDPROPERTYARRAYINDEX = STD_CTL_SCODE(381)
-CTL_E_SETNOTSUPPORTEDATRUNTIME = STD_CTL_SCODE(382)
-CTL_E_SETNOTSUPPORTED = STD_CTL_SCODE(383)
-CTL_E_NEEDPROPERTYARRAYINDEX = STD_CTL_SCODE(385)
-CTL_E_SETNOTPERMITTED = STD_CTL_SCODE(387)
-CTL_E_GETNOTSUPPORTEDATRUNTIME = STD_CTL_SCODE(393)
-CTL_E_GETNOTSUPPORTED = STD_CTL_SCODE(394)
-CTL_E_PROPERTYNOTFOUND = STD_CTL_SCODE(422)
-CTL_E_INVALIDCLIPBOARDFORMAT = STD_CTL_SCODE(460)
-CTL_E_INVALIDPICTURE = STD_CTL_SCODE(481)
-CTL_E_PRINTERERROR = STD_CTL_SCODE(482)
-CTL_E_CANTSAVEFILETOTEMP = STD_CTL_SCODE(735)
-CTL_E_SEARCHTEXTNOTFOUND = STD_CTL_SCODE(744)
-CTL_E_REPLACEMENTSTOOLONG = STD_CTL_SCODE(746)
-
-CONNECT_E_FIRST = MAKE_SCODE(winerror.SEVERITY_ERROR, winerror.FACILITY_ITF, 0x0200)
-CONNECT_E_LAST = MAKE_SCODE(winerror.SEVERITY_ERROR, winerror.FACILITY_ITF, 0x020F)
-CONNECT_S_FIRST = MAKE_SCODE(winerror.SEVERITY_SUCCESS, winerror.FACILITY_ITF, 0x0200)
-CONNECT_S_LAST = MAKE_SCODE(winerror.SEVERITY_SUCCESS, winerror.FACILITY_ITF, 0x020F)
-
-CONNECT_E_NOCONNECTION = CONNECT_E_FIRST + 0
-CONNECT_E_ADVISELIMIT = CONNECT_E_FIRST + 1
-CONNECT_E_CANNOTCONNECT = CONNECT_E_FIRST + 2
-CONNECT_E_OVERRIDDEN = CONNECT_E_FIRST + 3
-
-CLASS_E_NOTLICENSED = winerror.CLASSFACTORY_E_FIRST + 2
diff --git a/lib/win32com/readme.html b/lib/win32com/readme.html
deleted file mode 100644
index 3df75340..00000000
--- a/lib/win32com/readme.html
+++ /dev/null
@@ -1,87 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-  <title>win32com Readme</title>
-</head>
-<body>
- 
-<p><img width="551" height="99" id="_x0000_i1025"
- src="html%5Cimage%5Cpycom_blowing.gif"
- alt="Python and COM - Blowing the others away"> </p>
-    
-<h1>Python COM Extensions Readme </h1>
-    
-<p>This is the readme for win32com. Please check out the <a
- href="html/docindex.html">win32com documentation index</a></p>
-    
-<p>The <a href="test/.">win32com/test directory</a> contains some interesting
- scripts (and a new <a href="test/readme.txt">readme.txt</a>). Although these
- are used for testing, they do show a variety of COM techniques.</p>
-
-<h3>VARIANT objects</h3>
-<p>win32com.client now has explicit VARIANT objects which can be used in
-situations where you need more control over the argument types passed when
-calling COM methods.  See the <a href="html/variant.html">documentation on
-this object</a>
-
-<a name="currency"><h3>Important Currency changes</h3></a>
-<p>
-In all builds prior to 204, a COM currency value was returned as a tuple of
-integers.  Working with 2 integers to represent a currency object was a poor
-choice, but the alternative was never clear.  Now Python ships with the
-<a href="http://www.python.org/dev/doc/devel/lib/module-decimal.html">decimal</a>
-module, the alternative has arrived!
-</p>
-<p>
-Up until build 212, code could set <code>pythoncom.__future_currency__ = True</code>
-to force use of the decimal module, with a warning issued otherwise.  In 
-builds 213 and later, the decimal module is unconditionally used when
-pythoncon returns you a currency value.
-</p>
-
-<h3>Recent Changes</h3>
-
-<h4>Lots of internal changes on the road to py3k</h4>
-
-<h4>win32com.axcontrol and win2con.internet</h4>
-Many more interfaces for hosting AX controls and the interfaces
-used by Internet Explorer.
-
-<h4>win32com.shell</h4>
-The shell interfaces have undergone a number of enhancements and changes.
-A couple of methods have changed signature between the first build with shell support (200) and later builds.  
-SHGetFileInfo was broken in its result handling, so had to be changed - this 
-is the only function used by the samples that changed, but others not used by the samples also have changed.
-These shell interfaces are now generally stable.
-<h4>New win32com.taskscheduler module</h4>
-Roger Upole has contributed an interface to the Windows task scheduler.  This is actually very neat, and it allows
-Python to edit the task list as shown by Windows Control Panel.  Property page suppport may even appear later,
-now that the win32 library has the new win32rcparser module.
-<h4>ActiveX Scripting </h4>
-    
-<p>Python only supports "trusted" execution hosts - thus, it will no longer work
-as an engine inside IE (Python itself no longer has a restricted execution environment).  
-Python continues to work fine as an Active Scripting Engine in all other
-applications, including Windows Scripting Host, and ASP.
-
-<p>There is also support for Python as an ActiveX Scripting Host.</p>
-    
-<p>Active Debugging seems to be fully functional.</p>
-
-<h4>Older stuff</h4>
-<ul>
-</li>
-  <li>Unexpected exceptions in Python COM objects will generally now dump
-the exception and traceback to stdout. &nbsp;This is useful for debugging
-and testing - it means that in some cases there will be no need to register
-an object with <span style="font-style: italic;">--debug</span> to see these
-tracebacks. &nbsp;Note that COM objects used by server processes (such as
-ASP) generally have no valid stdout, so will still need to use <span
- style="font-style: italic;">--debug</span> as usual.<br>
-  </li>
-   <li>universal gateway support has been improved - we can now work as an
-Outlook Addin<br>
-  </li>
-  
-</body>
-</html>
diff --git a/lib/win32com/server/__init__.py b/lib/win32com/server/__init__.py
deleted file mode 100644
index 3348fc9f..00000000
--- a/lib/win32com/server/__init__.py
+++ /dev/null
@@ -1 +0,0 @@
-# Empty __init__ file to designate a sub-package.
diff --git a/lib/win32com/server/connect.py b/lib/win32com/server/connect.py
deleted file mode 100644
index 5c9a2dfe..00000000
--- a/lib/win32com/server/connect.py
+++ /dev/null
@@ -1,84 +0,0 @@
-"""Utilities for Server Side connections.
-
-  A collection of helpers for server side connection points.
-"""
-import pythoncom
-import win32com.server.util
-import winerror
-from win32com import olectl
-
-from .exception import Exception
-
-# Methods implemented by the interfaces.
-IConnectionPointContainer_methods = ["EnumConnectionPoints", "FindConnectionPoint"]
-IConnectionPoint_methods = [
-    "EnumConnections",
-    "Unadvise",
-    "Advise",
-    "GetConnectionPointContainer",
-    "GetConnectionInterface",
-]
-
-
-class ConnectableServer:
-    _public_methods_ = IConnectionPointContainer_methods + IConnectionPoint_methods
-    _com_interfaces_ = [
-        pythoncom.IID_IConnectionPoint,
-        pythoncom.IID_IConnectionPointContainer,
-    ]
-
-    # Clients must set _connect_interfaces_ = [...]
-    def __init__(self):
-        self.cookieNo = 0
-        self.connections = {}
-
-    # IConnectionPoint interfaces
-    def EnumConnections(self):
-        raise Exception(winerror.E_NOTIMPL)
-
-    def GetConnectionInterface(self):
-        raise Exception(winerror.E_NOTIMPL)
-
-    def GetConnectionPointContainer(self):
-        return win32com.server.util.wrap(self)
-
-    def Advise(self, pUnk):
-        # Creates a connection to the client.  Simply allocate a new cookie,
-        # find the clients interface, and store it in a dictionary.
-        try:
-            interface = pUnk.QueryInterface(
-                self._connect_interfaces_[0], pythoncom.IID_IDispatch
-            )
-        except pythoncom.com_error:
-            raise Exception(scode=olectl.CONNECT_E_NOCONNECTION)
-        self.cookieNo = self.cookieNo + 1
-        self.connections[self.cookieNo] = interface
-        return self.cookieNo
-
-    def Unadvise(self, cookie):
-        # Destroy a connection - simply delete interface from the map.
-        try:
-            del self.connections[cookie]
-        except KeyError:
-            raise Exception(scode=winerror.E_UNEXPECTED)
-
-    # IConnectionPointContainer interfaces
-    def EnumConnectionPoints(self):
-        raise Exception(winerror.E_NOTIMPL)
-
-    def FindConnectionPoint(self, iid):
-        # Find a connection we support.  Only support the single event interface.
-        if iid in self._connect_interfaces_:
-            return win32com.server.util.wrap(self)
-
-    def _BroadcastNotify(self, broadcaster, extraArgs):
-        # Broadcasts a notification to all connections.
-        # Ignores clients that fail.
-        for interface in self.connections.values():
-            try:
-                broadcaster(*(interface,) + extraArgs)
-            except pythoncom.com_error as details:
-                self._OnNotifyFail(interface, details)
-
-    def _OnNotifyFail(self, interface, details):
-        print("Ignoring COM error to connection - %s" % (repr(details)))
diff --git a/lib/win32com/server/dispatcher.py b/lib/win32com/server/dispatcher.py
deleted file mode 100644
index ac983125..00000000
--- a/lib/win32com/server/dispatcher.py
+++ /dev/null
@@ -1,291 +0,0 @@
-"""Dispatcher
-
-Please see policy.py for a discussion on dispatchers and policies
-"""
-import traceback
-from sys import exc_info
-
-import pythoncom
-import win32api
-import win32com
-
-#
-from win32com.server.exception import IsCOMServerException
-from win32com.util import IIDToInterfaceName
-
-
-class DispatcherBase:
-    """The base class for all Dispatchers.
-
-    This dispatcher supports wrapping all operations in exception handlers,
-    and all the necessary delegation to the policy.
-
-    This base class supports the printing of "unexpected" exceptions.  Note, however,
-    that exactly where the output of print goes may not be useful!  A derived class may
-    provide additional semantics for this.
-    """
-
-    def __init__(self, policyClass, object):
-        self.policy = policyClass(object)
-        # The logger we should dump to.  If None, we should send to the
-        # default location (typically 'print')
-        self.logger = getattr(win32com, "logger", None)
-
-    # Note the "return self._HandleException_()" is purely to stop pychecker
-    # complaining - _HandleException_ will itself raise an exception for the
-    # pythoncom framework, so the result will never be seen.
-    def _CreateInstance_(self, clsid, reqIID):
-        try:
-            self.policy._CreateInstance_(clsid, reqIID)
-            return pythoncom.WrapObject(self, reqIID)
-        except:
-            return self._HandleException_()
-
-    def _QueryInterface_(self, iid):
-        try:
-            return self.policy._QueryInterface_(iid)
-        except:
-            return self._HandleException_()
-
-    def _Invoke_(self, dispid, lcid, wFlags, args):
-        try:
-            return self.policy._Invoke_(dispid, lcid, wFlags, args)
-        except:
-            return self._HandleException_()
-
-    def _GetIDsOfNames_(self, names, lcid):
-        try:
-            return self.policy._GetIDsOfNames_(names, lcid)
-        except:
-            return self._HandleException_()
-
-    def _GetTypeInfo_(self, index, lcid):
-        try:
-            return self.policy._GetTypeInfo_(index, lcid)
-        except:
-            return self._HandleException_()
-
-    def _GetTypeInfoCount_(self):
-        try:
-            return self.policy._GetTypeInfoCount_()
-        except:
-            return self._HandleException_()
-
-    def _GetDispID_(self, name, fdex):
-        try:
-            return self.policy._GetDispID_(name, fdex)
-        except:
-            return self._HandleException_()
-
-    def _InvokeEx_(self, dispid, lcid, wFlags, args, kwargs, serviceProvider):
-        try:
-            return self.policy._InvokeEx_(
-                dispid, lcid, wFlags, args, kwargs, serviceProvider
-            )
-        except:
-            return self._HandleException_()
-
-    def _DeleteMemberByName_(self, name, fdex):
-        try:
-            return self.policy._DeleteMemberByName_(name, fdex)
-        except:
-            return self._HandleException_()
-
-    def _DeleteMemberByDispID_(self, id):
-        try:
-            return self.policy._DeleteMemberByDispID_(id)
-        except:
-            return self._HandleException_()
-
-    def _GetMemberProperties_(self, id, fdex):
-        try:
-            return self.policy._GetMemberProperties_(id, fdex)
-        except:
-            return self._HandleException_()
-
-    def _GetMemberName_(self, dispid):
-        try:
-            return self.policy._GetMemberName_(dispid)
-        except:
-            return self._HandleException_()
-
-    def _GetNextDispID_(self, fdex, flags):
-        try:
-            return self.policy._GetNextDispID_(fdex, flags)
-        except:
-            return self._HandleException_()
-
-    def _GetNameSpaceParent_(self):
-        try:
-            return self.policy._GetNameSpaceParent_()
-        except:
-            return self._HandleException_()
-
-    def _HandleException_(self):
-        """Called whenever an exception is raised.
-
-        Default behaviour is to print the exception.
-        """
-        # If not a COM exception, print it for the developer.
-        if not IsCOMServerException():
-            if self.logger is not None:
-                self.logger.exception("pythoncom server error")
-            else:
-                traceback.print_exc()
-        # But still raise it for the framework.
-        raise
-
-    def _trace_(self, *args):
-        if self.logger is not None:
-            record = " ".join(map(str, args))
-            self.logger.debug(record)
-        else:
-            for arg in args[:-1]:
-                print(arg, end=" ")
-            print(args[-1])
-
-
-class DispatcherTrace(DispatcherBase):
-    """A dispatcher, which causes a 'print' line for each COM function called."""
-
-    def _QueryInterface_(self, iid):
-        rc = DispatcherBase._QueryInterface_(self, iid)
-        if not rc:
-            self._trace_(
-                "in %s._QueryInterface_ with unsupported IID %s (%s)"
-                % (repr(self.policy._obj_), IIDToInterfaceName(iid), iid)
-            )
-        return rc
-
-    def _GetIDsOfNames_(self, names, lcid):
-        self._trace_("in _GetIDsOfNames_ with '%s' and '%d'\n" % (names, lcid))
-        return DispatcherBase._GetIDsOfNames_(self, names, lcid)
-
-    def _GetTypeInfo_(self, index, lcid):
-        self._trace_("in _GetTypeInfo_ with index=%d, lcid=%d\n" % (index, lcid))
-        return DispatcherBase._GetTypeInfo_(self, index, lcid)
-
-    def _GetTypeInfoCount_(self):
-        self._trace_("in _GetTypeInfoCount_\n")
-        return DispatcherBase._GetTypeInfoCount_(self)
-
-    def _Invoke_(self, dispid, lcid, wFlags, args):
-        self._trace_("in _Invoke_ with", dispid, lcid, wFlags, args)
-        return DispatcherBase._Invoke_(self, dispid, lcid, wFlags, args)
-
-    def _GetDispID_(self, name, fdex):
-        self._trace_("in _GetDispID_ with", name, fdex)
-        return DispatcherBase._GetDispID_(self, name, fdex)
-
-    def _InvokeEx_(self, dispid, lcid, wFlags, args, kwargs, serviceProvider):
-        self._trace_(
-            "in %r._InvokeEx_-%s%r [%x,%s,%r]"
-            % (self.policy._obj_, dispid, args, wFlags, lcid, serviceProvider)
-        )
-        return DispatcherBase._InvokeEx_(
-            self, dispid, lcid, wFlags, args, kwargs, serviceProvider
-        )
-
-    def _DeleteMemberByName_(self, name, fdex):
-        self._trace_("in _DeleteMemberByName_ with", name, fdex)
-        return DispatcherBase._DeleteMemberByName_(self, name, fdex)
-
-    def _DeleteMemberByDispID_(self, id):
-        self._trace_("in _DeleteMemberByDispID_ with", id)
-        return DispatcherBase._DeleteMemberByDispID_(self, id)
-
-    def _GetMemberProperties_(self, id, fdex):
-        self._trace_("in _GetMemberProperties_ with", id, fdex)
-        return DispatcherBase._GetMemberProperties_(self, id, fdex)
-
-    def _GetMemberName_(self, dispid):
-        self._trace_("in _GetMemberName_ with", dispid)
-        return DispatcherBase._GetMemberName_(self, dispid)
-
-    def _GetNextDispID_(self, fdex, flags):
-        self._trace_("in _GetNextDispID_ with", fdex, flags)
-        return DispatcherBase._GetNextDispID_(self, fdex, flags)
-
-    def _GetNameSpaceParent_(self):
-        self._trace_("in _GetNameSpaceParent_")
-        return DispatcherBase._GetNameSpaceParent_(self)
-
-
-class DispatcherWin32trace(DispatcherTrace):
-    """A tracing dispatcher that sends its output to the win32trace remote collector."""
-
-    def __init__(self, policyClass, object):
-        DispatcherTrace.__init__(self, policyClass, object)
-        if self.logger is None:
-            # If we have no logger, setup our output.
-            import win32traceutil  # Sets up everything.
-        self._trace_(
-            "Object with win32trace dispatcher created (object=%s)" % repr(object)
-        )
-
-
-class DispatcherOutputDebugString(DispatcherTrace):
-    """A tracing dispatcher that sends its output to win32api.OutputDebugString"""
-
-    def _trace_(self, *args):
-        for arg in args[:-1]:
-            win32api.OutputDebugString(str(arg) + " ")
-        win32api.OutputDebugString(str(args[-1]) + "\n")
-
-
-class DispatcherWin32dbg(DispatcherBase):
-    """A source-level debugger dispatcher
-
-    A dispatcher which invokes the debugger as an object is instantiated, or
-    when an unexpected exception occurs.
-
-    Requires Pythonwin.
-    """
-
-    def __init__(self, policyClass, ob):
-        # No one uses this, and it just causes py2exe to drag all of
-        # pythonwin in.
-        # import pywin.debugger
-        pywin.debugger.brk()
-        print("The DispatcherWin32dbg dispatcher is deprecated!")
-        print("Please let me know if this is a problem.")
-        print("Uncomment the relevant lines in dispatcher.py to re-enable")
-        # DEBUGGER Note - You can either:
-        # * Hit Run and wait for a (non Exception class) exception to occur!
-        # * Set a breakpoint and hit run.
-        # * Step into the object creation (a few steps away!)
-        DispatcherBase.__init__(self, policyClass, ob)
-
-    def _HandleException_(self):
-        """Invoke the debugger post mortem capability"""
-        # Save details away.
-        typ, val, tb = exc_info()
-        # import pywin.debugger, pywin.debugger.dbgcon
-        debug = 0
-        try:
-            raise typ(val)
-        except Exception:  # AARG - What is this Exception???
-            # Use some inside knowledge to borrow a Debugger option which dictates if we
-            # stop at "expected" exceptions.
-            debug = pywin.debugger.GetDebugger().get_option(
-                pywin.debugger.dbgcon.OPT_STOP_EXCEPTIONS
-            )
-        except:
-            debug = 1
-        if debug:
-            try:
-                pywin.debugger.post_mortem(tb, typ, val)  # The original exception
-            except:
-                traceback.print_exc()
-
-        # But still raise it.
-        del tb
-        raise
-
-
-try:
-    import win32trace
-
-    DefaultDebugDispatcher = DispatcherWin32trace
-except ImportError:  # no win32trace module - just use a print based one.
-    DefaultDebugDispatcher = DispatcherTrace
diff --git a/lib/win32com/server/exception.py b/lib/win32com/server/exception.py
deleted file mode 100644
index e7f4d080..00000000
--- a/lib/win32com/server/exception.py
+++ /dev/null
@@ -1,105 +0,0 @@
-"""Exception Handling
-
- Exceptions
-
-	 To better support COM exceptions, the framework allows for an instance to be
-	 raised.  This instance may have a certain number of known attributes, which are
-	 translated into COM exception details.
-	
-	 This means, for example, that Python could raise a COM exception that includes details
-	 on a Help file and location, and a description for the user.
-	
-	 This module provides a class which provides the necessary attributes.
-
-"""
-import sys
-
-import pythoncom
-
-
-# Note that we derive from com_error, which derives from exceptions.Exception
-# Also note that we dont support "self.args", as we dont support tuple-unpacking
-class COMException(pythoncom.com_error):
-    """An Exception object that is understood by the framework.
-
-    If the framework is presented with an exception of type class,
-    it looks for certain known attributes on this class to provide rich
-    error information to the caller.
-
-    It should be noted that the framework supports providing this error
-    information via COM Exceptions, or via the ISupportErrorInfo interface.
-
-    By using this class, you automatically provide rich error information to the
-    server.
-    """
-
-    def __init__(
-        self,
-        description=None,
-        scode=None,
-        source=None,
-        helpfile=None,
-        helpContext=None,
-        desc=None,
-        hresult=None,
-    ):
-        """Initialize an exception
-        **Params**
-
-        description -- A string description for the exception.
-        scode -- An integer scode to be returned to the server, if necessary.
-        The pythoncom framework defaults this to be DISP_E_EXCEPTION if not specified otherwise.
-        source -- A string which identifies the source of the error.
-        helpfile -- A string which points to a help file which contains details on the error.
-        helpContext -- An integer context in the help file.
-        desc -- A short-cut for description.
-        hresult -- A short-cut for scode.
-        """
-
-        # convert a WIN32 error into an HRESULT
-        scode = scode or hresult
-        if scode and scode != 1:  # We dont want S_FALSE mapped!
-            if scode >= -32768 and scode < 32768:
-                # this is HRESULT_FROM_WIN32()
-                scode = -2147024896 | (scode & 0x0000FFFF)
-        self.scode = scode
-
-        self.description = description or desc
-        if scode == 1 and not self.description:
-            self.description = "S_FALSE"
-        elif scode and not self.description:
-            self.description = pythoncom.GetScodeString(scode)
-
-        self.source = source
-        self.helpfile = helpfile
-        self.helpcontext = helpContext
-
-        # todo - fill in the exception value
-        pythoncom.com_error.__init__(self, scode, self.description, None, -1)
-
-    def __repr__(self):
-        return "<COM Exception - scode=%s, desc=%s>" % (self.scode, self.description)
-
-
-# Old name for the COMException class.
-# Do NOT use the name Exception, as it is now a built-in
-# COMException is the new, official name.
-Exception = COMException
-
-
-def IsCOMException(t=None):
-    if t is None:
-        t = sys.exc_info()[0]
-    try:
-        return issubclass(t, pythoncom.com_error)
-    except TypeError:  # 1.5 in -X mode?
-        return t is pythoncon.com_error
-
-
-def IsCOMServerException(t=None):
-    if t is None:
-        t = sys.exc_info()[0]
-    try:
-        return issubclass(t, COMException)
-    except TypeError:  # String exception
-        return 0
diff --git a/lib/win32com/server/factory.py b/lib/win32com/server/factory.py
deleted file mode 100644
index 7298f799..00000000
--- a/lib/win32com/server/factory.py
+++ /dev/null
@@ -1,26 +0,0 @@
-# Class factory utilities.
-import pythoncom
-
-
-def RegisterClassFactories(clsids, flags=None, clsctx=None):
-    """Given a list of CLSID, create and register class factories.
-
-    Returns a list, which should be passed to RevokeClassFactories
-    """
-    if flags is None:
-        flags = pythoncom.REGCLS_MULTIPLEUSE | pythoncom.REGCLS_SUSPENDED
-    if clsctx is None:
-        clsctx = pythoncom.CLSCTX_LOCAL_SERVER
-    ret = []
-    for clsid in clsids:
-        # Some server append '-Embedding' etc
-        if clsid[0] not in ["-", "/"]:
-            factory = pythoncom.MakePyFactory(clsid)
-            regId = pythoncom.CoRegisterClassObject(clsid, factory, clsctx, flags)
-            ret.append((factory, regId))
-    return ret
-
-
-def RevokeClassFactories(infos):
-    for factory, revokeId in infos:
-        pythoncom.CoRevokeClassObject(revokeId)
diff --git a/lib/win32com/server/localserver.py b/lib/win32com/server/localserver.py
deleted file mode 100644
index 21eeafeb..00000000
--- a/lib/win32com/server/localserver.py
+++ /dev/null
@@ -1,53 +0,0 @@
-# LocalServer .EXE support for Python.
-#
-# This is designed to be used as a _script_ file by pythonw.exe
-#
-# In some cases, you could also use Python.exe, which will create
-# a console window useful for debugging.
-#
-# NOTE: When NOT running in any sort of debugging mode,
-# 'print' statements may fail, as sys.stdout is not valid!!!
-
-#
-# Usage:
-#  wpython.exe LocalServer.py clsid [, clsid]
-import sys
-
-sys.coinit_flags = 2
-import pythoncom
-import win32api
-from win32com.server import factory
-
-usage = """\
-Invalid command line arguments
-
-This program provides LocalServer COM support
-for Python COM objects.
-
-It is typically run automatically by COM, passing as arguments
-The ProgID or CLSID of the Python Server(s) to be hosted
-"""
-
-
-def serve(clsids):
-    infos = factory.RegisterClassFactories(clsids)
-
-    pythoncom.EnableQuitMessage(win32api.GetCurrentThreadId())
-    pythoncom.CoResumeClassObjects()
-
-    pythoncom.PumpMessages()
-
-    factory.RevokeClassFactories(infos)
-
-    pythoncom.CoUninitialize()
-
-
-def main():
-    if len(sys.argv) == 1:
-        win32api.MessageBox(0, usage, "Python COM Server")
-        sys.exit(1)
-    serve(sys.argv[1:])
-
-
-if __name__ == "__main__":
-    main()
diff --git a/lib/win32com/server/policy.py b/lib/win32com/server/policy.py
deleted file mode 100644
index 8105e180..00000000
--- a/lib/win32com/server/policy.py
+++ /dev/null
@@ -1,829 +0,0 @@
-"""Policies 
-
-Note that Dispatchers are now implemented in "dispatcher.py", but
-are still documented here.
-
-Policies
-
- A policy is an object which manages the interaction between a public 
- Python object, and COM .  In simple terms, the policy object is the 
- object which is actually called by COM, and it invokes the requested 
- method, fetches/sets the requested property, etc.  See the 
- @win32com.server.policy.CreateInstance@ method for a description of
- how a policy is specified or created.
-
- Exactly how a policy determines which underlying object method/property 
- is obtained is up to the policy.  A few policies are provided, but you 
- can build your own.  See each policy class for a description of how it 
- implements its policy.
-
- There is a policy that allows the object to specify exactly which 
- methods and properties will be exposed.  There is also a policy that 
- will dynamically expose all Python methods and properties - even those 
- added after the object has been instantiated.
-
-Dispatchers
-
- A Dispatcher is a level in front of a Policy.  A dispatcher is the 
- thing which actually receives the COM calls, and passes them to the 
- policy object (which in turn somehow does something with the wrapped 
- object).
-
- It is important to note that a policy does not need to have a dispatcher.
- A dispatcher has the same interface as a policy, and simply steps in its 
- place, delegating to the real policy.  The primary use for a Dispatcher 
- is to support debugging when necessary, but without imposing overheads 
- when not (ie, by not using a dispatcher at all).
-
- There are a few dispatchers provided - "tracing" dispatchers which simply 
- prints calls and args (including a variation which uses 
- win32api.OutputDebugString), and a "debugger" dispatcher, which can 
- invoke the debugger when necessary.
-
-Error Handling
-
- It is important to realise that the caller of these interfaces may
- not be Python.  Therefore, general Python exceptions and tracebacks aren't 
- much use.
-
- In general, there is an Exception class that should be raised, to allow 
- the framework to extract rich COM type error information.
-
- The general rule is that the **only** exception returned from Python COM 
- Server code should be an Exception instance.  Any other Python exception 
- should be considered an implementation bug in the server (if not, it 
- should be handled, and an appropriate Exception instance raised).  Any 
- other exception is considered "unexpected", and a dispatcher may take 
- special action (see Dispatchers above)
-
- Occasionally, the implementation will raise the policy.error error.  
- This usually means there is a problem in the implementation that the 
- Python programmer should fix.
-
- For example, if policy is asked to wrap an object which it can not 
- support (because, eg, it does not provide _public_methods_ or _dynamic_) 
- then policy.error will be raised, indicating it is a Python programmers 
- problem, rather than a COM error.
- 
-"""
-__author__ = "Greg Stein and Mark Hammond"
-
-import sys
-import types
-
-import pythoncom
-import pywintypes
-import win32api
-import win32con
-import winerror
-
-# Import a few important constants to speed lookups.
-from pythoncom import (
-    DISPATCH_METHOD,
-    DISPATCH_PROPERTYGET,
-    DISPATCH_PROPERTYPUT,
-    DISPATCH_PROPERTYPUTREF,
-    DISPID_COLLECT,
-    DISPID_CONSTRUCTOR,
-    DISPID_DESTRUCTOR,
-    DISPID_EVALUATE,
-    DISPID_NEWENUM,
-    DISPID_PROPERTYPUT,
-    DISPID_STARTENUM,
-    DISPID_UNKNOWN,
-    DISPID_VALUE,
-)
-
-S_OK = 0
-
-# Few more globals to speed things.
-IDispatchType = pythoncom.TypeIIDs[pythoncom.IID_IDispatch]
-IUnknownType = pythoncom.TypeIIDs[pythoncom.IID_IUnknown]
-
-from .exception import COMException
-
-error = __name__ + " error"
-
-regSpec = "CLSID\\%s\\PythonCOM"
-regPolicy = "CLSID\\%s\\PythonCOMPolicy"
-regDispatcher = "CLSID\\%s\\PythonCOMDispatcher"
-regAddnPath = "CLSID\\%s\\PythonCOMPath"
-
-
-def CreateInstance(clsid, reqIID):
-    """Create a new instance of the specified IID
-
-    The COM framework **always** calls this function to create a new
-    instance for the specified CLSID.  This function looks up the
-    registry for the name of a policy, creates the policy, and asks the
-    policy to create the specified object by calling the _CreateInstance_ method.
-
-    Exactly how the policy creates the instance is up to the policy.  See the
-    specific policy documentation for more details.
-    """
-    # First see is sys.path should have something on it.
-    try:
-        addnPaths = win32api.RegQueryValue(
-            win32con.HKEY_CLASSES_ROOT, regAddnPath % clsid
-        ).split(";")
-        for newPath in addnPaths:
-            if newPath not in sys.path:
-                sys.path.insert(0, newPath)
-    except win32api.error:
-        pass
-    try:
-        policy = win32api.RegQueryValue(win32con.HKEY_CLASSES_ROOT, regPolicy % clsid)
-        policy = resolve_func(policy)
-    except win32api.error:
-        policy = DefaultPolicy
-
-    try:
-        dispatcher = win32api.RegQueryValue(
-            win32con.HKEY_CLASSES_ROOT, regDispatcher % clsid
-        )
-        if dispatcher:
-            dispatcher = resolve_func(dispatcher)
-    except win32api.error:
-        dispatcher = None
-
-    if dispatcher:
-        retObj = dispatcher(policy, None)
-    else:
-        retObj = policy(None)
-    return retObj._CreateInstance_(clsid, reqIID)
-
-
-class BasicWrapPolicy:
-    """The base class of policies.
-
-    Normally not used directly (use a child class, instead)
-
-    This policy assumes we are wrapping another object
-    as the COM server.  This supports the delegation of the core COM entry points
-    to either the wrapped object, or to a child class.
-
-    This policy supports the following special attributes on the wrapped object
-
-    _query_interface_ -- A handler which can respond to the COM 'QueryInterface' call.
-    _com_interfaces_ -- An optional list of IIDs which the interface will assume are
-        valid for the object.
-    _invoke_ -- A handler which can respond to the COM 'Invoke' call.  If this attribute
-        is not provided, then the default policy implementation is used.  If this attribute
-        does exist, it is responsible for providing all required functionality - ie, the
-        policy _invoke_ method is not invoked at all (and nor are you able to call it!)
-    _getidsofnames_ -- A handler which can respond to the COM 'GetIDsOfNames' call.  If this attribute
-        is not provided, then the default policy implementation is used.  If this attribute
-        does exist, it is responsible for providing all required functionality - ie, the
-        policy _getidsofnames_ method is not invoked at all (and nor are you able to call it!)
-
-    IDispatchEx functionality:
-
-    _invokeex_ -- Very similar to _invoke_, except slightly different arguments are used.
-        And the result is just the _real_ result (rather than the (hresult, argErr, realResult)
-        tuple that _invoke_ uses.
-        This is the new, prefered handler (the default _invoke_ handler simply called _invokeex_)
-    _getdispid_ -- Very similar to _getidsofnames_, except slightly different arguments are used,
-        and only 1 property at a time can be fetched (which is all we support in getidsofnames anyway!)
-        This is the new, prefered handler (the default _invoke_ handler simply called _invokeex_)
-    _getnextdispid_- uses self._name_to_dispid_ to enumerate the DISPIDs
-    """
-
-    def __init__(self, object):
-        """Initialise the policy object
-
-        Params:
-
-        object -- The object to wrap.  May be None *iff* @BasicWrapPolicy._CreateInstance_@ will be
-        called immediately after this to setup a brand new object
-        """
-        if object is not None:
-            self._wrap_(object)
-
-    def _CreateInstance_(self, clsid, reqIID):
-        """Creates a new instance of a **wrapped** object
-
-        This method looks up a "@win32com.server.policy.regSpec@" % clsid entry
-        in the registry (using @DefaultPolicy@)
-        """
-        try:
-            classSpec = win32api.RegQueryValue(
-                win32con.HKEY_CLASSES_ROOT, regSpec % clsid
-            )
-        except win32api.error:
-            raise error(
-                "The object is not correctly registered - %s key can not be read"
-                % (regSpec % clsid)
-            )
-        myob = call_func(classSpec)
-        self._wrap_(myob)
-        try:
-            return pythoncom.WrapObject(self, reqIID)
-        except pythoncom.com_error as xxx_todo_changeme:
-            (hr, desc, exc, arg) = xxx_todo_changeme.args
-            from win32com.util import IIDToInterfaceName
-
-            desc = (
-                "The object '%r' was created, but does not support the "
-                "interface '%s'(%s): %s"
-                % (myob, IIDToInterfaceName(reqIID), reqIID, desc)
-            )
-            raise pythoncom.com_error(hr, desc, exc, arg)
-
-    def _wrap_(self, object):
-        """Wraps up the specified object.
-
-        This function keeps a reference to the passed
-        object, and may interogate it to determine how to respond to COM requests, etc.
-        """
-        # We "clobber" certain of our own methods with ones
-        # provided by the wrapped object, iff they exist.
-        self._name_to_dispid_ = {}
-        ob = self._obj_ = object
-        if hasattr(ob, "_query_interface_"):
-            self._query_interface_ = ob._query_interface_
-
-        if hasattr(ob, "_invoke_"):
-            self._invoke_ = ob._invoke_
-
-        if hasattr(ob, "_invokeex_"):
-            self._invokeex_ = ob._invokeex_
-
-        if hasattr(ob, "_getidsofnames_"):
-            self._getidsofnames_ = ob._getidsofnames_
-
-        if hasattr(ob, "_getdispid_"):
-            self._getdispid_ = ob._getdispid_
-
-        # Allow for override of certain special attributes.
-        if hasattr(ob, "_com_interfaces_"):
-            self._com_interfaces_ = []
-            # Allow interfaces to be specified by name.
-            for i in ob._com_interfaces_:
-                if type(i) != pywintypes.IIDType:
-                    # Prolly a string!
-                    if i[0] != "{":
-                        i = pythoncom.InterfaceNames[i]
-                    else:
-                        i = pythoncom.MakeIID(i)
-                self._com_interfaces_.append(i)
-        else:
-            self._com_interfaces_ = []
-
-    # "QueryInterface" handling.
-    def _QueryInterface_(self, iid):
-        """The main COM entry-point for QueryInterface.
-
-        This checks the _com_interfaces_ attribute and if the interface is not specified
-        there, it calls the derived helper _query_interface_
-        """
-        if iid in self._com_interfaces_:
-            return 1
-        return self._query_interface_(iid)
-
-    def _query_interface_(self, iid):
-        """Called if the object does not provide the requested interface in _com_interfaces_,
-        and does not provide a _query_interface_ handler.
-
-        Returns a result to the COM framework indicating the interface is not supported.
-        """
-        return 0
-
-    # "Invoke" handling.
-    def _Invoke_(self, dispid, lcid, wFlags, args):
-        """The main COM entry-point for Invoke.
-
-        This calls the _invoke_ helper.
-        """
-        # Translate a possible string dispid to real dispid.
-        if type(dispid) == type(""):
-            try:
-                dispid = self._name_to_dispid_[dispid.lower()]
-            except KeyError:
-                raise COMException(
-                    scode=winerror.DISP_E_MEMBERNOTFOUND, desc="Member not found"
-                )
-        return self._invoke_(dispid, lcid, wFlags, args)
-
-    def _invoke_(self, dispid, lcid, wFlags, args):
-        # Delegates to the _invokeex_ implementation.  This allows
-        # a custom policy to define _invokeex_, and automatically get _invoke_ too.
-        return S_OK, -1, self._invokeex_(dispid, lcid, wFlags, args, None, None)
-
-    # "GetIDsOfNames" handling.
-    def _GetIDsOfNames_(self, names, lcid):
-        """The main COM entry-point for GetIDsOfNames.
-
-        This checks the validity of the arguments, and calls the _getidsofnames_ helper.
-        """
-        if len(names) > 1:
-            raise COMException(
-                scode=winerror.DISP_E_INVALID,
-                desc="Cannot support member argument names",
-            )
-        return self._getidsofnames_(names, lcid)
-
-    def _getidsofnames_(self, names, lcid):
-        ### note: lcid is being ignored...
-        return (self._getdispid_(names[0], 0),)
-
-    # IDispatchEx support for policies.  Most of the IDispathEx functionality
-    # by default will raise E_NOTIMPL.  Thus it is not necessary for derived
-    # policies to explicitely implement all this functionality just to not implement it!
-
-    def _GetDispID_(self, name, fdex):
-        return self._getdispid_(name, fdex)
-
-    def _getdispid_(self, name, fdex):
-        try:
-            ### TODO - look at the fdex flags!!!
-            return self._name_to_dispid_[name.lower()]
-        except KeyError:
-            raise COMException(scode=winerror.DISP_E_UNKNOWNNAME)
-
-    # "InvokeEx" handling.
-    def _InvokeEx_(self, dispid, lcid, wFlags, args, kwargs, serviceProvider):
-        """The main COM entry-point for InvokeEx.
-
-        This calls the _invokeex_ helper.
-        """
-        # Translate a possible string dispid to real dispid.
-        if type(dispid) == type(""):
-            try:
-                dispid = self._name_to_dispid_[dispid.lower()]
-            except KeyError:
-                raise COMException(
-                    scode=winerror.DISP_E_MEMBERNOTFOUND, desc="Member not found"
-                )
-        return self._invokeex_(dispid, lcid, wFlags, args, kwargs, serviceProvider)
-
-    def _invokeex_(self, dispid, lcid, wFlags, args, kwargs, serviceProvider):
-        """A stub for _invokeex_ - should never be called.
-
-        Simply raises an exception.
-        """
-        # Base classes should override this method (and not call the base)
-        raise error("This class does not provide _invokeex_ semantics")
-
-    def _DeleteMemberByName_(self, name, fdex):
-        return self._deletememberbyname_(name, fdex)
-
-    def _deletememberbyname_(self, name, fdex):
-        raise COMException(scode=winerror.E_NOTIMPL)
-
-    def _DeleteMemberByDispID_(self, id):
-        return self._deletememberbydispid(id)
-
-    def _deletememberbydispid_(self, id):
-        raise COMException(scode=winerror.E_NOTIMPL)
-
-    def _GetMemberProperties_(self, id, fdex):
-        return self._getmemberproperties_(id, fdex)
-
-    def _getmemberproperties_(self, id, fdex):
-        raise COMException(scode=winerror.E_NOTIMPL)
-
-    def _GetMemberName_(self, dispid):
-        return self._getmembername_(dispid)
-
-    def _getmembername_(self, dispid):
-        raise COMException(scode=winerror.E_NOTIMPL)
-
-    def _GetNextDispID_(self, fdex, dispid):
-        return self._getnextdispid_(fdex, dispid)
-
-    def _getnextdispid_(self, fdex, dispid):
-        ids = list(self._name_to_dispid_.values())
-        ids.sort()
-        if DISPID_STARTENUM in ids:
-            ids.remove(DISPID_STARTENUM)
-        if dispid == DISPID_STARTENUM:
-            return ids[0]
-        else:
-            try:
-                return ids[ids.index(dispid) + 1]
-            except ValueError:  # dispid not in list?
-                raise COMException(scode=winerror.E_UNEXPECTED)
-            except IndexError:  # No more items
-                raise COMException(scode=winerror.S_FALSE)
-
-    def _GetNameSpaceParent_(self):
-        return self._getnamespaceparent()
-
-    def _getnamespaceparent_(self):
-        raise COMException(scode=winerror.E_NOTIMPL)
-
-
-class MappedWrapPolicy(BasicWrapPolicy):
-    """Wraps an object using maps to do its magic
-
-    This policy wraps up a Python object, using a number of maps
-    which translate from a Dispatch ID and flags, into an object to call/getattr, etc.
-
-    It is the responsibility of derived classes to determine exactly how the
-    maps are filled (ie, the derived classes determine the map filling policy.
-
-    This policy supports the following special attributes on the wrapped object
-
-    _dispid_to_func_/_dispid_to_get_/_dispid_to_put_ -- These are dictionaries
-      (keyed by integer dispid, values are string attribute names) which the COM
-      implementation uses when it is processing COM requests.  Note that the implementation
-      uses this dictionary for its own purposes - not a copy - which means the contents of
-      these dictionaries will change as the object is used.
-
-    """
-
-    def _wrap_(self, object):
-        BasicWrapPolicy._wrap_(self, object)
-        ob = self._obj_
-        if hasattr(ob, "_dispid_to_func_"):
-            self._dispid_to_func_ = ob._dispid_to_func_
-        else:
-            self._dispid_to_func_ = {}
-        if hasattr(ob, "_dispid_to_get_"):
-            self._dispid_to_get_ = ob._dispid_to_get_
-        else:
-            self._dispid_to_get_ = {}
-        if hasattr(ob, "_dispid_to_put_"):
-            self._dispid_to_put_ = ob._dispid_to_put_
-        else:
-            self._dispid_to_put_ = {}
-
-    def _getmembername_(self, dispid):
-        if dispid in self._dispid_to_func_:
-            return self._dispid_to_func_[dispid]
-        elif dispid in self._dispid_to_get_:
-            return self._dispid_to_get_[dispid]
-        elif dispid in self._dispid_to_put_:
-            return self._dispid_to_put_[dispid]
-        else:
-            raise COMException(scode=winerror.DISP_E_MEMBERNOTFOUND)
-
-
-class DesignatedWrapPolicy(MappedWrapPolicy):
-    """A policy which uses a mapping to link functions and dispid
-
-     A MappedWrappedPolicy which allows the wrapped object to specify, via certain
-     special named attributes, exactly which methods and properties are exposed.
-
-     All a wrapped object need do is provide the special attributes, and the policy
-     will handle everything else.
-
-     Attributes:
-
-     _public_methods_ -- Required, unless a typelib GUID is given -- A list
-                  of strings, which must be the names of methods the object
-                  provides.  These methods will be exposed and callable
-                  from other COM hosts.
-     _public_attrs_ A list of strings, which must be the names of attributes on the object.
-                  These attributes will be exposed and readable and possibly writeable from other COM hosts.
-     _readonly_attrs_ -- A list of strings, which must also appear in _public_attrs.  These
-                  attributes will be readable, but not writable, by other COM hosts.
-     _value_ -- A method that will be called if the COM host requests the "default" method
-                  (ie, calls Invoke with dispid==DISPID_VALUE)
-     _NewEnum -- A method that will be called if the COM host requests an enumerator on the
-                  object (ie, calls Invoke with dispid==DISPID_NEWENUM.)
-                  It is the responsibility of the method to ensure the returned
-                  object conforms to the required Enum interface.
-
-    _typelib_guid_ -- The GUID of the typelibrary with interface definitions we use.
-    _typelib_version_ -- A tuple of (major, minor) with a default of 1,1
-    _typelib_lcid_ -- The LCID of the typelib, default = LOCALE_USER_DEFAULT
-
-     _Evaluate -- Dunno what this means, except the host has called Invoke with dispid==DISPID_EVALUATE!
-                  See the COM documentation for details.
-    """
-
-    def _wrap_(self, ob):
-        # If we have nominated universal interfaces to support, load them now
-        tlb_guid = getattr(ob, "_typelib_guid_", None)
-        if tlb_guid is not None:
-            tlb_major, tlb_minor = getattr(ob, "_typelib_version_", (1, 0))
-            tlb_lcid = getattr(ob, "_typelib_lcid_", 0)
-            from win32com import universal
-
-            # XXX - what if the user wants to implement interfaces from multiple
-            # typelibs?
-            # Filter out all 'normal' IIDs (ie, IID objects and strings starting with {
-            interfaces = [
-                i
-                for i in getattr(ob, "_com_interfaces_", [])
-                if type(i) != pywintypes.IIDType and not i.startswith("{")
-            ]
-            universal_data = universal.RegisterInterfaces(
-                tlb_guid, tlb_lcid, tlb_major, tlb_minor, interfaces
-            )
-        else:
-            universal_data = []
-        MappedWrapPolicy._wrap_(self, ob)
-        if not hasattr(ob, "_public_methods_") and not hasattr(ob, "_typelib_guid_"):
-            raise error(
-                "Object does not support DesignatedWrapPolicy, as it does not have either _public_methods_ or _typelib_guid_ attributes."
-            )
-
-        # Copy existing _dispid_to_func_ entries to _name_to_dispid_
-        for dispid, name in self._dispid_to_func_.items():
-            self._name_to_dispid_[name.lower()] = dispid
-        for dispid, name in self._dispid_to_get_.items():
-            self._name_to_dispid_[name.lower()] = dispid
-        for dispid, name in self._dispid_to_put_.items():
-            self._name_to_dispid_[name.lower()] = dispid
-
-        # Patch up the universal stuff.
-        for dispid, invkind, name in universal_data:
-            self._name_to_dispid_[name.lower()] = dispid
-            if invkind == DISPATCH_METHOD:
-                self._dispid_to_func_[dispid] = name
-            elif invkind in (DISPATCH_PROPERTYPUT, DISPATCH_PROPERTYPUTREF):
-                self._dispid_to_put_[dispid] = name
-            elif invkind == DISPATCH_PROPERTYGET:
-                self._dispid_to_get_[dispid] = name
-            else:
-                raise ValueError("unexpected invkind: %d (%s)" % (invkind, name))
-
-        # look for reserved methods
-        if hasattr(ob, "_value_"):
-            self._dispid_to_get_[DISPID_VALUE] = "_value_"
-            self._dispid_to_put_[DISPID_PROPERTYPUT] = "_value_"
-        if hasattr(ob, "_NewEnum"):
-            self._name_to_dispid_["_newenum"] = DISPID_NEWENUM
-            self._dispid_to_func_[DISPID_NEWENUM] = "_NewEnum"
-        if hasattr(ob, "_Evaluate"):
-            self._name_to_dispid_["_evaluate"] = DISPID_EVALUATE
-            self._dispid_to_func_[DISPID_EVALUATE] = "_Evaluate"
-
-        next_dispid = self._allocnextdispid(999)
-        # note: funcs have precedence over attrs (install attrs first)
-        if hasattr(ob, "_public_attrs_"):
-            if hasattr(ob, "_readonly_attrs_"):
-                readonly = ob._readonly_attrs_
-            else:
-                readonly = []
-            for name in ob._public_attrs_:
-                dispid = self._name_to_dispid_.get(name.lower())
-                if dispid is None:
-                    dispid = next_dispid
-                    self._name_to_dispid_[name.lower()] = dispid
-                    next_dispid = self._allocnextdispid(next_dispid)
-                self._dispid_to_get_[dispid] = name
-                if name not in readonly:
-                    self._dispid_to_put_[dispid] = name
-        for name in getattr(ob, "_public_methods_", []):
-            dispid = self._name_to_dispid_.get(name.lower())
-            if dispid is None:
-                dispid = next_dispid
-                self._name_to_dispid_[name.lower()] = dispid
-                next_dispid = self._allocnextdispid(next_dispid)
-            self._dispid_to_func_[dispid] = name
-        self._typeinfos_ = None  # load these on demand.
-
-    def _build_typeinfos_(self):
-        # Can only ever be one for now.
-        tlb_guid = getattr(self._obj_, "_typelib_guid_", None)
-        if tlb_guid is None:
-            return []
-        tlb_major, tlb_minor = getattr(self._obj_, "_typelib_version_", (1, 0))
-        tlb = pythoncom.LoadRegTypeLib(tlb_guid, tlb_major, tlb_minor)
-        typecomp = tlb.GetTypeComp()
-        # Not 100% sure what semantics we should use for the default interface.
-        # Look for the first name in _com_interfaces_ that exists in the typelib.
-        for iname in self._obj_._com_interfaces_:
-            try:
-                type_info, type_comp = typecomp.BindType(iname)
-                if type_info is not None:
-                    return [type_info]
-            except pythoncom.com_error:
-                pass
-        return []
-
-    def _GetTypeInfoCount_(self):
-        if self._typeinfos_ is None:
-            self._typeinfos_ = self._build_typeinfos_()
-        return len(self._typeinfos_)
-
-    def _GetTypeInfo_(self, index, lcid):
-        if self._typeinfos_ is None:
-            self._typeinfos_ = self._build_typeinfos_()
-        if index < 0 or index >= len(self._typeinfos_):
-            raise COMException(scode=winerror.DISP_E_BADINDEX)
-        return 0, self._typeinfos_[index]
-
-    def _allocnextdispid(self, last_dispid):
-        while 1:
-            last_dispid = last_dispid + 1
-            if (
-                last_dispid not in self._dispid_to_func_
-                and last_dispid not in self._dispid_to_get_
-                and last_dispid not in self._dispid_to_put_
-            ):
-                return last_dispid
-
-    def _invokeex_(self, dispid, lcid, wFlags, args, kwArgs, serviceProvider):
-        ### note: lcid is being ignored...
-
-        if wFlags & DISPATCH_METHOD:
-            try:
-                funcname = self._dispid_to_func_[dispid]
-            except KeyError:
-                if not wFlags & DISPATCH_PROPERTYGET:
-                    raise COMException(
-                        scode=winerror.DISP_E_MEMBERNOTFOUND
-                    )  # not found
-            else:
-                try:
-                    func = getattr(self._obj_, funcname)
-                except AttributeError:
-                    # May have a dispid, but that doesnt mean we have the function!
-                    raise COMException(scode=winerror.DISP_E_MEMBERNOTFOUND)
-                # Should check callable here
-                try:
-                    return func(*args)
-                except TypeError as v:
-                    # Particularly nasty is "wrong number of args" type error
-                    # This helps you see what 'func' and 'args' actually is
-                    if str(v).find("arguments") >= 0:
-                        print(
-                            "** TypeError %s calling function %r(%r)" % (v, func, args)
-                        )
-                    raise
-
-        if wFlags & DISPATCH_PROPERTYGET:
-            try:
-                name = self._dispid_to_get_[dispid]
-            except KeyError:
-                raise COMException(scode=winerror.DISP_E_MEMBERNOTFOUND)  # not found
-            retob = getattr(self._obj_, name)
-            if type(retob) == types.MethodType:  # a method as a property - call it.
-                retob = retob(*args)
-            return retob
-
-        if wFlags & (DISPATCH_PROPERTYPUT | DISPATCH_PROPERTYPUTREF):  ### correct?
-            try:
-                name = self._dispid_to_put_[dispid]
-            except KeyError:
-                raise COMException(scode=winerror.DISP_E_MEMBERNOTFOUND)  # read-only
-            # If we have a method of that name (ie, a property get function), and
-            # we have an equiv. property set function, use that instead.
-            if (
-                type(getattr(self._obj_, name, None)) == types.MethodType
-                and type(getattr(self._obj_, "Set" + name, None)) == types.MethodType
-            ):
-                fn = getattr(self._obj_, "Set" + name)
-                fn(*args)
-            else:
-                # just set the attribute
-                setattr(self._obj_, name, args[0])
-            return
-
-        raise COMException(scode=winerror.E_INVALIDARG, desc="invalid wFlags")
-
-
-class EventHandlerPolicy(DesignatedWrapPolicy):
-    """The default policy used by event handlers in the win32com.client package.
-
-    In addition to the base policy, this provides argument conversion semantics for
-    params
-      * dispatch params are converted to dispatch objects.
-      * Unicode objects are converted to strings (1.5.2 and earlier)
-
-    NOTE: Later, we may allow the object to override this process??
-    """
-
-    def _transform_args_(self, args, kwArgs, dispid, lcid, wFlags, serviceProvider):
-        ret = []
-        for arg in args:
-            arg_type = type(arg)
-            if arg_type == IDispatchType:
-                import win32com.client
-
-                arg = win32com.client.Dispatch(arg)
-            elif arg_type == IUnknownType:
-                try:
-                    import win32com.client
-
-                    arg = win32com.client.Dispatch(
-                        arg.QueryInterface(pythoncom.IID_IDispatch)
-                    )
-                except pythoncom.error:
-                    pass  # Keep it as IUnknown
-            ret.append(arg)
-        return tuple(ret), kwArgs
-
-    def _invokeex_(self, dispid, lcid, wFlags, args, kwArgs, serviceProvider):
-        # transform the args.
-        args, kwArgs = self._transform_args_(
-            args, kwArgs, dispid, lcid, wFlags, serviceProvider
-        )
-        return DesignatedWrapPolicy._invokeex_(
-            self, dispid, lcid, wFlags, args, kwArgs, serviceProvider
-        )
-
-
-class DynamicPolicy(BasicWrapPolicy):
-    """A policy which dynamically (ie, at run-time) determines public interfaces.
-
-    A dynamic policy is used to dynamically dispatch methods and properties to the
-    wrapped object.  The list of objects and properties does not need to be known in
-    advance, and methods or properties added to the wrapped object after construction
-    are also handled.
-
-    The wrapped object must provide the following attributes:
-
-    _dynamic_ -- A method that will be called whenever an invoke on the object
-           is called.  The method is called with the name of the underlying method/property
-           (ie, the mapping of dispid to/from name has been resolved.)  This name property
-           may also be '_value_' to indicate the default, and '_NewEnum' to indicate a new
-           enumerator is requested.
-
-    """
-
-    def _wrap_(self, object):
-        BasicWrapPolicy._wrap_(self, object)
-        if not hasattr(self._obj_, "_dynamic_"):
-            raise error("Object does not support Dynamic COM Policy")
-        self._next_dynamic_ = self._min_dynamic_ = 1000
-        self._dyn_dispid_to_name_ = {
-            DISPID_VALUE: "_value_",
-            DISPID_NEWENUM: "_NewEnum",
-        }
-
-    def _getdispid_(self, name, fdex):
-        # TODO - Look at fdex flags.
-        lname = name.lower()
-        try:
-            return self._name_to_dispid_[lname]
-        except KeyError:
-            dispid = self._next_dynamic_ = self._next_dynamic_ + 1
-            self._name_to_dispid_[lname] = dispid
-            self._dyn_dispid_to_name_[dispid] = name  # Keep case in this map...
-            return dispid
-
-    def _invoke_(self, dispid, lcid, wFlags, args):
-        return S_OK, -1, self._invokeex_(dispid, lcid, wFlags, args, None, None)
-
-    def _invokeex_(self, dispid, lcid, wFlags, args, kwargs, serviceProvider):
-        ### note: lcid is being ignored...
-        ### note: kwargs is being ignored...
-        ### note: serviceProvider is being ignored...
-        ### there might be assigned DISPID values to properties, too...
-        try:
-            name = self._dyn_dispid_to_name_[dispid]
-        except KeyError:
-            raise COMException(
-                scode=winerror.DISP_E_MEMBERNOTFOUND, desc="Member not found"
-            )
-        return self._obj_._dynamic_(name, lcid, wFlags, args)
-
-
-DefaultPolicy = DesignatedWrapPolicy
-
-
-def resolve_func(spec):
-    """Resolve a function by name
-
-    Given a function specified by 'module.function', return a callable object
-    (ie, the function itself)
-    """
-    try:
-        idx = spec.rindex(".")
-        mname = spec[:idx]
-        fname = spec[idx + 1 :]
-        # Dont attempt to optimize by looking in sys.modules,
-        # as another thread may also be performing the import - this
-        # way we take advantage of the built-in import lock.
-        module = _import_module(mname)
-        return getattr(module, fname)
-    except ValueError:  # No "." in name - assume in this module
-        return globals()[spec]
-
-
-def call_func(spec, *args):
-    """Call a function specified by name.
-
-    Call a function specified by 'module.function' and return the result.
-    """
-
-    return resolve_func(spec)(*args)
-
-
-def _import_module(mname):
-    """Import a module just like the 'import' statement.
-
-    Having this function is much nicer for importing arbitrary modules than
-    using the 'exec' keyword.  It is more efficient and obvious to the reader.
-    """
-    __import__(mname)
-    # Eeek - result of _import_ is "win32com" - not "win32com.a.b.c"
-    # Get the full module from sys.modules
-    return sys.modules[mname]
-
-
-#######
-#
-# Temporary hacks until all old code moves.
-#
-# These have been moved to a new source file, but some code may
-# still reference them here.  These will end up being removed.
-try:
-    from .dispatcher import DispatcherTrace, DispatcherWin32trace
-except ImportError:  # Quite likely a frozen executable that doesnt need dispatchers
-    pass
diff --git a/lib/win32com/server/register.py b/lib/win32com/server/register.py
deleted file mode 100644
index ae513c75..00000000
--- a/lib/win32com/server/register.py
+++ /dev/null
@@ -1,672 +0,0 @@
-"""Utilities for registering objects.
-
-This module contains utility functions to register Python objects as
-valid COM Servers.  The RegisterServer function provides all information
-necessary to allow the COM framework to respond to a request for a COM object,
-construct the necessary Python object, and dispatch COM events.
-
-"""
-import os
-import sys
-
-import pythoncom
-import win32api
-import win32con
-import winerror
-
-CATID_PythonCOMServer = "{B3EF80D0-68E2-11D0-A689-00C04FD658FF}"
-
-
-def _set_subkeys(keyName, valueDict, base=win32con.HKEY_CLASSES_ROOT):
-    hkey = win32api.RegCreateKey(base, keyName)
-    try:
-        for key, value in valueDict.items():
-            win32api.RegSetValueEx(hkey, key, None, win32con.REG_SZ, value)
-    finally:
-        win32api.RegCloseKey(hkey)
-
-
-def _set_string(path, value, base=win32con.HKEY_CLASSES_ROOT):
-    "Set a string value in the registry."
-
-    win32api.RegSetValue(base, path, win32con.REG_SZ, value)
-
-
-def _get_string(path, base=win32con.HKEY_CLASSES_ROOT):
-    "Get a string value from the registry."
-
-    try:
-        return win32api.RegQueryValue(base, path)
-    except win32api.error:
-        return None
-
-
-def _remove_key(path, base=win32con.HKEY_CLASSES_ROOT):
-    "Remove a string from the registry."
-
-    try:
-        win32api.RegDeleteKey(base, path)
-    except win32api.error as xxx_todo_changeme1:
-        (code, fn, msg) = xxx_todo_changeme1.args
-        if code != winerror.ERROR_FILE_NOT_FOUND:
-            raise win32api.error(code, fn, msg)
-
-
-def recurse_delete_key(path, base=win32con.HKEY_CLASSES_ROOT):
-    """Recursively delete registry keys.
-
-    This is needed since you can't blast a key when subkeys exist.
-    """
-    try:
-        h = win32api.RegOpenKey(base, path)
-    except win32api.error as xxx_todo_changeme2:
-        (code, fn, msg) = xxx_todo_changeme2.args
-        if code != winerror.ERROR_FILE_NOT_FOUND:
-            raise win32api.error(code, fn, msg)
-    else:
-        # parent key found and opened successfully. do some work, making sure
-        # to always close the thing (error or no).
-        try:
-            # remove all of the subkeys
-            while 1:
-                try:
-                    subkeyname = win32api.RegEnumKey(h, 0)
-                except win32api.error as xxx_todo_changeme:
-                    (code, fn, msg) = xxx_todo_changeme.args
-                    if code != winerror.ERROR_NO_MORE_ITEMS:
-                        raise win32api.error(code, fn, msg)
-                    break
-                recurse_delete_key(path + "\\" + subkeyname, base)
-
-            # remove the parent key
-            _remove_key(path, base)
-        finally:
-            win32api.RegCloseKey(h)
-
-
-def _cat_registrar():
-    return pythoncom.CoCreateInstance(
-        pythoncom.CLSID_StdComponentCategoriesMgr,
-        None,
-        pythoncom.CLSCTX_INPROC_SERVER,
-        pythoncom.IID_ICatRegister,
-    )
-
-
-def _find_localserver_exe(mustfind):
-    if not sys.platform.startswith("win32"):
-        return sys.executable
-    if pythoncom.__file__.find("_d") < 0:
-        exeBaseName = "pythonw.exe"
-    else:
-        exeBaseName = "pythonw_d.exe"
-    # First see if in the same directory as this .EXE
-    exeName = os.path.join(os.path.split(sys.executable)[0], exeBaseName)
-    if not os.path.exists(exeName):
-        # See if in our sys.prefix directory
-        exeName = os.path.join(sys.prefix, exeBaseName)
-    if not os.path.exists(exeName):
-        # See if in our sys.prefix/pcbuild directory (for developers)
-        if "64 bit" in sys.version:
-            exeName = os.path.join(sys.prefix, "PCbuild", "amd64", exeBaseName)
-        else:
-            exeName = os.path.join(sys.prefix, "PCbuild", exeBaseName)
-    if not os.path.exists(exeName):
-        # See if the registry has some info.
-        try:
-            key = "SOFTWARE\\Python\\PythonCore\\%s\\InstallPath" % sys.winver
-            path = win32api.RegQueryValue(win32con.HKEY_LOCAL_MACHINE, key)
-            exeName = os.path.join(path, exeBaseName)
-        except (AttributeError, win32api.error):
-            pass
-    if not os.path.exists(exeName):
-        if mustfind:
-            raise RuntimeError("Can not locate the program '%s'" % exeBaseName)
-        return None
-    return exeName
-
-
-def _find_localserver_module():
-    import win32com.server
-
-    path = win32com.server.__path__[0]
-    baseName = "localserver"
-    pyfile = os.path.join(path, baseName + ".py")
-    try:
-        os.stat(pyfile)
-    except os.error:
-        # See if we have a compiled extension
-        if __debug__:
-            ext = ".pyc"
-        else:
-            ext = ".pyo"
-        pyfile = os.path.join(path, baseName + ext)
-        try:
-            os.stat(pyfile)
-        except os.error:
-            raise RuntimeError(
-                "Can not locate the Python module 'win32com.server.%s'" % baseName
-            )
-    return pyfile
-
-
-def RegisterServer(
-    clsid,
-    pythonInstString=None,
-    desc=None,
-    progID=None,
-    verProgID=None,
-    defIcon=None,
-    threadingModel="both",
-    policy=None,
-    catids=[],
-    other={},
-    addPyComCat=None,
-    dispatcher=None,
-    clsctx=None,
-    addnPath=None,
-):
-    """Registers a Python object as a COM Server.  This enters almost all necessary
-    information in the system registry, allowing COM to use the object.
-
-    clsid -- The (unique) CLSID of the server.
-    pythonInstString -- A string holding the instance name that will be created
-                  whenever COM requests a new object.
-    desc -- The description of the COM object.
-    progID -- The user name of this object (eg, Word.Document)
-    verProgId -- The user name of this version's implementation (eg Word.6.Document)
-    defIcon -- The default icon for the object.
-    threadingModel -- The threading model this object supports.
-    policy -- The policy to use when creating this object.
-    catids -- A list of category ID's this object belongs in.
-    other -- A dictionary of extra items to be registered.
-    addPyComCat -- A flag indicating if the object should be added to the list
-             of Python servers installed on the machine.  If None (the default)
-             then it will be registered when running from python source, but
-             not registered if running in a frozen environment.
-    dispatcher -- The dispatcher to use when creating this object.
-    clsctx -- One of the CLSCTX_* constants.
-    addnPath -- An additional path the COM framework will add to sys.path
-                before attempting to create the object.
-    """
-
-    ### backwards-compat check
-    ### Certain policies do not require a "class name", just the policy itself.
-    if not pythonInstString and not policy:
-        raise TypeError(
-            "You must specify either the Python Class or Python Policy which implement the COM object."
-        )
-
-    keyNameRoot = "CLSID\\%s" % str(clsid)
-    _set_string(keyNameRoot, desc)
-
-    # Also register as an "Application" so DCOM etc all see us.
-    _set_string("AppID\\%s" % clsid, progID)
-    # Depending on contexts requested, register the specified server type.
-    # Set default clsctx.
-    if not clsctx:
-        clsctx = pythoncom.CLSCTX_INPROC_SERVER | pythoncom.CLSCTX_LOCAL_SERVER
-    # And if we are frozen, ignore the ones that don't make sense in this
-    # context.
-    if pythoncom.frozen:
-        assert (
-            sys.frozen
-        ), "pythoncom is frozen, but sys.frozen is not set - don't know the context!"
-        if sys.frozen == "dll":
-            clsctx = clsctx & pythoncom.CLSCTX_INPROC_SERVER
-        else:
-            clsctx = clsctx & pythoncom.CLSCTX_LOCAL_SERVER
-    # Now setup based on the clsctx left over.
-    if clsctx & pythoncom.CLSCTX_INPROC_SERVER:
-        # get the module to use for registration.
-        # nod to Gordon's installer - if sys.frozen and sys.frozendllhandle
-        # exist, then we are being registered via a DLL - use this DLL as the
-        # file name.
-        if pythoncom.frozen:
-            if hasattr(sys, "frozendllhandle"):
-                dllName = win32api.GetModuleFileName(sys.frozendllhandle)
-            else:
-                raise RuntimeError(
-                    "We appear to have a frozen DLL, but I don't know the DLL to use"
-                )
-        else:
-            # Normal case - running from .py file, so register pythoncom's DLL.
-            # Although now we prefer a 'loader' DLL if it exists to avoid some
-            # manifest issues (the 'loader' DLL has a manifest, but pythoncom does not)
-            pythoncom_dir = os.path.dirname(pythoncom.__file__)
-            suffix = "_d" if "_d" in pythoncom.__file__ else ""
-            # Always register with the full path to the DLLs.
-            loadername = os.path.join(
-                pythoncom_dir,
-                "pythoncomloader%d%d%s.dll"
-                % (sys.version_info[0], sys.version_info[1], suffix),
-            )
-            dllName = loadername if os.path.isfile(loadername) else pythoncom.__file__
-
-        _set_subkeys(
-            keyNameRoot + "\\InprocServer32",
-            {
-                None: dllName,
-                "ThreadingModel": threadingModel,
-            },
-        )
-    else:  # Remove any old InProcServer32 registrations
-        _remove_key(keyNameRoot + "\\InprocServer32")
-
-    if clsctx & pythoncom.CLSCTX_LOCAL_SERVER:
-        if pythoncom.frozen:
-            # If we are frozen, we write "{exe} /Automate", just
-            # like "normal" .EXEs do
-            exeName = win32api.GetShortPathName(sys.executable)
-            command = "%s /Automate" % (exeName,)
-        else:
-            # Running from .py sources - we need to write
-            # 'python.exe win32com\server\localserver.py {clsid}"
-            exeName = _find_localserver_exe(1)
-            exeName = win32api.GetShortPathName(exeName)
-            pyfile = _find_localserver_module()
-            command = '%s "%s" %s' % (exeName, pyfile, str(clsid))
-        _set_string(keyNameRoot + "\\LocalServer32", command)
-    else:  # Remove any old LocalServer32 registrations
-        _remove_key(keyNameRoot + "\\LocalServer32")
-
-    if pythonInstString:
-        _set_string(keyNameRoot + "\\PythonCOM", pythonInstString)
-    else:
-        _remove_key(keyNameRoot + "\\PythonCOM")
-    if policy:
-        _set_string(keyNameRoot + "\\PythonCOMPolicy", policy)
-    else:
-        _remove_key(keyNameRoot + "\\PythonCOMPolicy")
-
-    if dispatcher:
-        _set_string(keyNameRoot + "\\PythonCOMDispatcher", dispatcher)
-    else:
-        _remove_key(keyNameRoot + "\\PythonCOMDispatcher")
-
-    if defIcon:
-        _set_string(keyNameRoot + "\\DefaultIcon", defIcon)
-    else:
-        _remove_key(keyNameRoot + "\\DefaultIcon")
-
-    if addnPath:
-        _set_string(keyNameRoot + "\\PythonCOMPath", addnPath)
-    else:
-        _remove_key(keyNameRoot + "\\PythonCOMPath")
-
-    if addPyComCat is None:
-        addPyComCat = pythoncom.frozen == 0
-    if addPyComCat:
-        catids = catids + [CATID_PythonCOMServer]
-
-    # Set up the implemented categories
-    if catids:
-        regCat = _cat_registrar()
-        regCat.RegisterClassImplCategories(clsid, catids)
-
-    # set up any other reg values they might have
-    if other:
-        for key, value in other.items():
-            _set_string(keyNameRoot + "\\" + key, value)
-
-    if progID:
-        # set the progID as the most specific that was given to us
-        if verProgID:
-            _set_string(keyNameRoot + "\\ProgID", verProgID)
-        else:
-            _set_string(keyNameRoot + "\\ProgID", progID)
-
-        # Set up the root entries - version independent.
-        if desc:
-            _set_string(progID, desc)
-        _set_string(progID + "\\CLSID", str(clsid))
-
-        # Set up the root entries - version dependent.
-        if verProgID:
-            # point from independent to the current version
-            _set_string(progID + "\\CurVer", verProgID)
-
-            # point to the version-independent one
-            _set_string(keyNameRoot + "\\VersionIndependentProgID", progID)
-
-            # set up the versioned progID
-            if desc:
-                _set_string(verProgID, desc)
-            _set_string(verProgID + "\\CLSID", str(clsid))
-
-
-def GetUnregisterServerKeys(clsid, progID=None, verProgID=None, customKeys=None):
-    """Given a server, return a list of of ("key", root), which are keys recursively
-    and uncondtionally deleted at unregister or uninstall time.
-    """
-    # remove the main CLSID registration
-    ret = [("CLSID\\%s" % str(clsid), win32con.HKEY_CLASSES_ROOT)]
-    # remove the versioned ProgID registration
-    if verProgID:
-        ret.append((verProgID, win32con.HKEY_CLASSES_ROOT))
-    # blow away the independent ProgID. we can't leave it since we just
-    # torched the class.
-    ### could potentially check the CLSID... ?
-    if progID:
-        ret.append((progID, win32con.HKEY_CLASSES_ROOT))
-    # The DCOM config tool may write settings to the AppID key for our CLSID
-    ret.append(("AppID\\%s" % str(clsid), win32con.HKEY_CLASSES_ROOT))
-    # Any custom keys?
-    if customKeys:
-        ret = ret + customKeys
-
-    return ret
-
-
-def UnregisterServer(clsid, progID=None, verProgID=None, customKeys=None):
-    """Unregisters a Python COM server."""
-
-    for args in GetUnregisterServerKeys(clsid, progID, verProgID, customKeys):
-        recurse_delete_key(*args)
-
-    ### it might be nice at some point to "roll back" the independent ProgID
-    ### to an earlier version if one exists, and just blowing away the
-    ### specified version of the ProgID (and its corresponding CLSID)
-    ### another time, though...
-
-    ### NOTE: ATL simply blows away the above three keys without the
-    ### potential checks that I describe.  Assuming that defines the
-    ### "standard" then we have no additional changes necessary.
-
-
-def GetRegisteredServerOption(clsid, optionName):
-    """Given a CLSID for a server and option name, return the option value"""
-    keyNameRoot = "CLSID\\%s\\%s" % (str(clsid), str(optionName))
-    return _get_string(keyNameRoot)
-
-
-def _get(ob, attr, default=None):
-    try:
-        return getattr(ob, attr)
-    except AttributeError:
-        pass
-    # look down sub-classes
-    try:
-        bases = ob.__bases__
-    except AttributeError:
-        # ob is not a class - no probs.
-        return default
-    for base in bases:
-        val = _get(base, attr, None)
-        if val is not None:
-            return val
-    return default
-
-
-def RegisterClasses(*classes, **flags):
-    quiet = "quiet" in flags and flags["quiet"]
-    debugging = "debug" in flags and flags["debug"]
-    for cls in classes:
-        clsid = cls._reg_clsid_
-        progID = _get(cls, "_reg_progid_")
-        desc = _get(cls, "_reg_desc_", progID)
-        spec = _get(cls, "_reg_class_spec_")
-        verProgID = _get(cls, "_reg_verprogid_")
-        defIcon = _get(cls, "_reg_icon_")
-        threadingModel = _get(cls, "_reg_threading_", "both")
-        catids = _get(cls, "_reg_catids_", [])
-        options = _get(cls, "_reg_options_", {})
-        policySpec = _get(cls, "_reg_policy_spec_")
-        clsctx = _get(cls, "_reg_clsctx_")
-        tlb_filename = _get(cls, "_reg_typelib_filename_")
-        # default to being a COM category only when not frozen.
-        addPyComCat = not _get(cls, "_reg_disable_pycomcat_", pythoncom.frozen != 0)
-        addnPath = None
-        if debugging:
-            # If the class has a debugging dispatcher specified, use it, otherwise
-            # use our default dispatcher.
-            dispatcherSpec = _get(cls, "_reg_debug_dispatcher_spec_")
-            if dispatcherSpec is None:
-                dispatcherSpec = "win32com.server.dispatcher.DefaultDebugDispatcher"
-            # And remember the debugging flag as servers may wish to use it at runtime.
-            debuggingDesc = "(for debugging)"
-            options["Debugging"] = "1"
-        else:
-            dispatcherSpec = _get(cls, "_reg_dispatcher_spec_")
-            debuggingDesc = ""
-            options["Debugging"] = "0"
-
-        if spec is None:
-            moduleName = cls.__module__
-            if moduleName == "__main__":
-                # Use argv[0] to determine the module name.
-                try:
-                    # Use the win32api to find the case-sensitive name
-                    moduleName = os.path.splitext(
-                        win32api.FindFiles(sys.argv[0])[0][8]
-                    )[0]
-                except (IndexError, win32api.error):
-                    # Can't find the script file - the user must explicitely set the _reg_... attribute.
-                    raise TypeError(
-                        "Can't locate the script hosting the COM object - please set _reg_class_spec_ in your object"
-                    )
-
-            spec = moduleName + "." + cls.__name__
-            # Frozen apps don't need their directory on sys.path
-            if not pythoncom.frozen:
-                scriptDir = os.path.split(sys.argv[0])[0]
-                if not scriptDir:
-                    scriptDir = "."
-                addnPath = win32api.GetFullPathName(scriptDir)
-
-        RegisterServer(
-            clsid,
-            spec,
-            desc,
-            progID,
-            verProgID,
-            defIcon,
-            threadingModel,
-            policySpec,
-            catids,
-            options,
-            addPyComCat,
-            dispatcherSpec,
-            clsctx,
-            addnPath,
-        )
-        if not quiet:
-            print("Registered:", progID or spec, debuggingDesc)
-        # Register the typelibrary
-        if tlb_filename:
-            tlb_filename = os.path.abspath(tlb_filename)
-            typelib = pythoncom.LoadTypeLib(tlb_filename)
-            pythoncom.RegisterTypeLib(typelib, tlb_filename)
-            if not quiet:
-                print("Registered type library:", tlb_filename)
-    extra = flags.get("finalize_register")
-    if extra:
-        extra()
-
-
-def UnregisterClasses(*classes, **flags):
-    quiet = "quiet" in flags and flags["quiet"]
-    for cls in classes:
-        clsid = cls._reg_clsid_
-        progID = _get(cls, "_reg_progid_")
-        verProgID = _get(cls, "_reg_verprogid_")
-        customKeys = _get(cls, "_reg_remove_keys_")
-        unregister_typelib = _get(cls, "_reg_typelib_filename_") is not None
-
-        UnregisterServer(clsid, progID, verProgID, customKeys)
-        if not quiet:
-            print("Unregistered:", progID or str(clsid))
-        if unregister_typelib:
-            tlb_guid = _get(cls, "_typelib_guid_")
-            if tlb_guid is None:
-                # I guess I could load the typelib, but they need the GUID anyway.
-                print("Have typelib filename, but no GUID - can't unregister")
-            else:
-                major, minor = _get(cls, "_typelib_version_", (1, 0))
-                lcid = _get(cls, "_typelib_lcid_", 0)
-                try:
-                    pythoncom.UnRegisterTypeLib(tlb_guid, major, minor, lcid)
-                    if not quiet:
-                        print("Unregistered type library")
-                except pythoncom.com_error:
-                    pass
-
-    extra = flags.get("finalize_unregister")
-    if extra:
-        extra()
-
-
-#
-# Unregister info is for installers or external uninstallers.
-# The WISE installer, for example firstly registers the COM server,
-# then queries for the Unregister info, appending it to its
-# install log.  Uninstalling the package will the uninstall the server
-def UnregisterInfoClasses(*classes, **flags):
-    ret = []
-    for cls in classes:
-        clsid = cls._reg_clsid_
-        progID = _get(cls, "_reg_progid_")
-        verProgID = _get(cls, "_reg_verprogid_")
-        customKeys = _get(cls, "_reg_remove_keys_")
-
-        ret = ret + GetUnregisterServerKeys(clsid, progID, verProgID, customKeys)
-    return ret
-
-
-# Attempt to 're-execute' our current process with elevation.
-def ReExecuteElevated(flags):
-    import tempfile
-
-    import win32event  # we've already checked we are running XP above
-    import win32process
-    import winxpgui
-    from win32com.shell import shellcon
-    from win32com.shell.shell import ShellExecuteEx
-
-    if not flags["quiet"]:
-        print("Requesting elevation and retrying...")
-    new_params = " ".join(['"' + a + '"' for a in sys.argv])
-    # If we aren't already in unattended mode, we want our sub-process to
-    # be.
-    if not flags["unattended"]:
-        new_params += " --unattended"
-    # specifying the parent means the dialog is centered over our window,
-    # which is a good usability clue.
-    # hwnd is unlikely on the command-line, but flags may come from elsewhere
-    hwnd = flags.get("hwnd", None)
-    if hwnd is None:
-        try:
-            hwnd = winxpgui.GetConsoleWindow()
-        except winxpgui.error:
-            hwnd = 0
-    # Redirect output so we give the user some clue what went wrong.  This
-    # also means we need to use COMSPEC.  However, the "current directory"
-    # appears to end up ignored - so we execute things via a temp batch file.
-    tempbase = tempfile.mktemp("pycomserverreg")
-    outfile = tempbase + ".out"
-    batfile = tempbase + ".bat"
-
-    # If registering from pythonwin, need to run python console instead since
-    #  pythonwin will just open script for editting
-    current_exe = os.path.split(sys.executable)[1].lower()
-    exe_to_run = None
-    if current_exe == "pythonwin.exe":
-        exe_to_run = os.path.join(sys.prefix, "python.exe")
-    elif current_exe == "pythonwin_d.exe":
-        exe_to_run = os.path.join(sys.prefix, "python_d.exe")
-    if not exe_to_run or not os.path.exists(exe_to_run):
-        exe_to_run = sys.executable
-
-    try:
-        batf = open(batfile, "w")
-        try:
-            cwd = os.getcwd()
-            print("@echo off", file=batf)
-            # nothing is 'inherited' by the elevated process, including the
-            # environment.  I wonder if we need to set more?
-            print("set PYTHONPATH=%s" % os.environ.get("PYTHONPATH", ""), file=batf)
-            # may be on a different drive - select that before attempting to CD.
-            print(os.path.splitdrive(cwd)[0], file=batf)
-            print('cd "%s"' % os.getcwd(), file=batf)
-            print(
-                '%s %s > "%s" 2>&1'
-                % (win32api.GetShortPathName(exe_to_run), new_params, outfile),
-                file=batf,
-            )
-        finally:
-            batf.close()
-        executable = os.environ.get("COMSPEC", "cmd.exe")
-        rc = ShellExecuteEx(
-            hwnd=hwnd,
-            fMask=shellcon.SEE_MASK_NOCLOSEPROCESS,
-            lpVerb="runas",
-            lpFile=executable,
-            lpParameters='/C "%s"' % batfile,
-            nShow=win32con.SW_SHOW,
-        )
-        hproc = rc["hProcess"]
-        win32event.WaitForSingleObject(hproc, win32event.INFINITE)
-        exit_code = win32process.GetExitCodeProcess(hproc)
-        outf = open(outfile)
-        try:
-            output = outf.read()
-        finally:
-            outf.close()
-
-        if exit_code:
-            # Even if quiet you get to see this message.
-            print("Error: registration failed (exit code %s)." % exit_code)
-        # if we are quiet then the output if likely to already be nearly
-        # empty, so always print it.
-        print(output, end=" ")
-    finally:
-        for f in (outfile, batfile):
-            try:
-                os.unlink(f)
-            except os.error as exc:
-                print("Failed to remove tempfile '%s': %s" % (f, exc))
-
-
-def UseCommandLine(*classes, **flags):
-    unregisterInfo = "--unregister_info" in sys.argv
-    unregister = "--unregister" in sys.argv
-    flags["quiet"] = flags.get("quiet", 0) or "--quiet" in sys.argv
-    flags["debug"] = flags.get("debug", 0) or "--debug" in sys.argv
-    flags["unattended"] = flags.get("unattended", 0) or "--unattended" in sys.argv
-    if unregisterInfo:
-        return UnregisterInfoClasses(*classes, **flags)
-    try:
-        if unregister:
-            UnregisterClasses(*classes, **flags)
-        else:
-            RegisterClasses(*classes, **flags)
-    except win32api.error as exc:
-        # If we are on xp+ and have "access denied", retry using
-        # ShellExecuteEx with 'runas' verb to force elevation (vista) and/or
-        # admin login dialog (vista/xp)
-        if (
-            flags["unattended"]
-            or exc.winerror != winerror.ERROR_ACCESS_DENIED
-            or sys.getwindowsversion()[0] < 5
-        ):
-            raise
-        ReExecuteElevated(flags)
-
-
-def RegisterPyComCategory():
-    """Register the Python COM Server component category."""
-    regCat = _cat_registrar()
-    regCat.RegisterCategories([(CATID_PythonCOMServer, 0x0409, "Python COM Server")])
-
-
-if not pythoncom.frozen:
-    try:
-        win32api.RegQueryValue(
-            win32con.HKEY_CLASSES_ROOT,
-            "Component Categories\\%s" % CATID_PythonCOMServer,
-        )
-    except win32api.error:
-        try:
-            RegisterPyComCategory()
-        except pythoncom.error:  # Error with the COM category manager - oh well.
-            pass
diff --git a/lib/win32com/server/util.py b/lib/win32com/server/util.py
deleted file mode 100644
index c46dd375..00000000
--- a/lib/win32com/server/util.py
+++ /dev/null
@@ -1,229 +0,0 @@
-""" General Server side utilities 
-"""
-import pythoncom
-import winerror
-
-from . import policy
-from .exception import COMException
-
-
-def wrap(ob, iid=None, usePolicy=None, useDispatcher=None):
-    """Wraps an object in a PyGDispatch gateway.
-
-    Returns a client side PyI{iid} interface.
-
-    Interface and gateway support must exist for the specified IID, as
-    the QueryInterface() method is used.
-
-    """
-    if usePolicy is None:
-        usePolicy = policy.DefaultPolicy
-    if useDispatcher == 1:  # True will also work here.
-        import win32com.server.dispatcher
-
-        useDispatcher = win32com.server.dispatcher.DefaultDebugDispatcher
-    if useDispatcher is None or useDispatcher == 0:
-        ob = usePolicy(ob)
-    else:
-        ob = useDispatcher(usePolicy, ob)
-
-    # get a PyIDispatch, which interfaces to PyGDispatch
-    ob = pythoncom.WrapObject(ob)
-    if iid is not None:
-        ob = ob.QueryInterface(iid)  # Ask the PyIDispatch if it supports it?
-    return ob
-
-
-def unwrap(ob):
-    """Unwraps an interface.
-
-    Given an interface which wraps up a Gateway, return the object behind
-    the gateway.
-    """
-    ob = pythoncom.UnwrapObject(ob)
-    # see if the object is a dispatcher
-    if hasattr(ob, "policy"):
-        ob = ob.policy
-    return ob._obj_
-
-
-class ListEnumerator:
-    """A class to expose a Python sequence as an EnumVARIANT.
-
-    Create an instance of this class passing a sequence (list, tuple, or
-    any sequence protocol supporting object) and it will automatically
-    support the EnumVARIANT interface for the object.
-
-    See also the @NewEnum@ function, which can be used to turn the
-    instance into an actual COM server.
-    """
-
-    _public_methods_ = ["Next", "Skip", "Reset", "Clone"]
-
-    def __init__(self, data, index=0, iid=pythoncom.IID_IEnumVARIANT):
-        self._list_ = data
-        self.index = index
-        self._iid_ = iid
-
-    def _query_interface_(self, iid):
-        if iid == self._iid_:
-            return 1
-
-    def Next(self, count):
-        result = self._list_[self.index : self.index + count]
-        self.Skip(count)
-        return result
-
-    def Skip(self, count):
-        end = self.index + count
-        if end > len(self._list_):
-            end = len(self._list_)
-        self.index = end
-
-    def Reset(self):
-        self.index = 0
-
-    def Clone(self):
-        return self._wrap(self.__class__(self._list_, self.index))
-
-    def _wrap(self, ob):
-        return wrap(ob)
-
-
-class ListEnumeratorGateway(ListEnumerator):
-    """A List Enumerator which wraps a sequence's items in gateways.
-
-    If a sequence contains items (objects) that have not been wrapped for
-    return through the COM layers, then a ListEnumeratorGateway can be
-    used to wrap those items before returning them (from the Next() method).
-
-    See also the @ListEnumerator@ class and the @NewEnum@ function.
-    """
-
-    def Next(self, count):
-        result = self._list_[self.index : self.index + count]
-        self.Skip(count)
-        return map(self._wrap, result)
-
-
-def NewEnum(
-    seq,
-    cls=ListEnumerator,
-    iid=pythoncom.IID_IEnumVARIANT,
-    usePolicy=None,
-    useDispatcher=None,
-):
-    """Creates a new enumerator COM server.
-
-    This function creates a new COM Server that implements the
-    IID_IEnumVARIANT interface.
-
-    A COM server that can enumerate the passed in sequence will be
-    created, then wrapped up for return through the COM framework.
-    Optionally, a custom COM server for enumeration can be passed
-    (the default is @ListEnumerator@), and the specific IEnum
-    interface can be specified.
-    """
-    ob = cls(seq, iid=iid)
-    return wrap(ob, iid, usePolicy=usePolicy, useDispatcher=useDispatcher)
-
-
-class Collection:
-    "A collection of VARIANT values."
-
-    _public_methods_ = ["Item", "Count", "Add", "Remove", "Insert"]
-
-    def __init__(self, data=None, readOnly=0):
-        if data is None:
-            data = []
-        self.data = data
-
-        # disable Add/Remove if read-only. note that we adjust _public_methods_
-        # on this instance only.
-        if readOnly:
-            self._public_methods_ = ["Item", "Count"]
-
-    # This method is also used as the "default" method.
-    # Thus "print ob" will cause this to be called with zero
-    # params.  Handle this slightly more elegantly here.
-    # Ideally the  policy should handle this.
-    def Item(self, *args):
-        if len(args) != 1:
-            raise COMException(scode=winerror.DISP_E_BADPARAMCOUNT)
-
-        try:
-            return self.data[args[0]]
-        except IndexError as desc:
-            raise COMException(scode=winerror.DISP_E_BADINDEX, desc=str(desc))
-
-    _value_ = Item
-
-    def Count(self):
-        return len(self.data)
-
-    def Add(self, value):
-        self.data.append(value)
-
-    def Remove(self, index):
-        try:
-            del self.data[index]
-        except IndexError as desc:
-            raise COMException(scode=winerror.DISP_E_BADINDEX, desc=str(desc))
-
-    def Insert(self, index, value):
-        try:
-            index = int(index)
-        except (ValueError, TypeError):
-            raise COMException(scode=winerror.DISP_E_TYPEMISMATCH)
-        self.data.insert(index, value)
-
-    def _NewEnum(self):
-        return NewEnum(self.data)
-
-
-def NewCollection(seq, cls=Collection):
-    """Creates a new COM collection object
-
-    This function creates a new COM Server that implements the
-    common collection protocols, including enumeration. (_NewEnum)
-
-    A COM server that can enumerate the passed in sequence will be
-    created, then wrapped up for return through the COM framework.
-    Optionally, a custom COM server for enumeration can be passed
-    (the default is @Collection@).
-    """
-    return pythoncom.WrapObject(
-        policy.DefaultPolicy(cls(seq)), pythoncom.IID_IDispatch, pythoncom.IID_IDispatch
-    )
-
-
-class FileStream:
-    _public_methods_ = ["Read", "Write", "Clone", "CopyTo", "Seek"]
-    _com_interfaces_ = [pythoncom.IID_IStream]
-
-    def __init__(self, file):
-        self.file = file
-
-    def Read(self, amount):
-        return self.file.read(amount)
-
-    def Write(self, data):
-        self.file.write(data)
-        return len(data)
-
-    def Clone(self):
-        return self._wrap(self.__class__(self.file))
-
-    def CopyTo(self, dest, cb):
-        data = self.file.read(cb)
-        cbread = len(data)
-        dest.Write(data)  ## ??? Write does not currently return the length ???
-        return cbread, cbread
-
-    def Seek(self, offset, origin):
-        # how convient that the 'origin' values are the same as the CRT :)
-        self.file.seek(offset, origin)
-        return self.file.tell()
-
-    def _wrap(self, ob):
-        return wrap(ob)
diff --git a/lib/win32com/servers/PythonTools.py b/lib/win32com/servers/PythonTools.py
deleted file mode 100644
index 7f8f4d76..00000000
--- a/lib/win32com/servers/PythonTools.py
+++ /dev/null
@@ -1,47 +0,0 @@
-import sys
-import time
-
-
-class Tools:
-    _public_methods_ = ["reload", "adddir", "echo", "sleep"]
-
-    def reload(self, module):
-        if module in sys.modules:
-            from importlib import reload
-
-            reload(sys.modules[module])
-            return "reload succeeded."
-        return "no reload performed."
-
-    def adddir(self, dir):
-        if type(dir) == type(""):
-            sys.path.append(dir)
-        return str(sys.path)
-
-    def echo(self, arg):
-        return repr(arg)
-
-    def sleep(self, t):
-        time.sleep(t)
-
-
-if __name__ == "__main__":
-    from win32com.server.register import RegisterServer, UnregisterServer
-
-    clsid = "{06ce7630-1d81-11d0-ae37-c2fa70000000}"
-    progid = "Python.Tools"
-    verprogid = "Python.Tools.1"
-    if "--unregister" in sys.argv:
-        print("Unregistering...")
-        UnregisterServer(clsid, progid, verprogid)
-        print("Unregistered OK")
-    else:
-        print("Registering COM server...")
-        RegisterServer(
-            clsid,
-            "win32com.servers.PythonTools.Tools",
-            "Python Tools",
-            progid,
-            verprogid,
-        )
-        print("Class registered.")
diff --git a/lib/win32com/servers/__init__.py b/lib/win32com/servers/__init__.py
deleted file mode 100644
index e69de29b..00000000
diff --git a/lib/win32com/servers/dictionary.py b/lib/win32com/servers/dictionary.py
deleted file mode 100644
index 28596b81..00000000
--- a/lib/win32com/servers/dictionary.py
+++ /dev/null
@@ -1,137 +0,0 @@
-"""Python.Dictionary COM Server.
-
-This module implements a simple COM server that acts much like a Python
-dictionary or as a standard string-keyed VB Collection.  The keys of
-the dictionary are strings and are case-insensitive.
-
-It uses a highly customized policy to fine-tune the behavior exposed to
-the COM client.
-
-The object exposes the following properties:
-
-    int Count                       (readonly)
-    VARIANT Item(BSTR key)          (propget for Item)
-    Item(BSTR key, VARIANT value)   (propput for Item)
-
-    Note that 'Item' is the default property, so the following forms of
-    VB code are acceptable:
-
-        set ob = CreateObject("Python.Dictionary")
-        ob("hello") = "there"
-        ob.Item("hi") = ob("HELLO")
-
-All keys are defined, returning VT_NULL (None) if a value has not been
-stored.  To delete a key, simply assign VT_NULL to the key.
-
-The object responds to the _NewEnum method by returning an enumerator over
-the dictionary's keys. This allows for the following type of VB code:
-
-    for each name in ob
-        debug.print name, ob(name)
-    next
-"""
-
-
-import pythoncom
-import pywintypes
-import winerror
-from pythoncom import DISPATCH_METHOD, DISPATCH_PROPERTYGET
-from win32com.server import policy, util
-from win32com.server.exception import COMException
-from winerror import S_OK
-
-
-class DictionaryPolicy(policy.BasicWrapPolicy):
-    ### BasicWrapPolicy looks for this
-    _com_interfaces_ = []
-
-    ### BasicWrapPolicy looks for this
-    _name_to_dispid_ = {
-        "item": pythoncom.DISPID_VALUE,
-        "_newenum": pythoncom.DISPID_NEWENUM,
-        "count": 1,
-    }
-
-    ### Auto-Registration process looks for these...
-    _reg_desc_ = "Python Dictionary"
-    _reg_clsid_ = "{39b61048-c755-11d0-86fa-00c04fc2e03e}"
-    _reg_progid_ = "Python.Dictionary"
-    _reg_verprogid_ = "Python.Dictionary.1"
-    _reg_policy_spec_ = "win32com.servers.dictionary.DictionaryPolicy"
-
-    def _CreateInstance_(self, clsid, reqIID):
-        self._wrap_({})
-        return pythoncom.WrapObject(self, reqIID)
-
-    def _wrap_(self, ob):
-        self._obj_ = ob  # ob should be a dictionary
-
-    def _invokeex_(self, dispid, lcid, wFlags, args, kwargs, serviceProvider):
-        if dispid == 0:  # item
-            l = len(args)
-            if l < 1:
-                raise COMException(
-                    desc="not enough parameters", scode=winerror.DISP_E_BADPARAMCOUNT
-                )
-
-            key = args[0]
-            if type(key) not in [str, str]:
-                ### the nArgErr thing should be 0-based, not reversed... sigh
-                raise COMException(
-                    desc="Key must be a string", scode=winerror.DISP_E_TYPEMISMATCH
-                )
-
-            key = key.lower()
-
-            if wFlags & (DISPATCH_METHOD | DISPATCH_PROPERTYGET):
-                if l > 1:
-                    raise COMException(scode=winerror.DISP_E_BADPARAMCOUNT)
-                try:
-                    return self._obj_[key]
-                except KeyError:
-                    return None  # unknown keys return None (VT_NULL)
-
-            if l != 2:
-                raise COMException(scode=winerror.DISP_E_BADPARAMCOUNT)
-            if args[1] is None:
-                # delete a key when None is assigned to it
-                try:
-                    del self._obj_[key]
-                except KeyError:
-                    pass
-            else:
-                self._obj_[key] = args[1]
-            return S_OK
-
-        if dispid == 1:  # count
-            if not wFlags & DISPATCH_PROPERTYGET:
-                raise COMException(scode=winerror.DISP_E_MEMBERNOTFOUND)  # not found
-            if len(args) != 0:
-                raise COMException(scode=winerror.DISP_E_BADPARAMCOUNT)
-            return len(self._obj_)
-
-        if dispid == pythoncom.DISPID_NEWENUM:
-            return util.NewEnum(list(self._obj_.keys()))
-
-        raise COMException(scode=winerror.DISP_E_MEMBERNOTFOUND)
-
-    def _getidsofnames_(self, names, lcid):
-        ### this is a copy of MappedWrapPolicy._getidsofnames_ ...
-
-        name = names[0].lower()
-        try:
-            return (self._name_to_dispid_[name],)
-        except KeyError:
-            raise COMException(
-                scode=winerror.DISP_E_MEMBERNOTFOUND, desc="Member not found"
-            )
-
-
-def Register():
-    from win32com.server.register import UseCommandLine
-
-    return UseCommandLine(DictionaryPolicy)
-
-
-if __name__ == "__main__":
-    Register()
diff --git a/lib/win32com/servers/interp.py b/lib/win32com/servers/interp.py
deleted file mode 100644
index b15cede7..00000000
--- a/lib/win32com/servers/interp.py
+++ /dev/null
@@ -1,55 +0,0 @@
-"""Python.Interpreter COM Server
-
-  This module implements a very very simple COM server which
-  exposes the Python interpreter.
-
-  This is designed more as a demonstration than a full blown COM server.
-  General functionality and Error handling are both limited.
-
-  To use this object, ensure it is registered by running this module
-  from Python.exe.  Then, from Visual Basic, use "CreateObject('Python.Interpreter')",
-  and call its methods!
-"""
-
-import winerror
-from win32com.server.exception import Exception
-
-
-# Expose the Python interpreter.
-class Interpreter:
-    """The interpreter object exposed via COM"""
-
-    _public_methods_ = ["Exec", "Eval"]
-    # All registration stuff to support fully automatic register/unregister
-    _reg_verprogid_ = "Python.Interpreter.2"
-    _reg_progid_ = "Python.Interpreter"
-    _reg_desc_ = "Python Interpreter"
-    _reg_clsid_ = "{30BD3490-2632-11cf-AD5B-524153480001}"
-    _reg_class_spec_ = "win32com.servers.interp.Interpreter"
-
-    def __init__(self):
-        self.dict = {}
-
-    def Eval(self, exp):
-        """Evaluate an expression."""
-        if type(exp) != str:
-            raise Exception(desc="Must be a string", scode=winerror.DISP_E_TYPEMISMATCH)
-
-        return eval(str(exp), self.dict)
-
-    def Exec(self, exp):
-        """Execute a statement."""
-        if type(exp) != str:
-            raise Exception(desc="Must be a string", scode=winerror.DISP_E_TYPEMISMATCH)
-        exec(str(exp), self.dict)
-
-
-def Register():
-    import win32com.server.register
-
-    return win32com.server.register.UseCommandLine(Interpreter)
-
-
-if __name__ == "__main__":
-    print("Registering COM server...")
-    Register()
diff --git a/lib/win32com/servers/perfmon.py b/lib/win32com/servers/perfmon.py
deleted file mode 100644
index 861c6940..00000000
--- a/lib/win32com/servers/perfmon.py
+++ /dev/null
@@ -1,34 +0,0 @@
-"""A COM Server which exposes the NT Performance monitor in a very rudimentary way
-
-Usage from VB:
-	set ob = CreateObject("Python.PerfmonQuery")
-	freeBytes = ob.Query("Memory", "Available Bytes")
-"""
-import pythoncom
-import win32pdhutil
-import winerror
-from win32com.server import exception, register
-
-
-class PerfMonQuery:
-    _reg_verprogid_ = "Python.PerfmonQuery.1"
-    _reg_progid_ = "Python.PerfmonQuery"
-    _reg_desc_ = "Python Performance Monitor query object"
-    _reg_clsid_ = "{64cef7a0-8ece-11d1-a65a-00aa00125a98}"
-    _reg_class_spec_ = "win32com.servers.perfmon.PerfMonQuery"
-    _public_methods_ = ["Query"]
-
-    def Query(self, object, counter, instance=None, machine=None):
-        try:
-            return win32pdhutil.GetPerformanceAttributes(
-                object, counter, instance, machine=machine
-            )
-        except win32pdhutil.error as exc:
-            raise exception.Exception(desc=exc.strerror)
-        except TypeError as desc:
-            raise exception.Exception(desc=desc, scode=winerror.DISP_E_TYPEMISMATCH)
-
-
-if __name__ == "__main__":
-    print("Registering COM server...")
-    register.UseCommandLine(PerfMonQuery)
diff --git a/lib/win32com/servers/test_pycomtest.py b/lib/win32com/servers/test_pycomtest.py
deleted file mode 100644
index da606efa..00000000
--- a/lib/win32com/servers/test_pycomtest.py
+++ /dev/null
@@ -1,182 +0,0 @@
-# This is part of the Python test suite.
-# The object is registered when you first run the test suite.
-# (and hopefully unregistered once done ;-)
-
-import pythoncom
-import winerror
-
-# Ensure the vtables in the tlb are known.
-from win32com import universal
-from win32com.client import constants, gencache
-from win32com.server.exception import COMException
-from win32com.server.util import wrap
-
-pythoncom.__future_currency__ = True
-# We use the constants from the module, so must insist on a gencache.
-# Otherwise, use of gencache is not necessary (tho still advised)
-gencache.EnsureModule("{6BCDCB60-5605-11D0-AE5F-CADD4C000000}", 0, 1, 1)
-
-
-class PyCOMTest:
-    _typelib_guid_ = "{6BCDCB60-5605-11D0-AE5F-CADD4C000000}"
-    _typelib_version = 1, 0
-    _com_interfaces_ = ["IPyCOMTest"]
-    _reg_clsid_ = "{e743d9cd-cb03-4b04-b516-11d3a81c1597}"
-    _reg_progid_ = "Python.Test.PyCOMTest"
-
-    def DoubleString(self, str):
-        return str * 2
-
-    def DoubleInOutString(self, str):
-        return str * 2
-
-    def Fire(self, nID):
-        raise COMException(hresult=winerror.E_NOTIMPL)
-
-    def GetLastVarArgs(self):
-        raise COMException(hresult=winerror.E_NOTIMPL)
-
-    def GetMultipleInterfaces(self, outinterface1, outinterface2):
-        raise COMException(hresult=winerror.E_NOTIMPL)
-
-    def GetSafeArrays(self, attrs, attrs2, ints):
-        raise COMException(hresult=winerror.E_NOTIMPL)
-
-    def GetSetDispatch(self, indisp):
-        raise COMException(hresult=winerror.E_NOTIMPL)
-
-    # Result is of type IPyCOMTest
-    def GetSetInterface(self, ininterface):
-        return wrap(self)
-
-    def GetSetVariant(self, indisp):
-        return indisp
-
-    def TestByRefVariant(self, v):
-        return v * 2
-
-    def TestByRefString(self, v):
-        return v * 2
-
-    # Result is of type IPyCOMTest
-    def GetSetInterfaceArray(self, ininterface):
-        raise COMException(hresult=winerror.E_NOTIMPL)
-
-    def GetSetUnknown(self, inunk):
-        raise COMException(hresult=winerror.E_NOTIMPL)
-
-    # Result is of type ISimpleCounter
-    def GetSimpleCounter(self):
-        raise COMException(hresult=winerror.E_NOTIMPL)
-
-    def GetSimpleSafeArray(self, ints):
-        raise COMException(hresult=winerror.E_NOTIMPL)
-
-    def GetStruct(self):
-        raise COMException(hresult=winerror.E_NOTIMPL)
-
-    def SetIntSafeArray(self, ints):
-        return len(ints)
-
-    def SetLongLongSafeArray(self, ints):
-        return len(ints)
-
-    def SetULongLongSafeArray(self, ints):
-        return len(ints)
-
-    def SetBinSafeArray(self, buf):
-        return len(buf)
-
-    def SetVarArgs(self, *args):
-        raise COMException(hresult=winerror.E_NOTIMPL)
-
-    def SetVariantSafeArray(self, vars):
-        raise COMException(hresult=winerror.E_NOTIMPL)
-
-    def Start(self):
-        raise COMException(hresult=winerror.E_NOTIMPL)
-
-    def Stop(self, nID):
-        raise COMException(hresult=winerror.E_NOTIMPL)
-
-    def StopAll(self):
-        raise COMException(hresult=winerror.E_NOTIMPL)
-
-    def TakeByRefDispatch(self, inout):
-        raise COMException(hresult=winerror.E_NOTIMPL)
-
-    def TakeByRefTypedDispatch(self, inout):
-        raise COMException(hresult=winerror.E_NOTIMPL)
-
-    def Test(self, key, inval):
-        return not inval
-
-    def Test2(self, inval):
-        return inval
-
-    def Test3(self, inval):
-        raise COMException(hresult=winerror.E_NOTIMPL)
-
-    def Test4(self, inval):
-        raise COMException(hresult=winerror.E_NOTIMPL)
-
-    def Test5(self, inout):
-        if inout == constants.TestAttr1:
-            return constants.TestAttr1_1
-        elif inout == constants.TestAttr1_1:
-            return constants.TestAttr1
-        else:
-            return -1
-
-    def Test6(self, inval):
-        return inval
-
-    def TestInOut(self, fval, bval, lval):
-        return winerror.S_OK, fval * 2, not bval, lval * 2
-
-    def TestOptionals(self, strArg="def", sval=0, lval=1, dval=3.1400001049041748):
-        raise COMException(hresult=winerror.E_NOTIMPL)
-
-    def TestOptionals2(self, dval, strval="", sval=1):
-        raise COMException(hresult=winerror.E_NOTIMPL)
-
-    def CheckVariantSafeArray(self, data):
-        return 1
-
-    def LongProp(self):
-        return self.longval
-
-    def SetLongProp(self, val):
-        self.longval = val
-
-    def ULongProp(self):
-        return self.ulongval
-
-    def SetULongProp(self, val):
-        self.ulongval = val
-
-    def IntProp(self):
-        return self.intval
-
-    def SetIntProp(self, val):
-        self.intval = val
-
-
-class PyCOMTestMI(PyCOMTest):
-    _typelib_guid_ = "{6BCDCB60-5605-11D0-AE5F-CADD4C000000}"
-    _typelib_version = 1, 0
-    # Interfaces with a interface name, a real IID, and an IID as a string
-    _com_interfaces_ = [
-        "IPyCOMTest",
-        pythoncom.IID_IStream,
-        str(pythoncom.IID_IStorage),
-    ]
-    _reg_clsid_ = "{F506E9A1-FB46-4238-A597-FA4EB69787CA}"
-    _reg_progid_ = "Python.Test.PyCOMTestMI"
-
-
-if __name__ == "__main__":
-    import win32com.server.register
-
-    win32com.server.register.UseCommandLine(PyCOMTest)
-    win32com.server.register.UseCommandLine(PyCOMTestMI)
diff --git a/lib/win32com/storagecon.py b/lib/win32com/storagecon.py
deleted file mode 100644
index 3ed52902..00000000
--- a/lib/win32com/storagecon.py
+++ /dev/null
@@ -1,142 +0,0 @@
-"""Constants related to IStorage and related interfaces
-
-This file was generated by h2py from d:\msdev\include\objbase.h
-then hand edited, a few extra constants added, etc.
-"""
-
-STGC_DEFAULT = 0
-STGC_OVERWRITE = 1
-STGC_ONLYIFCURRENT = 2
-STGC_DANGEROUSLYCOMMITMERELYTODISKCACHE = 4
-STGC_CONSOLIDATE = 8
-
-STGTY_STORAGE = 1
-STGTY_STREAM = 2
-STGTY_LOCKBYTES = 3
-STGTY_PROPERTY = 4
-STREAM_SEEK_SET = 0
-STREAM_SEEK_CUR = 1
-STREAM_SEEK_END = 2
-
-LOCK_WRITE = 1
-LOCK_EXCLUSIVE = 2
-LOCK_ONLYONCE = 4
-
-# Generated as from here.
-
-CWCSTORAGENAME = 32
-STGM_DIRECT = 0x00000000
-STGM_TRANSACTED = 0x00010000
-STGM_SIMPLE = 0x08000000
-STGM_READ = 0x00000000
-STGM_WRITE = 0x00000001
-STGM_READWRITE = 0x00000002
-STGM_SHARE_DENY_NONE = 0x00000040
-STGM_SHARE_DENY_READ = 0x00000030
-STGM_SHARE_DENY_WRITE = 0x00000020
-STGM_SHARE_EXCLUSIVE = 0x00000010
-STGM_PRIORITY = 0x00040000
-STGM_DELETEONRELEASE = 0x04000000
-STGM_NOSCRATCH = 0x00100000
-STGM_CREATE = 0x00001000
-STGM_CONVERT = 0x00020000
-STGM_FAILIFTHERE = 0x00000000
-STGM_NOSNAPSHOT = 0x00200000
-ASYNC_MODE_COMPATIBILITY = 0x00000001
-ASYNC_MODE_DEFAULT = 0x00000000
-STGTY_REPEAT = 0x00000100
-STG_TOEND = 0xFFFFFFFF
-STG_LAYOUT_SEQUENTIAL = 0x00000000
-STG_LAYOUT_INTERLEAVED = 0x00000001
-
-## access rights used with COM server ACL's
-COM_RIGHTS_EXECUTE = 1
-COM_RIGHTS_EXECUTE_LOCAL = 2
-COM_RIGHTS_EXECUTE_REMOTE = 4
-COM_RIGHTS_ACTIVATE_LOCAL = 8
-COM_RIGHTS_ACTIVATE_REMOTE = 16
-
-STGFMT_DOCUMENT = 0
-STGFMT_STORAGE = 0
-STGFMT_NATIVE = 1
-STGFMT_FILE = 3
-STGFMT_ANY = 4
-STGFMT_DOCFILE = 5
-
-PID_DICTIONARY = 0
-PID_CODEPAGE = 1
-PID_FIRST_USABLE = 2
-PID_FIRST_NAME_DEFAULT = 4095
-
-PID_LOCALE = -2147483648
-PID_MODIFY_TIME = -2147483647
-PID_SECURITY = -2147483646
-PID_BEHAVIOR = -2147483645
-PID_ILLEGAL = -1
-PID_MIN_READONLY = -2147483648
-PID_MAX_READONLY = -1073741825
-
-## DiscardableInformation
-PIDDI_THUMBNAIL = 0x00000002
-
-## SummaryInformation
-PIDSI_TITLE = 2
-PIDSI_SUBJECT = 3
-PIDSI_AUTHOR = 4
-PIDSI_KEYWORDS = 5
-PIDSI_COMMENTS = 6
-PIDSI_TEMPLATE = 7
-PIDSI_LASTAUTHOR = 8
-PIDSI_REVNUMBER = 9
-PIDSI_EDITTIME = 10
-PIDSI_LASTPRINTED = 11
-PIDSI_CREATE_DTM = 12
-PIDSI_LASTSAVE_DTM = 13
-PIDSI_PAGECOUNT = 14
-PIDSI_WORDCOUNT = 15
-PIDSI_CHARCOUNT = 16
-PIDSI_THUMBNAIL = 17
-PIDSI_APPNAME = 18
-PIDSI_DOC_SECURITY = 19
-
-## DocSummaryInformation
-PIDDSI_CATEGORY = 2
-PIDDSI_PRESFORMAT = 3
-PIDDSI_BYTECOUNT = 4
-PIDDSI_LINECOUNT = 5
-PIDDSI_PARCOUNT = 6
-PIDDSI_SLIDECOUNT = 7
-PIDDSI_NOTECOUNT = 8
-PIDDSI_HIDDENCOUNT = 9
-PIDDSI_MMCLIPCOUNT = 10
-PIDDSI_SCALE = 11
-PIDDSI_HEADINGPAIR = 12
-PIDDSI_DOCPARTS = 13
-PIDDSI_MANAGER = 14
-PIDDSI_COMPANY = 15
-PIDDSI_LINKSDIRTY = 16
-
-
-## MediaFileSummaryInfo
-PIDMSI_EDITOR = 2
-PIDMSI_SUPPLIER = 3
-PIDMSI_SOURCE = 4
-PIDMSI_SEQUENCE_NO = 5
-PIDMSI_PROJECT = 6
-PIDMSI_STATUS = 7
-PIDMSI_OWNER = 8
-PIDMSI_RATING = 9
-PIDMSI_PRODUCTION = 10
-PIDMSI_COPYRIGHT = 11
-
-## PROPSETFLAG enum
-PROPSETFLAG_DEFAULT = 0
-PROPSETFLAG_NONSIMPLE = 1
-PROPSETFLAG_ANSI = 2
-PROPSETFLAG_UNBUFFERED = 4
-PROPSETFLAG_CASE_SENSITIVE = 8
-
-## STGMOVE enum
-STGMOVE_MOVE = 0
-STGMOVE_COPY = 1
-STGMOVE_SHALLOWCOPY = 2
diff --git a/lib/win32com/test/GenTestScripts.py b/lib/win32com/test/GenTestScripts.py
deleted file mode 100644
index 73bb2641..00000000
--- a/lib/win32com/test/GenTestScripts.py
+++ /dev/null
@@ -1,95 +0,0 @@
-#
-# Generate scripts needed for serious testing!
-#
-import os
-import sys
-
-import pythoncom
-import win32com
-import win32com.client.makepy
-import win32com.test
-
-genList = [
-    ("msword8", "{00020905-0000-0000-C000-000000000046}", 1033, 8, 0),
-]
-
-genDir = "Generated4Test"
-
-
-def GetGenPath():
-    import win32api
-
-    return os.path.join(win32api.GetFullPathName(win32com.test.__path__[0]), genDir)
-
-
-def GenerateFromRegistered(fname, *loadArgs):
-    #       tlb = apply(pythoncom.LoadRegTypeLib, loadArgs)
-    genPath = GetGenPath()
-    try:
-        os.stat(genPath)
-    except os.error:
-        os.mkdir(genPath)
-    # Ensure an __init__ exists.
-    open(os.path.join(genPath, "__init__.py"), "w").close()
-    print(fname, ": generating -", end=" ")
-    f = open(os.path.join(genPath, fname + ".py"), "w")
-    win32com.client.makepy.GenerateFromTypeLibSpec(
-        loadArgs, f, bQuiet=1, bGUIProgress=1
-    )
-    f.close()
-    print("compiling -", end=" ")
-    fullModName = "win32com.test.%s.%s" % (genDir, fname)
-    exec("import " + fullModName)
-    # Inject the generated module as a top level module.
-    sys.modules[fname] = sys.modules[fullModName]
-    print("done")
-
-
-def GenerateAll():
-    for args in genList:
-        try:
-            GenerateFromRegistered(*args)
-        except KeyboardInterrupt:
-            print("** Interrupted ***")
-            break
-        except pythoncom.com_error:
-            print("** Could not generate test code for ", args[0])
-
-
-def CleanAll():
-    print("Cleaning generated test scripts...")
-    try:  # Clear exceptions!
-        1 / 0
-    except:
-        pass
-    genPath = GetGenPath()
-    for args in genList:
-        try:
-            name = args[0] + ".py"
-            os.unlink(os.path.join(genPath, name))
-        except os.error as details:
-            if type(details) == type(()) and details[0] != 2:
-                print("Could not deleted generated", name, details)
-        try:
-            name = args[0] + ".pyc"
-            os.unlink(os.path.join(genPath, name))
-        except os.error as details:
-            if type(details) == type(()) and details[0] != 2:
-                print("Could not deleted generated", name, details)
-        try:
-            os.unlink(os.path.join(genPath, "__init__.py"))
-        except:
-            pass
-        try:
-            os.unlink(os.path.join(genPath, "__init__.pyc"))
-        except:
-            pass
-    try:
-        os.rmdir(genPath)
-    except os.error as details:
-        print("Could not delete test directory -", details)
-
-
-if __name__ == "__main__":
-    GenerateAll()
-    CleanAll()
diff --git a/lib/win32com/test/Testpys.sct b/lib/win32com/test/Testpys.sct
deleted file mode 100644
index dd9b4e00..00000000
--- a/lib/win32com/test/Testpys.sct
+++ /dev/null
@@ -1,64 +0,0 @@
-<scriptlet>
-
-<Registration
-  Description="TestPys"
-  ProgID="TestPys.Scriptlet"
-  Version="1"
-  ClassID="{2eeb6080-cd58-11d1-b81e-00a0240b2fef}">
-
-  <SCRIPT LANGUAGE="VBScript">      
-	Function Register()
-		Msgbox "Scriptlet 'Test' registered."      
-	End Function
-    
-	Function Unregister()
-		Msgbox "Scriptlet 'Test' unregistered."      
-	End Function
-   </SCRIPT>
-</Registration>
-
-<implements id=Automation type=Automation>
-  <property name=PyProp1>
-    <get/>
-    <put/>
-  </property>
-  <property name=PyProp2>
-    <get/>
-    <put/>
-  </property>
-  <method name=PyMethod1>
-  </method>
-
-  <method name=PyMethod2>
-  </method>
-</implements>
-
-<script language=python>
-
-PyProp1 = "PyScript Property1";
-PyProp2 = "PyScript Property2";
-
-def get_PyProp1():
-  return PyProp1
-
-def put_PyProp1(newValue):
-  global PyProp1
-  PyProp1 = newValue
-
-def get_PyProp2():
-  return PyProp2
-
-def put_PyProp2(newValue):
-  global PyProp2
-  PyProp2 = newValue
-
-def PyMethod1():
-  return "PyMethod1 called"
-
-def PyMethod2():
-  return "PyMethod2 called"
-
-</script>
-
-</scriptlet>
-
diff --git a/lib/win32com/test/__init__.py b/lib/win32com/test/__init__.py
deleted file mode 100644
index cb6d7f47..00000000
--- a/lib/win32com/test/__init__.py
+++ /dev/null
@@ -1 +0,0 @@
-# Empty file to designate a Python package
diff --git a/lib/win32com/test/daodump.py b/lib/win32com/test/daodump.py
deleted file mode 100644
index c222087a..00000000
--- a/lib/win32com/test/daodump.py
+++ /dev/null
@@ -1,90 +0,0 @@
-# import dao3032
-# No longer imported here - callers responsibility to load
-#
-import win32com.client
-
-
-def DumpDB(db, bDeep=1):
-    # MUST be a DB object.
-    DumpTables(db, bDeep)
-    DumpRelations(db, bDeep)
-    DumpAllContainers(db, bDeep)
-
-
-def DumpTables(db, bDeep=1):
-    for tab in db.TableDefs:
-        tab = db.TableDefs(tab.Name)  # Redundant lookup for testing purposes.
-        print(
-            "Table %s - Fields: %d, Attributes:%d"
-            % (tab.Name, len(tab.Fields), tab.Attributes)
-        )
-        if bDeep:
-            DumpFields(tab.Fields)
-
-
-def DumpFields(fields):
-    for field in fields:
-        print(
-            "  %s, size=%d, reqd=%d, type=%d, defVal=%s"
-            % (
-                field.Name,
-                field.Size,
-                field.Required,
-                field.Type,
-                str(field.DefaultValue),
-            )
-        )
-
-
-def DumpRelations(db, bDeep=1):
-    for relation in db.Relations:
-        print(
-            "Relation %s - %s->%s"
-            % (relation.Name, relation.Table, relation.ForeignTable)
-        )
-
-
-#### This dont work.  TLB says it is a Fields collection, but apparently not!
-####            if bDeep: DumpFields(relation.Fields)
-
-
-def DumpAllContainers(db, bDeep=1):
-    for cont in db.Containers:
-        print("Container %s - %d documents" % (cont.Name, len(cont.Documents)))
-        if bDeep:
-            DumpContainerDocuments(cont)
-
-
-def DumpContainerDocuments(container):
-    for doc in container.Documents:
-        import time
-
-        timeStr = time.ctime(int(doc.LastUpdated))
-        print("  %s - updated %s (" % (doc.Name, timeStr), end=" ")
-        print(doc.LastUpdated, ")")  # test the _print_ method?
-
-
-def TestEngine(engine):
-    import sys
-
-    if len(sys.argv) > 1:
-        dbName = sys.argv[1]
-    else:
-        dbName = "e:\\temp\\TestPython.mdb"
-    db = engine.OpenDatabase(dbName)
-    DumpDB(db)
-
-
-def test():
-    for progid in ("DAO.DBEngine.36", "DAO.DBEngine.35", "DAO.DBEngine.30"):
-        try:
-            ob = win32com.client.gencache.EnsureDispatch(progid)
-        except pythoncom.com_error:
-            print(progid, "does not seem to be installed")
-        else:
-            TestEngine(ob)
-            break
-
-
-if __name__ == "__main__":
-    test()
diff --git a/lib/win32com/test/errorSemantics.py b/lib/win32com/test/errorSemantics.py
deleted file mode 100644
index 49ebae2f..00000000
--- a/lib/win32com/test/errorSemantics.py
+++ /dev/null
@@ -1,259 +0,0 @@
-# errorSemantics.py
-
-# Test the Python error handling semantics.  Specifically:
-#
-# * When a Python COM object is called via IDispatch, the nominated
-#   scode is placed in the exception tuple, and the HRESULT is
-#   DISP_E_EXCEPTION
-# * When the same interface is called via IWhatever, the
-#   nominated  scode is returned directly (with the scode also
-#   reflected in the exception tuple)
-# * In all cases, the description etc end up in the exception tuple
-# * "Normal" Python exceptions resolve to an E_FAIL "internal error"
-
-import pythoncom
-import winerror
-from win32com.client import Dispatch
-from win32com.server.exception import COMException
-from win32com.server.util import wrap
-from win32com.test.util import CaptureWriter
-
-
-class error(Exception):
-    def __init__(self, msg, com_exception=None):
-        Exception.__init__(self, msg, str(com_exception))
-
-
-# Our COM server.
-class TestServer:
-    _public_methods_ = ["Clone", "Commit", "LockRegion", "Read"]
-    _com_interfaces_ = [pythoncom.IID_IStream]
-
-    def Clone(self):
-        raise COMException("Not today", scode=winerror.E_UNEXPECTED)
-
-    def Commit(self, flags):
-        # Testing unicode: 1F600   '😀'; GRINNING FACE
-        # Use the 'name' just for fun!
-        if flags == 0:
-            # A non com-specific exception.
-            raise Exception("\N{GRINNING FACE}")
-        # An explicit com_error, which is a bit of an edge-case, but might happen if
-        # a COM server itself calls another COM object and it fails.
-        excepinfo = (
-            winerror.E_UNEXPECTED,
-            "source",
-            "\N{GRINNING FACE}",
-            "helpfile",
-            1,
-            winerror.E_FAIL,
-        )
-        raise pythoncom.com_error(winerror.E_UNEXPECTED, "desc", excepinfo, None)
-
-
-def test():
-    # Call via a native interface.
-    com_server = wrap(TestServer(), pythoncom.IID_IStream)
-    try:
-        com_server.Clone()
-        raise error("Expecting this call to fail!")
-    except pythoncom.com_error as com_exc:
-        if com_exc.hresult != winerror.E_UNEXPECTED:
-            raise error(
-                "Calling the object natively did not yield the correct scode", com_exc
-            )
-        exc = com_exc.excepinfo
-        if not exc or exc[-1] != winerror.E_UNEXPECTED:
-            raise error(
-                "The scode element of the exception tuple did not yield the correct scode",
-                com_exc,
-            )
-        if exc[2] != "Not today":
-            raise error(
-                "The description in the exception tuple did not yield the correct string",
-                com_exc,
-            )
-    cap = CaptureWriter()
-    try:
-        cap.capture()
-        try:
-            com_server.Commit(0)
-        finally:
-            cap.release()
-        raise error("Expecting this call to fail!")
-    except pythoncom.com_error as com_exc:
-        if com_exc.hresult != winerror.E_FAIL:
-            raise error("The hresult was not E_FAIL for an internal error", com_exc)
-        if com_exc.excepinfo[1] != "Python COM Server Internal Error":
-            raise error(
-                "The description in the exception tuple did not yield the correct string",
-                com_exc,
-            )
-    # Check we saw a traceback in stderr
-    if cap.get_captured().find("Traceback") < 0:
-        raise error("Could not find a traceback in stderr: %r" % (cap.get_captured(),))
-
-    # Now do it all again, but using IDispatch
-    com_server = Dispatch(wrap(TestServer()))
-    try:
-        com_server.Clone()
-        raise error("Expecting this call to fail!")
-    except pythoncom.com_error as com_exc:
-        if com_exc.hresult != winerror.DISP_E_EXCEPTION:
-            raise error(
-                "Calling the object via IDispatch did not yield the correct scode",
-                com_exc,
-            )
-        exc = com_exc.excepinfo
-        if not exc or exc[-1] != winerror.E_UNEXPECTED:
-            raise error(
-                "The scode element of the exception tuple did not yield the correct scode",
-                com_exc,
-            )
-        if exc[2] != "Not today":
-            raise error(
-                "The description in the exception tuple did not yield the correct string",
-                com_exc,
-            )
-
-    cap.clear()
-    try:
-        cap.capture()
-        try:
-            com_server.Commit(0)
-        finally:
-            cap.release()
-        raise error("Expecting this call to fail!")
-    except pythoncom.com_error as com_exc:
-        if com_exc.hresult != winerror.DISP_E_EXCEPTION:
-            raise error(
-                "Calling the object via IDispatch did not yield the correct scode",
-                com_exc,
-            )
-        exc = com_exc.excepinfo
-        if not exc or exc[-1] != winerror.E_FAIL:
-            raise error(
-                "The scode element of the exception tuple did not yield the correct scode",
-                com_exc,
-            )
-        if exc[1] != "Python COM Server Internal Error":
-            raise error(
-                "The description in the exception tuple did not yield the correct string",
-                com_exc,
-            )
-    # Check we saw a traceback in stderr
-    if cap.get_captured().find("Traceback") < 0:
-        raise error("Could not find a traceback in stderr: %r" % (cap.get_captured(),))
-
-    # And an explicit com_error
-    cap.clear()
-    try:
-        cap.capture()
-        try:
-            com_server.Commit(1)
-        finally:
-            cap.release()
-        raise error("Expecting this call to fail!")
-    except pythoncom.com_error as com_exc:
-        if com_exc.hresult != winerror.DISP_E_EXCEPTION:
-            raise error(
-                "Calling the object via IDispatch did not yield the correct scode",
-                com_exc,
-            )
-        exc = com_exc.excepinfo
-        if not exc or exc[-1] != winerror.E_FAIL:
-            raise error(
-                "The scode element of the exception tuple did not yield the correct scode",
-                com_exc,
-            )
-        if exc[1] != "source":
-            raise error(
-                "The source in the exception tuple did not yield the correct string",
-                com_exc,
-            )
-        if exc[2] != "\U0001F600":
-            raise error(
-                "The description in the exception tuple did not yield the correct string",
-                com_exc,
-            )
-        if exc[3] != "helpfile":
-            raise error(
-                "The helpfile in the exception tuple did not yield the correct string",
-                com_exc,
-            )
-        if exc[4] != 1:
-            raise error(
-                "The help context in the exception tuple did not yield the correct string",
-                com_exc,
-            )
-
-
-try:
-    import logging
-except ImportError:
-    logging = None
-if logging is not None:
-    import win32com
-
-    class TestLogHandler(logging.Handler):
-        def __init__(self):
-            self.reset()
-            logging.Handler.__init__(self)
-
-        def reset(self):
-            self.num_emits = 0
-            self.last_record = None
-
-        def emit(self, record):
-            self.num_emits += 1
-            self.last_record = self.format(record)
-            return
-            print("--- record start")
-            print(self.last_record)
-            print("--- record end")
-
-    def testLogger():
-        assert not hasattr(win32com, "logger")
-        handler = TestLogHandler()
-        formatter = logging.Formatter("%(message)s")
-        handler.setFormatter(formatter)
-        log = logging.getLogger("win32com_test")
-        log.addHandler(handler)
-        win32com.logger = log
-        # Now throw some exceptions!
-        # Native interfaces
-        com_server = wrap(TestServer(), pythoncom.IID_IStream)
-        try:
-            com_server.Commit(0)
-            raise RuntimeError("should have failed")
-        except pythoncom.error as exc:
-            # `excepinfo` is a tuple with elt 2 being the traceback we captured.
-            message = exc.excepinfo[2]
-            assert message.endswith("Exception: \U0001F600\n")
-        assert handler.num_emits == 1, handler.num_emits
-        assert handler.last_record.startswith(
-            "pythoncom error: Unexpected exception in gateway method 'Commit'"
-        )
-        handler.reset()
-
-        # IDispatch
-        com_server = Dispatch(wrap(TestServer()))
-        try:
-            com_server.Commit(0)
-            raise RuntimeError("should have failed")
-        except pythoncom.error as exc:
-            # `excepinfo` is a tuple with elt 2 being the traceback we captured.
-            message = exc.excepinfo[2]
-            assert message.endswith("Exception: \U0001F600\n")
-        assert handler.num_emits == 1, handler.num_emits
-        handler.reset()
-
-
-if __name__ == "__main__":
-    test()
-    if logging is not None:
-        testLogger()
-    from win32com.test.util import CheckClean
-
-    CheckClean()
-    print("error semantic tests worked")
diff --git a/lib/win32com/test/pippo.idl b/lib/win32com/test/pippo.idl
deleted file mode 100644
index 4222684c..00000000
--- a/lib/win32com/test/pippo.idl
+++ /dev/null
@@ -1,66 +0,0 @@
-// TestServer.idl : IDL source for TestServer.dll
-//
-
-// This file will be processed by the MIDL tool to
-// produce the type library (TestServer.tlb) and marshalling code.
-
-import "oaidl.idl";
-import "ocidl.idl";
-	[
-		object,
-		uuid(50086EE8-F535-464B-806E-365ADBB727CF),
-		dual,
-		helpstring("ITestServerApp Interface"),
-		pointer_default(unique)
-	]
-	interface ITestServerApp : IDispatch
-	{
-		[id(1), helpstring("method Test1")] HRESULT Test1([out, retval] ITestServerApp **pVal);
-		[id(2), helpstring("method Test2")] HRESULT Test2([out, retval] VARIANT *pVar);
-		[propget, id(3), helpstring("property MyProp1")] HRESULT MyProp1([out, retval] long *pVal);
-	};
-	[
-		object,
-		uuid(618DB2A3-D5BD-4850-B66A-828727EB37E5),
-		dual,
-		helpstring("IPippo Interface"),
-		pointer_default(unique)
-	]
-	interface IPippo : IDispatch
-	{		
-		[id(1), helpstring("method Method1")] HRESULT Method1([out, retval] IPippo **val);
-		[propget, id(2), helpstring("property MyProp1")] HRESULT MyProp1([out, retval] long *pVal);
-		[id(3), helpstring("method Method2")] HRESULT Method2([in] long in1, [in, out] long *inout1,
-		                                                      [out, retval] long *val);
-		[id(4), helpstring("method Method3")] HRESULT Method3([in] VARIANT in1,
-		                                                      [out, retval] VARIANT *val);
-	};
-
-[
-	uuid(7783054E-9A20-4584-8C62-6ED2A08F6AC6),
-	version(1.0),
-	helpstring("TestServer 1.0 Type Library")
-]
-library TESTSERVERLib
-{
-	importlib("stdole32.tlb");
-	importlib("stdole2.tlb");
-	importlib("msado15.dll");
-
-	[
-		uuid(49E44E89-5A72-4456-B1D5-68268A19E798),
-		helpstring("TestServerApp Class")
-	]
-	coclass TestServerApp
-	{
-		[default] interface ITestServerApp;
-	};
-	[
-		uuid(1F0F75D6-BD63-41B9-9F88-2D9D2E1AA5C3),
-		helpstring("Pippo Class")
-	]
-	coclass Pippo
-	{
-		[default] interface IPippo;
-	};
-};
diff --git a/lib/win32com/test/pippo_server.py b/lib/win32com/test/pippo_server.py
deleted file mode 100644
index edcd9168..00000000
--- a/lib/win32com/test/pippo_server.py
+++ /dev/null
@@ -1,97 +0,0 @@
-# A little test server, complete with typelib, we can use for testing.
-# Originally submitted with bug:
-# [ 753154 ] memory leak wrapping object having _typelib_guid_ attribute
-# but modified by mhammond for use as part of the test suite.
-import os
-import sys
-
-import pythoncom
-import win32com
-import winerror
-from win32com.server.util import wrap
-
-
-class CPippo:
-    #
-    # COM declarations
-    #
-    _reg_clsid_ = "{1F0F75D6-BD63-41B9-9F88-2D9D2E1AA5C3}"
-    _reg_desc_ = "Pippo Python test object"
-    _reg_progid_ = "Python.Test.Pippo"
-    # _reg_clsctx_ = pythoncom.CLSCTX_LOCAL_SERVER
-    ###
-    ### Link to typelib
-    _typelib_guid_ = "{7783054E-9A20-4584-8C62-6ED2A08F6AC6}"
-    _typelib_version_ = 1, 0
-    _com_interfaces_ = ["IPippo"]
-
-    def __init__(self):
-        self.MyProp1 = 10
-
-    def Method1(self):
-        return wrap(CPippo())
-
-    def Method2(self, in1, inout1):
-        return in1, inout1 * 2
-
-    def Method3(self, in1):
-        # in1 will be a tuple, not a list.
-        # Yet, we are not allowed to return a tuple, but need to convert it to a list first. (Bug?)
-        return list(in1)
-
-
-def BuildTypelib():
-    from distutils.dep_util import newer
-
-    this_dir = os.path.dirname(__file__)
-    idl = os.path.abspath(os.path.join(this_dir, "pippo.idl"))
-    tlb = os.path.splitext(idl)[0] + ".tlb"
-    if newer(idl, tlb):
-        print("Compiling %s" % (idl,))
-        rc = os.system('midl "%s"' % (idl,))
-        if rc:
-            raise RuntimeError("Compiling MIDL failed!")
-        # Can't work out how to prevent MIDL from generating the stubs.
-        # just nuke them
-        for fname in "dlldata.c pippo_i.c pippo_p.c pippo.h".split():
-            os.remove(os.path.join(this_dir, fname))
-
-    print("Registering %s" % (tlb,))
-    tli = pythoncom.LoadTypeLib(tlb)
-    pythoncom.RegisterTypeLib(tli, tlb)
-
-
-def UnregisterTypelib():
-    k = CPippo
-    try:
-        pythoncom.UnRegisterTypeLib(
-            k._typelib_guid_,
-            k._typelib_version_[0],
-            k._typelib_version_[1],
-            0,
-            pythoncom.SYS_WIN32,
-        )
-        print("Unregistered typelib")
-    except pythoncom.error as details:
-        if details[0] == winerror.TYPE_E_REGISTRYACCESS:
-            pass
-        else:
-            raise
-
-
-def main(argv=None):
-    if argv is None:
-        argv = sys.argv[1:]
-    if "--unregister" in argv:
-        # Unregister the type-libraries.
-        UnregisterTypelib()
-    else:
-        # Build and register the type-libraries.
-        BuildTypelib()
-    import win32com.server.register
-
-    win32com.server.register.UseCommandLine(CPippo)
-
-
-if __name__ == "__main__":
-    main(sys.argv)
diff --git a/lib/win32com/test/policySemantics.py b/lib/win32com/test/policySemantics.py
deleted file mode 100644
index 746522f7..00000000
--- a/lib/win32com/test/policySemantics.py
+++ /dev/null
@@ -1,116 +0,0 @@
-import unittest
-
-import pythoncom
-import win32com.client
-import win32com.server.util
-import win32com.test.util
-import winerror
-
-
-class Error(Exception):
-    pass
-
-
-# An object representing a list of numbers
-class PythonSemanticClass:
-    _public_methods_ = ["In"]  # DISPIDs are allocated.
-    _dispid_to_func_ = {10: "Add", 11: "Remove"}  # DISPIDs specified by the object.
-
-    def __init__(self):
-        self.list = []
-
-    def _NewEnum(self):
-        return win32com.server.util.NewEnum(self.list)
-
-    def _value_(self):
-        # should return an array.
-        return self.list
-
-    def _Evaluate(self):
-        # return the sum
-        return sum(self.list)
-
-    def In(self, value):
-        return value in self.list
-
-    def Add(self, value):
-        self.list.append(value)
-
-    def Remove(self, value):
-        self.list.remove(value)
-
-
-def DispExTest(ob):
-    if not __debug__:
-        print("WARNING: Tests dressed up as assertions are being skipped!")
-    assert ob.GetDispID("Add", 0) == 10, "Policy did not honour the dispid"
-    # Not impl
-    #       assert ob.GetMemberName(10, 0)=="add", "Policy did not give me the correct function for the dispid"
-    assert ob.GetDispID("Remove", 0) == 11, "Policy did not honour the dispid"
-    assert ob.GetDispID("In", 0) == 1000, "Allocated dispid unexpected value"
-    assert (
-        ob.GetDispID("_NewEnum", 0) == pythoncom.DISPID_NEWENUM
-    ), "_NewEnum() got unexpected DISPID"
-    dispids = []
-    dispid = -1
-    while 1:
-        try:
-            dispid = ob.GetNextDispID(0, dispid)
-            dispids.append(dispid)
-        except pythoncom.com_error as xxx_todo_changeme:
-            (hr, desc, exc, arg) = xxx_todo_changeme.args
-            assert hr == winerror.S_FALSE, "Bad result at end of enum"
-            break
-    dispids.sort()
-    if dispids != [pythoncom.DISPID_EVALUATE, pythoncom.DISPID_NEWENUM, 10, 11, 1000]:
-        raise Error("Got back the wrong dispids: %s" % dispids)
-
-
-def SemanticTest(ob):
-    # First just check our object "generally" as expected.
-    ob.Add(1)
-    ob.Add(2)
-    ob.Add(3)
-    # invoke _value_
-    if ob() != (1, 2, 3):
-        raise Error("Bad result - got %s" % (repr(ob())))
-
-    dispob = ob._oleobj_
-
-    rc = dispob.Invoke(
-        pythoncom.DISPID_EVALUATE,
-        0,
-        pythoncom.DISPATCH_METHOD | pythoncom.DISPATCH_PROPERTYGET,
-        1,
-    )
-    if rc != 6:
-        raise Error("Evaluate returned %d" % rc)
-
-
-class Tester(win32com.test.util.TestCase):
-    def setUp(self):
-        debug = 0
-        import win32com.server.dispatcher
-
-        if debug:
-            dispatcher = win32com.server.dispatcher.DefaultDebugDispatcher
-        else:
-            dispatcher = None
-        disp = win32com.server.util.wrap(
-            PythonSemanticClass(), useDispatcher=dispatcher
-        )
-        self.ob = win32com.client.Dispatch(disp)
-
-    def tearDown(self):
-        self.ob = None
-
-    def testSemantics(self):
-        SemanticTest(self.ob)
-
-    def testIDispatchEx(self):
-        dispexob = self.ob._oleobj_.QueryInterface(pythoncom.IID_IDispatchEx)
-        DispExTest(dispexob)
-
-
-if __name__ == "__main__":
-    unittest.main()
diff --git a/lib/win32com/test/readme.txt b/lib/win32com/test/readme.txt
deleted file mode 100644
index 02edbd55..00000000
--- a/lib/win32com/test/readme.txt
+++ /dev/null
@@ -1,18 +0,0 @@
-COM Test Suite Readme
----------------------
-
-Running the test suite:
------------------------
-* Open a command prompt
-* Change to the "win32com\test" directory.
-* run "testall.py".  This will perform level 1 testing.
-  You may specify 1, 2, or 3 on the command line ("testutil 3")
-  to execute more tests.
-
-In general, this should just run the best it can, utilizing what is available
-on the machine.  It is likely some tests will refuse to run due to objects not
-being locally available - this is normal.
-
-The win32com source tree has source code to a C++ and VB component used purely
-for testing.  You may like to build and register these, particularly if you 
-are doing anything related to argument/result handling.
diff --git a/lib/win32com/test/testADOEvents.py b/lib/win32com/test/testADOEvents.py
deleted file mode 100644
index c79b2f7e..00000000
--- a/lib/win32com/test/testADOEvents.py
+++ /dev/null
@@ -1,100 +0,0 @@
-import os
-import time
-
-import pythoncom
-from win32com.client import Dispatch, DispatchWithEvents, constants
-
-finished = 0  # Flag for the wait loop from (3) to test
-
-
-class ADOEvents:  # event handler class
-    def OnWillConnect(self, str, user, pw, opt, sts, cn):
-        # Must have this event, as if it is not handled, ADO assumes the
-        # operation is cancelled, and raises an error (Operation cancelled
-        # by the user)
-        pass
-
-    def OnConnectComplete(self, error, status, connection):
-        # Assume no errors, until we have the basic stuff
-        # working. Now, "connection" should be an open
-        # connection to my data source
-        # Do the "something" from (2). For now, just
-        # print the connection data source
-        print("connection is", connection)
-        print("Connected to", connection.Properties("Data Source"))
-        # OK, our work is done. Let the main loop know
-        global finished
-        finished = 1
-
-    def OnCommitTransComplete(self, pError, adStatus, pConnection):
-        pass
-
-    def OnInfoMessage(self, pError, adStatus, pConnection):
-        pass
-
-    def OnDisconnect(self, adStatus, pConnection):
-        pass
-
-    def OnBeginTransComplete(self, TransactionLevel, pError, adStatus, pConnection):
-        pass
-
-    def OnRollbackTransComplete(self, pError, adStatus, pConnection):
-        pass
-
-    def OnExecuteComplete(
-        self, RecordsAffected, pError, adStatus, pCommand, pRecordset, pConnection
-    ):
-        pass
-
-    def OnWillExecute(
-        self,
-        Source,
-        CursorType,
-        LockType,
-        Options,
-        adStatus,
-        pCommand,
-        pRecordset,
-        pConnection,
-    ):
-        pass
-
-
-def TestConnection(dbname):
-    # Create the ADO connection object, and link the event
-    # handlers into it
-    c = DispatchWithEvents("ADODB.Connection", ADOEvents)
-
-    # Initiate the asynchronous open
-    dsn = "Driver={Microsoft Access Driver (*.mdb)};Dbq=%s" % dbname
-    user = "system"
-    pw = "manager"
-    c.Open(dsn, user, pw, constants.adAsyncConnect)
-
-    # Sit in a loop, until our event handler (above) sets the
-    # "finished" flag or we time out.
-    end_time = time.clock() + 10
-    while time.clock() < end_time:
-        # Pump messages so that COM gets a look in
-        pythoncom.PumpWaitingMessages()
-    if not finished:
-        print("XXX - Failed to connect!")
-
-
-def Test():
-    from . import testAccess
-
-    try:
-        testAccess.GenerateSupport()
-    except pythoncom.com_error:
-        print("*** Can not import the MSAccess type libraries - tests skipped")
-        return
-    dbname = testAccess.CreateTestAccessDatabase()
-    try:
-        TestConnection(dbname)
-    finally:
-        os.unlink(dbname)
-
-
-if __name__ == "__main__":
-    Test()
diff --git a/lib/win32com/test/testAXScript.py b/lib/win32com/test/testAXScript.py
deleted file mode 100644
index c37a5aff..00000000
--- a/lib/win32com/test/testAXScript.py
+++ /dev/null
@@ -1,43 +0,0 @@
-# Test AXScripting the best we can in an automated fashion...
-import os
-import sys
-
-import win32api
-import win32com.axscript
-import win32com.axscript.client
-import win32com.test.util
-
-verbose = "-v" in sys.argv
-
-
-class AXScript(win32com.test.util.TestCase):
-    def setUp(self):
-        file = win32api.GetFullPathName(
-            os.path.join(win32com.axscript.client.__path__[0], "pyscript.py")
-        )
-        from win32com.test.util import RegisterPythonServer
-
-        self.verbose = verbose
-        RegisterPythonServer(file, "python", verbose=self.verbose)
-
-    def testHost(self):
-        file = win32api.GetFullPathName(
-            os.path.join(win32com.axscript.__path__[0], "test\\testHost.py")
-        )
-        cmd = '%s "%s"' % (win32api.GetModuleFileName(0), file)
-        if verbose:
-            print("Testing Python Scripting host")
-        win32com.test.util.ExecuteShellCommand(cmd, self)
-
-    def testCScript(self):
-        file = win32api.GetFullPathName(
-            os.path.join(win32com.axscript.__path__[0], "Demos\\Client\\wsh\\test.pys")
-        )
-        cmd = 'cscript.exe "%s"' % (file)
-        if verbose:
-            print("Testing Windows Scripting host with Python script")
-        win32com.test.util.ExecuteShellCommand(cmd, self)
-
-
-if __name__ == "__main__":
-    win32com.test.util.testmain()
diff --git a/lib/win32com/test/testAccess.py b/lib/win32com/test/testAccess.py
deleted file mode 100644
index e6fce872..00000000
--- a/lib/win32com/test/testAccess.py
+++ /dev/null
@@ -1,187 +0,0 @@
-#
-# This assumes that you have MSAccess and DAO installed.
-#  You need to run makepy.py over "msaccess.tlb" and
-#  "dao3032.dll", and ensure the generated files are on the
-#  path.
-
-# You can run this with no args, and a test database will be generated.
-# You can optionally pass a dbname on the command line, in which case it will be dumped.
-
-import os
-import sys
-
-import pythoncom
-import win32api
-from win32com.client import Dispatch, constants, gencache
-
-
-def CreateTestAccessDatabase(dbname=None):
-    # Creates a test access database - returns the filename.
-    if dbname is None:
-        dbname = os.path.join(win32api.GetTempPath(), "COMTestSuiteTempDatabase.mdb")
-
-    access = Dispatch("Access.Application")
-    dbEngine = access.DBEngine
-    workspace = dbEngine.Workspaces(0)
-
-    try:
-        os.unlink(dbname)
-    except os.error:
-        print(
-            "WARNING - Unable to delete old test database - expect a COM exception RSN!"
-        )
-
-    newdb = workspace.CreateDatabase(
-        dbname, constants.dbLangGeneral, constants.dbEncrypt
-    )
-
-    # Create one test table.
-    table = newdb.CreateTableDef("Test Table 1")
-    table.Fields.Append(table.CreateField("First Name", constants.dbText))
-    table.Fields.Append(table.CreateField("Last Name", constants.dbText))
-
-    index = table.CreateIndex("UniqueIndex")
-    index.Fields.Append(index.CreateField("First Name"))
-    index.Fields.Append(index.CreateField("Last Name"))
-    index.Unique = -1
-    table.Indexes.Append(index)
-
-    newdb.TableDefs.Append(table)
-
-    # Create a second test table.
-    table = newdb.CreateTableDef("Test Table 2")
-    table.Fields.Append(table.CreateField("First Name", constants.dbText))
-    table.Fields.Append(table.CreateField("Last Name", constants.dbText))
-
-    newdb.TableDefs.Append(table)
-
-    # Create a relationship between them
-    relation = newdb.CreateRelation("TestRelationship")
-    relation.Table = "Test Table 1"
-    relation.ForeignTable = "Test Table 2"
-
-    field = relation.CreateField("First Name")
-    field.ForeignName = "First Name"
-    relation.Fields.Append(field)
-
-    field = relation.CreateField("Last Name")
-    field.ForeignName = "Last Name"
-    relation.Fields.Append(field)
-
-    relation.Attributes = (
-        constants.dbRelationDeleteCascade + constants.dbRelationUpdateCascade
-    )
-
-    newdb.Relations.Append(relation)
-
-    # Finally we can add some data to the table.
-    tab1 = newdb.OpenRecordset("Test Table 1")
-    tab1.AddNew()
-    tab1.Fields("First Name").Value = "Mark"
-    tab1.Fields("Last Name").Value = "Hammond"
-    tab1.Update()
-
-    tab1.MoveFirst()
-    # We do a simple bookmark test which tests our optimized VT_SAFEARRAY|VT_UI1 support.
-    # The bookmark will be a buffer object - remember it for later.
-    bk = tab1.Bookmark
-
-    # Add a second record.
-    tab1.AddNew()
-    tab1.Fields("First Name").Value = "Second"
-    tab1.Fields("Last Name").Value = "Person"
-    tab1.Update()
-
-    # Reset the bookmark to the one we saved.
-    # But first check the test is actually doing something!
-    tab1.MoveLast()
-    if tab1.Fields("First Name").Value != "Second":
-        raise RuntimeError("Unexpected record is last - makes bookmark test pointless!")
-
-    tab1.Bookmark = bk
-    if tab1.Bookmark != bk:
-        raise RuntimeError("The bookmark data is not the same")
-
-    if tab1.Fields("First Name").Value != "Mark":
-        raise RuntimeError("The bookmark did not reset the record pointer correctly")
-
-    return dbname
-
-
-def DoDumpAccessInfo(dbname):
-    from . import daodump
-
-    a = forms = None
-    try:
-        sys.stderr.write("Creating Access Application...\n")
-        a = Dispatch("Access.Application")
-        print("Opening database %s" % dbname)
-        a.OpenCurrentDatabase(dbname)
-        db = a.CurrentDb()
-        daodump.DumpDB(db, 1)
-        forms = a.Forms
-        print("There are %d forms open." % (len(forms)))
-        # Uncommenting these lines means Access remains open.
-        #               for form in forms:
-        #                       print " %s" % form.Name
-        reports = a.Reports
-        print("There are %d reports open" % (len(reports)))
-    finally:
-        if not a is None:
-            sys.stderr.write("Closing database\n")
-            try:
-                a.CloseCurrentDatabase()
-            except pythoncom.com_error:
-                pass
-
-
-# Generate all the support we can.
-def GenerateSupport():
-    # dao
-    gencache.EnsureModule("{00025E01-0000-0000-C000-000000000046}", 0, 4, 0)
-    # Access
-    #       gencache.EnsureModule("{4AFFC9A0-5F99-101B-AF4E-00AA003F0F07}", 0, 8, 0)
-    gencache.EnsureDispatch("Access.Application")
-
-
-def DumpAccessInfo(dbname):
-    amod = gencache.GetModuleForProgID("Access.Application")
-    dmod = gencache.GetModuleForProgID("DAO.DBEngine.35")
-    if amod is None and dmod is None:
-        DoDumpAccessInfo(dbname)
-        # Now generate all the support we can.
-        GenerateSupport()
-    else:
-        sys.stderr.write(
-            "testAccess not doing dynamic test, as generated code already exists\n"
-        )
-    # Now a generated version.
-    DoDumpAccessInfo(dbname)
-
-
-def test(dbname=None):
-    if dbname is None:
-        # We need makepy support to create a database (just for the constants!)
-        try:
-            GenerateSupport()
-        except pythoncom.com_error:
-            print("*** Can not import the MSAccess type libraries - tests skipped")
-            return
-        dbname = CreateTestAccessDatabase()
-        print("A test database at '%s' was created" % dbname)
-
-    DumpAccessInfo(dbname)
-
-
-if __name__ == "__main__":
-    import sys
-
-    from .util import CheckClean
-
-    dbname = None
-    if len(sys.argv) > 1:
-        dbname = sys.argv[1]
-
-    test(dbname)
-
-    CheckClean()
diff --git a/lib/win32com/test/testArrays.py b/lib/win32com/test/testArrays.py
deleted file mode 100644
index f395a413..00000000
--- a/lib/win32com/test/testArrays.py
+++ /dev/null
@@ -1,99 +0,0 @@
-# Originally contributed by Stefan Schukat as part of this arbitrary-sized
-# arrays patch.
-
-from win32com.client import gencache
-from win32com.test import util
-
-ZeroD = 0
-OneDEmpty = []
-OneD = [1, 2, 3]
-TwoD = [[1, 2, 3], [1, 2, 3], [1, 2, 3]]
-
-TwoD1 = [[[1, 2, 3, 5], [1, 2, 3], [1, 2, 3]], [[1, 2, 3], [1, 2, 3], [1, 2, 3]]]
-
-OneD1 = [[[1, 2, 3], [1, 2, 3], [1, 2, 3]], [[1, 2, 3], [1, 2, 3]]]
-
-OneD2 = [
-    [1, 2, 3],
-    [1, 2, 3, 4, 5],
-    [[1, 2, 3, 4, 5], [1, 2, 3, 4, 5], [1, 2, 3, 4, 5]],
-]
-
-
-ThreeD = [[[1, 2, 3], [1, 2, 3], [1, 2, 3]], [[1, 2, 3], [1, 2, 3], [1, 2, 3]]]
-
-FourD = [
-    [
-        [[1, 2, 3], [1, 2, 3], [1, 2, 3]],
-        [[1, 2, 3], [1, 2, 3], [1, 2, 3]],
-        [[1, 2, 3], [1, 2, 3], [1, 2, 3]],
-    ],
-    [
-        [[1, 2, 3], [1, 2, 3], [1, 2, 3]],
-        [[1, 2, 3], [1, 2, 3], [1, 2, 3]],
-        [[1, 2, 3], [1, 2, 3], [1, 2, 3]],
-    ],
-]
-
-LargeD = [
-    [[list(range(10))] * 10],
-] * 512
-
-
-def _normalize_array(a):
-    if type(a) != type(()):
-        return a
-    ret = []
-    for i in a:
-        ret.append(_normalize_array(i))
-    return ret
-
-
-class ArrayTest(util.TestCase):
-    def setUp(self):
-        self.arr = gencache.EnsureDispatch("PyCOMTest.ArrayTest")
-
-    def tearDown(self):
-        self.arr = None
-
-    def _doTest(self, array):
-        self.arr.Array = array
-        self.assertEqual(_normalize_array(self.arr.Array), array)
-
-    def testZeroD(self):
-        self._doTest(ZeroD)
-
-    def testOneDEmpty(self):
-        self._doTest(OneDEmpty)
-
-    def testOneD(self):
-        self._doTest(OneD)
-
-    def testTwoD(self):
-        self._doTest(TwoD)
-
-    def testThreeD(self):
-        self._doTest(ThreeD)
-
-    def testFourD(self):
-        self._doTest(FourD)
-
-    def testTwoD1(self):
-        self._doTest(TwoD1)
-
-    def testOneD1(self):
-        self._doTest(OneD1)
-
-    def testOneD2(self):
-        self._doTest(OneD2)
-
-    def testLargeD(self):
-        self._doTest(LargeD)
-
-
-if __name__ == "__main__":
-    try:
-        util.testmain()
-    except SystemExit as rc:
-        if not rc:
-            raise
diff --git a/lib/win32com/test/testClipboard.py b/lib/win32com/test/testClipboard.py
deleted file mode 100644
index 60df8668..00000000
--- a/lib/win32com/test/testClipboard.py
+++ /dev/null
@@ -1,170 +0,0 @@
-# testClipboard.py
-import unittest
-
-import pythoncom
-import win32clipboard
-import win32con
-import winerror
-from win32com.server.exception import COMException
-from win32com.server.util import NewEnum, wrap
-
-IDataObject_Methods = """GetData GetDataHere QueryGetData
-                         GetCanonicalFormatEtc SetData EnumFormatEtc
-                         DAdvise DUnadvise EnumDAdvise""".split()
-
-# A COM object implementing IDataObject used for basic testing.
-num_do_objects = 0
-
-
-def WrapCOMObject(ob, iid=None):
-    return wrap(ob, iid=iid, useDispatcher=0)
-
-
-class TestDataObject:
-    _com_interfaces_ = [pythoncom.IID_IDataObject]
-    _public_methods_ = IDataObject_Methods
-
-    def __init__(self, bytesval):
-        global num_do_objects
-        num_do_objects += 1
-        self.bytesval = bytesval
-        self.supported_fe = []
-        for cf in (win32con.CF_TEXT, win32con.CF_UNICODETEXT):
-            fe = cf, None, pythoncom.DVASPECT_CONTENT, -1, pythoncom.TYMED_HGLOBAL
-            self.supported_fe.append(fe)
-
-    def __del__(self):
-        global num_do_objects
-        num_do_objects -= 1
-
-    def _query_interface_(self, iid):
-        if iid == pythoncom.IID_IEnumFORMATETC:
-            return NewEnum(self.supported_fe, iid=iid)
-
-    def GetData(self, fe):
-        ret_stg = None
-        cf, target, aspect, index, tymed = fe
-        if aspect & pythoncom.DVASPECT_CONTENT and tymed == pythoncom.TYMED_HGLOBAL:
-            if cf == win32con.CF_TEXT:
-                ret_stg = pythoncom.STGMEDIUM()
-                ret_stg.set(pythoncom.TYMED_HGLOBAL, self.bytesval)
-            elif cf == win32con.CF_UNICODETEXT:
-                ret_stg = pythoncom.STGMEDIUM()
-                ret_stg.set(pythoncom.TYMED_HGLOBAL, self.bytesval.decode("latin1"))
-
-        if ret_stg is None:
-            raise COMException(hresult=winerror.E_NOTIMPL)
-        return ret_stg
-
-    def GetDataHere(self, fe):
-        raise COMException(hresult=winerror.E_NOTIMPL)
-
-    def QueryGetData(self, fe):
-        cf, target, aspect, index, tymed = fe
-        if aspect & pythoncom.DVASPECT_CONTENT == 0:
-            raise COMException(hresult=winerror.DV_E_DVASPECT)
-        if tymed != pythoncom.TYMED_HGLOBAL:
-            raise COMException(hresult=winerror.DV_E_TYMED)
-        return None  # should check better
-
-    def GetCanonicalFormatEtc(self, fe):
-        RaiseCOMException(winerror.DATA_S_SAMEFORMATETC)
-        # return fe
-
-    def SetData(self, fe, medium):
-        raise COMException(hresult=winerror.E_NOTIMPL)
-
-    def EnumFormatEtc(self, direction):
-        if direction != pythoncom.DATADIR_GET:
-            raise COMException(hresult=winerror.E_NOTIMPL)
-        return NewEnum(self.supported_fe, iid=pythoncom.IID_IEnumFORMATETC)
-
-    def DAdvise(self, fe, flags, sink):
-        raise COMException(hresult=winerror.E_NOTIMPL)
-
-    def DUnadvise(self, connection):
-        raise COMException(hresult=winerror.E_NOTIMPL)
-
-    def EnumDAdvise(self):
-        raise COMException(hresult=winerror.E_NOTIMPL)
-
-
-class ClipboardTester(unittest.TestCase):
-    def setUp(self):
-        pythoncom.OleInitialize()
-
-    def tearDown(self):
-        try:
-            pythoncom.OleFlushClipboard()
-        except pythoncom.com_error:
-            # We never set anything!
-            pass
-
-    def testIsCurrentClipboard(self):
-        do = TestDataObject(b"Hello from Python")
-        do = WrapCOMObject(do, iid=pythoncom.IID_IDataObject)
-        pythoncom.OleSetClipboard(do)
-        self.assertTrue(pythoncom.OleIsCurrentClipboard(do))
-
-    def testComToWin32(self):
-        # Set the data via our DataObject
-        do = TestDataObject(b"Hello from Python")
-        do = WrapCOMObject(do, iid=pythoncom.IID_IDataObject)
-        pythoncom.OleSetClipboard(do)
-        # Then get it back via the standard win32 clipboard functions.
-        win32clipboard.OpenClipboard()
-        got = win32clipboard.GetClipboardData(win32con.CF_TEXT)
-        # CF_TEXT gives bytes.
-        expected = b"Hello from Python"
-        self.assertEqual(got, expected)
-        # Now check unicode
-        got = win32clipboard.GetClipboardData(win32con.CF_UNICODETEXT)
-        self.assertEqual(got, "Hello from Python")
-        win32clipboard.CloseClipboard()
-
-    def testWin32ToCom(self):
-        # Set the data via the std win32 clipboard functions.
-        val = b"Hello again!"  # always bytes
-        win32clipboard.OpenClipboard()
-        win32clipboard.SetClipboardData(win32con.CF_TEXT, val)
-        win32clipboard.CloseClipboard()
-        # and get it via an IDataObject provided by COM
-        do = pythoncom.OleGetClipboard()
-        cf = (
-            win32con.CF_TEXT,
-            None,
-            pythoncom.DVASPECT_CONTENT,
-            -1,
-            pythoncom.TYMED_HGLOBAL,
-        )
-        stg = do.GetData(cf)
-        got = stg.data
-        # The data we get back has the \0, as our STGMEDIUM has no way of
-        # knowing if it meant to be a string, or a binary buffer, so
-        # it must return it too.
-        self.assertTrue(got, b"Hello again!\0")
-
-    def testDataObjectFlush(self):
-        do = TestDataObject(b"Hello from Python")
-        do = WrapCOMObject(do, iid=pythoncom.IID_IDataObject)
-        pythoncom.OleSetClipboard(do)
-        self.assertEqual(num_do_objects, 1)
-
-        do = None  # clear my ref!
-        pythoncom.OleFlushClipboard()
-        self.assertEqual(num_do_objects, 0)
-
-    def testDataObjectReset(self):
-        do = TestDataObject(b"Hello from Python")
-        do = WrapCOMObject(do)
-        pythoncom.OleSetClipboard(do)
-        do = None  # clear my ref!
-        self.assertEqual(num_do_objects, 1)
-        pythoncom.OleSetClipboard(None)
-        self.assertEqual(num_do_objects, 0)
-
-
-if __name__ == "__main__":
-    from win32com.test import util
-
-    util.testmain()
diff --git a/lib/win32com/test/testCollections.py b/lib/win32com/test/testCollections.py
deleted file mode 100644
index 954697e0..00000000
--- a/lib/win32com/test/testCollections.py
+++ /dev/null
@@ -1,166 +0,0 @@
-# testCollections.py
-#
-# This code tests both the client and server side of collections
-# and enumerators.
-#
-# Also has the side effect of testing some of the PythonCOM error semantics.
-import sys
-
-import pythoncom
-import pywintypes
-import win32com.client
-import win32com.server.util
-import win32com.test.util
-import winerror
-
-L = pywintypes.Unicode
-
-import unittest
-
-error = "collection test error"
-
-
-def MakeEmptyEnum():
-    # create the Python enumerator object as a real COM object
-    o = win32com.server.util.wrap(win32com.server.util.Collection())
-    return win32com.client.Dispatch(o)
-
-
-def MakeTestEnum():
-    # create a sub-collection, just to make sure it works :-)
-    sub = win32com.server.util.wrap(
-        win32com.server.util.Collection(["Sub1", 2, "Sub3"])
-    )
-    # create the Python enumerator object as a real COM object
-    o = win32com.server.util.wrap(win32com.server.util.Collection([1, "Two", 3, sub]))
-    return win32com.client.Dispatch(o)
-
-
-def TestEnumAgainst(o, check):
-    for i in range(len(check)):
-        if o(i) != check[i]:
-            raise error(
-                "Using default method gave the incorrect value - %s/%s"
-                % (repr(o(i)), repr(check[i]))
-            )
-
-    for i in range(len(check)):
-        if o.Item(i) != check[i]:
-            raise error(
-                "Using Item method gave the incorrect value - %s/%s"
-                % (repr(o(i)), repr(check[i]))
-            )
-
-    # First try looping.
-    cmp = []
-    for s in o:
-        cmp.append(s)
-
-    if cmp[: len(check)] != check:
-        raise error(
-            "Result after looping isnt correct - %s/%s"
-            % (repr(cmp[: len(check)]), repr(check))
-        )
-
-    for i in range(len(check)):
-        if o[i] != check[i]:
-            raise error("Using indexing gave the incorrect value")
-
-
-def TestEnum(quiet=None):
-    if quiet is None:
-        quiet = not "-v" in sys.argv
-    if not quiet:
-        print("Simple enum test")
-    o = MakeTestEnum()
-    check = [1, "Two", 3]
-    TestEnumAgainst(o, check)
-
-    if not quiet:
-        print("sub-collection test")
-    sub = o[3]
-    TestEnumAgainst(sub, ["Sub1", 2, "Sub3"])
-
-    # Remove the sublist for this test!
-    o.Remove(o.Count() - 1)
-
-    if not quiet:
-        print("Remove item test")
-    del check[1]
-    o.Remove(1)
-    TestEnumAgainst(o, check)
-
-    if not quiet:
-        print("Add item test")
-    o.Add("New Item")
-    check.append("New Item")
-    TestEnumAgainst(o, check)
-
-    if not quiet:
-        print("Insert item test")
-    o.Insert(2, -1)
-    check.insert(2, -1)
-    TestEnumAgainst(o, check)
-
-    ### This does not work!
-    #       if not quiet: print "Indexed replace item test"
-    #       o[2] = 'Replaced Item'
-    #       check[2] = 'Replaced Item'
-    #       TestEnumAgainst(o, check)
-
-    try:
-        o()
-        raise error("default method with no args worked when it shouldnt have!")
-    except pythoncom.com_error as exc:
-        if exc.hresult != winerror.DISP_E_BADPARAMCOUNT:
-            raise error("Expected DISP_E_BADPARAMCOUNT - got %s" % (exc,))
-
-    try:
-        o.Insert("foo", 2)
-        raise error("Insert worked when it shouldnt have!")
-    except pythoncom.com_error as exc:
-        if exc.hresult != winerror.DISP_E_TYPEMISMATCH:
-            raise error("Expected DISP_E_TYPEMISMATCH - got %s" % (exc,))
-
-    # Remove the sublist for this test!
-    try:
-        o.Remove(o.Count())
-        raise error("Remove worked when it shouldnt have!")
-    except pythoncom.com_error as exc:
-        if exc.hresult != winerror.DISP_E_BADINDEX:
-            raise error("Expected DISP_E_BADINDEX - got %s" % (exc,))
-
-    # Test an empty collection
-    if not quiet:
-        print("Empty collection test")
-    o = MakeEmptyEnum()
-    for item in o:
-        raise error("Empty list performed an iteration")
-
-    try:
-        ob = o[1]
-        raise error("Empty list could be indexed")
-    except IndexError:
-        pass
-
-    try:
-        ob = o[0]
-        raise error("Empty list could be indexed")
-    except IndexError:
-        pass
-
-    try:
-        ob = o(0)
-        raise error("Empty list could be indexed")
-    except pythoncom.com_error as exc:
-        if exc.hresult != winerror.DISP_E_BADINDEX:
-            raise error("Expected DISP_E_BADINDEX - got %s" % (exc,))
-
-
-class TestCase(win32com.test.util.TestCase):
-    def testEnum(self):
-        TestEnum()
-
-
-if __name__ == "__main__":
-    unittest.main()
diff --git a/lib/win32com/test/testConversionErrors.py b/lib/win32com/test/testConversionErrors.py
deleted file mode 100644
index a4b755e6..00000000
--- a/lib/win32com/test/testConversionErrors.py
+++ /dev/null
@@ -1,39 +0,0 @@
-import unittest
-
-import win32com.client
-import win32com.server.util
-import win32com.test.util
-
-
-class Tester:
-    _public_methods_ = ["TestValue"]
-
-    def TestValue(self, v):
-        pass
-
-
-def test_ob():
-    return win32com.client.Dispatch(win32com.server.util.wrap(Tester()))
-
-
-class TestException(Exception):
-    pass
-
-
-# The object we try and pass - pywin32 will call __float__ as a last resort.
-class BadConversions:
-    def __float__(self):
-        raise TestException()
-
-
-class TestCase(win32com.test.util.TestCase):
-    def test_float(self):
-        try:
-            test_ob().TestValue(BadConversions())
-            raise Exception("Should not have worked")
-        except Exception as e:
-            assert isinstance(e, TestException)
-
-
-if __name__ == "__main__":
-    unittest.main()
diff --git a/lib/win32com/test/testDCOM.py b/lib/win32com/test/testDCOM.py
deleted file mode 100644
index 9f5a334e..00000000
--- a/lib/win32com/test/testDCOM.py
+++ /dev/null
@@ -1,50 +0,0 @@
-# testDCOM
-usage = """\
-testDCOM.py - Simple DCOM test
-Usage: testDCOM.py serverName
-
-Attempts to start the Python.Interpreter object on the named machine,
-and checks that the object is indeed running remotely.
-
-Requires the named server be configured to run DCOM (using dcomcnfg.exe),
-and the Python.Interpreter object installed and registered on that machine.
-
-The Python.Interpreter object must be installed on the local machine,
-but no special DCOM configuration should be necessary.
-"""
-import string
-import sys
-
-# NOTE: If you configured the object locally using dcomcnfg, you could
-# simple use Dispatch rather than DispatchEx.
-import pythoncom
-import win32api
-import win32com.client
-
-
-def test(serverName):
-    if string.lower(serverName) == string.lower(win32api.GetComputerName()):
-        print("You must specify a remote server name, not the local machine!")
-        return
-
-    # Hack to overcome a DCOM limitation.  As the Python.Interpreter object
-    # is probably installed locally as an InProc object, DCOM seems to ignore
-    # all settings, and use the local object.
-    clsctx = pythoncom.CLSCTX_SERVER & ~pythoncom.CLSCTX_INPROC_SERVER
-    ob = win32com.client.DispatchEx("Python.Interpreter", serverName, clsctx=clsctx)
-    ob.Exec("import win32api")
-    actualName = ob.Eval("win32api.GetComputerName()")
-    if string.lower(serverName) != string.lower(actualName):
-        print(
-            "Error: The object created on server '%s' reported its name as '%s'"
-            % (serverName, actualName)
-        )
-    else:
-        print("Object created and tested OK on server '%s'" % serverName)
-
-
-if __name__ == "__main__":
-    if len(sys.argv) == 2:
-        test(sys.argv[1])
-    else:
-        print(usage)
diff --git a/lib/win32com/test/testDates.py b/lib/win32com/test/testDates.py
deleted file mode 100644
index 00406dda..00000000
--- a/lib/win32com/test/testDates.py
+++ /dev/null
@@ -1,74 +0,0 @@
-import unittest
-from datetime import datetime
-
-import pywintypes
-import win32com.client
-import win32com.server.util
-import win32com.test.util
-from win32timezone import TimeZoneInfo
-
-
-# A COM object so we can pass dates to and from the COM boundary.
-class Tester:
-    _public_methods_ = ["TestDate"]
-
-    def TestDate(self, d):
-        assert isinstance(d, datetime)
-        return d
-
-
-def test_ob():
-    return win32com.client.Dispatch(win32com.server.util.wrap(Tester()))
-
-
-class TestCase(win32com.test.util.TestCase):
-    def check(self, d, expected=None):
-        if not issubclass(pywintypes.TimeType, datetime):
-            self.skipTest("this is testing pywintypes and datetime")
-        got = test_ob().TestDate(d)
-        self.assertEqual(got, expected or d)
-
-    def testUTC(self):
-        self.check(
-            datetime(
-                year=2000,
-                month=12,
-                day=25,
-                microsecond=500000,
-                tzinfo=TimeZoneInfo.utc(),
-            )
-        )
-
-    def testLocal(self):
-        self.check(
-            datetime(
-                year=2000,
-                month=12,
-                day=25,
-                microsecond=500000,
-                tzinfo=TimeZoneInfo.local(),
-            )
-        )
-
-    def testMSTruncated(self):
-        # milliseconds are kept but microseconds are lost after rounding.
-        self.check(
-            datetime(
-                year=2000,
-                month=12,
-                day=25,
-                microsecond=500500,
-                tzinfo=TimeZoneInfo.utc(),
-            ),
-            datetime(
-                year=2000,
-                month=12,
-                day=25,
-                microsecond=500000,
-                tzinfo=TimeZoneInfo.utc(),
-            ),
-        )
-
-
-if __name__ == "__main__":
-    unittest.main()
diff --git a/lib/win32com/test/testDictionary.py b/lib/win32com/test/testDictionary.py
deleted file mode 100644
index 869cc186..00000000
--- a/lib/win32com/test/testDictionary.py
+++ /dev/null
@@ -1,99 +0,0 @@
-# testDictionary.py
-#
-import sys
-import unittest
-
-import pythoncom
-import pywintypes
-import win32com.client
-import win32com.server.util
-import win32com.test.util
-import win32timezone
-import winerror
-
-
-def MakeTestDictionary():
-    return win32com.client.Dispatch("Python.Dictionary")
-
-
-def TestDictAgainst(dict, check):
-    for key, value in list(check.items()):
-        if dict(key) != value:
-            raise Exception(
-                "Indexing for '%s' gave the incorrect value - %s/%s"
-                % (repr(key), repr(dict[key]), repr(check[key]))
-            )
-
-
-# Ensure we have the correct version registered.
-def Register(quiet):
-    import win32com.servers.dictionary
-    from win32com.test.util import RegisterPythonServer
-
-    RegisterPythonServer(win32com.servers.dictionary.__file__, "Python.Dictionary")
-
-
-def TestDict(quiet=None):
-    if quiet is None:
-        quiet = not "-v" in sys.argv
-    Register(quiet)
-
-    if not quiet:
-        print("Simple enum test")
-    dict = MakeTestDictionary()
-    checkDict = {}
-    TestDictAgainst(dict, checkDict)
-
-    dict["NewKey"] = "NewValue"
-    checkDict["NewKey"] = "NewValue"
-    TestDictAgainst(dict, checkDict)
-
-    dict["NewKey"] = None
-    del checkDict["NewKey"]
-    TestDictAgainst(dict, checkDict)
-
-    now = win32timezone.now()
-    # We want to keep the milliseconds but discard microseconds as they
-    # don't survive the conversion.
-    now = now.replace(microsecond=round(now.microsecond / 1000) * 1000)
-    dict["Now"] = now
-    checkDict["Now"] = now
-    TestDictAgainst(dict, checkDict)
-
-    if not quiet:
-        print("Failure tests")
-    try:
-        dict()
-        raise Exception("default method with no args worked when it shouldnt have!")
-    except pythoncom.com_error as xxx_todo_changeme:
-        (hr, desc, exc, argErr) = xxx_todo_changeme.args
-        if hr != winerror.DISP_E_BADPARAMCOUNT:
-            raise Exception("Expected DISP_E_BADPARAMCOUNT - got %d (%s)" % (hr, desc))
-
-    try:
-        dict("hi", "there")
-        raise Exception("multiple args worked when it shouldnt have!")
-    except pythoncom.com_error as xxx_todo_changeme1:
-        (hr, desc, exc, argErr) = xxx_todo_changeme1.args
-        if hr != winerror.DISP_E_BADPARAMCOUNT:
-            raise Exception("Expected DISP_E_BADPARAMCOUNT - got %d (%s)" % (hr, desc))
-
-    try:
-        dict(0)
-        raise Exception("int key worked when it shouldnt have!")
-    except pythoncom.com_error as xxx_todo_changeme2:
-        (hr, desc, exc, argErr) = xxx_todo_changeme2.args
-        if hr != winerror.DISP_E_TYPEMISMATCH:
-            raise Exception("Expected DISP_E_TYPEMISMATCH - got %d (%s)" % (hr, desc))
-
-    if not quiet:
-        print("Python.Dictionary tests complete.")
-
-
-class TestCase(win32com.test.util.TestCase):
-    def testDict(self):
-        TestDict()
-
-
-if __name__ == "__main__":
-    unittest.main()
diff --git a/lib/win32com/test/testDictionary.vbs b/lib/win32com/test/testDictionary.vbs
deleted file mode 100644
index ca1dc08e..00000000
--- a/lib/win32com/test/testDictionary.vbs
+++ /dev/null
@@ -1,26 +0,0 @@
-' Test Pyhon.Dictionary using VBScript - this uses
-' IDispatchEx, so is an interesting test.
-
-set ob = CreateObject("Python.Dictionary")
-ob("hello") = "there"
-' Our keys are case insensitive.
-ob.Item("hi") = ob("HELLO")
-
-dim ok
-ok = true
-
-if ob("hello") <> "there" then
-    WScript.Echo "**** The dictionary value was wrong!!"
-    ok = false
-end if
-
-if ob("hi") <> "there" then
-        WScript.Echo "**** The other dictionary value was wrong!!"
-        ok = false
-end if
-
-if ok then
-    WScript.Echo "VBScript has successfully tested Python.Dictionary"
-end if
-
-
diff --git a/lib/win32com/test/testDynamic.py b/lib/win32com/test/testDynamic.py
deleted file mode 100644
index 2fd91972..00000000
--- a/lib/win32com/test/testDynamic.py
+++ /dev/null
@@ -1,89 +0,0 @@
-# Test dynamic policy, and running object table.
-
-import pythoncom
-import winerror
-from win32com.server.exception import Exception
-
-error = "testDynamic error"
-
-iid = pythoncom.MakeIID("{b48969a0-784b-11d0-ae71-d23f56000000}")
-
-
-class VeryPermissive:
-    def _dynamic_(self, name, lcid, wFlags, args):
-        if wFlags & pythoncom.DISPATCH_METHOD:
-            return getattr(self, name)(*args)
-
-        if wFlags & pythoncom.DISPATCH_PROPERTYGET:
-            try:
-                # to avoid problems with byref param handling, tuple results are converted to lists.
-                ret = self.__dict__[name]
-                if type(ret) == type(()):
-                    ret = list(ret)
-                return ret
-            except KeyError:  # Probably a method request.
-                raise Exception(scode=winerror.DISP_E_MEMBERNOTFOUND)
-
-        if wFlags & (
-            pythoncom.DISPATCH_PROPERTYPUT | pythoncom.DISPATCH_PROPERTYPUTREF
-        ):
-            setattr(self, name, args[0])
-            return
-
-        raise Exception(scode=winerror.E_INVALIDARG, desc="invalid wFlags")
-
-    def write(self, *args):
-        if len(args) == 0:
-            raise Exception(
-                scode=winerror.DISP_E_BADPARAMCOUNT
-            )  # Probably call as PROPGET.
-
-        for arg in args[:-1]:
-            print(str(arg), end=" ")
-        print(str(args[-1]))
-
-
-def Test():
-    import win32com.server.policy
-    import win32com.server.util
-
-    #       import win32dbg;win32dbg.brk()
-    ob = win32com.server.util.wrap(
-        VeryPermissive(), usePolicy=win32com.server.policy.DynamicPolicy
-    )
-    try:
-        handle = pythoncom.RegisterActiveObject(ob, iid, 0)
-    except pythoncom.com_error as details:
-        print("Warning - could not register the object in the ROT:", details)
-        handle = None
-    try:
-        import win32com.client.dynamic
-
-        client = win32com.client.dynamic.Dispatch(iid)
-        client.ANewAttr = "Hello"
-        if client.ANewAttr != "Hello":
-            raise error("Could not set dynamic property")
-
-        v = ["Hello", "From", "Python", 1.4]
-        client.TestSequence = v
-        if v != list(client.TestSequence):
-            raise error(
-                "Dynamic sequences not working! %r/%r"
-                % (repr(v), repr(client.testSequence))
-            )
-
-        client.write("This", "output", "has", "come", "via", "testDynamic.py")
-        # Check our new "_FlagAsMethod" works (kinda!)
-        client._FlagAsMethod("NotReallyAMethod")
-        if not callable(client.NotReallyAMethod):
-            raise error("Method I flagged as callable isn't!")
-
-        client = None
-    finally:
-        if handle is not None:
-            pythoncom.RevokeActiveObject(handle)
-    print("Test worked!")
-
-
-if __name__ == "__main__":
-    Test()
diff --git a/lib/win32com/test/testExchange.py b/lib/win32com/test/testExchange.py
deleted file mode 100644
index b41a4472..00000000
--- a/lib/win32com/test/testExchange.py
+++ /dev/null
@@ -1,126 +0,0 @@
-# TestExchange = Exchange Server Dump
-# Note that this code uses "CDO", which is unlikely to get the best choice.
-# You should use the Outlook object model, or
-# the win32com.mapi examples for a low-level interface.
-
-import os
-
-import pythoncom
-from win32com.client import constants, gencache
-
-ammodule = None  # was the generated module!
-
-
-def GetDefaultProfileName():
-    import win32api
-    import win32con
-
-    try:
-        key = win32api.RegOpenKey(
-            win32con.HKEY_CURRENT_USER,
-            "Software\\Microsoft\\Windows NT\\CurrentVersion\\Windows Messaging Subsystem\\Profiles",
-        )
-        try:
-            return win32api.RegQueryValueEx(key, "DefaultProfile")[0]
-        finally:
-            key.Close()
-    except win32api.error:
-        return None
-
-
-#
-# Recursive dump of folders.
-#
-def DumpFolder(folder, indent=0):
-    print(" " * indent, folder.Name)
-    folders = folder.Folders
-    folder = folders.GetFirst()
-    while folder:
-        DumpFolder(folder, indent + 1)
-        folder = folders.GetNext()
-
-
-def DumpFolders(session):
-    try:
-        infostores = session.InfoStores
-    except AttributeError:
-        # later outlook?
-        store = session.DefaultStore
-        folder = store.GetRootFolder()
-        DumpFolder(folder)
-        return
-
-    print(infostores)
-    print("There are %d infostores" % infostores.Count)
-    for i in range(infostores.Count):
-        infostore = infostores[i + 1]
-        print("Infostore = ", infostore.Name)
-        try:
-            folder = infostore.RootFolder
-        except pythoncom.com_error as details:
-            hr, msg, exc, arg = details
-            # -2147221219 == MAPI_E_FAILONEPROVIDER - a single provider temporarily not available.
-            if exc and exc[-1] == -2147221219:
-                print("This info store is currently not available")
-                continue
-        DumpFolder(folder)
-
-
-# Build a dictionary of property tags, so I can reverse look-up
-#
-PropTagsById = {}
-if ammodule:
-    for name, val in ammodule.constants.__dict__.items():
-        PropTagsById[val] = name
-
-
-def TestAddress(session):
-    #       entry = session.GetAddressEntry("Skip")
-    #       print entry
-    pass
-
-
-def TestUser(session):
-    ae = session.CurrentUser
-    fields = getattr(ae, "Fields", [])
-    print("User has %d fields" % len(fields))
-    for f in range(len(fields)):
-        field = fields[f + 1]
-        try:
-            id = PropTagsById[field.ID]
-        except KeyError:
-            id = field.ID
-        print("%s/%s=%s" % (field.Name, id, field.Value))
-
-
-def test():
-    import win32com.client
-
-    oldcwd = os.getcwd()
-    try:
-        session = gencache.EnsureDispatch("MAPI.Session")
-        try:
-            session.Logon(GetDefaultProfileName())
-        except pythoncom.com_error as details:
-            print("Could not log on to MAPI:", details)
-            return
-    except pythoncom.error:
-        # no mapi.session - let's try outlook
-        app = gencache.EnsureDispatch("Outlook.Application")
-        session = app.Session
-
-    try:
-        TestUser(session)
-        TestAddress(session)
-        DumpFolders(session)
-    finally:
-        session.Logoff()
-        # It appears Exchange will change the cwd on us :(
-        os.chdir(oldcwd)
-
-
-if __name__ == "__main__":
-    from .util import CheckClean
-
-    test()
-    CheckClean()
diff --git a/lib/win32com/test/testExplorer.py b/lib/win32com/test/testExplorer.py
deleted file mode 100644
index bca66358..00000000
--- a/lib/win32com/test/testExplorer.py
+++ /dev/null
@@ -1,145 +0,0 @@
-# testExplorer -
-
-import os
-import time
-
-import pythoncom
-import win32api
-import win32com.client.dynamic
-import win32con
-import win32gui
-import winerror
-from win32com.client import Dispatch
-from win32com.test.util import CheckClean
-
-bVisibleEventFired = 0
-
-# These are errors we might see when this is run in automation (eg, on github)
-# Not sure exactly what -2125463506 is, but google shows it's a common error
-# possibly related to how IE is configured WRT site permissions etc.
-HRESULTS_IN_AUTOMATION = [-2125463506, winerror.MK_E_UNAVAILABLE]
-
-
-class ExplorerEvents:
-    def OnVisible(self, visible):
-        global bVisibleEventFired
-        bVisibleEventFired = 1
-
-
-def TestExplorerEvents():
-    global bVisibleEventFired
-    try:
-        iexplore = win32com.client.DispatchWithEvents(
-            "InternetExplorer.Application", ExplorerEvents
-        )
-    except pythoncom.com_error as exc:
-        # In automation we see this error trying to connect to events
-        # It's a little surprising that the non-event tests seem to work, but
-        # whatever...
-        if exc.hresult not in HRESULTS_IN_AUTOMATION:
-            raise
-        print("IE events appear to not be available, so skipping this test")
-        return
-
-    iexplore.Visible = 1
-    if not bVisibleEventFired:
-        raise RuntimeError("The IE event did not appear to fire!")
-    iexplore.Quit()
-    iexplore = None
-
-    bVisibleEventFired = 0
-    ie = win32com.client.Dispatch("InternetExplorer.Application")
-    ie_events = win32com.client.DispatchWithEvents(ie, ExplorerEvents)
-    ie.Visible = 1
-    if not bVisibleEventFired:
-        raise RuntimeError("The IE event did not appear to fire!")
-    ie.Quit()
-    ie = None
-    print("IE Event tests worked.")
-
-
-def TestObjectFromWindow():
-    # Check we can use ObjectFromLresult to get the COM object from the
-    # HWND - see KB Q249232
-    # Locating the HWND is different than the KB says...
-    hwnd = win32gui.FindWindow("IEFrame", None)
-    for child_class in [
-        "TabWindowClass",
-        "Shell DocObject View",
-        "Internet Explorer_Server",
-    ]:
-        hwnd = win32gui.FindWindowEx(hwnd, 0, child_class, None)
-        # ack - not working for markh on vista with IE8 (or maybe it is the
-        # lack of the 'accessibility' components mentioned in Q249232)
-        # either way - not working!
-        return
-    # But here is the point - once you have an 'Internet Explorer_Server',
-    # you can send a message and use ObjectFromLresult to get it back.
-    msg = win32gui.RegisterWindowMessage("WM_HTML_GETOBJECT")
-    rc, result = win32gui.SendMessageTimeout(
-        hwnd, msg, 0, 0, win32con.SMTO_ABORTIFHUNG, 1000
-    )
-    ob = pythoncom.ObjectFromLresult(result, pythoncom.IID_IDispatch, 0)
-    doc = Dispatch(ob)
-    # just to prove it works, set the background color of the document.
-    for color in "red green blue orange white".split():
-        doc.bgColor = color
-        time.sleep(0.2)
-
-
-def TestExplorer(iexplore):
-    if not iexplore.Visible:
-        iexplore.Visible = -1
-    filename = os.path.join(os.path.dirname(__file__), "..\\readme.html")
-    iexplore.Navigate(win32api.GetFullPathName(filename))
-    win32api.Sleep(1000)
-    TestObjectFromWindow()
-    win32api.Sleep(3000)
-    try:
-        iexplore.Quit()
-    except (AttributeError, pythoncom.com_error):
-        # User got sick of waiting :)
-        pass
-
-
-def TestAll():
-    try:
-        try:
-            try:
-                iexplore = win32com.client.dynamic.Dispatch(
-                    "InternetExplorer.Application"
-                )
-            except pythoncom.com_error as exc:
-                if exc.hresult not in HRESULTS_IN_AUTOMATION:
-                    raise
-                print("IE appears to not be available, so skipping this test")
-                return
-
-            TestExplorer(iexplore)
-
-            win32api.Sleep(1000)
-            iexplore = None
-
-            # Test IE events.
-            TestExplorerEvents()
-            # Give IE a chance to shutdown, else it can get upset on fast machines.
-            time.sleep(2)
-
-            # Note that the TextExplorerEvents will force makepy - hence
-            # this gencache is really no longer needed.
-
-            from win32com.client import gencache
-
-            gencache.EnsureModule("{EAB22AC0-30C1-11CF-A7EB-0000C05BAE0B}", 0, 1, 1)
-            iexplore = win32com.client.Dispatch("InternetExplorer.Application")
-            TestExplorer(iexplore)
-        except pythoncom.com_error as exc:
-            if exc.hresult != winerror.RPC_E_DISCONNECTED:  # user closed the app!
-                raise
-    finally:
-        iexplore = None
-
-
-if __name__ == "__main__":
-    TestAll()
-    CheckClean()
diff --git a/lib/win32com/test/testGIT.py b/lib/win32com/test/testGIT.py
deleted file mode 100644
index 2ec6bc44..00000000
--- a/lib/win32com/test/testGIT.py
+++ /dev/null
@@ -1,145 +0,0 @@
-"""Testing pasing object between multiple COM threads
-
-Uses standard COM marshalling to pass objects between threads.  Even 
-though Python generally seems to work when you just pass COM objects
-between threads, it shouldnt.
-
-This shows the "correct" way to do it.
-
-It shows that although we create new threads to use the Python.Interpreter,
-COM marshalls back all calls to that object to the main Python thread,
-which must be running a message loop (as this sample does).
-
-When this test is run in "free threaded" mode (at this stage, you must 
-manually mark the COM objects as "ThreadingModel=Free", or run from a 
-service which has marked itself as free-threaded), then no marshalling
-is done, and the Python.Interpreter object start doing the "expected" thing
-- ie, it reports being on the same thread as its caller!
-
-Python.exe needs a good way to mark itself as FreeThreaded - at the moment
-this is a pain in the but!
-
-"""
-
-import _thread
-import traceback
-
-import pythoncom
-import win32api
-import win32com.client
-import win32event
-
-
-def TestInterp(interp):
-    if interp.Eval("1+1") != 2:
-        raise ValueError("The interpreter returned the wrong result.")
-    try:
-        interp.Eval(1 + 1)
-        raise ValueError("The interpreter did not raise an exception")
-    except pythoncom.com_error as details:
-        import winerror
-
-        if details[0] != winerror.DISP_E_TYPEMISMATCH:
-            raise ValueError(
-                "The interpreter exception was not winerror.DISP_E_TYPEMISMATCH."
-            )
-
-
-def TestInterpInThread(stopEvent, cookie):
-    try:
-        DoTestInterpInThread(cookie)
-    finally:
-        win32event.SetEvent(stopEvent)
-
-
-def CreateGIT():
-    return pythoncom.CoCreateInstance(
-        pythoncom.CLSID_StdGlobalInterfaceTable,
-        None,
-        pythoncom.CLSCTX_INPROC,
-        pythoncom.IID_IGlobalInterfaceTable,
-    )
-
-
-def DoTestInterpInThread(cookie):
-    try:
-        pythoncom.CoInitialize()
-        myThread = win32api.GetCurrentThreadId()
-        GIT = CreateGIT()
-
-        interp = GIT.GetInterfaceFromGlobal(cookie, pythoncom.IID_IDispatch)
-        interp = win32com.client.Dispatch(interp)
-
-        TestInterp(interp)
-        interp.Exec("import win32api")
-        print(
-            "The test thread id is %d, Python.Interpreter's thread ID is %d"
-            % (myThread, interp.Eval("win32api.GetCurrentThreadId()"))
-        )
-        interp = None
-        pythoncom.CoUninitialize()
-    except:
-        traceback.print_exc()
-
-
-def BeginThreadsSimpleMarshal(numThreads, cookie):
-    """Creates multiple threads using simple (but slower) marshalling.
-
-    Single interpreter object, but a new stream is created per thread.
-
-    Returns the handles the threads will set when complete.
-    """
-    ret = []
-    for i in range(numThreads):
-        hEvent = win32event.CreateEvent(None, 0, 0, None)
-        _thread.start_new(TestInterpInThread, (hEvent, cookie))
-        ret.append(hEvent)
-    return ret
-
-
-def test(fn):
-    print("The main thread is %d" % (win32api.GetCurrentThreadId()))
-    GIT = CreateGIT()
-    interp = win32com.client.Dispatch("Python.Interpreter")
-    cookie = GIT.RegisterInterfaceInGlobal(interp._oleobj_, pythoncom.IID_IDispatch)
-
-    events = fn(4, cookie)
-    numFinished = 0
-    while 1:
-        try:
-            rc = win32event.MsgWaitForMultipleObjects(
-                events, 0, 2000, win32event.QS_ALLINPUT
-            )
-            if rc >= win32event.WAIT_OBJECT_0 and rc < win32event.WAIT_OBJECT_0 + len(
-                events
-            ):
-                numFinished = numFinished + 1
-                if numFinished >= len(events):
-                    break
-            elif rc == win32event.WAIT_OBJECT_0 + len(events):  # a message
-                # This is critical - whole apartment model demo will hang.
-                pythoncom.PumpWaitingMessages()
-            else:  # Timeout
-                print(
-                    "Waiting for thread to stop with interfaces=%d, gateways=%d"
-                    % (pythoncom._GetInterfaceCount(), pythoncom._GetGatewayCount())
-                )
-        except KeyboardInterrupt:
-            break
-    GIT.RevokeInterfaceFromGlobal(cookie)
-    del interp
-    del GIT
-
-
-if __name__ == "__main__":
-    test(BeginThreadsSimpleMarshal)
-    win32api.Sleep(500)
-    # Doing CoUninit here stop Pythoncom.dll hanging when DLLMain shuts-down the process
-    pythoncom.CoUninitialize()
-    if pythoncom._GetInterfaceCount() != 0 or pythoncom._GetGatewayCount() != 0:
-        print(
-            "Done with interfaces=%d, gateways=%d"
-            % (pythoncom._GetInterfaceCount(), pythoncom._GetGatewayCount())
-        )
-    else:
-        print("Done.")
diff --git a/lib/win32com/test/testGatewayAddresses.py b/lib/win32com/test/testGatewayAddresses.py
deleted file mode 100644
index d4899169..00000000
--- a/lib/win32com/test/testGatewayAddresses.py
+++ /dev/null
@@ -1,149 +0,0 @@
-# The purpose of this test is to ensure that the gateways objects
-# do the right thing WRT COM rules about object identity etc.
-
-# Also includes a basic test that we support inheritance correctly in
-# gateway interfaces.
-
-# For our test, we create an object of type IID_IPersistStorage
-# This interface derives from IPersist.
-# Therefore, QI's for IID_IDispatch, IID_IUnknown, IID_IPersist and
-# IID_IPersistStorage should all return the same gateway object.
-#
-# In addition, the interface should only need to declare itself as
-# using the IPersistStorage interface, and as the gateway derives
-# from IPersist, it should automatically be available without declaration.
-#
-# We also create an object of type IID_I??, and perform a QI for it.
-# We then jump through a number of hoops, ensuring that the objects
-# returned by the QIs follow all the rules.
-#
-# Here is Gregs summary of the rules:
-# 1) the set of supported interfaces is static and unchanging
-# 2) symmetric: if you QI an interface for that interface, it succeeds
-# 3) reflexive: if you QI against A for B, the new pointer must succeed
-#   for a QI for A
-# 4) transitive: if you QI for B, then QI that for C, then QI'ing A for C
-#   must succeed
-#
-#
-# Note that 1) Requires cooperation of the Python programmer.  The rule to keep is:
-# "whenever you return an _object_ from _query_interface_(), you must return the
-# same object each time for a given IID.  Note that you must return the same
-# _wrapped_ object
-# you
-# The rest are tested here.
-
-
-import pythoncom
-from win32com.server.util import wrap
-
-from .util import CheckClean
-
-numErrors = 0
-
-
-# Check that the 2 objects both have identical COM pointers.
-def CheckSameCOMObject(ob1, ob2):
-    addr1 = repr(ob1).split()[6][:-1]
-    addr2 = repr(ob2).split()[6][:-1]
-    return addr1 == addr2
-
-
-# Check that the objects conform to COM identity rules.
-def CheckObjectIdentity(ob1, ob2):
-    u1 = ob1.QueryInterface(pythoncom.IID_IUnknown)
-    u2 = ob2.QueryInterface(pythoncom.IID_IUnknown)
-    return CheckSameCOMObject(u1, u2)
-
-
-def FailObjectIdentity(ob1, ob2, when):
-    if not CheckObjectIdentity(ob1, ob2):
-        global numErrors
-        numErrors = numErrors + 1
-        print(when, "are not identical (%s, %s)" % (repr(ob1), repr(ob2)))
-
-
-class Dummy:
-    _public_methods_ = []  # We never attempt to make a call on this object.
-    _com_interfaces_ = [pythoncom.IID_IPersistStorage]
-
-
-class Dummy2:
-    _public_methods_ = []  # We never attempt to make a call on this object.
-    _com_interfaces_ = [
-        pythoncom.IID_IPersistStorage,
-        pythoncom.IID_IExternalConnection,
-    ]
-
-
-class DeletgatedDummy:
-    _public_methods_ = []
-
-
-class Dummy3:
-    _public_methods_ = []  # We never attempt to make a call on this object.
-    _com_interfaces_ = [pythoncom.IID_IPersistStorage]
-
-    def _query_interface_(self, iid):
-        if iid == pythoncom.IID_IExternalConnection:
-            # This will NEVER work - can only wrap the object once!
-            return wrap(DelegatedDummy())
-
-
-def TestGatewayInheritance():
-    # By default, wrap() creates and discards a temporary object.
-    # This is not necessary, but just the current implementation of wrap.
-    # As the object is correctly discarded, it doesnt affect this test.
-    o = wrap(Dummy(), pythoncom.IID_IPersistStorage)
-    o2 = o.QueryInterface(pythoncom.IID_IUnknown)
-    FailObjectIdentity(o, o2, "IID_IPersistStorage->IID_IUnknown")
-
-    o3 = o2.QueryInterface(pythoncom.IID_IDispatch)
-
-    FailObjectIdentity(o2, o3, "IID_IUnknown->IID_IDispatch")
-    FailObjectIdentity(o, o3, "IID_IPersistStorage->IID_IDispatch")
-
-    o4 = o3.QueryInterface(pythoncom.IID_IPersistStorage)
-    FailObjectIdentity(o, o4, "IID_IPersistStorage->IID_IPersistStorage(2)")
-    FailObjectIdentity(o2, o4, "IID_IUnknown->IID_IPersistStorage(2)")
-    FailObjectIdentity(o3, o4, "IID_IDispatch->IID_IPersistStorage(2)")
-
-    o5 = o4.QueryInterface(pythoncom.IID_IPersist)
-    FailObjectIdentity(o, o5, "IID_IPersistStorage->IID_IPersist")
-    FailObjectIdentity(o2, o5, "IID_IUnknown->IID_IPersist")
-    FailObjectIdentity(o3, o5, "IID_IDispatch->IID_IPersist")
-    FailObjectIdentity(o4, o5, "IID_IPersistStorage(2)->IID_IPersist")
-
-
-def TestMultiInterface():
-    o = wrap(Dummy2(), pythoncom.IID_IPersistStorage)
-    o2 = o.QueryInterface(pythoncom.IID_IExternalConnection)
-
-    FailObjectIdentity(o, o2, "IID_IPersistStorage->IID_IExternalConnection")
-
-    # Make the same QI again, to make sure it is stable.
-    o22 = o.QueryInterface(pythoncom.IID_IExternalConnection)
-    FailObjectIdentity(o, o22, "IID_IPersistStorage->IID_IExternalConnection")
-    FailObjectIdentity(
-        o2, o22, "IID_IPersistStorage->IID_IExternalConnection (stability)"
-    )
-
-    o3 = o2.QueryInterface(pythoncom.IID_IPersistStorage)
-    FailObjectIdentity(o2, o3, "IID_IExternalConnection->IID_IPersistStorage")
-    FailObjectIdentity(
-        o, o3, "IID_IPersistStorage->IID_IExternalConnection->IID_IPersistStorage"
-    )
-
-
-def test():
-    TestGatewayInheritance()
-    TestMultiInterface()
-    if numErrors == 0:
-        print("Worked ok")
-    else:
-        print("There were", numErrors, "errors.")
-
-
-if __name__ == "__main__":
-    test()
-    CheckClean()
diff --git a/lib/win32com/test/testInterp.vbs b/lib/win32com/test/testInterp.vbs
deleted file mode 100644
index f34d17a9..00000000
--- a/lib/win32com/test/testInterp.vbs
+++ /dev/null
@@ -1,12 +0,0 @@
-set o = CreateObject("Python.Interpreter")
-if o.Eval("1+1") <> 2 Then
-	WScript.Echo "Eval('1+1') failed"
-	bFailed = True
-end if
-
-if bFailed then
-	WScript.Echo "*********** VBScript tests failed *********"
-else
-	WScript.Echo "VBScript test worked OK"
-end if
-
diff --git a/lib/win32com/test/testIterators.py b/lib/win32com/test/testIterators.py
deleted file mode 100644
index b75a78df..00000000
--- a/lib/win32com/test/testIterators.py
+++ /dev/null
@@ -1,140 +0,0 @@
-# Some raw iter tests.  Some "high-level" iterator tests can be found in
-# testvb.py and testOutlook.py
-import sys
-import unittest
-
-import pythoncom
-import win32com.server.util
-import win32com.test.util
-from win32com.client import Dispatch
-from win32com.client.gencache import EnsureDispatch
-
-
-class _BaseTestCase(win32com.test.util.TestCase):
-    def test_enumvariant_vb(self):
-        ob, iter = self.iter_factory()
-        got = []
-        for v in iter:
-            got.append(v)
-        self.assertEqual(got, self.expected_data)
-
-    def test_yield(self):
-        ob, i = self.iter_factory()
-        got = []
-        for v in iter(i):
-            got.append(v)
-        self.assertEqual(got, self.expected_data)
-
-    def _do_test_nonenum(self, object):
-        try:
-            for i in object:
-                pass
-            self.fail("Could iterate over a non-iterable object")
-        except TypeError:
-            pass  # this is expected.
-        self.assertRaises(TypeError, iter, object)
-        self.assertRaises(AttributeError, getattr, object, "next")
-
-    def test_nonenum_wrapper(self):
-        # Check our raw PyIDispatch
-        ob = self.object._oleobj_
-        try:
-            for i in ob:
-                pass
-            self.fail("Could iterate over a non-iterable object")
-        except TypeError:
-            pass  # this is expected.
-        self.assertRaises(TypeError, iter, ob)
-        self.assertRaises(AttributeError, getattr, ob, "next")
-
-        # And our Dispatch wrapper
-        ob = self.object
-        try:
-            for i in ob:
-                pass
-            self.fail("Could iterate over a non-iterable object")
-        except TypeError:
-            pass  # this is expected.
-        # Note that as our object may be dynamic, we *do* have a __getitem__
-        # method, meaning we *can* call iter() on the object.  In this case
-        # actual iteration is what fails.
-        # So either the 'iter(); will raise a type error, or an attempt to
-        # fetch it
-        try:
-            next(iter(ob))
-            self.fail("Expected a TypeError fetching this iterator")
-        except TypeError:
-            pass
-        # And it should never have a 'next' method
-        self.assertRaises(AttributeError, getattr, ob, "next")
-
-
-class VBTestCase(_BaseTestCase):
-    def setUp(self):
-        def factory():
-            # Our VB test harness exposes a property with IEnumVariant.
-            ob = self.object.EnumerableCollectionProperty
-            for i in self.expected_data:
-                ob.Add(i)
-            # Get the raw IEnumVARIANT.
-            invkind = pythoncom.DISPATCH_METHOD | pythoncom.DISPATCH_PROPERTYGET
-            iter = ob._oleobj_.InvokeTypes(
-                pythoncom.DISPID_NEWENUM, 0, invkind, (13, 10), ()
-            )
-            return ob, iter.QueryInterface(pythoncom.IID_IEnumVARIANT)
-
-        # We *need* generated dispatch semantics, so dynamic __getitem__ etc
-        # don't get in the way of our tests.
-        self.object = EnsureDispatch("PyCOMVBTest.Tester")
-        self.expected_data = [1, "Two", "3"]
-        self.iter_factory = factory
-
-    def tearDown(self):
-        self.object = None
-
-
-# Test our client semantics, but using a wrapped Python list object.
-# This has the effect of re-using our client specific tests, but in this
-# case is exercising the server side.
-class SomeObject:
-    _public_methods_ = ["GetCollection"]
-
-    def __init__(self, data):
-        self.data = data
-
-    def GetCollection(self):
-        return win32com.server.util.NewCollection(self.data)
-
-
-class WrappedPythonCOMServerTestCase(_BaseTestCase):
-    def setUp(self):
-        def factory():
-            ob = self.object.GetCollection()
-            flags = pythoncom.DISPATCH_METHOD | pythoncom.DISPATCH_PROPERTYGET
-            enum = ob._oleobj_.Invoke(pythoncom.DISPID_NEWENUM, 0, flags, 1)
-            return ob, enum.QueryInterface(pythoncom.IID_IEnumVARIANT)
-
-        self.expected_data = [1, "Two", 3]
-        sv = win32com.server.util.wrap(SomeObject(self.expected_data))
-        self.object = Dispatch(sv)
-        self.iter_factory = factory
-
-    def tearDown(self):
-        self.object = None
-
-
-def suite():
-    # We dont want our base class run
-    suite = unittest.TestSuite()
-    for item in list(globals().values()):
-        if (
-            type(item) == type(unittest.TestCase)
-            and issubclass(item, unittest.TestCase)
-            and item != _BaseTestCase
-        ):
-            suite.addTest(unittest.makeSuite(item))
-    return suite
-
-
-if __name__ == "__main__":
-    unittest.main(argv=sys.argv + ["suite"])
diff --git a/lib/win32com/test/testMSOffice.py b/lib/win32com/test/testMSOffice.py
deleted file mode 100644
index f4893dfd..00000000
--- a/lib/win32com/test/testMSOffice.py
+++ /dev/null
@@ -1,209 +0,0 @@
-# Test MSOffice
-#
-# Main purpose of test is to ensure that Dynamic COM objects
-# work as expected.
-
-# Assumes Word and Excel installed on your machine.
-
-import traceback
-
-import pythoncom
-import win32api
-import win32com
-import win32com.client.dynamic
-from pywintypes import Unicode
-from win32com.client import gencache
-from win32com.test.util import CheckClean
-
-error = "MSOffice test error"
-
-
-# Test a few of the MSOffice components.
-def TestWord():
-    # Try and load the object exposed by Word 8
-    # Office 97 - _totally_ different object model!
-    try:
-        # NOTE - using "client.Dispatch" would return an msword8.py instance!
-        print("Starting Word 8 for dynamic test")
-        word = win32com.client.dynamic.Dispatch("Word.Application")
-        TestWord8(word)
-
-        word = None
-        # Now we will test Dispatch without the new "lazy" capabilities
-        print("Starting Word 8 for non-lazy dynamic test")
-        dispatch = win32com.client.dynamic._GetGoodDispatch("Word.Application")
-        typeinfo = dispatch.GetTypeInfo()
-        attr = typeinfo.GetTypeAttr()
-        olerepr = win32com.client.build.DispatchItem(typeinfo, attr, None, 0)
-        word = win32com.client.dynamic.CDispatch(dispatch, olerepr)
-        dispatch = typeinfo = attr = olerepr = None
-        TestWord8(word)
-
-    except pythoncom.com_error:
-        print("Starting Word 7 for dynamic test")
-        word = win32com.client.Dispatch("Word.Basic")
-        TestWord7(word)
-
-    except Exception as e:
-        print("Word dynamic tests failed", e)
-        traceback.print_exc()
-
-    print("Starting MSWord for generated test")
-    try:
-        from win32com.client import gencache
-
-        word = gencache.EnsureDispatch("Word.Application.8")
-        TestWord8(word)
-    except Exception as e:
-        print("Word generated tests failed", e)
-        traceback.print_exc()
-
-
-def TestWord7(word):
-    word.FileNew()
-    # If not shown, show the app.
-    if not word.AppShow():
-        word._proc_("AppShow")
-
-    for i in range(12):
-        word.FormatFont(Color=i + 1, Points=i + 12)
-        word.Insert("Hello from Python %d\n" % i)
-
-    word.FileClose(2)
-
-
-def TestWord8(word):
-    word.Visible = 1
-    doc = word.Documents.Add()
-    wrange = doc.Range()
-    for i in range(10):
-        wrange.InsertAfter("Hello from Python %d\n" % i)
-    paras = doc.Paragraphs
-    for i in range(len(paras)):
-        # *sob* - in Word 2019, `p = paras(i+1)` seems to work to get a para
-        # but `p.Font` then blows up.
-        #        p = paras[i]()
-        p = paras(i + 1)
-        p.Font.ColorIndex = i + 1
-        p.Font.Size = 12 + (4 * i)
-    # XXX - note that
-    # for para in paras:
-    #       para().Font...
-    # doesnt seem to work - no error, just doesnt work
-    # Should check if it works for VB!
-    doc.Close(SaveChanges=0)
-    word.Quit()
-    win32api.Sleep(1000)  # Wait for word to close, else we
-    # may get OA error.
-
-
-def TestWord8OldStyle():
-    try:
-        import win32com.test.Generated4Test.msword8
-    except ImportError:
-        print("Can not do old style test")
-
-
-def TextExcel(xl):
-    xl.Visible = 0
-    if xl.Visible:
-        raise error("Visible property is true.")
-    xl.Visible = 1
-    if not xl.Visible:
-        raise error("Visible property not true.")
-
-    if int(xl.Version[0]) >= 8:
-        xl.Workbooks.Add()
-    else:
-        xl.Workbooks().Add()
-
-    xl.Range("A1:C1").Value = (1, 2, 3)
-    xl.Range("A2:C2").Value = ("x", "y", "z")
-    xl.Range("A3:C3").Value = ("3", "2", "1")
-
-    for i in range(20):
-        xl.Cells(i + 1, i + 1).Value = "Hi %d" % i
-
-    if xl.Range("A1").Value != "Hi 0":
-        raise error("Single cell range failed")
-
-    if xl.Range("A1:B1").Value != ((Unicode("Hi 0"), 2),):
-        raise error("flat-horizontal cell range failed")
-
-    if xl.Range("A1:A2").Value != ((Unicode("Hi 0"),), (Unicode("x"),)):
-        raise error("flat-vertical cell range failed")
-
-    if xl.Range("A1:C3").Value != (
-        (Unicode("Hi 0"), 2, 3),
-        (Unicode("x"), Unicode("Hi 1"), Unicode("z")),
-        (3, 2, Unicode("Hi 2")),
-    ):
-        raise error("square cell range failed")
-
-    xl.Range("A1:C3").Value = ((3, 2, 1), ("x", "y", "z"), (1, 2, 3))
-
-    if xl.Range("A1:C3").Value != (
-        (3, 2, 1),
-        (Unicode("x"), Unicode("y"), Unicode("z")),
-        (1, 2, 3),
-    ):
-        raise error("Range was not what I set it to!")
-
-    # test dates out with Excel
-    xl.Cells(5, 1).Value = "Excel time"
-    xl.Cells(5, 2).Formula = "=Now()"
-
-    import time
-
-    xl.Cells(6, 1).Value = "Python time"
-    xl.Cells(6, 2).Value = pythoncom.MakeTime(time.time())
-    xl.Cells(6, 2).NumberFormat = "d/mm/yy h:mm"
-    xl.Columns("A:B").EntireColumn.AutoFit()
-
-    xl.Workbooks(1).Close(0)
-    xl.Quit()
-
-
-def TestAll():
-    TestWord()
-
-    try:
-        print("Starting Excel for Dynamic test...")
-        xl = win32com.client.dynamic.Dispatch("Excel.Application")
-        TextExcel(xl)
-    except Exception as e:
-        worked = False
-        print("Excel tests failed", e)
-        traceback.print_exc()
-
-    try:
-        print("Starting Excel 8 for generated excel8.py test...")
-        mod = gencache.EnsureModule(
-            "{00020813-0000-0000-C000-000000000046}", 0, 1, 2, bForDemand=1
-        )
-        xl = win32com.client.Dispatch("Excel.Application")
-        TextExcel(xl)
-    except ImportError:
-        print("Could not import the generated Excel 97 wrapper")
-    except Exception as e:
-        print("Generated Excel tests failed", e)
-        traceback.print_exc()
-
-    try:
-        import xl5en32
-
-        mod = gencache.EnsureModule("{00020813-0000-0000-C000-000000000046}", 9, 1, 0)
-        xl = win32com.client.Dispatch("Excel.Application.5")
-        print("Starting Excel 95 for makepy test...")
-        TextExcel(xl)
-    except ImportError:
-        print("Could not import the generated Excel 95 wrapper")
-    except Exception as e:
-        print("Excel 95 tests failed", e)
-        traceback.print_exc()
-
-
-if __name__ == "__main__":
-    TestAll()
-    CheckClean()
-    pythoncom.CoUninitialize()
diff --git a/lib/win32com/test/testMSOfficeEvents.py b/lib/win32com/test/testMSOfficeEvents.py
deleted file mode 100644
index c173c3ef..00000000
--- a/lib/win32com/test/testMSOfficeEvents.py
+++ /dev/null
@@ -1,136 +0,0 @@
-# OfficeEvents - test/demonstrate events with Word and Excel.
-import msvcrt
-import sys
-import threading
-import time
-import types
-
-import pythoncom
-from win32com.client import Dispatch, DispatchWithEvents
-
-stopEvent = threading.Event()
-
-
-def TestExcel():
-    class ExcelEvents:
-        def OnNewWorkbook(self, wb):
-            if type(wb) != types.InstanceType:
-                raise RuntimeError(
-                    "The transformer doesnt appear to have translated this for us!"
-                )
-            self.seen_events["OnNewWorkbook"] = None
-
-        def OnWindowActivate(self, wb, wn):
-            if type(wb) != types.InstanceType or type(wn) != types.InstanceType:
-                raise RuntimeError(
-                    "The transformer doesnt appear to have translated this for us!"
-                )
-            self.seen_events["OnWindowActivate"] = None
-
-        def OnWindowDeactivate(self, wb, wn):
-            self.seen_events["OnWindowDeactivate"] = None
-
-        def OnSheetDeactivate(self, sh):
-            self.seen_events["OnSheetDeactivate"] = None
-
-        def OnSheetBeforeDoubleClick(self, Sh, Target, Cancel):
-            if Target.Column % 2 == 0:
-                print("You can double-click there...")
-            else:
-                print("You can not double-click there...")
-                # This function is a void, so the result ends up in
-                # the only ByRef - Cancel.
-                return 1
-
-    class WorkbookEvents:
-        def OnActivate(self):
-            print("workbook OnActivate")
-
-        def OnBeforeRightClick(self, Target, Cancel):
-            print("It's a Worksheet Event")
-
-    e = DispatchWithEvents("Excel.Application", ExcelEvents)
-    e.seen_events = {}
-    e.Visible = 1
-    book = e.Workbooks.Add()
-    book = DispatchWithEvents(book, WorkbookEvents)
-    print("Have book", book)
-    #    sheet = e.Worksheets(1)
-    #    sheet = DispatchWithEvents(sheet, WorksheetEvents)
-
-    print("Double-click in a few of the Excel cells...")
-    print("Press any key when finished with Excel, or wait 10 seconds...")
-    if not _WaitForFinish(e, 10):
-        e.Quit()
-    if not _CheckSeenEvents(e, ["OnNewWorkbook", "OnWindowActivate"]):
-        sys.exit(1)
-
-
-def TestWord():
-    class WordEvents:
-        def OnDocumentChange(self):
-            self.seen_events["OnDocumentChange"] = None
-
-        def OnWindowActivate(self, doc, wn):
-            self.seen_events["OnWindowActivate"] = None
-
-        def OnQuit(self):
-            self.seen_events["OnQuit"] = None
-            stopEvent.set()
-
-    w = DispatchWithEvents("Word.Application", WordEvents)
-    w.seen_events = {}
-    w.Visible = 1
-    w.Documents.Add()
-    print("Press any key when finished with Word, or wait 10 seconds...")
-    if not _WaitForFinish(w, 10):
-        w.Quit()
-    if not _CheckSeenEvents(w, ["OnDocumentChange", "OnWindowActivate"]):
-        sys.exit(1)
-
-
-def _WaitForFinish(ob, timeout):
-    end = time.time() + timeout
-    while 1:
-        if msvcrt.kbhit():
-            msvcrt.getch()
-            break
-        pythoncom.PumpWaitingMessages()
-        stopEvent.wait(0.2)
-        if stopEvent.isSet():
-            stopEvent.clear()
-            break
-        try:
-            if not ob.Visible:
-                # Gone invisible - we need to pretend we timed
-                # out, so the app is quit.
-                return 0
-        except pythoncom.com_error:
-            # Excel is busy (eg, editing the cell) - ignore
-            pass
-        if time.time() > end:
-            return 0
-    return 1
-
-
-def _CheckSeenEvents(o, events):
-    rc = 1
-    for e in events:
-        if e not in o.seen_events:
-            print("ERROR: Expected event did not trigger", e)
-            rc = 0
-    return rc
-
-
-def test():
-    import sys
-
-    if "noword" not in sys.argv[1:]:
-        TestWord()
-    if "noexcel" not in sys.argv[1:]:
-        TestExcel()
-    print("Word and Excel event tests passed.")
-
-
-if __name__ == "__main__":
-    test()
diff --git a/lib/win32com/test/testMarshal.py b/lib/win32com/test/testMarshal.py
deleted file mode 100644
index c57d445f..00000000
--- a/lib/win32com/test/testMarshal.py
+++ /dev/null
@@ -1,160 +0,0 @@
-"""Testing pasing object between multiple COM threads
-
-Uses standard COM marshalling to pass objects between threads.  Even
-though Python generally seems to work when you just pass COM objects
-between threads, it shouldnt.
-
-This shows the "correct" way to do it.
-
-It shows that although we create new threads to use the Python.Interpreter,
-COM marshalls back all calls to that object to the main Python thread,
-which must be running a message loop (as this sample does).
-
-When this test is run in "free threaded" mode (at this stage, you must
-manually mark the COM objects as "ThreadingModel=Free", or run from a
-service which has marked itself as free-threaded), then no marshalling
-is done, and the Python.Interpreter object start doing the "expected" thing
-- ie, it reports being on the same thread as its caller!
-
-Python.exe needs a good way to mark itself as FreeThreaded - at the moment
-this is a pain in the but!
-
-"""
-
-import threading
-import unittest
-
-import pythoncom
-import win32api
-import win32com.client
-import win32event
-
-from .testServers import InterpCase
-
-freeThreaded = 1
-
-
-class ThreadInterpCase(InterpCase):
-    def _testInterpInThread(self, stopEvent, interp):
-        try:
-            self._doTestInThread(interp)
-        finally:
-            win32event.SetEvent(stopEvent)
-
-    def _doTestInThread(self, interp):
-        pythoncom.CoInitialize()
-        myThread = win32api.GetCurrentThreadId()
-
-        if freeThreaded:
-            interp = pythoncom.CoGetInterfaceAndReleaseStream(
-                interp, pythoncom.IID_IDispatch
-            )
-            interp = win32com.client.Dispatch(interp)
-
-        interp.Exec("import win32api")
-        # print "The test thread id is %d, Python.Interpreter's thread ID is %d" % (myThread, interp.Eval("win32api.GetCurrentThreadId()"))
-        pythoncom.CoUninitialize()
-
-    def BeginThreadsSimpleMarshal(self, numThreads):
-        """Creates multiple threads using simple (but slower) marshalling.
-
-        Single interpreter object, but a new stream is created per thread.
-
-        Returns the handles the threads will set when complete.
-        """
-        interp = win32com.client.Dispatch("Python.Interpreter")
-        events = []
-        threads = []
-        for i in range(numThreads):
-            hEvent = win32event.CreateEvent(None, 0, 0, None)
-            events.append(hEvent)
-            interpStream = pythoncom.CoMarshalInterThreadInterfaceInStream(
-                pythoncom.IID_IDispatch, interp._oleobj_
-            )
-            t = threading.Thread(
-                target=self._testInterpInThread, args=(hEvent, interpStream)
-            )
-            t.setDaemon(1)  # so errors dont cause shutdown hang
-            t.start()
-            threads.append(t)
-        interp = None
-        return threads, events
-
-    #
-    # NOTE - this doesnt quite work - Im not even sure it should, but Greg reckons
-    # you should be able to avoid the marshal per thread!
-    # I think that refers to CoMarshalInterface though...
-    def BeginThreadsFastMarshal(self, numThreads):
-        """Creates multiple threads using fast (but complex) marshalling.
-
-        The marshal stream is created once, and each thread uses the same stream
-
-        Returns the handles the threads will set when complete.
-        """
-        interp = win32com.client.Dispatch("Python.Interpreter")
-        if freeThreaded:
-            interp = pythoncom.CoMarshalInterThreadInterfaceInStream(
-                pythoncom.IID_IDispatch, interp._oleobj_
-            )
-        events = []
-        threads = []
-        for i in range(numThreads):
-            hEvent = win32event.CreateEvent(None, 0, 0, None)
-            t = threading.Thread(target=self._testInterpInThread, args=(hEvent, interp))
-            t.setDaemon(1)  # so errors dont cause shutdown hang
-            t.start()
-            events.append(hEvent)
-            threads.append(t)
-        return threads, events
-
-    def _DoTestMarshal(self, fn, bCoWait=0):
-        # print "The main thread is %d" % (win32api.GetCurrentThreadId())
-        threads, events = fn(2)
-        numFinished = 0
-        while 1:
-            try:
-                if bCoWait:
-                    rc = pythoncom.CoWaitForMultipleHandles(0, 2000, events)
-                else:
-                    # Specifying "bWaitAll" here will wait for messages *and* all events
-                    # (which is pretty useless)
-                    rc = win32event.MsgWaitForMultipleObjects(
-                        events, 0, 2000, win32event.QS_ALLINPUT
-                    )
-                if (
-                    rc >= win32event.WAIT_OBJECT_0
-                    and rc < win32event.WAIT_OBJECT_0 + len(events)
-                ):
-                    numFinished = numFinished + 1
-                    if numFinished >= len(events):
-                        break
-                elif rc == win32event.WAIT_OBJECT_0 + len(events):  # a message
-                    # This is critical - whole apartment model demo will hang.
-                    pythoncom.PumpWaitingMessages()
-                else:  # Timeout
-                    print(
-                        "Waiting for thread to stop with interfaces=%d, gateways=%d"
-                        % (pythoncom._GetInterfaceCount(), pythoncom._GetGatewayCount())
-                    )
-            except KeyboardInterrupt:
-                break
-        for t in threads:
-            t.join(2)
-            self.assertFalse(t.is_alive(), "thread failed to stop!?")
-        threads = None  # threads hold references to args
-        # Seems to be a leak here I can't locate :(
-        # self.assertEqual(pythoncom._GetInterfaceCount(), 0)
-        # self.assertEqual(pythoncom._GetGatewayCount(), 0)
-
-    def testSimpleMarshal(self):
-        self._DoTestMarshal(self.BeginThreadsSimpleMarshal)
-
-    def testSimpleMarshalCoWait(self):
-        self._DoTestMarshal(self.BeginThreadsSimpleMarshal, 1)
-
-
-#    def testFastMarshal(self):
-#        self._DoTestMarshal(self.BeginThreadsFastMarshal)
-
-if __name__ == "__main__":
-    unittest.main("testMarshal")
diff --git a/lib/win32com/test/testNetscape.py b/lib/win32com/test/testNetscape.py
deleted file mode 100644
index 471de802..00000000
--- a/lib/win32com/test/testNetscape.py
+++ /dev/null
@@ -1,27 +0,0 @@
-## AHH - I cant make this work!!!
-
-# But this is the general idea.
-
-import sys
-
-import netscape
-
-error = "Netscape Test Error"
-
-if __name__ == "__main__":
-    n = netscape.CNetworkCX()
-    rc = n.Open("http://d|/temp/apyext.html", 0, None, 0, None)
-    if not rc:
-        raise error("Open method of Netscape failed")
-    while 1:
-        num, str = n.Read(None, 0)
-        print("Got ", num, str)
-        if num == 0:
-            break  # used to be continue - no idea!!
-        if num == -1:
-            break
-    #               sys.stdout.write(str)
-    n.Close()
-    print("Done!")
-    del n
-    sys.last_type = sys.last_value = sys.last_traceback = None
diff --git a/lib/win32com/test/testPersist.py b/lib/win32com/test/testPersist.py
deleted file mode 100644
index 066f4029..00000000
--- a/lib/win32com/test/testPersist.py
+++ /dev/null
@@ -1,231 +0,0 @@
-import os
-
-import pythoncom
-import pywintypes
-import win32api
-import win32com
-import win32com.client
-import win32com.client.dynamic
-import win32com.server.util
-import win32ui
-from pywin32_testutil import str2bytes
-from pywintypes import Unicode
-from win32com import storagecon
-from win32com.axcontrol import axcontrol
-from win32com.test.util import CheckClean
-
-S_OK = 0
-
-
-import win32timezone
-
-now = win32timezone.now()
-
-
-class LockBytes:
-    _public_methods_ = [
-        "ReadAt",
-        "WriteAt",
-        "Flush",
-        "SetSize",
-        "LockRegion",
-        "UnlockRegion",
-        "Stat",
-    ]
-    _com_interfaces_ = [pythoncom.IID_ILockBytes]
-
-    def __init__(self, data=""):
-        self.data = str2bytes(data)
-        self.ctime = now
-        self.mtime = now
-        self.atime = now
-
-    def ReadAt(self, offset, cb):
-        print("ReadAt")
-        result = self.data[offset : offset + cb]
-        return result
-
-    def WriteAt(self, offset, data):
-        print("WriteAt " + str(offset))
-        print("len " + str(len(data)))
-        print("data:")
-        # print data
-        if len(self.data) >= offset:
-            newdata = self.data[0:offset] + data
-        print(len(newdata))
-        if len(self.data) >= offset + len(data):
-            newdata = newdata + self.data[offset + len(data) :]
-        print(len(newdata))
-        self.data = newdata
-        return len(data)
-
-    def Flush(self, whatsthis=0):
-        print("Flush" + str(whatsthis))
-        fname = os.path.join(win32api.GetTempPath(), "persist.doc")
-        open(fname, "wb").write(self.data)
-        return S_OK
-
-    def SetSize(self, size):
-        print("Set Size" + str(size))
-        if size > len(self.data):
-            self.data = self.data + str2bytes("\000" * (size - len(self.data)))
-        else:
-            self.data = self.data[0:size]
-        return S_OK
-
-    def LockRegion(self, offset, size, locktype):
-        print("LockRegion")
-
-    def UnlockRegion(self, offset, size, locktype):
-        print("UnlockRegion")
-
-    def Stat(self, statflag):
-        print("returning Stat " + str(statflag))
-        return (
-            "PyMemBytes",
-            storagecon.STGTY_LOCKBYTES,
-            len(self.data),
-            self.mtime,
-            self.ctime,
-            self.atime,
-            storagecon.STGM_DIRECT | storagecon.STGM_READWRITE | storagecon.STGM_CREATE,
-            storagecon.STGM_SHARE_EXCLUSIVE,
-            "{00020905-0000-0000-C000-000000000046}",
-            0,  # statebits ?
-            0,
-        )
-
-
-class OleClientSite:
-    _public_methods_ = [
-        "SaveObject",
-        "GetMoniker",
-        "GetContainer",
-        "ShowObject",
-        "OnShowWindow",
-        "RequestNewObjectLayout",
-    ]
-    _com_interfaces_ = [axcontrol.IID_IOleClientSite]
-
-    def __init__(self, data=""):
-        self.IPersistStorage = None
-        self.IStorage = None
-
-    def SetIPersistStorage(self, IPersistStorage):
-        self.IPersistStorage = IPersistStorage
-
-    def SetIStorage(self, IStorage):
-        self.IStorage = IStorage
-
-    def SaveObject(self):
-        print("SaveObject")
-        if self.IPersistStorage != None and self.IStorage != None:
-            self.IPersistStorage.Save(self.IStorage, 1)
-            self.IStorage.Commit(0)
-        return S_OK
-
-    def GetMoniker(self, dwAssign, dwWhichMoniker):
-        print("GetMoniker " + str(dwAssign) + " " + str(dwWhichMoniker))
-
-    def GetContainer(self):
-        print("GetContainer")
-
-    def ShowObject(self):
-        print("ShowObject")
-
-    def OnShowWindow(self, fShow):
-        print("ShowObject" + str(fShow))
-
-    def RequestNewObjectLayout(self):
-        print("RequestNewObjectLayout")
-
-
-def test():
-    # create a LockBytes object and
-    # wrap it as a COM object
-    #       import win32com.server.dispatcher
-    lbcom = win32com.server.util.wrap(
-        LockBytes(), pythoncom.IID_ILockBytes
-    )  # , useDispatcher=win32com.server.dispatcher.DispatcherWin32trace)
-
-    # create a structured storage on the ILockBytes object
-    stcom = pythoncom.StgCreateDocfileOnILockBytes(
-        lbcom,
-        storagecon.STGM_DIRECT
-        | storagecon.STGM_CREATE
-        | storagecon.STGM_READWRITE
-        | storagecon.STGM_SHARE_EXCLUSIVE,
-        0,
-    )
-
-    # create our ClientSite
-    ocs = OleClientSite()
-    # wrap it as a COM object
-    ocscom = win32com.server.util.wrap(ocs, axcontrol.IID_IOleClientSite)
-
-    # create a Word OLE Document, connect it to our site and our storage
-    oocom = axcontrol.OleCreate(
-        "{00020906-0000-0000-C000-000000000046}",
-        axcontrol.IID_IOleObject,
-        0,
-        (0,),
-        ocscom,
-        stcom,
-    )
-
-    mf = win32ui.GetMainFrame()
-    hwnd = mf.GetSafeHwnd()
-
-    # Set the host and document name
-    # for unknown reason document name becomes hostname, and document name
-    # is not set, debugged it, but don't know where the problem is?
-    oocom.SetHostNames("OTPython", "This is Cool")
-
-    # activate the OLE document
-    oocom.DoVerb(-1, ocscom, 0, hwnd, mf.GetWindowRect())
-
-    # set the hostnames again
-    oocom.SetHostNames("OTPython2", "ThisisCool2")
-
-    # get IDispatch of Word
-    doc = win32com.client.Dispatch(oocom.QueryInterface(pythoncom.IID_IDispatch))
-
-    # get IPersistStorage of Word
-    dpcom = oocom.QueryInterface(pythoncom.IID_IPersistStorage)
-
-    # let our ClientSite know the interfaces
-    ocs.SetIPersistStorage(dpcom)
-    ocs.SetIStorage(stcom)
-
-    # use IDispatch to do the Office Word test
-    # pasted from TestOffice.py
-
-    wrange = doc.Range()
-    for i in range(10):
-        wrange.InsertAfter("Hello from Python %d\n" % i)
-    paras = doc.Paragraphs
-    for i in range(len(paras)):
-        paras[i]().Font.ColorIndex = i + 1
-        paras[i]().Font.Size = 12 + (4 * i)
-    # XXX - note that
-    # for para in paras:
-    #       para().Font...
-    # doesnt seem to work - no error, just doesnt work
-    # Should check if it works for VB!
-
-    dpcom.Save(stcom, 0)
-    dpcom.HandsOffStorage()
-    #       oocom.Close(axcontrol.OLECLOSE_NOSAVE) # or OLECLOSE_SAVEIFDIRTY, but it fails???
-
-    # Save the ILockBytes data to "persist2.doc"
-    lbcom.Flush()
-
-    # exiting Winword will automatically update the ILockBytes data
-    # and flush it to "%TEMP%\persist.doc"
-    doc.Application.Quit()
-
-
-if __name__ == "__main__":
-    test()
-    pythoncom.CoUninitialize()
-    CheckClean()
diff --git a/lib/win32com/test/testPippo.py b/lib/win32com/test/testPippo.py
deleted file mode 100644
index a1a762c2..00000000
--- a/lib/win32com/test/testPippo.py
+++ /dev/null
@@ -1,82 +0,0 @@
-import sys
-import unittest
-
-import pythoncom
-from win32com.client import Dispatch
-from win32com.client.gencache import EnsureDispatch
-
-
-class PippoTester(unittest.TestCase):
-    def setUp(self):
-        from win32com.test import pippo_server
-        from win32com.test.util import RegisterPythonServer
-
-        RegisterPythonServer(pippo_server.__file__, "Python.Test.Pippo")
-        # create it.
-        self.object = Dispatch("Python.Test.Pippo")
-
-    def testLeaks(self):
-        try:
-            gtrc = sys.gettotalrefcount
-        except AttributeError:
-            print("Please run this with python_d for leak tests")
-            gtrc = lambda: 0
-        # note creating self.object() should have consumed our "one time" leaks
-        self.object.Method1()
-        start = gtrc()
-        for i in range(1000):
-            object = Dispatch("Python.Test.Pippo")
-            object.Method1()
-        object = None
-        end = gtrc()
-        if end - start > 5:
-            self.fail("We lost %d references!" % (end - start,))
-
-    def testResults(self):
-        rc, out1 = self.object.Method2(123, 111)
-        self.assertEqual(rc, 123)
-        self.assertEqual(out1, 222)
-
-    def testPythonArrays(self):
-        self._testArray([-3, -2, -1, 0, 1, 2, 3])
-        self._testArray([-3.14, -2, -0.1, 0.0, 1.1, 2.5, 3])
-
-    def testNumpyArrays(self):
-        try:
-            import numpy
-        except:
-            print("Numpy test not possible because numpy module failed to import")
-            return
-        self._testArray(numpy.array([-3, -2, -1, 0, 1, 2, 3]))
-        self._testArray(numpy.array([-3.14, -2, -0.1, 0.0, 1.1, 2.5, 3]))
-
-    def testByteArrays(self):
-        if "bytes" in dir(__builtins__):
-            # Use eval to avoid compilation error in Python 2.
-            self._testArray(eval("b'abcdef'"))
-            self._testArray(eval("bytearray(b'abcdef')"))
-
-    def _testArray(self, inArray):
-        outArray = self.object.Method3(inArray)
-        self.assertEqual(list(outArray), list(inArray))
-
-    def testLeaksGencache(self):
-        try:
-            gtrc = sys.gettotalrefcount
-        except AttributeError:
-            print("Please run this with python_d for leak tests")
-            gtrc = lambda: 0
-        # note creating self.object() should have consumed our "one time" leaks
-        object = EnsureDispatch("Python.Test.Pippo")
-        start = gtrc()
-        for i in range(1000):
-            object = EnsureDispatch("Python.Test.Pippo")
-            object.Method1()
-        object = None
-        end = gtrc()
-        if end - start > 10:
-            self.fail("We lost %d references!" % (end - start,))
-
-
-if __name__ == "__main__":
-    unittest.main()
diff --git a/lib/win32com/test/testPyComTest.py b/lib/win32com/test/testPyComTest.py
deleted file mode 100644
index aec0a6f5..00000000
--- a/lib/win32com/test/testPyComTest.py
+++ /dev/null
@@ -1,835 +0,0 @@
-# NOTE - Still seems to be a leak here somewhere
-# gateway count doesnt hit zero.  Hence the print statements!
-
-import sys
-
-sys.coinit_flags = 0  # Must be free-threaded!
-import datetime
-import decimal
-import os
-import time
-
-import pythoncom
-import pywintypes
-import win32api
-import win32com
-import win32com.client.connect
-import win32timezone
-import winerror
-from pywin32_testutil import str2memory
-from win32com.client import VARIANT, CastTo, DispatchBaseClass, constants
-from win32com.test.util import CheckClean, RegisterPythonServer
-
-importMsg = "**** PyCOMTest is not installed ***\n  PyCOMTest is a Python test specific COM client and server.\n  It is likely this server is not installed on this machine\n  To install the server, you must get the win32com sources\n  and build it using MS Visual C++"
-
-error = Exception
-
-# This test uses a Python implemented COM server - ensure correctly registered.
-RegisterPythonServer(
-    os.path.join(os.path.dirname(__file__), "..", "servers", "test_pycomtest.py"),
-    "Python.Test.PyCOMTest",
-)
-
-from win32com.client import gencache
-
-try:
-    gencache.EnsureModule("{6BCDCB60-5605-11D0-AE5F-CADD4C000000}", 0, 1, 1)
-except pythoncom.com_error:
-    print("The PyCOMTest module can not be located or generated.")
-    print(importMsg)
-    raise RuntimeError(importMsg)
-
-# We had a bg where RegisterInterfaces would fail if gencache had
-# already been run - exercise that here
-from win32com import universal
-
-universal.RegisterInterfaces("{6BCDCB60-5605-11D0-AE5F-CADD4C000000}", 0, 1, 1)
-
-verbose = 0
-
-
-def check_get_set(func, arg):
-    got = func(arg)
-    if got != arg:
-        raise error("%s failed - expected %r, got %r" % (func, arg, got))
-
-
-def check_get_set_raises(exc, func, arg):
-    try:
-        got = func(arg)
-    except exc as e:
-        pass  # what we expect!
-    else:
-        raise error(
-            "%s with arg %r didn't raise %s - returned %r" % (func, arg, exc, got)
-        )
-
-
-def progress(*args):
-    if verbose:
-        for arg in args:
-            print(arg, end=" ")
-        print()
-
-
-def TestApplyResult(fn, args, result):
-    try:
-        fnName = str(fn).split()[1]
-    except:
-        fnName = str(fn)
-    progress("Testing ", fnName)
-    pref = "function " + fnName
-    rc = fn(*args)
-    if rc != result:
-        raise error("%s failed - result not %r but %r" % (pref, result, rc))
-
-
-def TestConstant(constName, pyConst):
-    try:
-        comConst = getattr(constants, constName)
-    except:
-        raise error("Constant %s missing" % (constName,))
-    if comConst != pyConst:
-        raise error(
-            "Constant value wrong for %s - got %s, wanted %s"
-            % (constName, comConst, pyConst)
-        )
-
-
-# Simple handler class.  This demo only fires one event.
-class RandomEventHandler:
-    def _Init(self):
-        self.fireds = {}
-
-    def OnFire(self, no):
-        try:
-            self.fireds[no] = self.fireds[no] + 1
-        except KeyError:
-            self.fireds[no] = 0
-
-    def OnFireWithNamedParams(self, no, a_bool, out1, out2):
-        # This test exists mainly to help with an old bug, where named
-        # params would come in reverse.
-        Missing = pythoncom.Missing
-        if no is not Missing:
-            # We know our impl called 'OnFire' with the same ID
-            assert no in self.fireds
-            assert no + 1 == out1, "expecting 'out1' param to be ID+1"
-            assert no + 2 == out2, "expecting 'out2' param to be ID+2"
-        # The middle must be a boolean.
-        assert a_bool is Missing or type(a_bool) == bool, "middle param not a bool"
-        return out1 + 2, out2 + 2
-
-    def _DumpFireds(self):
-        if not self.fireds:
-            print("ERROR: Nothing was received!")
-        for firedId, no in self.fireds.items():
-            progress("ID %d fired %d times" % (firedId, no))
-
-
-# A simple handler class that derives from object (ie, a "new style class") -
-# only relevant for Python 2.x (ie, the 2 classes should be identical in 3.x)
-class NewStyleRandomEventHandler(object):
-    def _Init(self):
-        self.fireds = {}
-
-    def OnFire(self, no):
-        try:
-            self.fireds[no] = self.fireds[no] + 1
-        except KeyError:
-            self.fireds[no] = 0
-
-    def OnFireWithNamedParams(self, no, a_bool, out1, out2):
-        # This test exists mainly to help with an old bug, where named
-        # params would come in reverse.
-        Missing = pythoncom.Missing
-        if no is not Missing:
-            # We know our impl called 'OnFire' with the same ID
-            assert no in self.fireds
-            assert no + 1 == out1, "expecting 'out1' param to be ID+1"
-            assert no + 2 == out2, "expecting 'out2' param to be ID+2"
-        # The middle must be a boolean.
-        assert a_bool is Missing or type(a_bool) == bool, "middle param not a bool"
-        return out1 + 2, out2 + 2
-
-    def _DumpFireds(self):
-        if not self.fireds:
-            print("ERROR: Nothing was received!")
-        for firedId, no in self.fireds.items():
-            progress("ID %d fired %d times" % (firedId, no))
-
-
-# Test everything which can be tested using both the "dynamic" and "generated"
-# COM objects (or when there are very subtle differences)
-def TestCommon(o, is_generated):
-    progress("Getting counter")
-    counter = o.GetSimpleCounter()
-    TestCounter(counter, is_generated)
-
-    progress("Checking default args")
-    rc = o.TestOptionals()
-    if rc[:-1] != ("def", 0, 1) or abs(rc[-1] - 3.14) > 0.01:
-        print(rc)
-        raise error("Did not get the optional values correctly")
-    rc = o.TestOptionals("Hi", 2, 3, 1.1)
-    if rc[:-1] != ("Hi", 2, 3) or abs(rc[-1] - 1.1) > 0.01:
-        print(rc)
-        raise error("Did not get the specified optional values correctly")
-    rc = o.TestOptionals2(0)
-    if rc != (0, "", 1):
-        print(rc)
-        raise error("Did not get the optional2 values correctly")
-    rc = o.TestOptionals2(1.1, "Hi", 2)
-    if rc[1:] != ("Hi", 2) or abs(rc[0] - 1.1) > 0.01:
-        print(rc)
-        raise error("Did not get the specified optional2 values correctly")
-
-    progress("Checking getting/passing IUnknown")
-    check_get_set(o.GetSetUnknown, o)
-    progress("Checking getting/passing IDispatch")
-    # This might be called with either the interface or the CoClass - but these
-    # functions always return from the interface.
-    expected_class = o.__class__
-    # CoClass instances have `default_interface`
-    expected_class = getattr(expected_class, "default_interface", expected_class)
-    if not isinstance(o.GetSetDispatch(o), expected_class):
-        raise error("GetSetDispatch failed: %r" % (o.GetSetDispatch(o),))
-    progress("Checking getting/passing IDispatch of known type")
-    expected_class = o.__class__
-    expected_class = getattr(expected_class, "default_interface", expected_class)
-    if o.GetSetInterface(o).__class__ != expected_class:
-        raise error("GetSetDispatch failed")
-
-    progress("Checking misc args")
-    check_get_set(o.GetSetVariant, 4)
-    check_get_set(o.GetSetVariant, "foo")
-    check_get_set(o.GetSetVariant, o)
-
-    # signed/unsigned.
-    check_get_set(o.GetSetInt, 0)
-    check_get_set(o.GetSetInt, -1)
-    check_get_set(o.GetSetInt, 1)
-
-    check_get_set(o.GetSetUnsignedInt, 0)
-    check_get_set(o.GetSetUnsignedInt, 1)
-    check_get_set(o.GetSetUnsignedInt, 0x80000000)
-    if o.GetSetUnsignedInt(-1) != 0xFFFFFFFF:
-        # -1 is a special case - we accept a negative int (silently converting to
-        # unsigned) but when getting it back we convert it to a long.
-        raise error("unsigned -1 failed")
-
-    check_get_set(o.GetSetLong, 0)
-    check_get_set(o.GetSetLong, -1)
-    check_get_set(o.GetSetLong, 1)
-
-    check_get_set(o.GetSetUnsignedLong, 0)
-    check_get_set(o.GetSetUnsignedLong, 1)
-    check_get_set(o.GetSetUnsignedLong, 0x80000000)
-    # -1 is a special case - see above.
-    if o.GetSetUnsignedLong(-1) != 0xFFFFFFFF:
-        raise error("unsigned -1 failed")
-
-    # We want to explicitly test > 32 bits.  py3k has no 'maxint' and
-    # 'maxsize+1' is no good on 64bit platforms as its 65 bits!
-    big = 2147483647  # sys.maxint on py2k
-    for l in big, big + 1, 1 << 65:
-        check_get_set(o.GetSetVariant, l)
-
-    progress("Checking structs")
-    r = o.GetStruct()
-    assert r.int_value == 99 and str(r.str_value) == "Hello from C++"
-    assert o.DoubleString("foo") == "foofoo"
-
-    progress("Checking var args")
-    o.SetVarArgs("Hi", "There", "From", "Python", 1)
-    if o.GetLastVarArgs() != ("Hi", "There", "From", "Python", 1):
-        raise error("VarArgs failed -" + str(o.GetLastVarArgs()))
-
-    progress("Checking arrays")
-    l = []
-    TestApplyResult(o.SetVariantSafeArray, (l,), len(l))
-    l = [1, 2, 3, 4]
-    TestApplyResult(o.SetVariantSafeArray, (l,), len(l))
-    TestApplyResult(
-        o.CheckVariantSafeArray,
-        (
-            (
-                1,
-                2,
-                3,
-                4,
-            ),
-        ),
-        1,
-    )
-
-    # and binary
-    TestApplyResult(o.SetBinSafeArray, (str2memory("foo\0bar"),), 7)
-
-    progress("Checking properties")
-    o.LongProp = 3
-    if o.LongProp != 3 or o.IntProp != 3:
-        raise error("Property value wrong - got %d/%d" % (o.LongProp, o.IntProp))
-    o.LongProp = o.IntProp = -3
-    if o.LongProp != -3 or o.IntProp != -3:
-        raise error("Property value wrong - got %d/%d" % (o.LongProp, o.IntProp))
-    # This number fits in an unsigned long.  Attempting to set it to a normal
-    # long will involve overflow, which is to be expected. But we do
-    # expect it to work in a property explicitly a VT_UI4.
-    check = 3 * 10**9
-    o.ULongProp = check
-    if o.ULongProp != check:
-        raise error(
-            "Property value wrong - got %d (expected %d)" % (o.ULongProp, check)
-        )
-
-    TestApplyResult(o.Test, ("Unused", 99), 1)  # A bool function
-    TestApplyResult(o.Test, ("Unused", -1), 1)  # A bool function
-    TestApplyResult(o.Test, ("Unused", 1 == 1), 1)  # A bool function
-    TestApplyResult(o.Test, ("Unused", 0), 0)
-    TestApplyResult(o.Test, ("Unused", 1 == 0), 0)
-
-    assert o.DoubleString("foo") == "foofoo"
-
-    TestConstant("ULongTest1", 0xFFFFFFFF)
-    TestConstant("ULongTest2", 0x7FFFFFFF)
-    TestConstant("LongTest1", -0x7FFFFFFF)
-    TestConstant("LongTest2", 0x7FFFFFFF)
-    TestConstant("UCharTest", 255)
-    TestConstant("CharTest", -1)
-    # 'Hello World', but the 'r' is the "Registered" sign (\xae)
-    TestConstant("StringTest", "Hello Wo\xaeld")
-
-    progress("Checking dates and times")
-    # For now *all* times passed must be tz-aware.
-    now = win32timezone.now()
-    # but conversion to and from a VARIANT loses sub-second...
-    now = now.replace(microsecond=0)
-    later = now + datetime.timedelta(seconds=1)
-    TestApplyResult(o.EarliestDate, (now, later), now)
-
-    # The below used to fail with `ValueError: microsecond must be in 0..999999` - see #1655
-    # https://planetcalc.com/7027/ says that float is: Sun, 25 Mar 1951 7:23:49 am
-    assert o.MakeDate(18712.308206013888) == datetime.datetime.fromisoformat(
-        "1951-03-25 07:23:49+00:00"
-    )
-
-    progress("Checking currency")
-    # currency.
-    pythoncom.__future_currency__ = 1
-    if o.CurrencyProp != 0:
-        raise error("Expecting 0, got %r" % (o.CurrencyProp,))
-    for val in ("1234.5678", "1234.56", "1234"):
-        o.CurrencyProp = decimal.Decimal(val)
-        if o.CurrencyProp != decimal.Decimal(val):
-            raise error("%s got %r" % (val, o.CurrencyProp))
-    v1 = decimal.Decimal("1234.5678")
-    TestApplyResult(o.DoubleCurrency, (v1,), v1 * 2)
-
-    v2 = decimal.Decimal("9012.3456")
-    TestApplyResult(o.AddCurrencies, (v1, v2), v1 + v2)
-
-    TestTrickyTypesWithVariants(o, is_generated)
-    progress("Checking win32com.client.VARIANT")
-    TestPyVariant(o, is_generated)
-
-
-def TestTrickyTypesWithVariants(o, is_generated):
-    # Test tricky stuff with type handling and generally only works with
-    # "generated" support but can be worked around using VARIANT.
-    if is_generated:
-        got = o.TestByRefVariant(2)
-    else:
-        v = VARIANT(pythoncom.VT_BYREF | pythoncom.VT_VARIANT, 2)
-        o.TestByRefVariant(v)
-        got = v.value
-    if got != 4:
-        raise error("TestByRefVariant failed")
-
-    if is_generated:
-        got = o.TestByRefString("Foo")
-    else:
-        v = VARIANT(pythoncom.VT_BYREF | pythoncom.VT_BSTR, "Foo")
-        o.TestByRefString(v)
-        got = v.value
-    if got != "FooFoo":
-        raise error("TestByRefString failed")
-
-    # check we can pass ints as a VT_UI1
-    vals = [1, 2, 3, 4]
-    if is_generated:
-        arg = vals
-    else:
-        arg = VARIANT(pythoncom.VT_ARRAY | pythoncom.VT_UI1, vals)
-    TestApplyResult(o.SetBinSafeArray, (arg,), len(vals))
-
-    # safearrays of doubles and floats
-    vals = [0, 1.1, 2.2, 3.3]
-    if is_generated:
-        arg = vals
-    else:
-        arg = VARIANT(pythoncom.VT_ARRAY | pythoncom.VT_R8, vals)
-    TestApplyResult(o.SetDoubleSafeArray, (arg,), len(vals))
-
-    if is_generated:
-        arg = vals
-    else:
-        arg = VARIANT(pythoncom.VT_ARRAY | pythoncom.VT_R4, vals)
-    TestApplyResult(o.SetFloatSafeArray, (arg,), len(vals))
-
-    vals = [1.1, 2.2, 3.3, 4.4]
-    expected = (1.1 * 2, 2.2 * 2, 3.3 * 2, 4.4 * 2)
-    if is_generated:
-        TestApplyResult(o.ChangeDoubleSafeArray, (vals,), expected)
-    else:
-        arg = VARIANT(pythoncom.VT_BYREF | pythoncom.VT_ARRAY | pythoncom.VT_R8, vals)
-        o.ChangeDoubleSafeArray(arg)
-        if arg.value != expected:
-            raise error("ChangeDoubleSafeArray got the wrong value")
-
-    if is_generated:
-        got = o.DoubleInOutString("foo")
-    else:
-        v = VARIANT(pythoncom.VT_BYREF | pythoncom.VT_BSTR, "foo")
-        o.DoubleInOutString(v)
-        got = v.value
-    assert got == "foofoo", got
-
-    val = decimal.Decimal("1234.5678")
-    if is_generated:
-        got = o.DoubleCurrencyByVal(val)
-    else:
-        v = VARIANT(pythoncom.VT_BYREF | pythoncom.VT_CY, val)
-        o.DoubleCurrencyByVal(v)
-        got = v.value
-    assert got == val * 2
-
-
-def TestDynamic():
-    progress("Testing Dynamic")
-    import win32com.client.dynamic
-
-    o = win32com.client.dynamic.DumbDispatch("PyCOMTest.PyCOMTest")
-    TestCommon(o, False)
-
-    counter = win32com.client.dynamic.DumbDispatch("PyCOMTest.SimpleCounter")
-    TestCounter(counter, False)
-
-    # Dynamic doesn't know this should be an int, so we get a COM
-    # TypeMismatch error.
-    try:
-        check_get_set_raises(ValueError, o.GetSetInt, "foo")
-        raise error("no exception raised")
-    except pythoncom.com_error as exc:
-        if exc.hresult != winerror.DISP_E_TYPEMISMATCH:
-            raise
-
-    arg1 = VARIANT(pythoncom.VT_R4 | pythoncom.VT_BYREF, 2.0)
-    arg2 = VARIANT(pythoncom.VT_BOOL | pythoncom.VT_BYREF, True)
-    arg3 = VARIANT(pythoncom.VT_I4 | pythoncom.VT_BYREF, 4)
-    o.TestInOut(arg1, arg2, arg3)
-    assert arg1.value == 4.0, arg1
-    assert arg2.value == False
-    assert arg3.value == 8
-
-    # damn - props with params don't work for dynamic objects :(
-    # o.SetParamProp(0, 1)
-    # if o.ParamProp(0) != 1:
-    #    raise RuntimeError, o.paramProp(0)
-
-
-def TestGenerated():
-    # Create an instance of the server.
-    from win32com.client.gencache import EnsureDispatch
-
-    o = EnsureDispatch("PyCOMTest.PyCOMTest")
-    TestCommon(o, True)
-
-    counter = EnsureDispatch("PyCOMTest.SimpleCounter")
-    TestCounter(counter, True)
-
-    # This dance lets us get a CoClass even though it's not explicitly registered.
-    # This is `CoPyComTest`
-    from win32com.client.CLSIDToClass import GetClass
-
-    coclass_o = GetClass("{8EE0C520-5605-11D0-AE5F-CADD4C000000}")()
-    TestCommon(coclass_o, True)
-
-    # Test the regression reported in #1753
-    assert bool(coclass_o)
-
-    # This is `CoSimpleCounter` and the counter tests should work.
-    coclass = GetClass("{B88DD310-BAE8-11D0-AE86-76F2C1000000}")()
-    TestCounter(coclass, True)
-
-    # XXX - this is failing in dynamic tests, but should work fine.
-    i1, i2 = o.GetMultipleInterfaces()
-    if not isinstance(i1, DispatchBaseClass) or not isinstance(i2, DispatchBaseClass):
-        # Yay - is now an instance returned!
-        raise error(
-            "GetMultipleInterfaces did not return instances - got '%s', '%s'" % (i1, i2)
-        )
-    del i1
-    del i2
-
-    # Generated knows to only pass a 32bit int, so should fail.
-    check_get_set_raises(OverflowError, o.GetSetInt, 0x80000000)
-    check_get_set_raises(OverflowError, o.GetSetLong, 0x80000000)
-
-    # Generated knows this should be an int, so raises ValueError
-    check_get_set_raises(ValueError, o.GetSetInt, "foo")
-    check_get_set_raises(ValueError, o.GetSetLong, "foo")
-
-    # Pass some non-sequence objects to our array decoder, and watch it fail.
-    try:
-        o.SetVariantSafeArray("foo")
-        raise error("Expected a type error")
-    except TypeError:
-        pass
-    try:
-        o.SetVariantSafeArray(666)
-        raise error("Expected a type error")
-    except TypeError:
-        pass
-
-    o.GetSimpleSafeArray(None)
-    TestApplyResult(o.GetSimpleSafeArray, (None,), tuple(range(10)))
-    resultCheck = tuple(range(5)), tuple(range(10)), tuple(range(20))
-    TestApplyResult(o.GetSafeArrays, (None, None, None), resultCheck)
-
-    l = []
-    TestApplyResult(o.SetIntSafeArray, (l,), len(l))
-    l = [1, 2, 3, 4]
-    TestApplyResult(o.SetIntSafeArray, (l,), len(l))
-    ll = [1, 2, 3, 0x100000000]
-    TestApplyResult(o.SetLongLongSafeArray, (ll,), len(ll))
-    TestApplyResult(o.SetULongLongSafeArray, (ll,), len(ll))
-
-    # Tell the server to do what it does!
-    TestApplyResult(o.Test2, (constants.Attr2,), constants.Attr2)
-    TestApplyResult(o.Test3, (constants.Attr2,), constants.Attr2)
-    TestApplyResult(o.Test4, (constants.Attr2,), constants.Attr2)
-    TestApplyResult(o.Test5, (constants.Attr2,), constants.Attr2)
-
-    TestApplyResult(o.Test6, (constants.WideAttr1,), constants.WideAttr1)
-    TestApplyResult(o.Test6, (constants.WideAttr2,), constants.WideAttr2)
-    TestApplyResult(o.Test6, (constants.WideAttr3,), constants.WideAttr3)
-    TestApplyResult(o.Test6, (constants.WideAttr4,), constants.WideAttr4)
-    TestApplyResult(o.Test6, (constants.WideAttr5,), constants.WideAttr5)
-
-    TestApplyResult(o.TestInOut, (2.0, True, 4), (4.0, False, 8))
-
-    o.SetParamProp(0, 1)
-    if o.ParamProp(0) != 1:
-        raise RuntimeError(o.paramProp(0))
-
-    # Make sure CastTo works - even though it is only casting it to itself!
-    o2 = CastTo(o, "IPyCOMTest")
-    if o != o2:
-        raise error("CastTo should have returned the same object")
-
-    # Do the connection point thing...
-    # Create a connection object.
-    progress("Testing connection points")
-    o2 = win32com.client.DispatchWithEvents(o, RandomEventHandler)
-    TestEvents(o2, o2)
-    o2 = win32com.client.DispatchWithEvents(o, NewStyleRandomEventHandler)
-    TestEvents(o2, o2)
-    # and a plain "WithEvents".
-    handler = win32com.client.WithEvents(o, RandomEventHandler)
-    TestEvents(o, handler)
-    handler = win32com.client.WithEvents(o, NewStyleRandomEventHandler)
-    TestEvents(o, handler)
-    progress("Finished generated .py test.")
-
-
-def TestEvents(o, handler):
-    sessions = []
-    handler._Init()
-    try:
-        for i in range(3):
-            session = o.Start()
-            sessions.append(session)
-        time.sleep(0.5)
-    finally:
-        # Stop the servers
-        for session in sessions:
-            o.Stop(session)
-        handler._DumpFireds()
-        handler.close()
-
-
-def _TestPyVariant(o, is_generated, val, checker=None):
-    if is_generated:
-        vt, got = o.GetVariantAndType(val)
-    else:
-        # Gotta supply all 3 args with the last 2 being explicit variants to
-        # get the byref behaviour.
-        var_vt = VARIANT(pythoncom.VT_UI2 | pythoncom.VT_BYREF, 0)
-        var_result = VARIANT(pythoncom.VT_VARIANT | pythoncom.VT_BYREF, 0)
-        o.GetVariantAndType(val, var_vt, var_result)
-        vt = var_vt.value
-        got = var_result.value
-    if checker is not None:
-        checker(got)
-        return
-    # default checking.
-    assert vt == val.varianttype, (vt, val.varianttype)
-    # Handle our safe-array test - if the passed value is a list of variants,
-    # compare against the actual values.
-    if type(val.value) in (tuple, list):
-        check = [v.value if isinstance(v, VARIANT) else v for v in val.value]
-        # pythoncom always returns arrays as tuples.
-        got = list(got)
-    else:
-        check = val.value
-    assert type(check) == type(got), (type(check), type(got))
-    assert check == got, (check, got)
-
-
-def _TestPyVariantFails(o, is_generated, val, exc):
-    try:
-        _TestPyVariant(o, is_generated, val)
-        raise error("Setting %r didn't raise %s" % (val, exc))
-    except exc:
-        pass
-
-
-def TestPyVariant(o, is_generated):
-    _TestPyVariant(o, is_generated, VARIANT(pythoncom.VT_UI1, 1))
-    _TestPyVariant(
-        o, is_generated, VARIANT(pythoncom.VT_ARRAY | pythoncom.VT_UI4, [1, 2, 3])
-    )
-    _TestPyVariant(o, is_generated, VARIANT(pythoncom.VT_BSTR, "hello"))
-    _TestPyVariant(
-        o,
-        is_generated,
-        VARIANT(pythoncom.VT_ARRAY | pythoncom.VT_BSTR, ["hello", "there"]),
-    )
-
-    def check_dispatch(got):
-        assert isinstance(got._oleobj_, pythoncom.TypeIIDs[pythoncom.IID_IDispatch])
-
-    _TestPyVariant(o, is_generated, VARIANT(pythoncom.VT_DISPATCH, o), check_dispatch)
-    _TestPyVariant(
-        o, is_generated, VARIANT(pythoncom.VT_ARRAY | pythoncom.VT_DISPATCH, [o])
-    )
-    # an array of variants each with a specific type.
-    v = VARIANT(
-        pythoncom.VT_ARRAY | pythoncom.VT_VARIANT,
-        [
-            VARIANT(pythoncom.VT_UI4, 1),
-            VARIANT(pythoncom.VT_UI4, 2),
-            VARIANT(pythoncom.VT_UI4, 3),
-        ],
-    )
-    _TestPyVariant(o, is_generated, v)
-
-    # and failures
-    _TestPyVariantFails(o, is_generated, VARIANT(pythoncom.VT_UI1, "foo"), ValueError)
-
-
-def TestCounter(counter, bIsGenerated):
-    # Test random access into container
-    progress("Testing counter", repr(counter))
-    import random
-
-    for i in range(50):
-        num = int(random.random() * len(counter))
-        try:
-            # XXX - this appears broken by commit 08a14d4deb374eaa06378509cf44078ad467b9dc -
-            # We shouldn't need to do generated differently than dynamic.
-            if bIsGenerated:
-                ret = counter.Item(num + 1)
-            else:
-                ret = counter[num]
-            if ret != num + 1:
-                raise error(
-                    "Random access into element %d failed - return was %s"
-                    % (num, repr(ret))
-                )
-        except IndexError:
-            raise error("** IndexError accessing collection element %d" % num)
-
-    num = 0
-    if bIsGenerated:
-        counter.SetTestProperty(1)
-        counter.TestProperty = 1  # Note this has a second, default arg.
-        counter.SetTestProperty(1, 2)
-        if counter.TestPropertyWithDef != 0:
-            raise error("Unexpected property set value!")
-        if counter.TestPropertyNoDef(1) != 1:
-            raise error("Unexpected property set value!")
-    else:
-        pass
-        # counter.TestProperty = 1
-
-    counter.LBound = 1
-    counter.UBound = 10
-    if counter.LBound != 1 or counter.UBound != 10:
-        print("** Error - counter did not keep its properties")
-
-    if bIsGenerated:
-        bounds = counter.GetBounds()
-        if bounds[0] != 1 or bounds[1] != 10:
-            raise error("** Error - counter did not give the same properties back")
-        counter.SetBounds(bounds[0], bounds[1])
-
-    for item in counter:
-        num = num + 1
-    if num != len(counter):
-        raise error("*** Length of counter and loop iterations dont match ***")
-    if num != 10:
-        raise error("*** Unexpected number of loop iterations ***")
-
-    try:
-        counter = iter(counter)._iter_.Clone()  # Test Clone() and enum directly
-    except AttributeError:
-        # *sob* - sometimes this is a real iterator and sometimes not :/
-        progress("Finished testing counter (but skipped the iterator stuff")
-        return
-    counter.Reset()
-    num = 0
-    for item in counter:
-        num = num + 1
-    if num != 10:
-        raise error("*** Unexpected number of loop iterations - got %d ***" % num)
-    progress("Finished testing counter")
-
-
-def TestLocalVTable(ob):
-    # Python doesn't fully implement this interface.
-    if ob.DoubleString("foo") != "foofoo":
-        raise error("couldn't foofoo")
-
-
-###############################
-##
-## Some vtable tests of the interface
-##
-def TestVTable(clsctx=pythoncom.CLSCTX_ALL):
-    # Any vtable interfaces marked as dual *should* be able to be
-    # correctly implemented as IDispatch.
-    ob = win32com.client.Dispatch("Python.Test.PyCOMTest")
-    TestLocalVTable(ob)
-    # Now test it via vtable - use some C++ code to help here as Python can't do it directly yet.
-    tester = win32com.client.Dispatch("PyCOMTest.PyCOMTest")
-    testee = pythoncom.CoCreateInstance(
-        "Python.Test.PyCOMTest", None, clsctx, pythoncom.IID_IUnknown
-    )
-    # check we fail gracefully with None passed.
-    try:
-        tester.TestMyInterface(None)
-    except pythoncom.com_error as details:
-        pass
-    # and a real object.
-    tester.TestMyInterface(testee)
-
-
-def TestVTable2():
-    # We once crashed creating our object with the native interface as
-    # the first IID specified.  We must do it _after_ the tests, so that
-    # Python has already had the gateway registered from last run.
-    ob = win32com.client.Dispatch("Python.Test.PyCOMTest")
-    iid = pythoncom.InterfaceNames["IPyCOMTest"]
-    clsid = "Python.Test.PyCOMTest"
-    clsctx = pythoncom.CLSCTX_SERVER
-    try:
-        testee = pythoncom.CoCreateInstance(clsid, None, clsctx, iid)
-    except TypeError:
-        # Python can't actually _use_ this interface yet, so this is
-        # "expected".  Any COM error is not.
-        pass
-
-
-def TestVTableMI():
-    clsctx = pythoncom.CLSCTX_SERVER
-    ob = pythoncom.CoCreateInstance(
-        "Python.Test.PyCOMTestMI", None, clsctx, pythoncom.IID_IUnknown
-    )
-    # This inherits from IStream.
-    ob.QueryInterface(pythoncom.IID_IStream)
-    # This implements IStorage, specifying the IID as a string
-    ob.QueryInterface(pythoncom.IID_IStorage)
-    # IDispatch should always work
-    ob.QueryInterface(pythoncom.IID_IDispatch)
-
-    iid = pythoncom.InterfaceNames["IPyCOMTest"]
-    try:
-        ob.QueryInterface(iid)
-    except TypeError:
-        # Python can't actually _use_ this interface yet, so this is
-        # "expected".  Any COM error is not.
-        pass
-
-
-def TestQueryInterface(long_lived_server=0, iterations=5):
-    tester = win32com.client.Dispatch("PyCOMTest.PyCOMTest")
-    if long_lived_server:
-        # Create a local server
-        t0 = win32com.client.Dispatch(
-            "Python.Test.PyCOMTest", clsctx=pythoncom.CLSCTX_LOCAL_SERVER
-        )
-    # Request custom interfaces a number of times
-    prompt = [
-        "Testing QueryInterface without long-lived local-server #%d of %d...",
-        "Testing QueryInterface with long-lived local-server #%d of %d...",
-    ]
-
-    for i in range(iterations):
-        progress(prompt[long_lived_server != 0] % (i + 1, iterations))
-        tester.TestQueryInterface()
-
-
-class Tester(win32com.test.util.TestCase):
-    def testVTableInProc(self):
-        # We used to crash running this the second time - do it a few times
-        for i in range(3):
-            progress("Testing VTables in-process #%d..." % (i + 1))
-            TestVTable(pythoncom.CLSCTX_INPROC_SERVER)
-
-    def testVTableLocalServer(self):
-        for i in range(3):
-            progress("Testing VTables out-of-process #%d..." % (i + 1))
-            TestVTable(pythoncom.CLSCTX_LOCAL_SERVER)
-
-    def testVTable2(self):
-        for i in range(3):
-            TestVTable2()
-
-    def testVTableMI(self):
-        for i in range(3):
-            TestVTableMI()
-
-    def testMultiQueryInterface(self):
-        TestQueryInterface(0, 6)
-        # When we use the custom interface in the presence of a long-lived
-        # local server, i.e. a local server that is already running when
-        # we request an instance of our COM object, and remains afterwards,
-        # then after repeated requests to create an instance of our object
-        # the custom interface disappears -- i.e. QueryInterface fails with
-        # E_NOINTERFACE. Set the upper range of the following test to 2 to
-        # pass this test, i.e. TestQueryInterface(1,2)
-        TestQueryInterface(1, 6)
-
-    def testDynamic(self):
-        TestDynamic()
-
-    def testGenerated(self):
-        TestGenerated()
-
-
-if __name__ == "__main__":
-    # XXX - todo - Complete hack to crank threading support.
-    # Should NOT be necessary
-    def NullThreadFunc():
-        pass
-
-    import _thread
-
-    _thread.start_new(NullThreadFunc, ())
-
-    if "-v" in sys.argv:
-        verbose = 1
-
-    win32com.test.util.testmain()
diff --git a/lib/win32com/test/testPyScriptlet.js b/lib/win32com/test/testPyScriptlet.js
deleted file mode 100644
index fd9822b9..00000000
--- a/lib/win32com/test/testPyScriptlet.js
+++ /dev/null
@@ -1,33 +0,0 @@
-function print(msg)
-{
-  WScript.Echo(msg) ;
-}
-
-function check(condition, msg)
-{
-  if (!condition) {
-    print("***** testPyScriptlet.js failed *****");
-    print(msg);
-  }
-}
-
-var thisScriptEngine = ScriptEngine() ;
-
-var majorVersion = ScriptEngineMajorVersion() ;
-var minorVersion = ScriptEngineMinorVersion() ;
-var buildVersion = ScriptEngineBuildVersion() ;
-
-WScript.Echo(thisScriptEngine + " Version " + majorVersion + "." + minorVersion + " Build " + buildVersion) ;
-
-var scriptlet = new  ActiveXObject("TestPys.Scriptlet") ;
-
-check(scriptlet.PyProp1=="PyScript Property1", "PyProp1 wasn't correct initial value");
-scriptlet.PyProp1 = "New Value";
-check(scriptlet.PyProp1=="New Value", "PyProp1 wasn't correct new value");
-
-check(scriptlet.PyProp2=="PyScript Property2", "PyProp2 wasn't correct initial value");
-scriptlet.PyProp2 = "Another New Value";
-check(scriptlet.PyProp2=="Another New Value", "PyProp2 wasn't correct new value");
-
-check(scriptlet.PyMethod1()=="PyMethod1 called", "Method1 wrong value");
-check(scriptlet.PyMethod2()=="PyMethod2 called", "Method2 wrong value");
diff --git a/lib/win32com/test/testROT.py b/lib/win32com/test/testROT.py
deleted file mode 100644
index 5a4ccbcc..00000000
--- a/lib/win32com/test/testROT.py
+++ /dev/null
@@ -1,29 +0,0 @@
-import unittest
-
-import pythoncom
-import win32com.test.util
-import winerror
-
-
-class TestROT(win32com.test.util.TestCase):
-    def testit(self):
-        ctx = pythoncom.CreateBindCtx()
-        rot = pythoncom.GetRunningObjectTable()
-        num = 0
-        for mk in rot:
-            name = mk.GetDisplayName(ctx, None)
-            num += 1
-            # Monikers themselves can iterate their contents (sometimes :)
-            try:
-                for sub in mk:
-                    num += 1
-            except pythoncom.com_error as exc:
-                if exc.hresult != winerror.E_NOTIMPL:
-                    raise
-
-        # if num < 2:
-        #    print "Only", num, "objects in the ROT - this is unusual"
-
-
-if __name__ == "__main__":
-    unittest.main()
diff --git a/lib/win32com/test/testServers.py b/lib/win32com/test/testServers.py
deleted file mode 100644
index f25009bf..00000000
--- a/lib/win32com/test/testServers.py
+++ /dev/null
@@ -1,52 +0,0 @@
-import unittest
-
-import pythoncom
-import win32com.client.dynamic
-import win32com.test.util
-import winerror
-
-
-def TestConnections():
-    import win32com.demos.connect
-
-    win32com.demos.connect.test()
-
-
-class InterpCase(win32com.test.util.TestCase):
-    def setUp(self):
-        # Ensure the correct version registered.
-        from win32com.servers import interp
-        from win32com.test.util import RegisterPythonServer
-
-        RegisterPythonServer(interp.__file__, "Python.Interpreter")
-
-    def _testInterp(self, interp):
-        self.assertEqual(interp.Eval("1+1"), 2)
-        win32com.test.util.assertRaisesCOM_HRESULT(
-            self, winerror.DISP_E_TYPEMISMATCH, interp.Eval, 2
-        )
-
-    def testInproc(self):
-        interp = win32com.client.dynamic.Dispatch(
-            "Python.Interpreter", clsctx=pythoncom.CLSCTX_INPROC
-        )
-        self._testInterp(interp)
-
-    def testLocalServer(self):
-        interp = win32com.client.dynamic.Dispatch(
-            "Python.Interpreter", clsctx=pythoncom.CLSCTX_LOCAL_SERVER
-        )
-        self._testInterp(interp)
-
-    def testAny(self):
-        interp = win32com.client.dynamic.Dispatch("Python.Interpreter")
-        self._testInterp(interp)
-
-
-class ConnectionsTestCase(win32com.test.util.TestCase):
-    def testConnections(self):
-        TestConnections()
-
-
-if __name__ == "__main__":
-    unittest.main("testServers")
diff --git a/lib/win32com/test/testShell.py b/lib/win32com/test/testShell.py
deleted file mode 100644
index b312a9dc..00000000
--- a/lib/win32com/test/testShell.py
+++ /dev/null
@@ -1,281 +0,0 @@
-import datetime
-import os
-import struct
-import sys
-
-import win32timezone
-
-try:
-    sys_maxsize = sys.maxsize  # 2.6 and later - maxsize != maxint on 64bits
-except AttributeError:
-    sys_maxsize = sys.maxint
-
-import pythoncom
-import pywintypes
-import win32com.test.util
-import win32con
-from pywin32_testutil import str2bytes
-from win32com.shell import shell
-from win32com.shell.shellcon import *
-from win32com.storagecon import *
-
-
-class ShellTester(win32com.test.util.TestCase):
-    def testShellLink(self):
-        desktop = str(shell.SHGetSpecialFolderPath(0, CSIDL_DESKTOP))
-        num = 0
-        shellLink = pythoncom.CoCreateInstance(
-            shell.CLSID_ShellLink,
-            None,
-            pythoncom.CLSCTX_INPROC_SERVER,
-            shell.IID_IShellLink,
-        )
-        persistFile = shellLink.QueryInterface(pythoncom.IID_IPersistFile)
-        names = [os.path.join(desktop, n) for n in os.listdir(desktop)]
-        programs = str(shell.SHGetSpecialFolderPath(0, CSIDL_PROGRAMS))
-        names.extend([os.path.join(programs, n) for n in os.listdir(programs)])
-        for name in names:
-            try:
-                persistFile.Load(name, STGM_READ)
-            except pythoncom.com_error:
-                continue
-            # Resolve is slow - avoid it for our tests.
-            # shellLink.Resolve(0, shell.SLR_ANY_MATCH | shell.SLR_NO_UI)
-            fname, findData = shellLink.GetPath(0)
-            unc = shellLink.GetPath(shell.SLGP_UNCPRIORITY)[0]
-            num += 1
-        if num == 0:
-            # This isn't a fatal error, but is unlikely.
-            print(
-                "Could not find any links on your desktop or programs dir, which is unusual"
-            )
-
-    def testShellFolder(self):
-        sf = shell.SHGetDesktopFolder()
-        names_1 = []
-        for i in sf:  # Magically calls EnumObjects
-            name = sf.GetDisplayNameOf(i, SHGDN_NORMAL)
-            names_1.append(name)
-
-        # And get the enumerator manually
-        enum = sf.EnumObjects(
-            0, SHCONTF_FOLDERS | SHCONTF_NONFOLDERS | SHCONTF_INCLUDEHIDDEN
-        )
-        names_2 = []
-        for i in enum:
-            name = sf.GetDisplayNameOf(i, SHGDN_NORMAL)
-            names_2.append(name)
-        names_1.sort()
-        names_2.sort()
-        self.assertEqual(names_1, names_2)
-
-
-class PIDLTester(win32com.test.util.TestCase):
-    def _rtPIDL(self, pidl):
-        pidl_str = shell.PIDLAsString(pidl)
-        pidl_rt = shell.StringAsPIDL(pidl_str)
-        self.assertEqual(pidl_rt, pidl)
-        pidl_str_rt = shell.PIDLAsString(pidl_rt)
-        self.assertEqual(pidl_str_rt, pidl_str)
-
-    def _rtCIDA(self, parent, kids):
-        cida = parent, kids
-        cida_str = shell.CIDAAsString(cida)
-        cida_rt = shell.StringAsCIDA(cida_str)
-        self.assertEqual(cida, cida_rt)
-        cida_str_rt = shell.CIDAAsString(cida_rt)
-        self.assertEqual(cida_str_rt, cida_str)
-
-    def testPIDL(self):
-        # A PIDL of "\1" is:   cb    pidl   cb
-        expect = str2bytes("\03\00" "\1" "\0\0")
-        self.assertEqual(shell.PIDLAsString([str2bytes("\1")]), expect)
-        self._rtPIDL([str2bytes("\0")])
-        self._rtPIDL([str2bytes("\1"), str2bytes("\2"), str2bytes("\3")])
-        self._rtPIDL([str2bytes("\0") * 2048] * 2048)
-        # PIDL must be a list
-        self.assertRaises(TypeError, shell.PIDLAsString, "foo")
-
-    def testCIDA(self):
-        self._rtCIDA([str2bytes("\0")], [[str2bytes("\0")]])
-        self._rtCIDA([str2bytes("\1")], [[str2bytes("\2")]])
-        self._rtCIDA(
-            [str2bytes("\0")], [[str2bytes("\0")], [str2bytes("\1")], [str2bytes("\2")]]
-        )
-
-    def testBadShortPIDL(self):
-        # A too-short child element:   cb    pidl   cb
-        pidl = str2bytes("\01\00" "\1")
-        self.assertRaises(ValueError, shell.StringAsPIDL, pidl)
-
-        # ack - tried to test too long PIDLs, but a len of 0xFFFF may not
-        # always fail.
-
-
-class FILEGROUPDESCRIPTORTester(win32com.test.util.TestCase):
-    def _getTestTimes(self):
-        if issubclass(pywintypes.TimeType, datetime.datetime):
-            ctime = win32timezone.now()
-            # FILETIME only has ms precision...
-            ctime = ctime.replace(microsecond=ctime.microsecond // 1000 * 1000)
-            atime = ctime + datetime.timedelta(seconds=1)
-            wtime = atime + datetime.timedelta(seconds=1)
-        else:
-            ctime = pywintypes.Time(11)
-            atime = pywintypes.Time(12)
-            wtime = pywintypes.Time(13)
-        return ctime, atime, wtime
-
-    def _testRT(self, fd):
-        fgd_string = shell.FILEGROUPDESCRIPTORAsString([fd])
-        fd2 = shell.StringAsFILEGROUPDESCRIPTOR(fgd_string)[0]
-
-        fd = fd.copy()
-        fd2 = fd2.copy()
-
-        # The returned objects *always* have dwFlags and cFileName.
-        if "dwFlags" not in fd:
-            del fd2["dwFlags"]
-        if "cFileName" not in fd:
-            self.assertEqual(fd2["cFileName"], "")
-            del fd2["cFileName"]
-
-        self.assertEqual(fd, fd2)
-
-    def _testSimple(self, make_unicode):
-        fgd = shell.FILEGROUPDESCRIPTORAsString([], make_unicode)
-        header = struct.pack("i", 0)
-        self.assertEqual(header, fgd[: len(header)])
-        self._testRT(dict())
-        d = dict()
-        fgd = shell.FILEGROUPDESCRIPTORAsString([d], make_unicode)
-        header = struct.pack("i", 1)
-        self.assertEqual(header, fgd[: len(header)])
-        self._testRT(d)
-
-    def testSimpleBytes(self):
-        self._testSimple(False)
-
-    def testSimpleUnicode(self):
-        self._testSimple(True)
-
-    def testComplex(self):
-        clsid = pythoncom.MakeIID("{CD637886-DB8B-4b04-98B5-25731E1495BE}")
-        ctime, atime, wtime = self._getTestTimes()
-        d = dict(
-            cFileName="foo.txt",
-            clsid=clsid,
-            sizel=(1, 2),
-            pointl=(3, 4),
-            dwFileAttributes=win32con.FILE_ATTRIBUTE_NORMAL,
-            ftCreationTime=ctime,
-            ftLastAccessTime=atime,
-            ftLastWriteTime=wtime,
-            nFileSize=sys_maxsize + 1,
-        )
-        self._testRT(d)
-
-    def testUnicode(self):
-        # exercise a bug fixed in build 210 - multiple unicode objects failed.
-        ctime, atime, wtime = self._getTestTimes()
-        d = [
-            dict(
-                cFileName="foo.txt",
-                sizel=(1, 2),
-                pointl=(3, 4),
-                dwFileAttributes=win32con.FILE_ATTRIBUTE_NORMAL,
-                ftCreationTime=ctime,
-                ftLastAccessTime=atime,
-                ftLastWriteTime=wtime,
-                nFileSize=sys_maxsize + 1,
-            ),
-            dict(
-                cFileName="foo2.txt",
-                sizel=(1, 2),
-                pointl=(3, 4),
-                dwFileAttributes=win32con.FILE_ATTRIBUTE_NORMAL,
-                ftCreationTime=ctime,
-                ftLastAccessTime=atime,
-                ftLastWriteTime=wtime,
-                nFileSize=sys_maxsize + 1,
-            ),
-            dict(
-                cFileName="foo\xa9.txt",
-                sizel=(1, 2),
-                pointl=(3, 4),
-                dwFileAttributes=win32con.FILE_ATTRIBUTE_NORMAL,
-                ftCreationTime=ctime,
-                ftLastAccessTime=atime,
-                ftLastWriteTime=wtime,
-                nFileSize=sys_maxsize + 1,
-            ),
-        ]
-        s = shell.FILEGROUPDESCRIPTORAsString(d, 1)
-        d2 = shell.StringAsFILEGROUPDESCRIPTOR(s)
-        # clobber 'dwFlags' - they are not expected to be identical
-        for t in d2:
-            del t["dwFlags"]
-        self.assertEqual(d, d2)
-
-
-class FileOperationTester(win32com.test.util.TestCase):
-    def setUp(self):
-        import tempfile
-
-        self.src_name = os.path.join(tempfile.gettempdir(), "pywin32_testshell")
-        self.dest_name = os.path.join(tempfile.gettempdir(), "pywin32_testshell_dest")
-        self.test_data = str2bytes("Hello from\0Python")
-        f = open(self.src_name, "wb")
-        f.write(self.test_data)
-        f.close()
-        try:
-            os.unlink(self.dest_name)
-        except os.error:
-            pass
-
-    def tearDown(self):
-        for fname in (self.src_name, self.dest_name):
-            if os.path.isfile(fname):
-                os.unlink(fname)
-
-    def testCopy(self):
-        s = (0, FO_COPY, self.src_name, self.dest_name)  # hwnd,  # operation
-
-        rc, aborted = shell.SHFileOperation(s)
-        self.assertTrue(not aborted)
-        self.assertEqual(0, rc)
-        self.assertTrue(os.path.isfile(self.src_name))
-        self.assertTrue(os.path.isfile(self.dest_name))
-
-    def testRename(self):
-        s = (0, FO_RENAME, self.src_name, self.dest_name)  # hwnd,  # operation
-        rc, aborted = shell.SHFileOperation(s)
-        self.assertTrue(not aborted)
-        self.assertEqual(0, rc)
-        self.assertTrue(os.path.isfile(self.dest_name))
-        self.assertTrue(not os.path.isfile(self.src_name))
-
-    def testMove(self):
-        s = (0, FO_MOVE, self.src_name, self.dest_name)  # hwnd,  # operation
-        rc, aborted = shell.SHFileOperation(s)
-        self.assertTrue(not aborted)
-        self.assertEqual(0, rc)
-        self.assertTrue(os.path.isfile(self.dest_name))
-        self.assertTrue(not os.path.isfile(self.src_name))
-
-    def testDelete(self):
-        s = (
-            0,  # hwnd,
-            FO_DELETE,  # operation
-            self.src_name,
-            None,
-            FOF_NOCONFIRMATION,
-        )
-        rc, aborted = shell.SHFileOperation(s)
-        self.assertTrue(not aborted)
-        self.assertEqual(0, rc)
-        self.assertTrue(not os.path.isfile(self.src_name))
-
-
-if __name__ == "__main__":
-    win32com.test.util.testmain()
diff --git a/lib/win32com/test/testStorage.py b/lib/win32com/test/testStorage.py
deleted file mode 100644
index 5b7e25de..00000000
--- a/lib/win32com/test/testStorage.py
+++ /dev/null
@@ -1,88 +0,0 @@
-import unittest
-
-import pythoncom
-import win32api
-import win32com.test.util
-from win32com import storagecon
-
-
-class TestEnum(win32com.test.util.TestCase):
-    def testit(self):
-        fname, tmp = win32api.GetTempFileName(win32api.GetTempPath(), "stg")
-        m = storagecon.STGM_READWRITE | storagecon.STGM_SHARE_EXCLUSIVE
-        ##  file, mode, format, attrs (always 0), IID (IStorage or IPropertySetStorage, storage options(only used with STGFMT_DOCFILE)
-        pss = pythoncom.StgOpenStorageEx(
-            fname, m, storagecon.STGFMT_FILE, 0, pythoncom.IID_IPropertySetStorage
-        )
-        ###                               {"Version":2,"reserved":0,"SectorSize":512,"TemplateFile":u'somefilename'})
-
-        ## FMTID_SummaryInformation FMTID_DocSummaryInformation FMTID_UserDefinedProperties
-        psuser = pss.Create(
-            pythoncom.FMTID_UserDefinedProperties,
-            pythoncom.IID_IPropertySetStorage,
-            storagecon.PROPSETFLAG_DEFAULT,
-            storagecon.STGM_READWRITE
-            | storagecon.STGM_CREATE
-            | storagecon.STGM_SHARE_EXCLUSIVE,
-        )  ## its very picky about flag combinations!
-        psuser.WriteMultiple((3, 4), ("hey", "bubba"))
-        psuser.WritePropertyNames((3, 4), ("property3", "property4"))
-        expected_summaries = []
-        expected_summaries.append(("property3", 3, pythoncom.VT_BSTR))
-        expected_summaries.append(("property4", 4, pythoncom.VT_BSTR))
-        psuser = None
-
-        pssum = pss.Create(
-            pythoncom.FMTID_SummaryInformation,
-            pythoncom.IID_IPropertySetStorage,
-            storagecon.PROPSETFLAG_DEFAULT,
-            storagecon.STGM_READWRITE
-            | storagecon.STGM_CREATE
-            | storagecon.STGM_SHARE_EXCLUSIVE,
-        )
-        pssum.WriteMultiple(
-            (storagecon.PIDSI_AUTHOR, storagecon.PIDSI_COMMENTS), ("me", "comment")
-        )
-
-        pssum = None
-        pss = None  ## doesn't seem to be a close or release method, and you can't even reopen it from the same process until previous object is gone
-
-        pssread = pythoncom.StgOpenStorageEx(
-            fname,
-            storagecon.STGM_READ | storagecon.STGM_SHARE_EXCLUSIVE,
-            storagecon.STGFMT_FILE,
-            0,
-            pythoncom.IID_IPropertySetStorage,
-        )
-        found_summaries = []
-        for psstat in pssread:
-            ps = pssread.Open(
-                psstat[0], storagecon.STGM_READ | storagecon.STGM_SHARE_EXCLUSIVE
-            )
-            for p in ps:
-                p_val = ps.ReadMultiple((p[1],))[0]
-                if (p[1] == storagecon.PIDSI_AUTHOR and p_val == "me") or (
-                    p[1] == storagecon.PIDSI_COMMENTS and p_val == "comment"
-                ):
-                    pass
-                else:
-                    self.fail("Uxexpected property %s/%s" % (p, p_val))
-            ps = None
-            ## FMTID_UserDefinedProperties can't exist without FMTID_DocSummaryInformation, and isn't returned independently from Enum
-            ## also can't be open at same time
-            if psstat[0] == pythoncom.FMTID_DocSummaryInformation:
-                ps = pssread.Open(
-                    pythoncom.FMTID_UserDefinedProperties,
-                    storagecon.STGM_READ | storagecon.STGM_SHARE_EXCLUSIVE,
-                )
-                for p in ps:
-                    found_summaries.append(p)
-                ps = None
-        psread = None
-        expected_summaries.sort()
-        found_summaries.sort()
-        self.assertEqual(expected_summaries, found_summaries)
-
-
-if __name__ == "__main__":
-    unittest.main()
diff --git a/lib/win32com/test/testStreams.py b/lib/win32com/test/testStreams.py
deleted file mode 100644
index 3beb47c7..00000000
--- a/lib/win32com/test/testStreams.py
+++ /dev/null
@@ -1,148 +0,0 @@
-import unittest
-
-import pythoncom
-import win32com.server.util
-import win32com.test.util
-from pywin32_testutil import str2bytes
-
-
-class Persists:
-    _public_methods_ = [
-        "GetClassID",
-        "IsDirty",
-        "Load",
-        "Save",
-        "GetSizeMax",
-        "InitNew",
-    ]
-    _com_interfaces_ = [pythoncom.IID_IPersistStreamInit]
-
-    def __init__(self):
-        self.data = str2bytes("abcdefg")
-        self.dirty = 1
-
-    def GetClassID(self):
-        return pythoncom.IID_NULL
-
-    def IsDirty(self):
-        return self.dirty
-
-    def Load(self, stream):
-        self.data = stream.Read(26)
-
-    def Save(self, stream, clearDirty):
-        stream.Write(self.data)
-        if clearDirty:
-            self.dirty = 0
-
-    def GetSizeMax(self):
-        return 1024
-
-    def InitNew(self):
-        pass
-
-
-class Stream:
-    _public_methods_ = ["Read", "Write", "Seek"]
-    _com_interfaces_ = [pythoncom.IID_IStream]
-
-    def __init__(self, data):
-        self.data = data
-        self.index = 0
-
-    def Read(self, amount):
-        result = self.data[self.index : self.index + amount]
-        self.index = self.index + amount
-        return result
-
-    def Write(self, data):
-        self.data = data
-        self.index = 0
-        return len(data)
-
-    def Seek(self, dist, origin):
-        if origin == pythoncom.STREAM_SEEK_SET:
-            self.index = dist
-        elif origin == pythoncom.STREAM_SEEK_CUR:
-            self.index = self.index + dist
-        elif origin == pythoncom.STREAM_SEEK_END:
-            self.index = len(self.data) + dist
-        else:
-            raise ValueError("Unknown Seek type: " + str(origin))
-        if self.index < 0:
-            self.index = 0
-        else:
-            self.index = min(self.index, len(self.data))
-        return self.index
-
-
-class BadStream(Stream):
-    """PyGStream::Read could formerly overflow buffer if the python implementation
-    returned more data than requested.
-    """
-
-    def Read(self, amount):
-        return str2bytes("x") * (amount + 1)
-
-
-class StreamTest(win32com.test.util.TestCase):
-    def _readWrite(self, data, write_stream, read_stream=None):
-        if read_stream is None:
-            read_stream = write_stream
-        write_stream.Write(data)
-        read_stream.Seek(0, pythoncom.STREAM_SEEK_SET)
-        got = read_stream.Read(len(data))
-        self.assertEqual(data, got)
-        read_stream.Seek(1, pythoncom.STREAM_SEEK_SET)
-        got = read_stream.Read(len(data) - 2)
-        self.assertEqual(data[1:-1], got)
-
-    def testit(self):
-        mydata = str2bytes("abcdefghijklmnopqrstuvwxyz")
-
-        # First test the objects just as Python objects...
-        s = Stream(mydata)
-        p = Persists()
-
-        p.Load(s)
-        p.Save(s, 0)
-        self.assertEqual(s.data, mydata)
-
-        # Wrap the Python objects as COM objects, and make the calls as if
-        # they were non-Python COM objects.
-        s2 = win32com.server.util.wrap(s, pythoncom.IID_IStream)
-        p2 = win32com.server.util.wrap(p, pythoncom.IID_IPersistStreamInit)
-
-        self._readWrite(mydata, s, s)
-        self._readWrite(mydata, s, s2)
-        self._readWrite(mydata, s2, s)
-        self._readWrite(mydata, s2, s2)
-
-        self._readWrite(str2bytes("string with\0a NULL"), s2, s2)
-        # reset the stream
-        s.Write(mydata)
-        p2.Load(s2)
-        p2.Save(s2, 0)
-        self.assertEqual(s.data, mydata)
-
-    def testseek(self):
-        s = Stream(str2bytes("yo"))
-        s = win32com.server.util.wrap(s, pythoncom.IID_IStream)
-        # we used to die in py3k passing a value > 32bits
-        s.Seek(0x100000000, pythoncom.STREAM_SEEK_SET)
-
-    def testerrors(self):
-        # setup a test logger to capture tracebacks etc.
-        records, old_log = win32com.test.util.setup_test_logger()
-        ## check for buffer overflow in Read method
-        badstream = BadStream("Check for buffer overflow")
-        badstream2 = win32com.server.util.wrap(badstream, pythoncom.IID_IStream)
-        self.assertRaises(pythoncom.com_error, badstream2.Read, 10)
-        win32com.test.util.restore_test_logger(old_log)
-        # there's 1 error here
-        self.assertEqual(len(records), 1)
-        self.assertTrue(records[0].msg.startswith("pythoncom error"))
-
-
-if __name__ == "__main__":
-    unittest.main()
diff --git a/lib/win32com/test/testWMI.py b/lib/win32com/test/testWMI.py
deleted file mode 100644
index 5829b48e..00000000
--- a/lib/win32com/test/testWMI.py
+++ /dev/null
@@ -1,18 +0,0 @@
-import unittest
-
-import win32com.test.util
-from win32com.client import GetObject
-
-
-class Simple(win32com.test.util.TestCase):
-    def testit(self):
-        cses = GetObject("WinMgMts:").InstancesOf("Win32_Process")
-        vals = []
-        for cs in cses:
-            val = cs.Properties_("Caption").Value
-            vals.append(val)
-        self.assertFalse(len(vals) < 5, "We only found %d processes!" % len(vals))
-
-
-if __name__ == "__main__":
-    unittest.main()
diff --git a/lib/win32com/test/testall.py b/lib/win32com/test/testall.py
deleted file mode 100644
index 6da07407..00000000
--- a/lib/win32com/test/testall.py
+++ /dev/null
@@ -1,321 +0,0 @@
-import getopt
-import os
-import re
-import sys
-import traceback
-import unittest
-
-try:
-    this_file = __file__
-except NameError:
-    this_file = sys.argv[0]
-
-win32com_src_dir = os.path.abspath(os.path.join(this_file, "../.."))
-
-import win32com
-
-# We'd prefer the win32com namespace to be the parent of __file__ - ie, our source-tree,
-# rather than the version installed - otherwise every .py change needs a full install to
-# test!
-# We can't patch win32comext as most of them have a .pyd in their root :(
-# This clearly ins't ideal or perfect :)
-win32com.__path__[0] = win32com_src_dir
-
-import pythoncom
-import win32com.client
-from win32com.test.util import (
-    CapturingFunctionTestCase,
-    CheckClean,
-    RegisterPythonServer,
-    ShellTestCase,
-    TestCase,
-    TestLoader,
-    TestRunner,
-)
-
-verbosity = 1  # default unittest verbosity.
-
-
-def GenerateAndRunOldStyle():
-    from . import GenTestScripts
-
-    GenTestScripts.GenerateAll()
-    try:
-        pass  #
-    finally:
-        GenTestScripts.CleanAll()
-
-
-def CleanGenerated():
-    import shutil
-
-    import win32com
-
-    if os.path.isdir(win32com.__gen_path__):
-        if verbosity > 1:
-            print("Deleting files from %s" % (win32com.__gen_path__))
-        shutil.rmtree(win32com.__gen_path__)
-    import win32com.client.gencache
-
-    win32com.client.gencache.__init__()  # Reset
-
-
-def RemoveRefCountOutput(data):
-    while 1:
-        last_line_pos = data.rfind("\n")
-        if not re.match("\[\d+ refs\]", data[last_line_pos + 1 :]):
-            break
-        if last_line_pos < 0:
-            # All the output
-            return ""
-        data = data[:last_line_pos]
-
-    return data
-
-
-def ExecuteSilentlyIfOK(cmd, testcase):
-    f = os.popen(cmd)
-    data = f.read().strip()
-    rc = f.close()
-    if rc:
-        print(data)
-        testcase.fail("Executing '%s' failed (%d)" % (cmd, rc))
-    # for "_d" builds, strip the '[xxx refs]' line
-    return RemoveRefCountOutput(data)
-
-
-class PyCOMTest(TestCase):
-    no_leak_tests = True  # done by the test itself
-
-    def testit(self):
-        # Check that the item is registered, so we get the correct
-        # 'skipped' behaviour (and recorded as such) rather than either
-        # error or silence due to non-registration.
-        RegisterPythonServer(
-            os.path.join(
-                os.path.dirname(__file__), "..", "servers", "test_pycomtest.py"
-            ),
-            "Python.Test.PyCOMTest",
-        )
-
-        # Execute testPyComTest in its own process so it can play
-        # with the Python thread state
-        fname = os.path.join(os.path.dirname(this_file), "testPyComTest.py")
-        cmd = '%s "%s" -q 2>&1' % (sys.executable, fname)
-        data = ExecuteSilentlyIfOK(cmd, self)
-
-
-class PippoTest(TestCase):
-    def testit(self):
-        # Check we are registered before spawning the process.
-        from win32com.test import pippo_server
-
-        RegisterPythonServer(pippo_server.__file__, "Python.Test.Pippo")
-
-        python = sys.executable
-        fname = os.path.join(os.path.dirname(this_file), "testPippo.py")
-        cmd = '%s "%s" 2>&1' % (python, fname)
-        ExecuteSilentlyIfOK(cmd, self)
-
-
-# This is a list of "win32com.test.???" module names, optionally with a
-# function in that module if the module isn't unitest based...
-unittest_modules = [
-    # Level 1 tests - fast and few dependencies - good for CI!
-    """testIterators testvbscript_regexp testStorage
-          testStreams testWMI policySemantics testShell testROT
-          testxslt testCollections
-          errorSemantics.test testArrays
-          testClipboard
-          testConversionErrors
-        """.split(),
-    # Level 2 tests - wants our demo COM objects registered.
-    # (these are strange; on github CI they get further than expected when
-    # our objects are not installed, so fail to quietly fail with "can't
-    # register" like they do locally. So really just a nod to CI)
-    """
-        testAXScript testDictionary testServers testvb testMarshal
-        """.split(),
-    # Level 3 tests - Requires Office or other non-free stuff.
-    """testMSOffice.TestAll testMSOfficeEvents.test testAccess.test
-           testExplorer.TestAll testExchange.test
-        """.split(),
-    # Level 4 tests - we try and run `makepy` over every typelib installed!
-    """testmakepy.TestAll
-        """.split(),
-]
-
-# A list of other unittest modules we use - these are fully qualified module
-# names and the module is assumed to be unittest based.
-unittest_other_modules = [
-    # Level 1 tests.
-    """win32com.directsound.test.ds_test
-        """.split(),
-    # Level 2 tests.
-    [],
-    # Level 3 tests.
-    [],
-    # Level 4 tests.
-    [],
-]
-
-
-output_checked_programs = [
-    # Level 1 tests.
-    [],
-    # Level 2 tests.
-    [
-        ("cscript.exe /nologo //E:vbscript testInterp.vbs", "VBScript test worked OK"),
-        (
-            "cscript.exe /nologo //E:vbscript testDictionary.vbs",
-            "VBScript has successfully tested Python.Dictionary",
-        ),
-    ],
-    # Level 3 tests
-    [],
-    # Level 4 tests.
-    [],
-]
-
-custom_test_cases = [
-    # Level 1 tests.
-    [],
-    # Level 2 tests.
-    [
-        PyCOMTest,
-        PippoTest,
-    ],
-    # Level 3 tests
-    [],
-    # Level 4 tests.
-    [],
-]
-
-
-def get_test_mod_and_func(test_name, import_failures):
-    if test_name.find(".") > 0:
-        mod_name, func_name = test_name.split(".")
-    else:
-        mod_name = test_name
-        func_name = None
-    fq_mod_name = "win32com.test." + mod_name
-    try:
-        __import__(fq_mod_name)
-        mod = sys.modules[fq_mod_name]
-    except:
-        import_failures.append((mod_name, sys.exc_info()[:2]))
-        return None, None
-    func = None if func_name is None else getattr(mod, func_name)
-    return mod, func
-
-
-# Return a test suite all loaded with the tests we want to run
-def make_test_suite(test_level=1):
-    suite = unittest.TestSuite()
-    import_failures = []
-    loader = TestLoader()
-    for i in range(testLevel):
-        for mod_name in unittest_modules[i]:
-            mod, func = get_test_mod_and_func(mod_name, import_failures)
-            if mod is None:
-                raise Exception("no such module '{}'".format(mod_name))
-            if func is not None:
-                test = CapturingFunctionTestCase(func, description=mod_name)
-            else:
-                if hasattr(mod, "suite"):
-                    test = mod.suite()
-                else:
-                    test = loader.loadTestsFromModule(mod)
-            assert test.countTestCases() > 0, "No tests loaded from %r" % mod
-            suite.addTest(test)
-        for cmd, output in output_checked_programs[i]:
-            suite.addTest(ShellTestCase(cmd, output))
-
-        for test_class in custom_test_cases[i]:
-            suite.addTest(unittest.defaultTestLoader.loadTestsFromTestCase(test_class))
-    # other "normal" unittest modules.
-    for i in range(testLevel):
-        for mod_name in unittest_other_modules[i]:
-            try:
-                __import__(mod_name)
-            except:
-                import_failures.append((mod_name, sys.exc_info()[:2]))
-                continue
-
-            mod = sys.modules[mod_name]
-            if hasattr(mod, "suite"):
-                test = mod.suite()
-            else:
-                test = loader.loadTestsFromModule(mod)
-            assert test.countTestCases() > 0, "No tests loaded from %r" % mod
-            suite.addTest(test)
-
-    return suite, import_failures
-
-
-def usage(why):
-    print(why)
-    print()
-    print("win32com test suite")
-    print("usage: testall [-v] test_level")
-    print("  where test_level is an integer 1-3.  Level 1 tests are quick,")
-    print("  level 2 tests invoke Word, IE etc, level 3 take ages!")
-    sys.exit(1)
-
-
-if __name__ == "__main__":
-    try:
-        opts, args = getopt.getopt(sys.argv[1:], "v")
-    except getopt.error as why:
-        usage(why)
-    for opt, val in opts:
-        if opt == "-v":
-            verbosity += 1
-    testLevel = 2  # default to quick test with local objects
-    test_names = []
-    for arg in args:
-        try:
-            testLevel = int(arg)
-            if testLevel < 0 or testLevel > 4:
-                raise ValueError("Only levels 1-4 are supported")
-        except ValueError:
-            test_names.append(arg)
-    if test_names:
-        usage("Test names are not supported yet")
-    CleanGenerated()
-
-    suite, import_failures = make_test_suite(testLevel)
-    if verbosity:
-        if hasattr(sys, "gettotalrefcount"):
-            print("This is a debug build - memory leak tests will also be run.")
-            print("These tests may take *many* minutes to run - be patient!")
-            print("(running from python.exe will avoid these leak tests)")
-        print(
-            "Executing level %d tests - %d test cases will be run"
-            % (testLevel, suite.countTestCases())
-        )
-        if verbosity == 1 and suite.countTestCases() < 70:
-            # A little row of markers so the dots show how close to finished
-            print("|" * suite.countTestCases())
-    testRunner = TestRunner(verbosity=verbosity)
-    testResult = testRunner.run(suite)
-    if import_failures:
-        testResult.stream.writeln(
-            "*** The following test modules could not be imported ***"
-        )
-        for mod_name, (exc_type, exc_val) in import_failures:
-            desc = "\n".join(traceback.format_exception_only(exc_type, exc_val))
-            testResult.stream.write("%s: %s" % (mod_name, desc))
-        testResult.stream.writeln(
-            "*** %d test(s) could not be run ***" % len(import_failures)
-        )
-
-    # re-print unit-test error here so it is noticed
-    if not testResult.wasSuccessful():
-        print("*" * 20, "- unittest tests FAILED")
-
-    CheckClean()
-    pythoncom.CoUninitialize()
-    CleanGenerated()
-    if not testResult.wasSuccessful():
-        sys.exit(1)
diff --git a/lib/win32com/test/testmakepy.py b/lib/win32com/test/testmakepy.py
deleted file mode 100644
index 2eeb8818..00000000
--- a/lib/win32com/test/testmakepy.py
+++ /dev/null
@@ -1,55 +0,0 @@
-# Test makepy - try and run it over every OCX in the windows system directory.
-
-import sys
-import traceback
-
-import pythoncom
-import win32api
-import win32com.test.util
-import winerror
-from win32com.client import gencache, makepy, selecttlb
-
-
-def TestBuildAll(verbose=1):
-    num = 0
-    tlbInfos = selecttlb.EnumTlbs()
-    for info in tlbInfos:
-        if verbose:
-            print("%s (%s)" % (info.desc, info.dll))
-        try:
-            makepy.GenerateFromTypeLibSpec(info)
-            #          sys.stderr.write("Attr typeflags for coclass referenced object %s=%d (%d), typekind=%d\n" % (name, refAttr.wTypeFlags, refAttr.wTypeFlags & pythoncom.TYPEFLAG_FDUAL,refAttr.typekind))
-            num += 1
-        except pythoncom.com_error as details:
-            # Ignore these 2 errors, as the are very common and can obscure
-            # useful warnings.
-            if details.hresult not in [
-                winerror.TYPE_E_CANTLOADLIBRARY,
-                winerror.TYPE_E_LIBNOTREGISTERED,
-            ]:
-                print("** COM error on", info.desc)
-                print(details)
-        except KeyboardInterrupt:
-            print("Interrupted!")
-            raise KeyboardInterrupt
-        except:
-            print("Failed:", info.desc)
-            traceback.print_exc()
-        if makepy.bForDemandDefault:
-            # This only builds enums etc by default - build each
-            # interface manually
-            tinfo = (info.clsid, info.lcid, info.major, info.minor)
-            mod = gencache.EnsureModule(info.clsid, info.lcid, info.major, info.minor)
-            for name in mod.NamesToIIDMap.keys():
-                makepy.GenerateChildFromTypeLibSpec(name, tinfo)
-    return num
-
-
-def TestAll(verbose=0):
-    num = TestBuildAll(verbose)
-    print("Generated and imported", num, "modules")
-    win32com.test.util.CheckClean()
-
-
-if __name__ == "__main__":
-    TestAll("-q" not in sys.argv)
diff --git a/lib/win32com/test/testvb.py b/lib/win32com/test/testvb.py
deleted file mode 100644
index 5a3d2f73..00000000
--- a/lib/win32com/test/testvb.py
+++ /dev/null
@@ -1,594 +0,0 @@
-# Test code for a VB Program.
-#
-# This requires the PythonCOM VB Test Harness.
-#
-
-import sys
-import traceback
-
-import pythoncom
-import win32com.client
-import win32com.client.dynamic
-import win32com.client.gencache
-import winerror
-from pywin32_testutil import str2memory
-from win32com.server.util import NewCollection, wrap
-from win32com.test import util
-
-# for debugging
-useDispatcher = None
-##  import win32com.server.dispatcher
-##  useDispatcher = win32com.server.dispatcher.DefaultDebugDispatcher
-
-error = RuntimeError
-
-
-# Set up a COM object that VB will do some callbacks on.  This is used
-# to test byref params for gateway IDispatch.
-class TestObject:
-    _public_methods_ = [
-        "CallbackVoidOneByRef",
-        "CallbackResultOneByRef",
-        "CallbackVoidTwoByRef",
-        "CallbackString",
-        "CallbackResultOneByRefButReturnNone",
-        "CallbackVoidOneByRefButReturnNone",
-        "CallbackArrayResult",
-        "CallbackArrayResultOneArrayByRef",
-        "CallbackArrayResultWrongSize",
-    ]
-
-    def CallbackVoidOneByRef(self, intVal):
-        return intVal + 1
-
-    def CallbackResultOneByRef(self, intVal):
-        return intVal, intVal + 1
-
-    def CallbackVoidTwoByRef(self, int1, int2):
-        return int1 + int2, int1 - int2
-
-    def CallbackString(self, strVal):
-        return 0, strVal + " has visited Python"
-
-    def CallbackArrayResult(self, arrayVal):
-        ret = []
-        for i in arrayVal:
-            ret.append(i + 1)
-        # returning as a list forces it be processed as a single result
-        # (rather than a tuple, where it may be interpreted as
-        # multiple results for byref unpacking)
-        return ret
-
-    def CallbackArrayResultWrongSize(self, arrayVal):
-        return list(arrayVal[:-1])
-
-    def CallbackArrayResultOneArrayByRef(self, arrayVal):
-        ret = []
-        for i in arrayVal:
-            ret.append(i + 1)
-        # See above for list processing.
-        return list(arrayVal), ret
-
-    def CallbackResultOneByRefButReturnNone(self, intVal):
-        return
-
-    def CallbackVoidOneByRefButReturnNone(self, intVal):
-        return
-
-
-def TestVB(vbtest, bUseGenerated):
-    vbtest.LongProperty = -1
-    if vbtest.LongProperty != -1:
-        raise error("Could not set the long property correctly.")
-    vbtest.IntProperty = 10
-    if vbtest.IntProperty != 10:
-        raise error("Could not set the integer property correctly.")
-    vbtest.VariantProperty = 10
-    if vbtest.VariantProperty != 10:
-        raise error("Could not set the variant integer property correctly.")
-    vbtest.VariantProperty = str2memory("raw\0data")
-    if vbtest.VariantProperty != str2memory("raw\0data"):
-        raise error("Could not set the variant buffer property correctly.")
-    vbtest.StringProperty = "Hello from Python"
-    if vbtest.StringProperty != "Hello from Python":
-        raise error("Could not set the string property correctly.")
-    vbtest.VariantProperty = "Hello from Python"
-    if vbtest.VariantProperty != "Hello from Python":
-        raise error("Could not set the variant string property correctly.")
-    vbtest.VariantProperty = (1.0, 2.0, 3.0)
-    if vbtest.VariantProperty != (1.0, 2.0, 3.0):
-        raise error(
-            "Could not set the variant property to an array of floats correctly - '%s'."
-            % (vbtest.VariantProperty,)
-        )
-
-    TestArrays(vbtest, bUseGenerated)
-    TestStructs(vbtest)
-    TestCollections(vbtest)
-
-    assert vbtest.TakeByValObject(vbtest) == vbtest
-
-    # Python doesnt support PUTREF properties without a typeref
-    # (although we could)
-    if bUseGenerated:
-        ob = vbtest.TakeByRefObject(vbtest)
-        assert ob[0] == vbtest and ob[1] == vbtest
-
-        # A property that only has PUTREF defined.
-        vbtest.VariantPutref = vbtest
-        if vbtest.VariantPutref._oleobj_ != vbtest._oleobj_:
-            raise error("Could not set the VariantPutref property correctly.")
-        # Cant test further types for this VariantPutref, as only
-        # COM objects can be stored ByRef.
-
-        # A "set" type property - only works for generated.
-        # VB recognizes a collection via a few "private" interfaces that we
-        # could later build support in for.
-        #               vbtest.CollectionProperty = NewCollection((1,2,"3", "Four"))
-        #               if vbtest.CollectionProperty != (1,2,"3", "Four"):
-        #                       raise error("Could not set the Collection property correctly - got back " + str(vbtest.CollectionProperty))
-
-        # These are sub's that have a single byref param
-        # Result should be just the byref.
-        if vbtest.IncrementIntegerParam(1) != 2:
-            raise error("Could not pass an integer byref")
-
-        # Sigh - we cant have *both* "ommited byref" and optional args
-        # We really have to opt that args nominated as optional work as optional
-        # rather than simply all byrefs working as optional.
-        #               if vbtest.IncrementIntegerParam() != 1:
-        #                       raise error("Could not pass an omitted integer byref")
-
-        if vbtest.IncrementVariantParam(1) != 2:
-            raise error(
-                "Could not pass an int VARIANT byref:"
-                + str(vbtest.IncrementVariantParam(1))
-            )
-
-        if vbtest.IncrementVariantParam(1.5) != 2.5:
-            raise error("Could not pass a float VARIANT byref")
-
-        # Can't test IncrementVariantParam with the param omitted as it
-        # it not declared in the VB code as "Optional"
-        callback_ob = wrap(TestObject(), useDispatcher=useDispatcher)
-        vbtest.DoSomeCallbacks(callback_ob)
-
-    ret = vbtest.PassIntByVal(1)
-    if ret != 2:
-        raise error("Could not increment the integer - " + str(ret))
-
-    TestVBInterface(vbtest)
-    # Python doesnt support byrefs without some sort of generated support.
-    if bUseGenerated:
-        # This is a VB function that takes a single byref
-        # Hence 2 return values - function and byref.
-        ret = vbtest.PassIntByRef(1)
-        if ret != (1, 2):
-            raise error("Could not increment the integer - " + str(ret))
-        # Check you can leave a byref arg blank.
-
-
-# see above
-#               ret = vbtest.PassIntByRef()
-#               if ret != (0,1):
-#                       raise error("Could not increment the integer with default arg- "+str(ret))
-
-
-def _DoTestCollection(vbtest, col_name, expected):
-    # It sucks that some objects allow "Count()", but others "Count"
-    def _getcount(ob):
-        r = getattr(ob, "Count")
-        if type(r) != type(0):
-            return r()
-        return r
-
-    c = getattr(vbtest, col_name)
-    check = []
-    for item in c:
-        check.append(item)
-    if check != list(expected):
-        raise error(
-            "Collection %s didn't have %r (had %r)" % (col_name, expected, check)
-        )
-    # Just looping over the collection again works (ie, is restartable)
-    check = []
-    for item in c:
-        check.append(item)
-    if check != list(expected):
-        raise error(
-            "Collection 2nd time around %s didn't have %r (had %r)"
-            % (col_name, expected, check)
-        )
-    # Check we can get it via iter()
-    i = iter(getattr(vbtest, col_name))
-    check = []
-    for item in i:
-        check.append(item)
-    if check != list(expected):
-        raise error(
-            "Collection iterator %s didn't have %r 2nd time around (had %r)"
-            % (col_name, expected, check)
-        )
-    # but an iterator is not restartable
-    check = []
-    for item in i:
-        check.append(item)
-    if check != []:
-        raise error(
-            "2nd time around Collection iterator %s wasn't empty (had %r)"
-            % (col_name, check)
-        )
-
-    # Check len()==Count()
-    c = getattr(vbtest, col_name)
-    if len(c) != _getcount(c):
-        raise error(
-            "Collection %s __len__(%r) wasn't==Count(%r)"
-            % (col_name, len(c), _getcount(c))
-        )
-    # Check we can do it with zero based indexing.
-    c = getattr(vbtest, col_name)
-    check = []
-    for i in range(_getcount(c)):
-        check.append(c[i])
-    if check != list(expected):
-        raise error(
-            "Collection %s didn't have %r (had %r)" % (col_name, expected, check)
-        )
-
-    # Check we can do it with our old "Skip/Next" methods.
-    c = getattr(vbtest, col_name)._NewEnum()
-    check = []
-    while 1:
-        n = c.Next()
-        if not n:
-            break
-        check.append(n[0])
-    if check != list(expected):
-        raise error(
-            "Collection %s didn't have %r (had %r)" % (col_name, expected, check)
-        )
-
-
-def TestCollections(vbtest):
-    _DoTestCollection(vbtest, "CollectionProperty", [1, "Two", "3"])
-    # zero based indexing works for simple VB collections.
-    if vbtest.CollectionProperty[0] != 1:
-        raise error("The CollectionProperty[0] element was not the default value")
-
-    _DoTestCollection(vbtest, "EnumerableCollectionProperty", [])
-    vbtest.EnumerableCollectionProperty.Add(1)
-    vbtest.EnumerableCollectionProperty.Add("Two")
-    vbtest.EnumerableCollectionProperty.Add("3")
-    _DoTestCollection(vbtest, "EnumerableCollectionProperty", [1, "Two", "3"])
-
-
-def _DoTestArray(vbtest, data, expected_exception=None):
-    try:
-        vbtest.ArrayProperty = data
-        if expected_exception is not None:
-            raise error("Expected '%s'" % expected_exception)
-    except expected_exception:
-        return
-    got = vbtest.ArrayProperty
-    if got != data:
-        raise error(
-            "Could not set the array data correctly - got %r, expected %r" % (got, data)
-        )
-
-
-def TestArrays(vbtest, bUseGenerated):
-    # Try and use a safe array (note that the VB code has this declared as a VARIANT
-    # and I cant work out how to force it to use native arrays!
-    # (NOTE Python will convert incoming arrays to tuples, so we pass a tuple, even tho
-    # a list works fine - just makes it easier for us to compare the result!
-    # Empty array
-    _DoTestArray(vbtest, ())
-    # Empty child array
-    _DoTestArray(vbtest, ((), ()))
-    # ints
-    _DoTestArray(vbtest, tuple(range(1, 100)))
-    # Floats
-    _DoTestArray(vbtest, (1.0, 2.0, 3.0))
-    # Strings.
-    _DoTestArray(vbtest, tuple("Hello from Python".split()))
-    # Date and Time?
-    # COM objects.
-    _DoTestArray(vbtest, (vbtest, vbtest))
-    # Mixed
-    _DoTestArray(vbtest, (1, 2.0, "3"))
-    # Array alements containing other arrays
-    _DoTestArray(vbtest, (1, (vbtest, vbtest), ("3", "4")))
-    # Multi-dimensional
-    _DoTestArray(vbtest, (((1, 2, 3), (4, 5, 6))))
-    _DoTestArray(vbtest, (((vbtest, vbtest, vbtest), (vbtest, vbtest, vbtest))))
-    # Another dimension!
-    arrayData = (((1, 2), (3, 4), (5, 6)), ((7, 8), (9, 10), (11, 12)))
-    arrayData = (
-        ((vbtest, vbtest), (vbtest, vbtest), (vbtest, vbtest)),
-        ((vbtest, vbtest), (vbtest, vbtest), (vbtest, vbtest)),
-    )
-    _DoTestArray(vbtest, arrayData)
-
-    # Check that when a '__getitem__ that fails' object is the first item
-    # in the structure, we don't mistake it for a sequence.
-    _DoTestArray(vbtest, (vbtest, 2.0, "3"))
-    _DoTestArray(vbtest, (1, 2.0, vbtest))
-
-    # Pass arbitrarily sized arrays - these used to fail, but thanks to
-    # Stefan Schukat, they now work!
-    expected_exception = None
-    arrayData = (((1, 2, 1), (3, 4), (5, 6)), ((7, 8), (9, 10), (11, 12)))
-    _DoTestArray(vbtest, arrayData, expected_exception)
-    arrayData = (((vbtest, vbtest),), ((vbtest,),))
-    _DoTestArray(vbtest, arrayData, expected_exception)
-    # Pass bad data - last item wrong size
-    arrayData = (((1, 2), (3, 4), (5, 6, 8)), ((7, 8), (9, 10), (11, 12)))
-    _DoTestArray(vbtest, arrayData, expected_exception)
-
-    # byref safearray results with incorrect size.
-    callback_ob = wrap(TestObject(), useDispatcher=useDispatcher)
-    print("** Expecting a 'ValueError' exception to be printed next:")
-    try:
-        vbtest.DoCallbackSafeArraySizeFail(callback_ob)
-    except pythoncom.com_error as exc:
-        assert (
-            exc.excepinfo[1] == "Python COM Server Internal Error"
-        ), "Didnt get the correct exception - '%s'" % (exc,)
-
-    if bUseGenerated:
-        # This one is a bit strange!  The array param is "ByRef", as VB insists.
-        # The function itself also _returns_ the arram param.
-        # Therefore, Python sees _2_ result values - one for the result,
-        # and one for the byref.
-        testData = "Mark was here".split()
-        resultData, byRefParam = vbtest.PassSAFEARRAY(testData)
-        if testData != list(resultData):
-            raise error(
-                "The safe array data was not what we expected - got " + str(resultData)
-            )
-        if testData != list(byRefParam):
-            raise error(
-                "The safe array data was not what we expected - got " + str(byRefParam)
-            )
-        testData = [1.0, 2.0, 3.0]
-        resultData, byRefParam = vbtest.PassSAFEARRAYVariant(testData)
-        assert testData == list(byRefParam)
-        assert testData == list(resultData)
-        testData = ["hi", "from", "Python"]
-        resultData, byRefParam = vbtest.PassSAFEARRAYVariant(testData)
-        assert testData == list(byRefParam), "Expected '%s', got '%s'" % (
-            testData,
-            list(byRefParam),
-        )
-        assert testData == list(resultData), "Expected '%s', got '%s'" % (
-            testData,
-            list(resultData),
-        )
-        # This time, instead of an explicit str() for 1.5, we just
-        # pass Unicode, so the result should compare equal
-        testData = [1, 2.0, "3"]
-        resultData, byRefParam = vbtest.PassSAFEARRAYVariant(testData)
-        assert testData == list(byRefParam)
-        assert testData == list(resultData)
-    print("Array tests passed")
-
-
-def TestStructs(vbtest):
-    try:
-        vbtest.IntProperty = "One"
-        raise error("Should have failed by now")
-    except pythoncom.com_error as exc:
-        if exc.hresult != winerror.DISP_E_TYPEMISMATCH:
-            raise error("Expected DISP_E_TYPEMISMATCH")
-
-    s = vbtest.StructProperty
-    if s.int_val != 99 or str(s.str_val) != "hello":
-        raise error("The struct value was not correct")
-    s.str_val = "Hi from Python"
-    s.int_val = 11
-    if s.int_val != 11 or str(s.str_val) != "Hi from Python":
-        raise error("The struct value didnt persist!")
-
-    if s.sub_val.int_val != 66 or str(s.sub_val.str_val) != "sub hello":
-        raise error("The sub-struct value was not correct")
-    sub = s.sub_val
-    sub.int_val = 22
-    if sub.int_val != 22:
-        print(sub.int_val)
-        raise error("The sub-struct value didnt persist!")
-
-    if s.sub_val.int_val != 22:
-        print(s.sub_val.int_val)
-        raise error("The sub-struct value (re-fetched) didnt persist!")
-
-    if (
-        s.sub_val.array_val[0].int_val != 0
-        or str(s.sub_val.array_val[0].str_val) != "zero"
-    ):
-        print(s.sub_val.array_val[0].int_val)
-        raise error("The array element wasnt correct")
-    s.sub_val.array_val[0].int_val = 99
-    s.sub_val.array_val[1].int_val = 66
-    if s.sub_val.array_val[0].int_val != 99 or s.sub_val.array_val[1].int_val != 66:
-        print(s.sub_val.array_val[0].int_val)
-        raise error("The array element didnt persist.")
-    # Now pass the struct back to VB
-    vbtest.StructProperty = s
-    # And get it back again
-    s = vbtest.StructProperty
-    if s.int_val != 11 or str(s.str_val) != "Hi from Python":
-        raise error("After sending to VB, the struct value didnt persist!")
-    if s.sub_val.array_val[0].int_val != 99:
-        raise error("After sending to VB, the struct array value didnt persist!")
-
-    # Now do some object equality tests.
-    assert s == s
-    assert s != None
-    if sys.version_info > (3, 0):
-        try:
-            s < None
-            raise error("Expected type error")
-        except TypeError:
-            pass
-        try:
-            None < s
-            raise error("Expected type error")
-        except TypeError:
-            pass
-    assert s != s.sub_val
-    import copy
-
-    s2 = copy.copy(s)
-    assert s is not s2
-    assert s == s2
-    s2.int_val = 123
-    assert s != s2
-    # Make sure everything works with functions
-    s2 = vbtest.GetStructFunc()
-    assert s == s2
-    vbtest.SetStructSub(s2)
-
-    # Create a new structure, and set its elements.
-    s = win32com.client.Record("VBStruct", vbtest)
-    assert s.int_val == 0, "new struct inst initialized correctly!"
-    s.int_val = -1
-    vbtest.SetStructSub(s)
-    assert vbtest.GetStructFunc().int_val == -1, "new struct didnt make the round trip!"
-    # Finally, test stand-alone structure arrays.
-    s_array = vbtest.StructArrayProperty
-    assert s_array is None, "Expected None from the uninitialized VB array"
-    vbtest.MakeStructArrayProperty(3)
-    s_array = vbtest.StructArrayProperty
-    assert len(s_array) == 3
-    for i in range(len(s_array)):
-        assert s_array[i].int_val == i
-        assert s_array[i].sub_val.int_val == i
-        assert s_array[i].sub_val.array_val[0].int_val == i
-        assert s_array[i].sub_val.array_val[1].int_val == i + 1
-        assert s_array[i].sub_val.array_val[2].int_val == i + 2
-
-    # Some error type checks.
-    try:
-        s.bad_attribute
-        raise RuntimeError("Could get a bad attribute")
-    except AttributeError:
-        pass
-    m = s.__members__
-    assert (
-        m[0] == "int_val"
-        and m[1] == "str_val"
-        and m[2] == "ob_val"
-        and m[3] == "sub_val"
-    ), m
-
-    # Test attribute errors.
-    try:
-        s.foo
-        raise RuntimeError("Expected attribute error")
-    except AttributeError as exc:
-        assert "foo" in str(exc), exc
-
-    # test repr - it uses repr() of the sub-objects, so check it matches.
-    expected = "com_struct(int_val=%r, str_val=%r, ob_val=%r, sub_val=%r)" % (
-        s.int_val,
-        s.str_val,
-        s.ob_val,
-        s.sub_val,
-    )
-    if repr(s) != expected:
-        print("Expected repr:", expected)
-        print("Actual repr  :", repr(s))
-        raise RuntimeError("repr() of record object failed")
-
-    print("Struct/Record tests passed")
-
-
-def TestVBInterface(ob):
-    t = ob.GetInterfaceTester(2)
-    if t.getn() != 2:
-        raise error("Initial value wrong")
-    t.setn(3)
-    if t.getn() != 3:
-        raise error("New value wrong")
-
-
-def TestObjectSemantics(ob):
-    # a convenient place to test some of our equality semantics
-    assert ob == ob._oleobj_
-    assert not ob != ob._oleobj_
-    # same test again, but lhs and rhs reversed.
-    assert ob._oleobj_ == ob
-    assert not ob._oleobj_ != ob
-    # same tests but against different pointers.  COM identity rules should
-    # still ensure all works
-    assert ob._oleobj_ == ob._oleobj_.QueryInterface(pythoncom.IID_IUnknown)
-    assert not ob._oleobj_ != ob._oleobj_.QueryInterface(pythoncom.IID_IUnknown)
-
-    assert ob._oleobj_ != None
-    assert None != ob._oleobj_
-    assert ob != None
-    assert None != ob
-    if sys.version_info > (3, 0):
-        try:
-            ob < None
-            raise error("Expected type error")
-        except TypeError:
-            pass
-        try:
-            None < ob
-            raise error("Expected type error")
-        except TypeError:
-            pass
-
-    assert ob._oleobj_.QueryInterface(pythoncom.IID_IUnknown) == ob._oleobj_
-    assert not ob._oleobj_.QueryInterface(pythoncom.IID_IUnknown) != ob._oleobj_
-
-    assert ob._oleobj_ == ob._oleobj_.QueryInterface(pythoncom.IID_IDispatch)
-    assert not ob._oleobj_ != ob._oleobj_.QueryInterface(pythoncom.IID_IDispatch)
-
-    assert ob._oleobj_.QueryInterface(pythoncom.IID_IDispatch) == ob._oleobj_
-    assert not ob._oleobj_.QueryInterface(pythoncom.IID_IDispatch) != ob._oleobj_
-
-    print("Object semantic tests passed")
-
-
-def DoTestAll():
-    o = win32com.client.Dispatch("PyCOMVBTest.Tester")
-    TestObjectSemantics(o)
-    TestVB(o, 1)
-
-    o = win32com.client.dynamic.DumbDispatch("PyCOMVBTest.Tester")
-    TestObjectSemantics(o)
-    TestVB(o, 0)
-
-
-def TestAll():
-    # Import the type library for the test module.  Let the 'invalid clsid'
-    # exception filter up, where the test runner will treat it as 'skipped'
-    win32com.client.gencache.EnsureDispatch("PyCOMVBTest.Tester")
-
-    if not __debug__:
-        raise RuntimeError("This must be run in debug mode - we use assert!")
-    try:
-        DoTestAll()
-        print("All tests appear to have worked!")
-    except:
-        # ?????
-        print("TestAll() failed!!")
-        traceback.print_exc()
-        raise
-
-
-# Make this test run under our test suite to leak tests etc work
-def suite():
-    import unittest
-
-    test = util.CapturingFunctionTestCase(TestAll, description="VB tests")
-    suite = unittest.TestSuite()
-    suite.addTest(test)
-    return suite
-
-
-if __name__ == "__main__":
-    util.testmain()
diff --git a/lib/win32com/test/testvbscript_regexp.py b/lib/win32com/test/testvbscript_regexp.py
deleted file mode 100644
index a22f0bea..00000000
--- a/lib/win32com/test/testvbscript_regexp.py
+++ /dev/null
@@ -1,40 +0,0 @@
-import unittest
-
-import win32com.test.util
-from win32com.client.dynamic import DumbDispatch
-from win32com.client.gencache import EnsureDispatch
-
-
-class RegexTest(win32com.test.util.TestCase):
-    def _CheckMatches(self, match, expected):
-        found = []
-        for imatch in match:
-            found.append(imatch.FirstIndex)
-        self.assertEqual(list(found), list(expected))
-
-    def _TestVBScriptRegex(self, re):
-        StringToSearch = "Python python pYthon Python"
-        re.Pattern = "Python"
-        re.Global = True
-
-        re.IgnoreCase = True
-        match = re.Execute(StringToSearch)
-        expected = 0, 7, 14, 21
-        self._CheckMatches(match, expected)
-
-        re.IgnoreCase = False
-        match = re.Execute(StringToSearch)
-        expected = 0, 21
-        self._CheckMatches(match, expected)
-
-    def testDynamic(self):
-        re = DumbDispatch("VBScript.Regexp")
-        self._TestVBScriptRegex(re)
-
-    def testGenerated(self):
-        re = EnsureDispatch("VBScript.Regexp")
-        self._TestVBScriptRegex(re)
-
-
-if __name__ == "__main__":
-    unittest.main()
diff --git a/lib/win32com/test/testxslt.js b/lib/win32com/test/testxslt.js
deleted file mode 100644
index 347401c2..00000000
--- a/lib/win32com/test/testxslt.js
+++ /dev/null
@@ -1,12 +0,0 @@
-//Args:  input-file style-file output-file
-var xml  = WScript.CreateObject("Microsoft.XMLDOM");          //input
-xml.validateOnParse=false;
-xml.load(WScript.Arguments(0));
-var xsl  = WScript.CreateObject("Microsoft.XMLDOM");          //style
-xsl.validateOnParse=false;
-xsl.load(WScript.Arguments(1));
-var out = WScript.CreateObject("Scripting.FileSystemObject"); //output
-var replace = true; var unicode = false; //output file properties
-var hdl = out.CreateTextFile( WScript.Arguments(2), replace, unicode )
-hdl.write( xml.transformNode( xsl.documentElement ));
-//eof
diff --git a/lib/win32com/test/testxslt.py b/lib/win32com/test/testxslt.py
deleted file mode 100644
index caaa2ec5..00000000
--- a/lib/win32com/test/testxslt.py
+++ /dev/null
@@ -1,34 +0,0 @@
-import os
-import tempfile
-import unittest
-
-import win32com.test.util
-
-expected_output = "The jscript test worked.\nThe Python test worked"
-
-
-class XSLT(win32com.test.util.TestCase):
-    def testAll(self):
-        output_name = tempfile.mktemp("-pycom-test")
-        cmd = (
-            "cscript //nologo testxslt.js doesnt_matter.xml testxslt.xsl " + output_name
-        )
-        win32com.test.util.ExecuteShellCommand(cmd, self)
-        try:
-            f = open(output_name)
-            try:
-                got = f.read()
-                if got != expected_output:
-                    print("ERROR: XSLT expected output of %r" % (expected_output,))
-                    print("but got %r" % (got,))
-            finally:
-                f.close()
-        finally:
-            try:
-                os.unlink(output_name)
-            except os.error:
-                pass
-
-
-if __name__ == "__main__":
-    unittest.main()
diff --git a/lib/win32com/test/testxslt.xsl b/lib/win32com/test/testxslt.xsl
deleted file mode 100644
index 9ab5c0f9..00000000
--- a/lib/win32com/test/testxslt.xsl
+++ /dev/null
@@ -1,55 +0,0 @@
-<!-- include in the xsl:stylesheet element:
-     (a) the version attribute as usual
-     (b) the XSLT namespace declaration as usual
-     (c) the MSXSL namespace declaration
-     (d) a namespace declaration to identify your functions
-     (e) the 'extension-element-prefixes' attribute to give the
-         namespace prefixes that indicate extension elements
-         (i.e. 'msxsl')
-     (f) the 'exclude-result-prefixes' attribute to indicate the
-         namespaces that aren't supposed to be part of the result
-         tree (i.e. 'foo') -->
-<xsl:stylesheet version="1.0"
-                xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
-                xmlns:msxsl="urn:schemas-microsoft-com:xslt"
-                xmlns:foo="http://www.pythoncom-test.com/foo"
-                xmlns:bar="http://www.pythoncom-test.com/bar"
-                extension-element-prefixes="msxsl"
-                exclude-result-prefixes="foo bar">
-
-<!-- do whatever output you want - you can use full XSLT functionality
-     -->
-<xsl:output method="html" />
-
-<!-- define the Javascript functions that you want to include within
-     a msxsl:script element.
-     - language indicates the scripting language
-     - implements-prefix gives the namespace prefix that you declared
-       for your function (i.e. foo) -->
-<msxsl:script language="javascript"
-              implements-prefix="foo">
-   function worked() {
-      return "The jscript test worked";
-    }
-</msxsl:script>
-
-<!-- ditto for Python, using the 'bar' namespace
--->
-<msxsl:script language="python"
-              implements-prefix="bar">
-def worked():
-  return "The Python test worked"
-</msxsl:script>
-
-<xsl:template match="/">
-<!-- The output template.  Keep whitespace down as our test matches text exactly -->
-<!-- call your functions using the prefix that you've used (i.e.
-     foo) anywhere you can normally use an XPath function, but
-     make sure it's returning the right kind of object -->
-<xsl:value-of select="foo:worked()" />.
-<xsl:value-of select="bar:worked()" />
-
-</xsl:template>
-
-</xsl:stylesheet>
-
diff --git a/lib/win32com/test/util.py b/lib/win32com/test/util.py
deleted file mode 100644
index 691be851..00000000
--- a/lib/win32com/test/util.py
+++ /dev/null
@@ -1,265 +0,0 @@
-import gc
-import logging
-import os
-import sys
-import tempfile
-import unittest
-import winreg
-
-import pythoncom
-import pywin32_testutil
-import pywintypes
-import win32api
-import win32com
-import winerror
-from pythoncom import _GetGatewayCount, _GetInterfaceCount
-from pywin32_testutil import LeakTestCase, TestLoader, TestResult, TestRunner
-
-
-def CheckClean():
-    # Ensure no lingering exceptions - Python should have zero outstanding
-    # COM objects
-    try:
-        sys.exc_clear()
-    except AttributeError:
-        pass  # py3k
-    c = _GetInterfaceCount()
-    if c:
-        print("Warning - %d com interface objects still alive" % c)
-    c = _GetGatewayCount()
-    if c:
-        print("Warning - %d com gateway objects still alive" % c)
-
-
-def RegisterPythonServer(filename, progids=None, verbose=0):
-    if progids:
-        if isinstance(progids, str):
-            progids = [progids]
-        # we know the CLSIDs we need, but we might not be an admin user
-        # and otherwise unable to register them.  So as long as the progids
-        # exist and the DLL points at our version, assume it already is.
-        why_not = None
-        for progid in progids:
-            try:
-                clsid = pywintypes.IID(progid)
-            except pythoncom.com_error:
-                # not registered.
-                break
-            try:
-                HKCR = winreg.HKEY_CLASSES_ROOT
-                hk = winreg.OpenKey(HKCR, "CLSID\\%s" % clsid)
-                dll = winreg.QueryValue(hk, "InprocServer32")
-            except WindowsError:
-                # no CLSID or InProcServer32 - not registered
-                break
-            ok_files = [
-                os.path.basename(pythoncom.__file__),
-                "pythoncomloader%d%d.dll" % (sys.version_info[0], sys.version_info[1]),
-            ]
-            if os.path.basename(dll) not in ok_files:
-                why_not = "%r is registered against a different Python version (%s)" % (
-                    progid,
-                    dll,
-                )
-                break
-        else:
-            # print "Skipping registration of '%s' - already registered" % filename
-            return
-    # needs registration - see if its likely!
-    try:
-        from win32com.shell.shell import IsUserAnAdmin
-    except ImportError:
-        print("Can't import win32com.shell - no idea if you are an admin or not?")
-        is_admin = False
-    else:
-        try:
-            is_admin = IsUserAnAdmin()
-        except pythoncom.com_error:
-            # old, less-secure OS - assume *is* admin.
-            is_admin = True
-    if not is_admin:
-        msg = (
-            "%r isn't registered, but I'm not an administrator who can register it."
-            % progids[0]
-        )
-        if why_not:
-            msg += "\n(registration check failed as %s)" % why_not
-        # throw a normal "class not registered" exception - we don't report
-        # them the same way as "real" errors.
-        raise pythoncom.com_error(winerror.CO_E_CLASSSTRING, msg, None, -1)
-    # so theoretically we are able to register it.
-    cmd = '%s "%s" --unattended > nul 2>&1' % (win32api.GetModuleFileName(0), filename)
-    if verbose:
-        print("Registering engine", filename)
-    #       print cmd
-    rc = os.system(cmd)
-    if rc:
-        print("Registration command was:")
-        print(cmd)
-        raise RuntimeError("Registration of engine '%s' failed" % filename)
-
-
-def ExecuteShellCommand(
-    cmd,
-    testcase,
-    expected_output=None,  # Set to '' to check for nothing
-    tracebacks_ok=0,  # OK if the output contains a t/b?
-):
-    output_name = tempfile.mktemp("win32com_test")
-    cmd = cmd + ' > "%s" 2>&1' % output_name
-    rc = os.system(cmd)
-    output = open(output_name, "r").read().strip()
-    os.remove(output_name)
-
-    class Failed(Exception):
-        pass
-
-    try:
-        if rc:
-            raise Failed("exit code was " + str(rc))
-        if expected_output is not None and output != expected_output:
-            raise Failed("Expected output %r (got %r)" % (expected_output, output))
-        if not tracebacks_ok and output.find("Traceback (most recent call last)") >= 0:
-            raise Failed("traceback in program output")
-        return output
-    except Failed as why:
-        print("Failed to exec command '%r'" % cmd)
-        print("Failed as", why)
-        print("** start of program output **")
-        print(output)
-        print("** end of program output **")
-        testcase.fail("Executing '%s' failed as %s" % (cmd, why))
-
-
-def assertRaisesCOM_HRESULT(testcase, hresult, func, *args, **kw):
-    try:
-        func(*args, **kw)
-    except pythoncom.com_error as details:
-        if details.hresult == hresult:
-            return
-    testcase.fail("Excepected COM exception with HRESULT 0x%x" % hresult)
-
-
-class CaptureWriter:
-    def __init__(self):
-        self.old_err = self.old_out = None
-        self.clear()
-
-    def capture(self):
-        self.clear()
-        self.old_out = sys.stdout
-        self.old_err = sys.stderr
-        sys.stdout = sys.stderr = self
-
-    def release(self):
-        if self.old_out:
-            sys.stdout = self.old_out
-            self.old_out = None
-        if self.old_err:
-            sys.stderr = self.old_err
-            self.old_err = None
-
-    def clear(self):
-        self.captured = []
-
-    def write(self, msg):
-        self.captured.append(msg)
-
-    def get_captured(self):
-        return "".join(self.captured)
-
-    def get_num_lines_captured(self):
-        return len("".join(self.captured).split("\n"))
-
-
-# Utilities to set the win32com logger to something what just captures
-# records written and doesn't print them.
-class LogHandler(logging.Handler):
-    def __init__(self):
-        self.emitted = []
-        logging.Handler.__init__(self)
-
-    def emit(self, record):
-        self.emitted.append(record)
-
-
-_win32com_logger = None
-
-
-def setup_test_logger():
-    old_log = getattr(win32com, "logger", None)
-    global _win32com_logger
-    if _win32com_logger is None:
-        _win32com_logger = logging.Logger("test")
-        handler = LogHandler()
-        _win32com_logger.addHandler(handler)
-
-    win32com.logger = _win32com_logger
-    handler = _win32com_logger.handlers[0]
-    handler.emitted = []
-    return handler.emitted, old_log
-
-
-def restore_test_logger(prev_logger):
-    assert prev_logger is None, "who needs this?"
-    if prev_logger is None:
-        del win32com.logger
-    else:
-        win32com.logger = prev_logger
-
-
-# We used to override some of this (and may later!)
-TestCase = unittest.TestCase
-
-
-def CapturingFunctionTestCase(*args, **kw):
-    real_test = _CapturingFunctionTestCase(*args, **kw)
-    return LeakTestCase(real_test)
-
-
-class _CapturingFunctionTestCase(unittest.FunctionTestCase):  # , TestCaseMixin):
-    def __call__(self, result=None):
-        if result is None:
-            result = self.defaultTestResult()
-        writer = CaptureWriter()
-        # self._preTest()
-        writer.capture()
-        try:
-            unittest.FunctionTestCase.__call__(self, result)
-            if getattr(self, "do_leak_tests", 0) and hasattr(sys, "gettotalrefcount"):
-                self.run_leak_tests(result)
-        finally:
-            writer.release()
-            # self._postTest(result)
-        output = writer.get_captured()
-        self.checkOutput(output, result)
-        if result.showAll:
-            print(output)
-
-    def checkOutput(self, output, result):
-        if output.find("Traceback") >= 0:
-            msg = "Test output contained a traceback\n---\n%s\n---" % output
-            result.errors.append((self, msg))
-
-
-class ShellTestCase(unittest.TestCase):
-    def __init__(self, cmd, expected_output):
-        self.__cmd = cmd
-        self.__eo = expected_output
-        unittest.TestCase.__init__(self)
-
-    def runTest(self):
-        ExecuteShellCommand(self.__cmd, self, self.__eo)
-
-    def __str__(self):
-        max = 30
-        if len(self.__cmd) > max:
-            cmd_repr = self.__cmd[:max] + "..."
-        else:
-            cmd_repr = self.__cmd
-        return "exec: " + cmd_repr
-
-
-def testmain(*args, **kw):
-    pywin32_testutil.testmain(*args, **kw)
-    CheckClean()
diff --git a/lib/win32com/universal.py b/lib/win32com/universal.py
deleted file mode 100644
index 7c2944ed..00000000
--- a/lib/win32com/universal.py
+++ /dev/null
@@ -1,226 +0,0 @@
-# Code that packs and unpacks the Univgw structures.
-
-# See if we have a special directory for the binaries (for developers)
-
-import pythoncom
-from win32com.client import gencache
-
-com_error = pythoncom.com_error
-_univgw = pythoncom._univgw
-
-
-def RegisterInterfaces(typelibGUID, lcid, major, minor, interface_names=None):
-    ret = []  # return a list of (dispid, funcname for our policy's benefit
-    # First see if we have makepy support.  If so, we can probably satisfy the request without loading the typelib.
-    try:
-        mod = gencache.GetModuleForTypelib(typelibGUID, lcid, major, minor)
-    except ImportError:
-        mod = None
-    if mod is None:
-        import win32com.client.build
-
-        # Load up the typelib and build (but don't cache) it now
-        tlb = pythoncom.LoadRegTypeLib(typelibGUID, major, minor, lcid)
-        typecomp_lib = tlb.GetTypeComp()
-        if interface_names is None:
-            interface_names = []
-            for i in range(tlb.GetTypeInfoCount()):
-                info = tlb.GetTypeInfo(i)
-                doc = tlb.GetDocumentation(i)
-                attr = info.GetTypeAttr()
-                if attr.typekind == pythoncom.TKIND_INTERFACE or (
-                    attr.typekind == pythoncom.TKIND_DISPATCH
-                    and attr.wTypeFlags & pythoncom.TYPEFLAG_FDUAL
-                ):
-                    interface_names.append(doc[0])
-        for name in interface_names:
-            type_info, type_comp = typecomp_lib.BindType(
-                name,
-            )
-            # Not sure why we don't get an exception here - BindType's C
-            # impl looks correct..
-            if type_info is None:
-                raise ValueError("The interface '%s' can not be located" % (name,))
-            # If we got back a Dispatch interface, convert to the real interface.
-            attr = type_info.GetTypeAttr()
-            if attr.typekind == pythoncom.TKIND_DISPATCH:
-                refhtype = type_info.GetRefTypeOfImplType(-1)
-                type_info = type_info.GetRefTypeInfo(refhtype)
-                attr = type_info.GetTypeAttr()
-            item = win32com.client.build.VTableItem(
-                type_info, attr, type_info.GetDocumentation(-1)
-            )
-            _doCreateVTable(
-                item.clsid, item.python_name, item.bIsDispatch, item.vtableFuncs
-            )
-            for info in item.vtableFuncs:
-                names, dispid, desc = info
-                invkind = desc[4]
-                ret.append((dispid, invkind, names[0]))
-    else:
-        # Cool - can used cached info.
-        if not interface_names:
-            interface_names = list(mod.VTablesToClassMap.values())
-        for name in interface_names:
-            try:
-                iid = mod.NamesToIIDMap[name]
-            except KeyError:
-                raise ValueError(
-                    "Interface '%s' does not exist in this cached typelib" % (name,)
-                )
-            #            print "Processing interface", name
-            sub_mod = gencache.GetModuleForCLSID(iid)
-            is_dispatch = getattr(sub_mod, name + "_vtables_dispatch_", None)
-            method_defs = getattr(sub_mod, name + "_vtables_", None)
-            if is_dispatch is None or method_defs is None:
-                raise ValueError("Interface '%s' is IDispatch only" % (name,))
-
-            # And create the univgw defn
-            _doCreateVTable(iid, name, is_dispatch, method_defs)
-            for info in method_defs:
-                names, dispid, desc = info
-                invkind = desc[4]
-                ret.append((dispid, invkind, names[0]))
-    return ret
-
-
-def _doCreateVTable(iid, interface_name, is_dispatch, method_defs):
-    defn = Definition(iid, is_dispatch, method_defs)
-    vtbl = _univgw.CreateVTable(defn, is_dispatch)
-    _univgw.RegisterVTable(vtbl, iid, interface_name)
-
-
-def _CalcTypeSize(typeTuple):
-    t = typeTuple[0]
-    if t & (pythoncom.VT_BYREF | pythoncom.VT_ARRAY):
-        # Its a pointer.
-        cb = _univgw.SizeOfVT(pythoncom.VT_PTR)[1]
-    elif t == pythoncom.VT_RECORD:
-        # Just because a type library uses records doesn't mean the user
-        # is trying to.  We need to better place to warn about this, but it
-        # isn't here.
-        # try:
-        #    import warnings
-        #    warnings.warn("warning: records are known to not work for vtable interfaces")
-        # except ImportError:
-        #    print "warning: records are known to not work for vtable interfaces"
-        cb = _univgw.SizeOfVT(pythoncom.VT_PTR)[1]
-        # cb = typeInfo.GetTypeAttr().cbSizeInstance
-    else:
-        cb = _univgw.SizeOfVT(t)[1]
-    return cb
-
-
-class Arg:
-    def __init__(self, arg_info, name=None):
-        self.name = name
-        self.vt, self.inOut, self.default, self.clsid = arg_info
-        self.size = _CalcTypeSize(arg_info)
-        # Offset from the beginning of the arguments of the stack.
-        self.offset = 0
-
-
-class Method:
-    def __init__(self, method_info, isEventSink=0):
-        all_names, dispid, desc = method_info
-        name = all_names[0]
-        names = all_names[1:]
-        invkind = desc[4]
-        arg_defs = desc[2]
-        ret_def = desc[8]
-
-        self.dispid = dispid
-        self.invkind = invkind
-        # We dont use this ATM.
-        #        self.ret = Arg(ret_def)
-        if isEventSink and name[:2] != "On":
-            name = "On%s" % name
-        self.name = name
-        cbArgs = 0
-        self.args = []
-        for argDesc in arg_defs:
-            arg = Arg(argDesc)
-            arg.offset = cbArgs
-            cbArgs = cbArgs + arg.size
-            self.args.append(arg)
-        self.cbArgs = cbArgs
-        self._gw_in_args = self._GenerateInArgTuple()
-        self._gw_out_args = self._GenerateOutArgTuple()
-
-    def _GenerateInArgTuple(self):
-        # Given a method, generate the in argument tuple
-        l = []
-        for arg in self.args:
-            if arg.inOut & pythoncom.PARAMFLAG_FIN or arg.inOut == 0:
-                l.append((arg.vt, arg.offset, arg.size))
-        return tuple(l)
-
-    def _GenerateOutArgTuple(self):
-        # Given a method, generate the out argument tuple
-        l = []
-        for arg in self.args:
-            if (
-                arg.inOut & pythoncom.PARAMFLAG_FOUT
-                or arg.inOut & pythoncom.PARAMFLAG_FRETVAL
-                or arg.inOut == 0
-            ):
-                l.append((arg.vt, arg.offset, arg.size, arg.clsid))
-        return tuple(l)
-
-
-class Definition:
-    def __init__(self, iid, is_dispatch, method_defs):
-        self._iid = iid
-        self._methods = []
-        self._is_dispatch = is_dispatch
-        for info in method_defs:
-            entry = Method(info)
-            self._methods.append(entry)
-
-    def iid(self):
-        return self._iid
-
-    def vtbl_argsizes(self):
-        return [m.cbArgs for m in self._methods]
-
-    def vtbl_argcounts(self):
-        return [len(m.args) for m in self._methods]
-
-    def dispatch(
-        self,
-        ob,
-        index,
-        argPtr,
-        ReadFromInTuple=_univgw.ReadFromInTuple,
-        WriteFromOutTuple=_univgw.WriteFromOutTuple,
-    ):
-        "Dispatch a call to an interface method."
-        meth = self._methods[index]
-        # Infer S_OK if they don't return anything bizarre.
-        hr = 0
-        args = ReadFromInTuple(meth._gw_in_args, argPtr)
-        # If ob is a dispatcher, ensure a policy
-        ob = getattr(ob, "policy", ob)
-        # Ensure the correct dispid is setup
-        ob._dispid_to_func_[meth.dispid] = meth.name
-        retVal = ob._InvokeEx_(meth.dispid, 0, meth.invkind, args, None, None)
-        # None is an allowed return value stating that
-        # the code doesn't want to touch any output arguments.
-        if type(retVal) == tuple:  # Like pythoncom, we special case a tuple.
-            # However, if they want to return a specific HRESULT,
-            # then they have to return all of the out arguments
-            # AND the HRESULT.
-            if len(retVal) == len(meth._gw_out_args) + 1:
-                hr = retVal[0]
-                retVal = retVal[1:]
-            else:
-                raise TypeError(
-                    "Expected %s return values, got: %s"
-                    % (len(meth._gw_out_args) + 1, len(retVal))
-                )
-        else:
-            retVal = [retVal]
-            retVal.extend([None] * (len(meth._gw_out_args) - 1))
-            retVal = tuple(retVal)
-        WriteFromOutTuple(retVal, meth._gw_out_args, argPtr)
-        return hr
diff --git a/lib/win32com/util.py b/lib/win32com/util.py
deleted file mode 100644
index 767e34a7..00000000
--- a/lib/win32com/util.py
+++ /dev/null
@@ -1,34 +0,0 @@
-"""General utility functions common to client and server.
-
-  This module contains a collection of general purpose utility functions.
-"""
-import pythoncom
-import win32api
-import win32con
-
-
-def IIDToInterfaceName(iid):
-    """Converts an IID to a string interface name.
-
-    Used primarily for debugging purposes, this allows a cryptic IID to
-    be converted to a useful string name.  This will firstly look for interfaces
-    known (ie, registered) by pythoncom.  If not known, it will look in the
-    registry for a registered interface.
-
-    iid -- An IID object.
-
-    Result -- Always a string - either an interface name, or '<Unregistered interface>'
-    """
-    try:
-        return pythoncom.ServerInterfaces[iid]
-    except KeyError:
-        try:
-            try:
-                return win32api.RegQueryValue(
-                    win32con.HKEY_CLASSES_ROOT, "Interface\\%s" % iid
-                )
-            except win32api.error:
-                pass
-        except ImportError:
-            pass
-        return str(iid)
diff --git a/lib/win32comext/adsi/__init__.py b/lib/win32comext/adsi/__init__.py
deleted file mode 100644
index ab95196f..00000000
--- a/lib/win32comext/adsi/__init__.py
+++ /dev/null
@@ -1,122 +0,0 @@
-import win32com
-import win32com.client
-
-if type(__path__) == type(""):
-    # For freeze to work!
-    import sys
-
-    try:
-        import adsi
-
-        sys.modules["win32com.adsi.adsi"] = adsi
-    except ImportError:
-        pass
-else:
-    # See if we have a special directory for the binaries (for developers)
-    win32com.__PackageSupportBuildPath__(__path__)
-
-
-# Some helpers
-# We want to _look_ like the ADSI module, but provide some additional
-# helpers.
-
-# Of specific note - most of the interfaces supported by ADSI
-# derive from IDispatch - thus, you get the custome methods from the
-# interface, as well as via IDispatch.
-import pythoncom
-
-from .adsi import *
-
-LCID = 0
-
-IDispatchType = pythoncom.TypeIIDs[pythoncom.IID_IDispatch]
-IADsContainerType = pythoncom.TypeIIDs[adsi.IID_IADsContainer]
-
-
-def _get_good_ret(
-    ob,
-    # Named arguments used internally
-    resultCLSID=None,
-):
-    assert resultCLSID is None, "Now have type info for ADSI objects - fix me!"
-    # See if the object supports IDispatch
-    if hasattr(ob, "Invoke"):
-        import win32com.client.dynamic
-
-        name = "Dispatch wrapper around %r" % ob
-        return win32com.client.dynamic.Dispatch(ob, name, ADSIDispatch)
-    return ob
-
-
-class ADSIEnumerator:
-    def __init__(self, ob):
-        # Query the object for the container interface.
-        self._cont_ = ob.QueryInterface(IID_IADsContainer)
-        self._oleobj_ = ADsBuildEnumerator(self._cont_)  # a PyIADsEnumVARIANT
-        self.index = -1
-
-    def __getitem__(self, index):
-        return self.__GetIndex(index)
-
-    def __call__(self, index):
-        return self.__GetIndex(index)
-
-    def __GetIndex(self, index):
-        if type(index) != type(0):
-            raise TypeError("Only integer indexes are supported for enumerators")
-        if index != self.index + 1:
-            # Index requested out of sequence.
-            raise ValueError("You must index this object sequentially")
-        self.index = index
-        result = ADsEnumerateNext(self._oleobj_, 1)
-        if len(result):
-            return _get_good_ret(result[0])
-        # Failed - reset for next time around.
-        self.index = -1
-        self._oleobj_ = ADsBuildEnumerator(self._cont_)  # a PyIADsEnumVARIANT
-        raise IndexError("list index out of range")
-
-
-class ADSIDispatch(win32com.client.CDispatch):
-    def _wrap_dispatch_(
-        self, ob, userName=None, returnCLSID=None, UnicodeToString=None
-    ):
-        assert UnicodeToString is None, "this is deprectated and will be removed"
-        if not userName:
-            userName = "ADSI-object"
-        olerepr = win32com.client.dynamic.MakeOleRepr(ob, None, None)
-        return ADSIDispatch(ob, olerepr, userName)
-
-    def _NewEnum(self):
-        try:
-            return ADSIEnumerator(self)
-        except pythoncom.com_error:
-            # doesnt support it - let our base try!
-            return win32com.client.CDispatch._NewEnum(self)
-
-    def __getattr__(self, attr):
-        try:
-            return getattr(self._oleobj_, attr)
-        except AttributeError:
-            return win32com.client.CDispatch.__getattr__(self, attr)
-
-    def QueryInterface(self, iid):
-        ret = self._oleobj_.QueryInterface(iid)
-        return _get_good_ret(ret)
-
-
-# We override the global methods to do the right thing.
-_ADsGetObject = ADsGetObject  # The one in the .pyd
-
-
-def ADsGetObject(path, iid=pythoncom.IID_IDispatch):
-    ret = _ADsGetObject(path, iid)
-    return _get_good_ret(ret)
-
-
-_ADsOpenObject = ADsOpenObject
-
-
-def ADsOpenObject(path, username, password, reserved=0, iid=pythoncom.IID_IDispatch):
-    ret = _ADsOpenObject(path, username, password, reserved, iid)
-    return _get_good_ret(ret)
diff --git a/lib/win32comext/adsi/adsi.pyd b/lib/win32comext/adsi/adsi.pyd
deleted file mode 100644
index 31006a516148760710baa300318a9af1dccaa226..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 97792
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
XDG$A0i+<N&B<0Zv`tR|-VGI0!QGmn`

diff --git a/lib/win32comext/adsi/adsicon.py b/lib/win32comext/adsi/adsicon.py
deleted file mode 100644
index 9944aefa..00000000
--- a/lib/win32comext/adsi/adsicon.py
+++ /dev/null
@@ -1,340 +0,0 @@
-ADS_ATTR_CLEAR = 1
-ADS_ATTR_UPDATE = 2
-ADS_ATTR_APPEND = 3
-ADS_ATTR_DELETE = 4
-ADS_EXT_MINEXTDISPID = 1
-ADS_EXT_MAXEXTDISPID = 16777215
-ADS_EXT_INITCREDENTIALS = 1
-ADS_EXT_INITIALIZE_COMPLETE = 2
-
-ADS_SEARCHPREF_ASYNCHRONOUS = 0
-ADS_SEARCHPREF_DEREF_ALIASES = 1
-ADS_SEARCHPREF_SIZE_LIMIT = 2
-ADS_SEARCHPREF_TIME_LIMIT = 3
-ADS_SEARCHPREF_ATTRIBTYPES_ONLY = 4
-ADS_SEARCHPREF_SEARCH_SCOPE = 5
-ADS_SEARCHPREF_TIMEOUT = 6
-ADS_SEARCHPREF_PAGESIZE = 7
-ADS_SEARCHPREF_PAGED_TIME_LIMIT = 8
-ADS_SEARCHPREF_CHASE_REFERRALS = 9
-ADS_SEARCHPREF_SORT_ON = 10
-ADS_SEARCHPREF_CACHE_RESULTS = 11
-ADS_SEARCHPREF_DIRSYNC = 12
-ADS_SEARCHPREF_TOMBSTONE = 13
-
-ADS_SCOPE_BASE = 0
-ADS_SCOPE_ONELEVEL = 1
-ADS_SCOPE_SUBTREE = 2
-
-ADS_SECURE_AUTHENTICATION = 0x1
-ADS_USE_ENCRYPTION = 0x2
-ADS_USE_SSL = 0x2
-ADS_READONLY_SERVER = 0x4
-ADS_PROMPT_CREDENTIALS = 0x8
-ADS_NO_AUTHENTICATION = 0x10
-ADS_FAST_BIND = 0x20
-ADS_USE_SIGNING = 0x40
-ADS_USE_SEALING = 0x80
-ADS_USE_DELEGATION = 0x100
-ADS_SERVER_BIND = 0x200
-
-ADSTYPE_INVALID = 0
-ADSTYPE_DN_STRING = ADSTYPE_INVALID + 1
-ADSTYPE_CASE_EXACT_STRING = ADSTYPE_DN_STRING + 1
-ADSTYPE_CASE_IGNORE_STRING = ADSTYPE_CASE_EXACT_STRING + 1
-ADSTYPE_PRINTABLE_STRING = ADSTYPE_CASE_IGNORE_STRING + 1
-ADSTYPE_NUMERIC_STRING = ADSTYPE_PRINTABLE_STRING + 1
-ADSTYPE_BOOLEAN = ADSTYPE_NUMERIC_STRING + 1
-ADSTYPE_INTEGER = ADSTYPE_BOOLEAN + 1
-ADSTYPE_OCTET_STRING = ADSTYPE_INTEGER + 1
-ADSTYPE_UTC_TIME = ADSTYPE_OCTET_STRING + 1
-ADSTYPE_LARGE_INTEGER = ADSTYPE_UTC_TIME + 1
-ADSTYPE_PROV_SPECIFIC = ADSTYPE_LARGE_INTEGER + 1
-ADSTYPE_OBJECT_CLASS = ADSTYPE_PROV_SPECIFIC + 1
-ADSTYPE_CASEIGNORE_LIST = ADSTYPE_OBJECT_CLASS + 1
-ADSTYPE_OCTET_LIST = ADSTYPE_CASEIGNORE_LIST + 1
-ADSTYPE_PATH = ADSTYPE_OCTET_LIST + 1
-ADSTYPE_POSTALADDRESS = ADSTYPE_PATH + 1
-ADSTYPE_TIMESTAMP = ADSTYPE_POSTALADDRESS + 1
-ADSTYPE_BACKLINK = ADSTYPE_TIMESTAMP + 1
-ADSTYPE_TYPEDNAME = ADSTYPE_BACKLINK + 1
-ADSTYPE_HOLD = ADSTYPE_TYPEDNAME + 1
-ADSTYPE_NETADDRESS = ADSTYPE_HOLD + 1
-ADSTYPE_REPLICAPOINTER = ADSTYPE_NETADDRESS + 1
-ADSTYPE_FAXNUMBER = ADSTYPE_REPLICAPOINTER + 1
-ADSTYPE_EMAIL = ADSTYPE_FAXNUMBER + 1
-ADSTYPE_NT_SECURITY_DESCRIPTOR = ADSTYPE_EMAIL + 1
-ADSTYPE_UNKNOWN = ADSTYPE_NT_SECURITY_DESCRIPTOR + 1
-ADSTYPE_DN_WITH_BINARY = ADSTYPE_UNKNOWN + 1
-ADSTYPE_DN_WITH_STRING = ADSTYPE_DN_WITH_BINARY + 1
-
-ADS_PROPERTY_CLEAR = 1
-ADS_PROPERTY_UPDATE = 2
-ADS_PROPERTY_APPEND = 3
-ADS_PROPERTY_DELETE = 4
-ADS_SYSTEMFLAG_DISALLOW_DELETE = -2147483648
-ADS_SYSTEMFLAG_CONFIG_ALLOW_RENAME = 0x40000000
-ADS_SYSTEMFLAG_CONFIG_ALLOW_MOVE = 0x20000000
-ADS_SYSTEMFLAG_CONFIG_ALLOW_LIMITED_MOVE = 0x10000000
-ADS_SYSTEMFLAG_DOMAIN_DISALLOW_RENAME = -2147483648
-ADS_SYSTEMFLAG_DOMAIN_DISALLOW_MOVE = 0x4000000
-ADS_SYSTEMFLAG_CR_NTDS_NC = 0x1
-ADS_SYSTEMFLAG_CR_NTDS_DOMAIN = 0x2
-ADS_SYSTEMFLAG_ATTR_NOT_REPLICATED = 0x1
-ADS_SYSTEMFLAG_ATTR_IS_CONSTRUCTED = 0x4
-ADS_GROUP_TYPE_GLOBAL_GROUP = 0x2
-ADS_GROUP_TYPE_DOMAIN_LOCAL_GROUP = 0x4
-ADS_GROUP_TYPE_LOCAL_GROUP = 0x4
-ADS_GROUP_TYPE_UNIVERSAL_GROUP = 0x8
-ADS_GROUP_TYPE_SECURITY_ENABLED = -2147483648
-ADS_UF_SCRIPT = 0x1
-ADS_UF_ACCOUNTDISABLE = 0x2
-ADS_UF_HOMEDIR_REQUIRED = 0x8
-ADS_UF_LOCKOUT = 0x10
-ADS_UF_PASSWD_NOTREQD = 0x20
-ADS_UF_PASSWD_CANT_CHANGE = 0x40
-ADS_UF_ENCRYPTED_TEXT_PASSWORD_ALLOWED = 0x80
-ADS_UF_TEMP_DUPLICATE_ACCOUNT = 0x100
-ADS_UF_NORMAL_ACCOUNT = 0x200
-ADS_UF_INTERDOMAIN_TRUST_ACCOUNT = 0x800
-ADS_UF_WORKSTATION_TRUST_ACCOUNT = 0x1000
-ADS_UF_SERVER_TRUST_ACCOUNT = 0x2000
-ADS_UF_DONT_EXPIRE_PASSWD = 0x10000
-ADS_UF_MNS_LOGON_ACCOUNT = 0x20000
-ADS_UF_SMARTCARD_REQUIRED = 0x40000
-ADS_UF_TRUSTED_FOR_DELEGATION = 0x80000
-ADS_UF_NOT_DELEGATED = 0x100000
-ADS_UF_USE_DES_KEY_ONLY = 0x200000
-ADS_UF_DONT_REQUIRE_PREAUTH = 0x400000
-ADS_UF_PASSWORD_EXPIRED = 0x800000
-ADS_UF_TRUSTED_TO_AUTHENTICATE_FOR_DELEGATION = 0x1000000
-ADS_RIGHT_DELETE = 0x10000
-ADS_RIGHT_READ_CONTROL = 0x20000
-ADS_RIGHT_WRITE_DAC = 0x40000
-ADS_RIGHT_WRITE_OWNER = 0x80000
-ADS_RIGHT_SYNCHRONIZE = 0x100000
-ADS_RIGHT_ACCESS_SYSTEM_SECURITY = 0x1000000
-ADS_RIGHT_GENERIC_READ = -2147483648
-ADS_RIGHT_GENERIC_WRITE = 0x40000000
-ADS_RIGHT_GENERIC_EXECUTE = 0x20000000
-ADS_RIGHT_GENERIC_ALL = 0x10000000
-ADS_RIGHT_DS_CREATE_CHILD = 0x1
-ADS_RIGHT_DS_DELETE_CHILD = 0x2
-ADS_RIGHT_ACTRL_DS_LIST = 0x4
-ADS_RIGHT_DS_SELF = 0x8
-ADS_RIGHT_DS_READ_PROP = 0x10
-ADS_RIGHT_DS_WRITE_PROP = 0x20
-ADS_RIGHT_DS_DELETE_TREE = 0x40
-ADS_RIGHT_DS_LIST_OBJECT = 0x80
-ADS_RIGHT_DS_CONTROL_ACCESS = 0x100
-ADS_ACETYPE_ACCESS_ALLOWED = 0
-ADS_ACETYPE_ACCESS_DENIED = 0x1
-ADS_ACETYPE_SYSTEM_AUDIT = 0x2
-ADS_ACETYPE_ACCESS_ALLOWED_OBJECT = 0x5
-ADS_ACETYPE_ACCESS_DENIED_OBJECT = 0x6
-ADS_ACETYPE_SYSTEM_AUDIT_OBJECT = 0x7
-ADS_ACETYPE_SYSTEM_ALARM_OBJECT = 0x8
-ADS_ACETYPE_ACCESS_ALLOWED_CALLBACK = 0x9
-ADS_ACETYPE_ACCESS_DENIED_CALLBACK = 0xA
-ADS_ACETYPE_ACCESS_ALLOWED_CALLBACK_OBJECT = 0xB
-ADS_ACETYPE_ACCESS_DENIED_CALLBACK_OBJECT = 0xC
-ADS_ACETYPE_SYSTEM_AUDIT_CALLBACK = 0xD
-ADS_ACETYPE_SYSTEM_ALARM_CALLBACK = 0xE
-ADS_ACETYPE_SYSTEM_AUDIT_CALLBACK_OBJECT = 0xF
-ADS_ACETYPE_SYSTEM_ALARM_CALLBACK_OBJECT = 0x10
-ADS_ACEFLAG_INHERIT_ACE = 0x2
-ADS_ACEFLAG_NO_PROPAGATE_INHERIT_ACE = 0x4
-ADS_ACEFLAG_INHERIT_ONLY_ACE = 0x8
-ADS_ACEFLAG_INHERITED_ACE = 0x10
-ADS_ACEFLAG_VALID_INHERIT_FLAGS = 0x1F
-ADS_ACEFLAG_SUCCESSFUL_ACCESS = 0x40
-ADS_ACEFLAG_FAILED_ACCESS = 0x80
-ADS_FLAG_OBJECT_TYPE_PRESENT = 0x1
-ADS_FLAG_INHERITED_OBJECT_TYPE_PRESENT = 0x2
-ADS_SD_CONTROL_SE_OWNER_DEFAULTED = 0x1
-ADS_SD_CONTROL_SE_GROUP_DEFAULTED = 0x2
-ADS_SD_CONTROL_SE_DACL_PRESENT = 0x4
-ADS_SD_CONTROL_SE_DACL_DEFAULTED = 0x8
-ADS_SD_CONTROL_SE_SACL_PRESENT = 0x10
-ADS_SD_CONTROL_SE_SACL_DEFAULTED = 0x20
-ADS_SD_CONTROL_SE_DACL_AUTO_INHERIT_REQ = 0x100
-ADS_SD_CONTROL_SE_SACL_AUTO_INHERIT_REQ = 0x200
-ADS_SD_CONTROL_SE_DACL_AUTO_INHERITED = 0x400
-ADS_SD_CONTROL_SE_SACL_AUTO_INHERITED = 0x800
-ADS_SD_CONTROL_SE_DACL_PROTECTED = 0x1000
-ADS_SD_CONTROL_SE_SACL_PROTECTED = 0x2000
-ADS_SD_CONTROL_SE_SELF_RELATIVE = 0x8000
-ADS_SD_REVISION_DS = 4
-ADS_NAME_TYPE_1779 = 1
-ADS_NAME_TYPE_CANONICAL = 2
-ADS_NAME_TYPE_NT4 = 3
-ADS_NAME_TYPE_DISPLAY = 4
-ADS_NAME_TYPE_DOMAIN_SIMPLE = 5
-ADS_NAME_TYPE_ENTERPRISE_SIMPLE = 6
-ADS_NAME_TYPE_GUID = 7
-ADS_NAME_TYPE_UNKNOWN = 8
-ADS_NAME_TYPE_USER_PRINCIPAL_NAME = 9
-ADS_NAME_TYPE_CANONICAL_EX = 10
-ADS_NAME_TYPE_SERVICE_PRINCIPAL_NAME = 11
-ADS_NAME_TYPE_SID_OR_SID_HISTORY_NAME = 12
-ADS_NAME_INITTYPE_DOMAIN = 1
-ADS_NAME_INITTYPE_SERVER = 2
-ADS_NAME_INITTYPE_GC = 3
-ADS_OPTION_SERVERNAME = 0
-ADS_OPTION_REFERRALS = ADS_OPTION_SERVERNAME + 1
-ADS_OPTION_PAGE_SIZE = ADS_OPTION_REFERRALS + 1
-ADS_OPTION_SECURITY_MASK = ADS_OPTION_PAGE_SIZE + 1
-ADS_OPTION_MUTUAL_AUTH_STATUS = ADS_OPTION_SECURITY_MASK + 1
-ADS_OPTION_QUOTA = ADS_OPTION_MUTUAL_AUTH_STATUS + 1
-ADS_OPTION_PASSWORD_PORTNUMBER = ADS_OPTION_QUOTA + 1
-ADS_OPTION_PASSWORD_METHOD = ADS_OPTION_PASSWORD_PORTNUMBER + 1
-ADS_SECURITY_INFO_OWNER = 0x1
-ADS_SECURITY_INFO_GROUP = 0x2
-ADS_SECURITY_INFO_DACL = 0x4
-ADS_SECURITY_INFO_SACL = 0x8
-ADS_SETTYPE_FULL = 1
-ADS_SETTYPE_PROVIDER = 2
-ADS_SETTYPE_SERVER = 3
-ADS_SETTYPE_DN = 4
-ADS_FORMAT_WINDOWS = 1
-ADS_FORMAT_WINDOWS_NO_SERVER = 2
-ADS_FORMAT_WINDOWS_DN = 3
-ADS_FORMAT_WINDOWS_PARENT = 4
-ADS_FORMAT_X500 = 5
-ADS_FORMAT_X500_NO_SERVER = 6
-ADS_FORMAT_X500_DN = 7
-ADS_FORMAT_X500_PARENT = 8
-ADS_FORMAT_SERVER = 9
-ADS_FORMAT_PROVIDER = 10
-ADS_FORMAT_LEAF = 11
-ADS_DISPLAY_FULL = 1
-ADS_DISPLAY_VALUE_ONLY = 2
-ADS_ESCAPEDMODE_DEFAULT = 1
-ADS_ESCAPEDMODE_ON = 2
-ADS_ESCAPEDMODE_OFF = 3
-ADS_ESCAPEDMODE_OFF_EX = 4
-ADS_PATH_FILE = 1
-ADS_PATH_FILESHARE = 2
-ADS_PATH_REGISTRY = 3
-ADS_SD_FORMAT_IID = 1
-ADS_SD_FORMAT_RAW = 2
-ADS_SD_FORMAT_HEXSTRING = 3
-
-
-# Generated by h2py from AdsErr.h
-def _HRESULT_TYPEDEF_(_sc):
-    return _sc
-
-
-E_ADS_BAD_PATHNAME = _HRESULT_TYPEDEF_((-2147463168))
-E_ADS_INVALID_DOMAIN_OBJECT = _HRESULT_TYPEDEF_((-2147463167))
-E_ADS_INVALID_USER_OBJECT = _HRESULT_TYPEDEF_((-2147463166))
-E_ADS_INVALID_COMPUTER_OBJECT = _HRESULT_TYPEDEF_((-2147463165))
-E_ADS_UNKNOWN_OBJECT = _HRESULT_TYPEDEF_((-2147463164))
-E_ADS_PROPERTY_NOT_SET = _HRESULT_TYPEDEF_((-2147463163))
-E_ADS_PROPERTY_NOT_SUPPORTED = _HRESULT_TYPEDEF_((-2147463162))
-E_ADS_PROPERTY_INVALID = _HRESULT_TYPEDEF_((-2147463161))
-E_ADS_BAD_PARAMETER = _HRESULT_TYPEDEF_((-2147463160))
-E_ADS_OBJECT_UNBOUND = _HRESULT_TYPEDEF_((-2147463159))
-E_ADS_PROPERTY_NOT_MODIFIED = _HRESULT_TYPEDEF_((-2147463158))
-E_ADS_PROPERTY_MODIFIED = _HRESULT_TYPEDEF_((-2147463157))
-E_ADS_CANT_CONVERT_DATATYPE = _HRESULT_TYPEDEF_((-2147463156))
-E_ADS_PROPERTY_NOT_FOUND = _HRESULT_TYPEDEF_((-2147463155))
-E_ADS_OBJECT_EXISTS = _HRESULT_TYPEDEF_((-2147463154))
-E_ADS_SCHEMA_VIOLATION = _HRESULT_TYPEDEF_((-2147463153))
-E_ADS_COLUMN_NOT_SET = _HRESULT_TYPEDEF_((-2147463152))
-S_ADS_ERRORSOCCURRED = _HRESULT_TYPEDEF_(0x00005011)
-S_ADS_NOMORE_ROWS = _HRESULT_TYPEDEF_(0x00005012)
-S_ADS_NOMORE_COLUMNS = _HRESULT_TYPEDEF_(0x00005013)
-E_ADS_INVALID_FILTER = _HRESULT_TYPEDEF_((-2147463148))
-
-# ADS_DEREFENUM enum
-ADS_DEREF_NEVER = 0
-ADS_DEREF_SEARCHING = 1
-ADS_DEREF_FINDING = 2
-ADS_DEREF_ALWAYS = 3
-
-# ADS_PREFERENCES_ENUM
-ADSIPROP_ASYNCHRONOUS = 0
-ADSIPROP_DEREF_ALIASES = 0x1
-ADSIPROP_SIZE_LIMIT = 0x2
-ADSIPROP_TIME_LIMIT = 0x3
-ADSIPROP_ATTRIBTYPES_ONLY = 0x4
-ADSIPROP_SEARCH_SCOPE = 0x5
-ADSIPROP_TIMEOUT = 0x6
-ADSIPROP_PAGESIZE = 0x7
-ADSIPROP_PAGED_TIME_LIMIT = 0x8
-ADSIPROP_CHASE_REFERRALS = 0x9
-ADSIPROP_SORT_ON = 0xA
-ADSIPROP_CACHE_RESULTS = 0xB
-ADSIPROP_ADSIFLAG = 0xC
-
-# ADSI_DIALECT_ENUM
-ADSI_DIALECT_LDAP = 0
-ADSI_DIALECT_SQL = 0x1
-
-# ADS_CHASE_REFERRALS_ENUM
-ADS_CHASE_REFERRALS_NEVER = 0
-ADS_CHASE_REFERRALS_SUBORDINATE = 0x20
-ADS_CHASE_REFERRALS_EXTERNAL = 0x40
-ADS_CHASE_REFERRALS_ALWAYS = (
-    ADS_CHASE_REFERRALS_SUBORDINATE | ADS_CHASE_REFERRALS_EXTERNAL
-)
-
-# Generated by h2py from ObjSel.h
-DSOP_SCOPE_TYPE_TARGET_COMPUTER = 0x00000001
-DSOP_SCOPE_TYPE_UPLEVEL_JOINED_DOMAIN = 0x00000002
-DSOP_SCOPE_TYPE_DOWNLEVEL_JOINED_DOMAIN = 0x00000004
-DSOP_SCOPE_TYPE_ENTERPRISE_DOMAIN = 0x00000008
-DSOP_SCOPE_TYPE_GLOBAL_CATALOG = 0x00000010
-DSOP_SCOPE_TYPE_EXTERNAL_UPLEVEL_DOMAIN = 0x00000020
-DSOP_SCOPE_TYPE_EXTERNAL_DOWNLEVEL_DOMAIN = 0x00000040
-DSOP_SCOPE_TYPE_WORKGROUP = 0x00000080
-DSOP_SCOPE_TYPE_USER_ENTERED_UPLEVEL_SCOPE = 0x00000100
-DSOP_SCOPE_TYPE_USER_ENTERED_DOWNLEVEL_SCOPE = 0x00000200
-DSOP_SCOPE_FLAG_STARTING_SCOPE = 0x00000001
-DSOP_SCOPE_FLAG_WANT_PROVIDER_WINNT = 0x00000002
-DSOP_SCOPE_FLAG_WANT_PROVIDER_LDAP = 0x00000004
-DSOP_SCOPE_FLAG_WANT_PROVIDER_GC = 0x00000008
-DSOP_SCOPE_FLAG_WANT_SID_PATH = 0x00000010
-DSOP_SCOPE_FLAG_WANT_DOWNLEVEL_BUILTIN_PATH = 0x00000020
-DSOP_SCOPE_FLAG_DEFAULT_FILTER_USERS = 0x00000040
-DSOP_SCOPE_FLAG_DEFAULT_FILTER_GROUPS = 0x00000080
-DSOP_SCOPE_FLAG_DEFAULT_FILTER_COMPUTERS = 0x00000100
-DSOP_SCOPE_FLAG_DEFAULT_FILTER_CONTACTS = 0x00000200
-DSOP_FILTER_INCLUDE_ADVANCED_VIEW = 0x00000001
-DSOP_FILTER_USERS = 0x00000002
-DSOP_FILTER_BUILTIN_GROUPS = 0x00000004
-DSOP_FILTER_WELL_KNOWN_PRINCIPALS = 0x00000008
-DSOP_FILTER_UNIVERSAL_GROUPS_DL = 0x00000010
-DSOP_FILTER_UNIVERSAL_GROUPS_SE = 0x00000020
-DSOP_FILTER_GLOBAL_GROUPS_DL = 0x00000040
-DSOP_FILTER_GLOBAL_GROUPS_SE = 0x00000080
-DSOP_FILTER_DOMAIN_LOCAL_GROUPS_DL = 0x00000100
-DSOP_FILTER_DOMAIN_LOCAL_GROUPS_SE = 0x00000200
-DSOP_FILTER_CONTACTS = 0x00000400
-DSOP_FILTER_COMPUTERS = 0x00000800
-DSOP_DOWNLEVEL_FILTER_USERS = -2147483647
-DSOP_DOWNLEVEL_FILTER_LOCAL_GROUPS = -2147483646
-DSOP_DOWNLEVEL_FILTER_GLOBAL_GROUPS = -2147483644
-DSOP_DOWNLEVEL_FILTER_COMPUTERS = -2147483640
-DSOP_DOWNLEVEL_FILTER_WORLD = -2147483632
-DSOP_DOWNLEVEL_FILTER_AUTHENTICATED_USER = -2147483616
-DSOP_DOWNLEVEL_FILTER_ANONYMOUS = -2147483584
-DSOP_DOWNLEVEL_FILTER_BATCH = -2147483520
-DSOP_DOWNLEVEL_FILTER_CREATOR_OWNER = -2147483392
-DSOP_DOWNLEVEL_FILTER_CREATOR_GROUP = -2147483136
-DSOP_DOWNLEVEL_FILTER_DIALUP = -2147482624
-DSOP_DOWNLEVEL_FILTER_INTERACTIVE = -2147481600
-DSOP_DOWNLEVEL_FILTER_NETWORK = -2147479552
-DSOP_DOWNLEVEL_FILTER_SERVICE = -2147475456
-DSOP_DOWNLEVEL_FILTER_SYSTEM = -2147467264
-DSOP_DOWNLEVEL_FILTER_EXCLUDE_BUILTIN_GROUPS = -2147450880
-DSOP_DOWNLEVEL_FILTER_TERMINAL_SERVER = -2147418112
-DSOP_DOWNLEVEL_FILTER_ALL_WELLKNOWN_SIDS = -2147352576
-DSOP_DOWNLEVEL_FILTER_LOCAL_SERVICE = -2147221504
-DSOP_DOWNLEVEL_FILTER_NETWORK_SERVICE = -2146959360
-DSOP_DOWNLEVEL_FILTER_REMOTE_LOGON = -2146435072
-DSOP_FLAG_MULTISELECT = 0x00000001
-DSOP_FLAG_SKIP_TARGET_COMPUTER_DC_CHECK = 0x00000002
-CFSTR_DSOP_DS_SELECTION_LIST = "CFSTR_DSOP_DS_SELECTION_LIST"
diff --git a/lib/win32comext/adsi/demos/objectPicker.py b/lib/win32comext/adsi/demos/objectPicker.py
deleted file mode 100644
index 5df42459..00000000
--- a/lib/win32comext/adsi/demos/objectPicker.py
+++ /dev/null
@@ -1,68 +0,0 @@
-# A demo for the IDsObjectPicker interface.
-import pythoncom
-import win32clipboard
-from win32com.adsi import adsi
-from win32com.adsi.adsicon import *
-
-cf_objectpicker = win32clipboard.RegisterClipboardFormat(CFSTR_DSOP_DS_SELECTION_LIST)
-
-
-def main():
-    hwnd = 0
-
-    # Create an instance of the object picker.
-    picker = pythoncom.CoCreateInstance(
-        adsi.CLSID_DsObjectPicker,
-        None,
-        pythoncom.CLSCTX_INPROC_SERVER,
-        adsi.IID_IDsObjectPicker,
-    )
-
-    # Create our scope init info.
-    siis = adsi.DSOP_SCOPE_INIT_INFOs(1)
-    sii = siis[0]
-
-    # Combine multiple scope types in a single array entry.
-
-    sii.type = (
-        DSOP_SCOPE_TYPE_UPLEVEL_JOINED_DOMAIN | DSOP_SCOPE_TYPE_DOWNLEVEL_JOINED_DOMAIN
-    )
-
-    # Set uplevel and downlevel filters to include only computer objects.
-    # Uplevel filters apply to both mixed and native modes.
-    # Notice that the uplevel and downlevel flags are different.
-
-    sii.filterFlags.uplevel.bothModes = DSOP_FILTER_COMPUTERS
-    sii.filterFlags.downlevel = DSOP_DOWNLEVEL_FILTER_COMPUTERS
-
-    # Initialize the interface.
-    picker.Initialize(
-        None,  # Target is the local computer.
-        siis,  # scope infos
-        DSOP_FLAG_MULTISELECT,  # options
-        ("objectGUID", "displayName"),
-    )  # attributes to fetch
-
-    do = picker.InvokeDialog(hwnd)
-    # Extract the data from the IDataObject.
-    format_etc = (
-        cf_objectpicker,
-        None,
-        pythoncom.DVASPECT_CONTENT,
-        -1,
-        pythoncom.TYMED_HGLOBAL,
-    )
-    medium = do.GetData(format_etc)
-    data = adsi.StringAsDS_SELECTION_LIST(medium.data)
-    for item in data:
-        name, klass, adspath, upn, attrs, flags = item
-        print("Item", name)
-        print(" Class:", klass)
-        print(" AdsPath:", adspath)
-        print(" UPN:", upn)
-        print(" Attrs:", attrs)
-        print(" Flags:", flags)
-
-
-if __name__ == "__main__":
-    main()
diff --git a/lib/win32comext/adsi/demos/scp.py b/lib/win32comext/adsi/demos/scp.py
deleted file mode 100644
index d1a4ca05..00000000
--- a/lib/win32comext/adsi/demos/scp.py
+++ /dev/null
@@ -1,565 +0,0 @@
-"""A re-implementation of the MS DirectoryService samples related to services.
-
-* Adds and removes an ActiveDirectory "Service Connection Point",
-  including managing the security on the object.
-* Creates and registers Service Principal Names.
-* Changes the username for a domain user.
-
-Some of these functions are likely to become move to a module - but there
-is also a little command-line-interface to try these functions out.
-
-For example:
-
-scp.py --account-name=domain\\user --service-class=PythonScpTest \\
-       --keyword=foo --keyword=bar --binding-string=bind_info \\
-       ScpCreate SpnCreate SpnRegister
-
-would:
-* Attempt to delete a Service Connection Point for the service class
-  'PythonScpTest'
-* Attempt to create a Service Connection Point for that class, with 2
-  keywords and a binding string of 'bind_info'
-* Create a Service Principal Name for the service and register it
-
-to undo those changes, you could execute:
-
-scp.py --account-name=domain\\user --service-class=PythonScpTest \\
-       SpnCreate SpnUnregister ScpDelete
-
-which will:
-* Create a SPN
-* Unregister that SPN from the Active Directory.
-* Delete the Service Connection Point
-
-Executing with --test will create and remove one of everything.
-"""
-
-import optparse
-import textwrap
-import traceback
-
-import ntsecuritycon as dscon
-import win32api
-import win32con
-import win32security
-import winerror
-from win32com.adsi import adsi
-from win32com.adsi.adsicon import *
-from win32com.client import Dispatch
-
-verbose = 1
-g_createdSCP = None
-g_createdSPNs = []
-g_createdSPNLast = None
-
-import logging
-
-logger = logging  # use logging module global methods for now.
-
-# still a bit confused about log(n, ...) vs logger.info/debug()
-
-
-# Returns distinguished name of SCP.
-def ScpCreate(
-    service_binding_info,
-    service_class_name,  # Service class string to store in SCP.
-    account_name=None,  # Logon account that needs access to SCP.
-    container_name=None,
-    keywords=None,
-    object_class="serviceConnectionPoint",
-    dns_name_type="A",
-    dn=None,
-    dns_name=None,
-):
-    container_name = container_name or service_class_name
-    if not dns_name:
-        # Get the DNS name of the local computer
-        dns_name = win32api.GetComputerNameEx(win32con.ComputerNameDnsFullyQualified)
-    # Get the distinguished name of the computer object for the local computer
-    if dn is None:
-        dn = win32api.GetComputerObjectName(win32con.NameFullyQualifiedDN)
-
-    # Compose the ADSpath and bind to the computer object for the local computer
-    comp = adsi.ADsGetObject("LDAP://" + dn, adsi.IID_IDirectoryObject)
-
-    # Publish the SCP as a child of the computer object
-    keywords = keywords or []
-    # Fill in the attribute values to be stored in the SCP.
-    attrs = [
-        ("cn", ADS_ATTR_UPDATE, ADSTYPE_CASE_IGNORE_STRING, (container_name,)),
-        ("objectClass", ADS_ATTR_UPDATE, ADSTYPE_CASE_IGNORE_STRING, (object_class,)),
-        ("keywords", ADS_ATTR_UPDATE, ADSTYPE_CASE_IGNORE_STRING, keywords),
-        ("serviceDnsName", ADS_ATTR_UPDATE, ADSTYPE_CASE_IGNORE_STRING, (dns_name,)),
-        (
-            "serviceDnsNameType",
-            ADS_ATTR_UPDATE,
-            ADSTYPE_CASE_IGNORE_STRING,
-            (dns_name_type,),
-        ),
-        (
-            "serviceClassName",
-            ADS_ATTR_UPDATE,
-            ADSTYPE_CASE_IGNORE_STRING,
-            (service_class_name,),
-        ),
-        (
-            "serviceBindingInformation",
-            ADS_ATTR_UPDATE,
-            ADSTYPE_CASE_IGNORE_STRING,
-            (service_binding_info,),
-        ),
-    ]
-    new = comp.CreateDSObject("cn=" + container_name, attrs)
-    logger.info("New connection point is at %s", container_name)
-    # Wrap in a usable IDispatch object.
-    new = Dispatch(new)
-    # And allow access to the SCP for the specified account name
-    AllowAccessToScpProperties(account_name, new)
-    return new
-
-
-def ScpDelete(container_name, dn=None):
-    if dn is None:
-        dn = win32api.GetComputerObjectName(win32con.NameFullyQualifiedDN)
-    logger.debug("Removing connection point '%s' from %s", container_name, dn)
-
-    # Compose the ADSpath and bind to the computer object for the local computer
-    comp = adsi.ADsGetObject("LDAP://" + dn, adsi.IID_IDirectoryObject)
-    comp.DeleteDSObject("cn=" + container_name)
-    logger.info("Deleted service connection point '%s'", container_name)
-
-
-# This function is described in detail in the MSDN article titled
-# "Enabling Service Account to Access SCP Properties"
-# From that article:
-# The following sample code sets a pair of ACEs on a service connection point
-# (SCP) object. The ACEs grant read/write access to the user or computer account
-# under which the service instance will be running. Your service installation
-# program calls this code to ensure that the service will be allowed to update
-# its properties at run time. If you don't set ACEs like these, your service
-# will get access-denied errors if it tries to modify the SCP's properties.
-#
-# The code uses the IADsSecurityDescriptor, IADsAccessControlList, and
-# IADsAccessControlEntry interfaces to do the following:
-# * Get the SCP object's security descriptor.
-# * Set ACEs in the DACL of the security descriptor.
-# * Set the security descriptor back on the SCP object.
-
-
-def AllowAccessToScpProperties(
-    accountSAM,  # Service account to allow access.
-    scpObject,  # The IADs SCP object.
-    schemaIDGUIDs=(  # Attributes to allow write-access to.
-        "{28630eb8-41d5-11d1-a9c1-0000f80367c1}",  # serviceDNSName
-        "{b7b1311c-b82e-11d0-afee-0000f80367c1}",  # serviceBindingInformation
-    ),
-):
-    # If no service account is specified, service runs under LocalSystem.
-    # So allow access to the computer account of the service's host.
-    if accountSAM:
-        trustee = accountSAM
-    else:
-        # Get the SAM account name of the computer object for the server.
-        trustee = win32api.GetComputerObjectName(win32con.NameSamCompatible)
-
-    # Get the nTSecurityDescriptor attribute
-    attribute = "nTSecurityDescriptor"
-    sd = getattr(scpObject, attribute)
-    acl = sd.DiscretionaryAcl
-
-    for sguid in schemaIDGUIDs:
-        ace = Dispatch(adsi.CLSID_AccessControlEntry)
-
-        # Set the properties of the ACE.
-        # Allow read and write access to the property.
-        ace.AccessMask = ADS_RIGHT_DS_READ_PROP | ADS_RIGHT_DS_WRITE_PROP
-
-        # Set the trustee, which is either the service account or the
-        # host computer account.
-        ace.Trustee = trustee
-
-        # Set the ACE type.
-        ace.AceType = ADS_ACETYPE_ACCESS_ALLOWED_OBJECT
-
-        # Set AceFlags to zero because ACE is not inheritable.
-        ace.AceFlags = 0
-
-        # Set Flags to indicate an ACE that protects a specified object.
-        ace.Flags = ADS_FLAG_OBJECT_TYPE_PRESENT
-
-        # Set ObjectType to the schemaIDGUID of the attribute.
-        ace.ObjectType = sguid
-
-        # Add the ACEs to the DACL.
-        acl.AddAce(ace)
-
-    # Write the modified DACL back to the security descriptor.
-    sd.DiscretionaryAcl = acl
-    # Write the ntSecurityDescriptor property to the property cache.
-    setattr(scpObject, attribute, sd)
-    # SetInfo updates the SCP object in the directory.
-    scpObject.SetInfo()
-    logger.info("Set security on object for account '%s'" % (trustee,))
-
-
-# Service Principal Names functions from the same sample.
-# The example calls the DsWriteAccountSpn function, which stores the SPNs in
-# Microsoft Active Directory under the servicePrincipalName attribute of the
-# account object specified by the serviceAcctDN parameter. The account object
-# corresponds to the logon account specified in the CreateService call for this
-# service instance. If the logon account is a domain user account,
-# serviceAcctDN must be the distinguished name of the account object in
-# Active Directory for that user account. If the service's logon account is the
-# LocalSystem account, serviceAcctDN must be the distinguished name of the
-# computer account object for the host computer on which the service is
-# installed. win32api.TranslateNames and win32security.DsCrackNames can
-# be used to convert a domain\account format name to a distinguished name.
-def SpnRegister(
-    serviceAcctDN,  # DN of the service's logon account
-    spns,  # List of SPNs to register
-    operation,  # Add, replace, or delete SPNs
-):
-    assert type(spns) not in [str, str] and hasattr(spns, "__iter__"), (
-        "spns must be a sequence of strings (got %r)" % spns
-    )
-    # Bind to a domain controller.
-    # Get the domain for the current user.
-    samName = win32api.GetUserNameEx(win32api.NameSamCompatible)
-    samName = samName.split("\\", 1)[0]
-
-    if not serviceAcctDN:
-        # Get the SAM account name of the computer object for the server.
-        serviceAcctDN = win32api.GetComputerObjectName(win32con.NameFullyQualifiedDN)
-    logger.debug("SpnRegister using DN '%s'", serviceAcctDN)
-
-    # Get the name of a domain controller in that domain.
-    info = win32security.DsGetDcName(
-        domainName=samName,
-        flags=dscon.DS_IS_FLAT_NAME
-        | dscon.DS_RETURN_DNS_NAME
-        | dscon.DS_DIRECTORY_SERVICE_REQUIRED,
-    )
-    # Bind to the domain controller.
-    handle = win32security.DsBind(info["DomainControllerName"])
-
-    # Write the SPNs to the service account or computer account.
-    logger.debug("DsWriteAccountSpn with spns %s")
-    win32security.DsWriteAccountSpn(
-        handle,  # handle to the directory
-        operation,  # Add or remove SPN from account's existing SPNs
-        serviceAcctDN,  # DN of service account or computer account
-        spns,
-    )  # names
-
-    # Unbind the DS in any case (but Python would do it anyway)
-    handle.Close()
-
-
-def UserChangePassword(username_dn, new_password):
-    # set the password on the account.
-    # Use the distinguished name to bind to the account object.
-    accountPath = "LDAP://" + username_dn
-    user = adsi.ADsGetObject(accountPath, adsi.IID_IADsUser)
-
-    # Set the password on the account.
-    user.SetPassword(new_password)
-
-
-# functions related to the command-line interface
-def log(level, msg, *args):
-    if verbose >= level:
-        print(msg % args)
-
-
-class _NoDefault:
-    pass
-
-
-def _get_option(po, opt_name, default=_NoDefault):
-    parser, options = po
-    ret = getattr(options, opt_name, default)
-    if not ret and default is _NoDefault:
-        parser.error("The '%s' option must be specified for this operation" % opt_name)
-    if not ret:
-        ret = default
-    return ret
-
-
-def _option_error(po, why):
-    parser = po[0]
-    parser.error(why)
-
-
-def do_ScpCreate(po):
-    """Create a Service Connection Point"""
-    global g_createdSCP
-    scp = ScpCreate(
-        _get_option(po, "binding_string"),
-        _get_option(po, "service_class"),
-        _get_option(po, "account_name_sam", None),
-        keywords=_get_option(po, "keywords", None),
-    )
-    g_createdSCP = scp
-    return scp.distinguishedName
-
-
-def do_ScpDelete(po):
-    """Delete a Service Connection Point"""
-    sc = _get_option(po, "service_class")
-    try:
-        ScpDelete(sc)
-    except adsi.error as details:
-        if details[0] != winerror.ERROR_DS_OBJ_NOT_FOUND:
-            raise
-        log(2, "ScpDelete ignoring ERROR_DS_OBJ_NOT_FOUND for service-class '%s'", sc)
-    return sc
-
-
-def do_SpnCreate(po):
-    """Create a Service Principal Name"""
-    # The 'service name' is the dn of our scp.
-    if g_createdSCP is None:
-        # Could accept an arg to avoid this?
-        _option_error(po, "ScpCreate must have been specified before SpnCreate")
-    # Create a Service Principal Name"
-    spns = win32security.DsGetSpn(
-        dscon.DS_SPN_SERVICE,
-        _get_option(po, "service_class"),
-        g_createdSCP.distinguishedName,
-        _get_option(po, "port", 0),
-        None,
-        None,
-    )
-    spn = spns[0]
-    log(2, "Created SPN: %s", spn)
-    global g_createdSPNLast
-    g_createdSPNLast = spn
-    g_createdSPNs.append(spn)
-    return spn
-
-
-def do_SpnRegister(po):
-    """Register a previously created Service Principal Name"""
-    if not g_createdSPNLast:
-        _option_error(po, "SpnCreate must appear before SpnRegister")
-
-    SpnRegister(
-        _get_option(po, "account_name_dn", None),
-        (g_createdSPNLast,),
-        dscon.DS_SPN_ADD_SPN_OP,
-    )
-    return g_createdSPNLast
-
-
-def do_SpnUnregister(po):
-    """Unregister a previously created Service Principal Name"""
-    if not g_createdSPNLast:
-        _option_error(po, "SpnCreate must appear before SpnUnregister")
-    SpnRegister(
-        _get_option(po, "account_name_dn", None),
-        (g_createdSPNLast,),
-        dscon.DS_SPN_DELETE_SPN_OP,
-    )
-    return g_createdSPNLast
-
-
-def do_UserChangePassword(po):
-    """Change the password for a specified user"""
-    UserChangePassword(_get_option(po, "account_name_dn"), _get_option(po, "password"))
-    return "Password changed OK"
-
-
-handlers = (
-    ("ScpCreate", do_ScpCreate),
-    ("ScpDelete", do_ScpDelete),
-    ("SpnCreate", do_SpnCreate),
-    ("SpnRegister", do_SpnRegister),
-    ("SpnUnregister", do_SpnUnregister),
-    ("UserChangePassword", do_UserChangePassword),
-)
-
-
-class HelpFormatter(optparse.IndentedHelpFormatter):
-    def format_description(self, description):
-        return description
-
-
-def main():
-    global verbose
-    _handlers_dict = {}
-
-    arg_descs = []
-    for arg, func in handlers:
-        this_desc = "\n".join(textwrap.wrap(func.__doc__, subsequent_indent=" " * 8))
-        arg_descs.append("  %s: %s" % (arg, this_desc))
-        _handlers_dict[arg.lower()] = func
-
-    description = __doc__ + "\ncommands:\n" + "\n".join(arg_descs) + "\n"
-
-    parser = optparse.OptionParser(
-        usage="%prog [options] command ...",
-        description=description,
-        formatter=HelpFormatter(),
-    )
-
-    parser.add_option(
-        "-v",
-        action="count",
-        dest="verbose",
-        default=1,
-        help="increase the verbosity of status messages",
-    )
-
-    parser.add_option(
-        "-q", "--quiet", action="store_true", help="Don't print any status messages"
-    )
-
-    parser.add_option(
-        "-t",
-        "--test",
-        action="store_true",
-        help="Execute a mini-test suite, providing defaults for most options and args",
-    ),
-
-    parser.add_option(
-        "",
-        "--show-tracebacks",
-        action="store_true",
-        help="Show the tracebacks for any exceptions",
-    )
-
-    parser.add_option("", "--service-class", help="The service class name to use")
-
-    parser.add_option(
-        "", "--port", default=0, help="The port number to associate with the SPN"
-    )
-
-    parser.add_option(
-        "", "--binding-string", help="The binding string to use for SCP creation"
-    )
-
-    parser.add_option(
-        "", "--account-name", help="The account name to use (default is LocalSystem)"
-    )
-
-    parser.add_option("", "--password", help="The password to set.")
-
-    parser.add_option(
-        "",
-        "--keyword",
-        action="append",
-        dest="keywords",
-        help="""A keyword to add to the SCP.  May be specified
-                              multiple times""",
-    )
-
-    parser.add_option(
-        "",
-        "--log-level",
-        help="""The log-level to use - may be a number or a logging
-                             module constant""",
-        default=str(logging.WARNING),
-    )
-
-    options, args = parser.parse_args()
-    po = (parser, options)
-    # fixup misc
-    try:
-        options.port = int(options.port)
-    except (TypeError, ValueError):
-        parser.error("--port must be numeric")
-    # fixup log-level
-    try:
-        log_level = int(options.log_level)
-    except (TypeError, ValueError):
-        try:
-            log_level = int(getattr(logging, options.log_level.upper()))
-        except (ValueError, TypeError, AttributeError):
-            parser.error("Invalid --log-level value")
-    try:
-        sl = logger.setLevel
-        # logger is a real logger
-    except AttributeError:
-        # logger is logging module
-        sl = logging.getLogger().setLevel
-    sl(log_level)
-    # Check -q/-v
-    if options.quiet and options.verbose:
-        parser.error("Can't specify --quiet and --verbose")
-    if options.quiet:
-        options.verbose -= 1
-    verbose = options.verbose
-    # --test
-    if options.test:
-        if args:
-            parser.error("Can't specify args with --test")
-
-        args = "ScpDelete ScpCreate SpnCreate SpnRegister SpnUnregister ScpDelete"
-        log(1, "--test - pretending args are:\n %s", args)
-        args = args.split()
-        if not options.service_class:
-            options.service_class = "PythonScpTest"
-            log(2, "--test: --service-class=%s", options.service_class)
-        if not options.keywords:
-            options.keywords = "Python Powered".split()
-            log(2, "--test: --keyword=%s", options.keywords)
-        if not options.binding_string:
-            options.binding_string = "test binding string"
-            log(2, "--test: --binding-string=%s", options.binding_string)
-
-    # check args
-    if not args:
-        parser.error("No command specified (use --help for valid commands)")
-    for arg in args:
-        if arg.lower() not in _handlers_dict:
-            parser.error("Invalid command '%s' (use --help for valid commands)" % arg)
-
-    # Patch up account-name.
-    if options.account_name:
-        log(2, "Translating account name '%s'", options.account_name)
-        options.account_name_sam = win32security.TranslateName(
-            options.account_name, win32api.NameUnknown, win32api.NameSamCompatible
-        )
-        log(2, "NameSamCompatible is '%s'", options.account_name_sam)
-        options.account_name_dn = win32security.TranslateName(
-            options.account_name, win32api.NameUnknown, win32api.NameFullyQualifiedDN
-        )
-        log(2, "NameFullyQualifiedDNis '%s'", options.account_name_dn)
-
-    # do it.
-    for arg in args:
-        handler = _handlers_dict[arg.lower()]  # already been validated
-        if handler is None:
-            parser.error("Invalid command '%s'" % arg)
-        err_msg = None
-        try:
-            try:
-                log(2, "Executing '%s'...", arg)
-                result = handler(po)
-                log(1, "%s: %s", arg, result)
-            except:
-                if options.show_tracebacks:
-                    print("--show-tracebacks specified - dumping exception")
-                    traceback.print_exc()
-                raise
-        except adsi.error as xxx_todo_changeme:
-            (hr, desc, exc, argerr) = xxx_todo_changeme.args
-            if exc:
-                extra_desc = exc[2]
-            else:
-                extra_desc = ""
-            err_msg = desc
-            if extra_desc:
-                err_msg += "\n\t" + extra_desc
-        except win32api.error as xxx_todo_changeme1:
-            (hr, func, msg) = xxx_todo_changeme1.args
-            err_msg = msg
-        if err_msg:
-            log(1, "Command '%s' failed: %s", arg, err_msg)
-
-
-if __name__ == "__main__":
-    try:
-        main()
-    except KeyboardInterrupt:
-        print("*** Interrupted")
diff --git a/lib/win32comext/adsi/demos/search.py b/lib/win32comext/adsi/demos/search.py
deleted file mode 100644
index 22c6a258..00000000
--- a/lib/win32comext/adsi/demos/search.py
+++ /dev/null
@@ -1,152 +0,0 @@
-import pythoncom
-import pywintypes
-import win32security
-from win32com.adsi import adsi, adsicon
-from win32com.adsi.adsicon import *
-
-options = None  # set to optparse options object
-
-ADsTypeNameMap = {}
-
-
-def getADsTypeName(type_val):
-    # convert integer type to the 'typename' as known in the headerfiles.
-    if not ADsTypeNameMap:
-        for n, v in adsicon.__dict__.items():
-            if n.startswith("ADSTYPE_"):
-                ADsTypeNameMap[v] = n
-    return ADsTypeNameMap.get(type_val, hex(type_val))
-
-
-def _guid_from_buffer(b):
-    return pywintypes.IID(b, True)
-
-
-def _sid_from_buffer(b):
-    return str(pywintypes.SID(b))
-
-
-_null_converter = lambda x: x
-
-converters = {
-    "objectGUID": _guid_from_buffer,
-    "objectSid": _sid_from_buffer,
-    "instanceType": getADsTypeName,
-}
-
-
-def log(level, msg, *args):
-    if options.verbose >= level:
-        print("log:", msg % args)
-
-
-def getGC():
-    cont = adsi.ADsOpenObject(
-        "GC:", options.user, options.password, 0, adsi.IID_IADsContainer
-    )
-    enum = adsi.ADsBuildEnumerator(cont)
-    # Only 1 child of the global catalog.
-    for e in enum:
-        gc = e.QueryInterface(adsi.IID_IDirectorySearch)
-        return gc
-    return None
-
-
-def print_attribute(col_data):
-    prop_name, prop_type, values = col_data
-    if values is not None:
-        log(2, "property '%s' has type '%s'", prop_name, getADsTypeName(prop_type))
-        value = [converters.get(prop_name, _null_converter)(v[0]) for v in values]
-        if len(value) == 1:
-            value = value[0]
-        print(" %s=%r" % (prop_name, value))
-    else:
-        print(" %s is None" % (prop_name,))
-
-
-def search():
-    gc = getGC()
-    if gc is None:
-        log(0, "Can't find the global catalog")
-        return
-
-    prefs = [(ADS_SEARCHPREF_SEARCH_SCOPE, (ADS_SCOPE_SUBTREE,))]
-    hr, statuses = gc.SetSearchPreference(prefs)
-    log(3, "SetSearchPreference returned %d/%r", hr, statuses)
-
-    if options.attributes:
-        attributes = options.attributes.split(",")
-    else:
-        attributes = None
-
-    h = gc.ExecuteSearch(options.filter, attributes)
-    hr = gc.GetNextRow(h)
-    while hr != S_ADS_NOMORE_ROWS:
-        print("-- new row --")
-        if attributes is None:
-            # Loop over all columns returned
-            while 1:
-                col_name = gc.GetNextColumnName(h)
-                if col_name is None:
-                    break
-                data = gc.GetColumn(h, col_name)
-                print_attribute(data)
-        else:
-            # loop over attributes specified.
-            for a in attributes:
-                try:
-                    data = gc.GetColumn(h, a)
-                    print_attribute(data)
-                except adsi.error as details:
-                    if details[0] != E_ADS_COLUMN_NOT_SET:
-                        raise
-                    print_attribute((a, None, None))
-        hr = gc.GetNextRow(h)
-    gc.CloseSearchHandle(h)
-
-
-def main():
-    global options
-    from optparse import OptionParser
-
-    parser = OptionParser()
-    parser.add_option(
-        "-f", "--file", dest="filename", help="write report to FILE", metavar="FILE"
-    )
-    parser.add_option(
-        "-v",
-        "--verbose",
-        action="count",
-        default=1,
-        help="increase verbosity of output",
-    )
-    parser.add_option(
-        "-q", "--quiet", action="store_true", help="suppress output messages"
-    )
-
-    parser.add_option("-U", "--user", help="specify the username used to connect")
-    parser.add_option("-P", "--password", help="specify the password used to connect")
-    parser.add_option(
-        "",
-        "--filter",
-        default="(&(objectCategory=person)(objectClass=User))",
-        help="specify the search filter",
-    )
-    parser.add_option(
-        "", "--attributes", help="comma sep'd list of attribute names to print"
-    )
-
-    options, args = parser.parse_args()
-    if options.quiet:
-        if options.verbose != 1:
-            parser.error("Can not use '--verbose' and '--quiet'")
-        options.verbose = 0
-
-    if args:
-        parser.error("You need not specify args")
-
-    search()
-
-
-if __name__ == "__main__":
-    main()
diff --git a/lib/win32comext/adsi/demos/test.py b/lib/win32comext/adsi/demos/test.py
deleted file mode 100644
index a1dba34d..00000000
--- a/lib/win32comext/adsi/demos/test.py
+++ /dev/null
@@ -1,273 +0,0 @@
-import string
-import sys
-
-import pythoncom
-import win32api
-from win32com.adsi import *
-
-verbose_level = 0
-
-server = ""  # Must have trailing /
-local_name = win32api.GetComputerName()
-
-
-def DumpRoot():
-    "Dumps the root DSE"
-    path = "LDAP://%srootDSE" % server
-    rootdse = ADsGetObject(path)
-
-    for item in rootdse.Get("SupportedLDAPVersion"):
-        print("%s supports ldap version %s" % (path, item))
-
-    attributes = ["CurrentTime", "defaultNamingContext"]
-    for attr in attributes:
-        val = rootdse.Get(attr)
-        print(" %s=%s" % (attr, val))
-
-
-###############################################
-#
-# Code taken from article titled:
-# Reading attributeSchema and classSchema Objects
-def _DumpClass(child):
-    attrs = "Abstract lDAPDisplayName schemaIDGUID schemaNamingContext attributeSyntax oMSyntax"
-    _DumpTheseAttributes(child, string.split(attrs))
-
-
-def _DumpAttribute(child):
-    attrs = "lDAPDisplayName schemaIDGUID adminDescription adminDisplayName rDNAttID defaultHidingValue defaultObjectCategory systemOnly defaultSecurityDescriptor"
-    _DumpTheseAttributes(child, string.split(attrs))
-
-
-def _DumpTheseAttributes(child, attrs):
-    for attr in attrs:
-        try:
-            val = child.Get(attr)
-        except pythoncom.com_error as details:
-            continue
-            # ###
-            (hr, msg, exc, arg) = details
-            if exc and exc[2]:
-                msg = exc[2]
-            val = "<Error: %s>" % (msg,)
-        if verbose_level >= 2:
-            print(" %s: %s=%s" % (child.Class, attr, val))
-
-
-def DumpSchema():
-    "Dumps the default DSE schema"
-    # Bind to rootDSE to get the schemaNamingContext property.
-    path = "LDAP://%srootDSE" % server
-    rootdse = ADsGetObject(path)
-    name = rootdse.Get("schemaNamingContext")
-
-    # Bind to the actual schema container.
-    path = "LDAP://" + server + name
-    print("Binding to", path)
-    ob = ADsGetObject(path)
-    nclasses = nattr = nsub = nunk = 0
-
-    # Enumerate the attribute and class objects in the schema container.
-    for child in ob:
-        # Find out if this is a class, attribute, or subSchema object.
-        class_name = child.Class
-        if class_name == "classSchema":
-            _DumpClass(child)
-            nclasses = nclasses + 1
-        elif class_name == "attributeSchema":
-            _DumpAttribute(child)
-            nattr = nattr + 1
-        elif class_name == "subSchema":
-            nsub = nsub + 1
-        else:
-            print("Unknown class:", class_name)
-            nunk = nunk + 1
-    if verbose_level:
-        print("Processed", nclasses, "classes")
-        print("Processed", nattr, "attributes")
-        print("Processed", nsub, "sub-schema's")
-        print("Processed", nunk, "unknown types")
-
-
-def _DumpObject(ob, level=0):
-    prefix = "  " * level
-    print("%s%s object: %s" % (prefix, ob.Class, ob.Name))
-    # Do the directory object thing
-    try:
-        dir_ob = ADsGetObject(ob.ADsPath, IID_IDirectoryObject)
-    except pythoncom.com_error:
-        dir_ob = None
-    if dir_ob is not None:
-        info = dir_ob.GetObjectInformation()
-        print("%s RDN='%s', ObjectDN='%s'" % (prefix, info.RDN, info.ObjectDN))
-        # Create a list of names to fetch
-        names = ["distinguishedName"]
-        attrs = dir_ob.GetObjectAttributes(names)
-        for attr in attrs:
-            for val, typ in attr.Values:
-                print("%s Attribute '%s' = %s" % (prefix, attr.AttrName, val))
-
-    for child in ob:
-        _DumpObject(child, level + 1)
-
-
-def DumpAllObjects():
-    "Recursively dump the entire directory!"
-    path = "LDAP://%srootDSE" % server
-    rootdse = ADsGetObject(path)
-    name = rootdse.Get("defaultNamingContext")
-
-    # Bind to the actual schema container.
-    path = "LDAP://" + server + name
-    print("Binding to", path)
-    ob = ADsGetObject(path)
-
-    # Enumerate the attribute and class objects in the schema container.
-    _DumpObject(ob)
-
-
-##########################################################
-#
-# Code taken from article:
-# Example Code for Enumerating Schema Classes, Attributes, and Syntaxes
-
-# Fill a map with VT_ datatypes, to give us better names:
-vt_map = {}
-for name, val in pythoncom.__dict__.items():
-    if name[:3] == "VT_":
-        vt_map[val] = name
-
-
-def DumpSchema2():
-    "Dumps the schema using an alternative technique"
-    path = "LDAP://%sschema" % (server,)
-    schema = ADsGetObject(path, IID_IADsContainer)
-    nclass = nprop = nsyntax = 0
-    for item in schema:
-        item_class = string.lower(item.Class)
-        if item_class == "class":
-            items = []
-            if item.Abstract:
-                items.append("Abstract")
-            if item.Auxiliary:
-                items.append("Auxiliary")
-            # 			if item.Structural: items.append("Structural")
-            desc = string.join(items, ", ")
-            import win32com.util
-
-            iid_name = win32com.util.IIDToInterfaceName(item.PrimaryInterface)
-            if verbose_level >= 2:
-                print(
-                    "Class: Name=%s, Flags=%s, Primary Interface=%s"
-                    % (item.Name, desc, iid_name)
-                )
-            nclass = nclass + 1
-        elif item_class == "property":
-            if item.MultiValued:
-                val_type = "Multi-Valued"
-            else:
-                val_type = "Single-Valued"
-            if verbose_level >= 2:
-                print("Property: Name=%s, %s" % (item.Name, val_type))
-            nprop = nprop + 1
-        elif item_class == "syntax":
-            data_type = vt_map.get(item.OleAutoDataType, "<unknown type>")
-            if verbose_level >= 2:
-                print("Syntax: Name=%s, Datatype = %s" % (item.Name, data_type))
-            nsyntax = nsyntax + 1
-    if verbose_level >= 1:
-        print("Processed", nclass, "classes")
-        print("Processed", nprop, "properties")
-        print("Processed", nsyntax, "syntax items")
-
-
-def DumpGC():
-    "Dumps the GC: object (whatever that is!)"
-    ob = ADsGetObject("GC:", IID_IADsContainer)
-    for sub_ob in ob:
-        print("GC ob: %s (%s)" % (sub_ob.Name, sub_ob.ADsPath))
-
-
-def DumpLocalUsers():
-    "Dumps the local machine users"
-    path = "WinNT://%s,computer" % (local_name,)
-    ob = ADsGetObject(path, IID_IADsContainer)
-    ob.put_Filter(["User", "Group"])
-    for sub_ob in ob:
-        print("User/Group: %s (%s)" % (sub_ob.Name, sub_ob.ADsPath))
-
-
-def DumpLocalGroups():
-    "Dumps the local machine groups"
-    path = "WinNT://%s,computer" % (local_name,)
-    ob = ADsGetObject(path, IID_IADsContainer)
-
-    ob.put_Filter(["Group"])
-    for sub_ob in ob:
-        print("Group: %s (%s)" % (sub_ob.Name, sub_ob.ADsPath))
-        # get the members
-        members = sub_ob.Members()
-        for member in members:
-            print("  Group member: %s (%s)" % (member.Name, member.ADsPath))
-
-
-def usage(tests):
-    import os
-
-    print("Usage: %s [-s server ] [-v] [Test ...]" % os.path.basename(sys.argv[0]))
-    print("  -v : Verbose - print more information")
-    print("  -s : server - execute the tests against the named server")
-    print("where Test is one of:")
-    for t in tests:
-        print(t.__name__, ":", t.__doc__)
-    print()
-    print("If not tests are specified, all tests are run")
-    sys.exit(1)
-
-
-def main():
-    import getopt
-    import traceback
-
-    tests = []
-    for ob in globals().values():
-        if type(ob) == type(main) and ob.__doc__:
-            tests.append(ob)
-    opts, args = getopt.getopt(sys.argv[1:], "s:hv")
-    for opt, val in opts:
-        if opt == "-s":
-            if val[-1] not in "\\/":
-                val = val + "/"
-            global server
-            server = val
-        if opt == "-h":
-            usage(tests)
-        if opt == "-v":
-            global verbose_level
-            verbose_level = verbose_level + 1
-
-    if len(args) == 0:
-        print("Running all tests - use '-h' to see command-line options...")
-        dotests = tests
-    else:
-        dotests = []
-        for arg in args:
-            for t in tests:
-                if t.__name__ == arg:
-                    dotests.append(t)
-                    break
-            else:
-                print("Test '%s' unknown - skipping" % arg)
-    if not len(dotests):
-        print("Nothing to do!")
-        usage(tests)
-    for test in dotests:
-        try:
-            test()
-        except:
-            print("Test %s failed" % test.__name__)
-            traceback.print_exc()
-
-
-if __name__ == "__main__":
-    main()
diff --git a/lib/win32comext/authorization/__init__.py b/lib/win32comext/authorization/__init__.py
deleted file mode 100644
index 3a893267..00000000
--- a/lib/win32comext/authorization/__init__.py
+++ /dev/null
@@ -1,6 +0,0 @@
-# This is a python package
-# __PackageSupportBuildPath__ not needed for distutil based builds,
-# but not everyone is there yet.
-import win32com
-
-win32com.__PackageSupportBuildPath__(__path__)
diff --git a/lib/win32comext/authorization/authorization.pyd b/lib/win32comext/authorization/authorization.pyd
deleted file mode 100644
index 4c473bd0baf49054bdcf5e64324cf0bc383a3c9b..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 29696
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
J_WTz#@E_GUC+h$J

diff --git a/lib/win32comext/authorization/demos/EditSecurity.py b/lib/win32comext/authorization/demos/EditSecurity.py
deleted file mode 100644
index d961bc0d..00000000
--- a/lib/win32comext/authorization/demos/EditSecurity.py
+++ /dev/null
@@ -1,255 +0,0 @@
-import os
-
-import ntsecuritycon
-import pythoncom
-import win32api
-import win32com.server.policy
-import win32con
-import win32security
-from ntsecuritycon import (
-    CONTAINER_INHERIT_ACE,
-    FILE_ALL_ACCESS,
-    FILE_APPEND_DATA,
-    FILE_GENERIC_EXECUTE,
-    FILE_GENERIC_READ,
-    FILE_GENERIC_WRITE,
-    FILE_READ_ATTRIBUTES,
-    FILE_READ_DATA,
-    FILE_READ_EA,
-    FILE_WRITE_ATTRIBUTES,
-    FILE_WRITE_DATA,
-    FILE_WRITE_EA,
-    INHERIT_ONLY_ACE,
-    OBJECT_INHERIT_ACE,
-    PSPCB_SI_INITDIALOG,
-    READ_CONTROL,
-    SI_ACCESS_CONTAINER,
-    SI_ACCESS_GENERAL,
-    SI_ACCESS_PROPERTY,
-    SI_ACCESS_SPECIFIC,
-    SI_ADVANCED,
-    SI_CONTAINER,
-    SI_EDIT_ALL,
-    SI_EDIT_AUDITS,
-    SI_EDIT_PROPERTIES,
-    SI_PAGE_ADVPERM,
-    SI_PAGE_AUDIT,
-    SI_PAGE_OWNER,
-    SI_PAGE_PERM,
-    SI_PAGE_TITLE,
-    SI_RESET,
-    STANDARD_RIGHTS_EXECUTE,
-    STANDARD_RIGHTS_READ,
-    STANDARD_RIGHTS_WRITE,
-    SYNCHRONIZE,
-    WRITE_DAC,
-    WRITE_OWNER,
-)
-from pythoncom import IID_NULL
-from win32com.authorization import authorization
-from win32com.shell.shellcon import (  # # Msg parameter to PropertySheetPageCallback
-    PSPCB_CREATE,
-    PSPCB_RELEASE,
-)
-from win32security import CONTAINER_INHERIT_ACE, INHERIT_ONLY_ACE, OBJECT_INHERIT_ACE
-
-
-class SecurityInformation(win32com.server.policy.DesignatedWrapPolicy):
-    _com_interfaces_ = [authorization.IID_ISecurityInformation]
-    _public_methods_ = [
-        "GetObjectInformation",
-        "GetSecurity",
-        "SetSecurity",
-        "GetAccessRights",
-        "GetInheritTypes",
-        "MapGeneric",
-        "PropertySheetPageCallback",
-    ]
-
-    def __init__(self, FileName):
-        self.FileName = FileName
-        self._wrap_(self)
-
-    def GetObjectInformation(self):
-        """Identifies object whose security will be modified, and determines options available
-        to the end user"""
-        flags = SI_ADVANCED | SI_EDIT_ALL | SI_PAGE_TITLE | SI_RESET
-        if os.path.isdir(self.FileName):
-            flags |= SI_CONTAINER
-        hinstance = 0  ## handle to module containing string resources
-        servername = ""  ## name of authenticating server if not local machine
-        objectname = os.path.split(self.FileName)[1]
-        pagetitle = "Python ACL Editor"
-        if os.path.isdir(self.FileName):
-            pagetitle += " (dir)"
-        else:
-            pagetitle += " (file)"
-        objecttype = IID_NULL
-        return flags, hinstance, servername, objectname, pagetitle, objecttype
-
-    def GetSecurity(self, requestedinfo, bdefault):
-        """Requests the existing permissions for object"""
-        if bdefault:
-            ## This is invoked if the 'Default' button is pressed (only present if SI_RESET is passed
-            ## with the flags in GetObjectInfo). Passing an empty SD with a NULL Dacl
-            ##  should cause inherited ACL from parent dir or default dacl from user's token to be used
-            return win32security.SECURITY_DESCRIPTOR()
-        else:
-            ## GetFileSecurity sometimes fails to return flags indicating that an ACE is inherited
-            return win32security.GetNamedSecurityInfo(
-                self.FileName, win32security.SE_FILE_OBJECT, requestedinfo
-            )
-
-    def SetSecurity(self, requestedinfo, sd):
-        """Applies permissions to the object"""
-        owner = sd.GetSecurityDescriptorOwner()
-        group = sd.GetSecurityDescriptorGroup()
-        dacl = sd.GetSecurityDescriptorDacl()
-        sacl = sd.GetSecurityDescriptorSacl()
-        win32security.SetNamedSecurityInfo(
-            self.FileName,
-            win32security.SE_FILE_OBJECT,
-            requestedinfo,
-            owner,
-            group,
-            dacl,
-            sacl,
-        )
-        ## should also handle recursive operations here
-
-    def GetAccessRights(self, objecttype, flags):
-        """Returns a tuple of (AccessRights, DefaultAccess), where AccessRights is a sequence of tuples representing
-        SI_ACCESS structs, containing (guid, access mask, Name, flags). DefaultAccess indicates which of the
-        AccessRights will be used initially when a new ACE is added (zero based).
-        Flags can contain SI_ACCESS_SPECIFIC,SI_ACCESS_GENERAL,SI_ACCESS_CONTAINER,SI_ACCESS_PROPERTY,
-              CONTAINER_INHERIT_ACE,INHERIT_ONLY_ACE,OBJECT_INHERIT_ACE
-        """
-        ## input flags: SI_ADVANCED,SI_EDIT_AUDITS,SI_EDIT_PROPERTIES indicating which property sheet is requesting the rights
-        if (objecttype is not None) and (objecttype != IID_NULL):
-            ## Should not be true for file objects.  Usually only used with DS objects that support security for
-            ## their properties
-            raise NotImplementedError("Object type is not supported")
-
-        if os.path.isdir(self.FileName):
-            file_append_data_desc = "Create subfolders"
-            file_write_data_desc = "Create Files"
-        else:
-            file_append_data_desc = "Append data"
-            file_write_data_desc = "Write data"
-
-        accessrights = [
-            (
-                IID_NULL,
-                FILE_GENERIC_READ,
-                "Generic read",
-                SI_ACCESS_GENERAL
-                | SI_ACCESS_SPECIFIC
-                | OBJECT_INHERIT_ACE
-                | CONTAINER_INHERIT_ACE,
-            ),
-            (
-                IID_NULL,
-                FILE_GENERIC_WRITE,
-                "Generic write",
-                SI_ACCESS_GENERAL
-                | SI_ACCESS_SPECIFIC
-                | OBJECT_INHERIT_ACE
-                | CONTAINER_INHERIT_ACE,
-            ),
-            (
-                IID_NULL,
-                win32con.DELETE,
-                "Delete",
-                SI_ACCESS_SPECIFIC | OBJECT_INHERIT_ACE | CONTAINER_INHERIT_ACE,
-            ),
-            (
-                IID_NULL,
-                WRITE_OWNER,
-                "Change owner",
-                SI_ACCESS_SPECIFIC | OBJECT_INHERIT_ACE | CONTAINER_INHERIT_ACE,
-            ),
-            (
-                IID_NULL,
-                READ_CONTROL,
-                "Read Permissions",
-                SI_ACCESS_SPECIFIC | OBJECT_INHERIT_ACE | CONTAINER_INHERIT_ACE,
-            ),
-            (
-                IID_NULL,
-                WRITE_DAC,
-                "Change permissions",
-                SI_ACCESS_SPECIFIC | OBJECT_INHERIT_ACE | CONTAINER_INHERIT_ACE,
-            ),
-            (
-                IID_NULL,
-                FILE_APPEND_DATA,
-                file_append_data_desc,
-                SI_ACCESS_SPECIFIC | OBJECT_INHERIT_ACE | CONTAINER_INHERIT_ACE,
-            ),
-            (
-                IID_NULL,
-                FILE_WRITE_DATA,
-                file_write_data_desc,
-                SI_ACCESS_SPECIFIC | OBJECT_INHERIT_ACE | CONTAINER_INHERIT_ACE,
-            ),
-        ]
-        return (accessrights, 0)
-
-    def MapGeneric(self, guid, aceflags, mask):
-        """Converts generic access rights to specific rights.  This implementation uses standard file system rights,
-        but you can map them any way that suits your application.
-        """
-        return win32security.MapGenericMask(
-            mask,
-            (
-                FILE_GENERIC_READ,
-                FILE_GENERIC_WRITE,
-                FILE_GENERIC_EXECUTE,
-                FILE_ALL_ACCESS,
-            ),
-        )
-
-    def GetInheritTypes(self):
-        """Specifies which types of ACE inheritance are supported.
-        Returns a sequence of tuples representing SI_INHERIT_TYPE structs, containing
-        (object type guid, inheritance flags, display name).  Guid is usually only used with
-        Directory Service objects.
-        """
-        return (
-            (IID_NULL, 0, "Only current object"),
-            (IID_NULL, OBJECT_INHERIT_ACE, "Files inherit permissions"),
-            (IID_NULL, CONTAINER_INHERIT_ACE, "Sub Folders inherit permissions"),
-            (
-                IID_NULL,
-                CONTAINER_INHERIT_ACE | OBJECT_INHERIT_ACE,
-                "Files and subfolders",
-            ),
-        )
-
-    def PropertySheetPageCallback(self, hwnd, msg, pagetype):
-        """Invoked each time a property sheet page is created or destroyed."""
-        ## page types from SI_PAGE_TYPE enum: SI_PAGE_PERM SI_PAGE_ADVPERM SI_PAGE_AUDIT SI_PAGE_OWNER
-        ## msg: PSPCB_CREATE, PSPCB_RELEASE, PSPCB_SI_INITDIALOG
-        return None
-
-    def EditSecurity(self, owner_hwnd=0):
-        """Creates an ACL editor dialog based on parameters returned by interface methods"""
-        isi = pythoncom.WrapObject(
-            self, authorization.IID_ISecurityInformation, pythoncom.IID_IUnknown
-        )
-        authorization.EditSecurity(owner_hwnd, isi)
-
-
-## folder permissions
-temp_dir = win32api.GetTempPath()
-dir_name = win32api.GetTempFileName(temp_dir, "isi")[0]
-print(dir_name)
-os.remove(dir_name)
-os.mkdir(dir_name)
-si = SecurityInformation(dir_name)
-si.EditSecurity()
-
-## file permissions
-fname = win32api.GetTempFileName(dir_name, "isi")[0]
-si = SecurityInformation(fname)
-si.EditSecurity()
diff --git a/lib/win32comext/authorization/demos/EditServiceSecurity.py b/lib/win32comext/authorization/demos/EditServiceSecurity.py
deleted file mode 100644
index 86d60414..00000000
--- a/lib/win32comext/authorization/demos/EditServiceSecurity.py
+++ /dev/null
@@ -1,242 +0,0 @@
-"""
-Implements a permissions editor for services.
-Service can be specified as plain name for local machine,
-or as a remote service of the form \\machinename\service
-"""
-
-import os
-
-import ntsecuritycon
-import pythoncom
-import win32api
-import win32com.server.policy
-import win32con
-import win32security
-import win32service
-from win32com.authorization import authorization
-
-SERVICE_GENERIC_EXECUTE = (
-    win32service.SERVICE_START
-    | win32service.SERVICE_STOP
-    | win32service.SERVICE_PAUSE_CONTINUE
-    | win32service.SERVICE_USER_DEFINED_CONTROL
-)
-SERVICE_GENERIC_READ = (
-    win32service.SERVICE_QUERY_CONFIG
-    | win32service.SERVICE_QUERY_STATUS
-    | win32service.SERVICE_INTERROGATE
-    | win32service.SERVICE_ENUMERATE_DEPENDENTS
-)
-SERVICE_GENERIC_WRITE = win32service.SERVICE_CHANGE_CONFIG
-
-from ntsecuritycon import (
-    CONTAINER_INHERIT_ACE,
-    INHERIT_ONLY_ACE,
-    OBJECT_INHERIT_ACE,
-    PSPCB_SI_INITDIALOG,
-    READ_CONTROL,
-    SI_ACCESS_CONTAINER,
-    SI_ACCESS_GENERAL,
-    SI_ACCESS_PROPERTY,
-    SI_ACCESS_SPECIFIC,
-    SI_ADVANCED,
-    SI_CONTAINER,
-    SI_EDIT_ALL,
-    SI_EDIT_AUDITS,
-    SI_EDIT_PROPERTIES,
-    SI_PAGE_ADVPERM,
-    SI_PAGE_AUDIT,
-    SI_PAGE_OWNER,
-    SI_PAGE_PERM,
-    SI_PAGE_TITLE,
-    SI_RESET,
-    STANDARD_RIGHTS_EXECUTE,
-    STANDARD_RIGHTS_READ,
-    STANDARD_RIGHTS_WRITE,
-    WRITE_DAC,
-    WRITE_OWNER,
-)
-from pythoncom import IID_NULL
-from win32com.shell.shellcon import (  # # Msg parameter to PropertySheetPageCallback
-    PSPCB_CREATE,
-    PSPCB_RELEASE,
-)
-from win32security import CONTAINER_INHERIT_ACE, INHERIT_ONLY_ACE, OBJECT_INHERIT_ACE
-
-
-class ServiceSecurity(win32com.server.policy.DesignatedWrapPolicy):
-    _com_interfaces_ = [authorization.IID_ISecurityInformation]
-    _public_methods_ = [
-        "GetObjectInformation",
-        "GetSecurity",
-        "SetSecurity",
-        "GetAccessRights",
-        "GetInheritTypes",
-        "MapGeneric",
-        "PropertySheetPageCallback",
-    ]
-
-    def __init__(self, ServiceName):
-        self.ServiceName = ServiceName
-        self._wrap_(self)
-
-    def GetObjectInformation(self):
-        """Identifies object whose security will be modified, and determines options available
-        to the end user"""
-        flags = SI_ADVANCED | SI_EDIT_ALL | SI_PAGE_TITLE | SI_RESET
-        hinstance = 0  ## handle to module containing string resources
-        servername = ""  ## name of authenticating server if not local machine
-
-        ## service name can contain remote machine name of the form \\Server\ServiceName
-        objectname = os.path.split(self.ServiceName)[1]
-        pagetitle = "Service Permissions for " + self.ServiceName
-        objecttype = IID_NULL
-        return flags, hinstance, servername, objectname, pagetitle, objecttype
-
-    def GetSecurity(self, requestedinfo, bdefault):
-        """Requests the existing permissions for object"""
-        if bdefault:
-            return win32security.SECURITY_DESCRIPTOR()
-        else:
-            return win32security.GetNamedSecurityInfo(
-                self.ServiceName, win32security.SE_SERVICE, requestedinfo
-            )
-
-    def SetSecurity(self, requestedinfo, sd):
-        """Applies permissions to the object"""
-        owner = sd.GetSecurityDescriptorOwner()
-        group = sd.GetSecurityDescriptorGroup()
-        dacl = sd.GetSecurityDescriptorDacl()
-        sacl = sd.GetSecurityDescriptorSacl()
-        win32security.SetNamedSecurityInfo(
-            self.ServiceName,
-            win32security.SE_SERVICE,
-            requestedinfo,
-            owner,
-            group,
-            dacl,
-            sacl,
-        )
-
-    def GetAccessRights(self, objecttype, flags):
-        """Returns a tuple of (AccessRights, DefaultAccess), where AccessRights is a sequence of tuples representing
-        SI_ACCESS structs, containing (guid, access mask, Name, flags). DefaultAccess indicates which of the
-        AccessRights will be used initially when a new ACE is added (zero based).
-        Flags can contain SI_ACCESS_SPECIFIC,SI_ACCESS_GENERAL,SI_ACCESS_CONTAINER,SI_ACCESS_PROPERTY,
-              CONTAINER_INHERIT_ACE,INHERIT_ONLY_ACE,OBJECT_INHERIT_ACE
-        """
-        ## input flags: SI_ADVANCED,SI_EDIT_AUDITS,SI_EDIT_PROPERTIES indicating which property sheet is requesting the rights
-        if (objecttype is not None) and (objecttype != IID_NULL):
-            ## Not relevent for services
-            raise NotImplementedError("Object type is not supported")
-
-        ## ???? for some reason, the DACL for a service will not retain ACCESS_SYSTEM_SECURITY in an ACE ????
-        ## (IID_NULL, win32con.ACCESS_SYSTEM_SECURITY, 'View/change audit settings', SI_ACCESS_SPECIFIC),
-
-        accessrights = [
-            (
-                IID_NULL,
-                win32service.SERVICE_ALL_ACCESS,
-                "Full control",
-                SI_ACCESS_GENERAL,
-            ),
-            (IID_NULL, SERVICE_GENERIC_READ, "Generic read", SI_ACCESS_GENERAL),
-            (IID_NULL, SERVICE_GENERIC_WRITE, "Generic write", SI_ACCESS_GENERAL),
-            (
-                IID_NULL,
-                SERVICE_GENERIC_EXECUTE,
-                "Start/Stop/Pause service",
-                SI_ACCESS_GENERAL,
-            ),
-            (IID_NULL, READ_CONTROL, "Read Permissions", SI_ACCESS_GENERAL),
-            (IID_NULL, WRITE_DAC, "Change permissions", SI_ACCESS_GENERAL),
-            (IID_NULL, WRITE_OWNER, "Change owner", SI_ACCESS_GENERAL),
-            (IID_NULL, win32con.DELETE, "Delete service", SI_ACCESS_GENERAL),
-            (IID_NULL, win32service.SERVICE_START, "Start service", SI_ACCESS_SPECIFIC),
-            (IID_NULL, win32service.SERVICE_STOP, "Stop service", SI_ACCESS_SPECIFIC),
-            (
-                IID_NULL,
-                win32service.SERVICE_PAUSE_CONTINUE,
-                "Pause/unpause service",
-                SI_ACCESS_SPECIFIC,
-            ),
-            (
-                IID_NULL,
-                win32service.SERVICE_USER_DEFINED_CONTROL,
-                "Execute user defined operations",
-                SI_ACCESS_SPECIFIC,
-            ),
-            (
-                IID_NULL,
-                win32service.SERVICE_QUERY_CONFIG,
-                "Read configuration",
-                SI_ACCESS_SPECIFIC,
-            ),
-            (
-                IID_NULL,
-                win32service.SERVICE_CHANGE_CONFIG,
-                "Change configuration",
-                SI_ACCESS_SPECIFIC,
-            ),
-            (
-                IID_NULL,
-                win32service.SERVICE_ENUMERATE_DEPENDENTS,
-                "List dependent services",
-                SI_ACCESS_SPECIFIC,
-            ),
-            (
-                IID_NULL,
-                win32service.SERVICE_QUERY_STATUS,
-                "Query status",
-                SI_ACCESS_SPECIFIC,
-            ),
-            (
-                IID_NULL,
-                win32service.SERVICE_INTERROGATE,
-                "Query status (immediate)",
-                SI_ACCESS_SPECIFIC,
-            ),
-        ]
-        return (accessrights, 0)
-
-    def MapGeneric(self, guid, aceflags, mask):
-        """Converts generic access rights to specific rights."""
-        return win32security.MapGenericMask(
-            mask,
-            (
-                SERVICE_GENERIC_READ,
-                SERVICE_GENERIC_WRITE,
-                SERVICE_GENERIC_EXECUTE,
-                win32service.SERVICE_ALL_ACCESS,
-            ),
-        )
-
-    def GetInheritTypes(self):
-        """Specifies which types of ACE inheritance are supported.
-        Services don't use any inheritance
-        """
-        return ((IID_NULL, 0, "Only current object"),)
-
-    def PropertySheetPageCallback(self, hwnd, msg, pagetype):
-        """Invoked each time a property sheet page is created or destroyed."""
-        ## page types from SI_PAGE_TYPE enum: SI_PAGE_PERM SI_PAGE_ADVPERM SI_PAGE_AUDIT SI_PAGE_OWNER
-        ## msg: PSPCB_CREATE, PSPCB_RELEASE, PSPCB_SI_INITDIALOG
-        return None
-
-    def EditSecurity(self, owner_hwnd=0):
-        """Creates an ACL editor dialog based on parameters returned by interface methods"""
-        isi = pythoncom.WrapObject(
-            self, authorization.IID_ISecurityInformation, pythoncom.IID_IUnknown
-        )
-        authorization.EditSecurity(owner_hwnd, isi)
-
-
-if __name__ == "__main__":
-    # Find the first service on local machine and edit its permissions
-    scm = win32service.OpenSCManager(
-        None, None, win32service.SC_MANAGER_ENUMERATE_SERVICE
-    )
-    svcs = win32service.EnumServicesStatus(scm)
-    win32service.CloseServiceHandle(scm)
-    si = ServiceSecurity(svcs[0][0])
-    si.EditSecurity()
diff --git a/lib/win32comext/axcontrol/__init__.py b/lib/win32comext/axcontrol/__init__.py
deleted file mode 100644
index 8d5db8b9..00000000
--- a/lib/win32comext/axcontrol/__init__.py
+++ /dev/null
@@ -1,4 +0,0 @@
-# See if we have a special directory for the binaries (for developers)
-import win32com
-
-win32com.__PackageSupportBuildPath__(__path__)
diff --git a/lib/win32comext/axcontrol/axcontrol.pyd b/lib/win32comext/axcontrol/axcontrol.pyd
deleted file mode 100644
index 40cb13efb8d20aab01709722d253e1391db7d154..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 143872
zcmd?Sd3+Q_`ahlk13?TE#8y1epkYB#jK(7@9urAmA`=Lgpa{f85mr%z1VKc>1U0s!
zfVX&{i0gf<2Ouh8L5}4X(I_4$9vLHox(cjE|K9JXs;j#v2l(CH&p$t2I;rledg{6A
zd7gTzy1VGYnJG<EQc{}Xf5%BlS%|;<7m?q_f7+#{q_jTz_0}n`v|QI=VQOq$hk>KV
zOvoHJ{;JEyUpzK*<i%HBc~xoVUoOoYUv_2Ym@6~$`wqw)d(|bEc1=$|AWMV3r)Ff$
zJC*5+-T$|K|M22>aXszV17Ckn{-(XYO#Zff{X_ZN`t?otyW;bfuW!NM=(Yo2--y3$
zbo&*bA1L?VsXTCTAGzO5`nUNt{q@aq9hSfS$BZ1!F&m<=xF99vlAD^RRDO5VC2pHt
zDaT~CYSOxW%E2J~aQu&d@22B#h7_mC9hRG<q%@aX-rtm&xJf4CUz3y)(@FQmT?NGb
z!*;wg?d#N(f%y9_{_f(<aZOSNQeeeRQfdz84gGIglaz`BQc~L8qT0K+lmCuGeXc@X
zRb}Hkl-$a@?pk{3q*7d7-&Uhc+BF?+tIU*?lCI+~xw!P=l$6}fxC@vm@8T~N#P=@(
zwd$&xrBruAMFx068osU5uBz)e)lg^zttm&MU32{P{fiLZ_zB}j;-2sXyb;`vsjuCo
zS6qdL<WUNEm2x2d{;5v8b8+|oSO22r-{!{b(8tH7rbOeR=VK`;(aQX+&e6ElWTf2c
zo!TTNZ&4<g5{;)nd~_43&vdME>5+csL1<OJJU7wh-zh0;*RIv@;tJkT{XBRdDtJTv
z@V?75@NyKqU)yMSTlf0mou%NNJ;Z}I{u05j)(`J&NS^ouzwO7cI{gh7o*jU<Luy06
zmw52rxm4i&;)i$pu?F6q3f^@tyzT*b4=H%pU*^FZf0@AR-NeVgPqGZW9tz%>F1*@3
zetKtgkk0F`_Tcp&t?={1>k19l^!_M4(tpiBE6QVz2M>ZRn4IEDk>ZWTLoc6%uJO<n
zP5H<AiNMJ?uxxUtCMk|JPr-Y`h1c7I2YvZ6Q;@lGhKJuj#wh#%(CEwh&IZ2$3f^@t
zykB<v>AhRQTYswuZ}#N^uXi&ayrYgc@R}-kXS(p7@!)~1vip+h-F}?Vdr?T}Ex5v?
zcT5-3`?6q={%aT&<loQ$yjLGghL?k080a<y&$`lsx99}I8>!&E;lgX>!2|#1A1%Zk
z^_)j<|EuKIRv0<Mzt&w1y=@h|>s)w?fA;gQz2e{SS3G#LuNHV+TKM1%r_j~>SSA>x
zpXtK8JOFQ<!mrPJ9=vxHyg4m>@Se{$@FpmDzqZDx<lhkicvBU;>p$?p8!!0Tet5s1
zY~UTM;Jx9(Tl15lm-_s5vOJctYdm!10sLd_AaJeEg*lYR=A$@V`gJb6DH@)Wx(sH^
z{EL<!ms-{$>U130J~ah3(HW~t)6LC3>ZWPEc5Tc~jdf{KmKL+~(qdiCP0Oh&no$+L
ztI7o$wNs<4kD@+``e>kb?b^rySj^0*{efdWDj0^|i4patpe1`4OFhz1JZq2?Gf@1;
z04Zii?PXwe=1_Meg;cciqO7!N<rP^O=MT<1AF#8F?C%ThT~YhrQ9A+L$_`jKIHkq3
z#Lckii*oT(vwA0lVpo%0B~g1z)L!LSmcpf{!R7Ib3@$GXG`O7Z;!-&!Gdja5Z5g#&
zMC}buaavwDqj~r^8WbC(4CLQ6&dix~BbCh;wFU+`?~oS-|FoAz?TfOCqxKb9LqJe=
z-tZB_J(|K9p$lj!?SF*ZG@(4;uOO4M7CBW^vt?1cNwj<DbTlbDBx-}d-9snyqGdFm
zmn|*A8BGKM!3KWoNI+vx%`c~89)xNn3dwg%x;{B@P5ut1%<K=N_Fl*O5%7LqmRg$r
zI++RLYhL}1e=o{{gjQmt%n=?nz~AY(6g|B0?4|zdwb7(&pMFdy=JC)$eaU|6$EqPL
ziGHMupn6b0nhch^|2_S9YDZoD_~{72<)%I^E@yhUOz$lS5SNMPYh3=9`cX*R*SLQC
z2~CWCbl^pU`Y{rLeNaC-fL2dlPRGNNuG<8zll5aW;05*L?r$5{k4MqN8!t&88qtpq
z#5^AQuqSy={g|m{C+$a>5(H)P&mz|M$VRc3h_6Sk&y?)9{g_Sr5y4MQWo=#kxce}{
zrH{d-nTJclvt?&{xGYx1-01&IRfMOoCzZ5qjqA%OG%@;eF)yeux%JtTm$AqR>dW`I
z<H^tIm`J+*EO4EyFY{2V^o7i&J-PIo#`Wdu0K6o9@!5|&w1d$9aTflFe%zAJlJYP8
zq)7cZC@RJOp8Xh;sH-2Z9*RNYq0<d6zxFV=yi{y(xv7`N<$tCW(1)jJR~y%do6yAQ
z1MP6b_T$(?04?BOKEoZqK75dLy(w^=tPgjhHfTQv)ikaT7YE=qtPdxn9c1v&Gs$Dx
zi_T}WB>FJ*JSkEiu9Z0~_Tr2}x%(g5iwh9DCC3}{EkKTk&NjF_D4HR-e6L0&F5eXh
z0<>MvC^h{*uow5!t~Rb86Vb%z$JM+D*o#ro@by(H8tNYUGpi4c+FWIK51r~ZR>6ut
zQu&}Q#`QEwsSx6aSxCY7^{F!HdV1hGS)Y2KHfUc$Up1~zZ36Hb)~C;iZ#?vvxPR(X
zJEb}FKd*Z6$uX`B|6B2E%P;Hd(;$V*AqJP*)TqSeI1iV5lm*QG-#H!Fmu}SU#`WhA
zG%@<qh8GRSC(Crgz>8m}BL(BvhsjCTR|l?>^&tnfLHqL4_Qv%gH2|++eb_`y<DpZ!
z;g8stX`T$;RNkI*`dnpd{(Jsr@8@;(p+MpCM6Qd=zdYY}vWLrS%GCUi^?|y%4}Cxr
zPak;Epgz2;7x11wT#b~7UmwOKU0)oyPS%HGQ5)2UFF$KsAHD|$-gph`!*pUA54|qz
zrhO<@-ko!DzBeb2cjsh0bb~7XhyEt9t*$=&#56!W)Yag!+_P1OdAK~Rq7wR>A64=H
zz~8Liw|+d~*N;bC{iruSZL1R=o__Sh9Zz0P$HJuRyufv`el$gG(0{!BY2*5_DcwI_
z!}@VC+JVsros2(XFXnnN;n?oHDeK$w)bf%tIY|X9|Dk@Y{-mycY&lSHxhdPl<zNq&
z&;D$1dCRq3@z6XKu>2qB#|N}!joXjc(8Sn}mv|9~NBmL7kF5aBi!u;joDACi`f*&+
zb%(%pvVLp_yr6!}|G07ecnLkc@fy~TJYpIT-6-s*{kTswMPkJH5;%%}{KK2GkGL^n
zJoJj1-x1$ZSH`Tn-Yv8fDqj|}zxU<K9>QvDQ4~Kl_kZN+OQHRq<jdwCAh>;HeBH02
zIf7eD54S&gxHa`~({WOyZWI#EC`kFwvS^4uKH$9ChrXbRr!TyqzC=VXkUtB=uNT6M
zd-3Z)UU|yp*R1<n1~f~F82Ysd_dR(#9akq^FHO3>IxW~fcy07ga;RUnNKJ{^16D=j
zy;l|FtVSldynkv+K~9yuC(oHZ4dSym*wv2p9NHoNlq_8!MJM_o`8|PmcO7`W>xDOL
zKj9VBf!DTPc<BwnOLU(id2pA3T7OHk+C?h|W@Qj_L{cg>S=}5&4$O*0<9%1f>^8A@
z`X~&BW}U$hu;z_^xVk7S)86IsW<7Z`3*Dl2X;!gf5VauN<S@;6YA9xvk-EMTU0k+f
zn6}XE%ImT+)i4)hn4}@P>LEBAAp_qKN&L5bfR#Lt1+=>I{5Z6K@_ZZZTtpST+T!})
z#rG3lSsi#U*9-5gM&U&(OO@zgo)kmdqkX>J>p<$UeJEJ^3cx~!_O5)S>2pz)#zHm<
z%~+sBA=pev^*po;$a85kCC?#>*~O4&Bq&dRKKod3T-k3LJLaFhe7|w~{XKAX)v?k1
zHQK>yA9D`=sP({UEQyW$sk0Qh9vFYB6zSi?=Sndb#Y>bCji8v?RqjTUO}XHp_0zZi
z(SSXF64Wg!#!t;^ZgT1U57(Y=A<vM%mH>mk=3RvqW7R?r*A+Pi*O7S!*M%xrA+Cc?
z)VS73VEyN&UFd~<ZwdRj5BvTV%!#q@pYehwJ6f-Of11@MKk>NRSUH1$Cn$!Y_FA6D
ztNJ~`9Zi9uiZN*aapma??0?er(xmIFn*`ejuaoS5YV!OpkJUH7pF_L-vj279^{yA*
zu>FKrPzPSydf}xv1TWFOZ2#?lN*();!F=|=cm4Js-TtWkM;F(u(*9%K`s_c3Nw)ub
zh<)3CA7E|&0j(bUkE3h*BhR<d&P7z)e}wRL;l=k8URfP@FV_q2tVZG0WB<`UX#W9r
zKkYwS2JQdvv~Q(Z_1gc)fI)hrxHxKue%}hw=Pc(|a5N7l(f$TOuw&f;2u1e!RS<1%
z1bD>Zc^Ejr+q{C&>^+6?K2`3R)ibIl4T{<^?0?3smTYdn?O6E$fz9VGg?7&>28p@s
z;>^4S2Ds4fQ;nwYz%Rt?D#z+ZURBq&Q82h4-`ug@{f(iUWBrSN5j4cIqS2hSH9Izf
zw({l0+%z7>t?>HellABYv18=kBw_-F^7OMMNeG5Ox1&8-wom;m^8r@+w7IZ8eL72{
z&0XOJ;!Pd2%>$#9|D|)1{U6fU$bRzG=;7JZM%GVg2bXkX7sy!r@6123B>wjy<%;Ql
zk3T`~{`c~6V>S@~>cIJeSIOXb=;z~IT$*{fwDE9xSa8MOLml_|Up!y17y7mj|M?!8
z82`D67j$&>o-a7|S3nD_r$56TPd-k^50b7o1+I-h)B12HYLz~?=L-g{C%z4zFSs}W
zuVH;S8SNm0Q%-kfFj`5TG0s`Ckd^iHpR@kU`f$NI;vdw9`M(G*Pl)IlZ+)aBPh4J-
zq^;oc{IMFB|D`@0w{LxD?$?LZM)jdB&P4|GVUs#3sZ;{-(CVb?rGe{YeJDq5P#+4`
zlAjIhL%#sLhV`KX+JW8wF!mw4lW?0dDCi(X+K10oNc-Qj4~1)pe^4Lp#_39ob-Kaj
zanC+1$~3r~@8a^m)Q2%#w=|wV>4_%BKIHMDLHp2j4=4-Rho!jVw-1Ywu3rjVC+oum
z)CTq8w11MH4eLW*0A9oTun8v?sSihz-JFxz$`Vi?+T+ZN&c{CO`U~V^aZ&<z|HFK2
zx7EZys1F4Sm(vX{k1I<+TxMYlRpWA$hs(V78khf>YKY9Z{-PaiTtB{oc{BR)885tr
zQquXfkvKOQ)Q?BiNlIfc?oYa&6}V2;j{&Gv`VrCbgtdzJHmn~V0`MBvkC$+Q66|jx
z?5BPdtA#OT@}@H1v=_%HRY5cu8m#VeJ^!sLMv@ot`@MdD2-K*2Y|E9TN9l{Zezz2E
zqj(HSboUj{mUZxOyGf}Iaa$~*2y_>8xVY6(o&S8%4t?26+t#?gyoV-6UpDcA`VtYn
zNY2OJ%4)M-uW%cy%^-h1w&lMtu4j3SKIP%Q-~Mz<x;{B@ovdF!{^;tLn=g9xZPM4U
zel0~0Z@l{S3-UO(9kZCsY{lZ|Hj84#Q5=gi=*O*0tQN8|QgNua^$%QCl%A~C1MvZA
zj@1L$;?_~TRUC~E$Z)J|b*t4vK4t<AWDi{?r$_Nutrv9GbZ^uyM04Sj-4{o8kqrG6
z$l8P3;pFf;$aFKshBb;kxLFLxS*`H*ic$(jr$~{1?Hsk!+p}h+JYE81AK}iY-O{ms
z-<6UgLwDBOadN(x$Bm!GAza?0{$~!7EH09QktmiaNObKDFDPu{SPR(w=crvXs{1uf
zCKSie0wj)T9*d7_7e0C#s7ndI);l#n{8}sg-@^&NHsJTl82ObR0Sb;a8~_R{n>#DQ
z3wkvviciE;9onq>uIpCEnC}fQI20|9LQ7e)os7oO^06tYoLsix0gTEHjN0q4o@1q2
zam%UQVVWRs{&G><j`(M)bI9QZdChVhq>D#k9oWp?P}?-x6eo=*K!h=#Pu>t-(4#r(
zN+In7n>yBor~s*|BF$HkCl$NU`~ZFT%%*7NSe*sbdeAT&o0OnIltoMeB>5LP=Deq9
z#?PhU!t$=EWi1Qs^^P@#w`c4q%@9&C&q&=Uxrv5RX&7b0{&H_C?{z_Eo@chs7MM(6
z<ESrKG=!&^Auq}WDv>vQS!B?F!FgB?e+!XLirR-q;{{@=pw>mJaIrClHFmt9%GK*<
zvH6nYIM%6v%){CMGbwM_h@r!<<}Ip<#s_6%nTdP_@PUfq0CmM-&@$8k*q~gu?sQ%E
z8#Equ8&MZ=>kij-pQ$=5y$3CH>!_cE`L?RVy6cs!xzMUu<t16;sBWWU5NHVx#kX>-
zNjS(FAD3F&#NLfTcr3g0K=2uN^Le{zzTA)K`{&91Npc@*P_&Tu4{)qgaNnr{kd=8&
z@!yK3EAr!61sNE%aO7IYvQb@FSpXSrEjto3YaUM{$F0W?)KlsiTqm%yP06o37R&ns
zqur)vmo*<%Ii*=`*YJX+F?;E#F3Uz$_GlKh2W5|%8D4<X;QgD7%BxH%ibtAI7r%{;
zTmhBKL(g34*}V2tf6wOVnHxU30%Kr))ziPw^p8mYv|#@<^p7;&f2AIOq4YnX_5_Tt
z&^`d27mgY=D!G4UYBXLb=<iqpVL{s|92;Va+FEAN#}e>48+JoZkQU`)-%FJuc)mxK
z7CP4bD9K56t!TzJvjEf72IqUty~v<w{EDonqSL>95u+kyv}QE~!IV)!UpTdud@zFo
zDmpX@%aaQ&Z-I+2FS4QM4lX+JqBCTe(h6PUMPKteQ?^mhhOnuBSZz>m(R$E1j+Ki8
z^}LJbybFMXPI9bc^j&y*-VFo#PUtb<(hfM*ts2%ARgX=Sg59cq2!ct+`m3&gmGzYm
zW>v}GH?lV3uVZD&q2{9994p^0_?k8_UT`!4zyo1okOaGEr@}p61T?2Bj_$PgMC~?C
z{|r=PUZ@gm#VG<&jWffU+!fDY-2i8u^A1hd7O7N&qhDX<w%WV}#HKGNpJnzRO<ZK^
zKZ4e^8*{2^--W+`fi*IjOB(FZ8LM2G^ny&l;ub^`{4e?i7e~Vi6MZlQ_8vG^PL=vh
zux>h%_#%l{Kn&&v9<xZm5|P1Vpd<884Ws2UTH(s6FjXG_8;VC5X%`XAPI%5jv-c6z
zy9H)@S*vj8f=;8tHx!&v+ZwITaI9g{s&py^APNP8Q-vPTPn;SC<97q;PWGT*#0OC!
z3ZP2}0UYZcIYzq1-sM>D%L!uzVaCss+k&-OSmc1Uu-n&ylG=ko0I(i(hVXBMND5+7
zgQ3o$F~USw(t<57>O~RU{su{ZBMT8TMKKqDTt}y8M3Db_PApiF#D8HpCj%L-`OoP9
zl&JnwAp`1D+)C$OPQ0j=oK>pDr*S%gJ}nG{rW6Kg5p9O-KoXkoM4Y1qf%BZMz;@;>
zLI;4fwj-){tP@47;fiIdiI&y-`tEb;E}7w%)j>*DFX>h{vz3`JujmQ$BgBz!gBrUU
zVylIqTEKMe1g;>CXI<k3owVdK<-n;(u6+$r)ssR=?yo>pNv;Z&B00`@CAs<1UL?nP
z3g|lnlEYvWq+=Z@A~u42`*k*cBdeO7+&M)NMs)1=PezvrrmQ=g(*ZNZ4IO(PM1k>m
zs!K(93@S5OH$)}^9e&)ZgayL$Wxx!<%Mb=Y5yn1I$NCh6VgtTdlsA?&#IY{*NIypO
z7mc;Xjt3Y;_bSxX!tkH9gsmO$5zsjFkN~ZGxX9a>*ZLSaAEtS(um%%f0%k#(>3Dlp
zEMB2>Ic~j-EJe=Gj<p73fW%fHQ7QOvL>jkAE4HozC}lOzg`;(>Z-pb_3Q!A%N|HZ6
zYqUt19L!~;9wCPYim<_+Yq6E;SeM8!;R-cFq~Sm^<St=bxZ*wyFTxc|iDO--?@!bB
zqr5-Pu}T%2ukZ}U8(9m{#<9lBG2q(-V<Iq)J;-{<;R_<W#@^#t&q^z0D(nrg!#EZZ
z+KnJT=N-rD3nXh1rk^B@c2QvnoBXKaU%!o5Vc4ZPul}g#EiexFRKCXvSG?CGCFS*>
znxc0+eZxP<io*nYHJ^T~ScqD&x4#la-gyFd@)ow?aB-_ORyk5V6_|0JLvAg23;yI<
z^pFusrH7v8&$`t^-ReP7jUNJh$gMuptv($!3iADKU8Y-ixF7Otw>s6W{sm*^kpe=t
z-RjSAd|2@MNUAkn6>jx1xB5+g@2PI}<8JlCQr%1eztXLq;a1-u)oH4Fgj+qztu8^e
zqH2I!cb;39FI^q{1KKgSx{F)gQL2Ae)n~cY2fEcT4<PzCRo&IC-toC68e&KFud4cJ
zw|c!>y-KQoQPu6->KEMVr=<Gds`@audZt@_E2<S$?cKUkRaZJbPpxj_*5Pi|1-fdm
z>SFHa>HFv8LAmK}tV7){f6`T12HL@HRV!VEg^zyjRE#2@KaG|rG7_72Iu53Qln3wd
z%H2&lEwS?}_kLQU?KZcZo#?gMD|g@ImU9!~4Q@F*v3adq&PaS6k%$yyWhaLE#y!WB
z(f(VveRg7jDW@f-)VTLE5?A@~nfIxCKR0pN2VS|iDW@e~*y!F*OB@Slspw5h+`Qhq
z-^$>bmRPdVy`P<!_nli#OSJgLEoUcczjVvdg!748PD^Yy<%~oNgF|kj`@3$NjKoRr
zxaG9OvU5Cq79_m;i%mI_xWmBAPW)*24Ezh-zR|=`(<Uu3;xiA<1am(lvC=2gDYb4J
z;A3b>OEfk7OiS#pcH7{&a8pi8JhH{TpPiUsU_!n|F4>8#U$|}35=VdTm5&|Z;+&TF
z+dtj=xe3HeS`UH$c(+Y<;!Xn-_<!uS$w<t3-z@{5)7<tMi5vqbBhkxO?qcxCNc1&u
zK<_hd-?YSKMh75YpAI;t4E-@WoSV4U=qLDNbR#$67};ecmKok=C;qnG!})R_pTnk%
z`S_9B2JKBbEn%B-Byq!gZktGAq$z_x>)iVpiD%Y$<&#!><?YMea&BU!PY1eu?cUE$
zgbmKnPcz>$61%s$ZPF6m&A8ydu>)y|kw!nW6K5EFvJ*!be6kad7`bF81{i$6e_wgc
znXX(i5|5a2cB0&;4>$YDwkfA2J~cWYO$;zN10PdPORVwPgin`wbS+!zma`L`49x6A
z7gNqiI7WXm5^a4jTjY2+A5r7N$w<6l+C&nYeRg25&kl6=m5(+!q$P6Ba$)8M?9XB&
zue5~op*vPu;zt8NJF(ly0`}9V11I_Pd8C=kX^BpzZ(5?2uY3pmo3fd(KP$YkcIUhI
z(-OUX`moanvxo5ou!jZ*%y%Q}+{7cM97*)>&7EFG=Q9$uhKKDEFZk?gxhZG(?0<G*
zj?uA5;!`7w>_iXKJ}vRJp)n(|)#wBC&F2>e_-xc*12ZGB*e4^8|GA0HK0Eooj}Kdo
ze6tf*nX$4HIcBVk#2Kax|7hT6B+l`bk6q&Ozg^;9-&k{ebZsbd<&vG)Zss85YxErU
zt;&Uyo!Ib}TTV;7>??Qr%)7tXz|TnBVPu+?7+~f#_;30~5<`uCA|5dIBqK4vhqK?m
z^foZF6DOH+T4KB5e_G;wAOD~6>ETsIe?ae>9?rYXoQ3{>;oTo$%J3Ivj$|YbHRbF?
zZy)@Vy1D#>{m=Evp8ZKnY&A9k{>~@s%|2N#Fy)Ly7vpOpi6y?d<8R->v`I_+;+s25
z-u7teak+~R;vWMC{?W|wjKm1T^GG7c*QS@jCpWRx=n3Ydktyu6frEI%$PxJX=H}7H
z7sEan*#RE|CoNI?xQi$FGtVt&B<?hN2>pM<r3?Pc*zh!8`~!KJu`+!6kd~M;--Vf-
zILE+*J}h=&W+w(4m>G#Fh7W0pt9<ixv(bUH#2G$X<``LICr0@6u!paFhS3?=6EkPw
zAI+S_{L<xy-d{8CJ=sv=n$>%M&F$)@TB^#gc|X9)Jgn2Xj(!Ynuw`m5TiJuFFK(Fm
zUNWQFmrrhnMd$~mVeH>X^LpEIfI$1QFgL+YMh~>-XhGNwv`=lUz3ey1`E}s4C=)Pi
z_C5)~NWvoPlpD1-%li3kz`)LKA3pM4iF8uv-FH~(l_489+^YnYJQQ#Ef#)DppTngO
z_qXRt9~?w-S3p46H-0>{)51wY>{?>S3~z?H0R7d@JJI4vzBz(fU}qFy7oivXI2}8o
z2btjehr4^X`0jE%dGsO^j|w=}$Eag=NpcAog^3TOiZ)<TcM!lLU-K^0JK>5sf&%hE
zY!NY8!F5>GIo6>V7rCoznYO}qL1*-d;k7;XnkceYkth#G7Pn)zCjz$mlORa14n<=o
zsIrkuX^&h=?FYQx%%paTAa@a@Ak0N#`n%1jbWk7qf+cJcn>rNLg3>&iAY355nUpUw
zIiV3Rfm7UT014P0cC1fiaNxwmi6%djc*m_{@zlCw?Z7astkmRZGARTSzXWQaxQrAd
zt8_Y=#cXULNTL!g$U?h1&*?{KOfi=d(9e@k0);Jw!uOe5K1vfmPME`t@kKy`bWH-y
z#UqePle{h<ViE3GUja((dL-^QxFQz)Ar`?$ciN+&S%Y`}j4%a_`GV+RZ0Pmfh=Z)-
z`KTz<;cAJ04ljxJ>}jBvvI=fj-ti9Z0__*@mq<ozBuJTC^b(2cJn+E0^Yh5`5-|On
z7Yx&ji|lPN`v<&83j3yjfeqArCe{8X3NwfpZ951%uV5o~NPrgP@G@?2HpYuKx_Cid
z9d4tZB-^M^l---a+^ykTTqQ+noO3sB%|>U(O2be{QFe*i1t6Rn31I5%FcQEuXxE3M
z^6c<$q_DbH&L8J0EibZ{V+$DjFO*<a*>Md+Npqnr5GX3Wsm~t|1d4f7>Io>Q1IWdc
z_Z4tQU|&hzh`ix>7wJRDu5j@;+K_#23OKMgKKtR?uWkgHWWPed2&Q5MnJM<`l?^O4
zYQHvN1oR;f_478;rxE*g8Jc?b>wfeP+OMtfw@D{EFu=(&0PWXh=;5QCMcnP?zw4(L
z6SzHbq@q@pj)fe*l6)tUo2MbWk9!w5)|?G&f%7e#kWPP?A<5%@f!nY+M`Av9`$Q7w
zsCVr+2CV=9DDPDE7K1ZE;J7U?F;T3?;28X10)XFC0iz5Ivu|pbz+OWIW$wQ~j-lL4
zWU5N9fW5)l+!!C&Lef1SulRt~+5j6mL}q3GOpSae5BcjpR>)&NOCuOjvys}z`7`B1
z$@w|f)5-Oizd}G@55VA$v4H=Z(n<Jx4S+on=41qaw*XIIJkqhc3&wDXV(FFDE5_EQ
zaQS*RQ(WHsk&EbY8WHU?mFbIHkHH9tkxNak_j5W4zxEz}l>Z?vey1t?DF1Z<`9my9
z{<!VRUt<=OKLAkv?5*T4aQ0vRiholDjN%_<9>MUy^Lm^wajcodp{jJaWBt6AV#h`e
zg^e~a!NrI@1k*oznBK9~<>8mf*n~C%gu-++OGcNIG&PBT9}65ae}2a45e(~CKLLiC
zKSKqYnLi|eCi`(VP?FsX4dX7fHzwv!z5ouL#oofd9D%c6{Bz?IJQz9%z3|`#%y#dM
z*hW&GA#RNVp57C=d}1VBtgU06fDU#w4ebFe3H3Tg5X<5{uM#P=KPa$w+22I@h|0HX
z&>DQ$TGnE5(@4s++LNMoPYl~<V?LZK_PW!r#F#QZUXI9#^#e|jI5X)e7pI~FhrE|S
znB9&9o+rU6rcxDz&?v}oQ<H}~#vM*m$r0vyBQ((?oQ8gMxxQy{0@F9>5AYsFwD<83
zK!*Y-rkTe*;Qi@8wZ<$YCBWZ%=b-3|7hmYdOW#5V7c5va5-@p=Kt&NPapij+#<8Yp
z@H96`;X*RLm-+y!ZNoJ<wULbPNsZv!kiXo#TKuIOpMNOO2WCaZ<n)BDz_&Li=|iD2
zxG&S-XRyyb^`{mw{`sTV3#%U__k!z%yNO{u^a)s@{OuP!=2DNp)%?ZtretzEymM0m
zr_3Cuh`JfG_s)2yw4Zl=$9}&seySrU&kh4cFctKD*Tmv|aHJ5&kgSyla0+A7{}fcC
zD#v%+Yy-BBoR!^w8^1^q#SkuV;w+P42&2yQ6VMdU)&W{Rqdcs;y788GcI`%7A`*Q)
z=&)V>V(!i&et4fCPwB`R+HE{m!k2I~wElSkO}+Tx0`w2Y4|5RUDJuh%l$K(E$ufYf
zf6ya{4&#TtK-Aog3^+dz(J5ln(J=3Q<^v<OAb_X+Q1-LYI%aQ^B|#<Dm~_Q-8l3tJ
zDR<+93;f?oGB;dt8CuZt<VL%v_rtxiP`>?hZ9DOXj<rNY5U$7*IHhDZfMLF^5Ow2m
zwB;xQ>U=pj117(V>jc7Zfr=pbjjSgbHt^J(V-3a#i&C(vj?o0a^fp`3c9*rnc^P)Z
z|2XxwA-eRlrqRl0v*zM*Wh8A6z&X~9(!7SvTRYZ3j%#m7+(hUIG_v#T_i=Qw=8E4O
z2U;@<=kU-XX0MY2Dp0cmdu5^BEDND<p}kg?b8GUsu$hBq1z6cwh@@_S3oo?a&Ep!O
z2XL*$`H;Ri(nq~R2o_I&564p^&bDOuUBJMxzF$sMaB8wf3JUF*I(@c+d+6jqZ4(*~
z9<e~se8&CgQNDaML+0VZ7ua$>wZkKcIK?m%-5}$?&eJlk$ht-DAguXH4^I)|nFB~b
zyJjppVC!R9r}B<oM(BmeQNZ1?J^~lnt42UU@Hh<BJ^g&##hKKdO7fE&>us$cOW6zu
z-X_Ue3dDoUcpalK$Fm5EB2*R}_V`>wz8zg0>kIHAX5*E#Tk@$h5CFqLL92vIBScs@
zsLI7U(aUpGY*^!1tte)U0ElTAVaATh$3QY)GXA&UBbT4n4S>Se|KQz~wV4{F%iJoc
zm1C{ewZi$^6!XCR*Y9N~eco;Qa&j5V7A!^NAI_`ddC-A*gT#=5@&qJtpD-)5?NKd>
z0w-pd-B4tIRsi+2Ka6obcsU5JEO?(D7$=0!YDQgfTGXP9aO5VD*PcRqL!rGJ>qWAz
zvS0~y`83};a3}5;Vv$#f^&O7<>~x<Gl{Ma9vGXpvcNnNFzzXu@Li?kc`8G~=;+^HF
zwA*U=*hNclt~o7g_iI<!<y|oN@IBG;?^4S)<Lqx4PJ)FlQ{%6c$fjUrZF-)KDb-Ei
zEwW`Ldptl=IMAYkPqAnOOzSHgni1&<hIE<knsyhI>Xu1VMZ4%z9Q0a=UhHuTdf+@U
zK-+t$cX%Kng=io=32mc*x)rPpSKJ{CP8WH`t%V$g7JCC4<T!~hQH!@F$BQu84yK6h
zqLpM1T%dTrDDHuiI9*-aUCvxd%YVykEZQK)LvhZhiVN7`X?X4yG8wd?`?B!4(8*<v
z^%RsmuW~rp$N?6k8<<;)L6#tnL>)jM0ZaEGiXiB67r9dex!T^U;dQvm>%OuSi*)uI
zOVaH0L-;3djX<B6y$U8s$a)cwfNPr=m<qE6dsOr49><|B6@4o2+QtE{?Ht)D>r8zh
zvE+C_A1*`&QS_lDnY+s_df&0$LnnAqp67$6Z@demPhU>$mF4*`F3@q3+Bg#wXm8-U
zugGerAA^qM+27~!*g4c1aphfvC~+mY*1jvQqE1t-)h|+EcsBmFtZ5hn^AXi}P8#~#
zXCu`FC;rlHpoz#pY*7iu;VHjo@P-2pY_x|FFf`&WHAxXMglSnY!{Z#j8pd<0+;Ew*
zq6)VmtgrBw0l+vFD369wmC)5AvBCU9Il7{m#4o}8>7qLcG#C%fAmQ=QQ53%9A4+kQ
zslIr~7eDk<eZBz$RQwQ;K8?f=OVHGd9}YwRVEiytFyk7;A3s#e0E{2L22Fn9Qoc^d
zMgF^n-UuY@SPuyU>4U=+<te1mI)=ib(RyhKb-(ngl`zolP>1I|aEHr082n7QKFD4r
zMrB3SpUu^Z>Tg&)aYcoE6mBx&;o|^!>5BFN>0Obsh}zbtIN=LB&2zq98!5`do^NT<
z_)h<J8nGkF-v~&BGR8>>53ZsknM8$)(DxxPk)MV6yGE-Zvk<s5j+faWuwN4ph#TtE
z9!n*x$_%$bOa7Gb2U*b<ffyKYxnmuIk|w;^5T1!4=w~iqGe_Li^N7P0;mrig2eZV9
zPhU>#8JC8>eG_EJg7R~g;D?f0s2iZ)?GzNKksn3}Gd>pHkr|Akbr2A@ZcnAv-GvcQ
zf%W<MC?&7Y;eiGH2iQu<Z6}rs3jG3s>s#%Ha)_=VejH2txjsLue*9Vse#IPF@O$lz
zy7)oK1;2lzPUF|t;5R=RhtQp9rtqs|sWJSpp2ZT__u7XR4?rVS7#)e~{O%k<iJlOu
zp_X!^<+NDQM#PP-+oMmrMTKQZS78-%a84C_(8|qX^U9uSqbhr5;CmP(qpGwcbf9K2
z5bTCVr5G*!MqVM$#nyCsAM#pfdZDha)rV1MruPenoT_rHw%`Cg28MO5;*01hvFipD
z=xZ39!4IrLNEVA@5*FG+vkUFZa|`Y5?pFq=PvD1M-<JTpf8S@A0bN&b(z=}hdv~^X
z#q8c02ssd2w8e?-T)TG`57yhgGv)lY-5a2YP(1xz;OSW3$+6>VX6yMO2*gHsMg<un
zH+kKcB=LO!LQ(`QviH=U2(NMfFJJ;agj$mS{yU&au7V3Vdrz5q{AdZlGgkkUe}!HN
zudCyV-V)H8S!hpy58dwWs>uAQlMi?v0DSp?PC(wv2h76Yp2X!9VOI)Wr479wqYnH&
zLHIv{IuCwfUHGjVhTl+r;N?XP`Lo1rRH!{-4c+~~S2;jD^g9Su{wyEIQTO4`rmH^x
zls?=K%#c2f__IgQ)bnSB=pXcFwqTa*&&J3A^k;{nN6`GypCv%4xl4Jv`8L?Yb*NKo
zN<346eD80(gfIJYq0GK9lnfTIJ#m?wRL5HI4z~JPEcso~#i)%<F4^0oIZ;_SjDMVr
z5jsX-0GzTqZROH!rt)^;#k^b;kxs(5y}>tJaWi~`&xSVv?#KrcrK-{^HRACFRMZym
zL0+OYlZF!5Z$h2M{yofB!5;fm22Dc){m><7tVk1^K1eS2iG3aXhY57$jEO&Z{ufMV
z;rZ3Xr>b;<M*W@F6zZJ+#)pa%0`8WF`{5q$OAL~J+-1pW^}u$PME|qvZPdVas>grY
zHpD;DS>eA`@MoZ)LI;Gbv8;T?2iI}#U|miBiXSY7t-COVC2DZ2N)X2QX%72Cze*67
zzDioL4T8p8|Be%@=ThB2TTAR{_Eh?o#mPl|Lp+4L6io@Wjv+1fQGX0)a8EU!ekR7n
z1#n_4l}{}QU$`}VVb!R@@bw@3z{n-ju_j{tWDo*PG!pRY&L72(xQwm%L3+pn@<S*A
z+3WsIrMws5A=#<)FhB~?pkr;N1glDAhJgcLyh0A(F&$JAQvgx%V!vEX{4oGxuLt>=
zSl@S)d4Ltn+Ilc|tcL;Z57Lt<@_kdldHU&_Uxy1RYXR9ezfKgigYzq*5x$yDm9!>`
z+KaS~&<I1OzUdQcrZLvm;is2LfUm(m^;6;hn}8wyV$UY-B^cN<i@0cR!=6nP@Me=E
zsxe-I+ZyBLqUiP7vkPR5P=A48>{*Zf!&v;OyMDs+J?P~+QWZ39-6QkVm#^m&DJP<x
zTC<sxCrTyj_s^|;U=ba>{4c-%oP`mR{PX(1D}7<67F>^D66tLQ!mk_u%`_nogst}X
z=Kur(y(n@O2gr^};$F^g1ZLDB9T9fL&?-cmhDw{uSS&mw5>zqZrXM(8dI1)sbu_CO
z8QzRtHMKd9oVR1$2kMYyFgx>gqrMfp$<`|D7n5&Tar>ga*I&|6-v=m=ULEzlQ^Dz5
zf7EBDKhFE`{bz2zOP<jV?YZ5sV|1SVK_RmNKOmEjJQjyQrapdYvmfyWs%BXb#$&(@
z7O6;l7fwj<aE5gvZi3Sha1gdBeBo-bOu6_)xX4)1Zp}ck5P_i^N|SjP6Z>M>48RlD
zWL4~EQoceWcAPiC_~cZf-3y~&Uzq^htcV1Y4@!G*>PMm~oWj~uy+dv0i<(m}prAN4
zn(^_ISouOjCV5E`d6k+lN$aD#zu|kHUy>y1ZKYQMUeunj5jIY8$|E3eaON)H!i)!F
zSS~O@PDkA0UZ8Ui6$ZgNCqt%m$Aj~(w!-)qtH<e~w|I!&6PH>K)61yyGI~GjyBEkM
zwatiu@BH3BKUV()YR!s8MtmOaX;00Ff%%c<&F8y)fYp312Q(0rG@pl|ox(nOJ}1Yk
z&<X>8Q6`vBQ+Okh3C5>miC{c*57{O8mi$-t8J~7jef}bSBtDfsjl`#Cps5$1rlNl^
zKCPWj%#!2NR2hKr>4xWhk*Ky`PRFPGcd0)jDhL$uMjUl2J`GpQ1@W{c<6y0!8c)Nh
zIo6qIV3IMI3=%nH;(0*m2u#RTI>4Cm90i_~iE)FeRjAZvf2!Daaa7}F=wMiZKyWA;
zE7vN4U`#Ge+(GI``-28UPp0y((!5^(`ooW;=L+KD#joq0Re1a3*KF;r+OVneuPb2Y
zbTqVBMxa~ryU)<$07SI4f4y5S{~!FT^s5*D^928A(ZGj)IxdsrZ#SUn$EFJZ<{tjP
z$Ov`t|Kgbd{#)d7Kk=9IfY6#yUu^K{yv1la4%t-(tCn=$cBmJl)d(Xmm>(o#V_6sR
zPBAYL-O3T3{H#lONn1M(&WiOVVy%$>0#ek)`w2-IX1*8GeWJPztQ_J#Qe9O#iLc6-
ziH44qc$z$FEB2YeFA!M6EjmOcutNQDiQOH{_oRcA2MG%l5afFfMpU>2He8>jd<C_&
z7HED3(AA3TQIy<mHL>H{rn32iS@#j&^5x?g<|gTDx(rgUyl;ikbgVZ3)F<!uLQ60n
z1Rb*8x|mIsyblpXWtz2;5$eeMUr!M?qpx4e<^IUq>3B89F&+R`CwNVJD&M=LWoSps
zjhUj{Qnd^+VHFg>#?IPmU<T*#C(ucc6u0i%37nK;>b**NBzqkl5}#9%ef5At5+9-c
zVUqv35*^@wR>8Hc!Vqn1{r;zLR~`S;RR(C#|J3nst%LAi{>BeKwJ!YiPbzLV;NN`w
z(&rV5vFlN2?~%iu*!q81`d<!utS;~h`Xnm7JMz69fJ~l!{(&I$6L1i0kCJY3G6Kft
z**%-#JxRG}l7_zs=B#Vj409~cZccVPcTa<c;xr|BeXI<H9ahC_OzT&&Sj}~xI?Z5Y
z&qDqD|L$)A{@<DK^QR?7Pxk+4-+=#5_ScM^_=2VZ=%VLSlK-x}mcWAk`#BDP^O_i1
z`R}af_vybUt3I=(5B>M9=h$bz{dXSv2mN;!!K`8b9Y&7;cfnuem!9z5CBMbqmcaIW
zT5jxZvADmt(A0J3*f+%VVt}uf%b5^->+fh&Mxzz&=wlQsj2~*C7l`{IdfvZP--iu`
z-Z<6}X<s^#CUqL>9P6I>l&_r6hPR<oxvOc{7`=-YFh-}rYThqSK#bA#f}d6>T5yKD
zizX3`2i0C%`SKF%O8{+*TMZccwJL@y#(pY-*P)3^Fq8~3h9?n%nF*kBtB3~Y&vy{<
zu|x|bB3Uh@OE`nA{fEGL-bc0Emn=fWv1aJ|aeW`NM_4je?w3y1;m=KvlOJ5~#y}NV
zQcVXFk%LcgF~C(U^b$1F7P>;rvM^<g&`>83>W{|0K&XdYHXI0P4jKMrib6amy_A2M
z3mV7`pvCy^m~Y9Di--~km(4cd9wC8X$ZbmI65l~J=FcO6^gH@67kAo*XtHWhsmXc{
zzCi~{vo-z@htIEsrl7IU@mwL7z6K~te5cctN%VXy%@sZHaY7GO4)pv5Mjm(*7tnK;
z78pz+Qc~{D{PQAy^I*jW%m9xn@P$;Ba7sj&z|44*s3N=3f<TpLT?=EY34BR#p$iQV
z_yB<V2(;z0K?0NL`%PNc8xLFy{l<GN(7+cDq~kI<{u`~u(vMAbJm6vdi;PeQ>o0^>
z-j=X?i(EE{wV94yJOdradg3gBuJDJ3ivb!3e5iL!Q?3&tz6Nv(sZtBc&DnJlWmHdr
zl;Hh2Xl8PD;RXJr9br;LV+l#oc#1eKnNf#o8X-#GgbAexQJiQ(<M(qZC|`r5rG*d)
z`#T-o48e7-VUOD-@89*h-q>X*r^?@K#b_~m5W*2yD7AEb5`hA;HLJX}D{~HGqVb;i
zd^ye@;$R59v}|E92SLT8`#u=`@LU)G>MRZ70$3%2ayPPywxL}V?IcTc4Jc5#2dsuw
z?%`nc=7#vG{3}Tsd4Kzf6DYGrk~Gv;#COTxNBQj$W~Y4LM;QmNxqt7+|2tZ`ITuL=
zJPKHxK)y4%5tAWqVEn1c<L`o}+rRP8OCG<&evI$tU)=Mh*v8x=Nhusr`Tk*^n!0io
zjHSe9EdkFwJ9M2Gd+g#M)EbQn1a0lV2EAabKQHq((8sBjRe{j#764`#Y#0M3l`xg)
zi_290Oq~`}4{5zV#ZyK}o&8(RhxHaL%c^ivP_VpQfHNnKd^&YCo?h{lMoe^8N9NWs
zxQoL-RXRYY%0kJhnf4a!4+$7vX+?YHAvr@<B`PZY^hXAYs-dD=zNDC{a848bV1B8R
zkD`Z9B_9|EEOhXRH!rHs3V8ET>7y$Tl@D_tmx>hHd*$0<>az($0JzA$9wb9B+pwM#
zK|>aMaQ<G(>xBIKSjK)RmZa&ge5!c>WOIQmS1JrE__>5U=iX^444l`JY2Q4EmXOY9
z6*!krg<+<ygWW5~DIj?sNuM9_#ryvC(L#YRf%tKK)COn(gXUkj>!T`^v=n-~?3eY?
zReET%yui@NGBU@k=Znjqz<Mki9PeUWV!V5{yW^EKG@gU4m_M{0`ve`Z9)l9d_a4eW
z_OA!{ebA)!z{4^?BkM6uPv)q62qU=494~zh7e_+qj3<jlatMb(;tL>=sJJS9^k*=r
zk^xog&7<p~Z;0k+@_K~&=jJC>{;=hh<W6w?aUvncL&JrmNRx%~=W#93E2EL;UH3j9
zeU6ttl0TF_jjTT$(B<V1m!f}g{qf9LVwSxASWRxo^R9QGhnZQb0Dm{ee^>NL(+huJ
zL>!qrQO}D#3{gtN6vBPny8!1<k*)D<ZFi>Q#(aAPxAiHSmT=s4o_852fI~&>E#A6^
zz#;DCe4Ikaz+99IAI?emJtw^keuudDUCQAFzct9t`0#@j6Z{Tl19b{%3}XE{_z{1s
zz@B4o!Ec_x*)RN{ukQJ=(2*03b%wD3M}HAGDuTko30jknEScH?j&ePB3GWP{>PBdn
zOL!?ScS8VR6+n}DL#5PMx`HjSlGEqQG97CSMgZ;oah?@hNO~DpO#56S@jZfIwJ8cQ
zrL(OgZ*cqzRs`xW)<WEr+}8`}uc)7olAHS)$3@*2e?=7*b?_uS^EnNF#D^!zhwy#+
z^Tak@BI14<@RWSIa18Hx!-$qoDH|yHtcFXiBcFo>a44O<MLtah&c5Y??|Gx8(J1JD
z@Y+A$9V>*kZlXyAb-%!2z|?p#on%$k-J^V(8Q&ei&krPeUPZegyk+&mo7yP6pnt)!
zBgQ83VZcG`*Y`lX2Kl0VyKl36y9Lri91+`JL-3Mq{DCU;UX_mm)Ghrk3{M-&OcJw5
zUJ~igsG(}99FiNsi9h=EZpy6Q98!si<g|SW^7B>n4AQ^-llu5M744Lt)%L*fGub}7
z`J!XdqyBu+1*3^=&|VWhtn^pZN7?T=^^twr>q6D%@6w0%Iz{?4Vy|yTQ_o(vLI0q=
z{^c@aMxC*J&*$`$0l44uDOR~I;rcJ`F7n^?>lducL#Xr3x8`83%(p?fujbq0J9*1&
z-MjX>85^kib^%sbb>`dS0yy*#d&_*gQ{WhV-%oq}oAfgF`g#Nkg5RsSukbrUS{VFX
zdwmHTDEt;ZS`U82ANKmU*)D!RvLw9yBmQJq5Wk;4()d{hzbOLO;D=n0_><+ht?@go
zKKzJ3@Ed0E8?gWQi9e}I5ddqi(*C4Ey}y?(<w*ghT*~>WXco7MT*NOTURa8sjr)%E
z)+|mxoD;e&Yp%enHZBI<Nw#eyDL6VBuTTetVF7Szo|`B_=End4G7mx8?-W2#{^Ayl
zk$|-TfwyH%!(Tj4F5+O0j-hiWT%qa~RN+1T$S0O!O~Czl95AYVLD~Z@7a1kM{WzF*
z26OD$QAms7SW?_N*}YG{h5LYrh!zl6=A$?l#i+f}uE-Lv3bQkWwhlGumO^WXBJf}_
zg5pe7gi}q=-71zY8+{R~D5F=A^|&g+q27nK%K6=<m`?vUlEXciwGFM{|Eln(UjHX_
ziM~&zbI%7K$?^#3+4LbPUku>T{1M3Wqf{qbg{7A;{t`CR`j4fQVtiPj`{rQiw>yB2
z%+DWL`s4bKVYL15pYJ|hP|Z-N;(Yf+08dU!6>CgiN1etrY%sl4;QBEgU@$Fg4AUh0
z_NKHo_T#k=h%VxZG7c*7-qzcB%goOq8mlZeQ2d*W6+<2Swp;**-ehm#-^&8WhcSx#
zjz`-E@$2g1w*}A?e%*ukm1z7b*g)a;0kpafe#9U4qdj{Ier*NLAH{E~^fLT=qMA^_
zztcFpdjA7b;XeM2*7$va+Zw-a_2EbSf!|d27W^g%oc+R2)^|{!(9XY_U^ybe@_GRx
z=-$8(_e@|T@h<0*Jluy}X6^{kOkqlW_dci8XyRH`TI5*kZ&P}T*cXmOKR^OYCsV2o
zo2l4$6qavlO1*)b68pZ4u8NYUP;z5mIp1D0g0x<Q)j!e}$?*=p=ME6YYr|g$uY>W>
zd_mCv{p=nfp>BLR7VYYfhl211)q&TlUU=>I6JDqeyv^^`hu=E80sMmJy{3P=koM9J
zg~k{+Mw1)ECS)c&RH2=S+0SNmMzM&yqo2#e|I+{*0v=a1<BM<w)>C+(4=;Kii$csk
zUlOj9RBYZ0xFM~&$_-YLy9(cO9^1v$V=ggptE4dAQxdN@%+&{}PB@9e`1z82orH%7
zQH2c>JW-g&?{8oUHmF$)gLCn93&6+F9(kjRtZ76WO*_+>(z8jD*s*G{yN0waK9SRN
zRWyE=Ivl`EpQOd2cAss4bpBf6UWNCCkZ;x80R&fW%bLc&ajO^Xx_Oxnp7TYc9DZnl
z_I^ecU*rt-tPJNT^5cbg_mvvov8vDxdfyITSHV-4%EcAhTWZ?f$7htwPG}URWotA_
z#|uhy#z<@-nVjxeE0M^r4auoQ+#ZMbK;Z_}@iuXoTo1l`5ip;=oZ<}}YZLn|M+NGB
zFa1eE34Aa8^evFI`Cj^M@8SyEp-IW3i_wkAw?FW`^s~{$U3Os6v;Cg{e4YES$H^Eb
zX^7t;P!3@dZjx)`r1twGtmnQ&Ll>~p!5=r*H$R?3yZxEJch`ZpxL$a}_7h$~9eCyS
z!b@)yUfunG9XBWK2UGy;{^jEjM@x5t%6`Bsz-o9uprQ3%4tmwU-Wziv;RV-wagKra
zOJHoZ-uq(qKG%B}s6J0iAFlUals=8D_wIcMQa10S>wx~j^<FE%j6Tu7-n$sRRDN#f
zO+L?|TnPNfYX4oo{vq^#4s|+SLww1&Qua!F0;FS=pc3}r631FGgVK@H@ll?RM>Bmo
z9s#;I!)9!&;*SduB`at6f<QMu9CI~_aC!bp0xt*1KOSHHCcVU=U+cs7`Ar1*A}WFJ
z#d!Wv@C_V;nklwXAv>526|&FX=_1=Ch%B7Ut_q+i!N^xE?K>Dwn&04Wk%#X%7~rFT
zCm4pjkV5q$<Ua+p8*k3WJYox`Kwm<Q#<ID_(!&9A?I*B9=NT*``+=qRKAvJw_}0ZH
zVB+_q-FL<H1t9E2R>9Qmc^gHBNHnCNpmZaR9kvp&yD^(Al|$t6{<dsXuSWACo)K?G
z<kdUis@&a2{rzY>8OW`j*@R3Vwiiw7d_VfGa@@qjC9m+WxBvLu`Ctz>dm8_K^zG;c
zvx<>rKOqN0dG>ns27nBnFYbf(`(>|B^8r@&`c6Qr8*lw~qe9#0zM73ZuagR^<NXsC
z$@5C{(4&5P^uZt^7qmx&4~y~y^-1zi|GHzJ_Gq>0GhX`89#u)7M(k0G^`OGoqgm)5
zv`13}vt)a;X&sSb{%Hhyc%(`Rcf0xTCfTF*#1XV&8gsrp0R&{eY?&@o8}p?*O5XZn
zHr9n~!TB<sZPcuO538LzOP~${J9Ib!$gIu~P)0;DxssP?N%&2bE(X7&T>MVs*j1&#
zZw@Af4?iXkG=86<M&oySefSZ7%*ksBK=2zUp#BhkA4``y_VFf&1n)m10%9M3zJc>2
zXdmaM7);M#L&eG4ur5=^{Bzv&><^}7Xd|E~Ojoe<|6(6c6rhHm-yyCQd4CCjil4m&
zw6Tv*dRWe48-?XpSTfa-_sIe~bUXnFKQjf?AL3_Ry42w(<8Q}`5CP%m6W7<}=ZhYu
zU!z)MdZxzIv1TV@6Pku*3e$-!?KeMV{fkv;Xy;I4&P&w#SKtu+aK*jE$93^okzf@P
z!^RNqT%?!8+!n&+5KO!oh~{NcjPE)U`Kr>PSRYI!mB{`f8K$BDtc&4BR46c8EzM*q
z{*0C&m>>4)jTN9$php3y7H`;5QNV<MkcCsx&|Mpsa2>F=n3U_c4Cph_eiM>3A9tX?
zwii=;@xXfs&>d?ov8XEji(@rMDLFMZv&s`tPqtL5GzZHUh41$Q+ovv}Pp`vhqDos>
z+8+TCUy%<466$-Qkq`1p2oJi-5K2C?>XT250+HQ2tP^=89X}9~6#{`;KCc56P&o+C
z<)Bn=ls0RXN9s^ESE6|lOHD;8`6F42-=??}{)mz*nIV+SDSb)ugIUuEOO9buE=lqj
zCVWu@%|JuZ70hTQo49r9Y6_->LisYB&%!7~89Fplp0kzLE=BX4S%@<*oM_XNXr!g{
z8x~>;<pDC1UpjdP_cK`9AL%IkB|oklN$A-jT139LSKT7u6j8{A$SiW-*D-_?mQXD6
zzK&uNDm$=OP&|;Abt{<9`q8`*VPYKdjtCDqfr_kY`U26D``|81leBa{x>lr%7k{3M
zlAe8dMwc7Ac<<ssH5jsNl6*(1eReegD#l&K&PvwH5m+k59S&+l)@@L$w7CUJZh{)^
z@QlXVnjS?2qrdW}UpuAa6O(VdVX)EXi0Jchf)w|yPgsJIedXM4mF2*{CJUXIs~4ig
zx$4ik&D`b@^#EHcqIP11q=+gY1)ac^GqJ#k0U{sd$R(Rj1&^}9`AnSGL{C?xB@s6w
zMsx#-IHS*spg6j?1U*a~M3B^H9$_L_3LNscwy&UOpGf4YN+&wjos&dd5Dbs}LO^ol
zSEQT^luD#C#8u-_R)sEF&n-jQ<${5EBMr?b^d|k(H#ywd=s^N_m?xqRJrqj>g9~Lf
z4LzB%zgs3)4Ooc4m>-b^-aUYK-T3t^wA-J2L&rMsTGb10$2E<?Gx>pR{UpeGG)Md{
zXkrmEVUa(6Uxa8rDSp2l?e{BwFY^Ib^iKh_dg%XS_#Wj03w)O?^y7P6U3@>8*bu&Y
zeI_rZ#M(M^<UljUMi<$8u}H(yGV-RYrvU?7^%!n62Ec2q7E%?9;csAMtg7Wefp0vi
zQJePJ*v!XuXFH5vo=#g>XZ=RM^6~4E8pQXa0iEl&Lc1rVAWyFLS?E5winnFOt#=ks
zMpbwZ8+lb-+lDDWD55$)`feF+;_Y|;;$K<6$s<oYq99y9x++KYL_a<GyN?2`LpPrS
z^aNURbPtlk(0uP)k_Oy{4)tk(hVMV$hG%E?xaS=%MYnt#`CQBg8@rO}S>PM<P&HUD
zMtHCRMx<vN3)v_%V}a)|kz~vSA`^j#%SSoc5E3+!5BXui8kmp4^A~s(q`_xPsYf?3
zfYVQZ0Ap~(QW^1Jl3o)Sa~AqEaN17$XKy@p{*kZa9EY=ydFpk%$U_d3aqr5S3u}Zi
zyK<DlI03TD?uFAILl@@R=N(vJH-YZp3G4HC3Zw*osZm47I<kca=$QJp2lFu^>fj`V
zc;ukng6snUo%tT4Jm=177)3uz{O$w}2or2C!`p8%@V1|Jcmqymp*@9f!3jP~?8X}z
zk`Lw~vxuuN4*`rmU%ZeJYI=03lH)Ed!(Ofodnp;JxuT@F4Q*YH^0;bHlMeuBW+INq
zUusy1vWq<L2P^CDPk8U&|7)?Cu|s0^<5^W8wosnd;w$R*;{5M;&auImuIYUL9f?6K
zo)4B$;^12e?&3l5g_65AvL<GdXCZ4(!{jT%r<AM*0Zh%)UNTRk?C8!@yu~PP9sdeB
zfq6QMgy?x1ap&m?=+Ai?<6oJl66_Te05Jr4>R77pP;G<xi|to8l)pHPu%O~p1^0bE
zXJI&GApRuu^StA`)4;XH&pWnMeSQE#)%)q@N}opZ7c0@!%U^5)hQa*B;(TJp7}B3l
zoh1V>fAI)<C^u?;ad)!+F71o?-o;gYjOd}6i0}KLsT)4r2R(o|E+=%R0GptW>#}LQ
z4;{d^$cS+iRWS5X?{>$d43D7_k23I!7QJ9`^+P5x89`1G<6Hs*w_AI#(tOcE$3!U@
zw!WC?*Q*c{y@mG*FY)39L(d~cN%UL~99(+l5^t#OzT&&tOBksfOzib@)u6Nt!`7h`
zVvvV67NSy9I!qj;Jhbr_8QV|k+;anz!dsq=o+_k0m2_<cU7L*Pq!5tTl2{Ub53|3H
zU-y^3citj>9M4DJ-B;E_AGBZSt45`!Z>snUq3=c++fQFrUNU{d(Nobk5T%CbQ?FWp
zX~g@b*a0yE6>TR3#<;aJV^Rn%6WVy9Ab$-JLW^}2DZID@wZ-Pa=^8i(=$}v+u6R;6
zf~7)OfFKHXAKzOM`RZo_q0JH4o3Z3UD-g|x-G<<4Y6h>xI6WGXP=S2*eZ(8C1pAqn
z69eXb(V5mZf`FKxsTl|y^rO`m2u&AZaaArS*zHg+HkNhyS<=l{hoS_;IO?wC?{wUR
zHbyBhpM%$2ugg}f?|pmsVh=c)Bj2%!VqQ!5)df%xbgd#M_47J=-k{y?v&!?&d(`tf
zz45#bPTGU@vG@SImsGZZd*cPJ));i*E^ww}{cr_^z;}gk;}=mrLAjP(c75+-V_Nc+
z7@IMJ?=gx?(3^I=f`3=CN}ku5dJbj&$Dh|J0+_(_I#r7~b{o4Pf9l0VO@O8AO=W-X
zdy(lMdtPT9`UJ+0?DzN&pk-kEtM_Ak6Cdj5tNqXG<e|U+d7TSzZJyUzEB04Cud@&p
zaOz`UhBiWt{LkxHKuY9!_cTl&{U~+yU#ZiLKd;lEzny^2Q0d_J!iKAxM!SRg8U6nJ
z%Ck6Z&>s&XkK&=8SXJu%&1<3Zjr-#cs?R~vNA@?RPb2>LYp90jj}t&P=#RSyX375e
zCG=AJ2@BA}M;nWnzm@*G67TEh4`BbsqRzE{&w=xtt(e06-qzDtRN_4)W0dKesjXU6
zA~9q7;xKx6|23e%xL*bPG@8?(DQp^TSp;lUZ<OVkKv-FyIm3fWyU=*XR{7>l0X#M`
z6>$4=FrbP#%GGlUp-MDU*6RkABp%UqU`5h~gr7bH7;%Bd)Kn?I7xNVsp1=*y<8o;E
zUQ8>Lw5J8S`Uq1dJrTA{`mmYGd(MNWRk@VC$yhM3h+8+p?24)1lw9w}(%=VY4*YgV
zTjGZ=s|)|d|42TN{-*#4<9kw<5!-MDB2}O-=Q`miFxcW$+;J=i^-Na4-=JCk2W-RH
zh4T~Av-Em=IO|%+IvQ6ho2Wfbwd--<^Mv4GXu;maj@AECRfN~+g`#G|gK)@-4L?Xz
zuBKf#vuzZ5h?{wjB?!vYp%`#8MoSGpz;f{8V*#q<C7MP}!uPNc&O=`S6++|tZ&9Mq
z>b!OaGJAlnl+1R*DeC-}MpmD8M<|p-6b0GiSZYYC41SQ;zwvyoz=0-18n0=20dt8L
zm>+l!H^DEWfEIVT@**ii%%qtFn~3-A0~Dy4;8?eSy@5brkB$Qn5b>!33>Ta@3n&jY
zaSl`@LZ$zr$uK+*6;pyjVo#R-m^_qz770+LpSNmyiy;#s2=rP{kd(p1N4^*J<|QOW
zwm>qOT|`^o_o5<N%XXuc7Eug~E+wMJl5rG0w|XOR5>>u7xxQYVGV;P$kXKwfDS54+
zG$4o)kr#80SaC@xmkUaozDi2s#0-*qKua!{gk~GbJq%<VYoQ`{GR{AaB)M%t7S|2{
zyoW@O=B&!bscu+Ogdlb0w;SEG{J5?J{gB^d7@9INxysN?G*j}si6ws>n#p`Jc}#ag
z8TvD2K9L?bV4o)P<2qXA6xY329}|_TQfxIeK?%lz1Z&%^kFZeQG=_O>swUPw&|oFC
zZ#8CSVll9a%lbv6wmiAsZw%?5R6L2~4Ik>-C~Ob)is*Q<B5Rf0fh3m+ASFp;5Fp74
z=AuBIWcIPKATQUdkbFYU&y=nBDr`1XWWhtiMUwQmbsobH+=FG6dk}s_)--*QtrP@J
z5x#r73={vN)Z%?MgG|Ta8yi1doRU&{R5Y$%avy(1PAMumQiYz;Z6}eVqm2p;g~iAE
zj=V&po6yLyZU!j#cp{!$7mdQ{Osc3x6bdD;bwW-Zrk%QmznKsWv<xc;w5+RTvj7!Z
z#!ber;HH(9oe4^0cO!>mD*K0$ySpLm#v=LBQ=ts;2eT-Uz+0D-^y@@`Q~D+TwfWz9
z31u$e*y3NGDWO`)nms~Ux$lS&mHG~qTBUj@6cHBOPt2g~K9!=}P66XYrLIn{_p4MA
zesO6_`z7DwoA{E(Z$1Z>^VqFW^3Egl$J`an26~u11;<Wh_i#c`^)Klb+A#vXg^Sx+
z@?-7C%AK9TcoY6^hk!Boee$BlFT~*mzsm)#yT9LmoW}1J+}51q^RjjDBmVGmMFzhf
z`;VXOUq#S+$(d$dmo4VxY=dsN;+7PQ5VyL!DEB8uRi&k{kHd|~GmXe6X~cg)B@m}p
z7Gs&FtjH7STZ^qJ=(J-UCo)57E`8)9B%&J6L!gtWS<?4E<@QQ<&nlbgoo7yFQyfE9
z`Nt%Em?~T#zrz(U_!93%fEft6@dZxB+lU@2nT^8x&WDkbx;AmvG!m~g<#<I9zub5O
zR)vb7ErMA<hw)OFbL1{5t9)2f_8>;!{DrH4iT(W|TqS+v^l52<C94lw{klahGxREf
z#brcA@9o4Hwun!|(pnBN{*RH%ozIitI0l0d@wufRfr=)52*VLqkh4VYiu9A%T6u&D
zEOr#>9}2#{*e|q-RLLZHizN_ZVw5^Q+~A)n3b#&xDf}ydKW%A5$?FHKSMdEKKm@{<
zWB=DfIN-l#&Gck-JzFb;H)GAB5I#;LtnCdwIF1#h{|pg<aENWsP=&QINIv!(e8F#c
zsrCY^I-p;mgzKsPg6|1}uhK8dUE&WfH2e)gA>t`O0a4dreTJbC8j@^C0P#I(=b~yB
z6_fz#2@mf>Cmmkw!1@PN!Xo#;z&_TCNaN|<9^!b1Y62S;i!oq^UQh-5b)rC}d`kW2
zO(#A}uo2>+&i`CUG6M1X%(<RezDBhc%b5ycxPjRkDZ};9G&ECsG?AtKnh;6&P8FaE
zU&!PWIB9UyvF;`YqW8aCpisqPD&p$=%qKluyL-6K9PO&mSIPLOC1H4!c3E#F*ZVZc
zuvQ95_^y+Vg6|DJ-9H_8JJvR!s*vs}NY`VhV4O)HZOe^pt#to=XqnRe6N89R-=X@)
z&LQ|zbl4}8-S6W-7dj9Y@X?z!VpJb`nvl*=h{B1bzdHnt;?}Th2peC=cmvmJ39r7J
zCiMIFJJkm(K1MT>Q)(whTvElC3gPDa(Wl%Gu#D;vC}5N`FuDXBv!{U%%%=wZM_)i?
zGW9AVMYF`rU@2H2D_SFuI{D7Ooo4)E#C<<ecfbg~UwVb`KJb3&*Pg;a@(B<@2wPU+
zTj1j`xV8j{I<2wyk!RZnQ@Gwoq7j)UeLCc75G(1<YLZc1djX*kz#f<n6>rMxs9Os6
z8+#pfCl}J~0!grOH^9085BUhmc_^qIFxf`waXdzEEOV;#TFcYTAA0+%DuW2=;*CGf
z`DB6me%}!oM&=#f;1Wg|k08Nes_#!BJ)GVGxKg^@Dg~{jn3_Qm?<mcPmXA%5Z*e2x
zdpThz$$c>H2~87aU@iFTXkD+MCoYvmn7pYuNgwt3i$3Uw?ROy7dn0iA@m~LVhVTCd
zMg`ALx0Z3BS!!=o+gWlbi9gKDfiu;7-2k>izZ&FI`#gz@*6`IfSIYQG?Wyl%%#Gj#
z7=yh9;R}!m@+GMH0|A-&@KXFWs_!RW?+5tLTOc+LJ$s5#{bD>##t+si8FmLCya*{e
zV~6{G_06K#J;|Vd+=EJB20XExhS&;lgFAzitojfP&&hj}L2L+@<t2A>GQ2m?oeca2
zE-kb4yG2ImQ-gMw0H92UH6%<=1_EeR;!TFP9qU(Aa~DB<-nKqShr5ub3nWekxFB_E
z<0#-E?^rqu1vMGu6^y5M0vF5i0Z4wXH1LL{B>8&!A2Hu$6G{I%z$fW5fU`Rv$}v(*
zUc%mYBRB}gq(Arsn0JLt^@rx`*#Mi@n7A(`c$&Hj6e#avn!4+lsz82Sw(S`&*F8_*
zJr7X==|7+Cmwt^FeFQMY^cm5w_eB5xUBI7GSK_vQc^nArOX`2UlTzQ-e_v9+lEAs+
zvjr&lrT!D*Ue^Rd>dnE##-+|j*9DR-kOETg3_OH+y-@H;J<?I6UgDQ|z4CV7r!`K!
zPb*)aP)Y+hY@9%&tpXTc-&<+7IhKt|ep8dnpHG2P%vPxl$bT+am}f^1%(IJm!lVRc
zo;cz2mK(8GhVwfaGz9eJ_FX#90Zm7l;Q;P)Ufetn@F5d9rPn#1kAJu?OOw}e4edv{
zxd%@&aqt8OPA0%MO_9${>DO_&`5PEx-+tiDU5%PVT>p3k;O)~t{{9%1gMMxrFb$dn
ziInNyie^zcmKD3oQ6MG(Rwc<l_M5Fmx)4LV%0U1%a4W8I;8C0es+Dpy1gV7!=}LhV
z@Q<y4hbYJKDER#2vBxU@!AjQoNSAVr@+<nH_hWF*=%>EK*?eCd$nJhrW_Z&3aNa~a
z<x6yU?1D^!H@^<Nm+OT$wlR2h<DV1!@>L%!?=B;q4{I;s7mrR3!BCv)5WBnKC`KOK
zglhXDo+)=wqTly%C8~@(BueMtGx9gg)Dr!Q=vLRp2&HqB@6G!{se`fWbvvKyc794a
z2ZY!YLyHhEMZqV;;T`rR#Grk=y^CQCzMSE@#!LWZ7=x+18kG92VZmIC2mjS)V}L_&
zdcq;&1~0gs9NJJ6<WOBVIE?UV5SNpX>e{{}GZ)qX-${0?_f>zxq`Lk2eg)}YA^q9g
zIKK|)&5$9Ff8{8Y_`W}90#_b|O7eV4BegwDdcSyUfN<43itkZ&2EE`*`a1}QX}VyH
zpg*~|@>ECm%HNKWG4%yfdIE4f@BEv4UiM*hbH~FlJ-|(lK}kgTw4U`b7W+O4s3UF&
z)0Erqgzj{nz4Yk%$!PyN!9V{p`3V+v;0=rR(B$KcQbh68J=V=~K;i%ZGfSEf>_69O
zi0x+MK0mq&JV)L}t}tTang(c|3pBC(r=d64M)7squ<xV8*Y<{zY*k0$Fbk~n<Ak>o
z=S^6lj;wBU4^Wtotw<1cG@6R^Zvqa`9y#de$shei{`@QQmm?H^K8iS*xAd!*oSP3Y
zHz0q2@X3Skf}lJgdLTRoIf*2(uRpILu@inB`_uw2IEd!Rd6bCjf93$hzWvXG7-wJp
zXWgxwi#-63+-&&Mj+<=F&0I3fzdl1?>GMBhP~Euyx!HyE9R@|BpSIK0O}kK=uBTD(
znXY+9Qg<3T*`hSovtLxz^?x#qgQ|-C!l$rH02z<FQX^Xu6KbT6<~~NIKpuDX^wB+r
zN!|MptdhrFEr9TI3lT_?x1NWlqI(AjjY+yUKZ<cM1K;LfPxszB0`kJ?VbAu6zR4;|
z&hxXMPthg<UD_L%EEPB7djO;W3ANeNa7(?yzeEpW@|5o6#$RDOpGR$rMm%2vMkKwz
zvXDq6ogX3nI6rbd$5-FK;iFECpC9=QBcRWD(ue0qGNex<=STS7P4E23Q|KQ&KT>-*
zF=Nb!=)auDE7k&R;sGMX^PJb9hmTekaktQam-J@vd^BJ%|3@6508E*uq!M52LV{yX
z?dqPCx&AagrgtRA5yOt3&UpR<wK2On4N<0wbKP$b<1FWU?E3TM4#=r@!DK<M3bLQx
zi+}-#B#7-DzKk;g`5QDxpv>gc#ob^>CUzYaKAP!bN;JCkvu4qzh!gmw_I1P;&AK=%
zVN-u>*B!0L%eSb3(zF6I094G3!B3QywG@($l7Rrru?Dz}VY7T~S;U?4<=N^pPvlpo
z>kTrIBNnx6EySBJPy7&AcM@_NSVL=Ngtg+5_ythG86R=1zA|QY`JUA9Z7`Yc?M&Pz
zqbKtg7KTyg&x)}JI&uw(uRH_uCZAQk((GCrUoCr2;6;~i2V+L0;asi2U4`?5IDZ2!
zgF(&kt^4LUC&PZuifH+c)Uvl#FUgKbo`l}<V8?2S-n9oh)?~EJdn+}PGEJ7qhYL`=
zCM*x{;)b%x+IU%m=e3rhcb)TE&#Rk0orFHF2J_6FdgkBiL&=#v^qINtdFs1~4Bj6L
z2CMmZ37=zYeEwam`W!EPIRCPxPb2fsxz9iUjzj<8{JUH*OP+tL(M!$0-5}RcrV6Cj
ze>XB{!1>Ym6<Le0TP_pM4jtA(8|{KKWKQ0X_U@cqLzRdZgjW`PnkL$z9^1p~cizYC
zuc6e@%8IOMsKTpxw&K>YWZNX@Vk_jdaD4=?$DwdE3!_mul!X!$a#$FGLKhZ_Q8<Z(
zC<>ieh@h~W1sMARhXuHVf}Jd26;`mF1x((<dx*jzHx_#2T#VVR;OkNtm-IjLB5ut?
zIz}?ZvvJM2R&)lp`IcL_J$*S@Fns7ROxL2F(fFViH5U!wyLd|9i&nmog=7UB_3?yb
z7wrbkpT=xFUyBHASc{yhe7oR%d(c*5QOqCWEwmADAt0BV?Legn$jdroz0788xwk`x
zlCRJ2DzIVe-i&Y%H6#od-`_VLD-vb6R-sj*hvPUP@r^t*l)bROqm(!icLNfSK)mwR
zJ{Z@H0$mwbyb2TC0IKj_5hY6S)4XU9HCXJs@9t9X*<<s3aBvn@6Pnl0V@z6#euM^_
z0-CX>RMV+HnHH}2GjD@&P)IQDd!Y$u!MIr%aao56O~57jc16})v_n?mN&Mje2vdV>
z%G7LXfnmjd-g6GdS6>Jn(AQ<pQ&Ou&g`t=<d?>_u9aOCHS$T_KctPJL$cF%%oE^~X
zQQfa<GGQQJ9tE`=(L5F(*KX7(WADSS^-j$Xzt#%>_i)0m4fq`>WnxPsV+2X+3Lu4*
z&7HTy3wkvvicd_7#)mfRUUS{*7_8d3@Pb3p@;juCBySE&hTx(rUI2xNOQAwH08ex%
zYang%i78!$w3vNj?-!`CPZ61$ze!K-=jhMJfR$%Lq`4F+`3$NtE9ekLQ=W0F_D&-H
z6B$=kI^MB{qNGn)$@7~fKo8qCqbU^VsvL&Ngo<KWEZaUdd#Y`pZCG`wZJ*Nx4Rh8A
z{V_GuPngc34nPNbv|^Bj<3&;w(&Vg>p(j)Me?w2;d-Xj9>4-ua=k=aAn@G2yI>@$K
zHGDmg6$HOQoks8+gW%m737y@*#3@HJHE|}h1O!bTih`iTGj2Q<QRlw|4kLqb#oJ&p
zxdf+x^Ljy6!_FWpf&FhHgSN2w7z0aZ33gSm4q*&OY>M*@impjG|8*AW;`uM0)&WIw
z{;P!YfCw-UZq_}Rvj@HO{%jEzS`Y~=$UIGzVS8v6nkkBJW~o7u_|?seM}Z7X2<f54
zBTWwr{nkH`J_Ew|P5{xs{hM&#v6|w_J-J7si>XVr4$v>q64BB+lbw`0aXqQj>1&N&
z1S-RK=7Vg^IV&4MFP3zUwFLF*G+;b^Fop+z@aWene3$D?MVRS`kXuCQK8}#|JyY|3
zyN-uzpQnsa)UJ@1+7;S3`}(ZB>JC|TetIi6m1Mn=g%f4?`)pPef9dj&3<4J_#7FS@
z7JXf;>!;y5A5(E0(xo`kG7N~?y_?|%q`s{?`o>3WjM>}3*s^RMc#hwtLE=P~PFczK
zOV>{2xZpt!cz`$2O(J}IUCraY=?-epzjTB=Uzz?GP|COar13FI`w&_I$GRRP#YB9i
z-S8bUJcgM*1<eZ3tN_jO+;-<nJ9>)JHicZHfB9z)!y9EMMFZ#su;cp`1iQOQUv=U`
z;lgcMq#o-&pbYKCvadA;rD1}Vu^vE*hyiAacv8hVNSOv1y0RvQ@Lu~<uvgfOju9NH
z7{}N&H--<v@_F;lxKm0hb+lVpenM8NU0v3)&|Zu8coTo$F5Y}x7nYxdIJ}UbxVT3y
zyUHc(@y*hjmtvkL@iHkZatZE1Eg`)dS%Qx0SK1<$n3Rt8^}Jh;6Kf&kS)WB$>t#2g
z4<3XbI8>{mJj3&BRuy;$JuI-dA<r+{o0%N3H{KPFh~e>W<f-1$6v>u#;xxl69rU}c
zBolM@6fKxv*|$0YdkUssC)+=9WUuo1IbC<zaHQP8N=CDi$slqPGZ_1y7|=}zMIgRj
z0vUTEH?l$!7)-bFk!4`vYKI_^;UaO3AfcAzn5rr%b`bhY&h%sy)S6r#jXeH9imskV
zBgIaM|M2$r^?K;{T#{?{Q|Ddl&j%I80pDbhB@Or%+Si{3)bQ)>H%A~7{X8!=R^tF*
zl5e+2z^t~P4+b&rcALaB(EcNV0JOU^xVH|=E+{(`IaBPS${N7F26tC~K11`y5=7xl
z?UnU!x7F3B^DLuJ++i)Ux5cy`RRgM|u*^Q&CaQ(aEmk;x^}K#}V5k!3(@?3lP@a}%
zbWmuQTV%saVB#Su2#U@@dz^m(XipjH+ZJs)S!?89L6V!zLS%29hxpyiW<jmypc;^l
zYj}f|->Va&lPQqINxDk)=INSoAEBU>N|MZ5S~j3mCLdFd4qQLF{vYzu&+{x|UraU7
z43E4yO2;z;^kPN#JknYE{b0Sp^~TqO{ZyZ8r4QGGRnn)C_25qAw7h)GVdx)R4-OT~
z7|B2s<!(M^5qhch;Mbrj;N2x3v&etf&<lSJfBz8bTz~%>rA~p<DkI*3{e{%2Dw7~K
z8>688X_S`t$wCMe!ml}`r>vrI0PWjTDJ&j8WrP!f($kTTBiwAb@ks&`@c~yKJY{qw
z0jl`mYAA+^4_4wP<ChW;i6{LD0WTL$zv~*X2cakIIY#j{kfOu^XdPrg%>D@LBgDpP
zH?**_M-9shK`YAJSbkBJt6ApK1ot<xJXe)hv3#E@SFubVg*FRoX6}Yh#xA~p$cF5{
z`-P}U@BsI<F*9~_49kLT1V|51lg~HoB7=Gq=z|9!gXZOs)LqPfO6nNjqyJOD^cK}X
zI(L`pIr1xeRwrc33^oWWzVtX^m3&wr&;HAeOAs*3oQ9#fW>MxJuJH;C=QsaR0G8c=
za#r~A*I3mhWn|m9I7|{8lFWZw^rwHx;a>^)<OLQdG$#V}e|w#hY{34XLUKL(UmCFg
zH)Dh(`;Yejnf(U<&;Co0tnEL@sbl|vfNTE|Ebou~KiReaf@ov*f6(AO6-}5=+7yP3
zI+YaJ-@6U~YV<z9+IxziG6&I!EyU%*rif1xJ1KTs9W}!$oDa9-eg1;$YC2oY*Wjjl
zV;<o|^uzl{0o<=2h#ivjgYRh&J3a(N`aMD};zs2WB==v5YUL5s{(5m8NPlx7wH8PL
zkMK-3fJ4vL;4ejv7h%vmVBT>Bhv@C~rl^>{oSLuS#xTq`f$RF$Z_*8Whj6h_g^s~^
zZJZ26eW>~E9LM2Hu;Ec*H@J=}YwZu$YR9@!+3t#@sO;7od82`-Y|BY9Eel8mIBQi3
z2iC=Gc+i#@Uh#_$I%C{GV73jduen-t{u43>Uwy+we+CeJQP|^6z?EPW=5)OGL`b&d
zWcj^Zeuv5LRq}ha{NCA>ZDz>tHS#+~e#_<eCye5B+%3O*<+mwNa5{$Mw}t!?f2U(B
z`L)!2=#tZMuas-$_hb3pAiqoH_htE=FTeN7Z>9WBk>9cMJ3@Z@$!`z&JxzW)$?swE
ztH%9JaN8-rpULlL`F&G<Uy$EN<@Zkcogu&1$nO~W9U#B$<#)Hxo{-<I^1Ducm&or+
z@;gU<<MMlh{9Y};L*=(fe$SELe)4Mzx8w4Ahy2cx-+A&oUw&VZ-<Ra~W%=D9zYFAd
zk^C-}-#6uViTo~=Uj^Tiatrz0djh3UE5BRhccuKQ`!7rRW1)A0{4SN>m*sc9{NC%k
zKSj!8<yZ0T0x9>F-?QZRB>C+izishrT)CI8!-G^89FUq)mJwaLG-K56rH)gUx-7bM
zbw=XaG<I;$7k}{oQTHeCQ55MPFkTZ92xle;7!Yw#(BQQZPytaU<Zz-P8Iy2$tVu`)
z5)H{XnLuzof&m3$G`b$Bs96=4bv=T*3V02N8WA<1>&DgJnpIb$ux{1^@mTYIpQ@*3
zYC0W3cK!d~w?9cg{T%hwQ%_YrRb5@(vnK&FjLyH0puQ2L6_?Iea7}l-pP-$)ux42Q
zeRr^L=lg?^tn*tse|p>ynJ1=dgU^BNDtua&^)<$QkHra05kcIy)e#)9ISFB)bBA1{
zr3F1G#IwG=$(=VQpkK9ulKiP38D^KHPESpEIz4{atj0m{p88NycAr*Bz@w}|b+Z~{
zUzv4AYj8|zL)IYA8M^`lQyWs_`)u)?(H7{NRlg;9&)>5ewrraeq7e1zcqpVX5wCY1
zw{g}5LM)i-s5#PuEIfU-ESuuR1B99(n+BpQFPQ2{s_E0>*ftR<eV&Hc@o4OFzDqWK
ziE_dbW5Wy&c7*MT^T3c{lR{mdgbjmt9t|gdJ~2cE+1BFN^9|)oX`fbU`*p^^WqU?;
z-V3~;wR8D!sWNtAXivY+D}l5)WKv2q>6Okiv5c`ilyIxkr*+*9x#gi6N;I@{wL<!J
zuE52fy+-=ZYEU{WabhB+r+GUq5IAYPl5Zfn)NVQ2WcX>PQ<_;bqW*hFO(K?OC+)^6
z3Z~6?PZ^C{z8Zm0ib=4XO=F#b#tJu8WZ|ce4}%1i^;HxResW^&xsx86P^CTrX6NTP
zA>_t&J}pJzA};4H#y@Svg=#wqPsLq_#4BErFJC95Z(A9+1bFAxflzc4#MlGFI+rV?
zKm4@<mwP^2ty`9E*L7!3M^e%7PR+vlZyif6>71Y}OkVMB%{W+jEGdpdS{O%GpG^4I
zhsjc$3@=YwkWdvj6;JFu^{w4sCR`o&wF|{s755_mp#*{UL$a6Rb^&onkE3yKilg@a
z`XFk6C~H!7!xnCVahvx2*j-cWDH*&M7Z`2+K%mc#Wm9E)EZnHtV`@@OLG}q-6P`{T
z=4m`H$<wC|m$DCJHxAn2Sv722))~8kN%$^S_8D6O0~%(c7i6Ci3ZTzyP2Tf9>Tktv
z*;0npUp`J;No{5T+GStB7}-pd@a-sA=34zu=V35&(r(n;z~%4O^z&Rd{KunY?V%h>
zrtZuyK@qFp3C1qpT{Eb21YETG)y@O}U0}2^?)&v;z7AomzP(e^uXFQIR18APoAB;N
zkUQ@Nf%5Vsq~lg`E43h6(f8D!*+QujmfrvYPs1+AH-qr$BA~kc-$mi$oAx6@-?Vqj
zkfCD8irvAf^`AL{$#fb~{~f~3Mp!G`-?q-re(3Jr6W93+K*CcY*~zjR+GN{A=)rGs
zpqp)xXc7`d=FgF>#4hY{!ImO4vkU&y-HmR!yp<~V@85TKuWnz7#W(lUj`}mVj6w2*
z6|@Tea@+<WWJ2eO$aZ-snA>@w6Ifq5orDvr{h{Lt489AX^Wj9<1SfR90-X?dfq%K;
z@0kGpwcx)TcM+5#RtfjSZaDv}AG^EV%e!l4bnZtvaO3EypCV}IR%>U2G&6`s_tIuc
zkVX4k`(!r^z81<-yLWZR{TiyIkJP(;vQr1CQ(u8+R;UteRNmB&>>o5hh$bCB<h~F0
z>TmHoK1jbJboF4|L?R-%kpwHs-L0$QV!`Nq`8)QEtNzS~j)c)Qr+2=Kl68)NrJap9
z)sMd!bZSFOVC$sa?$vK}-h``t?MJ*@|DmJv{~+D4ZO?tmi0g14-_*3z(||2U^IX}h
z+)1mvh-033-V^J_kLb!hzi9FaQ-{|<_0@O+`RV5<LF3GBJkMW(nP6NUZkTC?IRFoY
z=-H*%gQx4&$%qf_xN}dT`}D^_h1VMX0+)3*!=MQ3c9S)dqPR>|-|eV54N51<ph?O8
zgBasku@9}P^Ci>~GVZ4`4i3>W*e8D+YP>rbSKr;I#vRV_WFyBQmU!Y`o2g9h-#E{K
z2%fTMn3nAxz6mOn4SV`ddY8C*>W&9Xv}1?HK<HS-I{L~A#}0w<S0g2OpT2;`sp~ep
zW{6>7zub6^j)aI^kJx~pD5G^9G@@`rk%9kG6c6dS-#5H7>6Px`#~e+K5syEH;sWax
z5^dewKUPrRb6tq+okYWPLxifmQ#KtAzv6rSpdkSD+Y|%zwF&4L^GBm4y#v&P<qSM3
zj>|%|dK&4vK7^qx?i~oAcoT`dD(?Ox2t#MY_3y!XIqphODBG9gmf(u&`{lT0e6<mi
zAK|$)L_KgRrF=QoK{-e04THxzNO5+oOB3;=a&W9BBH@%&wB~NA;`;4VWDMJzyonTd
z;wD{yn7nN#7c-fQdE{7G%y<}@($Ff)c{#H0Tn6*V`eayNOyxp3lewJ#Ci@!V&LQ%u
zxM%QW=H<BG;jGGb7p_#<*721#m&$fGXtV@`@xlT0S~rZFr7TX~M!yS`gy%0#OI_5u
z!bZB;$Uj3*=X+Etu8e2ND5Em6m67WRtcn`}@t5O%7^#iihbuC&9^pkSc6tE4q9z{w
z&;zO@4_Q0_sy&DyILoWhs<^k2&MeOBz)>93@h}GxyD0G<O6Teh(c&AWn+jNcG|@0&
zadmHLpsmukA|ZW~1uMR>A<wGV9eZ}b9ZT?_vGXkSIaPra`{lRi+;S69;!#xGXZ9lx
zx<$m?=M5}P;QeW$qpeQ#)R&H%0v^5U3#+_%<VMXJ&#SQTE1!R6kHch6s_h>B-564L
z5uWj&d&*@u>_wo6s&czuvY(*bCUqkp%Cbm4ZrMZ}<To{vAJ*r<jpX+d<>!~%1H$>O
zMzZdg>$_vF*dTLM56(UH#ZH(UxBV<A#iq1|EuK~9#fRtZ^n7nCJW~U9!d!T2pr<iE
z-qYxbPe_dEybgl_(yo+g`=}@L7`?U5I!RB3c$_b+9{nO5AC&Hqwz^MHx(j;IogLAA
z%1`Ki4of3F?S2E}N7!1##KyQ=A;-m+4v{_p{Ys|SZ;Ai(UZf(~a)Z{uwAlu2iKNl|
znrhR96sHpx&qr4|5J;h_vj8G$X_{_>(2zPqU(m=P!>L}HHrLi0<Gz%SZVesI9y+c#
zkdDW!I(8yDMcXmOPDlM-4>c%P=g|}@8i(Jw8%9gQO;AAdS>|7?_}_&2mnr_zcxoqZ
z%03|@70qksr!~ZZ@8PG&Er@ecXwoYQ_oX*%$(ZzRI=;5CtgABUt4Lk;@3VcCHR%nz
z8@eXFlG>Q&$Qam~a9`@OFUl)@S*v2lWenT_J+TenQshDe8&reG`h&0jo^HUqW^^Z<
z8S3j0!Q?ZG`o@Uh*faeEM#Z&!`vc|zt|j9<n<yMnK=LHqzomLudPCfHM6A^MR!91(
zxJ|g+(+{*3Tx_ISP<o^1`!l+(IF@Wh?&%FQ+S02*GVg@VANH>vkTGxz(q1V8-=6P;
z)SkX-a3?MkHh(fKq5dXPv}*91AUs3k!>S{9D&7&*OCd43x*F;oZJsS3xI6>f=-0+v
z6bD^LZ=1HQW^O~=J&>+%jej|=5f@mK6RYAHaFx1mn=3e_zSZ?|To5STcC3mE;A$hJ
z+R~3{Pd}r*CP``<*D<}LW^n!Bd~n^Xj?4m}CYVf<I4pf5N;qX)QuBnJJ12#v#!ZJ1
zZbP@#k6(unD)1FSwDZ}X#)rqbF-5~Bxe#*1lOQ#UpEXL39I*|rzBXYK+1R-qQ+C{o
zG|uWu-PjfjLNUrtD1KjPB;|j1C&WCBx3+_cd4r6wFB1n5Z@P|njUAFJg(6XJo2Rj{
zlNhLpWYS3&E}DegAXTquB_`Uf*RyH`WkZHYVk-SaI7VoiN32*$cJ4qiJPj%ZMv@|o
zE?(R~y8-b9Y?`550-cyi(x3-@G|_0x=t{T+9>JhPnNFZgk((R8|Ab4-2?ybJD!$Rv
zr}KI0C)mT^M!DeERspbx3h$8_WEJdAZ=6}ynMMMH;d?>Qu@7I9aBM_m6blkEU=`9*
z3hGan0-`_BN(cHQhMDf+?MX-sw@urm);i*AQamLdtaY^Vz2(@*z2%7dP0OKS$l}5E
zoA%>E1Y>b`sO}6gZ9&`{jA<<P$BfT|R?dg&Ud6bEk%({0&M2u~)KN3K{x?anH6t4G
zU5(dtd{^;t{r;H6!<T(0+;=#FgJq0E1FNT}Z=LgGZJ{+5#&_na>&~YDckbMZlcxbo
zQ}mDTUIoYxar7M|&j~v`Cv3%9%M!;<l(ljAw?u4=yF7~5Z&NDFeQg3vSGwR6Y!ZBp
zgfPZ64nG%HSto?DPH6L-v2_W|k9%hX<|=R(Y>ayi*WJSxj)t_Hwo%-_NoLTBv<dR6
z4aGQPN5XCJIL)iKkX6_}<|h+z9~-L6IwQ1r6iD+(yfN+_$uW!%r+GR$jSFeUsWj`N
z(inx3{y~|-I;x{}oQlGB5Q*-b<1WS(N{aGgVN4cwFFp0<!gk=gd-&x?=)#hR8{>|a
z3R|hJwxB4j3Aa;0G38AqLF_w68&)1bIFRkmjn6^vl|x>=F9{;ElJLECbQ(`XMv`Y$
zh7;d+0oD-moI=;1sq4mBE`?9T;#@-p%03HglN~P4BwSC*aC#<f@oYlSzyVFi(4D!9
z`U={fE1X|L-14u%eP-f)@1JzX3Aj3ATTRdtv4YmVB36_cR+L(-c$n~muwv7sNLE<7
zz^p0G@ik>a+t|NBxQ_emE1=R?>W_5ugn90n15ZV>tiew2H?hhj1FLFa=wHRdP$k{t
zY4uF@xATC1D)&z{#?8hx`T;}e>-+=`@zlqU>-<<<#ArQnQ}H&aipxCzIP#lyFs1R#
zE`U8lX?qeX9ww}$09C&&-gCzLflt-sLv~9U({<WcRod;AwAsC+?H>Ob7J<6Q4?`)s
z$B&TbBzYbs&!gpej6A#K`Dl3_C(p;qbFw_|kb0h#=SStaS)Ol}=e1HMN1kit`4V})
z$e_FB^+bcN?5UHKfIRP&=ZodJO`ccF^ON$tK%UFwS?Pa3URTPqU!IkopuAp;^Uj@E
zHtzAS<MOPARIIA($ZFWtN%7QZ0W>epXh1CdYij+6_!`+Osrv-Jb-yckSZaeiepZP$
z_M7(XKD#_6t=Y%y$|~7*PQx&#ry<RWrDuTned&%q3BiF0PXX3<bYYb|dlIsF<-$+<
zcUty5@7x)A9?;!^;ML<W_~YkeD31uBkJFsC;j_(CXgFw?Rn!>={oE^2hMxR?psCvM
z-8%h?_WZE^b@u#l`W5#4aC+YX_!;*6u>SD};K$kXJ-U4VKo7MkzgP2LwC9KIUv~ih
ziUaU{_WW@9GVJ+b`^Ve!UCRC`opA@?|KlIF<qxNS@c{gF2jH(b0N-~2e#Qa#;}5`(
zI{^P5A043l2jH(e0Dr{+_`U=1GY-HXALi2lkGIbqlU`XiB~FM?!Yx}GwqP(0cly<{
z+_I&Ax&eK{B)dBA1*M6*L0Dc13p5}loTBtMIOP<cZh5f(W&+|%c0-20VK$aI5N}f9
zZ_<=P`wlQ}X3++N?(x$SdE9(wh{TWAc)3&Jqcr|4Z6E3$KS1NF4wLwIPEJ3PrbZaY
zH2w#g7j}>TtH!4$NqmRKU%`zK_?tC;KCO9mkAFzxpVC5I_xL+Cz7$L1z*lR$zf0nm
zYy1v8Jp%s{jZZj6;umOq(>RHr1N{I0$FOd?8^X%Hd=eo<CBp)SXE99HkmYAGoWn4{
zu!-RV3^y`-i(x0j?-&kYz1kD^DRb)9Go(9f9CcVMkuaVi-NxgnlV_ZQa=BNC?W`}G
z@zWT(81`lOIm^Ax@DiqLeUDn~dYk!M8E&@7r^L{5GnUpFmNEQ_<!)g70fvt<+|00*
z;Sh#(3_q~sv(tiSf36%gk>RlnhcLW|p)S`K-z)jI7;a{`p5bi_uVENuSjzANhMnIk
zJu%-YID%m^!zm228D7k=g5gyRZ)Vuc@JWU_oX>lVf5mVB(~}sU$Z$HtR+iJ{4YHj_
zGu*vj+1t!`CFAJ~lNs*&M#(+M_)CmG#P9}&Wem?^ID%m<`~5bCe`EOBKBe~u#!vj0
z!Y^ic55xBuKE?6_x|G}vj0YKxV7UKl#b3|x3Whlh$1(ijD<$_j!$%oj&oGbSX$(L9
zlJjL)%Fx3wp5ez|D7oznS2CQ(a16uu{;lMK3^N(N#pP>e=w~>cp{~!}KdSU=87^k%
zWq2~f7=~;9qvQh&cQTA;*!F|sKhE%ShM5dUFr3cv+Kzcijyg)IVdzMOcUYj77fvDN
zy$qWfb}@7(Dt;5g4u&a16}^sO8$;J&itc9^V(1*E=tT@$7>4cmnHSeRe%pp8H;-~Y
zwN^YNCLh`FS_{6yf-kq=H(Ky|3m%&G?1K-z`+DNtA431R8_(PFhd=(le$^X^H@ZY!
z;fZafD=qS?EO?^@_ho+MczE0q&gK7%7bl$j@?qCo_%Y9Zf7ieNH41!Ho(2oQ;~%4*
zd-TEA6Q4WXJ5y}I0CUWrukM#~g!9ppl)j?e_S0XT`Fi5AQ<c4rAtwYs9(IKDrX1iY
zgZ>!PvG4id`cck?%?hvUzyCKAUjY7$!rOnH^z~5Jz;hpZrz`KJ=R7A2aPG@l`B+=x
znoJSO-FnAw`&iO1v!vfS$2Iz^i;r+Nv_jumXH2Mj<ixe(CclyRlplEZ+wIMdoP4v1
z-#qh+X}1k}J+b)>@QVg)Y<csXRk#1^^~AegA^ZkM%9r2$&cxl@K6%2##TSk?6K@{4
zX7)p;BEQR2e)l^(Km6f@Hxlog0Q}7AyocVr^z@7=5&vH^@9U!nCbuQ7|AT0LWsoa&
znFVjM*ysG`d2jqU|Bb{Ku7!Lb&uN(J$s?pd<`@f}Y{BvEm?-&C7W@bco@Bv?TJT{O
z{74Hv+JX<a;D=lA5f=O~3qI0<A8)}iSB@&*aTXkN&nP~&u|?r0Sn%2@L#EFDPg2gZ
zyECteA3f+lu@*ip`qL4TXOVeCdF$SHw}fV`xY)Pv#q%D^y5)q=ZrS;1M^>o&^U@tR
zUf4v>4d@8Tv&ekIqEF3|BK#yJ7naAelsrNTWV#d#^IZZvHE@LFS!9k?FpSIRGzK4!
z_vH~%ATwoJ^`Ozmzn=KWKhR#&mz;^+5b_8qkXdx;*MC0a{87$7m7~9(^upzBr{tbL
z^6Iw44Y!~@4sLznse5DAO`g6haqS)Gubb99B<5@wKitul_`+c5+xY(Okt>?#wT?SA
z>&a_ov>!8RTJGdaqV@e?!Q0BC`OVwoorf)cBk|6E3)f?nfv?WA*ngG<Pq*L~TJWP)
zxx)U*wD40b{8KFWL<>I2f{(Z06D;`g799Q`ZTdgUVo&F$L3?gnx;yc@lZDtHAAdd;
zgXIxYAoFaCJgu+N5t3(-xntU|-o5r$yAp4}MiJD{ov&K(ofiBx3;wzVf5U=rvE&!B
z;4fM5*Dd($!BYY!G~S=K;;<7czZ^FCQ@64^Z2!k!f6*ROT;jR+*eQ2rF8<fw(k_`1
zdcc>oX3bR{8=bo!{NhN9yy^{+^2b>6JJy2ho6eBZlR3!3?{C3rOC22{c@~+WOYi++
ztoQZAhp^6G?wBxx7D4F<$+O5Ds9*%Q=)>M+d4v?mq-SAtgydOd_ObBeEcj3*7nV=3
z@Vyp%yahkcf)BCaP798Q8uAD!km<JYon1TbxH$EV#FfL)|Nm6}b@RNx{NeD-Hxh6C
z0eIQqC!1z18Zu?!8;Q5YEBx}ezDzm06zy|5wa+Pw9^E(a+1i!666-&u@&Bc_Cby1k
zTx#GqThbq^><E`X!(vbT%Xi<l_@Z5jjn|_8#J0@+Thr28l6US-Z2kuGsTDVF__Ia+
zEek%`qQCzIUH9F0+@EGXJLKUJXMJ_|T`xX+^wVXS58d}H%HuxU|FQ*t$%409@EsQX
z6$}2V1@|s{DmA<5@SNt&4@^lq`P94bZ#t@d&a!XPA4$I8nd`*F;OB8$s=M#*ch1J?
zS9MPqbZjM?ANCI(iAqvPF?9Gd_&SAx*6|JxGvyIdAQQ`G@(3xA*;m1^K3<my<GfxG
z#(5nhjAIc?9w7xX@o+>QAq6t=KtdiN1v1g?<PlOJ(>mTBtLS0<$64^cmiq2z!Q(CX
zQ5M`~!Lha_kB|bHSlf!i2eCsnf3O7~V!;zExYL3sTJWJ3{4fhX+=7p=;8y-f3*Rb#
zq=kQs1wYY(pJ2gHvf#-Ue1Zj^X2IPSTntt-D(&As7Cglwe~Ja4Xu&-e{9Fs3ZNYOa
z_<0t5wdMXw<b62srW+&odkza8W5GKfdhROMvNsY}-AnPa!TEO!{(%J_8-L^XrH;t`
z$I%wNk41m11s7@F1qshb?$;a^JjR0evEZ>5JkEmmwc!0Mc)SJgZ@~vx@PQV5kOd!X
z!G~Dz1Pku8;E5J|s0BaFf~Ukrw@2~&OYU8{>$Sv3JgC3vYoBWB+x@VKyFR+^853_F
zF>{xRhbr>kHF0n4ksT)PT(j#V6Za>+&}rf==cep4adCF?k5RZ~J-}hX`*uW^r``9%
z>+K6LzFx1!*QBX0-G8?+UI%ZVFd*lwnLiwPci{EE$L*NA&HKfM{ZHRNYi;9{V`I9;
zjoWh6|6Q7}tS#~RmvMjbLH}R9?fqhbqqg*%4O2f~k3DDOLf=1sm6*6Y@yV^Y-zdMb
zU+Jf(%^LsV>xnOHf&Ab5Bqfc$@U8D!cO~At1o_8(o#OkVD%AhcF3++PN7S5o#pe2g
zF(rWqYTFW@{RaMi`ibMexo3C&6{ioIb?v!(rma}~+w&{BUhQaj?d;5FRv&vtTGzM1
zO_!gwW80G-pL5N5bMN_f(y9cXCBOW;M|JI+vD<U+?XABT=l*@r0t<hur92BQ{4xtZ
z=ZJvk)`hzhH>?+RFP|K|ul17Gv#zZI{ttyGY`pL8d-rFZvu^8oN5o%v&+6IlpT9l+
z-Cc<-{o#-JqxOB0z5j#nZWx{VQ2Ff{*$=!rx7?yX@PD6tQC50d&Qt#`UHR3CN95I6
z_}eV@USi=lAAUjb&0t&NQ$HfVgt>n`bN0};H}u_+wQ9<T_v|0Cq3R_|`iYnQD`j5$
zpmQD`w<%`zMLTA^XyIRK(f{kXoi|(^yDM?s>8QV&vvyTj_>WFK|MkD^!Tshk$=`m?
zEq8b~?VIavo^$=|nB;=&MHcx=3tnZx{TBQ(3%;?U$vbrOuEZC9t=dz-!mqaAyYBqg
zb^aSa&w70LACKDc-t*Ig7JiKdUu?mbSn#VppO@+F+Lid!bD00$ANYN(g}>B-Uv9y_
zeP;KVuEgc;$B%lXe*MSqy|?Ykq2ALHE>3-LXZ91%-!#zo{L*D_x%NW;Mx}p4#clbS
zvlgVjaLkKGyQjZ(Yu1LH`Dy=Hp8ZtEvmfnyy0h<ZEc$<U>-ER}_|G>JZ`~%G@43C}
zCcjy8-eueRdY;&P*?;n18Q<9W>)+flbNk7;o4;Ip!@@E5j7`b=KksV8pT}I`$xkR-
zk@4`hqnvLqx$2reZ#<EI!Hp}=zUir5_q_AN&KD+5%D!mU<msO4rjEbox7ll3udw8Q
zr3GJJTeoQJm2V{0jaKpCDhq$~L;wExjH|2DAMbqS%GEC)nO}6z52yLILw-(rMt*@1
z|98cGmmP1!pXC=$&-d@$op@^;{Im3LkDd4WyW?-H2%NKe(VwzU$Zb7!%_A><URPH*
z^XB9K`oftX?z{7=&E-#&&AujQ{Z)TBYr~~Gt~;-L(Z(_NKYZ>JZ*;!#$wl{W4Gh2W
z$ID*|d7gQA;6;lT?D)R?ce^&^zPL1P*}Knw(%u*>*uLjY&;IOg&&Kk#Wsl6<bMO9P
z4_)?1)zO)cEV=oayRRxgJJ@%|S<_qRWju528rR?Vta~x>l|Cz8esE;gjZ3}BUtfFa
zpkV%nlPdkEq&C0&mzQs7NxpMx|2JN{@adGy7Z%rjv)MOq`2cU`pZ6TUFXNVLzS^*K
z?I}whyL8@{5B=#+S&bEO<;mG4_l6w5Z%$m-J@cW8zVG$9b#7JY+6%sEcTUTGe9}LQ
zK6>rDhih*baLI$uY|s6D|1pzZ>;Lvu4?ebc|E>k=QdixzVBW6-BcA^2wiDWJ7?hE9
z*Ps8ra{AE~*Z;e!cGb|ezjCj==kS{8SEto9U%dGAdFQ{9+j8!&-v8I_|G4L&JCFGF
z2ad-wm*0Eb2{R^UXMX!&;Xke)8awNce=Hdk+>kM?U&+_`FFe(jc*_@vH)FnUh_~Pa
zEcieRKFER(w%|?+o@l{`TJWMDcOIXzWp`rBHOiim3sS2l+`De(;{#9sVC0UNmc6eu
z9scLDznt}_$L@T8`WI(;t~v9O%Dv;C&3yVlTe{xA(R+IGYUkCH)|_$f({(3aTDUGW
zf9w_M$8CGI->l{f@1J_%lb?TbcTxS!t+Sp_d*;d9;qSkGV)3<a-go!cfe&+*&EDI*
z@P;$`raas~EphNii8o<qx@*v#3p#dnT)V2SEphEf@#3tMqpGd(A<i=27-GTuTJQu5
zE-ZMg1@B|Q9Tt431&^`di5A>x!Cf1^7=2~I5zZTY=+7tY8tI<Yb+m~WojLIR8x1~|
z#pI#q`zKlOUs-VXj^j?LOpiRT5XT=k+kAd;{OU{oS+rqE&W+U%1y6nLqT^2e<o?C)
z#|%AZ&7Rn4Zx#*s(z#ka*K+k$koIw!2WKZzj*qFMTfa7jD>+^BVJh9YVG7Q!ytJ}v
zNu|qITjKKv%d5gS><x;aWRag=T<R*WsHiF_R>E~Gcafc3AW*#2Rq0#es_<1V43?2?
z<+-`#({i&jvU0rHsc9LRd8xB-otf(j*7z%Y;OFF&lU#Q0+1}LbjDms;S9!IovMT6W
z>I=H6YyAGIK+sn@mSpDRAXt$rL@o}xCO9p9PC;tk*%<}t8FRAIGPG)9i&VC~a-l0)
zN^&VZEX<vjTj5I!_=<zD2(<F@+$*GZ$(Km3v{L3r!Ucii%IXTpr<RoXDtv+BU=?;)
zQ(9Az!n3Q2OTFbK!I}WHgKyy8V&x@C&-Vq>sw#uUcqgMYcm5^5lAua&n^zWP1nEFk
z1!XI;veFApnsJ?9j$&E(k|xuUo{Dl`Wl)jAat2Myg^e=u(=^I2yS(yJlBGlI(KO;`
zReCFmOME&>l$@29HK*LS#E_Kw44T20OXL>5UN#p-zNsa_^2IuLZ6D_w#gq0&?9B`m
zFOu!TEElH>^Nf6={LOMv{x)bCwbBa_e_44Jy>rVeORJVt_^PXWPZuR)q@SIoI5MTB
z{9#^JzTa0;zF?_0Q04apf=j){3w@NAl<$Q{3bRyQ%`Fd>8ReI)I80M=)NU6oDy}Ro
zC=M+2Q5%=^aQlts71x#+tsMQ?wWzAJrowlk%U4-a?60mtCoD(j4wm^`suJh9xL>%+
z@$OS#0a{%3$pRrLEju?qqcA^pPDWN{dRAV+`IK*%o|8+Q2=2|xo#ic%G%YtPy&z*=
zL1tl2ZcYZ#=%DmrI%1omM$_{PQVVA1D~^)SEX<$n_2%XkWTbNfP0z?lotX`)#<Nok
z(mV#9la-_KtT`EZGYh?WS+i2}WLZcR(kXhrCwH!i=Xx`8Ox%-|PR54iXJ@6R6=cmx
zEl@=W(>ZWQG0k-8S@~(HdFiur(sQYt+5s7}W~O_xy@g1gmz!4TNzF;m&d9^ZsG{ll
z8F?rL^l5rpUIvupNZUaU)6+AuQ_ojSB1`{B(ZcKu)LY){9C+qzA!;8`<Jj8SY9Gc$
zUIo1jYx*dD=w1b<<SV|vKtbnR1-0D%o0MEiGV>X_7;a;I&oO+O;Rc3(WVnvuy$tVQ
z_*;gJ46kFjjG>$Jd6)5)<CGmChIKb6`&@2C7Yv;Ye`)(tI3I1Fe}=N7j^Ub{+23a>
zdNacohQG9ZZJdv`&&{}3!@HGz&vN@%o~P_AJx{@=o7irKb=)56j#Ts_hJJ>>ba|RM
zA6*{7xRasl52`#5b349hj<VCs@HgC!JohQN_45>e4fliV8Md<@VlUuwzQ}rBQm~Do
z_hp4AH!6K?M=898VTj=`?UxSDNBhOacnZVz+mwBSI4)#!e;17F{w{7;a$U!8IT>~^
z{H4nw#;JUDIsBY&9mAHj%04%@&l7e1a=q#L?RrefrCg}=&ExWZ#PwQNsOZij1(UfS
zT*38S#{J>?^A%s~t!-9%S91P?Sl>AIqu}<mpY7^m{*z2!&vGj{pXqGhSBxh!+{@`Z
z7}j#SB!=r*Zz-26WwWxgj$s?alxLXEu!CXSvx=VboPr^SDbFihyr5tcLpkW+)O?yM
z|CBrhJq%kWtNX7emrB>da`Tv9#?X73l50Mi^O>sj)G@z_q5l-VpBt{^oGiDV`5U#q
zG$q${xROg@xmM=4Gt~BLSjTdmnxC)iNI664bB^M2uv`-JlNmN;D!G)=N-o55Q<(43
z`aDX`Jx0kDv0M@JYZ-Q(uH;&{{rg#N4f9(VHceG>O=l^6O)S^S{C0+I)0JG?v25Sz
zs(f9{k1tTT|12dZCMdZ!mUA)R&Cuy)eJ3k9uPz7kYZ<nrD!HQRN=~r8Cg!ha*p;s2
zQchEH?kUQiR_3=eZ2Ogxb5BunO>Qm+^W$eL+&M|fd8aA4mb(;vI`@+)+>cMR^k)yp
z#dxM?bH5I8I^FN*wJ3f5Bb0tG!y<;ibX=_Cd~{sw;`S-D9USl8WBdIK+ZgI{bgWn9
zs5@PiqllrO;V)f|CeBBfLon{taE-Drd#<vtmg8oK<DMR;Qn)_Way_+h{J(<B+q74u
zcX9o?4p+Ef=w$dymp6s;(dBI(q3md3*v0dP4z@pq%Q<<jl50+3d4_Ht|C)|hbU(v7
zhQD-q1owYko(_&1T@0I>RQ+AS_D|;V3BTbg*XMNoO<}npkF&RMz3sJ(<0+3QeGjnQ
zM%EYPak1@drPsS(!6Jsu-zr>ur(g@ic-B|M?P@RU?YuzA>3-tp`QgKy-$fiBMsqnj
z{-fl*KPp(nu(?~|_+W=DZwo^g_s?w3r{Y2-x0CI7lG||-<KjWq&#;+cmxk*(-#;iA
zV(5H`=?q&K#$T`OadZA&E>Ai`T`yj4kIh`}QkK7-{nS;X^ou15b}{tUDtzUGDxc;v
z6kf-$iQzBZK3g~+-9BB6r!W*;zGQB1rCgs~>~~%N-ruQmxY$2__Cp=xTCR@g%kGh?
zye@_*41ekJdO06m-cXXVqm5zH22~C}mvar*<NouN+(s@}I`_ND?3ag`UdH`w(1l9g
z8N>Q+RIrTGUBobn<?8NI@=XkDZ&mVpIp2@i-^(q25B*WeRd5{qirZlk<IYN@S6rsx
z{zsL3E8F=j!=2op>KGS{H?uum4Bcy$o-T&XynZs8^ZkMCYhgXQpR{v)7{~k$F4uPU
zbMs22w}qjX>jA%KFXKW7*TY*3-TMBLq5Jo$T+Lh$4|BcDW4wv=#IxT+oKMOsrN4<`
z7sHm-itgt);9<LmvEAb?RDACO1zQ-p7P3Bu9Sq%NiZ1xRsgCXFV!PbzzwK;ykn?G|
zNu_JPSwYut8D}_Uoho-a`z3|zt(9@@|2AHSSjqY9<a}#cUiZ&d9%tU-`diE8PUd>*
z<n%49|2@XbbUS6eK`x*B7G-bBtqOK9^xmfM5JT7P3ioq+{)+Q!;{4mV9(8#_T<%uR
zcQW%k*?-H~j<?tj57$>bm#cuwJ&5&(7*;S`$@#Z(`ezv?aXK+s+1ti2<y3`tazFR5
z+=-lSzokCPxV=tiJ0D=XZef4w`q=-Fs^5;W>@S9G41ei(*~R(jcv-}_pJ6Aji{8Ti
zZ{hlQfMN6T%I+41P97(|;(DrMztnR5xUW|7O$@sjie-xKx`y>Jbk;MS?_ZqkztOti
zvtHe9n(k2kT+8%imY>4@*K+aPU!G*S^$b(EedziT9H*O7lpXlCzKmCO41ekRspEF1
z>nHRpm46$<S{}cfrm}qu>lpsh_BC@p+CC@aE`}-W=l8h3ZRh%!uKVRX%5Lvp6>NH!
z@%I#LVd(uo=KqcP?<-i>p`ico3buTpp!iThFGK%F3U9)`Hn}DGV+HFNHhrS-E`}+e
zvfO71wsE_9lKXQkmt#No{~tIWG;_PZg89R^-4!uEo$)p2E4^;^%NnL%&#-{oV>9#J
zk1BcRV+#5icHXSo`$ioXIh|mr+j}#&V;9>yjNx|fM_R6h=jCl||2)>~;d1MK(az&$
zEZcVrLnrGS$K{RX^dasq&Qp~AMGRXQh8U(yRQx7}9Sl<@DS92lGOmv{&i7gN=RC&4
z<>C4Fdu-POT<#{ePs<hYeRc)YN1vzib22Pqf4;@}gmk<+fy=|Ng<*(c%86Vah8+x3
zPU7+~4Do%~Mz+75`-h9$L&rKL-^I|w>-x@PnLb`Y!T2xT?_Hda?)Occf3vn@gKC!r
z+-}+#7FgnI?lf$32tN(SbG&J1N8y^Qsotg5C(B5KMa+&TRDQ?ADtIKre1@|a7BW1a
zq5Id$Z`1ON!+QZ}O|-n644G9`S$?T60Gu$r8$;sxWmV>W1Z--lB$9rlJ}u98S&gqc
zn4@<sWEU^3stF29HX<q$<YUQ3Sh5k(xd_oqHiG;Vy_18=B*gR@wc!WfconpTrTxi6
z^P8Bj{FYJSTZGLbuJNU=ss*kR^(5alzh=P#U%<7bSZ&=YR$FjLVxoKszt9)JCIZ^A
zQ?jVE+O?>rI_R43a}~R)$!nD*KI{VmANy`#qCC#4@dcLV2aAI>)gq(TSEA`$&Zr#(
z71#oklS5Cpg~$&EXgk2-;))udE8xSX8|<cmeL+_VwlTrR((=;E<APwx>T;C_UCAY7
zzLHDj4uVO6QkTCN`#r`^;0)DscvqF&$zW@_63pj<sIrxzagmF#^JY=CD|sQdGmS5m
zDsw6-q@iVhI<$IlU&8H|8xHpWWK}Mx63NNsbl^N;!UVL<S(Uy;Xv|^1Re+YdXg+Q9
z(OWyx%8Dx&`na6s(=r1--{roH#gIT<S=6H)Mr-U%TeKFT+huqUM{;iY1l_l^?PNl3
zWyMlgPF1Ckwtt1UeYqA?1@v|fD(1=2<wQEQ`w3rCd+N~qSr=e`=2r5y5z0rorWE?i
zr)5`_T*|w0)CLnWSH_2o+Mutp)K|(0B|W*KVnXtQ1rsW!$!%M(e^FXhRiG3ujp8$k
z{a{Max|fXNOJ-FGTE9A`QDD$D7v6P5ezP@O*jp{@)y`~Twbpji8BEbu^<qwReH(E;
z>=)?BL8Yxc#QO3sRrQr??>5vIETj!vDlp3$qiuaePp>MmP=%1)W&-vo=J~42FZazv
zRmu2YJ}slNcz%U%R#hqX_l37xQTc7OlV9w#Q@oB+E38^oJd0{y;azVOD71a56$p{?
z^r5x$F21kAUdOD;YV7Qqg%3i@m@G$R!ekb?aKxgj#Xe?Ze5Mgu#^C~AZBXQv**iW;
zDKsIK)ETW!(hY4oK5+TDT~jE}k-JBsXyc)kx21vmHLFhd71Q=V-r<S<J3A|ig!V~2
zSDvZJsuJ?B2~+hzxJ4^Stt_35U3jWSdQmSd>d7BbDtl4K{fD)NTLRjFVISpOx9QOQ
zlCp;Vl2%;FxrF-&=|wlOBNH7v#3C-F7_K@K#UE-J>d474EzJ=X71Q!d5a@NBrhaJk
zO?19d)gq>)msgh*2c*ZT;pp*dT0|_WKDY*RE4@|KRC{`m>!rBpx3<LvJ*v1g9`-1%
zSuks<!g?ciN(c2)91#(VDh}+3E=W|oFyd=&uIcw&YA<rWk*vsiIwL}d*ls%RR_%uB
z&*Cw;ht;4*iUN+F7e{-O;-#GygC3<NJnyxtiS94t4`~g)3$^*s`bXOzBmF~FI7R<R
z!<TcHV!ztVjT$YdV38If5Z@fPCEp;Z>Zl;G^faWefP*T0#nnEE>3&|0AdM+(c_|t^
zwPMIckrr0U#zgs-oAu6pO(l^ciaRZ}^b*XunXYI`LwPyP4AXrJRAFbKu*EbfM1Qd>
zzML0EN-N{JQF=MQFiI==VO*D)a*i%F_77XiYv8i5s;@-~7F8hVvnvDT)1$vcN=0mr
zs}&5(;b%#<_?7&uB3S%0ht{r&T2#AQd5Gy<Tew}qiF%Tv<_5}Mb*+1wlF0XC@3Ug_
zJc1f)G!OFu&}948TjOO4BO8hHeP?uHaI6Zg%A))q-er#ZlKm#~l7Z}35ft}|B;cvS
z9W^F%)#ztw6;;)k$4PqRJ{|Xr=qu&H%s|zm^x|MK7Z>s<0bXqI&#%Jh5#iALD0G*E
z`=n{<Rdaj+`9=xGy^PA5MTGK%d)jP2bv`jIt9rJ-pb83<CrRyW%%9RKimR)$(p5f0
zC|K$z3F?j$$aFc&4k|uhlWn=^ii^up5I)MM&8{pqDAEo?L@i5T4CH%Z<+rMesz5$&
zTO;o!AV>2x4%tr)cTzn?oQb@ZH)Z`roC&(smv&w>{bst2T_#IraU0oVx=rKkHED<8
zrO15>%_|Idh-hzNe>kem<RhP15pPMoX{NVSdyGu1XvG07LcWK@?Lw4aE(HGM(SC^i
zwWT%EU-df_q!9L*D8(n+w<^k>J+wH}#p~CYF6LHLm}3KaRC=HoudU0Ypv>o5P*aHs
zT~(#aUnO6aaN&iFnnkp_!>?e4@53?vK%eSU(wpJ;Hn3#FD+fw1wdVzLC4q6(VZ&8K
z{YN9^SoF~*fvoBYn$;SDN*}FF)~8M`1q^i(hd+(CgrwavaKlboUcy1KJXcJ4?$G?}
z|6J88l^c17+iX<66NM-`ME!L?DE(BJRiBTcB?$Q?T)ZAG#y#&4;~tbxGs3(<pbx|U
za`2X0c=Fp&eS}y8-WujjQOS|we|tEcYX6~C>y%TKpFIq%eDMp}(<2`ye8u%*<-6HF
zFT;5Z*Yo~MtNbs8o9@_nRE(Ii+9B``Xs_83$7}G5jB83nI`l#BjncIn|D@MEOsoiL
zTENFUq^3yJHE~)Ee!Fo^f}}$qX1=7?JWOl~(j+&4LjS!Sq}6Tk=i%C#Hzg%qT8o*#
z)Nkn4GDKR5H0z-c@3<Ng(U<5>B4qG8aNU~?l#+C6PndR4KITD~{x;k^7wov*A+Tr7
z6bWC);R-(tCF<^u@aG*HBY(uo4Z4|6JNJ8#<v}U*HwROY&&pdI0()YZ+Y?ZE#k~=J
z-PjnRzZqxd<6a+;p(KRSFEG#%e@u)>K^}O9s0hZHDEb>+Zpg(y4oaiFoKEIBI!1UN
za|pb1qDf&$6kR^84}1E;e0^b3)*xT!!w!LG>zW;g{&A`ukxsL`NiET`8(|aq%45jQ
z#P#}nqU8wF_G!Oh4=kwmN74Nb(QzxviuTa40c{QX_TS+UQ`R^{^Fz3Pz(GF@C8jj@
zuESolqME5f@Pi-i1@DygNRmwc`5o*)o<DW8+;(7l#eZRM=O68D(Dg*N{Zu`X_1gae
z?SCU|@!#09Ozq%lSySK2rfAvyz4Qk!{AC`5IhjCxi24im7MUXQI=L5ptroviO5JaC
zJHnpg9{Rk{XBU4wclMN}#3b8}zNHVk(sn1IFHAujz#eDK4nv~28Pn|ud(Xmr^Ma@e
z_%AYI2GMkRbiH8Dj+sne6Ghjbwg-DoddT_5+sFS_^cV9mF%QyofRA_lOc8k<0*`z{
zG0kibYb-I1QtEQF!e3&oLtw9-)M1`Xik8E>rlyFzZgJU{V-5P5-Ep8;VVA~^W@>k%
z99^hOyvx}`w7r+{O<-Ix55jaiqBc(L8GBhw5qVt;`hm*OjCgsd@lMBS%FL`sYn-Mr
zW(Zqn%F(!EcTn4CHexXKN&PKlGd+!ib_b0eWroi-Za`f6En?k4#@!;+&rikY5Pa?b
zgMIAO_Rze7z8~vEzWUJPPOotv?bFUr6j$vINi|}bDW&6>z<6gp%HU6;Qr|cISqndz
zhmPB3Kb;8yYuu((x}WOyh&|e-DtS#5-EMVUYPOME^N77~yI{BeCaGz+7vs5kxKKZK
zJ~pNFd=2mPm`UX|QFM899K*X^J>;6uuB~y5{IlO^yJjMijW_hrT*+?!NAoB1AWZwM
z3$ZhVc?;gbHAUpLNzwIycW`^itwcK`Tj((T7=Kq!S!&1R3$GDhdTaY;YCWFdod(LL
z$3c4OUb`7%pgz{{xInmRSBKS~h<TLCY`^69H7yZcq=PW+H$5&mG1s#m?a)UDl~d<S
z`Z|pmLVQZ8=i&Ok0(;+x6?JqW#@qE{r_om_fxge6Yn`tf*Vg+CZJ)ItTJ6*0wCNYp
zXC0^4KWg7UT<|}Y#+tqp{n0!K(|)D0Qn|3F&=ir^rkw6a*kjy7jtJBqXdctGF2biP
zH~#6+{>ENXMKI1C=!Zl#>(33m!{Tq<Up?Sye^Wj8)?ej4h|vbtAeOgd4sxI|wG(Zg
z#?&Op`q8J_ZQ2O3{n>|($7cPI{nmJ_6_fqVhW+FtU2pn+&Slf*sjt|zUz&eK9o!GC
z?b6y0y_g5~7LTdU=+N^bylbln##xu!4VqbRcIBqj)Q;*NkLc0!D$`EVWjC)PG99|T
z;T=guFwP;=?@!GS^nHRGX-s>q_X(s~mtWt9<C_FVPU@2Sj@>vx^K0`UOvfjE-+*^&
zOc8la6rHcWf5JBlY~`q}(V_KuZRC^$;uiWx3u3Sbbr{0^*n#><2kx7wpZGDBc`*;5
zezFmG2gbj4=;*@z^E||!R?JadkgdbG*M`{j|La4?U&`04Piy?u?bI4y?Aj^mip77s
z&6q{=#v)^#NZ5>bZpc{sSu)zgPqj-Vkq5=vBqJ{9ao5^EtmCc+>jej@(-!>b9o6Zf
z9F$7OCp~|~w}pDBB8qO8x}V}*n;vrd{=^NAt~a{2-k<3DC7oK%Zu|#Z9x*sOjlM@Y
zQ=QYH?XI=)0j)XN#X&neDSxY-G6S6C{f$kWAo_Y^y~*^Go)6+3BdsP15|!GW%aUHl
ziE#h7Nw3>IDb)UR<J#Kp|J&H$w8RF=@0U2p7dnpWaS7k}>5&ytbUW1X8}EAekXzHs
zI$KLG{kqO3Cg^<hd<*Z4_Q>a8V(uEm<wNbCG^e*4hiDzkJoNZyjVIRe?_lOq?TGn@
zYOfdbKfC^>*PqB{v%Ol^pImqjpi5@T#pB-JJP30#LAMutJIxf4*QT6qFL+0|hnyx*
zoN*cRVWN{X_0txtW$Q!7FS0?~X&1ldVNJ}=AEsTppX1$Gtv(D}u-<Z@_@9h%{7~zQ
za&&WUI*#I9)^PsTix9@JgK6`6o-qYugq~+ubsZ|M?_-5AFEK6F_v`qUL60nmqT7vr
zZqi~SrxVhAA?f!KJ-XiAp#N08w_sj%pfxSZgEZ^7r{fIX9Vb@QK@>eMXgR#I8zn=C
zUT>w?rR{U$y0`V#m9X>Y)aQD%=l^wmQYqy8%ck9J#Ju$9*tZgW^nYoe>0v!@$2WLj
zvHd~uV~ue?MUuMS^t=h*xa*PFr0Dv^J99nc^t_Z9QT1yXzjVT6%zq9PKg!_aLyaH3
z#WuPh3>ocH_ZzF-*7>}P*A=XCMa|K^ptVH1adD+F$0i+mJTc?68+7Y<Lb8;DoR1mz
zu|%hX>b2EaH#MzsV@;8s`{LbrDQlke`iFH~-ft-n#Vot>(7K~}5T@goUQfk03QQ4s
zt=E+ZG24mVx)Q|-I&|E`H#`)<IO};6kxYHoc@yy|HTkj4nAd7Q5Z_F1^#k#BdSQ&W
zx?Nb~nzdcn&4XxMw$6iS&S1CRLeGiJL)+~JQQJ-Wtaei>-Ou&7f^QXp8hsE&`&+Ni
z;TuWOLcrF*J{o&G_}BTmaqY6)b9pegwCjU<eGW;Y(p%T(OndZtE#B>=WVVNlZ^k@$
zC7vh!+!)=2c%x&q2lJbixUbS{54M^94~Y8t3#l^w+2i>OuS=VLr~0<WDe{mWxAk)s
ze9MN^M;)e|_AkCA6(yq)y&hX+JliHo-L7>1EV4;YbI8M3ky$?44`CjrKK;A^@6ekf
z^18P*4U*LDSGRL~tFuRXO`!HtXS63Xy&g~TEjTS6hEWv6dU_r=&qhuspnOtpj7lY0
zL@zU*htL>o=co0C3?)3+XP1<tt{)wb1;$+KL1Tnne3$!$3}H&C{j2Y5@a-W(BKnfb
zmu#%hlca8!`hExBkcv(OOve{unC-<HU;Mp{$06ext5#0AP~2}e<}FUd(*w;vnlMi|
z)cMEHUH5chY}2tv+x_3bR@|@ZBg&6YM*H0T1mYzAt;hOa?sv;9>6?&t4QRdT(R%B6
zA06SQJ#`j++HPvQrku+nXIf0UNe{kVptI`%<?|bh4icgiQ%t%=$HA11^vL#ZNlSDZ
zE6WUeCv4R<W0o)8w1E=xLFvVxBISx)VZL=7p8p~pzCEDD!!Q|X4#sxULB65Gw1@QC
z9b`{aFZN7<E-!d^2fs(sjR$ED>9Dhh^x7R{kL#%judJ8!9hUU_57M59X4E5elODVi
zZ)b|6kv%O2-;``ZdOvu0N4rP*cF+!{zDS3ie@L%+gr3GT68s;GPD*E{-iSOpkrwYn
zn=0k?!RqYn#m@CMI!Q74ZJxm+8;C}S*)GX0yMyK^!r+-w?qsyfjiAuK<#2*$mrt3E
zEG6xW|8^T5<-gvbQ=ZZ$&`tZL9iZtW8EFpIr<A4+@;^5XrJJ|u=jB6b=%6w<kyao6
zUi{@YWJorW0&^CmAwJ%%)@ph{%BR!do082)zaBiiW7{KL(&nF6F4ARJ-=yE}p!!~q
zJoFK{!hJWD3p~6NtJz^lJiGcQdGn|P{&UMf>GwlF*+z%izEYlv)^B2zhWL2bQYExG
z)1E4i!S8^5hiW6KH*=!CM*Rx!YWB!EWrBTN6VFD=ni!=aKHeqkp-&U2u9FNMEs#B!
znAn6g2P0?ZJP-D4L^`}<rn3)2;@QP*lD9j^ZnwePkL!c6XJs$>xSs1hpEe^OQ;Kv^
zI=s`>!$gzP0=W*z;N7eqavMQASlcNv>9Xseq~GqKKDLs1Nw|)wi>cFcgPup<BE%`g
z5no~*=}3q84=SPVXovU_<h=a!e0Sd7KmX^hr_X6jIrVQJZrYzsxui|Is5($`k$>ru
z^2$jQFPdLdUQv1xzBuGR8HAIH7nPni`J@v6(qLIt<w=vKUc|3lUljgHrIY=o^C??8
zPT_yLcH#f*w1RB8PzJ+Krtdq9D^+hs;|I`N;vGy|R7vtJu-6T!<Q7$qOG%MsXo7<j
ztu|a1g)c3obRq?HM*8VJ_u_G<5()2%iDbZ&Q&LJ6EEJ*$IL)z7PRlD8H!m%fWXeFR
zi_m5htutEg0-|+A(XwRP{n0cjCr&f-@JhM(XquFBM$rnSTv9Ym%DF(p_sqq~0V)>^
zS<U(-J}#}eI(T*s-b$XcAV{B>sU}772arjF47~^T(Il;R9DSBd;C(iEzpL^Zx45bz
zxQLuf?+OOdhM0c&<(HSvhdafZE!vh~$+)akS%&5)+6A%<>rGmLl52^gDY=cHwT(kQ
zwW_QuKSn=7J_;XKi%U`Wi9-|+&8KAE0{$N1s^0OoB-&7?>H|zeDKTz=X0(sVL=&Hb
zhBnA@r%9R<?<HWt{A6}Fz57)MhQ#5fjlh$!c))lyrRhNb-G3Bl^ZDC8Ud$y&0jJl#
zsm=~?IQn8-n;4UlI5b`iEf^?<P97kJ<_+l><R4hHcr?lfza;+yr#<+O8A4sUZ>cy|
zc6v_hb;LSEEP9}0K&%)rxvv;7v9JF?dM9s%-ZODZ!+*>W=a~PI-s?&4tvKB!^`>aO
zx4{qpjlCa{-hblsrPS-ydh7m6z0<crZw5~1;y-4HU+evE?Y)Kc-i_1!Qg4&i``_BT
zm-K#()Av$u%l}Gm`gZ7@g;PHMV}`V8z5lHr){@?JIQ>!T?fPHo{fhMd2d6$S%JzE{
zx8H{k)E>+}VqOpHD~6R05W^<Ni(z?AzaycqNGR<u5`ZV<4fIF#Ei;{YEz=A{ngJpq
zU`ca;e!d;WNPZ2cH)VNJba}S^zo<MTNA(p0Z|>I-=Z`Jw<Bdr<5y8kq_8qLR4&Z~<
zm*9h4IQ<3xF+;rC2mfuKalH(^6L9(!{?W((S9)tn?=qaOlX{!}S9;q>?>jiXFZH%)
zz5i`rOm2nVQ*b&R|LEgd?*aP^)mvUnis}RLVn80omspHBGxeA=kZ9hq)E9#NMO<mT
zXu^!(PW;y*tFdvoH~eUT#GeIiInmH=h;QO%8po&sVpMRT7==DLs-V9Zg?>0HZ$yV<
zaGV(YLEpAmf1i{XuMlGoj~9o3HAoEoXs{T(eTaxJ9VUt}$r+Q5xg6(X;v+}*5knj!
z1f`|+yB>Cob;b&3aFmFjoFq~*vF33$*79E=8)Jk3J(`B;=FgNF>53CWgCoUI$1u^C
z^KH`kmL?(J5h8><uR~{AtMdgtnkJ%frSk~r91+&p9M-AI;?5G{^m8zO4eJ~wqG`D2
zGGyfVoEPJl^@!LP2cL^`g*XrY={wjTphwe?sUhR&-$(REIb({nUk{h%YlF<jY}~tO
zJ;B38G!4(G4H-RuIS@=V;xEmY2EB?lJ{+eb@Q?Wt+IZ|Zacm6h@rLyo=~TP!C+AJF
zt(Nu`E%;Ez;EVCyTd1M7YT_eD(mX3c47j<kpW2Wce3fp9XhxcD{8w<gXdLaS^rvOQ
zb2&>)9XST$(BlKU`gimTnei9RNmza0+zB6y#OWyfV{Yd<Xdm$0QTm4ac@ICCGB(!~
z7v}4@pnU2Wh;btj88_5;!Q-TLY_*hI)s1CNYuH3}E?z@<`{R^=|Ck{uJ<6LjKqMiK
zBq5F@p-m@E9M(0o17kdoM`j))N5zSOTVZRcPf<*YiV@`Fv4dm9V8ogD;Be7$i4YfG
zighDoH#Q!7P6~!e{0`8Hhz5D$o4A=~<k)_gBP59g$50XP?^mQ_!b+sm^*{2s0b-=%
zFfq7mU`PKpu5&~@YHxKUC+`=A;C^AS7#dLb3)Xg!^g8@97N_IzkMXpJUu?>+d@(=_
z2q4B&nI{hwgTKJF;q$0#uJ4g!>HZ}V_Bh4Ro0UDfZ;Tv6bE!m>*-33!_8IbNk9mWo
z?ycqNr1Jb5r*C9={0Cp2=)N6VD#X9=pY(=~X?;aB4YAgcQRR)+;lCW~r1-zc&=F0;
zI<O&Qrz7Pz_>MLHn++Y&G>kQdjM6b!#vK)J28k~4bFUEMqp%Ju4e{TQvC|>0M2yFO
za+~%Cz6KOULuDDbU0K?|kG~3WFRY`lh^8UF8!~n}nvnhl{I?i7qG@;*XUOQjqI7YL
zu(Y9{Y?rS7BJqQ$9)?-1>hopPK6{&kSn@FQx3<}}yU=FW;q*uR#|&vY_%<6|&qd4O
z7yR#pnz1x5DIFxDX^1_BjGcc|R$$Ew|IXc7M_&<5Lwhr1>~wU2pM0$l1%{4j8rqv7
zqsGd^#DLvutR%n6m{~ehv_MbRby!Q1x==m?x68W&vPlS%ZARYFG_1!MGU4_y4EJ<&
zZ-@Bb>;0XzPUV>4#F&wQF=L2Gx|zoei=4H-uYVKueJf6P;Xh_b%fZyQ@=>A~@VN4k
z9B*h`DRm0h^_Ual|5>P`aU~k3cJR|O%8$`)$<-*tWB5;cOSgkTBASML3>mw+aNmHw
zi2sYiI{J!e8s?UUjGYeWjY2HIf3u+@nufM&$k^%V0zbJ4@z2l^O+$M$WbFLWg7k4W
zLC>Ef{)ncbZ5lGVUG)}QJQO=*J2BP*thj7ngV4SPqJ3d*lBe32oafyv=Xq`BJWuKz
zGf0dHCWtYZLyjpJEXGU*9vIb?)G;FDuxsOXG)wz+jKY0YDeki(_gH>wn=X1AZMqz%
zD*WTV@nG7t@^jDm;mFZ6rx+&Z6f{5ZldsIVMb!MUXL?mmC;D;%`tlGl>~YNFjPzF9
zNB;%3kH_f*{NsM$zp>rSXXH`151l+(40a@mz9<BhrNvqn!!9#zZ`Udg42in0&~2@^
zG$wuIv50Yw!=vYnyiT*8Z2JY)xUBxZzMbM9PIuuS_a0*p>E6Sp-t|255Z0iqHm1A-
z8>iwl1OK>R_@CL>OMR<)9U2}3i!AL#@txuLKhMgSZEXbF+R$)Y!!Rgp+l#b;=kEvV
zOV(Im+Hc{F9NiD=F8#YAcX7r%$s()zDEcO1)G)-TVK<|X+QlL{zd8)@XDH%NBG!1E
zV$|*t9V&JX!u<l`C)QDWyZ0qOS?hMtyQtgYI30n1-18hv-6}uY-_JK~5#nw9Plq}h
zf1`04e}`CT(K0`!yJ#!!Gw{ELbw}e$cQg%iJR{9d>2`0!xQhR;Sa&q8bVt)LUK?pt
zT<I^@`qaHfyl`z7;sN}7-{ZN6f$KQ+ON@!uI_^UL$=~ACjeo4?9!wpZakA%iZ)+VU
z-Mr@hW%QSk<NArArAOiZcMR6#Mu~wuCbU}ma?iX~tW$M4NZxnTSdwC!&a}adk-gDP
z8NTkTo;T|HvfhLDR)21?=V0%LZ2G#4A6t9I4{uoSV8nqzhy$35U_LY|Frq^~Z+JWs
zamX)HUe1GtV;(dN^Ps~p4;m`Q>{j!jpS0hoFS8zgDow98SYw{V@!V%Jo*7|HYvfV!
z!a4ac;k<cJ*MJVS%0u?cd7LHf0rR(e<|50Y>fPEuoE_*NBXK$k|G4Ko`2HdLdy(w#
z!FW-$M~K_;?}nPObkBKEG{h()UAUbM=_`gHo)4Kgpew$kFRw8V5OJ7y;y31n_$T6(
z%m?w)z^!H53z_7varz$rxW77>vW*-QC!7wKz*8&v%z)~l3t7th(BQG6<8!QCfH3;+
zDz2HhqhBA<?*p|KsN@e5A;_lw8+#0;Jo&{!lWT%Q#Y>QR75}v)C!c`~k$5L)*K=OP
zH}R-6u+hv*wb`Drrzf4`fu1w{#JsQ>dHmG)YK;#n2H5n~pRqpO@&W2_6HYJSANLbu
z4|<M>_;@ovdzz1U)XyRMZH4^@TF0^Uw_eL|RA1rzLdK|2AHP~_ErNf>4vWS5!4NzT
zNx&Q*kDMJ2k^Z4-D<=MveuSRzdb1gWXGZA#slJXD;+oM8<RZiw{T<>({QnaUBIt;L
zyS$JmIU`*Uy;{GF!&v($=!bb2o^MaYJWQwknJ{s9ycizrFNT-)6T_iv_{78xvNHyD
zCJn?RQ2fUoO;!u>8Lq!JaJJ8@`m$=9lr|Q!zZ&EaIrtyVX~*Gu0sc>Ayb9Ns8+^il
zWAL@^FywOe$9=*m)EA8-!~BO8X`gOD+S>;^L>BZDl<D$fysDkkx;)mZC*s+CJoYz{
zj}sjtalYYm)I)#5W&FjuN&xLKK32pB@I(?%4A_ncG{+oWF9)Jg8Lr_x3Ci{hyC%np
zgrTslAHD^MX9MB793F={*(`=THVS%{V2*8J8C~CUO~1bwJh89W(LYA?pNO(+o`$A<
z#x>Qgs$m6XdrZMKrz1Wc?+sN_>#>K+dc=Sb0=?71bAnF$t?1DEdy{b84*y#Z{Y`LF
zu8H$BWxJS`@<~q}eIV!s-Od)RgTA><hndf0n|!pqmU|p}DM$Uk9{9ufZ^6HJ7RnDO
zgt2`R+ZgfPfBgDLVVFod=Y49}{kcOlrC=}dXAxQ@XrWW^40}(6*8VN_3{J#5PKI3k
z4;b$tSNqS1Tue9YnT+pCbw+5-)SHn<hmr3sju?@Iv`q$WJ!q|v>oRC>#b9q7<zeLe
z6=*G>IStx~KKSM~XuTc7U>6;$Wn>Yel3@YEvlu38$nrB8&S4l}*u?Mwh8r2a#jum%
zcMONHUTxof%AC6O4EriZ9iD>IQ5Vm!A43H&C4i6U*v|U089$Aoi(y}epR?TC3@>52
z*7vBzuD6-LmEmTKd<uL|M>fMUhF`JV4U9j)@KJ`F8MZPU!my6v2bO$xTJUVNNjfGn
zJeJ`Qh8HoELO6Z#y^?>6;bw;G8Q#Y58iqlJr3^n{*ok&eN6dE$j$oL~a0<h0h8Hue
zV0ab7n;AAUe3D@f=kp%pUojlO^dyESGMvt^mF1*yI0f0xqZ#hruk3ARypr*BhRF=~
zeWT<aWc($@A7Xd|!!m|vF&x3Lmi>Mk!@n{7Y@gEm1LG(DOW_wYyocd?44-280bNS&
z2F8O7M=;#~wc@X5cm=~8hT|Ci@RgE#o#CSluV<LY@HB=Wf64hWEM@3n7|-zIFO=MN
zhASD)V>pK4d;eB)L57(O-{SH$GxRf@&QRCq?jKe9wG0<C^fEk|VGP4H|55S*hC3O?
zGi*bwrsHvjmov;{ID+AHme+RR_k~ku7fhOXaw+{p;&umq#F>7|3BRdWT#jEZ<{v7$
zp6F=-AN>l|OLT4f^Q_m4w5o#Q>Pu(&7ST`Wh=vHBT2WC|B1Bb%kF#oZc$cPCEh_Xb
zRawyQXJyS+zZH!YLdOino=NW%c$a3>miYYiQ$cR``Kex5Tv#Q45ZUcMhcKPc?M}^@
zIlJ&|{J^8z?Y=<3R;4DZGUy8|z^{=}Habhu;FwWRR$iT2odtRC(z8*zCB;i;;>YmZ
z?%5fsl+ip>+l`JHvn!Vbiv4!NWJr`{l>cFl8R4w+YyAGIK(IO^5U2{!kNnzdi7vo*
zVg`QXhkk)f{+61zIDlVAvQ5XiM?8V-e^9CM@&tbM(QjYIbIv8h&w=zlDUG_D?+Z|l
zw%Kqg3+Gbl_8Teqr-93T)%NMmMK0$e(N-}d9X~i2#1FhuMl+ZGglS~ecB_1^rXhpE
zxs-(%L0(^6bt!&}u@_^`hVblQ@xt`1e6Ke(FLhSF+s&josd-tcIR#-nV_sT@H!CMI
zS5dO^eSyX0B|emQaXEgfSGBV@r6+!(D9SjTsZ7JPefHKFP2k)^HZ%+Q{7YJum0q2@
zK>moGZFWX(Fi+Z<MU_Q{ioOnNfAk}1y*5}W4EfnvVKM4@{i9N*Rn_#~Zpl<}nPZ0h
z$@Oq|IXGkIQQD=B8T@XMU7~a6T_7G4Gg3=S^Lz_>6TqG+ZZmVri@jA9<t0n4qO%YY
z(EMknD>p?#Pzt??k|AcyIK>h}D1{rj4+Jm8!pkBaxh)*Ys3d7R?&bLwmRBQY$=~;?
zM&RS<LGjNMl?)cmwgfqrl~v~Ukls_Z-mrUBAjGdG2a799e7OM?g?p;+(LCmn!Za=|
zMgsMFmMUOUVMUc)O&WsIk3H2w>yoH?v?QTw6pxtoXd|%7645OpaGV*?<G5Z7Dcfp!
z&M_m1E`SCR39l39NT*Yq*RD$y;z7rZY9D?jI2a(|$Vfs}M(rlLwr_LHSZF65B}ggZ
zo3nKdVsyqY^k!ErOv{}mhZ0qj;Smxs4{e0vbR;uswT8#3Ma)z+h#}Z4!g<_cW0hy@
zxZDHgq__)ZCf=p9e0amJ6hGmL2zeSs5V$7dC^961xi3KG7plA?RNYa;=_=m{CtM#9
z5?TMbifmCek}rqfh+LEhkm$FL86{PV{1`%`lF>jP-J>A;fMZ6$=a-epbCU3kAmUXt
z$Y#e3{N!(-5<_fsg-2yhE%zQJc>t+bY-UAsiUZ}vl|iwCd5lNRWS$W-_-C;5eU;Va
z_@Qy1$5$ceDMsU#Jx|7i1R0&V>mo8)g<w9Fz%w@|y|7RYabB)7i=^!FW4YE0UN80b
zVWi#+VXirY66HSB$K#P6Xh_-j!4m2zs!tZCR%3oUD<fz2*?GCMy>qkD3p^O<dxlUs
z8GvT`$@sGaRW<&(<)y*0YFY9HhCXt-y~ZeuDJElf(ThTHv}4As;!Ax{l;%mzE2x68
zWRz8foMauZ`~A%7V8E<%+hRaP;apk6>a|-m_(@ac)czZ^o>^6;H5I->jD#2l&|WC^
z2Qlx%{2D*@T$o?H*jG@7Nq(t#4$|3Gl?w|gN4gMQeY{Hx<!pRTaYc<!jDiGWP9dgo
zRe_~45Q)S4Vme=#Q&s894+d)JSEI9#s-VV?OmlooL_6ga2oxfOL7*I3r?M8QQz;Q&
z#gP{L{I<Mh=#JQpnMis$Y5hJzQ}-kj1-{MXU78wLScoZdwNGX##MioHdA{mkRX`UG
zYb<E;S=sXE+zWZ;AVhytg9w;18I{#F0UtgK#a>CRmOlAgjCX0i@3I;nM$p3i^2>eV
zO_Kt9v+y>w5KnQrGphoNiedkH(u3h$Iz{X>)1;O8O0Wa`Sx%8trTmNcqmhREP0?C8
z>ik&vDZ0qghyw9Ar%uBUdj~`#^mBKRHqt#&xNhfEm6v*h0qi-JuW55*5i14y5W+)P
z&Xbyxo}FRSN>k+w>@JoMce{vubZkWf#h*-bt2GU^@SkYaNGE6a^_=ePimLg=71f2R
za%4gT+7_$UxzxuFthO~e9d~q{7I{bFK6<yh|G76hO=|V5{IhLyqF^9-G<I!{PDOXh
zVH@WmBc=Q9Xeo7%Y8$yCx4XEvlC{RQKxLpiTWe^s%mh9XGteQW^JVJ7)S6%wS*7ZO
zrUYTL#;H*NEyG4ijs=ISv7i?TUA$8vHM6(eq!5jnFZL`Cd)QhZrh`{;s&L!oHr~Sz
zs7Gpu^792WzpK`*|Ie{`!HP8XEAu?8iuZ_?T~&2yjX#rrwm73Q7{G4-4~a9UJP@oY
zuE6p@d1Wb9>f>ftmK9f)R`^Q86SK_n3QQG*xH=B*?v?F|LD)#E3DAu`?lDVzcs=}{
zxB_2bQF$fSCp1Z1-zTe@k*Yu@7G@Bjya8V|l8F`IrTgaBEL`XdXxd*%FCrey^wW*O
zT(OKOYDn-%Q|IDK53%wl%!|bmidBef^3DxrkL_t!R;d_oP}R@@qWDtgwG{U+iwepY
z`BJM<bRS)b@ebT0(>Di{aCZ6pKyhGc8bW=wsOm#cGRli95J>YWJbGv(IyWOPCnH<0
zPYF?2m{wbx8Nm94GCF{_@{a+vI#^l=_bM;piw%$~toHj#$`_QE6soF#@5i#FPp>Bx
zmQ?vshe!9Imtx2WR4v7`7|IalRxJtFB)*aX`4Ux0g<)M{v>g>WVDYIoD9#d#e2c2-
zhpWePZq(=s%TXDHoLgZ9iY>&Pw7l6l1zEE)PMMric#2w?Gii#FBo@#j8-C?&ks2z+
z@5Pdm>dF!n2<0yUvC_AsOw164)xNUA1+w`S(lTEXxK))4$`_)|6jl~vJ!(lIetLVc
z5R(M#(UqWCzRJbrfvQUSVQwKNM@e9)uf@|R`56i9brXdFzHcpLj{b>n^02SgS5g!7
zX_iVf2DSw7{0c5A4~io-R(M%WdC8?n0-_iJs=7K&<xUlidj)ALT^IVqLJ_I`Vt@Hb
zi>gmTS3C*2Pb%{j`%kJk<)l+iN>QG(@KMp2i~N*C0IL^hzEL820rmgmP(OQo?boi|
z3*PGPo_OE;C*5&^dIm{Pf_~-V0`6B(tuiwWz=}sW(O0h7jyjS}VMzJX(bCKBc1Nd<
zU~T8Io=o*S<<|T=n2&d0WqwwE7xVG{sx3c0PwB_IskVF<^YPB9Ek9zZ{gty?>BoDa
zw&|0YkM}=q`Sw~P)DBMXpKqVOi}}tHdp;(|GT*jd_)g~gOYPIUnD6x2^HZ4L(hEOQ
z68o#98us5M_WH*$zp28WZ?82%U9(u}?+VzbU(fvJYJ2`h=C=gx`EAVi*4XnSme^mp
zYn6R?&(OAg%ws;@A++WDnUD7aZTTyik9YrU`D>Vu_xf!4EzHL|d$#<I%*Xq9wtV|i
zN2oe~yt8JTzGbQMPs$2=ek=34df|64zvWu{^j*xy`(n2FM=Z6!YQ0?9hxf5;)3<AW
zqdmWa`FKalHhmZKoj3Nv*X8epul<YnmTdLgmnuRH{YI6qd5wMgcILb9u;+I&zoQra
ze$BtrK7GUz`>V1mm3`iO?9<mVzpEGi8s<0MYoC5S^HZAb`Oh-H<9GJ_R;~X&dw#pt
zf4@Dyi}`K6@Z+yi<@Y~epWelM=Q?}7y;mdD{hZ$Yuzh;x)hhq4Uiit(Z+^r+eIzIQ
zt2K2>e_M-v`WEK<H`wz-%y&L+&u?RXs26?*^NXIaPrp~|f6|`6pZVfX_Wbx|s(dZI
z@ROL|^pt)2WafLHw&zb_e%(fUzK8imo9y}awGyGOxklOFw8cLCdgd2xwdaSJk9SUN
z<5L^+UEA&X5lif^Jj<1Ru2<~S&ttyWVb3pPeseGUTIRRBYM;K2`QDxOd_8}2zh=*G
z()PV>&u`ZJH|+UOYWsTOhnQcq%Rc>1t$(*Yzn%Hbz3@Ak?|#!h{eI><-?Hb&uTb?T
z{%p@rVt%L>{y66Q-?mSm!u+DY*z?`YcedN}y*mG1_(eMZckI*Kx7rA`OWU{S(9(<R
zl>hK9gKhtcXFlF9u;mY9e$yBBd>8YJzO?73FkgIS&v$G7*Y^B~C+x3u{dfIvXz6R#
zD80#EZfBg$$um;t%r7o2luI#gtVX%rl4B<qUNJg=oYWTx6fZ5rLQY|YuX16qOee9^
z8(vRB-ZuQ%S#!#LOVr}<L^jV(4v%l?fnZjpw*ot+l)M)I3Hh{&a;y;L<9R3v+vFdu
zmjvlqwe*s$Ja%zm+fs3`r0hU)u$I<o1636|d%OH+XF(1N)1_5Q!r9u(Mf?;N?7ckE
zIors|eA%0`vn&SK$djM)<<jL+tnm7Mf#6ba@j`5@B463aOZ|9MkM-Kp0<7ctf{?V8
z3qQ-Y)x-4@ZJ@25h`$fypNJ>9#o6l9_1v4?k=A&?`ei?dTbFHqyg^1jM^n3G?EKZU
zy(-t>i@B;UsOj41=XBgI*h4mQv$J}w<=*wmZI5%ygJtXq8@<tX%eC@wHT7n%x%H8X
z)tek@B03-(Fn>#nw~<%vH!6DA=5O{RDt%OK*yxS+!@>G1wS;z0gbQh-SK1L4klwPj
zm-3Ia|DS3HN|{lsw))KShqLd^KJEvW(%9+^x7X+hq6%iKU+yBSl#jdqpZ3l_%&n@-
z<7etrq87Yh)qoWv6gT)3dZmL#1q@mwl_}g^D@LDj32SSE+m@?LHDZ;BMWS1ltbmSe
zm7Cu;zpq->EEb4ZBr2^@3Pfok(87+`%0)qg4zizj+8NTZrS3nw?(^6_-+sP5^XBH{
z+;h)4$vt_8-LS^wt>ft$y};w1zmBJS<w1^5eU|)LiyR_u-xjNb_t)p|*dF}n@;rSb
z;vwrjSs!MY1A6Eo>N7bq{)O#0b=-Y3*P;8zfpIU`k7b5C_?bU+eGfa{?|=S-&tQi>
z?*91cGkv)B-5-DWeso}c{?hi4xEEeW{P}SY7-0@q{{t(2h;}*Th<}LqzhwN7dOsgG
zy|UX^-^2dP7wDFv){ps)8T>j*+&!QyxL3-_OX$KgkLLTx+Xhq+UW1-$^W84E6V1Jc
z?|#8kjv<fRz2qQ(pFyqr$T<kNqR#!~X@{?U1-Z651Ih<iqq)Bzmk+!Z#dq+%G<f7(
z?h`%8_rKtW&{&t>nE<P3?jwBv3_gqY;N#?C|2~?`0}sFYD(=32j~Ms|G=bM&t<(xM
zcn7Zw?m`;gh2P=Jf?j+Z9(OGH$?yie3XR~K@TlX+e}>oKBgn*a3s}7eRq%0mGunjj
z!V~9F2fPk{k6L)`wMu;u4U&F43GYO6@Gd;-c<O);!eht@@5Adbi$?HW_(~rsLnH=%
z9+~(geE;h?FL)E)f;Qn@c+v^%BElQ+I@H2jaOH{QLBq%4kI<Yg14_+jhcKFpkH8x8
z;T?G8Nz55|3qFpP<9%;X>V0SxJ`T5`7`_eDf5&;mH{nbD)BzuaYta_G1)o7}ygHfw
zgF1K@E`K9+AdPhsdbkHU53j*6^5Y}WMne(<PhOx@5U;}x$iOFI2SxB*=s$&eN(_vN
z@NxJIT8~$!^4ih$_z2vBEPNX_7V>=J;ToM>VfZHWyotVt*I*d+@DXUEK~hjR;mN1b
z$M8DbfPDBQ>>wTAh5kj{GnW_`Lm_+|K7*Fwx!JC^q2>5CTyVNl>m(k=&<2TzH={9p
z7oPZL`i;cE-=hj%dkcLJjpLK>PUPZUxG2Cif)BzY-b(%N;{3voq9ERa_o5J9y-j}S
z2X(_6@YQdpf8up`IU2(|@KI#pwKK?PiYoXBJnc;SC*FWJA{XC=v(KUp@jCn>8f;Nd
zxcVLRPkbCcg+h2e$hC|NiGk0d5xhE^?<}I_cmsY4nGyqUM3PThxEV<vY2loAk|Pf<
zT!b9F@I9!BH=yKzZsYrNK}(M4ht8qSlnY<+Zm!=SQaAYGb2+bg;pONIyzn}-3@@}%
z6fgWPis6N~qYe1}{LPZv`Chb%a^c_-ayjCKi%=KepNm=YHeZW8KN^_iZFnDEIDv-n
z{dt!qNAuNam~vqeEyoM*KrwuOer3tUJZmY}3+2N3sDc;13pMfbUFCNfv>RTH&>pCR
z*WohM#Yf<JG>%WgO~}PJ;ZYx=ZSfjB6Zx5&g76BY<NI?eORnYfQHXNk^=Jg&pFdgh
zDxZ51;}Ye<i_rCW;V8=Dg)!8?$KlH&)E}?G_g+k$r5tWU6ZkfK7A;_|RR5&ZJJ1lG
z`|fJ?hq-p}++$ZiK*M<Mr>jesGhRpxoV|i}mKaz^CZ2oZ>YR^ojpGeiMoB4$$FHQX
z;(hQcRKX|V&(UUl7rrgZIFAp)FQN|KfqT(zybI5|gt1Fv;H-}_#xlQa@Juv>55g<Z
z8TkI(!~J=QB|mX^741cg@S|u0Ubr4@#B={$y<`pb#B1;=llH``k12IOa>aj~bB6|5
zR~Ya!Xb2yNx1%%g+=o{;UB>yvbI)C+N9jX&?ysv0)^dH~xtFe<K&vDkKKlvIHC}y^
zISXx+ayT5LpGiEdpe^_|JpNNkZO8lIQZ)DzV&JuC4!%F9ujK!I%jNWY%7tMRzzbKP
zVSIo7Udi?QG>TF#eATBpzj)z^D2eA@{B%Cw597ayDwGTFLruJJ7ut^R&&w-0d<)2>
zT=+N|WNjw=J@VrFbMQ*O-YgoTTzCr#;e~gh5qy8XUCGV+J`|%|_zAQDFZ?{R@cp@U
zB@gcrSI{RZ7y3~fFFYOX#s^^nO~_;69_0BcuM7S*PMz`UbL?!pl6vBOFo%}m9XRLn
zoNK%W!)P7egtwstz6tlD2Hu4W*VBf0_6$tt!gcU}LLJJ5ue*wR;Drm2`Wfd1PUXE7
z-i+o^F1!!vc;POz7|))9=^VF`>vk=QP%ium8pR7UD1m2>!E_#5$!B{bs!%R`5H<1a
zGnmd@D>-aepdFM8zkpo4@H#ZeI=l(>FH%pua0AluNw^0E@h;4Ki8&PSz&ZcI>y&u-
zSro&^VHMdD1D`++zCVww<d=OMwJ8_QzJ~LQ7aoJ2!V6!8JllCJoXQ_7JmO!ujwl!U
zQ2;MI9S!5z<1n2oR&vHZh@zAWpF`{L!a3w=P2$<}Fr61x^26SaDwGSmsEHTuMceT%
zoXP<!T#H=Fg<nB~yq6JXkQd*d%XRj@DfIy~M7i*C6v7LyMk5jr$G*&Y$6N5&>!>H*
z2fv0aDTi;rp0>pY;Yl|zhU0bk5ZaCJLgOp+N#0Khn`kaxIPa^x2D}eiD1dk1pU^N~
zjq$z=t;6f^QnVh={tR{c*QgJky%_3Vv=Ps~3$^n`&bxTH_TRadB_58WHr|DSjr2o&
z5bi?bQVs)O=eov6U=4YA-{-)cD1h(6*L{P2h-VLmdK3-g*>9n)x{2!<&)y1klEwUp
z*Wu0-^CP|suS#?6NDN$<VIG$lcqg*(?0ZlvvYdCk31{aR2k`7?Q1_rMc$Mc|p)THl
zV`vZFg5#)%ccE+32Y9b4{6LYuijTm}Xb9hgo)XtSUV~v|NDQ>m2;PAwm+7~71AYU=
z@D|*PY<wHOyh0zqvu{E@iZ<ifBcZ-rr9VhK4Akhi5(AH_Q&+qOS0VLtUN3AQ4c~>Q
zI`j{`4nKs3@ez0vT83wjgo=KXF$&Lq2<7<}$HKGsL46Cw@a%I?;cwGt@a$<&vo_IZ
zBnJKlZN#%zL1mDGXJ3Na@E_D4&mIJI_IKzrc=j8p&o<~Yc=i^kk^f|Tz_X7)z3~>F
zo6iAs7(?^$ao9qBd>bzKE^RI`FoqUO4BUYXd>6Ji^I9Yxo_Z^NUgF^`Xal|pPrZ$P
zBIWQ&v<a_n=QW|b@xsfS92alFU!xx0g|Gb{^?8764PJzFd=lP=B+sYt*gL2XUic=o
z951{OjpBtLL<u~59H#SlHt{d|KK+(*;cHM6FFX~s@xs&4ZhU{vO^dQ!$iwF+!at&U
zc;Qi7Xgj>{7!<^_H)1*;XBPi78lhbH_B*-O@DUjL0rkWi@P{aiZ^I>b(QZ->e}%T-
z^%mzB?ZC%j70ua6e}GS*xp?+esArH5&;AK@6Iy_0uY^kfnEoyC@PfNJzj*dQsMEI6
zo_O{<sNbOxyxK<JLs9WRq0P`J-hu2(P;tEQIkZt?ex}q7$i}npK%IUM^~bZvK(UWN
zHSxkH(RPWymp+5Kc=ib>_5!Fqc;VmQPk+F3|6k4OFh0oVRPb9!!#Cl|pVR($6K+O+
zDTn9%g4c*Q;FS;1zW5}(U<ds~%3%eq!#nW2o%CBNhgUyHzm<4+_Cp+3%HgNG)EOU#
zYaXVacoU`{p+7vtabOS4$E#gDC(`i-T)CTmi#Ort9_2d6C*jk`l=#P#x(vnfarmYG
z;yRHSxCd46E<E9v)CaG_XHf^Q9%tQ%T)YWyLlgKW+=~`;c`RJ`E3RvNf9^-g9r*+r
zrd;^mJ)Bp(@Cr1F7j8fae1G0Y$p`r{<WMfOPz&$Evwlt8@Ikm5c^;;2u#Pl*fBr_v
z>v%O9qFnfG6vFrCRXqDi-ru3+lnbYFHumRclpKv`{DyiEBaEO;c;Tnf7QAph+Ky-6
zg!;$da*az2d=9yI_Cu&A(S-P?xqOi45w1r#+@rtYBk+c2cs{%ZCr}u#{y=-6C|>yZ
zA33K|KEeAhv=MK>&!D^Uad<o0j%S~Q`q{Hw3-~TP=TB4xAAvVK$06{R5Y5}gF%{2&
z7U27H97^uPU!oDpg)g4Pdv3f2U-O~?wO-<952$U(!nfg^7xNwk?}O)|3Vs+yP<S_W
zgC`#`p!QI{07j5bxo|D=<73c5A-wQrWZ)an>lsjU@xl-a;DsY7h!^J21jo1GqL)x7
z%7@_HXba^+7d?d+9{W;0n;~W%ybx`sJO-~toA624MV?3Z@pmtyzQp(7x;eaFys&yC
zZ9~j<c=S=!2R|2vPy#PJ?&bUrW&Aw25Jm7hyc-#K;R70Nh2H^}98G`655rs0I=tk`
zn|ln;i<caACTid%FWwy}iTA!@Kz$HZ@FVaWsEN1WBWMi28xGFpIq|~zXgfX#AATjz
zk0&vUI`7rACw>@y0qwzG4<AEM;V0nxy|nXVv^jhXdGYIx<yRacAAZhp1L~7#2p@y<
zU&Fb^3(rMo;78%LXfb{aZb!p-p*D{;!Am~ZC1@Rf7#7edz6tL@QG6FZhD^Nt64fJ*
zr=H*A81NJ{d<Sg~m!d4*fUD62-h|hnW#6YAVHH*I4%~_cx6sewUNnMt;gPSSpWrok
z3Yv2#$A?SN4!i+ZqwWtlKD-76?&A2cijsH-ZbjqxHr$JXEshV5^wEZVex<=v(0o1%
z(&17xm(OGjxEd|k#_{1bXab*vRpk5>!L7);hvUP&XjIn!@W|J5y!$ymJOx>-QFXW!
zEoQxEz}3k20LO>dpuwFSA6C))F2{#kk$RZp!@X$BBl{@1LU(f=2_^UEMy?m3<o)d7
zg_5IF(U*i*paA}Fe_pr+1}A^ad4pc2hpFhPa%n;RAmtJlLSb{3nwZ7BweJD=AxbY)
z?^PG^?>Xupa7)w$>U{pcgn!?Smp``-KEX^vZdCOm{&(8I6yGuVQ`T4f<**0*8KHpH
zfEwik#7oHZxRRq?qE@LD9C?lUh`N;Mz+{ZhEfih76%A1bsZm7D=dtf1W;K6T5I?Fe
zqdW>n`K=<Cag$>qe^+wEQA*eH;qIyG!;|p~c|=rQJo(5=dE|29O!X-~W|UeiQm1j8
z6FB<R@l9ga@bmL0AG3m=?)&q`$(X4+FQyik@eJ}>OrG-+o@>oiD0O}*(NnP(68mwY
zpO0BY?cRzO@fzO@IY)dC^C%u8Z816-zlP^u)mMv)Rc!JV$<IH|v#sKB@;a9D*f&hp
zZJ5WcoP3nDl>AI;w{o(T`d`EIam$Ffm?Ny9buPyL^JJ^;i(Ncfp9}UML)uE}GxeI}
ze{v?sZ2AKA()ms+qX);hlxJB>{YU#=5$_SG<NK-O)OiR@w%dX6Gh6RqZMT?uFmq47
zhN&7#OYZActfT3VynCK}wQG2dtBCABXD=DtJ!qW0c=3|+&kcw7o4@A&OWszwE&{n=
zE|fEJ;aoIl=3=>cE|E*-#&TB9&N;b8u9<7)+PO}yn<Lm@{lWF+v;0=bGOVx_v7%PO
zN?K!<V>PU%Wfa1NNFiD<3$a4HkSHVzV+E^V7o0+)&@8kH?Lw!}EsPi3La)Hm%GPYJ
z?X&&1ZU^k39kLBOY)9;<ZQ3zAZYS)dJ!V_BZ98_uZrUxoZFlUhJ#M>p&sIfGQ7d|j
zzM{XV7X!s$F;p~);bNp1Et<txF<wj*lf|*3RkVvvu~BRmTg7&<Q|uPUi*B)3R3%SI
zD|t)4lE0*v0;OOnR5D88Qlu0unWb1MUP_dbrLmG#vP({>QEHZ2rFN-P>Xyb!ZmCyN
zWlvcvd&|DEzpR%7<zP8fHp=00q#P}q<ybjhPLz}7v9eXR%TBpbZkAi+cDYmTmdDF(
zxmQ*dPerSEE53@qqE`ZyU?o&BD&b0`60Mk(SS4ObRFajkidC^IPNh+4R$7&IrBmrv
z#w%{6S5Z|@RjYcdzN){fR|C~xHB>dK;cBEBt(w(XHC|0rlhv`RRduS3YO~s^wyT|L
zw>n;RtG%kKd1_kCTl3ZYHN6(71#6+2Q47~1wOB1)OVpCJv6@x0Yfi0EYt~w|cCAzE
z*2ZgYtyfcZPhG2f>%O|buGa(gU_Def>fw5%9<7`8SUp}()RXnGx>dL9PQ6iY)?4*<
zy;JYj$LnsrS630%!E!lS9!s;lmh>mx3RuCuUS(P_E55&PS(d%Of3>W()v>zPxaC?s
zOQk$1E#*!5QvQ^l3Z#OmP|8S!Q;}3OWu{`Ocq)-frp8iM%1$|{Myi==rP`@Zs+$^5
zxv5@Cr9Eja?M?gA{<NMBq=V^D+DM1fk#sa|reo=NI+0GM$I@2XPCMyFx|wdJ+v!fa
zn;uWQ>0Vl8JQ*$H&G<6@jGhT(f|*dp$b>VIOf+L=Vwrd*kx6F8GFHaUIGIMKnQ3L(
znNFsg8PB+xUPfg-SuN|$`m+A4o(*J!*-+NVhO?1uG;3yK*?2aQO=ickR@Tls*+#aR
zZDrfpPPUsJ&$`)OR^>c7E$7Yoa{ip23rt_hk;7ig<2g6i%c;C4ujRdYU*4bB^MQOY
zAIcl~a6Xcc=FNO8AI~T9$^2N}%G-G--^e%ft$aJ*$#?VPc{kt7tAeMX6}$ys!C%k|
zfkLnlDj0to0saa{0Q-M921IM-|He3A4yfg_!2Ewa4$QpjXI{56ud<m}NN>hGrq7s(
zd^2X3ne)WV^E7i5mT$YnXkzCu<DWHSzMnZN#AeLrof-3ZYjR#Tr{`Qg;31nH>ubwo
z9Cuh9v>CZwMs1A|TW7R38KIMm&TU3ym(f^bB$iRwU<5W9eH}*JHlwYKusWlw!N_Vd
zsyd9MZAMX-5maOJ)EPMqMonpXhf%W42q~kZ#>l8MDw?cnlB{SPRx@o@GA<*Z#;9j7
z(wU5MNk%w_(amK<(-_TkMlyp@%w!FdWc}i>c4@P2aaprytXB-yC?@NZBx{p4>k*f=
zh{ifZXANSo{xDg4Bw2SjtU21OH(b^l8tV)>vnK0`Bx?$X^+cPsgvR<oXYF9HZZKIh
zBv~&wtQFd<6I|8^8tVg{wSmF9z+_F3WIf=p7HG2$a9IOr%>O!bzrnn3GUq3m@7v7s
z8Z*1jtZp!)n_S6BW^;#`+-3F-Fi$6#l{<Cio2BCP4aMvmX0CNOLyEc7VCHl<E4`GD
z8PQ}8Y%u3}nBStzW=&e&%UoqLGqq@GAL~bx_HEL#KH4<SY|&zd&}hdfE!bear?I*-
XS;@6%E1fn<&^q$OfBW-))dK$wa>5hi

diff --git a/lib/win32comext/axdebug/__init__.py b/lib/win32comext/axdebug/__init__.py
deleted file mode 100644
index 8d5db8b9..00000000
--- a/lib/win32comext/axdebug/__init__.py
+++ /dev/null
@@ -1,4 +0,0 @@
-# See if we have a special directory for the binaries (for developers)
-import win32com
-
-win32com.__PackageSupportBuildPath__(__path__)
diff --git a/lib/win32comext/axdebug/adb.py b/lib/win32comext/axdebug/adb.py
deleted file mode 100644
index 812c23e6..00000000
--- a/lib/win32comext/axdebug/adb.py
+++ /dev/null
@@ -1,480 +0,0 @@
-"""The glue between the Python debugger interface and the Active Debugger interface
-"""
-import _thread
-import bdb
-import os
-import sys
-import traceback
-
-import pythoncom
-import win32api
-import win32com.client.connect
-from win32com.axdebug.util import _wrap, _wrap_remove, trace
-from win32com.server.util import unwrap
-
-from . import axdebug, gateways, stackframe
-
-
-def fnull(*args):
-    pass
-
-
-try:
-    os.environ["DEBUG_AXDEBUG"]
-    debugging = 1
-except KeyError:
-    debugging = 0
-
-traceenter = fnull  # trace enter of functions
-tracev = fnull  # verbose trace
-
-if debugging:
-    traceenter = trace  # trace enter of functions
-    tracev = trace  # verbose trace
-
-
-class OutputReflector:
-    def __init__(self, file, writefunc):
-        self.writefunc = writefunc
-        self.file = file
-
-    def __getattr__(self, name):
-        return getattr(self.file, name)
-
-    def write(self, message):
-        self.writefunc(message)
-        self.file.write(message)
-
-
-def _dumpf(frame):
-    if frame is None:
-        return "<None>"
-    else:
-        addn = "(with trace!)"
-        if frame.f_trace is None:
-            addn = " **No Trace Set **"
-        return "Frame at %d, file %s, line: %d%s" % (
-            id(frame),
-            frame.f_code.co_filename,
-            frame.f_lineno,
-            addn,
-        )
-
-
-g_adb = None
-
-
-def OnSetBreakPoint(codeContext, breakPointState, lineNo):
-    try:
-        fileName = codeContext.codeContainer.GetFileName()
-        # inject the code into linecache.
-        import linecache
-
-        linecache.cache[fileName] = 0, 0, codeContext.codeContainer.GetText(), fileName
-        g_adb._OnSetBreakPoint(fileName, codeContext, breakPointState, lineNo + 1)
-    except:
-        traceback.print_exc()
-
-
-class Adb(bdb.Bdb, gateways.RemoteDebugApplicationEvents):
-    def __init__(self):
-        self.debugApplication = None
-        self.debuggingThread = None
-        self.debuggingThreadStateHandle = None
-        self.stackSnifferCookie = self.stackSniffer = None
-        self.codeContainerProvider = None
-        self.debuggingThread = None
-        self.breakFlags = None
-        self.breakReason = None
-        self.appDebugger = None
-        self.appEventConnection = None
-        self.logicalbotframe = None  # Anything at this level or below does not exist!
-        self.currentframe = None  # The frame we are currently in.
-        self.recursiveData = []  # Data saved for each reentery on this thread.
-        bdb.Bdb.__init__(self)
-        self._threadprotectlock = _thread.allocate_lock()
-        self.reset()
-
-    def canonic(self, fname):
-        if fname[0] == "<":
-            return fname
-        return bdb.Bdb.canonic(self, fname)
-
-    def reset(self):
-        traceenter("adb.reset")
-        bdb.Bdb.reset(self)
-
-    def __xxxxx__set_break(self, filename, lineno, cond=None):
-        # As per standard one, except no linecache checking!
-        if filename not in self.breaks:
-            self.breaks[filename] = []
-        list = self.breaks[filename]
-        if lineno in list:
-            return "There is already a breakpoint there!"
-        list.append(lineno)
-        if cond is not None:
-            self.cbreaks[filename, lineno] = cond
-
-    def stop_here(self, frame):
-        traceenter("stop_here", _dumpf(frame), _dumpf(self.stopframe))
-        # As per bdb.stop_here, except for logicalbotframe
-        ##              if self.stopframe is None:
-        ##                      return 1
-        if frame is self.stopframe:
-            return 1
-
-        tracev("stop_here said 'No'!")
-        return 0
-
-    def break_here(self, frame):
-        traceenter("break_here", self.breakFlags, _dumpf(frame))
-        self.breakReason = None
-        if self.breakFlags == axdebug.APPBREAKFLAG_DEBUGGER_HALT:
-            self.breakReason = axdebug.BREAKREASON_DEBUGGER_HALT
-        elif self.breakFlags == axdebug.APPBREAKFLAG_DEBUGGER_BLOCK:
-            self.breakReason = axdebug.BREAKREASON_DEBUGGER_BLOCK
-        elif self.breakFlags == axdebug.APPBREAKFLAG_STEP:
-            self.breakReason = axdebug.BREAKREASON_STEP
-        else:
-            print("Calling base 'break_here' with", self.breaks)
-            if bdb.Bdb.break_here(self, frame):
-                self.breakReason = axdebug.BREAKREASON_BREAKPOINT
-        return self.breakReason is not None
-
-    def break_anywhere(self, frame):
-        traceenter("break_anywhere", _dumpf(frame))
-        if self.breakFlags == axdebug.APPBREAKFLAG_DEBUGGER_HALT:
-            self.breakReason = axdebug.BREAKREASON_DEBUGGER_HALT
-            return 1
-        rc = bdb.Bdb.break_anywhere(self, frame)
-        tracev("break_anywhere", _dumpf(frame), "returning", rc)
-        return rc
-
-    def dispatch_return(self, frame, arg):
-        traceenter("dispatch_return", _dumpf(frame), arg)
-        if self.logicalbotframe is frame:
-            # We dont want to debug parent frames.
-            tracev("dispatch_return resetting sys.trace")
-            sys.settrace(None)
-            return
-        #                       self.bSetTrace = 0
-        self.currentframe = frame.f_back
-        return bdb.Bdb.dispatch_return(self, frame, arg)
-
-    def dispatch_line(self, frame):
-        traceenter("dispatch_line", _dumpf(frame), _dumpf(self.botframe))
-        #               trace("logbotframe is", _dumpf(self.logicalbotframe), "botframe is", self.botframe)
-        if frame is self.logicalbotframe:
-            trace("dispatch_line", _dumpf(frame), "for bottom frame returing tracer")
-            # The next code executed in the frame above may be a builtin (eg, apply())
-            # in which sys.trace needs to be set.
-            sys.settrace(self.trace_dispatch)
-            # And return the tracer incase we are about to execute Python code,
-            # in which case sys tracer is ignored!
-            return self.trace_dispatch
-
-        if self.codeContainerProvider.FromFileName(frame.f_code.co_filename) is None:
-            trace(
-                "dispatch_line has no document for", _dumpf(frame), "- skipping trace!"
-            )
-            return None
-        self.currentframe = (
-            frame  # So the stack sniffer knows our most recent, debuggable code.
-        )
-        return bdb.Bdb.dispatch_line(self, frame)
-
-    def dispatch_call(self, frame, arg):
-        traceenter("dispatch_call", _dumpf(frame))
-        frame.f_locals["__axstack_address__"] = axdebug.GetStackAddress()
-        if frame is self.botframe:
-            trace("dispatch_call is self.botframe - returning tracer")
-            return self.trace_dispatch
-        # Not our bottom frame.  If we have a document for it,
-        # then trace it, otherwise run at full speed.
-        if self.codeContainerProvider.FromFileName(frame.f_code.co_filename) is None:
-            trace(
-                "dispatch_call has no document for", _dumpf(frame), "- skipping trace!"
-            )
-            ##                      sys.settrace(None)
-            return None
-        return self.trace_dispatch
-
-    #               rc =  bdb.Bdb.dispatch_call(self, frame, arg)
-    #               trace("dispatch_call", _dumpf(frame),"returned",rc)
-    #               return rc
-
-    def trace_dispatch(self, frame, event, arg):
-        traceenter("trace_dispatch", _dumpf(frame), event, arg)
-        if self.debugApplication is None:
-            trace("trace_dispatch has no application!")
-            return  # None
-        return bdb.Bdb.trace_dispatch(self, frame, event, arg)
-
-    #
-    # The user functions do bugger all!
-    #
-    #       def user_call(self, frame, argument_list):
-    #               traceenter("user_call",_dumpf(frame))
-
-    def user_line(self, frame):
-        traceenter("user_line", _dumpf(frame))
-        # Traces at line zero
-        if frame.f_lineno != 0:
-            breakReason = self.breakReason
-            if breakReason is None:
-                breakReason = axdebug.BREAKREASON_STEP
-            self._HandleBreakPoint(frame, None, breakReason)
-
-    def user_return(self, frame, return_value):
-        #               traceenter("user_return",_dumpf(frame),return_value)
-        bdb.Bdb.user_return(self, frame, return_value)
-
-    def user_exception(self, frame, exc_info):
-        #               traceenter("user_exception")
-        bdb.Bdb.user_exception(self, frame, exc_info)
-
-    def _HandleBreakPoint(self, frame, tb, reason):
-        traceenter(
-            "Calling HandleBreakPoint with reason", reason, "at frame", _dumpf(frame)
-        )
-        traceenter(" Current frame is", _dumpf(self.currentframe))
-        try:
-            resumeAction = self.debugApplication.HandleBreakPoint(reason)
-            tracev("HandleBreakPoint returned with ", resumeAction)
-        except pythoncom.com_error as details:
-            # Eeek - the debugger is dead, or something serious is happening.
-            # Assume we should continue
-            resumeAction = axdebug.BREAKRESUMEACTION_CONTINUE
-            trace("HandleBreakPoint FAILED with", details)
-
-        self.stack = []
-        self.curindex = 0
-        if resumeAction == axdebug.BREAKRESUMEACTION_ABORT:
-            self.set_quit()
-        elif resumeAction == axdebug.BREAKRESUMEACTION_CONTINUE:
-            tracev("resume action is continue")
-            self.set_continue()
-        elif resumeAction == axdebug.BREAKRESUMEACTION_STEP_INTO:
-            tracev("resume action is step")
-            self.set_step()
-        elif resumeAction == axdebug.BREAKRESUMEACTION_STEP_OVER:
-            tracev("resume action is next")
-            self.set_next(frame)
-        elif resumeAction == axdebug.BREAKRESUMEACTION_STEP_OUT:
-            tracev("resume action is stop out")
-            self.set_return(frame)
-        else:
-            raise ValueError("unknown resume action flags")
-        self.breakReason = None
-
-    def set_trace(self):
-        self.breakReason = axdebug.BREAKREASON_LANGUAGE_INITIATED
-        bdb.Bdb.set_trace(self)
-
-    def CloseApp(self):
-        traceenter("ClosingApp")
-        self.reset()
-        self.logicalbotframe = None
-        if self.stackSnifferCookie is not None:
-            try:
-                self.debugApplication.RemoveStackFrameSniffer(self.stackSnifferCookie)
-
-            except pythoncom.com_error:
-                trace(
-                    "*** Could not RemoveStackFrameSniffer %d"
-                    % (self.stackSnifferCookie)
-                )
-        if self.stackSniffer:
-            _wrap_remove(self.stackSniffer)
-        self.stackSnifferCookie = self.stackSniffer = None
-
-        if self.appEventConnection is not None:
-            self.appEventConnection.Disconnect()
-            self.appEventConnection = None
-        self.debugApplication = None
-        self.appDebugger = None
-        if self.codeContainerProvider is not None:
-            self.codeContainerProvider.Close()
-            self.codeContainerProvider = None
-
-    def AttachApp(self, debugApplication, codeContainerProvider):
-        #               traceenter("AttachApp", debugApplication, codeContainerProvider)
-        self.codeContainerProvider = codeContainerProvider
-        self.debugApplication = debugApplication
-        self.stackSniffer = _wrap(
-            stackframe.DebugStackFrameSniffer(self), axdebug.IID_IDebugStackFrameSniffer
-        )
-        self.stackSnifferCookie = debugApplication.AddStackFrameSniffer(
-            self.stackSniffer
-        )
-        #               trace("StackFrameSniffer added (%d)" % self.stackSnifferCookie)
-
-        # Connect to the application events.
-        self.appEventConnection = win32com.client.connect.SimpleConnection(
-            self.debugApplication, self, axdebug.IID_IRemoteDebugApplicationEvents
-        )
-
-    def ResetAXDebugging(self):
-        traceenter("ResetAXDebugging", self, "with refcount", len(self.recursiveData))
-        if win32api.GetCurrentThreadId() != self.debuggingThread:
-            trace("ResetAXDebugging called on other thread")
-            return
-
-        if len(self.recursiveData) == 0:
-            #                       print "ResetAXDebugging called for final time."
-            self.logicalbotframe = None
-            self.debuggingThread = None
-            self.currentframe = None
-            self.debuggingThreadStateHandle = None
-            return
-
-        (
-            self.logbotframe,
-            self.stopframe,
-            self.currentframe,
-            self.debuggingThreadStateHandle,
-        ) = self.recursiveData[0]
-        self.recursiveData = self.recursiveData[1:]
-
-    def SetupAXDebugging(self, baseFrame=None, userFrame=None):
-        """Get ready for potential debugging.  Must be called on the thread
-        that is being debugged.
-        """
-        # userFrame is for non AXScript debugging.  This is the first frame of the
-        # users code.
-        if userFrame is None:
-            userFrame = baseFrame
-        else:
-            # We have missed the "dispatch_call" function, so set this up now!
-            userFrame.f_locals["__axstack_address__"] = axdebug.GetStackAddress()
-
-        traceenter("SetupAXDebugging", self)
-        self._threadprotectlock.acquire()
-        try:
-            thisThread = win32api.GetCurrentThreadId()
-            if self.debuggingThread is None:
-                self.debuggingThread = thisThread
-            else:
-                if self.debuggingThread != thisThread:
-                    trace("SetupAXDebugging called on other thread - ignored!")
-                    return
-                # push our context.
-                self.recursiveData.insert(
-                    0,
-                    (
-                        self.logicalbotframe,
-                        self.stopframe,
-                        self.currentframe,
-                        self.debuggingThreadStateHandle,
-                    ),
-                )
-        finally:
-            self._threadprotectlock.release()
-
-        trace("SetupAXDebugging has base frame as", _dumpf(baseFrame))
-        self.botframe = baseFrame
-        self.stopframe = userFrame
-        self.logicalbotframe = baseFrame
-        self.currentframe = None
-        self.debuggingThreadStateHandle = axdebug.GetThreadStateHandle()
-
-        self._BreakFlagsChanged()
-
-    # RemoteDebugApplicationEvents
-    def OnConnectDebugger(self, appDebugger):
-        traceenter("OnConnectDebugger", appDebugger)
-        self.appDebugger = appDebugger
-        # Reflect output to appDebugger
-        writefunc = lambda s: appDebugger.onDebugOutput(s)
-        sys.stdout = OutputReflector(sys.stdout, writefunc)
-        sys.stderr = OutputReflector(sys.stderr, writefunc)
-
-    def OnDisconnectDebugger(self):
-        traceenter("OnDisconnectDebugger")
-        # Stop reflecting output
-        if isinstance(sys.stdout, OutputReflector):
-            sys.stdout = sys.stdout.file
-        if isinstance(sys.stderr, OutputReflector):
-            sys.stderr = sys.stderr.file
-        self.appDebugger = None
-        self.set_quit()
-
-    def OnSetName(self, name):
-        traceenter("OnSetName", name)
-
-    def OnDebugOutput(self, string):
-        traceenter("OnDebugOutput", string)
-
-    def OnClose(self):
-        traceenter("OnClose")
-
-    def OnEnterBreakPoint(self, rdat):
-        traceenter("OnEnterBreakPoint", rdat)
-
-    def OnLeaveBreakPoint(self, rdat):
-        traceenter("OnLeaveBreakPoint", rdat)
-
-    def OnCreateThread(self, rdat):
-        traceenter("OnCreateThread", rdat)
-
-    def OnDestroyThread(self, rdat):
-        traceenter("OnDestroyThread", rdat)
-
-    def OnBreakFlagChange(self, abf, rdat):
-        traceenter("Debugger OnBreakFlagChange", abf, rdat)
-        self.breakFlags = abf
-        self._BreakFlagsChanged()
-
-    def _BreakFlagsChanged(self):
-        traceenter(
-            "_BreakFlagsChanged to %s with our thread = %s, and debugging thread = %s"
-            % (self.breakFlags, self.debuggingThread, win32api.GetCurrentThreadId())
-        )
-        trace("_BreakFlagsChanged has breaks", self.breaks)
-        # If a request comes on our debugging thread, then do it now!
-        #               if self.debuggingThread!=win32api.GetCurrentThreadId():
-        #                       return
-
-        if len(self.breaks) or self.breakFlags:
-            if self.logicalbotframe:
-                trace("BreakFlagsChange with bot frame", _dumpf(self.logicalbotframe))
-                # We have frames not to be debugged (eg, Scripting engine frames
-                # (sys.settrace will be set when out logicalbotframe is hit -
-                #  this may not be the right thing to do, as it may not cause the
-                #  immediate break we desire.)
-                self.logicalbotframe.f_trace = self.trace_dispatch
-            else:
-                trace("BreakFlagsChanged, but no bottom frame")
-                if self.stopframe is not None:
-                    self.stopframe.f_trace = self.trace_dispatch
-            # If we have the thread-state for the thread being debugged, then
-            # we dynamically set its trace function - it is possible that the thread
-            # being debugged is in a blocked call (eg, a message box) and we
-            # want to hit the debugger the instant we return
-        if (
-            self.debuggingThreadStateHandle is not None
-            and self.breakFlags
-            and self.debuggingThread != win32api.GetCurrentThreadId()
-        ):
-            axdebug.SetThreadStateTrace(
-                self.debuggingThreadStateHandle, self.trace_dispatch
-            )
-
-    def _OnSetBreakPoint(self, key, codeContext, bps, lineNo):
-        traceenter("_OnSetBreakPoint", self, key, codeContext, bps, lineNo)
-        if bps == axdebug.BREAKPOINT_ENABLED:
-            problem = self.set_break(key, lineNo)
-            if problem:
-                print("*** set_break failed -", problem)
-            trace("_OnSetBreakPoint just set BP and has breaks", self.breaks)
-        else:
-            self.clear_break(key, lineNo)
-        self._BreakFlagsChanged()
-        trace("_OnSetBreakPoint leaving with breaks", self.breaks)
-
-
-def Debugger():
-    global g_adb
-    if g_adb is None:
-        g_adb = Adb()
-    return g_adb
diff --git a/lib/win32comext/axdebug/axdebug.pyd b/lib/win32comext/axdebug/axdebug.pyd
deleted file mode 100644
index 9a8481903aa303776feca6d1925f57320ae0e80d..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 285184
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
J%YTP|{~Ju!s!9L=

diff --git a/lib/win32comext/axdebug/codecontainer.py b/lib/win32comext/axdebug/codecontainer.py
deleted file mode 100644
index a7a2e245..00000000
--- a/lib/win32comext/axdebug/codecontainer.py
+++ /dev/null
@@ -1,278 +0,0 @@
-"""A utility class for a code container.
-
-A code container is a class which holds source code for a debugger.  It knows how
-to color the text, and also how to translate lines into offsets, and back.
-"""
-
-import sys
-import tokenize
-
-import win32api
-import winerror
-from win32com.axdebug import axdebug
-from win32com.server.exception import Exception
-
-from . import contexts
-from .util import RaiseNotImpl, _wrap
-
-_keywords = {}  # set of Python keywords
-for name in """
- and assert break class continue def del elif else except exec
- finally for from global if import in is lambda not
- or pass print raise return try while
- """.split():
-    _keywords[name] = 1
-
-
-class SourceCodeContainer:
-    def __init__(
-        self,
-        text,
-        fileName="<Remove Me!>",
-        sourceContext=0,
-        startLineNumber=0,
-        site=None,
-        debugDocument=None,
-    ):
-        self.sourceContext = sourceContext  # The source context added by a smart host.
-        self.text = text
-        if text:
-            self._buildlines()
-        self.nextLineNo = 0
-        self.fileName = fileName
-        self.codeContexts = {}
-        self.site = site
-        self.startLineNumber = startLineNumber
-        self.debugDocument = None
-
-    def _Close(self):
-        self.text = self.lines = self.lineOffsets = None
-        self.codeContexts = None
-        self.debugDocument = None
-        self.site = None
-        self.sourceContext = None
-
-    def GetText(self):
-        return self.text
-
-    def GetName(self, dnt):
-        assert 0, "You must subclass this"
-
-    def GetFileName(self):
-        return self.fileName
-
-    def GetPositionOfLine(self, cLineNumber):
-        self.GetText()  # Prime us.
-        try:
-            return self.lineOffsets[cLineNumber]
-        except IndexError:
-            raise Exception(scode=winerror.S_FALSE)
-
-    def GetLineOfPosition(self, charPos):
-        self.GetText()  # Prime us.
-        lastOffset = 0
-        lineNo = 0
-        for lineOffset in self.lineOffsets[1:]:
-            if lineOffset > charPos:
-                break
-            lastOffset = lineOffset
-            lineNo = lineNo + 1
-        else:  # for not broken.
-            #                       print "Cant find", charPos, "in", self.lineOffsets
-            raise Exception(scode=winerror.S_FALSE)
-        #               print "GLOP ret=",lineNo,       (charPos-lastOffset)
-        return lineNo, (charPos - lastOffset)
-
-    def GetNextLine(self):
-        if self.nextLineNo >= len(self.lines):
-            self.nextLineNo = 0  # auto-reset.
-            return ""
-        rc = self.lines[self.nextLineNo]
-        self.nextLineNo = self.nextLineNo + 1
-        return rc
-
-    def GetLine(self, num):
-        self.GetText()  # Prime us.
-        return self.lines[num]
-
-    def GetNumChars(self):
-        return len(self.GetText())
-
-    def GetNumLines(self):
-        self.GetText()  # Prime us.
-        return len(self.lines)
-
-    def _buildline(self, pos):
-        i = self.text.find("\n", pos)
-        if i < 0:
-            newpos = len(self.text)
-        else:
-            newpos = i + 1
-        r = self.text[pos:newpos]
-        return r, newpos
-
-    def _buildlines(self):
-        self.lines = []
-        self.lineOffsets = [0]
-        line, pos = self._buildline(0)
-        while line:
-            self.lines.append(line)
-            self.lineOffsets.append(pos)
-            line, pos = self._buildline(pos)
-
-    def _ProcessToken(self, type, token, spos, epos, line):
-        srow, scol = spos
-        erow, ecol = epos
-        self.GetText()  # Prime us.
-        linenum = srow - 1  # Lines zero based for us too.
-        realCharPos = self.lineOffsets[linenum] + scol
-        numskipped = realCharPos - self.lastPos
-        if numskipped == 0:
-            pass
-        elif numskipped == 1:
-            self.attrs.append(axdebug.SOURCETEXT_ATTR_COMMENT)
-        else:
-            self.attrs.append((axdebug.SOURCETEXT_ATTR_COMMENT, numskipped))
-        kwSize = len(token)
-        self.lastPos = realCharPos + kwSize
-        attr = 0
-
-        if type == tokenize.NAME:
-            if token in _keywords:
-                attr = axdebug.SOURCETEXT_ATTR_KEYWORD
-        elif type == tokenize.STRING:
-            attr = axdebug.SOURCETEXT_ATTR_STRING
-        elif type == tokenize.NUMBER:
-            attr = axdebug.SOURCETEXT_ATTR_NUMBER
-        elif type == tokenize.OP:
-            attr = axdebug.SOURCETEXT_ATTR_OPERATOR
-        elif type == tokenize.COMMENT:
-            attr = axdebug.SOURCETEXT_ATTR_COMMENT
-        # else attr remains zero...
-        if kwSize == 0:
-            pass
-        elif kwSize == 1:
-            self.attrs.append(attr)
-        else:
-            self.attrs.append((attr, kwSize))
-
-    def GetSyntaxColorAttributes(self):
-        self.lastPos = 0
-        self.attrs = []
-        try:
-            tokenize.tokenize(self.GetNextLine, self._ProcessToken)
-        except tokenize.TokenError:
-            pass  # Ignore - will cause all subsequent text to be commented.
-        numAtEnd = len(self.GetText()) - self.lastPos
-        if numAtEnd:
-            self.attrs.append((axdebug.SOURCETEXT_ATTR_COMMENT, numAtEnd))
-        return self.attrs
-
-    # We also provide and manage DebugDocumentContext objects
-    def _MakeDebugCodeContext(self, lineNo, charPos, len):
-        return _wrap(
-            contexts.DebugCodeContext(lineNo, charPos, len, self, self.site),
-            axdebug.IID_IDebugCodeContext,
-        )
-
-    # Make a context at the given position.  It should take up the entire context.
-    def _MakeContextAtPosition(self, charPos):
-        lineNo, offset = self.GetLineOfPosition(charPos)
-        try:
-            endPos = self.GetPositionOfLine(lineNo + 1)
-        except:
-            endPos = charPos
-        codecontext = self._MakeDebugCodeContext(lineNo, charPos, endPos - charPos)
-        return codecontext
-
-    # Returns a DebugCodeContext.  debugDocument can be None for smart hosts.
-    def GetCodeContextAtPosition(self, charPos):
-        #               trace("GetContextOfPos", charPos, maxChars)
-        # Convert to line number.
-        lineNo, offset = self.GetLineOfPosition(charPos)
-        charPos = self.GetPositionOfLine(lineNo)
-        try:
-            cc = self.codeContexts[charPos]
-        #                       trace(" GetContextOfPos using existing")
-        except KeyError:
-            cc = self._MakeContextAtPosition(charPos)
-            self.codeContexts[charPos] = cc
-        return cc
-
-
-class SourceModuleContainer(SourceCodeContainer):
-    def __init__(self, module):
-        self.module = module
-        if hasattr(module, "__file__"):
-            fname = self.module.__file__
-            # Check for .pyc or .pyo or even .pys!
-            if fname[-1] in ["O", "o", "C", "c", "S", "s"]:
-                fname = fname[:-1]
-            try:
-                fname = win32api.GetFullPathName(fname)
-            except win32api.error:
-                pass
-        else:
-            if module.__name__ == "__main__" and len(sys.argv) > 0:
-                fname = sys.argv[0]
-            else:
-                fname = "<Unknown!>"
-        SourceCodeContainer.__init__(self, None, fname)
-
-    def GetText(self):
-        if self.text is None:
-            fname = self.GetFileName()
-            if fname:
-                try:
-                    self.text = open(fname, "r").read()
-                except IOError as details:
-                    self.text = "# Exception opening file\n# %s" % (repr(details))
-            else:
-                self.text = "# No file available for module '%s'" % (self.module)
-            self._buildlines()
-        return self.text
-
-    def GetName(self, dnt):
-        name = self.module.__name__
-        try:
-            fname = win32api.GetFullPathName(self.module.__file__)
-        except win32api.error:
-            fname = self.module.__file__
-        except AttributeError:
-            fname = name
-        if dnt == axdebug.DOCUMENTNAMETYPE_APPNODE:
-            return name.split(".")[-1]
-        elif dnt == axdebug.DOCUMENTNAMETYPE_TITLE:
-            return fname
-        elif dnt == axdebug.DOCUMENTNAMETYPE_FILE_TAIL:
-            return os.path.split(fname)[1]
-        elif dnt == axdebug.DOCUMENTNAMETYPE_URL:
-            return "file:%s" % fname
-        else:
-            raise Exception(scode=winerror.E_UNEXPECTED)
-
-
-if __name__ == "__main__":
-    import sys
-
-    sys.path.append(".")
-    import ttest
-
-    sc = SourceModuleContainer(ttest)
-    #       sc = SourceCodeContainer(open(sys.argv[1], "rb").read(), sys.argv[1])
-    attrs = sc.GetSyntaxColorAttributes()
-    attrlen = 0
-    for attr in attrs:
-        if type(attr) == type(()):
-            attrlen = attrlen + attr[1]
-        else:
-            attrlen = attrlen + 1
-    text = sc.GetText()
-    if attrlen != len(text):
-        print("Lengths dont match!!! (%d/%d)" % (attrlen, len(text)))
-
-    #       print "Attributes:"
-    #       print attrs
-    print("GetLineOfPos=", sc.GetLineOfPosition(0))
-    print("GetLineOfPos=", sc.GetLineOfPosition(4))
-    print("GetLineOfPos=", sc.GetLineOfPosition(10))
diff --git a/lib/win32comext/axdebug/contexts.py b/lib/win32comext/axdebug/contexts.py
deleted file mode 100644
index 85816639..00000000
--- a/lib/win32comext/axdebug/contexts.py
+++ /dev/null
@@ -1,62 +0,0 @@
-""" A module for managing the AXDebug I*Contexts
-
-"""
-import pythoncom
-import win32com.server.util
-
-from . import adb, axdebug, gateways
-
-# Utility function for wrapping object created by this module.
-from .util import _wrap, _wrap_remove, trace
-
-
-class DebugCodeContext(gateways.DebugCodeContext, gateways.DebugDocumentContext):
-    # NOTE: We also implement the IDebugDocumentContext interface for Simple Hosts.
-    # Thus, debugDocument may be NULL when we have smart hosts - but in that case, we
-    # wont be called upon to provide it.
-    _public_methods_ = (
-        gateways.DebugCodeContext._public_methods_
-        + gateways.DebugDocumentContext._public_methods_
-    )
-    _com_interfaces_ = (
-        gateways.DebugCodeContext._com_interfaces_
-        + gateways.DebugDocumentContext._com_interfaces_
-    )
-
-    def __init__(self, lineNo, charPos, len, codeContainer, debugSite):
-        self.debugSite = debugSite
-        self.offset = charPos
-        self.length = len
-        self.breakPointState = 0
-        self.lineno = lineNo
-        gateways.DebugCodeContext.__init__(self)
-        self.codeContainer = codeContainer
-
-    def _Close(self):
-        self.debugSite = None
-
-    def GetDocumentContext(self):
-        if self.debugSite is not None:
-            # We have a smart host - let him give it to us.
-            return self.debugSite.GetDocumentContextFromPosition(
-                self.codeContainer.sourceContext, self.offset, self.length
-            )
-        else:
-            # Simple host - Fine - Ill do it myself!
-            return _wrap(self, axdebug.IID_IDebugDocumentContext)
-
-    def SetBreakPoint(self, bps):
-        self.breakPointState = bps
-        adb.OnSetBreakPoint(self, bps, self.lineno)
-
-    # The DebugDocumentContext methods for simple hosts.
-    def GetDocument(self):
-        return self.codeContainer.debugDocument
-
-    def EnumCodeContexts(self):
-        return _wrap(EnumDebugCodeContexts([self]), axdebug.IID_IEnumDebugCodeContexts)
-
-
-class EnumDebugCodeContexts(gateways.EnumDebugCodeContexts):
-    def _wrap(self, obj):
-        return _wrap(obj, axdebug.IID_IDebugCodeContext)
diff --git a/lib/win32comext/axdebug/debugger.py b/lib/win32comext/axdebug/debugger.py
deleted file mode 100644
index 3157586b..00000000
--- a/lib/win32comext/axdebug/debugger.py
+++ /dev/null
@@ -1,250 +0,0 @@
-import os
-import string
-import sys
-
-import pythoncom
-import win32api
-from win32com.axdebug import (
-    adb,
-    axdebug,
-    codecontainer,
-    contexts,
-    documents,
-    expressions,
-    gateways,
-)
-from win32com.axdebug.util import _wrap, _wrap_remove, trace
-from win32com.axscript import axscript
-
-currentDebugger = None
-
-
-class ModuleTreeNode:
-    """Helper class for building a module tree"""
-
-    def __init__(self, module):
-        modName = module.__name__
-        self.moduleName = modName
-        self.module = module
-        self.realNode = None
-        self.cont = codecontainer.SourceModuleContainer(module)
-
-    def __repr__(self):
-        return "<ModuleTreeNode wrapping %s>" % (self.module)
-
-    def Attach(self, parentRealNode):
-        self.realNode.Attach(parentRealNode)
-
-    def Close(self):
-        self.module = None
-        self.cont = None
-        self.realNode = None
-
-
-def BuildModule(module, built_nodes, rootNode, create_node_fn, create_node_args):
-    if module:
-        keep = module.__name__
-        keep = keep and (built_nodes.get(module) is None)
-        if keep and hasattr(module, "__file__"):
-            keep = string.lower(os.path.splitext(module.__file__)[1]) not in [
-                ".pyd",
-                ".dll",
-            ]
-    #               keep = keep and module.__name__=='__main__'
-    if module and keep:
-        #        print "keeping", module.__name__
-        node = ModuleTreeNode(module)
-        built_nodes[module] = node
-        realNode = create_node_fn(*(node,) + create_node_args)
-        node.realNode = realNode
-
-        # Split into parent nodes.
-        parts = string.split(module.__name__, ".")
-        if parts[-1][:8] == "__init__":
-            parts = parts[:-1]
-        parent = string.join(parts[:-1], ".")
-        parentNode = rootNode
-        if parent:
-            parentModule = sys.modules[parent]
-            BuildModule(
-                parentModule, built_nodes, rootNode, create_node_fn, create_node_args
-            )
-            if parentModule in built_nodes:
-                parentNode = built_nodes[parentModule].realNode
-        node.Attach(parentNode)
-
-
-def RefreshAllModules(builtItems, rootNode, create_node, create_node_args):
-    for module in list(sys.modules.values()):
-        BuildModule(module, builtItems, rootNode, create_node, create_node_args)
-
-
-# realNode = pdm.CreateDebugDocumentHelper(None) # DebugDocumentHelper node?
-# app.CreateApplicationNode() # doc provider node.
-
-
-class CodeContainerProvider(documents.CodeContainerProvider):
-    def __init__(self, axdebugger):
-        self.axdebugger = axdebugger
-        documents.CodeContainerProvider.__init__(self)
-        self.currentNumModules = len(sys.modules)
-        self.nodes = {}
-        self.axdebugger.RefreshAllModules(self.nodes, self)
-
-    def FromFileName(self, fname):
-        ### It appears we cant add modules during a debug session!
-        #               if self.currentNumModules != len(sys.modules):
-        #                       self.axdebugger.RefreshAllModules(self.nodes, self)
-        #                       self.currentNumModules = len(sys.modules)
-        #               for key in self.ccsAndNodes.keys():
-        #                       print "File:", key
-        return documents.CodeContainerProvider.FromFileName(self, fname)
-
-    def Close(self):
-        documents.CodeContainerProvider.Close(self)
-        self.axdebugger = None
-        print("Closing %d nodes" % (len(self.nodes)))
-        for node in self.nodes.values():
-            node.Close()
-        self.nodes = {}
-
-
-class OriginalInterfaceMaker:
-    def MakeInterfaces(self, pdm):
-        app = self.pdm.CreateApplication()
-        self.cookie = pdm.AddApplication(app)
-        root = app.GetRootNode()
-        return app, root
-
-    def CloseInterfaces(self, pdm):
-        pdm.RemoveApplication(self.cookie)
-
-
-class SimpleHostStyleInterfaceMaker:
-    def MakeInterfaces(self, pdm):
-        app = pdm.GetDefaultApplication()
-        root = app.GetRootNode()
-        return app, root
-
-    def CloseInterfaces(self, pdm):
-        pass
-
-
-class AXDebugger:
-    def __init__(self, interfaceMaker=None, processName=None):
-        if processName is None:
-            processName = "Python Process"
-        if interfaceMaker is None:
-            interfaceMaker = SimpleHostStyleInterfaceMaker()
-
-        self.pydebugger = adb.Debugger()
-
-        self.pdm = pythoncom.CoCreateInstance(
-            axdebug.CLSID_ProcessDebugManager,
-            None,
-            pythoncom.CLSCTX_ALL,
-            axdebug.IID_IProcessDebugManager,
-        )
-
-        self.app, self.root = interfaceMaker.MakeInterfaces(self.pdm)
-        self.app.SetName(processName)
-        self.interfaceMaker = interfaceMaker
-
-        expressionProvider = _wrap(
-            expressions.ProvideExpressionContexts(),
-            axdebug.IID_IProvideExpressionContexts,
-        )
-        self.expressionCookie = self.app.AddGlobalExpressionContextProvider(
-            expressionProvider
-        )
-
-        contProvider = CodeContainerProvider(self)
-        self.pydebugger.AttachApp(self.app, contProvider)
-
-    def Break(self):
-        # Get the frame we start debugging from - this is the frame 1 level up
-        try:
-            1 + ""
-        except:
-            frame = sys.exc_info()[2].tb_frame.f_back
-
-        # Get/create the debugger, and tell it to break.
-        self.app.StartDebugSession()
-        #               self.app.CauseBreak()
-
-        self.pydebugger.SetupAXDebugging(None, frame)
-        self.pydebugger.set_trace()
-
-    def Close(self):
-        self.pydebugger.ResetAXDebugging()
-        self.interfaceMaker.CloseInterfaces(self.pdm)
-        self.pydebugger.CloseApp()
-        self.app.RemoveGlobalExpressionContextProvider(self.expressionCookie)
-        self.expressionCookie = None
-
-        self.pdm = None
-        self.app = None
-        self.pydebugger = None
-        self.root = None
-
-    def RefreshAllModules(self, nodes, containerProvider):
-        RefreshAllModules(
-            nodes, self.root, self.CreateApplicationNode, (containerProvider,)
-        )
-
-    def CreateApplicationNode(self, node, containerProvider):
-        realNode = self.app.CreateApplicationNode()
-
-        document = documents.DebugDocumentText(node.cont)
-        document = _wrap(document, axdebug.IID_IDebugDocument)
-
-        node.cont.debugDocument = document
-
-        provider = documents.DebugDocumentProvider(document)
-        provider = _wrap(provider, axdebug.IID_IDebugDocumentProvider)
-        realNode.SetDocumentProvider(provider)
-
-        containerProvider.AddCodeContainer(node.cont, realNode)
-        return realNode
-
-
-def _GetCurrentDebugger():
-    global currentDebugger
-    if currentDebugger is None:
-        currentDebugger = AXDebugger()
-    return currentDebugger
-
-
-def Break():
-    _GetCurrentDebugger().Break()
-
-
-brk = Break
-set_trace = Break
-
-
-def dosomethingelse():
-    a = 2
-    b = "Hi there"
-
-
-def dosomething():
-    a = 1
-    b = 2
-    dosomethingelse()
-
-
-def test():
-    Break()
-    input("Waiting...")
-    dosomething()
-    print("Done")
-
-
-if __name__ == "__main__":
-    print("About to test the debugging interfaces!")
-    test()
-    print(
-        " %d/%d com objects still alive"
-        % (pythoncom._GetInterfaceCount(), pythoncom._GetGatewayCount())
-    )
diff --git a/lib/win32comext/axdebug/documents.py b/lib/win32comext/axdebug/documents.py
deleted file mode 100644
index d039cf40..00000000
--- a/lib/win32comext/axdebug/documents.py
+++ /dev/null
@@ -1,140 +0,0 @@
-""" Management of documents for AXDebugging.
-"""
-
-
-import pythoncom
-import win32api
-from win32com.server.exception import Exception
-from win32com.server.util import unwrap
-
-from . import axdebug, codecontainer, contexts, gateways
-from .util import RaiseNotImpl, _wrap, _wrap_remove, trace
-
-# def trace(*args):
-#       pass
-
-
-def GetGoodFileName(fname):
-    if fname[0] != "<":
-        return win32api.GetFullPathName(fname)
-    return fname
-
-
-class DebugDocumentProvider(gateways.DebugDocumentProvider):
-    def __init__(self, doc):
-        self.doc = doc
-
-    def GetName(self, dnt):
-        return self.doc.GetName(dnt)
-
-    def GetDocumentClassId(self):
-        return self.doc.GetDocumentClassId()
-
-    def GetDocument(self):
-        return self.doc
-
-
-class DebugDocumentText(
-    gateways.DebugDocumentInfo, gateways.DebugDocumentText, gateways.DebugDocument
-):
-    _com_interfaces_ = (
-        gateways.DebugDocumentInfo._com_interfaces_
-        + gateways.DebugDocumentText._com_interfaces_
-        + gateways.DebugDocument._com_interfaces_
-    )
-    _public_methods_ = (
-        gateways.DebugDocumentInfo._public_methods_
-        + gateways.DebugDocumentText._public_methods_
-        + gateways.DebugDocument._public_methods_
-    )
-
-    # A class which implements a DebugDocumentText, using the functionality
-    # provided by a codeContainer
-    def __init__(self, codeContainer):
-        gateways.DebugDocumentText.__init__(self)
-        gateways.DebugDocumentInfo.__init__(self)
-        gateways.DebugDocument.__init__(self)
-        self.codeContainer = codeContainer
-
-    def _Close(self):
-        self.docContexts = None
-        #               self.codeContainer._Close()
-        self.codeContainer = None
-
-    # IDebugDocumentInfo
-    def GetName(self, dnt):
-        return self.codeContainer.GetName(dnt)
-
-    def GetDocumentClassId(self):
-        return "{DF630910-1C1D-11d0-AE36-8C0F5E000000}"
-
-    # IDebugDocument has no methods!
-    #
-
-    # IDebugDocumentText methods.
-    # def GetDocumentAttributes
-    def GetSize(self):
-        #               trace("GetSize")
-        return self.codeContainer.GetNumLines(), self.codeContainer.GetNumChars()
-
-    def GetPositionOfLine(self, cLineNumber):
-        return self.codeContainer.GetPositionOfLine(cLineNumber)
-
-    def GetLineOfPosition(self, charPos):
-        return self.codeContainer.GetLineOfPosition(charPos)
-
-    def GetText(self, charPos, maxChars, wantAttr):
-        # Get all the attributes, else the tokenizer will get upset.
-        # XXX - not yet!
-        #               trace("GetText", charPos, maxChars, wantAttr)
-        cont = self.codeContainer
-        attr = cont.GetSyntaxColorAttributes()
-        return cont.GetText(), attr
-
-    def GetPositionOfContext(self, context):
-        trace("GetPositionOfContext", context)
-        context = unwrap(context)
-        return context.offset, context.length
-
-    # Return a DebugDocumentContext.
-    def GetContextOfPosition(self, charPos, maxChars):
-        # Make one
-        doc = _wrap(self, axdebug.IID_IDebugDocument)
-        rc = self.codeContainer.GetCodeContextAtPosition(charPos)
-        return rc.QueryInterface(axdebug.IID_IDebugDocumentContext)
-
-
-class CodeContainerProvider:
-    """An abstract Python class which provides code containers!
-
-    Given a Python file name (as the debugger knows it by) this will
-    return a CodeContainer interface suitable for use.
-
-    This provides a simple base imlpementation that simply supports
-    a dictionary of nodes and providers.
-    """
-
-    def __init__(self):
-        self.ccsAndNodes = {}
-
-    def AddCodeContainer(self, cc, node=None):
-        fname = GetGoodFileName(cc.fileName)
-        self.ccsAndNodes[fname] = cc, node
-
-    def FromFileName(self, fname):
-        cc, node = self.ccsAndNodes.get(GetGoodFileName(fname), (None, None))
-        #               if cc is None:
-        #                       print "FromFileName for %s returning None" % fname
-        return cc
-
-    def Close(self):
-        for cc, node in self.ccsAndNodes.values():
-            try:
-                # Must close the node before closing the provider
-                # as node may make calls on provider (eg Reset breakpoints etc)
-                if node is not None:
-                    node.Close()
-                cc._Close()
-            except pythoncom.com_error:
-                pass
-        self.ccsAndNodes = {}
diff --git a/lib/win32comext/axdebug/dump.py b/lib/win32comext/axdebug/dump.py
deleted file mode 100644
index 26ee51e0..00000000
--- a/lib/win32comext/axdebug/dump.py
+++ /dev/null
@@ -1,61 +0,0 @@
-import traceback
-
-import pythoncom
-from win32com.axdebug import axdebug
-from win32com.client.util import Enumerator
-
-
-def DumpDebugApplicationNode(node, level=0):
-    # Recursive dump of a DebugApplicationNode
-    spacer = " " * level
-    for desc, attr in [
-        ("Node Name", axdebug.DOCUMENTNAMETYPE_APPNODE),
-        ("Title", axdebug.DOCUMENTNAMETYPE_TITLE),
-        ("Filename", axdebug.DOCUMENTNAMETYPE_FILE_TAIL),
-        ("URL", axdebug.DOCUMENTNAMETYPE_URL),
-    ]:
-        try:
-            info = node.GetName(attr)
-        except pythoncom.com_error:
-            info = "<N/A>"
-        print("%s%s: %s" % (spacer, desc, info))
-    try:
-        doc = node.GetDocument()
-    except pythoncom.com_error:
-        doc = None
-    if doc:
-        doctext = doc.QueryInterface(axdebug.IID_IDebugDocumentText)
-        numLines, numChars = doctext.GetSize()
-        #                       text, attr = doctext.GetText(0, 20, 1)
-        text, attr = doctext.GetText(0, numChars, 1)
-        print(
-            "%sText is %s, %d bytes long" % (spacer, repr(text[:40] + "..."), len(text))
-        )
-    else:
-        print("%s%s" % (spacer, "<No document available>"))
-
-    for child in Enumerator(node.EnumChildren()):
-        DumpDebugApplicationNode(child, level + 1)
-
-
-def dumpall():
-    dm = pythoncom.CoCreateInstance(
-        axdebug.CLSID_MachineDebugManager,
-        None,
-        pythoncom.CLSCTX_ALL,
-        axdebug.IID_IMachineDebugManager,
-    )
-    e = Enumerator(dm.EnumApplications())
-    for app in e:
-        print("Application: %s" % app.GetName())
-        node = (
-            app.GetRootNode()
-        )  # of type PyIDebugApplicationNode->PyIDebugDocumentProvider->PyIDebugDocumentInfo
-        DumpDebugApplicationNode(node)
-
-
-if __name__ == "__main__":
-    try:
-        dumpall()
-    except:
-        traceback.print_exc()
diff --git a/lib/win32comext/axdebug/expressions.py b/lib/win32comext/axdebug/expressions.py
deleted file mode 100644
index 28c7b904..00000000
--- a/lib/win32comext/axdebug/expressions.py
+++ /dev/null
@@ -1,214 +0,0 @@
-import io
-import string
-import sys
-import traceback
-from pprint import pprint
-
-import winerror
-from win32com.server.exception import COMException
-
-from . import axdebug, gateways
-from .util import RaiseNotImpl, _wrap, _wrap_remove
-
-
-# Given an object, return a nice string
-def MakeNiceString(ob):
-    stream = io.StringIO()
-    pprint(ob, stream)
-    return string.strip(stream.getvalue())
-
-
-class ProvideExpressionContexts(gateways.ProvideExpressionContexts):
-    pass
-
-
-class ExpressionContext(gateways.DebugExpressionContext):
-    def __init__(self, frame):
-        self.frame = frame
-
-    def ParseLanguageText(self, code, radix, delim, flags):
-        return _wrap(
-            Expression(self.frame, code, radix, delim, flags),
-            axdebug.IID_IDebugExpression,
-        )
-
-    def GetLanguageInfo(self):
-        #               print "GetLanguageInfo"
-        return "Python", "{DF630910-1C1D-11d0-AE36-8C0F5E000000}"
-
-
-class Expression(gateways.DebugExpression):
-    def __init__(self, frame, code, radix, delim, flags):
-        self.callback = None
-        self.frame = frame
-        self.code = code
-        self.radix = radix
-        self.delim = delim
-        self.flags = flags
-        self.isComplete = 0
-        self.result = None
-        self.hresult = winerror.E_UNEXPECTED
-
-    def Start(self, callback):
-        try:
-            try:
-                try:
-                    self.result = eval(
-                        self.code, self.frame.f_globals, self.frame.f_locals
-                    )
-                except SyntaxError:
-                    exec(self.code, self.frame.f_globals, self.frame.f_locals)
-                    self.result = ""
-                self.hresult = 0
-            except:
-                l = traceback.format_exception_only(
-                    sys.exc_info()[0], sys.exc_info()[1]
-                )
-                # l is a list of strings with trailing "\n"
-                self.result = string.join(map(lambda s: s[:-1], l), "\n")
-                self.hresult = winerror.E_FAIL
-        finally:
-            self.isComplete = 1
-            callback.onComplete()
-
-    def Abort(self):
-        print("** ABORT **")
-
-    def QueryIsComplete(self):
-        return self.isComplete
-
-    def GetResultAsString(self):
-        #               print "GetStrAsResult returning", self.result
-        return self.hresult, MakeNiceString(self.result)
-
-    def GetResultAsDebugProperty(self):
-        result = _wrap(
-            DebugProperty(self.code, self.result, None, self.hresult),
-            axdebug.IID_IDebugProperty,
-        )
-        return self.hresult, result
-
-
-def MakeEnumDebugProperty(object, dwFieldSpec, nRadix, iid, stackFrame=None):
-    name_vals = []
-    if hasattr(object, "items") and hasattr(object, "keys"):  # If it is a dict.
-        name_vals = iter(object.items())
-        dictionary = object
-    elif hasattr(object, "__dict__"):  # object with dictionary, module
-        name_vals = iter(object.__dict__.items())
-        dictionary = object.__dict__
-    infos = []
-    for name, val in name_vals:
-        infos.append(
-            GetPropertyInfo(name, val, dwFieldSpec, nRadix, 0, dictionary, stackFrame)
-        )
-    return _wrap(EnumDebugPropertyInfo(infos), axdebug.IID_IEnumDebugPropertyInfo)
-
-
-def GetPropertyInfo(
-    obname, obvalue, dwFieldSpec, nRadix, hresult=0, dictionary=None, stackFrame=None
-):
-    # returns a tuple
-    name = typ = value = fullname = attrib = dbgprop = None
-    if dwFieldSpec & axdebug.DBGPROP_INFO_VALUE:
-        value = MakeNiceString(obvalue)
-    if dwFieldSpec & axdebug.DBGPROP_INFO_NAME:
-        name = obname
-    if dwFieldSpec & axdebug.DBGPROP_INFO_TYPE:
-        if hresult:
-            typ = "Error"
-        else:
-            try:
-                typ = type(obvalue).__name__
-            except AttributeError:
-                typ = str(type(obvalue))
-    if dwFieldSpec & axdebug.DBGPROP_INFO_FULLNAME:
-        fullname = obname
-    if dwFieldSpec & axdebug.DBGPROP_INFO_ATTRIBUTES:
-        if hasattr(obvalue, "has_key") or hasattr(
-            obvalue, "__dict__"
-        ):  # If it is a dict or object
-            attrib = axdebug.DBGPROP_ATTRIB_VALUE_IS_EXPANDABLE
-        else:
-            attrib = 0
-    if dwFieldSpec & axdebug.DBGPROP_INFO_DEBUGPROP:
-        dbgprop = _wrap(
-            DebugProperty(name, obvalue, None, hresult, dictionary, stackFrame),
-            axdebug.IID_IDebugProperty,
-        )
-    return name, typ, value, fullname, attrib, dbgprop
-
-
-from win32com.server.util import ListEnumeratorGateway
-
-
-class EnumDebugPropertyInfo(ListEnumeratorGateway):
-    """A class to expose a Python sequence as an EnumDebugCodeContexts
-
-    Create an instance of this class passing a sequence (list, tuple, or
-    any sequence protocol supporting object) and it will automatically
-    support the EnumDebugCodeContexts interface for the object.
-
-    """
-
-    _public_methods_ = ListEnumeratorGateway._public_methods_ + ["GetCount"]
-    _com_interfaces_ = [axdebug.IID_IEnumDebugPropertyInfo]
-
-    def GetCount(self):
-        return len(self._list_)
-
-    def _wrap(self, ob):
-        return ob
-
-
-class DebugProperty:
-    _com_interfaces_ = [axdebug.IID_IDebugProperty]
-    _public_methods_ = [
-        "GetPropertyInfo",
-        "GetExtendedInfo",
-        "SetValueAsString",
-        "EnumMembers",
-        "GetParent",
-    ]
-
-    def __init__(
-        self, name, value, parent=None, hresult=0, dictionary=None, stackFrame=None
-    ):
-        self.name = name
-        self.value = value
-        self.parent = parent
-        self.hresult = hresult
-        self.dictionary = dictionary
-        self.stackFrame = stackFrame
-
-    def GetPropertyInfo(self, dwFieldSpec, nRadix):
-        return GetPropertyInfo(
-            self.name,
-            self.value,
-            dwFieldSpec,
-            nRadix,
-            self.hresult,
-            dictionary,
-            stackFrame,
-        )
-
-    def GetExtendedInfo(self):  ### Note - not in the framework.
-        RaiseNotImpl("DebugProperty::GetExtendedInfo")
-
-    def SetValueAsString(self, value, radix):
-        if self.stackFrame and self.dictionary:
-            self.dictionary[self.name] = eval(
-                value, self.stackFrame.f_globals, self.stackFrame.f_locals
-            )
-        else:
-            RaiseNotImpl("DebugProperty::SetValueAsString")
-
-    def EnumMembers(self, dwFieldSpec, nRadix, iid):
-        # Returns IEnumDebugPropertyInfo
-        return MakeEnumDebugProperty(
-            self.value, dwFieldSpec, nRadix, iid, self.stackFrame
-        )
-
-    def GetParent(self):
-        # return IDebugProperty
-        RaiseNotImpl("DebugProperty::GetParent")
diff --git a/lib/win32comext/axdebug/gateways.py b/lib/win32comext/axdebug/gateways.py
deleted file mode 100644
index d87e85b3..00000000
--- a/lib/win32comext/axdebug/gateways.py
+++ /dev/null
@@ -1,583 +0,0 @@
-# Classes which describe interfaces.
-
-import pythoncom
-import win32com.server.connect
-import winerror
-from win32com.axdebug import axdebug
-from win32com.axdebug.util import RaiseNotImpl, _wrap
-from win32com.server.exception import Exception
-from win32com.server.util import ListEnumeratorGateway
-
-
-class EnumDebugCodeContexts(ListEnumeratorGateway):
-    """A class to expose a Python sequence as an EnumDebugCodeContexts
-
-    Create an instance of this class passing a sequence (list, tuple, or
-    any sequence protocol supporting object) and it will automatically
-    support the EnumDebugCodeContexts interface for the object.
-
-    """
-
-    _com_interfaces_ = [axdebug.IID_IEnumDebugCodeContexts]
-
-
-class EnumDebugStackFrames(ListEnumeratorGateway):
-    """A class to expose a Python sequence as an EnumDebugStackFrames
-
-    Create an instance of this class passing a sequence (list, tuple, or
-    any sequence protocol supporting object) and it will automatically
-    support the EnumDebugStackFrames interface for the object.
-
-    """
-
-    _com_interfaces_ = [axdebug.IID_IEnumDebugStackFrames]
-
-
-class EnumDebugApplicationNodes(ListEnumeratorGateway):
-    """A class to expose a Python sequence as an EnumDebugStackFrames
-
-    Create an instance of this class passing a sequence (list, tuple, or
-    any sequence protocol supporting object) and it will automatically
-    support the EnumDebugApplicationNodes interface for the object.
-
-    """
-
-    _com_interfaces_ = [axdebug.IID_IEnumDebugApplicationNodes]
-
-
-class EnumRemoteDebugApplications(ListEnumeratorGateway):
-    _com_interfaces_ = [axdebug.IID_IEnumRemoteDebugApplications]
-
-
-class EnumRemoteDebugApplicationThreads(ListEnumeratorGateway):
-    _com_interfaces_ = [axdebug.IID_IEnumRemoteDebugApplicationThreads]
-
-
-class DebugDocumentInfo:
-    _public_methods_ = ["GetName", "GetDocumentClassId"]
-    _com_interfaces_ = [axdebug.IID_IDebugDocumentInfo]
-
-    def __init__(self):
-        pass
-
-    def GetName(self, dnt):
-        """Get the one of the name of the document
-        dnt -- int DOCUMENTNAMETYPE
-        """
-        RaiseNotImpl("GetName")
-
-    def GetDocumentClassId(self):
-        """
-        Result must be an IID object (or string representing one).
-        """
-        RaiseNotImpl("GetDocumentClassId")
-
-
-class DebugDocumentProvider(DebugDocumentInfo):
-    _public_methods_ = DebugDocumentInfo._public_methods_ + ["GetDocument"]
-    _com_interfaces_ = DebugDocumentInfo._com_interfaces_ + [
-        axdebug.IID_IDebugDocumentProvider
-    ]
-
-    def GetDocument(self):
-        RaiseNotImpl("GetDocument")
-
-
-class DebugApplicationNode(DebugDocumentProvider):
-    """Provides the functionality of IDebugDocumentProvider, plus a context within a project tree."""
-
-    _public_methods_ = (
-        """EnumChildren GetParent SetDocumentProvider
-                    Close Attach Detach""".split()
-        + DebugDocumentProvider._public_methods_
-    )
-    _com_interfaces_ = [
-        axdebug.IID_IDebugDocumentProvider
-    ] + DebugDocumentProvider._com_interfaces_
-
-    def __init__(self):
-        DebugDocumentProvider.__init__(self)
-
-    def EnumChildren(self):
-        # Result is type PyIEnumDebugApplicationNodes
-        RaiseNotImpl("EnumChildren")
-
-    def GetParent(self):
-        # result is type PyIDebugApplicationNode
-        RaiseNotImpl("GetParent")
-
-    def SetDocumentProvider(self, pddp):  # PyIDebugDocumentProvider pddp
-        # void result.
-        RaiseNotImpl("SetDocumentProvider")
-
-    def Close(self):
-        # void result.
-        RaiseNotImpl("Close")
-
-    def Attach(self, parent):  # PyIDebugApplicationNode
-        # void result.
-        RaiseNotImpl("Attach")
-
-    def Detach(self):
-        # void result.
-        RaiseNotImpl("Detach")
-
-
-class DebugApplicationNodeEvents:
-    """Event interface for DebugApplicationNode object."""
-
-    _public_methods_ = "onAddChild onRemoveChild onDetach".split()
-    _com_interfaces_ = [axdebug.IID_IDebugApplicationNodeEvents]
-
-    def __init__(self):
-        pass
-
-    def onAddChild(self, child):  # PyIDebugApplicationNode
-        # void result.
-        RaiseNotImpl("onAddChild")
-
-    def onRemoveChild(self, child):  # PyIDebugApplicationNode
-        # void result.
-        RaiseNotImpl("onRemoveChild")
-
-    def onDetach(self):
-        # void result.
-        RaiseNotImpl("onDetach")
-
-    def onAttach(self, parent):  # PyIDebugApplicationNode
-        # void result.
-        RaiseNotImpl("onAttach")
-
-
-class DebugDocument(DebugDocumentInfo):
-    """The base interface to all debug documents."""
-
-    _public_methods_ = DebugDocumentInfo._public_methods_
-    _com_interfaces_ = [axdebug.IID_IDebugDocument] + DebugDocumentInfo._com_interfaces_
-
-
-class DebugDocumentText(DebugDocument):
-    """The interface to a text only debug document."""
-
-    _com_interfaces_ = [axdebug.IID_IDebugDocumentText] + DebugDocument._com_interfaces_
-    _public_methods_ = [
-        "GetDocumentAttributes",
-        "GetSize",
-        "GetPositionOfLine",
-        "GetLineOfPosition",
-        "GetText",
-        "GetPositionOfContext",
-        "GetContextOfPosition",
-    ] + DebugDocument._public_methods_
-
-    def __init__(self):
-        pass
-
-    # IDebugDocumentText
-    def GetDocumentAttributes(self):
-        # Result is int (TEXT_DOC_ATTR)
-        RaiseNotImpl("GetDocumentAttributes")
-
-    def GetSize(self):
-        # Result is (numLines, numChars)
-        RaiseNotImpl("GetSize")
-
-    def GetPositionOfLine(self, cLineNumber):
-        # Result is int char position
-        RaiseNotImpl("GetPositionOfLine")
-
-    def GetLineOfPosition(self, charPos):
-        # Result is int, int (lineNo, offset)
-        RaiseNotImpl("GetLineOfPosition")
-
-    def GetText(self, charPos, maxChars, wantAttr):
-        """Params
-        charPos -- integer
-        maxChars -- integer
-        wantAttr -- Should the function compute attributes.
-
-        Return value must be (string, attribtues).  attributes may be
-        None if(not wantAttr)
-        """
-        RaiseNotImpl("GetText")
-
-    def GetPositionOfContext(self, debugDocumentContext):
-        """Params
-        debugDocumentContext -- a PyIDebugDocumentContext object.
-
-        Return value must be (charPos, numChars)
-        """
-        RaiseNotImpl("GetPositionOfContext")
-
-    def GetContextOfPosition(self, charPos, maxChars):
-        """Params are integers.
-        Return value must be PyIDebugDocumentContext object
-        """
-        print(self)
-        RaiseNotImpl("GetContextOfPosition")
-
-
-class DebugDocumentTextExternalAuthor:
-    """Allow external editors to edit file-based debugger documents, and to notify the document when the source file has been changed."""
-
-    _public_methods_ = ["GetPathName", "GetFileName", "NotifyChanged"]
-    _com_interfaces_ = [axdebug.IID_IDebugDocumentTextExternalAuthor]
-
-    def __init__(self):
-        pass
-
-    def GetPathName(self):
-        """Return the full path (including file name) to the document's source file.
-
-        Result must be (filename, fIsOriginal), where
-        - if fIsOriginalPath is TRUE if the path refers to the original file for the document.
-        - if fIsOriginalPath is FALSE if the path refers to a newly created temporary file.
-
-        raise Exception(winerror.E_FAIL) if no source file can be created/determined.
-        """
-        RaiseNotImpl("GetPathName")
-
-    def GetFileName(self):
-        """Return just the name of the document, with no path information.  (Used for "Save As...")
-
-        Result is a string
-        """
-        RaiseNotImpl("GetFileName")
-
-    def NotifyChanged(self):
-        """Notify the host that the document's source file has been saved and
-        that its contents should be refreshed.
-        """
-        RaiseNotImpl("NotifyChanged")
-
-
-class DebugDocumentTextEvents:
-    _public_methods_ = """onDestroy onInsertText onRemoveText
-              onReplaceText onUpdateTextAttributes
-              onUpdateDocumentAttributes""".split()
-    _com_interfaces_ = [axdebug.IID_IDebugDocumentTextEvents]
-
-    def __init__(self):
-        pass
-
-    def onDestroy(self):
-        # Result is void.
-        RaiseNotImpl("onDestroy")
-
-    def onInsertText(self, cCharacterPosition, cNumToInsert):
-        # Result is void.
-        RaiseNotImpl("onInsertText")
-
-    def onRemoveText(self, cCharacterPosition, cNumToRemove):
-        # Result is void.
-        RaiseNotImpl("onRemoveText")
-
-    def onReplaceText(self, cCharacterPosition, cNumToReplace):
-        # Result is void.
-        RaiseNotImpl("onReplaceText")
-
-    def onUpdateTextAttributes(self, cCharacterPosition, cNumToUpdate):
-        # Result is void.
-        RaiseNotImpl("onUpdateTextAttributes")
-
-    def onUpdateDocumentAttributes(self, textdocattr):  # TEXT_DOC_ATTR
-        # Result is void.
-        RaiseNotImpl("onUpdateDocumentAttributes")
-
-
-class DebugDocumentContext:
-    _public_methods_ = ["GetDocument", "EnumCodeContexts"]
-    _com_interfaces_ = [axdebug.IID_IDebugDocumentContext]
-
-    def __init__(self):
-        pass
-
-    def GetDocument(self):
-        """Return value must be a PyIDebugDocument object"""
-        RaiseNotImpl("GetDocument")
-
-    def EnumCodeContexts(self):
-        """Return value must be a PyIEnumDebugCodeContexts object"""
-        RaiseNotImpl("EnumCodeContexts")
-
-
-class DebugCodeContext:
-    _public_methods_ = ["GetDocumentContext", "SetBreakPoint"]
-    _com_interfaces_ = [axdebug.IID_IDebugCodeContext]
-
-    def __init__(self):
-        pass
-
-    def GetDocumentContext(self):
-        """Return value must be a PyIDebugDocumentContext object"""
-        RaiseNotImpl("GetDocumentContext")
-
-    def SetBreakPoint(self, bps):
-        """bps -- an integer with flags."""
-        RaiseNotImpl("SetBreakPoint")
-
-
-class DebugStackFrame:
-    """Abstraction representing a logical stack frame on the stack of a thread."""
-
-    _public_methods_ = [
-        "GetCodeContext",
-        "GetDescriptionString",
-        "GetLanguageString",
-        "GetThread",
-        "GetDebugProperty",
-    ]
-    _com_interfaces_ = [axdebug.IID_IDebugStackFrame]
-
-    def __init__(self):
-        pass
-
-    def GetCodeContext(self):
-        """Returns the current code context associated with the stack frame.
-
-        Return value must be a IDebugCodeContext object
-        """
-        RaiseNotImpl("GetCodeContext")
-
-    def GetDescriptionString(self, fLong):
-        """Returns a textual description of the stack frame.
-
-        fLong -- A flag indicating if the long name is requested.
-        """
-        RaiseNotImpl("GetDescriptionString")
-
-    def GetLanguageString(self):
-        """Returns a short or long textual description of the language.
-
-        fLong -- A flag indicating if the long name is requested.
-        """
-        RaiseNotImpl("GetLanguageString")
-
-    def GetThread(self):
-        """Returns the thread associated with this stack frame.
-
-        Result must be a IDebugApplicationThread
-        """
-        RaiseNotImpl("GetThread")
-
-    def GetDebugProperty(self):
-        RaiseNotImpl("GetDebugProperty")
-
-
-class DebugDocumentHost:
-    """The interface from the IDebugDocumentHelper back to
-    the smart host or language engine.  This interface
-    exposes host specific functionality such as syntax coloring.
-    """
-
-    _public_methods_ = [
-        "GetDeferredText",
-        "GetScriptTextAttributes",
-        "OnCreateDocumentContext",
-        "GetPathName",
-        "GetFileName",
-        "NotifyChanged",
-    ]
-    _com_interfaces_ = [axdebug.IID_IDebugDocumentHost]
-
-    def __init__(self):
-        pass
-
-    def GetDeferredText(self, dwTextStartCookie, maxChars, bWantAttr):
-        RaiseNotImpl("GetDeferredText")
-
-    def GetScriptTextAttributes(self, codeText, delimterText, flags):
-        # Result must be an attribute sequence of same "length" as the code.
-        RaiseNotImpl("GetScriptTextAttributes")
-
-    def OnCreateDocumentContext(self):
-        # Result must be a PyIUnknown
-        RaiseNotImpl("OnCreateDocumentContext")
-
-    def GetPathName(self):
-        # Result must be (string, int) where the int is a BOOL
-        # - TRUE if the path refers to the original file for the document.
-        # - FALSE if the path refers to a newly created temporary file.
-        # - raise Exception(scode=E_FAIL) if no source file can be created/determined.
-        RaiseNotImpl("GetPathName")
-
-    def GetFileName(self):
-        # Result is a string with just the name of the document, no path information.
-        RaiseNotImpl("GetFileName")
-
-    def NotifyChanged(self):
-        RaiseNotImpl("NotifyChanged")
-
-
-# Additional gateway related functions.
-
-
-class DebugDocumentTextConnectServer:
-    _public_methods_ = (
-        win32com.server.connect.IConnectionPointContainer_methods
-        + win32com.server.connect.IConnectionPoint_methods
-    )
-    _com_interfaces_ = [
-        pythoncom.IID_IConnectionPoint,
-        pythoncom.IID_IConnectionPointContainer,
-    ]
-
-    # IConnectionPoint interfaces
-    def __init__(self):
-        self.cookieNo = -1
-        self.connections = {}
-
-    def EnumConnections(self):
-        RaiseNotImpl("EnumConnections")
-
-    def GetConnectionInterface(self):
-        RaiseNotImpl("GetConnectionInterface")
-
-    def GetConnectionPointContainer(self):
-        return _wrap(self)
-
-    def Advise(self, pUnk):
-        # Creates a connection to the client.  Simply allocate a new cookie,
-        # find the clients interface, and store it in a dictionary.
-        interface = pUnk.QueryInterface(axdebug.IID_IDebugDocumentTextEvents, 1)
-        self.cookieNo = self.cookieNo + 1
-        self.connections[self.cookieNo] = interface
-        return self.cookieNo
-
-    def Unadvise(self, cookie):
-        # Destroy a connection - simply delete interface from the map.
-        try:
-            del self.connections[cookie]
-        except KeyError:
-            return Exception(scode=winerror.E_UNEXPECTED)
-
-    # IConnectionPointContainer interfaces
-    def EnumConnectionPoints(self):
-        RaiseNotImpl("EnumConnectionPoints")
-
-    def FindConnectionPoint(self, iid):
-        # Find a connection we support.  Only support the single event interface.
-        if iid == axdebug.IID_IDebugDocumentTextEvents:
-            return _wrap(self)
-        raise Exception(scode=winerror.E_NOINTERFACE)  # ??
-
-
-class RemoteDebugApplicationEvents:
-    _public_methods_ = [
-        "OnConnectDebugger",
-        "OnDisconnectDebugger",
-        "OnSetName",
-        "OnDebugOutput",
-        "OnClose",
-        "OnEnterBreakPoint",
-        "OnLeaveBreakPoint",
-        "OnCreateThread",
-        "OnDestroyThread",
-        "OnBreakFlagChange",
-    ]
-    _com_interfaces_ = [axdebug.IID_IRemoteDebugApplicationEvents]
-
-    def OnConnectDebugger(self, appDebugger):
-        """appDebugger -- a PyIApplicationDebugger"""
-        RaiseNotImpl("OnConnectDebugger")
-
-    def OnDisconnectDebugger(self):
-        RaiseNotImpl("OnDisconnectDebugger")
-
-    def OnSetName(self, name):
-        RaiseNotImpl("OnSetName")
-
-    def OnDebugOutput(self, string):
-        RaiseNotImpl("OnDebugOutput")
-
-    def OnClose(self):
-        RaiseNotImpl("OnClose")
-
-    def OnEnterBreakPoint(self, rdat):
-        """rdat -- PyIRemoteDebugApplicationThread"""
-        RaiseNotImpl("OnEnterBreakPoint")
-
-    def OnLeaveBreakPoint(self, rdat):
-        """rdat -- PyIRemoteDebugApplicationThread"""
-        RaiseNotImpl("OnLeaveBreakPoint")
-
-    def OnCreateThread(self, rdat):
-        """rdat -- PyIRemoteDebugApplicationThread"""
-        RaiseNotImpl("OnCreateThread")
-
-    def OnDestroyThread(self, rdat):
-        """rdat -- PyIRemoteDebugApplicationThread"""
-        RaiseNotImpl("OnDestroyThread")
-
-    def OnBreakFlagChange(self, abf, rdat):
-        """abf -- int - one of the axdebug.APPBREAKFLAGS constants
-        rdat -- PyIRemoteDebugApplicationThread
-        RaiseNotImpl("OnBreakFlagChange")
-        """
-
-
-class DebugExpressionContext:
-    _public_methods_ = ["ParseLanguageText", "GetLanguageInfo"]
-    _com_interfaces_ = [axdebug.IID_IDebugExpressionContext]
-
-    def __init__(self):
-        pass
-
-    def ParseLanguageText(self, code, radix, delim, flags):
-        """
-        result is IDebugExpression
-        """
-        RaiseNotImpl("ParseLanguageText")
-
-    def GetLanguageInfo(self):
-        """
-        result is (string langName, iid langId)
-        """
-        RaiseNotImpl("GetLanguageInfo")
-
-
-class DebugExpression:
-    _public_methods_ = [
-        "Start",
-        "Abort",
-        "QueryIsComplete",
-        "GetResultAsString",
-        "GetResultAsDebugProperty",
-    ]
-    _com_interfaces_ = [axdebug.IID_IDebugExpression]
-
-    def Start(self, callback):
-        """
-        callback -- an IDebugExpressionCallback
-
-        result - void
-        """
-        RaiseNotImpl("Start")
-
-    def Abort(self):
-        """
-        no params
-        result -- void
-        """
-        RaiseNotImpl("Abort")
-
-    def QueryIsComplete(self):
-        """
-        no params
-        result -- void
-        """
-        RaiseNotImpl("QueryIsComplete")
-
-    def GetResultAsString(self):
-        RaiseNotImpl("GetResultAsString")
-
-    def GetResultAsDebugProperty(self):
-        RaiseNotImpl("GetResultAsDebugProperty")
-
-
-class ProvideExpressionContexts:
-    _public_methods_ = ["EnumExpressionContexts"]
-    _com_interfaces_ = [axdebug.IID_IProvideExpressionContexts]
-
-    def EnumExpressionContexts(self):
-        RaiseNotImpl("EnumExpressionContexts")
diff --git a/lib/win32comext/axdebug/stackframe.py b/lib/win32comext/axdebug/stackframe.py
deleted file mode 100644
index edc3fe8c..00000000
--- a/lib/win32comext/axdebug/stackframe.py
+++ /dev/null
@@ -1,179 +0,0 @@
-"""Support for stack-frames.
-
-Provides Implements a nearly complete wrapper for a stack frame.
-"""
-
-import pythoncom
-from win32com.server.exception import COMException
-
-from . import axdebug, expressions, gateways
-from .util import RaiseNotImpl, _wrap, trace
-
-# def trace(*args):
-#       pass
-
-
-class EnumDebugStackFrames(gateways.EnumDebugStackFrames):
-    """A class that given a debugger object, can return an enumerator
-    of DebugStackFrame objects.
-    """
-
-    def __init__(self, debugger):
-        infos = []
-        frame = debugger.currentframe
-        #               print "Stack check"
-        while frame:
-            #                       print " Checking frame", frame.f_code.co_filename, frame.f_lineno-1, frame.f_trace,
-            # Get a DebugCodeContext for the stack frame.  If we fail, then it
-            # is not debuggable, and therefore not worth displaying.
-            cc = debugger.codeContainerProvider.FromFileName(frame.f_code.co_filename)
-            if cc is not None:
-                try:
-                    address = frame.f_locals["__axstack_address__"]
-                except KeyError:
-                    #                                       print "Couldnt find stack address for",frame.f_code.co_filename, frame.f_lineno-1
-                    # Use this one, even tho it is wrong :-(
-                    address = axdebug.GetStackAddress()
-                frameInfo = (
-                    DebugStackFrame(frame, frame.f_lineno - 1, cc),
-                    address,
-                    address + 1,
-                    0,
-                    None,
-                )
-                infos.append(frameInfo)
-            #                               print "- Kept!"
-            #                       else:
-            #                               print "- rejected"
-            frame = frame.f_back
-
-        gateways.EnumDebugStackFrames.__init__(self, infos, 0)
-
-    #       def __del__(self):
-    #               print "EnumDebugStackFrames dieing"
-
-    def Next(self, count):
-        return gateways.EnumDebugStackFrames.Next(self, count)
-
-    #       def _query_interface_(self, iid):
-    #               from win32com.util import IIDToInterfaceName
-    #               print "EnumDebugStackFrames QI with %s (%s)" % (IIDToInterfaceName(iid), str(iid))
-    #               return 0
-    def _wrap(self, obj):
-        # This enum returns a tuple, with 2 com objects in it.
-        obFrame, min, lim, fFinal, obFinal = obj
-        obFrame = _wrap(obFrame, axdebug.IID_IDebugStackFrame)
-        if obFinal:
-            obFinal = _wrap(obFinal, pythoncom.IID_IUnknown)
-        return obFrame, min, lim, fFinal, obFinal
-
-
-class DebugStackFrame(gateways.DebugStackFrame):
-    def __init__(self, frame, lineno, codeContainer):
-        self.frame = frame
-        self.lineno = lineno
-        self.codeContainer = codeContainer
-        self.expressionContext = None
-
-    #       def __del__(self):
-    #               print "DSF dieing"
-    def _query_interface_(self, iid):
-        if iid == axdebug.IID_IDebugExpressionContext:
-            if self.expressionContext is None:
-                self.expressionContext = _wrap(
-                    expressions.ExpressionContext(self.frame),
-                    axdebug.IID_IDebugExpressionContext,
-                )
-            return self.expressionContext
-        #               from win32com.util import IIDToInterfaceName
-        #               print "DebugStackFrame QI with %s (%s)" % (IIDToInterfaceName(iid), str(iid))
-        return 0
-
-    #
-    # The following need implementation
-    def GetThread(self):
-        """Returns the thread associated with this stack frame.
-
-        Result must be a IDebugApplicationThread
-        """
-        RaiseNotImpl("GetThread")
-
-    def GetCodeContext(self):
-        offset = self.codeContainer.GetPositionOfLine(self.lineno)
-        return self.codeContainer.GetCodeContextAtPosition(offset)
-
-    #
-    # The following are usefully implemented
-    def GetDescriptionString(self, fLong):
-        filename = self.frame.f_code.co_filename
-        s = ""
-        if 0:  # fLong:
-            s = s + filename
-        if self.frame.f_code.co_name:
-            s = s + self.frame.f_code.co_name
-        else:
-            s = s + "<lambda>"
-        return s
-
-    def GetLanguageString(self, fLong):
-        if fLong:
-            return "Python ActiveX Scripting Engine"
-        else:
-            return "Python"
-
-    def GetDebugProperty(self):
-        return _wrap(StackFrameDebugProperty(self.frame), axdebug.IID_IDebugProperty)
-
-
-class DebugStackFrameSniffer:
-    _public_methods_ = ["EnumStackFrames"]
-    _com_interfaces_ = [axdebug.IID_IDebugStackFrameSniffer]
-
-    def __init__(self, debugger):
-        self.debugger = debugger
-        trace("DebugStackFrameSniffer instantiated")
-
-    #       def __del__(self):
-    #               print "DSFS dieing"
-    def EnumStackFrames(self):
-        trace("DebugStackFrameSniffer.EnumStackFrames called")
-        return _wrap(
-            EnumDebugStackFrames(self.debugger), axdebug.IID_IEnumDebugStackFrames
-        )
-
-
-# A DebugProperty for a stack frame.
-class StackFrameDebugProperty:
-    _com_interfaces_ = [axdebug.IID_IDebugProperty]
-    _public_methods_ = [
-        "GetPropertyInfo",
-        "GetExtendedInfo",
-        "SetValueAsString",
-        "EnumMembers",
-        "GetParent",
-    ]
-
-    def __init__(self, frame):
-        self.frame = frame
-
-    def GetPropertyInfo(self, dwFieldSpec, nRadix):
-        RaiseNotImpl("StackFrameDebugProperty::GetPropertyInfo")
-
-    def GetExtendedInfo(self):  ### Note - not in the framework.
-        RaiseNotImpl("StackFrameDebugProperty::GetExtendedInfo")
-
-    def SetValueAsString(self, value, radix):
-        #
-        RaiseNotImpl("DebugProperty::SetValueAsString")
-
-    def EnumMembers(self, dwFieldSpec, nRadix, iid):
-        print("EnumMembers", dwFieldSpec, nRadix, iid)
-        from . import expressions
-
-        return expressions.MakeEnumDebugProperty(
-            self.frame.f_locals, dwFieldSpec, nRadix, iid, self.frame
-        )
-
-    def GetParent(self):
-        # return IDebugProperty
-        RaiseNotImpl("DebugProperty::GetParent")
diff --git a/lib/win32comext/axdebug/util.py b/lib/win32comext/axdebug/util.py
deleted file mode 100644
index c3d4f733..00000000
--- a/lib/win32comext/axdebug/util.py
+++ /dev/null
@@ -1,141 +0,0 @@
-# Utility function for wrapping objects.  Centralising allows me to turn
-# debugging on and off for the entire package in a single spot.
-
-import os
-import sys
-
-import win32api
-import win32com.server.util
-import winerror
-from win32com.server.exception import Exception
-
-try:
-    os.environ["DEBUG_AXDEBUG"]
-    debugging = 1
-except KeyError:
-    debugging = 0
-
-
-def trace(*args):
-    if not debugging:
-        return
-    print(str(win32api.GetCurrentThreadId()) + ":", end=" ")
-    for arg in args:
-        print(arg, end=" ")
-    print()
-
-
-# The AXDebugging implementation assumes that the returned COM pointers are in
-# some cases identical.  Eg, from a C++ perspective:
-# p->GetSomeInterface( &p1 );
-# p->GetSomeInterface( &p2 );
-# p1==p2
-# By default, this is _not_ true for Python.
-# (Now this is only true for Document objects, and Python
-# now does ensure this.
-
-all_wrapped = {}
-
-
-def _wrap_nodebug(object, iid):
-    return win32com.server.util.wrap(object, iid)
-
-
-def _wrap_debug(object, iid):
-    import win32com.server.policy
-
-    dispatcher = win32com.server.policy.DispatcherWin32trace
-    return win32com.server.util.wrap(object, iid, useDispatcher=dispatcher)
-
-
-if debugging:
-    _wrap = _wrap_debug
-else:
-    _wrap = _wrap_nodebug
-
-
-def _wrap_remove(object, iid=None):
-    # Old - no longer used or necessary!
-    return
-
-
-def _dump_wrapped():
-    from win32com.server.util import unwrap
-
-    print("Wrapped items:")
-    for key, items in all_wrapped.items():
-        print(key, end=" ")
-        try:
-            ob = unwrap(key)
-            print(ob, sys.getrefcount(ob))
-        except:
-            print("<error>")
-
-
-def RaiseNotImpl(who=None):
-    if who is not None:
-        print("********* Function %s Raising E_NOTIMPL  ************" % (who))
-
-    # Print a sort-of "traceback", dumping all the frames leading to here.
-    try:
-        1 / 0
-    except:
-        frame = sys.exc_info()[2].tb_frame
-    while frame:
-        print("File: %s, Line: %d" % (frame.f_code.co_filename, frame.f_lineno))
-        frame = frame.f_back
-
-    # and raise the exception for COM
-    raise Exception(scode=winerror.E_NOTIMPL)
-
-
-import win32com.server.policy
-
-
-class Dispatcher(win32com.server.policy.DispatcherWin32trace):
-    def __init__(self, policyClass, object):
-        win32com.server.policy.DispatcherTrace.__init__(self, policyClass, object)
-        import win32traceutil  # Sets up everything.
-
-    #               print "Object with win32trace dispatcher created (object=%s)" % `object`
-
-    def _QueryInterface_(self, iid):
-        rc = win32com.server.policy.DispatcherBase._QueryInterface_(self, iid)
-        #               if not rc:
-        #                       self._trace_("in _QueryInterface_ with unsupported IID %s (%s)\n" % (IIDToInterfaceName(iid),iid))
-        return rc
-
-    def _Invoke_(self, dispid, lcid, wFlags, args):
-        print(
-            "In Invoke with",
-            dispid,
-            lcid,
-            wFlags,
-            args,
-            "with object",
-            self.policy._obj_,
-        )
-        try:
-            rc = win32com.server.policy.DispatcherBase._Invoke_(
-                self, dispid, lcid, wFlags, args
-            )
-            #                       print "Invoke of", dispid, "returning", rc
-            return rc
-        except Exception:
-            t, v, tb = sys.exc_info()
-            tb = None  # A cycle
-            scode = v.scode
-            try:
-                desc = " (" + str(v.description) + ")"
-            except AttributeError:
-                desc = ""
-            print(
-                "*** Invoke of %s raised COM exception 0x%x%s" % (dispid, scode, desc)
-            )
-        except:
-            print("*** Invoke of %s failed:" % dispid)
-            typ, val, tb = sys.exc_info()
-            import traceback
-
-            traceback.print_exception(typ, val, tb)
-            raise
diff --git a/lib/win32comext/axscript/Demos/client/asp/CreateObject.asp b/lib/win32comext/axscript/Demos/client/asp/CreateObject.asp
deleted file mode 100644
index 5338c0a0..00000000
--- a/lib/win32comext/axscript/Demos/client/asp/CreateObject.asp
+++ /dev/null
@@ -1,19 +0,0 @@
-<HTML>
-
-<SCRIPT Language="Python" RUNAT=Server>
-
-# Just for the sake of the demo, our Python script engine
-# will create a Python.Interpreter COM object, and call that.
-
-# This is completely useless, as the Python Script Engine is
-# completely normal Python, and ASP does not impose retrictions, so
-# there is nothing the COM object can do that we can not do natively.
-
-o = Server.CreateObject("Python.Interpreter")
-
-Response.Write("Python says 1+1=" + str(o.Eval("1+1")))
-
-</SCRIPT>
-
-</HTML>
-
diff --git a/lib/win32comext/axscript/Demos/client/asp/caps.asp b/lib/win32comext/axscript/Demos/client/asp/caps.asp
deleted file mode 100644
index 6b0342aa..00000000
--- a/lib/win32comext/axscript/Demos/client/asp/caps.asp
+++ /dev/null
@@ -1,52 +0,0 @@
-<%@ Language=Python %>
-<HTML>
-
-<HEAD>
-
-<BODY BACKGROUND="/samples/images/backgrnd.gif">
-
-<TITLE>Python test</TITLE>
-
-</HEAD>
-
-<BODY BGCOLOR="FFFFFF">
-
-<SCRIPT Language="Python" RUNAT=Server>
-# NOTE that the <% tags below execute _before_ these tags!
-Response.Write("Hello from Python<P>")
-Response.Write("Browser is "+bc.browser)
-import win32api # Should be no problem using win32api in ASP pages.
-Response.Write("<p>Win32 username is "+win32api.GetUserName())
-</SCRIPT>
-
-<BODY BGCOLOR="FFFFFF">
-
-<% 
-import sys
-print sys.path
-from win32com.axscript.asputil import *
-print "Hello"
-print "There"
-print "How are you"
-%>
-
-<%bc = Server.CreateObject("MSWC.BrowserType")%>
-<BODY BGCOLOR="FFFFFF">
-<table border=1> 
-<tr><td>Browser</td><td> <%=bc.browser %> 
-<tr><td>Version</td><td> <%=bc.version %> </td></TR> 
-<tr><td>Frames</td><td> 
-<%Response.Write( iif(bc.frames, "TRUE", "FALSE")) %></td></TR> 
-<tr><td>Tables</td><td> 
-<%Response.Write( iif (bc.tables, "TRUE", "FALSE")) %></td></TR> 
-<tr><td>BackgroundSounds</td><td> 
-<%Response.Write( iif(bc.BackgroundSounds, "TRUE", "FALSE"))%></td></TR> 
-<tr><td>VBScript</td><td> 
-<%Response.Write( iif(bc.vbscript, "TRUE", "FALSE"))%></td></TR> 
-<tr><td>JavaScript</td><td> 
-<%Response.Write( iif(bc.javascript, "TRUE", "FALSE"))%></td></TR> 
-
-</table> 
-
-</body>
-</html>
diff --git a/lib/win32comext/axscript/Demos/client/asp/interrupt/test.asp b/lib/win32comext/axscript/Demos/client/asp/interrupt/test.asp
deleted file mode 100644
index ee77703f..00000000
--- a/lib/win32comext/axscript/Demos/client/asp/interrupt/test.asp
+++ /dev/null
@@ -1,4 +0,0 @@
-<%@ language=python%>
-<html>
-<%Response.Redirect("test1.html")%>
-</html>
diff --git a/lib/win32comext/axscript/Demos/client/asp/interrupt/test.html b/lib/win32comext/axscript/Demos/client/asp/interrupt/test.html
deleted file mode 100644
index 0b7f0559..00000000
--- a/lib/win32comext/axscript/Demos/client/asp/interrupt/test.html
+++ /dev/null
@@ -1,10 +0,0 @@
-<html>
-<head>
-<body>
-GOT There
-<script language=javascript>
-location.href ="http://192.168.0.1/Python/interrupt/test.asp"
-</script>
-</body>
-</head>
-</html>
diff --git a/lib/win32comext/axscript/Demos/client/asp/interrupt/test1.asp b/lib/win32comext/axscript/Demos/client/asp/interrupt/test1.asp
deleted file mode 100644
index a936dd99..00000000
--- a/lib/win32comext/axscript/Demos/client/asp/interrupt/test1.asp
+++ /dev/null
@@ -1,6 +0,0 @@
-<%@ language =Python%>
-<html>
-<head>
-<%Response.Redirect("test.html")%>
-</head>
-</html>
diff --git a/lib/win32comext/axscript/Demos/client/asp/interrupt/test1.html b/lib/win32comext/axscript/Demos/client/asp/interrupt/test1.html
deleted file mode 100644
index 6f1d9b2f..00000000
--- a/lib/win32comext/axscript/Demos/client/asp/interrupt/test1.html
+++ /dev/null
@@ -1,11 +0,0 @@
-<html>
-<head>
-<body>
-GOT HERE
-<script language=javascript>
-location.href ="http://192.168.0.1/Python/interrupt/test1.asp"
-</script>
-</body>
-</head>
-</html>
-
diff --git a/lib/win32comext/axscript/Demos/client/asp/tut1.asp b/lib/win32comext/axscript/Demos/client/asp/tut1.asp
deleted file mode 100644
index dcbb047c..00000000
--- a/lib/win32comext/axscript/Demos/client/asp/tut1.asp
+++ /dev/null
@@ -1,11 +0,0 @@
-<HTML>
-
-<SCRIPT Language="Python" RUNAT=Server>
-
-for i in range(3,8):
-  Response.Write("<FONT SIZE=%d>Hello World!!<BR>" % i)
-
-</SCRIPT>
-
-</HTML>
-
diff --git a/lib/win32comext/axscript/Demos/client/ie/MarqueeText1.htm b/lib/win32comext/axscript/Demos/client/ie/MarqueeText1.htm
deleted file mode 100644
index 85a676f8..00000000
--- a/lib/win32comext/axscript/Demos/client/ie/MarqueeText1.htm
+++ /dev/null
@@ -1,25 +0,0 @@
-<HTML>
-<HEAD>
-<base target="text">
-<TITLE> Internet Workshop </TITLE>
-</HEAD>
-<BODY leftmargin=8 bgcolor="#FFFFFF" VLINK="#666666" LINK="#FF0000">
-<FONT FACE="ARIAL,HELVETICA" SIZE="2">
-
-<P>
-<BR>
-<P><FONT FACE="ARIAL,HELVETICA" SIZE="5"><B>Python AX Script Engine</B></FONT>
-<BR>Demo using the Marquee Control
-<BR>Mark Hammond.
-
-<P>This is really quite a boring demo, as the Marquee control does everything.  However, there is Python code behind the buttons that change the speed.  This code is all of 2 lines per button!!!
-
-<P>For more information on Python as an ActiveX scripting language, see
-
-<P><B>Python</B>
-<BR><A HREF="http://www.python.org">http://www.python.org</A>
-
-</FONT>
-</BODY>
-</HTML>
-
diff --git a/lib/win32comext/axscript/Demos/client/ie/calc.htm b/lib/win32comext/axscript/Demos/client/ie/calc.htm
deleted file mode 100644
index 7c7fb48d..00000000
--- a/lib/win32comext/axscript/Demos/client/ie/calc.htm
+++ /dev/null
@@ -1,116 +0,0 @@
-<HTML>
-<HEAD><TITLE>Python Script sample:  Calculator</TITLE></HEAD>
-<BODY><FONT FACE=ARIAL SIZE=3> <!-- global default -->
-<SCRIPT LANGUAGE="Python">
-# globals
-Accum = 0.0	  # Previous number (operand) awaiting operation
-FlagNewNum = 1    # Flag to indicate a new number (operand) is being entered
-NullOp = lambda x,y: y
-PendingOp = NullOp# Pending operation waiting for completion of second operand
-numberButNames = ['Zero','One','Two','Three','Four','Five','Six','Seven','Eight','Nine']
-
-def NumPressed(Num):
-	print "NumPressed", Num
-	global FlagNewNum
-	if FlagNewNum:
-		ax.document.Keypad.ReadOut.Value = Num
-		FlagNewNum = None
-	else:
-		if ax.document.Keypad.ReadOut.Value == "0":
-			ax.document.Keypad.ReadOut.Value = str(Num)
-		else:
-			ax.document.Keypad.ReadOut.Value= ax.document.Keypad.ReadOut.Value + str(Num)
-
-# Dynamically create handlers for all the decimal buttons.
-# (ie, this will dynamically create "One_OnClick()"... etc handlers
-for i in range(len(numberButNames)):
-	exec "def %s_OnClick():\tNumPressed(%d)\n" % (numberButNames[i],i)
-
-def Decimal_OnClick():
-	global curReadOut, FlagNewNum
-	curReadOut = ax.document.Keypad.ReadOut.Value
-	if FlagNewNum:
-		curReadOut = "0."
-		FlagNewNum = None
-	else:
-		if not ("." in curReadOut):
-			curReadOut = curReadOut + "."
-	ax.document.Keypad.ReadOut.Value = curReadOut
-
-import sys, string
-
-def Operation(Op, fn):
-	global FlagNewNum, PendingOp, Accum
-	ReadOut = ax.document.Keypad.ReadOut.Value
-	print "Operation", Op, ReadOut, PendingOp, Accum
-	if FlagNewNum:
-		# User is hitting op keys repeatedly, so don't do anything
-		PendingOp = NullOp
-	else:
-		FlagNewNum = 1
-		Accum = PendingOp( Accum, string.atof(ReadOut) )
-	ax.document.Keypad.ReadOut.Value = str(Accum)
-	PendingOp = fn
-
-def ClearEntry_OnClick():
-	# Remove current number and reset state
-	global FlagNewNum
-	ax.document.Keypad.ReadOut.Value = "0"
-	FlagNewNum = 1
-
-def Clear_OnClick():
-	global Accum, PendingOp
-	Accum = 0
-	PendingOp = NullOp
-	ClearEntry_OnClick()
-
-def Neg_OnClick():
-	ax.document.Keypad.ReadOut.Value = str(-string.atof(ax.document.Keypad.ReadOut.Value))
-</SCRIPT>
-
-
-<form action="" Name="Keypad">
-<TABLE>
-<B>
-<TABLE BORDER=2 WIDTH=50 HEIGHT=60 CELLPADDING=1 CELLSPACING=5>
-<CAPTION ALIGN=top> <b>Calculator</b><p> </CAPTION>
-<TR>
- <TD COLSPAN=3 ALIGN=MIDDLE><INPUT NAME="ReadOut" TYPE="Text" SIZE=24 VALUE="0" WIDTH=100%></TD>
- <TD></TD>
- <TD><INPUT NAME="Clear" TYPE="Button" VALUE="  C  " ></TD>
- <TD><INPUT NAME="ClearEntry" TYPE="Button" VALUE="  CE " ></TD>
-</TR>
-<TR>
- <TD><INPUT NAME="Seven" TYPE="Button" VALUE="  7  " ></TD>
- <TD><INPUT NAME="Eight" TYPE="Button" VALUE="  8  " ></TD>
- <TD><INPUT NAME="Nine" TYPE="Button" VALUE="  9  " ></TD>
- <TD></TD>
- <TD><INPUT NAME="Neg" TYPE="Button" VALUE=" +/- " ></TD>
- <TD><INPUT NAME="Percent" TYPE="Button" VALUE="  % " OnClick="Operation('%', lambda x,y: x*y/100.0)"></TD>
-</TR>
-
-<TR>
- <TD><INPUT NAME="Four" TYPE="Button" VALUE="  4  " ></TD>
- <TD><INPUT NAME="Five" TYPE="Button" VALUE="  5  " ></TD>
- <TD><INPUT NAME="Six" TYPE="Button" VALUE="  6  " ></TD>
- <TD></TD>
- <TD ALIGN=MIDDLE><INPUT NAME="Plus" TYPE="Button" VALUE="  +  " OnClick="Operation('+', lambda x,y: x+y)"></TD>
- <TD ALIGN=MIDDLE><INPUT NAME="Minus" TYPE="Button" VALUE="   -   " OnClick="Operation('-', lambda x,y: x-y)"></TD>
-</TR>
-<TR>
- <TD><INPUT NAME="One" TYPE="Button" VALUE="  1  " ></TD>
- <TD><INPUT NAME="Two" TYPE="Button" VALUE="  2  " ></TD>
- <TD><INPUT NAME="Three" TYPE="Button" VALUE="  3  " ></TD>
- <TD></TD>
- <TD ALIGN=MIDDLE><INPUT NAME="Multiply" TYPE="Button" VALUE="  *  " OnClick="Operation('*', lambda x,y: x*y)" ></TD>
- <TD ALIGN=MIDDLE><INPUT NAME="Divide" TYPE="Button" VALUE="   /   " OnClick="Operation('/', lambda x,y: x/y)" ></TD>
-</TR>
-<TR>
- <TD><INPUT NAME="Zero" TYPE="Button" VALUE="  0  " ></TD>
- <TD><INPUT NAME="Decimal" TYPE="Button" VALUE="   .  " ></TD>
- <TD COLSPAN=3></TD>
- <TD><INPUT NAME="Equals" TYPE="Button" VALUE="  =  " OnClick="Operation('=', lambda x,y: x)"></TD>
-</TR></TABLE></TABLE></B>
-</FORM>
-</FONT></BODY></HTML>
-
diff --git a/lib/win32comext/axscript/Demos/client/ie/dbgtest.htm b/lib/win32comext/axscript/Demos/client/ie/dbgtest.htm
deleted file mode 100644
index 7ee9468d..00000000
--- a/lib/win32comext/axscript/Demos/client/ie/dbgtest.htm
+++ /dev/null
@@ -1,16 +0,0 @@
-<HTML>
-<BODY>
-
-<SCRIPT>
-b="Hello There, how are you"
-</SCRIPT>
-
-<SCRIPT LANGUAGE="Python">
-print "Hello"
-a="Hi there"
-document.write("Hello<P>")
-alert("Hi there")
-</SCRIPT>
-
-</BODY>
-</HTML>
diff --git a/lib/win32comext/axscript/Demos/client/ie/demo.htm b/lib/win32comext/axscript/Demos/client/ie/demo.htm
deleted file mode 100644
index a828bac2..00000000
--- a/lib/win32comext/axscript/Demos/client/ie/demo.htm
+++ /dev/null
@@ -1,26 +0,0 @@
-<HTML>
-<HEAD>
-<TITLE>Python AXScript Demos</TITLE>
-</HEAD>
-
-
-<SCRIPT LANGUAGE="Python">
-def Window_OnLoad():
-	pass
-#	import win32traceutil
-#	print "Frames are", ax.window.frames._print_details_()
-#	print "Frame 0 href = ", ax.frames.Item(0).location.href
-
-def Name_OnLoad():
-	print "Frame loading"
-
-</SCRIPT>
-
-<FRAMESET FRAMEBORDER=1 COLS = "250, *">
-	<FRAME SRC="demo_menu.htm">
-	<FRAME SRC="demo_check.htm" NAME="Body">
-</FRAMESET>
-
-
-</HTML>
-
diff --git a/lib/win32comext/axscript/Demos/client/ie/demo_check.htm b/lib/win32comext/axscript/Demos/client/ie/demo_check.htm
deleted file mode 100644
index f0e09f9d..00000000
--- a/lib/win32comext/axscript/Demos/client/ie/demo_check.htm
+++ /dev/null
@@ -1,42 +0,0 @@
-<HTML>
-<H1>Engine Registration</H1>
-
-<BODY>
-
-<p>The Python ActiveX Scripting Engine is not currently registered.<p>
-
-<p>Due to a <a href="http://starship.python.net/crew/mhammond/win32/PrivacyProblem.html">privacy
-concern</a> discovered in the engine, the use of Python inside IE has been disabled.</p>
-
-Before any of the supplied demos will work, the engine must be successfully registered.
-
-<P>To install a version of the engine, that does work with IE, you can execute the Python program 
-<CODE>win32com\axscript\client\pyscript_rexec.py</CODE> must be run.  You can either do this manually, or follow the instructions below.</p>
-
-<H2>Register the engine now!</H2>
-
-<p>If you have read about the <a href="http://starship.python.net/crew/mhammond/win32/PrivacyProblem.html">privacy
-concern</a> and still wish to register the engine, just follow the process outlined below:</p>
-<OL>
-  <LI>Click on the link below
-  <LI><B>A dialog will be presented asking if the file should be opened or saved to disk.  Select "Open it".</B>
-  <LI>A Console program will briefly open, while the server is registered.
-</OL>
-
-<P><A HREF="..\..\..\client\pyscript_rexec.py">Register the engine now</A>
-
-<H2>Checking the registration</H2>
-After the registration is complete, simply hit the Reload button.  If the 
-registration was successful, the page will change to the Python/AvtiveX Demo Page.
-
-
-<SCRIPT LANGUAGE="Python">
-try:
-	window.open("demo_intro.htm", "Body")
-except:
-	history.back()
-</SCRIPT>
-</BODY></HTML>
-
-
-
diff --git a/lib/win32comext/axscript/Demos/client/ie/demo_intro.htm b/lib/win32comext/axscript/Demos/client/ie/demo_intro.htm
deleted file mode 100644
index b8c811d8..00000000
--- a/lib/win32comext/axscript/Demos/client/ie/demo_intro.htm
+++ /dev/null
@@ -1,38 +0,0 @@
-<HTML>
-<BODY>
-
-<H1>
-  <MARQUEE NAME="Marquee1" DIRECTION=LEFT BEHAVIOR=SCROLL SCROLLAMOUNT=10 SCROLLDELAY=200
-  >Python ActiveX Scripting Demonstation
-  </MARQUEE> 
-</H1>
-
-<p>Congratulations on installing the Python ActiveX Scripting Engine</p>
-
-<p>Be warned that there is a <a href="http://starship.python.net/crew/mhammond/win32/PrivacyProblem.html">privacy
-concern</a> with this engine.  Please read this information, including how to disable the feature.</p>
-
-
-<H3>Object model</H3>
-<P>Except as described below, the object module exposed should be similar to that exposed
-by Visual Basic, etc.  Due to the nature of ActiveX Scripting, the details for each
-host are different, but Python should work "correctly".
-
-<P>The object model exposed via Python for MSIE is not as seamless as VB.  The biggest limitation is 
-the concept of a "local" namespace.  For example, in VB, you can
-code <code>text="Hi there"</code>, but in Python, you must code 
-<code>MyForm.ThisButton.Text="Hi There"</code>.  See the <A HREF="foo2.htm">foo2</A> sample 
-for futher details.
-
-<H3>Known bugs and problems</H3>
-<UL>
-<LI><P>This release seems to have broken Aaron's mouse-trace sample.  No idea why, and Im supposed to be looking into it.
-<LI><P>Builtin objects such as MARQUEE are giving me grief.  Objects accessed via forms are generally
-no problem.
-<LI><P>If you are trying to use Python with the Windows Scripting Host, note that
-.pys files are not correct registered - you will need to explicitely
-specify either cscript.exe or wscript.exe on the command line.
-</UL>
-
-</BODY></HTML>
-
diff --git a/lib/win32comext/axscript/Demos/client/ie/demo_menu.htm b/lib/win32comext/axscript/Demos/client/ie/demo_menu.htm
deleted file mode 100644
index ba23a434..00000000
--- a/lib/win32comext/axscript/Demos/client/ie/demo_menu.htm
+++ /dev/null
@@ -1,16 +0,0 @@
-<HTML>
-<BODY>
-<H1>Scripting Demos</H1>
-<P>An <A HREF="demo_check.htm" TARGET=Body>Introduction</A> to the 
-scripting engine.
-
-<P>The <A HREF="calc.htm" TARGET=Body>Calculator Demo</A> is a very 
-cool sample written by Aaron Watters.
-
-<P><A HREF="mouseTrack.htm" TARGET=Body>Mouse track</A> is another of 
-Aaron's samples, and shows how fast the Python engine is!
-
-<P>The <A HREF="foo2.htm" TARGET=Body>foo2 sample</A> is mainly used 
-for debugging and testing, but does show some forms in action.
-
-
diff --git a/lib/win32comext/axscript/Demos/client/ie/docwrite.htm b/lib/win32comext/axscript/Demos/client/ie/docwrite.htm
deleted file mode 100644
index c95b7902..00000000
--- a/lib/win32comext/axscript/Demos/client/ie/docwrite.htm
+++ /dev/null
@@ -1,25 +0,0 @@
-<HTML>
-<BODY>
-A page generated by Python
-
-<SCRIPT LANGUAGE="XXXVBScript">
-document.open()
-document.writeLn "<P>Hello from VBScript"
-document.close()
-</SCRIPT>
-
-<SCRIPT LANGUAGE="Python">
-ax.document.write("<P>Hello from Python")
-ax.document.close()
-ax.document.open()
-ax.document.write("<P>Hello again from Python")
-ax.document.close()
-
-def Window_OnLoad():
-	pass
-#	ax.document.write("<P>Hello from Load from Python")
-#	ax.document.close()
-</SCRIPT>
-
-</BODY>
-</HTML>
diff --git a/lib/win32comext/axscript/Demos/client/ie/foo2.htm b/lib/win32comext/axscript/Demos/client/ie/foo2.htm
deleted file mode 100644
index d5e0c4a6..00000000
--- a/lib/win32comext/axscript/Demos/client/ie/foo2.htm
+++ /dev/null
@@ -1,105 +0,0 @@
-<HTML>
-<BODY>
-
-<SCRIPT>
-b="Hello"
-</SCRIPT>
-
-<SCRIPT LANGUAGE="Python">
-import win32traceutil
-import sys
-print "Hello"
-a="Hi there"
-print "Location is", document.location
-document.write("Hello", " from version ", 2, " of the Python AXScript Engine","<P>")
-document.writeln("This is Python", sys.version)
-
-</SCRIPT>
-
-<P>The caption on the first button is set by the Window Load code.  Clicking
-that button changes the text in the first edit box.
-
-<P>The second button changes its own text when clicked.
-
-<P>The fourth button calls a global function, defined in the global 'script' scope,
-rather than the 'MyForm' scope.
-
-<FORM NAME="MyForm" METHOD="GET">
-   <SCRIPT LANGUAGE="Python">
-print "Hello from in the form"
-   </SCRIPT>
-   <INPUT NAME="Button1" TYPE="Button" OnClick="MyForm.Text1.value='Hi'" LANGUAGE="Python">
-   <INPUT TYPE="TEXT" SIZE=25 NAME="Text1">
-   <INPUT NAME="Button2" TYPE="Button" VALUE="Click for 'Hi'" OnClick="a='Howdy'; MyForm.Button2.value='Hi'" LANGUAGE="Python">
-   <INPUT NAME="Button3" TYPE="Button" VALUE="Click for URL" OnClick="MyForm.Text2.value=document.location" LANGUAGE="Python">
-   <INPUT TYPE="TEXT" SIZE=25 NAME="Text2">
-   <INPUT NAME="Button4" TYPE="Button" VALUE="Call global fn" OnClick="foo1()" LANGUAGE="Python">
-   <INPUT NAME="Button5" TYPE="Button" VALUE="Script for... Test">
-<script for="Button5" event="onClick" language="Python">
-print "HelloThere";
-window.alert("Hello")
-def ATest():
-	print "Hello from ATEst"
-
-ATest()
-</script>
-   <INPUT NAME="Button6" TYPE="Button" VALUE="Set Other" OnClick="Form2.Text1.Value='Hi from other'" LANGUAGE="Python">
-
-</FORM><BR>
-<P>
-And here is a second form
-<P>
-<FORM NAME="Form2" METHOD="GET">
-   <INPUT NAME="Button1" TYPE="Button" OnClick="Form2.Text1.Value='Hi'" LANGUAGE="Python">
-   <INPUT NAME="Button2" TYPE="Button" VALUE="Set Other" OnClick="MyForm.Text1.Value='Hi from other'" LANGUAGE="Python">
-   <INPUT TYPE="TEXT" SIZE=25 NAME="Text1">
-   <INPUT NAME="ButRExec" TYPE="Button" VALUE="RExec fail" OnClick="import win32api;win32api.MessageBox(0,'Oops')" LANGUAGE="Python">
-   <INPUT NAME="ButRExec2" TYPE="Button" VALUE="RExec fail 2" OnClick="import sys,win32traceutil;print sys.modules;from win32com.client import dynamic;import win32com.client.dynamic, pythoncom, win32com.client;o=win32com.client.Dispatch('Word.Application')" LANGUAGE="Python">
-   <INPUT NAME="ButVB" TYPE="Button" VALUE="VBScript Button" OnClick='alert("Hi from VBScript")'>
-   <INPUT NAME="ButCallChain" TYPE="Button" VALUE="Multi-Language call" OnClick='CallPython()'>
-</FORM><BR>
-
-<SCRIPT LANGUAGE="VBScript">
-function CallPython()
-	alert("Hello from VB - Im about to call Python!")
-	PythonGlobalFunction()
-end function
-</SCRIPT>
-
-<SCRIPT LANGUAGE="JScript">
-function JScriptFunction()
-{
-  alert("Hello from JScript");
-}
-</SCRIPT>
-
-<SCRIPT LANGUAGE="Python">
-x=13
-
-def foo1():
-   y = 14
-   for name, item in globals().items():
-        print name, `item`
-   alert ("Hello from AXCode")
-   print "Y is ",y
-
-def PythonGlobalFunction():
-	window.alert("Hello from Python - Im about to call JScript!")
-	window.JScriptFunction()
-
-def Window_OnLoad():
-	print "X is", x
-	print "a is", a
-#	print "------ GLOBALS ----------"
-#	for n,v in globals().items():
-#		print n,'=',v
-	print "MyForm is", MyForm
-	print "MyForm is repr", `MyForm`
-	print "MyForm.Button1 is", `MyForm.Button1`
-	MyForm.Button1.Value = "Python Rules!"
-	Form2.Button1.value = "Form2!"
-	MyForm.Text1.value = document.location
-</SCRIPT>
-
-</BODY>
-</HTML>
diff --git a/lib/win32comext/axscript/Demos/client/ie/form.htm b/lib/win32comext/axscript/Demos/client/ie/form.htm
deleted file mode 100644
index 97a239f3..00000000
--- a/lib/win32comext/axscript/Demos/client/ie/form.htm
+++ /dev/null
@@ -1,25 +0,0 @@
-<HTML>
-<BODY>
-
-<FORM NAME="TestForm" METHOD="POST" >
-   <INPUT TYPE="TEXT" SIZE=25 NAME="Name">Name<br>
-   <INPUT TYPE="TEXT" SIZE=25 NAME="Address">Address<br>
-   <INPUT TYPE=SUBMIT
-</FORM>
-
-<SCRIPT LANGUAGE="Python" for="TestForm" Event="onSubmit">
-return Validate()
-</SCRIPT>
-
-<SCRIPT LANGUAGE="Python">
-
-def Validate():
-	if not TestForm.Name.Value or not TestForm.Address.Value:
-		ax.alert("You must enter a name and address.")
-		return 1
-	return 0
-
-</SCRIPT>
-
-</BODY>
-</HTML>
diff --git a/lib/win32comext/axscript/Demos/client/ie/marqueeDemo.htm b/lib/win32comext/axscript/Demos/client/ie/marqueeDemo.htm
deleted file mode 100644
index 33847c1d..00000000
--- a/lib/win32comext/axscript/Demos/client/ie/marqueeDemo.htm
+++ /dev/null
@@ -1,60 +0,0 @@
-<HTML>
-<HEAD>
-<base target="text">
-<TITLE> Internet Workshop </TITLE>
-</HEAD>
-<BODY leftmargin=8 bgcolor="#FFFFFF" VLINK="#666666" LINK="#FF0000">
-<FONT FACE="ARIAL,HELVETICA" SIZE="2">
-
-<P>
-<BR>
-<P><FONT FACE="ARIAL,HELVETICA" SIZE="5"><B>Marquee Demo</B></FONT>
-
-<P>
-
-
-<OBJECT 
-	ID="Marquee1" 
- 	CLASSID="CLSID:1A4DA620-6217-11CF-BE62-0080C72EDD2D"
-	CODEBASE="/workshop/activex/gallery/ms/marquee/other/marquee.ocx#Version=4,70,0,1112"
-	TYPE="application/x-oleobject"
-	WIDTH=100% 
-	HEIGHT=80
->
-	<PARAM NAME="szURL" VALUE="marqueeText1.htm">
-	<PARAM NAME="ScrollPixelsX" VALUE="0">
-    	<PARAM NAME="ScrollPixelsY" VALUE="-5">
-    	<PARAM NAME="ScrollDelay" VALUE="100">
-    	<PARAM NAME="Whitespace" VALUE="0">
-</OBJECT>
-
-<br> <br>
-
-<INPUT TYPE="Button" NAME="btnFaster" VALUE="Faster">
-<INPUT TYPE="Button" NAME="btnNormal" VALUE="Normal">
-<INPUT TYPE="Button" NAME="btnSlower" VALUE="Slower">
-
-<SCRIPT Language="Python">
-
-def btnFaster_Onclick():
-	ax.Marquee1.ScrollDelay = 0
-
-def btnNormal_Onclick():
-	ax.Marquee1.ScrollDelay = 50
-
-def btnSlower_Onclick():
-	ax.Marquee1.ScrollDelay = 300
-
-</SCRIPT> 
-
-
-<P>&nbsp;
-<HR>
-<B>Notes:</B>
-<P>
-
-
-</FONT>
-</BODY>
-</HTML>
-
diff --git a/lib/win32comext/axscript/Demos/client/ie/mousetrack.htm b/lib/win32comext/axscript/Demos/client/ie/mousetrack.htm
deleted file mode 100644
index d307a4a6..00000000
--- a/lib/win32comext/axscript/Demos/client/ie/mousetrack.htm
+++ /dev/null
@@ -1,83 +0,0 @@
-<HTML>
-
-<HEAD><TITLE>Python Scripting sample:  Mouse tracking</TITLE></HEAD>
-<BODY BGCOLOR="#FFFFFF" TOPMARGIN=8>
-<FONT SIZE=5>
-<TABLE Border=0><TR VALIGN=MIDDLE><TD>
-<A ID="Image"> <IMG 
-SRC="file:..\..\..\..\..\win32com\html\image\pycom_blowing.gif" 
-ALT="Clickable Map Image" HEIGHT=113 WIDTH=624 BORDER=0></A>
-
-</TD></TR>
- <TR><TD>&nbsp;</TD></TR>
- <TR VALIGN=MIDDLE><TD VALIGN=MIDDLE ALIGN=CENTER><FONT SIZE=5><INPUT 
-TYPE="text" NAME="TxtLinkDescription" SIZE=50></FONT></TD></TR></TABLE>
-</FONT>
-
-<P>
-A mouse tracking demo.  Move the mouse over the image above...
-
-<SCRIPT Language="Python">
-<!-- 
-# Remember the last location clicked
-#print "here we go", 1
-mx = my = 0
-
-# class for rectangle testing
-class rect:
-   def __init__(self, lowx, lowy, upx, upy, desc, url):
-       self.lowx, self.lowy, self.upx, self.upy, self.desc, self.url = \
-         lowx, lowy, upx, upy, desc, url
-   def inside(self, x, y):
-#       print (x,y), "inside", self.desc,
-       result = self.lowx <= x <= self.upx and self.lowy <= y <= self.upy
-#       print result
-       return result
-   def mouse_move(self):
-#       print "move", self.desc
-       ax.TxtLinkDescription.Value = coords + " - " + self.desc
-   def onclick(self):
-#       print "click", self.desc
-       ax.TxtLinkDescription.Value = coords +" click! " + `self.url`
-       if self.url: ax.location = self.url
-
-blows = "Blows away "
-rects =[rect(12,48,59,101,blows+"Visual Basic", ""),
-	rect(107,0,172,58,blows+"Internet Explorer", ""),
-	rect(193,0,261,56,blows+"Microsoft Access", ""),
-	rect(332,43,392,93,blows+"Microsoft Word", ""),
-	rect(457,52,521,99,blows+"Microsoft Excel", ""),
-	rect(537,12,613,85,"Python blows them all away!", "http://www.python.org"),
-]
-
-default = rect(0,0,0,0,"Click on an icon","")
-
-def Image_MouseMove(s, b, x, y):
-    global mx, my, coords
-    coords =`(x,y)`
-#    print coords,
-    mx, my = x, y
-    for r in rects:
-        if r.inside(x,y):
-#           print r.desc
-           r.mouse_move()
-           break
-    else:
-#        print default.desc
-        default.mouse_move()
-
-def Image_OnClick():
-    for r in rects:
-        if r.inside(mx,my):
-           r.onclick()
-           break
--->
-</SCRIPT>
-
-<P>
-
-</FONT>
-
-</BODY>
-</HTML>
-
diff --git a/lib/win32comext/axscript/Demos/client/ie/pycom_blowing.gif b/lib/win32comext/axscript/Demos/client/ie/pycom_blowing.gif
deleted file mode 100644
index 0d65a2928962860cf8b675b5192a43b165f31350..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 20926
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
Ab^rhX

diff --git a/lib/win32comext/axscript/Demos/client/wsh/blank.pys b/lib/win32comext/axscript/Demos/client/wsh/blank.pys
deleted file mode 100644
index e69de29b..00000000
diff --git a/lib/win32comext/axscript/Demos/client/wsh/excel.pys b/lib/win32comext/axscript/Demos/client/wsh/excel.pys
deleted file mode 100644
index 9c8fe751..00000000
--- a/lib/win32comext/axscript/Demos/client/wsh/excel.pys
+++ /dev/null
@@ -1,34 +0,0 @@
-#app=WScript.Application
-#app._print_details_() # Use this to see what Python knows about a COM object.
-
-g_index = 1
-# A procedure, using a global.
-def Show(desc, value = None):
-	global g_index # Need global for g_index, as I locally assign.
-	# No global needed to "xl" object, as only referenced.
-	# Also note "xl" is assigned later in the script - ie, Python is very late bound.
-	xl.Cells(g_index, 1).Value = desc
-	if value: xl.Cells(g_index, 2).Value = value
-	g_index = g_index + 1
-
-xl = WScript.CreateObject("Excel.Application")
-import sys
-
-xl.Visible = 1
-#xl.Workbooks().Add() # Excel versions before 98
-xl.Workbooks.Add()
-
-# Show the WScript properties.
-Show("Application Friendly Name", WScript.Name)
-Show("Application Version", WScript.Version)
-Show("Application Context: Fully Qualified Name", WScript.FullName)
-Show("Application Context: Path Only", WScript.Path)
-Show("State of Interactive Mode", WScript.Interactive)
-
-Show("All script arguments:")
-args = WScript.Arguments
-
-for i in range(0,args.Count()):
-	Show("Arg %d" % i, args(i))
-
-
diff --git a/lib/win32comext/axscript/Demos/client/wsh/registry.pys b/lib/win32comext/axscript/Demos/client/wsh/registry.pys
deleted file mode 100644
index 2d9d1e77..00000000
--- a/lib/win32comext/axscript/Demos/client/wsh/registry.pys
+++ /dev/null
@@ -1,45 +0,0 @@
-""" Windows Script Host Sample Script
-' Ported to Python
-'
-' ------------------------------------------------------------------------
-'               Copyright (C) 1996 Microsoft Corporation
-'
-' You have a royalty-free right to use, modify, reproduce and distribute
-' the Sample Application Files (and/or any modified version) in any way
-' you find useful, provided that you agree that Microsoft has no warranty,
-' obligations or liability for any Sample Application Files.
-' ------------------------------------------------------------------------
-'
-' This sample demonstrates how to write/delete from the registry. 
-"""
-
-WshShell = WScript.CreateObject("WScript.Shell")
-
-WshShell.Popup("This script shows how to use registry related methods.", 2)
-
-WshShell.Popup("Create key HKCU\\Foo with value 'Top level key'")
-WshShell.RegWrite("HKCU\\Foo\\", "Top level key")
-
-WshShell.Popup("Create key HKCU\\Foo\\Bar with value 'Second level key'")
-WshShell.RegWrite( "HKCU\\Foo\\Bar\\", "Second level key")
-
-WshShell.Popup ("Set value HKCU\\Foo\\Value to REG_SZ 1")
-WshShell.RegWrite( "HKCU\\Foo\\Value", 1)
-
-WshShell.Popup ("Set value HKCU\\Foo\\Bar to REG_DWORD 2")
-WshShell.RegWrite ("HKCU\\Foo\\Bar", 2, "REG_DWORD")
-
-WshShell.Popup ("Set value HKCU\\Foo\\Bar to REG_EXPAND_SZ '3'")
-WshShell.RegWrite ("HKCU\\Foo\\Bar\\Baz", "%SystemRoot%\\Foo")
-
-WshShell.Popup ("Delete value HKCU\\Foo\\Bar\\Baz")
-WshShell.RegDelete ("HKCU\\Foo\\Bar\\Baz")
-
-WshShell.Popup ("Delete key HKCU\\Foo\\Bar")
-WshShell.RegDelete ("HKCU\\Foo\\Bar\\")
-
-WshShell.Popup ("Delete key HKCU\\Foo")
-WshShell.RegDelete ("HKCU\\Foo\\")
-
-WScript.Echo ("Done")
-
diff --git a/lib/win32comext/axscript/Demos/client/wsh/test.pys b/lib/win32comext/axscript/Demos/client/wsh/test.pys
deleted file mode 100644
index 4038321e..00000000
--- a/lib/win32comext/axscript/Demos/client/wsh/test.pys
+++ /dev/null
@@ -1,15 +0,0 @@
-# Testall - test core AX support.
-
-# Test "Restricted Execution" (ie, IObjectSafety).
-# This will fail if in a "restricted execution" environment, but
-# will silenty do nothing of not restricted.  This same line in an MSIE
-# script would cause an exception.
-print("Importing win32api...")
-import win32api
-if 1==1:
-	print("Hi")
-
-WScript.Echo("Hello from WScript")
-
-#fail
-
diff --git a/lib/win32comext/axscript/__init__.py b/lib/win32comext/axscript/__init__.py
deleted file mode 100644
index 8d5db8b9..00000000
--- a/lib/win32comext/axscript/__init__.py
+++ /dev/null
@@ -1,4 +0,0 @@
-# See if we have a special directory for the binaries (for developers)
-import win32com
-
-win32com.__PackageSupportBuildPath__(__path__)
diff --git a/lib/win32comext/axscript/asputil.py b/lib/win32comext/axscript/asputil.py
deleted file mode 100644
index b61c3537..00000000
--- a/lib/win32comext/axscript/asputil.py
+++ /dev/null
@@ -1,13 +0,0 @@
-"""A utility module for ASP (Active Server Pages on MS Internet Info Server.
-
-Contains:
-	iif -- A utility function to avoid using "if" statements in ASP <% tags
-
-"""
-
-
-def iif(cond, t, f):
-    if cond:
-        return t
-    else:
-        return f
diff --git a/lib/win32comext/axscript/axscript.pyd b/lib/win32comext/axscript/axscript.pyd
deleted file mode 100644
index a29615a5f4f88f1ea911cc9cc16c0c211953935b..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 93184
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
HbG-f!>`YfX

diff --git a/lib/win32comext/axscript/client/__init__.py b/lib/win32comext/axscript/client/__init__.py
deleted file mode 100644
index 7858ad6b..00000000
--- a/lib/win32comext/axscript/client/__init__.py
+++ /dev/null
@@ -1 +0,0 @@
-# This is a Python package
diff --git a/lib/win32comext/axscript/client/debug.py b/lib/win32comext/axscript/client/debug.py
deleted file mode 100644
index 2e305f0b..00000000
--- a/lib/win32comext/axscript/client/debug.py
+++ /dev/null
@@ -1,240 +0,0 @@
-import os
-import sys
-
-import pythoncom
-import win32api
-import win32com.client.connect
-import win32com.server.util
-import winerror
-from win32com.axdebug import adb, axdebug, contexts, documents, gateways, stackframe
-from win32com.axdebug.codecontainer import SourceCodeContainer
-from win32com.axdebug.util import _wrap, _wrap_remove
-from win32com.client.util import Enumerator
-from win32com.server.exception import COMException
-from win32com.util import IIDToInterfaceName
-
-from .framework import trace
-
-try:
-    os.environ["DEBUG_AXDEBUG"]
-    debuggingTrace = 1  # Should we print "trace" output?
-except KeyError:
-    debuggingTrace = 0
-
-
-def trace(*args):
-    """A function used instead of "print" for debugging output."""
-    if not debuggingTrace:
-        return
-    print(win32api.GetCurrentThreadId(), end=" ")
-    for arg in args:
-        print(arg, end=" ")
-    print()
-
-
-# Note that the DebugManager is not a COM gateway class for the
-# debugger - but it does create and manage them.
-class DebugManager:
-    _debugger_interfaces_ = [axdebug.IID_IActiveScriptDebug]
-
-    def __init__(self, scriptEngine):
-        self.scriptEngine = scriptEngine
-        self.adb = adb.Debugger()
-        self.rootNode = None
-        self.debugApplication = None
-        self.ccProvider = documents.CodeContainerProvider()
-        try:
-            self.scriptSiteDebug = scriptEngine.GetScriptSite(
-                axdebug.IID_IActiveScriptSiteDebug
-            )
-        except pythoncom.com_error:
-            # No debugger interface (ie, dumb host).  Do the extra work.
-            trace("Scripting site has no debugger interface")
-            self.scriptSiteDebug = None
-        # Get the debug application object.
-        self.debugApplication = None
-        if self.scriptSiteDebug is not None:
-            # Spec says that we should test for this, and if it fails revert to
-            # PDM application.
-            try:
-                self.debugApplication = self.scriptSiteDebug.GetApplication()
-                self.rootNode = self.scriptSiteDebug.GetRootApplicationNode()
-            except pythoncom.com_error:
-                self.debugApplication = None
-
-        if self.debugApplication is None:
-            # Try to get/create the default one
-            # NOTE - Dont catch exceptions here - let the parent do it,
-            # so it knows debug support is available.
-            pdm = pythoncom.CoCreateInstance(
-                axdebug.CLSID_ProcessDebugManager,
-                None,
-                pythoncom.CLSCTX_ALL,
-                axdebug.IID_IProcessDebugManager,
-            )
-            self.debugApplication = pdm.GetDefaultApplication()
-            self.rootNode = self.debugApplication.GetRootNode()
-
-        assert (
-            self.debugApplication is not None
-        ), "Need to have a DebugApplication object by now!"
-        self.activeScriptDebug = None
-
-        if self.debugApplication is not None:
-            self.adb.AttachApp(self.debugApplication, self.ccProvider)
-        self.codeContainers = {}
-        self.activeScriptDebug = _wrap(
-            ActiveScriptDebug(self, self.codeContainers), axdebug.IID_IActiveScriptDebug
-        )
-
-    def Close(self):
-        # Called by the language engine when it receives a close request
-        if self.activeScriptDebug is not None:
-            _wrap_remove(self.activeScriptDebug)
-            self.activeScriptDebug = None
-        self.scriptEngine = None
-        self.rootNode = None
-        self.debugApplication = None
-        self.scriptSiteDebug = None
-        if self.ccProvider is not None:
-            self.ccProvider.Close()
-            self.ccProvider = None
-        self.codeContainers = {}
-        if self.adb:
-            self.adb.CloseApp()
-            self.adb = None
-
-    # 		print "Close complete"
-
-    def IsAnyHost(self):
-        "Do we have _any_ debugging interfaces installed?"
-        return self.debugApplication is not None
-
-    def IsSimpleHost(self):
-        return self.scriptSiteDebug is None
-
-    def HandleRuntimeError(self):
-        """Called by the engine when a runtime error occurs.  If we have a debugger,
-        we let it know.
-
-        The result is a boolean which indicates if the error handler should call
-        IActiveScriptSite::OnScriptError()
-        """
-        # 		if self.IsAnyHost:
-        # 			site = _wrap(self, axdebug.IID_IActiveScriptSite)
-        # 			breakResume, errorResume, fCallOnError = self.debugApplication(activeScriptErrorDebug, site)
-        # Do something with these!
-        # 		else:
-        trace("HandleRuntimeError")
-        fCallOnError = 1
-        return fCallOnError
-
-    def _query_interface_for_debugger_(self, iid):
-        if iid in self._debugger_interfaces_:
-            return self.activeScriptDebug
-        trace("DebugManager QI - unknown IID", iid)
-        return 0
-
-    def OnEnterScript(self):
-        trace("OnEnterScript")
-        try:
-            1 / 0
-        except:
-            # Bit of a hack - reach into engine.
-            baseFrame = sys.exc_info()[2].tb_frame.f_back
-        self.adb.SetupAXDebugging(baseFrame)
-
-    def OnLeaveScript(self):
-        trace("OnLeaveScript")
-        self.adb.ResetAXDebugging()
-
-    def AddScriptBlock(self, codeBlock):
-        # If we dont have debugging support, dont bother.
-        cc = DebugCodeBlockContainer(codeBlock, self.scriptSiteDebug)
-        if self.IsSimpleHost():
-            document = documents.DebugDocumentText(cc)
-            document = _wrap(document, axdebug.IID_IDebugDocument)
-            provider = documents.DebugDocumentProvider(document)
-            provider = _wrap(provider, axdebug.IID_IDebugDocumentProvider)
-            cc.debugDocument = document
-            newNode = self.debugApplication.CreateApplicationNode()
-            newNode.SetDocumentProvider(provider)
-            newNode.Attach(self.rootNode)
-        else:
-            newNode = None  # Managed by smart host.
-            self.codeContainers[cc.sourceContext] = cc
-        self.ccProvider.AddCodeContainer(cc, newNode)
-
-
-class DebugCodeBlockContainer(SourceCodeContainer):
-    def __init__(self, codeBlock, site):
-        self.codeBlock = codeBlock
-        SourceCodeContainer.__init__(
-            self,
-            codeBlock.codeText,
-            codeBlock.GetFileName(),
-            codeBlock.sourceContextCookie,
-            codeBlock.startLineNumber,
-            site,
-        )
-
-    def GetName(self, dnt):
-        if dnt == axdebug.DOCUMENTNAMETYPE_APPNODE:
-            return self.codeBlock.GetDisplayName()
-        elif dnt == axdebug.DOCUMENTNAMETYPE_TITLE:
-            return self.codeBlock.GetDisplayName()
-        # 		elif dnt==axdebug.DOCUMENTNAMETYPE_FILE_TAIL:
-        # 		elif dnt==axdebug.DOCUMENTNAMETYPE_URL:
-        else:
-            raise COMException(scode=winerror.S_FALSE)
-
-
-class EnumDebugCodeContexts(gateways.EnumDebugCodeContexts):
-    def _wrap(self, ob):
-        return ob
-
-
-class ActiveScriptDebug:
-    """The class which implements the IActiveScriptDebug interface for the Active Script engine.
-
-    Only ever used by smart hosts.
-    """
-
-    _public_methods_ = [
-        "GetScriptTextAttributes",
-        "GetScriptletTextAttributes",
-        "EnumCodeContextsOfPosition",
-    ]
-    _com_interfaces_ = [axdebug.IID_IActiveScriptDebug]
-
-    def __init__(self, debugMgr, codeContainers):
-        self.debugMgr = debugMgr
-        self.scriptSiteDebug = debugMgr.scriptSiteDebug
-        self.codeContainers = codeContainers
-
-    def _Close(self):
-        self.debugMgr = None
-        self.scriptSiteDebug = None
-        self.codeContainers = {}
-
-    def _query_interface_(self, iid):
-        trace("DebuggerQI with", iid)
-        return _wrap(self.debugMgr.scriptEngine, iid)
-
-    def GetScriptTextAttributes(self, code, delim, flags):
-        container = SourceCodeContainer(code, "<Temp Code Block>")
-        return container.GetSyntaxColorAttributes()
-
-    def GetScriptletTextAttributes(self, code, delim, flags):
-        trace("GetScriptletTextAttributes", code, delim, flags)
-        container = SourceCodeContainer(code, "<Temp Code Block>")
-        return container.GetSyntaxColorAttributes()
-
-    def EnumCodeContextsOfPosition(self, context, charOffset, numChars):
-        trace("EnumCodeContextsOfPosition", context, charOffset, numChars)
-        try:
-            context = self.codeContainers[context].GetCodeContextAtPosition(charOffset)
-        except KeyError:
-            raise COMException(scode=winerror.E_UNEXPECTED)
-        enum = EnumDebugCodeContexts([context])
-        return _wrap(enum, axdebug.IID_IEnumDebugCodeContexts)
diff --git a/lib/win32comext/axscript/client/error.py b/lib/win32comext/axscript/client/error.py
deleted file mode 100644
index 1dfa54fa..00000000
--- a/lib/win32comext/axscript/client/error.py
+++ /dev/null
@@ -1,273 +0,0 @@
-"""Exception and error handling.
-
- This contains the core exceptions that the implementations should raise
- as well as the IActiveScriptError interface code.
- 
-"""
-
-import re
-import sys
-import traceback
-
-import pythoncom
-import win32com.server.exception
-import win32com.server.util
-import winerror
-from win32com.axscript import axscript
-
-debugging = 0
-
-
-def FormatForAX(text):
-    """Format a string suitable for an AX Host"""
-    # Replace all " with ', so it works OK in HTML (ie, ASP)
-    return ExpandTabs(AddCR(text))
-
-
-def ExpandTabs(text):
-    return re.sub("\t", "    ", text)
-
-
-def AddCR(text):
-    return re.sub("\n", "\r\n", text)
-
-
-class IActiveScriptError:
-    """An implementation of IActiveScriptError
-
-    The ActiveX Scripting host calls this client whenever we report
-    an exception to it.  This interface provides the exception details
-    for the host to report to the user.
-    """
-
-    _com_interfaces_ = [axscript.IID_IActiveScriptError]
-    _public_methods_ = ["GetSourceLineText", "GetSourcePosition", "GetExceptionInfo"]
-
-    def _query_interface_(self, iid):
-        print("IActiveScriptError QI - unknown IID", iid)
-        return 0
-
-    def _SetExceptionInfo(self, exc):
-        self.exception = exc
-
-    def GetSourceLineText(self):
-        return self.exception.linetext
-
-    def GetSourcePosition(self):
-        ctx = self.exception.sourceContext
-        # Zero based in the debugger (but our columns are too!)
-        return (
-            ctx,
-            self.exception.lineno + self.exception.startLineNo - 1,
-            self.exception.colno,
-        )
-
-    def GetExceptionInfo(self):
-        return self.exception
-
-
-class AXScriptException(win32com.server.exception.COMException):
-    """A class used as a COM exception.
-
-    Note this has attributes which conform to the standard attributes
-    for COM exceptions, plus a few others specific to our IActiveScriptError
-    object.
-    """
-
-    def __init__(self, site, codeBlock, exc_type, exc_value, exc_traceback):
-        # set properties base class shares via base ctor...
-        win32com.server.exception.COMException.__init__(
-            self,
-            description="Unknown Exception",
-            scode=winerror.DISP_E_EXCEPTION,
-            source="Python ActiveX Scripting Engine",
-        )
-
-        # And my other values...
-        if codeBlock is None:
-            self.sourceContext = 0
-            self.startLineNo = 0
-        else:
-            self.sourceContext = codeBlock.sourceContextCookie
-            self.startLineNo = codeBlock.startLineNumber
-        self.linetext = ""
-
-        self.__BuildFromException(site, exc_type, exc_value, exc_traceback)
-
-    def __BuildFromException(self, site, type, value, tb):
-        if debugging:
-            import linecache
-
-            linecache.clearcache()
-        try:
-            if issubclass(type, SyntaxError):
-                self._BuildFromSyntaxError(site, value, tb)
-            else:
-                self._BuildFromOther(site, type, value, tb)
-        except:  # Error extracting traceback info!!!
-            traceback.print_exc()
-            # re-raise.
-            raise
-
-    def _BuildFromSyntaxError(self, site, exc, tb):
-        value = exc.args
-        # All syntax errors should have a message as element 0
-        try:
-            msg = value[0]
-        except:
-            msg = "Unknown Error (%s)" % (value,)
-        try:
-            (filename, lineno, offset, line) = value[1]
-            # Some of these may be None, which upsets us!
-            if offset is None:
-                offset = 0
-            if line is None:
-                line = ""
-        except:
-            msg = "Unknown"
-            lineno = 0
-            offset = 0
-            line = "Unknown"
-        self.description = FormatForAX(msg)
-        self.lineno = lineno
-        self.colno = offset - 1
-        self.linetext = ExpandTabs(line.rstrip())
-
-    def _BuildFromOther(self, site, exc_type, value, tb):
-        self.colno = -1
-        self.lineno = 0
-        if debugging:  # Full traceback if debugging.
-            list = traceback.format_exception(exc_type, value, tb)
-            self.description = ExpandTabs("".join(list))
-            return
-        # Run down the traceback list, looking for the first "<Script..>"
-        # Hide traceback above this.  In addition, keep going down
-        # looking for a "_*_" attribute, and below hide these also.
-        hide_names = [
-            "r_import",
-            "r_reload",
-            "r_open",
-        ]  # hide from these functions down in the traceback.
-        depth = None
-        tb_top = tb
-        while tb_top:
-            filename, lineno, name, line = self.ExtractTracebackInfo(tb_top, site)
-            if filename[:7] == "<Script":
-                break
-            tb_top = tb_top.tb_next
-        format_items = []
-        if tb_top:  # found one.
-            depth = 0
-            tb_look = tb_top
-            # Look down for our bottom
-            while tb_look:
-                filename, lineno, name, line = self.ExtractTracebackInfo(tb_look, site)
-                if name in hide_names:
-                    break
-                # We can report a line-number, but not a filename.  Therefore,
-                # we return the last line-number we find in one of our script
-                # blocks.
-                if filename.startswith("<Script"):
-                    self.lineno = lineno
-                    self.linetext = line
-                format_items.append((filename, lineno, name, line))
-                depth = depth + 1
-                tb_look = tb_look.tb_next
-        else:
-            depth = None
-            tb_top = tb
-
-        bits = ["Traceback (most recent call last):\n"]
-        bits.extend(traceback.format_list(format_items))
-        if exc_type == pythoncom.com_error:
-            desc = "%s (0x%x)" % (value.strerror, value.hresult)
-            if (
-                value.hresult == winerror.DISP_E_EXCEPTION
-                and value.excepinfo
-                and value.excepinfo[2]
-            ):
-                desc = value.excepinfo[2]
-            bits.append("COM Error: " + desc)
-        else:
-            bits.extend(traceback.format_exception_only(exc_type, value))
-
-        # XXX - this utf8 encoding seems bogus.  From well before py3k,
-        # we had the comment:
-        # > all items in the list are utf8 courtesy of Python magically
-        # > converting unicode to utf8 before compilation.
-        # but that is likely just confusion from early unicode days;
-        # Python isn't doing it, pywin32 probably was, so 'mbcs' would
-        # be the default encoding.  We should never hit this these days
-        # anyway, but on py3k, we *never* will, and str objects there
-        # don't have a decode method...
-        if sys.version_info < (3,):
-            for i in range(len(bits)):
-                if type(bits[i]) is str:
-                    # assert type(bits[i]) is str, type(bits[i])
-                    bits[i] = bits[i].decode("utf8")
-
-        self.description = ExpandTabs("".join(bits))
-        # Clear tracebacks etc.
-        tb = tb_top = tb_look = None
-
-    def ExtractTracebackInfo(self, tb, site):
-        import linecache
-
-        f = tb.tb_frame
-        lineno = tb.tb_lineno
-        co = f.f_code
-        filename = co.co_filename
-        name = co.co_name
-        line = linecache.getline(filename, lineno)
-        if not line:
-            try:
-                codeBlock = site.scriptCodeBlocks[filename]
-            except KeyError:
-                codeBlock = None
-            if codeBlock:
-                # Note: 'line' will now be unicode.
-                line = codeBlock.GetLineNo(lineno)
-        if line:
-            line = line.strip()
-        else:
-            line = None
-        return filename, lineno, name, line
-
-    def __repr__(self):
-        return "AXScriptException Object with description:" + self.description
-
-
-def ProcessAXScriptException(scriptingSite, debugManager, exceptionInstance):
-    """General function to handle any exception in AX code
-
-    This function creates an instance of our IActiveScriptError interface, and
-    gives it to the host, along with out exception class.  The host will
-    likely call back on the IActiveScriptError interface to get the source text
-    and other information not normally in COM exceptions.
-    """
-    # 	traceback.print_exc()
-    instance = IActiveScriptError()
-    instance._SetExceptionInfo(exceptionInstance)
-    gateway = win32com.server.util.wrap(instance, axscript.IID_IActiveScriptError)
-    if debugManager:
-        fCallOnError = debugManager.HandleRuntimeError()
-        if not fCallOnError:
-            return None
-
-    try:
-        result = scriptingSite.OnScriptError(gateway)
-    except pythoncom.com_error as details:
-        print("**OnScriptError failed:", details)
-        print("Exception description:'%s'" % (repr(exceptionInstance.description)))
-        print("Exception text:'%s'" % (repr(exceptionInstance.linetext)))
-        result = winerror.S_FALSE
-
-    if result == winerror.S_OK:
-        # If the above  returns NOERROR, it is assumed the error has been
-        # correctly registered and the value SCRIPT_E_REPORTED is returned.
-        ret = win32com.server.exception.COMException(scode=axscript.SCRIPT_E_REPORTED)
-        return ret
-    else:
-        # The error is taken to be unreported and is propagated up the call stack
-        # via the IDispatch::Invoke's EXCEPINFO parameter (hr returned is DISP_E_EXCEPTION.
-        return exceptionInstance
diff --git a/lib/win32comext/axscript/client/framework.py b/lib/win32comext/axscript/client/framework.py
deleted file mode 100644
index d7b56a7c..00000000
--- a/lib/win32comext/axscript/client/framework.py
+++ /dev/null
@@ -1,1270 +0,0 @@
-"""AXScript Client Framework
-
-  This module provides a core framework for an ActiveX Scripting client.
-  Derived classes actually implement the AX Client itself, including the
-  scoping rules, etc.
-
-  There are classes defined for the engine itself, and for ScriptItems
-"""
-import re
-import sys
-
-import pythoncom  # Need simple connection point support
-import win32api
-import win32com.client.connect
-import win32com.server.util
-import winerror
-from win32com.axscript import axscript
-
-
-def RemoveCR(text):
-    # No longer just "RemoveCR" - should be renamed to
-    # FixNewlines, or something.  Idea is to fix arbitary newlines into
-    # something Python can compile...
-    return re.sub("(\r\n)|\r|(\n\r)", "\n", text)
-
-
-SCRIPTTEXT_FORCEEXECUTION = -2147483648  # 0x80000000
-SCRIPTTEXT_ISEXPRESSION = 0x00000020
-SCRIPTTEXT_ISPERSISTENT = 0x00000040
-
-from win32com.server.exception import Exception, IsCOMServerException
-
-from . import error  # ax.client.error
-
-state_map = {
-    axscript.SCRIPTSTATE_UNINITIALIZED: "SCRIPTSTATE_UNINITIALIZED",
-    axscript.SCRIPTSTATE_INITIALIZED: "SCRIPTSTATE_INITIALIZED",
-    axscript.SCRIPTSTATE_STARTED: "SCRIPTSTATE_STARTED",
-    axscript.SCRIPTSTATE_CONNECTED: "SCRIPTSTATE_CONNECTED",
-    axscript.SCRIPTSTATE_DISCONNECTED: "SCRIPTSTATE_DISCONNECTED",
-    axscript.SCRIPTSTATE_CLOSED: "SCRIPTSTATE_CLOSED",
-}
-
-
-def profile(fn, *args):
-    import profile
-
-    prof = profile.Profile()
-    try:
-        # roll on 1.6 :-)
-        # 		return prof.runcall(fn, *args)
-        return prof.runcall(*(fn,) + args)
-    finally:
-        import pstats
-
-        # Damn - really want to send this to Excel!
-        #      width, list = pstats.Stats(prof).strip_dirs().get_print_list([])
-        pstats.Stats(prof).strip_dirs().sort_stats("time").print_stats()
-
-
-class SafeOutput:
-    softspace = 1
-
-    def __init__(self, redir=None):
-        if redir is None:
-            redir = sys.stdout
-        self.redir = redir
-
-    def write(self, message):
-        try:
-            self.redir.write(message)
-        except:
-            win32api.OutputDebugString(message)
-
-    def flush(self):
-        pass
-
-    def close(self):
-        pass
-
-
-# Make sure we have a valid sys.stdout/stderr, otherwise out
-# print and trace statements may raise an exception
-def MakeValidSysOuts():
-    if not isinstance(sys.stdout, SafeOutput):
-        sys.stdout = sys.stderr = SafeOutput()
-        # and for the sake of working around something I can't understand...
-        # prevent keyboard interrupts from killing IIS
-        import signal
-
-        def noOp(a, b):
-            # it would be nice to get to the bottom of this, so a warning to
-            # the debug console can't hurt.
-            print("WARNING: Ignoring keyboard interrupt from ActiveScripting engine")
-
-        # If someone else has already redirected, then assume they know what they are doing!
-        if signal.getsignal(signal.SIGINT) == signal.default_int_handler:
-            try:
-                signal.signal(signal.SIGINT, noOp)
-            except ValueError:
-                # Not the main thread - can't do much.
-                pass
-
-
-def trace(*args):
-    """A function used instead of "print" for debugging output."""
-    for arg in args:
-        print(arg, end=" ")
-    print()
-
-
-def RaiseAssert(scode, desc):
-    """A debugging function that raises an exception considered an "Assertion"."""
-    print("**************** ASSERTION FAILED *******************")
-    print(desc)
-    raise Exception(desc, scode)
-
-
-class AXScriptCodeBlock:
-    """An object which represents a chunk of code in an AX Script"""
-
-    def __init__(self, name, codeText, sourceContextCookie, startLineNumber, flags):
-        self.name = name
-        self.codeText = codeText
-        self.codeObject = None
-        self.sourceContextCookie = sourceContextCookie
-        self.startLineNumber = startLineNumber
-        self.flags = flags
-        self.beenExecuted = 0
-
-    def GetFileName(self):
-        # Gets the "file name" for Python - uses <...> so Python doesnt think
-        # it is a real file.
-        return "<%s>" % self.name
-
-    def GetDisplayName(self):
-        return self.name
-
-    def GetLineNo(self, no):
-        pos = -1
-        for i in range(no - 1):
-            pos = self.codeText.find("\n", pos + 1)
-            if pos == -1:
-                pos = len(self.codeText)
-        epos = self.codeText.find("\n", pos + 1)
-        if epos == -1:
-            epos = len(self.codeText)
-        return self.codeText[pos + 1 : epos].strip()
-
-
-class Event:
-    """A single event for a ActiveX named object."""
-
-    def __init__(self):
-        self.name = "<None>"
-
-    def __repr__(self):
-        return "<%s at %d: %s>" % (self.__class__.__name__, id(self), self.name)
-
-    def Reset(self):
-        pass
-
-    def Close(self):
-        pass
-
-    def Build(self, typeinfo, funcdesc):
-        self.dispid = funcdesc[0]
-        self.name = typeinfo.GetNames(self.dispid)[0]
-
-
-# 		print "Event.Build() - Event Name is ", self.name
-
-
-class EventSink:
-    """A set of events against an item.  Note this is a COM client for connection points."""
-
-    _public_methods_ = []
-
-    def __init__(self, myItem, coDispatch):
-        self.events = {}
-        self.connection = None
-        self.coDispatch = coDispatch
-        self.myScriptItem = myItem
-        self.myInvokeMethod = myItem.GetEngine().ProcessScriptItemEvent
-        self.iid = None
-
-    def Reset(self):
-        self.Disconnect()
-
-    def Close(self):
-        self.iid = None
-        self.myScriptItem = None
-        self.myInvokeMethod = None
-        self.coDispatch = None
-        for event in self.events.values():
-            event.Reset()
-        self.events = {}
-        self.Disconnect()
-
-    # COM Connection point methods.
-    def _query_interface_(self, iid):
-        if iid == self.iid:
-            return win32com.server.util.wrap(self)
-
-    def _invoke_(self, dispid, lcid, wFlags, args):
-        try:
-            event = self.events[dispid]
-        except:
-            raise Exception(scode=winerror.DISP_E_MEMBERNOTFOUND)
-        # print "Invoke for ", event, "on", self.myScriptItem, " - calling",  self.myInvokeMethod
-        return self.myInvokeMethod(self.myScriptItem, event, lcid, wFlags, args)
-
-    def GetSourceTypeInfo(self, typeinfo):
-        """Gets the typeinfo for the Source Events for the passed typeinfo"""
-        attr = typeinfo.GetTypeAttr()
-        cFuncs = attr[6]
-        typeKind = attr[5]
-        if typeKind not in [pythoncom.TKIND_COCLASS, pythoncom.TKIND_INTERFACE]:
-            RaiseAssert(
-                winerror.E_UNEXPECTED, "The typeKind of the object is unexpected"
-            )
-        cImplType = attr[8]
-        for i in range(cImplType):
-            # Look for the [source, default] interface on the coclass
-            # that isn't marked as restricted.
-            flags = typeinfo.GetImplTypeFlags(i)
-            flagsNeeded = (
-                pythoncom.IMPLTYPEFLAG_FDEFAULT | pythoncom.IMPLTYPEFLAG_FSOURCE
-            )
-            if (flags & (flagsNeeded | pythoncom.IMPLTYPEFLAG_FRESTRICTED)) == (
-                flagsNeeded
-            ):
-                # Get the handle to the implemented interface.
-                href = typeinfo.GetRefTypeOfImplType(i)
-                return typeinfo.GetRefTypeInfo(href)
-
-    def BuildEvents(self):
-        # See if it is an extender object.
-        try:
-            mainTypeInfo = self.coDispatch.QueryInterface(
-                axscript.IID_IProvideMultipleClassInfo
-            )
-            isMulti = 1
-            numTypeInfos = mainTypeInfo.GetMultiTypeInfoCount()
-        except pythoncom.com_error:
-            isMulti = 0
-            numTypeInfos = 1
-            try:
-                mainTypeInfo = self.coDispatch.QueryInterface(
-                    pythoncom.IID_IProvideClassInfo
-                )
-            except pythoncom.com_error:
-                numTypeInfos = 0
-        # Create an event handler for the item.
-        for item in range(numTypeInfos):
-            if isMulti:
-                typeinfo, flags = mainTypeInfo.GetInfoOfIndex(
-                    item, axscript.MULTICLASSINFO_GETTYPEINFO
-                )
-            else:
-                typeinfo = mainTypeInfo.GetClassInfo()
-            sourceType = self.GetSourceTypeInfo(typeinfo)
-            cFuncs = 0
-            if sourceType:
-                attr = sourceType.GetTypeAttr()
-                self.iid = attr[0]
-                cFuncs = attr[6]
-                for i in range(cFuncs):
-                    funcdesc = sourceType.GetFuncDesc(i)
-                    event = Event()
-                    event.Build(sourceType, funcdesc)
-                    self.events[event.dispid] = event
-
-    def Connect(self):
-        if self.connection is not None or self.iid is None:
-            return
-        # 		trace("Connect for sink item", self.myScriptItem.name, "with IID",str(self.iid))
-        self.connection = win32com.client.connect.SimpleConnection(
-            self.coDispatch, self, self.iid
-        )
-
-    def Disconnect(self):
-        if self.connection:
-            try:
-                self.connection.Disconnect()
-            except pythoncom.com_error:
-                pass  # Ignore disconnection errors.
-            self.connection = None
-
-
-class ScriptItem:
-    """An item (or subitem) that is exposed to the ActiveX script"""
-
-    def __init__(self, parentItem, name, dispatch, flags):
-        self.parentItem = parentItem
-        self.dispatch = dispatch
-        self.name = name
-        self.flags = flags
-        self.eventSink = None
-        self.subItems = {}
-        self.createdConnections = 0
-        self.isRegistered = 0
-
-    # 		trace("Creating ScriptItem", name, "of parent", parentItem,"with dispatch", dispatch)
-
-    def __repr__(self):
-        flagsDesc = ""
-        if self.flags is not None and self.flags & axscript.SCRIPTITEM_GLOBALMEMBERS:
-            flagsDesc = "/Global"
-        return "<%s at %d: %s%s>" % (
-            self.__class__.__name__,
-            id(self),
-            self.name,
-            flagsDesc,
-        )
-
-    def _dump_(self, level):
-        flagDescs = []
-        if self.flags is not None and self.flags & axscript.SCRIPTITEM_GLOBALMEMBERS:
-            flagDescs.append("GLOBAL!")
-        if self.flags is None or self.flags & axscript.SCRIPTITEM_ISVISIBLE == 0:
-            flagDescs.append("NOT VISIBLE")
-        if self.flags is not None and self.flags & axscript.SCRIPTITEM_ISSOURCE:
-            flagDescs.append("EVENT SINK")
-        if self.flags is not None and self.flags & axscript.SCRIPTITEM_CODEONLY:
-            flagDescs.append("CODE ONLY")
-        print(" " * level, "Name=", self.name, ", flags=", "/".join(flagDescs), self)
-        for subItem in self.subItems.values():
-            subItem._dump_(level + 1)
-
-    def Reset(self):
-        self.Disconnect()
-        if self.eventSink:
-            self.eventSink.Reset()
-        self.isRegistered = 0
-        for subItem in self.subItems.values():
-            subItem.Reset()
-
-    def Close(self):
-        self.Reset()
-        self.dispatch = None
-        self.parentItem = None
-        if self.eventSink:
-            self.eventSink.Close()
-            self.eventSink = None
-        for subItem in self.subItems.values():
-            subItem.Close()
-        self.subItems = []
-        self.createdConnections = 0
-
-    def Register(self):
-        if self.isRegistered:
-            return
-        # Get the type info to use to build this item.
-        # 		if not self.dispatch:
-        # 			id = self.parentItem.dispatch.GetIDsOfNames(self.name)
-        # 			print "DispID of me is", id
-        # 			result = self.parentItem.dispatch.Invoke(id, 0, pythoncom.DISPATCH_PROPERTYGET,1)
-        # 			if type(result)==pythoncom.TypeIIDs[pythoncom.IID_IDispatch]:
-        # 				self.dispatch = result
-        # 			else:
-        # 				print "*** No dispatch"
-        # 				return
-        # 			print "**** Made dispatch"
-        self.isRegistered = 1
-        # Register the sub-items.
-        for item in self.subItems.values():
-            if not item.isRegistered:
-                item.Register()
-
-    def IsGlobal(self):
-        return self.flags & axscript.SCRIPTITEM_GLOBALMEMBERS
-
-    def IsVisible(self):
-        return (
-            self.flags & (axscript.SCRIPTITEM_ISVISIBLE | axscript.SCRIPTITEM_ISSOURCE)
-        ) != 0
-
-    def GetEngine(self):
-        item = self
-        while item.parentItem.__class__ == self.__class__:
-            item = item.parentItem
-        return item.parentItem
-
-    def _GetFullItemName(self):
-        ret = self.name
-        if self.parentItem:
-            try:
-                ret = self.parentItem._GetFullItemName() + "." + ret
-            except AttributeError:
-                pass
-        return ret
-
-    def GetSubItemClass(self):
-        return self.__class__
-
-    def GetSubItem(self, name):
-        return self.subItems[name.lower()]
-
-    def GetCreateSubItem(self, parentItem, name, dispatch, flags):
-        keyName = name.lower()
-        try:
-            rc = self.subItems[keyName]
-            # No changes allowed to existing flags.
-            if not rc.flags is None and not flags is None and rc.flags != flags:
-                raise Exception(scode=winerror.E_INVALIDARG)
-            # Existing item must not have a dispatch.
-            if not rc.dispatch is None and not dispatch is None:
-                raise Exception(scode=winerror.E_INVALIDARG)
-            rc.flags = flags  # Setup the real flags.
-            rc.dispatch = dispatch
-        except KeyError:
-            rc = self.subItems[keyName] = self.GetSubItemClass()(
-                parentItem, name, dispatch, flags
-            )
-        return rc
-
-    # 		if self.dispatch is None:
-    # 			RaiseAssert(winerror.E_UNEXPECTED, "??")
-
-    def CreateConnections(self):
-        # Create (but do not connect to) the connection points.
-        if self.createdConnections:
-            return
-        self.createdConnections = 1
-        # Nothing to do unless this is an event source
-        # This flags means self, _and_ children, are connectable.
-        if self.flags & axscript.SCRIPTITEM_ISSOURCE:
-            self.BuildEvents()
-            self.FindBuildSubItemEvents()
-
-    def Connect(self):
-        # Connect to the already created connection points.
-        if self.eventSink:
-            self.eventSink.Connect()
-        for subItem in self.subItems.values():
-            subItem.Connect()
-
-    def Disconnect(self):
-        # Disconnect from the connection points.
-        if self.eventSink:
-            self.eventSink.Disconnect()
-        for subItem in self.subItems.values():
-            subItem.Disconnect()
-
-    def BuildEvents(self):
-        if self.eventSink is not None or self.dispatch is None:
-            RaiseAssert(
-                winerror.E_UNEXPECTED,
-                "Item already has built events, or no dispatch available?",
-            )
-
-        # 		trace("BuildEvents for named item", self._GetFullItemName())
-        self.eventSink = EventSink(self, self.dispatch)
-        self.eventSink.BuildEvents()
-
-    def FindBuildSubItemEvents(self):
-        # Called during connection to event source.  Seeks out and connects to
-        # all children.  As per the AX spec, this is not recursive
-        # (ie, children sub-items are not seeked)
-        try:
-            multiTypeInfo = self.dispatch.QueryInterface(
-                axscript.IID_IProvideMultipleClassInfo
-            )
-            numTypeInfos = multiTypeInfo.GetMultiTypeInfoCount()
-        except pythoncom.com_error:
-            return
-        for item in range(numTypeInfos):
-            typeinfo, flags = multiTypeInfo.GetInfoOfIndex(
-                item, axscript.MULTICLASSINFO_GETTYPEINFO
-            )
-            defaultType = self.GetDefaultSourceTypeInfo(typeinfo)
-            index = 0
-            while 1:
-                try:
-                    fdesc = defaultType.GetFuncDesc(index)
-                except pythoncom.com_error:
-                    break  # No more funcs
-                index = index + 1
-                dispid = fdesc[0]
-                funckind = fdesc[3]
-                invkind = fdesc[4]
-                elemdesc = fdesc[8]
-                funcflags = fdesc[9]
-                try:
-                    isSubObject = (
-                        not (funcflags & pythoncom.FUNCFLAG_FRESTRICTED)
-                        and funckind == pythoncom.FUNC_DISPATCH
-                        and invkind == pythoncom.INVOKE_PROPERTYGET
-                        and elemdesc[0][0] == pythoncom.VT_PTR
-                        and elemdesc[0][1][0] == pythoncom.VT_USERDEFINED
-                    )
-                except:
-                    isSubObject = 0
-                if isSubObject:
-                    try:
-                        # We found a sub-object.
-                        names = typeinfo.GetNames(dispid)
-                        result = self.dispatch.Invoke(
-                            dispid, 0x0, pythoncom.DISPATCH_PROPERTYGET, 1
-                        )
-                        # IE has an interesting problem - there are lots of synonyms for the same object.  Eg
-                        # in a simple form, "window.top", "window.window", "window.parent", "window.self"
-                        # all refer to the same object.  Our event implementation code does not differentiate
-                        # eg, "window_onload" will fire for *all* objects named "window".  Thus,
-                        # "window" and "window.window" will fire the same event handler :(
-                        # One option would be to check if the sub-object is indeed the
-                        # parent object - however, this would stop "top_onload" from firing,
-                        # as no event handler for "top" would work.
-                        # I think we simply need to connect to a *single* event handler.
-                        # As use in IE is deprecated, I am not solving this now.
-                        if type(result) == pythoncom.TypeIIDs[pythoncom.IID_IDispatch]:
-                            name = names[0]
-                            subObj = self.GetCreateSubItem(
-                                self, name, result, axscript.SCRIPTITEM_ISVISIBLE
-                            )
-                            # print "subobj", name, "flags are", subObj.flags, "mydisp=", self.dispatch, "result disp=", result, "compare=", self.dispatch==result
-                            subObj.BuildEvents()
-                            subObj.Register()
-                    except pythoncom.com_error:
-                        pass
-
-    def GetDefaultSourceTypeInfo(self, typeinfo):
-        """Gets the typeinfo for the Default Dispatch for the passed typeinfo"""
-        attr = typeinfo.GetTypeAttr()
-        cFuncs = attr[6]
-        typeKind = attr[5]
-        if typeKind not in [pythoncom.TKIND_COCLASS, pythoncom.TKIND_INTERFACE]:
-            RaiseAssert(
-                winerror.E_UNEXPECTED, "The typeKind of the object is unexpected"
-            )
-        cImplType = attr[8]
-        for i in range(cImplType):
-            # Look for the [source, default] interface on the coclass
-            # that isn't marked as restricted.
-            flags = typeinfo.GetImplTypeFlags(i)
-            if (
-                flags
-                & (
-                    pythoncom.IMPLTYPEFLAG_FDEFAULT
-                    | pythoncom.IMPLTYPEFLAG_FSOURCE
-                    | pythoncom.IMPLTYPEFLAG_FRESTRICTED
-                )
-            ) == pythoncom.IMPLTYPEFLAG_FDEFAULT:
-                # Get the handle to the implemented interface.
-                href = typeinfo.GetRefTypeOfImplType(i)
-                defTypeInfo = typeinfo.GetRefTypeInfo(href)
-                attr = defTypeInfo.GetTypeAttr()
-                typeKind = attr[5]
-                typeFlags = attr[11]
-                if (
-                    typeKind == pythoncom.TKIND_INTERFACE
-                    and typeFlags & pythoncom.TYPEFLAG_FDUAL
-                ):
-                    # Get corresponding Disp interface
-                    # -1 is a special value which does this for us.
-                    href = typeinfo.GetRefTypeOfImplType(-1)
-                    return defTypeInfo.GetRefTypeInfo(href)
-                else:
-                    return defTypeInfo
-
-
-IActiveScriptMethods = [
-    "SetScriptSite",
-    "GetScriptSite",
-    "SetScriptState",
-    "GetScriptState",
-    "Close",
-    "AddNamedItem",
-    "AddTypeLib",
-    "GetScriptDispatch",
-    "GetCurrentScriptThreadID",
-    "GetScriptThreadID",
-    "GetScriptThreadState",
-    "InterruptScriptThread",
-    "Clone",
-]
-IActiveScriptParseMethods = ["InitNew", "AddScriptlet", "ParseScriptText"]
-IObjectSafetyMethods = ["GetInterfaceSafetyOptions", "SetInterfaceSafetyOptions"]
-
-# ActiveScriptParseProcedure is a new interface with IIS4/IE4.
-IActiveScriptParseProcedureMethods = ["ParseProcedureText"]
-
-
-class COMScript:
-    """An ActiveX Scripting engine base class.
-
-    This class implements the required COM interfaces for ActiveX scripting.
-    """
-
-    _public_methods_ = (
-        IActiveScriptMethods
-        + IActiveScriptParseMethods
-        + IObjectSafetyMethods
-        + IActiveScriptParseProcedureMethods
-    )
-    _com_interfaces_ = [
-        axscript.IID_IActiveScript,
-        axscript.IID_IActiveScriptParse,
-        axscript.IID_IObjectSafety,
-    ]  # , axscript.IID_IActiveScriptParseProcedure]
-
-    def __init__(self):
-        # Make sure we can print/trace wihout an exception!
-        MakeValidSysOuts()
-        # 		trace("AXScriptEngine object created", self)
-        self.baseThreadId = -1
-        self.debugManager = None
-        self.threadState = axscript.SCRIPTTHREADSTATE_NOTINSCRIPT
-        self.scriptState = axscript.SCRIPTSTATE_UNINITIALIZED
-        self.scriptSite = None
-        self.safetyOptions = 0
-        self.lcid = 0
-        self.subItems = {}
-        self.scriptCodeBlocks = {}
-
-    def _query_interface_(self, iid):
-        if self.debugManager:
-            return self.debugManager._query_interface_for_debugger_(iid)
-        # 		trace("ScriptEngine QI - unknown IID", iid)
-        return 0
-
-    # IActiveScriptParse
-    def InitNew(self):
-        if self.scriptSite is not None:
-            self.SetScriptState(axscript.SCRIPTSTATE_INITIALIZED)
-
-    def AddScriptlet(
-        self,
-        defaultName,
-        code,
-        itemName,
-        subItemName,
-        eventName,
-        delimiter,
-        sourceContextCookie,
-        startLineNumber,
-    ):
-        # 		trace ("AddScriptlet", defaultName, code, itemName, subItemName, eventName, delimiter, sourceContextCookie, startLineNumber)
-        self.DoAddScriptlet(
-            defaultName,
-            code,
-            itemName,
-            subItemName,
-            eventName,
-            delimiter,
-            sourceContextCookie,
-            startLineNumber,
-        )
-
-    def ParseScriptText(
-        self,
-        code,
-        itemName,
-        context,
-        delimiter,
-        sourceContextCookie,
-        startLineNumber,
-        flags,
-        bWantResult,
-    ):
-        # 		trace ("ParseScriptText", code[:20],"...", itemName, context, delimiter, sourceContextCookie, startLineNumber, flags, bWantResult)
-        if (
-            bWantResult
-            or self.scriptState == axscript.SCRIPTSTATE_STARTED
-            or self.scriptState == axscript.SCRIPTSTATE_CONNECTED
-            or self.scriptState == axscript.SCRIPTSTATE_DISCONNECTED
-        ):
-            flags = flags | SCRIPTTEXT_FORCEEXECUTION
-        else:
-            flags = flags & (~SCRIPTTEXT_FORCEEXECUTION)
-
-        if flags & SCRIPTTEXT_FORCEEXECUTION:
-            # About to execute the code.
-            self.RegisterNewNamedItems()
-        return self.DoParseScriptText(
-            code, sourceContextCookie, startLineNumber, bWantResult, flags
-        )
-
-    #
-    # IActiveScriptParseProcedure
-    def ParseProcedureText(
-        self,
-        code,
-        formalParams,
-        procName,
-        itemName,
-        unkContext,
-        delimiter,
-        contextCookie,
-        startingLineNumber,
-        flags,
-    ):
-        trace(
-            "ParseProcedureText",
-            code,
-            formalParams,
-            procName,
-            itemName,
-            unkContext,
-            delimiter,
-            contextCookie,
-            startingLineNumber,
-            flags,
-        )
-        # NOTE - this is never called, as we have disabled this interface.
-        # Problem is, once enabled all even code comes via here, rather than AddScriptlet.
-        # However, the "procName" is always an empty string - ie, itemName is the object whose event we are handling,
-        # but no idea what the specific event is!?
-        # Problem is disabling this block is that AddScriptlet is _not_ passed
-        # <SCRIPT for="whatever" event="onClick" language="Python">
-        # (but even for those blocks, the "onClick" information is still missing!?!?!?)
-
-        # 		self.DoAddScriptlet(None, code, itemName, subItemName, eventName, delimiter,sourceContextCookie, startLineNumber)
-        return None
-
-    #
-    # IActiveScript
-    def SetScriptSite(self, site):
-        # We should still work with an existing site (or so MSXML believes :)
-        self.scriptSite = site
-        if self.debugManager is not None:
-            self.debugManager.Close()
-        import traceback
-
-        try:
-            import win32com.axdebug.axdebug  # see if the core exists.
-
-            from . import debug
-
-            self.debugManager = debug.DebugManager(self)
-        except pythoncom.com_error:
-            # COM errors will occur if the debugger interface has never been
-            # seen on the target system
-            trace("Debugging interfaces not available - debugging is disabled..")
-            self.debugManager = None
-        except ImportError:
-            trace(
-                "Debugging extensions (axdebug) module does not exist - debugging is disabled.."
-            )
-            self.debugManager = None
-        except:
-            traceback.print_exc()
-            trace(
-                "*** Debugger Manager could not initialize - %s: %s"
-                % (sys.exc_info()[0], sys.exc_info()[1])
-            )
-            self.debugManager = None
-
-        try:
-            self.lcid = site.GetLCID()
-        except pythoncom.com_error:
-            self.lcid = win32api.GetUserDefaultLCID()
-        self.Reset()
-
-    def GetScriptSite(self, iid):
-        if self.scriptSite is None:
-            raise Exception(scode=winerror.S_FALSE)
-        return self.scriptSite.QueryInterface(iid)
-
-    def SetScriptState(self, state):
-        # print "SetScriptState with %s - currentstate = %s" % (state_map.get(state),state_map.get(self.scriptState))
-        if state == self.scriptState:
-            return
-        # If closed, allow no other state transitions
-        if self.scriptState == axscript.SCRIPTSTATE_CLOSED:
-            raise Exception(scode=winerror.E_INVALIDARG)
-
-        if state == axscript.SCRIPTSTATE_INITIALIZED:
-            # Re-initialize - shutdown then reset.
-            if self.scriptState in [
-                axscript.SCRIPTSTATE_CONNECTED,
-                axscript.SCRIPTSTATE_STARTED,
-            ]:
-                self.Stop()
-        elif state == axscript.SCRIPTSTATE_STARTED:
-            if self.scriptState == axscript.SCRIPTSTATE_CONNECTED:
-                self.Disconnect()
-            if self.scriptState == axscript.SCRIPTSTATE_DISCONNECTED:
-                self.Reset()
-            self.Run()
-            self.ChangeScriptState(axscript.SCRIPTSTATE_STARTED)
-        elif state == axscript.SCRIPTSTATE_CONNECTED:
-            if self.scriptState in [
-                axscript.SCRIPTSTATE_UNINITIALIZED,
-                axscript.SCRIPTSTATE_INITIALIZED,
-            ]:
-                self.ChangeScriptState(
-                    axscript.SCRIPTSTATE_STARTED
-                )  # report transition through started
-                self.Run()
-            if self.scriptState == axscript.SCRIPTSTATE_STARTED:
-                self.Connect()
-                self.ChangeScriptState(state)
-        elif state == axscript.SCRIPTSTATE_DISCONNECTED:
-            if self.scriptState == axscript.SCRIPTSTATE_CONNECTED:
-                self.Disconnect()
-        elif state == axscript.SCRIPTSTATE_CLOSED:
-            self.Close()
-        elif state == axscript.SCRIPTSTATE_UNINITIALIZED:
-            if self.scriptState == axscript.SCRIPTSTATE_STARTED:
-                self.Stop()
-            if self.scriptState == axscript.SCRIPTSTATE_CONNECTED:
-                self.Disconnect()
-            if self.scriptState == axscript.SCRIPTSTATE_DISCONNECTED:
-                self.Reset()
-            self.ChangeScriptState(state)
-        else:
-            raise Exception(scode=winerror.E_INVALIDARG)
-
-    def GetScriptState(self):
-        return self.scriptState
-
-    def Close(self):
-        # 		trace("Close")
-        if self.scriptState in [
-            axscript.SCRIPTSTATE_CONNECTED,
-            axscript.SCRIPTSTATE_DISCONNECTED,
-        ]:
-            self.Stop()
-        if self.scriptState in [
-            axscript.SCRIPTSTATE_CONNECTED,
-            axscript.SCRIPTSTATE_DISCONNECTED,
-            axscript.SCRIPTSTATE_INITIALIZED,
-            axscript.SCRIPTSTATE_STARTED,
-        ]:
-            pass  # engine.close??
-        if self.scriptState in [
-            axscript.SCRIPTSTATE_UNINITIALIZED,
-            axscript.SCRIPTSTATE_CONNECTED,
-            axscript.SCRIPTSTATE_DISCONNECTED,
-            axscript.SCRIPTSTATE_INITIALIZED,
-            axscript.SCRIPTSTATE_STARTED,
-        ]:
-            self.ChangeScriptState(axscript.SCRIPTSTATE_CLOSED)
-            # Completely reset all named items (including persistent)
-            for item in self.subItems.values():
-                item.Close()
-            self.subItems = {}
-            self.baseThreadId = -1
-        if self.debugManager:
-            self.debugManager.Close()
-            self.debugManager = None
-        self.scriptSite = None
-        self.scriptCodeBlocks = {}
-        self.persistLoaded = 0
-
-    def AddNamedItem(self, name, flags):
-        if self.scriptSite is None:
-            raise Exception(scode=winerror.E_INVALIDARG)
-        try:
-            unknown = self.scriptSite.GetItemInfo(name, axscript.SCRIPTINFO_IUNKNOWN)[0]
-            dispatch = unknown.QueryInterface(pythoncom.IID_IDispatch)
-        except pythoncom.com_error:
-            raise Exception(
-                scode=winerror.E_NOINTERFACE,
-                desc="Object has no dispatch interface available.",
-            )
-        newItem = self.subItems[name] = self.GetNamedItemClass()(
-            self, name, dispatch, flags
-        )
-        if newItem.IsGlobal():
-            newItem.CreateConnections()
-
-    def GetScriptDispatch(self, name):
-        # Base classes should override.
-        raise Exception(scode=winerror.E_NOTIMPL)
-
-    def GetCurrentScriptThreadID(self):
-        return self.baseThreadId
-
-    def GetScriptThreadID(self, win32ThreadId):
-        if self.baseThreadId == -1:
-            raise Exception(scode=winerror.E_UNEXPECTED)
-        if self.baseThreadId != win32ThreadId:
-            raise Exception(scode=winerror.E_INVALIDARG)
-        return self.baseThreadId
-
-    def GetScriptThreadState(self, scriptThreadId):
-        if self.baseThreadId == -1:
-            raise Exception(scode=winerror.E_UNEXPECTED)
-        if scriptThreadId != self.baseThreadId:
-            raise Exception(scode=winerror.E_INVALIDARG)
-        return self.threadState
-
-    def AddTypeLib(self, uuid, major, minor, flags):
-        # Get the win32com gencache to register this library.
-        from win32com.client import gencache
-
-        gencache.EnsureModule(uuid, self.lcid, major, minor, bForDemand=1)
-
-    # This is never called by the C++ framework - it does magic.
-    # See PyGActiveScript.cpp
-    # def InterruptScriptThread(self, stidThread, exc_info, flags):
-    # 	raise Exception("Not Implemented", scode=winerror.E_NOTIMPL)
-
-    def Clone(self):
-        raise Exception("Not Implemented", scode=winerror.E_NOTIMPL)
-
-    #
-    # IObjectSafety
-
-    # Note that IE seems to insist we say we support all the flags, even tho
-    # we dont accept them all.  If unknown flags come in, they are ignored, and never
-    # reflected in GetInterfaceSafetyOptions and the QIs obviously fail, but still IE
-    # allows our engine to initialize.
-    def SetInterfaceSafetyOptions(self, iid, optionsMask, enabledOptions):
-        # 		trace ("SetInterfaceSafetyOptions", iid, optionsMask, enabledOptions)
-        if optionsMask & enabledOptions == 0:
-            return
-
-        # See comments above.
-        # 		if (optionsMask & enabledOptions & \
-        # 			~(axscript.INTERFACESAFE_FOR_UNTRUSTED_DATA | axscript.INTERFACESAFE_FOR_UNTRUSTED_CALLER)):
-        # 			# request for options we don't understand
-        # 			RaiseAssert(scode=winerror.E_FAIL, desc="Unknown safety options")
-
-        if iid in [
-            pythoncom.IID_IPersist,
-            pythoncom.IID_IPersistStream,
-            pythoncom.IID_IPersistStreamInit,
-            axscript.IID_IActiveScript,
-            axscript.IID_IActiveScriptParse,
-        ]:
-            supported = self._GetSupportedInterfaceSafetyOptions()
-            self.safetyOptions = supported & optionsMask & enabledOptions
-        else:
-            raise Exception(scode=winerror.E_NOINTERFACE)
-
-    def _GetSupportedInterfaceSafetyOptions(self):
-        return 0
-
-    def GetInterfaceSafetyOptions(self, iid):
-        if iid in [
-            pythoncom.IID_IPersist,
-            pythoncom.IID_IPersistStream,
-            pythoncom.IID_IPersistStreamInit,
-            axscript.IID_IActiveScript,
-            axscript.IID_IActiveScriptParse,
-        ]:
-            supported = self._GetSupportedInterfaceSafetyOptions()
-            return supported, self.safetyOptions
-        else:
-            raise Exception(scode=winerror.E_NOINTERFACE)
-
-    #
-    # Other helpers.
-    def ExecutePendingScripts(self):
-        self.RegisterNewNamedItems()
-        self.DoExecutePendingScripts()
-
-    def ProcessScriptItemEvent(self, item, event, lcid, wFlags, args):
-        # 		trace("ProcessScriptItemEvent", item, event, lcid, wFlags, args)
-        self.RegisterNewNamedItems()
-        return self.DoProcessScriptItemEvent(item, event, lcid, wFlags, args)
-
-    def _DumpNamedItems_(self):
-        for item in self.subItems.values():
-            item._dump_(0)
-
-    def ResetNamedItems(self):
-        # Due to the way we work, we re-create persistent ones.
-        existing = self.subItems
-        self.subItems = {}
-        for name, item in existing.items():
-            item.Close()
-            if item.flags & axscript.SCRIPTITEM_ISPERSISTENT:
-                self.AddNamedItem(item.name, item.flags)
-
-    def GetCurrentSafetyOptions(self):
-        return self.safetyOptions
-
-    def ProcessNewNamedItemsConnections(self):
-        # Process all sub-items.
-        for item in self.subItems.values():
-            if not item.createdConnections:  # Fast-track!
-                item.CreateConnections()
-
-    def RegisterNewNamedItems(self):
-        # Register all sub-items.
-        for item in self.subItems.values():
-            if not item.isRegistered:  # Fast-track!
-                self.RegisterNamedItem(item)
-
-    def RegisterNamedItem(self, item):
-        item.Register()
-
-    def CheckConnectedOrDisconnected(self):
-        if self.scriptState in [
-            axscript.SCRIPTSTATE_CONNECTED,
-            axscript.SCRIPTSTATE_DISCONNECTED,
-        ]:
-            return
-        RaiseAssert(
-            winerror.E_UNEXPECTED,
-            "Not connected or disconnected - %d" % self.scriptState,
-        )
-
-    def Connect(self):
-        self.ProcessNewNamedItemsConnections()
-        self.RegisterNewNamedItems()
-        self.ConnectEventHandlers()
-
-    def Run(self):
-        # 		trace("AXScript running...")
-        if (
-            self.scriptState != axscript.SCRIPTSTATE_INITIALIZED
-            and self.scriptState != axscript.SCRIPTSTATE_STARTED
-        ):
-            raise Exception(scode=winerror.E_UNEXPECTED)
-        # 		self._DumpNamedItems_()
-        self.ExecutePendingScripts()
-        self.DoRun()
-
-    def Stop(self):
-        # Stop all executing scripts, and disconnect.
-        if self.scriptState == axscript.SCRIPTSTATE_CONNECTED:
-            self.Disconnect()
-        # Reset back to initialized.
-        self.Reset()
-
-    def Disconnect(self):
-        self.CheckConnectedOrDisconnected()
-        try:
-            self.DisconnectEventHandlers()
-        except pythoncom.com_error:
-            # Ignore errors when disconnecting.
-            pass
-
-        self.ChangeScriptState(axscript.SCRIPTSTATE_DISCONNECTED)
-
-    def ConnectEventHandlers(self):
-        # 		trace ("Connecting to event handlers")
-        for item in self.subItems.values():
-            item.Connect()
-        self.ChangeScriptState(axscript.SCRIPTSTATE_CONNECTED)
-
-    def DisconnectEventHandlers(self):
-        # 		trace ("Disconnecting from event handlers")
-        for item in self.subItems.values():
-            item.Disconnect()
-
-    def Reset(self):
-        # Keeping persistent engine state, reset back an initialized state
-        self.ResetNamedItems()
-        self.ChangeScriptState(axscript.SCRIPTSTATE_INITIALIZED)
-
-    def ChangeScriptState(self, state):
-        # print "  ChangeScriptState with %s - currentstate = %s" % (state_map.get(state),state_map.get(self.scriptState))
-        self.DisableInterrupts()
-        try:
-            self.scriptState = state
-            try:
-                if self.scriptSite:
-                    self.scriptSite.OnStateChange(state)
-            except pythoncom.com_error as xxx_todo_changeme:
-                (hr, desc, exc, arg) = xxx_todo_changeme.args
-                # Ignore all errors here - E_NOTIMPL likely from scriptlets.
-        finally:
-            self.EnableInterrupts()
-
-    # This stack frame is debugged - therefore we do as little as possible in it.
-    def _ApplyInScriptedSection(self, fn, args):
-        if self.debugManager:
-            self.debugManager.OnEnterScript()
-            if self.debugManager.adb.appDebugger:
-                return self.debugManager.adb.runcall(fn, *args)
-            else:
-                return fn(*args)
-        else:
-            return fn(*args)
-
-    def ApplyInScriptedSection(self, codeBlock, fn, args):
-        self.BeginScriptedSection()
-        try:
-            try:
-                # 				print "ApplyInSS", codeBlock, fn, args
-                return self._ApplyInScriptedSection(fn, args)
-            finally:
-                if self.debugManager:
-                    self.debugManager.OnLeaveScript()
-                self.EndScriptedSection()
-        except:
-            self.HandleException(codeBlock)
-
-    # This stack frame is debugged - therefore we do as little as possible in it.
-    def _CompileInScriptedSection(self, code, name, type):
-        if self.debugManager:
-            self.debugManager.OnEnterScript()
-        return compile(code, name, type)
-
-    def CompileInScriptedSection(self, codeBlock, type, realCode=None):
-        if codeBlock.codeObject is not None:  # already compiled
-            return 1
-        if realCode is None:
-            code = codeBlock.codeText
-        else:
-            code = realCode
-        name = codeBlock.GetFileName()
-        self.BeginScriptedSection()
-        try:
-            try:
-                codeObject = self._CompileInScriptedSection(RemoveCR(code), name, type)
-                codeBlock.codeObject = codeObject
-                return 1
-            finally:
-                if self.debugManager:
-                    self.debugManager.OnLeaveScript()
-                self.EndScriptedSection()
-        except:
-            self.HandleException(codeBlock)
-
-    # This stack frame is debugged - therefore we do as little as possible in it.
-    def _ExecInScriptedSection(self, codeObject, globals, locals=None):
-        if self.debugManager:
-            self.debugManager.OnEnterScript()
-            if self.debugManager.adb.appDebugger:
-                return self.debugManager.adb.run(codeObject, globals, locals)
-            else:
-                exec(codeObject, globals, locals)
-        else:
-            exec(codeObject, globals, locals)
-
-    def ExecInScriptedSection(self, codeBlock, globals, locals=None):
-        if locals is None:
-            locals = globals
-        assert (
-            not codeBlock.beenExecuted
-        ), "This code block should not have been executed"
-        codeBlock.beenExecuted = 1
-        self.BeginScriptedSection()
-        try:
-            try:
-                self._ExecInScriptedSection(codeBlock.codeObject, globals, locals)
-            finally:
-                if self.debugManager:
-                    self.debugManager.OnLeaveScript()
-                self.EndScriptedSection()
-        except:
-            self.HandleException(codeBlock)
-
-    def _EvalInScriptedSection(self, codeBlock, globals, locals=None):
-        if self.debugManager:
-            self.debugManager.OnEnterScript()
-            if self.debugManager.adb.appDebugger:
-                return self.debugManager.adb.runeval(codeBlock, globals, locals)
-            else:
-                return eval(codeBlock, globals, locals)
-        else:
-            return eval(codeBlock, globals, locals)
-
-    def EvalInScriptedSection(self, codeBlock, globals, locals=None):
-        if locals is None:
-            locals = globals
-        assert (
-            not codeBlock.beenExecuted
-        ), "This code block should not have been executed"
-        codeBlock.beenExecuted = 1
-        self.BeginScriptedSection()
-        try:
-            try:
-                return self._EvalInScriptedSection(
-                    codeBlock.codeObject, globals, locals
-                )
-            finally:
-                if self.debugManager:
-                    self.debugManager.OnLeaveScript()
-                self.EndScriptedSection()
-        except:
-            self.HandleException(codeBlock)
-
-    def HandleException(self, codeBlock):
-        # NOTE - Never returns - raises a ComException
-        exc_type, exc_value, exc_traceback = sys.exc_info()
-        # If a SERVER exception, re-raise it.  If a client side COM error, it is
-        # likely to have originated from the script code itself, and therefore
-        # needs to be reported like any other exception.
-        if IsCOMServerException(exc_type):
-            # Ensure the traceback doesnt cause a cycle.
-            exc_traceback = None
-            raise
-        # It could be an error by another script.
-        if (
-            issubclass(pythoncom.com_error, exc_type)
-            and exc_value.hresult == axscript.SCRIPT_E_REPORTED
-        ):
-            # Ensure the traceback doesnt cause a cycle.
-            exc_traceback = None
-            raise Exception(scode=exc_value.hresult)
-
-        exception = error.AXScriptException(
-            self, codeBlock, exc_type, exc_value, exc_traceback
-        )
-
-        # Ensure the traceback doesnt cause a cycle.
-        exc_traceback = None
-        result_exception = error.ProcessAXScriptException(
-            self.scriptSite, self.debugManager, exception
-        )
-        if result_exception is not None:
-            try:
-                self.scriptSite.OnScriptTerminate(None, result_exception)
-            except pythoncom.com_error:
-                pass  # Ignore errors telling engine we stopped.
-            # reset ourselves to 'connected' so further events continue to fire.
-            self.SetScriptState(axscript.SCRIPTSTATE_CONNECTED)
-            raise result_exception
-        # I think that in some cases this should just return - but the code
-        # that could return None above is disabled, so it never happens.
-        RaiseAssert(
-            winerror.E_UNEXPECTED, "Don't have an exception to raise to the caller!"
-        )
-
-    def BeginScriptedSection(self):
-        if self.scriptSite is None:
-            raise Exception(scode=winerror.E_UNEXPECTED)
-        self.scriptSite.OnEnterScript()
-
-    def EndScriptedSection(self):
-        if self.scriptSite is None:
-            raise Exception(scode=winerror.E_UNEXPECTED)
-        self.scriptSite.OnLeaveScript()
-
-    def DisableInterrupts(self):
-        pass
-
-    def EnableInterrupts(self):
-        pass
-
-    def GetNamedItem(self, name):
-        try:
-            return self.subItems[name]
-        except KeyError:
-            raise Exception(scode=winerror.E_INVALIDARG)
-
-    def GetNamedItemClass(self):
-        return ScriptItem
-
-    def _AddScriptCodeBlock(self, codeBlock):
-        self.scriptCodeBlocks[codeBlock.GetFileName()] = codeBlock
-        if self.debugManager:
-            self.debugManager.AddScriptBlock(codeBlock)
-
-
-if __name__ == "__main__":
-    print("This is a framework class - please use pyscript.py etc")
-
-
-def dumptypeinfo(typeinfo):
-    return
-    attr = typeinfo.GetTypeAttr()
-    # Loop over all methods
-    print("Methods")
-    for j in range(attr[6]):
-        fdesc = list(typeinfo.GetFuncDesc(j))
-        id = fdesc[0]
-        try:
-            names = typeinfo.GetNames(id)
-        except pythoncom.ole_error:
-            names = None
-        doc = typeinfo.GetDocumentation(id)
-
-        print(" ", names, "has attr", fdesc)
-
-    # Loop over all variables (ie, properties)
-    print("Variables")
-    for j in range(attr[7]):
-        fdesc = list(typeinfo.GetVarDesc(j))
-        names = typeinfo.GetNames(id)
-        print(" ", names, "has attr", fdesc)
diff --git a/lib/win32comext/axscript/client/pydumper.py b/lib/win32comext/axscript/client/pydumper.py
deleted file mode 100644
index 3d0725ae..00000000
--- a/lib/win32comext/axscript/client/pydumper.py
+++ /dev/null
@@ -1,77 +0,0 @@
-# pydumper.py
-#
-# This is being worked on - it does not yet work at all, in ay way
-# shape or form :-)
-#
-# A new script engine, derived from the standard scripting engine,
-# which dumps information.
-
-# This generally can be used to grab all sorts of useful details about
-# an engine - expose bugs in it or Python, dump the object model, etc.
-
-# As it is derived from the standard engine, it fully supports Python
-# as a scripting language - meaning the dumps produced can be quite dynamic,
-# and based on the script code you execute.
-
-from win32com.axscript import axscript
-
-from . import pyscript
-from .pyscript import SCRIPTTEXT_FORCEEXECUTION, Exception, RaiseAssert, trace
-
-PyDump_CLSID = "{ac527e60-c693-11d0-9c25-00aa00125a98}"
-
-
-class AXScriptAttribute(pyscript.AXScriptAttribute):
-    pass
-
-
-class NamedScriptAttribute(pyscript.NamedScriptAttribute):
-    pass
-
-
-class PyScript(pyscript.PyScript):
-    pass
-
-
-def Register():
-    import sys
-
-    if "-d" in sys.argv:
-        dispatcher = "DispatcherWin32trace"
-        debug_desc = " (" + dispatcher + ")"
-        debug_option = "Yes"
-    else:
-        dispatcher = None
-        debug_desc = ""
-        debug_option = ""
-
-    categories = [axscript.CATID_ActiveScript, axscript.CATID_ActiveScriptParse]
-    clsid = PyDump_CLSID
-    lcid = 0x0409  # // english
-    policy = None  # "win32com.axscript.client.axspolicy.AXScriptPolicy"
-
-    print("Registering COM server%s..." % debug_desc)
-    from win32com.server.register import RegisterServer
-
-    languageName = "PyDump"
-    verProgId = "Python.Dumper.1"
-    RegisterServer(
-        clsid=clsid,
-        pythonInstString="win32com.axscript.client.pyscript.PyDumper",
-        className="Python Debugging/Dumping ActiveX Scripting Engine",
-        progID=languageName,
-        verProgID=verProgId,
-        catids=categories,
-        policy=policy,
-        dispatcher=dispatcher,
-    )
-
-    CreateRegKey(languageName + "\\OLEScript")
-    # Basic Registration for wsh.
-    win32com.server.register._set_string(".pysDump", "pysDumpFile")
-    win32com.server.register._set_string("pysDumpFile\\ScriptEngine", languageName)
-    print("Dumping Server registered.")
-
-
-if __name__ == "__main__":
-    Register()
diff --git a/lib/win32comext/axscript/client/pyscript.py b/lib/win32comext/axscript/client/pyscript.py
deleted file mode 100644
index d2b21b58..00000000
--- a/lib/win32comext/axscript/client/pyscript.py
+++ /dev/null
@@ -1,443 +0,0 @@
-"""Python ActiveX Scripting Implementation
-
-This module implements the Python ActiveX Scripting client.
-
-To register the implementation, simply "run" this Python program - ie
-either double-click on it, or run "python.exe pyscript.py" from the
-command line.
-"""
-
-import re
-
-import pythoncom
-import win32api
-import win32com
-import win32com.client.dynamic
-import win32com.server.register
-import winerror
-from win32com.axscript import axscript
-from win32com.axscript.client import framework, scriptdispatch
-from win32com.axscript.client.framework import (
-    SCRIPTTEXT_FORCEEXECUTION,
-    SCRIPTTEXT_ISEXPRESSION,
-    SCRIPTTEXT_ISPERSISTENT,
-    Exception,
-    RaiseAssert,
-    trace,
-)
-
-PyScript_CLSID = "{DF630910-1C1D-11d0-AE36-8C0F5E000000}"
-
-debugging_attr = 0
-
-
-def debug_attr_print(*args):
-    if debugging_attr:
-        trace(*args)
-
-
-def ExpandTabs(text):
-    return re.sub("\t", "    ", text)
-
-
-def AddCR(text):
-    return re.sub("\n", "\r\n", text)
-
-
-class AXScriptCodeBlock(framework.AXScriptCodeBlock):
-    def GetDisplayName(self):
-        return "PyScript - " + framework.AXScriptCodeBlock.GetDisplayName(self)
-
-
-# There is only ever _one_ ax object - it exists in the global namespace
-# for all script items.
-# It performs a search from all global/visible objects
-# down.
-# This means that if 2 sub-objects of the same name are used
-# then only one is ever reachable using the ax shortcut.
-class AXScriptAttribute:
-    "An attribute in a scripts namespace."
-
-    def __init__(self, engine):
-        self.__dict__["_scriptEngine_"] = engine
-
-    def __getattr__(self, attr):
-        if attr[1] == "_" and attr[:-1] == "_":
-            raise AttributeError(attr)
-        rc = self._FindAttribute_(attr)
-        if rc is None:
-            raise AttributeError(attr)
-        return rc
-
-    def _Close_(self):
-        self.__dict__["_scriptEngine_"] = None
-
-    def _DoFindAttribute_(self, obj, attr):
-        try:
-            return obj.subItems[attr.lower()].attributeObject
-        except KeyError:
-            pass
-        # Check out the sub-items
-        for item in obj.subItems.values():
-            try:
-                return self._DoFindAttribute_(item, attr)
-            except AttributeError:
-                pass
-        raise AttributeError(attr)
-
-    def _FindAttribute_(self, attr):
-        for item in self._scriptEngine_.subItems.values():
-            try:
-                return self._DoFindAttribute_(item, attr)
-            except AttributeError:
-                pass
-        # All else fails, see if it is a global
-        # (mainly b/w compat)
-        return getattr(self._scriptEngine_.globalNameSpaceModule, attr)
-
-
-# 		raise AttributeError(attr)
-
-
-class NamedScriptAttribute:
-    "An explicitely named object in an objects namespace"
-
-    # Each named object holds a reference to one of these.
-    # Whenever a sub-item appears in a namespace, it is really one of these
-    # objects.  Has a circular reference back to the item itself, which is
-    # closed via _Close_()
-    def __init__(self, scriptItem):
-        self.__dict__["_scriptItem_"] = scriptItem
-
-    def __repr__(self):
-        return "<NamedItemAttribute" + repr(self._scriptItem_) + ">"
-
-    def __getattr__(self, attr):
-        # If a known subitem, return it.
-        try:
-            return self._scriptItem_.subItems[attr.lower()].attributeObject
-        except KeyError:
-            # Otherwise see if the dispatch can give it to us
-            if self._scriptItem_.dispatchContainer:
-                return getattr(self._scriptItem_.dispatchContainer, attr)
-        raise AttributeError(attr)
-
-    def __setattr__(self, attr, value):
-        # XXX - todo - if a known item, then should call its default
-        # dispatch method.
-        attr = attr.lower()
-        if self._scriptItem_.dispatchContainer:
-            try:
-                return setattr(self._scriptItem_.dispatchContainer, attr, value)
-            except AttributeError:
-                pass
-        raise AttributeError(attr)
-
-    def _Close_(self):
-        self.__dict__["_scriptItem_"] = None
-
-
-class ScriptItem(framework.ScriptItem):
-    def __init__(self, parentItem, name, dispatch, flags):
-        framework.ScriptItem.__init__(self, parentItem, name, dispatch, flags)
-        self.scriptlets = {}
-        self.attributeObject = None
-
-    def Reset(self):
-        framework.ScriptItem.Reset(self)
-        if self.attributeObject:
-            self.attributeObject._Close_()
-        self.attributeObject = None
-
-    def Close(self):
-        framework.ScriptItem.Close(self)  # calls reset.
-        self.dispatchContainer = None
-        self.scriptlets = {}
-
-    def Register(self):
-        framework.ScriptItem.Register(self)
-        self.attributeObject = NamedScriptAttribute(self)
-        if self.dispatch:
-            # Need to avoid the new Python "lazy" dispatch behaviour.
-            try:
-                engine = self.GetEngine()
-                olerepr = clsid = None
-                typeinfo = self.dispatch.GetTypeInfo()
-                clsid = typeinfo.GetTypeAttr()[0]
-                try:
-                    olerepr = engine.mapKnownCOMTypes[clsid]
-                except KeyError:
-                    pass
-            except pythoncom.com_error:
-                typeinfo = None
-            if olerepr is None:
-                olerepr = win32com.client.dynamic.MakeOleRepr(
-                    self.dispatch, typeinfo, None
-                )
-                if clsid is not None:
-                    engine.mapKnownCOMTypes[clsid] = olerepr
-            self.dispatchContainer = win32com.client.dynamic.CDispatch(
-                self.dispatch, olerepr, self.name
-            )
-
-
-# 			self.dispatchContainer = win32com.client.dynamic.Dispatch(self.dispatch, userName = self.name)
-# 			self.dispatchContainer = win32com.client.dynamic.DumbDispatch(self.dispatch, userName = self.name)
-
-# 	def Connect(self):
-# 		framework.ScriptItem.Connect(self)
-# 	def Disconnect(self):
-# 		framework.ScriptItem.Disconnect(self)
-
-
-class PyScript(framework.COMScript):
-    # Setup the auto-registration stuff...
-    _reg_verprogid_ = "Python.AXScript.2"
-    _reg_progid_ = "Python"
-    # 	_reg_policy_spec_ = default
-    _reg_catids_ = [axscript.CATID_ActiveScript, axscript.CATID_ActiveScriptParse]
-    _reg_desc_ = "Python ActiveX Scripting Engine"
-    _reg_clsid_ = PyScript_CLSID
-    _reg_class_spec_ = "win32com.axscript.client.pyscript.PyScript"
-    _reg_remove_keys_ = [(".pys",), ("pysFile",)]
-    _reg_threading_ = "both"
-
-    def __init__(self):
-        framework.COMScript.__init__(self)
-        self.globalNameSpaceModule = None
-        self.codeBlocks = []
-        self.scriptDispatch = None
-
-    def InitNew(self):
-        framework.COMScript.InitNew(self)
-        import imp
-
-        self.scriptDispatch = None
-        self.globalNameSpaceModule = imp.new_module("__ax_main__")
-        self.globalNameSpaceModule.__dict__["ax"] = AXScriptAttribute(self)
-
-        self.codeBlocks = []
-        self.persistedCodeBlocks = []
-        self.mapKnownCOMTypes = {}  # Map of known CLSID to typereprs
-        self.codeBlockCounter = 0
-
-    def Stop(self):
-        # Flag every pending script as already done
-        for b in self.codeBlocks:
-            b.beenExecuted = 1
-        return framework.COMScript.Stop(self)
-
-    def Reset(self):
-        # Reset all code-blocks that are persistent, and discard the rest
-        oldCodeBlocks = self.codeBlocks[:]
-        self.codeBlocks = []
-        for b in oldCodeBlocks:
-            if b.flags & SCRIPTTEXT_ISPERSISTENT:
-                b.beenExecuted = 0
-                self.codeBlocks.append(b)
-        return framework.COMScript.Reset(self)
-
-    def _GetNextCodeBlockNumber(self):
-        self.codeBlockCounter = self.codeBlockCounter + 1
-        return self.codeBlockCounter
-
-    def RegisterNamedItem(self, item):
-        wasReg = item.isRegistered
-        framework.COMScript.RegisterNamedItem(self, item)
-        if not wasReg:
-            # Insert into our namespace.
-            # Add every item by name
-            if item.IsVisible():
-                self.globalNameSpaceModule.__dict__[item.name] = item.attributeObject
-            if item.IsGlobal():
-                # Global items means sub-items are also added...
-                for subitem in item.subItems.values():
-                    self.globalNameSpaceModule.__dict__[
-                        subitem.name
-                    ] = subitem.attributeObject
-                # Also add all methods
-                for name, entry in item.dispatchContainer._olerepr_.mapFuncs.items():
-                    if not entry.hidden:
-                        self.globalNameSpaceModule.__dict__[name] = getattr(
-                            item.dispatchContainer, name
-                        )
-
-    def DoExecutePendingScripts(self):
-        try:
-            globs = self.globalNameSpaceModule.__dict__
-            for codeBlock in self.codeBlocks:
-                if not codeBlock.beenExecuted:
-                    if self.CompileInScriptedSection(codeBlock, "exec"):
-                        self.ExecInScriptedSection(codeBlock, globs)
-        finally:
-            pass
-
-    def DoRun(self):
-        pass
-
-    def Close(self):
-        self.ResetNamespace()
-        self.globalNameSpaceModule = None
-        self.codeBlocks = []
-        self.scriptDispatch = None
-        framework.COMScript.Close(self)
-
-    def GetScriptDispatch(self, name):
-        # 		trace("GetScriptDispatch with", name)
-        # 		if name is not None: return None
-        if self.scriptDispatch is None:
-            self.scriptDispatch = scriptdispatch.MakeScriptDispatch(
-                self, self.globalNameSpaceModule
-            )
-        return self.scriptDispatch
-
-    def MakeEventMethodName(self, subItemName, eventName):
-        return (
-            subItemName[0].upper()
-            + subItemName[1:]
-            + "_"
-            + eventName[0].upper()
-            + eventName[1:]
-        )
-
-    def DoAddScriptlet(
-        self,
-        defaultName,
-        code,
-        itemName,
-        subItemName,
-        eventName,
-        delimiter,
-        sourceContextCookie,
-        startLineNumber,
-    ):
-        # Just store the code away - compile when called.  (JIT :-)
-        item = self.GetNamedItem(itemName)
-        if (
-            itemName == subItemName
-        ):  # Explicit handlers - eg <SCRIPT LANGUAGE="Python" for="TestForm" Event="onSubmit">
-            subItem = item
-        else:
-            subItem = item.GetCreateSubItem(item, subItemName, None, None)
-        funcName = self.MakeEventMethodName(subItemName, eventName)
-
-        codeBlock = AXScriptCodeBlock(
-            "Script Event %s" % funcName, code, sourceContextCookie, startLineNumber, 0
-        )
-        self._AddScriptCodeBlock(codeBlock)
-        subItem.scriptlets[funcName] = codeBlock
-
-    def DoProcessScriptItemEvent(self, item, event, lcid, wFlags, args):
-        # 		trace("ScriptItemEvent", self, item, event, event.name, lcid, wFlags, args)
-        funcName = self.MakeEventMethodName(item.name, event.name)
-        codeBlock = function = None
-        try:
-            function = item.scriptlets[funcName]
-            if type(function) == type(self):  # ie, is a CodeBlock instance
-                codeBlock = function
-                function = None
-        except KeyError:
-            pass
-        if codeBlock is not None:
-            realCode = "def %s():\n" % funcName
-            for line in framework.RemoveCR(codeBlock.codeText).split("\n"):
-                realCode = realCode + "\t" + line + "\n"
-            realCode = realCode + "\n"
-            if not self.CompileInScriptedSection(codeBlock, "exec", realCode):
-                return
-            dict = {}
-            self.ExecInScriptedSection(
-                codeBlock, self.globalNameSpaceModule.__dict__, dict
-            )
-            function = dict[funcName]
-            # cache back in scriptlets as a function.
-            item.scriptlets[funcName] = function
-        if function is None:
-            # still no function - see if in the global namespace.
-            try:
-                function = self.globalNameSpaceModule.__dict__[funcName]
-            except KeyError:
-                # Not there _exactly_ - do case ins search.
-                funcNameLook = funcName.lower()
-                for attr in self.globalNameSpaceModule.__dict__.keys():
-                    if funcNameLook == attr.lower():
-                        function = self.globalNameSpaceModule.__dict__[attr]
-                        # cache back in scriptlets, to avoid this overhead next time
-                        item.scriptlets[funcName] = function
-
-        if function is None:
-            raise Exception(scode=winerror.DISP_E_MEMBERNOTFOUND)
-        return self.ApplyInScriptedSection(codeBlock, function, args)
-
-    def DoParseScriptText(
-        self, code, sourceContextCookie, startLineNumber, bWantResult, flags
-    ):
-        code = framework.RemoveCR(code) + "\n"
-        if flags & SCRIPTTEXT_ISEXPRESSION:
-            name = "Script Expression"
-            exec_type = "eval"
-        else:
-            name = "Script Block"
-            exec_type = "exec"
-        num = self._GetNextCodeBlockNumber()
-        if num == 1:
-            num = ""
-        name = "%s %s" % (name, num)
-        codeBlock = AXScriptCodeBlock(
-            name, code, sourceContextCookie, startLineNumber, flags
-        )
-        self._AddScriptCodeBlock(codeBlock)
-        globs = self.globalNameSpaceModule.__dict__
-        if bWantResult:  # always immediate.
-            if self.CompileInScriptedSection(codeBlock, exec_type):
-                if flags & SCRIPTTEXT_ISEXPRESSION:
-                    return self.EvalInScriptedSection(codeBlock, globs)
-                else:
-                    return self.ExecInScriptedSection(codeBlock, globs)
-
-            # else compile failed, but user chose to keep running...
-        else:
-            if flags & SCRIPTTEXT_FORCEEXECUTION:
-                if self.CompileInScriptedSection(codeBlock, exec_type):
-                    self.ExecInScriptedSection(codeBlock, globs)
-            else:
-                self.codeBlocks.append(codeBlock)
-
-    def GetNamedItemClass(self):
-        return ScriptItem
-
-    def ResetNamespace(self):
-        if self.globalNameSpaceModule is not None:
-            try:
-                self.globalNameSpaceModule.ax._Reset_()
-            except AttributeError:
-                pass  # ???
-            globalNameSpaceModule = None
-
-
-def DllRegisterServer():
-    klass = PyScript
-    win32com.server.register._set_subkeys(
-        klass._reg_progid_ + "\\OLEScript", {}
-    )  # Just a CreateKey
-    # Basic Registration for wsh.
-    win32com.server.register._set_string(".pys", "pysFile")
-    win32com.server.register._set_string("pysFile\\ScriptEngine", klass._reg_progid_)
-    guid_wsh_shellex = "{60254CA5-953B-11CF-8C96-00AA00B8708C}"
-    win32com.server.register._set_string(
-        "pysFile\\ShellEx\\DropHandler", guid_wsh_shellex
-    )
-    win32com.server.register._set_string(
-        "pysFile\\ShellEx\\PropertySheetHandlers\\WSHProps", guid_wsh_shellex
-    )
-
-
-def Register(klass=PyScript):
-    ret = win32com.server.register.UseCommandLine(
-        klass, finalize_register=DllRegisterServer
-    )
-    return ret
-
-
-if __name__ == "__main__":
-    Register()
diff --git a/lib/win32comext/axscript/client/pyscript_rexec.py b/lib/win32comext/axscript/client/pyscript_rexec.py
deleted file mode 100644
index a07b5a16..00000000
--- a/lib/win32comext/axscript/client/pyscript_rexec.py
+++ /dev/null
@@ -1,49 +0,0 @@
-# A version of the ActiveScripting engine that enables rexec support
-# This version supports hosting by IE - however, due to Python's
-# rexec module being neither completely trusted nor private, it is
-# *not* enabled by default.
-# As of Python 2.2, rexec is simply not available - thus, if you use this,
-# a HTML page can do almost *anything* at all on your machine.
-
-# You almost certainly do NOT want to use thus!
-
-import pythoncom
-from win32com.axscript import axscript
-
-from . import pyscript
-
-INTERFACE_USES_DISPEX = 0x00000004  # Object knows to use IDispatchEx
-INTERFACE_USES_SECURITY_MANAGER = (
-    0x00000008  # Object knows to use IInternetHostSecurityManager
-)
-
-
-class PyScriptRExec(pyscript.PyScript):
-    # Setup the auto-registration stuff...
-    _reg_verprogid_ = "Python.AXScript-rexec.2"
-    _reg_progid_ = "Python"  # Same ProgID as the standard engine.
-    # 	_reg_policy_spec_ = default
-    _reg_catids_ = [axscript.CATID_ActiveScript, axscript.CATID_ActiveScriptParse]
-    _reg_desc_ = "Python ActiveX Scripting Engine (with rexec support)"
-    _reg_clsid_ = "{69c2454b-efa2-455b-988c-c3651c4a2f69}"
-    _reg_class_spec_ = "win32com.axscript.client.pyscript_rexec.PyScriptRExec"
-    _reg_remove_keys_ = [(".pys",), ("pysFile",)]
-    _reg_threading_ = "Apartment"
-
-    def _GetSupportedInterfaceSafetyOptions(self):
-        # print "**** calling", pyscript.PyScript._GetSupportedInterfaceSafetyOptions, "**->", pyscript.PyScript._GetSupportedInterfaceSafetyOptions(self)
-        return (
-            INTERFACE_USES_DISPEX
-            | INTERFACE_USES_SECURITY_MANAGER
-            | axscript.INTERFACESAFE_FOR_UNTRUSTED_DATA
-            | axscript.INTERFACESAFE_FOR_UNTRUSTED_CALLER
-        )
-
-
-if __name__ == "__main__":
-    print("WARNING: By registering this engine, you are giving remote HTML code")
-    print("the ability to execute *any* code on your system.")
-    print()
-    print("You almost certainly do NOT want to do this.")
-    print("You have been warned, and are doing this at your own (significant) risk")
-    pyscript.Register(PyScriptRExec)
diff --git a/lib/win32comext/axscript/client/scriptdispatch.py b/lib/win32comext/axscript/client/scriptdispatch.py
deleted file mode 100644
index 525326e7..00000000
--- a/lib/win32comext/axscript/client/scriptdispatch.py
+++ /dev/null
@@ -1,115 +0,0 @@
-"""dynamic dispatch objects for AX Script.
-
- This is an IDispatch object that a scripting host may use to
- query and invoke methods on the main script.  Not may hosts use
- this yet, so it is not well tested!
-"""
-
-import types
-
-import pythoncom
-import win32com.server.policy
-import win32com.server.util
-import winerror
-from win32com.axscript import axscript
-from win32com.client import Dispatch
-from win32com.server.exception import COMException
-
-debugging = 0
-
-PyIDispatchType = pythoncom.TypeIIDs[pythoncom.IID_IDispatch]
-
-
-def _is_callable(obj):
-    return type(obj) in [types.FunctionType, types.MethodType]
-    # ignore hasattr(obj, "__call__") as this means all COM objects!
-
-
-class ScriptDispatch:
-    _public_methods_ = []
-
-    def __init__(self, engine, scriptNamespace):
-        self.engine = engine
-        self.scriptNamespace = scriptNamespace
-
-    def _dynamic_(self, name, lcid, wFlags, args):
-        # Ensure any newly added items are available.
-        self.engine.RegisterNewNamedItems()
-        self.engine.ProcessNewNamedItemsConnections()
-        if wFlags & pythoncom.INVOKE_FUNC:
-            # attempt to call a function
-            try:
-                func = getattr(self.scriptNamespace, name)
-                if not _is_callable(func):
-                    raise AttributeError(name)  # Not a function.
-                realArgs = []
-                for arg in args:
-                    if type(arg) == PyIDispatchType:
-                        realArgs.append(Dispatch(arg))
-                    else:
-                        realArgs.append(arg)
-                # xxx - todo - work out what code block to pass???
-                return self.engine.ApplyInScriptedSection(None, func, tuple(realArgs))
-
-            except AttributeError:
-                if not wFlags & pythoncom.DISPATCH_PROPERTYGET:
-                    raise COMException(scode=winerror.DISP_E_MEMBERNOTFOUND)
-        if wFlags & pythoncom.DISPATCH_PROPERTYGET:
-            # attempt to get a property
-            try:
-                ret = getattr(self.scriptNamespace, name)
-                if _is_callable(ret):
-                    raise AttributeError(name)  # Not a property.
-            except AttributeError:
-                raise COMException(scode=winerror.DISP_E_MEMBERNOTFOUND)
-            except COMException as instance:
-                raise
-            except:
-                ret = self.engine.HandleException()
-            return ret
-
-        raise COMException(scode=winerror.DISP_E_MEMBERNOTFOUND)
-
-
-class StrictDynamicPolicy(win32com.server.policy.DynamicPolicy):
-    def _wrap_(self, object):
-        win32com.server.policy.DynamicPolicy._wrap_(self, object)
-        if hasattr(self._obj_, "scriptNamespace"):
-            for name in dir(self._obj_.scriptNamespace):
-                self._dyn_dispid_to_name_[self._getdispid_(name, 0)] = name
-
-    def _getmembername_(self, dispid):
-        try:
-            return str(self._dyn_dispid_to_name_[dispid])
-        except KeyError:
-            raise COMException(scode=winerror.DISP_E_UNKNOWNNAME, desc="Name not found")
-
-    def _getdispid_(self, name, fdex):
-        try:
-            func = getattr(self._obj_.scriptNamespace, str(name))
-        except AttributeError:
-            raise COMException(scode=winerror.DISP_E_MEMBERNOTFOUND)
-        # 		if not _is_callable(func):
-        return win32com.server.policy.DynamicPolicy._getdispid_(self, name, fdex)
-
-
-def _wrap_debug(obj):
-    return win32com.server.util.wrap(
-        obj,
-        usePolicy=StrictDynamicPolicy,
-        useDispatcher=win32com.server.policy.DispatcherWin32trace,
-    )
-
-
-def _wrap_nodebug(obj):
-    return win32com.server.util.wrap(obj, usePolicy=StrictDynamicPolicy)
-
-
-if debugging:
-    _wrap = _wrap_debug
-else:
-    _wrap = _wrap_nodebug
-
-
-def MakeScriptDispatch(engine, namespace):
-    return _wrap(ScriptDispatch(engine, namespace))
diff --git a/lib/win32comext/axscript/server/__init__.py b/lib/win32comext/axscript/server/__init__.py
deleted file mode 100644
index e69de29b..00000000
diff --git a/lib/win32comext/axscript/server/axsite.py b/lib/win32comext/axscript/server/axsite.py
deleted file mode 100644
index d07ed120..00000000
--- a/lib/win32comext/axscript/server/axsite.py
+++ /dev/null
@@ -1,145 +0,0 @@
-import pythoncom
-import win32com.axscript.axscript
-import winerror
-from win32com.axscript import axscript
-from win32com.server import exception, util
-
-
-class AXEngine:
-    def __init__(self, site, engine):
-        self.eScript = self.eParse = self.eSafety = None
-        if type(engine) == type(""):
-            engine = pythoncom.CoCreateInstance(
-                engine, None, pythoncom.CLSCTX_SERVER, pythoncom.IID_IUnknown
-            )
-
-        self.eScript = engine.QueryInterface(axscript.IID_IActiveScript)
-        self.eParse = engine.QueryInterface(axscript.IID_IActiveScriptParse)
-        self.eSafety = engine.QueryInterface(axscript.IID_IObjectSafety)
-
-        self.eScript.SetScriptSite(site)
-        self.eParse.InitNew()
-
-    def __del__(self):
-        self.Close()
-
-    def GetScriptDispatch(self, name=None):
-        return self.eScript.GetScriptDispatch(name)
-
-    def AddNamedItem(self, item, flags):
-        return self.eScript.AddNamedItem(item, flags)
-
-    # Some helpers.
-    def AddCode(self, code, flags=0):
-        self.eParse.ParseScriptText(code, None, None, None, 0, 0, flags)
-
-    def EvalCode(self, code):
-        return self.eParse.ParseScriptText(
-            code, None, None, None, 0, 0, axscript.SCRIPTTEXT_ISEXPRESSION
-        )
-
-    def Start(self):
-        # Should maybe check state?
-        # Do I need to transition through?
-        self.eScript.SetScriptState(axscript.SCRIPTSTATE_STARTED)
-
-    #    self.eScript.SetScriptState(axscript.SCRIPTSTATE_CONNECTED)
-
-    def Close(self):
-        if self.eScript:
-            self.eScript.Close()
-        self.eScript = self.eParse = self.eSafety = None
-
-    def SetScriptState(self, state):
-        self.eScript.SetScriptState(state)
-
-
-IActiveScriptSite_methods = [
-    "GetLCID",
-    "GetItemInfo",
-    "GetDocVersionString",
-    "OnScriptTerminate",
-    "OnStateChange",
-    "OnScriptError",
-    "OnEnterScript",
-    "OnLeaveScript",
-]
-
-
-class AXSite:
-    """An Active Scripting site.  A Site can have exactly one engine."""
-
-    _public_methods_ = IActiveScriptSite_methods
-    _com_interfaces_ = [axscript.IID_IActiveScriptSite]
-
-    def __init__(self, objModel={}, engine=None, lcid=0):
-        self.lcid = lcid
-        self.objModel = {}
-        for name, object in objModel.items():
-            # Gregs code did string.lower this - I think that is callers job if he wants!
-            self.objModel[name] = object
-
-        self.engine = None
-        if engine:
-            self._AddEngine(engine)
-
-    def AddEngine(self, engine):
-        """Adds a new engine to the site.
-        engine can be a string, or a fully wrapped engine object.
-        """
-        if type(engine) == type(""):
-            newEngine = AXEngine(util.wrap(self), engine)
-        else:
-            newEngine = engine
-        self.engine = newEngine
-        flags = (
-            axscript.SCRIPTITEM_ISVISIBLE
-            | axscript.SCRIPTITEM_NOCODE
-            | axscript.SCRIPTITEM_GLOBALMEMBERS
-            | axscript.SCRIPTITEM_ISPERSISTENT
-        )
-        for name in self.objModel.keys():
-            newEngine.AddNamedItem(name, flags)
-            newEngine.SetScriptState(axscript.SCRIPTSTATE_INITIALIZED)
-        return newEngine
-
-    # B/W compat
-    _AddEngine = AddEngine
-
-    def _Close(self):
-        self.engine.Close()
-        self.objModel = {}
-
-    def GetLCID(self):
-        return self.lcid
-
-    def GetItemInfo(self, name, returnMask):
-        if name not in self.objModel:
-            raise exception.Exception(
-                scode=winerror.TYPE_E_ELEMENTNOTFOUND, desc="item not found"
-            )
-
-        ### for now, we don't have any type information
-
-        if returnMask & axscript.SCRIPTINFO_IUNKNOWN:
-            return (self.objModel[name], None)
-
-        return (None, None)
-
-    def GetDocVersionString(self):
-        return "Python AXHost version 1.0"
-
-    def OnScriptTerminate(self, result, excepInfo):
-        pass
-
-    def OnStateChange(self, state):
-        pass
-
-    def OnScriptError(self, errorInterface):
-        return winerror.S_FALSE
-
-    def OnEnterScript(self):
-        pass
-
-    def OnLeaveScript(self):
-        pass
diff --git a/lib/win32comext/axscript/server/error.py b/lib/win32comext/axscript/server/error.py
deleted file mode 100644
index 82491a6e..00000000
--- a/lib/win32comext/axscript/server/error.py
+++ /dev/null
@@ -1,16 +0,0 @@
-"""Exception instance for AXScript servers.
-
-This module implements an exception instance that is raised by the core 
-server scripting support.
-
-When a script error occurs, it wraps the COM object that describes the
-exception in a Python instance, which can then be raised and caught.
-"""
-
-
-class Exception:
-    def __init__(self, activeScriptError):
-        self.activeScriptError = activeScriptError
-
-    def __getattr__(self, attr):
-        return getattr(self.activeScriptError, attr)
diff --git a/lib/win32comext/axscript/test/debugTest.pys b/lib/win32comext/axscript/test/debugTest.pys
deleted file mode 100644
index 4e133abe..00000000
--- a/lib/win32comext/axscript/test/debugTest.pys
+++ /dev/null
@@ -1,17 +0,0 @@
-def Function(i):
-	Test.Echo(i)
-
-print(dir())
-
-a=1
-b=a
-c=b # And here is a comment
-d="A string"
-print(a)
-Test.echo("Hello from Python")
-for i in range(2):
-	Function(i)
-a = """\
-A multi-line string!
-"""
-
diff --git a/lib/win32comext/axscript/test/debugTest.vbs b/lib/win32comext/axscript/test/debugTest.vbs
deleted file mode 100644
index 58f4a222..00000000
--- a/lib/win32comext/axscript/test/debugTest.vbs
+++ /dev/null
@@ -1,7 +0,0 @@
-a=1
-b=a
-Test.Echo "Hello from VBScript"
-' Here is a comment
-for i = 1 to 10
-  
-next
diff --git a/lib/win32comext/axscript/test/leakTest.py b/lib/win32comext/axscript/test/leakTest.py
deleted file mode 100644
index d8ccac57..00000000
--- a/lib/win32comext/axscript/test/leakTest.py
+++ /dev/null
@@ -1,188 +0,0 @@
-import sys
-
-import pythoncom
-import win32com.server.policy
-from win32com.axscript import axscript
-from win32com.axscript.server import axsite
-from win32com.axscript.server.error import Exception
-from win32com.server import connect, util
-
-
-class MySite(axsite.AXSite):
-    def OnScriptError(self, error):
-        exc = error.GetExceptionInfo()
-        context, line, char = error.GetSourcePosition()
-        print(" >Exception:", exc[1])
-        try:
-            st = error.GetSourceLineText()
-        except pythoncom.com_error:
-            st = None
-        if st is None:
-            st = ""
-        text = st + "\n" + (" " * (char - 1)) + "^" + "\n" + exc[2]
-        for line in text.splitlines():
-            print("  >" + line)
-
-
-class MyCollection(util.Collection):
-    def _NewEnum(self):
-        print("Making new Enumerator")
-        return util.Collection._NewEnum(self)
-
-
-class Test:
-    _public_methods_ = ["echo"]
-    _public_attrs_ = ["collection", "verbose"]
-
-    def __init__(self):
-        self.verbose = 0
-        self.collection = util.wrap(MyCollection([1, "Two", 3]))
-        self.last = ""
-
-    #    self._connect_server_ = TestConnectServer(self)
-
-    def echo(self, *args):
-        self.last = "".join(map(str, args))
-        if self.verbose:
-            for arg in args:
-                print(arg, end=" ")
-            print()
-
-
-#    self._connect_server_.Broadcast(last)
-
-
-#### Connections currently wont work, as there is no way for the engine to
-#### know what events we support.  We need typeinfo support.
-
-IID_ITestEvents = pythoncom.MakeIID("{8EB72F90-0D44-11d1-9C4B-00AA00125A98}")
-
-
-class TestConnectServer(connect.ConnectableServer):
-    _connect_interfaces_ = [IID_ITestEvents]
-
-    # The single public method that the client can call on us
-    # (ie, as a normal COM server, this exposes just this single method.
-    def __init__(self, object):
-        self.object = object
-
-    def Broadcast(self, arg):
-        # Simply broadcast a notification.
-        self._BroadcastNotify(self.NotifyDoneIt, (arg,))
-
-    def NotifyDoneIt(self, interface, arg):
-        interface.Invoke(1000, 0, pythoncom.DISPATCH_METHOD, 1, arg)
-
-
-VBScript = """\
-prop = "Property Value"
-
-sub hello(arg1)
-   test.echo arg1
-end sub
-  
-sub testcollection
-   test.verbose = 1
-   for each item in test.collection
-     test.echo "Collection item is", item
-   next
-end sub
-"""
-if sys.version_info < (3,):
-    PyScript = """print "PyScript is being parsed..."\n"""
-else:
-    PyScript = """print("PyScript is being parsed...")\n"""
-PyScript += """\
-prop = "Property Value"
-def hello(arg1):
-   test.echo(arg1)
-   pass
-   
-def testcollection():
-   test.verbose = 1
-#   test.collection[1] = "New one"
-   for item in test.collection:
-     test.echo("Collection item is", item)
-   pass
-"""
-
-ErrScript = """\
-bad code for everyone!
-"""
-
-
-def TestEngine(engineName, code, bShouldWork=1):
-    echoer = Test()
-    model = {
-        "test": util.wrap(echoer),
-    }
-
-    site = MySite(model)
-    engine = site._AddEngine(engineName)
-    engine.AddCode(code, axscript.SCRIPTTEXT_ISPERSISTENT)
-    try:
-        engine.Start()
-    finally:
-        if not bShouldWork:
-            engine.Close()
-            return
-    doTestEngine(engine, echoer)
-    # re-transition the engine back to the UNINITIALIZED state, a-la ASP.
-    engine.eScript.SetScriptState(axscript.SCRIPTSTATE_UNINITIALIZED)
-    engine.eScript.SetScriptSite(util.wrap(site))
-    print("restarting")
-    engine.Start()
-    # all done!
-    engine.Close()
-
-
-def doTestEngine(engine, echoer):
-    # Now call into the scripts IDispatch
-    from win32com.client.dynamic import Dispatch
-
-    ob = Dispatch(engine.GetScriptDispatch())
-    try:
-        ob.hello("Goober")
-    except pythoncom.com_error as exc:
-        print("***** Calling 'hello' failed", exc)
-        return
-    if echoer.last != "Goober":
-        print("***** Function call didnt set value correctly", repr(echoer.last))
-
-    if str(ob.prop) != "Property Value":
-        print("***** Property Value not correct - ", repr(ob.prop))
-
-    ob.testcollection()
-
-    # Now make sure my engines can evaluate stuff.
-    result = engine.eParse.ParseScriptText(
-        "1+1", None, None, None, 0, 0, axscript.SCRIPTTEXT_ISEXPRESSION
-    )
-    if result != 2:
-        print("Engine could not evaluate '1+1' - said the result was", result)
-
-
-def dotestall():
-    for i in range(10):
-        TestEngine("Python", PyScript)
-        print(sys.gettotalrefcount())
-
-
-##  print "Testing Exceptions"
-##  try:
-##    TestEngine("Python", ErrScript, 0)
-##  except pythoncom.com_error:
-##    pass
-
-
-def testall():
-    dotestall()
-    pythoncom.CoUninitialize()
-    print(
-        "AXScript Host worked correctly - %d/%d COM objects left alive."
-        % (pythoncom._GetInterfaceCount(), pythoncom._GetGatewayCount())
-    )
-
-
-if __name__ == "__main__":
-    testall()
diff --git a/lib/win32comext/axscript/test/testHost.py b/lib/win32comext/axscript/test/testHost.py
deleted file mode 100644
index 8ef8bcc0..00000000
--- a/lib/win32comext/axscript/test/testHost.py
+++ /dev/null
@@ -1,257 +0,0 @@
-import sys
-import unittest
-
-import pythoncom
-import win32com.server.policy
-import win32com.test.util
-from win32com.axscript import axscript
-from win32com.axscript.server import axsite
-from win32com.axscript.server.error import Exception
-from win32com.client.dynamic import Dispatch
-from win32com.server import connect, util
-from win32com.server.exception import COMException
-
-verbose = "-v" in sys.argv
-
-
-class MySite(axsite.AXSite):
-    def __init__(self, *args):
-        self.exception_seen = None
-        axsite.AXSite.__init__(self, *args)
-
-    def OnScriptError(self, error):
-        self.exception_seen = exc = error.GetExceptionInfo()
-        context, line, char = error.GetSourcePosition()
-        if not verbose:
-            return
-        print(" >Exception:", exc[1])
-        try:
-            st = error.GetSourceLineText()
-        except pythoncom.com_error:
-            st = None
-        if st is None:
-            st = ""
-        text = st + "\n" + (" " * (char - 1)) + "^" + "\n" + exc[2]
-        for line in text.splitlines():
-            print("  >" + line)
-
-
-class MyCollection(util.Collection):
-    def _NewEnum(self):
-        return util.Collection._NewEnum(self)
-
-
-class Test:
-    _public_methods_ = ["echo", "fail"]
-    _public_attrs_ = ["collection"]
-
-    def __init__(self):
-        self.verbose = verbose
-        self.collection = util.wrap(MyCollection([1, "Two", 3]))
-        self.last = ""
-        self.fail_called = 0
-
-    #    self._connect_server_ = TestConnectServer(self)
-
-    def echo(self, *args):
-        self.last = "".join([str(s) for s in args])
-        if self.verbose:
-            for arg in args:
-                print(arg, end=" ")
-            print()
-
-    def fail(self, *args):
-        print("**** fail() called ***")
-        for arg in args:
-            print(arg, end=" ")
-        print()
-        self.fail_called = 1
-
-
-#    self._connect_server_.Broadcast(last)
-
-
-#### Connections currently wont work, as there is no way for the engine to
-#### know what events we support.  We need typeinfo support.
-
-IID_ITestEvents = pythoncom.MakeIID("{8EB72F90-0D44-11d1-9C4B-00AA00125A98}")
-
-
-class TestConnectServer(connect.ConnectableServer):
-    _connect_interfaces_ = [IID_ITestEvents]
-
-    # The single public method that the client can call on us
-    # (ie, as a normal COM server, this exposes just this single method.
-    def __init__(self, object):
-        self.object = object
-
-    def Broadcast(self, arg):
-        # Simply broadcast a notification.
-        self._BroadcastNotify(self.NotifyDoneIt, (arg,))
-
-    def NotifyDoneIt(self, interface, arg):
-        interface.Invoke(1000, 0, pythoncom.DISPATCH_METHOD, 1, arg)
-
-
-VBScript = """\
-prop = "Property Value"
-
-sub hello(arg1)
-   test.echo arg1
-end sub
-  
-sub testcollection
-   if test.collection.Item(0) <> 1 then
-     test.fail("Index 0 was wrong")
-   end if
-   if test.collection.Item(1) <> "Two" then
-     test.fail("Index 1 was wrong")
-   end if
-   if test.collection.Item(2) <> 3 then
-     test.fail("Index 2 was wrong")
-   end if
-   num = 0
-   for each item in test.collection
-     num = num + 1
-   next
-   if num <> 3 then
-     test.fail("Collection didn't have 3 items")
-   end if
-end sub
-"""
-PyScript = """\
-# A unicode \xa9omment.
-prop = "Property Value"
-def hello(arg1):
-   test.echo(arg1)
-   
-def testcollection():
-#   test.collection[1] = "New one"
-   got = []
-   for item in test.collection:
-     got.append(item)
-   if got != [1, "Two", 3]:
-     test.fail("Didn't get the collection")
-   pass
-"""
-
-# XXX - needs py3k work!  Throwing a bytes string with an extended char
-# doesn't make much sense, but py2x allows it.  What it gets upset with
-# is a real unicode arg - which is the only thing py3k allows!
-PyScript_Exc = """\
-def hello(arg1):
-  raise RuntimeError("exc with extended \xa9har")
-"""
-
-ErrScript = """\
-bad code for everyone!
-"""
-
-state_map = {
-    axscript.SCRIPTSTATE_UNINITIALIZED: "SCRIPTSTATE_UNINITIALIZED",
-    axscript.SCRIPTSTATE_INITIALIZED: "SCRIPTSTATE_INITIALIZED",
-    axscript.SCRIPTSTATE_STARTED: "SCRIPTSTATE_STARTED",
-    axscript.SCRIPTSTATE_CONNECTED: "SCRIPTSTATE_CONNECTED",
-    axscript.SCRIPTSTATE_DISCONNECTED: "SCRIPTSTATE_DISCONNECTED",
-    axscript.SCRIPTSTATE_CLOSED: "SCRIPTSTATE_CLOSED",
-}
-
-
-def _CheckEngineState(engine, name, state):
-    got = engine.engine.eScript.GetScriptState()
-    if got != state:
-        got_name = state_map.get(got, str(got))
-        state_name = state_map.get(state, str(state))
-        raise RuntimeError(
-            "Warning - engine %s has state %s, but expected %s"
-            % (name, got_name, state_name)
-        )
-
-
-class EngineTester(win32com.test.util.TestCase):
-    def _TestEngine(self, engineName, code, expected_exc=None):
-        echoer = Test()
-        model = {
-            "test": util.wrap(echoer),
-        }
-        site = MySite(model)
-        engine = site._AddEngine(engineName)
-        try:
-            _CheckEngineState(site, engineName, axscript.SCRIPTSTATE_INITIALIZED)
-            engine.AddCode(code)
-            engine.Start()
-            _CheckEngineState(site, engineName, axscript.SCRIPTSTATE_STARTED)
-            self.assertTrue(not echoer.fail_called, "Fail should not have been called")
-            # Now call into the scripts IDispatch
-            ob = Dispatch(engine.GetScriptDispatch())
-            try:
-                ob.hello("Goober")
-                self.assertTrue(
-                    expected_exc is None,
-                    "Expected %r, but no exception seen" % (expected_exc,),
-                )
-            except pythoncom.com_error:
-                if expected_exc is None:
-                    self.fail(
-                        "Unexpected failure from script code: %s"
-                        % (site.exception_seen,)
-                    )
-                if expected_exc not in site.exception_seen[2]:
-                    self.fail(
-                        "Could not find %r in %r"
-                        % (expected_exc, site.exception_seen[2])
-                    )
-                return
-            self.assertEqual(echoer.last, "Goober")
-
-            self.assertEqual(str(ob.prop), "Property Value")
-            ob.testcollection()
-            self.assertTrue(not echoer.fail_called, "Fail should not have been called")
-
-            # Now make sure my engines can evaluate stuff.
-            result = engine.eParse.ParseScriptText(
-                "1+1", None, None, None, 0, 0, axscript.SCRIPTTEXT_ISEXPRESSION
-            )
-            self.assertEqual(result, 2)
-            # re-initialize to make sure it transitions back to initialized again.
-            engine.SetScriptState(axscript.SCRIPTSTATE_INITIALIZED)
-            _CheckEngineState(site, engineName, axscript.SCRIPTSTATE_INITIALIZED)
-            engine.Start()
-            _CheckEngineState(site, engineName, axscript.SCRIPTSTATE_STARTED)
-
-            # Transition back to initialized, then through connected too.
-            engine.SetScriptState(axscript.SCRIPTSTATE_INITIALIZED)
-            _CheckEngineState(site, engineName, axscript.SCRIPTSTATE_INITIALIZED)
-            engine.SetScriptState(axscript.SCRIPTSTATE_CONNECTED)
-            _CheckEngineState(site, engineName, axscript.SCRIPTSTATE_CONNECTED)
-            engine.SetScriptState(axscript.SCRIPTSTATE_INITIALIZED)
-            _CheckEngineState(site, engineName, axscript.SCRIPTSTATE_INITIALIZED)
-
-            engine.SetScriptState(axscript.SCRIPTSTATE_CONNECTED)
-            _CheckEngineState(site, engineName, axscript.SCRIPTSTATE_CONNECTED)
-            engine.SetScriptState(axscript.SCRIPTSTATE_DISCONNECTED)
-            _CheckEngineState(site, engineName, axscript.SCRIPTSTATE_DISCONNECTED)
-        finally:
-            engine.Close()
-            engine = None
-            site = None
-
-    def testVB(self):
-        self._TestEngine("VBScript", VBScript)
-
-    def testPython(self):
-        self._TestEngine("Python", PyScript)
-
-    def testPythonUnicodeError(self):
-        self._TestEngine("Python", PyScript)
-
-    def testVBExceptions(self):
-        self.assertRaises(pythoncom.com_error, self._TestEngine, "VBScript", ErrScript)
-
-    def testPythonExceptions(self):
-        expected = "RuntimeError: exc with extended \xa9har"
-        self._TestEngine("Python", PyScript_Exc, expected)
-
-
-if __name__ == "__main__":
-    unittest.main()
diff --git a/lib/win32comext/axscript/test/testHost4Dbg.py b/lib/win32comext/axscript/test/testHost4Dbg.py
deleted file mode 100644
index 3bfafd67..00000000
--- a/lib/win32comext/axscript/test/testHost4Dbg.py
+++ /dev/null
@@ -1,88 +0,0 @@
-import os
-import sys
-import traceback
-
-import pythoncom
-import win32ui
-from win32com.axscript import axscript
-from win32com.axscript.server import axsite
-from win32com.axscript.server.error import Exception
-from win32com.server import util
-
-version = "0.0.1"
-
-
-class MySite(axsite.AXSite):
-    def OnScriptError(self, error):
-        print("An error occurred in the Script Code")
-        exc = error.GetExceptionInfo()
-        try:
-            text = error.GetSourceLineText()
-        except:
-            text = "<unknown>"
-        context, line, char = error.GetSourcePosition()
-        print(
-            "Exception: %s (line %d)\n%s\n%s^\n%s"
-            % (exc[1], line, text, " " * (char - 1), exc[2])
-        )
-
-
-class ObjectModel:
-    _public_methods_ = ["echo", "msgbox"]
-
-    def echo(self, *args):
-        print("".join(map(str, args)))
-
-    def msgbox(self, *args):
-        msg = "".join(map(str, args))
-        win32ui.MessageBox(msg)
-
-
-def TestEngine():
-    model = {"Test": util.wrap(ObjectModel())}
-    scriptDir = "."
-    site = MySite(model)
-    pyEngine = site._AddEngine("Python")
-    #  pyEngine2 = site._AddEngine("Python")
-    vbEngine = site._AddEngine("VBScript")
-    #  forthEngine = site._AddEngine("ForthScript")
-    try:
-        #    code = open(os.path.join(scriptDir, "debugTest.4ths"),"rb").read()
-        #    forthEngine.AddCode(code)
-        code = open(os.path.join(scriptDir, "debugTest.pys"), "rb").read()
-        pyEngine.AddCode(code)
-        code = open(os.path.join(scriptDir, "debugTest.vbs"), "rb").read()
-        vbEngine.AddCode(code)
-        #    code = open(os.path.join(scriptDir, "debugTestFail.pys"),"rb").read()
-        #    pyEngine2.AddCode(code)
-
-        #    from win32com.axdebug import axdebug
-        #    sessionProvider=pythoncom.CoCreateInstance(axdebug.CLSID_DefaultDebugSessionProvider,None,pythoncom.CLSCTX_ALL, axdebug.IID_IDebugSessionProvider)
-        #    sessionProvider.StartDebugSession(None)
-
-        input("Press enter to continue")
-        #   forthEngine.Start()
-        pyEngine.Start()  # Actually run the Python code
-        vbEngine.Start()  # Actually run the VB code
-    except pythoncom.com_error as details:
-        print("Script failed: %s (0x%x)" % (details[1], details[0]))
-    # Now run the code expected to fail!
-    #  try:
-    #    pyEngine2.Start() # Actually run the Python code that fails!
-    #    print "Script code worked when it should have failed."
-    #  except pythoncom.com_error:
-    #    pass
-
-    site._Close()
-
-
-if __name__ == "__main__":
-    import win32com.axdebug.util
-
-    try:
-        TestEngine()
-    except:
-        traceback.print_exc()
-    win32com.axdebug.util._dump_wrapped()
-    sys.exc_type = sys.exc_value = sys.exc_traceback = None
-    print(pythoncom._GetInterfaceCount(), "com objects still alive")
diff --git a/lib/win32comext/bits/__init__.py b/lib/win32comext/bits/__init__.py
deleted file mode 100644
index 3a893267..00000000
--- a/lib/win32comext/bits/__init__.py
+++ /dev/null
@@ -1,6 +0,0 @@
-# This is a python package
-# __PackageSupportBuildPath__ not needed for distutil based builds,
-# but not everyone is there yet.
-import win32com
-
-win32com.__PackageSupportBuildPath__(__path__)
diff --git a/lib/win32comext/bits/bits.pyd b/lib/win32comext/bits/bits.pyd
deleted file mode 100644
index 5108e7b8cd187c05d919a40e82be7b0f38834195..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 62976
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
QgScKuRW$#%e;a|n0rQvF@Bjb+

diff --git a/lib/win32comext/bits/test/show_all_jobs.py b/lib/win32comext/bits/test/show_all_jobs.py
deleted file mode 100644
index 8ce230ce..00000000
--- a/lib/win32comext/bits/test/show_all_jobs.py
+++ /dev/null
@@ -1,52 +0,0 @@
-# Dump lots of info about BITS jobs.
-import pythoncom
-from win32com.bits import bits
-
-states = dict(
-    [
-        (val, (name[13:]))
-        for name, val in vars(bits).items()
-        if name.startswith("BG_JOB_STATE_")
-    ]
-)
-
-job_types = dict(
-    [
-        (val, (name[12:]))
-        for name, val in vars(bits).items()
-        if name.startswith("BG_JOB_TYPE_")
-    ]
-)
-
-bcm = pythoncom.CoCreateInstance(
-    bits.CLSID_BackgroundCopyManager,
-    None,
-    pythoncom.CLSCTX_LOCAL_SERVER,
-    bits.IID_IBackgroundCopyManager,
-)
-
-try:
-    enum = bcm.EnumJobs(bits.BG_JOB_ENUM_ALL_USERS)
-except pythoncom.error:
-    print("Failed to get jobs for all users - trying for current user")
-    enum = bcm.EnumJobs(0)
-
-for job in enum:
-    print("Job:", job.GetDisplayName())
-    print("Description:", job.GetDescription())
-    print("Id:", job.GetId())
-    print("State:", states.get(job.GetState()))
-    print("Type:", job_types.get(job.GetType()))
-    print("Owner:", job.GetOwner())
-    print("Errors:", job.GetErrorCount())
-    print("Created/Modified/Finished times:", [str(t) for t in job.GetTimes()])
-    bytes_tot, bytes_xf, files_tot, files_xf = job.GetProgress()
-    print("Bytes: %d complete of %d total" % (bytes_xf, bytes_tot))
-    print("Files: %d complete of %d total" % (files_xf, files_tot))
-    for f in job.EnumFiles():
-        bytes, total, done = f.GetProgress()
-        print("  Remote:", f.GetRemoteName())
-        print("  Local:", f.GetLocalName())
-        print("  Progress: %d of %d bytes - completed=%s)" % (bytes, total, done))
-        print()
-    print()
diff --git a/lib/win32comext/bits/test/test_bits.py b/lib/win32comext/bits/test/test_bits.py
deleted file mode 100644
index 94bcbe4b..00000000
--- a/lib/win32comext/bits/test/test_bits.py
+++ /dev/null
@@ -1,121 +0,0 @@
-import os
-import tempfile
-
-import pythoncom
-import win32api
-import win32event
-from win32com.bits import bits
-from win32com.server.util import wrap
-
-TIMEOUT = 200  # ms
-StopEvent = win32event.CreateEvent(None, 0, 0, None)
-
-job_name = "bits-pywin32-test"
-states = dict(
-    [
-        (val, (name[13:]))
-        for name, val in vars(bits).items()
-        if name.startswith("BG_JOB_STATE_")
-    ]
-)
-
-bcm = pythoncom.CoCreateInstance(
-    bits.CLSID_BackgroundCopyManager,
-    None,
-    pythoncom.CLSCTX_LOCAL_SERVER,
-    bits.IID_IBackgroundCopyManager,
-)
-
-
-class BackgroundJobCallback:
-    _com_interfaces_ = [bits.IID_IBackgroundCopyCallback]
-    _public_methods_ = ["JobTransferred", "JobError", "JobModification"]
-
-    def JobTransferred(self, job):
-        print("Job Transferred", job)
-        job.Complete()
-        win32event.SetEvent(StopEvent)  # exit msg pump
-
-    def JobError(self, job, error):
-        print("Job Error", job, error)
-        f = error.GetFile()
-        print("While downloading", f.GetRemoteName())
-        print("To", f.GetLocalName())
-        print("The following error happened:")
-        self._print_error(error)
-        if f.GetRemoteName().endswith("missing-favicon.ico"):
-            print("Changing to point to correct file")
-            f2 = f.QueryInterface(bits.IID_IBackgroundCopyFile2)
-            favicon = "http://www.python.org/favicon.ico"
-            print("Changing RemoteName from", f2.GetRemoteName(), "to", favicon)
-            f2.SetRemoteName(favicon)
-            job.Resume()
-        else:
-            job.Cancel()
-
-    def _print_error(self, err):
-        ctx, hresult = err.GetError()
-        try:
-            hresult_msg = win32api.FormatMessage(hresult)
-        except win32api.error:
-            hresult_msg = ""
-        print("Context=0x%x, hresult=0x%x (%s)" % (ctx, hresult, hresult_msg))
-        print(err.GetErrorDescription())
-
-    def JobModification(self, job, reserved):
-        state = job.GetState()
-        print("Job Modification", job.GetDisplayName(), states.get(state))
-        # Need to catch TRANSIENT_ERROR here, as JobError doesn't get
-        # called (apparently) when the error is transient.
-        if state == bits.BG_JOB_STATE_TRANSIENT_ERROR:
-            print("Error details:")
-            err = job.GetError()
-            self._print_error(err)
-
-
-job = bcm.CreateJob(job_name, bits.BG_JOB_TYPE_DOWNLOAD)
-
-job.SetNotifyInterface(wrap(BackgroundJobCallback()))
-job.SetNotifyFlags(
-    bits.BG_NOTIFY_JOB_TRANSFERRED
-    | bits.BG_NOTIFY_JOB_ERROR
-    | bits.BG_NOTIFY_JOB_MODIFICATION
-)
-
-
-# The idea here is to intentionally make one of the files fail to be
-# downloaded. Then the JobError notification will be triggered, where
-# we do fix the failing file by calling SetRemoteName to a valid URL
-# and call Resume() on the job, making the job finish successfully.
-#
-# Note to self: A domain that cannot be resolved will cause
-# TRANSIENT_ERROR instead of ERROR, and the JobError notification will
-# not be triggered! This can bite you during testing depending on how
-# your DNS is configured. For example, if you use OpenDNS.org's DNS
-# servers, an invalid hostname will *always* be resolved (they
-# redirect you to a search page), so be careful when testing.
-job.AddFile(
-    "http://www.python.org/favicon.ico",
-    os.path.join(tempfile.gettempdir(), "bits-favicon.ico"),
-)
-job.AddFile(
-    "http://www.python.org/missing-favicon.ico",
-    os.path.join(tempfile.gettempdir(), "bits-missing-favicon.ico"),
-)
-
-for f in job.EnumFiles():
-    print("Downloading", f.GetRemoteName())
-    print("To", f.GetLocalName())
-
-job.Resume()
-
-while True:
-    rc = win32event.MsgWaitForMultipleObjects(
-        (StopEvent,), 0, TIMEOUT, win32event.QS_ALLEVENTS
-    )
-
-    if rc == win32event.WAIT_OBJECT_0:
-        break
-    elif rc == win32event.WAIT_OBJECT_0 + 1:
-        if pythoncom.PumpWaitingMessages():
-            break  # wm_quit
diff --git a/lib/win32comext/directsound/__init__.py b/lib/win32comext/directsound/__init__.py
deleted file mode 100644
index 8d5db8b9..00000000
--- a/lib/win32comext/directsound/__init__.py
+++ /dev/null
@@ -1,4 +0,0 @@
-# See if we have a special directory for the binaries (for developers)
-import win32com
-
-win32com.__PackageSupportBuildPath__(__path__)
diff --git a/lib/win32comext/directsound/directsound.pyd b/lib/win32comext/directsound/directsound.pyd
deleted file mode 100644
index 81342354c221e45a590b8f6df75c3d83cccb7d16..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 76288
zcmd>ncUV(P(034mC}M~jdx;8)9mRq@p&q2#yJGL<BG?NEmKbC26?^X$Y(Z3P2-v&W
zuHj<$iuIcBH+#+@;at7<zVG+f_k8hT_sq`j?9A-!?CzXmaF=;9TbWE|hd;AfCOe9p
zej1kkb5hbqCM#Sav9Ro5fz*meZGuuOwi`HTlzL>uhyfA3hN=7X8a{kPq`G%Mbwt!~
z^`PNupU}4IVI%tXtL@}e&_y6!C*}5+A)60x7yo)cblpA-aN}!7c8p;8fgNL6zJEs_
zmLJ+N5cyUCKP7eljzNImr5$1Ul+*(|1_PdwdSu5?<U=+e*<PB}Keb~3%MUaB)@uh@
z-eyprfz-ED(lB3{tnYMt+3Yvv`--@?vPx>le1*%&hNDDK)S^MSc4jrAp$`5!pG;=Y
ziY&QoB(S7p{PM}d0q~8)?C&sNviFNj)(LGKzRF~8sd1Q%tQ!rO#zywN02K&7kerEr
z9WrIIc4FC2@^Iii8KVL+S|-aRdcXM9j_fx!61Wz_kPyoxyC4Uy*iS8!h1ZVg+bgn{
zOg2%EqG<fh#$N>ftbQ7BU7N2a>*NN6GZ-n2{D)N~Txw)8W9^ZAMJ6L;l@$bn49@DO
zA$k#`BKn|==>)oAyjA*Hy?#SSpd#srsh?!1^0#_kDE<HH$LZx-43naxk<-afIoQZh
z&<O>A5&(Hn@zw%1GKEs!n$NoMSsy+d%4bo?k}u<j=I?$J=_v{d6zm-tg*|{l=qR5h
z@!3T_yM_!D(0*TT`w?h{g7YW<8-oBbemWImWNi4XAfFZGv$A~VicI9ES1!F%C<VQ-
zJiP=!ynIf)e0<i0&-(D$P(F)7Cel;p(o+-`<x}wT0VetQEQ!x9^4T?HynGoWMg5FG
zGw@?V0m%o5mk;v-WNi4XAfFZGv$A~Vij3zc_N8Z#UhYaF8RX@Q5G5ZMH_o8?<2WlS
zgPPg|HH?}wIJGE`4uMyjRYO<{r<a3)h&|((^|Y-_M&rlRyFn}&<ZDVI6X*>-#ftQd
z9?f3Rn^Pf|UKyU=PLbZiJoKjV^nO&a(7VdhTUmto6X-ou=hC~xS~v|A>3Qd&*MO&Y
zvWA7;EF<IZk~O{B@C1Uq6L@+xMS36FSj+o-1ZzB}zJ;Dw5-U1Z)QZ2!m2>IU;OV`D
z|7ZH!AkZ^to!P+9WWW#lbmR0FF&+yxVue)|Lr2q$QTZ{@v1i<pdBJtvT-2ub!JwqS
zP3&r*`VDsIN`Hydc{`X@SKxI$jF_YfrMI)rTg~Z{Q@ovv(IDv2mXQ+r11*P+=oNLo
zFzTk|7Q&t&+{&786bLJv^Mf8y)`vRl0@YTO-9cI1Q!0<|G-G5*uBnq6jiVGE7mkt}
z<#YuZ8|cAg3)UNJ9U{wfdZ#j|1nD<!AYKcYRUfdB2*Pu*NzQrNLIh1)#yjLEBKkX=
zPD}Fhjdb3{ppUXv(u2LO*6dy8Eb<%VJsFL=L<8C|t7d?V!r4}#^mo>KJCo|%b^cIP
zN{T<POsTY&FP~;s!t0h&ZrX*&f{A3VS(AcfvSglLRse2IgHQ(cNNqe{oY^KXf3ekU
zqVjWQ*D~M*7^3IIiG}ujp`|-3`)Rd_?C1K>y!NAEswex|A4py2+K;XEFwa3N(SAx|
zq}`xK&lK;HY})CaIsy$w;fjLkN=Ld$mRc6il$CyAU(~y)v87|r6b(<)Ade;8!+2rC
zW>sO3g_)t}k_zWgXN5A*?Y+X;U;Q2>o?Pq{XIW$o-dJC@A_iy*=sSXo^Jdjow4KLz
ziZwbTcgt3R(TzihWe6-^L01-*B__+yza%o*(lFU!s2ru_QfL<-<86<oAzazDd}Op7
zZ?yf1ra|>WG};z`MWZ!vCCS$H8fT6%q!nzK=vdirEYTC~w=iqZ&)>i6Uw(_65)&qs
zt^{G24UxW`h57sy^is5<f-6x6Y<BELqkqwEBVN060*Jhii+iqiSAnxU+7(6~qe3$u
z`fZZSoVyism^(rhD`Tbkp$~A*Yt!}6$}$BASBIbDP>xW!5Ssw@W|ckaCX!LXYE0#b
z+1!aFbR+nOpR~OQPn_HKF-J74=Ap<XvtLdZnXA+<0hlvz(E9gg)m(Dsu#{F9`?hTC
z&zp?lY{IqUnwE11I;tR-;!o2?maT<y45X6A-VTv9;p#Nh+@N|VT8#tXqh|b=r{VOG
zqRKb}W|+?3Er@2>O-`RCsQ~wIeIW06xL>X(iRi|xI)i%F>j_pRj4=6w_5QfB_=ANu
zWRJpnG8wIC%g4KYOhPsO-0`QuUl{(ve?I#$z83$A`A@x>8e2M|^`*LXM=I(lcYP7&
zzM7^!>(DtAod#+E^Bp^fqVvFTtU%!;2RUfo4#nYP{!m<h;s^YE{n;v`sVuBND^Ur9
zvS>Zg!}>D{usD_fY5nO#M8x?Uf=2(MFTqf)^ka}$U^Fc2PktifY>NelmLP?5ptC|5
z3T=@3{oMgW8==q!4TFCe;4r2F6ozAkVk%*?GFKbFTAyfKvL4_FE3Qw>EU-RZKv|x7
z@elU3i|ng!|Gf64rg35R<;6(lt~b}1tb%=&M=OiItZm6kKd>L7X8PhoJTXFKKeMa}
z-RNg+Kd=jD>fg#P$iIvBFb|b~wjc2%ilRN}Q3>|&awpM&J@f(mU+m!nf+M;1(1O^?
zoj=x2%1S<i{1j_rHU89$#-Hq(Hv)_+6G<G`pYJzFPgzdTlQ^DK0B%fQyeYTxbHChg
z?CATG{l*f$(8`|p^^*3hPoN=;KWbR}7Y%jHk3Z`=cl<|L4;#fy{$aoIq7R6${l){j
zvMk=#J6WD7D}9RljSF5RGjA`J{RSH!alf$!WdCJF6!seviCCWf#w_rjXGLWDjrxpb
z^eeBPmt~2AlI%DB>iw(zhBw)UxZlV@HK=^b4w4K;c?Ga&l>c$R@c}`UT>D(Z+QUNO
zWq-2Y7(m^z{YH1X`fvM<1=IoCZ)niyU$iUiH_B_NjrD$`CbXAFyJWqV%>?v&v6sl4
zk*+Mp@gMgar_t)a?l+d8Ztk987i`;lDl-H8^?sv^b=%*lt@S(<rxdf_U+p(4kbuH|
z<LL^baNZQwDR;kN4FB7Hqa2NwxZg+z9##{xl3K!QmI40X?l=0PE%E&8_2B(B@(1lu
z&)OfTW$2vwgL*BAja+|V%j{8D4+^7|mA}Mzi!(j%{3dFqtQNV1Xgx^$i$H<U*`Cbw
zplVpQ^S`VI(Wv~h^<W@T6xV|Zs01atKsu(xwt&T{_fPwS%8V`Hd|I2>`uFwV&3Ed=
zvL1ZuLDKwh*Mq;B|9w5kLRlU={M&k9wST+AufOA1o6j^)Jvsd~cIfKPv?4#b9prTR
zF$#7RI@9^%NS0!~{EFvw{T;Ka8sBCXYh#Nx=@h=Rb}nRJmi}=*M^#b>PM$cOUw}4p
zl5HZL63Gm(D>jv3obijLunz>;YODhrY?7Cvg*efK9HqZmmr{QvY5u9{5T${CDV+`C
z9%lq`@0wLw)aUeXX(C1i8GK-xur`A#Vk=w!x|6*}cJnZEjVHROqbhKXo4cVbvN&gG
z=i=sZ!K?~EdsJ!6878{8nN@9o4bt0l`dgg-3MPcs9ENS&CH-f!Y6KB8kE;!o!Ko6X
zUkr_5Zu%hT-s7?<wJGt^%_W>p3j-muhMmC<cSA9A*gJ8Roo*32SD)BW+~rchJ#>e8
zIuu=T`p*zb5jPJdL53g~VuKgZpgOpPYE1_<upUAEt4W|vW>o|+X^iZ_#ZGkTB#SCz
zR?X`ITCk2zpcdt5R?QS)v#K8m1nCtREFZlOb%3)JsA$ct!4H#p0(D^?SC+}#f%U3J
z4<vIpobqGOxHAc_cjX1w@M4}Nkl`$%vMVNUhmP6~{Ak|g^zT3l%#EaEEG25QYB*zy
z4XHm#K9<BDi9vm}nYuwlVm3N}l+|EQci!_|k7SOuDr!AqwVc8kPjIX)altbjPD7&Y
z(X$5@Es&+tY(;H?4O1{#jzRS;h7>F36^mnKH<yuSRSQPxbFjX65NVpYL5Q|($pHNo
zt+`D}(ps8X6-GSW8&?5y(BKpc9?YtbKk1o2$|pAl*N_%^h8@z%(b|@lR<k{)8wu}f
zMC66+NaR<XALOf<_S7&Kv&sh@1To`R#2tkgkf5Tdqk$M_vY&V=#}smB=RHn0(Z$o`
zL*1htIM6_c4L%Tfh12;VTBk-kw)gPE`Nj`t8$X<D{BWl63&UTySycxWf-yx59h{*7
zevW`0W-o!%sd-#gW-psJkrLjbh|~`bI6XQi!8iz})?yeSul`*26IO;we5u7~a_0x=
zL)`Wt#ZQY!ABY+P`pg_Ab!O(^ZdNVC6{j!34&}GaZO|EG>mXGS%~-+M>MXF8dq{<I
zabm5hgw56;Sj>qfO9)lM&skQVrYQ?LT-hk_^NQ^PA{&}jwx|)LhYM~;F)>66$f4kh
zaaG=$t8Hj(Rwbi|w^d<h3WL)iPC%SMZ<6h*wLd2PG_dd!LRLy0K~Mb|=}tUT4KTlO
zMNH|_V0@@UJaGa~v#6G+DPPvGj+7^8>S;%jA*QM81m@8cKZbu>zr;}KJv5;BsbxLU
z-{EJ*wuVGG?|Nn+@eT5GWZGEIQvB7hX)3vF|MPWCw4mJmAN)K|V=B=|@#YEWXq}tM
zXz)Q(h>#~BZQ)N(;XBm!Vm#QGRr8q!0@dV1awA}NtPl?B7%t{%a#CnLbR%975p!gc
zvHh|*j=B7SvWcu&2g;3pMtOS&Mue2y6{}=d)Paz=((+e=zOD4h))Ni-M(1D1jbfzP
z0>Z&0?yV<l^94~X3Ql<}j%^~~&yKPl&!e&*ZtlTK%&J|iek7c1+mc7sM0wi1sC@c#
zZkm}hgqGwKKIb_-mUh&(;dJ?g!+|I)@hkCPaUdxAuf0Uipz5`b32IhtZBNW8;+9c4
z^IuGn%zwqvogORyMVkWAe}$tR{1*<eN<U|vpE|{l-5oHi#sDGpTO|dvUr3#ae(QBS
zDaRAM{ZIWCvlr|00w!fVNDCX3A&_sJDBt;ZBwu7l-t6~#kd$o7B5MAUwZWbv8I_>=
zAU!rL9i4qWF8CU>MIb8H9XH5NYvFC8lQXU&LXifi8lY}gO+s^VOs(RUW=wfu|7R%`
zrwYq0_Rjq6bJlyVe|reMur8f=*5ThO<LYnzP4p!#sG8_Y_A#YCMUluE^B25-d)AgH
z|Eqs%kJf_!_p<hHjPzL0V0!}IsX6VX%8gq&M7kij+m<>osDhXT*b~$MoQDsysuSaZ
z_tPX&>}hA-HI5W)WCV2}ic_8SSxhPpT;qA%O5|l>t}%f?(KTB1OPyoyOaqRDGpok2
z?wPLHrbmNbNk*EjscUIemx2;6AkAfi{81JOh(IX`7(v|_R0mL#9fVo|mIycoMM2o-
zX*{lC(-#nHgz@t$QtL25#M#t^C}PXi)N5U-rXb?;*3?VxI(d^oCZa_?W<Q&VDYlJ`
z^apb-7;`Y$R5XAj9%j{3MoC<+7eJ|Kz!pavYgURe1#Cu99+|*Om%OY5=CblLdsbQa
z=?s3(tzo^HRn2*Rd_9abApCd)pbTmfhQMn1ZmkwL>`AReWi0?Lv&v4&VM0DgWL7l`
zqn>WlMj?~8`1dIBxJqNJH=0#70ihgba2HpJHoO`bO39k$Sv4$ER-*3)Bt5V1c2@JF
zAmgnQ2%-O`SpRVqq%Q$+eTW%igSUe=;eu#!R96)38nc6Hpe<GYgHY-(*AA`_D4P1u
z^uL(N!ff1ne=?bMa1^b<AND6iN4h^5C~)=%)e<@D&Kk}IRVioQ#EONp`UK|TjMt$=
ze;-*Zeh$Juihw-2HLJ=|r_5eGSdCnJooBJv)>KDiEOQl&dJc-DjBO9e!`Mm!EsQaK
z+IQ&4>0jc66pmx7{;qD)Gu@<2PB+Pf_zmlxPDYBj<<z&qH<N705Nskhf}@G=GcZ1k
zbw2>K!F42>e%4L$MD|uU347!bj0LoSrRd9>Ra=5#e8HI@@>$>h8H`Rx$614~JCSs!
zb=Ba@jtV&R_<{`jF}LkRyGLvZx=<(gu=>!cN6z{+qlm;_<q}OS#-0i9*`qrQI2Zyn
zMPEL8Ur&8|cdc!D)AYzdv+5D+A05#$7o-n<OBFbM`_JG*&DOdFY!5&qk&U|WcF%%H
zcGaep1i_tmLvgmAy1@NFv+4w)^}(On9lCVWAs-0n>keJuk%nLs)mVud`u3ha6uu08
z%h{%z=An{V)%HL0LJ@)PsEsi%%uYL=U?%Iw54v9{Kf@Rh6u_2&{Zt~T;+OL`ib==p
zk8Wb-tROKU^=dQ*_gHTa;OcMdtwxv|SE!n3f)~&j_sc*rj|uYLCz81N_x1KUtCq{p
zbdet?>WJ}E8CQSf2ZP64cnhi~^3$5}^Atrt;pbW4f8wV-S_}S-^kXmbGYQRkeiq{D
zZ~VZt7(ctIn#j)`%pZ*R&-rQh-}pJpsxkevw(_@g7->^0#+0X7^#fNDe>QI>O%0x{
z64q?>W^Iq7D36+8QzJpe%BA%p(Be6M>d#z%&R=2H2barVkDu_zrY_Il7^*0$?IEV3
zSylEY{G|uv;V+56f8lQ$$-u8y*6YD^*2h*5z@TD1IEgEX{=&uz%DYRoMCQ7)hEqUQ
zsyq+k#<Cu`5GZ91D*WYnwFVme{Ji?5DlY@vBJ7@zzdj)H2Kg1RllQ!O{0o)*Jq{~+
zgxvF>S+$&}F^g#AIj@doH2&*(wH4z5r%L{r3dwo39S7><VI0w$^t{@YNtS2lk;@;X
zd%Kim0p%Hth=lT2e@2;<Oy|`dsKfN@I-kG#iM>+%Q-f&%j{bIDt+9yAZZU}d^1SN6
z*r4<3l5a!<Uj8pu|Nrv5S~5@kdBt_mwvIn1F+u+pe||ro7=Gr*Y&cK+c`M4S;?Ea&
z9>w_cRbVCYXE(vr-w-h|{=A;iUxdbF>O%ZE*p&qTTl~2p8uAgXnz;H~{P|zwu@4zf
zKZ(Z<TTK1Ie7^fKIVm1n?Fr9=B_7+8)pANl9ky8S!394*!(kr(9FH9`l++kSk{ct%
zc<gRQ>EGh9M&e0~$2x)s#JfR9+B1Lr_HY4n{B}o($Hrh2{y&b#9z>sFJOi;a+M~?J
z9+BzjHZ~ZvZ<|f!ES{leR}_yuSeYv2#$%^39SZSS+L#FOSgij5q%jP&U>|AJff&Q6
zj&9AWNI}*Ao7gMO&|mt)GU)5){xGW&iIO*dmx|it4>5`J`oo|cD)~?TP{-4lMKtpG
zLkC9VKl?+*1H4v-Hwft^Udx9S!l1w5Lh26#nPk8AhYLv-P#*I$%71uKcb7zexDs`E
ze;C7G{SW<NnYlE)(?Il>{_r#Fk^JFw(h&K>SFHa3r9ZU3|8NEbCHB6~zyvj`Oxj=D
z`x%(NmA$vWPoQA$@o1N8@5un9_Fhu3_ea!$XzxwXtyvWZerSUKukD@Ur;_+xCc3eT
z-zA9hIZ*ex@w@jGPzw%3!*0OVWV*)*!Im}t$M{`Iq9exdhA=TsposTV*t%MtJNzHV
z?_62$x%>C>BJ05##yZXueQ@>5{qkh0Cho1?!EYhnXT=%YKk?@Y7u5Xc^8|^LC*GxF
zO&D)~i+4R>eQjyUxU5FYn+EP9?H)Q2<6TpMglTWUJYb7T7r>&*7-QI%py(IzF7br2
zin<Ub44p+1YQa|?LfCqLY$1xr&T_vK$U2e44-OGi{C<|=OZ_1RbNvs{0H%^BzC_PS
z{BwNCOsz!b>M@mUlu9YYm+m*Go^D&kmlmM0CBAeScxVyvrST}w6JOfLn&$Cpyf30u
zBHs-({>gqlWDY6rGYIkf^}?to-LG@Pq^%BIu2AJz!!#60H6F{j%8e{V638@e;q52<
zHL&nU_XpeP1^svDSwrk&6r(G~Z`y<jTrHvsqN*#SnOW8NCtSU1Mg()YdPra%uJXoj
zMtbB>{3hzQF6z22DjoY*);rm}A`bgE7_e_TI6&m(It!~Hd~+Lo7iLaiE2u-CLpfcP
zNf(8<OH`&V3L@-9xjs0ZVm=7sVbl>WxlZ94ef!%ia)V$V+sROD2p5*94Q?7}NZ_|-
z)dnIiI-L+^_#Bv{VOZtDqFS+MMpD=YK@y6Y;5^b4{OS-0!h%x(Opb#=X4e8PlkR{G
zL_i1oG^&H!L55&-F_M7TNpEFQfv7&7%>}1GRs#{6?YO}H7^yxOP7WTj1VTTVLg>fD
zhknw)aVKz$_fAkTs|P)et=jwF+E9Gv1gc_KDeCi9d`P_)HK!*yX6isv&YtgvR1&cT
zGyC=a2UM{C;m<>K>vdKWbd`J*gDO)jHnL^@=li1zrASA4_eZ-x4GwNM=_v30&DT`&
zpY}(Ccp8I=MxOoAOh)6s?vJW79<Ynq2Z8>!KXPG(7>|3nknWFaFv;?G66^C~I?YDf
zA9eg0<%^A}yWIWJ1k}M8;N;kgzv2gk%`Z+j)Ww+=X`IaPP>=XH#GQaX2x$g51kt+y
z-#jr6iJ7HG4PoYEN7Q3K=bPA#(~rXbVFGU3=0t{a`Va@RDvhsOa#Ty)$Bb+Oe;-U7
zHuiUjf_*=rjY-l|y8v5+N)MtcZhkr-_^GqSb0VmRDVm?XijtjAbYl9U6bgu>y}-oW
zM;({|nzr;DQzwsm9PTIUR=GsOT+FJ;#2scTn1W-NYYXpbh+{Yk%o|i!V5xXM5PcJV
z1n``GHjjrYMv^MRf^>adI3N8}rU8^{f>7!i1O;JUzG}p4LlJw(#?qKC=X7x{Gr<OI
zGWN5LVs@}q4Nl)0%4!82?Z~A7Yl49#(NqlT^X8~Cz<^KBIfW*Po?<yrhFpK9K6{#3
zF=uc-0zPX`mP92*1=_&tdAS1g&G6tyC<wR7C5(eL@VN2Z5k)juirGo5XbgCmLIb9V
z+sg`Q&`R^|N-APkQ5m|6!~Pot<nw5ZFnEe-Q(3_k!~q)0WLjPR06c}^!1aNJrg2G`
zc8L0#RbEW1kzLGq7UgU}>^X;k*c9i0rmqyU!ysYST4*DIWHj9=P1FUo8x}F0VL=zw
zcM26{rfz>hEBcKLiLshC5Tyb7%ce!Fu~RDez<ByW-)z&e39yGTh_-k^Fd9ve9)n1h
zgLMf58wB&Ao9CT+b_LI(MR1V5EE>YROO0ADvSd~{6Y)N9EXP^*v1Xfzal$~cQQ|(m
z2-2Iyfhq`&Fi@QS1C5js%wr!v&#D(Fz1cf{jCMB=&BvX&ON`M06!BwJjunj%#^{wI
zt`I8-2A8Axb{M126c(p3dc()ZUlOluj2^OrRI{oxDr<H2KO3Vps7;o?A9ZP*&S9J|
zMxPY3gIHg@z-HAFVhY<Fb+G;nTs$o*1@J5zSYzSeJwVf7<cFWas!)ur0t=?o+zLVu
zSrI&M4n&3R^M2H)MF*uAW?>Y5^**2@8s)ABcv2)qix>Eaa%mv&m<he{X@>$R&H51&
z-ap2Uvjg9EA{Ds5fi88nKdnm+Bv1V)1>O1xKnv8T-tyA^Mg3C$R6j_6KS0;jAwV~(
zBsr>ZOs8#0Aj}86I^j(#4|9NS!g>4|@pn}JDcBHb3^sVvF|#UD<vR}=EP6#Y>mKoh
z@o=LZf;#Vmb_=?Yc2<EI8rd~MO?RqU4sZI!f=XmDdTfd_t2VP*krO!sZgrbgdw^qu
zOCA$7JmI0usseSfu45g?;&hH!$Qf5O$RO{EZal6M{tgPW8z-pIlgYOTqd-1aLl5AA
z!g;f*D!RccJaY;%_GHkNOuE9#X_x?yPdB5$9sHKk+{T$bNfCsHD)HFoO(l`Tqk^3N
zpi4A5z(9nvhsGr96&`%lvbO;P^jX3B&seE2?6^-@k5~sYoe%--hW4@q_;{#C4ur7Z
zo`OehA|07{DI|#!L(_xM%u?Io3ODZ9om{i(Ayk1O2*T5OcuonmfjUM8Lg8sl-jh7O
zW&i=d@pwa9JjM%fJ&%KYm_V48y+IjETt1I`MC?AWbjysM{e*`Sd=*Su+Y^sfCgZ$d
zc{PvTLa7-?V(|P#cB02^D_KP1NIO`a9)T!zXK+eoGZ2A_nsum%?Nq-2i~BUJ4(+_b
zOj$0rjtw@U#P0$iXx)ViCG+o@jDfFZg^vIpcF?wyXa^b627FsQ7{i*gWjZ(c$$VIT
z60H5F`QRT*oIiGFgF*A*DTd%z^I>X7syrLa(R|n})MWFaBId&=P{CW<{Crp<)QYBB
z{G3<`{NLxqgIc+BVn4CL&k28Y#m|YeD9mooM?mW;7zN3kD2lEyC+yG_%?TYgP6l~S
zCPDu`FHROFl0TalqJpLNQXfmUS+yIZk6~u^@}5}&3loU;vWFFsy{!IDcUxgEb`Vss
zmkYomPQmK@#9n#>@lW>R1w8DfatBdI>!c0-$zIreXEPk@F_ato8Ec-p5RTj*Y1d|O
z8gh-eQ`IJR>A0?l%LgoTKPFbl9}ZtRVlg}_XXC5t$d0jaP=&#YmVfOT&-uc-m^*Ms
zJJ!!p)(CqpbfhXRqLm_gIYZMT1awgm{T`ZQt;aL81CK5wqOXbQt_<zWqvay{ponh9
z&}tt21Ea`TTP&i>F|>w9e-hE7Mf8t?Bp6;nBi7!E=#C=#5s!vsKxc_)PZ4e8(U1)2
zCnCC(h+fB|AsNv3MD*91g4|OXnk}CO)pZelPek{zMxPbY$3?UcL+9fKJ1L@9i)dGd
z7Ic0@L{Apc_SVGris+sq`b7a!i$Hvvh}MYc^9(I;zFtIE6w%wPTQ3yR`9$<AhPLH7
zj}y^PYY1u?!q5WeQ6l<`hz<gpcE1MIZz681h;wI61-^QVXq|{wGITz^<E|olu!w$-
zfyy=Vb|N}ZL|<cQp>?o`t|_7qGPJ;U3lZ%kq8BqX60(IxBKmc8LFmy8Ef~4Gh)xsH
z9T{59x2`Cn_ljswhSu=t(jt1kh%Uv@(LCBwL`R6|ulcR!fSrhLE28i5Xix{|auHo$
zL?7qTpbqqp7-X~&Qi<r*JepqeG^jp_=$vYT+>-@#K0<#M(YHi&PXR592KtMLJ}RO$
z3~j>;_FhCU7ts|NIv<bD7SZEHbUua_?C`#b?kb|6+LKy@0ZkRr%|!GWh87&<IT2k>
zL~pW2pAykO+yuGtg)k5=$g_4-L_ZSI0~op(k4_NLMiI?1^g$lIUqr7H(bX8bFOS|K
zqNj@Jf()&3vL&5w6w!S|bT(w-Cs@3QqYoD_SDgl&_UPN&So{pC<s#ZmMDNXQY7lXS
zMBF0Q)VV6NlgT3b6<|g=%9`>B5q(8OcgUsON5t(HaZOlLVW8TH=!GJ>3`66%rU1{r
zB05q;e@8>@Q8lluh9bJXh<?D(HaxnHh;AsNPg<khM05!ey_TT`3#=%jKUWcij<#-H
zT14Lw(Y+WNoRhYTis(cU?FBSHP>v#QjfktlniiCebwJb4(ZZ~pBBJv%v|N^-=G8k9
z9WJ6xm=t84V`l>WhltjS=nD)zl}Fzb(UnB>c82cDqwkAoTM?~i=&L+BRYX5?6?8I`
zp_lOJb0Yezhz@4xgFO0_h~6xsYcq6t9(`0q&k)fHhCa!o_lf9%BKj>xN_+G^kKQh#
z14MKNL(4VH8*LEL)kXAvhOWoAUL>L&Mf5_3?#S!hAfjKo2y#a<w6l#J4asy7ohqW+
zGxS)V_!JSnTSPZx=zKhDBSrLF5nY0zdnws~4ieELMf7JIk~^L!-djYs7SVSYx-idq
zR}o!LMAJ<j?NL9zbvqGVR79_2=<_@}SVaF>S&(}oLvQENEkyJU5#61kZFs>NiRi;3
zx&_eK+`c|en_Ew@OE<oBSpt<-5=-%cFREMV7?l<hOTWulDMkEn9v12T&X+dCk;|;g
z6id_jQsXHqy(pF@q7)nV!Qg@7dj{23oa4=^dLn)Wk1q&rc>FSkFT&#^C!_5g(BN^i
z87`+1(@tb>;NBZW9K{FloVI}T18&I)5jT<HP71i{z?D8F;zlyudI48B@5?dlt`Z9~
z;RtJXeWpeqt~Xig#?tC6EyhxNmU5tEcJ0m5zAWv}(vd73&(eu3oy^i`mTqV1s*2Qh
zGfTI!bURBAvh*-ZkFqq8rN>!%lBGtLo@VJ~mR@108>8&S()z5VHoI1{v<ORIvh)f|
z(^-0zrQcclkfoU{eZtaWEam0m`Hx^Fyu2OQH7{=yc3qRD<yq>?(tIralkxLAOK-FE
zB1=gw@hob|`}bE=h?CI|C+}^$@fx}_mz3n({}ZC#Q8vk3(go+NSq{`P_x?t<0vj&V
zqvGt~T9mHu;F^LJFZie&7yHc|X>WStgl47!g^^}8q7?Ty@C_8xEd@^M=TX%yYbP28
z_0cxdDvtO#6bm*Ka=`1LC4+3wvjV(!StvT#V0R(7>G{a=T75tvu4zVuqgJnVuubBc
zrbpNZ#3s3AKMv3*C3_eVlDwSN3k0bj1h1+d4elb7^>1twRgOa!oNZE!Cw(h5s&Im1
zK0<IMqipxuB-caBew^OU)g4Np`&h(dQ}76ZD&`_MJ?D@u=fFrY593=-vCrwxbD;IQ
z9)(NYlK0wVe-h<0LsqoSZ)ybvWS26%0F2uOMinczt7pv4Z%P2L*M>Ev{yZ+2n%l@^
zaYp`r8hxHi&=u;%8KbCC5z|E;$ZtA}i|m(H?M(+zV%m*FD5UoM^Bv;-BOw-tk4U}6
z!wLE<Qzyn|RPoqvHc`qT{W%J#r6Sa4R!vpYJjTn>hy#YP*-8O01P<vo4@Hi$USp%k
z^i-6W6=6fCKhIJb2K5b)rrO{IaXGo^1FK43F5~4?0>P>|;DWa)#bNm#G@f>W1@06+
z$us3^0h<aILXv^@f(DA2&hS71=<6&lv;UZ7`JfC>E4q1KG?nS^L=A}jVl!s2={F1l
zM#Bwn@40}>5F)HaTQEmlcObYfgClE0%O3p|Bjg!vh{yBh4~i-Ba;Sh$URFUyAmsq-
zAUh}jaz-YzVH(G)lnHY5Ybs7gPh(dyNS`EFpj^8WlW8p1$0-sQaMyJyv%MJ8nAu~`
zqr5$8OGdQ|s&QIzM2lcBBKfxIxMXu6$WZ7arz_?X&@>~mq`p<5pr%O?1@&H-1wl=X
z5tuWl-LfBH{H9%HmQpNsyo+oS*-Sy$r9JX|%uGuP-{hHf$J7<7^|%VXIL6(J%FoSE
zRe>lpwq1of(ap=CL^kVAq+Q(As6wU=MFCtgg(4FLhK&h6A+~u=GMp>|yixg0IYlrq
za1r#9L?((&cThlmaS9*AWKZ+GkdB()rdEo$i>ScqGf@9L3bM8V6zw01GIO79moa|2
zZDuY5aaV(!-dDoy)nu`MgS-)y&^NGba!%Xevxg;VET(@$V}x*-SeLU76kv3-JWwpq
zpLR8}aqJ&9k#3X}kNt|Ke9VdFv}rv;ZrO6vC}fJmMl#yu0Nn8>8;5(41tX-jIEjHJ
zF?ogghM;hsTea_l@ZSFgQxV)P!}N|jPmC=G2eWR^L_}V5#3r`+y3;6BOoK_uQsnai
zfSSzo43*-Hk)fup&VcMGsf7gQGq@aOPF<0i;+4#ltC?c>>T2Md@c3(GfgcZiio6+!
z!sp2}^~@N=9PpxvGe@;FeTEzqoQw68;dTR@ls98D62^Njks7d<-fe^QPQyV=YtAss
zn}Zb7k<~q53P@Ys{!PeF{1?JmbDrpj$osf!W_{7i|4Jf;rwH%iYM?%RR>6E;Cw~Tn
zY06hYGwRspvrv#Ps*!0SBr_EUrzQiESl0-YlP%T(uO3%5v(iifxXQU*=3eYm8`EOc
z)+cAL=b4y+F`qXN-}=K>G&-q+befX7FpLl9AU+68?(i#y2vbMVSQQS^Qz(4>8eJH?
z%(zQD#us-VGDDyzc#ML$Y2j`ITy`<Ds%shencKLPfwygN!w#j;n*J74W{L+x7SvK}
zR4I5&9)-J>Q4K+~9&^6b>@PSEy7#*{$#jmtK}YX3(aKs_tb^xBN<)F>NO`Q;HcFG*
zV{NM*Bk>rSyq3Un0YfJny7!P>Oss2Gtpf?3hirR~dxYh0bd1Gl@XsjIxas9t!Mxb^
zY`}3h(sck@0+)3Pb3z<jOJF-d|C!d7cbG`<{IT#cLHZQB5rZ!$P<%S~&PCP`h==xq
z|Ipu|+a*J27eS$%F1Wz=ycl>sv4EY7<{o>rz7v(<c^SC8m!1hFpjX__L>Vo&?D4Qv
zJeKX`WrVHVf%$TH0~8Mv$*W;lIlNzr+a~zf1ilxI3J|Xd73<`&Y}-n=$8_=;z@*5#
zqlCImk$1!ujdzN?mvD6yn;{uD#7Hx+Gqp^yv!R({Dc3vo+C+qd?9^f*?l(F4h=pjl
zEC?K$X^3ObcnW)t1R`v*C+g&BE(>D131aqR3u>eTL~_@kXL5Ey_of)IM{>G>d#w@I
zkkd_&GlTfUcfhDvCtr!9MT$HIDKFauT=B9^6Rt#dNw!HS!ydpL>y8b;-viNCFwe1D
zauBS(q^_Ndvt%rc{6b1hY6K<^fsW}uNhJ)%Dq_lNFlzElPNPgG&%ya3MSdSC&*V*9
z5tI1D3nv@xOrLrQlSMgT9&#vU#f3)~1ZfUF1Sz{R>g0#f&RU$^fFTaXxR?zZtEq7|
zwNsnvMOZbpYm9tUB`TvEpynj~1vt|vG^8gh!vgenMowpUF&j7goNl#(R4p*)_yHu}
zFMhTMH#v1!B{}`E&*+10V_^@KhOmiQ)r-nutM$0pzAm1?(M?rw6&8g3FjVP|=|Y9!
z1YlFh$l|#TMy{Lql^r&3@ZKc*NDz7}!_Wt)HxDxl&$Oej^57QcJ6c%LUt>#u1F64o
zOMmC6KRi}r-QQI-GpEFw^G)0b@iaYqu<t~0vAvwZvfKrtW1Z#nNt~{=L+%<(-#I-E
z&D;pUT80ly=^WX^Lk7-4q0DERfyDrAO+eDUHE~fEX=bu=eEZlSKg%wOJmy8Nf8c44
z`zh@jJne(OpuN*Vd;UMrrf<0Zo$s^)U|8f9KG7im2)h%+X9{6DK=}iqJT}Q8Yb{z)
z-3wM_dZFx)RoNI;M*DQOJ4cJ9gw=mR2XLeyWom~i{HLa9O9MkP?R`(X8s<)O@8hz)
zhe)HXl!o))Xbk-~8VV_m%MMaL+<rzQ_9aIKr8ZR}S7A`)*MVtPFdqbHUo7D1Q4`=t
z<l=wh@#7rGPU8L1OyR4Ad0oy*CJb~BJz?p_qi`gsvxm{+f?~aoKFQbPo{#>LHs<Z{
z$bLh$G4K5Q4Uh8CU)8_$xS%z7+xR-3SFG2@ydN~YUx3ce#n<s7=-BDMkmrI2D-;#R
z#X6l@3yXJs+tRFPZp0^2BHfyY+vk%-R%||!veNRsU%q26pdRDG;R{OikJ#IgG^&^n
zzV8eNr;R;t<D-+){qpSmD4U0iqqGb1F>v3SzMWWwct!6%dRlGm#J&}YPYaAH=<Aq-
zw%ySrMP37p5Op7&lN&A-i7$#NV(0S(MNx2!)(2g=LOia_sBx%KcGM`4w@K%co~Sv;
zbPiIf$q%Y4B{xZq>Zq4LTmwgW-XTSviVIsJAisnwZBDW}(lhqFIz@gEpqwH0<LW4C
zrTbLA?bGyjR7pn3C9_#(lvAwJLSQwzayn#Wf^LZ7U`?mzww&2BApAbz@?{TWWBEi>
z!f`e^)^!?Os4SV;XnW4E(?x?V8W;1@h#v7J9DWs_j%^V<m7V@lYBlymi0KTr{y5X%
z`C9GKbUV1)UXY!C+_oAjbNbaLkmU@EZv%;a1M{$Ewu3T8HWNLbA(LTQC5zX?XS59_
zLXh7hnslM2O~_3mpr3Z0kg(e@PB)FZAx2oC_UJO|mF**@&BUeYBE%3|U?mC1>Jmmr
zTjcF%D9x(<poyI%Eqb6w8x6c<u2=+(V9}vY>5NLfY0Rn~xWt~Y5RPRI2F})WlI95>
z*iENiV$P7xy5kHK^OD#guE4jC!E2z&n<@}wR#Ds`2T#}7u-iTT6~5pKZK(y#ry<BO
zpD1F2iNrn(rzQrV{w4{0%)}weo$JFPW^!IQqgJ$>QH#eW#DPNL(N3`mpK&3Jw8JTr
zKVeef0&4)M;b9%u71#g@{aAdQz7+ghOw&H2hGj;Tjh#@^E~>b`t=cd(^Xt&x@gU@A
zRm@kJW;wnk#C)6>CNy<oqXld1>0oNZUz_$K=f5kAZ}8wr9sC(o?T3>d<Tr;Qt8tO5
zaT+n3F*cX!+^A~I;}Y}W@+WA)ZfZ5K&c2~fIzcegiRxmFGpO{a9#F#=P$QjddU_1l
zmnS3w2X%o*`7T_WRiSi{V%s+I`x&f*^Jp8&uF@e!(~F8F&^Ya@lZY#Wss_X1JZy{(
zXlfi?8b!;f$RIDpFjmaxw)r#^70_B}qeh#)e4FPCBet;;3g<O8&bc%W<fYL7!m5b|
zoxtU5fP|!w7XdaV>}84~3&I*%e7iSIKPD_`*dXuC2%e|0N`ffo6-!A_Y<bx{HK@A4
zhItLZ9WcAowCBJ2pyp!xm4w8>CC#eiw2bS0@u0J>GoFJ3q&ISP>3RWwZ3tHL@OXlK
zA$u@lm6>YJ1J@qD&YVXQmq7Qf=zoXeD$~haO>+gdr_SvU-z!)S?6G?5AJtlpTjgBS
z<fuq1E*j?HLT$wbooB&OE*F1dRsAnqBzRc5LI?!ACb^bafdAyUPjJ`r>I5=o$@b{*
zgne%FAsU!v6h1Y-106BPD(Kwcgy%<Sew7A-&9}OMvp6^#3`PT7V;%@O=$T$XAzZA3
zi|Kd%BA-Y{{>3QzWnu47&OeffG}j=@F2d<;Y2d-a$U?+nvIE!jQA8HM`2fH89HM1j
z8_Jd8+ZL0wt^bR*i05NrH@gP0v<FMWS<099W!L>#I*_G<Svr)Z!&y3#r4cNRWGOw?
zV0InLQhLn5?D~>jFJb9SmR@A(ahC38X*5e0ur!XPJRKvu=IfV*w#}~PS^Alklm5-F
z-`VwHmePsC?3&0@p8iR8&C?mruFoJv*!i;bPxQyZdM%<U7X$PeCMQ^c)yUI+*jEo9
zcvl<y6i-xM(B{bOg7g`YMYVd3LvWukyHB@+Y%{n%=YuL|1oTO6r7wnO8}Xl|aCoHC
z+abrt##RyOs5p!~HuEi_>_Hyr=0evj8xv0Be2fIg<AKijE+eMlSmAYp0DWgL^gfuL
zIL!iEI9deITkGC-rlGJXy|0~1|D4;5Pv0^|?Wfy5wnm?6-gc3QDyIeO&$0hFAl1Y_
za?JLvxxr+spb`F`5jI>mkitufKg<0IbEa5kom=5uFS7X{V&P-h|1I-JB26T`7UOA(
z!c-8v0(6;+cjNIIQ~Q6!yPF#P9G^>H^>chK{g0S|zwY1NbmQlEwaEXWpW_Ak?xw~6
zh==_Dh==_Di1#!#_(#0EN%fC-Pt(We|0KW0bmJfKo~A=T#|!$=m=;^(IRky)QI>Tu
zgN2%YHs1Ym>(het2X+u17h*iIkuoY4CFzr}c;p(%tY8frxvT`5D^|s7(-xG>6NWVx
z!B=*GLGYCk{37~#%q?s=X^S3Ya2l6IuTc1o)VIg6JUHAG0R0gqcl1pAsKy6ixMtS~
zY<wAf;UI&1i*V<|3~nRBSw|S`CBoydT%&zG!2j?61R<j70D~X7Y?jj=8^36lBI%u<
zFFAw%6pnr&0z6U3=Lz{vA-^c(4~6`_kQWx(R}%92Le2?!Zy_Hm<a304tB|wKk-YrD
zU)>gRvD~=;&)*NB{zw7dE#w=8e7cbPIr8=Cf3>5ZM#$ZST%>D~^#7-Te_N1mClhm_
z!8`%pD&&WS{IZbW6!IrR-cZOt3wflF7ZmccLf%QpMZUrW{zZ7K4bP979e8E3`a<4H
z$U6!7Kp`J5<a304yO19j@+(4qU&vny`F9~NF7#I#yF>c932+M`uP>DQ33(?Wj}Y?d
zLcUDMcM7>t$gc?b6CuwL@(u$1okG4!$Y%@rU?F!9_~f~h$(G>1rJ|ov$bUy*f_`g+
ze6*0a5OSH2-<9+A_6qq-A@3&SZbJTAq|4r?L4QK-DdeSvTqe|Kog=A|kEh>7$ma-o
zjv&Wf0sb!JrG<V%g#5TrenqG+(k&S&izdoqE*sCoYDq5E$N%xk>W2yWJR#2%a(5+<
zA1UNUA$Kmqmxl}aULlti<;!#F{|_&AwIA2N>5z-w2?56k9ZED$i5gI&>EV%kd<}oB
zFK}*g=MNhq=fw=Qxu)D*OcuU$Z!zV137lE@$SsX`nsRR+nR?IZ)CNmhyEnTRc1^kJ
zhs+py$Ng-43D3?4CZ#FYKa_2kC3tj*zE^Ch$CfL~O%+k!@p*XWhs_7PYgq6r!aA=y
z(KtgnyA|Kw*yDHAs-{<!33br_(m%TT-MQ{>>Yb)sc-+UgZ9ADPMnbRUWt+x_;x>jR
zHrO5$aWsBqbpDEaQ+4UeJr1(?3$Cffr*(?%_;Prfa*=jxW!t2}Rb?S|clQrUSFXDO
z{*FF6R&?j_XUnHJ1gw}7`Sg^_;m7XNYdAL8m9Ct#neV@l`^F!g$N6jb53W2W;l;Lc
z(Om}Eue9P1|BLLyVXI#GZ+{njcW#YtwoB&hDDz|0)1c!Kx3aQURE)Bb;PXk~dH(kk
z-nD}KLA?Ak&+OOzX$9L#>iZq{&MeUu^@I8P-=`EB<!=R-uTZLWjZol|A-{dKt&{zm
z8B6s8+=j0oC(++D37lDYZQx|5bmdBWw71=Gv_;vZK|>B^D0huV`_n5!9E!%R(>B-<
zdOYTns>6H7R(GfLn0?B$q}7UPo1Zk9-KSe6uQHyCa^7l}Ofz@gAO5Iz3+;v<^2y48
z6~B$Nt^4luq8?f62L4g>u{K&+C}8Nud3&|fy1RHcuH>`Vwdj_(oN-5{zyDG<F6@Wb
z5p|7xeU~@t<E{*^-Ma1S;5l}#)%qu<x7$9h#+fGD1G#N;YksJ{t)ScMPx)@7l=~}W
zQ}?%lBf80bkJf2<wc%n<&8kIZGi!IN*ydp25y>;FjchgNwL{$Znl2vN<NfO{n`|3$
zAmpW@XN`(;dL|T)8vUuS&+NAL#iwX4FRy5HY_|1${*Y~>h7`MWsmA15Y4@fMNIk1L
zb$@N?ZmE8K9@*V_?X@pfyU($Ua_NS#eOIpEUcy_yC~*6a206jo-@UH1dhxt<HxmN(
zEIe+Sw#%cd%6U{iXWuHm%YT2qZt{uJe@yN1YFB}TQhv(=KHe&~)A7=izrMW--_}pN
zc4k=ramp)8&OP}t*QVA<zg-E9XFWK3(A<Cfoo{UyFV!Uayc)i`-ycUiEdG5&tC8{k
zb6rjw7LK^<fA{E>ZGNfWe75QH?HTmYukxk?XXXqXc$zyI73%JDa^{vnErJGq+E`38
zquuq^<2LmgP&}d3bi2&k!7KaUHI0bwzwG#_dtE~EuM1A}yr*xt|NMunugeN|`SWq`
zmX6_d-!0Ag!~b;=nRZ_Hz?Ea#_Ds|l^9tMau(jv0Gl9#?{E^n^WRLS_o_G$}Wb$gY
zZ*ZpO#h|F+TUS2q^!w4Aka_94-Szf&x>@+#)96LVZnrv?=~Q>|n{$00*Bjh;MZkW|
ze3xy5e~cVG;BdsK@3nTk_MWj+l@(W^=EbdRXII`;@Rc_9&!s0_YR*+>)=Q1?82iCz
zMx&829}E>n-b>1<c6a(&ZtcDIhbL6<x%*}PnF-%-5AxYN!6SQYm!0vORby8_n>;yS
z=FHYz<ZmnYtu}1uqAQ~|Yopip>62LT;AGd4>yHe2e%f!7U5zCduez>_{<vk?C!6iu
zDuqvjn$?~g1J*rq&FJ3H|IiN8h6!C`X2?s}OkMoVFWAsP<F)Uq)0@XrjNu*RX}-&C
zZw#+jF`w7Ts?XPsEOVDz=rkd%#KC}h3tsn0G5uCm8<(B)%C1R^=FeZu_3Na3={NIu
z*CiL8g{E&(UJ7{9;ajWKp3VOp8}Xz}DcA2i92!;+TJ%SWGKFvW?U?mj(-YD5tAl6l
ze|+`e&gfyuC+e3TGP$<Tw)DP--!z&N_i^#QjjmH~`$rd9t!=n;`V(WP0+~fmUum^-
z%#X{jYQNr8xj^j0-kbJl<EKAee=hOr-HUCP{5~a39=d(hrP!9+3SN&}mR>aEQ!D?i
zZ4RF>?Xuk(aG-0qYP+6<tahy7T2(PVMpu4m=!w_ueYQSa)7h@@DE|#_xY4T~v<NxW
zKkQ32&)(6-A<LJ9?Rx3Ipy>$hjNm)jZTs7A8EV+7nO}I_$H2Ih=L0;pcJm#+)_45`
z{~_gUE;M}MY+k;va{i!g8QtpH-_jm5*fn`k^;D72rFHe{(I#DmI`NbHTso%G%&EC9
zCBb;e@7C@9D?WvO2|2XBOTD4%Hx61m@mTjP&#RiH0im-BukEY2R4elK;1<mS5BzB4
zS2;D!ennzzjC0mqZpNTuyN4x}DA@YW!{ZZ5%7c$z{`9<5_~}lbiDkX!l#bzc>Yg^y
z+r50Yeqwz7J-cpc_Ks=WWY?=QU(dX~I_1cZ4Z$%bo_>3Err*?}Rs5r)m-g^I;1F?5
z*6jV~%{TURdT{!x|JqY;MqcjLxnEkdUZcL=8|M|<A)rCdsoo!2*K6DE<Wv`KNs|9z
z$4Doc-KcyWb6VMH7lc2((}w%r@RMiQ@yyEM0ZZ<B?AX(}!AlAJYR>ECx;Hg4wYqbM
zx)-RnBuD}Wx7@uqD)aaj-`Tngy~?^imPufnzpmRgO(|PBbVu0?kFllB9NW_S{lJPj
zgER@7xX9uwpEN7xdH+~e$v!@_+Gi}SH__Kv_|ZlCSAA#s=&D|s@TKs9?h?3%&yM&a
zZa=n#9yk%$_s@Xv%@TM^ScM*b&WD@$@8~4U$Uo^!NeNsk<;^$E>e{Zs>!ua@Yg%OD
zISHJy;Lo6CubR&E+4{w6`h^J}w@ct1E3;qSPFuV<bW5|ny_PmycwPcuXk$|&xZ5Os
zz|1H0>$hF7{;ZGjxbL*vPrRqgUl%@?HKem=gvZILPJY^L;h~KJu8&Na)oQ!`T(Q<Z
zbM(bdoG2C5Xw8&?4L3bK6}<1hD%-Q{z&;YVZ~BH;X-h}<_uW=$o5RrStG^xy^9dQ(
zYktVlcU=<}&W%~OcVV@m+}sM>@pG~VRlT;`UtB-ByU|ofv(BSpr+`|WcFD86m%Fb>
z3R$__=RwoapVrqc+v&^>-BRB<HCC<K;Zt}>r&|jGUAna9Hja$xK6dxxQn6g636~Fy
z3yxVE8>y;!a-z0cu}2@&k3v?oS`~ZkR*8(Nbsh}7vQZflH>1&_XGObz9cO<srG(p{
z;MMtBuV_0t{hYQ;zTW~;Dh8j7j8}Mc?^L6%+WwFFh2Mp)9G30e*+b(dfvfo+K3nKf
zQX@ZI>4(YP>Q0N5z;SV19@P4+%Vh8Q)$cjZ9y_C638#!l**6~e&KSR<{)3EeQ=j@y
zn7c5!AU9)n&iLf?ky9rO^60wS<Qcr(Z_T7{6R&=GH^AXVov$IGyVnKJa$Mh3-7Meo
zB5ubEhQ_?SR;`O6ru%|9Nh_LduNrb7zs>GO?!Q&LeY(KR_WQ1T9lz^TzeDSN_YTi)
zwrJsqs$RQhWNrBI(jjAekq(<&a?W{e^d7Y|y{|Der9p&`VX!f1j?0=oBNK+#kia!Z
z>~MEcZ(8rO#OBlcrmgGm8@0K?r~c~b(D<_tUKe_Is(aR-cLQxRZuxC`+dH~Q@#1f^
zJJXhysFdx$yjCxLsWBJwZ%K5S6z8bm;tG|??`>4{l)&LOZw@T46SdAS`r8<Hn+lcN
zea?~D-rTXx_ef}f!=TcdLsQ@18dG|1s@JqezP<%xSDNZRs^k#6s;p1^IHzZ6vQ-o0
zQ7iGio2em3HV0o_<zC=72^_KM?$BO62Ko9f-L>?7tuha0N?@J)C|RcN<14R?Hr?+z
zznFIIYqvU63cah$9eSMA#MIO8(BTCxQ}%^F_ubuoOv~9fF23CIrhul_i^QNckLEjs
zY`v6Rwe0lIFBW(6pWd~o@lwmxLnbwr?R8w)oLhEbQ1$Tev{N<W?*G*{_I}8sw4^EF
z56edP`@XY+`?j-zYdyn4j7yIh?;k$8aG8DC;5E<eeX?ZdyT|A=6MNK}>9=ceQ5TO6
z{Q^~+uPs`>^=zx%HJ;thso!u)bI+rmnU}`}t!dF=<GYDxq9t%lhbKPGD@CY$w!K>A
z`?dLPcL`i~?ecyf_qHspU0<c8&9a9{?h?4}%+~XpyN}%+uw{i}@4DyfWfIt?X-ZX}
z4okbWIvSXAV#}&gY6)EN^@2H9rVozrJ(a0GUCuUDBZ0N|hKwuh<b2bA{f$po?{2El
zy7ZClq0bjo@jq0zl5gh$wMv;rw|{qJ*>r7!&mUj=`{cWGXaAmoi(hZ`pBtuCIYf`z
z*Lg*Y?l-bzftyd5>ziBm<AN0}5=$Iiq*<SFqtCeC<3DJlcWvo%aCgv*4X-a99JuYV
zs%4c)8^1pfm=?J0{ize(T*}QFKDO#XAMXYE3%qc=e{x&l({VK_?|Kxx@Sfa!V)FM*
zoUfu;OJi_Q!u!gT9}es@`gYxJt?PekUOfIUW&G^<rgxh6mDAc)zs>C{_E1&QEU#U6
z!NAhXN395%yZlIn<*N^TEgD=pY>!tppS2lVE6%PmM{WP5$m=mz12u>5KL1*}<FJpt
zhct=Z_$b3~>gUWg_0y}}^sF<0TQPorp#F37X(vlP4Ef^ny~g?;Hr&*r&GB)c4XcBH
zPaUPcwLfrccuM;{FDAdY4M@B>!n0=3tb5%m9;jz<H7q>X(^Os&xT0BD!@WC}cdM?C
zd(eGWYo8TQ8mDUe%^eytq<49{G(+gBlnWEPDk{(Syy8-LVX~M1iG7iwfon47EFHMD
z!}Wq!lzW@dd2-9h*sm+9#spZ-mkTEsJiGWqeQr(8lx?e@7wA7tf_IN;n{O`8hbz)?
zzKI{+U|;pe<vw0WQ=UrU&zDV>pL_k+fvd`G#c|$AnC|&?l2i7)QdL6_-hB1`^_h)9
z0UKQhx<pM4UZ4njI{3hj^3Q{n+k2lLq+NHu^37$JM;(fj^fz4s$4JhnQzh`9PRnJ-
zoFcf`7Q@_IMDIQvE5W<(e1j2AS8m&m^J}k@3x{Mi40e5bMR_X8L003jZONe$c!UIw
zFVQ9PT4cKN@DIqZ=y<oyhvGLY-MpgQewOsPe8W>OhnYQ#{qDW3{+5#V&*lCPY8}|r
zc*^lsM;FX1?0sm>u_;4(EN^>rd_cn3h8qf1J7p94!;>rfsddPj%W>{ob_NYqUv}uI
zne=Di!R<9{JPbBfoaYox4102`)%4<NrN>`)eld2$`X~8!XNGK0Txs{Q%c9iAC&u6W
z9Mhv!Oq+<O<u4R@eg1TttwE)mdd;r+!D;Hk(lgsk&zSO~&{fUeb&mFfXGE<zI_3ix
zJ#Yd(1L0{i`dq)@vCCS_TTnAXv$EzN13xw%5c_D(RsFrN1tIHC__Uju@ye@;ciNnu
zzWU%3+YH@XtZCucPI)3Qr+3Yeb=|HVK2zdT{EuzTjPrijc}0(%>JgMN=I-FZ#RL00
zeejNc`nq@Y!^az&%%0|V&grS|k?`xU-wi$B+PqlguIBTOw2JQUcCC-?uzuR|bzklN
z7NuR{n(ELlXW_;1L6=_bxLe$7W9^|~orm2o*V03Kx=h)t%0(aP{5<QTMgn_DVCSiS
z-Bos+AGr4Er>^6lj61ce_wR2$#l(1>n1A7>-L@_{3z}bibNf+*-)7rLwJvbivYHE9
zym7qVI&^kg%VqEOukJoCNcpB*Y6!RFd4aS&^Q%`JSHb3uOfyU~W6!B?Et6Mw)V(TH
z<j<y~wCn0MJ7}L)ukLR>mc2>2aosC1xK{oawU_)kFyHqX?N@|*FWxR|Rc`f@q0!Bk
zoa%fwT{)`;?8UW9QmKUO)D?|paWndTZ1z{fhnit$E0rC$tZV27UDf5o?z=g+oHr%&
zuioJyvmZR%Qn`P>Lrqi8Dzo~p3ye=R6+8F(POaKA_jZYlDDFFBQpoG&iJ|GnLO0*M
z2uN4XTn&3Zc4Tmp1U@Z+lO^!uxJ{0SM_Ssu7y0u+!IzjHhe6M{yhZfaGt=V?>B>bW
z=s#K8Nai^`+J1;7zM+ZQZr(cH0!LSPHfiDNbfs<w<dtiyMK7DaFs)&Ra%CCf@96IS
zcC(redY_@3=?Hp=cdaV!_Sv-cs&d_X)Q|lmCnBy}=JnQyw_E{?_=}y}xYb*G0w#Y0
z_=#!n+oe|U;a;DYt_!!|<IQ%ppDhFYn6Iy?QDony?itFtX=FbuLms}&8liiXp<KOJ
z7Vc2>w?tW;A(}2NGL(lk;BVcR!R~t;XS(l2{AvpyzY4D^iN7rzmM8wU=v({EI(f&C
z10Eg5>-=WVj9&hsUHIL!-1v{W-q;1!aAv;o@p<4et1_+O_$nK|Tf^a-+7#_&MKAna
zO%H20T9(+fqDz``Luv4jcwtic-Gi(5w~VKzUZrC-USK>A^5Z#Xjorsy+*Req{JehD
zLmb|(b+xn)@790gs45mXv-$6F+x^m%F(VM8R;z}u3n(@7!%fThdiP%#mQ^%EsoM^E
z81G7t2F$pe2zU@rf2^cG*-YoYlNMXr+o;?Yex7ZC!<+8dd&?t3xh)3cb!%VbI7$1=
zJNIkGTk)Gu(%vhngwHMy3%@=R*j7^iPrp?c&tA(=9_a#mXmg;5ucW@81eQtK_mc42
zzCqadSi~PU-GltL13piZ@NfJSS)<+jH08EbjK{#~Pow32t1E3yQ!Xhai%w}9GF9`V
zMbZ29(v_>ep?yK`OIiu+es*6$U;hl{mUS}OXWJd$>q=ntu<VS=Sf5uf<=e~7bRAf8
zwWYtz9$5{?OtbVCKCqnP&dfCBsu0wdd-Vw4@`umBOBVRy`>LT&iaC033Yd6(_VKB{
z)i(!Tu3en-iyMFV#FvFn8zdHdQnvN7iav|n%RM~O-&A0D>pc%nck0hAj!ZtRx?X!-
z{xuzrRE*0E+2uTaewV*?74UrJv#!XTXThtN{O+&Wx5?%Ai);Jc>$)v?pZQ|-5(dA_
z^M2pj>D~tU?fa{9#^IVx!v<u`J3ewzW9_!Yla9we9tp0S5mRAj%SOIy3Qe9+s7_$}
z;%?(>^(ge+ch!rIg?prCU5L+W*RJ2aE6N3Bq2Hka5x;fw+cR@<nlfGuxL3!WBL|<W
zGT;DU7amrhUSwmt0s0Q*<&WNTu#7c4&*ez1nuz~y*~;sCz65suY^t+qf4XwZ3?9EO
zwdUyJchZ%Kjmdsr4Tx6{`dIR+1+KKP?m;IjSf&}vm9m1vKb9<7b3Vq8<`c%>So}`@
zJ(-sA&~!-XJYWg>o5c4QuX{Px8b5M;m&8->zpIjXd1R;W=loc2kuP(>Up8hdI6ipO
z8SD1(_3Hg@-Cpb4=Gmq>8Om8p`1={MD{tRh*RQ;|)xwJ#&Iay^zj>$o(nS?z9%Ezs
zXl4biJ}@=5;FRpT^RnWf@2cVGJ>%{=ue7L#oz9hO8JXB+t(X4M*<f4O=BLZ_n0nWJ
z;4Sai?v7n<SL?7om>c2NqfsZH^%46#pL{MjxUjwd_qM(22PQ<#(N@f!(ro>mq-UQl
zo#0jss=uj+lTO<({XkOIrq|wc{RZ6_Jt*C_=ANi8tyjElHUAHL+v&@$c&6UX*Sd@g
z?#GZn$NiWq5;#o)k9u9n$*+}DE8Tv(uEG8Ly1p;^WLx-(5!|V!Z8iE~Wsl9Zd-Kfo
zP&w_a=5gmLR$QP+m$Z+Rw4dj-u&tr@Rpo94-+x%cR>Q2}@a|0`t>O3yKeDaiJw@9u
zuj;-caPjbzhy$OZ?dvXS8{7GiiklPC_)2*8`|<T8u!jV8UOS}Eq(T|W#rv^8y&qX|
z@1F{8zgvd#<R{qYskv{`51#Jy!Vms>C)ta(S{G%*ezhiCRnoh4pQCmb8SA$5>dFHd
z${BX>j|=ymxN!Tu!|6u2zx0L2zi69r#lE2h9xtgsK>|;dz>_5KWC{HE;^`4%k6%^p
z*^K$>a{KV7Y7J{Ok7*n*&EajgAyI!Vb*VGAMBil0&v2d}R|#B20<YV#r0?Ed7JBO?
za8*hD=gWQH>HIA9Bd+zFK49%t<&5gQK77V*D>&vn^izn3eI>A)gkI54^Q)iQcvX4q
z5$b!~yB)8XRpouSh5kATENx$@!zH`t^(^(3H@Bv?8VG*M^ZlPr-IBIWc2&9khM<q#
zkA4h)mZ98!g@>p4eRTWF{;G2Sc#L<Yx=X^VRw>spD^0oSrrSNcB$@2^=c%RjEw3t%
zL=u0+lkS@Clp9l46TCNV*^j@>i;FyZK5dj~?hWnq!?zAj^FN$6;aI~mM+y|w9`v15
z%>CAZmS4+OJebgWZL1w)?=9bdY`~nT8>!FwyV->9t3CPU<ChCN4NQ36;$rpsLHa|J
z3pFowB<$<<S%HdTiC**TcAmUvd+l8*f4rXcMSk7q(0rMr)4NNHSF9RXxVb#uXZ3=6
zg_}nyreDk+o>1k$rjVI+>U>PhtoYz#z^D`NiaqmMHEwC;=zAKY-eLBFgwaESHZ|Nd
zZ<^=mRM~HfYpht4rrgmO_W#>651$=Vo8QI#P!aASfqP2eU<v%#$J}7z&@|=THZqMz
zgGC$sBzSGh_c_x?Tku{ISR;YGC9sbK_Lab)lK#RZ@K(PE&Rxe?`rjsjH6^t+)2;AY
z3G5|-qlZ7f)?loKp0@;_DbYuaq<-eSsvDiH+CP@SPb9GVsC#iQtNIlsaQN<NoXH9w
zzj;#IMi+5DDJzRUU+C)u<Jt1Bwi+#PA4&b_efEDgonVp2*x}R@MVtjrlE9}WaIyq$
zCDDIt2^`%f@_Fd~H05f#U%sVu9Zl7%yDMP-A;Mk~SSx|!_1m^SKbxk+<LgYm_}7)2
z>|2zcYrpFxaCmZ`S(BDq<c}Y$T$XquLpjxm`93J(x6F!)DUVNC;Kvd;zDM^dO>S85
z-Y<*$s^{W-hiAu)W6LCKB=Tt`u$Kh(mcY{a=PSWW=aaO3W`W;bJ42shyy>w7ekOsR
zOW^RLZFIA?TiW-Mz`cL>>1>VfBZ1=%2dx-Z`I>UhYOJ3FeRfZi!0yrGPBr1y2X9~A
zz3;1rOJ#K>a5U)Ewu+a<NZ_dwI9385KX<ER2dn;1NZ@Ga>+MwcJ-Cf!BIl0U5Hl`D
z0vkU)esOiCC4QHgZ`g(pR{T7cz)vLbpAz_^1b!-kpGn}i5?DPoqJ6V#mhpHm!GDmz
z;Wf&Qh`(W}-%A3Il)%vvI7R|bmB6tQSY5VVQI9zmeN~jel_YRw3G5<)T_tc830zeI
zyGh_`61chqt|5WN$D54&g&$t&VOJt-!<WlMSO9Y~;W^A)JYL3OKO>*{;W1kFGxC|A
z@cd?OeLUyQenvj?6Q1YH#p7Xa_A~OCA3kKjenvj?!&|THXXG=#Vtk(49`9hWpOMe}
z=sh#~8CfdxtHS5Ga8(H`K2|5z7aj}EtuH=iDdH;#3KL<q1g<QBT_kWJL7`%Md@Yat
zM7Xd7rZ0=p&&X1lpR)v3O5h?AxTpkHN#NoVSc)$t!At9xli({$;F=P+h6Ju9f!!o<
zH3{5A0&66&%!yvpx9H1O0=rA<*OkEaBrqp|10`^f1P+nFttIfR{Y&;8Of2nucop^o
z^~>d#wR!3|f9@6K>ZgDMkG8gv!1*L_=Jpel)iG&G-CEQisCRxWfuBg=iVkzX^|dME
z9QO+MH)^L8tt5eMCG_niu*^HGzv5(RXZ<ns=U!-sjRejofo&zQodlLkV0#IiUjjQw
z-~tl3pagc5z=b5RlLRg-ffW+iSpq91a1jYyR06x(<+VrImceUhW~3^2anNV8Rfp%<
zn|E5n>Sr^KS;O(gy)vv}<Ipzutl_Y+<ua{d=Vckstl^Q$QzmP8Z=idQH7xUY`;iAe
z{%z&EH>F`O;1Bj`BZ2KR^U8C(-}fuG`)4Q(vvIz(+uN~Z<8vEU&&*K9W?_GH`rP%%
zrPT_CwD9^~Zgs?!$MTCElf&Nc`+Q_W@G666m3(hqT#_n07@~+tSDs9PeLg8r=VsXZ
z{x)O#w%XVD^;Wzy?PC0Pa<UBP-GirT|2ipuU&;Nrl4ZMI|BCbX+A-)~{?WbP`w_+h
zyWes#HH$|zpO_fiu6&<}jbqc5$3H=yBL}K~T64AS#74z}rw3*?nKpW1=b>*eW$IJ?
z{f^D5($xFym&k<iEiNV>{JquG)*aV;@z5#yN&0KMy7b$emRGs8OV4kS1wJm+UxGg^
zk!OGeKTra9C=<ag9&lB;Z!6-zwIkP`AABWX`Ut?!d026D{pz)!16pl5-MWlJ*ERpA
zy>Ee!s<{52ga83~1O*E|@T#Cu0hfS?h_ai_hO8#pb$0{NVmHg~O|oUPyY6mCVtvF%
zTk79O+S*^K^^uT3QUw#WDpl09VoR-$XsONL+M2)8n*U$a_@=F`zweouyL<QMMri-k
z{@PD3OwO4(XU?2Cb7t<$+&gz~sCxC{-TA+HVMgC1*dzahkKQOh@Y<hlKF)S`_`8ns
zu3xMT8{{W``^J0qp=Fg1y&Kx}!GdEwtp@s&27SM5pc|ieo>z6`OZQE9+WC#;uitrK
z+I_K~8uAxi_Ku}`aLNVS=lv-6hILP`ddfgIK5xBr{4+OSornGMvuS_g{1=SRU++EV
z;^%(%=D>{muHp3E7u@<i_m4hWYi(b1V^waUue`yaZ`2SsKEI6{=$9GdJ0orGBk}y=
ziA#k)B@FbWA^yT`?|eOe%iGTTXWetc)2}?fGG(AQ8sZxb@g_t3s<*34-6MD&^%(k3
zXQI2=KyNX`FE_;h_~?ssM`m1az5j$A*Y*72l~<m;@<{ix>0h#Kd#3z>$G>@m`gqGV
zdzJl=zf;J+FY;gB(u!K!6DL1)l6B?Y?>O&!#%urm_2mx@?b`Rz!^0E4VvyhQof}X2
z>s!B^@tr4G!7Enx)}_B}yy&tgCzL(#$Yp=={(SyTH(mOb?-lP}<a*@&+i$L$d*_K3
z&u`r~=<Ip&6=mM(^<Q;tfAWNamzu7+cHHw1crUqS)9P<N^unG0`;%v$C|Xj!u43uR
zvag>r|ITlh-@fMxL-|)4;@3B~Hk^p}<y(&v&+o4?(2u+O-9Marb+Y9C;h$f5!_SWQ
z*4+8YGIclj*NFEOetX51%TCvgKi7Y8r8mC+#Tnlj5Bs$IuJ@wnel!1;NaBJU8Xhb^
z!?owE%{!iYyS3F{{H@bpe&W2>Kf3LMN5T)(S6y4#bJY*dzi-3SU%%+nhMjXew_o_c
z^TW@-vF@&)Bxc?6*UNv}U-szsBi1$4KK<u##|!tlo@%jQ^P9)t7`!Rv+x_M*%MO%(
zTDCKMd;N~$H}5(y^X|)b#7-*R(e$lH@3<<wIyGU{`78HSJ03k{v+{r5-1^jvpO5?M
z&$i8R-qPYO{P1fVrlh?0EsVw&+uDEj>!01+S9sewlb(O}iw|2$pV-*?@gr*W^^@JD
zzk2iZj~usN`@wxJw=Zt$-BA7h-48zKyeTq1Tv#5wt3Ri^ea6;Li|>w1cxBvo*2en3
zcFD(s1uM$$U-DMXzGwfmz4_+JU*7iUZddoDxl5j%^wL$^diNiAp?0h78{e<3zBF<4
z!!JL1#=y-}9M13m>fKE%Pm0|5ZmjtmN8Wy>_4Yfz(75tydt>{THlAI5@y}g-7oPd*
zJKz2Nop;}M?4_^e^p;+K*QsZ$Dk?Ai<2L{AZ#*)u;+}hgQ&RUiR!j_j=zZcL>|fCH
z;JJVPU-^dkWJCN2Lwt%MKGhH}FvMpV;zt_dHGh5Pbjy!loPlrIbA9I2+G3~OwYB*E
zBhG$p&eOSl`+wf{g<q|Hzv98(+g@Gy-uY$Mp0^{qfBvr0hyU{9kymeVpIvxE!PQGP
zpL^lMtqV5zxAw0;@rsgDpWHREqWz1V=X~*pZ@+Oz&2_~;sd(J}=nq}9UVUys;A_9!
za>s{>*DJ57+TUJx^SKi&+b7v)Ox-u*oA|PdGUc|~p%;d}_Kj9N&)JvH&bOS9G>#8A
zs+)Bcye7`O%&g5m_cCx=4nJ2DKV860lCLHv`1VOy72ObxHANM*IjF`{;TXP`Ag<R1
z-(WPGe|;dN1R{}GFd&#)CEsxdxtuSN2(&0swMmJn(YjPU30_g+Ew<a-URetB)vHQu
z{g>5XN(m>GXe^}!6nBeck`&@ir^$?=rqW2DF3I>`B~>3tDap7R4A-_O>l<rp)x<(6
zH5iBo)`uhER9H<eVl32D%*n+qDK!aM-tgs6pcWETnQ?&<jw<UV8T?gI)OLd}5r`%s
z))PpnQUwmYyimyI5)z>D{2RiN7?+{M)r68%gRy96fdVC)>chc$B@{>nsJ<yFHKB%-
zR7|IY(x5iP5-ng?ql&X6oPdG6vBqdfXuo1bRU9%@k`Y96sG&tlS-7r#Axf)_B^m<J
zpsEDo@km&-6LCeA#-xfOkY!^a(g-xBgw&LpXuwBxc+shFgQ_Id%NkK!NP(QsDjB)e
zW;NKDQWq(uU`@tqQ%!+{X2qn!eFSn~&16e5r8dYqEl68RX$nUo%6e7VsG_R%&>xXt
zfYgk}lz1W*RFlbYw2o@2sU-@l4<thR!gMklASOjZlaW{xY_CboG_WFA>H{0O4Zs>g
z4~WD9p-d|z$<{Dh0<9*ROqVI3M8XZ>6miS;Q>fwLUF2WxNT9_YZ*-wj^=cp_orV0q
zs<hPM!EMQov@!iY&7^aF@N@r9)1*)UXGo2v!nK+M>b;#BI2;W|8bhk^qhLZsuZ2AW
zyi<<ys_YU)8T$S~Jy~?FOdnaK_%a^V(3s?=w;0NcC&CQ@G_lB>ln%o?g)Uh%BD^u&
z(Ab~^VE=|dGslzYq)9&PG{NZPWTLN!5nJD)z_ecHB@Tauvyx{^$8FUt5^t()hJQ8$
zQoKUmRH8AMYD|l0A$yQ-G{GIH>yY1rnY(|+XH2VE8AHbbJ6zRJKWbfF_e=Lav!3i#
zQ$jy#ucVsd+DIkjz?3bY`<bp@ie~nJf}iVhl)5|>HlL#!ZJ$ihK)~w_|Kr2%Sbj%D
zefyKYQJSwM&IM$~xsbXsjL}8!X?$F*2uHnIlX?RU@rY_1D@hS>i6-S7yx%Cv#&|rI
zp#Fr$<O7r_<J6>*?&x9&C2tX3Q*$L=Is6GVRRo$3rF_k$4tx1-;RIrUrdtcYDjOTt
zV-!L|W;bFoQ|m0>;zME}(iCV((jc~&H#Q{k`js_Rgqz{8wn#)PCetqDtf^Qk5K*G(
zGNqMZRCqMq0wA&>+zd-&RMu=O%f}suG?iQt484>s%H1)E4v8vcDdA0FFbPUMc)v4{
zG1{Or*GY~=ibqA$CEz+3HA8Bwwl=BM(y)#JEYhOHg2BebqU?HR6(Q`IU0-d0$kZ4v
z53NQ!$!F>Y(Fd0+t20_OR}Ax!gsPe}kWf4Qw?s__6Jb8n(xx3S0&f)>iL^G!>RuY7
z=oO0;Thw%Lfdk;q$?xrGI{nQZvj`9q8R-ex6c|)75(YK~!jZuGh#1T=vpW(Jkdqf<
z&x00`WNZQT*kG(79!Q9BR6n^OhZIi5Jt;Fm(^?IlNV)VQiM)}g)#HxKb&SCNp%!iK
z2@jTznx4X73Ir=>x5H=$8q5A^!<#5|$oALQKCKts3qL38XSe_7Zhvxeqy4i7f%G`G
zq(nD{Q9kW5X`gh{ELm8h#A8WJ<zrC{b9%oqG?A_xg9{uU`HD79Eh)i-B5RzJ718Wq
ztf)!()c+SKm_{_BR&v(7Ak$a>mRe`*Pm1Zr=XAS_rEsXpNB0g4U}}T5HlnJ~{4X=x
zgPLNg6llN%IYlwKP>IPKMS9*W?m5X+3}cNl)~KA(*HG+O<%+RVtc^w$N%u-V&f8;{
z6W7TB`H<=p2_))NOkS~0L(axnBksPm?4ueUv`n&-**dXIt~Jw>0q~i$|KGG|l%t-u
z@Q@3~bQdu-w3wpPgqntg%)L@9Q1znHgBFe0SQj-yH*_|#LIC{@t2Nvbh+;O8l}pkF
zjCQe5X5M004|%hVVqy>7!Y?KlQCK?TRz+*+AZ81Jy7ZErq6v%zx;%~1aB2Y-II3LE
zVL%_fI4y*ZxLNAfs0{(*LiM!t#4JI}t3WUqON97sPFtzNN|+vtdzRDy-B_e)<_>Z<
zO2(lN$y3qGd5UIsF$Jbo#HbZCZYP$k^()^tpqlZG63pc^A>;;uXbbK%2`tCGSe?S5
zBP~)hEJ*bR(u~TNE@{uvri!Bql{ZABhiJXSr|4LK@s2KMB=BomU+6b>sHSH7I)W*)
z(%|b1o>8ncGV?IAb%tUWb65)vms*K_M@3b6iO0Fd;ZX|1(Gcx<@ckIfd9jb6TjtsW
zalZ7EqEV&H)Q8#&y(b#Nnx8KQl|W-C98+o=qe1EeVyd)WB?rI`Md&o@^<o`Q%Ttpv
z689%wny{?w5Zq3>b^O?NN;74Qh4O^G(lquzXFV&8E2jG^R{VX-TJA@OvOj1yELgc+
z^b1zrI{JD2q4*OC_@}xP-KY8fgLcpGrq{-_w)cz0z1*V^`<Zqu(xPfaX2`5JgEBp{
z(A4^Frq?odg=>Wq17<i7ffK`KSrNotVQNWxEQYZc_kxXTxw=usmtsv5i5~*(m=UE^
zFO3kw8<1{G)HOC>uvQkQw<~BWf#H+3Z!-RDmKWLCiq+5}5ZBDYwCD;utv-Tcb4T)F
z3<+#d6PN|mhU+LZF7TTrGhRIt3hHN)%9vK1yG4HsWGuc<?vvLD_&W(_21I<Cgo=d6
zNEn|d=w!Ex8nF-R#0St5wE?+p!|N?PB3%!Cl+$UZ*C;JR_0&a~E7K9VfX`?L{pJz1
zZ&o=jgP)}36n%DkuJB-5g*l+mo-r-T+p{r|fJ?aLl%BItyBd?jD`*aZv5)^1l7w3t
zIfY*uQ&)IXu{g3xzy*Z8SA^vzI**IVOJO<Ye0*f*`<@NqB(?&vUtgPuH7MdifGD0x
zevyV8R3A(@X*VMXRmtD<QBHRUqLfa6$JfLn=o3O9()Cf{mpTd59y;-Y&L#0WON@zh
zoh0Pb#TYaCn5YNcSM>gz?zU_M?<vqLZu|a5zpgnW<JY23XWbt@dpxk~1_WtuGZ{q6
z)?1c=^!OkCKD`T8h<u;v-zNIOA5(!u3O+`E(GFoV|5||sMq@-w-?X(J9&IEWBiJ2D
z(H;ubi7wGDS^V+1N>lilX$Dg}WSWr`yz%$hLs=!;k;akA7(HqbkCe1tE61JBriwbz
z-?Uvbo7SmD>=i48n9<RL6)eK&#z1Mw)9{2SRj;I)@E`*ZkdiCX%YVM#*c6T~DN-C8
z>9&HKT_}RSlx+vDFm*?^=kKh)wM^9i3JieynIyl(L9Ra0fu$AQC8<jr`NdpNcrodt
z&nLZBpPiYNMfr5;WAYozGUOXooY?6nF36XUXOYIIVcH~HP&qwwv*!HSok2f}P#&kV
z#BWUF>AH&O+;kMbM$^m4wCZU28coli85KtJYcvynt!PqrlwLAlnkU2`(ehOh=eH>h
zu}~xY8utTCTN)#nJjo|bx|(AfUf%6#E=QMW3%}drtgv}5u5eYl%+kF+hsVJw+5F3k
zojx=E#mh8;<hQ#jea^}%SC!X;XGNKEGfOEUM$^ac@c5jiPDhDM*3!KWNGj23D&?os
zHBF7_nx@8dO;h-xyWDoMzue_=J1bX{UwVBuUzOKS$&@0lOuD#dl)LCFnA}e#za}Bg
zU+%JB=r8rSD%N_OK8L-^<8^sRK2LYRE*^)FCFFSR<^D=~rdFPbqj_A&d@+?nbVs$l
zyvmCesEl*TvJJIzmy}evN*tP~60eMxIcy~!N4d>Mxk;W(FL8Qp#pRU5FX+b?CsJry
zK`oss>$LNFb3Rn2%;qUsYx4*Z8XwZVu2SEqbi2<}z67nS@lm|g<G85GQE5jtv(nwR
z%B=VrS9w*1)Ks6}?eaQ(PFH263%)}_baK4V_QH!xUG^$(R{H94SFx?!B;DadOL@>d
zn$)7Kd=*tb2liTh6}D<v&S$H%YxNd84t|>5R@mHb>B49?x5IX!!{et0aF@9%HGVB!
z^t}w<MO8L#AC0bgHdh1oNT)+hS5>9#DVg-u4p)W4=ed|3Q<FV4{&ae!4H?%8ac1<j
z&JyllQtxy=RGGI=y17INnqI}abmBBghcB;oR&obN`=NRL<&IJ@kjS_lhIe?7RmPE_
zOzUT&`DLM?YjIu};@Y!$UT``tRYCtZEV?!Q?4}(O{MtZ(e7-7=913*lSsh-cdwl7U
zM3Z0auJpS~OT7-C*XMFmYKhnH!Vl!}3wWi=zsBkDRoTj&m!NaG&}ziv@Ob<-yWQdS
zmN+WYBce<%NB_crTB7lld*EFduFwxijDGwiImNaTv7(p!h<hECC8Bq)u5xN}vd6ZJ
z9wOc6a(OX4$?=Kg((vv<udKAKu{m|=CEn$J>eLwG(*8;OrPY!(J>-b`taem7JT$CG
z{hXC+P>mA1EX<hhws~w7q@BiJ>9Va}?QyJ5n@`HAbcy}C44;$ytJEfYt(NX8zQAGk
zVf-l7dX&)1<tuY|(3#6@UK)zi<+-YSuF?ueh07y{8(AJPl{?lr$}1g?5?*y7hm1|`
zqLo)wX>2ONS5@h)a=Tp~YFTl?uXJxmP=4JeCf7%_4ZZFob~e-bvNDo?>JuoQo?z)S
z%5vl17W2`eUkNxOp~WKJ^OJ0>P4eZxB={5w2Nq}Zxo;Kp<&y4}uy0v5pCb9{CB0R`
z_>ycsi{#rZ={qGXI4hfv^t|z%xgmmd;=qrvbQs}fO3Bcs0H29~?-Q|G4K(^;75XK#
z9?*IuZMi&;MWn-d6%>rtpX3i+C)+{7QDy#v^chu-OvoD+`WWfMQojS5p4SV$vNO%=
zWz7GNitEjjUzo#|zs4BeX&v(-ez%TZqr)i^$<Qu(QI>Ek0?E~187};e&#5`A4|KdE
zJLX0Fdvx?c9Zs1@hIZ-8CAs=5!-evYr|@-9DU5ODBHgN^R|7YeO<75nCR<-Vm#>qp
z@letr^7KF+-r*hd8V5?hjy?o@EFDM)$t0cW((6Ix=&!Od+KK&M&xId8*@yBGj8`G@
zYjx3=6F217cqo4x@@xVfd$psk*+_3k7^^%jgQj;r67=O7_15^wer|(KL?gYdx^&Ww
zc<Iv1C4Kc*zCrgx(V6m7n^+8aDLoHivo5_JdYHA}u#SiF&Hlro*-LN#osexsKI|!u
zx`<|0f8sa0Nbfx+awxrDmq%azFv_R~4SR#5E~1&0PyG68GvbG0^Vz4F%d2@qFHQJ?
zmO^=mj=j23*YF{ht7RlREZ50t2Yx7eyT{ObL??^N(A$;r5FLALV_u|Bv!vtGLoBy7
zw^d_44)<?L!*7AGmoS;LT+Y}+IN`_@jM1dq<1O+2F1O?Im**Z;@kFv?=gH3ST~xk(
z#kyo7xGvtpHv-qKZwyC5>#$E4Uxb8(friksr3-`c7Ch>YE?jcXI*%Gr14(tAZmVWd
zJhYw)X6$qs2%n3v+U_eSecW)0MJcs8H7^t<n)@i&u~tiKh*H`}3;Hsk;A@D^vsic?
z`cVgw)|{@3h_{3&A8W<@f#iqj!T!9nC<*fkRtUJrVhPsP;eK{K0>$kf-@IzOjd%)>
zMhiKaRz+#`*?gB!T0ASw$@4a6r*Xd4tTZ?0+mxNg`P#D5e4KA{b{gkvM_LWe*DXp=
zy`aczvJN~x&mKsoRyX1?`<mJmy>*x*LHP&av4e-^1s{yp<jzYViDACOEP$e{c^hMq
zR6_`HnoFk0wxZ0-FTXsr9_C~{Z)&=vg7cg<UWdM{v`cs$cIwl7g0DX-P4MkO+5t>b
z7d4Bz_8)*hkUl&<uNf%o`=e|xRq*8hi81;ub=mHGBV!-ZXr3$6mQcO}NYnYpQc9!W
zpX#FWgwHIaG**E7+82-}%}sNGRwVN{%#@F@tvM$h=R5YT=(B^<khVU_<II}FKAD6#
zohzX>JIIxTgZrl~&0~4R7z-xnvB^s(u*pRe;yL)eA)bbxT%J&rYssQ%X}Y{Kba|J-
zTJ!e9{}<xVa)i8TG!!gy<IjY7?6%yK@>q_L;Z8$Cc|zVqt_#Uak-RJM=Q@PkX>o|k
zyN#Wco6bKumv}8QZpoQGflUuhWYbZf=|xAx4_7_2>|oG2i*^V$Dtilcx(I*PA>>VK
zBOCSof7oa<$?L$MZiL)v1D~gjMz#Oj)c*Lh1R;0Y2<bA9;n%9N+da##=FFuwn~FA@
z!loyVi0?zYFNgmMyXLdWo(b_8Qzx*gpifOq8k!iNP(!}aMrC~uf9~RC6?_G5R>pob
zF84U()yg{}j~%ge5<8-3B0jB@$EK$yvhkq_Y~)nr#X#MMtS8be3h8WAI>rJWUsgNo
z{5~t4d}BRhM!T$h2jw~N=R$<sX%^^eYL_`Wx!nK3UVkP2T*vdRM748^av7T={fu}v
zgH&?|(ND?l%VX5NZvlQV8(}-L=<A-H4%_JXW*GVvm0N&;vTzRmoPdx!%}w^7$JXc0
zrnb}Uud7d%oeozz>9w?gO}{@sKCxzk`>>TUMmy%ci#kumpQ8{k9vx~st^|9%1Ai{$
z`Aplf2BaF5=-KT!R{t>T6J5w&xC4J4AUV_8{+2$`dLDl07GXEC>ir@+9n&5iAHQFi
z`1^wQpvPJGb1p*ew7x^NQwZ$!4fvDf`AqG!38b2vh@NeyoH6`8ZpFL-;dW%v*DE_6
z^DP~pnZL95QKw1xGaUir>|ytJ?#oBA=`TuOmOd!^lEpZtw2?mF!=JmjJ|l-}<2_)n
ze*u4f&GVVsct1!r?-Ct0K4vmICN+s26Ut}D_$IPraBn@P=;)!GiR0MBE#u<37T9(E
z6gK~Z2~62HksZ4?pH1IAiA@eoX5)R+Sf3LE!Uc>?`GD*{1(U!Dcp(MjE%+Gt82H#I
zK8!!Qe43wWwipY}Ibi}T2o<n`rPEl!{ZryKnA`6{xtBnN!l!`z0wH%=0hT5cUSYFx
zb4xR0)r{Gb*=*=C+c$~LUYgHl7tI_wa;P9qW8EjnRyh7cR01J)@<;{L%iER<kCOK(
z%sFWObmI72HXinAb2Iih!c4HA2p)ahOvf7VaUH`zVpPU7tI%<NZf<2pM?St8%Ifzp
z_BKMREK48PkB3}W(pTO)jB~w7<ZmZ2R*d>$y2&2EMEpFJu}h%{!JJ&|Euc=ud}(=_
zTn*05XEWh5GvPBcVUw9f1)2FJl~t^hb+EXUIb&8nn+0E-1slwQ%vnV<hDcxB64@Zu
zb*t;}bM4TVuDgLhsEbQI-J&0fc?IRg-JiV!zG?N?x0ZSLA$|(tTV?!A;45@=il3{a
zYqHZ&)@RZ&=qpR7vttrR56z4pRioMVGUQzwX6#3hPmt&H<hn=AU-NTVKG|tT4x6!F
zXRk>)Y!b!!eRL|DoWR^YKab@n^5WxaFmKn|K!f`G?V+Yo9j=vS66A9Ly5Ejx(~rd5
zdSWh{m~&LdA7+h5n>@m1<?Lh=$WQcT8ryej9_DkC*wiB2vnS=UNkyo;kw>3jhf~{<
zf6_&e`=td?%Rgr_n*$%21K*ni-<tzJnNu`ti1_KcJu2YP0Ri=Ya}ha!bOmcZ{Z)Vn
zt;^`r_V;E3-`v2Hvi@j$$$CDwEK|?eC)4T;Wf2dSzHAfH&2-UZ&|WQF`f@%n(MO}d
z26^0G$U|@t@mCOr5Zb(qy$6WFIP)gVqBu4>@J1G1F!t+`iL39=^jBQD*rnguD%QJN
z+BDj^N7|lGv=r>?<>at|Ymlt_4d&~|VeN}Oli|N)_|Bh*{V4dGqATNN^n*gkQ*`p4
zLmw!FygfR;*N`><K8ubo55IZ59DHtF+B~FHBW<TH?GmK*BhBo>9gD73Y8Qg}66Q!K
zz<+-C`ai#WEj;2szk4n0@UQZ_*Nz;#!HvUg8}O?6S{y=(HDS+>((o3&T9=@+5Hh(6
zZ;&i0S`>;z=&b>IuR-7&a@{R1{v{m$YBj1R!a?M=rBVs@g$aIli=VzWAx`^X<i)7!
zNF@At>lR7$+Hk|D+@SH?M~mEQlSjq(Yw$WEW@3wTkiR+Trxy$$CzfE7ArbH9`rUy<
zQuWc>w~U=5xz^C<VgwuZUrCn|mA}2rzCO;~QWXscV<FXVOIG<xmoxSe>4sD2elNbL
z;j71svLW^uB$daab^cPkNKXj+P~(yZ0wg0l1?l|!Ddfqju~VfU9vnHvCu*c7PL$0R
z^;fD*Y;igty}6HNa+(S|IPp+`9V4aSq$$3vBZQop&P9re@@&x%7g3m|;UEd#dBzfh
zWWr)-pOpCe&~~a9URn0@9QSFpv?X~R%QHG~ojwM=g1;5&w}nDD=mEh=963v|$59qE
z^1J9G2sq4#?IiH7c9zpw4%IK8TwoOnzLIbd<%vpZ7Wy<JncNT@;3aKHH!=_VbB05_
zgj|I6f>s|79j#}qQ_ErFubQ(2;%OZm(Imc_!o=g0CFcmAy^^hRx9HD}ka?`uB~|_u
z5OMy`YPI1<*;lQyWOG`r7ddP;s}1j3rt}i5R_i6~`&@1~D*J;iS!TnFIu5J#Vp|zr
zf2;Cqq7lLWYGh$|81vxOW77;(etNTtmxJGng;wDx+0*8Ba;Km?#xhDSpb}<|S&M2=
zQzT31IffOklclZ3x1j=&q+ghn>j(jRvh^p2#5+s$7N?0u#s0OV(N9L_k+sgM0U0?{
zX|y4pk5L09wRU_gXBEY*n5)STf?2IaYuqh3?L>7E%|H#ww&ko!s&L9wf|!f(Jk4sY
zLPJuslw=i3`u$hVsyZ|7EJn%+=3-cP@u(uXlfXK8!uAG*IMwYarjplKto{o~Fgh7O
zf?T53TCMJ7)R?GBreegCiCHf}*=OaT?I7EqK7B>zr<p7D&!Fl`XeKZ^pw6_Ai~rSS
zkoQGVmrN-Y<m==mXN!7dC{CgnRl<6ltwK+BX0?cy`(-98<x2Mil=|(QRYCqOj_iii
znkS35D`!<gjq^rKw>U9o$%Mk~IjeB=A`!(C(Ch{`GO{}b=Rvr>53Z!9blQWwqr3HJ
z??Vj}Ijgb{Fqzm#6V8oVWVIk0yDDduH&Cm}anz8h8dX`dn1&s;K=XrQdX~)Zk>aa(
zqq-pXv`kaz+<@fRH8~!&4nwe-a5SgXXcEVW<#|rt>9b4-FNWu4`Jm)=Mr&hME4h^%
zebLCW<NhkolZx2oc@KQL0IkGcp|tW?Y(rzbRGwXS;E+7V_t%NCCY(q$1|n5ai~+dM
z^pCHKinB8zObA3}OT!VU%-GfAF)WTrR&wE>+F3pEtu}V&cpv|s9Bx`}nZ#}!=S<2-
zEK!P+p}38>apno9cGy=zD^b@s*43#AE$wBJ%a2ht#;NLS*)^0RZk%QOm=9i(_T+I#
zaA&@EXU80i)IM>vUd|AkuS*qk4J5Mnd0G7HbUw^1Y)MpIC5+9_DG4X(>9k-j53f()
z6F7EEdy*_RE^|uOOSjlEn&aSI@=8a!HnYPUjedJ`b7>;bpbDiEOBp*EsmWBx4?Xc|
zBv=X0_QB^*imwO;{h}#g`x7N+`n!z&U@VR{JZV&V2nQ?^u@<bzsX(Y3Yf85yW5<G@
z&ncoQe_9qh&MXxr2oE}+;iDcH<r$kVOQV~EKa9rk%hLRGP>ZoOc25-!OjI})FSYm=
zi#dTlO{AcX^z8_IKCYh4VGUyH$W}3bQmyyba%c0?ba*!S_?caJh(8*@ytK(5NYrh_
z!$5}8wNuI(NsVp{Ct^`LRgCBTSsa)uH)GF%zh1!DO6JELocBY&q-dx5$)55vh8js^
znhRYLDL<MBg4pp|%#V*F1~(uJ64}v671%OSIyEasc&;nqeie19#phiZt7Dlq55&U@
z8<Gpr0T-f-h4@Nfd|_nq!o>?M!d?b?LQH%0EGwyn@M;TVUt?(fU_+cSLoOs^U7*jT
zZ87{)p|+Rw?4`<!wR=DPv}nt#3%_@U*iWLpvojT`p4?lL`y*+c%XW(QR<-n*X^KGH
zlHO|IqrEo$)h6kE2EOC;Ouz>uedv+wauoyL-y1d7$5_7mQBkh3KF0F<Bwu`&;FtSN
z^a@kf)hg*(iJuWM>Swg~&c{S~gA!`(Vzf7wIITphmQdp}*0)vC2Mv6RLB|nEU;c!U
ztI3;Z;B!m5(x1&&XyCI-db5EKkFc|@&5}N7;KTND_Vr^?Ud>Ok%Uzny#abnO=*et8
zETpq8jgRfl=3AM?h5b!QuQ%{n4ScPVzQ@2<V&K!{4IB8%41DY<SzigY_9!2Nui3!o
z9)oYQfzM~)>yz|?pJv;o+Q3&R=`{wvbq2mxNgp)u)fo8L&qR465^D9uq$2Ao*dzF|
z5<eqyu>PhzE#w);17m+1kbIv}lqtzrzOjEE?(xX|i^FT5_%lMD@~nVbyBO_bk#x6#
z&sg6YNjEi?Nn)WqkK?Y)E?;A{N;;nB^6^m9Poq~$dd)@V^kzxNGg{O9w@P~79CLcR
zCjTgNdXJ<lCz;dxB)#A`b9%p|x6d-C4`})4n$tBqj0KJM()gCk`?PUfw@5uSzRwNj
z<sFuytYe%zIxNEf0Yb)XA2~m<8p@2%7JgtzKJ3vEV>ySZeF|p$bI(uxt%e$_eR|~l
zZL@)4;MmWneMZ&eFttzLze)QP$osjmecF%z*KQwW*1t#pvC4Uj)!@iO%IDKQH76R%
zIZXYh{oka0s^z@U*nj#?HrUP3e*duOVQL@i(f?Zgr(Mpchvo^p8*VpjkEHj{H>WGl
ziS)ix%;{y4j`!|O=g0k$K2&H<KUjOWz98}yEHKZnm5+DdP0P1FFVfo<n$v3}-Mz@1
z-XrNlW6(AG_MK^-pAE?JE#`DZ(v`*L^p%p%ip=RXlHNWB{R&C9E-}yFCha>g27OrO
z??1~tKa=_0%gpJsC4FcN`f^E+pKYGsC+P*t&FOJT?;C@DF#popujX8H`O9Av>DHCz
zbj|<pj=ib>9jtuKzX#-Z-;DiJlOMO5%h&uHrwC2U*ZjMn*qpA_zkLk4=AW&0^ZY~7
zJ~bugbj|;m!<?@9U)vb;gV}HJmqISyJvXiY!SWmJJr@6<{I15ZgtV_t*U%x}52_y)
z`f2hPt+K7bZ+7|l!x<}{QCY2=WX6|%j&u+{E{}c#%#TMue(@V%S{5_8>8DI6+l-!m
zTnx=j=$Yr+=Jc$W0C?rb=F@$nO&G$YJd&s56Q6>UW;4^zz%L)$euka1<xBqTVh*7k
z@kKmMFRkAHEZ9GTv8hKgrr_*Y0pO(w!y`B=0=NUA;61z>4EPs>2#$~7)ge}a(EI^-
z0G~#nGq(eP^YJiZFK`RsO$bB4+W>bX3=<FFQL}Ic54aU@9l|HTu{Xu$9gX+)_aiUh
zAVLA~A;3zUqjdv!1GXbn11DIF4a6GY*sow)5!!(F0q#TC3>^Cl?Djd}rF6iPjsXO2
z0qjQDMd^T3kA?og3jiw-27tQ(A4C`gJ_Ps)!am}`W@Hp$Kkzu<69@-@_X8e(JoLwL
zO$G1*gekz?fHxt`1l|Yu41xl@U@pF$gHQ;(9kA>KJTE1Fz{e3%!21CU6nwXm_yO-n
zz;6UItY6ry6B+v<a0SqZunRcW8*Iu+ur;LvUWKq1cq`!Z2t&XJ02iJN{efEmFG2VK
zcn#nk2%iA&2Ydw~|83Y1@O(VLDFAK-Y(TIAj|281lmW-Qkv%jYdH}~9k#(E`KLL*U
zAp5_k!cTzf&s@?O&3=Sk#1FU!VJ~okFCpv)j=3PKKMnc-j{|;;kPrW)j{<xPVJ7f?
zz@yKA4S_3wRS4C<@ts@t1VRn*0R9DG6L8EA*>;3>;QDirbZ)YFA>JEDI>A<i0pJ90
zMi>T;xgoPJLR$mJJdphw!Gb=5IUn0`CZ1;l$NY}9Szr_31dm+|n*hhWjeUqv0~~WS
zwizJ;9P=?&v;<`W$J~qk0^xe#m}jwv&Vmf!m{YOU%fJg9^C$LegzdmFS7LQ%LucTa
z7qRin(eA)82Vz?h27qI}!-~&ATM`f8PZ36d4*-r|0lnS@KVS@@5O^GL2Z9@TKj6A^
z(FVXV?_tYU!Y6@aj>B5c!<ic3`ZI%c#&G5Nkd1VLB?!a733?FNd*BCr31K$yA;4Ly
zU@PGGo-Ml?!A(4Xk0CSz$9#uHtgr*{IA9L~o%bWSzy=7M;8KKs-~@{i27%KT6UG%o
z2jH03u<s%$@57FOn5VD>zzJ5B;9N3r%uU#P2qnNV4`G`S+`uvCU>C23Er=iRPJ|Tj
zcEFDit|0z0#?C_64jkX6Wp^R`kaz%pi|`8Y5x{$#=xf0BXW-}z-T%7~Hu*rnx(dhu
zPB4y854;U<CqgUme!zVQn}E}SwV9Qm16Ke`5H<tHa}IWg3*`fE2fW1%9f0f4tI;{O
zj}ep)1@v45`vJ!@4)&l2vViN)oY7gdQ@v<+q!YXrp&dA#F?q?4I#J#L#vFux;H`kW
z5OxFK4LFDp{|NP2kMRK^4|o^gAVL{%f^Q*MfsX*r4niJqf(sGqfm;CE5EcL@*pJ`_
zPH-<mHE@E*hhP`r3gA5m^MG#$EKy+x=tHm`VG7a-eiPw1;I{%khp-nsBY+cYF<t}5
z@3^v62+iPe1GXa+ek|Zab*L-ScLJ`gM_qvvYzRYN@Z1Xc0zwV&y@2^&hTj4w_%gyK
z;I9C_gU||m1n|ZUuoZBE-;bbN;I{)#YCye#PXW9V;dbD3R%tK7Zs2rI$P$Gufx7{(
zMd$;L--~6(#84OD#{qr`VF);Wcb08I*a^G~a5ut!-~{&}d;pxq(O#Ef90uMGctjF1
z4nPOMQiLhMeSq5#W&+;@_=ObO2zWi<HiYHCS2i;CZ3HXuX8_OMh<w181MWj815R*a
z6Z#tPrGPGk5b$ciTM;6_2@W7M6Mr+_QE7o4fad}F5pD%e=R;pb=mO3z$2mfTO~4hv
zQxMvKTL3E%tovarzy^de;Bmm45H<mC1KfcSdJA?0d=?=Bd;st*gzdmb0H=Nh^>`cO
z4B$e99^e+h3Iz8%2!IU;g(Hv;coV|xcOf5e2f{AkeSps*STSA=0KSDV`+dj<oO%W7
z0-O%GE=1UizDx&6=?rHx{F5M^kNgBUK|1fa>mvc_tmEvD#hFJsm#6?I_zprfaQ&6X
zBRTy2l-Y1cji#mNAi-jiPJ9^NShX8x3&){dL<ZnXk-CO?@g>1E7*svLoXmyq2l)Xj
zSt)S39?N^@uk^OjB!<kaC`W@B{`rM3ny_4nYaoP#9LP(t1Pik$-sLI<j4&0FqpX&}
zeVLW>SnwX2g`I=26grSbHEbU8+QHL+e=7J>3~tNn0aI}JBwNAG#J@U7Od++At!Il^
zkn^939Q7=~bH<P}1im<HVNG0%C3JgdCqcR<KMvj~=#@MV1{Hao&UrMQOQ1y(B~V@B
zC^L+*&}rqh6emG)()C*d-UPTaJWHV6IS5No$7O(MBW6V_=5Sl2IDZu7M|4_*kUs%R
z5T)VmNz{?*vWV9ug#0)mj(_FgsN*@wT2xQcu#Q_wC@1QX;q!qb07)t=6ac;f(zUCM
z>*SI$sMSa(%?1>s)<Azdh;A0Vp_#+nkP`!MBd>$rzHaEb7BZr+2(`y@Zoh1PqZQ3;
zSc1Gc@LZ~gre(&va9@F6ViW_F+Bk{21hU$0Qr^Bix2>cEpTn)LmdO9aIBUh&gqjR>
z4tI`p9_VCU1zoedl&-=qOV{!)Ygbv9yQ{jZri=AaoiUzuS9jNU$Ge-mTe~-P_jLDl
z@9ZAv9_$|K2C*OG4Zz^NL-!8fJ96)Vds%OOZ$U5iIN?7S=Q?(F^mpv(80Z-680r}A
zsNWLb(!8a0%cd=DTQ+ZL-_qRK+PSH-t#fl{duLB)UuSbyYuBc(wyw=x?Oi=xeO=bx
zvR-#@b#HxdytlcxwYRNzb8mZZPw&p&{@y*k1HD7N!@VQD2YT6%&|_!&K>J{OO-FM_
zYsaRJwhsC(6G+V3UejLRzNx*fy{~;|dqIb#V|hn)M-908xNZkJ*cN3=;g+&3ZmuEe
z*1u)Xmf<ZUTM9a7cP{U=cGh&(b6xv7cXkeT4#95u+-77g(wj8i(>2gF(xq&*ZY|qd
zzqNg9|JFTQhqsPwE!bw=R<o^s+oo-8+xoT*Z5!Uky7Rl0?!s<scUgB0>`S(7hjshA
z_rS8l-K;0Sr@ANJWBI{>9~9i(eD}cJoA2qnC%%384)>0Ndk10b>fXLyrsS|)s9!T`
z=0+Xzc`dA{N6nUcZfB~+5bD7?^E;K!Le!&-*M#g&Ht+A;gSrg!+9;@x742WsRnOa@
z9X0Alorb!GQKv#)s~TRf9$vE{)QxS+-==IUME%Nm4O>yi_H8}9j%D3$)NK<yX0SWI
dr?982r@p7HXJ^lF&+H$#e*m@rbNv%6@ZUD+?92cF

diff --git a/lib/win32comext/directsound/test/__init__.py b/lib/win32comext/directsound/test/__init__.py
deleted file mode 100644
index 447e0d44..00000000
--- a/lib/win32comext/directsound/test/__init__.py
+++ /dev/null
@@ -1 +0,0 @@
-# This is a Python package, imported by the win32com test suite.
diff --git a/lib/win32comext/directsound/test/ds_record.py b/lib/win32comext/directsound/test/ds_record.py
deleted file mode 100644
index 13c4d645..00000000
--- a/lib/win32comext/directsound/test/ds_record.py
+++ /dev/null
@@ -1,60 +0,0 @@
-import os
-import struct
-
-import pywintypes
-import win32api
-import win32com.directsound.directsound as ds
-import win32event
-
-
-def wav_header_pack(wfx, datasize):
-    return struct.pack(
-        "<4sl4s4slhhllhh4sl",
-        "RIFF",
-        36 + datasize,
-        "WAVE",
-        "fmt ",
-        16,
-        wfx.wFormatTag,
-        wfx.nChannels,
-        wfx.nSamplesPerSec,
-        wfx.nAvgBytesPerSec,
-        wfx.nBlockAlign,
-        wfx.wBitsPerSample,
-        "data",
-        datasize,
-    )
-
-
-d = ds.DirectSoundCaptureCreate(None, None)
-
-sdesc = ds.DSCBUFFERDESC()
-sdesc.dwBufferBytes = 352800  # 2 seconds
-sdesc.lpwfxFormat = pywintypes.WAVEFORMATEX()
-sdesc.lpwfxFormat.wFormatTag = pywintypes.WAVE_FORMAT_PCM
-sdesc.lpwfxFormat.nChannels = 2
-sdesc.lpwfxFormat.nSamplesPerSec = 44100
-sdesc.lpwfxFormat.nAvgBytesPerSec = 176400
-sdesc.lpwfxFormat.nBlockAlign = 4
-sdesc.lpwfxFormat.wBitsPerSample = 16
-
-print(sdesc)
-print(d)
-buffer = d.CreateCaptureBuffer(sdesc)
-
-event = win32event.CreateEvent(None, 0, 0, None)
-notify = buffer.QueryInterface(ds.IID_IDirectSoundNotify)
-
-notify.SetNotificationPositions((ds.DSBPN_OFFSETSTOP, event))
-
-buffer.Start(0)
-
-win32event.WaitForSingleObject(event, -1)
-
-data = buffer.Update(0, 352800)
-
-fname = os.path.join(win32api.GetTempPath(), "test_directsound_record.wav")
-f = open(fname, "wb")
-f.write(wav_header_pack(sdesc.lpwfxFormat, 352800))
-f.write(data)
-f.close()
diff --git a/lib/win32comext/directsound/test/ds_test.py b/lib/win32comext/directsound/test/ds_test.py
deleted file mode 100644
index 84259ee2..00000000
--- a/lib/win32comext/directsound/test/ds_test.py
+++ /dev/null
@@ -1,402 +0,0 @@
-import os
-import struct
-import sys
-import unittest
-
-import pythoncom
-import pywintypes
-import win32api
-import win32com.directsound.directsound as ds
-import win32event
-from pywin32_testutil import TestSkipped, find_test_fixture
-
-# next two lines are for for debugging:
-# import win32com
-# import directsound as ds
-
-WAV_FORMAT_PCM = 1
-WAV_HEADER_SIZE = struct.calcsize("<4sl4s4slhhllhh4sl")
-
-
-def wav_header_unpack(data):
-    (
-        riff,
-        riffsize,
-        wave,
-        fmt,
-        fmtsize,
-        format,
-        nchannels,
-        samplespersecond,
-        datarate,
-        blockalign,
-        bitspersample,
-        data,
-        datalength,
-    ) = struct.unpack("<4sl4s4slhhllhh4sl", data)
-
-    if riff != b"RIFF":
-        raise ValueError("invalid wav header")
-
-    if fmtsize != 16 or fmt != b"fmt " or data != b"data":
-        # fmt chuck is not first chunk, directly followed by data chuck
-        # It is nowhere required that they are, it is just very common
-        raise ValueError("cannot understand wav header")
-
-    wfx = pywintypes.WAVEFORMATEX()
-    wfx.wFormatTag = format
-    wfx.nChannels = nchannels
-    wfx.nSamplesPerSec = samplespersecond
-    wfx.nAvgBytesPerSec = datarate
-    wfx.nBlockAlign = blockalign
-    wfx.wBitsPerSample = bitspersample
-
-    return wfx, datalength
-
-
-def wav_header_pack(wfx, datasize):
-    return struct.pack(
-        "<4sl4s4slhhllhh4sl",
-        b"RIFF",
-        36 + datasize,
-        b"WAVE",
-        b"fmt ",
-        16,
-        wfx.wFormatTag,
-        wfx.nChannels,
-        wfx.nSamplesPerSec,
-        wfx.nAvgBytesPerSec,
-        wfx.nBlockAlign,
-        wfx.wBitsPerSample,
-        b"data",
-        datasize,
-    )
-
-
-class WAVEFORMATTest(unittest.TestCase):
-    def test_1_Type(self):
-        "WAVEFORMATEX type"
-        w = pywintypes.WAVEFORMATEX()
-        self.assertTrue(type(w) == pywintypes.WAVEFORMATEXType)
-
-    def test_2_Attr(self):
-        "WAVEFORMATEX attribute access"
-        # A wav header for a soundfile from a CD should look like this...
-        w = pywintypes.WAVEFORMATEX()
-        w.wFormatTag = pywintypes.WAVE_FORMAT_PCM
-        w.nChannels = 2
-        w.nSamplesPerSec = 44100
-        w.nAvgBytesPerSec = 176400
-        w.nBlockAlign = 4
-        w.wBitsPerSample = 16
-
-        self.assertTrue(w.wFormatTag == 1)
-        self.assertTrue(w.nChannels == 2)
-        self.assertTrue(w.nSamplesPerSec == 44100)
-        self.assertTrue(w.nAvgBytesPerSec == 176400)
-        self.assertTrue(w.nBlockAlign == 4)
-        self.assertTrue(w.wBitsPerSample == 16)
-
-
-class DSCAPSTest(unittest.TestCase):
-    def test_1_Type(self):
-        "DSCAPS type"
-        c = ds.DSCAPS()
-        self.assertTrue(type(c) == ds.DSCAPSType)
-
-    def test_2_Attr(self):
-        "DSCAPS attribute access"
-        c = ds.DSCAPS()
-        c.dwFlags = 1
-        c.dwMinSecondarySampleRate = 2
-        c.dwMaxSecondarySampleRate = 3
-        c.dwPrimaryBuffers = 4
-        c.dwMaxHwMixingAllBuffers = 5
-        c.dwMaxHwMixingStaticBuffers = 6
-        c.dwMaxHwMixingStreamingBuffers = 7
-        c.dwFreeHwMixingAllBuffers = 8
-        c.dwFreeHwMixingStaticBuffers = 9
-        c.dwFreeHwMixingStreamingBuffers = 10
-        c.dwMaxHw3DAllBuffers = 11
-        c.dwMaxHw3DStaticBuffers = 12
-        c.dwMaxHw3DStreamingBuffers = 13
-        c.dwFreeHw3DAllBuffers = 14
-        c.dwFreeHw3DStaticBuffers = 15
-        c.dwFreeHw3DStreamingBuffers = 16
-        c.dwTotalHwMemBytes = 17
-        c.dwFreeHwMemBytes = 18
-        c.dwMaxContigFreeHwMemBytes = 19
-        c.dwUnlockTransferRateHwBuffers = 20
-        c.dwPlayCpuOverheadSwBuffers = 21
-
-        self.assertTrue(c.dwFlags == 1)
-        self.assertTrue(c.dwMinSecondarySampleRate == 2)
-        self.assertTrue(c.dwMaxSecondarySampleRate == 3)
-        self.assertTrue(c.dwPrimaryBuffers == 4)
-        self.assertTrue(c.dwMaxHwMixingAllBuffers == 5)
-        self.assertTrue(c.dwMaxHwMixingStaticBuffers == 6)
-        self.assertTrue(c.dwMaxHwMixingStreamingBuffers == 7)
-        self.assertTrue(c.dwFreeHwMixingAllBuffers == 8)
-        self.assertTrue(c.dwFreeHwMixingStaticBuffers == 9)
-        self.assertTrue(c.dwFreeHwMixingStreamingBuffers == 10)
-        self.assertTrue(c.dwMaxHw3DAllBuffers == 11)
-        self.assertTrue(c.dwMaxHw3DStaticBuffers == 12)
-        self.assertTrue(c.dwMaxHw3DStreamingBuffers == 13)
-        self.assertTrue(c.dwFreeHw3DAllBuffers == 14)
-        self.assertTrue(c.dwFreeHw3DStaticBuffers == 15)
-        self.assertTrue(c.dwFreeHw3DStreamingBuffers == 16)
-        self.assertTrue(c.dwTotalHwMemBytes == 17)
-        self.assertTrue(c.dwFreeHwMemBytes == 18)
-        self.assertTrue(c.dwMaxContigFreeHwMemBytes == 19)
-        self.assertTrue(c.dwUnlockTransferRateHwBuffers == 20)
-        self.assertTrue(c.dwPlayCpuOverheadSwBuffers == 21)
-
-
-class DSBCAPSTest(unittest.TestCase):
-    def test_1_Type(self):
-        "DSBCAPS type"
-        c = ds.DSBCAPS()
-        self.assertTrue(type(c) == ds.DSBCAPSType)
-
-    def test_2_Attr(self):
-        "DSBCAPS attribute access"
-        c = ds.DSBCAPS()
-        c.dwFlags = 1
-        c.dwBufferBytes = 2
-        c.dwUnlockTransferRate = 3
-        c.dwPlayCpuOverhead = 4
-
-        self.assertTrue(c.dwFlags == 1)
-        self.assertTrue(c.dwBufferBytes == 2)
-        self.assertTrue(c.dwUnlockTransferRate == 3)
-        self.assertTrue(c.dwPlayCpuOverhead == 4)
-
-
-class DSCCAPSTest(unittest.TestCase):
-    def test_1_Type(self):
-        "DSCCAPS type"
-        c = ds.DSCCAPS()
-        self.assertTrue(type(c) == ds.DSCCAPSType)
-
-    def test_2_Attr(self):
-        "DSCCAPS attribute access"
-        c = ds.DSCCAPS()
-        c.dwFlags = 1
-        c.dwFormats = 2
-        c.dwChannels = 4
-
-        self.assertTrue(c.dwFlags == 1)
-        self.assertTrue(c.dwFormats == 2)
-        self.assertTrue(c.dwChannels == 4)
-
-
-class DSCBCAPSTest(unittest.TestCase):
-    def test_1_Type(self):
-        "DSCBCAPS type"
-        c = ds.DSCBCAPS()
-        self.assertTrue(type(c) == ds.DSCBCAPSType)
-
-    def test_2_Attr(self):
-        "DSCBCAPS attribute access"
-        c = ds.DSCBCAPS()
-        c.dwFlags = 1
-        c.dwBufferBytes = 2
-
-        self.assertTrue(c.dwFlags == 1)
-        self.assertTrue(c.dwBufferBytes == 2)
-
-
-class DSBUFFERDESCTest(unittest.TestCase):
-    def test_1_Type(self):
-        "DSBUFFERDESC type"
-        c = ds.DSBUFFERDESC()
-        self.assertTrue(type(c) == ds.DSBUFFERDESCType)
-
-    def test_2_Attr(self):
-        "DSBUFFERDESC attribute access"
-        c = ds.DSBUFFERDESC()
-        c.dwFlags = 1
-        c.dwBufferBytes = 2
-        c.lpwfxFormat = pywintypes.WAVEFORMATEX()
-        c.lpwfxFormat.wFormatTag = pywintypes.WAVE_FORMAT_PCM
-        c.lpwfxFormat.nChannels = 2
-        c.lpwfxFormat.nSamplesPerSec = 44100
-        c.lpwfxFormat.nAvgBytesPerSec = 176400
-        c.lpwfxFormat.nBlockAlign = 4
-        c.lpwfxFormat.wBitsPerSample = 16
-
-        self.assertTrue(c.dwFlags == 1)
-        self.assertTrue(c.dwBufferBytes == 2)
-        self.assertTrue(c.lpwfxFormat.wFormatTag == 1)
-        self.assertTrue(c.lpwfxFormat.nChannels == 2)
-        self.assertTrue(c.lpwfxFormat.nSamplesPerSec == 44100)
-        self.assertTrue(c.lpwfxFormat.nAvgBytesPerSec == 176400)
-        self.assertTrue(c.lpwfxFormat.nBlockAlign == 4)
-        self.assertTrue(c.lpwfxFormat.wBitsPerSample == 16)
-
-    def invalid_format(self, c):
-        c.lpwfxFormat = 17
-
-    def test_3_invalid_format(self):
-        "DSBUFFERDESC invalid lpwfxFormat assignment"
-        c = ds.DSBUFFERDESC()
-        self.assertRaises(ValueError, self.invalid_format, c)
-
-
-class DSCBUFFERDESCTest(unittest.TestCase):
-    def test_1_Type(self):
-        "DSCBUFFERDESC type"
-        c = ds.DSCBUFFERDESC()
-        self.assertTrue(type(c) == ds.DSCBUFFERDESCType)
-
-    def test_2_Attr(self):
-        "DSCBUFFERDESC attribute access"
-        c = ds.DSCBUFFERDESC()
-        c.dwFlags = 1
-        c.dwBufferBytes = 2
-        c.lpwfxFormat = pywintypes.WAVEFORMATEX()
-        c.lpwfxFormat.wFormatTag = pywintypes.WAVE_FORMAT_PCM
-        c.lpwfxFormat.nChannels = 2
-        c.lpwfxFormat.nSamplesPerSec = 44100
-        c.lpwfxFormat.nAvgBytesPerSec = 176400
-        c.lpwfxFormat.nBlockAlign = 4
-        c.lpwfxFormat.wBitsPerSample = 16
-
-        self.assertTrue(c.dwFlags == 1)
-        self.assertTrue(c.dwBufferBytes == 2)
-        self.assertTrue(c.lpwfxFormat.wFormatTag == 1)
-        self.assertTrue(c.lpwfxFormat.nChannels == 2)
-        self.assertTrue(c.lpwfxFormat.nSamplesPerSec == 44100)
-        self.assertTrue(c.lpwfxFormat.nAvgBytesPerSec == 176400)
-        self.assertTrue(c.lpwfxFormat.nBlockAlign == 4)
-        self.assertTrue(c.lpwfxFormat.wBitsPerSample == 16)
-
-    def invalid_format(self, c):
-        c.lpwfxFormat = 17
-
-    def test_3_invalid_format(self):
-        "DSCBUFFERDESC invalid lpwfxFormat assignment"
-        c = ds.DSCBUFFERDESC()
-        self.assertRaises(ValueError, self.invalid_format, c)
-
-
-class DirectSoundTest(unittest.TestCase):
-    # basic tests - mostly just exercise the functions
-    def testEnumerate(self):
-        """DirectSoundEnumerate() sanity tests"""
-
-        devices = ds.DirectSoundEnumerate()
-        # this might fail on machines without a sound card
-        self.assertTrue(len(devices))
-        # if we have an entry, it must be a tuple of size 3
-        self.assertTrue(len(devices[0]) == 3)
-
-    def testCreate(self):
-        """DirectSoundCreate()"""
-        try:
-            d = ds.DirectSoundCreate(None, None)
-        except pythoncom.com_error as exc:
-            if exc.hresult != ds.DSERR_NODRIVER:
-                raise
-            raise TestSkipped(exc)
-
-    def testPlay(self):
-        """Mesdames et Messieurs, la cour de Devin Dazzle"""
-        # relative to 'testall.py' in the win32com test suite.
-        extra = os.path.join(
-            os.path.dirname(sys.argv[0]), "../../win32comext/directsound/test"
-        )
-
-        fname = find_test_fixture("01-Intro.wav", extra)
-
-        with open(fname, "rb") as f:
-            hdr = f.read(WAV_HEADER_SIZE)
-            wfx, size = wav_header_unpack(hdr)
-
-            try:
-                d = ds.DirectSoundCreate(None, None)
-            except pythoncom.com_error as exc:
-                if exc.hresult != ds.DSERR_NODRIVER:
-                    raise
-                raise TestSkipped(exc)
-            d.SetCooperativeLevel(None, ds.DSSCL_PRIORITY)
-
-            sdesc = ds.DSBUFFERDESC()
-            sdesc.dwFlags = ds.DSBCAPS_STICKYFOCUS | ds.DSBCAPS_CTRLPOSITIONNOTIFY
-            sdesc.dwBufferBytes = size
-            sdesc.lpwfxFormat = wfx
-
-            buffer = d.CreateSoundBuffer(sdesc, None)
-
-            event = win32event.CreateEvent(None, 0, 0, None)
-            notify = buffer.QueryInterface(ds.IID_IDirectSoundNotify)
-
-            notify.SetNotificationPositions((ds.DSBPN_OFFSETSTOP, event))
-
-            buffer.Update(0, f.read(size))
-
-            buffer.Play(0)
-
-            win32event.WaitForSingleObject(event, -1)
-
-
-class DirectSoundCaptureTest(unittest.TestCase):
-    # basic tests - mostly just exercise the functions
-    def testEnumerate(self):
-        """DirectSoundCaptureEnumerate() sanity tests"""
-
-        devices = ds.DirectSoundCaptureEnumerate()
-        # this might fail on machines without a sound card
-        self.assertTrue(len(devices))
-        # if we have an entry, it must be a tuple of size 3
-        self.assertTrue(len(devices[0]) == 3)
-
-    def testCreate(self):
-        """DirectSoundCreate()"""
-        try:
-            d = ds.DirectSoundCaptureCreate(None, None)
-        except pythoncom.com_error as exc:
-            if exc.hresult != ds.DSERR_NODRIVER:
-                raise
-            raise TestSkipped(exc)
-
-    def testRecord(self):
-        try:
-            d = ds.DirectSoundCaptureCreate(None, None)
-        except pythoncom.com_error as exc:
-            if exc.hresult != ds.DSERR_NODRIVER:
-                raise
-            raise TestSkipped(exc)
-
-        sdesc = ds.DSCBUFFERDESC()
-        sdesc.dwBufferBytes = 352800  # 2 seconds
-        sdesc.lpwfxFormat = pywintypes.WAVEFORMATEX()
-        sdesc.lpwfxFormat.wFormatTag = pywintypes.WAVE_FORMAT_PCM
-        sdesc.lpwfxFormat.nChannels = 2
-        sdesc.lpwfxFormat.nSamplesPerSec = 44100
-        sdesc.lpwfxFormat.nAvgBytesPerSec = 176400
-        sdesc.lpwfxFormat.nBlockAlign = 4
-        sdesc.lpwfxFormat.wBitsPerSample = 16
-
-        buffer = d.CreateCaptureBuffer(sdesc)
-
-        event = win32event.CreateEvent(None, 0, 0, None)
-        notify = buffer.QueryInterface(ds.IID_IDirectSoundNotify)
-
-        notify.SetNotificationPositions((ds.DSBPN_OFFSETSTOP, event))
-
-        buffer.Start(0)
-
-        win32event.WaitForSingleObject(event, -1)
-        event.Close()
-
-        data = buffer.Update(0, 352800)
-        fname = os.path.join(win32api.GetTempPath(), "test_directsound_record.wav")
-        f = open(fname, "wb")
-        f.write(wav_header_pack(sdesc.lpwfxFormat, 352800))
-        f.write(data)
-        f.close()
-
-
-if __name__ == "__main__":
-    unittest.main()
diff --git a/lib/win32comext/ifilter/__init__.py b/lib/win32comext/ifilter/__init__.py
deleted file mode 100644
index cc577a23..00000000
--- a/lib/win32comext/ifilter/__init__.py
+++ /dev/null
@@ -1 +0,0 @@
-# empty file to designate as a package.
diff --git a/lib/win32comext/ifilter/demo/filterDemo.py b/lib/win32comext/ifilter/demo/filterDemo.py
deleted file mode 100644
index 30742d8a..00000000
--- a/lib/win32comext/ifilter/demo/filterDemo.py
+++ /dev/null
@@ -1,300 +0,0 @@
-import pythoncom
-import pywintypes
-from win32com import storagecon
-from win32com.ifilter import ifilter
-from win32com.ifilter.ifiltercon import *
-
-
-class FileParser:
-    # Property IDs for the Storage Property Set
-    PIDS_BODY = 0x00000013
-
-    # property IDs for HTML Storage Property Set
-    PIDH_DESCRIPTION = "DESCRIPTION"
-    PIDH_HREF = "A.HREF"
-    PIDH_IMGSRC = "IMG.SRC"
-
-    # conversion map to convert ifilter properties to more user friendly names
-    propertyToName = {
-        PSGUID_STORAGE: {PIDS_BODY: "body"},
-        PSGUID_SUMMARYINFORMATION: {
-            PIDSI_TITLE: "title",
-            PIDSI_SUBJECT: "description",
-            PIDSI_AUTHOR: "author",
-            PIDSI_KEYWORDS: "keywords",
-            PIDSI_COMMENTS: "comments",
-        },
-        PSGUID_HTMLINFORMATION: {PIDH_DESCRIPTION: "description"},
-        PSGUID_HTML2_INFORMATION: {PIDH_HREF: "href", PIDH_IMGSRC: "img"},
-    }
-
-    def __init__(self, verbose=False):
-        self.f = None
-        self.stg = None
-        self.verbose = verbose
-
-    def Close(self):
-        self.f = None
-        self.stg = None
-
-    def Parse(self, fileName, maxErrors=10):
-        properties = {}
-
-        try:
-            self._bind_to_filter(fileName)
-            try:
-                flags = self.f.Init(
-                    IFILTER_INIT_APPLY_INDEX_ATTRIBUTES
-                    | IFILTER_INIT_APPLY_OTHER_ATTRIBUTES
-                )
-                if flags == IFILTER_FLAGS_OLE_PROPERTIES and self.stg is not None:
-                    self._trace("filter requires to get properities via ole")
-                    self._get_properties(properties)
-
-                errCnt = 0
-                while True:
-                    try:
-                        # each chunk returns a tuple with the following:-
-                        # idChunk       = The chunk identifier. each chunk has a unique identifier
-                        # breakType     = The type of break that separates the previous chunk from the current chunk. Values are:-
-                        #                 CHUNK_NO_BREAK=0,CHUNK_EOW=1,CHUNK_EOS= 2,CHUNK_EOP= 3,CHUNK_EOC= 4
-                        # flags         = Flags indicate whether this chunk contains a text-type or a value-type property
-                        #                 locale = The language and sublanguage associated with a chunk of text
-                        # attr          = A tuple containing the property to be applied to the chunk. Tuple is (propertyset GUID, property ID)
-                        #                 Property ID can be a number or string
-                        # idChunkSource = The ID of the source of a chunk. The value of the idChunkSource member depends on the nature of the chunk
-                        # startSource   = The offset from which the source text for a derived chunk starts in the source chunk
-                        # lenSource     = The length in characters of the source text from which the current chunk was derived.
-                        #                 A zero value signifies character-by-character correspondence between the source text and the derived text.
-
-                        (
-                            idChunk,
-                            breakType,
-                            flags,
-                            locale,
-                            attr,
-                            idChunkSource,
-                            startSource,
-                            lenSource,
-                        ) = self.f.GetChunk()
-                        self._trace(
-                            "Chunk details:",
-                            idChunk,
-                            breakType,
-                            flags,
-                            locale,
-                            attr,
-                            idChunkSource,
-                            startSource,
-                            lenSource,
-                        )
-
-                        # attempt to map each property to a more user friendly name. If we don't know what it is just return
-                        # the set guid and property id. (note: the id can be a number or a string.
-                        propSet = self.propertyToName.get(attr[0])
-                        if propSet:
-                            propName = propSet.get(attr[1], "%s:%s" % attr)
-                        else:
-                            propName = "%s:%s" % attr
-
-                    except pythoncom.com_error as e:
-                        if e[0] == FILTER_E_END_OF_CHUNKS:
-                            # we have read all the chunks
-                            break
-                        elif e[0] in [
-                            FILTER_E_EMBEDDING_UNAVAILABLE,
-                            FILTER_E_LINK_UNAVAILABLE,
-                        ]:
-                            # the next chunk can't be read. Also keep track of the number of times we
-                            # fail as some filters (ie. the Msoft office ones can get stuck here)
-                            errCnt += 1
-                            if errCnt > maxErrors:
-                                raise
-                            else:
-                                continue
-                        elif e[0] == FILTER_E_ACCESS:
-                            self._trace("Access denied")
-                            raise
-                        elif e[0] == FILTER_E_PASSWORD:
-                            self._trace("Password required")
-                            raise
-                        else:
-                            # any other type of error really can't be recovered from
-                            raise
-
-                    # reset consecutive errors (some filters may get stuck in a lopp if embedding or link failures occurs
-                    errCnt = 0
-
-                    if flags == CHUNK_TEXT:
-                        # its a text segment - get all available text for this chunk.
-                        body_chunks = properties.setdefault(propName, [])
-                        self._get_text(body_chunks)
-                    elif flags == CHUNK_VALUE:
-                        # its a data segment - get the value
-                        properties[propName] = self.f.GetValue()
-                    else:
-                        self._trace("Unknown flag returned by GetChunk:", flags)
-            finally:
-                self.Close()
-
-        except pythoncom.com_error as e:
-            self._trace("ERROR processing file", e)
-            raise
-
-        return properties
-
-    def _bind_to_filter(self, fileName):
-        """
-        See if the file is a structured storage file or a normal file
-        and then return an ifilter interface by calling the appropriate bind/load function
-        """
-        if pythoncom.StgIsStorageFile(fileName):
-            self.stg = pythoncom.StgOpenStorage(
-                fileName, None, storagecon.STGM_READ | storagecon.STGM_SHARE_DENY_WRITE
-            )
-            try:
-                self.f = ifilter.BindIFilterFromStorage(self.stg)
-            except pythoncom.com_error as e:
-                if (
-                    e[0] == -2147467262
-                ):  # 0x80004002: # no interface, try the load interface (this happens for some MSoft files)
-                    self.f = ifilter.LoadIFilter(fileName)
-                else:
-                    raise
-        else:
-            self.f = ifilter.LoadIFilter(fileName)
-            self.stg = None
-
-    def _get_text(self, body_chunks):
-        """
-        Gets all the text for a particular chunk. We need to keep calling get text till all the
-        segments for this chunk are retrieved
-        """
-        while True:
-            try:
-                body_chunks.append(self.f.GetText())
-            except pythoncom.com_error as e:
-                if e[0] in [
-                    FILTER_E_NO_MORE_TEXT,
-                    FILTER_E_NO_MORE_TEXT,
-                    FILTER_E_NO_TEXT,
-                ]:
-                    break
-                else:
-                    raise  # not one of the values we were expecting
-
-    def _get_properties(self, properties):
-        """
-        Use OLE property sets to get base properties
-        """
-        try:
-            pss = self.stg.QueryInterface(pythoncom.IID_IPropertySetStorage)
-        except pythoncom.com_error as e:
-            self._trace("No Property information could be retrieved", e)
-            return
-
-        ps = pss.Open(PSGUID_SUMMARYINFORMATION)
-
-        props = (
-            PIDSI_TITLE,
-            PIDSI_SUBJECT,
-            PIDSI_AUTHOR,
-            PIDSI_KEYWORDS,
-            PIDSI_COMMENTS,
-        )
-
-        title, subject, author, keywords, comments = ps.ReadMultiple(props)
-        if title is not None:
-            properties["title"] = title
-        if subject is not None:
-            properties["description"] = subject
-        if author is not None:
-            properties["author"] = author
-        if keywords is not None:
-            properties["keywords"] = keywords
-        if comments is not None:
-            properties["comments"] = comments
-
-    def _trace(self, *args):
-        if self.verbose:
-            ret = " ".join([str(arg) for arg in args])
-            try:
-                print(ret)
-            except IOError:
-                pass
-
-
-def _usage():
-    import os
-
-    print("Usage: %s filename [verbose [dumpbody]]" % (os.path.basename(sys.argv[0]),))
-    print()
-    print("Where:-")
-    print("filename = name of the file to extract text & properties from")
-    print("verbose = 1=debug output, 0=no debug output (default=0)")
-    print("dumpbody = 1=print text content, 0=don't print content (default=1)")
-    print()
-    print("e.g. to dump a word file called spam.doc go:- filterDemo.py spam.doc")
-    print()
-    print("by default .htm, .txt, .doc, .dot, .xls, .xlt, .ppt are supported")
-    print("you can filter .pdf's by downloading adobes ifilter component. ")
-    print(
-        "(currently found at http://download.adobe.com/pub/adobe/acrobat/win/all/ifilter50.exe)."
-    )
-    print("ifilters for other filetypes are also available.")
-    print()
-    print(
-        "This extension is only supported on win2000 & winXP - because thats the only"
-    )
-    print("place the ifilter stuff is supported. For more info on the API check out ")
-    print("MSDN under ifilters")
-
-
-if __name__ == "__main__":
-    import operator
-    import sys
-
-    fName = ""
-    verbose = False
-    bDumpBody = True
-
-    if len(sys.argv) < 2:
-        _usage()
-        sys.exit(1)
-
-    try:
-        fName = sys.argv[1]
-        verbose = sys.argv[2] != "0"
-        bDumpBody = sys.argv[3] != "0"
-    except:
-        pass
-
-    p = FileParser(verbose)
-    propMap = p.Parse(fName)
-
-    if bDumpBody:
-        print("Body")
-        ch = " ".join(propMap.get("body", []))
-        try:
-            print(ch)
-        except UnicodeError:
-            print(ch.encode("iso8859-1", "ignore"))
-
-    print("Properties")
-    for propName, propValue in propMap.items():
-        print(propName, ":", end=" ")
-        if propName == "body":
-            print(
-                "<%s length: %d>"
-                % (
-                    propName,
-                    reduce(operator.add, [len(p) for p in propValue]),
-                )
-            )
-        elif type(propValue) == type([]):
-            print()
-            for pv in propValue:
-                print(pv)
-        else:
-            print(propValue)
-        print()
diff --git a/lib/win32comext/ifilter/ifilter.pyd b/lib/win32comext/ifilter/ifilter.pyd
deleted file mode 100644
index 52390f6f13d191e04f37a88c04a2c79715a330ae..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 30720
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

diff --git a/lib/win32comext/ifilter/ifiltercon.py b/lib/win32comext/ifilter/ifiltercon.py
deleted file mode 100644
index f29d536e..00000000
--- a/lib/win32comext/ifilter/ifiltercon.py
+++ /dev/null
@@ -1,110 +0,0 @@
-# manual stuff
-from pywintypes import IID
-
-PSGUID_STORAGE = IID("{B725F130-47EF-101A-A5F1-02608C9EEBAC}")
-PSGUID_SUMMARYINFORMATION = IID("{F29F85E0-4FF9-1068-AB91-08002B27B3D9}")
-PSGUID_HTMLINFORMATION = IID("{D1B5D3F0-C0B3-11CF-9A92-00A0C908DBF1}")
-PSGUID_HTML2_INFORMATION = IID("{C82BF597-B831-11D0-B733-00AA00A1EBD2}")
-
-IFILTER_INIT_CANON_PARAGRAPHS = 1
-IFILTER_INIT_HARD_LINE_BREAKS = 2
-IFILTER_INIT_CANON_HYPHENS = 4
-IFILTER_INIT_CANON_SPACES = 8
-IFILTER_INIT_APPLY_INDEX_ATTRIBUTES = 16
-IFILTER_INIT_APPLY_CRAWL_ATTRIBUTES = 256
-IFILTER_INIT_APPLY_OTHER_ATTRIBUTES = 32
-IFILTER_INIT_INDEXING_ONLY = 64
-IFILTER_INIT_SEARCH_LINKS = 128
-IFILTER_INIT_FILTER_OWNED_VALUE_OK = 512
-
-IFILTER_FLAGS_OLE_PROPERTIES = 1
-
-CHUNK_TEXT = 0x1
-CHUNK_VALUE = 0x2
-CHUNK_NO_BREAK = 0
-CHUNK_EOW = 1
-CHUNK_EOS = 2
-CHUNK_EOP = 3
-CHUNK_EOC = 4
-
-NOT_AN_ERROR = 0x00080000
-FILTER_E_END_OF_CHUNKS = -2147215616
-FILTER_E_NO_MORE_TEXT = -2147215615
-FILTER_E_NO_MORE_VALUES = -2147215614
-FILTER_E_ACCESS = -2147215613
-FILTER_W_MONIKER_CLIPPED = 0x00041704
-FILTER_E_NO_TEXT = -2147215611
-FILTER_E_NO_VALUES = -2147215610
-FILTER_E_EMBEDDING_UNAVAILABLE = -2147215609
-FILTER_E_LINK_UNAVAILABLE = -2147215608
-FILTER_S_LAST_TEXT = 0x00041709
-FILTER_S_LAST_VALUES = 0x0004170A
-FILTER_E_PASSWORD = -2147215605
-FILTER_E_UNKNOWNFORMAT = -2147215604
-
-# Generated by h2py from PropIdl.h
-PROPSETFLAG_DEFAULT = 0
-PROPSETFLAG_NONSIMPLE = 1
-PROPSETFLAG_ANSI = 2
-PROPSETFLAG_UNBUFFERED = 4
-PROPSETFLAG_CASE_SENSITIVE = 8
-PROPSET_BEHAVIOR_CASE_SENSITIVE = 1
-PID_DICTIONARY = 0
-PID_CODEPAGE = 0x1
-PID_FIRST_USABLE = 0x2
-PID_FIRST_NAME_DEFAULT = 0xFFF
-PID_LOCALE = -2147483648
-PID_MODIFY_TIME = -2147483647
-PID_SECURITY = -2147483646
-PID_BEHAVIOR = -2147483645
-PID_ILLEGAL = -1
-PID_MIN_READONLY = -2147483648
-PID_MAX_READONLY = -1073741825
-PIDDI_THUMBNAIL = 0x00000002
-PIDSI_TITLE = 0x00000002
-PIDSI_SUBJECT = 0x00000003
-PIDSI_AUTHOR = 0x00000004
-PIDSI_KEYWORDS = 0x00000005
-PIDSI_COMMENTS = 0x00000006
-PIDSI_TEMPLATE = 0x00000007
-PIDSI_LASTAUTHOR = 0x00000008
-PIDSI_REVNUMBER = 0x00000009
-PIDSI_EDITTIME = 0x0000000A
-PIDSI_LASTPRINTED = 0x0000000B
-PIDSI_CREATE_DTM = 0x0000000C
-PIDSI_LASTSAVE_DTM = 0x0000000D
-PIDSI_PAGECOUNT = 0x0000000E
-PIDSI_WORDCOUNT = 0x0000000F
-PIDSI_CHARCOUNT = 0x00000010
-PIDSI_THUMBNAIL = 0x00000011
-PIDSI_APPNAME = 0x00000012
-PIDSI_DOC_SECURITY = 0x00000013
-PIDDSI_CATEGORY = 0x00000002
-PIDDSI_PRESFORMAT = 0x00000003
-PIDDSI_BYTECOUNT = 0x00000004
-PIDDSI_LINECOUNT = 0x00000005
-PIDDSI_PARCOUNT = 0x00000006
-PIDDSI_SLIDECOUNT = 0x00000007
-PIDDSI_NOTECOUNT = 0x00000008
-PIDDSI_HIDDENCOUNT = 0x00000009
-PIDDSI_MMCLIPCOUNT = 0x0000000A
-PIDDSI_SCALE = 0x0000000B
-PIDDSI_HEADINGPAIR = 0x0000000C
-PIDDSI_DOCPARTS = 0x0000000D
-PIDDSI_MANAGER = 0x0000000E
-PIDDSI_COMPANY = 0x0000000F
-PIDDSI_LINKSDIRTY = 0x00000010
-PIDMSI_EDITOR = 0x00000002
-PIDMSI_SUPPLIER = 0x00000003
-PIDMSI_SOURCE = 0x00000004
-PIDMSI_SEQUENCE_NO = 0x00000005
-PIDMSI_PROJECT = 0x00000006
-PIDMSI_STATUS = 0x00000007
-PIDMSI_OWNER = 0x00000008
-PIDMSI_RATING = 0x00000009
-PIDMSI_PRODUCTION = 0x0000000A
-PIDMSI_COPYRIGHT = 0x0000000B
-PRSPEC_INVALID = -1
-PRSPEC_LPWSTR = 0
-PRSPEC_PROPID = 1
-CCH_MAX_PROPSTG_NAME = 31
diff --git a/lib/win32comext/internet/__init__.py b/lib/win32comext/internet/__init__.py
deleted file mode 100644
index 8d5db8b9..00000000
--- a/lib/win32comext/internet/__init__.py
+++ /dev/null
@@ -1,4 +0,0 @@
-# See if we have a special directory for the binaries (for developers)
-import win32com
-
-win32com.__PackageSupportBuildPath__(__path__)
diff --git a/lib/win32comext/internet/inetcon.py b/lib/win32comext/internet/inetcon.py
deleted file mode 100644
index 413eccf6..00000000
--- a/lib/win32comext/internet/inetcon.py
+++ /dev/null
@@ -1,261 +0,0 @@
-INET_E_USE_DEFAULT_PROTOCOLHANDLER = -2146697199  # _HRESULT_TYPEDEF_(0x800C0011L)
-INET_E_USE_DEFAULT_SETTING = -2146697198  # _HRESULT_TYPEDEF_(0x800C0012L)
-INET_E_DEFAULT_ACTION = INET_E_USE_DEFAULT_PROTOCOLHANDLER
-INET_E_QUERYOPTION_UNKNOWN = -2146697197  # _HRESULT_TYPEDEF_(0x800C0013L)
-INET_E_REDIRECTING = -2146697196  # _HRESULT_TYPEDEF_(0x800C0014L)
-
-INET_E_INVALID_URL = -2146697214  # _HRESULT_TYPEDEF_(0x800C0002L)
-INET_E_NO_SESSION = -2146697213  # _HRESULT_TYPEDEF_(0x800C0003L)
-INET_E_CANNOT_CONNECT = -2146697212  # _HRESULT_TYPEDEF_(0x800C0004L)
-INET_E_RESOURCE_NOT_FOUND = -2146697211  # _HRESULT_TYPEDEF_(0x800C0005L)
-INET_E_OBJECT_NOT_FOUND = -2146697210  # _HRESULT_TYPEDEF_(0x800C0006L)
-INET_E_DATA_NOT_AVAILABLE = -2146697209  # _HRESULT_TYPEDEF_(0x800C0007L)
-INET_E_DOWNLOAD_FAILURE = -2146697208  # _HRESULT_TYPEDEF_(0x800C0008L)
-INET_E_AUTHENTICATION_REQUIRED = -2146697207  # _HRESULT_TYPEDEF_(0x800C0009L)
-INET_E_NO_VALID_MEDIA = -2146697206  # _HRESULT_TYPEDEF_(0x800C000AL)
-INET_E_CONNECTION_TIMEOUT = -2146697205  # _HRESULT_TYPEDEF_(0x800C000BL)
-INET_E_INVALID_REQUEST = -2146697204  # _HRESULT_TYPEDEF_(0x800C000CL)
-INET_E_UNKNOWN_PROTOCOL = -2146697203  # _HRESULT_TYPEDEF_(0x800C000DL)
-INET_E_SECURITY_PROBLEM = -2146697202  # _HRESULT_TYPEDEF_(0x800C000EL)
-INET_E_CANNOT_LOAD_DATA = -2146697201  # _HRESULT_TYPEDEF_(0x800C000FL)
-INET_E_CANNOT_INSTANTIATE_OBJECT = -2146697200  # _HRESULT_TYPEDEF_(0x800C0010L)
-INET_E_INVALID_CERTIFICATE = -2146697191  # _HRESULT_TYPEDEF_(0x800C0019L)
-INET_E_REDIRECT_FAILED = -2146697196  # _HRESULT_TYPEDEF_(0x800C0014L)
-INET_E_REDIRECT_TO_DIR = -2146697195  # _HRESULT_TYPEDEF_(0x800C0015L)
-INET_E_CANNOT_LOCK_REQUEST = -2146697194  # _HRESULT_TYPEDEF_(0x800C0016L)
-INET_E_USE_EXTEND_BINDING = -2146697193  # _HRESULT_TYPEDEF_(0x800C0017L)
-INET_E_TERMINATED_BIND = -2146697192  # _HRESULT_TYPEDEF_(0x800C0018L)
-INET_E_CODE_DOWNLOAD_DECLINED = -2146696960  # _HRESULT_TYPEDEF_(0x800C0100L)
-INET_E_RESULT_DISPATCHED = -2146696704  # _HRESULT_TYPEDEF_(0x800C0200L)
-INET_E_CANNOT_REPLACE_SFP_FILE = -2146696448  # _HRESULT_TYPEDEF_(0x800C0300L)
-INET_E_CODE_INSTALL_SUPPRESSED = -2146696192  # _HRESULT_TYPEDEF_(0x800C0400L)
-INET_E_CODE_INSTALL_BLOCKED_BY_HASH_POLICY = (
-    -2146695936
-)  # _HRESULT_TYPEDEF_(0x800C0500L)
-
-# Generated by h2py from UrlMon.h
-MKSYS_URLMONIKER = 6
-URL_MK_LEGACY = 0
-URL_MK_UNIFORM = 1
-URL_MK_NO_CANONICALIZE = 2
-FIEF_FLAG_FORCE_JITUI = 0x1
-FIEF_FLAG_PEEK = 0x2
-FIEF_FLAG_SKIP_INSTALLED_VERSION_CHECK = 0x4
-FMFD_DEFAULT = 0x00000000
-FMFD_URLASFILENAME = 0x00000001
-FMFD_ENABLEMIMESNIFFING = 0x00000002
-FMFD_IGNOREMIMETEXTPLAIN = 0x00000004
-URLMON_OPTION_USERAGENT = 0x10000001
-URLMON_OPTION_USERAGENT_REFRESH = 0x10000002
-URLMON_OPTION_URL_ENCODING = 0x10000004
-URLMON_OPTION_USE_BINDSTRINGCREDS = 0x10000008
-URLMON_OPTION_USE_BROWSERAPPSDOCUMENTS = 0x10000010
-CF_NULL = 0
-Uri_CREATE_ALLOW_RELATIVE = 0x00000001
-Uri_CREATE_ALLOW_IMPLICIT_WILDCARD_SCHEME = 0x00000002
-Uri_CREATE_ALLOW_IMPLICIT_FILE_SCHEME = 0x00000004
-Uri_CREATE_NOFRAG = 0x00000008
-Uri_CREATE_NO_CANONICALIZE = 0x00000010
-Uri_CREATE_CANONICALIZE = 0x00000100
-Uri_CREATE_FILE_USE_DOS_PATH = 0x00000020
-Uri_CREATE_DECODE_EXTRA_INFO = 0x00000040
-Uri_CREATE_NO_DECODE_EXTRA_INFO = 0x00000080
-Uri_CREATE_CRACK_UNKNOWN_SCHEMES = 0x00000200
-Uri_CREATE_NO_CRACK_UNKNOWN_SCHEMES = 0x00000400
-Uri_CREATE_PRE_PROCESS_HTML_URI = 0x00000800
-Uri_CREATE_NO_PRE_PROCESS_HTML_URI = 0x00001000
-Uri_CREATE_IE_SETTINGS = 0x00002000
-Uri_CREATE_NO_IE_SETTINGS = 0x00004000
-Uri_CREATE_NO_ENCODE_FORBIDDEN_CHARACTERS = 0x00008000
-Uri_DISPLAY_NO_FRAGMENT = 0x00000001
-Uri_PUNYCODE_IDN_HOST = 0x00000002
-Uri_DISPLAY_IDN_HOST = 0x00000004
-Uri_ENCODING_USER_INFO_AND_PATH_IS_PERCENT_ENCODED_UTF8 = 0x00000001
-Uri_ENCODING_USER_INFO_AND_PATH_IS_CP = 0x00000002
-Uri_ENCODING_HOST_IS_IDN = 0x00000004
-Uri_ENCODING_HOST_IS_PERCENT_ENCODED_UTF8 = 0x00000008
-Uri_ENCODING_HOST_IS_PERCENT_ENCODED_CP = 0x00000010
-Uri_ENCODING_QUERY_AND_FRAGMENT_IS_PERCENT_ENCODED_UTF8 = 0x00000020
-Uri_ENCODING_QUERY_AND_FRAGMENT_IS_CP = 0x00000040
-Uri_ENCODING_RFC = (
-    Uri_ENCODING_USER_INFO_AND_PATH_IS_PERCENT_ENCODED_UTF8
-    | Uri_ENCODING_HOST_IS_PERCENT_ENCODED_UTF8
-    | Uri_ENCODING_QUERY_AND_FRAGMENT_IS_PERCENT_ENCODED_UTF8
-)
-UriBuilder_USE_ORIGINAL_FLAGS = 0x00000001
-WININETINFO_OPTION_LOCK_HANDLE = 65534
-URLOSTRM_USECACHEDCOPY_ONLY = 0x1
-URLOSTRM_USECACHEDCOPY = 0x2
-URLOSTRM_GETNEWESTVERSION = 0x3
-SET_FEATURE_ON_THREAD = 0x00000001
-SET_FEATURE_ON_PROCESS = 0x00000002
-SET_FEATURE_IN_REGISTRY = 0x00000004
-SET_FEATURE_ON_THREAD_LOCALMACHINE = 0x00000008
-SET_FEATURE_ON_THREAD_INTRANET = 0x00000010
-SET_FEATURE_ON_THREAD_TRUSTED = 0x00000020
-SET_FEATURE_ON_THREAD_INTERNET = 0x00000040
-SET_FEATURE_ON_THREAD_RESTRICTED = 0x00000080
-GET_FEATURE_FROM_THREAD = 0x00000001
-GET_FEATURE_FROM_PROCESS = 0x00000002
-GET_FEATURE_FROM_REGISTRY = 0x00000004
-GET_FEATURE_FROM_THREAD_LOCALMACHINE = 0x00000008
-GET_FEATURE_FROM_THREAD_INTRANET = 0x00000010
-GET_FEATURE_FROM_THREAD_TRUSTED = 0x00000020
-GET_FEATURE_FROM_THREAD_INTERNET = 0x00000040
-GET_FEATURE_FROM_THREAD_RESTRICTED = 0x00000080
-PROTOCOLFLAG_NO_PICS_CHECK = 0x00000001
-MUTZ_NOSAVEDFILECHECK = 0x00000001
-MUTZ_ISFILE = 0x00000002
-MUTZ_ACCEPT_WILDCARD_SCHEME = 0x00000080
-MUTZ_ENFORCERESTRICTED = 0x00000100
-MUTZ_RESERVED = 0x00000200
-MUTZ_REQUIRESAVEDFILECHECK = 0x00000400
-MUTZ_DONT_UNESCAPE = 0x00000800
-MUTZ_DONT_USE_CACHE = 0x00001000
-MUTZ_FORCE_INTRANET_FLAGS = 0x00002000
-MUTZ_IGNORE_ZONE_MAPPINGS = 0x00004000
-MAX_SIZE_SECURITY_ID = 512
-URLACTION_MIN = 0x00001000
-URLACTION_DOWNLOAD_MIN = 0x00001000
-URLACTION_DOWNLOAD_SIGNED_ACTIVEX = 0x00001001
-URLACTION_DOWNLOAD_UNSIGNED_ACTIVEX = 0x00001004
-URLACTION_DOWNLOAD_CURR_MAX = 0x00001004
-URLACTION_DOWNLOAD_MAX = 0x000011FF
-URLACTION_ACTIVEX_MIN = 0x00001200
-URLACTION_ACTIVEX_RUN = 0x00001200
-URLPOLICY_ACTIVEX_CHECK_LIST = 0x00010000
-URLACTION_ACTIVEX_OVERRIDE_OBJECT_SAFETY = 0x00001201
-URLACTION_ACTIVEX_OVERRIDE_DATA_SAFETY = 0x00001202
-URLACTION_ACTIVEX_OVERRIDE_SCRIPT_SAFETY = 0x00001203
-URLACTION_SCRIPT_OVERRIDE_SAFETY = 0x00001401
-URLACTION_ACTIVEX_CONFIRM_NOOBJECTSAFETY = 0x00001204
-URLACTION_ACTIVEX_TREATASUNTRUSTED = 0x00001205
-URLACTION_ACTIVEX_NO_WEBOC_SCRIPT = 0x00001206
-URLACTION_ACTIVEX_OVERRIDE_REPURPOSEDETECTION = 0x00001207
-URLACTION_ACTIVEX_OVERRIDE_OPTIN = 0x00001208
-URLACTION_ACTIVEX_SCRIPTLET_RUN = 0x00001209
-URLACTION_ACTIVEX_DYNSRC_VIDEO_AND_ANIMATION = 0x0000120A
-URLACTION_ACTIVEX_CURR_MAX = 0x0000120A
-URLACTION_ACTIVEX_MAX = 0x000013FF
-URLACTION_SCRIPT_MIN = 0x00001400
-URLACTION_SCRIPT_RUN = 0x00001400
-URLACTION_SCRIPT_JAVA_USE = 0x00001402
-URLACTION_SCRIPT_SAFE_ACTIVEX = 0x00001405
-URLACTION_CROSS_DOMAIN_DATA = 0x00001406
-URLACTION_SCRIPT_PASTE = 0x00001407
-URLACTION_ALLOW_XDOMAIN_SUBFRAME_RESIZE = 0x00001408
-URLACTION_SCRIPT_CURR_MAX = 0x00001408
-URLACTION_SCRIPT_MAX = 0x000015FF
-URLACTION_HTML_MIN = 0x00001600
-URLACTION_HTML_SUBMIT_FORMS = 0x00001601
-URLACTION_HTML_SUBMIT_FORMS_FROM = 0x00001602
-URLACTION_HTML_SUBMIT_FORMS_TO = 0x00001603
-URLACTION_HTML_FONT_DOWNLOAD = 0x00001604
-URLACTION_HTML_JAVA_RUN = 0x00001605
-URLACTION_HTML_USERDATA_SAVE = 0x00001606
-URLACTION_HTML_SUBFRAME_NAVIGATE = 0x00001607
-URLACTION_HTML_META_REFRESH = 0x00001608
-URLACTION_HTML_MIXED_CONTENT = 0x00001609
-URLACTION_HTML_INCLUDE_FILE_PATH = 0x0000160A
-URLACTION_HTML_MAX = 0x000017FF
-URLACTION_SHELL_MIN = 0x00001800
-URLACTION_SHELL_INSTALL_DTITEMS = 0x00001800
-URLACTION_SHELL_MOVE_OR_COPY = 0x00001802
-URLACTION_SHELL_FILE_DOWNLOAD = 0x00001803
-URLACTION_SHELL_VERB = 0x00001804
-URLACTION_SHELL_WEBVIEW_VERB = 0x00001805
-URLACTION_SHELL_SHELLEXECUTE = 0x00001806
-URLACTION_SHELL_EXECUTE_HIGHRISK = 0x00001806
-URLACTION_SHELL_EXECUTE_MODRISK = 0x00001807
-URLACTION_SHELL_EXECUTE_LOWRISK = 0x00001808
-URLACTION_SHELL_POPUPMGR = 0x00001809
-URLACTION_SHELL_RTF_OBJECTS_LOAD = 0x0000180A
-URLACTION_SHELL_ENHANCED_DRAGDROP_SECURITY = 0x0000180B
-URLACTION_SHELL_EXTENSIONSECURITY = 0x0000180C
-URLACTION_SHELL_SECURE_DRAGSOURCE = 0x0000180D
-URLACTION_SHELL_CURR_MAX = 0x0000180D
-URLACTION_SHELL_MAX = 0x000019FF
-URLACTION_NETWORK_MIN = 0x00001A00
-URLACTION_CREDENTIALS_USE = 0x00001A00
-URLPOLICY_CREDENTIALS_SILENT_LOGON_OK = 0x00000000
-URLPOLICY_CREDENTIALS_MUST_PROMPT_USER = 0x00010000
-URLPOLICY_CREDENTIALS_CONDITIONAL_PROMPT = 0x00020000
-URLPOLICY_CREDENTIALS_ANONYMOUS_ONLY = 0x00030000
-URLACTION_AUTHENTICATE_CLIENT = 0x00001A01
-URLPOLICY_AUTHENTICATE_CLEARTEXT_OK = 0x00000000
-URLPOLICY_AUTHENTICATE_CHALLENGE_RESPONSE = 0x00010000
-URLPOLICY_AUTHENTICATE_MUTUAL_ONLY = 0x00030000
-URLACTION_COOKIES = 0x00001A02
-URLACTION_COOKIES_SESSION = 0x00001A03
-URLACTION_CLIENT_CERT_PROMPT = 0x00001A04
-URLACTION_COOKIES_THIRD_PARTY = 0x00001A05
-URLACTION_COOKIES_SESSION_THIRD_PARTY = 0x00001A06
-URLACTION_COOKIES_ENABLED = 0x00001A10
-URLACTION_NETWORK_CURR_MAX = 0x00001A10
-URLACTION_NETWORK_MAX = 0x00001BFF
-URLACTION_JAVA_MIN = 0x00001C00
-URLACTION_JAVA_PERMISSIONS = 0x00001C00
-URLPOLICY_JAVA_PROHIBIT = 0x00000000
-URLPOLICY_JAVA_HIGH = 0x00010000
-URLPOLICY_JAVA_MEDIUM = 0x00020000
-URLPOLICY_JAVA_LOW = 0x00030000
-URLPOLICY_JAVA_CUSTOM = 0x00800000
-URLACTION_JAVA_CURR_MAX = 0x00001C00
-URLACTION_JAVA_MAX = 0x00001CFF
-URLACTION_INFODELIVERY_MIN = 0x00001D00
-URLACTION_INFODELIVERY_NO_ADDING_CHANNELS = 0x00001D00
-URLACTION_INFODELIVERY_NO_EDITING_CHANNELS = 0x00001D01
-URLACTION_INFODELIVERY_NO_REMOVING_CHANNELS = 0x00001D02
-URLACTION_INFODELIVERY_NO_ADDING_SUBSCRIPTIONS = 0x00001D03
-URLACTION_INFODELIVERY_NO_EDITING_SUBSCRIPTIONS = 0x00001D04
-URLACTION_INFODELIVERY_NO_REMOVING_SUBSCRIPTIONS = 0x00001D05
-URLACTION_INFODELIVERY_NO_CHANNEL_LOGGING = 0x00001D06
-URLACTION_INFODELIVERY_CURR_MAX = 0x00001D06
-URLACTION_INFODELIVERY_MAX = 0x00001DFF
-URLACTION_CHANNEL_SOFTDIST_MIN = 0x00001E00
-URLACTION_CHANNEL_SOFTDIST_PERMISSIONS = 0x00001E05
-URLPOLICY_CHANNEL_SOFTDIST_PROHIBIT = 0x00010000
-URLPOLICY_CHANNEL_SOFTDIST_PRECACHE = 0x00020000
-URLPOLICY_CHANNEL_SOFTDIST_AUTOINSTALL = 0x00030000
-URLACTION_CHANNEL_SOFTDIST_MAX = 0x00001EFF
-URLACTION_BEHAVIOR_MIN = 0x00002000
-URLACTION_BEHAVIOR_RUN = 0x00002000
-URLPOLICY_BEHAVIOR_CHECK_LIST = 0x00010000
-URLACTION_FEATURE_MIN = 0x00002100
-URLACTION_FEATURE_MIME_SNIFFING = 0x00002100
-URLACTION_FEATURE_ZONE_ELEVATION = 0x00002101
-URLACTION_FEATURE_WINDOW_RESTRICTIONS = 0x00002102
-URLACTION_FEATURE_SCRIPT_STATUS_BAR = 0x00002103
-URLACTION_FEATURE_FORCE_ADDR_AND_STATUS = 0x00002104
-URLACTION_FEATURE_BLOCK_INPUT_PROMPTS = 0x00002105
-URLACTION_AUTOMATIC_DOWNLOAD_UI_MIN = 0x00002200
-URLACTION_AUTOMATIC_DOWNLOAD_UI = 0x00002200
-URLACTION_AUTOMATIC_ACTIVEX_UI = 0x00002201
-URLACTION_ALLOW_RESTRICTEDPROTOCOLS = 0x00002300
-URLACTION_ALLOW_APEVALUATION = 0x00002301
-URLACTION_WINDOWS_BROWSER_APPLICATIONS = 0x00002400
-URLACTION_XPS_DOCUMENTS = 0x00002401
-URLACTION_LOOSE_XAML = 0x00002402
-URLACTION_LOWRIGHTS = 0x00002500
-URLACTION_WINFX_SETUP = 0x00002600
-URLPOLICY_ALLOW = 0x00
-URLPOLICY_QUERY = 0x01
-URLPOLICY_DISALLOW = 0x03
-URLPOLICY_NOTIFY_ON_ALLOW = 0x10
-URLPOLICY_NOTIFY_ON_DISALLOW = 0x20
-URLPOLICY_LOG_ON_ALLOW = 0x40
-URLPOLICY_LOG_ON_DISALLOW = 0x80
-URLPOLICY_MASK_PERMISSIONS = 0x0F
-URLPOLICY_DONTCHECKDLGBOX = 0x100
-URLZONE_ESC_FLAG = 0x100
-SECURITY_IE_STATE_GREEN = 0x00000000
-SECURITY_IE_STATE_RED = 0x00000001
-SOFTDIST_FLAG_USAGE_EMAIL = 0x00000001
-SOFTDIST_FLAG_USAGE_PRECACHE = 0x00000002
-SOFTDIST_FLAG_USAGE_AUTOINSTALL = 0x00000004
-SOFTDIST_FLAG_DELETE_SUBSCRIPTION = 0x00000008
-SOFTDIST_ADSTATE_NONE = 0x00000000
-SOFTDIST_ADSTATE_AVAILABLE = 0x00000001
-SOFTDIST_ADSTATE_DOWNLOADED = 0x00000002
-SOFTDIST_ADSTATE_INSTALLED = 0x00000003
-CONFIRMSAFETYACTION_LOADOBJECT = 0x00000001
diff --git a/lib/win32comext/internet/internet.pyd b/lib/win32comext/internet/internet.pyd
deleted file mode 100644
index b46d2db833f25193091c43ca12fbc75f543ea289..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 93696
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

diff --git a/lib/win32comext/mapi/__init__.py b/lib/win32comext/mapi/__init__.py
deleted file mode 100644
index 3933e212..00000000
--- a/lib/win32comext/mapi/__init__.py
+++ /dev/null
@@ -1,27 +0,0 @@
-if type(__path__) == type(""):
-    # For freeze to work!
-    import sys
-
-    try:
-        import mapi
-
-        sys.modules["win32com.mapi.mapi"] = mapi
-    except ImportError:
-        pass
-    try:
-        import exchange
-
-        sys.modules["win32com.mapi.exchange"] = exchange
-    except ImportError:
-        pass
-    try:
-        import exchdapi
-
-        sys.modules["win32com.mapi.exchdapi"] = exchdapi
-    except ImportError:
-        pass
-else:
-    import win32com
-
-    # See if we have a special directory for the binaries (for developers)
-    win32com.__PackageSupportBuildPath__(__path__)
diff --git a/lib/win32comext/mapi/demos/mapisend.py b/lib/win32comext/mapi/demos/mapisend.py
deleted file mode 100644
index 9f94361a..00000000
--- a/lib/win32comext/mapi/demos/mapisend.py
+++ /dev/null
@@ -1,98 +0,0 @@
-#!/usr/bin/env python
-
-"""module to send mail with Extended MAPI using the pywin32 mapi wrappers..."""
-
-# this was based on Jason Hattingh's C++ code at http://www.codeproject.com/internet/mapadmin.asp
-# written by David Fraser <davidf at sjsoft.com> and Stephen Emslie <stephene at sjsoft.com>
-# you can test this by changing the variables at the bottom and running from the command line
-
-from win32com.mapi import mapi, mapitags
-
-
-def SendEMAPIMail(
-    Subject="", Message="", SendTo=None, SendCC=None, SendBCC=None, MAPIProfile=None
-):
-    """Sends an email to the recipient using the extended MAPI interface
-    Subject and Message are strings
-    Send{To,CC,BCC} are comma-separated address lists
-    MAPIProfile is the name of the MAPI profile"""
-
-    # initialize and log on
-    mapi.MAPIInitialize(None)
-    session = mapi.MAPILogonEx(
-        0, MAPIProfile, None, mapi.MAPI_EXTENDED | mapi.MAPI_USE_DEFAULT
-    )
-    messagestorestable = session.GetMsgStoresTable(0)
-    messagestorestable.SetColumns(
-        (mapitags.PR_ENTRYID, mapitags.PR_DISPLAY_NAME_A, mapitags.PR_DEFAULT_STORE), 0
-    )
-
-    while True:
-        rows = messagestorestable.QueryRows(1, 0)
-        # if this is the last row then stop
-        if len(rows) != 1:
-            break
-        row = rows[0]
-        # if this is the default store then stop
-        if (mapitags.PR_DEFAULT_STORE, True) in row:
-            break
-
-    # unpack the row and open the message store
-    (eid_tag, eid), (name_tag, name), (def_store_tag, def_store) = row
-    msgstore = session.OpenMsgStore(
-        0, eid, None, mapi.MDB_NO_DIALOG | mapi.MAPI_BEST_ACCESS
-    )
-
-    # get the outbox
-    hr, props = msgstore.GetProps((mapitags.PR_IPM_OUTBOX_ENTRYID), 0)
-    (tag, eid) = props[0]
-    # check for errors
-    if mapitags.PROP_TYPE(tag) == mapitags.PT_ERROR:
-        raise TypeError("got PT_ERROR instead of PT_BINARY: %s" % eid)
-    outboxfolder = msgstore.OpenEntry(eid, None, mapi.MAPI_BEST_ACCESS)
-
-    # create the message and the addrlist
-    message = outboxfolder.CreateMessage(None, 0)
-    # note: you can use the resolveaddress functions for this. but you may get headaches
-    pal = []
-
-    def makeentry(recipient, recipienttype):
-        return (
-            (mapitags.PR_RECIPIENT_TYPE, recipienttype),
-            (mapitags.PR_SEND_RICH_INFO, False),
-            (mapitags.PR_DISPLAY_TYPE, 0),
-            (mapitags.PR_OBJECT_TYPE, 6),
-            (mapitags.PR_EMAIL_ADDRESS_A, recipient),
-            (mapitags.PR_ADDRTYPE_A, "SMTP"),
-            (mapitags.PR_DISPLAY_NAME_A, recipient),
-        )
-
-    if SendTo:
-        pal.extend(
-            [makeentry(recipient, mapi.MAPI_TO) for recipient in SendTo.split(",")]
-        )
-    if SendCC:
-        pal.extend(
-            [makeentry(recipient, mapi.MAPI_CC) for recipient in SendCC.split(",")]
-        )
-    if SendBCC:
-        pal.extend(
-            [makeentry(recipient, mapi.MAPI_BCC) for recipient in SendBCC.split(",")]
-        )
-
-    # add the resolved recipients to the message
-    message.ModifyRecipients(mapi.MODRECIP_ADD, pal)
-    message.SetProps([(mapitags.PR_BODY_A, Message), (mapitags.PR_SUBJECT_A, Subject)])
-
-    # save changes and submit
-    outboxfolder.SaveChanges(0)
-    message.SubmitMessage(0)
-
-
-if __name__ == "__main__":
-    MAPIProfile = ""
-    # Change this to a valid email address to test
-    SendTo = "an.invalid at address"
-    SendMessage = "testing one two three"
-    SendSubject = "Testing Extended MAPI!!"
-    SendEMAPIMail(SendSubject, SendMessage, SendTo, MAPIProfile=MAPIProfile)
diff --git a/lib/win32comext/mapi/emsabtags.py b/lib/win32comext/mapi/emsabtags.py
deleted file mode 100644
index 65e93df1..00000000
--- a/lib/win32comext/mapi/emsabtags.py
+++ /dev/null
@@ -1,874 +0,0 @@
-# Converted "manually" from EMSABTAG.H
-from .mapitags import (
-    PROP_TAG,
-    PT_APPTIME,
-    PT_BINARY,
-    PT_BOOLEAN,
-    PT_CLSID,
-    PT_CURRENCY,
-    PT_DOUBLE,
-    PT_ERROR,
-    PT_FLOAT,
-    PT_I2,
-    PT_I4,
-    PT_I8,
-    PT_LONG,
-    PT_LONGLONG,
-    PT_MV_APPTIME,
-    PT_MV_BINARY,
-    PT_MV_CLSID,
-    PT_MV_CURRENCY,
-    PT_MV_DOUBLE,
-    PT_MV_FLOAT,
-    PT_MV_I2,
-    PT_MV_I4,
-    PT_MV_I8,
-    PT_MV_LONG,
-    PT_MV_LONGLONG,
-    PT_MV_R4,
-    PT_MV_R8,
-    PT_MV_SHORT,
-    PT_MV_STRING8,
-    PT_MV_SYSTIME,
-    PT_MV_TSTRING,
-    PT_MV_UNICODE,
-    PT_NULL,
-    PT_OBJECT,
-    PT_R4,
-    PT_SHORT,
-    PT_STRING8,
-    PT_SYSTIME,
-    PT_TSTRING,
-    PT_UNICODE,
-    PT_UNSPECIFIED,
-)
-
-AB_SHOW_PHANTOMS = 2
-AB_SHOW_OTHERS = 4
-
-# Flags for ulFlag on ResolveNames
-EMS_AB_ADDRESS_LOOKUP = 1
-
-
-# Constructed, but externally visible.
-PR_EMS_AB_SERVER = PROP_TAG(PT_TSTRING, 65534)
-PR_EMS_AB_SERVER_A = PROP_TAG(PT_STRING8, 65534)
-PR_EMS_AB_SERVER_W = PROP_TAG(PT_UNICODE, 65534)
-PR_EMS_AB_CONTAINERID = PROP_TAG(PT_LONG, 65533)
-PR_EMS_AB_DOS_ENTRYID = PR_EMS_AB_CONTAINERID
-PR_EMS_AB_PARENT_ENTRYID = PROP_TAG(PT_BINARY, 65532)
-PR_EMS_AB_IS_MASTER = PROP_TAG(PT_BOOLEAN, 65531)
-PR_EMS_AB_OBJECT_OID = PROP_TAG(PT_BINARY, 65530)
-PR_EMS_AB_HIERARCHY_PATH = PROP_TAG(PT_TSTRING, 65529)
-PR_EMS_AB_HIERARCHY_PATH_A = PROP_TAG(PT_STRING8, 65529)
-PR_EMS_AB_HIERARCHY_PATH_W = PROP_TAG(PT_UNICODE, 65529)
-PR_EMS_AB_CHILD_RDNS = PROP_TAG(PT_MV_STRING8, 65528)
-
-MIN_EMS_AB_CONSTRUCTED_PROP_ID = 65528
-
-PR_EMS_AB_OTHER_RECIPS = PROP_TAG(PT_OBJECT, 61440)
-
-# Prop tags defined in the schema.
-PR_EMS_AB_DISPLAY_NAME_PRINTABLE = PROP_TAG(PT_TSTRING, 14847)
-PR_EMS_AB_DISPLAY_NAME_PRINTABLE_A = PROP_TAG(PT_STRING8, 14847)
-PR_EMS_AB_DISPLAY_NAME_PRINTABLE_W = PROP_TAG(PT_UNICODE, 14847)
-
-PR_EMS_AB_ACCESS_CATEGORY = PROP_TAG(PT_LONG, 32836)
-PR_EMS_AB_ACTIVATION_SCHEDULE = PROP_TAG(PT_BINARY, 32837)
-PR_EMS_AB_ACTIVATION_STYLE = PROP_TAG(PT_LONG, 32838)
-PR_EMS_AB_ADDRESS_ENTRY_DISPLAY_TABLE = PROP_TAG(PT_BINARY, 32791)
-PR_EMS_AB_ADDRESS_ENTRY_DISPLAY_TABLE_MSDOS = PROP_TAG(PT_BINARY, 32839)
-PR_EMS_AB_ADDRESS_SYNTAX = PROP_TAG(PT_BINARY, 32792)
-PR_EMS_AB_ADDRESS_TYPE = PROP_TAG(PT_TSTRING, 32840)
-PR_EMS_AB_ADDRESS_TYPE_A = PROP_TAG(PT_STRING8, 32840)
-PR_EMS_AB_ADDRESS_TYPE_W = PROP_TAG(PT_UNICODE, 32840)
-PR_EMS_AB_ADMD = PROP_TAG(PT_TSTRING, 32841)
-PR_EMS_AB_ADMD_A = PROP_TAG(PT_STRING8, 32841)
-PR_EMS_AB_ADMD_W = PROP_TAG(PT_UNICODE, 32841)
-PR_EMS_AB_ADMIN_DESCRIPTION = PROP_TAG(PT_TSTRING, 32842)
-PR_EMS_AB_ADMIN_DESCRIPTION_A = PROP_TAG(PT_STRING8, 32842)
-PR_EMS_AB_ADMIN_DESCRIPTION_W = PROP_TAG(PT_UNICODE, 32842)
-PR_EMS_AB_ADMIN_DISPLAY_NAME = PROP_TAG(PT_TSTRING, 32843)
-PR_EMS_AB_ADMIN_DISPLAY_NAME_A = PROP_TAG(PT_STRING8, 32843)
-PR_EMS_AB_ADMIN_DISPLAY_NAME_W = PROP_TAG(PT_UNICODE, 32843)
-PR_EMS_AB_ADMIN_EXTENSION_DLL = PROP_TAG(PT_TSTRING, 32844)
-PR_EMS_AB_ADMIN_EXTENSION_DLL_A = PROP_TAG(PT_STRING8, 32844)
-PR_EMS_AB_ADMIN_EXTENSION_DLL_W = PROP_TAG(PT_UNICODE, 32844)
-PR_EMS_AB_ALIASED_OBJECT_NAME = PROP_TAG(PT_TSTRING, 32845)
-PR_EMS_AB_ALIASED_OBJECT_NAME_A = PROP_TAG(PT_STRING8, 32845)
-PR_EMS_AB_ALIASED_OBJECT_NAME_W = PROP_TAG(PT_UNICODE, 32845)
-PR_EMS_AB_ALIASED_OBJECT_NAME_O = PROP_TAG(PT_OBJECT, 32845)
-PR_EMS_AB_ALIASED_OBJECT_NAME_T = PROP_TAG(PT_TSTRING, 32845)
-PR_EMS_AB_ALT_RECIPIENT = PROP_TAG(PT_TSTRING, 32846)
-PR_EMS_AB_ALT_RECIPIENT_A = PROP_TAG(PT_STRING8, 32846)
-PR_EMS_AB_ALT_RECIPIENT_W = PROP_TAG(PT_UNICODE, 32846)
-PR_EMS_AB_ALT_RECIPIENT_O = PROP_TAG(PT_OBJECT, 32846)
-PR_EMS_AB_ALT_RECIPIENT_T = PROP_TAG(PT_TSTRING, 32846)
-PR_EMS_AB_ALT_RECIPIENT_BL = PROP_TAG(PT_MV_TSTRING, 32847)
-PR_EMS_AB_ALT_RECIPIENT_BL_A = PROP_TAG(PT_MV_STRING8, 32847)
-PR_EMS_AB_ALT_RECIPIENT_BL_W = PROP_TAG(PT_MV_UNICODE, 32847)
-PR_EMS_AB_ALT_RECIPIENT_BL_O = PROP_TAG(PT_OBJECT, 32847)
-PR_EMS_AB_ALT_RECIPIENT_BL_T = PROP_TAG(PT_MV_TSTRING, 32847)
-PR_EMS_AB_ANCESTOR_ID = PROP_TAG(PT_BINARY, 32848)
-PR_EMS_AB_ASSOC_NT_ACCOUNT = PROP_TAG(PT_BINARY, 32807)
-PR_EMS_AB_ASSOC_REMOTE_DXA = PROP_TAG(PT_MV_TSTRING, 32849)
-PR_EMS_AB_ASSOC_REMOTE_DXA_A = PROP_TAG(PT_MV_STRING8, 32849)
-PR_EMS_AB_ASSOC_REMOTE_DXA_W = PROP_TAG(PT_MV_UNICODE, 32849)
-PR_EMS_AB_ASSOC_REMOTE_DXA_O = PROP_TAG(PT_OBJECT, 32849)
-PR_EMS_AB_ASSOC_REMOTE_DXA_T = PROP_TAG(PT_MV_TSTRING, 32849)
-PR_EMS_AB_ASSOCIATION_LIFETIME = PROP_TAG(PT_LONG, 32850)
-PR_EMS_AB_AUTH_ORIG_BL = PROP_TAG(PT_MV_TSTRING, 32851)
-PR_EMS_AB_AUTH_ORIG_BL_A = PROP_TAG(PT_MV_STRING8, 32851)
-PR_EMS_AB_AUTH_ORIG_BL_W = PROP_TAG(PT_MV_UNICODE, 32851)
-PR_EMS_AB_AUTH_ORIG_BL_O = PROP_TAG(PT_OBJECT, 32851)
-PR_EMS_AB_AUTH_ORIG_BL_T = PROP_TAG(PT_MV_TSTRING, 32851)
-PR_EMS_AB_AUTHORITY_REVOCATION_LIST = PROP_TAG(PT_MV_BINARY, 32806)
-PR_EMS_AB_AUTHORIZED_DOMAIN = PROP_TAG(PT_TSTRING, 32852)
-PR_EMS_AB_AUTHORIZED_DOMAIN_A = PROP_TAG(PT_STRING8, 32852)
-PR_EMS_AB_AUTHORIZED_DOMAIN_W = PROP_TAG(PT_UNICODE, 32852)
-PR_EMS_AB_AUTHORIZED_PASSWORD = PROP_TAG(PT_BINARY, 32853)
-PR_EMS_AB_AUTHORIZED_USER = PROP_TAG(PT_TSTRING, 32854)
-PR_EMS_AB_AUTHORIZED_USER_A = PROP_TAG(PT_STRING8, 32854)
-PR_EMS_AB_AUTHORIZED_USER_W = PROP_TAG(PT_UNICODE, 32854)
-PR_EMS_AB_AUTOREPLY = PROP_TAG(PT_BOOLEAN, 32779)
-PR_EMS_AB_AUTOREPLY_MESSAGE = PROP_TAG(PT_TSTRING, 32778)
-PR_EMS_AB_AUTOREPLY_MESSAGE_A = PROP_TAG(PT_STRING8, 32778)
-PR_EMS_AB_AUTOREPLY_MESSAGE_W = PROP_TAG(PT_UNICODE, 32778)
-PR_EMS_AB_AUTOREPLY_SUBJECT = PROP_TAG(PT_TSTRING, 32830)
-PR_EMS_AB_AUTOREPLY_SUBJECT_A = PROP_TAG(PT_STRING8, 32830)
-PR_EMS_AB_AUTOREPLY_SUBJECT_W = PROP_TAG(PT_UNICODE, 32830)
-PR_EMS_AB_BRIDGEHEAD_SERVERS = PROP_TAG(PT_MV_TSTRING, 33140)
-PR_EMS_AB_BRIDGEHEAD_SERVERS_A = PROP_TAG(PT_MV_STRING8, 33140)
-PR_EMS_AB_BRIDGEHEAD_SERVERS_W = PROP_TAG(PT_MV_UNICODE, 33140)
-PR_EMS_AB_BRIDGEHEAD_SERVERS_O = PROP_TAG(PT_OBJECT, 33140)
-PR_EMS_AB_BRIDGEHEAD_SERVERS_T = PROP_TAG(PT_MV_TSTRING, 33140)
-PR_EMS_AB_BUSINESS_CATEGORY = PROP_TAG(PT_MV_TSTRING, 32855)
-PR_EMS_AB_BUSINESS_CATEGORY_A = PROP_TAG(PT_MV_STRING8, 32855)
-PR_EMS_AB_BUSINESS_CATEGORY_W = PROP_TAG(PT_MV_UNICODE, 32855)
-PR_EMS_AB_BUSINESS_ROLES = PROP_TAG(PT_BINARY, 32803)
-PR_EMS_AB_CA_CERTIFICATE = PROP_TAG(PT_MV_BINARY, 32771)
-PR_EMS_AB_CAN_CREATE_PF = PROP_TAG(PT_MV_TSTRING, 32856)
-PR_EMS_AB_CAN_CREATE_PF_A = PROP_TAG(PT_MV_STRING8, 32856)
-PR_EMS_AB_CAN_CREATE_PF_W = PROP_TAG(PT_MV_UNICODE, 32856)
-PR_EMS_AB_CAN_CREATE_PF_O = PROP_TAG(PT_OBJECT, 32856)
-PR_EMS_AB_CAN_CREATE_PF_T = PROP_TAG(PT_MV_TSTRING, 32856)
-PR_EMS_AB_CAN_CREATE_PF_BL = PROP_TAG(PT_MV_TSTRING, 32857)
-PR_EMS_AB_CAN_CREATE_PF_BL_A = PROP_TAG(PT_MV_STRING8, 32857)
-PR_EMS_AB_CAN_CREATE_PF_BL_W = PROP_TAG(PT_MV_UNICODE, 32857)
-PR_EMS_AB_CAN_CREATE_PF_BL_O = PROP_TAG(PT_OBJECT, 32857)
-PR_EMS_AB_CAN_CREATE_PF_BL_T = PROP_TAG(PT_MV_TSTRING, 32857)
-PR_EMS_AB_CAN_CREATE_PF_DL = PROP_TAG(PT_MV_TSTRING, 32858)
-PR_EMS_AB_CAN_CREATE_PF_DL_A = PROP_TAG(PT_MV_STRING8, 32858)
-PR_EMS_AB_CAN_CREATE_PF_DL_W = PROP_TAG(PT_MV_UNICODE, 32858)
-PR_EMS_AB_CAN_CREATE_PF_DL_O = PROP_TAG(PT_OBJECT, 32858)
-PR_EMS_AB_CAN_CREATE_PF_DL_T = PROP_TAG(PT_MV_TSTRING, 32858)
-PR_EMS_AB_CAN_CREATE_PF_DL_BL = PROP_TAG(PT_MV_TSTRING, 32859)
-PR_EMS_AB_CAN_CREATE_PF_DL_BL_A = PROP_TAG(PT_MV_STRING8, 32859)
-PR_EMS_AB_CAN_CREATE_PF_DL_BL_W = PROP_TAG(PT_MV_UNICODE, 32859)
-PR_EMS_AB_CAN_CREATE_PF_DL_BL_O = PROP_TAG(PT_OBJECT, 32859)
-PR_EMS_AB_CAN_CREATE_PF_DL_BL_T = PROP_TAG(PT_MV_TSTRING, 32859)
-PR_EMS_AB_CAN_NOT_CREATE_PF = PROP_TAG(PT_MV_TSTRING, 32860)
-PR_EMS_AB_CAN_NOT_CREATE_PF_A = PROP_TAG(PT_MV_STRING8, 32860)
-PR_EMS_AB_CAN_NOT_CREATE_PF_W = PROP_TAG(PT_MV_UNICODE, 32860)
-PR_EMS_AB_CAN_NOT_CREATE_PF_O = PROP_TAG(PT_OBJECT, 32860)
-PR_EMS_AB_CAN_NOT_CREATE_PF_T = PROP_TAG(PT_MV_TSTRING, 32860)
-PR_EMS_AB_CAN_NOT_CREATE_PF_BL = PROP_TAG(PT_MV_TSTRING, 32861)
-PR_EMS_AB_CAN_NOT_CREATE_PF_BL_A = PROP_TAG(PT_MV_STRING8, 32861)
-PR_EMS_AB_CAN_NOT_CREATE_PF_BL_W = PROP_TAG(PT_MV_UNICODE, 32861)
-PR_EMS_AB_CAN_NOT_CREATE_PF_BL_O = PROP_TAG(PT_OBJECT, 32861)
-PR_EMS_AB_CAN_NOT_CREATE_PF_BL_T = PROP_TAG(PT_MV_TSTRING, 32861)
-PR_EMS_AB_CAN_NOT_CREATE_PF_DL = PROP_TAG(PT_MV_TSTRING, 32862)
-PR_EMS_AB_CAN_NOT_CREATE_PF_DL_A = PROP_TAG(PT_MV_STRING8, 32862)
-PR_EMS_AB_CAN_NOT_CREATE_PF_DL_W = PROP_TAG(PT_MV_UNICODE, 32862)
-PR_EMS_AB_CAN_NOT_CREATE_PF_DL_O = PROP_TAG(PT_OBJECT, 32862)
-PR_EMS_AB_CAN_NOT_CREATE_PF_DL_T = PROP_TAG(PT_MV_TSTRING, 32862)
-PR_EMS_AB_CAN_NOT_CREATE_PF_DL_BL = PROP_TAG(PT_MV_TSTRING, 32863)
-PR_EMS_AB_CAN_NOT_CREATE_PF_DL_BL_A = PROP_TAG(PT_MV_STRING8, 32863)
-PR_EMS_AB_CAN_NOT_CREATE_PF_DL_BL_W = PROP_TAG(PT_MV_UNICODE, 32863)
-PR_EMS_AB_CAN_NOT_CREATE_PF_DL_BL_O = PROP_TAG(PT_OBJECT, 32863)
-PR_EMS_AB_CAN_NOT_CREATE_PF_DL_BL_T = PROP_TAG(PT_MV_TSTRING, 32863)
-PR_EMS_AB_CAN_PRESERVE_DNS = PROP_TAG(PT_BOOLEAN, 32864)
-PR_EMS_AB_CERTIFICATE_REVOCATION_LIST = PROP_TAG(PT_BINARY, 32790)
-PR_EMS_AB_CLOCK_ALERT_OFFSET = PROP_TAG(PT_LONG, 32865)
-PR_EMS_AB_CLOCK_ALERT_REPAIR = PROP_TAG(PT_BOOLEAN, 32866)
-PR_EMS_AB_CLOCK_WARNING_OFFSET = PROP_TAG(PT_LONG, 32867)
-PR_EMS_AB_CLOCK_WARNING_REPAIR = PROP_TAG(PT_BOOLEAN, 32868)
-PR_EMS_AB_COMPUTER_NAME = PROP_TAG(PT_TSTRING, 32869)
-PR_EMS_AB_COMPUTER_NAME_A = PROP_TAG(PT_STRING8, 32869)
-PR_EMS_AB_COMPUTER_NAME_W = PROP_TAG(PT_UNICODE, 32869)
-PR_EMS_AB_CONNECTED_DOMAINS = PROP_TAG(PT_MV_TSTRING, 32870)
-PR_EMS_AB_CONNECTED_DOMAINS_A = PROP_TAG(PT_MV_STRING8, 32870)
-PR_EMS_AB_CONNECTED_DOMAINS_W = PROP_TAG(PT_MV_UNICODE, 32870)
-PR_EMS_AB_CONTAINER_INFO = PROP_TAG(PT_LONG, 32871)
-PR_EMS_AB_COST = PROP_TAG(PT_LONG, 32872)
-PR_EMS_AB_COUNTRY_NAME = PROP_TAG(PT_TSTRING, 32873)
-PR_EMS_AB_COUNTRY_NAME_A = PROP_TAG(PT_STRING8, 32873)
-PR_EMS_AB_COUNTRY_NAME_W = PROP_TAG(PT_UNICODE, 32873)
-PR_EMS_AB_CROSS_CERTIFICATE_PAIR = PROP_TAG(PT_MV_BINARY, 32805)
-PR_EMS_AB_DELIV_CONT_LENGTH = PROP_TAG(PT_LONG, 32874)
-PR_EMS_AB_DELIV_EITS = PROP_TAG(PT_MV_BINARY, 32875)
-PR_EMS_AB_DELIV_EXT_CONT_TYPES = PROP_TAG(PT_MV_BINARY, 32876)
-PR_EMS_AB_DELIVER_AND_REDIRECT = PROP_TAG(PT_BOOLEAN, 32877)
-PR_EMS_AB_DELIVERY_MECHANISM = PROP_TAG(PT_LONG, 32878)
-PR_EMS_AB_DESCRIPTION = PROP_TAG(PT_MV_TSTRING, 32879)
-PR_EMS_AB_DESCRIPTION_A = PROP_TAG(PT_MV_STRING8, 32879)
-PR_EMS_AB_DESCRIPTION_W = PROP_TAG(PT_MV_UNICODE, 32879)
-PR_EMS_AB_DESTINATION_INDICATOR = PROP_TAG(PT_MV_TSTRING, 32880)
-PR_EMS_AB_DESTINATION_INDICATOR_A = PROP_TAG(PT_MV_STRING8, 32880)
-PR_EMS_AB_DESTINATION_INDICATOR_W = PROP_TAG(PT_MV_UNICODE, 32880)
-PR_EMS_AB_DIAGNOSTIC_REG_KEY = PROP_TAG(PT_TSTRING, 32881)
-PR_EMS_AB_DIAGNOSTIC_REG_KEY_A = PROP_TAG(PT_STRING8, 32881)
-PR_EMS_AB_DIAGNOSTIC_REG_KEY_W = PROP_TAG(PT_UNICODE, 32881)
-PR_EMS_AB_DISPLAY_NAME_OVERRIDE = PROP_TAG(PT_BOOLEAN, 32769)
-PR_EMS_AB_DL_MEM_REJECT_PERMS_BL = PROP_TAG(PT_MV_TSTRING, 32882)
-PR_EMS_AB_DL_MEM_REJECT_PERMS_BL_A = PROP_TAG(PT_MV_STRING8, 32882)
-PR_EMS_AB_DL_MEM_REJECT_PERMS_BL_W = PROP_TAG(PT_MV_UNICODE, 32882)
-PR_EMS_AB_DL_MEM_REJECT_PERMS_BL_O = PROP_TAG(PT_OBJECT, 32882)
-PR_EMS_AB_DL_MEM_REJECT_PERMS_BL_T = PROP_TAG(PT_MV_TSTRING, 32882)
-PR_EMS_AB_DL_MEM_SUBMIT_PERMS_BL = PROP_TAG(PT_MV_TSTRING, 32883)
-PR_EMS_AB_DL_MEM_SUBMIT_PERMS_BL_A = PROP_TAG(PT_MV_STRING8, 32883)
-PR_EMS_AB_DL_MEM_SUBMIT_PERMS_BL_W = PROP_TAG(PT_MV_UNICODE, 32883)
-PR_EMS_AB_DL_MEM_SUBMIT_PERMS_BL_O = PROP_TAG(PT_OBJECT, 32883)
-PR_EMS_AB_DL_MEM_SUBMIT_PERMS_BL_T = PROP_TAG(PT_MV_TSTRING, 32883)
-PR_EMS_AB_DL_MEMBER_RULE = PROP_TAG(PT_MV_BINARY, 32884)
-PR_EMS_AB_DOMAIN_DEF_ALT_RECIP = PROP_TAG(PT_TSTRING, 32885)
-PR_EMS_AB_DOMAIN_DEF_ALT_RECIP_A = PROP_TAG(PT_STRING8, 32885)
-PR_EMS_AB_DOMAIN_DEF_ALT_RECIP_W = PROP_TAG(PT_UNICODE, 32885)
-PR_EMS_AB_DOMAIN_DEF_ALT_RECIP_O = PROP_TAG(PT_OBJECT, 32885)
-PR_EMS_AB_DOMAIN_DEF_ALT_RECIP_T = PROP_TAG(PT_TSTRING, 32885)
-PR_EMS_AB_DOMAIN_NAME = PROP_TAG(PT_TSTRING, 32886)
-PR_EMS_AB_DOMAIN_NAME_A = PROP_TAG(PT_STRING8, 32886)
-PR_EMS_AB_DOMAIN_NAME_W = PROP_TAG(PT_UNICODE, 32886)
-PR_EMS_AB_DSA_SIGNATURE = PROP_TAG(PT_BINARY, 32887)
-PR_EMS_AB_DXA_ADMIN_COPY = PROP_TAG(PT_BOOLEAN, 32888)
-PR_EMS_AB_DXA_ADMIN_FORWARD = PROP_TAG(PT_BOOLEAN, 32889)
-PR_EMS_AB_DXA_ADMIN_UPDATE = PROP_TAG(PT_LONG, 32890)
-PR_EMS_AB_DXA_APPEND_REQCN = PROP_TAG(PT_BOOLEAN, 32891)
-PR_EMS_AB_DXA_CONF_CONTAINER_LIST = PROP_TAG(PT_MV_TSTRING, 32892)
-PR_EMS_AB_DXA_CONF_CONTAINER_LIST_A = PROP_TAG(PT_MV_STRING8, 32892)
-PR_EMS_AB_DXA_CONF_CONTAINER_LIST_W = PROP_TAG(PT_MV_UNICODE, 32892)
-PR_EMS_AB_DXA_CONF_CONTAINER_LIST_O = PROP_TAG(PT_OBJECT, 32892)
-PR_EMS_AB_DXA_CONF_CONTAINER_LIST_T = PROP_TAG(PT_MV_TSTRING, 32892)
-PR_EMS_AB_DXA_CONF_REQ_TIME = PROP_TAG(PT_SYSTIME, 32893)
-PR_EMS_AB_DXA_CONF_SEQ = PROP_TAG(PT_TSTRING, 32894)
-PR_EMS_AB_DXA_CONF_SEQ_A = PROP_TAG(PT_STRING8, 32894)
-PR_EMS_AB_DXA_CONF_SEQ_W = PROP_TAG(PT_UNICODE, 32894)
-PR_EMS_AB_DXA_CONF_SEQ_USN = PROP_TAG(PT_LONG, 32895)
-PR_EMS_AB_DXA_EXCHANGE_OPTIONS = PROP_TAG(PT_LONG, 32896)
-PR_EMS_AB_DXA_EXPORT_NOW = PROP_TAG(PT_BOOLEAN, 32897)
-PR_EMS_AB_DXA_FLAGS = PROP_TAG(PT_LONG, 32898)
-PR_EMS_AB_DXA_IMP_SEQ = PROP_TAG(PT_TSTRING, 32899)
-PR_EMS_AB_DXA_IMP_SEQ_A = PROP_TAG(PT_STRING8, 32899)
-PR_EMS_AB_DXA_IMP_SEQ_W = PROP_TAG(PT_UNICODE, 32899)
-PR_EMS_AB_DXA_IMP_SEQ_TIME = PROP_TAG(PT_SYSTIME, 32900)
-PR_EMS_AB_DXA_IMP_SEQ_USN = PROP_TAG(PT_LONG, 32901)
-PR_EMS_AB_DXA_IMPORT_NOW = PROP_TAG(PT_BOOLEAN, 32902)
-PR_EMS_AB_DXA_IN_TEMPLATE_MAP = PROP_TAG(PT_MV_TSTRING, 32903)
-PR_EMS_AB_DXA_IN_TEMPLATE_MAP_A = PROP_TAG(PT_MV_STRING8, 32903)
-PR_EMS_AB_DXA_IN_TEMPLATE_MAP_W = PROP_TAG(PT_MV_UNICODE, 32903)
-PR_EMS_AB_DXA_LOCAL_ADMIN = PROP_TAG(PT_TSTRING, 32904)
-PR_EMS_AB_DXA_LOCAL_ADMIN_A = PROP_TAG(PT_STRING8, 32904)
-PR_EMS_AB_DXA_LOCAL_ADMIN_W = PROP_TAG(PT_UNICODE, 32904)
-PR_EMS_AB_DXA_LOCAL_ADMIN_O = PROP_TAG(PT_OBJECT, 32904)
-PR_EMS_AB_DXA_LOCAL_ADMIN_T = PROP_TAG(PT_TSTRING, 32904)
-PR_EMS_AB_DXA_LOGGING_LEVEL = PROP_TAG(PT_LONG, 32905)
-PR_EMS_AB_DXA_NATIVE_ADDRESS_TYPE = PROP_TAG(PT_TSTRING, 32906)
-PR_EMS_AB_DXA_NATIVE_ADDRESS_TYPE_A = PROP_TAG(PT_STRING8, 32906)
-PR_EMS_AB_DXA_NATIVE_ADDRESS_TYPE_W = PROP_TAG(PT_UNICODE, 32906)
-PR_EMS_AB_DXA_OUT_TEMPLATE_MAP = PROP_TAG(PT_MV_TSTRING, 32907)
-PR_EMS_AB_DXA_OUT_TEMPLATE_MAP_A = PROP_TAG(PT_MV_STRING8, 32907)
-PR_EMS_AB_DXA_OUT_TEMPLATE_MAP_W = PROP_TAG(PT_MV_UNICODE, 32907)
-PR_EMS_AB_DXA_PASSWORD = PROP_TAG(PT_TSTRING, 32908)
-PR_EMS_AB_DXA_PASSWORD_A = PROP_TAG(PT_STRING8, 32908)
-PR_EMS_AB_DXA_PASSWORD_W = PROP_TAG(PT_UNICODE, 32908)
-PR_EMS_AB_DXA_PREV_EXCHANGE_OPTIONS = PROP_TAG(PT_LONG, 32909)
-PR_EMS_AB_DXA_PREV_EXPORT_NATIVE_ONLY = PROP_TAG(PT_BOOLEAN, 32910)
-PR_EMS_AB_DXA_PREV_IN_EXCHANGE_SENSITIVITY = PROP_TAG(PT_LONG, 32911)
-PR_EMS_AB_DXA_PREV_REMOTE_ENTRIES = PROP_TAG(PT_TSTRING, 32912)
-PR_EMS_AB_DXA_PREV_REMOTE_ENTRIES_A = PROP_TAG(PT_STRING8, 32912)
-PR_EMS_AB_DXA_PREV_REMOTE_ENTRIES_W = PROP_TAG(PT_UNICODE, 32912)
-PR_EMS_AB_DXA_PREV_REMOTE_ENTRIES_O = PROP_TAG(PT_OBJECT, 32912)
-PR_EMS_AB_DXA_PREV_REMOTE_ENTRIES_T = PROP_TAG(PT_TSTRING, 32912)
-PR_EMS_AB_DXA_PREV_REPLICATION_SENSITIVITY = PROP_TAG(PT_LONG, 32913)
-PR_EMS_AB_DXA_PREV_TEMPLATE_OPTIONS = PROP_TAG(PT_LONG, 32914)
-PR_EMS_AB_DXA_PREV_TYPES = PROP_TAG(PT_LONG, 32915)
-PR_EMS_AB_DXA_RECIPIENT_CP = PROP_TAG(PT_TSTRING, 32916)
-PR_EMS_AB_DXA_RECIPIENT_CP_A = PROP_TAG(PT_STRING8, 32916)
-PR_EMS_AB_DXA_RECIPIENT_CP_W = PROP_TAG(PT_UNICODE, 32916)
-PR_EMS_AB_DXA_REMOTE_CLIENT = PROP_TAG(PT_TSTRING, 32917)
-PR_EMS_AB_DXA_REMOTE_CLIENT_A = PROP_TAG(PT_STRING8, 32917)
-PR_EMS_AB_DXA_REMOTE_CLIENT_W = PROP_TAG(PT_UNICODE, 32917)
-PR_EMS_AB_DXA_REMOTE_CLIENT_O = PROP_TAG(PT_OBJECT, 32917)
-PR_EMS_AB_DXA_REMOTE_CLIENT_T = PROP_TAG(PT_TSTRING, 32917)
-PR_EMS_AB_DXA_REQ_SEQ = PROP_TAG(PT_TSTRING, 32918)
-PR_EMS_AB_DXA_REQ_SEQ_A = PROP_TAG(PT_STRING8, 32918)
-PR_EMS_AB_DXA_REQ_SEQ_W = PROP_TAG(PT_UNICODE, 32918)
-PR_EMS_AB_DXA_REQ_SEQ_TIME = PROP_TAG(PT_SYSTIME, 32919)
-PR_EMS_AB_DXA_REQ_SEQ_USN = PROP_TAG(PT_LONG, 32920)
-PR_EMS_AB_DXA_REQNAME = PROP_TAG(PT_TSTRING, 32921)
-PR_EMS_AB_DXA_REQNAME_A = PROP_TAG(PT_STRING8, 32921)
-PR_EMS_AB_DXA_REQNAME_W = PROP_TAG(PT_UNICODE, 32921)
-PR_EMS_AB_DXA_SVR_SEQ = PROP_TAG(PT_TSTRING, 32922)
-PR_EMS_AB_DXA_SVR_SEQ_A = PROP_TAG(PT_STRING8, 32922)
-PR_EMS_AB_DXA_SVR_SEQ_W = PROP_TAG(PT_UNICODE, 32922)
-PR_EMS_AB_DXA_SVR_SEQ_TIME = PROP_TAG(PT_SYSTIME, 32923)
-PR_EMS_AB_DXA_SVR_SEQ_USN = PROP_TAG(PT_LONG, 32924)
-PR_EMS_AB_DXA_TASK = PROP_TAG(PT_LONG, 32925)
-PR_EMS_AB_DXA_TEMPLATE_OPTIONS = PROP_TAG(PT_LONG, 32926)
-PR_EMS_AB_DXA_TEMPLATE_TIMESTAMP = PROP_TAG(PT_SYSTIME, 32927)
-PR_EMS_AB_DXA_TYPES = PROP_TAG(PT_LONG, 32928)
-PR_EMS_AB_DXA_UNCONF_CONTAINER_LIST = PROP_TAG(PT_MV_TSTRING, 32929)
-PR_EMS_AB_DXA_UNCONF_CONTAINER_LIST_A = PROP_TAG(PT_MV_STRING8, 32929)
-PR_EMS_AB_DXA_UNCONF_CONTAINER_LIST_W = PROP_TAG(PT_MV_UNICODE, 32929)
-PR_EMS_AB_DXA_UNCONF_CONTAINER_LIST_O = PROP_TAG(PT_OBJECT, 32929)
-PR_EMS_AB_DXA_UNCONF_CONTAINER_LIST_T = PROP_TAG(PT_MV_TSTRING, 32929)
-PR_EMS_AB_ENABLED_PROTOCOLS = PROP_TAG(PT_LONG, 33151)
-PR_EMS_AB_ENCAPSULATION_METHOD = PROP_TAG(PT_LONG, 32930)
-PR_EMS_AB_ENCRYPT = PROP_TAG(PT_BOOLEAN, 32931)
-PR_EMS_AB_ENCRYPT_ALG_LIST_NA = PROP_TAG(PT_MV_TSTRING, 32832)
-PR_EMS_AB_ENCRYPT_ALG_LIST_NA_A = PROP_TAG(PT_MV_STRING8, 32832)
-PR_EMS_AB_ENCRYPT_ALG_LIST_NA_W = PROP_TAG(PT_MV_UNICODE, 32832)
-PR_EMS_AB_ENCRYPT_ALG_LIST_OTHER = PROP_TAG(PT_MV_TSTRING, 32833)
-PR_EMS_AB_ENCRYPT_ALG_LIST_OTHER_A = PROP_TAG(PT_MV_STRING8, 32833)
-PR_EMS_AB_ENCRYPT_ALG_LIST_OTHER_W = PROP_TAG(PT_MV_UNICODE, 32833)
-PR_EMS_AB_ENCRYPT_ALG_SELECTED_NA = PROP_TAG(PT_TSTRING, 32835)
-PR_EMS_AB_ENCRYPT_ALG_SELECTED_NA_A = PROP_TAG(PT_STRING8, 32835)
-PR_EMS_AB_ENCRYPT_ALG_SELECTED_NA_W = PROP_TAG(PT_UNICODE, 32835)
-PR_EMS_AB_ENCRYPT_ALG_SELECTED_OTHER = PROP_TAG(PT_TSTRING, 32829)
-PR_EMS_AB_ENCRYPT_ALG_SELECTED_OTHER_A = PROP_TAG(PT_STRING8, 32829)
-PR_EMS_AB_ENCRYPT_ALG_SELECTED_OTHER_W = PROP_TAG(PT_UNICODE, 32829)
-PR_EMS_AB_EXPAND_DLS_LOCALLY = PROP_TAG(PT_BOOLEAN, 32932)
-PR_EMS_AB_EXPIRATION_TIME = PROP_TAG(PT_SYSTIME, 32808)
-PR_EMS_AB_EXPORT_CONTAINERS = PROP_TAG(PT_MV_TSTRING, 32933)
-PR_EMS_AB_EXPORT_CONTAINERS_A = PROP_TAG(PT_MV_STRING8, 32933)
-PR_EMS_AB_EXPORT_CONTAINERS_W = PROP_TAG(PT_MV_UNICODE, 32933)
-PR_EMS_AB_EXPORT_CONTAINERS_O = PROP_TAG(PT_OBJECT, 32933)
-PR_EMS_AB_EXPORT_CONTAINERS_T = PROP_TAG(PT_MV_TSTRING, 32933)
-PR_EMS_AB_EXPORT_CUSTOM_RECIPIENTS = PROP_TAG(PT_BOOLEAN, 32934)
-PR_EMS_AB_EXTENDED_CHARS_ALLOWED = PROP_TAG(PT_BOOLEAN, 32935)
-PR_EMS_AB_EXTENSION_ATTRIBUTE_1 = PROP_TAG(PT_TSTRING, 32813)
-PR_EMS_AB_EXTENSION_ATTRIBUTE_1_A = PROP_TAG(PT_STRING8, 32813)
-PR_EMS_AB_EXTENSION_ATTRIBUTE_1_W = PROP_TAG(PT_UNICODE, 32813)
-PR_EMS_AB_EXTENSION_ATTRIBUTE_10 = PROP_TAG(PT_TSTRING, 32822)
-PR_EMS_AB_EXTENSION_ATTRIBUTE_10_A = PROP_TAG(PT_STRING8, 32822)
-PR_EMS_AB_EXTENSION_ATTRIBUTE_10_W = PROP_TAG(PT_UNICODE, 32822)
-PR_EMS_AB_EXTENSION_ATTRIBUTE_2 = PROP_TAG(PT_TSTRING, 32814)
-PR_EMS_AB_EXTENSION_ATTRIBUTE_2_A = PROP_TAG(PT_STRING8, 32814)
-PR_EMS_AB_EXTENSION_ATTRIBUTE_2_W = PROP_TAG(PT_UNICODE, 32814)
-PR_EMS_AB_EXTENSION_ATTRIBUTE_3 = PROP_TAG(PT_TSTRING, 32815)
-PR_EMS_AB_EXTENSION_ATTRIBUTE_3_A = PROP_TAG(PT_STRING8, 32815)
-PR_EMS_AB_EXTENSION_ATTRIBUTE_3_W = PROP_TAG(PT_UNICODE, 32815)
-PR_EMS_AB_EXTENSION_ATTRIBUTE_4 = PROP_TAG(PT_TSTRING, 32816)
-PR_EMS_AB_EXTENSION_ATTRIBUTE_4_A = PROP_TAG(PT_STRING8, 32816)
-PR_EMS_AB_EXTENSION_ATTRIBUTE_4_W = PROP_TAG(PT_UNICODE, 32816)
-PR_EMS_AB_EXTENSION_ATTRIBUTE_5 = PROP_TAG(PT_TSTRING, 32817)
-PR_EMS_AB_EXTENSION_ATTRIBUTE_5_A = PROP_TAG(PT_STRING8, 32817)
-PR_EMS_AB_EXTENSION_ATTRIBUTE_5_W = PROP_TAG(PT_UNICODE, 32817)
-PR_EMS_AB_EXTENSION_ATTRIBUTE_6 = PROP_TAG(PT_TSTRING, 32818)
-PR_EMS_AB_EXTENSION_ATTRIBUTE_6_A = PROP_TAG(PT_STRING8, 32818)
-PR_EMS_AB_EXTENSION_ATTRIBUTE_6_W = PROP_TAG(PT_UNICODE, 32818)
-PR_EMS_AB_EXTENSION_ATTRIBUTE_7 = PROP_TAG(PT_TSTRING, 32819)
-PR_EMS_AB_EXTENSION_ATTRIBUTE_7_A = PROP_TAG(PT_STRING8, 32819)
-PR_EMS_AB_EXTENSION_ATTRIBUTE_7_W = PROP_TAG(PT_UNICODE, 32819)
-PR_EMS_AB_EXTENSION_ATTRIBUTE_8 = PROP_TAG(PT_TSTRING, 32820)
-PR_EMS_AB_EXTENSION_ATTRIBUTE_8_A = PROP_TAG(PT_STRING8, 32820)
-PR_EMS_AB_EXTENSION_ATTRIBUTE_8_W = PROP_TAG(PT_UNICODE, 32820)
-PR_EMS_AB_EXTENSION_ATTRIBUTE_9 = PROP_TAG(PT_TSTRING, 32821)
-PR_EMS_AB_EXTENSION_ATTRIBUTE_9_A = PROP_TAG(PT_STRING8, 32821)
-PR_EMS_AB_EXTENSION_ATTRIBUTE_9_W = PROP_TAG(PT_UNICODE, 32821)
-PR_EMS_AB_EXTENSION_DATA = PROP_TAG(PT_MV_BINARY, 32936)
-PR_EMS_AB_EXTENSION_NAME = PROP_TAG(PT_MV_TSTRING, 32937)
-PR_EMS_AB_EXTENSION_NAME_A = PROP_TAG(PT_MV_STRING8, 32937)
-PR_EMS_AB_EXTENSION_NAME_W = PROP_TAG(PT_MV_UNICODE, 32937)
-PR_EMS_AB_EXTENSION_NAME_INHERITED = PROP_TAG(PT_MV_TSTRING, 32938)
-PR_EMS_AB_EXTENSION_NAME_INHERITED_A = PROP_TAG(PT_MV_STRING8, 32938)
-PR_EMS_AB_EXTENSION_NAME_INHERITED_W = PROP_TAG(PT_MV_UNICODE, 32938)
-PR_EMS_AB_FACSIMILE_TELEPHONE_NUMBER = PROP_TAG(PT_MV_BINARY, 32939)
-PR_EMS_AB_FILE_VERSION = PROP_TAG(PT_BINARY, 32940)
-PR_EMS_AB_FILTER_LOCAL_ADDRESSES = PROP_TAG(PT_BOOLEAN, 32941)
-PR_EMS_AB_FOLDER_PATHNAME = PROP_TAG(PT_TSTRING, 32772)
-PR_EMS_AB_FOLDER_PATHNAME_A = PROP_TAG(PT_STRING8, 32772)
-PR_EMS_AB_FOLDER_PATHNAME_W = PROP_TAG(PT_UNICODE, 32772)
-PR_EMS_AB_FOLDERS_CONTAINER = PROP_TAG(PT_TSTRING, 32942)
-PR_EMS_AB_FOLDERS_CONTAINER_A = PROP_TAG(PT_STRING8, 32942)
-PR_EMS_AB_FOLDERS_CONTAINER_W = PROP_TAG(PT_UNICODE, 32942)
-PR_EMS_AB_FOLDERS_CONTAINER_O = PROP_TAG(PT_OBJECT, 32942)
-PR_EMS_AB_FOLDERS_CONTAINER_T = PROP_TAG(PT_TSTRING, 32942)
-PR_EMS_AB_GARBAGE_COLL_PERIOD = PROP_TAG(PT_LONG, 32943)
-PR_EMS_AB_GATEWAY_LOCAL_CRED = PROP_TAG(PT_TSTRING, 32944)
-PR_EMS_AB_GATEWAY_LOCAL_CRED_A = PROP_TAG(PT_STRING8, 32944)
-PR_EMS_AB_GATEWAY_LOCAL_CRED_W = PROP_TAG(PT_UNICODE, 32944)
-PR_EMS_AB_GATEWAY_LOCAL_DESIG = PROP_TAG(PT_TSTRING, 32945)
-PR_EMS_AB_GATEWAY_LOCAL_DESIG_A = PROP_TAG(PT_STRING8, 32945)
-PR_EMS_AB_GATEWAY_LOCAL_DESIG_W = PROP_TAG(PT_UNICODE, 32945)
-PR_EMS_AB_GATEWAY_PROXY = PROP_TAG(PT_MV_TSTRING, 32946)
-PR_EMS_AB_GATEWAY_PROXY_A = PROP_TAG(PT_MV_STRING8, 32946)
-PR_EMS_AB_GATEWAY_PROXY_W = PROP_TAG(PT_MV_UNICODE, 32946)
-PR_EMS_AB_GATEWAY_ROUTING_TREE = PROP_TAG(PT_BINARY, 32947)
-PR_EMS_AB_GWART_LAST_MODIFIED = PROP_TAG(PT_SYSTIME, 32948)
-PR_EMS_AB_HAS_FULL_REPLICA_NCS = PROP_TAG(PT_MV_TSTRING, 32949)
-PR_EMS_AB_HAS_FULL_REPLICA_NCS_A = PROP_TAG(PT_MV_STRING8, 32949)
-PR_EMS_AB_HAS_FULL_REPLICA_NCS_W = PROP_TAG(PT_MV_UNICODE, 32949)
-PR_EMS_AB_HAS_FULL_REPLICA_NCS_O = PROP_TAG(PT_OBJECT, 32949)
-PR_EMS_AB_HAS_FULL_REPLICA_NCS_T = PROP_TAG(PT_MV_TSTRING, 32949)
-PR_EMS_AB_HAS_MASTER_NCS = PROP_TAG(PT_MV_TSTRING, 32950)
-PR_EMS_AB_HAS_MASTER_NCS_A = PROP_TAG(PT_MV_STRING8, 32950)
-PR_EMS_AB_HAS_MASTER_NCS_W = PROP_TAG(PT_MV_UNICODE, 32950)
-PR_EMS_AB_HAS_MASTER_NCS_O = PROP_TAG(PT_OBJECT, 32950)
-PR_EMS_AB_HAS_MASTER_NCS_T = PROP_TAG(PT_MV_TSTRING, 32950)
-PR_EMS_AB_HELP_DATA16 = PROP_TAG(PT_BINARY, 32826)
-PR_EMS_AB_HELP_DATA32 = PROP_TAG(PT_BINARY, 32784)
-PR_EMS_AB_HELP_FILE_NAME = PROP_TAG(PT_TSTRING, 32827)
-PR_EMS_AB_HELP_FILE_NAME_A = PROP_TAG(PT_STRING8, 32827)
-PR_EMS_AB_HELP_FILE_NAME_W = PROP_TAG(PT_UNICODE, 32827)
-PR_EMS_AB_HEURISTICS = PROP_TAG(PT_LONG, 32951)
-PR_EMS_AB_HIDE_DL_MEMBERSHIP = PROP_TAG(PT_BOOLEAN, 32952)
-PR_EMS_AB_HIDE_FROM_ADDRESS_BOOK = PROP_TAG(PT_BOOLEAN, 32953)
-PR_EMS_AB_HOME_MDB = PROP_TAG(PT_TSTRING, 32774)
-PR_EMS_AB_HOME_MDB_A = PROP_TAG(PT_STRING8, 32774)
-PR_EMS_AB_HOME_MDB_W = PROP_TAG(PT_UNICODE, 32774)
-PR_EMS_AB_HOME_MDB_O = PROP_TAG(PT_OBJECT, 32774)
-PR_EMS_AB_HOME_MDB_T = PROP_TAG(PT_TSTRING, 32774)
-PR_EMS_AB_HOME_MDB_BL = PROP_TAG(PT_MV_TSTRING, 32788)
-PR_EMS_AB_HOME_MDB_BL_A = PROP_TAG(PT_MV_STRING8, 32788)
-PR_EMS_AB_HOME_MDB_BL_W = PROP_TAG(PT_MV_UNICODE, 32788)
-PR_EMS_AB_HOME_MDB_BL_O = PROP_TAG(PT_OBJECT, 32788)
-PR_EMS_AB_HOME_MDB_BL_T = PROP_TAG(PT_MV_TSTRING, 32788)
-PR_EMS_AB_HOME_MTA = PROP_TAG(PT_TSTRING, 32775)
-PR_EMS_AB_HOME_MTA_A = PROP_TAG(PT_STRING8, 32775)
-PR_EMS_AB_HOME_MTA_W = PROP_TAG(PT_UNICODE, 32775)
-PR_EMS_AB_HOME_MTA_O = PROP_TAG(PT_OBJECT, 32775)
-PR_EMS_AB_HOME_MTA_T = PROP_TAG(PT_TSTRING, 32775)
-PR_EMS_AB_HOME_PUBLIC_SERVER = PROP_TAG(PT_TSTRING, 32831)
-PR_EMS_AB_HOME_PUBLIC_SERVER_A = PROP_TAG(PT_STRING8, 32831)
-PR_EMS_AB_HOME_PUBLIC_SERVER_W = PROP_TAG(PT_UNICODE, 32831)
-PR_EMS_AB_HOME_PUBLIC_SERVER_O = PROP_TAG(PT_OBJECT, 32831)
-PR_EMS_AB_HOME_PUBLIC_SERVER_T = PROP_TAG(PT_TSTRING, 32831)
-PR_EMS_AB_IMPORT_CONTAINER = PROP_TAG(PT_TSTRING, 32954)
-PR_EMS_AB_IMPORT_CONTAINER_A = PROP_TAG(PT_STRING8, 32954)
-PR_EMS_AB_IMPORT_CONTAINER_W = PROP_TAG(PT_UNICODE, 32954)
-PR_EMS_AB_IMPORT_CONTAINER_O = PROP_TAG(PT_OBJECT, 32954)
-PR_EMS_AB_IMPORT_CONTAINER_T = PROP_TAG(PT_TSTRING, 32954)
-PR_EMS_AB_IMPORT_SENSITIVITY = PROP_TAG(PT_LONG, 32955)
-PR_EMS_AB_IMPORTED_FROM = PROP_TAG(PT_TSTRING, 32834)
-PR_EMS_AB_IMPORTED_FROM_A = PROP_TAG(PT_STRING8, 32834)
-PR_EMS_AB_IMPORTED_FROM_W = PROP_TAG(PT_UNICODE, 32834)
-PR_EMS_AB_INBOUND_SITES = PROP_TAG(PT_MV_TSTRING, 32956)
-PR_EMS_AB_INBOUND_SITES_A = PROP_TAG(PT_MV_STRING8, 32956)
-PR_EMS_AB_INBOUND_SITES_W = PROP_TAG(PT_MV_UNICODE, 32956)
-PR_EMS_AB_INBOUND_SITES_O = PROP_TAG(PT_OBJECT, 32956)
-PR_EMS_AB_INBOUND_SITES_T = PROP_TAG(PT_MV_TSTRING, 32956)
-PR_EMS_AB_INSTANCE_TYPE = PROP_TAG(PT_LONG, 32957)
-PR_EMS_AB_INTERNATIONAL_ISDN_NUMBER = PROP_TAG(PT_MV_TSTRING, 32958)
-PR_EMS_AB_INTERNATIONAL_ISDN_NUMBER_A = PROP_TAG(PT_MV_STRING8, 32958)
-PR_EMS_AB_INTERNATIONAL_ISDN_NUMBER_W = PROP_TAG(PT_MV_UNICODE, 32958)
-PR_EMS_AB_INVOCATION_ID = PROP_TAG(PT_BINARY, 32959)
-PR_EMS_AB_IS_DELETED = PROP_TAG(PT_BOOLEAN, 32960)
-PR_EMS_AB_IS_MEMBER_OF_DL = PROP_TAG(PT_OBJECT, 32776)
-PR_EMS_AB_IS_MEMBER_OF_DL_A = PROP_TAG(PT_MV_STRING8, 32776)
-PR_EMS_AB_IS_MEMBER_OF_DL_W = PROP_TAG(PT_MV_UNICODE, 32776)
-PR_EMS_AB_IS_MEMBER_OF_DL_O = PROP_TAG(PT_OBJECT, 32776)
-PR_EMS_AB_IS_MEMBER_OF_DL_T = PROP_TAG(PT_MV_TSTRING, 32776)
-PR_EMS_AB_IS_SINGLE_VALUED = PROP_TAG(PT_BOOLEAN, 32961)
-PR_EMS_AB_KCC_STATUS = PROP_TAG(PT_MV_BINARY, 32962)
-PR_EMS_AB_KM_SERVER = PROP_TAG(PT_TSTRING, 32781)
-PR_EMS_AB_KM_SERVER_A = PROP_TAG(PT_STRING8, 32781)
-PR_EMS_AB_KM_SERVER_W = PROP_TAG(PT_UNICODE, 32781)
-PR_EMS_AB_KM_SERVER_O = PROP_TAG(PT_OBJECT, 32781)
-PR_EMS_AB_KM_SERVER_T = PROP_TAG(PT_TSTRING, 32781)
-PR_EMS_AB_KNOWLEDGE_INFORMATION = PROP_TAG(PT_MV_TSTRING, 32963)
-PR_EMS_AB_KNOWLEDGE_INFORMATION_A = PROP_TAG(PT_MV_STRING8, 32963)
-PR_EMS_AB_KNOWLEDGE_INFORMATION_W = PROP_TAG(PT_MV_UNICODE, 32963)
-PR_EMS_AB_LANGUAGE = PROP_TAG(PT_LONG, 33144)
-PR_EMS_AB_LDAP_DISPLAY_NAME = PROP_TAG(PT_MV_TSTRING, 33137)
-PR_EMS_AB_LDAP_DISPLAY_NAME_A = PROP_TAG(PT_MV_STRING8, 33137)
-PR_EMS_AB_LDAP_DISPLAY_NAME_W = PROP_TAG(PT_MV_UNICODE, 33137)
-PR_EMS_AB_LINE_WRAP = PROP_TAG(PT_LONG, 32964)
-PR_EMS_AB_LINK_ID = PROP_TAG(PT_LONG, 32965)
-PR_EMS_AB_LOCAL_BRIDGE_HEAD = PROP_TAG(PT_TSTRING, 32966)
-PR_EMS_AB_LOCAL_BRIDGE_HEAD_A = PROP_TAG(PT_STRING8, 32966)
-PR_EMS_AB_LOCAL_BRIDGE_HEAD_W = PROP_TAG(PT_UNICODE, 32966)
-PR_EMS_AB_LOCAL_BRIDGE_HEAD_ADDRESS = PROP_TAG(PT_TSTRING, 32967)
-PR_EMS_AB_LOCAL_BRIDGE_HEAD_ADDRESS_A = PROP_TAG(PT_STRING8, 32967)
-PR_EMS_AB_LOCAL_BRIDGE_HEAD_ADDRESS_W = PROP_TAG(PT_UNICODE, 32967)
-PR_EMS_AB_LOCAL_INITIAL_TURN = PROP_TAG(PT_BOOLEAN, 32968)
-PR_EMS_AB_LOCAL_SCOPE = PROP_TAG(PT_MV_TSTRING, 32969)
-PR_EMS_AB_LOCAL_SCOPE_A = PROP_TAG(PT_MV_STRING8, 32969)
-PR_EMS_AB_LOCAL_SCOPE_W = PROP_TAG(PT_MV_UNICODE, 32969)
-PR_EMS_AB_LOCAL_SCOPE_O = PROP_TAG(PT_OBJECT, 32969)
-PR_EMS_AB_LOCAL_SCOPE_T = PROP_TAG(PT_MV_TSTRING, 32969)
-PR_EMS_AB_LOG_FILENAME = PROP_TAG(PT_TSTRING, 32970)
-PR_EMS_AB_LOG_FILENAME_A = PROP_TAG(PT_STRING8, 32970)
-PR_EMS_AB_LOG_FILENAME_W = PROP_TAG(PT_UNICODE, 32970)
-PR_EMS_AB_LOG_ROLLOVER_INTERVAL = PROP_TAG(PT_LONG, 32971)
-PR_EMS_AB_MAINTAIN_AUTOREPLY_HISTORY = PROP_TAG(PT_BOOLEAN, 32972)
-PR_EMS_AB_MANAGER = PROP_TAG(PT_OBJECT, 32773)
-PR_EMS_AB_MANAGER_A = PROP_TAG(PT_STRING8, 32773)
-PR_EMS_AB_MANAGER_W = PROP_TAG(PT_UNICODE, 32773)
-PR_EMS_AB_MANAGER_O = PROP_TAG(PT_OBJECT, 32773)
-PR_EMS_AB_MANAGER_T = PROP_TAG(PT_TSTRING, 32773)
-PR_EMS_AB_MAPI_DISPLAY_TYPE = PROP_TAG(PT_LONG, 32973)
-PR_EMS_AB_MAPI_ID = PROP_TAG(PT_LONG, 32974)
-PR_EMS_AB_MAXIMUM_OBJECT_ID = PROP_TAG(PT_BINARY, 33129)
-PR_EMS_AB_MDB_BACKOFF_INTERVAL = PROP_TAG(PT_LONG, 32975)
-PR_EMS_AB_MDB_MSG_TIME_OUT_PERIOD = PROP_TAG(PT_LONG, 32976)
-PR_EMS_AB_MDB_OVER_QUOTA_LIMIT = PROP_TAG(PT_LONG, 32977)
-PR_EMS_AB_MDB_STORAGE_QUOTA = PROP_TAG(PT_LONG, 32978)
-PR_EMS_AB_MDB_UNREAD_LIMIT = PROP_TAG(PT_LONG, 32979)
-PR_EMS_AB_MDB_USE_DEFAULTS = PROP_TAG(PT_BOOLEAN, 32980)
-PR_EMS_AB_MEMBER = PROP_TAG(PT_OBJECT, 32777)
-PR_EMS_AB_MEMBER_A = PROP_TAG(PT_MV_STRING8, 32777)
-PR_EMS_AB_MEMBER_W = PROP_TAG(PT_MV_UNICODE, 32777)
-PR_EMS_AB_MEMBER_O = PROP_TAG(PT_OBJECT, 32777)
-PR_EMS_AB_MEMBER_T = PROP_TAG(PT_MV_TSTRING, 32777)
-PR_EMS_AB_MESSAGE_TRACKING_ENABLED = PROP_TAG(PT_BOOLEAN, 32981)
-PR_EMS_AB_MONITOR_CLOCK = PROP_TAG(PT_BOOLEAN, 32982)
-PR_EMS_AB_MONITOR_SERVERS = PROP_TAG(PT_BOOLEAN, 32983)
-PR_EMS_AB_MONITOR_SERVICES = PROP_TAG(PT_BOOLEAN, 32984)
-PR_EMS_AB_MONITORED_CONFIGURATIONS = PROP_TAG(PT_MV_TSTRING, 32985)
-PR_EMS_AB_MONITORED_CONFIGURATIONS_A = PROP_TAG(PT_MV_STRING8, 32985)
-PR_EMS_AB_MONITORED_CONFIGURATIONS_W = PROP_TAG(PT_MV_UNICODE, 32985)
-PR_EMS_AB_MONITORED_CONFIGURATIONS_O = PROP_TAG(PT_OBJECT, 32985)
-PR_EMS_AB_MONITORED_CONFIGURATIONS_T = PROP_TAG(PT_MV_TSTRING, 32985)
-PR_EMS_AB_MONITORED_SERVERS = PROP_TAG(PT_MV_TSTRING, 32986)
-PR_EMS_AB_MONITORED_SERVERS_A = PROP_TAG(PT_MV_STRING8, 32986)
-PR_EMS_AB_MONITORED_SERVERS_W = PROP_TAG(PT_MV_UNICODE, 32986)
-PR_EMS_AB_MONITORED_SERVERS_O = PROP_TAG(PT_OBJECT, 32986)
-PR_EMS_AB_MONITORED_SERVERS_T = PROP_TAG(PT_MV_TSTRING, 32986)
-PR_EMS_AB_MONITORED_SERVICES = PROP_TAG(PT_MV_TSTRING, 32987)
-PR_EMS_AB_MONITORED_SERVICES_A = PROP_TAG(PT_MV_STRING8, 32987)
-PR_EMS_AB_MONITORED_SERVICES_W = PROP_TAG(PT_MV_UNICODE, 32987)
-PR_EMS_AB_MONITORING_ALERT_DELAY = PROP_TAG(PT_LONG, 32988)
-PR_EMS_AB_MONITORING_ALERT_UNITS = PROP_TAG(PT_LONG, 32989)
-PR_EMS_AB_MONITORING_AVAILABILITY_STYLE = PROP_TAG(PT_LONG, 32990)
-PR_EMS_AB_MONITORING_AVAILABILITY_WINDOW = PROP_TAG(PT_BINARY, 32991)
-PR_EMS_AB_MONITORING_CACHED_VIA_MAIL = PROP_TAG(PT_MV_TSTRING, 32992)
-PR_EMS_AB_MONITORING_CACHED_VIA_MAIL_A = PROP_TAG(PT_MV_STRING8, 32992)
-PR_EMS_AB_MONITORING_CACHED_VIA_MAIL_W = PROP_TAG(PT_MV_UNICODE, 32992)
-PR_EMS_AB_MONITORING_CACHED_VIA_MAIL_O = PROP_TAG(PT_OBJECT, 32992)
-PR_EMS_AB_MONITORING_CACHED_VIA_MAIL_T = PROP_TAG(PT_MV_TSTRING, 32992)
-PR_EMS_AB_MONITORING_CACHED_VIA_RPC = PROP_TAG(PT_MV_TSTRING, 32993)
-PR_EMS_AB_MONITORING_CACHED_VIA_RPC_A = PROP_TAG(PT_MV_STRING8, 32993)
-PR_EMS_AB_MONITORING_CACHED_VIA_RPC_W = PROP_TAG(PT_MV_UNICODE, 32993)
-PR_EMS_AB_MONITORING_CACHED_VIA_RPC_O = PROP_TAG(PT_OBJECT, 32993)
-PR_EMS_AB_MONITORING_CACHED_VIA_RPC_T = PROP_TAG(PT_MV_TSTRING, 32993)
-PR_EMS_AB_MONITORING_ESCALATION_PROCEDURE = PROP_TAG(PT_MV_BINARY, 32994)
-PR_EMS_AB_MONITORING_HOTSITE_POLL_INTERVAL = PROP_TAG(PT_LONG, 32995)
-PR_EMS_AB_MONITORING_HOTSITE_POLL_UNITS = PROP_TAG(PT_LONG, 32996)
-PR_EMS_AB_MONITORING_MAIL_UPDATE_INTERVAL = PROP_TAG(PT_LONG, 32997)
-PR_EMS_AB_MONITORING_MAIL_UPDATE_UNITS = PROP_TAG(PT_LONG, 32998)
-PR_EMS_AB_MONITORING_NORMAL_POLL_INTERVAL = PROP_TAG(PT_LONG, 32999)
-PR_EMS_AB_MONITORING_NORMAL_POLL_UNITS = PROP_TAG(PT_LONG, 33000)
-PR_EMS_AB_MONITORING_RECIPIENTS = PROP_TAG(PT_MV_TSTRING, 33001)
-PR_EMS_AB_MONITORING_RECIPIENTS_A = PROP_TAG(PT_MV_STRING8, 33001)
-PR_EMS_AB_MONITORING_RECIPIENTS_W = PROP_TAG(PT_MV_UNICODE, 33001)
-PR_EMS_AB_MONITORING_RECIPIENTS_O = PROP_TAG(PT_OBJECT, 33001)
-PR_EMS_AB_MONITORING_RECIPIENTS_T = PROP_TAG(PT_MV_TSTRING, 33001)
-PR_EMS_AB_MONITORING_RECIPIENTS_NDR = PROP_TAG(PT_MV_TSTRING, 33002)
-PR_EMS_AB_MONITORING_RECIPIENTS_NDR_A = PROP_TAG(PT_MV_STRING8, 33002)
-PR_EMS_AB_MONITORING_RECIPIENTS_NDR_W = PROP_TAG(PT_MV_UNICODE, 33002)
-PR_EMS_AB_MONITORING_RECIPIENTS_NDR_O = PROP_TAG(PT_OBJECT, 33002)
-PR_EMS_AB_MONITORING_RECIPIENTS_NDR_T = PROP_TAG(PT_MV_TSTRING, 33002)
-PR_EMS_AB_MONITORING_RPC_UPDATE_INTERVAL = PROP_TAG(PT_LONG, 33003)
-PR_EMS_AB_MONITORING_RPC_UPDATE_UNITS = PROP_TAG(PT_LONG, 33004)
-PR_EMS_AB_MONITORING_WARNING_DELAY = PROP_TAG(PT_LONG, 33005)
-PR_EMS_AB_MONITORING_WARNING_UNITS = PROP_TAG(PT_LONG, 33006)
-PR_EMS_AB_MTA_LOCAL_CRED = PROP_TAG(PT_TSTRING, 33007)
-PR_EMS_AB_MTA_LOCAL_CRED_A = PROP_TAG(PT_STRING8, 33007)
-PR_EMS_AB_MTA_LOCAL_CRED_W = PROP_TAG(PT_UNICODE, 33007)
-PR_EMS_AB_MTA_LOCAL_DESIG = PROP_TAG(PT_TSTRING, 33008)
-PR_EMS_AB_MTA_LOCAL_DESIG_A = PROP_TAG(PT_STRING8, 33008)
-PR_EMS_AB_MTA_LOCAL_DESIG_W = PROP_TAG(PT_UNICODE, 33008)
-PR_EMS_AB_N_ADDRESS = PROP_TAG(PT_BINARY, 33009)
-PR_EMS_AB_N_ADDRESS_TYPE = PROP_TAG(PT_LONG, 33010)
-PR_EMS_AB_NETWORK_ADDRESS = PROP_TAG(PT_MV_TSTRING, 33136)
-PR_EMS_AB_NETWORK_ADDRESS_A = PROP_TAG(PT_MV_STRING8, 33136)
-PR_EMS_AB_NETWORK_ADDRESS_W = PROP_TAG(PT_MV_UNICODE, 33136)
-PR_EMS_AB_NNTP_CHARACTER_SET = PROP_TAG(PT_TSTRING, 33149)
-PR_EMS_AB_NNTP_CHARACTER_SET_A = PROP_TAG(PT_STRING8, 33149)
-PR_EMS_AB_NNTP_CHARACTER_SET_W = PROP_TAG(PT_UNICODE, 33149)
-PR_EMS_AB_NNTP_CONTENT_FORMAT = PROP_TAG(PT_TSTRING, 33142)
-PR_EMS_AB_NNTP_CONTENT_FORMAT_A = PROP_TAG(PT_STRING8, 33142)
-PR_EMS_AB_NNTP_CONTENT_FORMAT_W = PROP_TAG(PT_UNICODE, 33142)
-PR_EMS_AB_NT_MACHINE_NAME = PROP_TAG(PT_TSTRING, 33011)
-PR_EMS_AB_NT_MACHINE_NAME_A = PROP_TAG(PT_STRING8, 33011)
-PR_EMS_AB_NT_MACHINE_NAME_W = PROP_TAG(PT_UNICODE, 33011)
-PR_EMS_AB_NT_SECURITY_DESCRIPTOR = PROP_TAG(PT_BINARY, 32787)
-PR_EMS_AB_NUM_OF_OPEN_RETRIES = PROP_TAG(PT_LONG, 33012)
-PR_EMS_AB_NUM_OF_TRANSFER_RETRIES = PROP_TAG(PT_LONG, 33013)
-PR_EMS_AB_OBJ_DIST_NAME = PROP_TAG(PT_TSTRING, 32828)
-PR_EMS_AB_OBJ_DIST_NAME_A = PROP_TAG(PT_STRING8, 32828)
-PR_EMS_AB_OBJ_DIST_NAME_W = PROP_TAG(PT_UNICODE, 32828)
-PR_EMS_AB_OBJ_DIST_NAME_O = PROP_TAG(PT_OBJECT, 32828)
-PR_EMS_AB_OBJ_DIST_NAME_T = PROP_TAG(PT_TSTRING, 32828)
-PR_EMS_AB_OBJECT_CLASS_CATEGORY = PROP_TAG(PT_LONG, 33014)
-PR_EMS_AB_OBJECT_VERSION = PROP_TAG(PT_LONG, 33015)
-PR_EMS_AB_OFF_LINE_AB_CONTAINERS = PROP_TAG(PT_MV_TSTRING, 33016)
-PR_EMS_AB_OFF_LINE_AB_CONTAINERS_A = PROP_TAG(PT_MV_STRING8, 33016)
-PR_EMS_AB_OFF_LINE_AB_CONTAINERS_W = PROP_TAG(PT_MV_UNICODE, 33016)
-PR_EMS_AB_OFF_LINE_AB_CONTAINERS_O = PROP_TAG(PT_OBJECT, 33016)
-PR_EMS_AB_OFF_LINE_AB_CONTAINERS_T = PROP_TAG(PT_MV_TSTRING, 33016)
-PR_EMS_AB_OFF_LINE_AB_SCHEDULE = PROP_TAG(PT_BINARY, 33017)
-PR_EMS_AB_OFF_LINE_AB_SERVER = PROP_TAG(PT_TSTRING, 33018)
-PR_EMS_AB_OFF_LINE_AB_SERVER_A = PROP_TAG(PT_STRING8, 33018)
-PR_EMS_AB_OFF_LINE_AB_SERVER_W = PROP_TAG(PT_UNICODE, 33018)
-PR_EMS_AB_OFF_LINE_AB_SERVER_O = PROP_TAG(PT_OBJECT, 33018)
-PR_EMS_AB_OFF_LINE_AB_SERVER_T = PROP_TAG(PT_TSTRING, 33018)
-PR_EMS_AB_OFF_LINE_AB_STYLE = PROP_TAG(PT_LONG, 33019)
-PR_EMS_AB_OID_TYPE = PROP_TAG(PT_LONG, 33020)
-PR_EMS_AB_OM_OBJECT_CLASS = PROP_TAG(PT_BINARY, 33021)
-PR_EMS_AB_OM_SYNTAX = PROP_TAG(PT_LONG, 33022)
-PR_EMS_AB_OOF_REPLY_TO_ORIGINATOR = PROP_TAG(PT_BOOLEAN, 33023)
-PR_EMS_AB_OPEN_RETRY_INTERVAL = PROP_TAG(PT_LONG, 33024)
-PR_EMS_AB_ORGANIZATION_NAME = PROP_TAG(PT_MV_TSTRING, 33025)
-PR_EMS_AB_ORGANIZATION_NAME_A = PROP_TAG(PT_MV_STRING8, 33025)
-PR_EMS_AB_ORGANIZATION_NAME_W = PROP_TAG(PT_MV_UNICODE, 33025)
-PR_EMS_AB_ORGANIZATIONAL_UNIT_NAME = PROP_TAG(PT_MV_TSTRING, 33026)
-PR_EMS_AB_ORGANIZATIONAL_UNIT_NAME_A = PROP_TAG(PT_MV_STRING8, 33026)
-PR_EMS_AB_ORGANIZATIONAL_UNIT_NAME_W = PROP_TAG(PT_MV_UNICODE, 33026)
-PR_EMS_AB_ORIGINAL_DISPLAY_TABLE = PROP_TAG(PT_BINARY, 33027)
-PR_EMS_AB_ORIGINAL_DISPLAY_TABLE_MSDOS = PROP_TAG(PT_BINARY, 33028)
-PR_EMS_AB_OUTBOUND_SITES = PROP_TAG(PT_MV_TSTRING, 33029)
-PR_EMS_AB_OUTBOUND_SITES_A = PROP_TAG(PT_MV_STRING8, 33029)
-PR_EMS_AB_OUTBOUND_SITES_W = PROP_TAG(PT_MV_UNICODE, 33029)
-PR_EMS_AB_OUTBOUND_SITES_O = PROP_TAG(PT_OBJECT, 33029)
-PR_EMS_AB_OUTBOUND_SITES_T = PROP_TAG(PT_MV_TSTRING, 33029)
-PR_EMS_AB_OWNER = PROP_TAG(PT_TSTRING, 32780)
-PR_EMS_AB_OWNER_A = PROP_TAG(PT_STRING8, 32780)
-PR_EMS_AB_OWNER_W = PROP_TAG(PT_UNICODE, 32780)
-PR_EMS_AB_OWNER_O = PROP_TAG(PT_OBJECT, 32780)
-PR_EMS_AB_OWNER_T = PROP_TAG(PT_TSTRING, 32780)
-PR_EMS_AB_OWNER_BL = PROP_TAG(PT_TSTRING, 32804)
-PR_EMS_AB_OWNER_BL_A = PROP_TAG(PT_STRING8, 32804)
-PR_EMS_AB_OWNER_BL_W = PROP_TAG(PT_UNICODE, 32804)
-PR_EMS_AB_OWNER_BL_O = PROP_TAG(PT_OBJECT, 32804)
-PR_EMS_AB_OWNER_BL_T = PROP_TAG(PT_TSTRING, 32804)
-PR_EMS_AB_P_SELECTOR = PROP_TAG(PT_BINARY, 33030)
-PR_EMS_AB_P_SELECTOR_INBOUND = PROP_TAG(PT_BINARY, 33031)
-PR_EMS_AB_PER_MSG_DIALOG_DISPLAY_TABLE = PROP_TAG(PT_BINARY, 33032)
-PR_EMS_AB_PER_RECIP_DIALOG_DISPLAY_TABLE = PROP_TAG(PT_BINARY, 33033)
-PR_EMS_AB_PERIOD_REP_SYNC_TIMES = PROP_TAG(PT_BINARY, 33034)
-PR_EMS_AB_PERIOD_REPL_STAGGER = PROP_TAG(PT_LONG, 33035)
-PR_EMS_AB_PF_CONTACTS = PROP_TAG(PT_MV_TSTRING, 32824)
-PR_EMS_AB_PF_CONTACTS_A = PROP_TAG(PT_MV_STRING8, 32824)
-PR_EMS_AB_PF_CONTACTS_W = PROP_TAG(PT_MV_UNICODE, 32824)
-PR_EMS_AB_PF_CONTACTS_O = PROP_TAG(PT_OBJECT, 32824)
-PR_EMS_AB_PF_CONTACTS_T = PROP_TAG(PT_MV_TSTRING, 32824)
-PR_EMS_AB_POP_CHARACTER_SET = PROP_TAG(PT_TSTRING, 33145)
-PR_EMS_AB_POP_CHARACTER_SET_A = PROP_TAG(PT_STRING8, 33145)
-PR_EMS_AB_POP_CHARACTER_SET_W = PROP_TAG(PT_UNICODE, 33145)
-PR_EMS_AB_POP_CONTENT_FORMAT = PROP_TAG(PT_TSTRING, 33143)
-PR_EMS_AB_POP_CONTENT_FORMAT_A = PROP_TAG(PT_STRING8, 33143)
-PR_EMS_AB_POP_CONTENT_FORMAT_W = PROP_TAG(PT_UNICODE, 33143)
-PR_EMS_AB_POSTAL_ADDRESS = PROP_TAG(PT_MV_BINARY, 33036)
-PR_EMS_AB_PREFERRED_DELIVERY_METHOD = PROP_TAG(PT_MV_LONG, 33037)
-PR_EMS_AB_PRMD = PROP_TAG(PT_TSTRING, 33038)
-PR_EMS_AB_PRMD_A = PROP_TAG(PT_STRING8, 33038)
-PR_EMS_AB_PRMD_W = PROP_TAG(PT_UNICODE, 33038)
-PR_EMS_AB_PROXY_ADDRESSES = PROP_TAG(PT_MV_TSTRING, 32783)
-PR_EMS_AB_PROXY_ADDRESSES_A = PROP_TAG(PT_MV_STRING8, 32783)
-PR_EMS_AB_PROXY_ADDRESSES_W = PROP_TAG(PT_MV_UNICODE, 32783)
-PR_EMS_AB_PROXY_GENERATOR_DLL = PROP_TAG(PT_TSTRING, 33039)
-PR_EMS_AB_PROXY_GENERATOR_DLL_A = PROP_TAG(PT_STRING8, 33039)
-PR_EMS_AB_PROXY_GENERATOR_DLL_W = PROP_TAG(PT_UNICODE, 33039)
-PR_EMS_AB_PUBLIC_DELEGATES = PROP_TAG(PT_OBJECT, 32789)
-PR_EMS_AB_PUBLIC_DELEGATES_A = PROP_TAG(PT_MV_STRING8, 32789)
-PR_EMS_AB_PUBLIC_DELEGATES_W = PROP_TAG(PT_MV_UNICODE, 32789)
-PR_EMS_AB_PUBLIC_DELEGATES_O = PROP_TAG(PT_OBJECT, 32789)
-PR_EMS_AB_PUBLIC_DELEGATES_T = PROP_TAG(PT_MV_TSTRING, 32789)
-PR_EMS_AB_PUBLIC_DELEGATES_BL = PROP_TAG(PT_MV_TSTRING, 33040)
-PR_EMS_AB_PUBLIC_DELEGATES_BL_A = PROP_TAG(PT_MV_STRING8, 33040)
-PR_EMS_AB_PUBLIC_DELEGATES_BL_W = PROP_TAG(PT_MV_UNICODE, 33040)
-PR_EMS_AB_PUBLIC_DELEGATES_BL_O = PROP_TAG(PT_OBJECT, 33040)
-PR_EMS_AB_PUBLIC_DELEGATES_BL_T = PROP_TAG(PT_MV_TSTRING, 33040)
-PR_EMS_AB_QUOTA_NOTIFICATION_SCHEDULE = PROP_TAG(PT_BINARY, 33041)
-PR_EMS_AB_QUOTA_NOTIFICATION_STYLE = PROP_TAG(PT_LONG, 33042)
-PR_EMS_AB_RANGE_LOWER = PROP_TAG(PT_LONG, 33043)
-PR_EMS_AB_RANGE_UPPER = PROP_TAG(PT_LONG, 33044)
-PR_EMS_AB_RAS_CALLBACK_NUMBER = PROP_TAG(PT_TSTRING, 33045)
-PR_EMS_AB_RAS_CALLBACK_NUMBER_A = PROP_TAG(PT_STRING8, 33045)
-PR_EMS_AB_RAS_CALLBACK_NUMBER_W = PROP_TAG(PT_UNICODE, 33045)
-PR_EMS_AB_RAS_PHONE_NUMBER = PROP_TAG(PT_TSTRING, 33046)
-PR_EMS_AB_RAS_PHONE_NUMBER_A = PROP_TAG(PT_STRING8, 33046)
-PR_EMS_AB_RAS_PHONE_NUMBER_W = PROP_TAG(PT_UNICODE, 33046)
-PR_EMS_AB_RAS_PHONEBOOK_ENTRY_NAME = PROP_TAG(PT_TSTRING, 33047)
-PR_EMS_AB_RAS_PHONEBOOK_ENTRY_NAME_A = PROP_TAG(PT_STRING8, 33047)
-PR_EMS_AB_RAS_PHONEBOOK_ENTRY_NAME_W = PROP_TAG(PT_UNICODE, 33047)
-PR_EMS_AB_RAS_REMOTE_SRVR_NAME = PROP_TAG(PT_TSTRING, 33048)
-PR_EMS_AB_RAS_REMOTE_SRVR_NAME_A = PROP_TAG(PT_STRING8, 33048)
-PR_EMS_AB_RAS_REMOTE_SRVR_NAME_W = PROP_TAG(PT_UNICODE, 33048)
-PR_EMS_AB_REGISTERED_ADDRESS = PROP_TAG(PT_MV_BINARY, 33049)
-PR_EMS_AB_REMOTE_BRIDGE_HEAD = PROP_TAG(PT_TSTRING, 33050)
-PR_EMS_AB_REMOTE_BRIDGE_HEAD_A = PROP_TAG(PT_STRING8, 33050)
-PR_EMS_AB_REMOTE_BRIDGE_HEAD_W = PROP_TAG(PT_UNICODE, 33050)
-PR_EMS_AB_REMOTE_BRIDGE_HEAD_ADDRESS = PROP_TAG(PT_TSTRING, 33051)
-PR_EMS_AB_REMOTE_BRIDGE_HEAD_ADDRESS_A = PROP_TAG(PT_STRING8, 33051)
-PR_EMS_AB_REMOTE_BRIDGE_HEAD_ADDRESS_W = PROP_TAG(PT_UNICODE, 33051)
-PR_EMS_AB_REMOTE_OUT_BH_SERVER = PROP_TAG(PT_TSTRING, 33052)
-PR_EMS_AB_REMOTE_OUT_BH_SERVER_A = PROP_TAG(PT_STRING8, 33052)
-PR_EMS_AB_REMOTE_OUT_BH_SERVER_W = PROP_TAG(PT_UNICODE, 33052)
-PR_EMS_AB_REMOTE_OUT_BH_SERVER_O = PROP_TAG(PT_OBJECT, 33052)
-PR_EMS_AB_REMOTE_OUT_BH_SERVER_T = PROP_TAG(PT_TSTRING, 33052)
-PR_EMS_AB_REMOTE_SITE = PROP_TAG(PT_TSTRING, 33053)
-PR_EMS_AB_REMOTE_SITE_A = PROP_TAG(PT_STRING8, 33053)
-PR_EMS_AB_REMOTE_SITE_W = PROP_TAG(PT_UNICODE, 33053)
-PR_EMS_AB_REMOTE_SITE_O = PROP_TAG(PT_OBJECT, 33053)
-PR_EMS_AB_REMOTE_SITE_T = PROP_TAG(PT_TSTRING, 33053)
-PR_EMS_AB_REPLICATION_MAIL_MSG_SIZE = PROP_TAG(PT_LONG, 33128)
-PR_EMS_AB_REPLICATION_SENSITIVITY = PROP_TAG(PT_LONG, 33054)
-PR_EMS_AB_REPLICATION_STAGGER = PROP_TAG(PT_LONG, 33055)
-PR_EMS_AB_REPORT_TO_ORIGINATOR = PROP_TAG(PT_BOOLEAN, 33056)
-PR_EMS_AB_REPORT_TO_OWNER = PROP_TAG(PT_BOOLEAN, 33057)
-PR_EMS_AB_REPORTS = PROP_TAG(PT_OBJECT, 32782)
-PR_EMS_AB_REPORTS_A = PROP_TAG(PT_MV_STRING8, 32782)
-PR_EMS_AB_REPORTS_W = PROP_TAG(PT_MV_UNICODE, 32782)
-PR_EMS_AB_REPORTS_O = PROP_TAG(PT_OBJECT, 32782)
-PR_EMS_AB_REPORTS_T = PROP_TAG(PT_MV_TSTRING, 32782)
-PR_EMS_AB_REQ_SEQ = PROP_TAG(PT_LONG, 33058)
-PR_EMS_AB_RESPONSIBLE_LOCAL_DXA = PROP_TAG(PT_TSTRING, 33059)
-PR_EMS_AB_RESPONSIBLE_LOCAL_DXA_A = PROP_TAG(PT_STRING8, 33059)
-PR_EMS_AB_RESPONSIBLE_LOCAL_DXA_W = PROP_TAG(PT_UNICODE, 33059)
-PR_EMS_AB_RESPONSIBLE_LOCAL_DXA_O = PROP_TAG(PT_OBJECT, 33059)
-PR_EMS_AB_RESPONSIBLE_LOCAL_DXA_T = PROP_TAG(PT_TSTRING, 33059)
-PR_EMS_AB_RID_SERVER = PROP_TAG(PT_TSTRING, 33060)
-PR_EMS_AB_RID_SERVER_A = PROP_TAG(PT_STRING8, 33060)
-PR_EMS_AB_RID_SERVER_W = PROP_TAG(PT_UNICODE, 33060)
-PR_EMS_AB_RID_SERVER_O = PROP_TAG(PT_OBJECT, 33060)
-PR_EMS_AB_RID_SERVER_T = PROP_TAG(PT_TSTRING, 33060)
-PR_EMS_AB_ROLE_OCCUPANT = PROP_TAG(PT_MV_TSTRING, 33061)
-PR_EMS_AB_ROLE_OCCUPANT_A = PROP_TAG(PT_MV_STRING8, 33061)
-PR_EMS_AB_ROLE_OCCUPANT_W = PROP_TAG(PT_MV_UNICODE, 33061)
-PR_EMS_AB_ROLE_OCCUPANT_O = PROP_TAG(PT_OBJECT, 33061)
-PR_EMS_AB_ROLE_OCCUPANT_T = PROP_TAG(PT_MV_TSTRING, 33061)
-PR_EMS_AB_ROUTING_LIST = PROP_TAG(PT_MV_TSTRING, 33062)
-PR_EMS_AB_ROUTING_LIST_A = PROP_TAG(PT_MV_STRING8, 33062)
-PR_EMS_AB_ROUTING_LIST_W = PROP_TAG(PT_MV_UNICODE, 33062)
-PR_EMS_AB_RTS_CHECKPOINT_SIZE = PROP_TAG(PT_LONG, 33063)
-PR_EMS_AB_RTS_RECOVERY_TIMEOUT = PROP_TAG(PT_LONG, 33064)
-PR_EMS_AB_RTS_WINDOW_SIZE = PROP_TAG(PT_LONG, 33065)
-PR_EMS_AB_RUNS_ON = PROP_TAG(PT_MV_TSTRING, 33066)
-PR_EMS_AB_RUNS_ON_A = PROP_TAG(PT_MV_STRING8, 33066)
-PR_EMS_AB_RUNS_ON_W = PROP_TAG(PT_MV_UNICODE, 33066)
-PR_EMS_AB_RUNS_ON_O = PROP_TAG(PT_OBJECT, 33066)
-PR_EMS_AB_RUNS_ON_T = PROP_TAG(PT_MV_TSTRING, 33066)
-PR_EMS_AB_S_SELECTOR = PROP_TAG(PT_BINARY, 33067)
-PR_EMS_AB_S_SELECTOR_INBOUND = PROP_TAG(PT_BINARY, 33068)
-PR_EMS_AB_SCHEMA_FLAGS = PROP_TAG(PT_LONG, 33139)
-PR_EMS_AB_SCHEMA_VERSION = PROP_TAG(PT_MV_LONG, 33148)
-PR_EMS_AB_SEARCH_FLAGS = PROP_TAG(PT_LONG, 33069)
-PR_EMS_AB_SEARCH_GUIDE = PROP_TAG(PT_MV_BINARY, 33070)
-PR_EMS_AB_SECURITY_PROTOCOL = PROP_TAG(PT_MV_BINARY, 32823)
-PR_EMS_AB_SEE_ALSO = PROP_TAG(PT_MV_TSTRING, 33071)
-PR_EMS_AB_SEE_ALSO_A = PROP_TAG(PT_MV_STRING8, 33071)
-PR_EMS_AB_SEE_ALSO_W = PROP_TAG(PT_MV_UNICODE, 33071)
-PR_EMS_AB_SEE_ALSO_O = PROP_TAG(PT_OBJECT, 33071)
-PR_EMS_AB_SEE_ALSO_T = PROP_TAG(PT_MV_TSTRING, 33071)
-PR_EMS_AB_SERIAL_NUMBER = PROP_TAG(PT_MV_TSTRING, 33072)
-PR_EMS_AB_SERIAL_NUMBER_A = PROP_TAG(PT_MV_STRING8, 33072)
-PR_EMS_AB_SERIAL_NUMBER_W = PROP_TAG(PT_MV_UNICODE, 33072)
-PR_EMS_AB_SERVICE_ACTION_FIRST = PROP_TAG(PT_LONG, 33073)
-PR_EMS_AB_SERVICE_ACTION_OTHER = PROP_TAG(PT_LONG, 33074)
-PR_EMS_AB_SERVICE_ACTION_SECOND = PROP_TAG(PT_LONG, 33075)
-PR_EMS_AB_SERVICE_RESTART_DELAY = PROP_TAG(PT_LONG, 33076)
-PR_EMS_AB_SERVICE_RESTART_MESSAGE = PROP_TAG(PT_TSTRING, 33077)
-PR_EMS_AB_SERVICE_RESTART_MESSAGE_A = PROP_TAG(PT_STRING8, 33077)
-PR_EMS_AB_SERVICE_RESTART_MESSAGE_W = PROP_TAG(PT_UNICODE, 33077)
-PR_EMS_AB_SESSION_DISCONNECT_TIMER = PROP_TAG(PT_LONG, 33078)
-PR_EMS_AB_SITE_AFFINITY = PROP_TAG(PT_MV_TSTRING, 33079)
-PR_EMS_AB_SITE_AFFINITY_A = PROP_TAG(PT_MV_STRING8, 33079)
-PR_EMS_AB_SITE_AFFINITY_W = PROP_TAG(PT_MV_UNICODE, 33079)
-PR_EMS_AB_SITE_FOLDER_GUID = PROP_TAG(PT_BINARY, 33126)
-PR_EMS_AB_SITE_FOLDER_SERVER = PROP_TAG(PT_TSTRING, 33127)
-PR_EMS_AB_SITE_FOLDER_SERVER_A = PROP_TAG(PT_STRING8, 33127)
-PR_EMS_AB_SITE_FOLDER_SERVER_W = PROP_TAG(PT_UNICODE, 33127)
-PR_EMS_AB_SITE_FOLDER_SERVER_O = PROP_TAG(PT_OBJECT, 33127)
-PR_EMS_AB_SITE_FOLDER_SERVER_T = PROP_TAG(PT_TSTRING, 33127)
-PR_EMS_AB_SITE_PROXY_SPACE = PROP_TAG(PT_MV_TSTRING, 33080)
-PR_EMS_AB_SITE_PROXY_SPACE_A = PROP_TAG(PT_MV_STRING8, 33080)
-PR_EMS_AB_SITE_PROXY_SPACE_W = PROP_TAG(PT_MV_UNICODE, 33080)
-PR_EMS_AB_SPACE_LAST_COMPUTED = PROP_TAG(PT_SYSTIME, 33081)
-PR_EMS_AB_STREET_ADDRESS = PROP_TAG(PT_TSTRING, 33082)
-PR_EMS_AB_STREET_ADDRESS_A = PROP_TAG(PT_STRING8, 33082)
-PR_EMS_AB_STREET_ADDRESS_W = PROP_TAG(PT_UNICODE, 33082)
-PR_EMS_AB_SUB_REFS = PROP_TAG(PT_MV_TSTRING, 33083)
-PR_EMS_AB_SUB_REFS_A = PROP_TAG(PT_MV_STRING8, 33083)
-PR_EMS_AB_SUB_REFS_W = PROP_TAG(PT_MV_UNICODE, 33083)
-PR_EMS_AB_SUB_REFS_O = PROP_TAG(PT_OBJECT, 33083)
-PR_EMS_AB_SUB_REFS_T = PROP_TAG(PT_MV_TSTRING, 33083)
-PR_EMS_AB_SUB_SITE = PROP_TAG(PT_TSTRING, 33147)
-PR_EMS_AB_SUB_SITE_A = PROP_TAG(PT_STRING8, 33147)
-PR_EMS_AB_SUB_SITE_W = PROP_TAG(PT_UNICODE, 33147)
-PR_EMS_AB_SUBMISSION_CONT_LENGTH = PROP_TAG(PT_LONG, 33084)
-PR_EMS_AB_SUPPORTED_APPLICATION_CONTEXT = PROP_TAG(PT_MV_BINARY, 33085)
-PR_EMS_AB_SUPPORTING_STACK = PROP_TAG(PT_MV_TSTRING, 33086)
-PR_EMS_AB_SUPPORTING_STACK_A = PROP_TAG(PT_MV_STRING8, 33086)
-PR_EMS_AB_SUPPORTING_STACK_W = PROP_TAG(PT_MV_UNICODE, 33086)
-PR_EMS_AB_SUPPORTING_STACK_O = PROP_TAG(PT_OBJECT, 33086)
-PR_EMS_AB_SUPPORTING_STACK_T = PROP_TAG(PT_MV_TSTRING, 33086)
-PR_EMS_AB_SUPPORTING_STACK_BL = PROP_TAG(PT_MV_TSTRING, 33087)
-PR_EMS_AB_SUPPORTING_STACK_BL_A = PROP_TAG(PT_MV_STRING8, 33087)
-PR_EMS_AB_SUPPORTING_STACK_BL_W = PROP_TAG(PT_MV_UNICODE, 33087)
-PR_EMS_AB_SUPPORTING_STACK_BL_O = PROP_TAG(PT_OBJECT, 33087)
-PR_EMS_AB_SUPPORTING_STACK_BL_T = PROP_TAG(PT_MV_TSTRING, 33087)
-PR_EMS_AB_T_SELECTOR = PROP_TAG(PT_BINARY, 33088)
-PR_EMS_AB_T_SELECTOR_INBOUND = PROP_TAG(PT_BINARY, 33089)
-PR_EMS_AB_TARGET_ADDRESS = PROP_TAG(PT_TSTRING, 32785)
-PR_EMS_AB_TARGET_ADDRESS_A = PROP_TAG(PT_STRING8, 32785)
-PR_EMS_AB_TARGET_ADDRESS_W = PROP_TAG(PT_UNICODE, 32785)
-PR_EMS_AB_TARGET_MTAS = PROP_TAG(PT_MV_TSTRING, 33090)
-PR_EMS_AB_TARGET_MTAS_A = PROP_TAG(PT_MV_STRING8, 33090)
-PR_EMS_AB_TARGET_MTAS_W = PROP_TAG(PT_MV_UNICODE, 33090)
-PR_EMS_AB_TELEPHONE_NUMBER = PROP_TAG(PT_MV_TSTRING, 32786)
-PR_EMS_AB_TELEPHONE_NUMBER_A = PROP_TAG(PT_MV_STRING8, 32786)
-PR_EMS_AB_TELEPHONE_NUMBER_W = PROP_TAG(PT_MV_UNICODE, 32786)
-PR_EMS_AB_TELETEX_TERMINAL_IDENTIFIER = PROP_TAG(PT_MV_BINARY, 33091)
-PR_EMS_AB_TEMP_ASSOC_THRESHOLD = PROP_TAG(PT_LONG, 33092)
-PR_EMS_AB_TOMBSTONE_LIFETIME = PROP_TAG(PT_LONG, 33093)
-PR_EMS_AB_TRACKING_LOG_PATH_NAME = PROP_TAG(PT_TSTRING, 33094)
-PR_EMS_AB_TRACKING_LOG_PATH_NAME_A = PROP_TAG(PT_STRING8, 33094)
-PR_EMS_AB_TRACKING_LOG_PATH_NAME_W = PROP_TAG(PT_UNICODE, 33094)
-PR_EMS_AB_TRANS_RETRY_MINS = PROP_TAG(PT_LONG, 33095)
-PR_EMS_AB_TRANS_TIMEOUT_MINS = PROP_TAG(PT_LONG, 33096)
-PR_EMS_AB_TRANSFER_RETRY_INTERVAL = PROP_TAG(PT_LONG, 33097)
-PR_EMS_AB_TRANSFER_TIMEOUT_NON_URGENT = PROP_TAG(PT_LONG, 33098)
-PR_EMS_AB_TRANSFER_TIMEOUT_NORMAL = PROP_TAG(PT_LONG, 33099)
-PR_EMS_AB_TRANSFER_TIMEOUT_URGENT = PROP_TAG(PT_LONG, 33100)
-PR_EMS_AB_TRANSLATION_TABLE_USED = PROP_TAG(PT_LONG, 33101)
-PR_EMS_AB_TRANSPORT_EXPEDITED_DATA = PROP_TAG(PT_BOOLEAN, 33102)
-PR_EMS_AB_TRUST_LEVEL = PROP_TAG(PT_LONG, 33103)
-PR_EMS_AB_TURN_REQUEST_THRESHOLD = PROP_TAG(PT_LONG, 33104)
-PR_EMS_AB_TWO_WAY_ALTERNATE_FACILITY = PROP_TAG(PT_BOOLEAN, 33105)
-PR_EMS_AB_UNAUTH_ORIG_BL = PROP_TAG(PT_MV_TSTRING, 33106)
-PR_EMS_AB_UNAUTH_ORIG_BL_A = PROP_TAG(PT_MV_STRING8, 33106)
-PR_EMS_AB_UNAUTH_ORIG_BL_W = PROP_TAG(PT_MV_UNICODE, 33106)
-PR_EMS_AB_UNAUTH_ORIG_BL_O = PROP_TAG(PT_OBJECT, 33106)
-PR_EMS_AB_UNAUTH_ORIG_BL_T = PROP_TAG(PT_MV_TSTRING, 33106)
-PR_EMS_AB_USE_SERVER_VALUES = PROP_TAG(PT_BOOLEAN, 33150)
-PR_EMS_AB_USER_PASSWORD = PROP_TAG(PT_MV_BINARY, 33107)
-PR_EMS_AB_USN_CHANGED = PROP_TAG(PT_LONG, 32809)
-PR_EMS_AB_USN_CREATED = PROP_TAG(PT_LONG, 33108)
-PR_EMS_AB_USN_DSA_LAST_OBJ_REMOVED = PROP_TAG(PT_LONG, 33109)
-PR_EMS_AB_USN_INTERSITE = PROP_TAG(PT_LONG, 33146)
-PR_EMS_AB_USN_LAST_OBJ_REM = PROP_TAG(PT_LONG, 33110)
-PR_EMS_AB_USN_SOURCE = PROP_TAG(PT_LONG, 33111)
-PR_EMS_AB_WWW_HOME_PAGE = PROP_TAG(PT_TSTRING, 33141)
-PR_EMS_AB_WWW_HOME_PAGE_A = PROP_TAG(PT_STRING8, 33141)
-PR_EMS_AB_WWW_HOME_PAGE_W = PROP_TAG(PT_UNICODE, 33141)
-PR_EMS_AB_X121_ADDRESS = PROP_TAG(PT_MV_TSTRING, 33112)
-PR_EMS_AB_X121_ADDRESS_A = PROP_TAG(PT_MV_STRING8, 33112)
-PR_EMS_AB_X121_ADDRESS_W = PROP_TAG(PT_MV_UNICODE, 33112)
-PR_EMS_AB_X25_CALL_USER_DATA_INCOMING = PROP_TAG(PT_BINARY, 33113)
-PR_EMS_AB_X25_CALL_USER_DATA_OUTGOING = PROP_TAG(PT_BINARY, 33114)
-PR_EMS_AB_X25_FACILITIES_DATA_INCOMING = PROP_TAG(PT_BINARY, 33115)
-PR_EMS_AB_X25_FACILITIES_DATA_OUTGOING = PROP_TAG(PT_BINARY, 33116)
-PR_EMS_AB_X25_LEASED_LINE_PORT = PROP_TAG(PT_BINARY, 33117)
-PR_EMS_AB_X25_LEASED_OR_SWITCHED = PROP_TAG(PT_BOOLEAN, 33118)
-PR_EMS_AB_X25_REMOTE_MTA_PHONE = PROP_TAG(PT_TSTRING, 33119)
-PR_EMS_AB_X25_REMOTE_MTA_PHONE_A = PROP_TAG(PT_STRING8, 33119)
-PR_EMS_AB_X25_REMOTE_MTA_PHONE_W = PROP_TAG(PT_UNICODE, 33119)
-PR_EMS_AB_X400_ATTACHMENT_TYPE = PROP_TAG(PT_BINARY, 33120)
-PR_EMS_AB_X400_SELECTOR_SYNTAX = PROP_TAG(PT_LONG, 33121)
-PR_EMS_AB_X500_ACCESS_CONTROL_LIST = PROP_TAG(PT_BINARY, 33122)
-PR_EMS_AB_XMIT_TIMEOUT_NON_URGENT = PROP_TAG(PT_LONG, 33123)
-PR_EMS_AB_XMIT_TIMEOUT_NORMAL = PROP_TAG(PT_LONG, 33124)
-PR_EMS_AB_XMIT_TIMEOUT_URGENT = PROP_TAG(PT_LONG, 33125)
diff --git a/lib/win32comext/mapi/exchange.pyd b/lib/win32comext/mapi/exchange.pyd
deleted file mode 100644
index 15272f147ef540f56f00f2513f85b422eaacb768..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 88064
zcmd?ScYGAp`aixQ83>TDs4RrOV$dLpNI-)S-IWA3l3=7LiZlfTLBy~D#0G2vEaNJ6
zvG-o^iU`;e0wf?<P^ni03vP^sqSUMNd%vGEGdmjsdhh4^-w$4yojG&PbKXxq&pFcy
zu3G3ybh%tf_%jTbYZ-p|&nMdxZ;}&St|skQG;u9yxZ%`g3HcjN9Xx)*RPU6c8?P%G
zeS`Pf(UT|N81!B<)>~9O**jsfH|Nqp-WzTlGqy`=YNK?MbhGa^wkVwQevb8b<&kr8
zhT^#1!4Gl=%kT1Bzx*!CRplS$4#M$$=J}lJWw`@!ysqX0`OT^RAomI!7tZ-0XQR}6
zM~?41_<rtXa{QtE4xDi9c=l;=SeWZ_jhS2D)qP*PF;>|gR|jw7dQIB8R-t5}D!qRt
zew)hvEU>Tk>$zO@r6~66T8y(vs<57G6b@7)>*v^Gv&5g^DnzqF{3fx3g$b^~R1kXW
z>Q?k*`&5GKG3<;=!+A$>?cFk*&k~^KnVl}z6cbnNx;*X@96KY3-(M@RA!PDitG*ZA
zb}1S&Iyl<pDk{eLo%oxEzbgDW{`p`=T~syKlv8kmVj!&xoq)vF%DPNZ6@^FeDt%vk
zOg&$hqNzpKf`rHfvJrX%>#8?)(v7G{8Mz=U7j)#h{Fr(d^Ys6p{{=!nXXWeKhA&*M
zKt#I>q6ma@(lY`P&&+S7=+VLimw&mJCnBkL4NZ{qUc)n0TBP0yI|+nVWmUiWhRd~n
z{d$w$ZHnF#kh(>$)%QYAchcK&rA_ZNMK9l?H_W6LzB)bm3Q+Y1^sNFTy7grc(hret
zRzUwEpjR25uQm$t)4yYX4Zz9wSCDeQrUAV&pkJNd6&SrEE7q^~4KisNo~KotedIHo
zh&GF*O&_$WVD(|BzCIA^KcZEls=h4{P6+6S4bKF$KTwenOkE+;(LarT^g5BTH}tAH
z3>Y16Mm<nc|Ip2B=`aCj&TyVF&+DrK;i1Wa@RX+HdQ|52fW8kUUi?*sho*&x?!;cy
z@SH~UkV0vhy97QC?Uba?qL%be@+0}_K8nYiAEAsQo@qM~-91x2bGcZ(TB_yq%>C)}
zagdw2HaD}(@bm*sR=C%!;LC~hNx;cKWN>;{!;>MWgVPO9J5b8e?@XV?is-E{U(X@e
zTLOB6fUbxJ!uhnL{PY0#yaD}FqcAO?f2<!eJimU5j*Od6$&Y9gK{RtCPI~;GyIeIb
zazH5nQ``Oxc^RBuXn0;iZJ~{hqWT~n+$p#XPXuiOdOp$3k=+W)e@Z|Prq6%|MvYX*
znPrX=OBM3#(641*H@`@l@%B{=hM~IKci~6uEB){7%dgs8B5i12dk}vD;S<<bdsL0t
zS3|Uqx37_}5?O8gYKeL_Pv~arPJ*O;RYGv~8MPBo_BG`4EBu%HX<>!5up_XkWnx`r
zv@^rA8ZGlp>ly(k&X3%gzL3h+Kc!7|g-z{)f(%caPn5~@L?u%Z4XNC+;x++2^#IPI
z>NldxhKA>_4K7!86Vii%y5{Mh7@qr3MNjRR57Fq+o~gaBN^ljYpy@;kxO8oCMs({$
zlCA=sC-<_;Q`h4-tnC|?;L^39`zN@<T79$%^lbYLirgg+(;IZ{Od$Yko{!^5$_+s8
zO58w`e;9k^yAlo0o2U<aFP(@QrN0C(b+>ovUjUW9-|&0~sFr`df(H3|i8KsEQl{la
znpFW&^tYQ(Cv;ANzNfe$?c1{hjY<y$CmI#KzAjo4(BGFPuy;T%&|Bo|mGl}V$SnZ~
z(x-nV@i9;Tl!sa3wSHrukB+hjdO*X{1McvBL=e#~glOR`5L+{dt@?hH(ig~3w5Sjz
z|H7WGZN4PI)l-|mV68tUXDL!GjrIr4WJKp)&xRCf`eBOnlXW-_Yi@{4*A}65SnJHz
zq3oj^GlL`0dfO0b9UKT~hUa^f*Yu;aB8sGT`8VkePWKs}qaSmZ0Z88x-Ek=oK8<dY
z--?>FWtz`53yc&4J{W<e^@qslo{y!^0(SUpp?{=*#K;lD8GSjPbV?|009y`05-1XX
z4TOW~5+1z)eJ`vxkA!B5!nTmXQxLXHKM4Y#MB;n|b$v6Uqv7$<fI^)U^g~n|m^p(5
z^eYY)b_>-%<A1Eb6@Mh6Y9v+5OMuwE5nlI53}$X4L(xVlRDl`B=~|9I)cuad5zqZ!
zv)ZTmdYR!_hN9(g2Ao~3&OYck`v}i6TQWQ^s<R6nXK&@%WH}pFXBRlmj^Np*a(1FR
zd#B^9PZjOjCakQ$fNXdsp^UDu2#vtsYMis=LXieL05RZ?Rb&j$e`qm~p((*1co^|K
zNIQt6Hb6pVcv=d{;!99)JIW2u7WRuVB1Y~!i`?t+<R0XqzNWSg<yggXQ>&IeOiFJ`
zC8aT<b=9>^{gAZiTYGA$u;M(#F^r*lwK%~kgDfYQeH}ZY6SV(@@YYu1IINv4PH;ac
zgtbo?Lqgeqi4&X&C-@4S5r4Y?EPqsv{xMuyd^VtO3g{aQ&zJNIP0XBVeF1$EhBFvd
zA<VEVhNIBW8M<~JsQ1+71Ds&GLs5le{xZ(O^ytsT)I(vKhCE5vT!Lw!a?EQ`<O;R`
zCclZPF?z^=r{v)bcg2BX<D0IP^~DK&TTgBCV30d3T_@RH7uj8BN!KgZh&XgGq-&*U
z8rGgfJBVYth@%6#UUQieM|0$1h+r}_(c6Gx5GqN5l7-5Kj`3ez>kP_y`j(#B8p>Kf
zqVE-4lN4o$WZPIvB+F_jk`4-2BJ`+hzvL2^uGI7!cyR@(rY<I~cFODZPZTuUw}G#M
zj1#b_t9Z8;-<S9k@Bg}X3wjj1D`+Q25P$^l`|u(d2JoI~<Mj&OqSYeDThO1bWeeUr
z6yED>ytk{?LE@Dlbu8Xq{{>#jmv!y49I^;~w}3cIeK)gl&KYCLb>UBx>$+8f^Qg%6
z0W=M3->`Bh`$rVHg4Fk>ONGl|9r~`IU&Z8U>09O7x|SnY;F0}6QzW)P(SpPdU27p}
zCrEq>$yTD)8Viz>6q3~_as^uhNxq51jR4L7KMX2;31@9<lkDBLw_5RGX&*B_JPx{u
z53%s@`vBn(sIIY5J&c6e@VrtX@)?8{x>gJVVQr*BbrF7C!A?N6RJ9JatsNfB=+GQB
zPZS+Yyr%w|q7%{IIqb(&;2;}d`8Af<8VJCK3Sf~K+LxF+hqVKgQYd?b7}{w7=rI8z
zZeZdR@3B4OElg?9(q9SaVFuPyBNox$x&oAl#b?<-?ut@UvsQ|vK1WSm>n}hKD<B`B
zNa^oR)jH_Z-%~hSTYpynNg%`SUjqZueSf?A<)bY*oFm;QsO}#@1zlT@b(F9+jckXq
z=c33JYy~-_n%y^vS<m$-s@*&EA@O=Hs32ZjeSgYqRanoq`>yzrte2Jx>vxG0aSbP|
z4OD&46enW5zDKnVTJd@`Jtr<+$MOx>KZr=YX+=7*fYaZ`uzZxo|D}Q<L1Eyy4*q?_
zu!HP|vR@GKcP9TPhW2(^bZo@A8MPfAZ3j=4n3)mMIlhcSUut}TBU<+QEOH<vtCMV;
zAMK{Bt}GK-eG4eMmM%D-V8c-MCn$0SX|H2dYmRfr*z3#Wp?1Wv?B&agl)Y>LMX{IG
zHjeN}TV8_W^N$3_BdDNjkD*;ydq&}yiy~z&Un3_57eS}J;A9>4QhU7U4}yM<Zx0Gw
zd%(~YMFg6|BP=|df1q6a3eQHkjIN~!o~zh4l>H%!TtVuuz{Jx&$4YCD)!#kzxtM(Z
zUVl$vT~72jQcO)H2;U*oRr<Tk#@SDBF8Wa9_Ag-5wJ~TL)=pQp{sfAY{+?H@>(t-P
zA`pzg$mp!$!pi5Y{2ulX!eak#P#(7U@@-fvhFjt*`<~*fr(k`73Ru_5CakHHL@4_s
z6e)E!F<~{a##_VlEQ=_u_!)pX->5ZyOaocTFJFfd#OIf92P}D=Y6Cl8fKB*7<h4@l
zth)f4jC}xm13xNpDORnIpI?@s>WM~>I`9@EPwP#X2%j%QLGgGKZM-*KZ3*(p?<mOS
z?+f0mU~0Nn0t#X6dZpjKC~^g_haIj)N=m=L1hFLjCCnZ25m2%66kuMAqNh;A)EGrR
z<i{xCTve^ym8gj@4!WXzzADdPt6A8WtlIGW8)|XzJBs=Ac&ca$Y^HEzh2`(x_oDj1
z;j`dJ9R5rN4G#A3FpIGr-;%MN?+If!p{B0AiiTnB21+56Jsdx3eEONWG8l7?Pd=Qj
z?eS`S7zZLfwJFezbp57kjIP_-T~C#+$EvPR2Uoh*Rl2@F*}%ytQu+K%X4lsEa9FT8
z^Z7uymObviz_iDg!L;A~u5-fE!3MMNDoYLrc2N#nR)`!<LK|Is79_&j1PU#b{U_R}
zK=VBkR?4Bh`&~8R$#K71ISxAWS~H%Fs9RHyv$8s-JC5~JUGt#}rlVEl*i2_i6n%(l
z-<1}+DT3|-g-#cAnxMN|iE28El&Jce=o-uDV0cClzBsWJP%Qgc)stsn9}_JlHL`o2
zVfWlbdM;Zoa@i_M($O%i^-w*p79}zNT+e*AmVLa0vyzKCM#wt+(TDjTh(b+(vlFfq
z?~p}`G9<Eds3noRc2Zv%3fCf$$o?$idYa=vD7#c7av^YaH*s}yzpMNR`udpq>I#pf
z4rf4bJcgrfz#Mi8RcUx~O~Dn?zlPGkMu8I_=BsKvt7UJ~(7D8uAz(Qk{@YAiB{w?N
zhX3O?gg;@Kh;^pKlkNh)xkxN~oWzsvfX}>|Vg<UK^zmje$&g?I^HU~gMuu)^<cJKu
z+B0pHpwxjM@o?$+CjO2f5|4jB6J5bS`U*?@=L`Oq-xd6gMEpTe2y43){sZDJ!-4-D
z)jD{Y75q#Vd}cgk^fTjOmWqd545WIF9|9NA!D34akV1S2wCAeavF!cJ^S}n}y+0%>
zL8+C^*!;^a#wPEeVm@0cjCBGty7nj<hBXiM5X$zTNX5f{BMq%>?}reW)YxrKw$Q)G
z+nm1?3I;g*QFd)Q{C$cL%sat`aS+Quh9^(K7%1{>CNNgAVJQ1TF>mIBLrfTT<%2Cv
z8$LFlF!7Z2APnI7NNTG5Ceg-o(-2E6(*@7+cSJ061WyUthPAnD7|NcEAC=#%X37hD
ztqV_{^ip?zQ_G)D2X)CO@*sEEqrT5vts1N7Lt0<pDz93ts+PsH)(YKoh+?|7yF1aP
zD5Wh#kt>KiMmxhqmriHGVin!q@+EzfzQOdQQD|`d2p(r%R(@6s|2Xt7_=m$*o%o+e
z`l`I?6dS)^@DE!e(rp9Gx^}wY_o6YRn~Wlb|2ow=_&4~sz)Bnr;;TCnC_d_l2Z+Zn
zWSaP&hc!6y|G<=3qQM}!?!?u?r?=BuAAMW!-!JkXhxTD@JWVN-Jxk<&3FQBxY8^yi
zRtXMtK$+u;t7J#B;QJ~$>MFr_1{K7}H^tP<dDKkI^^b|p@&2~6n;KsS6Nl+;={5uR
z4zvu&B@ArCwE`@6?neb(dmc^0T5H9?Hz-o;J-d;m(!84=JNtT%gk^St%3xbvUXAyE
z5LNz0JGA^?k);3IfaYxz|5t#HK<T>HOaRSg!%+5a6e)ijVgjnm-^yt%L{!IoqL#fb
zJ(p@mbo>)-{IWi5I^6HbbCtrcxy+K+p{<1X%3C6@XCWhuQy>u5K4Ood?7LCq3T8s#
zOI7RO8F9l`4z;a@FWcv?MjMA_eaEv|XFPSGQ--e@4sqt#c>jg#KPo_s61+zi3*JF+
z4&>=wiT5HU&Wli_^jqJ=TZevIGxXM$rfF}-<e%d}UgVhv{lt%_&oVI=4?4*PxOoc&
zdZhw55JJTKUjR0udJ*qY<O+6!K*y@q!PDae3imPPi7^yD<25{-C;wx4#^d+G|Iab;
zw}e0xe$yVlN8+jA50q<I3;-Dd|B*LEz7xfN#)3dt+fKBh>?_27+5`Rzs&()bqyggd
z2)c$R3+EkJ5veEPDiv}rpY29=(5)k00q=n>CSDC}$ICm@2K@8@%OD=wOnFzoA%O3N
z5$M_yPzY;l=)|Gy+fn2SdI9(krpa*lW;S3*7<n}+{4>N>{xKNzCI8qDiAw(Qh$0Qg
zPqu+I5nzQ1*jkZfYXSBF4KtMej!2UE_SGgZ=X~s8oUJqeaIT+yd^SBC>o4DuLTmw{
zu?^?u0!vPJZ=#&aUl%!bgDvXXooF7`USQ==b~_ZQY0(Cxuawh?)?fCL2h)S<UVO3g
zB`4n2=up->o<W~6xL2zVA-#3^7TiN$5$?$fZfo?WYhRy5xYsGT4N#<(7226_PjG!f
zZ1-5S&iFG6#3i2Vv~x3_S0E8q4sxyyY`Oru`8APa2UN!TzW^Jk9Ha?;R6H+Lt?SI6
zs%go!BT(J`u)DMA54VBQcz-y}#&=JDOK`t^Nx^M>Rq*|UZglNAPzY-mQcj`lO(;_S
z@B>rWWBp+%D*Q8lr~@yqPo8Jt{SzvR$2(Q^2u1I@#KL>2;O(UF4ivn<pGmwQ(!>xi
z1urjr^)T_O>yxGvGeTOk^=9$NeYM9Or@j}W4~{qgVUH?X{)#EIMDsp2y7Dh5P5l*-
zW*b3wxu9ExeV|Lmk1Kd8&^@GD2R+AJE&PENi#!&IfT-LKgibszP!;>TgE}=4^|2AX
zm1oK8B0+TcWkIwNI@PsRohYxqY>0JK6e;`DOhk3%6N_jJx;F3_Om=Xt%YTQVqda|2
zPi>lj+-Bi?6e+HfTtge@lN%|y%M{KPBDpq#^8$sF!-tAD!&U1b*6VRqJhl{W#}!=u
zx|!nEwP!H;D;e4+Yp+L`^P$BVYybtHFVa^U-j7sP;T#>X<Y|0PoG)X24+-No!5Ku`
zu=bbomo<Wu^RstU>pK1UX@#$zjnB#%kCCT!{ma5P9pW(6J=lh~vY!QSyufRu;58O?
ze{}}oU8KZ#5I-v4X>P)+<ND<ntc!JQjO|Vfw8pa%5R~!k7SNaRY#p;(afK`!$?nf6
zs97(Hpmw1Gu73%VTqURtC^D~qsn&7pi;G#NYr8Ng(*9*qZS|jI_5YsL|0Rk70>!ev
zmLw)i|1Q;kPuPsEeSA74QL6gyh$7X0N*(<t<Lok2i1i*@PbdKy;r~ZO7{x!bQImhW
z|Gz#J{$CLO8=_C}Fa5v8xD?9%Lo~th{7%(6j{hw<Tf6@_{|71eyRg^RqAO*ueQX$S
z<yvBxCom2_FECc1YxsXhis4%Y;|2Vf{%^u);eI#fRJ2R@(`;6*bNn&wa|&n*o`*zn
z3eVd}WR+M>wed6%JQEb2dZL!@f@cI9hO&Q!St>lms&%j~JZovZC&IHcofROTPtk=H
zcTThM+>>L==M$=F>vJNX>wy8|AKHes2iY)`eL0F0o*$6cf}1-1`CQ?;)_lvd*TI4X
zGpt0QR{5VI#r)3((nNq1Dj>5Fi*>EF0HLD*$PFk`_IkAm#F_sU;_Tn&f2T1XBmdh+
zKJDvADK?s!eJrue-$1dfd{)HL85MLbg4SW}U4^Cvic~)J3A0;><plXujU>R3j=Ew{
zS1e}SbK18TovHDSR%r&jYgJbe+vgWsK!00Lpe+^9bprJJ4g}hl4MW*W1t{ZjM-ymW
z<J&!`CH7=r)4&bVPCN@iljg*^nFZ%dq^HWfFSg-K5jYE;5xJd0F>6BvP7QkqWg9@H
z;_rj1bzSQT+lA*^)@08&W7h+Zo@(av2Vht+efG9-z2djT6#bZD+V`~J>V*or_5oUl
zwfE>rq3knIr1be0Gh6Btms5{(|IJZJeic54GA(-_1Huv?D=d3|MbU)f(riTI1kosk
z=v?Rq_df}uh(gpBMateMnTVYB?xHfSfx#R!t^U9Fn*HyG{KenSwEKV9XG!G1I!a{c
zQzDUukT|Y?p<!72Kw0=7(6s9RXJn|9h_nAKw1Zmxi@iAKFT+4j{B4^E%(|cJF+~s3
zXk??AA!r6FG;fPE+6tN{*)){>q)3Bl?FbXi3GU~bO5rd%{sVt=;(fKfiMJaqC}vPK
zOg3eBzw#nWe4E!&d`~|q;+rXcHwn#gpN#@MPW+D7=U-Q?nXgr-+fD^r?AkKMm!9$d
z=P)WqLS)L<xqjut{J)*KUU@EPVEz!hf2q3-`<V+Z*j)woPfrN!J_7q45Ww1>7*zH-
z0^0}J2atVI>$ntCl0M7DoBU<Lk{6G-0y9IcR`S{r53Oa&-$2JP9jarQ(&ngceohA*
zSwCu7o1ZZX5$tATw#CnsDypHC;^!1FtZP5CB|qC0KL*;kg5>A)+WeT8WB!JpkI?LY
z=Lhq<%K=B-9{@^m`njJut(a9ko1ev%<mZydML#t#CETYa{M<<Rq3q2lQtOMCtJdcF
zqNyCml0NmK*2A7d8wU#zM*MxKmO|>#2k<}G#?;3T3cut2*)N!g3IqP$mO_j*WFY*Q
zFwhMcb!{*xVBJJ9&<;f|8kP2dYW+{H@BM_Tf6qbP_&2pS@js8iq1Jcp`+sfxvwK<i
zuMqre9~Jy3%Rq5ID1^0fj61mhR}?_}Uoj1agT!B-bS&`3G_dX;X`l}L@bBj6UF@e5
zBp1IvFi0VQLzG`&;eT^A<=;@@zW|tZ?aNlgPZ<LL=_qmq{lM=r@%O01!E0X~c6#^^
z@G^%oj_=`h^V1h-gr8rIv8NCcVP#Kyds_Vbwu=1pd_?r|tvGm+@biYUr%zDi3Jw52
zxvF*W;uBn9F|W5`nRSD(XkPt}g|AuvlsPz!$zLoVnb?vVLVkG_s5r)tSD65dpR~03
zI!E{#y-4`F7Zr5vEHn>m?bsIUuqaaV{To#46OJF3vCiL(cvgO}DvgzqkI#ceNq*2s
zbpb<~k!1<~g$fG3>|p_T6DsJMj)r0FGPDA~;V4r1!FuMZwekZW&i-va-V5|ZUahD)
z`+o0R6+NK&>3j=KhM?)D(7X)<y7p%aqWOl<ksqK)<!=|7Xik(Lkb}RImaSjsc<a@*
zx#(8Lrv%%6&FcfJkmxEkce8QNUr8y>d`P4?RdDAD?h0ZEWselxygo2jwXSu2z=!h=
zXZvrj4<LSTYHs3XyjAhT#M{iqJLf!0&U?y<cin@6_f=FtoCblgc7+Nb51~li-@J)g
zF0`)hZ;oGH<aL6{sOdoNJ9gAL#(z2sRQS&;l0jSf;w04*>|t9E3+E`o*+JnvO>q9=
zA<i3FIh5@doXi)ym^e>h58p|5|1@8$We?NPt=Pi{Fyc7*E@2)nZr{Piy{wG#z5W4_
zFUL=;(+ci8=mNMe5k;;b?O~c~UCSPx!g+^O{|9?m)6B#>T(a{+7|%_6NV4%3b+_c4
zCU{reukgaP@cah|gthjp47?~(_OJ%o?}_Z;LDY00|0nj)TA;!nE`);Y@Gx9;1atT}
z(}FqsBZ~DD1v7`WwH>DrW)f8!%I=CE1+%>cQ*QUH>uC^;P0Y2GxJ0~;@yrW7p&zCH
z+VWh2OxD!D4K(_p=>I;EXMX|OLxA3)<axdT75%H$we+8c^A0Kgz5dPhsn1S^OfY}H
z6@FpO-<#R^=5(_JIaKhiyI1hNCsF?aG!1Kg*f5m+qC|ap{sU<#^<BsH;t*r9#8*fi
zt<3uYtnnuY1l9Z)%*gn&K+%Fq51nfv+3^7-<x@!RK?U6ZD@Y<}1thnjNR2=FCKBiT
zbQH=?w0>B2l9I=Gwl$Ymk`x`FD6&zE7ZfY*5qapa9oRpbhP8888P7kVNUdkAL6&<Q
zc?_b>9bX>Zi3P*)W0p8>QKSH*x~nCQ-`=M<&Q(CJmw@-5rUWuhiQ{q!c&!jPvP~e4
z`_nJL$=cG0t>-QQ9nlBZA4DHVkaH@_9d84;T>vazD3Ta00B#Wge<;f>5CB}yeP6YX
zTQBHZ2Lj6;x?BDC0dnborrm$^97_Q8rT?y~|C`aLt{rt#0IB3Rlsy(j${u>x(SHDE
zYfHfDe+kG4|KCBUihpF7CjWN-557kQEWTU#Uxb=?{!99QU0FgYepLVOtJZP+)6Q!5
zf9&`NdTPA{EX9@|CfR7Vb+M$8CTKb+G>@{n_Dd5=<4GlrdH7NJP!|);3DzfvvCTiu
zhhq8eE$C73zCi%?dg}YgW0myIwDC?^LFpCUCDQ9Jev~bErz*VXiyv{kzFoCG(RylQ
z+n+Q%LL6I2aa`NtoL1y(#lKXthyd7teXHg9W;V__XIpaJxtuuHMFeLr7!vXyG!1K?
zGFW1r5Jk%0H>C-ebv^%<NCS+?(~5siJU$Cg1=M5W;kz4@-1ePi;TbP@E>L)06|2((
zk509QvL6zwV?6GAd^}T8>2L5XPGJ?urxHRj@%)ZNRpGhD#<OP`<@3s&BA=-upJFr(
zYj;za$Y*W&ELE-Rk`Lut2Oi5G(*+9x;>VyV{&>BOWJ_mDGPes7uR^j56?CnpF_Ao=
zkZeGa^2f7GB+l_+G0JNDqt*X&AS3ah59B8O|AfR;Nn)toe{<>oDP1J-vPfd0^q)#;
zhq50KNiZJ1rdr3vgBdt`y#CXz{zGV}__zDta;C-q3-3}BUe&)JeS-f+<iCKGL)mAe
z$mG9{{+r@#?f#F6M~{M@+%L0+5{x<cc4Vwd9C<dJGX%~(3q%}8&?D~C5jYFj7WeI;
zNX=&-SFKNYzszz%j(JdA8fGn59XtQ7X=viTgw7Ge+u6pusFNkWyO&aYyTXEZ9ef9R
zLi4cJL^;+{6e+yFAPWVzC&U{@?SG25*8Jf-^eXvdHad=9pPH(AMjo&$!@~XBJH*{d
z;pRB0YriKG_g~8F$BEf_VRk)C+`NBFR;AQa>3vb*pJkAyJvi}VJ~<b?srfH>j$6-M
zg+x}FMK>GnP=PyhzKFRG^ni65fm@->;v5vI#C)!5ee8S^>&%=_)<;bTZr?wcPi}8u
zj!!co+L$@Cv2iXq!xC%N5{h->Ji+;%n8V{}jr#_aIlL(5!0~AZvsakI3C7b~{)sij
z@~`gbNaD>w$VB{ors@NVkDhKJJWmjIRR~XlvXTGPC&F?i$v*`l<4tc9p)=m?B&52p
z*Esb%3im03sOWb#1RlTM_#F~erQpkKSns|~!7Z9Af?FX99wV?W#y<T11^l>z(*f&w
z)jBwl>vNb^TF-~!g+Y}lK{$mJHety+0DYriF$!=5MXSfj<ZfvmJjI$ggUOHi9u^#6
z6*l$|nb+{pupH(xh2}CNpf5?E#nvHt9ni7Qvv|S3X7cZW7;Ev*L{%pAmvtmq-T+$p
zFX6wGkhE{n1ow@ALRi~GcJcfwiq!pM&#Tt8@27kN6&yfMFrzyrJ|9gYLd=hkNCs^u
zV7+XdFQ;2L&lj9~O9W>TJOFt*n&ZAPR>pJTC{pq6Po~3+cPF@BbuL}#@8YvHo(@Jo
zoZoB#VKMJVRSz)lhBm%8-=Z8ZQ~2&h1zl?+_?}^9tcT)9J+L`kwRS##dku>0E7$e|
zD0Rdy=yy$`so&>eA#w35Nf8FDqSGv~WeBVlArad!RKWZX1aM!aGVgvUQtLHqkj_$U
z=KZ~9)XKp5f2Q3!*BeJ+{U6=QdbtLJinqr>s!ISa?_dGG8*YR3e+76BDq#J;9s#dW
zdY+6TSFjlV=rI9Lpy!mqE6i(1^hXw%4oOd|<&ik~66)gwZdG>pBlaIw<+Z)>FmhIh
z80zxII{C+V(;Vo9|F6M7E&iEAi$9j1YVrT%o5KGbQP@gU0RIW({|Uwa8z@rulY3Na
z^L}#21+?1tli!Mp4)6#_|IPKY%h9{w-wHDE`0rz)EBF&^{J*_H{CTql|109B%>@4=
zgd56!Q2dnl!w*rd{~rGsH2L50Kj<QCxbHi#mw5bNFi{o!ey=6}iv)jomf&9}_BR+5
z@ZJTQ8}3KJkBisLv<Fn{U>nL?tsldpyw=^RccJ2mQP<($u$SG2OUb(!1mf|YX5+o5
zy@mJ1*D3F<cL?5k5Gn3|0)?=4p2GVp+9-SZ0qHCqTs?nq0(*HMO-_tlrLcA2_u@LW
zg}+>~Z?4Z;*DJ482;lFZx3lmce2w^9D*UYwB6RKhzleVhD~Gb{qezWE9Zmer0Ns%f
z?uK7D(Ek1S<IEQz?`h~w?EAK3?E7t`w#q(EweemdcqiPh<c+@ZoT}ixP}%pd5>RO$
z#j3Tk4`4=Ea@xn5_{ds^SJok4;9c{li8peLeI(j=Z)$7F_uW@1-{rRn-i;6;o_`00
zur@&1$A>6V_OTjy?LV@QJJG};@j8$n*FJo@Rv*2KKYjo+i?{DS3IXintu_|^27>?a
zt%AQ5FysEm{}BJ}bOzW5id?~L$Xhe<pUapI|F!Zn-XH-NMe@Yt44QE~E4&s;bFfm#
z&^Xlb$gn+E<4)cBI1gyVe#&Jc<h1vxOpGPI>}qZC)9)4Pqm$xioA~SRN5$T$yioQU
z6sh>qL$yAh{XBt+4(N4gp>Di$(VO6HdyKtTAn{dr&$aQs_%iX{e2d6`CNSdp2f@1o
z{R8hf6e+x=s`c^kUWke(#%twU-ygxFgb3K9AOOj?I@`DwwX)>cUU2Q2DYyoL70iFp
zF07qNvEexa6sdgc7o@YaYsY$W2b`=un~2S4#(<8@XZBkFUQr}qm}xeErAQ$R&nN}p
zX&}V?Zvx;01t5YVwSF<l1mK*{Ou^Y>t}n~`d3GOm;r$CPNK1G>$L{*^mKN{*rRyJV
z7TzBeoh(MHu(pma5Xzn-I>CLC+Fqof<lTDz!UUX=Zuv&Fy6s~eD5?1qdXAsZKdY!g
z3@6!GHor(QT&b{}4A$}dn_#(^z;VBch=KQ;j5V>q10B!9*L}YU8lBiyj^mF$%zqA<
z_-_Lk;ExSI-y;)M<~=aY5@lC`|HupxWoIA+P7uJnS!uBaid=l?ReM3T=A(S^;RPHp
zyx7sjd9TS<G;%QVzr>eK2Tgvi1R@nLt?S=5KXY1G{LFfR>R2~j_}LE?AWs1SJP)h*
z`36Pi^>5^*G>zk3|6Yok4(P{^FR}IX&H@$lxqE4c_65&LswbGuw&oVjJ<k(o2Zb{e
zj9~r$0C8TSOt?LY%=Ld0=LxQV?`M_2o6Xf}?_P}m=vM6gbErCgJbD|6t1_5VZQz#*
z@CnmIz;hr}jQ;}sUYa+ar$>>>SBh2Z+VkZBsNj(63Gx*y9)9@;rG|j`HoB0Y(8>lj
z-(yL1({q&QXT<_64-&!q5702I-KK!`K#__^|3*Gb%{${!8qU^^M^^uXt^S_{bm{*Q
zMFAR3w)>wf{THhK4@>{8rT-hy3WE8;?*HmK`md^^|2pDRA@ZN!&GBpNG5SihVcpcs
z5{vOH#j-poV(B0bQ348K?GYuGCgKny;oz&0xKb>GtT~~XBLDsSF4zDogtDlE=%&Jh
zdGq3%=*FS$QOq#LGs7@n`s2tj>fm=2?tj^D+Gi@19&ewgD8x|1>{Bd$&li5zP8EJv
zh-2Lk3V8n~g@g4hI+nWx>lCml?Q^8A<aq`_SE-Z<Inq#b23;nV<c&v&T)0ivoK&Mq
zfCpURBAY%QU`&#OEbKppeU!ttkH5gx4nQ1&nNr6BmqRwkiT9At(tW0U)`FLK`Rqrk
zsr+~J$=H+iu8W?bJ-l2*u-f%dj;;kkA*?N+DDb=piqv}FJF0bXBA6%xLzv=$r{k<H
z9A6wfLwU%GpD7Q}5j(-fU@7<F{kwlJjymka2mbe({7-;_<Hzg$NKH-tPr{z?Kk{ke
z|0Z^<bpwmw9~6)`Df?)LB3CdUw(*W?&6|&vc|!nXB1?vB)5z6L)KD~&>SNydun{C2
zI))LQAib_D9|3=x_L%&QhW*F$cZ$v5?4}lfFGALM|LqjvkNxY~{h$!mIxuG9c}Wy0
z{=PyQOWXfH@K^NzfWHI3nf!eKV)6WCDunRwr`;BRKR!wRs&5qjIv@bx`FBvjd<f0K
zUlSB5{{CPZ`+wtaC4A!ls=wwIe>cFg;`tk-5Q4w*CKi9^2!9O~f9udc*1vuwe_iN~
zSbss0;?MJc=kNOeD}NY|&I3A`PZdD&@$qLW5@F?kyHYLwZhV6J>ogh1@Hx@n@4t{g
zDh~WL$B!$>_b>HOtz++Ba*Ri298pu+EHgGQL`y5ma5%D}%q+7UQD%8O!=p|x8r7LE
z!5{kqt>jCiA%E~2%dbn2I4gGdrC?9O%}bAy-3x9YGVK<$z&u^pJ&oE6WnYIMm0$N&
zt&h#GWiX0+UIU@VeAibeH2=p2T1Wik`p?fMKeORL@%nok`K)5-RGXoLkCCAXlZ2sf
z;h@O>Kq0JMto-j26sg3uShY6af2bA+sUEMjLiil2I=~|i#jnfa`v+m@%f2hb#Bb)?
z_~gJAb&WXsg<%-^cuzf6AuIFcQx*Cq2J1?61~gDbGT!G;$VifX%Te241_IXHfpW})
z@h)$UulWF%#`fMp_@)Bh2AGA1zXK7u?z9aznMEhEA>P-Ar!+p{#g!QS&C<m!=%Tbt
z=qtimc=x@1Ib%I+dNfky7(e>wnQH^38}Z)td8z$yrY0?*uMEu7dSM^n0`A;(dkpQX
zpLn!3$T#PYzTVN^HwY+a|2(Q58Pl4uS|+|YQj%VX5<myMu8MtJS=ySpkst8z`IjZ*
zY;@Ex)Q;q&cSoh}ETLvH__Yyy4+0qtz9GVAos_!pTK&Znpy@4G%gKfDbqyV=SKPtB
zjH!YUg+>j}^QdA}Wi!8;);7{-W=*Tmp@d?57X;*1NL9YD|Hg?Rgy*R46qJF?_0f0w
zfXeJuWMkxrn6&EjKMb_h)O#fL$4Agg-)DIGqFeQGhhh)PpL~?|d9Ga;?177XMJSYy
zI=qE)|8jy^L)(xmWO8}>Gn{rW-C}r*@kkGs0$^QlK#WhwFh7|6^Q=UY))q$bqohAY
zN<`jZ5?v`lMSr=H-$^i)KnT(8X33rDWZtZ{28EVpl=>W+fo{=|IwJupNi-Dk>{%qm
zSxU}O*um@6M*z0d{-J^_v$8|SeBE}$a{w)cis7j++h9!qZBk3*48D5-hTuOq>5%jJ
zkU#PayD)eYXf+b0;Nuy2kfKx0krH8%AD{6B@cj{TVc0U)L8WAS@Eo3@BoJSOuIie$
zA~J=og#7?9dliK~tRl0lW;_1Av9tnhj87s+t=^CLF?|6gO6pxr(;qw3<x=)YYd1W9
zjH9H2V_ECYbf0KKe55xjA_m>|uvuSu2L+C=UfhjRtA2FlQ3M9FvEf+)f@0tV1JGak
z@H=}Iu>rI5%nHXDW$*a(!L8|OLjsZ4(ii>*L}&lZFMNTeb9R#$+`Dv?*w<lv>jn6I
zxCY)ebEC=Hf-6wzZ@fC<X+!ABv!SX@W66H;aLcbxv;6u2DoOf)o>9s2?RGWi(y?1O
z96J&bg?jF#+N^`u(MEkDqWF%?jaD#HNQG>4`{k^D;vf|9JpT}C*>KNLaL=^h2I_*_
z$^o|zKLMpjL~2k*zl$)Fi9D80vF7Q+((?3Mym|U}!z+%*(}&ci#naX?h|+JF2Im_x
z$bUICRd`4=wK$m!Yo*`gM>O?R0~Ty0i-FwC1B!{ta#+}`{BSTm;9uU-RnNuULV9P!
z^X&sP{_f}m8tD@#-CkV4#$72q3DS|sLJc$_jSTq`6HT&rK+h-rvdoQ!Ct2FgaEES9
z@0}1#&ePXaA3=YC$m7zGHA%5hbuEb4wf=?S`QTc1I|IYi)%e0iBqEV5yd-@K*rJ6=
zXbHccz7xlJ`hjTMA<DBNQ(z}%@M>t5VJtRF4i0ATz@Gy)y9;uH?jDGgvIBBfE0lGF
z5KtToWoHR6cPXwM2&uSGMnVLjf>|fD6{ZZ&fonvHGZ4t$yPslh3o?!XHVsuFFS`)W
zphY}+Y|pR%%tyHjV7~c5_3^Dyfye{WlM+oVe62@M2wzQT)T0c~>o^P`alp5J<ZDC$
z{Z?C^nHxn6$_euH9nmd=P#NOMBFAy#uq7d78RNl%Fed0aDBecG3A%GEwtaRmUaV@u
z^LS7x=ChfmeT&rX@CUd%C;^51=x8G6M_t^duR+)ftr<5#m)u8BHxc`Q*cXQwnS-c8
zA^!C~C*mm}4V%8wa@*4_w^fKq+3;M8N)}?gW2mC0n+2NZouE6#K=(x>f=2a3`Ob{8
zSbngHmI~JwH-ziw_rl@qRdiGTh+)I|zG-AnNvxxNwi7>&5d*<B^{jhcuB^5%AiE8?
zb3TryG9FVjvmlzRws)btxHx`jX*AFQ6GO`*qsVpe(qo2}U6+AqMC*Vagsr%tr8`Qk
z(Ik4^AI_oWN)RNQh-er@2_1X|FTgJnC>%P|C;8q%K>wU+Y8D{7GS@O>XBnRTBhdhw
z;D>kAr)4CfK@8<JI0M9<%(ci#-<BhldH#qtcIK)A;QZ7Ds1PfJG-oJj&iRJOBo{U1
zJ6;iXmv)0D17Q_^38yQ^G0)TY5FQhJNNupdV<uX<)?K<D$OSjg;saHlj;M?K!^}!q
zQt3rh%4&O*DR3k;h>4(RY}gUV4%0A8Y5K=mshd%!c$!k1&m1-f6*|=B!}py=h}v#Z
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
W5~M{_X_c+crZe0BUjMgi;C}(0&%et6

diff --git a/lib/win32comext/mapi/mapi.pyd b/lib/win32comext/mapi/mapi.pyd
deleted file mode 100644
index e372d4bf9b7a146fbb3e02f18cf668464f6e1a93..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 196608
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
YOL+Fq*_%)Ox9pWS=>Plgze5fDUk%P&T>t<8

diff --git a/lib/win32comext/mapi/mapitags.py b/lib/win32comext/mapi/mapitags.py
deleted file mode 100644
index e6e9667e..00000000
--- a/lib/win32comext/mapi/mapitags.py
+++ /dev/null
@@ -1,1025 +0,0 @@
-MV_FLAG = 4096  # Multi-value flag
-
-PT_UNSPECIFIED = 0
-PT_NULL = 1
-PT_I2 = 2
-PT_LONG = 3
-PT_R4 = 4
-PT_DOUBLE = 5
-PT_CURRENCY = 6
-PT_APPTIME = 7
-PT_ERROR = 10
-PT_BOOLEAN = 11
-PT_OBJECT = 13
-PT_I8 = 20
-PT_STRING8 = 30
-PT_UNICODE = 31
-PT_SYSTIME = 64
-PT_CLSID = 72
-PT_BINARY = 258
-
-PT_SHORT = PT_I2
-PT_I4 = PT_LONG
-PT_FLOAT = PT_R4
-PT_R8 = PT_DOUBLE
-PT_LONGLONG = PT_I8
-
-PT_MV_I2 = MV_FLAG | PT_I2
-PT_MV_LONG = MV_FLAG | PT_LONG
-PT_MV_R4 = MV_FLAG | PT_R4
-PT_MV_DOUBLE = MV_FLAG | PT_DOUBLE
-PT_MV_CURRENCY = MV_FLAG | PT_CURRENCY
-PT_MV_APPTIME = MV_FLAG | PT_APPTIME
-PT_MV_SYSTIME = MV_FLAG | PT_SYSTIME
-PT_MV_STRING8 = MV_FLAG | PT_STRING8
-PT_MV_BINARY = MV_FLAG | PT_BINARY
-PT_MV_UNICODE = MV_FLAG | PT_UNICODE
-PT_MV_CLSID = MV_FLAG | PT_CLSID
-PT_MV_I8 = MV_FLAG | PT_I8
-
-PT_MV_SHORT = PT_MV_I2
-PT_MV_I4 = PT_MV_LONG
-PT_MV_FLOAT = PT_MV_R4
-PT_MV_R8 = PT_MV_DOUBLE
-PT_MV_LONGLONG = PT_MV_I8
-
-PT_TSTRING = PT_UNICODE  # ???
-PT_MV_TSTRING = MV_FLAG | PT_UNICODE
-
-
-PROP_TYPE_MASK = 65535  # Mask for Property type
-
-
-def PROP_TYPE(ulPropTag):
-    return ulPropTag & PROP_TYPE_MASK
-
-
-def PROP_ID(ulPropTag):
-    return ulPropTag >> 16
-
-
-def PROP_TAG(ulPropType, ulPropID):
-    return (ulPropID << 16) | (ulPropType)
-
-
-PROP_ID_NULL = 0
-PROP_ID_INVALID = 65535
-PR_NULL = PROP_TAG(PT_NULL, PROP_ID_NULL)
-
-
-PR_ACKNOWLEDGEMENT_MODE = PROP_TAG(PT_LONG, 1)
-PR_ACKNOWLEDGEMENT_MODE = PROP_TAG(PT_LONG, 1)
-PR_ALTERNATE_RECIPIENT_ALLOWED = PROP_TAG(PT_BOOLEAN, 2)
-PR_AUTHORIZING_USERS = PROP_TAG(PT_BINARY, 3)
-PR_AUTO_FORWARD_COMMENT = PROP_TAG(PT_TSTRING, 4)
-PR_AUTO_FORWARD_COMMENT_W = PROP_TAG(PT_UNICODE, 4)
-PR_AUTO_FORWARD_COMMENT_W = PROP_TAG(PT_UNICODE, 4)
-PR_AUTO_FORWARD_COMMENT_A = PROP_TAG(PT_STRING8, 4)
-PR_AUTO_FORWARDED = PROP_TAG(PT_BOOLEAN, 5)
-PR_CONTENT_CONFIDENTIALITY_ALGORITHM_ID = PROP_TAG(PT_BINARY, 6)
-PR_CONTENT_CORRELATOR = PROP_TAG(PT_BINARY, 7)
-PR_CONTENT_IDENTIFIER = PROP_TAG(PT_TSTRING, 8)
-PR_CONTENT_IDENTIFIER_W = PROP_TAG(PT_UNICODE, 8)
-PR_CONTENT_IDENTIFIER_A = PROP_TAG(PT_STRING8, 8)
-PR_CONTENT_LENGTH = PROP_TAG(PT_LONG, 9)
-PR_CONTENT_RETURN_REQUESTED = PROP_TAG(PT_BOOLEAN, 10)
-PR_CONVERSATION_KEY = PROP_TAG(PT_BINARY, 11)
-PR_CONVERSION_EITS = PROP_TAG(PT_BINARY, 12)
-PR_CONVERSION_WITH_LOSS_PROHIBITED = PROP_TAG(PT_BOOLEAN, 13)
-PR_CONVERTED_EITS = PROP_TAG(PT_BINARY, 14)
-PR_DEFERRED_DELIVERY_TIME = PROP_TAG(PT_SYSTIME, 15)
-PR_DELIVER_TIME = PROP_TAG(PT_SYSTIME, 16)
-PR_DISCARD_REASON = PROP_TAG(PT_LONG, 17)
-PR_DISCLOSURE_OF_RECIPIENTS = PROP_TAG(PT_BOOLEAN, 18)
-PR_DL_EXPANSION_HISTORY = PROP_TAG(PT_BINARY, 19)
-PR_DL_EXPANSION_PROHIBITED = PROP_TAG(PT_BOOLEAN, 20)
-PR_EXPIRY_TIME = PROP_TAG(PT_SYSTIME, 21)
-PR_IMPLICIT_CONVERSION_PROHIBITED = PROP_TAG(PT_BOOLEAN, 22)
-PR_IMPORTANCE = PROP_TAG(PT_LONG, 23)
-PR_IPM_ID = PROP_TAG(PT_BINARY, 24)
-PR_LATEST_DELIVERY_TIME = PROP_TAG(PT_SYSTIME, 25)
-PR_MESSAGE_CLASS = PROP_TAG(PT_TSTRING, 26)
-PR_MESSAGE_CLASS_W = PROP_TAG(PT_UNICODE, 26)
-PR_MESSAGE_CLASS_A = PROP_TAG(PT_STRING8, 26)
-PR_MESSAGE_DELIVERY_ID = PROP_TAG(PT_BINARY, 27)
-PR_MESSAGE_SECURITY_LABEL = PROP_TAG(PT_BINARY, 30)
-PR_OBSOLETED_IPMS = PROP_TAG(PT_BINARY, 31)
-PR_ORIGINALLY_INTENDED_RECIPIENT_NAME = PROP_TAG(PT_BINARY, 32)
-PR_ORIGINAL_EITS = PROP_TAG(PT_BINARY, 33)
-PR_ORIGINATOR_CERTIFICATE = PROP_TAG(PT_BINARY, 34)
-PR_ORIGINATOR_DELIVERY_REPORT_REQUESTED = PROP_TAG(PT_BOOLEAN, 35)
-PR_ORIGINATOR_RETURN_ADDRESS = PROP_TAG(PT_BINARY, 36)
-PR_PARENT_KEY = PROP_TAG(PT_BINARY, 37)
-PR_PRIORITY = PROP_TAG(PT_LONG, 38)
-PR_ORIGIN_CHECK = PROP_TAG(PT_BINARY, 39)
-PR_PROOF_OF_SUBMISSION_REQUESTED = PROP_TAG(PT_BOOLEAN, 40)
-PR_READ_RECEIPT_REQUESTED = PROP_TAG(PT_BOOLEAN, 41)
-PR_RECEIPT_TIME = PROP_TAG(PT_SYSTIME, 42)
-PR_RECIPIENT_REASSIGNMENT_PROHIBITED = PROP_TAG(PT_BOOLEAN, 43)
-PR_REDIRECTION_HISTORY = PROP_TAG(PT_BINARY, 44)
-PR_RELATED_IPMS = PROP_TAG(PT_BINARY, 45)
-PR_ORIGINAL_SENSITIVITY = PROP_TAG(PT_LONG, 46)
-PR_LANGUAGES = PROP_TAG(PT_TSTRING, 47)
-PR_LANGUAGES_W = PROP_TAG(PT_UNICODE, 47)
-PR_LANGUAGES_A = PROP_TAG(PT_STRING8, 47)
-PR_REPLY_TIME = PROP_TAG(PT_SYSTIME, 48)
-PR_REPORT_TAG = PROP_TAG(PT_BINARY, 49)
-PR_REPORT_TIME = PROP_TAG(PT_SYSTIME, 50)
-PR_RETURNED_IPM = PROP_TAG(PT_BOOLEAN, 51)
-PR_SECURITY = PROP_TAG(PT_LONG, 52)
-PR_INCOMPLETE_COPY = PROP_TAG(PT_BOOLEAN, 53)
-PR_SENSITIVITY = PROP_TAG(PT_LONG, 54)
-PR_SUBJECT = PROP_TAG(PT_TSTRING, 55)
-PR_SUBJECT_W = PROP_TAG(PT_UNICODE, 55)
-PR_SUBJECT_A = PROP_TAG(PT_STRING8, 55)
-PR_SUBJECT_IPM = PROP_TAG(PT_BINARY, 56)
-PR_CLIENT_SUBMIT_TIME = PROP_TAG(PT_SYSTIME, 57)
-PR_REPORT_NAME = PROP_TAG(PT_TSTRING, 58)
-PR_REPORT_NAME_W = PROP_TAG(PT_UNICODE, 58)
-PR_REPORT_NAME_A = PROP_TAG(PT_STRING8, 58)
-PR_SENT_REPRESENTING_SEARCH_KEY = PROP_TAG(PT_BINARY, 59)
-PR_X400_CONTENT_TYPE = PROP_TAG(PT_BINARY, 60)
-PR_SUBJECT_PREFIX = PROP_TAG(PT_TSTRING, 61)
-PR_SUBJECT_PREFIX_W = PROP_TAG(PT_UNICODE, 61)
-PR_SUBJECT_PREFIX_A = PROP_TAG(PT_STRING8, 61)
-PR_NON_RECEIPT_REASON = PROP_TAG(PT_LONG, 62)
-PR_RECEIVED_BY_ENTRYID = PROP_TAG(PT_BINARY, 63)
-PR_RECEIVED_BY_NAME = PROP_TAG(PT_TSTRING, 64)
-PR_RECEIVED_BY_NAME_W = PROP_TAG(PT_UNICODE, 64)
-PR_RECEIVED_BY_NAME_A = PROP_TAG(PT_STRING8, 64)
-PR_SENT_REPRESENTING_ENTRYID = PROP_TAG(PT_BINARY, 65)
-PR_SENT_REPRESENTING_NAME = PROP_TAG(PT_TSTRING, 66)
-PR_SENT_REPRESENTING_NAME_W = PROP_TAG(PT_UNICODE, 66)
-PR_SENT_REPRESENTING_NAME_A = PROP_TAG(PT_STRING8, 66)
-PR_RCVD_REPRESENTING_ENTRYID = PROP_TAG(PT_BINARY, 67)
-PR_RCVD_REPRESENTING_NAME = PROP_TAG(PT_TSTRING, 68)
-PR_RCVD_REPRESENTING_NAME_W = PROP_TAG(PT_UNICODE, 68)
-PR_RCVD_REPRESENTING_NAME_A = PROP_TAG(PT_STRING8, 68)
-PR_REPORT_ENTRYID = PROP_TAG(PT_BINARY, 69)
-PR_READ_RECEIPT_ENTRYID = PROP_TAG(PT_BINARY, 70)
-PR_MESSAGE_SUBMISSION_ID = PROP_TAG(PT_BINARY, 71)
-PR_PROVIDER_SUBMIT_TIME = PROP_TAG(PT_SYSTIME, 72)
-PR_ORIGINAL_SUBJECT = PROP_TAG(PT_TSTRING, 73)
-PR_ORIGINAL_SUBJECT_W = PROP_TAG(PT_UNICODE, 73)
-PR_ORIGINAL_SUBJECT_A = PROP_TAG(PT_STRING8, 73)
-PR_DISC_VAL = PROP_TAG(PT_BOOLEAN, 74)
-PR_ORIG_MESSAGE_CLASS = PROP_TAG(PT_TSTRING, 75)
-PR_ORIG_MESSAGE_CLASS_W = PROP_TAG(PT_UNICODE, 75)
-PR_ORIG_MESSAGE_CLASS_A = PROP_TAG(PT_STRING8, 75)
-PR_ORIGINAL_AUTHOR_ENTRYID = PROP_TAG(PT_BINARY, 76)
-PR_ORIGINAL_AUTHOR_NAME = PROP_TAG(PT_TSTRING, 77)
-PR_ORIGINAL_AUTHOR_NAME_W = PROP_TAG(PT_UNICODE, 77)
-PR_ORIGINAL_AUTHOR_NAME_A = PROP_TAG(PT_STRING8, 77)
-PR_ORIGINAL_SUBMIT_TIME = PROP_TAG(PT_SYSTIME, 78)
-PR_REPLY_RECIPIENT_ENTRIES = PROP_TAG(PT_BINARY, 79)
-PR_REPLY_RECIPIENT_NAMES = PROP_TAG(PT_TSTRING, 80)
-PR_REPLY_RECIPIENT_NAMES_W = PROP_TAG(PT_UNICODE, 80)
-PR_REPLY_RECIPIENT_NAMES_A = PROP_TAG(PT_STRING8, 80)
-PR_RECEIVED_BY_SEARCH_KEY = PROP_TAG(PT_BINARY, 81)
-PR_RCVD_REPRESENTING_SEARCH_KEY = PROP_TAG(PT_BINARY, 82)
-PR_READ_RECEIPT_SEARCH_KEY = PROP_TAG(PT_BINARY, 83)
-PR_REPORT_SEARCH_KEY = PROP_TAG(PT_BINARY, 84)
-PR_ORIGINAL_DELIVERY_TIME = PROP_TAG(PT_SYSTIME, 85)
-PR_ORIGINAL_AUTHOR_SEARCH_KEY = PROP_TAG(PT_BINARY, 86)
-PR_MESSAGE_TO_ME = PROP_TAG(PT_BOOLEAN, 87)
-PR_MESSAGE_CC_ME = PROP_TAG(PT_BOOLEAN, 88)
-PR_MESSAGE_RECIP_ME = PROP_TAG(PT_BOOLEAN, 89)
-PR_ORIGINAL_SENDER_NAME = PROP_TAG(PT_TSTRING, 90)
-PR_ORIGINAL_SENDER_NAME_W = PROP_TAG(PT_UNICODE, 90)
-PR_ORIGINAL_SENDER_NAME_A = PROP_TAG(PT_STRING8, 90)
-PR_ORIGINAL_SENDER_ENTRYID = PROP_TAG(PT_BINARY, 91)
-PR_ORIGINAL_SENDER_SEARCH_KEY = PROP_TAG(PT_BINARY, 92)
-PR_ORIGINAL_SENT_REPRESENTING_NAME = PROP_TAG(PT_TSTRING, 93)
-PR_ORIGINAL_SENT_REPRESENTING_NAME_W = PROP_TAG(PT_UNICODE, 93)
-PR_ORIGINAL_SENT_REPRESENTING_NAME_A = PROP_TAG(PT_STRING8, 93)
-PR_ORIGINAL_SENT_REPRESENTING_ENTRYID = PROP_TAG(PT_BINARY, 94)
-PR_ORIGINAL_SENT_REPRESENTING_SEARCH_KEY = PROP_TAG(PT_BINARY, 95)
-PR_START_DATE = PROP_TAG(PT_SYSTIME, 96)
-PR_END_DATE = PROP_TAG(PT_SYSTIME, 97)
-PR_OWNER_APPT_ID = PROP_TAG(PT_LONG, 98)
-PR_RESPONSE_REQUESTED = PROP_TAG(PT_BOOLEAN, 99)
-PR_SENT_REPRESENTING_ADDRTYPE = PROP_TAG(PT_TSTRING, 100)
-PR_SENT_REPRESENTING_ADDRTYPE_W = PROP_TAG(PT_UNICODE, 100)
-PR_SENT_REPRESENTING_ADDRTYPE_A = PROP_TAG(PT_STRING8, 100)
-PR_SENT_REPRESENTING_EMAIL_ADDRESS = PROP_TAG(PT_TSTRING, 101)
-PR_SENT_REPRESENTING_EMAIL_ADDRESS_W = PROP_TAG(PT_UNICODE, 101)
-PR_SENT_REPRESENTING_EMAIL_ADDRESS_A = PROP_TAG(PT_STRING8, 101)
-PR_ORIGINAL_SENDER_ADDRTYPE = PROP_TAG(PT_TSTRING, 102)
-PR_ORIGINAL_SENDER_ADDRTYPE_W = PROP_TAG(PT_UNICODE, 102)
-PR_ORIGINAL_SENDER_ADDRTYPE_A = PROP_TAG(PT_STRING8, 102)
-PR_ORIGINAL_SENDER_EMAIL_ADDRESS = PROP_TAG(PT_TSTRING, 103)
-PR_ORIGINAL_SENDER_EMAIL_ADDRESS_W = PROP_TAG(PT_UNICODE, 103)
-PR_ORIGINAL_SENDER_EMAIL_ADDRESS_A = PROP_TAG(PT_STRING8, 103)
-PR_ORIGINAL_SENT_REPRESENTING_ADDRTYPE = PROP_TAG(PT_TSTRING, 104)
-PR_ORIGINAL_SENT_REPRESENTING_ADDRTYPE_W = PROP_TAG(PT_UNICODE, 104)
-PR_ORIGINAL_SENT_REPRESENTING_ADDRTYPE_A = PROP_TAG(PT_STRING8, 104)
-PR_ORIGINAL_SENT_REPRESENTING_EMAIL_ADDRESS = PROP_TAG(PT_TSTRING, 105)
-PR_ORIGINAL_SENT_REPRESENTING_EMAIL_ADDRESS_W = PROP_TAG(PT_UNICODE, 105)
-PR_ORIGINAL_SENT_REPRESENTING_EMAIL_ADDRESS_A = PROP_TAG(PT_STRING8, 105)
-PR_CONVERSATION_TOPIC = PROP_TAG(PT_TSTRING, 112)
-PR_CONVERSATION_TOPIC_W = PROP_TAG(PT_UNICODE, 112)
-PR_CONVERSATION_TOPIC_A = PROP_TAG(PT_STRING8, 112)
-PR_CONVERSATION_INDEX = PROP_TAG(PT_BINARY, 113)
-PR_ORIGINAL_DISPLAY_BCC = PROP_TAG(PT_TSTRING, 114)
-PR_ORIGINAL_DISPLAY_BCC_W = PROP_TAG(PT_UNICODE, 114)
-PR_ORIGINAL_DISPLAY_BCC_A = PROP_TAG(PT_STRING8, 114)
-PR_ORIGINAL_DISPLAY_CC = PROP_TAG(PT_TSTRING, 115)
-PR_ORIGINAL_DISPLAY_CC_W = PROP_TAG(PT_UNICODE, 115)
-PR_ORIGINAL_DISPLAY_CC_A = PROP_TAG(PT_STRING8, 115)
-PR_ORIGINAL_DISPLAY_TO = PROP_TAG(PT_TSTRING, 116)
-PR_ORIGINAL_DISPLAY_TO_W = PROP_TAG(PT_UNICODE, 116)
-PR_ORIGINAL_DISPLAY_TO_A = PROP_TAG(PT_STRING8, 116)
-PR_RECEIVED_BY_ADDRTYPE = PROP_TAG(PT_TSTRING, 117)
-PR_RECEIVED_BY_ADDRTYPE_W = PROP_TAG(PT_UNICODE, 117)
-PR_RECEIVED_BY_ADDRTYPE_A = PROP_TAG(PT_STRING8, 117)
-PR_RECEIVED_BY_EMAIL_ADDRESS = PROP_TAG(PT_TSTRING, 118)
-PR_RECEIVED_BY_EMAIL_ADDRESS_W = PROP_TAG(PT_UNICODE, 118)
-PR_RECEIVED_BY_EMAIL_ADDRESS_A = PROP_TAG(PT_STRING8, 118)
-PR_RCVD_REPRESENTING_ADDRTYPE = PROP_TAG(PT_TSTRING, 119)
-PR_RCVD_REPRESENTING_ADDRTYPE_W = PROP_TAG(PT_UNICODE, 119)
-PR_RCVD_REPRESENTING_ADDRTYPE_A = PROP_TAG(PT_STRING8, 119)
-PR_RCVD_REPRESENTING_EMAIL_ADDRESS = PROP_TAG(PT_TSTRING, 120)
-PR_RCVD_REPRESENTING_EMAIL_ADDRESS_W = PROP_TAG(PT_UNICODE, 120)
-PR_RCVD_REPRESENTING_EMAIL_ADDRESS_A = PROP_TAG(PT_STRING8, 120)
-PR_ORIGINAL_AUTHOR_ADDRTYPE = PROP_TAG(PT_TSTRING, 121)
-PR_ORIGINAL_AUTHOR_ADDRTYPE_W = PROP_TAG(PT_UNICODE, 121)
-PR_ORIGINAL_AUTHOR_ADDRTYPE_A = PROP_TAG(PT_STRING8, 121)
-PR_ORIGINAL_AUTHOR_EMAIL_ADDRESS = PROP_TAG(PT_TSTRING, 122)
-PR_ORIGINAL_AUTHOR_EMAIL_ADDRESS_W = PROP_TAG(PT_UNICODE, 122)
-PR_ORIGINAL_AUTHOR_EMAIL_ADDRESS_A = PROP_TAG(PT_STRING8, 122)
-PR_ORIGINALLY_INTENDED_RECIP_ADDRTYPE = PROP_TAG(PT_TSTRING, 123)
-PR_ORIGINALLY_INTENDED_RECIP_ADDRTYPE_W = PROP_TAG(PT_UNICODE, 123)
-PR_ORIGINALLY_INTENDED_RECIP_ADDRTYPE_A = PROP_TAG(PT_STRING8, 123)
-PR_ORIGINALLY_INTENDED_RECIP_EMAIL_ADDRESS = PROP_TAG(PT_TSTRING, 124)
-PR_ORIGINALLY_INTENDED_RECIP_EMAIL_ADDRESS_W = PROP_TAG(PT_UNICODE, 124)
-PR_ORIGINALLY_INTENDED_RECIP_EMAIL_ADDRESS_A = PROP_TAG(PT_STRING8, 124)
-PR_TRANSPORT_MESSAGE_HEADERS = PROP_TAG(PT_TSTRING, 125)
-PR_TRANSPORT_MESSAGE_HEADERS_W = PROP_TAG(PT_UNICODE, 125)
-PR_TRANSPORT_MESSAGE_HEADERS_A = PROP_TAG(PT_STRING8, 125)
-PR_DELEGATION = PROP_TAG(PT_BINARY, 126)
-PR_TNEF_CORRELATION_KEY = PROP_TAG(PT_BINARY, 127)
-PR_BODY = PROP_TAG(PT_TSTRING, 4096)
-PR_BODY_W = PROP_TAG(PT_UNICODE, 4096)
-PR_BODY_A = PROP_TAG(PT_STRING8, 4096)
-PR_BODY_HTML = PROP_TAG(PT_TSTRING, 4115)
-PR_BODY_HTML_W = PROP_TAG(PT_UNICODE, 4115)
-PR_BODY_HTML_A = PROP_TAG(PT_STRING8, 4115)
-PR_REPORT_TEXT = PROP_TAG(PT_TSTRING, 4097)
-PR_REPORT_TEXT_W = PROP_TAG(PT_UNICODE, 4097)
-PR_REPORT_TEXT_A = PROP_TAG(PT_STRING8, 4097)
-PR_ORIGINATOR_AND_DL_EXPANSION_HISTORY = PROP_TAG(PT_BINARY, 4098)
-PR_REPORTING_DL_NAME = PROP_TAG(PT_BINARY, 4099)
-PR_REPORTING_MTA_CERTIFICATE = PROP_TAG(PT_BINARY, 4100)
-PR_RTF_SYNC_BODY_CRC = PROP_TAG(PT_LONG, 4102)
-PR_RTF_SYNC_BODY_COUNT = PROP_TAG(PT_LONG, 4103)
-PR_RTF_SYNC_BODY_TAG = PROP_TAG(PT_TSTRING, 4104)
-PR_RTF_SYNC_BODY_TAG_W = PROP_TAG(PT_UNICODE, 4104)
-PR_RTF_SYNC_BODY_TAG_A = PROP_TAG(PT_STRING8, 4104)
-PR_RTF_COMPRESSED = PROP_TAG(PT_BINARY, 4105)
-PR_RTF_SYNC_PREFIX_COUNT = PROP_TAG(PT_LONG, 4112)
-PR_RTF_SYNC_TRAILING_COUNT = PROP_TAG(PT_LONG, 4113)
-PR_ORIGINALLY_INTENDED_RECIP_ENTRYID = PROP_TAG(PT_BINARY, 4114)
-PR_CONTENT_INTEGRITY_CHECK = PROP_TAG(PT_BINARY, 3072)
-PR_EXPLICIT_CONVERSION = PROP_TAG(PT_LONG, 3073)
-PR_IPM_RETURN_REQUESTED = PROP_TAG(PT_BOOLEAN, 3074)
-PR_MESSAGE_TOKEN = PROP_TAG(PT_BINARY, 3075)
-PR_NDR_REASON_CODE = PROP_TAG(PT_LONG, 3076)
-PR_NDR_DIAG_CODE = PROP_TAG(PT_LONG, 3077)
-PR_NON_RECEIPT_NOTIFICATION_REQUESTED = PROP_TAG(PT_BOOLEAN, 3078)
-PR_DELIVERY_POINT = PROP_TAG(PT_LONG, 3079)
-PR_ORIGINATOR_NON_DELIVERY_REPORT_REQUESTED = PROP_TAG(PT_BOOLEAN, 3080)
-PR_ORIGINATOR_REQUESTED_ALTERNATE_RECIPIENT = PROP_TAG(PT_BINARY, 3081)
-PR_PHYSICAL_DELIVERY_BUREAU_FAX_DELIVERY = PROP_TAG(PT_BOOLEAN, 3082)
-PR_PHYSICAL_DELIVERY_MODE = PROP_TAG(PT_LONG, 3083)
-PR_PHYSICAL_DELIVERY_REPORT_REQUEST = PROP_TAG(PT_LONG, 3084)
-PR_PHYSICAL_FORWARDING_ADDRESS = PROP_TAG(PT_BINARY, 3085)
-PR_PHYSICAL_FORWARDING_ADDRESS_REQUESTED = PROP_TAG(PT_BOOLEAN, 3086)
-PR_PHYSICAL_FORWARDING_PROHIBITED = PROP_TAG(PT_BOOLEAN, 3087)
-PR_PHYSICAL_RENDITION_ATTRIBUTES = PROP_TAG(PT_BINARY, 3088)
-PR_PROOF_OF_DELIVERY = PROP_TAG(PT_BINARY, 3089)
-PR_PROOF_OF_DELIVERY_REQUESTED = PROP_TAG(PT_BOOLEAN, 3090)
-PR_RECIPIENT_CERTIFICATE = PROP_TAG(PT_BINARY, 3091)
-PR_RECIPIENT_NUMBER_FOR_ADVICE = PROP_TAG(PT_TSTRING, 3092)
-PR_RECIPIENT_NUMBER_FOR_ADVICE_W = PROP_TAG(PT_UNICODE, 3092)
-PR_RECIPIENT_NUMBER_FOR_ADVICE_A = PROP_TAG(PT_STRING8, 3092)
-PR_RECIPIENT_TYPE = PROP_TAG(PT_LONG, 3093)
-PR_REGISTERED_MAIL_TYPE = PROP_TAG(PT_LONG, 3094)
-PR_REPLY_REQUESTED = PROP_TAG(PT_BOOLEAN, 3095)
-PR_REQUESTED_DELIVERY_METHOD = PROP_TAG(PT_LONG, 3096)
-PR_SENDER_ENTRYID = PROP_TAG(PT_BINARY, 3097)
-PR_SENDER_NAME = PROP_TAG(PT_TSTRING, 3098)
-PR_SENDER_NAME_W = PROP_TAG(PT_UNICODE, 3098)
-PR_SENDER_NAME_A = PROP_TAG(PT_STRING8, 3098)
-PR_SUPPLEMENTARY_INFO = PROP_TAG(PT_TSTRING, 3099)
-PR_SUPPLEMENTARY_INFO_W = PROP_TAG(PT_UNICODE, 3099)
-PR_SUPPLEMENTARY_INFO_A = PROP_TAG(PT_STRING8, 3099)
-PR_TYPE_OF_MTS_USER = PROP_TAG(PT_LONG, 3100)
-PR_SENDER_SEARCH_KEY = PROP_TAG(PT_BINARY, 3101)
-PR_SENDER_ADDRTYPE = PROP_TAG(PT_TSTRING, 3102)
-PR_SENDER_ADDRTYPE_W = PROP_TAG(PT_UNICODE, 3102)
-PR_SENDER_ADDRTYPE_A = PROP_TAG(PT_STRING8, 3102)
-PR_SENDER_EMAIL_ADDRESS = PROP_TAG(PT_TSTRING, 3103)
-PR_SENDER_EMAIL_ADDRESS_W = PROP_TAG(PT_UNICODE, 3103)
-PR_SENDER_EMAIL_ADDRESS_A = PROP_TAG(PT_STRING8, 3103)
-PR_CURRENT_VERSION = PROP_TAG(PT_I8, 3584)
-PR_DELETE_AFTER_SUBMIT = PROP_TAG(PT_BOOLEAN, 3585)
-PR_DISPLAY_BCC = PROP_TAG(PT_TSTRING, 3586)
-PR_DISPLAY_BCC_W = PROP_TAG(PT_UNICODE, 3586)
-PR_DISPLAY_BCC_A = PROP_TAG(PT_STRING8, 3586)
-PR_DISPLAY_CC = PROP_TAG(PT_TSTRING, 3587)
-PR_DISPLAY_CC_W = PROP_TAG(PT_UNICODE, 3587)
-PR_DISPLAY_CC_A = PROP_TAG(PT_STRING8, 3587)
-PR_DISPLAY_TO = PROP_TAG(PT_TSTRING, 3588)
-PR_DISPLAY_TO_W = PROP_TAG(PT_UNICODE, 3588)
-PR_DISPLAY_TO_A = PROP_TAG(PT_STRING8, 3588)
-PR_PARENT_DISPLAY = PROP_TAG(PT_TSTRING, 3589)
-PR_PARENT_DISPLAY_W = PROP_TAG(PT_UNICODE, 3589)
-PR_PARENT_DISPLAY_A = PROP_TAG(PT_STRING8, 3589)
-PR_MESSAGE_DELIVERY_TIME = PROP_TAG(PT_SYSTIME, 3590)
-PR_MESSAGE_FLAGS = PROP_TAG(PT_LONG, 3591)
-PR_MESSAGE_SIZE = PROP_TAG(PT_LONG, 3592)
-PR_PARENT_ENTRYID = PROP_TAG(PT_BINARY, 3593)
-PR_SENTMAIL_ENTRYID = PROP_TAG(PT_BINARY, 3594)
-PR_CORRELATE = PROP_TAG(PT_BOOLEAN, 3596)
-PR_CORRELATE_MTSID = PROP_TAG(PT_BINARY, 3597)
-PR_DISCRETE_VALUES = PROP_TAG(PT_BOOLEAN, 3598)
-PR_RESPONSIBILITY = PROP_TAG(PT_BOOLEAN, 3599)
-PR_SPOOLER_STATUS = PROP_TAG(PT_LONG, 3600)
-PR_TRANSPORT_STATUS = PROP_TAG(PT_LONG, 3601)
-PR_MESSAGE_RECIPIENTS = PROP_TAG(PT_OBJECT, 3602)
-PR_MESSAGE_ATTACHMENTS = PROP_TAG(PT_OBJECT, 3603)
-PR_SUBMIT_FLAGS = PROP_TAG(PT_LONG, 3604)
-PR_RECIPIENT_STATUS = PROP_TAG(PT_LONG, 3605)
-PR_TRANSPORT_KEY = PROP_TAG(PT_LONG, 3606)
-PR_MSG_STATUS = PROP_TAG(PT_LONG, 3607)
-PR_MESSAGE_DOWNLOAD_TIME = PROP_TAG(PT_LONG, 3608)
-PR_CREATION_VERSION = PROP_TAG(PT_I8, 3609)
-PR_MODIFY_VERSION = PROP_TAG(PT_I8, 3610)
-PR_HASATTACH = PROP_TAG(PT_BOOLEAN, 3611)
-PR_BODY_CRC = PROP_TAG(PT_LONG, 3612)
-PR_NORMALIZED_SUBJECT = PROP_TAG(PT_TSTRING, 3613)
-PR_NORMALIZED_SUBJECT_W = PROP_TAG(PT_UNICODE, 3613)
-PR_NORMALIZED_SUBJECT_A = PROP_TAG(PT_STRING8, 3613)
-PR_RTF_IN_SYNC = PROP_TAG(PT_BOOLEAN, 3615)
-PR_ATTACH_SIZE = PROP_TAG(PT_LONG, 3616)
-PR_ATTACH_NUM = PROP_TAG(PT_LONG, 3617)
-PR_PREPROCESS = PROP_TAG(PT_BOOLEAN, 3618)
-PR_ORIGINATING_MTA_CERTIFICATE = PROP_TAG(PT_BINARY, 3621)
-PR_PROOF_OF_SUBMISSION = PROP_TAG(PT_BINARY, 3622)
-PR_ENTRYID = PROP_TAG(PT_BINARY, 4095)
-PR_OBJECT_TYPE = PROP_TAG(PT_LONG, 4094)
-PR_ICON = PROP_TAG(PT_BINARY, 4093)
-PR_MINI_ICON = PROP_TAG(PT_BINARY, 4092)
-PR_STORE_ENTRYID = PROP_TAG(PT_BINARY, 4091)
-PR_STORE_RECORD_KEY = PROP_TAG(PT_BINARY, 4090)
-PR_RECORD_KEY = PROP_TAG(PT_BINARY, 4089)
-PR_MAPPING_SIGNATURE = PROP_TAG(PT_BINARY, 4088)
-PR_ACCESS_LEVEL = PROP_TAG(PT_LONG, 4087)
-PR_INSTANCE_KEY = PROP_TAG(PT_BINARY, 4086)
-PR_ROW_TYPE = PROP_TAG(PT_LONG, 4085)
-PR_ACCESS = PROP_TAG(PT_LONG, 4084)
-PR_ROWID = PROP_TAG(PT_LONG, 12288)
-PR_DISPLAY_NAME = PROP_TAG(PT_TSTRING, 12289)
-PR_DISPLAY_NAME_W = PROP_TAG(PT_UNICODE, 12289)
-PR_DISPLAY_NAME_A = PROP_TAG(PT_STRING8, 12289)
-PR_ADDRTYPE = PROP_TAG(PT_TSTRING, 12290)
-PR_ADDRTYPE_W = PROP_TAG(PT_UNICODE, 12290)
-PR_ADDRTYPE_A = PROP_TAG(PT_STRING8, 12290)
-PR_EMAIL_ADDRESS = PROP_TAG(PT_TSTRING, 12291)
-PR_EMAIL_ADDRESS_W = PROP_TAG(PT_UNICODE, 12291)
-PR_EMAIL_ADDRESS_A = PROP_TAG(PT_STRING8, 12291)
-PR_COMMENT = PROP_TAG(PT_TSTRING, 12292)
-PR_COMMENT_W = PROP_TAG(PT_UNICODE, 12292)
-PR_COMMENT_A = PROP_TAG(PT_STRING8, 12292)
-PR_DEPTH = PROP_TAG(PT_LONG, 12293)
-PR_PROVIDER_DISPLAY = PROP_TAG(PT_TSTRING, 12294)
-PR_PROVIDER_DISPLAY_W = PROP_TAG(PT_UNICODE, 12294)
-PR_PROVIDER_DISPLAY_A = PROP_TAG(PT_STRING8, 12294)
-PR_CREATION_TIME = PROP_TAG(PT_SYSTIME, 12295)
-PR_LAST_MODIFICATION_TIME = PROP_TAG(PT_SYSTIME, 12296)
-PR_RESOURCE_FLAGS = PROP_TAG(PT_LONG, 12297)
-PR_PROVIDER_DLL_NAME = PROP_TAG(PT_TSTRING, 12298)
-PR_PROVIDER_DLL_NAME_W = PROP_TAG(PT_UNICODE, 12298)
-PR_PROVIDER_DLL_NAME_A = PROP_TAG(PT_STRING8, 12298)
-PR_SEARCH_KEY = PROP_TAG(PT_BINARY, 12299)
-PR_PROVIDER_UID = PROP_TAG(PT_BINARY, 12300)
-PR_PROVIDER_ORDINAL = PROP_TAG(PT_LONG, 12301)
-PR_FORM_VERSION = PROP_TAG(PT_TSTRING, 13057)
-PR_FORM_VERSION_W = PROP_TAG(PT_UNICODE, 13057)
-PR_FORM_VERSION_A = PROP_TAG(PT_STRING8, 13057)
-PR_FORM_CLSID = PROP_TAG(PT_CLSID, 13058)
-PR_FORM_CONTACT_NAME = PROP_TAG(PT_TSTRING, 13059)
-PR_FORM_CONTACT_NAME_W = PROP_TAG(PT_UNICODE, 13059)
-PR_FORM_CONTACT_NAME_A = PROP_TAG(PT_STRING8, 13059)
-PR_FORM_CATEGORY = PROP_TAG(PT_TSTRING, 13060)
-PR_FORM_CATEGORY_W = PROP_TAG(PT_UNICODE, 13060)
-PR_FORM_CATEGORY_A = PROP_TAG(PT_STRING8, 13060)
-PR_FORM_CATEGORY_SUB = PROP_TAG(PT_TSTRING, 13061)
-PR_FORM_CATEGORY_SUB_W = PROP_TAG(PT_UNICODE, 13061)
-PR_FORM_CATEGORY_SUB_A = PROP_TAG(PT_STRING8, 13061)
-PR_FORM_HOST_MAP = PROP_TAG(PT_MV_LONG, 13062)
-PR_FORM_HIDDEN = PROP_TAG(PT_BOOLEAN, 13063)
-PR_FORM_DESIGNER_NAME = PROP_TAG(PT_TSTRING, 13064)
-PR_FORM_DESIGNER_NAME_W = PROP_TAG(PT_UNICODE, 13064)
-PR_FORM_DESIGNER_NAME_A = PROP_TAG(PT_STRING8, 13064)
-PR_FORM_DESIGNER_GUID = PROP_TAG(PT_CLSID, 13065)
-PR_FORM_MESSAGE_BEHAVIOR = PROP_TAG(PT_LONG, 13066)
-PR_DEFAULT_STORE = PROP_TAG(PT_BOOLEAN, 13312)
-PR_STORE_SUPPORT_MASK = PROP_TAG(PT_LONG, 13325)
-PR_STORE_STATE = PROP_TAG(PT_LONG, 13326)
-PR_IPM_SUBTREE_SEARCH_KEY = PROP_TAG(PT_BINARY, 13328)
-PR_IPM_OUTBOX_SEARCH_KEY = PROP_TAG(PT_BINARY, 13329)
-PR_IPM_WASTEBASKET_SEARCH_KEY = PROP_TAG(PT_BINARY, 13330)
-PR_IPM_SENTMAIL_SEARCH_KEY = PROP_TAG(PT_BINARY, 13331)
-PR_MDB_PROVIDER = PROP_TAG(PT_BINARY, 13332)
-PR_RECEIVE_FOLDER_SETTINGS = PROP_TAG(PT_OBJECT, 13333)
-PR_VALID_FOLDER_MASK = PROP_TAG(PT_LONG, 13791)
-PR_IPM_SUBTREE_ENTRYID = PROP_TAG(PT_BINARY, 13792)
-PR_IPM_OUTBOX_ENTRYID = PROP_TAG(PT_BINARY, 13794)
-PR_IPM_WASTEBASKET_ENTRYID = PROP_TAG(PT_BINARY, 13795)
-PR_IPM_SENTMAIL_ENTRYID = PROP_TAG(PT_BINARY, 13796)
-PR_VIEWS_ENTRYID = PROP_TAG(PT_BINARY, 13797)
-PR_COMMON_VIEWS_ENTRYID = PROP_TAG(PT_BINARY, 13798)
-PR_FINDER_ENTRYID = PROP_TAG(PT_BINARY, 13799)
-PR_CONTAINER_FLAGS = PROP_TAG(PT_LONG, 13824)
-PR_FOLDER_TYPE = PROP_TAG(PT_LONG, 13825)
-PR_CONTENT_COUNT = PROP_TAG(PT_LONG, 13826)
-PR_CONTENT_UNREAD = PROP_TAG(PT_LONG, 13827)
-PR_CREATE_TEMPLATES = PROP_TAG(PT_OBJECT, 13828)
-PR_DETAILS_TABLE = PROP_TAG(PT_OBJECT, 13829)
-PR_SEARCH = PROP_TAG(PT_OBJECT, 13831)
-PR_SELECTABLE = PROP_TAG(PT_BOOLEAN, 13833)
-PR_SUBFOLDERS = PROP_TAG(PT_BOOLEAN, 13834)
-PR_STATUS = PROP_TAG(PT_LONG, 13835)
-PR_ANR = PROP_TAG(PT_TSTRING, 13836)
-PR_ANR_W = PROP_TAG(PT_UNICODE, 13836)
-PR_ANR_A = PROP_TAG(PT_STRING8, 13836)
-PR_CONTENTS_SORT_ORDER = PROP_TAG(PT_MV_LONG, 13837)
-PR_CONTAINER_HIERARCHY = PROP_TAG(PT_OBJECT, 13838)
-PR_CONTAINER_CONTENTS = PROP_TAG(PT_OBJECT, 13839)
-PR_FOLDER_ASSOCIATED_CONTENTS = PROP_TAG(PT_OBJECT, 13840)
-PR_DEF_CREATE_DL = PROP_TAG(PT_BINARY, 13841)
-PR_DEF_CREATE_MAILUSER = PROP_TAG(PT_BINARY, 13842)
-PR_CONTAINER_CLASS = PROP_TAG(PT_TSTRING, 13843)
-PR_CONTAINER_CLASS_W = PROP_TAG(PT_UNICODE, 13843)
-PR_CONTAINER_CLASS_A = PROP_TAG(PT_STRING8, 13843)
-PR_CONTAINER_MODIFY_VERSION = PROP_TAG(PT_I8, 13844)
-PR_AB_PROVIDER_ID = PROP_TAG(PT_BINARY, 13845)
-PR_DEFAULT_VIEW_ENTRYID = PROP_TAG(PT_BINARY, 13846)
-PR_ASSOC_CONTENT_COUNT = PROP_TAG(PT_LONG, 13847)
-PR_ATTACHMENT_X400_PARAMETERS = PROP_TAG(PT_BINARY, 14080)
-PR_ATTACH_DATA_OBJ = PROP_TAG(PT_OBJECT, 14081)
-PR_ATTACH_DATA_BIN = PROP_TAG(PT_BINARY, 14081)
-PR_ATTACH_ENCODING = PROP_TAG(PT_BINARY, 14082)
-PR_ATTACH_EXTENSION = PROP_TAG(PT_TSTRING, 14083)
-PR_ATTACH_EXTENSION_W = PROP_TAG(PT_UNICODE, 14083)
-PR_ATTACH_EXTENSION_A = PROP_TAG(PT_STRING8, 14083)
-PR_ATTACH_FILENAME = PROP_TAG(PT_TSTRING, 14084)
-PR_ATTACH_FILENAME_W = PROP_TAG(PT_UNICODE, 14084)
-PR_ATTACH_FILENAME_A = PROP_TAG(PT_STRING8, 14084)
-PR_ATTACH_METHOD = PROP_TAG(PT_LONG, 14085)
-PR_ATTACH_LONG_FILENAME = PROP_TAG(PT_TSTRING, 14087)
-PR_ATTACH_LONG_FILENAME_W = PROP_TAG(PT_UNICODE, 14087)
-PR_ATTACH_LONG_FILENAME_A = PROP_TAG(PT_STRING8, 14087)
-PR_ATTACH_PATHNAME = PROP_TAG(PT_TSTRING, 14088)
-PR_ATTACH_PATHNAME_W = PROP_TAG(PT_UNICODE, 14088)
-PR_ATTACH_PATHNAME_A = PROP_TAG(PT_STRING8, 14088)
-PR_ATTACH_RENDERING = PROP_TAG(PT_BINARY, 14089)
-PR_ATTACH_TAG = PROP_TAG(PT_BINARY, 14090)
-PR_RENDERING_POSITION = PROP_TAG(PT_LONG, 14091)
-PR_ATTACH_TRANSPORT_NAME = PROP_TAG(PT_TSTRING, 14092)
-PR_ATTACH_TRANSPORT_NAME_W = PROP_TAG(PT_UNICODE, 14092)
-PR_ATTACH_TRANSPORT_NAME_A = PROP_TAG(PT_STRING8, 14092)
-PR_ATTACH_LONG_PATHNAME = PROP_TAG(PT_TSTRING, 14093)
-PR_ATTACH_LONG_PATHNAME_W = PROP_TAG(PT_UNICODE, 14093)
-PR_ATTACH_LONG_PATHNAME_A = PROP_TAG(PT_STRING8, 14093)
-PR_ATTACH_MIME_TAG = PROP_TAG(PT_TSTRING, 14094)
-PR_ATTACH_MIME_TAG_W = PROP_TAG(PT_UNICODE, 14094)
-PR_ATTACH_MIME_TAG_A = PROP_TAG(PT_STRING8, 14094)
-PR_ATTACH_ADDITIONAL_INFO = PROP_TAG(PT_BINARY, 14095)
-PR_DISPLAY_TYPE = PROP_TAG(PT_LONG, 14592)
-PR_TEMPLATEID = PROP_TAG(PT_BINARY, 14594)
-PR_PRIMARY_CAPABILITY = PROP_TAG(PT_BINARY, 14596)
-PR_7BIT_DISPLAY_NAME = PROP_TAG(PT_STRING8, 14847)
-PR_ACCOUNT = PROP_TAG(PT_TSTRING, 14848)
-PR_ACCOUNT_W = PROP_TAG(PT_UNICODE, 14848)
-PR_ACCOUNT_A = PROP_TAG(PT_STRING8, 14848)
-PR_ALTERNATE_RECIPIENT = PROP_TAG(PT_BINARY, 14849)
-PR_CALLBACK_TELEPHONE_NUMBER = PROP_TAG(PT_TSTRING, 14850)
-PR_CALLBACK_TELEPHONE_NUMBER_W = PROP_TAG(PT_UNICODE, 14850)
-PR_CALLBACK_TELEPHONE_NUMBER_A = PROP_TAG(PT_STRING8, 14850)
-PR_CONVERSION_PROHIBITED = PROP_TAG(PT_BOOLEAN, 14851)
-PR_DISCLOSE_RECIPIENTS = PROP_TAG(PT_BOOLEAN, 14852)
-PR_GENERATION = PROP_TAG(PT_TSTRING, 14853)
-PR_GENERATION_W = PROP_TAG(PT_UNICODE, 14853)
-PR_GENERATION_A = PROP_TAG(PT_STRING8, 14853)
-PR_GIVEN_NAME = PROP_TAG(PT_TSTRING, 14854)
-PR_GIVEN_NAME_W = PROP_TAG(PT_UNICODE, 14854)
-PR_GIVEN_NAME_A = PROP_TAG(PT_STRING8, 14854)
-PR_GOVERNMENT_ID_NUMBER = PROP_TAG(PT_TSTRING, 14855)
-PR_GOVERNMENT_ID_NUMBER_W = PROP_TAG(PT_UNICODE, 14855)
-PR_GOVERNMENT_ID_NUMBER_A = PROP_TAG(PT_STRING8, 14855)
-PR_BUSINESS_TELEPHONE_NUMBER = PROP_TAG(PT_TSTRING, 14856)
-PR_BUSINESS_TELEPHONE_NUMBER_W = PROP_TAG(PT_UNICODE, 14856)
-PR_BUSINESS_TELEPHONE_NUMBER_A = PROP_TAG(PT_STRING8, 14856)
-PR_OFFICE_TELEPHONE_NUMBER = PR_BUSINESS_TELEPHONE_NUMBER
-PR_OFFICE_TELEPHONE_NUMBER_W = PR_BUSINESS_TELEPHONE_NUMBER_W
-PR_OFFICE_TELEPHONE_NUMBER_A = PR_BUSINESS_TELEPHONE_NUMBER_A
-PR_HOME_TELEPHONE_NUMBER = PROP_TAG(PT_TSTRING, 14857)
-PR_HOME_TELEPHONE_NUMBER_W = PROP_TAG(PT_UNICODE, 14857)
-PR_HOME_TELEPHONE_NUMBER_A = PROP_TAG(PT_STRING8, 14857)
-PR_INITIALS = PROP_TAG(PT_TSTRING, 14858)
-PR_INITIALS_W = PROP_TAG(PT_UNICODE, 14858)
-PR_INITIALS_A = PROP_TAG(PT_STRING8, 14858)
-PR_KEYWORD = PROP_TAG(PT_TSTRING, 14859)
-PR_KEYWORD_W = PROP_TAG(PT_UNICODE, 14859)
-PR_KEYWORD_A = PROP_TAG(PT_STRING8, 14859)
-PR_LANGUAGE = PROP_TAG(PT_TSTRING, 14860)
-PR_LANGUAGE_W = PROP_TAG(PT_UNICODE, 14860)
-PR_LANGUAGE_A = PROP_TAG(PT_STRING8, 14860)
-PR_LOCATION = PROP_TAG(PT_TSTRING, 14861)
-PR_LOCATION_W = PROP_TAG(PT_UNICODE, 14861)
-PR_LOCATION_A = PROP_TAG(PT_STRING8, 14861)
-PR_MAIL_PERMISSION = PROP_TAG(PT_BOOLEAN, 14862)
-PR_MHS_COMMON_NAME = PROP_TAG(PT_TSTRING, 14863)
-PR_MHS_COMMON_NAME_W = PROP_TAG(PT_UNICODE, 14863)
-PR_MHS_COMMON_NAME_A = PROP_TAG(PT_STRING8, 14863)
-PR_ORGANIZATIONAL_ID_NUMBER = PROP_TAG(PT_TSTRING, 14864)
-PR_ORGANIZATIONAL_ID_NUMBER_W = PROP_TAG(PT_UNICODE, 14864)
-PR_ORGANIZATIONAL_ID_NUMBER_A = PROP_TAG(PT_STRING8, 14864)
-PR_SURNAME = PROP_TAG(PT_TSTRING, 14865)
-PR_SURNAME_W = PROP_TAG(PT_UNICODE, 14865)
-PR_SURNAME_A = PROP_TAG(PT_STRING8, 14865)
-PR_ORIGINAL_ENTRYID = PROP_TAG(PT_BINARY, 14866)
-PR_ORIGINAL_DISPLAY_NAME = PROP_TAG(PT_TSTRING, 14867)
-PR_ORIGINAL_DISPLAY_NAME_W = PROP_TAG(PT_UNICODE, 14867)
-PR_ORIGINAL_DISPLAY_NAME_A = PROP_TAG(PT_STRING8, 14867)
-PR_ORIGINAL_SEARCH_KEY = PROP_TAG(PT_BINARY, 14868)
-PR_POSTAL_ADDRESS = PROP_TAG(PT_TSTRING, 14869)
-PR_POSTAL_ADDRESS_W = PROP_TAG(PT_UNICODE, 14869)
-PR_POSTAL_ADDRESS_A = PROP_TAG(PT_STRING8, 14869)
-PR_COMPANY_NAME = PROP_TAG(PT_TSTRING, 14870)
-PR_COMPANY_NAME_W = PROP_TAG(PT_UNICODE, 14870)
-PR_COMPANY_NAME_A = PROP_TAG(PT_STRING8, 14870)
-PR_TITLE = PROP_TAG(PT_TSTRING, 14871)
-PR_TITLE_W = PROP_TAG(PT_UNICODE, 14871)
-PR_TITLE_A = PROP_TAG(PT_STRING8, 14871)
-PR_DEPARTMENT_NAME = PROP_TAG(PT_TSTRING, 14872)
-PR_DEPARTMENT_NAME_W = PROP_TAG(PT_UNICODE, 14872)
-PR_DEPARTMENT_NAME_A = PROP_TAG(PT_STRING8, 14872)
-PR_OFFICE_LOCATION = PROP_TAG(PT_TSTRING, 14873)
-PR_OFFICE_LOCATION_W = PROP_TAG(PT_UNICODE, 14873)
-PR_OFFICE_LOCATION_A = PROP_TAG(PT_STRING8, 14873)
-PR_PRIMARY_TELEPHONE_NUMBER = PROP_TAG(PT_TSTRING, 14874)
-PR_PRIMARY_TELEPHONE_NUMBER_W = PROP_TAG(PT_UNICODE, 14874)
-PR_PRIMARY_TELEPHONE_NUMBER_A = PROP_TAG(PT_STRING8, 14874)
-PR_BUSINESS2_TELEPHONE_NUMBER = PROP_TAG(PT_TSTRING, 14875)
-PR_BUSINESS2_TELEPHONE_NUMBER_W = PROP_TAG(PT_UNICODE, 14875)
-PR_BUSINESS2_TELEPHONE_NUMBER_A = PROP_TAG(PT_STRING8, 14875)
-PR_OFFICE2_TELEPHONE_NUMBER = PR_BUSINESS2_TELEPHONE_NUMBER
-PR_OFFICE2_TELEPHONE_NUMBER_W = PR_BUSINESS2_TELEPHONE_NUMBER_W
-PR_OFFICE2_TELEPHONE_NUMBER_A = PR_BUSINESS2_TELEPHONE_NUMBER_A
-PR_MOBILE_TELEPHONE_NUMBER = PROP_TAG(PT_TSTRING, 14876)
-PR_MOBILE_TELEPHONE_NUMBER_W = PROP_TAG(PT_UNICODE, 14876)
-PR_MOBILE_TELEPHONE_NUMBER_A = PROP_TAG(PT_STRING8, 14876)
-PR_CELLULAR_TELEPHONE_NUMBER = PR_MOBILE_TELEPHONE_NUMBER
-PR_CELLULAR_TELEPHONE_NUMBER_W = PR_MOBILE_TELEPHONE_NUMBER_W
-PR_CELLULAR_TELEPHONE_NUMBER_A = PR_MOBILE_TELEPHONE_NUMBER_A
-PR_RADIO_TELEPHONE_NUMBER = PROP_TAG(PT_TSTRING, 14877)
-PR_RADIO_TELEPHONE_NUMBER_W = PROP_TAG(PT_UNICODE, 14877)
-PR_RADIO_TELEPHONE_NUMBER_A = PROP_TAG(PT_STRING8, 14877)
-PR_CAR_TELEPHONE_NUMBER = PROP_TAG(PT_TSTRING, 14878)
-PR_CAR_TELEPHONE_NUMBER_W = PROP_TAG(PT_UNICODE, 14878)
-PR_CAR_TELEPHONE_NUMBER_A = PROP_TAG(PT_STRING8, 14878)
-PR_OTHER_TELEPHONE_NUMBER = PROP_TAG(PT_TSTRING, 14879)
-PR_OTHER_TELEPHONE_NUMBER_W = PROP_TAG(PT_UNICODE, 14879)
-PR_OTHER_TELEPHONE_NUMBER_A = PROP_TAG(PT_STRING8, 14879)
-PR_TRANSMITABLE_DISPLAY_NAME = PROP_TAG(PT_TSTRING, 14880)
-PR_TRANSMITABLE_DISPLAY_NAME_W = PROP_TAG(PT_UNICODE, 14880)
-PR_TRANSMITABLE_DISPLAY_NAME_A = PROP_TAG(PT_STRING8, 14880)
-PR_PAGER_TELEPHONE_NUMBER = PROP_TAG(PT_TSTRING, 14881)
-PR_PAGER_TELEPHONE_NUMBER_W = PROP_TAG(PT_UNICODE, 14881)
-PR_PAGER_TELEPHONE_NUMBER_A = PROP_TAG(PT_STRING8, 14881)
-PR_BEEPER_TELEPHONE_NUMBER = PR_PAGER_TELEPHONE_NUMBER
-PR_BEEPER_TELEPHONE_NUMBER_W = PR_PAGER_TELEPHONE_NUMBER_W
-PR_BEEPER_TELEPHONE_NUMBER_A = PR_PAGER_TELEPHONE_NUMBER_A
-PR_USER_CERTIFICATE = PROP_TAG(PT_BINARY, 14882)
-PR_PRIMARY_FAX_NUMBER = PROP_TAG(PT_TSTRING, 14883)
-PR_PRIMARY_FAX_NUMBER_W = PROP_TAG(PT_UNICODE, 14883)
-PR_PRIMARY_FAX_NUMBER_A = PROP_TAG(PT_STRING8, 14883)
-PR_BUSINESS_FAX_NUMBER = PROP_TAG(PT_TSTRING, 14884)
-PR_BUSINESS_FAX_NUMBER_W = PROP_TAG(PT_UNICODE, 14884)
-PR_BUSINESS_FAX_NUMBER_A = PROP_TAG(PT_STRING8, 14884)
-PR_HOME_FAX_NUMBER = PROP_TAG(PT_TSTRING, 14885)
-PR_HOME_FAX_NUMBER_W = PROP_TAG(PT_UNICODE, 14885)
-PR_HOME_FAX_NUMBER_A = PROP_TAG(PT_STRING8, 14885)
-PR_COUNTRY = PROP_TAG(PT_TSTRING, 14886)
-PR_COUNTRY_W = PROP_TAG(PT_UNICODE, 14886)
-PR_COUNTRY_A = PROP_TAG(PT_STRING8, 14886)
-PR_BUSINESS_ADDRESS_COUNTRY = PR_COUNTRY
-PR_BUSINESS_ADDRESS_COUNTRY_W = PR_COUNTRY_W
-PR_BUSINESS_ADDRESS_COUNTRY_A = PR_COUNTRY_A
-PR_LOCALITY = PROP_TAG(PT_TSTRING, 14887)
-PR_LOCALITY_W = PROP_TAG(PT_UNICODE, 14887)
-PR_LOCALITY_A = PROP_TAG(PT_STRING8, 14887)
-PR_BUSINESS_ADDRESS_CITY = PR_LOCALITY
-PR_BUSINESS_ADDRESS_CITY_W = PR_LOCALITY_W
-PR_BUSINESS_ADDRESS_CITY_A = PR_LOCALITY_A
-PR_STATE_OR_PROVINCE = PROP_TAG(PT_TSTRING, 14888)
-PR_STATE_OR_PROVINCE_W = PROP_TAG(PT_UNICODE, 14888)
-PR_STATE_OR_PROVINCE_A = PROP_TAG(PT_STRING8, 14888)
-PR_BUSINESS_ADDRESS_STATE_OR_PROVINCE = PR_STATE_OR_PROVINCE
-PR_BUSINESS_ADDRESS_STATE_OR_PROVINCE_W = PR_STATE_OR_PROVINCE_W
-PR_BUSINESS_ADDRESS_STATE_OR_PROVINCE_A = PR_STATE_OR_PROVINCE_A
-PR_STREET_ADDRESS = PROP_TAG(PT_TSTRING, 14889)
-PR_STREET_ADDRESS_W = PROP_TAG(PT_UNICODE, 14889)
-PR_STREET_ADDRESS_A = PROP_TAG(PT_STRING8, 14889)
-PR_BUSINESS_ADDRESS_STREET = PR_STREET_ADDRESS
-PR_BUSINESS_ADDRESS_STREET_W = PR_STREET_ADDRESS_W
-PR_BUSINESS_ADDRESS_STREET_A = PR_STREET_ADDRESS_A
-PR_POSTAL_CODE = PROP_TAG(PT_TSTRING, 14890)
-PR_POSTAL_CODE_W = PROP_TAG(PT_UNICODE, 14890)
-PR_POSTAL_CODE_A = PROP_TAG(PT_STRING8, 14890)
-PR_BUSINESS_ADDRESS_POSTAL_CODE = PR_POSTAL_CODE
-PR_BUSINESS_ADDRESS_POSTAL_CODE_W = PR_POSTAL_CODE_W
-PR_BUSINESS_ADDRESS_POSTAL_CODE_A = PR_POSTAL_CODE_A
-PR_POST_OFFICE_BOX = PROP_TAG(PT_TSTRING, 14891)
-PR_POST_OFFICE_BOX_W = PROP_TAG(PT_UNICODE, 14891)
-PR_POST_OFFICE_BOX_A = PROP_TAG(PT_STRING8, 14891)
-PR_BUSINESS_ADDRESS_POST_OFFICE_BOX = PR_POST_OFFICE_BOX
-PR_BUSINESS_ADDRESS_POST_OFFICE_BOX_W = PR_POST_OFFICE_BOX_W
-PR_BUSINESS_ADDRESS_POST_OFFICE_BOX_A = PR_POST_OFFICE_BOX_A
-PR_TELEX_NUMBER = PROP_TAG(PT_TSTRING, 14892)
-PR_TELEX_NUMBER_W = PROP_TAG(PT_UNICODE, 14892)
-PR_TELEX_NUMBER_A = PROP_TAG(PT_STRING8, 14892)
-PR_ISDN_NUMBER = PROP_TAG(PT_TSTRING, 14893)
-PR_ISDN_NUMBER_W = PROP_TAG(PT_UNICODE, 14893)
-PR_ISDN_NUMBER_A = PROP_TAG(PT_STRING8, 14893)
-PR_ASSISTANT_TELEPHONE_NUMBER = PROP_TAG(PT_TSTRING, 14894)
-PR_ASSISTANT_TELEPHONE_NUMBER_W = PROP_TAG(PT_UNICODE, 14894)
-PR_ASSISTANT_TELEPHONE_NUMBER_A = PROP_TAG(PT_STRING8, 14894)
-PR_HOME2_TELEPHONE_NUMBER = PROP_TAG(PT_TSTRING, 14895)
-PR_HOME2_TELEPHONE_NUMBER_W = PROP_TAG(PT_UNICODE, 14895)
-PR_HOME2_TELEPHONE_NUMBER_A = PROP_TAG(PT_STRING8, 14895)
-PR_ASSISTANT = PROP_TAG(PT_TSTRING, 14896)
-PR_ASSISTANT_W = PROP_TAG(PT_UNICODE, 14896)
-PR_ASSISTANT_A = PROP_TAG(PT_STRING8, 14896)
-PR_SEND_RICH_INFO = PROP_TAG(PT_BOOLEAN, 14912)
-PR_WEDDING_ANNIVERSARY = PROP_TAG(PT_SYSTIME, 14913)
-PR_BIRTHDAY = PROP_TAG(PT_SYSTIME, 14914)
-PR_HOBBIES = PROP_TAG(PT_TSTRING, 14915)
-PR_HOBBIES_W = PROP_TAG(PT_UNICODE, 14915)
-PR_HOBBIES_A = PROP_TAG(PT_STRING8, 14915)
-PR_MIDDLE_NAME = PROP_TAG(PT_TSTRING, 14916)
-PR_MIDDLE_NAME_W = PROP_TAG(PT_UNICODE, 14916)
-PR_MIDDLE_NAME_A = PROP_TAG(PT_STRING8, 14916)
-PR_DISPLAY_NAME_PREFIX = PROP_TAG(PT_TSTRING, 14917)
-PR_DISPLAY_NAME_PREFIX_W = PROP_TAG(PT_UNICODE, 14917)
-PR_DISPLAY_NAME_PREFIX_A = PROP_TAG(PT_STRING8, 14917)
-PR_PROFESSION = PROP_TAG(PT_TSTRING, 14918)
-PR_PROFESSION_W = PROP_TAG(PT_UNICODE, 14918)
-PR_PROFESSION_A = PROP_TAG(PT_STRING8, 14918)
-PR_PREFERRED_BY_NAME = PROP_TAG(PT_TSTRING, 14919)
-PR_PREFERRED_BY_NAME_W = PROP_TAG(PT_UNICODE, 14919)
-PR_PREFERRED_BY_NAME_A = PROP_TAG(PT_STRING8, 14919)
-PR_SPOUSE_NAME = PROP_TAG(PT_TSTRING, 14920)
-PR_SPOUSE_NAME_W = PROP_TAG(PT_UNICODE, 14920)
-PR_SPOUSE_NAME_A = PROP_TAG(PT_STRING8, 14920)
-PR_COMPUTER_NETWORK_NAME = PROP_TAG(PT_TSTRING, 14921)
-PR_COMPUTER_NETWORK_NAME_W = PROP_TAG(PT_UNICODE, 14921)
-PR_COMPUTER_NETWORK_NAME_A = PROP_TAG(PT_STRING8, 14921)
-PR_CUSTOMER_ID = PROP_TAG(PT_TSTRING, 14922)
-PR_CUSTOMER_ID_W = PROP_TAG(PT_UNICODE, 14922)
-PR_CUSTOMER_ID_A = PROP_TAG(PT_STRING8, 14922)
-PR_TTYTDD_PHONE_NUMBER = PROP_TAG(PT_TSTRING, 14923)
-PR_TTYTDD_PHONE_NUMBER_W = PROP_TAG(PT_UNICODE, 14923)
-PR_TTYTDD_PHONE_NUMBER_A = PROP_TAG(PT_STRING8, 14923)
-PR_FTP_SITE = PROP_TAG(PT_TSTRING, 14924)
-PR_FTP_SITE_W = PROP_TAG(PT_UNICODE, 14924)
-PR_FTP_SITE_A = PROP_TAG(PT_STRING8, 14924)
-PR_GENDER = PROP_TAG(PT_SHORT, 14925)
-PR_MANAGER_NAME = PROP_TAG(PT_TSTRING, 14926)
-PR_MANAGER_NAME_W = PROP_TAG(PT_UNICODE, 14926)
-PR_MANAGER_NAME_A = PROP_TAG(PT_STRING8, 14926)
-PR_NICKNAME = PROP_TAG(PT_TSTRING, 14927)
-PR_NICKNAME_W = PROP_TAG(PT_UNICODE, 14927)
-PR_NICKNAME_A = PROP_TAG(PT_STRING8, 14927)
-PR_PERSONAL_HOME_PAGE = PROP_TAG(PT_TSTRING, 14928)
-PR_PERSONAL_HOME_PAGE_W = PROP_TAG(PT_UNICODE, 14928)
-PR_PERSONAL_HOME_PAGE_A = PROP_TAG(PT_STRING8, 14928)
-PR_BUSINESS_HOME_PAGE = PROP_TAG(PT_TSTRING, 14929)
-PR_BUSINESS_HOME_PAGE_W = PROP_TAG(PT_UNICODE, 14929)
-PR_BUSINESS_HOME_PAGE_A = PROP_TAG(PT_STRING8, 14929)
-PR_CONTACT_VERSION = PROP_TAG(PT_CLSID, 14930)
-PR_CONTACT_ENTRYIDS = PROP_TAG(PT_MV_BINARY, 14931)
-PR_CONTACT_ADDRTYPES = PROP_TAG(PT_MV_TSTRING, 14932)
-PR_CONTACT_ADDRTYPES_W = PROP_TAG(PT_MV_UNICODE, 14932)
-PR_CONTACT_ADDRTYPES_A = PROP_TAG(PT_MV_STRING8, 14932)
-PR_CONTACT_DEFAULT_ADDRESS_INDEX = PROP_TAG(PT_LONG, 14933)
-PR_CONTACT_EMAIL_ADDRESSES = PROP_TAG(PT_MV_TSTRING, 14934)
-PR_CONTACT_EMAIL_ADDRESSES_W = PROP_TAG(PT_MV_UNICODE, 14934)
-PR_CONTACT_EMAIL_ADDRESSES_A = PROP_TAG(PT_MV_STRING8, 14934)
-PR_COMPANY_MAIN_PHONE_NUMBER = PROP_TAG(PT_TSTRING, 14935)
-PR_COMPANY_MAIN_PHONE_NUMBER_W = PROP_TAG(PT_UNICODE, 14935)
-PR_COMPANY_MAIN_PHONE_NUMBER_A = PROP_TAG(PT_STRING8, 14935)
-PR_CHILDRENS_NAMES = PROP_TAG(PT_MV_TSTRING, 14936)
-PR_CHILDRENS_NAMES_W = PROP_TAG(PT_MV_UNICODE, 14936)
-PR_CHILDRENS_NAMES_A = PROP_TAG(PT_MV_STRING8, 14936)
-PR_HOME_ADDRESS_CITY = PROP_TAG(PT_TSTRING, 14937)
-PR_HOME_ADDRESS_CITY_W = PROP_TAG(PT_UNICODE, 14937)
-PR_HOME_ADDRESS_CITY_A = PROP_TAG(PT_STRING8, 14937)
-PR_HOME_ADDRESS_COUNTRY = PROP_TAG(PT_TSTRING, 14938)
-PR_HOME_ADDRESS_COUNTRY_W = PROP_TAG(PT_UNICODE, 14938)
-PR_HOME_ADDRESS_COUNTRY_A = PROP_TAG(PT_STRING8, 14938)
-PR_HOME_ADDRESS_POSTAL_CODE = PROP_TAG(PT_TSTRING, 14939)
-PR_HOME_ADDRESS_POSTAL_CODE_W = PROP_TAG(PT_UNICODE, 14939)
-PR_HOME_ADDRESS_POSTAL_CODE_A = PROP_TAG(PT_STRING8, 14939)
-PR_HOME_ADDRESS_STATE_OR_PROVINCE = PROP_TAG(PT_TSTRING, 14940)
-PR_HOME_ADDRESS_STATE_OR_PROVINCE_W = PROP_TAG(PT_UNICODE, 14940)
-PR_HOME_ADDRESS_STATE_OR_PROVINCE_A = PROP_TAG(PT_STRING8, 14940)
-PR_HOME_ADDRESS_STREET = PROP_TAG(PT_TSTRING, 14941)
-PR_HOME_ADDRESS_STREET_W = PROP_TAG(PT_UNICODE, 14941)
-PR_HOME_ADDRESS_STREET_A = PROP_TAG(PT_STRING8, 14941)
-PR_HOME_ADDRESS_POST_OFFICE_BOX = PROP_TAG(PT_TSTRING, 14942)
-PR_HOME_ADDRESS_POST_OFFICE_BOX_W = PROP_TAG(PT_UNICODE, 14942)
-PR_HOME_ADDRESS_POST_OFFICE_BOX_A = PROP_TAG(PT_STRING8, 14942)
-PR_OTHER_ADDRESS_CITY = PROP_TAG(PT_TSTRING, 14943)
-PR_OTHER_ADDRESS_CITY_W = PROP_TAG(PT_UNICODE, 14943)
-PR_OTHER_ADDRESS_CITY_A = PROP_TAG(PT_STRING8, 14943)
-PR_OTHER_ADDRESS_COUNTRY = PROP_TAG(PT_TSTRING, 14944)
-PR_OTHER_ADDRESS_COUNTRY_W = PROP_TAG(PT_UNICODE, 14944)
-PR_OTHER_ADDRESS_COUNTRY_A = PROP_TAG(PT_STRING8, 14944)
-PR_OTHER_ADDRESS_POSTAL_CODE = PROP_TAG(PT_TSTRING, 14945)
-PR_OTHER_ADDRESS_POSTAL_CODE_W = PROP_TAG(PT_UNICODE, 14945)
-PR_OTHER_ADDRESS_POSTAL_CODE_A = PROP_TAG(PT_STRING8, 14945)
-PR_OTHER_ADDRESS_STATE_OR_PROVINCE = PROP_TAG(PT_TSTRING, 14946)
-PR_OTHER_ADDRESS_STATE_OR_PROVINCE_W = PROP_TAG(PT_UNICODE, 14946)
-PR_OTHER_ADDRESS_STATE_OR_PROVINCE_A = PROP_TAG(PT_STRING8, 14946)
-PR_OTHER_ADDRESS_STREET = PROP_TAG(PT_TSTRING, 14947)
-PR_OTHER_ADDRESS_STREET_W = PROP_TAG(PT_UNICODE, 14947)
-PR_OTHER_ADDRESS_STREET_A = PROP_TAG(PT_STRING8, 14947)
-PR_OTHER_ADDRESS_POST_OFFICE_BOX = PROP_TAG(PT_TSTRING, 14948)
-PR_OTHER_ADDRESS_POST_OFFICE_BOX_W = PROP_TAG(PT_UNICODE, 14948)
-PR_OTHER_ADDRESS_POST_OFFICE_BOX_A = PROP_TAG(PT_STRING8, 14948)
-PR_STORE_PROVIDERS = PROP_TAG(PT_BINARY, 15616)
-PR_AB_PROVIDERS = PROP_TAG(PT_BINARY, 15617)
-PR_TRANSPORT_PROVIDERS = PROP_TAG(PT_BINARY, 15618)
-PR_DEFAULT_PROFILE = PROP_TAG(PT_BOOLEAN, 15620)
-PR_AB_SEARCH_PATH = PROP_TAG(PT_MV_BINARY, 15621)
-PR_AB_DEFAULT_DIR = PROP_TAG(PT_BINARY, 15622)
-PR_AB_DEFAULT_PAB = PROP_TAG(PT_BINARY, 15623)
-PR_FILTERING_HOOKS = PROP_TAG(PT_BINARY, 15624)
-PR_SERVICE_NAME = PROP_TAG(PT_TSTRING, 15625)
-PR_SERVICE_NAME_W = PROP_TAG(PT_UNICODE, 15625)
-PR_SERVICE_NAME_A = PROP_TAG(PT_STRING8, 15625)
-PR_SERVICE_DLL_NAME = PROP_TAG(PT_TSTRING, 15626)
-PR_SERVICE_DLL_NAME_W = PROP_TAG(PT_UNICODE, 15626)
-PR_SERVICE_DLL_NAME_A = PROP_TAG(PT_STRING8, 15626)
-PR_SERVICE_ENTRY_NAME = PROP_TAG(PT_STRING8, 15627)
-PR_SERVICE_UID = PROP_TAG(PT_BINARY, 15628)
-PR_SERVICE_EXTRA_UIDS = PROP_TAG(PT_BINARY, 15629)
-PR_SERVICES = PROP_TAG(PT_BINARY, 15630)
-PR_SERVICE_SUPPORT_FILES = PROP_TAG(PT_MV_TSTRING, 15631)
-PR_SERVICE_SUPPORT_FILES_W = PROP_TAG(PT_MV_UNICODE, 15631)
-PR_SERVICE_SUPPORT_FILES_A = PROP_TAG(PT_MV_STRING8, 15631)
-PR_SERVICE_DELETE_FILES = PROP_TAG(PT_MV_TSTRING, 15632)
-PR_SERVICE_DELETE_FILES_W = PROP_TAG(PT_MV_UNICODE, 15632)
-PR_SERVICE_DELETE_FILES_A = PROP_TAG(PT_MV_STRING8, 15632)
-PR_AB_SEARCH_PATH_UPDATE = PROP_TAG(PT_BINARY, 15633)
-PR_PROFILE_NAME = PROP_TAG(PT_TSTRING, 15634)
-PR_PROFILE_NAME_A = PROP_TAG(PT_STRING8, 15634)
-PR_PROFILE_NAME_W = PROP_TAG(PT_UNICODE, 15634)
-PR_IDENTITY_DISPLAY = PROP_TAG(PT_TSTRING, 15872)
-PR_IDENTITY_DISPLAY_W = PROP_TAG(PT_UNICODE, 15872)
-PR_IDENTITY_DISPLAY_A = PROP_TAG(PT_STRING8, 15872)
-PR_IDENTITY_ENTRYID = PROP_TAG(PT_BINARY, 15873)
-PR_RESOURCE_METHODS = PROP_TAG(PT_LONG, 15874)
-PR_RESOURCE_TYPE = PROP_TAG(PT_LONG, 15875)
-PR_STATUS_CODE = PROP_TAG(PT_LONG, 15876)
-PR_IDENTITY_SEARCH_KEY = PROP_TAG(PT_BINARY, 15877)
-PR_OWN_STORE_ENTRYID = PROP_TAG(PT_BINARY, 15878)
-PR_RESOURCE_PATH = PROP_TAG(PT_TSTRING, 15879)
-PR_RESOURCE_PATH_W = PROP_TAG(PT_UNICODE, 15879)
-PR_RESOURCE_PATH_A = PROP_TAG(PT_STRING8, 15879)
-PR_STATUS_STRING = PROP_TAG(PT_TSTRING, 15880)
-PR_STATUS_STRING_W = PROP_TAG(PT_UNICODE, 15880)
-PR_STATUS_STRING_A = PROP_TAG(PT_STRING8, 15880)
-PR_X400_DEFERRED_DELIVERY_CANCEL = PROP_TAG(PT_BOOLEAN, 15881)
-PR_HEADER_FOLDER_ENTRYID = PROP_TAG(PT_BINARY, 15882)
-PR_REMOTE_PROGRESS = PROP_TAG(PT_LONG, 15883)
-PR_REMOTE_PROGRESS_TEXT = PROP_TAG(PT_TSTRING, 15884)
-PR_REMOTE_PROGRESS_TEXT_W = PROP_TAG(PT_UNICODE, 15884)
-PR_REMOTE_PROGRESS_TEXT_A = PROP_TAG(PT_STRING8, 15884)
-PR_REMOTE_VALIDATE_OK = PROP_TAG(PT_BOOLEAN, 15885)
-PR_CONTROL_FLAGS = PROP_TAG(PT_LONG, 16128)
-PR_CONTROL_STRUCTURE = PROP_TAG(PT_BINARY, 16129)
-PR_CONTROL_TYPE = PROP_TAG(PT_LONG, 16130)
-PR_DELTAX = PROP_TAG(PT_LONG, 16131)
-PR_DELTAY = PROP_TAG(PT_LONG, 16132)
-PR_XPOS = PROP_TAG(PT_LONG, 16133)
-PR_YPOS = PROP_TAG(PT_LONG, 16134)
-PR_CONTROL_ID = PROP_TAG(PT_BINARY, 16135)
-PR_INITIAL_DETAILS_PANE = PROP_TAG(PT_LONG, 16136)
-
-PROP_ID_SECURE_MIN = 26608
-PROP_ID_SECURE_MAX = 26623
-
-# From EDKMDB.H
-pidExchangeXmitReservedMin = 16352
-pidExchangeNonXmitReservedMin = 26080
-pidProfileMin = 26112
-pidStoreMin = 26136
-pidFolderMin = 26168
-pidMessageReadOnlyMin = 26176
-pidMessageWriteableMin = 26200
-pidAttachReadOnlyMin = 26220
-pidSpecialMin = 26224
-pidAdminMin = 26256
-pidSecureProfileMin = PROP_ID_SECURE_MIN
-
-PR_PROFILE_VERSION = PROP_TAG(PT_LONG, pidProfileMin + 0)
-PR_PROFILE_CONFIG_FLAGS = PROP_TAG(PT_LONG, pidProfileMin + 1)
-PR_PROFILE_HOME_SERVER = PROP_TAG(PT_STRING8, pidProfileMin + 2)
-PR_PROFILE_HOME_SERVER_DN = PROP_TAG(PT_STRING8, pidProfileMin + 18)
-PR_PROFILE_HOME_SERVER_ADDRS = PROP_TAG(PT_MV_STRING8, pidProfileMin + 19)
-PR_PROFILE_USER = PROP_TAG(PT_STRING8, pidProfileMin + 3)
-PR_PROFILE_CONNECT_FLAGS = PROP_TAG(PT_LONG, pidProfileMin + 4)
-PR_PROFILE_TRANSPORT_FLAGS = PROP_TAG(PT_LONG, pidProfileMin + 5)
-PR_PROFILE_UI_STATE = PROP_TAG(PT_LONG, pidProfileMin + 6)
-PR_PROFILE_UNRESOLVED_NAME = PROP_TAG(PT_STRING8, pidProfileMin + 7)
-PR_PROFILE_UNRESOLVED_SERVER = PROP_TAG(PT_STRING8, pidProfileMin + 8)
-PR_PROFILE_BINDING_ORDER = PROP_TAG(PT_STRING8, pidProfileMin + 9)
-PR_PROFILE_MAX_RESTRICT = PROP_TAG(PT_LONG, pidProfileMin + 13)
-PR_PROFILE_AB_FILES_PATH = PROP_TAG(PT_STRING8, pidProfileMin + 14)
-PR_PROFILE_OFFLINE_STORE_PATH = PROP_TAG(PT_STRING8, pidProfileMin + 16)
-PR_PROFILE_OFFLINE_INFO = PROP_TAG(PT_BINARY, pidProfileMin + 17)
-PR_PROFILE_ADDR_INFO = PROP_TAG(PT_BINARY, pidSpecialMin + 23)
-PR_PROFILE_OPTIONS_DATA = PROP_TAG(PT_BINARY, pidSpecialMin + 25)
-PR_PROFILE_SECURE_MAILBOX = PROP_TAG(PT_BINARY, pidSecureProfileMin + 0)
-PR_DISABLE_WINSOCK = PROP_TAG(PT_LONG, pidProfileMin + 24)
-PR_OST_ENCRYPTION = PROP_TAG(PT_LONG, 26370)
-PR_PROFILE_OPEN_FLAGS = PROP_TAG(PT_LONG, pidProfileMin + 9)
-PR_PROFILE_TYPE = PROP_TAG(PT_LONG, pidProfileMin + 10)
-PR_PROFILE_MAILBOX = PROP_TAG(PT_STRING8, pidProfileMin + 11)
-PR_PROFILE_SERVER = PROP_TAG(PT_STRING8, pidProfileMin + 12)
-PR_PROFILE_SERVER_DN = PROP_TAG(PT_STRING8, pidProfileMin + 20)
-PR_PROFILE_FAVFLD_DISPLAY_NAME = PROP_TAG(PT_STRING8, pidProfileMin + 15)
-PR_PROFILE_FAVFLD_COMMENT = PROP_TAG(PT_STRING8, pidProfileMin + 21)
-PR_PROFILE_ALLPUB_DISPLAY_NAME = PROP_TAG(PT_STRING8, pidProfileMin + 22)
-PR_PROFILE_ALLPUB_COMMENT = PROP_TAG(PT_STRING8, pidProfileMin + 23)
-
-OSTF_NO_ENCRYPTION = -2147483648
-OSTF_COMPRESSABLE_ENCRYPTION = 1073741824
-OSTF_BEST_ENCRYPTION = 536870912
-
-
-PR_NON_IPM_SUBTREE_ENTRYID = PROP_TAG(PT_BINARY, pidStoreMin + 8)
-PR_EFORMS_REGISTRY_ENTRYID = PROP_TAG(PT_BINARY, pidStoreMin + 9)
-PR_SPLUS_FREE_BUSY_ENTRYID = PROP_TAG(PT_BINARY, pidStoreMin + 10)
-PR_OFFLINE_ADDRBOOK_ENTRYID = PROP_TAG(PT_BINARY, pidStoreMin + 11)
-PR_EFORMS_FOR_LOCALE_ENTRYID = PROP_TAG(PT_BINARY, pidStoreMin + 12)
-PR_FREE_BUSY_FOR_LOCAL_SITE_ENTRYID = PROP_TAG(PT_BINARY, pidStoreMin + 13)
-PR_ADDRBOOK_FOR_LOCAL_SITE_ENTRYID = PROP_TAG(PT_BINARY, pidStoreMin + 14)
-PR_OFFLINE_MESSAGE_ENTRYID = PROP_TAG(PT_BINARY, pidStoreMin + 15)
-PR_IPM_FAVORITES_ENTRYID = PROP_TAG(PT_BINARY, pidStoreMin + 24)
-PR_IPM_PUBLIC_FOLDERS_ENTRYID = PROP_TAG(PT_BINARY, pidStoreMin + 25)
-PR_GW_MTSIN_ENTRYID = PROP_TAG(PT_BINARY, pidStoreMin + 16)
-PR_GW_MTSOUT_ENTRYID = PROP_TAG(PT_BINARY, pidStoreMin + 17)
-PR_TRANSFER_ENABLED = PROP_TAG(PT_BOOLEAN, pidStoreMin + 18)
-PR_TEST_LINE_SPEED = PROP_TAG(PT_BINARY, pidStoreMin + 19)
-PR_HIERARCHY_SYNCHRONIZER = PROP_TAG(PT_OBJECT, pidStoreMin + 20)
-PR_CONTENTS_SYNCHRONIZER = PROP_TAG(PT_OBJECT, pidStoreMin + 21)
-PR_COLLECTOR = PROP_TAG(PT_OBJECT, pidStoreMin + 22)
-PR_FAST_TRANSFER = PROP_TAG(PT_OBJECT, pidStoreMin + 23)
-PR_STORE_OFFLINE = PROP_TAG(PT_BOOLEAN, pidStoreMin + 26)
-PR_IN_TRANSIT = PROP_TAG(PT_BOOLEAN, pidStoreMin)
-PR_REPLICATION_STYLE = PROP_TAG(PT_LONG, pidAdminMin)
-PR_REPLICATION_SCHEDULE = PROP_TAG(PT_BINARY, pidAdminMin + 1)
-PR_REPLICATION_MESSAGE_PRIORITY = PROP_TAG(PT_LONG, pidAdminMin + 2)
-PR_OVERALL_MSG_AGE_LIMIT = PROP_TAG(PT_LONG, pidAdminMin + 3)
-PR_REPLICATION_ALWAYS_INTERVAL = PROP_TAG(PT_LONG, pidAdminMin + 4)
-PR_REPLICATION_MSG_SIZE = PROP_TAG(PT_LONG, pidAdminMin + 5)
-STYLE_ALWAYS_INTERVAL_DEFAULT = 15
-REPLICATION_MESSAGE_SIZE_LIMIT_DEFAULT = 100
-STYLE_NEVER = 0
-STYLE_NORMAL = 1
-STYLE_ALWAYS = 2
-STYLE_DEFAULT = -1
-PR_SOURCE_KEY = PROP_TAG(PT_BINARY, pidExchangeNonXmitReservedMin + 0)
-PR_PARENT_SOURCE_KEY = PROP_TAG(PT_BINARY, pidExchangeNonXmitReservedMin + 1)
-PR_CHANGE_KEY = PROP_TAG(PT_BINARY, pidExchangeNonXmitReservedMin + 2)
-PR_PREDECESSOR_CHANGE_LIST = PROP_TAG(PT_BINARY, pidExchangeNonXmitReservedMin + 3)
-PR_FOLDER_CHILD_COUNT = PROP_TAG(PT_LONG, pidFolderMin)
-PR_RIGHTS = PROP_TAG(PT_LONG, pidFolderMin + 1)
-PR_ACL_TABLE = PROP_TAG(PT_OBJECT, pidExchangeXmitReservedMin)
-PR_RULES_TABLE = PROP_TAG(PT_OBJECT, pidExchangeXmitReservedMin + 1)
-PR_HAS_RULES = PROP_TAG(PT_BOOLEAN, pidFolderMin + 2)
-PR_ADDRESS_BOOK_ENTRYID = PROP_TAG(PT_BINARY, pidFolderMin + 3)
-PR_ACL_DATA = PROP_TAG(PT_BINARY, pidExchangeXmitReservedMin)
-PR_RULES_DATA = PROP_TAG(PT_BINARY, pidExchangeXmitReservedMin + 1)
-PR_FOLDER_DESIGN_FLAGS = PROP_TAG(PT_LONG, pidExchangeXmitReservedMin + 2)
-PR_DESIGN_IN_PROGRESS = PROP_TAG(PT_BOOLEAN, pidExchangeXmitReservedMin + 4)
-PR_SECURE_ORIGINATION = PROP_TAG(PT_BOOLEAN, pidExchangeXmitReservedMin + 5)
-PR_PUBLISH_IN_ADDRESS_BOOK = PROP_TAG(PT_BOOLEAN, pidExchangeXmitReservedMin + 6)
-PR_RESOLVE_METHOD = PROP_TAG(PT_LONG, pidExchangeXmitReservedMin + 7)
-PR_ADDRESS_BOOK_DISPLAY_NAME = PROP_TAG(PT_TSTRING, pidExchangeXmitReservedMin + 8)
-PR_EFORMS_LOCALE_ID = PROP_TAG(PT_LONG, pidExchangeXmitReservedMin + 9)
-PR_REPLICA_LIST = PROP_TAG(PT_BINARY, pidAdminMin + 8)
-PR_OVERALL_AGE_LIMIT = PROP_TAG(PT_LONG, pidAdminMin + 9)
-RESOLVE_METHOD_DEFAULT = 0
-RESOLVE_METHOD_LAST_WRITER_WINS = 1
-RESOLVE_METHOD_NO_CONFLICT_NOTIFICATION = 2
-PR_PUBLIC_FOLDER_ENTRYID = PROP_TAG(PT_BINARY, pidFolderMin + 4)
-PR_HAS_NAMED_PROPERTIES = PROP_TAG(PT_BOOLEAN, pidMessageReadOnlyMin + 10)
-PR_CREATOR_NAME = PROP_TAG(PT_TSTRING, pidExchangeXmitReservedMin + 24)
-PR_CREATOR_ENTRYID = PROP_TAG(PT_BINARY, pidExchangeXmitReservedMin + 25)
-PR_LAST_MODIFIER_NAME = PROP_TAG(PT_TSTRING, pidExchangeXmitReservedMin + 26)
-PR_LAST_MODIFIER_ENTRYID = PROP_TAG(PT_BINARY, pidExchangeXmitReservedMin + 27)
-PR_HAS_DAMS = PROP_TAG(PT_BOOLEAN, pidExchangeXmitReservedMin + 10)
-PR_RULE_TRIGGER_HISTORY = PROP_TAG(PT_BINARY, pidExchangeXmitReservedMin + 18)
-PR_MOVE_TO_STORE_ENTRYID = PROP_TAG(PT_BINARY, pidExchangeXmitReservedMin + 19)
-PR_MOVE_TO_FOLDER_ENTRYID = PROP_TAG(PT_BINARY, pidExchangeXmitReservedMin + 20)
-PR_REPLICA_SERVER = PROP_TAG(PT_TSTRING, pidMessageReadOnlyMin + 4)
-PR_DEFERRED_SEND_NUMBER = PROP_TAG(PT_LONG, pidExchangeXmitReservedMin + 11)
-PR_DEFERRED_SEND_UNITS = PROP_TAG(PT_LONG, pidExchangeXmitReservedMin + 12)
-PR_EXPIRY_NUMBER = PROP_TAG(PT_LONG, pidExchangeXmitReservedMin + 13)
-PR_EXPIRY_UNITS = PROP_TAG(PT_LONG, pidExchangeXmitReservedMin + 14)
-PR_DEFERRED_SEND_TIME = PROP_TAG(PT_SYSTIME, pidExchangeXmitReservedMin + 15)
-PR_GW_ADMIN_OPERATIONS = PROP_TAG(PT_LONG, pidMessageWriteableMin)
-PR_P1_CONTENT = PROP_TAG(PT_BINARY, 4352)
-PR_P1_CONTENT_TYPE = PROP_TAG(PT_BINARY, 4353)
-PR_CLIENT_ACTIONS = PROP_TAG(PT_BINARY, pidMessageReadOnlyMin + 5)
-PR_DAM_ORIGINAL_ENTRYID = PROP_TAG(PT_BINARY, pidMessageReadOnlyMin + 6)
-PR_DAM_BACK_PATCHED = PROP_TAG(PT_BOOLEAN, pidMessageReadOnlyMin + 7)
-PR_RULE_ERROR = PROP_TAG(PT_LONG, pidMessageReadOnlyMin + 8)
-PR_RULE_ACTION_TYPE = PROP_TAG(PT_LONG, pidMessageReadOnlyMin + 9)
-PR_RULE_ACTION_NUMBER = PROP_TAG(PT_LONG, pidMessageReadOnlyMin + 16)
-PR_RULE_FOLDER_ENTRYID = PROP_TAG(PT_BINARY, pidMessageReadOnlyMin + 17)
-PR_CONFLICT_ENTRYID = PROP_TAG(PT_BINARY, pidExchangeXmitReservedMin + 16)
-PR_MESSAGE_LOCALE_ID = PROP_TAG(PT_LONG, pidExchangeXmitReservedMin + 17)
-PR_STORAGE_QUOTA_LIMIT = PROP_TAG(PT_LONG, pidExchangeXmitReservedMin + 21)
-PR_EXCESS_STORAGE_USED = PROP_TAG(PT_LONG, pidExchangeXmitReservedMin + 22)
-PR_SVR_GENERATING_QUOTA_MSG = PROP_TAG(PT_TSTRING, pidExchangeXmitReservedMin + 23)
-PR_DELEGATED_BY_RULE = PROP_TAG(PT_BOOLEAN, pidExchangeXmitReservedMin + 3)
-MSGSTATUS_IN_CONFLICT = 2048
-PR_IN_CONFLICT = PROP_TAG(PT_BOOLEAN, pidAttachReadOnlyMin)
-PR_LONGTERM_ENTRYID_FROM_TABLE = PROP_TAG(PT_BINARY, pidSpecialMin)
-PR_ORIGINATOR_NAME = PROP_TAG(PT_TSTRING, pidMessageWriteableMin + 3)
-PR_ORIGINATOR_ADDR = PROP_TAG(PT_TSTRING, pidMessageWriteableMin + 4)
-PR_ORIGINATOR_ADDRTYPE = PROP_TAG(PT_TSTRING, pidMessageWriteableMin + 5)
-PR_ORIGINATOR_ENTRYID = PROP_TAG(PT_BINARY, pidMessageWriteableMin + 6)
-PR_ARRIVAL_TIME = PROP_TAG(PT_SYSTIME, pidMessageWriteableMin + 7)
-PR_TRACE_INFO = PROP_TAG(PT_BINARY, pidMessageWriteableMin + 8)
-PR_INTERNAL_TRACE_INFO = PROP_TAG(PT_BINARY, pidMessageWriteableMin + 18)
-PR_SUBJECT_TRACE_INFO = PROP_TAG(PT_BINARY, pidMessageWriteableMin + 9)
-PR_RECIPIENT_NUMBER = PROP_TAG(PT_LONG, pidMessageWriteableMin + 10)
-PR_MTS_SUBJECT_ID = PROP_TAG(PT_BINARY, pidMessageWriteableMin + 11)
-PR_REPORT_DESTINATION_NAME = PROP_TAG(PT_TSTRING, pidMessageWriteableMin + 12)
-PR_REPORT_DESTINATION_ENTRYID = PROP_TAG(PT_BINARY, pidMessageWriteableMin + 13)
-PR_CONTENT_SEARCH_KEY = PROP_TAG(PT_BINARY, pidMessageWriteableMin + 14)
-PR_FOREIGN_ID = PROP_TAG(PT_BINARY, pidMessageWriteableMin + 15)
-PR_FOREIGN_REPORT_ID = PROP_TAG(PT_BINARY, pidMessageWriteableMin + 16)
-PR_FOREIGN_SUBJECT_ID = PROP_TAG(PT_BINARY, pidMessageWriteableMin + 17)
-PR_MTS_ID = PR_MESSAGE_SUBMISSION_ID
-PR_MTS_REPORT_ID = PR_MESSAGE_SUBMISSION_ID
-
-PR_FOLDER_FLAGS = PROP_TAG(PT_LONG, pidAdminMin + 24)
-PR_LAST_ACCESS_TIME = PROP_TAG(PT_SYSTIME, pidAdminMin + 25)
-PR_RESTRICTION_COUNT = PROP_TAG(PT_LONG, pidAdminMin + 26)
-PR_CATEG_COUNT = PROP_TAG(PT_LONG, pidAdminMin + 27)
-PR_CACHED_COLUMN_COUNT = PROP_TAG(PT_LONG, pidAdminMin + 28)
-PR_NORMAL_MSG_W_ATTACH_COUNT = PROP_TAG(PT_LONG, pidAdminMin + 29)
-PR_ASSOC_MSG_W_ATTACH_COUNT = PROP_TAG(PT_LONG, pidAdminMin + 30)
-PR_RECIPIENT_ON_NORMAL_MSG_COUNT = PROP_TAG(PT_LONG, pidAdminMin + 31)
-PR_RECIPIENT_ON_ASSOC_MSG_COUNT = PROP_TAG(PT_LONG, pidAdminMin + 32)
-PR_ATTACH_ON_NORMAL_MSG_COUNT = PROP_TAG(PT_LONG, pidAdminMin + 33)
-PR_ATTACH_ON_ASSOC_MSG_COUNT = PROP_TAG(PT_LONG, pidAdminMin + 34)
-PR_NORMAL_MESSAGE_SIZE = PROP_TAG(PT_LONG, pidAdminMin + 35)
-PR_NORMAL_MESSAGE_SIZE_EXTENDED = PROP_TAG(PT_I8, pidAdminMin + 35)
-PR_ASSOC_MESSAGE_SIZE = PROP_TAG(PT_LONG, pidAdminMin + 36)
-PR_ASSOC_MESSAGE_SIZE_EXTENDED = PROP_TAG(PT_I8, pidAdminMin + 36)
-PR_FOLDER_PATHNAME = PROP_TAG(PT_TSTRING, pidAdminMin + 37)
-PR_OWNER_COUNT = PROP_TAG(PT_LONG, pidAdminMin + 38)
-PR_CONTACT_COUNT = PROP_TAG(PT_LONG, pidAdminMin + 39)
-
-PR_MESSAGE_SIZE_EXTENDED = PROP_TAG(PT_I8, PROP_ID(PR_MESSAGE_SIZE))
-
-PR_USERFIELDS = PROP_TAG(PT_BINARY, 0x36E3)
-
-# IExchangeManageStoreEx::CreateStoreEntryID2
-PR_FORCE_USE_ENTRYID_SERVER = PROP_TAG(PT_BOOLEAN, 0x7CFE)
-PR_PROFILE_MDB_DN = PROP_TAG(PT_STRING8, 0x7CFF)
-
-# MSPST.h
-PST_EXTERN_PROPID_BASE = 0x6700
-PR_PST_PATH = PROP_TAG(PT_STRING8, PST_EXTERN_PROPID_BASE + 0)
-PR_PST_PATH_W = PROP_TAG(PT_UNICODE, PST_EXTERN_PROPID_BASE + 0)
-PR_PST_PATH_A = PROP_TAG(PT_STRING8, PST_EXTERN_PROPID_BASE + 0)
-PR_PST_REMEMBER_PW = PROP_TAG(PT_BOOLEAN, PST_EXTERN_PROPID_BASE + 1)
-PR_PST_ENCRYPTION = PROP_TAG(PT_LONG, PST_EXTERN_PROPID_BASE + 2)
-PR_PST_PW_SZ_OLD = PROP_TAG(PT_STRING8, PST_EXTERN_PROPID_BASE + 3)
-PR_PST_PW_SZ_OLD_W = PROP_TAG(PT_UNICODE, PST_EXTERN_PROPID_BASE + 3)
-PR_PST_PW_SZ_OLD_A = PROP_TAG(PT_STRING8, PST_EXTERN_PROPID_BASE + 3)
-PR_PST_PW_SZ_NEW = PROP_TAG(PT_STRING8, PST_EXTERN_PROPID_BASE + 4)
-PR_PST_PW_SZ_NEW_W = PROP_TAG(PT_UNICODE, PST_EXTERN_PROPID_BASE + 4)
-PR_PST_PW_SZ_NEW_A = PROP_TAG(PT_STRING8, PST_EXTERN_PROPID_BASE + 4)
diff --git a/lib/win32comext/mapi/mapiutil.py b/lib/win32comext/mapi/mapiutil.py
deleted file mode 100644
index ab89e6ad..00000000
--- a/lib/win32comext/mapi/mapiutil.py
+++ /dev/null
@@ -1,217 +0,0 @@
-# General utilities for MAPI and MAPI objects.
-# We used to use these old names from the 'types' module...
-TupleType = tuple
-ListType = list
-IntType = int
-import pythoncom
-from pywintypes import TimeType
-
-from . import mapi, mapitags
-
-prTable = {}
-
-
-def GetPropTagName(pt):
-    if not prTable:
-        for name, value in mapitags.__dict__.items():
-            if name[:3] == "PR_":
-                # Store both the full ID (including type) and just the ID.
-                # This is so PR_FOO_A and PR_FOO_W are still differentiated,
-                # but should we get a PT_FOO with PT_ERROR set, we fallback
-                # to the ID.
-
-                # String types should have 3 definitions in mapitags.py
-                # PR_BODY	= PROP_TAG( PT_TSTRING,	4096)
-                # PR_BODY_W	= PROP_TAG( PT_UNICODE, 4096)
-                # PR_BODY_A	= PROP_TAG( PT_STRING8, 4096)
-                # The following change ensures a lookup using only the the
-                # property id returns the conditional default.
-
-                # PT_TSTRING is a conditional assignment for either PT_UNICODE or
-                # PT_STRING8 and should not be returned during a lookup.
-
-                if (
-                    mapitags.PROP_TYPE(value) == mapitags.PT_UNICODE
-                    or mapitags.PROP_TYPE(value) == mapitags.PT_STRING8
-                ):
-                    if name[-2:] == "_A" or name[-2:] == "_W":
-                        prTable[value] = name
-                    else:
-                        prTable[mapitags.PROP_ID(value)] = name
-
-                else:
-                    prTable[value] = name
-                    prTable[mapitags.PROP_ID(value)] = name
-
-    try:
-        try:
-            return prTable[pt]
-        except KeyError:
-            # Can't find it exactly - see if the raw ID exists.
-            return prTable[mapitags.PROP_ID(pt)]
-    except KeyError:
-        # god-damn bullshit hex() warnings: I don't see a way to get the
-        # old behaviour without a warning!!
-        ret = hex(int(pt))
-        # -0x8000000L -> 0x80000000
-        if ret[0] == "-":
-            ret = ret[1:]
-        if ret[-1] == "L":
-            ret = ret[:-1]
-        return ret
-
-
-mapiErrorTable = {}
-
-
-def GetScodeString(hr):
-    if not mapiErrorTable:
-        for name, value in mapi.__dict__.items():
-            if name[:7] in ["MAPI_E_", "MAPI_W_"]:
-                mapiErrorTable[value] = name
-    return mapiErrorTable.get(hr, pythoncom.GetScodeString(hr))
-
-
-ptTable = {}
-
-
-def GetMapiTypeName(propType, rawType=True):
-    """Given a mapi type flag, return a string description of the type"""
-    if not ptTable:
-        for name, value in mapitags.__dict__.items():
-            if name[:3] == "PT_":
-                # PT_TSTRING is a conditional assignment
-                # for either PT_UNICODE or PT_STRING8 and
-                # should not be returned during a lookup.
-                if name in ["PT_TSTRING", "PT_MV_TSTRING"]:
-                    continue
-                ptTable[value] = name
-
-    if rawType:
-        propType = propType & ~mapitags.MV_FLAG
-    return ptTable.get(propType, str(hex(propType)))
-
-
-def GetProperties(obj, propList):
-    """Given a MAPI object and a list of properties, return a list of property values.
-
-    Allows a single property to be passed, and the result is a single object.
-
-    Each request property can be an integer or a string.  Of a string, it is
-    automatically converted to an integer via the GetIdsFromNames function.
-
-    If the property fetch fails, the result is None.
-    """
-    bRetList = 1
-    if type(propList) not in [TupleType, ListType]:
-        bRetList = 0
-        propList = (propList,)
-    realPropList = []
-    rc = []
-    for prop in propList:
-        if type(prop) != IntType:  # Integer
-            props = ((mapi.PS_PUBLIC_STRINGS, prop),)
-            propIds = obj.GetIDsFromNames(props, 0)
-            prop = mapitags.PROP_TAG(
-                mapitags.PT_UNSPECIFIED, mapitags.PROP_ID(propIds[0])
-            )
-        realPropList.append(prop)
-
-    hr, data = obj.GetProps(realPropList, 0)
-    if hr != 0:
-        data = None
-        return None
-    if bRetList:
-        return [v[1] for v in data]
-    else:
-        return data[0][1]
-
-
-def GetAllProperties(obj, make_tag_names=True):
-    tags = obj.GetPropList(0)
-    hr, data = obj.GetProps(tags)
-    ret = []
-    for tag, val in data:
-        if make_tag_names:
-            hr, tags, array = obj.GetNamesFromIDs((tag,))
-            if type(array[0][1]) == type(""):
-                name = array[0][1]
-            else:
-                name = GetPropTagName(tag)
-        else:
-            name = tag
-        ret.append((name, val))
-    return ret
-
-
-_MapiTypeMap = {
-    type(0.0): mapitags.PT_DOUBLE,
-    type(0): mapitags.PT_I4,
-    type("".encode("ascii")): mapitags.PT_STRING8,  # bytes
-    type(""): mapitags.PT_UNICODE,  # str
-    type(None): mapitags.PT_UNSPECIFIED,
-    # In Python 2.2.2, bool isn't a distinct type (type(1==1) is type(0)).
-    # (markh thinks the above is trying to say that in 2020, we probably *do*
-    # want bool in this map? :)
-}
-
-
-def SetPropertyValue(obj, prop, val):
-    if type(prop) != IntType:
-        props = ((mapi.PS_PUBLIC_STRINGS, prop),)
-        propIds = obj.GetIDsFromNames(props, mapi.MAPI_CREATE)
-        if val == (1 == 1) or val == (1 == 0):
-            type_tag = mapitags.PT_BOOLEAN
-        else:
-            type_tag = _MapiTypeMap.get(type(val))
-            if type_tag is None:
-                raise ValueError(
-                    "Don't know what to do with '%r' ('%s')" % (val, type(val))
-                )
-        prop = mapitags.PROP_TAG(type_tag, mapitags.PROP_ID(propIds[0]))
-    if val is None:
-        # Delete the property
-        obj.DeleteProps((prop,))
-    else:
-        obj.SetProps(((prop, val),))
-
-
-def SetProperties(msg, propDict):
-    """Given a Python dictionary, set the objects properties.
-
-    If the dictionary key is a string, then a property ID is queried
-    otherwise the ID is assumed native.
-
-    Coded for maximum efficiency wrt server calls - ie, maximum of
-    2 calls made to the object, regardless of the dictionary contents
-    (only 1 if dictionary full of int keys)
-    """
-
-    newProps = []
-    # First pass over the properties we should get IDs for.
-    for key, val in propDict.items():
-        if type(key) == str:
-            newProps.append((mapi.PS_PUBLIC_STRINGS, key))
-    # Query for the new IDs
-    if newProps:
-        newIds = msg.GetIDsFromNames(newProps, mapi.MAPI_CREATE)
-    newIdNo = 0
-    newProps = []
-    for key, val in propDict.items():
-        if type(key) == str:
-            type_val = type(val)
-            if type_val == str:
-                tagType = mapitags.PT_UNICODE
-            elif type_val == IntType:
-                tagType = mapitags.PT_I4
-            elif type_val == TimeType:
-                tagType = mapitags.PT_SYSTIME
-            else:
-                raise ValueError(
-                    "The type of object %s(%s) can not be written"
-                    % (repr(val), type_val)
-                )
-            key = mapitags.PROP_TAG(tagType, mapitags.PROP_ID(newIds[newIdNo]))
-            newIdNo = newIdNo + 1
-        newProps.append((key, val))
-    msg.SetProps(newProps)
diff --git a/lib/win32comext/propsys/__init__.py b/lib/win32comext/propsys/__init__.py
deleted file mode 100644
index 7e28f9b6..00000000
--- a/lib/win32comext/propsys/__init__.py
+++ /dev/null
@@ -1 +0,0 @@
-# this is a python package
diff --git a/lib/win32comext/propsys/propsys.pyd b/lib/win32comext/propsys/propsys.pyd
deleted file mode 100644
index 7a5f62e08680b2f6a48d0280b134decac12d3d2a..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 138752
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

diff --git a/lib/win32comext/propsys/pscon.py b/lib/win32comext/propsys/pscon.py
deleted file mode 100644
index 5aac4045..00000000
--- a/lib/win32comext/propsys/pscon.py
+++ /dev/null
@@ -1,838 +0,0 @@
-# hand generated from propsys.h
-
-## PROPENUMTYPE, used with IPropertyEnumType
-PET_DISCRETEVALUE = 0
-PET_RANGEDVALUE = 1
-PET_DEFAULTVALUE = 2
-PET_ENDRANGE = 3
-
-PDTF_DEFAULT = 0
-PDTF_MULTIPLEVALUES = 0x1
-PDTF_ISINNATE = 0x2
-PDTF_ISGROUP = 0x4
-PDTF_CANGROUPBY = 0x8
-PDTF_CANSTACKBY = 0x10
-PDTF_ISTREEPROPERTY = 0x20
-PDTF_INCLUDEINFULLTEXTQUERY = 0x40
-PDTF_ISVIEWABLE = 0x80
-PDTF_ISQUERYABLE = 0x100
-PDTF_ISSYSTEMPROPERTY = 0x80000000
-PDTF_MASK_ALL = 0x800001FF
-
-PDVF_DEFAULT = 0
-PDVF_CENTERALIGN = 0x1
-PDVF_RIGHTALIGN = 0x2
-PDVF_BEGINNEWGROUP = 0x4
-PDVF_FILLAREA = 0x8
-PDVF_SORTDESCENDING = 0x10
-PDVF_SHOWONLYIFPRESENT = 0x20
-PDVF_SHOWBYDEFAULT = 0x40
-PDVF_SHOWINPRIMARYLIST = 0x80
-PDVF_SHOWINSECONDARYLIST = 0x100
-PDVF_HIDELABEL = 0x200
-PDVF_HIDDEN = 0x800
-PDVF_CANWRAP = 0x1000
-PDVF_MASK_ALL = 0x1BFF
-
-PDDT_STRING = 0
-PDDT_NUMBER = 1
-PDDT_BOOLEAN = 2
-PDDT_DATETIME = 3
-PDDT_ENUMERATED = 4
-
-PDGR_DISCRETE = 0
-PDGR_ALPHANUMERIC = 1
-PDGR_SIZE = 2
-PDGR_DYNAMIC = 3
-PDGR_DATE = 4
-PDGR_PERCENT = 5
-PDGR_ENUMERATED = 6
-
-## PROPDESC_FORMAT_FLAGS
-PDFF_DEFAULT = 0
-PDFF_PREFIXNAME = 0x1
-PDFF_FILENAME = 0x2
-PDFF_ALWAYSKB = 0x4
-PDFF_RESERVED_RIGHTTOLEFT = 0x8
-PDFF_SHORTTIME = 0x10
-PDFF_LONGTIME = 0x20
-PDFF_HIDETIME = 0x40
-PDFF_SHORTDATE = 0x80
-PDFF_LONGDATE = 0x100
-PDFF_HIDEDATE = 0x200
-PDFF_RELATIVEDATE = 0x400
-PDFF_USEEDITINVITATION = 0x800
-PDFF_READONLY = 0x1000
-PDFF_NOAUTOREADINGORDER = 0x2000
-
-PDSD_GENERAL = 0
-PDSD_A_Z = 1
-PDSD_LOWEST_HIGHEST = 2
-PDSD_SMALLEST_BIGGEST = 3
-PDSD_OLDEST_NEWEST = 4
-
-PDRDT_GENERAL = 0
-PDRDT_DATE = 1
-PDRDT_SIZE = 2
-PDRDT_COUNT = 3
-PDRDT_REVISION = 4
-PDRDT_LENGTH = 5
-PDRDT_DURATION = 6
-PDRDT_SPEED = 7
-PDRDT_RATE = 8
-PDRDT_RATING = 9
-PDRDT_PRIORITY = 10
-
-PDAT_DEFAULT = 0
-PDAT_FIRST = 1
-PDAT_SUM = 2
-PDAT_AVERAGE = 3
-PDAT_DATERANGE = 4
-PDAT_UNION = 5
-PDAT_MAX = 6
-PDAT_MIN = 7
-
-PDCOT_NONE = 0
-PDCOT_STRING = 1
-PDCOT_SIZE = 2
-PDCOT_DATETIME = 3
-PDCOT_BOOLEAN = 4
-PDCOT_NUMBER = 5
-
-PDSIF_DEFAULT = 0
-PDSIF_ININVERTEDINDEX = 0x1
-PDSIF_ISCOLUMN = 0x2
-PDSIF_ISCOLUMNSPARSE = 0x4
-PDCIT_NONE = 0
-PDCIT_ONDISK = 1
-PDCIT_INMEMORY = 2
-
-## PROPDESC_ENUMFILTER, used with IPropertySystem::EnumeratePropertyDescriptions
-PDEF_ALL = 0
-PDEF_SYSTEM = 1
-PDEF_NONSYSTEM = 2
-PDEF_VIEWABLE = 3
-PDEF_QUERYABLE = 4
-PDEF_INFULLTEXTQUERY = 5
-PDEF_COLUMN = 6
-
-## PSC_STATE, used with IPropertyStoreCache
-PSC_NORMAL = 0
-PSC_NOTINSOURCE = 1
-PSC_DIRTY = 2
-
-## CONDITION_OPERATION
-COP_IMPLICIT = 0
-COP_EQUAL = 1
-COP_NOTEQUAL = 2
-COP_LESSTHAN = 3
-COP_GREATERTHAN = 4
-COP_LESSTHANOREQUAL = 5
-COP_GREATERTHANOREQUAL = 6
-COP_VALUE_STARTSWITH = 7
-COP_VALUE_ENDSWITH = 8
-COP_VALUE_CONTAINS = 9
-COP_VALUE_NOTCONTAINS = 10
-COP_DOSWILDCARDS = 11
-COP_WORD_EQUAL = 12
-COP_WORD_STARTSWITH = 13
-COP_APPLICATION_SPECIFIC = 14
-
-## PERSIST_SPROPSTORE_FLAGS, used with IPersistSerializedPropStorage
-FPSPS_READONLY = 1
-
-PKEY_PIDSTR_MAX = 10  # will take care of any long integer value
-# define GUIDSTRING_MAX      (1 + 8 + 1 + 4 + 1 + 4 + 1 + 4 + 1 + 12 + 1 + 1)  // "{12345678-1234-1234-1234-123456789012}"
-GUIDSTRING_MAX = 1 + 8 + 1 + 4 + 1 + 4 + 1 + 4 + 1 + 12 + 1 + 1  # hrm ???
-# define PKEYSTR_MAX         (GUIDSTRING_MAX + 1 + PKEY_PIDSTR_MAX)
-PKEYSTR_MAX = GUIDSTRING_MAX + 1 + PKEY_PIDSTR_MAX
-
-## Property keys from propkey.h
-from pywintypes import IID
-
-PKEY_Audio_ChannelCount = (IID("{64440490-4C8B-11D1-8B70-080036B11A03}"), 7)
-PKEY_Audio_Compression = (IID("{64440490-4C8B-11D1-8B70-080036B11A03}"), 10)
-PKEY_Audio_EncodingBitrate = (IID("{64440490-4C8B-11D1-8B70-080036B11A03}"), 4)
-PKEY_Audio_Format = (IID("{64440490-4C8B-11D1-8B70-080036B11A03}"), 2)
-PKEY_Audio_IsVariableBitRate = (IID("{E6822FEE-8C17-4D62-823C-8E9CFCBD1D5C}"), 100)
-PKEY_Audio_PeakValue = (IID("{2579E5D0-1116-4084-BD9A-9B4F7CB4DF5E}"), 100)
-PKEY_Audio_SampleRate = (IID("{64440490-4C8B-11D1-8B70-080036B11A03}"), 5)
-PKEY_Audio_SampleSize = (IID("{64440490-4C8B-11D1-8B70-080036B11A03}"), 6)
-PKEY_Audio_StreamName = (IID("{64440490-4C8B-11D1-8B70-080036B11A03}"), 9)
-PKEY_Audio_StreamNumber = (IID("{64440490-4C8B-11D1-8B70-080036B11A03}"), 8)
-PKEY_Calendar_Duration = (IID("{293CA35A-09AA-4DD2-B180-1FE245728A52}"), 100)
-PKEY_Calendar_IsOnline = (IID("{BFEE9149-E3E2-49A7-A862-C05988145CEC}"), 100)
-PKEY_Calendar_IsRecurring = (IID("{315B9C8D-80A9-4EF9-AE16-8E746DA51D70}"), 100)
-PKEY_Calendar_Location = (IID("{F6272D18-CECC-40B1-B26A-3911717AA7BD}"), 100)
-PKEY_Calendar_OptionalAttendeeAddresses = (
-    IID("{D55BAE5A-3892-417A-A649-C6AC5AAAEAB3}"),
-    100,
-)
-PKEY_Calendar_OptionalAttendeeNames = (
-    IID("{09429607-582D-437F-84C3-DE93A2B24C3C}"),
-    100,
-)
-PKEY_Calendar_OrganizerAddress = (IID("{744C8242-4DF5-456C-AB9E-014EFB9021E3}"), 100)
-PKEY_Calendar_OrganizerName = (IID("{AAA660F9-9865-458E-B484-01BC7FE3973E}"), 100)
-PKEY_Calendar_ReminderTime = (IID("{72FC5BA4-24F9-4011-9F3F-ADD27AFAD818}"), 100)
-PKEY_Calendar_RequiredAttendeeAddresses = (
-    IID("{0BA7D6C3-568D-4159-AB91-781A91FB71E5}"),
-    100,
-)
-PKEY_Calendar_RequiredAttendeeNames = (
-    IID("{B33AF30B-F552-4584-936C-CB93E5CDA29F}"),
-    100,
-)
-PKEY_Calendar_Resources = (IID("{00F58A38-C54B-4C40-8696-97235980EAE1}"), 100)
-PKEY_Calendar_ShowTimeAs = (IID("{5BF396D4-5EB2-466F-BDE9-2FB3F2361D6E}"), 100)
-PKEY_Calendar_ShowTimeAsText = (IID("{53DA57CF-62C0-45C4-81DE-7610BCEFD7F5}"), 100)
-PKEY_Communication_AccountName = (IID("{E3E0584C-B788-4A5A-BB20-7F5A44C9ACDD}"), 9)
-PKEY_Communication_Suffix = (IID("{807B653A-9E91-43EF-8F97-11CE04EE20C5}"), 100)
-PKEY_Communication_TaskStatus = (IID("{BE1A72C6-9A1D-46B7-AFE7-AFAF8CEF4999}"), 100)
-PKEY_Communication_TaskStatusText = (IID("{A6744477-C237-475B-A075-54F34498292A}"), 100)
-PKEY_Computer_DecoratedFreeSpace = (IID("{9B174B35-40FF-11D2-A27E-00C04FC30871}"), 7)
-PKEY_Contact_Anniversary = (IID("{9AD5BADB-CEA7-4470-A03D-B84E51B9949E}"), 100)
-PKEY_Contact_AssistantName = (IID("{CD102C9C-5540-4A88-A6F6-64E4981C8CD1}"), 100)
-PKEY_Contact_AssistantTelephone = (IID("{9A93244D-A7AD-4FF8-9B99-45EE4CC09AF6}"), 100)
-PKEY_Contact_Birthday = (IID("{176DC63C-2688-4E89-8143-A347800F25E9}"), 47)
-PKEY_Contact_BusinessAddress = (IID("{730FB6DD-CF7C-426B-A03F-BD166CC9EE24}"), 100)
-PKEY_Contact_BusinessAddressCity = (IID("{402B5934-EC5A-48C3-93E6-85E86A2D934E}"), 100)
-PKEY_Contact_BusinessAddressCountry = (
-    IID("{B0B87314-FCF6-4FEB-8DFF-A50DA6AF561C}"),
-    100,
-)
-PKEY_Contact_BusinessAddressPostalCode = (
-    IID("{E1D4A09E-D758-4CD1-B6EC-34A8B5A73F80}"),
-    100,
-)
-PKEY_Contact_BusinessAddressPostOfficeBox = (
-    IID("{BC4E71CE-17F9-48D5-BEE9-021DF0EA5409}"),
-    100,
-)
-PKEY_Contact_BusinessAddressState = (IID("{446F787F-10C4-41CB-A6C4-4D0343551597}"), 100)
-PKEY_Contact_BusinessAddressStreet = (
-    IID("{DDD1460F-C0BF-4553-8CE4-10433C908FB0}"),
-    100,
-)
-PKEY_Contact_BusinessFaxNumber = (IID("{91EFF6F3-2E27-42CA-933E-7C999FBE310B}"), 100)
-PKEY_Contact_BusinessHomePage = (IID("{56310920-2491-4919-99CE-EADB06FAFDB2}"), 100)
-PKEY_Contact_BusinessTelephone = (IID("{6A15E5A0-0A1E-4CD7-BB8C-D2F1B0C929BC}"), 100)
-PKEY_Contact_CallbackTelephone = (IID("{BF53D1C3-49E0-4F7F-8567-5A821D8AC542}"), 100)
-PKEY_Contact_CarTelephone = (IID("{8FDC6DEA-B929-412B-BA90-397A257465FE}"), 100)
-PKEY_Contact_Children = (IID("{D4729704-8EF1-43EF-9024-2BD381187FD5}"), 100)
-PKEY_Contact_CompanyMainTelephone = (IID("{8589E481-6040-473D-B171-7FA89C2708ED}"), 100)
-PKEY_Contact_Department = (IID("{FC9F7306-FF8F-4D49-9FB6-3FFE5C0951EC}"), 100)
-PKEY_Contact_EmailAddress = (IID("{F8FA7FA3-D12B-4785-8A4E-691A94F7A3E7}"), 100)
-PKEY_Contact_EmailAddress2 = (IID("{38965063-EDC8-4268-8491-B7723172CF29}"), 100)
-PKEY_Contact_EmailAddress3 = (IID("{644D37B4-E1B3-4BAD-B099-7E7C04966ACA}"), 100)
-PKEY_Contact_EmailAddresses = (IID("{84D8F337-981D-44B3-9615-C7596DBA17E3}"), 100)
-PKEY_Contact_EmailName = (IID("{CC6F4F24-6083-4BD4-8754-674D0DE87AB8}"), 100)
-PKEY_Contact_FileAsName = (IID("{F1A24AA7-9CA7-40F6-89EC-97DEF9FFE8DB}"), 100)
-PKEY_Contact_FirstName = (IID("{14977844-6B49-4AAD-A714-A4513BF60460}"), 100)
-PKEY_Contact_FullName = (IID("{635E9051-50A5-4BA2-B9DB-4ED056C77296}"), 100)
-PKEY_Contact_Gender = (IID("{3C8CEE58-D4F0-4CF9-B756-4E5D24447BCD}"), 100)
-PKEY_Contact_Hobbies = (IID("{5DC2253F-5E11-4ADF-9CFE-910DD01E3E70}"), 100)
-PKEY_Contact_HomeAddress = (IID("{98F98354-617A-46B8-8560-5B1B64BF1F89}"), 100)
-PKEY_Contact_HomeAddressCity = (IID("{176DC63C-2688-4E89-8143-A347800F25E9}"), 65)
-PKEY_Contact_HomeAddressCountry = (IID("{08A65AA1-F4C9-43DD-9DDF-A33D8E7EAD85}"), 100)
-PKEY_Contact_HomeAddressPostalCode = (
-    IID("{8AFCC170-8A46-4B53-9EEE-90BAE7151E62}"),
-    100,
-)
-PKEY_Contact_HomeAddressPostOfficeBox = (
-    IID("{7B9F6399-0A3F-4B12-89BD-4ADC51C918AF}"),
-    100,
-)
-PKEY_Contact_HomeAddressState = (IID("{C89A23D0-7D6D-4EB8-87D4-776A82D493E5}"), 100)
-PKEY_Contact_HomeAddressStreet = (IID("{0ADEF160-DB3F-4308-9A21-06237B16FA2A}"), 100)
-PKEY_Contact_HomeFaxNumber = (IID("{660E04D6-81AB-4977-A09F-82313113AB26}"), 100)
-PKEY_Contact_HomeTelephone = (IID("{176DC63C-2688-4E89-8143-A347800F25E9}"), 20)
-PKEY_Contact_IMAddress = (IID("{D68DBD8A-3374-4B81-9972-3EC30682DB3D}"), 100)
-PKEY_Contact_Initials = (IID("{F3D8F40D-50CB-44A2-9718-40CB9119495D}"), 100)
-PKEY_Contact_JA_CompanyNamePhonetic = (IID("{897B3694-FE9E-43E6-8066-260F590C0100}"), 2)
-PKEY_Contact_JA_FirstNamePhonetic = (IID("{897B3694-FE9E-43E6-8066-260F590C0100}"), 3)
-PKEY_Contact_JA_LastNamePhonetic = (IID("{897B3694-FE9E-43E6-8066-260F590C0100}"), 4)
-PKEY_Contact_JobTitle = (IID("{176DC63C-2688-4E89-8143-A347800F25E9}"), 6)
-PKEY_Contact_Label = (IID("{97B0AD89-DF49-49CC-834E-660974FD755B}"), 100)
-PKEY_Contact_LastName = (IID("{8F367200-C270-457C-B1D4-E07C5BCD90C7}"), 100)
-PKEY_Contact_MailingAddress = (IID("{C0AC206A-827E-4650-95AE-77E2BB74FCC9}"), 100)
-PKEY_Contact_MiddleName = (IID("{176DC63C-2688-4E89-8143-A347800F25E9}"), 71)
-PKEY_Contact_MobileTelephone = (IID("{176DC63C-2688-4E89-8143-A347800F25E9}"), 35)
-PKEY_Contact_NickName = (IID("{176DC63C-2688-4E89-8143-A347800F25E9}"), 74)
-PKEY_Contact_OfficeLocation = (IID("{176DC63C-2688-4E89-8143-A347800F25E9}"), 7)
-PKEY_Contact_OtherAddress = (IID("{508161FA-313B-43D5-83A1-C1ACCF68622C}"), 100)
-PKEY_Contact_OtherAddressCity = (IID("{6E682923-7F7B-4F0C-A337-CFCA296687BF}"), 100)
-PKEY_Contact_OtherAddressCountry = (IID("{8F167568-0AAE-4322-8ED9-6055B7B0E398}"), 100)
-PKEY_Contact_OtherAddressPostalCode = (
-    IID("{95C656C1-2ABF-4148-9ED3-9EC602E3B7CD}"),
-    100,
-)
-PKEY_Contact_OtherAddressPostOfficeBox = (
-    IID("{8B26EA41-058F-43F6-AECC-4035681CE977}"),
-    100,
-)
-PKEY_Contact_OtherAddressState = (IID("{71B377D6-E570-425F-A170-809FAE73E54E}"), 100)
-PKEY_Contact_OtherAddressStreet = (IID("{FF962609-B7D6-4999-862D-95180D529AEA}"), 100)
-PKEY_Contact_PagerTelephone = (IID("{D6304E01-F8F5-4F45-8B15-D024A6296789}"), 100)
-PKEY_Contact_PersonalTitle = (IID("{176DC63C-2688-4E89-8143-A347800F25E9}"), 69)
-PKEY_Contact_PrimaryAddressCity = (IID("{C8EA94F0-A9E3-4969-A94B-9C62A95324E0}"), 100)
-PKEY_Contact_PrimaryAddressCountry = (
-    IID("{E53D799D-0F3F-466E-B2FF-74634A3CB7A4}"),
-    100,
-)
-PKEY_Contact_PrimaryAddressPostalCode = (
-    IID("{18BBD425-ECFD-46EF-B612-7B4A6034EDA0}"),
-    100,
-)
-PKEY_Contact_PrimaryAddressPostOfficeBox = (
-    IID("{DE5EF3C7-46E1-484E-9999-62C5308394C1}"),
-    100,
-)
-PKEY_Contact_PrimaryAddressState = (IID("{F1176DFE-7138-4640-8B4C-AE375DC70A6D}"), 100)
-PKEY_Contact_PrimaryAddressStreet = (IID("{63C25B20-96BE-488F-8788-C09C407AD812}"), 100)
-PKEY_Contact_PrimaryEmailAddress = (IID("{176DC63C-2688-4E89-8143-A347800F25E9}"), 48)
-PKEY_Contact_PrimaryTelephone = (IID("{176DC63C-2688-4E89-8143-A347800F25E9}"), 25)
-PKEY_Contact_Profession = (IID("{7268AF55-1CE4-4F6E-A41F-B6E4EF10E4A9}"), 100)
-PKEY_Contact_SpouseName = (IID("{9D2408B6-3167-422B-82B0-F583B7A7CFE3}"), 100)
-PKEY_Contact_Suffix = (IID("{176DC63C-2688-4E89-8143-A347800F25E9}"), 73)
-PKEY_Contact_TelexNumber = (IID("{C554493C-C1F7-40C1-A76C-EF8C0614003E}"), 100)
-PKEY_Contact_TTYTDDTelephone = (IID("{AAF16BAC-2B55-45E6-9F6D-415EB94910DF}"), 100)
-PKEY_Contact_WebPage = (IID("{E3E0584C-B788-4A5A-BB20-7F5A44C9ACDD}"), 18)
-PKEY_AcquisitionID = (IID("{65A98875-3C80-40AB-ABBC-EFDAF77DBEE2}"), 100)
-PKEY_ApplicationName = (IID("{F29F85E0-4FF9-1068-AB91-08002B27B3D9}"), 18)
-PKEY_Author = (IID("{F29F85E0-4FF9-1068-AB91-08002B27B3D9}"), 4)
-PKEY_Capacity = (IID("{9B174B35-40FF-11D2-A27E-00C04FC30871}"), 3)
-PKEY_Category = (IID("{D5CDD502-2E9C-101B-9397-08002B2CF9AE}"), 2)
-PKEY_Comment = (IID("{F29F85E0-4FF9-1068-AB91-08002B27B3D9}"), 6)
-PKEY_Company = (IID("{D5CDD502-2E9C-101B-9397-08002B2CF9AE}"), 15)
-PKEY_ComputerName = (IID("{28636AA6-953D-11D2-B5D6-00C04FD918D0}"), 5)
-PKEY_ContainedItems = (IID("{28636AA6-953D-11D2-B5D6-00C04FD918D0}"), 29)
-PKEY_ContentStatus = (IID("{D5CDD502-2E9C-101B-9397-08002B2CF9AE}"), 27)
-PKEY_ContentType = (IID("{D5CDD502-2E9C-101B-9397-08002B2CF9AE}"), 26)
-PKEY_Copyright = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 11)
-PKEY_DateAccessed = (IID("{B725F130-47EF-101A-A5F1-02608C9EEBAC}"), 16)
-PKEY_DateAcquired = (IID("{2CBAA8F5-D81F-47CA-B17A-F8D822300131}"), 100)
-PKEY_DateArchived = (IID("{43F8D7B7-A444-4F87-9383-52271C9B915C}"), 100)
-PKEY_DateCompleted = (IID("{72FAB781-ACDA-43E5-B155-B2434F85E678}"), 100)
-PKEY_DateCreated = (IID("{B725F130-47EF-101A-A5F1-02608C9EEBAC}"), 15)
-PKEY_DateImported = (IID("{14B81DA1-0135-4D31-96D9-6CBFC9671A99}"), 18258)
-PKEY_DateModified = (IID("{B725F130-47EF-101A-A5F1-02608C9EEBAC}"), 14)
-PKEY_DueDate = (IID("{3F8472B5-E0AF-4DB2-8071-C53FE76AE7CE}"), 100)
-PKEY_EndDate = (IID("{C75FAA05-96FD-49E7-9CB4-9F601082D553}"), 100)
-PKEY_FileAllocationSize = (IID("{B725F130-47EF-101A-A5F1-02608C9EEBAC}"), 18)
-PKEY_FileAttributes = (IID("{B725F130-47EF-101A-A5F1-02608C9EEBAC}"), 13)
-PKEY_FileCount = (IID("{28636AA6-953D-11D2-B5D6-00C04FD918D0}"), 12)
-PKEY_FileDescription = (IID("{0CEF7D53-FA64-11D1-A203-0000F81FEDEE}"), 3)
-PKEY_FileExtension = (IID("{E4F10A3C-49E6-405D-8288-A23BD4EEAA6C}"), 100)
-PKEY_FileFRN = (IID("{B725F130-47EF-101A-A5F1-02608C9EEBAC}"), 21)
-PKEY_FileName = (IID("{41CF5AE0-F75A-4806-BD87-59C7D9248EB9}"), 100)
-PKEY_FileOwner = (IID("{9B174B34-40FF-11D2-A27E-00C04FC30871}"), 4)
-PKEY_FileVersion = (IID("{0CEF7D53-FA64-11D1-A203-0000F81FEDEE}"), 4)
-PKEY_FindData = (IID("{28636AA6-953D-11D2-B5D6-00C04FD918D0}"), 0)
-PKEY_FlagColor = (IID("{67DF94DE-0CA7-4D6F-B792-053A3E4F03CF}"), 100)
-PKEY_FlagColorText = (IID("{45EAE747-8E2A-40AE-8CBF-CA52ABA6152A}"), 100)
-PKEY_FlagStatus = (IID("{E3E0584C-B788-4A5A-BB20-7F5A44C9ACDD}"), 12)
-PKEY_FlagStatusText = (IID("{DC54FD2E-189D-4871-AA01-08C2F57A4ABC}"), 100)
-PKEY_FreeSpace = (IID("{9B174B35-40FF-11D2-A27E-00C04FC30871}"), 2)
-PKEY_Identity = (IID("{A26F4AFC-7346-4299-BE47-EB1AE613139F}"), 100)
-PKEY_Importance = (IID("{E3E0584C-B788-4A5A-BB20-7F5A44C9ACDD}"), 11)
-PKEY_ImportanceText = (IID("{A3B29791-7713-4E1D-BB40-17DB85F01831}"), 100)
-PKEY_IsAttachment = (IID("{F23F425C-71A1-4FA8-922F-678EA4A60408}"), 100)
-PKEY_IsDeleted = (IID("{5CDA5FC8-33EE-4FF3-9094-AE7BD8868C4D}"), 100)
-PKEY_IsFlagged = (IID("{5DA84765-E3FF-4278-86B0-A27967FBDD03}"), 100)
-PKEY_IsFlaggedComplete = (IID("{A6F360D2-55F9-48DE-B909-620E090A647C}"), 100)
-PKEY_IsIncomplete = (IID("{346C8BD1-2E6A-4C45-89A4-61B78E8E700F}"), 100)
-PKEY_IsRead = (IID("{E3E0584C-B788-4A5A-BB20-7F5A44C9ACDD}"), 10)
-PKEY_IsSendToTarget = (IID("{28636AA6-953D-11D2-B5D6-00C04FD918D0}"), 33)
-PKEY_IsShared = (IID("{EF884C5B-2BFE-41BB-AAE5-76EEDF4F9902}"), 100)
-PKEY_ItemAuthors = (IID("{D0A04F0A-462A-48A4-BB2F-3706E88DBD7D}"), 100)
-PKEY_ItemDate = (IID("{F7DB74B4-4287-4103-AFBA-F1B13DCD75CF}"), 100)
-PKEY_ItemFolderNameDisplay = (IID("{B725F130-47EF-101A-A5F1-02608C9EEBAC}"), 2)
-PKEY_ItemFolderPathDisplay = (IID("{E3E0584C-B788-4A5A-BB20-7F5A44C9ACDD}"), 6)
-PKEY_ItemFolderPathDisplayNarrow = (IID("{DABD30ED-0043-4789-A7F8-D013A4736622}"), 100)
-PKEY_ItemName = (IID("{6B8DA074-3B5C-43BC-886F-0A2CDCE00B6F}"), 100)
-PKEY_ItemNameDisplay = (IID("{B725F130-47EF-101A-A5F1-02608C9EEBAC}"), 10)
-PKEY_ItemNamePrefix = (IID("{D7313FF1-A77A-401C-8C99-3DBDD68ADD36}"), 100)
-PKEY_ItemParticipants = (IID("{D4D0AA16-9948-41A4-AA85-D97FF9646993}"), 100)
-PKEY_ItemPathDisplay = (IID("{E3E0584C-B788-4A5A-BB20-7F5A44C9ACDD}"), 7)
-PKEY_ItemPathDisplayNarrow = (IID("{28636AA6-953D-11D2-B5D6-00C04FD918D0}"), 8)
-PKEY_ItemType = (IID("{28636AA6-953D-11D2-B5D6-00C04FD918D0}"), 11)
-PKEY_ItemTypeText = (IID("{B725F130-47EF-101A-A5F1-02608C9EEBAC}"), 4)
-PKEY_ItemUrl = (IID("{49691C90-7E17-101A-A91C-08002B2ECDA9}"), 9)
-PKEY_Keywords = (IID("{F29F85E0-4FF9-1068-AB91-08002B27B3D9}"), 5)
-PKEY_Kind = (IID("{1E3EE840-BC2B-476C-8237-2ACD1A839B22}"), 3)
-PKEY_KindText = (IID("{F04BEF95-C585-4197-A2B7-DF46FDC9EE6D}"), 100)
-PKEY_Language = (IID("{D5CDD502-2E9C-101B-9397-08002B2CF9AE}"), 28)
-PKEY_MileageInformation = (IID("{FDF84370-031A-4ADD-9E91-0D775F1C6605}"), 100)
-PKEY_MIMEType = (IID("{0B63E350-9CCC-11D0-BCDB-00805FCCCE04}"), 5)
-PKEY_Null = (IID("{00000000-0000-0000-0000-000000000000}"), 0)
-PKEY_OfflineAvailability = (IID("{A94688B6-7D9F-4570-A648-E3DFC0AB2B3F}"), 100)
-PKEY_OfflineStatus = (IID("{6D24888F-4718-4BDA-AFED-EA0FB4386CD8}"), 100)
-PKEY_OriginalFileName = (IID("{0CEF7D53-FA64-11D1-A203-0000F81FEDEE}"), 6)
-PKEY_ParentalRating = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 21)
-PKEY_ParentalRatingReason = (IID("{10984E0A-F9F2-4321-B7EF-BAF195AF4319}"), 100)
-PKEY_ParentalRatingsOrganization = (IID("{A7FE0840-1344-46F0-8D37-52ED712A4BF9}"), 100)
-PKEY_ParsingBindContext = (IID("{DFB9A04D-362F-4CA3-B30B-0254B17B5B84}"), 100)
-PKEY_ParsingName = (IID("{28636AA6-953D-11D2-B5D6-00C04FD918D0}"), 24)
-PKEY_ParsingPath = (IID("{28636AA6-953D-11D2-B5D6-00C04FD918D0}"), 30)
-PKEY_PerceivedType = (IID("{28636AA6-953D-11D2-B5D6-00C04FD918D0}"), 9)
-PKEY_PercentFull = (IID("{9B174B35-40FF-11D2-A27E-00C04FC30871}"), 5)
-PKEY_Priority = (IID("{9C1FCF74-2D97-41BA-B4AE-CB2E3661A6E4}"), 5)
-PKEY_PriorityText = (IID("{D98BE98B-B86B-4095-BF52-9D23B2E0A752}"), 100)
-PKEY_Project = (IID("{39A7F922-477C-48DE-8BC8-B28441E342E3}"), 100)
-PKEY_ProviderItemID = (IID("{F21D9941-81F0-471A-ADEE-4E74B49217ED}"), 100)
-PKEY_Rating = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 9)
-PKEY_RatingText = (IID("{90197CA7-FD8F-4E8C-9DA3-B57E1E609295}"), 100)
-PKEY_Sensitivity = (IID("{F8D3F6AC-4874-42CB-BE59-AB454B30716A}"), 100)
-PKEY_SensitivityText = (IID("{D0C7F054-3F72-4725-8527-129A577CB269}"), 100)
-PKEY_SFGAOFlags = (IID("{28636AA6-953D-11D2-B5D6-00C04FD918D0}"), 25)
-PKEY_SharedWith = (IID("{EF884C5B-2BFE-41BB-AAE5-76EEDF4F9902}"), 200)
-PKEY_ShareUserRating = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 12)
-PKEY_Shell_OmitFromView = (IID("{DE35258C-C695-4CBC-B982-38B0AD24CED0}"), 2)
-PKEY_SimpleRating = (IID("{A09F084E-AD41-489F-8076-AA5BE3082BCA}"), 100)
-PKEY_Size = (IID("{B725F130-47EF-101A-A5F1-02608C9EEBAC}"), 12)
-PKEY_SoftwareUsed = (IID("{14B81DA1-0135-4D31-96D9-6CBFC9671A99}"), 305)
-PKEY_SourceItem = (IID("{668CDFA5-7A1B-4323-AE4B-E527393A1D81}"), 100)
-PKEY_StartDate = (IID("{48FD6EC8-8A12-4CDF-A03E-4EC5A511EDDE}"), 100)
-PKEY_Status = (IID("{000214A1-0000-0000-C000-000000000046}"), 9)
-PKEY_Subject = (IID("{F29F85E0-4FF9-1068-AB91-08002B27B3D9}"), 3)
-PKEY_Thumbnail = (IID("{F29F85E0-4FF9-1068-AB91-08002B27B3D9}"), 17)
-PKEY_ThumbnailCacheId = (IID("{446D16B1-8DAD-4870-A748-402EA43D788C}"), 100)
-PKEY_ThumbnailStream = (IID("{F29F85E0-4FF9-1068-AB91-08002B27B3D9}"), 27)
-PKEY_Title = (IID("{F29F85E0-4FF9-1068-AB91-08002B27B3D9}"), 2)
-PKEY_TotalFileSize = (IID("{28636AA6-953D-11D2-B5D6-00C04FD918D0}"), 14)
-PKEY_Trademarks = (IID("{0CEF7D53-FA64-11D1-A203-0000F81FEDEE}"), 9)
-PKEY_Document_ByteCount = (IID("{D5CDD502-2E9C-101B-9397-08002B2CF9AE}"), 4)
-PKEY_Document_CharacterCount = (IID("{F29F85E0-4FF9-1068-AB91-08002B27B3D9}"), 16)
-PKEY_Document_ClientID = (IID("{276D7BB0-5B34-4FB0-AA4B-158ED12A1809}"), 100)
-PKEY_Document_Contributor = (IID("{F334115E-DA1B-4509-9B3D-119504DC7ABB}"), 100)
-PKEY_Document_DateCreated = (IID("{F29F85E0-4FF9-1068-AB91-08002B27B3D9}"), 12)
-PKEY_Document_DatePrinted = (IID("{F29F85E0-4FF9-1068-AB91-08002B27B3D9}"), 11)
-PKEY_Document_DateSaved = (IID("{F29F85E0-4FF9-1068-AB91-08002B27B3D9}"), 13)
-PKEY_Document_Division = (IID("{1E005EE6-BF27-428B-B01C-79676ACD2870}"), 100)
-PKEY_Document_DocumentID = (IID("{E08805C8-E395-40DF-80D2-54F0D6C43154}"), 100)
-PKEY_Document_HiddenSlideCount = (IID("{D5CDD502-2E9C-101B-9397-08002B2CF9AE}"), 9)
-PKEY_Document_LastAuthor = (IID("{F29F85E0-4FF9-1068-AB91-08002B27B3D9}"), 8)
-PKEY_Document_LineCount = (IID("{D5CDD502-2E9C-101B-9397-08002B2CF9AE}"), 5)
-PKEY_Document_Manager = (IID("{D5CDD502-2E9C-101B-9397-08002B2CF9AE}"), 14)
-PKEY_Document_MultimediaClipCount = (IID("{D5CDD502-2E9C-101B-9397-08002B2CF9AE}"), 10)
-PKEY_Document_NoteCount = (IID("{D5CDD502-2E9C-101B-9397-08002B2CF9AE}"), 8)
-PKEY_Document_PageCount = (IID("{F29F85E0-4FF9-1068-AB91-08002B27B3D9}"), 14)
-PKEY_Document_ParagraphCount = (IID("{D5CDD502-2E9C-101B-9397-08002B2CF9AE}"), 6)
-PKEY_Document_PresentationFormat = (IID("{D5CDD502-2E9C-101B-9397-08002B2CF9AE}"), 3)
-PKEY_Document_RevisionNumber = (IID("{F29F85E0-4FF9-1068-AB91-08002B27B3D9}"), 9)
-PKEY_Document_Security = (IID("{F29F85E0-4FF9-1068-AB91-08002B27B3D9}"), 19)
-PKEY_Document_SlideCount = (IID("{D5CDD502-2E9C-101B-9397-08002B2CF9AE}"), 7)
-PKEY_Document_Template = (IID("{F29F85E0-4FF9-1068-AB91-08002B27B3D9}"), 7)
-PKEY_Document_TotalEditingTime = (IID("{F29F85E0-4FF9-1068-AB91-08002B27B3D9}"), 10)
-PKEY_Document_Version = (IID("{D5CDD502-2E9C-101B-9397-08002B2CF9AE}"), 29)
-PKEY_Document_WordCount = (IID("{F29F85E0-4FF9-1068-AB91-08002B27B3D9}"), 15)
-PKEY_DRM_DatePlayExpires = (IID("{AEAC19E4-89AE-4508-B9B7-BB867ABEE2ED}"), 6)
-PKEY_DRM_DatePlayStarts = (IID("{AEAC19E4-89AE-4508-B9B7-BB867ABEE2ED}"), 5)
-PKEY_DRM_Description = (IID("{AEAC19E4-89AE-4508-B9B7-BB867ABEE2ED}"), 3)
-PKEY_DRM_IsProtected = (IID("{AEAC19E4-89AE-4508-B9B7-BB867ABEE2ED}"), 2)
-PKEY_DRM_PlayCount = (IID("{AEAC19E4-89AE-4508-B9B7-BB867ABEE2ED}"), 4)
-PKEY_GPS_Altitude = (IID("{827EDB4F-5B73-44A7-891D-FDFFABEA35CA}"), 100)
-PKEY_GPS_AltitudeDenominator = (IID("{78342DCB-E358-4145-AE9A-6BFE4E0F9F51}"), 100)
-PKEY_GPS_AltitudeNumerator = (IID("{2DAD1EB7-816D-40D3-9EC3-C9773BE2AADE}"), 100)
-PKEY_GPS_AltitudeRef = (IID("{46AC629D-75EA-4515-867F-6DC4321C5844}"), 100)
-PKEY_GPS_AreaInformation = (IID("{972E333E-AC7E-49F1-8ADF-A70D07A9BCAB}"), 100)
-PKEY_GPS_Date = (IID("{3602C812-0F3B-45F0-85AD-603468D69423}"), 100)
-PKEY_GPS_DestBearing = (IID("{C66D4B3C-E888-47CC-B99F-9DCA3EE34DEA}"), 100)
-PKEY_GPS_DestBearingDenominator = (IID("{7ABCF4F8-7C3F-4988-AC91-8D2C2E97ECA5}"), 100)
-PKEY_GPS_DestBearingNumerator = (IID("{BA3B1DA9-86EE-4B5D-A2A4-A271A429F0CF}"), 100)
-PKEY_GPS_DestBearingRef = (IID("{9AB84393-2A0F-4B75-BB22-7279786977CB}"), 100)
-PKEY_GPS_DestDistance = (IID("{A93EAE04-6804-4F24-AC81-09B266452118}"), 100)
-PKEY_GPS_DestDistanceDenominator = (IID("{9BC2C99B-AC71-4127-9D1C-2596D0D7DCB7}"), 100)
-PKEY_GPS_DestDistanceNumerator = (IID("{2BDA47DA-08C6-4FE1-80BC-A72FC517C5D0}"), 100)
-PKEY_GPS_DestDistanceRef = (IID("{ED4DF2D3-8695-450B-856F-F5C1C53ACB66}"), 100)
-PKEY_GPS_DestLatitude = (IID("{9D1D7CC5-5C39-451C-86B3-928E2D18CC47}"), 100)
-PKEY_GPS_DestLatitudeDenominator = (IID("{3A372292-7FCA-49A7-99D5-E47BB2D4E7AB}"), 100)
-PKEY_GPS_DestLatitudeNumerator = (IID("{ECF4B6F6-D5A6-433C-BB92-4076650FC890}"), 100)
-PKEY_GPS_DestLatitudeRef = (IID("{CEA820B9-CE61-4885-A128-005D9087C192}"), 100)
-PKEY_GPS_DestLongitude = (IID("{47A96261-CB4C-4807-8AD3-40B9D9DBC6BC}"), 100)
-PKEY_GPS_DestLongitudeDenominator = (IID("{425D69E5-48AD-4900-8D80-6EB6B8D0AC86}"), 100)
-PKEY_GPS_DestLongitudeNumerator = (IID("{A3250282-FB6D-48D5-9A89-DBCACE75CCCF}"), 100)
-PKEY_GPS_DestLongitudeRef = (IID("{182C1EA6-7C1C-4083-AB4B-AC6C9F4ED128}"), 100)
-PKEY_GPS_Differential = (IID("{AAF4EE25-BD3B-4DD7-BFC4-47F77BB00F6D}"), 100)
-PKEY_GPS_DOP = (IID("{0CF8FB02-1837-42F1-A697-A7017AA289B9}"), 100)
-PKEY_GPS_DOPDenominator = (IID("{A0BE94C5-50BA-487B-BD35-0654BE8881ED}"), 100)
-PKEY_GPS_DOPNumerator = (IID("{47166B16-364F-4AA0-9F31-E2AB3DF449C3}"), 100)
-PKEY_GPS_ImgDirection = (IID("{16473C91-D017-4ED9-BA4D-B6BAA55DBCF8}"), 100)
-PKEY_GPS_ImgDirectionDenominator = (IID("{10B24595-41A2-4E20-93C2-5761C1395F32}"), 100)
-PKEY_GPS_ImgDirectionNumerator = (IID("{DC5877C7-225F-45F7-BAC7-E81334B6130A}"), 100)
-PKEY_GPS_ImgDirectionRef = (IID("{A4AAA5B7-1AD0-445F-811A-0F8F6E67F6B5}"), 100)
-PKEY_GPS_Latitude = (IID("{8727CFFF-4868-4EC6-AD5B-81B98521D1AB}"), 100)
-PKEY_GPS_LatitudeDenominator = (IID("{16E634EE-2BFF-497B-BD8A-4341AD39EEB9}"), 100)
-PKEY_GPS_LatitudeNumerator = (IID("{7DDAAAD1-CCC8-41AE-B750-B2CB8031AEA2}"), 100)
-PKEY_GPS_LatitudeRef = (IID("{029C0252-5B86-46C7-ACA0-2769FFC8E3D4}"), 100)
-PKEY_GPS_Longitude = (IID("{C4C4DBB2-B593-466B-BBDA-D03D27D5E43A}"), 100)
-PKEY_GPS_LongitudeDenominator = (IID("{BE6E176C-4534-4D2C-ACE5-31DEDAC1606B}"), 100)
-PKEY_GPS_LongitudeNumerator = (IID("{02B0F689-A914-4E45-821D-1DDA452ED2C4}"), 100)
-PKEY_GPS_LongitudeRef = (IID("{33DCF22B-28D5-464C-8035-1EE9EFD25278}"), 100)
-PKEY_GPS_MapDatum = (IID("{2CA2DAE6-EDDC-407D-BEF1-773942ABFA95}"), 100)
-PKEY_GPS_MeasureMode = (IID("{A015ED5D-AAEA-4D58-8A86-3C586920EA0B}"), 100)
-PKEY_GPS_ProcessingMethod = (IID("{59D49E61-840F-4AA9-A939-E2099B7F6399}"), 100)
-PKEY_GPS_Satellites = (IID("{467EE575-1F25-4557-AD4E-B8B58B0D9C15}"), 100)
-PKEY_GPS_Speed = (IID("{DA5D0862-6E76-4E1B-BABD-70021BD25494}"), 100)
-PKEY_GPS_SpeedDenominator = (IID("{7D122D5A-AE5E-4335-8841-D71E7CE72F53}"), 100)
-PKEY_GPS_SpeedNumerator = (IID("{ACC9CE3D-C213-4942-8B48-6D0820F21C6D}"), 100)
-PKEY_GPS_SpeedRef = (IID("{ECF7F4C9-544F-4D6D-9D98-8AD79ADAF453}"), 100)
-PKEY_GPS_Status = (IID("{125491F4-818F-46B2-91B5-D537753617B2}"), 100)
-PKEY_GPS_Track = (IID("{76C09943-7C33-49E3-9E7E-CDBA872CFADA}"), 100)
-PKEY_GPS_TrackDenominator = (IID("{C8D1920C-01F6-40C0-AC86-2F3A4AD00770}"), 100)
-PKEY_GPS_TrackNumerator = (IID("{702926F4-44A6-43E1-AE71-45627116893B}"), 100)
-PKEY_GPS_TrackRef = (IID("{35DBE6FE-44C3-4400-AAAE-D2C799C407E8}"), 100)
-PKEY_GPS_VersionID = (IID("{22704DA4-C6B2-4A99-8E56-F16DF8C92599}"), 100)
-PKEY_Image_BitDepth = (IID("{6444048F-4C8B-11D1-8B70-080036B11A03}"), 7)
-PKEY_Image_ColorSpace = (IID("{14B81DA1-0135-4D31-96D9-6CBFC9671A99}"), 40961)
-PKEY_Image_CompressedBitsPerPixel = (IID("{364B6FA9-37AB-482A-BE2B-AE02F60D4318}"), 100)
-PKEY_Image_CompressedBitsPerPixelDenominator = (
-    IID("{1F8844E1-24AD-4508-9DFD-5326A415CE02}"),
-    100,
-)
-PKEY_Image_CompressedBitsPerPixelNumerator = (
-    IID("{D21A7148-D32C-4624-8900-277210F79C0F}"),
-    100,
-)
-PKEY_Image_Compression = (IID("{14B81DA1-0135-4D31-96D9-6CBFC9671A99}"), 259)
-PKEY_Image_CompressionText = (IID("{3F08E66F-2F44-4BB9-A682-AC35D2562322}"), 100)
-PKEY_Image_Dimensions = (IID("{6444048F-4C8B-11D1-8B70-080036B11A03}"), 13)
-PKEY_Image_HorizontalResolution = (IID("{6444048F-4C8B-11D1-8B70-080036B11A03}"), 5)
-PKEY_Image_HorizontalSize = (IID("{6444048F-4C8B-11D1-8B70-080036B11A03}"), 3)
-PKEY_Image_ImageID = (IID("{10DABE05-32AA-4C29-BF1A-63E2D220587F}"), 100)
-PKEY_Image_ResolutionUnit = (IID("{19B51FA6-1F92-4A5C-AB48-7DF0ABD67444}"), 100)
-PKEY_Image_VerticalResolution = (IID("{6444048F-4C8B-11D1-8B70-080036B11A03}"), 6)
-PKEY_Image_VerticalSize = (IID("{6444048F-4C8B-11D1-8B70-080036B11A03}"), 4)
-PKEY_Journal_Contacts = (IID("{DEA7C82C-1D89-4A66-9427-A4E3DEBABCB1}"), 100)
-PKEY_Journal_EntryType = (IID("{95BEB1FC-326D-4644-B396-CD3ED90E6DDF}"), 100)
-PKEY_Link_Comment = (IID("{B9B4B3FC-2B51-4A42-B5D8-324146AFCF25}"), 5)
-PKEY_Link_DateVisited = (IID("{5CBF2787-48CF-4208-B90E-EE5E5D420294}"), 23)
-PKEY_Link_Description = (IID("{5CBF2787-48CF-4208-B90E-EE5E5D420294}"), 21)
-PKEY_Link_Status = (IID("{B9B4B3FC-2B51-4A42-B5D8-324146AFCF25}"), 3)
-PKEY_Link_TargetExtension = (IID("{7A7D76F4-B630-4BD7-95FF-37CC51A975C9}"), 2)
-PKEY_Link_TargetParsingPath = (IID("{B9B4B3FC-2B51-4A42-B5D8-324146AFCF25}"), 2)
-PKEY_Link_TargetSFGAOFlags = (IID("{B9B4B3FC-2B51-4A42-B5D8-324146AFCF25}"), 8)
-PKEY_Media_AuthorUrl = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 32)
-PKEY_Media_AverageLevel = (IID("{09EDD5B6-B301-43C5-9990-D00302EFFD46}"), 100)
-PKEY_Media_ClassPrimaryID = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 13)
-PKEY_Media_ClassSecondaryID = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 14)
-PKEY_Media_CollectionGroupID = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 24)
-PKEY_Media_CollectionID = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 25)
-PKEY_Media_ContentDistributor = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 18)
-PKEY_Media_ContentID = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 26)
-PKEY_Media_CreatorApplication = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 27)
-PKEY_Media_CreatorApplicationVersion = (
-    IID("{64440492-4C8B-11D1-8B70-080036B11A03}"),
-    28,
-)
-PKEY_Media_DateEncoded = (IID("{2E4B640D-5019-46D8-8881-55414CC5CAA0}"), 100)
-PKEY_Media_DateReleased = (IID("{DE41CC29-6971-4290-B472-F59F2E2F31E2}"), 100)
-PKEY_Media_Duration = (IID("{64440490-4C8B-11D1-8B70-080036B11A03}"), 3)
-PKEY_Media_DVDID = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 15)
-PKEY_Media_EncodedBy = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 36)
-PKEY_Media_EncodingSettings = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 37)
-PKEY_Media_FrameCount = (IID("{6444048F-4C8B-11D1-8B70-080036B11A03}"), 12)
-PKEY_Media_MCDI = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 16)
-PKEY_Media_MetadataContentProvider = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 17)
-PKEY_Media_Producer = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 22)
-PKEY_Media_PromotionUrl = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 33)
-PKEY_Media_ProtectionType = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 38)
-PKEY_Media_ProviderRating = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 39)
-PKEY_Media_ProviderStyle = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 40)
-PKEY_Media_Publisher = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 30)
-PKEY_Media_SubscriptionContentId = (IID("{9AEBAE7A-9644-487D-A92C-657585ED751A}"), 100)
-PKEY_Media_SubTitle = (IID("{56A3372E-CE9C-11D2-9F0E-006097C686F6}"), 38)
-PKEY_Media_UniqueFileIdentifier = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 35)
-PKEY_Media_UserNoAutoInfo = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 41)
-PKEY_Media_UserWebUrl = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 34)
-PKEY_Media_Writer = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 23)
-PKEY_Media_Year = (IID("{56A3372E-CE9C-11D2-9F0E-006097C686F6}"), 5)
-PKEY_Message_AttachmentContents = (IID("{3143BF7C-80A8-4854-8880-E2E40189BDD0}"), 100)
-PKEY_Message_AttachmentNames = (IID("{E3E0584C-B788-4A5A-BB20-7F5A44C9ACDD}"), 21)
-PKEY_Message_BccAddress = (IID("{E3E0584C-B788-4A5A-BB20-7F5A44C9ACDD}"), 2)
-PKEY_Message_BccName = (IID("{E3E0584C-B788-4A5A-BB20-7F5A44C9ACDD}"), 3)
-PKEY_Message_CcAddress = (IID("{E3E0584C-B788-4A5A-BB20-7F5A44C9ACDD}"), 4)
-PKEY_Message_CcName = (IID("{E3E0584C-B788-4A5A-BB20-7F5A44C9ACDD}"), 5)
-PKEY_Message_ConversationID = (IID("{DC8F80BD-AF1E-4289-85B6-3DFC1B493992}"), 100)
-PKEY_Message_ConversationIndex = (IID("{DC8F80BD-AF1E-4289-85B6-3DFC1B493992}"), 101)
-PKEY_Message_DateReceived = (IID("{E3E0584C-B788-4A5A-BB20-7F5A44C9ACDD}"), 20)
-PKEY_Message_DateSent = (IID("{E3E0584C-B788-4A5A-BB20-7F5A44C9ACDD}"), 19)
-PKEY_Message_FromAddress = (IID("{E3E0584C-B788-4A5A-BB20-7F5A44C9ACDD}"), 13)
-PKEY_Message_FromName = (IID("{E3E0584C-B788-4A5A-BB20-7F5A44C9ACDD}"), 14)
-PKEY_Message_HasAttachments = (IID("{9C1FCF74-2D97-41BA-B4AE-CB2E3661A6E4}"), 8)
-PKEY_Message_IsFwdOrReply = (IID("{9A9BC088-4F6D-469E-9919-E705412040F9}"), 100)
-PKEY_Message_MessageClass = (IID("{CD9ED458-08CE-418F-A70E-F912C7BB9C5C}"), 103)
-PKEY_Message_SenderAddress = (IID("{0BE1C8E7-1981-4676-AE14-FDD78F05A6E7}"), 100)
-PKEY_Message_SenderName = (IID("{0DA41CFA-D224-4A18-AE2F-596158DB4B3A}"), 100)
-PKEY_Message_Store = (IID("{E3E0584C-B788-4A5A-BB20-7F5A44C9ACDD}"), 15)
-PKEY_Message_ToAddress = (IID("{E3E0584C-B788-4A5A-BB20-7F5A44C9ACDD}"), 16)
-PKEY_Message_ToDoTitle = (IID("{BCCC8A3C-8CEF-42E5-9B1C-C69079398BC7}"), 100)
-PKEY_Message_ToName = (IID("{E3E0584C-B788-4A5A-BB20-7F5A44C9ACDD}"), 17)
-PKEY_Music_AlbumArtist = (IID("{56A3372E-CE9C-11D2-9F0E-006097C686F6}"), 13)
-PKEY_Music_AlbumTitle = (IID("{56A3372E-CE9C-11D2-9F0E-006097C686F6}"), 4)
-PKEY_Music_Artist = (IID("{56A3372E-CE9C-11D2-9F0E-006097C686F6}"), 2)
-PKEY_Music_BeatsPerMinute = (IID("{56A3372E-CE9C-11D2-9F0E-006097C686F6}"), 35)
-PKEY_Music_Composer = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 19)
-PKEY_Music_Conductor = (IID("{56A3372E-CE9C-11D2-9F0E-006097C686F6}"), 36)
-PKEY_Music_ContentGroupDescription = (IID("{56A3372E-CE9C-11D2-9F0E-006097C686F6}"), 33)
-PKEY_Music_Genre = (IID("{56A3372E-CE9C-11D2-9F0E-006097C686F6}"), 11)
-PKEY_Music_InitialKey = (IID("{56A3372E-CE9C-11D2-9F0E-006097C686F6}"), 34)
-PKEY_Music_Lyrics = (IID("{56A3372E-CE9C-11D2-9F0E-006097C686F6}"), 12)
-PKEY_Music_Mood = (IID("{56A3372E-CE9C-11D2-9F0E-006097C686F6}"), 39)
-PKEY_Music_PartOfSet = (IID("{56A3372E-CE9C-11D2-9F0E-006097C686F6}"), 37)
-PKEY_Music_Period = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 31)
-PKEY_Music_SynchronizedLyrics = (IID("{6B223B6A-162E-4AA9-B39F-05D678FC6D77}"), 100)
-PKEY_Music_TrackNumber = (IID("{56A3372E-CE9C-11D2-9F0E-006097C686F6}"), 7)
-PKEY_Note_Color = (IID("{4776CAFA-BCE4-4CB1-A23E-265E76D8EB11}"), 100)
-PKEY_Note_ColorText = (IID("{46B4E8DE-CDB2-440D-885C-1658EB65B914}"), 100)
-PKEY_Photo_Aperture = (IID("{14B81DA1-0135-4D31-96D9-6CBFC9671A99}"), 37378)
-PKEY_Photo_ApertureDenominator = (IID("{E1A9A38B-6685-46BD-875E-570DC7AD7320}"), 100)
-PKEY_Photo_ApertureNumerator = (IID("{0337ECEC-39FB-4581-A0BD-4C4CC51E9914}"), 100)
-PKEY_Photo_Brightness = (IID("{1A701BF6-478C-4361-83AB-3701BB053C58}"), 100)
-PKEY_Photo_BrightnessDenominator = (IID("{6EBE6946-2321-440A-90F0-C043EFD32476}"), 100)
-PKEY_Photo_BrightnessNumerator = (IID("{9E7D118F-B314-45A0-8CFB-D654B917C9E9}"), 100)
-PKEY_Photo_CameraManufacturer = (IID("{14B81DA1-0135-4D31-96D9-6CBFC9671A99}"), 271)
-PKEY_Photo_CameraModel = (IID("{14B81DA1-0135-4D31-96D9-6CBFC9671A99}"), 272)
-PKEY_Photo_CameraSerialNumber = (IID("{14B81DA1-0135-4D31-96D9-6CBFC9671A99}"), 273)
-PKEY_Photo_Contrast = (IID("{2A785BA9-8D23-4DED-82E6-60A350C86A10}"), 100)
-PKEY_Photo_ContrastText = (IID("{59DDE9F2-5253-40EA-9A8B-479E96C6249A}"), 100)
-PKEY_Photo_DateTaken = (IID("{14B81DA1-0135-4D31-96D9-6CBFC9671A99}"), 36867)
-PKEY_Photo_DigitalZoom = (IID("{F85BF840-A925-4BC2-B0C4-8E36B598679E}"), 100)
-PKEY_Photo_DigitalZoomDenominator = (IID("{745BAF0E-E5C1-4CFB-8A1B-D031A0A52393}"), 100)
-PKEY_Photo_DigitalZoomNumerator = (IID("{16CBB924-6500-473B-A5BE-F1599BCBE413}"), 100)
-PKEY_Photo_Event = (IID("{14B81DA1-0135-4D31-96D9-6CBFC9671A99}"), 18248)
-PKEY_Photo_EXIFVersion = (IID("{D35F743A-EB2E-47F2-A286-844132CB1427}"), 100)
-PKEY_Photo_ExposureBias = (IID("{14B81DA1-0135-4D31-96D9-6CBFC9671A99}"), 37380)
-PKEY_Photo_ExposureBiasDenominator = (
-    IID("{AB205E50-04B7-461C-A18C-2F233836E627}"),
-    100,
-)
-PKEY_Photo_ExposureBiasNumerator = (IID("{738BF284-1D87-420B-92CF-5834BF6EF9ED}"), 100)
-PKEY_Photo_ExposureIndex = (IID("{967B5AF8-995A-46ED-9E11-35B3C5B9782D}"), 100)
-PKEY_Photo_ExposureIndexDenominator = (
-    IID("{93112F89-C28B-492F-8A9D-4BE2062CEE8A}"),
-    100,
-)
-PKEY_Photo_ExposureIndexNumerator = (IID("{CDEDCF30-8919-44DF-8F4C-4EB2FFDB8D89}"), 100)
-PKEY_Photo_ExposureProgram = (IID("{14B81DA1-0135-4D31-96D9-6CBFC9671A99}"), 34850)
-PKEY_Photo_ExposureProgramText = (IID("{FEC690B7-5F30-4646-AE47-4CAAFBA884A3}"), 100)
-PKEY_Photo_ExposureTime = (IID("{14B81DA1-0135-4D31-96D9-6CBFC9671A99}"), 33434)
-PKEY_Photo_ExposureTimeDenominator = (
-    IID("{55E98597-AD16-42E0-B624-21599A199838}"),
-    100,
-)
-PKEY_Photo_ExposureTimeNumerator = (IID("{257E44E2-9031-4323-AC38-85C552871B2E}"), 100)
-PKEY_Photo_Flash = (IID("{14B81DA1-0135-4D31-96D9-6CBFC9671A99}"), 37385)
-PKEY_Photo_FlashEnergy = (IID("{14B81DA1-0135-4D31-96D9-6CBFC9671A99}"), 41483)
-PKEY_Photo_FlashEnergyDenominator = (IID("{D7B61C70-6323-49CD-A5FC-C84277162C97}"), 100)
-PKEY_Photo_FlashEnergyNumerator = (IID("{FCAD3D3D-0858-400F-AAA3-2F66CCE2A6BC}"), 100)
-PKEY_Photo_FlashManufacturer = (IID("{AABAF6C9-E0C5-4719-8585-57B103E584FE}"), 100)
-PKEY_Photo_FlashModel = (IID("{FE83BB35-4D1A-42E2-916B-06F3E1AF719E}"), 100)
-PKEY_Photo_FlashText = (IID("{6B8B68F6-200B-47EA-8D25-D8050F57339F}"), 100)
-PKEY_Photo_FNumber = (IID("{14B81DA1-0135-4D31-96D9-6CBFC9671A99}"), 33437)
-PKEY_Photo_FNumberDenominator = (IID("{E92A2496-223B-4463-A4E3-30EABBA79D80}"), 100)
-PKEY_Photo_FNumberNumerator = (IID("{1B97738A-FDFC-462F-9D93-1957E08BE90C}"), 100)
-PKEY_Photo_FocalLength = (IID("{14B81DA1-0135-4D31-96D9-6CBFC9671A99}"), 37386)
-PKEY_Photo_FocalLengthDenominator = (IID("{305BC615-DCA1-44A5-9FD4-10C0BA79412E}"), 100)
-PKEY_Photo_FocalLengthInFilm = (IID("{A0E74609-B84D-4F49-B860-462BD9971F98}"), 100)
-PKEY_Photo_FocalLengthNumerator = (IID("{776B6B3B-1E3D-4B0C-9A0E-8FBAF2A8492A}"), 100)
-PKEY_Photo_FocalPlaneXResolution = (IID("{CFC08D97-C6F7-4484-89DD-EBEF4356FE76}"), 100)
-PKEY_Photo_FocalPlaneXResolutionDenominator = (
-    IID("{0933F3F5-4786-4F46-A8E8-D64DD37FA521}"),
-    100,
-)
-PKEY_Photo_FocalPlaneXResolutionNumerator = (
-    IID("{DCCB10AF-B4E2-4B88-95F9-031B4D5AB490}"),
-    100,
-)
-PKEY_Photo_FocalPlaneYResolution = (IID("{4FFFE4D0-914F-4AC4-8D6F-C9C61DE169B1}"), 100)
-PKEY_Photo_FocalPlaneYResolutionDenominator = (
-    IID("{1D6179A6-A876-4031-B013-3347B2B64DC8}"),
-    100,
-)
-PKEY_Photo_FocalPlaneYResolutionNumerator = (
-    IID("{A2E541C5-4440-4BA8-867E-75CFC06828CD}"),
-    100,
-)
-PKEY_Photo_GainControl = (IID("{FA304789-00C7-4D80-904A-1E4DCC7265AA}"), 100)
-PKEY_Photo_GainControlDenominator = (IID("{42864DFD-9DA4-4F77-BDED-4AAD7B256735}"), 100)
-PKEY_Photo_GainControlNumerator = (IID("{8E8ECF7C-B7B8-4EB8-A63F-0EE715C96F9E}"), 100)
-PKEY_Photo_GainControlText = (IID("{C06238B2-0BF9-4279-A723-25856715CB9D}"), 100)
-PKEY_Photo_ISOSpeed = (IID("{14B81DA1-0135-4D31-96D9-6CBFC9671A99}"), 34855)
-PKEY_Photo_LensManufacturer = (IID("{E6DDCAF7-29C5-4F0A-9A68-D19412EC7090}"), 100)
-PKEY_Photo_LensModel = (IID("{E1277516-2B5F-4869-89B1-2E585BD38B7A}"), 100)
-PKEY_Photo_LightSource = (IID("{14B81DA1-0135-4D31-96D9-6CBFC9671A99}"), 37384)
-PKEY_Photo_MakerNote = (IID("{FA303353-B659-4052-85E9-BCAC79549B84}"), 100)
-PKEY_Photo_MakerNoteOffset = (IID("{813F4124-34E6-4D17-AB3E-6B1F3C2247A1}"), 100)
-PKEY_Photo_MaxAperture = (IID("{08F6D7C2-E3F2-44FC-AF1E-5AA5C81A2D3E}"), 100)
-PKEY_Photo_MaxApertureDenominator = (IID("{C77724D4-601F-46C5-9B89-C53F93BCEB77}"), 100)
-PKEY_Photo_MaxApertureNumerator = (IID("{C107E191-A459-44C5-9AE6-B952AD4B906D}"), 100)
-PKEY_Photo_MeteringMode = (IID("{14B81DA1-0135-4D31-96D9-6CBFC9671A99}"), 37383)
-PKEY_Photo_MeteringModeText = (IID("{F628FD8C-7BA8-465A-A65B-C5AA79263A9E}"), 100)
-PKEY_Photo_Orientation = (IID("{14B81DA1-0135-4D31-96D9-6CBFC9671A99}"), 274)
-PKEY_Photo_OrientationText = (IID("{A9EA193C-C511-498A-A06B-58E2776DCC28}"), 100)
-PKEY_Photo_PhotometricInterpretation = (
-    IID("{341796F1-1DF9-4B1C-A564-91BDEFA43877}"),
-    100,
-)
-PKEY_Photo_PhotometricInterpretationText = (
-    IID("{821437D6-9EAB-4765-A589-3B1CBBD22A61}"),
-    100,
-)
-PKEY_Photo_ProgramMode = (IID("{6D217F6D-3F6A-4825-B470-5F03CA2FBE9B}"), 100)
-PKEY_Photo_ProgramModeText = (IID("{7FE3AA27-2648-42F3-89B0-454E5CB150C3}"), 100)
-PKEY_Photo_RelatedSoundFile = (IID("{318A6B45-087F-4DC2-B8CC-05359551FC9E}"), 100)
-PKEY_Photo_Saturation = (IID("{49237325-A95A-4F67-B211-816B2D45D2E0}"), 100)
-PKEY_Photo_SaturationText = (IID("{61478C08-B600-4A84-BBE4-E99C45F0A072}"), 100)
-PKEY_Photo_Sharpness = (IID("{FC6976DB-8349-4970-AE97-B3C5316A08F0}"), 100)
-PKEY_Photo_SharpnessText = (IID("{51EC3F47-DD50-421D-8769-334F50424B1E}"), 100)
-PKEY_Photo_ShutterSpeed = (IID("{14B81DA1-0135-4D31-96D9-6CBFC9671A99}"), 37377)
-PKEY_Photo_ShutterSpeedDenominator = (
-    IID("{E13D8975-81C7-4948-AE3F-37CAE11E8FF7}"),
-    100,
-)
-PKEY_Photo_ShutterSpeedNumerator = (IID("{16EA4042-D6F4-4BCA-8349-7C78D30FB333}"), 100)
-PKEY_Photo_SubjectDistance = (IID("{14B81DA1-0135-4D31-96D9-6CBFC9671A99}"), 37382)
-PKEY_Photo_SubjectDistanceDenominator = (
-    IID("{0C840A88-B043-466D-9766-D4B26DA3FA77}"),
-    100,
-)
-PKEY_Photo_SubjectDistanceNumerator = (
-    IID("{8AF4961C-F526-43E5-AA81-DB768219178D}"),
-    100,
-)
-PKEY_Photo_TranscodedForSync = (IID("{9A8EBB75-6458-4E82-BACB-35C0095B03BB}"), 100)
-PKEY_Photo_WhiteBalance = (IID("{EE3D3D8A-5381-4CFA-B13B-AAF66B5F4EC9}"), 100)
-PKEY_Photo_WhiteBalanceText = (IID("{6336B95E-C7A7-426D-86FD-7AE3D39C84B4}"), 100)
-PKEY_PropGroup_Advanced = (IID("{900A403B-097B-4B95-8AE2-071FDAEEB118}"), 100)
-PKEY_PropGroup_Audio = (IID("{2804D469-788F-48AA-8570-71B9C187E138}"), 100)
-PKEY_PropGroup_Calendar = (IID("{9973D2B5-BFD8-438A-BA94-5349B293181A}"), 100)
-PKEY_PropGroup_Camera = (IID("{DE00DE32-547E-4981-AD4B-542F2E9007D8}"), 100)
-PKEY_PropGroup_Contact = (IID("{DF975FD3-250A-4004-858F-34E29A3E37AA}"), 100)
-PKEY_PropGroup_Content = (IID("{D0DAB0BA-368A-4050-A882-6C010FD19A4F}"), 100)
-PKEY_PropGroup_Description = (IID("{8969B275-9475-4E00-A887-FF93B8B41E44}"), 100)
-PKEY_PropGroup_FileSystem = (IID("{E3A7D2C1-80FC-4B40-8F34-30EA111BDC2E}"), 100)
-PKEY_PropGroup_General = (IID("{CC301630-B192-4C22-B372-9F4C6D338E07}"), 100)
-PKEY_PropGroup_GPS = (IID("{F3713ADA-90E3-4E11-AAE5-FDC17685B9BE}"), 100)
-PKEY_PropGroup_Image = (IID("{E3690A87-0FA8-4A2A-9A9F-FCE8827055AC}"), 100)
-PKEY_PropGroup_Media = (IID("{61872CF7-6B5E-4B4B-AC2D-59DA84459248}"), 100)
-PKEY_PropGroup_MediaAdvanced = (IID("{8859A284-DE7E-4642-99BA-D431D044B1EC}"), 100)
-PKEY_PropGroup_Message = (IID("{7FD7259D-16B4-4135-9F97-7C96ECD2FA9E}"), 100)
-PKEY_PropGroup_Music = (IID("{68DD6094-7216-40F1-A029-43FE7127043F}"), 100)
-PKEY_PropGroup_Origin = (IID("{2598D2FB-5569-4367-95DF-5CD3A177E1A5}"), 100)
-PKEY_PropGroup_PhotoAdvanced = (IID("{0CB2BF5A-9EE7-4A86-8222-F01E07FDADAF}"), 100)
-PKEY_PropGroup_RecordedTV = (IID("{E7B33238-6584-4170-A5C0-AC25EFD9DA56}"), 100)
-PKEY_PropGroup_Video = (IID("{BEBE0920-7671-4C54-A3EB-49FDDFC191EE}"), 100)
-PKEY_PropList_ConflictPrompt = (IID("{C9944A21-A406-48FE-8225-AEC7E24C211B}"), 11)
-PKEY_PropList_ExtendedTileInfo = (IID("{C9944A21-A406-48FE-8225-AEC7E24C211B}"), 9)
-PKEY_PropList_FileOperationPrompt = (IID("{C9944A21-A406-48FE-8225-AEC7E24C211B}"), 10)
-PKEY_PropList_FullDetails = (IID("{C9944A21-A406-48FE-8225-AEC7E24C211B}"), 2)
-PKEY_PropList_InfoTip = (IID("{C9944A21-A406-48FE-8225-AEC7E24C211B}"), 4)
-PKEY_PropList_NonPersonal = (IID("{49D1091F-082E-493F-B23F-D2308AA9668C}"), 100)
-PKEY_PropList_PreviewDetails = (IID("{C9944A21-A406-48FE-8225-AEC7E24C211B}"), 8)
-PKEY_PropList_PreviewTitle = (IID("{C9944A21-A406-48FE-8225-AEC7E24C211B}"), 6)
-PKEY_PropList_QuickTip = (IID("{C9944A21-A406-48FE-8225-AEC7E24C211B}"), 5)
-PKEY_PropList_TileInfo = (IID("{C9944A21-A406-48FE-8225-AEC7E24C211B}"), 3)
-PKEY_PropList_XPDetailsPanel = (IID("{F2275480-F782-4291-BD94-F13693513AEC}"), 0)
-PKEY_RecordedTV_ChannelNumber = (IID("{6D748DE2-8D38-4CC3-AC60-F009B057C557}"), 7)
-PKEY_RecordedTV_Credits = (IID("{6D748DE2-8D38-4CC3-AC60-F009B057C557}"), 4)
-PKEY_RecordedTV_DateContentExpires = (IID("{6D748DE2-8D38-4CC3-AC60-F009B057C557}"), 15)
-PKEY_RecordedTV_EpisodeName = (IID("{6D748DE2-8D38-4CC3-AC60-F009B057C557}"), 2)
-PKEY_RecordedTV_IsATSCContent = (IID("{6D748DE2-8D38-4CC3-AC60-F009B057C557}"), 16)
-PKEY_RecordedTV_IsClosedCaptioningAvailable = (
-    IID("{6D748DE2-8D38-4CC3-AC60-F009B057C557}"),
-    12,
-)
-PKEY_RecordedTV_IsDTVContent = (IID("{6D748DE2-8D38-4CC3-AC60-F009B057C557}"), 17)
-PKEY_RecordedTV_IsHDContent = (IID("{6D748DE2-8D38-4CC3-AC60-F009B057C557}"), 18)
-PKEY_RecordedTV_IsRepeatBroadcast = (IID("{6D748DE2-8D38-4CC3-AC60-F009B057C557}"), 13)
-PKEY_RecordedTV_IsSAP = (IID("{6D748DE2-8D38-4CC3-AC60-F009B057C557}"), 14)
-PKEY_RecordedTV_NetworkAffiliation = (
-    IID("{2C53C813-FB63-4E22-A1AB-0B331CA1E273}"),
-    100,
-)
-PKEY_RecordedTV_OriginalBroadcastDate = (
-    IID("{4684FE97-8765-4842-9C13-F006447B178C}"),
-    100,
-)
-PKEY_RecordedTV_ProgramDescription = (IID("{6D748DE2-8D38-4CC3-AC60-F009B057C557}"), 3)
-PKEY_RecordedTV_RecordingTime = (IID("{A5477F61-7A82-4ECA-9DDE-98B69B2479B3}"), 100)
-PKEY_RecordedTV_StationCallSign = (IID("{6D748DE2-8D38-4CC3-AC60-F009B057C557}"), 5)
-PKEY_RecordedTV_StationName = (IID("{1B5439E7-EBA1-4AF8-BDD7-7AF1D4549493}"), 100)
-PKEY_Search_AutoSummary = (IID("{560C36C0-503A-11CF-BAA1-00004C752A9A}"), 2)
-PKEY_Search_ContainerHash = (IID("{BCEEE283-35DF-4D53-826A-F36A3EEFC6BE}"), 100)
-PKEY_Search_Contents = (IID("{B725F130-47EF-101A-A5F1-02608C9EEBAC}"), 19)
-PKEY_Search_EntryID = (IID("{49691C90-7E17-101A-A91C-08002B2ECDA9}"), 5)
-PKEY_Search_GatherTime = (IID("{0B63E350-9CCC-11D0-BCDB-00805FCCCE04}"), 8)
-PKEY_Search_IsClosedDirectory = (IID("{0B63E343-9CCC-11D0-BCDB-00805FCCCE04}"), 23)
-PKEY_Search_IsFullyContained = (IID("{0B63E343-9CCC-11D0-BCDB-00805FCCCE04}"), 24)
-PKEY_Search_QueryFocusedSummary = (IID("{560C36C0-503A-11CF-BAA1-00004C752A9A}"), 3)
-PKEY_Search_Rank = (IID("{49691C90-7E17-101A-A91C-08002B2ECDA9}"), 3)
-PKEY_Search_Store = (IID("{A06992B3-8CAF-4ED7-A547-B259E32AC9FC}"), 100)
-PKEY_Search_UrlToIndex = (IID("{0B63E343-9CCC-11D0-BCDB-00805FCCCE04}"), 2)
-PKEY_Search_UrlToIndexWithModificationTime = (
-    IID("{0B63E343-9CCC-11D0-BCDB-00805FCCCE04}"),
-    12,
-)
-PKEY_DescriptionID = (IID("{28636AA6-953D-11D2-B5D6-00C04FD918D0}"), 2)
-PKEY_Link_TargetSFGAOFlagsStrings = (IID("{D6942081-D53B-443D-AD47-5E059D9CD27A}"), 3)
-PKEY_Link_TargetUrl = (IID("{5CBF2787-48CF-4208-B90E-EE5E5D420294}"), 2)
-PKEY_Shell_SFGAOFlagsStrings = (IID("{D6942081-D53B-443D-AD47-5E059D9CD27A}"), 2)
-PKEY_Software_DateLastUsed = (IID("{841E4F90-FF59-4D16-8947-E81BBFFAB36D}"), 16)
-PKEY_Software_ProductName = (IID("{0CEF7D53-FA64-11D1-A203-0000F81FEDEE}"), 7)
-PKEY_Sync_Comments = (IID("{7BD5533E-AF15-44DB-B8C8-BD6624E1D032}"), 13)
-PKEY_Sync_ConflictDescription = (IID("{CE50C159-2FB8-41FD-BE68-D3E042E274BC}"), 4)
-PKEY_Sync_ConflictFirstLocation = (IID("{CE50C159-2FB8-41FD-BE68-D3E042E274BC}"), 6)
-PKEY_Sync_ConflictSecondLocation = (IID("{CE50C159-2FB8-41FD-BE68-D3E042E274BC}"), 7)
-PKEY_Sync_HandlerCollectionID = (IID("{7BD5533E-AF15-44DB-B8C8-BD6624E1D032}"), 2)
-PKEY_Sync_HandlerID = (IID("{7BD5533E-AF15-44DB-B8C8-BD6624E1D032}"), 3)
-PKEY_Sync_HandlerName = (IID("{CE50C159-2FB8-41FD-BE68-D3E042E274BC}"), 2)
-PKEY_Sync_HandlerType = (IID("{7BD5533E-AF15-44DB-B8C8-BD6624E1D032}"), 8)
-PKEY_Sync_HandlerTypeLabel = (IID("{7BD5533E-AF15-44DB-B8C8-BD6624E1D032}"), 9)
-PKEY_Sync_ItemID = (IID("{7BD5533E-AF15-44DB-B8C8-BD6624E1D032}"), 6)
-PKEY_Sync_ItemName = (IID("{CE50C159-2FB8-41FD-BE68-D3E042E274BC}"), 3)
-PKEY_Task_BillingInformation = (IID("{D37D52C6-261C-4303-82B3-08B926AC6F12}"), 100)
-PKEY_Task_CompletionStatus = (IID("{084D8A0A-E6D5-40DE-BF1F-C8820E7C877C}"), 100)
-PKEY_Task_Owner = (IID("{08C7CC5F-60F2-4494-AD75-55E3E0B5ADD0}"), 100)
-PKEY_Video_Compression = (IID("{64440491-4C8B-11D1-8B70-080036B11A03}"), 10)
-PKEY_Video_Director = (IID("{64440492-4C8B-11D1-8B70-080036B11A03}"), 20)
-PKEY_Video_EncodingBitrate = (IID("{64440491-4C8B-11D1-8B70-080036B11A03}"), 8)
-PKEY_Video_FourCC = (IID("{64440491-4C8B-11D1-8B70-080036B11A03}"), 44)
-PKEY_Video_FrameHeight = (IID("{64440491-4C8B-11D1-8B70-080036B11A03}"), 4)
-PKEY_Video_FrameRate = (IID("{64440491-4C8B-11D1-8B70-080036B11A03}"), 6)
-PKEY_Video_FrameWidth = (IID("{64440491-4C8B-11D1-8B70-080036B11A03}"), 3)
-PKEY_Video_HorizontalAspectRatio = (IID("{64440491-4C8B-11D1-8B70-080036B11A03}"), 42)
-PKEY_Video_SampleSize = (IID("{64440491-4C8B-11D1-8B70-080036B11A03}"), 9)
-PKEY_Video_StreamName = (IID("{64440491-4C8B-11D1-8B70-080036B11A03}"), 2)
-PKEY_Video_StreamNumber = (IID("{64440491-4C8B-11D1-8B70-080036B11A03}"), 11)
-PKEY_Video_TotalBitrate = (IID("{64440491-4C8B-11D1-8B70-080036B11A03}"), 43)
-PKEY_Video_VerticalAspectRatio = (IID("{64440491-4C8B-11D1-8B70-080036B11A03}"), 45)
-PKEY_Volume_FileSystem = (IID("{9B174B35-40FF-11D2-A27E-00C04FC30871}"), 4)
-PKEY_Volume_IsMappedDrive = (IID("{149C0B69-2C2D-48FC-808F-D318D78C4636}"), 2)
-PKEY_Volume_IsRoot = (IID("{9B174B35-40FF-11D2-A27E-00C04FC30871}"), 10)
-
-PKEY_AppUserModel_RelaunchCommand = (IID("{9F4C2855-9F79-4B39-A8D0-E1D42DE1D5F3}"), 2)
-PKEY_AppUserModel_RelaunchIconResource = (
-    IID("{9F4C2855-9F79-4B39-A8D0-E1D42DE1D5F3}"),
-    3,
-)
-PKEY_AppUserModel_RelaunchDisplayNameResource = (
-    IID("{9F4C2855-9F79-4B39-A8D0-E1D42DE1D5F3}"),
-    4,
-)
-PKEY_AppUserModel_ID = (IID("{9F4C2855-9F79-4B39-A8D0-E1D42DE1D5F3}"), 5)
-PKEY_AppUserModel_IsDestListSeparator = (
-    IID("{9F4C2855-9F79-4B39-A8D0-E1D42DE1D5F3}"),
-    6,
-)
-PKEY_AppUserModel_ExcludeFromShowInNewInstall = (
-    IID("{9F4C2855-9F79-4B39-A8D0-E1D42DE1D5F3}"),
-    8,
-)
-PKEY_AppUserModel_PreventPinning = (IID("{9F4C2855-9F79-4B39-A8D0-E1D42DE1D5F3}"), 9)
-
-# PKA_FLAGS, used with IPropertyChange
-PKA_SET = 0
-PKA_APPEND = 1
-PKA_DELETE = 2
diff --git a/lib/win32comext/propsys/test/testpropsys.py b/lib/win32comext/propsys/test/testpropsys.py
deleted file mode 100644
index 356d3e67..00000000
--- a/lib/win32comext/propsys/test/testpropsys.py
+++ /dev/null
@@ -1,5 +0,0 @@
-from win32com.propsys import propsys, pscon
-
-print("propsys was imported (sorry - that is the extent of the tests,")
-print("but see the shell folder_view demo, which uses this module)")
-# that's all folks!
diff --git a/lib/win32comext/shell/__init__.py b/lib/win32comext/shell/__init__.py
deleted file mode 100644
index 8d5db8b9..00000000
--- a/lib/win32comext/shell/__init__.py
+++ /dev/null
@@ -1,4 +0,0 @@
-# See if we have a special directory for the binaries (for developers)
-import win32com
-
-win32com.__PackageSupportBuildPath__(__path__)
diff --git a/lib/win32comext/shell/demos/IActiveDesktop.py b/lib/win32comext/shell/demos/IActiveDesktop.py
deleted file mode 100644
index c60ef3c8..00000000
--- a/lib/win32comext/shell/demos/IActiveDesktop.py
+++ /dev/null
@@ -1,83 +0,0 @@
-import time
-
-import pythoncom
-from win32com.shell import shell, shellcon
-
-website = "https://github.com/mhammond/pywin32/"
-iad = pythoncom.CoCreateInstance(
-    shell.CLSID_ActiveDesktop,
-    None,
-    pythoncom.CLSCTX_INPROC_SERVER,
-    shell.IID_IActiveDesktop,
-)
-opts = iad.GetDesktopItemOptions()
-if not (opts["ActiveDesktop"] and opts["EnableComponents"]):
-    print("Warning: Enabling Active Desktop")
-    opts["ActiveDesktop"] = True
-    opts["EnableComponents"] = True
-    iad.SetDesktopItemOptions(opts)
-    iad.ApplyChanges(0xFFFF)
-    iad = None
-    ## apparently takes a short while for it to become active
-    time.sleep(2)
-    iad = pythoncom.CoCreateInstance(
-        shell.CLSID_ActiveDesktop,
-        None,
-        pythoncom.CLSCTX_INPROC_SERVER,
-        shell.IID_IActiveDesktop,
-    )
-
-cnt = iad.GetDesktopItemCount()
-print("Count:", cnt)
-for i in range(cnt):
-    print(iad.GetDesktopItem(i))
-
-component = {
-    "ID": cnt + 1,
-    "ComponentType": shellcon.COMP_TYPE_WEBSITE,
-    "CurItemState": shellcon.IS_NORMAL,
-    "SubscribedURL": website,
-    "Source": website,
-    "FriendlyName": "Pywin32 on SF",
-    "Checked": True,  ## this controls whether item is currently displayed
-    "NoScroll": False,
-    "Dirty": False,
-    "Pos": {
-        "Top": 69,
-        "Left": 69,
-        "Height": 400,
-        "Width": 400,
-        "zIndex": 1002,
-        "CanResize": True,
-        "CanResizeX": True,
-        "CanResizeY": True,
-        "PreferredLeftPercent": 0,
-        "PreferredTopPercent": 0,
-    },
-    "Original": {
-        "Top": 33,
-        "Left": 304,
-        "Height": 362,
-        "Width": 372,
-        "ItemState": shellcon.IS_NORMAL,
-    },
-    "Restored": {
-        "Top": 33,
-        "Left": 304,
-        "Height": 362,
-        "Width": 372,
-        "ItemState": shellcon.IS_NORMAL,
-    },
-}
-
-
-try:
-    existing_item = iad.GetDesktopItemBySource(website)
-except pythoncom.com_error:
-    pass
-else:
-    iad.RemoveDesktopItem(existing_item)
-    iad.ApplyChanges(0xFFFF)
-
-iad.AddDesktopItem(component)
-iad.ApplyChanges(0xFFFF)  ## need to check which AD_APPLY constants are actually needed
diff --git a/lib/win32comext/shell/demos/IFileOperationProgressSink.py b/lib/win32comext/shell/demos/IFileOperationProgressSink.py
deleted file mode 100644
index de117ad0..00000000
--- a/lib/win32comext/shell/demos/IFileOperationProgressSink.py
+++ /dev/null
@@ -1,181 +0,0 @@
-# Sample implementation of IFileOperationProgressSink that just prints
-# some basic info
-
-import pythoncom
-from win32com.server.policy import DesignatedWrapPolicy
-from win32com.shell import shell, shellcon
-
-tsf_flags = list(
-    (k, v) for k, v in list(shellcon.__dict__.items()) if k.startswith("TSF_")
-)
-
-
-def decode_flags(flags):
-    if flags == 0:
-        return "TSF_NORMAL"
-    flag_txt = ""
-    for k, v in tsf_flags:
-        if flags & v:
-            if flag_txt:
-                flag_txt = flag_txt + "|" + k
-            else:
-                flag_txt = k
-    return flag_txt
-
-
-class FileOperationProgressSink(DesignatedWrapPolicy):
-    _com_interfaces_ = [shell.IID_IFileOperationProgressSink]
-    _public_methods_ = [
-        "StartOperations",
-        "FinishOperations",
-        "PreRenameItem",
-        "PostRenameItem",
-        "PreMoveItem",
-        "PostMoveItem",
-        "PreCopyItem",
-        "PostCopyItem",
-        "PreDeleteItem",
-        "PostDeleteItem",
-        "PreNewItem",
-        "PostNewItem",
-        "UpdateProgress",
-        "ResetTimer",
-        "PauseTimer",
-        "ResumeTimer",
-    ]
-
-    def __init__(self):
-        self._wrap_(self)
-
-    def StartOperations(self):
-        print("StartOperations")
-
-    def FinishOperations(self, Result):
-        print("FinishOperations: HRESULT ", Result)
-
-    def PreRenameItem(self, Flags, Item, NewName):
-        print(
-            "PreRenameItem: Renaming "
-            + Item.GetDisplayName(shellcon.SHGDN_FORPARSING)
-            + " to "
-            + NewName
-        )
-
-    def PostRenameItem(self, Flags, Item, NewName, hrRename, NewlyCreated):
-        if NewlyCreated is not None:
-            newfile = NewlyCreated.GetDisplayName(shellcon.SHGDN_FORPARSING)
-        else:
-            newfile = "not renamed, HRESULT " + str(hrRename)
-        print(
-            "PostRenameItem: renamed "
-            + Item.GetDisplayName(shellcon.SHGDN_FORPARSING)
-            + " to "
-            + newfile
-        )
-
-    def PreMoveItem(self, Flags, Item, DestinationFolder, NewName):
-        print(
-            "PreMoveItem: Moving "
-            + Item.GetDisplayName(shellcon.SHGDN_FORPARSING)
-            + " to "
-            + DestinationFolder.GetDisplayName(shellcon.SHGDN_FORPARSING)
-            + "\\"
-            + str(NewName)
-        )
-
-    def PostMoveItem(
-        self, Flags, Item, DestinationFolder, NewName, hrMove, NewlyCreated
-    ):
-        if NewlyCreated is not None:
-            newfile = NewlyCreated.GetDisplayName(shellcon.SHGDN_FORPARSING)
-        else:
-            newfile = "not copied, HRESULT " + str(hrMove)
-        print(
-            "PostMoveItem: Moved "
-            + Item.GetDisplayName(shellcon.SHGDN_FORPARSING)
-            + " to "
-            + newfile
-        )
-
-    def PreCopyItem(self, Flags, Item, DestinationFolder, NewName):
-        if not NewName:
-            NewName = ""
-        print(
-            "PreCopyItem: Copying "
-            + Item.GetDisplayName(shellcon.SHGDN_FORPARSING)
-            + " to "
-            + DestinationFolder.GetDisplayName(shellcon.SHGDN_FORPARSING)
-            + "\\"
-            + NewName
-        )
-        print("Flags: ", decode_flags(Flags))
-
-    def PostCopyItem(
-        self, Flags, Item, DestinationFolder, NewName, hrCopy, NewlyCreated
-    ):
-        if NewlyCreated is not None:
-            newfile = NewlyCreated.GetDisplayName(shellcon.SHGDN_FORPARSING)
-        else:
-            newfile = "not copied, HRESULT " + str(hrCopy)
-        print(
-            "PostCopyItem: Copied "
-            + Item.GetDisplayName(shellcon.SHGDN_FORPARSING)
-            + " to "
-            + newfile
-        )
-        print("Flags: ", decode_flags(Flags))
-
-    def PreDeleteItem(self, Flags, Item):
-        print(
-            "PreDeleteItem: Deleting " + Item.GetDisplayName(shellcon.SHGDN_FORPARSING)
-        )
-
-    def PostDeleteItem(self, Flags, Item, hrDelete, NewlyCreated):
-        print(
-            "PostDeleteItem: Deleted " + Item.GetDisplayName(shellcon.SHGDN_FORPARSING)
-        )
-        if NewlyCreated:
-            print(
-                "	Moved to recycle bin - "
-                + NewlyCreated.GetDisplayName(shellcon.SHGDN_FORPARSING)
-            )
-
-    def PreNewItem(self, Flags, DestinationFolder, NewName):
-        print(
-            "PreNewItem: Creating "
-            + DestinationFolder.GetDisplayName(shellcon.SHGDN_FORPARSING)
-            + "\\"
-            + NewName
-        )
-
-    def PostNewItem(
-        self,
-        Flags,
-        DestinationFolder,
-        NewName,
-        TemplateName,
-        FileAttributes,
-        hrNew,
-        NewItem,
-    ):
-        print(
-            "PostNewItem: Created " + NewItem.GetDisplayName(shellcon.SHGDN_FORPARSING)
-        )
-
-    def UpdateProgress(self, WorkTotal, WorkSoFar):
-        print("UpdateProgress: ", WorkSoFar, WorkTotal)
-
-    def ResetTimer(self):
-        print("ResetTimer")
-
-    def PauseTimer(self):
-        print("PauseTimer")
-
-    def ResumeTimer(self):
-        print("ResumeTimer")
-
-
-def CreateSink():
-    return pythoncom.WrapObject(
-        FileOperationProgressSink(), shell.IID_IFileOperationProgressSink
-    )
diff --git a/lib/win32comext/shell/demos/IShellLinkDataList.py b/lib/win32comext/shell/demos/IShellLinkDataList.py
deleted file mode 100644
index 4327dc70..00000000
--- a/lib/win32comext/shell/demos/IShellLinkDataList.py
+++ /dev/null
@@ -1,67 +0,0 @@
-import os
-import sys
-
-import pythoncom
-import win32api
-from win32com.shell import shell, shellcon
-
-temp_dir = win32api.GetTempPath()
-linkname = win32api.GetTempFileName(temp_dir, "cmd")[0]
-os.remove(linkname)
-linkname += ".lnk"
-print("Link name:", linkname)
-ish = pythoncom.CoCreateInstance(
-    shell.CLSID_ShellLink, None, pythoncom.CLSCTX_INPROC_SERVER, shell.IID_IShellLink
-)
-ish.SetPath(os.environ["cOMSPEC"])
-ish.SetWorkingDirectory(os.path.split(sys.executable)[0])
-ish.SetDescription("shortcut made by python")
-
-console_props = {
-    "Signature": shellcon.NT_CONSOLE_PROPS_SIG,
-    "InsertMode": True,
-    "FullScreen": False,  ## True looks like "DOS Mode" from win98!
-    "FontFamily": 54,
-    "CursorSize": 75,  ## pct of character size
-    "ScreenBufferSize": (152, 256),
-    "AutoPosition": False,
-    "FontSize": (4, 5),
-    "FaceName": "",
-    "HistoryBufferSize": 32,
-    "InputBufferSize": 0,
-    "QuickEdit": True,
-    "Font": 0,  ## 0 should always be present, use win32console.GetNumberOfConsoleFonts() to find how many available
-    "FillAttribute": 7,
-    "PopupFillAttribute": 245,
-    "WindowSize": (128, 32),
-    "WindowOrigin": (0, 0),
-    "FontWeight": 400,
-    "HistoryNoDup": False,
-    "NumberOfHistoryBuffers": 32,
-    ## ColorTable copied from a 'normal' console shortcut, with some obvious changes
-    ## These do not appear to be documented.  From experimentation, [0] is background, [7] is foreground text
-    "ColorTable": (
-        255,
-        8388608,
-        32768,
-        8421376,
-        128,
-        8388736,
-        32896,
-        12582912,
-        8421504,
-        16711680,
-        65280,
-        16776960,
-        255,
-        16711935,
-        65535,
-        16777215,
-    ),
-}
-
-ishdl = ish.QueryInterface(shell.IID_IShellLinkDataList)
-ishdl.AddDataBlock(console_props)
-ipf = ish.QueryInterface(pythoncom.IID_IPersistFile)
-ipf.Save(linkname, 1)
-os.startfile(linkname)
diff --git a/lib/win32comext/shell/demos/ITransferAdviseSink.py b/lib/win32comext/shell/demos/ITransferAdviseSink.py
deleted file mode 100644
index 0eafeb9e..00000000
--- a/lib/win32comext/shell/demos/ITransferAdviseSink.py
+++ /dev/null
@@ -1,107 +0,0 @@
-# ITransferAdviseSink implementation template
-
-import pythoncom
-from win32com.server.policy import DesignatedWrapPolicy
-from win32com.shell import shell, shellcon
-
-tsf_flags = list(
-    (k, v) for k, v in list(shellcon.__dict__.items()) if k.startswith("TSF_")
-)
-
-
-def decode_flags(flags):
-    if flags == 0:
-        return "TSF_NORMAL"
-    flag_txt = ""
-    for k, v in tsf_flags:
-        if flags & v:
-            if flag_txt:
-                flag_txt = flag_txt + "|" + k
-            else:
-                flag_txt = k
-    return flag_txt
-
-
-TRANSFER_ADVISE_STATES = {}
-for k, v in list(shellcon.__dict__.items()):
-    if k.startswith("TS_"):
-        TRANSFER_ADVISE_STATES[v] = k
-
-
-def decode_flags(flags):
-    if flags == 0:
-        return "TSF_NORMAL"
-    flag_txt = ""
-    for k, v in tsf_flags:
-        if flags & v:
-            if flag_txt:
-                flag_txt = flag_txt + "|" + k
-            else:
-                flag_txt = k
-    return flag_txt
-
-
-class TransferAdviseSink(DesignatedWrapPolicy):
-    _com_interfaces_ = [shell.IID_ITransferAdviseSink]
-    _public_methods_ = [
-        "UpdateProgress",
-        "UpdateTransferState",
-        "ConfirmOverwrite",
-        "ConfirmEncryptionLoss",
-        "FileFailure",
-        "SubStreamFailure",
-        "PropertyFailure",
-    ]
-
-    def __init__(self):
-        self._wrap_(self)
-
-    def UpdateProgress(
-        self,
-        SizeCurrent,
-        SizeTotal,
-        FilesCurrent,
-        FilesTotal,
-        FoldersCurrent,
-        FoldersTotal,
-    ):
-        print("UpdateProgress - processed so far:")
-        print("\t %s out of %s bytes" % (SizeCurrent, SizeTotal))
-        print("\t %s out of %s files" % (FilesCurrent, FilesTotal))
-        print("\t %s out of %s folders" % (FoldersCurrent, FoldersTotal))
-
-    def UpdateTransferState(self, State):
-        print(
-            "Current state: ",
-            TRANSFER_ADVISE_STATES.get(State, "??? Unknown state %s ???" % State),
-        )
-
-    def ConfirmOverwrite(self, Source, DestParent, Name):
-        print(
-            "ConfirmOverwrite: ",
-            Source.GetDisplayName(shellcon.SHGDN_FORPARSING),
-            DestParent.GetDisplayName(shellcon.SHGDN_FORPARSING),
-            Name,
-        )
-
-    def ConfirmEncryptionLoss(self, Source):
-        print(
-            "ConfirmEncryptionLoss:", Source.GetDisplayName(shellcon.SHGDN_FORPARSING)
-        )
-
-    def FileFailure(self, Item, ItemName, Error):
-        print("FileFailure:", Item.GetDisplayName(shellcon.SHGDN_FORPARSING), ItemName)
-
-    def SubStreamFailure(self, Item, StreamName, Error):
-        print("SubStreamFailure:\n")
-
-    def PropertyFailure(self, Item, key, Error):
-        print("PropertyFailure:\n")
-
-
-def CreateSink():
-    return pythoncom.WrapObject(
-        TransferAdviseSink(),
-        shell.IID_ITransferAdviseSink,
-        shell.IID_ITransferAdviseSink,
-    )
diff --git a/lib/win32comext/shell/demos/IUniformResourceLocator.py b/lib/win32comext/shell/demos/IUniformResourceLocator.py
deleted file mode 100644
index 5a48efcb..00000000
--- a/lib/win32comext/shell/demos/IUniformResourceLocator.py
+++ /dev/null
@@ -1,56 +0,0 @@
-import os
-
-import pythoncom
-import win32api
-from win32com.shell import shell, shellcon
-
-
-class InternetShortcut:
-    def __init__(self):
-        self._base = pythoncom.CoCreateInstance(
-            shell.CLSID_InternetShortcut,
-            None,
-            pythoncom.CLSCTX_INPROC_SERVER,
-            shell.IID_IUniformResourceLocator,
-        )
-
-    def load(self, filename):
-        # Get an IPersist interface
-        # which allows save/restore of object to/from files
-        self._base.QueryInterface(pythoncom.IID_IPersistFile).Load(filename)
-
-    def save(self, filename):
-        self._base.QueryInterface(pythoncom.IID_IPersistFile).Save(filename, 1)
-
-    def __getattr__(self, name):
-        if name != "_base":
-            return getattr(self._base, name)
-
-
-temp_dir = win32api.GetTempPath()
-linkname = win32api.GetTempFileName(temp_dir, "ish")[0]
-print("Link:", linkname)
-os.remove(linkname)
-linkname += ".url"
-
-ish = InternetShortcut()
-ish.SetURL("https://github.com/mhammond/pywin32")
-ish.save(linkname)
-
-## IUniformResourceLocator also give access to IPropertySetStorage
-pss = ish.QueryInterface(pythoncom.IID_IPropertySetStorage)
-ps = pss.Open(shell.FMTID_InternetSite)
-property_ids = [
-    (k, v) for k, v in shellcon.__dict__.items() if k.startswith("PID_INTSITE_")
-]
-for pname, pval in property_ids:
-    print(pname, ps.ReadMultiple((pval,))[0])
-
-ps = pss.Open(shell.FMTID_Intshcut)
-property_ids = [(k, v) for k, v in shellcon.__dict__.items() if k.startswith("PID_IS_")]
-for pname, pval in property_ids:
-    print(pname, ps.ReadMultiple((pval,))[0])
-
-new_sh = InternetShortcut()
-new_sh.load(linkname)
-new_sh.InvokeCommand("Open")
diff --git a/lib/win32comext/shell/demos/browse_for_folder.py b/lib/win32comext/shell/demos/browse_for_folder.py
deleted file mode 100644
index dfa1e054..00000000
--- a/lib/win32comext/shell/demos/browse_for_folder.py
+++ /dev/null
@@ -1,45 +0,0 @@
-# A couple of samples using SHBrowseForFolder
-
-import os
-
-import win32gui
-from win32com.shell import shell, shellcon
-
-
-# A callback procedure - called by SHBrowseForFolder
-def BrowseCallbackProc(hwnd, msg, lp, data):
-    if msg == shellcon.BFFM_INITIALIZED:
-        win32gui.SendMessage(hwnd, shellcon.BFFM_SETSELECTION, 1, data)
-    elif msg == shellcon.BFFM_SELCHANGED:
-        # Set the status text of the
-        # For this message, 'lp' is the address of the PIDL.
-        pidl = shell.AddressAsPIDL(lp)
-        try:
-            path = shell.SHGetPathFromIDList(pidl)
-            win32gui.SendMessage(hwnd, shellcon.BFFM_SETSTATUSTEXT, 0, path)
-        except shell.error:
-            # No path for this PIDL
-            pass
-
-
-if __name__ == "__main__":
-    # Demonstrate a dialog with the cwd selected as the default - this
-    # must be done via a callback function.
-    flags = shellcon.BIF_STATUSTEXT
-    shell.SHBrowseForFolder(
-        0,  # parent HWND
-        None,  # root PIDL.
-        "Default of %s" % os.getcwd(),  # title
-        flags,  # flags
-        BrowseCallbackProc,  # callback function
-        os.getcwd(),  # 'data' param for the callback
-    )
-    # Browse from this directory down only.
-    # Get the PIDL for the cwd.
-    desktop = shell.SHGetDesktopFolder()
-    cb, pidl, extra = desktop.ParseDisplayName(0, None, os.getcwd())
-    shell.SHBrowseForFolder(
-        0,  # parent HWND
-        pidl,  # root PIDL.
-        "From %s down only" % os.getcwd(),  # title
-    )
diff --git a/lib/win32comext/shell/demos/create_link.py b/lib/win32comext/shell/demos/create_link.py
deleted file mode 100644
index 906454c5..00000000
--- a/lib/win32comext/shell/demos/create_link.py
+++ /dev/null
@@ -1,73 +0,0 @@
-# link.py
-# From a demo by Mark Hammond, corrupted by Mike Fletcher
-# (and re-corrupted by Mark Hammond :-)
-import os
-
-import pythoncom
-from win32com.shell import shell
-
-
-class PyShortcut:
-    def __init__(self):
-        self._base = pythoncom.CoCreateInstance(
-            shell.CLSID_ShellLink,
-            None,
-            pythoncom.CLSCTX_INPROC_SERVER,
-            shell.IID_IShellLink,
-        )
-
-    def load(self, filename):
-        # Get an IPersist interface
-        # which allows save/restore of object to/from files
-        self._base.QueryInterface(pythoncom.IID_IPersistFile).Load(filename)
-
-    def save(self, filename):
-        self._base.QueryInterface(pythoncom.IID_IPersistFile).Save(filename, 0)
-
-    def __getattr__(self, name):
-        if name != "_base":
-            return getattr(self._base, name)
-
-
-if __name__ == "__main__":
-    import sys
-
-    if len(sys.argv) < 2:
-        print(
-            "Usage: %s LinkFile [path [, args[, description[, working_dir]]]]\n\nIf LinkFile does not exist, it will be created using the other args"
-        )
-        sys.exit(1)
-    file = sys.argv[1]
-    shortcut = PyShortcut()
-    if os.path.exists(file):
-        # load and dump info from file...
-        shortcut.load(file)
-        # now print data...
-        print(
-            "Shortcut in file %s to file:\n\t%s\nArguments:\n\t%s\nDescription:\n\t%s\nWorking Directory:\n\t%s\nItemIDs:\n\t<skipped>"
-            % (
-                file,
-                shortcut.GetPath(shell.SLGP_SHORTPATH)[0],
-                shortcut.GetArguments(),
-                shortcut.GetDescription(),
-                shortcut.GetWorkingDirectory(),
-                # shortcut.GetIDList(),
-            )
-        )
-    else:
-        if len(sys.argv) < 3:
-            print(
-                "Link file does not exist\nYou must supply the path, args, description and working_dir as args"
-            )
-            sys.exit(1)
-        # create the shortcut using rest of args...
-        data = map(
-            None,
-            sys.argv[2:],
-            ("SetPath", "SetArguments", "SetDescription", "SetWorkingDirectory"),
-        )
-        for value, function in data:
-            if value and function:
-                # call function on each non-null value
-                getattr(shortcut, function)(value)
-        shortcut.save(file)
diff --git a/lib/win32comext/shell/demos/dump_link.py b/lib/win32comext/shell/demos/dump_link.py
deleted file mode 100644
index b9b31b33..00000000
--- a/lib/win32comext/shell/demos/dump_link.py
+++ /dev/null
@@ -1,58 +0,0 @@
-# dump_link.py - dumps information about shell shortcuts
-#
-import glob
-import os
-import sys
-
-import pythoncom
-from win32com.shell import shell, shellcon
-from win32com.storagecon import *
-
-
-def DumpLink(fname):
-    shellLink = pythoncom.CoCreateInstance(
-        shell.CLSID_ShellLink,
-        None,
-        pythoncom.CLSCTX_INPROC_SERVER,
-        shell.IID_IShellLink,
-    )
-    persistFile = shellLink.QueryInterface(pythoncom.IID_IPersistFile)
-    persistFile.Load(fname, STGM_READ)
-    shellLink.Resolve(0, shell.SLR_ANY_MATCH | shell.SLR_NO_UI)
-    fname, findData = shellLink.GetPath(0)
-    print("Filename:", fname, ", UNC=", shellLink.GetPath(shell.SLGP_UNCPRIORITY)[0])
-    print("Description:", shellLink.GetDescription())
-    print("Working Directory:", shellLink.GetWorkingDirectory())
-    print("Icon:", shellLink.GetIconLocation())
-
-
-def FavDumper(nothing, path, names):
-    # called by os.path.walk
-    for name in names:
-        print(name, end=" ")
-        try:
-            DumpLink(name)
-        except pythoncom.com_error:
-            print(" - not a link")
-
-
-def DumpFavorites():
-    favfold = str(shell.SHGetSpecialFolderPath(0, shellcon.CSIDL_FAVORITES))
-    print("Your favourites are at", favfold)
-    os.path.walk(favfold, FavDumper, None)
-
-
-if __name__ == "__main__":
-    if len(sys.argv) > 1:
-        for fspec in sys.argv[1:]:
-            files = glob.glob(fspec)
-            if files:
-                for file in files:
-                    print(file)
-                    DumpLink(file)
-                    print()
-            else:
-                print("Can not find", fspec)
-    else:
-        print("Dumping your favorites folder!")
-        DumpFavorites()
diff --git a/lib/win32comext/shell/demos/explorer_browser.py b/lib/win32comext/shell/demos/explorer_browser.py
deleted file mode 100644
index dbbd76b1..00000000
--- a/lib/win32comext/shell/demos/explorer_browser.py
+++ /dev/null
@@ -1,143 +0,0 @@
-# A sample of using Vista's IExplorerBrowser interfaces...
-# Currently doesn't quite work:
-# * CPU sits at 100% while running.
-
-import sys
-
-import pythoncom
-import win32api
-import win32con
-import win32gui
-from win32com.server.util import unwrap, wrap
-from win32com.shell import shell, shellcon
-
-# event handler for the browser.
-IExplorerBrowserEvents_Methods = """OnNavigationComplete OnNavigationFailed 
-                                    OnNavigationPending OnViewCreated""".split()
-
-
-class EventHandler:
-    _com_interfaces_ = [shell.IID_IExplorerBrowserEvents]
-    _public_methods_ = IExplorerBrowserEvents_Methods
-
-    def OnNavigationComplete(self, pidl):
-        print("OnNavComplete", pidl)
-
-    def OnNavigationFailed(self, pidl):
-        print("OnNavigationFailed", pidl)
-
-    def OnNavigationPending(self, pidl):
-        print("OnNavigationPending", pidl)
-
-    def OnViewCreated(self, view):
-        print("OnViewCreated", view)
-        # And if our demo view has been registered, it may well
-        # be that view!
-        try:
-            pyview = unwrap(view)
-            print("and look - its a Python implemented view!", pyview)
-        except ValueError:
-            pass
-
-
-class MainWindow:
-    def __init__(self):
-        message_map = {
-            win32con.WM_DESTROY: self.OnDestroy,
-            win32con.WM_COMMAND: self.OnCommand,
-            win32con.WM_SIZE: self.OnSize,
-        }
-        # Register the Window class.
-        wc = win32gui.WNDCLASS()
-        hinst = wc.hInstance = win32api.GetModuleHandle(None)
-        wc.lpszClassName = "test_explorer_browser"
-        wc.lpfnWndProc = message_map  # could also specify a wndproc.
-        classAtom = win32gui.RegisterClass(wc)
-        # Create the Window.
-        style = win32con.WS_OVERLAPPEDWINDOW | win32con.WS_VISIBLE
-        self.hwnd = win32gui.CreateWindow(
-            classAtom,
-            "Python IExplorerBrowser demo",
-            style,
-            0,
-            0,
-            win32con.CW_USEDEFAULT,
-            win32con.CW_USEDEFAULT,
-            0,
-            0,
-            hinst,
-            None,
-        )
-        eb = pythoncom.CoCreateInstance(
-            shellcon.CLSID_ExplorerBrowser,
-            None,
-            pythoncom.CLSCTX_ALL,
-            shell.IID_IExplorerBrowser,
-        )
-        # as per MSDN docs, hook up events early
-        self.event_cookie = eb.Advise(wrap(EventHandler()))
-
-        eb.SetOptions(shellcon.EBO_SHOWFRAMES)
-        rect = win32gui.GetClientRect(self.hwnd)
-        # Set the flags such that the folders autoarrange and non web view is presented
-        flags = (shellcon.FVM_LIST, shellcon.FWF_AUTOARRANGE | shellcon.FWF_NOWEBVIEW)
-        eb.Initialize(self.hwnd, rect, (0, shellcon.FVM_DETAILS))
-        if len(sys.argv) == 2:
-            # If an arg was specified, ask the desktop parse it.
-            # You can pass anything explorer accepts as its '/e' argument -
-            # eg, "::{guid}\::{guid}" etc.
-            # "::{20D04FE0-3AEA-1069-A2D8-08002B30309D}" is "My Computer"
-            pidl = shell.SHGetDesktopFolder().ParseDisplayName(0, None, sys.argv[1])[1]
-        else:
-            # And start browsing at the root of the namespace.
-            pidl = []
-        eb.BrowseToIDList(pidl, shellcon.SBSP_ABSOLUTE)
-        # and for some reason the "Folder" view in the navigator pane doesn't
-        # magically synchronize itself - so let's do that ourself.
-        # Get the tree control.
-        sp = eb.QueryInterface(pythoncom.IID_IServiceProvider)
-        try:
-            tree = sp.QueryService(
-                shell.IID_INameSpaceTreeControl, shell.IID_INameSpaceTreeControl
-            )
-        except pythoncom.com_error as exc:
-            # this should really only fail if no "nav" frame exists...
-            print(
-                "Strange - failed to get the tree control even though "
-                "we asked for a EBO_SHOWFRAMES"
-            )
-            print(exc)
-        else:
-            # get the IShellItem for the selection.
-            si = shell.SHCreateItemFromIDList(pidl, shell.IID_IShellItem)
-            # set it to selected.
-            tree.SetItemState(si, shellcon.NSTCIS_SELECTED, shellcon.NSTCIS_SELECTED)
-
-        # eb.FillFromObject(None, shellcon.EBF_NODROPTARGET);
-        # eb.SetEmptyText("No known folders yet...");
-        self.eb = eb
-
-    def OnCommand(self, hwnd, msg, wparam, lparam):
-        pass
-
-    def OnDestroy(self, hwnd, msg, wparam, lparam):
-        print("tearing down ExplorerBrowser...")
-        self.eb.Unadvise(self.event_cookie)
-        self.eb.Destroy()
-        self.eb = None
-        print("shutting down app...")
-        win32gui.PostQuitMessage(0)
-
-    def OnSize(self, hwnd, msg, wparam, lparam):
-        x = win32api.LOWORD(lparam)
-        y = win32api.HIWORD(lparam)
-        self.eb.SetRect(None, (0, 0, x, y))
-
-
-def main():
-    w = MainWindow()
-    win32gui.PumpMessages()
-
-
-if __name__ == "__main__":
-    main()
diff --git a/lib/win32comext/shell/demos/servers/column_provider.py b/lib/win32comext/shell/demos/servers/column_provider.py
deleted file mode 100644
index 6c8625a4..00000000
--- a/lib/win32comext/shell/demos/servers/column_provider.py
+++ /dev/null
@@ -1,126 +0,0 @@
-# A sample shell column provider
-# Mainly ported from MSDN article:
-#  Using Shell Column Handlers for Detailed File Information,
-#  Raymond Chen, Microsoft Corporation, February 2000
-#
-# To demostrate:
-# * Execute this script to register the namespace.
-# * Open Windows Explorer
-# * Right-click an explorer column header - select "More"
-# * Locate column 'pyc size' or 'pyo size', and add it to the view.
-# This handler is providing that column data.
-import os
-import stat
-
-import commctrl
-import pythoncom
-from pywintypes import IID
-from win32com.server.util import wrap
-from win32com.shell import shell, shellcon
-
-IPersist_Methods = ["GetClassID"]
-IColumnProvider_Methods = IPersist_Methods + [
-    "Initialize",
-    "GetColumnInfo",
-    "GetItemData",
-]
-
-
-class ColumnProvider:
-    _reg_progid_ = "Python.ShellExtension.ColumnProvider"
-    _reg_desc_ = "Python Sample Shell Extension (Column Provider)"
-    _reg_clsid_ = IID("{0F14101A-E05E-4070-BD54-83DFA58C3D68}")
-    _com_interfaces_ = [
-        pythoncom.IID_IPersist,
-        shell.IID_IColumnProvider,
-    ]
-    _public_methods_ = IColumnProvider_Methods
-
-    # IPersist
-    def GetClassID(self):
-        return self._reg_clsid_
-
-    # IColumnProvider
-    def Initialize(self, colInit):
-        flags, reserved, name = colInit
-        print("ColumnProvider initializing for file", name)
-
-    def GetColumnInfo(self, index):
-        # We support exactly 2 columns - 'pyc size' and 'pyo size'
-        if index in [0, 1]:
-            # As per the MSDN sample, use our CLSID as the fmtid
-            if index == 0:
-                ext = ".pyc"
-            else:
-                ext = ".pyo"
-            title = ext + " size"
-            description = "Size of compiled %s file" % ext
-            col_id = (self._reg_clsid_, index)  # fmtid  # pid
-            col_info = (
-                col_id,  # scid
-                pythoncom.VT_I4,  # vt
-                commctrl.LVCFMT_RIGHT,  # fmt
-                20,  # cChars
-                shellcon.SHCOLSTATE_TYPE_INT
-                | shellcon.SHCOLSTATE_SECONDARYUI,  # csFlags
-                title,
-                description,
-            )
-            return col_info
-        return None  # Indicate no more columns.
-
-    def GetItemData(self, colid, colData):
-        fmt_id, pid = colid
-        fmt_id == self._reg_clsid_
-        flags, attr, reserved, ext, name = colData
-        if ext.lower() not in [".py", ".pyw"]:
-            return None
-        if pid == 0:
-            ext = ".pyc"
-        else:
-            ext = ".pyo"
-        check_file = os.path.splitext(name)[0] + ext
-        try:
-            st = os.stat(check_file)
-            return st[stat.ST_SIZE]
-        except OSError:
-            # No file
-            return None
-
-
-def DllRegisterServer():
-    import winreg
-
-    # Special ColumnProvider key
-    key = winreg.CreateKey(
-        winreg.HKEY_CLASSES_ROOT,
-        "Folder\\ShellEx\\ColumnHandlers\\" + str(ColumnProvider._reg_clsid_),
-    )
-    winreg.SetValueEx(key, None, 0, winreg.REG_SZ, ColumnProvider._reg_desc_)
-    print(ColumnProvider._reg_desc_, "registration complete.")
-
-
-def DllUnregisterServer():
-    import winreg
-
-    try:
-        key = winreg.DeleteKey(
-            winreg.HKEY_CLASSES_ROOT,
-            "Folder\\ShellEx\\ColumnHandlers\\" + str(ColumnProvider._reg_clsid_),
-        )
-    except WindowsError as details:
-        import errno
-
-        if details.errno != errno.ENOENT:
-            raise
-    print(ColumnProvider._reg_desc_, "unregistration complete.")
-
-
-if __name__ == "__main__":
-    from win32com.server import register
-
-    register.UseCommandLine(
-        ColumnProvider,
-        finalize_register=DllRegisterServer,
-        finalize_unregister=DllUnregisterServer,
-    )
diff --git a/lib/win32comext/shell/demos/servers/context_menu.py b/lib/win32comext/shell/demos/servers/context_menu.py
deleted file mode 100644
index b92109d7..00000000
--- a/lib/win32comext/shell/demos/servers/context_menu.py
+++ /dev/null
@@ -1,122 +0,0 @@
-# A sample context menu handler.
-# Adds a 'Hello from Python' menu entry to .py files.  When clicked, a
-# simple message box is displayed.
-#
-# To demostrate:
-# * Execute this script to register the context menu.
-# * Open Windows Explorer, and browse to a directory with a .py file.
-# * Right-Click on a .py file - locate and click on 'Hello from Python' on
-#   the context menu.
-
-import pythoncom
-import win32con
-import win32gui
-from win32com.shell import shell, shellcon
-
-
-class ShellExtension:
-    _reg_progid_ = "Python.ShellExtension.ContextMenu"
-    _reg_desc_ = "Python Sample Shell Extension (context menu)"
-    _reg_clsid_ = "{CED0336C-C9EE-4a7f-8D7F-C660393C381F}"
-    _com_interfaces_ = [shell.IID_IShellExtInit, shell.IID_IContextMenu]
-    _public_methods_ = shellcon.IContextMenu_Methods + shellcon.IShellExtInit_Methods
-
-    def Initialize(self, folder, dataobj, hkey):
-        print("Init", folder, dataobj, hkey)
-        self.dataobj = dataobj
-
-    def QueryContextMenu(self, hMenu, indexMenu, idCmdFirst, idCmdLast, uFlags):
-        print("QCM", hMenu, indexMenu, idCmdFirst, idCmdLast, uFlags)
-        # Query the items clicked on
-        format_etc = win32con.CF_HDROP, None, 1, -1, pythoncom.TYMED_HGLOBAL
-        sm = self.dataobj.GetData(format_etc)
-        num_files = shell.DragQueryFile(sm.data_handle, -1)
-        if num_files > 1:
-            msg = "&Hello from Python (with %d files selected)" % num_files
-        else:
-            fname = shell.DragQueryFile(sm.data_handle, 0)
-            msg = "&Hello from Python (with '%s' selected)" % fname
-        idCmd = idCmdFirst
-        items = ["First Python content menu item"]
-        if (
-            uFlags & 0x000F
-        ) == shellcon.CMF_NORMAL:  # Check == here, since CMF_NORMAL=0
-            print("CMF_NORMAL...")
-            items.append(msg)
-        elif uFlags & shellcon.CMF_VERBSONLY:
-            print("CMF_VERBSONLY...")
-            items.append(msg + " - shortcut")
-        elif uFlags & shellcon.CMF_EXPLORE:
-            print("CMF_EXPLORE...")
-            items.append(msg + " - normal file, right-click in Explorer")
-        elif uFlags & CMF_DEFAULTONLY:
-            print("CMF_DEFAULTONLY...\r\n")
-        else:
-            print("** unknown flags", uFlags)
-        win32gui.InsertMenu(
-            hMenu, indexMenu, win32con.MF_SEPARATOR | win32con.MF_BYPOSITION, 0, None
-        )
-        indexMenu += 1
-        for item in items:
-            win32gui.InsertMenu(
-                hMenu,
-                indexMenu,
-                win32con.MF_STRING | win32con.MF_BYPOSITION,
-                idCmd,
-                item,
-            )
-            indexMenu += 1
-            idCmd += 1
-
-        win32gui.InsertMenu(
-            hMenu, indexMenu, win32con.MF_SEPARATOR | win32con.MF_BYPOSITION, 0, None
-        )
-        indexMenu += 1
-        return idCmd - idCmdFirst  # Must return number of menu items we added.
-
-    def InvokeCommand(self, ci):
-        mask, hwnd, verb, params, dir, nShow, hotkey, hicon = ci
-        win32gui.MessageBox(hwnd, "Hello", "Wow", win32con.MB_OK)
-
-    def GetCommandString(self, cmd, typ):
-        # If GetCommandString returns the same string for all items then
-        # the shell seems to ignore all but one.  This is even true in
-        # Win7 etc where there is no status bar (and hence this string seems
-        # ignored)
-        return "Hello from Python (cmd=%d)!!" % (cmd,)
-
-
-def DllRegisterServer():
-    import winreg
-
-    key = winreg.CreateKey(winreg.HKEY_CLASSES_ROOT, "Python.File\\shellex")
-    subkey = winreg.CreateKey(key, "ContextMenuHandlers")
-    subkey2 = winreg.CreateKey(subkey, "PythonSample")
-    winreg.SetValueEx(subkey2, None, 0, winreg.REG_SZ, ShellExtension._reg_clsid_)
-    print(ShellExtension._reg_desc_, "registration complete.")
-
-
-def DllUnregisterServer():
-    import winreg
-
-    try:
-        key = winreg.DeleteKey(
-            winreg.HKEY_CLASSES_ROOT,
-            "Python.File\\shellex\\ContextMenuHandlers\\PythonSample",
-        )
-    except WindowsError as details:
-        import errno
-
-        if details.errno != errno.ENOENT:
-            raise
-    print(ShellExtension._reg_desc_, "unregistration complete.")
-
-
-if __name__ == "__main__":
-    from win32com.server import register
-
-    register.UseCommandLine(
-        ShellExtension,
-        finalize_register=DllRegisterServer,
-        finalize_unregister=DllUnregisterServer,
-    )
diff --git a/lib/win32comext/shell/demos/servers/copy_hook.py b/lib/win32comext/shell/demos/servers/copy_hook.py
deleted file mode 100644
index e5871fd8..00000000
--- a/lib/win32comext/shell/demos/servers/copy_hook.py
+++ /dev/null
@@ -1,84 +0,0 @@
-# A sample shell copy hook.
-
-# To demostrate:
-# * Execute this script to register the context menu.
-# * Open Windows Explorer
-# * Attempt to move or copy a directory.
-# * Note our hook's dialog is displayed.
-
-import pythoncom
-import win32con
-import win32gui
-from win32com.shell import shell, shellcon
-
-
-# Our shell extension.
-class ShellExtension:
-    _reg_progid_ = "Python.ShellExtension.CopyHook"
-    _reg_desc_ = "Python Sample Shell Extension (copy hook)"
-    _reg_clsid_ = "{1845b6ba-2bbd-4197-b930-46d8651497c1}"
-    _com_interfaces_ = [shell.IID_ICopyHook]
-    _public_methods_ = ["CopyCallBack"]
-
-    def CopyCallBack(self, hwnd, func, flags, srcName, srcAttr, destName, destAttr):
-        # This function should return:
-        # IDYES Allows the operation.
-        # IDNO Prevents the operation on this folder but continues with any other operations that have been approved (for example, a batch copy operation).
-        # IDCANCEL Prevents the current operation and cancels any pending operations.
-        print("CopyCallBack", hwnd, func, flags, srcName, srcAttr, destName, destAttr)
-        return win32gui.MessageBox(
-            hwnd, "Allow operation?", "CopyHook", win32con.MB_YESNO
-        )
-
-
-def DllRegisterServer():
-    import winreg
-
-    key = winreg.CreateKey(
-        winreg.HKEY_CLASSES_ROOT,
-        "directory\\shellex\\CopyHookHandlers\\" + ShellExtension._reg_desc_,
-    )
-    winreg.SetValueEx(key, None, 0, winreg.REG_SZ, ShellExtension._reg_clsid_)
-    key = winreg.CreateKey(
-        winreg.HKEY_CLASSES_ROOT,
-        "*\\shellex\\CopyHookHandlers\\" + ShellExtension._reg_desc_,
-    )
-    winreg.SetValueEx(key, None, 0, winreg.REG_SZ, ShellExtension._reg_clsid_)
-    print(ShellExtension._reg_desc_, "registration complete.")
-
-
-def DllUnregisterServer():
-    import winreg
-
-    try:
-        key = winreg.DeleteKey(
-            winreg.HKEY_CLASSES_ROOT,
-            "directory\\shellex\\CopyHookHandlers\\" + ShellExtension._reg_desc_,
-        )
-    except WindowsError as details:
-        import errno
-
-        if details.errno != errno.ENOENT:
-            raise
-    try:
-        key = winreg.DeleteKey(
-            winreg.HKEY_CLASSES_ROOT,
-            "*\\shellex\\CopyHookHandlers\\" + ShellExtension._reg_desc_,
-        )
-    except WindowsError as details:
-        import errno
-
-        if details.errno != errno.ENOENT:
-            raise
-    print(ShellExtension._reg_desc_, "unregistration complete.")
-
-
-if __name__ == "__main__":
-    from win32com.server import register
-
-    register.UseCommandLine(
-        ShellExtension,
-        finalize_register=DllRegisterServer,
-        finalize_unregister=DllUnregisterServer,
-    )
-#!/usr/bin/env python
diff --git a/lib/win32comext/shell/demos/servers/empty_volume_cache.py b/lib/win32comext/shell/demos/servers/empty_volume_cache.py
deleted file mode 100644
index a257ac17..00000000
--- a/lib/win32comext/shell/demos/servers/empty_volume_cache.py
+++ /dev/null
@@ -1,188 +0,0 @@
-# A sample implementation of IEmptyVolumeCache - see
-# http://msdn2.microsoft.com/en-us/library/aa969271.aspx for an overview.
-#
-# * Execute this script to register the handler
-# * Start the "disk cleanup" tool - look for "pywin32 compiled files"
-import os
-import stat
-import sys
-
-import pythoncom
-import win32gui
-import winerror
-from win32com.server.exception import COMException
-from win32com.shell import shell, shellcon
-
-# Our shell extension.
-IEmptyVolumeCache_Methods = (
-    "Initialize GetSpaceUsed Purge ShowProperties Deactivate".split()
-)
-IEmptyVolumeCache2_Methods = "InitializeEx".split()
-
-ico = os.path.join(sys.prefix, "py.ico")
-if not os.path.isfile(ico):
-    ico = os.path.join(sys.prefix, "PC", "py.ico")
-if not os.path.isfile(ico):
-    ico = None
-    print("Can't find python.ico - no icon will be installed")
-
-
-class EmptyVolumeCache:
-    _reg_progid_ = "Python.ShellExtension.EmptyVolumeCache"
-    _reg_desc_ = "Python Sample Shell Extension (disk cleanup)"
-    _reg_clsid_ = "{EADD0777-2968-4c72-A999-2BF5F756259C}"
-    _reg_icon_ = ico
-    _com_interfaces_ = [shell.IID_IEmptyVolumeCache, shell.IID_IEmptyVolumeCache2]
-    _public_methods_ = IEmptyVolumeCache_Methods + IEmptyVolumeCache2_Methods
-
-    def Initialize(self, hkey, volume, flags):
-        # This should never be called, except on win98.
-        print("Unless we are on 98, Initialize call is unexpected!")
-        raise COMException(hresult=winerror.E_NOTIMPL)
-
-    def InitializeEx(self, hkey, volume, key_name, flags):
-        # Must return a tuple of:
-        # (display_name, description, button_name, flags)
-        print("InitializeEx called with", hkey, volume, key_name, flags)
-        self.volume = volume
-        if flags & shellcon.EVCF_SETTINGSMODE:
-            print("We are being run on a schedule")
-            # In this case, "because there is no opportunity for user
-            # feedback, only those files that are extremely safe to clean up
-            # should be touched. You should ignore the initialization
-            # method's pcwszVolume parameter and clean unneeded files
-            # regardless of what drive they are on."
-            self.volume = None  # flag as 'any disk will do'
-        elif flags & shellcon.EVCF_OUTOFDISKSPACE:
-            # In this case, "the handler should be aggressive about deleting
-            # files, even if it results in a performance loss. However, the
-            # handler obviously should not delete files that would cause an
-            # application to fail or the user to lose data."
-            print("We are being run as we are out of disk-space")
-        else:
-            # This case is not documented - we are guessing :)
-            print("We are being run because the user asked")
-
-        # For the sake of demo etc, we tell the shell to only show us when
-        # there are > 0 bytes available.  Our GetSpaceUsed will check the
-        # volume, so will return 0 when we are on a different disk
-        flags = shellcon.EVCF_DONTSHOWIFZERO | shellcon.EVCF_ENABLEBYDEFAULT
-
-        return (
-            "pywin32 compiled files",
-            "Removes all .pyc and .pyo files in the pywin32 directories",
-            "click me!",
-            flags,
-        )
-
-    def _GetDirectories(self):
-        root_dir = os.path.abspath(os.path.dirname(os.path.dirname(win32gui.__file__)))
-        if self.volume is not None and not root_dir.lower().startswith(
-            self.volume.lower()
-        ):
-            return []
-        return [
-            os.path.join(root_dir, p)
-            for p in ("win32", "win32com", "win32comext", "isapi")
-        ]
-
-    def _WalkCallback(self, arg, directory, files):
-        # callback function for os.path.walk - no need to be member, but its
-        # close to the callers :)
-        callback, total_list = arg
-        for file in files:
-            fqn = os.path.join(directory, file).lower()
-            if file.endswith(".pyc") or file.endswith(".pyo"):
-                # See below - total_list == None means delete files,
-                # otherwise it is a list where the result is stored. Its a
-                # list simply due to the way os.walk works - only [0] is
-                # referenced
-                if total_list is None:
-                    print("Deleting file", fqn)
-                    # Should do callback.PurgeProcess - left as an exercise :)
-                    os.remove(fqn)
-                else:
-                    total_list[0] += os.stat(fqn)[stat.ST_SIZE]
-                    # and callback to the tool
-                    if callback:
-                        # for the sake of seeing the progress bar do its thing,
-                        # we take longer than we need to...
-                        # ACK - for some bizarre reason this screws up the XP
-                        # cleanup manager - clues welcome!! :)
-                        ## print "Looking in", directory, ", but waiting a while..."
-                        ## time.sleep(3)
-                        # now do it
-                        used = total_list[0]
-                        callback.ScanProgress(used, 0, "Looking at " + fqn)
-
-    def GetSpaceUsed(self, callback):
-        total = [0]  # See _WalkCallback above
-        try:
-            for d in self._GetDirectories():
-                os.path.walk(d, self._WalkCallback, (callback, total))
-                print("After looking in", d, "we have", total[0], "bytes")
-        except pythoncom.error as exc:
-            # This will be raised by the callback when the user selects 'cancel'.
-            if exc.hresult != winerror.E_ABORT:
-                raise  # that's the documented error code!
-            print("User cancelled the operation")
-        return total[0]
-
-    def Purge(self, amt_to_free, callback):
-        print("Purging", amt_to_free, "bytes...")
-        # we ignore amt_to_free - it is generally what we returned for
-        # GetSpaceUsed
-        try:
-            for d in self._GetDirectories():
-                os.path.walk(d, self._WalkCallback, (callback, None))
-        except pythoncom.error as exc:
-            # This will be raised by the callback when the user selects 'cancel'.
-            if exc.hresult != winerror.E_ABORT:
-                raise  # that's the documented error code!
-            print("User cancelled the operation")
-
-    def ShowProperties(self, hwnd):
-        raise COMException(hresult=winerror.E_NOTIMPL)
-
-    def Deactivate(self):
-        print("Deactivate called")
-        return 0
-
-
-def DllRegisterServer():
-    # Also need to register specially in:
-    # HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Explorer\VolumeCaches
-    # See link at top of file.
-    import winreg
-
-    kn = r"Software\Microsoft\Windows\CurrentVersion\Explorer\VolumeCaches\%s" % (
-        EmptyVolumeCache._reg_desc_,
-    )
-    key = winreg.CreateKey(winreg.HKEY_LOCAL_MACHINE, kn)
-    winreg.SetValueEx(key, None, 0, winreg.REG_SZ, EmptyVolumeCache._reg_clsid_)
-
-
-def DllUnregisterServer():
-    import winreg
-
-    kn = r"Software\Microsoft\Windows\CurrentVersion\Explorer\VolumeCaches\%s" % (
-        EmptyVolumeCache._reg_desc_,
-    )
-    try:
-        key = winreg.DeleteKey(winreg.HKEY_LOCAL_MACHINE, kn)
-    except WindowsError as details:
-        import errno
-
-        if details.errno != errno.ENOENT:
-            raise
-    print(EmptyVolumeCache._reg_desc_, "unregistration complete.")
-
-
-if __name__ == "__main__":
-    from win32com.server import register
-
-    register.UseCommandLine(
-        EmptyVolumeCache,
-        finalize_register=DllRegisterServer,
-        finalize_unregister=DllUnregisterServer,
-    )
diff --git a/lib/win32comext/shell/demos/servers/folder_view.py b/lib/win32comext/shell/demos/servers/folder_view.py
deleted file mode 100644
index 383270df..00000000
--- a/lib/win32comext/shell/demos/servers/folder_view.py
+++ /dev/null
@@ -1,862 +0,0 @@
-# This is a port of the Vista SDK "FolderView" sample, and associated
-# notes at http://shellrevealed.com/blogs/shellblog/archive/2007/03/15/Shell-Namespace-Extension_3A00_-Creating-and-Using-the-System-Folder-View-Object.aspx
-# A key difference to shell_view.py is that this version uses the default
-# IShellView provided by the shell (via SHCreateShellFolderView) rather
-# than our own.
-# XXX - sadly, it doesn't work quite like the original sample.  Oh well,
-# another day...
-import os
-import pickle
-import random
-import sys
-
-import commctrl
-import pythoncom
-import win32api
-import win32con
-import winerror
-import winxpgui as win32gui  # the needs vista, let alone xp!
-from win32com.axcontrol import axcontrol  # IObjectWithSite
-from win32com.propsys import propsys
-from win32com.server.exception import COMException
-from win32com.server.util import NewEnum as _NewEnum, wrap as _wrap
-from win32com.shell import shell, shellcon
-from win32com.util import IIDToInterfaceName
-
-GUID = pythoncom.MakeIID
-
-# If set, output spews to the win32traceutil collector...
-debug = 0
-
-
-# wrap a python object in a COM pointer
-def wrap(ob, iid=None):
-    return _wrap(ob, iid, useDispatcher=(debug > 0))
-
-
-def NewEnum(seq, iid):
-    return _NewEnum(seq, iid=iid, useDispatcher=(debug > 0))
-
-
-# The sample makes heavy use of "string ids" (ie, integer IDs defined in .h
-# files, loaded at runtime from a (presumably localized) DLL.  We cheat.
-_sids = {}  # strings, indexed bystring_id,
-
-
-def LoadString(sid):
-    return _sids[sid]
-
-
-# fn to create a unique string ID
-_last_ids = 0
-
-
-def _make_ids(s):
-    global _last_ids
-    _last_ids += 1
-    _sids[_last_ids] = s
-    return _last_ids
-
-
-# These strings are what the user sees and would be localized.
-# XXX - its possible that the shell might persist these values, so
-# this scheme wouldn't really be suitable in a real ap.
-IDS_UNSPECIFIED = _make_ids("unspecified")
-IDS_SMALL = _make_ids("small")
-IDS_MEDIUM = _make_ids("medium")
-IDS_LARGE = _make_ids("large")
-IDS_CIRCLE = _make_ids("circle")
-IDS_TRIANGLE = _make_ids("triangle")
-IDS_RECTANGLE = _make_ids("rectangle")
-IDS_POLYGON = _make_ids("polygon")
-IDS_DISPLAY = _make_ids("Display")
-IDS_DISPLAY_TT = _make_ids("Display the item.")
-IDS_SETTINGS = _make_ids("Settings")
-IDS_SETTING1 = _make_ids("Setting 1")
-IDS_SETTING2 = _make_ids("Setting 2")
-IDS_SETTING3 = _make_ids("Setting 3")
-IDS_SETTINGS_TT = _make_ids("Modify settings.")
-IDS_SETTING1_TT = _make_ids("Modify setting 1.")
-IDS_SETTING2_TT = _make_ids("Modify setting 2.")
-IDS_SETTING3_TT = _make_ids("Modify setting 3.")
-IDS_LESSTHAN5 = _make_ids("Less Than 5")
-IDS_5ORGREATER = _make_ids("Five or Greater")
-del _make_ids, _last_ids
-
-# Other misc resource stuff
-IDI_ICON1 = 100
-IDI_SETTINGS = 101
-
-# The sample defines a number of "category ids".  Each one gets
-# its own GUID.
-CAT_GUID_NAME = GUID("{de094c9d-c65a-11dc-ba21-005056c00008}")
-CAT_GUID_SIZE = GUID("{de094c9e-c65a-11dc-ba21-005056c00008}")
-CAT_GUID_SIDES = GUID("{de094c9f-c65a-11dc-ba21-005056c00008}")
-CAT_GUID_LEVEL = GUID("{de094ca0-c65a-11dc-ba21-005056c00008}")
-# The next category guid is NOT based on a column (see
-# ViewCategoryProvider::EnumCategories()...)
-CAT_GUID_VALUE = "{de094ca1-c65a-11dc-ba21-005056c00008}"
-
-GUID_Display = GUID("{4d6c2fdd-c689-11dc-ba21-005056c00008}")
-GUID_Settings = GUID("{4d6c2fde-c689-11dc-ba21-005056c00008}")
-GUID_Setting1 = GUID("{4d6c2fdf-c689-11dc-ba21-005056c00008}")
-GUID_Setting2 = GUID("{4d6c2fe0-c689-11dc-ba21-005056c00008}")
-GUID_Setting3 = GUID("{4d6c2fe1-c689-11dc-ba21-005056c00008}")
-
-# Hrm - not sure what to do about the std keys.
-# Probably need a simple parser for propkey.h
-PKEY_ItemNameDisplay = ("{B725F130-47EF-101A-A5F1-02608C9EEBAC}", 10)
-PKEY_PropList_PreviewDetails = ("{C9944A21-A406-48FE-8225-AEC7E24C211B}", 8)
-
-# Not sure what the "3" here refers to - docs say PID_FIRST_USABLE (2) be
-# used.  Presumably it is the 'propID' value in the .propdesc file!
-# note that the following GUIDs are also references in the .propdesc file
-PID_SOMETHING = 3
-# These are our 'private' PKEYs
-# Col 2, name="Sample.AreaSize"
-PKEY_Sample_AreaSize = ("{d6f5e341-c65c-11dc-ba21-005056c00008}", PID_SOMETHING)
-# Col 3, name="Sample.NumberOfSides"
-PKEY_Sample_NumberOfSides = ("{d6f5e342-c65c-11dc-ba21-005056c00008}", PID_SOMETHING)
-# Col 4, name="Sample.DirectoryLevel"
-PKEY_Sample_DirectoryLevel = ("{d6f5e343-c65c-11dc-ba21-005056c00008}", PID_SOMETHING)
-
-
-# We construct a PIDL from a pickle of a dict - turn it back into a
-# dict (we should *never* be called with a PIDL that the last elt is not
-# ours, so it is safe to assume we created it (assume->"ass" = "u" + "me" :)
-def pidl_to_item(pidl):
-    # Note that only the *last* elt in the PIDL is certainly ours,
-    # but it contains everything we need encoded as a dict.
-    return pickle.loads(pidl[-1])
-
-
-# Start of msdn sample port...
-# make_item_enum replaces the sample's entire EnumIDList.cpp :)
-def make_item_enum(level, flags):
-    pidls = []
-    nums = """zero one two three four five size seven eight nine ten""".split()
-    for i, name in enumerate(nums):
-        size = random.randint(0, 255)
-        sides = 1
-        while sides in [1, 2]:
-            sides = random.randint(0, 5)
-        is_folder = (i % 2) != 0
-        # check the flags say to include it.
-        # (This seems strange; if you ask the same folder for, but appear
-        skip = False
-        if not (flags & shellcon.SHCONTF_STORAGE):
-            if is_folder:
-                skip = not (flags & shellcon.SHCONTF_FOLDERS)
-            else:
-                skip = not (flags & shellcon.SHCONTF_NONFOLDERS)
-        if not skip:
-            data = dict(
-                name=name, size=size, sides=sides, level=level, is_folder=is_folder
-            )
-            pidls.append([pickle.dumps(data)])
-    return NewEnum(pidls, shell.IID_IEnumIDList)
-
-
-# start of Utils.cpp port
-def DisplayItem(shell_item_array, hwnd_parent=0):
-    # Get the first ShellItem and display its name
-    if shell_item_array is None:
-        msg = "You must select something!"
-    else:
-        si = shell_item_array.GetItemAt(0)
-        name = si.GetDisplayName(shellcon.SIGDN_NORMALDISPLAY)
-        msg = "%d items selected, first is %r" % (shell_item_array.GetCount(), name)
-    win32gui.MessageBox(hwnd_parent, msg, "Hello", win32con.MB_OK)
-
-
-# end of Utils.cpp port
-
-
-# start of sample's FVCommands.cpp port
-class Command:
-    def __init__(self, guid, ids, ids_tt, idi, flags, callback, children):
-        self.guid = guid
-        self.ids = ids
-        self.ids_tt = ids_tt
-        self.idi = idi
-        self.flags = flags
-        self.callback = callback
-        self.children = children
-        assert not children or isinstance(children[0], Command)
-
-    def tuple(self):
-        return (
-            self.guid,
-            self.ids,
-            self.ids_tt,
-            self.idi,
-            self.flags,
-            self.callback,
-            self.children,
-        )
-
-
-# command callbacks - called back directly by us - see ExplorerCommand.Invoke
-def onDisplay(items, bindctx):
-    DisplayItem(items)
-
-
-def onSetting1(items, bindctx):
-    win32gui.MessageBox(0, LoadString(IDS_SETTING1), "Hello", win32con.MB_OK)
-
-
-def onSetting2(items, bindctx):
-    win32gui.MessageBox(0, LoadString(IDS_SETTING2), "Hello", win32con.MB_OK)
-
-
-def onSetting3(items, bindctx):
-    win32gui.MessageBox(0, LoadString(IDS_SETTING3), "Hello", win32con.MB_OK)
-
-
-taskSettings = [
-    Command(
-        GUID_Setting1, IDS_SETTING1, IDS_SETTING1_TT, IDI_SETTINGS, 0, onSetting1, None
-    ),
-    Command(
-        GUID_Setting2, IDS_SETTING2, IDS_SETTING2_TT, IDI_SETTINGS, 0, onSetting2, None
-    ),
-    Command(
-        GUID_Setting3, IDS_SETTING3, IDS_SETTING3_TT, IDI_SETTINGS, 0, onSetting3, None
-    ),
-]
-
-tasks = [
-    Command(GUID_Display, IDS_DISPLAY, IDS_DISPLAY_TT, IDI_ICON1, 0, onDisplay, None),
-    Command(
-        GUID_Settings,
-        IDS_SETTINGS,
-        IDS_SETTINGS_TT,
-        IDI_SETTINGS,
-        shellcon.ECF_HASSUBCOMMANDS,
-        None,
-        taskSettings,
-    ),
-]
-
-
-class ExplorerCommandProvider:
-    _com_interfaces_ = [shell.IID_IExplorerCommandProvider]
-    _public_methods_ = shellcon.IExplorerCommandProvider_Methods
-
-    def GetCommands(self, site, iid):
-        items = [wrap(ExplorerCommand(t)) for t in tasks]
-        return NewEnum(items, shell.IID_IEnumExplorerCommand)
-
-
-class ExplorerCommand:
-    _com_interfaces_ = [shell.IID_IExplorerCommand]
-    _public_methods_ = shellcon.IExplorerCommand_Methods
-
-    def __init__(self, cmd):
-        self.cmd = cmd
-
-    # The sample also appears to ignore the pidl args!?
-    def GetTitle(self, pidl):
-        return LoadString(self.cmd.ids)
-
-    def GetToolTip(self, pidl):
-        return LoadString(self.cmd.ids_tt)
-
-    def GetIcon(self, pidl):
-        # Return a string of the usual "dll,resource_id" format
-        # todo - just return any ".ico that comes with python" + ",0" :)
-        raise COMException(hresult=winerror.E_NOTIMPL)
-
-    def GetState(self, shell_items, slow_ok):
-        return shellcon.ECS_ENABLED
-
-    def GetFlags(self):
-        return self.cmd.flags
-
-    def GetCanonicalName(self):
-        return self.cmd.guid
-
-    def Invoke(self, items, bind_ctx):
-        # If no function defined - just return S_OK
-        if self.cmd.callback:
-            self.cmd.callback(items, bind_ctx)
-        else:
-            print("No callback for command ", LoadString(self.cmd.ids))
-
-    def EnumSubCommands(self):
-        if not self.cmd.children:
-            return None
-        items = [wrap(ExplorerCommand(c)) for c in self.cmd.children]
-        return NewEnum(items, shell.IID_IEnumExplorerCommand)
-
-
-# end of sample's FVCommands.cpp port
-
-
-# start of sample's Category.cpp port
-class FolderViewCategorizer:
-    _com_interfaces_ = [shell.IID_ICategorizer]
-    _public_methods_ = shellcon.ICategorizer_Methods
-
-    description = None  # subclasses should set their own
-
-    def __init__(self, shell_folder):
-        self.sf = shell_folder
-
-    #  Determines the relative order of two items in their item identifier lists.
-    def CompareCategory(self, flags, cat1, cat2):
-        return cat1 - cat2
-
-    #  Retrieves the name of a categorizer, such as "Group By Device
-    #  Type", that can be displayed in the user interface.
-    def GetDescription(self, cch):
-        return self.description
-
-    # Retrieves information about a category, such as the default
-    # display and the text to display in the user interface.
-    def GetCategoryInfo(self, catid):
-        # Note: this isn't always appropriate!  See overrides below
-        return 0, str(catid)  # ????
-
-
-class FolderViewCategorizer_Name(FolderViewCategorizer):
-    description = "Alphabetical"
-
-    def GetCategory(self, pidls):
-        ret = []
-        for pidl in pidls:
-            val = self.sf.GetDetailsEx(pidl, PKEY_ItemNameDisplay)
-            ret.append(val)
-        return ret
-
-
-class FolderViewCategorizer_Size(FolderViewCategorizer):
-    description = "Group By Size"
-
-    def GetCategory(self, pidls):
-        ret = []
-        for pidl in pidls:
-            # Why don't we just get the size of the PIDL?
-            val = self.sf.GetDetailsEx(pidl, PKEY_Sample_AreaSize)
-            val = int(val)  # it probably came in a VT_BSTR variant
-            if val < 255 // 3:
-                cid = IDS_SMALL
-            elif val < 2 * 255 // 3:
-                cid = IDS_MEDIUM
-            else:
-                cid = IDS_LARGE
-            ret.append(cid)
-        return ret
-
-    def GetCategoryInfo(self, catid):
-        return 0, LoadString(catid)
-
-
-class FolderViewCategorizer_Sides(FolderViewCategorizer):
-    description = "Group By Sides"
-
-    def GetCategory(self, pidls):
-        ret = []
-        for pidl in pidls:
-            val = self.sf.GetDetailsEx(pidl, PKEY_ItemNameDisplay)
-            if val == 0:
-                cid = IDS_CIRCLE
-            elif val == 3:
-                cid = IDS_TRIANGLE
-            elif val == 4:
-                cid = IDS_RECTANGLE
-            elif val == 5:
-                cid = IDS_POLYGON
-            else:
-                cid = IDS_UNSPECIFIED
-            ret.append(cid)
-        return ret
-
-    def GetCategoryInfo(self, catid):
-        return 0, LoadString(catid)
-
-
-class FolderViewCategorizer_Value(FolderViewCategorizer):
-    description = "Group By Value"
-
-    def GetCategory(self, pidls):
-        ret = []
-        for pidl in pidls:
-            val = self.sf.GetDetailsEx(pidl, PKEY_ItemNameDisplay)
-            if val in "one two three four".split():
-                ret.append(IDS_LESSTHAN5)
-            else:
-                ret.append(IDS_5ORGREATER)
-        return ret
-
-    def GetCategoryInfo(self, catid):
-        return 0, LoadString(catid)
-
-
-class FolderViewCategorizer_Level(FolderViewCategorizer):
-    description = "Group By Value"
-
-    def GetCategory(self, pidls):
-        return [
-            self.sf.GetDetailsEx(pidl, PKEY_Sample_DirectoryLevel) for pidl in pidls
-        ]
-
-
-class ViewCategoryProvider:
-    _com_interfaces_ = [shell.IID_ICategoryProvider]
-    _public_methods_ = shellcon.ICategoryProvider_Methods
-
-    def __init__(self, shell_folder):
-        self.shell_folder = shell_folder
-
-    def CanCategorizeOnSCID(self, pkey):
-        return pkey in [
-            PKEY_ItemNameDisplay,
-            PKEY_Sample_AreaSize,
-            PKEY_Sample_NumberOfSides,
-            PKEY_Sample_DirectoryLevel,
-        ]
-
-    #  Creates a category object.
-    def CreateCategory(self, guid, iid):
-        if iid == shell.IID_ICategorizer:
-            if guid == CAT_GUID_NAME:
-                klass = FolderViewCategorizer_Name
-            elif guid == CAT_GUID_SIDES:
-                klass = FolderViewCategorizer_Sides
-            elif guid == CAT_GUID_SIZE:
-                klass = FolderViewCategorizer_Size
-            elif guid == CAT_GUID_VALUE:
-                klass = FolderViewCategorizer_Value
-            elif guid == CAT_GUID_LEVEL:
-                klass = FolderViewCategorizer_Level
-            else:
-                raise COMException(hresult=winerror.E_INVALIDARG)
-            return wrap(klass(self.shell_folder))
-        raise COMException(hresult=winerror.E_NOINTERFACE)
-
-    #  Retrieves the enumerator for the categories.
-    def EnumCategories(self):
-        # These are additional categories beyond the columns
-        seq = [CAT_GUID_VALUE]
-        return NewEnum(seq, pythoncom.IID_IEnumGUID)
-
-    #  Retrieves a globally unique identifier (GUID) that represents
-    #  the categorizer to use for the specified Shell column.
-    def GetCategoryForSCID(self, scid):
-        if scid == PKEY_ItemNameDisplay:
-            guid = CAT_GUID_NAME
-        elif scid == PKEY_Sample_AreaSize:
-            guid = CAT_GUID_SIZE
-        elif scid == PKEY_Sample_NumberOfSides:
-            guid = CAT_GUID_SIDES
-        elif scid == PKEY_Sample_DirectoryLevel:
-            guid = CAT_GUID_LEVEL
-        elif scid == pythoncom.IID_NULL:
-            # This can be called with a NULL
-            # format ID. This will happen if you have a category,
-            # not based on a column, that gets stored in the
-            # property bag. When a return is made to this item,
-            # it will call this function with a NULL format id.
-            guid = CAT_GUID_VALUE
-        else:
-            raise COMException(hresult=winerror.E_INVALIDARG)
-        return guid
-
-    #  Retrieves the name of the specified category. This is where
-    #  additional categories that appear under the column
-    #  related categories in the UI, get their display names.
-    def GetCategoryName(self, guid, cch):
-        if guid == CAT_GUID_VALUE:
-            return "Value"
-        raise COMException(hresult=winerror.E_FAIL)
-
-    #  Enables the folder to override the default grouping.
-    def GetDefaultCategory(self):
-        return CAT_GUID_LEVEL, (pythoncom.IID_NULL, 0)
-
-
-# end of sample's Category.cpp port
-
-# start of sample's ContextMenu.cpp port
-MENUVERB_DISPLAY = 0
-
-folderViewImplContextMenuIDs = [
-    (
-        "display",
-        MENUVERB_DISPLAY,
-        0,
-    ),
-]
-
-
-class ContextMenu:
-    _reg_progid_ = "Python.ShellFolderSample.ContextMenu"
-    _reg_desc_ = "Python FolderView Context Menu"
-    _reg_clsid_ = "{fed40039-021f-4011-87c5-6188b9979764}"
-    _com_interfaces_ = [
-        shell.IID_IShellExtInit,
-        shell.IID_IContextMenu,
-        axcontrol.IID_IObjectWithSite,
-    ]
-    _public_methods_ = (
-        shellcon.IContextMenu_Methods
-        + shellcon.IShellExtInit_Methods
-        + ["GetSite", "SetSite"]
-    )
-    _context_menu_type_ = "PythonFolderViewSampleType"
-
-    def __init__(self):
-        self.site = None
-        self.dataobj = None
-
-    def Initialize(self, folder, dataobj, hkey):
-        self.dataobj = dataobj
-
-    def QueryContextMenu(self, hMenu, indexMenu, idCmdFirst, idCmdLast, uFlags):
-        s = LoadString(IDS_DISPLAY)
-        win32gui.InsertMenu(
-            hMenu, indexMenu, win32con.MF_BYPOSITION, idCmdFirst + MENUVERB_DISPLAY, s
-        )
-        indexMenu += 1
-        # other verbs could go here...
-
-        # indicate that we added one verb.
-        return 1
-
-    def InvokeCommand(self, ci):
-        mask, hwnd, verb, params, dir, nShow, hotkey, hicon = ci
-        # this seems very convuluted, but its what the sample does :)
-        for verb_name, verb_id, flag in folderViewImplContextMenuIDs:
-            if isinstance(verb, int):
-                matches = verb == verb_id
-            else:
-                matches = verb == verb_name
-            if matches:
-                break
-        else:
-            assert False, ci  # failed to find our ID
-        if verb_id == MENUVERB_DISPLAY:
-            sia = shell.SHCreateShellItemArrayFromDataObject(self.dataobj)
-            DisplayItem(hwnd, sia)
-        else:
-            assert False, ci  # Got some verb we weren't expecting?
-
-    def GetCommandString(self, cmd, typ):
-        raise COMException(hresult=winerror.E_NOTIMPL)
-
-    def SetSite(self, site):
-        self.site = site
-
-    def GetSite(self, iid):
-        return self.site
-
-
-# end of sample's ContextMenu.cpp port
-
-
-# start of sample's ShellFolder.cpp port
-class ShellFolder:
-    _com_interfaces_ = [
-        shell.IID_IBrowserFrameOptions,
-        pythoncom.IID_IPersist,
-        shell.IID_IPersistFolder,
-        shell.IID_IPersistFolder2,
-        shell.IID_IShellFolder,
-        shell.IID_IShellFolder2,
-    ]
-
-    _public_methods_ = (
-        shellcon.IBrowserFrame_Methods
-        + shellcon.IPersistFolder2_Methods
-        + shellcon.IShellFolder2_Methods
-    )
-
-    _reg_progid_ = "Python.ShellFolderSample.Folder2"
-    _reg_desc_ = "Python FolderView sample"
-    _reg_clsid_ = "{bb8c24ad-6aaa-4cec-ac5e-c429d5f57627}"
-
-    max_levels = 5
-
-    def __init__(self, level=0):
-        self.current_level = level
-        self.pidl = None  # set when Initialize is called
-
-    def ParseDisplayName(self, hwnd, reserved, displayName, attr):
-        # print "ParseDisplayName", displayName
-        raise COMException(hresult=winerror.E_NOTIMPL)
-
-    def EnumObjects(self, hwndOwner, flags):
-        if self.current_level >= self.max_levels:
-            return None
-        return make_item_enum(self.current_level + 1, flags)
-
-    def BindToObject(self, pidl, bc, iid):
-        tail = pidl_to_item(pidl)
-        # assert tail['is_folder'], "BindToObject should only be called on folders?"
-        # *sob*
-        # No point creating object just to have QI fail.
-        if iid not in ShellFolder._com_interfaces_:
-            raise COMException(hresult=winerror.E_NOTIMPL)
-        child = ShellFolder(self.current_level + 1)
-        # hrmph - not sure what multiple PIDLs here mean?
-        #        assert len(pidl)==1, pidl # expecting just relative child PIDL
-        child.Initialize(self.pidl + pidl)
-        return wrap(child, iid)
-
-    def BindToStorage(self, pidl, bc, iid):
-        return self.BindToObject(pidl, bc, iid)
-
-    def CompareIDs(self, param, id1, id2):
-        return 0  # XXX - todo - implement this!
-
-    def CreateViewObject(self, hwnd, iid):
-        if iid == shell.IID_IShellView:
-            com_folder = wrap(self)
-            return shell.SHCreateShellFolderView(com_folder)
-        elif iid == shell.IID_ICategoryProvider:
-            return wrap(ViewCategoryProvider(self))
-        elif iid == shell.IID_IContextMenu:
-            ws = wrap(self)
-            dcm = (hwnd, None, self.pidl, ws, None)
-            return shell.SHCreateDefaultContextMenu(dcm, iid)
-        elif iid == shell.IID_IExplorerCommandProvider:
-            return wrap(ExplorerCommandProvider())
-        else:
-            raise COMException(hresult=winerror.E_NOINTERFACE)
-
-    def GetAttributesOf(self, pidls, attrFlags):
-        assert len(pidls) == 1, "sample only expects 1 too!"
-        assert len(pidls[0]) == 1, "expect relative pidls!"
-        item = pidl_to_item(pidls[0])
-        flags = 0
-        if item["is_folder"]:
-            flags |= shellcon.SFGAO_FOLDER
-        if item["level"] < self.max_levels:
-            flags |= shellcon.SFGAO_HASSUBFOLDER
-        return flags
-
-    #  Retrieves an OLE interface that can be used to carry out
-    #  actions on the specified file objects or folders.
-    def GetUIObjectOf(self, hwndOwner, pidls, iid, inout):
-        assert len(pidls) == 1, "oops - arent expecting more than one!"
-        assert len(pidls[0]) == 1, "assuming relative pidls!"
-        item = pidl_to_item(pidls[0])
-        if iid == shell.IID_IContextMenu:
-            ws = wrap(self)
-            dcm = (hwndOwner, None, self.pidl, ws, pidls)
-            return shell.SHCreateDefaultContextMenu(dcm, iid)
-        elif iid == shell.IID_IExtractIconW:
-            dxi = shell.SHCreateDefaultExtractIcon()
-            # dxi is IDefaultExtractIconInit
-            if item["is_folder"]:
-                dxi.SetNormalIcon("shell32.dll", 4)
-            else:
-                dxi.SetNormalIcon("shell32.dll", 1)
-            # just return the dxi - let Python QI for IID_IExtractIconW
-            return dxi
-
-        elif iid == pythoncom.IID_IDataObject:
-            return shell.SHCreateDataObject(self.pidl, pidls, None, iid)
-
-        elif iid == shell.IID_IQueryAssociations:
-            elts = []
-            if item["is_folder"]:
-                elts.append((shellcon.ASSOCCLASS_FOLDER, None, None))
-            elts.append(
-                (shellcon.ASSOCCLASS_PROGID_STR, None, ContextMenu._context_menu_type_)
-            )
-            return shell.AssocCreateForClasses(elts, iid)
-
-        raise COMException(hresult=winerror.E_NOINTERFACE)
-
-    #  Retrieves the display name for the specified file object or subfolder.
-    def GetDisplayNameOf(self, pidl, flags):
-        item = pidl_to_item(pidl)
-        if flags & shellcon.SHGDN_FORPARSING:
-            if flags & shellcon.SHGDN_INFOLDER:
-                return item["name"]
-            else:
-                if flags & shellcon.SHGDN_FORADDRESSBAR:
-                    sigdn = shellcon.SIGDN_DESKTOPABSOLUTEEDITING
-                else:
-                    sigdn = shellcon.SIGDN_DESKTOPABSOLUTEPARSING
-                parent = shell.SHGetNameFromIDList(self.pidl, sigdn)
-                return parent + "\\" + item["name"]
-        else:
-            return item["name"]
-
-    def SetNameOf(self, hwndOwner, pidl, new_name, flags):
-        raise COMException(hresult=winerror.E_NOTIMPL)
-
-    def GetClassID(self):
-        return self._reg_clsid_
-
-    #  IPersistFolder method
-    def Initialize(self, pidl):
-        self.pidl = pidl
-
-    #  IShellFolder2 methods
-    def EnumSearches(self):
-        raise COMException(hresult=winerror.E_NOINTERFACE)
-
-    #  Retrieves the default sorting and display columns.
-    def GetDefaultColumn(self, dwres):
-        # result is (sort, display)
-        return 0, 0
-
-    #  Retrieves the default state for a specified column.
-    def GetDefaultColumnState(self, iCol):
-        if iCol < 3:
-            return shellcon.SHCOLSTATE_ONBYDEFAULT | shellcon.SHCOLSTATE_TYPE_STR
-        raise COMException(hresult=winerror.E_INVALIDARG)
-
-    #  Requests the GUID of the default search object for the folder.
-    def GetDefaultSearchGUID(self):
-        raise COMException(hresult=winerror.E_NOTIMPL)
-
-    #  Helper function for getting the display name for a column.
-    def _GetColumnDisplayName(self, pidl, pkey):
-        item = pidl_to_item(pidl)
-        is_folder = item["is_folder"]
-        if pkey == PKEY_ItemNameDisplay:
-            val = item["name"]
-        elif pkey == PKEY_Sample_AreaSize and not is_folder:
-            val = "%d Sq. Ft." % item["size"]
-        elif pkey == PKEY_Sample_NumberOfSides and not is_folder:
-            val = str(item["sides"])  # not sure why str()
-        elif pkey == PKEY_Sample_DirectoryLevel:
-            val = str(item["level"])
-        else:
-            val = ""
-        return val
-
-    #  Retrieves detailed information, identified by a
-    #  property set ID (FMTID) and property ID (PID),
-    #  on an item in a Shell folder.
-    def GetDetailsEx(self, pidl, pkey):
-        item = pidl_to_item(pidl)
-        is_folder = item["is_folder"]
-        if not is_folder and pkey == PKEY_PropList_PreviewDetails:
-            return "prop:Sample.AreaSize;Sample.NumberOfSides;Sample.DirectoryLevel"
-        return self._GetColumnDisplayName(pidl, pkey)
-
-    #  Retrieves detailed information, identified by a
-    #  column index, on an item in a Shell folder.
-    def GetDetailsOf(self, pidl, iCol):
-        key = self.MapColumnToSCID(iCol)
-        if pidl is None:
-            data = [
-                (commctrl.LVCFMT_LEFT, "Name"),
-                (commctrl.LVCFMT_CENTER, "Size"),
-                (commctrl.LVCFMT_CENTER, "Sides"),
-                (commctrl.LVCFMT_CENTER, "Level"),
-            ]
-            if iCol >= len(data):
-                raise COMException(hresult=winerror.E_FAIL)
-            fmt, val = data[iCol]
-        else:
-            fmt = 0  # ?
-            val = self._GetColumnDisplayName(pidl, key)
-        cxChar = 24
-        return fmt, cxChar, val
-
-    #  Converts a column name to the appropriate
-    #  property set ID (FMTID) and property ID (PID).
-    def MapColumnToSCID(self, iCol):
-        data = [
-            PKEY_ItemNameDisplay,
-            PKEY_Sample_AreaSize,
-            PKEY_Sample_NumberOfSides,
-            PKEY_Sample_DirectoryLevel,
-        ]
-        if iCol >= len(data):
-            raise COMException(hresult=winerror.E_FAIL)
-        return data[iCol]
-
-    #  IPersistFolder2 methods
-    #  Retrieves the PIDLIST_ABSOLUTE for the folder object.
-    def GetCurFolder(self):
-        # The docs say this is OK, but I suspect its a problem in this case :)
-        # assert self.pidl, "haven't been initialized?"
-        return self.pidl
-
-
-# end of sample's ShellFolder.cpp port
-
-
-def get_schema_fname():
-    me = win32api.GetFullPathName(__file__)
-    sc = os.path.splitext(me)[0] + ".propdesc"
-    assert os.path.isfile(sc), sc
-    return sc
-
-
-def DllRegisterServer():
-    import winreg
-
-    if sys.getwindowsversion()[0] < 6:
-        print("This sample only works on Vista")
-        sys.exit(1)
-
-    key = winreg.CreateKey(
-        winreg.HKEY_LOCAL_MACHINE,
-        "SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\"
-        "Explorer\\Desktop\\Namespace\\" + ShellFolder._reg_clsid_,
-    )
-    winreg.SetValueEx(key, None, 0, winreg.REG_SZ, ShellFolder._reg_desc_)
-    # And special shell keys under our CLSID
-    key = winreg.CreateKey(
-        winreg.HKEY_CLASSES_ROOT, "CLSID\\" + ShellFolder._reg_clsid_ + "\\ShellFolder"
-    )
-    # 'Attributes' is an int stored as a binary! use struct
-    attr = (
-        shellcon.SFGAO_FOLDER | shellcon.SFGAO_HASSUBFOLDER | shellcon.SFGAO_BROWSABLE
-    )
-    import struct
-
-    s = struct.pack("i", attr)
-    winreg.SetValueEx(key, "Attributes", 0, winreg.REG_BINARY, s)
-    # register the context menu handler under the FolderViewSampleType type.
-    keypath = "%s\\shellex\\ContextMenuHandlers\\%s" % (
-        ContextMenu._context_menu_type_,
-        ContextMenu._reg_desc_,
-    )
-    key = winreg.CreateKey(winreg.HKEY_CLASSES_ROOT, keypath)
-    winreg.SetValueEx(key, None, 0, winreg.REG_SZ, ContextMenu._reg_clsid_)
-    propsys.PSRegisterPropertySchema(get_schema_fname())
-    print(ShellFolder._reg_desc_, "registration complete.")
-
-
-def DllUnregisterServer():
-    import winreg
-
-    paths = [
-        "SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Explorer\\Desktop\\Namespace\\"
-        + ShellFolder._reg_clsid_,
-        "%s\\shellex\\ContextMenuHandlers\\%s"
-        % (ContextMenu._context_menu_type_, ContextMenu._reg_desc_),
-    ]
-    for path in paths:
-        try:
-            winreg.DeleteKey(winreg.HKEY_LOCAL_MACHINE, path)
-        except WindowsError as details:
-            import errno
-
-            if details.errno != errno.ENOENT:
-                print("FAILED to remove %s: %s" % (path, details))
-
-    propsys.PSUnregisterPropertySchema(get_schema_fname())
-    print(ShellFolder._reg_desc_, "unregistration complete.")
-
-
-if __name__ == "__main__":
-    from win32com.server import register
-
-    register.UseCommandLine(
-        ShellFolder,
-        ContextMenu,
-        debug=debug,
-        finalize_register=DllRegisterServer,
-        finalize_unregister=DllUnregisterServer,
-    )
diff --git a/lib/win32comext/shell/demos/servers/icon_handler.py b/lib/win32comext/shell/demos/servers/icon_handler.py
deleted file mode 100644
index 57aa3611..00000000
--- a/lib/win32comext/shell/demos/servers/icon_handler.py
+++ /dev/null
@@ -1,82 +0,0 @@
-# A sample icon handler.  Sets the icon for Python files to a random
-# ICO file.  ICO files are found in the Python directory - generally there will
-# be 3 icons found.
-#
-# To demostrate:
-# * Execute this script to register the context menu.
-# * Open Windows Explorer, and browse to a directory with a .py file.
-# * Note the pretty, random selection of icons!
-# Use glob to locate ico files, and random.choice to pick one.
-import glob
-import os
-import random
-import sys
-
-import pythoncom
-import win32gui
-import winerror
-from win32com.shell import shell, shellcon
-
-ico_files = glob.glob(os.path.join(sys.prefix, "*.ico"))
-if not ico_files:
-    ico_files = glob.glob(os.path.join(sys.prefix, "PC", "*.ico"))
-if not ico_files:
-    print("WARNING: Can't find any icon files")
-
-# Our shell extension.
-IExtractIcon_Methods = "Extract GetIconLocation".split()
-IPersistFile_Methods = "IsDirty Load Save SaveCompleted GetCurFile".split()
-
-
-class ShellExtension:
-    _reg_progid_ = "Python.ShellExtension.IconHandler"
-    _reg_desc_ = "Python Sample Shell Extension (icon handler)"
-    _reg_clsid_ = "{a97e32d7-3b78-448c-b341-418120ea9227}"
-    _com_interfaces_ = [shell.IID_IExtractIcon, pythoncom.IID_IPersistFile]
-    _public_methods_ = IExtractIcon_Methods + IPersistFile_Methods
-
-    def Load(self, filename, mode):
-        self.filename = filename
-        self.mode = mode
-
-    def GetIconLocation(self, flags):
-        # note - returning a single int will set the HRESULT (eg, S_FALSE,
-        # E_PENDING - see MS docs for details.
-        return random.choice(ico_files), 0, 0
-
-    def Extract(self, fname, index, size):
-        return winerror.S_FALSE
-
-
-def DllRegisterServer():
-    import winreg
-
-    key = winreg.CreateKey(winreg.HKEY_CLASSES_ROOT, "Python.File\\shellex")
-    subkey = winreg.CreateKey(key, "IconHandler")
-    winreg.SetValueEx(subkey, None, 0, winreg.REG_SZ, ShellExtension._reg_clsid_)
-    print(ShellExtension._reg_desc_, "registration complete.")
-
-
-def DllUnregisterServer():
-    import winreg
-
-    try:
-        key = winreg.DeleteKey(
-            winreg.HKEY_CLASSES_ROOT, "Python.File\\shellex\\IconHandler"
-        )
-    except WindowsError as details:
-        import errno
-
-        if details.errno != errno.ENOENT:
-            raise
-    print(ShellExtension._reg_desc_, "unregistration complete.")
-
-
-if __name__ == "__main__":
-    from win32com.server import register
-
-    register.UseCommandLine(
-        ShellExtension,
-        finalize_register=DllRegisterServer,
-        finalize_unregister=DllUnregisterServer,
-    )
diff --git a/lib/win32comext/shell/demos/servers/shell_view.py b/lib/win32comext/shell/demos/servers/shell_view.py
deleted file mode 100644
index 7d8bc51b..00000000
--- a/lib/win32comext/shell/demos/servers/shell_view.py
+++ /dev/null
@@ -1,972 +0,0 @@
-# A sample shell namespace view
-
-# To demostrate:
-# * Execute this script to register the namespace.
-# * Open Windows Explorer, and locate the new "Python Path Shell Browser"
-#   folder off "My Computer"
-# * Browse this tree - .py files are shown expandable, with classes and
-#   methods selectable.  Selecting a Python file, or a class/method, will
-#   display the file using Scintilla.
-# Known problems:
-# * Classes and methods don't have icons - this is a demo, so we keep it small
-#   See icon_handler.py for examples of how to work with icons.
-#
-#
-# Notes on PIDLs
-# PIDLS are complicated, but fairly well documented in MSDN.  If you need to
-# do much with these shell extensions, you must understand their concept.
-# Here is a short-course, as it applies to this sample:
-# A PIDL identifies an item, much in the same way that a filename does
-# (however, the shell is not limited to displaying "files").
-# An "ItemID" is a single string, each being an item in the hierarchy.
-# A "PIDL" is a list of these strings.
-# All shell etc functions work with PIDLs, so even in the case where
-# an ItemID is conceptually used, a 1-item list is always used.
-# Conceptually, think of:
-#    pidl = pathname.split("\\") # pidl is a list of "parent" items.
-#    # each item is a string 'item id', but these are ever used directly
-# As there is no concept of passing a single item, to open a file using only
-# a relative filename, conceptually you would say:
-#   open_file([filename]) # Pass a single-itemed relative "PIDL"
-# and continuing the analogy, a "listdir" type function would return a list
-# of single-itemed lists - each list containing the relative PIDL of the child.
-#
-# Each PIDL entry is a binary string, and may contain any character.  For
-# PIDLs not created by you, they can not be interpreted - they are just
-# blobs.  PIDLs created by you (ie, children of your IShellFolder) can
-# store and interpret the string however makes most sense for your application.
-# (but within PIDL rules - they must be persistable, etc)
-# There is no reason that pickled strings, for example, couldn't be used
-# as an EntryID.
-# This application takes a simple approach - each PIDL is a string of form
-# "directory\0directory_name", "file\0file_name" or
-# "object\0file_name\0class_name[.method_name"
-# The first string in each example is literal (ie, the word 'directory',
-# 'file' or 'object', and every other string is variable.  We use '\0' as
-# a field sep just 'cos we can (and 'cos it can't possibly conflict with the
-# string content)
-
-import _thread
-import os
-import pyclbr
-import sys
-
-import commctrl
-import pythoncom
-import win32api
-import win32con
-import win32gui
-import win32gui_struct
-import winerror
-from pywin.scintilla import scintillacon
-from win32com.server.exception import COMException
-from win32com.server.util import NewEnum, wrap
-from win32com.shell import shell, shellcon
-from win32com.util import IIDToInterfaceName
-
-# Set this to 1 to cause debug version to be registered and used.  A debug
-# version will spew output to win32traceutil.
-debug = 0
-if debug:
-    import win32traceutil
-
-# markh is toying with an implementation that allows auto reload of a module
-# if this attribute exists.
-com_auto_reload = True
-
-
-# Helper function to get a system IShellFolder interface, and the PIDL within
-# that folder for an existing file/directory.
-def GetFolderAndPIDLForPath(filename):
-    desktop = shell.SHGetDesktopFolder()
-    info = desktop.ParseDisplayName(0, None, os.path.abspath(filename))
-    cchEaten, pidl, attr = info
-    # We must walk the ID list, looking for one child at a time.
-    folder = desktop
-    while len(pidl) > 1:
-        this = pidl.pop(0)
-        folder = folder.BindToObject([this], None, shell.IID_IShellFolder)
-    # We are left with the pidl for the specific item.  Leave it as
-    # a list, so it remains a valid PIDL.
-    return folder, pidl
-
-
-# A cache of pyclbr module objects, so we only parse a given filename once.
-clbr_modules = {}  # Indexed by path, item is dict as returned from pyclbr
-
-
-def get_clbr_for_file(path):
-    try:
-        objects = clbr_modules[path]
-    except KeyError:
-        dir, filename = os.path.split(path)
-        base, ext = os.path.splitext(filename)
-        objects = pyclbr.readmodule_ex(base, [dir])
-        clbr_modules[path] = objects
-    return objects
-
-
-# Our COM interfaces.
-
-
-# Base class for a shell folder.
-# All child classes use a simple PIDL of the form:
-#  "object_type\0object_name[\0extra ...]"
-class ShellFolderBase:
-    _com_interfaces_ = [
-        shell.IID_IBrowserFrameOptions,
-        pythoncom.IID_IPersist,
-        shell.IID_IPersistFolder,
-        shell.IID_IShellFolder,
-    ]
-
-    _public_methods_ = (
-        shellcon.IBrowserFrame_Methods
-        + shellcon.IPersistFolder_Methods
-        + shellcon.IShellFolder_Methods
-    )
-
-    def GetFrameOptions(self, mask):
-        # print "GetFrameOptions", self, mask
-        return 0
-
-    def ParseDisplayName(self, hwnd, reserved, displayName, attr):
-        print("ParseDisplayName", displayName)
-        # return cchEaten, pidl, attr
-
-    def BindToStorage(self, pidl, bc, iid):
-        print("BTS", iid, IIDToInterfaceName(iid))
-
-    def BindToObject(self, pidl, bc, iid):
-        # We may be passed a set of relative PIDLs here - ie
-        # [pidl_of_dir, pidl_of_child_dir, pidl_of_file, pidl_of_function]
-        # But each of our PIDLs keeps the fully qualified name anyway - so
-        # just jump directly to the last.
-        final_pidl = pidl[-1]
-        typ, extra = final_pidl.split("\0", 1)
-        if typ == "directory":
-            klass = ShellFolderDirectory
-        elif typ == "file":
-            klass = ShellFolderFile
-        elif typ == "object":
-            klass = ShellFolderObject
-        else:
-            raise RuntimeError("What is " + repr(typ))
-        ret = wrap(klass(extra), iid, useDispatcher=(debug > 0))
-        return ret
-
-
-# A ShellFolder for an object with CHILDREN on the file system
-# Note that this means our "File" folder is *not* a 'FileSystem' folder,
-# as it's children (functions and classes) are not on the file system.
-#
-class ShellFolderFileSystem(ShellFolderBase):
-    def _GetFolderAndPIDLForPIDL(self, my_idl):
-        typ, name = my_idl[0].split("\0")
-        return GetFolderAndPIDLForPath(name)
-
-    # Interface methods
-    def CompareIDs(self, param, id1, id2):
-        if id1 < id2:
-            return -1
-        if id1 == id2:
-            return 0
-        return 1
-
-    def GetUIObjectOf(self, hwndOwner, pidls, iid, inout):
-        # delegate to the shell.
-        assert len(pidls) == 1, "oops - arent expecting more than one!"
-        pidl = pidls[0]
-        folder, child_pidl = self._GetFolderAndPIDLForPIDL(pidl)
-        try:
-            inout, ret = folder.GetUIObjectOf(hwndOwner, [child_pidl], iid, inout, iid)
-        except pythoncom.com_error as exc:
-            raise COMException(hresult=exc.hresult)
-        return inout, ret
-        # return object of IID
-
-    def GetDisplayNameOf(self, pidl, flags):
-        # delegate to the shell.
-        folder, child_pidl = self._GetFolderAndPIDLForPIDL(pidl)
-        ret = folder.GetDisplayNameOf(child_pidl, flags)
-        return ret
-
-    def GetAttributesOf(self, pidls, attrFlags):
-        ret_flags = -1
-        for pidl in pidls:
-            pidl = pidl[0]  # ??
-            typ, name = pidl.split("\0")
-            flags = shellcon.SHGFI_ATTRIBUTES
-            rc, info = shell.SHGetFileInfo(name, 0, flags)
-            hIcon, iIcon, dwAttr, name, typeName = info
-            # All our items, even files, have sub-items
-            extras = (
-                shellcon.SFGAO_HASSUBFOLDER
-                | shellcon.SFGAO_FOLDER
-                | shellcon.SFGAO_FILESYSANCESTOR
-                | shellcon.SFGAO_BROWSABLE
-            )
-            ret_flags &= dwAttr | extras
-        return ret_flags
-
-
-class ShellFolderDirectory(ShellFolderFileSystem):
-    def __init__(self, path):
-        self.path = os.path.abspath(path)
-
-    def CreateViewObject(self, hwnd, iid):
-        # delegate to the shell.
-        folder, child_pidl = GetFolderAndPIDLForPath(self.path)
-        return folder.CreateViewObject(hwnd, iid)
-
-    def EnumObjects(self, hwndOwner, flags):
-        pidls = []
-        for fname in os.listdir(self.path):
-            fqn = os.path.join(self.path, fname)
-            if os.path.isdir(fqn):
-                type_name = "directory"
-                type_class = ShellFolderDirectory
-            else:
-                base, ext = os.path.splitext(fname)
-                if ext in [".py", ".pyw"]:
-                    type_class = ShellFolderFile
-                    type_name = "file"
-                else:
-                    type_class = None
-            if type_class is not None:
-                pidls.append([type_name + "\0" + fqn])
-        return NewEnum(pidls, iid=shell.IID_IEnumIDList, useDispatcher=(debug > 0))
-
-    def GetDisplayNameOf(self, pidl, flags):
-        final_pidl = pidl[-1]
-        full_fname = final_pidl.split("\0")[-1]
-        return os.path.split(full_fname)[-1]
-
-    def GetAttributesOf(self, pidls, attrFlags):
-        return (
-            shellcon.SFGAO_HASSUBFOLDER
-            | shellcon.SFGAO_FOLDER
-            | shellcon.SFGAO_FILESYSANCESTOR
-            | shellcon.SFGAO_BROWSABLE
-        )
-
-
-# As per comments above, even though this manages a file, it is *not* a
-# ShellFolderFileSystem, as the children are not on the file system.
-class ShellFolderFile(ShellFolderBase):
-    def __init__(self, path):
-        self.path = os.path.abspath(path)
-
-    def EnumObjects(self, hwndOwner, flags):
-        objects = get_clbr_for_file(self.path)
-        pidls = []
-        for name, ob in objects.items():
-            pidls.append(["object\0" + self.path + "\0" + name])
-        return NewEnum(pidls, iid=shell.IID_IEnumIDList, useDispatcher=(debug > 0))
-
-    def GetAttributesOf(self, pidls, attrFlags):
-        ret_flags = -1
-        for pidl in pidls:
-            assert len(pidl) == 1, "Expecting relative pidls"
-            pidl = pidl[0]
-            typ, filename, obname = pidl.split("\0")
-            obs = get_clbr_for_file(filename)
-            ob = obs[obname]
-            flags = (
-                shellcon.SFGAO_BROWSABLE
-                | shellcon.SFGAO_FOLDER
-                | shellcon.SFGAO_FILESYSANCESTOR
-            )
-            if hasattr(ob, "methods"):
-                flags |= shellcon.SFGAO_HASSUBFOLDER
-            ret_flags &= flags
-        return ret_flags
-
-    def GetDisplayNameOf(self, pidl, flags):
-        assert len(pidl) == 1, "Expecting relative PIDL"
-        typ, fname, obname = pidl[0].split("\0")
-        fqname = os.path.splitext(fname)[0] + "." + obname
-        if flags & shellcon.SHGDN_INFOLDER:
-            ret = obname
-        else:  # SHGDN_NORMAL is the default
-            ret = fqname
-        # No need to look at the SHGDN_FOR* modifiers.
-        return ret
-
-    def CreateViewObject(self, hwnd, iid):
-        return wrap(ScintillaShellView(hwnd, self.path), iid, useDispatcher=debug > 0)
-
-
-# A ShellFolder for our Python objects
-class ShellFolderObject(ShellFolderBase):
-    def __init__(self, details):
-        self.path, details = details.split("\0")
-        if details.find(".") > 0:
-            self.class_name, self.method_name = details.split(".")
-        else:
-            self.class_name = details
-            self.method_name = None
-
-    def CreateViewObject(self, hwnd, iid):
-        mod_objects = get_clbr_for_file(self.path)
-        object = mod_objects[self.class_name]
-        if self.method_name is None:
-            lineno = object.lineno
-        else:
-            lineno = object.methods[self.method_name]
-            return wrap(
-                ScintillaShellView(hwnd, self.path, lineno),
-                iid,
-                useDispatcher=debug > 0,
-            )
-
-    def EnumObjects(self, hwndOwner, flags):
-        assert self.method_name is None, "Should not be enuming methods!"
-        mod_objects = get_clbr_for_file(self.path)
-        my_objects = mod_objects[self.class_name]
-        pidls = []
-        for func_name, lineno in my_objects.methods.items():
-            pidl = ["object\0" + self.path + "\0" + self.class_name + "." + func_name]
-            pidls.append(pidl)
-        return NewEnum(pidls, iid=shell.IID_IEnumIDList, useDispatcher=(debug > 0))
-
-    def GetDisplayNameOf(self, pidl, flags):
-        assert len(pidl) == 1, "Expecting relative PIDL"
-        typ, fname, obname = pidl[0].split("\0")
-        class_name, method_name = obname.split(".")
-        fqname = os.path.splitext(fname)[0] + "." + obname
-        if flags & shellcon.SHGDN_INFOLDER:
-            ret = method_name
-        else:  # SHGDN_NORMAL is the default
-            ret = fqname
-        # No need to look at the SHGDN_FOR* modifiers.
-        return ret
-
-    def GetAttributesOf(self, pidls, attrFlags):
-        ret_flags = -1
-        for pidl in pidls:
-            assert len(pidl) == 1, "Expecting relative pidls"
-            flags = (
-                shellcon.SFGAO_BROWSABLE
-                | shellcon.SFGAO_FOLDER
-                | shellcon.SFGAO_FILESYSANCESTOR
-            )
-            ret_flags &= flags
-        return ret_flags
-
-
-# The "Root" folder of our namespace.  As all children are directories,
-# it is derived from ShellFolderFileSystem
-# This is the only COM object actually registered and externally created.
-class ShellFolderRoot(ShellFolderFileSystem):
-    _reg_progid_ = "Python.ShellExtension.Folder"
-    _reg_desc_ = "Python Path Shell Browser"
-    _reg_clsid_ = "{f6287035-3074-4cb5-a8a6-d3c80e206944}"
-
-    def GetClassID(self):
-        return self._reg_clsid_
-
-    def Initialize(self, pidl):
-        # This is the PIDL of us, as created by the shell.  This is our
-        # top-level ID.  All other items under us have PIDLs defined
-        # by us - see the notes at the top of the file.
-        # print "Initialize called with pidl", repr(pidl)
-        self.pidl = pidl
-
-    def CreateViewObject(self, hwnd, iid):
-        return wrap(FileSystemView(self, hwnd), iid, useDispatcher=debug > 0)
-
-    def EnumObjects(self, hwndOwner, flags):
-        items = [["directory\0" + p] for p in sys.path if os.path.isdir(p)]
-        return NewEnum(items, iid=shell.IID_IEnumIDList, useDispatcher=(debug > 0))
-
-    def GetDisplayNameOf(self, pidl, flags):
-        ## return full path for sys.path dirs, since they don't appear under a parent folder
-        final_pidl = pidl[-1]
-        display_name = final_pidl.split("\0")[-1]
-        return display_name
-
-
-# Simple shell view implementations
-
-
-# Uses a builtin listview control to display simple lists of directories
-# or filenames.
-class FileSystemView:
-    _public_methods_ = shellcon.IShellView_Methods
-    _com_interfaces_ = [
-        pythoncom.IID_IOleWindow,
-        shell.IID_IShellView,
-    ]
-
-    def __init__(self, folder, hwnd):
-        self.hwnd_parent = hwnd  # provided by explorer.
-        self.hwnd = None  # intermediate window for catching command notifications.
-        self.hwnd_child = None  # our ListView
-        self.activate_state = None
-        self.hmenu = None
-        self.browser = None
-        self.folder = folder
-        self.children = None
-
-    # IOleWindow
-    def GetWindow(self):
-        return self.hwnd
-
-    def ContextSensitiveHelp(self, enter_mode):
-        raise COMException(hresult=winerror.E_NOTIMPL)
-
-    # IShellView
-    def CreateViewWindow(self, prev, settings, browser, rect):
-        print("FileSystemView.CreateViewWindow", prev, settings, browser, rect)
-        self.cur_foldersettings = settings
-        self.browser = browser
-        self._CreateMainWindow(prev, settings, browser, rect)
-        self._CreateChildWindow(prev)
-
-        # This isn't part of the sample, but the most convenient place to
-        # test/demonstrate how you can get an IShellBrowser from a HWND
-        # (but ONLY when you are in the same process as the IShellBrowser!)
-        # Obviously it is not necessary here - we already have the browser!
-        browser_ad = win32gui.SendMessage(self.hwnd_parent, win32con.WM_USER + 7, 0, 0)
-        browser_ob = pythoncom.ObjectFromAddress(browser_ad, shell.IID_IShellBrowser)
-        assert browser == browser_ob
-        # and make a call on the object to prove it doesn't die :)
-        assert browser.QueryActiveShellView() == browser_ob.QueryActiveShellView()
-
-    def _CreateMainWindow(self, prev, settings, browser, rect):
-        # Creates a parent window that hosts the view window.  This window
-        # gets the control notifications etc sent from the child.
-        style = win32con.WS_CHILD | win32con.WS_VISIBLE  #
-        wclass_name = "ShellViewDemo_DefView"
-        # Register the Window class.
-        wc = win32gui.WNDCLASS()
-        wc.hInstance = win32gui.dllhandle
-        wc.lpszClassName = wclass_name
-        wc.style = win32con.CS_VREDRAW | win32con.CS_HREDRAW
-        try:
-            win32gui.RegisterClass(wc)
-        except win32gui.error as details:
-            # Should only happen when this module is reloaded
-            if details[0] != winerror.ERROR_CLASS_ALREADY_EXISTS:
-                raise
-
-        message_map = {
-            win32con.WM_DESTROY: self.OnDestroy,
-            win32con.WM_COMMAND: self.OnCommand,
-            win32con.WM_NOTIFY: self.OnNotify,
-            win32con.WM_CONTEXTMENU: self.OnContextMenu,
-            win32con.WM_SIZE: self.OnSize,
-        }
-
-        self.hwnd = win32gui.CreateWindow(
-            wclass_name,
-            "",
-            style,
-            rect[0],
-            rect[1],
-            rect[2] - rect[0],
-            rect[3] - rect[1],
-            self.hwnd_parent,
-            0,
-            win32gui.dllhandle,
-            None,
-        )
-        win32gui.SetWindowLong(self.hwnd, win32con.GWL_WNDPROC, message_map)
-        print("View 's hwnd is", self.hwnd)
-        return self.hwnd
-
-    def _CreateChildWindow(self, prev):
-        # Creates the list view window.
-        assert self.hwnd_child is None, "already have a window"
-        assert self.cur_foldersettings is not None, "no settings"
-        style = (
-            win32con.WS_CHILD
-            | win32con.WS_VISIBLE
-            | win32con.WS_BORDER
-            | commctrl.LVS_SHAREIMAGELISTS
-            | commctrl.LVS_EDITLABELS
-        )
-
-        view_mode, view_flags = self.cur_foldersettings
-        if view_mode == shellcon.FVM_ICON:
-            style |= commctrl.LVS_ICON | commctrl.LVS_AUTOARRANGE
-        elif view_mode == shellcon.FVM_SMALLICON:
-            style |= commctrl.LVS_SMALLICON | commctrl.LVS_AUTOARRANGE
-        elif view_mode == shellcon.FVM_LIST:
-            style |= commctrl.LVS_LIST | commctrl.LVS_AUTOARRANGE
-        elif view_mode == shellcon.FVM_DETAILS:
-            style |= commctrl.LVS_REPORT | commctrl.LVS_AUTOARRANGE
-        else:
-            # XP 'thumbnails' etc
-            view_mode = shellcon.FVM_DETAILS
-            # Default to 'report'
-            style |= commctrl.LVS_REPORT | commctrl.LVS_AUTOARRANGE
-
-        for f_flag, l_flag in [
-            (shellcon.FWF_SINGLESEL, commctrl.LVS_SINGLESEL),
-            (shellcon.FWF_ALIGNLEFT, commctrl.LVS_ALIGNLEFT),
-            (shellcon.FWF_SHOWSELALWAYS, commctrl.LVS_SHOWSELALWAYS),
-        ]:
-            if view_flags & f_flag:
-                style |= l_flag
-
-        self.hwnd_child = win32gui.CreateWindowEx(
-            win32con.WS_EX_CLIENTEDGE,
-            "SysListView32",
-            None,
-            style,
-            0,
-            0,
-            0,
-            0,
-            self.hwnd,
-            1000,
-            0,
-            None,
-        )
-
-        cr = win32gui.GetClientRect(self.hwnd)
-        win32gui.MoveWindow(self.hwnd_child, 0, 0, cr[2] - cr[0], cr[3] - cr[1], True)
-
-        # Setup the columns for the view.
-        lvc, extras = win32gui_struct.PackLVCOLUMN(
-            fmt=commctrl.LVCFMT_LEFT, subItem=1, text="Name", cx=300
-        )
-        win32gui.SendMessage(self.hwnd_child, commctrl.LVM_INSERTCOLUMN, 0, lvc)
-
-        lvc, extras = win32gui_struct.PackLVCOLUMN(
-            fmt=commctrl.LVCFMT_RIGHT, subItem=1, text="Exists", cx=50
-        )
-        win32gui.SendMessage(self.hwnd_child, commctrl.LVM_INSERTCOLUMN, 1, lvc)
-        # and fill it with the content
-        self.Refresh()
-
-    def GetCurrentInfo(self):
-        return self.cur_foldersettings
-
-    def UIActivate(self, activate_state):
-        print("OnActivate")
-
-    def _OnActivate(self, activate_state):
-        if self.activate_state == activate_state:
-            return
-        self._OnDeactivate()  # restore menu's first, if necessary.
-        if activate_state != shellcon.SVUIA_DEACTIVATE:
-            assert self.hmenu is None, "Should have destroyed it!"
-            self.hmenu = win32gui.CreateMenu()
-            widths = 0, 0, 0, 0, 0, 0
-            # Ask explorer to add its standard items.
-            self.browser.InsertMenusSB(self.hmenu, widths)
-            # Merge with these standard items
-            self._MergeMenus(activate_state)
-            self.browser.SetMenuSB(self.hmenu, 0, self.hwnd)
-        self.activate_state = activate_state
-
-    def _OnDeactivate(self):
-        if self.browser is not None and self.hmenu is not None:
-            self.browser.SetMenuSB(0, 0, 0)
-            self.browser.RemoveMenusSB(self.hmenu)
-            win32gui.DestroyMenu(self.hmenu)
-            self.hmenu = None
-        self.hsubmenus = None
-        self.activate_state = shellcon.SVUIA_DEACTIVATE
-
-    def _MergeMenus(self, activate_state):
-        # Merge the operations we support into the top-level menus.
-        # NOTE: This function it *not* called each time the selection changes.
-        # SVUIA_ACTIVATE_FOCUS really means "have a selection?"
-        have_sel = activate_state == shellcon.SVUIA_ACTIVATE_FOCUS
-        # only do "file" menu here, and only 1 item on it!
-        mid = shellcon.FCIDM_MENU_FILE
-        # Get the hmenu for the menu
-        buf, extras = win32gui_struct.EmptyMENUITEMINFO(win32con.MIIM_SUBMENU)
-        win32gui.GetMenuItemInfo(self.hmenu, mid, False, buf)
-        data = win32gui_struct.UnpackMENUITEMINFO(buf)
-        submenu = data[3]
-        print("Do someting with the file menu!")
-
-    def Refresh(self):
-        stateMask = commctrl.LVIS_SELECTED | commctrl.LVIS_DROPHILITED
-        state = 0
-        self.children = []
-        # Enumerate and store the child PIDLs
-        for cid in self.folder.EnumObjects(self.hwnd, 0):
-            self.children.append(cid)
-
-        for row_index, data in enumerate(self.children):
-            assert len(data) == 1, "expecting just a child PIDL"
-            typ, path = data[0].split("\0")
-            desc = os.path.exists(path) and "Yes" or "No"
-            prop_vals = (path, desc)
-            # first col
-            data, extras = win32gui_struct.PackLVITEM(
-                item=row_index,
-                subItem=0,
-                text=prop_vals[0],
-                state=state,
-                stateMask=stateMask,
-            )
-            win32gui.SendMessage(
-                self.hwnd_child, commctrl.LVM_INSERTITEM, row_index, data
-            )
-            # rest of the cols.
-            col_index = 1
-            for prop_val in prop_vals[1:]:
-                data, extras = win32gui_struct.PackLVITEM(
-                    item=row_index, subItem=col_index, text=prop_val
-                )
-
-                win32gui.SendMessage(self.hwnd_child, commctrl.LVM_SETITEM, 0, data)
-                col_index += 1
-
-    def SelectItem(self, pidl, flag):
-        # For the sake of brevity, we don't implement this yet.
-        # You would need to locate the index of the item in the shell-view
-        # with that PIDL, then ask the list-view to select it.
-        print("Please implement SelectItem for PIDL", pidl)
-
-    def GetItemObject(self, item_num, iid):
-        raise COMException(hresult=winerror.E_NOTIMPL)
-
-    def TranslateAccelerator(self, msg):
-        return winerror.S_FALSE
-
-    def DestroyViewWindow(self):
-        win32gui.DestroyWindow(self.hwnd)
-        self.hwnd = None
-        print("Destroyed view window")
-
-    # Message handlers.
-    def OnDestroy(self, hwnd, msg, wparam, lparam):
-        print("OnDestory")
-
-    def OnCommand(self, hwnd, msg, wparam, lparam):
-        print("OnCommand")
-
-    def OnNotify(self, hwnd, msg, wparam, lparam):
-        hwndFrom, idFrom, code = win32gui_struct.UnpackWMNOTIFY(lparam)
-        # print "OnNotify code=0x%x (0x%x, 0x%x)" % (code, wparam, lparam)
-        if code == commctrl.NM_SETFOCUS:
-            # Control got focus - Explorer may not know - tell it
-            if self.browser is not None:
-                self.browser.OnViewWindowActive(None)
-            # And do our menu thang
-            self._OnActivate(shellcon.SVUIA_ACTIVATE_FOCUS)
-        elif code == commctrl.NM_KILLFOCUS:
-            self._OnDeactivate()
-        elif code == commctrl.NM_DBLCLK:
-            # This DblClick implementation leaves a little to be desired :)
-            # It demonstrates some useful concepts, such as asking the
-            # folder for its context-menu and invoking a command from it.
-            # However, as our folder delegates IContextMenu to the shell
-            # itself, the end result is that the folder is opened in
-            # its "normal" place in Windows explorer rather than inside
-            # our shell-extension.
-            # Determine the selected items.
-            sel = []
-            n = -1
-            while 1:
-                n = win32gui.SendMessage(
-                    self.hwnd_child, commctrl.LVM_GETNEXTITEM, n, commctrl.LVNI_SELECTED
-                )
-                if n == -1:
-                    break
-                sel.append(self.children[n][-1:])
-            print("Selection is", sel)
-            hmenu = win32gui.CreateMenu()
-            try:
-                # Get the IContextMenu for the items.
-                inout, cm = self.folder.GetUIObjectOf(
-                    self.hwnd_parent, sel, shell.IID_IContextMenu, 0
-                )
-
-                # As per 'Q179911', we need to determine if the default operation
-                # should be 'open' or 'explore'
-                flags = shellcon.CMF_DEFAULTONLY
-                try:
-                    self.browser.GetControlWindow(shellcon.FCW_TREE)
-                    flags |= shellcon.CMF_EXPLORE
-                except pythoncom.com_error:
-                    pass
-                # *sob* - delegating to the shell does work - but lands us
-                # in the original location.  Q179911 also shows that
-                # ShellExecuteEx should work - but I can't make it work as
-                # described (XP: function call succeeds, but another thread
-                # shows a dialog with text of E_INVALID_PARAM, and new
-                # Explorer window opens with desktop view. Vista: function
-                # call succeeds, but no window created at all.
-                # On Vista, I'd love to get an IExplorerBrowser interface
-                # from the shell, but a QI fails, and although the
-                # IShellBrowser does appear to support IServiceProvider, I
-                # still can't get it
-                if 0:
-                    id_cmd_first = 1  # TrackPopupMenu makes it hard to use 0
-                    cm.QueryContextMenu(hmenu, 0, id_cmd_first, -1, flags)
-                    # Find the default item in the returned menu.
-                    cmd = win32gui.GetMenuDefaultItem(hmenu, False, 0)
-                    if cmd == -1:
-                        print("Oops: _doDefaultActionFor found no default menu")
-                    else:
-                        ci = (
-                            0,
-                            self.hwnd_parent,
-                            cmd - id_cmd_first,
-                            None,
-                            None,
-                            0,
-                            0,
-                            0,
-                        )
-                        cm.InvokeCommand(ci)
-                else:
-                    rv = shell.ShellExecuteEx(
-                        hwnd=self.hwnd_parent,
-                        nShow=win32con.SW_NORMAL,
-                        lpClass="folder",
-                        lpVerb="explore",
-                        lpIDList=sel[0],
-                    )
-                    print("ShellExecuteEx returned", rv)
-            finally:
-                win32gui.DestroyMenu(hmenu)
-
-    def OnContextMenu(self, hwnd, msg, wparam, lparam):
-        # Get the selected items.
-        pidls = []
-        n = -1
-        while 1:
-            n = win32gui.SendMessage(
-                self.hwnd_child, commctrl.LVM_GETNEXTITEM, n, commctrl.LVNI_SELECTED
-            )
-            if n == -1:
-                break
-            pidls.append(self.children[n][-1:])
-
-        spt = win32api.GetCursorPos()
-        if not pidls:
-            print("Ignoring background click")
-            return
-        # Get the IContextMenu for the items.
-        inout, cm = self.folder.GetUIObjectOf(
-            self.hwnd_parent, pidls, shell.IID_IContextMenu, 0
-        )
-        hmenu = win32gui.CreatePopupMenu()
-        sel = None
-        # As per 'Q179911', we need to determine if the default operation
-        # should be 'open' or 'explore'
-        try:
-            flags = 0
-            try:
-                self.browser.GetControlWindow(shellcon.FCW_TREE)
-                flags |= shellcon.CMF_EXPLORE
-            except pythoncom.com_error:
-                pass
-            id_cmd_first = 1  # TrackPopupMenu makes it hard to use 0
-            cm.QueryContextMenu(hmenu, 0, id_cmd_first, -1, flags)
-            tpm_flags = (
-                win32con.TPM_LEFTALIGN
-                | win32con.TPM_RETURNCMD
-                | win32con.TPM_RIGHTBUTTON
-            )
-            sel = win32gui.TrackPopupMenu(
-                hmenu, tpm_flags, spt[0], spt[1], 0, self.hwnd, None
-            )
-            print("TrackPopupMenu returned", sel)
-        finally:
-            win32gui.DestroyMenu(hmenu)
-        if sel:
-            ci = 0, self.hwnd_parent, sel - id_cmd_first, None, None, 0, 0, 0
-            cm.InvokeCommand(ci)
-
-    def OnSize(self, hwnd, msg, wparam, lparam):
-        # print "OnSize", self.hwnd_child, win32api.LOWORD(lparam), win32api.HIWORD(lparam)
-        if self.hwnd_child is not None:
-            x = win32api.LOWORD(lparam)
-            y = win32api.HIWORD(lparam)
-            win32gui.MoveWindow(self.hwnd_child, 0, 0, x, y, False)
-
-
-# This uses scintilla to display a filename, and optionally jump to a line
-# number.
-class ScintillaShellView:
-    _public_methods_ = shellcon.IShellView_Methods
-    _com_interfaces_ = [
-        pythoncom.IID_IOleWindow,
-        shell.IID_IShellView,
-    ]
-
-    def __init__(self, hwnd, filename, lineno=None):
-        self.filename = filename
-        self.lineno = lineno
-        self.hwnd_parent = hwnd
-        self.hwnd = None
-
-    def _SendSci(self, msg, wparam=0, lparam=0):
-        return win32gui.SendMessage(self.hwnd, msg, wparam, lparam)
-
-    # IShellView
-    def CreateViewWindow(self, prev, settings, browser, rect):
-        print("ScintillaShellView.CreateViewWindow", prev, settings, browser, rect)
-        # Make sure scintilla.dll is loaded.  If not, find it on sys.path
-        # (which it generally is for Pythonwin)
-        try:
-            win32api.GetModuleHandle("Scintilla.dll")
-        except win32api.error:
-            for p in sys.path:
-                fname = os.path.join(p, "Scintilla.dll")
-                if not os.path.isfile(fname):
-                    fname = os.path.join(p, "Build", "Scintilla.dll")
-                if os.path.isfile(fname):
-                    win32api.LoadLibrary(fname)
-                    break
-            else:
-                raise RuntimeError("Can't find scintilla!")
-
-        style = (
-            win32con.WS_CHILD
-            | win32con.WS_VSCROLL
-            | win32con.WS_HSCROLL
-            | win32con.WS_CLIPCHILDREN
-            | win32con.WS_VISIBLE
-        )
-        self.hwnd = win32gui.CreateWindow(
-            "Scintilla",
-            "Scintilla",
-            style,
-            rect[0],
-            rect[1],
-            rect[2] - rect[0],
-            rect[3] - rect[1],
-            self.hwnd_parent,
-            1000,
-            0,
-            None,
-        )
-
-        message_map = {
-            win32con.WM_SIZE: self.OnSize,
-        }
-        #        win32gui.SetWindowLong(self.hwnd, win32con.GWL_WNDPROC, message_map)
-
-        file_data = file(self.filename, "U").read()
-
-        self._SetupLexer()
-        self._SendSci(scintillacon.SCI_ADDTEXT, len(file_data), file_data)
-        if self.lineno != None:
-            self._SendSci(scintillacon.SCI_GOTOLINE, self.lineno)
-        print("Scintilla's hwnd is", self.hwnd)
-
-    def _SetupLexer(self):
-        h = self.hwnd
-        styles = [
-            ((0, 0, 200, 0, 0x808080), None, scintillacon.SCE_P_DEFAULT),
-            ((0, 2, 200, 0, 0x008000), None, scintillacon.SCE_P_COMMENTLINE),
-            ((0, 2, 200, 0, 0x808080), None, scintillacon.SCE_P_COMMENTBLOCK),
-            ((0, 0, 200, 0, 0x808000), None, scintillacon.SCE_P_NUMBER),
-            ((0, 0, 200, 0, 0x008080), None, scintillacon.SCE_P_STRING),
-            ((0, 0, 200, 0, 0x008080), None, scintillacon.SCE_P_CHARACTER),
-            ((0, 0, 200, 0, 0x008080), None, scintillacon.SCE_P_TRIPLE),
-            ((0, 0, 200, 0, 0x008080), None, scintillacon.SCE_P_TRIPLEDOUBLE),
-            ((0, 0, 200, 0, 0x000000), 0x008080, scintillacon.SCE_P_STRINGEOL),
-            ((0, 1, 200, 0, 0x800000), None, scintillacon.SCE_P_WORD),
-            ((0, 1, 200, 0, 0xFF0000), None, scintillacon.SCE_P_CLASSNAME),
-            ((0, 1, 200, 0, 0x808000), None, scintillacon.SCE_P_DEFNAME),
-            ((0, 0, 200, 0, 0x000000), None, scintillacon.SCE_P_OPERATOR),
-            ((0, 0, 200, 0, 0x000000), None, scintillacon.SCE_P_IDENTIFIER),
-        ]
-        self._SendSci(scintillacon.SCI_SETLEXER, scintillacon.SCLEX_PYTHON, 0)
-        self._SendSci(scintillacon.SCI_SETSTYLEBITS, 5)
-        baseFormat = (-402653169, 0, 200, 0, 0, 0, 49, "Courier New")
-        for f, bg, stylenum in styles:
-            self._SendSci(scintillacon.SCI_STYLESETFORE, stylenum, f[4])
-            self._SendSci(scintillacon.SCI_STYLESETFONT, stylenum, baseFormat[7])
-            if f[1] & 1:
-                self._SendSci(scintillacon.SCI_STYLESETBOLD, stylenum, 1)
-            else:
-                self._SendSci(scintillacon.SCI_STYLESETBOLD, stylenum, 0)
-            if f[1] & 2:
-                self._SendSci(scintillacon.SCI_STYLESETITALIC, stylenum, 1)
-            else:
-                self._SendSci(scintillacon.SCI_STYLESETITALIC, stylenum, 0)
-            self._SendSci(
-                scintillacon.SCI_STYLESETSIZE, stylenum, int(baseFormat[2] / 20)
-            )
-            if bg is not None:
-                self._SendSci(scintillacon.SCI_STYLESETBACK, stylenum, bg)
-            self._SendSci(
-                scintillacon.SCI_STYLESETEOLFILLED, stylenum, 1
-            )  # Only needed for unclosed strings.
-
-    # IOleWindow
-    def GetWindow(self):
-        return self.hwnd
-
-    def UIActivate(self, activate_state):
-        print("OnActivate")
-
-    def DestroyViewWindow(self):
-        win32gui.DestroyWindow(self.hwnd)
-        self.hwnd = None
-        print("Destroyed scintilla window")
-
-    def TranslateAccelerator(self, msg):
-        return winerror.S_FALSE
-
-    def OnSize(self, hwnd, msg, wparam, lparam):
-        x = win32api.LOWORD(lparam)
-        y = win32api.HIWORD(lparam)
-        win32gui.MoveWindow(self.hwnd, 0, 0, x, y, False)
-
-
-def DllRegisterServer():
-    import winreg
-
-    key = winreg.CreateKey(
-        winreg.HKEY_LOCAL_MACHINE,
-        "SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\"
-        "Explorer\\Desktop\\Namespace\\" + ShellFolderRoot._reg_clsid_,
-    )
-    winreg.SetValueEx(key, None, 0, winreg.REG_SZ, ShellFolderRoot._reg_desc_)
-    # And special shell keys under our CLSID
-    key = winreg.CreateKey(
-        winreg.HKEY_CLASSES_ROOT,
-        "CLSID\\" + ShellFolderRoot._reg_clsid_ + "\\ShellFolder",
-    )
-    # 'Attributes' is an int stored as a binary! use struct
-    attr = (
-        shellcon.SFGAO_FOLDER | shellcon.SFGAO_HASSUBFOLDER | shellcon.SFGAO_BROWSABLE
-    )
-    import struct
-
-    s = struct.pack("i", attr)
-    winreg.SetValueEx(key, "Attributes", 0, winreg.REG_BINARY, s)
-    print(ShellFolderRoot._reg_desc_, "registration complete.")
-
-
-def DllUnregisterServer():
-    import winreg
-
-    try:
-        key = winreg.DeleteKey(
-            winreg.HKEY_LOCAL_MACHINE,
-            "SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\"
-            "Explorer\\Desktop\\Namespace\\" + ShellFolderRoot._reg_clsid_,
-        )
-    except WindowsError as details:
-        import errno
-
-        if details.errno != errno.ENOENT:
-            raise
-    print(ShellFolderRoot._reg_desc_, "unregistration complete.")
-
-
-if __name__ == "__main__":
-    from win32com.server import register
-
-    register.UseCommandLine(
-        ShellFolderRoot,
-        debug=debug,
-        finalize_register=DllRegisterServer,
-        finalize_unregister=DllUnregisterServer,
-    )
diff --git a/lib/win32comext/shell/demos/shellexecuteex.py b/lib/win32comext/shell/demos/shellexecuteex.py
deleted file mode 100644
index 6111841b..00000000
--- a/lib/win32comext/shell/demos/shellexecuteex.py
+++ /dev/null
@@ -1,19 +0,0 @@
-import win32con
-from win32com.shell import shell, shellcon
-
-
-def ExplorePIDL():
-    pidl = shell.SHGetSpecialFolderLocation(0, shellcon.CSIDL_DESKTOP)
-    print("The desktop is at", shell.SHGetPathFromIDList(pidl))
-    shell.ShellExecuteEx(
-        fMask=shellcon.SEE_MASK_NOCLOSEPROCESS,
-        nShow=win32con.SW_NORMAL,
-        lpClass="folder",
-        lpVerb="explore",
-        lpIDList=pidl,
-    )
-    print("Done!")
-
-
-if __name__ == "__main__":
-    ExplorePIDL()
diff --git a/lib/win32comext/shell/demos/viewstate.py b/lib/win32comext/shell/demos/viewstate.py
deleted file mode 100644
index e3b7fc15..00000000
--- a/lib/win32comext/shell/demos/viewstate.py
+++ /dev/null
@@ -1,68 +0,0 @@
-"""
-Demonstrates how to propagate a folder's view state to all its subfolders
-The format of the ColInfo stream is apparently undocumented, but
-it can be read raw from one folder and copied to another's view state.
-"""
-
-import os
-import sys
-
-import pythoncom
-from win32com.shell import shell, shellcon
-
-template_folder = os.path.split(sys.executable)[0]
-print("Template folder:", template_folder)
-template_pidl = shell.SHILCreateFromPath(template_folder, 0)[0]
-template_pb = shell.SHGetViewStatePropertyBag(
-    template_pidl,
-    "Shell",
-    shellcon.SHGVSPB_FOLDERNODEFAULTS,
-    pythoncom.IID_IPropertyBag,
-)
-
-# Column info has to be read as a stream
-# This may blow up if folder has never been opened in Explorer and has no ColInfo yet
-template_iunk = template_pb.Read("ColInfo", pythoncom.VT_UNKNOWN)
-template_stream = template_iunk.QueryInterface(pythoncom.IID_IStream)
-streamsize = template_stream.Stat()[2]
-template_colinfo = template_stream.Read(streamsize)
-
-
-def update_colinfo(not_used, dir_name, fnames):
-    for fname in fnames:
-        full_fname = os.path.join(dir_name, fname)
-        if os.path.isdir(full_fname):
-            print(full_fname)
-            pidl = shell.SHILCreateFromPath(full_fname, 0)[0]
-            pb = shell.SHGetViewStatePropertyBag(
-                pidl,
-                "Shell",
-                shellcon.SHGVSPB_FOLDERNODEFAULTS,
-                pythoncom.IID_IPropertyBag,
-            )
-            ## not all folders already have column info, and we're replacing it anyway
-            pb.Write("ColInfo", template_stream)
-            iunk = pb.Read("ColInfo", pythoncom.VT_UNKNOWN)
-            s = iunk.QueryInterface(pythoncom.IID_IStream)
-            s.Write(template_colinfo)
-            s = None
-            ## attribute names read from registry, can't find any way to enumerate IPropertyBag
-            for attr in (
-                "Address",
-                "Buttons",
-                "Col",
-                "Vid",
-                "WFlags",
-                "FFlags",
-                "Sort",
-                "SortDir",
-                "ShowCmd",
-                "FolderType",
-                "Mode",
-                "Rev",
-            ):
-                pb.Write(attr, template_pb.Read(attr))
-            pb = None
-
-
-os.path.walk(template_folder, update_colinfo, None)
diff --git a/lib/win32comext/shell/demos/walk_shell_folders.py b/lib/win32comext/shell/demos/walk_shell_folders.py
deleted file mode 100644
index 592350c8..00000000
--- a/lib/win32comext/shell/demos/walk_shell_folders.py
+++ /dev/null
@@ -1,24 +0,0 @@
-# A little sample that walks from the desktop into child
-# items.
-from win32com.shell import shell, shellcon
-
-
-def walk(folder, depth=2, indent=""):
-    try:
-        pidls = folder.EnumObjects(0, shellcon.SHCONTF_FOLDERS)
-    except shell.error:
-        # no items
-        return
-    for pidl in pidls:
-        dn = folder.GetDisplayNameOf(pidl, shellcon.SHGDN_NORMAL)
-        print(indent, dn)
-        if depth:
-            try:
-                child = folder.BindToObject(pidl, None, shell.IID_IShellFolder)
-            except shell.error:
-                pass
-            else:
-                walk(child, depth - 1, indent + " ")
-
-
-walk(shell.SHGetDesktopFolder())
diff --git a/lib/win32comext/shell/shell.pyd b/lib/win32comext/shell/shell.pyd
deleted file mode 100644
index fe2352d91f2421c5042bd7b38936d86d5d37e1eb..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 528896
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%0DgQ9byPpv<Aepa=VqU#OvmjcUaPK
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

diff --git a/lib/win32comext/shell/shellcon.py b/lib/win32comext/shell/shellcon.py
deleted file mode 100644
index 769adf73..00000000
--- a/lib/win32comext/shell/shellcon.py
+++ /dev/null
@@ -1,1597 +0,0 @@
-# Generated by h2py from \mssdk\include\shlobj.h and shellapi.h
-WM_USER = 1024
-DROPEFFECT_NONE = 0
-DROPEFFECT_COPY = 1
-DROPEFFECT_MOVE = 2
-DROPEFFECT_LINK = 4
-DROPEFFECT_SCROLL = -2147483648
-
-FO_MOVE = 1
-FO_COPY = 2
-FO_DELETE = 3
-FO_RENAME = 4
-
-## File operation flags used with shell.SHFileOperation
-FOF_MULTIDESTFILES = 1
-FOF_CONFIRMMOUSE = 2
-FOF_SILENT = 4
-FOF_RENAMEONCOLLISION = 8
-FOF_NOCONFIRMATION = 16
-FOF_WANTMAPPINGHANDLE = 32
-FOF_ALLOWUNDO = 64
-FOF_FILESONLY = 128
-FOF_SIMPLEPROGRESS = 256
-FOF_NOCONFIRMMKDIR = 512
-FOF_NOERRORUI = 1024
-FOF_NOCOPYSECURITYATTRIBS = 2048
-FOF_NORECURSION = 4096
-FOF_NO_CONNECTED_ELEMENTS = 8192
-FOF_WANTNUKEWARNING = 16384
-FOF_NORECURSEREPARSE = 32768
-FOF_NO_UI = FOF_SILENT | FOF_NOCONFIRMATION | FOF_NOERRORUI | FOF_NOCONFIRMMKDIR
-
-## Extended file operation flags, used with IFileOperation
-FOFX_NOSKIPJUNCTIONS = 0x00010000
-FOFX_PREFERHARDLINK = 0x00020000
-FOFX_SHOWELEVATIONPROMPT = 0x00040000
-FOFX_EARLYFAILURE = 0x00100000
-FOFX_PRESERVEFILEEXTENSIONS = 0x00200000
-FOFX_KEEPNEWERFILE = 0x00400000
-FOFX_NOCOPYHOOKS = 0x00800000
-FOFX_NOMINIMIZEBOX = 0x01000000
-FOFX_MOVEACLSACROSSVOLUMES = 0x02000000
-FOFX_DONTDISPLAYSOURCEPATH = 0x04000000
-FOFX_DONTDISPLAYDESTPATH = 0x08000000
-FOFX_REQUIREELEVATION = 0x10000000
-FOFX_COPYASDOWNLOAD = 0x40000000
-FOFX_DONTDISPLAYLOCATIONS = 0x80000000
-
-PO_DELETE = 19
-PO_RENAME = 20
-PO_PORTCHANGE = 32
-PO_REN_PORT = 52
-SE_ERR_FNF = 2
-SE_ERR_PNF = 3
-SE_ERR_ACCESSDENIED = 5
-SE_ERR_OOM = 8
-SE_ERR_DLLNOTFOUND = 32
-SE_ERR_SHARE = 26
-SE_ERR_ASSOCINCOMPLETE = 27
-SE_ERR_DDETIMEOUT = 28
-SE_ERR_DDEFAIL = 29
-SE_ERR_DDEBUSY = 30
-SE_ERR_NOASSOC = 31
-SEE_MASK_CLASSNAME = 1
-SEE_MASK_CLASSKEY = 3
-SEE_MASK_IDLIST = 4
-SEE_MASK_INVOKEIDLIST = 12
-SEE_MASK_ICON = 16
-SEE_MASK_HOTKEY = 32
-SEE_MASK_NOCLOSEPROCESS = 64
-SEE_MASK_CONNECTNETDRV = 128
-SEE_MASK_FLAG_DDEWAIT = 256
-SEE_MASK_DOENVSUBST = 512
-SEE_MASK_FLAG_NO_UI = 1024
-SEE_MASK_UNICODE = 16384
-SEE_MASK_NO_CONSOLE = 32768
-SEE_MASK_ASYNCOK = 1048576
-SEE_MASK_HMONITOR = 2097152
-SHERB_NOCONFIRMATION = 1
-SHERB_NOPROGRESSUI = 2
-SHERB_NOSOUND = 4
-NIM_ADD = 0
-NIM_MODIFY = 1
-NIM_DELETE = 2
-NIF_MESSAGE = 1
-NIF_ICON = 2
-NIF_TIP = 4
-SHGFI_ICON = 256
-SHGFI_DISPLAYNAME = 512
-SHGFI_TYPENAME = 1024
-SHGFI_ATTRIBUTES = 2048
-SHGFI_ICONLOCATION = 4096
-SHGFI_EXETYPE = 8192
-SHGFI_SYSICONINDEX = 16384
-SHGFI_LINKOVERLAY = 32768
-SHGFI_SELECTED = 65536
-SHGFI_ATTR_SPECIFIED = 131072
-SHGFI_LARGEICON = 0
-SHGFI_SMALLICON = 1
-SHGFI_OPENICON = 2
-SHGFI_SHELLICONSIZE = 4
-SHGFI_PIDL = 8
-SHGFI_USEFILEATTRIBUTES = 16
-SHGNLI_PIDL = 1
-SHGNLI_PREFIXNAME = 2
-SHGNLI_NOUNIQUE = 4
-PRINTACTION_OPEN = 0
-PRINTACTION_PROPERTIES = 1
-PRINTACTION_NETINSTALL = 2
-PRINTACTION_NETINSTALLLINK = 3
-PRINTACTION_TESTPAGE = 4
-PRINTACTION_OPENNETPRN = 5
-PRINTACTION_DOCUMENTDEFAULTS = 6
-PRINTACTION_SERVERPROPERTIES = 7
-
-# Flags used with IContextMenu.QueryContextMenu
-CMF_NORMAL = 0
-CMF_DEFAULTONLY = 1
-CMF_VERBSONLY = 2
-CMF_EXPLORE = 4
-CMF_NOVERBS = 8
-CMF_CANRENAME = 16
-CMF_NODEFAULT = 32
-CMF_INCLUDESTATIC = 64
-CMF_ITEMMENU = 128
-CMF_EXTENDEDVERBS = 256
-CMF_DISABLEDVERBS = 512
-CMF_ASYNCVERBSTATE = 1024
-CMF_OPTIMIZEFORINVOKE = 2048
-CMF_SYNCCASCADEMENU = 4096
-CMF_DONOTPICKDEFAULT = 8192
-CMF_RESERVED = 0xFFFF0000
-
-GCS_VERBA = 0
-GCS_HELPTEXTA = 1
-GCS_VALIDATEA = 2
-GCS_VERBW = 4
-GCS_HELPTEXTW = 5
-GCS_VALIDATEW = 6
-GCS_UNICODE = 4
-GCS_VERB = GCS_VERBA
-GCS_HELPTEXT = GCS_HELPTEXTA
-GCS_VALIDATE = GCS_VALIDATEA
-CMDSTR_NEWFOLDERA = "NewFolder"
-CMDSTR_VIEWLISTA = "ViewList"
-CMDSTR_VIEWDETAILSA = "ViewDetails"
-CMDSTR_NEWFOLDER = CMDSTR_NEWFOLDERA
-CMDSTR_VIEWLIST = CMDSTR_VIEWLISTA
-CMDSTR_VIEWDETAILS = CMDSTR_VIEWDETAILSA
-CMIC_MASK_HOTKEY = SEE_MASK_HOTKEY
-CMIC_MASK_ICON = SEE_MASK_ICON
-CMIC_MASK_FLAG_NO_UI = SEE_MASK_FLAG_NO_UI
-CMIC_MASK_UNICODE = SEE_MASK_UNICODE
-CMIC_MASK_NO_CONSOLE = SEE_MASK_NO_CONSOLE
-CMIC_MASK_ASYNCOK = SEE_MASK_ASYNCOK
-CMIC_MASK_PTINVOKE = 536870912
-GIL_OPENICON = 1
-GIL_FORSHELL = 2
-GIL_ASYNC = 32
-GIL_DEFAULTICON = 64
-GIL_FORSHORTCUT = 128
-GIL_CHECKSHIELD = 512
-GIL_SIMULATEDOC = 1
-GIL_PERINSTANCE = 2
-GIL_PERCLASS = 4
-GIL_NOTFILENAME = 8
-GIL_DONTCACHE = 16
-GIL_SHIELD = 512
-GIL_FORCENOSHIELD = 1024
-ISIOI_ICONFILE = 1
-ISIOI_ICONINDEX = 2
-ISIOI_SYSIMAGELISTINDEX = 4
-FVSIF_RECT = 1
-FVSIF_PINNED = 2
-FVSIF_NEWFAILED = 134217728
-FVSIF_NEWFILE = -2147483648
-FVSIF_CANVIEWIT = 1073741824
-FCIDM_SHVIEWFIRST = 0
-FCIDM_SHVIEWLAST = 32767
-FCIDM_BROWSERFIRST = 40960
-FCIDM_BROWSERLAST = 48896
-FCIDM_GLOBALFIRST = 32768
-FCIDM_GLOBALLAST = 40959
-FCIDM_MENU_FILE = FCIDM_GLOBALFIRST + 0
-FCIDM_MENU_EDIT = FCIDM_GLOBALFIRST + 64
-FCIDM_MENU_VIEW = FCIDM_GLOBALFIRST + 128
-FCIDM_MENU_VIEW_SEP_OPTIONS = FCIDM_GLOBALFIRST + 129
-FCIDM_MENU_TOOLS = FCIDM_GLOBALFIRST + 192
-FCIDM_MENU_TOOLS_SEP_GOTO = FCIDM_GLOBALFIRST + 193
-FCIDM_MENU_HELP = FCIDM_GLOBALFIRST + 256
-FCIDM_MENU_FIND = FCIDM_GLOBALFIRST + 320
-FCIDM_MENU_EXPLORE = FCIDM_GLOBALFIRST + 336
-FCIDM_MENU_FAVORITES = FCIDM_GLOBALFIRST + 368
-FCIDM_TOOLBAR = FCIDM_BROWSERFIRST + 0
-FCIDM_STATUS = FCIDM_BROWSERFIRST + 1
-IDC_OFFLINE_HAND = 103
-SBSP_DEFBROWSER = 0
-SBSP_SAMEBROWSER = 1
-SBSP_NEWBROWSER = 2
-SBSP_DEFMODE = 0
-SBSP_OPENMODE = 16
-SBSP_EXPLOREMODE = 32
-SBSP_ABSOLUTE = 0
-SBSP_RELATIVE = 4096
-SBSP_PARENT = 8192
-SBSP_NAVIGATEBACK = 16384
-SBSP_NAVIGATEFORWARD = 32768
-SBSP_ALLOW_AUTONAVIGATE = 65536
-SBSP_INITIATEDBYHLINKFRAME = -2147483648
-SBSP_REDIRECT = 1073741824
-SBSP_WRITENOHISTORY = 134217728
-SBSP_NOAUTOSELECT = 67108864
-FCW_STATUS = 1
-FCW_TOOLBAR = 2
-FCW_TREE = 3
-FCW_INTERNETBAR = 6
-FCW_PROGRESS = 8
-FCT_MERGE = 1
-FCT_CONFIGABLE = 2
-FCT_ADDTOEND = 4
-CDBOSC_SETFOCUS = 0
-CDBOSC_KILLFOCUS = 1
-CDBOSC_SELCHANGE = 2
-CDBOSC_RENAME = 3
-SVSI_DESELECT = 0
-SVSI_SELECT = 1
-SVSI_EDIT = 3
-SVSI_DESELECTOTHERS = 4
-SVSI_ENSUREVISIBLE = 8
-SVSI_FOCUSED = 16
-SVSI_TRANSLATEPT = 32
-SVGIO_BACKGROUND = 0
-SVGIO_SELECTION = 1
-SVGIO_ALLVIEW = 2
-SVGIO_CHECKED = (0x3,)
-SVGIO_TYPE_MASK = (0xF,)
-SVGIO_FLAG_VIEWORDER = -2147483648  # 0x80000000
-STRRET_WSTR = 0
-STRRET_OFFSET = 1
-STRRET_CSTR = 2
-CSIDL_DESKTOP = 0
-CSIDL_INTERNET = 1
-CSIDL_PROGRAMS = 2
-CSIDL_CONTROLS = 3
-CSIDL_PRINTERS = 4
-CSIDL_PERSONAL = 5
-CSIDL_FAVORITES = 6
-CSIDL_STARTUP = 7
-CSIDL_RECENT = 8
-CSIDL_SENDTO = 9
-CSIDL_BITBUCKET = 10
-CSIDL_STARTMENU = 11
-CSIDL_MYDOCUMENTS = 12
-CSIDL_MYMUSIC = 13
-CSIDL_MYVIDEO = 14
-CSIDL_DESKTOPDIRECTORY = 16
-CSIDL_DRIVES = 17
-CSIDL_NETWORK = 18
-CSIDL_NETHOOD = 19
-CSIDL_FONTS = 20
-CSIDL_TEMPLATES = 21
-CSIDL_COMMON_STARTMENU = 22
-CSIDL_COMMON_PROGRAMS = 23
-CSIDL_COMMON_STARTUP = 24
-CSIDL_COMMON_DESKTOPDIRECTORY = 25
-CSIDL_APPDATA = 26
-CSIDL_PRINTHOOD = 27
-CSIDL_LOCAL_APPDATA = 28
-CSIDL_ALTSTARTUP = 29
-CSIDL_COMMON_ALTSTARTUP = 30
-CSIDL_COMMON_FAVORITES = 31
-CSIDL_INTERNET_CACHE = 32
-CSIDL_COOKIES = 33
-CSIDL_HISTORY = 34
-CSIDL_COMMON_APPDATA = 35
-CSIDL_WINDOWS = 36
-CSIDL_SYSTEM = 37
-CSIDL_PROGRAM_FILES = 38
-CSIDL_MYPICTURES = 39
-CSIDL_PROFILE = 40
-CSIDL_SYSTEMX86 = 41
-CSIDL_PROGRAM_FILESX86 = 42
-CSIDL_PROGRAM_FILES_COMMON = 43
-CSIDL_PROGRAM_FILES_COMMONX86 = 44
-CSIDL_COMMON_TEMPLATES = 45
-CSIDL_COMMON_DOCUMENTS = 46
-CSIDL_COMMON_ADMINTOOLS = 47
-CSIDL_ADMINTOOLS = 48
-CSIDL_CONNECTIONS = 49
-CSIDL_COMMON_MUSIC = 53
-CSIDL_COMMON_PICTURES = 54
-CSIDL_COMMON_VIDEO = 55
-CSIDL_RESOURCES = 56
-CSIDL_RESOURCES_LOCALIZED = 57
-CSIDL_COMMON_OEM_LINKS = 58
-CSIDL_CDBURN_AREA = 59
-# 60 unused
-CSIDL_COMPUTERSNEARME = 61
-
-BIF_RETURNONLYFSDIRS = 1
-BIF_DONTGOBELOWDOMAIN = 2
-BIF_STATUSTEXT = 4
-BIF_RETURNFSANCESTORS = 8
-BIF_EDITBOX = 16
-BIF_VALIDATE = 32
-BIF_BROWSEFORCOMPUTER = 4096
-BIF_BROWSEFORPRINTER = 8192
-BIF_BROWSEINCLUDEFILES = 16384
-BFFM_INITIALIZED = 1
-BFFM_SELCHANGED = 2
-BFFM_VALIDATEFAILEDA = 3
-BFFM_VALIDATEFAILEDW = 4
-BFFM_SETSTATUSTEXTA = WM_USER + 100
-BFFM_ENABLEOK = WM_USER + 101
-BFFM_SETSELECTIONA = WM_USER + 102
-BFFM_SETSELECTIONW = WM_USER + 103
-BFFM_SETSTATUSTEXTW = WM_USER + 104
-BFFM_SETSTATUSTEXT = BFFM_SETSTATUSTEXTA
-BFFM_SETSELECTION = BFFM_SETSELECTIONA
-BFFM_VALIDATEFAILED = BFFM_VALIDATEFAILEDA
-SFGAO_CANCOPY = DROPEFFECT_COPY
-SFGAO_CANMOVE = DROPEFFECT_MOVE
-SFGAO_CANLINK = DROPEFFECT_LINK
-SFGAO_CANRENAME = 16
-SFGAO_CANDELETE = 32
-SFGAO_HASPROPSHEET = 64
-SFGAO_DROPTARGET = 256
-SFGAO_CAPABILITYMASK = 375
-SFGAO_LINK = 65536
-SFGAO_SHARE = 131072
-SFGAO_READONLY = 262144
-SFGAO_GHOSTED = 524288
-SFGAO_HIDDEN = 524288
-SFGAO_DISPLAYATTRMASK = 983040
-SFGAO_FILESYSANCESTOR = 268435456
-SFGAO_FOLDER = 536870912
-SFGAO_FILESYSTEM = 1073741824
-SFGAO_HASSUBFOLDER = -2147483648
-SFGAO_CONTENTSMASK = -2147483648
-SFGAO_VALIDATE = 16777216
-SFGAO_REMOVABLE = 33554432
-SFGAO_COMPRESSED = 67108864
-SFGAO_BROWSABLE = 134217728
-SFGAO_NONENUMERATED = 1048576
-SFGAO_NEWCONTENT = 2097152
-SFGAO_STORAGE = 8
-DWFRF_NORMAL = 0
-DWFRF_DELETECONFIGDATA = 1
-DWFAF_HIDDEN = 1
-CFSTR_SHELLIDLIST = "Shell IDList Array"
-CFSTR_SHELLIDLISTOFFSET = "Shell Object Offsets"
-CFSTR_NETRESOURCES = "Net Resource"
-CFSTR_FILEDESCRIPTORA = "FileGroupDescriptor"
-CFSTR_FILEDESCRIPTORW = "FileGroupDescriptorW"
-CFSTR_FILECONTENTS = "FileContents"
-CFSTR_FILENAMEA = "FileName"
-CFSTR_FILENAMEW = "FileNameW"
-CFSTR_PRINTERGROUP = "PrinterFriendlyName"
-CFSTR_FILENAMEMAPA = "FileNameMap"
-CFSTR_FILENAMEMAPW = "FileNameMapW"
-CFSTR_SHELLURL = "UniformResourceLocator"
-CFSTR_INETURLA = CFSTR_SHELLURL
-CFSTR_INETURLW = "UniformResourceLocatorW"
-CFSTR_PREFERREDDROPEFFECT = "Preferred DropEffect"
-CFSTR_PERFORMEDDROPEFFECT = "Performed DropEffect"
-CFSTR_PASTESUCCEEDED = "Paste Succeeded"
-CFSTR_INDRAGLOOP = "InShellDragLoop"
-CFSTR_DRAGCONTEXT = "DragContext"
-CFSTR_MOUNTEDVOLUME = "MountedVolume"
-CFSTR_PERSISTEDDATAOBJECT = "PersistedDataObject"
-CFSTR_TARGETCLSID = "TargetCLSID"
-CFSTR_LOGICALPERFORMEDDROPEFFECT = "Logical Performed DropEffect"
-CFSTR_AUTOPLAY_SHELLIDLISTS = "Autoplay Enumerated IDList Array"
-CFSTR_FILEDESCRIPTOR = CFSTR_FILEDESCRIPTORA
-CFSTR_FILENAME = CFSTR_FILENAMEA
-CFSTR_FILENAMEMAP = CFSTR_FILENAMEMAPA
-DVASPECT_SHORTNAME = 2
-SHCNE_RENAMEITEM = 1
-SHCNE_CREATE = 2
-SHCNE_DELETE = 4
-SHCNE_MKDIR = 8
-SHCNE_RMDIR = 16
-SHCNE_MEDIAINSERTED = 32
-SHCNE_MEDIAREMOVED = 64
-SHCNE_DRIVEREMOVED = 128
-SHCNE_DRIVEADD = 256
-SHCNE_NETSHARE = 512
-SHCNE_NETUNSHARE = 1024
-SHCNE_ATTRIBUTES = 2048
-SHCNE_UPDATEDIR = 4096
-SHCNE_UPDATEITEM = 8192
-SHCNE_SERVERDISCONNECT = 16384
-SHCNE_UPDATEIMAGE = 32768
-SHCNE_DRIVEADDGUI = 65536
-SHCNE_RENAMEFOLDER = 131072
-SHCNE_FREESPACE = 262144
-SHCNE_EXTENDED_EVENT = 67108864
-SHCNE_ASSOCCHANGED = 134217728
-SHCNE_DISKEVENTS = 145439
-SHCNE_GLOBALEVENTS = 201687520
-SHCNE_ALLEVENTS = 2147483647
-SHCNE_INTERRUPT = -2147483648
-SHCNEE_ORDERCHANGED = 2
-SHCNF_IDLIST = 0
-SHCNF_PATHA = 1
-SHCNF_PRINTERA = 2
-SHCNF_DWORD = 3
-SHCNF_PATHW = 5
-SHCNF_PRINTERW = 6
-SHCNF_TYPE = 255
-SHCNF_FLUSH = 4096
-SHCNF_FLUSHNOWAIT = 8192
-SHCNF_PATH = SHCNF_PATHA
-SHCNF_PRINTER = SHCNF_PRINTERA
-QIF_CACHED = 1
-QIF_DONTEXPANDFOLDER = 2
-
-# SHARD enum for SHAddToRecentDocs
-SHARD_PIDL = 1
-SHARD_PATHA = 2
-SHARD_PATHW = 3
-SHARD_APPIDINFO = 4
-SHARD_APPIDINFOIDLIST = 5
-SHARD_LINK = 6
-SHARD_APPIDINFOLINK = 7
-SHARD_SHELLITEM = 8
-## SHARD_PATH = SHARD_PATHW
-SHARD_PATH = SHARD_PATHA
-
-SHGDFIL_FINDDATA = 1
-SHGDFIL_NETRESOURCE = 2
-SHGDFIL_DESCRIPTIONID = 3
-SHDID_ROOT_REGITEM = 1
-SHDID_FS_FILE = 2
-SHDID_FS_DIRECTORY = 3
-SHDID_FS_OTHER = 4
-SHDID_COMPUTER_DRIVE35 = 5
-SHDID_COMPUTER_DRIVE525 = 6
-SHDID_COMPUTER_REMOVABLE = 7
-SHDID_COMPUTER_FIXED = 8
-SHDID_COMPUTER_NETDRIVE = 9
-SHDID_COMPUTER_CDROM = 10
-SHDID_COMPUTER_RAMDISK = 11
-SHDID_COMPUTER_OTHER = 12
-SHDID_NET_DOMAIN = 13
-SHDID_NET_SERVER = 14
-SHDID_NET_SHARE = 15
-SHDID_NET_RESTOFNET = 16
-SHDID_NET_OTHER = 17
-PID_IS_URL = 2
-PID_IS_NAME = 4
-PID_IS_WORKINGDIR = 5
-PID_IS_HOTKEY = 6
-PID_IS_SHOWCMD = 7
-PID_IS_ICONINDEX = 8
-PID_IS_ICONFILE = 9
-PID_IS_WHATSNEW = 10
-PID_IS_AUTHOR = 11
-PID_IS_DESCRIPTION = 12
-PID_IS_COMMENT = 13
-PID_INTSITE_WHATSNEW = 2
-PID_INTSITE_AUTHOR = 3
-PID_INTSITE_LASTVISIT = 4
-PID_INTSITE_LASTMOD = 5
-PID_INTSITE_VISITCOUNT = 6
-PID_INTSITE_DESCRIPTION = 7
-PID_INTSITE_COMMENT = 8
-PID_INTSITE_FLAGS = 9
-PID_INTSITE_CONTENTLEN = 10
-PID_INTSITE_CONTENTCODE = 11
-PID_INTSITE_RECURSE = 12
-PID_INTSITE_WATCH = 13
-PID_INTSITE_SUBSCRIPTION = 14
-PID_INTSITE_URL = 15
-PID_INTSITE_TITLE = 16
-PID_INTSITE_CODEPAGE = 18
-PID_INTSITE_TRACKING = 19
-PIDISF_RECENTLYCHANGED = 1
-PIDISF_CACHEDSTICKY = 2
-PIDISF_CACHEIMAGES = 16
-PIDISF_FOLLOWALLLINKS = 32
-PIDISM_GLOBAL = 0
-PIDISM_WATCH = 1
-PIDISM_DONTWATCH = 2
-SSF_SHOWALLOBJECTS = 1
-SSF_SHOWEXTENSIONS = 2
-SSF_SHOWCOMPCOLOR = 8
-SSF_SHOWSYSFILES = 32
-SSF_DOUBLECLICKINWEBVIEW = 128
-SSF_SHOWATTRIBCOL = 256
-SSF_DESKTOPHTML = 512
-SSF_WIN95CLASSIC = 1024
-SSF_DONTPRETTYPATH = 2048
-SSF_SHOWINFOTIP = 8192
-SSF_MAPNETDRVBUTTON = 4096
-SSF_NOCONFIRMRECYCLE = 32768
-SSF_HIDEICONS = 16384
-
-ABM_NEW = 0
-ABM_REMOVE = 1
-ABM_QUERYPOS = 2
-ABM_SETPOS = 3
-ABM_GETSTATE = 4
-ABM_GETTASKBARPOS = 5
-ABM_ACTIVATE = 6
-ABM_GETAUTOHIDEBAR = 7
-ABM_SETAUTOHIDEBAR = 8
-ABM_WINDOWPOSCHANGED = 9
-ABN_STATECHANGE = 0
-ABN_POSCHANGED = 1
-ABN_FULLSCREENAPP = 2
-ABN_WINDOWARRANGE = 3
-ABS_AUTOHIDE = 1
-ABS_ALWAYSONTOP = 2
-ABE_LEFT = 0
-ABE_TOP = 1
-ABE_RIGHT = 2
-ABE_BOTTOM = 3
-
-
-def EIRESID(x):
-    return -1 * (int)(x)
-
-
-# Some manually added ones
-
-SHCONTF_FOLDERS = 32  # for shell browser
-SHCONTF_NONFOLDERS = 64  # for default view
-SHCONTF_INCLUDEHIDDEN = 128  # for hidden/system objects
-SHCONTF_INIT_ON_FIRST_NEXT = 256
-SHCONTF_NETPRINTERSRCH = 512
-SHCONTF_SHAREABLE = 1024
-SHCONTF_STORAGE = 2048
-
-SHGDN_NORMAL = 0  # default (display purpose)
-SHGDN_INFOLDER = 1  # displayed under a folder (relative)
-SHGDN_FOREDITING = 4096  # for in-place editing
-SHGDN_INCLUDE_NONFILESYS = 8192  # if not set, display names for shell name space items that are not in the file system will fail.
-SHGDN_FORADDRESSBAR = 16384  # for displaying in the address (drives dropdown) bar
-SHGDN_FORPARSING = 32768  # for ParseDisplayName or path
-
-BFO_NONE = 0
-BFO_BROWSER_PERSIST_SETTINGS = 1
-BFO_RENAME_FOLDER_OPTIONS_TOINTERNET = 2
-BFO_BOTH_OPTIONS = 4
-BIF_PREFER_INTERNET_SHORTCUT = 8
-BFO_BROWSE_NO_IN_NEW_PROCESS = 16
-BFO_ENABLE_HYPERLINK_TRACKING = 32
-BFO_USE_IE_OFFLINE_SUPPORT = 64
-BFO_SUBSTITUE_INTERNET_START_PAGE = 128
-BFO_USE_IE_LOGOBANDING = 256
-BFO_ADD_IE_TOCAPTIONBAR = 512
-BFO_USE_DIALUP_REF = 1024
-BFO_USE_IE_TOOLBAR = 2048
-BFO_NO_PARENT_FOLDER_SUPPORT = 4096
-BFO_NO_REOPEN_NEXT_RESTART = 8192
-BFO_GO_HOME_PAGE = 16384
-BFO_PREFER_IEPROCESS = 32768
-BFO_SHOW_NAVIGATION_CANCELLED = 65536
-BFO_QUERY_ALL = -1
-# From ShlGuid.h
-PID_FINDDATA = 0
-PID_NETRESOURCE = 1
-PID_DESCRIPTIONID = 2
-PID_WHICHFOLDER = 3
-PID_NETWORKLOCATION = 4
-PID_COMPUTERNAME = 5
-PID_DISPLACED_FROM = 2
-PID_DISPLACED_DATE = 3
-PID_SYNC_COPY_IN = 2
-PID_MISC_STATUS = 2
-PID_MISC_ACCESSCOUNT = 3
-PID_MISC_OWNER = 4
-PID_HTMLINFOTIPFILE = 5
-PID_MISC_PICS = 6
-PID_DISPLAY_PROPERTIES = 0
-PID_INTROTEXT = 1
-PIDSI_ARTIST = 2
-PIDSI_SONGTITLE = 3
-PIDSI_ALBUM = 4
-PIDSI_YEAR = 5
-PIDSI_COMMENT = 6
-PIDSI_TRACK = 7
-PIDSI_GENRE = 11
-PIDSI_LYRICS = 12
-PIDDRSI_PROTECTED = 2
-PIDDRSI_DESCRIPTION = 3
-PIDDRSI_PLAYCOUNT = 4
-PIDDRSI_PLAYSTARTS = 5
-PIDDRSI_PLAYEXPIRES = 6
-PIDVSI_STREAM_NAME = 2
-PIDVSI_FRAME_WIDTH = 3
-PIDVSI_FRAME_HEIGHT = 4
-PIDVSI_TIMELENGTH = 7
-PIDVSI_FRAME_COUNT = 5
-PIDVSI_FRAME_RATE = 6
-PIDVSI_DATA_RATE = 8
-PIDVSI_SAMPLE_SIZE = 9
-PIDVSI_COMPRESSION = 10
-PIDVSI_STREAM_NUMBER = 11
-PIDASI_FORMAT = 2
-PIDASI_TIMELENGTH = 3
-PIDASI_AVG_DATA_RATE = 4
-PIDASI_SAMPLE_RATE = 5
-PIDASI_SAMPLE_SIZE = 6
-PIDASI_CHANNEL_COUNT = 7
-PIDASI_STREAM_NUMBER = 8
-PIDASI_STREAM_NAME = 9
-PIDASI_COMPRESSION = 10
-PID_CONTROLPANEL_CATEGORY = 2
-PID_VOLUME_FREE = 2
-PID_VOLUME_CAPACITY = 3
-PID_VOLUME_FILESYSTEM = 4
-PID_SHARE_CSC_STATUS = 2
-PID_LINK_TARGET = 2
-PID_QUERY_RANK = 2
-# From PropIdl.h
-PROPSETFLAG_DEFAULT = 0
-PROPSETFLAG_NONSIMPLE = 1
-PROPSETFLAG_ANSI = 2
-PROPSETFLAG_UNBUFFERED = 4
-PROPSETFLAG_CASE_SENSITIVE = 8
-PROPSET_BEHAVIOR_CASE_SENSITIVE = 1
-PID_DICTIONARY = 0
-PID_CODEPAGE = 1
-PID_FIRST_USABLE = 2
-PID_FIRST_NAME_DEFAULT = 4095
-PID_LOCALE = -2147483648
-PID_MODIFY_TIME = -2147483647
-PID_SECURITY = -2147483646
-PID_BEHAVIOR = -2147483645
-PID_ILLEGAL = -1
-PID_MIN_READONLY = -2147483648
-PID_MAX_READONLY = -1073741825
-PIDDI_THUMBNAIL = 2
-PIDSI_TITLE = 2
-PIDSI_SUBJECT = 3
-PIDSI_AUTHOR = 4
-PIDSI_KEYWORDS = 5
-PIDSI_COMMENTS = 6
-PIDSI_TEMPLATE = 7
-PIDSI_LASTAUTHOR = 8
-PIDSI_REVNUMBER = 9
-PIDSI_EDITTIME = 10
-PIDSI_LASTPRINTED = 11
-PIDSI_CREATE_DTM = 12
-PIDSI_LASTSAVE_DTM = 13
-PIDSI_PAGECOUNT = 14
-PIDSI_WORDCOUNT = 15
-PIDSI_CHARCOUNT = 16
-PIDSI_THUMBNAIL = 17
-PIDSI_APPNAME = 18
-PIDSI_DOC_SECURITY = 19
-PIDDSI_CATEGORY = 2
-PIDDSI_PRESFORMAT = 3
-PIDDSI_BYTECOUNT = 4
-PIDDSI_LINECOUNT = 5
-PIDDSI_PARCOUNT = 6
-PIDDSI_SLIDECOUNT = 7
-PIDDSI_NOTECOUNT = 8
-PIDDSI_HIDDENCOUNT = 9
-PIDDSI_MMCLIPCOUNT = 10
-PIDDSI_SCALE = 11
-PIDDSI_HEADINGPAIR = 12
-PIDDSI_DOCPARTS = 13
-PIDDSI_MANAGER = 14
-PIDDSI_COMPANY = 15
-PIDDSI_LINKSDIRTY = 16
-PIDMSI_EDITOR = 2
-PIDMSI_SUPPLIER = 3
-PIDMSI_SOURCE = 4
-PIDMSI_SEQUENCE_NO = 5
-PIDMSI_PROJECT = 6
-PIDMSI_STATUS = 7
-PIDMSI_OWNER = 8
-PIDMSI_RATING = 9
-PIDMSI_PRODUCTION = 10
-PIDMSI_COPYRIGHT = 11
-PRSPEC_INVALID = -1
-PRSPEC_LPWSTR = 0
-PRSPEC_PROPID = 1
-# From ShObjIdl.h
-SHCIDS_ALLFIELDS = -2147483648
-SHCIDS_CANONICALONLY = 268435456
-SHCIDS_BITMASK = -65536
-SHCIDS_COLUMNMASK = 65535
-SFGAO_CANMONIKER = 4194304
-SFGAO_HASSTORAGE = 4194304
-SFGAO_STREAM = 4194304
-SFGAO_STORAGEANCESTOR = 8388608
-SFGAO_STORAGECAPMASK = 1891958792
-
-MAXPROPPAGES = 100
-PSP_DEFAULT = 0
-PSP_DLGINDIRECT = 1
-PSP_USEHICON = 2
-PSP_USEICONID = 4
-PSP_USETITLE = 8
-PSP_RTLREADING = 16
-PSP_HASHELP = 32
-PSP_USEREFPARENT = 64
-PSP_USECALLBACK = 128
-PSP_PREMATURE = 1024
-PSP_HIDEHEADER = 2048
-PSP_USEHEADERTITLE = 4096
-PSP_USEHEADERSUBTITLE = 8192
-PSP_USEFUSIONCONTEXT = 16384
-PSPCB_ADDREF = 0
-PSPCB_RELEASE = 1
-PSPCB_CREATE = 2
-
-PSH_DEFAULT = 0
-PSH_PROPTITLE = 1
-PSH_USEHICON = 2
-PSH_USEICONID = 4
-PSH_PROPSHEETPAGE = 8
-PSH_WIZARDHASFINISH = 16
-PSH_WIZARD = 32
-PSH_USEPSTARTPAGE = 64
-PSH_NOAPPLYNOW = 128
-PSH_USECALLBACK = 256
-PSH_HASHELP = 512
-PSH_MODELESS = 1024
-PSH_RTLREADING = 2048
-PSH_WIZARDCONTEXTHELP = 4096
-PSH_WIZARD97 = 16777216
-PSH_WATERMARK = 32768
-PSH_USEHBMWATERMARK = 65536
-PSH_USEHPLWATERMARK = 131072
-PSH_STRETCHWATERMARK = 262144
-PSH_HEADER = 524288
-PSH_USEHBMHEADER = 1048576
-PSH_USEPAGELANG = 2097152
-PSH_WIZARD_LITE = 4194304
-PSH_NOCONTEXTHELP = 33554432
-
-PSCB_INITIALIZED = 1
-PSCB_PRECREATE = 2
-PSCB_BUTTONPRESSED = 3
-PSNRET_NOERROR = 0
-PSNRET_INVALID = 1
-PSNRET_INVALID_NOCHANGEPAGE = 2
-PSNRET_MESSAGEHANDLED = 3
-
-PSWIZB_BACK = 1
-PSWIZB_NEXT = 2
-PSWIZB_FINISH = 4
-PSWIZB_DISABLEDFINISH = 8
-PSBTN_BACK = 0
-PSBTN_NEXT = 1
-PSBTN_FINISH = 2
-PSBTN_OK = 3
-PSBTN_APPLYNOW = 4
-PSBTN_CANCEL = 5
-PSBTN_HELP = 6
-PSBTN_MAX = 6
-
-ID_PSRESTARTWINDOWS = 2
-ID_PSREBOOTSYSTEM = ID_PSRESTARTWINDOWS | 1
-WIZ_CXDLG = 276
-WIZ_CYDLG = 140
-WIZ_CXBMP = 80
-WIZ_BODYX = 92
-WIZ_BODYCX = 184
-PROP_SM_CXDLG = 212
-PROP_SM_CYDLG = 188
-PROP_MED_CXDLG = 227
-PROP_MED_CYDLG = 215
-PROP_LG_CXDLG = 252
-PROP_LG_CYDLG = 218
-ISOLATION_AWARE_USE_STATIC_LIBRARY = 0
-ISOLATION_AWARE_BUILD_STATIC_LIBRARY = 0
-
-SHCOLSTATE_TYPE_STR = 1
-SHCOLSTATE_TYPE_INT = 2
-SHCOLSTATE_TYPE_DATE = 3
-SHCOLSTATE_TYPEMASK = 15
-SHCOLSTATE_ONBYDEFAULT = 16
-SHCOLSTATE_SLOW = 32
-SHCOLSTATE_EXTENDED = 64
-SHCOLSTATE_SECONDARYUI = 128
-SHCOLSTATE_HIDDEN = 256
-SHCOLSTATE_PREFER_VARCMP = 512
-
-FWF_AUTOARRANGE = 1
-FWF_ABBREVIATEDNAMES = 2
-FWF_SNAPTOGRID = 4
-FWF_OWNERDATA = 8
-FWF_BESTFITWINDOW = 16
-FWF_DESKTOP = 32
-FWF_SINGLESEL = 64
-FWF_NOSUBFOLDERS = 128
-FWF_TRANSPARENT = 256
-FWF_NOCLIENTEDGE = 512
-FWF_NOSCROLL = 1024
-FWF_ALIGNLEFT = 2048
-FWF_NOICONS = 4096
-FWF_SHOWSELALWAYS = 8192
-FWF_NOVISIBLE = 16384
-FWF_SINGLECLICKACTIVATE = 32768
-FWF_NOWEBVIEW = 65536
-FWF_HIDEFILENAMES = 131072
-FWF_CHECKSELECT = 262144
-
-FVM_FIRST = 1
-FVM_ICON = 1
-FVM_SMALLICON = 2
-FVM_LIST = 3
-FVM_DETAILS = 4
-FVM_THUMBNAIL = 5
-FVM_TILE = 6
-FVM_THUMBSTRIP = 7
-
-SVUIA_DEACTIVATE = 0
-SVUIA_ACTIVATE_NOFOCUS = 1
-SVUIA_ACTIVATE_FOCUS = 2
-SVUIA_INPLACEACTIVATE = 3
-
-# SHChangeNotifyRegister flags
-SHCNRF_InterruptLevel = 1
-SHCNRF_ShellLevel = 2
-SHCNRF_RecursiveInterrupt = 4096
-SHCNRF_NewDelivery = 32768
-
-FD_CLSID = 0x0001
-FD_SIZEPOINT = 0x0002
-FD_ATTRIBUTES = 0x0004
-FD_CREATETIME = 0x0008
-FD_ACCESSTIME = 0x0010
-FD_WRITESTIME = 0x0020
-FD_FILESIZE = 0x0040
-FD_PROGRESSUI = 0x4000
-FD_LINKUI = 0x8000
-
-# shlwapi stuff
-ASSOCF_INIT_NOREMAPCLSID = 0x00000001  #  do not remap clsids to progids
-ASSOCF_INIT_BYEXENAME = 0x00000002  # executable is being passed in
-ASSOCF_OPEN_BYEXENAME = 0x00000002  # executable is being passed in
-ASSOCF_INIT_DEFAULTTOSTAR = 0x00000004  # treat "*" as the BaseClass
-ASSOCF_INIT_DEFAULTTOFOLDER = 0x00000008  # treat "Folder" as the BaseClass
-ASSOCF_NOUSERSETTINGS = 0x00000010  #  dont use HKCU
-ASSOCF_NOTRUNCATE = 0x00000020  # dont truncate the return string
-ASSOCF_VERIFY = 0x00000040  #  verify data is accurate (DISK HITS)
-ASSOCF_REMAPRUNDLL = 0x00000080  # actually gets info about rundlls target if applicable
-ASSOCF_NOFIXUPS = 0x00000100  # attempt to fix errors if found
-ASSOCF_IGNOREBASECLASS = 0x00000200  # dont recurse into the baseclass
-
-ASSOCSTR_COMMAND = 1  # shell\verb\command string
-ASSOCSTR_EXECUTABLE = 2  # the executable part of command string
-ASSOCSTR_FRIENDLYDOCNAME = 3  # friendly name of the document type
-ASSOCSTR_FRIENDLYAPPNAME = 4  # friendly name of executable
-ASSOCSTR_NOOPEN = 5  # noopen value
-ASSOCSTR_SHELLNEWVALUE = 6  # query values under the shellnew key
-ASSOCSTR_DDECOMMAND = 7  # template for DDE commands
-ASSOCSTR_DDEIFEXEC = 8  # DDECOMMAND to use if just create a process
-ASSOCSTR_DDEAPPLICATION = 9  # Application name in DDE broadcast
-ASSOCSTR_DDETOPIC = 10  # Topic Name in DDE broadcast
-ASSOCSTR_INFOTIP = (
-    11  # info tip for an item, or list of properties to create info tip from
-)
-ASSOCSTR_QUICKTIP = 12  # same as ASSOCSTR_INFOTIP, except, this list contains only quickly retrievable properties
-ASSOCSTR_TILEINFO = (
-    13  # similar to ASSOCSTR_INFOTIP - lists important properties for tileview
-)
-ASSOCSTR_CONTENTTYPE = 14  # MIME Content type
-ASSOCSTR_DEFAULTICON = 15  # Default icon source
-ASSOCSTR_SHELLEXTENSION = (
-    16  # Guid string pointing to the Shellex\Shellextensionhandler value.
-)
-
-ASSOCKEY_SHELLEXECCLASS = 1  # the key that should be passed to ShellExec(hkeyClass)
-ASSOCKEY_APP = 2  # the "Application" key for the association
-ASSOCKEY_CLASS = 3  # the progid or class key
-ASSOCKEY_BASECLASS = 4  # the BaseClass key
-
-ASSOCDATA_MSIDESCRIPTOR = 1  # Component Descriptor to pass to MSI APIs
-ASSOCDATA_NOACTIVATEHANDLER = 2  # restrict attempts to activate window
-ASSOCDATA_QUERYCLASSSTORE = 3  # should check with the NT Class Store
-ASSOCDATA_HASPERUSERASSOC = 4  # defaults to user specified association
-ASSOCDATA_EDITFLAGS = 5  # Edit flags.
-ASSOCDATA_VALUE = 6  # use pszExtra as the Value name
-
-# flags used with SHGetViewStatePropertyBag
-SHGVSPB_PERUSER = 1
-SHGVSPB_ALLUSERS = 2
-SHGVSPB_PERFOLDER = 4
-SHGVSPB_ALLFOLDERS = 8
-SHGVSPB_INHERIT = 16
-SHGVSPB_ROAM = 32
-SHGVSPB_NOAUTODEFAULTS = 0x80000000
-SHGVSPB_FOLDER = SHGVSPB_PERUSER | SHGVSPB_PERFOLDER
-SHGVSPB_FOLDERNODEFAULTS = SHGVSPB_PERUSER | SHGVSPB_PERFOLDER | SHGVSPB_NOAUTODEFAULTS
-SHGVSPB_USERDEFAULTS = SHGVSPB_PERUSER | SHGVSPB_ALLFOLDERS
-SHGVSPB_GLOBALDEAFAULTS = SHGVSPB_ALLUSERS | SHGVSPB_ALLFOLDERS
-
-# IDeskband and related
-DBIM_MINSIZE = 0x0001
-DBIM_MAXSIZE = 0x0002
-DBIM_INTEGRAL = 0x0004
-DBIM_ACTUAL = 0x0008
-DBIM_TITLE = 0x0010
-DBIM_MODEFLAGS = 0x0020
-DBIM_BKCOLOR = 0x0040
-
-DBIMF_NORMAL = 0x0000
-DBIMF_VARIABLEHEIGHT = 0x0008
-DBIMF_DEBOSSED = 0x0020
-DBIMF_BKCOLOR = 0x0040
-
-DBIF_VIEWMODE_NORMAL = 0x0000
-DBIF_VIEWMODE_VERTICAL = 0x0001
-DBIF_VIEWMODE_FLOATING = 0x0002
-DBIF_VIEWMODE_TRANSPARENT = 0x0004
-
-# Message types used with SHShellFolderView_Message
-SFVM_REARRANGE = 1
-SFVM_ADDOBJECT = 3
-SFVM_REMOVEOBJECT = 6
-SFVM_UPDATEOBJECT = 7
-SFVM_GETSELECTEDOBJECTS = 9
-SFVM_SETITEMPOS = 14
-SFVM_SETCLIPBOARD = 16
-SFVM_SETPOINTS = 23
-
-# SHELL_LINK_DATA_FLAGS enum, used with IShellLinkDatalist
-SLDF_HAS_ID_LIST = 1
-SLDF_HAS_LINK_INFO = 2
-SLDF_HAS_NAME = 4
-SLDF_HAS_RELPATH = 8
-SLDF_HAS_WORKINGDIR = 16
-SLDF_HAS_ARGS = 32
-SLDF_HAS_ICONLOCATION = 64
-SLDF_UNICODE = 128
-SLDF_FORCE_NO_LINKINFO = 256
-SLDF_HAS_EXP_SZ = 512
-SLDF_RUN_IN_SEPARATE = 1024
-SLDF_HAS_LOGO3ID = 2048
-SLDF_HAS_DARWINID = 4096
-SLDF_RUNAS_USER = 8192
-SLDF_NO_PIDL_ALIAS = 32768
-SLDF_FORCE_UNCNAME = 65536
-SLDF_HAS_EXP_ICON_SZ = 16384
-SLDF_RUN_WITH_SHIMLAYER = 131072
-SLDF_RESERVED = 2147483648
-
-# IShellLinkDataList data block signatures
-EXP_SPECIAL_FOLDER_SIG = 2684354565
-NT_CONSOLE_PROPS_SIG = 2684354562
-NT_FE_CONSOLE_PROPS_SIG = 2684354564
-EXP_DARWIN_ID_SIG = 2684354566
-EXP_LOGO3_ID_SIG = 2684354567
-EXP_SZ_ICON_SIG = 2684354567
-EXP_SZ_LINK_SIG = 2684354561
-
-# IURL_SETURL_FLAGS enum, used with PyIUniformResourceLocator.SetURL
-IURL_SETURL_FL_GUESS_PROTOCOL = 1
-IURL_SETURL_FL_USE_DEFAULT_PROTOCOL = 2
-
-# IURL_INVOKECOMMAND_FLAGS enum, used with PyIUniformResourceLocator.InvokeCommand
-IURL_INVOKECOMMAND_FL_ALLOW_UI = 1
-IURL_INVOKECOMMAND_FL_USE_DEFAULT_VERB = 2
-IURL_INVOKECOMMAND_FL_DDEWAIT = 4
-
-## constants used with IActiveDesktop
-# COMPONENT.ComponentType
-COMP_TYPE_HTMLDOC = 0
-COMP_TYPE_PICTURE = 1
-COMP_TYPE_WEBSITE = 2
-COMP_TYPE_CONTROL = 3
-COMP_TYPE_CFHTML = 4
-COMP_TYPE_MAX = 4
-# COMPONENT.CurItemState
-IS_NORMAL = 1
-IS_FULLSCREEN = 2
-IS_SPLIT = 4
-IS_VALIDSIZESTATEBITS = IS_NORMAL | IS_SPLIT | IS_FULLSCREEN
-IS_VALIDSTATEBITS = IS_NORMAL | IS_SPLIT | IS_FULLSCREEN | 0x80000000 | 0x40000000
-# IActiveDesktop.ApplyChanges Flags
-AD_APPLY_SAVE = 1
-AD_APPLY_HTMLGEN = 2
-AD_APPLY_REFRESH = 4
-AD_APPLY_ALL = AD_APPLY_SAVE | AD_APPLY_HTMLGEN | AD_APPLY_REFRESH
-AD_APPLY_FORCE = 8
-AD_APPLY_BUFFERED_REFRESH = 16
-AD_APPLY_DYNAMICREFRESH = 32
-# Wallpaper styles used with GetWallpaper and SetWallpaper
-WPSTYLE_CENTER = 0
-WPSTYLE_TILE = 1
-WPSTYLE_STRETCH = 2
-WPSTYLE_MAX = 3
-# ModifyDesktopItem flags
-COMP_ELEM_TYPE = 0x00000001
-COMP_ELEM_CHECKED = 0x00000002
-COMP_ELEM_DIRTY = 0x00000004
-COMP_ELEM_NOSCROLL = 0x00000008
-COMP_ELEM_POS_LEFT = 0x00000010
-COMP_ELEM_POS_TOP = 0x00000020
-COMP_ELEM_SIZE_WIDTH = 0x00000040
-COMP_ELEM_SIZE_HEIGHT = 0x00000080
-COMP_ELEM_POS_ZINDEX = 0x00000100
-COMP_ELEM_SOURCE = 0x00000200
-COMP_ELEM_FRIENDLYNAME = 0x00000400
-COMP_ELEM_SUBSCRIBEDURL = 0x00000800
-COMP_ELEM_ORIGINAL_CSI = 0x00001000
-COMP_ELEM_RESTORED_CSI = 0x00002000
-COMP_ELEM_CURITEMSTATE = 0x00004000
-COMP_ELEM_ALL = (
-    COMP_ELEM_TYPE
-    | COMP_ELEM_CHECKED
-    | COMP_ELEM_DIRTY
-    | COMP_ELEM_NOSCROLL
-    | COMP_ELEM_POS_LEFT
-    | COMP_ELEM_SIZE_WIDTH
-    | COMP_ELEM_SIZE_HEIGHT
-    | COMP_ELEM_POS_ZINDEX
-    | COMP_ELEM_SOURCE
-    | COMP_ELEM_FRIENDLYNAME
-    | COMP_ELEM_POS_TOP
-    | COMP_ELEM_SUBSCRIBEDURL
-    | COMP_ELEM_ORIGINAL_CSI
-    | COMP_ELEM_RESTORED_CSI
-    | COMP_ELEM_CURITEMSTATE
-)
-
-DTI_ADDUI_DEFAULT = 0
-DTI_ADDUI_DISPSUBWIZARD = 1
-DTI_ADDUI_POSITIONITEM = 2
-ADDURL_SILENT = 0x0001
-COMPONENT_TOP = 0x3FFFFFFF
-COMPONENT_DEFAULT_LEFT = 0xFFFF
-COMPONENT_DEFAULT_TOP = 0xFFFF
-
-SSM_CLEAR = 0
-SSM_SET = 1
-SSM_REFRESH = 2
-SSM_UPDATE = 4
-
-SCHEME_DISPLAY = 0x0001
-SCHEME_EDIT = 0x0002
-SCHEME_LOCAL = 0x0004
-SCHEME_GLOBAL = 0x0008
-SCHEME_REFRESH = 0x0010
-SCHEME_UPDATE = 0x0020
-SCHEME_DONOTUSE = 0x0040
-SCHEME_CREATE = 0x0080
-
-GADOF_DIRTY = 1
-
-# From EmptyVC.h
-EVCF_HASSETTINGS = 0x0001
-EVCF_ENABLEBYDEFAULT = 0x0002
-EVCF_REMOVEFROMLIST = 0x0004
-EVCF_ENABLEBYDEFAULT_AUTO = 0x0008
-EVCF_DONTSHOWIFZERO = 0x0010
-EVCF_SETTINGSMODE = 0x0020
-EVCF_OUTOFDISKSPACE = 0x0040
-EVCCBF_LASTNOTIFICATION = 0x0001
-
-# ShObjIdl.h IExplorer* related
-EBO_NONE = 0
-EBO_NAVIGATEONCE = 0x1
-EBO_SHOWFRAMES = 0x2
-EBO_ALWAYSNAVIGATE = 0x4
-EBO_NOTRAVELLOG = 0x8
-EBO_NOWRAPPERWINDOW = 0x10
-EBF_NONE = 0
-EBF_SELECTFROMDATAOBJECT = 0x100
-EBF_NODROPTARGET = 0x200
-ECS_ENABLED = 0
-ECS_DISABLED = 0x1
-ECS_HIDDEN = 0x2
-ECS_CHECKBOX = 0x4
-ECS_CHECKED = 0x8
-
-ECF_HASSUBCOMMANDS = 0x1
-ECF_HASSPLITBUTTON = 0x2
-ECF_HIDELABEL = 0x4
-ECF_ISSEPARATOR = 0x8
-ECF_HASLUASHIELD = 0x10
-
-SIATTRIBFLAGS_AND = 0x1
-SIATTRIBFLAGS_OR = 0x2
-SIATTRIBFLAGS_APPCOMPAT = 0x3
-SIATTRIBFLAGS_MASK = 0x3
-
-SIGDN_NORMALDISPLAY = 0
-SIGDN_PARENTRELATIVEPARSING = -2147385343  ## 0x80018001
-SIGDN_DESKTOPABSOLUTEPARSING = -2147319808  ## 0x80028000
-SIGDN_PARENTRELATIVEEDITING = -2147282943  ## 0x80031001
-SIGDN_DESKTOPABSOLUTEEDITING = -2147172352  ## 0x8004c000
-SIGDN_FILESYSPATH = -2147123200  ## 0x80058000
-SIGDN_URL = -2147057664  ## 0x80068000
-SIGDN_PARENTRELATIVEFORADDRESSBAR = -2146975743  ## 0x8007c001,
-SIGDN_PARENTRELATIVE = -2146959359  ## 0x80080001
-
-SICHINT_DISPLAY = (0,)
-SICHINT_ALLFIELDS = -2147483648  ## 0x80000000
-SICHINT_CANONICAL = 0x10000000
-
-ASSOCCLASS_SHELL_KEY = 0
-ASSOCCLASS_PROGID_KEY = 1  # hkeyClass
-ASSOCCLASS_PROGID_STR = 2  # pszClass (HKCR\pszClass)
-ASSOCCLASS_CLSID_KEY = 3  # hkeyClass
-ASSOCCLASS_CLSID_STR = 4  #  pszClass (HKCR\CLSID\pszClass)
-ASSOCCLASS_APP_KEY = 5  # hkeyClass
-ASSOCCLASS_APP_STR = 6  # pszClass (HKCR\Applications\PathFindFileName(pszClass))
-ASSOCCLASS_SYSTEM_STR = 7  # pszClass
-ASSOCCLASS_FOLDER = 8  # none
-ASSOCCLASS_STAR = 9  # none
-
-NSTCS_HASEXPANDOS = 0x1
-NSTCS_HASLINES = 0x2
-NSTCS_SINGLECLICKEXPAND = 0x4
-NSTCS_FULLROWSELECT = 0x8
-NSTCS_SPRINGEXPAND = 0x10
-NSTCS_HORIZONTALSCROLL = 0x20
-NSTCS_ROOTHASEXPANDO = 0x40
-NSTCS_SHOWSELECTIONALWAYS = 0x80
-NSTCS_NOINFOTIP = 0x200
-NSTCS_EVENHEIGHT = 0x400
-NSTCS_NOREPLACEOPEN = 0x800
-NSTCS_DISABLEDRAGDROP = 0x1000
-NSTCS_NOORDERSTREAM = 0x2000
-NSTCS_RICHTOOLTIP = 0x4000
-NSTCS_BORDER = 0x8000
-NSTCS_NOEDITLABELS = 0x10000
-NSTCS_TABSTOP = 0x20000
-NSTCS_FAVORITESMODE = 0x80000
-NSTCS_AUTOHSCROLL = 0x100000
-NSTCS_FADEINOUTEXPANDOS = 0x200000
-NSTCS_EMPTYTEXT = 0x400000
-NSTCS_CHECKBOXES = 0x800000
-NSTCS_PARTIALCHECKBOXES = 0x1000000
-NSTCS_EXCLUSIONCHECKBOXES = 0x2000000
-NSTCS_DIMMEDCHECKBOXES = 0x4000000
-NSTCS_NOINDENTCHECKS = 0x8000000
-NSTCS_ALLOWJUNCTIONS = 0x10000000
-NSTCS_SHOWTABSBUTTON = 0x20000000
-NSTCS_SHOWDELETEBUTTON = 0x40000000
-NSTCS_SHOWREFRESHBUTTON = -2147483648  # 0x80000000
-
-NSTCRS_VISIBLE = 0
-NSTCRS_HIDDEN = 0x1
-NSTCRS_EXPANDED = 0x2
-NSTCIS_NONE = 0
-NSTCIS_SELECTED = 0x1
-NSTCIS_EXPANDED = 0x2
-NSTCIS_BOLD = 0x4
-NSTCIS_DISABLED = 0x8
-NSTCGNI_NEXT = 0
-NSTCGNI_NEXTVISIBLE = 0x1
-NSTCGNI_PREV = 0x2
-NSTCGNI_PREVVISIBLE = 0x3
-NSTCGNI_PARENT = 0x4
-NSTCGNI_CHILD = 0x5
-NSTCGNI_FIRSTVISIBLE = 0x6
-NSTCGNI_LASTVISIBLE = 0x7
-
-CLSID_ExplorerBrowser = "{71f96385-ddd6-48d3-a0c1-ae06e8b055fb}"
-
-# Names of the methods of many shell interfaces; used by implementation of
-# the interfaces.
-IBrowserFrame_Methods = ["GetFrameOptions"]
-ICategorizer_Methods = [
-    "GetDescription",
-    "GetCategory",
-    "GetCategoryInfo",
-    "CompareCategory",
-]
-ICategoryProvider_Methods = [
-    "CanCategorizeOnSCID",
-    "GetDefaultCategory",
-    "GetCategoryForSCID",
-    "EnumCategories",
-    "GetCategoryName",
-    "CreateCategory",
-]
-IContextMenu_Methods = ["QueryContextMenu", "InvokeCommand", "GetCommandString"]
-IExplorerCommand_Methods = [
-    "GetTitle",
-    "GetIcon",
-    "GetToolTip",
-    "GetCanonicalName",
-    "GetState",
-    "Invoke",
-    "GetFlags",
-    "EnumSubCommands",
-]
-IExplorerCommandProvider_Methods = ["GetCommand", "GetCommands"]
-IOleWindow_Methods = [
-    "GetWindow",
-    "ContextSensitiveHelp",
-]  # XXX - this should be somewhere in win32com
-IPersist_Methods = ["GetClassID"]
-IPersistFolder_Methods = IPersist_Methods + ["Initialize"]
-IPersistFolder2_Methods = IPersistFolder_Methods + ["GetCurFolder"]
-IShellExtInit_Methods = ["Initialize"]
-IShellView_Methods = IOleWindow_Methods + [
-    "TranslateAccelerator",
-    "EnableModeless",
-    "UIActivate",
-    "Refresh",
-    "CreateViewWindow",
-    "DestroyViewWindow",
-    "GetCurrentInfo",
-    "AddPropertySheetPages",
-    "SaveViewState",
-    "SelectItem",
-    "GetItemObject",
-]
-
-IShellFolder_Methods = [
-    "ParseDisplayName",
-    "EnumObjects",
-    "BindToObject",
-    "BindToStorage",
-    "CompareIDs",
-    "CreateViewObject",
-    "GetAttributesOf",
-    "GetUIObjectOf",
-    "GetDisplayNameOf",
-    "SetNameOf",
-]
-IShellFolder2_Methods = IShellFolder_Methods + [
-    "GetDefaultSearchGUID",
-    "EnumSearches",
-    "GetDefaultColumn",
-    "GetDefaultColumnState",
-    "GetDetailsEx",
-    "GetDetailsOf",
-    "MapColumnToSCID",
-]
-
-## enum GETPROPERTYSTOREFLAGS, used with IShellItem2 methods
-GPS_DEFAULT = 0
-GPS_HANDLERPROPERTIESONLY = 0x1
-GPS_READWRITE = 0x2
-GPS_TEMPORARY = 0x4
-GPS_FASTPROPERTIESONLY = 0x8
-GPS_OPENSLOWITEM = 0x10
-GPS_DELAYCREATION = 0x20
-GPS_BESTEFFORT = 0x40
-GPS_MASK_VALID = 0x7F
-
-## Bind context parameter names, used with IBindCtx::RegisterObjectParam
-STR_AVOID_DRIVE_RESTRICTION_POLICY = "Avoid Drive Restriction Policy"
-STR_BIND_DELEGATE_CREATE_OBJECT = "Delegate Object Creation"
-STR_BIND_FOLDERS_READ_ONLY = "Folders As Read Only"
-STR_BIND_FOLDER_ENUM_MODE = "Folder Enum Mode"
-STR_BIND_FORCE_FOLDER_SHORTCUT_RESOLVE = "Force Folder Shortcut Resolve"
-STR_DONT_PARSE_RELATIVE = "Don't Parse Relative"
-STR_DONT_RESOLVE_LINK = "Don't Resolve Link"
-## STR_ENUM_ITEMS_FLAGS
-STR_FILE_SYS_BIND_DATA = "File System Bind Data"
-STR_GET_ASYNC_HANDLER = "GetAsyncHandler"
-STR_GPS_BESTEFFORT = "GPS_BESTEFFORT"
-STR_GPS_DELAYCREATION = "GPS_DELAYCREATION"
-STR_GPS_FASTPROPERTIESONLY = "GPS_FASTPROPERTIESONLY"
-STR_GPS_HANDLERPROPERTIESONLY = "GPS_HANDLERPROPERTIESONLY"
-STR_GPS_NO_OPLOCK = "GPS_NO_OPLOCK"
-STR_GPS_OPENSLOWITEM = "GPS_OPENSLOWITEM"
-STR_IFILTER_FORCE_TEXT_FILTER_FALLBACK = "Always bind persistent handlers"
-STR_IFILTER_LOAD_DEFINED_FILTER = "Only bind registered persistent handlers"
-STR_INTERNAL_NAVIGATE = "Internal Navigation"
-STR_INTERNETFOLDER_PARSE_ONLY_URLMON_BINDABLE = "Validate URL"
-STR_ITEM_CACHE_CONTEXT = "ItemCacheContext"
-STR_NO_VALIDATE_FILENAME_CHARS = "NoValidateFilenameChars"
-STR_PARSE_ALLOW_INTERNET_SHELL_FOLDERS = "Allow binding to Internet shell folder handlers and negate STR_PARSE_PREFER_WEB_BROWSING"
-STR_PARSE_AND_CREATE_ITEM = "ParseAndCreateItem"
-STR_PARSE_DONT_REQUIRE_VALIDATED_URLS = "Do not require validated URLs"
-STR_PARSE_EXPLICIT_ASSOCIATION_SUCCESSFUL = "ExplicitAssociationSuccessful"
-STR_PARSE_PARTIAL_IDLIST = "ParseOriginalItem"
-STR_PARSE_PREFER_FOLDER_BROWSING = "Parse Prefer Folder Browsing"
-STR_PARSE_PREFER_WEB_BROWSING = "Do not bind to Internet shell folder handlers"
-STR_PARSE_PROPERTYSTORE = "DelegateNamedProperties"
-STR_PARSE_SHELL_PROTOCOL_TO_FILE_OBJECTS = "Parse Shell Protocol To File Objects"
-STR_PARSE_SHOW_NET_DIAGNOSTICS_UI = "Show network diagnostics UI"
-STR_PARSE_SKIP_NET_CACHE = "Skip Net Resource Cache"
-STR_PARSE_TRANSLATE_ALIASES = "Parse Translate Aliases"
-STR_PARSE_WITH_EXPLICIT_ASSOCAPP = "ExplicitAssociationApp"
-STR_PARSE_WITH_EXPLICIT_PROGID = "ExplicitProgid"
-STR_PARSE_WITH_PROPERTIES = "ParseWithProperties"
-## STR_PROPERTYBAG_PARAM
-STR_SKIP_BINDING_CLSID = "Skip Binding CLSID"
-STR_TRACK_CLSID = "Track the CLSID"
-
-## KF_REDIRECTION_CAPABILITIES enum
-KF_REDIRECTION_CAPABILITIES_ALLOW_ALL = 0x000000FF
-KF_REDIRECTION_CAPABILITIES_REDIRECTABLE = 0x00000001
-KF_REDIRECTION_CAPABILITIES_DENY_ALL = 0x000FFF00
-KF_REDIRECTION_CAPABILITIES_DENY_POLICY_REDIRECTED = 0x00000100
-KF_REDIRECTION_CAPABILITIES_DENY_POLICY = 0x00000200
-KF_REDIRECTION_CAPABILITIES_DENY_PERMISSIONS = 0x00000400
-
-## KF_REDIRECT_FLAGS enum
-KF_REDIRECT_USER_EXCLUSIVE = 0x00000001
-KF_REDIRECT_COPY_SOURCE_DACL = 0x00000002
-KF_REDIRECT_OWNER_USER = 0x00000004
-KF_REDIRECT_SET_OWNER_EXPLICIT = 0x00000008
-KF_REDIRECT_CHECK_ONLY = 0x00000010
-KF_REDIRECT_WITH_UI = 0x00000020
-KF_REDIRECT_UNPIN = 0x00000040
-KF_REDIRECT_PIN = 0x00000080
-KF_REDIRECT_COPY_CONTENTS = 0x00000200
-KF_REDIRECT_DEL_SOURCE_CONTENTS = 0x00000400
-KF_REDIRECT_EXCLUDE_ALL_KNOWN_SUBFOLDERS = 0x00000800
-
-## KF_CATEGORY enum
-KF_CATEGORY_VIRTUAL = 0x00000001
-KF_CATEGORY_FIXED = 0x00000002
-KF_CATEGORY_COMMON = 0x00000003
-KF_CATEGORY_PERUSER = 0x00000004
-
-## FFFP_MODE enum
-FFFP_EXACTMATCH = 0
-FFFP_NEARESTPARENTMATCH = 1
-
-## APPDOCLISTTYPE, used with IApplicationDocumentLists.GetList
-ADLT_RECENT = 0
-ADLT_FREQUENT = 1
-
-## KNOWNDESTCATEGORY used with ICustomDestinationList.AppendKnownCategory
-KDC_FREQUENT = 1
-KDC_RECENT = 2
-
-## LIBRARYFOLDERFILTER used with IShellLibrary.GetFolders
-LFF_FORCEFILESYSTEM = 1
-LFF_STORAGEITEMS = 2
-LFF_ALLITEMS = 3
-
-## DEFAULTSAVEFOLDERTYPE used with IShellLibrary.Get/SetDefaultSaveFolder
-DSFT_DETECT = 1
-DSFT_PRIVATE = 2
-DSFT_PUBLIC = 3
-
-## LIBRARYOPTIONFLAGS used with IShellLibrary.Get/SetOptions
-LOF_DEFAULT = 0
-LOF_PINNEDTONAVPANE = 1
-LOF_MASK_ALL = 1
-
-## LIBRARYSAVEFLAGS Used with PyIShellLibrary.Save
-LSF_FAILIFTHERE = 0
-LSF_OVERRIDEEXISTING = 1
-LSF_MAKEUNIQUENAME = 2
-
-## TRANSFER_SOURCE_FLAGS, used with IFileOperationProgressSink
-TSF_NORMAL = 0
-TSF_FAIL_EXIST = 0
-TSF_RENAME_EXIST = 0x1
-TSF_OVERWRITE_EXIST = 0x2
-TSF_ALLOW_DECRYPTION = 0x4
-TSF_NO_SECURITY = 0x8
-TSF_COPY_CREATION_TIME = 0x10
-TSF_COPY_WRITE_TIME = 0x20
-TSF_USE_FULL_ACCESS = 0x40
-TSF_DELETE_RECYCLE_IF_POSSIBLE = 0x80
-TSF_COPY_HARD_LINK = 0x100
-TSF_COPY_LOCALIZED_NAME = 0x200
-TSF_MOVE_AS_COPY_DELETE = 0x400
-TSF_SUSPEND_SHELLEVENTS = 0x800
-
-## TRANSFER_ADVISE_STATE, used with ITransferAdviseSink
-TS_NONE = 0
-TS_PERFORMING = 1
-TS_PREPARING = 2
-TS_INDETERMINATE = 4
-
-## Success HRESULTs returned by ITransfer* interface operations
-COPYENGINE_S_YES = 0x00270001
-COPYENGINE_S_NOT_HANDLED = 0x00270003
-COPYENGINE_S_USER_RETRY = 0x00270004
-COPYENGINE_S_USER_IGNORED = 0x00270005
-COPYENGINE_S_MERGE = 0x00270006
-COPYENGINE_S_DONT_PROCESS_CHILDREN = 0x00270008
-COPYENGINE_S_ALREADY_DONE = 0x0027000A
-COPYENGINE_S_PENDING = 0x0027000B
-COPYENGINE_S_KEEP_BOTH = 0x0027000C
-COPYENGINE_S_CLOSE_PROGRAM = 0x0027000D
-COPYENGINE_S_COLLISIONRESOLVED = 0x0027000E
-
-## Error HRESULTS
-COPYENGINE_E_USER_CANCELLED = 0x80270000
-COPYENGINE_E_CANCELLED = 0x80270001
-COPYENGINE_E_REQUIRES_ELEVATION = 0x80270002
-COPYENGINE_E_SAME_FILE = 0x80270003
-COPYENGINE_E_DIFF_DIR = 0x80270004
-COPYENGINE_E_MANY_SRC_1_DEST = 0x80270005
-COPYENGINE_E_DEST_SUBTREE = 0x80270009
-COPYENGINE_E_DEST_SAME_TREE = 0x8027000A
-COPYENGINE_E_FLD_IS_FILE_DEST = 0x8027000B
-COPYENGINE_E_FILE_IS_FLD_DEST = 0x8027000C
-COPYENGINE_E_FILE_TOO_LARGE = 0x8027000D
-COPYENGINE_E_REMOVABLE_FULL = 0x8027000E
-COPYENGINE_E_DEST_IS_RO_CD = 0x8027000F
-COPYENGINE_E_DEST_IS_RW_CD = 0x80270010
-COPYENGINE_E_DEST_IS_R_CD = 0x80270011
-COPYENGINE_E_DEST_IS_RO_DVD = 0x80270012
-COPYENGINE_E_DEST_IS_RW_DVD = 0x80270013
-COPYENGINE_E_DEST_IS_R_DVD = 0x80270014
-COPYENGINE_E_SRC_IS_RO_CD = 0x80270015
-COPYENGINE_E_SRC_IS_RW_CD = 0x80270016
-COPYENGINE_E_SRC_IS_R_CD = 0x80270017
-COPYENGINE_E_SRC_IS_RO_DVD = 0x80270018
-COPYENGINE_E_SRC_IS_RW_DVD = 0x80270019
-COPYENGINE_E_SRC_IS_R_DVD = 0x8027001A
-COPYENGINE_E_INVALID_FILES_SRC = 0x8027001B
-COPYENGINE_E_INVALID_FILES_DEST = 0x8027001C
-COPYENGINE_E_PATH_TOO_DEEP_SRC = 0x8027001D
-COPYENGINE_E_PATH_TOO_DEEP_DEST = 0x8027001E
-COPYENGINE_E_ROOT_DIR_SRC = 0x8027001F
-COPYENGINE_E_ROOT_DIR_DEST = 0x80270020
-COPYENGINE_E_ACCESS_DENIED_SRC = 0x80270021
-COPYENGINE_E_ACCESS_DENIED_DEST = 0x80270022
-COPYENGINE_E_PATH_NOT_FOUND_SRC = 0x80270023
-COPYENGINE_E_PATH_NOT_FOUND_DEST = 0x80270024
-COPYENGINE_E_NET_DISCONNECT_SRC = 0x80270025
-COPYENGINE_E_NET_DISCONNECT_DEST = 0x80270026
-COPYENGINE_E_SHARING_VIOLATION_SRC = 0x80270027
-COPYENGINE_E_SHARING_VIOLATION_DEST = 0x80270028
-COPYENGINE_E_ALREADY_EXISTS_NORMAL = 0x80270029
-COPYENGINE_E_ALREADY_EXISTS_READONLY = 0x8027002A
-COPYENGINE_E_ALREADY_EXISTS_SYSTEM = 0x8027002B
-COPYENGINE_E_ALREADY_EXISTS_FOLDER = 0x8027002C
-COPYENGINE_E_STREAM_LOSS = 0x8027002D
-COPYENGINE_E_EA_LOSS = 0x8027002E
-COPYENGINE_E_PROPERTY_LOSS = 0x8027002F
-COPYENGINE_E_PROPERTIES_LOSS = 0x80270030
-COPYENGINE_E_ENCRYPTION_LOSS = 0x80270031
-COPYENGINE_E_DISK_FULL = 0x80270032
-COPYENGINE_E_DISK_FULL_CLEAN = 0x80270033
-COPYENGINE_E_EA_NOT_SUPPORTED = 0x80270034
-COPYENGINE_E_CANT_REACH_SOURCE = 0x80270035
-COPYENGINE_E_RECYCLE_UNKNOWN_ERROR = 0x80270035
-COPYENGINE_E_RECYCLE_FORCE_NUKE = 0x80270036
-COPYENGINE_E_RECYCLE_SIZE_TOO_BIG = 0x80270037
-COPYENGINE_E_RECYCLE_PATH_TOO_LONG = 0x80270038
-COPYENGINE_E_RECYCLE_BIN_NOT_FOUND = 0x8027003A
-COPYENGINE_E_NEWFILE_NAME_TOO_LONG = 0x8027003B
-COPYENGINE_E_NEWFOLDER_NAME_TOO_LONG = 0x8027003C
-COPYENGINE_E_DIR_NOT_EMPTY = 0x8027003D
-COPYENGINE_E_FAT_MAX_IN_ROOT = 0x8027003E
-COPYENGINE_E_ACCESSDENIED_READONLY = 0x8027003F
-COPYENGINE_E_REDIRECTED_TO_WEBPAGE = 0x80270040
-COPYENGINE_E_SERVER_BAD_FILE_TYPE = 0x80270041
-
-FOLDERID_NetworkFolder = "{D20BEEC4-5CA8-4905-AE3B-BF251EA09B53}"
-FOLDERID_ComputerFolder = "{0AC0837C-BBF8-452A-850D-79D08E667CA7}"
-FOLDERID_InternetFolder = "{4D9F7874-4E0C-4904-967B-40B0D20C3E4B}"
-FOLDERID_ControlPanelFolder = "{82A74AEB-AEB4-465C-A014-D097EE346D63}"
-FOLDERID_PrintersFolder = "{76FC4E2D-D6AD-4519-A663-37BD56068185}"
-FOLDERID_SyncManagerFolder = "{43668BF8-C14E-49B2-97C9-747784D784B7}"
-FOLDERID_SyncSetupFolder = "{0F214138-B1D3-4a90-BBA9-27CBC0C5389A}"
-FOLDERID_ConflictFolder = "{4bfefb45-347d-4006-a5be-ac0cb0567192}"
-FOLDERID_SyncResultsFolder = "{289a9a43-be44-4057-a41b-587a76d7e7f9}"
-FOLDERID_RecycleBinFolder = "{B7534046-3ECB-4C18-BE4E-64CD4CB7D6AC}"
-FOLDERID_ConnectionsFolder = "{6F0CD92B-2E97-45D1-88FF-B0D186B8DEDD}"
-FOLDERID_Fonts = "{FD228CB7-AE11-4AE3-864C-16F3910AB8FE}"
-FOLDERID_Desktop = "{B4BFCC3A-DB2C-424C-B029-7FE99A87C641}"
-FOLDERID_Startup = "{B97D20BB-F46A-4C97-BA10-5E3608430854}"
-FOLDERID_Programs = "{A77F5D77-2E2B-44C3-A6A2-ABA601054A51}"
-FOLDERID_StartMenu = "{625B53C3-AB48-4EC1-BA1F-A1EF4146FC19}"
-FOLDERID_Recent = "{AE50C081-EBD2-438A-8655-8A092E34987A}"
-FOLDERID_SendTo = "{8983036C-27C0-404B-8F08-102D10DCFD74}"
-FOLDERID_Documents = "{FDD39AD0-238F-46AF-ADB4-6C85480369C7}"
-FOLDERID_Favorites = "{1777F761-68AD-4D8A-87BD-30B759FA33DD}"
-FOLDERID_NetHood = "{C5ABBF53-E17F-4121-8900-86626FC2C973}"
-FOLDERID_PrintHood = "{9274BD8D-CFD1-41C3-B35E-B13F55A758F4}"
-FOLDERID_Templates = "{A63293E8-664E-48DB-A079-DF759E0509F7}"
-FOLDERID_CommonStartup = "{82A5EA35-D9CD-47C5-9629-E15D2F714E6E}"
-FOLDERID_CommonPrograms = "{0139D44E-6AFE-49F2-8690-3DAFCAE6FFB8}"
-FOLDERID_CommonStartMenu = "{A4115719-D62E-491D-AA7C-E74B8BE3B067}"
-FOLDERID_PublicDesktop = "{C4AA340D-F20F-4863-AFEF-F87EF2E6BA25}"
-FOLDERID_ProgramData = "{62AB5D82-FDC1-4DC3-A9DD-070D1D495D97}"
-FOLDERID_CommonTemplates = "{B94237E7-57AC-4347-9151-B08C6C32D1F7}"
-FOLDERID_PublicDocuments = "{ED4824AF-DCE4-45A8-81E2-FC7965083634}"
-FOLDERID_RoamingAppData = "{3EB685DB-65F9-4CF6-A03A-E3EF65729F3D}"
-FOLDERID_LocalAppData = "{F1B32785-6FBA-4FCF-9D55-7B8E7F157091}"
-FOLDERID_LocalAppDataLow = "{A520A1A4-1780-4FF6-BD18-167343C5AF16}"
-FOLDERID_InternetCache = "{352481E8-33BE-4251-BA85-6007CAEDCF9D}"
-FOLDERID_Cookies = "{2B0F765D-C0E9-4171-908E-08A611B84FF6}"
-FOLDERID_History = "{D9DC8A3B-B784-432E-A781-5A1130A75963}"
-FOLDERID_System = "{1AC14E77-02E7-4E5D-B744-2EB1AE5198B7}"
-FOLDERID_SystemX86 = "{D65231B0-B2F1-4857-A4CE-A8E7C6EA7D27}"
-FOLDERID_Windows = "{F38BF404-1D43-42F2-9305-67DE0B28FC23}"
-FOLDERID_Profile = "{5E6C858F-0E22-4760-9AFE-EA3317B67173}"
-FOLDERID_Pictures = "{33E28130-4E1E-4676-835A-98395C3BC3BB}"
-FOLDERID_ProgramFilesX86 = "{7C5A40EF-A0FB-4BFC-874A-C0F2E0B9FA8E}"
-FOLDERID_ProgramFilesCommonX86 = "{DE974D24-D9C6-4D3E-BF91-F4455120B917}"
-FOLDERID_ProgramFilesX64 = "{6D809377-6AF0-444b-8957-A3773F02200E}"
-FOLDERID_ProgramFilesCommonX64 = "{6365D5A7-0F0D-45e5-87F6-0DA56B6A4F7D}"
-FOLDERID_ProgramFiles = "{905e63b6-c1bf-494e-b29c-65b732d3d21a}"
-FOLDERID_ProgramFilesCommon = "{F7F1ED05-9F6D-47A2-AAAE-29D317C6F066}"
-FOLDERID_UserProgramFiles = "{5cd7aee2-2219-4a67-b85d-6c9ce15660cb}"
-FOLDERID_UserProgramFilesCommon = "{bcbd3057-ca5c-4622-b42d-bc56db0ae516}"
-FOLDERID_AdminTools = "{724EF170-A42D-4FEF-9F26-B60E846FBA4F}"
-FOLDERID_CommonAdminTools = "{D0384E7D-BAC3-4797-8F14-CBA229B392B5}"
-FOLDERID_Music = "{4BD8D571-6D19-48D3-BE97-422220080E43}"
-FOLDERID_Videos = "{18989B1D-99B5-455B-841C-AB7C74E4DDFC}"
-FOLDERID_Ringtones = "{C870044B-F49E-4126-A9C3-B52A1FF411E8}"
-FOLDERID_PublicPictures = "{B6EBFB86-6907-413C-9AF7-4FC2ABF07CC5}"
-FOLDERID_PublicMusic = "{3214FAB5-9757-4298-BB61-92A9DEAA44FF}"
-FOLDERID_PublicVideos = "{2400183A-6185-49FB-A2D8-4A392A602BA3}"
-FOLDERID_PublicRingtones = "{E555AB60-153B-4D17-9F04-A5FE99FC15EC}"
-FOLDERID_ResourceDir = "{8AD10C31-2ADB-4296-A8F7-E4701232C972}"
-FOLDERID_LocalizedResourcesDir = "{2A00375E-224C-49DE-B8D1-440DF7EF3DDC}"
-FOLDERID_CommonOEMLinks = "{C1BAE2D0-10DF-4334-BEDD-7AA20B227A9D}"
-FOLDERID_CDBurning = "{9E52AB10-F80D-49DF-ACB8-4330F5687855}"
-FOLDERID_UserProfiles = "{0762D272-C50A-4BB0-A382-697DCD729B80}"
-FOLDERID_Playlists = "{DE92C1C7-837F-4F69-A3BB-86E631204A23}"
-FOLDERID_SamplePlaylists = "{15CA69B3-30EE-49C1-ACE1-6B5EC372AFB5}"
-FOLDERID_SampleMusic = "{B250C668-F57D-4EE1-A63C-290EE7D1AA1F}"
-FOLDERID_SamplePictures = "{C4900540-2379-4C75-844B-64E6FAF8716B}"
-FOLDERID_SampleVideos = "{859EAD94-2E85-48AD-A71A-0969CB56A6CD}"
-FOLDERID_PhotoAlbums = "{69D2CF90-FC33-4FB7-9A0C-EBB0F0FCB43C}"
-FOLDERID_Public = "{DFDF76A2-C82A-4D63-906A-5644AC457385}"
-FOLDERID_ChangeRemovePrograms = "{df7266ac-9274-4867-8d55-3bd661de872d}"
-FOLDERID_AppUpdates = "{a305ce99-f527-492b-8b1a-7e76fa98d6e4}"
-FOLDERID_AddNewPrograms = "{de61d971-5ebc-4f02-a3a9-6c82895e5c04}"
-FOLDERID_Downloads = "{374DE290-123F-4565-9164-39C4925E467B}"
-FOLDERID_PublicDownloads = "{3D644C9B-1FB8-4f30-9B45-F670235F79C0}"
-FOLDERID_SavedSearches = "{7d1d3a04-debb-4115-95cf-2f29da2920da}"
-FOLDERID_QuickLaunch = "{52a4f021-7b75-48a9-9f6b-4b87a210bc8f}"
-FOLDERID_Contacts = "{56784854-C6CB-462b-8169-88E350ACB882}"
-FOLDERID_SidebarParts = "{A75D362E-50FC-4fb7-AC2C-A8BEAA314493}"
-FOLDERID_SidebarDefaultParts = "{7B396E54-9EC5-4300-BE0A-2482EBAE1A26}"
-FOLDERID_PublicGameTasks = "{DEBF2536-E1A8-4c59-B6A2-414586476AEA}"
-FOLDERID_GameTasks = "{054FAE61-4DD8-4787-80B6-090220C4B700}"
-FOLDERID_SavedGames = "{4C5C32FF-BB9D-43b0-B5B4-2D72E54EAAA4}"
-FOLDERID_Games = "{CAC52C1A-B53D-4edc-92D7-6B2E8AC19434}"
-FOLDERID_SEARCH_MAPI = "{98ec0e18-2098-4d44-8644-66979315a281}"
-FOLDERID_SEARCH_CSC = "{ee32e446-31ca-4aba-814f-a5ebd2fd6d5e}"
-FOLDERID_Links = "{bfb9d5e0-c6a9-404c-b2b2-ae6db6af4968}"
-FOLDERID_UsersFiles = "{f3ce0f7c-4901-4acc-8648-d5d44b04ef8f}"
-FOLDERID_UsersLibraries = "{A302545D-DEFF-464b-ABE8-61C8648D939B}"
-FOLDERID_SearchHome = "{190337d1-b8ca-4121-a639-6d472d16972a}"
-FOLDERID_OriginalImages = "{2C36C0AA-5812-4b87-BFD0-4CD0DFB19B39}"
-FOLDERID_DocumentsLibrary = "{7b0db17d-9cd2-4a93-9733-46cc89022e7c}"
-FOLDERID_MusicLibrary = "{2112AB0A-C86A-4ffe-A368-0DE96E47012E}"
-FOLDERID_PicturesLibrary = "{A990AE9F-A03B-4e80-94BC-9912D7504104}"
-FOLDERID_VideosLibrary = "{491E922F-5643-4af4-A7EB-4E7A138D8174}"
-FOLDERID_RecordedTVLibrary = "{1A6FDBA2-F42D-4358-A798-B74D745926C5}"
-FOLDERID_HomeGroup = "{52528A6B-B9E3-4add-B60D-588C2DBA842D}"
-FOLDERID_HomeGroupCurrentUser = "{9B74B6A3-0DFD-4f11-9E78-5F7800F2E772}"
-FOLDERID_DeviceMetadataStore = "{5CE4A5E9-E4EB-479D-B89F-130C02886155}"
-FOLDERID_Libraries = "{1B3EA5DC-B587-4786-B4EF-BD1DC332AEAE}"
-FOLDERID_PublicLibraries = "{48daf80b-e6cf-4f4e-b800-0e69d84ee384}"
-FOLDERID_UserPinned = "{9e3995ab-1f9c-4f13-b827-48b24b6c7174}"
-FOLDERID_ImplicitAppShortcuts = "{bcb5256f-79f6-4cee-b725-dc34e402fd46}"
-FOLDERID_AccountPictures = "{008ca0b1-55b4-4c56-b8a8-4de4b299d3be}"
-FOLDERID_PublicUserTiles = "{0482af6c-08f1-4c34-8c90-e17ec98b1e17}"
-FOLDERID_AppsFolder = "{1e87508d-89c2-42f0-8a7e-645a0f50ca58}"
-FOLDERID_StartMenuAllPrograms = "{F26305EF-6948-40B9-B255-81453D09C785}"
-FOLDERID_CommonStartMenuPlaces = "{A440879F-87A0-4F7D-B700-0207B966194A}"
-FOLDERID_ApplicationShortcuts = "{A3918781-E5F2-4890-B3D9-A7E54332328C}"
-FOLDERID_RoamingTiles = "{00BCFC5A-ED94-4e48-96A1-3F6217F21990}"
-FOLDERID_RoamedTileImages = "{AAA8D5A5-F1D6-4259-BAA8-78E7EF60835E}"
-FOLDERID_Screenshots = "{b7bede81-df94-4682-a7d8-57a52620b86f}"
-FOLDERID_CameraRoll = "{AB5FB87B-7CE2-4F83-915D-550846C9537B}"
-FOLDERID_SkyDrive = "{A52BBA46-E9E1-435f-B3D9-28DAA648C0F6}"
-FOLDERID_OneDrive = "{A52BBA46-E9E1-435f-B3D9-28DAA648C0F6}"
-FOLDERID_SkyDriveDocuments = "{24D89E24-2F19-4534-9DDE-6A6671FBB8FE}"
-FOLDERID_SkyDrivePictures = "{339719B5-8C47-4894-94C2-D8F77ADD44A6}"
-FOLDERID_SkyDriveMusic = "{C3F2459E-80D6-45DC-BFEF-1F769F2BE730}"
-FOLDERID_SkyDriveCameraRoll = "{767E6811-49CB-4273-87C2-20F355E1085B}"
-FOLDERID_SearchHistory = "{0D4C3DB6-03A3-462F-A0E6-08924C41B5D4}"
-FOLDERID_SearchTemplates = "{7E636BFE-DFA9-4D5E-B456-D7B39851D8A9}"
-FOLDERID_CameraRollLibrary = "{2B20DF75-1EDA-4039-8097-38798227D5B7}"
-FOLDERID_SavedPictures = "{3B193882-D3AD-4eab-965A-69829D1FB59F}"
-FOLDERID_SavedPicturesLibrary = "{E25B5812-BE88-4bd9-94B0-29233477B6C3}"
-FOLDERID_RetailDemo = "{12D4C69E-24AD-4923-BE19-31321C43A767}"
-FOLDERID_Device = "{1C2AC1DC-4358-4B6C-9733-AF21156576F0}"
-FOLDERID_DevelopmentFiles = "{DBE8E08E-3053-4BBC-B183-2A7B2B191E59}"
-FOLDERID_Objects3D = "{31C0DD25-9439-4F12-BF41-7FF4EDA38722}"
-FOLDERID_AppCaptures = "{EDC0FE71-98D8-4F4A-B920-C8DC133CB165}"
-FOLDERID_LocalDocuments = "{f42ee2d3-909f-4907-8871-4c22fc0bf756}"
-FOLDERID_LocalPictures = "{0ddd015d-b06c-45d5-8c4c-f59713854639 }"
-FOLDERID_LocalVideos = "{35286a68-3c57-41a1-bbb1-0eae73d76c95}"
-FOLDERID_LocalMusic = "{a0c69a99-21c8-4671-8703-7934162fcf1d}"
-FOLDERID_LocalDownloads = "{7d83ee9b-2244-4e70-b1f5-5393042af1e4}"
-FOLDERID_RecordedCalls = "{2f8b40c2-83ed-48ee-b383-a1f157ec6f9a}"
-
-KF_FLAG_DEFAULT = 0x00000000
-KF_FLAG_FORCE_APP_DATA_REDIRECTION = 0x00080000
-KF_FLAG_RETURN_FILTER_REDIRECTION_TARGET = 0x00040000
-KF_FLAG_FORCE_PACKAGE_REDIRECTION = 0x00020000
-KF_FLAG_NO_PACKAGE_REDIRECTION = 0x00010000
-KF_FLAG_FORCE_APPCONTAINER_REDIRECTION = 0x00020000
-KF_FLAG_NO_APPCONTAINER_REDIRECTION = 0x00010000
-KF_FLAG_CREATE = 0x00008000
-KF_FLAG_DONT_VERIFY = 0x00004000
-KF_FLAG_DONT_UNEXPAND = 0x00002000
-KF_FLAG_NO_ALIAS = 0x00001000
-KF_FLAG_INIT = 0x00000800
-KF_FLAG_DEFAULT_PATH = 0x00000400
-KF_FLAG_NOT_PARENT_RELATIVE = 0x00000200
-KF_FLAG_SIMPLE_IDLIST = 0x00000100
-KF_FLAG_ALIAS_ONLY = 0x80000000
diff --git a/lib/win32comext/shell/test/testSHFileOperation.py b/lib/win32comext/shell/test/testSHFileOperation.py
deleted file mode 100644
index 8a896882..00000000
--- a/lib/win32comext/shell/test/testSHFileOperation.py
+++ /dev/null
@@ -1,75 +0,0 @@
-import os
-
-import win32api
-from win32com.shell import shell, shellcon
-
-
-def testSHFileOperation(file_cnt):
-    temp_dir = os.environ["temp"]
-    orig_fnames = [
-        win32api.GetTempFileName(temp_dir, "sfo")[0] for x in range(file_cnt)
-    ]
-    new_fnames = [
-        os.path.join(temp_dir, "copy of " + os.path.split(orig_fnames[x])[1])
-        for x in range(file_cnt)
-    ]
-
-    pFrom = "\0".join(orig_fnames)
-    pTo = "\0".join(new_fnames)
-
-    shell.SHFileOperation(
-        (
-            0,
-            shellcon.FO_MOVE,
-            pFrom,
-            pTo,
-            shellcon.FOF_MULTIDESTFILES | shellcon.FOF_NOCONFIRMATION,
-        )
-    )
-    for fname in orig_fnames:
-        assert not os.path.isfile(fname)
-
-    for fname in new_fnames:
-        assert os.path.isfile(fname)
-        shell.SHFileOperation(
-            (
-                0,
-                shellcon.FO_DELETE,
-                fname,
-                None,
-                shellcon.FOF_NOCONFIRMATION | shellcon.FOF_NOERRORUI,
-            )
-        )
-
-
-def testSHNAMEMAPPINGS(file_cnt):
-    ## attemps to move a set of files to names that already exist, and generated filenames should be returned
-    ##   as a sequence of 2-tuples created from SHNAMEMAPPINGS handle
-    temp_dir = os.environ["temp"]
-    orig_fnames = [
-        win32api.GetTempFileName(temp_dir, "sfo")[0] for x in range(file_cnt)
-    ]
-    new_fnames = [win32api.GetTempFileName(temp_dir, "sfo")[0] for x in range(file_cnt)]
-    pFrom = "\0".join(orig_fnames)
-    pTo = "\0".join(new_fnames)
-    rc, banyaborted, NameMappings = shell.SHFileOperation(
-        (
-            0,
-            shellcon.FO_MOVE,
-            pFrom,
-            pTo,
-            shellcon.FOF_MULTIDESTFILES
-            | shellcon.FOF_NOCONFIRMATION
-            | shellcon.FOF_RENAMEONCOLLISION
-            | shellcon.FOF_WANTMAPPINGHANDLE,
-        )
-    )
-
-    for old_fname, new_fname in NameMappings:
-        print("Old:", old_fname, "New:", new_fname)
-    assert len(NameMappings) == file_cnt
-
-
-testSHFileOperation(10)
-testSHFileOperation(1)
-testSHNAMEMAPPINGS(5)
diff --git a/lib/win32comext/shell/test/testShellFolder.py b/lib/win32comext/shell/test/testShellFolder.py
deleted file mode 100644
index 0517af58..00000000
--- a/lib/win32comext/shell/test/testShellFolder.py
+++ /dev/null
@@ -1,21 +0,0 @@
-from win32com.shell import shell
-from win32com.shell.shellcon import *
-
-sf = shell.SHGetDesktopFolder()
-print("Shell Folder is", sf)
-
-names = []
-for i in sf:  # Magically calls EnumObjects
-    name = sf.GetDisplayNameOf(i, SHGDN_NORMAL)
-    names.append(name)
-
-# And get the enumerator manually
-enum = sf.EnumObjects(0, SHCONTF_FOLDERS | SHCONTF_NONFOLDERS | SHCONTF_INCLUDEHIDDEN)
-num = 0
-for i in enum:
-    num += 1
-if num != len(names):
-    print("Should have got the same number of names!?")
-print("Found", len(names), "items on the desktop")
-for name in names:
-    print(name)
diff --git a/lib/win32comext/shell/test/testShellItem.py b/lib/win32comext/shell/test/testShellItem.py
deleted file mode 100644
index 592a3647..00000000
--- a/lib/win32comext/shell/test/testShellItem.py
+++ /dev/null
@@ -1,69 +0,0 @@
-# Test IShellItem and related interfaces
-import unittest
-
-from win32com.shell import knownfolders, shell, shellcon
-
-
-class TestShellItem(unittest.TestCase):
-    def assertShellItemsEqual(self, i1, i2):
-        n1 = i1.GetDisplayName(shellcon.SHGDN_FORPARSING)
-        n2 = i2.GetDisplayName(shellcon.SHGDN_FORPARSING)
-        self.assertEqual(n1, n2)
-
-    def test_idlist_roundtrip(self):
-        pidl = shell.SHGetSpecialFolderLocation(0, shellcon.CSIDL_DESKTOP)
-        item = shell.SHCreateItemFromIDList(pidl, shell.IID_IShellItem)
-        pidl_back = shell.SHGetIDListFromObject(item)
-        self.assertEqual(pidl, pidl_back)
-
-    def test_parsing_name(self):
-        sf = shell.SHGetDesktopFolder()
-        flags = shellcon.SHCONTF_FOLDERS | shellcon.SHCONTF_NONFOLDERS
-        children = sf.EnumObjects(0, flags)
-        child_pidl = next(children)
-        name = sf.GetDisplayNameOf(child_pidl, shellcon.SHGDN_FORPARSING)
-
-        item = shell.SHCreateItemFromParsingName(name, None, shell.IID_IShellItem)
-        # test the name we get from the item is the same as from the folder.
-        self.assertEqual(name, item.GetDisplayName(shellcon.SHGDN_FORPARSING))
-
-    def test_parsing_relative(self):
-        desktop_pidl = shell.SHGetSpecialFolderLocation(0, shellcon.CSIDL_DESKTOP)
-        desktop_item = shell.SHCreateItemFromIDList(desktop_pidl, shell.IID_IShellItem)
-
-        sf = shell.SHGetDesktopFolder()
-        flags = shellcon.SHCONTF_FOLDERS | shellcon.SHCONTF_NONFOLDERS
-        children = sf.EnumObjects(0, flags)
-        child_pidl = next(children)
-        name_flags = shellcon.SHGDN_FORPARSING | shellcon.SHGDN_INFOLDER
-        name = sf.GetDisplayNameOf(child_pidl, name_flags)
-
-        item = shell.SHCreateItemFromRelativeName(
-            desktop_item, name, None, shell.IID_IShellItem
-        )
-        # test the name we get from the item is the same as from the folder.
-        self.assertEqual(name, item.GetDisplayName(name_flags))
-
-    def test_create_in_known_folder(self):
-        item = shell.SHCreateItemInKnownFolder(
-            knownfolders.FOLDERID_Desktop, 0, None, shell.IID_IShellItem
-        )
-        # this will do for now :)
-
-    def test_create_item_with_parent(self):
-        desktop_pidl = shell.SHGetSpecialFolderLocation(0, shellcon.CSIDL_DESKTOP)
-        desktop_item = shell.SHCreateItemFromIDList(desktop_pidl, shell.IID_IShellItem)
-
-        sf = shell.SHGetDesktopFolder()
-        flags = shellcon.SHCONTF_FOLDERS | shellcon.SHCONTF_NONFOLDERS
-        children = sf.EnumObjects(0, flags)
-        child_pidl = next(children)
-        item1 = shell.SHCreateItemWithParent(
-            desktop_pidl, None, child_pidl, shell.IID_IShellItem
-        )
-        item2 = shell.SHCreateItemWithParent(None, sf, child_pidl, shell.IID_IShellItem)
-        self.assertShellItemsEqual(item1, item2)
-
-
-if __name__ == "__main__":
-    unittest.main()
diff --git a/lib/win32comext/taskscheduler/__init__.py b/lib/win32comext/taskscheduler/__init__.py
deleted file mode 100644
index 3a893267..00000000
--- a/lib/win32comext/taskscheduler/__init__.py
+++ /dev/null
@@ -1,6 +0,0 @@
-# This is a python package
-# __PackageSupportBuildPath__ not needed for distutil based builds,
-# but not everyone is there yet.
-import win32com
-
-win32com.__PackageSupportBuildPath__(__path__)
diff --git a/lib/win32comext/taskscheduler/taskscheduler.pyd b/lib/win32comext/taskscheduler/taskscheduler.pyd
deleted file mode 100644
index 0896d0119bc04ad09dd12c38e1a01bd11987a36d..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 53248
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

diff --git a/lib/win32comext/taskscheduler/test/test_addtask.py b/lib/win32comext/taskscheduler/test/test_addtask.py
deleted file mode 100644
index a7b0959d..00000000
--- a/lib/win32comext/taskscheduler/test/test_addtask.py
+++ /dev/null
@@ -1,66 +0,0 @@
-import os
-import sys
-import time
-
-import pythoncom
-import win32api
-from win32com.taskscheduler import taskscheduler
-
-task_name = "test_addtask.job"
-ts = pythoncom.CoCreateInstance(
-    taskscheduler.CLSID_CTaskScheduler,
-    None,
-    pythoncom.CLSCTX_INPROC_SERVER,
-    taskscheduler.IID_ITaskScheduler,
-)
-tasks = ts.Enum()
-for task in tasks:
-    print(task)
-if task_name in tasks:
-    print("Deleting existing task " + task_name)
-    ts.Delete(task_name)
-
-t = ts.NewWorkItem(task_name)
-t.SetComment("rude comments")
-t.SetApplicationName(sys.executable)
-t.SetPriority(taskscheduler.REALTIME_PRIORITY_CLASS)
-t.SetParameters(
-    "-c\"import win32ui,time;win32ui.MessageBox('hey bubba I am running');\""
-)
-t.SetWorkingDirectory(os.path.dirname(sys.executable))
-t.SetCreator("test_addtask.py")
-t.SetMaxRunTime(20000)  # milliseconds
-t.SetFlags(
-    taskscheduler.TASK_FLAG_INTERACTIVE | taskscheduler.TASK_FLAG_RUN_ONLY_IF_LOGGED_ON
-)
-##               |taskscheduler.TASK_FLAG_DELETE_WHEN_DONE)  #task self destructs when no more future run times
-t.SetAccountInformation(win32api.GetUserName(), None)
-## None is only valid for local system acct or if task flags contain TASK_FLAG_RUN_ONLY_IF_LOGGED_ON
-t.SetWorkItemData("some binary garbage")
-
-run_time = time.localtime(time.time() + 60)
-tr_ind, tr = t.CreateTrigger()
-tt = tr.GetTrigger()
-
-## flags default to TASK_TRIGGER_FLAG_DISABLED (4)
-tt.Flags = taskscheduler.TASK_TRIGGER_FLAG_KILL_AT_DURATION_END
-tt.BeginYear = int(time.strftime("%Y", run_time))
-tt.BeginMonth = int(time.strftime("%m", run_time))
-tt.BeginDay = int(time.strftime("%d", run_time))
-tt.StartMinute = int(time.strftime("%M", run_time))
-tt.StartHour = int(time.strftime("%H", run_time))
-tt.MinutesInterval = 1
-tt.MinutesDuration = 5
-
-tt.TriggerType = taskscheduler.TASK_TIME_TRIGGER_MONTHLYDATE
-# months can contain multiples in a bitmask, use 1<<(month_nbr-1)
-tt.MonthlyDate_Months = 1 << (
-    int(time.strftime("%m", run_time)) - 1
-)  ## corresponds to TASK_JANUARY..TASK_DECEMBER constants
-# days too
-tt.MonthlyDate_Days = 1 << (int(time.strftime("%d", run_time)) - 1)
-tr.SetTrigger(tt)
-print(t.GetTriggerString(tr_ind))
-
-pf = t.QueryInterface(pythoncom.IID_IPersistFile)
-pf.Save(None, 1)
diff --git a/lib/win32comext/taskscheduler/test/test_addtask_1.py b/lib/win32comext/taskscheduler/test/test_addtask_1.py
deleted file mode 100644
index 29c9e08d..00000000
--- a/lib/win32comext/taskscheduler/test/test_addtask_1.py
+++ /dev/null
@@ -1,69 +0,0 @@
-import time
-
-import pythoncom
-import win32api
-from win32com.taskscheduler import taskscheduler
-
-test_task_name = "test_addtask_1.job"
-
-ts = pythoncom.CoCreateInstance(
-    taskscheduler.CLSID_CTaskScheduler,
-    None,
-    pythoncom.CLSCTX_INPROC_SERVER,
-    taskscheduler.IID_ITaskScheduler,
-)
-
-tasks = ts.Enum()
-for task in tasks:
-    print(task)
-if test_task_name in tasks:
-    print("Deleting existing task " + test_task_name)
-    ts.Delete(test_task_name)
-
-new_task = pythoncom.CoCreateInstance(
-    taskscheduler.CLSID_CTask,
-    None,
-    pythoncom.CLSCTX_INPROC_SERVER,
-    taskscheduler.IID_ITask,
-)
-ts.AddWorkItem(test_task_name, new_task)  ## task object is modified in place
-
-new_task.SetFlags(
-    taskscheduler.TASK_FLAG_INTERACTIVE | taskscheduler.TASK_FLAG_RUN_ONLY_IF_LOGGED_ON
-)
-new_task.SetIdleWait(1, 10000)
-new_task.SetComment("test task with idle trigger")
-new_task.SetApplicationName("c:\\python23\\python.exe")
-new_task.SetPriority(taskscheduler.REALTIME_PRIORITY_CLASS)
-new_task.SetParameters(
-    "-c\"import win32ui,time;win32ui.MessageBox('why aint you doing no work ?');\""
-)
-new_task.SetWorkingDirectory("c:\\python23")
-new_task.SetCreator("test_addtask_1.py")
-new_task.SetAccountInformation(win32api.GetUserName(), None)
-## None is only valid for local system acct or if Flags contain TASK_FLAG_RUN_ONLY_IF_LOGGED_ON
-
-
-run_time = time.localtime(time.time() + 30)
-end_time = time.localtime(time.time() + 60 * 60 * 24)
-
-tr_ind, tr = new_task.CreateTrigger()
-tt = tr.GetTrigger()
-tt.TriggerType = taskscheduler.TASK_EVENT_TRIGGER_ON_IDLE
-tt.Flags = taskscheduler.TASK_TRIGGER_FLAG_HAS_END_DATE
-
-tt.BeginYear = int(time.strftime("%Y", run_time))
-tt.BeginMonth = int(time.strftime("%m", run_time))
-tt.BeginDay = int(time.strftime("%d", run_time))
-tt.StartMinute = int(time.strftime("%M", run_time))
-tt.StartHour = int(time.strftime("%H", run_time))
-
-tt.EndYear = int(time.strftime("%Y", end_time))
-tt.EndMonth = int(time.strftime("%m", end_time))
-tt.EndDay = int(time.strftime("%d", end_time))
-
-tr.SetTrigger(tt)
-print(new_task.GetTriggerString(tr_ind))
-
-pf = new_task.QueryInterface(pythoncom.IID_IPersistFile)
-pf.Save(None, 1)
diff --git a/lib/win32comext/taskscheduler/test/test_addtask_2.py b/lib/win32comext/taskscheduler/test/test_addtask_2.py
deleted file mode 100644
index 4663bea4..00000000
--- a/lib/win32comext/taskscheduler/test/test_addtask_2.py
+++ /dev/null
@@ -1,51 +0,0 @@
-import time
-
-import pythoncom
-import win32api
-from win32com.taskscheduler import taskscheduler
-
-task_name = "test_addtask_2.job"
-ts = pythoncom.CoCreateInstance(
-    taskscheduler.CLSID_CTaskScheduler,
-    None,
-    pythoncom.CLSCTX_INPROC_SERVER,
-    taskscheduler.IID_ITaskScheduler,
-)
-tasks = ts.Enum()
-for task in tasks:
-    print(task)
-if task_name in tasks:
-    print("Deleting existing task " + task_name)
-    ts.Delete(task_name)
-
-t = ts.NewWorkItem(task_name)
-t.SetComment("Test a task running as local system acct")
-t.SetApplicationName("c:\\python23\\python.exe")
-t.SetPriority(taskscheduler.REALTIME_PRIORITY_CLASS)
-t.SetParameters("test_localsystem.py")
-t.SetWorkingDirectory("c:\\python23")
-t.SetCreator("test_addtask_2.py")
-t.SetMaxRunTime(20000)  # milliseconds
-t.SetFlags(taskscheduler.TASK_FLAG_DELETE_WHEN_DONE)
-t.SetAccountInformation(
-    "", None
-)  ## empty string for account name means to use local system
-## None is only valid for local system acct or if task flags contain TASK_FLAG_RUN_ONLY_IF_LOGGED_ON
-
-run_time = time.localtime(time.time() + 60)
-tr_ind, tr = t.CreateTrigger()
-
-tt = tr.GetTrigger()
-tt.Flags = 0  ## flags for a new trigger default to TASK_TRIGGER_FLAG_DISABLED (4), make sure to clear them if not using any
-tt.TriggerType = taskscheduler.TASK_TIME_TRIGGER_ONCE
-tt.BeginYear = int(time.strftime("%Y", run_time))
-tt.BeginMonth = int(time.strftime("%m", run_time))
-tt.BeginDay = int(time.strftime("%d", run_time))
-tt.StartMinute = int(time.strftime("%M", run_time))
-tt.StartHour = int(time.strftime("%H", run_time))
-
-tr.SetTrigger(tt)
-print(t.GetTriggerString(tr_ind))
-
-pf = t.QueryInterface(pythoncom.IID_IPersistFile)
-pf.Save(None, 1)
diff --git a/lib/win32comext/taskscheduler/test/test_localsystem.py b/lib/win32comext/taskscheduler/test/test_localsystem.py
deleted file mode 100644
index 9209d3af..00000000
--- a/lib/win32comext/taskscheduler/test/test_localsystem.py
+++ /dev/null
@@ -1,3 +0,0 @@
-f = open("test_localsystem.txt", "w")
-f.write("I have run\n")
-f.close()
diff --git a/lib/zc/lockfile/__init__.py b/lib/zc/lockfile/__init__.py
index f93917b0..b541fa2d 100644
--- a/lib/zc/lockfile/__init__.py
+++ b/lib/zc/lockfile/__init__.py
@@ -11,18 +11,18 @@
 # FOR A PARTICULAR PURPOSE
 #
 ##############################################################################
-import logging
+
 import os
-
-
+import errno
+import logging
 logger = logging.getLogger("zc.lockfile")
 
+__metaclass__ = type
 
 class LockError(Exception):
     """Couldn't get a lock
     """
 
-
 try:
     import fcntl
 except ImportError:
@@ -31,7 +31,6 @@ except ImportError:
     except ImportError:
         def _lock_file(file):
             raise TypeError('No file-locking support on this platform')
-
         def _unlock_file(file):
             raise TypeError('No file-locking support on this platform')
 
@@ -41,14 +40,14 @@ except ImportError:
             # Lock just the first byte
             try:
                 msvcrt.locking(file.fileno(), msvcrt.LK_NBLCK, 1)
-            except OSError:
+            except IOError:
                 raise LockError("Couldn't lock %r" % file.name)
 
         def _unlock_file(file):
             try:
                 file.seek(0)
                 msvcrt.locking(file.fileno(), msvcrt.LK_UNLCK, 1)
-            except OSError:
+            except IOError:
                 raise LockError("Couldn't unlock %r" % file.name)
 
 else:
@@ -58,16 +57,14 @@ else:
     def _lock_file(file):
         try:
             fcntl.flock(file.fileno(), _flags)
-        except OSError:
+        except IOError:
             raise LockError("Couldn't lock %r" % file.name)
 
     def _unlock_file(file):
         fcntl.flock(file.fileno(), fcntl.LOCK_UN)
 
-
 class LazyHostName:
     """Avoid importing socket and calling gethostname() unnecessarily"""
-
     def __str__(self):
         import socket
         return socket.gethostname()
@@ -82,7 +79,7 @@ class SimpleLockFile:
         try:
             # Try to open for writing without truncation:
             fp = open(path, 'r+')
-        except OSError:
+        except IOError:
             # If the file doesn't exist, we'll get an IO error, try a+
             # Note that there may be a race here. Multiple processes
             # could fail on the r+ open and open the file a+, but only
@@ -92,7 +89,7 @@ class SimpleLockFile:
         try:
             _lock_file(fp)
             self._fp = fp
-        except BaseException:
+        except:
             fp.close()
             raise
 
@@ -117,7 +114,7 @@ class LockFile(SimpleLockFile):
 
     def __init__(self, path, content_template='{pid}'):
         self._content_template = content_template
-        super().__init__(path)
+        super(LockFile, self).__init__(path)
 
     def _on_lock(self):
         content = self._content_template.format(
diff --git a/lib/zc/lockfile/tests.py b/lib/zc/lockfile/tests.py
index ae9ffca5..4c890539 100644
--- a/lib/zc/lockfile/tests.py
+++ b/lib/zc/lockfile/tests.py
@@ -11,22 +11,23 @@
 # FOR A PARTICULAR PURPOSE.
 #
 ##############################################################################
-import doctest
-import os
+import os, re, sys, unittest, doctest
+import zc.lockfile, time, threading
+from zope.testing import renormalizing, setupstack
 import tempfile
-import threading
-import time
-import unittest
-from unittest.mock import Mock
-from unittest.mock import patch
-
-from zope.testing import setupstack
-
-import zc.lockfile
+try:
+    from unittest.mock import Mock, patch
+except ImportError:
+    from mock import Mock, patch
 
+checker = renormalizing.RENormalizing([
+    # Python 3 adds module path to error class name.
+    (re.compile("zc\.lockfile\.LockError:"),
+     r"LockError:"),
+    ])
 
 def inc():
-    while True:
+    while 1:
         try:
             lock = zc.lockfile.LockFile('f.lock')
         except zc.lockfile.LockError:
@@ -42,7 +43,6 @@ def inc():
     f.close()
     lock.close()
 
-
 def many_threads_read_and_write():
     r"""
     >>> with open('f', 'w+b') as file:
@@ -72,7 +72,6 @@ def many_threads_read_and_write():
 
     """
 
-
 def pid_in_lockfile():
     r"""
     >>> import os, zc.lockfile
@@ -89,7 +88,7 @@ def pid_in_lockfile():
     >>> lock = zc.lockfile.LockFile("f.lock")
     Traceback (most recent call last):
       ...
-    zc.lockfile.LockError: Couldn't lock 'f.lock'
+    LockError: Couldn't lock 'f.lock'
 
     >>> f = open("f.lock")
     >>> _ = f.seek(1)
@@ -108,8 +107,7 @@ def hostname_in_lockfile():
 
     >>> import zc.lockfile
     >>> with patch('socket.gethostname', Mock(return_value='myhostname')):
-    ...     lock = zc.lockfile.LockFile(
-    ...         "f.lock", content_template='{hostname}')
+    ...     lock = zc.lockfile.LockFile("f.lock", content_template='{hostname}')
     >>> f = open("f.lock")
     >>> _ = f.seek(1)
     >>> f.read().rstrip()
@@ -121,7 +119,7 @@ def hostname_in_lockfile():
     >>> lock = zc.lockfile.LockFile("f.lock", content_template='{hostname}')
     Traceback (most recent call last):
       ...
-    zc.lockfile.LockError: Couldn't lock 'f.lock'
+    LockError: Couldn't lock 'f.lock'
 
     >>> f = open("f.lock")
     >>> _ = f.seek(1)
@@ -133,7 +131,7 @@ def hostname_in_lockfile():
     """
 
 
-class TestLogger:
+class TestLogger(object):
     def __init__(self):
         self.log_entries = []
 
@@ -143,7 +141,6 @@ class TestLogger:
 
 class LockFileLogEntryTestCase(unittest.TestCase):
     """Tests for logging in case of lock failure"""
-
     def setUp(self):
         self.here = os.getcwd()
         self.tmp = tempfile.mkdtemp(prefix='zc.lockfile-test-')
@@ -157,8 +154,8 @@ class LockFileLogEntryTestCase(unittest.TestCase):
         # PID and hostname are parsed and logged from lock file on failure
         with patch('os.getpid', Mock(return_value=123)):
             with patch('socket.gethostname', Mock(return_value='myhostname')):
-                lock = zc.lockfile.LockFile(
-                    'f.lock', content_template='{pid}/{hostname}')
+                lock = zc.lockfile.LockFile('f.lock',
+                                            content_template='{pid}/{hostname}')
                 with open('f.lock') as f:
                     self.assertEqual(' 123/myhostname\n', f.read())
 
@@ -194,10 +191,11 @@ class LockFileLogEntryTestCase(unittest.TestCase):
 def test_suite():
     suite = unittest.TestSuite()
     suite.addTest(doctest.DocFileSuite(
-        'README.txt',
+        'README.txt', checker=checker,
         setUp=setupstack.setUpDirectory, tearDown=setupstack.tearDown))
     suite.addTest(doctest.DocTestSuite(
-        setUp=setupstack.setUpDirectory, tearDown=setupstack.tearDown))
+        setUp=setupstack.setUpDirectory, tearDown=setupstack.tearDown,
+        checker=checker))
     # Add unittest test cases from this module
     suite.addTest(unittest.defaultTestLoader.loadTestsFromName(__name__))
     return suite
diff --git a/requirements.txt b/requirements.txt
index ca332f91..dea2b2a3 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -7,8 +7,8 @@ beautifulsoup4==4.12.3
 bleach==6.1.0
 certifi==2024.2.2
 cheroot==10.0.0
-cherrypy==18.9.0
 cloudinary==1.39.1
+cherrypy==18.8.0
 distro==1.9.0
 dnspython==2.6.1
 facebook-sdk==3.1.0

From 51196a7fb1b709ca81e56e7e3534d7c8f0914a90 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 24 Mar 2024 17:55:12 -0700
Subject: [PATCH 555/743] Update cherrypy==18.9.0

---
 lib/annotated_types/__init__.py               |  396 ++
 .../__init__.py => annotated_types/py.typed}  |    0
 lib/annotated_types/test_cases.py             |  147 +
 lib/autocommand/autoasync.py                  |    8 +-
 lib/cherrypy/_cplogging.py                    |    6 +-
 lib/cherrypy/lib/cptools.py                   |   12 +-
 lib/cherrypy/lib/profiler.py                  |    4 +-
 lib/cherrypy/lib/reprconf.py                  |    2 +-
 lib/cherrypy/lib/static.py                    |   12 +-
 lib/cherrypy/process/wspbus.py                |    2 +-
 lib/cherrypy/test/test_http.py                |   15 +
 lib/cherrypy/test/test_iterator.py            |    2 +
 lib/cherrypy/test/test_logging.py             |   28 +
 lib/inflect/__init__.py                       |  180 +-
 lib/inflect/compat/__init__.py                |    0
 lib/inflect/compat/pydantic.py                |   19 +
 lib/inflect/compat/pydantic1.py               |    8 +
 .../__init__.py}                              |  152 +-
 lib/jaraco/collections/py.typed               |    0
 lib/jaraco/context.py                         |   75 +
 .../{functools.py => functools/__init__.py}   |  155 +-
 lib/jaraco/functools/__init__.pyi             |  128 +
 lib/jaraco/functools/py.typed                 |    0
 lib/jaraco/text/__init__.py                   |   18 +-
 lib/jaraco/text/show-newlines.py              |    4 +-
 lib/jaraco/text/strip-prefix.py               |   21 +
 lib/more_itertools/__init__.py                |    2 +-
 lib/more_itertools/more.py                    |  143 +-
 lib/more_itertools/more.pyi                   |   23 +-
 lib/more_itertools/recipes.py                 |  107 +-
 lib/more_itertools/recipes.pyi                |   16 +-
 lib/pydantic/__init__.py                      |  373 +-
 lib/pydantic/_internal/__init__.py            |    0
 lib/pydantic/_internal/_config.py             |  322 ++
 lib/pydantic/_internal/_core_metadata.py      |   92 +
 lib/pydantic/_internal/_core_utils.py         |  570 +++
 lib/pydantic/_internal/_dataclasses.py        |  225 +
 lib/pydantic/_internal/_decorators.py         |  791 ++++
 lib/pydantic/_internal/_decorators_v1.py      |  181 +
 .../_internal/_discriminated_union.py         |  506 +++
 lib/pydantic/_internal/_fields.py             |  319 ++
 lib/pydantic/_internal/_forward_ref.py        |   23 +
 lib/pydantic/_internal/_generate_schema.py    | 2231 +++++++++
 lib/pydantic/_internal/_generics.py           |  517 +++
 lib/pydantic/_internal/_git.py                |   26 +
 lib/pydantic/_internal/_internal_dataclass.py |   10 +
 .../_internal/_known_annotated_metadata.py    |  410 ++
 lib/pydantic/_internal/_mock_val_ser.py       |  140 +
 lib/pydantic/_internal/_model_construction.py |  637 +++
 lib/pydantic/_internal/_repr.py               |  117 +
 .../_internal/_schema_generation_shared.py    |  124 +
 lib/pydantic/_internal/_signature.py          |  164 +
 lib/pydantic/_internal/_std_types_schema.py   |  714 +++
 lib/pydantic/_internal/_typing_extra.py       |  469 ++
 lib/pydantic/_internal/_utils.py              |  362 ++
 lib/pydantic/_internal/_validate_call.py      |   84 +
 lib/pydantic/_internal/_validators.py         |  278 ++
 lib/pydantic/_migration.py                    |  308 ++
 lib/pydantic/alias_generators.py              |   50 +
 lib/pydantic/aliases.py                       |  112 +
 lib/pydantic/annotated_handlers.py            |  120 +
 lib/pydantic/class_validators.py              |  344 +-
 lib/pydantic/color.py                         |  285 +-
 lib/pydantic/config.py                        | 1048 ++++-
 lib/pydantic/dataclasses.py                   |  632 +--
 lib/pydantic/datetime_parse.py                |  250 +-
 lib/pydantic/decorator.py                     |  266 +-
 lib/pydantic/deprecated/__init__.py           |    0
 lib/pydantic/deprecated/class_validators.py   |  253 ++
 lib/pydantic/deprecated/config.py             |   72 +
 lib/pydantic/deprecated/copy_internals.py     |  224 +
 lib/pydantic/deprecated/decorator.py          |  279 ++
 lib/pydantic/deprecated/json.py               |  140 +
 lib/pydantic/deprecated/parse.py              |   80 +
 lib/pydantic/deprecated/tools.py              |  103 +
 lib/pydantic/env_settings.py                  |  348 +-
 lib/pydantic/error_wrappers.py                |  164 +-
 lib/pydantic/errors.py                        |  728 +--
 lib/pydantic/fields.py                        | 2201 +++++----
 lib/pydantic/functional_serializers.py        |  395 ++
 lib/pydantic/functional_validators.py         |  706 +++
 lib/pydantic/generics.py                      |  366 +-
 lib/pydantic/json.py                          |  114 +-
 lib/pydantic/json_schema.py                   | 2425 ++++++++++
 lib/pydantic/main.py                          | 2273 ++++++----
 lib/pydantic/mypy.py                          | 1199 +++--
 lib/pydantic/networks.py                      | 1202 +++--
 lib/pydantic/parse.py                         |   68 +-
 lib/pydantic/plugin/__init__.py               |  170 +
 lib/pydantic/plugin/_loader.py                |   50 +
 lib/pydantic/plugin/_schema_validator.py      |  138 +
 lib/pydantic/root_model.py                    |  149 +
 lib/pydantic/schema.py                        | 1155 +----
 lib/pydantic/tools.py                         |   94 +-
 lib/pydantic/type_adapter.py                  |  460 ++
 lib/pydantic/types.py                         | 3382 ++++++++++----
 lib/pydantic/typing.py                        |  604 +--
 lib/pydantic/utils.py                         |  843 +---
 lib/pydantic/v1/__init__.py                   |  131 +
 lib/pydantic/{ => v1}/_hypothesis_plugin.py   |    9 +-
 lib/pydantic/{ => v1}/annotated_types.py      |    0
 lib/pydantic/v1/class_validators.py           |  361 ++
 lib/pydantic/v1/color.py                      |  494 ++
 lib/pydantic/v1/config.py                     |  191 +
 lib/pydantic/v1/dataclasses.py                |  500 +++
 lib/pydantic/v1/datetime_parse.py             |  248 +
 lib/pydantic/v1/decorator.py                  |  264 ++
 lib/pydantic/v1/env_settings.py               |  350 ++
 lib/pydantic/v1/error_wrappers.py             |  161 +
 lib/pydantic/v1/errors.py                     |  646 +++
 lib/pydantic/v1/fields.py                     | 1253 ++++++
 lib/pydantic/v1/generics.py                   |  400 ++
 lib/pydantic/v1/json.py                       |  112 +
 lib/pydantic/v1/main.py                       | 1107 +++++
 lib/pydantic/v1/mypy.py                       |  944 ++++
 lib/pydantic/v1/networks.py                   |  747 ++++
 lib/pydantic/v1/parse.py                      |   66 +
 lib/pydantic/v1/py.typed                      |    0
 lib/pydantic/v1/schema.py                     | 1163 +++++
 lib/pydantic/v1/tools.py                      |   92 +
 lib/pydantic/v1/types.py                      | 1205 +++++
 lib/pydantic/v1/typing.py                     |  603 +++
 lib/pydantic/v1/utils.py                      |  803 ++++
 lib/pydantic/v1/validators.py                 |  765 ++++
 lib/pydantic/v1/version.py                    |   38 +
 lib/pydantic/validate_call_decorator.py       |   67 +
 lib/pydantic/validators.py                    |  767 +---
 lib/pydantic/version.py                       |   84 +-
 lib/pydantic/warnings.py                      |   58 +
 lib/pydantic_core/__init__.py                 |  139 +
 lib/pydantic_core/_pydantic_core.pyi          |  882 ++++
 lib/pydantic_core/core_schema.py              | 3980 +++++++++++++++++
 lib/pydantic_core/py.typed                    |    0
 lib/tempora/timing.py                         |   13 +-
 lib/typing_extensions.py                      | 2142 ++++++---
 lib/zc/lockfile/__init__.py                   |   23 +-
 lib/zc/lockfile/tests.py                      |   46 +-
 137 files changed, 44442 insertions(+), 11582 deletions(-)
 create mode 100644 lib/annotated_types/__init__.py
 rename lib/{jaraco/classes/__init__.py => annotated_types/py.typed} (100%)
 create mode 100644 lib/annotated_types/test_cases.py
 create mode 100644 lib/inflect/compat/__init__.py
 create mode 100644 lib/inflect/compat/pydantic.py
 create mode 100644 lib/inflect/compat/pydantic1.py
 rename lib/jaraco/{collections.py => collections/__init__.py} (88%)
 create mode 100644 lib/jaraco/collections/py.typed
 rename lib/jaraco/{functools.py => functools/__init__.py} (84%)
 create mode 100644 lib/jaraco/functools/__init__.pyi
 create mode 100644 lib/jaraco/functools/py.typed
 create mode 100644 lib/jaraco/text/strip-prefix.py
 create mode 100644 lib/pydantic/_internal/__init__.py
 create mode 100644 lib/pydantic/_internal/_config.py
 create mode 100644 lib/pydantic/_internal/_core_metadata.py
 create mode 100644 lib/pydantic/_internal/_core_utils.py
 create mode 100644 lib/pydantic/_internal/_dataclasses.py
 create mode 100644 lib/pydantic/_internal/_decorators.py
 create mode 100644 lib/pydantic/_internal/_decorators_v1.py
 create mode 100644 lib/pydantic/_internal/_discriminated_union.py
 create mode 100644 lib/pydantic/_internal/_fields.py
 create mode 100644 lib/pydantic/_internal/_forward_ref.py
 create mode 100644 lib/pydantic/_internal/_generate_schema.py
 create mode 100644 lib/pydantic/_internal/_generics.py
 create mode 100644 lib/pydantic/_internal/_git.py
 create mode 100644 lib/pydantic/_internal/_internal_dataclass.py
 create mode 100644 lib/pydantic/_internal/_known_annotated_metadata.py
 create mode 100644 lib/pydantic/_internal/_mock_val_ser.py
 create mode 100644 lib/pydantic/_internal/_model_construction.py
 create mode 100644 lib/pydantic/_internal/_repr.py
 create mode 100644 lib/pydantic/_internal/_schema_generation_shared.py
 create mode 100644 lib/pydantic/_internal/_signature.py
 create mode 100644 lib/pydantic/_internal/_std_types_schema.py
 create mode 100644 lib/pydantic/_internal/_typing_extra.py
 create mode 100644 lib/pydantic/_internal/_utils.py
 create mode 100644 lib/pydantic/_internal/_validate_call.py
 create mode 100644 lib/pydantic/_internal/_validators.py
 create mode 100644 lib/pydantic/_migration.py
 create mode 100644 lib/pydantic/alias_generators.py
 create mode 100644 lib/pydantic/aliases.py
 create mode 100644 lib/pydantic/annotated_handlers.py
 create mode 100644 lib/pydantic/deprecated/__init__.py
 create mode 100644 lib/pydantic/deprecated/class_validators.py
 create mode 100644 lib/pydantic/deprecated/config.py
 create mode 100644 lib/pydantic/deprecated/copy_internals.py
 create mode 100644 lib/pydantic/deprecated/decorator.py
 create mode 100644 lib/pydantic/deprecated/json.py
 create mode 100644 lib/pydantic/deprecated/parse.py
 create mode 100644 lib/pydantic/deprecated/tools.py
 create mode 100644 lib/pydantic/functional_serializers.py
 create mode 100644 lib/pydantic/functional_validators.py
 create mode 100644 lib/pydantic/json_schema.py
 create mode 100644 lib/pydantic/plugin/__init__.py
 create mode 100644 lib/pydantic/plugin/_loader.py
 create mode 100644 lib/pydantic/plugin/_schema_validator.py
 create mode 100644 lib/pydantic/root_model.py
 create mode 100644 lib/pydantic/type_adapter.py
 create mode 100644 lib/pydantic/v1/__init__.py
 rename lib/pydantic/{ => v1}/_hypothesis_plugin.py (97%)
 rename lib/pydantic/{ => v1}/annotated_types.py (100%)
 create mode 100644 lib/pydantic/v1/class_validators.py
 create mode 100644 lib/pydantic/v1/color.py
 create mode 100644 lib/pydantic/v1/config.py
 create mode 100644 lib/pydantic/v1/dataclasses.py
 create mode 100644 lib/pydantic/v1/datetime_parse.py
 create mode 100644 lib/pydantic/v1/decorator.py
 create mode 100644 lib/pydantic/v1/env_settings.py
 create mode 100644 lib/pydantic/v1/error_wrappers.py
 create mode 100644 lib/pydantic/v1/errors.py
 create mode 100644 lib/pydantic/v1/fields.py
 create mode 100644 lib/pydantic/v1/generics.py
 create mode 100644 lib/pydantic/v1/json.py
 create mode 100644 lib/pydantic/v1/main.py
 create mode 100644 lib/pydantic/v1/mypy.py
 create mode 100644 lib/pydantic/v1/networks.py
 create mode 100644 lib/pydantic/v1/parse.py
 create mode 100644 lib/pydantic/v1/py.typed
 create mode 100644 lib/pydantic/v1/schema.py
 create mode 100644 lib/pydantic/v1/tools.py
 create mode 100644 lib/pydantic/v1/types.py
 create mode 100644 lib/pydantic/v1/typing.py
 create mode 100644 lib/pydantic/v1/utils.py
 create mode 100644 lib/pydantic/v1/validators.py
 create mode 100644 lib/pydantic/v1/version.py
 create mode 100644 lib/pydantic/validate_call_decorator.py
 create mode 100644 lib/pydantic/warnings.py
 create mode 100644 lib/pydantic_core/__init__.py
 create mode 100644 lib/pydantic_core/_pydantic_core.pyi
 create mode 100644 lib/pydantic_core/core_schema.py
 create mode 100644 lib/pydantic_core/py.typed

diff --git a/lib/annotated_types/__init__.py b/lib/annotated_types/__init__.py
new file mode 100644
index 00000000..2f989504
--- /dev/null
+++ b/lib/annotated_types/__init__.py
@@ -0,0 +1,396 @@
+import math
+import sys
+from dataclasses import dataclass
+from datetime import timezone
+from typing import TYPE_CHECKING, Any, Callable, Iterator, Optional, SupportsFloat, SupportsIndex, TypeVar, Union
+
+if sys.version_info < (3, 8):
+    from typing_extensions import Protocol, runtime_checkable
+else:
+    from typing import Protocol, runtime_checkable
+
+if sys.version_info < (3, 9):
+    from typing_extensions import Annotated, Literal
+else:
+    from typing import Annotated, Literal
+
+if sys.version_info < (3, 10):
+    EllipsisType = type(Ellipsis)
+    KW_ONLY = {}
+    SLOTS = {}
+else:
+    from types import EllipsisType
+
+    KW_ONLY = {"kw_only": True}
+    SLOTS = {"slots": True}
+
+
+__all__ = (
+    'BaseMetadata',
+    'GroupedMetadata',
+    'Gt',
+    'Ge',
+    'Lt',
+    'Le',
+    'Interval',
+    'MultipleOf',
+    'MinLen',
+    'MaxLen',
+    'Len',
+    'Timezone',
+    'Predicate',
+    'LowerCase',
+    'UpperCase',
+    'IsDigits',
+    'IsFinite',
+    'IsNotFinite',
+    'IsNan',
+    'IsNotNan',
+    'IsInfinite',
+    'IsNotInfinite',
+    'doc',
+    'DocInfo',
+    '__version__',
+)
+
+__version__ = '0.6.0'
+
+
+T = TypeVar('T')
+
+
+# arguments that start with __ are considered
+# positional only
+# see https://peps.python.org/pep-0484/#positional-only-arguments
+
+
+class SupportsGt(Protocol):
+    def __gt__(self: T, __other: T) -> bool:
+        ...
+
+
+class SupportsGe(Protocol):
+    def __ge__(self: T, __other: T) -> bool:
+        ...
+
+
+class SupportsLt(Protocol):
+    def __lt__(self: T, __other: T) -> bool:
+        ...
+
+
+class SupportsLe(Protocol):
+    def __le__(self: T, __other: T) -> bool:
+        ...
+
+
+class SupportsMod(Protocol):
+    def __mod__(self: T, __other: T) -> T:
+        ...
+
+
+class SupportsDiv(Protocol):
+    def __div__(self: T, __other: T) -> T:
+        ...
+
+
+class BaseMetadata:
+    """Base class for all metadata.
+
+    This exists mainly so that implementers
+    can do `isinstance(..., BaseMetadata)` while traversing field annotations.
+    """
+
+    __slots__ = ()
+
+
+@dataclass(frozen=True, **SLOTS)
+class Gt(BaseMetadata):
+    """Gt(gt=x) implies that the value must be greater than x.
+
+    It can be used with any type that supports the ``>`` operator,
+    including numbers, dates and times, strings, sets, and so on.
+    """
+
+    gt: SupportsGt
+
+
+@dataclass(frozen=True, **SLOTS)
+class Ge(BaseMetadata):
+    """Ge(ge=x) implies that the value must be greater than or equal to x.
+
+    It can be used with any type that supports the ``>=`` operator,
+    including numbers, dates and times, strings, sets, and so on.
+    """
+
+    ge: SupportsGe
+
+
+@dataclass(frozen=True, **SLOTS)
+class Lt(BaseMetadata):
+    """Lt(lt=x) implies that the value must be less than x.
+
+    It can be used with any type that supports the ``<`` operator,
+    including numbers, dates and times, strings, sets, and so on.
+    """
+
+    lt: SupportsLt
+
+
+@dataclass(frozen=True, **SLOTS)
+class Le(BaseMetadata):
+    """Le(le=x) implies that the value must be less than or equal to x.
+
+    It can be used with any type that supports the ``<=`` operator,
+    including numbers, dates and times, strings, sets, and so on.
+    """
+
+    le: SupportsLe
+
+
+@runtime_checkable
+class GroupedMetadata(Protocol):
+    """A grouping of multiple BaseMetadata objects.
+
+    `GroupedMetadata` on its own is not metadata and has no meaning.
+    All it the the constraint and metadata should be fully expressable
+    in terms of the `BaseMetadata`'s returned by `GroupedMetadata.__iter__()`.
+
+    Concrete implementations should override `GroupedMetadata.__iter__()`
+    to add their own metadata.
+    For example:
+
+    >>> @dataclass
+    >>> class Field(GroupedMetadata):
+    >>>     gt: float | None = None
+    >>>     description: str | None = None
+    ...
+    >>>     def __iter__(self) -> Iterable[BaseMetadata]:
+    >>>         if self.gt is not None:
+    >>>             yield Gt(self.gt)
+    >>>         if self.description is not None:
+    >>>             yield Description(self.gt)
+
+    Also see the implementation of `Interval` below for an example.
+
+    Parsers should recognize this and unpack it so that it can be used
+    both with and without unpacking:
+
+    - `Annotated[int, Field(...)]` (parser must unpack Field)
+    - `Annotated[int, *Field(...)]` (PEP-646)
+    """  # noqa: trailing-whitespace
+
+    @property
+    def __is_annotated_types_grouped_metadata__(self) -> Literal[True]:
+        return True
+
+    def __iter__(self) -> Iterator[BaseMetadata]:
+        ...
+
+    if not TYPE_CHECKING:
+        __slots__ = ()  # allow subclasses to use slots
+
+        def __init_subclass__(cls, *args: Any, **kwargs: Any) -> None:
+            # Basic ABC like functionality without the complexity of an ABC
+            super().__init_subclass__(*args, **kwargs)
+            if cls.__iter__ is GroupedMetadata.__iter__:
+                raise TypeError("Can't subclass GroupedMetadata without implementing __iter__")
+
+        def __iter__(self) -> Iterator[BaseMetadata]:  # noqa: F811
+            raise NotImplementedError  # more helpful than "None has no attribute..." type errors
+
+
+@dataclass(frozen=True, **KW_ONLY, **SLOTS)
+class Interval(GroupedMetadata):
+    """Interval can express inclusive or exclusive bounds with a single object.
+
+    It accepts keyword arguments ``gt``, ``ge``, ``lt``, and/or ``le``, which
+    are interpreted the same way as the single-bound constraints.
+    """
+
+    gt: Union[SupportsGt, None] = None
+    ge: Union[SupportsGe, None] = None
+    lt: Union[SupportsLt, None] = None
+    le: Union[SupportsLe, None] = None
+
+    def __iter__(self) -> Iterator[BaseMetadata]:
+        """Unpack an Interval into zero or more single-bounds."""
+        if self.gt is not None:
+            yield Gt(self.gt)
+        if self.ge is not None:
+            yield Ge(self.ge)
+        if self.lt is not None:
+            yield Lt(self.lt)
+        if self.le is not None:
+            yield Le(self.le)
+
+
+@dataclass(frozen=True, **SLOTS)
+class MultipleOf(BaseMetadata):
+    """MultipleOf(multiple_of=x) might be interpreted in two ways:
+
+    1. Python semantics, implying ``value % multiple_of == 0``, or
+    2. JSONschema semantics, where ``int(value / multiple_of) == value / multiple_of``
+
+    We encourage users to be aware of these two common interpretations,
+    and libraries to carefully document which they implement.
+    """
+
+    multiple_of: Union[SupportsDiv, SupportsMod]
+
+
+@dataclass(frozen=True, **SLOTS)
+class MinLen(BaseMetadata):
+    """
+    MinLen() implies minimum inclusive length,
+    e.g. ``len(value) >= min_length``.
+    """
+
+    min_length: Annotated[int, Ge(0)]
+
+
+@dataclass(frozen=True, **SLOTS)
+class MaxLen(BaseMetadata):
+    """
+    MaxLen() implies maximum inclusive length,
+    e.g. ``len(value) <= max_length``.
+    """
+
+    max_length: Annotated[int, Ge(0)]
+
+
+@dataclass(frozen=True, **SLOTS)
+class Len(GroupedMetadata):
+    """
+    Len() implies that ``min_length <= len(value) <= max_length``.
+
+    Upper bound may be omitted or ``None`` to indicate no upper length bound.
+    """
+
+    min_length: Annotated[int, Ge(0)] = 0
+    max_length: Optional[Annotated[int, Ge(0)]] = None
+
+    def __iter__(self) -> Iterator[BaseMetadata]:
+        """Unpack a Len into zone or more single-bounds."""
+        if self.min_length > 0:
+            yield MinLen(self.min_length)
+        if self.max_length is not None:
+            yield MaxLen(self.max_length)
+
+
+@dataclass(frozen=True, **SLOTS)
+class Timezone(BaseMetadata):
+    """Timezone(tz=...) requires a datetime to be aware (or ``tz=None``, naive).
+
+    ``Annotated[datetime, Timezone(None)]`` must be a naive datetime.
+    ``Timezone[...]`` (the ellipsis literal) expresses that the datetime must be
+    tz-aware but any timezone is allowed.
+
+    You may also pass a specific timezone string or timezone object such as
+    ``Timezone(timezone.utc)`` or ``Timezone("Africa/Abidjan")`` to express that
+    you only allow a specific timezone, though we note that this is often
+    a symptom of poor design.
+    """
+
+    tz: Union[str, timezone, EllipsisType, None]
+
+
+@dataclass(frozen=True, **SLOTS)
+class Predicate(BaseMetadata):
+    """``Predicate(func: Callable)`` implies `func(value)` is truthy for valid values.
+
+    Users should prefer statically inspectable metadata, but if you need the full
+    power and flexibility of arbitrary runtime predicates... here it is.
+
+    We provide a few predefined predicates for common string constraints:
+    ``IsLower = Predicate(str.islower)``, ``IsUpper = Predicate(str.isupper)``, and
+    ``IsDigit = Predicate(str.isdigit)``. Users are encouraged to use methods which
+    can be given special handling, and avoid indirection like ``lambda s: s.lower()``.
+
+    Some libraries might have special logic to handle certain predicates, e.g. by
+    checking for `str.isdigit` and using its presence to both call custom logic to
+    enforce digit-only strings, and customise some generated external schema.
+
+    We do not specify what behaviour should be expected for predicates that raise
+    an exception.  For example `Annotated[int, Predicate(str.isdigit)]` might silently
+    skip invalid constraints, or statically raise an error; or it might try calling it
+    and then propogate or discard the resulting exception.
+    """
+
+    func: Callable[[Any], bool]
+
+
+@dataclass
+class Not:
+    func: Callable[[Any], bool]
+
+    def __call__(self, __v: Any) -> bool:
+        return not self.func(__v)
+
+
+_StrType = TypeVar("_StrType", bound=str)
+
+LowerCase = Annotated[_StrType, Predicate(str.islower)]
+"""
+Return True if the string is a lowercase string, False otherwise.
+
+A string is lowercase if all cased characters in the string are lowercase and there is at least one cased character in the string.
+"""  # noqa: E501
+UpperCase = Annotated[_StrType, Predicate(str.isupper)]
+"""
+Return True if the string is an uppercase string, False otherwise.
+
+A string is uppercase if all cased characters in the string are uppercase and there is at least one cased character in the string.
+"""  # noqa: E501
+IsDigits = Annotated[_StrType, Predicate(str.isdigit)]
+"""
+Return True if the string is a digit string, False otherwise.
+
+A string is a digit string if all characters in the string are digits and there is at least one character in the string.
+"""  # noqa: E501
+IsAscii = Annotated[_StrType, Predicate(str.isascii)]
+"""
+Return True if all characters in the string are ASCII, False otherwise.
+
+ASCII characters have code points in the range U+0000-U+007F. Empty string is ASCII too.
+"""
+
+_NumericType = TypeVar('_NumericType', bound=Union[SupportsFloat, SupportsIndex])
+IsFinite = Annotated[_NumericType, Predicate(math.isfinite)]
+"""Return True if x is neither an infinity nor a NaN, and False otherwise."""
+IsNotFinite = Annotated[_NumericType, Predicate(Not(math.isfinite))]
+"""Return True if x is one of infinity or NaN, and False otherwise"""
+IsNan = Annotated[_NumericType, Predicate(math.isnan)]
+"""Return True if x is a NaN (not a number), and False otherwise."""
+IsNotNan = Annotated[_NumericType, Predicate(Not(math.isnan))]
+"""Return True if x is anything but NaN (not a number), and False otherwise."""
+IsInfinite = Annotated[_NumericType, Predicate(math.isinf)]
+"""Return True if x is a positive or negative infinity, and False otherwise."""
+IsNotInfinite = Annotated[_NumericType, Predicate(Not(math.isinf))]
+"""Return True if x is neither a positive or negative infinity, and False otherwise."""
+
+try:
+    from typing_extensions import DocInfo, doc  # type: ignore [attr-defined]
+except ImportError:
+
+    @dataclass(frozen=True, **SLOTS)
+    class DocInfo:  # type: ignore [no-redef]
+        """ "
+        The return value of doc(), mainly to be used by tools that want to extract the
+        Annotated documentation at runtime.
+        """
+
+        documentation: str
+        """The documentation string passed to doc()."""
+
+    def doc(
+        documentation: str,
+    ) -> DocInfo:
+        """
+        Add documentation to a type annotation inside of Annotated.
+
+        For example:
+
+        >>> def hi(name: Annotated[int, doc("The name of the user")]) -> None: ...
+        """
+        return DocInfo(documentation)
diff --git a/lib/jaraco/classes/__init__.py b/lib/annotated_types/py.typed
similarity index 100%
rename from lib/jaraco/classes/__init__.py
rename to lib/annotated_types/py.typed
diff --git a/lib/annotated_types/test_cases.py b/lib/annotated_types/test_cases.py
new file mode 100644
index 00000000..f54df700
--- /dev/null
+++ b/lib/annotated_types/test_cases.py
@@ -0,0 +1,147 @@
+import math
+import sys
+from datetime import date, datetime, timedelta, timezone
+from decimal import Decimal
+from typing import Any, Dict, Iterable, Iterator, List, NamedTuple, Set, Tuple
+
+if sys.version_info < (3, 9):
+    from typing_extensions import Annotated
+else:
+    from typing import Annotated
+
+import annotated_types as at
+
+
+class Case(NamedTuple):
+    """
+    A test case for `annotated_types`.
+    """
+
+    annotation: Any
+    valid_cases: Iterable[Any]
+    invalid_cases: Iterable[Any]
+
+
+def cases() -> Iterable[Case]:
+    # Gt, Ge, Lt, Le
+    yield Case(Annotated[int, at.Gt(4)], (5, 6, 1000), (4, 0, -1))
+    yield Case(Annotated[float, at.Gt(0.5)], (0.6, 0.7, 0.8, 0.9), (0.5, 0.0, -0.1))
+    yield Case(
+        Annotated[datetime, at.Gt(datetime(2000, 1, 1))],
+        [datetime(2000, 1, 2), datetime(2000, 1, 3)],
+        [datetime(2000, 1, 1), datetime(1999, 12, 31)],
+    )
+    yield Case(
+        Annotated[datetime, at.Gt(date(2000, 1, 1))],
+        [date(2000, 1, 2), date(2000, 1, 3)],
+        [date(2000, 1, 1), date(1999, 12, 31)],
+    )
+    yield Case(
+        Annotated[datetime, at.Gt(Decimal('1.123'))],
+        [Decimal('1.1231'), Decimal('123')],
+        [Decimal('1.123'), Decimal('0')],
+    )
+
+    yield Case(Annotated[int, at.Ge(4)], (4, 5, 6, 1000, 4), (0, -1))
+    yield Case(Annotated[float, at.Ge(0.5)], (0.5, 0.6, 0.7, 0.8, 0.9), (0.4, 0.0, -0.1))
+    yield Case(
+        Annotated[datetime, at.Ge(datetime(2000, 1, 1))],
+        [datetime(2000, 1, 2), datetime(2000, 1, 3)],
+        [datetime(1998, 1, 1), datetime(1999, 12, 31)],
+    )
+
+    yield Case(Annotated[int, at.Lt(4)], (0, -1), (4, 5, 6, 1000, 4))
+    yield Case(Annotated[float, at.Lt(0.5)], (0.4, 0.0, -0.1), (0.5, 0.6, 0.7, 0.8, 0.9))
+    yield Case(
+        Annotated[datetime, at.Lt(datetime(2000, 1, 1))],
+        [datetime(1999, 12, 31), datetime(1999, 12, 31)],
+        [datetime(2000, 1, 2), datetime(2000, 1, 3)],
+    )
+
+    yield Case(Annotated[int, at.Le(4)], (4, 0, -1), (5, 6, 1000))
+    yield Case(Annotated[float, at.Le(0.5)], (0.5, 0.0, -0.1), (0.6, 0.7, 0.8, 0.9))
+    yield Case(
+        Annotated[datetime, at.Le(datetime(2000, 1, 1))],
+        [datetime(2000, 1, 1), datetime(1999, 12, 31)],
+        [datetime(2000, 1, 2), datetime(2000, 1, 3)],
+    )
+
+    # Interval
+    yield Case(Annotated[int, at.Interval(gt=4)], (5, 6, 1000), (4, 0, -1))
+    yield Case(Annotated[int, at.Interval(gt=4, lt=10)], (5, 6), (4, 10, 1000, 0, -1))
+    yield Case(Annotated[float, at.Interval(ge=0.5, le=1)], (0.5, 0.9, 1), (0.49, 1.1))
+    yield Case(
+        Annotated[datetime, at.Interval(gt=datetime(2000, 1, 1), le=datetime(2000, 1, 3))],
+        [datetime(2000, 1, 2), datetime(2000, 1, 3)],
+        [datetime(2000, 1, 1), datetime(2000, 1, 4)],
+    )
+
+    yield Case(Annotated[int, at.MultipleOf(multiple_of=3)], (0, 3, 9), (1, 2, 4))
+    yield Case(Annotated[float, at.MultipleOf(multiple_of=0.5)], (0, 0.5, 1, 1.5), (0.4, 1.1))
+
+    # lengths
+
+    yield Case(Annotated[str, at.MinLen(3)], ('123', '1234', 'x' * 10), ('', '1', '12'))
+    yield Case(Annotated[str, at.Len(3)], ('123', '1234', 'x' * 10), ('', '1', '12'))
+    yield Case(Annotated[List[int], at.MinLen(3)], ([1, 2, 3], [1, 2, 3, 4], [1] * 10), ([], [1], [1, 2]))
+    yield Case(Annotated[List[int], at.Len(3)], ([1, 2, 3], [1, 2, 3, 4], [1] * 10), ([], [1], [1, 2]))
+
+    yield Case(Annotated[str, at.MaxLen(4)], ('', '1234'), ('12345', 'x' * 10))
+    yield Case(Annotated[str, at.Len(0, 4)], ('', '1234'), ('12345', 'x' * 10))
+    yield Case(Annotated[List[str], at.MaxLen(4)], ([], ['a', 'bcdef'], ['a', 'b', 'c']), (['a'] * 5, ['b'] * 10))
+    yield Case(Annotated[List[str], at.Len(0, 4)], ([], ['a', 'bcdef'], ['a', 'b', 'c']), (['a'] * 5, ['b'] * 10))
+
+    yield Case(Annotated[str, at.Len(3, 5)], ('123', '12345'), ('', '1', '12', '123456', 'x' * 10))
+    yield Case(Annotated[str, at.Len(3, 3)], ('123',), ('12', '1234'))
+
+    yield Case(Annotated[Dict[int, int], at.Len(2, 3)], [{1: 1, 2: 2}], [{}, {1: 1}, {1: 1, 2: 2, 3: 3, 4: 4}])
+    yield Case(Annotated[Set[int], at.Len(2, 3)], ({1, 2}, {1, 2, 3}), (set(), {1}, {1, 2, 3, 4}))
+    yield Case(Annotated[Tuple[int, ...], at.Len(2, 3)], ((1, 2), (1, 2, 3)), ((), (1,), (1, 2, 3, 4)))
+
+    # Timezone
+
+    yield Case(
+        Annotated[datetime, at.Timezone(None)], [datetime(2000, 1, 1)], [datetime(2000, 1, 1, tzinfo=timezone.utc)]
+    )
+    yield Case(
+        Annotated[datetime, at.Timezone(...)], [datetime(2000, 1, 1, tzinfo=timezone.utc)], [datetime(2000, 1, 1)]
+    )
+    yield Case(
+        Annotated[datetime, at.Timezone(timezone.utc)],
+        [datetime(2000, 1, 1, tzinfo=timezone.utc)],
+        [datetime(2000, 1, 1), datetime(2000, 1, 1, tzinfo=timezone(timedelta(hours=6)))],
+    )
+    yield Case(
+        Annotated[datetime, at.Timezone('Europe/London')],
+        [datetime(2000, 1, 1, tzinfo=timezone(timedelta(0), name='Europe/London'))],
+        [datetime(2000, 1, 1), datetime(2000, 1, 1, tzinfo=timezone(timedelta(hours=6)))],
+    )
+
+    # predicate types
+
+    yield Case(at.LowerCase[str], ['abc', 'foobar'], ['', 'A', 'Boom'])
+    yield Case(at.UpperCase[str], ['ABC', 'DEFO'], ['', 'a', 'abc', 'AbC'])
+    yield Case(at.IsDigits[str], ['123'], ['', 'ab', 'a1b2'])
+    yield Case(at.IsAscii[str], ['123', 'foo bar'], ['£100', '😊', 'whatever 👀'])
+
+    yield Case(Annotated[int, at.Predicate(lambda x: x % 2 == 0)], [0, 2, 4], [1, 3, 5])
+
+    yield Case(at.IsFinite[float], [1.23], [math.nan, math.inf, -math.inf])
+    yield Case(at.IsNotFinite[float], [math.nan, math.inf], [1.23])
+    yield Case(at.IsNan[float], [math.nan], [1.23, math.inf])
+    yield Case(at.IsNotNan[float], [1.23, math.inf], [math.nan])
+    yield Case(at.IsInfinite[float], [math.inf], [math.nan, 1.23])
+    yield Case(at.IsNotInfinite[float], [math.nan, 1.23], [math.inf])
+
+    # check stacked predicates
+    yield Case(at.IsInfinite[Annotated[float, at.Predicate(lambda x: x > 0)]], [math.inf], [-math.inf, 1.23, math.nan])
+
+    # doc
+    yield Case(Annotated[int, at.doc("A number")], [1, 2], [])
+
+    # custom GroupedMetadata
+    class MyCustomGroupedMetadata(at.GroupedMetadata):
+        def __iter__(self) -> Iterator[at.Predicate]:
+            yield at.Predicate(lambda x: float(x).is_integer())
+
+    yield Case(Annotated[float, MyCustomGroupedMetadata()], [0, 2.0], [0.01, 1.5])
diff --git a/lib/autocommand/autoasync.py b/lib/autocommand/autoasync.py
index 3c8ebdcf..688f7e05 100644
--- a/lib/autocommand/autoasync.py
+++ b/lib/autocommand/autoasync.py
@@ -20,7 +20,7 @@ from functools import wraps
 from inspect import signature
 
 
-def _launch_forever_coro(coro, args, kwargs, loop):
+async def _run_forever_coro(coro, args, kwargs, loop):
     '''
     This helper function launches an async main function that was tagged with
     forever=True. There are two possibilities:
@@ -48,7 +48,7 @@ def _launch_forever_coro(coro, args, kwargs, loop):
     # forever=True feature from autoasync at some point in the future.
     thing = coro(*args, **kwargs)
     if iscoroutine(thing):
-        loop.create_task(thing)
+        await thing
 
 
 def autoasync(coro=None, *, loop=None, forever=False, pass_loop=False):
@@ -127,7 +127,9 @@ def autoasync(coro=None, *, loop=None, forever=False, pass_loop=False):
             args, kwargs = bound_args.args, bound_args.kwargs
 
         if forever:
-            _launch_forever_coro(coro, args, kwargs, local_loop)
+            local_loop.create_task(_run_forever_coro(
+                coro, args, kwargs, local_loop
+            ))
             local_loop.run_forever()
         else:
             return local_loop.run_until_complete(coro(*args, **kwargs))
diff --git a/lib/cherrypy/_cplogging.py b/lib/cherrypy/_cplogging.py
index 151d3b40..bce1c87b 100644
--- a/lib/cherrypy/_cplogging.py
+++ b/lib/cherrypy/_cplogging.py
@@ -452,6 +452,6 @@ class WSGIErrorHandler(logging.Handler):
 
 class LazyRfc3339UtcTime(object):
     def __str__(self):
-        """Return now() in RFC3339 UTC Format."""
-        now = datetime.datetime.now()
-        return now.isoformat('T') + 'Z'
+        """Return utcnow() in RFC3339 UTC Format."""
+        iso_formatted_now = datetime.datetime.utcnow().isoformat('T')
+        return f'{iso_formatted_now!s}Z'
diff --git a/lib/cherrypy/lib/cptools.py b/lib/cherrypy/lib/cptools.py
index 613a8995..13b4c567 100644
--- a/lib/cherrypy/lib/cptools.py
+++ b/lib/cherrypy/lib/cptools.py
@@ -622,13 +622,15 @@ def autovary(ignore=None, debug=False):
 
 
 def convert_params(exception=ValueError, error=400):
-    """Convert request params based on function annotations, with error handling.
+    """Convert request params based on function annotations.
 
-    exception
-        Exception class to catch.
+    This function also processes errors that are subclasses of ``exception``.
 
-    status
-        The HTTP error code to return to the client on failure.
+    :param BaseException exception: Exception class to catch.
+    :type exception: BaseException
+
+    :param error: The HTTP status code to return to the client on failure.
+    :type error: int
     """
     request = cherrypy.serving.request
     types = request.handler.callable.__annotations__
diff --git a/lib/cherrypy/lib/profiler.py b/lib/cherrypy/lib/profiler.py
index fccf2eb8..7182278a 100644
--- a/lib/cherrypy/lib/profiler.py
+++ b/lib/cherrypy/lib/profiler.py
@@ -47,7 +47,9 @@ try:
     import pstats
 
     def new_func_strip_path(func_name):
-        """Make profiler output more readable by adding `__init__` modules' parents
+        """Add ``__init__`` modules' parents.
+
+        This makes the profiler output more readable.
         """
         filename, line, name = func_name
         if filename.endswith('__init__.py'):
diff --git a/lib/cherrypy/lib/reprconf.py b/lib/cherrypy/lib/reprconf.py
index 76381d7b..536b9417 100644
--- a/lib/cherrypy/lib/reprconf.py
+++ b/lib/cherrypy/lib/reprconf.py
@@ -188,7 +188,7 @@ class Parser(configparser.ConfigParser):
 
     def dict_from_file(self, file):
         if hasattr(file, 'read'):
-            self.readfp(file)
+            self.read_file(file)
         else:
             self.read(file)
         return self.as_dict()
diff --git a/lib/cherrypy/lib/static.py b/lib/cherrypy/lib/static.py
index 66a5a947..c1ad95f3 100644
--- a/lib/cherrypy/lib/static.py
+++ b/lib/cherrypy/lib/static.py
@@ -1,19 +1,18 @@
 """Module with helpers for serving static files."""
 
+import mimetypes
 import os
 import platform
 import re
 import stat
-import mimetypes
-import urllib.parse
 import unicodedata
-
+import urllib.parse
 from email.generator import _make_boundary as make_boundary
 from io import UnsupportedOperation
 
 import cherrypy
 from cherrypy._cpcompat import ntob
-from cherrypy.lib import cptools, httputil, file_generator_limited
+from cherrypy.lib import cptools, file_generator_limited, httputil
 
 
 def _setup_mimetypes():
@@ -185,7 +184,10 @@ def serve_fileobj(fileobj, content_type=None, disposition=None, name=None,
 
 
 def _serve_fileobj(fileobj, content_type, content_length, debug=False):
-    """Internal. Set response.body to the given file object, perhaps ranged."""
+    """Set ``response.body`` to the given file object, perhaps ranged.
+
+    Internal helper.
+    """
     response = cherrypy.serving.response
 
     # HTTP/1.0 didn't have Range/Accept-Ranges headers, or the 206 code
diff --git a/lib/cherrypy/process/wspbus.py b/lib/cherrypy/process/wspbus.py
index 1d2789b1..a60cd51e 100644
--- a/lib/cherrypy/process/wspbus.py
+++ b/lib/cherrypy/process/wspbus.py
@@ -494,7 +494,7 @@ class Bus(object):
                     "Cannot reconstruct command from '-c'. "
                     'Ref: https://github.com/cherrypy/cherrypy/issues/1545')
         except AttributeError:
-            """It looks Py_GetArgcArgv is completely absent in some environments
+            """It looks Py_GetArgcArgv's completely absent in some environments
 
             It is known, that there's no Py_GetArgcArgv in MS Windows and
             ``ctypes`` module is completely absent in Google AppEngine
diff --git a/lib/cherrypy/test/test_http.py b/lib/cherrypy/test/test_http.py
index a955be43..9a7e9331 100644
--- a/lib/cherrypy/test/test_http.py
+++ b/lib/cherrypy/test/test_http.py
@@ -136,6 +136,9 @@ class HTTPTests(helper.CPWebCase):
         self.assertStatus(200)
         self.assertBody(b'Hello world!')
 
+        response.close()
+        c.close()
+
         # Now send a message that has no Content-Length, but does send a body.
         # Verify that CP times out the socket and responds
         # with 411 Length Required.
@@ -159,6 +162,9 @@ class HTTPTests(helper.CPWebCase):
         self.status = str(response.status)
         self.assertStatus(411)
 
+        response.close()
+        c.close()
+
     def test_post_multipart(self):
         alphabet = 'abcdefghijklmnopqrstuvwxyz'
         # generate file contents for a large post
@@ -184,6 +190,9 @@ class HTTPTests(helper.CPWebCase):
         parts = ['%s * 65536' % ch for ch in alphabet]
         self.assertBody(', '.join(parts))
 
+        response.close()
+        c.close()
+
     def test_post_filename_with_special_characters(self):
         """Testing that we can handle filenames with special characters.
 
@@ -217,6 +226,9 @@ class HTTPTests(helper.CPWebCase):
             self.assertStatus(200)
             self.assertBody(fname)
 
+            response.close()
+            c.close()
+
     def test_malformed_request_line(self):
         if getattr(cherrypy.server, 'using_apache', False):
             return self.skip('skipped due to known Apache differences...')
@@ -264,6 +276,9 @@ class HTTPTests(helper.CPWebCase):
         self.body = response.fp.read(20)
         self.assertBody('Illegal header line.')
 
+        response.close()
+        c.close()
+
     def test_http_over_https(self):
         if self.scheme != 'https':
             return self.skip('skipped (not running HTTPS)... ')
diff --git a/lib/cherrypy/test/test_iterator.py b/lib/cherrypy/test/test_iterator.py
index 6600a78d..5bad59be 100644
--- a/lib/cherrypy/test/test_iterator.py
+++ b/lib/cherrypy/test/test_iterator.py
@@ -150,6 +150,8 @@ class IteratorTest(helper.CPWebCase):
             self.assertStatus(200)
             self.assertBody('0')
 
+            itr_conn.close()
+
         # Now we do the same check with streaming - some classes will
         # be automatically closed, while others cannot.
         stream_counts = {}
diff --git a/lib/cherrypy/test/test_logging.py b/lib/cherrypy/test/test_logging.py
index 2d4aa56f..49d41d0a 100644
--- a/lib/cherrypy/test/test_logging.py
+++ b/lib/cherrypy/test/test_logging.py
@@ -1,5 +1,6 @@
 """Basic tests for the CherryPy core: request handling."""
 
+import datetime
 import logging
 
 from cheroot.test import webtest
@@ -197,6 +198,33 @@ def test_custom_log_format(log_tracker, monkeypatch, server):
     )
 
 
+def test_utc_in_timez(monkeypatch):
+    """Test that ``LazyRfc3339UtcTime`` is rendered as ``str`` using UTC timestamp."""
+    utcoffset8_local_time_in_naive_utc = (
+        datetime.datetime(
+            year=2020,
+            month=1,
+            day=1,
+            hour=1,
+            minute=23,
+            second=45,
+            tzinfo=datetime.timezone(datetime.timedelta(hours=8)),
+        )
+        .astimezone(datetime.timezone.utc)
+        .replace(tzinfo=None)
+    )
+
+    class mock_datetime:
+        @classmethod
+        def utcnow(cls):
+            return utcoffset8_local_time_in_naive_utc
+
+    monkeypatch.setattr('datetime.datetime', mock_datetime)
+    rfc3339_utc_time = str(cherrypy._cplogging.LazyRfc3339UtcTime())
+    expected_time = '2019-12-31T17:23:45Z'
+    assert rfc3339_utc_time == expected_time
+
+
 def test_timez_log_format(log_tracker, monkeypatch, server):
     """Test a customized access_log_format string, which is a
     feature of _cplogging.LogManager.access()."""
diff --git a/lib/inflect/__init__.py b/lib/inflect/__init__.py
index 78d2e33c..b638c6b8 100644
--- a/lib/inflect/__init__.py
+++ b/lib/inflect/__init__.py
@@ -3,8 +3,6 @@ inflect: english language inflection
  - correctly generate plurals, ordinals, indefinite articles
  - convert numbers to words
 
-Copyright (C) 2010 Paul Dyson
-
 Based upon the Perl module
 `Lingua::EN::Inflect <https://metacpan.org/pod/Lingua::EN::Inflect>`_.
 
@@ -70,11 +68,16 @@ from typing import (
     cast,
     Any,
 )
+from typing_extensions import Literal
 from numbers import Number
 
 
-from pydantic import Field, validate_arguments
-from pydantic.typing import Annotated
+from pydantic import Field
+from typing_extensions import Annotated
+
+
+from .compat.pydantic1 import validate_call
+from .compat.pydantic import same_method
 
 
 class UnknownClassicalModeError(Exception):
@@ -105,14 +108,6 @@ class BadGenderError(Exception):
     pass
 
 
-STDOUT_ON = False
-
-
-def print3(txt: str) -> None:
-    if STDOUT_ON:
-        print(txt)
-
-
 def enclose(s: str) -> str:
     return f"(?:{s})"
 
@@ -1727,66 +1722,44 @@ plverb_irregular_pres = {
     "is": "are",
     "was": "were",
     "were": "were",
-    "was": "were",
-    "have": "have",
     "have": "have",
     "has": "have",
     "do": "do",
-    "do": "do",
     "does": "do",
 }
 
 plverb_ambiguous_pres = {
-    "act": "act",
     "act": "act",
     "acts": "act",
     "blame": "blame",
-    "blame": "blame",
     "blames": "blame",
     "can": "can",
-    "can": "can",
-    "can": "can",
     "must": "must",
-    "must": "must",
-    "must": "must",
-    "fly": "fly",
     "fly": "fly",
     "flies": "fly",
     "copy": "copy",
-    "copy": "copy",
     "copies": "copy",
     "drink": "drink",
-    "drink": "drink",
     "drinks": "drink",
     "fight": "fight",
-    "fight": "fight",
     "fights": "fight",
     "fire": "fire",
-    "fire": "fire",
     "fires": "fire",
     "like": "like",
-    "like": "like",
     "likes": "like",
     "look": "look",
-    "look": "look",
     "looks": "look",
     "make": "make",
-    "make": "make",
     "makes": "make",
     "reach": "reach",
-    "reach": "reach",
     "reaches": "reach",
     "run": "run",
-    "run": "run",
     "runs": "run",
     "sink": "sink",
-    "sink": "sink",
     "sinks": "sink",
     "sleep": "sleep",
-    "sleep": "sleep",
     "sleeps": "sleep",
     "view": "view",
-    "view": "view",
     "views": "view",
 }
 
@@ -1854,7 +1827,7 @@ pl_adj_poss_keys = re.compile(fr"^({enclose('|'.join(pl_adj_poss))})$", re.IGNOR
 
 A_abbrev = re.compile(
     r"""
-(?! FJO | [HLMNS]Y.  | RY[EO] | SQU
+^(?! FJO | [HLMNS]Y.  | RY[EO] | SQU
   | ( F[LR]? | [HL] | MN? | N | RH? | S[CHKLMNPTVW]? | X(YL)?) [AEIOU])
 [FHLMNRSX][A-Z]
 """,
@@ -2053,15 +2026,14 @@ Falsish = Any  # ideally, falsish would only validate on bool(value) is False
 
 class engine:
     def __init__(self) -> None:
-
         self.classical_dict = def_classical.copy()
         self.persistent_count: Optional[int] = None
         self.mill_count = 0
-        self.pl_sb_user_defined: List[str] = []
-        self.pl_v_user_defined: List[str] = []
-        self.pl_adj_user_defined: List[str] = []
-        self.si_sb_user_defined: List[str] = []
-        self.A_a_user_defined: List[str] = []
+        self.pl_sb_user_defined: List[Optional[Word]] = []
+        self.pl_v_user_defined: List[Optional[Word]] = []
+        self.pl_adj_user_defined: List[Optional[Word]] = []
+        self.si_sb_user_defined: List[Optional[Word]] = []
+        self.A_a_user_defined: List[Optional[Word]] = []
         self.thegender = "neuter"
         self.__number_args: Optional[Dict[str, str]] = None
 
@@ -2073,28 +2045,8 @@ class engine:
     def _number_args(self, val):
         self.__number_args = val
 
-    deprecated_methods = dict(
-        pl="plural",
-        plnoun="plural_noun",
-        plverb="plural_verb",
-        pladj="plural_adj",
-        sinoun="single_noun",
-        prespart="present_participle",
-        numwords="number_to_words",
-        plequal="compare",
-        plnounequal="compare_nouns",
-        plverbequal="compare_verbs",
-        pladjequal="compare_adjs",
-        wordlist="join",
-    )
-
-    def __getattr__(self, meth):
-        if meth in self.deprecated_methods:
-            print3(f"{meth}() deprecated, use {self.deprecated_methods[meth]}()")
-            raise DeprecationWarning
-        raise AttributeError
-
-    def defnoun(self, singular: str, plural: str) -> int:
+    @validate_call
+    def defnoun(self, singular: Optional[Word], plural: Optional[Word]) -> int:
         """
         Set the noun plural of singular to plural.
 
@@ -2105,7 +2057,16 @@ class engine:
         self.si_sb_user_defined.extend((plural, singular))
         return 1
 
-    def defverb(self, s1: str, p1: str, s2: str, p2: str, s3: str, p3: str) -> int:
+    @validate_call
+    def defverb(
+        self,
+        s1: Optional[Word],
+        p1: Optional[Word],
+        s2: Optional[Word],
+        p2: Optional[Word],
+        s3: Optional[Word],
+        p3: Optional[Word],
+    ) -> int:
         """
         Set the verb plurals for s1, s2 and s3 to p1, p2 and p3 respectively.
 
@@ -2121,7 +2082,8 @@ class engine:
         self.pl_v_user_defined.extend((s1, p1, s2, p2, s3, p3))
         return 1
 
-    def defadj(self, singular: str, plural: str) -> int:
+    @validate_call
+    def defadj(self, singular: Optional[Word], plural: Optional[Word]) -> int:
         """
         Set the adjective plural of singular to plural.
 
@@ -2131,7 +2093,8 @@ class engine:
         self.pl_adj_user_defined.extend((singular, plural))
         return 1
 
-    def defa(self, pattern: str) -> int:
+    @validate_call
+    def defa(self, pattern: Optional[Word]) -> int:
         """
         Define the indefinite article as 'a' for words matching pattern.
 
@@ -2140,7 +2103,8 @@ class engine:
         self.A_a_user_defined.extend((pattern, "a"))
         return 1
 
-    def defan(self, pattern: str) -> int:
+    @validate_call
+    def defan(self, pattern: Optional[Word]) -> int:
         """
         Define the indefinite article as 'an' for words matching pattern.
 
@@ -2149,7 +2113,7 @@ class engine:
         self.A_a_user_defined.extend((pattern, "an"))
         return 1
 
-    def checkpat(self, pattern: Optional[str]) -> None:
+    def checkpat(self, pattern: Optional[Word]) -> None:
         """
         check for errors in a regex pattern
         """
@@ -2158,16 +2122,15 @@ class engine:
         try:
             re.match(pattern, "")
         except re.error:
-            print3(f"\nBad user-defined singular pattern:\n\t{pattern}\n")
-            raise BadUserDefinedPatternError
+            raise BadUserDefinedPatternError(pattern)
 
-    def checkpatplural(self, pattern: str) -> None:
+    def checkpatplural(self, pattern: Optional[Word]) -> None:
         """
         check for errors in a regex replace pattern
         """
         return
 
-    @validate_arguments
+    @validate_call
     def ud_match(self, word: Word, wordlist: Sequence[Optional[Word]]) -> Optional[str]:
         for i in range(len(wordlist) - 2, -2, -2):  # backwards through even elements
             mo = re.search(fr"^{wordlist[i]}$", word, re.IGNORECASE)
@@ -2307,7 +2270,7 @@ class engine:
 
     # 0. PERFORM GENERAL INFLECTIONS IN A STRING
 
-    @validate_arguments
+    @validate_call
     def inflect(self, text: Word) -> str:
         """
         Perform inflections in a string.
@@ -2384,7 +2347,7 @@ class engine:
         else:
             return "", "", ""
 
-    @validate_arguments
+    @validate_call
     def plural(self, text: Word, count: Optional[Union[str, int, Any]] = None) -> str:
         """
         Return the plural of text.
@@ -2408,7 +2371,7 @@ class engine:
         )
         return f"{pre}{plural}{post}"
 
-    @validate_arguments
+    @validate_call
     def plural_noun(
         self, text: Word, count: Optional[Union[str, int, Any]] = None
     ) -> str:
@@ -2429,7 +2392,7 @@ class engine:
         plural = self.postprocess(word, self._plnoun(word, count))
         return f"{pre}{plural}{post}"
 
-    @validate_arguments
+    @validate_call
     def plural_verb(
         self, text: Word, count: Optional[Union[str, int, Any]] = None
     ) -> str:
@@ -2453,7 +2416,7 @@ class engine:
         )
         return f"{pre}{plural}{post}"
 
-    @validate_arguments
+    @validate_call
     def plural_adj(
         self, text: Word, count: Optional[Union[str, int, Any]] = None
     ) -> str:
@@ -2474,7 +2437,7 @@ class engine:
         plural = self.postprocess(word, self._pl_special_adjective(word, count) or word)
         return f"{pre}{plural}{post}"
 
-    @validate_arguments
+    @validate_call
     def compare(self, word1: Word, word2: Word) -> Union[str, bool]:
         """
         compare word1 and word2 for equality regardless of plurality
@@ -2497,15 +2460,15 @@ class engine:
         >>> compare('egg', '')
         Traceback (most recent call last):
         ...
-        pydantic.error_wrappers.ValidationError: 1 validation error for Compare
-        word2
-          ensure this value has at least 1 characters...
+        pydantic...ValidationError: ...
+        ...
+          ...at least 1 characters...
         """
         norms = self.plural_noun, self.plural_verb, self.plural_adj
         results = (self._plequal(word1, word2, norm) for norm in norms)
         return next(filter(None, results), False)
 
-    @validate_arguments
+    @validate_call
     def compare_nouns(self, word1: Word, word2: Word) -> Union[str, bool]:
         """
         compare word1 and word2 for equality regardless of plurality
@@ -2521,7 +2484,7 @@ class engine:
         """
         return self._plequal(word1, word2, self.plural_noun)
 
-    @validate_arguments
+    @validate_call
     def compare_verbs(self, word1: Word, word2: Word) -> Union[str, bool]:
         """
         compare word1 and word2 for equality regardless of plurality
@@ -2537,7 +2500,7 @@ class engine:
         """
         return self._plequal(word1, word2, self.plural_verb)
 
-    @validate_arguments
+    @validate_call
     def compare_adjs(self, word1: Word, word2: Word) -> Union[str, bool]:
         """
         compare word1 and word2 for equality regardless of plurality
@@ -2553,13 +2516,13 @@ class engine:
         """
         return self._plequal(word1, word2, self.plural_adj)
 
-    @validate_arguments
+    @validate_call
     def singular_noun(
         self,
         text: Word,
         count: Optional[Union[int, str, Any]] = None,
         gender: Optional[str] = None,
-    ) -> Union[str, bool]:
+    ) -> Union[str, Literal[False]]:
         """
         Return the singular of text, where text is a plural noun.
 
@@ -2611,12 +2574,12 @@ class engine:
             return "s:p"
         self.classical_dict = classval.copy()
 
-        if pl == self.plural or pl == self.plural_noun:
+        if same_method(pl, self.plural) or same_method(pl, self.plural_noun):
             if self._pl_check_plurals_N(word1, word2):
                 return "p:p"
             if self._pl_check_plurals_N(word2, word1):
                 return "p:p"
-        if pl == self.plural or pl == self.plural_adj:
+        if same_method(pl, self.plural) or same_method(pl, self.plural_adj):
             if self._pl_check_plurals_adj(word1, word2):
                 return "p:p"
         return False
@@ -3266,11 +3229,11 @@ class engine:
 
         if words.last in si_sb_irregular_caps:
             llen = len(words.last)
-            return "{}{}".format(word[:-llen], si_sb_irregular_caps[words.last])
+            return f"{word[:-llen]}{si_sb_irregular_caps[words.last]}"
 
         if words.last.lower() in si_sb_irregular:
             llen = len(words.last.lower())
-            return "{}{}".format(word[:-llen], si_sb_irregular[words.last.lower()])
+            return f"{word[:-llen]}{si_sb_irregular[words.last.lower()]}"
 
         dash_split = words.lowered.split("-")
         if (" ".join(dash_split[-2:])).lower() in si_sb_irregular_compound:
@@ -3341,7 +3304,6 @@ class engine:
         # HANDLE INCOMPLETELY ASSIMILATED IMPORTS
 
         if self.classical_dict["ancient"]:
-
             if words.lowered[-6:] == "trices":
                 return word[:-3] + "x"
             if words.lowered[-4:] in ("eaux", "ieux"):
@@ -3459,7 +3421,6 @@ class engine:
         # HANDLE ...o
 
         if words.lowered[-2:] == "os":
-
             if words.last.lower() in si_sb_U_o_os_complete:
                 return word[:-1]
 
@@ -3489,7 +3450,7 @@ class engine:
 
     # ADJECTIVES
 
-    @validate_arguments
+    @validate_call
     def a(self, text: Word, count: Optional[Union[int, str, Any]] = 1) -> str:
         """
         Return the appropriate indefinite article followed by text.
@@ -3570,7 +3531,7 @@ class engine:
 
     # 2. TRANSLATE ZERO-QUANTIFIED $word TO "no plural($word)"
 
-    @validate_arguments
+    @validate_call
     def no(self, text: Word, count: Optional[Union[int, str]] = None) -> str:
         """
         If count is 0, no, zero or nil, return 'no' followed by the plural
@@ -3608,7 +3569,7 @@ class engine:
 
     # PARTICIPLES
 
-    @validate_arguments
+    @validate_call
     def present_participle(self, word: Word) -> str:
         """
         Return the present participle for word.
@@ -3627,31 +3588,31 @@ class engine:
 
     # NUMERICAL INFLECTIONS
 
-    @validate_arguments
-    def ordinal(self, num: Union[int, Word]) -> str:  # noqa: C901
+    @validate_call(config=dict(arbitrary_types_allowed=True))
+    def ordinal(self, num: Union[Number, Word]) -> str:
         """
         Return the ordinal of num.
 
-        num can be an integer or text
-
-        e.g. ordinal(1) returns '1st'
-        ordinal('one') returns 'first'
-
+        >>> ordinal = engine().ordinal
+        >>> ordinal(1)
+        '1st'
+        >>> ordinal('one')
+        'first'
         """
         if DIGIT.match(str(num)):
-            if isinstance(num, (int, float)):
+            if isinstance(num, (float, int)) and int(num) == num:
                 n = int(num)
             else:
                 if "." in str(num):
                     try:
                         # numbers after decimal,
                         # so only need last one for ordinal
-                        n = int(num[-1])
+                        n = int(str(num)[-1])
 
                     except ValueError:  # ends with '.', so need to use whole string
-                        n = int(num[:-1])
+                        n = int(str(num)[:-1])
                 else:
-                    n = int(num)
+                    n = int(num)  # type: ignore
             try:
                 post = nth[n % 100]
             except KeyError:
@@ -3660,7 +3621,7 @@ class engine:
         else:
             # Mad props to Damian Conway (?) whose ordinal()
             # algorithm is type-bendy enough to foil MyPy
-            str_num: str = num  # type:	ignore[assignment]
+            str_num: str = num  # type: ignore[assignment]
             mo = ordinal_suff.search(str_num)
             if mo:
                 post = ordinal[mo.group(1)]
@@ -3671,7 +3632,6 @@ class engine:
 
     def millfn(self, ind: int = 0) -> str:
         if ind > len(mill) - 1:
-            print3("number out of range")
             raise NumOutOfRangeError
         return mill[ind]
 
@@ -3787,7 +3747,7 @@ class engine:
             num = ONE_DIGIT_WORD.sub(self.unitsub, num, 1)
         return num
 
-    @validate_arguments(config=dict(arbitrary_types_allowed=True))  # noqa: C901
+    @validate_call(config=dict(arbitrary_types_allowed=True))  # noqa: C901
     def number_to_words(  # noqa: C901
         self,
         num: Union[Number, Word],
@@ -3939,7 +3899,7 @@ class engine:
 
     # Join words with commas and a trailing 'and' (when appropriate)...
 
-    @validate_arguments
+    @validate_call
     def join(
         self,
         words: Optional[Sequence[Word]],
diff --git a/lib/inflect/compat/__init__.py b/lib/inflect/compat/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/lib/inflect/compat/pydantic.py b/lib/inflect/compat/pydantic.py
new file mode 100644
index 00000000..d777564a
--- /dev/null
+++ b/lib/inflect/compat/pydantic.py
@@ -0,0 +1,19 @@
+class ValidateCallWrapperWrapper:
+    def __init__(self, wrapped):
+        self.orig = wrapped
+
+    def __eq__(self, other):
+        return self.raw_function == other.raw_function
+
+    @property
+    def raw_function(self):
+        return getattr(self.orig, 'raw_function') or self.orig
+
+
+def same_method(m1, m2) -> bool:
+    """
+    Return whether m1 and m2 are the same method.
+
+    Workaround for pydantic/pydantic#6390.
+    """
+    return ValidateCallWrapperWrapper(m1) == ValidateCallWrapperWrapper(m2)
diff --git a/lib/inflect/compat/pydantic1.py b/lib/inflect/compat/pydantic1.py
new file mode 100644
index 00000000..8262fdcf
--- /dev/null
+++ b/lib/inflect/compat/pydantic1.py
@@ -0,0 +1,8 @@
+try:
+    from pydantic import validate_call  # type: ignore
+except ImportError:
+    # Pydantic 1
+    from pydantic import validate_arguments as validate_call  # type: ignore
+
+
+__all__ = ['validate_call']
diff --git a/lib/jaraco/collections.py b/lib/jaraco/collections/__init__.py
similarity index 88%
rename from lib/jaraco/collections.py
rename to lib/jaraco/collections/__init__.py
index db89b122..abedf002 100644
--- a/lib/jaraco/collections.py
+++ b/lib/jaraco/collections/__init__.py
@@ -5,23 +5,49 @@ import itertools
 import copy
 import functools
 import random
+from collections.abc import Container, Iterable, Mapping
+from typing import Callable, Union
 
-from jaraco.classes.properties import NonDataProperty
 import jaraco.text
 
 
+_Matchable = Union[Callable, Container, Iterable, re.Pattern]
+
+
+def _dispatch(obj: _Matchable) -> Callable:
+    # can't rely on singledispatch for Union[Container, Iterable]
+    # due to ambiguity
+    # (https://peps.python.org/pep-0443/#abstract-base-classes).
+    if isinstance(obj, re.Pattern):
+        return obj.fullmatch
+    if not isinstance(obj, Callable):  # type: ignore
+        if not isinstance(obj, Container):
+            obj = set(obj)  # type: ignore
+        obj = obj.__contains__
+    return obj  # type: ignore
+
+
 class Projection(collections.abc.Mapping):
     """
     Project a set of keys over a mapping
 
     >>> sample = {'a': 1, 'b': 2, 'c': 3}
     >>> prj = Projection(['a', 'c', 'd'], sample)
-    >>> prj == {'a': 1, 'c': 3}
+    >>> dict(prj)
+    {'a': 1, 'c': 3}
+
+    Projection also accepts an iterable or callable or pattern.
+
+    >>> iter_prj = Projection(iter('acd'), sample)
+    >>> call_prj = Projection(lambda k: ord(k) in (97, 99, 100), sample)
+    >>> pat_prj = Projection(re.compile(r'[acd]'), sample)
+    >>> prj == iter_prj == call_prj == pat_prj
     True
 
     Keys should only appear if they were specified and exist in the space.
+    Order is retained.
 
-    >>> sorted(list(prj.keys()))
+    >>> list(prj)
     ['a', 'c']
 
     Attempting to access a key not in the projection
@@ -36,119 +62,58 @@ class Projection(collections.abc.Mapping):
 
     >>> target = {'a': 2, 'b': 2}
     >>> target.update(prj)
-    >>> target == {'a': 1, 'b': 2, 'c': 3}
-    True
+    >>> target
+    {'a': 1, 'b': 2, 'c': 3}
 
-    Also note that Projection keeps a reference to the original dict, so
-    if you modify the original dict, that could modify the Projection.
+    Projection keeps a reference to the original dict, so
+    modifying the original dict may modify the Projection.
 
     >>> del sample['a']
     >>> dict(prj)
     {'c': 3}
     """
 
-    def __init__(self, keys, space):
-        self._keys = tuple(keys)
+    def __init__(self, keys: _Matchable, space: Mapping):
+        self._match = _dispatch(keys)
         self._space = space
 
     def __getitem__(self, key):
-        if key not in self._keys:
+        if not self._match(key):
             raise KeyError(key)
         return self._space[key]
 
+    def _keys_resolved(self):
+        return filter(self._match, self._space)
+
     def __iter__(self):
-        return iter(set(self._keys).intersection(self._space))
+        return self._keys_resolved()
 
     def __len__(self):
-        return len(tuple(iter(self)))
+        return len(tuple(self._keys_resolved()))
 
 
-class DictFilter(collections.abc.Mapping):
+class Mask(Projection):
     """
-    Takes a dict, and simulates a sub-dict based on the keys.
+    The inverse of a :class:`Projection`, masking out keys.
 
     >>> sample = {'a': 1, 'b': 2, 'c': 3}
-    >>> filtered = DictFilter(sample, ['a', 'c'])
-    >>> filtered == {'a': 1, 'c': 3}
-    True
-    >>> set(filtered.values()) == {1, 3}
-    True
-    >>> set(filtered.items()) == {('a', 1), ('c', 3)}
-    True
-
-    One can also filter by a regular expression pattern
-
-    >>> sample['d'] = 4
-    >>> sample['ef'] = 5
-
-    Here we filter for only single-character keys
-
-    >>> filtered = DictFilter(sample, include_pattern='.$')
-    >>> filtered == {'a': 1, 'b': 2, 'c': 3, 'd': 4}
-    True
-
-    >>> filtered['e']
-    Traceback (most recent call last):
-    ...
-    KeyError: 'e'
-
-    >>> 'e' in filtered
-    False
-
-    Pattern is useful for excluding keys with a prefix.
-
-    >>> filtered = DictFilter(sample, include_pattern=r'(?![ace])')
-    >>> dict(filtered)
-    {'b': 2, 'd': 4}
-
-    Also note that DictFilter keeps a reference to the original dict, so
-    if you modify the original dict, that could modify the filtered dict.
-
-    >>> del sample['d']
-    >>> dict(filtered)
+    >>> msk = Mask(['a', 'c', 'd'], sample)
+    >>> dict(msk)
     {'b': 2}
     """
 
-    def __init__(self, dict, include_keys=[], include_pattern=None):
-        self.dict = dict
-        self.specified_keys = set(include_keys)
-        if include_pattern is not None:
-            self.include_pattern = re.compile(include_pattern)
-        else:
-            # for performance, replace the pattern_keys property
-            self.pattern_keys = set()
-
-    def get_pattern_keys(self):
-        keys = filter(self.include_pattern.match, self.dict.keys())
-        return set(keys)
-
-    pattern_keys = NonDataProperty(get_pattern_keys)
-
-    @property
-    def include_keys(self):
-        return self.specified_keys | self.pattern_keys
-
-    def __getitem__(self, i):
-        if i not in self.include_keys:
-            raise KeyError(i)
-        return self.dict[i]
-
-    def __iter__(self):
-        return filter(self.include_keys.__contains__, self.dict.keys())
-
-    def __len__(self):
-        return len(list(self))
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        # self._match = compose(operator.not_, self._match)
+        self._match = lambda key, orig=self._match: not orig(key)
 
 
 def dict_map(function, dictionary):
     """
-    dict_map is much like the built-in function map.  It takes a dictionary
-    and applys a function to the values of that dictionary, returning a
-    new dictionary with the mapped values in the original keys.
+    Return a new dict with function applied to values of dictionary.
 
-    >>> d = dict_map(lambda x:x+1, dict(a=1, b=2))
-    >>> d == dict(a=2,b=3)
-    True
+    >>> dict_map(lambda x: x+1, dict(a=1, b=2))
+    {'a': 2, 'b': 3}
     """
     return dict((key, function(value)) for key, value in dictionary.items())
 
@@ -164,7 +129,7 @@ class RangeMap(dict):
     One may supply keyword parameters to be passed to the sort function used
     to sort keys (i.e. key, reverse) as sort_params.
 
-    Let's create a map that maps 1-3 -> 'a', 4-6 -> 'b'
+    Create a map that maps 1-3 -> 'a', 4-6 -> 'b'
 
     >>> r = RangeMap({3: 'a', 6: 'b'})  # boy, that was easy
     >>> r[1], r[2], r[3], r[4], r[5], r[6]
@@ -176,7 +141,7 @@ class RangeMap(dict):
     >>> r[4.5]
     'b'
 
-    But you'll notice that the way rangemap is defined, it must be open-ended
+    Notice that the way rangemap is defined, it must be open-ended
     on one side.
 
     >>> r[0]
@@ -279,7 +244,7 @@ class RangeMap(dict):
         return (sorted_keys[RangeMap.first_item], sorted_keys[RangeMap.last_item])
 
     # some special values for the RangeMap
-    undefined_value = type(str('RangeValueUndefined'), (), {})()
+    undefined_value = type('RangeValueUndefined', (), {})()
 
     class Item(int):
         "RangeMap Item"
@@ -294,7 +259,7 @@ def __identity(x):
 
 def sorted_items(d, key=__identity, reverse=False):
     """
-    Return the items of the dictionary sorted by the keys
+    Return the items of the dictionary sorted by the keys.
 
     >>> sample = dict(foo=20, bar=42, baz=10)
     >>> tuple(sorted_items(sample))
@@ -307,6 +272,7 @@ def sorted_items(d, key=__identity, reverse=False):
     >>> tuple(sorted_items(sample, reverse=True))
     (('foo', 20), ('baz', 10), ('bar', 42))
     """
+
     # wrap the key func so it operates on the first element of each item
     def pairkey_key(item):
         return key(item[0])
@@ -475,7 +441,7 @@ class ItemsAsAttributes:
     Mix-in class to enable a mapping object to provide items as
     attributes.
 
-    >>> C = type(str('C'), (dict, ItemsAsAttributes), dict())
+    >>> C = type('C', (dict, ItemsAsAttributes), dict())
     >>> i = C()
     >>> i['foo'] = 'bar'
     >>> i.foo
@@ -504,7 +470,7 @@ class ItemsAsAttributes:
 
     >>> missing_func = lambda self, key: 'missing item'
     >>> C = type(
-    ...     str('C'),
+    ...     'C',
     ...     (dict, ItemsAsAttributes),
     ...     dict(__missing__ = missing_func),
     ... )
diff --git a/lib/jaraco/collections/py.typed b/lib/jaraco/collections/py.typed
new file mode 100644
index 00000000..e69de29b
diff --git a/lib/jaraco/context.py b/lib/jaraco/context.py
index 87a4e3dc..b0d1ef37 100644
--- a/lib/jaraco/context.py
+++ b/lib/jaraco/context.py
@@ -5,10 +5,18 @@ import functools
 import tempfile
 import shutil
 import operator
+import warnings
 
 
 @contextlib.contextmanager
 def pushd(dir):
+    """
+    >>> tmp_path = getfixture('tmp_path')
+    >>> with pushd(tmp_path):
+    ...     assert os.getcwd() == os.fspath(tmp_path)
+    >>> assert os.getcwd() != os.fspath(tmp_path)
+    """
+
     orig = os.getcwd()
     os.chdir(dir)
     try:
@@ -29,6 +37,8 @@ def tarball_context(url, target_dir=None, runner=None, pushd=pushd):
         target_dir = os.path.basename(url).replace('.tar.gz', '').replace('.tgz', '')
     if runner is None:
         runner = functools.partial(subprocess.check_call, shell=True)
+    else:
+        warnings.warn("runner parameter is deprecated", DeprecationWarning)
     # In the tar command, use --strip-components=1 to strip the first path and
     #  then
     #  use -C to cause the files to be extracted to {target_dir}. This ensures
@@ -48,6 +58,15 @@ def tarball_context(url, target_dir=None, runner=None, pushd=pushd):
 def infer_compression(url):
     """
     Given a URL or filename, infer the compression code for tar.
+
+    >>> infer_compression('http://foo/bar.tar.gz')
+    'z'
+    >>> infer_compression('http://foo/bar.tgz')
+    'z'
+    >>> infer_compression('file.bz')
+    'j'
+    >>> infer_compression('file.xz')
+    'J'
     """
     # cheat and just assume it's the last two characters
     compression_indicator = url[-2:]
@@ -61,6 +80,12 @@ def temp_dir(remover=shutil.rmtree):
     """
     Create a temporary directory context. Pass a custom remover
     to override the removal behavior.
+
+    >>> import pathlib
+    >>> with temp_dir() as the_dir:
+    ...     assert os.path.isdir(the_dir)
+    ...     _ = pathlib.Path(the_dir).joinpath('somefile').write_text('contents')
+    >>> assert not os.path.exists(the_dir)
     """
     temp_dir = tempfile.mkdtemp()
     try:
@@ -90,6 +115,12 @@ def repo_context(url, branch=None, quiet=True, dest_ctx=temp_dir):
 
 @contextlib.contextmanager
 def null():
+    """
+    A null context suitable to stand in for a meaningful context.
+
+    >>> with null() as value:
+    ...     assert value is None
+    """
     yield
 
 
@@ -112,6 +143,10 @@ class ExceptionTrap:
     ...     raise ValueError("1 + 1 is not 3")
     >>> bool(trap)
     True
+    >>> trap.value
+    ValueError('1 + 1 is not 3')
+    >>> trap.tb
+    <traceback object at ...>
 
     >>> with ExceptionTrap(ValueError) as trap:
     ...     raise Exception()
@@ -211,3 +246,43 @@ class suppress(contextlib.suppress, contextlib.ContextDecorator):
     ...     {}['']
     >>> key_error()
     """
+
+
+class on_interrupt(contextlib.ContextDecorator):
+    """
+    Replace a KeyboardInterrupt with SystemExit(1)
+
+    >>> def do_interrupt():
+    ...     raise KeyboardInterrupt()
+    >>> on_interrupt('error')(do_interrupt)()
+    Traceback (most recent call last):
+    ...
+    SystemExit: 1
+    >>> on_interrupt('error', code=255)(do_interrupt)()
+    Traceback (most recent call last):
+    ...
+    SystemExit: 255
+    >>> on_interrupt('suppress')(do_interrupt)()
+    >>> with __import__('pytest').raises(KeyboardInterrupt):
+    ...     on_interrupt('ignore')(do_interrupt)()
+    """
+
+    def __init__(
+        self,
+        action='error',
+        # py3.7 compat
+        # /,
+        code=1,
+    ):
+        self.action = action
+        self.code = code
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, exctype, excinst, exctb):
+        if exctype is not KeyboardInterrupt or self.action == 'ignore':
+            return
+        elif self.action == 'error':
+            raise SystemExit(self.code) from excinst
+        return self.action == 'suppress'
diff --git a/lib/jaraco/functools.py b/lib/jaraco/functools/__init__.py
similarity index 84%
rename from lib/jaraco/functools.py
rename to lib/jaraco/functools/__init__.py
index 43c009f9..ca6c22fa 100644
--- a/lib/jaraco/functools.py
+++ b/lib/jaraco/functools/__init__.py
@@ -1,4 +1,4 @@
-import collections
+import collections.abc
 import functools
 import inspect
 import itertools
@@ -9,11 +9,6 @@ import warnings
 
 import more_itertools
 
-from typing import Callable, TypeVar
-
-
-CallableT = TypeVar("CallableT", bound=Callable[..., object])
-
 
 def compose(*funcs):
     """
@@ -39,24 +34,6 @@ def compose(*funcs):
     return functools.reduce(compose_two, funcs)
 
 
-def method_caller(method_name, *args, **kwargs):
-    """
-    Return a function that will call a named method on the
-    target object with optional positional and keyword
-    arguments.
-
-    >>> lower = method_caller('lower')
-    >>> lower('MyString')
-    'mystring'
-    """
-
-    def call_method(target):
-        func = getattr(target, method_name)
-        return func(*args, **kwargs)
-
-    return call_method
-
-
 def once(func):
     """
     Decorate func so it's only ever called the first time.
@@ -99,12 +76,7 @@ def once(func):
     return wrapper
 
 
-def method_cache(
-    method: CallableT,
-    cache_wrapper: Callable[
-        [CallableT], CallableT
-    ] = functools.lru_cache(),  # type: ignore[assignment]
-) -> CallableT:
+def method_cache(method, cache_wrapper=functools.lru_cache()):
     """
     Wrap lru_cache to support storing the cache data in the object instances.
 
@@ -172,22 +144,17 @@ def method_cache(
     for another implementation and additional justification.
     """
 
-    def wrapper(self: object, *args: object, **kwargs: object) -> object:
+    def wrapper(self, *args, **kwargs):
         # it's the first call, replace the method with a cached, bound method
-        bound_method: CallableT = types.MethodType(  # type: ignore[assignment]
-            method, self
-        )
+        bound_method = types.MethodType(method, self)
         cached_method = cache_wrapper(bound_method)
         setattr(self, method.__name__, cached_method)
         return cached_method(*args, **kwargs)
 
     # Support cache clear even before cache has been created.
-    wrapper.cache_clear = lambda: None  # type: ignore[attr-defined]
+    wrapper.cache_clear = lambda: None
 
-    return (
-        _special_method_cache(method, cache_wrapper)  # type: ignore[return-value]
-        or wrapper
-    )
+    return _special_method_cache(method, cache_wrapper) or wrapper
 
 
 def _special_method_cache(method, cache_wrapper):
@@ -203,12 +170,13 @@ def _special_method_cache(method, cache_wrapper):
     """
     name = method.__name__
     special_names = '__getattr__', '__getitem__'
+
     if name not in special_names:
-        return
+        return None
 
     wrapper_name = '__cached' + name
 
-    def proxy(self, *args, **kwargs):
+    def proxy(self, /, *args, **kwargs):
         if wrapper_name not in vars(self):
             bound = types.MethodType(method, self)
             cache = cache_wrapper(bound)
@@ -245,7 +213,7 @@ def result_invoke(action):
     r"""
     Decorate a function with an action function that is
     invoked on the results returned from the decorated
-    function (for its side-effect), then return the original
+    function (for its side effect), then return the original
     result.
 
     >>> @result_invoke(print)
@@ -269,7 +237,7 @@ def result_invoke(action):
     return wrap
 
 
-def invoke(f, *args, **kwargs):
+def invoke(f, /, *args, **kwargs):
     """
     Call a function for its side effect after initialization.
 
@@ -304,25 +272,15 @@ def invoke(f, *args, **kwargs):
     Use functools.partial to pass parameters to the initial call
 
     >>> @functools.partial(invoke, name='bingo')
-    ... def func(name): print("called with", name)
+    ... def func(name): print('called with', name)
     called with bingo
     """
     f(*args, **kwargs)
     return f
 
 
-def call_aside(*args, **kwargs):
-    """
-    Deprecated name for invoke.
-    """
-    warnings.warn("call_aside is deprecated, use invoke", DeprecationWarning)
-    return invoke(*args, **kwargs)
-
-
 class Throttler:
-    """
-    Rate-limit a function (or other callable)
-    """
+    """Rate-limit a function (or other callable)."""
 
     def __init__(self, func, max_rate=float('Inf')):
         if isinstance(func, Throttler):
@@ -339,20 +297,20 @@ class Throttler:
         return self.func(*args, **kwargs)
 
     def _wait(self):
-        "ensure at least 1/max_rate seconds from last call"
+        """Ensure at least 1/max_rate seconds from last call."""
         elapsed = time.time() - self.last_called
         must_wait = 1 / self.max_rate - elapsed
         time.sleep(max(0, must_wait))
         self.last_called = time.time()
 
-    def __get__(self, obj, type=None):
+    def __get__(self, obj, owner=None):
         return first_invoke(self._wait, functools.partial(self.func, obj))
 
 
 def first_invoke(func1, func2):
     """
     Return a function that when invoked will invoke func1 without
-    any parameters (for its side-effect) and then invoke func2
+    any parameters (for its side effect) and then invoke func2
     with whatever parameters were passed, returning its result.
     """
 
@@ -363,6 +321,17 @@ def first_invoke(func1, func2):
     return wrapper
 
 
+method_caller = first_invoke(
+    lambda: warnings.warn(
+        '`jaraco.functools.method_caller` is deprecated, '
+        'use `operator.methodcaller` instead',
+        DeprecationWarning,
+        stacklevel=3,
+    ),
+    operator.methodcaller,
+)
+
+
 def retry_call(func, cleanup=lambda: None, retries=0, trap=()):
     """
     Given a callable func, trap the indicated exceptions
@@ -371,7 +340,7 @@ def retry_call(func, cleanup=lambda: None, retries=0, trap=()):
     to propagate.
     """
     attempts = itertools.count() if retries == float('inf') else range(retries)
-    for attempt in attempts:
+    for _ in attempts:
         try:
             return func()
         except trap:
@@ -408,7 +377,7 @@ def retry(*r_args, **r_kwargs):
 
 def print_yielded(func):
     """
-    Convert a generator into a function that prints all yielded elements
+    Convert a generator into a function that prints all yielded elements.
 
     >>> @print_yielded
     ... def x():
@@ -424,7 +393,7 @@ def print_yielded(func):
 
 def pass_none(func):
     """
-    Wrap func so it's not called if its first param is None
+    Wrap func so it's not called if its first param is None.
 
     >>> print_text = pass_none(print)
     >>> print_text('text')
@@ -433,9 +402,10 @@ def pass_none(func):
     """
 
     @functools.wraps(func)
-    def wrapper(param, *args, **kwargs):
+    def wrapper(param, /, *args, **kwargs):
         if param is not None:
             return func(param, *args, **kwargs)
+        return None
 
     return wrapper
 
@@ -509,7 +479,7 @@ def save_method_args(method):
     args_and_kwargs = collections.namedtuple('args_and_kwargs', 'args kwargs')
 
     @functools.wraps(method)
-    def wrapper(self, *args, **kwargs):
+    def wrapper(self, /, *args, **kwargs):
         attr_name = '_saved_' + method.__name__
         attr = args_and_kwargs(args, kwargs)
         setattr(self, attr_name, attr)
@@ -559,6 +529,13 @@ def except_(*exceptions, replace=None, use=None):
 
 
 def identity(x):
+    """
+    Return the argument.
+
+    >>> o = object()
+    >>> identity(o) is o
+    True
+    """
     return x
 
 
@@ -580,7 +557,7 @@ def bypass_when(check, *, _op=identity):
 
     def decorate(func):
         @functools.wraps(func)
-        def wrapper(param):
+        def wrapper(param, /):
             return param if _op(check) else func(param)
 
         return wrapper
@@ -604,3 +581,53 @@ def bypass_unless(check):
     2
     """
     return bypass_when(check, _op=operator.not_)
+
+
+@functools.singledispatch
+def _splat_inner(args, func):
+    """Splat args to func."""
+    return func(*args)
+
+
+@_splat_inner.register
+def _(args: collections.abc.Mapping, func):
+    """Splat kargs to func as kwargs."""
+    return func(**args)
+
+
+def splat(func):
+    """
+    Wrap func to expect its parameters to be passed positionally in a tuple.
+
+    Has a similar effect to that of ``itertools.starmap`` over
+    simple ``map``.
+
+    >>> pairs = [(-1, 1), (0, 2)]
+    >>> more_itertools.consume(itertools.starmap(print, pairs))
+    -1 1
+    0 2
+    >>> more_itertools.consume(map(splat(print), pairs))
+    -1 1
+    0 2
+
+    The approach generalizes to other iterators that don't have a "star"
+    equivalent, such as a "starfilter".
+
+    >>> list(filter(splat(operator.add), pairs))
+    [(0, 2)]
+
+    Splat also accepts a mapping argument.
+
+    >>> def is_nice(msg, code):
+    ...     return "smile" in msg or code == 0
+    >>> msgs = [
+    ...     dict(msg='smile!', code=20),
+    ...     dict(msg='error :(', code=1),
+    ...     dict(msg='unknown', code=0),
+    ... ]
+    >>> for msg in filter(splat(is_nice), msgs):
+    ...     print(msg)
+    {'msg': 'smile!', 'code': 20}
+    {'msg': 'unknown', 'code': 0}
+    """
+    return functools.wraps(func)(functools.partial(_splat_inner, func=func))
diff --git a/lib/jaraco/functools/__init__.pyi b/lib/jaraco/functools/__init__.pyi
new file mode 100644
index 00000000..c2b9ab17
--- /dev/null
+++ b/lib/jaraco/functools/__init__.pyi
@@ -0,0 +1,128 @@
+from collections.abc import Callable, Hashable, Iterator
+from functools import partial
+from operator import methodcaller
+import sys
+from typing import (
+    Any,
+    Generic,
+    Protocol,
+    TypeVar,
+    overload,
+)
+
+if sys.version_info >= (3, 10):
+    from typing import Concatenate, ParamSpec
+else:
+    from typing_extensions import Concatenate, ParamSpec
+
+_P = ParamSpec('_P')
+_R = TypeVar('_R')
+_T = TypeVar('_T')
+_R1 = TypeVar('_R1')
+_R2 = TypeVar('_R2')
+_V = TypeVar('_V')
+_S = TypeVar('_S')
+_R_co = TypeVar('_R_co', covariant=True)
+
+class _OnceCallable(Protocol[_P, _R]):
+    saved_result: _R
+    reset: Callable[[], None]
+    def __call__(self, *args: _P.args, **kwargs: _P.kwargs) -> _R: ...
+
+class _ProxyMethodCacheWrapper(Protocol[_R_co]):
+    cache_clear: Callable[[], None]
+    def __call__(self, *args: Hashable, **kwargs: Hashable) -> _R_co: ...
+
+class _MethodCacheWrapper(Protocol[_R_co]):
+    def cache_clear(self) -> None: ...
+    def __call__(self, *args: Hashable, **kwargs: Hashable) -> _R_co: ...
+
+# `compose()` overloads below will cover most use cases.
+
+@overload
+def compose(
+    __func1: Callable[[_R], _T],
+    __func2: Callable[_P, _R],
+    /,
+) -> Callable[_P, _T]: ...
+@overload
+def compose(
+    __func1: Callable[[_R], _T],
+    __func2: Callable[[_R1], _R],
+    __func3: Callable[_P, _R1],
+    /,
+) -> Callable[_P, _T]: ...
+@overload
+def compose(
+    __func1: Callable[[_R], _T],
+    __func2: Callable[[_R2], _R],
+    __func3: Callable[[_R1], _R2],
+    __func4: Callable[_P, _R1],
+    /,
+) -> Callable[_P, _T]: ...
+def once(func: Callable[_P, _R]) -> _OnceCallable[_P, _R]: ...
+def method_cache(
+    method: Callable[..., _R],
+    cache_wrapper: Callable[[Callable[..., _R]], _MethodCacheWrapper[_R]] = ...,
+) -> _MethodCacheWrapper[_R] | _ProxyMethodCacheWrapper[_R]: ...
+def apply(
+    transform: Callable[[_R], _T]
+) -> Callable[[Callable[_P, _R]], Callable[_P, _T]]: ...
+def result_invoke(
+    action: Callable[[_R], Any]
+) -> Callable[[Callable[_P, _R]], Callable[_P, _R]]: ...
+def invoke(
+    f: Callable[_P, _R], /, *args: _P.args, **kwargs: _P.kwargs
+) -> Callable[_P, _R]: ...
+def call_aside(
+    f: Callable[_P, _R], *args: _P.args, **kwargs: _P.kwargs
+) -> Callable[_P, _R]: ...
+
+class Throttler(Generic[_R]):
+    last_called: float
+    func: Callable[..., _R]
+    max_rate: float
+    def __init__(
+        self, func: Callable[..., _R] | Throttler[_R], max_rate: float = ...
+    ) -> None: ...
+    def reset(self) -> None: ...
+    def __call__(self, *args: Any, **kwargs: Any) -> _R: ...
+    def __get__(self, obj: Any, owner: type[Any] | None = ...) -> Callable[..., _R]: ...
+
+def first_invoke(
+    func1: Callable[..., Any], func2: Callable[_P, _R]
+) -> Callable[_P, _R]: ...
+
+method_caller: Callable[..., methodcaller]
+
+def retry_call(
+    func: Callable[..., _R],
+    cleanup: Callable[..., None] = ...,
+    retries: int | float = ...,
+    trap: type[BaseException] | tuple[type[BaseException], ...] = ...,
+) -> _R: ...
+def retry(
+    cleanup: Callable[..., None] = ...,
+    retries: int | float = ...,
+    trap: type[BaseException] | tuple[type[BaseException], ...] = ...,
+) -> Callable[[Callable[..., _R]], Callable[..., _R]]: ...
+def print_yielded(func: Callable[_P, Iterator[Any]]) -> Callable[_P, None]: ...
+def pass_none(
+    func: Callable[Concatenate[_T, _P], _R]
+) -> Callable[Concatenate[_T, _P], _R]: ...
+def assign_params(
+    func: Callable[..., _R], namespace: dict[str, Any]
+) -> partial[_R]: ...
+def save_method_args(
+    method: Callable[Concatenate[_S, _P], _R]
+) -> Callable[Concatenate[_S, _P], _R]: ...
+def except_(
+    *exceptions: type[BaseException], replace: Any = ..., use: Any = ...
+) -> Callable[[Callable[_P, Any]], Callable[_P, Any]]: ...
+def identity(x: _T) -> _T: ...
+def bypass_when(
+    check: _V, *, _op: Callable[[_V], Any] = ...
+) -> Callable[[Callable[[_T], _R]], Callable[[_T], _T | _R]]: ...
+def bypass_unless(
+    check: Any,
+) -> Callable[[Callable[[_T], _R]], Callable[[_T], _T | _R]]: ...
diff --git a/lib/jaraco/functools/py.typed b/lib/jaraco/functools/py.typed
new file mode 100644
index 00000000..e69de29b
diff --git a/lib/jaraco/text/__init__.py b/lib/jaraco/text/__init__.py
index e51101c2..0fabd0c3 100644
--- a/lib/jaraco/text/__init__.py
+++ b/lib/jaraco/text/__init__.py
@@ -227,10 +227,12 @@ def unwrap(s):
     return '\n'.join(cleaned)
 
 
-lorem_ipsum: str = files(__name__).joinpath('Lorem ipsum.txt').read_text()
+lorem_ipsum: str = (
+    files(__name__).joinpath('Lorem ipsum.txt').read_text(encoding='utf-8')
+)
 
 
-class Splitter(object):
+class Splitter:
     """object that will split a string with the given arguments for each call
 
     >>> s = Splitter(',')
@@ -367,7 +369,7 @@ class WordSet(tuple):
         return self.trim_left(item).trim_right(item)
 
     def __getitem__(self, item):
-        result = super(WordSet, self).__getitem__(item)
+        result = super().__getitem__(item)
         if isinstance(item, slice):
             result = WordSet(result)
         return result
@@ -582,7 +584,7 @@ def join_continuation(lines):
     ['foobarbaz']
 
     Not sure why, but...
-    The character preceeding the backslash is also elided.
+    The character preceding the backslash is also elided.
 
     >>> list(join_continuation(['goo\\', 'dly']))
     ['godly']
@@ -607,16 +609,16 @@ def read_newlines(filename, limit=1024):
     r"""
     >>> tmp_path = getfixture('tmp_path')
     >>> filename = tmp_path / 'out.txt'
-    >>> _ = filename.write_text('foo\n', newline='')
+    >>> _ = filename.write_text('foo\n', newline='', encoding='utf-8')
     >>> read_newlines(filename)
     '\n'
-    >>> _ = filename.write_text('foo\r\n', newline='')
+    >>> _ = filename.write_text('foo\r\n', newline='', encoding='utf-8')
     >>> read_newlines(filename)
     '\r\n'
-    >>> _ = filename.write_text('foo\r\nbar\nbing\r', newline='')
+    >>> _ = filename.write_text('foo\r\nbar\nbing\r', newline='', encoding='utf-8')
     >>> read_newlines(filename)
     ('\r', '\n', '\r\n')
     """
-    with open(filename) as fp:
+    with open(filename, encoding='utf-8') as fp:
         fp.read(limit)
     return fp.newlines
diff --git a/lib/jaraco/text/show-newlines.py b/lib/jaraco/text/show-newlines.py
index 2ba32062..e11d1ba4 100644
--- a/lib/jaraco/text/show-newlines.py
+++ b/lib/jaraco/text/show-newlines.py
@@ -12,11 +12,11 @@ def report_newlines(filename):
 
     >>> tmp_path = getfixture('tmp_path')
     >>> filename = tmp_path / 'out.txt'
-    >>> _ = filename.write_text('foo\nbar\n', newline='')
+    >>> _ = filename.write_text('foo\nbar\n', newline='', encoding='utf-8')
     >>> report_newlines(filename)
     newline is '\n'
     >>> filename = tmp_path / 'out.txt'
-    >>> _ = filename.write_text('foo\nbar\r\n', newline='')
+    >>> _ = filename.write_text('foo\nbar\r\n', newline='', encoding='utf-8')
     >>> report_newlines(filename)
     newlines are ('\n', '\r\n')
     """
diff --git a/lib/jaraco/text/strip-prefix.py b/lib/jaraco/text/strip-prefix.py
new file mode 100644
index 00000000..761717a9
--- /dev/null
+++ b/lib/jaraco/text/strip-prefix.py
@@ -0,0 +1,21 @@
+import sys
+
+import autocommand
+
+from jaraco.text import Stripper
+
+
+def strip_prefix():
+    r"""
+    Strip any common prefix from stdin.
+
+    >>> import io, pytest
+    >>> getfixture('monkeypatch').setattr('sys.stdin', io.StringIO('abcdef\nabc123'))
+    >>> strip_prefix()
+    def
+    123
+    """
+    sys.stdout.writelines(Stripper.strip_prefix(sys.stdin).lines)
+
+
+autocommand.autocommand(__name__)(strip_prefix)
diff --git a/lib/more_itertools/__init__.py b/lib/more_itertools/__init__.py
index 28ffadcf..aff94a9a 100644
--- a/lib/more_itertools/__init__.py
+++ b/lib/more_itertools/__init__.py
@@ -3,4 +3,4 @@
 from .more import *  # noqa
 from .recipes import *  # noqa
 
-__version__ = '10.1.0'
+__version__ = '10.2.0'
diff --git a/lib/more_itertools/more.py b/lib/more_itertools/more.py
index 59c2f1a4..dd711a47 100755
--- a/lib/more_itertools/more.py
+++ b/lib/more_itertools/more.py
@@ -19,7 +19,7 @@ from itertools import (
     zip_longest,
     product,
 )
-from math import exp, factorial, floor, log
+from math import exp, factorial, floor, log, perm, comb
 from queue import Empty, Queue
 from random import random, randrange, uniform
 from operator import itemgetter, mul, sub, gt, lt, ge, le
@@ -68,8 +68,10 @@ __all__ = [
     'divide',
     'duplicates_everseen',
     'duplicates_justseen',
+    'classify_unique',
     'exactly_n',
     'filter_except',
+    'filter_map',
     'first',
     'gray_product',
     'groupby_transform',
@@ -83,6 +85,7 @@ __all__ = [
     'is_sorted',
     'islice_extended',
     'iterate',
+    'iter_suppress',
     'last',
     'locate',
     'longest_common_prefix',
@@ -198,15 +201,14 @@ def first(iterable, default=_marker):
     ``next(iter(iterable), default)``.
 
     """
-    try:
-        return next(iter(iterable))
-    except StopIteration as e:
-        if default is _marker:
-            raise ValueError(
-                'first() was called on an empty iterable, and no '
-                'default value was provided.'
-            ) from e
-        return default
+    for item in iterable:
+        return item
+    if default is _marker:
+        raise ValueError(
+            'first() was called on an empty iterable, and no '
+            'default value was provided.'
+        )
+    return default
 
 
 def last(iterable, default=_marker):
@@ -582,6 +584,9 @@ def strictly_n(iterable, n, too_short=None, too_long=None):
         >>> list(strictly_n(iterable, n))
         ['a', 'b', 'c', 'd']
 
+    Note that the returned iterable must be consumed in order for the check to
+    be made.
+
     By default, *too_short* and *too_long* are functions that raise
     ``ValueError``.
 
@@ -919,7 +924,7 @@ def substrings_indexes(seq, reverse=False):
 
 
 class bucket:
-    """Wrap *iterable* and return an object that buckets it iterable into
+    """Wrap *iterable* and return an object that buckets the iterable into
     child iterables based on a *key* function.
 
         >>> iterable = ['a1', 'b1', 'c1', 'a2', 'b2', 'c2', 'b3']
@@ -3222,6 +3227,8 @@ class time_limited:
     stops if  the time elapsed is greater than *limit_seconds*. If your time
     limit is 1 second, but it takes 2 seconds to generate the first item from
     the iterable, the function will run for 2 seconds and not yield anything.
+    As a special case, when *limit_seconds* is zero, the iterator never
+    returns anything.
 
     """
 
@@ -3237,6 +3244,9 @@ class time_limited:
         return self
 
     def __next__(self):
+        if self.limit_seconds == 0:
+            self.timed_out = True
+            raise StopIteration
         item = next(self._iterable)
         if monotonic() - self._start_time > self.limit_seconds:
             self.timed_out = True
@@ -3356,7 +3366,7 @@ def iequals(*iterables):
     >>> iequals("abc", "acb")
     False
 
-    Not to be confused with :func:`all_equals`, which checks whether all
+    Not to be confused with :func:`all_equal`, which checks whether all
     elements of iterable are equal to each other.
 
     """
@@ -3853,7 +3863,7 @@ def nth_permutation(iterable, r, index):
     elif not 0 <= r < n:
         raise ValueError
     else:
-        c = factorial(n) // factorial(n - r)
+        c = perm(n, r)
 
     if index < 0:
         index += c
@@ -3898,7 +3908,7 @@ def nth_combination_with_replacement(iterable, r, index):
     if (r < 0) or (r > n):
         raise ValueError
 
-    c = factorial(n + r - 1) // (factorial(r) * factorial(n - 1))
+    c = comb(n + r - 1, r)
 
     if index < 0:
         index += c
@@ -3911,9 +3921,7 @@ def nth_combination_with_replacement(iterable, r, index):
     while r:
         r -= 1
         while n >= 0:
-            num_combs = factorial(n + r - 1) // (
-                factorial(r) * factorial(n - 1)
-            )
+            num_combs = comb(n + r - 1, r)
             if index < num_combs:
                 break
             n -= 1
@@ -4015,9 +4023,9 @@ def combination_index(element, iterable):
     for i, j in enumerate(reversed(indexes), start=1):
         j = n - j
         if i <= j:
-            index += factorial(j) // (factorial(i) * factorial(j - i))
+            index += comb(j, i)
 
-    return factorial(n + 1) // (factorial(k + 1) * factorial(n - k)) - index
+    return comb(n + 1, k + 1) - index
 
 
 def combination_with_replacement_index(element, iterable):
@@ -4057,7 +4065,7 @@ def combination_with_replacement_index(element, iterable):
             break
     else:
         raise ValueError(
-            'element is not a combination with replacment of iterable'
+            'element is not a combination with replacement of iterable'
         )
 
     n = len(pool)
@@ -4066,11 +4074,13 @@ def combination_with_replacement_index(element, iterable):
         occupations[p] += 1
 
     index = 0
+    cumulative_sum = 0
     for k in range(1, n):
-        j = l + n - 1 - k - sum(occupations[:k])
+        cumulative_sum += occupations[k - 1]
+        j = l + n - 1 - k - cumulative_sum
         i = n - k
         if i <= j:
-            index += factorial(j) // (factorial(i) * factorial(j - i))
+            index += comb(j, i)
 
     return index
 
@@ -4296,7 +4306,7 @@ def duplicates_everseen(iterable, key=None):
     >>> list(duplicates_everseen('AaaBbbCccAaa', str.lower))
     ['a', 'a', 'b', 'b', 'c', 'c', 'A', 'a', 'a']
 
-    This function is analagous to :func:`unique_everseen` and is subject to
+    This function is analogous to :func:`unique_everseen` and is subject to
     the same performance considerations.
 
     """
@@ -4326,12 +4336,54 @@ def duplicates_justseen(iterable, key=None):
     >>> list(duplicates_justseen('AaaBbbCccAaa', str.lower))
     ['a', 'a', 'b', 'b', 'c', 'c', 'a', 'a']
 
-    This function is analagous to :func:`unique_justseen`.
+    This function is analogous to :func:`unique_justseen`.
 
     """
     return flatten(g for _, g in groupby(iterable, key) for _ in g)
 
 
+def classify_unique(iterable, key=None):
+    """Classify each element in terms of its uniqueness.
+
+    For each element in the input iterable, return a 3-tuple consisting of:
+
+    1. The element itself
+    2. ``False`` if the element is equal to the one preceding it in the input,
+       ``True`` otherwise (i.e. the equivalent of :func:`unique_justseen`)
+    3. ``False`` if this element has been seen anywhere in the input before,
+       ``True`` otherwise (i.e. the equivalent of :func:`unique_everseen`)
+
+    >>> list(classify_unique('otto'))    # doctest: +NORMALIZE_WHITESPACE
+    [('o', True,  True),
+     ('t', True,  True),
+     ('t', False, False),
+     ('o', True,  False)]
+
+    This function is analogous to :func:`unique_everseen` and is subject to
+    the same performance considerations.
+
+    """
+    seen_set = set()
+    seen_list = []
+    use_key = key is not None
+    previous = None
+
+    for i, element in enumerate(iterable):
+        k = key(element) if use_key else element
+        is_unique_justseen = not i or previous != k
+        previous = k
+        is_unique_everseen = False
+        try:
+            if k not in seen_set:
+                seen_set.add(k)
+                is_unique_everseen = True
+        except TypeError:
+            if k not in seen_list:
+                seen_list.append(k)
+                is_unique_everseen = True
+        yield element, is_unique_justseen, is_unique_everseen
+
+
 def minmax(iterable_or_value, *others, key=None, default=_marker):
     """Returns both the smallest and largest items in an iterable
     or the largest of two or more arguments.
@@ -4529,10 +4581,8 @@ def takewhile_inclusive(predicate, iterable):
     :func:`takewhile` would return ``[1, 4]``.
     """
     for x in iterable:
-        if predicate(x):
-            yield x
-        else:
-            yield x
+        yield x
+        if not predicate(x):
             break
 
 
@@ -4567,3 +4617,40 @@ def outer_product(func, xs, ys, *args, **kwargs):
         starmap(lambda x, y: func(x, y, *args, **kwargs), product(xs, ys)),
         n=len(ys),
     )
+
+
+def iter_suppress(iterable, *exceptions):
+    """Yield each of the items from *iterable*. If the iteration raises one of
+    the specified *exceptions*, that exception will be suppressed and iteration
+    will stop.
+
+    >>> from itertools import chain
+    >>> def breaks_at_five(x):
+    ...     while True:
+    ...         if x >= 5:
+    ...             raise RuntimeError
+    ...         yield x
+    ...         x += 1
+    >>> it_1 = iter_suppress(breaks_at_five(1), RuntimeError)
+    >>> it_2 = iter_suppress(breaks_at_five(2), RuntimeError)
+    >>> list(chain(it_1, it_2))
+    [1, 2, 3, 4, 2, 3, 4]
+    """
+    try:
+        yield from iterable
+    except exceptions:
+        return
+
+
+def filter_map(func, iterable):
+    """Apply *func* to every element of *iterable*, yielding only those which
+    are not ``None``.
+
+    >>> elems = ['1', 'a', '2', 'b', '3']
+    >>> list(filter_map(lambda s: int(s) if s.isnumeric() else None, elems))
+    [1, 2, 3]
+    """
+    for x in iterable:
+        y = func(x)
+        if y is not None:
+            yield y
diff --git a/lib/more_itertools/more.pyi b/lib/more_itertools/more.pyi
index 07bfc155..9a5fc911 100644
--- a/lib/more_itertools/more.pyi
+++ b/lib/more_itertools/more.pyi
@@ -29,7 +29,7 @@ _U = TypeVar('_U')
 _V = TypeVar('_V')
 _W = TypeVar('_W')
 _T_co = TypeVar('_T_co', covariant=True)
-_GenFn = TypeVar('_GenFn', bound=Callable[..., Iterator[object]])
+_GenFn = TypeVar('_GenFn', bound=Callable[..., Iterator[Any]])
 _Raisable = BaseException | Type[BaseException]
 
 @type_check_only
@@ -74,7 +74,7 @@ class peekable(Generic[_T], Iterator[_T]):
     def __getitem__(self, index: slice) -> list[_T]: ...
 
 def consumer(func: _GenFn) -> _GenFn: ...
-def ilen(iterable: Iterable[object]) -> int: ...
+def ilen(iterable: Iterable[_T]) -> int: ...
 def iterate(func: Callable[[_T], _T], start: _T) -> Iterator[_T]: ...
 def with_iter(
     context_manager: ContextManager[Iterable[_T]],
@@ -116,7 +116,7 @@ class bucket(Generic[_T, _U], Container[_U]):
         self,
         iterable: Iterable[_T],
         key: Callable[[_T], _U],
-        validator: Callable[[object], object] | None = ...,
+        validator: Callable[[_U], object] | None = ...,
     ) -> None: ...
     def __contains__(self, value: object) -> bool: ...
     def __iter__(self) -> Iterator[_U]: ...
@@ -383,7 +383,7 @@ def mark_ends(
     iterable: Iterable[_T],
 ) -> Iterable[tuple[bool, bool, _T]]: ...
 def locate(
-    iterable: Iterable[object],
+    iterable: Iterable[_T],
     pred: Callable[..., Any] = ...,
     window_size: int | None = ...,
 ) -> Iterator[int]: ...
@@ -618,6 +618,9 @@ def duplicates_everseen(
 def duplicates_justseen(
     iterable: Iterable[_T], key: Callable[[_T], _U] | None = ...
 ) -> Iterator[_T]: ...
+def classify_unique(
+    iterable: Iterable[_T], key: Callable[[_T], _U] | None = ...
+) -> Iterator[tuple[_T, bool, bool]]: ...
 
 class _SupportsLessThan(Protocol):
     def __lt__(self, __other: Any) -> bool: ...
@@ -662,9 +665,9 @@ def minmax(
 def longest_common_prefix(
     iterables: Iterable[Iterable[_T]],
 ) -> Iterator[_T]: ...
-def iequals(*iterables: Iterable[object]) -> bool: ...
+def iequals(*iterables: Iterable[Any]) -> bool: ...
 def constrained_batches(
-    iterable: Iterable[object],
+    iterable: Iterable[_T],
     max_size: int,
     max_count: int | None = ...,
     get_len: Callable[[_T], object] = ...,
@@ -682,3 +685,11 @@ def outer_product(
     *args: Any,
     **kwargs: Any,
 ) -> Iterator[tuple[_V, ...]]: ...
+def iter_suppress(
+    iterable: Iterable[_T],
+    *exceptions: Type[BaseException],
+) -> Iterator[_T]: ...
+def filter_map(
+    func: Callable[[_T], _V | None],
+    iterable: Iterable[_T],
+) -> Iterator[_V]: ...
diff --git a/lib/more_itertools/recipes.py b/lib/more_itertools/recipes.py
index a0bdbece..145e3cb5 100644
--- a/lib/more_itertools/recipes.py
+++ b/lib/more_itertools/recipes.py
@@ -28,6 +28,7 @@ from itertools import (
     zip_longest,
 )
 from random import randrange, sample, choice
+from sys import hexversion
 
 __all__ = [
     'all_equal',
@@ -56,6 +57,7 @@ __all__ = [
     'powerset',
     'prepend',
     'quantify',
+    'reshape',
     'random_combination_with_replacement',
     'random_combination',
     'random_permutation',
@@ -69,6 +71,7 @@ __all__ = [
     'tabulate',
     'tail',
     'take',
+    'totient',
     'transpose',
     'triplewise',
     'unique_everseen',
@@ -492,7 +495,7 @@ def unique_everseen(iterable, key=None):
         >>> list(unique_everseen(iterable, key=tuple))  # Faster
         [[1, 2], [2, 3]]
 
-    Similary, you may want to convert unhashable ``set`` objects with
+    Similarly, you may want to convert unhashable ``set`` objects with
     ``key=frozenset``. For ``dict`` objects,
     ``key=lambda x: frozenset(x.items())`` can be used.
 
@@ -524,6 +527,9 @@ def unique_justseen(iterable, key=None):
     ['A', 'B', 'C', 'A', 'D']
 
     """
+    if key is None:
+        return map(operator.itemgetter(0), groupby(iterable))
+
     return map(next, map(operator.itemgetter(1), groupby(iterable, key)))
 
 
@@ -817,35 +823,34 @@ def polynomial_from_roots(roots):
     return list(reduce(convolve, factors, [1]))
 
 
-def iter_index(iterable, value, start=0):
+def iter_index(iterable, value, start=0, stop=None):
     """Yield the index of each place in *iterable* that *value* occurs,
-    beginning with index *start*.
+    beginning with index *start* and ending before index *stop*.
 
     See :func:`locate` for a more general means of finding the indexes
     associated with particular values.
 
     >>> list(iter_index('AABCADEAF', 'A'))
     [0, 1, 4, 7]
+    >>> list(iter_index('AABCADEAF', 'A', 1))  # start index is inclusive
+    [1, 4, 7]
+    >>> list(iter_index('AABCADEAF', 'A', 1, 7))  # stop index is not inclusive
+    [1, 4]
     """
-    try:
-        seq_index = iterable.index
-    except AttributeError:
+    seq_index = getattr(iterable, 'index', None)
+    if seq_index is None:
         # Slow path for general iterables
-        it = islice(iterable, start, None)
-        i = start - 1
-        try:
-            while True:
-                i = i + operator.indexOf(it, value) + 1
+        it = islice(iterable, start, stop)
+        for i, element in enumerate(it, start):
+            if element is value or element == value:
                 yield i
-        except ValueError:
-            pass
     else:
         # Fast path for sequences
+        stop = len(iterable) if stop is None else stop
         i = start - 1
         try:
             while True:
-                i = seq_index(value, i + 1)
-                yield i
+                yield (i := seq_index(value, i + 1, stop))
         except ValueError:
             pass
 
@@ -856,47 +861,52 @@ def sieve(n):
     >>> list(sieve(30))
     [2, 3, 5, 7, 11, 13, 17, 19, 23, 29]
     """
+    if n > 2:
+        yield 2
+    start = 3
     data = bytearray((0, 1)) * (n // 2)
-    data[:3] = 0, 0, 0
     limit = math.isqrt(n) + 1
-    for p in compress(range(limit), data):
+    for p in iter_index(data, 1, start, limit):
+        yield from iter_index(data, 1, start, p * p)
         data[p * p : n : p + p] = bytes(len(range(p * p, n, p + p)))
-    data[2] = 1
-    return iter_index(data, 1) if n > 2 else iter([])
+        start = p * p
+    yield from iter_index(data, 1, start)
 
 
-def _batched(iterable, n):
-    """Batch data into lists of length *n*. The last batch may be shorter.
+def _batched(iterable, n, *, strict=False):
+    """Batch data into tuples of length *n*. If the number of items in
+    *iterable* is not divisible by *n*:
+    * The last batch will be shorter if *strict* is ``False``.
+    * :exc:`ValueError` will be raised if *strict* is ``True``.
 
     >>> list(batched('ABCDEFG', 3))
     [('A', 'B', 'C'), ('D', 'E', 'F'), ('G',)]
 
-    On Python 3.12 and above, this is an alias for :func:`itertools.batched`.
+    On Python 3.13 and above, this is an alias for :func:`itertools.batched`.
     """
     if n < 1:
         raise ValueError('n must be at least one')
     it = iter(iterable)
-    while True:
-        batch = tuple(islice(it, n))
-        if not batch:
-            break
+    while batch := tuple(islice(it, n)):
+        if strict and len(batch) != n:
+            raise ValueError('batched(): incomplete batch')
         yield batch
 
 
-try:
+if hexversion >= 0x30D00A2:
     from itertools import batched as itertools_batched
-except ImportError:
-    batched = _batched
-else:
 
-    def batched(iterable, n):
-        return itertools_batched(iterable, n)
+    def batched(iterable, n, *, strict=False):
+        return itertools_batched(iterable, n, strict=strict)
+
+else:
+    batched = _batched
 
     batched.__doc__ = _batched.__doc__
 
 
 def transpose(it):
-    """Swap the rows and columns of the input.
+    """Swap the rows and columns of the input matrix.
 
     >>> list(transpose([(1, 2, 3), (11, 22, 33)]))
     [(1, 11), (2, 22), (3, 33)]
@@ -907,8 +917,20 @@ def transpose(it):
     return _zip_strict(*it)
 
 
+def reshape(matrix, cols):
+    """Reshape the 2-D input *matrix* to have a column count given by *cols*.
+
+    >>> matrix = [(0, 1), (2, 3), (4, 5)]
+    >>> cols = 3
+    >>> list(reshape(matrix, cols))
+    [(0, 1, 2), (3, 4, 5)]
+    """
+    return batched(chain.from_iterable(matrix), cols)
+
+
 def matmul(m1, m2):
     """Multiply two matrices.
+
     >>> list(matmul([(7, 5), (3, 5)], [(2, 5), (7, 9)]))
     [(49, 80), (41, 60)]
 
@@ -921,13 +943,12 @@ def matmul(m1, m2):
 
 def factor(n):
     """Yield the prime factors of n.
+
     >>> list(factor(360))
     [2, 2, 2, 3, 3, 5]
     """
     for prime in sieve(math.isqrt(n) + 1):
-        while True:
-            if n % prime:
-                break
+        while not n % prime:
             yield prime
             n //= prime
             if n == 1:
@@ -975,3 +996,17 @@ def polynomial_derivative(coefficients):
     n = len(coefficients)
     powers = reversed(range(1, n))
     return list(map(operator.mul, coefficients, powers))
+
+
+def totient(n):
+    """Return the count of natural numbers up to *n* that are coprime with *n*.
+
+    >>> totient(9)
+    6
+    >>> totient(12)
+    4
+    """
+    for p in unique_justseen(factor(n)):
+        n = n // p * (p - 1)
+
+    return n
diff --git a/lib/more_itertools/recipes.pyi b/lib/more_itertools/recipes.pyi
index ef883864..ed4c19db 100644
--- a/lib/more_itertools/recipes.pyi
+++ b/lib/more_itertools/recipes.pyi
@@ -14,6 +14,8 @@ from typing import (
 
 # Type and type variable definitions
 _T = TypeVar('_T')
+_T1 = TypeVar('_T1')
+_T2 = TypeVar('_T2')
 _U = TypeVar('_U')
 
 def take(n: int, iterable: Iterable[_T]) -> list[_T]: ...
@@ -26,14 +28,14 @@ def consume(iterator: Iterable[_T], n: int | None = ...) -> None: ...
 def nth(iterable: Iterable[_T], n: int) -> _T | None: ...
 @overload
 def nth(iterable: Iterable[_T], n: int, default: _U) -> _T | _U: ...
-def all_equal(iterable: Iterable[object]) -> bool: ...
+def all_equal(iterable: Iterable[_T]) -> bool: ...
 def quantify(
     iterable: Iterable[_T], pred: Callable[[_T], bool] = ...
 ) -> int: ...
 def pad_none(iterable: Iterable[_T]) -> Iterator[_T | None]: ...
 def padnone(iterable: Iterable[_T]) -> Iterator[_T | None]: ...
 def ncycles(iterable: Iterable[_T], n: int) -> Iterator[_T]: ...
-def dotproduct(vec1: Iterable[object], vec2: Iterable[object]) -> object: ...
+def dotproduct(vec1: Iterable[_T1], vec2: Iterable[_T2]) -> Any: ...
 def flatten(listOfLists: Iterable[Iterable[_T]]) -> Iterator[_T]: ...
 def repeatfunc(
     func: Callable[..., _U], times: int | None = ..., *args: Any
@@ -103,20 +105,24 @@ def sliding_window(
 def subslices(iterable: Iterable[_T]) -> Iterator[list[_T]]: ...
 def polynomial_from_roots(roots: Sequence[_T]) -> list[_T]: ...
 def iter_index(
-    iterable: Iterable[object],
+    iterable: Iterable[_T],
     value: Any,
     start: int | None = ...,
+    stop: int | None = ...,
 ) -> Iterator[int]: ...
 def sieve(n: int) -> Iterator[int]: ...
 def batched(
-    iterable: Iterable[_T],
-    n: int,
+    iterable: Iterable[_T], n: int, *, strict: bool = False
 ) -> Iterator[tuple[_T]]: ...
 def transpose(
     it: Iterable[Iterable[_T]],
 ) -> Iterator[tuple[_T, ...]]: ...
+def reshape(
+    matrix: Iterable[Iterable[_T]], cols: int
+) -> Iterator[tuple[_T, ...]]: ...
 def matmul(m1: Sequence[_T], m2: Sequence[_T]) -> Iterator[tuple[_T]]: ...
 def factor(n: int) -> Iterator[int]: ...
 def polynomial_eval(coefficients: Sequence[_T], x: _U) -> _U: ...
 def sum_of_squares(it: Iterable[_T]) -> _T: ...
 def polynomial_derivative(coefficients: Sequence[_T]) -> list[_T]: ...
+def totient(n: int) -> int: ...
diff --git a/lib/pydantic/__init__.py b/lib/pydantic/__init__.py
index 3bf1418f..85a8c18b 100644
--- a/lib/pydantic/__init__.py
+++ b/lib/pydantic/__init__.py
@@ -1,56 +1,114 @@
-# flake8: noqa
-from . import dataclasses
-from .annotated_types import create_model_from_namedtuple, create_model_from_typeddict
-from .class_validators import root_validator, validator
-from .config import BaseConfig, ConfigDict, Extra
-from .decorator import validate_arguments
-from .env_settings import BaseSettings
-from .error_wrappers import ValidationError
-from .errors import *
-from .fields import Field, PrivateAttr, Required
-from .main import *
-from .networks import *
-from .parse import Protocol
-from .tools import *
-from .types import *
-from .version import VERSION, compiled
+import typing
+
+from ._migration import getattr_migration
+from .version import VERSION
+
+if typing.TYPE_CHECKING:
+    # import of virtually everything is supported via `__getattr__` below,
+    # but we need them here for type checking and IDE support
+    import pydantic_core
+    from pydantic_core.core_schema import (
+        FieldSerializationInfo,
+        SerializationInfo,
+        SerializerFunctionWrapHandler,
+        ValidationInfo,
+        ValidatorFunctionWrapHandler,
+    )
+
+    from . import dataclasses
+    from ._internal._generate_schema import GenerateSchema as GenerateSchema
+    from .aliases import AliasChoices, AliasGenerator, AliasPath
+    from .annotated_handlers import GetCoreSchemaHandler, GetJsonSchemaHandler
+    from .config import ConfigDict
+    from .errors import *
+    from .fields import Field, PrivateAttr, computed_field
+    from .functional_serializers import (
+        PlainSerializer,
+        SerializeAsAny,
+        WrapSerializer,
+        field_serializer,
+        model_serializer,
+    )
+    from .functional_validators import (
+        AfterValidator,
+        BeforeValidator,
+        InstanceOf,
+        PlainValidator,
+        SkipValidation,
+        WrapValidator,
+        field_validator,
+        model_validator,
+    )
+    from .json_schema import WithJsonSchema
+    from .main import *
+    from .networks import *
+    from .type_adapter import TypeAdapter
+    from .types import *
+    from .validate_call_decorator import validate_call
+    from .warnings import PydanticDeprecatedSince20, PydanticDeprecatedSince26, PydanticDeprecationWarning
+
+    # this encourages pycharm to import `ValidationError` from here, not pydantic_core
+    ValidationError = pydantic_core.ValidationError
+    from .deprecated.class_validators import root_validator, validator
+    from .deprecated.config import BaseConfig, Extra
+    from .deprecated.tools import *
+    from .root_model import RootModel
 
 __version__ = VERSION
-
-# WARNING __all__ from .errors is not included here, it will be removed as an export here in v2
-# please use "from pydantic.errors import ..." instead
-__all__ = [
-    # annotated types utils
-    'create_model_from_namedtuple',
-    'create_model_from_typeddict',
+__all__ = (
     # dataclasses
     'dataclasses',
-    # class_validators
+    # functional validators
+    'field_validator',
+    'model_validator',
+    'AfterValidator',
+    'BeforeValidator',
+    'PlainValidator',
+    'WrapValidator',
+    'SkipValidation',
+    'InstanceOf',
+    # JSON Schema
+    'WithJsonSchema',
+    # deprecated V1 functional validators, these are imported via `__getattr__` below
     'root_validator',
     'validator',
+    # functional serializers
+    'field_serializer',
+    'model_serializer',
+    'PlainSerializer',
+    'SerializeAsAny',
+    'WrapSerializer',
     # config
-    'BaseConfig',
     'ConfigDict',
+    # deprecated V1 config, these are imported via `__getattr__` below
+    'BaseConfig',
     'Extra',
-    # decorator
-    'validate_arguments',
-    # env_settings
-    'BaseSettings',
-    # error_wrappers
-    'ValidationError',
+    # validate_call
+    'validate_call',
+    # errors
+    'PydanticErrorCodes',
+    'PydanticUserError',
+    'PydanticSchemaGenerationError',
+    'PydanticImportError',
+    'PydanticUndefinedAnnotation',
+    'PydanticInvalidForJsonSchema',
     # fields
     'Field',
-    'Required',
+    'computed_field',
+    'PrivateAttr',
+    # alias
+    'AliasChoices',
+    'AliasGenerator',
+    'AliasPath',
     # main
     'BaseModel',
     'create_model',
-    'validate_model',
     # network
     'AnyUrl',
     'AnyHttpUrl',
     'FileUrl',
     'HttpUrl',
-    'stricturl',
+    'UrlConstraints',
     'EmailStr',
     'NameEmail',
     'IPvAnyAddress',
@@ -62,48 +120,38 @@ __all__ = [
     'RedisDsn',
     'MongoDsn',
     'KafkaDsn',
+    'NatsDsn',
+    'MySQLDsn',
+    'MariaDBDsn',
     'validate_email',
-    # parse
-    'Protocol',
-    # tools
-    'parse_file_as',
+    # root_model
+    'RootModel',
+    # deprecated tools, these are imported via `__getattr__` below
     'parse_obj_as',
-    'parse_raw_as',
     'schema_of',
     'schema_json_of',
     # types
-    'NoneStr',
-    'NoneBytes',
-    'StrBytes',
-    'NoneStrBytes',
+    'Strict',
     'StrictStr',
-    'ConstrainedBytes',
     'conbytes',
-    'ConstrainedList',
     'conlist',
-    'ConstrainedSet',
     'conset',
-    'ConstrainedFrozenSet',
     'confrozenset',
-    'ConstrainedStr',
     'constr',
-    'PyObject',
-    'ConstrainedInt',
+    'StringConstraints',
+    'ImportString',
     'conint',
     'PositiveInt',
     'NegativeInt',
     'NonNegativeInt',
     'NonPositiveInt',
-    'ConstrainedFloat',
     'confloat',
     'PositiveFloat',
     'NegativeFloat',
     'NonNegativeFloat',
     'NonPositiveFloat',
     'FiniteFloat',
-    'ConstrainedDecimal',
     'condecimal',
-    'ConstrainedDate',
     'condate',
     'UUID1',
     'UUID3',
@@ -111,9 +159,8 @@ __all__ = [
     'UUID5',
     'FilePath',
     'DirectoryPath',
+    'NewPath',
     'Json',
-    'JsonWrapper',
-    'SecretField',
     'SecretStr',
     'SecretBytes',
     'StrictBool',
@@ -121,11 +168,221 @@ __all__ = [
     'StrictInt',
     'StrictFloat',
     'PaymentCardNumber',
-    'PrivateAttr',
     'ByteSize',
     'PastDate',
     'FutureDate',
+    'PastDatetime',
+    'FutureDatetime',
+    'AwareDatetime',
+    'NaiveDatetime',
+    'AllowInfNan',
+    'EncoderProtocol',
+    'EncodedBytes',
+    'EncodedStr',
+    'Base64Encoder',
+    'Base64Bytes',
+    'Base64Str',
+    'Base64UrlBytes',
+    'Base64UrlStr',
+    'GetPydanticSchema',
+    'Tag',
+    'Discriminator',
+    'JsonValue',
+    # type_adapter
+    'TypeAdapter',
     # version
-    'compiled',
+    '__version__',
     'VERSION',
-]
+    # warnings
+    'PydanticDeprecatedSince20',
+    'PydanticDeprecatedSince26',
+    'PydanticDeprecationWarning',
+    # annotated handlers
+    'GetCoreSchemaHandler',
+    'GetJsonSchemaHandler',
+    # generate schema from ._internal
+    'GenerateSchema',
+    # pydantic_core
+    'ValidationError',
+    'ValidationInfo',
+    'SerializationInfo',
+    'ValidatorFunctionWrapHandler',
+    'FieldSerializationInfo',
+    'SerializerFunctionWrapHandler',
+    'OnErrorOmit',
+)
+
+# A mapping of {<member name>: (package, <module name>)} defining dynamic imports
+_dynamic_imports: 'dict[str, tuple[str, str]]' = {
+    'dataclasses': (__package__, '__module__'),
+    # functional validators
+    'field_validator': (__package__, '.functional_validators'),
+    'model_validator': (__package__, '.functional_validators'),
+    'AfterValidator': (__package__, '.functional_validators'),
+    'BeforeValidator': (__package__, '.functional_validators'),
+    'PlainValidator': (__package__, '.functional_validators'),
+    'WrapValidator': (__package__, '.functional_validators'),
+    'SkipValidation': (__package__, '.functional_validators'),
+    'InstanceOf': (__package__, '.functional_validators'),
+    # JSON Schema
+    'WithJsonSchema': (__package__, '.json_schema'),
+    # functional serializers
+    'field_serializer': (__package__, '.functional_serializers'),
+    'model_serializer': (__package__, '.functional_serializers'),
+    'PlainSerializer': (__package__, '.functional_serializers'),
+    'SerializeAsAny': (__package__, '.functional_serializers'),
+    'WrapSerializer': (__package__, '.functional_serializers'),
+    # config
+    'ConfigDict': (__package__, '.config'),
+    # validate call
+    'validate_call': (__package__, '.validate_call_decorator'),
+    # errors
+    'PydanticErrorCodes': (__package__, '.errors'),
+    'PydanticUserError': (__package__, '.errors'),
+    'PydanticSchemaGenerationError': (__package__, '.errors'),
+    'PydanticImportError': (__package__, '.errors'),
+    'PydanticUndefinedAnnotation': (__package__, '.errors'),
+    'PydanticInvalidForJsonSchema': (__package__, '.errors'),
+    # fields
+    'Field': (__package__, '.fields'),
+    'computed_field': (__package__, '.fields'),
+    'PrivateAttr': (__package__, '.fields'),
+    # alias
+    'AliasChoices': (__package__, '.aliases'),
+    'AliasGenerator': (__package__, '.aliases'),
+    'AliasPath': (__package__, '.aliases'),
+    # main
+    'BaseModel': (__package__, '.main'),
+    'create_model': (__package__, '.main'),
+    # network
+    'AnyUrl': (__package__, '.networks'),
+    'AnyHttpUrl': (__package__, '.networks'),
+    'FileUrl': (__package__, '.networks'),
+    'HttpUrl': (__package__, '.networks'),
+    'UrlConstraints': (__package__, '.networks'),
+    'EmailStr': (__package__, '.networks'),
+    'NameEmail': (__package__, '.networks'),
+    'IPvAnyAddress': (__package__, '.networks'),
+    'IPvAnyInterface': (__package__, '.networks'),
+    'IPvAnyNetwork': (__package__, '.networks'),
+    'PostgresDsn': (__package__, '.networks'),
+    'CockroachDsn': (__package__, '.networks'),
+    'AmqpDsn': (__package__, '.networks'),
+    'RedisDsn': (__package__, '.networks'),
+    'MongoDsn': (__package__, '.networks'),
+    'KafkaDsn': (__package__, '.networks'),
+    'NatsDsn': (__package__, '.networks'),
+    'MySQLDsn': (__package__, '.networks'),
+    'MariaDBDsn': (__package__, '.networks'),
+    'validate_email': (__package__, '.networks'),
+    # root_model
+    'RootModel': (__package__, '.root_model'),
+    # types
+    'Strict': (__package__, '.types'),
+    'StrictStr': (__package__, '.types'),
+    'conbytes': (__package__, '.types'),
+    'conlist': (__package__, '.types'),
+    'conset': (__package__, '.types'),
+    'confrozenset': (__package__, '.types'),
+    'constr': (__package__, '.types'),
+    'StringConstraints': (__package__, '.types'),
+    'ImportString': (__package__, '.types'),
+    'conint': (__package__, '.types'),
+    'PositiveInt': (__package__, '.types'),
+    'NegativeInt': (__package__, '.types'),
+    'NonNegativeInt': (__package__, '.types'),
+    'NonPositiveInt': (__package__, '.types'),
+    'confloat': (__package__, '.types'),
+    'PositiveFloat': (__package__, '.types'),
+    'NegativeFloat': (__package__, '.types'),
+    'NonNegativeFloat': (__package__, '.types'),
+    'NonPositiveFloat': (__package__, '.types'),
+    'FiniteFloat': (__package__, '.types'),
+    'condecimal': (__package__, '.types'),
+    'condate': (__package__, '.types'),
+    'UUID1': (__package__, '.types'),
+    'UUID3': (__package__, '.types'),
+    'UUID4': (__package__, '.types'),
+    'UUID5': (__package__, '.types'),
+    'FilePath': (__package__, '.types'),
+    'DirectoryPath': (__package__, '.types'),
+    'NewPath': (__package__, '.types'),
+    'Json': (__package__, '.types'),
+    'SecretStr': (__package__, '.types'),
+    'SecretBytes': (__package__, '.types'),
+    'StrictBool': (__package__, '.types'),
+    'StrictBytes': (__package__, '.types'),
+    'StrictInt': (__package__, '.types'),
+    'StrictFloat': (__package__, '.types'),
+    'PaymentCardNumber': (__package__, '.types'),
+    'ByteSize': (__package__, '.types'),
+    'PastDate': (__package__, '.types'),
+    'FutureDate': (__package__, '.types'),
+    'PastDatetime': (__package__, '.types'),
+    'FutureDatetime': (__package__, '.types'),
+    'AwareDatetime': (__package__, '.types'),
+    'NaiveDatetime': (__package__, '.types'),
+    'AllowInfNan': (__package__, '.types'),
+    'EncoderProtocol': (__package__, '.types'),
+    'EncodedBytes': (__package__, '.types'),
+    'EncodedStr': (__package__, '.types'),
+    'Base64Encoder': (__package__, '.types'),
+    'Base64Bytes': (__package__, '.types'),
+    'Base64Str': (__package__, '.types'),
+    'Base64UrlBytes': (__package__, '.types'),
+    'Base64UrlStr': (__package__, '.types'),
+    'GetPydanticSchema': (__package__, '.types'),
+    'Tag': (__package__, '.types'),
+    'Discriminator': (__package__, '.types'),
+    'JsonValue': (__package__, '.types'),
+    'OnErrorOmit': (__package__, '.types'),
+    # type_adapter
+    'TypeAdapter': (__package__, '.type_adapter'),
+    # warnings
+    'PydanticDeprecatedSince20': (__package__, '.warnings'),
+    'PydanticDeprecatedSince26': (__package__, '.warnings'),
+    'PydanticDeprecationWarning': (__package__, '.warnings'),
+    # annotated handlers
+    'GetCoreSchemaHandler': (__package__, '.annotated_handlers'),
+    'GetJsonSchemaHandler': (__package__, '.annotated_handlers'),
+    # generate schema from ._internal
+    'GenerateSchema': (__package__, '._internal._generate_schema'),
+    # pydantic_core stuff
+    'ValidationError': ('pydantic_core', '.'),
+    'ValidationInfo': ('pydantic_core', '.core_schema'),
+    'SerializationInfo': ('pydantic_core', '.core_schema'),
+    'ValidatorFunctionWrapHandler': ('pydantic_core', '.core_schema'),
+    'FieldSerializationInfo': ('pydantic_core', '.core_schema'),
+    'SerializerFunctionWrapHandler': ('pydantic_core', '.core_schema'),
+    # deprecated, mostly not included in __all__
+    'root_validator': (__package__, '.deprecated.class_validators'),
+    'validator': (__package__, '.deprecated.class_validators'),
+    'BaseConfig': (__package__, '.deprecated.config'),
+    'Extra': (__package__, '.deprecated.config'),
+    'parse_obj_as': (__package__, '.deprecated.tools'),
+    'schema_of': (__package__, '.deprecated.tools'),
+    'schema_json_of': (__package__, '.deprecated.tools'),
+    'FieldValidationInfo': ('pydantic_core', '.core_schema'),
+}
+
+_getattr_migration = getattr_migration(__name__)
+
+
+def __getattr__(attr_name: str) -> object:
+    dynamic_attr = _dynamic_imports.get(attr_name)
+    if dynamic_attr is None:
+        return _getattr_migration(attr_name)
+
+    package, module_name = dynamic_attr
+
+    from importlib import import_module
+
+    if module_name == '__module__':
+        return import_module(f'.{attr_name}', package=package)
+    else:
+        module = import_module(module_name, package=package)
+        return getattr(module, attr_name)
+
+
+def __dir__() -> 'list[str]':
+    return list(__all__)
diff --git a/lib/pydantic/_internal/__init__.py b/lib/pydantic/_internal/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/lib/pydantic/_internal/_config.py b/lib/pydantic/_internal/_config.py
new file mode 100644
index 00000000..52c4cc42
--- /dev/null
+++ b/lib/pydantic/_internal/_config.py
@@ -0,0 +1,322 @@
+from __future__ import annotations as _annotations
+
+import warnings
+from contextlib import contextmanager
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    cast,
+)
+
+from pydantic_core import core_schema
+from typing_extensions import (
+    Literal,
+    Self,
+)
+
+from ..aliases import AliasGenerator
+from ..config import ConfigDict, ExtraValues, JsonDict, JsonEncoder, JsonSchemaExtraCallable
+from ..errors import PydanticUserError
+from ..warnings import PydanticDeprecatedSince20
+
+if not TYPE_CHECKING:
+    # See PyCharm issues https://youtrack.jetbrains.com/issue/PY-21915
+    # and https://youtrack.jetbrains.com/issue/PY-51428
+    DeprecationWarning = PydanticDeprecatedSince20
+
+if TYPE_CHECKING:
+    from .._internal._schema_generation_shared import GenerateSchema
+
+DEPRECATION_MESSAGE = 'Support for class-based `config` is deprecated, use ConfigDict instead.'
+
+
+class ConfigWrapper:
+    """Internal wrapper for Config which exposes ConfigDict items as attributes."""
+
+    __slots__ = ('config_dict',)
+
+    config_dict: ConfigDict
+
+    # all annotations are copied directly from ConfigDict, and should be kept up to date, a test will fail if they
+    # stop matching
+    title: str | None
+    str_to_lower: bool
+    str_to_upper: bool
+    str_strip_whitespace: bool
+    str_min_length: int
+    str_max_length: int | None
+    extra: ExtraValues | None
+    frozen: bool
+    populate_by_name: bool
+    use_enum_values: bool
+    validate_assignment: bool
+    arbitrary_types_allowed: bool
+    from_attributes: bool
+    # whether to use the actual key provided in the data (e.g. alias or first alias for "field required" errors) instead of field_names
+    # to construct error `loc`s, default `True`
+    loc_by_alias: bool
+    alias_generator: Callable[[str], str] | AliasGenerator | None
+    ignored_types: tuple[type, ...]
+    allow_inf_nan: bool
+    json_schema_extra: JsonDict | JsonSchemaExtraCallable | None
+    json_encoders: dict[type[object], JsonEncoder] | None
+
+    # new in V2
+    strict: bool
+    # whether instances of models and dataclasses (including subclass instances) should re-validate, default 'never'
+    revalidate_instances: Literal['always', 'never', 'subclass-instances']
+    ser_json_timedelta: Literal['iso8601', 'float']
+    ser_json_bytes: Literal['utf8', 'base64']
+    ser_json_inf_nan: Literal['null', 'constants']
+    # whether to validate default values during validation, default False
+    validate_default: bool
+    validate_return: bool
+    protected_namespaces: tuple[str, ...]
+    hide_input_in_errors: bool
+    defer_build: bool
+    plugin_settings: dict[str, object] | None
+    schema_generator: type[GenerateSchema] | None
+    json_schema_serialization_defaults_required: bool
+    json_schema_mode_override: Literal['validation', 'serialization', None]
+    coerce_numbers_to_str: bool
+    regex_engine: Literal['rust-regex', 'python-re']
+    validation_error_cause: bool
+
+    def __init__(self, config: ConfigDict | dict[str, Any] | type[Any] | None, *, check: bool = True):
+        if check:
+            self.config_dict = prepare_config(config)
+        else:
+            self.config_dict = cast(ConfigDict, config)
+
+    @classmethod
+    def for_model(cls, bases: tuple[type[Any], ...], namespace: dict[str, Any], kwargs: dict[str, Any]) -> Self:
+        """Build a new `ConfigWrapper` instance for a `BaseModel`.
+
+        The config wrapper built based on (in descending order of priority):
+        - options from `kwargs`
+        - options from the `namespace`
+        - options from the base classes (`bases`)
+
+        Args:
+            bases: A tuple of base classes.
+            namespace: The namespace of the class being created.
+            kwargs: The kwargs passed to the class being created.
+
+        Returns:
+            A `ConfigWrapper` instance for `BaseModel`.
+        """
+        config_new = ConfigDict()
+        for base in bases:
+            config = getattr(base, 'model_config', None)
+            if config:
+                config_new.update(config.copy())
+
+        config_class_from_namespace = namespace.get('Config')
+        config_dict_from_namespace = namespace.get('model_config')
+
+        if config_class_from_namespace and config_dict_from_namespace:
+            raise PydanticUserError('"Config" and "model_config" cannot be used together', code='config-both')
+
+        config_from_namespace = config_dict_from_namespace or prepare_config(config_class_from_namespace)
+
+        config_new.update(config_from_namespace)
+
+        for k in list(kwargs.keys()):
+            if k in config_keys:
+                config_new[k] = kwargs.pop(k)
+
+        return cls(config_new)
+
+    # we don't show `__getattr__` to type checkers so missing attributes cause errors
+    if not TYPE_CHECKING:  # pragma: no branch
+
+        def __getattr__(self, name: str) -> Any:
+            try:
+                return self.config_dict[name]
+            except KeyError:
+                try:
+                    return config_defaults[name]
+                except KeyError:
+                    raise AttributeError(f'Config has no attribute {name!r}') from None
+
+    def core_config(self, obj: Any) -> core_schema.CoreConfig:
+        """Create a pydantic-core config, `obj` is just used to populate `title` if not set in config.
+
+        Pass `obj=None` if you do not want to attempt to infer the `title`.
+
+        We don't use getattr here since we don't want to populate with defaults.
+
+        Args:
+            obj: An object used to populate `title` if not set in config.
+
+        Returns:
+            A `CoreConfig` object created from config.
+        """
+
+        def dict_not_none(**kwargs: Any) -> Any:
+            return {k: v for k, v in kwargs.items() if v is not None}
+
+        core_config = core_schema.CoreConfig(
+            **dict_not_none(
+                title=self.config_dict.get('title') or (obj and obj.__name__),
+                extra_fields_behavior=self.config_dict.get('extra'),
+                allow_inf_nan=self.config_dict.get('allow_inf_nan'),
+                populate_by_name=self.config_dict.get('populate_by_name'),
+                str_strip_whitespace=self.config_dict.get('str_strip_whitespace'),
+                str_to_lower=self.config_dict.get('str_to_lower'),
+                str_to_upper=self.config_dict.get('str_to_upper'),
+                strict=self.config_dict.get('strict'),
+                ser_json_timedelta=self.config_dict.get('ser_json_timedelta'),
+                ser_json_bytes=self.config_dict.get('ser_json_bytes'),
+                ser_json_inf_nan=self.config_dict.get('ser_json_inf_nan'),
+                from_attributes=self.config_dict.get('from_attributes'),
+                loc_by_alias=self.config_dict.get('loc_by_alias'),
+                revalidate_instances=self.config_dict.get('revalidate_instances'),
+                validate_default=self.config_dict.get('validate_default'),
+                str_max_length=self.config_dict.get('str_max_length'),
+                str_min_length=self.config_dict.get('str_min_length'),
+                hide_input_in_errors=self.config_dict.get('hide_input_in_errors'),
+                coerce_numbers_to_str=self.config_dict.get('coerce_numbers_to_str'),
+                regex_engine=self.config_dict.get('regex_engine'),
+                validation_error_cause=self.config_dict.get('validation_error_cause'),
+            )
+        )
+        return core_config
+
+    def __repr__(self):
+        c = ', '.join(f'{k}={v!r}' for k, v in self.config_dict.items())
+        return f'ConfigWrapper({c})'
+
+
+class ConfigWrapperStack:
+    """A stack of `ConfigWrapper` instances."""
+
+    def __init__(self, config_wrapper: ConfigWrapper):
+        self._config_wrapper_stack: list[ConfigWrapper] = [config_wrapper]
+
+    @property
+    def tail(self) -> ConfigWrapper:
+        return self._config_wrapper_stack[-1]
+
+    @contextmanager
+    def push(self, config_wrapper: ConfigWrapper | ConfigDict | None):
+        if config_wrapper is None:
+            yield
+            return
+
+        if not isinstance(config_wrapper, ConfigWrapper):
+            config_wrapper = ConfigWrapper(config_wrapper, check=False)
+
+        self._config_wrapper_stack.append(config_wrapper)
+        try:
+            yield
+        finally:
+            self._config_wrapper_stack.pop()
+
+
+config_defaults = ConfigDict(
+    title=None,
+    str_to_lower=False,
+    str_to_upper=False,
+    str_strip_whitespace=False,
+    str_min_length=0,
+    str_max_length=None,
+    # let the model / dataclass decide how to handle it
+    extra=None,
+    frozen=False,
+    populate_by_name=False,
+    use_enum_values=False,
+    validate_assignment=False,
+    arbitrary_types_allowed=False,
+    from_attributes=False,
+    loc_by_alias=True,
+    alias_generator=None,
+    ignored_types=(),
+    allow_inf_nan=True,
+    json_schema_extra=None,
+    strict=False,
+    revalidate_instances='never',
+    ser_json_timedelta='iso8601',
+    ser_json_bytes='utf8',
+    ser_json_inf_nan='null',
+    validate_default=False,
+    validate_return=False,
+    protected_namespaces=('model_',),
+    hide_input_in_errors=False,
+    json_encoders=None,
+    defer_build=False,
+    plugin_settings=None,
+    schema_generator=None,
+    json_schema_serialization_defaults_required=False,
+    json_schema_mode_override=None,
+    coerce_numbers_to_str=False,
+    regex_engine='rust-regex',
+    validation_error_cause=False,
+)
+
+
+def prepare_config(config: ConfigDict | dict[str, Any] | type[Any] | None) -> ConfigDict:
+    """Create a `ConfigDict` instance from an existing dict, a class (e.g. old class-based config) or None.
+
+    Args:
+        config: The input config.
+
+    Returns:
+        A ConfigDict object created from config.
+    """
+    if config is None:
+        return ConfigDict()
+
+    if not isinstance(config, dict):
+        warnings.warn(DEPRECATION_MESSAGE, DeprecationWarning)
+        config = {k: getattr(config, k) for k in dir(config) if not k.startswith('__')}
+
+    config_dict = cast(ConfigDict, config)
+    check_deprecated(config_dict)
+    return config_dict
+
+
+config_keys = set(ConfigDict.__annotations__.keys())
+
+
+V2_REMOVED_KEYS = {
+    'allow_mutation',
+    'error_msg_templates',
+    'fields',
+    'getter_dict',
+    'smart_union',
+    'underscore_attrs_are_private',
+    'json_loads',
+    'json_dumps',
+    'copy_on_model_validation',
+    'post_init_call',
+}
+V2_RENAMED_KEYS = {
+    'allow_population_by_field_name': 'populate_by_name',
+    'anystr_lower': 'str_to_lower',
+    'anystr_strip_whitespace': 'str_strip_whitespace',
+    'anystr_upper': 'str_to_upper',
+    'keep_untouched': 'ignored_types',
+    'max_anystr_length': 'str_max_length',
+    'min_anystr_length': 'str_min_length',
+    'orm_mode': 'from_attributes',
+    'schema_extra': 'json_schema_extra',
+    'validate_all': 'validate_default',
+}
+
+
+def check_deprecated(config_dict: ConfigDict) -> None:
+    """Check for deprecated config keys and warn the user.
+
+    Args:
+        config_dict: The input config.
+    """
+    deprecated_removed_keys = V2_REMOVED_KEYS & config_dict.keys()
+    deprecated_renamed_keys = V2_RENAMED_KEYS.keys() & config_dict.keys()
+    if deprecated_removed_keys or deprecated_renamed_keys:
+        renamings = {k: V2_RENAMED_KEYS[k] for k in sorted(deprecated_renamed_keys)}
+        renamed_bullets = [f'* {k!r} has been renamed to {v!r}' for k, v in renamings.items()]
+        removed_bullets = [f'* {k!r} has been removed' for k in sorted(deprecated_removed_keys)]
+        message = '\n'.join(['Valid config keys have changed in V2:'] + renamed_bullets + removed_bullets)
+        warnings.warn(message, UserWarning)
diff --git a/lib/pydantic/_internal/_core_metadata.py b/lib/pydantic/_internal/_core_metadata.py
new file mode 100644
index 00000000..296d49f5
--- /dev/null
+++ b/lib/pydantic/_internal/_core_metadata.py
@@ -0,0 +1,92 @@
+from __future__ import annotations as _annotations
+
+import typing
+from typing import Any
+
+import typing_extensions
+
+if typing.TYPE_CHECKING:
+    from ._schema_generation_shared import (
+        CoreSchemaOrField as CoreSchemaOrField,
+    )
+    from ._schema_generation_shared import (
+        GetJsonSchemaFunction,
+    )
+
+
+class CoreMetadata(typing_extensions.TypedDict, total=False):
+    """A `TypedDict` for holding the metadata dict of the schema.
+
+    Attributes:
+        pydantic_js_functions: List of JSON schema functions.
+        pydantic_js_prefer_positional_arguments: Whether JSON schema generator will
+            prefer positional over keyword arguments for an 'arguments' schema.
+    """
+
+    pydantic_js_functions: list[GetJsonSchemaFunction]
+    pydantic_js_annotation_functions: list[GetJsonSchemaFunction]
+
+    # If `pydantic_js_prefer_positional_arguments` is True, the JSON schema generator will
+    # prefer positional over keyword arguments for an 'arguments' schema.
+    pydantic_js_prefer_positional_arguments: bool | None
+
+    pydantic_typed_dict_cls: type[Any] | None  # TODO: Consider moving this into the pydantic-core TypedDictSchema
+
+
+class CoreMetadataHandler:
+    """Because the metadata field in pydantic_core is of type `Any`, we can't assume much about its contents.
+
+    This class is used to interact with the metadata field on a CoreSchema object in a consistent
+    way throughout pydantic.
+    """
+
+    __slots__ = ('_schema',)
+
+    def __init__(self, schema: CoreSchemaOrField):
+        self._schema = schema
+
+        metadata = schema.get('metadata')
+        if metadata is None:
+            schema['metadata'] = CoreMetadata()
+        elif not isinstance(metadata, dict):
+            raise TypeError(f'CoreSchema metadata should be a dict; got {metadata!r}.')
+
+    @property
+    def metadata(self) -> CoreMetadata:
+        """Retrieves the metadata dict from the schema, initializing it to a dict if it is None
+        and raises an error if it is not a dict.
+        """
+        metadata = self._schema.get('metadata')
+        if metadata is None:
+            self._schema['metadata'] = metadata = CoreMetadata()
+        if not isinstance(metadata, dict):
+            raise TypeError(f'CoreSchema metadata should be a dict; got {metadata!r}.')
+        return metadata
+
+
+def build_metadata_dict(
+    *,  # force keyword arguments to make it easier to modify this signature in a backwards-compatible way
+    js_functions: list[GetJsonSchemaFunction] | None = None,
+    js_annotation_functions: list[GetJsonSchemaFunction] | None = None,
+    js_prefer_positional_arguments: bool | None = None,
+    typed_dict_cls: type[Any] | None = None,
+    initial_metadata: Any | None = None,
+) -> Any:
+    """Builds a dict to use as the metadata field of a CoreSchema object in a manner that is consistent
+    with the CoreMetadataHandler class.
+    """
+    if initial_metadata is not None and not isinstance(initial_metadata, dict):
+        raise TypeError(f'CoreSchema metadata should be a dict; got {initial_metadata!r}.')
+
+    metadata = CoreMetadata(
+        pydantic_js_functions=js_functions or [],
+        pydantic_js_annotation_functions=js_annotation_functions or [],
+        pydantic_js_prefer_positional_arguments=js_prefer_positional_arguments,
+        pydantic_typed_dict_cls=typed_dict_cls,
+    )
+    metadata = {k: v for k, v in metadata.items() if v is not None}
+
+    if initial_metadata is not None:
+        metadata = {**initial_metadata, **metadata}
+
+    return metadata
diff --git a/lib/pydantic/_internal/_core_utils.py b/lib/pydantic/_internal/_core_utils.py
new file mode 100644
index 00000000..e74c74ac
--- /dev/null
+++ b/lib/pydantic/_internal/_core_utils.py
@@ -0,0 +1,570 @@
+from __future__ import annotations
+
+import os
+from collections import defaultdict
+from typing import (
+    Any,
+    Callable,
+    Hashable,
+    TypeVar,
+    Union,
+)
+
+from pydantic_core import CoreSchema, core_schema
+from pydantic_core import validate_core_schema as _validate_core_schema
+from typing_extensions import TypeAliasType, TypeGuard, get_args, get_origin
+
+from . import _repr
+from ._typing_extra import is_generic_alias
+
+AnyFunctionSchema = Union[
+    core_schema.AfterValidatorFunctionSchema,
+    core_schema.BeforeValidatorFunctionSchema,
+    core_schema.WrapValidatorFunctionSchema,
+    core_schema.PlainValidatorFunctionSchema,
+]
+
+
+FunctionSchemaWithInnerSchema = Union[
+    core_schema.AfterValidatorFunctionSchema,
+    core_schema.BeforeValidatorFunctionSchema,
+    core_schema.WrapValidatorFunctionSchema,
+]
+
+CoreSchemaField = Union[
+    core_schema.ModelField, core_schema.DataclassField, core_schema.TypedDictField, core_schema.ComputedField
+]
+CoreSchemaOrField = Union[core_schema.CoreSchema, CoreSchemaField]
+
+_CORE_SCHEMA_FIELD_TYPES = {'typed-dict-field', 'dataclass-field', 'model-field', 'computed-field'}
+_FUNCTION_WITH_INNER_SCHEMA_TYPES = {'function-before', 'function-after', 'function-wrap'}
+_LIST_LIKE_SCHEMA_WITH_ITEMS_TYPES = {'list', 'set', 'frozenset'}
+
+_DEFINITIONS_CACHE_METADATA_KEY = 'pydantic.definitions_cache'
+
+TAGGED_UNION_TAG_KEY = 'pydantic.internal.tagged_union_tag'
+"""
+Used in a `Tag` schema to specify the tag used for a discriminated union.
+"""
+HAS_INVALID_SCHEMAS_METADATA_KEY = 'pydantic.internal.invalid'
+"""Used to mark a schema that is invalid because it refers to a definition that was not yet defined when the
+schema was first encountered.
+"""
+
+
+def is_core_schema(
+    schema: CoreSchemaOrField,
+) -> TypeGuard[CoreSchema]:
+    return schema['type'] not in _CORE_SCHEMA_FIELD_TYPES
+
+
+def is_core_schema_field(
+    schema: CoreSchemaOrField,
+) -> TypeGuard[CoreSchemaField]:
+    return schema['type'] in _CORE_SCHEMA_FIELD_TYPES
+
+
+def is_function_with_inner_schema(
+    schema: CoreSchemaOrField,
+) -> TypeGuard[FunctionSchemaWithInnerSchema]:
+    return schema['type'] in _FUNCTION_WITH_INNER_SCHEMA_TYPES
+
+
+def is_list_like_schema_with_items_schema(
+    schema: CoreSchema,
+) -> TypeGuard[core_schema.ListSchema | core_schema.SetSchema | core_schema.FrozenSetSchema]:
+    return schema['type'] in _LIST_LIKE_SCHEMA_WITH_ITEMS_TYPES
+
+
+def get_type_ref(type_: type[Any], args_override: tuple[type[Any], ...] | None = None) -> str:
+    """Produces the ref to be used for this type by pydantic_core's core schemas.
+
+    This `args_override` argument was added for the purpose of creating valid recursive references
+    when creating generic models without needing to create a concrete class.
+    """
+    origin = get_origin(type_) or type_
+
+    args = get_args(type_) if is_generic_alias(type_) else (args_override or ())
+    generic_metadata = getattr(type_, '__pydantic_generic_metadata__', None)
+    if generic_metadata:
+        origin = generic_metadata['origin'] or origin
+        args = generic_metadata['args'] or args
+
+    module_name = getattr(origin, '__module__', '<No __module__>')
+    if isinstance(origin, TypeAliasType):
+        type_ref = f'{module_name}.{origin.__name__}:{id(origin)}'
+    else:
+        try:
+            qualname = getattr(origin, '__qualname__', f'<No __qualname__: {origin}>')
+        except Exception:
+            qualname = getattr(origin, '__qualname__', '<No __qualname__>')
+        type_ref = f'{module_name}.{qualname}:{id(origin)}'
+
+    arg_refs: list[str] = []
+    for arg in args:
+        if isinstance(arg, str):
+            # Handle string literals as a special case; we may be able to remove this special handling if we
+            # wrap them in a ForwardRef at some point.
+            arg_ref = f'{arg}:str-{id(arg)}'
+        else:
+            arg_ref = f'{_repr.display_as_type(arg)}:{id(arg)}'
+        arg_refs.append(arg_ref)
+    if arg_refs:
+        type_ref = f'{type_ref}[{",".join(arg_refs)}]'
+    return type_ref
+
+
+def get_ref(s: core_schema.CoreSchema) -> None | str:
+    """Get the ref from the schema if it has one.
+    This exists just for type checking to work correctly.
+    """
+    return s.get('ref', None)
+
+
+def collect_definitions(schema: core_schema.CoreSchema) -> dict[str, core_schema.CoreSchema]:
+    defs: dict[str, CoreSchema] = {}
+
+    def _record_valid_refs(s: core_schema.CoreSchema, recurse: Recurse) -> core_schema.CoreSchema:
+        ref = get_ref(s)
+        if ref:
+            defs[ref] = s
+        return recurse(s, _record_valid_refs)
+
+    walk_core_schema(schema, _record_valid_refs)
+
+    return defs
+
+
+def define_expected_missing_refs(
+    schema: core_schema.CoreSchema, allowed_missing_refs: set[str]
+) -> core_schema.CoreSchema | None:
+    if not allowed_missing_refs:
+        # in this case, there are no missing refs to potentially substitute, so there's no need to walk the schema
+        # this is a common case (will be hit for all non-generic models), so it's worth optimizing for
+        return None
+
+    refs = collect_definitions(schema).keys()
+
+    expected_missing_refs = allowed_missing_refs.difference(refs)
+    if expected_missing_refs:
+        definitions: list[core_schema.CoreSchema] = [
+            # TODO: Replace this with a (new) CoreSchema that, if present at any level, makes validation fail
+            #   Issue: https://github.com/pydantic/pydantic-core/issues/619
+            core_schema.none_schema(ref=ref, metadata={HAS_INVALID_SCHEMAS_METADATA_KEY: True})
+            for ref in expected_missing_refs
+        ]
+        return core_schema.definitions_schema(schema, definitions)
+    return None
+
+
+def collect_invalid_schemas(schema: core_schema.CoreSchema) -> bool:
+    invalid = False
+
+    def _is_schema_valid(s: core_schema.CoreSchema, recurse: Recurse) -> core_schema.CoreSchema:
+        nonlocal invalid
+        if 'metadata' in s:
+            metadata = s['metadata']
+            if HAS_INVALID_SCHEMAS_METADATA_KEY in metadata:
+                invalid = metadata[HAS_INVALID_SCHEMAS_METADATA_KEY]
+                return s
+        return recurse(s, _is_schema_valid)
+
+    walk_core_schema(schema, _is_schema_valid)
+    return invalid
+
+
+T = TypeVar('T')
+
+
+Recurse = Callable[[core_schema.CoreSchema, 'Walk'], core_schema.CoreSchema]
+Walk = Callable[[core_schema.CoreSchema, Recurse], core_schema.CoreSchema]
+
+# TODO: Should we move _WalkCoreSchema into pydantic_core proper?
+#   Issue: https://github.com/pydantic/pydantic-core/issues/615
+
+
+class _WalkCoreSchema:
+    def __init__(self):
+        self._schema_type_to_method = self._build_schema_type_to_method()
+
+    def _build_schema_type_to_method(self) -> dict[core_schema.CoreSchemaType, Recurse]:
+        mapping: dict[core_schema.CoreSchemaType, Recurse] = {}
+        key: core_schema.CoreSchemaType
+        for key in get_args(core_schema.CoreSchemaType):
+            method_name = f"handle_{key.replace('-', '_')}_schema"
+            mapping[key] = getattr(self, method_name, self._handle_other_schemas)
+        return mapping
+
+    def walk(self, schema: core_schema.CoreSchema, f: Walk) -> core_schema.CoreSchema:
+        return f(schema, self._walk)
+
+    def _walk(self, schema: core_schema.CoreSchema, f: Walk) -> core_schema.CoreSchema:
+        schema = self._schema_type_to_method[schema['type']](schema.copy(), f)
+        ser_schema: core_schema.SerSchema | None = schema.get('serialization')  # type: ignore
+        if ser_schema:
+            schema['serialization'] = self._handle_ser_schemas(ser_schema, f)
+        return schema
+
+    def _handle_other_schemas(self, schema: core_schema.CoreSchema, f: Walk) -> core_schema.CoreSchema:
+        sub_schema = schema.get('schema', None)
+        if sub_schema is not None:
+            schema['schema'] = self.walk(sub_schema, f)  # type: ignore
+        return schema
+
+    def _handle_ser_schemas(self, ser_schema: core_schema.SerSchema, f: Walk) -> core_schema.SerSchema:
+        schema: core_schema.CoreSchema | None = ser_schema.get('schema', None)
+        if schema is not None:
+            ser_schema['schema'] = self.walk(schema, f)  # type: ignore
+        return_schema: core_schema.CoreSchema | None = ser_schema.get('return_schema', None)
+        if return_schema is not None:
+            ser_schema['return_schema'] = self.walk(return_schema, f)  # type: ignore
+        return ser_schema
+
+    def handle_definitions_schema(self, schema: core_schema.DefinitionsSchema, f: Walk) -> core_schema.CoreSchema:
+        new_definitions: list[core_schema.CoreSchema] = []
+        for definition in schema['definitions']:
+            if 'schema_ref' in definition and 'ref' in definition:
+                # This indicates a purposely indirect reference
+                # We want to keep such references around for implications related to JSON schema, etc.:
+                new_definitions.append(definition)
+                # However, we still need to walk the referenced definition:
+                self.walk(definition, f)
+                continue
+
+            updated_definition = self.walk(definition, f)
+            if 'ref' in updated_definition:
+                # If the updated definition schema doesn't have a 'ref', it shouldn't go in the definitions
+                # This is most likely to happen due to replacing something with a definition reference, in
+                # which case it should certainly not go in the definitions list
+                new_definitions.append(updated_definition)
+        new_inner_schema = self.walk(schema['schema'], f)
+
+        if not new_definitions and len(schema) == 3:
+            # This means we'd be returning a "trivial" definitions schema that just wrapped the inner schema
+            return new_inner_schema
+
+        new_schema = schema.copy()
+        new_schema['schema'] = new_inner_schema
+        new_schema['definitions'] = new_definitions
+        return new_schema
+
+    def handle_list_schema(self, schema: core_schema.ListSchema, f: Walk) -> core_schema.CoreSchema:
+        items_schema = schema.get('items_schema')
+        if items_schema is not None:
+            schema['items_schema'] = self.walk(items_schema, f)
+        return schema
+
+    def handle_set_schema(self, schema: core_schema.SetSchema, f: Walk) -> core_schema.CoreSchema:
+        items_schema = schema.get('items_schema')
+        if items_schema is not None:
+            schema['items_schema'] = self.walk(items_schema, f)
+        return schema
+
+    def handle_frozenset_schema(self, schema: core_schema.FrozenSetSchema, f: Walk) -> core_schema.CoreSchema:
+        items_schema = schema.get('items_schema')
+        if items_schema is not None:
+            schema['items_schema'] = self.walk(items_schema, f)
+        return schema
+
+    def handle_generator_schema(self, schema: core_schema.GeneratorSchema, f: Walk) -> core_schema.CoreSchema:
+        items_schema = schema.get('items_schema')
+        if items_schema is not None:
+            schema['items_schema'] = self.walk(items_schema, f)
+        return schema
+
+    def handle_tuple_schema(self, schema: core_schema.TupleSchema, f: Walk) -> core_schema.CoreSchema:
+        schema['items_schema'] = [self.walk(v, f) for v in schema['items_schema']]
+        return schema
+
+    def handle_dict_schema(self, schema: core_schema.DictSchema, f: Walk) -> core_schema.CoreSchema:
+        keys_schema = schema.get('keys_schema')
+        if keys_schema is not None:
+            schema['keys_schema'] = self.walk(keys_schema, f)
+        values_schema = schema.get('values_schema')
+        if values_schema:
+            schema['values_schema'] = self.walk(values_schema, f)
+        return schema
+
+    def handle_function_schema(self, schema: AnyFunctionSchema, f: Walk) -> core_schema.CoreSchema:
+        if not is_function_with_inner_schema(schema):
+            return schema
+        schema['schema'] = self.walk(schema['schema'], f)
+        return schema
+
+    def handle_union_schema(self, schema: core_schema.UnionSchema, f: Walk) -> core_schema.CoreSchema:
+        new_choices: list[CoreSchema | tuple[CoreSchema, str]] = []
+        for v in schema['choices']:
+            if isinstance(v, tuple):
+                new_choices.append((self.walk(v[0], f), v[1]))
+            else:
+                new_choices.append(self.walk(v, f))
+        schema['choices'] = new_choices
+        return schema
+
+    def handle_tagged_union_schema(self, schema: core_schema.TaggedUnionSchema, f: Walk) -> core_schema.CoreSchema:
+        new_choices: dict[Hashable, core_schema.CoreSchema] = {}
+        for k, v in schema['choices'].items():
+            new_choices[k] = v if isinstance(v, (str, int)) else self.walk(v, f)
+        schema['choices'] = new_choices
+        return schema
+
+    def handle_chain_schema(self, schema: core_schema.ChainSchema, f: Walk) -> core_schema.CoreSchema:
+        schema['steps'] = [self.walk(v, f) for v in schema['steps']]
+        return schema
+
+    def handle_lax_or_strict_schema(self, schema: core_schema.LaxOrStrictSchema, f: Walk) -> core_schema.CoreSchema:
+        schema['lax_schema'] = self.walk(schema['lax_schema'], f)
+        schema['strict_schema'] = self.walk(schema['strict_schema'], f)
+        return schema
+
+    def handle_json_or_python_schema(self, schema: core_schema.JsonOrPythonSchema, f: Walk) -> core_schema.CoreSchema:
+        schema['json_schema'] = self.walk(schema['json_schema'], f)
+        schema['python_schema'] = self.walk(schema['python_schema'], f)
+        return schema
+
+    def handle_model_fields_schema(self, schema: core_schema.ModelFieldsSchema, f: Walk) -> core_schema.CoreSchema:
+        extras_schema = schema.get('extras_schema')
+        if extras_schema is not None:
+            schema['extras_schema'] = self.walk(extras_schema, f)
+        replaced_fields: dict[str, core_schema.ModelField] = {}
+        replaced_computed_fields: list[core_schema.ComputedField] = []
+        for computed_field in schema.get('computed_fields', ()):
+            replaced_field = computed_field.copy()
+            replaced_field['return_schema'] = self.walk(computed_field['return_schema'], f)
+            replaced_computed_fields.append(replaced_field)
+        if replaced_computed_fields:
+            schema['computed_fields'] = replaced_computed_fields
+        for k, v in schema['fields'].items():
+            replaced_field = v.copy()
+            replaced_field['schema'] = self.walk(v['schema'], f)
+            replaced_fields[k] = replaced_field
+        schema['fields'] = replaced_fields
+        return schema
+
+    def handle_typed_dict_schema(self, schema: core_schema.TypedDictSchema, f: Walk) -> core_schema.CoreSchema:
+        extras_schema = schema.get('extras_schema')
+        if extras_schema is not None:
+            schema['extras_schema'] = self.walk(extras_schema, f)
+        replaced_computed_fields: list[core_schema.ComputedField] = []
+        for computed_field in schema.get('computed_fields', ()):
+            replaced_field = computed_field.copy()
+            replaced_field['return_schema'] = self.walk(computed_field['return_schema'], f)
+            replaced_computed_fields.append(replaced_field)
+        if replaced_computed_fields:
+            schema['computed_fields'] = replaced_computed_fields
+        replaced_fields: dict[str, core_schema.TypedDictField] = {}
+        for k, v in schema['fields'].items():
+            replaced_field = v.copy()
+            replaced_field['schema'] = self.walk(v['schema'], f)
+            replaced_fields[k] = replaced_field
+        schema['fields'] = replaced_fields
+        return schema
+
+    def handle_dataclass_args_schema(self, schema: core_schema.DataclassArgsSchema, f: Walk) -> core_schema.CoreSchema:
+        replaced_fields: list[core_schema.DataclassField] = []
+        replaced_computed_fields: list[core_schema.ComputedField] = []
+        for computed_field in schema.get('computed_fields', ()):
+            replaced_field = computed_field.copy()
+            replaced_field['return_schema'] = self.walk(computed_field['return_schema'], f)
+            replaced_computed_fields.append(replaced_field)
+        if replaced_computed_fields:
+            schema['computed_fields'] = replaced_computed_fields
+        for field in schema['fields']:
+            replaced_field = field.copy()
+            replaced_field['schema'] = self.walk(field['schema'], f)
+            replaced_fields.append(replaced_field)
+        schema['fields'] = replaced_fields
+        return schema
+
+    def handle_arguments_schema(self, schema: core_schema.ArgumentsSchema, f: Walk) -> core_schema.CoreSchema:
+        replaced_arguments_schema: list[core_schema.ArgumentsParameter] = []
+        for param in schema['arguments_schema']:
+            replaced_param = param.copy()
+            replaced_param['schema'] = self.walk(param['schema'], f)
+            replaced_arguments_schema.append(replaced_param)
+        schema['arguments_schema'] = replaced_arguments_schema
+        if 'var_args_schema' in schema:
+            schema['var_args_schema'] = self.walk(schema['var_args_schema'], f)
+        if 'var_kwargs_schema' in schema:
+            schema['var_kwargs_schema'] = self.walk(schema['var_kwargs_schema'], f)
+        return schema
+
+    def handle_call_schema(self, schema: core_schema.CallSchema, f: Walk) -> core_schema.CoreSchema:
+        schema['arguments_schema'] = self.walk(schema['arguments_schema'], f)
+        if 'return_schema' in schema:
+            schema['return_schema'] = self.walk(schema['return_schema'], f)
+        return schema
+
+
+_dispatch = _WalkCoreSchema().walk
+
+
+def walk_core_schema(schema: core_schema.CoreSchema, f: Walk) -> core_schema.CoreSchema:
+    """Recursively traverse a CoreSchema.
+
+    Args:
+        schema (core_schema.CoreSchema): The CoreSchema to process, it will not be modified.
+        f (Walk): A function to apply. This function takes two arguments:
+          1. The current CoreSchema that is being processed
+             (not the same one you passed into this function, one level down).
+          2. The "next" `f` to call. This lets you for example use `f=functools.partial(some_method, some_context)`
+             to pass data down the recursive calls without using globals or other mutable state.
+
+    Returns:
+        core_schema.CoreSchema: A processed CoreSchema.
+    """
+    return f(schema.copy(), _dispatch)
+
+
+def simplify_schema_references(schema: core_schema.CoreSchema) -> core_schema.CoreSchema:  # noqa: C901
+    definitions: dict[str, core_schema.CoreSchema] = {}
+    ref_counts: dict[str, int] = defaultdict(int)
+    involved_in_recursion: dict[str, bool] = {}
+    current_recursion_ref_count: dict[str, int] = defaultdict(int)
+
+    def collect_refs(s: core_schema.CoreSchema, recurse: Recurse) -> core_schema.CoreSchema:
+        if s['type'] == 'definitions':
+            for definition in s['definitions']:
+                ref = get_ref(definition)
+                assert ref is not None
+                if ref not in definitions:
+                    definitions[ref] = definition
+                recurse(definition, collect_refs)
+            return recurse(s['schema'], collect_refs)
+        else:
+            ref = get_ref(s)
+            if ref is not None:
+                new = recurse(s, collect_refs)
+                new_ref = get_ref(new)
+                if new_ref:
+                    definitions[new_ref] = new
+                return core_schema.definition_reference_schema(schema_ref=ref)
+            else:
+                return recurse(s, collect_refs)
+
+    schema = walk_core_schema(schema, collect_refs)
+
+    def count_refs(s: core_schema.CoreSchema, recurse: Recurse) -> core_schema.CoreSchema:
+        if s['type'] != 'definition-ref':
+            return recurse(s, count_refs)
+        ref = s['schema_ref']
+        ref_counts[ref] += 1
+
+        if ref_counts[ref] >= 2:
+            # If this model is involved in a recursion this should be detected
+            # on its second encounter, we can safely stop the walk here.
+            if current_recursion_ref_count[ref] != 0:
+                involved_in_recursion[ref] = True
+            return s
+
+        current_recursion_ref_count[ref] += 1
+        recurse(definitions[ref], count_refs)
+        current_recursion_ref_count[ref] -= 1
+        return s
+
+    schema = walk_core_schema(schema, count_refs)
+
+    assert all(c == 0 for c in current_recursion_ref_count.values()), 'this is a bug! please report it'
+
+    def can_be_inlined(s: core_schema.DefinitionReferenceSchema, ref: str) -> bool:
+        if ref_counts[ref] > 1:
+            return False
+        if involved_in_recursion.get(ref, False):
+            return False
+        if 'serialization' in s:
+            return False
+        if 'metadata' in s:
+            metadata = s['metadata']
+            for k in (
+                'pydantic_js_functions',
+                'pydantic_js_annotation_functions',
+                'pydantic.internal.union_discriminator',
+            ):
+                if k in metadata:
+                    # we need to keep this as a ref
+                    return False
+        return True
+
+    def inline_refs(s: core_schema.CoreSchema, recurse: Recurse) -> core_schema.CoreSchema:
+        if s['type'] == 'definition-ref':
+            ref = s['schema_ref']
+            # Check if the reference is only used once, not involved in recursion and does not have
+            # any extra keys (like 'serialization')
+            if can_be_inlined(s, ref):
+                # Inline the reference by replacing the reference with the actual schema
+                new = definitions.pop(ref)
+                ref_counts[ref] -= 1  # because we just replaced it!
+                # put all other keys that were on the def-ref schema into the inlined version
+                # in particular this is needed for `serialization`
+                if 'serialization' in s:
+                    new['serialization'] = s['serialization']
+                s = recurse(new, inline_refs)
+                return s
+            else:
+                return recurse(s, inline_refs)
+        else:
+            return recurse(s, inline_refs)
+
+    schema = walk_core_schema(schema, inline_refs)
+
+    def_values = [v for v in definitions.values() if ref_counts[v['ref']] > 0]  # type: ignore
+
+    if def_values:
+        schema = core_schema.definitions_schema(schema=schema, definitions=def_values)
+    return schema
+
+
+def _strip_metadata(schema: CoreSchema) -> CoreSchema:
+    def strip_metadata(s: CoreSchema, recurse: Recurse) -> CoreSchema:
+        s = s.copy()
+        s.pop('metadata', None)
+        if s['type'] == 'model-fields':
+            s = s.copy()
+            s['fields'] = {k: v.copy() for k, v in s['fields'].items()}
+            for field_name, field_schema in s['fields'].items():
+                field_schema.pop('metadata', None)
+                s['fields'][field_name] = field_schema
+            computed_fields = s.get('computed_fields', None)
+            if computed_fields:
+                s['computed_fields'] = [cf.copy() for cf in computed_fields]
+                for cf in computed_fields:
+                    cf.pop('metadata', None)
+            else:
+                s.pop('computed_fields', None)
+        elif s['type'] == 'model':
+            # remove some defaults
+            if s.get('custom_init', True) is False:
+                s.pop('custom_init')
+            if s.get('root_model', True) is False:
+                s.pop('root_model')
+            if {'title'}.issuperset(s.get('config', {}).keys()):
+                s.pop('config', None)
+
+        return recurse(s, strip_metadata)
+
+    return walk_core_schema(schema, strip_metadata)
+
+
+def pretty_print_core_schema(
+    schema: CoreSchema,
+    include_metadata: bool = False,
+) -> None:
+    """Pretty print a CoreSchema using rich.
+    This is intended for debugging purposes.
+
+    Args:
+        schema: The CoreSchema to print.
+        include_metadata: Whether to include metadata in the output. Defaults to `False`.
+    """
+    from rich import print  # type: ignore  # install it manually in your dev env
+
+    if not include_metadata:
+        schema = _strip_metadata(schema)
+
+    return print(schema)
+
+
+def validate_core_schema(schema: CoreSchema) -> CoreSchema:
+    if 'PYDANTIC_SKIP_VALIDATING_CORE_SCHEMAS' in os.environ:
+        return schema
+    return _validate_core_schema(schema)
diff --git a/lib/pydantic/_internal/_dataclasses.py b/lib/pydantic/_internal/_dataclasses.py
new file mode 100644
index 00000000..1ec23044
--- /dev/null
+++ b/lib/pydantic/_internal/_dataclasses.py
@@ -0,0 +1,225 @@
+"""Private logic for creating pydantic dataclasses."""
+from __future__ import annotations as _annotations
+
+import dataclasses
+import typing
+import warnings
+from functools import partial, wraps
+from typing import Any, Callable, ClassVar
+
+from pydantic_core import (
+    ArgsKwargs,
+    SchemaSerializer,
+    SchemaValidator,
+    core_schema,
+)
+from typing_extensions import TypeGuard
+
+from ..errors import PydanticUndefinedAnnotation
+from ..fields import FieldInfo
+from ..plugin._schema_validator import create_schema_validator
+from ..warnings import PydanticDeprecatedSince20
+from . import _config, _decorators, _typing_extra
+from ._fields import collect_dataclass_fields
+from ._generate_schema import GenerateSchema
+from ._generics import get_standard_typevars_map
+from ._mock_val_ser import set_dataclass_mocks
+from ._schema_generation_shared import CallbackGetCoreSchemaHandler
+from ._signature import generate_pydantic_signature
+
+if typing.TYPE_CHECKING:
+    from ..config import ConfigDict
+
+    class StandardDataclass(typing.Protocol):
+        __dataclass_fields__: ClassVar[dict[str, Any]]
+        __dataclass_params__: ClassVar[Any]  # in reality `dataclasses._DataclassParams`
+        __post_init__: ClassVar[Callable[..., None]]
+
+        def __init__(self, *args: object, **kwargs: object) -> None:
+            pass
+
+    class PydanticDataclass(StandardDataclass, typing.Protocol):
+        """A protocol containing attributes only available once a class has been decorated as a Pydantic dataclass.
+
+        Attributes:
+            __pydantic_config__: Pydantic-specific configuration settings for the dataclass.
+            __pydantic_complete__: Whether dataclass building is completed, or if there are still undefined fields.
+            __pydantic_core_schema__: The pydantic-core schema used to build the SchemaValidator and SchemaSerializer.
+            __pydantic_decorators__: Metadata containing the decorators defined on the dataclass.
+            __pydantic_fields__: Metadata about the fields defined on the dataclass.
+            __pydantic_serializer__: The pydantic-core SchemaSerializer used to dump instances of the dataclass.
+            __pydantic_validator__: The pydantic-core SchemaValidator used to validate instances of the dataclass.
+        """
+
+        __pydantic_config__: ClassVar[ConfigDict]
+        __pydantic_complete__: ClassVar[bool]
+        __pydantic_core_schema__: ClassVar[core_schema.CoreSchema]
+        __pydantic_decorators__: ClassVar[_decorators.DecoratorInfos]
+        __pydantic_fields__: ClassVar[dict[str, FieldInfo]]
+        __pydantic_serializer__: ClassVar[SchemaSerializer]
+        __pydantic_validator__: ClassVar[SchemaValidator]
+
+else:
+    # See PyCharm issues https://youtrack.jetbrains.com/issue/PY-21915
+    # and https://youtrack.jetbrains.com/issue/PY-51428
+    DeprecationWarning = PydanticDeprecatedSince20
+
+
+def set_dataclass_fields(cls: type[StandardDataclass], types_namespace: dict[str, Any] | None = None) -> None:
+    """Collect and set `cls.__pydantic_fields__`.
+
+    Args:
+        cls: The class.
+        types_namespace: The types namespace, defaults to `None`.
+    """
+    typevars_map = get_standard_typevars_map(cls)
+    fields = collect_dataclass_fields(cls, types_namespace, typevars_map=typevars_map)
+
+    cls.__pydantic_fields__ = fields  # type: ignore
+
+
+def complete_dataclass(
+    cls: type[Any],
+    config_wrapper: _config.ConfigWrapper,
+    *,
+    raise_errors: bool = True,
+    types_namespace: dict[str, Any] | None,
+) -> bool:
+    """Finish building a pydantic dataclass.
+
+    This logic is called on a class which has already been wrapped in `dataclasses.dataclass()`.
+
+    This is somewhat analogous to `pydantic._internal._model_construction.complete_model_class`.
+
+    Args:
+        cls: The class.
+        config_wrapper: The config wrapper instance.
+        raise_errors: Whether to raise errors, defaults to `True`.
+        types_namespace: The types namespace.
+
+    Returns:
+        `True` if building a pydantic dataclass is successfully completed, `False` otherwise.
+
+    Raises:
+        PydanticUndefinedAnnotation: If `raise_error` is `True` and there is an undefined annotations.
+    """
+    if hasattr(cls, '__post_init_post_parse__'):
+        warnings.warn(
+            'Support for `__post_init_post_parse__` has been dropped, the method will not be called', DeprecationWarning
+        )
+
+    if types_namespace is None:
+        types_namespace = _typing_extra.get_cls_types_namespace(cls)
+
+    set_dataclass_fields(cls, types_namespace)
+
+    typevars_map = get_standard_typevars_map(cls)
+    gen_schema = GenerateSchema(
+        config_wrapper,
+        types_namespace,
+        typevars_map,
+    )
+
+    # This needs to be called before we change the __init__
+    sig = generate_pydantic_signature(
+        init=cls.__init__,
+        fields=cls.__pydantic_fields__,  # type: ignore
+        config_wrapper=config_wrapper,
+        is_dataclass=True,
+    )
+
+    # dataclass.__init__ must be defined here so its `__qualname__` can be changed since functions can't be copied.
+    def __init__(__dataclass_self__: PydanticDataclass, *args: Any, **kwargs: Any) -> None:
+        __tracebackhide__ = True
+        s = __dataclass_self__
+        s.__pydantic_validator__.validate_python(ArgsKwargs(args, kwargs), self_instance=s)
+
+    __init__.__qualname__ = f'{cls.__qualname__}.__init__'
+
+    cls.__init__ = __init__  # type: ignore
+    cls.__pydantic_config__ = config_wrapper.config_dict  # type: ignore
+    cls.__signature__ = sig  # type: ignore
+    get_core_schema = getattr(cls, '__get_pydantic_core_schema__', None)
+    try:
+        if get_core_schema:
+            schema = get_core_schema(
+                cls,
+                CallbackGetCoreSchemaHandler(
+                    partial(gen_schema.generate_schema, from_dunder_get_core_schema=False),
+                    gen_schema,
+                    ref_mode='unpack',
+                ),
+            )
+        else:
+            schema = gen_schema.generate_schema(cls, from_dunder_get_core_schema=False)
+    except PydanticUndefinedAnnotation as e:
+        if raise_errors:
+            raise
+        set_dataclass_mocks(cls, cls.__name__, f'`{e.name}`')
+        return False
+
+    core_config = config_wrapper.core_config(cls)
+
+    try:
+        schema = gen_schema.clean_schema(schema)
+    except gen_schema.CollectedInvalid:
+        set_dataclass_mocks(cls, cls.__name__, 'all referenced types')
+        return False
+
+    # We are about to set all the remaining required properties expected for this cast;
+    # __pydantic_decorators__ and __pydantic_fields__ should already be set
+    cls = typing.cast('type[PydanticDataclass]', cls)
+    # debug(schema)
+
+    cls.__pydantic_core_schema__ = schema
+    cls.__pydantic_validator__ = validator = create_schema_validator(
+        schema, cls, cls.__module__, cls.__qualname__, 'dataclass', core_config, config_wrapper.plugin_settings
+    )
+    cls.__pydantic_serializer__ = SchemaSerializer(schema, core_config)
+
+    if config_wrapper.validate_assignment:
+
+        @wraps(cls.__setattr__)
+        def validated_setattr(instance: Any, __field: str, __value: str) -> None:
+            validator.validate_assignment(instance, __field, __value)
+
+        cls.__setattr__ = validated_setattr.__get__(None, cls)  # type: ignore
+
+    return True
+
+
+def is_builtin_dataclass(_cls: type[Any]) -> TypeGuard[type[StandardDataclass]]:
+    """Returns True if a class is a stdlib dataclass and *not* a pydantic dataclass.
+
+    We check that
+    - `_cls` is a dataclass
+    - `_cls` does not inherit from a processed pydantic dataclass (and thus have a `__pydantic_validator__`)
+    - `_cls` does not have any annotations that are not dataclass fields
+    e.g.
+    ```py
+    import dataclasses
+
+    import pydantic.dataclasses
+
+    @dataclasses.dataclass
+    class A:
+        x: int
+
+    @pydantic.dataclasses.dataclass
+    class B(A):
+        y: int
+    ```
+    In this case, when we first check `B`, we make an extra check and look at the annotations ('y'),
+    which won't be a superset of all the dataclass fields (only the stdlib fields i.e. 'x')
+
+    Args:
+        cls: The class.
+
+    Returns:
+        `True` if the class is a stdlib dataclass, `False` otherwise.
+    """
+    return (
+        dataclasses.is_dataclass(_cls)
+        and not hasattr(_cls, '__pydantic_validator__')
+        and set(_cls.__dataclass_fields__).issuperset(set(getattr(_cls, '__annotations__', {})))
+    )
diff --git a/lib/pydantic/_internal/_decorators.py b/lib/pydantic/_internal/_decorators.py
new file mode 100644
index 00000000..5672464c
--- /dev/null
+++ b/lib/pydantic/_internal/_decorators.py
@@ -0,0 +1,791 @@
+"""Logic related to validators applied to models etc. via the `@field_validator` and `@model_validator` decorators."""
+from __future__ import annotations as _annotations
+
+from collections import deque
+from dataclasses import dataclass, field
+from functools import cached_property, partial, partialmethod
+from inspect import Parameter, Signature, isdatadescriptor, ismethoddescriptor, signature
+from itertools import islice
+from typing import TYPE_CHECKING, Any, Callable, ClassVar, Generic, Iterable, TypeVar, Union
+
+from pydantic_core import PydanticUndefined, core_schema
+from typing_extensions import Literal, TypeAlias, is_typeddict
+
+from ..errors import PydanticUserError
+from ._core_utils import get_type_ref
+from ._internal_dataclass import slots_true
+from ._typing_extra import get_function_type_hints
+
+if TYPE_CHECKING:
+    from ..fields import ComputedFieldInfo
+    from ..functional_validators import FieldValidatorModes
+
+
+@dataclass(**slots_true)
+class ValidatorDecoratorInfo:
+    """A container for data from `@validator` so that we can access it
+    while building the pydantic-core schema.
+
+    Attributes:
+        decorator_repr: A class variable representing the decorator string, '@validator'.
+        fields: A tuple of field names the validator should be called on.
+        mode: The proposed validator mode.
+        each_item: For complex objects (sets, lists etc.) whether to validate individual
+            elements rather than the whole object.
+        always: Whether this method and other validators should be called even if the value is missing.
+        check_fields: Whether to check that the fields actually exist on the model.
+    """
+
+    decorator_repr: ClassVar[str] = '@validator'
+
+    fields: tuple[str, ...]
+    mode: Literal['before', 'after']
+    each_item: bool
+    always: bool
+    check_fields: bool | None
+
+
+@dataclass(**slots_true)
+class FieldValidatorDecoratorInfo:
+    """A container for data from `@field_validator` so that we can access it
+    while building the pydantic-core schema.
+
+    Attributes:
+        decorator_repr: A class variable representing the decorator string, '@field_validator'.
+        fields: A tuple of field names the validator should be called on.
+        mode: The proposed validator mode.
+        check_fields: Whether to check that the fields actually exist on the model.
+    """
+
+    decorator_repr: ClassVar[str] = '@field_validator'
+
+    fields: tuple[str, ...]
+    mode: FieldValidatorModes
+    check_fields: bool | None
+
+
+@dataclass(**slots_true)
+class RootValidatorDecoratorInfo:
+    """A container for data from `@root_validator` so that we can access it
+    while building the pydantic-core schema.
+
+    Attributes:
+        decorator_repr: A class variable representing the decorator string, '@root_validator'.
+        mode: The proposed validator mode.
+    """
+
+    decorator_repr: ClassVar[str] = '@root_validator'
+    mode: Literal['before', 'after']
+
+
+@dataclass(**slots_true)
+class FieldSerializerDecoratorInfo:
+    """A container for data from `@field_serializer` so that we can access it
+    while building the pydantic-core schema.
+
+    Attributes:
+        decorator_repr: A class variable representing the decorator string, '@field_serializer'.
+        fields: A tuple of field names the serializer should be called on.
+        mode: The proposed serializer mode.
+        return_type: The type of the serializer's return value.
+        when_used: The serialization condition. Accepts a string with values `'always'`, `'unless-none'`, `'json'`,
+            and `'json-unless-none'`.
+        check_fields: Whether to check that the fields actually exist on the model.
+    """
+
+    decorator_repr: ClassVar[str] = '@field_serializer'
+    fields: tuple[str, ...]
+    mode: Literal['plain', 'wrap']
+    return_type: Any
+    when_used: core_schema.WhenUsed
+    check_fields: bool | None
+
+
+@dataclass(**slots_true)
+class ModelSerializerDecoratorInfo:
+    """A container for data from `@model_serializer` so that we can access it
+    while building the pydantic-core schema.
+
+    Attributes:
+        decorator_repr: A class variable representing the decorator string, '@model_serializer'.
+        mode: The proposed serializer mode.
+        return_type: The type of the serializer's return value.
+        when_used: The serialization condition. Accepts a string with values `'always'`, `'unless-none'`, `'json'`,
+            and `'json-unless-none'`.
+    """
+
+    decorator_repr: ClassVar[str] = '@model_serializer'
+    mode: Literal['plain', 'wrap']
+    return_type: Any
+    when_used: core_schema.WhenUsed
+
+
+@dataclass(**slots_true)
+class ModelValidatorDecoratorInfo:
+    """A container for data from `@model_validator` so that we can access it
+    while building the pydantic-core schema.
+
+    Attributes:
+        decorator_repr: A class variable representing the decorator string, '@model_serializer'.
+        mode: The proposed serializer mode.
+    """
+
+    decorator_repr: ClassVar[str] = '@model_validator'
+    mode: Literal['wrap', 'before', 'after']
+
+
+DecoratorInfo: TypeAlias = """Union[
+    ValidatorDecoratorInfo,
+    FieldValidatorDecoratorInfo,
+    RootValidatorDecoratorInfo,
+    FieldSerializerDecoratorInfo,
+    ModelSerializerDecoratorInfo,
+    ModelValidatorDecoratorInfo,
+    ComputedFieldInfo,
+]"""
+
+ReturnType = TypeVar('ReturnType')
+DecoratedType: TypeAlias = (
+    'Union[classmethod[Any, Any, ReturnType], staticmethod[Any, ReturnType], Callable[..., ReturnType], property]'
+)
+
+
+@dataclass  # can't use slots here since we set attributes on `__post_init__`
+class PydanticDescriptorProxy(Generic[ReturnType]):
+    """Wrap a classmethod, staticmethod, property or unbound function
+    and act as a descriptor that allows us to detect decorated items
+    from the class' attributes.
+
+    This class' __get__ returns the wrapped item's __get__ result,
+    which makes it transparent for classmethods and staticmethods.
+
+    Attributes:
+        wrapped: The decorator that has to be wrapped.
+        decorator_info: The decorator info.
+        shim: A wrapper function to wrap V1 style function.
+    """
+
+    wrapped: DecoratedType[ReturnType]
+    decorator_info: DecoratorInfo
+    shim: Callable[[Callable[..., Any]], Callable[..., Any]] | None = None
+
+    def __post_init__(self):
+        for attr in 'setter', 'deleter':
+            if hasattr(self.wrapped, attr):
+                f = partial(self._call_wrapped_attr, name=attr)
+                setattr(self, attr, f)
+
+    def _call_wrapped_attr(self, func: Callable[[Any], None], *, name: str) -> PydanticDescriptorProxy[ReturnType]:
+        self.wrapped = getattr(self.wrapped, name)(func)
+        return self
+
+    def __get__(self, obj: object | None, obj_type: type[object] | None = None) -> PydanticDescriptorProxy[ReturnType]:
+        try:
+            return self.wrapped.__get__(obj, obj_type)
+        except AttributeError:
+            # not a descriptor, e.g. a partial object
+            return self.wrapped  # type: ignore[return-value]
+
+    def __set_name__(self, instance: Any, name: str) -> None:
+        if hasattr(self.wrapped, '__set_name__'):
+            self.wrapped.__set_name__(instance, name)  # pyright: ignore[reportFunctionMemberAccess]
+
+    def __getattr__(self, __name: str) -> Any:
+        """Forward checks for __isabstractmethod__ and such."""
+        return getattr(self.wrapped, __name)
+
+
+DecoratorInfoType = TypeVar('DecoratorInfoType', bound=DecoratorInfo)
+
+
+@dataclass(**slots_true)
+class Decorator(Generic[DecoratorInfoType]):
+    """A generic container class to join together the decorator metadata
+    (metadata from decorator itself, which we have when the
+    decorator is called but not when we are building the core-schema)
+    and the bound function (which we have after the class itself is created).
+
+    Attributes:
+        cls_ref: The class ref.
+        cls_var_name: The decorated function name.
+        func: The decorated function.
+        shim: A wrapper function to wrap V1 style function.
+        info: The decorator info.
+    """
+
+    cls_ref: str
+    cls_var_name: str
+    func: Callable[..., Any]
+    shim: Callable[[Any], Any] | None
+    info: DecoratorInfoType
+
+    @staticmethod
+    def build(
+        cls_: Any,
+        *,
+        cls_var_name: str,
+        shim: Callable[[Any], Any] | None,
+        info: DecoratorInfoType,
+    ) -> Decorator[DecoratorInfoType]:
+        """Build a new decorator.
+
+        Args:
+            cls_: The class.
+            cls_var_name: The decorated function name.
+            shim: A wrapper function to wrap V1 style function.
+            info: The decorator info.
+
+        Returns:
+            The new decorator instance.
+        """
+        func = get_attribute_from_bases(cls_, cls_var_name)
+        if shim is not None:
+            func = shim(func)
+        func = unwrap_wrapped_function(func, unwrap_partial=False)
+        if not callable(func):
+            # This branch will get hit for classmethod properties
+            attribute = get_attribute_from_base_dicts(cls_, cls_var_name)  # prevents the binding call to `__get__`
+            if isinstance(attribute, PydanticDescriptorProxy):
+                func = unwrap_wrapped_function(attribute.wrapped)
+        return Decorator(
+            cls_ref=get_type_ref(cls_),
+            cls_var_name=cls_var_name,
+            func=func,
+            shim=shim,
+            info=info,
+        )
+
+    def bind_to_cls(self, cls: Any) -> Decorator[DecoratorInfoType]:
+        """Bind the decorator to a class.
+
+        Args:
+            cls: the class.
+
+        Returns:
+            The new decorator instance.
+        """
+        return self.build(
+            cls,
+            cls_var_name=self.cls_var_name,
+            shim=self.shim,
+            info=self.info,
+        )
+
+
+def get_bases(tp: type[Any]) -> tuple[type[Any], ...]:
+    """Get the base classes of a class or typeddict.
+
+    Args:
+        tp: The type or class to get the bases.
+
+    Returns:
+        The base classes.
+    """
+    if is_typeddict(tp):
+        return tp.__orig_bases__  # type: ignore
+    try:
+        return tp.__bases__
+    except AttributeError:
+        return ()
+
+
+def mro(tp: type[Any]) -> tuple[type[Any], ...]:
+    """Calculate the Method Resolution Order of bases using the C3 algorithm.
+
+    See https://www.python.org/download/releases/2.3/mro/
+    """
+    # try to use the existing mro, for performance mainly
+    # but also because it helps verify the implementation below
+    if not is_typeddict(tp):
+        try:
+            return tp.__mro__
+        except AttributeError:
+            # GenericAlias and some other cases
+            pass
+
+    bases = get_bases(tp)
+    return (tp,) + mro_for_bases(bases)
+
+
+def mro_for_bases(bases: tuple[type[Any], ...]) -> tuple[type[Any], ...]:
+    def merge_seqs(seqs: list[deque[type[Any]]]) -> Iterable[type[Any]]:
+        while True:
+            non_empty = [seq for seq in seqs if seq]
+            if not non_empty:
+                # Nothing left to process, we're done.
+                return
+            candidate: type[Any] | None = None
+            for seq in non_empty:  # Find merge candidates among seq heads.
+                candidate = seq[0]
+                not_head = [s for s in non_empty if candidate in islice(s, 1, None)]
+                if not_head:
+                    # Reject the candidate.
+                    candidate = None
+                else:
+                    break
+            if not candidate:
+                raise TypeError('Inconsistent hierarchy, no C3 MRO is possible')
+            yield candidate
+            for seq in non_empty:
+                # Remove candidate.
+                if seq[0] == candidate:
+                    seq.popleft()
+
+    seqs = [deque(mro(base)) for base in bases] + [deque(bases)]
+    return tuple(merge_seqs(seqs))
+
+
+_sentinel = object()
+
+
+def get_attribute_from_bases(tp: type[Any] | tuple[type[Any], ...], name: str) -> Any:
+    """Get the attribute from the next class in the MRO that has it,
+    aiming to simulate calling the method on the actual class.
+
+    The reason for iterating over the mro instead of just getting
+    the attribute (which would do that for us) is to support TypedDict,
+    which lacks a real __mro__, but can have a virtual one constructed
+    from its bases (as done here).
+
+    Args:
+        tp: The type or class to search for the attribute. If a tuple, this is treated as a set of base classes.
+        name: The name of the attribute to retrieve.
+
+    Returns:
+        Any: The attribute value, if found.
+
+    Raises:
+        AttributeError: If the attribute is not found in any class in the MRO.
+    """
+    if isinstance(tp, tuple):
+        for base in mro_for_bases(tp):
+            attribute = base.__dict__.get(name, _sentinel)
+            if attribute is not _sentinel:
+                attribute_get = getattr(attribute, '__get__', None)
+                if attribute_get is not None:
+                    return attribute_get(None, tp)
+                return attribute
+        raise AttributeError(f'{name} not found in {tp}')
+    else:
+        try:
+            return getattr(tp, name)
+        except AttributeError:
+            return get_attribute_from_bases(mro(tp), name)
+
+
+def get_attribute_from_base_dicts(tp: type[Any], name: str) -> Any:
+    """Get an attribute out of the `__dict__` following the MRO.
+    This prevents the call to `__get__` on the descriptor, and allows
+    us to get the original function for classmethod properties.
+
+    Args:
+        tp: The type or class to search for the attribute.
+        name: The name of the attribute to retrieve.
+
+    Returns:
+        Any: The attribute value, if found.
+
+    Raises:
+        KeyError: If the attribute is not found in any class's `__dict__` in the MRO.
+    """
+    for base in reversed(mro(tp)):
+        if name in base.__dict__:
+            return base.__dict__[name]
+    return tp.__dict__[name]  # raise the error
+
+
+@dataclass(**slots_true)
+class DecoratorInfos:
+    """Mapping of name in the class namespace to decorator info.
+
+    note that the name in the class namespace is the function or attribute name
+    not the field name!
+    """
+
+    validators: dict[str, Decorator[ValidatorDecoratorInfo]] = field(default_factory=dict)
+    field_validators: dict[str, Decorator[FieldValidatorDecoratorInfo]] = field(default_factory=dict)
+    root_validators: dict[str, Decorator[RootValidatorDecoratorInfo]] = field(default_factory=dict)
+    field_serializers: dict[str, Decorator[FieldSerializerDecoratorInfo]] = field(default_factory=dict)
+    model_serializers: dict[str, Decorator[ModelSerializerDecoratorInfo]] = field(default_factory=dict)
+    model_validators: dict[str, Decorator[ModelValidatorDecoratorInfo]] = field(default_factory=dict)
+    computed_fields: dict[str, Decorator[ComputedFieldInfo]] = field(default_factory=dict)
+
+    @staticmethod
+    def build(model_dc: type[Any]) -> DecoratorInfos:  # noqa: C901 (ignore complexity)
+        """We want to collect all DecFunc instances that exist as
+        attributes in the namespace of the class (a BaseModel or dataclass)
+        that called us
+        But we want to collect these in the order of the bases
+        So instead of getting them all from the leaf class (the class that called us),
+        we traverse the bases from root (the oldest ancestor class) to leaf
+        and collect all of the instances as we go, taking care to replace
+        any duplicate ones with the last one we see to mimic how function overriding
+        works with inheritance.
+        If we do replace any functions we put the replacement into the position
+        the replaced function was in; that is, we maintain the order.
+        """
+        # reminder: dicts are ordered and replacement does not alter the order
+        res = DecoratorInfos()
+        for base in reversed(mro(model_dc)[1:]):
+            existing: DecoratorInfos | None = base.__dict__.get('__pydantic_decorators__')
+            if existing is None:
+                existing = DecoratorInfos.build(base)
+            res.validators.update({k: v.bind_to_cls(model_dc) for k, v in existing.validators.items()})
+            res.field_validators.update({k: v.bind_to_cls(model_dc) for k, v in existing.field_validators.items()})
+            res.root_validators.update({k: v.bind_to_cls(model_dc) for k, v in existing.root_validators.items()})
+            res.field_serializers.update({k: v.bind_to_cls(model_dc) for k, v in existing.field_serializers.items()})
+            res.model_serializers.update({k: v.bind_to_cls(model_dc) for k, v in existing.model_serializers.items()})
+            res.model_validators.update({k: v.bind_to_cls(model_dc) for k, v in existing.model_validators.items()})
+            res.computed_fields.update({k: v.bind_to_cls(model_dc) for k, v in existing.computed_fields.items()})
+
+        to_replace: list[tuple[str, Any]] = []
+
+        for var_name, var_value in vars(model_dc).items():
+            if isinstance(var_value, PydanticDescriptorProxy):
+                info = var_value.decorator_info
+                if isinstance(info, ValidatorDecoratorInfo):
+                    res.validators[var_name] = Decorator.build(
+                        model_dc, cls_var_name=var_name, shim=var_value.shim, info=info
+                    )
+                elif isinstance(info, FieldValidatorDecoratorInfo):
+                    res.field_validators[var_name] = Decorator.build(
+                        model_dc, cls_var_name=var_name, shim=var_value.shim, info=info
+                    )
+                elif isinstance(info, RootValidatorDecoratorInfo):
+                    res.root_validators[var_name] = Decorator.build(
+                        model_dc, cls_var_name=var_name, shim=var_value.shim, info=info
+                    )
+                elif isinstance(info, FieldSerializerDecoratorInfo):
+                    # check whether a serializer function is already registered for fields
+                    for field_serializer_decorator in res.field_serializers.values():
+                        # check that each field has at most one serializer function.
+                        # serializer functions for the same field in subclasses are allowed,
+                        # and are treated as overrides
+                        if field_serializer_decorator.cls_var_name == var_name:
+                            continue
+                        for f in info.fields:
+                            if f in field_serializer_decorator.info.fields:
+                                raise PydanticUserError(
+                                    'Multiple field serializer functions were defined '
+                                    f'for field {f!r}, this is not allowed.',
+                                    code='multiple-field-serializers',
+                                )
+                    res.field_serializers[var_name] = Decorator.build(
+                        model_dc, cls_var_name=var_name, shim=var_value.shim, info=info
+                    )
+                elif isinstance(info, ModelValidatorDecoratorInfo):
+                    res.model_validators[var_name] = Decorator.build(
+                        model_dc, cls_var_name=var_name, shim=var_value.shim, info=info
+                    )
+                elif isinstance(info, ModelSerializerDecoratorInfo):
+                    res.model_serializers[var_name] = Decorator.build(
+                        model_dc, cls_var_name=var_name, shim=var_value.shim, info=info
+                    )
+                else:
+                    from ..fields import ComputedFieldInfo
+
+                    isinstance(var_value, ComputedFieldInfo)
+                    res.computed_fields[var_name] = Decorator.build(
+                        model_dc, cls_var_name=var_name, shim=None, info=info
+                    )
+                to_replace.append((var_name, var_value.wrapped))
+        if to_replace:
+            # If we can save `__pydantic_decorators__` on the class we'll be able to check for it above
+            # so then we don't need to re-process the type, which means we can discard our descriptor wrappers
+            # and replace them with the thing they are wrapping (see the other setattr call below)
+            # which allows validator class methods to also function as regular class methods
+            setattr(model_dc, '__pydantic_decorators__', res)
+            for name, value in to_replace:
+                setattr(model_dc, name, value)
+        return res
+
+
+def inspect_validator(validator: Callable[..., Any], mode: FieldValidatorModes) -> bool:
+    """Look at a field or model validator function and determine whether it takes an info argument.
+
+    An error is raised if the function has an invalid signature.
+
+    Args:
+        validator: The validator function to inspect.
+        mode: The proposed validator mode.
+
+    Returns:
+        Whether the validator takes an info argument.
+    """
+    try:
+        sig = signature(validator)
+    except ValueError:
+        # builtins and some C extensions don't have signatures
+        # assume that they don't take an info argument and only take a single argument
+        # e.g. `str.strip` or `datetime.datetime`
+        return False
+    n_positional = count_positional_params(sig)
+    if mode == 'wrap':
+        if n_positional == 3:
+            return True
+        elif n_positional == 2:
+            return False
+    else:
+        assert mode in {'before', 'after', 'plain'}, f"invalid mode: {mode!r}, expected 'before', 'after' or 'plain"
+        if n_positional == 2:
+            return True
+        elif n_positional == 1:
+            return False
+
+    raise PydanticUserError(
+        f'Unrecognized field_validator function signature for {validator} with `mode={mode}`:{sig}',
+        code='validator-signature',
+    )
+
+
+def inspect_field_serializer(
+    serializer: Callable[..., Any], mode: Literal['plain', 'wrap'], computed_field: bool = False
+) -> tuple[bool, bool]:
+    """Look at a field serializer function and determine if it is a field serializer,
+    and whether it takes an info argument.
+
+    An error is raised if the function has an invalid signature.
+
+    Args:
+        serializer: The serializer function to inspect.
+        mode: The serializer mode, either 'plain' or 'wrap'.
+        computed_field: When serializer is applied on computed_field. It doesn't require
+            info signature.
+
+    Returns:
+        Tuple of (is_field_serializer, info_arg).
+    """
+    sig = signature(serializer)
+
+    first = next(iter(sig.parameters.values()), None)
+    is_field_serializer = first is not None and first.name == 'self'
+
+    n_positional = count_positional_params(sig)
+    if is_field_serializer:
+        # -1 to correct for self parameter
+        info_arg = _serializer_info_arg(mode, n_positional - 1)
+    else:
+        info_arg = _serializer_info_arg(mode, n_positional)
+
+    if info_arg is None:
+        raise PydanticUserError(
+            f'Unrecognized field_serializer function signature for {serializer} with `mode={mode}`:{sig}',
+            code='field-serializer-signature',
+        )
+    if info_arg and computed_field:
+        raise PydanticUserError(
+            'field_serializer on computed_field does not use info signature', code='field-serializer-signature'
+        )
+
+    else:
+        return is_field_serializer, info_arg
+
+
+def inspect_annotated_serializer(serializer: Callable[..., Any], mode: Literal['plain', 'wrap']) -> bool:
+    """Look at a serializer function used via `Annotated` and determine whether it takes an info argument.
+
+    An error is raised if the function has an invalid signature.
+
+    Args:
+        serializer: The serializer function to check.
+        mode: The serializer mode, either 'plain' or 'wrap'.
+
+    Returns:
+        info_arg
+    """
+    sig = signature(serializer)
+    info_arg = _serializer_info_arg(mode, count_positional_params(sig))
+    if info_arg is None:
+        raise PydanticUserError(
+            f'Unrecognized field_serializer function signature for {serializer} with `mode={mode}`:{sig}',
+            code='field-serializer-signature',
+        )
+    else:
+        return info_arg
+
+
+def inspect_model_serializer(serializer: Callable[..., Any], mode: Literal['plain', 'wrap']) -> bool:
+    """Look at a model serializer function and determine whether it takes an info argument.
+
+    An error is raised if the function has an invalid signature.
+
+    Args:
+        serializer: The serializer function to check.
+        mode: The serializer mode, either 'plain' or 'wrap'.
+
+    Returns:
+        `info_arg` - whether the function expects an info argument.
+    """
+    if isinstance(serializer, (staticmethod, classmethod)) or not is_instance_method_from_sig(serializer):
+        raise PydanticUserError(
+            '`@model_serializer` must be applied to instance methods', code='model-serializer-instance-method'
+        )
+
+    sig = signature(serializer)
+    info_arg = _serializer_info_arg(mode, count_positional_params(sig))
+    if info_arg is None:
+        raise PydanticUserError(
+            f'Unrecognized model_serializer function signature for {serializer} with `mode={mode}`:{sig}',
+            code='model-serializer-signature',
+        )
+    else:
+        return info_arg
+
+
+def _serializer_info_arg(mode: Literal['plain', 'wrap'], n_positional: int) -> bool | None:
+    if mode == 'plain':
+        if n_positional == 1:
+            # (__input_value: Any) -> Any
+            return False
+        elif n_positional == 2:
+            # (__model: Any, __input_value: Any) -> Any
+            return True
+    else:
+        assert mode == 'wrap', f"invalid mode: {mode!r}, expected 'plain' or 'wrap'"
+        if n_positional == 2:
+            # (__input_value: Any, __serializer: SerializerFunctionWrapHandler) -> Any
+            return False
+        elif n_positional == 3:
+            # (__input_value: Any, __serializer: SerializerFunctionWrapHandler, __info: SerializationInfo) -> Any
+            return True
+
+    return None
+
+
+AnyDecoratorCallable: TypeAlias = (
+    'Union[classmethod[Any, Any, Any], staticmethod[Any, Any], partialmethod[Any], Callable[..., Any]]'
+)
+
+
+def is_instance_method_from_sig(function: AnyDecoratorCallable) -> bool:
+    """Whether the function is an instance method.
+
+    It will consider a function as instance method if the first parameter of
+    function is `self`.
+
+    Args:
+        function: The function to check.
+
+    Returns:
+        `True` if the function is an instance method, `False` otherwise.
+    """
+    sig = signature(unwrap_wrapped_function(function))
+    first = next(iter(sig.parameters.values()), None)
+    if first and first.name == 'self':
+        return True
+    return False
+
+
+def ensure_classmethod_based_on_signature(function: AnyDecoratorCallable) -> Any:
+    """Apply the `@classmethod` decorator on the function.
+
+    Args:
+        function: The function to apply the decorator on.
+
+    Return:
+        The `@classmethod` decorator applied function.
+    """
+    if not isinstance(
+        unwrap_wrapped_function(function, unwrap_class_static_method=False), classmethod
+    ) and _is_classmethod_from_sig(function):
+        return classmethod(function)  # type: ignore[arg-type]
+    return function
+
+
+def _is_classmethod_from_sig(function: AnyDecoratorCallable) -> bool:
+    sig = signature(unwrap_wrapped_function(function))
+    first = next(iter(sig.parameters.values()), None)
+    if first and first.name == 'cls':
+        return True
+    return False
+
+
+def unwrap_wrapped_function(
+    func: Any,
+    *,
+    unwrap_partial: bool = True,
+    unwrap_class_static_method: bool = True,
+) -> Any:
+    """Recursively unwraps a wrapped function until the underlying function is reached.
+    This handles property, functools.partial, functools.partialmethod, staticmethod and classmethod.
+
+    Args:
+        func: The function to unwrap.
+        unwrap_partial: If True (default), unwrap partial and partialmethod decorators, otherwise don't.
+            decorators.
+        unwrap_class_static_method: If True (default), also unwrap classmethod and staticmethod
+            decorators. If False, only unwrap partial and partialmethod decorators.
+
+    Returns:
+        The underlying function of the wrapped function.
+    """
+    all: set[Any] = {property, cached_property}
+
+    if unwrap_partial:
+        all.update({partial, partialmethod})
+
+    if unwrap_class_static_method:
+        all.update({staticmethod, classmethod})
+
+    while isinstance(func, tuple(all)):
+        if unwrap_class_static_method and isinstance(func, (classmethod, staticmethod)):
+            func = func.__func__
+        elif isinstance(func, (partial, partialmethod)):
+            func = func.func
+        elif isinstance(func, property):
+            func = func.fget  # arbitrary choice, convenient for computed fields
+        else:
+            # Make coverage happy as it can only get here in the last possible case
+            assert isinstance(func, cached_property)
+            func = func.func  # type: ignore
+
+    return func
+
+
+def get_function_return_type(
+    func: Any, explicit_return_type: Any, types_namespace: dict[str, Any] | None = None
+) -> Any:
+    """Get the function return type.
+
+    It gets the return type from the type annotation if `explicit_return_type` is `None`.
+    Otherwise, it returns `explicit_return_type`.
+
+    Args:
+        func: The function to get its return type.
+        explicit_return_type: The explicit return type.
+        types_namespace: The types namespace, defaults to `None`.
+
+    Returns:
+        The function return type.
+    """
+    if explicit_return_type is PydanticUndefined:
+        # try to get it from the type annotation
+        hints = get_function_type_hints(
+            unwrap_wrapped_function(func), include_keys={'return'}, types_namespace=types_namespace
+        )
+        return hints.get('return', PydanticUndefined)
+    else:
+        return explicit_return_type
+
+
+def count_positional_params(sig: Signature) -> int:
+    return sum(1 for param in sig.parameters.values() if can_be_positional(param))
+
+
+def can_be_positional(param: Parameter) -> bool:
+    return param.kind in (Parameter.POSITIONAL_ONLY, Parameter.POSITIONAL_OR_KEYWORD)
+
+
+def ensure_property(f: Any) -> Any:
+    """Ensure that a function is a `property` or `cached_property`, or is a valid descriptor.
+
+    Args:
+        f: The function to check.
+
+    Returns:
+        The function, or a `property` or `cached_property` instance wrapping the function.
+    """
+    if ismethoddescriptor(f) or isdatadescriptor(f):
+        return f
+    else:
+        return property(f)
diff --git a/lib/pydantic/_internal/_decorators_v1.py b/lib/pydantic/_internal/_decorators_v1.py
new file mode 100644
index 00000000..4f81e6d4
--- /dev/null
+++ b/lib/pydantic/_internal/_decorators_v1.py
@@ -0,0 +1,181 @@
+"""Logic for V1 validators, e.g. `@validator` and `@root_validator`."""
+from __future__ import annotations as _annotations
+
+from inspect import Parameter, signature
+from typing import Any, Dict, Tuple, Union, cast
+
+from pydantic_core import core_schema
+from typing_extensions import Protocol
+
+from ..errors import PydanticUserError
+from ._decorators import can_be_positional
+
+
+class V1OnlyValueValidator(Protocol):
+    """A simple validator, supported for V1 validators and V2 validators."""
+
+    def __call__(self, __value: Any) -> Any:
+        ...
+
+
+class V1ValidatorWithValues(Protocol):
+    """A validator with `values` argument, supported for V1 validators and V2 validators."""
+
+    def __call__(self, __value: Any, values: dict[str, Any]) -> Any:
+        ...
+
+
+class V1ValidatorWithValuesKwOnly(Protocol):
+    """A validator with keyword only `values` argument, supported for V1 validators and V2 validators."""
+
+    def __call__(self, __value: Any, *, values: dict[str, Any]) -> Any:
+        ...
+
+
+class V1ValidatorWithKwargs(Protocol):
+    """A validator with `kwargs` argument, supported for V1 validators and V2 validators."""
+
+    def __call__(self, __value: Any, **kwargs: Any) -> Any:
+        ...
+
+
+class V1ValidatorWithValuesAndKwargs(Protocol):
+    """A validator with `values` and `kwargs` arguments, supported for V1 validators and V2 validators."""
+
+    def __call__(self, __value: Any, values: dict[str, Any], **kwargs: Any) -> Any:
+        ...
+
+
+V1Validator = Union[
+    V1ValidatorWithValues, V1ValidatorWithValuesKwOnly, V1ValidatorWithKwargs, V1ValidatorWithValuesAndKwargs
+]
+
+
+def can_be_keyword(param: Parameter) -> bool:
+    return param.kind in (Parameter.POSITIONAL_OR_KEYWORD, Parameter.KEYWORD_ONLY)
+
+
+def make_generic_v1_field_validator(validator: V1Validator) -> core_schema.WithInfoValidatorFunction:
+    """Wrap a V1 style field validator for V2 compatibility.
+
+    Args:
+        validator: The V1 style field validator.
+
+    Returns:
+        A wrapped V2 style field validator.
+
+    Raises:
+        PydanticUserError: If the signature is not supported or the parameters are
+            not available in Pydantic V2.
+    """
+    sig = signature(validator)
+
+    needs_values_kw = False
+
+    for param_num, (param_name, parameter) in enumerate(sig.parameters.items()):
+        if can_be_keyword(parameter) and param_name in ('field', 'config'):
+            raise PydanticUserError(
+                'The `field` and `config` parameters are not available in Pydantic V2, '
+                'please use the `info` parameter instead.',
+                code='validator-field-config-info',
+            )
+        if parameter.kind is Parameter.VAR_KEYWORD:
+            needs_values_kw = True
+        elif can_be_keyword(parameter) and param_name == 'values':
+            needs_values_kw = True
+        elif can_be_positional(parameter) and param_num == 0:
+            # value
+            continue
+        elif parameter.default is Parameter.empty:  # ignore params with defaults e.g. bound by functools.partial
+            raise PydanticUserError(
+                f'Unsupported signature for V1 style validator {validator}: {sig} is not supported.',
+                code='validator-v1-signature',
+            )
+
+    if needs_values_kw:
+        # (v, **kwargs), (v, values, **kwargs), (v, *, values, **kwargs) or (v, *, values)
+        val1 = cast(V1ValidatorWithValues, validator)
+
+        def wrapper1(value: Any, info: core_schema.ValidationInfo) -> Any:
+            return val1(value, values=info.data)
+
+        return wrapper1
+    else:
+        val2 = cast(V1OnlyValueValidator, validator)
+
+        def wrapper2(value: Any, _: core_schema.ValidationInfo) -> Any:
+            return val2(value)
+
+        return wrapper2
+
+
+RootValidatorValues = Dict[str, Any]
+# technically tuple[model_dict, model_extra, fields_set] | tuple[dataclass_dict, init_vars]
+RootValidatorFieldsTuple = Tuple[Any, ...]
+
+
+class V1RootValidatorFunction(Protocol):
+    """A simple root validator, supported for V1 validators and V2 validators."""
+
+    def __call__(self, __values: RootValidatorValues) -> RootValidatorValues:
+        ...
+
+
+class V2CoreBeforeRootValidator(Protocol):
+    """V2 validator with mode='before'."""
+
+    def __call__(self, __values: RootValidatorValues, __info: core_schema.ValidationInfo) -> RootValidatorValues:
+        ...
+
+
+class V2CoreAfterRootValidator(Protocol):
+    """V2 validator with mode='after'."""
+
+    def __call__(
+        self, __fields_tuple: RootValidatorFieldsTuple, __info: core_schema.ValidationInfo
+    ) -> RootValidatorFieldsTuple:
+        ...
+
+
+def make_v1_generic_root_validator(
+    validator: V1RootValidatorFunction, pre: bool
+) -> V2CoreBeforeRootValidator | V2CoreAfterRootValidator:
+    """Wrap a V1 style root validator for V2 compatibility.
+
+    Args:
+        validator: The V1 style field validator.
+        pre: Whether the validator is a pre validator.
+
+    Returns:
+        A wrapped V2 style validator.
+    """
+    if pre is True:
+        # mode='before' for pydantic-core
+        def _wrapper1(values: RootValidatorValues, _: core_schema.ValidationInfo) -> RootValidatorValues:
+            return validator(values)
+
+        return _wrapper1
+
+    # mode='after' for pydantic-core
+    def _wrapper2(fields_tuple: RootValidatorFieldsTuple, _: core_schema.ValidationInfo) -> RootValidatorFieldsTuple:
+        if len(fields_tuple) == 2:
+            # dataclass, this is easy
+            values, init_vars = fields_tuple
+            values = validator(values)
+            return values, init_vars
+        else:
+            # ugly hack: to match v1 behaviour, we merge values and model_extra, then split them up based on fields
+            # afterwards
+            model_dict, model_extra, fields_set = fields_tuple
+            if model_extra:
+                fields = set(model_dict.keys())
+                model_dict.update(model_extra)
+                model_dict_new = validator(model_dict)
+                for k in list(model_dict_new.keys()):
+                    if k not in fields:
+                        model_extra[k] = model_dict_new.pop(k)
+            else:
+                model_dict_new = validator(model_dict)
+            return model_dict_new, model_extra, fields_set
+
+    return _wrapper2
diff --git a/lib/pydantic/_internal/_discriminated_union.py b/lib/pydantic/_internal/_discriminated_union.py
new file mode 100644
index 00000000..c40117d3
--- /dev/null
+++ b/lib/pydantic/_internal/_discriminated_union.py
@@ -0,0 +1,506 @@
+from __future__ import annotations as _annotations
+
+from typing import TYPE_CHECKING, Any, Hashable, Sequence
+
+from pydantic_core import CoreSchema, core_schema
+
+from ..errors import PydanticUserError
+from . import _core_utils
+from ._core_utils import (
+    CoreSchemaField,
+    collect_definitions,
+    simplify_schema_references,
+)
+
+if TYPE_CHECKING:
+    from ..types import Discriminator
+
+CORE_SCHEMA_METADATA_DISCRIMINATOR_PLACEHOLDER_KEY = 'pydantic.internal.union_discriminator'
+
+
+class MissingDefinitionForUnionRef(Exception):
+    """Raised when applying a discriminated union discriminator to a schema
+    requires a definition that is not yet defined
+    """
+
+    def __init__(self, ref: str) -> None:
+        self.ref = ref
+        super().__init__(f'Missing definition for ref {self.ref!r}')
+
+
+def set_discriminator_in_metadata(schema: CoreSchema, discriminator: Any) -> None:
+    schema.setdefault('metadata', {})
+    metadata = schema.get('metadata')
+    assert metadata is not None
+    metadata[CORE_SCHEMA_METADATA_DISCRIMINATOR_PLACEHOLDER_KEY] = discriminator
+
+
+def apply_discriminators(schema: core_schema.CoreSchema) -> core_schema.CoreSchema:
+    definitions: dict[str, CoreSchema] | None = None
+
+    def inner(s: core_schema.CoreSchema, recurse: _core_utils.Recurse) -> core_schema.CoreSchema:
+        nonlocal definitions
+
+        s = recurse(s, inner)
+        if s['type'] == 'tagged-union':
+            return s
+
+        metadata = s.get('metadata', {})
+        discriminator = metadata.pop(CORE_SCHEMA_METADATA_DISCRIMINATOR_PLACEHOLDER_KEY, None)
+        if discriminator is not None:
+            if definitions is None:
+                definitions = collect_definitions(schema)
+            s = apply_discriminator(s, discriminator, definitions)
+        return s
+
+    return simplify_schema_references(_core_utils.walk_core_schema(schema, inner))
+
+
+def apply_discriminator(
+    schema: core_schema.CoreSchema,
+    discriminator: str | Discriminator,
+    definitions: dict[str, core_schema.CoreSchema] | None = None,
+) -> core_schema.CoreSchema:
+    """Applies the discriminator and returns a new core schema.
+
+    Args:
+        schema: The input schema.
+        discriminator: The name of the field which will serve as the discriminator.
+        definitions: A mapping of schema ref to schema.
+
+    Returns:
+        The new core schema.
+
+    Raises:
+        TypeError:
+            - If `discriminator` is used with invalid union variant.
+            - If `discriminator` is used with `Union` type with one variant.
+            - If `discriminator` value mapped to multiple choices.
+        MissingDefinitionForUnionRef:
+            If the definition for ref is missing.
+        PydanticUserError:
+            - If a model in union doesn't have a discriminator field.
+            - If discriminator field has a non-string alias.
+            - If discriminator fields have different aliases.
+            - If discriminator field not of type `Literal`.
+    """
+    from ..types import Discriminator
+
+    if isinstance(discriminator, Discriminator):
+        if isinstance(discriminator.discriminator, str):
+            discriminator = discriminator.discriminator
+        else:
+            return discriminator._convert_schema(schema)
+
+    return _ApplyInferredDiscriminator(discriminator, definitions or {}).apply(schema)
+
+
+class _ApplyInferredDiscriminator:
+    """This class is used to convert an input schema containing a union schema into one where that union is
+    replaced with a tagged-union, with all the associated debugging and performance benefits.
+
+    This is done by:
+    * Validating that the input schema is compatible with the provided discriminator
+    * Introspecting the schema to determine which discriminator values should map to which union choices
+    * Handling various edge cases such as 'definitions', 'default', 'nullable' schemas, and more
+
+    I have chosen to implement the conversion algorithm in this class, rather than a function,
+    to make it easier to maintain state while recursively walking the provided CoreSchema.
+    """
+
+    def __init__(self, discriminator: str, definitions: dict[str, core_schema.CoreSchema]):
+        # `discriminator` should be the name of the field which will serve as the discriminator.
+        # It must be the python name of the field, and *not* the field's alias. Note that as of now,
+        # all members of a discriminated union _must_ use a field with the same name as the discriminator.
+        # This may change if/when we expose a way to manually specify the TaggedUnionSchema's choices.
+        self.discriminator = discriminator
+
+        # `definitions` should contain a mapping of schema ref to schema for all schemas which might
+        # be referenced by some choice
+        self.definitions = definitions
+
+        # `_discriminator_alias` will hold the value, if present, of the alias for the discriminator
+        #
+        # Note: following the v1 implementation, we currently disallow the use of different aliases
+        # for different choices. This is not a limitation of pydantic_core, but if we try to handle
+        # this, the inference logic gets complicated very quickly, and could result in confusing
+        # debugging challenges for users making subtle mistakes.
+        #
+        # Rather than trying to do the most powerful inference possible, I think we should eventually
+        # expose a way to more-manually control the way the TaggedUnionSchema is constructed through
+        # the use of a new type which would be placed as an Annotation on the Union type. This would
+        # provide the full flexibility/power of pydantic_core's TaggedUnionSchema where necessary for
+        # more complex cases, without over-complicating the inference logic for the common cases.
+        self._discriminator_alias: str | None = None
+
+        # `_should_be_nullable` indicates whether the converted union has `None` as an allowed value.
+        # If `None` is an acceptable value of the (possibly-wrapped) union, we ignore it while
+        # constructing the TaggedUnionSchema, but set the `_should_be_nullable` attribute to True.
+        # Once we have constructed the TaggedUnionSchema, if `_should_be_nullable` is True, we ensure
+        # that the final schema gets wrapped as a NullableSchema. This has the same semantics on the
+        # python side, but resolves the issue that `None` cannot correspond to any discriminator values.
+        self._should_be_nullable = False
+
+        # `_is_nullable` is used to track if the final produced schema will definitely be nullable;
+        # we set it to True if the input schema is wrapped in a nullable schema that we know will be preserved
+        # as an indication that, even if None is discovered as one of the union choices, we will not need to wrap
+        # the final value in another nullable schema.
+        #
+        # This is more complicated than just checking for the final outermost schema having type 'nullable' thanks
+        # to the possible presence of other wrapper schemas such as DefinitionsSchema, WithDefaultSchema, etc.
+        self._is_nullable = False
+
+        # `_choices_to_handle` serves as a stack of choices to add to the tagged union. Initially, choices
+        # from the union in the wrapped schema will be appended to this list, and the recursive choice-handling
+        # algorithm may add more choices to this stack as (nested) unions are encountered.
+        self._choices_to_handle: list[core_schema.CoreSchema] = []
+
+        # `_tagged_union_choices` is built during the call to `apply`, and will hold the choices to be included
+        # in the output TaggedUnionSchema that will replace the union from the input schema
+        self._tagged_union_choices: dict[Hashable, core_schema.CoreSchema] = {}
+
+        # `_used` is changed to True after applying the discriminator to prevent accidental re-use
+        self._used = False
+
+    def apply(self, schema: core_schema.CoreSchema) -> core_schema.CoreSchema:
+        """Return a new CoreSchema based on `schema` that uses a tagged-union with the discriminator provided
+        to this class.
+
+        Args:
+            schema: The input schema.
+
+        Returns:
+            The new core schema.
+
+        Raises:
+            TypeError:
+                - If `discriminator` is used with invalid union variant.
+                - If `discriminator` is used with `Union` type with one variant.
+                - If `discriminator` value mapped to multiple choices.
+            ValueError:
+                If the definition for ref is missing.
+            PydanticUserError:
+                - If a model in union doesn't have a discriminator field.
+                - If discriminator field has a non-string alias.
+                - If discriminator fields have different aliases.
+                - If discriminator field not of type `Literal`.
+        """
+        self.definitions.update(collect_definitions(schema))
+        assert not self._used
+        schema = self._apply_to_root(schema)
+        if self._should_be_nullable and not self._is_nullable:
+            schema = core_schema.nullable_schema(schema)
+        self._used = True
+        new_defs = collect_definitions(schema)
+        missing_defs = self.definitions.keys() - new_defs.keys()
+        if missing_defs:
+            schema = core_schema.definitions_schema(schema, [self.definitions[ref] for ref in missing_defs])
+        return schema
+
+    def _apply_to_root(self, schema: core_schema.CoreSchema) -> core_schema.CoreSchema:
+        """This method handles the outer-most stage of recursion over the input schema:
+        unwrapping nullable or definitions schemas, and calling the `_handle_choice`
+        method iteratively on the choices extracted (recursively) from the possibly-wrapped union.
+        """
+        if schema['type'] == 'nullable':
+            self._is_nullable = True
+            wrapped = self._apply_to_root(schema['schema'])
+            nullable_wrapper = schema.copy()
+            nullable_wrapper['schema'] = wrapped
+            return nullable_wrapper
+
+        if schema['type'] == 'definitions':
+            wrapped = self._apply_to_root(schema['schema'])
+            definitions_wrapper = schema.copy()
+            definitions_wrapper['schema'] = wrapped
+            return definitions_wrapper
+
+        if schema['type'] != 'union':
+            # If the schema is not a union, it probably means it just had a single member and
+            # was flattened by pydantic_core.
+            # However, it still may make sense to apply the discriminator to this schema,
+            # as a way to get discriminated-union-style error messages, so we allow this here.
+            schema = core_schema.union_schema([schema])
+
+        # Reverse the choices list before extending the stack so that they get handled in the order they occur
+        choices_schemas = [v[0] if isinstance(v, tuple) else v for v in schema['choices'][::-1]]
+        self._choices_to_handle.extend(choices_schemas)
+        while self._choices_to_handle:
+            choice = self._choices_to_handle.pop()
+            self._handle_choice(choice)
+
+        if self._discriminator_alias is not None and self._discriminator_alias != self.discriminator:
+            # * We need to annotate `discriminator` as a union here to handle both branches of this conditional
+            # * We need to annotate `discriminator` as list[list[str | int]] and not list[list[str]] due to the
+            #   invariance of list, and because list[list[str | int]] is the type of the discriminator argument
+            #   to tagged_union_schema below
+            # * See the docstring of pydantic_core.core_schema.tagged_union_schema for more details about how to
+            #   interpret the value of the discriminator argument to tagged_union_schema. (The list[list[str]] here
+            #   is the appropriate way to provide a list of fallback attributes to check for a discriminator value.)
+            discriminator: str | list[list[str | int]] = [[self.discriminator], [self._discriminator_alias]]
+        else:
+            discriminator = self.discriminator
+        return core_schema.tagged_union_schema(
+            choices=self._tagged_union_choices,
+            discriminator=discriminator,
+            custom_error_type=schema.get('custom_error_type'),
+            custom_error_message=schema.get('custom_error_message'),
+            custom_error_context=schema.get('custom_error_context'),
+            strict=False,
+            from_attributes=True,
+            ref=schema.get('ref'),
+            metadata=schema.get('metadata'),
+            serialization=schema.get('serialization'),
+        )
+
+    def _handle_choice(self, choice: core_schema.CoreSchema) -> None:
+        """This method handles the "middle" stage of recursion over the input schema.
+        Specifically, it is responsible for handling each choice of the outermost union
+        (and any "coalesced" choices obtained from inner unions).
+
+        Here, "handling" entails:
+        * Coalescing nested unions and compatible tagged-unions
+        * Tracking the presence of 'none' and 'nullable' schemas occurring as choices
+        * Validating that each allowed discriminator value maps to a unique choice
+        * Updating the _tagged_union_choices mapping that will ultimately be used to build the TaggedUnionSchema.
+        """
+        if choice['type'] == 'definition-ref':
+            if choice['schema_ref'] not in self.definitions:
+                raise MissingDefinitionForUnionRef(choice['schema_ref'])
+
+        if choice['type'] == 'none':
+            self._should_be_nullable = True
+        elif choice['type'] == 'definitions':
+            self._handle_choice(choice['schema'])
+        elif choice['type'] == 'nullable':
+            self._should_be_nullable = True
+            self._handle_choice(choice['schema'])  # unwrap the nullable schema
+        elif choice['type'] == 'union':
+            # Reverse the choices list before extending the stack so that they get handled in the order they occur
+            choices_schemas = [v[0] if isinstance(v, tuple) else v for v in choice['choices'][::-1]]
+            self._choices_to_handle.extend(choices_schemas)
+        elif choice['type'] not in {
+            'model',
+            'typed-dict',
+            'tagged-union',
+            'lax-or-strict',
+            'dataclass',
+            'dataclass-args',
+            'definition-ref',
+        } and not _core_utils.is_function_with_inner_schema(choice):
+            # We should eventually handle 'definition-ref' as well
+            raise TypeError(
+                f'{choice["type"]!r} is not a valid discriminated union variant;'
+                ' should be a `BaseModel` or `dataclass`'
+            )
+        else:
+            if choice['type'] == 'tagged-union' and self._is_discriminator_shared(choice):
+                # In this case, this inner tagged-union is compatible with the outer tagged-union,
+                # and its choices can be coalesced into the outer TaggedUnionSchema.
+                subchoices = [x for x in choice['choices'].values() if not isinstance(x, (str, int))]
+                # Reverse the choices list before extending the stack so that they get handled in the order they occur
+                self._choices_to_handle.extend(subchoices[::-1])
+                return
+
+            inferred_discriminator_values = self._infer_discriminator_values_for_choice(choice, source_name=None)
+            self._set_unique_choice_for_values(choice, inferred_discriminator_values)
+
+    def _is_discriminator_shared(self, choice: core_schema.TaggedUnionSchema) -> bool:
+        """This method returns a boolean indicating whether the discriminator for the `choice`
+        is the same as that being used for the outermost tagged union. This is used to
+        determine whether this TaggedUnionSchema choice should be "coalesced" into the top level,
+        or whether it should be treated as a separate (nested) choice.
+        """
+        inner_discriminator = choice['discriminator']
+        return inner_discriminator == self.discriminator or (
+            isinstance(inner_discriminator, list)
+            and (self.discriminator in inner_discriminator or [self.discriminator] in inner_discriminator)
+        )
+
+    def _infer_discriminator_values_for_choice(  # noqa C901
+        self, choice: core_schema.CoreSchema, source_name: str | None
+    ) -> list[str | int]:
+        """This function recurses over `choice`, extracting all discriminator values that should map to this choice.
+
+        `model_name` is accepted for the purpose of producing useful error messages.
+        """
+        if choice['type'] == 'definitions':
+            return self._infer_discriminator_values_for_choice(choice['schema'], source_name=source_name)
+        elif choice['type'] == 'function-plain':
+            raise TypeError(
+                f'{choice["type"]!r} is not a valid discriminated union variant;'
+                ' should be a `BaseModel` or `dataclass`'
+            )
+        elif _core_utils.is_function_with_inner_schema(choice):
+            return self._infer_discriminator_values_for_choice(choice['schema'], source_name=source_name)
+        elif choice['type'] == 'lax-or-strict':
+            return sorted(
+                set(
+                    self._infer_discriminator_values_for_choice(choice['lax_schema'], source_name=None)
+                    + self._infer_discriminator_values_for_choice(choice['strict_schema'], source_name=None)
+                )
+            )
+
+        elif choice['type'] == 'tagged-union':
+            values: list[str | int] = []
+            # Ignore str/int "choices" since these are just references to other choices
+            subchoices = [x for x in choice['choices'].values() if not isinstance(x, (str, int))]
+            for subchoice in subchoices:
+                subchoice_values = self._infer_discriminator_values_for_choice(subchoice, source_name=None)
+                values.extend(subchoice_values)
+            return values
+
+        elif choice['type'] == 'union':
+            values = []
+            for subchoice in choice['choices']:
+                subchoice_schema = subchoice[0] if isinstance(subchoice, tuple) else subchoice
+                subchoice_values = self._infer_discriminator_values_for_choice(subchoice_schema, source_name=None)
+                values.extend(subchoice_values)
+            return values
+
+        elif choice['type'] == 'nullable':
+            self._should_be_nullable = True
+            return self._infer_discriminator_values_for_choice(choice['schema'], source_name=None)
+
+        elif choice['type'] == 'model':
+            return self._infer_discriminator_values_for_choice(choice['schema'], source_name=choice['cls'].__name__)
+
+        elif choice['type'] == 'dataclass':
+            return self._infer_discriminator_values_for_choice(choice['schema'], source_name=choice['cls'].__name__)
+
+        elif choice['type'] == 'model-fields':
+            return self._infer_discriminator_values_for_model_choice(choice, source_name=source_name)
+
+        elif choice['type'] == 'dataclass-args':
+            return self._infer_discriminator_values_for_dataclass_choice(choice, source_name=source_name)
+
+        elif choice['type'] == 'typed-dict':
+            return self._infer_discriminator_values_for_typed_dict_choice(choice, source_name=source_name)
+
+        elif choice['type'] == 'definition-ref':
+            schema_ref = choice['schema_ref']
+            if schema_ref not in self.definitions:
+                raise MissingDefinitionForUnionRef(schema_ref)
+            return self._infer_discriminator_values_for_choice(self.definitions[schema_ref], source_name=source_name)
+        else:
+            raise TypeError(
+                f'{choice["type"]!r} is not a valid discriminated union variant;'
+                ' should be a `BaseModel` or `dataclass`'
+            )
+
+    def _infer_discriminator_values_for_typed_dict_choice(
+        self, choice: core_schema.TypedDictSchema, source_name: str | None = None
+    ) -> list[str | int]:
+        """This method just extracts the _infer_discriminator_values_for_choice logic specific to TypedDictSchema
+        for the sake of readability.
+        """
+        source = 'TypedDict' if source_name is None else f'TypedDict {source_name!r}'
+        field = choice['fields'].get(self.discriminator)
+        if field is None:
+            raise PydanticUserError(
+                f'{source} needs a discriminator field for key {self.discriminator!r}', code='discriminator-no-field'
+            )
+        return self._infer_discriminator_values_for_field(field, source)
+
+    def _infer_discriminator_values_for_model_choice(
+        self, choice: core_schema.ModelFieldsSchema, source_name: str | None = None
+    ) -> list[str | int]:
+        source = 'ModelFields' if source_name is None else f'Model {source_name!r}'
+        field = choice['fields'].get(self.discriminator)
+        if field is None:
+            raise PydanticUserError(
+                f'{source} needs a discriminator field for key {self.discriminator!r}', code='discriminator-no-field'
+            )
+        return self._infer_discriminator_values_for_field(field, source)
+
+    def _infer_discriminator_values_for_dataclass_choice(
+        self, choice: core_schema.DataclassArgsSchema, source_name: str | None = None
+    ) -> list[str | int]:
+        source = 'DataclassArgs' if source_name is None else f'Dataclass {source_name!r}'
+        for field in choice['fields']:
+            if field['name'] == self.discriminator:
+                break
+        else:
+            raise PydanticUserError(
+                f'{source} needs a discriminator field for key {self.discriminator!r}', code='discriminator-no-field'
+            )
+        return self._infer_discriminator_values_for_field(field, source)
+
+    def _infer_discriminator_values_for_field(self, field: CoreSchemaField, source: str) -> list[str | int]:
+        if field['type'] == 'computed-field':
+            # This should never occur as a discriminator, as it is only relevant to serialization
+            return []
+        alias = field.get('validation_alias', self.discriminator)
+        if not isinstance(alias, str):
+            raise PydanticUserError(
+                f'Alias {alias!r} is not supported in a discriminated union', code='discriminator-alias-type'
+            )
+        if self._discriminator_alias is None:
+            self._discriminator_alias = alias
+        elif self._discriminator_alias != alias:
+            raise PydanticUserError(
+                f'Aliases for discriminator {self.discriminator!r} must be the same '
+                f'(got {alias}, {self._discriminator_alias})',
+                code='discriminator-alias',
+            )
+        return self._infer_discriminator_values_for_inner_schema(field['schema'], source)
+
+    def _infer_discriminator_values_for_inner_schema(
+        self, schema: core_schema.CoreSchema, source: str
+    ) -> list[str | int]:
+        """When inferring discriminator values for a field, we typically extract the expected values from a literal
+        schema. This function does that, but also handles nested unions and defaults.
+        """
+        if schema['type'] == 'literal':
+            return schema['expected']
+
+        elif schema['type'] == 'union':
+            # Generally when multiple values are allowed they should be placed in a single `Literal`, but
+            # we add this case to handle the situation where a field is annotated as a `Union` of `Literal`s.
+            # For example, this lets us handle `Union[Literal['key'], Union[Literal['Key'], Literal['KEY']]]`
+            values: list[Any] = []
+            for choice in schema['choices']:
+                choice_schema = choice[0] if isinstance(choice, tuple) else choice
+                choice_values = self._infer_discriminator_values_for_inner_schema(choice_schema, source)
+                values.extend(choice_values)
+            return values
+
+        elif schema['type'] == 'default':
+            # This will happen if the field has a default value; we ignore it while extracting the discriminator values
+            return self._infer_discriminator_values_for_inner_schema(schema['schema'], source)
+
+        elif schema['type'] == 'function-after':
+            # After validators don't affect the discriminator values
+            return self._infer_discriminator_values_for_inner_schema(schema['schema'], source)
+
+        elif schema['type'] in {'function-before', 'function-wrap', 'function-plain'}:
+            validator_type = repr(schema['type'].split('-')[1])
+            raise PydanticUserError(
+                f'Cannot use a mode={validator_type} validator in the'
+                f' discriminator field {self.discriminator!r} of {source}',
+                code='discriminator-validator',
+            )
+
+        else:
+            raise PydanticUserError(
+                f'{source} needs field {self.discriminator!r} to be of type `Literal`',
+                code='discriminator-needs-literal',
+            )
+
+    def _set_unique_choice_for_values(self, choice: core_schema.CoreSchema, values: Sequence[str | int]) -> None:
+        """This method updates `self.tagged_union_choices` so that all provided (discriminator) `values` map to the
+        provided `choice`, validating that none of these values already map to another (different) choice.
+        """
+        for discriminator_value in values:
+            if discriminator_value in self._tagged_union_choices:
+                # It is okay if `value` is already in tagged_union_choices as long as it maps to the same value.
+                # Because tagged_union_choices may map values to other values, we need to walk the choices dict
+                # until we get to a "real" choice, and confirm that is equal to the one assigned.
+                existing_choice = self._tagged_union_choices[discriminator_value]
+                if existing_choice != choice:
+                    raise TypeError(
+                        f'Value {discriminator_value!r} for discriminator '
+                        f'{self.discriminator!r} mapped to multiple choices'
+                    )
+            else:
+                self._tagged_union_choices[discriminator_value] = choice
diff --git a/lib/pydantic/_internal/_fields.py b/lib/pydantic/_internal/_fields.py
new file mode 100644
index 00000000..94de3062
--- /dev/null
+++ b/lib/pydantic/_internal/_fields.py
@@ -0,0 +1,319 @@
+"""Private logic related to fields (the `Field()` function and `FieldInfo` class), and arguments to `Annotated`."""
+from __future__ import annotations as _annotations
+
+import dataclasses
+import sys
+import warnings
+from copy import copy
+from functools import lru_cache
+from typing import TYPE_CHECKING, Any
+
+from pydantic_core import PydanticUndefined
+
+from pydantic.errors import PydanticUserError
+
+from . import _typing_extra
+from ._config import ConfigWrapper
+from ._repr import Representation
+from ._typing_extra import get_cls_type_hints_lenient, get_type_hints, is_classvar, is_finalvar
+
+if TYPE_CHECKING:
+    from annotated_types import BaseMetadata
+
+    from ..fields import FieldInfo
+    from ..main import BaseModel
+    from ._dataclasses import StandardDataclass
+    from ._decorators import DecoratorInfos
+
+
+def get_type_hints_infer_globalns(
+    obj: Any,
+    localns: dict[str, Any] | None = None,
+    include_extras: bool = False,
+) -> dict[str, Any]:
+    """Gets type hints for an object by inferring the global namespace.
+
+    It uses the `typing.get_type_hints`, The only thing that we do here is fetching
+    global namespace from `obj.__module__` if it is not `None`.
+
+    Args:
+        obj: The object to get its type hints.
+        localns: The local namespaces.
+        include_extras: Whether to recursively include annotation metadata.
+
+    Returns:
+        The object type hints.
+    """
+    module_name = getattr(obj, '__module__', None)
+    globalns: dict[str, Any] | None = None
+    if module_name:
+        try:
+            globalns = sys.modules[module_name].__dict__
+        except KeyError:
+            # happens occasionally, see https://github.com/pydantic/pydantic/issues/2363
+            pass
+    return get_type_hints(obj, globalns=globalns, localns=localns, include_extras=include_extras)
+
+
+class PydanticMetadata(Representation):
+    """Base class for annotation markers like `Strict`."""
+
+    __slots__ = ()
+
+
+def pydantic_general_metadata(**metadata: Any) -> BaseMetadata:
+    """Create a new `_PydanticGeneralMetadata` class with the given metadata.
+
+    Args:
+        **metadata: The metadata to add.
+
+    Returns:
+        The new `_PydanticGeneralMetadata` class.
+    """
+    return _general_metadata_cls()(metadata)  # type: ignore
+
+
+@lru_cache(maxsize=None)
+def _general_metadata_cls() -> type[BaseMetadata]:
+    """Do it this way to avoid importing `annotated_types` at import time."""
+    from annotated_types import BaseMetadata
+
+    class _PydanticGeneralMetadata(PydanticMetadata, BaseMetadata):
+        """Pydantic general metadata like `max_digits`."""
+
+        def __init__(self, metadata: Any):
+            self.__dict__ = metadata
+
+    return _PydanticGeneralMetadata  # type: ignore
+
+
+def collect_model_fields(  # noqa: C901
+    cls: type[BaseModel],
+    bases: tuple[type[Any], ...],
+    config_wrapper: ConfigWrapper,
+    types_namespace: dict[str, Any] | None,
+    *,
+    typevars_map: dict[Any, Any] | None = None,
+) -> tuple[dict[str, FieldInfo], set[str]]:
+    """Collect the fields of a nascent pydantic model.
+
+    Also collect the names of any ClassVars present in the type hints.
+
+    The returned value is a tuple of two items: the fields dict, and the set of ClassVar names.
+
+    Args:
+        cls: BaseModel or dataclass.
+        bases: Parents of the class, generally `cls.__bases__`.
+        config_wrapper: The config wrapper instance.
+        types_namespace: Optional extra namespace to look for types in.
+        typevars_map: A dictionary mapping type variables to their concrete types.
+
+    Returns:
+        A tuple contains fields and class variables.
+
+    Raises:
+        NameError:
+            - If there is a conflict between a field name and protected namespaces.
+            - If there is a field other than `root` in `RootModel`.
+            - If a field shadows an attribute in the parent model.
+    """
+    from ..fields import FieldInfo
+
+    type_hints = get_cls_type_hints_lenient(cls, types_namespace)
+
+    # https://docs.python.org/3/howto/annotations.html#accessing-the-annotations-dict-of-an-object-in-python-3-9-and-older
+    # annotations is only used for finding fields in parent classes
+    annotations = cls.__dict__.get('__annotations__', {})
+    fields: dict[str, FieldInfo] = {}
+
+    class_vars: set[str] = set()
+    for ann_name, ann_type in type_hints.items():
+        if ann_name == 'model_config':
+            # We never want to treat `model_config` as a field
+            # Note: we may need to change this logic if/when we introduce a `BareModel` class with no
+            # protected namespaces (where `model_config` might be allowed as a field name)
+            continue
+        for protected_namespace in config_wrapper.protected_namespaces:
+            if ann_name.startswith(protected_namespace):
+                for b in bases:
+                    if hasattr(b, ann_name):
+                        from ..main import BaseModel
+
+                        if not (issubclass(b, BaseModel) and ann_name in b.model_fields):
+                            raise NameError(
+                                f'Field "{ann_name}" conflicts with member {getattr(b, ann_name)}'
+                                f' of protected namespace "{protected_namespace}".'
+                            )
+                else:
+                    valid_namespaces = tuple(
+                        x for x in config_wrapper.protected_namespaces if not ann_name.startswith(x)
+                    )
+                    warnings.warn(
+                        f'Field "{ann_name}" has conflict with protected namespace "{protected_namespace}".'
+                        '\n\nYou may be able to resolve this warning by setting'
+                        f" `model_config['protected_namespaces'] = {valid_namespaces}`.",
+                        UserWarning,
+                    )
+        if is_classvar(ann_type):
+            class_vars.add(ann_name)
+            continue
+        if _is_finalvar_with_default_val(ann_type, getattr(cls, ann_name, PydanticUndefined)):
+            class_vars.add(ann_name)
+            continue
+        if not is_valid_field_name(ann_name):
+            continue
+        if cls.__pydantic_root_model__ and ann_name != 'root':
+            raise NameError(
+                f"Unexpected field with name {ann_name!r}; only 'root' is allowed as a field of a `RootModel`"
+            )
+
+        # when building a generic model with `MyModel[int]`, the generic_origin check makes sure we don't get
+        # "... shadows an attribute" errors
+        generic_origin = getattr(cls, '__pydantic_generic_metadata__', {}).get('origin')
+        for base in bases:
+            dataclass_fields = {
+                field.name for field in (dataclasses.fields(base) if dataclasses.is_dataclass(base) else ())
+            }
+            if hasattr(base, ann_name):
+                if base is generic_origin:
+                    # Don't error when "shadowing" of attributes in parametrized generics
+                    continue
+
+                if ann_name in dataclass_fields:
+                    # Don't error when inheriting stdlib dataclasses whose fields are "shadowed" by defaults being set
+                    # on the class instance.
+                    continue
+                warnings.warn(
+                    f'Field name "{ann_name}" shadows an attribute in parent "{base.__qualname__}"; ',
+                    UserWarning,
+                )
+
+        try:
+            default = getattr(cls, ann_name, PydanticUndefined)
+            if default is PydanticUndefined:
+                raise AttributeError
+        except AttributeError:
+            if ann_name in annotations:
+                field_info = FieldInfo.from_annotation(ann_type)
+            else:
+                # if field has no default value and is not in __annotations__ this means that it is
+                # defined in a base class and we can take it from there
+                model_fields_lookup: dict[str, FieldInfo] = {}
+                for x in cls.__bases__[::-1]:
+                    model_fields_lookup.update(getattr(x, 'model_fields', {}))
+                if ann_name in model_fields_lookup:
+                    # The field was present on one of the (possibly multiple) base classes
+                    # copy the field to make sure typevar substitutions don't cause issues with the base classes
+                    field_info = copy(model_fields_lookup[ann_name])
+                else:
+                    # The field was not found on any base classes; this seems to be caused by fields not getting
+                    # generated thanks to models not being fully defined while initializing recursive models.
+                    # Nothing stops us from just creating a new FieldInfo for this type hint, so we do this.
+                    field_info = FieldInfo.from_annotation(ann_type)
+        else:
+            field_info = FieldInfo.from_annotated_attribute(ann_type, default)
+            # attributes which are fields are removed from the class namespace:
+            # 1. To match the behaviour of annotation-only fields
+            # 2. To avoid false positives in the NameError check above
+            try:
+                delattr(cls, ann_name)
+            except AttributeError:
+                pass  # indicates the attribute was on a parent class
+
+        # Use cls.__dict__['__pydantic_decorators__'] instead of cls.__pydantic_decorators__
+        # to make sure the decorators have already been built for this exact class
+        decorators: DecoratorInfos = cls.__dict__['__pydantic_decorators__']
+        if ann_name in decorators.computed_fields:
+            raise ValueError("you can't override a field with a computed field")
+        fields[ann_name] = field_info
+
+    if typevars_map:
+        for field in fields.values():
+            field.apply_typevars_map(typevars_map, types_namespace)
+
+    return fields, class_vars
+
+
+def _is_finalvar_with_default_val(type_: type[Any], val: Any) -> bool:
+    from ..fields import FieldInfo
+
+    if not is_finalvar(type_):
+        return False
+    elif val is PydanticUndefined:
+        return False
+    elif isinstance(val, FieldInfo) and (val.default is PydanticUndefined and val.default_factory is None):
+        return False
+    else:
+        return True
+
+
+def collect_dataclass_fields(
+    cls: type[StandardDataclass], types_namespace: dict[str, Any] | None, *, typevars_map: dict[Any, Any] | None = None
+) -> dict[str, FieldInfo]:
+    """Collect the fields of a dataclass.
+
+    Args:
+        cls: dataclass.
+        types_namespace: Optional extra namespace to look for types in.
+        typevars_map: A dictionary mapping type variables to their concrete types.
+
+    Returns:
+        The dataclass fields.
+    """
+    from ..fields import FieldInfo
+
+    fields: dict[str, FieldInfo] = {}
+    dataclass_fields: dict[str, dataclasses.Field] = cls.__dataclass_fields__
+    cls_localns = dict(vars(cls))  # this matches get_cls_type_hints_lenient, but all tests pass with `= None` instead
+
+    source_module = sys.modules.get(cls.__module__)
+    if source_module is not None:
+        types_namespace = {**source_module.__dict__, **(types_namespace or {})}
+
+    for ann_name, dataclass_field in dataclass_fields.items():
+        ann_type = _typing_extra.eval_type_lenient(dataclass_field.type, types_namespace, cls_localns)
+        if is_classvar(ann_type):
+            continue
+
+        if (
+            not dataclass_field.init
+            and dataclass_field.default == dataclasses.MISSING
+            and dataclass_field.default_factory == dataclasses.MISSING
+        ):
+            # TODO: We should probably do something with this so that validate_assignment behaves properly
+            #   Issue: https://github.com/pydantic/pydantic/issues/5470
+            continue
+
+        if isinstance(dataclass_field.default, FieldInfo):
+            if dataclass_field.default.init_var:
+                if dataclass_field.default.init is False:
+                    raise PydanticUserError(
+                        f'Dataclass field {ann_name} has init=False and init_var=True, but these are mutually exclusive.',
+                        code='clashing-init-and-init-var',
+                    )
+
+                # TODO: same note as above re validate_assignment
+                continue
+            field_info = FieldInfo.from_annotated_attribute(ann_type, dataclass_field.default)
+        else:
+            field_info = FieldInfo.from_annotated_attribute(ann_type, dataclass_field)
+
+        fields[ann_name] = field_info
+
+        if field_info.default is not PydanticUndefined and isinstance(getattr(cls, ann_name, field_info), FieldInfo):
+            # We need this to fix the default when the "default" from __dataclass_fields__ is a pydantic.FieldInfo
+            setattr(cls, ann_name, field_info.default)
+
+    if typevars_map:
+        for field in fields.values():
+            field.apply_typevars_map(typevars_map, types_namespace)
+
+    return fields
+
+
+def is_valid_field_name(name: str) -> bool:
+    return not name.startswith('_')
+
+
+def is_valid_privateattr_name(name: str) -> bool:
+    return name.startswith('_') and not name.startswith('__')
diff --git a/lib/pydantic/_internal/_forward_ref.py b/lib/pydantic/_internal/_forward_ref.py
new file mode 100644
index 00000000..231f81d1
--- /dev/null
+++ b/lib/pydantic/_internal/_forward_ref.py
@@ -0,0 +1,23 @@
+from __future__ import annotations as _annotations
+
+from dataclasses import dataclass
+from typing import Union
+
+
+@dataclass
+class PydanticRecursiveRef:
+    type_ref: str
+
+    __name__ = 'PydanticRecursiveRef'
+    __hash__ = object.__hash__
+
+    def __call__(self) -> None:
+        """Defining __call__ is necessary for the `typing` module to let you use an instance of
+        this class as the result of resolving a standard ForwardRef.
+        """
+
+    def __or__(self, other):
+        return Union[self, other]  # type: ignore
+
+    def __ror__(self, other):
+        return Union[other, self]  # type: ignore
diff --git a/lib/pydantic/_internal/_generate_schema.py b/lib/pydantic/_internal/_generate_schema.py
new file mode 100644
index 00000000..6ab7ec19
--- /dev/null
+++ b/lib/pydantic/_internal/_generate_schema.py
@@ -0,0 +1,2231 @@
+"""Convert python types to pydantic-core schema."""
+from __future__ import annotations as _annotations
+
+import collections.abc
+import dataclasses
+import inspect
+import re
+import sys
+import typing
+import warnings
+from contextlib import contextmanager
+from copy import copy, deepcopy
+from enum import Enum
+from functools import partial
+from inspect import Parameter, _ParameterKind, signature
+from itertools import chain
+from operator import attrgetter
+from types import FunctionType, LambdaType, MethodType
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    Dict,
+    Final,
+    ForwardRef,
+    Iterable,
+    Iterator,
+    Mapping,
+    Type,
+    TypeVar,
+    Union,
+    cast,
+    overload,
+)
+from warnings import warn
+
+from pydantic_core import CoreSchema, PydanticUndefined, core_schema, to_jsonable_python
+from typing_extensions import Annotated, Literal, TypeAliasType, TypedDict, get_args, get_origin, is_typeddict
+
+from ..aliases import AliasGenerator
+from ..annotated_handlers import GetCoreSchemaHandler, GetJsonSchemaHandler
+from ..config import ConfigDict, JsonDict, JsonEncoder
+from ..errors import PydanticSchemaGenerationError, PydanticUndefinedAnnotation, PydanticUserError
+from ..json_schema import JsonSchemaValue
+from ..version import version_short
+from ..warnings import PydanticDeprecatedSince20
+from . import _core_utils, _decorators, _discriminated_union, _known_annotated_metadata, _typing_extra
+from ._config import ConfigWrapper, ConfigWrapperStack
+from ._core_metadata import CoreMetadataHandler, build_metadata_dict
+from ._core_utils import (
+    CoreSchemaOrField,
+    collect_invalid_schemas,
+    define_expected_missing_refs,
+    get_ref,
+    get_type_ref,
+    is_function_with_inner_schema,
+    is_list_like_schema_with_items_schema,
+    simplify_schema_references,
+    validate_core_schema,
+)
+from ._decorators import (
+    Decorator,
+    DecoratorInfos,
+    FieldSerializerDecoratorInfo,
+    FieldValidatorDecoratorInfo,
+    ModelSerializerDecoratorInfo,
+    ModelValidatorDecoratorInfo,
+    RootValidatorDecoratorInfo,
+    ValidatorDecoratorInfo,
+    get_attribute_from_bases,
+    inspect_field_serializer,
+    inspect_model_serializer,
+    inspect_validator,
+)
+from ._fields import collect_dataclass_fields, get_type_hints_infer_globalns
+from ._forward_ref import PydanticRecursiveRef
+from ._generics import get_standard_typevars_map, has_instance_in_type, recursively_defined_type_refs, replace_types
+from ._schema_generation_shared import (
+    CallbackGetCoreSchemaHandler,
+)
+from ._typing_extra import is_finalvar
+from ._utils import lenient_issubclass
+
+if TYPE_CHECKING:
+    from ..fields import ComputedFieldInfo, FieldInfo
+    from ..main import BaseModel
+    from ..types import Discriminator
+    from ..validators import FieldValidatorModes
+    from ._dataclasses import StandardDataclass
+    from ._schema_generation_shared import GetJsonSchemaFunction
+
+_SUPPORTS_TYPEDDICT = sys.version_info >= (3, 12)
+_AnnotatedType = type(Annotated[int, 123])
+
+FieldDecoratorInfo = Union[ValidatorDecoratorInfo, FieldValidatorDecoratorInfo, FieldSerializerDecoratorInfo]
+FieldDecoratorInfoType = TypeVar('FieldDecoratorInfoType', bound=FieldDecoratorInfo)
+AnyFieldDecorator = Union[
+    Decorator[ValidatorDecoratorInfo],
+    Decorator[FieldValidatorDecoratorInfo],
+    Decorator[FieldSerializerDecoratorInfo],
+]
+
+ModifyCoreSchemaWrapHandler = GetCoreSchemaHandler
+GetCoreSchemaFunction = Callable[[Any, ModifyCoreSchemaWrapHandler], core_schema.CoreSchema]
+
+
+TUPLE_TYPES: list[type] = [tuple, typing.Tuple]
+LIST_TYPES: list[type] = [list, typing.List, collections.abc.MutableSequence]
+SET_TYPES: list[type] = [set, typing.Set, collections.abc.MutableSet]
+FROZEN_SET_TYPES: list[type] = [frozenset, typing.FrozenSet, collections.abc.Set]
+DICT_TYPES: list[type] = [dict, typing.Dict, collections.abc.MutableMapping, collections.abc.Mapping]
+
+
+def check_validator_fields_against_field_name(
+    info: FieldDecoratorInfo,
+    field: str,
+) -> bool:
+    """Check if field name is in validator fields.
+
+    Args:
+        info: The field info.
+        field: The field name to check.
+
+    Returns:
+        `True` if field name is in validator fields, `False` otherwise.
+    """
+    if isinstance(info, (ValidatorDecoratorInfo, FieldValidatorDecoratorInfo)):
+        if '*' in info.fields:
+            return True
+    for v_field_name in info.fields:
+        if v_field_name == field:
+            return True
+    return False
+
+
+def check_decorator_fields_exist(decorators: Iterable[AnyFieldDecorator], fields: Iterable[str]) -> None:
+    """Check if the defined fields in decorators exist in `fields` param.
+
+    It ignores the check for a decorator if the decorator has `*` as field or `check_fields=False`.
+
+    Args:
+        decorators: An iterable of decorators.
+        fields: An iterable of fields name.
+
+    Raises:
+        PydanticUserError: If one of the field names does not exist in `fields` param.
+    """
+    fields = set(fields)
+    for dec in decorators:
+        if isinstance(dec.info, (ValidatorDecoratorInfo, FieldValidatorDecoratorInfo)) and '*' in dec.info.fields:
+            continue
+        if dec.info.check_fields is False:
+            continue
+        for field in dec.info.fields:
+            if field not in fields:
+                raise PydanticUserError(
+                    f'Decorators defined with incorrect fields: {dec.cls_ref}.{dec.cls_var_name}'
+                    " (use check_fields=False if you're inheriting from the model and intended this)",
+                    code='decorator-missing-field',
+                )
+
+
+def filter_field_decorator_info_by_field(
+    validator_functions: Iterable[Decorator[FieldDecoratorInfoType]], field: str
+) -> list[Decorator[FieldDecoratorInfoType]]:
+    return [dec for dec in validator_functions if check_validator_fields_against_field_name(dec.info, field)]
+
+
+def apply_each_item_validators(
+    schema: core_schema.CoreSchema,
+    each_item_validators: list[Decorator[ValidatorDecoratorInfo]],
+    field_name: str | None,
+) -> core_schema.CoreSchema:
+    # This V1 compatibility shim should eventually be removed
+
+    # push down any `each_item=True` validators
+    # note that this won't work for any Annotated types that get wrapped by a function validator
+    # but that's okay because that didn't exist in V1
+    if schema['type'] == 'nullable':
+        schema['schema'] = apply_each_item_validators(schema['schema'], each_item_validators, field_name)
+        return schema
+    elif schema['type'] == 'tuple':
+        if (variadic_item_index := schema.get('variadic_item_index')) is not None:
+            schema['items_schema'][variadic_item_index] = apply_validators(
+                schema['items_schema'][variadic_item_index], each_item_validators, field_name
+            )
+    elif is_list_like_schema_with_items_schema(schema):
+        inner_schema = schema.get('items_schema', None)
+        if inner_schema is None:
+            inner_schema = core_schema.any_schema()
+        schema['items_schema'] = apply_validators(inner_schema, each_item_validators, field_name)
+    elif schema['type'] == 'dict':
+        # push down any `each_item=True` validators onto dict _values_
+        # this is super arbitrary but it's the V1 behavior
+        inner_schema = schema.get('values_schema', None)
+        if inner_schema is None:
+            inner_schema = core_schema.any_schema()
+        schema['values_schema'] = apply_validators(inner_schema, each_item_validators, field_name)
+    elif each_item_validators:
+        raise TypeError(
+            f"`@validator(..., each_item=True)` cannot be applied to fields with a schema of {schema['type']}"
+        )
+    return schema
+
+
+def modify_model_json_schema(
+    schema_or_field: CoreSchemaOrField, handler: GetJsonSchemaHandler, *, cls: Any
+) -> JsonSchemaValue:
+    """Add title and description for model-like classes' JSON schema.
+
+    Args:
+        schema_or_field: The schema data to generate a JSON schema from.
+        handler: The `GetCoreSchemaHandler` instance.
+        cls: The model-like class.
+
+    Returns:
+        JsonSchemaValue: The updated JSON schema.
+    """
+    from ..main import BaseModel
+
+    json_schema = handler(schema_or_field)
+    original_schema = handler.resolve_ref_schema(json_schema)
+    # Preserve the fact that definitions schemas should never have sibling keys:
+    if '$ref' in original_schema:
+        ref = original_schema['$ref']
+        original_schema.clear()
+        original_schema['allOf'] = [{'$ref': ref}]
+    if 'title' not in original_schema:
+        original_schema['title'] = cls.__name__
+    # BaseModel; don't use cls.__doc__ as it will contain the verbose class signature by default
+    docstring = None if cls is BaseModel else cls.__doc__
+    if docstring and 'description' not in original_schema:
+        original_schema['description'] = inspect.cleandoc(docstring)
+    return json_schema
+
+
+JsonEncoders = Dict[Type[Any], JsonEncoder]
+
+
+def _add_custom_serialization_from_json_encoders(
+    json_encoders: JsonEncoders | None, tp: Any, schema: CoreSchema
+) -> CoreSchema:
+    """Iterate over the json_encoders and add the first matching encoder to the schema.
+
+    Args:
+        json_encoders: A dictionary of types and their encoder functions.
+        tp: The type to check for a matching encoder.
+        schema: The schema to add the encoder to.
+    """
+    if not json_encoders:
+        return schema
+    if 'serialization' in schema:
+        return schema
+    # Check the class type and its superclasses for a matching encoder
+    # Decimal.__class__.__mro__ (and probably other cases) doesn't include Decimal itself
+    # if the type is a GenericAlias (e.g. from list[int]) we need to use __class__ instead of .__mro__
+    for base in (tp, *getattr(tp, '__mro__', tp.__class__.__mro__)[:-1]):
+        encoder = json_encoders.get(base)
+        if encoder is None:
+            continue
+
+        warnings.warn(
+            f'`json_encoders` is deprecated. See https://docs.pydantic.dev/{version_short()}/concepts/serialization/#custom-serializers for alternatives',
+            PydanticDeprecatedSince20,
+        )
+
+        # TODO: in theory we should check that the schema accepts a serialization key
+        schema['serialization'] = core_schema.plain_serializer_function_ser_schema(encoder, when_used='json')
+        return schema
+
+    return schema
+
+
+TypesNamespace = Union[Dict[str, Any], None]
+
+
+class TypesNamespaceStack:
+    """A stack of types namespaces."""
+
+    def __init__(self, types_namespace: TypesNamespace):
+        self._types_namespace_stack: list[TypesNamespace] = [types_namespace]
+
+    @property
+    def tail(self) -> TypesNamespace:
+        return self._types_namespace_stack[-1]
+
+    @contextmanager
+    def push(self, for_type: type[Any]):
+        types_namespace = {**_typing_extra.get_cls_types_namespace(for_type), **(self.tail or {})}
+        self._types_namespace_stack.append(types_namespace)
+        try:
+            yield
+        finally:
+            self._types_namespace_stack.pop()
+
+
+class GenerateSchema:
+    """Generate core schema for a Pydantic model, dataclass and types like `str`, `datetime`, ... ."""
+
+    __slots__ = (
+        '_config_wrapper_stack',
+        '_types_namespace_stack',
+        '_typevars_map',
+        '_has_invalid_schema',
+        'field_name_stack',
+        'defs',
+    )
+
+    def __init__(
+        self,
+        config_wrapper: ConfigWrapper,
+        types_namespace: dict[str, Any] | None,
+        typevars_map: dict[Any, Any] | None = None,
+    ) -> None:
+        # we need a stack for recursing into child models
+        self._config_wrapper_stack = ConfigWrapperStack(config_wrapper)
+        self._types_namespace_stack = TypesNamespaceStack(types_namespace)
+        self._typevars_map = typevars_map
+        self._has_invalid_schema = False
+        self.field_name_stack = _FieldNameStack()
+        self.defs = _Definitions()
+
+    @classmethod
+    def __from_parent(
+        cls,
+        config_wrapper_stack: ConfigWrapperStack,
+        types_namespace_stack: TypesNamespaceStack,
+        typevars_map: dict[Any, Any] | None,
+        defs: _Definitions,
+    ) -> GenerateSchema:
+        obj = cls.__new__(cls)
+        obj._config_wrapper_stack = config_wrapper_stack
+        obj._types_namespace_stack = types_namespace_stack
+        obj._typevars_map = typevars_map
+        obj._has_invalid_schema = False
+        obj.field_name_stack = _FieldNameStack()
+        obj.defs = defs
+        return obj
+
+    @property
+    def _config_wrapper(self) -> ConfigWrapper:
+        return self._config_wrapper_stack.tail
+
+    @property
+    def _types_namespace(self) -> dict[str, Any] | None:
+        return self._types_namespace_stack.tail
+
+    @property
+    def _current_generate_schema(self) -> GenerateSchema:
+        cls = self._config_wrapper.schema_generator or GenerateSchema
+        return cls.__from_parent(
+            self._config_wrapper_stack,
+            self._types_namespace_stack,
+            self._typevars_map,
+            self.defs,
+        )
+
+    @property
+    def _arbitrary_types(self) -> bool:
+        return self._config_wrapper.arbitrary_types_allowed
+
+    def str_schema(self) -> CoreSchema:
+        """Generate a CoreSchema for `str`"""
+        return core_schema.str_schema()
+
+    # the following methods can be overridden but should be considered
+    # unstable / private APIs
+    def _list_schema(self, tp: Any, items_type: Any) -> CoreSchema:
+        return core_schema.list_schema(self.generate_schema(items_type))
+
+    def _dict_schema(self, tp: Any, keys_type: Any, values_type: Any) -> CoreSchema:
+        return core_schema.dict_schema(self.generate_schema(keys_type), self.generate_schema(values_type))
+
+    def _set_schema(self, tp: Any, items_type: Any) -> CoreSchema:
+        return core_schema.set_schema(self.generate_schema(items_type))
+
+    def _frozenset_schema(self, tp: Any, items_type: Any) -> CoreSchema:
+        return core_schema.frozenset_schema(self.generate_schema(items_type))
+
+    def _arbitrary_type_schema(self, tp: Any) -> CoreSchema:
+        if not isinstance(tp, type):
+            warn(
+                f'{tp!r} is not a Python type (it may be an instance of an object),'
+                ' Pydantic will allow any object with no validation since we cannot even'
+                ' enforce that the input is an instance of the given type.'
+                ' To get rid of this error wrap the type with `pydantic.SkipValidation`.',
+                UserWarning,
+            )
+            return core_schema.any_schema()
+        return core_schema.is_instance_schema(tp)
+
+    def _unknown_type_schema(self, obj: Any) -> CoreSchema:
+        raise PydanticSchemaGenerationError(
+            f'Unable to generate pydantic-core schema for {obj!r}. '
+            'Set `arbitrary_types_allowed=True` in the model_config to ignore this error'
+            ' or implement `__get_pydantic_core_schema__` on your type to fully support it.'
+            '\n\nIf you got this error by calling handler(<some type>) within'
+            ' `__get_pydantic_core_schema__` then you likely need to call'
+            ' `handler.generate_schema(<some type>)` since we do not call'
+            ' `__get_pydantic_core_schema__` on `<some type>` otherwise to avoid infinite recursion.'
+        )
+
+    def _apply_discriminator_to_union(
+        self, schema: CoreSchema, discriminator: str | Discriminator | None
+    ) -> CoreSchema:
+        if discriminator is None:
+            return schema
+        try:
+            return _discriminated_union.apply_discriminator(
+                schema,
+                discriminator,
+            )
+        except _discriminated_union.MissingDefinitionForUnionRef:
+            # defer until defs are resolved
+            _discriminated_union.set_discriminator_in_metadata(
+                schema,
+                discriminator,
+            )
+            return schema
+
+    class CollectedInvalid(Exception):
+        pass
+
+    def clean_schema(self, schema: CoreSchema) -> CoreSchema:
+        schema = self.collect_definitions(schema)
+        schema = simplify_schema_references(schema)
+        schema = _discriminated_union.apply_discriminators(schema)
+        if collect_invalid_schemas(schema):
+            raise self.CollectedInvalid()
+        schema = validate_core_schema(schema)
+        return schema
+
+    def collect_definitions(self, schema: CoreSchema) -> CoreSchema:
+        ref = cast('str | None', schema.get('ref', None))
+        if ref:
+            self.defs.definitions[ref] = schema
+        if 'ref' in schema:
+            schema = core_schema.definition_reference_schema(schema['ref'])
+        return core_schema.definitions_schema(
+            schema,
+            list(self.defs.definitions.values()),
+        )
+
+    def _add_js_function(self, metadata_schema: CoreSchema, js_function: Callable[..., Any]) -> None:
+        metadata = CoreMetadataHandler(metadata_schema).metadata
+        pydantic_js_functions = metadata.setdefault('pydantic_js_functions', [])
+        # because of how we generate core schemas for nested generic models
+        # we can end up adding `BaseModel.__get_pydantic_json_schema__` multiple times
+        # this check may fail to catch duplicates if the function is a `functools.partial`
+        # or something like that
+        # but if it does it'll fail by inserting the duplicate
+        if js_function not in pydantic_js_functions:
+            pydantic_js_functions.append(js_function)
+
+    def generate_schema(
+        self,
+        obj: Any,
+        from_dunder_get_core_schema: bool = True,
+    ) -> core_schema.CoreSchema:
+        """Generate core schema.
+
+        Args:
+            obj: The object to generate core schema for.
+            from_dunder_get_core_schema: Whether to generate schema from either the
+                `__get_pydantic_core_schema__` function or `__pydantic_core_schema__` property.
+
+        Returns:
+            The generated core schema.
+
+        Raises:
+            PydanticUndefinedAnnotation:
+                If it is not possible to evaluate forward reference.
+            PydanticSchemaGenerationError:
+                If it is not possible to generate pydantic-core schema.
+            TypeError:
+                - If `alias_generator` returns a disallowed type (must be str, AliasPath or AliasChoices).
+                - If V1 style validator with `each_item=True` applied on a wrong field.
+            PydanticUserError:
+                - If `typing.TypedDict` is used instead of `typing_extensions.TypedDict` on Python < 3.12.
+                - If `__modify_schema__` method is used instead of `__get_pydantic_json_schema__`.
+        """
+        schema: CoreSchema | None = None
+
+        if from_dunder_get_core_schema:
+            from_property = self._generate_schema_from_property(obj, obj)
+            if from_property is not None:
+                schema = from_property
+
+        if schema is None:
+            schema = self._generate_schema(obj)
+
+        metadata_js_function = _extract_get_pydantic_json_schema(obj, schema)
+        if metadata_js_function is not None:
+            metadata_schema = resolve_original_schema(schema, self.defs.definitions)
+            if metadata_schema:
+                self._add_js_function(metadata_schema, metadata_js_function)
+
+        schema = _add_custom_serialization_from_json_encoders(self._config_wrapper.json_encoders, obj, schema)
+
+        schema = self._post_process_generated_schema(schema)
+
+        return schema
+
+    def _model_schema(self, cls: type[BaseModel]) -> core_schema.CoreSchema:
+        """Generate schema for a Pydantic model."""
+        with self.defs.get_schema_or_ref(cls) as (model_ref, maybe_schema):
+            if maybe_schema is not None:
+                return maybe_schema
+
+            fields = cls.model_fields
+            decorators = cls.__pydantic_decorators__
+            computed_fields = decorators.computed_fields
+            check_decorator_fields_exist(
+                chain(
+                    decorators.field_validators.values(),
+                    decorators.field_serializers.values(),
+                    decorators.validators.values(),
+                ),
+                {*fields.keys(), *computed_fields.keys()},
+            )
+            config_wrapper = ConfigWrapper(cls.model_config, check=False)
+            core_config = config_wrapper.core_config(cls)
+            metadata = build_metadata_dict(js_functions=[partial(modify_model_json_schema, cls=cls)])
+
+            model_validators = decorators.model_validators.values()
+
+            extras_schema = None
+            if core_config.get('extra_fields_behavior') == 'allow':
+                for tp in (cls, *cls.__mro__):
+                    extras_annotation = cls.__annotations__.get('__pydantic_extra__', None)
+                    if extras_annotation is not None:
+                        tp = get_origin(extras_annotation)
+                        if tp not in (Dict, dict):
+                            raise PydanticSchemaGenerationError(
+                                'The type annotation for `__pydantic_extra__` must be `Dict[str, ...]`'
+                            )
+                        extra_items_type = self._get_args_resolving_forward_refs(
+                            cls.__annotations__['__pydantic_extra__'],
+                            required=True,
+                        )[1]
+                        if extra_items_type is not Any:
+                            extras_schema = self.generate_schema(extra_items_type)
+                            break
+
+            with self._config_wrapper_stack.push(config_wrapper), self._types_namespace_stack.push(cls):
+                self = self._current_generate_schema
+                if cls.__pydantic_root_model__:
+                    root_field = self._common_field_schema('root', fields['root'], decorators)
+                    inner_schema = root_field['schema']
+                    inner_schema = apply_model_validators(inner_schema, model_validators, 'inner')
+                    model_schema = core_schema.model_schema(
+                        cls,
+                        inner_schema,
+                        custom_init=getattr(cls, '__pydantic_custom_init__', None),
+                        root_model=True,
+                        post_init=getattr(cls, '__pydantic_post_init__', None),
+                        config=core_config,
+                        ref=model_ref,
+                        metadata=metadata,
+                    )
+                else:
+                    fields_schema: core_schema.CoreSchema = core_schema.model_fields_schema(
+                        {k: self._generate_md_field_schema(k, v, decorators) for k, v in fields.items()},
+                        computed_fields=[
+                            self._computed_field_schema(d, decorators.field_serializers)
+                            for d in computed_fields.values()
+                        ],
+                        extras_schema=extras_schema,
+                        model_name=cls.__name__,
+                    )
+                    inner_schema = apply_validators(fields_schema, decorators.root_validators.values(), None)
+                    new_inner_schema = define_expected_missing_refs(inner_schema, recursively_defined_type_refs())
+                    if new_inner_schema is not None:
+                        inner_schema = new_inner_schema
+                    inner_schema = apply_model_validators(inner_schema, model_validators, 'inner')
+
+                    model_schema = core_schema.model_schema(
+                        cls,
+                        inner_schema,
+                        custom_init=getattr(cls, '__pydantic_custom_init__', None),
+                        root_model=False,
+                        post_init=getattr(cls, '__pydantic_post_init__', None),
+                        config=core_config,
+                        ref=model_ref,
+                        metadata=metadata,
+                    )
+
+                schema = self._apply_model_serializers(model_schema, decorators.model_serializers.values())
+                schema = apply_model_validators(schema, model_validators, 'outer')
+                self.defs.definitions[model_ref] = self._post_process_generated_schema(schema)
+                return core_schema.definition_reference_schema(model_ref)
+
+    def _unpack_refs_defs(self, schema: CoreSchema) -> CoreSchema:
+        """Unpack all 'definitions' schemas into `GenerateSchema.defs.definitions`
+        and return the inner schema.
+        """
+
+        def get_ref(s: CoreSchema) -> str:
+            return s['ref']  # type: ignore
+
+        if schema['type'] == 'definitions':
+            self.defs.definitions.update({get_ref(s): s for s in schema['definitions']})
+            schema = schema['schema']
+        return schema
+
+    def _generate_schema_from_property(self, obj: Any, source: Any) -> core_schema.CoreSchema | None:
+        """Try to generate schema from either the `__get_pydantic_core_schema__` function or
+        `__pydantic_core_schema__` property.
+
+        Note: `__get_pydantic_core_schema__` takes priority so it can
+        decide whether to use a `__pydantic_core_schema__` attribute, or generate a fresh schema.
+        """
+        # avoid calling `__get_pydantic_core_schema__` if we've already visited this object
+        with self.defs.get_schema_or_ref(obj) as (_, maybe_schema):
+            if maybe_schema is not None:
+                return maybe_schema
+        if obj is source:
+            ref_mode = 'unpack'
+        else:
+            ref_mode = 'to-def'
+
+        schema: CoreSchema
+        get_schema = getattr(obj, '__get_pydantic_core_schema__', None)
+        if get_schema is None:
+            validators = getattr(obj, '__get_validators__', None)
+            if validators is None:
+                return None
+            warn(
+                '`__get_validators__` is deprecated and will be removed, use `__get_pydantic_core_schema__` instead.',
+                PydanticDeprecatedSince20,
+            )
+            schema = core_schema.chain_schema([core_schema.with_info_plain_validator_function(v) for v in validators()])
+        else:
+            if len(inspect.signature(get_schema).parameters) == 1:
+                # (source) -> CoreSchema
+                schema = get_schema(source)
+            else:
+                schema = get_schema(
+                    source, CallbackGetCoreSchemaHandler(self._generate_schema, self, ref_mode=ref_mode)
+                )
+
+        schema = self._unpack_refs_defs(schema)
+
+        if is_function_with_inner_schema(schema):
+            ref = schema['schema'].pop('ref', None)  # pyright: ignore[reportGeneralTypeIssues]
+            if ref:
+                schema['ref'] = ref
+        else:
+            ref = get_ref(schema)
+
+        if ref:
+            self.defs.definitions[ref] = self._post_process_generated_schema(schema)
+            return core_schema.definition_reference_schema(ref)
+
+        schema = self._post_process_generated_schema(schema)
+
+        return schema
+
+    def _resolve_forward_ref(self, obj: Any) -> Any:
+        # we assume that types_namespace has the target of forward references in its scope,
+        # but this could fail, for example, if calling Validator on an imported type which contains
+        # forward references to other types only defined in the module from which it was imported
+        # `Validator(SomeImportedTypeAliasWithAForwardReference)`
+        # or the equivalent for BaseModel
+        # class Model(BaseModel):
+        #   x: SomeImportedTypeAliasWithAForwardReference
+        try:
+            obj = _typing_extra.eval_type_backport(obj, globalns=self._types_namespace)
+        except NameError as e:
+            raise PydanticUndefinedAnnotation.from_name_error(e) from e
+
+        # if obj is still a ForwardRef, it means we can't evaluate it, raise PydanticUndefinedAnnotation
+        if isinstance(obj, ForwardRef):
+            raise PydanticUndefinedAnnotation(obj.__forward_arg__, f'Unable to evaluate forward reference {obj}')
+
+        if self._typevars_map:
+            obj = replace_types(obj, self._typevars_map)
+
+        return obj
+
+    @overload
+    def _get_args_resolving_forward_refs(self, obj: Any, required: Literal[True]) -> tuple[Any, ...]:
+        ...
+
+    @overload
+    def _get_args_resolving_forward_refs(self, obj: Any) -> tuple[Any, ...] | None:
+        ...
+
+    def _get_args_resolving_forward_refs(self, obj: Any, required: bool = False) -> tuple[Any, ...] | None:
+        args = get_args(obj)
+        if args:
+            args = tuple([self._resolve_forward_ref(a) if isinstance(a, ForwardRef) else a for a in args])
+        elif required:  # pragma: no cover
+            raise TypeError(f'Expected {obj} to have generic parameters but it had none')
+        return args
+
+    def _get_first_arg_or_any(self, obj: Any) -> Any:
+        args = self._get_args_resolving_forward_refs(obj)
+        if not args:
+            return Any
+        return args[0]
+
+    def _get_first_two_args_or_any(self, obj: Any) -> tuple[Any, Any]:
+        args = self._get_args_resolving_forward_refs(obj)
+        if not args:
+            return (Any, Any)
+        if len(args) < 2:
+            origin = get_origin(obj)
+            raise TypeError(f'Expected two type arguments for {origin}, got 1')
+        return args[0], args[1]
+
+    def _post_process_generated_schema(self, schema: core_schema.CoreSchema) -> core_schema.CoreSchema:
+        if 'metadata' not in schema:
+            schema['metadata'] = {}
+        return schema
+
+    def _generate_schema(self, obj: Any) -> core_schema.CoreSchema:
+        """Recursively generate a pydantic-core schema for any supported python type."""
+        has_invalid_schema = self._has_invalid_schema
+        self._has_invalid_schema = False
+        schema = self._generate_schema_inner(obj)
+        self._has_invalid_schema = self._has_invalid_schema or has_invalid_schema
+        return schema
+
+    def _generate_schema_inner(self, obj: Any) -> core_schema.CoreSchema:
+        if isinstance(obj, _AnnotatedType):
+            return self._annotated_schema(obj)
+
+        if isinstance(obj, dict):
+            # we assume this is already a valid schema
+            return obj  # type: ignore[return-value]
+
+        if isinstance(obj, str):
+            obj = ForwardRef(obj)
+
+        if isinstance(obj, ForwardRef):
+            return self.generate_schema(self._resolve_forward_ref(obj))
+
+        from ..main import BaseModel
+
+        if lenient_issubclass(obj, BaseModel):
+            return self._model_schema(obj)
+
+        if isinstance(obj, PydanticRecursiveRef):
+            return core_schema.definition_reference_schema(schema_ref=obj.type_ref)
+
+        return self.match_type(obj)
+
+    def match_type(self, obj: Any) -> core_schema.CoreSchema:  # noqa: C901
+        """Main mapping of types to schemas.
+
+        The general structure is a series of if statements starting with the simple cases
+        (non-generic primitive types) and then handling generics and other more complex cases.
+
+        Each case either generates a schema directly, calls into a public user-overridable method
+        (like `GenerateSchema.tuple_variable_schema`) or calls into a private method that handles some
+        boilerplate before calling into the user-facing method (e.g. `GenerateSchema._tuple_schema`).
+
+        The idea is that we'll evolve this into adding more and more user facing methods over time
+        as they get requested and we figure out what the right API for them is.
+        """
+        if obj is str:
+            return self.str_schema()
+        elif obj is bytes:
+            return core_schema.bytes_schema()
+        elif obj is int:
+            return core_schema.int_schema()
+        elif obj is float:
+            return core_schema.float_schema()
+        elif obj is bool:
+            return core_schema.bool_schema()
+        elif obj is Any or obj is object:
+            return core_schema.any_schema()
+        elif obj is None or obj is _typing_extra.NoneType:
+            return core_schema.none_schema()
+        elif obj in TUPLE_TYPES:
+            return self._tuple_schema(obj)
+        elif obj in LIST_TYPES:
+            return self._list_schema(obj, self._get_first_arg_or_any(obj))
+        elif obj in SET_TYPES:
+            return self._set_schema(obj, self._get_first_arg_or_any(obj))
+        elif obj in FROZEN_SET_TYPES:
+            return self._frozenset_schema(obj, self._get_first_arg_or_any(obj))
+        elif obj in DICT_TYPES:
+            return self._dict_schema(obj, *self._get_first_two_args_or_any(obj))
+        elif isinstance(obj, TypeAliasType):
+            return self._type_alias_type_schema(obj)
+        elif obj == type:
+            return self._type_schema()
+        elif _typing_extra.is_callable_type(obj):
+            return core_schema.callable_schema()
+        elif _typing_extra.is_literal_type(obj):
+            return self._literal_schema(obj)
+        elif is_typeddict(obj):
+            return self._typed_dict_schema(obj, None)
+        elif _typing_extra.is_namedtuple(obj):
+            return self._namedtuple_schema(obj, None)
+        elif _typing_extra.is_new_type(obj):
+            # NewType, can't use isinstance because it fails <3.10
+            return self.generate_schema(obj.__supertype__)
+        elif obj == re.Pattern:
+            return self._pattern_schema(obj)
+        elif obj is collections.abc.Hashable or obj is typing.Hashable:
+            return self._hashable_schema()
+        elif isinstance(obj, typing.TypeVar):
+            return self._unsubstituted_typevar_schema(obj)
+        elif is_finalvar(obj):
+            if obj is Final:
+                return core_schema.any_schema()
+            return self.generate_schema(
+                self._get_first_arg_or_any(obj),
+            )
+        elif isinstance(obj, (FunctionType, LambdaType, MethodType, partial)):
+            return self._callable_schema(obj)
+        elif inspect.isclass(obj) and issubclass(obj, Enum):
+            from ._std_types_schema import get_enum_core_schema
+
+            return get_enum_core_schema(obj, self._config_wrapper.config_dict)
+
+        if _typing_extra.is_dataclass(obj):
+            return self._dataclass_schema(obj, None)
+
+        res = self._get_prepare_pydantic_annotations_for_known_type(obj, ())
+        if res is not None:
+            source_type, annotations = res
+            return self._apply_annotations(source_type, annotations)
+
+        origin = get_origin(obj)
+        if origin is not None:
+            return self._match_generic_type(obj, origin)
+
+        if self._arbitrary_types:
+            return self._arbitrary_type_schema(obj)
+        return self._unknown_type_schema(obj)
+
+    def _match_generic_type(self, obj: Any, origin: Any) -> CoreSchema:  # noqa: C901
+        if isinstance(origin, TypeAliasType):
+            return self._type_alias_type_schema(obj)
+
+        # Need to handle generic dataclasses before looking for the schema properties because attribute accesses
+        # on _GenericAlias delegate to the origin type, so lose the information about the concrete parametrization
+        # As a result, currently, there is no way to cache the schema for generic dataclasses. This may be possible
+        # to resolve by modifying the value returned by `Generic.__class_getitem__`, but that is a dangerous game.
+        if _typing_extra.is_dataclass(origin):
+            return self._dataclass_schema(obj, origin)
+        if _typing_extra.is_namedtuple(origin):
+            return self._namedtuple_schema(obj, origin)
+
+        from_property = self._generate_schema_from_property(origin, obj)
+        if from_property is not None:
+            return from_property
+
+        if _typing_extra.origin_is_union(origin):
+            return self._union_schema(obj)
+        elif origin in TUPLE_TYPES:
+            return self._tuple_schema(obj)
+        elif origin in LIST_TYPES:
+            return self._list_schema(obj, self._get_first_arg_or_any(obj))
+        elif origin in SET_TYPES:
+            return self._set_schema(obj, self._get_first_arg_or_any(obj))
+        elif origin in FROZEN_SET_TYPES:
+            return self._frozenset_schema(obj, self._get_first_arg_or_any(obj))
+        elif origin in DICT_TYPES:
+            return self._dict_schema(obj, *self._get_first_two_args_or_any(obj))
+        elif is_typeddict(origin):
+            return self._typed_dict_schema(obj, origin)
+        elif origin in (typing.Type, type):
+            return self._subclass_schema(obj)
+        elif origin in {typing.Sequence, collections.abc.Sequence}:
+            return self._sequence_schema(obj)
+        elif origin in {typing.Iterable, collections.abc.Iterable, typing.Generator, collections.abc.Generator}:
+            return self._iterable_schema(obj)
+        elif origin in (re.Pattern, typing.Pattern):
+            return self._pattern_schema(obj)
+
+        if self._arbitrary_types:
+            return self._arbitrary_type_schema(origin)
+        return self._unknown_type_schema(obj)
+
+    def _generate_td_field_schema(
+        self,
+        name: str,
+        field_info: FieldInfo,
+        decorators: DecoratorInfos,
+        *,
+        required: bool = True,
+    ) -> core_schema.TypedDictField:
+        """Prepare a TypedDictField to represent a model or typeddict field."""
+        common_field = self._common_field_schema(name, field_info, decorators)
+        return core_schema.typed_dict_field(
+            common_field['schema'],
+            required=False if not field_info.is_required() else required,
+            serialization_exclude=common_field['serialization_exclude'],
+            validation_alias=common_field['validation_alias'],
+            serialization_alias=common_field['serialization_alias'],
+            metadata=common_field['metadata'],
+        )
+
+    def _generate_md_field_schema(
+        self,
+        name: str,
+        field_info: FieldInfo,
+        decorators: DecoratorInfos,
+    ) -> core_schema.ModelField:
+        """Prepare a ModelField to represent a model field."""
+        common_field = self._common_field_schema(name, field_info, decorators)
+        return core_schema.model_field(
+            common_field['schema'],
+            serialization_exclude=common_field['serialization_exclude'],
+            validation_alias=common_field['validation_alias'],
+            serialization_alias=common_field['serialization_alias'],
+            frozen=common_field['frozen'],
+            metadata=common_field['metadata'],
+        )
+
+    def _generate_dc_field_schema(
+        self,
+        name: str,
+        field_info: FieldInfo,
+        decorators: DecoratorInfos,
+    ) -> core_schema.DataclassField:
+        """Prepare a DataclassField to represent the parameter/field, of a dataclass."""
+        common_field = self._common_field_schema(name, field_info, decorators)
+        return core_schema.dataclass_field(
+            name,
+            common_field['schema'],
+            init=field_info.init,
+            init_only=field_info.init_var or None,
+            kw_only=None if field_info.kw_only else False,
+            serialization_exclude=common_field['serialization_exclude'],
+            validation_alias=common_field['validation_alias'],
+            serialization_alias=common_field['serialization_alias'],
+            frozen=common_field['frozen'],
+            metadata=common_field['metadata'],
+        )
+
+    @staticmethod
+    def _apply_alias_generator_to_field_info(
+        alias_generator: Callable[[str], str] | AliasGenerator, field_info: FieldInfo, field_name: str
+    ) -> None:
+        """Apply an alias_generator to aliases on a FieldInfo instance if appropriate.
+
+        Args:
+            alias_generator: A callable that takes a string and returns a string, or an AliasGenerator instance.
+            field_info: The FieldInfo instance to which the alias_generator is (maybe) applied.
+            field_name: The name of the field from which to generate the alias.
+        """
+        # Apply an alias_generator if
+        # 1. An alias is not specified
+        # 2. An alias is specified, but the priority is <= 1
+        if (
+            field_info.alias_priority is None
+            or field_info.alias_priority <= 1
+            or field_info.alias is None
+            or field_info.validation_alias is None
+            or field_info.serialization_alias is None
+        ):
+            alias, validation_alias, serialization_alias = None, None, None
+
+            if isinstance(alias_generator, AliasGenerator):
+                alias, validation_alias, serialization_alias = alias_generator.generate_aliases(field_name)
+            elif isinstance(alias_generator, Callable):
+                alias = alias_generator(field_name)
+                if not isinstance(alias, str):
+                    raise TypeError(f'alias_generator {alias_generator} must return str, not {alias.__class__}')
+
+            # if priority is not set, we set to 1
+            # which supports the case where the alias_generator from a child class is used
+            # to generate an alias for a field in a parent class
+            if field_info.alias_priority is None or field_info.alias_priority <= 1:
+                field_info.alias_priority = 1
+
+            # if the priority is 1, then we set the aliases to the generated alias
+            if field_info.alias_priority == 1:
+                field_info.serialization_alias = serialization_alias or alias
+                field_info.validation_alias = validation_alias or alias
+                field_info.alias = alias
+
+            # if any of the aliases are not set, then we set them to the corresponding generated alias
+            if field_info.alias is None:
+                field_info.alias = alias
+            if field_info.serialization_alias is None:
+                field_info.serialization_alias = serialization_alias or alias
+            if field_info.validation_alias is None:
+                field_info.validation_alias = validation_alias or alias
+
+    @staticmethod
+    def _apply_alias_generator_to_computed_field_info(
+        alias_generator: Callable[[str], str] | AliasGenerator,
+        computed_field_info: ComputedFieldInfo,
+        computed_field_name: str,
+    ):
+        """Apply an alias_generator to alias on a ComputedFieldInfo instance if appropriate.
+
+        Args:
+            alias_generator: A callable that takes a string and returns a string, or an AliasGenerator instance.
+            computed_field_info: The ComputedFieldInfo instance to which the alias_generator is (maybe) applied.
+            computed_field_name: The name of the computed field from which to generate the alias.
+        """
+        # Apply an alias_generator if
+        # 1. An alias is not specified
+        # 2. An alias is specified, but the priority is <= 1
+
+        if (
+            computed_field_info.alias_priority is None
+            or computed_field_info.alias_priority <= 1
+            or computed_field_info.alias is None
+        ):
+            alias, validation_alias, serialization_alias = None, None, None
+
+            if isinstance(alias_generator, AliasGenerator):
+                alias, validation_alias, serialization_alias = alias_generator.generate_aliases(computed_field_name)
+            elif isinstance(alias_generator, Callable):
+                alias = alias_generator(computed_field_name)
+                if not isinstance(alias, str):
+                    raise TypeError(f'alias_generator {alias_generator} must return str, not {alias.__class__}')
+
+            # if priority is not set, we set to 1
+            # which supports the case where the alias_generator from a child class is used
+            # to generate an alias for a field in a parent class
+            if computed_field_info.alias_priority is None or computed_field_info.alias_priority <= 1:
+                computed_field_info.alias_priority = 1
+
+            # if the priority is 1, then we set the aliases to the generated alias
+            # note that we use the serialization_alias with priority over alias, as computed_field
+            # aliases are used for serialization only (not validation)
+            if computed_field_info.alias_priority == 1:
+                computed_field_info.alias = serialization_alias or alias
+
+    def _common_field_schema(  # C901
+        self, name: str, field_info: FieldInfo, decorators: DecoratorInfos
+    ) -> _CommonField:
+        # Update FieldInfo annotation if appropriate:
+        from .. import AliasChoices, AliasPath
+        from ..fields import FieldInfo
+
+        if has_instance_in_type(field_info.annotation, (ForwardRef, str)):
+            types_namespace = self._types_namespace
+            if self._typevars_map:
+                types_namespace = (types_namespace or {}).copy()
+                # Ensure that typevars get mapped to their concrete types:
+                types_namespace.update({k.__name__: v for k, v in self._typevars_map.items()})
+
+            evaluated = _typing_extra.eval_type_lenient(field_info.annotation, types_namespace)
+            if evaluated is not field_info.annotation and not has_instance_in_type(evaluated, PydanticRecursiveRef):
+                new_field_info = FieldInfo.from_annotation(evaluated)
+                field_info.annotation = new_field_info.annotation
+
+                # Handle any field info attributes that may have been obtained from now-resolved annotations
+                for k, v in new_field_info._attributes_set.items():
+                    # If an attribute is already set, it means it was set by assigning to a call to Field (or just a
+                    # default value), and that should take the highest priority. So don't overwrite existing attributes.
+                    # We skip over "attributes" that are present in the metadata_lookup dict because these won't
+                    # actually end up as attributes of the `FieldInfo` instance.
+                    if k not in field_info._attributes_set and k not in field_info.metadata_lookup:
+                        setattr(field_info, k, v)
+
+                # Finally, ensure the field info also reflects all the `_attributes_set` that are actually metadata.
+                field_info.metadata = [*new_field_info.metadata, *field_info.metadata]
+
+        source_type, annotations = field_info.annotation, field_info.metadata
+
+        def set_discriminator(schema: CoreSchema) -> CoreSchema:
+            schema = self._apply_discriminator_to_union(schema, field_info.discriminator)
+            return schema
+
+        with self.field_name_stack.push(name):
+            if field_info.discriminator is not None:
+                schema = self._apply_annotations(source_type, annotations, transform_inner_schema=set_discriminator)
+            else:
+                schema = self._apply_annotations(
+                    source_type,
+                    annotations,
+                )
+
+        # This V1 compatibility shim should eventually be removed
+        # push down any `each_item=True` validators
+        # note that this won't work for any Annotated types that get wrapped by a function validator
+        # but that's okay because that didn't exist in V1
+        this_field_validators = filter_field_decorator_info_by_field(decorators.validators.values(), name)
+        if _validators_require_validate_default(this_field_validators):
+            field_info.validate_default = True
+        each_item_validators = [v for v in this_field_validators if v.info.each_item is True]
+        this_field_validators = [v for v in this_field_validators if v not in each_item_validators]
+        schema = apply_each_item_validators(schema, each_item_validators, name)
+
+        schema = apply_validators(schema, filter_field_decorator_info_by_field(this_field_validators, name), name)
+        schema = apply_validators(
+            schema, filter_field_decorator_info_by_field(decorators.field_validators.values(), name), name
+        )
+
+        # the default validator needs to go outside of any other validators
+        # so that it is the topmost validator for the field validator
+        # which uses it to check if the field has a default value or not
+        if not field_info.is_required():
+            schema = wrap_default(field_info, schema)
+
+        schema = self._apply_field_serializers(
+            schema, filter_field_decorator_info_by_field(decorators.field_serializers.values(), name)
+        )
+        json_schema_updates = {
+            'title': field_info.title,
+            'description': field_info.description,
+            'examples': to_jsonable_python(field_info.examples),
+        }
+        json_schema_updates = {k: v for k, v in json_schema_updates.items() if v is not None}
+
+        json_schema_extra = field_info.json_schema_extra
+
+        metadata = build_metadata_dict(
+            js_annotation_functions=[get_json_schema_update_func(json_schema_updates, json_schema_extra)]
+        )
+
+        alias_generator = self._config_wrapper.alias_generator
+        if alias_generator is not None:
+            self._apply_alias_generator_to_field_info(alias_generator, field_info, name)
+
+        if isinstance(field_info.validation_alias, (AliasChoices, AliasPath)):
+            validation_alias = field_info.validation_alias.convert_to_aliases()
+        else:
+            validation_alias = field_info.validation_alias
+
+        return _common_field(
+            schema,
+            serialization_exclude=True if field_info.exclude else None,
+            validation_alias=validation_alias,
+            serialization_alias=field_info.serialization_alias,
+            frozen=field_info.frozen,
+            metadata=metadata,
+        )
+
+    def _union_schema(self, union_type: Any) -> core_schema.CoreSchema:
+        """Generate schema for a Union."""
+        args = self._get_args_resolving_forward_refs(union_type, required=True)
+        choices: list[CoreSchema] = []
+        nullable = False
+        for arg in args:
+            if arg is None or arg is _typing_extra.NoneType:
+                nullable = True
+            else:
+                choices.append(self.generate_schema(arg))
+
+        if len(choices) == 1:
+            s = choices[0]
+        else:
+            choices_with_tags: list[CoreSchema | tuple[CoreSchema, str]] = []
+            for choice in choices:
+                metadata = choice.get('metadata')
+                if isinstance(metadata, dict):
+                    tag = metadata.get(_core_utils.TAGGED_UNION_TAG_KEY)
+                    if tag is not None:
+                        choices_with_tags.append((choice, tag))
+                    else:
+                        choices_with_tags.append(choice)
+            s = core_schema.union_schema(choices_with_tags)
+
+        if nullable:
+            s = core_schema.nullable_schema(s)
+        return s
+
+    def _type_alias_type_schema(
+        self,
+        obj: Any,  # TypeAliasType
+    ) -> CoreSchema:
+        with self.defs.get_schema_or_ref(obj) as (ref, maybe_schema):
+            if maybe_schema is not None:
+                return maybe_schema
+
+            origin = get_origin(obj) or obj
+
+            annotation = origin.__value__
+            typevars_map = get_standard_typevars_map(obj)
+
+            with self._types_namespace_stack.push(origin):
+                annotation = _typing_extra.eval_type_lenient(annotation, self._types_namespace)
+                annotation = replace_types(annotation, typevars_map)
+                schema = self.generate_schema(annotation)
+                assert schema['type'] != 'definitions'
+                schema['ref'] = ref  # type: ignore
+            self.defs.definitions[ref] = schema
+            return core_schema.definition_reference_schema(ref)
+
+    def _literal_schema(self, literal_type: Any) -> CoreSchema:
+        """Generate schema for a Literal."""
+        expected = _typing_extra.all_literal_values(literal_type)
+        assert expected, f'literal "expected" cannot be empty, obj={literal_type}'
+        return core_schema.literal_schema(expected)
+
+    def _typed_dict_schema(self, typed_dict_cls: Any, origin: Any) -> core_schema.CoreSchema:
+        """Generate schema for a TypedDict.
+
+        It is not possible to track required/optional keys in TypedDict without __required_keys__
+        since TypedDict.__new__ erases the base classes (it replaces them with just `dict`)
+        and thus we can track usage of total=True/False
+        __required_keys__ was added in Python 3.9
+        (https://github.com/miss-islington/cpython/blob/1e9939657dd1f8eb9f596f77c1084d2d351172fc/Doc/library/typing.rst?plain=1#L1546-L1548)
+        however it is buggy
+        (https://github.com/python/typing_extensions/blob/ac52ac5f2cb0e00e7988bae1e2a1b8257ac88d6d/src/typing_extensions.py#L657-L666).
+
+        On 3.11 but < 3.12 TypedDict does not preserve inheritance information.
+
+        Hence to avoid creating validators that do not do what users expect we only
+        support typing.TypedDict on Python >= 3.12 or typing_extension.TypedDict on all versions
+        """
+        from ..fields import FieldInfo
+
+        with self.defs.get_schema_or_ref(typed_dict_cls) as (typed_dict_ref, maybe_schema):
+            if maybe_schema is not None:
+                return maybe_schema
+
+            typevars_map = get_standard_typevars_map(typed_dict_cls)
+            if origin is not None:
+                typed_dict_cls = origin
+
+            if not _SUPPORTS_TYPEDDICT and type(typed_dict_cls).__module__ == 'typing':
+                raise PydanticUserError(
+                    'Please use `typing_extensions.TypedDict` instead of `typing.TypedDict` on Python < 3.12.',
+                    code='typed-dict-version',
+                )
+
+            try:
+                config: ConfigDict | None = get_attribute_from_bases(typed_dict_cls, '__pydantic_config__')
+            except AttributeError:
+                config = None
+
+            with self._config_wrapper_stack.push(config), self._types_namespace_stack.push(typed_dict_cls):
+                core_config = self._config_wrapper.core_config(typed_dict_cls)
+
+                self = self._current_generate_schema
+
+                required_keys: frozenset[str] = typed_dict_cls.__required_keys__
+
+                fields: dict[str, core_schema.TypedDictField] = {}
+
+                decorators = DecoratorInfos.build(typed_dict_cls)
+
+                for field_name, annotation in get_type_hints_infer_globalns(
+                    typed_dict_cls, localns=self._types_namespace, include_extras=True
+                ).items():
+                    annotation = replace_types(annotation, typevars_map)
+                    required = field_name in required_keys
+
+                    if get_origin(annotation) == _typing_extra.Required:
+                        required = True
+                        annotation = self._get_args_resolving_forward_refs(
+                            annotation,
+                            required=True,
+                        )[0]
+                    elif get_origin(annotation) == _typing_extra.NotRequired:
+                        required = False
+                        annotation = self._get_args_resolving_forward_refs(
+                            annotation,
+                            required=True,
+                        )[0]
+
+                    field_info = FieldInfo.from_annotation(annotation)
+                    fields[field_name] = self._generate_td_field_schema(
+                        field_name, field_info, decorators, required=required
+                    )
+
+                metadata = build_metadata_dict(
+                    js_functions=[partial(modify_model_json_schema, cls=typed_dict_cls)], typed_dict_cls=typed_dict_cls
+                )
+
+                td_schema = core_schema.typed_dict_schema(
+                    fields,
+                    computed_fields=[
+                        self._computed_field_schema(d, decorators.field_serializers)
+                        for d in decorators.computed_fields.values()
+                    ],
+                    ref=typed_dict_ref,
+                    metadata=metadata,
+                    config=core_config,
+                )
+
+                schema = self._apply_model_serializers(td_schema, decorators.model_serializers.values())
+                schema = apply_model_validators(schema, decorators.model_validators.values(), 'all')
+                self.defs.definitions[typed_dict_ref] = self._post_process_generated_schema(schema)
+                return core_schema.definition_reference_schema(typed_dict_ref)
+
+    def _namedtuple_schema(self, namedtuple_cls: Any, origin: Any) -> core_schema.CoreSchema:
+        """Generate schema for a NamedTuple."""
+        with self.defs.get_schema_or_ref(namedtuple_cls) as (namedtuple_ref, maybe_schema):
+            if maybe_schema is not None:
+                return maybe_schema
+            typevars_map = get_standard_typevars_map(namedtuple_cls)
+            if origin is not None:
+                namedtuple_cls = origin
+
+            annotations: dict[str, Any] = get_type_hints_infer_globalns(
+                namedtuple_cls, include_extras=True, localns=self._types_namespace
+            )
+            if not annotations:
+                # annotations is empty, happens if namedtuple_cls defined via collections.namedtuple(...)
+                annotations = {k: Any for k in namedtuple_cls._fields}
+
+            if typevars_map:
+                annotations = {
+                    field_name: replace_types(annotation, typevars_map)
+                    for field_name, annotation in annotations.items()
+                }
+
+            arguments_schema = core_schema.arguments_schema(
+                [
+                    self._generate_parameter_schema(
+                        field_name, annotation, default=namedtuple_cls._field_defaults.get(field_name, Parameter.empty)
+                    )
+                    for field_name, annotation in annotations.items()
+                ],
+                metadata=build_metadata_dict(js_prefer_positional_arguments=True),
+            )
+            return core_schema.call_schema(arguments_schema, namedtuple_cls, ref=namedtuple_ref)
+
+    def _generate_parameter_schema(
+        self,
+        name: str,
+        annotation: type[Any],
+        default: Any = Parameter.empty,
+        mode: Literal['positional_only', 'positional_or_keyword', 'keyword_only'] | None = None,
+    ) -> core_schema.ArgumentsParameter:
+        """Prepare a ArgumentsParameter to represent a field in a namedtuple or function signature."""
+        from ..fields import FieldInfo
+
+        if default is Parameter.empty:
+            field = FieldInfo.from_annotation(annotation)
+        else:
+            field = FieldInfo.from_annotated_attribute(annotation, default)
+        assert field.annotation is not None, 'field.annotation should not be None when generating a schema'
+        source_type, annotations = field.annotation, field.metadata
+        with self.field_name_stack.push(name):
+            schema = self._apply_annotations(source_type, annotations)
+
+        if not field.is_required():
+            schema = wrap_default(field, schema)
+
+        parameter_schema = core_schema.arguments_parameter(name, schema)
+        if mode is not None:
+            parameter_schema['mode'] = mode
+        if field.alias is not None:
+            parameter_schema['alias'] = field.alias
+        else:
+            alias_generator = self._config_wrapper.alias_generator
+            if isinstance(alias_generator, AliasGenerator) and alias_generator.alias is not None:
+                parameter_schema['alias'] = alias_generator.alias(name)
+            elif isinstance(alias_generator, Callable):
+                parameter_schema['alias'] = alias_generator(name)
+        return parameter_schema
+
+    def _tuple_schema(self, tuple_type: Any) -> core_schema.CoreSchema:
+        """Generate schema for a Tuple, e.g. `tuple[int, str]` or `tuple[int, ...]`."""
+        # TODO: do we really need to resolve type vars here?
+        typevars_map = get_standard_typevars_map(tuple_type)
+        params = self._get_args_resolving_forward_refs(tuple_type)
+
+        if typevars_map and params:
+            params = tuple(replace_types(param, typevars_map) for param in params)
+
+        # NOTE: subtle difference: `tuple[()]` gives `params=()`, whereas `typing.Tuple[()]` gives `params=((),)`
+        # This is only true for <3.11, on Python 3.11+ `typing.Tuple[()]` gives `params=()`
+        if not params:
+            if tuple_type in TUPLE_TYPES:
+                return core_schema.tuple_schema([core_schema.any_schema()], variadic_item_index=0)
+            else:
+                # special case for `tuple[()]` which means `tuple[]` - an empty tuple
+                return core_schema.tuple_schema([])
+        elif params[-1] is Ellipsis:
+            if len(params) == 2:
+                return core_schema.tuple_schema([self.generate_schema(params[0])], variadic_item_index=0)
+            else:
+                # TODO: something like https://github.com/pydantic/pydantic/issues/5952
+                raise ValueError('Variable tuples can only have one type')
+        elif len(params) == 1 and params[0] == ():
+            # special case for `Tuple[()]` which means `Tuple[]` - an empty tuple
+            # NOTE: This conditional can be removed when we drop support for Python 3.10.
+            return core_schema.tuple_schema([])
+        else:
+            return core_schema.tuple_schema([self.generate_schema(param) for param in params])
+
+    def _type_schema(self) -> core_schema.CoreSchema:
+        return core_schema.custom_error_schema(
+            core_schema.is_instance_schema(type),
+            custom_error_type='is_type',
+            custom_error_message='Input should be a type',
+        )
+
+    def _union_is_subclass_schema(self, union_type: Any) -> core_schema.CoreSchema:
+        """Generate schema for `Type[Union[X, ...]]`."""
+        args = self._get_args_resolving_forward_refs(union_type, required=True)
+        return core_schema.union_schema([self.generate_schema(typing.Type[args]) for args in args])
+
+    def _subclass_schema(self, type_: Any) -> core_schema.CoreSchema:
+        """Generate schema for a Type, e.g. `Type[int]`."""
+        type_param = self._get_first_arg_or_any(type_)
+        if type_param == Any:
+            return self._type_schema()
+        elif isinstance(type_param, typing.TypeVar):
+            if type_param.__bound__:
+                if _typing_extra.origin_is_union(get_origin(type_param.__bound__)):
+                    return self._union_is_subclass_schema(type_param.__bound__)
+                return core_schema.is_subclass_schema(type_param.__bound__)
+            elif type_param.__constraints__:
+                return core_schema.union_schema(
+                    [self.generate_schema(typing.Type[c]) for c in type_param.__constraints__]
+                )
+            else:
+                return self._type_schema()
+        elif _typing_extra.origin_is_union(get_origin(type_param)):
+            return self._union_is_subclass_schema(type_param)
+        else:
+            return core_schema.is_subclass_schema(type_param)
+
+    def _sequence_schema(self, sequence_type: Any) -> core_schema.CoreSchema:
+        """Generate schema for a Sequence, e.g. `Sequence[int]`."""
+        item_type = self._get_first_arg_or_any(sequence_type)
+
+        list_schema = core_schema.list_schema(self.generate_schema(item_type))
+        python_schema = core_schema.is_instance_schema(typing.Sequence, cls_repr='Sequence')
+        if item_type != Any:
+            from ._validators import sequence_validator
+
+            python_schema = core_schema.chain_schema(
+                [python_schema, core_schema.no_info_wrap_validator_function(sequence_validator, list_schema)],
+            )
+        return core_schema.json_or_python_schema(json_schema=list_schema, python_schema=python_schema)
+
+    def _iterable_schema(self, type_: Any) -> core_schema.GeneratorSchema:
+        """Generate a schema for an `Iterable`."""
+        item_type = self._get_first_arg_or_any(type_)
+
+        return core_schema.generator_schema(self.generate_schema(item_type))
+
+    def _pattern_schema(self, pattern_type: Any) -> core_schema.CoreSchema:
+        from . import _validators
+
+        metadata = build_metadata_dict(js_functions=[lambda _1, _2: {'type': 'string', 'format': 'regex'}])
+        ser = core_schema.plain_serializer_function_ser_schema(
+            attrgetter('pattern'), when_used='json', return_schema=core_schema.str_schema()
+        )
+        if pattern_type == typing.Pattern or pattern_type == re.Pattern:
+            # bare type
+            return core_schema.no_info_plain_validator_function(
+                _validators.pattern_either_validator, serialization=ser, metadata=metadata
+            )
+
+        param = self._get_args_resolving_forward_refs(
+            pattern_type,
+            required=True,
+        )[0]
+        if param == str:
+            return core_schema.no_info_plain_validator_function(
+                _validators.pattern_str_validator, serialization=ser, metadata=metadata
+            )
+        elif param == bytes:
+            return core_schema.no_info_plain_validator_function(
+                _validators.pattern_bytes_validator, serialization=ser, metadata=metadata
+            )
+        else:
+            raise PydanticSchemaGenerationError(f'Unable to generate pydantic-core schema for {pattern_type!r}.')
+
+    def _hashable_schema(self) -> core_schema.CoreSchema:
+        return core_schema.custom_error_schema(
+            core_schema.is_instance_schema(collections.abc.Hashable),
+            custom_error_type='is_hashable',
+            custom_error_message='Input should be hashable',
+        )
+
+    def _dataclass_schema(
+        self, dataclass: type[StandardDataclass], origin: type[StandardDataclass] | None
+    ) -> core_schema.CoreSchema:
+        """Generate schema for a dataclass."""
+        with self.defs.get_schema_or_ref(dataclass) as (dataclass_ref, maybe_schema):
+            if maybe_schema is not None:
+                return maybe_schema
+
+            typevars_map = get_standard_typevars_map(dataclass)
+            if origin is not None:
+                dataclass = origin
+
+            config = getattr(dataclass, '__pydantic_config__', None)
+            with self._config_wrapper_stack.push(config), self._types_namespace_stack.push(dataclass):
+                core_config = self._config_wrapper.core_config(dataclass)
+
+                self = self._current_generate_schema
+
+                from ..dataclasses import is_pydantic_dataclass
+
+                if is_pydantic_dataclass(dataclass):
+                    fields = deepcopy(dataclass.__pydantic_fields__)
+                    if typevars_map:
+                        for field in fields.values():
+                            field.apply_typevars_map(typevars_map, self._types_namespace)
+                else:
+                    fields = collect_dataclass_fields(
+                        dataclass,
+                        self._types_namespace,
+                        typevars_map=typevars_map,
+                    )
+
+                # disallow combination of init=False on a dataclass field and extra='allow' on a dataclass
+                if config and config.get('extra') == 'allow':
+                    # disallow combination of init=False on a dataclass field and extra='allow' on a dataclass
+                    for field_name, field in fields.items():
+                        if field.init is False:
+                            raise PydanticUserError(
+                                f'Field {field_name} has `init=False` and dataclass has config setting `extra="allow"`. '
+                                f'This combination is not allowed.',
+                                code='dataclass-init-false-extra-allow',
+                            )
+
+                decorators = dataclass.__dict__.get('__pydantic_decorators__') or DecoratorInfos.build(dataclass)
+                # Move kw_only=False args to the start of the list, as this is how vanilla dataclasses work.
+                # Note that when kw_only is missing or None, it is treated as equivalent to kw_only=True
+                args = sorted(
+                    (self._generate_dc_field_schema(k, v, decorators) for k, v in fields.items()),
+                    key=lambda a: a.get('kw_only') is not False,
+                )
+                has_post_init = hasattr(dataclass, '__post_init__')
+                has_slots = hasattr(dataclass, '__slots__')
+
+                args_schema = core_schema.dataclass_args_schema(
+                    dataclass.__name__,
+                    args,
+                    computed_fields=[
+                        self._computed_field_schema(d, decorators.field_serializers)
+                        for d in decorators.computed_fields.values()
+                    ],
+                    collect_init_only=has_post_init,
+                )
+
+                inner_schema = apply_validators(args_schema, decorators.root_validators.values(), None)
+
+                model_validators = decorators.model_validators.values()
+                inner_schema = apply_model_validators(inner_schema, model_validators, 'inner')
+
+                dc_schema = core_schema.dataclass_schema(
+                    dataclass,
+                    inner_schema,
+                    post_init=has_post_init,
+                    ref=dataclass_ref,
+                    fields=[field.name for field in dataclasses.fields(dataclass)],
+                    slots=has_slots,
+                    config=core_config,
+                )
+                schema = self._apply_model_serializers(dc_schema, decorators.model_serializers.values())
+                schema = apply_model_validators(schema, model_validators, 'outer')
+                self.defs.definitions[dataclass_ref] = self._post_process_generated_schema(schema)
+                return core_schema.definition_reference_schema(dataclass_ref)
+
+    def _callable_schema(self, function: Callable[..., Any]) -> core_schema.CallSchema:
+        """Generate schema for a Callable.
+
+        TODO support functional validators once we support them in Config
+        """
+        sig = signature(function)
+
+        type_hints = _typing_extra.get_function_type_hints(function)
+
+        mode_lookup: dict[_ParameterKind, Literal['positional_only', 'positional_or_keyword', 'keyword_only']] = {
+            Parameter.POSITIONAL_ONLY: 'positional_only',
+            Parameter.POSITIONAL_OR_KEYWORD: 'positional_or_keyword',
+            Parameter.KEYWORD_ONLY: 'keyword_only',
+        }
+
+        arguments_list: list[core_schema.ArgumentsParameter] = []
+        var_args_schema: core_schema.CoreSchema | None = None
+        var_kwargs_schema: core_schema.CoreSchema | None = None
+
+        for name, p in sig.parameters.items():
+            if p.annotation is sig.empty:
+                annotation = Any
+            else:
+                annotation = type_hints[name]
+
+            parameter_mode = mode_lookup.get(p.kind)
+            if parameter_mode is not None:
+                arg_schema = self._generate_parameter_schema(name, annotation, p.default, parameter_mode)
+                arguments_list.append(arg_schema)
+            elif p.kind == Parameter.VAR_POSITIONAL:
+                var_args_schema = self.generate_schema(annotation)
+            else:
+                assert p.kind == Parameter.VAR_KEYWORD, p.kind
+                var_kwargs_schema = self.generate_schema(annotation)
+
+        return_schema: core_schema.CoreSchema | None = None
+        config_wrapper = self._config_wrapper
+        if config_wrapper.validate_return:
+            return_hint = type_hints.get('return')
+            if return_hint is not None:
+                return_schema = self.generate_schema(return_hint)
+
+        return core_schema.call_schema(
+            core_schema.arguments_schema(
+                arguments_list,
+                var_args_schema=var_args_schema,
+                var_kwargs_schema=var_kwargs_schema,
+                populate_by_name=config_wrapper.populate_by_name,
+            ),
+            function,
+            return_schema=return_schema,
+        )
+
+    def _unsubstituted_typevar_schema(self, typevar: typing.TypeVar) -> core_schema.CoreSchema:
+        assert isinstance(typevar, typing.TypeVar)
+
+        bound = typevar.__bound__
+        constraints = typevar.__constraints__
+        default = getattr(typevar, '__default__', None)
+
+        if (bound is not None) + (len(constraints) != 0) + (default is not None) > 1:
+            raise NotImplementedError(
+                'Pydantic does not support mixing more than one of TypeVar bounds, constraints and defaults'
+            )
+
+        if default is not None:
+            return self.generate_schema(default)
+        elif constraints:
+            return self._union_schema(typing.Union[constraints])  # type: ignore
+        elif bound:
+            schema = self.generate_schema(bound)
+            schema['serialization'] = core_schema.wrap_serializer_function_ser_schema(
+                lambda x, h: h(x), schema=core_schema.any_schema()
+            )
+            return schema
+        else:
+            return core_schema.any_schema()
+
+    def _computed_field_schema(
+        self,
+        d: Decorator[ComputedFieldInfo],
+        field_serializers: dict[str, Decorator[FieldSerializerDecoratorInfo]],
+    ) -> core_schema.ComputedField:
+        try:
+            return_type = _decorators.get_function_return_type(d.func, d.info.return_type, self._types_namespace)
+        except NameError as e:
+            raise PydanticUndefinedAnnotation.from_name_error(e) from e
+        if return_type is PydanticUndefined:
+            raise PydanticUserError(
+                'Computed field is missing return type annotation or specifying `return_type`'
+                ' to the `@computed_field` decorator (e.g. `@computed_field(return_type=int|str)`)',
+                code='model-field-missing-annotation',
+            )
+
+        return_type = replace_types(return_type, self._typevars_map)
+        # Create a new ComputedFieldInfo so that different type parametrizations of the same
+        # generic model's computed field can have different return types.
+        d.info = dataclasses.replace(d.info, return_type=return_type)
+        return_type_schema = self.generate_schema(return_type)
+        # Apply serializers to computed field if there exist
+        return_type_schema = self._apply_field_serializers(
+            return_type_schema,
+            filter_field_decorator_info_by_field(field_serializers.values(), d.cls_var_name),
+            computed_field=True,
+        )
+
+        alias_generator = self._config_wrapper.alias_generator
+        if alias_generator is not None:
+            self._apply_alias_generator_to_computed_field_info(
+                alias_generator=alias_generator, computed_field_info=d.info, computed_field_name=d.cls_var_name
+            )
+
+        def set_computed_field_metadata(schema: CoreSchemaOrField, handler: GetJsonSchemaHandler) -> JsonSchemaValue:
+            json_schema = handler(schema)
+
+            json_schema['readOnly'] = True
+
+            title = d.info.title
+            if title is not None:
+                json_schema['title'] = title
+
+            description = d.info.description
+            if description is not None:
+                json_schema['description'] = description
+
+            examples = d.info.examples
+            if examples is not None:
+                json_schema['examples'] = to_jsonable_python(examples)
+
+            json_schema_extra = d.info.json_schema_extra
+            if json_schema_extra is not None:
+                add_json_schema_extra(json_schema, json_schema_extra)
+
+            return json_schema
+
+        metadata = build_metadata_dict(js_annotation_functions=[set_computed_field_metadata])
+        return core_schema.computed_field(
+            d.cls_var_name, return_schema=return_type_schema, alias=d.info.alias, metadata=metadata
+        )
+
+    def _annotated_schema(self, annotated_type: Any) -> core_schema.CoreSchema:
+        """Generate schema for an Annotated type, e.g. `Annotated[int, Field(...)]` or `Annotated[int, Gt(0)]`."""
+        from ..fields import FieldInfo
+
+        source_type, *annotations = self._get_args_resolving_forward_refs(
+            annotated_type,
+            required=True,
+        )
+        schema = self._apply_annotations(source_type, annotations)
+        # put the default validator last so that TypeAdapter.get_default_value() works
+        # even if there are function validators involved
+        for annotation in annotations:
+            if isinstance(annotation, FieldInfo):
+                schema = wrap_default(annotation, schema)
+        return schema
+
+    def _get_prepare_pydantic_annotations_for_known_type(
+        self, obj: Any, annotations: tuple[Any, ...]
+    ) -> tuple[Any, list[Any]] | None:
+        from ._std_types_schema import PREPARE_METHODS
+
+        # Check for hashability
+        try:
+            hash(obj)
+        except TypeError:
+            # obj is definitely not a known type if this fails
+            return None
+
+        for gen in PREPARE_METHODS:
+            res = gen(obj, annotations, self._config_wrapper.config_dict)
+            if res is not None:
+                return res
+
+        return None
+
+    def _apply_annotations(
+        self,
+        source_type: Any,
+        annotations: list[Any],
+        transform_inner_schema: Callable[[CoreSchema], CoreSchema] = lambda x: x,
+    ) -> CoreSchema:
+        """Apply arguments from `Annotated` or from `FieldInfo` to a schema.
+
+        This gets called by `GenerateSchema._annotated_schema` but differs from it in that it does
+        not expect `source_type` to be an `Annotated` object, it expects it to be  the first argument of that
+        (in other words, `GenerateSchema._annotated_schema` just unpacks `Annotated`, this process it).
+        """
+        annotations = list(_known_annotated_metadata.expand_grouped_metadata(annotations))
+        res = self._get_prepare_pydantic_annotations_for_known_type(source_type, tuple(annotations))
+        if res is not None:
+            source_type, annotations = res
+
+        pydantic_js_annotation_functions: list[GetJsonSchemaFunction] = []
+
+        def inner_handler(obj: Any) -> CoreSchema:
+            from_property = self._generate_schema_from_property(obj, obj)
+            if from_property is None:
+                schema = self._generate_schema(obj)
+            else:
+                schema = from_property
+            metadata_js_function = _extract_get_pydantic_json_schema(obj, schema)
+            if metadata_js_function is not None:
+                metadata_schema = resolve_original_schema(schema, self.defs.definitions)
+                if metadata_schema is not None:
+                    self._add_js_function(metadata_schema, metadata_js_function)
+            return transform_inner_schema(schema)
+
+        get_inner_schema = CallbackGetCoreSchemaHandler(inner_handler, self)
+
+        for annotation in annotations:
+            if annotation is None:
+                continue
+            get_inner_schema = self._get_wrapped_inner_schema(
+                get_inner_schema, annotation, pydantic_js_annotation_functions
+            )
+
+        schema = get_inner_schema(source_type)
+        if pydantic_js_annotation_functions:
+            metadata = CoreMetadataHandler(schema).metadata
+            metadata.setdefault('pydantic_js_annotation_functions', []).extend(pydantic_js_annotation_functions)
+        return _add_custom_serialization_from_json_encoders(self._config_wrapper.json_encoders, source_type, schema)
+
+    def _apply_single_annotation(self, schema: core_schema.CoreSchema, metadata: Any) -> core_schema.CoreSchema:
+        from ..fields import FieldInfo
+
+        if isinstance(metadata, FieldInfo):
+            for field_metadata in metadata.metadata:
+                schema = self._apply_single_annotation(schema, field_metadata)
+
+            if metadata.discriminator is not None:
+                schema = self._apply_discriminator_to_union(schema, metadata.discriminator)
+            return schema
+
+        if schema['type'] == 'nullable':
+            # for nullable schemas, metadata is automatically applied to the inner schema
+            inner = schema.get('schema', core_schema.any_schema())
+            inner = self._apply_single_annotation(inner, metadata)
+            if inner:
+                schema['schema'] = inner
+            return schema
+
+        original_schema = schema
+        ref = schema.get('ref', None)
+        if ref is not None:
+            schema = schema.copy()
+            new_ref = ref + f'_{repr(metadata)}'
+            if new_ref in self.defs.definitions:
+                return self.defs.definitions[new_ref]
+            schema['ref'] = new_ref  # type: ignore
+        elif schema['type'] == 'definition-ref':
+            ref = schema['schema_ref']
+            if ref in self.defs.definitions:
+                schema = self.defs.definitions[ref].copy()
+                new_ref = ref + f'_{repr(metadata)}'
+                if new_ref in self.defs.definitions:
+                    return self.defs.definitions[new_ref]
+                schema['ref'] = new_ref  # type: ignore
+
+        maybe_updated_schema = _known_annotated_metadata.apply_known_metadata(metadata, schema.copy())
+
+        if maybe_updated_schema is not None:
+            return maybe_updated_schema
+        return original_schema
+
+    def _apply_single_annotation_json_schema(
+        self, schema: core_schema.CoreSchema, metadata: Any
+    ) -> core_schema.CoreSchema:
+        from ..fields import FieldInfo
+
+        if isinstance(metadata, FieldInfo):
+            for field_metadata in metadata.metadata:
+                schema = self._apply_single_annotation_json_schema(schema, field_metadata)
+            json_schema_update: JsonSchemaValue = {}
+            if metadata.title:
+                json_schema_update['title'] = metadata.title
+            if metadata.description:
+                json_schema_update['description'] = metadata.description
+            if metadata.examples:
+                json_schema_update['examples'] = to_jsonable_python(metadata.examples)
+
+            json_schema_extra = metadata.json_schema_extra
+            if json_schema_update or json_schema_extra:
+                CoreMetadataHandler(schema).metadata.setdefault('pydantic_js_annotation_functions', []).append(
+                    get_json_schema_update_func(json_schema_update, json_schema_extra)
+                )
+        return schema
+
+    def _get_wrapped_inner_schema(
+        self,
+        get_inner_schema: GetCoreSchemaHandler,
+        annotation: Any,
+        pydantic_js_annotation_functions: list[GetJsonSchemaFunction],
+    ) -> CallbackGetCoreSchemaHandler:
+        metadata_get_schema: GetCoreSchemaFunction = getattr(annotation, '__get_pydantic_core_schema__', None) or (
+            lambda source, handler: handler(source)
+        )
+
+        def new_handler(source: Any) -> core_schema.CoreSchema:
+            schema = metadata_get_schema(source, get_inner_schema)
+            schema = self._apply_single_annotation(schema, annotation)
+            schema = self._apply_single_annotation_json_schema(schema, annotation)
+
+            metadata_js_function = _extract_get_pydantic_json_schema(annotation, schema)
+            if metadata_js_function is not None:
+                pydantic_js_annotation_functions.append(metadata_js_function)
+            return schema
+
+        return CallbackGetCoreSchemaHandler(new_handler, self)
+
+    def _apply_field_serializers(
+        self,
+        schema: core_schema.CoreSchema,
+        serializers: list[Decorator[FieldSerializerDecoratorInfo]],
+        computed_field: bool = False,
+    ) -> core_schema.CoreSchema:
+        """Apply field serializers to a schema."""
+        if serializers:
+            schema = copy(schema)
+            if schema['type'] == 'definitions':
+                inner_schema = schema['schema']
+                schema['schema'] = self._apply_field_serializers(inner_schema, serializers)
+                return schema
+            else:
+                ref = typing.cast('str|None', schema.get('ref', None))
+                if ref is not None:
+                    schema = core_schema.definition_reference_schema(ref)
+
+            # use the last serializer to make it easy to override a serializer set on a parent model
+            serializer = serializers[-1]
+            is_field_serializer, info_arg = inspect_field_serializer(
+                serializer.func, serializer.info.mode, computed_field=computed_field
+            )
+
+            try:
+                return_type = _decorators.get_function_return_type(
+                    serializer.func, serializer.info.return_type, self._types_namespace
+                )
+            except NameError as e:
+                raise PydanticUndefinedAnnotation.from_name_error(e) from e
+
+            if return_type is PydanticUndefined:
+                return_schema = None
+            else:
+                return_schema = self.generate_schema(return_type)
+
+            if serializer.info.mode == 'wrap':
+                schema['serialization'] = core_schema.wrap_serializer_function_ser_schema(
+                    serializer.func,
+                    is_field_serializer=is_field_serializer,
+                    info_arg=info_arg,
+                    return_schema=return_schema,
+                    when_used=serializer.info.when_used,
+                )
+            else:
+                assert serializer.info.mode == 'plain'
+                schema['serialization'] = core_schema.plain_serializer_function_ser_schema(
+                    serializer.func,
+                    is_field_serializer=is_field_serializer,
+                    info_arg=info_arg,
+                    return_schema=return_schema,
+                    when_used=serializer.info.when_used,
+                )
+        return schema
+
+    def _apply_model_serializers(
+        self, schema: core_schema.CoreSchema, serializers: Iterable[Decorator[ModelSerializerDecoratorInfo]]
+    ) -> core_schema.CoreSchema:
+        """Apply model serializers to a schema."""
+        ref: str | None = schema.pop('ref', None)  # type: ignore
+        if serializers:
+            serializer = list(serializers)[-1]
+            info_arg = inspect_model_serializer(serializer.func, serializer.info.mode)
+
+            try:
+                return_type = _decorators.get_function_return_type(
+                    serializer.func, serializer.info.return_type, self._types_namespace
+                )
+            except NameError as e:
+                raise PydanticUndefinedAnnotation.from_name_error(e) from e
+            if return_type is PydanticUndefined:
+                return_schema = None
+            else:
+                return_schema = self.generate_schema(return_type)
+
+            if serializer.info.mode == 'wrap':
+                ser_schema: core_schema.SerSchema = core_schema.wrap_serializer_function_ser_schema(
+                    serializer.func,
+                    info_arg=info_arg,
+                    return_schema=return_schema,
+                    when_used=serializer.info.when_used,
+                )
+            else:
+                # plain
+                ser_schema = core_schema.plain_serializer_function_ser_schema(
+                    serializer.func,
+                    info_arg=info_arg,
+                    return_schema=return_schema,
+                    when_used=serializer.info.when_used,
+                )
+            schema['serialization'] = ser_schema
+        if ref:
+            schema['ref'] = ref  # type: ignore
+        return schema
+
+
+_VALIDATOR_F_MATCH: Mapping[
+    tuple[FieldValidatorModes, Literal['no-info', 'with-info']],
+    Callable[[Callable[..., Any], core_schema.CoreSchema, str | None], core_schema.CoreSchema],
+] = {
+    ('before', 'no-info'): lambda f, schema, _: core_schema.no_info_before_validator_function(f, schema),
+    ('after', 'no-info'): lambda f, schema, _: core_schema.no_info_after_validator_function(f, schema),
+    ('plain', 'no-info'): lambda f, _1, _2: core_schema.no_info_plain_validator_function(f),
+    ('wrap', 'no-info'): lambda f, schema, _: core_schema.no_info_wrap_validator_function(f, schema),
+    ('before', 'with-info'): lambda f, schema, field_name: core_schema.with_info_before_validator_function(
+        f, schema, field_name=field_name
+    ),
+    ('after', 'with-info'): lambda f, schema, field_name: core_schema.with_info_after_validator_function(
+        f, schema, field_name=field_name
+    ),
+    ('plain', 'with-info'): lambda f, _, field_name: core_schema.with_info_plain_validator_function(
+        f, field_name=field_name
+    ),
+    ('wrap', 'with-info'): lambda f, schema, field_name: core_schema.with_info_wrap_validator_function(
+        f, schema, field_name=field_name
+    ),
+}
+
+
+def apply_validators(
+    schema: core_schema.CoreSchema,
+    validators: Iterable[Decorator[RootValidatorDecoratorInfo]]
+    | Iterable[Decorator[ValidatorDecoratorInfo]]
+    | Iterable[Decorator[FieldValidatorDecoratorInfo]],
+    field_name: str | None,
+) -> core_schema.CoreSchema:
+    """Apply validators to a schema.
+
+    Args:
+        schema: The schema to apply validators on.
+        validators: An iterable of validators.
+        field_name: The name of the field if validators are being applied to a model field.
+
+    Returns:
+        The updated schema.
+    """
+    for validator in validators:
+        info_arg = inspect_validator(validator.func, validator.info.mode)
+        val_type = 'with-info' if info_arg else 'no-info'
+
+        schema = _VALIDATOR_F_MATCH[(validator.info.mode, val_type)](validator.func, schema, field_name)
+    return schema
+
+
+def _validators_require_validate_default(validators: Iterable[Decorator[ValidatorDecoratorInfo]]) -> bool:
+    """In v1, if any of the validators for a field had `always=True`, the default value would be validated.
+
+    This serves as an auxiliary function for re-implementing that logic, by looping over a provided
+    collection of (v1-style) ValidatorDecoratorInfo's and checking if any of them have `always=True`.
+
+    We should be able to drop this function and the associated logic calling it once we drop support
+    for v1-style validator decorators. (Or we can extend it and keep it if we add something equivalent
+    to the v1-validator `always` kwarg to `field_validator`.)
+    """
+    for validator in validators:
+        if validator.info.always:
+            return True
+    return False
+
+
+def apply_model_validators(
+    schema: core_schema.CoreSchema,
+    validators: Iterable[Decorator[ModelValidatorDecoratorInfo]],
+    mode: Literal['inner', 'outer', 'all'],
+) -> core_schema.CoreSchema:
+    """Apply model validators to a schema.
+
+    If mode == 'inner', only "before" validators are applied
+    If mode == 'outer', validators other than "before" are applied
+    If mode == 'all', all validators are applied
+
+    Args:
+        schema: The schema to apply validators on.
+        validators: An iterable of validators.
+        mode: The validator mode.
+
+    Returns:
+        The updated schema.
+    """
+    ref: str | None = schema.pop('ref', None)  # type: ignore
+    for validator in validators:
+        if mode == 'inner' and validator.info.mode != 'before':
+            continue
+        if mode == 'outer' and validator.info.mode == 'before':
+            continue
+        info_arg = inspect_validator(validator.func, validator.info.mode)
+        if validator.info.mode == 'wrap':
+            if info_arg:
+                schema = core_schema.with_info_wrap_validator_function(function=validator.func, schema=schema)
+            else:
+                schema = core_schema.no_info_wrap_validator_function(function=validator.func, schema=schema)
+        elif validator.info.mode == 'before':
+            if info_arg:
+                schema = core_schema.with_info_before_validator_function(function=validator.func, schema=schema)
+            else:
+                schema = core_schema.no_info_before_validator_function(function=validator.func, schema=schema)
+        else:
+            assert validator.info.mode == 'after'
+            if info_arg:
+                schema = core_schema.with_info_after_validator_function(function=validator.func, schema=schema)
+            else:
+                schema = core_schema.no_info_after_validator_function(function=validator.func, schema=schema)
+    if ref:
+        schema['ref'] = ref  # type: ignore
+    return schema
+
+
+def wrap_default(field_info: FieldInfo, schema: core_schema.CoreSchema) -> core_schema.CoreSchema:
+    """Wrap schema with default schema if default value or `default_factory` are available.
+
+    Args:
+        field_info: The field info object.
+        schema: The schema to apply default on.
+
+    Returns:
+        Updated schema by default value or `default_factory`.
+    """
+    if field_info.default_factory:
+        return core_schema.with_default_schema(
+            schema, default_factory=field_info.default_factory, validate_default=field_info.validate_default
+        )
+    elif field_info.default is not PydanticUndefined:
+        return core_schema.with_default_schema(
+            schema, default=field_info.default, validate_default=field_info.validate_default
+        )
+    else:
+        return schema
+
+
+def _extract_get_pydantic_json_schema(tp: Any, schema: CoreSchema) -> GetJsonSchemaFunction | None:
+    """Extract `__get_pydantic_json_schema__` from a type, handling the deprecated `__modify_schema__`."""
+    js_modify_function = getattr(tp, '__get_pydantic_json_schema__', None)
+
+    if hasattr(tp, '__modify_schema__'):
+        from pydantic import BaseModel  # circular reference
+
+        has_custom_v2_modify_js_func = (
+            js_modify_function is not None
+            and BaseModel.__get_pydantic_json_schema__.__func__  # type: ignore
+            not in (js_modify_function, getattr(js_modify_function, '__func__', None))
+        )
+
+        if not has_custom_v2_modify_js_func:
+            raise PydanticUserError(
+                'The `__modify_schema__` method is not supported in Pydantic v2. '
+                'Use `__get_pydantic_json_schema__` instead.',
+                code='custom-json-schema',
+            )
+
+    # handle GenericAlias' but ignore Annotated which "lies" about its origin (in this case it would be `int`)
+    if hasattr(tp, '__origin__') and not isinstance(tp, type(Annotated[int, 'placeholder'])):
+        return _extract_get_pydantic_json_schema(tp.__origin__, schema)
+
+    if js_modify_function is None:
+        return None
+
+    return js_modify_function
+
+
+def get_json_schema_update_func(
+    json_schema_update: JsonSchemaValue, json_schema_extra: JsonDict | typing.Callable[[JsonDict], None] | None
+) -> GetJsonSchemaFunction:
+    def json_schema_update_func(
+        core_schema_or_field: CoreSchemaOrField, handler: GetJsonSchemaHandler
+    ) -> JsonSchemaValue:
+        json_schema = {**handler(core_schema_or_field), **json_schema_update}
+        add_json_schema_extra(json_schema, json_schema_extra)
+        return json_schema
+
+    return json_schema_update_func
+
+
+def add_json_schema_extra(
+    json_schema: JsonSchemaValue, json_schema_extra: JsonDict | typing.Callable[[JsonDict], None] | None
+):
+    if isinstance(json_schema_extra, dict):
+        json_schema.update(to_jsonable_python(json_schema_extra))
+    elif callable(json_schema_extra):
+        json_schema_extra(json_schema)
+
+
+class _CommonField(TypedDict):
+    schema: core_schema.CoreSchema
+    validation_alias: str | list[str | int] | list[list[str | int]] | None
+    serialization_alias: str | None
+    serialization_exclude: bool | None
+    frozen: bool | None
+    metadata: dict[str, Any]
+
+
+def _common_field(
+    schema: core_schema.CoreSchema,
+    *,
+    validation_alias: str | list[str | int] | list[list[str | int]] | None = None,
+    serialization_alias: str | None = None,
+    serialization_exclude: bool | None = None,
+    frozen: bool | None = None,
+    metadata: Any = None,
+) -> _CommonField:
+    return {
+        'schema': schema,
+        'validation_alias': validation_alias,
+        'serialization_alias': serialization_alias,
+        'serialization_exclude': serialization_exclude,
+        'frozen': frozen,
+        'metadata': metadata,
+    }
+
+
+class _Definitions:
+    """Keeps track of references and definitions."""
+
+    def __init__(self) -> None:
+        self.seen: set[str] = set()
+        self.definitions: dict[str, core_schema.CoreSchema] = {}
+
+    @contextmanager
+    def get_schema_or_ref(self, tp: Any) -> Iterator[tuple[str, None] | tuple[str, CoreSchema]]:
+        """Get a definition for `tp` if one exists.
+
+        If a definition exists, a tuple of `(ref_string, CoreSchema)` is returned.
+        If no definition exists yet, a tuple of `(ref_string, None)` is returned.
+
+        Note that the returned `CoreSchema` will always be a `DefinitionReferenceSchema`,
+        not the actual definition itself.
+
+        This should be called for any type that can be identified by reference.
+        This includes any recursive types.
+
+        At present the following types can be named/recursive:
+
+        - BaseModel
+        - Dataclasses
+        - TypedDict
+        - TypeAliasType
+        """
+        ref = get_type_ref(tp)
+        # return the reference if we're either (1) in a cycle or (2) it was already defined
+        if ref in self.seen or ref in self.definitions:
+            yield (ref, core_schema.definition_reference_schema(ref))
+        else:
+            self.seen.add(ref)
+            try:
+                yield (ref, None)
+            finally:
+                self.seen.discard(ref)
+
+
+def resolve_original_schema(schema: CoreSchema, definitions: dict[str, CoreSchema]) -> CoreSchema | None:
+    if schema['type'] == 'definition-ref':
+        return definitions.get(schema['schema_ref'], None)
+    elif schema['type'] == 'definitions':
+        return schema['schema']
+    else:
+        return schema
+
+
+class _FieldNameStack:
+    __slots__ = ('_stack',)
+
+    def __init__(self) -> None:
+        self._stack: list[str] = []
+
+    @contextmanager
+    def push(self, field_name: str) -> Iterator[None]:
+        self._stack.append(field_name)
+        yield
+        self._stack.pop()
+
+    def get(self) -> str | None:
+        if self._stack:
+            return self._stack[-1]
+        else:
+            return None
diff --git a/lib/pydantic/_internal/_generics.py b/lib/pydantic/_internal/_generics.py
new file mode 100644
index 00000000..5a66eaa9
--- /dev/null
+++ b/lib/pydantic/_internal/_generics.py
@@ -0,0 +1,517 @@
+from __future__ import annotations
+
+import sys
+import types
+import typing
+from collections import ChainMap
+from contextlib import contextmanager
+from contextvars import ContextVar
+from types import prepare_class
+from typing import TYPE_CHECKING, Any, Iterator, List, Mapping, MutableMapping, Tuple, TypeVar
+from weakref import WeakValueDictionary
+
+import typing_extensions
+
+from ._core_utils import get_type_ref
+from ._forward_ref import PydanticRecursiveRef
+from ._typing_extra import TypeVarType, typing_base
+from ._utils import all_identical, is_model_class
+
+if sys.version_info >= (3, 10):
+    from typing import _UnionGenericAlias  # type: ignore[attr-defined]
+
+if TYPE_CHECKING:
+    from ..main import BaseModel
+
+GenericTypesCacheKey = Tuple[Any, Any, Tuple[Any, ...]]
+
+# Note: We want to remove LimitedDict, but to do this, we'd need to improve the handling of generics caching.
+#   Right now, to handle recursive generics, we some types must remain cached for brief periods without references.
+#   By chaining the WeakValuesDict with a LimitedDict, we have a way to retain caching for all types with references,
+#   while also retaining a limited number of types even without references. This is generally enough to build
+#   specific recursive generic models without losing required items out of the cache.
+
+KT = TypeVar('KT')
+VT = TypeVar('VT')
+_LIMITED_DICT_SIZE = 100
+if TYPE_CHECKING:
+
+    class LimitedDict(dict, MutableMapping[KT, VT]):
+        def __init__(self, size_limit: int = _LIMITED_DICT_SIZE):
+            ...
+
+else:
+
+    class LimitedDict(dict):
+        """Limit the size/length of a dict used for caching to avoid unlimited increase in memory usage.
+
+        Since the dict is ordered, and we always remove elements from the beginning, this is effectively a FIFO cache.
+        """
+
+        def __init__(self, size_limit: int = _LIMITED_DICT_SIZE):
+            self.size_limit = size_limit
+            super().__init__()
+
+        def __setitem__(self, __key: Any, __value: Any) -> None:
+            super().__setitem__(__key, __value)
+            if len(self) > self.size_limit:
+                excess = len(self) - self.size_limit + self.size_limit // 10
+                to_remove = list(self.keys())[:excess]
+                for key in to_remove:
+                    del self[key]
+
+
+# weak dictionaries allow the dynamically created parametrized versions of generic models to get collected
+# once they are no longer referenced by the caller.
+if sys.version_info >= (3, 9):  # Typing for weak dictionaries available at 3.9
+    GenericTypesCache = WeakValueDictionary[GenericTypesCacheKey, 'type[BaseModel]']
+else:
+    GenericTypesCache = WeakValueDictionary
+
+if TYPE_CHECKING:
+
+    class DeepChainMap(ChainMap[KT, VT]):  # type: ignore
+        ...
+
+else:
+
+    class DeepChainMap(ChainMap):
+        """Variant of ChainMap that allows direct updates to inner scopes.
+
+        Taken from https://docs.python.org/3/library/collections.html#collections.ChainMap,
+        with some light modifications for this use case.
+        """
+
+        def clear(self) -> None:
+            for mapping in self.maps:
+                mapping.clear()
+
+        def __setitem__(self, key: KT, value: VT) -> None:
+            for mapping in self.maps:
+                mapping[key] = value
+
+        def __delitem__(self, key: KT) -> None:
+            hit = False
+            for mapping in self.maps:
+                if key in mapping:
+                    del mapping[key]
+                    hit = True
+            if not hit:
+                raise KeyError(key)
+
+
+# Despite the fact that LimitedDict _seems_ no longer necessary, I'm very nervous to actually remove it
+# and discover later on that we need to re-add all this infrastructure...
+# _GENERIC_TYPES_CACHE = DeepChainMap(GenericTypesCache(), LimitedDict())
+
+_GENERIC_TYPES_CACHE = GenericTypesCache()
+
+
+class PydanticGenericMetadata(typing_extensions.TypedDict):
+    origin: type[BaseModel] | None  # analogous to typing._GenericAlias.__origin__
+    args: tuple[Any, ...]  # analogous to typing._GenericAlias.__args__
+    parameters: tuple[type[Any], ...]  # analogous to typing.Generic.__parameters__
+
+
+def create_generic_submodel(
+    model_name: str, origin: type[BaseModel], args: tuple[Any, ...], params: tuple[Any, ...]
+) -> type[BaseModel]:
+    """Dynamically create a submodel of a provided (generic) BaseModel.
+
+    This is used when producing concrete parametrizations of generic models. This function
+    only *creates* the new subclass; the schema/validators/serialization must be updated to
+    reflect a concrete parametrization elsewhere.
+
+    Args:
+        model_name: The name of the newly created model.
+        origin: The base class for the new model to inherit from.
+        args: A tuple of generic metadata arguments.
+        params: A tuple of generic metadata parameters.
+
+    Returns:
+        The created submodel.
+    """
+    namespace: dict[str, Any] = {'__module__': origin.__module__}
+    bases = (origin,)
+    meta, ns, kwds = prepare_class(model_name, bases)
+    namespace.update(ns)
+    created_model = meta(
+        model_name,
+        bases,
+        namespace,
+        __pydantic_generic_metadata__={
+            'origin': origin,
+            'args': args,
+            'parameters': params,
+        },
+        __pydantic_reset_parent_namespace__=False,
+        **kwds,
+    )
+
+    model_module, called_globally = _get_caller_frame_info(depth=3)
+    if called_globally:  # create global reference and therefore allow pickling
+        object_by_reference = None
+        reference_name = model_name
+        reference_module_globals = sys.modules[created_model.__module__].__dict__
+        while object_by_reference is not created_model:
+            object_by_reference = reference_module_globals.setdefault(reference_name, created_model)
+            reference_name += '_'
+
+    return created_model
+
+
+def _get_caller_frame_info(depth: int = 2) -> tuple[str | None, bool]:
+    """Used inside a function to check whether it was called globally.
+
+    Args:
+        depth: The depth to get the frame.
+
+    Returns:
+        A tuple contains `module_name` and `called_globally`.
+
+    Raises:
+        RuntimeError: If the function is not called inside a function.
+    """
+    try:
+        previous_caller_frame = sys._getframe(depth)
+    except ValueError as e:
+        raise RuntimeError('This function must be used inside another function') from e
+    except AttributeError:  # sys module does not have _getframe function, so there's nothing we can do about it
+        return None, False
+    frame_globals = previous_caller_frame.f_globals
+    return frame_globals.get('__name__'), previous_caller_frame.f_locals is frame_globals
+
+
+DictValues: type[Any] = {}.values().__class__
+
+
+def iter_contained_typevars(v: Any) -> Iterator[TypeVarType]:
+    """Recursively iterate through all subtypes and type args of `v` and yield any typevars that are found.
+
+    This is inspired as an alternative to directly accessing the `__parameters__` attribute of a GenericAlias,
+    since __parameters__ of (nested) generic BaseModel subclasses won't show up in that list.
+    """
+    if isinstance(v, TypeVar):
+        yield v
+    elif is_model_class(v):
+        yield from v.__pydantic_generic_metadata__['parameters']
+    elif isinstance(v, (DictValues, list)):
+        for var in v:
+            yield from iter_contained_typevars(var)
+    else:
+        args = get_args(v)
+        for arg in args:
+            yield from iter_contained_typevars(arg)
+
+
+def get_args(v: Any) -> Any:
+    pydantic_generic_metadata: PydanticGenericMetadata | None = getattr(v, '__pydantic_generic_metadata__', None)
+    if pydantic_generic_metadata:
+        return pydantic_generic_metadata.get('args')
+    return typing_extensions.get_args(v)
+
+
+def get_origin(v: Any) -> Any:
+    pydantic_generic_metadata: PydanticGenericMetadata | None = getattr(v, '__pydantic_generic_metadata__', None)
+    if pydantic_generic_metadata:
+        return pydantic_generic_metadata.get('origin')
+    return typing_extensions.get_origin(v)
+
+
+def get_standard_typevars_map(cls: type[Any]) -> dict[TypeVarType, Any] | None:
+    """Package a generic type's typevars and parametrization (if present) into a dictionary compatible with the
+    `replace_types` function. Specifically, this works with standard typing generics and typing._GenericAlias.
+    """
+    origin = get_origin(cls)
+    if origin is None:
+        return None
+    if not hasattr(origin, '__parameters__'):
+        return None
+
+    # In this case, we know that cls is a _GenericAlias, and origin is the generic type
+    # So it is safe to access cls.__args__ and origin.__parameters__
+    args: tuple[Any, ...] = cls.__args__  # type: ignore
+    parameters: tuple[TypeVarType, ...] = origin.__parameters__
+    return dict(zip(parameters, args))
+
+
+def get_model_typevars_map(cls: type[BaseModel]) -> dict[TypeVarType, Any] | None:
+    """Package a generic BaseModel's typevars and concrete parametrization (if present) into a dictionary compatible
+    with the `replace_types` function.
+
+    Since BaseModel.__class_getitem__ does not produce a typing._GenericAlias, and the BaseModel generic info is
+    stored in the __pydantic_generic_metadata__ attribute, we need special handling here.
+    """
+    # TODO: This could be unified with `get_standard_typevars_map` if we stored the generic metadata
+    #   in the __origin__, __args__, and __parameters__ attributes of the model.
+    generic_metadata = cls.__pydantic_generic_metadata__
+    origin = generic_metadata['origin']
+    args = generic_metadata['args']
+    return dict(zip(iter_contained_typevars(origin), args))
+
+
+def replace_types(type_: Any, type_map: Mapping[Any, Any] | None) -> Any:
+    """Return type with all occurrences of `type_map` keys recursively replaced with their values.
+
+    Args:
+        type_: The class or generic alias.
+        type_map: Mapping from `TypeVar` instance to concrete types.
+
+    Returns:
+        A new type representing the basic structure of `type_` with all
+        `typevar_map` keys recursively replaced.
+
+    Example:
+        ```py
+        from typing import List, Tuple, Union
+
+        from pydantic._internal._generics import replace_types
+
+        replace_types(Tuple[str, Union[List[str], float]], {str: int})
+        #> Tuple[int, Union[List[int], float]]
+        ```
+    """
+    if not type_map:
+        return type_
+
+    type_args = get_args(type_)
+    origin_type = get_origin(type_)
+
+    if origin_type is typing_extensions.Annotated:
+        annotated_type, *annotations = type_args
+        annotated = replace_types(annotated_type, type_map)
+        for annotation in annotations:
+            annotated = typing_extensions.Annotated[annotated, annotation]
+        return annotated
+
+    # Having type args is a good indicator that this is a typing module
+    # class instantiation or a generic alias of some sort.
+    if type_args:
+        resolved_type_args = tuple(replace_types(arg, type_map) for arg in type_args)
+        if all_identical(type_args, resolved_type_args):
+            # If all arguments are the same, there is no need to modify the
+            # type or create a new object at all
+            return type_
+        if (
+            origin_type is not None
+            and isinstance(type_, typing_base)
+            and not isinstance(origin_type, typing_base)
+            and getattr(type_, '_name', None) is not None
+        ):
+            # In python < 3.9 generic aliases don't exist so any of these like `list`,
+            # `type` or `collections.abc.Callable` need to be translated.
+            # See: https://www.python.org/dev/peps/pep-0585
+            origin_type = getattr(typing, type_._name)
+        assert origin_type is not None
+        # PEP-604 syntax (Ex.: list | str) is represented with a types.UnionType object that does not have __getitem__.
+        # We also cannot use isinstance() since we have to compare types.
+        if sys.version_info >= (3, 10) and origin_type is types.UnionType:
+            return _UnionGenericAlias(origin_type, resolved_type_args)
+        # NotRequired[T] and Required[T] don't support tuple type resolved_type_args, hence the condition below
+        return origin_type[resolved_type_args[0] if len(resolved_type_args) == 1 else resolved_type_args]
+
+    # We handle pydantic generic models separately as they don't have the same
+    # semantics as "typing" classes or generic aliases
+
+    if not origin_type and is_model_class(type_):
+        parameters = type_.__pydantic_generic_metadata__['parameters']
+        if not parameters:
+            return type_
+        resolved_type_args = tuple(replace_types(t, type_map) for t in parameters)
+        if all_identical(parameters, resolved_type_args):
+            return type_
+        return type_[resolved_type_args]
+
+    # Handle special case for typehints that can have lists as arguments.
+    # `typing.Callable[[int, str], int]` is an example for this.
+    if isinstance(type_, (List, list)):
+        resolved_list = list(replace_types(element, type_map) for element in type_)
+        if all_identical(type_, resolved_list):
+            return type_
+        return resolved_list
+
+    # If all else fails, we try to resolve the type directly and otherwise just
+    # return the input with no modifications.
+    return type_map.get(type_, type_)
+
+
+def has_instance_in_type(type_: Any, isinstance_target: Any) -> bool:
+    """Checks if the type, or any of its arbitrary nested args, satisfy
+    `isinstance(<type>, isinstance_target)`.
+    """
+    if isinstance(type_, isinstance_target):
+        return True
+
+    type_args = get_args(type_)
+    origin_type = get_origin(type_)
+
+    if origin_type is typing_extensions.Annotated:
+        annotated_type, *annotations = type_args
+        return has_instance_in_type(annotated_type, isinstance_target)
+
+    # Having type args is a good indicator that this is a typing module
+    # class instantiation or a generic alias of some sort.
+    if any(has_instance_in_type(a, isinstance_target) for a in type_args):
+        return True
+
+    # Handle special case for typehints that can have lists as arguments.
+    # `typing.Callable[[int, str], int]` is an example for this.
+    if isinstance(type_, (List, list)) and not isinstance(type_, typing_extensions.ParamSpec):
+        if any(has_instance_in_type(element, isinstance_target) for element in type_):
+            return True
+
+    return False
+
+
+def check_parameters_count(cls: type[BaseModel], parameters: tuple[Any, ...]) -> None:
+    """Check the generic model parameters count is equal.
+
+    Args:
+        cls: The generic model.
+        parameters: A tuple of passed parameters to the generic model.
+
+    Raises:
+        TypeError: If the passed parameters count is not equal to generic model parameters count.
+    """
+    actual = len(parameters)
+    expected = len(cls.__pydantic_generic_metadata__['parameters'])
+    if actual != expected:
+        description = 'many' if actual > expected else 'few'
+        raise TypeError(f'Too {description} parameters for {cls}; actual {actual}, expected {expected}')
+
+
+_generic_recursion_cache: ContextVar[set[str] | None] = ContextVar('_generic_recursion_cache', default=None)
+
+
+@contextmanager
+def generic_recursion_self_type(
+    origin: type[BaseModel], args: tuple[Any, ...]
+) -> Iterator[PydanticRecursiveRef | None]:
+    """This contextmanager should be placed around the recursive calls used to build a generic type,
+    and accept as arguments the generic origin type and the type arguments being passed to it.
+
+    If the same origin and arguments are observed twice, it implies that a self-reference placeholder
+    can be used while building the core schema, and will produce a schema_ref that will be valid in the
+    final parent schema.
+    """
+    previously_seen_type_refs = _generic_recursion_cache.get()
+    if previously_seen_type_refs is None:
+        previously_seen_type_refs = set()
+        token = _generic_recursion_cache.set(previously_seen_type_refs)
+    else:
+        token = None
+
+    try:
+        type_ref = get_type_ref(origin, args_override=args)
+        if type_ref in previously_seen_type_refs:
+            self_type = PydanticRecursiveRef(type_ref=type_ref)
+            yield self_type
+        else:
+            previously_seen_type_refs.add(type_ref)
+            yield None
+    finally:
+        if token:
+            _generic_recursion_cache.reset(token)
+
+
+def recursively_defined_type_refs() -> set[str]:
+    visited = _generic_recursion_cache.get()
+    if not visited:
+        return set()  # not in a generic recursion, so there are no types
+
+    return visited.copy()  # don't allow modifications
+
+
+def get_cached_generic_type_early(parent: type[BaseModel], typevar_values: Any) -> type[BaseModel] | None:
+    """The use of a two-stage cache lookup approach was necessary to have the highest performance possible for
+    repeated calls to `__class_getitem__` on generic types (which may happen in tighter loops during runtime),
+    while still ensuring that certain alternative parametrizations ultimately resolve to the same type.
+
+    As a concrete example, this approach was necessary to make Model[List[T]][int] equal to Model[List[int]].
+    The approach could be modified to not use two different cache keys at different points, but the
+    _early_cache_key is optimized to be as quick to compute as possible (for repeated-access speed), and the
+    _late_cache_key is optimized to be as "correct" as possible, so that two types that will ultimately be the
+    same after resolving the type arguments will always produce cache hits.
+
+    If we wanted to move to only using a single cache key per type, we would either need to always use the
+    slower/more computationally intensive logic associated with _late_cache_key, or would need to accept
+    that Model[List[T]][int] is a different type than Model[List[T]][int]. Because we rely on subclass relationships
+    during validation, I think it is worthwhile to ensure that types that are functionally equivalent are actually
+    equal.
+    """
+    return _GENERIC_TYPES_CACHE.get(_early_cache_key(parent, typevar_values))
+
+
+def get_cached_generic_type_late(
+    parent: type[BaseModel], typevar_values: Any, origin: type[BaseModel], args: tuple[Any, ...]
+) -> type[BaseModel] | None:
+    """See the docstring of `get_cached_generic_type_early` for more information about the two-stage cache lookup."""
+    cached = _GENERIC_TYPES_CACHE.get(_late_cache_key(origin, args, typevar_values))
+    if cached is not None:
+        set_cached_generic_type(parent, typevar_values, cached, origin, args)
+    return cached
+
+
+def set_cached_generic_type(
+    parent: type[BaseModel],
+    typevar_values: tuple[Any, ...],
+    type_: type[BaseModel],
+    origin: type[BaseModel] | None = None,
+    args: tuple[Any, ...] | None = None,
+) -> None:
+    """See the docstring of `get_cached_generic_type_early` for more information about why items are cached with
+    two different keys.
+    """
+    _GENERIC_TYPES_CACHE[_early_cache_key(parent, typevar_values)] = type_
+    if len(typevar_values) == 1:
+        _GENERIC_TYPES_CACHE[_early_cache_key(parent, typevar_values[0])] = type_
+    if origin and args:
+        _GENERIC_TYPES_CACHE[_late_cache_key(origin, args, typevar_values)] = type_
+
+
+def _union_orderings_key(typevar_values: Any) -> Any:
+    """This is intended to help differentiate between Union types with the same arguments in different order.
+
+    Thanks to caching internal to the `typing` module, it is not possible to distinguish between
+    List[Union[int, float]] and List[Union[float, int]] (and similarly for other "parent" origins besides List)
+    because `typing` considers Union[int, float] to be equal to Union[float, int].
+
+    However, you _can_ distinguish between (top-level) Union[int, float] vs. Union[float, int].
+    Because we parse items as the first Union type that is successful, we get slightly more consistent behavior
+    if we make an effort to distinguish the ordering of items in a union. It would be best if we could _always_
+    get the exact-correct order of items in the union, but that would require a change to the `typing` module itself.
+    (See https://github.com/python/cpython/issues/86483 for reference.)
+    """
+    if isinstance(typevar_values, tuple):
+        args_data = []
+        for value in typevar_values:
+            args_data.append(_union_orderings_key(value))
+        return tuple(args_data)
+    elif typing_extensions.get_origin(typevar_values) is typing.Union:
+        return get_args(typevar_values)
+    else:
+        return ()
+
+
+def _early_cache_key(cls: type[BaseModel], typevar_values: Any) -> GenericTypesCacheKey:
+    """This is intended for minimal computational overhead during lookups of cached types.
+
+    Note that this is overly simplistic, and it's possible that two different cls/typevar_values
+    inputs would ultimately result in the same type being created in BaseModel.__class_getitem__.
+    To handle this, we have a fallback _late_cache_key that is checked later if the _early_cache_key
+    lookup fails, and should result in a cache hit _precisely_ when the inputs to __class_getitem__
+    would result in the same type.
+    """
+    return cls, typevar_values, _union_orderings_key(typevar_values)
+
+
+def _late_cache_key(origin: type[BaseModel], args: tuple[Any, ...], typevar_values: Any) -> GenericTypesCacheKey:
+    """This is intended for use later in the process of creating a new type, when we have more information
+    about the exact args that will be passed. If it turns out that a different set of inputs to
+    __class_getitem__ resulted in the same inputs to the generic type creation process, we can still
+    return the cached type, and update the cache with the _early_cache_key as well.
+    """
+    # The _union_orderings_key is placed at the start here to ensure there cannot be a collision with an
+    # _early_cache_key, as that function will always produce a BaseModel subclass as the first item in the key,
+    # whereas this function will always produce a tuple as the first item in the key.
+    return _union_orderings_key(typevar_values), origin, args
diff --git a/lib/pydantic/_internal/_git.py b/lib/pydantic/_internal/_git.py
new file mode 100644
index 00000000..9de7aaf9
--- /dev/null
+++ b/lib/pydantic/_internal/_git.py
@@ -0,0 +1,26 @@
+"""Git utilities, adopted from mypy's git utilities (https://github.com/python/mypy/blob/master/mypy/git.py)."""
+from __future__ import annotations
+
+import os
+import subprocess
+
+
+def is_git_repo(dir: str) -> bool:
+    """Is the given directory version-controlled with git?"""
+    return os.path.exists(os.path.join(dir, '.git'))
+
+
+def have_git() -> bool:
+    """Can we run the git executable?"""
+    try:
+        subprocess.check_output(['git', '--help'])
+        return True
+    except subprocess.CalledProcessError:
+        return False
+    except OSError:
+        return False
+
+
+def git_revision(dir: str) -> str:
+    """Get the SHA-1 of the HEAD of a git repository."""
+    return subprocess.check_output(['git', 'rev-parse', '--short', 'HEAD'], cwd=dir).decode('utf-8').strip()
diff --git a/lib/pydantic/_internal/_internal_dataclass.py b/lib/pydantic/_internal/_internal_dataclass.py
new file mode 100644
index 00000000..317a3d9c
--- /dev/null
+++ b/lib/pydantic/_internal/_internal_dataclass.py
@@ -0,0 +1,10 @@
+import sys
+from typing import Any, Dict
+
+dataclass_kwargs: Dict[str, Any]
+
+# `slots` is available on Python >= 3.10
+if sys.version_info >= (3, 10):
+    slots_true = {'slots': True}
+else:
+    slots_true = {}
diff --git a/lib/pydantic/_internal/_known_annotated_metadata.py b/lib/pydantic/_internal/_known_annotated_metadata.py
new file mode 100644
index 00000000..77caf705
--- /dev/null
+++ b/lib/pydantic/_internal/_known_annotated_metadata.py
@@ -0,0 +1,410 @@
+from __future__ import annotations
+
+from collections import defaultdict
+from copy import copy
+from functools import partial
+from typing import TYPE_CHECKING, Any, Callable, Iterable
+
+from pydantic_core import CoreSchema, PydanticCustomError, to_jsonable_python
+from pydantic_core import core_schema as cs
+
+from ._fields import PydanticMetadata
+
+if TYPE_CHECKING:
+    from ..annotated_handlers import GetJsonSchemaHandler
+
+
+STRICT = {'strict'}
+SEQUENCE_CONSTRAINTS = {'min_length', 'max_length'}
+INEQUALITY = {'le', 'ge', 'lt', 'gt'}
+NUMERIC_CONSTRAINTS = {'multiple_of', 'allow_inf_nan', *INEQUALITY}
+
+STR_CONSTRAINTS = {*SEQUENCE_CONSTRAINTS, *STRICT, 'strip_whitespace', 'to_lower', 'to_upper', 'pattern'}
+BYTES_CONSTRAINTS = {*SEQUENCE_CONSTRAINTS, *STRICT}
+
+LIST_CONSTRAINTS = {*SEQUENCE_CONSTRAINTS, *STRICT}
+TUPLE_CONSTRAINTS = {*SEQUENCE_CONSTRAINTS, *STRICT}
+SET_CONSTRAINTS = {*SEQUENCE_CONSTRAINTS, *STRICT}
+DICT_CONSTRAINTS = {*SEQUENCE_CONSTRAINTS, *STRICT}
+GENERATOR_CONSTRAINTS = {*SEQUENCE_CONSTRAINTS, *STRICT}
+
+FLOAT_CONSTRAINTS = {*NUMERIC_CONSTRAINTS, *STRICT}
+INT_CONSTRAINTS = {*NUMERIC_CONSTRAINTS, *STRICT}
+BOOL_CONSTRAINTS = STRICT
+UUID_CONSTRAINTS = STRICT
+
+DATE_TIME_CONSTRAINTS = {*NUMERIC_CONSTRAINTS, *STRICT}
+TIMEDELTA_CONSTRAINTS = {*NUMERIC_CONSTRAINTS, *STRICT}
+TIME_CONSTRAINTS = {*NUMERIC_CONSTRAINTS, *STRICT}
+LAX_OR_STRICT_CONSTRAINTS = STRICT
+
+UNION_CONSTRAINTS = {'union_mode'}
+URL_CONSTRAINTS = {
+    'max_length',
+    'allowed_schemes',
+    'host_required',
+    'default_host',
+    'default_port',
+    'default_path',
+}
+
+TEXT_SCHEMA_TYPES = ('str', 'bytes', 'url', 'multi-host-url')
+SEQUENCE_SCHEMA_TYPES = ('list', 'tuple', 'set', 'frozenset', 'generator', *TEXT_SCHEMA_TYPES)
+NUMERIC_SCHEMA_TYPES = ('float', 'int', 'date', 'time', 'timedelta', 'datetime')
+
+CONSTRAINTS_TO_ALLOWED_SCHEMAS: dict[str, set[str]] = defaultdict(set)
+for constraint in STR_CONSTRAINTS:
+    CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(TEXT_SCHEMA_TYPES)
+for constraint in BYTES_CONSTRAINTS:
+    CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('bytes',))
+for constraint in LIST_CONSTRAINTS:
+    CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('list',))
+for constraint in TUPLE_CONSTRAINTS:
+    CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('tuple',))
+for constraint in SET_CONSTRAINTS:
+    CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('set', 'frozenset'))
+for constraint in DICT_CONSTRAINTS:
+    CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('dict',))
+for constraint in GENERATOR_CONSTRAINTS:
+    CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('generator',))
+for constraint in FLOAT_CONSTRAINTS:
+    CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('float',))
+for constraint in INT_CONSTRAINTS:
+    CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('int',))
+for constraint in DATE_TIME_CONSTRAINTS:
+    CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('date', 'time', 'datetime'))
+for constraint in TIMEDELTA_CONSTRAINTS:
+    CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('timedelta',))
+for constraint in TIME_CONSTRAINTS:
+    CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('time',))
+for schema_type in (*TEXT_SCHEMA_TYPES, *SEQUENCE_SCHEMA_TYPES, *NUMERIC_SCHEMA_TYPES, 'typed-dict', 'model'):
+    CONSTRAINTS_TO_ALLOWED_SCHEMAS['strict'].add(schema_type)
+for constraint in UNION_CONSTRAINTS:
+    CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('union',))
+for constraint in URL_CONSTRAINTS:
+    CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('url', 'multi-host-url'))
+for constraint in BOOL_CONSTRAINTS:
+    CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('bool',))
+for constraint in UUID_CONSTRAINTS:
+    CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('uuid',))
+for constraint in LAX_OR_STRICT_CONSTRAINTS:
+    CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint].update(('lax-or-strict',))
+
+
+def add_js_update_schema(s: cs.CoreSchema, f: Callable[[], dict[str, Any]]) -> None:
+    def update_js_schema(s: cs.CoreSchema, handler: GetJsonSchemaHandler) -> dict[str, Any]:
+        js_schema = handler(s)
+        js_schema.update(f())
+        return js_schema
+
+    if 'metadata' in s:
+        metadata = s['metadata']
+        if 'pydantic_js_functions' in s:
+            metadata['pydantic_js_functions'].append(update_js_schema)
+        else:
+            metadata['pydantic_js_functions'] = [update_js_schema]
+    else:
+        s['metadata'] = {'pydantic_js_functions': [update_js_schema]}
+
+
+def as_jsonable_value(v: Any) -> Any:
+    if type(v) not in (int, str, float, bytes, bool, type(None)):
+        return to_jsonable_python(v)
+    return v
+
+
+def expand_grouped_metadata(annotations: Iterable[Any]) -> Iterable[Any]:
+    """Expand the annotations.
+
+    Args:
+        annotations: An iterable of annotations.
+
+    Returns:
+        An iterable of expanded annotations.
+
+    Example:
+        ```py
+        from annotated_types import Ge, Len
+
+        from pydantic._internal._known_annotated_metadata import expand_grouped_metadata
+
+        print(list(expand_grouped_metadata([Ge(4), Len(5)])))
+        #> [Ge(ge=4), MinLen(min_length=5)]
+        ```
+    """
+    import annotated_types as at
+
+    from pydantic.fields import FieldInfo  # circular import
+
+    for annotation in annotations:
+        if isinstance(annotation, at.GroupedMetadata):
+            yield from annotation
+        elif isinstance(annotation, FieldInfo):
+            yield from annotation.metadata
+            # this is a bit problematic in that it results in duplicate metadata
+            # all of our "consumers" can handle it, but it is not ideal
+            # we probably should split up FieldInfo into:
+            # - annotated types metadata
+            # - individual metadata known only to Pydantic
+            annotation = copy(annotation)
+            annotation.metadata = []
+            yield annotation
+        else:
+            yield annotation
+
+
+def apply_known_metadata(annotation: Any, schema: CoreSchema) -> CoreSchema | None:  # noqa: C901
+    """Apply `annotation` to `schema` if it is an annotation we know about (Gt, Le, etc.).
+    Otherwise return `None`.
+
+    This does not handle all known annotations. If / when it does, it can always
+    return a CoreSchema and return the unmodified schema if the annotation should be ignored.
+
+    Assumes that GroupedMetadata has already been expanded via `expand_grouped_metadata`.
+
+    Args:
+        annotation: The annotation.
+        schema: The schema.
+
+    Returns:
+        An updated schema with annotation if it is an annotation we know about, `None` otherwise.
+
+    Raises:
+        PydanticCustomError: If `Predicate` fails.
+    """
+    import annotated_types as at
+
+    from . import _validators
+
+    schema = schema.copy()
+    schema_update, other_metadata = collect_known_metadata([annotation])
+    schema_type = schema['type']
+    for constraint, value in schema_update.items():
+        if constraint not in CONSTRAINTS_TO_ALLOWED_SCHEMAS:
+            raise ValueError(f'Unknown constraint {constraint}')
+        allowed_schemas = CONSTRAINTS_TO_ALLOWED_SCHEMAS[constraint]
+
+        if schema_type in allowed_schemas:
+            if constraint == 'union_mode' and schema_type == 'union':
+                schema['mode'] = value  # type: ignore  # schema is UnionSchema
+            else:
+                schema[constraint] = value
+            continue
+
+        if constraint == 'allow_inf_nan' and value is False:
+            return cs.no_info_after_validator_function(
+                _validators.forbid_inf_nan_check,
+                schema,
+            )
+        elif constraint == 'pattern':
+            # insert a str schema to make sure the regex engine matches
+            return cs.chain_schema(
+                [
+                    schema,
+                    cs.str_schema(pattern=value),
+                ]
+            )
+        elif constraint == 'gt':
+            s = cs.no_info_after_validator_function(
+                partial(_validators.greater_than_validator, gt=value),
+                schema,
+            )
+            add_js_update_schema(s, lambda: {'gt': as_jsonable_value(value)})
+            return s
+        elif constraint == 'ge':
+            return cs.no_info_after_validator_function(
+                partial(_validators.greater_than_or_equal_validator, ge=value),
+                schema,
+            )
+        elif constraint == 'lt':
+            return cs.no_info_after_validator_function(
+                partial(_validators.less_than_validator, lt=value),
+                schema,
+            )
+        elif constraint == 'le':
+            return cs.no_info_after_validator_function(
+                partial(_validators.less_than_or_equal_validator, le=value),
+                schema,
+            )
+        elif constraint == 'multiple_of':
+            return cs.no_info_after_validator_function(
+                partial(_validators.multiple_of_validator, multiple_of=value),
+                schema,
+            )
+        elif constraint == 'min_length':
+            s = cs.no_info_after_validator_function(
+                partial(_validators.min_length_validator, min_length=value),
+                schema,
+            )
+            add_js_update_schema(s, lambda: {'minLength': (as_jsonable_value(value))})
+            return s
+        elif constraint == 'max_length':
+            s = cs.no_info_after_validator_function(
+                partial(_validators.max_length_validator, max_length=value),
+                schema,
+            )
+            add_js_update_schema(s, lambda: {'maxLength': (as_jsonable_value(value))})
+            return s
+        elif constraint == 'strip_whitespace':
+            return cs.chain_schema(
+                [
+                    schema,
+                    cs.str_schema(strip_whitespace=True),
+                ]
+            )
+        elif constraint == 'to_lower':
+            return cs.chain_schema(
+                [
+                    schema,
+                    cs.str_schema(to_lower=True),
+                ]
+            )
+        elif constraint == 'to_upper':
+            return cs.chain_schema(
+                [
+                    schema,
+                    cs.str_schema(to_upper=True),
+                ]
+            )
+        elif constraint == 'min_length':
+            return cs.no_info_after_validator_function(
+                partial(_validators.min_length_validator, min_length=annotation.min_length),
+                schema,
+            )
+        elif constraint == 'max_length':
+            return cs.no_info_after_validator_function(
+                partial(_validators.max_length_validator, max_length=annotation.max_length),
+                schema,
+            )
+        else:
+            raise RuntimeError(f'Unable to apply constraint {constraint} to schema {schema_type}')
+
+    for annotation in other_metadata:
+        if isinstance(annotation, at.Gt):
+            return cs.no_info_after_validator_function(
+                partial(_validators.greater_than_validator, gt=annotation.gt),
+                schema,
+            )
+        elif isinstance(annotation, at.Ge):
+            return cs.no_info_after_validator_function(
+                partial(_validators.greater_than_or_equal_validator, ge=annotation.ge),
+                schema,
+            )
+        elif isinstance(annotation, at.Lt):
+            return cs.no_info_after_validator_function(
+                partial(_validators.less_than_validator, lt=annotation.lt),
+                schema,
+            )
+        elif isinstance(annotation, at.Le):
+            return cs.no_info_after_validator_function(
+                partial(_validators.less_than_or_equal_validator, le=annotation.le),
+                schema,
+            )
+        elif isinstance(annotation, at.MultipleOf):
+            return cs.no_info_after_validator_function(
+                partial(_validators.multiple_of_validator, multiple_of=annotation.multiple_of),
+                schema,
+            )
+        elif isinstance(annotation, at.MinLen):
+            return cs.no_info_after_validator_function(
+                partial(_validators.min_length_validator, min_length=annotation.min_length),
+                schema,
+            )
+        elif isinstance(annotation, at.MaxLen):
+            return cs.no_info_after_validator_function(
+                partial(_validators.max_length_validator, max_length=annotation.max_length),
+                schema,
+            )
+        elif isinstance(annotation, at.Predicate):
+            predicate_name = f'{annotation.func.__qualname__} ' if hasattr(annotation.func, '__qualname__') else ''
+
+            def val_func(v: Any) -> Any:
+                # annotation.func may also raise an exception, let it pass through
+                if not annotation.func(v):
+                    raise PydanticCustomError(
+                        'predicate_failed',
+                        f'Predicate {predicate_name}failed',  # type: ignore
+                    )
+                return v
+
+            return cs.no_info_after_validator_function(val_func, schema)
+        # ignore any other unknown metadata
+        return None
+
+    return schema
+
+
+def collect_known_metadata(annotations: Iterable[Any]) -> tuple[dict[str, Any], list[Any]]:
+    """Split `annotations` into known metadata and unknown annotations.
+
+    Args:
+        annotations: An iterable of annotations.
+
+    Returns:
+        A tuple contains a dict of known metadata and a list of unknown annotations.
+
+    Example:
+        ```py
+        from annotated_types import Gt, Len
+
+        from pydantic._internal._known_annotated_metadata import collect_known_metadata
+
+        print(collect_known_metadata([Gt(1), Len(42), ...]))
+        #> ({'gt': 1, 'min_length': 42}, [Ellipsis])
+        ```
+    """
+    import annotated_types as at
+
+    annotations = expand_grouped_metadata(annotations)
+
+    res: dict[str, Any] = {}
+    remaining: list[Any] = []
+    for annotation in annotations:
+        # isinstance(annotation, PydanticMetadata) also covers ._fields:_PydanticGeneralMetadata
+        if isinstance(annotation, PydanticMetadata):
+            res.update(annotation.__dict__)
+        # we don't use dataclasses.asdict because that recursively calls asdict on the field values
+        elif isinstance(annotation, at.MinLen):
+            res.update({'min_length': annotation.min_length})
+        elif isinstance(annotation, at.MaxLen):
+            res.update({'max_length': annotation.max_length})
+        elif isinstance(annotation, at.Gt):
+            res.update({'gt': annotation.gt})
+        elif isinstance(annotation, at.Ge):
+            res.update({'ge': annotation.ge})
+        elif isinstance(annotation, at.Lt):
+            res.update({'lt': annotation.lt})
+        elif isinstance(annotation, at.Le):
+            res.update({'le': annotation.le})
+        elif isinstance(annotation, at.MultipleOf):
+            res.update({'multiple_of': annotation.multiple_of})
+        elif isinstance(annotation, type) and issubclass(annotation, PydanticMetadata):
+            # also support PydanticMetadata classes being used without initialisation,
+            # e.g. `Annotated[int, Strict]` as well as `Annotated[int, Strict()]`
+            res.update({k: v for k, v in vars(annotation).items() if not k.startswith('_')})
+        else:
+            remaining.append(annotation)
+    # Nones can sneak in but pydantic-core will reject them
+    # it'd be nice to clean things up so we don't put in None (we probably don't _need_ to, it was just easier)
+    # but this is simple enough to kick that can down the road
+    res = {k: v for k, v in res.items() if v is not None}
+    return res, remaining
+
+
+def check_metadata(metadata: dict[str, Any], allowed: Iterable[str], source_type: Any) -> None:
+    """A small utility function to validate that the given metadata can be applied to the target.
+    More than saving lines of code, this gives us a consistent error message for all of our internal implementations.
+
+    Args:
+        metadata: A dict of metadata.
+        allowed: An iterable of allowed metadata.
+        source_type: The source type.
+
+    Raises:
+        TypeError: If there is metadatas that can't be applied on source type.
+    """
+    unknown = metadata.keys() - set(allowed)
+    if unknown:
+        raise TypeError(
+            f'The following constraints cannot be applied to {source_type!r}: {", ".join([f"{k!r}" for k in unknown])}'
+        )
diff --git a/lib/pydantic/_internal/_mock_val_ser.py b/lib/pydantic/_internal/_mock_val_ser.py
new file mode 100644
index 00000000..b303fed2
--- /dev/null
+++ b/lib/pydantic/_internal/_mock_val_ser.py
@@ -0,0 +1,140 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Callable, Generic, TypeVar
+
+from pydantic_core import SchemaSerializer, SchemaValidator
+from typing_extensions import Literal
+
+from ..errors import PydanticErrorCodes, PydanticUserError
+
+if TYPE_CHECKING:
+    from ..dataclasses import PydanticDataclass
+    from ..main import BaseModel
+
+
+ValSer = TypeVar('ValSer', SchemaValidator, SchemaSerializer)
+
+
+class MockValSer(Generic[ValSer]):
+    """Mocker for `pydantic_core.SchemaValidator` or `pydantic_core.SchemaSerializer` which optionally attempts to
+    rebuild the thing it's mocking when one of its methods is accessed and raises an error if that fails.
+    """
+
+    __slots__ = '_error_message', '_code', '_val_or_ser', '_attempt_rebuild'
+
+    def __init__(
+        self,
+        error_message: str,
+        *,
+        code: PydanticErrorCodes,
+        val_or_ser: Literal['validator', 'serializer'],
+        attempt_rebuild: Callable[[], ValSer | None] | None = None,
+    ) -> None:
+        self._error_message = error_message
+        self._val_or_ser = SchemaValidator if val_or_ser == 'validator' else SchemaSerializer
+        self._code: PydanticErrorCodes = code
+        self._attempt_rebuild = attempt_rebuild
+
+    def __getattr__(self, item: str) -> None:
+        __tracebackhide__ = True
+        if self._attempt_rebuild:
+            val_ser = self._attempt_rebuild()
+            if val_ser is not None:
+                return getattr(val_ser, item)
+
+        # raise an AttributeError if `item` doesn't exist
+        getattr(self._val_or_ser, item)
+        raise PydanticUserError(self._error_message, code=self._code)
+
+    def rebuild(self) -> ValSer | None:
+        if self._attempt_rebuild:
+            val_ser = self._attempt_rebuild()
+            if val_ser is not None:
+                return val_ser
+            else:
+                raise PydanticUserError(self._error_message, code=self._code)
+        return None
+
+
+def set_model_mocks(cls: type[BaseModel], cls_name: str, undefined_name: str = 'all referenced types') -> None:
+    """Set `__pydantic_validator__` and `__pydantic_serializer__` to `MockValSer`s on a model.
+
+    Args:
+        cls: The model class to set the mocks on
+        cls_name: Name of the model class, used in error messages
+        undefined_name: Name of the undefined thing, used in error messages
+    """
+    undefined_type_error_message = (
+        f'`{cls_name}` is not fully defined; you should define {undefined_name},'
+        f' then call `{cls_name}.model_rebuild()`.'
+    )
+
+    def attempt_rebuild_validator() -> SchemaValidator | None:
+        if cls.model_rebuild(raise_errors=False, _parent_namespace_depth=5) is not False:
+            return cls.__pydantic_validator__
+        else:
+            return None
+
+    cls.__pydantic_validator__ = MockValSer(  # type: ignore[assignment]
+        undefined_type_error_message,
+        code='class-not-fully-defined',
+        val_or_ser='validator',
+        attempt_rebuild=attempt_rebuild_validator,
+    )
+
+    def attempt_rebuild_serializer() -> SchemaSerializer | None:
+        if cls.model_rebuild(raise_errors=False, _parent_namespace_depth=5) is not False:
+            return cls.__pydantic_serializer__
+        else:
+            return None
+
+    cls.__pydantic_serializer__ = MockValSer(  # type: ignore[assignment]
+        undefined_type_error_message,
+        code='class-not-fully-defined',
+        val_or_ser='serializer',
+        attempt_rebuild=attempt_rebuild_serializer,
+    )
+
+
+def set_dataclass_mocks(
+    cls: type[PydanticDataclass], cls_name: str, undefined_name: str = 'all referenced types'
+) -> None:
+    """Set `__pydantic_validator__` and `__pydantic_serializer__` to `MockValSer`s on a dataclass.
+
+    Args:
+        cls: The model class to set the mocks on
+        cls_name: Name of the model class, used in error messages
+        undefined_name: Name of the undefined thing, used in error messages
+    """
+    from ..dataclasses import rebuild_dataclass
+
+    undefined_type_error_message = (
+        f'`{cls_name}` is not fully defined; you should define {undefined_name},'
+        f' then call `pydantic.dataclasses.rebuild_dataclass({cls_name})`.'
+    )
+
+    def attempt_rebuild_validator() -> SchemaValidator | None:
+        if rebuild_dataclass(cls, raise_errors=False, _parent_namespace_depth=5) is not False:
+            return cls.__pydantic_validator__
+        else:
+            return None
+
+    cls.__pydantic_validator__ = MockValSer(  # type: ignore[assignment]
+        undefined_type_error_message,
+        code='class-not-fully-defined',
+        val_or_ser='validator',
+        attempt_rebuild=attempt_rebuild_validator,
+    )
+
+    def attempt_rebuild_serializer() -> SchemaSerializer | None:
+        if rebuild_dataclass(cls, raise_errors=False, _parent_namespace_depth=5) is not False:
+            return cls.__pydantic_serializer__
+        else:
+            return None
+
+    cls.__pydantic_serializer__ = MockValSer(  # type: ignore[assignment]
+        undefined_type_error_message,
+        code='class-not-fully-defined',
+        val_or_ser='validator',
+        attempt_rebuild=attempt_rebuild_serializer,
+    )
diff --git a/lib/pydantic/_internal/_model_construction.py b/lib/pydantic/_internal/_model_construction.py
new file mode 100644
index 00000000..543f73e9
--- /dev/null
+++ b/lib/pydantic/_internal/_model_construction.py
@@ -0,0 +1,637 @@
+"""Private logic for creating models."""
+from __future__ import annotations as _annotations
+
+import operator
+import typing
+import warnings
+import weakref
+from abc import ABCMeta
+from functools import partial
+from types import FunctionType
+from typing import Any, Callable, Generic
+
+import typing_extensions
+from pydantic_core import PydanticUndefined, SchemaSerializer
+from typing_extensions import dataclass_transform, deprecated
+
+from ..errors import PydanticUndefinedAnnotation, PydanticUserError
+from ..plugin._schema_validator import create_schema_validator
+from ..warnings import GenericBeforeBaseModelWarning, PydanticDeprecatedSince20
+from ._config import ConfigWrapper
+from ._decorators import DecoratorInfos, PydanticDescriptorProxy, get_attribute_from_bases
+from ._fields import collect_model_fields, is_valid_field_name, is_valid_privateattr_name
+from ._generate_schema import GenerateSchema
+from ._generics import PydanticGenericMetadata, get_model_typevars_map
+from ._mock_val_ser import MockValSer, set_model_mocks
+from ._schema_generation_shared import CallbackGetCoreSchemaHandler
+from ._signature import generate_pydantic_signature
+from ._typing_extra import get_cls_types_namespace, is_annotated, is_classvar, parent_frame_namespace
+from ._utils import ClassAttribute, SafeGetItemProxy
+from ._validate_call import ValidateCallWrapper
+
+if typing.TYPE_CHECKING:
+    from ..fields import Field as PydanticModelField
+    from ..fields import FieldInfo, ModelPrivateAttr
+    from ..main import BaseModel
+else:
+    # See PyCharm issues https://youtrack.jetbrains.com/issue/PY-21915
+    # and https://youtrack.jetbrains.com/issue/PY-51428
+    DeprecationWarning = PydanticDeprecatedSince20
+    PydanticModelField = object()
+
+object_setattr = object.__setattr__
+
+
+class _ModelNamespaceDict(dict):
+    """A dictionary subclass that intercepts attribute setting on model classes and
+    warns about overriding of decorators.
+    """
+
+    def __setitem__(self, k: str, v: object) -> None:
+        existing: Any = self.get(k, None)
+        if existing and v is not existing and isinstance(existing, PydanticDescriptorProxy):
+            warnings.warn(f'`{k}` overrides an existing Pydantic `{existing.decorator_info.decorator_repr}` decorator')
+
+        return super().__setitem__(k, v)
+
+
+@dataclass_transform(kw_only_default=True, field_specifiers=(PydanticModelField,))
+class ModelMetaclass(ABCMeta):
+    def __new__(
+        mcs,
+        cls_name: str,
+        bases: tuple[type[Any], ...],
+        namespace: dict[str, Any],
+        __pydantic_generic_metadata__: PydanticGenericMetadata | None = None,
+        __pydantic_reset_parent_namespace__: bool = True,
+        _create_model_module: str | None = None,
+        **kwargs: Any,
+    ) -> type:
+        """Metaclass for creating Pydantic models.
+
+        Args:
+            cls_name: The name of the class to be created.
+            bases: The base classes of the class to be created.
+            namespace: The attribute dictionary of the class to be created.
+            __pydantic_generic_metadata__: Metadata for generic models.
+            __pydantic_reset_parent_namespace__: Reset parent namespace.
+            _create_model_module: The module of the class to be created, if created by `create_model`.
+            **kwargs: Catch-all for any other keyword arguments.
+
+        Returns:
+            The new class created by the metaclass.
+        """
+        # Note `ModelMetaclass` refers to `BaseModel`, but is also used to *create* `BaseModel`, so we rely on the fact
+        # that `BaseModel` itself won't have any bases, but any subclass of it will, to determine whether the `__new__`
+        # call we're in the middle of is for the `BaseModel` class.
+        if bases:
+            base_field_names, class_vars, base_private_attributes = mcs._collect_bases_data(bases)
+
+            config_wrapper = ConfigWrapper.for_model(bases, namespace, kwargs)
+            namespace['model_config'] = config_wrapper.config_dict
+            private_attributes = inspect_namespace(
+                namespace, config_wrapper.ignored_types, class_vars, base_field_names
+            )
+            if private_attributes:
+                original_model_post_init = get_model_post_init(namespace, bases)
+                if original_model_post_init is not None:
+                    # if there are private_attributes and a model_post_init function, we handle both
+
+                    def wrapped_model_post_init(self: BaseModel, __context: Any) -> None:
+                        """We need to both initialize private attributes and call the user-defined model_post_init
+                        method.
+                        """
+                        init_private_attributes(self, __context)
+                        original_model_post_init(self, __context)
+
+                    namespace['model_post_init'] = wrapped_model_post_init
+                else:
+                    namespace['model_post_init'] = init_private_attributes
+
+            namespace['__class_vars__'] = class_vars
+            namespace['__private_attributes__'] = {**base_private_attributes, **private_attributes}
+
+            cls: type[BaseModel] = super().__new__(mcs, cls_name, bases, namespace, **kwargs)  # type: ignore
+
+            from ..main import BaseModel
+
+            mro = cls.__mro__
+            if Generic in mro and mro.index(Generic) < mro.index(BaseModel):
+                warnings.warn(
+                    GenericBeforeBaseModelWarning(
+                        'Classes should inherit from `BaseModel` before generic classes (e.g. `typing.Generic[T]`) '
+                        'for pydantic generics to work properly.'
+                    ),
+                    stacklevel=2,
+                )
+
+            cls.__pydantic_custom_init__ = not getattr(cls.__init__, '__pydantic_base_init__', False)
+            cls.__pydantic_post_init__ = None if cls.model_post_init is BaseModel.model_post_init else 'model_post_init'
+
+            cls.__pydantic_decorators__ = DecoratorInfos.build(cls)
+
+            # Use the getattr below to grab the __parameters__ from the `typing.Generic` parent class
+            if __pydantic_generic_metadata__:
+                cls.__pydantic_generic_metadata__ = __pydantic_generic_metadata__
+            else:
+                parent_parameters = getattr(cls, '__pydantic_generic_metadata__', {}).get('parameters', ())
+                parameters = getattr(cls, '__parameters__', None) or parent_parameters
+                if parameters and parent_parameters and not all(x in parameters for x in parent_parameters):
+                    combined_parameters = parent_parameters + tuple(x for x in parameters if x not in parent_parameters)
+                    parameters_str = ', '.join([str(x) for x in combined_parameters])
+                    generic_type_label = f'typing.Generic[{parameters_str}]'
+                    error_message = (
+                        f'All parameters must be present on typing.Generic;'
+                        f' you should inherit from {generic_type_label}.'
+                    )
+                    if Generic not in bases:  # pragma: no cover
+                        # We raise an error here not because it is desirable, but because some cases are mishandled.
+                        # It would be nice to remove this error and still have things behave as expected, it's just
+                        # challenging because we are using a custom `__class_getitem__` to parametrize generic models,
+                        # and not returning a typing._GenericAlias from it.
+                        bases_str = ', '.join([x.__name__ for x in bases] + [generic_type_label])
+                        error_message += (
+                            f' Note: `typing.Generic` must go last: `class {cls.__name__}({bases_str}): ...`)'
+                        )
+                    raise TypeError(error_message)
+
+                cls.__pydantic_generic_metadata__ = {
+                    'origin': None,
+                    'args': (),
+                    'parameters': parameters,
+                }
+
+            cls.__pydantic_complete__ = False  # Ensure this specific class gets completed
+
+            # preserve `__set_name__` protocol defined in https://peps.python.org/pep-0487
+            # for attributes not in `new_namespace` (e.g. private attributes)
+            for name, obj in private_attributes.items():
+                obj.__set_name__(cls, name)
+
+            if __pydantic_reset_parent_namespace__:
+                cls.__pydantic_parent_namespace__ = build_lenient_weakvaluedict(parent_frame_namespace())
+            parent_namespace = getattr(cls, '__pydantic_parent_namespace__', None)
+            if isinstance(parent_namespace, dict):
+                parent_namespace = unpack_lenient_weakvaluedict(parent_namespace)
+
+            types_namespace = get_cls_types_namespace(cls, parent_namespace)
+            set_model_fields(cls, bases, config_wrapper, types_namespace)
+
+            if config_wrapper.frozen and '__hash__' not in namespace:
+                set_default_hash_func(cls, bases)
+
+            complete_model_class(
+                cls,
+                cls_name,
+                config_wrapper,
+                raise_errors=False,
+                types_namespace=types_namespace,
+                create_model_module=_create_model_module,
+            )
+
+            # If this is placed before the complete_model_class call above,
+            # the generic computed fields return type is set to PydanticUndefined
+            cls.model_computed_fields = {k: v.info for k, v in cls.__pydantic_decorators__.computed_fields.items()}
+
+            # using super(cls, cls) on the next line ensures we only call the parent class's __pydantic_init_subclass__
+            # I believe the `type: ignore` is only necessary because mypy doesn't realize that this code branch is
+            # only hit for _proper_ subclasses of BaseModel
+            super(cls, cls).__pydantic_init_subclass__(**kwargs)  # type: ignore[misc]
+            return cls
+        else:
+            # this is the BaseModel class itself being created, no logic required
+            return super().__new__(mcs, cls_name, bases, namespace, **kwargs)
+
+    if not typing.TYPE_CHECKING:  # pragma: no branch
+        # We put `__getattr__` in a non-TYPE_CHECKING block because otherwise, mypy allows arbitrary attribute access
+
+        def __getattr__(self, item: str) -> Any:
+            """This is necessary to keep attribute access working for class attribute access."""
+            private_attributes = self.__dict__.get('__private_attributes__')
+            if private_attributes and item in private_attributes:
+                return private_attributes[item]
+            if item == '__pydantic_core_schema__':
+                # This means the class didn't get a schema generated for it, likely because there was an undefined reference
+                maybe_mock_validator = getattr(self, '__pydantic_validator__', None)
+                if isinstance(maybe_mock_validator, MockValSer):
+                    rebuilt_validator = maybe_mock_validator.rebuild()
+                    if rebuilt_validator is not None:
+                        # In this case, a validator was built, and so `__pydantic_core_schema__` should now be set
+                        return getattr(self, '__pydantic_core_schema__')
+            raise AttributeError(item)
+
+    @classmethod
+    def __prepare__(cls, *args: Any, **kwargs: Any) -> dict[str, object]:
+        return _ModelNamespaceDict()
+
+    def __instancecheck__(self, instance: Any) -> bool:
+        """Avoid calling ABC _abc_subclasscheck unless we're pretty sure.
+
+        See #3829 and python/cpython#92810
+        """
+        return hasattr(instance, '__pydantic_validator__') and super().__instancecheck__(instance)
+
+    @staticmethod
+    def _collect_bases_data(bases: tuple[type[Any], ...]) -> tuple[set[str], set[str], dict[str, ModelPrivateAttr]]:
+        from ..main import BaseModel
+
+        field_names: set[str] = set()
+        class_vars: set[str] = set()
+        private_attributes: dict[str, ModelPrivateAttr] = {}
+        for base in bases:
+            if issubclass(base, BaseModel) and base is not BaseModel:
+                # model_fields might not be defined yet in the case of generics, so we use getattr here:
+                field_names.update(getattr(base, 'model_fields', {}).keys())
+                class_vars.update(base.__class_vars__)
+                private_attributes.update(base.__private_attributes__)
+        return field_names, class_vars, private_attributes
+
+    @property
+    @deprecated('The `__fields__` attribute is deprecated, use `model_fields` instead.', category=None)
+    def __fields__(self) -> dict[str, FieldInfo]:
+        warnings.warn(
+            'The `__fields__` attribute is deprecated, use `model_fields` instead.', PydanticDeprecatedSince20
+        )
+        return self.model_fields  # type: ignore
+
+    def __dir__(self) -> list[str]:
+        attributes = list(super().__dir__())
+        if '__fields__' in attributes:
+            attributes.remove('__fields__')
+        return attributes
+
+
+def init_private_attributes(self: BaseModel, __context: Any) -> None:
+    """This function is meant to behave like a BaseModel method to initialise private attributes.
+
+    It takes context as an argument since that's what pydantic-core passes when calling it.
+
+    Args:
+        self: The BaseModel instance.
+        __context: The context.
+    """
+    if getattr(self, '__pydantic_private__', None) is None:
+        pydantic_private = {}
+        for name, private_attr in self.__private_attributes__.items():
+            default = private_attr.get_default()
+            if default is not PydanticUndefined:
+                pydantic_private[name] = default
+        object_setattr(self, '__pydantic_private__', pydantic_private)
+
+
+def get_model_post_init(namespace: dict[str, Any], bases: tuple[type[Any], ...]) -> Callable[..., Any] | None:
+    """Get the `model_post_init` method from the namespace or the class bases, or `None` if not defined."""
+    if 'model_post_init' in namespace:
+        return namespace['model_post_init']
+
+    from ..main import BaseModel
+
+    model_post_init = get_attribute_from_bases(bases, 'model_post_init')
+    if model_post_init is not BaseModel.model_post_init:
+        return model_post_init
+
+
+def inspect_namespace(  # noqa C901
+    namespace: dict[str, Any],
+    ignored_types: tuple[type[Any], ...],
+    base_class_vars: set[str],
+    base_class_fields: set[str],
+) -> dict[str, ModelPrivateAttr]:
+    """Iterate over the namespace and:
+    * gather private attributes
+    * check for items which look like fields but are not (e.g. have no annotation) and warn.
+
+    Args:
+        namespace: The attribute dictionary of the class to be created.
+        ignored_types: A tuple of ignore types.
+        base_class_vars: A set of base class class variables.
+        base_class_fields: A set of base class fields.
+
+    Returns:
+        A dict contains private attributes info.
+
+    Raises:
+        TypeError: If there is a `__root__` field in model.
+        NameError: If private attribute name is invalid.
+        PydanticUserError:
+            - If a field does not have a type annotation.
+            - If a field on base class was overridden by a non-annotated attribute.
+    """
+    from ..fields import FieldInfo, ModelPrivateAttr, PrivateAttr
+
+    all_ignored_types = ignored_types + default_ignored_types()
+
+    private_attributes: dict[str, ModelPrivateAttr] = {}
+    raw_annotations = namespace.get('__annotations__', {})
+
+    if '__root__' in raw_annotations or '__root__' in namespace:
+        raise TypeError("To define root models, use `pydantic.RootModel` rather than a field called '__root__'")
+
+    ignored_names: set[str] = set()
+    for var_name, value in list(namespace.items()):
+        if var_name == 'model_config':
+            continue
+        elif (
+            isinstance(value, type)
+            and value.__module__ == namespace['__module__']
+            and value.__qualname__.startswith(namespace['__qualname__'])
+        ):
+            # `value` is a nested type defined in this namespace; don't error
+            continue
+        elif isinstance(value, all_ignored_types) or value.__class__.__module__ == 'functools':
+            ignored_names.add(var_name)
+            continue
+        elif isinstance(value, ModelPrivateAttr):
+            if var_name.startswith('__'):
+                raise NameError(
+                    'Private attributes must not use dunder names;'
+                    f' use a single underscore prefix instead of {var_name!r}.'
+                )
+            elif is_valid_field_name(var_name):
+                raise NameError(
+                    'Private attributes must not use valid field names;'
+                    f' use sunder names, e.g. {"_" + var_name!r} instead of {var_name!r}.'
+                )
+            private_attributes[var_name] = value
+            del namespace[var_name]
+        elif isinstance(value, FieldInfo) and not is_valid_field_name(var_name):
+            suggested_name = var_name.lstrip('_') or 'my_field'  # don't suggest '' for all-underscore name
+            raise NameError(
+                f'Fields must not use names with leading underscores;'
+                f' e.g., use {suggested_name!r} instead of {var_name!r}.'
+            )
+
+        elif var_name.startswith('__'):
+            continue
+        elif is_valid_privateattr_name(var_name):
+            if var_name not in raw_annotations or not is_classvar(raw_annotations[var_name]):
+                private_attributes[var_name] = PrivateAttr(default=value)
+                del namespace[var_name]
+        elif var_name in base_class_vars:
+            continue
+        elif var_name not in raw_annotations:
+            if var_name in base_class_fields:
+                raise PydanticUserError(
+                    f'Field {var_name!r} defined on a base class was overridden by a non-annotated attribute. '
+                    f'All field definitions, including overrides, require a type annotation.',
+                    code='model-field-overridden',
+                )
+            elif isinstance(value, FieldInfo):
+                raise PydanticUserError(
+                    f'Field {var_name!r} requires a type annotation', code='model-field-missing-annotation'
+                )
+            else:
+                raise PydanticUserError(
+                    f'A non-annotated attribute was detected: `{var_name} = {value!r}`. All model fields require a '
+                    f'type annotation; if `{var_name}` is not meant to be a field, you may be able to resolve this '
+                    f"error by annotating it as a `ClassVar` or updating `model_config['ignored_types']`.",
+                    code='model-field-missing-annotation',
+                )
+
+    for ann_name, ann_type in raw_annotations.items():
+        if (
+            is_valid_privateattr_name(ann_name)
+            and ann_name not in private_attributes
+            and ann_name not in ignored_names
+            and not is_classvar(ann_type)
+            and ann_type not in all_ignored_types
+            and getattr(ann_type, '__module__', None) != 'functools'
+        ):
+            if is_annotated(ann_type):
+                _, *metadata = typing_extensions.get_args(ann_type)
+                private_attr = next((v for v in metadata if isinstance(v, ModelPrivateAttr)), None)
+                if private_attr is not None:
+                    private_attributes[ann_name] = private_attr
+                    continue
+            private_attributes[ann_name] = PrivateAttr()
+
+    return private_attributes
+
+
+def set_default_hash_func(cls: type[BaseModel], bases: tuple[type[Any], ...]) -> None:
+    base_hash_func = get_attribute_from_bases(bases, '__hash__')
+    new_hash_func = make_hash_func(cls)
+    if base_hash_func in {None, object.__hash__} or getattr(base_hash_func, '__code__', None) == new_hash_func.__code__:
+        # If `__hash__` is some default, we generate a hash function.
+        # It will be `None` if not overridden from BaseModel.
+        # It may be `object.__hash__` if there is another
+        # parent class earlier in the bases which doesn't override `__hash__` (e.g. `typing.Generic`).
+        # It may be a value set by `set_default_hash_func` if `cls` is a subclass of another frozen model.
+        # In the last case we still need a new hash function to account for new `model_fields`.
+        cls.__hash__ = new_hash_func
+
+
+def make_hash_func(cls: type[BaseModel]) -> Any:
+    getter = operator.itemgetter(*cls.model_fields.keys()) if cls.model_fields else lambda _: 0
+
+    def hash_func(self: Any) -> int:
+        try:
+            return hash(getter(self.__dict__))
+        except KeyError:
+            # In rare cases (such as when using the deprecated copy method), the __dict__ may not contain
+            # all model fields, which is how we can get here.
+            # getter(self.__dict__) is much faster than any 'safe' method that accounts for missing keys,
+            # and wrapping it in a `try` doesn't slow things down much in the common case.
+            return hash(getter(SafeGetItemProxy(self.__dict__)))
+
+    return hash_func
+
+
+def set_model_fields(
+    cls: type[BaseModel], bases: tuple[type[Any], ...], config_wrapper: ConfigWrapper, types_namespace: dict[str, Any]
+) -> None:
+    """Collect and set `cls.model_fields` and `cls.__class_vars__`.
+
+    Args:
+        cls: BaseModel or dataclass.
+        bases: Parents of the class, generally `cls.__bases__`.
+        config_wrapper: The config wrapper instance.
+        types_namespace: Optional extra namespace to look for types in.
+    """
+    typevars_map = get_model_typevars_map(cls)
+    fields, class_vars = collect_model_fields(cls, bases, config_wrapper, types_namespace, typevars_map=typevars_map)
+
+    cls.model_fields = fields
+    cls.__class_vars__.update(class_vars)
+
+    for k in class_vars:
+        # Class vars should not be private attributes
+        #     We remove them _here_ and not earlier because we rely on inspecting the class to determine its classvars,
+        #     but private attributes are determined by inspecting the namespace _prior_ to class creation.
+        #     In the case that a classvar with a leading-'_' is defined via a ForwardRef (e.g., when using
+        #     `__future__.annotations`), we want to remove the private attribute which was detected _before_ we knew it
+        #     evaluated to a classvar
+
+        value = cls.__private_attributes__.pop(k, None)
+        if value is not None and value.default is not PydanticUndefined:
+            setattr(cls, k, value.default)
+
+
+def complete_model_class(
+    cls: type[BaseModel],
+    cls_name: str,
+    config_wrapper: ConfigWrapper,
+    *,
+    raise_errors: bool = True,
+    types_namespace: dict[str, Any] | None,
+    create_model_module: str | None = None,
+) -> bool:
+    """Finish building a model class.
+
+    This logic must be called after class has been created since validation functions must be bound
+    and `get_type_hints` requires a class object.
+
+    Args:
+        cls: BaseModel or dataclass.
+        cls_name: The model or dataclass name.
+        config_wrapper: The config wrapper instance.
+        raise_errors: Whether to raise errors.
+        types_namespace: Optional extra namespace to look for types in.
+        create_model_module: The module of the class to be created, if created by `create_model`.
+
+    Returns:
+        `True` if the model is successfully completed, else `False`.
+
+    Raises:
+        PydanticUndefinedAnnotation: If `PydanticUndefinedAnnotation` occurs in`__get_pydantic_core_schema__`
+            and `raise_errors=True`.
+    """
+    typevars_map = get_model_typevars_map(cls)
+    gen_schema = GenerateSchema(
+        config_wrapper,
+        types_namespace,
+        typevars_map,
+    )
+
+    handler = CallbackGetCoreSchemaHandler(
+        partial(gen_schema.generate_schema, from_dunder_get_core_schema=False),
+        gen_schema,
+        ref_mode='unpack',
+    )
+
+    if config_wrapper.defer_build:
+        set_model_mocks(cls, cls_name)
+        return False
+
+    try:
+        schema = cls.__get_pydantic_core_schema__(cls, handler)
+    except PydanticUndefinedAnnotation as e:
+        if raise_errors:
+            raise
+        set_model_mocks(cls, cls_name, f'`{e.name}`')
+        return False
+
+    core_config = config_wrapper.core_config(cls)
+
+    try:
+        schema = gen_schema.clean_schema(schema)
+    except gen_schema.CollectedInvalid:
+        set_model_mocks(cls, cls_name)
+        return False
+
+    # debug(schema)
+    cls.__pydantic_core_schema__ = schema
+
+    cls.__pydantic_validator__ = create_schema_validator(
+        schema,
+        cls,
+        create_model_module or cls.__module__,
+        cls.__qualname__,
+        'create_model' if create_model_module else 'BaseModel',
+        core_config,
+        config_wrapper.plugin_settings,
+    )
+    cls.__pydantic_serializer__ = SchemaSerializer(schema, core_config)
+    cls.__pydantic_complete__ = True
+
+    # set __signature__ attr only for model class, but not for its instances
+    cls.__signature__ = ClassAttribute(
+        '__signature__',
+        generate_pydantic_signature(init=cls.__init__, fields=cls.model_fields, config_wrapper=config_wrapper),
+    )
+    return True
+
+
+class _PydanticWeakRef:
+    """Wrapper for `weakref.ref` that enables `pickle` serialization.
+
+    Cloudpickle fails to serialize `weakref.ref` objects due to an arcane error related
+    to abstract base classes (`abc.ABC`). This class works around the issue by wrapping
+    `weakref.ref` instead of subclassing it.
+
+    See https://github.com/pydantic/pydantic/issues/6763 for context.
+
+    Semantics:
+        - If not pickled, behaves the same as a `weakref.ref`.
+        - If pickled along with the referenced object, the same `weakref.ref` behavior
+          will be maintained between them after unpickling.
+        - If pickled without the referenced object, after unpickling the underlying
+          reference will be cleared (`__call__` will always return `None`).
+    """
+
+    def __init__(self, obj: Any):
+        if obj is None:
+            # The object will be `None` upon deserialization if the serialized weakref
+            # had lost its underlying object.
+            self._wr = None
+        else:
+            self._wr = weakref.ref(obj)
+
+    def __call__(self) -> Any:
+        if self._wr is None:
+            return None
+        else:
+            return self._wr()
+
+    def __reduce__(self) -> tuple[Callable, tuple[weakref.ReferenceType | None]]:
+        return _PydanticWeakRef, (self(),)
+
+
+def build_lenient_weakvaluedict(d: dict[str, Any] | None) -> dict[str, Any] | None:
+    """Takes an input dictionary, and produces a new value that (invertibly) replaces the values with weakrefs.
+
+    We can't just use a WeakValueDictionary because many types (including int, str, etc.) can't be stored as values
+    in a WeakValueDictionary.
+
+    The `unpack_lenient_weakvaluedict` function can be used to reverse this operation.
+    """
+    if d is None:
+        return None
+    result = {}
+    for k, v in d.items():
+        try:
+            proxy = _PydanticWeakRef(v)
+        except TypeError:
+            proxy = v
+        result[k] = proxy
+    return result
+
+
+def unpack_lenient_weakvaluedict(d: dict[str, Any] | None) -> dict[str, Any] | None:
+    """Inverts the transform performed by `build_lenient_weakvaluedict`."""
+    if d is None:
+        return None
+
+    result = {}
+    for k, v in d.items():
+        if isinstance(v, _PydanticWeakRef):
+            v = v()
+            if v is not None:
+                result[k] = v
+        else:
+            result[k] = v
+    return result
+
+
+def default_ignored_types() -> tuple[type[Any], ...]:
+    from ..fields import ComputedFieldInfo
+
+    return (
+        FunctionType,
+        property,
+        classmethod,
+        staticmethod,
+        PydanticDescriptorProxy,
+        ComputedFieldInfo,
+        ValidateCallWrapper,
+    )
diff --git a/lib/pydantic/_internal/_repr.py b/lib/pydantic/_internal/_repr.py
new file mode 100644
index 00000000..479b4479
--- /dev/null
+++ b/lib/pydantic/_internal/_repr.py
@@ -0,0 +1,117 @@
+"""Tools to provide pretty/human-readable display of objects."""
+from __future__ import annotations as _annotations
+
+import types
+import typing
+from typing import Any
+
+import typing_extensions
+
+from . import _typing_extra
+
+if typing.TYPE_CHECKING:
+    ReprArgs: typing_extensions.TypeAlias = 'typing.Iterable[tuple[str | None, Any]]'
+    RichReprResult: typing_extensions.TypeAlias = (
+        'typing.Iterable[Any | tuple[Any] | tuple[str, Any] | tuple[str, Any, Any]]'
+    )
+
+
+class PlainRepr(str):
+    """String class where repr doesn't include quotes. Useful with Representation when you want to return a string
+    representation of something that is valid (or pseudo-valid) python.
+    """
+
+    def __repr__(self) -> str:
+        return str(self)
+
+
+class Representation:
+    # Mixin to provide `__str__`, `__repr__`, and `__pretty__` and `__rich_repr__` methods.
+    # `__pretty__` is used by [devtools](https://python-devtools.helpmanual.io/).
+    # `__rich_repr__` is used by [rich](https://rich.readthedocs.io/en/stable/pretty.html).
+    # (this is not a docstring to avoid adding a docstring to classes which inherit from Representation)
+
+    # we don't want to use a type annotation here as it can break get_type_hints
+    __slots__ = tuple()  # type: typing.Collection[str]
+
+    def __repr_args__(self) -> ReprArgs:
+        """Returns the attributes to show in __str__, __repr__, and __pretty__ this is generally overridden.
+
+        Can either return:
+        * name - value pairs, e.g.: `[('foo_name', 'foo'), ('bar_name', ['b', 'a', 'r'])]`
+        * or, just values, e.g.: `[(None, 'foo'), (None, ['b', 'a', 'r'])]`
+        """
+        attrs_names = self.__slots__
+        if not attrs_names and hasattr(self, '__dict__'):
+            attrs_names = self.__dict__.keys()
+        attrs = ((s, getattr(self, s)) for s in attrs_names)
+        return [(a, v) for a, v in attrs if v is not None]
+
+    def __repr_name__(self) -> str:
+        """Name of the instance's class, used in __repr__."""
+        return self.__class__.__name__
+
+    def __repr_str__(self, join_str: str) -> str:
+        return join_str.join(repr(v) if a is None else f'{a}={v!r}' for a, v in self.__repr_args__())
+
+    def __pretty__(self, fmt: typing.Callable[[Any], Any], **kwargs: Any) -> typing.Generator[Any, None, None]:
+        """Used by devtools (https://python-devtools.helpmanual.io/) to pretty print objects."""
+        yield self.__repr_name__() + '('
+        yield 1
+        for name, value in self.__repr_args__():
+            if name is not None:
+                yield name + '='
+            yield fmt(value)
+            yield ','
+            yield 0
+        yield -1
+        yield ')'
+
+    def __rich_repr__(self) -> RichReprResult:
+        """Used by Rich (https://rich.readthedocs.io/en/stable/pretty.html) to pretty print objects."""
+        for name, field_repr in self.__repr_args__():
+            if name is None:
+                yield field_repr
+            else:
+                yield name, field_repr
+
+    def __str__(self) -> str:
+        return self.__repr_str__(' ')
+
+    def __repr__(self) -> str:
+        return f'{self.__repr_name__()}({self.__repr_str__(", ")})'
+
+
+def display_as_type(obj: Any) -> str:
+    """Pretty representation of a type, should be as close as possible to the original type definition string.
+
+    Takes some logic from `typing._type_repr`.
+    """
+    if isinstance(obj, types.FunctionType):
+        return obj.__name__
+    elif obj is ...:
+        return '...'
+    elif isinstance(obj, Representation):
+        return repr(obj)
+    elif isinstance(obj, typing_extensions.TypeAliasType):
+        return str(obj)
+
+    if not isinstance(obj, (_typing_extra.typing_base, _typing_extra.WithArgsTypes, type)):
+        obj = obj.__class__
+
+    if _typing_extra.origin_is_union(typing_extensions.get_origin(obj)):
+        args = ', '.join(map(display_as_type, typing_extensions.get_args(obj)))
+        return f'Union[{args}]'
+    elif isinstance(obj, _typing_extra.WithArgsTypes):
+        if typing_extensions.get_origin(obj) == typing_extensions.Literal:
+            args = ', '.join(map(repr, typing_extensions.get_args(obj)))
+        else:
+            args = ', '.join(map(display_as_type, typing_extensions.get_args(obj)))
+        try:
+            return f'{obj.__qualname__}[{args}]'
+        except AttributeError:
+            return str(obj)  # handles TypeAliasType in 3.12
+    elif isinstance(obj, type):
+        return obj.__qualname__
+    else:
+        return repr(obj).replace('typing.', '').replace('typing_extensions.', '')
diff --git a/lib/pydantic/_internal/_schema_generation_shared.py b/lib/pydantic/_internal/_schema_generation_shared.py
new file mode 100644
index 00000000..1a9aa852
--- /dev/null
+++ b/lib/pydantic/_internal/_schema_generation_shared.py
@@ -0,0 +1,124 @@
+"""Types and utility functions used by various other internal tools."""
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any, Callable
+
+from pydantic_core import core_schema
+from typing_extensions import Literal
+
+from ..annotated_handlers import GetCoreSchemaHandler, GetJsonSchemaHandler
+
+if TYPE_CHECKING:
+    from ..json_schema import GenerateJsonSchema, JsonSchemaValue
+    from ._core_utils import CoreSchemaOrField
+    from ._generate_schema import GenerateSchema
+
+    GetJsonSchemaFunction = Callable[[CoreSchemaOrField, GetJsonSchemaHandler], JsonSchemaValue]
+    HandlerOverride = Callable[[CoreSchemaOrField], JsonSchemaValue]
+
+
+class GenerateJsonSchemaHandler(GetJsonSchemaHandler):
+    """JsonSchemaHandler implementation that doesn't do ref unwrapping by default.
+
+    This is used for any Annotated metadata so that we don't end up with conflicting
+    modifications to the definition schema.
+
+    Used internally by Pydantic, please do not rely on this implementation.
+    See `GetJsonSchemaHandler` for the handler API.
+    """
+
+    def __init__(self, generate_json_schema: GenerateJsonSchema, handler_override: HandlerOverride | None) -> None:
+        self.generate_json_schema = generate_json_schema
+        self.handler = handler_override or generate_json_schema.generate_inner
+        self.mode = generate_json_schema.mode
+
+    def __call__(self, __core_schema: CoreSchemaOrField) -> JsonSchemaValue:
+        return self.handler(__core_schema)
+
+    def resolve_ref_schema(self, maybe_ref_json_schema: JsonSchemaValue) -> JsonSchemaValue:
+        """Resolves `$ref` in the json schema.
+
+        This returns the input json schema if there is no `$ref` in json schema.
+
+        Args:
+            maybe_ref_json_schema: The input json schema that may contains `$ref`.
+
+        Returns:
+            Resolved json schema.
+
+        Raises:
+            LookupError: If it can't find the definition for `$ref`.
+        """
+        if '$ref' not in maybe_ref_json_schema:
+            return maybe_ref_json_schema
+        ref = maybe_ref_json_schema['$ref']
+        json_schema = self.generate_json_schema.get_schema_from_definitions(ref)
+        if json_schema is None:
+            raise LookupError(
+                f'Could not find a ref for {ref}.'
+                ' Maybe you tried to call resolve_ref_schema from within a recursive model?'
+            )
+        return json_schema
+
+
+class CallbackGetCoreSchemaHandler(GetCoreSchemaHandler):
+    """Wrapper to use an arbitrary function as a `GetCoreSchemaHandler`.
+
+    Used internally by Pydantic, please do not rely on this implementation.
+    See `GetCoreSchemaHandler` for the handler API.
+    """
+
+    def __init__(
+        self,
+        handler: Callable[[Any], core_schema.CoreSchema],
+        generate_schema: GenerateSchema,
+        ref_mode: Literal['to-def', 'unpack'] = 'to-def',
+    ) -> None:
+        self._handler = handler
+        self._generate_schema = generate_schema
+        self._ref_mode = ref_mode
+
+    def __call__(self, __source_type: Any) -> core_schema.CoreSchema:
+        schema = self._handler(__source_type)
+        ref = schema.get('ref')
+        if self._ref_mode == 'to-def':
+            if ref is not None:
+                self._generate_schema.defs.definitions[ref] = schema
+                return core_schema.definition_reference_schema(ref)
+            return schema
+        else:  # ref_mode = 'unpack
+            return self.resolve_ref_schema(schema)
+
+    def _get_types_namespace(self) -> dict[str, Any] | None:
+        return self._generate_schema._types_namespace
+
+    def generate_schema(self, __source_type: Any) -> core_schema.CoreSchema:
+        return self._generate_schema.generate_schema(__source_type)
+
+    @property
+    def field_name(self) -> str | None:
+        return self._generate_schema.field_name_stack.get()
+
+    def resolve_ref_schema(self, maybe_ref_schema: core_schema.CoreSchema) -> core_schema.CoreSchema:
+        """Resolves reference in the core schema.
+
+        Args:
+            maybe_ref_schema: The input core schema that may contains reference.
+
+        Returns:
+            Resolved core schema.
+
+        Raises:
+            LookupError: If it can't find the definition for reference.
+        """
+        if maybe_ref_schema['type'] == 'definition-ref':
+            ref = maybe_ref_schema['schema_ref']
+            if ref not in self._generate_schema.defs.definitions:
+                raise LookupError(
+                    f'Could not find a ref for {ref}.'
+                    ' Maybe you tried to call resolve_ref_schema from within a recursive model?'
+                )
+            return self._generate_schema.defs.definitions[ref]
+        elif maybe_ref_schema['type'] == 'definitions':
+            return self.resolve_ref_schema(maybe_ref_schema['schema'])
+        return maybe_ref_schema
diff --git a/lib/pydantic/_internal/_signature.py b/lib/pydantic/_internal/_signature.py
new file mode 100644
index 00000000..816a1651
--- /dev/null
+++ b/lib/pydantic/_internal/_signature.py
@@ -0,0 +1,164 @@
+from __future__ import annotations
+
+import dataclasses
+from inspect import Parameter, Signature, signature
+from typing import TYPE_CHECKING, Any, Callable
+
+from pydantic_core import PydanticUndefined
+
+from ._config import ConfigWrapper
+from ._utils import is_valid_identifier
+
+if TYPE_CHECKING:
+    from ..fields import FieldInfo
+
+
+def _field_name_for_signature(field_name: str, field_info: FieldInfo) -> str:
+    """Extract the correct name to use for the field when generating a signature.
+
+    Assuming the field has a valid alias, this will return the alias. Otherwise, it will return the field name.
+    First priority is given to the validation_alias, then the alias, then the field name.
+
+    Args:
+        field_name: The name of the field
+        field_info: The corresponding FieldInfo object.
+
+    Returns:
+        The correct name to use when generating a signature.
+    """
+
+    def _alias_if_valid(x: Any) -> str | None:
+        """Return the alias if it is a valid alias and identifier, else None."""
+        return x if isinstance(x, str) and is_valid_identifier(x) else None
+
+    return _alias_if_valid(field_info.alias) or _alias_if_valid(field_info.validation_alias) or field_name
+
+
+def _process_param_defaults(param: Parameter) -> Parameter:
+    """Modify the signature for a parameter in a dataclass where the default value is a FieldInfo instance.
+
+    Args:
+        param (Parameter): The parameter
+
+    Returns:
+        Parameter: The custom processed parameter
+    """
+    from ..fields import FieldInfo
+
+    param_default = param.default
+    if isinstance(param_default, FieldInfo):
+        annotation = param.annotation
+        # Replace the annotation if appropriate
+        # inspect does "clever" things to show annotations as strings because we have
+        # `from __future__ import annotations` in main, we don't want that
+        if annotation == 'Any':
+            annotation = Any
+
+        # Replace the field default
+        default = param_default.default
+        if default is PydanticUndefined:
+            if param_default.default_factory is PydanticUndefined:
+                default = Signature.empty
+            else:
+                # this is used by dataclasses to indicate a factory exists:
+                default = dataclasses._HAS_DEFAULT_FACTORY  # type: ignore
+        return param.replace(
+            annotation=annotation, name=_field_name_for_signature(param.name, param_default), default=default
+        )
+    return param
+
+
+def _generate_signature_parameters(  # noqa: C901 (ignore complexity, could use a refactor)
+    init: Callable[..., None],
+    fields: dict[str, FieldInfo],
+    config_wrapper: ConfigWrapper,
+) -> dict[str, Parameter]:
+    """Generate a mapping of parameter names to Parameter objects for a pydantic BaseModel or dataclass."""
+    from itertools import islice
+
+    present_params = signature(init).parameters.values()
+    merged_params: dict[str, Parameter] = {}
+    var_kw = None
+    use_var_kw = False
+
+    for param in islice(present_params, 1, None):  # skip self arg
+        # inspect does "clever" things to show annotations as strings because we have
+        # `from __future__ import annotations` in main, we don't want that
+        if fields.get(param.name):
+            # exclude params with init=False
+            if getattr(fields[param.name], 'init', True) is False:
+                continue
+            param = param.replace(name=_field_name_for_signature(param.name, fields[param.name]))
+        if param.annotation == 'Any':
+            param = param.replace(annotation=Any)
+        if param.kind is param.VAR_KEYWORD:
+            var_kw = param
+            continue
+        merged_params[param.name] = param
+
+    if var_kw:  # if custom init has no var_kw, fields which are not declared in it cannot be passed through
+        allow_names = config_wrapper.populate_by_name
+        for field_name, field in fields.items():
+            # when alias is a str it should be used for signature generation
+            param_name = _field_name_for_signature(field_name, field)
+
+            if field_name in merged_params or param_name in merged_params:
+                continue
+
+            if not is_valid_identifier(param_name):
+                if allow_names:
+                    param_name = field_name
+                else:
+                    use_var_kw = True
+                    continue
+
+            kwargs = {} if field.is_required() else {'default': field.get_default(call_default_factory=False)}
+            merged_params[param_name] = Parameter(
+                param_name, Parameter.KEYWORD_ONLY, annotation=field.rebuild_annotation(), **kwargs
+            )
+
+    if config_wrapper.extra == 'allow':
+        use_var_kw = True
+
+    if var_kw and use_var_kw:
+        # Make sure the parameter for extra kwargs
+        # does not have the same name as a field
+        default_model_signature = [
+            ('self', Parameter.POSITIONAL_ONLY),
+            ('data', Parameter.VAR_KEYWORD),
+        ]
+        if [(p.name, p.kind) for p in present_params] == default_model_signature:
+            # if this is the standard model signature, use extra_data as the extra args name
+            var_kw_name = 'extra_data'
+        else:
+            # else start from var_kw
+            var_kw_name = var_kw.name
+
+        # generate a name that's definitely unique
+        while var_kw_name in fields:
+            var_kw_name += '_'
+        merged_params[var_kw_name] = var_kw.replace(name=var_kw_name)
+
+    return merged_params
+
+
+def generate_pydantic_signature(
+    init: Callable[..., None], fields: dict[str, FieldInfo], config_wrapper: ConfigWrapper, is_dataclass: bool = False
+) -> Signature:
+    """Generate signature for a pydantic BaseModel or dataclass.
+
+    Args:
+        init: The class init.
+        fields: The model fields.
+        config_wrapper: The config wrapper instance.
+        is_dataclass: Whether the model is a dataclass.
+
+    Returns:
+        The dataclass/BaseModel subclass signature.
+    """
+    merged_params = _generate_signature_parameters(init, fields, config_wrapper)
+
+    if is_dataclass:
+        merged_params = {k: _process_param_defaults(v) for k, v in merged_params.items()}
+
+    return Signature(parameters=list(merged_params.values()), return_annotation=None)
diff --git a/lib/pydantic/_internal/_std_types_schema.py b/lib/pydantic/_internal/_std_types_schema.py
new file mode 100644
index 00000000..c8523bf4
--- /dev/null
+++ b/lib/pydantic/_internal/_std_types_schema.py
@@ -0,0 +1,714 @@
+"""Logic for generating pydantic-core schemas for standard library types.
+
+Import of this module is deferred since it contains imports of many standard library modules.
+"""
+from __future__ import annotations as _annotations
+
+import collections
+import collections.abc
+import dataclasses
+import decimal
+import inspect
+import os
+import typing
+from enum import Enum
+from functools import partial
+from ipaddress import IPv4Address, IPv4Interface, IPv4Network, IPv6Address, IPv6Interface, IPv6Network
+from typing import Any, Callable, Iterable, TypeVar
+
+import typing_extensions
+from pydantic_core import (
+    CoreSchema,
+    MultiHostUrl,
+    PydanticCustomError,
+    PydanticOmit,
+    Url,
+    core_schema,
+)
+from typing_extensions import get_args, get_origin
+
+from pydantic.errors import PydanticSchemaGenerationError
+from pydantic.fields import FieldInfo
+from pydantic.types import Strict
+
+from ..config import ConfigDict
+from ..json_schema import JsonSchemaValue, update_json_schema
+from . import _known_annotated_metadata, _typing_extra, _validators
+from ._core_utils import get_type_ref
+from ._internal_dataclass import slots_true
+from ._schema_generation_shared import GetCoreSchemaHandler, GetJsonSchemaHandler
+
+if typing.TYPE_CHECKING:
+    from ._generate_schema import GenerateSchema
+
+    StdSchemaFunction = Callable[[GenerateSchema, type[Any]], core_schema.CoreSchema]
+
+
+@dataclasses.dataclass(**slots_true)
+class SchemaTransformer:
+    get_core_schema: Callable[[Any, GetCoreSchemaHandler], CoreSchema]
+    get_json_schema: Callable[[CoreSchema, GetJsonSchemaHandler], JsonSchemaValue]
+
+    def __get_pydantic_core_schema__(self, source_type: Any, handler: GetCoreSchemaHandler) -> CoreSchema:
+        return self.get_core_schema(source_type, handler)
+
+    def __get_pydantic_json_schema__(self, schema: CoreSchema, handler: GetJsonSchemaHandler) -> JsonSchemaValue:
+        return self.get_json_schema(schema, handler)
+
+
+def get_enum_core_schema(enum_type: type[Enum], config: ConfigDict) -> CoreSchema:
+    cases: list[Any] = list(enum_type.__members__.values())
+
+    enum_ref = get_type_ref(enum_type)
+    description = None if not enum_type.__doc__ else inspect.cleandoc(enum_type.__doc__)
+    if description == 'An enumeration.':  # This is the default value provided by enum.EnumMeta.__new__; don't use it
+        description = None
+    updates = {'title': enum_type.__name__, 'description': description}
+    updates = {k: v for k, v in updates.items() if v is not None}
+
+    def get_json_schema(_, handler: GetJsonSchemaHandler) -> JsonSchemaValue:
+        json_schema = handler(core_schema.literal_schema([x.value for x in cases], ref=enum_ref))
+        original_schema = handler.resolve_ref_schema(json_schema)
+        update_json_schema(original_schema, updates)
+        return json_schema
+
+    if not cases:
+        # Use an isinstance check for enums with no cases.
+        # The most important use case for this is creating TypeVar bounds for generics that should
+        # be restricted to enums. This is more consistent than it might seem at first, since you can only
+        # subclass enum.Enum (or subclasses of enum.Enum) if all parent classes have no cases.
+        # We use the get_json_schema function when an Enum subclass has been declared with no cases
+        # so that we can still generate a valid json schema.
+        return core_schema.is_instance_schema(enum_type, metadata={'pydantic_js_functions': [get_json_schema]})
+
+    use_enum_values = config.get('use_enum_values', False)
+
+    if len(cases) == 1:
+        expected = repr(cases[0].value)
+    else:
+        expected = ', '.join([repr(case.value) for case in cases[:-1]]) + f' or {cases[-1].value!r}'
+
+    def to_enum(__input_value: Any) -> Enum:
+        try:
+            enum_field = enum_type(__input_value)
+            if use_enum_values:
+                return enum_field.value
+            return enum_field
+        except ValueError:
+            # The type: ignore on the next line is to ignore the requirement of LiteralString
+            raise PydanticCustomError('enum', f'Input should be {expected}', {'expected': expected})  # type: ignore
+
+    strict_python_schema = core_schema.is_instance_schema(enum_type)
+    if use_enum_values:
+        strict_python_schema = core_schema.chain_schema(
+            [strict_python_schema, core_schema.no_info_plain_validator_function(lambda x: x.value)]
+        )
+
+    to_enum_validator = core_schema.no_info_plain_validator_function(to_enum)
+    if issubclass(enum_type, int):
+        # this handles `IntEnum`, and also `Foobar(int, Enum)`
+        updates['type'] = 'integer'
+        lax = core_schema.chain_schema([core_schema.int_schema(), to_enum_validator])
+        # Disallow float from JSON due to strict mode
+        strict = core_schema.json_or_python_schema(
+            json_schema=core_schema.no_info_after_validator_function(to_enum, core_schema.int_schema()),
+            python_schema=strict_python_schema,
+        )
+    elif issubclass(enum_type, str):
+        # this handles `StrEnum` (3.11 only), and also `Foobar(str, Enum)`
+        updates['type'] = 'string'
+        lax = core_schema.chain_schema([core_schema.str_schema(), to_enum_validator])
+        strict = core_schema.json_or_python_schema(
+            json_schema=core_schema.no_info_after_validator_function(to_enum, core_schema.str_schema()),
+            python_schema=strict_python_schema,
+        )
+    elif issubclass(enum_type, float):
+        updates['type'] = 'numeric'
+        lax = core_schema.chain_schema([core_schema.float_schema(), to_enum_validator])
+        strict = core_schema.json_or_python_schema(
+            json_schema=core_schema.no_info_after_validator_function(to_enum, core_schema.float_schema()),
+            python_schema=strict_python_schema,
+        )
+    else:
+        lax = to_enum_validator
+        strict = core_schema.json_or_python_schema(json_schema=to_enum_validator, python_schema=strict_python_schema)
+    return core_schema.lax_or_strict_schema(
+        lax_schema=lax, strict_schema=strict, ref=enum_ref, metadata={'pydantic_js_functions': [get_json_schema]}
+    )
+
+
+@dataclasses.dataclass(**slots_true)
+class InnerSchemaValidator:
+    """Use a fixed CoreSchema, avoiding interference from outward annotations."""
+
+    core_schema: CoreSchema
+    js_schema: JsonSchemaValue | None = None
+    js_core_schema: CoreSchema | None = None
+    js_schema_update: JsonSchemaValue | None = None
+
+    def __get_pydantic_json_schema__(self, _schema: CoreSchema, handler: GetJsonSchemaHandler) -> JsonSchemaValue:
+        if self.js_schema is not None:
+            return self.js_schema
+        js_schema = handler(self.js_core_schema or self.core_schema)
+        if self.js_schema_update is not None:
+            js_schema.update(self.js_schema_update)
+        return js_schema
+
+    def __get_pydantic_core_schema__(self, _source_type: Any, _handler: GetCoreSchemaHandler) -> CoreSchema:
+        return self.core_schema
+
+
+def decimal_prepare_pydantic_annotations(
+    source: Any, annotations: Iterable[Any], config: ConfigDict
+) -> tuple[Any, list[Any]] | None:
+    if source is not decimal.Decimal:
+        return None
+
+    metadata, remaining_annotations = _known_annotated_metadata.collect_known_metadata(annotations)
+
+    config_allow_inf_nan = config.get('allow_inf_nan')
+    if config_allow_inf_nan is not None:
+        metadata.setdefault('allow_inf_nan', config_allow_inf_nan)
+
+    _known_annotated_metadata.check_metadata(
+        metadata, {*_known_annotated_metadata.FLOAT_CONSTRAINTS, 'max_digits', 'decimal_places'}, decimal.Decimal
+    )
+    return source, [InnerSchemaValidator(core_schema.decimal_schema(**metadata)), *remaining_annotations]
+
+
+def datetime_prepare_pydantic_annotations(
+    source_type: Any, annotations: Iterable[Any], _config: ConfigDict
+) -> tuple[Any, list[Any]] | None:
+    import datetime
+
+    metadata, remaining_annotations = _known_annotated_metadata.collect_known_metadata(annotations)
+    if source_type is datetime.date:
+        sv = InnerSchemaValidator(core_schema.date_schema(**metadata))
+    elif source_type is datetime.datetime:
+        sv = InnerSchemaValidator(core_schema.datetime_schema(**metadata))
+    elif source_type is datetime.time:
+        sv = InnerSchemaValidator(core_schema.time_schema(**metadata))
+    elif source_type is datetime.timedelta:
+        sv = InnerSchemaValidator(core_schema.timedelta_schema(**metadata))
+    else:
+        return None
+    # check now that we know the source type is correct
+    _known_annotated_metadata.check_metadata(metadata, _known_annotated_metadata.DATE_TIME_CONSTRAINTS, source_type)
+    return (source_type, [sv, *remaining_annotations])
+
+
+def uuid_prepare_pydantic_annotations(
+    source_type: Any, annotations: Iterable[Any], _config: ConfigDict
+) -> tuple[Any, list[Any]] | None:
+    # UUIDs have no constraints - they are fixed length, constructing a UUID instance checks the length
+
+    from uuid import UUID
+
+    if source_type is not UUID:
+        return None
+
+    return (source_type, [InnerSchemaValidator(core_schema.uuid_schema()), *annotations])
+
+
+def path_schema_prepare_pydantic_annotations(
+    source_type: Any, annotations: Iterable[Any], _config: ConfigDict
+) -> tuple[Any, list[Any]] | None:
+    import pathlib
+
+    if source_type not in {
+        os.PathLike,
+        pathlib.Path,
+        pathlib.PurePath,
+        pathlib.PosixPath,
+        pathlib.PurePosixPath,
+        pathlib.PureWindowsPath,
+    }:
+        return None
+
+    metadata, remaining_annotations = _known_annotated_metadata.collect_known_metadata(annotations)
+    _known_annotated_metadata.check_metadata(metadata, _known_annotated_metadata.STR_CONSTRAINTS, source_type)
+
+    construct_path = pathlib.PurePath if source_type is os.PathLike else source_type
+
+    def path_validator(input_value: str) -> os.PathLike[Any]:
+        try:
+            return construct_path(input_value)
+        except TypeError as e:
+            raise PydanticCustomError('path_type', 'Input is not a valid path') from e
+
+    constrained_str_schema = core_schema.str_schema(**metadata)
+
+    instance_schema = core_schema.json_or_python_schema(
+        json_schema=core_schema.no_info_after_validator_function(path_validator, constrained_str_schema),
+        python_schema=core_schema.is_instance_schema(source_type),
+    )
+
+    strict: bool | None = None
+    for annotation in annotations:
+        if isinstance(annotation, Strict):
+            strict = annotation.strict
+
+    schema = core_schema.lax_or_strict_schema(
+        lax_schema=core_schema.union_schema(
+            [
+                instance_schema,
+                core_schema.no_info_after_validator_function(path_validator, constrained_str_schema),
+            ],
+            custom_error_type='path_type',
+            custom_error_message='Input is not a valid path',
+            strict=True,
+        ),
+        strict_schema=instance_schema,
+        serialization=core_schema.to_string_ser_schema(),
+        strict=strict,
+    )
+
+    return (
+        source_type,
+        [
+            InnerSchemaValidator(schema, js_core_schema=constrained_str_schema, js_schema_update={'format': 'path'}),
+            *remaining_annotations,
+        ],
+    )
+
+
+def dequeue_validator(
+    input_value: Any, handler: core_schema.ValidatorFunctionWrapHandler, maxlen: None | int
+) -> collections.deque[Any]:
+    if isinstance(input_value, collections.deque):
+        maxlens = [v for v in (input_value.maxlen, maxlen) if v is not None]
+        if maxlens:
+            maxlen = min(maxlens)
+        return collections.deque(handler(input_value), maxlen=maxlen)
+    else:
+        return collections.deque(handler(input_value), maxlen=maxlen)
+
+
+@dataclasses.dataclass(**slots_true)
+class SequenceValidator:
+    mapped_origin: type[Any]
+    item_source_type: type[Any]
+    min_length: int | None = None
+    max_length: int | None = None
+    strict: bool = False
+
+    def serialize_sequence_via_list(
+        self, v: Any, handler: core_schema.SerializerFunctionWrapHandler, info: core_schema.SerializationInfo
+    ) -> Any:
+        items: list[Any] = []
+        for index, item in enumerate(v):
+            try:
+                v = handler(item, index)
+            except PydanticOmit:
+                pass
+            else:
+                items.append(v)
+
+        if info.mode_is_json():
+            return items
+        else:
+            return self.mapped_origin(items)
+
+    def __get_pydantic_core_schema__(self, source_type: Any, handler: GetCoreSchemaHandler) -> CoreSchema:
+        if self.item_source_type is Any:
+            items_schema = None
+        else:
+            items_schema = handler.generate_schema(self.item_source_type)
+
+        metadata = {'min_length': self.min_length, 'max_length': self.max_length, 'strict': self.strict}
+
+        if self.mapped_origin in (list, set, frozenset):
+            if self.mapped_origin is list:
+                constrained_schema = core_schema.list_schema(items_schema, **metadata)
+            elif self.mapped_origin is set:
+                constrained_schema = core_schema.set_schema(items_schema, **metadata)
+            else:
+                assert self.mapped_origin is frozenset  # safety check in case we forget to add a case
+                constrained_schema = core_schema.frozenset_schema(items_schema, **metadata)
+
+            schema = constrained_schema
+        else:
+            # safety check in case we forget to add a case
+            assert self.mapped_origin in (collections.deque, collections.Counter)
+
+            if self.mapped_origin is collections.deque:
+                # if we have a MaxLen annotation might as well set that as the default maxlen on the deque
+                # this lets us re-use existing metadata annotations to let users set the maxlen on a dequeue
+                # that e.g. comes from JSON
+                coerce_instance_wrap = partial(
+                    core_schema.no_info_wrap_validator_function,
+                    partial(dequeue_validator, maxlen=metadata.get('max_length', None)),
+                )
+            else:
+                coerce_instance_wrap = partial(core_schema.no_info_after_validator_function, self.mapped_origin)
+
+            constrained_schema = core_schema.list_schema(items_schema, **metadata)
+
+            check_instance = core_schema.json_or_python_schema(
+                json_schema=core_schema.list_schema(),
+                python_schema=core_schema.is_instance_schema(self.mapped_origin),
+            )
+
+            serialization = core_schema.wrap_serializer_function_ser_schema(
+                self.serialize_sequence_via_list, schema=items_schema or core_schema.any_schema(), info_arg=True
+            )
+
+            strict = core_schema.chain_schema([check_instance, coerce_instance_wrap(constrained_schema)])
+
+            if metadata.get('strict', False):
+                schema = strict
+            else:
+                lax = coerce_instance_wrap(constrained_schema)
+                schema = core_schema.lax_or_strict_schema(lax_schema=lax, strict_schema=strict)
+            schema['serialization'] = serialization
+
+        return schema
+
+
+SEQUENCE_ORIGIN_MAP: dict[Any, Any] = {
+    typing.Deque: collections.deque,
+    collections.deque: collections.deque,
+    list: list,
+    typing.List: list,
+    set: set,
+    typing.AbstractSet: set,
+    typing.Set: set,
+    frozenset: frozenset,
+    typing.FrozenSet: frozenset,
+    typing.Sequence: list,
+    typing.MutableSequence: list,
+    typing.MutableSet: set,
+    # this doesn't handle subclasses of these
+    # parametrized typing.Set creates one of these
+    collections.abc.MutableSet: set,
+    collections.abc.Set: frozenset,
+}
+
+
+def identity(s: CoreSchema) -> CoreSchema:
+    return s
+
+
+def sequence_like_prepare_pydantic_annotations(
+    source_type: Any, annotations: Iterable[Any], _config: ConfigDict
+) -> tuple[Any, list[Any]] | None:
+    origin: Any = get_origin(source_type)
+
+    mapped_origin = SEQUENCE_ORIGIN_MAP.get(origin, None) if origin else SEQUENCE_ORIGIN_MAP.get(source_type, None)
+    if mapped_origin is None:
+        return None
+
+    args = get_args(source_type)
+
+    if not args:
+        args = (Any,)
+    elif len(args) != 1:
+        raise ValueError('Expected sequence to have exactly 1 generic parameter')
+
+    item_source_type = args[0]
+
+    metadata, remaining_annotations = _known_annotated_metadata.collect_known_metadata(annotations)
+    _known_annotated_metadata.check_metadata(metadata, _known_annotated_metadata.SEQUENCE_CONSTRAINTS, source_type)
+
+    return (source_type, [SequenceValidator(mapped_origin, item_source_type, **metadata), *remaining_annotations])
+
+
+MAPPING_ORIGIN_MAP: dict[Any, Any] = {
+    typing.DefaultDict: collections.defaultdict,
+    collections.defaultdict: collections.defaultdict,
+    collections.OrderedDict: collections.OrderedDict,
+    typing_extensions.OrderedDict: collections.OrderedDict,
+    dict: dict,
+    typing.Dict: dict,
+    collections.Counter: collections.Counter,
+    typing.Counter: collections.Counter,
+    # this doesn't handle subclasses of these
+    typing.Mapping: dict,
+    typing.MutableMapping: dict,
+    # parametrized typing.{Mutable}Mapping creates one of these
+    collections.abc.MutableMapping: dict,
+    collections.abc.Mapping: dict,
+}
+
+
+def defaultdict_validator(
+    input_value: Any, handler: core_schema.ValidatorFunctionWrapHandler, default_default_factory: Callable[[], Any]
+) -> collections.defaultdict[Any, Any]:
+    if isinstance(input_value, collections.defaultdict):
+        default_factory = input_value.default_factory
+        return collections.defaultdict(default_factory, handler(input_value))
+    else:
+        return collections.defaultdict(default_default_factory, handler(input_value))
+
+
+def get_defaultdict_default_default_factory(values_source_type: Any) -> Callable[[], Any]:
+    def infer_default() -> Callable[[], Any]:
+        allowed_default_types: dict[Any, Any] = {
+            typing.Tuple: tuple,
+            tuple: tuple,
+            collections.abc.Sequence: tuple,
+            collections.abc.MutableSequence: list,
+            typing.List: list,
+            list: list,
+            typing.Sequence: list,
+            typing.Set: set,
+            set: set,
+            typing.MutableSet: set,
+            collections.abc.MutableSet: set,
+            collections.abc.Set: frozenset,
+            typing.MutableMapping: dict,
+            typing.Mapping: dict,
+            collections.abc.Mapping: dict,
+            collections.abc.MutableMapping: dict,
+            float: float,
+            int: int,
+            str: str,
+            bool: bool,
+        }
+        values_type_origin = get_origin(values_source_type) or values_source_type
+        instructions = 'set using `DefaultDict[..., Annotated[..., Field(default_factory=...)]]`'
+        if isinstance(values_type_origin, TypeVar):
+
+            def type_var_default_factory() -> None:
+                raise RuntimeError(
+                    'Generic defaultdict cannot be used without a concrete value type or an'
+                    ' explicit default factory, ' + instructions
+                )
+
+            return type_var_default_factory
+        elif values_type_origin not in allowed_default_types:
+            # a somewhat subjective set of types that have reasonable default values
+            allowed_msg = ', '.join([t.__name__ for t in set(allowed_default_types.values())])
+            raise PydanticSchemaGenerationError(
+                f'Unable to infer a default factory for keys of type {values_source_type}.'
+                f' Only {allowed_msg} are supported, other types require an explicit default factory'
+                ' ' + instructions
+            )
+        return allowed_default_types[values_type_origin]
+
+    # Assume Annotated[..., Field(...)]
+    if _typing_extra.is_annotated(values_source_type):
+        field_info = next((v for v in get_args(values_source_type) if isinstance(v, FieldInfo)), None)
+    else:
+        field_info = None
+    if field_info and field_info.default_factory:
+        default_default_factory = field_info.default_factory
+    else:
+        default_default_factory = infer_default()
+    return default_default_factory
+
+
+@dataclasses.dataclass(**slots_true)
+class MappingValidator:
+    mapped_origin: type[Any]
+    keys_source_type: type[Any]
+    values_source_type: type[Any]
+    min_length: int | None = None
+    max_length: int | None = None
+    strict: bool = False
+
+    def serialize_mapping_via_dict(self, v: Any, handler: core_schema.SerializerFunctionWrapHandler) -> Any:
+        return handler(v)
+
+    def __get_pydantic_core_schema__(self, source_type: Any, handler: GetCoreSchemaHandler) -> CoreSchema:
+        if self.keys_source_type is Any:
+            keys_schema = None
+        else:
+            keys_schema = handler.generate_schema(self.keys_source_type)
+        if self.values_source_type is Any:
+            values_schema = None
+        else:
+            values_schema = handler.generate_schema(self.values_source_type)
+
+        metadata = {'min_length': self.min_length, 'max_length': self.max_length, 'strict': self.strict}
+
+        if self.mapped_origin is dict:
+            schema = core_schema.dict_schema(keys_schema, values_schema, **metadata)
+        else:
+            constrained_schema = core_schema.dict_schema(keys_schema, values_schema, **metadata)
+            check_instance = core_schema.json_or_python_schema(
+                json_schema=core_schema.dict_schema(),
+                python_schema=core_schema.is_instance_schema(self.mapped_origin),
+            )
+
+            if self.mapped_origin is collections.defaultdict:
+                default_default_factory = get_defaultdict_default_default_factory(self.values_source_type)
+                coerce_instance_wrap = partial(
+                    core_schema.no_info_wrap_validator_function,
+                    partial(defaultdict_validator, default_default_factory=default_default_factory),
+                )
+            else:
+                coerce_instance_wrap = partial(core_schema.no_info_after_validator_function, self.mapped_origin)
+
+            serialization = core_schema.wrap_serializer_function_ser_schema(
+                self.serialize_mapping_via_dict,
+                schema=core_schema.dict_schema(
+                    keys_schema or core_schema.any_schema(), values_schema or core_schema.any_schema()
+                ),
+                info_arg=False,
+            )
+
+            strict = core_schema.chain_schema([check_instance, coerce_instance_wrap(constrained_schema)])
+
+            if metadata.get('strict', False):
+                schema = strict
+            else:
+                lax = coerce_instance_wrap(constrained_schema)
+                schema = core_schema.lax_or_strict_schema(lax_schema=lax, strict_schema=strict)
+                schema['serialization'] = serialization
+
+        return schema
+
+
+def mapping_like_prepare_pydantic_annotations(
+    source_type: Any, annotations: Iterable[Any], _config: ConfigDict
+) -> tuple[Any, list[Any]] | None:
+    origin: Any = get_origin(source_type)
+
+    mapped_origin = MAPPING_ORIGIN_MAP.get(origin, None) if origin else MAPPING_ORIGIN_MAP.get(source_type, None)
+    if mapped_origin is None:
+        return None
+
+    args = get_args(source_type)
+
+    if not args:
+        args = (Any, Any)
+    elif mapped_origin is collections.Counter:
+        # a single generic
+        if len(args) != 1:
+            raise ValueError('Expected Counter to have exactly 1 generic parameter')
+        args = (args[0], int)  # keys are always an int
+    elif len(args) != 2:
+        raise ValueError('Expected mapping to have exactly 2 generic parameters')
+
+    keys_source_type, values_source_type = args
+
+    metadata, remaining_annotations = _known_annotated_metadata.collect_known_metadata(annotations)
+    _known_annotated_metadata.check_metadata(metadata, _known_annotated_metadata.SEQUENCE_CONSTRAINTS, source_type)
+
+    return (
+        source_type,
+        [
+            MappingValidator(mapped_origin, keys_source_type, values_source_type, **metadata),
+            *remaining_annotations,
+        ],
+    )
+
+
+def ip_prepare_pydantic_annotations(
+    source_type: Any, annotations: Iterable[Any], _config: ConfigDict
+) -> tuple[Any, list[Any]] | None:
+    def make_strict_ip_schema(tp: type[Any]) -> CoreSchema:
+        return core_schema.json_or_python_schema(
+            json_schema=core_schema.no_info_after_validator_function(tp, core_schema.str_schema()),
+            python_schema=core_schema.is_instance_schema(tp),
+        )
+
+    if source_type is IPv4Address:
+        return source_type, [
+            SchemaTransformer(
+                lambda _1, _2: core_schema.lax_or_strict_schema(
+                    lax_schema=core_schema.no_info_plain_validator_function(_validators.ip_v4_address_validator),
+                    strict_schema=make_strict_ip_schema(IPv4Address),
+                    serialization=core_schema.to_string_ser_schema(),
+                ),
+                lambda _1, _2: {'type': 'string', 'format': 'ipv4'},
+            ),
+            *annotations,
+        ]
+    if source_type is IPv4Network:
+        return source_type, [
+            SchemaTransformer(
+                lambda _1, _2: core_schema.lax_or_strict_schema(
+                    lax_schema=core_schema.no_info_plain_validator_function(_validators.ip_v4_network_validator),
+                    strict_schema=make_strict_ip_schema(IPv4Network),
+                    serialization=core_schema.to_string_ser_schema(),
+                ),
+                lambda _1, _2: {'type': 'string', 'format': 'ipv4network'},
+            ),
+            *annotations,
+        ]
+    if source_type is IPv4Interface:
+        return source_type, [
+            SchemaTransformer(
+                lambda _1, _2: core_schema.lax_or_strict_schema(
+                    lax_schema=core_schema.no_info_plain_validator_function(_validators.ip_v4_interface_validator),
+                    strict_schema=make_strict_ip_schema(IPv4Interface),
+                    serialization=core_schema.to_string_ser_schema(),
+                ),
+                lambda _1, _2: {'type': 'string', 'format': 'ipv4interface'},
+            ),
+            *annotations,
+        ]
+
+    if source_type is IPv6Address:
+        return source_type, [
+            SchemaTransformer(
+                lambda _1, _2: core_schema.lax_or_strict_schema(
+                    lax_schema=core_schema.no_info_plain_validator_function(_validators.ip_v6_address_validator),
+                    strict_schema=make_strict_ip_schema(IPv6Address),
+                    serialization=core_schema.to_string_ser_schema(),
+                ),
+                lambda _1, _2: {'type': 'string', 'format': 'ipv6'},
+            ),
+            *annotations,
+        ]
+    if source_type is IPv6Network:
+        return source_type, [
+            SchemaTransformer(
+                lambda _1, _2: core_schema.lax_or_strict_schema(
+                    lax_schema=core_schema.no_info_plain_validator_function(_validators.ip_v6_network_validator),
+                    strict_schema=make_strict_ip_schema(IPv6Network),
+                    serialization=core_schema.to_string_ser_schema(),
+                ),
+                lambda _1, _2: {'type': 'string', 'format': 'ipv6network'},
+            ),
+            *annotations,
+        ]
+    if source_type is IPv6Interface:
+        return source_type, [
+            SchemaTransformer(
+                lambda _1, _2: core_schema.lax_or_strict_schema(
+                    lax_schema=core_schema.no_info_plain_validator_function(_validators.ip_v6_interface_validator),
+                    strict_schema=make_strict_ip_schema(IPv6Interface),
+                    serialization=core_schema.to_string_ser_schema(),
+                ),
+                lambda _1, _2: {'type': 'string', 'format': 'ipv6interface'},
+            ),
+            *annotations,
+        ]
+
+    return None
+
+
+def url_prepare_pydantic_annotations(
+    source_type: Any, annotations: Iterable[Any], _config: ConfigDict
+) -> tuple[Any, list[Any]] | None:
+    if source_type is Url:
+        return source_type, [
+            SchemaTransformer(
+                lambda _1, _2: core_schema.url_schema(),
+                lambda cs, handler: handler(cs),
+            ),
+            *annotations,
+        ]
+    if source_type is MultiHostUrl:
+        return source_type, [
+            SchemaTransformer(
+                lambda _1, _2: core_schema.multi_host_url_schema(),
+                lambda cs, handler: handler(cs),
+            ),
+            *annotations,
+        ]
+
+
+PREPARE_METHODS: tuple[Callable[[Any, Iterable[Any], ConfigDict], tuple[Any, list[Any]] | None], ...] = (
+    decimal_prepare_pydantic_annotations,
+    sequence_like_prepare_pydantic_annotations,
+    datetime_prepare_pydantic_annotations,
+    uuid_prepare_pydantic_annotations,
+    path_schema_prepare_pydantic_annotations,
+    mapping_like_prepare_pydantic_annotations,
+    ip_prepare_pydantic_annotations,
+    url_prepare_pydantic_annotations,
+)
diff --git a/lib/pydantic/_internal/_typing_extra.py b/lib/pydantic/_internal/_typing_extra.py
new file mode 100644
index 00000000..1d5d3b3f
--- /dev/null
+++ b/lib/pydantic/_internal/_typing_extra.py
@@ -0,0 +1,469 @@
+"""Logic for interacting with type annotations, mostly extensions, shims and hacks to wrap python's typing module."""
+from __future__ import annotations as _annotations
+
+import dataclasses
+import sys
+import types
+import typing
+from collections.abc import Callable
+from functools import partial
+from types import GetSetDescriptorType
+from typing import TYPE_CHECKING, Any, Final
+
+from typing_extensions import Annotated, Literal, TypeAliasType, TypeGuard, get_args, get_origin
+
+if TYPE_CHECKING:
+    from ._dataclasses import StandardDataclass
+
+try:
+    from typing import _TypingBase  # type: ignore[attr-defined]
+except ImportError:
+    from typing import _Final as _TypingBase  # type: ignore[attr-defined]
+
+typing_base = _TypingBase
+
+
+if sys.version_info < (3, 9):
+    # python < 3.9 does not have GenericAlias (list[int], tuple[str, ...] and so on)
+    TypingGenericAlias = ()
+else:
+    from typing import GenericAlias as TypingGenericAlias  # type: ignore
+
+
+if sys.version_info < (3, 11):
+    from typing_extensions import NotRequired, Required
+else:
+    from typing import NotRequired, Required  # noqa: F401
+
+
+if sys.version_info < (3, 10):
+
+    def origin_is_union(tp: type[Any] | None) -> bool:
+        return tp is typing.Union
+
+    WithArgsTypes = (TypingGenericAlias,)
+
+else:
+
+    def origin_is_union(tp: type[Any] | None) -> bool:
+        return tp is typing.Union or tp is types.UnionType
+
+    WithArgsTypes = typing._GenericAlias, types.GenericAlias, types.UnionType  # type: ignore[attr-defined]
+
+
+if sys.version_info < (3, 10):
+    NoneType = type(None)
+    EllipsisType = type(Ellipsis)
+else:
+    from types import NoneType as NoneType
+
+
+LITERAL_TYPES: set[Any] = {Literal}
+if hasattr(typing, 'Literal'):
+    LITERAL_TYPES.add(typing.Literal)  # type: ignore
+
+NONE_TYPES: tuple[Any, ...] = (None, NoneType, *(tp[None] for tp in LITERAL_TYPES))
+
+
+TypeVarType = Any  # since mypy doesn't allow the use of TypeVar as a type
+
+
+def is_none_type(type_: Any) -> bool:
+    return type_ in NONE_TYPES
+
+
+def is_callable_type(type_: type[Any]) -> bool:
+    return type_ is Callable or get_origin(type_) is Callable
+
+
+def is_literal_type(type_: type[Any]) -> bool:
+    return Literal is not None and get_origin(type_) in LITERAL_TYPES
+
+
+def literal_values(type_: type[Any]) -> tuple[Any, ...]:
+    return get_args(type_)
+
+
+def all_literal_values(type_: type[Any]) -> list[Any]:
+    """This method is used to retrieve all Literal values as
+    Literal can be used recursively (see https://www.python.org/dev/peps/pep-0586)
+    e.g. `Literal[Literal[Literal[1, 2, 3], "foo"], 5, None]`.
+    """
+    if not is_literal_type(type_):
+        return [type_]
+
+    values = literal_values(type_)
+    return list(x for value in values for x in all_literal_values(value))
+
+
+def is_annotated(ann_type: Any) -> bool:
+    from ._utils import lenient_issubclass
+
+    origin = get_origin(ann_type)
+    return origin is not None and lenient_issubclass(origin, Annotated)
+
+
+def is_namedtuple(type_: type[Any]) -> bool:
+    """Check if a given class is a named tuple.
+    It can be either a `typing.NamedTuple` or `collections.namedtuple`.
+    """
+    from ._utils import lenient_issubclass
+
+    return lenient_issubclass(type_, tuple) and hasattr(type_, '_fields')
+
+
+test_new_type = typing.NewType('test_new_type', str)
+
+
+def is_new_type(type_: type[Any]) -> bool:
+    """Check whether type_ was created using typing.NewType.
+
+    Can't use isinstance because it fails <3.10.
+    """
+    return isinstance(type_, test_new_type.__class__) and hasattr(type_, '__supertype__')  # type: ignore[arg-type]
+
+
+def _check_classvar(v: type[Any] | None) -> bool:
+    if v is None:
+        return False
+
+    return v.__class__ == typing.ClassVar.__class__ and getattr(v, '_name', None) == 'ClassVar'
+
+
+def is_classvar(ann_type: type[Any]) -> bool:
+    if _check_classvar(ann_type) or _check_classvar(get_origin(ann_type)):
+        return True
+
+    # this is an ugly workaround for class vars that contain forward references and are therefore themselves
+    # forward references, see #3679
+    if ann_type.__class__ == typing.ForwardRef and ann_type.__forward_arg__.startswith('ClassVar['):  # type: ignore
+        return True
+
+    return False
+
+
+def _check_finalvar(v: type[Any] | None) -> bool:
+    """Check if a given type is a `typing.Final` type."""
+    if v is None:
+        return False
+
+    return v.__class__ == Final.__class__ and (sys.version_info < (3, 8) or getattr(v, '_name', None) == 'Final')
+
+
+def is_finalvar(ann_type: Any) -> bool:
+    return _check_finalvar(ann_type) or _check_finalvar(get_origin(ann_type))
+
+
+def parent_frame_namespace(*, parent_depth: int = 2) -> dict[str, Any] | None:
+    """We allow use of items in parent namespace to get around the issue with `get_type_hints` only looking in the
+    global module namespace. See https://github.com/pydantic/pydantic/issues/2678#issuecomment-1008139014 -> Scope
+    and suggestion at the end of the next comment by @gvanrossum.
+
+    WARNING 1: it matters exactly where this is called. By default, this function will build a namespace from the
+    parent of where it is called.
+
+    WARNING 2: this only looks in the parent namespace, not other parents since (AFAIK) there's no way to collect a
+    dict of exactly what's in scope. Using `f_back` would work sometimes but would be very wrong and confusing in many
+    other cases. See https://discuss.python.org/t/is-there-a-way-to-access-parent-nested-namespaces/20659.
+    """
+    frame = sys._getframe(parent_depth)
+    # if f_back is None, it's the global module namespace and we don't need to include it here
+    if frame.f_back is None:
+        return None
+    else:
+        return frame.f_locals
+
+
+def add_module_globals(obj: Any, globalns: dict[str, Any] | None = None) -> dict[str, Any]:
+    module_name = getattr(obj, '__module__', None)
+    if module_name:
+        try:
+            module_globalns = sys.modules[module_name].__dict__
+        except KeyError:
+            # happens occasionally, see https://github.com/pydantic/pydantic/issues/2363
+            pass
+        else:
+            if globalns:
+                return {**module_globalns, **globalns}
+            else:
+                # copy module globals to make sure it can't be updated later
+                return module_globalns.copy()
+
+    return globalns or {}
+
+
+def get_cls_types_namespace(cls: type[Any], parent_namespace: dict[str, Any] | None = None) -> dict[str, Any]:
+    ns = add_module_globals(cls, parent_namespace)
+    ns[cls.__name__] = cls
+    return ns
+
+
+def get_cls_type_hints_lenient(obj: Any, globalns: dict[str, Any] | None = None) -> dict[str, Any]:
+    """Collect annotations from a class, including those from parent classes.
+
+    Unlike `typing.get_type_hints`, this function will not error if a forward reference is not resolvable.
+    """
+    hints = {}
+    for base in reversed(obj.__mro__):
+        ann = base.__dict__.get('__annotations__')
+        localns = dict(vars(base))
+        if ann is not None and ann is not GetSetDescriptorType:
+            for name, value in ann.items():
+                hints[name] = eval_type_lenient(value, globalns, localns)
+    return hints
+
+
+def eval_type_lenient(value: Any, globalns: dict[str, Any] | None = None, localns: dict[str, Any] | None = None) -> Any:
+    """Behaves like typing._eval_type, except it won't raise an error if a forward reference can't be resolved."""
+    if value is None:
+        value = NoneType
+    elif isinstance(value, str):
+        value = _make_forward_ref(value, is_argument=False, is_class=True)
+
+    try:
+        return eval_type_backport(value, globalns, localns)
+    except NameError:
+        # the point of this function is to be tolerant to this case
+        return value
+
+
+def eval_type_backport(
+    value: Any, globalns: dict[str, Any] | None = None, localns: dict[str, Any] | None = None
+) -> Any:
+    """Like `typing._eval_type`, but falls back to the `eval_type_backport` package if it's
+    installed to let older Python versions use newer typing features.
+    Specifically, this transforms `X | Y` into `typing.Union[X, Y]`
+    and `list[X]` into `typing.List[X]` etc. (for all the types made generic in PEP 585)
+    if the original syntax is not supported in the current Python version.
+    """
+    try:
+        return typing._eval_type(  # type: ignore
+            value, globalns, localns
+        )
+    except TypeError as e:
+        if not (isinstance(value, typing.ForwardRef) and is_backport_fixable_error(e)):
+            raise
+        try:
+            from eval_type_backport import eval_type_backport
+        except ImportError:
+            raise TypeError(
+                f'You have a type annotation {value.__forward_arg__!r} '
+                f'which makes use of newer typing features than are supported in your version of Python. '
+                f'To handle this error, you should either remove the use of new syntax '
+                f'or install the `eval_type_backport` package.'
+            ) from e
+
+        return eval_type_backport(value, globalns, localns, try_default=False)
+
+
+def is_backport_fixable_error(e: TypeError) -> bool:
+    msg = str(e)
+    return msg.startswith('unsupported operand type(s) for |: ') or "' object is not subscriptable" in msg
+
+
+def get_function_type_hints(
+    function: Callable[..., Any], *, include_keys: set[str] | None = None, types_namespace: dict[str, Any] | None = None
+) -> dict[str, Any]:
+    """Like `typing.get_type_hints`, but doesn't convert `X` to `Optional[X]` if the default value is `None`, also
+    copes with `partial`.
+    """
+    if isinstance(function, partial):
+        annotations = function.func.__annotations__
+    else:
+        annotations = function.__annotations__
+
+    globalns = add_module_globals(function)
+    type_hints = {}
+    for name, value in annotations.items():
+        if include_keys is not None and name not in include_keys:
+            continue
+        if value is None:
+            value = NoneType
+        elif isinstance(value, str):
+            value = _make_forward_ref(value)
+
+        type_hints[name] = eval_type_backport(value, globalns, types_namespace)
+
+    return type_hints
+
+
+if sys.version_info < (3, 9, 8) or (3, 10) <= sys.version_info < (3, 10, 1):
+
+    def _make_forward_ref(
+        arg: Any,
+        is_argument: bool = True,
+        *,
+        is_class: bool = False,
+    ) -> typing.ForwardRef:
+        """Wrapper for ForwardRef that accounts for the `is_class` argument missing in older versions.
+        The `module` argument is omitted as it breaks <3.9.8, =3.10.0 and isn't used in the calls below.
+
+        See https://github.com/python/cpython/pull/28560 for some background.
+        The backport happened on 3.9.8, see:
+        https://github.com/pydantic/pydantic/discussions/6244#discussioncomment-6275458,
+        and on 3.10.1 for the 3.10 branch, see:
+        https://github.com/pydantic/pydantic/issues/6912
+
+        Implemented as EAFP with memory.
+        """
+        return typing.ForwardRef(arg, is_argument)
+
+else:
+    _make_forward_ref = typing.ForwardRef
+
+
+if sys.version_info >= (3, 10):
+    get_type_hints = typing.get_type_hints
+
+else:
+    """
+    For older versions of python, we have a custom implementation of `get_type_hints` which is a close as possible to
+    the implementation in CPython 3.10.8.
+    """
+
+    @typing.no_type_check
+    def get_type_hints(  # noqa: C901
+        obj: Any,
+        globalns: dict[str, Any] | None = None,
+        localns: dict[str, Any] | None = None,
+        include_extras: bool = False,
+    ) -> dict[str, Any]:  # pragma: no cover
+        """Taken verbatim from python 3.10.8 unchanged, except:
+        * type annotations of the function definition above.
+        * prefixing `typing.` where appropriate
+        * Use `_make_forward_ref` instead of `typing.ForwardRef` to handle the `is_class` argument.
+
+        https://github.com/python/cpython/blob/aaaf5174241496afca7ce4d4584570190ff972fe/Lib/typing.py#L1773-L1875
+
+        DO NOT CHANGE THIS METHOD UNLESS ABSOLUTELY NECESSARY.
+        ======================================================
+
+        Return type hints for an object.
+
+        This is often the same as obj.__annotations__, but it handles
+        forward references encoded as string literals, adds Optional[t] if a
+        default value equal to None is set and recursively replaces all
+        'Annotated[T, ...]' with 'T' (unless 'include_extras=True').
+
+        The argument may be a module, class, method, or function. The annotations
+        are returned as a dictionary. For classes, annotations include also
+        inherited members.
+
+        TypeError is raised if the argument is not of a type that can contain
+        annotations, and an empty dictionary is returned if no annotations are
+        present.
+
+        BEWARE -- the behavior of globalns and localns is counterintuitive
+        (unless you are familiar with how eval() and exec() work).  The
+        search order is locals first, then globals.
+
+        - If no dict arguments are passed, an attempt is made to use the
+          globals from obj (or the respective module's globals for classes),
+          and these are also used as the locals.  If the object does not appear
+          to have globals, an empty dictionary is used.  For classes, the search
+          order is globals first then locals.
+
+        - If one dict argument is passed, it is used for both globals and
+          locals.
+
+        - If two dict arguments are passed, they specify globals and
+          locals, respectively.
+        """
+        if getattr(obj, '__no_type_check__', None):
+            return {}
+        # Classes require a special treatment.
+        if isinstance(obj, type):
+            hints = {}
+            for base in reversed(obj.__mro__):
+                if globalns is None:
+                    base_globals = getattr(sys.modules.get(base.__module__, None), '__dict__', {})
+                else:
+                    base_globals = globalns
+                ann = base.__dict__.get('__annotations__', {})
+                if isinstance(ann, types.GetSetDescriptorType):
+                    ann = {}
+                base_locals = dict(vars(base)) if localns is None else localns
+                if localns is None and globalns is None:
+                    # This is surprising, but required.  Before Python 3.10,
+                    # get_type_hints only evaluated the globalns of
+                    # a class.  To maintain backwards compatibility, we reverse
+                    # the globalns and localns order so that eval() looks into
+                    # *base_globals* first rather than *base_locals*.
+                    # This only affects ForwardRefs.
+                    base_globals, base_locals = base_locals, base_globals
+                for name, value in ann.items():
+                    if value is None:
+                        value = type(None)
+                    if isinstance(value, str):
+                        value = _make_forward_ref(value, is_argument=False, is_class=True)
+
+                    value = eval_type_backport(value, base_globals, base_locals)
+                    hints[name] = value
+            if not include_extras and hasattr(typing, '_strip_annotations'):
+                return {
+                    k: typing._strip_annotations(t)  # type: ignore
+                    for k, t in hints.items()
+                }
+            else:
+                return hints
+
+        if globalns is None:
+            if isinstance(obj, types.ModuleType):
+                globalns = obj.__dict__
+            else:
+                nsobj = obj
+                # Find globalns for the unwrapped object.
+                while hasattr(nsobj, '__wrapped__'):
+                    nsobj = nsobj.__wrapped__
+                globalns = getattr(nsobj, '__globals__', {})
+            if localns is None:
+                localns = globalns
+        elif localns is None:
+            localns = globalns
+        hints = getattr(obj, '__annotations__', None)
+        if hints is None:
+            # Return empty annotations for something that _could_ have them.
+            if isinstance(obj, typing._allowed_types):  # type: ignore
+                return {}
+            else:
+                raise TypeError(f'{obj!r} is not a module, class, method, ' 'or function.')
+        defaults = typing._get_defaults(obj)  # type: ignore
+        hints = dict(hints)
+        for name, value in hints.items():
+            if value is None:
+                value = type(None)
+            if isinstance(value, str):
+                # class-level forward refs were handled above, this must be either
+                # a module-level annotation or a function argument annotation
+
+                value = _make_forward_ref(
+                    value,
+                    is_argument=not isinstance(obj, types.ModuleType),
+                    is_class=False,
+                )
+            value = eval_type_backport(value, globalns, localns)
+            if name in defaults and defaults[name] is None:
+                value = typing.Optional[value]
+            hints[name] = value
+        return hints if include_extras else {k: typing._strip_annotations(t) for k, t in hints.items()}  # type: ignore
+
+
+def is_dataclass(_cls: type[Any]) -> TypeGuard[type[StandardDataclass]]:
+    # The dataclasses.is_dataclass function doesn't seem to provide TypeGuard functionality,
+    # so I created this convenience function
+    return dataclasses.is_dataclass(_cls)
+
+
+def origin_is_type_alias_type(origin: Any) -> TypeGuard[TypeAliasType]:
+    return isinstance(origin, TypeAliasType)
+
+
+if sys.version_info >= (3, 10):
+
+    def is_generic_alias(type_: type[Any]) -> bool:
+        return isinstance(type_, (types.GenericAlias, typing._GenericAlias))  # type: ignore[attr-defined]
+
+else:
+
+    def is_generic_alias(type_: type[Any]) -> bool:
+        return isinstance(type_, typing._GenericAlias)  # type: ignore
diff --git a/lib/pydantic/_internal/_utils.py b/lib/pydantic/_internal/_utils.py
new file mode 100644
index 00000000..31f5b2c5
--- /dev/null
+++ b/lib/pydantic/_internal/_utils.py
@@ -0,0 +1,362 @@
+"""Bucket of reusable internal utilities.
+
+This should be reduced as much as possible with functions only used in one place, moved to that place.
+"""
+from __future__ import annotations as _annotations
+
+import dataclasses
+import keyword
+import typing
+import weakref
+from collections import OrderedDict, defaultdict, deque
+from copy import deepcopy
+from itertools import zip_longest
+from types import BuiltinFunctionType, CodeType, FunctionType, GeneratorType, LambdaType, ModuleType
+from typing import Any, Mapping, TypeVar
+
+from typing_extensions import TypeAlias, TypeGuard
+
+from . import _repr, _typing_extra
+
+if typing.TYPE_CHECKING:
+    MappingIntStrAny: TypeAlias = 'typing.Mapping[int, Any] | typing.Mapping[str, Any]'
+    AbstractSetIntStr: TypeAlias = 'typing.AbstractSet[int] | typing.AbstractSet[str]'
+    from ..main import BaseModel
+
+
+# these are types that are returned unchanged by deepcopy
+IMMUTABLE_NON_COLLECTIONS_TYPES: set[type[Any]] = {
+    int,
+    float,
+    complex,
+    str,
+    bool,
+    bytes,
+    type,
+    _typing_extra.NoneType,
+    FunctionType,
+    BuiltinFunctionType,
+    LambdaType,
+    weakref.ref,
+    CodeType,
+    # note: including ModuleType will differ from behaviour of deepcopy by not producing error.
+    # It might be not a good idea in general, but considering that this function used only internally
+    # against default values of fields, this will allow to actually have a field with module as default value
+    ModuleType,
+    NotImplemented.__class__,
+    Ellipsis.__class__,
+}
+
+# these are types that if empty, might be copied with simple copy() instead of deepcopy()
+BUILTIN_COLLECTIONS: set[type[Any]] = {
+    list,
+    set,
+    tuple,
+    frozenset,
+    dict,
+    OrderedDict,
+    defaultdict,
+    deque,
+}
+
+
+def sequence_like(v: Any) -> bool:
+    return isinstance(v, (list, tuple, set, frozenset, GeneratorType, deque))
+
+
+def lenient_isinstance(o: Any, class_or_tuple: type[Any] | tuple[type[Any], ...] | None) -> bool:  # pragma: no cover
+    try:
+        return isinstance(o, class_or_tuple)  # type: ignore[arg-type]
+    except TypeError:
+        return False
+
+
+def lenient_issubclass(cls: Any, class_or_tuple: Any) -> bool:  # pragma: no cover
+    try:
+        return isinstance(cls, type) and issubclass(cls, class_or_tuple)
+    except TypeError:
+        if isinstance(cls, _typing_extra.WithArgsTypes):
+            return False
+        raise  # pragma: no cover
+
+
+def is_model_class(cls: Any) -> TypeGuard[type[BaseModel]]:
+    """Returns true if cls is a _proper_ subclass of BaseModel, and provides proper type-checking,
+    unlike raw calls to lenient_issubclass.
+    """
+    from ..main import BaseModel
+
+    return lenient_issubclass(cls, BaseModel) and cls is not BaseModel
+
+
+def is_valid_identifier(identifier: str) -> bool:
+    """Checks that a string is a valid identifier and not a Python keyword.
+    :param identifier: The identifier to test.
+    :return: True if the identifier is valid.
+    """
+    return identifier.isidentifier() and not keyword.iskeyword(identifier)
+
+
+KeyType = TypeVar('KeyType')
+
+
+def deep_update(mapping: dict[KeyType, Any], *updating_mappings: dict[KeyType, Any]) -> dict[KeyType, Any]:
+    updated_mapping = mapping.copy()
+    for updating_mapping in updating_mappings:
+        for k, v in updating_mapping.items():
+            if k in updated_mapping and isinstance(updated_mapping[k], dict) and isinstance(v, dict):
+                updated_mapping[k] = deep_update(updated_mapping[k], v)
+            else:
+                updated_mapping[k] = v
+    return updated_mapping
+
+
+def update_not_none(mapping: dict[Any, Any], **update: Any) -> None:
+    mapping.update({k: v for k, v in update.items() if v is not None})
+
+
+T = TypeVar('T')
+
+
+def unique_list(
+    input_list: list[T] | tuple[T, ...],
+    *,
+    name_factory: typing.Callable[[T], str] = str,
+) -> list[T]:
+    """Make a list unique while maintaining order.
+    We update the list if another one with the same name is set
+    (e.g. model validator overridden in subclass).
+    """
+    result: list[T] = []
+    result_names: list[str] = []
+    for v in input_list:
+        v_name = name_factory(v)
+        if v_name not in result_names:
+            result_names.append(v_name)
+            result.append(v)
+        else:
+            result[result_names.index(v_name)] = v
+
+    return result
+
+
+class ValueItems(_repr.Representation):
+    """Class for more convenient calculation of excluded or included fields on values."""
+
+    __slots__ = ('_items', '_type')
+
+    def __init__(self, value: Any, items: AbstractSetIntStr | MappingIntStrAny) -> None:
+        items = self._coerce_items(items)
+
+        if isinstance(value, (list, tuple)):
+            items = self._normalize_indexes(items, len(value))  # type: ignore
+
+        self._items: MappingIntStrAny = items  # type: ignore
+
+    def is_excluded(self, item: Any) -> bool:
+        """Check if item is fully excluded.
+
+        :param item: key or index of a value
+        """
+        return self.is_true(self._items.get(item))
+
+    def is_included(self, item: Any) -> bool:
+        """Check if value is contained in self._items.
+
+        :param item: key or index of value
+        """
+        return item in self._items
+
+    def for_element(self, e: int | str) -> AbstractSetIntStr | MappingIntStrAny | None:
+        """:param e: key or index of element on value
+        :return: raw values for element if self._items is dict and contain needed element
+        """
+        item = self._items.get(e)  # type: ignore
+        return item if not self.is_true(item) else None
+
+    def _normalize_indexes(self, items: MappingIntStrAny, v_length: int) -> dict[int | str, Any]:
+        """:param items: dict or set of indexes which will be normalized
+        :param v_length: length of sequence indexes of which will be
+
+        >>> self._normalize_indexes({0: True, -2: True, -1: True}, 4)
+        {0: True, 2: True, 3: True}
+        >>> self._normalize_indexes({'__all__': True}, 4)
+        {0: True, 1: True, 2: True, 3: True}
+        """
+        normalized_items: dict[int | str, Any] = {}
+        all_items = None
+        for i, v in items.items():
+            if not (isinstance(v, typing.Mapping) or isinstance(v, typing.AbstractSet) or self.is_true(v)):
+                raise TypeError(f'Unexpected type of exclude value for index "{i}" {v.__class__}')
+            if i == '__all__':
+                all_items = self._coerce_value(v)
+                continue
+            if not isinstance(i, int):
+                raise TypeError(
+                    'Excluding fields from a sequence of sub-models or dicts must be performed index-wise: '
+                    'expected integer keys or keyword "__all__"'
+                )
+            normalized_i = v_length + i if i < 0 else i
+            normalized_items[normalized_i] = self.merge(v, normalized_items.get(normalized_i))
+
+        if not all_items:
+            return normalized_items
+        if self.is_true(all_items):
+            for i in range(v_length):
+                normalized_items.setdefault(i, ...)
+            return normalized_items
+        for i in range(v_length):
+            normalized_item = normalized_items.setdefault(i, {})
+            if not self.is_true(normalized_item):
+                normalized_items[i] = self.merge(all_items, normalized_item)
+        return normalized_items
+
+    @classmethod
+    def merge(cls, base: Any, override: Any, intersect: bool = False) -> Any:
+        """Merge a `base` item with an `override` item.
+
+        Both `base` and `override` are converted to dictionaries if possible.
+        Sets are converted to dictionaries with the sets entries as keys and
+        Ellipsis as values.
+
+        Each key-value pair existing in `base` is merged with `override`,
+        while the rest of the key-value pairs are updated recursively with this function.
+
+        Merging takes place based on the "union" of keys if `intersect` is
+        set to `False` (default) and on the intersection of keys if
+        `intersect` is set to `True`.
+        """
+        override = cls._coerce_value(override)
+        base = cls._coerce_value(base)
+        if override is None:
+            return base
+        if cls.is_true(base) or base is None:
+            return override
+        if cls.is_true(override):
+            return base if intersect else override
+
+        # intersection or union of keys while preserving ordering:
+        if intersect:
+            merge_keys = [k for k in base if k in override] + [k for k in override if k in base]
+        else:
+            merge_keys = list(base) + [k for k in override if k not in base]
+
+        merged: dict[int | str, Any] = {}
+        for k in merge_keys:
+            merged_item = cls.merge(base.get(k), override.get(k), intersect=intersect)
+            if merged_item is not None:
+                merged[k] = merged_item
+
+        return merged
+
+    @staticmethod
+    def _coerce_items(items: AbstractSetIntStr | MappingIntStrAny) -> MappingIntStrAny:
+        if isinstance(items, typing.Mapping):
+            pass
+        elif isinstance(items, typing.AbstractSet):
+            items = dict.fromkeys(items, ...)  # type: ignore
+        else:
+            class_name = getattr(items, '__class__', '???')
+            raise TypeError(f'Unexpected type of exclude value {class_name}')
+        return items  # type: ignore
+
+    @classmethod
+    def _coerce_value(cls, value: Any) -> Any:
+        if value is None or cls.is_true(value):
+            return value
+        return cls._coerce_items(value)
+
+    @staticmethod
+    def is_true(v: Any) -> bool:
+        return v is True or v is ...
+
+    def __repr_args__(self) -> _repr.ReprArgs:
+        return [(None, self._items)]
+
+
+if typing.TYPE_CHECKING:
+
+    def ClassAttribute(name: str, value: T) -> T:
+        ...
+
+else:
+
+    class ClassAttribute:
+        """Hide class attribute from its instances."""
+
+        __slots__ = 'name', 'value'
+
+        def __init__(self, name: str, value: Any) -> None:
+            self.name = name
+            self.value = value
+
+        def __get__(self, instance: Any, owner: type[Any]) -> None:
+            if instance is None:
+                return self.value
+            raise AttributeError(f'{self.name!r} attribute of {owner.__name__!r} is class-only')
+
+
+Obj = TypeVar('Obj')
+
+
+def smart_deepcopy(obj: Obj) -> Obj:
+    """Return type as is for immutable built-in types
+    Use obj.copy() for built-in empty collections
+    Use copy.deepcopy() for non-empty collections and unknown objects.
+    """
+    obj_type = obj.__class__
+    if obj_type in IMMUTABLE_NON_COLLECTIONS_TYPES:
+        return obj  # fastest case: obj is immutable and not collection therefore will not be copied anyway
+    try:
+        if not obj and obj_type in BUILTIN_COLLECTIONS:
+            # faster way for empty collections, no need to copy its members
+            return obj if obj_type is tuple else obj.copy()  # tuple doesn't have copy method  # type: ignore
+    except (TypeError, ValueError, RuntimeError):
+        # do we really dare to catch ALL errors? Seems a bit risky
+        pass
+
+    return deepcopy(obj)  # slowest way when we actually might need a deepcopy
+
+
+_SENTINEL = object()
+
+
+def all_identical(left: typing.Iterable[Any], right: typing.Iterable[Any]) -> bool:
+    """Check that the items of `left` are the same objects as those in `right`.
+
+    >>> a, b = object(), object()
+    >>> all_identical([a, b, a], [a, b, a])
+    True
+    >>> all_identical([a, b, [a]], [a, b, [a]])  # new list object, while "equal" is not "identical"
+    False
+    """
+    for left_item, right_item in zip_longest(left, right, fillvalue=_SENTINEL):
+        if left_item is not right_item:
+            return False
+    return True
+
+
+@dataclasses.dataclass(frozen=True)
+class SafeGetItemProxy:
+    """Wrapper redirecting `__getitem__` to `get` with a sentinel value as default
+
+    This makes is safe to use in `operator.itemgetter` when some keys may be missing
+    """
+
+    # Define __slots__manually for performances
+    # @dataclasses.dataclass() only support slots=True in python>=3.10
+    __slots__ = ('wrapped',)
+
+    wrapped: Mapping[str, Any]
+
+    def __getitem__(self, __key: str) -> Any:
+        return self.wrapped.get(__key, _SENTINEL)
+
+    # required to pass the object to operator.itemgetter() instances due to a quirk of typeshed
+    # https://github.com/python/mypy/issues/13713
+    # https://github.com/python/typeshed/pull/8785
+    # Since this is typing-only, hide it in a typing.TYPE_CHECKING block
+    if typing.TYPE_CHECKING:
+
+        def __contains__(self, __key: str) -> bool:
+            return self.wrapped.__contains__(__key)
diff --git a/lib/pydantic/_internal/_validate_call.py b/lib/pydantic/_internal/_validate_call.py
new file mode 100644
index 00000000..664c0630
--- /dev/null
+++ b/lib/pydantic/_internal/_validate_call.py
@@ -0,0 +1,84 @@
+from __future__ import annotations as _annotations
+
+import inspect
+from functools import partial
+from typing import Any, Awaitable, Callable
+
+import pydantic_core
+
+from ..config import ConfigDict
+from ..plugin._schema_validator import create_schema_validator
+from . import _generate_schema, _typing_extra
+from ._config import ConfigWrapper
+
+
+class ValidateCallWrapper:
+    """This is a wrapper around a function that validates the arguments passed to it, and optionally the return value."""
+
+    __slots__ = (
+        '__pydantic_validator__',
+        '__name__',
+        '__qualname__',
+        '__annotations__',
+        '__dict__',  # required for __module__
+    )
+
+    def __init__(self, function: Callable[..., Any], config: ConfigDict | None, validate_return: bool):
+        if isinstance(function, partial):
+            func = function.func
+            schema_type = func
+            self.__name__ = f'partial({func.__name__})'
+            self.__qualname__ = f'partial({func.__qualname__})'
+            self.__module__ = func.__module__
+        else:
+            schema_type = function
+            self.__name__ = function.__name__
+            self.__qualname__ = function.__qualname__
+            self.__module__ = function.__module__
+
+        namespace = _typing_extra.add_module_globals(function, None)
+        config_wrapper = ConfigWrapper(config)
+        gen_schema = _generate_schema.GenerateSchema(config_wrapper, namespace)
+        schema = gen_schema.clean_schema(gen_schema.generate_schema(function))
+        core_config = config_wrapper.core_config(self)
+
+        self.__pydantic_validator__ = create_schema_validator(
+            schema,
+            schema_type,
+            self.__module__,
+            self.__qualname__,
+            'validate_call',
+            core_config,
+            config_wrapper.plugin_settings,
+        )
+
+        if validate_return:
+            signature = inspect.signature(function)
+            return_type = signature.return_annotation if signature.return_annotation is not signature.empty else Any
+            gen_schema = _generate_schema.GenerateSchema(config_wrapper, namespace)
+            schema = gen_schema.clean_schema(gen_schema.generate_schema(return_type))
+            validator = create_schema_validator(
+                schema,
+                schema_type,
+                self.__module__,
+                self.__qualname__,
+                'validate_call',
+                core_config,
+                config_wrapper.plugin_settings,
+            )
+            if inspect.iscoroutinefunction(function):
+
+                async def return_val_wrapper(aw: Awaitable[Any]) -> None:
+                    return validator.validate_python(await aw)
+
+                self.__return_pydantic_validator__ = return_val_wrapper
+            else:
+                self.__return_pydantic_validator__ = validator.validate_python
+        else:
+            self.__return_pydantic_validator__ = None
+
+    def __call__(self, *args: Any, **kwargs: Any) -> Any:
+        res = self.__pydantic_validator__.validate_python(pydantic_core.ArgsKwargs(args, kwargs))
+        if self.__return_pydantic_validator__:
+            return self.__return_pydantic_validator__(res)
+        return res
diff --git a/lib/pydantic/_internal/_validators.py b/lib/pydantic/_internal/_validators.py
new file mode 100644
index 00000000..7193fe5c
--- /dev/null
+++ b/lib/pydantic/_internal/_validators.py
@@ -0,0 +1,278 @@
+"""Validator functions for standard library types.
+
+Import of this module is deferred since it contains imports of many standard library modules.
+"""
+
+from __future__ import annotations as _annotations
+
+import math
+import re
+import typing
+from ipaddress import IPv4Address, IPv4Interface, IPv4Network, IPv6Address, IPv6Interface, IPv6Network
+from typing import Any
+
+from pydantic_core import PydanticCustomError, core_schema
+from pydantic_core._pydantic_core import PydanticKnownError
+
+
+def sequence_validator(
+    __input_value: typing.Sequence[Any],
+    validator: core_schema.ValidatorFunctionWrapHandler,
+) -> typing.Sequence[Any]:
+    """Validator for `Sequence` types, isinstance(v, Sequence) has already been called."""
+    value_type = type(__input_value)
+
+    # We don't accept any plain string as a sequence
+    # Relevant issue: https://github.com/pydantic/pydantic/issues/5595
+    if issubclass(value_type, (str, bytes)):
+        raise PydanticCustomError(
+            'sequence_str',
+            "'{type_name}' instances are not allowed as a Sequence value",
+            {'type_name': value_type.__name__},
+        )
+
+    v_list = validator(__input_value)
+
+    # the rest of the logic is just re-creating the original type from `v_list`
+    if value_type == list:
+        return v_list
+    elif issubclass(value_type, range):
+        # return the list as we probably can't re-create the range
+        return v_list
+    else:
+        # best guess at how to re-create the original type, more custom construction logic might be required
+        return value_type(v_list)  # type: ignore[call-arg]
+
+
+def import_string(value: Any) -> Any:
+    if isinstance(value, str):
+        try:
+            return _import_string_logic(value)
+        except ImportError as e:
+            raise PydanticCustomError('import_error', 'Invalid python path: {error}', {'error': str(e)}) from e
+    else:
+        # otherwise we just return the value and let the next validator do the rest of the work
+        return value
+
+
+def _import_string_logic(dotted_path: str) -> Any:
+    """Inspired by uvicorn — dotted paths should include a colon before the final item if that item is not a module.
+    (This is necessary to distinguish between a submodule and an attribute when there is a conflict.).
+
+    If the dotted path does not include a colon and the final item is not a valid module, importing as an attribute
+    rather than a submodule will be attempted automatically.
+
+    So, for example, the following values of `dotted_path` result in the following returned values:
+    * 'collections': <module 'collections'>
+    * 'collections.abc': <module 'collections.abc'>
+    * 'collections.abc:Mapping': <class 'collections.abc.Mapping'>
+    * `collections.abc.Mapping`: <class 'collections.abc.Mapping'> (though this is a bit slower than the previous line)
+
+    An error will be raised under any of the following scenarios:
+    * `dotted_path` contains more than one colon (e.g., 'collections:abc:Mapping')
+    * the substring of `dotted_path` before the colon is not a valid module in the environment (e.g., '123:Mapping')
+    * the substring of `dotted_path` after the colon is not an attribute of the module (e.g., 'collections:abc123')
+    """
+    from importlib import import_module
+
+    components = dotted_path.strip().split(':')
+    if len(components) > 2:
+        raise ImportError(f"Import strings should have at most one ':'; received {dotted_path!r}")
+
+    module_path = components[0]
+    if not module_path:
+        raise ImportError(f'Import strings should have a nonempty module name; received {dotted_path!r}')
+
+    try:
+        module = import_module(module_path)
+    except ModuleNotFoundError as e:
+        if '.' in module_path:
+            # Check if it would be valid if the final item was separated from its module with a `:`
+            maybe_module_path, maybe_attribute = dotted_path.strip().rsplit('.', 1)
+            try:
+                return _import_string_logic(f'{maybe_module_path}:{maybe_attribute}')
+            except ImportError:
+                pass
+            raise ImportError(f'No module named {module_path!r}') from e
+        raise e
+
+    if len(components) > 1:
+        attribute = components[1]
+        try:
+            return getattr(module, attribute)
+        except AttributeError as e:
+            raise ImportError(f'cannot import name {attribute!r} from {module_path!r}') from e
+    else:
+        return module
+
+
+def pattern_either_validator(__input_value: Any) -> typing.Pattern[Any]:
+    if isinstance(__input_value, typing.Pattern):
+        return __input_value
+    elif isinstance(__input_value, (str, bytes)):
+        # todo strict mode
+        return compile_pattern(__input_value)  # type: ignore
+    else:
+        raise PydanticCustomError('pattern_type', 'Input should be a valid pattern')
+
+
+def pattern_str_validator(__input_value: Any) -> typing.Pattern[str]:
+    if isinstance(__input_value, typing.Pattern):
+        if isinstance(__input_value.pattern, str):
+            return __input_value
+        else:
+            raise PydanticCustomError('pattern_str_type', 'Input should be a string pattern')
+    elif isinstance(__input_value, str):
+        return compile_pattern(__input_value)
+    elif isinstance(__input_value, bytes):
+        raise PydanticCustomError('pattern_str_type', 'Input should be a string pattern')
+    else:
+        raise PydanticCustomError('pattern_type', 'Input should be a valid pattern')
+
+
+def pattern_bytes_validator(__input_value: Any) -> typing.Pattern[bytes]:
+    if isinstance(__input_value, typing.Pattern):
+        if isinstance(__input_value.pattern, bytes):
+            return __input_value
+        else:
+            raise PydanticCustomError('pattern_bytes_type', 'Input should be a bytes pattern')
+    elif isinstance(__input_value, bytes):
+        return compile_pattern(__input_value)
+    elif isinstance(__input_value, str):
+        raise PydanticCustomError('pattern_bytes_type', 'Input should be a bytes pattern')
+    else:
+        raise PydanticCustomError('pattern_type', 'Input should be a valid pattern')
+
+
+PatternType = typing.TypeVar('PatternType', str, bytes)
+
+
+def compile_pattern(pattern: PatternType) -> typing.Pattern[PatternType]:
+    try:
+        return re.compile(pattern)
+    except re.error:
+        raise PydanticCustomError('pattern_regex', 'Input should be a valid regular expression')
+
+
+def ip_v4_address_validator(__input_value: Any) -> IPv4Address:
+    if isinstance(__input_value, IPv4Address):
+        return __input_value
+
+    try:
+        return IPv4Address(__input_value)
+    except ValueError:
+        raise PydanticCustomError('ip_v4_address', 'Input is not a valid IPv4 address')
+
+
+def ip_v6_address_validator(__input_value: Any) -> IPv6Address:
+    if isinstance(__input_value, IPv6Address):
+        return __input_value
+
+    try:
+        return IPv6Address(__input_value)
+    except ValueError:
+        raise PydanticCustomError('ip_v6_address', 'Input is not a valid IPv6 address')
+
+
+def ip_v4_network_validator(__input_value: Any) -> IPv4Network:
+    """Assume IPv4Network initialised with a default `strict` argument.
+
+    See more:
+    https://docs.python.org/library/ipaddress.html#ipaddress.IPv4Network
+    """
+    if isinstance(__input_value, IPv4Network):
+        return __input_value
+
+    try:
+        return IPv4Network(__input_value)
+    except ValueError:
+        raise PydanticCustomError('ip_v4_network', 'Input is not a valid IPv4 network')
+
+
+def ip_v6_network_validator(__input_value: Any) -> IPv6Network:
+    """Assume IPv6Network initialised with a default `strict` argument.
+
+    See more:
+    https://docs.python.org/library/ipaddress.html#ipaddress.IPv6Network
+    """
+    if isinstance(__input_value, IPv6Network):
+        return __input_value
+
+    try:
+        return IPv6Network(__input_value)
+    except ValueError:
+        raise PydanticCustomError('ip_v6_network', 'Input is not a valid IPv6 network')
+
+
+def ip_v4_interface_validator(__input_value: Any) -> IPv4Interface:
+    if isinstance(__input_value, IPv4Interface):
+        return __input_value
+
+    try:
+        return IPv4Interface(__input_value)
+    except ValueError:
+        raise PydanticCustomError('ip_v4_interface', 'Input is not a valid IPv4 interface')
+
+
+def ip_v6_interface_validator(__input_value: Any) -> IPv6Interface:
+    if isinstance(__input_value, IPv6Interface):
+        return __input_value
+
+    try:
+        return IPv6Interface(__input_value)
+    except ValueError:
+        raise PydanticCustomError('ip_v6_interface', 'Input is not a valid IPv6 interface')
+
+
+def greater_than_validator(x: Any, gt: Any) -> Any:
+    if not (x > gt):
+        raise PydanticKnownError('greater_than', {'gt': gt})
+    return x
+
+
+def greater_than_or_equal_validator(x: Any, ge: Any) -> Any:
+    if not (x >= ge):
+        raise PydanticKnownError('greater_than_equal', {'ge': ge})
+    return x
+
+
+def less_than_validator(x: Any, lt: Any) -> Any:
+    if not (x < lt):
+        raise PydanticKnownError('less_than', {'lt': lt})
+    return x
+
+
+def less_than_or_equal_validator(x: Any, le: Any) -> Any:
+    if not (x <= le):
+        raise PydanticKnownError('less_than_equal', {'le': le})
+    return x
+
+
+def multiple_of_validator(x: Any, multiple_of: Any) -> Any:
+    if not (x % multiple_of == 0):
+        raise PydanticKnownError('multiple_of', {'multiple_of': multiple_of})
+    return x
+
+
+def min_length_validator(x: Any, min_length: Any) -> Any:
+    if not (len(x) >= min_length):
+        raise PydanticKnownError(
+            'too_short',
+            {'field_type': 'Value', 'min_length': min_length, 'actual_length': len(x)},
+        )
+    return x
+
+
+def max_length_validator(x: Any, max_length: Any) -> Any:
+    if len(x) > max_length:
+        raise PydanticKnownError(
+            'too_long',
+            {'field_type': 'Value', 'max_length': max_length, 'actual_length': len(x)},
+        )
+    return x
+
+
+def forbid_inf_nan_check(x: Any) -> Any:
+    if not math.isfinite(x):
+        raise PydanticKnownError('finite_number')
+    return x
diff --git a/lib/pydantic/_migration.py b/lib/pydantic/_migration.py
new file mode 100644
index 00000000..c8478a62
--- /dev/null
+++ b/lib/pydantic/_migration.py
@@ -0,0 +1,308 @@
+import sys
+from typing import Any, Callable, Dict
+
+from .version import version_short
+
+MOVED_IN_V2 = {
+    'pydantic.utils:version_info': 'pydantic.version:version_info',
+    'pydantic.error_wrappers:ValidationError': 'pydantic:ValidationError',
+    'pydantic.utils:to_camel': 'pydantic.alias_generators:to_pascal',
+    'pydantic.utils:to_lower_camel': 'pydantic.alias_generators:to_camel',
+    'pydantic:PyObject': 'pydantic.types:ImportString',
+    'pydantic.types:PyObject': 'pydantic.types:ImportString',
+    'pydantic.generics:GenericModel': 'pydantic.BaseModel',
+}
+
+DEPRECATED_MOVED_IN_V2 = {
+    'pydantic.tools:schema_of': 'pydantic.deprecated.tools:schema_of',
+    'pydantic.tools:parse_obj_as': 'pydantic.deprecated.tools:parse_obj_as',
+    'pydantic.tools:schema_json_of': 'pydantic.deprecated.tools:schema_json_of',
+    'pydantic.json:pydantic_encoder': 'pydantic.deprecated.json:pydantic_encoder',
+    'pydantic:validate_arguments': 'pydantic.deprecated.decorator:validate_arguments',
+    'pydantic.json:custom_pydantic_encoder': 'pydantic.deprecated.json:custom_pydantic_encoder',
+    'pydantic.json:timedelta_isoformat': 'pydantic.deprecated.json:timedelta_isoformat',
+    'pydantic.decorator:validate_arguments': 'pydantic.deprecated.decorator:validate_arguments',
+    'pydantic.class_validators:validator': 'pydantic.deprecated.class_validators:validator',
+    'pydantic.class_validators:root_validator': 'pydantic.deprecated.class_validators:root_validator',
+    'pydantic.config:BaseConfig': 'pydantic.deprecated.config:BaseConfig',
+    'pydantic.config:Extra': 'pydantic.deprecated.config:Extra',
+}
+
+REDIRECT_TO_V1 = {
+    f'pydantic.utils:{obj}': f'pydantic.v1.utils:{obj}'
+    for obj in (
+        'deep_update',
+        'GetterDict',
+        'lenient_issubclass',
+        'lenient_isinstance',
+        'is_valid_field',
+        'update_not_none',
+        'import_string',
+        'Representation',
+        'ROOT_KEY',
+        'smart_deepcopy',
+        'sequence_like',
+    )
+}
+
+
+REMOVED_IN_V2 = {
+    'pydantic:ConstrainedBytes',
+    'pydantic:ConstrainedDate',
+    'pydantic:ConstrainedDecimal',
+    'pydantic:ConstrainedFloat',
+    'pydantic:ConstrainedFrozenSet',
+    'pydantic:ConstrainedInt',
+    'pydantic:ConstrainedList',
+    'pydantic:ConstrainedSet',
+    'pydantic:ConstrainedStr',
+    'pydantic:JsonWrapper',
+    'pydantic:NoneBytes',
+    'pydantic:NoneStr',
+    'pydantic:NoneStrBytes',
+    'pydantic:Protocol',
+    'pydantic:Required',
+    'pydantic:StrBytes',
+    'pydantic:compiled',
+    'pydantic.config:get_config',
+    'pydantic.config:inherit_config',
+    'pydantic.config:prepare_config',
+    'pydantic:create_model_from_namedtuple',
+    'pydantic:create_model_from_typeddict',
+    'pydantic.dataclasses:create_pydantic_model_from_dataclass',
+    'pydantic.dataclasses:make_dataclass_validator',
+    'pydantic.dataclasses:set_validation',
+    'pydantic.datetime_parse:parse_date',
+    'pydantic.datetime_parse:parse_time',
+    'pydantic.datetime_parse:parse_datetime',
+    'pydantic.datetime_parse:parse_duration',
+    'pydantic.error_wrappers:ErrorWrapper',
+    'pydantic.errors:AnyStrMaxLengthError',
+    'pydantic.errors:AnyStrMinLengthError',
+    'pydantic.errors:ArbitraryTypeError',
+    'pydantic.errors:BoolError',
+    'pydantic.errors:BytesError',
+    'pydantic.errors:CallableError',
+    'pydantic.errors:ClassError',
+    'pydantic.errors:ColorError',
+    'pydantic.errors:ConfigError',
+    'pydantic.errors:DataclassTypeError',
+    'pydantic.errors:DateError',
+    'pydantic.errors:DateNotInTheFutureError',
+    'pydantic.errors:DateNotInThePastError',
+    'pydantic.errors:DateTimeError',
+    'pydantic.errors:DecimalError',
+    'pydantic.errors:DecimalIsNotFiniteError',
+    'pydantic.errors:DecimalMaxDigitsError',
+    'pydantic.errors:DecimalMaxPlacesError',
+    'pydantic.errors:DecimalWholeDigitsError',
+    'pydantic.errors:DictError',
+    'pydantic.errors:DurationError',
+    'pydantic.errors:EmailError',
+    'pydantic.errors:EnumError',
+    'pydantic.errors:EnumMemberError',
+    'pydantic.errors:ExtraError',
+    'pydantic.errors:FloatError',
+    'pydantic.errors:FrozenSetError',
+    'pydantic.errors:FrozenSetMaxLengthError',
+    'pydantic.errors:FrozenSetMinLengthError',
+    'pydantic.errors:HashableError',
+    'pydantic.errors:IPv4AddressError',
+    'pydantic.errors:IPv4InterfaceError',
+    'pydantic.errors:IPv4NetworkError',
+    'pydantic.errors:IPv6AddressError',
+    'pydantic.errors:IPv6InterfaceError',
+    'pydantic.errors:IPv6NetworkError',
+    'pydantic.errors:IPvAnyAddressError',
+    'pydantic.errors:IPvAnyInterfaceError',
+    'pydantic.errors:IPvAnyNetworkError',
+    'pydantic.errors:IntEnumError',
+    'pydantic.errors:IntegerError',
+    'pydantic.errors:InvalidByteSize',
+    'pydantic.errors:InvalidByteSizeUnit',
+    'pydantic.errors:InvalidDiscriminator',
+    'pydantic.errors:InvalidLengthForBrand',
+    'pydantic.errors:JsonError',
+    'pydantic.errors:JsonTypeError',
+    'pydantic.errors:ListError',
+    'pydantic.errors:ListMaxLengthError',
+    'pydantic.errors:ListMinLengthError',
+    'pydantic.errors:ListUniqueItemsError',
+    'pydantic.errors:LuhnValidationError',
+    'pydantic.errors:MissingDiscriminator',
+    'pydantic.errors:MissingError',
+    'pydantic.errors:NoneIsAllowedError',
+    'pydantic.errors:NoneIsNotAllowedError',
+    'pydantic.errors:NotDigitError',
+    'pydantic.errors:NotNoneError',
+    'pydantic.errors:NumberNotGeError',
+    'pydantic.errors:NumberNotGtError',
+    'pydantic.errors:NumberNotLeError',
+    'pydantic.errors:NumberNotLtError',
+    'pydantic.errors:NumberNotMultipleError',
+    'pydantic.errors:PathError',
+    'pydantic.errors:PathNotADirectoryError',
+    'pydantic.errors:PathNotAFileError',
+    'pydantic.errors:PathNotExistsError',
+    'pydantic.errors:PatternError',
+    'pydantic.errors:PyObjectError',
+    'pydantic.errors:PydanticTypeError',
+    'pydantic.errors:PydanticValueError',
+    'pydantic.errors:SequenceError',
+    'pydantic.errors:SetError',
+    'pydantic.errors:SetMaxLengthError',
+    'pydantic.errors:SetMinLengthError',
+    'pydantic.errors:StrError',
+    'pydantic.errors:StrRegexError',
+    'pydantic.errors:StrictBoolError',
+    'pydantic.errors:SubclassError',
+    'pydantic.errors:TimeError',
+    'pydantic.errors:TupleError',
+    'pydantic.errors:TupleLengthError',
+    'pydantic.errors:UUIDError',
+    'pydantic.errors:UUIDVersionError',
+    'pydantic.errors:UrlError',
+    'pydantic.errors:UrlExtraError',
+    'pydantic.errors:UrlHostError',
+    'pydantic.errors:UrlHostTldError',
+    'pydantic.errors:UrlPortError',
+    'pydantic.errors:UrlSchemeError',
+    'pydantic.errors:UrlSchemePermittedError',
+    'pydantic.errors:UrlUserInfoError',
+    'pydantic.errors:WrongConstantError',
+    'pydantic.main:validate_model',
+    'pydantic.networks:stricturl',
+    'pydantic:parse_file_as',
+    'pydantic:parse_raw_as',
+    'pydantic:stricturl',
+    'pydantic.tools:parse_file_as',
+    'pydantic.tools:parse_raw_as',
+    'pydantic.types:ConstrainedBytes',
+    'pydantic.types:ConstrainedDate',
+    'pydantic.types:ConstrainedDecimal',
+    'pydantic.types:ConstrainedFloat',
+    'pydantic.types:ConstrainedFrozenSet',
+    'pydantic.types:ConstrainedInt',
+    'pydantic.types:ConstrainedList',
+    'pydantic.types:ConstrainedSet',
+    'pydantic.types:ConstrainedStr',
+    'pydantic.types:JsonWrapper',
+    'pydantic.types:NoneBytes',
+    'pydantic.types:NoneStr',
+    'pydantic.types:NoneStrBytes',
+    'pydantic.types:StrBytes',
+    'pydantic.typing:evaluate_forwardref',
+    'pydantic.typing:AbstractSetIntStr',
+    'pydantic.typing:AnyCallable',
+    'pydantic.typing:AnyClassMethod',
+    'pydantic.typing:CallableGenerator',
+    'pydantic.typing:DictAny',
+    'pydantic.typing:DictIntStrAny',
+    'pydantic.typing:DictStrAny',
+    'pydantic.typing:IntStr',
+    'pydantic.typing:ListStr',
+    'pydantic.typing:MappingIntStrAny',
+    'pydantic.typing:NoArgAnyCallable',
+    'pydantic.typing:NoneType',
+    'pydantic.typing:ReprArgs',
+    'pydantic.typing:SetStr',
+    'pydantic.typing:StrPath',
+    'pydantic.typing:TupleGenerator',
+    'pydantic.typing:WithArgsTypes',
+    'pydantic.typing:all_literal_values',
+    'pydantic.typing:display_as_type',
+    'pydantic.typing:get_all_type_hints',
+    'pydantic.typing:get_args',
+    'pydantic.typing:get_origin',
+    'pydantic.typing:get_sub_types',
+    'pydantic.typing:is_callable_type',
+    'pydantic.typing:is_classvar',
+    'pydantic.typing:is_finalvar',
+    'pydantic.typing:is_literal_type',
+    'pydantic.typing:is_namedtuple',
+    'pydantic.typing:is_new_type',
+    'pydantic.typing:is_none_type',
+    'pydantic.typing:is_typeddict',
+    'pydantic.typing:is_typeddict_special',
+    'pydantic.typing:is_union',
+    'pydantic.typing:new_type_supertype',
+    'pydantic.typing:resolve_annotations',
+    'pydantic.typing:typing_base',
+    'pydantic.typing:update_field_forward_refs',
+    'pydantic.typing:update_model_forward_refs',
+    'pydantic.utils:ClassAttribute',
+    'pydantic.utils:DUNDER_ATTRIBUTES',
+    'pydantic.utils:PyObjectStr',
+    'pydantic.utils:ValueItems',
+    'pydantic.utils:almost_equal_floats',
+    'pydantic.utils:get_discriminator_alias_and_values',
+    'pydantic.utils:get_model',
+    'pydantic.utils:get_unique_discriminator_alias',
+    'pydantic.utils:in_ipython',
+    'pydantic.utils:is_valid_identifier',
+    'pydantic.utils:path_type',
+    'pydantic.utils:validate_field_name',
+    'pydantic:validate_model',
+}
+
+
+def getattr_migration(module: str) -> Callable[[str], Any]:
+    """Implement PEP 562 for objects that were either moved or removed on the migration
+    to V2.
+
+    Args:
+        module: The module name.
+
+    Returns:
+        A callable that will raise an error if the object is not found.
+    """
+    # This avoids circular import with errors.py.
+    from .errors import PydanticImportError
+
+    def wrapper(name: str) -> object:
+        """Raise an error if the object is not found, or warn if it was moved.
+
+        In case it was moved, it still returns the object.
+
+        Args:
+            name: The object name.
+
+        Returns:
+            The object.
+        """
+        if name == '__path__':
+            raise AttributeError(f'module {module!r} has no attribute {name!r}')
+
+        import warnings
+
+        from ._internal._validators import import_string
+
+        import_path = f'{module}:{name}'
+        if import_path in MOVED_IN_V2.keys():
+            new_location = MOVED_IN_V2[import_path]
+            warnings.warn(f'`{import_path}` has been moved to `{new_location}`.')
+            return import_string(MOVED_IN_V2[import_path])
+        if import_path in DEPRECATED_MOVED_IN_V2:
+            # skip the warning here because a deprecation warning will be raised elsewhere
+            return import_string(DEPRECATED_MOVED_IN_V2[import_path])
+        if import_path in REDIRECT_TO_V1:
+            new_location = REDIRECT_TO_V1[import_path]
+            warnings.warn(
+                f'`{import_path}` has been removed. We are importing from `{new_location}` instead.'
+                'See the migration guide for more details: https://docs.pydantic.dev/latest/migration/'
+            )
+            return import_string(REDIRECT_TO_V1[import_path])
+        if import_path == 'pydantic:BaseSettings':
+            raise PydanticImportError(
+                '`BaseSettings` has been moved to the `pydantic-settings` package. '
+                f'See https://docs.pydantic.dev/{version_short()}/migration/#basesettings-has-moved-to-pydantic-settings '
+                'for more details.'
+            )
+        if import_path in REMOVED_IN_V2:
+            raise PydanticImportError(f'`{import_path}` has been removed in V2.')
+        globals: Dict[str, Any] = sys.modules[module].__dict__
+        if name in globals:
+            return globals[name]
+        raise AttributeError(f'module {module!r} has no attribute {name!r}')
+
+    return wrapper
diff --git a/lib/pydantic/alias_generators.py b/lib/pydantic/alias_generators.py
new file mode 100644
index 00000000..155e66e0
--- /dev/null
+++ b/lib/pydantic/alias_generators.py
@@ -0,0 +1,50 @@
+"""Alias generators for converting between different capitalization conventions."""
+import re
+
+__all__ = ('to_pascal', 'to_camel', 'to_snake')
+
+
+def to_pascal(snake: str) -> str:
+    """Convert a snake_case string to PascalCase.
+
+    Args:
+        snake: The string to convert.
+
+    Returns:
+        The PascalCase string.
+    """
+    camel = snake.title()
+    return re.sub('([0-9A-Za-z])_(?=[0-9A-Z])', lambda m: m.group(1), camel)
+
+
+def to_camel(snake: str) -> str:
+    """Convert a snake_case string to camelCase.
+
+    Args:
+        snake: The string to convert.
+
+    Returns:
+        The converted camelCase string.
+    """
+    camel = to_pascal(snake)
+    return re.sub('(^_*[A-Z])', lambda m: m.group(1).lower(), camel)
+
+
+def to_snake(camel: str) -> str:
+    """Convert a PascalCase or camelCase string to snake_case.
+
+    Args:
+        camel: The string to convert.
+
+    Returns:
+        The converted string in snake_case.
+    """
+    # Handle the sequence of uppercase letters followed by a lowercase letter
+    snake = re.sub(r'([A-Z]+)([A-Z][a-z])', lambda m: f'{m.group(1)}_{m.group(2)}', camel)
+    # Insert an underscore between a lowercase letter and an uppercase letter
+    snake = re.sub(r'([a-z])([A-Z])', lambda m: f'{m.group(1)}_{m.group(2)}', snake)
+    # Insert an underscore between a digit and an uppercase letter
+    snake = re.sub(r'([0-9])([A-Z])', lambda m: f'{m.group(1)}_{m.group(2)}', snake)
+    # Insert an underscore between a lowercase letter and a digit
+    snake = re.sub(r'([a-z])([0-9])', lambda m: f'{m.group(1)}_{m.group(2)}', snake)
+    return snake.lower()
diff --git a/lib/pydantic/aliases.py b/lib/pydantic/aliases.py
new file mode 100644
index 00000000..b53557b1
--- /dev/null
+++ b/lib/pydantic/aliases.py
@@ -0,0 +1,112 @@
+"""Support for alias configurations."""
+from __future__ import annotations
+
+import dataclasses
+from typing import Callable, Literal
+
+from ._internal import _internal_dataclass
+
+__all__ = ('AliasGenerator', 'AliasPath', 'AliasChoices')
+
+
+@dataclasses.dataclass(**_internal_dataclass.slots_true)
+class AliasPath:
+    """Usage docs: https://docs.pydantic.dev/2.6/concepts/alias#aliaspath-and-aliaschoices
+
+    A data class used by `validation_alias` as a convenience to create aliases.
+
+    Attributes:
+        path: A list of string or integer aliases.
+    """
+
+    path: list[int | str]
+
+    def __init__(self, first_arg: str, *args: str | int) -> None:
+        self.path = [first_arg] + list(args)
+
+    def convert_to_aliases(self) -> list[str | int]:
+        """Converts arguments to a list of string or integer aliases.
+
+        Returns:
+            The list of aliases.
+        """
+        return self.path
+
+
+@dataclasses.dataclass(**_internal_dataclass.slots_true)
+class AliasChoices:
+    """Usage docs: https://docs.pydantic.dev/2.6/concepts/alias#aliaspath-and-aliaschoices
+
+    A data class used by `validation_alias` as a convenience to create aliases.
+
+    Attributes:
+        choices: A list containing a string or `AliasPath`.
+    """
+
+    choices: list[str | AliasPath]
+
+    def __init__(self, first_choice: str | AliasPath, *choices: str | AliasPath) -> None:
+        self.choices = [first_choice] + list(choices)
+
+    def convert_to_aliases(self) -> list[list[str | int]]:
+        """Converts arguments to a list of lists containing string or integer aliases.
+
+        Returns:
+            The list of aliases.
+        """
+        aliases: list[list[str | int]] = []
+        for c in self.choices:
+            if isinstance(c, AliasPath):
+                aliases.append(c.convert_to_aliases())
+            else:
+                aliases.append([c])
+        return aliases
+
+
+@dataclasses.dataclass(**_internal_dataclass.slots_true)
+class AliasGenerator:
+    """Usage docs: https://docs.pydantic.dev/2.6/concepts/alias#using-an-aliasgenerator
+
+    A data class used by `alias_generator` as a convenience to create various aliases.
+
+    Attributes:
+        alias: A callable that takes a field name and returns an alias for it.
+        validation_alias: A callable that takes a field name and returns a validation alias for it.
+        serialization_alias: A callable that takes a field name and returns a serialization alias for it.
+    """
+
+    alias: Callable[[str], str] | None = None
+    validation_alias: Callable[[str], str | AliasPath | AliasChoices] | None = None
+    serialization_alias: Callable[[str], str] | None = None
+
+    def _generate_alias(
+        self,
+        alias_kind: Literal['alias', 'validation_alias', 'serialization_alias'],
+        allowed_types: tuple[type[str] | type[AliasPath] | type[AliasChoices], ...],
+        field_name: str,
+    ) -> str | AliasPath | AliasChoices | None:
+        """Generate an alias of the specified kind. Returns None if the alias generator is None.
+
+        Raises:
+            TypeError: If the alias generator produces an invalid type.
+        """
+        alias = None
+        if alias_generator := getattr(self, alias_kind):
+            alias = alias_generator(field_name)
+            if alias and not isinstance(alias, allowed_types):
+                raise TypeError(
+                    f'Invalid `{alias_kind}` type. `{alias_kind}` generator must produce one of `{allowed_types}`'
+                )
+        return alias
+
+    def generate_aliases(self, field_name: str) -> tuple[str | None, str | AliasPath | AliasChoices | None, str | None]:
+        """Generate `alias`, `validation_alias`, and `serialization_alias` for a field.
+
+        Returns:
+            A tuple of three aliases - validation, alias, and serialization.
+        """
+        alias = self._generate_alias('alias', (str,), field_name)
+        validation_alias = self._generate_alias('validation_alias', (str, AliasChoices, AliasPath), field_name)
+        serialization_alias = self._generate_alias('serialization_alias', (str,), field_name)
+
+        return alias, validation_alias, serialization_alias  # type: ignore
diff --git a/lib/pydantic/annotated_handlers.py b/lib/pydantic/annotated_handlers.py
new file mode 100644
index 00000000..081949a8
--- /dev/null
+++ b/lib/pydantic/annotated_handlers.py
@@ -0,0 +1,120 @@
+"""Type annotations to use with `__get_pydantic_core_schema__` and `__get_pydantic_json_schema__`."""
+from __future__ import annotations as _annotations
+
+from typing import TYPE_CHECKING, Any, Union
+
+from pydantic_core import core_schema
+
+if TYPE_CHECKING:
+    from .json_schema import JsonSchemaMode, JsonSchemaValue
+
+    CoreSchemaOrField = Union[
+        core_schema.CoreSchema,
+        core_schema.ModelField,
+        core_schema.DataclassField,
+        core_schema.TypedDictField,
+        core_schema.ComputedField,
+    ]
+
+__all__ = 'GetJsonSchemaHandler', 'GetCoreSchemaHandler'
+
+
+class GetJsonSchemaHandler:
+    """Handler to call into the next JSON schema generation function.
+
+    Attributes:
+        mode: Json schema mode, can be `validation` or `serialization`.
+    """
+
+    mode: JsonSchemaMode
+
+    def __call__(self, __core_schema: CoreSchemaOrField) -> JsonSchemaValue:
+        """Call the inner handler and get the JsonSchemaValue it returns.
+        This will call the next JSON schema modifying function up until it calls
+        into `pydantic.json_schema.GenerateJsonSchema`, which will raise a
+        `pydantic.errors.PydanticInvalidForJsonSchema` error if it cannot generate
+        a JSON schema.
+
+        Args:
+            __core_schema: A `pydantic_core.core_schema.CoreSchema`.
+
+        Returns:
+            JsonSchemaValue: The JSON schema generated by the inner JSON schema modify
+            functions.
+        """
+        raise NotImplementedError
+
+    def resolve_ref_schema(self, __maybe_ref_json_schema: JsonSchemaValue) -> JsonSchemaValue:
+        """Get the real schema for a `{"$ref": ...}` schema.
+        If the schema given is not a `$ref` schema, it will be returned as is.
+        This means you don't have to check before calling this function.
+
+        Args:
+            __maybe_ref_json_schema: A JsonSchemaValue which may be a `$ref` schema.
+
+        Raises:
+            LookupError: If the ref is not found.
+
+        Returns:
+            JsonSchemaValue: A JsonSchemaValue that has no `$ref`.
+        """
+        raise NotImplementedError
+
+
+class GetCoreSchemaHandler:
+    """Handler to call into the next CoreSchema schema generation function."""
+
+    def __call__(self, __source_type: Any) -> core_schema.CoreSchema:
+        """Call the inner handler and get the CoreSchema it returns.
+        This will call the next CoreSchema modifying function up until it calls
+        into Pydantic's internal schema generation machinery, which will raise a
+        `pydantic.errors.PydanticSchemaGenerationError` error if it cannot generate
+        a CoreSchema for the given source type.
+
+        Args:
+            __source_type: The input type.
+
+        Returns:
+            CoreSchema: The `pydantic-core` CoreSchema generated.
+        """
+        raise NotImplementedError
+
+    def generate_schema(self, __source_type: Any) -> core_schema.CoreSchema:
+        """Generate a schema unrelated to the current context.
+        Use this function if e.g. you are handling schema generation for a sequence
+        and want to generate a schema for its items.
+        Otherwise, you may end up doing something like applying a `min_length` constraint
+        that was intended for the sequence itself to its items!
+
+        Args:
+            __source_type: The input type.
+
+        Returns:
+            CoreSchema: The `pydantic-core` CoreSchema generated.
+        """
+        raise NotImplementedError
+
+    def resolve_ref_schema(self, __maybe_ref_schema: core_schema.CoreSchema) -> core_schema.CoreSchema:
+        """Get the real schema for a `definition-ref` schema.
+        If the schema given is not a `definition-ref` schema, it will be returned as is.
+        This means you don't have to check before calling this function.
+
+        Args:
+            __maybe_ref_schema: A `CoreSchema`, `ref`-based or not.
+
+        Raises:
+            LookupError: If the `ref` is not found.
+
+        Returns:
+            A concrete `CoreSchema`.
+        """
+        raise NotImplementedError
+
+    @property
+    def field_name(self) -> str | None:
+        """Get the name of the closest field to this validator."""
+        raise NotImplementedError
+
+    def _get_types_namespace(self) -> dict[str, Any] | None:
+        """Internal method used during type resolution for serializer annotations."""
+        raise NotImplementedError
diff --git a/lib/pydantic/class_validators.py b/lib/pydantic/class_validators.py
index 87190610..2ff72ae5 100644
--- a/lib/pydantic/class_validators.py
+++ b/lib/pydantic/class_validators.py
@@ -1,342 +1,4 @@
-import warnings
-from collections import ChainMap
-from functools import wraps
-from itertools import chain
-from types import FunctionType
-from typing import TYPE_CHECKING, Any, Callable, Dict, Iterable, List, Optional, Set, Tuple, Type, Union, overload
+"""`class_validators` module is a backport module from V1."""
+from ._migration import getattr_migration
 
-from .errors import ConfigError
-from .typing import AnyCallable
-from .utils import ROOT_KEY, in_ipython
-
-if TYPE_CHECKING:
-    from .typing import AnyClassMethod
-
-
-class Validator:
-    __slots__ = 'func', 'pre', 'each_item', 'always', 'check_fields', 'skip_on_failure'
-
-    def __init__(
-        self,
-        func: AnyCallable,
-        pre: bool = False,
-        each_item: bool = False,
-        always: bool = False,
-        check_fields: bool = False,
-        skip_on_failure: bool = False,
-    ):
-        self.func = func
-        self.pre = pre
-        self.each_item = each_item
-        self.always = always
-        self.check_fields = check_fields
-        self.skip_on_failure = skip_on_failure
-
-
-if TYPE_CHECKING:
-    from inspect import Signature
-
-    from .config import BaseConfig
-    from .fields import ModelField
-    from .types import ModelOrDc
-
-    ValidatorCallable = Callable[[Optional[ModelOrDc], Any, Dict[str, Any], ModelField, Type[BaseConfig]], Any]
-    ValidatorsList = List[ValidatorCallable]
-    ValidatorListDict = Dict[str, List[Validator]]
-
-_FUNCS: Set[str] = set()
-VALIDATOR_CONFIG_KEY = '__validator_config__'
-ROOT_VALIDATOR_CONFIG_KEY = '__root_validator_config__'
-
-
-def validator(
-    *fields: str,
-    pre: bool = False,
-    each_item: bool = False,
-    always: bool = False,
-    check_fields: bool = True,
-    whole: bool = None,
-    allow_reuse: bool = False,
-) -> Callable[[AnyCallable], 'AnyClassMethod']:
-    """
-    Decorate methods on the class indicating that they should be used to validate fields
-    :param fields: which field(s) the method should be called on
-    :param pre: whether or not this validator should be called before the standard validators (else after)
-    :param each_item: for complex objects (sets, lists etc.) whether to validate individual elements rather than the
-      whole object
-    :param always: whether this method and other validators should be called even if the value is missing
-    :param check_fields: whether to check that the fields actually exist on the model
-    :param allow_reuse: whether to track and raise an error if another validator refers to the decorated function
-    """
-    if not fields:
-        raise ConfigError('validator with no fields specified')
-    elif isinstance(fields[0], FunctionType):
-        raise ConfigError(
-            "validators should be used with fields and keyword arguments, not bare. "  # noqa: Q000
-            "E.g. usage should be `@validator('<field_name>', ...)`"
-        )
-    elif not all(isinstance(field, str) for field in fields):
-        raise ConfigError(
-            "validator fields should be passed as separate string args. "  # noqa: Q000
-            "E.g. usage should be `@validator('<field_name_1>', '<field_name_2>', ...)`"
-        )
-
-    if whole is not None:
-        warnings.warn(
-            'The "whole" keyword argument is deprecated, use "each_item" (inverse meaning, default False) instead',
-            DeprecationWarning,
-        )
-        assert each_item is False, '"each_item" and "whole" conflict, remove "whole"'
-        each_item = not whole
-
-    def dec(f: AnyCallable) -> 'AnyClassMethod':
-        f_cls = _prepare_validator(f, allow_reuse)
-        setattr(
-            f_cls,
-            VALIDATOR_CONFIG_KEY,
-            (
-                fields,
-                Validator(func=f_cls.__func__, pre=pre, each_item=each_item, always=always, check_fields=check_fields),
-            ),
-        )
-        return f_cls
-
-    return dec
-
-
-@overload
-def root_validator(_func: AnyCallable) -> 'AnyClassMethod':
-    ...
-
-
-@overload
-def root_validator(
-    *, pre: bool = False, allow_reuse: bool = False, skip_on_failure: bool = False
-) -> Callable[[AnyCallable], 'AnyClassMethod']:
-    ...
-
-
-def root_validator(
-    _func: Optional[AnyCallable] = None, *, pre: bool = False, allow_reuse: bool = False, skip_on_failure: bool = False
-) -> Union['AnyClassMethod', Callable[[AnyCallable], 'AnyClassMethod']]:
-    """
-    Decorate methods on a model indicating that they should be used to validate (and perhaps modify) data either
-    before or after standard model parsing/validation is performed.
-    """
-    if _func:
-        f_cls = _prepare_validator(_func, allow_reuse)
-        setattr(
-            f_cls, ROOT_VALIDATOR_CONFIG_KEY, Validator(func=f_cls.__func__, pre=pre, skip_on_failure=skip_on_failure)
-        )
-        return f_cls
-
-    def dec(f: AnyCallable) -> 'AnyClassMethod':
-        f_cls = _prepare_validator(f, allow_reuse)
-        setattr(
-            f_cls, ROOT_VALIDATOR_CONFIG_KEY, Validator(func=f_cls.__func__, pre=pre, skip_on_failure=skip_on_failure)
-        )
-        return f_cls
-
-    return dec
-
-
-def _prepare_validator(function: AnyCallable, allow_reuse: bool) -> 'AnyClassMethod':
-    """
-    Avoid validators with duplicated names since without this, validators can be overwritten silently
-    which generally isn't the intended behaviour, don't run in ipython (see #312) or if allow_reuse is False.
-    """
-    f_cls = function if isinstance(function, classmethod) else classmethod(function)
-    if not in_ipython() and not allow_reuse:
-        ref = f_cls.__func__.__module__ + '.' + f_cls.__func__.__qualname__
-        if ref in _FUNCS:
-            raise ConfigError(f'duplicate validator function "{ref}"; if this is intended, set `allow_reuse=True`')
-        _FUNCS.add(ref)
-    return f_cls
-
-
-class ValidatorGroup:
-    def __init__(self, validators: 'ValidatorListDict') -> None:
-        self.validators = validators
-        self.used_validators = {'*'}
-
-    def get_validators(self, name: str) -> Optional[Dict[str, Validator]]:
-        self.used_validators.add(name)
-        validators = self.validators.get(name, [])
-        if name != ROOT_KEY:
-            validators += self.validators.get('*', [])
-        if validators:
-            return {v.func.__name__: v for v in validators}
-        else:
-            return None
-
-    def check_for_unused(self) -> None:
-        unused_validators = set(
-            chain.from_iterable(
-                (v.func.__name__ for v in self.validators[f] if v.check_fields)
-                for f in (self.validators.keys() - self.used_validators)
-            )
-        )
-        if unused_validators:
-            fn = ', '.join(unused_validators)
-            raise ConfigError(
-                f"Validators defined with incorrect fields: {fn} "  # noqa: Q000
-                f"(use check_fields=False if you're inheriting from the model and intended this)"
-            )
-
-
-def extract_validators(namespace: Dict[str, Any]) -> Dict[str, List[Validator]]:
-    validators: Dict[str, List[Validator]] = {}
-    for var_name, value in namespace.items():
-        validator_config = getattr(value, VALIDATOR_CONFIG_KEY, None)
-        if validator_config:
-            fields, v = validator_config
-            for field in fields:
-                if field in validators:
-                    validators[field].append(v)
-                else:
-                    validators[field] = [v]
-    return validators
-
-
-def extract_root_validators(namespace: Dict[str, Any]) -> Tuple[List[AnyCallable], List[Tuple[bool, AnyCallable]]]:
-    from inspect import signature
-
-    pre_validators: List[AnyCallable] = []
-    post_validators: List[Tuple[bool, AnyCallable]] = []
-    for name, value in namespace.items():
-        validator_config: Optional[Validator] = getattr(value, ROOT_VALIDATOR_CONFIG_KEY, None)
-        if validator_config:
-            sig = signature(validator_config.func)
-            args = list(sig.parameters.keys())
-            if args[0] == 'self':
-                raise ConfigError(
-                    f'Invalid signature for root validator {name}: {sig}, "self" not permitted as first argument, '
-                    f'should be: (cls, values).'
-                )
-            if len(args) != 2:
-                raise ConfigError(f'Invalid signature for root validator {name}: {sig}, should be: (cls, values).')
-            # check function signature
-            if validator_config.pre:
-                pre_validators.append(validator_config.func)
-            else:
-                post_validators.append((validator_config.skip_on_failure, validator_config.func))
-    return pre_validators, post_validators
-
-
-def inherit_validators(base_validators: 'ValidatorListDict', validators: 'ValidatorListDict') -> 'ValidatorListDict':
-    for field, field_validators in base_validators.items():
-        if field not in validators:
-            validators[field] = []
-        validators[field] += field_validators
-    return validators
-
-
-def make_generic_validator(validator: AnyCallable) -> 'ValidatorCallable':
-    """
-    Make a generic function which calls a validator with the right arguments.
-
-    Unfortunately other approaches (eg. return a partial of a function that builds the arguments) is slow,
-    hence this laborious way of doing things.
-
-    It's done like this so validators don't all need **kwargs in their signature, eg. any combination of
-    the arguments "values", "fields" and/or "config" are permitted.
-    """
-    from inspect import signature
-
-    sig = signature(validator)
-    args = list(sig.parameters.keys())
-    first_arg = args.pop(0)
-    if first_arg == 'self':
-        raise ConfigError(
-            f'Invalid signature for validator {validator}: {sig}, "self" not permitted as first argument, '
-            f'should be: (cls, value, values, config, field), "values", "config" and "field" are all optional.'
-        )
-    elif first_arg == 'cls':
-        # assume the second argument is value
-        return wraps(validator)(_generic_validator_cls(validator, sig, set(args[1:])))
-    else:
-        # assume the first argument was value which has already been removed
-        return wraps(validator)(_generic_validator_basic(validator, sig, set(args)))
-
-
-def prep_validators(v_funcs: Iterable[AnyCallable]) -> 'ValidatorsList':
-    return [make_generic_validator(f) for f in v_funcs if f]
-
-
-all_kwargs = {'values', 'field', 'config'}
-
-
-def _generic_validator_cls(validator: AnyCallable, sig: 'Signature', args: Set[str]) -> 'ValidatorCallable':
-    # assume the first argument is value
-    has_kwargs = False
-    if 'kwargs' in args:
-        has_kwargs = True
-        args -= {'kwargs'}
-
-    if not args.issubset(all_kwargs):
-        raise ConfigError(
-            f'Invalid signature for validator {validator}: {sig}, should be: '
-            f'(cls, value, values, config, field), "values", "config" and "field" are all optional.'
-        )
-
-    if has_kwargs:
-        return lambda cls, v, values, field, config: validator(cls, v, values=values, field=field, config=config)
-    elif args == set():
-        return lambda cls, v, values, field, config: validator(cls, v)
-    elif args == {'values'}:
-        return lambda cls, v, values, field, config: validator(cls, v, values=values)
-    elif args == {'field'}:
-        return lambda cls, v, values, field, config: validator(cls, v, field=field)
-    elif args == {'config'}:
-        return lambda cls, v, values, field, config: validator(cls, v, config=config)
-    elif args == {'values', 'field'}:
-        return lambda cls, v, values, field, config: validator(cls, v, values=values, field=field)
-    elif args == {'values', 'config'}:
-        return lambda cls, v, values, field, config: validator(cls, v, values=values, config=config)
-    elif args == {'field', 'config'}:
-        return lambda cls, v, values, field, config: validator(cls, v, field=field, config=config)
-    else:
-        # args == {'values', 'field', 'config'}
-        return lambda cls, v, values, field, config: validator(cls, v, values=values, field=field, config=config)
-
-
-def _generic_validator_basic(validator: AnyCallable, sig: 'Signature', args: Set[str]) -> 'ValidatorCallable':
-    has_kwargs = False
-    if 'kwargs' in args:
-        has_kwargs = True
-        args -= {'kwargs'}
-
-    if not args.issubset(all_kwargs):
-        raise ConfigError(
-            f'Invalid signature for validator {validator}: {sig}, should be: '
-            f'(value, values, config, field), "values", "config" and "field" are all optional.'
-        )
-
-    if has_kwargs:
-        return lambda cls, v, values, field, config: validator(v, values=values, field=field, config=config)
-    elif args == set():
-        return lambda cls, v, values, field, config: validator(v)
-    elif args == {'values'}:
-        return lambda cls, v, values, field, config: validator(v, values=values)
-    elif args == {'field'}:
-        return lambda cls, v, values, field, config: validator(v, field=field)
-    elif args == {'config'}:
-        return lambda cls, v, values, field, config: validator(v, config=config)
-    elif args == {'values', 'field'}:
-        return lambda cls, v, values, field, config: validator(v, values=values, field=field)
-    elif args == {'values', 'config'}:
-        return lambda cls, v, values, field, config: validator(v, values=values, config=config)
-    elif args == {'field', 'config'}:
-        return lambda cls, v, values, field, config: validator(v, field=field, config=config)
-    else:
-        # args == {'values', 'field', 'config'}
-        return lambda cls, v, values, field, config: validator(v, values=values, field=field, config=config)
-
-
-def gather_all_validators(type_: 'ModelOrDc') -> Dict[str, 'AnyClassMethod']:
-    all_attributes = ChainMap(*[cls.__dict__ for cls in type_.__mro__])  # type: ignore[arg-type,var-annotated]
-    return {
-        k: v
-        for k, v in all_attributes.items()
-        if hasattr(v, VALIDATOR_CONFIG_KEY) or hasattr(v, ROOT_VALIDATOR_CONFIG_KEY)
-    }
+__getattr__ = getattr_migration(__name__)
diff --git a/lib/pydantic/color.py b/lib/pydantic/color.py
index 6fdc9fb1..108bb8fa 100644
--- a/lib/pydantic/color.py
+++ b/lib/pydantic/color.py
@@ -1,22 +1,28 @@
-"""
-Color definitions are  used as per CSS3 specification:
-http://www.w3.org/TR/css3-color/#svg-color
+"""Color definitions are used as per the CSS3
+[CSS Color Module Level 3](http://www.w3.org/TR/css3-color/#svg-color) specification.
 
 A few colors have multiple names referring to the sames colors, eg. `grey` and `gray` or `aqua` and `cyan`.
 
-In these cases the LAST color when sorted alphabetically takes preferences,
-eg. Color((0, 255, 255)).as_named() == 'cyan' because "cyan" comes after "aqua".
+In these cases the _last_ color when sorted alphabetically takes preferences,
+eg. `Color((0, 255, 255)).as_named() == 'cyan'` because "cyan" comes after "aqua".
+
+Warning: Deprecated
+    The `Color` class is deprecated, use `pydantic_extra_types` instead.
+    See [`pydantic-extra-types.Color`](../usage/types/extra_types/color_types.md)
+    for more information.
 """
 import math
 import re
 from colorsys import hls_to_rgb, rgb_to_hls
-from typing import TYPE_CHECKING, Any, Dict, Optional, Tuple, Union, cast
+from typing import Any, Callable, Optional, Tuple, Type, Union, cast
 
-from .errors import ColorError
-from .utils import Representation, almost_equal_floats
+from pydantic_core import CoreSchema, PydanticCustomError, core_schema
+from typing_extensions import deprecated
 
-if TYPE_CHECKING:
-    from .typing import CallableGenerator, ReprArgs
+from ._internal import _repr
+from ._internal._schema_generation_shared import GetJsonSchemaHandler as _GetJsonSchemaHandler
+from .json_schema import JsonSchemaValue
+from .warnings import PydanticDeprecatedSince20
 
 ColorTuple = Union[Tuple[int, int, int], Tuple[int, int, int, float]]
 ColorType = Union[ColorTuple, str]
@@ -24,9 +30,7 @@ HslColorTuple = Union[Tuple[float, float, float], Tuple[float, float, float, flo
 
 
 class RGBA:
-    """
-    Internal use only as a representation of a color.
-    """
+    """Internal use only as a representation of a color."""
 
     __slots__ = 'r', 'g', 'b', 'alpha', '_tuple'
 
@@ -43,24 +47,35 @@ class RGBA:
 
 
 # these are not compiled here to avoid import slowdown, they'll be compiled the first time they're used, then cached
-r_hex_short = r'\s*(?:#|0x)?([0-9a-f])([0-9a-f])([0-9a-f])([0-9a-f])?\s*'
-r_hex_long = r'\s*(?:#|0x)?([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})?\s*'
 _r_255 = r'(\d{1,3}(?:\.\d+)?)'
 _r_comma = r'\s*,\s*'
-r_rgb = fr'\s*rgb\(\s*{_r_255}{_r_comma}{_r_255}{_r_comma}{_r_255}\)\s*'
 _r_alpha = r'(\d(?:\.\d+)?|\.\d+|\d{1,2}%)'
-r_rgba = fr'\s*rgba\(\s*{_r_255}{_r_comma}{_r_255}{_r_comma}{_r_255}{_r_comma}{_r_alpha}\s*\)\s*'
 _r_h = r'(-?\d+(?:\.\d+)?|-?\.\d+)(deg|rad|turn)?'
 _r_sl = r'(\d{1,3}(?:\.\d+)?)%'
-r_hsl = fr'\s*hsl\(\s*{_r_h}{_r_comma}{_r_sl}{_r_comma}{_r_sl}\s*\)\s*'
-r_hsla = fr'\s*hsl\(\s*{_r_h}{_r_comma}{_r_sl}{_r_comma}{_r_sl}{_r_comma}{_r_alpha}\s*\)\s*'
+r_hex_short = r'\s*(?:#|0x)?([0-9a-f])([0-9a-f])([0-9a-f])([0-9a-f])?\s*'
+r_hex_long = r'\s*(?:#|0x)?([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})?\s*'
+# CSS3 RGB examples: rgb(0, 0, 0), rgba(0, 0, 0, 0.5), rgba(0, 0, 0, 50%)
+r_rgb = rf'\s*rgba?\(\s*{_r_255}{_r_comma}{_r_255}{_r_comma}{_r_255}(?:{_r_comma}{_r_alpha})?\s*\)\s*'
+# CSS3 HSL examples: hsl(270, 60%, 50%), hsla(270, 60%, 50%, 0.5), hsla(270, 60%, 50%, 50%)
+r_hsl = rf'\s*hsla?\(\s*{_r_h}{_r_comma}{_r_sl}{_r_comma}{_r_sl}(?:{_r_comma}{_r_alpha})?\s*\)\s*'
+# CSS4 RGB examples: rgb(0 0 0), rgb(0 0 0 / 0.5), rgb(0 0 0 / 50%), rgba(0 0 0 / 50%)
+r_rgb_v4_style = rf'\s*rgba?\(\s*{_r_255}\s+{_r_255}\s+{_r_255}(?:\s*/\s*{_r_alpha})?\s*\)\s*'
+# CSS4 HSL examples: hsl(270 60% 50%), hsl(270 60% 50% / 0.5), hsl(270 60% 50% / 50%), hsla(270 60% 50% / 50%)
+r_hsl_v4_style = rf'\s*hsla?\(\s*{_r_h}\s+{_r_sl}\s+{_r_sl}(?:\s*/\s*{_r_alpha})?\s*\)\s*'
 
 # colors where the two hex characters are the same, if all colors match this the short version of hex colors can be used
 repeat_colors = {int(c * 2, 16) for c in '0123456789abcdef'}
 rads = 2 * math.pi
 
 
-class Color(Representation):
+@deprecated(
+    'The `Color` class is deprecated, use `pydantic_extra_types` instead. '
+    'See https://docs.pydantic.dev/latest/api/pydantic_extra_types_color/.',
+    category=PydanticDeprecatedSince20,
+)
+class Color(_repr.Representation):
+    """Represents a color."""
+
     __slots__ = '_original', '_rgba'
 
     def __init__(self, value: ColorType) -> None:
@@ -74,22 +89,39 @@ class Color(Representation):
             self._rgba = value._rgba
             value = value._original
         else:
-            raise ColorError(reason='value must be a tuple, list or string')
+            raise PydanticCustomError(
+                'color_error', 'value is not a valid color: value must be a tuple, list or string'
+            )
 
         # if we've got here value must be a valid color
         self._original = value
 
     @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+    def __get_pydantic_json_schema__(
+        cls, core_schema: core_schema.CoreSchema, handler: _GetJsonSchemaHandler
+    ) -> JsonSchemaValue:
+        field_schema = {}
         field_schema.update(type='string', format='color')
+        return field_schema
 
     def original(self) -> ColorType:
-        """
-        Original value passed to Color
-        """
+        """Original value passed to `Color`."""
         return self._original
 
     def as_named(self, *, fallback: bool = False) -> str:
+        """Returns the name of the color if it can be found in `COLORS_BY_VALUE` dictionary,
+        otherwise returns the hexadecimal representation of the color or raises `ValueError`.
+
+        Args:
+            fallback: If True, falls back to returning the hexadecimal representation of
+                the color instead of raising a ValueError when no named color is found.
+
+        Returns:
+            The name of the color, or the hexadecimal representation of the color.
+
+        Raises:
+            ValueError: When no named color is found and fallback is `False`.
+        """
         if self._rgba.alpha is None:
             rgb = cast(Tuple[int, int, int], self.as_rgb_tuple())
             try:
@@ -103,9 +135,13 @@ class Color(Representation):
             return self.as_hex()
 
     def as_hex(self) -> str:
-        """
-        Hex string representing the color can be 3, 4, 6 or 8 characters depending on whether the string
+        """Returns the hexadecimal representation of the color.
+
+        Hex string representing the color can be 3, 4, 6, or 8 characters depending on whether the string
         a "short" representation of the color is possible and whether there's an alpha channel.
+
+        Returns:
+            The hexadecimal representation of the color.
         """
         values = [float_to_255(c) for c in self._rgba[:3]]
         if self._rgba.alpha is not None:
@@ -117,9 +153,7 @@ class Color(Representation):
         return '#' + as_hex
 
     def as_rgb(self) -> str:
-        """
-        Color as an rgb(<r>, <g>, <b>) or rgba(<r>, <g>, <b>, <a>) string.
-        """
+        """Color as an `rgb(<r>, <g>, <b>)` or `rgba(<r>, <g>, <b>, <a>)` string."""
         if self._rgba.alpha is None:
             return f'rgb({float_to_255(self._rgba.r)}, {float_to_255(self._rgba.g)}, {float_to_255(self._rgba.b)})'
         else:
@@ -129,14 +163,18 @@ class Color(Representation):
             )
 
     def as_rgb_tuple(self, *, alpha: Optional[bool] = None) -> ColorTuple:
-        """
-        Color as an RGB or RGBA tuple; red, green and blue are in the range 0 to 255, alpha if included is
-        in the range 0 to 1.
+        """Returns the color as an RGB or RGBA tuple.
 
-        :param alpha: whether to include the alpha channel, options are
-          None - (default) include alpha only if it's set (e.g. not None)
-          True - always include alpha,
-          False - always omit alpha,
+        Args:
+            alpha: Whether to include the alpha channel. There are three options for this input:
+
+                - `None` (default): Include alpha only if it's set. (e.g. not `None`)
+                - `True`: Always include alpha.
+                - `False`: Always omit alpha.
+
+        Returns:
+            A tuple that contains the values of the red, green, and blue channels in the range 0 to 255.
+                If alpha is included, it is in the range 0 to 1.
         """
         r, g, b = (float_to_255(c) for c in self._rgba[:3])
         if alpha is None:
@@ -151,9 +189,7 @@ class Color(Representation):
             return r, g, b
 
     def as_hsl(self) -> str:
-        """
-        Color as an hsl(<h>, <s>, <l>) or hsl(<h>, <s>, <l>, <a>) string.
-        """
+        """Color as an `hsl(<h>, <s>, <l>)` or `hsl(<h>, <s>, <l>, <a>)` string."""
         if self._rgba.alpha is None:
             h, s, li = self.as_hsl_tuple(alpha=False)  # type: ignore
             return f'hsl({h * 360:0.0f}, {s:0.0%}, {li:0.0%})'
@@ -162,18 +198,23 @@ class Color(Representation):
             return f'hsl({h * 360:0.0f}, {s:0.0%}, {li:0.0%}, {round(a, 2)})'
 
     def as_hsl_tuple(self, *, alpha: Optional[bool] = None) -> HslColorTuple:
-        """
-        Color as an HSL or HSLA tuple, e.g. hue, saturation, lightness and optionally alpha; all elements are in
-        the range 0 to 1.
+        """Returns the color as an HSL or HSLA tuple.
 
-        NOTE: this is HSL as used in HTML and most other places, not HLS as used in python's colorsys.
+        Args:
+            alpha: Whether to include the alpha channel.
 
-        :param alpha: whether to include the alpha channel, options are
-          None - (default) include alpha only if it's set (e.g. not None)
-          True - always include alpha,
-          False - always omit alpha,
+                - `None` (default): Include the alpha channel only if it's set (e.g. not `None`).
+                - `True`: Always include alpha.
+                - `False`: Always omit alpha.
+
+        Returns:
+            The color as a tuple of hue, saturation, lightness, and alpha (if included).
+                All elements are in the range 0 to 1.
+
+        Note:
+            This is HSL as used in HTML and most other places, not HLS as used in Python's `colorsys`.
         """
-        h, l, s = rgb_to_hls(self._rgba.r, self._rgba.g, self._rgba.b)
+        h, l, s = rgb_to_hls(self._rgba.r, self._rgba.g, self._rgba.b)  # noqa: E741
         if alpha is None:
             if self._rgba.alpha is None:
                 return h, s, l
@@ -189,14 +230,22 @@ class Color(Representation):
         return 1 if self._rgba.alpha is None else self._rgba.alpha
 
     @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield cls
+    def __get_pydantic_core_schema__(
+        cls, source: Type[Any], handler: Callable[[Any], CoreSchema]
+    ) -> core_schema.CoreSchema:
+        return core_schema.with_info_plain_validator_function(
+            cls._validate, serialization=core_schema.to_string_ser_schema()
+        )
+
+    @classmethod
+    def _validate(cls, __input_value: Any, _: Any) -> 'Color':
+        return cls(__input_value)
 
     def __str__(self) -> str:
         return self.as_named(fallback=True)
 
-    def __repr_args__(self) -> 'ReprArgs':
-        return [(None, self.as_named(fallback=True))] + [('rgb', self.as_rgb_tuple())]  # type: ignore
+    def __repr_args__(self) -> '_repr.ReprArgs':
+        return [(None, self.as_named(fallback=True))] + [('rgb', self.as_rgb_tuple())]
 
     def __eq__(self, other: Any) -> bool:
         return isinstance(other, Color) and self.as_rgb_tuple() == other.as_rgb_tuple()
@@ -206,8 +255,16 @@ class Color(Representation):
 
 
 def parse_tuple(value: Tuple[Any, ...]) -> RGBA:
-    """
-    Parse a tuple or list as a color.
+    """Parse a tuple or list to get RGBA values.
+
+    Args:
+        value: A tuple or list.
+
+    Returns:
+        An `RGBA` tuple parsed from the input tuple.
+
+    Raises:
+        PydanticCustomError: If tuple is not valid.
     """
     if len(value) == 3:
         r, g, b = (parse_color_value(v) for v in value)
@@ -216,17 +273,28 @@ def parse_tuple(value: Tuple[Any, ...]) -> RGBA:
         r, g, b = (parse_color_value(v) for v in value[:3])
         return RGBA(r, g, b, parse_float_alpha(value[3]))
     else:
-        raise ColorError(reason='tuples must have length 3 or 4')
+        raise PydanticCustomError('color_error', 'value is not a valid color: tuples must have length 3 or 4')
 
 
 def parse_str(value: str) -> RGBA:
-    """
-    Parse a string to an RGBA tuple, trying the following formats (in this order):
-    * named color, see COLORS_BY_NAME below
+    """Parse a string representing a color to an RGBA tuple.
+
+    Possible formats for the input string include:
+
+    * named color, see `COLORS_BY_NAME`
     * hex short eg. `<prefix>fff` (prefix can be `#`, `0x` or nothing)
     * hex long eg. `<prefix>ffffff` (prefix can be `#`, `0x` or nothing)
-    * `rgb(<r>, <g>, <b>) `
+    * `rgb(<r>, <g>, <b>)`
     * `rgba(<r>, <g>, <b>, <a>)`
+
+    Args:
+        value: A string representing a color.
+
+    Returns:
+        An `RGBA` tuple parsed from the input string.
+
+    Raises:
+        ValueError: If the input string cannot be parsed to an RGBA tuple.
     """
     value_lower = value.lower()
     try:
@@ -256,49 +324,70 @@ def parse_str(value: str) -> RGBA:
             alpha = None
         return ints_to_rgba(r, g, b, alpha)
 
-    m = re.fullmatch(r_rgb, value_lower)
-    if m:
-        return ints_to_rgba(*m.groups(), None)  # type: ignore
-
-    m = re.fullmatch(r_rgba, value_lower)
+    m = re.fullmatch(r_rgb, value_lower) or re.fullmatch(r_rgb_v4_style, value_lower)
     if m:
         return ints_to_rgba(*m.groups())  # type: ignore
 
-    m = re.fullmatch(r_hsl, value_lower)
+    m = re.fullmatch(r_hsl, value_lower) or re.fullmatch(r_hsl_v4_style, value_lower)
     if m:
-        h, h_units, s, l_ = m.groups()
-        return parse_hsl(h, h_units, s, l_)
+        return parse_hsl(*m.groups())  # type: ignore
 
-    m = re.fullmatch(r_hsla, value_lower)
-    if m:
-        h, h_units, s, l_, a = m.groups()
-        return parse_hsl(h, h_units, s, l_, parse_float_alpha(a))
-
-    raise ColorError(reason='string not recognised as a valid color')
+    raise PydanticCustomError('color_error', 'value is not a valid color: string not recognised as a valid color')
 
 
-def ints_to_rgba(r: Union[int, str], g: Union[int, str], b: Union[int, str], alpha: Optional[float]) -> RGBA:
+def ints_to_rgba(r: Union[int, str], g: Union[int, str], b: Union[int, str], alpha: Optional[float] = None) -> RGBA:
+    """Converts integer or string values for RGB color and an optional alpha value to an `RGBA` object.
+
+    Args:
+        r: An integer or string representing the red color value.
+        g: An integer or string representing the green color value.
+        b: An integer or string representing the blue color value.
+        alpha: A float representing the alpha value. Defaults to None.
+
+    Returns:
+        An instance of the `RGBA` class with the corresponding color and alpha values.
+    """
     return RGBA(parse_color_value(r), parse_color_value(g), parse_color_value(b), parse_float_alpha(alpha))
 
 
 def parse_color_value(value: Union[int, str], max_val: int = 255) -> float:
-    """
-    Parse a value checking it's a valid int in the range 0 to max_val and divide by max_val to give a number
-    in the range 0 to 1
+    """Parse the color value provided and return a number between 0 and 1.
+
+    Args:
+        value: An integer or string color value.
+        max_val: Maximum range value. Defaults to 255.
+
+    Raises:
+        PydanticCustomError: If the value is not a valid color.
+
+    Returns:
+        A number between 0 and 1.
     """
     try:
         color = float(value)
     except ValueError:
-        raise ColorError(reason='color values must be a valid number')
+        raise PydanticCustomError('color_error', 'value is not a valid color: color values must be a valid number')
     if 0 <= color <= max_val:
         return color / max_val
     else:
-        raise ColorError(reason=f'color values must be in the range 0 to {max_val}')
+        raise PydanticCustomError(
+            'color_error',
+            'value is not a valid color: color values must be in the range 0 to {max_val}',
+            {'max_val': max_val},
+        )
 
 
 def parse_float_alpha(value: Union[None, str, float, int]) -> Optional[float]:
-    """
-    Parse a value checking it's a valid float in the range 0 to 1
+    """Parse an alpha value checking it's a valid float in the range 0 to 1.
+
+    Args:
+        value: The input value to parse.
+
+    Returns:
+        The parsed value as a float, or `None` if the value was None or equal 1.
+
+    Raises:
+        PydanticCustomError: If the input value cannot be successfully parsed as a float in the expected range.
     """
     if value is None:
         return None
@@ -308,19 +397,28 @@ def parse_float_alpha(value: Union[None, str, float, int]) -> Optional[float]:
         else:
             alpha = float(value)
     except ValueError:
-        raise ColorError(reason='alpha values must be a valid float')
+        raise PydanticCustomError('color_error', 'value is not a valid color: alpha values must be a valid float')
 
-    if almost_equal_floats(alpha, 1):
+    if math.isclose(alpha, 1):
         return None
     elif 0 <= alpha <= 1:
         return alpha
     else:
-        raise ColorError(reason='alpha values must be in the range 0 to 1')
+        raise PydanticCustomError('color_error', 'value is not a valid color: alpha values must be in the range 0 to 1')
 
 
 def parse_hsl(h: str, h_units: str, sat: str, light: str, alpha: Optional[float] = None) -> RGBA:
-    """
-    Parse raw hue, saturation, lightness and alpha values and convert to RGBA.
+    """Parse raw hue, saturation, lightness, and alpha values and convert to RGBA.
+
+    Args:
+        h: The hue value.
+        h_units: The unit for hue value.
+        sat: The saturation value.
+        light: The lightness value.
+        alpha: Alpha value.
+
+    Returns:
+        An instance of `RGBA`.
     """
     s_value, l_value = parse_color_value(sat, 100), parse_color_value(light, 100)
 
@@ -334,10 +432,21 @@ def parse_hsl(h: str, h_units: str, sat: str, light: str, alpha: Optional[float]
         h_value = h_value % 1
 
     r, g, b = hls_to_rgb(h_value, l_value, s_value)
-    return RGBA(r, g, b, alpha)
+    return RGBA(r, g, b, parse_float_alpha(alpha))
 
 
 def float_to_255(c: float) -> int:
+    """Converts a float value between 0 and 1 (inclusive) to an integer between 0 and 255 (inclusive).
+
+    Args:
+        c: The float value to be converted. Must be between 0 and 1 (inclusive).
+
+    Returns:
+        The integer equivalent of the given float value rounded to the nearest whole number.
+
+    Raises:
+        ValueError: If the given float value is outside the acceptable range of 0 to 1 (inclusive).
+    """
     return int(round(c * 255))
 
 
diff --git a/lib/pydantic/config.py b/lib/pydantic/config.py
index 74687ca0..6b22586b 100644
--- a/lib/pydantic/config.py
+++ b/lib/pydantic/config.py
@@ -1,192 +1,912 @@
-import json
-from enum import Enum
-from typing import TYPE_CHECKING, Any, Callable, Dict, ForwardRef, Optional, Tuple, Type, Union
+"""Configuration for Pydantic models."""
+from __future__ import annotations as _annotations
 
-from typing_extensions import Literal, Protocol
+from typing import TYPE_CHECKING, Any, Callable, Dict, List, Type, Union
 
-from .typing import AnyArgTCallable, AnyCallable
-from .utils import GetterDict
-from .version import compiled
+from typing_extensions import Literal, TypeAlias, TypedDict
+
+from ._migration import getattr_migration
+from .aliases import AliasGenerator
 
 if TYPE_CHECKING:
-    from typing import overload
+    from ._internal._generate_schema import GenerateSchema as _GenerateSchema
 
-    from .fields import ModelField
-    from .main import BaseModel
-
-    ConfigType = Type['BaseConfig']
-
-    class SchemaExtraCallable(Protocol):
-        @overload
-        def __call__(self, schema: Dict[str, Any]) -> None:
-            pass
-
-        @overload
-        def __call__(self, schema: Dict[str, Any], model_class: Type[BaseModel]) -> None:
-            pass
-
-else:
-    SchemaExtraCallable = Callable[..., None]
-
-__all__ = 'BaseConfig', 'ConfigDict', 'get_config', 'Extra', 'inherit_config', 'prepare_config'
+__all__ = ('ConfigDict',)
 
 
-class Extra(str, Enum):
-    allow = 'allow'
-    ignore = 'ignore'
-    forbid = 'forbid'
+JsonValue: TypeAlias = Union[int, float, str, bool, None, List['JsonValue'], 'JsonDict']
+JsonDict: TypeAlias = Dict[str, JsonValue]
+
+JsonEncoder = Callable[[Any], Any]
+
+JsonSchemaExtraCallable: TypeAlias = Union[
+    Callable[[JsonDict], None],
+    Callable[[JsonDict, Type[Any]], None],
+]
+
+ExtraValues = Literal['allow', 'ignore', 'forbid']
 
 
-# https://github.com/cython/cython/issues/4003
-# Will be fixed with Cython 3 but still in alpha right now
-if not compiled:
-    from typing_extensions import TypedDict
+class ConfigDict(TypedDict, total=False):
+    """A TypedDict for configuring Pydantic behaviour."""
 
-    class ConfigDict(TypedDict, total=False):
-        title: Optional[str]
-        anystr_lower: bool
-        anystr_strip_whitespace: bool
-        min_anystr_length: int
-        max_anystr_length: Optional[int]
-        validate_all: bool
-        extra: Extra
-        allow_mutation: bool
-        frozen: bool
-        allow_population_by_field_name: bool
-        use_enum_values: bool
-        fields: Dict[str, Union[str, Dict[str, str]]]
-        validate_assignment: bool
-        error_msg_templates: Dict[str, str]
-        arbitrary_types_allowed: bool
-        orm_mode: bool
-        getter_dict: Type[GetterDict]
-        alias_generator: Optional[Callable[[str], str]]
-        keep_untouched: Tuple[type, ...]
-        schema_extra: Union[Dict[str, object], 'SchemaExtraCallable']
-        json_loads: Callable[[str], object]
-        json_dumps: AnyArgTCallable[str]
-        json_encoders: Dict[Type[object], AnyCallable]
-        underscore_attrs_are_private: bool
-        allow_inf_nan: bool
+    title: str | None
+    """The title for the generated JSON schema, defaults to the model's name"""
 
-        # whether or not inherited models as fields should be reconstructed as base model
-        copy_on_model_validation: bool
-        # whether dataclass `__post_init__` should be run after validation
-        post_init_call: Literal['before_validation', 'after_validation']
+    str_to_lower: bool
+    """Whether to convert all characters to lowercase for str types. Defaults to `False`."""
 
-else:
-    ConfigDict = dict  # type: ignore
+    str_to_upper: bool
+    """Whether to convert all characters to uppercase for str types. Defaults to `False`."""
+    str_strip_whitespace: bool
+    """Whether to strip leading and trailing whitespace for str types."""
+
+    str_min_length: int
+    """The minimum length for str types. Defaults to `None`."""
+
+    str_max_length: int | None
+    """The maximum length for str types. Defaults to `None`."""
+
+    extra: ExtraValues | None
+    """
+    Whether to ignore, allow, or forbid extra attributes during model initialization. Defaults to `'ignore'`.
+
+    You can configure how pydantic handles the attributes that are not defined in the model:
+
+    * `allow` - Allow any extra attributes.
+    * `forbid` - Forbid any extra attributes.
+    * `ignore` - Ignore any extra attributes.
+
+    ```py
+    from pydantic import BaseModel, ConfigDict
 
 
-class BaseConfig:
-    title: Optional[str] = None
-    anystr_lower: bool = False
-    anystr_upper: bool = False
-    anystr_strip_whitespace: bool = False
-    min_anystr_length: int = 0
-    max_anystr_length: Optional[int] = None
-    validate_all: bool = False
-    extra: Extra = Extra.ignore
-    allow_mutation: bool = True
-    frozen: bool = False
-    allow_population_by_field_name: bool = False
-    use_enum_values: bool = False
-    fields: Dict[str, Union[str, Dict[str, str]]] = {}
-    validate_assignment: bool = False
-    error_msg_templates: Dict[str, str] = {}
-    arbitrary_types_allowed: bool = False
-    orm_mode: bool = False
-    getter_dict: Type[GetterDict] = GetterDict
-    alias_generator: Optional[Callable[[str], str]] = None
-    keep_untouched: Tuple[type, ...] = ()
-    schema_extra: Union[Dict[str, Any], 'SchemaExtraCallable'] = {}
-    json_loads: Callable[[str], Any] = json.loads
-    json_dumps: Callable[..., str] = json.dumps
-    json_encoders: Dict[Union[Type[Any], str, ForwardRef], AnyCallable] = {}
-    underscore_attrs_are_private: bool = False
-    allow_inf_nan: bool = True
+    class User(BaseModel):
+        model_config = ConfigDict(extra='ignore')  # (1)!
 
-    # whether inherited models as fields should be reconstructed as base model,
-    # and whether such a copy should be shallow or deep
-    copy_on_model_validation: Literal['none', 'deep', 'shallow'] = 'shallow'
-
-    # whether `Union` should check all allowed types before even trying to coerce
-    smart_union: bool = False
-    # whether dataclass `__post_init__` should be run before or after validation
-    post_init_call: Literal['before_validation', 'after_validation'] = 'before_validation'
-
-    @classmethod
-    def get_field_info(cls, name: str) -> Dict[str, Any]:
-        """
-        Get properties of FieldInfo from the `fields` property of the config class.
-        """
-
-        fields_value = cls.fields.get(name)
-
-        if isinstance(fields_value, str):
-            field_info: Dict[str, Any] = {'alias': fields_value}
-        elif isinstance(fields_value, dict):
-            field_info = fields_value
-        else:
-            field_info = {}
-
-        if 'alias' in field_info:
-            field_info.setdefault('alias_priority', 2)
-
-        if field_info.get('alias_priority', 0) <= 1 and cls.alias_generator:
-            alias = cls.alias_generator(name)
-            if not isinstance(alias, str):
-                raise TypeError(f'Config.alias_generator must return str, not {alias.__class__}')
-            field_info.update(alias=alias, alias_priority=1)
-        return field_info
-
-    @classmethod
-    def prepare_field(cls, field: 'ModelField') -> None:
-        """
-        Optional hook to check or modify fields during model creation.
-        """
-        pass
+        name: str
 
 
-def get_config(config: Union[ConfigDict, Type[object], None]) -> Type[BaseConfig]:
-    if config is None:
-        return BaseConfig
+    user = User(name='John Doe', age=20)  # (2)!
+    print(user)
+    #> name='John Doe'
+    ```
 
-    else:
-        config_dict = (
-            config
-            if isinstance(config, dict)
-            else {k: getattr(config, k) for k in dir(config) if not k.startswith('__')}
+    1. This is the default behaviour.
+    2. The `age` argument is ignored.
+
+    Instead, with `extra='allow'`, the `age` argument is included:
+
+    ```py
+    from pydantic import BaseModel, ConfigDict
+
+
+    class User(BaseModel):
+        model_config = ConfigDict(extra='allow')
+
+        name: str
+
+
+    user = User(name='John Doe', age=20)  # (1)!
+    print(user)
+    #> name='John Doe' age=20
+    ```
+
+    1. The `age` argument is included.
+
+    With `extra='forbid'`, an error is raised:
+
+    ```py
+    from pydantic import BaseModel, ConfigDict, ValidationError
+
+
+    class User(BaseModel):
+        model_config = ConfigDict(extra='forbid')
+
+        name: str
+
+
+    try:
+        User(name='John Doe', age=20)
+    except ValidationError as e:
+        print(e)
+        '''
+        1 validation error for User
+        age
+        Extra inputs are not permitted [type=extra_forbidden, input_value=20, input_type=int]
+        '''
+    ```
+    """
+
+    frozen: bool
+    """
+    Whether models are faux-immutable, i.e. whether `__setattr__` is allowed, and also generates
+    a `__hash__()` method for the model. This makes instances of the model potentially hashable if all the
+    attributes are hashable. Defaults to `False`.
+
+    Note:
+        On V1, the inverse of this setting was called `allow_mutation`, and was `True` by default.
+    """
+
+    populate_by_name: bool
+    """
+    Whether an aliased field may be populated by its name as given by the model
+    attribute, as well as the alias. Defaults to `False`.
+
+    Note:
+        The name of this configuration setting was changed in **v2.0** from
+        `allow_population_by_field_name` to `populate_by_name`.
+
+    ```py
+    from pydantic import BaseModel, ConfigDict, Field
+
+
+    class User(BaseModel):
+        model_config = ConfigDict(populate_by_name=True)
+
+        name: str = Field(alias='full_name')  # (1)!
+        age: int
+
+
+    user = User(full_name='John Doe', age=20)  # (2)!
+    print(user)
+    #> name='John Doe' age=20
+    user = User(name='John Doe', age=20)  # (3)!
+    print(user)
+    #> name='John Doe' age=20
+    ```
+
+    1. The field `'name'` has an alias `'full_name'`.
+    2. The model is populated by the alias `'full_name'`.
+    3. The model is populated by the field name `'name'`.
+    """
+
+    use_enum_values: bool
+    """
+    Whether to populate models with the `value` property of enums, rather than the raw enum.
+    This may be useful if you want to serialize `model.model_dump()` later. Defaults to `False`.
+
+    !!! note
+        If you have an `Optional[Enum]` value that you set a default for, you need to use `validate_default=True`
+        for said Field to ensure that the `use_enum_values` flag takes effect on the default, as extracting an
+        enum's value occurs during validation, not serialization.
+
+    ```py
+    from enum import Enum
+    from typing import Optional
+
+    from pydantic import BaseModel, ConfigDict, Field
+
+
+    class SomeEnum(Enum):
+        FOO = 'foo'
+        BAR = 'bar'
+        BAZ = 'baz'
+
+
+    class SomeModel(BaseModel):
+        model_config = ConfigDict(use_enum_values=True)
+
+        some_enum: SomeEnum
+        another_enum: Optional[SomeEnum] = Field(default=SomeEnum.FOO, validate_default=True)
+
+
+    model1 = SomeModel(some_enum=SomeEnum.BAR)
+    print(model1.model_dump())
+    # {'some_enum': 'bar', 'another_enum': 'foo'}
+
+    model2 = SomeModel(some_enum=SomeEnum.BAR, another_enum=SomeEnum.BAZ)
+    print(model2.model_dump())
+    #> {'some_enum': 'bar', 'another_enum': 'baz'}
+    ```
+    """
+
+    validate_assignment: bool
+    """
+    Whether to validate the data when the model is changed. Defaults to `False`.
+
+    The default behavior of Pydantic is to validate the data when the model is created.
+
+    In case the user changes the data after the model is created, the model is _not_ revalidated.
+
+    ```py
+    from pydantic import BaseModel
+
+    class User(BaseModel):
+        name: str
+
+    user = User(name='John Doe')  # (1)!
+    print(user)
+    #> name='John Doe'
+    user.name = 123  # (1)!
+    print(user)
+    #> name=123
+    ```
+
+    1. The validation happens only when the model is created.
+    2. The validation does not happen when the data is changed.
+
+    In case you want to revalidate the model when the data is changed, you can use `validate_assignment=True`:
+
+    ```py
+    from pydantic import BaseModel, ValidationError
+
+    class User(BaseModel, validate_assignment=True):  # (1)!
+        name: str
+
+    user = User(name='John Doe')  # (2)!
+    print(user)
+    #> name='John Doe'
+    try:
+        user.name = 123  # (3)!
+    except ValidationError as e:
+        print(e)
+        '''
+        1 validation error for User
+        name
+          Input should be a valid string [type=string_type, input_value=123, input_type=int]
+        '''
+    ```
+
+    1. You can either use class keyword arguments, or `model_config` to set `validate_assignment=True`.
+    2. The validation happens when the model is created.
+    3. The validation _also_ happens when the data is changed.
+    """
+
+    arbitrary_types_allowed: bool
+    """
+    Whether arbitrary types are allowed for field types. Defaults to `False`.
+
+    ```py
+    from pydantic import BaseModel, ConfigDict, ValidationError
+
+    # This is not a pydantic model, it's an arbitrary class
+    class Pet:
+        def __init__(self, name: str):
+            self.name = name
+
+    class Model(BaseModel):
+        model_config = ConfigDict(arbitrary_types_allowed=True)
+
+        pet: Pet
+        owner: str
+
+    pet = Pet(name='Hedwig')
+    # A simple check of instance type is used to validate the data
+    model = Model(owner='Harry', pet=pet)
+    print(model)
+    #> pet=<__main__.Pet object at 0x0123456789ab> owner='Harry'
+    print(model.pet)
+    #> <__main__.Pet object at 0x0123456789ab>
+    print(model.pet.name)
+    #> Hedwig
+    print(type(model.pet))
+    #> <class '__main__.Pet'>
+    try:
+        # If the value is not an instance of the type, it's invalid
+        Model(owner='Harry', pet='Hedwig')
+    except ValidationError as e:
+        print(e)
+        '''
+        1 validation error for Model
+        pet
+          Input should be an instance of Pet [type=is_instance_of, input_value='Hedwig', input_type=str]
+        '''
+
+    # Nothing in the instance of the arbitrary type is checked
+    # Here name probably should have been a str, but it's not validated
+    pet2 = Pet(name=42)
+    model2 = Model(owner='Harry', pet=pet2)
+    print(model2)
+    #> pet=<__main__.Pet object at 0x0123456789ab> owner='Harry'
+    print(model2.pet)
+    #> <__main__.Pet object at 0x0123456789ab>
+    print(model2.pet.name)
+    #> 42
+    print(type(model2.pet))
+    #> <class '__main__.Pet'>
+    ```
+    """
+
+    from_attributes: bool
+    """
+    Whether to build models and look up discriminators of tagged unions using python object attributes.
+    """
+
+    loc_by_alias: bool
+    """Whether to use the actual key provided in the data (e.g. alias) for error `loc`s rather than the field's name. Defaults to `True`."""
+
+    alias_generator: Callable[[str], str] | AliasGenerator | None
+    """
+    A callable that takes a field name and returns an alias for it
+    or an instance of [`AliasGenerator`][pydantic.aliases.AliasGenerator]. Defaults to `None`.
+
+    When using a callable, the alias generator is used for both validation and serialization.
+    If you want to use different alias generators for validation and serialization, you can use
+    [`AliasGenerator`][pydantic.aliases.AliasGenerator] instead.
+
+    If data source field names do not match your code style (e. g. CamelCase fields),
+    you can automatically generate aliases using `alias_generator`. Here's an example with
+    a basic callable:
+
+    ```py
+    from pydantic import BaseModel, ConfigDict
+    from pydantic.alias_generators import to_pascal
+
+    class Voice(BaseModel):
+        model_config = ConfigDict(alias_generator=to_pascal)
+
+        name: str
+        language_code: str
+
+    voice = Voice(Name='Filiz', LanguageCode='tr-TR')
+    print(voice.language_code)
+    #> tr-TR
+    print(voice.model_dump(by_alias=True))
+    #> {'Name': 'Filiz', 'LanguageCode': 'tr-TR'}
+    ```
+
+    If you want to use different alias generators for validation and serialization, you can use
+    [`AliasGenerator`][pydantic.aliases.AliasGenerator].
+
+    ```py
+    from pydantic import AliasGenerator, BaseModel, ConfigDict
+    from pydantic.alias_generators import to_camel, to_pascal
+
+    class Athlete(BaseModel):
+        first_name: str
+        last_name: str
+        sport: str
+
+        model_config = ConfigDict(
+            alias_generator=AliasGenerator(
+                validation_alias=to_camel,
+                serialization_alias=to_pascal,
+            )
         )
 
-        class Config(BaseConfig):
-            ...
+    athlete = Athlete(firstName='John', lastName='Doe', sport='track')
+    print(athlete.model_dump(by_alias=True))
+    #> {'FirstName': 'John', 'LastName': 'Doe', 'Sport': 'track'}
+    ```
 
-        for k, v in config_dict.items():
-            setattr(Config, k, v)
-        return Config
+    Note:
+        Pydantic offers three built-in alias generators: [`to_pascal`][pydantic.alias_generators.to_pascal],
+        [`to_camel`][pydantic.alias_generators.to_camel], and [`to_snake`][pydantic.alias_generators.to_snake].
+    """
 
+    ignored_types: tuple[type, ...]
+    """A tuple of types that may occur as values of class attributes without annotations. This is
+    typically used for custom descriptors (classes that behave like `property`). If an attribute is set on a
+    class without an annotation and has a type that is not in this tuple (or otherwise recognized by
+    _pydantic_), an error will be raised. Defaults to `()`.
+    """
 
-def inherit_config(self_config: 'ConfigType', parent_config: 'ConfigType', **namespace: Any) -> 'ConfigType':
-    if not self_config:
-        base_classes: Tuple['ConfigType', ...] = (parent_config,)
-    elif self_config == parent_config:
-        base_classes = (self_config,)
-    else:
-        base_classes = self_config, parent_config
+    allow_inf_nan: bool
+    """Whether to allow infinity (`+inf` an `-inf`) and NaN values to float fields. Defaults to `True`."""
 
-    namespace['json_encoders'] = {
-        **getattr(parent_config, 'json_encoders', {}),
-        **getattr(self_config, 'json_encoders', {}),
-        **namespace.get('json_encoders', {}),
+    json_schema_extra: JsonDict | JsonSchemaExtraCallable | None
+    """A dict or callable to provide extra JSON schema properties. Defaults to `None`."""
+
+    json_encoders: dict[type[object], JsonEncoder] | None
+    """
+    A `dict` of custom JSON encoders for specific types. Defaults to `None`.
+
+    !!! warning "Deprecated"
+        This config option is a carryover from v1.
+        We originally planned to remove it in v2 but didn't have a 1:1 replacement so we are keeping it for now.
+        It is still deprecated and will likely be removed in the future.
+    """
+
+    # new in V2
+    strict: bool
+    """
+    _(new in V2)_ If `True`, strict validation is applied to all fields on the model.
+
+    By default, Pydantic attempts to coerce values to the correct type, when possible.
+
+    There are situations in which you may want to disable this behavior, and instead raise an error if a value's type
+    does not match the field's type annotation.
+
+    To configure strict mode for all fields on a model, you can set `strict=True` on the model.
+
+    ```py
+    from pydantic import BaseModel, ConfigDict
+
+    class Model(BaseModel):
+        model_config = ConfigDict(strict=True)
+
+        name: str
+        age: int
+    ```
+
+    See [Strict Mode](../concepts/strict_mode.md) for more details.
+
+    See the [Conversion Table](../concepts/conversion_table.md) for more details on how Pydantic converts data in both
+    strict and lax modes.
+    """
+    # whether instances of models and dataclasses (including subclass instances) should re-validate, default 'never'
+    revalidate_instances: Literal['always', 'never', 'subclass-instances']
+    """
+    When and how to revalidate models and dataclasses during validation. Accepts the string
+    values of `'never'`, `'always'` and `'subclass-instances'`. Defaults to `'never'`.
+
+    - `'never'` will not revalidate models and dataclasses during validation
+    - `'always'` will revalidate models and dataclasses during validation
+    - `'subclass-instances'` will revalidate models and dataclasses during validation if the instance is a
+        subclass of the model or dataclass
+
+    By default, model and dataclass instances are not revalidated during validation.
+
+    ```py
+    from typing import List
+
+    from pydantic import BaseModel
+
+    class User(BaseModel, revalidate_instances='never'):  # (1)!
+        hobbies: List[str]
+
+    class SubUser(User):
+        sins: List[str]
+
+    class Transaction(BaseModel):
+        user: User
+
+    my_user = User(hobbies=['reading'])
+    t = Transaction(user=my_user)
+    print(t)
+    #> user=User(hobbies=['reading'])
+
+    my_user.hobbies = [1]  # (2)!
+    t = Transaction(user=my_user)  # (3)!
+    print(t)
+    #> user=User(hobbies=[1])
+
+    my_sub_user = SubUser(hobbies=['scuba diving'], sins=['lying'])
+    t = Transaction(user=my_sub_user)
+    print(t)
+    #> user=SubUser(hobbies=['scuba diving'], sins=['lying'])
+    ```
+
+    1. `revalidate_instances` is set to `'never'` by **default.
+    2. The assignment is not validated, unless you set `validate_assignment` to `True` in the model's config.
+    3. Since `revalidate_instances` is set to `never`, this is not revalidated.
+
+    If you want to revalidate instances during validation, you can set `revalidate_instances` to `'always'`
+    in the model's config.
+
+    ```py
+    from typing import List
+
+    from pydantic import BaseModel, ValidationError
+
+    class User(BaseModel, revalidate_instances='always'):  # (1)!
+        hobbies: List[str]
+
+    class SubUser(User):
+        sins: List[str]
+
+    class Transaction(BaseModel):
+        user: User
+
+    my_user = User(hobbies=['reading'])
+    t = Transaction(user=my_user)
+    print(t)
+    #> user=User(hobbies=['reading'])
+
+    my_user.hobbies = [1]
+    try:
+        t = Transaction(user=my_user)  # (2)!
+    except ValidationError as e:
+        print(e)
+        '''
+        1 validation error for Transaction
+        user.hobbies.0
+          Input should be a valid string [type=string_type, input_value=1, input_type=int]
+        '''
+
+    my_sub_user = SubUser(hobbies=['scuba diving'], sins=['lying'])
+    t = Transaction(user=my_sub_user)
+    print(t)  # (3)!
+    #> user=User(hobbies=['scuba diving'])
+    ```
+
+    1. `revalidate_instances` is set to `'always'`.
+    2. The model is revalidated, since `revalidate_instances` is set to `'always'`.
+    3. Using `'never'` we would have gotten `user=SubUser(hobbies=['scuba diving'], sins=['lying'])`.
+
+    It's also possible to set `revalidate_instances` to `'subclass-instances'` to only revalidate instances
+    of subclasses of the model.
+
+    ```py
+    from typing import List
+
+    from pydantic import BaseModel
+
+    class User(BaseModel, revalidate_instances='subclass-instances'):  # (1)!
+        hobbies: List[str]
+
+    class SubUser(User):
+        sins: List[str]
+
+    class Transaction(BaseModel):
+        user: User
+
+    my_user = User(hobbies=['reading'])
+    t = Transaction(user=my_user)
+    print(t)
+    #> user=User(hobbies=['reading'])
+
+    my_user.hobbies = [1]
+    t = Transaction(user=my_user)  # (2)!
+    print(t)
+    #> user=User(hobbies=[1])
+
+    my_sub_user = SubUser(hobbies=['scuba diving'], sins=['lying'])
+    t = Transaction(user=my_sub_user)
+    print(t)  # (3)!
+    #> user=User(hobbies=['scuba diving'])
+    ```
+
+    1. `revalidate_instances` is set to `'subclass-instances'`.
+    2. This is not revalidated, since `my_user` is not a subclass of `User`.
+    3. Using `'never'` we would have gotten `user=SubUser(hobbies=['scuba diving'], sins=['lying'])`.
+    """
+
+    ser_json_timedelta: Literal['iso8601', 'float']
+    """
+    The format of JSON serialized timedeltas. Accepts the string values of `'iso8601'` and
+    `'float'`. Defaults to `'iso8601'`.
+
+    - `'iso8601'` will serialize timedeltas to ISO 8601 durations.
+    - `'float'` will serialize timedeltas to the total number of seconds.
+    """
+
+    ser_json_bytes: Literal['utf8', 'base64']
+    """
+    The encoding of JSON serialized bytes. Accepts the string values of `'utf8'` and `'base64'`.
+    Defaults to `'utf8'`.
+
+    - `'utf8'` will serialize bytes to UTF-8 strings.
+    - `'base64'` will serialize bytes to URL safe base64 strings.
+    """
+
+    ser_json_inf_nan: Literal['null', 'constants']
+    """
+    The encoding of JSON serialized infinity and NaN float values. Accepts the string values of `'null'` and `'constants'`.
+    Defaults to `'null'`.
+
+    - `'null'` will serialize infinity and NaN values as `null`.
+    - `'constants'` will serialize infinity and NaN values as `Infinity` and `NaN`.
+    """
+
+    # whether to validate default values during validation, default False
+    validate_default: bool
+    """Whether to validate default values during validation. Defaults to `False`."""
+
+    validate_return: bool
+    """whether to validate the return value from call validators. Defaults to `False`."""
+
+    protected_namespaces: tuple[str, ...]
+    """
+    A `tuple` of strings that prevent model to have field which conflict with them.
+    Defaults to `('model_', )`).
+
+    Pydantic prevents collisions between model attributes and `BaseModel`'s own methods by
+    namespacing them with the prefix `model_`.
+
+    ```py
+    import warnings
+
+    from pydantic import BaseModel
+
+    warnings.filterwarnings('error')  # Raise warnings as errors
+
+    try:
+
+        class Model(BaseModel):
+            model_prefixed_field: str
+
+    except UserWarning as e:
+        print(e)
+        '''
+        Field "model_prefixed_field" has conflict with protected namespace "model_".
+
+        You may be able to resolve this warning by setting `model_config['protected_namespaces'] = ()`.
+        '''
+    ```
+
+    You can customize this behavior using the `protected_namespaces` setting:
+
+    ```py
+    import warnings
+
+    from pydantic import BaseModel, ConfigDict
+
+    warnings.filterwarnings('error')  # Raise warnings as errors
+
+    try:
+
+        class Model(BaseModel):
+            model_prefixed_field: str
+            also_protect_field: str
+
+            model_config = ConfigDict(
+                protected_namespaces=('protect_me_', 'also_protect_')
+            )
+
+    except UserWarning as e:
+        print(e)
+        '''
+        Field "also_protect_field" has conflict with protected namespace "also_protect_".
+
+        You may be able to resolve this warning by setting `model_config['protected_namespaces'] = ('protect_me_',)`.
+        '''
+    ```
+
+    While Pydantic will only emit a warning when an item is in a protected namespace but does not actually have a collision,
+    an error _is_ raised if there is an actual collision with an existing attribute:
+
+    ```py
+    from pydantic import BaseModel
+
+    try:
+
+        class Model(BaseModel):
+            model_validate: str
+
+    except NameError as e:
+        print(e)
+        '''
+        Field "model_validate" conflicts with member <bound method BaseModel.model_validate of <class 'pydantic.main.BaseModel'>> of protected namespace "model_".
+        '''
+    ```
+    """
+
+    hide_input_in_errors: bool
+    """
+    Whether to hide inputs when printing errors. Defaults to `False`.
+
+    Pydantic shows the input value and type when it raises `ValidationError` during the validation.
+
+    ```py
+    from pydantic import BaseModel, ValidationError
+
+    class Model(BaseModel):
+        a: str
+
+    try:
+        Model(a=123)
+    except ValidationError as e:
+        print(e)
+        '''
+        1 validation error for Model
+        a
+          Input should be a valid string [type=string_type, input_value=123, input_type=int]
+        '''
+    ```
+
+    You can hide the input value and type by setting the `hide_input_in_errors` config to `True`.
+
+    ```py
+    from pydantic import BaseModel, ConfigDict, ValidationError
+
+    class Model(BaseModel):
+        a: str
+        model_config = ConfigDict(hide_input_in_errors=True)
+
+    try:
+        Model(a=123)
+    except ValidationError as e:
+        print(e)
+        '''
+        1 validation error for Model
+        a
+          Input should be a valid string [type=string_type]
+        '''
+    ```
+    """
+
+    defer_build: bool
+    """
+    Whether to defer model validator and serializer construction until the first model validation.
+
+    This can be useful to avoid the overhead of building models which are only
+    used nested within other models, or when you want to manually define type namespace via
+    [`Model.model_rebuild(_types_namespace=...)`][pydantic.BaseModel.model_rebuild]. Defaults to False.
+    """
+
+    plugin_settings: dict[str, object] | None
+    """A `dict` of settings for plugins. Defaults to `None`.
+
+    See [Pydantic Plugins](../concepts/plugins.md) for details.
+    """
+
+    schema_generator: type[_GenerateSchema] | None
+    """
+    A custom core schema generator class to use when generating JSON schemas.
+    Useful if you want to change the way types are validated across an entire model/schema. Defaults to `None`.
+
+    The `GenerateSchema` interface is subject to change, currently only the `string_schema` method is public.
+
+    See [#6737](https://github.com/pydantic/pydantic/pull/6737) for details.
+    """
+
+    json_schema_serialization_defaults_required: bool
+    """
+    Whether fields with default values should be marked as required in the serialization schema. Defaults to `False`.
+
+    This ensures that the serialization schema will reflect the fact a field with a default will always be present
+    when serializing the model, even though it is not required for validation.
+
+    However, there are scenarios where this may be undesirable — in particular, if you want to share the schema
+    between validation and serialization, and don't mind fields with defaults being marked as not required during
+    serialization. See [#7209](https://github.com/pydantic/pydantic/issues/7209) for more details.
+
+    ```py
+    from pydantic import BaseModel, ConfigDict
+
+    class Model(BaseModel):
+        a: str = 'a'
+
+        model_config = ConfigDict(json_schema_serialization_defaults_required=True)
+
+    print(Model.model_json_schema(mode='validation'))
+    '''
+    {
+        'properties': {'a': {'default': 'a', 'title': 'A', 'type': 'string'}},
+        'title': 'Model',
+        'type': 'object',
     }
+    '''
+    print(Model.model_json_schema(mode='serialization'))
+    '''
+    {
+        'properties': {'a': {'default': 'a', 'title': 'A', 'type': 'string'}},
+        'required': ['a'],
+        'title': 'Model',
+        'type': 'object',
+    }
+    '''
+    ```
+    """
 
-    return type('Config', base_classes, namespace)
+    json_schema_mode_override: Literal['validation', 'serialization', None]
+    """
+    If not `None`, the specified mode will be used to generate the JSON schema regardless of what `mode` was passed to
+    the function call. Defaults to `None`.
+
+    This provides a way to force the JSON schema generation to reflect a specific mode, e.g., to always use the
+    validation schema.
+
+    It can be useful when using frameworks (such as FastAPI) that may generate different schemas for validation
+    and serialization that must both be referenced from the same schema; when this happens, we automatically append
+    `-Input` to the definition reference for the validation schema and `-Output` to the definition reference for the
+    serialization schema. By specifying a `json_schema_mode_override` though, this prevents the conflict between
+    the validation and serialization schemas (since both will use the specified schema), and so prevents the suffixes
+    from being added to the definition references.
+
+    ```py
+    from pydantic import BaseModel, ConfigDict, Json
+
+    class Model(BaseModel):
+        a: Json[int]  # requires a string to validate, but will dump an int
+
+    print(Model.model_json_schema(mode='serialization'))
+    '''
+    {
+        'properties': {'a': {'title': 'A', 'type': 'integer'}},
+        'required': ['a'],
+        'title': 'Model',
+        'type': 'object',
+    }
+    '''
+
+    class ForceInputModel(Model):
+        # the following ensures that even with mode='serialization', we
+        # will get the schema that would be generated for validation.
+        model_config = ConfigDict(json_schema_mode_override='validation')
+
+    print(ForceInputModel.model_json_schema(mode='serialization'))
+    '''
+    {
+        'properties': {
+            'a': {
+                'contentMediaType': 'application/json',
+                'contentSchema': {'type': 'integer'},
+                'title': 'A',
+                'type': 'string',
+            }
+        },
+        'required': ['a'],
+        'title': 'ForceInputModel',
+        'type': 'object',
+    }
+    '''
+    ```
+    """
+
+    coerce_numbers_to_str: bool
+    """
+    If `True`, enables automatic coercion of any `Number` type to `str` in "lax" (non-strict) mode. Defaults to `False`.
+
+    Pydantic doesn't allow number types (`int`, `float`, `Decimal`) to be coerced as type `str` by default.
+
+    ```py
+    from decimal import Decimal
+
+    from pydantic import BaseModel, ConfigDict, ValidationError
+
+    class Model(BaseModel):
+        value: str
+
+    try:
+        print(Model(value=42))
+    except ValidationError as e:
+        print(e)
+        '''
+        1 validation error for Model
+        value
+          Input should be a valid string [type=string_type, input_value=42, input_type=int]
+        '''
+
+    class Model(BaseModel):
+        model_config = ConfigDict(coerce_numbers_to_str=True)
+
+        value: str
+
+    repr(Model(value=42).value)
+    #> "42"
+    repr(Model(value=42.13).value)
+    #> "42.13"
+    repr(Model(value=Decimal('42.13')).value)
+    #> "42.13"
+    ```
+    """
+
+    regex_engine: Literal['rust-regex', 'python-re']
+    """
+    The regex engine to used for pattern validation
+    Defaults to `'rust-regex'`.
+
+    - `rust-regex` uses the [`regex`](https://docs.rs/regex) Rust crate,
+      which is non-backtracking and therefore more DDoS resistant, but does not support all regex features.
+    - `python-re` use the [`re`](https://docs.python.org/3/library/re.html) module,
+      which supports all regex features, but may be slower.
+
+    ```py
+    from pydantic import BaseModel, ConfigDict, Field, ValidationError
+
+    class Model(BaseModel):
+        model_config = ConfigDict(regex_engine='python-re')
+
+        value: str = Field(pattern=r'^abc(?=def)')
+
+    print(Model(value='abcdef').value)
+    #> abcdef
+
+    try:
+        print(Model(value='abxyzcdef'))
+    except ValidationError as e:
+        print(e)
+        '''
+        1 validation error for Model
+        value
+          String should match pattern '^abc(?=def)' [type=string_pattern_mismatch, input_value='abxyzcdef', input_type=str]
+        '''
+    ```
+    """
+
+    validation_error_cause: bool
+    """
+    If `True`, python exceptions that were part of a validation failure will be shown as an exception group as a cause. Can be useful for debugging. Defaults to `False`.
+
+    Note:
+        Python 3.10 and older don't support exception groups natively. <=3.10, backport must be installed: `pip install exceptiongroup`.
+
+    Note:
+        The structure of validation errors are likely to change in future pydantic versions. Pydantic offers no guarantees about the structure of validation errors. Should be used for visual traceback debugging only.
+    """
 
 
-def prepare_config(config: Type[BaseConfig], cls_name: str) -> None:
-    if not isinstance(config.extra, Extra):
-        try:
-            config.extra = Extra(config.extra)
-        except ValueError:
-            raise ValueError(f'"{cls_name}": {config.extra} is not a valid value for "extra"')
+__getattr__ = getattr_migration(__name__)
diff --git a/lib/pydantic/dataclasses.py b/lib/pydantic/dataclasses.py
index 68331127..d9c9c903 100644
--- a/lib/pydantic/dataclasses.py
+++ b/lib/pydantic/dataclasses.py
@@ -1,479 +1,327 @@
-"""
-The main purpose is to enhance stdlib dataclasses by adding validation
-A pydantic dataclass can be generated from scratch or from a stdlib one.
+"""Provide an enhanced dataclass that performs validation."""
+from __future__ import annotations as _annotations
 
-Behind the scene, a pydantic dataclass is just like a regular one on which we attach
-a `BaseModel` and magic methods to trigger the validation of the data.
-`__init__` and `__post_init__` are hence overridden and have extra logic to be
-able to validate input data.
-
-When a pydantic dataclass is generated from scratch, it's just a plain dataclass
-with validation triggered at initialization
-
-The tricky part if for stdlib dataclasses that are converted after into pydantic ones e.g.
-
-```py
-@dataclasses.dataclass
-class M:
-    x: int
-
-ValidatedM = pydantic.dataclasses.dataclass(M)
-```
-
-We indeed still want to support equality, hashing, repr, ... as if it was the stdlib one!
-
-```py
-assert isinstance(ValidatedM(x=1), M)
-assert ValidatedM(x=1) == M(x=1)
-```
-
-This means we **don't want to create a new dataclass that inherits from it**
-The trick is to create a wrapper around `M` that will act as a proxy to trigger
-validation without altering default `M` behaviour.
-"""
+import dataclasses
 import sys
-from contextlib import contextmanager
-from functools import wraps
-from typing import (
-    TYPE_CHECKING,
-    Any,
-    Callable,
-    ClassVar,
-    Dict,
-    Generator,
-    Optional,
-    Set,
-    Type,
-    TypeVar,
-    Union,
-    overload,
-)
+import types
+from typing import TYPE_CHECKING, Any, Callable, Generic, NoReturn, TypeVar, overload
 
-from typing_extensions import dataclass_transform
+from typing_extensions import Literal, TypeGuard, dataclass_transform
 
-from .class_validators import gather_all_validators
-from .config import BaseConfig, ConfigDict, Extra, get_config
-from .error_wrappers import ValidationError
-from .errors import DataclassTypeError
-from .fields import Field, FieldInfo, Required, Undefined
-from .main import create_model, validate_model
-from .utils import ClassAttribute
+from ._internal import _config, _decorators, _typing_extra
+from ._internal import _dataclasses as _pydantic_dataclasses
+from ._migration import getattr_migration
+from .config import ConfigDict
+from .fields import Field, FieldInfo
 
 if TYPE_CHECKING:
-    from .main import BaseModel
-    from .typing import CallableGenerator, NoArgAnyCallable
+    from ._internal._dataclasses import PydanticDataclass
 
-    DataclassT = TypeVar('DataclassT', bound='Dataclass')
-
-    DataclassClassOrWrapper = Union[Type['Dataclass'], 'DataclassProxy']
-
-    class Dataclass:
-        # stdlib attributes
-        __dataclass_fields__: ClassVar[Dict[str, Any]]
-        __dataclass_params__: ClassVar[Any]  # in reality `dataclasses._DataclassParams`
-        __post_init__: ClassVar[Callable[..., None]]
-
-        # Added by pydantic
-        __pydantic_run_validation__: ClassVar[bool]
-        __post_init_post_parse__: ClassVar[Callable[..., None]]
-        __pydantic_initialised__: ClassVar[bool]
-        __pydantic_model__: ClassVar[Type[BaseModel]]
-        __pydantic_validate_values__: ClassVar[Callable[['Dataclass'], None]]
-        __pydantic_has_field_info_default__: ClassVar[bool]  # whether a `pydantic.Field` is used as default value
-
-        def __init__(self, *args: object, **kwargs: object) -> None:
-            pass
-
-        @classmethod
-        def __get_validators__(cls: Type['Dataclass']) -> 'CallableGenerator':
-            pass
-
-        @classmethod
-        def __validate__(cls: Type['DataclassT'], v: Any) -> 'DataclassT':
-            pass
-
-
-__all__ = [
-    'dataclass',
-    'set_validation',
-    'create_pydantic_model_from_dataclass',
-    'is_builtin_dataclass',
-    'make_dataclass_validator',
-]
+__all__ = 'dataclass', 'rebuild_dataclass'
 
 _T = TypeVar('_T')
 
 if sys.version_info >= (3, 10):
 
-    @dataclass_transform(kw_only_default=True, field_descriptors=(Field, FieldInfo))
+    @dataclass_transform(field_specifiers=(dataclasses.field, Field))
     @overload
     def dataclass(
         *,
-        init: bool = True,
+        init: Literal[False] = False,
         repr: bool = True,
         eq: bool = True,
         order: bool = False,
         unsafe_hash: bool = False,
         frozen: bool = False,
-        config: Union[ConfigDict, Type[object], None] = None,
-        validate_on_init: Optional[bool] = None,
+        config: ConfigDict | type[object] | None = None,
+        validate_on_init: bool | None = None,
         kw_only: bool = ...,
-    ) -> Callable[[Type[_T]], 'DataclassClassOrWrapper']:
+        slots: bool = ...,
+    ) -> Callable[[type[_T]], type[PydanticDataclass]]:  # type: ignore
         ...
 
-    @dataclass_transform(kw_only_default=True, field_descriptors=(Field, FieldInfo))
+    @dataclass_transform(field_specifiers=(dataclasses.field, Field))
     @overload
     def dataclass(
-        _cls: Type[_T],
+        _cls: type[_T],  # type: ignore
         *,
-        init: bool = True,
+        init: Literal[False] = False,
         repr: bool = True,
         eq: bool = True,
         order: bool = False,
         unsafe_hash: bool = False,
         frozen: bool = False,
-        config: Union[ConfigDict, Type[object], None] = None,
-        validate_on_init: Optional[bool] = None,
+        config: ConfigDict | type[object] | None = None,
+        validate_on_init: bool | None = None,
         kw_only: bool = ...,
-    ) -> 'DataclassClassOrWrapper':
+        slots: bool = ...,
+    ) -> type[PydanticDataclass]:
         ...
 
 else:
 
-    @dataclass_transform(kw_only_default=True, field_descriptors=(Field, FieldInfo))
+    @dataclass_transform(field_specifiers=(dataclasses.field, Field))
     @overload
     def dataclass(
         *,
-        init: bool = True,
+        init: Literal[False] = False,
         repr: bool = True,
         eq: bool = True,
         order: bool = False,
         unsafe_hash: bool = False,
         frozen: bool = False,
-        config: Union[ConfigDict, Type[object], None] = None,
-        validate_on_init: Optional[bool] = None,
-    ) -> Callable[[Type[_T]], 'DataclassClassOrWrapper']:
+        config: ConfigDict | type[object] | None = None,
+        validate_on_init: bool | None = None,
+    ) -> Callable[[type[_T]], type[PydanticDataclass]]:  # type: ignore
         ...
 
-    @dataclass_transform(kw_only_default=True, field_descriptors=(Field, FieldInfo))
+    @dataclass_transform(field_specifiers=(dataclasses.field, Field))
     @overload
     def dataclass(
-        _cls: Type[_T],
+        _cls: type[_T],  # type: ignore
         *,
-        init: bool = True,
+        init: Literal[False] = False,
         repr: bool = True,
         eq: bool = True,
         order: bool = False,
         unsafe_hash: bool = False,
         frozen: bool = False,
-        config: Union[ConfigDict, Type[object], None] = None,
-        validate_on_init: Optional[bool] = None,
-    ) -> 'DataclassClassOrWrapper':
+        config: ConfigDict | type[object] | None = None,
+        validate_on_init: bool | None = None,
+    ) -> type[PydanticDataclass]:
         ...
 
 
-@dataclass_transform(kw_only_default=True, field_descriptors=(Field, FieldInfo))
-def dataclass(
-    _cls: Optional[Type[_T]] = None,
+@dataclass_transform(field_specifiers=(dataclasses.field, Field))
+def dataclass(  # noqa: C901
+    _cls: type[_T] | None = None,
     *,
-    init: bool = True,
+    init: Literal[False] = False,
     repr: bool = True,
     eq: bool = True,
     order: bool = False,
     unsafe_hash: bool = False,
     frozen: bool = False,
-    config: Union[ConfigDict, Type[object], None] = None,
-    validate_on_init: Optional[bool] = None,
+    config: ConfigDict | type[object] | None = None,
+    validate_on_init: bool | None = None,
     kw_only: bool = False,
-) -> Union[Callable[[Type[_T]], 'DataclassClassOrWrapper'], 'DataclassClassOrWrapper']:
+    slots: bool = False,
+) -> Callable[[type[_T]], type[PydanticDataclass]] | type[PydanticDataclass]:
+    """Usage docs: https://docs.pydantic.dev/2.6/concepts/dataclasses/
+
+    A decorator used to create a Pydantic-enhanced dataclass, similar to the standard Python `dataclass`,
+    but with added validation.
+
+    This function should be used similarly to `dataclasses.dataclass`.
+
+    Args:
+        _cls: The target `dataclass`.
+        init: Included for signature compatibility with `dataclasses.dataclass`, and is passed through to
+            `dataclasses.dataclass` when appropriate. If specified, must be set to `False`, as pydantic inserts its
+            own  `__init__` function.
+        repr: A boolean indicating whether to include the field in the `__repr__` output.
+        eq: Determines if a `__eq__` method should be generated for the class.
+        order: Determines if comparison magic methods should be generated, such as `__lt__`, but not `__eq__`.
+        unsafe_hash: Determines if a `__hash__` method should be included in the class, as in `dataclasses.dataclass`.
+        frozen: Determines if the generated class should be a 'frozen' `dataclass`, which does not allow its
+            attributes to be modified after it has been initialized.
+        config: The Pydantic config to use for the `dataclass`.
+        validate_on_init: A deprecated parameter included for backwards compatibility; in V2, all Pydantic dataclasses
+            are validated on init.
+        kw_only: Determines if `__init__` method parameters must be specified by keyword only. Defaults to `False`.
+        slots: Determines if the generated class should be a 'slots' `dataclass`, which does not allow the addition of
+            new attributes after instantiation.
+
+    Returns:
+        A decorator that accepts a class as its argument and returns a Pydantic `dataclass`.
+
+    Raises:
+        AssertionError: Raised if `init` is not `False` or `validate_on_init` is `False`.
     """
-    Like the python standard lib dataclasses but with type validation.
-    The result is either a pydantic dataclass that will validate input data
-    or a wrapper that will trigger validation around a stdlib dataclass
-    to avoid modifying it directly
-    """
-    the_config = get_config(config)
+    assert init is False, 'pydantic.dataclasses.dataclass only supports init=False'
+    assert validate_on_init is not False, 'validate_on_init=False is no longer supported'
 
-    def wrap(cls: Type[Any]) -> 'DataclassClassOrWrapper':
-        import dataclasses
+    if sys.version_info >= (3, 10):
+        kwargs = dict(kw_only=kw_only, slots=slots)
+    else:
+        kwargs = {}
 
-        if is_builtin_dataclass(cls) and _extra_dc_args(_cls) == _extra_dc_args(_cls.__bases__[0]):  # type: ignore
-            dc_cls_doc = ''
-            dc_cls = DataclassProxy(cls)
-            default_validate_on_init = False
-        else:
-            dc_cls_doc = cls.__doc__ or ''  # needs to be done before generating dataclass
-            if sys.version_info >= (3, 10):
-                dc_cls = dataclasses.dataclass(
-                    cls,
-                    init=init,
-                    repr=repr,
-                    eq=eq,
-                    order=order,
-                    unsafe_hash=unsafe_hash,
-                    frozen=frozen,
-                    kw_only=kw_only,
-                )
-            else:
-                dc_cls = dataclasses.dataclass(  # type: ignore
-                    cls, init=init, repr=repr, eq=eq, order=order, unsafe_hash=unsafe_hash, frozen=frozen
-                )
-            default_validate_on_init = True
+    def make_pydantic_fields_compatible(cls: type[Any]) -> None:
+        """Make sure that stdlib `dataclasses` understands `Field` kwargs like `kw_only`
+        To do that, we simply change
+          `x: int = pydantic.Field(..., kw_only=True)`
+        into
+          `x: int = dataclasses.field(default=pydantic.Field(..., kw_only=True), kw_only=True)`
+        """
+        for annotation_cls in cls.__mro__:
+            # In Python < 3.9, `__annotations__` might not be present if there are no fields.
+            # we therefore need to use `getattr` to avoid an `AttributeError`.
+            annotations = getattr(annotation_cls, '__annotations__', [])
+            for field_name in annotations:
+                field_value = getattr(cls, field_name, None)
+                # Process only if this is an instance of `FieldInfo`.
+                if not isinstance(field_value, FieldInfo):
+                    continue
 
-        should_validate_on_init = default_validate_on_init if validate_on_init is None else validate_on_init
-        _add_pydantic_validation_attributes(cls, the_config, should_validate_on_init, dc_cls_doc)
-        dc_cls.__pydantic_model__.__try_update_forward_refs__(**{cls.__name__: cls})
-        return dc_cls
+                # Initialize arguments for the standard `dataclasses.field`.
+                field_args: dict = {'default': field_value}
+
+                # Handle `kw_only` for Python 3.10+
+                if sys.version_info >= (3, 10) and field_value.kw_only:
+                    field_args['kw_only'] = True
+
+                # Set `repr` attribute if it's explicitly specified to be not `True`.
+                if field_value.repr is not True:
+                    field_args['repr'] = field_value.repr
+
+                setattr(cls, field_name, dataclasses.field(**field_args))
+                # In Python 3.8, dataclasses checks cls.__dict__['__annotations__'] for annotations,
+                # so we must make sure it's initialized before we add to it.
+                if cls.__dict__.get('__annotations__') is None:
+                    cls.__annotations__ = {}
+                cls.__annotations__[field_name] = annotations[field_name]
+
+    def create_dataclass(cls: type[Any]) -> type[PydanticDataclass]:
+        """Create a Pydantic dataclass from a regular dataclass.
+
+        Args:
+            cls: The class to create the Pydantic dataclass from.
+
+        Returns:
+            A Pydantic dataclass.
+        """
+        original_cls = cls
+
+        config_dict = config
+        if config_dict is None:
+            # if not explicitly provided, read from the type
+            cls_config = getattr(cls, '__pydantic_config__', None)
+            if cls_config is not None:
+                config_dict = cls_config
+        config_wrapper = _config.ConfigWrapper(config_dict)
+        decorators = _decorators.DecoratorInfos.build(cls)
+
+        # Keep track of the original __doc__ so that we can restore it after applying the dataclasses decorator
+        # Otherwise, classes with no __doc__ will have their signature added into the JSON schema description,
+        # since dataclasses.dataclass will set this as the __doc__
+        original_doc = cls.__doc__
+
+        if _pydantic_dataclasses.is_builtin_dataclass(cls):
+            # Don't preserve the docstring for vanilla dataclasses, as it may include the signature
+            # This matches v1 behavior, and there was an explicit test for it
+            original_doc = None
+
+            # We don't want to add validation to the existing std lib dataclass, so we will subclass it
+            #   If the class is generic, we need to make sure the subclass also inherits from Generic
+            #   with all the same parameters.
+            bases = (cls,)
+            if issubclass(cls, Generic):
+                generic_base = Generic[cls.__parameters__]  # type: ignore
+                bases = bases + (generic_base,)
+            cls = types.new_class(cls.__name__, bases)
+
+        make_pydantic_fields_compatible(cls)
+
+        cls = dataclasses.dataclass(  # type: ignore[call-overload]
+            cls,
+            # the value of init here doesn't affect anything except that it makes it easier to generate a signature
+            init=True,
+            repr=repr,
+            eq=eq,
+            order=order,
+            unsafe_hash=unsafe_hash,
+            frozen=frozen,
+            **kwargs,
+        )
+
+        cls.__pydantic_decorators__ = decorators  # type: ignore
+        cls.__doc__ = original_doc
+        cls.__module__ = original_cls.__module__
+        cls.__qualname__ = original_cls.__qualname__
+        pydantic_complete = _pydantic_dataclasses.complete_dataclass(
+            cls, config_wrapper, raise_errors=False, types_namespace=None
+        )
+        cls.__pydantic_complete__ = pydantic_complete  # type: ignore
+        return cls
 
     if _cls is None:
-        return wrap
+        return create_dataclass
 
-    return wrap(_cls)
+    return create_dataclass(_cls)
 
 
-@contextmanager
-def set_validation(cls: Type['DataclassT'], value: bool) -> Generator[Type['DataclassT'], None, None]:
-    original_run_validation = cls.__pydantic_run_validation__
-    try:
-        cls.__pydantic_run_validation__ = value
-        yield cls
-    finally:
-        cls.__pydantic_run_validation__ = original_run_validation
+__getattr__ = getattr_migration(__name__)
+
+if (3, 8) <= sys.version_info < (3, 11):
+    # Monkeypatch dataclasses.InitVar so that typing doesn't error if it occurs as a type when evaluating type hints
+    # Starting in 3.11, typing.get_type_hints will not raise an error if the retrieved type hints are not callable.
+
+    def _call_initvar(*args: Any, **kwargs: Any) -> NoReturn:
+        """This function does nothing but raise an error that is as similar as possible to what you'd get
+        if you were to try calling `InitVar[int]()` without this monkeypatch. The whole purpose is just
+        to ensure typing._type_check does not error if the type hint evaluates to `InitVar[<parameter>]`.
+        """
+        raise TypeError("'InitVar' object is not callable")
+
+    dataclasses.InitVar.__call__ = _call_initvar
 
 
-class DataclassProxy:
-    __slots__ = '__dataclass__'
+def rebuild_dataclass(
+    cls: type[PydanticDataclass],
+    *,
+    force: bool = False,
+    raise_errors: bool = True,
+    _parent_namespace_depth: int = 2,
+    _types_namespace: dict[str, Any] | None = None,
+) -> bool | None:
+    """Try to rebuild the pydantic-core schema for the dataclass.
 
-    def __init__(self, dc_cls: Type['Dataclass']) -> None:
-        object.__setattr__(self, '__dataclass__', dc_cls)
+    This may be necessary when one of the annotations is a ForwardRef which could not be resolved during
+    the initial attempt to build the schema, and automatic rebuilding fails.
 
-    def __call__(self, *args: Any, **kwargs: Any) -> Any:
-        with set_validation(self.__dataclass__, True):
-            return self.__dataclass__(*args, **kwargs)
+    This is analogous to `BaseModel.model_rebuild`.
 
-    def __getattr__(self, name: str) -> Any:
-        return getattr(self.__dataclass__, name)
+    Args:
+        cls: The class to rebuild the pydantic-core schema for.
+        force: Whether to force the rebuilding of the schema, defaults to `False`.
+        raise_errors: Whether to raise errors, defaults to `True`.
+        _parent_namespace_depth: The depth level of the parent namespace, defaults to 2.
+        _types_namespace: The types namespace, defaults to `None`.
 
-    def __instancecheck__(self, instance: Any) -> bool:
-        return isinstance(instance, self.__dataclass__)
-
-
-def _add_pydantic_validation_attributes(  # noqa: C901 (ignore complexity)
-    dc_cls: Type['Dataclass'],
-    config: Type[BaseConfig],
-    validate_on_init: bool,
-    dc_cls_doc: str,
-) -> None:
+    Returns:
+        Returns `None` if the schema is already "complete" and rebuilding was not required.
+        If rebuilding _was_ required, returns `True` if rebuilding was successful, otherwise `False`.
     """
-    We need to replace the right method. If no `__post_init__` has been set in the stdlib dataclass
-    it won't even exist (code is generated on the fly by `dataclasses`)
-    By default, we run validation after `__init__` or `__post_init__` if defined
-    """
-    init = dc_cls.__init__
-
-    @wraps(init)
-    def handle_extra_init(self: 'Dataclass', *args: Any, **kwargs: Any) -> None:
-        if config.extra == Extra.ignore:
-            init(self, *args, **{k: v for k, v in kwargs.items() if k in self.__dataclass_fields__})
-
-        elif config.extra == Extra.allow:
-            for k, v in kwargs.items():
-                self.__dict__.setdefault(k, v)
-            init(self, *args, **{k: v for k, v in kwargs.items() if k in self.__dataclass_fields__})
-
-        else:
-            init(self, *args, **kwargs)
-
-    if hasattr(dc_cls, '__post_init__'):
-        post_init = dc_cls.__post_init__
-
-        @wraps(post_init)
-        def new_post_init(self: 'Dataclass', *args: Any, **kwargs: Any) -> None:
-            if config.post_init_call == 'before_validation':
-                post_init(self, *args, **kwargs)
-
-            if self.__class__.__pydantic_run_validation__:
-                self.__pydantic_validate_values__()
-                if hasattr(self, '__post_init_post_parse__'):
-                    self.__post_init_post_parse__(*args, **kwargs)
-
-            if config.post_init_call == 'after_validation':
-                post_init(self, *args, **kwargs)
-
-        setattr(dc_cls, '__init__', handle_extra_init)
-        setattr(dc_cls, '__post_init__', new_post_init)
-
+    if not force and cls.__pydantic_complete__:
+        return None
     else:
-
-        @wraps(init)
-        def new_init(self: 'Dataclass', *args: Any, **kwargs: Any) -> None:
-            handle_extra_init(self, *args, **kwargs)
-
-            if self.__class__.__pydantic_run_validation__:
-                self.__pydantic_validate_values__()
-
-            if hasattr(self, '__post_init_post_parse__'):
-                # We need to find again the initvars. To do that we use `__dataclass_fields__` instead of
-                # public method `dataclasses.fields`
-                import dataclasses
-
-                # get all initvars and their default values
-                initvars_and_values: Dict[str, Any] = {}
-                for i, f in enumerate(self.__class__.__dataclass_fields__.values()):
-                    if f._field_type is dataclasses._FIELD_INITVAR:  # type: ignore[attr-defined]
-                        try:
-                            # set arg value by default
-                            initvars_and_values[f.name] = args[i]
-                        except IndexError:
-                            initvars_and_values[f.name] = kwargs.get(f.name, f.default)
-
-                self.__post_init_post_parse__(**initvars_and_values)
-
-        setattr(dc_cls, '__init__', new_init)
-
-    setattr(dc_cls, '__pydantic_run_validation__', ClassAttribute('__pydantic_run_validation__', validate_on_init))
-    setattr(dc_cls, '__pydantic_initialised__', False)
-    setattr(dc_cls, '__pydantic_model__', create_pydantic_model_from_dataclass(dc_cls, config, dc_cls_doc))
-    setattr(dc_cls, '__pydantic_validate_values__', _dataclass_validate_values)
-    setattr(dc_cls, '__validate__', classmethod(_validate_dataclass))
-    setattr(dc_cls, '__get_validators__', classmethod(_get_validators))
-
-    if dc_cls.__pydantic_model__.__config__.validate_assignment and not dc_cls.__dataclass_params__.frozen:
-        setattr(dc_cls, '__setattr__', _dataclass_validate_assignment_setattr)
-
-
-def _get_validators(cls: 'DataclassClassOrWrapper') -> 'CallableGenerator':
-    yield cls.__validate__
-
-
-def _validate_dataclass(cls: Type['DataclassT'], v: Any) -> 'DataclassT':
-    with set_validation(cls, True):
-        if isinstance(v, cls):
-            v.__pydantic_validate_values__()
-            return v
-        elif isinstance(v, (list, tuple)):
-            return cls(*v)
-        elif isinstance(v, dict):
-            return cls(**v)
+        if _types_namespace is not None:
+            types_namespace: dict[str, Any] | None = _types_namespace.copy()
         else:
-            raise DataclassTypeError(class_name=cls.__name__)
+            if _parent_namespace_depth > 0:
+                frame_parent_ns = _typing_extra.parent_frame_namespace(parent_depth=_parent_namespace_depth) or {}
+                # Note: we may need to add something similar to cls.__pydantic_parent_namespace__ from BaseModel
+                #   here when implementing handling of recursive generics. See BaseModel.model_rebuild for reference.
+                types_namespace = frame_parent_ns
+            else:
+                types_namespace = {}
+
+            types_namespace = _typing_extra.get_cls_types_namespace(cls, types_namespace)
+        return _pydantic_dataclasses.complete_dataclass(
+            cls,
+            _config.ConfigWrapper(cls.__pydantic_config__, check=False),
+            raise_errors=raise_errors,
+            types_namespace=types_namespace,
+        )
 
 
-def create_pydantic_model_from_dataclass(
-    dc_cls: Type['Dataclass'],
-    config: Type[Any] = BaseConfig,
-    dc_cls_doc: Optional[str] = None,
-) -> Type['BaseModel']:
-    import dataclasses
+def is_pydantic_dataclass(__cls: type[Any]) -> TypeGuard[type[PydanticDataclass]]:
+    """Whether a class is a pydantic dataclass.
 
-    field_definitions: Dict[str, Any] = {}
-    for field in dataclasses.fields(dc_cls):
-        default: Any = Undefined
-        default_factory: Optional['NoArgAnyCallable'] = None
-        field_info: FieldInfo
+    Args:
+        __cls: The class.
 
-        if field.default is not dataclasses.MISSING:
-            default = field.default
-        elif field.default_factory is not dataclasses.MISSING:
-            default_factory = field.default_factory
-        else:
-            default = Required
-
-        if isinstance(default, FieldInfo):
-            field_info = default
-            dc_cls.__pydantic_has_field_info_default__ = True
-        else:
-            field_info = Field(default=default, default_factory=default_factory, **field.metadata)
-
-        field_definitions[field.name] = (field.type, field_info)
-
-    validators = gather_all_validators(dc_cls)
-    model: Type['BaseModel'] = create_model(
-        dc_cls.__name__,
-        __config__=config,
-        __module__=dc_cls.__module__,
-        __validators__=validators,
-        __cls_kwargs__={'__resolve_forward_refs__': False},
-        **field_definitions,
-    )
-    model.__doc__ = dc_cls_doc if dc_cls_doc is not None else dc_cls.__doc__ or ''
-    return model
-
-
-def _dataclass_validate_values(self: 'Dataclass') -> None:
-    # validation errors can occur if this function is called twice on an already initialised dataclass.
-    # for example if Extra.forbid is enabled, it would consider __pydantic_initialised__ an invalid extra property
-    if getattr(self, '__pydantic_initialised__'):
-        return
-    if getattr(self, '__pydantic_has_field_info_default__', False):
-        # We need to remove `FieldInfo` values since they are not valid as input
-        # It's ok to do that because they are obviously the default values!
-        input_data = {k: v for k, v in self.__dict__.items() if not isinstance(v, FieldInfo)}
-    else:
-        input_data = self.__dict__
-    d, _, validation_error = validate_model(self.__pydantic_model__, input_data, cls=self.__class__)
-    if validation_error:
-        raise validation_error
-    self.__dict__.update(d)
-    object.__setattr__(self, '__pydantic_initialised__', True)
-
-
-def _dataclass_validate_assignment_setattr(self: 'Dataclass', name: str, value: Any) -> None:
-    if self.__pydantic_initialised__:
-        d = dict(self.__dict__)
-        d.pop(name, None)
-        known_field = self.__pydantic_model__.__fields__.get(name, None)
-        if known_field:
-            value, error_ = known_field.validate(value, d, loc=name, cls=self.__class__)
-            if error_:
-                raise ValidationError([error_], self.__class__)
-
-    object.__setattr__(self, name, value)
-
-
-def _extra_dc_args(cls: Type[Any]) -> Set[str]:
-    return {
-        x
-        for x in dir(cls)
-        if x not in getattr(cls, '__dataclass_fields__', {}) and not (x.startswith('__') and x.endswith('__'))
-    }
-
-
-def is_builtin_dataclass(_cls: Type[Any]) -> bool:
+    Returns:
+        `True` if the class is a pydantic dataclass, `False` otherwise.
     """
-    Whether a class is a stdlib dataclass
-    (useful to discriminated a pydantic dataclass that is actually a wrapper around a stdlib dataclass)
-
-    we check that
-    - `_cls` is a dataclass
-    - `_cls` is not a processed pydantic dataclass (with a basemodel attached)
-    - `_cls` is not a pydantic dataclass inheriting directly from a stdlib dataclass
-    e.g.
-    ```
-    @dataclasses.dataclass
-    class A:
-        x: int
-
-    @pydantic.dataclasses.dataclass
-    class B(A):
-        y: int
-    ```
-    In this case, when we first check `B`, we make an extra check and look at the annotations ('y'),
-    which won't be a superset of all the dataclass fields (only the stdlib fields i.e. 'x')
-    """
-    import dataclasses
-
-    return (
-        dataclasses.is_dataclass(_cls)
-        and not hasattr(_cls, '__pydantic_model__')
-        and set(_cls.__dataclass_fields__).issuperset(set(getattr(_cls, '__annotations__', {})))
-    )
-
-
-def make_dataclass_validator(dc_cls: Type['Dataclass'], config: Type[BaseConfig]) -> 'CallableGenerator':
-    """
-    Create a pydantic.dataclass from a builtin dataclass to add type validation
-    and yield the validators
-    It retrieves the parameters of the dataclass and forwards them to the newly created dataclass
-    """
-    yield from _get_validators(dataclass(dc_cls, config=config, validate_on_init=False))
+    return dataclasses.is_dataclass(__cls) and '__pydantic_validator__' in __cls.__dict__
diff --git a/lib/pydantic/datetime_parse.py b/lib/pydantic/datetime_parse.py
index cfd54593..902219df 100644
--- a/lib/pydantic/datetime_parse.py
+++ b/lib/pydantic/datetime_parse.py
@@ -1,248 +1,4 @@
-"""
-Functions to parse datetime objects.
+"""The `datetime_parse` module is a backport module from V1."""
+from ._migration import getattr_migration
 
-We're using regular expressions rather than time.strptime because:
-- They provide both validation and parsing.
-- They're more flexible for datetimes.
-- The date/datetime/time constructors produce friendlier error messages.
-
-Stolen from https://raw.githubusercontent.com/django/django/main/django/utils/dateparse.py at
-9718fa2e8abe430c3526a9278dd976443d4ae3c6
-
-Changed to:
-* use standard python datetime types not django.utils.timezone
-* raise ValueError when regex doesn't match rather than returning None
-* support parsing unix timestamps for dates and datetimes
-"""
-import re
-from datetime import date, datetime, time, timedelta, timezone
-from typing import Dict, Optional, Type, Union
-
-from . import errors
-
-date_expr = r'(?P<year>\d{4})-(?P<month>\d{1,2})-(?P<day>\d{1,2})'
-time_expr = (
-    r'(?P<hour>\d{1,2}):(?P<minute>\d{1,2})'
-    r'(?::(?P<second>\d{1,2})(?:\.(?P<microsecond>\d{1,6})\d{0,6})?)?'
-    r'(?P<tzinfo>Z|[+-]\d{2}(?::?\d{2})?)?$'
-)
-
-date_re = re.compile(f'{date_expr}$')
-time_re = re.compile(time_expr)
-datetime_re = re.compile(f'{date_expr}[T ]{time_expr}')
-
-standard_duration_re = re.compile(
-    r'^'
-    r'(?:(?P<days>-?\d+) (days?, )?)?'
-    r'((?:(?P<hours>-?\d+):)(?=\d+:\d+))?'
-    r'(?:(?P<minutes>-?\d+):)?'
-    r'(?P<seconds>-?\d+)'
-    r'(?:\.(?P<microseconds>\d{1,6})\d{0,6})?'
-    r'$'
-)
-
-# Support the sections of ISO 8601 date representation that are accepted by timedelta
-iso8601_duration_re = re.compile(
-    r'^(?P<sign>[-+]?)'
-    r'P'
-    r'(?:(?P<days>\d+(.\d+)?)D)?'
-    r'(?:T'
-    r'(?:(?P<hours>\d+(.\d+)?)H)?'
-    r'(?:(?P<minutes>\d+(.\d+)?)M)?'
-    r'(?:(?P<seconds>\d+(.\d+)?)S)?'
-    r')?'
-    r'$'
-)
-
-EPOCH = datetime(1970, 1, 1)
-# if greater than this, the number is in ms, if less than or equal it's in seconds
-# (in seconds this is 11th October 2603, in ms it's 20th August 1970)
-MS_WATERSHED = int(2e10)
-# slightly more than datetime.max in ns - (datetime.max - EPOCH).total_seconds() * 1e9
-MAX_NUMBER = int(3e20)
-StrBytesIntFloat = Union[str, bytes, int, float]
-
-
-def get_numeric(value: StrBytesIntFloat, native_expected_type: str) -> Union[None, int, float]:
-    if isinstance(value, (int, float)):
-        return value
-    try:
-        return float(value)
-    except ValueError:
-        return None
-    except TypeError:
-        raise TypeError(f'invalid type; expected {native_expected_type}, string, bytes, int or float')
-
-
-def from_unix_seconds(seconds: Union[int, float]) -> datetime:
-    if seconds > MAX_NUMBER:
-        return datetime.max
-    elif seconds < -MAX_NUMBER:
-        return datetime.min
-
-    while abs(seconds) > MS_WATERSHED:
-        seconds /= 1000
-    dt = EPOCH + timedelta(seconds=seconds)
-    return dt.replace(tzinfo=timezone.utc)
-
-
-def _parse_timezone(value: Optional[str], error: Type[Exception]) -> Union[None, int, timezone]:
-    if value == 'Z':
-        return timezone.utc
-    elif value is not None:
-        offset_mins = int(value[-2:]) if len(value) > 3 else 0
-        offset = 60 * int(value[1:3]) + offset_mins
-        if value[0] == '-':
-            offset = -offset
-        try:
-            return timezone(timedelta(minutes=offset))
-        except ValueError:
-            raise error()
-    else:
-        return None
-
-
-def parse_date(value: Union[date, StrBytesIntFloat]) -> date:
-    """
-    Parse a date/int/float/string and return a datetime.date.
-
-    Raise ValueError if the input is well formatted but not a valid date.
-    Raise ValueError if the input isn't well formatted.
-    """
-    if isinstance(value, date):
-        if isinstance(value, datetime):
-            return value.date()
-        else:
-            return value
-
-    number = get_numeric(value, 'date')
-    if number is not None:
-        return from_unix_seconds(number).date()
-
-    if isinstance(value, bytes):
-        value = value.decode()
-
-    match = date_re.match(value)  # type: ignore
-    if match is None:
-        raise errors.DateError()
-
-    kw = {k: int(v) for k, v in match.groupdict().items()}
-
-    try:
-        return date(**kw)
-    except ValueError:
-        raise errors.DateError()
-
-
-def parse_time(value: Union[time, StrBytesIntFloat]) -> time:
-    """
-    Parse a time/string and return a datetime.time.
-
-    Raise ValueError if the input is well formatted but not a valid time.
-    Raise ValueError if the input isn't well formatted, in particular if it contains an offset.
-    """
-    if isinstance(value, time):
-        return value
-
-    number = get_numeric(value, 'time')
-    if number is not None:
-        if number >= 86400:
-            # doesn't make sense since the time time loop back around to 0
-            raise errors.TimeError()
-        return (datetime.min + timedelta(seconds=number)).time()
-
-    if isinstance(value, bytes):
-        value = value.decode()
-
-    match = time_re.match(value)  # type: ignore
-    if match is None:
-        raise errors.TimeError()
-
-    kw = match.groupdict()
-    if kw['microsecond']:
-        kw['microsecond'] = kw['microsecond'].ljust(6, '0')
-
-    tzinfo = _parse_timezone(kw.pop('tzinfo'), errors.TimeError)
-    kw_: Dict[str, Union[None, int, timezone]] = {k: int(v) for k, v in kw.items() if v is not None}
-    kw_['tzinfo'] = tzinfo
-
-    try:
-        return time(**kw_)  # type: ignore
-    except ValueError:
-        raise errors.TimeError()
-
-
-def parse_datetime(value: Union[datetime, StrBytesIntFloat]) -> datetime:
-    """
-    Parse a datetime/int/float/string and return a datetime.datetime.
-
-    This function supports time zone offsets. When the input contains one,
-    the output uses a timezone with a fixed offset from UTC.
-
-    Raise ValueError if the input is well formatted but not a valid datetime.
-    Raise ValueError if the input isn't well formatted.
-    """
-    if isinstance(value, datetime):
-        return value
-
-    number = get_numeric(value, 'datetime')
-    if number is not None:
-        return from_unix_seconds(number)
-
-    if isinstance(value, bytes):
-        value = value.decode()
-
-    match = datetime_re.match(value)  # type: ignore
-    if match is None:
-        raise errors.DateTimeError()
-
-    kw = match.groupdict()
-    if kw['microsecond']:
-        kw['microsecond'] = kw['microsecond'].ljust(6, '0')
-
-    tzinfo = _parse_timezone(kw.pop('tzinfo'), errors.DateTimeError)
-    kw_: Dict[str, Union[None, int, timezone]] = {k: int(v) for k, v in kw.items() if v is not None}
-    kw_['tzinfo'] = tzinfo
-
-    try:
-        return datetime(**kw_)  # type: ignore
-    except ValueError:
-        raise errors.DateTimeError()
-
-
-def parse_duration(value: StrBytesIntFloat) -> timedelta:
-    """
-    Parse a duration int/float/string and return a datetime.timedelta.
-
-    The preferred format for durations in Django is '%d %H:%M:%S.%f'.
-
-    Also supports ISO 8601 representation.
-    """
-    if isinstance(value, timedelta):
-        return value
-
-    if isinstance(value, (int, float)):
-        # below code requires a string
-        value = f'{value:f}'
-    elif isinstance(value, bytes):
-        value = value.decode()
-
-    try:
-        match = standard_duration_re.match(value) or iso8601_duration_re.match(value)
-    except TypeError:
-        raise TypeError('invalid type; expected timedelta, string, bytes, int or float')
-
-    if not match:
-        raise errors.DurationError()
-
-    kw = match.groupdict()
-    sign = -1 if kw.pop('sign', '+') == '-' else 1
-    if kw.get('microseconds'):
-        kw['microseconds'] = kw['microseconds'].ljust(6, '0')
-
-    if kw.get('seconds') and kw.get('microseconds') and kw['seconds'].startswith('-'):
-        kw['microseconds'] = '-' + kw['microseconds']
-
-    kw_ = {k: float(v) for k, v in kw.items() if v is not None}
-
-    return sign * timedelta(**kw_)
+__getattr__ = getattr_migration(__name__)
diff --git a/lib/pydantic/decorator.py b/lib/pydantic/decorator.py
index 089aab65..c3643468 100644
--- a/lib/pydantic/decorator.py
+++ b/lib/pydantic/decorator.py
@@ -1,264 +1,4 @@
-from functools import wraps
-from typing import TYPE_CHECKING, Any, Callable, Dict, List, Mapping, Optional, Tuple, Type, TypeVar, Union, overload
+"""The `decorator` module is a backport module from V1."""
+from ._migration import getattr_migration
 
-from . import validator
-from .config import Extra
-from .errors import ConfigError
-from .main import BaseModel, create_model
-from .typing import get_all_type_hints
-from .utils import to_camel
-
-__all__ = ('validate_arguments',)
-
-if TYPE_CHECKING:
-    from .typing import AnyCallable
-
-    AnyCallableT = TypeVar('AnyCallableT', bound=AnyCallable)
-    ConfigType = Union[None, Type[Any], Dict[str, Any]]
-
-
-@overload
-def validate_arguments(func: None = None, *, config: 'ConfigType' = None) -> Callable[['AnyCallableT'], 'AnyCallableT']:
-    ...
-
-
-@overload
-def validate_arguments(func: 'AnyCallableT') -> 'AnyCallableT':
-    ...
-
-
-def validate_arguments(func: Optional['AnyCallableT'] = None, *, config: 'ConfigType' = None) -> Any:
-    """
-    Decorator to validate the arguments passed to a function.
-    """
-
-    def validate(_func: 'AnyCallable') -> 'AnyCallable':
-        vd = ValidatedFunction(_func, config)
-
-        @wraps(_func)
-        def wrapper_function(*args: Any, **kwargs: Any) -> Any:
-            return vd.call(*args, **kwargs)
-
-        wrapper_function.vd = vd  # type: ignore
-        wrapper_function.validate = vd.init_model_instance  # type: ignore
-        wrapper_function.raw_function = vd.raw_function  # type: ignore
-        wrapper_function.model = vd.model  # type: ignore
-        return wrapper_function
-
-    if func:
-        return validate(func)
-    else:
-        return validate
-
-
-ALT_V_ARGS = 'v__args'
-ALT_V_KWARGS = 'v__kwargs'
-V_POSITIONAL_ONLY_NAME = 'v__positional_only'
-V_DUPLICATE_KWARGS = 'v__duplicate_kwargs'
-
-
-class ValidatedFunction:
-    def __init__(self, function: 'AnyCallableT', config: 'ConfigType'):  # noqa C901
-        from inspect import Parameter, signature
-
-        parameters: Mapping[str, Parameter] = signature(function).parameters
-
-        if parameters.keys() & {ALT_V_ARGS, ALT_V_KWARGS, V_POSITIONAL_ONLY_NAME, V_DUPLICATE_KWARGS}:
-            raise ConfigError(
-                f'"{ALT_V_ARGS}", "{ALT_V_KWARGS}", "{V_POSITIONAL_ONLY_NAME}" and "{V_DUPLICATE_KWARGS}" '
-                f'are not permitted as argument names when using the "{validate_arguments.__name__}" decorator'
-            )
-
-        self.raw_function = function
-        self.arg_mapping: Dict[int, str] = {}
-        self.positional_only_args = set()
-        self.v_args_name = 'args'
-        self.v_kwargs_name = 'kwargs'
-
-        type_hints = get_all_type_hints(function)
-        takes_args = False
-        takes_kwargs = False
-        fields: Dict[str, Tuple[Any, Any]] = {}
-        for i, (name, p) in enumerate(parameters.items()):
-            if p.annotation is p.empty:
-                annotation = Any
-            else:
-                annotation = type_hints[name]
-
-            default = ... if p.default is p.empty else p.default
-            if p.kind == Parameter.POSITIONAL_ONLY:
-                self.arg_mapping[i] = name
-                fields[name] = annotation, default
-                fields[V_POSITIONAL_ONLY_NAME] = List[str], None
-                self.positional_only_args.add(name)
-            elif p.kind == Parameter.POSITIONAL_OR_KEYWORD:
-                self.arg_mapping[i] = name
-                fields[name] = annotation, default
-                fields[V_DUPLICATE_KWARGS] = List[str], None
-            elif p.kind == Parameter.KEYWORD_ONLY:
-                fields[name] = annotation, default
-            elif p.kind == Parameter.VAR_POSITIONAL:
-                self.v_args_name = name
-                fields[name] = Tuple[annotation, ...], None
-                takes_args = True
-            else:
-                assert p.kind == Parameter.VAR_KEYWORD, p.kind
-                self.v_kwargs_name = name
-                fields[name] = Dict[str, annotation], None  # type: ignore
-                takes_kwargs = True
-
-        # these checks avoid a clash between "args" and a field with that name
-        if not takes_args and self.v_args_name in fields:
-            self.v_args_name = ALT_V_ARGS
-
-        # same with "kwargs"
-        if not takes_kwargs and self.v_kwargs_name in fields:
-            self.v_kwargs_name = ALT_V_KWARGS
-
-        if not takes_args:
-            # we add the field so validation below can raise the correct exception
-            fields[self.v_args_name] = List[Any], None
-
-        if not takes_kwargs:
-            # same with kwargs
-            fields[self.v_kwargs_name] = Dict[Any, Any], None
-
-        self.create_model(fields, takes_args, takes_kwargs, config)
-
-    def init_model_instance(self, *args: Any, **kwargs: Any) -> BaseModel:
-        values = self.build_values(args, kwargs)
-        return self.model(**values)
-
-    def call(self, *args: Any, **kwargs: Any) -> Any:
-        m = self.init_model_instance(*args, **kwargs)
-        return self.execute(m)
-
-    def build_values(self, args: Tuple[Any, ...], kwargs: Dict[str, Any]) -> Dict[str, Any]:
-        values: Dict[str, Any] = {}
-        if args:
-            arg_iter = enumerate(args)
-            while True:
-                try:
-                    i, a = next(arg_iter)
-                except StopIteration:
-                    break
-                arg_name = self.arg_mapping.get(i)
-                if arg_name is not None:
-                    values[arg_name] = a
-                else:
-                    values[self.v_args_name] = [a] + [a for _, a in arg_iter]
-                    break
-
-        var_kwargs: Dict[str, Any] = {}
-        wrong_positional_args = []
-        duplicate_kwargs = []
-        fields_alias = [
-            field.alias
-            for name, field in self.model.__fields__.items()
-            if name not in (self.v_args_name, self.v_kwargs_name)
-        ]
-        non_var_fields = set(self.model.__fields__) - {self.v_args_name, self.v_kwargs_name}
-        for k, v in kwargs.items():
-            if k in non_var_fields or k in fields_alias:
-                if k in self.positional_only_args:
-                    wrong_positional_args.append(k)
-                if k in values:
-                    duplicate_kwargs.append(k)
-                values[k] = v
-            else:
-                var_kwargs[k] = v
-
-        if var_kwargs:
-            values[self.v_kwargs_name] = var_kwargs
-        if wrong_positional_args:
-            values[V_POSITIONAL_ONLY_NAME] = wrong_positional_args
-        if duplicate_kwargs:
-            values[V_DUPLICATE_KWARGS] = duplicate_kwargs
-        return values
-
-    def execute(self, m: BaseModel) -> Any:
-        d = {k: v for k, v in m._iter() if k in m.__fields_set__ or m.__fields__[k].default_factory}
-        var_kwargs = d.pop(self.v_kwargs_name, {})
-
-        if self.v_args_name in d:
-            args_: List[Any] = []
-            in_kwargs = False
-            kwargs = {}
-            for name, value in d.items():
-                if in_kwargs:
-                    kwargs[name] = value
-                elif name == self.v_args_name:
-                    args_ += value
-                    in_kwargs = True
-                else:
-                    args_.append(value)
-            return self.raw_function(*args_, **kwargs, **var_kwargs)
-        elif self.positional_only_args:
-            args_ = []
-            kwargs = {}
-            for name, value in d.items():
-                if name in self.positional_only_args:
-                    args_.append(value)
-                else:
-                    kwargs[name] = value
-            return self.raw_function(*args_, **kwargs, **var_kwargs)
-        else:
-            return self.raw_function(**d, **var_kwargs)
-
-    def create_model(self, fields: Dict[str, Any], takes_args: bool, takes_kwargs: bool, config: 'ConfigType') -> None:
-        pos_args = len(self.arg_mapping)
-
-        class CustomConfig:
-            pass
-
-        if not TYPE_CHECKING:  # pragma: no branch
-            if isinstance(config, dict):
-                CustomConfig = type('Config', (), config)  # noqa: F811
-            elif config is not None:
-                CustomConfig = config  # noqa: F811
-
-        if hasattr(CustomConfig, 'fields') or hasattr(CustomConfig, 'alias_generator'):
-            raise ConfigError(
-                'Setting the "fields" and "alias_generator" property on custom Config for '
-                '@validate_arguments is not yet supported, please remove.'
-            )
-
-        class DecoratorBaseModel(BaseModel):
-            @validator(self.v_args_name, check_fields=False, allow_reuse=True)
-            def check_args(cls, v: Optional[List[Any]]) -> Optional[List[Any]]:
-                if takes_args or v is None:
-                    return v
-
-                raise TypeError(f'{pos_args} positional arguments expected but {pos_args + len(v)} given')
-
-            @validator(self.v_kwargs_name, check_fields=False, allow_reuse=True)
-            def check_kwargs(cls, v: Optional[Dict[str, Any]]) -> Optional[Dict[str, Any]]:
-                if takes_kwargs or v is None:
-                    return v
-
-                plural = '' if len(v) == 1 else 's'
-                keys = ', '.join(map(repr, v.keys()))
-                raise TypeError(f'unexpected keyword argument{plural}: {keys}')
-
-            @validator(V_POSITIONAL_ONLY_NAME, check_fields=False, allow_reuse=True)
-            def check_positional_only(cls, v: Optional[List[str]]) -> None:
-                if v is None:
-                    return
-
-                plural = '' if len(v) == 1 else 's'
-                keys = ', '.join(map(repr, v))
-                raise TypeError(f'positional-only argument{plural} passed as keyword argument{plural}: {keys}')
-
-            @validator(V_DUPLICATE_KWARGS, check_fields=False, allow_reuse=True)
-            def check_duplicate_kwargs(cls, v: Optional[List[str]]) -> None:
-                if v is None:
-                    return
-
-                plural = '' if len(v) == 1 else 's'
-                keys = ', '.join(map(repr, v))
-                raise TypeError(f'multiple values for argument{plural}: {keys}')
-
-            class Config(CustomConfig):
-                extra = getattr(CustomConfig, 'extra', Extra.forbid)
-
-        self.model = create_model(to_camel(self.raw_function.__name__), __base__=DecoratorBaseModel, **fields)
+__getattr__ = getattr_migration(__name__)
diff --git a/lib/pydantic/deprecated/__init__.py b/lib/pydantic/deprecated/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/lib/pydantic/deprecated/class_validators.py b/lib/pydantic/deprecated/class_validators.py
new file mode 100644
index 00000000..7b48afd2
--- /dev/null
+++ b/lib/pydantic/deprecated/class_validators.py
@@ -0,0 +1,253 @@
+"""Old `@validator` and `@root_validator` function validators from V1."""
+
+from __future__ import annotations as _annotations
+
+from functools import partial, partialmethod
+from types import FunctionType
+from typing import TYPE_CHECKING, Any, Callable, TypeVar, Union, overload
+from warnings import warn
+
+from typing_extensions import Literal, Protocol, TypeAlias
+
+from .._internal import _decorators, _decorators_v1
+from ..errors import PydanticUserError
+from ..warnings import PydanticDeprecatedSince20
+
+_ALLOW_REUSE_WARNING_MESSAGE = '`allow_reuse` is deprecated and will be ignored; it should no longer be necessary'
+
+
+if TYPE_CHECKING:
+
+    class _OnlyValueValidatorClsMethod(Protocol):
+        def __call__(self, __cls: Any, __value: Any) -> Any:
+            ...
+
+    class _V1ValidatorWithValuesClsMethod(Protocol):
+        def __call__(self, __cls: Any, __value: Any, values: dict[str, Any]) -> Any:
+            ...
+
+    class _V1ValidatorWithValuesKwOnlyClsMethod(Protocol):
+        def __call__(self, __cls: Any, __value: Any, *, values: dict[str, Any]) -> Any:
+            ...
+
+    class _V1ValidatorWithKwargsClsMethod(Protocol):
+        def __call__(self, __cls: Any, **kwargs: Any) -> Any:
+            ...
+
+    class _V1ValidatorWithValuesAndKwargsClsMethod(Protocol):
+        def __call__(self, __cls: Any, values: dict[str, Any], **kwargs: Any) -> Any:
+            ...
+
+    class _V1RootValidatorClsMethod(Protocol):
+        def __call__(
+            self, __cls: Any, __values: _decorators_v1.RootValidatorValues
+        ) -> _decorators_v1.RootValidatorValues:
+            ...
+
+    V1Validator = Union[
+        _OnlyValueValidatorClsMethod,
+        _V1ValidatorWithValuesClsMethod,
+        _V1ValidatorWithValuesKwOnlyClsMethod,
+        _V1ValidatorWithKwargsClsMethod,
+        _V1ValidatorWithValuesAndKwargsClsMethod,
+        _decorators_v1.V1ValidatorWithValues,
+        _decorators_v1.V1ValidatorWithValuesKwOnly,
+        _decorators_v1.V1ValidatorWithKwargs,
+        _decorators_v1.V1ValidatorWithValuesAndKwargs,
+    ]
+
+    V1RootValidator = Union[
+        _V1RootValidatorClsMethod,
+        _decorators_v1.V1RootValidatorFunction,
+    ]
+
+    _PartialClsOrStaticMethod: TypeAlias = Union[classmethod[Any, Any, Any], staticmethod[Any, Any], partialmethod[Any]]
+
+    # Allow both a V1 (assumed pre=False) or V2 (assumed mode='after') validator
+    # We lie to type checkers and say we return the same thing we get
+    # but in reality we return a proxy object that _mostly_ behaves like the wrapped thing
+    _V1ValidatorType = TypeVar('_V1ValidatorType', V1Validator, _PartialClsOrStaticMethod)
+    _V1RootValidatorFunctionType = TypeVar(
+        '_V1RootValidatorFunctionType',
+        _decorators_v1.V1RootValidatorFunction,
+        _V1RootValidatorClsMethod,
+        _PartialClsOrStaticMethod,
+    )
+else:
+    # See PyCharm issues https://youtrack.jetbrains.com/issue/PY-21915
+    # and https://youtrack.jetbrains.com/issue/PY-51428
+    DeprecationWarning = PydanticDeprecatedSince20
+
+
+def validator(
+    __field: str,
+    *fields: str,
+    pre: bool = False,
+    each_item: bool = False,
+    always: bool = False,
+    check_fields: bool | None = None,
+    allow_reuse: bool = False,
+) -> Callable[[_V1ValidatorType], _V1ValidatorType]:
+    """Decorate methods on the class indicating that they should be used to validate fields.
+
+    Args:
+        __field (str): The first field the validator should be called on; this is separate
+            from `fields` to ensure an error is raised if you don't pass at least one.
+        *fields (str): Additional field(s) the validator should be called on.
+        pre (bool, optional): Whether this validator should be called before the standard
+            validators (else after). Defaults to False.
+        each_item (bool, optional): For complex objects (sets, lists etc.) whether to validate
+            individual elements rather than the whole object. Defaults to False.
+        always (bool, optional): Whether this method and other validators should be called even if
+            the value is missing. Defaults to False.
+        check_fields (bool | None, optional): Whether to check that the fields actually exist on the model.
+            Defaults to None.
+        allow_reuse (bool, optional): Whether to track and raise an error if another validator refers to
+            the decorated function. Defaults to False.
+
+    Returns:
+        Callable: A decorator that can be used to decorate a
+            function to be used as a validator.
+    """
+    if allow_reuse is True:  # pragma: no cover
+        warn(_ALLOW_REUSE_WARNING_MESSAGE, DeprecationWarning)
+    fields = tuple((__field, *fields))
+    if isinstance(fields[0], FunctionType):
+        raise PydanticUserError(
+            '`@validator` should be used with fields and keyword arguments, not bare. '
+            "E.g. usage should be `@validator('<field_name>', ...)`",
+            code='validator-no-fields',
+        )
+    elif not all(isinstance(field, str) for field in fields):
+        raise PydanticUserError(
+            '`@validator` fields should be passed as separate string args. '
+            "E.g. usage should be `@validator('<field_name_1>', '<field_name_2>', ...)`",
+            code='validator-invalid-fields',
+        )
+
+    warn(
+        'Pydantic V1 style `@validator` validators are deprecated.'
+        ' You should migrate to Pydantic V2 style `@field_validator` validators,'
+        ' see the migration guide for more details',
+        DeprecationWarning,
+        stacklevel=2,
+    )
+
+    mode: Literal['before', 'after'] = 'before' if pre is True else 'after'
+
+    def dec(f: Any) -> _decorators.PydanticDescriptorProxy[Any]:
+        if _decorators.is_instance_method_from_sig(f):
+            raise PydanticUserError(
+                '`@validator` cannot be applied to instance methods', code='validator-instance-method'
+            )
+        # auto apply the @classmethod decorator
+        f = _decorators.ensure_classmethod_based_on_signature(f)
+        wrap = _decorators_v1.make_generic_v1_field_validator
+        validator_wrapper_info = _decorators.ValidatorDecoratorInfo(
+            fields=fields,
+            mode=mode,
+            each_item=each_item,
+            always=always,
+            check_fields=check_fields,
+        )
+        return _decorators.PydanticDescriptorProxy(f, validator_wrapper_info, shim=wrap)
+
+    return dec  # type: ignore[return-value]
+
+
+@overload
+def root_validator(
+    *,
+    # if you don't specify `pre` the default is `pre=False`
+    # which means you need to specify `skip_on_failure=True`
+    skip_on_failure: Literal[True],
+    allow_reuse: bool = ...,
+) -> Callable[
+    [_V1RootValidatorFunctionType],
+    _V1RootValidatorFunctionType,
+]:
+    ...
+
+
+@overload
+def root_validator(
+    *,
+    # if you specify `pre=True` then you don't need to specify
+    # `skip_on_failure`, in fact it is not allowed as an argument!
+    pre: Literal[True],
+    allow_reuse: bool = ...,
+) -> Callable[
+    [_V1RootValidatorFunctionType],
+    _V1RootValidatorFunctionType,
+]:
+    ...
+
+
+@overload
+def root_validator(
+    *,
+    # if you explicitly specify `pre=False` then you
+    # MUST specify `skip_on_failure=True`
+    pre: Literal[False],
+    skip_on_failure: Literal[True],
+    allow_reuse: bool = ...,
+) -> Callable[
+    [_V1RootValidatorFunctionType],
+    _V1RootValidatorFunctionType,
+]:
+    ...
+
+
+def root_validator(
+    *__args,
+    pre: bool = False,
+    skip_on_failure: bool = False,
+    allow_reuse: bool = False,
+) -> Any:
+    """Decorate methods on a model indicating that they should be used to validate (and perhaps
+    modify) data either before or after standard model parsing/validation is performed.
+
+    Args:
+        pre (bool, optional): Whether this validator should be called before the standard
+            validators (else after). Defaults to False.
+        skip_on_failure (bool, optional): Whether to stop validation and return as soon as a
+            failure is encountered. Defaults to False.
+        allow_reuse (bool, optional): Whether to track and raise an error if another validator
+            refers to the decorated function. Defaults to False.
+
+    Returns:
+        Any: A decorator that can be used to decorate a function to be used as a root_validator.
+    """
+    warn(
+        'Pydantic V1 style `@root_validator` validators are deprecated.'
+        ' You should migrate to Pydantic V2 style `@model_validator` validators,'
+        ' see the migration guide for more details',
+        DeprecationWarning,
+        stacklevel=2,
+    )
+
+    if __args:
+        # Ensure a nice error is raised if someone attempts to use the bare decorator
+        return root_validator()(*__args)  # type: ignore
+
+    if allow_reuse is True:  # pragma: no cover
+        warn(_ALLOW_REUSE_WARNING_MESSAGE, DeprecationWarning)
+    mode: Literal['before', 'after'] = 'before' if pre is True else 'after'
+    if pre is False and skip_on_failure is not True:
+        raise PydanticUserError(
+            'If you use `@root_validator` with pre=False (the default) you MUST specify `skip_on_failure=True`.'
+            ' Note that `@root_validator` is deprecated and should be replaced with `@model_validator`.',
+            code='root-validator-pre-skip',
+        )
+
+    wrap = partial(_decorators_v1.make_v1_generic_root_validator, pre=pre)
+
+    def dec(f: Callable[..., Any] | classmethod[Any, Any, Any] | staticmethod[Any, Any]) -> Any:
+        if _decorators.is_instance_method_from_sig(f):
+            raise TypeError('`@root_validator` cannot be applied to instance methods')
+        # auto apply the @classmethod decorator
+        res = _decorators.ensure_classmethod_based_on_signature(f)
+        dec_info = _decorators.RootValidatorDecoratorInfo(mode=mode)
+        return _decorators.PydanticDescriptorProxy(res, dec_info, shim=wrap)
+
+    return dec
diff --git a/lib/pydantic/deprecated/config.py b/lib/pydantic/deprecated/config.py
new file mode 100644
index 00000000..45400c65
--- /dev/null
+++ b/lib/pydantic/deprecated/config.py
@@ -0,0 +1,72 @@
+from __future__ import annotations as _annotations
+
+import warnings
+from typing import TYPE_CHECKING, Any
+
+from typing_extensions import Literal, deprecated
+
+from .._internal import _config
+from ..warnings import PydanticDeprecatedSince20
+
+if not TYPE_CHECKING:
+    # See PyCharm issues https://youtrack.jetbrains.com/issue/PY-21915
+    # and https://youtrack.jetbrains.com/issue/PY-51428
+    DeprecationWarning = PydanticDeprecatedSince20
+
+__all__ = 'BaseConfig', 'Extra'
+
+
+class _ConfigMetaclass(type):
+    def __getattr__(self, item: str) -> Any:
+        try:
+            obj = _config.config_defaults[item]
+            warnings.warn(_config.DEPRECATION_MESSAGE, DeprecationWarning)
+            return obj
+        except KeyError as exc:
+            raise AttributeError(f"type object '{self.__name__}' has no attribute {exc}") from exc
+
+
+@deprecated('BaseConfig is deprecated. Use the `pydantic.ConfigDict` instead.', category=PydanticDeprecatedSince20)
+class BaseConfig(metaclass=_ConfigMetaclass):
+    """This class is only retained for backwards compatibility.
+
+    !!! Warning "Deprecated"
+        BaseConfig is deprecated. Use the [`pydantic.ConfigDict`][pydantic.ConfigDict] instead.
+    """
+
+    def __getattr__(self, item: str) -> Any:
+        try:
+            obj = super().__getattribute__(item)
+            warnings.warn(_config.DEPRECATION_MESSAGE, DeprecationWarning)
+            return obj
+        except AttributeError as exc:
+            try:
+                return getattr(type(self), item)
+            except AttributeError:
+                # re-raising changes the displayed text to reflect that `self` is not a type
+                raise AttributeError(str(exc)) from exc
+
+    def __init_subclass__(cls, **kwargs: Any) -> None:
+        warnings.warn(_config.DEPRECATION_MESSAGE, DeprecationWarning)
+        return super().__init_subclass__(**kwargs)
+
+
+class _ExtraMeta(type):
+    def __getattribute__(self, __name: str) -> Any:
+        # The @deprecated decorator accesses other attributes, so we only emit a warning for the expected ones
+        if __name in {'allow', 'ignore', 'forbid'}:
+            warnings.warn(
+                "`pydantic.config.Extra` is deprecated, use literal values instead (e.g. `extra='allow'`)",
+                DeprecationWarning,
+                stacklevel=2,
+            )
+        return super().__getattribute__(__name)
+
+
+@deprecated(
+    "Extra is deprecated. Use literal values instead (e.g. `extra='allow'`)", category=PydanticDeprecatedSince20
+)
+class Extra(metaclass=_ExtraMeta):
+    allow: Literal['allow'] = 'allow'
+    ignore: Literal['ignore'] = 'ignore'
+    forbid: Literal['forbid'] = 'forbid'
diff --git a/lib/pydantic/deprecated/copy_internals.py b/lib/pydantic/deprecated/copy_internals.py
new file mode 100644
index 00000000..efe5de28
--- /dev/null
+++ b/lib/pydantic/deprecated/copy_internals.py
@@ -0,0 +1,224 @@
+from __future__ import annotations as _annotations
+
+import typing
+from copy import deepcopy
+from enum import Enum
+from typing import Any, Tuple
+
+import typing_extensions
+
+from .._internal import (
+    _model_construction,
+    _typing_extra,
+    _utils,
+)
+
+if typing.TYPE_CHECKING:
+    from .. import BaseModel
+    from .._internal._utils import AbstractSetIntStr, MappingIntStrAny
+
+    AnyClassMethod = classmethod[Any, Any, Any]
+    TupleGenerator = typing.Generator[Tuple[str, Any], None, None]
+    Model = typing.TypeVar('Model', bound='BaseModel')
+    # should be `set[int] | set[str] | dict[int, IncEx] | dict[str, IncEx] | None`, but mypy can't cope
+    IncEx: typing_extensions.TypeAlias = 'set[int] | set[str] | dict[int, Any] | dict[str, Any] | None'
+
+_object_setattr = _model_construction.object_setattr
+
+
+def _iter(
+    self: BaseModel,
+    to_dict: bool = False,
+    by_alias: bool = False,
+    include: AbstractSetIntStr | MappingIntStrAny | None = None,
+    exclude: AbstractSetIntStr | MappingIntStrAny | None = None,
+    exclude_unset: bool = False,
+    exclude_defaults: bool = False,
+    exclude_none: bool = False,
+) -> TupleGenerator:
+    # Merge field set excludes with explicit exclude parameter with explicit overriding field set options.
+    # The extra "is not None" guards are not logically necessary but optimizes performance for the simple case.
+    if exclude is not None:
+        exclude = _utils.ValueItems.merge(
+            {k: v.exclude for k, v in self.model_fields.items() if v.exclude is not None}, exclude
+        )
+
+    if include is not None:
+        include = _utils.ValueItems.merge({k: True for k in self.model_fields}, include, intersect=True)
+
+    allowed_keys = _calculate_keys(self, include=include, exclude=exclude, exclude_unset=exclude_unset)  # type: ignore
+    if allowed_keys is None and not (to_dict or by_alias or exclude_unset or exclude_defaults or exclude_none):
+        # huge boost for plain _iter()
+        yield from self.__dict__.items()
+        if self.__pydantic_extra__:
+            yield from self.__pydantic_extra__.items()
+        return
+
+    value_exclude = _utils.ValueItems(self, exclude) if exclude is not None else None
+    value_include = _utils.ValueItems(self, include) if include is not None else None
+
+    if self.__pydantic_extra__ is None:
+        items = self.__dict__.items()
+    else:
+        items = list(self.__dict__.items()) + list(self.__pydantic_extra__.items())
+
+    for field_key, v in items:
+        if (allowed_keys is not None and field_key not in allowed_keys) or (exclude_none and v is None):
+            continue
+
+        if exclude_defaults:
+            try:
+                field = self.model_fields[field_key]
+            except KeyError:
+                pass
+            else:
+                if not field.is_required() and field.default == v:
+                    continue
+
+        if by_alias and field_key in self.model_fields:
+            dict_key = self.model_fields[field_key].alias or field_key
+        else:
+            dict_key = field_key
+
+        if to_dict or value_include or value_exclude:
+            v = _get_value(
+                type(self),
+                v,
+                to_dict=to_dict,
+                by_alias=by_alias,
+                include=value_include and value_include.for_element(field_key),
+                exclude=value_exclude and value_exclude.for_element(field_key),
+                exclude_unset=exclude_unset,
+                exclude_defaults=exclude_defaults,
+                exclude_none=exclude_none,
+            )
+        yield dict_key, v
+
+
+def _copy_and_set_values(
+    self: Model,
+    values: dict[str, Any],
+    fields_set: set[str],
+    extra: dict[str, Any] | None = None,
+    private: dict[str, Any] | None = None,
+    *,
+    deep: bool,  # UP006
+) -> Model:
+    if deep:
+        # chances of having empty dict here are quite low for using smart_deepcopy
+        values = deepcopy(values)
+        extra = deepcopy(extra)
+        private = deepcopy(private)
+
+    cls = self.__class__
+    m = cls.__new__(cls)
+    _object_setattr(m, '__dict__', values)
+    _object_setattr(m, '__pydantic_extra__', extra)
+    _object_setattr(m, '__pydantic_fields_set__', fields_set)
+    _object_setattr(m, '__pydantic_private__', private)
+
+    return m
+
+
+@typing.no_type_check
+def _get_value(
+    cls: type[BaseModel],
+    v: Any,
+    to_dict: bool,
+    by_alias: bool,
+    include: AbstractSetIntStr | MappingIntStrAny | None,
+    exclude: AbstractSetIntStr | MappingIntStrAny | None,
+    exclude_unset: bool,
+    exclude_defaults: bool,
+    exclude_none: bool,
+) -> Any:
+    from .. import BaseModel
+
+    if isinstance(v, BaseModel):
+        if to_dict:
+            return v.model_dump(
+                by_alias=by_alias,
+                exclude_unset=exclude_unset,
+                exclude_defaults=exclude_defaults,
+                include=include,  # type: ignore
+                exclude=exclude,  # type: ignore
+                exclude_none=exclude_none,
+            )
+        else:
+            return v.copy(include=include, exclude=exclude)
+
+    value_exclude = _utils.ValueItems(v, exclude) if exclude else None
+    value_include = _utils.ValueItems(v, include) if include else None
+
+    if isinstance(v, dict):
+        return {
+            k_: _get_value(
+                cls,
+                v_,
+                to_dict=to_dict,
+                by_alias=by_alias,
+                exclude_unset=exclude_unset,
+                exclude_defaults=exclude_defaults,
+                include=value_include and value_include.for_element(k_),
+                exclude=value_exclude and value_exclude.for_element(k_),
+                exclude_none=exclude_none,
+            )
+            for k_, v_ in v.items()
+            if (not value_exclude or not value_exclude.is_excluded(k_))
+            and (not value_include or value_include.is_included(k_))
+        }
+
+    elif _utils.sequence_like(v):
+        seq_args = (
+            _get_value(
+                cls,
+                v_,
+                to_dict=to_dict,
+                by_alias=by_alias,
+                exclude_unset=exclude_unset,
+                exclude_defaults=exclude_defaults,
+                include=value_include and value_include.for_element(i),
+                exclude=value_exclude and value_exclude.for_element(i),
+                exclude_none=exclude_none,
+            )
+            for i, v_ in enumerate(v)
+            if (not value_exclude or not value_exclude.is_excluded(i))
+            and (not value_include or value_include.is_included(i))
+        )
+
+        return v.__class__(*seq_args) if _typing_extra.is_namedtuple(v.__class__) else v.__class__(seq_args)
+
+    elif isinstance(v, Enum) and getattr(cls.model_config, 'use_enum_values', False):
+        return v.value
+
+    else:
+        return v
+
+
+def _calculate_keys(
+    self: BaseModel,
+    include: MappingIntStrAny | None,
+    exclude: MappingIntStrAny | None,
+    exclude_unset: bool,
+    update: typing.Dict[str, Any] | None = None,  # noqa UP006
+) -> typing.AbstractSet[str] | None:
+    if include is None and exclude is None and exclude_unset is False:
+        return None
+
+    keys: typing.AbstractSet[str]
+    if exclude_unset:
+        keys = self.__pydantic_fields_set__.copy()
+    else:
+        keys = set(self.__dict__.keys())
+        keys = keys | (self.__pydantic_extra__ or {}).keys()
+
+    if include is not None:
+        keys &= include.keys()
+
+    if update:
+        keys -= update.keys()
+
+    if exclude:
+        keys -= {k for k, v in exclude.items() if _utils.ValueItems.is_true(v)}
+
+    return keys
diff --git a/lib/pydantic/deprecated/decorator.py b/lib/pydantic/deprecated/decorator.py
new file mode 100644
index 00000000..36bd0690
--- /dev/null
+++ b/lib/pydantic/deprecated/decorator.py
@@ -0,0 +1,279 @@
+import warnings
+from functools import wraps
+from typing import TYPE_CHECKING, Any, Callable, Dict, List, Mapping, Optional, Tuple, Type, TypeVar, Union, overload
+
+from typing_extensions import deprecated
+
+from .._internal import _config, _typing_extra
+from ..alias_generators import to_pascal
+from ..errors import PydanticUserError
+from ..functional_validators import field_validator
+from ..main import BaseModel, create_model
+from ..warnings import PydanticDeprecatedSince20
+
+if not TYPE_CHECKING:
+    # See PyCharm issues https://youtrack.jetbrains.com/issue/PY-21915
+    # and https://youtrack.jetbrains.com/issue/PY-51428
+    DeprecationWarning = PydanticDeprecatedSince20
+
+__all__ = ('validate_arguments',)
+
+if TYPE_CHECKING:
+    AnyCallable = Callable[..., Any]
+
+    AnyCallableT = TypeVar('AnyCallableT', bound=AnyCallable)
+    ConfigType = Union[None, Type[Any], Dict[str, Any]]
+
+
+@overload
+def validate_arguments(func: None = None, *, config: 'ConfigType' = None) -> Callable[['AnyCallableT'], 'AnyCallableT']:
+    ...
+
+
+@overload
+def validate_arguments(func: 'AnyCallableT') -> 'AnyCallableT':
+    ...
+
+
+@deprecated(
+    'The `validate_arguments` method is deprecated; use `validate_call` instead.',
+    category=None,
+)
+def validate_arguments(func: Optional['AnyCallableT'] = None, *, config: 'ConfigType' = None) -> Any:
+    """Decorator to validate the arguments passed to a function."""
+    warnings.warn(
+        'The `validate_arguments` method is deprecated; use `validate_call` instead.',
+        PydanticDeprecatedSince20,
+        stacklevel=2,
+    )
+
+    def validate(_func: 'AnyCallable') -> 'AnyCallable':
+        vd = ValidatedFunction(_func, config)
+
+        @wraps(_func)
+        def wrapper_function(*args: Any, **kwargs: Any) -> Any:
+            return vd.call(*args, **kwargs)
+
+        wrapper_function.vd = vd  # type: ignore
+        wrapper_function.validate = vd.init_model_instance  # type: ignore
+        wrapper_function.raw_function = vd.raw_function  # type: ignore
+        wrapper_function.model = vd.model  # type: ignore
+        return wrapper_function
+
+    if func:
+        return validate(func)
+    else:
+        return validate
+
+
+ALT_V_ARGS = 'v__args'
+ALT_V_KWARGS = 'v__kwargs'
+V_POSITIONAL_ONLY_NAME = 'v__positional_only'
+V_DUPLICATE_KWARGS = 'v__duplicate_kwargs'
+
+
+class ValidatedFunction:
+    def __init__(self, function: 'AnyCallable', config: 'ConfigType'):
+        from inspect import Parameter, signature
+
+        parameters: Mapping[str, Parameter] = signature(function).parameters
+
+        if parameters.keys() & {ALT_V_ARGS, ALT_V_KWARGS, V_POSITIONAL_ONLY_NAME, V_DUPLICATE_KWARGS}:
+            raise PydanticUserError(
+                f'"{ALT_V_ARGS}", "{ALT_V_KWARGS}", "{V_POSITIONAL_ONLY_NAME}" and "{V_DUPLICATE_KWARGS}" '
+                f'are not permitted as argument names when using the "{validate_arguments.__name__}" decorator',
+                code=None,
+            )
+
+        self.raw_function = function
+        self.arg_mapping: Dict[int, str] = {}
+        self.positional_only_args: set[str] = set()
+        self.v_args_name = 'args'
+        self.v_kwargs_name = 'kwargs'
+
+        type_hints = _typing_extra.get_type_hints(function, include_extras=True)
+        takes_args = False
+        takes_kwargs = False
+        fields: Dict[str, Tuple[Any, Any]] = {}
+        for i, (name, p) in enumerate(parameters.items()):
+            if p.annotation is p.empty:
+                annotation = Any
+            else:
+                annotation = type_hints[name]
+
+            default = ... if p.default is p.empty else p.default
+            if p.kind == Parameter.POSITIONAL_ONLY:
+                self.arg_mapping[i] = name
+                fields[name] = annotation, default
+                fields[V_POSITIONAL_ONLY_NAME] = List[str], None
+                self.positional_only_args.add(name)
+            elif p.kind == Parameter.POSITIONAL_OR_KEYWORD:
+                self.arg_mapping[i] = name
+                fields[name] = annotation, default
+                fields[V_DUPLICATE_KWARGS] = List[str], None
+            elif p.kind == Parameter.KEYWORD_ONLY:
+                fields[name] = annotation, default
+            elif p.kind == Parameter.VAR_POSITIONAL:
+                self.v_args_name = name
+                fields[name] = Tuple[annotation, ...], None
+                takes_args = True
+            else:
+                assert p.kind == Parameter.VAR_KEYWORD, p.kind
+                self.v_kwargs_name = name
+                fields[name] = Dict[str, annotation], None
+                takes_kwargs = True
+
+        # these checks avoid a clash between "args" and a field with that name
+        if not takes_args and self.v_args_name in fields:
+            self.v_args_name = ALT_V_ARGS
+
+        # same with "kwargs"
+        if not takes_kwargs and self.v_kwargs_name in fields:
+            self.v_kwargs_name = ALT_V_KWARGS
+
+        if not takes_args:
+            # we add the field so validation below can raise the correct exception
+            fields[self.v_args_name] = List[Any], None
+
+        if not takes_kwargs:
+            # same with kwargs
+            fields[self.v_kwargs_name] = Dict[Any, Any], None
+
+        self.create_model(fields, takes_args, takes_kwargs, config)
+
+    def init_model_instance(self, *args: Any, **kwargs: Any) -> BaseModel:
+        values = self.build_values(args, kwargs)
+        return self.model(**values)
+
+    def call(self, *args: Any, **kwargs: Any) -> Any:
+        m = self.init_model_instance(*args, **kwargs)
+        return self.execute(m)
+
+    def build_values(self, args: Tuple[Any, ...], kwargs: Dict[str, Any]) -> Dict[str, Any]:
+        values: Dict[str, Any] = {}
+        if args:
+            arg_iter = enumerate(args)
+            while True:
+                try:
+                    i, a = next(arg_iter)
+                except StopIteration:
+                    break
+                arg_name = self.arg_mapping.get(i)
+                if arg_name is not None:
+                    values[arg_name] = a
+                else:
+                    values[self.v_args_name] = [a] + [a for _, a in arg_iter]
+                    break
+
+        var_kwargs: Dict[str, Any] = {}
+        wrong_positional_args = []
+        duplicate_kwargs = []
+        fields_alias = [
+            field.alias
+            for name, field in self.model.model_fields.items()
+            if name not in (self.v_args_name, self.v_kwargs_name)
+        ]
+        non_var_fields = set(self.model.model_fields) - {self.v_args_name, self.v_kwargs_name}
+        for k, v in kwargs.items():
+            if k in non_var_fields or k in fields_alias:
+                if k in self.positional_only_args:
+                    wrong_positional_args.append(k)
+                if k in values:
+                    duplicate_kwargs.append(k)
+                values[k] = v
+            else:
+                var_kwargs[k] = v
+
+        if var_kwargs:
+            values[self.v_kwargs_name] = var_kwargs
+        if wrong_positional_args:
+            values[V_POSITIONAL_ONLY_NAME] = wrong_positional_args
+        if duplicate_kwargs:
+            values[V_DUPLICATE_KWARGS] = duplicate_kwargs
+        return values
+
+    def execute(self, m: BaseModel) -> Any:
+        d = {k: v for k, v in m.__dict__.items() if k in m.__pydantic_fields_set__ or m.model_fields[k].default_factory}
+        var_kwargs = d.pop(self.v_kwargs_name, {})
+
+        if self.v_args_name in d:
+            args_: List[Any] = []
+            in_kwargs = False
+            kwargs = {}
+            for name, value in d.items():
+                if in_kwargs:
+                    kwargs[name] = value
+                elif name == self.v_args_name:
+                    args_ += value
+                    in_kwargs = True
+                else:
+                    args_.append(value)
+            return self.raw_function(*args_, **kwargs, **var_kwargs)
+        elif self.positional_only_args:
+            args_ = []
+            kwargs = {}
+            for name, value in d.items():
+                if name in self.positional_only_args:
+                    args_.append(value)
+                else:
+                    kwargs[name] = value
+            return self.raw_function(*args_, **kwargs, **var_kwargs)
+        else:
+            return self.raw_function(**d, **var_kwargs)
+
+    def create_model(self, fields: Dict[str, Any], takes_args: bool, takes_kwargs: bool, config: 'ConfigType') -> None:
+        pos_args = len(self.arg_mapping)
+
+        config_wrapper = _config.ConfigWrapper(config)
+
+        if config_wrapper.alias_generator:
+            raise PydanticUserError(
+                'Setting the "alias_generator" property on custom Config for '
+                '@validate_arguments is not yet supported, please remove.',
+                code=None,
+            )
+        if config_wrapper.extra is None:
+            config_wrapper.config_dict['extra'] = 'forbid'
+
+        class DecoratorBaseModel(BaseModel):
+            @field_validator(self.v_args_name, check_fields=False)
+            @classmethod
+            def check_args(cls, v: Optional[List[Any]]) -> Optional[List[Any]]:
+                if takes_args or v is None:
+                    return v
+
+                raise TypeError(f'{pos_args} positional arguments expected but {pos_args + len(v)} given')
+
+            @field_validator(self.v_kwargs_name, check_fields=False)
+            @classmethod
+            def check_kwargs(cls, v: Optional[Dict[str, Any]]) -> Optional[Dict[str, Any]]:
+                if takes_kwargs or v is None:
+                    return v
+
+                plural = '' if len(v) == 1 else 's'
+                keys = ', '.join(map(repr, v.keys()))
+                raise TypeError(f'unexpected keyword argument{plural}: {keys}')
+
+            @field_validator(V_POSITIONAL_ONLY_NAME, check_fields=False)
+            @classmethod
+            def check_positional_only(cls, v: Optional[List[str]]) -> None:
+                if v is None:
+                    return
+
+                plural = '' if len(v) == 1 else 's'
+                keys = ', '.join(map(repr, v))
+                raise TypeError(f'positional-only argument{plural} passed as keyword argument{plural}: {keys}')
+
+            @field_validator(V_DUPLICATE_KWARGS, check_fields=False)
+            @classmethod
+            def check_duplicate_kwargs(cls, v: Optional[List[str]]) -> None:
+                if v is None:
+                    return
+
+                plural = '' if len(v) == 1 else 's'
+                keys = ', '.join(map(repr, v))
+                raise TypeError(f'multiple values for argument{plural}: {keys}')
+
+            model_config = config_wrapper.config_dict
+
+        self.model = create_model(to_pascal(self.raw_function.__name__), __base__=DecoratorBaseModel, **fields)
diff --git a/lib/pydantic/deprecated/json.py b/lib/pydantic/deprecated/json.py
new file mode 100644
index 00000000..79e2f44a
--- /dev/null
+++ b/lib/pydantic/deprecated/json.py
@@ -0,0 +1,140 @@
+import datetime
+import warnings
+from collections import deque
+from decimal import Decimal
+from enum import Enum
+from ipaddress import IPv4Address, IPv4Interface, IPv4Network, IPv6Address, IPv6Interface, IPv6Network
+from pathlib import Path
+from re import Pattern
+from types import GeneratorType
+from typing import TYPE_CHECKING, Any, Callable, Dict, Type, Union
+from uuid import UUID
+
+from typing_extensions import deprecated
+
+from ..color import Color
+from ..networks import NameEmail
+from ..types import SecretBytes, SecretStr
+from ..warnings import PydanticDeprecatedSince20
+
+if not TYPE_CHECKING:
+    # See PyCharm issues https://youtrack.jetbrains.com/issue/PY-21915
+    # and https://youtrack.jetbrains.com/issue/PY-51428
+    DeprecationWarning = PydanticDeprecatedSince20
+
+__all__ = 'pydantic_encoder', 'custom_pydantic_encoder', 'timedelta_isoformat'
+
+
+def isoformat(o: Union[datetime.date, datetime.time]) -> str:
+    return o.isoformat()
+
+
+def decimal_encoder(dec_value: Decimal) -> Union[int, float]:
+    """Encodes a Decimal as int of there's no exponent, otherwise float.
+
+    This is useful when we use ConstrainedDecimal to represent Numeric(x,0)
+    where a integer (but not int typed) is used. Encoding this as a float
+    results in failed round-tripping between encode and parse.
+    Our Id type is a prime example of this.
+
+    >>> decimal_encoder(Decimal("1.0"))
+    1.0
+
+    >>> decimal_encoder(Decimal("1"))
+    1
+    """
+    exponent = dec_value.as_tuple().exponent
+    if isinstance(exponent, int) and exponent >= 0:
+        return int(dec_value)
+    else:
+        return float(dec_value)
+
+
+ENCODERS_BY_TYPE: Dict[Type[Any], Callable[[Any], Any]] = {
+    bytes: lambda o: o.decode(),
+    Color: str,
+    datetime.date: isoformat,
+    datetime.datetime: isoformat,
+    datetime.time: isoformat,
+    datetime.timedelta: lambda td: td.total_seconds(),
+    Decimal: decimal_encoder,
+    Enum: lambda o: o.value,
+    frozenset: list,
+    deque: list,
+    GeneratorType: list,
+    IPv4Address: str,
+    IPv4Interface: str,
+    IPv4Network: str,
+    IPv6Address: str,
+    IPv6Interface: str,
+    IPv6Network: str,
+    NameEmail: str,
+    Path: str,
+    Pattern: lambda o: o.pattern,
+    SecretBytes: str,
+    SecretStr: str,
+    set: list,
+    UUID: str,
+}
+
+
+@deprecated(
+    '`pydantic_encoder` is deprecated, use `pydantic_core.to_jsonable_python` instead.',
+    category=None,
+)
+def pydantic_encoder(obj: Any) -> Any:
+    warnings.warn(
+        '`pydantic_encoder` is deprecated, use `pydantic_core.to_jsonable_python` instead.',
+        category=PydanticDeprecatedSince20,
+        stacklevel=2,
+    )
+    from dataclasses import asdict, is_dataclass
+
+    from ..main import BaseModel
+
+    if isinstance(obj, BaseModel):
+        return obj.model_dump()
+    elif is_dataclass(obj):
+        return asdict(obj)
+
+    # Check the class type and its superclasses for a matching encoder
+    for base in obj.__class__.__mro__[:-1]:
+        try:
+            encoder = ENCODERS_BY_TYPE[base]
+        except KeyError:
+            continue
+        return encoder(obj)
+    else:  # We have exited the for loop without finding a suitable encoder
+        raise TypeError(f"Object of type '{obj.__class__.__name__}' is not JSON serializable")
+
+
+# TODO: Add a suggested migration path once there is a way to use custom encoders
+@deprecated(
+    '`custom_pydantic_encoder` is deprecated, use `BaseModel.model_dump` instead.',
+    category=None,
+)
+def custom_pydantic_encoder(type_encoders: Dict[Any, Callable[[Type[Any]], Any]], obj: Any) -> Any:
+    warnings.warn(
+        '`custom_pydantic_encoder` is deprecated, use `BaseModel.model_dump` instead.',
+        category=PydanticDeprecatedSince20,
+        stacklevel=2,
+    )
+    # Check the class type and its superclasses for a matching encoder
+    for base in obj.__class__.__mro__[:-1]:
+        try:
+            encoder = type_encoders[base]
+        except KeyError:
+            continue
+
+        return encoder(obj)
+    else:  # We have exited the for loop without finding a suitable encoder
+        return pydantic_encoder(obj)
+
+
+@deprecated('`timedelta_isoformat` is deprecated.', category=None)
+def timedelta_isoformat(td: datetime.timedelta) -> str:
+    """ISO 8601 encoding for Python timedelta object."""
+    warnings.warn('`timedelta_isoformat` is deprecated.', category=PydanticDeprecatedSince20, stacklevel=2)
+    minutes, seconds = divmod(td.seconds, 60)
+    hours, minutes = divmod(minutes, 60)
+    return f'{"-" if td.days < 0 else ""}P{abs(td.days)}DT{hours:d}H{minutes:d}M{seconds:d}.{td.microseconds:06d}S'
diff --git a/lib/pydantic/deprecated/parse.py b/lib/pydantic/deprecated/parse.py
new file mode 100644
index 00000000..2a92e62b
--- /dev/null
+++ b/lib/pydantic/deprecated/parse.py
@@ -0,0 +1,80 @@
+from __future__ import annotations
+
+import json
+import pickle
+import warnings
+from enum import Enum
+from pathlib import Path
+from typing import TYPE_CHECKING, Any, Callable
+
+from typing_extensions import deprecated
+
+from ..warnings import PydanticDeprecatedSince20
+
+if not TYPE_CHECKING:
+    # See PyCharm issues https://youtrack.jetbrains.com/issue/PY-21915
+    # and https://youtrack.jetbrains.com/issue/PY-51428
+    DeprecationWarning = PydanticDeprecatedSince20
+
+
+class Protocol(str, Enum):
+    json = 'json'
+    pickle = 'pickle'
+
+
+@deprecated('`load_str_bytes` is deprecated.', category=None)
+def load_str_bytes(
+    b: str | bytes,
+    *,
+    content_type: str | None = None,
+    encoding: str = 'utf8',
+    proto: Protocol | None = None,
+    allow_pickle: bool = False,
+    json_loads: Callable[[str], Any] = json.loads,
+) -> Any:
+    warnings.warn('`load_str_bytes` is deprecated.', category=PydanticDeprecatedSince20, stacklevel=2)
+    if proto is None and content_type:
+        if content_type.endswith(('json', 'javascript')):
+            pass
+        elif allow_pickle and content_type.endswith('pickle'):
+            proto = Protocol.pickle
+        else:
+            raise TypeError(f'Unknown content-type: {content_type}')
+
+    proto = proto or Protocol.json
+
+    if proto == Protocol.json:
+        if isinstance(b, bytes):
+            b = b.decode(encoding)
+        return json_loads(b)  # type: ignore
+    elif proto == Protocol.pickle:
+        if not allow_pickle:
+            raise RuntimeError('Trying to decode with pickle with allow_pickle=False')
+        bb = b if isinstance(b, bytes) else b.encode()  # type: ignore
+        return pickle.loads(bb)
+    else:
+        raise TypeError(f'Unknown protocol: {proto}')
+
+
+@deprecated('`load_file` is deprecated.', category=None)
+def load_file(
+    path: str | Path,
+    *,
+    content_type: str | None = None,
+    encoding: str = 'utf8',
+    proto: Protocol | None = None,
+    allow_pickle: bool = False,
+    json_loads: Callable[[str], Any] = json.loads,
+) -> Any:
+    warnings.warn('`load_file` is deprecated.', category=PydanticDeprecatedSince20, stacklevel=2)
+    path = Path(path)
+    b = path.read_bytes()
+    if content_type is None:
+        if path.suffix in ('.js', '.json'):
+            proto = Protocol.json
+        elif path.suffix == '.pkl':
+            proto = Protocol.pickle
+
+    return load_str_bytes(
+        b, proto=proto, content_type=content_type, encoding=encoding, allow_pickle=allow_pickle, json_loads=json_loads
+    )
diff --git a/lib/pydantic/deprecated/tools.py b/lib/pydantic/deprecated/tools.py
new file mode 100644
index 00000000..b04eae40
--- /dev/null
+++ b/lib/pydantic/deprecated/tools.py
@@ -0,0 +1,103 @@
+from __future__ import annotations
+
+import json
+import warnings
+from typing import TYPE_CHECKING, Any, Callable, Type, TypeVar, Union
+
+from typing_extensions import deprecated
+
+from ..json_schema import DEFAULT_REF_TEMPLATE, GenerateJsonSchema
+from ..type_adapter import TypeAdapter
+from ..warnings import PydanticDeprecatedSince20
+
+if not TYPE_CHECKING:
+    # See PyCharm issues https://youtrack.jetbrains.com/issue/PY-21915
+    # and https://youtrack.jetbrains.com/issue/PY-51428
+    DeprecationWarning = PydanticDeprecatedSince20
+
+__all__ = 'parse_obj_as', 'schema_of', 'schema_json_of'
+
+NameFactory = Union[str, Callable[[Type[Any]], str]]
+
+
+T = TypeVar('T')
+
+
+@deprecated(
+    '`parse_obj_as` is deprecated. Use `pydantic.TypeAdapter.validate_python` instead.',
+    category=None,
+)
+def parse_obj_as(type_: type[T], obj: Any, type_name: NameFactory | None = None) -> T:
+    warnings.warn(
+        '`parse_obj_as` is deprecated. Use `pydantic.TypeAdapter.validate_python` instead.',
+        category=PydanticDeprecatedSince20,
+        stacklevel=2,
+    )
+    if type_name is not None:  # pragma: no cover
+        warnings.warn(
+            'The type_name parameter is deprecated. parse_obj_as no longer creates temporary models',
+            DeprecationWarning,
+            stacklevel=2,
+        )
+    return TypeAdapter(type_).validate_python(obj)
+
+
+@deprecated(
+    '`schema_of` is deprecated. Use `pydantic.TypeAdapter.json_schema` instead.',
+    category=None,
+)
+def schema_of(
+    type_: Any,
+    *,
+    title: NameFactory | None = None,
+    by_alias: bool = True,
+    ref_template: str = DEFAULT_REF_TEMPLATE,
+    schema_generator: type[GenerateJsonSchema] = GenerateJsonSchema,
+) -> dict[str, Any]:
+    """Generate a JSON schema (as dict) for the passed model or dynamically generated one."""
+    warnings.warn(
+        '`schema_of` is deprecated. Use `pydantic.TypeAdapter.json_schema` instead.',
+        category=PydanticDeprecatedSince20,
+        stacklevel=2,
+    )
+    res = TypeAdapter(type_).json_schema(
+        by_alias=by_alias,
+        schema_generator=schema_generator,
+        ref_template=ref_template,
+    )
+    if title is not None:
+        if isinstance(title, str):
+            res['title'] = title
+        else:
+            warnings.warn(
+                'Passing a callable for the `title` parameter is deprecated and no longer supported',
+                DeprecationWarning,
+                stacklevel=2,
+            )
+            res['title'] = title(type_)
+    return res
+
+
+@deprecated(
+    '`schema_json_of` is deprecated. Use `pydantic.TypeAdapter.json_schema` instead.',
+    category=None,
+)
+def schema_json_of(
+    type_: Any,
+    *,
+    title: NameFactory | None = None,
+    by_alias: bool = True,
+    ref_template: str = DEFAULT_REF_TEMPLATE,
+    schema_generator: type[GenerateJsonSchema] = GenerateJsonSchema,
+    **dumps_kwargs: Any,
+) -> str:
+    """Generate a JSON schema (as JSON) for the passed model or dynamically generated one."""
+    warnings.warn(
+        '`schema_json_of` is deprecated. Use `pydantic.TypeAdapter.json_schema` instead.',
+        category=PydanticDeprecatedSince20,
+        stacklevel=2,
+    )
+    return json.dumps(
+        schema_of(type_, title=title, by_alias=by_alias, ref_template=ref_template, schema_generator=schema_generator),
+        **dumps_kwargs,
+    )
diff --git a/lib/pydantic/env_settings.py b/lib/pydantic/env_settings.py
index e9988c01..662f5900 100644
--- a/lib/pydantic/env_settings.py
+++ b/lib/pydantic/env_settings.py
@@ -1,346 +1,4 @@
-import os
-import warnings
-from pathlib import Path
-from typing import AbstractSet, Any, Callable, ClassVar, Dict, List, Mapping, Optional, Tuple, Type, Union
+"""The `env_settings` module is a backport module from V1."""
+from ._migration import getattr_migration
 
-from .config import BaseConfig, Extra
-from .fields import ModelField
-from .main import BaseModel
-from .typing import StrPath, display_as_type, get_origin, is_union
-from .utils import deep_update, path_type, sequence_like
-
-env_file_sentinel = str(object())
-
-SettingsSourceCallable = Callable[['BaseSettings'], Dict[str, Any]]
-DotenvType = Union[StrPath, List[StrPath], Tuple[StrPath, ...]]
-
-
-class SettingsError(ValueError):
-    pass
-
-
-class BaseSettings(BaseModel):
-    """
-    Base class for settings, allowing values to be overridden by environment variables.
-
-    This is useful in production for secrets you do not wish to save in code, it plays nicely with docker(-compose),
-    Heroku and any 12 factor app design.
-    """
-
-    def __init__(
-        __pydantic_self__,
-        _env_file: Optional[DotenvType] = env_file_sentinel,
-        _env_file_encoding: Optional[str] = None,
-        _env_nested_delimiter: Optional[str] = None,
-        _secrets_dir: Optional[StrPath] = None,
-        **values: Any,
-    ) -> None:
-        # Uses something other than `self` the first arg to allow "self" as a settable attribute
-        super().__init__(
-            **__pydantic_self__._build_values(
-                values,
-                _env_file=_env_file,
-                _env_file_encoding=_env_file_encoding,
-                _env_nested_delimiter=_env_nested_delimiter,
-                _secrets_dir=_secrets_dir,
-            )
-        )
-
-    def _build_values(
-        self,
-        init_kwargs: Dict[str, Any],
-        _env_file: Optional[DotenvType] = None,
-        _env_file_encoding: Optional[str] = None,
-        _env_nested_delimiter: Optional[str] = None,
-        _secrets_dir: Optional[StrPath] = None,
-    ) -> Dict[str, Any]:
-        # Configure built-in sources
-        init_settings = InitSettingsSource(init_kwargs=init_kwargs)
-        env_settings = EnvSettingsSource(
-            env_file=(_env_file if _env_file != env_file_sentinel else self.__config__.env_file),
-            env_file_encoding=(
-                _env_file_encoding if _env_file_encoding is not None else self.__config__.env_file_encoding
-            ),
-            env_nested_delimiter=(
-                _env_nested_delimiter if _env_nested_delimiter is not None else self.__config__.env_nested_delimiter
-            ),
-            env_prefix_len=len(self.__config__.env_prefix),
-        )
-        file_secret_settings = SecretsSettingsSource(secrets_dir=_secrets_dir or self.__config__.secrets_dir)
-        # Provide a hook to set built-in sources priority and add / remove sources
-        sources = self.__config__.customise_sources(
-            init_settings=init_settings, env_settings=env_settings, file_secret_settings=file_secret_settings
-        )
-        if sources:
-            return deep_update(*reversed([source(self) for source in sources]))
-        else:
-            # no one should mean to do this, but I think returning an empty dict is marginally preferable
-            # to an informative error and much better than a confusing error
-            return {}
-
-    class Config(BaseConfig):
-        env_prefix: str = ''
-        env_file: Optional[DotenvType] = None
-        env_file_encoding: Optional[str] = None
-        env_nested_delimiter: Optional[str] = None
-        secrets_dir: Optional[StrPath] = None
-        validate_all: bool = True
-        extra: Extra = Extra.forbid
-        arbitrary_types_allowed: bool = True
-        case_sensitive: bool = False
-
-        @classmethod
-        def prepare_field(cls, field: ModelField) -> None:
-            env_names: Union[List[str], AbstractSet[str]]
-            field_info_from_config = cls.get_field_info(field.name)
-
-            env = field_info_from_config.get('env') or field.field_info.extra.get('env')
-            if env is None:
-                if field.has_alias:
-                    warnings.warn(
-                        'aliases are no longer used by BaseSettings to define which environment variables to read. '
-                        'Instead use the "env" field setting. '
-                        'See https://pydantic-docs.helpmanual.io/usage/settings/#environment-variable-names',
-                        FutureWarning,
-                    )
-                env_names = {cls.env_prefix + field.name}
-            elif isinstance(env, str):
-                env_names = {env}
-            elif isinstance(env, (set, frozenset)):
-                env_names = env
-            elif sequence_like(env):
-                env_names = list(env)
-            else:
-                raise TypeError(f'invalid field env: {env!r} ({display_as_type(env)}); should be string, list or set')
-
-            if not cls.case_sensitive:
-                env_names = env_names.__class__(n.lower() for n in env_names)
-            field.field_info.extra['env_names'] = env_names
-
-        @classmethod
-        def customise_sources(
-            cls,
-            init_settings: SettingsSourceCallable,
-            env_settings: SettingsSourceCallable,
-            file_secret_settings: SettingsSourceCallable,
-        ) -> Tuple[SettingsSourceCallable, ...]:
-            return init_settings, env_settings, file_secret_settings
-
-        @classmethod
-        def parse_env_var(cls, field_name: str, raw_val: str) -> Any:
-            return cls.json_loads(raw_val)
-
-    # populated by the metaclass using the Config class defined above, annotated here to help IDEs only
-    __config__: ClassVar[Type[Config]]
-
-
-class InitSettingsSource:
-    __slots__ = ('init_kwargs',)
-
-    def __init__(self, init_kwargs: Dict[str, Any]):
-        self.init_kwargs = init_kwargs
-
-    def __call__(self, settings: BaseSettings) -> Dict[str, Any]:
-        return self.init_kwargs
-
-    def __repr__(self) -> str:
-        return f'InitSettingsSource(init_kwargs={self.init_kwargs!r})'
-
-
-class EnvSettingsSource:
-    __slots__ = ('env_file', 'env_file_encoding', 'env_nested_delimiter', 'env_prefix_len')
-
-    def __init__(
-        self,
-        env_file: Optional[DotenvType],
-        env_file_encoding: Optional[str],
-        env_nested_delimiter: Optional[str] = None,
-        env_prefix_len: int = 0,
-    ):
-        self.env_file: Optional[DotenvType] = env_file
-        self.env_file_encoding: Optional[str] = env_file_encoding
-        self.env_nested_delimiter: Optional[str] = env_nested_delimiter
-        self.env_prefix_len: int = env_prefix_len
-
-    def __call__(self, settings: BaseSettings) -> Dict[str, Any]:  # noqa C901
-        """
-        Build environment variables suitable for passing to the Model.
-        """
-        d: Dict[str, Any] = {}
-
-        if settings.__config__.case_sensitive:
-            env_vars: Mapping[str, Optional[str]] = os.environ
-        else:
-            env_vars = {k.lower(): v for k, v in os.environ.items()}
-
-        dotenv_vars = self._read_env_files(settings.__config__.case_sensitive)
-        if dotenv_vars:
-            env_vars = {**dotenv_vars, **env_vars}
-
-        for field in settings.__fields__.values():
-            env_val: Optional[str] = None
-            for env_name in field.field_info.extra['env_names']:
-                env_val = env_vars.get(env_name)
-                if env_val is not None:
-                    break
-
-            is_complex, allow_parse_failure = self.field_is_complex(field)
-            if is_complex:
-                if env_val is None:
-                    # field is complex but no value found so far, try explode_env_vars
-                    env_val_built = self.explode_env_vars(field, env_vars)
-                    if env_val_built:
-                        d[field.alias] = env_val_built
-                else:
-                    # field is complex and there's a value, decode that as JSON, then add explode_env_vars
-                    try:
-                        env_val = settings.__config__.parse_env_var(field.name, env_val)
-                    except ValueError as e:
-                        if not allow_parse_failure:
-                            raise SettingsError(f'error parsing env var "{env_name}"') from e
-
-                    if isinstance(env_val, dict):
-                        d[field.alias] = deep_update(env_val, self.explode_env_vars(field, env_vars))
-                    else:
-                        d[field.alias] = env_val
-            elif env_val is not None:
-                # simplest case, field is not complex, we only need to add the value if it was found
-                d[field.alias] = env_val
-
-        return d
-
-    def _read_env_files(self, case_sensitive: bool) -> Dict[str, Optional[str]]:
-        env_files = self.env_file
-        if env_files is None:
-            return {}
-
-        if isinstance(env_files, (str, os.PathLike)):
-            env_files = [env_files]
-
-        dotenv_vars = {}
-        for env_file in env_files:
-            env_path = Path(env_file).expanduser()
-            if env_path.is_file():
-                dotenv_vars.update(
-                    read_env_file(env_path, encoding=self.env_file_encoding, case_sensitive=case_sensitive)
-                )
-
-        return dotenv_vars
-
-    def field_is_complex(self, field: ModelField) -> Tuple[bool, bool]:
-        """
-        Find out if a field is complex, and if so whether JSON errors should be ignored
-        """
-        if field.is_complex():
-            allow_parse_failure = False
-        elif is_union(get_origin(field.type_)) and field.sub_fields and any(f.is_complex() for f in field.sub_fields):
-            allow_parse_failure = True
-        else:
-            return False, False
-
-        return True, allow_parse_failure
-
-    def explode_env_vars(self, field: ModelField, env_vars: Mapping[str, Optional[str]]) -> Dict[str, Any]:
-        """
-        Process env_vars and extract the values of keys containing env_nested_delimiter into nested dictionaries.
-
-        This is applied to a single field, hence filtering by env_var prefix.
-        """
-        prefixes = [f'{env_name}{self.env_nested_delimiter}' for env_name in field.field_info.extra['env_names']]
-        result: Dict[str, Any] = {}
-        for env_name, env_val in env_vars.items():
-            if not any(env_name.startswith(prefix) for prefix in prefixes):
-                continue
-            # we remove the prefix before splitting in case the prefix has characters in common with the delimiter
-            env_name_without_prefix = env_name[self.env_prefix_len :]
-            _, *keys, last_key = env_name_without_prefix.split(self.env_nested_delimiter)
-            env_var = result
-            for key in keys:
-                env_var = env_var.setdefault(key, {})
-            env_var[last_key] = env_val
-
-        return result
-
-    def __repr__(self) -> str:
-        return (
-            f'EnvSettingsSource(env_file={self.env_file!r}, env_file_encoding={self.env_file_encoding!r}, '
-            f'env_nested_delimiter={self.env_nested_delimiter!r})'
-        )
-
-
-class SecretsSettingsSource:
-    __slots__ = ('secrets_dir',)
-
-    def __init__(self, secrets_dir: Optional[StrPath]):
-        self.secrets_dir: Optional[StrPath] = secrets_dir
-
-    def __call__(self, settings: BaseSettings) -> Dict[str, Any]:
-        """
-        Build fields from "secrets" files.
-        """
-        secrets: Dict[str, Optional[str]] = {}
-
-        if self.secrets_dir is None:
-            return secrets
-
-        secrets_path = Path(self.secrets_dir).expanduser()
-
-        if not secrets_path.exists():
-            warnings.warn(f'directory "{secrets_path}" does not exist')
-            return secrets
-
-        if not secrets_path.is_dir():
-            raise SettingsError(f'secrets_dir must reference a directory, not a {path_type(secrets_path)}')
-
-        for field in settings.__fields__.values():
-            for env_name in field.field_info.extra['env_names']:
-                path = find_case_path(secrets_path, env_name, settings.__config__.case_sensitive)
-                if not path:
-                    # path does not exist, we curently don't return a warning for this
-                    continue
-
-                if path.is_file():
-                    secret_value = path.read_text().strip()
-                    if field.is_complex():
-                        try:
-                            secret_value = settings.__config__.parse_env_var(field.name, secret_value)
-                        except ValueError as e:
-                            raise SettingsError(f'error parsing env var "{env_name}"') from e
-
-                    secrets[field.alias] = secret_value
-                else:
-                    warnings.warn(
-                        f'attempted to load secret file "{path}" but found a {path_type(path)} instead.',
-                        stacklevel=4,
-                    )
-        return secrets
-
-    def __repr__(self) -> str:
-        return f'SecretsSettingsSource(secrets_dir={self.secrets_dir!r})'
-
-
-def read_env_file(
-    file_path: StrPath, *, encoding: str = None, case_sensitive: bool = False
-) -> Dict[str, Optional[str]]:
-    try:
-        from dotenv import dotenv_values
-    except ImportError as e:
-        raise ImportError('python-dotenv is not installed, run `pip install pydantic[dotenv]`') from e
-
-    file_vars: Dict[str, Optional[str]] = dotenv_values(file_path, encoding=encoding or 'utf8')
-    if not case_sensitive:
-        return {k.lower(): v for k, v in file_vars.items()}
-    else:
-        return file_vars
-
-
-def find_case_path(dir_path: Path, file_name: str, case_sensitive: bool) -> Optional[Path]:
-    """
-    Find a file within path's directory matching filename, optionally ignoring case.
-    """
-    for f in dir_path.iterdir():
-        if f.name == file_name:
-            return f
-        elif not case_sensitive and f.name.lower() == file_name.lower():
-            return f
-    return None
+__getattr__ = getattr_migration(__name__)
diff --git a/lib/pydantic/error_wrappers.py b/lib/pydantic/error_wrappers.py
index 5d3204f4..5144eeee 100644
--- a/lib/pydantic/error_wrappers.py
+++ b/lib/pydantic/error_wrappers.py
@@ -1,162 +1,4 @@
-import json
-from typing import TYPE_CHECKING, Any, Dict, Generator, List, Optional, Sequence, Tuple, Type, Union
+"""The `error_wrappers` module is a backport module from V1."""
+from ._migration import getattr_migration
 
-from .json import pydantic_encoder
-from .utils import Representation
-
-if TYPE_CHECKING:
-    from typing_extensions import TypedDict
-
-    from .config import BaseConfig
-    from .types import ModelOrDc
-    from .typing import ReprArgs
-
-    Loc = Tuple[Union[int, str], ...]
-
-    class _ErrorDictRequired(TypedDict):
-        loc: Loc
-        msg: str
-        type: str
-
-    class ErrorDict(_ErrorDictRequired, total=False):
-        ctx: Dict[str, Any]
-
-
-__all__ = 'ErrorWrapper', 'ValidationError'
-
-
-class ErrorWrapper(Representation):
-    __slots__ = 'exc', '_loc'
-
-    def __init__(self, exc: Exception, loc: Union[str, 'Loc']) -> None:
-        self.exc = exc
-        self._loc = loc
-
-    def loc_tuple(self) -> 'Loc':
-        if isinstance(self._loc, tuple):
-            return self._loc
-        else:
-            return (self._loc,)
-
-    def __repr_args__(self) -> 'ReprArgs':
-        return [('exc', self.exc), ('loc', self.loc_tuple())]
-
-
-# ErrorList is something like Union[List[Union[List[ErrorWrapper], ErrorWrapper]], ErrorWrapper]
-# but recursive, therefore just use:
-ErrorList = Union[Sequence[Any], ErrorWrapper]
-
-
-class ValidationError(Representation, ValueError):
-    __slots__ = 'raw_errors', 'model', '_error_cache'
-
-    def __init__(self, errors: Sequence[ErrorList], model: 'ModelOrDc') -> None:
-        self.raw_errors = errors
-        self.model = model
-        self._error_cache: Optional[List['ErrorDict']] = None
-
-    def errors(self) -> List['ErrorDict']:
-        if self._error_cache is None:
-            try:
-                config = self.model.__config__  # type: ignore
-            except AttributeError:
-                config = self.model.__pydantic_model__.__config__  # type: ignore
-            self._error_cache = list(flatten_errors(self.raw_errors, config))
-        return self._error_cache
-
-    def json(self, *, indent: Union[None, int, str] = 2) -> str:
-        return json.dumps(self.errors(), indent=indent, default=pydantic_encoder)
-
-    def __str__(self) -> str:
-        errors = self.errors()
-        no_errors = len(errors)
-        return (
-            f'{no_errors} validation error{"" if no_errors == 1 else "s"} for {self.model.__name__}\n'
-            f'{display_errors(errors)}'
-        )
-
-    def __repr_args__(self) -> 'ReprArgs':
-        return [('model', self.model.__name__), ('errors', self.errors())]
-
-
-def display_errors(errors: List['ErrorDict']) -> str:
-    return '\n'.join(f'{_display_error_loc(e)}\n  {e["msg"]} ({_display_error_type_and_ctx(e)})' for e in errors)
-
-
-def _display_error_loc(error: 'ErrorDict') -> str:
-    return ' -> '.join(str(e) for e in error['loc'])
-
-
-def _display_error_type_and_ctx(error: 'ErrorDict') -> str:
-    t = 'type=' + error['type']
-    ctx = error.get('ctx')
-    if ctx:
-        return t + ''.join(f'; {k}={v}' for k, v in ctx.items())
-    else:
-        return t
-
-
-def flatten_errors(
-    errors: Sequence[Any], config: Type['BaseConfig'], loc: Optional['Loc'] = None
-) -> Generator['ErrorDict', None, None]:
-    for error in errors:
-        if isinstance(error, ErrorWrapper):
-
-            if loc:
-                error_loc = loc + error.loc_tuple()
-            else:
-                error_loc = error.loc_tuple()
-
-            if isinstance(error.exc, ValidationError):
-                yield from flatten_errors(error.exc.raw_errors, config, error_loc)
-            else:
-                yield error_dict(error.exc, config, error_loc)
-        elif isinstance(error, list):
-            yield from flatten_errors(error, config, loc=loc)
-        else:
-            raise RuntimeError(f'Unknown error object: {error}')
-
-
-def error_dict(exc: Exception, config: Type['BaseConfig'], loc: 'Loc') -> 'ErrorDict':
-    type_ = get_exc_type(exc.__class__)
-    msg_template = config.error_msg_templates.get(type_) or getattr(exc, 'msg_template', None)
-    ctx = exc.__dict__
-    if msg_template:
-        msg = msg_template.format(**ctx)
-    else:
-        msg = str(exc)
-
-    d: 'ErrorDict' = {'loc': loc, 'msg': msg, 'type': type_}
-
-    if ctx:
-        d['ctx'] = ctx
-
-    return d
-
-
-_EXC_TYPE_CACHE: Dict[Type[Exception], str] = {}
-
-
-def get_exc_type(cls: Type[Exception]) -> str:
-    # slightly more efficient than using lru_cache since we don't need to worry about the cache filling up
-    try:
-        return _EXC_TYPE_CACHE[cls]
-    except KeyError:
-        r = _get_exc_type(cls)
-        _EXC_TYPE_CACHE[cls] = r
-        return r
-
-
-def _get_exc_type(cls: Type[Exception]) -> str:
-    if issubclass(cls, AssertionError):
-        return 'assertion_error'
-
-    base_name = 'type_error' if issubclass(cls, TypeError) else 'value_error'
-    if cls in (TypeError, ValueError):
-        # just TypeError or ValueError, no extra code
-        return base_name
-
-    # if it's not a TypeError or ValueError, we just take the lowercase of the exception name
-    # no chaining or snake case logic, use "code" for more complex error types.
-    code = getattr(cls, 'code', None) or cls.__name__.replace('Error', '').lower()
-    return base_name + '.' + code
+__getattr__ = getattr_migration(__name__)
diff --git a/lib/pydantic/errors.py b/lib/pydantic/errors.py
index 7bdafdd1..c5fa9612 100644
--- a/lib/pydantic/errors.py
+++ b/lib/pydantic/errors.py
@@ -1,646 +1,152 @@
-from decimal import Decimal
-from pathlib import Path
-from typing import TYPE_CHECKING, Any, Callable, Sequence, Set, Tuple, Type, Union
+"""Pydantic-specific errors."""
+from __future__ import annotations as _annotations
 
-from .typing import display_as_type
+import re
 
-if TYPE_CHECKING:
-    from .typing import DictStrAny
+from typing_extensions import Literal, Self
+
+from ._migration import getattr_migration
+from .version import version_short
 
-# explicitly state exports to avoid "from .errors import *" also importing Decimal, Path etc.
 __all__ = (
-    'PydanticTypeError',
-    'PydanticValueError',
-    'ConfigError',
-    'MissingError',
-    'ExtraError',
-    'NoneIsNotAllowedError',
-    'NoneIsAllowedError',
-    'WrongConstantError',
-    'NotNoneError',
-    'BoolError',
-    'BytesError',
-    'DictError',
-    'EmailError',
-    'UrlError',
-    'UrlSchemeError',
-    'UrlSchemePermittedError',
-    'UrlUserInfoError',
-    'UrlHostError',
-    'UrlHostTldError',
-    'UrlPortError',
-    'UrlExtraError',
-    'EnumError',
-    'IntEnumError',
-    'EnumMemberError',
-    'IntegerError',
-    'FloatError',
-    'PathError',
-    'PathNotExistsError',
-    'PathNotAFileError',
-    'PathNotADirectoryError',
-    'PyObjectError',
-    'SequenceError',
-    'ListError',
-    'SetError',
-    'FrozenSetError',
-    'TupleError',
-    'TupleLengthError',
-    'ListMinLengthError',
-    'ListMaxLengthError',
-    'ListUniqueItemsError',
-    'SetMinLengthError',
-    'SetMaxLengthError',
-    'FrozenSetMinLengthError',
-    'FrozenSetMaxLengthError',
-    'AnyStrMinLengthError',
-    'AnyStrMaxLengthError',
-    'StrError',
-    'StrRegexError',
-    'NumberNotGtError',
-    'NumberNotGeError',
-    'NumberNotLtError',
-    'NumberNotLeError',
-    'NumberNotMultipleError',
-    'DecimalError',
-    'DecimalIsNotFiniteError',
-    'DecimalMaxDigitsError',
-    'DecimalMaxPlacesError',
-    'DecimalWholeDigitsError',
-    'DateTimeError',
-    'DateError',
-    'DateNotInThePastError',
-    'DateNotInTheFutureError',
-    'TimeError',
-    'DurationError',
-    'HashableError',
-    'UUIDError',
-    'UUIDVersionError',
-    'ArbitraryTypeError',
-    'ClassError',
-    'SubclassError',
-    'JsonError',
-    'JsonTypeError',
-    'PatternError',
-    'DataclassTypeError',
-    'CallableError',
-    'IPvAnyAddressError',
-    'IPvAnyInterfaceError',
-    'IPvAnyNetworkError',
-    'IPv4AddressError',
-    'IPv6AddressError',
-    'IPv4NetworkError',
-    'IPv6NetworkError',
-    'IPv4InterfaceError',
-    'IPv6InterfaceError',
-    'ColorError',
-    'StrictBoolError',
-    'NotDigitError',
-    'LuhnValidationError',
-    'InvalidLengthForBrand',
-    'InvalidByteSize',
-    'InvalidByteSizeUnit',
-    'MissingDiscriminator',
-    'InvalidDiscriminator',
+    'PydanticUserError',
+    'PydanticUndefinedAnnotation',
+    'PydanticImportError',
+    'PydanticSchemaGenerationError',
+    'PydanticInvalidForJsonSchema',
+    'PydanticErrorCodes',
 )
 
-
-def cls_kwargs(cls: Type['PydanticErrorMixin'], ctx: 'DictStrAny') -> 'PydanticErrorMixin':
-    """
-    For built-in exceptions like ValueError or TypeError, we need to implement
-    __reduce__ to override the default behaviour (instead of __getstate__/__setstate__)
-    By default pickle protocol 2 calls `cls.__new__(cls, *args)`.
-    Since we only use kwargs, we need a little constructor to change that.
-    Note: the callable can't be a lambda as pickle looks in the namespace to find it
-    """
-    return cls(**ctx)
+# We use this URL to allow for future flexibility about how we host the docs, while allowing for Pydantic
+# code in the while with "old" URLs to still work.
+# 'u' refers to "user errors" - e.g. errors caused by developers using pydantic, as opposed to validation errors.
+DEV_ERROR_DOCS_URL = f'https://errors.pydantic.dev/{version_short()}/u/'
+PydanticErrorCodes = Literal[
+    'class-not-fully-defined',
+    'custom-json-schema',
+    'decorator-missing-field',
+    'discriminator-no-field',
+    'discriminator-alias-type',
+    'discriminator-needs-literal',
+    'discriminator-alias',
+    'discriminator-validator',
+    'callable-discriminator-no-tag',
+    'typed-dict-version',
+    'model-field-overridden',
+    'model-field-missing-annotation',
+    'config-both',
+    'removed-kwargs',
+    'invalid-for-json-schema',
+    'json-schema-already-used',
+    'base-model-instantiated',
+    'undefined-annotation',
+    'schema-for-unknown-type',
+    'import-error',
+    'create-model-field-definitions',
+    'create-model-config-base',
+    'validator-no-fields',
+    'validator-invalid-fields',
+    'validator-instance-method',
+    'root-validator-pre-skip',
+    'model-serializer-instance-method',
+    'validator-field-config-info',
+    'validator-v1-signature',
+    'validator-signature',
+    'field-serializer-signature',
+    'model-serializer-signature',
+    'multiple-field-serializers',
+    'invalid_annotated_type',
+    'type-adapter-config-unused',
+    'root-model-extra',
+    'unevaluable-type-annotation',
+    'dataclass-init-false-extra-allow',
+    'clashing-init-and-init-var',
+]
 
 
 class PydanticErrorMixin:
-    code: str
-    msg_template: str
+    """A mixin class for common functionality shared by all Pydantic-specific errors.
 
-    def __init__(self, **ctx: Any) -> None:
-        self.__dict__ = ctx
+    Attributes:
+        message: A message describing the error.
+        code: An optional error code from PydanticErrorCodes enum.
+    """
+
+    def __init__(self, message: str, *, code: PydanticErrorCodes | None) -> None:
+        self.message = message
+        self.code = code
 
     def __str__(self) -> str:
-        return self.msg_template.format(**self.__dict__)
+        if self.code is None:
+            return self.message
+        else:
+            return f'{self.message}\n\nFor further information visit {DEV_ERROR_DOCS_URL}{self.code}'
 
-    def __reduce__(self) -> Tuple[Callable[..., 'PydanticErrorMixin'], Tuple[Type['PydanticErrorMixin'], 'DictStrAny']]:
-        return cls_kwargs, (self.__class__, self.__dict__)
 
+class PydanticUserError(PydanticErrorMixin, TypeError):
+    """An error raised due to incorrect use of Pydantic."""
 
-class PydanticTypeError(PydanticErrorMixin, TypeError):
-    pass
 
+class PydanticUndefinedAnnotation(PydanticErrorMixin, NameError):
+    """A subclass of `NameError` raised when handling undefined annotations during `CoreSchema` generation.
 
-class PydanticValueError(PydanticErrorMixin, ValueError):
-    pass
+    Attributes:
+        name: Name of the error.
+        message: Description of the error.
+    """
 
+    def __init__(self, name: str, message: str) -> None:
+        self.name = name
+        super().__init__(message=message, code='undefined-annotation')
 
-class ConfigError(RuntimeError):
-    pass
+    @classmethod
+    def from_name_error(cls, name_error: NameError) -> Self:
+        """Convert a `NameError` to a `PydanticUndefinedAnnotation` error.
 
+        Args:
+            name_error: `NameError` to be converted.
 
-class MissingError(PydanticValueError):
-    msg_template = 'field required'
+        Returns:
+            Converted `PydanticUndefinedAnnotation` error.
+        """
+        try:
+            name = name_error.name  # type: ignore  # python > 3.10
+        except AttributeError:
+            name = re.search(r".*'(.+?)'", str(name_error)).group(1)  # type: ignore[union-attr]
+        return cls(name=name, message=str(name_error))
 
 
-class ExtraError(PydanticValueError):
-    msg_template = 'extra fields not permitted'
+class PydanticImportError(PydanticErrorMixin, ImportError):
+    """An error raised when an import fails due to module changes between V1 and V2.
 
+    Attributes:
+        message: Description of the error.
+    """
 
-class NoneIsNotAllowedError(PydanticTypeError):
-    code = 'none.not_allowed'
-    msg_template = 'none is not an allowed value'
+    def __init__(self, message: str) -> None:
+        super().__init__(message, code='import-error')
 
 
-class NoneIsAllowedError(PydanticTypeError):
-    code = 'none.allowed'
-    msg_template = 'value is not none'
+class PydanticSchemaGenerationError(PydanticUserError):
+    """An error raised during failures to generate a `CoreSchema` for some type.
 
+    Attributes:
+        message: Description of the error.
+    """
 
-class WrongConstantError(PydanticValueError):
-    code = 'const'
+    def __init__(self, message: str) -> None:
+        super().__init__(message, code='schema-for-unknown-type')
 
-    def __str__(self) -> str:
-        permitted = ', '.join(repr(v) for v in self.permitted)  # type: ignore
-        return f'unexpected value; permitted: {permitted}'
 
+class PydanticInvalidForJsonSchema(PydanticUserError):
+    """An error raised during failures to generate a JSON schema for some `CoreSchema`.
 
-class NotNoneError(PydanticTypeError):
-    code = 'not_none'
-    msg_template = 'value is not None'
+    Attributes:
+        message: Description of the error.
+    """
 
+    def __init__(self, message: str) -> None:
+        super().__init__(message, code='invalid-for-json-schema')
 
-class BoolError(PydanticTypeError):
-    msg_template = 'value could not be parsed to a boolean'
 
-
-class BytesError(PydanticTypeError):
-    msg_template = 'byte type expected'
-
-
-class DictError(PydanticTypeError):
-    msg_template = 'value is not a valid dict'
-
-
-class EmailError(PydanticValueError):
-    msg_template = 'value is not a valid email address'
-
-
-class UrlError(PydanticValueError):
-    code = 'url'
-
-
-class UrlSchemeError(UrlError):
-    code = 'url.scheme'
-    msg_template = 'invalid or missing URL scheme'
-
-
-class UrlSchemePermittedError(UrlError):
-    code = 'url.scheme'
-    msg_template = 'URL scheme not permitted'
-
-    def __init__(self, allowed_schemes: Set[str]):
-        super().__init__(allowed_schemes=allowed_schemes)
-
-
-class UrlUserInfoError(UrlError):
-    code = 'url.userinfo'
-    msg_template = 'userinfo required in URL but missing'
-
-
-class UrlHostError(UrlError):
-    code = 'url.host'
-    msg_template = 'URL host invalid'
-
-
-class UrlHostTldError(UrlError):
-    code = 'url.host'
-    msg_template = 'URL host invalid, top level domain required'
-
-
-class UrlPortError(UrlError):
-    code = 'url.port'
-    msg_template = 'URL port invalid, port cannot exceed 65535'
-
-
-class UrlExtraError(UrlError):
-    code = 'url.extra'
-    msg_template = 'URL invalid, extra characters found after valid URL: {extra!r}'
-
-
-class EnumMemberError(PydanticTypeError):
-    code = 'enum'
-
-    def __str__(self) -> str:
-        permitted = ', '.join(repr(v.value) for v in self.enum_values)  # type: ignore
-        return f'value is not a valid enumeration member; permitted: {permitted}'
-
-
-class IntegerError(PydanticTypeError):
-    msg_template = 'value is not a valid integer'
-
-
-class FloatError(PydanticTypeError):
-    msg_template = 'value is not a valid float'
-
-
-class PathError(PydanticTypeError):
-    msg_template = 'value is not a valid path'
-
-
-class _PathValueError(PydanticValueError):
-    def __init__(self, *, path: Path) -> None:
-        super().__init__(path=str(path))
-
-
-class PathNotExistsError(_PathValueError):
-    code = 'path.not_exists'
-    msg_template = 'file or directory at path "{path}" does not exist'
-
-
-class PathNotAFileError(_PathValueError):
-    code = 'path.not_a_file'
-    msg_template = 'path "{path}" does not point to a file'
-
-
-class PathNotADirectoryError(_PathValueError):
-    code = 'path.not_a_directory'
-    msg_template = 'path "{path}" does not point to a directory'
-
-
-class PyObjectError(PydanticTypeError):
-    msg_template = 'ensure this value contains valid import path or valid callable: {error_message}'
-
-
-class SequenceError(PydanticTypeError):
-    msg_template = 'value is not a valid sequence'
-
-
-class IterableError(PydanticTypeError):
-    msg_template = 'value is not a valid iterable'
-
-
-class ListError(PydanticTypeError):
-    msg_template = 'value is not a valid list'
-
-
-class SetError(PydanticTypeError):
-    msg_template = 'value is not a valid set'
-
-
-class FrozenSetError(PydanticTypeError):
-    msg_template = 'value is not a valid frozenset'
-
-
-class DequeError(PydanticTypeError):
-    msg_template = 'value is not a valid deque'
-
-
-class TupleError(PydanticTypeError):
-    msg_template = 'value is not a valid tuple'
-
-
-class TupleLengthError(PydanticValueError):
-    code = 'tuple.length'
-    msg_template = 'wrong tuple length {actual_length}, expected {expected_length}'
-
-    def __init__(self, *, actual_length: int, expected_length: int) -> None:
-        super().__init__(actual_length=actual_length, expected_length=expected_length)
-
-
-class ListMinLengthError(PydanticValueError):
-    code = 'list.min_items'
-    msg_template = 'ensure this value has at least {limit_value} items'
-
-    def __init__(self, *, limit_value: int) -> None:
-        super().__init__(limit_value=limit_value)
-
-
-class ListMaxLengthError(PydanticValueError):
-    code = 'list.max_items'
-    msg_template = 'ensure this value has at most {limit_value} items'
-
-    def __init__(self, *, limit_value: int) -> None:
-        super().__init__(limit_value=limit_value)
-
-
-class ListUniqueItemsError(PydanticValueError):
-    code = 'list.unique_items'
-    msg_template = 'the list has duplicated items'
-
-
-class SetMinLengthError(PydanticValueError):
-    code = 'set.min_items'
-    msg_template = 'ensure this value has at least {limit_value} items'
-
-    def __init__(self, *, limit_value: int) -> None:
-        super().__init__(limit_value=limit_value)
-
-
-class SetMaxLengthError(PydanticValueError):
-    code = 'set.max_items'
-    msg_template = 'ensure this value has at most {limit_value} items'
-
-    def __init__(self, *, limit_value: int) -> None:
-        super().__init__(limit_value=limit_value)
-
-
-class FrozenSetMinLengthError(PydanticValueError):
-    code = 'frozenset.min_items'
-    msg_template = 'ensure this value has at least {limit_value} items'
-
-    def __init__(self, *, limit_value: int) -> None:
-        super().__init__(limit_value=limit_value)
-
-
-class FrozenSetMaxLengthError(PydanticValueError):
-    code = 'frozenset.max_items'
-    msg_template = 'ensure this value has at most {limit_value} items'
-
-    def __init__(self, *, limit_value: int) -> None:
-        super().__init__(limit_value=limit_value)
-
-
-class AnyStrMinLengthError(PydanticValueError):
-    code = 'any_str.min_length'
-    msg_template = 'ensure this value has at least {limit_value} characters'
-
-    def __init__(self, *, limit_value: int) -> None:
-        super().__init__(limit_value=limit_value)
-
-
-class AnyStrMaxLengthError(PydanticValueError):
-    code = 'any_str.max_length'
-    msg_template = 'ensure this value has at most {limit_value} characters'
-
-    def __init__(self, *, limit_value: int) -> None:
-        super().__init__(limit_value=limit_value)
-
-
-class StrError(PydanticTypeError):
-    msg_template = 'str type expected'
-
-
-class StrRegexError(PydanticValueError):
-    code = 'str.regex'
-    msg_template = 'string does not match regex "{pattern}"'
-
-    def __init__(self, *, pattern: str) -> None:
-        super().__init__(pattern=pattern)
-
-
-class _NumberBoundError(PydanticValueError):
-    def __init__(self, *, limit_value: Union[int, float, Decimal]) -> None:
-        super().__init__(limit_value=limit_value)
-
-
-class NumberNotGtError(_NumberBoundError):
-    code = 'number.not_gt'
-    msg_template = 'ensure this value is greater than {limit_value}'
-
-
-class NumberNotGeError(_NumberBoundError):
-    code = 'number.not_ge'
-    msg_template = 'ensure this value is greater than or equal to {limit_value}'
-
-
-class NumberNotLtError(_NumberBoundError):
-    code = 'number.not_lt'
-    msg_template = 'ensure this value is less than {limit_value}'
-
-
-class NumberNotLeError(_NumberBoundError):
-    code = 'number.not_le'
-    msg_template = 'ensure this value is less than or equal to {limit_value}'
-
-
-class NumberNotFiniteError(PydanticValueError):
-    code = 'number.not_finite_number'
-    msg_template = 'ensure this value is a finite number'
-
-
-class NumberNotMultipleError(PydanticValueError):
-    code = 'number.not_multiple'
-    msg_template = 'ensure this value is a multiple of {multiple_of}'
-
-    def __init__(self, *, multiple_of: Union[int, float, Decimal]) -> None:
-        super().__init__(multiple_of=multiple_of)
-
-
-class DecimalError(PydanticTypeError):
-    msg_template = 'value is not a valid decimal'
-
-
-class DecimalIsNotFiniteError(PydanticValueError):
-    code = 'decimal.not_finite'
-    msg_template = 'value is not a valid decimal'
-
-
-class DecimalMaxDigitsError(PydanticValueError):
-    code = 'decimal.max_digits'
-    msg_template = 'ensure that there are no more than {max_digits} digits in total'
-
-    def __init__(self, *, max_digits: int) -> None:
-        super().__init__(max_digits=max_digits)
-
-
-class DecimalMaxPlacesError(PydanticValueError):
-    code = 'decimal.max_places'
-    msg_template = 'ensure that there are no more than {decimal_places} decimal places'
-
-    def __init__(self, *, decimal_places: int) -> None:
-        super().__init__(decimal_places=decimal_places)
-
-
-class DecimalWholeDigitsError(PydanticValueError):
-    code = 'decimal.whole_digits'
-    msg_template = 'ensure that there are no more than {whole_digits} digits before the decimal point'
-
-    def __init__(self, *, whole_digits: int) -> None:
-        super().__init__(whole_digits=whole_digits)
-
-
-class DateTimeError(PydanticValueError):
-    msg_template = 'invalid datetime format'
-
-
-class DateError(PydanticValueError):
-    msg_template = 'invalid date format'
-
-
-class DateNotInThePastError(PydanticValueError):
-    code = 'date.not_in_the_past'
-    msg_template = 'date is not in the past'
-
-
-class DateNotInTheFutureError(PydanticValueError):
-    code = 'date.not_in_the_future'
-    msg_template = 'date is not in the future'
-
-
-class TimeError(PydanticValueError):
-    msg_template = 'invalid time format'
-
-
-class DurationError(PydanticValueError):
-    msg_template = 'invalid duration format'
-
-
-class HashableError(PydanticTypeError):
-    msg_template = 'value is not a valid hashable'
-
-
-class UUIDError(PydanticTypeError):
-    msg_template = 'value is not a valid uuid'
-
-
-class UUIDVersionError(PydanticValueError):
-    code = 'uuid.version'
-    msg_template = 'uuid version {required_version} expected'
-
-    def __init__(self, *, required_version: int) -> None:
-        super().__init__(required_version=required_version)
-
-
-class ArbitraryTypeError(PydanticTypeError):
-    code = 'arbitrary_type'
-    msg_template = 'instance of {expected_arbitrary_type} expected'
-
-    def __init__(self, *, expected_arbitrary_type: Type[Any]) -> None:
-        super().__init__(expected_arbitrary_type=display_as_type(expected_arbitrary_type))
-
-
-class ClassError(PydanticTypeError):
-    code = 'class'
-    msg_template = 'a class is expected'
-
-
-class SubclassError(PydanticTypeError):
-    code = 'subclass'
-    msg_template = 'subclass of {expected_class} expected'
-
-    def __init__(self, *, expected_class: Type[Any]) -> None:
-        super().__init__(expected_class=display_as_type(expected_class))
-
-
-class JsonError(PydanticValueError):
-    msg_template = 'Invalid JSON'
-
-
-class JsonTypeError(PydanticTypeError):
-    code = 'json'
-    msg_template = 'JSON object must be str, bytes or bytearray'
-
-
-class PatternError(PydanticValueError):
-    code = 'regex_pattern'
-    msg_template = 'Invalid regular expression'
-
-
-class DataclassTypeError(PydanticTypeError):
-    code = 'dataclass'
-    msg_template = 'instance of {class_name}, tuple or dict expected'
-
-
-class CallableError(PydanticTypeError):
-    msg_template = '{value} is not callable'
-
-
-class EnumError(PydanticTypeError):
-    code = 'enum_instance'
-    msg_template = '{value} is not a valid Enum instance'
-
-
-class IntEnumError(PydanticTypeError):
-    code = 'int_enum_instance'
-    msg_template = '{value} is not a valid IntEnum instance'
-
-
-class IPvAnyAddressError(PydanticValueError):
-    msg_template = 'value is not a valid IPv4 or IPv6 address'
-
-
-class IPvAnyInterfaceError(PydanticValueError):
-    msg_template = 'value is not a valid IPv4 or IPv6 interface'
-
-
-class IPvAnyNetworkError(PydanticValueError):
-    msg_template = 'value is not a valid IPv4 or IPv6 network'
-
-
-class IPv4AddressError(PydanticValueError):
-    msg_template = 'value is not a valid IPv4 address'
-
-
-class IPv6AddressError(PydanticValueError):
-    msg_template = 'value is not a valid IPv6 address'
-
-
-class IPv4NetworkError(PydanticValueError):
-    msg_template = 'value is not a valid IPv4 network'
-
-
-class IPv6NetworkError(PydanticValueError):
-    msg_template = 'value is not a valid IPv6 network'
-
-
-class IPv4InterfaceError(PydanticValueError):
-    msg_template = 'value is not a valid IPv4 interface'
-
-
-class IPv6InterfaceError(PydanticValueError):
-    msg_template = 'value is not a valid IPv6 interface'
-
-
-class ColorError(PydanticValueError):
-    msg_template = 'value is not a valid color: {reason}'
-
-
-class StrictBoolError(PydanticValueError):
-    msg_template = 'value is not a valid boolean'
-
-
-class NotDigitError(PydanticValueError):
-    code = 'payment_card_number.digits'
-    msg_template = 'card number is not all digits'
-
-
-class LuhnValidationError(PydanticValueError):
-    code = 'payment_card_number.luhn_check'
-    msg_template = 'card number is not luhn valid'
-
-
-class InvalidLengthForBrand(PydanticValueError):
-    code = 'payment_card_number.invalid_length_for_brand'
-    msg_template = 'Length for a {brand} card must be {required_length}'
-
-
-class InvalidByteSize(PydanticValueError):
-    msg_template = 'could not parse value and unit from byte string'
-
-
-class InvalidByteSizeUnit(PydanticValueError):
-    msg_template = 'could not interpret byte unit: {unit}'
-
-
-class MissingDiscriminator(PydanticValueError):
-    code = 'discriminated_union.missing_discriminator'
-    msg_template = 'Discriminator {discriminator_key!r} is missing in value'
-
-
-class InvalidDiscriminator(PydanticValueError):
-    code = 'discriminated_union.invalid_discriminator'
-    msg_template = (
-        'No match for discriminator {discriminator_key!r} and value {discriminator_value!r} '
-        '(allowed values: {allowed_values})'
-    )
-
-    def __init__(self, *, discriminator_key: str, discriminator_value: Any, allowed_values: Sequence[Any]) -> None:
-        super().__init__(
-            discriminator_key=discriminator_key,
-            discriminator_value=discriminator_value,
-            allowed_values=', '.join(map(repr, allowed_values)),
-        )
+__getattr__ = getattr_migration(__name__)
diff --git a/lib/pydantic/fields.py b/lib/pydantic/fields.py
index cecd3d20..b416bb7d 100644
--- a/lib/pydantic/fields.py
+++ b/lib/pydantic/fields.py
@@ -1,1209 +1,875 @@
-import copy
-import re
-from collections import Counter as CollectionCounter, defaultdict, deque
-from collections.abc import Callable, Hashable as CollectionsHashable, Iterable as CollectionsIterable
-from typing import (
-    TYPE_CHECKING,
-    Any,
-    Counter,
-    DefaultDict,
-    Deque,
-    Dict,
-    ForwardRef,
-    FrozenSet,
-    Generator,
-    Iterable,
-    Iterator,
-    List,
-    Mapping,
-    Optional,
-    Pattern,
-    Sequence,
-    Set,
-    Tuple,
-    Type,
-    TypeVar,
-    Union,
-)
+"""Defining fields on models."""
+from __future__ import annotations as _annotations
 
-from typing_extensions import Annotated, Final
+import dataclasses
+import inspect
+import typing
+from copy import copy
+from dataclasses import Field as DataclassField
+from functools import cached_property
+from typing import Any, ClassVar
+from warnings import warn
 
-from . import errors as errors_
-from .class_validators import Validator, make_generic_validator, prep_validators
-from .error_wrappers import ErrorWrapper
-from .errors import ConfigError, InvalidDiscriminator, MissingDiscriminator, NoneIsNotAllowedError
-from .types import Json, JsonWrapper
-from .typing import (
-    NoArgAnyCallable,
-    convert_generics,
-    display_as_type,
-    get_args,
-    get_origin,
-    is_finalvar,
-    is_literal_type,
-    is_new_type,
-    is_none_type,
-    is_typeddict,
-    is_typeddict_special,
-    is_union,
-    new_type_supertype,
-)
-from .utils import (
-    PyObjectStr,
-    Representation,
-    ValueItems,
-    get_discriminator_alias_and_values,
-    get_unique_discriminator_alias,
-    lenient_isinstance,
-    lenient_issubclass,
-    sequence_like,
-    smart_deepcopy,
-)
-from .validators import constant_validator, dict_validator, find_validators, validate_json
+import annotated_types
+import typing_extensions
+from pydantic_core import PydanticUndefined
+from typing_extensions import Literal, Unpack
 
-Required: Any = Ellipsis
+from . import types
+from ._internal import _decorators, _fields, _generics, _internal_dataclass, _repr, _typing_extra, _utils
+from .aliases import AliasChoices, AliasPath
+from .config import JsonDict
+from .errors import PydanticUserError
+from .warnings import PydanticDeprecatedSince20
 
-T = TypeVar('T')
+if typing.TYPE_CHECKING:
+    from ._internal._repr import ReprArgs
+else:
+    # See PyCharm issues https://youtrack.jetbrains.com/issue/PY-21915
+    # and https://youtrack.jetbrains.com/issue/PY-51428
+    DeprecationWarning = PydanticDeprecatedSince20
 
 
-class UndefinedType:
-    def __repr__(self) -> str:
-        return 'PydanticUndefined'
-
-    def __copy__(self: T) -> T:
-        return self
-
-    def __reduce__(self) -> str:
-        return 'Undefined'
-
-    def __deepcopy__(self: T, _: Any) -> T:
-        return self
+_Unset: Any = PydanticUndefined
 
 
-Undefined = UndefinedType()
+class _FromFieldInfoInputs(typing_extensions.TypedDict, total=False):
+    """This class exists solely to add type checking for the `**kwargs` in `FieldInfo.from_field`."""
 
-if TYPE_CHECKING:
-    from .class_validators import ValidatorsList
-    from .config import BaseConfig
-    from .error_wrappers import ErrorList
-    from .types import ModelOrDc
-    from .typing import AbstractSetIntStr, MappingIntStrAny, ReprArgs
-
-    ValidateReturn = Tuple[Optional[Any], Optional[ErrorList]]
-    LocStr = Union[Tuple[Union[int, str], ...], str]
-    BoolUndefined = Union[bool, UndefinedType]
+    annotation: type[Any] | None
+    default_factory: typing.Callable[[], Any] | None
+    alias: str | None
+    alias_priority: int | None
+    validation_alias: str | AliasPath | AliasChoices | None
+    serialization_alias: str | None
+    title: str | None
+    description: str | None
+    examples: list[Any] | None
+    exclude: bool | None
+    gt: float | None
+    ge: float | None
+    lt: float | None
+    le: float | None
+    multiple_of: float | None
+    strict: bool | None
+    min_length: int | None
+    max_length: int | None
+    pattern: str | None
+    allow_inf_nan: bool | None
+    max_digits: int | None
+    decimal_places: int | None
+    union_mode: Literal['smart', 'left_to_right'] | None
+    discriminator: str | types.Discriminator | None
+    json_schema_extra: JsonDict | typing.Callable[[JsonDict], None] | None
+    frozen: bool | None
+    validate_default: bool | None
+    repr: bool
+    init: bool | None
+    init_var: bool | None
+    kw_only: bool | None
 
 
-class FieldInfo(Representation):
-    """
-    Captures extra information about a field.
+class _FieldInfoInputs(_FromFieldInfoInputs, total=False):
+    """This class exists solely to add type checking for the `**kwargs` in `FieldInfo.__init__`."""
+
+    default: Any
+
+
+class FieldInfo(_repr.Representation):
+    """This class holds information about a field.
+
+    `FieldInfo` is used for any field definition regardless of whether the [`Field()`][pydantic.fields.Field]
+    function is explicitly used.
+
+    !!! warning
+        You generally shouldn't be creating `FieldInfo` directly, you'll only need to use it when accessing
+        [`BaseModel`][pydantic.main.BaseModel] `.model_fields` internals.
+
+    Attributes:
+        annotation: The type annotation of the field.
+        default: The default value of the field.
+        default_factory: The factory function used to construct the default for the field.
+        alias: The alias name of the field.
+        alias_priority: The priority of the field's alias.
+        validation_alias: The validation alias of the field.
+        serialization_alias: The serialization alias of the field.
+        title: The title of the field.
+        description: The description of the field.
+        examples: List of examples of the field.
+        exclude: Whether to exclude the field from the model serialization.
+        discriminator: Field name or Discriminator for discriminating the type in a tagged union.
+        json_schema_extra: A dict or callable to provide extra JSON schema properties.
+        frozen: Whether the field is frozen.
+        validate_default: Whether to validate the default value of the field.
+        repr: Whether to include the field in representation of the model.
+        init: Whether the field should be included in the constructor of the dataclass.
+        init_var: Whether the field should _only_ be included in the constructor of the dataclass, and not stored.
+        kw_only: Whether the field should be a keyword-only argument in the constructor of the dataclass.
+        metadata: List of metadata constraints.
     """
 
+    annotation: type[Any] | None
+    default: Any
+    default_factory: typing.Callable[[], Any] | None
+    alias: str | None
+    alias_priority: int | None
+    validation_alias: str | AliasPath | AliasChoices | None
+    serialization_alias: str | None
+    title: str | None
+    description: str | None
+    examples: list[Any] | None
+    exclude: bool | None
+    discriminator: str | types.Discriminator | None
+    json_schema_extra: JsonDict | typing.Callable[[JsonDict], None] | None
+    frozen: bool | None
+    validate_default: bool | None
+    repr: bool
+    init: bool | None
+    init_var: bool | None
+    kw_only: bool | None
+    metadata: list[Any]
+
     __slots__ = (
+        'annotation',
         'default',
         'default_factory',
         'alias',
         'alias_priority',
+        'validation_alias',
+        'serialization_alias',
         'title',
         'description',
+        'examples',
         'exclude',
-        'include',
-        'const',
-        'gt',
-        'ge',
-        'lt',
-        'le',
-        'multiple_of',
-        'allow_inf_nan',
-        'max_digits',
-        'decimal_places',
-        'min_items',
-        'max_items',
-        'unique_items',
-        'min_length',
-        'max_length',
-        'allow_mutation',
-        'repr',
-        'regex',
         'discriminator',
-        'extra',
+        'json_schema_extra',
+        'frozen',
+        'validate_default',
+        'repr',
+        'init',
+        'init_var',
+        'kw_only',
+        'metadata',
+        '_attributes_set',
     )
 
-    # field constraints with the default value, it's also used in update_from_config below
-    __field_constraints__ = {
-        'min_length': None,
-        'max_length': None,
-        'regex': None,
-        'gt': None,
-        'lt': None,
-        'ge': None,
-        'le': None,
-        'multiple_of': None,
+    # used to convert kwargs to metadata/constraints,
+    # None has a special meaning - these items are collected into a `PydanticGeneralMetadata`
+    metadata_lookup: ClassVar[dict[str, typing.Callable[[Any], Any] | None]] = {
+        'strict': types.Strict,
+        'gt': annotated_types.Gt,
+        'ge': annotated_types.Ge,
+        'lt': annotated_types.Lt,
+        'le': annotated_types.Le,
+        'multiple_of': annotated_types.MultipleOf,
+        'min_length': annotated_types.MinLen,
+        'max_length': annotated_types.MaxLen,
+        'pattern': None,
         'allow_inf_nan': None,
         'max_digits': None,
         'decimal_places': None,
-        'min_items': None,
-        'max_items': None,
-        'unique_items': None,
-        'allow_mutation': True,
+        'union_mode': None,
     }
 
-    def __init__(self, default: Any = Undefined, **kwargs: Any) -> None:
-        self.default = default
+    def __init__(self, **kwargs: Unpack[_FieldInfoInputs]) -> None:
+        """This class should generally not be initialized directly; instead, use the `pydantic.fields.Field` function
+        or one of the constructor classmethods.
+
+        See the signature of `pydantic.fields.Field` for more details about the expected arguments.
+        """
+        self._attributes_set = {k: v for k, v in kwargs.items() if v is not _Unset}
+        kwargs = {k: _DefaultValues.get(k) if v is _Unset else v for k, v in kwargs.items()}  # type: ignore
+        self.annotation, annotation_metadata = self._extract_metadata(kwargs.get('annotation'))
+
+        default = kwargs.pop('default', PydanticUndefined)
+        if default is Ellipsis:
+            self.default = PydanticUndefined
+        else:
+            self.default = default
+
         self.default_factory = kwargs.pop('default_factory', None)
-        self.alias = kwargs.pop('alias', None)
-        self.alias_priority = kwargs.pop('alias_priority', 2 if self.alias is not None else None)
+
+        if self.default is not PydanticUndefined and self.default_factory is not None:
+            raise TypeError('cannot specify both default and default_factory')
+
         self.title = kwargs.pop('title', None)
+        self.alias = kwargs.pop('alias', None)
+        self.validation_alias = kwargs.pop('validation_alias', None)
+        self.serialization_alias = kwargs.pop('serialization_alias', None)
+        alias_is_set = any(alias is not None for alias in (self.alias, self.validation_alias, self.serialization_alias))
+        self.alias_priority = kwargs.pop('alias_priority', None) or 2 if alias_is_set else None
         self.description = kwargs.pop('description', None)
+        self.examples = kwargs.pop('examples', None)
         self.exclude = kwargs.pop('exclude', None)
-        self.include = kwargs.pop('include', None)
-        self.const = kwargs.pop('const', None)
-        self.gt = kwargs.pop('gt', None)
-        self.ge = kwargs.pop('ge', None)
-        self.lt = kwargs.pop('lt', None)
-        self.le = kwargs.pop('le', None)
-        self.multiple_of = kwargs.pop('multiple_of', None)
-        self.allow_inf_nan = kwargs.pop('allow_inf_nan', None)
-        self.max_digits = kwargs.pop('max_digits', None)
-        self.decimal_places = kwargs.pop('decimal_places', None)
-        self.min_items = kwargs.pop('min_items', None)
-        self.max_items = kwargs.pop('max_items', None)
-        self.unique_items = kwargs.pop('unique_items', None)
-        self.min_length = kwargs.pop('min_length', None)
-        self.max_length = kwargs.pop('max_length', None)
-        self.allow_mutation = kwargs.pop('allow_mutation', True)
-        self.regex = kwargs.pop('regex', None)
         self.discriminator = kwargs.pop('discriminator', None)
         self.repr = kwargs.pop('repr', True)
-        self.extra = kwargs
+        self.json_schema_extra = kwargs.pop('json_schema_extra', None)
+        self.validate_default = kwargs.pop('validate_default', None)
+        self.frozen = kwargs.pop('frozen', None)
+        # currently only used on dataclasses
+        self.init = kwargs.pop('init', None)
+        self.init_var = kwargs.pop('init_var', None)
+        self.kw_only = kwargs.pop('kw_only', None)
 
-    def __repr_args__(self) -> 'ReprArgs':
+        self.metadata = self._collect_metadata(kwargs) + annotation_metadata  # type: ignore
 
-        field_defaults_to_hide: Dict[str, Any] = {
-            'repr': True,
-            **self.__field_constraints__,
-        }
+    @staticmethod
+    def from_field(default: Any = PydanticUndefined, **kwargs: Unpack[_FromFieldInfoInputs]) -> FieldInfo:
+        """Create a new `FieldInfo` object with the `Field` function.
 
-        attrs = ((s, getattr(self, s)) for s in self.__slots__)
-        return [(a, v) for a, v in attrs if v != field_defaults_to_hide.get(a, None)]
+        Args:
+            default: The default value for the field. Defaults to Undefined.
+            **kwargs: Additional arguments dictionary.
 
-    def get_constraints(self) -> Set[str]:
+        Raises:
+            TypeError: If 'annotation' is passed as a keyword argument.
+
+        Returns:
+            A new FieldInfo object with the given parameters.
+
+        Example:
+            This is how you can create a field with default value like this:
+
+            ```python
+            import pydantic
+
+            class MyModel(pydantic.BaseModel):
+                foo: int = pydantic.Field(4)
+            ```
         """
-        Gets the constraints set on the field by comparing the constraint value with its default value
+        if 'annotation' in kwargs:
+            raise TypeError('"annotation" is not permitted as a Field keyword argument')
+        return FieldInfo(default=default, **kwargs)
 
-        :return: the constraints set on field_info
-        """
-        return {attr for attr, default in self.__field_constraints__.items() if getattr(self, attr) != default}
+    @staticmethod
+    def from_annotation(annotation: type[Any]) -> FieldInfo:
+        """Creates a `FieldInfo` instance from a bare annotation.
 
-    def update_from_config(self, from_config: Dict[str, Any]) -> None:
+        This function is used internally to create a `FieldInfo` from a bare annotation like this:
+
+        ```python
+        import pydantic
+
+        class MyModel(pydantic.BaseModel):
+            foo: int  # <-- like this
+        ```
+
+        We also account for the case where the annotation can be an instance of `Annotated` and where
+        one of the (not first) arguments in `Annotated` is an instance of `FieldInfo`, e.g.:
+
+        ```python
+        import annotated_types
+        from typing_extensions import Annotated
+
+        import pydantic
+
+        class MyModel(pydantic.BaseModel):
+            foo: Annotated[int, annotated_types.Gt(42)]
+            bar: Annotated[int, pydantic.Field(gt=42)]
+        ```
+
+        Args:
+            annotation: An annotation object.
+
+        Returns:
+            An instance of the field metadata.
         """
-        Update this FieldInfo based on a dict from get_field_info, only fields which have not been set are dated.
+        final = False
+        if _typing_extra.is_finalvar(annotation):
+            final = True
+            if annotation is not typing_extensions.Final:
+                annotation = typing_extensions.get_args(annotation)[0]
+
+        if _typing_extra.is_annotated(annotation):
+            first_arg, *extra_args = typing_extensions.get_args(annotation)
+            if _typing_extra.is_finalvar(first_arg):
+                final = True
+            field_info_annotations = [a for a in extra_args if isinstance(a, FieldInfo)]
+            field_info = FieldInfo.merge_field_infos(*field_info_annotations, annotation=first_arg)
+            if field_info:
+                new_field_info = copy(field_info)
+                new_field_info.annotation = first_arg
+                new_field_info.frozen = final or field_info.frozen
+                metadata: list[Any] = []
+                for a in extra_args:
+                    if not isinstance(a, FieldInfo):
+                        metadata.append(a)
+                    else:
+                        metadata.extend(a.metadata)
+                new_field_info.metadata = metadata
+                return new_field_info
+
+        return FieldInfo(annotation=annotation, frozen=final or None)
+
+    @staticmethod
+    def from_annotated_attribute(annotation: type[Any], default: Any) -> FieldInfo:
+        """Create `FieldInfo` from an annotation with a default value.
+
+        This is used in cases like the following:
+
+        ```python
+        import annotated_types
+        from typing_extensions import Annotated
+
+        import pydantic
+
+        class MyModel(pydantic.BaseModel):
+            foo: int = 4  # <-- like this
+            bar: Annotated[int, annotated_types.Gt(4)] = 4  # <-- or this
+            spam: Annotated[int, pydantic.Field(gt=4)] = 4  # <-- or this
+        ```
+
+        Args:
+            annotation: The type annotation of the field.
+            default: The default value of the field.
+
+        Returns:
+            A field object with the passed values.
         """
-        for attr_name, value in from_config.items():
+        if annotation is default:
+            raise PydanticUserError(
+                'Error when building FieldInfo from annotated attribute. '
+                "Make sure you don't have any field name clashing with a type annotation ",
+                code='unevaluable-type-annotation',
+            )
+
+        final = False
+        if _typing_extra.is_finalvar(annotation):
+            final = True
+            if annotation is not typing_extensions.Final:
+                annotation = typing_extensions.get_args(annotation)[0]
+
+        if isinstance(default, FieldInfo):
+            default.annotation, annotation_metadata = FieldInfo._extract_metadata(annotation)
+            default.metadata += annotation_metadata
+            default = default.merge_field_infos(
+                *[x for x in annotation_metadata if isinstance(x, FieldInfo)], default, annotation=default.annotation
+            )
+            default.frozen = final or default.frozen
+            return default
+        elif isinstance(default, dataclasses.Field):
+            init_var = False
+            if annotation is dataclasses.InitVar:
+                init_var = True
+                annotation = Any
+            elif isinstance(annotation, dataclasses.InitVar):
+                init_var = True
+                annotation = annotation.type
+            pydantic_field = FieldInfo._from_dataclass_field(default)
+            pydantic_field.annotation, annotation_metadata = FieldInfo._extract_metadata(annotation)
+            pydantic_field.metadata += annotation_metadata
+            pydantic_field = pydantic_field.merge_field_infos(
+                *[x for x in annotation_metadata if isinstance(x, FieldInfo)],
+                pydantic_field,
+                annotation=pydantic_field.annotation,
+            )
+            pydantic_field.frozen = final or pydantic_field.frozen
+            pydantic_field.init_var = init_var
+            pydantic_field.init = getattr(default, 'init', None)
+            pydantic_field.kw_only = getattr(default, 'kw_only', None)
+            return pydantic_field
+        else:
+            if _typing_extra.is_annotated(annotation):
+                first_arg, *extra_args = typing_extensions.get_args(annotation)
+                field_infos = [a for a in extra_args if isinstance(a, FieldInfo)]
+                field_info = FieldInfo.merge_field_infos(*field_infos, annotation=first_arg, default=default)
+                metadata: list[Any] = []
+                for a in extra_args:
+                    if not isinstance(a, FieldInfo):
+                        metadata.append(a)
+                    else:
+                        metadata.extend(a.metadata)
+                field_info.metadata = metadata
+                return field_info
+
+            return FieldInfo(annotation=annotation, default=default, frozen=final or None)
+
+    @staticmethod
+    def merge_field_infos(*field_infos: FieldInfo, **overrides: Any) -> FieldInfo:
+        """Merge `FieldInfo` instances keeping only explicitly set attributes.
+
+        Later `FieldInfo` instances override earlier ones.
+
+        Returns:
+            FieldInfo: A merged FieldInfo instance.
+        """
+        flattened_field_infos: list[FieldInfo] = []
+        for field_info in field_infos:
+            flattened_field_infos.extend(x for x in field_info.metadata if isinstance(x, FieldInfo))
+            flattened_field_infos.append(field_info)
+        field_infos = tuple(flattened_field_infos)
+        if len(field_infos) == 1:
+            # No merging necessary, but we still need to make a copy and apply the overrides
+            field_info = copy(field_infos[0])
+            field_info._attributes_set.update(overrides)
+            for k, v in overrides.items():
+                setattr(field_info, k, v)
+            return field_info  # type: ignore
+
+        new_kwargs: dict[str, Any] = {}
+        metadata = {}
+        for field_info in field_infos:
+            new_kwargs.update(field_info._attributes_set)
+            for x in field_info.metadata:
+                if not isinstance(x, FieldInfo):
+                    metadata[type(x)] = x
+        new_kwargs.update(overrides)
+        field_info = FieldInfo(**new_kwargs)
+        field_info.metadata = list(metadata.values())
+        return field_info
+
+    @staticmethod
+    def _from_dataclass_field(dc_field: DataclassField[Any]) -> FieldInfo:
+        """Return a new `FieldInfo` instance from a `dataclasses.Field` instance.
+
+        Args:
+            dc_field: The `dataclasses.Field` instance to convert.
+
+        Returns:
+            The corresponding `FieldInfo` instance.
+
+        Raises:
+            TypeError: If any of the `FieldInfo` kwargs does not match the `dataclass.Field` kwargs.
+        """
+        default = dc_field.default
+        if default is dataclasses.MISSING:
+            default = PydanticUndefined
+
+        if dc_field.default_factory is dataclasses.MISSING:
+            default_factory: typing.Callable[[], Any] | None = None
+        else:
+            default_factory = dc_field.default_factory
+
+        # use the `Field` function so in correct kwargs raise the correct `TypeError`
+        dc_field_metadata = {k: v for k, v in dc_field.metadata.items() if k in _FIELD_ARG_NAMES}
+        return Field(default=default, default_factory=default_factory, repr=dc_field.repr, **dc_field_metadata)
+
+    @staticmethod
+    def _extract_metadata(annotation: type[Any] | None) -> tuple[type[Any] | None, list[Any]]:
+        """Tries to extract metadata/constraints from an annotation if it uses `Annotated`.
+
+        Args:
+            annotation: The type hint annotation for which metadata has to be extracted.
+
+        Returns:
+            A tuple containing the extracted metadata type and the list of extra arguments.
+        """
+        if annotation is not None:
+            if _typing_extra.is_annotated(annotation):
+                first_arg, *extra_args = typing_extensions.get_args(annotation)
+                return first_arg, list(extra_args)
+
+        return annotation, []
+
+    @staticmethod
+    def _collect_metadata(kwargs: dict[str, Any]) -> list[Any]:
+        """Collect annotations from kwargs.
+
+        Args:
+            kwargs: Keyword arguments passed to the function.
+
+        Returns:
+            A list of metadata objects - a combination of `annotated_types.BaseMetadata` and
+                `PydanticMetadata`.
+        """
+        metadata: list[Any] = []
+        general_metadata = {}
+        for key, value in list(kwargs.items()):
             try:
-                current_value = getattr(self, attr_name)
-            except AttributeError:
-                # attr_name is not an attribute of FieldInfo, it should therefore be added to extra
-                # (except if extra already has this value!)
-                self.extra.setdefault(attr_name, value)
+                marker = FieldInfo.metadata_lookup[key]
+            except KeyError:
+                continue
+
+            del kwargs[key]
+            if value is not None:
+                if marker is None:
+                    general_metadata[key] = value
+                else:
+                    metadata.append(marker(value))
+        if general_metadata:
+            metadata.append(_fields.pydantic_general_metadata(**general_metadata))
+        return metadata
+
+    def get_default(self, *, call_default_factory: bool = False) -> Any:
+        """Get the default value.
+
+        We expose an option for whether to call the default_factory (if present), as calling it may
+        result in side effects that we want to avoid. However, there are times when it really should
+        be called (namely, when instantiating a model via `model_construct`).
+
+        Args:
+            call_default_factory: Whether to call the default_factory or not. Defaults to `False`.
+
+        Returns:
+            The default value, calling the default factory if requested or `None` if not set.
+        """
+        if self.default_factory is None:
+            return _utils.smart_deepcopy(self.default)
+        elif call_default_factory:
+            return self.default_factory()
+        else:
+            return None
+
+    def is_required(self) -> bool:
+        """Check if the field is required (i.e., does not have a default value or factory).
+
+        Returns:
+            `True` if the field is required, `False` otherwise.
+        """
+        return self.default is PydanticUndefined and self.default_factory is None
+
+    def rebuild_annotation(self) -> Any:
+        """Attempts to rebuild the original annotation for use in function signatures.
+
+        If metadata is present, it adds it to the original annotation using
+        `Annotated`. Otherwise, it returns the original annotation as-is.
+
+        Note that because the metadata has been flattened, the original annotation
+        may not be reconstructed exactly as originally provided, e.g. if the original
+        type had unrecognized annotations, or was annotated with a call to `pydantic.Field`.
+
+        Returns:
+            The rebuilt annotation.
+        """
+        if not self.metadata:
+            return self.annotation
+        else:
+            # Annotated arguments must be a tuple
+            return typing_extensions.Annotated[(self.annotation, *self.metadata)]  # type: ignore
+
+    def apply_typevars_map(self, typevars_map: dict[Any, Any] | None, types_namespace: dict[str, Any] | None) -> None:
+        """Apply a `typevars_map` to the annotation.
+
+        This method is used when analyzing parametrized generic types to replace typevars with their concrete types.
+
+        This method applies the `typevars_map` to the annotation in place.
+
+        Args:
+            typevars_map: A dictionary mapping type variables to their concrete types.
+            types_namespace (dict | None): A dictionary containing related types to the annotated type.
+
+        See Also:
+            pydantic._internal._generics.replace_types is used for replacing the typevars with
+                their concrete types.
+        """
+        annotation = _typing_extra.eval_type_lenient(self.annotation, types_namespace)
+        self.annotation = _generics.replace_types(annotation, typevars_map)
+
+    def __repr_args__(self) -> ReprArgs:
+        yield 'annotation', _repr.PlainRepr(_repr.display_as_type(self.annotation))
+        yield 'required', self.is_required()
+
+        for s in self.__slots__:
+            if s == '_attributes_set':
+                continue
+            if s == 'annotation':
+                continue
+            elif s == 'metadata' and not self.metadata:
+                continue
+            elif s == 'repr' and self.repr is True:
+                continue
+            if s == 'frozen' and self.frozen is False:
+                continue
+            if s == 'validation_alias' and self.validation_alias == self.alias:
+                continue
+            if s == 'serialization_alias' and self.serialization_alias == self.alias:
+                continue
+            if s == 'default_factory' and self.default_factory is not None:
+                yield 'default_factory', _repr.PlainRepr(_repr.display_as_type(self.default_factory))
             else:
-                if current_value is self.__field_constraints__.get(attr_name, None):
-                    setattr(self, attr_name, value)
-                elif attr_name == 'exclude':
-                    self.exclude = ValueItems.merge(value, current_value)
-                elif attr_name == 'include':
-                    self.include = ValueItems.merge(value, current_value, intersect=True)
-
-    def _validate(self) -> None:
-        if self.default is not Undefined and self.default_factory is not None:
-            raise ValueError('cannot specify both default and default_factory')
+                value = getattr(self, s)
+                if value is not None and value is not PydanticUndefined:
+                    yield s, value
 
 
-def Field(
-    default: Any = Undefined,
+class _EmptyKwargs(typing_extensions.TypedDict):
+    """This class exists solely to ensure that type checking warns about passing `**extra` in `Field`."""
+
+
+_DefaultValues = dict(
+    default=...,
+    default_factory=None,
+    alias=None,
+    alias_priority=None,
+    validation_alias=None,
+    serialization_alias=None,
+    title=None,
+    description=None,
+    examples=None,
+    exclude=None,
+    discriminator=None,
+    json_schema_extra=None,
+    frozen=None,
+    validate_default=None,
+    repr=True,
+    init=None,
+    init_var=None,
+    kw_only=None,
+    pattern=None,
+    strict=None,
+    gt=None,
+    ge=None,
+    lt=None,
+    le=None,
+    multiple_of=None,
+    allow_inf_nan=None,
+    max_digits=None,
+    decimal_places=None,
+    min_length=None,
+    max_length=None,
+)
+
+
+def Field(  # noqa: C901
+    default: Any = PydanticUndefined,
     *,
-    default_factory: Optional[NoArgAnyCallable] = None,
-    alias: str = None,
-    title: str = None,
-    description: str = None,
-    exclude: Union['AbstractSetIntStr', 'MappingIntStrAny', Any] = None,
-    include: Union['AbstractSetIntStr', 'MappingIntStrAny', Any] = None,
-    const: bool = None,
-    gt: float = None,
-    ge: float = None,
-    lt: float = None,
-    le: float = None,
-    multiple_of: float = None,
-    allow_inf_nan: bool = None,
-    max_digits: int = None,
-    decimal_places: int = None,
-    min_items: int = None,
-    max_items: int = None,
-    unique_items: bool = None,
-    min_length: int = None,
-    max_length: int = None,
-    allow_mutation: bool = True,
-    regex: str = None,
-    discriminator: str = None,
-    repr: bool = True,
-    **extra: Any,
+    default_factory: typing.Callable[[], Any] | None = _Unset,
+    alias: str | None = _Unset,
+    alias_priority: int | None = _Unset,
+    validation_alias: str | AliasPath | AliasChoices | None = _Unset,
+    serialization_alias: str | None = _Unset,
+    title: str | None = _Unset,
+    description: str | None = _Unset,
+    examples: list[Any] | None = _Unset,
+    exclude: bool | None = _Unset,
+    discriminator: str | types.Discriminator | None = _Unset,
+    json_schema_extra: JsonDict | typing.Callable[[JsonDict], None] | None = _Unset,
+    frozen: bool | None = _Unset,
+    validate_default: bool | None = _Unset,
+    repr: bool = _Unset,
+    init: bool | None = _Unset,
+    init_var: bool | None = _Unset,
+    kw_only: bool | None = _Unset,
+    pattern: str | None = _Unset,
+    strict: bool | None = _Unset,
+    gt: float | None = _Unset,
+    ge: float | None = _Unset,
+    lt: float | None = _Unset,
+    le: float | None = _Unset,
+    multiple_of: float | None = _Unset,
+    allow_inf_nan: bool | None = _Unset,
+    max_digits: int | None = _Unset,
+    decimal_places: int | None = _Unset,
+    min_length: int | None = _Unset,
+    max_length: int | None = _Unset,
+    union_mode: Literal['smart', 'left_to_right'] = _Unset,
+    **extra: Unpack[_EmptyKwargs],
 ) -> Any:
-    """
-    Used to provide extra information about a field, either for the model schema or complex validation. Some arguments
-    apply only to number fields (``int``, ``float``, ``Decimal``) and some apply only to ``str``.
+    """Usage docs: https://docs.pydantic.dev/2.6/concepts/fields
 
-    :param default: since this is replacing the field’s default, its first argument is used
-      to set the default, use ellipsis (``...``) to indicate the field is required
-    :param default_factory: callable that will be called when a default value is needed for this field
-      If both `default` and `default_factory` are set, an error is raised.
-    :param alias: the public name of the field
-    :param title: can be any string, used in the schema
-    :param description: can be any string, used in the schema
-    :param exclude: exclude this field while dumping.
-      Takes same values as the ``include`` and ``exclude`` arguments on the ``.dict`` method.
-    :param include: include this field while dumping.
-      Takes same values as the ``include`` and ``exclude`` arguments on the ``.dict`` method.
-    :param const: this field is required and *must* take it's default value
-    :param gt: only applies to numbers, requires the field to be "greater than". The schema
-      will have an ``exclusiveMinimum`` validation keyword
-    :param ge: only applies to numbers, requires the field to be "greater than or equal to". The
-      schema will have a ``minimum`` validation keyword
-    :param lt: only applies to numbers, requires the field to be "less than". The schema
-      will have an ``exclusiveMaximum`` validation keyword
-    :param le: only applies to numbers, requires the field to be "less than or equal to". The
-      schema will have a ``maximum`` validation keyword
-    :param multiple_of: only applies to numbers, requires the field to be "a multiple of". The
-      schema will have a ``multipleOf`` validation keyword
-    :param allow_inf_nan: only applies to numbers, allows the field to be NaN or infinity (+inf or -inf),
-        which is a valid Python float. Default True, set to False for compatibility with JSON.
-    :param max_digits: only applies to Decimals, requires the field to have a maximum number
-      of digits within the decimal. It does not include a zero before the decimal point or trailing decimal zeroes.
-    :param decimal_places: only applies to Decimals, requires the field to have at most a number of decimal places
-      allowed. It does not include trailing decimal zeroes.
-    :param min_items: only applies to lists, requires the field to have a minimum number of
-      elements. The schema will have a ``minItems`` validation keyword
-    :param max_items: only applies to lists, requires the field to have a maximum number of
-      elements. The schema will have a ``maxItems`` validation keyword
-    :param unique_items: only applies to lists, requires the field not to have duplicated
-      elements. The schema will have a ``uniqueItems`` validation keyword
-    :param min_length: only applies to strings, requires the field to have a minimum length. The
-      schema will have a ``maximum`` validation keyword
-    :param max_length: only applies to strings, requires the field to have a maximum length. The
-      schema will have a ``maxLength`` validation keyword
-    :param allow_mutation: a boolean which defaults to True. When False, the field raises a TypeError if the field is
-      assigned on an instance.  The BaseModel Config must set validate_assignment to True
-    :param regex: only applies to strings, requires the field match against a regular expression
-      pattern string. The schema will have a ``pattern`` validation keyword
-    :param discriminator: only useful with a (discriminated a.k.a. tagged) `Union` of sub models with a common field.
-      The `discriminator` is the name of this common field to shorten validation and improve generated schema
-    :param repr: show this field in the representation
-    :param **extra: any additional keyword arguments will be added as is to the schema
+    Create a field for objects that can be configured.
+
+    Used to provide extra information about a field, either for the model schema or complex validation. Some arguments
+    apply only to number fields (`int`, `float`, `Decimal`) and some apply only to `str`.
+
+    Note:
+        - Any `_Unset` objects will be replaced by the corresponding value defined in the `_DefaultValues` dictionary. If a key for the `_Unset` object is not found in the `_DefaultValues` dictionary, it will default to `None`
+
+    Args:
+        default: Default value if the field is not set.
+        default_factory: A callable to generate the default value, such as :func:`~datetime.utcnow`.
+        alias: The name to use for the attribute when validating or serializing by alias.
+            This is often used for things like converting between snake and camel case.
+        alias_priority: Priority of the alias. This affects whether an alias generator is used.
+        validation_alias: Like `alias`, but only affects validation, not serialization.
+        serialization_alias: Like `alias`, but only affects serialization, not validation.
+        title: Human-readable title.
+        description: Human-readable description.
+        examples: Example values for this field.
+        exclude: Whether to exclude the field from the model serialization.
+        discriminator: Field name or Discriminator for discriminating the type in a tagged union.
+        json_schema_extra: A dict or callable to provide extra JSON schema properties.
+        frozen: Whether the field is frozen. If true, attempts to change the value on an instance will raise an error.
+        validate_default: If `True`, apply validation to the default value every time you create an instance.
+            Otherwise, for performance reasons, the default value of the field is trusted and not validated.
+        repr: A boolean indicating whether to include the field in the `__repr__` output.
+        init: Whether the field should be included in the constructor of the dataclass.
+            (Only applies to dataclasses.)
+        init_var: Whether the field should _only_ be included in the constructor of the dataclass.
+            (Only applies to dataclasses.)
+        kw_only: Whether the field should be a keyword-only argument in the constructor of the dataclass.
+            (Only applies to dataclasses.)
+        strict: If `True`, strict validation is applied to the field.
+            See [Strict Mode](../concepts/strict_mode.md) for details.
+        gt: Greater than. If set, value must be greater than this. Only applicable to numbers.
+        ge: Greater than or equal. If set, value must be greater than or equal to this. Only applicable to numbers.
+        lt: Less than. If set, value must be less than this. Only applicable to numbers.
+        le: Less than or equal. If set, value must be less than or equal to this. Only applicable to numbers.
+        multiple_of: Value must be a multiple of this. Only applicable to numbers.
+        min_length: Minimum length for strings.
+        max_length: Maximum length for strings.
+        pattern: Pattern for strings (a regular expression).
+        allow_inf_nan: Allow `inf`, `-inf`, `nan`. Only applicable to numbers.
+        max_digits: Maximum number of allow digits for strings.
+        decimal_places: Maximum number of decimal places allowed for numbers.
+        union_mode: The strategy to apply when validating a union. Can be `smart` (the default), or `left_to_right`.
+            See [Union Mode](standard_library_types.md#union-mode) for details.
+        extra: (Deprecated) Extra fields that will be included in the JSON schema.
+
+            !!! warning Deprecated
+                The `extra` kwargs is deprecated. Use `json_schema_extra` instead.
+
+    Returns:
+        A new [`FieldInfo`][pydantic.fields.FieldInfo]. The return annotation is `Any` so `Field` can be used on
+            type-annotated fields without causing a type error.
     """
-    field_info = FieldInfo(
+    # Check deprecated and removed params from V1. This logic should eventually be removed.
+    const = extra.pop('const', None)  # type: ignore
+    if const is not None:
+        raise PydanticUserError('`const` is removed, use `Literal` instead', code='removed-kwargs')
+
+    min_items = extra.pop('min_items', None)  # type: ignore
+    if min_items is not None:
+        warn('`min_items` is deprecated and will be removed, use `min_length` instead', DeprecationWarning)
+        if min_length in (None, _Unset):
+            min_length = min_items  # type: ignore
+
+    max_items = extra.pop('max_items', None)  # type: ignore
+    if max_items is not None:
+        warn('`max_items` is deprecated and will be removed, use `max_length` instead', DeprecationWarning)
+        if max_length in (None, _Unset):
+            max_length = max_items  # type: ignore
+
+    unique_items = extra.pop('unique_items', None)  # type: ignore
+    if unique_items is not None:
+        raise PydanticUserError(
+            (
+                '`unique_items` is removed, use `Set` instead'
+                '(this feature is discussed in https://github.com/pydantic/pydantic-core/issues/296)'
+            ),
+            code='removed-kwargs',
+        )
+
+    allow_mutation = extra.pop('allow_mutation', None)  # type: ignore
+    if allow_mutation is not None:
+        warn('`allow_mutation` is deprecated and will be removed. use `frozen` instead', DeprecationWarning)
+        if allow_mutation is False:
+            frozen = True
+
+    regex = extra.pop('regex', None)  # type: ignore
+    if regex is not None:
+        raise PydanticUserError('`regex` is removed. use `pattern` instead', code='removed-kwargs')
+
+    if extra:
+        warn(
+            'Using extra keyword arguments on `Field` is deprecated and will be removed.'
+            ' Use `json_schema_extra` instead.'
+            f' (Extra keys: {", ".join(k.__repr__() for k in extra.keys())})',
+            DeprecationWarning,
+        )
+        if not json_schema_extra or json_schema_extra is _Unset:
+            json_schema_extra = extra  # type: ignore
+
+    if (
+        validation_alias
+        and validation_alias is not _Unset
+        and not isinstance(validation_alias, (str, AliasChoices, AliasPath))
+    ):
+        raise TypeError('Invalid `validation_alias` type. it should be `str`, `AliasChoices`, or `AliasPath`')
+
+    if serialization_alias in (_Unset, None) and isinstance(alias, str):
+        serialization_alias = alias
+
+    if validation_alias in (_Unset, None):
+        validation_alias = alias
+
+    include = extra.pop('include', None)  # type: ignore
+    if include is not None:
+        warn('`include` is deprecated and does nothing. It will be removed, use `exclude` instead', DeprecationWarning)
+
+    return FieldInfo.from_field(
         default,
         default_factory=default_factory,
         alias=alias,
+        alias_priority=alias_priority,
+        validation_alias=validation_alias,
+        serialization_alias=serialization_alias,
         title=title,
         description=description,
+        examples=examples,
         exclude=exclude,
-        include=include,
-        const=const,
+        discriminator=discriminator,
+        json_schema_extra=json_schema_extra,
+        frozen=frozen,
+        pattern=pattern,
+        validate_default=validate_default,
+        repr=repr,
+        init=init,
+        init_var=init_var,
+        kw_only=kw_only,
+        strict=strict,
         gt=gt,
         ge=ge,
         lt=lt,
         le=le,
         multiple_of=multiple_of,
+        min_length=min_length,
+        max_length=max_length,
         allow_inf_nan=allow_inf_nan,
         max_digits=max_digits,
         decimal_places=decimal_places,
-        min_items=min_items,
-        max_items=max_items,
-        unique_items=unique_items,
-        min_length=min_length,
-        max_length=max_length,
-        allow_mutation=allow_mutation,
-        regex=regex,
-        discriminator=discriminator,
-        repr=repr,
-        **extra,
+        union_mode=union_mode,
     )
-    field_info._validate()
-    return field_info
 
 
-# used to be an enum but changed to int's for small performance improvement as less access overhead
-SHAPE_SINGLETON = 1
-SHAPE_LIST = 2
-SHAPE_SET = 3
-SHAPE_MAPPING = 4
-SHAPE_TUPLE = 5
-SHAPE_TUPLE_ELLIPSIS = 6
-SHAPE_SEQUENCE = 7
-SHAPE_FROZENSET = 8
-SHAPE_ITERABLE = 9
-SHAPE_GENERIC = 10
-SHAPE_DEQUE = 11
-SHAPE_DICT = 12
-SHAPE_DEFAULTDICT = 13
-SHAPE_COUNTER = 14
-SHAPE_NAME_LOOKUP = {
-    SHAPE_LIST: 'List[{}]',
-    SHAPE_SET: 'Set[{}]',
-    SHAPE_TUPLE_ELLIPSIS: 'Tuple[{}, ...]',
-    SHAPE_SEQUENCE: 'Sequence[{}]',
-    SHAPE_FROZENSET: 'FrozenSet[{}]',
-    SHAPE_ITERABLE: 'Iterable[{}]',
-    SHAPE_DEQUE: 'Deque[{}]',
-    SHAPE_DICT: 'Dict[{}]',
-    SHAPE_DEFAULTDICT: 'DefaultDict[{}]',
-    SHAPE_COUNTER: 'Counter[{}]',
-}
-
-MAPPING_LIKE_SHAPES: Set[int] = {SHAPE_DEFAULTDICT, SHAPE_DICT, SHAPE_MAPPING, SHAPE_COUNTER}
+_FIELD_ARG_NAMES = set(inspect.signature(Field).parameters)
+_FIELD_ARG_NAMES.remove('extra')  # do not include the varkwargs parameter
 
 
-class ModelField(Representation):
-    __slots__ = (
-        'type_',
-        'outer_type_',
-        'annotation',
-        'sub_fields',
-        'sub_fields_mapping',
-        'key_field',
-        'validators',
-        'pre_validators',
-        'post_validators',
-        'default',
-        'default_factory',
-        'required',
-        'final',
-        'model_config',
-        'name',
-        'alias',
-        'has_alias',
-        'field_info',
-        'discriminator_key',
-        'discriminator_alias',
-        'validate_always',
-        'allow_none',
-        'shape',
-        'class_validators',
-        'parse_json',
-    )
+class ModelPrivateAttr(_repr.Representation):
+    """A descriptor for private attributes in class models.
+
+    !!! warning
+        You generally shouldn't be creating `ModelPrivateAttr` instances directly, instead use
+        `pydantic.fields.PrivateAttr`. (This is similar to `FieldInfo` vs. `Field`.)
+
+    Attributes:
+        default: The default value of the attribute if not provided.
+        default_factory: A callable function that generates the default value of the
+            attribute if not provided.
+    """
+
+    __slots__ = 'default', 'default_factory'
 
     def __init__(
-        self,
-        *,
-        name: str,
-        type_: Type[Any],
-        class_validators: Optional[Dict[str, Validator]],
-        model_config: Type['BaseConfig'],
-        default: Any = None,
-        default_factory: Optional[NoArgAnyCallable] = None,
-        required: 'BoolUndefined' = Undefined,
-        final: bool = False,
-        alias: str = None,
-        field_info: Optional[FieldInfo] = None,
+        self, default: Any = PydanticUndefined, *, default_factory: typing.Callable[[], Any] | None = None
     ) -> None:
-
-        self.name: str = name
-        self.has_alias: bool = alias is not None
-        self.alias: str = alias if alias is not None else name
-        self.annotation = type_
-        self.type_: Any = convert_generics(type_)
-        self.outer_type_: Any = type_
-        self.class_validators = class_validators or {}
-        self.default: Any = default
-        self.default_factory: Optional[NoArgAnyCallable] = default_factory
-        self.required: 'BoolUndefined' = required
-        self.final: bool = final
-        self.model_config = model_config
-        self.field_info: FieldInfo = field_info or FieldInfo(default)
-        self.discriminator_key: Optional[str] = self.field_info.discriminator
-        self.discriminator_alias: Optional[str] = self.discriminator_key
-
-        self.allow_none: bool = False
-        self.validate_always: bool = False
-        self.sub_fields: Optional[List[ModelField]] = None
-        self.sub_fields_mapping: Optional[Dict[str, 'ModelField']] = None  # used for discriminated union
-        self.key_field: Optional[ModelField] = None
-        self.validators: 'ValidatorsList' = []
-        self.pre_validators: Optional['ValidatorsList'] = None
-        self.post_validators: Optional['ValidatorsList'] = None
-        self.parse_json: bool = False
-        self.shape: int = SHAPE_SINGLETON
-        self.model_config.prepare_field(self)
-        self.prepare()
-
-    def get_default(self) -> Any:
-        return smart_deepcopy(self.default) if self.default_factory is None else self.default_factory()
-
-    @staticmethod
-    def _get_field_info(
-        field_name: str, annotation: Any, value: Any, config: Type['BaseConfig']
-    ) -> Tuple[FieldInfo, Any]:
-        """
-        Get a FieldInfo from a root typing.Annotated annotation, value, or config default.
-
-        The FieldInfo may be set in typing.Annotated or the value, but not both. If neither contain
-        a FieldInfo, a new one will be created using the config.
-
-        :param field_name: name of the field for use in error messages
-        :param annotation: a type hint such as `str` or `Annotated[str, Field(..., min_length=5)]`
-        :param value: the field's assigned value
-        :param config: the model's config object
-        :return: the FieldInfo contained in the `annotation`, the value, or a new one from the config.
-        """
-        field_info_from_config = config.get_field_info(field_name)
-
-        field_info = None
-        if get_origin(annotation) is Annotated:
-            field_infos = [arg for arg in get_args(annotation)[1:] if isinstance(arg, FieldInfo)]
-            if len(field_infos) > 1:
-                raise ValueError(f'cannot specify multiple `Annotated` `Field`s for {field_name!r}')
-            field_info = next(iter(field_infos), None)
-            if field_info is not None:
-                field_info = copy.copy(field_info)
-                field_info.update_from_config(field_info_from_config)
-                if field_info.default not in (Undefined, Required):
-                    raise ValueError(f'`Field` default cannot be set in `Annotated` for {field_name!r}')
-                if value is not Undefined and value is not Required:
-                    # check also `Required` because of `validate_arguments` that sets `...` as default value
-                    field_info.default = value
-
-        if isinstance(value, FieldInfo):
-            if field_info is not None:
-                raise ValueError(f'cannot specify `Annotated` and value `Field`s together for {field_name!r}')
-            field_info = value
-            field_info.update_from_config(field_info_from_config)
-        elif field_info is None:
-            field_info = FieldInfo(value, **field_info_from_config)
-        value = None if field_info.default_factory is not None else field_info.default
-        field_info._validate()
-        return field_info, value
-
-    @classmethod
-    def infer(
-        cls,
-        *,
-        name: str,
-        value: Any,
-        annotation: Any,
-        class_validators: Optional[Dict[str, Validator]],
-        config: Type['BaseConfig'],
-    ) -> 'ModelField':
-        from .schema import get_annotation_from_field_info
-
-        field_info, value = cls._get_field_info(name, annotation, value, config)
-        required: 'BoolUndefined' = Undefined
-        if value is Required:
-            required = True
-            value = None
-        elif value is not Undefined:
-            required = False
-        annotation = get_annotation_from_field_info(annotation, field_info, name, config.validate_assignment)
-
-        return cls(
-            name=name,
-            type_=annotation,
-            alias=field_info.alias,
-            class_validators=class_validators,
-            default=value,
-            default_factory=field_info.default_factory,
-            required=required,
-            model_config=config,
-            field_info=field_info,
-        )
-
-    def set_config(self, config: Type['BaseConfig']) -> None:
-        self.model_config = config
-        info_from_config = config.get_field_info(self.name)
-        config.prepare_field(self)
-        new_alias = info_from_config.get('alias')
-        new_alias_priority = info_from_config.get('alias_priority') or 0
-        if new_alias and new_alias_priority >= (self.field_info.alias_priority or 0):
-            self.field_info.alias = new_alias
-            self.field_info.alias_priority = new_alias_priority
-            self.alias = new_alias
-        new_exclude = info_from_config.get('exclude')
-        if new_exclude is not None:
-            self.field_info.exclude = ValueItems.merge(self.field_info.exclude, new_exclude)
-        new_include = info_from_config.get('include')
-        if new_include is not None:
-            self.field_info.include = ValueItems.merge(self.field_info.include, new_include, intersect=True)
-
-    @property
-    def alt_alias(self) -> bool:
-        return self.name != self.alias
-
-    def prepare(self) -> None:
-        """
-        Prepare the field but inspecting self.default, self.type_ etc.
-
-        Note: this method is **not** idempotent (because _type_analysis is not idempotent),
-        e.g. calling it it multiple times may modify the field and configure it incorrectly.
-        """
-        self._set_default_and_type()
-        if self.type_.__class__ is ForwardRef or self.type_.__class__ is DeferredType:
-            # self.type_ is currently a ForwardRef and there's nothing we can do now,
-            # user will need to call model.update_forward_refs()
-            return
-
-        self._type_analysis()
-        if self.required is Undefined:
-            self.required = True
-        if self.default is Undefined and self.default_factory is None:
-            self.default = None
-        self.populate_validators()
-
-    def _set_default_and_type(self) -> None:
-        """
-        Set the default value, infer the type if needed and check if `None` value is valid.
-        """
-        if self.default_factory is not None:
-            if self.type_ is Undefined:
-                raise errors_.ConfigError(
-                    f'you need to set the type of field {self.name!r} when using `default_factory`'
-                )
-            return
-
-        default_value = self.get_default()
-
-        if default_value is not None and self.type_ is Undefined:
-            self.type_ = default_value.__class__
-            self.outer_type_ = self.type_
-            self.annotation = self.type_
-
-        if self.type_ is Undefined:
-            raise errors_.ConfigError(f'unable to infer type for attribute "{self.name}"')
-
-        if self.required is False and default_value is None:
-            self.allow_none = True
-
-    def _type_analysis(self) -> None:  # noqa: C901 (ignore complexity)
-        # typing interface is horrible, we have to do some ugly checks
-        if lenient_issubclass(self.type_, JsonWrapper):
-            self.type_ = self.type_.inner_type
-            self.parse_json = True
-        elif lenient_issubclass(self.type_, Json):
-            self.type_ = Any
-            self.parse_json = True
-        elif isinstance(self.type_, TypeVar):
-            if self.type_.__bound__:
-                self.type_ = self.type_.__bound__
-            elif self.type_.__constraints__:
-                self.type_ = Union[self.type_.__constraints__]
-            else:
-                self.type_ = Any
-        elif is_new_type(self.type_):
-            self.type_ = new_type_supertype(self.type_)
-
-        if self.type_ is Any or self.type_ is object:
-            if self.required is Undefined:
-                self.required = False
-            self.allow_none = True
-            return
-        elif self.type_ is Pattern or self.type_ is re.Pattern:
-            # python 3.7 only, Pattern is a typing object but without sub fields
-            return
-        elif is_literal_type(self.type_):
-            return
-        elif is_typeddict(self.type_):
-            return
-
-        if is_finalvar(self.type_):
-            self.final = True
-
-            if self.type_ is Final:
-                self.type_ = Any
-            else:
-                self.type_ = get_args(self.type_)[0]
-
-            self._type_analysis()
-            return
-
-        origin = get_origin(self.type_)
-
-        if origin is Annotated or is_typeddict_special(origin):
-            self.type_ = get_args(self.type_)[0]
-            self._type_analysis()
-            return
-
-        if self.discriminator_key is not None and not is_union(origin):
-            raise TypeError('`discriminator` can only be used with `Union` type with more than one variant')
-
-        # add extra check for `collections.abc.Hashable` for python 3.10+ where origin is not `None`
-        if origin is None or origin is CollectionsHashable:
-            # field is not "typing" object eg. Union, Dict, List etc.
-            # allow None for virtual superclasses of NoneType, e.g. Hashable
-            if isinstance(self.type_, type) and isinstance(None, self.type_):
-                self.allow_none = True
-            return
-        elif origin is Callable:
-            return
-        elif is_union(origin):
-            types_ = []
-            for type_ in get_args(self.type_):
-                if is_none_type(type_) or type_ is Any or type_ is object:
-                    if self.required is Undefined:
-                        self.required = False
-                    self.allow_none = True
-                if is_none_type(type_):
-                    continue
-                types_.append(type_)
-
-            if len(types_) == 1:
-                # Optional[]
-                self.type_ = types_[0]
-                # this is the one case where the "outer type" isn't just the original type
-                self.outer_type_ = self.type_
-                # re-run to correctly interpret the new self.type_
-                self._type_analysis()
-            else:
-                self.sub_fields = [self._create_sub_type(t, f'{self.name}_{display_as_type(t)}') for t in types_]
-
-                if self.discriminator_key is not None:
-                    self.prepare_discriminated_union_sub_fields()
-            return
-        elif issubclass(origin, Tuple):  # type: ignore
-            # origin == Tuple without item type
-            args = get_args(self.type_)
-            if not args:  # plain tuple
-                self.type_ = Any
-                self.shape = SHAPE_TUPLE_ELLIPSIS
-            elif len(args) == 2 and args[1] is Ellipsis:  # e.g. Tuple[int, ...]
-                self.type_ = args[0]
-                self.shape = SHAPE_TUPLE_ELLIPSIS
-                self.sub_fields = [self._create_sub_type(args[0], f'{self.name}_0')]
-            elif args == ((),):  # Tuple[()] means empty tuple
-                self.shape = SHAPE_TUPLE
-                self.type_ = Any
-                self.sub_fields = []
-            else:
-                self.shape = SHAPE_TUPLE
-                self.sub_fields = [self._create_sub_type(t, f'{self.name}_{i}') for i, t in enumerate(args)]
-            return
-        elif issubclass(origin, List):
-            # Create self validators
-            get_validators = getattr(self.type_, '__get_validators__', None)
-            if get_validators:
-                self.class_validators.update(
-                    {f'list_{i}': Validator(validator, pre=True) for i, validator in enumerate(get_validators())}
-                )
-
-            self.type_ = get_args(self.type_)[0]
-            self.shape = SHAPE_LIST
-        elif issubclass(origin, Set):
-            # Create self validators
-            get_validators = getattr(self.type_, '__get_validators__', None)
-            if get_validators:
-                self.class_validators.update(
-                    {f'set_{i}': Validator(validator, pre=True) for i, validator in enumerate(get_validators())}
-                )
-
-            self.type_ = get_args(self.type_)[0]
-            self.shape = SHAPE_SET
-        elif issubclass(origin, FrozenSet):
-            # Create self validators
-            get_validators = getattr(self.type_, '__get_validators__', None)
-            if get_validators:
-                self.class_validators.update(
-                    {f'frozenset_{i}': Validator(validator, pre=True) for i, validator in enumerate(get_validators())}
-                )
-
-            self.type_ = get_args(self.type_)[0]
-            self.shape = SHAPE_FROZENSET
-        elif issubclass(origin, Deque):
-            self.type_ = get_args(self.type_)[0]
-            self.shape = SHAPE_DEQUE
-        elif issubclass(origin, Sequence):
-            self.type_ = get_args(self.type_)[0]
-            self.shape = SHAPE_SEQUENCE
-        # priority to most common mapping: dict
-        elif origin is dict or origin is Dict:
-            self.key_field = self._create_sub_type(get_args(self.type_)[0], 'key_' + self.name, for_keys=True)
-            self.type_ = get_args(self.type_)[1]
-            self.shape = SHAPE_DICT
-        elif issubclass(origin, DefaultDict):
-            self.key_field = self._create_sub_type(get_args(self.type_)[0], 'key_' + self.name, for_keys=True)
-            self.type_ = get_args(self.type_)[1]
-            self.shape = SHAPE_DEFAULTDICT
-        elif issubclass(origin, Counter):
-            self.key_field = self._create_sub_type(get_args(self.type_)[0], 'key_' + self.name, for_keys=True)
-            self.type_ = int
-            self.shape = SHAPE_COUNTER
-        elif issubclass(origin, Mapping):
-            self.key_field = self._create_sub_type(get_args(self.type_)[0], 'key_' + self.name, for_keys=True)
-            self.type_ = get_args(self.type_)[1]
-            self.shape = SHAPE_MAPPING
-        # Equality check as almost everything inherits form Iterable, including str
-        # check for Iterable and CollectionsIterable, as it could receive one even when declared with the other
-        elif origin in {Iterable, CollectionsIterable}:
-            self.type_ = get_args(self.type_)[0]
-            self.shape = SHAPE_ITERABLE
-            self.sub_fields = [self._create_sub_type(self.type_, f'{self.name}_type')]
-        elif issubclass(origin, Type):  # type: ignore
-            return
-        elif hasattr(origin, '__get_validators__') or self.model_config.arbitrary_types_allowed:
-            # Is a Pydantic-compatible generic that handles itself
-            # or we have arbitrary_types_allowed = True
-            self.shape = SHAPE_GENERIC
-            self.sub_fields = [self._create_sub_type(t, f'{self.name}_{i}') for i, t in enumerate(get_args(self.type_))]
-            self.type_ = origin
-            return
-        else:
-            raise TypeError(f'Fields of type "{origin}" are not supported.')
-
-        # type_ has been refined eg. as the type of a List and sub_fields needs to be populated
-        self.sub_fields = [self._create_sub_type(self.type_, '_' + self.name)]
-
-    def prepare_discriminated_union_sub_fields(self) -> None:
-        """
-        Prepare the mapping <discriminator key> -> <ModelField> and update `sub_fields`
-        Note that this process can be aborted if a `ForwardRef` is encountered
-        """
-        assert self.discriminator_key is not None
-
-        if self.type_.__class__ is DeferredType:
-            return
-
-        assert self.sub_fields is not None
-        sub_fields_mapping: Dict[str, 'ModelField'] = {}
-        all_aliases: Set[str] = set()
-
-        for sub_field in self.sub_fields:
-            t = sub_field.type_
-            if t.__class__ is ForwardRef:
-                # Stopping everything...will need to call `update_forward_refs`
-                return
-
-            alias, discriminator_values = get_discriminator_alias_and_values(t, self.discriminator_key)
-            all_aliases.add(alias)
-            for discriminator_value in discriminator_values:
-                sub_fields_mapping[discriminator_value] = sub_field
-
-        self.sub_fields_mapping = sub_fields_mapping
-        self.discriminator_alias = get_unique_discriminator_alias(all_aliases, self.discriminator_key)
-
-    def _create_sub_type(self, type_: Type[Any], name: str, *, for_keys: bool = False) -> 'ModelField':
-        if for_keys:
-            class_validators = None
-        else:
-            # validators for sub items should not have `each_item` as we want to check only the first sublevel
-            class_validators = {
-                k: Validator(
-                    func=v.func,
-                    pre=v.pre,
-                    each_item=False,
-                    always=v.always,
-                    check_fields=v.check_fields,
-                    skip_on_failure=v.skip_on_failure,
-                )
-                for k, v in self.class_validators.items()
-                if v.each_item
-            }
-
-        field_info, _ = self._get_field_info(name, type_, None, self.model_config)
-
-        return self.__class__(
-            type_=type_,
-            name=name,
-            class_validators=class_validators,
-            model_config=self.model_config,
-            field_info=field_info,
-        )
-
-    def populate_validators(self) -> None:
-        """
-        Prepare self.pre_validators, self.validators, and self.post_validators based on self.type_'s  __get_validators__
-        and class validators. This method should be idempotent, e.g. it should be safe to call multiple times
-        without mis-configuring the field.
-        """
-        self.validate_always = getattr(self.type_, 'validate_always', False) or any(
-            v.always for v in self.class_validators.values()
-        )
-
-        class_validators_ = self.class_validators.values()
-        if not self.sub_fields or self.shape == SHAPE_GENERIC:
-            get_validators = getattr(self.type_, '__get_validators__', None)
-            v_funcs = (
-                *[v.func for v in class_validators_ if v.each_item and v.pre],
-                *(get_validators() if get_validators else list(find_validators(self.type_, self.model_config))),
-                *[v.func for v in class_validators_ if v.each_item and not v.pre],
-            )
-            self.validators = prep_validators(v_funcs)
-
-        self.pre_validators = []
-        self.post_validators = []
-
-        if self.field_info and self.field_info.const:
-            self.post_validators.append(make_generic_validator(constant_validator))
-
-        if class_validators_:
-            self.pre_validators += prep_validators(v.func for v in class_validators_ if not v.each_item and v.pre)
-            self.post_validators += prep_validators(v.func for v in class_validators_ if not v.each_item and not v.pre)
-
-        if self.parse_json:
-            self.pre_validators.append(make_generic_validator(validate_json))
-
-        self.pre_validators = self.pre_validators or None
-        self.post_validators = self.post_validators or None
-
-    def validate(
-        self, v: Any, values: Dict[str, Any], *, loc: 'LocStr', cls: Optional['ModelOrDc'] = None
-    ) -> 'ValidateReturn':
-
-        assert self.type_.__class__ is not DeferredType
-
-        if self.type_.__class__ is ForwardRef:
-            assert cls is not None
-            raise ConfigError(
-                f'field "{self.name}" not yet prepared so type is still a ForwardRef, '
-                f'you might need to call {cls.__name__}.update_forward_refs().'
-            )
-
-        errors: Optional['ErrorList']
-        if self.pre_validators:
-            v, errors = self._apply_validators(v, values, loc, cls, self.pre_validators)
-            if errors:
-                return v, errors
-
-        if v is None:
-            if is_none_type(self.type_):
-                # keep validating
-                pass
-            elif self.allow_none:
-                if self.post_validators:
-                    return self._apply_validators(v, values, loc, cls, self.post_validators)
-                else:
-                    return None, None
-            else:
-                return v, ErrorWrapper(NoneIsNotAllowedError(), loc)
-
-        if self.shape == SHAPE_SINGLETON:
-            v, errors = self._validate_singleton(v, values, loc, cls)
-        elif self.shape in MAPPING_LIKE_SHAPES:
-            v, errors = self._validate_mapping_like(v, values, loc, cls)
-        elif self.shape == SHAPE_TUPLE:
-            v, errors = self._validate_tuple(v, values, loc, cls)
-        elif self.shape == SHAPE_ITERABLE:
-            v, errors = self._validate_iterable(v, values, loc, cls)
-        elif self.shape == SHAPE_GENERIC:
-            v, errors = self._apply_validators(v, values, loc, cls, self.validators)
-        else:
-            #  sequence, list, set, generator, tuple with ellipsis, frozen set
-            v, errors = self._validate_sequence_like(v, values, loc, cls)
-
-        if not errors and self.post_validators:
-            v, errors = self._apply_validators(v, values, loc, cls, self.post_validators)
-        return v, errors
-
-    def _validate_sequence_like(  # noqa: C901 (ignore complexity)
-        self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc']
-    ) -> 'ValidateReturn':
-        """
-        Validate sequence-like containers: lists, tuples, sets and generators
-        Note that large if-else blocks are necessary to enable Cython
-        optimization, which is why we disable the complexity check above.
-        """
-        if not sequence_like(v):
-            e: errors_.PydanticTypeError
-            if self.shape == SHAPE_LIST:
-                e = errors_.ListError()
-            elif self.shape in (SHAPE_TUPLE, SHAPE_TUPLE_ELLIPSIS):
-                e = errors_.TupleError()
-            elif self.shape == SHAPE_SET:
-                e = errors_.SetError()
-            elif self.shape == SHAPE_FROZENSET:
-                e = errors_.FrozenSetError()
-            else:
-                e = errors_.SequenceError()
-            return v, ErrorWrapper(e, loc)
-
-        loc = loc if isinstance(loc, tuple) else (loc,)
-        result = []
-        errors: List[ErrorList] = []
-        for i, v_ in enumerate(v):
-            v_loc = *loc, i
-            r, ee = self._validate_singleton(v_, values, v_loc, cls)
-            if ee:
-                errors.append(ee)
-            else:
-                result.append(r)
-
-        if errors:
-            return v, errors
-
-        converted: Union[List[Any], Set[Any], FrozenSet[Any], Tuple[Any, ...], Iterator[Any], Deque[Any]] = result
-
-        if self.shape == SHAPE_SET:
-            converted = set(result)
-        elif self.shape == SHAPE_FROZENSET:
-            converted = frozenset(result)
-        elif self.shape == SHAPE_TUPLE_ELLIPSIS:
-            converted = tuple(result)
-        elif self.shape == SHAPE_DEQUE:
-            converted = deque(result)
-        elif self.shape == SHAPE_SEQUENCE:
-            if isinstance(v, tuple):
-                converted = tuple(result)
-            elif isinstance(v, set):
-                converted = set(result)
-            elif isinstance(v, Generator):
-                converted = iter(result)
-            elif isinstance(v, deque):
-                converted = deque(result)
-        return converted, None
-
-    def _validate_iterable(
-        self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc']
-    ) -> 'ValidateReturn':
-        """
-        Validate Iterables.
-
-        This intentionally doesn't validate values to allow infinite generators.
-        """
-
-        try:
-            iterable = iter(v)
-        except TypeError:
-            return v, ErrorWrapper(errors_.IterableError(), loc)
-        return iterable, None
-
-    def _validate_tuple(
-        self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc']
-    ) -> 'ValidateReturn':
-        e: Optional[Exception] = None
-        if not sequence_like(v):
-            e = errors_.TupleError()
-        else:
-            actual_length, expected_length = len(v), len(self.sub_fields)  # type: ignore
-            if actual_length != expected_length:
-                e = errors_.TupleLengthError(actual_length=actual_length, expected_length=expected_length)
-
-        if e:
-            return v, ErrorWrapper(e, loc)
-
-        loc = loc if isinstance(loc, tuple) else (loc,)
-        result = []
-        errors: List[ErrorList] = []
-        for i, (v_, field) in enumerate(zip(v, self.sub_fields)):  # type: ignore
-            v_loc = *loc, i
-            r, ee = field.validate(v_, values, loc=v_loc, cls=cls)
-            if ee:
-                errors.append(ee)
-            else:
-                result.append(r)
-
-        if errors:
-            return v, errors
-        else:
-            return tuple(result), None
-
-    def _validate_mapping_like(
-        self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc']
-    ) -> 'ValidateReturn':
-        try:
-            v_iter = dict_validator(v)
-        except TypeError as exc:
-            return v, ErrorWrapper(exc, loc)
-
-        loc = loc if isinstance(loc, tuple) else (loc,)
-        result, errors = {}, []
-        for k, v_ in v_iter.items():
-            v_loc = *loc, '__key__'
-            key_result, key_errors = self.key_field.validate(k, values, loc=v_loc, cls=cls)  # type: ignore
-            if key_errors:
-                errors.append(key_errors)
-                continue
-
-            v_loc = *loc, k
-            value_result, value_errors = self._validate_singleton(v_, values, v_loc, cls)
-            if value_errors:
-                errors.append(value_errors)
-                continue
-
-            result[key_result] = value_result
-        if errors:
-            return v, errors
-        elif self.shape == SHAPE_DICT:
-            return result, None
-        elif self.shape == SHAPE_DEFAULTDICT:
-            return defaultdict(self.type_, result), None
-        elif self.shape == SHAPE_COUNTER:
-            return CollectionCounter(result), None
-        else:
-            return self._get_mapping_value(v, result), None
-
-    def _get_mapping_value(self, original: T, converted: Dict[Any, Any]) -> Union[T, Dict[Any, Any]]:
-        """
-        When type is `Mapping[KT, KV]` (or another unsupported mapping), we try to avoid
-        coercing to `dict` unwillingly.
-        """
-        original_cls = original.__class__
-
-        if original_cls == dict or original_cls == Dict:
-            return converted
-        elif original_cls in {defaultdict, DefaultDict}:
-            return defaultdict(self.type_, converted)
-        else:
-            try:
-                # Counter, OrderedDict, UserDict, ...
-                return original_cls(converted)  # type: ignore
-            except TypeError:
-                raise RuntimeError(f'Could not convert dictionary to {original_cls.__name__!r}') from None
-
-    def _validate_singleton(
-        self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc']
-    ) -> 'ValidateReturn':
-        if self.sub_fields:
-            if self.discriminator_key is not None:
-                return self._validate_discriminated_union(v, values, loc, cls)
-
-            errors = []
-
-            if self.model_config.smart_union and is_union(get_origin(self.type_)):
-                # 1st pass: check if the value is an exact instance of one of the Union types
-                # (e.g. to avoid coercing a bool into an int)
-                for field in self.sub_fields:
-                    if v.__class__ is field.outer_type_:
-                        return v, None
-
-                # 2nd pass: check if the value is an instance of any subclass of the Union types
-                for field in self.sub_fields:
-                    # This whole logic will be improved later on to support more complex `isinstance` checks
-                    # It will probably be done once a strict mode is added and be something like:
-                    # ```
-                    #     value, error = field.validate(v, values, strict=True)
-                    #     if error is None:
-                    #         return value, None
-                    # ```
-                    try:
-                        if isinstance(v, field.outer_type_):
-                            return v, None
-                    except TypeError:
-                        # compound type
-                        if lenient_isinstance(v, get_origin(field.outer_type_)):
-                            value, error = field.validate(v, values, loc=loc, cls=cls)
-                            if not error:
-                                return value, None
-
-            # 1st pass by default or 3rd pass with `smart_union` enabled:
-            # check if the value can be coerced into one of the Union types
-            for field in self.sub_fields:
-                value, error = field.validate(v, values, loc=loc, cls=cls)
-                if error:
-                    errors.append(error)
-                else:
-                    return value, None
-            return v, errors
-        else:
-            return self._apply_validators(v, values, loc, cls, self.validators)
-
-    def _validate_discriminated_union(
-        self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc']
-    ) -> 'ValidateReturn':
-        assert self.discriminator_key is not None
-        assert self.discriminator_alias is not None
-
-        try:
-            discriminator_value = v[self.discriminator_alias]
-        except KeyError:
-            return v, ErrorWrapper(MissingDiscriminator(discriminator_key=self.discriminator_key), loc)
-        except TypeError:
-            try:
-                # BaseModel or dataclass
-                discriminator_value = getattr(v, self.discriminator_key)
-            except (AttributeError, TypeError):
-                return v, ErrorWrapper(MissingDiscriminator(discriminator_key=self.discriminator_key), loc)
-
-        try:
-            sub_field = self.sub_fields_mapping[discriminator_value]  # type: ignore[index]
-        except TypeError:
-            assert cls is not None
-            raise ConfigError(
-                f'field "{self.name}" not yet prepared so type is still a ForwardRef, '
-                f'you might need to call {cls.__name__}.update_forward_refs().'
-            )
-        except KeyError:
-            assert self.sub_fields_mapping is not None
-            return v, ErrorWrapper(
-                InvalidDiscriminator(
-                    discriminator_key=self.discriminator_key,
-                    discriminator_value=discriminator_value,
-                    allowed_values=list(self.sub_fields_mapping),
-                ),
-                loc,
-            )
-        else:
-            if not isinstance(loc, tuple):
-                loc = (loc,)
-            return sub_field.validate(v, values, loc=(*loc, display_as_type(sub_field.type_)), cls=cls)
-
-    def _apply_validators(
-        self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc'], validators: 'ValidatorsList'
-    ) -> 'ValidateReturn':
-        for validator in validators:
-            try:
-                v = validator(cls, v, values, self, self.model_config)
-            except (ValueError, TypeError, AssertionError) as exc:
-                return v, ErrorWrapper(exc, loc)
-        return v, None
-
-    def is_complex(self) -> bool:
-        """
-        Whether the field is "complex" eg. env variables should be parsed as JSON.
-        """
-        from .main import BaseModel
-
-        return (
-            self.shape != SHAPE_SINGLETON
-            or hasattr(self.type_, '__pydantic_model__')
-            or lenient_issubclass(self.type_, (BaseModel, list, set, frozenset, dict))
-        )
-
-    def _type_display(self) -> PyObjectStr:
-        t = display_as_type(self.type_)
-
-        if self.shape in MAPPING_LIKE_SHAPES:
-            t = f'Mapping[{display_as_type(self.key_field.type_)}, {t}]'  # type: ignore
-        elif self.shape == SHAPE_TUPLE:
-            t = 'Tuple[{}]'.format(', '.join(display_as_type(f.type_) for f in self.sub_fields))  # type: ignore
-        elif self.shape == SHAPE_GENERIC:
-            assert self.sub_fields
-            t = '{}[{}]'.format(
-                display_as_type(self.type_), ', '.join(display_as_type(f.type_) for f in self.sub_fields)
-            )
-        elif self.shape != SHAPE_SINGLETON:
-            t = SHAPE_NAME_LOOKUP[self.shape].format(t)
-
-        if self.allow_none and (self.shape != SHAPE_SINGLETON or not self.sub_fields):
-            t = f'Optional[{t}]'
-        return PyObjectStr(t)
-
-    def __repr_args__(self) -> 'ReprArgs':
-        args = [('name', self.name), ('type', self._type_display()), ('required', self.required)]
-
-        if not self.required:
-            if self.default_factory is not None:
-                args.append(('default_factory', f'<function {self.default_factory.__name__}>'))
-            else:
-                args.append(('default', self.default))
-
-        if self.alt_alias:
-            args.append(('alias', self.alias))
-        return args
-
-
-class ModelPrivateAttr(Representation):
-    __slots__ = ('default', 'default_factory')
-
-    def __init__(self, default: Any = Undefined, *, default_factory: Optional[NoArgAnyCallable] = None) -> None:
         self.default = default
         self.default_factory = default_factory
 
+    if not typing.TYPE_CHECKING:
+        # We put `__getattr__` in a non-TYPE_CHECKING block because otherwise, mypy allows arbitrary attribute access
+
+        def __getattr__(self, item: str) -> Any:
+            """This function improves compatibility with custom descriptors by ensuring delegation happens
+            as expected when the default value of a private attribute is a descriptor.
+            """
+            if item in {'__get__', '__set__', '__delete__'}:
+                if hasattr(self.default, item):
+                    return getattr(self.default, item)
+            raise AttributeError(f'{type(self).__name__!r} object has no attribute {item!r}')
+
+    def __set_name__(self, cls: type[Any], name: str) -> None:
+        """Preserve `__set_name__` protocol defined in https://peps.python.org/pep-0487."""
+        if self.default is PydanticUndefined:
+            return
+        if not hasattr(self.default, '__set_name__'):
+            return
+        set_name = self.default.__set_name__
+        if callable(set_name):
+            set_name(cls, name)
+
     def get_default(self) -> Any:
-        return smart_deepcopy(self.default) if self.default_factory is None else self.default_factory()
+        """Retrieve the default value of the object.
+
+        If `self.default_factory` is `None`, the method will return a deep copy of the `self.default` object.
+
+        If `self.default_factory` is not `None`, it will call `self.default_factory` and return the value returned.
+
+        Returns:
+            The default value of the object.
+        """
+        return _utils.smart_deepcopy(self.default) if self.default_factory is None else self.default_factory()
 
     def __eq__(self, other: Any) -> bool:
         return isinstance(other, self.__class__) and (self.default, self.default_factory) == (
@@ -1213,23 +879,32 @@ class ModelPrivateAttr(Representation):
 
 
 def PrivateAttr(
-    default: Any = Undefined,
+    default: Any = PydanticUndefined,
     *,
-    default_factory: Optional[NoArgAnyCallable] = None,
+    default_factory: typing.Callable[[], Any] | None = None,
 ) -> Any:
+    """Usage docs: https://docs.pydantic.dev/2.6/concepts/models/#private-model-attributes
+
+    Indicates that an attribute is intended for private use and not handled during normal validation/serialization.
+
+    Private attributes are not validated by Pydantic, so it's up to you to ensure they are used in a type-safe manner.
+
+    Private attributes are stored in `__private_attributes__` on the model.
+
+    Args:
+        default: The attribute's default value. Defaults to Undefined.
+        default_factory: Callable that will be
+            called when a default value is needed for this attribute.
+            If both `default` and `default_factory` are set, an error will be raised.
+
+    Returns:
+        An instance of [`ModelPrivateAttr`][pydantic.fields.ModelPrivateAttr] class.
+
+    Raises:
+        ValueError: If both `default` and `default_factory` are set.
     """
-    Indicates that attribute is only used internally and never mixed with regular fields.
-
-    Types or values of private attrs are not checked by pydantic and it's up to you to keep them relevant.
-
-    Private attrs are stored in model __slots__.
-
-    :param default: the attribute’s default value
-    :param default_factory: callable that will be called when a default value is needed for this attribute
-      If both `default` and `default_factory` are set, an error is raised.
-    """
-    if default is not Undefined and default_factory is not None:
-        raise ValueError('cannot specify both default and default_factory')
+    if default is not PydanticUndefined and default_factory is not None:
+        raise TypeError('cannot specify both default and default_factory')
 
     return ModelPrivateAttr(
         default,
@@ -1237,11 +912,243 @@ def PrivateAttr(
     )
 
 
-class DeferredType:
-    """
-    Used to postpone field preparation, while creating recursive generic models.
+@dataclasses.dataclass(**_internal_dataclass.slots_true)
+class ComputedFieldInfo:
+    """A container for data from `@computed_field` so that we can access it while building the pydantic-core schema.
+
+    Attributes:
+        decorator_repr: A class variable representing the decorator string, '@computed_field'.
+        wrapped_property: The wrapped computed field property.
+        return_type: The type of the computed field property's return value.
+        alias: The alias of the property to be used during serialization.
+        alias_priority: The priority of the alias. This affects whether an alias generator is used.
+        title: Title of the computed field to include in the serialization JSON schema.
+        description: Description of the computed field to include in the serialization JSON schema.
+        examples: Example values of the computed field to include in the serialization JSON schema.
+        json_schema_extra: A dict or callable to provide extra JSON schema properties.
+        repr: A boolean indicating whether to include the field in the __repr__ output.
     """
 
+    decorator_repr: ClassVar[str] = '@computed_field'
+    wrapped_property: property
+    return_type: Any
+    alias: str | None
+    alias_priority: int | None
+    title: str | None
+    description: str | None
+    examples: list[Any] | None
+    json_schema_extra: JsonDict | typing.Callable[[JsonDict], None] | None
+    repr: bool
 
-def is_finalvar_with_default_val(type_: Type[Any], val: Any) -> bool:
-    return is_finalvar(type_) and val is not Undefined and not isinstance(val, FieldInfo)
+
+def _wrapped_property_is_private(property_: cached_property | property) -> bool:  # type: ignore
+    """Returns true if provided property is private, False otherwise."""
+    wrapped_name: str = ''
+
+    if isinstance(property_, property):
+        wrapped_name = getattr(property_.fget, '__name__', '')
+    elif isinstance(property_, cached_property):  # type: ignore
+        wrapped_name = getattr(property_.func, '__name__', '')  # type: ignore
+
+    return wrapped_name.startswith('_') and not wrapped_name.startswith('__')
+
+
+# this should really be `property[T], cached_property[T]` but property is not generic unlike cached_property
+# See https://github.com/python/typing/issues/985 and linked issues
+PropertyT = typing.TypeVar('PropertyT')
+
+
+@typing.overload
+def computed_field(
+    *,
+    alias: str | None = None,
+    alias_priority: int | None = None,
+    title: str | None = None,
+    description: str | None = None,
+    examples: list[Any] | None = None,
+    json_schema_extra: JsonDict | typing.Callable[[JsonDict], None] | None = None,
+    repr: bool = True,
+    return_type: Any = PydanticUndefined,
+) -> typing.Callable[[PropertyT], PropertyT]:
+    ...
+
+
+@typing.overload
+def computed_field(__func: PropertyT) -> PropertyT:
+    ...
+
+
+def computed_field(
+    __f: PropertyT | None = None,
+    *,
+    alias: str | None = None,
+    alias_priority: int | None = None,
+    title: str | None = None,
+    description: str | None = None,
+    examples: list[Any] | None = None,
+    json_schema_extra: JsonDict | typing.Callable[[JsonDict], None] | None = None,
+    repr: bool | None = None,
+    return_type: Any = PydanticUndefined,
+) -> PropertyT | typing.Callable[[PropertyT], PropertyT]:
+    """Usage docs: https://docs.pydantic.dev/2.6/concepts/fields#the-computed_field-decorator
+
+    Decorator to include `property` and `cached_property` when serializing models or dataclasses.
+
+    This is useful for fields that are computed from other fields, or for fields that are expensive to compute and should be cached.
+
+    ```py
+    from pydantic import BaseModel, computed_field
+
+    class Rectangle(BaseModel):
+        width: int
+        length: int
+
+        @computed_field
+        @property
+        def area(self) -> int:
+            return self.width * self.length
+
+    print(Rectangle(width=3, length=2).model_dump())
+    #> {'width': 3, 'length': 2, 'area': 6}
+    ```
+
+    If applied to functions not yet decorated with `@property` or `@cached_property`, the function is
+    automatically wrapped with `property`. Although this is more concise, you will lose IntelliSense in your IDE,
+    and confuse static type checkers, thus explicit use of `@property` is recommended.
+
+    !!! warning "Mypy Warning"
+        Even with the `@property` or `@cached_property` applied to your function before `@computed_field`,
+        mypy may throw a `Decorated property not supported` error.
+        See [mypy issue #1362](https://github.com/python/mypy/issues/1362), for more information.
+        To avoid this error message, add `# type: ignore[misc]` to the `@computed_field` line.
+
+        [pyright](https://github.com/microsoft/pyright) supports `@computed_field` without error.
+
+    ```py
+    import random
+
+    from pydantic import BaseModel, computed_field
+
+    class Square(BaseModel):
+        width: float
+
+        @computed_field
+        def area(self) -> float:  # converted to a `property` by `computed_field`
+            return round(self.width**2, 2)
+
+        @area.setter
+        def area(self, new_area: float) -> None:
+            self.width = new_area**0.5
+
+        @computed_field(alias='the magic number', repr=False)
+        def random_number(self) -> int:
+            return random.randint(0, 1_000)
+
+    square = Square(width=1.3)
+
+    # `random_number` does not appear in representation
+    print(repr(square))
+    #> Square(width=1.3, area=1.69)
+
+    print(square.random_number)
+    #> 3
+
+    square.area = 4
+
+    print(square.model_dump_json(by_alias=True))
+    #> {"width":2.0,"area":4.0,"the magic number":3}
+    ```
+
+    !!! warning "Overriding with `computed_field`"
+        You can't override a field from a parent class with a `computed_field` in the child class.
+        `mypy` complains about this behavior if allowed, and `dataclasses` doesn't allow this pattern either.
+        See the example below:
+
+    ```py
+    from pydantic import BaseModel, computed_field
+
+    class Parent(BaseModel):
+        a: str
+
+    try:
+
+        class Child(Parent):
+            @computed_field
+            @property
+            def a(self) -> str:
+                return 'new a'
+
+    except ValueError as e:
+        print(repr(e))
+        #> ValueError("you can't override a field with a computed field")
+    ```
+
+    Private properties decorated with `@computed_field` have `repr=False` by default.
+
+    ```py
+    from functools import cached_property
+
+    from pydantic import BaseModel, computed_field
+
+    class Model(BaseModel):
+        foo: int
+
+        @computed_field
+        @cached_property
+        def _private_cached_property(self) -> int:
+            return -self.foo
+
+        @computed_field
+        @property
+        def _private_property(self) -> int:
+            return -self.foo
+
+    m = Model(foo=1)
+    print(repr(m))
+    #> M(foo=1)
+    ```
+
+    Args:
+        __f: the function to wrap.
+        alias: alias to use when serializing this computed field, only used when `by_alias=True`
+        alias_priority: priority of the alias. This affects whether an alias generator is used
+        title: Title to use when including this computed field in JSON Schema
+        description: Description to use when including this computed field in JSON Schema, defaults to the function's
+            docstring
+        examples: Example values to use when including this computed field in JSON Schema
+        json_schema_extra: A dict or callable to provide extra JSON schema properties.
+        repr: whether to include this computed field in model repr.
+            Default is `False` for private properties and `True` for public properties.
+        return_type: optional return for serialization logic to expect when serializing to JSON, if included
+            this must be correct, otherwise a `TypeError` is raised.
+            If you don't include a return type Any is used, which does runtime introspection to handle arbitrary
+            objects.
+
+    Returns:
+        A proxy wrapper for the property.
+    """
+
+    def dec(f: Any) -> Any:
+        nonlocal description, return_type, alias_priority
+        unwrapped = _decorators.unwrap_wrapped_function(f)
+        if description is None and unwrapped.__doc__:
+            description = inspect.cleandoc(unwrapped.__doc__)
+
+        # if the function isn't already decorated with `@property` (or another descriptor), then we wrap it now
+        f = _decorators.ensure_property(f)
+        alias_priority = (alias_priority or 2) if alias is not None else None
+
+        if repr is None:
+            repr_: bool = False if _wrapped_property_is_private(property_=f) else True
+        else:
+            repr_ = repr
+
+        dec_info = ComputedFieldInfo(
+            f, return_type, alias, alias_priority, title, description, examples, json_schema_extra, repr_
+        )
+        return _decorators.PydanticDescriptorProxy(f, dec_info)
+
+    if __f is None:
+        return dec
+    else:
+        return dec(__f)
diff --git a/lib/pydantic/functional_serializers.py b/lib/pydantic/functional_serializers.py
new file mode 100644
index 00000000..6e31bf67
--- /dev/null
+++ b/lib/pydantic/functional_serializers.py
@@ -0,0 +1,395 @@
+"""This module contains related classes and functions for serialization."""
+from __future__ import annotations
+
+import dataclasses
+from functools import partialmethod
+from typing import TYPE_CHECKING, Any, Callable, TypeVar, Union, overload
+
+from pydantic_core import PydanticUndefined, core_schema
+from pydantic_core import core_schema as _core_schema
+from typing_extensions import Annotated, Literal, TypeAlias
+
+from . import PydanticUndefinedAnnotation
+from ._internal import _decorators, _internal_dataclass
+from .annotated_handlers import GetCoreSchemaHandler
+
+
+@dataclasses.dataclass(**_internal_dataclass.slots_true, frozen=True)
+class PlainSerializer:
+    """Plain serializers use a function to modify the output of serialization.
+
+    This is particularly helpful when you want to customize the serialization for annotated types.
+    Consider an input of `list`, which will be serialized into a space-delimited string.
+
+    ```python
+    from typing import List
+
+    from typing_extensions import Annotated
+
+    from pydantic import BaseModel, PlainSerializer
+
+    CustomStr = Annotated[
+        List, PlainSerializer(lambda x: ' '.join(x), return_type=str)
+    ]
+
+    class StudentModel(BaseModel):
+        courses: CustomStr
+
+    student = StudentModel(courses=['Math', 'Chemistry', 'English'])
+    print(student.model_dump())
+    #> {'courses': 'Math Chemistry English'}
+    ```
+
+    Attributes:
+        func: The serializer function.
+        return_type: The return type for the function. If omitted it will be inferred from the type annotation.
+        when_used: Determines when this serializer should be used. Accepts a string with values `'always'`,
+            `'unless-none'`, `'json'`, and `'json-unless-none'`. Defaults to 'always'.
+    """
+
+    func: core_schema.SerializerFunction
+    return_type: Any = PydanticUndefined
+    when_used: Literal['always', 'unless-none', 'json', 'json-unless-none'] = 'always'
+
+    def __get_pydantic_core_schema__(self, source_type: Any, handler: GetCoreSchemaHandler) -> core_schema.CoreSchema:
+        """Gets the Pydantic core schema.
+
+        Args:
+            source_type: The source type.
+            handler: The `GetCoreSchemaHandler` instance.
+
+        Returns:
+            The Pydantic core schema.
+        """
+        schema = handler(source_type)
+        try:
+            return_type = _decorators.get_function_return_type(
+                self.func, self.return_type, handler._get_types_namespace()
+            )
+        except NameError as e:
+            raise PydanticUndefinedAnnotation.from_name_error(e) from e
+        return_schema = None if return_type is PydanticUndefined else handler.generate_schema(return_type)
+        schema['serialization'] = core_schema.plain_serializer_function_ser_schema(
+            function=self.func,
+            info_arg=_decorators.inspect_annotated_serializer(self.func, 'plain'),
+            return_schema=return_schema,
+            when_used=self.when_used,
+        )
+        return schema
+
+
+@dataclasses.dataclass(**_internal_dataclass.slots_true, frozen=True)
+class WrapSerializer:
+    """Wrap serializers receive the raw inputs along with a handler function that applies the standard serialization
+    logic, and can modify the resulting value before returning it as the final output of serialization.
+
+    For example, here's a scenario in which a wrap serializer transforms timezones to UTC **and** utilizes the existing `datetime` serialization logic.
+
+    ```python
+    from datetime import datetime, timezone
+    from typing import Any, Dict
+
+    from typing_extensions import Annotated
+
+    from pydantic import BaseModel, WrapSerializer
+
+    class EventDatetime(BaseModel):
+        start: datetime
+        end: datetime
+
+    def convert_to_utc(value: Any, handler, info) -> Dict[str, datetime]:
+        # Note that `helper` can actually help serialize the `value` for further custom serialization in case it's a subclass.
+        partial_result = handler(value, info)
+        if info.mode == 'json':
+            return {
+                k: datetime.fromisoformat(v).astimezone(timezone.utc)
+                for k, v in partial_result.items()
+            }
+        return {k: v.astimezone(timezone.utc) for k, v in partial_result.items()}
+
+    UTCEventDatetime = Annotated[EventDatetime, WrapSerializer(convert_to_utc)]
+
+    class EventModel(BaseModel):
+        event_datetime: UTCEventDatetime
+
+    dt = EventDatetime(
+        start='2024-01-01T07:00:00-08:00', end='2024-01-03T20:00:00+06:00'
+    )
+    event = EventModel(event_datetime=dt)
+    print(event.model_dump())
+    '''
+    {
+        'event_datetime': {
+            'start': datetime.datetime(
+                2024, 1, 1, 15, 0, tzinfo=datetime.timezone.utc
+            ),
+            'end': datetime.datetime(
+                2024, 1, 3, 14, 0, tzinfo=datetime.timezone.utc
+            ),
+        }
+    }
+    '''
+
+    print(event.model_dump_json())
+    '''
+    {"event_datetime":{"start":"2024-01-01T15:00:00Z","end":"2024-01-03T14:00:00Z"}}
+    '''
+    ```
+
+    Attributes:
+        func: The serializer function to be wrapped.
+        return_type: The return type for the function. If omitted it will be inferred from the type annotation.
+        when_used: Determines when this serializer should be used. Accepts a string with values `'always'`,
+            `'unless-none'`, `'json'`, and `'json-unless-none'`. Defaults to 'always'.
+    """
+
+    func: core_schema.WrapSerializerFunction
+    return_type: Any = PydanticUndefined
+    when_used: Literal['always', 'unless-none', 'json', 'json-unless-none'] = 'always'
+
+    def __get_pydantic_core_schema__(self, source_type: Any, handler: GetCoreSchemaHandler) -> core_schema.CoreSchema:
+        """This method is used to get the Pydantic core schema of the class.
+
+        Args:
+            source_type: Source type.
+            handler: Core schema handler.
+
+        Returns:
+            The generated core schema of the class.
+        """
+        schema = handler(source_type)
+        try:
+            return_type = _decorators.get_function_return_type(
+                self.func, self.return_type, handler._get_types_namespace()
+            )
+        except NameError as e:
+            raise PydanticUndefinedAnnotation.from_name_error(e) from e
+        return_schema = None if return_type is PydanticUndefined else handler.generate_schema(return_type)
+        schema['serialization'] = core_schema.wrap_serializer_function_ser_schema(
+            function=self.func,
+            info_arg=_decorators.inspect_annotated_serializer(self.func, 'wrap'),
+            return_schema=return_schema,
+            when_used=self.when_used,
+        )
+        return schema
+
+
+if TYPE_CHECKING:
+    _PartialClsOrStaticMethod: TypeAlias = Union[classmethod[Any, Any, Any], staticmethod[Any, Any], partialmethod[Any]]
+    _PlainSerializationFunction = Union[_core_schema.SerializerFunction, _PartialClsOrStaticMethod]
+    _WrapSerializationFunction = Union[_core_schema.WrapSerializerFunction, _PartialClsOrStaticMethod]
+    _PlainSerializeMethodType = TypeVar('_PlainSerializeMethodType', bound=_PlainSerializationFunction)
+    _WrapSerializeMethodType = TypeVar('_WrapSerializeMethodType', bound=_WrapSerializationFunction)
+
+
+@overload
+def field_serializer(
+    __field: str,
+    *fields: str,
+    return_type: Any = ...,
+    when_used: Literal['always', 'unless-none', 'json', 'json-unless-none'] = ...,
+    check_fields: bool | None = ...,
+) -> Callable[[_PlainSerializeMethodType], _PlainSerializeMethodType]:
+    ...
+
+
+@overload
+def field_serializer(
+    __field: str,
+    *fields: str,
+    mode: Literal['plain'],
+    return_type: Any = ...,
+    when_used: Literal['always', 'unless-none', 'json', 'json-unless-none'] = ...,
+    check_fields: bool | None = ...,
+) -> Callable[[_PlainSerializeMethodType], _PlainSerializeMethodType]:
+    ...
+
+
+@overload
+def field_serializer(
+    __field: str,
+    *fields: str,
+    mode: Literal['wrap'],
+    return_type: Any = ...,
+    when_used: Literal['always', 'unless-none', 'json', 'json-unless-none'] = ...,
+    check_fields: bool | None = ...,
+) -> Callable[[_WrapSerializeMethodType], _WrapSerializeMethodType]:
+    ...
+
+
+def field_serializer(
+    *fields: str,
+    mode: Literal['plain', 'wrap'] = 'plain',
+    return_type: Any = PydanticUndefined,
+    when_used: Literal['always', 'unless-none', 'json', 'json-unless-none'] = 'always',
+    check_fields: bool | None = None,
+) -> Callable[[Any], Any]:
+    """Decorator that enables custom field serialization.
+
+    In the below example, a field of type `set` is used to mitigate duplication. A `field_serializer` is used to serialize the data as a sorted list.
+
+    ```python
+    from typing import Set
+
+    from pydantic import BaseModel, field_serializer
+
+    class StudentModel(BaseModel):
+        name: str = 'Jane'
+        courses: Set[str]
+
+        @field_serializer('courses', when_used='json')
+        def serialize_courses_in_order(courses: Set[str]):
+            return sorted(courses)
+
+    student = StudentModel(courses={'Math', 'Chemistry', 'English'})
+    print(student.model_dump_json())
+    #> {"name":"Jane","courses":["Chemistry","English","Math"]}
+    ```
+
+    See [Custom serializers](../concepts/serialization.md#custom-serializers) for more information.
+
+    Four signatures are supported:
+
+    - `(self, value: Any, info: FieldSerializationInfo)`
+    - `(self, value: Any, nxt: SerializerFunctionWrapHandler, info: FieldSerializationInfo)`
+    - `(value: Any, info: SerializationInfo)`
+    - `(value: Any, nxt: SerializerFunctionWrapHandler, info: SerializationInfo)`
+
+    Args:
+        fields: Which field(s) the method should be called on.
+        mode: The serialization mode.
+
+            - `plain` means the function will be called instead of the default serialization logic,
+            - `wrap` means the function will be called with an argument to optionally call the
+               default serialization logic.
+        return_type: Optional return type for the function, if omitted it will be inferred from the type annotation.
+        when_used: Determines the serializer will be used for serialization.
+        check_fields: Whether to check that the fields actually exist on the model.
+
+    Returns:
+        The decorator function.
+    """
+
+    def dec(
+        f: Callable[..., Any] | staticmethod[Any, Any] | classmethod[Any, Any, Any],
+    ) -> _decorators.PydanticDescriptorProxy[Any]:
+        dec_info = _decorators.FieldSerializerDecoratorInfo(
+            fields=fields,
+            mode=mode,
+            return_type=return_type,
+            when_used=when_used,
+            check_fields=check_fields,
+        )
+        return _decorators.PydanticDescriptorProxy(f, dec_info)
+
+    return dec
+
+
+FuncType = TypeVar('FuncType', bound=Callable[..., Any])
+
+
+@overload
+def model_serializer(__f: FuncType) -> FuncType:
+    ...
+
+
+@overload
+def model_serializer(
+    *,
+    mode: Literal['plain', 'wrap'] = ...,
+    when_used: Literal['always', 'unless-none', 'json', 'json-unless-none'] = 'always',
+    return_type: Any = ...,
+) -> Callable[[FuncType], FuncType]:
+    ...
+
+
+def model_serializer(
+    __f: Callable[..., Any] | None = None,
+    *,
+    mode: Literal['plain', 'wrap'] = 'plain',
+    when_used: Literal['always', 'unless-none', 'json', 'json-unless-none'] = 'always',
+    return_type: Any = PydanticUndefined,
+) -> Callable[[Any], Any]:
+    """Decorator that enables custom model serialization.
+
+    This is useful when a model need to be serialized in a customized manner, allowing for flexibility beyond just specific fields.
+
+    An example would be to serialize temperature to the same temperature scale, such as degrees Celsius.
+
+    ```python
+    from typing import Literal
+
+    from pydantic import BaseModel, model_serializer
+
+    class TemperatureModel(BaseModel):
+        unit: Literal['C', 'F']
+        value: int
+
+        @model_serializer()
+        def serialize_model(self):
+            if self.unit == 'F':
+                return {'unit': 'C', 'value': int((self.value - 32) / 1.8)}
+            return {'unit': self.unit, 'value': self.value}
+
+    temperature = TemperatureModel(unit='F', value=212)
+    print(temperature.model_dump())
+    #> {'unit': 'C', 'value': 100}
+    ```
+
+    See [Custom serializers](../concepts/serialization.md#custom-serializers) for more information.
+
+    Args:
+        __f: The function to be decorated.
+        mode: The serialization mode.
+
+            - `'plain'` means the function will be called instead of the default serialization logic
+            - `'wrap'` means the function will be called with an argument to optionally call the default
+                serialization logic.
+        when_used: Determines when this serializer should be used.
+        return_type: The return type for the function. If omitted it will be inferred from the type annotation.
+
+    Returns:
+        The decorator function.
+    """
+
+    def dec(f: Callable[..., Any]) -> _decorators.PydanticDescriptorProxy[Any]:
+        dec_info = _decorators.ModelSerializerDecoratorInfo(mode=mode, return_type=return_type, when_used=when_used)
+        return _decorators.PydanticDescriptorProxy(f, dec_info)
+
+    if __f is None:
+        return dec
+    else:
+        return dec(__f)  # type: ignore
+
+
+AnyType = TypeVar('AnyType')
+
+
+if TYPE_CHECKING:
+    SerializeAsAny = Annotated[AnyType, ...]  # SerializeAsAny[list[str]] will be treated by type checkers as list[str]
+    """Force serialization to ignore whatever is defined in the schema and instead ask the object
+    itself how it should be serialized.
+    In particular, this means that when model subclasses are serialized, fields present in the subclass
+    but not in the original schema will be included.
+    """
+else:
+
+    @dataclasses.dataclass(**_internal_dataclass.slots_true)
+    class SerializeAsAny:  # noqa: D101
+        def __class_getitem__(cls, item: Any) -> Any:
+            return Annotated[item, SerializeAsAny()]
+
+        def __get_pydantic_core_schema__(
+            self, source_type: Any, handler: GetCoreSchemaHandler
+        ) -> core_schema.CoreSchema:
+            schema = handler(source_type)
+            schema_to_update = schema
+            while schema_to_update['type'] == 'definitions':
+                schema_to_update = schema_to_update.copy()
+                schema_to_update = schema_to_update['schema']
+            schema_to_update['serialization'] = core_schema.wrap_serializer_function_ser_schema(
+                lambda x, h: h(x), schema=core_schema.any_schema()
+            )
+            return schema
+
+        __hash__ = object.__hash__
diff --git a/lib/pydantic/functional_validators.py b/lib/pydantic/functional_validators.py
new file mode 100644
index 00000000..b547755b
--- /dev/null
+++ b/lib/pydantic/functional_validators.py
@@ -0,0 +1,706 @@
+"""This module contains related classes and functions for validation."""
+
+from __future__ import annotations as _annotations
+
+import dataclasses
+import sys
+from functools import partialmethod
+from types import FunctionType
+from typing import TYPE_CHECKING, Any, Callable, TypeVar, Union, cast, overload
+
+from pydantic_core import core_schema
+from pydantic_core import core_schema as _core_schema
+from typing_extensions import Annotated, Literal, TypeAlias
+
+from . import GetCoreSchemaHandler as _GetCoreSchemaHandler
+from ._internal import _core_metadata, _decorators, _generics, _internal_dataclass
+from .annotated_handlers import GetCoreSchemaHandler
+from .errors import PydanticUserError
+
+if sys.version_info < (3, 11):
+    from typing_extensions import Protocol
+else:
+    from typing import Protocol
+
+_inspect_validator = _decorators.inspect_validator
+
+
+@dataclasses.dataclass(frozen=True, **_internal_dataclass.slots_true)
+class AfterValidator:
+    """Usage docs: https://docs.pydantic.dev/2.6/concepts/validators/#annotated-validators
+
+    A metadata class that indicates that a validation should be applied **after** the inner validation logic.
+
+    Attributes:
+        func: The validator function.
+
+    Example:
+        ```py
+        from typing_extensions import Annotated
+
+        from pydantic import AfterValidator, BaseModel, ValidationError
+
+        MyInt = Annotated[int, AfterValidator(lambda v: v + 1)]
+
+        class Model(BaseModel):
+            a: MyInt
+
+        print(Model(a=1).a)
+        #> 2
+
+        try:
+            Model(a='a')
+        except ValidationError as e:
+            print(e.json(indent=2))
+            '''
+            [
+              {
+                "type": "int_parsing",
+                "loc": [
+                  "a"
+                ],
+                "msg": "Input should be a valid integer, unable to parse string as an integer",
+                "input": "a",
+                "url": "https://errors.pydantic.dev/2/v/int_parsing"
+              }
+            ]
+            '''
+        ```
+    """
+
+    func: core_schema.NoInfoValidatorFunction | core_schema.WithInfoValidatorFunction
+
+    def __get_pydantic_core_schema__(self, source_type: Any, handler: _GetCoreSchemaHandler) -> core_schema.CoreSchema:
+        schema = handler(source_type)
+        info_arg = _inspect_validator(self.func, 'after')
+        if info_arg:
+            func = cast(core_schema.WithInfoValidatorFunction, self.func)
+            return core_schema.with_info_after_validator_function(func, schema=schema, field_name=handler.field_name)
+        else:
+            func = cast(core_schema.NoInfoValidatorFunction, self.func)
+            return core_schema.no_info_after_validator_function(func, schema=schema)
+
+
+@dataclasses.dataclass(frozen=True, **_internal_dataclass.slots_true)
+class BeforeValidator:
+    """Usage docs: https://docs.pydantic.dev/2.6/concepts/validators/#annotated-validators
+
+    A metadata class that indicates that a validation should be applied **before** the inner validation logic.
+
+    Attributes:
+        func: The validator function.
+
+    Example:
+        ```py
+        from typing_extensions import Annotated
+
+        from pydantic import BaseModel, BeforeValidator
+
+        MyInt = Annotated[int, BeforeValidator(lambda v: v + 1)]
+
+        class Model(BaseModel):
+            a: MyInt
+
+        print(Model(a=1).a)
+        #> 2
+
+        try:
+            Model(a='a')
+        except TypeError as e:
+            print(e)
+            #> can only concatenate str (not "int") to str
+        ```
+    """
+
+    func: core_schema.NoInfoValidatorFunction | core_schema.WithInfoValidatorFunction
+
+    def __get_pydantic_core_schema__(self, source_type: Any, handler: _GetCoreSchemaHandler) -> core_schema.CoreSchema:
+        schema = handler(source_type)
+        info_arg = _inspect_validator(self.func, 'before')
+        if info_arg:
+            func = cast(core_schema.WithInfoValidatorFunction, self.func)
+            return core_schema.with_info_before_validator_function(func, schema=schema, field_name=handler.field_name)
+        else:
+            func = cast(core_schema.NoInfoValidatorFunction, self.func)
+            return core_schema.no_info_before_validator_function(func, schema=schema)
+
+
+@dataclasses.dataclass(frozen=True, **_internal_dataclass.slots_true)
+class PlainValidator:
+    """Usage docs: https://docs.pydantic.dev/2.6/concepts/validators/#annotated-validators
+
+    A metadata class that indicates that a validation should be applied **instead** of the inner validation logic.
+
+    Attributes:
+        func: The validator function.
+
+    Example:
+        ```py
+        from typing_extensions import Annotated
+
+        from pydantic import BaseModel, PlainValidator
+
+        MyInt = Annotated[int, PlainValidator(lambda v: int(v) + 1)]
+
+        class Model(BaseModel):
+            a: MyInt
+
+        print(Model(a='1').a)
+        #> 2
+        ```
+    """
+
+    func: core_schema.NoInfoValidatorFunction | core_schema.WithInfoValidatorFunction
+
+    def __get_pydantic_core_schema__(self, source_type: Any, handler: _GetCoreSchemaHandler) -> core_schema.CoreSchema:
+        # Note that for some valid uses of PlainValidator, it is not possible to generate a core schema for the
+        # source_type, so calling `handler(source_type)` will error, which prevents us from generating a proper
+        # serialization schema. To work around this for use cases that will not involve serialization, we simply
+        # catch any PydanticSchemaGenerationError that may be raised while attempting to build the serialization schema
+        # and abort any attempts to handle special serialization.
+        from pydantic import PydanticSchemaGenerationError
+
+        try:
+            schema = handler(source_type)
+            serialization = core_schema.wrap_serializer_function_ser_schema(function=lambda v, h: h(v), schema=schema)
+        except PydanticSchemaGenerationError:
+            serialization = None
+
+        info_arg = _inspect_validator(self.func, 'plain')
+        if info_arg:
+            func = cast(core_schema.WithInfoValidatorFunction, self.func)
+            return core_schema.with_info_plain_validator_function(
+                func, field_name=handler.field_name, serialization=serialization
+            )
+        else:
+            func = cast(core_schema.NoInfoValidatorFunction, self.func)
+            return core_schema.no_info_plain_validator_function(func, serialization=serialization)
+
+
+@dataclasses.dataclass(frozen=True, **_internal_dataclass.slots_true)
+class WrapValidator:
+    """Usage docs: https://docs.pydantic.dev/2.6/concepts/validators/#annotated-validators
+
+    A metadata class that indicates that a validation should be applied **around** the inner validation logic.
+
+    Attributes:
+        func: The validator function.
+
+    ```py
+    from datetime import datetime
+
+    from typing_extensions import Annotated
+
+    from pydantic import BaseModel, ValidationError, WrapValidator
+
+    def validate_timestamp(v, handler):
+        if v == 'now':
+            # we don't want to bother with further validation, just return the new value
+            return datetime.now()
+        try:
+            return handler(v)
+        except ValidationError:
+            # validation failed, in this case we want to return a default value
+            return datetime(2000, 1, 1)
+
+    MyTimestamp = Annotated[datetime, WrapValidator(validate_timestamp)]
+
+    class Model(BaseModel):
+        a: MyTimestamp
+
+    print(Model(a='now').a)
+    #> 2032-01-02 03:04:05.000006
+    print(Model(a='invalid').a)
+    #> 2000-01-01 00:00:00
+    ```
+    """
+
+    func: core_schema.NoInfoWrapValidatorFunction | core_schema.WithInfoWrapValidatorFunction
+
+    def __get_pydantic_core_schema__(self, source_type: Any, handler: _GetCoreSchemaHandler) -> core_schema.CoreSchema:
+        schema = handler(source_type)
+        info_arg = _inspect_validator(self.func, 'wrap')
+        if info_arg:
+            func = cast(core_schema.WithInfoWrapValidatorFunction, self.func)
+            return core_schema.with_info_wrap_validator_function(func, schema=schema, field_name=handler.field_name)
+        else:
+            func = cast(core_schema.NoInfoWrapValidatorFunction, self.func)
+            return core_schema.no_info_wrap_validator_function(func, schema=schema)
+
+
+if TYPE_CHECKING:
+
+    class _OnlyValueValidatorClsMethod(Protocol):
+        def __call__(self, cls: Any, value: Any, /) -> Any:
+            ...
+
+    class _V2ValidatorClsMethod(Protocol):
+        def __call__(self, cls: Any, value: Any, info: _core_schema.ValidationInfo, /) -> Any:
+            ...
+
+    class _V2WrapValidatorClsMethod(Protocol):
+        def __call__(
+            self,
+            cls: Any,
+            value: Any,
+            handler: _core_schema.ValidatorFunctionWrapHandler,
+            info: _core_schema.ValidationInfo,
+            /,
+        ) -> Any:
+            ...
+
+    _V2Validator = Union[
+        _V2ValidatorClsMethod,
+        _core_schema.WithInfoValidatorFunction,
+        _OnlyValueValidatorClsMethod,
+        _core_schema.NoInfoValidatorFunction,
+    ]
+
+    _V2WrapValidator = Union[
+        _V2WrapValidatorClsMethod,
+        _core_schema.WithInfoWrapValidatorFunction,
+    ]
+
+    _PartialClsOrStaticMethod: TypeAlias = Union[classmethod[Any, Any, Any], staticmethod[Any, Any], partialmethod[Any]]
+
+    _V2BeforeAfterOrPlainValidatorType = TypeVar(
+        '_V2BeforeAfterOrPlainValidatorType',
+        _V2Validator,
+        _PartialClsOrStaticMethod,
+    )
+    _V2WrapValidatorType = TypeVar('_V2WrapValidatorType', _V2WrapValidator, _PartialClsOrStaticMethod)
+
+
+@overload
+def field_validator(
+    __field: str,
+    *fields: str,
+    mode: Literal['before', 'after', 'plain'] = ...,
+    check_fields: bool | None = ...,
+) -> Callable[[_V2BeforeAfterOrPlainValidatorType], _V2BeforeAfterOrPlainValidatorType]:
+    ...
+
+
+@overload
+def field_validator(
+    __field: str,
+    *fields: str,
+    mode: Literal['wrap'],
+    check_fields: bool | None = ...,
+) -> Callable[[_V2WrapValidatorType], _V2WrapValidatorType]:
+    ...
+
+
+FieldValidatorModes: TypeAlias = Literal['before', 'after', 'wrap', 'plain']
+
+
+def field_validator(
+    __field: str,
+    *fields: str,
+    mode: FieldValidatorModes = 'after',
+    check_fields: bool | None = None,
+) -> Callable[[Any], Any]:
+    """Usage docs: https://docs.pydantic.dev/2.6/concepts/validators/#field-validators
+
+    Decorate methods on the class indicating that they should be used to validate fields.
+
+    Example usage:
+    ```py
+    from typing import Any
+
+    from pydantic import (
+        BaseModel,
+        ValidationError,
+        field_validator,
+    )
+
+    class Model(BaseModel):
+        a: str
+
+        @field_validator('a')
+        @classmethod
+        def ensure_foobar(cls, v: Any):
+            if 'foobar' not in v:
+                raise ValueError('"foobar" not found in a')
+            return v
+
+    print(repr(Model(a='this is foobar good')))
+    #> Model(a='this is foobar good')
+
+    try:
+        Model(a='snap')
+    except ValidationError as exc_info:
+        print(exc_info)
+        '''
+        1 validation error for Model
+        a
+          Value error, "foobar" not found in a [type=value_error, input_value='snap', input_type=str]
+        '''
+    ```
+
+    For more in depth examples, see [Field Validators](../concepts/validators.md#field-validators).
+
+    Args:
+        __field: The first field the `field_validator` should be called on; this is separate
+            from `fields` to ensure an error is raised if you don't pass at least one.
+        *fields: Additional field(s) the `field_validator` should be called on.
+        mode: Specifies whether to validate the fields before or after validation.
+        check_fields: Whether to check that the fields actually exist on the model.
+
+    Returns:
+        A decorator that can be used to decorate a function to be used as a field_validator.
+
+    Raises:
+        PydanticUserError:
+            - If `@field_validator` is used bare (with no fields).
+            - If the args passed to `@field_validator` as fields are not strings.
+            - If `@field_validator` applied to instance methods.
+    """
+    if isinstance(__field, FunctionType):
+        raise PydanticUserError(
+            '`@field_validator` should be used with fields and keyword arguments, not bare. '
+            "E.g. usage should be `@validator('<field_name>', ...)`",
+            code='validator-no-fields',
+        )
+    fields = __field, *fields
+    if not all(isinstance(field, str) for field in fields):
+        raise PydanticUserError(
+            '`@field_validator` fields should be passed as separate string args. '
+            "E.g. usage should be `@validator('<field_name_1>', '<field_name_2>', ...)`",
+            code='validator-invalid-fields',
+        )
+
+    def dec(
+        f: Callable[..., Any] | staticmethod[Any, Any] | classmethod[Any, Any, Any],
+    ) -> _decorators.PydanticDescriptorProxy[Any]:
+        if _decorators.is_instance_method_from_sig(f):
+            raise PydanticUserError(
+                '`@field_validator` cannot be applied to instance methods', code='validator-instance-method'
+            )
+
+        # auto apply the @classmethod decorator
+        f = _decorators.ensure_classmethod_based_on_signature(f)
+
+        dec_info = _decorators.FieldValidatorDecoratorInfo(fields=fields, mode=mode, check_fields=check_fields)
+        return _decorators.PydanticDescriptorProxy(f, dec_info)
+
+    return dec
+
+
+_ModelType = TypeVar('_ModelType')
+_ModelTypeCo = TypeVar('_ModelTypeCo', covariant=True)
+
+
+class ModelWrapValidatorHandler(_core_schema.ValidatorFunctionWrapHandler, Protocol[_ModelTypeCo]):
+    """@model_validator decorated function handler argument type. This is used when `mode='wrap'`."""
+
+    def __call__(  # noqa: D102
+        self,
+        value: Any,
+        outer_location: str | int | None = None,
+        /,
+    ) -> _ModelTypeCo:  # pragma: no cover
+        ...
+
+
+class ModelWrapValidatorWithoutInfo(Protocol[_ModelType]):
+    """A @model_validator decorated function signature.
+    This is used when `mode='wrap'` and the function does not have info argument.
+    """
+
+    def __call__(  # noqa: D102
+        self,
+        cls: type[_ModelType],
+        # this can be a dict, a model instance
+        # or anything else that gets passed to validate_python
+        # thus validators _must_ handle all cases
+        value: Any,
+        handler: ModelWrapValidatorHandler[_ModelType],
+        /,
+    ) -> _ModelType:
+        ...
+
+
+class ModelWrapValidator(Protocol[_ModelType]):
+    """A @model_validator decorated function signature. This is used when `mode='wrap'`."""
+
+    def __call__(  # noqa: D102
+        self,
+        cls: type[_ModelType],
+        # this can be a dict, a model instance
+        # or anything else that gets passed to validate_python
+        # thus validators _must_ handle all cases
+        value: Any,
+        handler: ModelWrapValidatorHandler[_ModelType],
+        info: _core_schema.ValidationInfo,
+        /,
+    ) -> _ModelType:
+        ...
+
+
+class FreeModelBeforeValidatorWithoutInfo(Protocol):
+    """A @model_validator decorated function signature.
+    This is used when `mode='before'` and the function does not have info argument.
+    """
+
+    def __call__(  # noqa: D102
+        self,
+        # this can be a dict, a model instance
+        # or anything else that gets passed to validate_python
+        # thus validators _must_ handle all cases
+        value: Any,
+        /,
+    ) -> Any:
+        ...
+
+
+class ModelBeforeValidatorWithoutInfo(Protocol):
+    """A @model_validator decorated function signature.
+    This is used when `mode='before'` and the function does not have info argument.
+    """
+
+    def __call__(  # noqa: D102
+        self,
+        cls: Any,
+        # this can be a dict, a model instance
+        # or anything else that gets passed to validate_python
+        # thus validators _must_ handle all cases
+        value: Any,
+        /,
+    ) -> Any:
+        ...
+
+
+class FreeModelBeforeValidator(Protocol):
+    """A `@model_validator` decorated function signature. This is used when `mode='before'`."""
+
+    def __call__(  # noqa: D102
+        self,
+        # this can be a dict, a model instance
+        # or anything else that gets passed to validate_python
+        # thus validators _must_ handle all cases
+        value: Any,
+        info: _core_schema.ValidationInfo,
+        /,
+    ) -> Any:
+        ...
+
+
+class ModelBeforeValidator(Protocol):
+    """A `@model_validator` decorated function signature. This is used when `mode='before'`."""
+
+    def __call__(  # noqa: D102
+        self,
+        cls: Any,
+        # this can be a dict, a model instance
+        # or anything else that gets passed to validate_python
+        # thus validators _must_ handle all cases
+        value: Any,
+        info: _core_schema.ValidationInfo,
+        /,
+    ) -> Any:
+        ...
+
+
+ModelAfterValidatorWithoutInfo = Callable[[_ModelType], _ModelType]
+"""A `@model_validator` decorated function signature. This is used when `mode='after'` and the function does not
+have info argument.
+"""
+
+ModelAfterValidator = Callable[[_ModelType, _core_schema.ValidationInfo], _ModelType]
+"""A `@model_validator` decorated function signature. This is used when `mode='after'`."""
+
+_AnyModelWrapValidator = Union[ModelWrapValidator[_ModelType], ModelWrapValidatorWithoutInfo[_ModelType]]
+_AnyModeBeforeValidator = Union[
+    FreeModelBeforeValidator, ModelBeforeValidator, FreeModelBeforeValidatorWithoutInfo, ModelBeforeValidatorWithoutInfo
+]
+_AnyModelAfterValidator = Union[ModelAfterValidator[_ModelType], ModelAfterValidatorWithoutInfo[_ModelType]]
+
+
+@overload
+def model_validator(
+    *,
+    mode: Literal['wrap'],
+) -> Callable[
+    [_AnyModelWrapValidator[_ModelType]], _decorators.PydanticDescriptorProxy[_decorators.ModelValidatorDecoratorInfo]
+]:
+    ...
+
+
+@overload
+def model_validator(
+    *,
+    mode: Literal['before'],
+) -> Callable[[_AnyModeBeforeValidator], _decorators.PydanticDescriptorProxy[_decorators.ModelValidatorDecoratorInfo]]:
+    ...
+
+
+@overload
+def model_validator(
+    *,
+    mode: Literal['after'],
+) -> Callable[
+    [_AnyModelAfterValidator[_ModelType]], _decorators.PydanticDescriptorProxy[_decorators.ModelValidatorDecoratorInfo]
+]:
+    ...
+
+
+def model_validator(
+    *,
+    mode: Literal['wrap', 'before', 'after'],
+) -> Any:
+    """Usage docs: https://docs.pydantic.dev/2.6/concepts/validators/#model-validators
+
+    Decorate model methods for validation purposes.
+
+    Example usage:
+    ```py
+    from typing_extensions import Self
+
+    from pydantic import BaseModel, ValidationError, model_validator
+
+    class Square(BaseModel):
+        width: float
+        height: float
+
+        @model_validator(mode='after')
+        def verify_square(self) -> Self:
+            if self.width != self.height:
+                raise ValueError('width and height do not match')
+            return self
+
+    s = Square(width=1, height=1)
+    print(repr(s))
+    #> Square(width=1.0, height=1.0)
+
+    try:
+        Square(width=1, height=2)
+    except ValidationError as e:
+        print(e)
+        '''
+        1 validation error for Square
+          Value error, width and height do not match [type=value_error, input_value={'width': 1, 'height': 2}, input_type=dict]
+        '''
+    ```
+
+    For more in depth examples, see [Model Validators](../concepts/validators.md#model-validators).
+
+    Args:
+        mode: A required string literal that specifies the validation mode.
+            It can be one of the following: 'wrap', 'before', or 'after'.
+
+    Returns:
+        A decorator that can be used to decorate a function to be used as a model validator.
+    """
+
+    def dec(f: Any) -> _decorators.PydanticDescriptorProxy[Any]:
+        # auto apply the @classmethod decorator
+        f = _decorators.ensure_classmethod_based_on_signature(f)
+        dec_info = _decorators.ModelValidatorDecoratorInfo(mode=mode)
+        return _decorators.PydanticDescriptorProxy(f, dec_info)
+
+    return dec
+
+
+AnyType = TypeVar('AnyType')
+
+
+if TYPE_CHECKING:
+    # If we add configurable attributes to IsInstance, we'd probably need to stop hiding it from type checkers like this
+    InstanceOf = Annotated[AnyType, ...]  # `IsInstance[Sequence]` will be recognized by type checkers as `Sequence`
+
+else:
+
+    @dataclasses.dataclass(**_internal_dataclass.slots_true)
+    class InstanceOf:
+        '''Generic type for annotating a type that is an instance of a given class.
+
+        Example:
+            ```py
+            from pydantic import BaseModel, InstanceOf
+
+            class Foo:
+                ...
+
+            class Bar(BaseModel):
+                foo: InstanceOf[Foo]
+
+            Bar(foo=Foo())
+            try:
+                Bar(foo=42)
+            except ValidationError as e:
+                print(e)
+                """
+                [
+                │   {
+                │   │   'type': 'is_instance_of',
+                │   │   'loc': ('foo',),
+                │   │   'msg': 'Input should be an instance of Foo',
+                │   │   'input': 42,
+                │   │   'ctx': {'class': 'Foo'},
+                │   │   'url': 'https://errors.pydantic.dev/0.38.0/v/is_instance_of'
+                │   }
+                ]
+                """
+            ```
+        '''
+
+        @classmethod
+        def __class_getitem__(cls, item: AnyType) -> AnyType:
+            return Annotated[item, cls()]
+
+        @classmethod
+        def __get_pydantic_core_schema__(cls, source: Any, handler: GetCoreSchemaHandler) -> core_schema.CoreSchema:
+            from pydantic import PydanticSchemaGenerationError
+
+            # use the generic _origin_ as the second argument to isinstance when appropriate
+            instance_of_schema = core_schema.is_instance_schema(_generics.get_origin(source) or source)
+
+            try:
+                # Try to generate the "standard" schema, which will be used when loading from JSON
+                original_schema = handler(source)
+            except PydanticSchemaGenerationError:
+                # If that fails, just produce a schema that can validate from python
+                return instance_of_schema
+            else:
+                # Use the "original" approach to serialization
+                instance_of_schema['serialization'] = core_schema.wrap_serializer_function_ser_schema(
+                    function=lambda v, h: h(v), schema=original_schema
+                )
+                return core_schema.json_or_python_schema(python_schema=instance_of_schema, json_schema=original_schema)
+
+        __hash__ = object.__hash__
+
+
+if TYPE_CHECKING:
+    SkipValidation = Annotated[AnyType, ...]  # SkipValidation[list[str]] will be treated by type checkers as list[str]
+else:
+
+    @dataclasses.dataclass(**_internal_dataclass.slots_true)
+    class SkipValidation:
+        """If this is applied as an annotation (e.g., via `x: Annotated[int, SkipValidation]`), validation will be
+            skipped. You can also use `SkipValidation[int]` as a shorthand for `Annotated[int, SkipValidation]`.
+
+        This can be useful if you want to use a type annotation for documentation/IDE/type-checking purposes,
+        and know that it is safe to skip validation for one or more of the fields.
+
+        Because this converts the validation schema to `any_schema`, subsequent annotation-applied transformations
+        may not have the expected effects. Therefore, when used, this annotation should generally be the final
+        annotation applied to a type.
+        """
+
+        def __class_getitem__(cls, item: Any) -> Any:
+            return Annotated[item, SkipValidation()]
+
+        @classmethod
+        def __get_pydantic_core_schema__(cls, source: Any, handler: GetCoreSchemaHandler) -> core_schema.CoreSchema:
+            original_schema = handler(source)
+            metadata = _core_metadata.build_metadata_dict(js_annotation_functions=[lambda _c, h: h(original_schema)])
+            return core_schema.any_schema(
+                metadata=metadata,
+                serialization=core_schema.wrap_serializer_function_ser_schema(
+                    function=lambda v, h: h(v), schema=original_schema
+                ),
+            )
+
+        __hash__ = object.__hash__
diff --git a/lib/pydantic/generics.py b/lib/pydantic/generics.py
index a3f52bfe..5f6f7f7a 100644
--- a/lib/pydantic/generics.py
+++ b/lib/pydantic/generics.py
@@ -1,364 +1,4 @@
-import sys
-import typing
-from typing import (
-    TYPE_CHECKING,
-    Any,
-    ClassVar,
-    Dict,
-    Generic,
-    Iterator,
-    List,
-    Mapping,
-    Optional,
-    Tuple,
-    Type,
-    TypeVar,
-    Union,
-    cast,
-)
+"""The `generics` module is a backport module from V1."""
+from ._migration import getattr_migration
 
-from typing_extensions import Annotated
-
-from .class_validators import gather_all_validators
-from .fields import DeferredType
-from .main import BaseModel, create_model
-from .types import JsonWrapper
-from .typing import display_as_type, get_all_type_hints, get_args, get_origin, typing_base
-from .utils import LimitedDict, all_identical, lenient_issubclass
-
-GenericModelT = TypeVar('GenericModelT', bound='GenericModel')
-TypeVarType = Any  # since mypy doesn't allow the use of TypeVar as a type
-
-Parametrization = Mapping[TypeVarType, Type[Any]]
-
-_generic_types_cache: LimitedDict[Tuple[Type[Any], Union[Any, Tuple[Any, ...]]], Type[BaseModel]] = LimitedDict()
-# _assigned_parameters is a Mapping from parametrized version of generic models to assigned types of parametrizations
-# as captured during construction of the class (not instances).
-# E.g., for generic model `Model[A, B]`, when parametrized model `Model[int, str]` is created,
-# `Model[int, str]`: {A: int, B: str}` will be stored in `_assigned_parameters`.
-# (This information is only otherwise available after creation from the class name string).
-_assigned_parameters: LimitedDict[Type[Any], Parametrization] = LimitedDict()
-
-
-class GenericModel(BaseModel):
-    __slots__ = ()
-    __concrete__: ClassVar[bool] = False
-
-    if TYPE_CHECKING:
-        # Putting this in a TYPE_CHECKING block allows us to replace `if Generic not in cls.__bases__` with
-        # `not hasattr(cls, "__parameters__")`. This means we don't need to force non-concrete subclasses of
-        # `GenericModel` to also inherit from `Generic`, which would require changes to the use of `create_model` below.
-        __parameters__: ClassVar[Tuple[TypeVarType, ...]]
-
-    # Setting the return type as Type[Any] instead of Type[BaseModel] prevents PyCharm warnings
-    def __class_getitem__(cls: Type[GenericModelT], params: Union[Type[Any], Tuple[Type[Any], ...]]) -> Type[Any]:
-        """Instantiates a new class from a generic class `cls` and type variables `params`.
-
-        :param params: Tuple of types the class . Given a generic class
-            `Model` with 2 type variables and a concrete model `Model[str, int]`,
-            the value `(str, int)` would be passed to `params`.
-        :return: New model class inheriting from `cls` with instantiated
-            types described by `params`. If no parameters are given, `cls` is
-            returned as is.
-
-        """
-
-        def _cache_key(_params: Any) -> Tuple[Type[GenericModelT], Any, Tuple[Any, ...]]:
-            return cls, _params, get_args(_params)
-
-        cached = _generic_types_cache.get(_cache_key(params))
-        if cached is not None:
-            return cached
-        if cls.__concrete__ and Generic not in cls.__bases__:
-            raise TypeError('Cannot parameterize a concrete instantiation of a generic model')
-        if not isinstance(params, tuple):
-            params = (params,)
-        if cls is GenericModel and any(isinstance(param, TypeVar) for param in params):
-            raise TypeError('Type parameters should be placed on typing.Generic, not GenericModel')
-        if not hasattr(cls, '__parameters__'):
-            raise TypeError(f'Type {cls.__name__} must inherit from typing.Generic before being parameterized')
-
-        check_parameters_count(cls, params)
-        # Build map from generic typevars to passed params
-        typevars_map: Dict[TypeVarType, Type[Any]] = dict(zip(cls.__parameters__, params))
-        if all_identical(typevars_map.keys(), typevars_map.values()) and typevars_map:
-            return cls  # if arguments are equal to parameters it's the same object
-
-        # Create new model with original model as parent inserting fields with DeferredType.
-        model_name = cls.__concrete_name__(params)
-        validators = gather_all_validators(cls)
-
-        type_hints = get_all_type_hints(cls).items()
-        instance_type_hints = {k: v for k, v in type_hints if get_origin(v) is not ClassVar}
-
-        fields = {k: (DeferredType(), cls.__fields__[k].field_info) for k in instance_type_hints if k in cls.__fields__}
-
-        model_module, called_globally = get_caller_frame_info()
-        created_model = cast(
-            Type[GenericModel],  # casting ensures mypy is aware of the __concrete__ and __parameters__ attributes
-            create_model(
-                model_name,
-                __module__=model_module or cls.__module__,
-                __base__=(cls,) + tuple(cls.__parameterized_bases__(typevars_map)),
-                __config__=None,
-                __validators__=validators,
-                __cls_kwargs__=None,
-                **fields,
-            ),
-        )
-
-        _assigned_parameters[created_model] = typevars_map
-
-        if called_globally:  # create global reference and therefore allow pickling
-            object_by_reference = None
-            reference_name = model_name
-            reference_module_globals = sys.modules[created_model.__module__].__dict__
-            while object_by_reference is not created_model:
-                object_by_reference = reference_module_globals.setdefault(reference_name, created_model)
-                reference_name += '_'
-
-        created_model.Config = cls.Config
-
-        # Find any typevars that are still present in the model.
-        # If none are left, the model is fully "concrete", otherwise the new
-        # class is a generic class as well taking the found typevars as
-        # parameters.
-        new_params = tuple(
-            {param: None for param in iter_contained_typevars(typevars_map.values())}
-        )  # use dict as ordered set
-        created_model.__concrete__ = not new_params
-        if new_params:
-            created_model.__parameters__ = new_params
-
-        # Save created model in cache so we don't end up creating duplicate
-        # models that should be identical.
-        _generic_types_cache[_cache_key(params)] = created_model
-        if len(params) == 1:
-            _generic_types_cache[_cache_key(params[0])] = created_model
-
-        # Recursively walk class type hints and replace generic typevars
-        # with concrete types that were passed.
-        _prepare_model_fields(created_model, fields, instance_type_hints, typevars_map)
-
-        return created_model
-
-    @classmethod
-    def __concrete_name__(cls: Type[Any], params: Tuple[Type[Any], ...]) -> str:
-        """Compute class name for child classes.
-
-        :param params: Tuple of types the class . Given a generic class
-            `Model` with 2 type variables and a concrete model `Model[str, int]`,
-            the value `(str, int)` would be passed to `params`.
-        :return: String representing a the new class where `params` are
-            passed to `cls` as type variables.
-
-        This method can be overridden to achieve a custom naming scheme for GenericModels.
-        """
-        param_names = [display_as_type(param) for param in params]
-        params_component = ', '.join(param_names)
-        return f'{cls.__name__}[{params_component}]'
-
-    @classmethod
-    def __parameterized_bases__(cls, typevars_map: Parametrization) -> Iterator[Type[Any]]:
-        """
-        Returns unbound bases of cls parameterised to given type variables
-
-        :param typevars_map: Dictionary of type applications for binding subclasses.
-            Given a generic class `Model` with 2 type variables [S, T]
-            and a concrete model `Model[str, int]`,
-            the value `{S: str, T: int}` would be passed to `typevars_map`.
-        :return: an iterator of generic sub classes, parameterised by `typevars_map`
-            and other assigned parameters of `cls`
-
-        e.g.:
-        ```
-        class A(GenericModel, Generic[T]):
-            ...
-
-        class B(A[V], Generic[V]):
-            ...
-
-        assert A[int] in B.__parameterized_bases__({V: int})
-        ```
-        """
-
-        def build_base_model(
-            base_model: Type[GenericModel], mapped_types: Parametrization
-        ) -> Iterator[Type[GenericModel]]:
-            base_parameters = tuple(mapped_types[param] for param in base_model.__parameters__)
-            parameterized_base = base_model.__class_getitem__(base_parameters)
-            if parameterized_base is base_model or parameterized_base is cls:
-                # Avoid duplication in MRO
-                return
-            yield parameterized_base
-
-        for base_model in cls.__bases__:
-            if not issubclass(base_model, GenericModel):
-                # not a class that can be meaningfully parameterized
-                continue
-            elif not getattr(base_model, '__parameters__', None):
-                # base_model is "GenericModel"  (and has no __parameters__)
-                # or
-                # base_model is already concrete, and will be included transitively via cls.
-                continue
-            elif cls in _assigned_parameters:
-                if base_model in _assigned_parameters:
-                    # cls is partially parameterised but not from base_model
-                    # e.g. cls = B[S], base_model = A[S]
-                    # B[S][int] should subclass A[int],  (and will be transitively via B[int])
-                    # but it's not viable to consistently subclass types with arbitrary construction
-                    # So don't attempt to include A[S][int]
-                    continue
-                else:  # base_model not in _assigned_parameters:
-                    # cls is partially parameterized, base_model is original generic
-                    # e.g.  cls = B[str, T], base_model = B[S, T]
-                    # Need to determine the mapping for the base_model parameters
-                    mapped_types: Parametrization = {
-                        key: typevars_map.get(value, value) for key, value in _assigned_parameters[cls].items()
-                    }
-                    yield from build_base_model(base_model, mapped_types)
-            else:
-                # cls is base generic, so base_class has a distinct base
-                # can construct the Parameterised base model using typevars_map directly
-                yield from build_base_model(base_model, typevars_map)
-
-
-def replace_types(type_: Any, type_map: Mapping[Any, Any]) -> Any:
-    """Return type with all occurrences of `type_map` keys recursively replaced with their values.
-
-    :param type_: Any type, class or generic alias
-    :param type_map: Mapping from `TypeVar` instance to concrete types.
-    :return: New type representing the basic structure of `type_` with all
-        `typevar_map` keys recursively replaced.
-
-    >>> replace_types(Tuple[str, Union[List[str], float]], {str: int})
-    Tuple[int, Union[List[int], float]]
-
-    """
-    if not type_map:
-        return type_
-
-    type_args = get_args(type_)
-    origin_type = get_origin(type_)
-
-    if origin_type is Annotated:
-        annotated_type, *annotations = type_args
-        return Annotated[replace_types(annotated_type, type_map), tuple(annotations)]
-
-    # Having type args is a good indicator that this is a typing module
-    # class instantiation or a generic alias of some sort.
-    if type_args:
-        resolved_type_args = tuple(replace_types(arg, type_map) for arg in type_args)
-        if all_identical(type_args, resolved_type_args):
-            # If all arguments are the same, there is no need to modify the
-            # type or create a new object at all
-            return type_
-        if (
-            origin_type is not None
-            and isinstance(type_, typing_base)
-            and not isinstance(origin_type, typing_base)
-            and getattr(type_, '_name', None) is not None
-        ):
-            # In python < 3.9 generic aliases don't exist so any of these like `list`,
-            # `type` or `collections.abc.Callable` need to be translated.
-            # See: https://www.python.org/dev/peps/pep-0585
-            origin_type = getattr(typing, type_._name)
-        assert origin_type is not None
-        return origin_type[resolved_type_args]
-
-    # We handle pydantic generic models separately as they don't have the same
-    # semantics as "typing" classes or generic aliases
-    if not origin_type and lenient_issubclass(type_, GenericModel) and not type_.__concrete__:
-        type_args = type_.__parameters__
-        resolved_type_args = tuple(replace_types(t, type_map) for t in type_args)
-        if all_identical(type_args, resolved_type_args):
-            return type_
-        return type_[resolved_type_args]
-
-    # Handle special case for typehints that can have lists as arguments.
-    # `typing.Callable[[int, str], int]` is an example for this.
-    if isinstance(type_, (List, list)):
-        resolved_list = list(replace_types(element, type_map) for element in type_)
-        if all_identical(type_, resolved_list):
-            return type_
-        return resolved_list
-
-    # For JsonWrapperValue, need to handle its inner type to allow correct parsing
-    # of generic Json arguments like Json[T]
-    if not origin_type and lenient_issubclass(type_, JsonWrapper):
-        type_.inner_type = replace_types(type_.inner_type, type_map)
-        return type_
-
-    # If all else fails, we try to resolve the type directly and otherwise just
-    # return the input with no modifications.
-    return type_map.get(type_, type_)
-
-
-def check_parameters_count(cls: Type[GenericModel], parameters: Tuple[Any, ...]) -> None:
-    actual = len(parameters)
-    expected = len(cls.__parameters__)
-    if actual != expected:
-        description = 'many' if actual > expected else 'few'
-        raise TypeError(f'Too {description} parameters for {cls.__name__}; actual {actual}, expected {expected}')
-
-
-DictValues: Type[Any] = {}.values().__class__
-
-
-def iter_contained_typevars(v: Any) -> Iterator[TypeVarType]:
-    """Recursively iterate through all subtypes and type args of `v` and yield any typevars that are found."""
-    if isinstance(v, TypeVar):
-        yield v
-    elif hasattr(v, '__parameters__') and not get_origin(v) and lenient_issubclass(v, GenericModel):
-        yield from v.__parameters__
-    elif isinstance(v, (DictValues, list)):
-        for var in v:
-            yield from iter_contained_typevars(var)
-    else:
-        args = get_args(v)
-        for arg in args:
-            yield from iter_contained_typevars(arg)
-
-
-def get_caller_frame_info() -> Tuple[Optional[str], bool]:
-    """
-    Used inside a function to check whether it was called globally
-
-    Will only work against non-compiled code, therefore used only in pydantic.generics
-
-    :returns Tuple[module_name, called_globally]
-    """
-    try:
-        previous_caller_frame = sys._getframe(2)
-    except ValueError as e:
-        raise RuntimeError('This function must be used inside another function') from e
-    except AttributeError:  # sys module does not have _getframe function, so there's nothing we can do about it
-        return None, False
-    frame_globals = previous_caller_frame.f_globals
-    return frame_globals.get('__name__'), previous_caller_frame.f_locals is frame_globals
-
-
-def _prepare_model_fields(
-    created_model: Type[GenericModel],
-    fields: Mapping[str, Any],
-    instance_type_hints: Mapping[str, type],
-    typevars_map: Mapping[Any, type],
-) -> None:
-    """
-    Replace DeferredType fields with concrete type hints and prepare them.
-    """
-
-    for key, field in created_model.__fields__.items():
-        if key not in fields:
-            assert field.type_.__class__ is not DeferredType
-            # https://github.com/nedbat/coveragepy/issues/198
-            continue  # pragma: no cover
-
-        assert field.type_.__class__ is DeferredType, field.type_.__class__
-
-        field_type_hint = instance_type_hints[key]
-        concrete_type = replace_types(field_type_hint, typevars_map)
-        field.type_ = concrete_type
-        field.outer_type_ = concrete_type
-        field.prepare()
-        created_model.__annotations__[key] = concrete_type
+__getattr__ = getattr_migration(__name__)
diff --git a/lib/pydantic/json.py b/lib/pydantic/json.py
index b358b850..020fb6d2 100644
--- a/lib/pydantic/json.py
+++ b/lib/pydantic/json.py
@@ -1,112 +1,4 @@
-import datetime
-from collections import deque
-from decimal import Decimal
-from enum import Enum
-from ipaddress import IPv4Address, IPv4Interface, IPv4Network, IPv6Address, IPv6Interface, IPv6Network
-from pathlib import Path
-from re import Pattern
-from types import GeneratorType
-from typing import Any, Callable, Dict, Type, Union
-from uuid import UUID
+"""The `json` module is a backport module from V1."""
+from ._migration import getattr_migration
 
-from .color import Color
-from .networks import NameEmail
-from .types import SecretBytes, SecretStr
-
-__all__ = 'pydantic_encoder', 'custom_pydantic_encoder', 'timedelta_isoformat'
-
-
-def isoformat(o: Union[datetime.date, datetime.time]) -> str:
-    return o.isoformat()
-
-
-def decimal_encoder(dec_value: Decimal) -> Union[int, float]:
-    """
-    Encodes a Decimal as int of there's no exponent, otherwise float
-
-    This is useful when we use ConstrainedDecimal to represent Numeric(x,0)
-    where a integer (but not int typed) is used. Encoding this as a float
-    results in failed round-tripping between encode and parse.
-    Our Id type is a prime example of this.
-
-    >>> decimal_encoder(Decimal("1.0"))
-    1.0
-
-    >>> decimal_encoder(Decimal("1"))
-    1
-    """
-    if dec_value.as_tuple().exponent >= 0:
-        return int(dec_value)
-    else:
-        return float(dec_value)
-
-
-ENCODERS_BY_TYPE: Dict[Type[Any], Callable[[Any], Any]] = {
-    bytes: lambda o: o.decode(),
-    Color: str,
-    datetime.date: isoformat,
-    datetime.datetime: isoformat,
-    datetime.time: isoformat,
-    datetime.timedelta: lambda td: td.total_seconds(),
-    Decimal: decimal_encoder,
-    Enum: lambda o: o.value,
-    frozenset: list,
-    deque: list,
-    GeneratorType: list,
-    IPv4Address: str,
-    IPv4Interface: str,
-    IPv4Network: str,
-    IPv6Address: str,
-    IPv6Interface: str,
-    IPv6Network: str,
-    NameEmail: str,
-    Path: str,
-    Pattern: lambda o: o.pattern,
-    SecretBytes: str,
-    SecretStr: str,
-    set: list,
-    UUID: str,
-}
-
-
-def pydantic_encoder(obj: Any) -> Any:
-    from dataclasses import asdict, is_dataclass
-
-    from .main import BaseModel
-
-    if isinstance(obj, BaseModel):
-        return obj.dict()
-    elif is_dataclass(obj):
-        return asdict(obj)
-
-    # Check the class type and its superclasses for a matching encoder
-    for base in obj.__class__.__mro__[:-1]:
-        try:
-            encoder = ENCODERS_BY_TYPE[base]
-        except KeyError:
-            continue
-        return encoder(obj)
-    else:  # We have exited the for loop without finding a suitable encoder
-        raise TypeError(f"Object of type '{obj.__class__.__name__}' is not JSON serializable")
-
-
-def custom_pydantic_encoder(type_encoders: Dict[Any, Callable[[Type[Any]], Any]], obj: Any) -> Any:
-    # Check the class type and its superclasses for a matching encoder
-    for base in obj.__class__.__mro__[:-1]:
-        try:
-            encoder = type_encoders[base]
-        except KeyError:
-            continue
-
-        return encoder(obj)
-    else:  # We have exited the for loop without finding a suitable encoder
-        return pydantic_encoder(obj)
-
-
-def timedelta_isoformat(td: datetime.timedelta) -> str:
-    """
-    ISO 8601 encoding for Python timedelta object.
-    """
-    minutes, seconds = divmod(td.seconds, 60)
-    hours, minutes = divmod(minutes, 60)
-    return f'{"-" if td.days < 0 else ""}P{abs(td.days)}DT{hours:d}H{minutes:d}M{seconds:d}.{td.microseconds:06d}S'
+__getattr__ = getattr_migration(__name__)
diff --git a/lib/pydantic/json_schema.py b/lib/pydantic/json_schema.py
new file mode 100644
index 00000000..eee9e60e
--- /dev/null
+++ b/lib/pydantic/json_schema.py
@@ -0,0 +1,2425 @@
+"""
+Usage docs: https://docs.pydantic.dev/2.5/concepts/json_schema/
+
+The `json_schema` module contains classes and functions to allow the way [JSON Schema](https://json-schema.org/)
+is generated to be customized.
+
+In general you shouldn't need to use this module directly; instead, you can
+[`BaseModel.model_json_schema`][pydantic.BaseModel.model_json_schema] and
+[`TypeAdapter.json_schema`][pydantic.TypeAdapter.json_schema].
+"""
+from __future__ import annotations as _annotations
+
+import dataclasses
+import inspect
+import math
+import re
+import warnings
+from collections import defaultdict
+from copy import deepcopy
+from dataclasses import is_dataclass
+from enum import Enum
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    Counter,
+    Dict,
+    Hashable,
+    Iterable,
+    NewType,
+    Sequence,
+    Tuple,
+    TypeVar,
+    Union,
+    cast,
+)
+
+import pydantic_core
+from pydantic_core import CoreSchema, PydanticOmit, core_schema, to_jsonable_python
+from pydantic_core.core_schema import ComputedField
+from typing_extensions import Annotated, Literal, TypeAlias, assert_never, deprecated, final
+
+from pydantic.warnings import PydanticDeprecatedSince26
+
+from ._internal import (
+    _config,
+    _core_metadata,
+    _core_utils,
+    _decorators,
+    _internal_dataclass,
+    _mock_val_ser,
+    _schema_generation_shared,
+    _typing_extra,
+)
+from .annotated_handlers import GetJsonSchemaHandler
+from .config import JsonDict, JsonSchemaExtraCallable, JsonValue
+from .errors import PydanticInvalidForJsonSchema, PydanticUserError
+
+if TYPE_CHECKING:
+    from . import ConfigDict
+    from ._internal._core_utils import CoreSchemaField, CoreSchemaOrField
+    from ._internal._dataclasses import PydanticDataclass
+    from ._internal._schema_generation_shared import GetJsonSchemaFunction
+    from .main import BaseModel
+
+
+CoreSchemaOrFieldType = Literal[core_schema.CoreSchemaType, core_schema.CoreSchemaFieldType]
+"""
+A type alias for defined schema types that represents a union of
+`core_schema.CoreSchemaType` and
+`core_schema.CoreSchemaFieldType`.
+"""
+
+JsonSchemaValue = Dict[str, Any]
+"""
+A type alias for a JSON schema value. This is a dictionary of string keys to arbitrary JSON values.
+"""
+
+JsonSchemaMode = Literal['validation', 'serialization']
+"""
+A type alias that represents the mode of a JSON schema; either 'validation' or 'serialization'.
+
+For some types, the inputs to validation differ from the outputs of serialization. For example,
+computed fields will only be present when serializing, and should not be provided when
+validating. This flag provides a way to indicate whether you want the JSON schema required
+for validation inputs, or that will be matched by serialization outputs.
+"""
+
+_MODE_TITLE_MAPPING: dict[JsonSchemaMode, str] = {'validation': 'Input', 'serialization': 'Output'}
+
+
+def update_json_schema(schema: JsonSchemaValue, updates: dict[str, Any]) -> JsonSchemaValue:
+    """Update a JSON schema in-place by providing a dictionary of updates.
+
+    This function sets the provided key-value pairs in the schema and returns the updated schema.
+
+    Args:
+        schema: The JSON schema to update.
+        updates: A dictionary of key-value pairs to set in the schema.
+
+    Returns:
+        The updated JSON schema.
+    """
+    schema.update(updates)
+    return schema
+
+
+JsonSchemaWarningKind = Literal['skipped-choice', 'non-serializable-default']
+"""
+A type alias representing the kinds of warnings that can be emitted during JSON schema generation.
+
+See [`GenerateJsonSchema.render_warning_message`][pydantic.json_schema.GenerateJsonSchema.render_warning_message]
+for more details.
+"""
+
+
+class PydanticJsonSchemaWarning(UserWarning):
+    """This class is used to emit warnings produced during JSON schema generation.
+    See the [`GenerateJsonSchema.emit_warning`][pydantic.json_schema.GenerateJsonSchema.emit_warning] and
+    [`GenerateJsonSchema.render_warning_message`][pydantic.json_schema.GenerateJsonSchema.render_warning_message]
+    methods for more details; these can be overridden to control warning behavior.
+    """
+
+
+# ##### JSON Schema Generation #####
+DEFAULT_REF_TEMPLATE = '#/$defs/{model}'
+"""The default format string used to generate reference names."""
+
+# There are three types of references relevant to building JSON schemas:
+#   1. core_schema "ref" values; these are not exposed as part of the JSON schema
+#       * these might look like the fully qualified path of a model, its id, or something similar
+CoreRef = NewType('CoreRef', str)
+#   2. keys of the "definitions" object that will eventually go into the JSON schema
+#       * by default, these look like "MyModel", though may change in the presence of collisions
+#       * eventually, we may want to make it easier to modify the way these names are generated
+DefsRef = NewType('DefsRef', str)
+#   3. the values corresponding to the "$ref" key in the schema
+#       * By default, these look like "#/$defs/MyModel", as in {"$ref": "#/$defs/MyModel"}
+JsonRef = NewType('JsonRef', str)
+
+CoreModeRef = Tuple[CoreRef, JsonSchemaMode]
+JsonSchemaKeyT = TypeVar('JsonSchemaKeyT', bound=Hashable)
+
+
+@dataclasses.dataclass(**_internal_dataclass.slots_true)
+class _DefinitionsRemapping:
+    defs_remapping: dict[DefsRef, DefsRef]
+    json_remapping: dict[JsonRef, JsonRef]
+
+    @staticmethod
+    def from_prioritized_choices(
+        prioritized_choices: dict[DefsRef, list[DefsRef]],
+        defs_to_json: dict[DefsRef, JsonRef],
+        definitions: dict[DefsRef, JsonSchemaValue],
+    ) -> _DefinitionsRemapping:
+        """
+        This function should produce a remapping that replaces complex DefsRef with the simpler ones from the
+        prioritized_choices such that applying the name remapping would result in an equivalent JSON schema.
+        """
+        # We need to iteratively simplify the definitions until we reach a fixed point.
+        # The reason for this is that outer definitions may reference inner definitions that get simplified
+        # into an equivalent reference, and the outer definitions won't be equivalent until we've simplified
+        # the inner definitions.
+        copied_definitions = deepcopy(definitions)
+        definitions_schema = {'$defs': copied_definitions}
+        for _iter in range(100):  # prevent an infinite loop in the case of a bug, 100 iterations should be enough
+            # For every possible remapped DefsRef, collect all schemas that that DefsRef might be used for:
+            schemas_for_alternatives: dict[DefsRef, list[JsonSchemaValue]] = defaultdict(list)
+            for defs_ref in copied_definitions:
+                alternatives = prioritized_choices[defs_ref]
+                for alternative in alternatives:
+                    schemas_for_alternatives[alternative].append(copied_definitions[defs_ref])
+
+            # Deduplicate the schemas for each alternative; the idea is that we only want to remap to a new DefsRef
+            # if it introduces no ambiguity, i.e., there is only one distinct schema for that DefsRef.
+            for defs_ref, schemas in schemas_for_alternatives.items():
+                schemas_for_alternatives[defs_ref] = _deduplicate_schemas(schemas_for_alternatives[defs_ref])
+
+            # Build the remapping
+            defs_remapping: dict[DefsRef, DefsRef] = {}
+            json_remapping: dict[JsonRef, JsonRef] = {}
+            for original_defs_ref in definitions:
+                alternatives = prioritized_choices[original_defs_ref]
+                # Pick the first alternative that has only one schema, since that means there is no collision
+                remapped_defs_ref = next(x for x in alternatives if len(schemas_for_alternatives[x]) == 1)
+                defs_remapping[original_defs_ref] = remapped_defs_ref
+                json_remapping[defs_to_json[original_defs_ref]] = defs_to_json[remapped_defs_ref]
+            remapping = _DefinitionsRemapping(defs_remapping, json_remapping)
+            new_definitions_schema = remapping.remap_json_schema({'$defs': copied_definitions})
+            if definitions_schema == new_definitions_schema:
+                # We've reached the fixed point
+                return remapping
+            definitions_schema = new_definitions_schema
+
+        raise PydanticInvalidForJsonSchema('Failed to simplify the JSON schema definitions')
+
+    def remap_defs_ref(self, ref: DefsRef) -> DefsRef:
+        return self.defs_remapping.get(ref, ref)
+
+    def remap_json_ref(self, ref: JsonRef) -> JsonRef:
+        return self.json_remapping.get(ref, ref)
+
+    def remap_json_schema(self, schema: Any) -> Any:
+        """
+        Recursively update the JSON schema replacing all $refs
+        """
+        if isinstance(schema, str):
+            # Note: this may not really be a JsonRef; we rely on having no collisions between JsonRefs and other strings
+            return self.remap_json_ref(JsonRef(schema))
+        elif isinstance(schema, list):
+            return [self.remap_json_schema(item) for item in schema]
+        elif isinstance(schema, dict):
+            for key, value in schema.items():
+                if key == '$ref' and isinstance(value, str):
+                    schema['$ref'] = self.remap_json_ref(JsonRef(value))
+                elif key == '$defs':
+                    schema['$defs'] = {
+                        self.remap_defs_ref(DefsRef(key)): self.remap_json_schema(value)
+                        for key, value in schema['$defs'].items()
+                    }
+                else:
+                    schema[key] = self.remap_json_schema(value)
+        return schema
+
+
+class GenerateJsonSchema:
+    """Usage docs: https://docs.pydantic.dev/2.6/concepts/json_schema/#customizing-the-json-schema-generation-process
+
+    A class for generating JSON schemas.
+
+    This class generates JSON schemas based on configured parameters. The default schema dialect
+    is [https://json-schema.org/draft/2020-12/schema](https://json-schema.org/draft/2020-12/schema).
+    The class uses `by_alias` to configure how fields with
+    multiple names are handled and `ref_template` to format reference names.
+
+    Attributes:
+        schema_dialect: The JSON schema dialect used to generate the schema. See
+            [Declaring a Dialect](https://json-schema.org/understanding-json-schema/reference/schema.html#id4)
+            in the JSON Schema documentation for more information about dialects.
+        ignored_warning_kinds: Warnings to ignore when generating the schema. `self.render_warning_message` will
+            do nothing if its argument `kind` is in `ignored_warning_kinds`;
+            this value can be modified on subclasses to easily control which warnings are emitted.
+        by_alias: Whether to use field aliases when generating the schema.
+        ref_template: The format string used when generating reference names.
+        core_to_json_refs: A mapping of core refs to JSON refs.
+        core_to_defs_refs: A mapping of core refs to definition refs.
+        defs_to_core_refs: A mapping of definition refs to core refs.
+        json_to_defs_refs: A mapping of JSON refs to definition refs.
+        definitions: Definitions in the schema.
+
+    Args:
+        by_alias: Whether to use field aliases in the generated schemas.
+        ref_template: The format string to use when generating reference names.
+
+    Raises:
+        JsonSchemaError: If the instance of the class is inadvertently re-used after generating a schema.
+    """
+
+    schema_dialect = 'https://json-schema.org/draft/2020-12/schema'
+
+    # `self.render_warning_message` will do nothing if its argument `kind` is in `ignored_warning_kinds`;
+    # this value can be modified on subclasses to easily control which warnings are emitted
+    ignored_warning_kinds: set[JsonSchemaWarningKind] = {'skipped-choice'}
+
+    def __init__(self, by_alias: bool = True, ref_template: str = DEFAULT_REF_TEMPLATE):
+        self.by_alias = by_alias
+        self.ref_template = ref_template
+
+        self.core_to_json_refs: dict[CoreModeRef, JsonRef] = {}
+        self.core_to_defs_refs: dict[CoreModeRef, DefsRef] = {}
+        self.defs_to_core_refs: dict[DefsRef, CoreModeRef] = {}
+        self.json_to_defs_refs: dict[JsonRef, DefsRef] = {}
+
+        self.definitions: dict[DefsRef, JsonSchemaValue] = {}
+        self._config_wrapper_stack = _config.ConfigWrapperStack(_config.ConfigWrapper({}))
+
+        self._mode: JsonSchemaMode = 'validation'
+
+        # The following includes a mapping of a fully-unique defs ref choice to a list of preferred
+        # alternatives, which are generally simpler, such as only including the class name.
+        # At the end of schema generation, we use these to produce a JSON schema with more human-readable
+        # definitions, which would also work better in a generated OpenAPI client, etc.
+        self._prioritized_defsref_choices: dict[DefsRef, list[DefsRef]] = {}
+        self._collision_counter: dict[str, int] = defaultdict(int)
+        self._collision_index: dict[str, int] = {}
+
+        self._schema_type_to_method = self.build_schema_type_to_method()
+
+        # When we encounter definitions we need to try to build them immediately
+        # so that they are available schemas that reference them
+        # But it's possible that CoreSchema was never going to be used
+        # (e.g. because the CoreSchema that references short circuits is JSON schema generation without needing
+        #  the reference) so instead of failing altogether if we can't build a definition we
+        # store the error raised and re-throw it if we end up needing that def
+        self._core_defs_invalid_for_json_schema: dict[DefsRef, PydanticInvalidForJsonSchema] = {}
+
+        # This changes to True after generating a schema, to prevent issues caused by accidental re-use
+        # of a single instance of a schema generator
+        self._used = False
+
+    @property
+    def _config(self) -> _config.ConfigWrapper:
+        return self._config_wrapper_stack.tail
+
+    @property
+    def mode(self) -> JsonSchemaMode:
+        if self._config.json_schema_mode_override is not None:
+            return self._config.json_schema_mode_override
+        else:
+            return self._mode
+
+    def build_schema_type_to_method(
+        self,
+    ) -> dict[CoreSchemaOrFieldType, Callable[[CoreSchemaOrField], JsonSchemaValue]]:
+        """Builds a dictionary mapping fields to methods for generating JSON schemas.
+
+        Returns:
+            A dictionary containing the mapping of `CoreSchemaOrFieldType` to a handler method.
+
+        Raises:
+            TypeError: If no method has been defined for generating a JSON schema for a given pydantic core schema type.
+        """
+        mapping: dict[CoreSchemaOrFieldType, Callable[[CoreSchemaOrField], JsonSchemaValue]] = {}
+        core_schema_types: list[CoreSchemaOrFieldType] = _typing_extra.all_literal_values(
+            CoreSchemaOrFieldType  # type: ignore
+        )
+        for key in core_schema_types:
+            method_name = f"{key.replace('-', '_')}_schema"
+            try:
+                mapping[key] = getattr(self, method_name)
+            except AttributeError as e:  # pragma: no cover
+                raise TypeError(
+                    f'No method for generating JsonSchema for core_schema.type={key!r} '
+                    f'(expected: {type(self).__name__}.{method_name})'
+                ) from e
+        return mapping
+
+    def generate_definitions(
+        self, inputs: Sequence[tuple[JsonSchemaKeyT, JsonSchemaMode, core_schema.CoreSchema]]
+    ) -> tuple[dict[tuple[JsonSchemaKeyT, JsonSchemaMode], JsonSchemaValue], dict[DefsRef, JsonSchemaValue]]:
+        """Generates JSON schema definitions from a list of core schemas, pairing the generated definitions with a
+        mapping that links the input keys to the definition references.
+
+        Args:
+            inputs: A sequence of tuples, where:
+
+                - The first element is a JSON schema key type.
+                - The second element is the JSON mode: either 'validation' or 'serialization'.
+                - The third element is a core schema.
+
+        Returns:
+            A tuple where:
+
+                - The first element is a dictionary whose keys are tuples of JSON schema key type and JSON mode, and
+                    whose values are the JSON schema corresponding to that pair of inputs. (These schemas may have
+                    JsonRef references to definitions that are defined in the second returned element.)
+                - The second element is a dictionary whose keys are definition references for the JSON schemas
+                    from the first returned element, and whose values are the actual JSON schema definitions.
+
+        Raises:
+            PydanticUserError: Raised if the JSON schema generator has already been used to generate a JSON schema.
+        """
+        if self._used:
+            raise PydanticUserError(
+                'This JSON schema generator has already been used to generate a JSON schema. '
+                f'You must create a new instance of {type(self).__name__} to generate a new JSON schema.',
+                code='json-schema-already-used',
+            )
+
+        for key, mode, schema in inputs:
+            self._mode = mode
+            self.generate_inner(schema)
+
+        definitions_remapping = self._build_definitions_remapping()
+
+        json_schemas_map: dict[tuple[JsonSchemaKeyT, JsonSchemaMode], DefsRef] = {}
+        for key, mode, schema in inputs:
+            self._mode = mode
+            json_schema = self.generate_inner(schema)
+            json_schemas_map[(key, mode)] = definitions_remapping.remap_json_schema(json_schema)
+
+        json_schema = {'$defs': self.definitions}
+        json_schema = definitions_remapping.remap_json_schema(json_schema)
+        self._used = True
+        return json_schemas_map, _sort_json_schema(json_schema['$defs'])  # type: ignore
+
+    def generate(self, schema: CoreSchema, mode: JsonSchemaMode = 'validation') -> JsonSchemaValue:
+        """Generates a JSON schema for a specified schema in a specified mode.
+
+        Args:
+            schema: A Pydantic model.
+            mode: The mode in which to generate the schema. Defaults to 'validation'.
+
+        Returns:
+            A JSON schema representing the specified schema.
+
+        Raises:
+            PydanticUserError: If the JSON schema generator has already been used to generate a JSON schema.
+        """
+        self._mode = mode
+        if self._used:
+            raise PydanticUserError(
+                'This JSON schema generator has already been used to generate a JSON schema. '
+                f'You must create a new instance of {type(self).__name__} to generate a new JSON schema.',
+                code='json-schema-already-used',
+            )
+
+        json_schema: JsonSchemaValue = self.generate_inner(schema)
+        json_ref_counts = self.get_json_ref_counts(json_schema)
+
+        # Remove the top-level $ref if present; note that the _generate method already ensures there are no sibling keys
+        ref = cast(JsonRef, json_schema.get('$ref'))
+        while ref is not None:  # may need to unpack multiple levels
+            ref_json_schema = self.get_schema_from_definitions(ref)
+            if json_ref_counts[ref] > 1 or ref_json_schema is None:
+                # Keep the ref, but use an allOf to remove the top level $ref
+                json_schema = {'allOf': [{'$ref': ref}]}
+            else:
+                # "Unpack" the ref since this is the only reference
+                json_schema = ref_json_schema.copy()  # copy to prevent recursive dict reference
+                json_ref_counts[ref] -= 1
+            ref = cast(JsonRef, json_schema.get('$ref'))
+
+        self._garbage_collect_definitions(json_schema)
+        definitions_remapping = self._build_definitions_remapping()
+
+        if self.definitions:
+            json_schema['$defs'] = self.definitions
+
+        json_schema = definitions_remapping.remap_json_schema(json_schema)
+
+        # For now, we will not set the $schema key. However, if desired, this can be easily added by overriding
+        # this method and adding the following line after a call to super().generate(schema):
+        # json_schema['$schema'] = self.schema_dialect
+
+        self._used = True
+        return _sort_json_schema(json_schema)
+
+    def generate_inner(self, schema: CoreSchemaOrField) -> JsonSchemaValue:  # noqa: C901
+        """Generates a JSON schema for a given core schema.
+
+        Args:
+            schema: The given core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        # If a schema with the same CoreRef has been handled, just return a reference to it
+        # Note that this assumes that it will _never_ be the case that the same CoreRef is used
+        # on types that should have different JSON schemas
+        if 'ref' in schema:
+            core_ref = CoreRef(schema['ref'])  # type: ignore[typeddict-item]
+            core_mode_ref = (core_ref, self.mode)
+            if core_mode_ref in self.core_to_defs_refs and self.core_to_defs_refs[core_mode_ref] in self.definitions:
+                return {'$ref': self.core_to_json_refs[core_mode_ref]}
+
+        # Generate the JSON schema, accounting for the json_schema_override and core_schema_override
+        metadata_handler = _core_metadata.CoreMetadataHandler(schema)
+
+        def populate_defs(core_schema: CoreSchema, json_schema: JsonSchemaValue) -> JsonSchemaValue:
+            if 'ref' in core_schema:
+                core_ref = CoreRef(core_schema['ref'])  # type: ignore[typeddict-item]
+                defs_ref, ref_json_schema = self.get_cache_defs_ref_schema(core_ref)
+                json_ref = JsonRef(ref_json_schema['$ref'])
+                self.json_to_defs_refs[json_ref] = defs_ref
+                # Replace the schema if it's not a reference to itself
+                # What we want to avoid is having the def be just a ref to itself
+                # which is what would happen if we blindly assigned any
+                if json_schema.get('$ref', None) != json_ref:
+                    self.definitions[defs_ref] = json_schema
+                    self._core_defs_invalid_for_json_schema.pop(defs_ref, None)
+                json_schema = ref_json_schema
+            return json_schema
+
+        def convert_to_all_of(json_schema: JsonSchemaValue) -> JsonSchemaValue:
+            if '$ref' in json_schema and len(json_schema.keys()) > 1:
+                # technically you can't have any other keys next to a "$ref"
+                # but it's an easy mistake to make and not hard to correct automatically here
+                json_schema = json_schema.copy()
+                ref = json_schema.pop('$ref')
+                json_schema = {'allOf': [{'$ref': ref}], **json_schema}
+            return json_schema
+
+        def handler_func(schema_or_field: CoreSchemaOrField) -> JsonSchemaValue:
+            """Generate a JSON schema based on the input schema.
+
+            Args:
+                schema_or_field: The core schema to generate a JSON schema from.
+
+            Returns:
+                The generated JSON schema.
+
+            Raises:
+                TypeError: If an unexpected schema type is encountered.
+            """
+            # Generate the core-schema-type-specific bits of the schema generation:
+            json_schema: JsonSchemaValue | None = None
+            if self.mode == 'serialization' and 'serialization' in schema_or_field:
+                ser_schema = schema_or_field['serialization']  # type: ignore
+                json_schema = self.ser_schema(ser_schema)
+            if json_schema is None:
+                if _core_utils.is_core_schema(schema_or_field) or _core_utils.is_core_schema_field(schema_or_field):
+                    generate_for_schema_type = self._schema_type_to_method[schema_or_field['type']]
+                    json_schema = generate_for_schema_type(schema_or_field)
+                else:
+                    raise TypeError(f'Unexpected schema type: schema={schema_or_field}')
+            if _core_utils.is_core_schema(schema_or_field):
+                json_schema = populate_defs(schema_or_field, json_schema)
+                json_schema = convert_to_all_of(json_schema)
+            return json_schema
+
+        current_handler = _schema_generation_shared.GenerateJsonSchemaHandler(self, handler_func)
+
+        for js_modify_function in metadata_handler.metadata.get('pydantic_js_functions', ()):
+
+            def new_handler_func(
+                schema_or_field: CoreSchemaOrField,
+                current_handler: GetJsonSchemaHandler = current_handler,
+                js_modify_function: GetJsonSchemaFunction = js_modify_function,
+            ) -> JsonSchemaValue:
+                json_schema = js_modify_function(schema_or_field, current_handler)
+                if _core_utils.is_core_schema(schema_or_field):
+                    json_schema = populate_defs(schema_or_field, json_schema)
+                original_schema = current_handler.resolve_ref_schema(json_schema)
+                ref = json_schema.pop('$ref', None)
+                if ref and json_schema:
+                    original_schema.update(json_schema)
+                return original_schema
+
+            current_handler = _schema_generation_shared.GenerateJsonSchemaHandler(self, new_handler_func)
+
+        for js_modify_function in metadata_handler.metadata.get('pydantic_js_annotation_functions', ()):
+
+            def new_handler_func(
+                schema_or_field: CoreSchemaOrField,
+                current_handler: GetJsonSchemaHandler = current_handler,
+                js_modify_function: GetJsonSchemaFunction = js_modify_function,
+            ) -> JsonSchemaValue:
+                json_schema = js_modify_function(schema_or_field, current_handler)
+                if _core_utils.is_core_schema(schema_or_field):
+                    json_schema = populate_defs(schema_or_field, json_schema)
+                    json_schema = convert_to_all_of(json_schema)
+                return json_schema
+
+            current_handler = _schema_generation_shared.GenerateJsonSchemaHandler(self, new_handler_func)
+
+        json_schema = current_handler(schema)
+        if _core_utils.is_core_schema(schema):
+            json_schema = populate_defs(schema, json_schema)
+            json_schema = convert_to_all_of(json_schema)
+        return json_schema
+
+    # ### Schema generation methods
+    def any_schema(self, schema: core_schema.AnySchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches any value.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        return {}
+
+    def none_schema(self, schema: core_schema.NoneSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches `None`.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        return {'type': 'null'}
+
+    def bool_schema(self, schema: core_schema.BoolSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a bool value.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        return {'type': 'boolean'}
+
+    def int_schema(self, schema: core_schema.IntSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches an int value.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        json_schema: dict[str, Any] = {'type': 'integer'}
+        self.update_with_validations(json_schema, schema, self.ValidationsMapping.numeric)
+        json_schema = {k: v for k, v in json_schema.items() if v not in {math.inf, -math.inf}}
+        return json_schema
+
+    def float_schema(self, schema: core_schema.FloatSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a float value.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        json_schema: dict[str, Any] = {'type': 'number'}
+        self.update_with_validations(json_schema, schema, self.ValidationsMapping.numeric)
+        json_schema = {k: v for k, v in json_schema.items() if v not in {math.inf, -math.inf}}
+        return json_schema
+
+    def decimal_schema(self, schema: core_schema.DecimalSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a decimal value.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        json_schema = self.str_schema(core_schema.str_schema())
+        if self.mode == 'validation':
+            multiple_of = schema.get('multiple_of')
+            le = schema.get('le')
+            ge = schema.get('ge')
+            lt = schema.get('lt')
+            gt = schema.get('gt')
+            json_schema = {
+                'anyOf': [
+                    self.float_schema(
+                        core_schema.float_schema(
+                            allow_inf_nan=schema.get('allow_inf_nan'),
+                            multiple_of=None if multiple_of is None else float(multiple_of),
+                            le=None if le is None else float(le),
+                            ge=None if ge is None else float(ge),
+                            lt=None if lt is None else float(lt),
+                            gt=None if gt is None else float(gt),
+                        )
+                    ),
+                    json_schema,
+                ],
+            }
+        return json_schema
+
+    def str_schema(self, schema: core_schema.StringSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a string value.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        json_schema = {'type': 'string'}
+        self.update_with_validations(json_schema, schema, self.ValidationsMapping.string)
+        return json_schema
+
+    def bytes_schema(self, schema: core_schema.BytesSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a bytes value.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        json_schema = {'type': 'string', 'format': 'base64url' if self._config.ser_json_bytes == 'base64' else 'binary'}
+        self.update_with_validations(json_schema, schema, self.ValidationsMapping.bytes)
+        return json_schema
+
+    def date_schema(self, schema: core_schema.DateSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a date value.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        json_schema = {'type': 'string', 'format': 'date'}
+        self.update_with_validations(json_schema, schema, self.ValidationsMapping.date)
+        return json_schema
+
+    def time_schema(self, schema: core_schema.TimeSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a time value.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        return {'type': 'string', 'format': 'time'}
+
+    def datetime_schema(self, schema: core_schema.DatetimeSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a datetime value.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        return {'type': 'string', 'format': 'date-time'}
+
+    def timedelta_schema(self, schema: core_schema.TimedeltaSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a timedelta value.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        if self._config.ser_json_timedelta == 'float':
+            return {'type': 'number'}
+        return {'type': 'string', 'format': 'duration'}
+
+    def literal_schema(self, schema: core_schema.LiteralSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a literal value.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        expected = [v.value if isinstance(v, Enum) else v for v in schema['expected']]
+        # jsonify the expected values
+        expected = [to_jsonable_python(v) for v in expected]
+
+        if len(expected) == 1:
+            return {'const': expected[0]}
+
+        types = {type(e) for e in expected}
+        if types == {str}:
+            return {'enum': expected, 'type': 'string'}
+        elif types == {int}:
+            return {'enum': expected, 'type': 'integer'}
+        elif types == {float}:
+            return {'enum': expected, 'type': 'number'}
+        elif types == {bool}:
+            return {'enum': expected, 'type': 'boolean'}
+        elif types == {list}:
+            return {'enum': expected, 'type': 'array'}
+        # there is not None case because if it's mixed it hits the final `else`
+        # if it's a single Literal[None] then it becomes a `const` schema above
+        else:
+            return {'enum': expected}
+
+    def is_instance_schema(self, schema: core_schema.IsInstanceSchema) -> JsonSchemaValue:
+        """Handles JSON schema generation for a core schema that checks if a value is an instance of a class.
+
+        Unless overridden in a subclass, this raises an error.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        return self.handle_invalid_for_json_schema(schema, f'core_schema.IsInstanceSchema ({schema["cls"]})')
+
+    def is_subclass_schema(self, schema: core_schema.IsSubclassSchema) -> JsonSchemaValue:
+        """Handles JSON schema generation for a core schema that checks if a value is a subclass of a class.
+
+        For backwards compatibility with v1, this does not raise an error, but can be overridden to change this.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        # Note: This is for compatibility with V1; you can override if you want different behavior.
+        return {}
+
+    def callable_schema(self, schema: core_schema.CallableSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a callable value.
+
+        Unless overridden in a subclass, this raises an error.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        return self.handle_invalid_for_json_schema(schema, 'core_schema.CallableSchema')
+
+    def list_schema(self, schema: core_schema.ListSchema) -> JsonSchemaValue:
+        """Returns a schema that matches a list schema.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        items_schema = {} if 'items_schema' not in schema else self.generate_inner(schema['items_schema'])
+        json_schema = {'type': 'array', 'items': items_schema}
+        self.update_with_validations(json_schema, schema, self.ValidationsMapping.array)
+        return json_schema
+
+    @deprecated('`tuple_positional_schema` is deprecated. Use `tuple_schema` instead.', category=None)
+    @final
+    def tuple_positional_schema(self, schema: core_schema.TupleSchema) -> JsonSchemaValue:
+        """Replaced by `tuple_schema`."""
+        warnings.warn(
+            '`tuple_positional_schema` is deprecated. Use `tuple_schema` instead.',
+            PydanticDeprecatedSince26,
+            stacklevel=2,
+        )
+        return self.tuple_schema(schema)
+
+    @deprecated('`tuple_variable_schema` is deprecated. Use `tuple_schema` instead.', category=None)
+    @final
+    def tuple_variable_schema(self, schema: core_schema.TupleSchema) -> JsonSchemaValue:
+        """Replaced by `tuple_schema`."""
+        warnings.warn(
+            '`tuple_variable_schema` is deprecated. Use `tuple_schema` instead.',
+            PydanticDeprecatedSince26,
+            stacklevel=2,
+        )
+        return self.tuple_schema(schema)
+
+    def tuple_schema(self, schema: core_schema.TupleSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a tuple schema e.g. `Tuple[int,
+        str, bool]` or `Tuple[int, ...]`.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        json_schema: JsonSchemaValue = {'type': 'array'}
+        if 'variadic_item_index' in schema:
+            variadic_item_index = schema['variadic_item_index']
+            if variadic_item_index > 0:
+                json_schema['minItems'] = variadic_item_index
+                json_schema['prefixItems'] = [
+                    self.generate_inner(item) for item in schema['items_schema'][:variadic_item_index]
+                ]
+            if variadic_item_index + 1 == len(schema['items_schema']):
+                # if the variadic item is the last item, then represent it faithfully
+                json_schema['items'] = self.generate_inner(schema['items_schema'][variadic_item_index])
+            else:
+                # otherwise, 'items' represents the schema for the variadic
+                # item plus the suffix, so just allow anything for simplicity
+                # for now
+                json_schema['items'] = True
+        else:
+            prefixItems = [self.generate_inner(item) for item in schema['items_schema']]
+            if prefixItems:
+                json_schema['prefixItems'] = prefixItems
+            json_schema['minItems'] = len(prefixItems)
+            json_schema['maxItems'] = len(prefixItems)
+        self.update_with_validations(json_schema, schema, self.ValidationsMapping.array)
+        return json_schema
+
+    def set_schema(self, schema: core_schema.SetSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a set schema.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        return self._common_set_schema(schema)
+
+    def frozenset_schema(self, schema: core_schema.FrozenSetSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a frozenset schema.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        return self._common_set_schema(schema)
+
+    def _common_set_schema(self, schema: core_schema.SetSchema | core_schema.FrozenSetSchema) -> JsonSchemaValue:
+        items_schema = {} if 'items_schema' not in schema else self.generate_inner(schema['items_schema'])
+        json_schema = {'type': 'array', 'uniqueItems': True, 'items': items_schema}
+        self.update_with_validations(json_schema, schema, self.ValidationsMapping.array)
+        return json_schema
+
+    def generator_schema(self, schema: core_schema.GeneratorSchema) -> JsonSchemaValue:
+        """Returns a JSON schema that represents the provided GeneratorSchema.
+
+        Args:
+            schema: The schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        items_schema = {} if 'items_schema' not in schema else self.generate_inner(schema['items_schema'])
+        json_schema = {'type': 'array', 'items': items_schema}
+        self.update_with_validations(json_schema, schema, self.ValidationsMapping.array)
+        return json_schema
+
+    def dict_schema(self, schema: core_schema.DictSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a dict schema.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        json_schema: JsonSchemaValue = {'type': 'object'}
+
+        keys_schema = self.generate_inner(schema['keys_schema']).copy() if 'keys_schema' in schema else {}
+        keys_pattern = keys_schema.pop('pattern', None)
+
+        values_schema = self.generate_inner(schema['values_schema']).copy() if 'values_schema' in schema else {}
+        values_schema.pop('title', None)  # don't give a title to the additionalProperties
+        if values_schema or keys_pattern is not None:  # don't add additionalProperties if it's empty
+            if keys_pattern is None:
+                json_schema['additionalProperties'] = values_schema
+            else:
+                json_schema['patternProperties'] = {keys_pattern: values_schema}
+
+        self.update_with_validations(json_schema, schema, self.ValidationsMapping.object)
+        return json_schema
+
+    def _function_schema(
+        self,
+        schema: _core_utils.AnyFunctionSchema,
+    ) -> JsonSchemaValue:
+        if _core_utils.is_function_with_inner_schema(schema):
+            # This could be wrong if the function's mode is 'before', but in practice will often be right, and when it
+            # isn't, I think it would be hard to automatically infer what the desired schema should be.
+            return self.generate_inner(schema['schema'])
+
+        # function-plain
+        return self.handle_invalid_for_json_schema(
+            schema, f'core_schema.PlainValidatorFunctionSchema ({schema["function"]})'
+        )
+
+    def function_before_schema(self, schema: core_schema.BeforeValidatorFunctionSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a function-before schema.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        return self._function_schema(schema)
+
+    def function_after_schema(self, schema: core_schema.AfterValidatorFunctionSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a function-after schema.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        return self._function_schema(schema)
+
+    def function_plain_schema(self, schema: core_schema.PlainValidatorFunctionSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a function-plain schema.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        return self._function_schema(schema)
+
+    def function_wrap_schema(self, schema: core_schema.WrapValidatorFunctionSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a function-wrap schema.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        return self._function_schema(schema)
+
+    def default_schema(self, schema: core_schema.WithDefaultSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a schema with a default value.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        json_schema = self.generate_inner(schema['schema'])
+
+        if 'default' not in schema:
+            return json_schema
+        default = schema['default']
+        # Note: if you want to include the value returned by the default_factory,
+        # override this method and replace the code above with:
+        # if 'default' in schema:
+        #     default = schema['default']
+        # elif 'default_factory' in schema:
+        #     default = schema['default_factory']()
+        # else:
+        #     return json_schema
+
+        try:
+            encoded_default = self.encode_default(default)
+        except pydantic_core.PydanticSerializationError:
+            self.emit_warning(
+                'non-serializable-default',
+                f'Default value {default} is not JSON serializable; excluding default from JSON schema',
+            )
+            # Return the inner schema, as though there was no default
+            return json_schema
+
+        if '$ref' in json_schema:
+            # Since reference schemas do not support child keys, we wrap the reference schema in a single-case allOf:
+            return {'allOf': [json_schema], 'default': encoded_default}
+        else:
+            json_schema['default'] = encoded_default
+            return json_schema
+
+    def nullable_schema(self, schema: core_schema.NullableSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a schema that allows null values.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        null_schema = {'type': 'null'}
+        inner_json_schema = self.generate_inner(schema['schema'])
+
+        if inner_json_schema == null_schema:
+            return null_schema
+        else:
+            # Thanks to the equality check against `null_schema` above, I think 'oneOf' would also be valid here;
+            # I'll use 'anyOf' for now, but it could be changed it if it would work better with some external tooling
+            return self.get_flattened_anyof([inner_json_schema, null_schema])
+
+    def union_schema(self, schema: core_schema.UnionSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a schema that allows values matching any of the given schemas.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        generated: list[JsonSchemaValue] = []
+
+        choices = schema['choices']
+        for choice in choices:
+            # choice will be a tuple if an explicit label was provided
+            choice_schema = choice[0] if isinstance(choice, tuple) else choice
+            try:
+                generated.append(self.generate_inner(choice_schema))
+            except PydanticOmit:
+                continue
+            except PydanticInvalidForJsonSchema as exc:
+                self.emit_warning('skipped-choice', exc.message)
+        if len(generated) == 1:
+            return generated[0]
+        return self.get_flattened_anyof(generated)
+
+    def tagged_union_schema(self, schema: core_schema.TaggedUnionSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a schema that allows values matching any of the given schemas, where
+        the schemas are tagged with a discriminator field that indicates which schema should be used to validate
+        the value.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        generated: dict[str, JsonSchemaValue] = {}
+        for k, v in schema['choices'].items():
+            if isinstance(k, Enum):
+                k = k.value
+            try:
+                # Use str(k) since keys must be strings for json; while not technically correct,
+                # it's the closest that can be represented in valid JSON
+                generated[str(k)] = self.generate_inner(v).copy()
+            except PydanticOmit:
+                continue
+            except PydanticInvalidForJsonSchema as exc:
+                self.emit_warning('skipped-choice', exc.message)
+
+        one_of_choices = _deduplicate_schemas(generated.values())
+        json_schema: JsonSchemaValue = {'oneOf': one_of_choices}
+
+        # This reflects the v1 behavior; TODO: we should make it possible to exclude OpenAPI stuff from the JSON schema
+        openapi_discriminator = self._extract_discriminator(schema, one_of_choices)
+        if openapi_discriminator is not None:
+            json_schema['discriminator'] = {
+                'propertyName': openapi_discriminator,
+                'mapping': {k: v.get('$ref', v) for k, v in generated.items()},
+            }
+
+        return json_schema
+
+    def _extract_discriminator(
+        self, schema: core_schema.TaggedUnionSchema, one_of_choices: list[JsonDict]
+    ) -> str | None:
+        """Extract a compatible OpenAPI discriminator from the schema and one_of choices that end up in the final
+        schema."""
+        openapi_discriminator: str | None = None
+
+        if isinstance(schema['discriminator'], str):
+            return schema['discriminator']
+
+        if isinstance(schema['discriminator'], list):
+            # If the discriminator is a single item list containing a string, that is equivalent to the string case
+            if len(schema['discriminator']) == 1 and isinstance(schema['discriminator'][0], str):
+                return schema['discriminator'][0]
+            # When an alias is used that is different from the field name, the discriminator will be a list of single
+            # str lists, one for the attribute and one for the actual alias. The logic here will work even if there is
+            # more than one possible attribute, and looks for whether a single alias choice is present as a documented
+            # property on all choices. If so, that property will be used as the OpenAPI discriminator.
+            for alias_path in schema['discriminator']:
+                if not isinstance(alias_path, list):
+                    break  # this means that the discriminator is not a list of alias paths
+                if len(alias_path) != 1:
+                    continue  # this means that the "alias" does not represent a single field
+                alias = alias_path[0]
+                if not isinstance(alias, str):
+                    continue  # this means that the "alias" does not represent a field
+                alias_is_present_on_all_choices = True
+                for choice in one_of_choices:
+                    while '$ref' in choice:
+                        assert isinstance(choice['$ref'], str)
+                        choice = self.get_schema_from_definitions(JsonRef(choice['$ref'])) or {}
+                    properties = choice.get('properties', {})
+                    if not isinstance(properties, dict) or alias not in properties:
+                        alias_is_present_on_all_choices = False
+                        break
+                if alias_is_present_on_all_choices:
+                    openapi_discriminator = alias
+                    break
+        return openapi_discriminator
+
+    def chain_schema(self, schema: core_schema.ChainSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a core_schema.ChainSchema.
+
+        When generating a schema for validation, we return the validation JSON schema for the first step in the chain.
+        For serialization, we return the serialization JSON schema for the last step in the chain.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        step_index = 0 if self.mode == 'validation' else -1  # use first step for validation, last for serialization
+        return self.generate_inner(schema['steps'][step_index])
+
+    def lax_or_strict_schema(self, schema: core_schema.LaxOrStrictSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a schema that allows values matching either the lax schema or the
+        strict schema.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        # TODO: Need to read the default value off of model config or whatever
+        use_strict = schema.get('strict', False)  # TODO: replace this default False
+        # If your JSON schema fails to generate it is probably
+        # because one of the following two branches failed.
+        if use_strict:
+            return self.generate_inner(schema['strict_schema'])
+        else:
+            return self.generate_inner(schema['lax_schema'])
+
+    def json_or_python_schema(self, schema: core_schema.JsonOrPythonSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a schema that allows values matching either the JSON schema or the
+        Python schema.
+
+        The JSON schema is used instead of the Python schema. If you want to use the Python schema, you should override
+        this method.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        return self.generate_inner(schema['json_schema'])
+
+    def typed_dict_schema(self, schema: core_schema.TypedDictSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a schema that defines a typed dict.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        total = schema.get('total', True)
+        named_required_fields: list[tuple[str, bool, CoreSchemaField]] = [
+            (name, self.field_is_required(field, total), field)
+            for name, field in schema['fields'].items()
+            if self.field_is_present(field)
+        ]
+        if self.mode == 'serialization':
+            named_required_fields.extend(self._name_required_computed_fields(schema.get('computed_fields', [])))
+
+        config = _get_typed_dict_config(schema)
+        with self._config_wrapper_stack.push(config):
+            json_schema = self._named_required_fields_schema(named_required_fields)
+
+        extra = schema.get('extra_behavior')
+        if extra is None:
+            extra = config.get('extra', 'ignore')
+        if extra == 'forbid':
+            json_schema['additionalProperties'] = False
+        elif extra == 'allow':
+            json_schema['additionalProperties'] = True
+
+        return json_schema
+
+    @staticmethod
+    def _name_required_computed_fields(
+        computed_fields: list[ComputedField],
+    ) -> list[tuple[str, bool, core_schema.ComputedField]]:
+        return [(field['property_name'], True, field) for field in computed_fields]
+
+    def _named_required_fields_schema(
+        self, named_required_fields: Sequence[tuple[str, bool, CoreSchemaField]]
+    ) -> JsonSchemaValue:
+        properties: dict[str, JsonSchemaValue] = {}
+        required_fields: list[str] = []
+        for name, required, field in named_required_fields:
+            if self.by_alias:
+                name = self._get_alias_name(field, name)
+            try:
+                field_json_schema = self.generate_inner(field).copy()
+            except PydanticOmit:
+                continue
+            if 'title' not in field_json_schema and self.field_title_should_be_set(field):
+                title = self.get_title_from_name(name)
+                field_json_schema['title'] = title
+            field_json_schema = self.handle_ref_overrides(field_json_schema)
+            properties[name] = field_json_schema
+            if required:
+                required_fields.append(name)
+
+        json_schema = {'type': 'object', 'properties': properties}
+        if required_fields:
+            json_schema['required'] = required_fields
+        return json_schema
+
+    def _get_alias_name(self, field: CoreSchemaField, name: str) -> str:
+        if field['type'] == 'computed-field':
+            alias: Any = field.get('alias', name)
+        elif self.mode == 'validation':
+            alias = field.get('validation_alias', name)
+        else:
+            alias = field.get('serialization_alias', name)
+        if isinstance(alias, str):
+            name = alias
+        elif isinstance(alias, list):
+            alias = cast('list[str] | str', alias)
+            for path in alias:
+                if isinstance(path, list) and len(path) == 1 and isinstance(path[0], str):
+                    # Use the first valid single-item string path; the code that constructs the alias array
+                    # should ensure the first such item is what belongs in the JSON schema
+                    name = path[0]
+                    break
+        else:
+            assert_never(alias)
+        return name
+
+    def typed_dict_field_schema(self, schema: core_schema.TypedDictField) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a schema that defines a typed dict field.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        return self.generate_inner(schema['schema'])
+
+    def dataclass_field_schema(self, schema: core_schema.DataclassField) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a schema that defines a dataclass field.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        return self.generate_inner(schema['schema'])
+
+    def model_field_schema(self, schema: core_schema.ModelField) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a schema that defines a model field.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        return self.generate_inner(schema['schema'])
+
+    def computed_field_schema(self, schema: core_schema.ComputedField) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a schema that defines a computed field.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        return self.generate_inner(schema['return_schema'])
+
+    def model_schema(self, schema: core_schema.ModelSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a schema that defines a model.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        # We do not use schema['model'].model_json_schema() here
+        # because it could lead to inconsistent refs handling, etc.
+        cls = cast('type[BaseModel]', schema['cls'])
+        config = cls.model_config
+        title = config.get('title')
+
+        with self._config_wrapper_stack.push(config):
+            json_schema = self.generate_inner(schema['schema'])
+
+        json_schema_extra = config.get('json_schema_extra')
+        if cls.__pydantic_root_model__:
+            root_json_schema_extra = cls.model_fields['root'].json_schema_extra
+            if json_schema_extra and root_json_schema_extra:
+                raise ValueError(
+                    '"model_config[\'json_schema_extra\']" and "Field.json_schema_extra" on "RootModel.root"'
+                    ' field must not be set simultaneously'
+                )
+            if root_json_schema_extra:
+                json_schema_extra = root_json_schema_extra
+
+        json_schema = self._update_class_schema(json_schema, title, config.get('extra', None), cls, json_schema_extra)
+
+        return json_schema
+
+    def _update_class_schema(
+        self,
+        json_schema: JsonSchemaValue,
+        title: str | None,
+        extra: Literal['allow', 'ignore', 'forbid'] | None,
+        cls: type[Any],
+        json_schema_extra: JsonDict | JsonSchemaExtraCallable | None,
+    ) -> JsonSchemaValue:
+        if '$ref' in json_schema:
+            schema_to_update = self.get_schema_from_definitions(JsonRef(json_schema['$ref'])) or json_schema
+        else:
+            schema_to_update = json_schema
+
+        if title is not None:
+            # referenced_schema['title'] = title
+            schema_to_update.setdefault('title', title)
+
+        if 'additionalProperties' not in schema_to_update:
+            if extra == 'allow':
+                schema_to_update['additionalProperties'] = True
+            elif extra == 'forbid':
+                schema_to_update['additionalProperties'] = False
+
+        if isinstance(json_schema_extra, (staticmethod, classmethod)):
+            # In older versions of python, this is necessary to ensure staticmethod/classmethods are callable
+            json_schema_extra = json_schema_extra.__get__(cls)
+
+        if isinstance(json_schema_extra, dict):
+            schema_to_update.update(json_schema_extra)
+        elif callable(json_schema_extra):
+            if len(inspect.signature(json_schema_extra).parameters) > 1:
+                json_schema_extra(schema_to_update, cls)  # type: ignore
+            else:
+                json_schema_extra(schema_to_update)  # type: ignore
+        elif json_schema_extra is not None:
+            raise ValueError(
+                f"model_config['json_schema_extra']={json_schema_extra} should be a dict, callable, or None"
+            )
+
+        return json_schema
+
+    def resolve_schema_to_update(self, json_schema: JsonSchemaValue) -> JsonSchemaValue:
+        """Resolve a JsonSchemaValue to the non-ref schema if it is a $ref schema.
+
+        Args:
+            json_schema: The schema to resolve.
+
+        Returns:
+            The resolved schema.
+        """
+        if '$ref' in json_schema:
+            schema_to_update = self.get_schema_from_definitions(JsonRef(json_schema['$ref']))
+            if schema_to_update is None:
+                raise RuntimeError(f'Cannot update undefined schema for $ref={json_schema["$ref"]}')
+            return self.resolve_schema_to_update(schema_to_update)
+        else:
+            schema_to_update = json_schema
+        return schema_to_update
+
+    def model_fields_schema(self, schema: core_schema.ModelFieldsSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a schema that defines a model's fields.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        named_required_fields: list[tuple[str, bool, CoreSchemaField]] = [
+            (name, self.field_is_required(field, total=True), field)
+            for name, field in schema['fields'].items()
+            if self.field_is_present(field)
+        ]
+        if self.mode == 'serialization':
+            named_required_fields.extend(self._name_required_computed_fields(schema.get('computed_fields', [])))
+        json_schema = self._named_required_fields_schema(named_required_fields)
+        extras_schema = schema.get('extras_schema', None)
+        if extras_schema is not None:
+            schema_to_update = self.resolve_schema_to_update(json_schema)
+            schema_to_update['additionalProperties'] = self.generate_inner(extras_schema)
+        return json_schema
+
+    def field_is_present(self, field: CoreSchemaField) -> bool:
+        """Whether the field should be included in the generated JSON schema.
+
+        Args:
+            field: The schema for the field itself.
+
+        Returns:
+            `True` if the field should be included in the generated JSON schema, `False` otherwise.
+        """
+        if self.mode == 'serialization':
+            # If you still want to include the field in the generated JSON schema,
+            # override this method and return True
+            return not field.get('serialization_exclude')
+        elif self.mode == 'validation':
+            return True
+        else:
+            assert_never(self.mode)
+
+    def field_is_required(
+        self,
+        field: core_schema.ModelField | core_schema.DataclassField | core_schema.TypedDictField,
+        total: bool,
+    ) -> bool:
+        """Whether the field should be marked as required in the generated JSON schema.
+        (Note that this is irrelevant if the field is not present in the JSON schema.).
+
+        Args:
+            field: The schema for the field itself.
+            total: Only applies to `TypedDictField`s.
+                Indicates if the `TypedDict` this field belongs to is total, in which case any fields that don't
+                explicitly specify `required=False` are required.
+
+        Returns:
+            `True` if the field should be marked as required in the generated JSON schema, `False` otherwise.
+        """
+        if self.mode == 'serialization' and self._config.json_schema_serialization_defaults_required:
+            return not field.get('serialization_exclude')
+        else:
+            if field['type'] == 'typed-dict-field':
+                return field.get('required', total)
+            else:
+                return field['schema']['type'] != 'default'
+
+    def dataclass_args_schema(self, schema: core_schema.DataclassArgsSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a schema that defines a dataclass's constructor arguments.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        named_required_fields: list[tuple[str, bool, CoreSchemaField]] = [
+            (field['name'], self.field_is_required(field, total=True), field)
+            for field in schema['fields']
+            if self.field_is_present(field)
+        ]
+        if self.mode == 'serialization':
+            named_required_fields.extend(self._name_required_computed_fields(schema.get('computed_fields', [])))
+        return self._named_required_fields_schema(named_required_fields)
+
+    def dataclass_schema(self, schema: core_schema.DataclassSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a schema that defines a dataclass.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        cls = schema['cls']
+        config: ConfigDict = getattr(cls, '__pydantic_config__', cast('ConfigDict', {}))
+        title = config.get('title') or cls.__name__
+
+        with self._config_wrapper_stack.push(config):
+            json_schema = self.generate_inner(schema['schema']).copy()
+
+        json_schema_extra = config.get('json_schema_extra')
+        json_schema = self._update_class_schema(json_schema, title, config.get('extra', None), cls, json_schema_extra)
+
+        # Dataclass-specific handling of description
+        if is_dataclass(cls) and not hasattr(cls, '__pydantic_validator__'):
+            # vanilla dataclass; don't use cls.__doc__ as it will contain the class signature by default
+            description = None
+        else:
+            description = None if cls.__doc__ is None else inspect.cleandoc(cls.__doc__)
+        if description:
+            json_schema['description'] = description
+
+        return json_schema
+
+    def arguments_schema(self, schema: core_schema.ArgumentsSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a schema that defines a function's arguments.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        metadata = _core_metadata.CoreMetadataHandler(schema).metadata
+        prefer_positional = metadata.get('pydantic_js_prefer_positional_arguments')
+
+        arguments = schema['arguments_schema']
+        kw_only_arguments = [a for a in arguments if a.get('mode') == 'keyword_only']
+        kw_or_p_arguments = [a for a in arguments if a.get('mode') in {'positional_or_keyword', None}]
+        p_only_arguments = [a for a in arguments if a.get('mode') == 'positional_only']
+        var_args_schema = schema.get('var_args_schema')
+        var_kwargs_schema = schema.get('var_kwargs_schema')
+
+        if prefer_positional:
+            positional_possible = not kw_only_arguments and not var_kwargs_schema
+            if positional_possible:
+                return self.p_arguments_schema(p_only_arguments + kw_or_p_arguments, var_args_schema)
+
+        keyword_possible = not p_only_arguments and not var_args_schema
+        if keyword_possible:
+            return self.kw_arguments_schema(kw_or_p_arguments + kw_only_arguments, var_kwargs_schema)
+
+        if not prefer_positional:
+            positional_possible = not kw_only_arguments and not var_kwargs_schema
+            if positional_possible:
+                return self.p_arguments_schema(p_only_arguments + kw_or_p_arguments, var_args_schema)
+
+        raise PydanticInvalidForJsonSchema(
+            'Unable to generate JSON schema for arguments validator with positional-only and keyword-only arguments'
+        )
+
+    def kw_arguments_schema(
+        self, arguments: list[core_schema.ArgumentsParameter], var_kwargs_schema: CoreSchema | None
+    ) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a schema that defines a function's keyword arguments.
+
+        Args:
+            arguments: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        properties: dict[str, JsonSchemaValue] = {}
+        required: list[str] = []
+        for argument in arguments:
+            name = self.get_argument_name(argument)
+            argument_schema = self.generate_inner(argument['schema']).copy()
+            argument_schema['title'] = self.get_title_from_name(name)
+            properties[name] = argument_schema
+
+            if argument['schema']['type'] != 'default':
+                # This assumes that if the argument has a default value,
+                # the inner schema must be of type WithDefaultSchema.
+                # I believe this is true, but I am not 100% sure
+                required.append(name)
+
+        json_schema: JsonSchemaValue = {'type': 'object', 'properties': properties}
+        if required:
+            json_schema['required'] = required
+
+        if var_kwargs_schema:
+            additional_properties_schema = self.generate_inner(var_kwargs_schema)
+            if additional_properties_schema:
+                json_schema['additionalProperties'] = additional_properties_schema
+        else:
+            json_schema['additionalProperties'] = False
+        return json_schema
+
+    def p_arguments_schema(
+        self, arguments: list[core_schema.ArgumentsParameter], var_args_schema: CoreSchema | None
+    ) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a schema that defines a function's positional arguments.
+
+        Args:
+            arguments: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        prefix_items: list[JsonSchemaValue] = []
+        min_items = 0
+
+        for argument in arguments:
+            name = self.get_argument_name(argument)
+
+            argument_schema = self.generate_inner(argument['schema']).copy()
+            argument_schema['title'] = self.get_title_from_name(name)
+            prefix_items.append(argument_schema)
+
+            if argument['schema']['type'] != 'default':
+                # This assumes that if the argument has a default value,
+                # the inner schema must be of type WithDefaultSchema.
+                # I believe this is true, but I am not 100% sure
+                min_items += 1
+
+        json_schema: JsonSchemaValue = {'type': 'array', 'prefixItems': prefix_items}
+        if min_items:
+            json_schema['minItems'] = min_items
+
+        if var_args_schema:
+            items_schema = self.generate_inner(var_args_schema)
+            if items_schema:
+                json_schema['items'] = items_schema
+        else:
+            json_schema['maxItems'] = len(prefix_items)
+
+        return json_schema
+
+    def get_argument_name(self, argument: core_schema.ArgumentsParameter) -> str:
+        """Retrieves the name of an argument.
+
+        Args:
+            argument: The core schema.
+
+        Returns:
+            The name of the argument.
+        """
+        name = argument['name']
+        if self.by_alias:
+            alias = argument.get('alias')
+            if isinstance(alias, str):
+                name = alias
+            else:
+                pass  # might want to do something else?
+        return name
+
+    def call_schema(self, schema: core_schema.CallSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a schema that defines a function call.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        return self.generate_inner(schema['arguments_schema'])
+
+    def custom_error_schema(self, schema: core_schema.CustomErrorSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a schema that defines a custom error.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        return self.generate_inner(schema['schema'])
+
+    def json_schema(self, schema: core_schema.JsonSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a schema that defines a JSON object.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        content_core_schema = schema.get('schema') or core_schema.any_schema()
+        content_json_schema = self.generate_inner(content_core_schema)
+        if self.mode == 'validation':
+            return {'type': 'string', 'contentMediaType': 'application/json', 'contentSchema': content_json_schema}
+        else:
+            # self.mode == 'serialization'
+            return content_json_schema
+
+    def url_schema(self, schema: core_schema.UrlSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a schema that defines a URL.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        json_schema = {'type': 'string', 'format': 'uri', 'minLength': 1}
+        self.update_with_validations(json_schema, schema, self.ValidationsMapping.string)
+        return json_schema
+
+    def multi_host_url_schema(self, schema: core_schema.MultiHostUrlSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a schema that defines a URL that can be used with multiple hosts.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        # Note: 'multi-host-uri' is a custom/pydantic-specific format, not part of the JSON Schema spec
+        json_schema = {'type': 'string', 'format': 'multi-host-uri', 'minLength': 1}
+        self.update_with_validations(json_schema, schema, self.ValidationsMapping.string)
+        return json_schema
+
+    def uuid_schema(self, schema: core_schema.UuidSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a UUID.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        return {'type': 'string', 'format': 'uuid'}
+
+    def definitions_schema(self, schema: core_schema.DefinitionsSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a schema that defines a JSON object with definitions.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        for definition in schema['definitions']:
+            try:
+                self.generate_inner(definition)
+            except PydanticInvalidForJsonSchema as e:
+                core_ref: CoreRef = CoreRef(definition['ref'])  # type: ignore
+                self._core_defs_invalid_for_json_schema[self.get_defs_ref((core_ref, self.mode))] = e
+                continue
+        return self.generate_inner(schema['schema'])
+
+    def definition_ref_schema(self, schema: core_schema.DefinitionReferenceSchema) -> JsonSchemaValue:
+        """Generates a JSON schema that matches a schema that references a definition.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        core_ref = CoreRef(schema['schema_ref'])
+        _, ref_json_schema = self.get_cache_defs_ref_schema(core_ref)
+        return ref_json_schema
+
+    def ser_schema(
+        self, schema: core_schema.SerSchema | core_schema.IncExSeqSerSchema | core_schema.IncExDictSerSchema
+    ) -> JsonSchemaValue | None:
+        """Generates a JSON schema that matches a schema that defines a serialized object.
+
+        Args:
+            schema: The core schema.
+
+        Returns:
+            The generated JSON schema.
+        """
+        schema_type = schema['type']
+        if schema_type == 'function-plain' or schema_type == 'function-wrap':
+            # PlainSerializerFunctionSerSchema or WrapSerializerFunctionSerSchema
+            return_schema = schema.get('return_schema')
+            if return_schema is not None:
+                return self.generate_inner(return_schema)
+        elif schema_type == 'format' or schema_type == 'to-string':
+            # FormatSerSchema or ToStringSerSchema
+            return self.str_schema(core_schema.str_schema())
+        elif schema['type'] == 'model':
+            # ModelSerSchema
+            return self.generate_inner(schema['schema'])
+        return None
+
+    # ### Utility methods
+
+    def get_title_from_name(self, name: str) -> str:
+        """Retrieves a title from a name.
+
+        Args:
+            name: The name to retrieve a title from.
+
+        Returns:
+            The title.
+        """
+        return name.title().replace('_', ' ')
+
+    def field_title_should_be_set(self, schema: CoreSchemaOrField) -> bool:
+        """Returns true if a field with the given schema should have a title set based on the field name.
+
+        Intuitively, we want this to return true for schemas that wouldn't otherwise provide their own title
+        (e.g., int, float, str), and false for those that would (e.g., BaseModel subclasses).
+
+        Args:
+            schema: The schema to check.
+
+        Returns:
+            `True` if the field should have a title set, `False` otherwise.
+        """
+        if _core_utils.is_core_schema_field(schema):
+            if schema['type'] == 'computed-field':
+                field_schema = schema['return_schema']
+            else:
+                field_schema = schema['schema']
+            return self.field_title_should_be_set(field_schema)
+
+        elif _core_utils.is_core_schema(schema):
+            if schema.get('ref'):  # things with refs, such as models and enums, should not have titles set
+                return False
+            if schema['type'] in {'default', 'nullable', 'definitions'}:
+                return self.field_title_should_be_set(schema['schema'])  # type: ignore[typeddict-item]
+            if _core_utils.is_function_with_inner_schema(schema):
+                return self.field_title_should_be_set(schema['schema'])
+            if schema['type'] == 'definition-ref':
+                # Referenced schemas should not have titles set for the same reason
+                # schemas with refs should not
+                return False
+            return True  # anything else should have title set
+
+        else:
+            raise PydanticInvalidForJsonSchema(f'Unexpected schema type: schema={schema}')  # pragma: no cover
+
+    def normalize_name(self, name: str) -> str:
+        """Normalizes a name to be used as a key in a dictionary.
+
+        Args:
+            name: The name to normalize.
+
+        Returns:
+            The normalized name.
+        """
+        return re.sub(r'[^a-zA-Z0-9.\-_]', '_', name).replace('.', '__')
+
+    def get_defs_ref(self, core_mode_ref: CoreModeRef) -> DefsRef:
+        """Override this method to change the way that definitions keys are generated from a core reference.
+
+        Args:
+            core_mode_ref: The core reference.
+
+        Returns:
+            The definitions key.
+        """
+        # Split the core ref into "components"; generic origins and arguments are each separate components
+        core_ref, mode = core_mode_ref
+        components = re.split(r'([\][,])', core_ref)
+        # Remove IDs from each component
+        components = [x.rsplit(':', 1)[0] for x in components]
+        core_ref_no_id = ''.join(components)
+        # Remove everything before the last period from each "component"
+        components = [re.sub(r'(?:[^.[\]]+\.)+((?:[^.[\]]+))', r'\1', x) for x in components]
+        short_ref = ''.join(components)
+
+        mode_title = _MODE_TITLE_MAPPING[mode]
+
+        # It is important that the generated defs_ref values be such that at least one choice will not
+        # be generated for any other core_ref. Currently, this should be the case because we include
+        # the id of the source type in the core_ref
+        name = DefsRef(self.normalize_name(short_ref))
+        name_mode = DefsRef(self.normalize_name(short_ref) + f'-{mode_title}')
+        module_qualname = DefsRef(self.normalize_name(core_ref_no_id))
+        module_qualname_mode = DefsRef(f'{module_qualname}-{mode_title}')
+        module_qualname_id = DefsRef(self.normalize_name(core_ref))
+        occurrence_index = self._collision_index.get(module_qualname_id)
+        if occurrence_index is None:
+            self._collision_counter[module_qualname] += 1
+            occurrence_index = self._collision_index[module_qualname_id] = self._collision_counter[module_qualname]
+
+        module_qualname_occurrence = DefsRef(f'{module_qualname}__{occurrence_index}')
+        module_qualname_occurrence_mode = DefsRef(f'{module_qualname_mode}__{occurrence_index}')
+
+        self._prioritized_defsref_choices[module_qualname_occurrence_mode] = [
+            name,
+            name_mode,
+            module_qualname,
+            module_qualname_mode,
+            module_qualname_occurrence,
+            module_qualname_occurrence_mode,
+        ]
+
+        return module_qualname_occurrence_mode
+
+    def get_cache_defs_ref_schema(self, core_ref: CoreRef) -> tuple[DefsRef, JsonSchemaValue]:
+        """This method wraps the get_defs_ref method with some cache-lookup/population logic,
+        and returns both the produced defs_ref and the JSON schema that will refer to the right definition.
+
+        Args:
+            core_ref: The core reference to get the definitions reference for.
+
+        Returns:
+            A tuple of the definitions reference and the JSON schema that will refer to it.
+        """
+        core_mode_ref = (core_ref, self.mode)
+        maybe_defs_ref = self.core_to_defs_refs.get(core_mode_ref)
+        if maybe_defs_ref is not None:
+            json_ref = self.core_to_json_refs[core_mode_ref]
+            return maybe_defs_ref, {'$ref': json_ref}
+
+        defs_ref = self.get_defs_ref(core_mode_ref)
+
+        # populate the ref translation mappings
+        self.core_to_defs_refs[core_mode_ref] = defs_ref
+        self.defs_to_core_refs[defs_ref] = core_mode_ref
+
+        json_ref = JsonRef(self.ref_template.format(model=defs_ref))
+        self.core_to_json_refs[core_mode_ref] = json_ref
+        self.json_to_defs_refs[json_ref] = defs_ref
+        ref_json_schema = {'$ref': json_ref}
+        return defs_ref, ref_json_schema
+
+    def handle_ref_overrides(self, json_schema: JsonSchemaValue) -> JsonSchemaValue:
+        """It is not valid for a schema with a top-level $ref to have sibling keys.
+
+        During our own schema generation, we treat sibling keys as overrides to the referenced schema,
+        but this is not how the official JSON schema spec works.
+
+        Because of this, we first remove any sibling keys that are redundant with the referenced schema, then if
+        any remain, we transform the schema from a top-level '$ref' to use allOf to move the $ref out of the top level.
+        (See bottom of https://swagger.io/docs/specification/using-ref/ for a reference about this behavior)
+        """
+        if '$ref' in json_schema:
+            # prevent modifications to the input; this copy may be safe to drop if there is significant overhead
+            json_schema = json_schema.copy()
+
+            referenced_json_schema = self.get_schema_from_definitions(JsonRef(json_schema['$ref']))
+            if referenced_json_schema is None:
+                # This can happen when building schemas for models with not-yet-defined references.
+                # It may be a good idea to do a recursive pass at the end of the generation to remove
+                # any redundant override keys.
+                if len(json_schema) > 1:
+                    # Make it an allOf to at least resolve the sibling keys issue
+                    json_schema = json_schema.copy()
+                    json_schema.setdefault('allOf', [])
+                    json_schema['allOf'].append({'$ref': json_schema['$ref']})
+                    del json_schema['$ref']
+
+                return json_schema
+            for k, v in list(json_schema.items()):
+                if k == '$ref':
+                    continue
+                if k in referenced_json_schema and referenced_json_schema[k] == v:
+                    del json_schema[k]  # redundant key
+            if len(json_schema) > 1:
+                # There is a remaining "override" key, so we need to move $ref out of the top level
+                json_ref = JsonRef(json_schema['$ref'])
+                del json_schema['$ref']
+                assert 'allOf' not in json_schema  # this should never happen, but just in case
+                json_schema['allOf'] = [{'$ref': json_ref}]
+
+        return json_schema
+
+    def get_schema_from_definitions(self, json_ref: JsonRef) -> JsonSchemaValue | None:
+        def_ref = self.json_to_defs_refs[json_ref]
+        if def_ref in self._core_defs_invalid_for_json_schema:
+            raise self._core_defs_invalid_for_json_schema[def_ref]
+        return self.definitions.get(def_ref, None)
+
+    def encode_default(self, dft: Any) -> Any:
+        """Encode a default value to a JSON-serializable value.
+
+        This is used to encode default values for fields in the generated JSON schema.
+
+        Args:
+            dft: The default value to encode.
+
+        Returns:
+            The encoded default value.
+        """
+        config = self._config
+        return pydantic_core.to_jsonable_python(
+            dft,
+            timedelta_mode=config.ser_json_timedelta,
+            bytes_mode=config.ser_json_bytes,
+        )
+
+    def update_with_validations(
+        self, json_schema: JsonSchemaValue, core_schema: CoreSchema, mapping: dict[str, str]
+    ) -> None:
+        """Update the json_schema with the corresponding validations specified in the core_schema,
+        using the provided mapping to translate keys in core_schema to the appropriate keys for a JSON schema.
+
+        Args:
+            json_schema: The JSON schema to update.
+            core_schema: The core schema to get the validations from.
+            mapping: A mapping from core_schema attribute names to the corresponding JSON schema attribute names.
+        """
+        for core_key, json_schema_key in mapping.items():
+            if core_key in core_schema:
+                json_schema[json_schema_key] = core_schema[core_key]
+
+    class ValidationsMapping:
+        """This class just contains mappings from core_schema attribute names to the corresponding
+        JSON schema attribute names. While I suspect it is unlikely to be necessary, you can in
+        principle override this class in a subclass of GenerateJsonSchema (by inheriting from
+        GenerateJsonSchema.ValidationsMapping) to change these mappings.
+        """
+
+        numeric = {
+            'multiple_of': 'multipleOf',
+            'le': 'maximum',
+            'ge': 'minimum',
+            'lt': 'exclusiveMaximum',
+            'gt': 'exclusiveMinimum',
+        }
+        bytes = {
+            'min_length': 'minLength',
+            'max_length': 'maxLength',
+        }
+        string = {
+            'min_length': 'minLength',
+            'max_length': 'maxLength',
+            'pattern': 'pattern',
+        }
+        array = {
+            'min_length': 'minItems',
+            'max_length': 'maxItems',
+        }
+        object = {
+            'min_length': 'minProperties',
+            'max_length': 'maxProperties',
+        }
+        date = {
+            'le': 'maximum',
+            'ge': 'minimum',
+            'lt': 'exclusiveMaximum',
+            'gt': 'exclusiveMinimum',
+        }
+
+    def get_flattened_anyof(self, schemas: list[JsonSchemaValue]) -> JsonSchemaValue:
+        members = []
+        for schema in schemas:
+            if len(schema) == 1 and 'anyOf' in schema:
+                members.extend(schema['anyOf'])
+            else:
+                members.append(schema)
+        members = _deduplicate_schemas(members)
+        if len(members) == 1:
+            return members[0]
+        return {'anyOf': members}
+
+    def get_json_ref_counts(self, json_schema: JsonSchemaValue) -> dict[JsonRef, int]:
+        """Get all values corresponding to the key '$ref' anywhere in the json_schema."""
+        json_refs: dict[JsonRef, int] = Counter()
+
+        def _add_json_refs(schema: Any) -> None:
+            if isinstance(schema, dict):
+                if '$ref' in schema:
+                    json_ref = JsonRef(schema['$ref'])
+                    if not isinstance(json_ref, str):
+                        return  # in this case, '$ref' might have been the name of a property
+                    already_visited = json_ref in json_refs
+                    json_refs[json_ref] += 1
+                    if already_visited:
+                        return  # prevent recursion on a definition that was already visited
+                    defs_ref = self.json_to_defs_refs[json_ref]
+                    if defs_ref in self._core_defs_invalid_for_json_schema:
+                        raise self._core_defs_invalid_for_json_schema[defs_ref]
+                    _add_json_refs(self.definitions[defs_ref])
+
+                for v in schema.values():
+                    _add_json_refs(v)
+            elif isinstance(schema, list):
+                for v in schema:
+                    _add_json_refs(v)
+
+        _add_json_refs(json_schema)
+        return json_refs
+
+    def handle_invalid_for_json_schema(self, schema: CoreSchemaOrField, error_info: str) -> JsonSchemaValue:
+        raise PydanticInvalidForJsonSchema(f'Cannot generate a JsonSchema for {error_info}')
+
+    def emit_warning(self, kind: JsonSchemaWarningKind, detail: str) -> None:
+        """This method simply emits PydanticJsonSchemaWarnings based on handling in the `warning_message` method."""
+        message = self.render_warning_message(kind, detail)
+        if message is not None:
+            warnings.warn(message, PydanticJsonSchemaWarning)
+
+    def render_warning_message(self, kind: JsonSchemaWarningKind, detail: str) -> str | None:
+        """This method is responsible for ignoring warnings as desired, and for formatting the warning messages.
+
+        You can override the value of `ignored_warning_kinds` in a subclass of GenerateJsonSchema
+        to modify what warnings are generated. If you want more control, you can override this method;
+        just return None in situations where you don't want warnings to be emitted.
+
+        Args:
+            kind: The kind of warning to render. It can be one of the following:
+
+                - 'skipped-choice': A choice field was skipped because it had no valid choices.
+                - 'non-serializable-default': A default value was skipped because it was not JSON-serializable.
+            detail: A string with additional details about the warning.
+
+        Returns:
+            The formatted warning message, or `None` if no warning should be emitted.
+        """
+        if kind in self.ignored_warning_kinds:
+            return None
+        return f'{detail} [{kind}]'
+
+    def _build_definitions_remapping(self) -> _DefinitionsRemapping:
+        defs_to_json: dict[DefsRef, JsonRef] = {}
+        for defs_refs in self._prioritized_defsref_choices.values():
+            for defs_ref in defs_refs:
+                json_ref = JsonRef(self.ref_template.format(model=defs_ref))
+                defs_to_json[defs_ref] = json_ref
+
+        return _DefinitionsRemapping.from_prioritized_choices(
+            self._prioritized_defsref_choices, defs_to_json, self.definitions
+        )
+
+    def _garbage_collect_definitions(self, schema: JsonSchemaValue) -> None:
+        visited_defs_refs: set[DefsRef] = set()
+        unvisited_json_refs = _get_all_json_refs(schema)
+        while unvisited_json_refs:
+            next_json_ref = unvisited_json_refs.pop()
+            next_defs_ref = self.json_to_defs_refs[next_json_ref]
+            if next_defs_ref in visited_defs_refs:
+                continue
+            visited_defs_refs.add(next_defs_ref)
+            unvisited_json_refs.update(_get_all_json_refs(self.definitions[next_defs_ref]))
+
+        self.definitions = {k: v for k, v in self.definitions.items() if k in visited_defs_refs}
+
+
+# ##### Start JSON Schema Generation Functions #####
+
+
+def model_json_schema(
+    cls: type[BaseModel] | type[PydanticDataclass],
+    by_alias: bool = True,
+    ref_template: str = DEFAULT_REF_TEMPLATE,
+    schema_generator: type[GenerateJsonSchema] = GenerateJsonSchema,
+    mode: JsonSchemaMode = 'validation',
+) -> dict[str, Any]:
+    """Utility function to generate a JSON Schema for a model.
+
+    Args:
+        cls: The model class to generate a JSON Schema for.
+        by_alias: If `True` (the default), fields will be serialized according to their alias.
+            If `False`, fields will be serialized according to their attribute name.
+        ref_template: The template to use for generating JSON Schema references.
+        schema_generator: The class to use for generating the JSON Schema.
+        mode: The mode to use for generating the JSON Schema. It can be one of the following:
+
+            - 'validation': Generate a JSON Schema for validating data.
+            - 'serialization': Generate a JSON Schema for serializing data.
+
+    Returns:
+        The generated JSON Schema.
+    """
+    schema_generator_instance = schema_generator(by_alias=by_alias, ref_template=ref_template)
+    if isinstance(cls.__pydantic_validator__, _mock_val_ser.MockValSer):
+        cls.__pydantic_validator__.rebuild()
+    assert '__pydantic_core_schema__' in cls.__dict__, 'this is a bug! please report it'
+    return schema_generator_instance.generate(cls.__pydantic_core_schema__, mode=mode)
+
+
+def models_json_schema(
+    models: Sequence[tuple[type[BaseModel] | type[PydanticDataclass], JsonSchemaMode]],
+    *,
+    by_alias: bool = True,
+    title: str | None = None,
+    description: str | None = None,
+    ref_template: str = DEFAULT_REF_TEMPLATE,
+    schema_generator: type[GenerateJsonSchema] = GenerateJsonSchema,
+) -> tuple[dict[tuple[type[BaseModel] | type[PydanticDataclass], JsonSchemaMode], JsonSchemaValue], JsonSchemaValue]:
+    """Utility function to generate a JSON Schema for multiple models.
+
+    Args:
+        models: A sequence of tuples of the form (model, mode).
+        by_alias: Whether field aliases should be used as keys in the generated JSON Schema.
+        title: The title of the generated JSON Schema.
+        description: The description of the generated JSON Schema.
+        ref_template: The reference template to use for generating JSON Schema references.
+        schema_generator: The schema generator to use for generating the JSON Schema.
+
+    Returns:
+        A tuple where:
+            - The first element is a dictionary whose keys are tuples of JSON schema key type and JSON mode, and
+                whose values are the JSON schema corresponding to that pair of inputs. (These schemas may have
+                JsonRef references to definitions that are defined in the second returned element.)
+            - The second element is a JSON schema containing all definitions referenced in the first returned
+                    element, along with the optional title and description keys.
+    """
+    for cls, _ in models:
+        if isinstance(cls.__pydantic_validator__, _mock_val_ser.MockValSer):
+            cls.__pydantic_validator__.rebuild()
+
+    instance = schema_generator(by_alias=by_alias, ref_template=ref_template)
+    inputs = [(m, mode, m.__pydantic_core_schema__) for m, mode in models]
+    json_schemas_map, definitions = instance.generate_definitions(inputs)
+
+    json_schema: dict[str, Any] = {}
+    if definitions:
+        json_schema['$defs'] = definitions
+    if title:
+        json_schema['title'] = title
+    if description:
+        json_schema['description'] = description
+
+    return json_schemas_map, json_schema
+
+
+# ##### End JSON Schema Generation Functions #####
+
+
+_HashableJsonValue: TypeAlias = Union[
+    int, float, str, bool, None, Tuple['_HashableJsonValue', ...], Tuple[Tuple[str, '_HashableJsonValue'], ...]
+]
+
+
+def _deduplicate_schemas(schemas: Iterable[JsonDict]) -> list[JsonDict]:
+    return list({_make_json_hashable(schema): schema for schema in schemas}.values())
+
+
+def _make_json_hashable(value: JsonValue) -> _HashableJsonValue:
+    if isinstance(value, dict):
+        return tuple(sorted((k, _make_json_hashable(v)) for k, v in value.items()))
+    elif isinstance(value, list):
+        return tuple(_make_json_hashable(v) for v in value)
+    else:
+        return value
+
+
+def _sort_json_schema(value: JsonSchemaValue, parent_key: str | None = None) -> JsonSchemaValue:
+    if isinstance(value, dict):
+        sorted_dict: dict[str, JsonSchemaValue] = {}
+        keys = value.keys()
+        if (parent_key != 'properties') and (parent_key != 'default'):
+            keys = sorted(keys)
+        for key in keys:
+            sorted_dict[key] = _sort_json_schema(value[key], parent_key=key)
+        return sorted_dict
+    elif isinstance(value, list):
+        sorted_list: list[JsonSchemaValue] = []
+        for item in value:  # type: ignore
+            sorted_list.append(_sort_json_schema(item, parent_key))
+        return sorted_list  # type: ignore
+    else:
+        return value
+
+
+@dataclasses.dataclass(**_internal_dataclass.slots_true)
+class WithJsonSchema:
+    """Usage docs: https://docs.pydantic.dev/2.6/concepts/json_schema/#withjsonschema-annotation
+
+    Add this as an annotation on a field to override the (base) JSON schema that would be generated for that field.
+    This provides a way to set a JSON schema for types that would otherwise raise errors when producing a JSON schema,
+    such as Callable, or types that have an is-instance core schema, without needing to go so far as creating a
+    custom subclass of pydantic.json_schema.GenerateJsonSchema.
+    Note that any _modifications_ to the schema that would normally be made (such as setting the title for model fields)
+    will still be performed.
+
+    If `mode` is set this will only apply to that schema generation mode, allowing you
+    to set different json schemas for validation and serialization.
+    """
+
+    json_schema: JsonSchemaValue | None
+    mode: Literal['validation', 'serialization'] | None = None
+
+    def __get_pydantic_json_schema__(
+        self, core_schema: core_schema.CoreSchema, handler: GetJsonSchemaHandler
+    ) -> JsonSchemaValue:
+        mode = self.mode or handler.mode
+        if mode != handler.mode:
+            return handler(core_schema)
+        if self.json_schema is None:
+            # This exception is handled in pydantic.json_schema.GenerateJsonSchema._named_required_fields_schema
+            raise PydanticOmit
+        else:
+            return self.json_schema
+
+    def __hash__(self) -> int:
+        return hash(type(self.mode))
+
+
+@dataclasses.dataclass(**_internal_dataclass.slots_true)
+class Examples:
+    """Add examples to a JSON schema.
+
+    Examples should be a map of example names (strings)
+    to example values (any valid JSON).
+
+    If `mode` is set this will only apply to that schema generation mode,
+    allowing you to add different examples for validation and serialization.
+    """
+
+    examples: dict[str, Any]
+    mode: Literal['validation', 'serialization'] | None = None
+
+    def __get_pydantic_json_schema__(
+        self, core_schema: core_schema.CoreSchema, handler: GetJsonSchemaHandler
+    ) -> JsonSchemaValue:
+        mode = self.mode or handler.mode
+        json_schema = handler(core_schema)
+        if mode != handler.mode:
+            return json_schema
+        examples = json_schema.get('examples', {})
+        examples.update(to_jsonable_python(self.examples))
+        json_schema['examples'] = examples
+        return json_schema
+
+    def __hash__(self) -> int:
+        return hash(type(self.mode))
+
+
+def _get_all_json_refs(item: Any) -> set[JsonRef]:
+    """Get all the definitions references from a JSON schema."""
+    refs: set[JsonRef] = set()
+    if isinstance(item, dict):
+        for key, value in item.items():
+            if key == '$ref' and isinstance(value, str):
+                # the isinstance check ensures that '$ref' isn't the name of a property, etc.
+                refs.add(JsonRef(value))
+            elif isinstance(value, dict):
+                refs.update(_get_all_json_refs(value))
+            elif isinstance(value, list):
+                for item in value:
+                    refs.update(_get_all_json_refs(item))
+    elif isinstance(item, list):
+        for item in item:
+            refs.update(_get_all_json_refs(item))
+    return refs
+
+
+AnyType = TypeVar('AnyType')
+
+if TYPE_CHECKING:
+    SkipJsonSchema = Annotated[AnyType, ...]
+else:
+
+    @dataclasses.dataclass(**_internal_dataclass.slots_true)
+    class SkipJsonSchema:
+        """Usage docs: https://docs.pydantic.dev/2.6/concepts/json_schema/#skipjsonschema-annotation
+
+        Add this as an annotation on a field to skip generating a JSON schema for that field.
+
+        Example:
+            ```py
+            from typing import Union
+
+            from pydantic import BaseModel
+            from pydantic.json_schema import SkipJsonSchema
+
+            from pprint import pprint
+
+
+            class Model(BaseModel):
+                a: Union[int, None] = None  # (1)!
+                b: Union[int, SkipJsonSchema[None]] = None  # (2)!
+                c: SkipJsonSchema[Union[int, None]] = None  # (3)!
+
+
+            pprint(Model.model_json_schema())
+            '''
+            {
+                'properties': {
+                    'a': {
+                        'anyOf': [
+                            {'type': 'integer'},
+                            {'type': 'null'}
+                        ],
+                        'default': None,
+                        'title': 'A'
+                    },
+                    'b': {
+                        'default': None,
+                        'title': 'B',
+                        'type': 'integer'
+                    }
+                },
+                'title': 'Model',
+                'type': 'object'
+            }
+            '''
+            ```
+
+            1. The integer and null types are both included in the schema for `a`.
+            2. The integer type is the only type included in the schema for `b`.
+            3. The entirety of the `c` field is omitted from the schema.
+        """
+
+        def __class_getitem__(cls, item: AnyType) -> AnyType:
+            return Annotated[item, cls()]
+
+        def __get_pydantic_json_schema__(
+            self, core_schema: CoreSchema, handler: GetJsonSchemaHandler
+        ) -> JsonSchemaValue:
+            raise PydanticOmit
+
+        def __hash__(self) -> int:
+            return hash(type(self))
+
+
+def _get_typed_dict_config(schema: core_schema.TypedDictSchema) -> ConfigDict:
+    metadata = _core_metadata.CoreMetadataHandler(schema).metadata
+    cls = metadata.get('pydantic_typed_dict_cls')
+    if cls is not None:
+        try:
+            return _decorators.get_attribute_from_bases(cls, '__pydantic_config__')
+        except AttributeError:
+            pass
+    return {}
diff --git a/lib/pydantic/main.py b/lib/pydantic/main.py
index 69f3b751..8c7ebbbf 100644
--- a/lib/pydantic/main.py
+++ b/lib/pydantic/main.py
@@ -1,980 +1,1434 @@
+"""Logic for creating models."""
+from __future__ import annotations as _annotations
+
+import operator
+import sys
+import types
+import typing
 import warnings
-from abc import ABCMeta
-from copy import deepcopy
-from enum import Enum
-from functools import partial
-from pathlib import Path
-from types import FunctionType, prepare_class, resolve_bases
-from typing import (
-    TYPE_CHECKING,
-    AbstractSet,
-    Any,
-    Callable,
-    ClassVar,
-    Dict,
-    List,
-    Mapping,
-    Optional,
-    Tuple,
-    Type,
-    TypeVar,
-    Union,
-    cast,
-    no_type_check,
-    overload,
-)
+from copy import copy, deepcopy
+from typing import Any, ClassVar
 
-from typing_extensions import dataclass_transform
+import pydantic_core
+import typing_extensions
+from pydantic_core import PydanticUndefined
 
-from .class_validators import ValidatorGroup, extract_root_validators, extract_validators, inherit_validators
-from .config import BaseConfig, Extra, inherit_config, prepare_config
-from .error_wrappers import ErrorWrapper, ValidationError
-from .errors import ConfigError, DictError, ExtraError, MissingError
-from .fields import (
-    MAPPING_LIKE_SHAPES,
-    Field,
-    FieldInfo,
-    ModelField,
-    ModelPrivateAttr,
-    PrivateAttr,
-    Undefined,
-    is_finalvar_with_default_val,
-)
-from .json import custom_pydantic_encoder, pydantic_encoder
-from .parse import Protocol, load_file, load_str_bytes
-from .schema import default_ref_template, model_schema
-from .types import PyObject, StrBytes
-from .typing import (
-    AnyCallable,
-    get_args,
-    get_origin,
-    is_classvar,
-    is_namedtuple,
-    is_union,
-    resolve_annotations,
-    update_model_forward_refs,
-)
-from .utils import (
-    DUNDER_ATTRIBUTES,
-    ROOT_KEY,
-    ClassAttribute,
-    GetterDict,
-    Representation,
-    ValueItems,
-    generate_model_signature,
-    is_valid_field,
-    is_valid_private_name,
-    lenient_issubclass,
-    sequence_like,
-    smart_deepcopy,
-    unique_list,
-    validate_field_name,
+from ._internal import (
+    _config,
+    _decorators,
+    _fields,
+    _forward_ref,
+    _generics,
+    _mock_val_ser,
+    _model_construction,
+    _repr,
+    _typing_extra,
+    _utils,
 )
+from ._migration import getattr_migration
+from .annotated_handlers import GetCoreSchemaHandler, GetJsonSchemaHandler
+from .config import ConfigDict
+from .errors import PydanticUndefinedAnnotation, PydanticUserError
+from .json_schema import DEFAULT_REF_TEMPLATE, GenerateJsonSchema, JsonSchemaMode, JsonSchemaValue, model_json_schema
+from .warnings import PydanticDeprecatedSince20
 
-if TYPE_CHECKING:
+if typing.TYPE_CHECKING:
     from inspect import Signature
+    from pathlib import Path
 
-    from .class_validators import ValidatorListDict
-    from .types import ModelOrDc
-    from .typing import (
-        AbstractSetIntStr,
-        AnyClassMethod,
-        CallableGenerator,
-        DictAny,
-        DictStrAny,
-        MappingIntStrAny,
-        ReprArgs,
-        SetStr,
-        TupleGenerator,
-    )
+    from pydantic_core import CoreSchema, SchemaSerializer, SchemaValidator
+    from typing_extensions import Literal, Unpack
 
-    Model = TypeVar('Model', bound='BaseModel')
+    from ._internal._utils import AbstractSetIntStr, MappingIntStrAny
+    from .deprecated.parse import Protocol as DeprecatedParseProtocol
+    from .fields import ComputedFieldInfo, FieldInfo, ModelPrivateAttr
+    from .fields import Field as _Field
 
-__all__ = 'BaseModel', 'create_model', 'validate_model'
+    TupleGenerator = typing.Generator[typing.Tuple[str, Any], None, None]
+    Model = typing.TypeVar('Model', bound='BaseModel')
+    # should be `set[int] | set[str] | dict[int, IncEx] | dict[str, IncEx] | None`, but mypy can't cope
+    IncEx: typing_extensions.TypeAlias = 'set[int] | set[str] | dict[int, Any] | dict[str, Any] | None'
+else:
+    # See PyCharm issues https://youtrack.jetbrains.com/issue/PY-21915
+    # and https://youtrack.jetbrains.com/issue/PY-51428
+    DeprecationWarning = PydanticDeprecatedSince20
 
-_T = TypeVar('_T')
+__all__ = 'BaseModel', 'create_model'
+
+_object_setattr = _model_construction.object_setattr
 
 
-def validate_custom_root_type(fields: Dict[str, ModelField]) -> None:
-    if len(fields) > 1:
-        raise ValueError(f'{ROOT_KEY} cannot be mixed with other fields')
+class BaseModel(metaclass=_model_construction.ModelMetaclass):
+    """Usage docs: https://docs.pydantic.dev/2.6/concepts/models/
 
+    A base class for creating Pydantic models.
 
-def generate_hash_function(frozen: bool) -> Optional[Callable[[Any], int]]:
-    def hash_function(self_: Any) -> int:
-        return hash(self_.__class__) + hash(tuple(self_.__dict__.values()))
+    Attributes:
+        __class_vars__: The names of classvars defined on the model.
+        __private_attributes__: Metadata about the private attributes of the model.
+        __signature__: The signature for instantiating the model.
 
-    return hash_function if frozen else None
+        __pydantic_complete__: Whether model building is completed, or if there are still undefined fields.
+        __pydantic_core_schema__: The pydantic-core schema used to build the SchemaValidator and SchemaSerializer.
+        __pydantic_custom_init__: Whether the model has a custom `__init__` function.
+        __pydantic_decorators__: Metadata containing the decorators defined on the model.
+            This replaces `Model.__validators__` and `Model.__root_validators__` from Pydantic V1.
+        __pydantic_generic_metadata__: Metadata for generic models; contains data used for a similar purpose to
+            __args__, __origin__, __parameters__ in typing-module generics. May eventually be replaced by these.
+        __pydantic_parent_namespace__: Parent namespace of the model, used for automatic rebuilding of models.
+        __pydantic_post_init__: The name of the post-init method for the model, if defined.
+        __pydantic_root_model__: Whether the model is a `RootModel`.
+        __pydantic_serializer__: The pydantic-core SchemaSerializer used to dump instances of the model.
+        __pydantic_validator__: The pydantic-core SchemaValidator used to validate instances of the model.
 
+        __pydantic_extra__: An instance attribute with the values of extra fields from validation when
+            `model_config['extra'] == 'allow'`.
+        __pydantic_fields_set__: An instance attribute with the names of fields explicitly set.
+        __pydantic_private__: Instance attribute with the values of private attributes set on the model instance.
+    """
 
-# If a field is of type `Callable`, its default value should be a function and cannot to ignored.
-ANNOTATED_FIELD_UNTOUCHED_TYPES: Tuple[Any, ...] = (property, type, classmethod, staticmethod)
-# When creating a `BaseModel` instance, we bypass all the methods, properties... added to the model
-UNTOUCHED_TYPES: Tuple[Any, ...] = (FunctionType,) + ANNOTATED_FIELD_UNTOUCHED_TYPES
-# Note `ModelMetaclass` refers to `BaseModel`, but is also used to *create* `BaseModel`, so we need to add this extra
-# (somewhat hacky) boolean to keep track of whether we've created the `BaseModel` class yet, and therefore whether it's
-# safe to refer to it. If it *hasn't* been created, we assume that the `__new__` call we're in the middle of is for
-# the `BaseModel` class, since that's defined immediately after the metaclass.
-_is_base_model_class_defined = False
+    if typing.TYPE_CHECKING:
+        # Here we provide annotations for the attributes of BaseModel.
+        # Many of these are populated by the metaclass, which is why this section is in a `TYPE_CHECKING` block.
+        # However, for the sake of easy review, we have included type annotations of all class and instance attributes
+        # of `BaseModel` here:
 
+        # Class attributes
+        model_config: ClassVar[ConfigDict]
+        """
+        Configuration for the model, should be a dictionary conforming to [`ConfigDict`][pydantic.config.ConfigDict].
+        """
 
-@dataclass_transform(kw_only_default=True, field_descriptors=(Field, FieldInfo))
-class ModelMetaclass(ABCMeta):
-    @no_type_check  # noqa C901
-    def __new__(mcs, name, bases, namespace, **kwargs):  # noqa C901
-        fields: Dict[str, ModelField] = {}
-        config = BaseConfig
-        validators: 'ValidatorListDict' = {}
+        model_fields: ClassVar[dict[str, FieldInfo]]
+        """
+        Metadata about the fields defined on the model,
+        mapping of field names to [`FieldInfo`][pydantic.fields.FieldInfo].
 
-        pre_root_validators, post_root_validators = [], []
-        private_attributes: Dict[str, ModelPrivateAttr] = {}
-        base_private_attributes: Dict[str, ModelPrivateAttr] = {}
-        slots: SetStr = namespace.get('__slots__', ())
-        slots = {slots} if isinstance(slots, str) else set(slots)
-        class_vars: SetStr = set()
-        hash_func: Optional[Callable[[Any], int]] = None
+        This replaces `Model.__fields__` from Pydantic V1.
+        """
 
-        for base in reversed(bases):
-            if _is_base_model_class_defined and issubclass(base, BaseModel) and base != BaseModel:
-                fields.update(smart_deepcopy(base.__fields__))
-                config = inherit_config(base.__config__, config)
-                validators = inherit_validators(base.__validators__, validators)
-                pre_root_validators += base.__pre_root_validators__
-                post_root_validators += base.__post_root_validators__
-                base_private_attributes.update(base.__private_attributes__)
-                class_vars.update(base.__class_vars__)
-                hash_func = base.__hash__
+        model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]]
+        """A dictionary of computed field names and their corresponding `ComputedFieldInfo` objects."""
 
-        resolve_forward_refs = kwargs.pop('__resolve_forward_refs__', True)
-        allowed_config_kwargs: SetStr = {
-            key
-            for key in dir(config)
-            if not (key.startswith('__') and key.endswith('__'))  # skip dunder methods and attributes
-        }
-        config_kwargs = {key: kwargs.pop(key) for key in kwargs.keys() & allowed_config_kwargs}
-        config_from_namespace = namespace.get('Config')
-        if config_kwargs and config_from_namespace:
-            raise TypeError('Specifying config in two places is ambiguous, use either Config attribute or class kwargs')
-        config = inherit_config(config_from_namespace, config, **config_kwargs)
+        __class_vars__: ClassVar[set[str]]
+        __private_attributes__: ClassVar[dict[str, ModelPrivateAttr]]
+        __signature__: ClassVar[Signature]
 
-        validators = inherit_validators(extract_validators(namespace), validators)
-        vg = ValidatorGroup(validators)
+        __pydantic_complete__: ClassVar[bool]
+        __pydantic_core_schema__: ClassVar[CoreSchema]
+        __pydantic_custom_init__: ClassVar[bool]
+        __pydantic_decorators__: ClassVar[_decorators.DecoratorInfos]
+        __pydantic_generic_metadata__: ClassVar[_generics.PydanticGenericMetadata]
+        __pydantic_parent_namespace__: ClassVar[dict[str, Any] | None]
+        __pydantic_post_init__: ClassVar[None | Literal['model_post_init']]
+        __pydantic_root_model__: ClassVar[bool]
+        __pydantic_serializer__: ClassVar[SchemaSerializer]
+        __pydantic_validator__: ClassVar[SchemaValidator]
 
-        for f in fields.values():
-            f.set_config(config)
-            extra_validators = vg.get_validators(f.name)
-            if extra_validators:
-                f.class_validators.update(extra_validators)
-                # re-run prepare to add extra validators
-                f.populate_validators()
+        # Instance attributes
+        # Note: we use the non-existent kwarg `init=False` in pydantic.fields.Field below so that @dataclass_transform
+        # doesn't think these are valid as keyword arguments to the class initializer.
+        __pydantic_extra__: dict[str, Any] | None = _Field(init=False)  # type: ignore
+        __pydantic_fields_set__: set[str] = _Field(init=False)  # type: ignore
+        __pydantic_private__: dict[str, Any] | None = _Field(init=False)  # type: ignore
 
-        prepare_config(config, name)
+    else:
+        # `model_fields` and `__pydantic_decorators__` must be set for
+        # pydantic._internal._generate_schema.GenerateSchema.model_schema to work for a plain BaseModel annotation
+        model_fields = {}
+        model_computed_fields = {}
 
-        untouched_types = ANNOTATED_FIELD_UNTOUCHED_TYPES
+        __pydantic_decorators__ = _decorators.DecoratorInfos()
+        __pydantic_parent_namespace__ = None
+        # Prevent `BaseModel` from being instantiated directly:
+        __pydantic_validator__ = _mock_val_ser.MockValSer(
+            'Pydantic models should inherit from BaseModel, BaseModel cannot be instantiated directly',
+            val_or_ser='validator',
+            code='base-model-instantiated',
+        )
+        __pydantic_serializer__ = _mock_val_ser.MockValSer(
+            'Pydantic models should inherit from BaseModel, BaseModel cannot be instantiated directly',
+            val_or_ser='serializer',
+            code='base-model-instantiated',
+        )
 
-        def is_untouched(v: Any) -> bool:
-            return isinstance(v, untouched_types) or v.__class__.__name__ == 'cython_function_or_method'
+    __slots__ = '__dict__', '__pydantic_fields_set__', '__pydantic_extra__', '__pydantic_private__'
 
-        if (namespace.get('__module__'), namespace.get('__qualname__')) != ('pydantic.main', 'BaseModel'):
-            annotations = resolve_annotations(namespace.get('__annotations__', {}), namespace.get('__module__', None))
-            # annotation only fields need to come first in fields
-            for ann_name, ann_type in annotations.items():
-                if is_classvar(ann_type):
-                    class_vars.add(ann_name)
-                elif is_finalvar_with_default_val(ann_type, namespace.get(ann_name, Undefined)):
-                    class_vars.add(ann_name)
-                elif is_valid_field(ann_name):
-                    validate_field_name(bases, ann_name)
-                    value = namespace.get(ann_name, Undefined)
-                    allowed_types = get_args(ann_type) if is_union(get_origin(ann_type)) else (ann_type,)
-                    if (
-                        is_untouched(value)
-                        and ann_type != PyObject
-                        and not any(
-                            lenient_issubclass(get_origin(allowed_type), Type) for allowed_type in allowed_types
-                        )
-                    ):
-                        continue
-                    fields[ann_name] = ModelField.infer(
-                        name=ann_name,
-                        value=value,
-                        annotation=ann_type,
-                        class_validators=vg.get_validators(ann_name),
-                        config=config,
-                    )
-                elif ann_name not in namespace and config.underscore_attrs_are_private:
-                    private_attributes[ann_name] = PrivateAttr()
+    model_config = ConfigDict()
+    __pydantic_complete__ = False
+    __pydantic_root_model__ = False
 
-            untouched_types = UNTOUCHED_TYPES + config.keep_untouched
-            for var_name, value in namespace.items():
-                can_be_changed = var_name not in class_vars and not is_untouched(value)
-                if isinstance(value, ModelPrivateAttr):
-                    if not is_valid_private_name(var_name):
-                        raise NameError(
-                            f'Private attributes "{var_name}" must not be a valid field name; '
-                            f'Use sunder or dunder names, e. g. "_{var_name}" or "__{var_name}__"'
-                        )
-                    private_attributes[var_name] = value
-                elif config.underscore_attrs_are_private and is_valid_private_name(var_name) and can_be_changed:
-                    private_attributes[var_name] = PrivateAttr(default=value)
-                elif is_valid_field(var_name) and var_name not in annotations and can_be_changed:
-                    validate_field_name(bases, var_name)
-                    inferred = ModelField.infer(
-                        name=var_name,
-                        value=value,
-                        annotation=annotations.get(var_name, Undefined),
-                        class_validators=vg.get_validators(var_name),
-                        config=config,
-                    )
-                    if var_name in fields:
-                        if lenient_issubclass(inferred.type_, fields[var_name].type_):
-                            inferred.type_ = fields[var_name].type_
-                        else:
-                            raise TypeError(
-                                f'The type of {name}.{var_name} differs from the new default value; '
-                                f'if you wish to change the type of this field, please use a type annotation'
-                            )
-                    fields[var_name] = inferred
+    def __init__(self, /, **data: Any) -> None:  # type: ignore
+        """Create a new model by parsing and validating input data from keyword arguments.
 
-        _custom_root_type = ROOT_KEY in fields
-        if _custom_root_type:
-            validate_custom_root_type(fields)
-        vg.check_for_unused()
-        if config.json_encoders:
-            json_encoder = partial(custom_pydantic_encoder, config.json_encoders)
+        Raises [`ValidationError`][pydantic_core.ValidationError] if the input data cannot be
+        validated to form a valid model.
+
+        `self` is explicitly positional-only to allow `self` as a field name.
+        """
+        # `__tracebackhide__` tells pytest and some other tools to omit this function from tracebacks
+        __tracebackhide__ = True
+        self.__pydantic_validator__.validate_python(data, self_instance=self)
+
+    # The following line sets a flag that we use to determine when `__init__` gets overridden by the user
+    __init__.__pydantic_base_init__ = True  # pyright: ignore[reportFunctionMemberAccess]
+
+    @property
+    def model_extra(self) -> dict[str, Any] | None:
+        """Get extra fields set during validation.
+
+        Returns:
+            A dictionary of extra fields, or `None` if `config.extra` is not set to `"allow"`.
+        """
+        return self.__pydantic_extra__
+
+    @property
+    def model_fields_set(self) -> set[str]:
+        """Returns the set of fields that have been explicitly set on this model instance.
+
+        Returns:
+            A set of strings representing the fields that have been set,
+                i.e. that were not filled from defaults.
+        """
+        return self.__pydantic_fields_set__
+
+    @classmethod
+    def model_construct(cls: type[Model], _fields_set: set[str] | None = None, **values: Any) -> Model:
+        """Creates a new instance of the `Model` class with validated data.
+
+        Creates a new model setting `__dict__` and `__pydantic_fields_set__` from trusted or pre-validated data.
+        Default values are respected, but no other validation is performed.
+        Behaves as if `Config.extra = 'allow'` was set since it adds all passed values
+
+        Args:
+            _fields_set: The set of field names accepted for the Model instance.
+            values: Trusted or pre-validated data dictionary.
+
+        Returns:
+            A new instance of the `Model` class with validated data.
+        """
+        m = cls.__new__(cls)
+        fields_values: dict[str, Any] = {}
+        fields_set = set()
+
+        for name, field in cls.model_fields.items():
+            if field.alias and field.alias in values:
+                fields_values[name] = values.pop(field.alias)
+                fields_set.add(name)
+            elif name in values:
+                fields_values[name] = values.pop(name)
+                fields_set.add(name)
+            elif not field.is_required():
+                fields_values[name] = field.get_default(call_default_factory=True)
+        if _fields_set is None:
+            _fields_set = fields_set
+
+        _extra: dict[str, Any] | None = None
+        if cls.model_config.get('extra') == 'allow':
+            _extra = {}
+            for k, v in values.items():
+                _extra[k] = v
         else:
-            json_encoder = pydantic_encoder
-        pre_rv_new, post_rv_new = extract_root_validators(namespace)
+            fields_values.update(values)
+        _object_setattr(m, '__dict__', fields_values)
+        _object_setattr(m, '__pydantic_fields_set__', _fields_set)
+        if not cls.__pydantic_root_model__:
+            _object_setattr(m, '__pydantic_extra__', _extra)
 
-        if hash_func is None:
-            hash_func = generate_hash_function(config.frozen)
+        if cls.__pydantic_post_init__:
+            m.model_post_init(None)
+            # update private attributes with values set
+            if hasattr(m, '__pydantic_private__') and m.__pydantic_private__ is not None:
+                for k, v in values.items():
+                    if k in m.__private_attributes__:
+                        m.__pydantic_private__[k] = v
 
-        exclude_from_namespace = fields | private_attributes.keys() | {'__slots__'}
-        new_namespace = {
-            '__config__': config,
-            '__fields__': fields,
-            '__exclude_fields__': {
-                name: field.field_info.exclude for name, field in fields.items() if field.field_info.exclude is not None
-            }
-            or None,
-            '__include_fields__': {
-                name: field.field_info.include for name, field in fields.items() if field.field_info.include is not None
-            }
-            or None,
-            '__validators__': vg.validators,
-            '__pre_root_validators__': unique_list(
-                pre_root_validators + pre_rv_new,
-                name_factory=lambda v: v.__name__,
-            ),
-            '__post_root_validators__': unique_list(
-                post_root_validators + post_rv_new,
-                name_factory=lambda skip_on_failure_and_v: skip_on_failure_and_v[1].__name__,
-            ),
-            '__schema_cache__': {},
-            '__json_encoder__': staticmethod(json_encoder),
-            '__custom_root_type__': _custom_root_type,
-            '__private_attributes__': {**base_private_attributes, **private_attributes},
-            '__slots__': slots | private_attributes.keys(),
-            '__hash__': hash_func,
-            '__class_vars__': class_vars,
-            **{n: v for n, v in namespace.items() if n not in exclude_from_namespace},
-        }
+        elif not cls.__pydantic_root_model__:
+            # Note: if there are any private attributes, cls.__pydantic_post_init__ would exist
+            # Since it doesn't, that means that `__pydantic_private__` should be set to None
+            _object_setattr(m, '__pydantic_private__', None)
 
-        cls = super().__new__(mcs, name, bases, new_namespace, **kwargs)
-        # set __signature__ attr only for model class, but not for its instances
-        cls.__signature__ = ClassAttribute('__signature__', generate_model_signature(cls.__init__, fields, config))
-        if resolve_forward_refs:
-            cls.__try_update_forward_refs__()
+        return m
 
-        # preserve `__set_name__` protocol defined in https://peps.python.org/pep-0487
-        # for attributes not in `new_namespace` (e.g. private attributes)
-        for name, obj in namespace.items():
-            if name not in new_namespace:
-                set_name = getattr(obj, '__set_name__', None)
-                if callable(set_name):
-                    set_name(cls, name)
+    def model_copy(self: Model, *, update: dict[str, Any] | None = None, deep: bool = False) -> Model:
+        """Usage docs: https://docs.pydantic.dev/2.6/concepts/serialization/#model_copy
 
-        return cls
+        Returns a copy of the model.
 
-    def __instancecheck__(self, instance: Any) -> bool:
+        Args:
+            update: Values to change/add in the new model. Note: the data is not validated
+                before creating the new model. You should trust this data.
+            deep: Set to `True` to make a deep copy of the model.
+
+        Returns:
+            New model instance.
         """
-        Avoid calling ABC _abc_subclasscheck unless we're pretty sure.
+        copied = self.__deepcopy__() if deep else self.__copy__()
+        if update:
+            if self.model_config.get('extra') == 'allow':
+                for k, v in update.items():
+                    if k in self.model_fields:
+                        copied.__dict__[k] = v
+                    else:
+                        if copied.__pydantic_extra__ is None:
+                            copied.__pydantic_extra__ = {}
+                        copied.__pydantic_extra__[k] = v
+            else:
+                copied.__dict__.update(update)
+            copied.__pydantic_fields_set__.update(update.keys())
+        return copied
 
-        See #3829 and python/cpython#92810
-        """
-        return hasattr(instance, '__fields__') and super().__instancecheck__(instance)
-
-
-object_setattr = object.__setattr__
-
-
-class BaseModel(Representation, metaclass=ModelMetaclass):
-    if TYPE_CHECKING:
-        # populated by the metaclass, defined here to help IDEs only
-        __fields__: ClassVar[Dict[str, ModelField]] = {}
-        __include_fields__: ClassVar[Optional[Mapping[str, Any]]] = None
-        __exclude_fields__: ClassVar[Optional[Mapping[str, Any]]] = None
-        __validators__: ClassVar[Dict[str, AnyCallable]] = {}
-        __pre_root_validators__: ClassVar[List[AnyCallable]]
-        __post_root_validators__: ClassVar[List[Tuple[bool, AnyCallable]]]
-        __config__: ClassVar[Type[BaseConfig]] = BaseConfig
-        __json_encoder__: ClassVar[Callable[[Any], Any]] = lambda x: x
-        __schema_cache__: ClassVar['DictAny'] = {}
-        __custom_root_type__: ClassVar[bool] = False
-        __signature__: ClassVar['Signature']
-        __private_attributes__: ClassVar[Dict[str, ModelPrivateAttr]]
-        __class_vars__: ClassVar[SetStr]
-        __fields_set__: ClassVar[SetStr] = set()
-
-    Config = BaseConfig
-    __slots__ = ('__dict__', '__fields_set__')
-    __doc__ = ''  # Null out the Representation docstring
-
-    def __init__(__pydantic_self__, **data: Any) -> None:
-        """
-        Create a new model by parsing and validating input data from keyword arguments.
-
-        Raises ValidationError if the input data cannot be parsed to form a valid model.
-        """
-        # Uses something other than `self` the first arg to allow "self" as a settable attribute
-        values, fields_set, validation_error = validate_model(__pydantic_self__.__class__, data)
-        if validation_error:
-            raise validation_error
-        try:
-            object_setattr(__pydantic_self__, '__dict__', values)
-        except TypeError as e:
-            raise TypeError(
-                'Model values must be a dict; you may not have returned a dictionary from a root validator'
-            ) from e
-        object_setattr(__pydantic_self__, '__fields_set__', fields_set)
-        __pydantic_self__._init_private_attributes()
-
-    @no_type_check
-    def __setattr__(self, name, value):  # noqa: C901 (ignore complexity)
-        if name in self.__private_attributes__ or name in DUNDER_ATTRIBUTES:
-            return object_setattr(self, name, value)
-
-        if self.__config__.extra is not Extra.allow and name not in self.__fields__:
-            raise ValueError(f'"{self.__class__.__name__}" object has no field "{name}"')
-        elif not self.__config__.allow_mutation or self.__config__.frozen:
-            raise TypeError(f'"{self.__class__.__name__}" is immutable and does not support item assignment')
-        elif name in self.__fields__ and self.__fields__[name].final:
-            raise TypeError(
-                f'"{self.__class__.__name__}" object "{name}" field is final and does not support reassignment'
-            )
-        elif self.__config__.validate_assignment:
-            new_values = {**self.__dict__, name: value}
-
-            for validator in self.__pre_root_validators__:
-                try:
-                    new_values = validator(self.__class__, new_values)
-                except (ValueError, TypeError, AssertionError) as exc:
-                    raise ValidationError([ErrorWrapper(exc, loc=ROOT_KEY)], self.__class__)
-
-            known_field = self.__fields__.get(name, None)
-            if known_field:
-                # We want to
-                # - make sure validators are called without the current value for this field inside `values`
-                # - keep other values (e.g. submodels) untouched (using `BaseModel.dict()` will change them into dicts)
-                # - keep the order of the fields
-                if not known_field.field_info.allow_mutation:
-                    raise TypeError(f'"{known_field.name}" has allow_mutation set to False and cannot be assigned')
-                dict_without_original_value = {k: v for k, v in self.__dict__.items() if k != name}
-                value, error_ = known_field.validate(value, dict_without_original_value, loc=name, cls=self.__class__)
-                if error_:
-                    raise ValidationError([error_], self.__class__)
-                else:
-                    new_values[name] = value
-
-            errors = []
-            for skip_on_failure, validator in self.__post_root_validators__:
-                if skip_on_failure and errors:
-                    continue
-                try:
-                    new_values = validator(self.__class__, new_values)
-                except (ValueError, TypeError, AssertionError) as exc:
-                    errors.append(ErrorWrapper(exc, loc=ROOT_KEY))
-            if errors:
-                raise ValidationError(errors, self.__class__)
-
-            # update the whole __dict__ as other values than just `value`
-            # may be changed (e.g. with `root_validator`)
-            object_setattr(self, '__dict__', new_values)
-        else:
-            self.__dict__[name] = value
-
-        self.__fields_set__.add(name)
-
-    def __getstate__(self) -> 'DictAny':
-        private_attrs = ((k, getattr(self, k, Undefined)) for k in self.__private_attributes__)
-        return {
-            '__dict__': self.__dict__,
-            '__fields_set__': self.__fields_set__,
-            '__private_attribute_values__': {k: v for k, v in private_attrs if v is not Undefined},
-        }
-
-    def __setstate__(self, state: 'DictAny') -> None:
-        object_setattr(self, '__dict__', state['__dict__'])
-        object_setattr(self, '__fields_set__', state['__fields_set__'])
-        for name, value in state.get('__private_attribute_values__', {}).items():
-            object_setattr(self, name, value)
-
-    def _init_private_attributes(self) -> None:
-        for name, private_attr in self.__private_attributes__.items():
-            default = private_attr.get_default()
-            if default is not Undefined:
-                object_setattr(self, name, default)
-
-    def dict(
+    def model_dump(
         self,
         *,
-        include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
-        exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
+        mode: Literal['json', 'python'] | str = 'python',
+        include: IncEx = None,
+        exclude: IncEx = None,
         by_alias: bool = False,
-        skip_defaults: Optional[bool] = None,
         exclude_unset: bool = False,
         exclude_defaults: bool = False,
         exclude_none: bool = False,
-    ) -> 'DictStrAny':
-        """
+        round_trip: bool = False,
+        warnings: bool = True,
+    ) -> dict[str, Any]:
+        """Usage docs: https://docs.pydantic.dev/2.6/concepts/serialization/#modelmodel_dump
+
         Generate a dictionary representation of the model, optionally specifying which fields to include or exclude.
 
-        """
-        if skip_defaults is not None:
-            warnings.warn(
-                f'{self.__class__.__name__}.dict(): "skip_defaults" is deprecated and replaced by "exclude_unset"',
-                DeprecationWarning,
-            )
-            exclude_unset = skip_defaults
+        Args:
+            mode: The mode in which `to_python` should run.
+                If mode is 'json', the output will only contain JSON serializable types.
+                If mode is 'python', the output may contain non-JSON-serializable Python objects.
+            include: A list of fields to include in the output.
+            exclude: A list of fields to exclude from the output.
+            by_alias: Whether to use the field's alias in the dictionary key if defined.
+            exclude_unset: Whether to exclude fields that have not been explicitly set.
+            exclude_defaults: Whether to exclude fields that are set to their default value.
+            exclude_none: Whether to exclude fields that have a value of `None`.
+            round_trip: If True, dumped values should be valid as input for non-idempotent types such as Json[T].
+            warnings: Whether to log warnings when invalid fields are encountered.
 
-        return dict(
-            self._iter(
-                to_dict=True,
-                by_alias=by_alias,
-                include=include,
-                exclude=exclude,
-                exclude_unset=exclude_unset,
-                exclude_defaults=exclude_defaults,
-                exclude_none=exclude_none,
-            )
+        Returns:
+            A dictionary representation of the model.
+        """
+        return self.__pydantic_serializer__.to_python(
+            self,
+            mode=mode,
+            by_alias=by_alias,
+            include=include,
+            exclude=exclude,
+            exclude_unset=exclude_unset,
+            exclude_defaults=exclude_defaults,
+            exclude_none=exclude_none,
+            round_trip=round_trip,
+            warnings=warnings,
         )
 
-    def json(
+    def model_dump_json(
         self,
         *,
-        include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
-        exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
+        indent: int | None = None,
+        include: IncEx = None,
+        exclude: IncEx = None,
         by_alias: bool = False,
-        skip_defaults: Optional[bool] = None,
         exclude_unset: bool = False,
         exclude_defaults: bool = False,
         exclude_none: bool = False,
-        encoder: Optional[Callable[[Any], Any]] = None,
-        models_as_dict: bool = True,
+        round_trip: bool = False,
+        warnings: bool = True,
+    ) -> str:
+        """Usage docs: https://docs.pydantic.dev/2.6/concepts/serialization/#modelmodel_dump_json
+
+        Generates a JSON representation of the model using Pydantic's `to_json` method.
+
+        Args:
+            indent: Indentation to use in the JSON output. If None is passed, the output will be compact.
+            include: Field(s) to include in the JSON output.
+            exclude: Field(s) to exclude from the JSON output.
+            by_alias: Whether to serialize using field aliases.
+            exclude_unset: Whether to exclude fields that have not been explicitly set.
+            exclude_defaults: Whether to exclude fields that are set to their default value.
+            exclude_none: Whether to exclude fields that have a value of `None`.
+            round_trip: If True, dumped values should be valid as input for non-idempotent types such as Json[T].
+            warnings: Whether to log warnings when invalid fields are encountered.
+
+        Returns:
+            A JSON string representation of the model.
+        """
+        return self.__pydantic_serializer__.to_json(
+            self,
+            indent=indent,
+            include=include,
+            exclude=exclude,
+            by_alias=by_alias,
+            exclude_unset=exclude_unset,
+            exclude_defaults=exclude_defaults,
+            exclude_none=exclude_none,
+            round_trip=round_trip,
+            warnings=warnings,
+        ).decode()
+
+    @classmethod
+    def model_json_schema(
+        cls,
+        by_alias: bool = True,
+        ref_template: str = DEFAULT_REF_TEMPLATE,
+        schema_generator: type[GenerateJsonSchema] = GenerateJsonSchema,
+        mode: JsonSchemaMode = 'validation',
+    ) -> dict[str, Any]:
+        """Generates a JSON schema for a model class.
+
+        Args:
+            by_alias: Whether to use attribute aliases or not.
+            ref_template: The reference template.
+            schema_generator: To override the logic used to generate the JSON schema, as a subclass of
+                `GenerateJsonSchema` with your desired modifications
+            mode: The mode in which to generate the schema.
+
+        Returns:
+            The JSON schema for the given model class.
+        """
+        return model_json_schema(
+            cls, by_alias=by_alias, ref_template=ref_template, schema_generator=schema_generator, mode=mode
+        )
+
+    @classmethod
+    def model_parametrized_name(cls, params: tuple[type[Any], ...]) -> str:
+        """Compute the class name for parametrizations of generic classes.
+
+        This method can be overridden to achieve a custom naming scheme for generic BaseModels.
+
+        Args:
+            params: Tuple of types of the class. Given a generic class
+                `Model` with 2 type variables and a concrete model `Model[str, int]`,
+                the value `(str, int)` would be passed to `params`.
+
+        Returns:
+            String representing the new class where `params` are passed to `cls` as type variables.
+
+        Raises:
+            TypeError: Raised when trying to generate concrete names for non-generic models.
+        """
+        if not issubclass(cls, typing.Generic):
+            raise TypeError('Concrete names should only be generated for generic models.')
+
+        # Any strings received should represent forward references, so we handle them specially below.
+        # If we eventually move toward wrapping them in a ForwardRef in __class_getitem__ in the future,
+        # we may be able to remove this special case.
+        param_names = [param if isinstance(param, str) else _repr.display_as_type(param) for param in params]
+        params_component = ', '.join(param_names)
+        return f'{cls.__name__}[{params_component}]'
+
+    def model_post_init(self, __context: Any) -> None:
+        """Override this method to perform additional initialization after `__init__` and `model_construct`.
+        This is useful if you want to do some validation that requires the entire model to be initialized.
+        """
+        pass
+
+    @classmethod
+    def model_rebuild(
+        cls,
+        *,
+        force: bool = False,
+        raise_errors: bool = True,
+        _parent_namespace_depth: int = 2,
+        _types_namespace: dict[str, Any] | None = None,
+    ) -> bool | None:
+        """Try to rebuild the pydantic-core schema for the model.
+
+        This may be necessary when one of the annotations is a ForwardRef which could not be resolved during
+        the initial attempt to build the schema, and automatic rebuilding fails.
+
+        Args:
+            force: Whether to force the rebuilding of the model schema, defaults to `False`.
+            raise_errors: Whether to raise errors, defaults to `True`.
+            _parent_namespace_depth: The depth level of the parent namespace, defaults to 2.
+            _types_namespace: The types namespace, defaults to `None`.
+
+        Returns:
+            Returns `None` if the schema is already "complete" and rebuilding was not required.
+            If rebuilding _was_ required, returns `True` if rebuilding was successful, otherwise `False`.
+        """
+        if not force and cls.__pydantic_complete__:
+            return None
+        else:
+            if '__pydantic_core_schema__' in cls.__dict__:
+                delattr(cls, '__pydantic_core_schema__')  # delete cached value to ensure full rebuild happens
+            if _types_namespace is not None:
+                types_namespace: dict[str, Any] | None = _types_namespace.copy()
+            else:
+                if _parent_namespace_depth > 0:
+                    frame_parent_ns = _typing_extra.parent_frame_namespace(parent_depth=_parent_namespace_depth) or {}
+                    cls_parent_ns = (
+                        _model_construction.unpack_lenient_weakvaluedict(cls.__pydantic_parent_namespace__) or {}
+                    )
+                    types_namespace = {**cls_parent_ns, **frame_parent_ns}
+                    cls.__pydantic_parent_namespace__ = _model_construction.build_lenient_weakvaluedict(types_namespace)
+                else:
+                    types_namespace = _model_construction.unpack_lenient_weakvaluedict(
+                        cls.__pydantic_parent_namespace__
+                    )
+
+                types_namespace = _typing_extra.get_cls_types_namespace(cls, types_namespace)
+
+            # manually override defer_build so complete_model_class doesn't skip building the model again
+            config = {**cls.model_config, 'defer_build': False}
+            return _model_construction.complete_model_class(
+                cls,
+                cls.__name__,
+                _config.ConfigWrapper(config, check=False),
+                raise_errors=raise_errors,
+                types_namespace=types_namespace,
+            )
+
+    @classmethod
+    def model_validate(
+        cls: type[Model],
+        obj: Any,
+        *,
+        strict: bool | None = None,
+        from_attributes: bool | None = None,
+        context: dict[str, Any] | None = None,
+    ) -> Model:
+        """Validate a pydantic model instance.
+
+        Args:
+            obj: The object to validate.
+            strict: Whether to enforce types strictly.
+            from_attributes: Whether to extract data from object attributes.
+            context: Additional context to pass to the validator.
+
+        Raises:
+            ValidationError: If the object could not be validated.
+
+        Returns:
+            The validated model instance.
+        """
+        # `__tracebackhide__` tells pytest and some other tools to omit this function from tracebacks
+        __tracebackhide__ = True
+        return cls.__pydantic_validator__.validate_python(
+            obj, strict=strict, from_attributes=from_attributes, context=context
+        )
+
+    @classmethod
+    def model_validate_json(
+        cls: type[Model],
+        json_data: str | bytes | bytearray,
+        *,
+        strict: bool | None = None,
+        context: dict[str, Any] | None = None,
+    ) -> Model:
+        """Usage docs: https://docs.pydantic.dev/2.6/concepts/json/#json-parsing
+
+        Validate the given JSON data against the Pydantic model.
+
+        Args:
+            json_data: The JSON data to validate.
+            strict: Whether to enforce types strictly.
+            context: Extra variables to pass to the validator.
+
+        Returns:
+            The validated Pydantic model.
+
+        Raises:
+            ValueError: If `json_data` is not a JSON string.
+        """
+        # `__tracebackhide__` tells pytest and some other tools to omit this function from tracebacks
+        __tracebackhide__ = True
+        return cls.__pydantic_validator__.validate_json(json_data, strict=strict, context=context)
+
+    @classmethod
+    def model_validate_strings(
+        cls: type[Model],
+        obj: Any,
+        *,
+        strict: bool | None = None,
+        context: dict[str, Any] | None = None,
+    ) -> Model:
+        """Validate the given object contains string data against the Pydantic model.
+
+        Args:
+            obj: The object contains string data to validate.
+            strict: Whether to enforce types strictly.
+            context: Extra variables to pass to the validator.
+
+        Returns:
+            The validated Pydantic model.
+        """
+        # `__tracebackhide__` tells pytest and some other tools to omit this function from tracebacks
+        __tracebackhide__ = True
+        return cls.__pydantic_validator__.validate_strings(obj, strict=strict, context=context)
+
+    @classmethod
+    def __get_pydantic_core_schema__(cls, __source: type[BaseModel], __handler: GetCoreSchemaHandler) -> CoreSchema:
+        """Hook into generating the model's CoreSchema.
+
+        Args:
+            __source: The class we are generating a schema for.
+                This will generally be the same as the `cls` argument if this is a classmethod.
+            __handler: Call into Pydantic's internal JSON schema generation.
+                A callable that calls into Pydantic's internal CoreSchema generation logic.
+
+        Returns:
+            A `pydantic-core` `CoreSchema`.
+        """
+        # Only use the cached value from this _exact_ class; we don't want one from a parent class
+        # This is why we check `cls.__dict__` and don't use `cls.__pydantic_core_schema__` or similar.
+        if '__pydantic_core_schema__' in cls.__dict__:
+            # Due to the way generic classes are built, it's possible that an invalid schema may be temporarily
+            # set on generic classes. I think we could resolve this to ensure that we get proper schema caching
+            # for generics, but for simplicity for now, we just always rebuild if the class has a generic origin.
+            if not cls.__pydantic_generic_metadata__['origin']:
+                return cls.__pydantic_core_schema__
+
+        return __handler(__source)
+
+    @classmethod
+    def __get_pydantic_json_schema__(
+        cls,
+        __core_schema: CoreSchema,
+        __handler: GetJsonSchemaHandler,
+    ) -> JsonSchemaValue:
+        """Hook into generating the model's JSON schema.
+
+        Args:
+            __core_schema: A `pydantic-core` CoreSchema.
+                You can ignore this argument and call the handler with a new CoreSchema,
+                wrap this CoreSchema (`{'type': 'nullable', 'schema': current_schema}`),
+                or just call the handler with the original schema.
+            __handler: Call into Pydantic's internal JSON schema generation.
+                This will raise a `pydantic.errors.PydanticInvalidForJsonSchema` if JSON schema
+                generation fails.
+                Since this gets called by `BaseModel.model_json_schema` you can override the
+                `schema_generator` argument to that function to change JSON schema generation globally
+                for a type.
+
+        Returns:
+            A JSON schema, as a Python object.
+        """
+        return __handler(__core_schema)
+
+    @classmethod
+    def __pydantic_init_subclass__(cls, **kwargs: Any) -> None:
+        """This is intended to behave just like `__init_subclass__`, but is called by `ModelMetaclass`
+        only after the class is actually fully initialized. In particular, attributes like `model_fields` will
+        be present when this is called.
+
+        This is necessary because `__init_subclass__` will always be called by `type.__new__`,
+        and it would require a prohibitively large refactor to the `ModelMetaclass` to ensure that
+        `type.__new__` was called in such a manner that the class would already be sufficiently initialized.
+
+        This will receive the same `kwargs` that would be passed to the standard `__init_subclass__`, namely,
+        any kwargs passed to the class definition that aren't used internally by pydantic.
+
+        Args:
+            **kwargs: Any keyword arguments passed to the class definition that aren't used internally
+                by pydantic.
+        """
+        pass
+
+    def __class_getitem__(
+        cls, typevar_values: type[Any] | tuple[type[Any], ...]
+    ) -> type[BaseModel] | _forward_ref.PydanticRecursiveRef:
+        cached = _generics.get_cached_generic_type_early(cls, typevar_values)
+        if cached is not None:
+            return cached
+
+        if cls is BaseModel:
+            raise TypeError('Type parameters should be placed on typing.Generic, not BaseModel')
+        if not hasattr(cls, '__parameters__'):
+            raise TypeError(f'{cls} cannot be parametrized because it does not inherit from typing.Generic')
+        if not cls.__pydantic_generic_metadata__['parameters'] and typing.Generic not in cls.__bases__:
+            raise TypeError(f'{cls} is not a generic class')
+
+        if not isinstance(typevar_values, tuple):
+            typevar_values = (typevar_values,)
+        _generics.check_parameters_count(cls, typevar_values)
+
+        # Build map from generic typevars to passed params
+        typevars_map: dict[_typing_extra.TypeVarType, type[Any]] = dict(
+            zip(cls.__pydantic_generic_metadata__['parameters'], typevar_values)
+        )
+
+        if _utils.all_identical(typevars_map.keys(), typevars_map.values()) and typevars_map:
+            submodel = cls  # if arguments are equal to parameters it's the same object
+            _generics.set_cached_generic_type(cls, typevar_values, submodel)
+        else:
+            parent_args = cls.__pydantic_generic_metadata__['args']
+            if not parent_args:
+                args = typevar_values
+            else:
+                args = tuple(_generics.replace_types(arg, typevars_map) for arg in parent_args)
+
+            origin = cls.__pydantic_generic_metadata__['origin'] or cls
+            model_name = origin.model_parametrized_name(args)
+            params = tuple(
+                {param: None for param in _generics.iter_contained_typevars(typevars_map.values())}
+            )  # use dict as ordered set
+
+            with _generics.generic_recursion_self_type(origin, args) as maybe_self_type:
+                if maybe_self_type is not None:
+                    return maybe_self_type
+
+                cached = _generics.get_cached_generic_type_late(cls, typevar_values, origin, args)
+                if cached is not None:
+                    return cached
+
+                # Attempt to rebuild the origin in case new types have been defined
+                try:
+                    # depth 3 gets you above this __class_getitem__ call
+                    origin.model_rebuild(_parent_namespace_depth=3)
+                except PydanticUndefinedAnnotation:
+                    # It's okay if it fails, it just means there are still undefined types
+                    # that could be evaluated later.
+                    # TODO: Make sure validation fails if there are still undefined types, perhaps using MockValidator
+                    pass
+
+                submodel = _generics.create_generic_submodel(model_name, origin, args, params)
+
+                # Update cache
+                _generics.set_cached_generic_type(cls, typevar_values, submodel, origin, args)
+
+        return submodel
+
+    def __copy__(self: Model) -> Model:
+        """Returns a shallow copy of the model."""
+        cls = type(self)
+        m = cls.__new__(cls)
+        _object_setattr(m, '__dict__', copy(self.__dict__))
+        _object_setattr(m, '__pydantic_extra__', copy(self.__pydantic_extra__))
+        _object_setattr(m, '__pydantic_fields_set__', copy(self.__pydantic_fields_set__))
+
+        if self.__pydantic_private__ is None:
+            _object_setattr(m, '__pydantic_private__', None)
+        else:
+            _object_setattr(
+                m,
+                '__pydantic_private__',
+                {k: v for k, v in self.__pydantic_private__.items() if v is not PydanticUndefined},
+            )
+
+        return m
+
+    def __deepcopy__(self: Model, memo: dict[int, Any] | None = None) -> Model:
+        """Returns a deep copy of the model."""
+        cls = type(self)
+        m = cls.__new__(cls)
+        _object_setattr(m, '__dict__', deepcopy(self.__dict__, memo=memo))
+        _object_setattr(m, '__pydantic_extra__', deepcopy(self.__pydantic_extra__, memo=memo))
+        # This next line doesn't need a deepcopy because __pydantic_fields_set__ is a set[str],
+        # and attempting a deepcopy would be marginally slower.
+        _object_setattr(m, '__pydantic_fields_set__', copy(self.__pydantic_fields_set__))
+
+        if self.__pydantic_private__ is None:
+            _object_setattr(m, '__pydantic_private__', None)
+        else:
+            _object_setattr(
+                m,
+                '__pydantic_private__',
+                deepcopy({k: v for k, v in self.__pydantic_private__.items() if v is not PydanticUndefined}, memo=memo),
+            )
+
+        return m
+
+    if not typing.TYPE_CHECKING:
+        # We put `__getattr__` in a non-TYPE_CHECKING block because otherwise, mypy allows arbitrary attribute access
+
+        def __getattr__(self, item: str) -> Any:
+            private_attributes = object.__getattribute__(self, '__private_attributes__')
+            if item in private_attributes:
+                attribute = private_attributes[item]
+                if hasattr(attribute, '__get__'):
+                    return attribute.__get__(self, type(self))  # type: ignore
+
+                try:
+                    # Note: self.__pydantic_private__ cannot be None if self.__private_attributes__ has items
+                    return self.__pydantic_private__[item]  # type: ignore
+                except KeyError as exc:
+                    raise AttributeError(f'{type(self).__name__!r} object has no attribute {item!r}') from exc
+            else:
+                # `__pydantic_extra__` can fail to be set if the model is not yet fully initialized.
+                # See `BaseModel.__repr_args__` for more details
+                try:
+                    pydantic_extra = object.__getattribute__(self, '__pydantic_extra__')
+                except AttributeError:
+                    pydantic_extra = None
+
+                if pydantic_extra is not None:
+                    try:
+                        return pydantic_extra[item]
+                    except KeyError as exc:
+                        raise AttributeError(f'{type(self).__name__!r} object has no attribute {item!r}') from exc
+                else:
+                    if hasattr(self.__class__, item):
+                        return super().__getattribute__(item)  # Raises AttributeError if appropriate
+                    else:
+                        # this is the current error
+                        raise AttributeError(f'{type(self).__name__!r} object has no attribute {item!r}')
+
+    def __setattr__(self, name: str, value: Any) -> None:
+        if name in self.__class_vars__:
+            raise AttributeError(
+                f'{name!r} is a ClassVar of `{self.__class__.__name__}` and cannot be set on an instance. '
+                f'If you want to set a value on the class, use `{self.__class__.__name__}.{name} = value`.'
+            )
+        elif not _fields.is_valid_field_name(name):
+            if self.__pydantic_private__ is None or name not in self.__private_attributes__:
+                _object_setattr(self, name, value)
+            else:
+                attribute = self.__private_attributes__[name]
+                if hasattr(attribute, '__set__'):
+                    attribute.__set__(self, value)  # type: ignore
+                else:
+                    self.__pydantic_private__[name] = value
+            return
+
+        self._check_frozen(name, value)
+
+        attr = getattr(self.__class__, name, None)
+        if isinstance(attr, property):
+            attr.__set__(self, value)
+        elif self.model_config.get('validate_assignment', None):
+            self.__pydantic_validator__.validate_assignment(self, name, value)
+        elif self.model_config.get('extra') != 'allow' and name not in self.model_fields:
+            # TODO - matching error
+            raise ValueError(f'"{self.__class__.__name__}" object has no field "{name}"')
+        elif self.model_config.get('extra') == 'allow' and name not in self.model_fields:
+            if self.model_extra and name in self.model_extra:
+                self.__pydantic_extra__[name] = value  # type: ignore
+            else:
+                try:
+                    getattr(self, name)
+                except AttributeError:
+                    # attribute does not already exist on instance, so put it in extra
+                    self.__pydantic_extra__[name] = value  # type: ignore
+                else:
+                    # attribute _does_ already exist on instance, and was not in extra, so update it
+                    _object_setattr(self, name, value)
+        else:
+            self.__dict__[name] = value
+            self.__pydantic_fields_set__.add(name)
+
+    def __delattr__(self, item: str) -> Any:
+        if item in self.__private_attributes__:
+            attribute = self.__private_attributes__[item]
+            if hasattr(attribute, '__delete__'):
+                attribute.__delete__(self)  # type: ignore
+                return
+
+            try:
+                # Note: self.__pydantic_private__ cannot be None if self.__private_attributes__ has items
+                del self.__pydantic_private__[item]  # type: ignore
+                return
+            except KeyError as exc:
+                raise AttributeError(f'{type(self).__name__!r} object has no attribute {item!r}') from exc
+
+        self._check_frozen(item, None)
+
+        if item in self.model_fields:
+            object.__delattr__(self, item)
+        elif self.__pydantic_extra__ is not None and item in self.__pydantic_extra__:
+            del self.__pydantic_extra__[item]
+        else:
+            try:
+                object.__delattr__(self, item)
+            except AttributeError:
+                raise AttributeError(f'{type(self).__name__!r} object has no attribute {item!r}')
+
+    def _check_frozen(self, name: str, value: Any) -> None:
+        if self.model_config.get('frozen', None):
+            typ = 'frozen_instance'
+        elif getattr(self.model_fields.get(name), 'frozen', False):
+            typ = 'frozen_field'
+        else:
+            return
+        error: pydantic_core.InitErrorDetails = {
+            'type': typ,
+            'loc': (name,),
+            'input': value,
+        }
+        raise pydantic_core.ValidationError.from_exception_data(self.__class__.__name__, [error])
+
+    def __getstate__(self) -> dict[Any, Any]:
+        private = self.__pydantic_private__
+        if private:
+            private = {k: v for k, v in private.items() if v is not PydanticUndefined}
+        return {
+            '__dict__': self.__dict__,
+            '__pydantic_extra__': self.__pydantic_extra__,
+            '__pydantic_fields_set__': self.__pydantic_fields_set__,
+            '__pydantic_private__': private,
+        }
+
+    def __setstate__(self, state: dict[Any, Any]) -> None:
+        _object_setattr(self, '__pydantic_fields_set__', state['__pydantic_fields_set__'])
+        _object_setattr(self, '__pydantic_extra__', state['__pydantic_extra__'])
+        _object_setattr(self, '__pydantic_private__', state['__pydantic_private__'])
+        _object_setattr(self, '__dict__', state['__dict__'])
+
+    def __eq__(self, other: Any) -> bool:
+        if isinstance(other, BaseModel):
+            # When comparing instances of generic types for equality, as long as all field values are equal,
+            # only require their generic origin types to be equal, rather than exact type equality.
+            # This prevents headaches like MyGeneric(x=1) != MyGeneric[Any](x=1).
+            self_type = self.__pydantic_generic_metadata__['origin'] or self.__class__
+            other_type = other.__pydantic_generic_metadata__['origin'] or other.__class__
+
+            # Perform common checks first
+            if not (
+                self_type == other_type
+                and self.__pydantic_private__ == other.__pydantic_private__
+                and self.__pydantic_extra__ == other.__pydantic_extra__
+            ):
+                return False
+
+            # We only want to compare pydantic fields but ignoring fields is costly.
+            # We'll perform a fast check first, and fallback only when needed
+            # See GH-7444 and GH-7825 for rationale and a performance benchmark
+
+            # First, do the fast (and sometimes faulty) __dict__ comparison
+            if self.__dict__ == other.__dict__:
+                # If the check above passes, then pydantic fields are equal, we can return early
+                return True
+
+            # We don't want to trigger unnecessary costly filtering of __dict__ on all unequal objects, so we return
+            # early if there are no keys to ignore (we would just return False later on anyway)
+            model_fields = type(self).model_fields.keys()
+            if self.__dict__.keys() <= model_fields and other.__dict__.keys() <= model_fields:
+                return False
+
+            # If we reach here, there are non-pydantic-fields keys, mapped to unequal values, that we need to ignore
+            # Resort to costly filtering of the __dict__ objects
+            # We use operator.itemgetter because it is much faster than dict comprehensions
+            # NOTE: Contrary to standard python class and instances, when the Model class has a default value for an
+            # attribute and the model instance doesn't have a corresponding attribute, accessing the missing attribute
+            # raises an error in BaseModel.__getattr__ instead of returning the class attribute
+            # So we can use operator.itemgetter() instead of operator.attrgetter()
+            getter = operator.itemgetter(*model_fields) if model_fields else lambda _: _utils._SENTINEL
+            try:
+                return getter(self.__dict__) == getter(other.__dict__)
+            except KeyError:
+                # In rare cases (such as when using the deprecated BaseModel.copy() method),
+                # the __dict__ may not contain all model fields, which is how we can get here.
+                # getter(self.__dict__) is much faster than any 'safe' method that accounts
+                # for missing keys, and wrapping it in a `try` doesn't slow things down much
+                # in the common case.
+                self_fields_proxy = _utils.SafeGetItemProxy(self.__dict__)
+                other_fields_proxy = _utils.SafeGetItemProxy(other.__dict__)
+                return getter(self_fields_proxy) == getter(other_fields_proxy)
+
+        # other instance is not a BaseModel
+        else:
+            return NotImplemented  # delegate to the other item in the comparison
+
+    if typing.TYPE_CHECKING:
+        # We put `__init_subclass__` in a TYPE_CHECKING block because, even though we want the type-checking benefits
+        # described in the signature of `__init_subclass__` below, we don't want to modify the default behavior of
+        # subclass initialization.
+
+        def __init_subclass__(cls, **kwargs: Unpack[ConfigDict]):
+            """This signature is included purely to help type-checkers check arguments to class declaration, which
+            provides a way to conveniently set model_config key/value pairs.
+
+            ```py
+            from pydantic import BaseModel
+
+            class MyModel(BaseModel, extra='allow'):
+                ...
+            ```
+
+            However, this may be deceiving, since the _actual_ calls to `__init_subclass__` will not receive any
+            of the config arguments, and will only receive any keyword arguments passed during class initialization
+            that are _not_ expected keys in ConfigDict. (This is due to the way `ModelMetaclass.__new__` works.)
+
+            Args:
+                **kwargs: Keyword arguments passed to the class definition, which set model_config
+
+            Note:
+                You may want to override `__pydantic_init_subclass__` instead, which behaves similarly but is called
+                *after* the class is fully initialized.
+            """
+
+    def __iter__(self) -> TupleGenerator:
+        """So `dict(model)` works."""
+        yield from [(k, v) for (k, v) in self.__dict__.items() if not k.startswith('_')]
+        extra = self.__pydantic_extra__
+        if extra:
+            yield from extra.items()
+
+    def __repr__(self) -> str:
+        return f'{self.__repr_name__()}({self.__repr_str__(", ")})'
+
+    def __repr_args__(self) -> _repr.ReprArgs:
+        for k, v in self.__dict__.items():
+            field = self.model_fields.get(k)
+            if field and field.repr:
+                yield k, v
+
+        # `__pydantic_extra__` can fail to be set if the model is not yet fully initialized.
+        # This can happen if a `ValidationError` is raised during initialization and the instance's
+        # repr is generated as part of the exception handling. Therefore, we use `getattr` here
+        # with a fallback, even though the type hints indicate the attribute will always be present.
+        try:
+            pydantic_extra = object.__getattribute__(self, '__pydantic_extra__')
+        except AttributeError:
+            pydantic_extra = None
+
+        if pydantic_extra is not None:
+            yield from ((k, v) for k, v in pydantic_extra.items())
+        yield from ((k, getattr(self, k)) for k, v in self.model_computed_fields.items() if v.repr)
+
+    # take logic from `_repr.Representation` without the side effects of inheritance, see #5740
+    __repr_name__ = _repr.Representation.__repr_name__
+    __repr_str__ = _repr.Representation.__repr_str__
+    __pretty__ = _repr.Representation.__pretty__
+    __rich_repr__ = _repr.Representation.__rich_repr__
+
+    def __str__(self) -> str:
+        return self.__repr_str__(' ')
+
+    # ##### Deprecated methods from v1 #####
+    @property
+    @typing_extensions.deprecated(
+        'The `__fields__` attribute is deprecated, use `model_fields` instead.', category=None
+    )
+    def __fields__(self) -> dict[str, FieldInfo]:
+        warnings.warn(
+            'The `__fields__` attribute is deprecated, use `model_fields` instead.', category=PydanticDeprecatedSince20
+        )
+        return self.model_fields
+
+    @property
+    @typing_extensions.deprecated(
+        'The `__fields_set__` attribute is deprecated, use `model_fields_set` instead.',
+        category=None,
+    )
+    def __fields_set__(self) -> set[str]:
+        warnings.warn(
+            'The `__fields_set__` attribute is deprecated, use `model_fields_set` instead.',
+            category=PydanticDeprecatedSince20,
+        )
+        return self.__pydantic_fields_set__
+
+    @typing_extensions.deprecated('The `dict` method is deprecated; use `model_dump` instead.', category=None)
+    def dict(  # noqa: D102
+        self,
+        *,
+        include: IncEx = None,
+        exclude: IncEx = None,
+        by_alias: bool = False,
+        exclude_unset: bool = False,
+        exclude_defaults: bool = False,
+        exclude_none: bool = False,
+    ) -> typing.Dict[str, Any]:  # noqa UP006
+        warnings.warn('The `dict` method is deprecated; use `model_dump` instead.', category=PydanticDeprecatedSince20)
+        return self.model_dump(
+            include=include,
+            exclude=exclude,
+            by_alias=by_alias,
+            exclude_unset=exclude_unset,
+            exclude_defaults=exclude_defaults,
+            exclude_none=exclude_none,
+        )
+
+    @typing_extensions.deprecated('The `json` method is deprecated; use `model_dump_json` instead.', category=None)
+    def json(  # noqa: D102
+        self,
+        *,
+        include: IncEx = None,
+        exclude: IncEx = None,
+        by_alias: bool = False,
+        exclude_unset: bool = False,
+        exclude_defaults: bool = False,
+        exclude_none: bool = False,
+        encoder: typing.Callable[[Any], Any] | None = PydanticUndefined,  # type: ignore[assignment]
+        models_as_dict: bool = PydanticUndefined,  # type: ignore[assignment]
         **dumps_kwargs: Any,
     ) -> str:
-        """
-        Generate a JSON representation of the model, `include` and `exclude` arguments as per `dict()`.
-
-        `encoder` is an optional function to supply as `default` to json.dumps(), other arguments as per `json.dumps()`.
-        """
-        if skip_defaults is not None:
-            warnings.warn(
-                f'{self.__class__.__name__}.json(): "skip_defaults" is deprecated and replaced by "exclude_unset"',
-                DeprecationWarning,
-            )
-            exclude_unset = skip_defaults
-        encoder = cast(Callable[[Any], Any], encoder or self.__json_encoder__)
-
-        # We don't directly call `self.dict()`, which does exactly this with `to_dict=True`
-        # because we want to be able to keep raw `BaseModel` instances and not as `dict`.
-        # This allows users to write custom JSON encoders for given `BaseModel` classes.
-        data = dict(
-            self._iter(
-                to_dict=models_as_dict,
-                by_alias=by_alias,
-                include=include,
-                exclude=exclude,
-                exclude_unset=exclude_unset,
-                exclude_defaults=exclude_defaults,
-                exclude_none=exclude_none,
-            )
+        warnings.warn(
+            'The `json` method is deprecated; use `model_dump_json` instead.', category=PydanticDeprecatedSince20
+        )
+        if encoder is not PydanticUndefined:
+            raise TypeError('The `encoder` argument is no longer supported; use field serializers instead.')
+        if models_as_dict is not PydanticUndefined:
+            raise TypeError('The `models_as_dict` argument is no longer supported; use a model serializer instead.')
+        if dumps_kwargs:
+            raise TypeError('`dumps_kwargs` keyword arguments are no longer supported.')
+        return self.model_dump_json(
+            include=include,
+            exclude=exclude,
+            by_alias=by_alias,
+            exclude_unset=exclude_unset,
+            exclude_defaults=exclude_defaults,
+            exclude_none=exclude_none,
         )
-        if self.__custom_root_type__:
-            data = data[ROOT_KEY]
-        return self.__config__.json_dumps(data, default=encoder, **dumps_kwargs)
 
     @classmethod
-    def _enforce_dict_if_root(cls, obj: Any) -> Any:
-        if cls.__custom_root_type__ and (
-            not (isinstance(obj, dict) and obj.keys() == {ROOT_KEY})
-            or cls.__fields__[ROOT_KEY].shape in MAPPING_LIKE_SHAPES
-        ):
-            return {ROOT_KEY: obj}
-        else:
-            return obj
+    @typing_extensions.deprecated('The `parse_obj` method is deprecated; use `model_validate` instead.', category=None)
+    def parse_obj(cls: type[Model], obj: Any) -> Model:  # noqa: D102
+        warnings.warn(
+            'The `parse_obj` method is deprecated; use `model_validate` instead.', category=PydanticDeprecatedSince20
+        )
+        return cls.model_validate(obj)
 
     @classmethod
-    def parse_obj(cls: Type['Model'], obj: Any) -> 'Model':
-        obj = cls._enforce_dict_if_root(obj)
-        if not isinstance(obj, dict):
-            try:
-                obj = dict(obj)
-            except (TypeError, ValueError) as e:
-                exc = TypeError(f'{cls.__name__} expected dict not {obj.__class__.__name__}')
-                raise ValidationError([ErrorWrapper(exc, loc=ROOT_KEY)], cls) from e
-        return cls(**obj)
-
-    @classmethod
-    def parse_raw(
-        cls: Type['Model'],
-        b: StrBytes,
+    @typing_extensions.deprecated(
+        'The `parse_raw` method is deprecated; if your data is JSON use `model_validate_json`, '
+        'otherwise load the data then use `model_validate` instead.',
+        category=None,
+    )
+    def parse_raw(  # noqa: D102
+        cls: type[Model],
+        b: str | bytes,
         *,
-        content_type: str = None,
+        content_type: str | None = None,
         encoding: str = 'utf8',
-        proto: Protocol = None,
+        proto: DeprecatedParseProtocol | None = None,
         allow_pickle: bool = False,
-    ) -> 'Model':
+    ) -> Model:  # pragma: no cover
+        warnings.warn(
+            'The `parse_raw` method is deprecated; if your data is JSON use `model_validate_json`, '
+            'otherwise load the data then use `model_validate` instead.',
+            category=PydanticDeprecatedSince20,
+        )
+        from .deprecated import parse
+
         try:
-            obj = load_str_bytes(
+            obj = parse.load_str_bytes(
                 b,
                 proto=proto,
                 content_type=content_type,
                 encoding=encoding,
                 allow_pickle=allow_pickle,
-                json_loads=cls.__config__.json_loads,
             )
-        except (ValueError, TypeError, UnicodeDecodeError) as e:
-            raise ValidationError([ErrorWrapper(e, loc=ROOT_KEY)], cls)
-        return cls.parse_obj(obj)
+        except (ValueError, TypeError) as exc:
+            import json
+
+            # try to match V1
+            if isinstance(exc, UnicodeDecodeError):
+                type_str = 'value_error.unicodedecode'
+            elif isinstance(exc, json.JSONDecodeError):
+                type_str = 'value_error.jsondecode'
+            elif isinstance(exc, ValueError):
+                type_str = 'value_error'
+            else:
+                type_str = 'type_error'
+
+            # ctx is missing here, but since we've added `input` to the error, we're not pretending it's the same
+            error: pydantic_core.InitErrorDetails = {
+                # The type: ignore on the next line is to ignore the requirement of LiteralString
+                'type': pydantic_core.PydanticCustomError(type_str, str(exc)),  # type: ignore
+                'loc': ('__root__',),
+                'input': b,
+            }
+            raise pydantic_core.ValidationError.from_exception_data(cls.__name__, [error])
+        return cls.model_validate(obj)
 
     @classmethod
-    def parse_file(
-        cls: Type['Model'],
-        path: Union[str, Path],
+    @typing_extensions.deprecated(
+        'The `parse_file` method is deprecated; load the data from file, then if your data is JSON '
+        'use `model_validate_json`, otherwise `model_validate` instead.',
+        category=None,
+    )
+    def parse_file(  # noqa: D102
+        cls: type[Model],
+        path: str | Path,
         *,
-        content_type: str = None,
+        content_type: str | None = None,
         encoding: str = 'utf8',
-        proto: Protocol = None,
+        proto: DeprecatedParseProtocol | None = None,
         allow_pickle: bool = False,
-    ) -> 'Model':
-        obj = load_file(
+    ) -> Model:
+        warnings.warn(
+            'The `parse_file` method is deprecated; load the data from file, then if your data is JSON '
+            'use `model_validate_json`, otherwise `model_validate` instead.',
+            category=PydanticDeprecatedSince20,
+        )
+        from .deprecated import parse
+
+        obj = parse.load_file(
             path,
             proto=proto,
             content_type=content_type,
             encoding=encoding,
             allow_pickle=allow_pickle,
-            json_loads=cls.__config__.json_loads,
         )
         return cls.parse_obj(obj)
 
     @classmethod
-    def from_orm(cls: Type['Model'], obj: Any) -> 'Model':
-        if not cls.__config__.orm_mode:
-            raise ConfigError('You must have the config attribute orm_mode=True to use from_orm')
-        obj = {ROOT_KEY: obj} if cls.__custom_root_type__ else cls._decompose_class(obj)
-        m = cls.__new__(cls)
-        values, fields_set, validation_error = validate_model(cls, obj)
-        if validation_error:
-            raise validation_error
-        object_setattr(m, '__dict__', values)
-        object_setattr(m, '__fields_set__', fields_set)
-        m._init_private_attributes()
-        return m
+    @typing_extensions.deprecated(
+        'The `from_orm` method is deprecated; set '
+        "`model_config['from_attributes']=True` and use `model_validate` instead.",
+        category=None,
+    )
+    def from_orm(cls: type[Model], obj: Any) -> Model:  # noqa: D102
+        warnings.warn(
+            'The `from_orm` method is deprecated; set '
+            "`model_config['from_attributes']=True` and use `model_validate` instead.",
+            category=PydanticDeprecatedSince20,
+        )
+        if not cls.model_config.get('from_attributes', None):
+            raise PydanticUserError(
+                'You must set the config attribute `from_attributes=True` to use from_orm', code=None
+            )
+        return cls.model_validate(obj)
 
     @classmethod
-    def construct(cls: Type['Model'], _fields_set: Optional['SetStr'] = None, **values: Any) -> 'Model':
-        """
-        Creates a new model setting __dict__ and __fields_set__ from trusted or pre-validated data.
-        Default values are respected, but no other validation is performed.
-        Behaves as if `Config.extra = 'allow'` was set since it adds all passed values
-        """
-        m = cls.__new__(cls)
-        fields_values: Dict[str, Any] = {}
-        for name, field in cls.__fields__.items():
-            if field.alt_alias and field.alias in values:
-                fields_values[name] = values[field.alias]
-            elif name in values:
-                fields_values[name] = values[name]
-            elif not field.required:
-                fields_values[name] = field.get_default()
-        fields_values.update(values)
-        object_setattr(m, '__dict__', fields_values)
-        if _fields_set is None:
-            _fields_set = set(values.keys())
-        object_setattr(m, '__fields_set__', _fields_set)
-        m._init_private_attributes()
-        return m
-
-    def _copy_and_set_values(self: 'Model', values: 'DictStrAny', fields_set: 'SetStr', *, deep: bool) -> 'Model':
-        if deep:
-            # chances of having empty dict here are quite low for using smart_deepcopy
-            values = deepcopy(values)
-
-        cls = self.__class__
-        m = cls.__new__(cls)
-        object_setattr(m, '__dict__', values)
-        object_setattr(m, '__fields_set__', fields_set)
-        for name in self.__private_attributes__:
-            value = getattr(self, name, Undefined)
-            if value is not Undefined:
-                if deep:
-                    value = deepcopy(value)
-                object_setattr(m, name, value)
-
-        return m
+    @typing_extensions.deprecated('The `construct` method is deprecated; use `model_construct` instead.', category=None)
+    def construct(cls: type[Model], _fields_set: set[str] | None = None, **values: Any) -> Model:  # noqa: D102
+        warnings.warn(
+            'The `construct` method is deprecated; use `model_construct` instead.', category=PydanticDeprecatedSince20
+        )
+        return cls.model_construct(_fields_set=_fields_set, **values)
 
+    @typing_extensions.deprecated(
+        'The `copy` method is deprecated; use `model_copy` instead. '
+        'See the docstring of `BaseModel.copy` for details about how to handle `include` and `exclude`.',
+        category=None,
+    )
     def copy(
-        self: 'Model',
+        self: Model,
         *,
-        include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
-        exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
-        update: Optional['DictStrAny'] = None,
+        include: AbstractSetIntStr | MappingIntStrAny | None = None,
+        exclude: AbstractSetIntStr | MappingIntStrAny | None = None,
+        update: typing.Dict[str, Any] | None = None,  # noqa UP006
         deep: bool = False,
-    ) -> 'Model':
-        """
-        Duplicate a model, optionally choose which fields to include, exclude and change.
+    ) -> Model:  # pragma: no cover
+        """Returns a copy of the model.
 
-        :param include: fields to include in new model
-        :param exclude: fields to exclude from new model, as with values this takes precedence over include
-        :param update: values to change/add in the new model. Note: the data is not validated before creating
-            the new model: you should trust this data
-        :param deep: set to `True` to make a deep copy of the model
-        :return: new model instance
+        !!! warning "Deprecated"
+            This method is now deprecated; use `model_copy` instead.
+
+        If you need `include` or `exclude`, use:
+
+        ```py
+        data = self.model_dump(include=include, exclude=exclude, round_trip=True)
+        data = {**data, **(update or {})}
+        copied = self.model_validate(data)
+        ```
+
+        Args:
+            include: Optional set or mapping specifying which fields to include in the copied model.
+            exclude: Optional set or mapping specifying which fields to exclude in the copied model.
+            update: Optional dictionary of field-value pairs to override field values in the copied model.
+            deep: If True, the values of fields that are Pydantic models will be deep-copied.
+
+        Returns:
+            A copy of the model with included, excluded and updated fields as specified.
         """
+        warnings.warn(
+            'The `copy` method is deprecated; use `model_copy` instead. '
+            'See the docstring of `BaseModel.copy` for details about how to handle `include` and `exclude`.',
+            category=PydanticDeprecatedSince20,
+        )
+        from .deprecated import copy_internals
 
         values = dict(
-            self._iter(to_dict=False, by_alias=False, include=include, exclude=exclude, exclude_unset=False),
+            copy_internals._iter(
+                self, to_dict=False, by_alias=False, include=include, exclude=exclude, exclude_unset=False
+            ),
             **(update or {}),
         )
+        if self.__pydantic_private__ is None:
+            private = None
+        else:
+            private = {k: v for k, v in self.__pydantic_private__.items() if v is not PydanticUndefined}
 
-        # new `__fields_set__` can have unset optional fields with a set value in `update` kwarg
+        if self.__pydantic_extra__ is None:
+            extra: dict[str, Any] | None = None
+        else:
+            extra = self.__pydantic_extra__.copy()
+            for k in list(self.__pydantic_extra__):
+                if k not in values:  # k was in the exclude
+                    extra.pop(k)
+            for k in list(values):
+                if k in self.__pydantic_extra__:  # k must have come from extra
+                    extra[k] = values.pop(k)
+
+        # new `__pydantic_fields_set__` can have unset optional fields with a set value in `update` kwarg
         if update:
-            fields_set = self.__fields_set__ | update.keys()
+            fields_set = self.__pydantic_fields_set__ | update.keys()
         else:
-            fields_set = set(self.__fields_set__)
-
-        return self._copy_and_set_values(values, fields_set, deep=deep)
-
-    @classmethod
-    def schema(cls, by_alias: bool = True, ref_template: str = default_ref_template) -> 'DictStrAny':
-        cached = cls.__schema_cache__.get((by_alias, ref_template))
-        if cached is not None:
-            return cached
-        s = model_schema(cls, by_alias=by_alias, ref_template=ref_template)
-        cls.__schema_cache__[(by_alias, ref_template)] = s
-        return s
-
-    @classmethod
-    def schema_json(
-        cls, *, by_alias: bool = True, ref_template: str = default_ref_template, **dumps_kwargs: Any
-    ) -> str:
-        from .json import pydantic_encoder
-
-        return cls.__config__.json_dumps(
-            cls.schema(by_alias=by_alias, ref_template=ref_template), default=pydantic_encoder, **dumps_kwargs
-        )
-
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield cls.validate
-
-    @classmethod
-    def validate(cls: Type['Model'], value: Any) -> 'Model':
-        if isinstance(value, cls):
-            copy_on_model_validation = cls.__config__.copy_on_model_validation
-            # whether to deep or shallow copy the model on validation, None means do not copy
-            deep_copy: Optional[bool] = None
-            if copy_on_model_validation not in {'deep', 'shallow', 'none'}:
-                # Warn about deprecated behavior
-                warnings.warn(
-                    "`copy_on_model_validation` should be a string: 'deep', 'shallow' or 'none'", DeprecationWarning
-                )
-                if copy_on_model_validation:
-                    deep_copy = False
-
-            if copy_on_model_validation == 'shallow':
-                # shallow copy
-                deep_copy = False
-            elif copy_on_model_validation == 'deep':
-                # deep copy
-                deep_copy = True
-
-            if deep_copy is None:
-                return value
-            else:
-                return value._copy_and_set_values(value.__dict__, value.__fields_set__, deep=deep_copy)
-
-        value = cls._enforce_dict_if_root(value)
-
-        if isinstance(value, dict):
-            return cls(**value)
-        elif cls.__config__.orm_mode:
-            return cls.from_orm(value)
-        else:
-            try:
-                value_as_dict = dict(value)
-            except (TypeError, ValueError) as e:
-                raise DictError() from e
-            return cls(**value_as_dict)
-
-    @classmethod
-    def _decompose_class(cls: Type['Model'], obj: Any) -> GetterDict:
-        if isinstance(obj, GetterDict):
-            return obj
-        return cls.__config__.getter_dict(obj)
-
-    @classmethod
-    @no_type_check
-    def _get_value(
-        cls,
-        v: Any,
-        to_dict: bool,
-        by_alias: bool,
-        include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']],
-        exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']],
-        exclude_unset: bool,
-        exclude_defaults: bool,
-        exclude_none: bool,
-    ) -> Any:
-
-        if isinstance(v, BaseModel):
-            if to_dict:
-                v_dict = v.dict(
-                    by_alias=by_alias,
-                    exclude_unset=exclude_unset,
-                    exclude_defaults=exclude_defaults,
-                    include=include,
-                    exclude=exclude,
-                    exclude_none=exclude_none,
-                )
-                if ROOT_KEY in v_dict:
-                    return v_dict[ROOT_KEY]
-                return v_dict
-            else:
-                return v.copy(include=include, exclude=exclude)
-
-        value_exclude = ValueItems(v, exclude) if exclude else None
-        value_include = ValueItems(v, include) if include else None
-
-        if isinstance(v, dict):
-            return {
-                k_: cls._get_value(
-                    v_,
-                    to_dict=to_dict,
-                    by_alias=by_alias,
-                    exclude_unset=exclude_unset,
-                    exclude_defaults=exclude_defaults,
-                    include=value_include and value_include.for_element(k_),
-                    exclude=value_exclude and value_exclude.for_element(k_),
-                    exclude_none=exclude_none,
-                )
-                for k_, v_ in v.items()
-                if (not value_exclude or not value_exclude.is_excluded(k_))
-                and (not value_include or value_include.is_included(k_))
-            }
-
-        elif sequence_like(v):
-            seq_args = (
-                cls._get_value(
-                    v_,
-                    to_dict=to_dict,
-                    by_alias=by_alias,
-                    exclude_unset=exclude_unset,
-                    exclude_defaults=exclude_defaults,
-                    include=value_include and value_include.for_element(i),
-                    exclude=value_exclude and value_exclude.for_element(i),
-                    exclude_none=exclude_none,
-                )
-                for i, v_ in enumerate(v)
-                if (not value_exclude or not value_exclude.is_excluded(i))
-                and (not value_include or value_include.is_included(i))
-            )
-
-            return v.__class__(*seq_args) if is_namedtuple(v.__class__) else v.__class__(seq_args)
-
-        elif isinstance(v, Enum) and getattr(cls.Config, 'use_enum_values', False):
-            return v.value
-
-        else:
-            return v
-
-    @classmethod
-    def __try_update_forward_refs__(cls, **localns: Any) -> None:
-        """
-        Same as update_forward_refs but will not raise exception
-        when forward references are not defined.
-        """
-        update_model_forward_refs(cls, cls.__fields__.values(), cls.__config__.json_encoders, localns, (NameError,))
-
-    @classmethod
-    def update_forward_refs(cls, **localns: Any) -> None:
-        """
-        Try to update ForwardRefs on fields based on this Model, globalns and localns.
-        """
-        update_model_forward_refs(cls, cls.__fields__.values(), cls.__config__.json_encoders, localns)
-
-    def __iter__(self) -> 'TupleGenerator':
-        """
-        so `dict(model)` works
-        """
-        yield from self.__dict__.items()
-
-    def _iter(
-        self,
-        to_dict: bool = False,
-        by_alias: bool = False,
-        include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
-        exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
-        exclude_unset: bool = False,
-        exclude_defaults: bool = False,
-        exclude_none: bool = False,
-    ) -> 'TupleGenerator':
-
-        # Merge field set excludes with explicit exclude parameter with explicit overriding field set options.
-        # The extra "is not None" guards are not logically necessary but optimizes performance for the simple case.
-        if exclude is not None or self.__exclude_fields__ is not None:
-            exclude = ValueItems.merge(self.__exclude_fields__, exclude)
-
-        if include is not None or self.__include_fields__ is not None:
-            include = ValueItems.merge(self.__include_fields__, include, intersect=True)
-
-        allowed_keys = self._calculate_keys(
-            include=include, exclude=exclude, exclude_unset=exclude_unset  # type: ignore
-        )
-        if allowed_keys is None and not (to_dict or by_alias or exclude_unset or exclude_defaults or exclude_none):
-            # huge boost for plain _iter()
-            yield from self.__dict__.items()
-            return
-
-        value_exclude = ValueItems(self, exclude) if exclude is not None else None
-        value_include = ValueItems(self, include) if include is not None else None
-
-        for field_key, v in self.__dict__.items():
-            if (allowed_keys is not None and field_key not in allowed_keys) or (exclude_none and v is None):
-                continue
-
-            if exclude_defaults:
-                model_field = self.__fields__.get(field_key)
-                if not getattr(model_field, 'required', True) and getattr(model_field, 'default', _missing) == v:
-                    continue
-
-            if by_alias and field_key in self.__fields__:
-                dict_key = self.__fields__[field_key].alias
-            else:
-                dict_key = field_key
-
-            if to_dict or value_include or value_exclude:
-                v = self._get_value(
-                    v,
-                    to_dict=to_dict,
-                    by_alias=by_alias,
-                    include=value_include and value_include.for_element(field_key),
-                    exclude=value_exclude and value_exclude.for_element(field_key),
-                    exclude_unset=exclude_unset,
-                    exclude_defaults=exclude_defaults,
-                    exclude_none=exclude_none,
-                )
-            yield dict_key, v
-
-    def _calculate_keys(
-        self,
-        include: Optional['MappingIntStrAny'],
-        exclude: Optional['MappingIntStrAny'],
-        exclude_unset: bool,
-        update: Optional['DictStrAny'] = None,
-    ) -> Optional[AbstractSet[str]]:
-        if include is None and exclude is None and exclude_unset is False:
-            return None
-
-        keys: AbstractSet[str]
-        if exclude_unset:
-            keys = self.__fields_set__.copy()
-        else:
-            keys = self.__dict__.keys()
-
-        if include is not None:
-            keys &= include.keys()
-
-        if update:
-            keys -= update.keys()
+            fields_set = set(self.__pydantic_fields_set__)
 
+        # removing excluded fields from `__pydantic_fields_set__`
         if exclude:
-            keys -= {k for k, v in exclude.items() if ValueItems.is_true(v)}
+            fields_set -= set(exclude)
 
-        return keys
+        return copy_internals._copy_and_set_values(self, values, fields_set, extra, private, deep=deep)
 
-    def __eq__(self, other: Any) -> bool:
-        if isinstance(other, BaseModel):
-            return self.dict() == other.dict()
-        else:
-            return self.dict() == other
+    @classmethod
+    @typing_extensions.deprecated('The `schema` method is deprecated; use `model_json_schema` instead.', category=None)
+    def schema(  # noqa: D102
+        cls, by_alias: bool = True, ref_template: str = DEFAULT_REF_TEMPLATE
+    ) -> typing.Dict[str, Any]:  # noqa UP006
+        warnings.warn(
+            'The `schema` method is deprecated; use `model_json_schema` instead.', category=PydanticDeprecatedSince20
+        )
+        return cls.model_json_schema(by_alias=by_alias, ref_template=ref_template)
 
-    def __repr_args__(self) -> 'ReprArgs':
-        return [
-            (k, v)
-            for k, v in self.__dict__.items()
-            if k not in DUNDER_ATTRIBUTES and (k not in self.__fields__ or self.__fields__[k].field_info.repr)
-        ]
+    @classmethod
+    @typing_extensions.deprecated(
+        'The `schema_json` method is deprecated; use `model_json_schema` and json.dumps instead.',
+        category=None,
+    )
+    def schema_json(  # noqa: D102
+        cls, *, by_alias: bool = True, ref_template: str = DEFAULT_REF_TEMPLATE, **dumps_kwargs: Any
+    ) -> str:  # pragma: no cover
+        warnings.warn(
+            'The `schema_json` method is deprecated; use `model_json_schema` and json.dumps instead.',
+            category=PydanticDeprecatedSince20,
+        )
+        import json
+
+        from .deprecated.json import pydantic_encoder
+
+        return json.dumps(
+            cls.model_json_schema(by_alias=by_alias, ref_template=ref_template),
+            default=pydantic_encoder,
+            **dumps_kwargs,
+        )
+
+    @classmethod
+    @typing_extensions.deprecated('The `validate` method is deprecated; use `model_validate` instead.', category=None)
+    def validate(cls: type[Model], value: Any) -> Model:  # noqa: D102
+        warnings.warn(
+            'The `validate` method is deprecated; use `model_validate` instead.', category=PydanticDeprecatedSince20
+        )
+        return cls.model_validate(value)
+
+    @classmethod
+    @typing_extensions.deprecated(
+        'The `update_forward_refs` method is deprecated; use `model_rebuild` instead.',
+        category=None,
+    )
+    def update_forward_refs(cls, **localns: Any) -> None:  # noqa: D102
+        warnings.warn(
+            'The `update_forward_refs` method is deprecated; use `model_rebuild` instead.',
+            category=PydanticDeprecatedSince20,
+        )
+        if localns:  # pragma: no cover
+            raise TypeError('`localns` arguments are not longer accepted.')
+        cls.model_rebuild(force=True)
+
+    @typing_extensions.deprecated(
+        'The private method `_iter` will be removed and should no longer be used.', category=None
+    )
+    def _iter(self, *args: Any, **kwargs: Any) -> Any:
+        warnings.warn(
+            'The private method `_iter` will be removed and should no longer be used.',
+            category=PydanticDeprecatedSince20,
+        )
+        from .deprecated import copy_internals
+
+        return copy_internals._iter(self, *args, **kwargs)
+
+    @typing_extensions.deprecated(
+        'The private method `_copy_and_set_values` will be removed and should no longer be used.',
+        category=None,
+    )
+    def _copy_and_set_values(self, *args: Any, **kwargs: Any) -> Any:
+        warnings.warn(
+            'The private method `_copy_and_set_values` will be removed and should no longer be used.',
+            category=PydanticDeprecatedSince20,
+        )
+        from .deprecated import copy_internals
+
+        return copy_internals._copy_and_set_values(self, *args, **kwargs)
+
+    @classmethod
+    @typing_extensions.deprecated(
+        'The private method `_get_value` will be removed and should no longer be used.',
+        category=None,
+    )
+    def _get_value(cls, *args: Any, **kwargs: Any) -> Any:
+        warnings.warn(
+            'The private method `_get_value` will be removed and should no longer be used.',
+            category=PydanticDeprecatedSince20,
+        )
+        from .deprecated import copy_internals
+
+        return copy_internals._get_value(cls, *args, **kwargs)
+
+    @typing_extensions.deprecated(
+        'The private method `_calculate_keys` will be removed and should no longer be used.',
+        category=None,
+    )
+    def _calculate_keys(self, *args: Any, **kwargs: Any) -> Any:
+        warnings.warn(
+            'The private method `_calculate_keys` will be removed and should no longer be used.',
+            category=PydanticDeprecatedSince20,
+        )
+        from .deprecated import copy_internals
+
+        return copy_internals._calculate_keys(self, *args, **kwargs)
 
 
-_is_base_model_class_defined = True
-
-
-@overload
+@typing.overload
 def create_model(
     __model_name: str,
     *,
-    __config__: Optional[Type[BaseConfig]] = None,
+    __config__: ConfigDict | None = None,
+    __doc__: str | None = None,
     __base__: None = None,
     __module__: str = __name__,
-    __validators__: Dict[str, 'AnyClassMethod'] = None,
-    __cls_kwargs__: Dict[str, Any] = None,
+    __validators__: dict[str, classmethod] | None = None,
+    __cls_kwargs__: dict[str, Any] | None = None,
     **field_definitions: Any,
-) -> Type['BaseModel']:
+) -> type[BaseModel]:
     ...
 
 
-@overload
+@typing.overload
 def create_model(
     __model_name: str,
     *,
-    __config__: Optional[Type[BaseConfig]] = None,
-    __base__: Union[Type['Model'], Tuple[Type['Model'], ...]],
+    __config__: ConfigDict | None = None,
+    __doc__: str | None = None,
+    __base__: type[Model] | tuple[type[Model], ...],
     __module__: str = __name__,
-    __validators__: Dict[str, 'AnyClassMethod'] = None,
-    __cls_kwargs__: Dict[str, Any] = None,
+    __validators__: dict[str, classmethod] | None = None,
+    __cls_kwargs__: dict[str, Any] | None = None,
     **field_definitions: Any,
-) -> Type['Model']:
+) -> type[Model]:
     ...
 
 
-def create_model(
+def create_model(  # noqa: C901
     __model_name: str,
     *,
-    __config__: Optional[Type[BaseConfig]] = None,
-    __base__: Union[None, Type['Model'], Tuple[Type['Model'], ...]] = None,
-    __module__: str = __name__,
-    __validators__: Dict[str, 'AnyClassMethod'] = None,
-    __cls_kwargs__: Dict[str, Any] = None,
-    __slots__: Optional[Tuple[str, ...]] = None,
+    __config__: ConfigDict | None = None,
+    __doc__: str | None = None,
+    __base__: type[Model] | tuple[type[Model], ...] | None = None,
+    __module__: str | None = None,
+    __validators__: dict[str, classmethod] | None = None,
+    __cls_kwargs__: dict[str, Any] | None = None,
+    __slots__: tuple[str, ...] | None = None,
     **field_definitions: Any,
-) -> Type['Model']:
-    """
-    Dynamically create a model.
-    :param __model_name: name of the created model
-    :param __config__: config class to use for the new model
-    :param __base__: base class for the new model to inherit from
-    :param __module__: module of the created model
-    :param __validators__: a dict of method names and @validator class methods
-    :param __cls_kwargs__: a dict for class creation
-    :param __slots__: Deprecated, `__slots__` should not be passed to `create_model`
-    :param field_definitions: fields of the model (or extra fields if a base is supplied)
-        in the format `<name>=(<type>, <default default>)` or `<name>=<default value>, e.g.
-        `foobar=(str, ...)` or `foobar=123`, or, for complex use-cases, in the format
-        `<name>=<Field>` or `<name>=(<type>, <FieldInfo>)`, e.g.
-        `foo=Field(datetime, default_factory=datetime.utcnow, alias='bar')` or
-        `foo=(str, FieldInfo(title='Foo'))`
+) -> type[Model]:
+    """Usage docs: https://docs.pydantic.dev/2.6/concepts/models/#dynamic-model-creation
+
+    Dynamically creates and returns a new Pydantic model, in other words, `create_model` dynamically creates a
+    subclass of [`BaseModel`][pydantic.BaseModel].
+
+    Args:
+        __model_name: The name of the newly created model.
+        __config__: The configuration of the new model.
+        __doc__: The docstring of the new model.
+        __base__: The base class or classes for the new model.
+        __module__: The name of the module that the model belongs to;
+            if `None`, the value is taken from `sys._getframe(1)`
+        __validators__: A dictionary of methods that validate fields.
+        __cls_kwargs__: A dictionary of keyword arguments for class creation, such as `metaclass`.
+        __slots__: Deprecated. Should not be passed to `create_model`.
+        **field_definitions: Attributes of the new model. They should be passed in the format:
+            `<name>=(<type>, <default value>)` or `<name>=(<type>, <FieldInfo>)`.
+
+    Returns:
+        The new [model][pydantic.BaseModel].
+
+    Raises:
+        PydanticUserError: If `__base__` and `__config__` are both passed.
     """
     if __slots__ is not None:
         # __slots__ will be ignored from here on
@@ -982,11 +1436,14 @@ def create_model(
 
     if __base__ is not None:
         if __config__ is not None:
-            raise ConfigError('to avoid confusion __config__ and __base__ cannot be used together')
+            raise PydanticUserError(
+                'to avoid confusion `__config__` and `__base__` cannot be used together',
+                code='create-model-config-base',
+            )
         if not isinstance(__base__, tuple):
             __base__ = (__base__,)
     else:
-        __base__ = (cast(Type['Model'], BaseModel),)
+        __base__ = (typing.cast(typing.Type['Model'], BaseModel),)
 
     __cls_kwargs__ = __cls_kwargs__ or {}
 
@@ -994,16 +1451,16 @@ def create_model(
     annotations = {}
 
     for f_name, f_def in field_definitions.items():
-        if not is_valid_field(f_name):
+        if not _fields.is_valid_field_name(f_name):
             warnings.warn(f'fields may not start with an underscore, ignoring "{f_name}"', RuntimeWarning)
         if isinstance(f_def, tuple):
+            f_def = typing.cast('tuple[str, Any]', f_def)
             try:
                 f_annotation, f_value = f_def
             except ValueError as e:
-                raise ConfigError(
-                    'field definitions should either be a tuple of (<type>, <default>) or just a '
-                    'default value, unfortunately this means tuples as '
-                    'default values are not allowed'
+                raise PydanticUserError(
+                    'Field definitions should be a `(<type>, <default>)`.',
+                    code='create-model-field-definitions',
                 ) from e
         else:
             f_annotation, f_value = None, f_def
@@ -1012,98 +1469,32 @@ def create_model(
             annotations[f_name] = f_annotation
         fields[f_name] = f_value
 
-    namespace: 'DictStrAny' = {'__annotations__': annotations, '__module__': __module__}
+    if __module__ is None:
+        f = sys._getframe(1)
+        __module__ = f.f_globals['__name__']
+
+    namespace: dict[str, Any] = {'__annotations__': annotations, '__module__': __module__}
+    if __doc__:
+        namespace.update({'__doc__': __doc__})
     if __validators__:
         namespace.update(__validators__)
     namespace.update(fields)
     if __config__:
-        namespace['Config'] = inherit_config(__config__, BaseConfig)
-    resolved_bases = resolve_bases(__base__)
-    meta, ns, kwds = prepare_class(__model_name, resolved_bases, kwds=__cls_kwargs__)
+        namespace['model_config'] = _config.ConfigWrapper(__config__).config_dict
+    resolved_bases = types.resolve_bases(__base__)
+    meta, ns, kwds = types.prepare_class(__model_name, resolved_bases, kwds=__cls_kwargs__)
     if resolved_bases is not __base__:
         ns['__orig_bases__'] = __base__
     namespace.update(ns)
-    return meta(__model_name, resolved_bases, namespace, **kwds)
+
+    return meta(
+        __model_name,
+        resolved_bases,
+        namespace,
+        __pydantic_reset_parent_namespace__=False,
+        _create_model_module=__module__,
+        **kwds,
+    )
 
 
-_missing = object()
-
-
-def validate_model(  # noqa: C901 (ignore complexity)
-    model: Type[BaseModel], input_data: 'DictStrAny', cls: 'ModelOrDc' = None
-) -> Tuple['DictStrAny', 'SetStr', Optional[ValidationError]]:
-    """
-    validate data against a model.
-    """
-    values = {}
-    errors = []
-    # input_data names, possibly alias
-    names_used = set()
-    # field names, never aliases
-    fields_set = set()
-    config = model.__config__
-    check_extra = config.extra is not Extra.ignore
-    cls_ = cls or model
-
-    for validator in model.__pre_root_validators__:
-        try:
-            input_data = validator(cls_, input_data)
-        except (ValueError, TypeError, AssertionError) as exc:
-            return {}, set(), ValidationError([ErrorWrapper(exc, loc=ROOT_KEY)], cls_)
-
-    for name, field in model.__fields__.items():
-        value = input_data.get(field.alias, _missing)
-        using_name = False
-        if value is _missing and config.allow_population_by_field_name and field.alt_alias:
-            value = input_data.get(field.name, _missing)
-            using_name = True
-
-        if value is _missing:
-            if field.required:
-                errors.append(ErrorWrapper(MissingError(), loc=field.alias))
-                continue
-
-            value = field.get_default()
-
-            if not config.validate_all and not field.validate_always:
-                values[name] = value
-                continue
-        else:
-            fields_set.add(name)
-            if check_extra:
-                names_used.add(field.name if using_name else field.alias)
-
-        v_, errors_ = field.validate(value, values, loc=field.alias, cls=cls_)
-        if isinstance(errors_, ErrorWrapper):
-            errors.append(errors_)
-        elif isinstance(errors_, list):
-            errors.extend(errors_)
-        else:
-            values[name] = v_
-
-    if check_extra:
-        if isinstance(input_data, GetterDict):
-            extra = input_data.extra_keys() - names_used
-        else:
-            extra = input_data.keys() - names_used
-        if extra:
-            fields_set |= extra
-            if config.extra is Extra.allow:
-                for f in extra:
-                    values[f] = input_data[f]
-            else:
-                for f in sorted(extra):
-                    errors.append(ErrorWrapper(ExtraError(), loc=f))
-
-    for skip_on_failure, validator in model.__post_root_validators__:
-        if skip_on_failure and errors:
-            continue
-        try:
-            values = validator(cls_, values)
-        except (ValueError, TypeError, AssertionError) as exc:
-            errors.append(ErrorWrapper(exc, loc=ROOT_KEY))
-
-    if errors:
-        return values, fields_set, ValidationError(errors, cls_)
-    else:
-        return values, fields_set, None
+__getattr__ = getattr_migration(__name__)
diff --git a/lib/pydantic/mypy.py b/lib/pydantic/mypy.py
index 6bd9db18..0e70eab5 100644
--- a/lib/pydantic/mypy.py
+++ b/lib/pydantic/mypy.py
@@ -1,8 +1,13 @@
+"""This module includes classes and functions designed specifically for use with the mypy plugin."""
+
+from __future__ import annotations
+
 import sys
 from configparser import ConfigParser
-from typing import Any, Callable, Dict, List, Optional, Set, Tuple, Type as TypingType, Union
+from typing import Any, Callable, Iterator
 
 from mypy.errorcodes import ErrorCode
+from mypy.expandtype import expand_type, expand_type_by_instance
 from mypy.nodes import (
     ARG_NAMED,
     ARG_NAMED_OPT,
@@ -17,21 +22,23 @@ from mypy.nodes import (
     ClassDef,
     Context,
     Decorator,
+    DictExpr,
     EllipsisExpr,
-    FuncBase,
+    Expression,
     FuncDef,
+    IfStmt,
     JsonDict,
     MemberExpr,
     NameExpr,
     PassStmt,
     PlaceholderNode,
     RefExpr,
+    Statement,
     StrExpr,
-    SymbolNode,
     SymbolTableNode,
     TempNode,
+    TypeAlias,
     TypeInfo,
-    TypeVarExpr,
     Var,
 )
 from mypy.options import Options
@@ -41,11 +48,17 @@ from mypy.plugin import (
     FunctionContext,
     MethodContext,
     Plugin,
+    ReportConfigContext,
     SemanticAnalyzerPluginInterface,
 )
 from mypy.plugins import dataclasses
-from mypy.semanal import set_callable_name  # type: ignore
+from mypy.plugins.common import (
+    deserialize_and_fixup_type,
+)
+from mypy.semanal import set_callable_name
 from mypy.server.trigger import make_wildcard_trigger
+from mypy.state import state
+from mypy.typeops import map_type_from_supertype
 from mypy.types import (
     AnyType,
     CallableType,
@@ -63,76 +76,131 @@ from mypy.typevars import fill_typevars
 from mypy.util import get_unique_redefinition_name
 from mypy.version import __version__ as mypy_version
 
-from pydantic.utils import is_valid_field
+from pydantic._internal import _fields
+from pydantic.version import parse_mypy_version
 
 try:
     from mypy.types import TypeVarDef  # type: ignore[attr-defined]
 except ImportError:  # pragma: no cover
-    # Backward-compatible with TypeVarDef from Mypy 0.910.
+    # Backward-compatible with TypeVarDef from Mypy 0.930.
     from mypy.types import TypeVarType as TypeVarDef
 
 CONFIGFILE_KEY = 'pydantic-mypy'
 METADATA_KEY = 'pydantic-mypy-metadata'
 BASEMODEL_FULLNAME = 'pydantic.main.BaseModel'
-BASESETTINGS_FULLNAME = 'pydantic.env_settings.BaseSettings'
+BASESETTINGS_FULLNAME = 'pydantic_settings.main.BaseSettings'
+ROOT_MODEL_FULLNAME = 'pydantic.root_model.RootModel'
+MODEL_METACLASS_FULLNAME = 'pydantic._internal._model_construction.ModelMetaclass'
 FIELD_FULLNAME = 'pydantic.fields.Field'
 DATACLASS_FULLNAME = 'pydantic.dataclasses.dataclass'
-
-
-def parse_mypy_version(version: str) -> Tuple[int, ...]:
-    return tuple(int(part) for part in version.split('+', 1)[0].split('.'))
+MODEL_VALIDATOR_FULLNAME = 'pydantic.functional_validators.model_validator'
+DECORATOR_FULLNAMES = {
+    'pydantic.functional_validators.field_validator',
+    'pydantic.functional_validators.model_validator',
+    'pydantic.functional_serializers.serializer',
+    'pydantic.functional_serializers.model_serializer',
+    'pydantic.deprecated.class_validators.validator',
+    'pydantic.deprecated.class_validators.root_validator',
+}
 
 
 MYPY_VERSION_TUPLE = parse_mypy_version(mypy_version)
 BUILTINS_NAME = 'builtins' if MYPY_VERSION_TUPLE >= (0, 930) else '__builtins__'
 
+# Increment version if plugin changes and mypy caches should be invalidated
+__version__ = 2
 
-def plugin(version: str) -> 'TypingType[Plugin]':
-    """
-    `version` is the mypy version string
+
+def plugin(version: str) -> type[Plugin]:
+    """`version` is the mypy version string.
 
     We might want to use this to print a warning if the mypy version being used is
     newer, or especially older, than we expect (or need).
+
+    Args:
+        version: The mypy version string.
+
+    Return:
+        The Pydantic mypy plugin type.
     """
     return PydanticPlugin
 
 
+class _DeferAnalysis(Exception):
+    pass
+
+
 class PydanticPlugin(Plugin):
+    """The Pydantic mypy plugin."""
+
     def __init__(self, options: Options) -> None:
         self.plugin_config = PydanticPluginConfig(options)
+        self._plugin_data = self.plugin_config.to_data()
         super().__init__(options)
 
-    def get_base_class_hook(self, fullname: str) -> 'Optional[Callable[[ClassDefContext], None]]':
+    def get_base_class_hook(self, fullname: str) -> Callable[[ClassDefContext], bool] | None:
+        """Update Pydantic model class."""
         sym = self.lookup_fully_qualified(fullname)
         if sym and isinstance(sym.node, TypeInfo):  # pragma: no branch
             # No branching may occur if the mypy cache has not been cleared
-            if any(get_fullname(base) == BASEMODEL_FULLNAME for base in sym.node.mro):
+            if any(base.fullname == BASEMODEL_FULLNAME for base in sym.node.mro):
                 return self._pydantic_model_class_maker_callback
         return None
 
-    def get_function_hook(self, fullname: str) -> 'Optional[Callable[[FunctionContext], Type]]':
+    def get_metaclass_hook(self, fullname: str) -> Callable[[ClassDefContext], None] | None:
+        """Update Pydantic `ModelMetaclass` definition."""
+        if fullname == MODEL_METACLASS_FULLNAME:
+            return self._pydantic_model_metaclass_marker_callback
+        return None
+
+    def get_function_hook(self, fullname: str) -> Callable[[FunctionContext], Type] | None:
+        """Adjust the return type of the `Field` function."""
         sym = self.lookup_fully_qualified(fullname)
         if sym and sym.fullname == FIELD_FULLNAME:
             return self._pydantic_field_callback
         return None
 
-    def get_method_hook(self, fullname: str) -> Optional[Callable[[MethodContext], Type]]:
+    def get_method_hook(self, fullname: str) -> Callable[[MethodContext], Type] | None:
+        """Adjust return type of `from_orm` method call."""
         if fullname.endswith('.from_orm'):
-            return from_orm_callback
+            return from_attributes_callback
         return None
 
-    def get_class_decorator_hook(self, fullname: str) -> Optional[Callable[[ClassDefContext], None]]:
-        if fullname == DATACLASS_FULLNAME:
+    def get_class_decorator_hook(self, fullname: str) -> Callable[[ClassDefContext], None] | None:
+        """Mark pydantic.dataclasses as dataclass.
+
+        Mypy version 1.1.1 added support for `@dataclass_transform` decorator.
+        """
+        if fullname == DATACLASS_FULLNAME and MYPY_VERSION_TUPLE < (1, 1):
             return dataclasses.dataclass_class_maker_callback  # type: ignore[return-value]
         return None
 
-    def _pydantic_model_class_maker_callback(self, ctx: ClassDefContext) -> None:
-        transformer = PydanticModelTransformer(ctx, self.plugin_config)
-        transformer.transform()
+    def report_config_data(self, ctx: ReportConfigContext) -> dict[str, Any]:
+        """Return all plugin config data.
 
-    def _pydantic_field_callback(self, ctx: FunctionContext) -> 'Type':
+        Used by mypy to determine if cache needs to be discarded.
         """
-        Extract the type of the `default` argument from the Field function, and use it as the return type.
+        return self._plugin_data
+
+    def _pydantic_model_class_maker_callback(self, ctx: ClassDefContext) -> bool:
+        transformer = PydanticModelTransformer(ctx.cls, ctx.reason, ctx.api, self.plugin_config)
+        return transformer.transform()
+
+    def _pydantic_model_metaclass_marker_callback(self, ctx: ClassDefContext) -> None:
+        """Reset dataclass_transform_spec attribute of ModelMetaclass.
+
+        Let the plugin handle it. This behavior can be disabled
+        if 'debug_dataclass_transform' is set to True', for testing purposes.
+        """
+        if self.plugin_config.debug_dataclass_transform:
+            return
+        info_metaclass = ctx.cls.info.declared_metaclass
+        assert info_metaclass, "callback not passed from 'get_metaclass_hook'"
+        if getattr(info_metaclass.type, 'dataclass_transform_spec', None):
+            info_metaclass.type.dataclass_transform_spec = None
+
+    def _pydantic_field_callback(self, ctx: FunctionContext) -> Type:
+        """Extract the type of the `default` argument from the Field function, and use it as the return type.
 
         In particular:
         * Check whether the default and default_factory argument is specified.
@@ -164,11 +232,7 @@ class PydanticPlugin(Plugin):
             # Functions which use `ParamSpec` can be overloaded, exposing the callable's types as a parameter
             # Pydantic calls the default factory without any argument, so we retrieve the first item
             if isinstance(default_factory_type, Overloaded):
-                if MYPY_VERSION_TUPLE > (0, 910):
-                    default_factory_type = default_factory_type.items[0]
-                else:
-                    # Mypy0.910 exposes the items of overloaded types in a function
-                    default_factory_type = default_factory_type.items()[0]  # type: ignore[operator]
+                default_factory_type = default_factory_type.items[0]
 
             if isinstance(default_factory_type, CallableType):
                 ret_type = default_factory_type.ret_type
@@ -185,11 +249,26 @@ class PydanticPlugin(Plugin):
 
 
 class PydanticPluginConfig:
-    __slots__ = ('init_forbid_extra', 'init_typed', 'warn_required_dynamic_aliases', 'warn_untyped_fields')
+    """A Pydantic mypy plugin config holder.
+
+    Attributes:
+        init_forbid_extra: Whether to add a `**kwargs` at the end of the generated `__init__` signature.
+        init_typed: Whether to annotate fields in the generated `__init__`.
+        warn_required_dynamic_aliases: Whether to raise required dynamic aliases error.
+        debug_dataclass_transform: Whether to not reset `dataclass_transform_spec` attribute
+            of `ModelMetaclass` for testing purposes.
+    """
+
+    __slots__ = (
+        'init_forbid_extra',
+        'init_typed',
+        'warn_required_dynamic_aliases',
+        'debug_dataclass_transform',
+    )
     init_forbid_extra: bool
     init_typed: bool
     warn_required_dynamic_aliases: bool
-    warn_untyped_fields: bool
+    debug_dataclass_transform: bool  # undocumented
 
     def __init__(self, options: Options) -> None:
         if options.config_file is None:  # pragma: no cover
@@ -210,343 +289,724 @@ class PydanticPluginConfig:
                 setting = plugin_config.getboolean(CONFIGFILE_KEY, key, fallback=False)
                 setattr(self, key, setting)
 
+    def to_data(self) -> dict[str, Any]:
+        """Returns a dict of config names to their values."""
+        return {key: getattr(self, key) for key in self.__slots__}
 
-def from_orm_callback(ctx: MethodContext) -> Type:
-    """
-    Raise an error if orm_mode is not enabled
-    """
+
+def from_attributes_callback(ctx: MethodContext) -> Type:
+    """Raise an error if from_attributes is not enabled."""
     model_type: Instance
-    if isinstance(ctx.type, CallableType) and isinstance(ctx.type.ret_type, Instance):
-        model_type = ctx.type.ret_type  # called on the class
-    elif isinstance(ctx.type, Instance):
-        model_type = ctx.type  # called on an instance (unusual, but still valid)
+    ctx_type = ctx.type
+    if isinstance(ctx_type, TypeType):
+        ctx_type = ctx_type.item
+    if isinstance(ctx_type, CallableType) and isinstance(ctx_type.ret_type, Instance):
+        model_type = ctx_type.ret_type  # called on the class
+    elif isinstance(ctx_type, Instance):
+        model_type = ctx_type  # called on an instance (unusual, but still valid)
     else:  # pragma: no cover
-        detail = f'ctx.type: {ctx.type} (of type {ctx.type.__class__.__name__})'
+        detail = f'ctx.type: {ctx_type} (of type {ctx_type.__class__.__name__})'
         error_unexpected_behavior(detail, ctx.api, ctx.context)
         return ctx.default_return_type
     pydantic_metadata = model_type.type.metadata.get(METADATA_KEY)
     if pydantic_metadata is None:
         return ctx.default_return_type
-    orm_mode = pydantic_metadata.get('config', {}).get('orm_mode')
-    if orm_mode is not True:
-        error_from_orm(get_name(model_type.type), ctx.api, ctx.context)
+    from_attributes = pydantic_metadata.get('config', {}).get('from_attributes')
+    if from_attributes is not True:
+        error_from_attributes(model_type.type.name, ctx.api, ctx.context)
     return ctx.default_return_type
 
 
+class PydanticModelField:
+    """Based on mypy.plugins.dataclasses.DataclassAttribute."""
+
+    def __init__(
+        self,
+        name: str,
+        alias: str | None,
+        has_dynamic_alias: bool,
+        has_default: bool,
+        line: int,
+        column: int,
+        type: Type | None,
+        info: TypeInfo,
+    ):
+        self.name = name
+        self.alias = alias
+        self.has_dynamic_alias = has_dynamic_alias
+        self.has_default = has_default
+        self.line = line
+        self.column = column
+        self.type = type
+        self.info = info
+
+    def to_argument(
+        self,
+        current_info: TypeInfo,
+        typed: bool,
+        force_optional: bool,
+        use_alias: bool,
+        api: SemanticAnalyzerPluginInterface,
+    ) -> Argument:
+        """Based on mypy.plugins.dataclasses.DataclassAttribute.to_argument."""
+        variable = self.to_var(current_info, api, use_alias)
+        type_annotation = self.expand_type(current_info, api) if typed else AnyType(TypeOfAny.explicit)
+        return Argument(
+            variable=variable,
+            type_annotation=type_annotation,
+            initializer=None,
+            kind=ARG_NAMED_OPT if force_optional or self.has_default else ARG_NAMED,
+        )
+
+    def expand_type(self, current_info: TypeInfo, api: SemanticAnalyzerPluginInterface) -> Type | None:
+        """Based on mypy.plugins.dataclasses.DataclassAttribute.expand_type."""
+        # The getattr in the next line is used to prevent errors in legacy versions of mypy without this attribute
+        if self.type is not None and getattr(self.info, 'self_type', None) is not None:
+            # In general, it is not safe to call `expand_type()` during semantic analyzis,
+            # however this plugin is called very late, so all types should be fully ready.
+            # Also, it is tricky to avoid eager expansion of Self types here (e.g. because
+            # we serialize attributes).
+            expanded_type = expand_type(self.type, {self.info.self_type.id: fill_typevars(current_info)})
+            if isinstance(self.type, UnionType) and not isinstance(expanded_type, UnionType):
+                if not api.final_iteration:
+                    raise _DeferAnalysis()
+            return expanded_type
+        return self.type
+
+    def to_var(self, current_info: TypeInfo, api: SemanticAnalyzerPluginInterface, use_alias: bool) -> Var:
+        """Based on mypy.plugins.dataclasses.DataclassAttribute.to_var."""
+        if use_alias and self.alias is not None:
+            name = self.alias
+        else:
+            name = self.name
+
+        return Var(name, self.expand_type(current_info, api))
+
+    def serialize(self) -> JsonDict:
+        """Based on mypy.plugins.dataclasses.DataclassAttribute.serialize."""
+        assert self.type
+        return {
+            'name': self.name,
+            'alias': self.alias,
+            'has_dynamic_alias': self.has_dynamic_alias,
+            'has_default': self.has_default,
+            'line': self.line,
+            'column': self.column,
+            'type': self.type.serialize(),
+        }
+
+    @classmethod
+    def deserialize(cls, info: TypeInfo, data: JsonDict, api: SemanticAnalyzerPluginInterface) -> PydanticModelField:
+        """Based on mypy.plugins.dataclasses.DataclassAttribute.deserialize."""
+        data = data.copy()
+        typ = deserialize_and_fixup_type(data.pop('type'), api)
+        return cls(type=typ, info=info, **data)
+
+    def expand_typevar_from_subtype(self, sub_type: TypeInfo) -> None:
+        """Expands type vars in the context of a subtype when an attribute is inherited
+        from a generic super type.
+        """
+        if self.type is not None:
+            self.type = map_type_from_supertype(self.type, sub_type, self.info)
+
+
+class PydanticModelClassVar:
+    """Based on mypy.plugins.dataclasses.DataclassAttribute.
+
+    ClassVars are ignored by subclasses.
+
+    Attributes:
+        name: the ClassVar name
+    """
+
+    def __init__(self, name):
+        self.name = name
+
+    @classmethod
+    def deserialize(cls, data: JsonDict) -> PydanticModelClassVar:
+        """Based on mypy.plugins.dataclasses.DataclassAttribute.deserialize."""
+        data = data.copy()
+        return cls(**data)
+
+    def serialize(self) -> JsonDict:
+        """Based on mypy.plugins.dataclasses.DataclassAttribute.serialize."""
+        return {
+            'name': self.name,
+        }
+
+
 class PydanticModelTransformer:
-    tracked_config_fields: Set[str] = {
+    """Transform the BaseModel subclass according to the plugin settings.
+
+    Attributes:
+        tracked_config_fields: A set of field configs that the plugin has to track their value.
+    """
+
+    tracked_config_fields: set[str] = {
         'extra',
-        'allow_mutation',
         'frozen',
-        'orm_mode',
-        'allow_population_by_field_name',
+        'from_attributes',
+        'populate_by_name',
         'alias_generator',
     }
 
-    def __init__(self, ctx: ClassDefContext, plugin_config: PydanticPluginConfig) -> None:
-        self._ctx = ctx
+    def __init__(
+        self,
+        cls: ClassDef,
+        reason: Expression | Statement,
+        api: SemanticAnalyzerPluginInterface,
+        plugin_config: PydanticPluginConfig,
+    ) -> None:
+        self._cls = cls
+        self._reason = reason
+        self._api = api
+
         self.plugin_config = plugin_config
 
-    def transform(self) -> None:
-        """
-        Configures the BaseModel subclass according to the plugin settings.
+    def transform(self) -> bool:
+        """Configures the BaseModel subclass according to the plugin settings.
 
         In particular:
+
         * determines the model config and fields,
         * adds a fields-aware signature for the initializer and construct methods
-        * freezes the class if allow_mutation = False or frozen = True
+        * freezes the class if frozen = True
         * stores the fields, config, and if the class is settings in the mypy metadata for access by subclasses
         """
-        ctx = self._ctx
-        info = self._ctx.cls.info
-
-        self.adjust_validator_signatures()
+        info = self._cls.info
+        is_root_model = any(ROOT_MODEL_FULLNAME in base.fullname for base in info.mro[:-1])
         config = self.collect_config()
-        fields = self.collect_fields(config)
+        fields, class_vars = self.collect_fields_and_class_vars(config, is_root_model)
+        if fields is None or class_vars is None:
+            # Some definitions are not ready. We need another pass.
+            return False
         for field in fields:
-            if info[field.name].type is None:
-                if not ctx.api.final_iteration:
-                    ctx.api.defer()
-        is_settings = any(get_fullname(base) == BASESETTINGS_FULLNAME for base in info.mro[:-1])
-        self.add_initializer(fields, config, is_settings)
-        self.add_construct_method(fields)
-        self.set_frozen(fields, frozen=config.allow_mutation is False or config.frozen is True)
+            if field.type is None:
+                return False
+
+        is_settings = any(base.fullname == BASESETTINGS_FULLNAME for base in info.mro[:-1])
+        try:
+            self.add_initializer(fields, config, is_settings, is_root_model)
+            self.add_model_construct_method(fields, config, is_settings)
+            self.set_frozen(fields, self._api, frozen=config.frozen is True)
+        except _DeferAnalysis:
+            if not self._api.final_iteration:
+                self._api.defer()
+
+        self.adjust_decorator_signatures()
+
         info.metadata[METADATA_KEY] = {
             'fields': {field.name: field.serialize() for field in fields},
-            'config': config.set_values_dict(),
+            'class_vars': {class_var.name: class_var.serialize() for class_var in class_vars},
+            'config': config.get_values_dict(),
         }
 
-    def adjust_validator_signatures(self) -> None:
-        """When we decorate a function `f` with `pydantic.validator(...), mypy sees
-        `f` as a regular method taking a `self` instance, even though pydantic
-        internally wraps `f` with `classmethod` if necessary.
+        return True
 
-        Teach mypy this by marking any function whose outermost decorator is a
-        `validator()` call as a classmethod.
+    def adjust_decorator_signatures(self) -> None:
+        """When we decorate a function `f` with `pydantic.validator(...)`, `pydantic.field_validator`
+        or `pydantic.serializer(...)`, mypy sees `f` as a regular method taking a `self` instance,
+        even though pydantic internally wraps `f` with `classmethod` if necessary.
+
+        Teach mypy this by marking any function whose outermost decorator is a `validator()`,
+        `field_validator()` or `serializer()` call as a `classmethod`.
         """
-        for name, sym in self._ctx.cls.info.names.items():
+        for name, sym in self._cls.info.names.items():
             if isinstance(sym.node, Decorator):
                 first_dec = sym.node.original_decorators[0]
                 if (
                     isinstance(first_dec, CallExpr)
                     and isinstance(first_dec.callee, NameExpr)
-                    and first_dec.callee.fullname == 'pydantic.class_validators.validator'
+                    and first_dec.callee.fullname in DECORATOR_FULLNAMES
+                    # @model_validator(mode="after") is an exception, it expects a regular method
+                    and not (
+                        first_dec.callee.fullname == MODEL_VALIDATOR_FULLNAME
+                        and any(
+                            first_dec.arg_names[i] == 'mode' and isinstance(arg, StrExpr) and arg.value == 'after'
+                            for i, arg in enumerate(first_dec.args)
+                        )
+                    )
                 ):
+                    # TODO: Only do this if the first argument of the decorated function is `cls`
                     sym.node.func.is_class = True
 
-    def collect_config(self) -> 'ModelConfigData':
-        """
-        Collects the values of the config attributes that are used by the plugin, accounting for parent classes.
-        """
-        ctx = self._ctx
-        cls = ctx.cls
+    def collect_config(self) -> ModelConfigData:  # noqa: C901 (ignore complexity)
+        """Collects the values of the config attributes that are used by the plugin, accounting for parent classes."""
+        cls = self._cls
         config = ModelConfigData()
+
+        has_config_kwargs = False
+        has_config_from_namespace = False
+
+        # Handle `class MyModel(BaseModel, <name>=<expr>, ...):`
+        for name, expr in cls.keywords.items():
+            config_data = self.get_config_update(name, expr)
+            if config_data:
+                has_config_kwargs = True
+                config.update(config_data)
+
+        # Handle `model_config`
+        stmt: Statement | None = None
         for stmt in cls.defs.body:
-            if not isinstance(stmt, ClassDef):
+            if not isinstance(stmt, (AssignmentStmt, ClassDef)):
                 continue
-            if stmt.name == 'Config':
+
+            if isinstance(stmt, AssignmentStmt):
+                lhs = stmt.lvalues[0]
+                if not isinstance(lhs, NameExpr) or lhs.name != 'model_config':
+                    continue
+
+                if isinstance(stmt.rvalue, CallExpr):  # calls to `dict` or `ConfigDict`
+                    for arg_name, arg in zip(stmt.rvalue.arg_names, stmt.rvalue.args):
+                        if arg_name is None:
+                            continue
+                        config.update(self.get_config_update(arg_name, arg))
+                elif isinstance(stmt.rvalue, DictExpr):  # dict literals
+                    for key_expr, value_expr in stmt.rvalue.items:
+                        if not isinstance(key_expr, StrExpr):
+                            continue
+                        config.update(self.get_config_update(key_expr.value, value_expr))
+
+            elif isinstance(stmt, ClassDef):
+                if stmt.name != 'Config':  # 'deprecated' Config-class
+                    continue
                 for substmt in stmt.defs.body:
                     if not isinstance(substmt, AssignmentStmt):
                         continue
-                    config.update(self.get_config_update(substmt))
-                if (
-                    config.has_alias_generator
-                    and not config.allow_population_by_field_name
-                    and self.plugin_config.warn_required_dynamic_aliases
-                ):
-                    error_required_dynamic_aliases(ctx.api, stmt)
+                    lhs = substmt.lvalues[0]
+                    if not isinstance(lhs, NameExpr):
+                        continue
+                    config.update(self.get_config_update(lhs.name, substmt.rvalue))
+
+            if has_config_kwargs:
+                self._api.fail(
+                    'Specifying config in two places is ambiguous, use either Config attribute or class kwargs',
+                    cls,
+                )
+                break
+
+            has_config_from_namespace = True
+
+        if has_config_kwargs or has_config_from_namespace:
+            if (
+                stmt
+                and config.has_alias_generator
+                and not config.populate_by_name
+                and self.plugin_config.warn_required_dynamic_aliases
+            ):
+                error_required_dynamic_aliases(self._api, stmt)
+
         for info in cls.info.mro[1:]:  # 0 is the current class
             if METADATA_KEY not in info.metadata:
                 continue
 
             # Each class depends on the set of fields in its ancestors
-            ctx.api.add_plugin_dependency(make_wildcard_trigger(get_fullname(info)))
+            self._api.add_plugin_dependency(make_wildcard_trigger(info.fullname))
             for name, value in info.metadata[METADATA_KEY]['config'].items():
                 config.setdefault(name, value)
         return config
 
-    def collect_fields(self, model_config: 'ModelConfigData') -> List['PydanticModelField']:
-        """
-        Collects the fields for the model, accounting for parent classes
-        """
-        # First, collect fields belonging to the current class.
-        ctx = self._ctx
-        cls = self._ctx.cls
-        fields = []  # type: List[PydanticModelField]
-        known_fields = set()  # type: Set[str]
-        for stmt in cls.defs.body:
-            if not isinstance(stmt, AssignmentStmt):  # `and stmt.new_syntax` to require annotation
-                continue
+    def collect_fields_and_class_vars(
+        self, model_config: ModelConfigData, is_root_model: bool
+    ) -> tuple[list[PydanticModelField] | None, list[PydanticModelClassVar] | None]:
+        """Collects the fields for the model, accounting for parent classes."""
+        cls = self._cls
 
-            lhs = stmt.lvalues[0]
-            if not isinstance(lhs, NameExpr) or not is_valid_field(lhs.name):
-                continue
-
-            if not stmt.new_syntax and self.plugin_config.warn_untyped_fields:
-                error_untyped_fields(ctx.api, stmt)
-
-            # if lhs.name == '__config__':  # BaseConfig not well handled; I'm not sure why yet
-            #     continue
-
-            sym = cls.info.names.get(lhs.name)
-            if sym is None:  # pragma: no cover
-                # This is likely due to a star import (see the dataclasses plugin for a more detailed explanation)
-                # This is the same logic used in the dataclasses plugin
-                continue
-
-            node = sym.node
-            if isinstance(node, PlaceholderNode):  # pragma: no cover
-                # See the PlaceholderNode docstring for more detail about how this can occur
-                # Basically, it is an edge case when dealing with complex import logic
-                # This is the same logic used in the dataclasses plugin
-                continue
-            if not isinstance(node, Var):  # pragma: no cover
-                # Don't know if this edge case still happens with the `is_valid_field` check above
-                # but better safe than sorry
-                continue
-
-            # x: ClassVar[int] is ignored by dataclasses.
-            if node.is_classvar:
-                continue
-
-            is_required = self.get_is_required(cls, stmt, lhs)
-            alias, has_dynamic_alias = self.get_alias_info(stmt)
-            if (
-                has_dynamic_alias
-                and not model_config.allow_population_by_field_name
-                and self.plugin_config.warn_required_dynamic_aliases
-            ):
-                error_required_dynamic_aliases(ctx.api, stmt)
-            fields.append(
-                PydanticModelField(
-                    name=lhs.name,
-                    is_required=is_required,
-                    alias=alias,
-                    has_dynamic_alias=has_dynamic_alias,
-                    line=stmt.line,
-                    column=stmt.column,
-                )
-            )
-            known_fields.add(lhs.name)
-        all_fields = fields.copy()
-        for info in cls.info.mro[1:]:  # 0 is the current class, -2 is BaseModel, -1 is object
+        # First, collect fields and ClassVars belonging to any class in the MRO, ignoring duplicates.
+        #
+        # We iterate through the MRO in reverse because attrs defined in the parent must appear
+        # earlier in the attributes list than attrs defined in the child. See:
+        # https://docs.python.org/3/library/dataclasses.html#inheritance
+        #
+        # However, we also want fields defined in the subtype to override ones defined
+        # in the parent. We can implement this via a dict without disrupting the attr order
+        # because dicts preserve insertion order in Python 3.7+.
+        found_fields: dict[str, PydanticModelField] = {}
+        found_class_vars: dict[str, PydanticModelClassVar] = {}
+        for info in reversed(cls.info.mro[1:-1]):  # 0 is the current class, -2 is BaseModel, -1 is object
+            # if BASEMODEL_METADATA_TAG_KEY in info.metadata and BASEMODEL_METADATA_KEY not in info.metadata:
+            #     # We haven't processed the base class yet. Need another pass.
+            #     return None, None
             if METADATA_KEY not in info.metadata:
                 continue
 
-            superclass_fields = []
-            # Each class depends on the set of fields in its ancestors
-            ctx.api.add_plugin_dependency(make_wildcard_trigger(get_fullname(info)))
+            # Each class depends on the set of attributes in its dataclass ancestors.
+            self._api.add_plugin_dependency(make_wildcard_trigger(info.fullname))
 
             for name, data in info.metadata[METADATA_KEY]['fields'].items():
-                if name not in known_fields:
-                    field = PydanticModelField.deserialize(info, data)
-                    known_fields.add(name)
-                    superclass_fields.append(field)
-                else:
-                    (field,) = (a for a in all_fields if a.name == name)
-                    all_fields.remove(field)
-                    superclass_fields.append(field)
-            all_fields = superclass_fields + all_fields
-        return all_fields
+                field = PydanticModelField.deserialize(info, data, self._api)
+                # (The following comment comes directly from the dataclasses plugin)
+                # TODO: We shouldn't be performing type operations during the main
+                #       semantic analysis pass, since some TypeInfo attributes might
+                #       still be in flux. This should be performed in a later phase.
+                with state.strict_optional_set(self._api.options.strict_optional):
+                    field.expand_typevar_from_subtype(cls.info)
+                found_fields[name] = field
 
-    def add_initializer(self, fields: List['PydanticModelField'], config: 'ModelConfigData', is_settings: bool) -> None:
+                sym_node = cls.info.names.get(name)
+                if sym_node and sym_node.node and not isinstance(sym_node.node, Var):
+                    self._api.fail(
+                        'BaseModel field may only be overridden by another field',
+                        sym_node.node,
+                    )
+            # Collect ClassVars
+            for name, data in info.metadata[METADATA_KEY]['class_vars'].items():
+                found_class_vars[name] = PydanticModelClassVar.deserialize(data)
+
+        # Second, collect fields and ClassVars belonging to the current class.
+        current_field_names: set[str] = set()
+        current_class_vars_names: set[str] = set()
+        for stmt in self._get_assignment_statements_from_block(cls.defs):
+            maybe_field = self.collect_field_or_class_var_from_stmt(stmt, model_config, found_class_vars)
+            if isinstance(maybe_field, PydanticModelField):
+                lhs = stmt.lvalues[0]
+                if is_root_model and lhs.name != 'root':
+                    error_extra_fields_on_root_model(self._api, stmt)
+                else:
+                    current_field_names.add(lhs.name)
+                    found_fields[lhs.name] = maybe_field
+            elif isinstance(maybe_field, PydanticModelClassVar):
+                lhs = stmt.lvalues[0]
+                current_class_vars_names.add(lhs.name)
+                found_class_vars[lhs.name] = maybe_field
+
+        return list(found_fields.values()), list(found_class_vars.values())
+
+    def _get_assignment_statements_from_if_statement(self, stmt: IfStmt) -> Iterator[AssignmentStmt]:
+        for body in stmt.body:
+            if not body.is_unreachable:
+                yield from self._get_assignment_statements_from_block(body)
+        if stmt.else_body is not None and not stmt.else_body.is_unreachable:
+            yield from self._get_assignment_statements_from_block(stmt.else_body)
+
+    def _get_assignment_statements_from_block(self, block: Block) -> Iterator[AssignmentStmt]:
+        for stmt in block.body:
+            if isinstance(stmt, AssignmentStmt):
+                yield stmt
+            elif isinstance(stmt, IfStmt):
+                yield from self._get_assignment_statements_from_if_statement(stmt)
+
+    def collect_field_or_class_var_from_stmt(  # noqa C901
+        self, stmt: AssignmentStmt, model_config: ModelConfigData, class_vars: dict[str, PydanticModelClassVar]
+    ) -> PydanticModelField | PydanticModelClassVar | None:
+        """Get pydantic model field from statement.
+
+        Args:
+            stmt: The statement.
+            model_config: Configuration settings for the model.
+            class_vars: ClassVars already known to be defined on the model.
+
+        Returns:
+            A pydantic model field if it could find the field in statement. Otherwise, `None`.
         """
-        Adds a fields-aware `__init__` method to the class.
+        cls = self._cls
+
+        lhs = stmt.lvalues[0]
+        if not isinstance(lhs, NameExpr) or not _fields.is_valid_field_name(lhs.name) or lhs.name == 'model_config':
+            return None
+
+        if not stmt.new_syntax:
+            if (
+                isinstance(stmt.rvalue, CallExpr)
+                and isinstance(stmt.rvalue.callee, CallExpr)
+                and isinstance(stmt.rvalue.callee.callee, NameExpr)
+                and stmt.rvalue.callee.callee.fullname in DECORATOR_FULLNAMES
+            ):
+                # This is a (possibly-reused) validator or serializer, not a field
+                # In particular, it looks something like: my_validator = validator('my_field')(f)
+                # Eventually, we may want to attempt to respect model_config['ignored_types']
+                return None
+
+            if lhs.name in class_vars:
+                # Class vars are not fields and are not required to be annotated
+                return None
+
+            # The assignment does not have an annotation, and it's not anything else we recognize
+            error_untyped_fields(self._api, stmt)
+            return None
+
+        lhs = stmt.lvalues[0]
+        if not isinstance(lhs, NameExpr):
+            return None
+
+        if not _fields.is_valid_field_name(lhs.name) or lhs.name == 'model_config':
+            return None
+
+        sym = cls.info.names.get(lhs.name)
+        if sym is None:  # pragma: no cover
+            # This is likely due to a star import (see the dataclasses plugin for a more detailed explanation)
+            # This is the same logic used in the dataclasses plugin
+            return None
+
+        node = sym.node
+        if isinstance(node, PlaceholderNode):  # pragma: no cover
+            # See the PlaceholderNode docstring for more detail about how this can occur
+            # Basically, it is an edge case when dealing with complex import logic
+
+            # The dataclasses plugin now asserts this cannot happen, but I'd rather not error if it does..
+            return None
+
+        if isinstance(node, TypeAlias):
+            self._api.fail(
+                'Type aliases inside BaseModel definitions are not supported at runtime',
+                node,
+            )
+            # Skip processing this node. This doesn't match the runtime behaviour,
+            # but the only alternative would be to modify the SymbolTable,
+            # and it's a little hairy to do that in a plugin.
+            return None
+
+        if not isinstance(node, Var):  # pragma: no cover
+            # Don't know if this edge case still happens with the `is_valid_field` check above
+            # but better safe than sorry
+
+            # The dataclasses plugin now asserts this cannot happen, but I'd rather not error if it does..
+            return None
+
+        # x: ClassVar[int] is not a field
+        if node.is_classvar:
+            return PydanticModelClassVar(lhs.name)
+
+        # x: InitVar[int] is not supported in BaseModel
+        node_type = get_proper_type(node.type)
+        if isinstance(node_type, Instance) and node_type.type.fullname == 'dataclasses.InitVar':
+            self._api.fail(
+                'InitVar is not supported in BaseModel',
+                node,
+            )
+
+        has_default = self.get_has_default(stmt)
+
+        if sym.type is None and node.is_final and node.is_inferred:
+            # This follows the logic from the dataclasses plugin. The following comment is taken verbatim:
+            #
+            # This is a special case, assignment like x: Final = 42 is classified
+            # annotated above, but mypy strips the `Final` turning it into x = 42.
+            # We do not support inferred types in dataclasses, so we can try inferring
+            # type for simple literals, and otherwise require an explicit type
+            # argument for Final[...].
+            typ = self._api.analyze_simple_literal_type(stmt.rvalue, is_final=True)
+            if typ:
+                node.type = typ
+            else:
+                self._api.fail(
+                    'Need type argument for Final[...] with non-literal default in BaseModel',
+                    stmt,
+                )
+                node.type = AnyType(TypeOfAny.from_error)
+
+        alias, has_dynamic_alias = self.get_alias_info(stmt)
+        if has_dynamic_alias and not model_config.populate_by_name and self.plugin_config.warn_required_dynamic_aliases:
+            error_required_dynamic_aliases(self._api, stmt)
+
+        init_type = self._infer_dataclass_attr_init_type(sym, lhs.name, stmt)
+        return PydanticModelField(
+            name=lhs.name,
+            has_dynamic_alias=has_dynamic_alias,
+            has_default=has_default,
+            alias=alias,
+            line=stmt.line,
+            column=stmt.column,
+            type=init_type,
+            info=cls.info,
+        )
+
+    def _infer_dataclass_attr_init_type(self, sym: SymbolTableNode, name: str, context: Context) -> Type | None:
+        """Infer __init__ argument type for an attribute.
+
+        In particular, possibly use the signature of __set__.
+        """
+        default = sym.type
+        if sym.implicit:
+            return default
+        t = get_proper_type(sym.type)
+
+        # Perform a simple-minded inference from the signature of __set__, if present.
+        # We can't use mypy.checkmember here, since this plugin runs before type checking.
+        # We only support some basic scanerios here, which is hopefully sufficient for
+        # the vast majority of use cases.
+        if not isinstance(t, Instance):
+            return default
+        setter = t.type.get('__set__')
+        if setter:
+            if isinstance(setter.node, FuncDef):
+                super_info = t.type.get_containing_type_info('__set__')
+                assert super_info
+                if setter.type:
+                    setter_type = get_proper_type(map_type_from_supertype(setter.type, t.type, super_info))
+                else:
+                    return AnyType(TypeOfAny.unannotated)
+                if isinstance(setter_type, CallableType) and setter_type.arg_kinds == [
+                    ARG_POS,
+                    ARG_POS,
+                    ARG_POS,
+                ]:
+                    return expand_type_by_instance(setter_type.arg_types[2], t)
+                else:
+                    self._api.fail(f'Unsupported signature for "__set__" in "{t.type.name}"', context)
+            else:
+                self._api.fail(f'Unsupported "__set__" in "{t.type.name}"', context)
+
+        return default
+
+    def add_initializer(
+        self, fields: list[PydanticModelField], config: ModelConfigData, is_settings: bool, is_root_model: bool
+    ) -> None:
+        """Adds a fields-aware `__init__` method to the class.
 
         The added `__init__` will be annotated with types vs. all `Any` depending on the plugin settings.
         """
-        ctx = self._ctx
+        if '__init__' in self._cls.info.names and not self._cls.info.names['__init__'].plugin_generated:
+            return  # Don't generate an __init__ if one already exists
+
         typed = self.plugin_config.init_typed
-        use_alias = config.allow_population_by_field_name is not True
-        force_all_optional = is_settings or bool(
-            config.has_alias_generator and not config.allow_population_by_field_name
-        )
-        init_arguments = self.get_field_arguments(
-            fields, typed=typed, force_all_optional=force_all_optional, use_alias=use_alias
-        )
+        use_alias = config.populate_by_name is not True
+        requires_dynamic_aliases = bool(config.has_alias_generator and not config.populate_by_name)
+        with state.strict_optional_set(self._api.options.strict_optional):
+            args = self.get_field_arguments(
+                fields,
+                typed=typed,
+                requires_dynamic_aliases=requires_dynamic_aliases,
+                use_alias=use_alias,
+                is_settings=is_settings,
+            )
+
+            if is_root_model and MYPY_VERSION_TUPLE <= (1, 0, 1):
+                # convert root argument to positional argument
+                # This is needed because mypy support for `dataclass_transform` isn't complete on 1.0.1
+                args[0].kind = ARG_POS if args[0].kind == ARG_NAMED else ARG_OPT
+
+            if is_settings:
+                base_settings_node = self._api.lookup_fully_qualified(BASESETTINGS_FULLNAME).node
+                if '__init__' in base_settings_node.names:
+                    base_settings_init_node = base_settings_node.names['__init__'].node
+                    if base_settings_init_node is not None and base_settings_init_node.type is not None:
+                        func_type = base_settings_init_node.type
+                        for arg_idx, arg_name in enumerate(func_type.arg_names):
+                            if arg_name.startswith('__') or not arg_name.startswith('_'):
+                                continue
+                            analyzed_variable_type = self._api.anal_type(func_type.arg_types[arg_idx])
+                            variable = Var(arg_name, analyzed_variable_type)
+                            args.append(Argument(variable, analyzed_variable_type, None, ARG_OPT))
+
         if not self.should_init_forbid_extra(fields, config):
             var = Var('kwargs')
-            init_arguments.append(Argument(var, AnyType(TypeOfAny.explicit), None, ARG_STAR2))
+            args.append(Argument(var, AnyType(TypeOfAny.explicit), None, ARG_STAR2))
 
-        if '__init__' not in ctx.cls.info.names:
-            add_method(ctx, '__init__', init_arguments, NoneType())
+        add_method(self._api, self._cls, '__init__', args=args, return_type=NoneType())
 
-    def add_construct_method(self, fields: List['PydanticModelField']) -> None:
-        """
-        Adds a fully typed `construct` classmethod to the class.
+    def add_model_construct_method(
+        self, fields: list[PydanticModelField], config: ModelConfigData, is_settings: bool
+    ) -> None:
+        """Adds a fully typed `model_construct` classmethod to the class.
 
         Similar to the fields-aware __init__ method, but always uses the field names (not aliases),
         and does not treat settings fields as optional.
         """
-        ctx = self._ctx
-        set_str = ctx.api.named_type(f'{BUILTINS_NAME}.set', [ctx.api.named_type(f'{BUILTINS_NAME}.str')])
+        set_str = self._api.named_type(f'{BUILTINS_NAME}.set', [self._api.named_type(f'{BUILTINS_NAME}.str')])
         optional_set_str = UnionType([set_str, NoneType()])
         fields_set_argument = Argument(Var('_fields_set', optional_set_str), optional_set_str, None, ARG_OPT)
-        construct_arguments = self.get_field_arguments(fields, typed=True, force_all_optional=False, use_alias=False)
-        construct_arguments = [fields_set_argument] + construct_arguments
+        with state.strict_optional_set(self._api.options.strict_optional):
+            args = self.get_field_arguments(
+                fields, typed=True, requires_dynamic_aliases=False, use_alias=False, is_settings=is_settings
+            )
+        if not self.should_init_forbid_extra(fields, config):
+            var = Var('kwargs')
+            args.append(Argument(var, AnyType(TypeOfAny.explicit), None, ARG_STAR2))
 
-        obj_type = ctx.api.named_type(f'{BUILTINS_NAME}.object')
-        self_tvar_name = '_PydanticBaseModel'  # Make sure it does not conflict with other names in the class
-        tvar_fullname = ctx.cls.fullname + '.' + self_tvar_name
-        tvd = TypeVarDef(self_tvar_name, tvar_fullname, -1, [], obj_type)
-        self_tvar_expr = TypeVarExpr(self_tvar_name, tvar_fullname, [], obj_type)
-        ctx.cls.info.names[self_tvar_name] = SymbolTableNode(MDEF, self_tvar_expr)
-
-        # Backward-compatible with TypeVarDef from Mypy 0.910.
-        if isinstance(tvd, TypeVarType):
-            self_type = tvd
-        else:
-            self_type = TypeVarType(tvd)  # type: ignore[call-arg]
+        args = [fields_set_argument] + args
 
         add_method(
-            ctx,
-            'construct',
-            construct_arguments,
-            return_type=self_type,
-            self_type=self_type,
-            tvar_def=tvd,
+            self._api,
+            self._cls,
+            'model_construct',
+            args=args,
+            return_type=fill_typevars(self._cls.info),
             is_classmethod=True,
         )
 
-    def set_frozen(self, fields: List['PydanticModelField'], frozen: bool) -> None:
-        """
-        Marks all fields as properties so that attempts to set them trigger mypy errors.
+    def set_frozen(self, fields: list[PydanticModelField], api: SemanticAnalyzerPluginInterface, frozen: bool) -> None:
+        """Marks all fields as properties so that attempts to set them trigger mypy errors.
 
         This is the same approach used by the attrs and dataclasses plugins.
         """
-        info = self._ctx.cls.info
+        info = self._cls.info
         for field in fields:
             sym_node = info.names.get(field.name)
             if sym_node is not None:
                 var = sym_node.node
-                assert isinstance(var, Var)
-                var.is_property = frozen
+                if isinstance(var, Var):
+                    var.is_property = frozen
+                elif isinstance(var, PlaceholderNode) and not self._api.final_iteration:
+                    # See https://github.com/pydantic/pydantic/issues/5191 to hit this branch for test coverage
+                    self._api.defer()
+                else:  # pragma: no cover
+                    # I don't know whether it's possible to hit this branch, but I've added it for safety
+                    try:
+                        var_str = str(var)
+                    except TypeError:
+                        # This happens for PlaceholderNode; perhaps it will happen for other types in the future..
+                        var_str = repr(var)
+                    detail = f'sym_node.node: {var_str} (of type {var.__class__})'
+                    error_unexpected_behavior(detail, self._api, self._cls)
             else:
-                var = field.to_var(info, use_alias=False)
+                var = field.to_var(info, api, use_alias=False)
                 var.info = info
                 var.is_property = frozen
-                var._fullname = get_fullname(info) + '.' + get_name(var)
-                info.names[get_name(var)] = SymbolTableNode(MDEF, var)
+                var._fullname = info.fullname + '.' + var.name
+                info.names[var.name] = SymbolTableNode(MDEF, var)
 
-    def get_config_update(self, substmt: AssignmentStmt) -> Optional['ModelConfigData']:
-        """
-        Determines the config update due to a single statement in the Config class definition.
+    def get_config_update(self, name: str, arg: Expression) -> ModelConfigData | None:
+        """Determines the config update due to a single kwarg in the ConfigDict definition.
 
         Warns if a tracked config attribute is set to a value the plugin doesn't know how to interpret (e.g., an int)
         """
-        lhs = substmt.lvalues[0]
-        if not (isinstance(lhs, NameExpr) and lhs.name in self.tracked_config_fields):
+        if name not in self.tracked_config_fields:
             return None
-        if lhs.name == 'extra':
-            if isinstance(substmt.rvalue, StrExpr):
-                forbid_extra = substmt.rvalue.value == 'forbid'
-            elif isinstance(substmt.rvalue, MemberExpr):
-                forbid_extra = substmt.rvalue.name == 'forbid'
+        if name == 'extra':
+            if isinstance(arg, StrExpr):
+                forbid_extra = arg.value == 'forbid'
+            elif isinstance(arg, MemberExpr):
+                forbid_extra = arg.name == 'forbid'
             else:
-                error_invalid_config_value(lhs.name, self._ctx.api, substmt)
+                error_invalid_config_value(name, self._api, arg)
                 return None
             return ModelConfigData(forbid_extra=forbid_extra)
-        if lhs.name == 'alias_generator':
+        if name == 'alias_generator':
             has_alias_generator = True
-            if isinstance(substmt.rvalue, NameExpr) and substmt.rvalue.fullname == 'builtins.None':
+            if isinstance(arg, NameExpr) and arg.fullname == 'builtins.None':
                 has_alias_generator = False
             return ModelConfigData(has_alias_generator=has_alias_generator)
-        if isinstance(substmt.rvalue, NameExpr) and substmt.rvalue.fullname in ('builtins.True', 'builtins.False'):
-            return ModelConfigData(**{lhs.name: substmt.rvalue.fullname == 'builtins.True'})
-        error_invalid_config_value(lhs.name, self._ctx.api, substmt)
+        if isinstance(arg, NameExpr) and arg.fullname in ('builtins.True', 'builtins.False'):
+            return ModelConfigData(**{name: arg.fullname == 'builtins.True'})
+        error_invalid_config_value(name, self._api, arg)
         return None
 
     @staticmethod
-    def get_is_required(cls: ClassDef, stmt: AssignmentStmt, lhs: NameExpr) -> bool:
-        """
-        Returns a boolean indicating whether the field defined in `stmt` is a required field.
-        """
+    def get_has_default(stmt: AssignmentStmt) -> bool:
+        """Returns a boolean indicating whether the field defined in `stmt` is a required field."""
         expr = stmt.rvalue
         if isinstance(expr, TempNode):
-            # TempNode means annotation-only, so only non-required if Optional
-            value_type = get_proper_type(cls.info[lhs.name].type)
-            if isinstance(value_type, UnionType) and any(isinstance(item, NoneType) for item in value_type.items):
-                # Annotated as Optional, or otherwise having NoneType in the union
-                return False
-            return True
+            # TempNode means annotation-only, so has no default
+            return False
         if isinstance(expr, CallExpr) and isinstance(expr.callee, RefExpr) and expr.callee.fullname == FIELD_FULLNAME:
-            # The "default value" is a call to `Field`; at this point, the field is
-            # only required if default is Ellipsis (i.e., `field_name: Annotation = Field(...)`) or if default_factory
-            # is specified.
+            # The "default value" is a call to `Field`; at this point, the field has a default if and only if:
+            # * there is a positional argument that is not `...`
+            # * there is a keyword argument named "default" that is not `...`
+            # * there is a "default_factory" that is not `None`
             for arg, name in zip(expr.args, expr.arg_names):
-                # If name is None, then this arg is the default because it is the only positonal argument.
+                # If name is None, then this arg is the default because it is the only positional argument.
                 if name is None or name == 'default':
-                    return arg.__class__ is EllipsisExpr
+                    return arg.__class__ is not EllipsisExpr
                 if name == 'default_factory':
-                    return False
-            return True
-        # Only required if the "default value" is Ellipsis (i.e., `field_name: Annotation = ...`)
-        return isinstance(expr, EllipsisExpr)
+                    return not (isinstance(arg, NameExpr) and arg.fullname == 'builtins.None')
+            return False
+        # Has no default if the "default value" is Ellipsis (i.e., `field_name: Annotation = ...`)
+        return not isinstance(expr, EllipsisExpr)
 
     @staticmethod
-    def get_alias_info(stmt: AssignmentStmt) -> Tuple[Optional[str], bool]:
-        """
-        Returns a pair (alias, has_dynamic_alias), extracted from the declaration of the field defined in `stmt`.
+    def get_alias_info(stmt: AssignmentStmt) -> tuple[str | None, bool]:
+        """Returns a pair (alias, has_dynamic_alias), extracted from the declaration of the field defined in `stmt`.
 
         `has_dynamic_alias` is True if and only if an alias is provided, but not as a string literal.
         If `has_dynamic_alias` is True, `alias` will be None.
@@ -573,29 +1033,38 @@ class PydanticModelTransformer:
         return None, False
 
     def get_field_arguments(
-        self, fields: List['PydanticModelField'], typed: bool, force_all_optional: bool, use_alias: bool
-    ) -> List[Argument]:
-        """
-        Helper function used during the construction of the `__init__` and `construct` method signatures.
+        self,
+        fields: list[PydanticModelField],
+        typed: bool,
+        use_alias: bool,
+        requires_dynamic_aliases: bool,
+        is_settings: bool,
+    ) -> list[Argument]:
+        """Helper function used during the construction of the `__init__` and `model_construct` method signatures.
 
         Returns a list of mypy Argument instances for use in the generated signatures.
         """
-        info = self._ctx.cls.info
+        info = self._cls.info
         arguments = [
-            field.to_argument(info, typed=typed, force_optional=force_all_optional, use_alias=use_alias)
+            field.to_argument(
+                info,
+                typed=typed,
+                force_optional=requires_dynamic_aliases or is_settings,
+                use_alias=use_alias,
+                api=self._api,
+            )
             for field in fields
             if not (use_alias and field.has_dynamic_alias)
         ]
         return arguments
 
-    def should_init_forbid_extra(self, fields: List['PydanticModelField'], config: 'ModelConfigData') -> bool:
-        """
-        Indicates whether the generated `__init__` should get a `**kwargs` at the end of its signature
+    def should_init_forbid_extra(self, fields: list[PydanticModelField], config: ModelConfigData) -> bool:
+        """Indicates whether the generated `__init__` should get a `**kwargs` at the end of its signature.
 
         We disallow arbitrary kwargs if the extra config setting is "forbid", or if the plugin config says to,
         *unless* a required dynamic alias is present (since then we can't determine a valid signature).
         """
-        if not config.allow_population_by_field_name:
+        if not config.populate_by_name:
             if self.is_dynamic_alias_present(fields, bool(config.has_alias_generator)):
                 return False
         if config.forbid_extra:
@@ -603,9 +1072,8 @@ class PydanticModelTransformer:
         return self.plugin_config.init_forbid_extra
 
     @staticmethod
-    def is_dynamic_alias_present(fields: List['PydanticModelField'], has_alias_generator: bool) -> bool:
-        """
-        Returns whether any fields on the model have a "dynamic alias", i.e., an alias that cannot be
+    def is_dynamic_alias_present(fields: list[PydanticModelField], has_alias_generator: bool) -> bool:
+        """Returns whether any fields on the model have a "dynamic alias", i.e., an alias that cannot be
         determined during static analysis.
         """
         for field in fields:
@@ -618,95 +1086,74 @@ class PydanticModelTransformer:
         return False
 
 
-class PydanticModelField:
-    def __init__(
-        self, name: str, is_required: bool, alias: Optional[str], has_dynamic_alias: bool, line: int, column: int
-    ):
-        self.name = name
-        self.is_required = is_required
-        self.alias = alias
-        self.has_dynamic_alias = has_dynamic_alias
-        self.line = line
-        self.column = column
-
-    def to_var(self, info: TypeInfo, use_alias: bool) -> Var:
-        name = self.name
-        if use_alias and self.alias is not None:
-            name = self.alias
-        return Var(name, info[self.name].type)
-
-    def to_argument(self, info: TypeInfo, typed: bool, force_optional: bool, use_alias: bool) -> Argument:
-        if typed and info[self.name].type is not None:
-            type_annotation = info[self.name].type
-        else:
-            type_annotation = AnyType(TypeOfAny.explicit)
-        return Argument(
-            variable=self.to_var(info, use_alias),
-            type_annotation=type_annotation,
-            initializer=None,
-            kind=ARG_NAMED_OPT if force_optional or not self.is_required else ARG_NAMED,
-        )
-
-    def serialize(self) -> JsonDict:
-        return self.__dict__
-
-    @classmethod
-    def deserialize(cls, info: TypeInfo, data: JsonDict) -> 'PydanticModelField':
-        return cls(**data)
-
-
 class ModelConfigData:
+    """Pydantic mypy plugin model config class."""
+
     def __init__(
         self,
-        forbid_extra: Optional[bool] = None,
-        allow_mutation: Optional[bool] = None,
-        frozen: Optional[bool] = None,
-        orm_mode: Optional[bool] = None,
-        allow_population_by_field_name: Optional[bool] = None,
-        has_alias_generator: Optional[bool] = None,
+        forbid_extra: bool | None = None,
+        frozen: bool | None = None,
+        from_attributes: bool | None = None,
+        populate_by_name: bool | None = None,
+        has_alias_generator: bool | None = None,
     ):
         self.forbid_extra = forbid_extra
-        self.allow_mutation = allow_mutation
         self.frozen = frozen
-        self.orm_mode = orm_mode
-        self.allow_population_by_field_name = allow_population_by_field_name
+        self.from_attributes = from_attributes
+        self.populate_by_name = populate_by_name
         self.has_alias_generator = has_alias_generator
 
-    def set_values_dict(self) -> Dict[str, Any]:
+    def get_values_dict(self) -> dict[str, Any]:
+        """Returns a dict of Pydantic model config names to their values.
+
+        It includes the config if config value is not `None`.
+        """
         return {k: v for k, v in self.__dict__.items() if v is not None}
 
-    def update(self, config: Optional['ModelConfigData']) -> None:
+    def update(self, config: ModelConfigData | None) -> None:
+        """Update Pydantic model config values."""
         if config is None:
             return
-        for k, v in config.set_values_dict().items():
+        for k, v in config.get_values_dict().items():
             setattr(self, k, v)
 
     def setdefault(self, key: str, value: Any) -> None:
+        """Set default value for Pydantic model config if config value is `None`."""
         if getattr(self, key) is None:
             setattr(self, key, value)
 
 
-ERROR_ORM = ErrorCode('pydantic-orm', 'Invalid from_orm call', 'Pydantic')
+ERROR_ORM = ErrorCode('pydantic-orm', 'Invalid from_attributes call', 'Pydantic')
 ERROR_CONFIG = ErrorCode('pydantic-config', 'Invalid config value', 'Pydantic')
 ERROR_ALIAS = ErrorCode('pydantic-alias', 'Dynamic alias disallowed', 'Pydantic')
 ERROR_UNEXPECTED = ErrorCode('pydantic-unexpected', 'Unexpected behavior', 'Pydantic')
 ERROR_UNTYPED = ErrorCode('pydantic-field', 'Untyped field disallowed', 'Pydantic')
 ERROR_FIELD_DEFAULTS = ErrorCode('pydantic-field', 'Invalid Field defaults', 'Pydantic')
+ERROR_EXTRA_FIELD_ROOT_MODEL = ErrorCode('pydantic-field', 'Extra field on RootModel subclass', 'Pydantic')
 
 
-def error_from_orm(model_name: str, api: CheckerPluginInterface, context: Context) -> None:
-    api.fail(f'"{model_name}" does not have orm_mode=True', context, code=ERROR_ORM)
+def error_from_attributes(model_name: str, api: CheckerPluginInterface, context: Context) -> None:
+    """Emits an error when the model does not have `from_attributes=True`."""
+    api.fail(f'"{model_name}" does not have from_attributes=True', context, code=ERROR_ORM)
 
 
 def error_invalid_config_value(name: str, api: SemanticAnalyzerPluginInterface, context: Context) -> None:
+    """Emits an error when the config value is invalid."""
     api.fail(f'Invalid value for "Config.{name}"', context, code=ERROR_CONFIG)
 
 
 def error_required_dynamic_aliases(api: SemanticAnalyzerPluginInterface, context: Context) -> None:
+    """Emits required dynamic aliases error.
+
+    This will be called when `warn_required_dynamic_aliases=True`.
+    """
     api.fail('Required dynamic aliases disallowed', context, code=ERROR_ALIAS)
 
 
-def error_unexpected_behavior(detail: str, api: CheckerPluginInterface, context: Context) -> None:  # pragma: no cover
+def error_unexpected_behavior(
+    detail: str, api: CheckerPluginInterface | SemanticAnalyzerPluginInterface, context: Context
+) -> None:  # pragma: no cover
+    """Emits unexpected behavior error."""
     # Can't think of a good way to test this, but I confirmed it renders as desired by adding to a non-error path
     link = 'https://github.com/pydantic/pydantic/issues/new/choose'
     full_message = f'The pydantic mypy plugin ran into unexpected behavior: {detail}\n'
@@ -715,55 +1162,70 @@ def error_unexpected_behavior(detail: str, api: CheckerPluginInterface, context:
 
 
 def error_untyped_fields(api: SemanticAnalyzerPluginInterface, context: Context) -> None:
+    """Emits an error when there is an untyped field in the model."""
     api.fail('Untyped fields disallowed', context, code=ERROR_UNTYPED)
 
 
+def error_extra_fields_on_root_model(api: CheckerPluginInterface, context: Context) -> None:
+    """Emits an error when there is more than just a root field defined for a subclass of RootModel."""
+    api.fail('Only `root` is allowed as a field of a `RootModel`', context, code=ERROR_EXTRA_FIELD_ROOT_MODEL)
+
+
 def error_default_and_default_factory_specified(api: CheckerPluginInterface, context: Context) -> None:
+    """Emits an error when `Field` has both `default` and `default_factory` together."""
     api.fail('Field default and default_factory cannot be specified together', context, code=ERROR_FIELD_DEFAULTS)
 
 
 def add_method(
-    ctx: ClassDefContext,
+    api: SemanticAnalyzerPluginInterface | CheckerPluginInterface,
+    cls: ClassDef,
     name: str,
-    args: List[Argument],
+    args: list[Argument],
     return_type: Type,
-    self_type: Optional[Type] = None,
-    tvar_def: Optional[TypeVarDef] = None,
+    self_type: Type | None = None,
+    tvar_def: TypeVarDef | None = None,
     is_classmethod: bool = False,
-    is_new: bool = False,
-    # is_staticmethod: bool = False,
 ) -> None:
-    """
-    Adds a new method to a class.
-
-    This can be dropped if/when https://github.com/python/mypy/issues/7301 is merged
-    """
-    info = ctx.cls.info
+    """Very closely related to `mypy.plugins.common.add_method_to_class`, with a few pydantic-specific changes."""
+    info = cls.info
 
     # First remove any previously generated methods with the same name
     # to avoid clashes and problems in the semantic analyzer.
     if name in info.names:
         sym = info.names[name]
         if sym.plugin_generated and isinstance(sym.node, FuncDef):
-            ctx.cls.defs.body.remove(sym.node)  # pragma: no cover
+            cls.defs.body.remove(sym.node)  # pragma: no cover
 
-    self_type = self_type or fill_typevars(info)
-    if is_classmethod or is_new:
-        first = [Argument(Var('_cls'), TypeType.make_normalized(self_type), None, ARG_POS)]
-    # elif is_staticmethod:
-    #     first = []
+    if isinstance(api, SemanticAnalyzerPluginInterface):
+        function_type = api.named_type('builtins.function')
+    else:
+        function_type = api.named_generic_type('builtins.function', [])
+
+    if is_classmethod:
+        self_type = self_type or TypeType(fill_typevars(info))
+        first = [Argument(Var('_cls'), self_type, None, ARG_POS, True)]
     else:
         self_type = self_type or fill_typevars(info)
+        # `self` is positional *ONLY* here, but this can't be expressed
+        # fully in the mypy internal API. ARG_POS is the closest we can get.
+        # Using ARG_POS will, however, give mypy errors if a `self` field
+        # is present on a model:
+        #
+        #     Name "self" already defined (possibly by an import)  [no-redef]
+        #
+        # As a workaround, we give this argument a name that will
+        # never conflict. By its positional nature, this name will not
+        # be used or exposed to users.
         first = [Argument(Var('__pydantic_self__'), self_type, None, ARG_POS)]
     args = first + args
+
     arg_types, arg_names, arg_kinds = [], [], []
     for arg in args:
         assert arg.type_annotation, 'All arguments must be fully typed.'
         arg_types.append(arg.type_annotation)
-        arg_names.append(get_name(arg.variable))
+        arg_names.append(arg.variable.name)
         arg_kinds.append(arg.kind)
 
-    function_type = ctx.api.named_type(f'{BUILTINS_NAME}.function')
     signature = CallableType(arg_types, arg_kinds, arg_names, return_type, function_type)
     if tvar_def:
         signature.variables = [tvar_def]
@@ -772,8 +1234,7 @@ def add_method(
     func.info = info
     func.type = set_callable_name(signature, func)
     func.is_class = is_classmethod
-    # func.is_static = is_staticmethod
-    func._fullname = get_fullname(info) + '.' + name
+    func._fullname = info.fullname + '.' + name
     func.line = info.line
 
     # NOTE: we would like the plugin generated node to dominate, but we still
@@ -783,68 +1244,44 @@ def add_method(
         r_name = get_unique_redefinition_name(name, info.names)
         info.names[r_name] = info.names[name]
 
-    if is_classmethod:  # or is_staticmethod:
+    # Add decorator for is_classmethod
+    # The dataclasses plugin claims this is unnecessary for classmethods, but not including it results in a
+    # signature incompatible with the superclass, which causes mypy errors to occur for every subclass of BaseModel.
+    if is_classmethod:
         func.is_decorated = True
         v = Var(name, func.type)
         v.info = info
         v._fullname = func._fullname
-        # if is_classmethod:
         v.is_classmethod = True
         dec = Decorator(func, [NameExpr('classmethod')], v)
-        # else:
-        #     v.is_staticmethod = True
-        #     dec = Decorator(func, [NameExpr('staticmethod')], v)
-
         dec.line = info.line
         sym = SymbolTableNode(MDEF, dec)
     else:
         sym = SymbolTableNode(MDEF, func)
     sym.plugin_generated = True
-
     info.names[name] = sym
+
     info.defn.defs.body.append(func)
 
 
-def get_fullname(x: Union[FuncBase, SymbolNode]) -> str:
-    """
-    Used for compatibility with mypy 0.740; can be dropped once support for 0.740 is dropped.
-    """
-    fn = x.fullname
-    if callable(fn):  # pragma: no cover
-        return fn()
-    return fn
+def parse_toml(config_file: str) -> dict[str, Any] | None:
+    """Returns a dict of config keys to values.
 
-
-def get_name(x: Union[FuncBase, SymbolNode]) -> str:
+    It reads configs from toml file and returns `None` if the file is not a toml file.
     """
-    Used for compatibility with mypy 0.740; can be dropped once support for 0.740 is dropped.
-    """
-    fn = x.name
-    if callable(fn):  # pragma: no cover
-        return fn()
-    return fn
-
-
-def parse_toml(config_file: str) -> Optional[Dict[str, Any]]:
     if not config_file.endswith('.toml'):
         return None
 
-    read_mode = 'rb'
     if sys.version_info >= (3, 11):
         import tomllib as toml_
     else:
         try:
             import tomli as toml_
-        except ImportError:
-            # older versions of mypy have toml as a dependency, not tomli
-            read_mode = 'r'
-            try:
-                import toml as toml_  # type: ignore[no-redef]
-            except ImportError:  # pragma: no cover
-                import warnings
+        except ImportError:  # pragma: no cover
+            import warnings
 
-                warnings.warn('No TOML parser installed, cannot read configuration from `pyproject.toml`.')
-                return None
+            warnings.warn('No TOML parser installed, cannot read configuration from `pyproject.toml`.')
+            return None
 
-    with open(config_file, read_mode) as rf:
-        return toml_.load(rf)  # type: ignore[arg-type]
+    with open(config_file, 'rb') as rf:
+        return toml_.load(rf)
diff --git a/lib/pydantic/networks.py b/lib/pydantic/networks.py
index c7d97186..6d9d292f 100644
--- a/lib/pydantic/networks.py
+++ b/lib/pydantic/networks.py
@@ -1,80 +1,35 @@
-import re
-from ipaddress import (
-    IPv4Address,
-    IPv4Interface,
-    IPv4Network,
-    IPv6Address,
-    IPv6Interface,
-    IPv6Network,
-    _BaseAddress,
-    _BaseNetwork,
-)
-from typing import (
-    TYPE_CHECKING,
-    Any,
-    Collection,
-    Dict,
-    Generator,
-    List,
-    Match,
-    Optional,
-    Pattern,
-    Set,
-    Tuple,
-    Type,
-    Union,
-    cast,
-    no_type_check,
-)
+"""The networks module contains types for common network-related fields."""
+from __future__ import annotations as _annotations
 
-from . import errors
-from .utils import Representation, update_not_none
-from .validators import constr_length_validator, str_validator
+import dataclasses as _dataclasses
+import re
+from importlib.metadata import version
+from ipaddress import IPv4Address, IPv4Interface, IPv4Network, IPv6Address, IPv6Interface, IPv6Network
+from typing import TYPE_CHECKING, Any
+
+from pydantic_core import MultiHostUrl, PydanticCustomError, Url, core_schema
+from typing_extensions import Annotated, TypeAlias
+
+from ._internal import _fields, _repr, _schema_generation_shared
+from ._migration import getattr_migration
+from .annotated_handlers import GetCoreSchemaHandler
+from .json_schema import JsonSchemaValue
 
 if TYPE_CHECKING:
     import email_validator
-    from typing_extensions import TypedDict
 
-    from .config import BaseConfig
-    from .fields import ModelField
-    from .typing import AnyCallable
-
-    CallableGenerator = Generator[AnyCallable, None, None]
-
-    class Parts(TypedDict, total=False):
-        scheme: str
-        user: Optional[str]
-        password: Optional[str]
-        ipv4: Optional[str]
-        ipv6: Optional[str]
-        domain: Optional[str]
-        port: Optional[str]
-        path: Optional[str]
-        query: Optional[str]
-        fragment: Optional[str]
-
-    class HostParts(TypedDict, total=False):
-        host: str
-        tld: Optional[str]
-        host_type: Optional[str]
-        port: Optional[str]
-        rebuild: bool
+    NetworkType: TypeAlias = 'str | bytes | int | tuple[str | bytes | int, str | int]'
 
 else:
     email_validator = None
 
-    class Parts(dict):
-        pass
-
-
-NetworkType = Union[str, bytes, int, Tuple[Union[str, bytes, int], Union[str, int]]]
 
 __all__ = [
     'AnyUrl',
     'AnyHttpUrl',
     'FileUrl',
     'HttpUrl',
-    'stricturl',
+    'UrlConstraints',
     'EmailStr',
     'NameEmail',
     'IPvAnyAddress',
@@ -86,489 +41,321 @@ __all__ = [
     'RedisDsn',
     'MongoDsn',
     'KafkaDsn',
+    'NatsDsn',
     'validate_email',
+    'MySQLDsn',
+    'MariaDBDsn',
 ]
 
-_url_regex_cache = None
-_multi_host_url_regex_cache = None
-_ascii_domain_regex_cache = None
-_int_domain_regex_cache = None
-_host_regex_cache = None
 
-_host_regex = (
-    r'(?:'
-    r'(?P<ipv4>(?:\d{1,3}\.){3}\d{1,3})(?=$|[/:#?])|'  # ipv4
-    r'(?P<ipv6>\[[A-F0-9]*:[A-F0-9:]+\])(?=$|[/:#?])|'  # ipv6
-    r'(?P<domain>[^\s/:?#]+)'  # domain, validation occurs later
-    r')?'
-    r'(?::(?P<port>\d+))?'  # port
+@_dataclasses.dataclass
+class UrlConstraints(_fields.PydanticMetadata):
+    """Url constraints.
+
+    Attributes:
+        max_length: The maximum length of the url. Defaults to `None`.
+        allowed_schemes: The allowed schemes. Defaults to `None`.
+        host_required: Whether the host is required. Defaults to `None`.
+        default_host: The default host. Defaults to `None`.
+        default_port: The default port. Defaults to `None`.
+        default_path: The default path. Defaults to `None`.
+    """
+
+    max_length: int | None = None
+    allowed_schemes: list[str] | None = None
+    host_required: bool | None = None
+    default_host: str | None = None
+    default_port: int | None = None
+    default_path: str | None = None
+
+    def __hash__(self) -> int:
+        return hash(
+            (
+                self.max_length,
+                tuple(self.allowed_schemes) if self.allowed_schemes is not None else None,
+                self.host_required,
+                self.default_host,
+                self.default_port,
+                self.default_path,
+            )
+        )
+
+
+AnyUrl = Url
+"""Base type for all URLs.
+
+* Any scheme allowed
+* Top-level domain (TLD) not required
+* Host required
+
+Assuming an input URL of `http://samuel:pass@example.com:8000/the/path/?query=here#fragment=is;this=bit`,
+the types export the following properties:
+
+- `scheme`: the URL scheme (`http`), always set.
+- `host`: the URL host (`example.com`), always set.
+- `username`: optional username if included (`samuel`).
+- `password`: optional password if included (`pass`).
+- `port`: optional port (`8000`).
+- `path`: optional path (`/the/path/`).
+- `query`: optional URL query (for example, `GET` arguments or "search string", such as `query=here`).
+- `fragment`: optional fragment (`fragment=is;this=bit`).
+"""
+AnyHttpUrl = Annotated[Url, UrlConstraints(allowed_schemes=['http', 'https'])]
+"""A type that will accept any http or https URL.
+
+* TLD not required
+* Host required
+"""
+HttpUrl = Annotated[Url, UrlConstraints(max_length=2083, allowed_schemes=['http', 'https'])]
+"""A type that will accept any http or https URL.
+
+* TLD required
+* Host required
+* Max length 2083
+
+```py
+from pydantic import BaseModel, HttpUrl, ValidationError
+
+class MyModel(BaseModel):
+    url: HttpUrl
+
+m = MyModel(url='http://www.example.com')
+print(m.url)
+#> http://www.example.com/
+
+try:
+    MyModel(url='ftp://invalid.url')
+except ValidationError as e:
+    print(e)
+    '''
+    1 validation error for MyModel
+    url
+      URL scheme should be 'http' or 'https' [type=url_scheme, input_value='ftp://invalid.url', input_type=str]
+    '''
+
+try:
+    MyModel(url='not a url')
+except ValidationError as e:
+    print(e)
+    '''
+    1 validation error for MyModel
+    url
+      Input should be a valid URL, relative URL without a base [type=url_parsing, input_value='not a url', input_type=str]
+    '''
+```
+
+"International domains" (e.g. a URL where the host or TLD includes non-ascii characters) will be encoded via
+[punycode](https://en.wikipedia.org/wiki/Punycode) (see
+[this article](https://www.xudongz.com/blog/2017/idn-phishing/) for a good description of why this is important):
+
+```py
+from pydantic import BaseModel, HttpUrl
+
+class MyModel(BaseModel):
+    url: HttpUrl
+
+m1 = MyModel(url='http://puny£code.com')
+print(m1.url)
+#> http://xn--punycode-eja.com/
+m2 = MyModel(url='https://www.аррӏе.com/')
+print(m2.url)
+#> https://www.xn--80ak6aa92e.com/
+m3 = MyModel(url='https://www.example.珠宝/')
+print(m3.url)
+#> https://www.example.xn--pbt977c/
+```
+
+
+!!! warning "Underscores in Hostnames"
+    In Pydantic, underscores are allowed in all parts of a domain except the TLD.
+    Technically this might be wrong - in theory the hostname cannot have underscores, but subdomains can.
+
+    To explain this; consider the following two cases:
+
+    - `exam_ple.co.uk`: the hostname is `exam_ple`, which should not be allowed since it contains an underscore.
+    - `foo_bar.example.com` the hostname is `example`, which should be allowed since the underscore is in the subdomain.
+
+    Without having an exhaustive list of TLDs, it would be impossible to differentiate between these two. Therefore
+    underscores are allowed, but you can always do further validation in a validator if desired.
+
+    Also, Chrome, Firefox, and Safari all currently accept `http://exam_ple.com` as a URL, so we're in good
+    (or at least big) company.
+"""
+FileUrl = Annotated[Url, UrlConstraints(allowed_schemes=['file'])]
+"""A type that will accept any file URL.
+
+* Host not required
+"""
+PostgresDsn = Annotated[
+    MultiHostUrl,
+    UrlConstraints(
+        host_required=True,
+        allowed_schemes=[
+            'postgres',
+            'postgresql',
+            'postgresql+asyncpg',
+            'postgresql+pg8000',
+            'postgresql+psycopg',
+            'postgresql+psycopg2',
+            'postgresql+psycopg2cffi',
+            'postgresql+py-postgresql',
+            'postgresql+pygresql',
+        ],
+    ),
+]
+"""A type that will accept any Postgres DSN.
+
+* User info required
+* TLD not required
+* Host required
+* Supports multiple hosts
+
+If further validation is required, these properties can be used by validators to enforce specific behaviour:
+
+```py
+from pydantic import (
+    BaseModel,
+    HttpUrl,
+    PostgresDsn,
+    ValidationError,
+    field_validator,
 )
-_scheme_regex = r'(?:(?P<scheme>[a-z][a-z0-9+\-.]+)://)?'  # scheme https://tools.ietf.org/html/rfc3986#appendix-A
-_user_info_regex = r'(?:(?P<user>[^\s:/]*)(?::(?P<password>[^\s/]*))?@)?'
-_path_regex = r'(?P<path>/[^\s?#]*)?'
-_query_regex = r'(?:\?(?P<query>[^\s#]*))?'
-_fragment_regex = r'(?:#(?P<fragment>[^\s#]*))?'
 
-
-def url_regex() -> Pattern[str]:
-    global _url_regex_cache
-    if _url_regex_cache is None:
-        _url_regex_cache = re.compile(
-            rf'{_scheme_regex}{_user_info_regex}{_host_regex}{_path_regex}{_query_regex}{_fragment_regex}',
-            re.IGNORECASE,
-        )
-    return _url_regex_cache
-
-
-def multi_host_url_regex() -> Pattern[str]:
-    """
-    Compiled multi host url regex.
-
-    Additionally to `url_regex` it allows to match multiple hosts.
-    E.g. host1.db.net,host2.db.net
-    """
-    global _multi_host_url_regex_cache
-    if _multi_host_url_regex_cache is None:
-        _multi_host_url_regex_cache = re.compile(
-            rf'{_scheme_regex}{_user_info_regex}'
-            r'(?P<hosts>([^/]*))'  # validation occurs later
-            rf'{_path_regex}{_query_regex}{_fragment_regex}',
-            re.IGNORECASE,
-        )
-    return _multi_host_url_regex_cache
-
-
-def ascii_domain_regex() -> Pattern[str]:
-    global _ascii_domain_regex_cache
-    if _ascii_domain_regex_cache is None:
-        ascii_chunk = r'[_0-9a-z](?:[-_0-9a-z]{0,61}[_0-9a-z])?'
-        ascii_domain_ending = r'(?P<tld>\.[a-z]{2,63})?\.?'
-        _ascii_domain_regex_cache = re.compile(
-            fr'(?:{ascii_chunk}\.)*?{ascii_chunk}{ascii_domain_ending}', re.IGNORECASE
-        )
-    return _ascii_domain_regex_cache
-
-
-def int_domain_regex() -> Pattern[str]:
-    global _int_domain_regex_cache
-    if _int_domain_regex_cache is None:
-        int_chunk = r'[_0-9a-\U00040000](?:[-_0-9a-\U00040000]{0,61}[_0-9a-\U00040000])?'
-        int_domain_ending = r'(?P<tld>(\.[^\W\d_]{2,63})|(\.(?:xn--)[_0-9a-z-]{2,63}))?\.?'
-        _int_domain_regex_cache = re.compile(fr'(?:{int_chunk}\.)*?{int_chunk}{int_domain_ending}', re.IGNORECASE)
-    return _int_domain_regex_cache
-
-
-def host_regex() -> Pattern[str]:
-    global _host_regex_cache
-    if _host_regex_cache is None:
-        _host_regex_cache = re.compile(
-            _host_regex,
-            re.IGNORECASE,
-        )
-    return _host_regex_cache
-
-
-class AnyUrl(str):
-    strip_whitespace = True
-    min_length = 1
-    max_length = 2**16
-    allowed_schemes: Optional[Collection[str]] = None
-    tld_required: bool = False
-    user_required: bool = False
-    host_required: bool = True
-    hidden_parts: Set[str] = set()
-
-    __slots__ = ('scheme', 'user', 'password', 'host', 'tld', 'host_type', 'port', 'path', 'query', 'fragment')
-
-    @no_type_check
-    def __new__(cls, url: Optional[str], **kwargs) -> object:
-        return str.__new__(cls, cls.build(**kwargs) if url is None else url)
-
-    def __init__(
-        self,
-        url: str,
-        *,
-        scheme: str,
-        user: Optional[str] = None,
-        password: Optional[str] = None,
-        host: Optional[str] = None,
-        tld: Optional[str] = None,
-        host_type: str = 'domain',
-        port: Optional[str] = None,
-        path: Optional[str] = None,
-        query: Optional[str] = None,
-        fragment: Optional[str] = None,
-    ) -> None:
-        str.__init__(url)
-        self.scheme = scheme
-        self.user = user
-        self.password = password
-        self.host = host
-        self.tld = tld
-        self.host_type = host_type
-        self.port = port
-        self.path = path
-        self.query = query
-        self.fragment = fragment
-
-    @classmethod
-    def build(
-        cls,
-        *,
-        scheme: str,
-        user: Optional[str] = None,
-        password: Optional[str] = None,
-        host: str,
-        port: Optional[str] = None,
-        path: Optional[str] = None,
-        query: Optional[str] = None,
-        fragment: Optional[str] = None,
-        **_kwargs: str,
-    ) -> str:
-        parts = Parts(
-            scheme=scheme,
-            user=user,
-            password=password,
-            host=host,
-            port=port,
-            path=path,
-            query=query,
-            fragment=fragment,
-            **_kwargs,  # type: ignore[misc]
-        )
-
-        url = scheme + '://'
-        if user:
-            url += user
-        if password:
-            url += ':' + password
-        if user or password:
-            url += '@'
-        url += host
-        if port and ('port' not in cls.hidden_parts or cls.get_default_parts(parts).get('port') != port):
-            url += ':' + port
-        if path:
-            url += path
-        if query:
-            url += '?' + query
-        if fragment:
-            url += '#' + fragment
-        return url
-
-    @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-        update_not_none(field_schema, minLength=cls.min_length, maxLength=cls.max_length, format='uri')
-
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield cls.validate
-
-    @classmethod
-    def validate(cls, value: Any, field: 'ModelField', config: 'BaseConfig') -> 'AnyUrl':
-        if value.__class__ == cls:
-            return value
-        value = str_validator(value)
-        if cls.strip_whitespace:
-            value = value.strip()
-        url: str = cast(str, constr_length_validator(value, field, config))
-
-        m = cls._match_url(url)
-        # the regex should always match, if it doesn't please report with details of the URL tried
-        assert m, 'URL regex failed unexpectedly'
-
-        original_parts = cast('Parts', m.groupdict())
-        parts = cls.apply_default_parts(original_parts)
-        parts = cls.validate_parts(parts)
-
-        if m.end() != len(url):
-            raise errors.UrlExtraError(extra=url[m.end() :])
-
-        return cls._build_url(m, url, parts)
-
-    @classmethod
-    def _build_url(cls, m: Match[str], url: str, parts: 'Parts') -> 'AnyUrl':
-        """
-        Validate hosts and build the AnyUrl object. Split from `validate` so this method
-        can be altered in `MultiHostDsn`.
-        """
-        host, tld, host_type, rebuild = cls.validate_host(parts)
-
-        return cls(
-            None if rebuild else url,
-            scheme=parts['scheme'],
-            user=parts['user'],
-            password=parts['password'],
-            host=host,
-            tld=tld,
-            host_type=host_type,
-            port=parts['port'],
-            path=parts['path'],
-            query=parts['query'],
-            fragment=parts['fragment'],
-        )
-
-    @staticmethod
-    def _match_url(url: str) -> Optional[Match[str]]:
-        return url_regex().match(url)
-
-    @staticmethod
-    def _validate_port(port: Optional[str]) -> None:
-        if port is not None and int(port) > 65_535:
-            raise errors.UrlPortError()
-
-    @classmethod
-    def validate_parts(cls, parts: 'Parts', validate_port: bool = True) -> 'Parts':
-        """
-        A method used to validate parts of a URL.
-        Could be overridden to set default values for parts if missing
-        """
-        scheme = parts['scheme']
-        if scheme is None:
-            raise errors.UrlSchemeError()
-
-        if cls.allowed_schemes and scheme.lower() not in cls.allowed_schemes:
-            raise errors.UrlSchemePermittedError(set(cls.allowed_schemes))
-
-        if validate_port:
-            cls._validate_port(parts['port'])
-
-        user = parts['user']
-        if cls.user_required and user is None:
-            raise errors.UrlUserInfoError()
-
-        return parts
-
-    @classmethod
-    def validate_host(cls, parts: 'Parts') -> Tuple[str, Optional[str], str, bool]:
-        tld, host_type, rebuild = None, None, False
-        for f in ('domain', 'ipv4', 'ipv6'):
-            host = parts[f]  # type: ignore[literal-required]
-            if host:
-                host_type = f
-                break
-
-        if host is None:
-            if cls.host_required:
-                raise errors.UrlHostError()
-        elif host_type == 'domain':
-            is_international = False
-            d = ascii_domain_regex().fullmatch(host)
-            if d is None:
-                d = int_domain_regex().fullmatch(host)
-                if d is None:
-                    raise errors.UrlHostError()
-                is_international = True
-
-            tld = d.group('tld')
-            if tld is None and not is_international:
-                d = int_domain_regex().fullmatch(host)
-                assert d is not None
-                tld = d.group('tld')
-                is_international = True
-
-            if tld is not None:
-                tld = tld[1:]
-            elif cls.tld_required:
-                raise errors.UrlHostTldError()
-
-            if is_international:
-                host_type = 'int_domain'
-                rebuild = True
-                host = host.encode('idna').decode('ascii')
-                if tld is not None:
-                    tld = tld.encode('idna').decode('ascii')
-
-        return host, tld, host_type, rebuild  # type: ignore
-
-    @staticmethod
-    def get_default_parts(parts: 'Parts') -> 'Parts':
-        return {}
-
-    @classmethod
-    def apply_default_parts(cls, parts: 'Parts') -> 'Parts':
-        for key, value in cls.get_default_parts(parts).items():
-            if not parts[key]:  # type: ignore[literal-required]
-                parts[key] = value  # type: ignore[literal-required]
-        return parts
-
-    def __repr__(self) -> str:
-        extra = ', '.join(f'{n}={getattr(self, n)!r}' for n in self.__slots__ if getattr(self, n) is not None)
-        return f'{self.__class__.__name__}({super().__repr__()}, {extra})'
-
-
-class AnyHttpUrl(AnyUrl):
-    allowed_schemes = {'http', 'https'}
-
-    __slots__ = ()
-
-
-class HttpUrl(AnyHttpUrl):
-    tld_required = True
-    # https://stackoverflow.com/questions/417142/what-is-the-maximum-length-of-a-url-in-different-browsers
-    max_length = 2083
-    hidden_parts = {'port'}
-
-    @staticmethod
-    def get_default_parts(parts: 'Parts') -> 'Parts':
-        return {'port': '80' if parts['scheme'] == 'http' else '443'}
-
-
-class FileUrl(AnyUrl):
-    allowed_schemes = {'file'}
-    host_required = False
-
-    __slots__ = ()
-
-
-class MultiHostDsn(AnyUrl):
-    __slots__ = AnyUrl.__slots__ + ('hosts',)
-
-    def __init__(self, *args: Any, hosts: Optional[List['HostParts']] = None, **kwargs: Any):
-        super().__init__(*args, **kwargs)
-        self.hosts = hosts
-
-    @staticmethod
-    def _match_url(url: str) -> Optional[Match[str]]:
-        return multi_host_url_regex().match(url)
-
-    @classmethod
-    def validate_parts(cls, parts: 'Parts', validate_port: bool = True) -> 'Parts':
-        return super().validate_parts(parts, validate_port=False)
-
-    @classmethod
-    def _build_url(cls, m: Match[str], url: str, parts: 'Parts') -> 'MultiHostDsn':
-        hosts_parts: List['HostParts'] = []
-        host_re = host_regex()
-        for host in m.groupdict()['hosts'].split(','):
-            d: Parts = host_re.match(host).groupdict()  # type: ignore
-            host, tld, host_type, rebuild = cls.validate_host(d)
-            port = d.get('port')
-            cls._validate_port(port)
-            hosts_parts.append(
-                {
-                    'host': host,
-                    'host_type': host_type,
-                    'tld': tld,
-                    'rebuild': rebuild,
-                    'port': port,
-                }
-            )
-
-        if len(hosts_parts) > 1:
-            return cls(
-                None if any([hp['rebuild'] for hp in hosts_parts]) else url,
-                scheme=parts['scheme'],
-                user=parts['user'],
-                password=parts['password'],
-                path=parts['path'],
-                query=parts['query'],
-                fragment=parts['fragment'],
-                host_type=None,
-                hosts=hosts_parts,
-            )
-        else:
-            # backwards compatibility with single host
-            host_part = hosts_parts[0]
-            return cls(
-                None if host_part['rebuild'] else url,
-                scheme=parts['scheme'],
-                user=parts['user'],
-                password=parts['password'],
-                host=host_part['host'],
-                tld=host_part['tld'],
-                host_type=host_part['host_type'],
-                port=host_part.get('port'),
-                path=parts['path'],
-                query=parts['query'],
-                fragment=parts['fragment'],
-            )
-
-
-class PostgresDsn(MultiHostDsn):
-    allowed_schemes = {
-        'postgres',
-        'postgresql',
-        'postgresql+asyncpg',
-        'postgresql+pg8000',
-        'postgresql+psycopg2',
-        'postgresql+psycopg2cffi',
-        'postgresql+py-postgresql',
-        'postgresql+pygresql',
-    }
-    user_required = True
-
-    __slots__ = ()
-
-
-class CockroachDsn(AnyUrl):
-    allowed_schemes = {
-        'cockroachdb',
-        'cockroachdb+psycopg2',
-        'cockroachdb+asyncpg',
-    }
-    user_required = True
-
-
-class AmqpDsn(AnyUrl):
-    allowed_schemes = {'amqp', 'amqps'}
-    host_required = False
-
-
-class RedisDsn(AnyUrl):
-    __slots__ = ()
-    allowed_schemes = {'redis', 'rediss'}
-    host_required = False
-
-    @staticmethod
-    def get_default_parts(parts: 'Parts') -> 'Parts':
-        return {
-            'domain': 'localhost' if not (parts['ipv4'] or parts['ipv6']) else '',
-            'port': '6379',
-            'path': '/0',
-        }
-
-
-class MongoDsn(AnyUrl):
-    allowed_schemes = {'mongodb'}
-
-    # TODO: Needed to generic "Parts" for "Replica Set", "Sharded Cluster", and other mongodb deployment modes
-    @staticmethod
-    def get_default_parts(parts: 'Parts') -> 'Parts':
-        return {
-            'port': '27017',
-        }
-
-
-class KafkaDsn(AnyUrl):
-    allowed_schemes = {'kafka'}
-
-    @staticmethod
-    def get_default_parts(parts: 'Parts') -> 'Parts':
-        return {
-            'domain': 'localhost',
-            'port': '9092',
-        }
-
-
-def stricturl(
-    *,
-    strip_whitespace: bool = True,
-    min_length: int = 1,
-    max_length: int = 2**16,
-    tld_required: bool = True,
-    host_required: bool = True,
-    allowed_schemes: Optional[Collection[str]] = None,
-) -> Type[AnyUrl]:
-    # use kwargs then define conf in a dict to aid with IDE type hinting
-    namespace = dict(
-        strip_whitespace=strip_whitespace,
-        min_length=min_length,
-        max_length=max_length,
-        tld_required=tld_required,
-        host_required=host_required,
-        allowed_schemes=allowed_schemes,
-    )
-    return type('UrlValue', (AnyUrl,), namespace)
+class MyModel(BaseModel):
+    url: HttpUrl
+
+m = MyModel(url='http://www.example.com')
+
+# the repr() method for a url will display all properties of the url
+print(repr(m.url))
+#> Url('http://www.example.com/')
+print(m.url.scheme)
+#> http
+print(m.url.host)
+#> www.example.com
+print(m.url.port)
+#> 80
+
+class MyDatabaseModel(BaseModel):
+    db: PostgresDsn
+
+    @field_validator('db')
+    def check_db_name(cls, v):
+        assert v.path and len(v.path) > 1, 'database must be provided'
+        return v
+
+m = MyDatabaseModel(db='postgres://user:pass@localhost:5432/foobar')
+print(m.db)
+#> postgres://user:pass@localhost:5432/foobar
+
+try:
+    MyDatabaseModel(db='postgres://user:pass@localhost:5432')
+except ValidationError as e:
+    print(e)
+    '''
+    1 validation error for MyDatabaseModel
+    db
+      Assertion failed, database must be provided
+    assert (None)
+     +  where None = MultiHostUrl('postgres://user:pass@localhost:5432').path [type=assertion_error, input_value='postgres://user:pass@localhost:5432', input_type=str]
+    '''
+```
+"""
+
+CockroachDsn = Annotated[
+    Url,
+    UrlConstraints(
+        host_required=True,
+        allowed_schemes=[
+            'cockroachdb',
+            'cockroachdb+psycopg2',
+            'cockroachdb+asyncpg',
+        ],
+    ),
+]
+"""A type that will accept any Cockroach DSN.
+
+* User info required
+* TLD not required
+* Host required
+"""
+AmqpDsn = Annotated[Url, UrlConstraints(allowed_schemes=['amqp', 'amqps'])]
+"""A type that will accept any AMQP DSN.
+
+* User info required
+* TLD not required
+* Host required
+"""
+RedisDsn = Annotated[
+    Url,
+    UrlConstraints(allowed_schemes=['redis', 'rediss'], default_host='localhost', default_port=6379, default_path='/0'),
+]
+"""A type that will accept any Redis DSN.
+
+* User info required
+* TLD not required
+* Host required (e.g., `rediss://:pass@localhost`)
+"""
+MongoDsn = Annotated[MultiHostUrl, UrlConstraints(allowed_schemes=['mongodb', 'mongodb+srv'], default_port=27017)]
+"""A type that will accept any MongoDB DSN.
+
+* User info not required
+* Database name not required
+* Port not required
+* User info may be passed without user part (e.g., `mongodb://mongodb0.example.com:27017`).
+"""
+KafkaDsn = Annotated[Url, UrlConstraints(allowed_schemes=['kafka'], default_host='localhost', default_port=9092)]
+"""A type that will accept any Kafka DSN.
+
+* User info required
+* TLD not required
+* Host required
+"""
+NatsDsn = Annotated[
+    MultiHostUrl, UrlConstraints(allowed_schemes=['nats', 'tls', 'ws'], default_host='localhost', default_port=4222)
+]
+"""A type that will accept any NATS DSN.
+
+NATS is a connective technology built for the ever increasingly hyper-connected world.
+It is a single technology that enables applications to securely communicate across
+any combination of cloud vendors, on-premise, edge, web and mobile, and devices.
+More: https://nats.io
+"""
+MySQLDsn = Annotated[
+    Url,
+    UrlConstraints(
+        allowed_schemes=[
+            'mysql',
+            'mysql+mysqlconnector',
+            'mysql+aiomysql',
+            'mysql+asyncmy',
+            'mysql+mysqldb',
+            'mysql+pymysql',
+            'mysql+cymysql',
+            'mysql+pyodbc',
+        ],
+        default_port=3306,
+    ),
+]
+"""A type that will accept any MySQL DSN.
+
+* User info required
+* TLD not required
+* Host required
+"""
+MariaDBDsn = Annotated[
+    Url,
+    UrlConstraints(
+        allowed_schemes=['mariadb', 'mariadb+mariadbconnector', 'mariadb+pymysql'],
+        default_port=3306,
+    ),
+]
+"""A type that will accept any MariaDB DSN.
+
+* User info required
+* TLD not required
+* Host required
+"""
 
 
 def import_email_validator() -> None:
@@ -577,27 +364,95 @@ def import_email_validator() -> None:
         import email_validator
     except ImportError as e:
         raise ImportError('email-validator is not installed, run `pip install pydantic[email]`') from e
+    if not version('email-validator').partition('.')[0] == '2':
+        raise ImportError('email-validator version >= 2.0 required, run pip install -U email-validator')
 
 
-class EmailStr(str):
-    @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-        field_schema.update(type='string', format='email')
+if TYPE_CHECKING:
+    EmailStr = Annotated[str, ...]
+else:
 
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        # included here and below so the error happens straight away
-        import_email_validator()
+    class EmailStr:
+        """
+        Info:
+            To use this type, you need to install the optional
+            [`email-validator`](https://github.com/JoshData/python-email-validator) package:
 
-        yield str_validator
-        yield cls.validate
+            ```bash
+            pip install email-validator
+            ```
 
-    @classmethod
-    def validate(cls, value: Union[str]) -> str:
-        return validate_email(value)[1]
+        Validate email addresses.
+
+        ```py
+        from pydantic import BaseModel, EmailStr
+
+        class Model(BaseModel):
+            email: EmailStr
+
+        print(Model(email='contact@mail.com'))
+        #> email='contact@mail.com'
+        ```
+        """  # noqa: D212
+
+        @classmethod
+        def __get_pydantic_core_schema__(
+            cls,
+            _source: type[Any],
+            _handler: GetCoreSchemaHandler,
+        ) -> core_schema.CoreSchema:
+            import_email_validator()
+            return core_schema.no_info_after_validator_function(cls._validate, core_schema.str_schema())
+
+        @classmethod
+        def __get_pydantic_json_schema__(
+            cls, core_schema: core_schema.CoreSchema, handler: _schema_generation_shared.GetJsonSchemaHandler
+        ) -> JsonSchemaValue:
+            field_schema = handler(core_schema)
+            field_schema.update(type='string', format='email')
+            return field_schema
+
+        @classmethod
+        def _validate(cls, __input_value: str) -> str:
+            return validate_email(__input_value)[1]
 
 
-class NameEmail(Representation):
+class NameEmail(_repr.Representation):
+    """
+    Info:
+        To use this type, you need to install the optional
+        [`email-validator`](https://github.com/JoshData/python-email-validator) package:
+
+        ```bash
+        pip install email-validator
+        ```
+
+    Validate a name and email address combination, as specified by
+    [RFC 5322](https://datatracker.ietf.org/doc/html/rfc5322#section-3.4).
+
+    The `NameEmail` has two properties: `name` and `email`.
+    In case the `name` is not provided, it's inferred from the email address.
+
+    ```py
+    from pydantic import BaseModel, NameEmail
+
+    class User(BaseModel):
+        email: NameEmail
+
+    user = User(email='Fred Bloggs <fred.bloggs@example.com>')
+    print(user.email)
+    #> Fred Bloggs <fred.bloggs@example.com>
+    print(user.email.name)
+    #> Fred Bloggs
+
+    user = User(email='fred.bloggs@example.com')
+    print(user.email)
+    #> fred.bloggs <fred.bloggs@example.com>
+    print(user.email.name)
+    #> fred.bloggs
+    ```
+    """  # noqa: D212
+
     __slots__ = 'name', 'email'
 
     def __init__(self, name: str, email: str):
@@ -608,39 +463,76 @@ class NameEmail(Representation):
         return isinstance(other, NameEmail) and (self.name, self.email) == (other.name, other.email)
 
     @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+    def __get_pydantic_json_schema__(
+        cls, core_schema: core_schema.CoreSchema, handler: _schema_generation_shared.GetJsonSchemaHandler
+    ) -> JsonSchemaValue:
+        field_schema = handler(core_schema)
         field_schema.update(type='string', format='name-email')
+        return field_schema
 
     @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
+    def __get_pydantic_core_schema__(
+        cls,
+        _source: type[Any],
+        _handler: GetCoreSchemaHandler,
+    ) -> core_schema.CoreSchema:
         import_email_validator()
-
-        yield cls.validate
+        return core_schema.no_info_after_validator_function(
+            cls._validate,
+            core_schema.union_schema(
+                [core_schema.is_instance_schema(cls), core_schema.str_schema()],
+                custom_error_type='name_email_type',
+                custom_error_message='Input is not a valid NameEmail',
+            ),
+            serialization=core_schema.to_string_ser_schema(),
+        )
 
     @classmethod
-    def validate(cls, value: Any) -> 'NameEmail':
-        if value.__class__ == cls:
-            return value
-        value = str_validator(value)
-        return cls(*validate_email(value))
+    def _validate(cls, __input_value: NameEmail | str) -> NameEmail:
+        if isinstance(__input_value, cls):
+            return __input_value
+        else:
+            name, email = validate_email(__input_value)  # type: ignore[arg-type]
+            return cls(name, email)
 
     def __str__(self) -> str:
         return f'{self.name} <{self.email}>'
 
 
-class IPvAnyAddress(_BaseAddress):
+class IPvAnyAddress:
+    """Validate an IPv4 or IPv6 address.
+
+    ```py
+    from pydantic import BaseModel
+    from pydantic.networks import IPvAnyAddress
+
+    class IpModel(BaseModel):
+        ip: IPvAnyAddress
+
+    print(IpModel(ip='127.0.0.1'))
+    #> ip=IPv4Address('127.0.0.1')
+
+    try:
+        IpModel(ip='http://www.example.com')
+    except ValueError as e:
+        print(e.errors())
+        '''
+        [
+            {
+                'type': 'ip_any_address',
+                'loc': ('ip',),
+                'msg': 'value is not a valid IPv4 or IPv6 address',
+                'input': 'http://www.example.com',
+            }
+        ]
+        '''
+    ```
+    """
+
     __slots__ = ()
 
-    @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-        field_schema.update(type='string', format='ipvanyaddress')
-
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield cls.validate
-
-    @classmethod
-    def validate(cls, value: Union[str, bytes, int]) -> Union[IPv4Address, IPv6Address]:
+    def __new__(cls, value: Any) -> IPv4Address | IPv6Address:
+        """Validate an IPv4 or IPv6 address."""
         try:
             return IPv4Address(value)
         except ValueError:
@@ -649,22 +541,38 @@ class IPvAnyAddress(_BaseAddress):
         try:
             return IPv6Address(value)
         except ValueError:
-            raise errors.IPvAnyAddressError()
+            raise PydanticCustomError('ip_any_address', 'value is not a valid IPv4 or IPv6 address')
+
+    @classmethod
+    def __get_pydantic_json_schema__(
+        cls, core_schema: core_schema.CoreSchema, handler: _schema_generation_shared.GetJsonSchemaHandler
+    ) -> JsonSchemaValue:
+        field_schema = {}
+        field_schema.update(type='string', format='ipvanyaddress')
+        return field_schema
+
+    @classmethod
+    def __get_pydantic_core_schema__(
+        cls,
+        _source: type[Any],
+        _handler: GetCoreSchemaHandler,
+    ) -> core_schema.CoreSchema:
+        return core_schema.no_info_plain_validator_function(
+            cls._validate, serialization=core_schema.to_string_ser_schema()
+        )
+
+    @classmethod
+    def _validate(cls, __input_value: Any) -> IPv4Address | IPv6Address:
+        return cls(__input_value)  # type: ignore[return-value]
 
 
-class IPvAnyInterface(_BaseAddress):
+class IPvAnyInterface:
+    """Validate an IPv4 or IPv6 interface."""
+
     __slots__ = ()
 
-    @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-        field_schema.update(type='string', format='ipvanyinterface')
-
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield cls.validate
-
-    @classmethod
-    def validate(cls, value: NetworkType) -> Union[IPv4Interface, IPv6Interface]:
+    def __new__(cls, value: NetworkType) -> IPv4Interface | IPv6Interface:
+        """Validate an IPv4 or IPv6 interface."""
         try:
             return IPv4Interface(value)
         except ValueError:
@@ -673,21 +581,39 @@ class IPvAnyInterface(_BaseAddress):
         try:
             return IPv6Interface(value)
         except ValueError:
-            raise errors.IPvAnyInterfaceError()
-
-
-class IPvAnyNetwork(_BaseNetwork):  # type: ignore
-    @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-        field_schema.update(type='string', format='ipvanynetwork')
+            raise PydanticCustomError('ip_any_interface', 'value is not a valid IPv4 or IPv6 interface')
 
     @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield cls.validate
+    def __get_pydantic_json_schema__(
+        cls, core_schema: core_schema.CoreSchema, handler: _schema_generation_shared.GetJsonSchemaHandler
+    ) -> JsonSchemaValue:
+        field_schema = {}
+        field_schema.update(type='string', format='ipvanyinterface')
+        return field_schema
 
     @classmethod
-    def validate(cls, value: NetworkType) -> Union[IPv4Network, IPv6Network]:
-        # Assume IP Network is defined with a default value for ``strict`` argument.
+    def __get_pydantic_core_schema__(
+        cls,
+        _source: type[Any],
+        _handler: GetCoreSchemaHandler,
+    ) -> core_schema.CoreSchema:
+        return core_schema.no_info_plain_validator_function(
+            cls._validate, serialization=core_schema.to_string_ser_schema()
+        )
+
+    @classmethod
+    def _validate(cls, __input_value: NetworkType) -> IPv4Interface | IPv6Interface:
+        return cls(__input_value)  # type: ignore[return-value]
+
+
+class IPvAnyNetwork:
+    """Validate an IPv4 or IPv6 network."""
+
+    __slots__ = ()
+
+    def __new__(cls, value: NetworkType) -> IPv4Network | IPv6Network:
+        """Validate an IPv4 or IPv6 network."""
+        # Assume IP Network is defined with a default value for `strict` argument.
         # Define your own class if you want to specify network address check strictness.
         try:
             return IPv4Network(value)
@@ -697,40 +623,86 @@ class IPvAnyNetwork(_BaseNetwork):  # type: ignore
         try:
             return IPv6Network(value)
         except ValueError:
-            raise errors.IPvAnyNetworkError()
+            raise PydanticCustomError('ip_any_network', 'value is not a valid IPv4 or IPv6 network')
+
+    @classmethod
+    def __get_pydantic_json_schema__(
+        cls, core_schema: core_schema.CoreSchema, handler: _schema_generation_shared.GetJsonSchemaHandler
+    ) -> JsonSchemaValue:
+        field_schema = {}
+        field_schema.update(type='string', format='ipvanynetwork')
+        return field_schema
+
+    @classmethod
+    def __get_pydantic_core_schema__(
+        cls,
+        _source: type[Any],
+        _handler: GetCoreSchemaHandler,
+    ) -> core_schema.CoreSchema:
+        return core_schema.no_info_plain_validator_function(
+            cls._validate, serialization=core_schema.to_string_ser_schema()
+        )
+
+    @classmethod
+    def _validate(cls, __input_value: NetworkType) -> IPv4Network | IPv6Network:
+        return cls(__input_value)  # type: ignore[return-value]
 
 
-pretty_email_regex = re.compile(r'([\w ]*?) *<(.*)> *')
+def _build_pretty_email_regex() -> re.Pattern[str]:
+    name_chars = r'[\w!#$%&\'*+\-/=?^_`{|}~]'
+    unquoted_name_group = rf'((?:{name_chars}+\s+)*{name_chars}+)'
+    quoted_name_group = r'"((?:[^"]|\")+)"'
+    email_group = r'<\s*(.+)\s*>'
+    return re.compile(rf'\s*(?:{unquoted_name_group}|{quoted_name_group})?\s*{email_group}\s*')
 
 
-def validate_email(value: Union[str]) -> Tuple[str, str]:
-    """
-    Brutally simple email address validation. Note unlike most email address validation
-    * raw ip address (literal) domain parts are not allowed.
-    * "John Doe <local_part@domain.com>" style "pretty" email addresses are processed
-    * the local part check is extremely basic. This raises the possibility of unicode spoofing, but no better
-        solution is really possible.
-    * spaces are striped from the beginning and end of addresses but no error is raised
+pretty_email_regex = _build_pretty_email_regex()
 
-    See RFC 5322 but treat it with suspicion, there seems to exist no universally acknowledged test for a valid email!
+MAX_EMAIL_LENGTH = 2048
+"""Maximum length for an email.
+A somewhat arbitrary but very generous number compared to what is allowed by most implementations.
+"""
+
+
+def validate_email(value: str) -> tuple[str, str]:
+    """Email address validation using [email-validator](https://pypi.org/project/email-validator/).
+
+    Note:
+        Note that:
+
+        * Raw IP address (literal) domain parts are not allowed.
+        * `"John Doe <local_part@domain.com>"` style "pretty" email addresses are processed.
+        * Spaces are striped from the beginning and end of addresses, but no error is raised.
     """
     if email_validator is None:
         import_email_validator()
 
+    if len(value) > MAX_EMAIL_LENGTH:
+        raise PydanticCustomError(
+            'value_error',
+            'value is not a valid email address: {reason}',
+            {'reason': f'Length must not exceed {MAX_EMAIL_LENGTH} characters'},
+        )
+
     m = pretty_email_regex.fullmatch(value)
-    name: Optional[str] = None
+    name: str | None = None
     if m:
-        name, value = m.groups()
+        unquoted_name, quoted_name, value = m.groups()
+        name = unquoted_name or quoted_name
 
     email = value.strip()
 
     try:
-        email_validator.validate_email(email, check_deliverability=False)
+        parts = email_validator.validate_email(email, check_deliverability=False)
     except email_validator.EmailNotValidError as e:
-        raise errors.EmailError() from e
+        raise PydanticCustomError(
+            'value_error', 'value is not a valid email address: {reason}', {'reason': str(e.args[0])}
+        ) from e
 
-    at_index = email.index('@')
-    local_part = email[:at_index]  # RFC 5321, local part must be case-sensitive.
-    global_part = email[at_index:].lower()
+    email = parts.normalized
+    assert email is not None
+    name = name or parts.local_part
+    return name, email
 
-    return name or local_part, local_part + global_part
+
+__getattr__ = getattr_migration(__name__)
diff --git a/lib/pydantic/parse.py b/lib/pydantic/parse.py
index 7ac330ca..ceee6342 100644
--- a/lib/pydantic/parse.py
+++ b/lib/pydantic/parse.py
@@ -1,66 +1,4 @@
-import json
-import pickle
-from enum import Enum
-from pathlib import Path
-from typing import Any, Callable, Union
+"""The `parse` module is a backport module from V1."""
+from ._migration import getattr_migration
 
-from .types import StrBytes
-
-
-class Protocol(str, Enum):
-    json = 'json'
-    pickle = 'pickle'
-
-
-def load_str_bytes(
-    b: StrBytes,
-    *,
-    content_type: str = None,
-    encoding: str = 'utf8',
-    proto: Protocol = None,
-    allow_pickle: bool = False,
-    json_loads: Callable[[str], Any] = json.loads,
-) -> Any:
-    if proto is None and content_type:
-        if content_type.endswith(('json', 'javascript')):
-            pass
-        elif allow_pickle and content_type.endswith('pickle'):
-            proto = Protocol.pickle
-        else:
-            raise TypeError(f'Unknown content-type: {content_type}')
-
-    proto = proto or Protocol.json
-
-    if proto == Protocol.json:
-        if isinstance(b, bytes):
-            b = b.decode(encoding)
-        return json_loads(b)
-    elif proto == Protocol.pickle:
-        if not allow_pickle:
-            raise RuntimeError('Trying to decode with pickle with allow_pickle=False')
-        bb = b if isinstance(b, bytes) else b.encode()
-        return pickle.loads(bb)
-    else:
-        raise TypeError(f'Unknown protocol: {proto}')
-
-
-def load_file(
-    path: Union[str, Path],
-    *,
-    content_type: str = None,
-    encoding: str = 'utf8',
-    proto: Protocol = None,
-    allow_pickle: bool = False,
-    json_loads: Callable[[str], Any] = json.loads,
-) -> Any:
-    path = Path(path)
-    b = path.read_bytes()
-    if content_type is None:
-        if path.suffix in ('.js', '.json'):
-            proto = Protocol.json
-        elif path.suffix == '.pkl':
-            proto = Protocol.pickle
-
-    return load_str_bytes(
-        b, proto=proto, content_type=content_type, encoding=encoding, allow_pickle=allow_pickle, json_loads=json_loads
-    )
+__getattr__ = getattr_migration(__name__)
diff --git a/lib/pydantic/plugin/__init__.py b/lib/pydantic/plugin/__init__.py
new file mode 100644
index 00000000..84197006
--- /dev/null
+++ b/lib/pydantic/plugin/__init__.py
@@ -0,0 +1,170 @@
+"""Usage docs: https://docs.pydantic.dev/2.6/concepts/plugins#build-a-plugin
+
+Plugin interface for Pydantic plugins, and related types.
+"""
+from __future__ import annotations
+
+from typing import Any, Callable, NamedTuple
+
+from pydantic_core import CoreConfig, CoreSchema, ValidationError
+from typing_extensions import Literal, Protocol, TypeAlias
+
+__all__ = (
+    'PydanticPluginProtocol',
+    'BaseValidateHandlerProtocol',
+    'ValidatePythonHandlerProtocol',
+    'ValidateJsonHandlerProtocol',
+    'ValidateStringsHandlerProtocol',
+    'NewSchemaReturns',
+    'SchemaTypePath',
+    'SchemaKind',
+)
+
+NewSchemaReturns: TypeAlias = 'tuple[ValidatePythonHandlerProtocol | None, ValidateJsonHandlerProtocol | None, ValidateStringsHandlerProtocol | None]'
+
+
+class SchemaTypePath(NamedTuple):
+    """Path defining where `schema_type` was defined, or where `TypeAdapter` was called."""
+
+    module: str
+    name: str
+
+
+SchemaKind: TypeAlias = Literal['BaseModel', 'TypeAdapter', 'dataclass', 'create_model', 'validate_call']
+
+
+class PydanticPluginProtocol(Protocol):
+    """Protocol defining the interface for Pydantic plugins."""
+
+    def new_schema_validator(
+        self,
+        schema: CoreSchema,
+        schema_type: Any,
+        schema_type_path: SchemaTypePath,
+        schema_kind: SchemaKind,
+        config: CoreConfig | None,
+        plugin_settings: dict[str, object],
+    ) -> tuple[
+        ValidatePythonHandlerProtocol | None, ValidateJsonHandlerProtocol | None, ValidateStringsHandlerProtocol | None
+    ]:
+        """This method is called for each plugin every time a new [`SchemaValidator`][pydantic_core.SchemaValidator]
+        is created.
+
+        It should return an event handler for each of the three validation methods, or `None` if the plugin does not
+        implement that method.
+
+        Args:
+            schema: The schema to validate against.
+            schema_type: The original type which the schema was created from, e.g. the model class.
+            schema_type_path: Path defining where `schema_type` was defined, or where `TypeAdapter` was called.
+            schema_kind: The kind of schema to validate against.
+            config: The config to use for validation.
+            plugin_settings: Any plugin settings.
+
+        Returns:
+            A tuple of optional event handlers for each of the three validation methods -
+                `validate_python`, `validate_json`, `validate_strings`.
+        """
+        raise NotImplementedError('Pydantic plugins should implement `new_schema_validator`.')
+
+
+class BaseValidateHandlerProtocol(Protocol):
+    """Base class for plugin callbacks protocols.
+
+    You shouldn't implement this protocol directly, instead use one of the subclasses with adds the correctly
+    typed `on_error` method.
+    """
+
+    on_enter: Callable[..., None]
+    """`on_enter` is changed to be more specific on all subclasses"""
+
+    def on_success(self, result: Any) -> None:
+        """Callback to be notified of successful validation.
+
+        Args:
+            result: The result of the validation.
+        """
+        return
+
+    def on_error(self, error: ValidationError) -> None:
+        """Callback to be notified of validation errors.
+
+        Args:
+            error: The validation error.
+        """
+        return
+
+    def on_exception(self, exception: Exception) -> None:
+        """Callback to be notified of validation exceptions.
+
+        Args:
+            exception: The exception raised during validation.
+        """
+        return
+
+
+class ValidatePythonHandlerProtocol(BaseValidateHandlerProtocol, Protocol):
+    """Event handler for `SchemaValidator.validate_python`."""
+
+    def on_enter(
+        self,
+        input: Any,
+        *,
+        strict: bool | None = None,
+        from_attributes: bool | None = None,
+        context: dict[str, Any] | None = None,
+        self_instance: Any | None = None,
+    ) -> None:
+        """Callback to be notified of validation start, and create an instance of the event handler.
+
+        Args:
+            input: The input to be validated.
+            strict: Whether to validate the object in strict mode.
+            from_attributes: Whether to validate objects as inputs by extracting attributes.
+            context: The context to use for validation, this is passed to functional validators.
+            self_instance: An instance of a model to set attributes on from validation, this is used when running
+                validation from the `__init__` method of a model.
+        """
+        pass
+
+
+class ValidateJsonHandlerProtocol(BaseValidateHandlerProtocol, Protocol):
+    """Event handler for `SchemaValidator.validate_json`."""
+
+    def on_enter(
+        self,
+        input: str | bytes | bytearray,
+        *,
+        strict: bool | None = None,
+        context: dict[str, Any] | None = None,
+        self_instance: Any | None = None,
+    ) -> None:
+        """Callback to be notified of validation start, and create an instance of the event handler.
+
+        Args:
+            input: The JSON data to be validated.
+            strict: Whether to validate the object in strict mode.
+            context: The context to use for validation, this is passed to functional validators.
+            self_instance: An instance of a model to set attributes on from validation, this is used when running
+                validation from the `__init__` method of a model.
+        """
+        pass
+
+
+StringInput: TypeAlias = 'dict[str, StringInput]'
+
+
+class ValidateStringsHandlerProtocol(BaseValidateHandlerProtocol, Protocol):
+    """Event handler for `SchemaValidator.validate_strings`."""
+
+    def on_enter(
+        self, input: StringInput, *, strict: bool | None = None, context: dict[str, Any] | None = None
+    ) -> None:
+        """Callback to be notified of validation start, and create an instance of the event handler.
+
+        Args:
+            input: The string data to be validated.
+            strict: Whether to validate the object in strict mode.
+            context: The context to use for validation, this is passed to functional validators.
+        """
+        pass
diff --git a/lib/pydantic/plugin/_loader.py b/lib/pydantic/plugin/_loader.py
new file mode 100644
index 00000000..9e0e33ca
--- /dev/null
+++ b/lib/pydantic/plugin/_loader.py
@@ -0,0 +1,50 @@
+from __future__ import annotations
+
+import importlib.metadata as importlib_metadata
+import warnings
+from typing import TYPE_CHECKING, Final, Iterable
+
+if TYPE_CHECKING:
+    from . import PydanticPluginProtocol
+
+
+PYDANTIC_ENTRY_POINT_GROUP: Final[str] = 'pydantic'
+
+# cache of plugins
+_plugins: dict[str, PydanticPluginProtocol] | None = None
+# return no plugins while loading plugins to avoid recursion and errors while import plugins
+# this means that if plugins use pydantic
+_loading_plugins: bool = False
+
+
+def get_plugins() -> Iterable[PydanticPluginProtocol]:
+    """Load plugins for Pydantic.
+
+    Inspired by: https://github.com/pytest-dev/pluggy/blob/1.3.0/src/pluggy/_manager.py#L376-L402
+    """
+    global _plugins, _loading_plugins
+    if _loading_plugins:
+        # this happens when plugins themselves use pydantic, we return no plugins
+        return ()
+    elif _plugins is None:
+        _plugins = {}
+        # set _loading_plugins so any plugins that use pydantic don't themselves use plugins
+        _loading_plugins = True
+        try:
+            for dist in importlib_metadata.distributions():
+                for entry_point in dist.entry_points:
+                    if entry_point.group != PYDANTIC_ENTRY_POINT_GROUP:
+                        continue
+                    if entry_point.value in _plugins:
+                        continue
+                    try:
+                        _plugins[entry_point.value] = entry_point.load()
+                    except (ImportError, AttributeError) as e:
+                        warnings.warn(
+                            f'{e.__class__.__name__} while loading the `{entry_point.name}` Pydantic plugin, '
+                            f'this plugin will not be installed.\n\n{e!r}'
+                        )
+        finally:
+            _loading_plugins = False
+
+    return _plugins.values()
diff --git a/lib/pydantic/plugin/_schema_validator.py b/lib/pydantic/plugin/_schema_validator.py
new file mode 100644
index 00000000..7186ece6
--- /dev/null
+++ b/lib/pydantic/plugin/_schema_validator.py
@@ -0,0 +1,138 @@
+"""Pluggable schema validator for pydantic."""
+from __future__ import annotations
+
+import functools
+from typing import TYPE_CHECKING, Any, Callable, Iterable, TypeVar
+
+from pydantic_core import CoreConfig, CoreSchema, SchemaValidator, ValidationError
+from typing_extensions import Literal, ParamSpec
+
+if TYPE_CHECKING:
+    from . import BaseValidateHandlerProtocol, PydanticPluginProtocol, SchemaKind, SchemaTypePath
+
+
+P = ParamSpec('P')
+R = TypeVar('R')
+Event = Literal['on_validate_python', 'on_validate_json', 'on_validate_strings']
+events: list[Event] = list(Event.__args__)  # type: ignore
+
+
+def create_schema_validator(
+    schema: CoreSchema,
+    schema_type: Any,
+    schema_type_module: str,
+    schema_type_name: str,
+    schema_kind: SchemaKind,
+    config: CoreConfig | None = None,
+    plugin_settings: dict[str, Any] | None = None,
+) -> SchemaValidator:
+    """Create a `SchemaValidator` or `PluggableSchemaValidator` if plugins are installed.
+
+    Returns:
+        If plugins are installed then return `PluggableSchemaValidator`, otherwise return `SchemaValidator`.
+    """
+    from . import SchemaTypePath
+    from ._loader import get_plugins
+
+    plugins = get_plugins()
+    if plugins:
+        return PluggableSchemaValidator(
+            schema,
+            schema_type,
+            SchemaTypePath(schema_type_module, schema_type_name),
+            schema_kind,
+            config,
+            plugins,
+            plugin_settings or {},
+        )  # type: ignore
+    else:
+        return SchemaValidator(schema, config)
+
+
+class PluggableSchemaValidator:
+    """Pluggable schema validator."""
+
+    __slots__ = '_schema_validator', 'validate_json', 'validate_python', 'validate_strings'
+
+    def __init__(
+        self,
+        schema: CoreSchema,
+        schema_type: Any,
+        schema_type_path: SchemaTypePath,
+        schema_kind: SchemaKind,
+        config: CoreConfig | None,
+        plugins: Iterable[PydanticPluginProtocol],
+        plugin_settings: dict[str, Any],
+    ) -> None:
+        self._schema_validator = SchemaValidator(schema, config)
+
+        python_event_handlers: list[BaseValidateHandlerProtocol] = []
+        json_event_handlers: list[BaseValidateHandlerProtocol] = []
+        strings_event_handlers: list[BaseValidateHandlerProtocol] = []
+        for plugin in plugins:
+            try:
+                p, j, s = plugin.new_schema_validator(
+                    schema, schema_type, schema_type_path, schema_kind, config, plugin_settings
+                )
+            except TypeError as e:  # pragma: no cover
+                raise TypeError(f'Error using plugin `{plugin.__module__}:{plugin.__class__.__name__}`: {e}') from e
+            if p is not None:
+                python_event_handlers.append(p)
+            if j is not None:
+                json_event_handlers.append(j)
+            if s is not None:
+                strings_event_handlers.append(s)
+
+        self.validate_python = build_wrapper(self._schema_validator.validate_python, python_event_handlers)
+        self.validate_json = build_wrapper(self._schema_validator.validate_json, json_event_handlers)
+        self.validate_strings = build_wrapper(self._schema_validator.validate_strings, strings_event_handlers)
+
+    def __getattr__(self, name: str) -> Any:
+        return getattr(self._schema_validator, name)
+
+
+def build_wrapper(func: Callable[P, R], event_handlers: list[BaseValidateHandlerProtocol]) -> Callable[P, R]:
+    if not event_handlers:
+        return func
+    else:
+        on_enters = tuple(h.on_enter for h in event_handlers if filter_handlers(h, 'on_enter'))
+        on_successes = tuple(h.on_success for h in event_handlers if filter_handlers(h, 'on_success'))
+        on_errors = tuple(h.on_error for h in event_handlers if filter_handlers(h, 'on_error'))
+        on_exceptions = tuple(h.on_exception for h in event_handlers if filter_handlers(h, 'on_exception'))
+
+        @functools.wraps(func)
+        def wrapper(*args: P.args, **kwargs: P.kwargs) -> R:
+            for on_enter_handler in on_enters:
+                on_enter_handler(*args, **kwargs)
+
+            try:
+                result = func(*args, **kwargs)
+            except ValidationError as error:
+                for on_error_handler in on_errors:
+                    on_error_handler(error)
+                raise
+            except Exception as exception:
+                for on_exception_handler in on_exceptions:
+                    on_exception_handler(exception)
+                raise
+            else:
+                for on_success_handler in on_successes:
+                    on_success_handler(result)
+                return result
+
+        return wrapper
+
+
+def filter_handlers(handler_cls: BaseValidateHandlerProtocol, method_name: str) -> bool:
+    """Filter out handler methods which are not implemented by the plugin directly - e.g. are missing
+    or are inherited from the protocol.
+    """
+    handler = getattr(handler_cls, method_name, None)
+    if handler is None:
+        return False
+    elif handler.__module__ == 'pydantic.plugin':
+        # this is the original handler, from the protocol due to runtime inheritance
+        # we don't want to call it
+        return False
+    else:
+        return True
diff --git a/lib/pydantic/root_model.py b/lib/pydantic/root_model.py
new file mode 100644
index 00000000..42186b9d
--- /dev/null
+++ b/lib/pydantic/root_model.py
@@ -0,0 +1,149 @@
+"""RootModel class and type definitions."""
+
+from __future__ import annotations as _annotations
+
+import typing
+from copy import copy, deepcopy
+
+from pydantic_core import PydanticUndefined
+
+from . import PydanticUserError
+from ._internal import _model_construction, _repr
+from .main import BaseModel, _object_setattr
+
+if typing.TYPE_CHECKING:
+    from typing import Any
+
+    from typing_extensions import Literal, dataclass_transform
+
+    from .fields import Field as PydanticModelField
+
+    # dataclass_transform could be applied to RootModel directly, but `ModelMetaclass`'s dataclass_transform
+    # takes priority (at least with pyright). We trick type checkers into thinking we apply dataclass_transform
+    # on a new metaclass.
+    @dataclass_transform(kw_only_default=False, field_specifiers=(PydanticModelField,))
+    class _RootModelMetaclass(_model_construction.ModelMetaclass):
+        ...
+
+    Model = typing.TypeVar('Model', bound='BaseModel')
+else:
+    _RootModelMetaclass = _model_construction.ModelMetaclass
+
+__all__ = ('RootModel',)
+
+
+RootModelRootType = typing.TypeVar('RootModelRootType')
+
+
+class RootModel(BaseModel, typing.Generic[RootModelRootType], metaclass=_RootModelMetaclass):
+    """Usage docs: https://docs.pydantic.dev/2.6/concepts/models/#rootmodel-and-custom-root-types
+
+    A Pydantic `BaseModel` for the root object of the model.
+
+    Attributes:
+        root: The root object of the model.
+        __pydantic_root_model__: Whether the model is a RootModel.
+        __pydantic_private__: Private fields in the model.
+        __pydantic_extra__: Extra fields in the model.
+
+    """
+
+    __pydantic_root_model__ = True
+    __pydantic_private__ = None
+    __pydantic_extra__ = None
+
+    root: RootModelRootType
+
+    def __init_subclass__(cls, **kwargs):
+        extra = cls.model_config.get('extra')
+        if extra is not None:
+            raise PydanticUserError(
+                "`RootModel` does not support setting `model_config['extra']`", code='root-model-extra'
+            )
+        super().__init_subclass__(**kwargs)
+
+    def __init__(self, /, root: RootModelRootType = PydanticUndefined, **data) -> None:  # type: ignore
+        __tracebackhide__ = True
+        if data:
+            if root is not PydanticUndefined:
+                raise ValueError(
+                    '"RootModel.__init__" accepts either a single positional argument or arbitrary keyword arguments'
+                )
+            root = data  # type: ignore
+        self.__pydantic_validator__.validate_python(root, self_instance=self)
+
+    __init__.__pydantic_base_init__ = True  # pyright: ignore[reportFunctionMemberAccess]
+
+    @classmethod
+    def model_construct(cls: type[Model], root: RootModelRootType, _fields_set: set[str] | None = None) -> Model:  # type: ignore
+        """Create a new model using the provided root object and update fields set.
+
+        Args:
+            root: The root object of the model.
+            _fields_set: The set of fields to be updated.
+
+        Returns:
+            The new model.
+
+        Raises:
+            NotImplemented: If the model is not a subclass of `RootModel`.
+        """
+        return super().model_construct(root=root, _fields_set=_fields_set)
+
+    def __getstate__(self) -> dict[Any, Any]:
+        return {
+            '__dict__': self.__dict__,
+            '__pydantic_fields_set__': self.__pydantic_fields_set__,
+        }
+
+    def __setstate__(self, state: dict[Any, Any]) -> None:
+        _object_setattr(self, '__pydantic_fields_set__', state['__pydantic_fields_set__'])
+        _object_setattr(self, '__dict__', state['__dict__'])
+
+    def __copy__(self: Model) -> Model:
+        """Returns a shallow copy of the model."""
+        cls = type(self)
+        m = cls.__new__(cls)
+        _object_setattr(m, '__dict__', copy(self.__dict__))
+        _object_setattr(m, '__pydantic_fields_set__', copy(self.__pydantic_fields_set__))
+        return m
+
+    def __deepcopy__(self: Model, memo: dict[int, Any] | None = None) -> Model:
+        """Returns a deep copy of the model."""
+        cls = type(self)
+        m = cls.__new__(cls)
+        _object_setattr(m, '__dict__', deepcopy(self.__dict__, memo=memo))
+        # This next line doesn't need a deepcopy because __pydantic_fields_set__ is a set[str],
+        # and attempting a deepcopy would be marginally slower.
+        _object_setattr(m, '__pydantic_fields_set__', copy(self.__pydantic_fields_set__))
+        return m
+
+    if typing.TYPE_CHECKING:
+
+        def model_dump(  # type: ignore
+            self,
+            *,
+            mode: Literal['json', 'python'] | str = 'python',
+            include: Any = None,
+            exclude: Any = None,
+            by_alias: bool = False,
+            exclude_unset: bool = False,
+            exclude_defaults: bool = False,
+            exclude_none: bool = False,
+            round_trip: bool = False,
+            warnings: bool = True,
+        ) -> RootModelRootType:
+            """This method is included just to get a more accurate return type for type checkers.
+            It is included in this `if TYPE_CHECKING:` block since no override is actually necessary.
+
+            See the documentation of `BaseModel.model_dump` for more details about the arguments.
+            """
+            ...
+
+    def __eq__(self, other: Any) -> bool:
+        if not isinstance(other, RootModel):
+            return NotImplemented
+        return self.model_fields['root'].annotation == other.model_fields['root'].annotation and super().__eq__(other)
+
+    def __repr_args__(self) -> _repr.ReprArgs:
+        yield 'root', self.root
diff --git a/lib/pydantic/schema.py b/lib/pydantic/schema.py
index e7af56f1..e290aed9 100644
--- a/lib/pydantic/schema.py
+++ b/lib/pydantic/schema.py
@@ -1,1153 +1,4 @@
-import re
-import warnings
-from collections import defaultdict
-from datetime import date, datetime, time, timedelta
-from decimal import Decimal
-from enum import Enum
-from ipaddress import IPv4Address, IPv4Interface, IPv4Network, IPv6Address, IPv6Interface, IPv6Network
-from pathlib import Path
-from typing import (
-    TYPE_CHECKING,
-    Any,
-    Callable,
-    Dict,
-    ForwardRef,
-    FrozenSet,
-    Generic,
-    Iterable,
-    List,
-    Optional,
-    Pattern,
-    Sequence,
-    Set,
-    Tuple,
-    Type,
-    TypeVar,
-    Union,
-    cast,
-)
-from uuid import UUID
+"""The `schema` module is a backport module from V1."""
+from ._migration import getattr_migration
 
-from typing_extensions import Annotated, Literal
-
-from .fields import (
-    MAPPING_LIKE_SHAPES,
-    SHAPE_DEQUE,
-    SHAPE_FROZENSET,
-    SHAPE_GENERIC,
-    SHAPE_ITERABLE,
-    SHAPE_LIST,
-    SHAPE_SEQUENCE,
-    SHAPE_SET,
-    SHAPE_SINGLETON,
-    SHAPE_TUPLE,
-    SHAPE_TUPLE_ELLIPSIS,
-    FieldInfo,
-    ModelField,
-)
-from .json import pydantic_encoder
-from .networks import AnyUrl, EmailStr
-from .types import (
-    ConstrainedDecimal,
-    ConstrainedFloat,
-    ConstrainedFrozenSet,
-    ConstrainedInt,
-    ConstrainedList,
-    ConstrainedSet,
-    SecretBytes,
-    SecretStr,
-    StrictBytes,
-    StrictStr,
-    conbytes,
-    condecimal,
-    confloat,
-    confrozenset,
-    conint,
-    conlist,
-    conset,
-    constr,
-)
-from .typing import (
-    all_literal_values,
-    get_args,
-    get_origin,
-    get_sub_types,
-    is_callable_type,
-    is_literal_type,
-    is_namedtuple,
-    is_none_type,
-    is_union,
-)
-from .utils import ROOT_KEY, get_model, lenient_issubclass
-
-if TYPE_CHECKING:
-    from .dataclasses import Dataclass
-    from .main import BaseModel
-
-default_prefix = '#/definitions/'
-default_ref_template = '#/definitions/{model}'
-
-TypeModelOrEnum = Union[Type['BaseModel'], Type[Enum]]
-TypeModelSet = Set[TypeModelOrEnum]
-
-
-def _apply_modify_schema(
-    modify_schema: Callable[..., None], field: Optional[ModelField], field_schema: Dict[str, Any]
-) -> None:
-    from inspect import signature
-
-    sig = signature(modify_schema)
-    args = set(sig.parameters.keys())
-    if 'field' in args or 'kwargs' in args:
-        modify_schema(field_schema, field=field)
-    else:
-        modify_schema(field_schema)
-
-
-def schema(
-    models: Sequence[Union[Type['BaseModel'], Type['Dataclass']]],
-    *,
-    by_alias: bool = True,
-    title: Optional[str] = None,
-    description: Optional[str] = None,
-    ref_prefix: Optional[str] = None,
-    ref_template: str = default_ref_template,
-) -> Dict[str, Any]:
-    """
-    Process a list of models and generate a single JSON Schema with all of them defined in the ``definitions``
-    top-level JSON key, including their sub-models.
-
-    :param models: a list of models to include in the generated JSON Schema
-    :param by_alias: generate the schemas using the aliases defined, if any
-    :param title: title for the generated schema that includes the definitions
-    :param description: description for the generated schema
-    :param ref_prefix: the JSON Pointer prefix for schema references with ``$ref``, if None, will be set to the
-      default of ``#/definitions/``. Update it if you want the schemas to reference the definitions somewhere
-      else, e.g. for OpenAPI use ``#/components/schemas/``. The resulting generated schemas will still be at the
-      top-level key ``definitions``, so you can extract them from there. But all the references will have the set
-      prefix.
-    :param ref_template: Use a ``string.format()`` template for ``$ref`` instead of a prefix. This can be useful
-      for references that cannot be represented by ``ref_prefix`` such as a definition stored in another file. For
-      a sibling json file in a ``/schemas`` directory use ``"/schemas/${model}.json#"``.
-    :return: dict with the JSON Schema with a ``definitions`` top-level key including the schema definitions for
-      the models and sub-models passed in ``models``.
-    """
-    clean_models = [get_model(model) for model in models]
-    flat_models = get_flat_models_from_models(clean_models)
-    model_name_map = get_model_name_map(flat_models)
-    definitions = {}
-    output_schema: Dict[str, Any] = {}
-    if title:
-        output_schema['title'] = title
-    if description:
-        output_schema['description'] = description
-    for model in clean_models:
-        m_schema, m_definitions, m_nested_models = model_process_schema(
-            model,
-            by_alias=by_alias,
-            model_name_map=model_name_map,
-            ref_prefix=ref_prefix,
-            ref_template=ref_template,
-        )
-        definitions.update(m_definitions)
-        model_name = model_name_map[model]
-        definitions[model_name] = m_schema
-    if definitions:
-        output_schema['definitions'] = definitions
-    return output_schema
-
-
-def model_schema(
-    model: Union[Type['BaseModel'], Type['Dataclass']],
-    by_alias: bool = True,
-    ref_prefix: Optional[str] = None,
-    ref_template: str = default_ref_template,
-) -> Dict[str, Any]:
-    """
-    Generate a JSON Schema for one model. With all the sub-models defined in the ``definitions`` top-level
-    JSON key.
-
-    :param model: a Pydantic model (a class that inherits from BaseModel)
-    :param by_alias: generate the schemas using the aliases defined, if any
-    :param ref_prefix: the JSON Pointer prefix for schema references with ``$ref``, if None, will be set to the
-      default of ``#/definitions/``. Update it if you want the schemas to reference the definitions somewhere
-      else, e.g. for OpenAPI use ``#/components/schemas/``. The resulting generated schemas will still be at the
-      top-level key ``definitions``, so you can extract them from there. But all the references will have the set
-      prefix.
-    :param ref_template: Use a ``string.format()`` template for ``$ref`` instead of a prefix. This can be useful for
-      references that cannot be represented by ``ref_prefix`` such as a definition stored in another file. For a
-      sibling json file in a ``/schemas`` directory use ``"/schemas/${model}.json#"``.
-    :return: dict with the JSON Schema for the passed ``model``
-    """
-    model = get_model(model)
-    flat_models = get_flat_models_from_model(model)
-    model_name_map = get_model_name_map(flat_models)
-    model_name = model_name_map[model]
-    m_schema, m_definitions, nested_models = model_process_schema(
-        model, by_alias=by_alias, model_name_map=model_name_map, ref_prefix=ref_prefix, ref_template=ref_template
-    )
-    if model_name in nested_models:
-        # model_name is in Nested models, it has circular references
-        m_definitions[model_name] = m_schema
-        m_schema = get_schema_ref(model_name, ref_prefix, ref_template, False)
-    if m_definitions:
-        m_schema.update({'definitions': m_definitions})
-    return m_schema
-
-
-def get_field_info_schema(field: ModelField, schema_overrides: bool = False) -> Tuple[Dict[str, Any], bool]:
-
-    # If no title is explicitly set, we don't set title in the schema for enums.
-    # The behaviour is the same as `BaseModel` reference, where the default title
-    # is in the definitions part of the schema.
-    schema_: Dict[str, Any] = {}
-    if field.field_info.title or not lenient_issubclass(field.type_, Enum):
-        schema_['title'] = field.field_info.title or field.alias.title().replace('_', ' ')
-
-    if field.field_info.title:
-        schema_overrides = True
-
-    if field.field_info.description:
-        schema_['description'] = field.field_info.description
-        schema_overrides = True
-
-    if not field.required and field.default is not None and not is_callable_type(field.outer_type_):
-        schema_['default'] = encode_default(field.default)
-        schema_overrides = True
-
-    return schema_, schema_overrides
-
-
-def field_schema(
-    field: ModelField,
-    *,
-    by_alias: bool = True,
-    model_name_map: Dict[TypeModelOrEnum, str],
-    ref_prefix: Optional[str] = None,
-    ref_template: str = default_ref_template,
-    known_models: TypeModelSet = None,
-) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]:
-    """
-    Process a Pydantic field and return a tuple with a JSON Schema for it as the first item.
-    Also return a dictionary of definitions with models as keys and their schemas as values. If the passed field
-    is a model and has sub-models, and those sub-models don't have overrides (as ``title``, ``default``, etc), they
-    will be included in the definitions and referenced in the schema instead of included recursively.
-
-    :param field: a Pydantic ``ModelField``
-    :param by_alias: use the defined alias (if any) in the returned schema
-    :param model_name_map: used to generate the JSON Schema references to other models included in the definitions
-    :param ref_prefix: the JSON Pointer prefix to use for references to other schemas, if None, the default of
-      #/definitions/ will be used
-    :param ref_template: Use a ``string.format()`` template for ``$ref`` instead of a prefix. This can be useful for
-      references that cannot be represented by ``ref_prefix`` such as a definition stored in another file. For a
-      sibling json file in a ``/schemas`` directory use ``"/schemas/${model}.json#"``.
-    :param known_models: used to solve circular references
-    :return: tuple of the schema for this field and additional definitions
-    """
-    s, schema_overrides = get_field_info_schema(field)
-
-    validation_schema = get_field_schema_validations(field)
-    if validation_schema:
-        s.update(validation_schema)
-        schema_overrides = True
-
-    f_schema, f_definitions, f_nested_models = field_type_schema(
-        field,
-        by_alias=by_alias,
-        model_name_map=model_name_map,
-        schema_overrides=schema_overrides,
-        ref_prefix=ref_prefix,
-        ref_template=ref_template,
-        known_models=known_models or set(),
-    )
-
-    # $ref will only be returned when there are no schema_overrides
-    if '$ref' in f_schema:
-        return f_schema, f_definitions, f_nested_models
-    else:
-        s.update(f_schema)
-        return s, f_definitions, f_nested_models
-
-
-numeric_types = (int, float, Decimal)
-_str_types_attrs: Tuple[Tuple[str, Union[type, Tuple[type, ...]], str], ...] = (
-    ('max_length', numeric_types, 'maxLength'),
-    ('min_length', numeric_types, 'minLength'),
-    ('regex', str, 'pattern'),
-)
-
-_numeric_types_attrs: Tuple[Tuple[str, Union[type, Tuple[type, ...]], str], ...] = (
-    ('gt', numeric_types, 'exclusiveMinimum'),
-    ('lt', numeric_types, 'exclusiveMaximum'),
-    ('ge', numeric_types, 'minimum'),
-    ('le', numeric_types, 'maximum'),
-    ('multiple_of', numeric_types, 'multipleOf'),
-)
-
-
-def get_field_schema_validations(field: ModelField) -> Dict[str, Any]:
-    """
-    Get the JSON Schema validation keywords for a ``field`` with an annotation of
-    a Pydantic ``FieldInfo`` with validation arguments.
-    """
-    f_schema: Dict[str, Any] = {}
-
-    if lenient_issubclass(field.type_, Enum):
-        # schema is already updated by `enum_process_schema`; just update with field extra
-        if field.field_info.extra:
-            f_schema.update(field.field_info.extra)
-        return f_schema
-
-    if lenient_issubclass(field.type_, (str, bytes)):
-        for attr_name, t, keyword in _str_types_attrs:
-            attr = getattr(field.field_info, attr_name, None)
-            if isinstance(attr, t):
-                f_schema[keyword] = attr
-    if lenient_issubclass(field.type_, numeric_types) and not issubclass(field.type_, bool):
-        for attr_name, t, keyword in _numeric_types_attrs:
-            attr = getattr(field.field_info, attr_name, None)
-            if isinstance(attr, t):
-                f_schema[keyword] = attr
-    if field.field_info is not None and field.field_info.const:
-        f_schema['const'] = field.default
-    if field.field_info.extra:
-        f_schema.update(field.field_info.extra)
-    modify_schema = getattr(field.outer_type_, '__modify_schema__', None)
-    if modify_schema:
-        _apply_modify_schema(modify_schema, field, f_schema)
-    return f_schema
-
-
-def get_model_name_map(unique_models: TypeModelSet) -> Dict[TypeModelOrEnum, str]:
-    """
-    Process a set of models and generate unique names for them to be used as keys in the JSON Schema
-    definitions. By default the names are the same as the class name. But if two models in different Python
-    modules have the same name (e.g. "users.Model" and "items.Model"), the generated names will be
-    based on the Python module path for those conflicting models to prevent name collisions.
-
-    :param unique_models: a Python set of models
-    :return: dict mapping models to names
-    """
-    name_model_map = {}
-    conflicting_names: Set[str] = set()
-    for model in unique_models:
-        model_name = normalize_name(model.__name__)
-        if model_name in conflicting_names:
-            model_name = get_long_model_name(model)
-            name_model_map[model_name] = model
-        elif model_name in name_model_map:
-            conflicting_names.add(model_name)
-            conflicting_model = name_model_map.pop(model_name)
-            name_model_map[get_long_model_name(conflicting_model)] = conflicting_model
-            name_model_map[get_long_model_name(model)] = model
-        else:
-            name_model_map[model_name] = model
-    return {v: k for k, v in name_model_map.items()}
-
-
-def get_flat_models_from_model(model: Type['BaseModel'], known_models: TypeModelSet = None) -> TypeModelSet:
-    """
-    Take a single ``model`` and generate a set with itself and all the sub-models in the tree. I.e. if you pass
-    model ``Foo`` (subclass of Pydantic ``BaseModel``) as ``model``, and it has a field of type ``Bar`` (also
-    subclass of ``BaseModel``) and that model ``Bar`` has a field of type ``Baz`` (also subclass of ``BaseModel``),
-    the return value will be ``set([Foo, Bar, Baz])``.
-
-    :param model: a Pydantic ``BaseModel`` subclass
-    :param known_models: used to solve circular references
-    :return: a set with the initial model and all its sub-models
-    """
-    known_models = known_models or set()
-    flat_models: TypeModelSet = set()
-    flat_models.add(model)
-    known_models |= flat_models
-    fields = cast(Sequence[ModelField], model.__fields__.values())
-    flat_models |= get_flat_models_from_fields(fields, known_models=known_models)
-    return flat_models
-
-
-def get_flat_models_from_field(field: ModelField, known_models: TypeModelSet) -> TypeModelSet:
-    """
-    Take a single Pydantic ``ModelField`` (from a model) that could have been declared as a sublcass of BaseModel
-    (so, it could be a submodel), and generate a set with its model and all the sub-models in the tree.
-    I.e. if you pass a field that was declared to be of type ``Foo`` (subclass of BaseModel) as ``field``, and that
-    model ``Foo`` has a field of type ``Bar`` (also subclass of ``BaseModel``) and that model ``Bar`` has a field of
-    type ``Baz`` (also subclass of ``BaseModel``), the return value will be ``set([Foo, Bar, Baz])``.
-
-    :param field: a Pydantic ``ModelField``
-    :param known_models: used to solve circular references
-    :return: a set with the model used in the declaration for this field, if any, and all its sub-models
-    """
-    from .main import BaseModel
-
-    flat_models: TypeModelSet = set()
-
-    field_type = field.type_
-    if lenient_issubclass(getattr(field_type, '__pydantic_model__', None), BaseModel):
-        field_type = field_type.__pydantic_model__
-
-    if field.sub_fields and not lenient_issubclass(field_type, BaseModel):
-        flat_models |= get_flat_models_from_fields(field.sub_fields, known_models=known_models)
-    elif lenient_issubclass(field_type, BaseModel) and field_type not in known_models:
-        flat_models |= get_flat_models_from_model(field_type, known_models=known_models)
-    elif lenient_issubclass(field_type, Enum):
-        flat_models.add(field_type)
-    return flat_models
-
-
-def get_flat_models_from_fields(fields: Sequence[ModelField], known_models: TypeModelSet) -> TypeModelSet:
-    """
-    Take a list of Pydantic  ``ModelField``s (from a model) that could have been declared as subclasses of ``BaseModel``
-    (so, any of them could be a submodel), and generate a set with their models and all the sub-models in the tree.
-    I.e. if you pass a the fields of a model ``Foo`` (subclass of ``BaseModel``) as ``fields``, and on of them has a
-    field of type ``Bar`` (also subclass of ``BaseModel``) and that model ``Bar`` has a field of type ``Baz`` (also
-    subclass of ``BaseModel``), the return value will be ``set([Foo, Bar, Baz])``.
-
-    :param fields: a list of Pydantic ``ModelField``s
-    :param known_models: used to solve circular references
-    :return: a set with any model declared in the fields, and all their sub-models
-    """
-    flat_models: TypeModelSet = set()
-    for field in fields:
-        flat_models |= get_flat_models_from_field(field, known_models=known_models)
-    return flat_models
-
-
-def get_flat_models_from_models(models: Sequence[Type['BaseModel']]) -> TypeModelSet:
-    """
-    Take a list of ``models`` and generate a set with them and all their sub-models in their trees. I.e. if you pass
-    a list of two models, ``Foo`` and ``Bar``, both subclasses of Pydantic ``BaseModel`` as models, and ``Bar`` has
-    a field of type ``Baz`` (also subclass of ``BaseModel``), the return value will be ``set([Foo, Bar, Baz])``.
-    """
-    flat_models: TypeModelSet = set()
-    for model in models:
-        flat_models |= get_flat_models_from_model(model)
-    return flat_models
-
-
-def get_long_model_name(model: TypeModelOrEnum) -> str:
-    return f'{model.__module__}__{model.__qualname__}'.replace('.', '__')
-
-
-def field_type_schema(
-    field: ModelField,
-    *,
-    by_alias: bool,
-    model_name_map: Dict[TypeModelOrEnum, str],
-    ref_template: str,
-    schema_overrides: bool = False,
-    ref_prefix: Optional[str] = None,
-    known_models: TypeModelSet,
-) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]:
-    """
-    Used by ``field_schema()``, you probably should be using that function.
-
-    Take a single ``field`` and generate the schema for its type only, not including additional
-    information as title, etc. Also return additional schema definitions, from sub-models.
-    """
-    from .main import BaseModel  # noqa: F811
-
-    definitions = {}
-    nested_models: Set[str] = set()
-    f_schema: Dict[str, Any]
-    if field.shape in {
-        SHAPE_LIST,
-        SHAPE_TUPLE_ELLIPSIS,
-        SHAPE_SEQUENCE,
-        SHAPE_SET,
-        SHAPE_FROZENSET,
-        SHAPE_ITERABLE,
-        SHAPE_DEQUE,
-    }:
-        items_schema, f_definitions, f_nested_models = field_singleton_schema(
-            field,
-            by_alias=by_alias,
-            model_name_map=model_name_map,
-            ref_prefix=ref_prefix,
-            ref_template=ref_template,
-            known_models=known_models,
-        )
-        definitions.update(f_definitions)
-        nested_models.update(f_nested_models)
-        f_schema = {'type': 'array', 'items': items_schema}
-        if field.shape in {SHAPE_SET, SHAPE_FROZENSET}:
-            f_schema['uniqueItems'] = True
-
-    elif field.shape in MAPPING_LIKE_SHAPES:
-        f_schema = {'type': 'object'}
-        key_field = cast(ModelField, field.key_field)
-        regex = getattr(key_field.type_, 'regex', None)
-        items_schema, f_definitions, f_nested_models = field_singleton_schema(
-            field,
-            by_alias=by_alias,
-            model_name_map=model_name_map,
-            ref_prefix=ref_prefix,
-            ref_template=ref_template,
-            known_models=known_models,
-        )
-        definitions.update(f_definitions)
-        nested_models.update(f_nested_models)
-        if regex:
-            # Dict keys have a regex pattern
-            # items_schema might be a schema or empty dict, add it either way
-            f_schema['patternProperties'] = {regex.pattern: items_schema}
-        elif items_schema:
-            # The dict values are not simply Any, so they need a schema
-            f_schema['additionalProperties'] = items_schema
-    elif field.shape == SHAPE_TUPLE or (field.shape == SHAPE_GENERIC and not issubclass(field.type_, BaseModel)):
-        sub_schema = []
-        sub_fields = cast(List[ModelField], field.sub_fields)
-        for sf in sub_fields:
-            sf_schema, sf_definitions, sf_nested_models = field_type_schema(
-                sf,
-                by_alias=by_alias,
-                model_name_map=model_name_map,
-                ref_prefix=ref_prefix,
-                ref_template=ref_template,
-                known_models=known_models,
-            )
-            definitions.update(sf_definitions)
-            nested_models.update(sf_nested_models)
-            sub_schema.append(sf_schema)
-
-        sub_fields_len = len(sub_fields)
-        if field.shape == SHAPE_GENERIC:
-            all_of_schemas = sub_schema[0] if sub_fields_len == 1 else {'type': 'array', 'items': sub_schema}
-            f_schema = {'allOf': [all_of_schemas]}
-        else:
-            f_schema = {
-                'type': 'array',
-                'minItems': sub_fields_len,
-                'maxItems': sub_fields_len,
-            }
-            if sub_fields_len >= 1:
-                f_schema['items'] = sub_schema
-    else:
-        assert field.shape in {SHAPE_SINGLETON, SHAPE_GENERIC}, field.shape
-        f_schema, f_definitions, f_nested_models = field_singleton_schema(
-            field,
-            by_alias=by_alias,
-            model_name_map=model_name_map,
-            schema_overrides=schema_overrides,
-            ref_prefix=ref_prefix,
-            ref_template=ref_template,
-            known_models=known_models,
-        )
-        definitions.update(f_definitions)
-        nested_models.update(f_nested_models)
-
-    # check field type to avoid repeated calls to the same __modify_schema__ method
-    if field.type_ != field.outer_type_:
-        if field.shape == SHAPE_GENERIC:
-            field_type = field.type_
-        else:
-            field_type = field.outer_type_
-        modify_schema = getattr(field_type, '__modify_schema__', None)
-        if modify_schema:
-            _apply_modify_schema(modify_schema, field, f_schema)
-    return f_schema, definitions, nested_models
-
-
-def model_process_schema(
-    model: TypeModelOrEnum,
-    *,
-    by_alias: bool = True,
-    model_name_map: Dict[TypeModelOrEnum, str],
-    ref_prefix: Optional[str] = None,
-    ref_template: str = default_ref_template,
-    known_models: TypeModelSet = None,
-    field: Optional[ModelField] = None,
-) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]:
-    """
-    Used by ``model_schema()``, you probably should be using that function.
-
-    Take a single ``model`` and generate its schema. Also return additional schema definitions, from sub-models. The
-    sub-models of the returned schema will be referenced, but their definitions will not be included in the schema. All
-    the definitions are returned as the second value.
-    """
-    from inspect import getdoc, signature
-
-    known_models = known_models or set()
-    if lenient_issubclass(model, Enum):
-        model = cast(Type[Enum], model)
-        s = enum_process_schema(model, field=field)
-        return s, {}, set()
-    model = cast(Type['BaseModel'], model)
-    s = {'title': model.__config__.title or model.__name__}
-    doc = getdoc(model)
-    if doc:
-        s['description'] = doc
-    known_models.add(model)
-    m_schema, m_definitions, nested_models = model_type_schema(
-        model,
-        by_alias=by_alias,
-        model_name_map=model_name_map,
-        ref_prefix=ref_prefix,
-        ref_template=ref_template,
-        known_models=known_models,
-    )
-    s.update(m_schema)
-    schema_extra = model.__config__.schema_extra
-    if callable(schema_extra):
-        if len(signature(schema_extra).parameters) == 1:
-            schema_extra(s)
-        else:
-            schema_extra(s, model)
-    else:
-        s.update(schema_extra)
-    return s, m_definitions, nested_models
-
-
-def model_type_schema(
-    model: Type['BaseModel'],
-    *,
-    by_alias: bool,
-    model_name_map: Dict[TypeModelOrEnum, str],
-    ref_template: str,
-    ref_prefix: Optional[str] = None,
-    known_models: TypeModelSet,
-) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]:
-    """
-    You probably should be using ``model_schema()``, this function is indirectly used by that function.
-
-    Take a single ``model`` and generate the schema for its type only, not including additional
-    information as title, etc. Also return additional schema definitions, from sub-models.
-    """
-    properties = {}
-    required = []
-    definitions: Dict[str, Any] = {}
-    nested_models: Set[str] = set()
-    for k, f in model.__fields__.items():
-        try:
-            f_schema, f_definitions, f_nested_models = field_schema(
-                f,
-                by_alias=by_alias,
-                model_name_map=model_name_map,
-                ref_prefix=ref_prefix,
-                ref_template=ref_template,
-                known_models=known_models,
-            )
-        except SkipField as skip:
-            warnings.warn(skip.message, UserWarning)
-            continue
-        definitions.update(f_definitions)
-        nested_models.update(f_nested_models)
-        if by_alias:
-            properties[f.alias] = f_schema
-            if f.required:
-                required.append(f.alias)
-        else:
-            properties[k] = f_schema
-            if f.required:
-                required.append(k)
-    if ROOT_KEY in properties:
-        out_schema = properties[ROOT_KEY]
-        out_schema['title'] = model.__config__.title or model.__name__
-    else:
-        out_schema = {'type': 'object', 'properties': properties}
-        if required:
-            out_schema['required'] = required
-    if model.__config__.extra == 'forbid':
-        out_schema['additionalProperties'] = False
-    return out_schema, definitions, nested_models
-
-
-def enum_process_schema(enum: Type[Enum], *, field: Optional[ModelField] = None) -> Dict[str, Any]:
-    """
-    Take a single `enum` and generate its schema.
-
-    This is similar to the `model_process_schema` function, but applies to ``Enum`` objects.
-    """
-    schema_: Dict[str, Any] = {
-        'title': enum.__name__,
-        # Python assigns all enums a default docstring value of 'An enumeration', so
-        # all enums will have a description field even if not explicitly provided.
-        'description': enum.__doc__ or 'An enumeration.',
-        # Add enum values and the enum field type to the schema.
-        'enum': [item.value for item in cast(Iterable[Enum], enum)],
-    }
-
-    add_field_type_to_schema(enum, schema_)
-
-    modify_schema = getattr(enum, '__modify_schema__', None)
-    if modify_schema:
-        _apply_modify_schema(modify_schema, field, schema_)
-
-    return schema_
-
-
-def field_singleton_sub_fields_schema(
-    field: ModelField,
-    *,
-    by_alias: bool,
-    model_name_map: Dict[TypeModelOrEnum, str],
-    ref_template: str,
-    schema_overrides: bool = False,
-    ref_prefix: Optional[str] = None,
-    known_models: TypeModelSet,
-) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]:
-    """
-    This function is indirectly used by ``field_schema()``, you probably should be using that function.
-
-    Take a list of Pydantic ``ModelField`` from the declaration of a type with parameters, and generate their
-    schema. I.e., fields used as "type parameters", like ``str`` and ``int`` in ``Tuple[str, int]``.
-    """
-    sub_fields = cast(List[ModelField], field.sub_fields)
-    definitions = {}
-    nested_models: Set[str] = set()
-    if len(sub_fields) == 1:
-        return field_type_schema(
-            sub_fields[0],
-            by_alias=by_alias,
-            model_name_map=model_name_map,
-            schema_overrides=schema_overrides,
-            ref_prefix=ref_prefix,
-            ref_template=ref_template,
-            known_models=known_models,
-        )
-    else:
-        s: Dict[str, Any] = {}
-        # https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#discriminator-object
-        field_has_discriminator: bool = field.discriminator_key is not None
-        if field_has_discriminator:
-            assert field.sub_fields_mapping is not None
-
-            discriminator_models_refs: Dict[str, Union[str, Dict[str, Any]]] = {}
-
-            for discriminator_value, sub_field in field.sub_fields_mapping.items():
-                # sub_field is either a `BaseModel` or directly an `Annotated` `Union` of many
-                if is_union(get_origin(sub_field.type_)):
-                    sub_models = get_sub_types(sub_field.type_)
-                    discriminator_models_refs[discriminator_value] = {
-                        model_name_map[sub_model]: get_schema_ref(
-                            model_name_map[sub_model], ref_prefix, ref_template, False
-                        )
-                        for sub_model in sub_models
-                    }
-                else:
-                    sub_field_type = sub_field.type_
-                    if hasattr(sub_field_type, '__pydantic_model__'):
-                        sub_field_type = sub_field_type.__pydantic_model__
-
-                    discriminator_model_name = model_name_map[sub_field_type]
-                    discriminator_model_ref = get_schema_ref(discriminator_model_name, ref_prefix, ref_template, False)
-                    discriminator_models_refs[discriminator_value] = discriminator_model_ref['$ref']
-
-            s['discriminator'] = {
-                'propertyName': field.discriminator_alias,
-                'mapping': discriminator_models_refs,
-            }
-
-        sub_field_schemas = []
-        for sf in sub_fields:
-            sub_schema, sub_definitions, sub_nested_models = field_type_schema(
-                sf,
-                by_alias=by_alias,
-                model_name_map=model_name_map,
-                schema_overrides=schema_overrides,
-                ref_prefix=ref_prefix,
-                ref_template=ref_template,
-                known_models=known_models,
-            )
-            definitions.update(sub_definitions)
-            if schema_overrides and 'allOf' in sub_schema:
-                # if the sub_field is a referenced schema we only need the referenced
-                # object. Otherwise we will end up with several allOf inside anyOf/oneOf.
-                # See https://github.com/pydantic/pydantic/issues/1209
-                sub_schema = sub_schema['allOf'][0]
-
-            if sub_schema.keys() == {'discriminator', 'oneOf'}:
-                # we don't want discriminator information inside oneOf choices, this is dealt with elsewhere
-                sub_schema.pop('discriminator')
-            sub_field_schemas.append(sub_schema)
-            nested_models.update(sub_nested_models)
-        s['oneOf' if field_has_discriminator else 'anyOf'] = sub_field_schemas
-        return s, definitions, nested_models
-
-
-# Order is important, e.g. subclasses of str must go before str
-# this is used only for standard library types, custom types should use __modify_schema__ instead
-field_class_to_schema: Tuple[Tuple[Any, Dict[str, Any]], ...] = (
-    (Path, {'type': 'string', 'format': 'path'}),
-    (datetime, {'type': 'string', 'format': 'date-time'}),
-    (date, {'type': 'string', 'format': 'date'}),
-    (time, {'type': 'string', 'format': 'time'}),
-    (timedelta, {'type': 'number', 'format': 'time-delta'}),
-    (IPv4Network, {'type': 'string', 'format': 'ipv4network'}),
-    (IPv6Network, {'type': 'string', 'format': 'ipv6network'}),
-    (IPv4Interface, {'type': 'string', 'format': 'ipv4interface'}),
-    (IPv6Interface, {'type': 'string', 'format': 'ipv6interface'}),
-    (IPv4Address, {'type': 'string', 'format': 'ipv4'}),
-    (IPv6Address, {'type': 'string', 'format': 'ipv6'}),
-    (Pattern, {'type': 'string', 'format': 'regex'}),
-    (str, {'type': 'string'}),
-    (bytes, {'type': 'string', 'format': 'binary'}),
-    (bool, {'type': 'boolean'}),
-    (int, {'type': 'integer'}),
-    (float, {'type': 'number'}),
-    (Decimal, {'type': 'number'}),
-    (UUID, {'type': 'string', 'format': 'uuid'}),
-    (dict, {'type': 'object'}),
-    (list, {'type': 'array', 'items': {}}),
-    (tuple, {'type': 'array', 'items': {}}),
-    (set, {'type': 'array', 'items': {}, 'uniqueItems': True}),
-    (frozenset, {'type': 'array', 'items': {}, 'uniqueItems': True}),
-)
-
-json_scheme = {'type': 'string', 'format': 'json-string'}
-
-
-def add_field_type_to_schema(field_type: Any, schema_: Dict[str, Any]) -> None:
-    """
-    Update the given `schema` with the type-specific metadata for the given `field_type`.
-
-    This function looks through `field_class_to_schema` for a class that matches the given `field_type`,
-    and then modifies the given `schema` with the information from that type.
-    """
-    for type_, t_schema in field_class_to_schema:
-        # Fallback for `typing.Pattern` and `re.Pattern` as they are not a valid class
-        if lenient_issubclass(field_type, type_) or field_type is type_ is Pattern:
-            schema_.update(t_schema)
-            break
-
-
-def get_schema_ref(name: str, ref_prefix: Optional[str], ref_template: str, schema_overrides: bool) -> Dict[str, Any]:
-    if ref_prefix:
-        schema_ref = {'$ref': ref_prefix + name}
-    else:
-        schema_ref = {'$ref': ref_template.format(model=name)}
-    return {'allOf': [schema_ref]} if schema_overrides else schema_ref
-
-
-def field_singleton_schema(  # noqa: C901 (ignore complexity)
-    field: ModelField,
-    *,
-    by_alias: bool,
-    model_name_map: Dict[TypeModelOrEnum, str],
-    ref_template: str,
-    schema_overrides: bool = False,
-    ref_prefix: Optional[str] = None,
-    known_models: TypeModelSet,
-) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]:
-    """
-    This function is indirectly used by ``field_schema()``, you should probably be using that function.
-
-    Take a single Pydantic ``ModelField``, and return its schema and any additional definitions from sub-models.
-    """
-    from .main import BaseModel
-
-    definitions: Dict[str, Any] = {}
-    nested_models: Set[str] = set()
-    field_type = field.type_
-
-    # Recurse into this field if it contains sub_fields and is NOT a
-    # BaseModel OR that BaseModel is a const
-    if field.sub_fields and (
-        (field.field_info and field.field_info.const) or not lenient_issubclass(field_type, BaseModel)
-    ):
-        return field_singleton_sub_fields_schema(
-            field,
-            by_alias=by_alias,
-            model_name_map=model_name_map,
-            schema_overrides=schema_overrides,
-            ref_prefix=ref_prefix,
-            ref_template=ref_template,
-            known_models=known_models,
-        )
-    if field_type is Any or field_type is object or field_type.__class__ == TypeVar or get_origin(field_type) is type:
-        return {}, definitions, nested_models  # no restrictions
-    if is_none_type(field_type):
-        return {'type': 'null'}, definitions, nested_models
-    if is_callable_type(field_type):
-        raise SkipField(f'Callable {field.name} was excluded from schema since JSON schema has no equivalent type.')
-    f_schema: Dict[str, Any] = {}
-    if field.field_info is not None and field.field_info.const:
-        f_schema['const'] = field.default
-
-    if is_literal_type(field_type):
-        values = all_literal_values(field_type)
-
-        if len({v.__class__ for v in values}) > 1:
-            return field_schema(
-                multitypes_literal_field_for_schema(values, field),
-                by_alias=by_alias,
-                model_name_map=model_name_map,
-                ref_prefix=ref_prefix,
-                ref_template=ref_template,
-                known_models=known_models,
-            )
-
-        # All values have the same type
-        field_type = values[0].__class__
-        f_schema['enum'] = list(values)
-        add_field_type_to_schema(field_type, f_schema)
-    elif lenient_issubclass(field_type, Enum):
-        enum_name = model_name_map[field_type]
-        f_schema, schema_overrides = get_field_info_schema(field, schema_overrides)
-        f_schema.update(get_schema_ref(enum_name, ref_prefix, ref_template, schema_overrides))
-        definitions[enum_name] = enum_process_schema(field_type, field=field)
-    elif is_namedtuple(field_type):
-        sub_schema, *_ = model_process_schema(
-            field_type.__pydantic_model__,
-            by_alias=by_alias,
-            model_name_map=model_name_map,
-            ref_prefix=ref_prefix,
-            ref_template=ref_template,
-            known_models=known_models,
-            field=field,
-        )
-        items_schemas = list(sub_schema['properties'].values())
-        f_schema.update(
-            {
-                'type': 'array',
-                'items': items_schemas,
-                'minItems': len(items_schemas),
-                'maxItems': len(items_schemas),
-            }
-        )
-    elif not hasattr(field_type, '__pydantic_model__'):
-        add_field_type_to_schema(field_type, f_schema)
-
-        modify_schema = getattr(field_type, '__modify_schema__', None)
-        if modify_schema:
-            _apply_modify_schema(modify_schema, field, f_schema)
-
-    if f_schema:
-        return f_schema, definitions, nested_models
-
-    # Handle dataclass-based models
-    if lenient_issubclass(getattr(field_type, '__pydantic_model__', None), BaseModel):
-        field_type = field_type.__pydantic_model__
-
-    if issubclass(field_type, BaseModel):
-        model_name = model_name_map[field_type]
-        if field_type not in known_models:
-            sub_schema, sub_definitions, sub_nested_models = model_process_schema(
-                field_type,
-                by_alias=by_alias,
-                model_name_map=model_name_map,
-                ref_prefix=ref_prefix,
-                ref_template=ref_template,
-                known_models=known_models,
-                field=field,
-            )
-            definitions.update(sub_definitions)
-            definitions[model_name] = sub_schema
-            nested_models.update(sub_nested_models)
-        else:
-            nested_models.add(model_name)
-        schema_ref = get_schema_ref(model_name, ref_prefix, ref_template, schema_overrides)
-        return schema_ref, definitions, nested_models
-
-    # For generics with no args
-    args = get_args(field_type)
-    if args is not None and not args and Generic in field_type.__bases__:
-        return f_schema, definitions, nested_models
-
-    raise ValueError(f'Value not declarable with JSON Schema, field: {field}')
-
-
-def multitypes_literal_field_for_schema(values: Tuple[Any, ...], field: ModelField) -> ModelField:
-    """
-    To support `Literal` with values of different types, we split it into multiple `Literal` with same type
-    e.g. `Literal['qwe', 'asd', 1, 2]` becomes `Union[Literal['qwe', 'asd'], Literal[1, 2]]`
-    """
-    literal_distinct_types = defaultdict(list)
-    for v in values:
-        literal_distinct_types[v.__class__].append(v)
-    distinct_literals = (Literal[tuple(same_type_values)] for same_type_values in literal_distinct_types.values())
-
-    return ModelField(
-        name=field.name,
-        type_=Union[tuple(distinct_literals)],  # type: ignore
-        class_validators=field.class_validators,
-        model_config=field.model_config,
-        default=field.default,
-        required=field.required,
-        alias=field.alias,
-        field_info=field.field_info,
-    )
-
-
-def encode_default(dft: Any) -> Any:
-    if isinstance(dft, Enum):
-        return dft.value
-    elif isinstance(dft, (int, float, str)):
-        return dft
-    elif isinstance(dft, (list, tuple)):
-        t = dft.__class__
-        seq_args = (encode_default(v) for v in dft)
-        return t(*seq_args) if is_namedtuple(t) else t(seq_args)
-    elif isinstance(dft, dict):
-        return {encode_default(k): encode_default(v) for k, v in dft.items()}
-    elif dft is None:
-        return None
-    else:
-        return pydantic_encoder(dft)
-
-
-_map_types_constraint: Dict[Any, Callable[..., type]] = {int: conint, float: confloat, Decimal: condecimal}
-
-
-def get_annotation_from_field_info(
-    annotation: Any, field_info: FieldInfo, field_name: str, validate_assignment: bool = False
-) -> Type[Any]:
-    """
-    Get an annotation with validation implemented for numbers and strings based on the field_info.
-    :param annotation: an annotation from a field specification, as ``str``, ``ConstrainedStr``
-    :param field_info: an instance of FieldInfo, possibly with declarations for validations and JSON Schema
-    :param field_name: name of the field for use in error messages
-    :param validate_assignment: default False, flag for BaseModel Config value of validate_assignment
-    :return: the same ``annotation`` if unmodified or a new annotation with validation in place
-    """
-    constraints = field_info.get_constraints()
-    used_constraints: Set[str] = set()
-    if constraints:
-        annotation, used_constraints = get_annotation_with_constraints(annotation, field_info)
-    if validate_assignment:
-        used_constraints.add('allow_mutation')
-
-    unused_constraints = constraints - used_constraints
-    if unused_constraints:
-        raise ValueError(
-            f'On field "{field_name}" the following field constraints are set but not enforced: '
-            f'{", ".join(unused_constraints)}. '
-            f'\nFor more details see https://pydantic-docs.helpmanual.io/usage/schema/#unenforced-field-constraints'
-        )
-
-    return annotation
-
-
-def get_annotation_with_constraints(annotation: Any, field_info: FieldInfo) -> Tuple[Type[Any], Set[str]]:  # noqa: C901
-    """
-    Get an annotation with used constraints implemented for numbers and strings based on the field_info.
-
-    :param annotation: an annotation from a field specification, as ``str``, ``ConstrainedStr``
-    :param field_info: an instance of FieldInfo, possibly with declarations for validations and JSON Schema
-    :return: the same ``annotation`` if unmodified or a new annotation along with the used constraints.
-    """
-    used_constraints: Set[str] = set()
-
-    def go(type_: Any) -> Type[Any]:
-        if (
-            is_literal_type(type_)
-            or isinstance(type_, ForwardRef)
-            or lenient_issubclass(type_, (ConstrainedList, ConstrainedSet, ConstrainedFrozenSet))
-        ):
-            return type_
-        origin = get_origin(type_)
-        if origin is not None:
-            args: Tuple[Any, ...] = get_args(type_)
-            if any(isinstance(a, ForwardRef) for a in args):
-                # forward refs cause infinite recursion below
-                return type_
-
-            if origin is Annotated:
-                return go(args[0])
-            if is_union(origin):
-                return Union[tuple(go(a) for a in args)]  # type: ignore
-
-            if issubclass(origin, List) and (
-                field_info.min_items is not None
-                or field_info.max_items is not None
-                or field_info.unique_items is not None
-            ):
-                used_constraints.update({'min_items', 'max_items', 'unique_items'})
-                return conlist(
-                    go(args[0]),
-                    min_items=field_info.min_items,
-                    max_items=field_info.max_items,
-                    unique_items=field_info.unique_items,
-                )
-
-            if issubclass(origin, Set) and (field_info.min_items is not None or field_info.max_items is not None):
-                used_constraints.update({'min_items', 'max_items'})
-                return conset(go(args[0]), min_items=field_info.min_items, max_items=field_info.max_items)
-
-            if issubclass(origin, FrozenSet) and (field_info.min_items is not None or field_info.max_items is not None):
-                used_constraints.update({'min_items', 'max_items'})
-                return confrozenset(go(args[0]), min_items=field_info.min_items, max_items=field_info.max_items)
-
-            for t in (Tuple, List, Set, FrozenSet, Sequence):
-                if issubclass(origin, t):  # type: ignore
-                    return t[tuple(go(a) for a in args)]  # type: ignore
-
-            if issubclass(origin, Dict):
-                return Dict[args[0], go(args[1])]  # type: ignore
-
-        attrs: Optional[Tuple[str, ...]] = None
-        constraint_func: Optional[Callable[..., type]] = None
-        if isinstance(type_, type):
-            if issubclass(type_, (SecretStr, SecretBytes)):
-                attrs = ('max_length', 'min_length')
-
-                def constraint_func(**kw: Any) -> Type[Any]:
-                    return type(type_.__name__, (type_,), kw)
-
-            elif issubclass(type_, str) and not issubclass(type_, (EmailStr, AnyUrl)):
-                attrs = ('max_length', 'min_length', 'regex')
-                if issubclass(type_, StrictStr):
-
-                    def constraint_func(**kw: Any) -> Type[Any]:
-                        return type(type_.__name__, (type_,), kw)
-
-                else:
-                    constraint_func = constr
-            elif issubclass(type_, bytes):
-                attrs = ('max_length', 'min_length', 'regex')
-                if issubclass(type_, StrictBytes):
-
-                    def constraint_func(**kw: Any) -> Type[Any]:
-                        return type(type_.__name__, (type_,), kw)
-
-                else:
-                    constraint_func = conbytes
-            elif issubclass(type_, numeric_types) and not issubclass(
-                type_,
-                (
-                    ConstrainedInt,
-                    ConstrainedFloat,
-                    ConstrainedDecimal,
-                    ConstrainedList,
-                    ConstrainedSet,
-                    ConstrainedFrozenSet,
-                    bool,
-                ),
-            ):
-                # Is numeric type
-                attrs = ('gt', 'lt', 'ge', 'le', 'multiple_of')
-                if issubclass(type_, float):
-                    attrs += ('allow_inf_nan',)
-                if issubclass(type_, Decimal):
-                    attrs += ('max_digits', 'decimal_places')
-                numeric_type = next(t for t in numeric_types if issubclass(type_, t))  # pragma: no branch
-                constraint_func = _map_types_constraint[numeric_type]
-
-        if attrs:
-            used_constraints.update(set(attrs))
-            kwargs = {
-                attr_name: attr
-                for attr_name, attr in ((attr_name, getattr(field_info, attr_name)) for attr_name in attrs)
-                if attr is not None
-            }
-            if kwargs:
-                constraint_func = cast(Callable[..., type], constraint_func)
-                return constraint_func(**kwargs)
-        return type_
-
-    return go(annotation), used_constraints
-
-
-def normalize_name(name: str) -> str:
-    """
-    Normalizes the given name. This can be applied to either a model *or* enum.
-    """
-    return re.sub(r'[^a-zA-Z0-9.\-_]', '_', name)
-
-
-class SkipField(Exception):
-    """
-    Utility exception used to exclude fields from schema.
-    """
-
-    def __init__(self, message: str) -> None:
-        self.message = message
+__getattr__ = getattr_migration(__name__)
diff --git a/lib/pydantic/tools.py b/lib/pydantic/tools.py
index 9cdb4538..8e317c92 100644
--- a/lib/pydantic/tools.py
+++ b/lib/pydantic/tools.py
@@ -1,92 +1,4 @@
-import json
-from functools import lru_cache
-from pathlib import Path
-from typing import TYPE_CHECKING, Any, Callable, Optional, Type, TypeVar, Union
+"""The `tools` module is a backport module from V1."""
+from ._migration import getattr_migration
 
-from .parse import Protocol, load_file, load_str_bytes
-from .types import StrBytes
-from .typing import display_as_type
-
-__all__ = ('parse_file_as', 'parse_obj_as', 'parse_raw_as', 'schema_of', 'schema_json_of')
-
-NameFactory = Union[str, Callable[[Type[Any]], str]]
-
-if TYPE_CHECKING:
-    from .typing import DictStrAny
-
-
-def _generate_parsing_type_name(type_: Any) -> str:
-    return f'ParsingModel[{display_as_type(type_)}]'
-
-
-@lru_cache(maxsize=2048)
-def _get_parsing_type(type_: Any, *, type_name: Optional[NameFactory] = None) -> Any:
-    from pydantic.main import create_model
-
-    if type_name is None:
-        type_name = _generate_parsing_type_name
-    if not isinstance(type_name, str):
-        type_name = type_name(type_)
-    return create_model(type_name, __root__=(type_, ...))
-
-
-T = TypeVar('T')
-
-
-def parse_obj_as(type_: Type[T], obj: Any, *, type_name: Optional[NameFactory] = None) -> T:
-    model_type = _get_parsing_type(type_, type_name=type_name)  # type: ignore[arg-type]
-    return model_type(__root__=obj).__root__
-
-
-def parse_file_as(
-    type_: Type[T],
-    path: Union[str, Path],
-    *,
-    content_type: str = None,
-    encoding: str = 'utf8',
-    proto: Protocol = None,
-    allow_pickle: bool = False,
-    json_loads: Callable[[str], Any] = json.loads,
-    type_name: Optional[NameFactory] = None,
-) -> T:
-    obj = load_file(
-        path,
-        proto=proto,
-        content_type=content_type,
-        encoding=encoding,
-        allow_pickle=allow_pickle,
-        json_loads=json_loads,
-    )
-    return parse_obj_as(type_, obj, type_name=type_name)
-
-
-def parse_raw_as(
-    type_: Type[T],
-    b: StrBytes,
-    *,
-    content_type: str = None,
-    encoding: str = 'utf8',
-    proto: Protocol = None,
-    allow_pickle: bool = False,
-    json_loads: Callable[[str], Any] = json.loads,
-    type_name: Optional[NameFactory] = None,
-) -> T:
-    obj = load_str_bytes(
-        b,
-        proto=proto,
-        content_type=content_type,
-        encoding=encoding,
-        allow_pickle=allow_pickle,
-        json_loads=json_loads,
-    )
-    return parse_obj_as(type_, obj, type_name=type_name)
-
-
-def schema_of(type_: Any, *, title: Optional[NameFactory] = None, **schema_kwargs: Any) -> 'DictStrAny':
-    """Generate a JSON schema (as dict) for the passed model or dynamically generated one"""
-    return _get_parsing_type(type_, type_name=title).schema(**schema_kwargs)
-
-
-def schema_json_of(type_: Any, *, title: Optional[NameFactory] = None, **schema_json_kwargs: Any) -> str:
-    """Generate a JSON schema (as JSON) for the passed model or dynamically generated one"""
-    return _get_parsing_type(type_, type_name=title).schema_json(**schema_json_kwargs)
+__getattr__ = getattr_migration(__name__)
diff --git a/lib/pydantic/type_adapter.py b/lib/pydantic/type_adapter.py
new file mode 100644
index 00000000..366262fe
--- /dev/null
+++ b/lib/pydantic/type_adapter.py
@@ -0,0 +1,460 @@
+"""Type adapter specification."""
+from __future__ import annotations as _annotations
+
+import sys
+from dataclasses import is_dataclass
+from typing import TYPE_CHECKING, Any, Dict, Generic, Iterable, Set, TypeVar, Union, cast, final, overload
+
+from pydantic_core import CoreSchema, SchemaSerializer, SchemaValidator, Some
+from typing_extensions import Literal, get_args, is_typeddict
+
+from pydantic.errors import PydanticUserError
+from pydantic.main import BaseModel
+
+from ._internal import _config, _generate_schema, _typing_extra
+from .config import ConfigDict
+from .json_schema import (
+    DEFAULT_REF_TEMPLATE,
+    GenerateJsonSchema,
+    JsonSchemaKeyT,
+    JsonSchemaMode,
+    JsonSchemaValue,
+)
+from .plugin._schema_validator import create_schema_validator
+
+T = TypeVar('T')
+
+
+if TYPE_CHECKING:
+    # should be `set[int] | set[str] | dict[int, IncEx] | dict[str, IncEx] | None`, but mypy can't cope
+    IncEx = Union[Set[int], Set[str], Dict[int, Any], Dict[str, Any]]
+
+
+def _get_schema(type_: Any, config_wrapper: _config.ConfigWrapper, parent_depth: int) -> CoreSchema:
+    """`BaseModel` uses its own `__module__` to find out where it was defined
+    and then looks for symbols to resolve forward references in those globals.
+    On the other hand this function can be called with arbitrary objects,
+    including type aliases, where `__module__` (always `typing.py`) is not useful.
+    So instead we look at the globals in our parent stack frame.
+
+    This works for the case where this function is called in a module that
+    has the target of forward references in its scope, but
+    does not always work for more complex cases.
+
+    For example, take the following:
+
+    a.py
+    ```python
+    from typing import Dict, List
+
+    IntList = List[int]
+    OuterDict = Dict[str, 'IntList']
+    ```
+
+    b.py
+    ```python test="skip"
+    from a import OuterDict
+
+    from pydantic import TypeAdapter
+
+    IntList = int  # replaces the symbol the forward reference is looking for
+    v = TypeAdapter(OuterDict)
+    v({'x': 1})  # should fail but doesn't
+    ```
+
+    If `OuterDict` were a `BaseModel`, this would work because it would resolve
+    the forward reference within the `a.py` namespace.
+    But `TypeAdapter(OuterDict)` can't determine what module `OuterDict` came from.
+
+    In other words, the assumption that _all_ forward references exist in the
+    module we are being called from is not technically always true.
+    Although most of the time it is and it works fine for recursive models and such,
+    `BaseModel`'s behavior isn't perfect either and _can_ break in similar ways,
+    so there is no right or wrong between the two.
+
+    But at the very least this behavior is _subtly_ different from `BaseModel`'s.
+    """
+    local_ns = _typing_extra.parent_frame_namespace(parent_depth=parent_depth)
+    global_ns = sys._getframe(max(parent_depth - 1, 1)).f_globals.copy()
+    global_ns.update(local_ns or {})
+    gen = _generate_schema.GenerateSchema(config_wrapper, types_namespace=global_ns, typevars_map={})
+    schema = gen.generate_schema(type_)
+    schema = gen.clean_schema(schema)
+    return schema
+
+
+def _getattr_no_parents(obj: Any, attribute: str) -> Any:
+    """Returns the attribute value without attempting to look up attributes from parent types."""
+    if hasattr(obj, '__dict__'):
+        try:
+            return obj.__dict__[attribute]
+        except KeyError:
+            pass
+
+    slots = getattr(obj, '__slots__', None)
+    if slots is not None and attribute in slots:
+        return getattr(obj, attribute)
+    else:
+        raise AttributeError(attribute)
+
+
+def _type_has_config(type_: Any) -> bool:
+    """Returns whether the type has config."""
+    try:
+        return issubclass(type_, BaseModel) or is_dataclass(type_) or is_typeddict(type_)
+    except TypeError:
+        # type is not a class
+        return False
+
+
+@final
+class TypeAdapter(Generic[T]):
+    """Usage docs: https://docs.pydantic.dev/2.6/concepts/type_adapter/
+
+    Type adapters provide a flexible way to perform validation and serialization based on a Python type.
+
+    A `TypeAdapter` instance exposes some of the functionality from `BaseModel` instance methods
+    for types that do not have such methods (such as dataclasses, primitive types, and more).
+
+    **Note:** `TypeAdapter` instances are not types, and cannot be used as type annotations for fields.
+
+    Attributes:
+        core_schema: The core schema for the type.
+        validator (SchemaValidator): The schema validator for the type.
+        serializer: The schema serializer for the type.
+    """
+
+    @overload
+    def __init__(
+        self,
+        type: type[T],
+        *,
+        config: ConfigDict | None = ...,
+        _parent_depth: int = ...,
+        module: str | None = ...,
+    ) -> None:
+        ...
+
+    # This second overload is for unsupported special forms (such as Union). `pyright` handles them fine, but `mypy` does not match
+    # them against `type: type[T]`, so an explicit overload with `type: T` is needed.
+    @overload
+    def __init__(  # pyright: ignore[reportOverlappingOverload]
+        self,
+        type: T,
+        *,
+        config: ConfigDict | None = ...,
+        _parent_depth: int = ...,
+        module: str | None = ...,
+    ) -> None:
+        ...
+
+    def __init__(
+        self,
+        type: type[T] | T,
+        *,
+        config: ConfigDict | None = None,
+        _parent_depth: int = 2,
+        module: str | None = None,
+    ) -> None:
+        """Initializes the TypeAdapter object.
+
+        Args:
+            type: The type associated with the `TypeAdapter`.
+            config: Configuration for the `TypeAdapter`, should be a dictionary conforming to [`ConfigDict`][pydantic.config.ConfigDict].
+            _parent_depth: depth at which to search the parent namespace to construct the local namespace.
+            module: The module that passes to plugin if provided.
+
+        !!! note
+            You cannot use the `config` argument when instantiating a `TypeAdapter` if the type you're using has its own
+            config that cannot be overridden (ex: `BaseModel`, `TypedDict`, and `dataclass`). A
+            [`type-adapter-config-unused`](../errors/usage_errors.md#type-adapter-config-unused) error will be raised in this case.
+
+        !!! note
+            The `_parent_depth` argument is named with an underscore to suggest its private nature and discourage use.
+            It may be deprecated in a minor version, so we only recommend using it if you're
+            comfortable with potential change in behavior / support.
+
+        ??? tip "Compatibility with `mypy`"
+            Depending on the type used, `mypy` might raise an error when instantiating a `TypeAdapter`. As a workaround, you can explicitly
+            annotate your variable:
+
+            ```py
+            from typing import Union
+
+            from pydantic import TypeAdapter
+
+            ta: TypeAdapter[Union[str, int]] = TypeAdapter(Union[str, int])  # type: ignore[arg-type]
+            ```
+
+        Returns:
+            A type adapter configured for the specified `type`.
+        """
+        type_is_annotated: bool = _typing_extra.is_annotated(type)
+        annotated_type: Any = get_args(type)[0] if type_is_annotated else None
+        type_has_config: bool = _type_has_config(annotated_type if type_is_annotated else type)
+
+        if type_has_config and config is not None:
+            raise PydanticUserError(
+                'Cannot use `config` when the type is a BaseModel, dataclass or TypedDict.'
+                ' These types can have their own config and setting the config via the `config`'
+                ' parameter to TypeAdapter will not override it, thus the `config` you passed to'
+                ' TypeAdapter becomes meaningless, which is probably not what you want.',
+                code='type-adapter-config-unused',
+            )
+
+        config_wrapper = _config.ConfigWrapper(config)
+
+        core_schema: CoreSchema
+        try:
+            core_schema = _getattr_no_parents(type, '__pydantic_core_schema__')
+        except AttributeError:
+            core_schema = _get_schema(type, config_wrapper, parent_depth=_parent_depth + 1)
+
+        core_config = config_wrapper.core_config(None)
+        validator: SchemaValidator
+        try:
+            validator = _getattr_no_parents(type, '__pydantic_validator__')
+        except AttributeError:
+            if module is None:
+                f = sys._getframe(1)
+                module = cast(str, f.f_globals.get('__name__', ''))
+            validator = create_schema_validator(
+                core_schema, type, module, str(type), 'TypeAdapter', core_config, config_wrapper.plugin_settings
+            )  # type: ignore
+
+        serializer: SchemaSerializer
+        try:
+            serializer = _getattr_no_parents(type, '__pydantic_serializer__')
+        except AttributeError:
+            serializer = SchemaSerializer(core_schema, core_config)
+
+        self.core_schema = core_schema
+        self.validator = validator
+        self.serializer = serializer
+
+    def validate_python(
+        self,
+        __object: Any,
+        *,
+        strict: bool | None = None,
+        from_attributes: bool | None = None,
+        context: dict[str, Any] | None = None,
+    ) -> T:
+        """Validate a Python object against the model.
+
+        Args:
+            __object: The Python object to validate against the model.
+            strict: Whether to strictly check types.
+            from_attributes: Whether to extract data from object attributes.
+            context: Additional context to pass to the validator.
+
+        !!! note
+            When using `TypeAdapter` with a Pydantic `dataclass`, the use of the `from_attributes`
+            argument is not supported.
+
+        Returns:
+            The validated object.
+        """
+        return self.validator.validate_python(__object, strict=strict, from_attributes=from_attributes, context=context)
+
+    def validate_json(
+        self, __data: str | bytes, *, strict: bool | None = None, context: dict[str, Any] | None = None
+    ) -> T:
+        """Usage docs: https://docs.pydantic.dev/2.6/concepts/json/#json-parsing
+
+        Validate a JSON string or bytes against the model.
+
+        Args:
+            __data: The JSON data to validate against the model.
+            strict: Whether to strictly check types.
+            context: Additional context to use during validation.
+
+        Returns:
+            The validated object.
+        """
+        return self.validator.validate_json(__data, strict=strict, context=context)
+
+    def validate_strings(self, __obj: Any, *, strict: bool | None = None, context: dict[str, Any] | None = None) -> T:
+        """Validate object contains string data against the model.
+
+        Args:
+            __obj: The object contains string data to validate.
+            strict: Whether to strictly check types.
+            context: Additional context to use during validation.
+
+        Returns:
+            The validated object.
+        """
+        return self.validator.validate_strings(__obj, strict=strict, context=context)
+
+    def get_default_value(self, *, strict: bool | None = None, context: dict[str, Any] | None = None) -> Some[T] | None:
+        """Get the default value for the wrapped type.
+
+        Args:
+            strict: Whether to strictly check types.
+            context: Additional context to pass to the validator.
+
+        Returns:
+            The default value wrapped in a `Some` if there is one or None if not.
+        """
+        return self.validator.get_default_value(strict=strict, context=context)
+
+    def dump_python(
+        self,
+        __instance: T,
+        *,
+        mode: Literal['json', 'python'] = 'python',
+        include: IncEx | None = None,
+        exclude: IncEx | None = None,
+        by_alias: bool = False,
+        exclude_unset: bool = False,
+        exclude_defaults: bool = False,
+        exclude_none: bool = False,
+        round_trip: bool = False,
+        warnings: bool = True,
+    ) -> Any:
+        """Dump an instance of the adapted type to a Python object.
+
+        Args:
+            __instance: The Python object to serialize.
+            mode: The output format.
+            include: Fields to include in the output.
+            exclude: Fields to exclude from the output.
+            by_alias: Whether to use alias names for field names.
+            exclude_unset: Whether to exclude unset fields.
+            exclude_defaults: Whether to exclude fields with default values.
+            exclude_none: Whether to exclude fields with None values.
+            round_trip: Whether to output the serialized data in a way that is compatible with deserialization.
+            warnings: Whether to display serialization warnings.
+
+        Returns:
+            The serialized object.
+        """
+        return self.serializer.to_python(
+            __instance,
+            mode=mode,
+            by_alias=by_alias,
+            include=include,
+            exclude=exclude,
+            exclude_unset=exclude_unset,
+            exclude_defaults=exclude_defaults,
+            exclude_none=exclude_none,
+            round_trip=round_trip,
+            warnings=warnings,
+        )
+
+    def dump_json(
+        self,
+        __instance: T,
+        *,
+        indent: int | None = None,
+        include: IncEx | None = None,
+        exclude: IncEx | None = None,
+        by_alias: bool = False,
+        exclude_unset: bool = False,
+        exclude_defaults: bool = False,
+        exclude_none: bool = False,
+        round_trip: bool = False,
+        warnings: bool = True,
+    ) -> bytes:
+        """Usage docs: https://docs.pydantic.dev/2.6/concepts/json/#json-serialization
+
+        Serialize an instance of the adapted type to JSON.
+
+        Args:
+            __instance: The instance to be serialized.
+            indent: Number of spaces for JSON indentation.
+            include: Fields to include.
+            exclude: Fields to exclude.
+            by_alias: Whether to use alias names for field names.
+            exclude_unset: Whether to exclude unset fields.
+            exclude_defaults: Whether to exclude fields with default values.
+            exclude_none: Whether to exclude fields with a value of `None`.
+            round_trip: Whether to serialize and deserialize the instance to ensure round-tripping.
+            warnings: Whether to emit serialization warnings.
+
+        Returns:
+            The JSON representation of the given instance as bytes.
+        """
+        return self.serializer.to_json(
+            __instance,
+            indent=indent,
+            include=include,
+            exclude=exclude,
+            by_alias=by_alias,
+            exclude_unset=exclude_unset,
+            exclude_defaults=exclude_defaults,
+            exclude_none=exclude_none,
+            round_trip=round_trip,
+            warnings=warnings,
+        )
+
+    def json_schema(
+        self,
+        *,
+        by_alias: bool = True,
+        ref_template: str = DEFAULT_REF_TEMPLATE,
+        schema_generator: type[GenerateJsonSchema] = GenerateJsonSchema,
+        mode: JsonSchemaMode = 'validation',
+    ) -> dict[str, Any]:
+        """Generate a JSON schema for the adapted type.
+
+        Args:
+            by_alias: Whether to use alias names for field names.
+            ref_template: The format string used for generating $ref strings.
+            schema_generator: The generator class used for creating the schema.
+            mode: The mode to use for schema generation.
+
+        Returns:
+            The JSON schema for the model as a dictionary.
+        """
+        schema_generator_instance = schema_generator(by_alias=by_alias, ref_template=ref_template)
+        return schema_generator_instance.generate(self.core_schema, mode=mode)
+
+    @staticmethod
+    def json_schemas(
+        __inputs: Iterable[tuple[JsonSchemaKeyT, JsonSchemaMode, TypeAdapter[Any]]],
+        *,
+        by_alias: bool = True,
+        title: str | None = None,
+        description: str | None = None,
+        ref_template: str = DEFAULT_REF_TEMPLATE,
+        schema_generator: type[GenerateJsonSchema] = GenerateJsonSchema,
+    ) -> tuple[dict[tuple[JsonSchemaKeyT, JsonSchemaMode], JsonSchemaValue], JsonSchemaValue]:
+        """Generate a JSON schema including definitions from multiple type adapters.
+
+        Args:
+            __inputs: Inputs to schema generation. The first two items will form the keys of the (first)
+                output mapping; the type adapters will provide the core schemas that get converted into
+                definitions in the output JSON schema.
+            by_alias: Whether to use alias names.
+            title: The title for the schema.
+            description: The description for the schema.
+            ref_template: The format string used for generating $ref strings.
+            schema_generator: The generator class used for creating the schema.
+
+        Returns:
+            A tuple where:
+
+                - The first element is a dictionary whose keys are tuples of JSON schema key type and JSON mode, and
+                    whose values are the JSON schema corresponding to that pair of inputs. (These schemas may have
+                    JsonRef references to definitions that are defined in the second returned element.)
+                - The second element is a JSON schema containing all definitions referenced in the first returned
+                    element, along with the optional title and description keys.
+
+        """
+        schema_generator_instance = schema_generator(by_alias=by_alias, ref_template=ref_template)
+
+        inputs = [(key, mode, adapter.core_schema) for key, mode, adapter in __inputs]
+
+        json_schemas_map, definitions = schema_generator_instance.generate_definitions(inputs)
+
+        json_schema: dict[str, Any] = {}
+        if definitions:
+            json_schema['$defs'] = definitions
+        if title:
+            json_schema['title'] = title
+        if description:
+            json_schema['description'] = description
+
+        return json_schemas_map, json_schema
diff --git a/lib/pydantic/types.py b/lib/pydantic/types.py
index f98dba3d..c2534c88 100644
--- a/lib/pydantic/types.py
+++ b/lib/pydantic/types.py
@@ -1,12 +1,14 @@
-import abc
-import math
+"""The types module contains custom types used by pydantic."""
+from __future__ import annotations as _annotations
+
+import base64
+import dataclasses as _dataclasses
 import re
-import warnings
-from datetime import date
+from datetime import date, datetime
 from decimal import Decimal
 from enum import Enum
 from pathlib import Path
-from types import new_class
+from types import ModuleType
 from typing import (
     TYPE_CHECKING,
     Any,
@@ -14,78 +16,56 @@ from typing import (
     ClassVar,
     Dict,
     FrozenSet,
+    Generic,
+    Hashable,
+    Iterator,
     List,
-    Optional,
-    Pattern,
     Set,
-    Tuple,
-    Type,
     TypeVar,
     Union,
     cast,
-    overload,
 )
 from uuid import UUID
-from weakref import WeakSet
 
-from . import errors
-from .datetime_parse import parse_date
-from .utils import import_string, update_not_none
-from .validators import (
-    bytes_validator,
-    constr_length_validator,
-    constr_lower,
-    constr_strip_whitespace,
-    constr_upper,
-    decimal_validator,
-    float_finite_validator,
-    float_validator,
-    frozenset_validator,
-    int_validator,
-    list_validator,
-    number_multiple_validator,
-    number_size_validator,
-    path_exists_validator,
-    path_validator,
-    set_validator,
-    str_validator,
-    strict_bytes_validator,
-    strict_float_validator,
-    strict_int_validator,
-    strict_str_validator,
+import annotated_types
+from annotated_types import BaseMetadata, MaxLen, MinLen
+from pydantic_core import CoreSchema, PydanticCustomError, core_schema
+from typing_extensions import Annotated, Literal, Protocol, TypeAlias, TypeAliasType, deprecated
+
+from ._internal import (
+    _core_utils,
+    _fields,
+    _internal_dataclass,
+    _typing_extra,
+    _utils,
+    _validators,
 )
+from ._migration import getattr_migration
+from .annotated_handlers import GetCoreSchemaHandler, GetJsonSchemaHandler
+from .errors import PydanticUserError
+from .json_schema import JsonSchemaValue
+from .warnings import PydanticDeprecatedSince20
 
-__all__ = [
-    'NoneStr',
-    'NoneBytes',
-    'StrBytes',
-    'NoneStrBytes',
+__all__ = (
+    'Strict',
     'StrictStr',
-    'ConstrainedBytes',
     'conbytes',
-    'ConstrainedList',
     'conlist',
-    'ConstrainedSet',
     'conset',
-    'ConstrainedFrozenSet',
     'confrozenset',
-    'ConstrainedStr',
     'constr',
-    'PyObject',
-    'ConstrainedInt',
+    'ImportString',
     'conint',
     'PositiveInt',
     'NegativeInt',
     'NonNegativeInt',
     'NonPositiveInt',
-    'ConstrainedFloat',
     'confloat',
     'PositiveFloat',
     'NegativeFloat',
     'NonNegativeFloat',
     'NonPositiveFloat',
     'FiniteFloat',
-    'ConstrainedDecimal',
     'condecimal',
     'UUID1',
     'UUID3',
@@ -93,9 +73,8 @@ __all__ = [
     'UUID5',
     'FilePath',
     'DirectoryPath',
+    'NewPath',
     'Json',
-    'JsonWrapper',
-    'SecretField',
     'SecretStr',
     'SecretBytes',
     'StrictBool',
@@ -106,845 +85,1512 @@ __all__ = [
     'ByteSize',
     'PastDate',
     'FutureDate',
-    'ConstrainedDate',
+    'PastDatetime',
+    'FutureDatetime',
     'condate',
-]
+    'AwareDatetime',
+    'NaiveDatetime',
+    'AllowInfNan',
+    'EncoderProtocol',
+    'EncodedBytes',
+    'EncodedStr',
+    'Base64Encoder',
+    'Base64Bytes',
+    'Base64Str',
+    'Base64UrlBytes',
+    'Base64UrlStr',
+    'GetPydanticSchema',
+    'StringConstraints',
+    'Tag',
+    'Discriminator',
+    'JsonValue',
+    'OnErrorOmit',
+)
 
-NoneStr = Optional[str]
-NoneBytes = Optional[bytes]
-StrBytes = Union[str, bytes]
-NoneStrBytes = Optional[StrBytes]
-OptionalInt = Optional[int]
-OptionalIntFloat = Union[OptionalInt, float]
-OptionalIntFloatDecimal = Union[OptionalIntFloat, Decimal]
-OptionalDate = Optional[date]
-StrIntFloat = Union[str, int, float]
-
-if TYPE_CHECKING:
-    from typing_extensions import Annotated
-
-    from .dataclasses import Dataclass
-    from .main import BaseModel
-    from .typing import CallableGenerator
-
-    ModelOrDc = Type[Union[BaseModel, Dataclass]]
 
 T = TypeVar('T')
-_DEFINED_TYPES: 'WeakSet[type]' = WeakSet()
 
 
-@overload
-def _registered(typ: Type[T]) -> Type[T]:
-    pass
+@_dataclasses.dataclass
+class Strict(_fields.PydanticMetadata, BaseMetadata):
+    """Usage docs: https://docs.pydantic.dev/2.6/concepts/strict_mode/#strict-mode-with-annotated-strict
 
+    A field metadata class to indicate that a field should be validated in strict mode.
 
-@overload
-def _registered(typ: 'ConstrainedNumberMeta') -> 'ConstrainedNumberMeta':
-    pass
+    Attributes:
+        strict: Whether to validate the field in strict mode.
 
+    Example:
+        ```python
+        from typing_extensions import Annotated
 
-def _registered(typ: Union[Type[T], 'ConstrainedNumberMeta']) -> Union[Type[T], 'ConstrainedNumberMeta']:
-    # In order to generate valid examples of constrained types, Hypothesis needs
-    # to inspect the type object - so we keep a weakref to each contype object
-    # until it can be registered.  When (or if) our Hypothesis plugin is loaded,
-    # it monkeypatches this function.
-    # If Hypothesis is never used, the total effect is to keep a weak reference
-    # which has minimal memory usage and doesn't even affect garbage collection.
-    _DEFINED_TYPES.add(typ)
-    return typ
+        from pydantic.types import Strict
 
+        StrictBool = Annotated[bool, Strict()]
+        ```
+    """
 
-class ConstrainedNumberMeta(type):
-    def __new__(cls, name: str, bases: Any, dct: Dict[str, Any]) -> 'ConstrainedInt':  # type: ignore
-        new_cls = cast('ConstrainedInt', type.__new__(cls, name, bases, dct))
+    strict: bool = True
 
-        if new_cls.gt is not None and new_cls.ge is not None:
-            raise errors.ConfigError('bounds gt and ge cannot be specified at the same time')
-        if new_cls.lt is not None and new_cls.le is not None:
-            raise errors.ConfigError('bounds lt and le cannot be specified at the same time')
-
-        return _registered(new_cls)  # type: ignore
+    def __hash__(self) -> int:
+        return hash(self.strict)
 
 
 # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ BOOLEAN TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-if TYPE_CHECKING:
-    StrictBool = bool
-else:
-
-    class StrictBool(int):
-        """
-        StrictBool to allow for bools which are not type-coerced.
-        """
-
-        @classmethod
-        def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-            field_schema.update(type='boolean')
-
-        @classmethod
-        def __get_validators__(cls) -> 'CallableGenerator':
-            yield cls.validate
-
-        @classmethod
-        def validate(cls, value: Any) -> bool:
-            """
-            Ensure that we only allow bools.
-            """
-            if isinstance(value, bool):
-                return value
-
-            raise errors.StrictBoolError()
-
+StrictBool = Annotated[bool, Strict()]
+"""A boolean that must be either ``True`` or ``False``."""
 
 # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ INTEGER TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 
-class ConstrainedInt(int, metaclass=ConstrainedNumberMeta):
-    strict: bool = False
-    gt: OptionalInt = None
-    ge: OptionalInt = None
-    lt: OptionalInt = None
-    le: OptionalInt = None
-    multiple_of: OptionalInt = None
-
-    @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-        update_not_none(
-            field_schema,
-            exclusiveMinimum=cls.gt,
-            exclusiveMaximum=cls.lt,
-            minimum=cls.ge,
-            maximum=cls.le,
-            multipleOf=cls.multiple_of,
-        )
-
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield strict_int_validator if cls.strict else int_validator
-        yield number_size_validator
-        yield number_multiple_validator
-
-
 def conint(
-    *, strict: bool = False, gt: int = None, ge: int = None, lt: int = None, le: int = None, multiple_of: int = None
-) -> Type[int]:
-    # use kwargs then define conf in a dict to aid with IDE type hinting
-    namespace = dict(strict=strict, gt=gt, ge=ge, lt=lt, le=le, multiple_of=multiple_of)
-    return type('ConstrainedIntValue', (ConstrainedInt,), namespace)
+    *,
+    strict: bool | None = None,
+    gt: int | None = None,
+    ge: int | None = None,
+    lt: int | None = None,
+    le: int | None = None,
+    multiple_of: int | None = None,
+) -> type[int]:
+    """
+    !!! warning "Discouraged"
+        This function is **discouraged** in favor of using
+        [`Annotated`](https://docs.python.org/3/library/typing.html#typing.Annotated) with
+        [`Field`][pydantic.fields.Field] instead.
+
+        This function will be **deprecated** in Pydantic 3.0.
+
+        The reason is that `conint` returns a type, which doesn't play well with static analysis tools.
+
+        === ":x: Don't do this"
+            ```py
+            from pydantic import BaseModel, conint
+
+            class Foo(BaseModel):
+                bar: conint(strict=True, gt=0)
+            ```
+
+        === ":white_check_mark: Do this"
+            ```py
+            from typing_extensions import Annotated
+
+            from pydantic import BaseModel, Field
+
+            class Foo(BaseModel):
+                bar: Annotated[int, Field(strict=True, gt=0)]
+            ```
+
+    A wrapper around `int` that allows for additional constraints.
+
+    Args:
+        strict: Whether to validate the integer in strict mode. Defaults to `None`.
+        gt: The value must be greater than this.
+        ge: The value must be greater than or equal to this.
+        lt: The value must be less than this.
+        le: The value must be less than or equal to this.
+        multiple_of: The value must be a multiple of this.
+
+    Returns:
+        The wrapped integer type.
+
+    ```py
+    from pydantic import BaseModel, ValidationError, conint
+
+    class ConstrainedExample(BaseModel):
+        constrained_int: conint(gt=1)
+
+    m = ConstrainedExample(constrained_int=2)
+    print(repr(m))
+    #> ConstrainedExample(constrained_int=2)
+
+    try:
+        ConstrainedExample(constrained_int=0)
+    except ValidationError as e:
+        print(e.errors())
+        '''
+        [
+            {
+                'type': 'greater_than',
+                'loc': ('constrained_int',),
+                'msg': 'Input should be greater than 1',
+                'input': 0,
+                'ctx': {'gt': 1},
+                'url': 'https://errors.pydantic.dev/2/v/greater_than',
+            }
+        ]
+        '''
+    ```
+
+    """  # noqa: D212
+    return Annotated[
+        int,
+        Strict(strict) if strict is not None else None,
+        annotated_types.Interval(gt=gt, ge=ge, lt=lt, le=le),
+        annotated_types.MultipleOf(multiple_of) if multiple_of is not None else None,
+    ]
 
 
-if TYPE_CHECKING:
-    PositiveInt = int
-    NegativeInt = int
-    NonPositiveInt = int
-    NonNegativeInt = int
-    StrictInt = int
-else:
+PositiveInt = Annotated[int, annotated_types.Gt(0)]
+"""An integer that must be greater than zero.
 
-    class PositiveInt(ConstrainedInt):
-        gt = 0
+```py
+from pydantic import BaseModel, PositiveInt, ValidationError
 
-    class NegativeInt(ConstrainedInt):
-        lt = 0
+class Model(BaseModel):
+    positive_int: PositiveInt
 
-    class NonPositiveInt(ConstrainedInt):
-        le = 0
+m = Model(positive_int=1)
+print(repr(m))
+#> Model(positive_int=1)
 
-    class NonNegativeInt(ConstrainedInt):
-        ge = 0
+try:
+    Model(positive_int=-1)
+except ValidationError as e:
+    print(e.errors())
+    '''
+    [
+        {
+            'type': 'greater_than',
+            'loc': ('positive_int',),
+            'msg': 'Input should be greater than 0',
+            'input': -1,
+            'ctx': {'gt': 0},
+            'url': 'https://errors.pydantic.dev/2/v/greater_than',
+        }
+    ]
+    '''
+```
+"""
+NegativeInt = Annotated[int, annotated_types.Lt(0)]
+"""An integer that must be less than zero.
 
-    class StrictInt(ConstrainedInt):
-        strict = True
+```py
+from pydantic import BaseModel, NegativeInt, ValidationError
 
+class Model(BaseModel):
+    negative_int: NegativeInt
+
+m = Model(negative_int=-1)
+print(repr(m))
+#> Model(negative_int=-1)
+
+try:
+    Model(negative_int=1)
+except ValidationError as e:
+    print(e.errors())
+    '''
+    [
+        {
+            'type': 'less_than',
+            'loc': ('negative_int',),
+            'msg': 'Input should be less than 0',
+            'input': 1,
+            'ctx': {'lt': 0},
+            'url': 'https://errors.pydantic.dev/2/v/less_than',
+        }
+    ]
+    '''
+```
+"""
+NonPositiveInt = Annotated[int, annotated_types.Le(0)]
+"""An integer that must be less than or equal to zero.
+
+```py
+from pydantic import BaseModel, NonPositiveInt, ValidationError
+
+class Model(BaseModel):
+    non_positive_int: NonPositiveInt
+
+m = Model(non_positive_int=0)
+print(repr(m))
+#> Model(non_positive_int=0)
+
+try:
+    Model(non_positive_int=1)
+except ValidationError as e:
+    print(e.errors())
+    '''
+    [
+        {
+            'type': 'less_than_equal',
+            'loc': ('non_positive_int',),
+            'msg': 'Input should be less than or equal to 0',
+            'input': 1,
+            'ctx': {'le': 0},
+            'url': 'https://errors.pydantic.dev/2/v/less_than_equal',
+        }
+    ]
+    '''
+```
+"""
+NonNegativeInt = Annotated[int, annotated_types.Ge(0)]
+"""An integer that must be greater than or equal to zero.
+
+```py
+from pydantic import BaseModel, NonNegativeInt, ValidationError
+
+class Model(BaseModel):
+    non_negative_int: NonNegativeInt
+
+m = Model(non_negative_int=0)
+print(repr(m))
+#> Model(non_negative_int=0)
+
+try:
+    Model(non_negative_int=-1)
+except ValidationError as e:
+    print(e.errors())
+    '''
+    [
+        {
+            'type': 'greater_than_equal',
+            'loc': ('non_negative_int',),
+            'msg': 'Input should be greater than or equal to 0',
+            'input': -1,
+            'ctx': {'ge': 0},
+            'url': 'https://errors.pydantic.dev/2/v/greater_than_equal',
+        }
+    ]
+    '''
+```
+"""
+StrictInt = Annotated[int, Strict()]
+"""An integer that must be validated in strict mode.
+
+```py
+from pydantic import BaseModel, StrictInt, ValidationError
+
+class StrictIntModel(BaseModel):
+    strict_int: StrictInt
+
+try:
+    StrictIntModel(strict_int=3.14159)
+except ValidationError as e:
+    print(e)
+    '''
+    1 validation error for StrictIntModel
+    strict_int
+      Input should be a valid integer [type=int_type, input_value=3.14159, input_type=float]
+    '''
+```
+"""
 
 # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ FLOAT TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 
-class ConstrainedFloat(float, metaclass=ConstrainedNumberMeta):
-    strict: bool = False
-    gt: OptionalIntFloat = None
-    ge: OptionalIntFloat = None
-    lt: OptionalIntFloat = None
-    le: OptionalIntFloat = None
-    multiple_of: OptionalIntFloat = None
-    allow_inf_nan: Optional[bool] = None
+@_dataclasses.dataclass
+class AllowInfNan(_fields.PydanticMetadata):
+    """A field metadata class to indicate that a field should allow ``-inf``, ``inf``, and ``nan``."""
 
-    @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-        update_not_none(
-            field_schema,
-            exclusiveMinimum=cls.gt,
-            exclusiveMaximum=cls.lt,
-            minimum=cls.ge,
-            maximum=cls.le,
-            multipleOf=cls.multiple_of,
-        )
-        # Modify constraints to account for differences between IEEE floats and JSON
-        if field_schema.get('exclusiveMinimum') == -math.inf:
-            del field_schema['exclusiveMinimum']
-        if field_schema.get('minimum') == -math.inf:
-            del field_schema['minimum']
-        if field_schema.get('exclusiveMaximum') == math.inf:
-            del field_schema['exclusiveMaximum']
-        if field_schema.get('maximum') == math.inf:
-            del field_schema['maximum']
+    allow_inf_nan: bool = True
 
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield strict_float_validator if cls.strict else float_validator
-        yield number_size_validator
-        yield number_multiple_validator
-        yield float_finite_validator
+    def __hash__(self) -> int:
+        return hash(self.allow_inf_nan)
 
 
 def confloat(
     *,
-    strict: bool = False,
-    gt: float = None,
-    ge: float = None,
-    lt: float = None,
-    le: float = None,
-    multiple_of: float = None,
-    allow_inf_nan: Optional[bool] = None,
-) -> Type[float]:
-    # use kwargs then define conf in a dict to aid with IDE type hinting
-    namespace = dict(strict=strict, gt=gt, ge=ge, lt=lt, le=le, multiple_of=multiple_of, allow_inf_nan=allow_inf_nan)
-    return type('ConstrainedFloatValue', (ConstrainedFloat,), namespace)
+    strict: bool | None = None,
+    gt: float | None = None,
+    ge: float | None = None,
+    lt: float | None = None,
+    le: float | None = None,
+    multiple_of: float | None = None,
+    allow_inf_nan: bool | None = None,
+) -> type[float]:
+    """
+    !!! warning "Discouraged"
+        This function is **discouraged** in favor of using
+        [`Annotated`](https://docs.python.org/3/library/typing.html#typing.Annotated) with
+        [`Field`][pydantic.fields.Field] instead.
+
+        This function will be **deprecated** in Pydantic 3.0.
+
+        The reason is that `confloat` returns a type, which doesn't play well with static analysis tools.
+
+        === ":x: Don't do this"
+            ```py
+            from pydantic import BaseModel, confloat
+
+            class Foo(BaseModel):
+                bar: confloat(strict=True, gt=0)
+            ```
+
+        === ":white_check_mark: Do this"
+            ```py
+            from typing_extensions import Annotated
+
+            from pydantic import BaseModel, Field
+
+            class Foo(BaseModel):
+                bar: Annotated[float, Field(strict=True, gt=0)]
+            ```
+
+    A wrapper around `float` that allows for additional constraints.
+
+    Args:
+        strict: Whether to validate the float in strict mode.
+        gt: The value must be greater than this.
+        ge: The value must be greater than or equal to this.
+        lt: The value must be less than this.
+        le: The value must be less than or equal to this.
+        multiple_of: The value must be a multiple of this.
+        allow_inf_nan: Whether to allow `-inf`, `inf`, and `nan`.
+
+    Returns:
+        The wrapped float type.
+
+    ```py
+    from pydantic import BaseModel, ValidationError, confloat
+
+    class ConstrainedExample(BaseModel):
+        constrained_float: confloat(gt=1.0)
+
+    m = ConstrainedExample(constrained_float=1.1)
+    print(repr(m))
+    #> ConstrainedExample(constrained_float=1.1)
+
+    try:
+        ConstrainedExample(constrained_float=0.9)
+    except ValidationError as e:
+        print(e.errors())
+        '''
+        [
+            {
+                'type': 'greater_than',
+                'loc': ('constrained_float',),
+                'msg': 'Input should be greater than 1',
+                'input': 0.9,
+                'ctx': {'gt': 1.0},
+                'url': 'https://errors.pydantic.dev/2/v/greater_than',
+            }
+        ]
+        '''
+    ```
+    """  # noqa: D212
+    return Annotated[
+        float,
+        Strict(strict) if strict is not None else None,
+        annotated_types.Interval(gt=gt, ge=ge, lt=lt, le=le),
+        annotated_types.MultipleOf(multiple_of) if multiple_of is not None else None,
+        AllowInfNan(allow_inf_nan) if allow_inf_nan is not None else None,
+    ]
 
 
-if TYPE_CHECKING:
-    PositiveFloat = float
-    NegativeFloat = float
-    NonPositiveFloat = float
-    NonNegativeFloat = float
-    StrictFloat = float
-    FiniteFloat = float
-else:
+PositiveFloat = Annotated[float, annotated_types.Gt(0)]
+"""A float that must be greater than zero.
 
-    class PositiveFloat(ConstrainedFloat):
-        gt = 0
+```py
+from pydantic import BaseModel, PositiveFloat, ValidationError
 
-    class NegativeFloat(ConstrainedFloat):
-        lt = 0
+class Model(BaseModel):
+    positive_float: PositiveFloat
 
-    class NonPositiveFloat(ConstrainedFloat):
-        le = 0
+m = Model(positive_float=1.0)
+print(repr(m))
+#> Model(positive_float=1.0)
 
-    class NonNegativeFloat(ConstrainedFloat):
-        ge = 0
+try:
+    Model(positive_float=-1.0)
+except ValidationError as e:
+    print(e.errors())
+    '''
+    [
+        {
+            'type': 'greater_than',
+            'loc': ('positive_float',),
+            'msg': 'Input should be greater than 0',
+            'input': -1.0,
+            'ctx': {'gt': 0.0},
+            'url': 'https://errors.pydantic.dev/2/v/greater_than',
+        }
+    ]
+    '''
+```
+"""
+NegativeFloat = Annotated[float, annotated_types.Lt(0)]
+"""A float that must be less than zero.
 
-    class StrictFloat(ConstrainedFloat):
-        strict = True
+```py
+from pydantic import BaseModel, NegativeFloat, ValidationError
 
-    class FiniteFloat(ConstrainedFloat):
-        allow_inf_nan = False
+class Model(BaseModel):
+    negative_float: NegativeFloat
+
+m = Model(negative_float=-1.0)
+print(repr(m))
+#> Model(negative_float=-1.0)
+
+try:
+    Model(negative_float=1.0)
+except ValidationError as e:
+    print(e.errors())
+    '''
+    [
+        {
+            'type': 'less_than',
+            'loc': ('negative_float',),
+            'msg': 'Input should be less than 0',
+            'input': 1.0,
+            'ctx': {'lt': 0.0},
+            'url': 'https://errors.pydantic.dev/2/v/less_than',
+        }
+    ]
+    '''
+```
+"""
+NonPositiveFloat = Annotated[float, annotated_types.Le(0)]
+"""A float that must be less than or equal to zero.
+
+```py
+from pydantic import BaseModel, NonPositiveFloat, ValidationError
+
+class Model(BaseModel):
+    non_positive_float: NonPositiveFloat
+
+m = Model(non_positive_float=0.0)
+print(repr(m))
+#> Model(non_positive_float=0.0)
+
+try:
+    Model(non_positive_float=1.0)
+except ValidationError as e:
+    print(e.errors())
+    '''
+    [
+        {
+            'type': 'less_than_equal',
+            'loc': ('non_positive_float',),
+            'msg': 'Input should be less than or equal to 0',
+            'input': 1.0,
+            'ctx': {'le': 0.0},
+            'url': 'https://errors.pydantic.dev/2/v/less_than_equal',
+        }
+    ]
+    '''
+```
+"""
+NonNegativeFloat = Annotated[float, annotated_types.Ge(0)]
+"""A float that must be greater than or equal to zero.
+
+```py
+from pydantic import BaseModel, NonNegativeFloat, ValidationError
+
+class Model(BaseModel):
+    non_negative_float: NonNegativeFloat
+
+m = Model(non_negative_float=0.0)
+print(repr(m))
+#> Model(non_negative_float=0.0)
+
+try:
+    Model(non_negative_float=-1.0)
+except ValidationError as e:
+    print(e.errors())
+    '''
+    [
+        {
+            'type': 'greater_than_equal',
+            'loc': ('non_negative_float',),
+            'msg': 'Input should be greater than or equal to 0',
+            'input': -1.0,
+            'ctx': {'ge': 0.0},
+            'url': 'https://errors.pydantic.dev/2/v/greater_than_equal',
+        }
+    ]
+    '''
+```
+"""
+StrictFloat = Annotated[float, Strict(True)]
+"""A float that must be validated in strict mode.
+
+```py
+from pydantic import BaseModel, StrictFloat, ValidationError
+
+class StrictFloatModel(BaseModel):
+    strict_float: StrictFloat
+
+try:
+    StrictFloatModel(strict_float='1.0')
+except ValidationError as e:
+    print(e)
+    '''
+    1 validation error for StrictFloatModel
+    strict_float
+      Input should be a valid number [type=float_type, input_value='1.0', input_type=str]
+    '''
+```
+"""
+FiniteFloat = Annotated[float, AllowInfNan(False)]
+"""A float that must be finite (not ``-inf``, ``inf``, or ``nan``).
+
+```py
+from pydantic import BaseModel, FiniteFloat
+
+class Model(BaseModel):
+    finite: FiniteFloat
+
+m = Model(finite=1.0)
+print(m)
+#> finite=1.0
+```
+"""
 
 
 # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ BYTES TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 
-class ConstrainedBytes(bytes):
-    strip_whitespace = False
-    to_upper = False
-    to_lower = False
-    min_length: OptionalInt = None
-    max_length: OptionalInt = None
-    strict: bool = False
-
-    @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-        update_not_none(field_schema, minLength=cls.min_length, maxLength=cls.max_length)
-
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield strict_bytes_validator if cls.strict else bytes_validator
-        yield constr_strip_whitespace
-        yield constr_upper
-        yield constr_lower
-        yield constr_length_validator
-
-
 def conbytes(
     *,
-    strip_whitespace: bool = False,
-    to_upper: bool = False,
-    to_lower: bool = False,
-    min_length: int = None,
-    max_length: int = None,
-    strict: bool = False,
-) -> Type[bytes]:
-    # use kwargs then define conf in a dict to aid with IDE type hinting
-    namespace = dict(
-        strip_whitespace=strip_whitespace,
-        to_upper=to_upper,
-        to_lower=to_lower,
-        min_length=min_length,
-        max_length=max_length,
-        strict=strict,
-    )
-    return _registered(type('ConstrainedBytesValue', (ConstrainedBytes,), namespace))
+    min_length: int | None = None,
+    max_length: int | None = None,
+    strict: bool | None = None,
+) -> type[bytes]:
+    """A wrapper around `bytes` that allows for additional constraints.
+
+    Args:
+        min_length: The minimum length of the bytes.
+        max_length: The maximum length of the bytes.
+        strict: Whether to validate the bytes in strict mode.
+
+    Returns:
+        The wrapped bytes type.
+    """
+    return Annotated[
+        bytes,
+        Strict(strict) if strict is not None else None,
+        annotated_types.Len(min_length or 0, max_length),
+    ]
 
 
-if TYPE_CHECKING:
-    StrictBytes = bytes
-else:
-
-    class StrictBytes(ConstrainedBytes):
-        strict = True
+StrictBytes = Annotated[bytes, Strict()]
+"""A bytes that must be validated in strict mode."""
 
 
 # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ STRING TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 
-class ConstrainedStr(str):
-    strip_whitespace = False
-    to_upper = False
-    to_lower = False
-    min_length: OptionalInt = None
-    max_length: OptionalInt = None
-    curtail_length: OptionalInt = None
-    regex: Optional[Pattern[str]] = None
-    strict = False
+@_dataclasses.dataclass(frozen=True)
+class StringConstraints(annotated_types.GroupedMetadata):
+    """Usage docs: https://docs.pydantic.dev/2.6/concepts/fields/#string-constraints
 
-    @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-        update_not_none(
-            field_schema,
-            minLength=cls.min_length,
-            maxLength=cls.max_length,
-            pattern=cls.regex and cls.regex.pattern,
-        )
+    Apply constraints to `str` types.
 
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield strict_str_validator if cls.strict else str_validator
-        yield constr_strip_whitespace
-        yield constr_upper
-        yield constr_lower
-        yield constr_length_validator
-        yield cls.validate
+    Attributes:
+        strip_whitespace: Whether to strip whitespace from the string.
+        to_upper: Whether to convert the string to uppercase.
+        to_lower: Whether to convert the string to lowercase.
+        strict: Whether to validate the string in strict mode.
+        min_length: The minimum length of the string.
+        max_length: The maximum length of the string.
+        pattern: A regex pattern that the string must match.
+    """
 
-    @classmethod
-    def validate(cls, value: Union[str]) -> Union[str]:
-        if cls.curtail_length and len(value) > cls.curtail_length:
-            value = value[: cls.curtail_length]
+    strip_whitespace: bool | None = None
+    to_upper: bool | None = None
+    to_lower: bool | None = None
+    strict: bool | None = None
+    min_length: int | None = None
+    max_length: int | None = None
+    pattern: str | None = None
 
-        if cls.regex:
-            if not cls.regex.match(value):
-                raise errors.StrRegexError(pattern=cls.regex.pattern)
-
-        return value
+    def __iter__(self) -> Iterator[BaseMetadata]:
+        if self.min_length is not None:
+            yield MinLen(self.min_length)
+        if self.max_length is not None:
+            yield MaxLen(self.max_length)
+        if self.strict is not None:
+            yield Strict()
+        if (
+            self.strip_whitespace is not None
+            or self.pattern is not None
+            or self.to_lower is not None
+            or self.to_upper is not None
+        ):
+            yield _fields.pydantic_general_metadata(
+                strip_whitespace=self.strip_whitespace,
+                to_upper=self.to_upper,
+                to_lower=self.to_lower,
+                pattern=self.pattern,
+            )
 
 
 def constr(
     *,
-    strip_whitespace: bool = False,
-    to_upper: bool = False,
-    to_lower: bool = False,
-    strict: bool = False,
-    min_length: int = None,
-    max_length: int = None,
-    curtail_length: int = None,
-    regex: str = None,
-) -> Type[str]:
-    # use kwargs then define conf in a dict to aid with IDE type hinting
-    namespace = dict(
-        strip_whitespace=strip_whitespace,
-        to_upper=to_upper,
-        to_lower=to_lower,
-        strict=strict,
-        min_length=min_length,
-        max_length=max_length,
-        curtail_length=curtail_length,
-        regex=regex and re.compile(regex),
-    )
-    return _registered(type('ConstrainedStrValue', (ConstrainedStr,), namespace))
+    strip_whitespace: bool | None = None,
+    to_upper: bool | None = None,
+    to_lower: bool | None = None,
+    strict: bool | None = None,
+    min_length: int | None = None,
+    max_length: int | None = None,
+    pattern: str | None = None,
+) -> type[str]:
+    """
+    !!! warning "Discouraged"
+        This function is **discouraged** in favor of using
+        [`Annotated`](https://docs.python.org/3/library/typing.html#typing.Annotated) with
+        [`StringConstraints`][pydantic.types.StringConstraints] instead.
+
+        This function will be **deprecated** in Pydantic 3.0.
+
+        The reason is that `constr` returns a type, which doesn't play well with static analysis tools.
+
+        === ":x: Don't do this"
+            ```py
+            from pydantic import BaseModel, constr
+
+            class Foo(BaseModel):
+                bar: constr(strip_whitespace=True, to_upper=True, pattern=r'^[A-Z]+$')
+            ```
+
+        === ":white_check_mark: Do this"
+            ```py
+            from typing_extensions import Annotated
+
+            from pydantic import BaseModel, StringConstraints
+
+            class Foo(BaseModel):
+                bar: Annotated[str, StringConstraints(strip_whitespace=True, to_upper=True, pattern=r'^[A-Z]+$')]
+            ```
+
+    A wrapper around `str` that allows for additional constraints.
+
+    ```py
+    from pydantic import BaseModel, constr
+
+    class Foo(BaseModel):
+        bar: constr(strip_whitespace=True, to_upper=True, pattern=r'^[A-Z]+$')
 
 
-if TYPE_CHECKING:
-    StrictStr = str
-else:
+    foo = Foo(bar='  hello  ')
+    print(foo)
+    #> bar='HELLO'
+    ```
 
-    class StrictStr(ConstrainedStr):
-        strict = True
+    Args:
+        strip_whitespace: Whether to remove leading and trailing whitespace.
+        to_upper: Whether to turn all characters to uppercase.
+        to_lower: Whether to turn all characters to lowercase.
+        strict: Whether to validate the string in strict mode.
+        min_length: The minimum length of the string.
+        max_length: The maximum length of the string.
+        pattern: A regex pattern to validate the string against.
+
+    Returns:
+        The wrapped string type.
+    """  # noqa: D212
+    return Annotated[
+        str,
+        StringConstraints(
+            strip_whitespace=strip_whitespace,
+            to_upper=to_upper,
+            to_lower=to_lower,
+            strict=strict,
+            min_length=min_length,
+            max_length=max_length,
+            pattern=pattern,
+        ),
+    ]
 
 
-# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ SET TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-# This types superclass should be Set[T], but cython chokes on that...
-class ConstrainedSet(set):  # type: ignore
-    # Needed for pydantic to detect that this is a set
-    __origin__ = set
-    __args__: Set[Type[T]]  # type: ignore
-
-    min_items: Optional[int] = None
-    max_items: Optional[int] = None
-    item_type: Type[T]  # type: ignore
-
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield cls.set_length_validator
-
-    @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-        update_not_none(field_schema, minItems=cls.min_items, maxItems=cls.max_items)
-
-    @classmethod
-    def set_length_validator(cls, v: 'Optional[Set[T]]') -> 'Optional[Set[T]]':
-        if v is None:
-            return None
-
-        v = set_validator(v)
-        v_len = len(v)
-
-        if cls.min_items is not None and v_len < cls.min_items:
-            raise errors.SetMinLengthError(limit_value=cls.min_items)
-
-        if cls.max_items is not None and v_len > cls.max_items:
-            raise errors.SetMaxLengthError(limit_value=cls.max_items)
-
-        return v
+StrictStr = Annotated[str, Strict()]
+"""A string that must be validated in strict mode."""
 
 
-def conset(item_type: Type[T], *, min_items: int = None, max_items: int = None) -> Type[Set[T]]:
-    # __args__ is needed to conform to typing generics api
-    namespace = {'min_items': min_items, 'max_items': max_items, 'item_type': item_type, '__args__': [item_type]}
-    # We use new_class to be able to deal with Generic types
-    return new_class('ConstrainedSetValue', (ConstrainedSet,), {}, lambda ns: ns.update(namespace))
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~ COLLECTION TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+HashableItemType = TypeVar('HashableItemType', bound=Hashable)
 
 
-# This types superclass should be FrozenSet[T], but cython chokes on that...
-class ConstrainedFrozenSet(frozenset):  # type: ignore
-    # Needed for pydantic to detect that this is a set
-    __origin__ = frozenset
-    __args__: FrozenSet[Type[T]]  # type: ignore
+def conset(
+    item_type: type[HashableItemType], *, min_length: int | None = None, max_length: int | None = None
+) -> type[set[HashableItemType]]:
+    """A wrapper around `typing.Set` that allows for additional constraints.
 
-    min_items: Optional[int] = None
-    max_items: Optional[int] = None
-    item_type: Type[T]  # type: ignore
+    Args:
+        item_type: The type of the items in the set.
+        min_length: The minimum length of the set.
+        max_length: The maximum length of the set.
 
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield cls.frozenset_length_validator
-
-    @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-        update_not_none(field_schema, minItems=cls.min_items, maxItems=cls.max_items)
-
-    @classmethod
-    def frozenset_length_validator(cls, v: 'Optional[FrozenSet[T]]') -> 'Optional[FrozenSet[T]]':
-        if v is None:
-            return None
-
-        v = frozenset_validator(v)
-        v_len = len(v)
-
-        if cls.min_items is not None and v_len < cls.min_items:
-            raise errors.FrozenSetMinLengthError(limit_value=cls.min_items)
-
-        if cls.max_items is not None and v_len > cls.max_items:
-            raise errors.FrozenSetMaxLengthError(limit_value=cls.max_items)
-
-        return v
+    Returns:
+        The wrapped set type.
+    """
+    return Annotated[Set[item_type], annotated_types.Len(min_length or 0, max_length)]
 
 
-def confrozenset(item_type: Type[T], *, min_items: int = None, max_items: int = None) -> Type[FrozenSet[T]]:
-    # __args__ is needed to conform to typing generics api
-    namespace = {'min_items': min_items, 'max_items': max_items, 'item_type': item_type, '__args__': [item_type]}
-    # We use new_class to be able to deal with Generic types
-    return new_class('ConstrainedFrozenSetValue', (ConstrainedFrozenSet,), {}, lambda ns: ns.update(namespace))
+def confrozenset(
+    item_type: type[HashableItemType], *, min_length: int | None = None, max_length: int | None = None
+) -> type[frozenset[HashableItemType]]:
+    """A wrapper around `typing.FrozenSet` that allows for additional constraints.
+
+    Args:
+        item_type: The type of the items in the frozenset.
+        min_length: The minimum length of the frozenset.
+        max_length: The maximum length of the frozenset.
+
+    Returns:
+        The wrapped frozenset type.
+    """
+    return Annotated[FrozenSet[item_type], annotated_types.Len(min_length or 0, max_length)]
 
 
-# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ LIST TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-# This types superclass should be List[T], but cython chokes on that...
-class ConstrainedList(list):  # type: ignore
-    # Needed for pydantic to detect that this is a list
-    __origin__ = list
-    __args__: Tuple[Type[T], ...]  # type: ignore
-
-    min_items: Optional[int] = None
-    max_items: Optional[int] = None
-    unique_items: Optional[bool] = None
-    item_type: Type[T]  # type: ignore
-
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield cls.list_length_validator
-        if cls.unique_items:
-            yield cls.unique_items_validator
-
-    @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-        update_not_none(field_schema, minItems=cls.min_items, maxItems=cls.max_items, uniqueItems=cls.unique_items)
-
-    @classmethod
-    def list_length_validator(cls, v: 'Optional[List[T]]') -> 'Optional[List[T]]':
-        if v is None:
-            return None
-
-        v = list_validator(v)
-        v_len = len(v)
-
-        if cls.min_items is not None and v_len < cls.min_items:
-            raise errors.ListMinLengthError(limit_value=cls.min_items)
-
-        if cls.max_items is not None and v_len > cls.max_items:
-            raise errors.ListMaxLengthError(limit_value=cls.max_items)
-
-        return v
-
-    @classmethod
-    def unique_items_validator(cls, v: 'List[T]') -> 'List[T]':
-        for i, value in enumerate(v, start=1):
-            if value in v[i:]:
-                raise errors.ListUniqueItemsError()
-
-        return v
+AnyItemType = TypeVar('AnyItemType')
 
 
 def conlist(
-    item_type: Type[T], *, min_items: int = None, max_items: int = None, unique_items: bool = None
-) -> Type[List[T]]:
-    # __args__ is needed to conform to typing generics api
-    namespace = dict(
-        min_items=min_items, max_items=max_items, unique_items=unique_items, item_type=item_type, __args__=(item_type,)
-    )
-    # We use new_class to be able to deal with Generic types
-    return new_class('ConstrainedListValue', (ConstrainedList,), {}, lambda ns: ns.update(namespace))
+    item_type: type[AnyItemType],
+    *,
+    min_length: int | None = None,
+    max_length: int | None = None,
+    unique_items: bool | None = None,
+) -> type[list[AnyItemType]]:
+    """A wrapper around typing.List that adds validation.
+
+    Args:
+        item_type: The type of the items in the list.
+        min_length: The minimum length of the list. Defaults to None.
+        max_length: The maximum length of the list. Defaults to None.
+        unique_items: Whether the items in the list must be unique. Defaults to None.
+            !!! warning Deprecated
+                The `unique_items` parameter is deprecated, use `Set` instead.
+                See [this issue](https://github.com/pydantic/pydantic-core/issues/296) for more details.
+
+    Returns:
+        The wrapped list type.
+    """
+    if unique_items is not None:
+        raise PydanticUserError(
+            (
+                '`unique_items` is removed, use `Set` instead'
+                '(this feature is discussed in https://github.com/pydantic/pydantic-core/issues/296)'
+            ),
+            code='removed-kwargs',
+        )
+    return Annotated[List[item_type], annotated_types.Len(min_length or 0, max_length)]
 
 
-# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ PYOBJECT TYPE ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~ IMPORT STRING TYPE ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
+AnyType = TypeVar('AnyType')
 if TYPE_CHECKING:
-    PyObject = Callable[..., Any]
+    ImportString = Annotated[AnyType, ...]
 else:
 
-    class PyObject:
-        validate_always = True
+    class ImportString:
+        """A type that can be used to import a type from a string.
+
+        `ImportString` expects a string and loads the Python object importable at that dotted path.
+        Attributes of modules may be separated from the module by `:` or `.`, e.g. if `'math:cos'` was provided,
+        the resulting field value would be the function`cos`. If a `.` is used and both an attribute and submodule
+        are present at the same path, the module will be preferred.
+
+        On model instantiation, pointers will be evaluated and imported. There is
+        some nuance to this behavior, demonstrated in the examples below.
+
+        **Good behavior:**
+        ```py
+        from math import cos
+
+        from pydantic import BaseModel, Field, ImportString, ValidationError
+
+
+        class ImportThings(BaseModel):
+            obj: ImportString
+
+
+        # A string value will cause an automatic import
+        my_cos = ImportThings(obj='math.cos')
+
+        # You can use the imported function as you would expect
+        cos_of_0 = my_cos.obj(0)
+        assert cos_of_0 == 1
+
+
+        # A string whose value cannot be imported will raise an error
+        try:
+            ImportThings(obj='foo.bar')
+        except ValidationError as e:
+            print(e)
+            '''
+            1 validation error for ImportThings
+            obj
+            Invalid python path: No module named 'foo.bar' [type=import_error, input_value='foo.bar', input_type=str]
+            '''
+
+
+        # Actual python objects can be assigned as well
+        my_cos = ImportThings(obj=cos)
+        my_cos_2 = ImportThings(obj='math.cos')
+        my_cos_3 = ImportThings(obj='math:cos')
+        assert my_cos == my_cos_2 == my_cos_3
+
+
+        # You can set default field value either as Python object:
+        class ImportThingsDefaultPyObj(BaseModel):
+            obj: ImportString = math.cos
+
+
+        # or as a string value (but only if used with `validate_default=True`)
+        class ImportThingsDefaultString(BaseModel):
+            obj: ImportString = Field(default='math.cos', validate_default=True)
+
+
+        my_cos_default1 = ImportThingsDefaultPyObj()
+        my_cos_default2 = ImportThingsDefaultString()
+        assert my_cos_default1.obj == my_cos_default2.obj == math.cos
+
+
+        # note: this will not work!
+        class ImportThingsMissingValidateDefault(BaseModel):
+            obj: ImportString = 'math.cos'
+
+        my_cos_default3 = ImportThingsMissingValidateDefault()
+        assert my_cos_default3.obj == 'math.cos'  # just string, not evaluated
+        ```
+
+        Serializing an `ImportString` type to json is also possible.
+
+        ```py
+        from pydantic import BaseModel, ImportString
+
+
+        class ImportThings(BaseModel):
+            obj: ImportString
+
+
+        # Create an instance
+        m = ImportThings(obj='math.cos')
+        print(m)
+        #> obj=<built-in function cos>
+        print(m.model_dump_json())
+        #> {"obj":"math.cos"}
+        ```
+        """
 
         @classmethod
-        def __get_validators__(cls) -> 'CallableGenerator':
-            yield cls.validate
+        def __class_getitem__(cls, item: AnyType) -> AnyType:
+            return Annotated[item, cls()]
 
         @classmethod
-        def validate(cls, value: Any) -> Any:
-            if isinstance(value, Callable):
-                return value
+        def __get_pydantic_core_schema__(
+            cls, source: type[Any], handler: GetCoreSchemaHandler
+        ) -> core_schema.CoreSchema:
+            serializer = core_schema.plain_serializer_function_ser_schema(cls._serialize, when_used='json')
+            if cls is source:
+                # Treat bare usage of ImportString (`schema is None`) as the same as ImportString[Any]
+                return core_schema.no_info_plain_validator_function(
+                    function=_validators.import_string, serialization=serializer
+                )
+            else:
+                return core_schema.no_info_before_validator_function(
+                    function=_validators.import_string, schema=handler(source), serialization=serializer
+                )
 
-            try:
-                value = str_validator(value)
-            except errors.StrError:
-                raise errors.PyObjectError(error_message='value is neither a valid import path not a valid callable')
+        @staticmethod
+        def _serialize(v: Any) -> str:
+            if isinstance(v, ModuleType):
+                return v.__name__
+            elif hasattr(v, '__module__') and hasattr(v, '__name__'):
+                return f'{v.__module__}.{v.__name__}'
+            else:
+                return v
 
-            try:
-                return import_string(value)
-            except ImportError as e:
-                raise errors.PyObjectError(error_message=str(e))
+        def __repr__(self) -> str:
+            return 'ImportString'
 
 
 # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ DECIMAL TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 
-class ConstrainedDecimal(Decimal, metaclass=ConstrainedNumberMeta):
-    gt: OptionalIntFloatDecimal = None
-    ge: OptionalIntFloatDecimal = None
-    lt: OptionalIntFloatDecimal = None
-    le: OptionalIntFloatDecimal = None
-    max_digits: OptionalInt = None
-    decimal_places: OptionalInt = None
-    multiple_of: OptionalIntFloatDecimal = None
-
-    @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-        update_not_none(
-            field_schema,
-            exclusiveMinimum=cls.gt,
-            exclusiveMaximum=cls.lt,
-            minimum=cls.ge,
-            maximum=cls.le,
-            multipleOf=cls.multiple_of,
-        )
-
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield decimal_validator
-        yield number_size_validator
-        yield number_multiple_validator
-        yield cls.validate
-
-    @classmethod
-    def validate(cls, value: Decimal) -> Decimal:
-        digit_tuple, exponent = value.as_tuple()[1:]
-        if exponent in {'F', 'n', 'N'}:
-            raise errors.DecimalIsNotFiniteError()
-
-        if exponent >= 0:
-            # A positive exponent adds that many trailing zeros.
-            digits = len(digit_tuple) + exponent
-            decimals = 0
-        else:
-            # If the absolute value of the negative exponent is larger than the
-            # number of digits, then it's the same as the number of digits,
-            # because it'll consume all of the digits in digit_tuple and then
-            # add abs(exponent) - len(digit_tuple) leading zeros after the
-            # decimal point.
-            if abs(exponent) > len(digit_tuple):
-                digits = decimals = abs(exponent)
-            else:
-                digits = len(digit_tuple)
-                decimals = abs(exponent)
-        whole_digits = digits - decimals
-
-        if cls.max_digits is not None and digits > cls.max_digits:
-            raise errors.DecimalMaxDigitsError(max_digits=cls.max_digits)
-
-        if cls.decimal_places is not None and decimals > cls.decimal_places:
-            raise errors.DecimalMaxPlacesError(decimal_places=cls.decimal_places)
-
-        if cls.max_digits is not None and cls.decimal_places is not None:
-            expected = cls.max_digits - cls.decimal_places
-            if whole_digits > expected:
-                raise errors.DecimalWholeDigitsError(whole_digits=expected)
-
-        return value
-
-
 def condecimal(
     *,
-    gt: Decimal = None,
-    ge: Decimal = None,
-    lt: Decimal = None,
-    le: Decimal = None,
-    max_digits: int = None,
-    decimal_places: int = None,
-    multiple_of: Decimal = None,
-) -> Type[Decimal]:
-    # use kwargs then define conf in a dict to aid with IDE type hinting
-    namespace = dict(
-        gt=gt, ge=ge, lt=lt, le=le, max_digits=max_digits, decimal_places=decimal_places, multiple_of=multiple_of
-    )
-    return type('ConstrainedDecimalValue', (ConstrainedDecimal,), namespace)
+    strict: bool | None = None,
+    gt: int | Decimal | None = None,
+    ge: int | Decimal | None = None,
+    lt: int | Decimal | None = None,
+    le: int | Decimal | None = None,
+    multiple_of: int | Decimal | None = None,
+    max_digits: int | None = None,
+    decimal_places: int | None = None,
+    allow_inf_nan: bool | None = None,
+) -> type[Decimal]:
+    """
+    !!! warning "Discouraged"
+        This function is **discouraged** in favor of using
+        [`Annotated`](https://docs.python.org/3/library/typing.html#typing.Annotated) with
+        [`Field`][pydantic.fields.Field] instead.
+
+        This function will be **deprecated** in Pydantic 3.0.
+
+        The reason is that `condecimal` returns a type, which doesn't play well with static analysis tools.
+
+        === ":x: Don't do this"
+            ```py
+            from pydantic import BaseModel, condecimal
+
+            class Foo(BaseModel):
+                bar: condecimal(strict=True, allow_inf_nan=True)
+            ```
+
+        === ":white_check_mark: Do this"
+            ```py
+            from decimal import Decimal
+
+            from typing_extensions import Annotated
+
+            from pydantic import BaseModel, Field
+
+            class Foo(BaseModel):
+                bar: Annotated[Decimal, Field(strict=True, allow_inf_nan=True)]
+            ```
+
+    A wrapper around Decimal that adds validation.
+
+    Args:
+        strict: Whether to validate the value in strict mode. Defaults to `None`.
+        gt: The value must be greater than this. Defaults to `None`.
+        ge: The value must be greater than or equal to this. Defaults to `None`.
+        lt: The value must be less than this. Defaults to `None`.
+        le: The value must be less than or equal to this. Defaults to `None`.
+        multiple_of: The value must be a multiple of this. Defaults to `None`.
+        max_digits: The maximum number of digits. Defaults to `None`.
+        decimal_places: The number of decimal places. Defaults to `None`.
+        allow_inf_nan: Whether to allow infinity and NaN. Defaults to `None`.
+
+    ```py
+    from decimal import Decimal
+
+    from pydantic import BaseModel, ValidationError, condecimal
+
+    class ConstrainedExample(BaseModel):
+        constrained_decimal: condecimal(gt=Decimal('1.0'))
+
+    m = ConstrainedExample(constrained_decimal=Decimal('1.1'))
+    print(repr(m))
+    #> ConstrainedExample(constrained_decimal=Decimal('1.1'))
+
+    try:
+        ConstrainedExample(constrained_decimal=Decimal('0.9'))
+    except ValidationError as e:
+        print(e.errors())
+        '''
+        [
+            {
+                'type': 'greater_than',
+                'loc': ('constrained_decimal',),
+                'msg': 'Input should be greater than 1.0',
+                'input': Decimal('0.9'),
+                'ctx': {'gt': Decimal('1.0')},
+                'url': 'https://errors.pydantic.dev/2/v/greater_than',
+            }
+        ]
+        '''
+    ```
+    """  # noqa: D212
+    return Annotated[
+        Decimal,
+        Strict(strict) if strict is not None else None,
+        annotated_types.Interval(gt=gt, ge=ge, lt=lt, le=le),
+        annotated_types.MultipleOf(multiple_of) if multiple_of is not None else None,
+        _fields.pydantic_general_metadata(max_digits=max_digits, decimal_places=decimal_places),
+        AllowInfNan(allow_inf_nan) if allow_inf_nan is not None else None,
+    ]
 
 
 # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ UUID TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-if TYPE_CHECKING:
-    UUID1 = UUID
-    UUID3 = UUID
-    UUID4 = UUID
-    UUID5 = UUID
-else:
 
-    class UUID1(UUID):
-        _required_version = 1
+@_dataclasses.dataclass(**_internal_dataclass.slots_true)
+class UuidVersion:
+    """A field metadata class to indicate a [UUID](https://docs.python.org/3/library/uuid.html) version."""
 
-        @classmethod
-        def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-            field_schema.update(type='string', format=f'uuid{cls._required_version}')
+    uuid_version: Literal[1, 3, 4, 5]
 
-    class UUID3(UUID1):
-        _required_version = 3
+    def __get_pydantic_json_schema__(
+        self, core_schema: core_schema.CoreSchema, handler: GetJsonSchemaHandler
+    ) -> JsonSchemaValue:
+        field_schema = handler(core_schema)
+        field_schema.pop('anyOf', None)  # remove the bytes/str union
+        field_schema.update(type='string', format=f'uuid{self.uuid_version}')
+        return field_schema
 
-    class UUID4(UUID1):
-        _required_version = 4
+    def __get_pydantic_core_schema__(self, source: Any, handler: GetCoreSchemaHandler) -> core_schema.CoreSchema:
+        if isinstance(self, source):
+            # used directly as a type
+            return core_schema.uuid_schema(version=self.uuid_version)
+        else:
+            # update existing schema with self.uuid_version
+            schema = handler(source)
+            _check_annotated_type(schema['type'], 'uuid', self.__class__.__name__)
+            schema['version'] = self.uuid_version  # type: ignore
+            return schema
 
-    class UUID5(UUID1):
-        _required_version = 5
+    def __hash__(self) -> int:
+        return hash(type(self.uuid_version))
+
+
+UUID1 = Annotated[UUID, UuidVersion(1)]
+"""A [UUID](https://docs.python.org/3/library/uuid.html) that must be version 1.
+
+```py
+import uuid
+
+from pydantic import UUID1, BaseModel
+
+class Model(BaseModel):
+    uuid1: UUID1
+
+Model(uuid1=uuid.uuid1())
+```
+"""
+UUID3 = Annotated[UUID, UuidVersion(3)]
+"""A [UUID](https://docs.python.org/3/library/uuid.html) that must be version 3.
+
+```py
+import uuid
+
+from pydantic import UUID3, BaseModel
+
+class Model(BaseModel):
+    uuid3: UUID3
+
+Model(uuid3=uuid.uuid3(uuid.NAMESPACE_DNS, 'pydantic.org'))
+```
+"""
+UUID4 = Annotated[UUID, UuidVersion(4)]
+"""A [UUID](https://docs.python.org/3/library/uuid.html) that must be version 4.
+
+```py
+import uuid
+
+from pydantic import UUID4, BaseModel
+
+class Model(BaseModel):
+    uuid4: UUID4
+
+Model(uuid4=uuid.uuid4())
+```
+"""
+UUID5 = Annotated[UUID, UuidVersion(5)]
+"""A [UUID](https://docs.python.org/3/library/uuid.html) that must be version 5.
+
+```py
+import uuid
+
+from pydantic import UUID5, BaseModel
+
+class Model(BaseModel):
+    uuid5: UUID5
+
+Model(uuid5=uuid.uuid5(uuid.NAMESPACE_DNS, 'pydantic.org'))
+```
+"""
 
 
 # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ PATH TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-if TYPE_CHECKING:
-    FilePath = Path
-    DirectoryPath = Path
-else:
 
-    class FilePath(Path):
-        @classmethod
-        def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-            field_schema.update(format='file-path')
+@_dataclasses.dataclass
+class PathType:
+    path_type: Literal['file', 'dir', 'new']
 
-        @classmethod
-        def __get_validators__(cls) -> 'CallableGenerator':
-            yield path_validator
-            yield path_exists_validator
-            yield cls.validate
+    def __get_pydantic_json_schema__(
+        self, core_schema: core_schema.CoreSchema, handler: GetJsonSchemaHandler
+    ) -> JsonSchemaValue:
+        field_schema = handler(core_schema)
+        format_conversion = {'file': 'file-path', 'dir': 'directory-path'}
+        field_schema.update(format=format_conversion.get(self.path_type, 'path'), type='string')
+        return field_schema
 
-        @classmethod
-        def validate(cls, value: Path) -> Path:
-            if not value.is_file():
-                raise errors.PathNotAFileError(path=value)
+    def __get_pydantic_core_schema__(self, source: Any, handler: GetCoreSchemaHandler) -> core_schema.CoreSchema:
+        function_lookup = {
+            'file': cast(core_schema.WithInfoValidatorFunction, self.validate_file),
+            'dir': cast(core_schema.WithInfoValidatorFunction, self.validate_directory),
+            'new': cast(core_schema.WithInfoValidatorFunction, self.validate_new),
+        }
 
-            return value
+        return core_schema.with_info_after_validator_function(
+            function_lookup[self.path_type],
+            handler(source),
+        )
 
-    class DirectoryPath(Path):
-        @classmethod
-        def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-            field_schema.update(format='directory-path')
+    @staticmethod
+    def validate_file(path: Path, _: core_schema.ValidationInfo) -> Path:
+        if path.is_file():
+            return path
+        else:
+            raise PydanticCustomError('path_not_file', 'Path does not point to a file')
 
-        @classmethod
-        def __get_validators__(cls) -> 'CallableGenerator':
-            yield path_validator
-            yield path_exists_validator
-            yield cls.validate
+    @staticmethod
+    def validate_directory(path: Path, _: core_schema.ValidationInfo) -> Path:
+        if path.is_dir():
+            return path
+        else:
+            raise PydanticCustomError('path_not_directory', 'Path does not point to a directory')
 
-        @classmethod
-        def validate(cls, value: Path) -> Path:
-            if not value.is_dir():
-                raise errors.PathNotADirectoryError(path=value)
+    @staticmethod
+    def validate_new(path: Path, _: core_schema.ValidationInfo) -> Path:
+        if path.exists():
+            raise PydanticCustomError('path_exists', 'Path already exists')
+        elif not path.parent.exists():
+            raise PydanticCustomError('parent_does_not_exist', 'Parent directory does not exist')
+        else:
+            return path
 
-            return value
+    def __hash__(self) -> int:
+        return hash(type(self.path_type))
+
+
+FilePath = Annotated[Path, PathType('file')]
+"""A path that must point to a file.
+
+```py
+from pathlib import Path
+
+from pydantic import BaseModel, FilePath, ValidationError
+
+class Model(BaseModel):
+    f: FilePath
+
+path = Path('text.txt')
+path.touch()
+m = Model(f='text.txt')
+print(m.model_dump())
+#> {'f': PosixPath('text.txt')}
+path.unlink()
+
+path = Path('directory')
+path.mkdir(exist_ok=True)
+try:
+    Model(f='directory')  # directory
+except ValidationError as e:
+    print(e)
+    '''
+    1 validation error for Model
+    f
+      Path does not point to a file [type=path_not_file, input_value='directory', input_type=str]
+    '''
+path.rmdir()
+
+try:
+    Model(f='not-exists-file')
+except ValidationError as e:
+    print(e)
+    '''
+    1 validation error for Model
+    f
+      Path does not point to a file [type=path_not_file, input_value='not-exists-file', input_type=str]
+    '''
+```
+"""
+DirectoryPath = Annotated[Path, PathType('dir')]
+"""A path that must point to a directory.
+
+```py
+from pathlib import Path
+
+from pydantic import BaseModel, DirectoryPath, ValidationError
+
+class Model(BaseModel):
+    f: DirectoryPath
+
+path = Path('directory/')
+path.mkdir()
+m = Model(f='directory/')
+print(m.model_dump())
+#> {'f': PosixPath('directory')}
+path.rmdir()
+
+path = Path('file.txt')
+path.touch()
+try:
+    Model(f='file.txt')  # file
+except ValidationError as e:
+    print(e)
+    '''
+    1 validation error for Model
+    f
+      Path does not point to a directory [type=path_not_directory, input_value='file.txt', input_type=str]
+    '''
+path.unlink()
+
+try:
+    Model(f='not-exists-directory')
+except ValidationError as e:
+    print(e)
+    '''
+    1 validation error for Model
+    f
+      Path does not point to a directory [type=path_not_directory, input_value='not-exists-directory', input_type=str]
+    '''
+```
+"""
+NewPath = Annotated[Path, PathType('new')]
+"""A path for a new file or directory that must not already exist."""
 
 
 # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ JSON TYPE ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-
-class JsonWrapper:
-    pass
-
-
-class JsonMeta(type):
-    def __getitem__(self, t: Type[Any]) -> Type[JsonWrapper]:
-        if t is Any:
-            return Json  # allow Json[Any] to replecate plain Json
-        return _registered(type('JsonWrapperValue', (JsonWrapper,), {'inner_type': t}))
-
-
 if TYPE_CHECKING:
-    Json = Annotated[T, ...]  # Json[list[str]] will be recognized by type checkers as list[str]
+    Json = Annotated[AnyType, ...]  # Json[list[str]] will be recognized by type checkers as list[str]
 
 else:
 
-    class Json(metaclass=JsonMeta):
+    class Json:
+        """A special type wrapper which loads JSON before parsing.
+
+        You can use the `Json` data type to make Pydantic first load a raw JSON string before
+        validating the loaded data into the parametrized type:
+
+        ```py
+        from typing import Any, List
+
+        from pydantic import BaseModel, Json, ValidationError
+
+
+        class AnyJsonModel(BaseModel):
+            json_obj: Json[Any]
+
+
+        class ConstrainedJsonModel(BaseModel):
+            json_obj: Json[List[int]]
+
+
+        print(AnyJsonModel(json_obj='{"b": 1}'))
+        #> json_obj={'b': 1}
+        print(ConstrainedJsonModel(json_obj='[1, 2, 3]'))
+        #> json_obj=[1, 2, 3]
+
+        try:
+            ConstrainedJsonModel(json_obj=12)
+        except ValidationError as e:
+            print(e)
+            '''
+            1 validation error for ConstrainedJsonModel
+            json_obj
+            JSON input should be string, bytes or bytearray [type=json_type, input_value=12, input_type=int]
+            '''
+
+        try:
+            ConstrainedJsonModel(json_obj='[a, b]')
+        except ValidationError as e:
+            print(e)
+            '''
+            1 validation error for ConstrainedJsonModel
+            json_obj
+            Invalid JSON: expected value at line 1 column 2 [type=json_invalid, input_value='[a, b]', input_type=str]
+            '''
+
+        try:
+            ConstrainedJsonModel(json_obj='["a", "b"]')
+        except ValidationError as e:
+            print(e)
+            '''
+            2 validation errors for ConstrainedJsonModel
+            json_obj.0
+            Input should be a valid integer, unable to parse string as an integer [type=int_parsing, input_value='a', input_type=str]
+            json_obj.1
+            Input should be a valid integer, unable to parse string as an integer [type=int_parsing, input_value='b', input_type=str]
+            '''
+        ```
+
+        When you dump the model using `model_dump` or `model_dump_json`, the dumped value will be the result of validation,
+        not the original JSON string. However, you can use the argument `round_trip=True` to get the original JSON string back:
+
+        ```py
+        from typing import List
+
+        from pydantic import BaseModel, Json
+
+
+        class ConstrainedJsonModel(BaseModel):
+            json_obj: Json[List[int]]
+
+
+        print(ConstrainedJsonModel(json_obj='[1, 2, 3]').model_dump_json())
+        #> {"json_obj":[1,2,3]}
+        print(
+            ConstrainedJsonModel(json_obj='[1, 2, 3]').model_dump_json(round_trip=True)
+        )
+        #> {"json_obj":"[1,2,3]"}
+        ```
+        """
+
         @classmethod
-        def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-            field_schema.update(type='string', format='json-string')
+        def __class_getitem__(cls, item: AnyType) -> AnyType:
+            return Annotated[item, cls()]
+
+        @classmethod
+        def __get_pydantic_core_schema__(cls, source: Any, handler: GetCoreSchemaHandler) -> core_schema.CoreSchema:
+            if cls is source:
+                return core_schema.json_schema(None)
+            else:
+                return core_schema.json_schema(handler(source))
+
+        def __repr__(self) -> str:
+            return 'Json'
+
+        def __hash__(self) -> int:
+            return hash(type(self))
+
+        def __eq__(self, other: Any) -> bool:
+            return type(other) == type(self)
 
 
 # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ SECRET TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
+SecretType = TypeVar('SecretType', str, bytes)
 
-class SecretField(abc.ABC):
-    """
-    Note: this should be implemented as a generic like `SecretField(ABC, Generic[T])`,
-          the `__init__()` should be part of the abstract class and the
-          `get_secret_value()` method should use the generic `T` type.
 
-          However Cython doesn't support very well generics at the moment and
-          the generated code fails to be imported (see
-          https://github.com/cython/cython/issues/2753).
-    """
+class _SecretField(Generic[SecretType]):
+    def __init__(self, secret_value: SecretType) -> None:
+        self._secret_value: SecretType = secret_value
+
+    def get_secret_value(self) -> SecretType:
+        """Get the secret value.
+
+        Returns:
+            The secret value.
+        """
+        return self._secret_value
 
     def __eq__(self, other: Any) -> bool:
         return isinstance(other, self.__class__) and self.get_secret_value() == other.get_secret_value()
 
-    def __str__(self) -> str:
-        return '**********' if self.get_secret_value() else ''
-
     def __hash__(self) -> int:
         return hash(self.get_secret_value())
 
-    @abc.abstractmethod
-    def get_secret_value(self) -> Any:  # pragma: no cover
-        ...
-
-
-class SecretStr(SecretField):
-    min_length: OptionalInt = None
-    max_length: OptionalInt = None
-
-    @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-        update_not_none(
-            field_schema,
-            type='string',
-            writeOnly=True,
-            format='password',
-            minLength=cls.min_length,
-            maxLength=cls.max_length,
-        )
-
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield cls.validate
-        yield constr_length_validator
-
-    @classmethod
-    def validate(cls, value: Any) -> 'SecretStr':
-        if isinstance(value, cls):
-            return value
-        value = str_validator(value)
-        return cls(value)
-
-    def __init__(self, value: str):
-        self._secret_value = value
-
-    def __repr__(self) -> str:
-        return f"SecretStr('{self}')"
-
     def __len__(self) -> int:
         return len(self._secret_value)
 
-    def display(self) -> str:
-        warnings.warn('`secret_str.display()` is deprecated, use `str(secret_str)` instead', DeprecationWarning)
-        return str(self)
-
-    def get_secret_value(self) -> str:
-        return self._secret_value
-
-
-class SecretBytes(SecretField):
-    min_length: OptionalInt = None
-    max_length: OptionalInt = None
-
-    @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-        update_not_none(
-            field_schema,
-            type='string',
-            writeOnly=True,
-            format='password',
-            minLength=cls.min_length,
-            maxLength=cls.max_length,
-        )
-
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield cls.validate
-        yield constr_length_validator
-
-    @classmethod
-    def validate(cls, value: Any) -> 'SecretBytes':
-        if isinstance(value, cls):
-            return value
-        value = bytes_validator(value)
-        return cls(value)
-
-    def __init__(self, value: bytes):
-        self._secret_value = value
+    def __str__(self) -> str:
+        return str(self._display())
 
     def __repr__(self) -> str:
-        return f"SecretBytes(b'{self}')"
+        return f'{self.__class__.__name__}({self._display()!r})'
 
-    def __len__(self) -> int:
-        return len(self._secret_value)
+    def _display(self) -> SecretType:
+        raise NotImplementedError
 
-    def display(self) -> str:
-        warnings.warn('`secret_bytes.display()` is deprecated, use `str(secret_bytes)` instead', DeprecationWarning)
-        return str(self)
+    @classmethod
+    def __get_pydantic_core_schema__(cls, source: type[Any], handler: GetCoreSchemaHandler) -> core_schema.CoreSchema:
+        if issubclass(source, SecretStr):
+            field_type = str
+            inner_schema = core_schema.str_schema()
+        else:
+            assert issubclass(source, SecretBytes)
+            field_type = bytes
+            inner_schema = core_schema.bytes_schema()
+        error_kind = 'string_type' if field_type is str else 'bytes_type'
 
-    def get_secret_value(self) -> bytes:
-        return self._secret_value
+        def serialize(
+            value: _SecretField[SecretType], info: core_schema.SerializationInfo
+        ) -> str | _SecretField[SecretType]:
+            if info.mode == 'json':
+                # we want the output to always be string without the `b'` prefix for bytes,
+                # hence we just use `secret_display`
+                return _secret_display(value.get_secret_value())
+            else:
+                return value
+
+        def get_json_schema(_core_schema: core_schema.CoreSchema, handler: GetJsonSchemaHandler) -> JsonSchemaValue:
+            json_schema = handler(inner_schema)
+            _utils.update_not_none(
+                json_schema,
+                type='string',
+                writeOnly=True,
+                format='password',
+            )
+            return json_schema
+
+        json_schema = core_schema.no_info_after_validator_function(
+            source,  # construct the type
+            inner_schema,
+        )
+        s = core_schema.json_or_python_schema(
+            python_schema=core_schema.union_schema(
+                [
+                    core_schema.is_instance_schema(source),
+                    json_schema,
+                ],
+                strict=True,
+                custom_error_type=error_kind,
+            ),
+            json_schema=json_schema,
+            serialization=core_schema.plain_serializer_function_ser_schema(
+                serialize,
+                info_arg=True,
+                return_schema=core_schema.str_schema(),
+                when_used='json',
+            ),
+        )
+        s.setdefault('metadata', {}).setdefault('pydantic_js_functions', []).append(get_json_schema)
+        return s
+
+
+def _secret_display(value: str | bytes) -> str:
+    return '**********' if value else ''
+
+
+class SecretStr(_SecretField[str]):
+    """A string used for storing sensitive information that you do not want to be visible in logging or tracebacks.
+
+    When the secret value is nonempty, it is displayed as `'**********'` instead of the underlying value in
+    calls to `repr()` and `str()`. If the value _is_ empty, it is displayed as `''`.
+
+    ```py
+    from pydantic import BaseModel, SecretStr
+
+    class User(BaseModel):
+        username: str
+        password: SecretStr
+
+    user = User(username='scolvin', password='password1')
+
+    print(user)
+    #> username='scolvin' password=SecretStr('**********')
+    print(user.password.get_secret_value())
+    #> password1
+    print((SecretStr('password'), SecretStr('')))
+    #> (SecretStr('**********'), SecretStr(''))
+    ```
+    """
+
+    def _display(self) -> str:
+        return _secret_display(self.get_secret_value())
+
+
+class SecretBytes(_SecretField[bytes]):
+    """A bytes used for storing sensitive information that you do not want to be visible in logging or tracebacks.
+
+    It displays `b'**********'` instead of the string value on `repr()` and `str()` calls.
+    When the secret value is nonempty, it is displayed as `b'**********'` instead of the underlying value in
+    calls to `repr()` and `str()`. If the value _is_ empty, it is displayed as `b''`.
+
+    ```py
+    from pydantic import BaseModel, SecretBytes
+
+    class User(BaseModel):
+        username: str
+        password: SecretBytes
+
+    user = User(username='scolvin', password=b'password1')
+    #> username='scolvin' password=SecretBytes(b'**********')
+    print(user.password.get_secret_value())
+    #> b'password1'
+    print((SecretBytes(b'password'), SecretBytes(b'')))
+    #> (SecretBytes(b'**********'), SecretBytes(b''))
+    ```
+    """
+
+    def _display(self) -> bytes:
+        return _secret_display(self.get_secret_value()).encode()
 
 
 # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ PAYMENT CARD TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 
 class PaymentCardBrand(str, Enum):
-    # If you add another card type, please also add it to the
-    # Hypothesis strategy in `pydantic._hypothesis_plugin`.
     amex = 'American Express'
     mastercard = 'Mastercard'
     visa = 'Visa'
@@ -954,10 +1600,13 @@ class PaymentCardBrand(str, Enum):
         return self.value
 
 
+@deprecated(
+    'The `PaymentCardNumber` class is deprecated, use `pydantic_extra_types` instead. '
+    'See https://docs.pydantic.dev/latest/api/pydantic_extra_types_payment/#pydantic_extra_types.payment.PaymentCardNumber.',
+    category=PydanticDeprecatedSince20,
+)
 class PaymentCardNumber(str):
-    """
-    Based on: https://en.wikipedia.org/wiki/Payment_card_number
-    """
+    """Based on: https://en.wikipedia.org/wiki/Payment_card_number."""
 
     strip_whitespace: ClassVar[bool] = True
     min_length: ClassVar[int] = 12
@@ -967,36 +1616,47 @@ class PaymentCardNumber(str):
     brand: PaymentCardBrand
 
     def __init__(self, card_number: str):
+        self.validate_digits(card_number)
+
+        card_number = self.validate_luhn_check_digit(card_number)
+
         self.bin = card_number[:6]
         self.last4 = card_number[-4:]
-        self.brand = self._get_brand(card_number)
+        self.brand = self.validate_brand(card_number)
 
     @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield str_validator
-        yield constr_strip_whitespace
-        yield constr_length_validator
-        yield cls.validate_digits
-        yield cls.validate_luhn_check_digit
-        yield cls
-        yield cls.validate_length_for_brand
+    def __get_pydantic_core_schema__(cls, source: type[Any], handler: GetCoreSchemaHandler) -> core_schema.CoreSchema:
+        return core_schema.with_info_after_validator_function(
+            cls.validate,
+            core_schema.str_schema(
+                min_length=cls.min_length, max_length=cls.max_length, strip_whitespace=cls.strip_whitespace
+            ),
+        )
+
+    @classmethod
+    def validate(cls, __input_value: str, _: core_schema.ValidationInfo) -> PaymentCardNumber:
+        """Validate the card number and return a `PaymentCardNumber` instance."""
+        return cls(__input_value)
 
     @property
     def masked(self) -> str:
+        """Mask all but the last 4 digits of the card number.
+
+        Returns:
+            A masked card number string.
+        """
         num_masked = len(self) - 10  # len(bin) + len(last4) == 10
         return f'{self.bin}{"*" * num_masked}{self.last4}'
 
     @classmethod
-    def validate_digits(cls, card_number: str) -> str:
+    def validate_digits(cls, card_number: str) -> None:
+        """Validate that the card number is all digits."""
         if not card_number.isdigit():
-            raise errors.NotDigitError
-        return card_number
+            raise PydanticCustomError('payment_card_number_digits', 'Card number is not all digits')
 
     @classmethod
     def validate_luhn_check_digit(cls, card_number: str) -> str:
-        """
-        Based on: https://en.wikipedia.org/wiki/Luhn_algorithm
-        """
+        """Based on: https://en.wikipedia.org/wiki/Luhn_algorithm."""
         sum_ = int(card_number[-1])
         length = len(card_number)
         parity = length % 2
@@ -1009,33 +1669,14 @@ class PaymentCardNumber(str):
             sum_ += digit
         valid = sum_ % 10 == 0
         if not valid:
-            raise errors.LuhnValidationError
-        return card_number
-
-    @classmethod
-    def validate_length_for_brand(cls, card_number: 'PaymentCardNumber') -> 'PaymentCardNumber':
-        """
-        Validate length based on BIN for major brands:
-        https://en.wikipedia.org/wiki/Payment_card_number#Issuer_identification_number_(IIN)
-        """
-        required_length: Union[None, int, str] = None
-        if card_number.brand in PaymentCardBrand.mastercard:
-            required_length = 16
-            valid = len(card_number) == required_length
-        elif card_number.brand == PaymentCardBrand.visa:
-            required_length = '13, 16 or 19'
-            valid = len(card_number) in {13, 16, 19}
-        elif card_number.brand == PaymentCardBrand.amex:
-            required_length = 15
-            valid = len(card_number) == required_length
-        else:
-            valid = True
-        if not valid:
-            raise errors.InvalidLengthForBrand(brand=card_number.brand, required_length=required_length)
+            raise PydanticCustomError('payment_card_number_luhn', 'Card number is not luhn valid')
         return card_number
 
     @staticmethod
-    def _get_brand(card_number: str) -> PaymentCardBrand:
+    def validate_brand(card_number: str) -> PaymentCardBrand:
+        """Validate length based on BIN for major brands:
+        https://en.wikipedia.org/wiki/Payment_card_number#Issuer_identification_number_(IIN).
+        """
         if card_number[0] == '4':
             brand = PaymentCardBrand.visa
         elif 51 <= int(card_number[:2]) <= 55:
@@ -1044,144 +1685,1195 @@ class PaymentCardNumber(str):
             brand = PaymentCardBrand.amex
         else:
             brand = PaymentCardBrand.other
+
+        required_length: None | int | str = None
+        if brand in PaymentCardBrand.mastercard:
+            required_length = 16
+            valid = len(card_number) == required_length
+        elif brand == PaymentCardBrand.visa:
+            required_length = '13, 16 or 19'
+            valid = len(card_number) in {13, 16, 19}
+        elif brand == PaymentCardBrand.amex:
+            required_length = 15
+            valid = len(card_number) == required_length
+        else:
+            valid = True
+
+        if not valid:
+            raise PydanticCustomError(
+                'payment_card_number_brand',
+                'Length for a {brand} card must be {required_length}',
+                {'brand': brand, 'required_length': required_length},
+            )
         return brand
 
 
 # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ BYTE SIZE TYPE ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-BYTE_SIZES = {
-    'b': 1,
-    'kb': 10**3,
-    'mb': 10**6,
-    'gb': 10**9,
-    'tb': 10**12,
-    'pb': 10**15,
-    'eb': 10**18,
-    'kib': 2**10,
-    'mib': 2**20,
-    'gib': 2**30,
-    'tib': 2**40,
-    'pib': 2**50,
-    'eib': 2**60,
-}
-BYTE_SIZES.update({k.lower()[0]: v for k, v in BYTE_SIZES.items() if 'i' not in k})
-byte_string_re = re.compile(r'^\s*(\d*\.?\d+)\s*(\w+)?', re.IGNORECASE)
-
 
 class ByteSize(int):
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield cls.validate
+    """Converts a string representing a number of bytes with units (such as `'1KB'` or `'11.5MiB'`) into an integer.
+
+    You can use the `ByteSize` data type to (case-insensitively) convert a string representation of a number of bytes into
+    an integer, and also to print out human-readable strings representing a number of bytes.
+
+    In conformance with [IEC 80000-13 Standard](https://en.wikipedia.org/wiki/ISO/IEC_80000) we interpret `'1KB'` to mean 1000 bytes,
+    and `'1KiB'` to mean 1024 bytes. In general, including a middle `'i'` will cause the unit to be interpreted as a power of 2,
+    rather than a power of 10 (so, for example, `'1 MB'` is treated as `1_000_000` bytes, whereas `'1 MiB'` is treated as `1_048_576` bytes).
+
+    !!! info
+        Note that `1b` will be parsed as "1 byte" and not "1 bit".
+
+    ```py
+    from pydantic import BaseModel, ByteSize
+
+    class MyModel(BaseModel):
+        size: ByteSize
+
+    print(MyModel(size=52000).size)
+    #> 52000
+    print(MyModel(size='3000 KiB').size)
+    #> 3072000
+
+    m = MyModel(size='50 PB')
+    print(m.size.human_readable())
+    #> 44.4PiB
+    print(m.size.human_readable(decimal=True))
+    #> 50.0PB
+
+    print(m.size.to('TiB'))
+    #> 45474.73508864641
+    ```
+    """
+
+    byte_sizes = {
+        'b': 1,
+        'kb': 10**3,
+        'mb': 10**6,
+        'gb': 10**9,
+        'tb': 10**12,
+        'pb': 10**15,
+        'eb': 10**18,
+        'kib': 2**10,
+        'mib': 2**20,
+        'gib': 2**30,
+        'tib': 2**40,
+        'pib': 2**50,
+        'eib': 2**60,
+        'bit': 1 / 8,
+        'kbit': 10**3 / 8,
+        'mbit': 10**6 / 8,
+        'gbit': 10**9 / 8,
+        'tbit': 10**12 / 8,
+        'pbit': 10**15 / 8,
+        'ebit': 10**18 / 8,
+        'kibit': 2**10 / 8,
+        'mibit': 2**20 / 8,
+        'gibit': 2**30 / 8,
+        'tibit': 2**40 / 8,
+        'pibit': 2**50 / 8,
+        'eibit': 2**60 / 8,
+    }
+    byte_sizes.update({k.lower()[0]: v for k, v in byte_sizes.items() if 'i' not in k})
+
+    byte_string_pattern = r'^\s*(\d*\.?\d+)\s*(\w+)?'
+    byte_string_re = re.compile(byte_string_pattern, re.IGNORECASE)
 
     @classmethod
-    def validate(cls, v: StrIntFloat) -> 'ByteSize':
+    def __get_pydantic_core_schema__(cls, source: type[Any], handler: GetCoreSchemaHandler) -> core_schema.CoreSchema:
+        return core_schema.with_info_after_validator_function(
+            function=cls._validate,
+            schema=core_schema.union_schema(
+                [
+                    core_schema.str_schema(pattern=cls.byte_string_pattern),
+                    core_schema.int_schema(ge=0),
+                ],
+                custom_error_type='byte_size',
+                custom_error_message='could not parse value and unit from byte string',
+            ),
+            serialization=core_schema.plain_serializer_function_ser_schema(
+                int, return_schema=core_schema.int_schema(ge=0)
+            ),
+        )
 
+    @classmethod
+    def _validate(cls, __input_value: Any, _: core_schema.ValidationInfo) -> ByteSize:
         try:
-            return cls(int(v))
+            return cls(int(__input_value))
         except ValueError:
             pass
 
-        str_match = byte_string_re.match(str(v))
+        str_match = cls.byte_string_re.match(str(__input_value))
         if str_match is None:
-            raise errors.InvalidByteSize()
+            raise PydanticCustomError('byte_size', 'could not parse value and unit from byte string')
 
         scalar, unit = str_match.groups()
         if unit is None:
             unit = 'b'
 
         try:
-            unit_mult = BYTE_SIZES[unit.lower()]
+            unit_mult = cls.byte_sizes[unit.lower()]
         except KeyError:
-            raise errors.InvalidByteSizeUnit(unit=unit)
+            raise PydanticCustomError('byte_size_unit', 'could not interpret byte unit: {unit}', {'unit': unit})
 
         return cls(int(float(scalar) * unit_mult))
 
     def human_readable(self, decimal: bool = False) -> str:
+        """Converts a byte size to a human readable string.
 
+        Args:
+            decimal: If True, use decimal units (e.g. 1000 bytes per KB). If False, use binary units
+                (e.g. 1024 bytes per KiB).
+
+        Returns:
+            A human readable string representation of the byte size.
+        """
         if decimal:
             divisor = 1000
-            units = ['B', 'KB', 'MB', 'GB', 'TB', 'PB']
+            units = 'B', 'KB', 'MB', 'GB', 'TB', 'PB'
             final_unit = 'EB'
         else:
             divisor = 1024
-            units = ['B', 'KiB', 'MiB', 'GiB', 'TiB', 'PiB']
+            units = 'B', 'KiB', 'MiB', 'GiB', 'TiB', 'PiB'
             final_unit = 'EiB'
 
         num = float(self)
         for unit in units:
             if abs(num) < divisor:
-                return f'{num:0.1f}{unit}'
+                if unit == 'B':
+                    return f'{num:0.0f}{unit}'
+                else:
+                    return f'{num:0.1f}{unit}'
             num /= divisor
 
         return f'{num:0.1f}{final_unit}'
 
     def to(self, unit: str) -> float:
+        """Converts a byte size to another unit, including both byte and bit units.
 
+        Args:
+            unit: The unit to convert to. Must be one of the following: B, KB, MB, GB, TB, PB, EB,
+                KiB, MiB, GiB, TiB, PiB, EiB (byte units) and
+                bit, kbit, mbit, gbit, tbit, pbit, ebit,
+                kibit, mibit, gibit, tibit, pibit, eibit (bit units).
+
+        Returns:
+            The byte size in the new unit.
+        """
         try:
-            unit_div = BYTE_SIZES[unit.lower()]
+            unit_div = self.byte_sizes[unit.lower()]
         except KeyError:
-            raise errors.InvalidByteSizeUnit(unit=unit)
+            raise PydanticCustomError('byte_size_unit', 'Could not interpret byte unit: {unit}', {'unit': unit})
 
         return self / unit_div
 
 
 # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ DATE TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
+
+def _check_annotated_type(annotated_type: str, expected_type: str, annotation: str) -> None:
+    if annotated_type != expected_type:
+        raise PydanticUserError(f"'{annotation}' cannot annotate '{annotated_type}'.", code='invalid_annotated_type')
+
+
 if TYPE_CHECKING:
-    PastDate = date
-    FutureDate = date
+    PastDate = Annotated[date, ...]
+    FutureDate = Annotated[date, ...]
 else:
 
-    class PastDate(date):
-        @classmethod
-        def __get_validators__(cls) -> 'CallableGenerator':
-            yield parse_date
-            yield cls.validate
+    class PastDate:
+        """A date in the past."""
 
         @classmethod
-        def validate(cls, value: date) -> date:
-            if value >= date.today():
-                raise errors.DateNotInThePastError()
+        def __get_pydantic_core_schema__(
+            cls, source: type[Any], handler: GetCoreSchemaHandler
+        ) -> core_schema.CoreSchema:
+            if cls is source:
+                # used directly as a type
+                return core_schema.date_schema(now_op='past')
+            else:
+                schema = handler(source)
+                _check_annotated_type(schema['type'], 'date', cls.__name__)
+                schema['now_op'] = 'past'
+                return schema
 
-            return value
+        def __repr__(self) -> str:
+            return 'PastDate'
 
-    class FutureDate(date):
-        @classmethod
-        def __get_validators__(cls) -> 'CallableGenerator':
-            yield parse_date
-            yield cls.validate
+    class FutureDate:
+        """A date in the future."""
 
         @classmethod
-        def validate(cls, value: date) -> date:
-            if value <= date.today():
-                raise errors.DateNotInTheFutureError()
+        def __get_pydantic_core_schema__(
+            cls, source: type[Any], handler: GetCoreSchemaHandler
+        ) -> core_schema.CoreSchema:
+            if cls is source:
+                # used directly as a type
+                return core_schema.date_schema(now_op='future')
+            else:
+                schema = handler(source)
+                _check_annotated_type(schema['type'], 'date', cls.__name__)
+                schema['now_op'] = 'future'
+                return schema
 
-            return value
-
-
-class ConstrainedDate(date, metaclass=ConstrainedNumberMeta):
-    gt: OptionalDate = None
-    ge: OptionalDate = None
-    lt: OptionalDate = None
-    le: OptionalDate = None
-
-    @classmethod
-    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
-        update_not_none(field_schema, exclusiveMinimum=cls.gt, exclusiveMaximum=cls.lt, minimum=cls.ge, maximum=cls.le)
-
-    @classmethod
-    def __get_validators__(cls) -> 'CallableGenerator':
-        yield parse_date
-        yield number_size_validator
+        def __repr__(self) -> str:
+            return 'FutureDate'
 
 
 def condate(
     *,
-    gt: date = None,
-    ge: date = None,
-    lt: date = None,
-    le: date = None,
-) -> Type[date]:
-    # use kwargs then define conf in a dict to aid with IDE type hinting
-    namespace = dict(gt=gt, ge=ge, lt=lt, le=le)
-    return type('ConstrainedDateValue', (ConstrainedDate,), namespace)
+    strict: bool | None = None,
+    gt: date | None = None,
+    ge: date | None = None,
+    lt: date | None = None,
+    le: date | None = None,
+) -> type[date]:
+    """A wrapper for date that adds constraints.
+
+    Args:
+        strict: Whether to validate the date value in strict mode. Defaults to `None`.
+        gt: The value must be greater than this. Defaults to `None`.
+        ge: The value must be greater than or equal to this. Defaults to `None`.
+        lt: The value must be less than this. Defaults to `None`.
+        le: The value must be less than or equal to this. Defaults to `None`.
+
+    Returns:
+        A date type with the specified constraints.
+    """
+    return Annotated[
+        date,
+        Strict(strict) if strict is not None else None,
+        annotated_types.Interval(gt=gt, ge=ge, lt=lt, le=le),
+    ]
+
+
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ DATETIME TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+if TYPE_CHECKING:
+    AwareDatetime = Annotated[datetime, ...]
+    NaiveDatetime = Annotated[datetime, ...]
+    PastDatetime = Annotated[datetime, ...]
+    FutureDatetime = Annotated[datetime, ...]
+
+else:
+
+    class AwareDatetime:
+        """A datetime that requires timezone info."""
+
+        @classmethod
+        def __get_pydantic_core_schema__(
+            cls, source: type[Any], handler: GetCoreSchemaHandler
+        ) -> core_schema.CoreSchema:
+            if cls is source:
+                # used directly as a type
+                return core_schema.datetime_schema(tz_constraint='aware')
+            else:
+                schema = handler(source)
+                _check_annotated_type(schema['type'], 'datetime', cls.__name__)
+                schema['tz_constraint'] = 'aware'
+                return schema
+
+        def __repr__(self) -> str:
+            return 'AwareDatetime'
+
+    class NaiveDatetime:
+        """A datetime that doesn't require timezone info."""
+
+        @classmethod
+        def __get_pydantic_core_schema__(
+            cls, source: type[Any], handler: GetCoreSchemaHandler
+        ) -> core_schema.CoreSchema:
+            if cls is source:
+                # used directly as a type
+                return core_schema.datetime_schema(tz_constraint='naive')
+            else:
+                schema = handler(source)
+                _check_annotated_type(schema['type'], 'datetime', cls.__name__)
+                schema['tz_constraint'] = 'naive'
+                return schema
+
+        def __repr__(self) -> str:
+            return 'NaiveDatetime'
+
+    class PastDatetime:
+        """A datetime that must be in the past."""
+
+        @classmethod
+        def __get_pydantic_core_schema__(
+            cls, source: type[Any], handler: GetCoreSchemaHandler
+        ) -> core_schema.CoreSchema:
+            if cls is source:
+                # used directly as a type
+                return core_schema.datetime_schema(now_op='past')
+            else:
+                schema = handler(source)
+                _check_annotated_type(schema['type'], 'datetime', cls.__name__)
+                schema['now_op'] = 'past'
+                return schema
+
+        def __repr__(self) -> str:
+            return 'PastDatetime'
+
+    class FutureDatetime:
+        """A datetime that must be in the future."""
+
+        @classmethod
+        def __get_pydantic_core_schema__(
+            cls, source: type[Any], handler: GetCoreSchemaHandler
+        ) -> core_schema.CoreSchema:
+            if cls is source:
+                # used directly as a type
+                return core_schema.datetime_schema(now_op='future')
+            else:
+                schema = handler(source)
+                _check_annotated_type(schema['type'], 'datetime', cls.__name__)
+                schema['now_op'] = 'future'
+                return schema
+
+        def __repr__(self) -> str:
+            return 'FutureDatetime'
+
+
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Encoded TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+
+class EncoderProtocol(Protocol):
+    """Protocol for encoding and decoding data to and from bytes."""
+
+    @classmethod
+    def decode(cls, data: bytes) -> bytes:
+        """Decode the data using the encoder.
+
+        Args:
+            data: The data to decode.
+
+        Returns:
+            The decoded data.
+        """
+        ...
+
+    @classmethod
+    def encode(cls, value: bytes) -> bytes:
+        """Encode the data using the encoder.
+
+        Args:
+            value: The data to encode.
+
+        Returns:
+            The encoded data.
+        """
+        ...
+
+    @classmethod
+    def get_json_format(cls) -> str:
+        """Get the JSON format for the encoded data.
+
+        Returns:
+            The JSON format for the encoded data.
+        """
+        ...
+
+
+class Base64Encoder(EncoderProtocol):
+    """Standard (non-URL-safe) Base64 encoder."""
+
+    @classmethod
+    def decode(cls, data: bytes) -> bytes:
+        """Decode the data from base64 encoded bytes to original bytes data.
+
+        Args:
+            data: The data to decode.
+
+        Returns:
+            The decoded data.
+        """
+        try:
+            return base64.decodebytes(data)
+        except ValueError as e:
+            raise PydanticCustomError('base64_decode', "Base64 decoding error: '{error}'", {'error': str(e)})
+
+    @classmethod
+    def encode(cls, value: bytes) -> bytes:
+        """Encode the data from bytes to a base64 encoded bytes.
+
+        Args:
+            value: The data to encode.
+
+        Returns:
+            The encoded data.
+        """
+        return base64.encodebytes(value)
+
+    @classmethod
+    def get_json_format(cls) -> Literal['base64']:
+        """Get the JSON format for the encoded data.
+
+        Returns:
+            The JSON format for the encoded data.
+        """
+        return 'base64'
+
+
+class Base64UrlEncoder(EncoderProtocol):
+    """URL-safe Base64 encoder."""
+
+    @classmethod
+    def decode(cls, data: bytes) -> bytes:
+        """Decode the data from base64 encoded bytes to original bytes data.
+
+        Args:
+            data: The data to decode.
+
+        Returns:
+            The decoded data.
+        """
+        try:
+            return base64.urlsafe_b64decode(data)
+        except ValueError as e:
+            raise PydanticCustomError('base64_decode', "Base64 decoding error: '{error}'", {'error': str(e)})
+
+    @classmethod
+    def encode(cls, value: bytes) -> bytes:
+        """Encode the data from bytes to a base64 encoded bytes.
+
+        Args:
+            value: The data to encode.
+
+        Returns:
+            The encoded data.
+        """
+        return base64.urlsafe_b64encode(value)
+
+    @classmethod
+    def get_json_format(cls) -> Literal['base64url']:
+        """Get the JSON format for the encoded data.
+
+        Returns:
+            The JSON format for the encoded data.
+        """
+        return 'base64url'
+
+
+@_dataclasses.dataclass(**_internal_dataclass.slots_true)
+class EncodedBytes:
+    """A bytes type that is encoded and decoded using the specified encoder.
+
+    `EncodedBytes` needs an encoder that implements `EncoderProtocol` to operate.
+
+    ```py
+    from typing_extensions import Annotated
+
+    from pydantic import BaseModel, EncodedBytes, EncoderProtocol, ValidationError
+
+    class MyEncoder(EncoderProtocol):
+        @classmethod
+        def decode(cls, data: bytes) -> bytes:
+            if data == b'**undecodable**':
+                raise ValueError('Cannot decode data')
+            return data[13:]
+
+        @classmethod
+        def encode(cls, value: bytes) -> bytes:
+            return b'**encoded**: ' + value
+
+        @classmethod
+        def get_json_format(cls) -> str:
+            return 'my-encoder'
+
+    MyEncodedBytes = Annotated[bytes, EncodedBytes(encoder=MyEncoder)]
+
+    class Model(BaseModel):
+        my_encoded_bytes: MyEncodedBytes
+
+    # Initialize the model with encoded data
+    m = Model(my_encoded_bytes=b'**encoded**: some bytes')
+
+    # Access decoded value
+    print(m.my_encoded_bytes)
+    #> b'some bytes'
+
+    # Serialize into the encoded form
+    print(m.model_dump())
+    #> {'my_encoded_bytes': b'**encoded**: some bytes'}
+
+    # Validate encoded data
+    try:
+        Model(my_encoded_bytes=b'**undecodable**')
+    except ValidationError as e:
+        print(e)
+        '''
+        1 validation error for Model
+        my_encoded_bytes
+          Value error, Cannot decode data [type=value_error, input_value=b'**undecodable**', input_type=bytes]
+        '''
+    ```
+    """
+
+    encoder: type[EncoderProtocol]
+
+    def __get_pydantic_json_schema__(
+        self, core_schema: core_schema.CoreSchema, handler: GetJsonSchemaHandler
+    ) -> JsonSchemaValue:
+        field_schema = handler(core_schema)
+        field_schema.update(type='string', format=self.encoder.get_json_format())
+        return field_schema
+
+    def __get_pydantic_core_schema__(self, source: type[Any], handler: GetCoreSchemaHandler) -> core_schema.CoreSchema:
+        return core_schema.with_info_after_validator_function(
+            function=self.decode,
+            schema=core_schema.bytes_schema(),
+            serialization=core_schema.plain_serializer_function_ser_schema(function=self.encode),
+        )
+
+    def decode(self, data: bytes, _: core_schema.ValidationInfo) -> bytes:
+        """Decode the data using the specified encoder.
+
+        Args:
+            data: The data to decode.
+
+        Returns:
+            The decoded data.
+        """
+        return self.encoder.decode(data)
+
+    def encode(self, value: bytes) -> bytes:
+        """Encode the data using the specified encoder.
+
+        Args:
+            value: The data to encode.
+
+        Returns:
+            The encoded data.
+        """
+        return self.encoder.encode(value)
+
+    def __hash__(self) -> int:
+        return hash(self.encoder)
+
+
+@_dataclasses.dataclass(**_internal_dataclass.slots_true)
+class EncodedStr(EncodedBytes):
+    """A str type that is encoded and decoded using the specified encoder.
+
+    `EncodedStr` needs an encoder that implements `EncoderProtocol` to operate.
+
+    ```py
+    from typing_extensions import Annotated
+
+    from pydantic import BaseModel, EncodedStr, EncoderProtocol, ValidationError
+
+    class MyEncoder(EncoderProtocol):
+        @classmethod
+        def decode(cls, data: bytes) -> bytes:
+            if data == b'**undecodable**':
+                raise ValueError('Cannot decode data')
+            return data[13:]
+
+        @classmethod
+        def encode(cls, value: bytes) -> bytes:
+            return b'**encoded**: ' + value
+
+        @classmethod
+        def get_json_format(cls) -> str:
+            return 'my-encoder'
+
+    MyEncodedStr = Annotated[str, EncodedStr(encoder=MyEncoder)]
+
+    class Model(BaseModel):
+        my_encoded_str: MyEncodedStr
+
+    # Initialize the model with encoded data
+    m = Model(my_encoded_str='**encoded**: some str')
+
+    # Access decoded value
+    print(m.my_encoded_str)
+    #> some str
+
+    # Serialize into the encoded form
+    print(m.model_dump())
+    #> {'my_encoded_str': '**encoded**: some str'}
+
+    # Validate encoded data
+    try:
+        Model(my_encoded_str='**undecodable**')
+    except ValidationError as e:
+        print(e)
+        '''
+        1 validation error for Model
+        my_encoded_str
+          Value error, Cannot decode data [type=value_error, input_value='**undecodable**', input_type=str]
+        '''
+    ```
+    """
+
+    def __get_pydantic_core_schema__(self, source: type[Any], handler: GetCoreSchemaHandler) -> core_schema.CoreSchema:
+        return core_schema.with_info_after_validator_function(
+            function=self.decode_str,
+            schema=super(EncodedStr, self).__get_pydantic_core_schema__(source=source, handler=handler),  # noqa: UP008
+            serialization=core_schema.plain_serializer_function_ser_schema(function=self.encode_str),
+        )
+
+    def decode_str(self, data: bytes, _: core_schema.ValidationInfo) -> str:
+        """Decode the data using the specified encoder.
+
+        Args:
+            data: The data to decode.
+
+        Returns:
+            The decoded data.
+        """
+        return data.decode()
+
+    def encode_str(self, value: str) -> str:
+        """Encode the data using the specified encoder.
+
+        Args:
+            value: The data to encode.
+
+        Returns:
+            The encoded data.
+        """
+        return super(EncodedStr, self).encode(value=value.encode()).decode()  # noqa: UP008
+
+    def __hash__(self) -> int:
+        return hash(self.encoder)
+
+
+Base64Bytes = Annotated[bytes, EncodedBytes(encoder=Base64Encoder)]
+"""A bytes type that is encoded and decoded using the standard (non-URL-safe) base64 encoder.
+
+Note:
+    Under the hood, `Base64Bytes` use standard library `base64.encodebytes` and `base64.decodebytes` functions.
+
+    As a result, attempting to decode url-safe base64 data using the `Base64Bytes` type may fail or produce an incorrect
+    decoding.
+
+```py
+from pydantic import Base64Bytes, BaseModel, ValidationError
+
+class Model(BaseModel):
+    base64_bytes: Base64Bytes
+
+# Initialize the model with base64 data
+m = Model(base64_bytes=b'VGhpcyBpcyB0aGUgd2F5')
+
+# Access decoded value
+print(m.base64_bytes)
+#> b'This is the way'
+
+# Serialize into the base64 form
+print(m.model_dump())
+#> {'base64_bytes': b'VGhpcyBpcyB0aGUgd2F5\n'}
+
+# Validate base64 data
+try:
+    print(Model(base64_bytes=b'undecodable').base64_bytes)
+except ValidationError as e:
+    print(e)
+    '''
+    1 validation error for Model
+    base64_bytes
+      Base64 decoding error: 'Incorrect padding' [type=base64_decode, input_value=b'undecodable', input_type=bytes]
+    '''
+```
+"""
+Base64Str = Annotated[str, EncodedStr(encoder=Base64Encoder)]
+"""A str type that is encoded and decoded using the standard (non-URL-safe) base64 encoder.
+
+Note:
+    Under the hood, `Base64Bytes` use standard library `base64.encodebytes` and `base64.decodebytes` functions.
+
+    As a result, attempting to decode url-safe base64 data using the `Base64Str` type may fail or produce an incorrect
+    decoding.
+
+```py
+from pydantic import Base64Str, BaseModel, ValidationError
+
+class Model(BaseModel):
+    base64_str: Base64Str
+
+# Initialize the model with base64 data
+m = Model(base64_str='VGhlc2UgYXJlbid0IHRoZSBkcm9pZHMgeW91J3JlIGxvb2tpbmcgZm9y')
+
+# Access decoded value
+print(m.base64_str)
+#> These aren't the droids you're looking for
+
+# Serialize into the base64 form
+print(m.model_dump())
+#> {'base64_str': 'VGhlc2UgYXJlbid0IHRoZSBkcm9pZHMgeW91J3JlIGxvb2tpbmcgZm9y\n'}
+
+# Validate base64 data
+try:
+    print(Model(base64_str='undecodable').base64_str)
+except ValidationError as e:
+    print(e)
+    '''
+    1 validation error for Model
+    base64_str
+      Base64 decoding error: 'Incorrect padding' [type=base64_decode, input_value='undecodable', input_type=str]
+    '''
+```
+"""
+Base64UrlBytes = Annotated[bytes, EncodedBytes(encoder=Base64UrlEncoder)]
+"""A bytes type that is encoded and decoded using the URL-safe base64 encoder.
+
+Note:
+    Under the hood, `Base64UrlBytes` use standard library `base64.urlsafe_b64encode` and `base64.urlsafe_b64decode`
+    functions.
+
+    As a result, the `Base64UrlBytes` type can be used to faithfully decode "vanilla" base64 data
+    (using `'+'` and `'/'`).
+
+```py
+from pydantic import Base64UrlBytes, BaseModel
+
+class Model(BaseModel):
+    base64url_bytes: Base64UrlBytes
+
+# Initialize the model with base64 data
+m = Model(base64url_bytes=b'SHc_dHc-TXc==')
+print(m)
+#> base64url_bytes=b'Hw?tw>Mw'
+```
+"""
+Base64UrlStr = Annotated[str, EncodedStr(encoder=Base64UrlEncoder)]
+"""A str type that is encoded and decoded using the URL-safe base64 encoder.
+
+Note:
+    Under the hood, `Base64UrlStr` use standard library `base64.urlsafe_b64encode` and `base64.urlsafe_b64decode`
+    functions.
+
+    As a result, the `Base64UrlStr` type can be used to faithfully decode "vanilla" base64 data (using `'+'` and `'/'`).
+
+```py
+from pydantic import Base64UrlStr, BaseModel
+
+class Model(BaseModel):
+    base64url_str: Base64UrlStr
+
+# Initialize the model with base64 data
+m = Model(base64url_str='SHc_dHc-TXc==')
+print(m)
+#> base64url_str='Hw?tw>Mw'
+```
+"""
+
+
+__getattr__ = getattr_migration(__name__)
+
+
+@_dataclasses.dataclass(**_internal_dataclass.slots_true)
+class GetPydanticSchema:
+    """Usage docs: https://docs.pydantic.dev/2.6/concepts/types/#using-getpydanticschema-to-reduce-boilerplate
+
+    A convenience class for creating an annotation that provides pydantic custom type hooks.
+
+    This class is intended to eliminate the need to create a custom "marker" which defines the
+     `__get_pydantic_core_schema__` and `__get_pydantic_json_schema__` custom hook methods.
+
+    For example, to have a field treated by type checkers as `int`, but by pydantic as `Any`, you can do:
+    ```python
+    from typing import Any
+
+    from typing_extensions import Annotated
+
+    from pydantic import BaseModel, GetPydanticSchema
+
+    HandleAsAny = GetPydanticSchema(lambda _s, h: h(Any))
+
+    class Model(BaseModel):
+        x: Annotated[int, HandleAsAny]  # pydantic sees `x: Any`
+
+    print(repr(Model(x='abc').x))
+    #> 'abc'
+    ```
+    """
+
+    get_pydantic_core_schema: Callable[[Any, GetCoreSchemaHandler], CoreSchema] | None = None
+    get_pydantic_json_schema: Callable[[Any, GetJsonSchemaHandler], JsonSchemaValue] | None = None
+
+    # Note: we may want to consider adding a convenience staticmethod `def for_type(type_: Any) -> GetPydanticSchema:`
+    #   which returns `GetPydanticSchema(lambda _s, h: h(type_))`
+
+    if not TYPE_CHECKING:
+        # We put `__getattr__` in a non-TYPE_CHECKING block because otherwise, mypy allows arbitrary attribute access
+
+        def __getattr__(self, item: str) -> Any:
+            """Use this rather than defining `__get_pydantic_core_schema__` etc. to reduce the number of nested calls."""
+            if item == '__get_pydantic_core_schema__' and self.get_pydantic_core_schema:
+                return self.get_pydantic_core_schema
+            elif item == '__get_pydantic_json_schema__' and self.get_pydantic_json_schema:
+                return self.get_pydantic_json_schema
+            else:
+                return object.__getattribute__(self, item)
+
+    __hash__ = object.__hash__
+
+
+@_dataclasses.dataclass(**_internal_dataclass.slots_true, frozen=True)
+class Tag:
+    """Provides a way to specify the expected tag to use for a case of a (callable) discriminated union.
+
+    Also provides a way to label a union case in error messages.
+
+    When using a callable `Discriminator`, attach a `Tag` to each case in the `Union` to specify the tag that
+    should be used to identify that case. For example, in the below example, the `Tag` is used to specify that
+    if `get_discriminator_value` returns `'apple'`, the input should be validated as an `ApplePie`, and if it
+    returns `'pumpkin'`, the input should be validated as a `PumpkinPie`.
+
+    The primary role of the `Tag` here is to map the return value from the callable `Discriminator` function to
+    the appropriate member of the `Union` in question.
+
+    ```py
+    from typing import Any, Union
+
+    from typing_extensions import Annotated, Literal
+
+    from pydantic import BaseModel, Discriminator, Tag
+
+    class Pie(BaseModel):
+        time_to_cook: int
+        num_ingredients: int
+
+    class ApplePie(Pie):
+        fruit: Literal['apple'] = 'apple'
+
+    class PumpkinPie(Pie):
+        filling: Literal['pumpkin'] = 'pumpkin'
+
+    def get_discriminator_value(v: Any) -> str:
+        if isinstance(v, dict):
+            return v.get('fruit', v.get('filling'))
+        return getattr(v, 'fruit', getattr(v, 'filling', None))
+
+    class ThanksgivingDinner(BaseModel):
+        dessert: Annotated[
+            Union[
+                Annotated[ApplePie, Tag('apple')],
+                Annotated[PumpkinPie, Tag('pumpkin')],
+            ],
+            Discriminator(get_discriminator_value),
+        ]
+
+    apple_variation = ThanksgivingDinner.model_validate(
+        {'dessert': {'fruit': 'apple', 'time_to_cook': 60, 'num_ingredients': 8}}
+    )
+    print(repr(apple_variation))
+    '''
+    ThanksgivingDinner(dessert=ApplePie(time_to_cook=60, num_ingredients=8, fruit='apple'))
+    '''
+
+    pumpkin_variation = ThanksgivingDinner.model_validate(
+        {
+            'dessert': {
+                'filling': 'pumpkin',
+                'time_to_cook': 40,
+                'num_ingredients': 6,
+            }
+        }
+    )
+    print(repr(pumpkin_variation))
+    '''
+    ThanksgivingDinner(dessert=PumpkinPie(time_to_cook=40, num_ingredients=6, filling='pumpkin'))
+    '''
+    ```
+
+    !!! note
+        You must specify a `Tag` for every case in a `Tag` that is associated with a
+        callable `Discriminator`. Failing to do so will result in a `PydanticUserError` with code
+        [`callable-discriminator-no-tag`](../errors/usage_errors.md#callable-discriminator-no-tag).
+
+    See the [Discriminated Unions] concepts docs for more details on how to use `Tag`s.
+
+    [Discriminated Unions]: ../concepts/unions.md#discriminated-unions
+    """
+
+    tag: str
+
+    def __get_pydantic_core_schema__(self, source_type: Any, handler: GetCoreSchemaHandler) -> CoreSchema:
+        schema = handler(source_type)
+        metadata = schema.setdefault('metadata', {})
+        assert isinstance(metadata, dict)
+        metadata[_core_utils.TAGGED_UNION_TAG_KEY] = self.tag
+        return schema
+
+
+@_dataclasses.dataclass(**_internal_dataclass.slots_true, frozen=True)
+class Discriminator:
+    """Usage docs: https://docs.pydantic.dev/2.6/concepts/unions/#discriminated-unions-with-callable-discriminator
+
+    Provides a way to use a custom callable as the way to extract the value of a union discriminator.
+
+    This allows you to get validation behavior like you'd get from `Field(discriminator=<field_name>)`,
+    but without needing to have a single shared field across all the union choices. This also makes it
+    possible to handle unions of models and primitive types with discriminated-union-style validation errors.
+    Finally, this allows you to use a custom callable as the way to identify which member of a union a value
+    belongs to, while still seeing all the performance benefits of a discriminated union.
+
+    Consider this example, which is much more performant with the use of `Discriminator` and thus a `TaggedUnion`
+    than it would be as a normal `Union`.
+
+    ```py
+    from typing import Any, Union
+
+    from typing_extensions import Annotated, Literal
+
+    from pydantic import BaseModel, Discriminator, Tag
+
+    class Pie(BaseModel):
+        time_to_cook: int
+        num_ingredients: int
+
+    class ApplePie(Pie):
+        fruit: Literal['apple'] = 'apple'
+
+    class PumpkinPie(Pie):
+        filling: Literal['pumpkin'] = 'pumpkin'
+
+    def get_discriminator_value(v: Any) -> str:
+        if isinstance(v, dict):
+            return v.get('fruit', v.get('filling'))
+        return getattr(v, 'fruit', getattr(v, 'filling', None))
+
+    class ThanksgivingDinner(BaseModel):
+        dessert: Annotated[
+            Union[
+                Annotated[ApplePie, Tag('apple')],
+                Annotated[PumpkinPie, Tag('pumpkin')],
+            ],
+            Discriminator(get_discriminator_value),
+        ]
+
+    apple_variation = ThanksgivingDinner.model_validate(
+        {'dessert': {'fruit': 'apple', 'time_to_cook': 60, 'num_ingredients': 8}}
+    )
+    print(repr(apple_variation))
+    '''
+    ThanksgivingDinner(dessert=ApplePie(time_to_cook=60, num_ingredients=8, fruit='apple'))
+    '''
+
+    pumpkin_variation = ThanksgivingDinner.model_validate(
+        {
+            'dessert': {
+                'filling': 'pumpkin',
+                'time_to_cook': 40,
+                'num_ingredients': 6,
+            }
+        }
+    )
+    print(repr(pumpkin_variation))
+    '''
+    ThanksgivingDinner(dessert=PumpkinPie(time_to_cook=40, num_ingredients=6, filling='pumpkin'))
+    '''
+    ```
+
+    See the [Discriminated Unions] concepts docs for more details on how to use `Discriminator`s.
+
+    [Discriminated Unions]: ../concepts/unions.md#discriminated-unions
+    """
+
+    discriminator: str | Callable[[Any], Hashable]
+    """The callable or field name for discriminating the type in a tagged union.
+
+    A `Callable` discriminator must extract the value of the discriminator from the input.
+    A `str` discriminator must be the name of a field to discriminate against.
+    """
+    custom_error_type: str | None = None
+    """Type to use in [custom errors](../errors/errors.md#custom-errors) replacing the standard discriminated union
+    validation errors.
+    """
+    custom_error_message: str | None = None
+    """Message to use in custom errors."""
+    custom_error_context: dict[str, int | str | float] | None = None
+    """Context to use in custom errors."""
+
+    def __get_pydantic_core_schema__(self, source_type: Any, handler: GetCoreSchemaHandler) -> CoreSchema:
+        origin = _typing_extra.get_origin(source_type)
+        if not origin or not _typing_extra.origin_is_union(origin):
+            raise TypeError(f'{type(self).__name__} must be used with a Union type, not {source_type}')
+
+        if isinstance(self.discriminator, str):
+            from pydantic import Field
+
+            return handler(Annotated[source_type, Field(discriminator=self.discriminator)])
+        else:
+            original_schema = handler(source_type)
+            return self._convert_schema(original_schema)
+
+    def _convert_schema(self, original_schema: core_schema.CoreSchema) -> core_schema.TaggedUnionSchema:
+        if original_schema['type'] != 'union':
+            # This likely indicates that the schema was a single-item union that was simplified.
+            # In this case, we do the same thing we do in
+            # `pydantic._internal._discriminated_union._ApplyInferredDiscriminator._apply_to_root`, namely,
+            # package the generated schema back into a single-item union.
+            original_schema = core_schema.union_schema([original_schema])
+
+        tagged_union_choices = {}
+        for i, choice in enumerate(original_schema['choices']):
+            tag = None
+            if isinstance(choice, tuple):
+                choice, tag = choice
+            metadata = choice.get('metadata')
+            if metadata is not None:
+                metadata_tag = metadata.get(_core_utils.TAGGED_UNION_TAG_KEY)
+                if metadata_tag is not None:
+                    tag = metadata_tag
+            if tag is None:
+                raise PydanticUserError(
+                    f'`Tag` not provided for choice {choice} used with `Discriminator`',
+                    code='callable-discriminator-no-tag',
+                )
+            tagged_union_choices[tag] = choice
+
+        # Have to do these verbose checks to ensure falsy values ('' and {}) don't get ignored
+        custom_error_type = self.custom_error_type
+        if custom_error_type is None:
+            custom_error_type = original_schema.get('custom_error_type')
+
+        custom_error_message = self.custom_error_message
+        if custom_error_message is None:
+            custom_error_message = original_schema.get('custom_error_message')
+
+        custom_error_context = self.custom_error_context
+        if custom_error_context is None:
+            custom_error_context = original_schema.get('custom_error_context')
+
+        custom_error_type = original_schema.get('custom_error_type') if custom_error_type is None else custom_error_type
+        return core_schema.tagged_union_schema(
+            tagged_union_choices,
+            self.discriminator,
+            custom_error_type=custom_error_type,
+            custom_error_message=custom_error_message,
+            custom_error_context=custom_error_context,
+            strict=original_schema.get('strict'),
+            ref=original_schema.get('ref'),
+            metadata=original_schema.get('metadata'),
+            serialization=original_schema.get('serialization'),
+        )
+
+
+_JSON_TYPES = {int, float, str, bool, list, dict, type(None)}
+
+
+def _get_type_name(x: Any) -> str:
+    type_ = type(x)
+    if type_ in _JSON_TYPES:
+        return type_.__name__
+
+    # Handle proper subclasses; note we don't need to handle None or bool here
+    if isinstance(x, int):
+        return 'int'
+    if isinstance(x, float):
+        return 'float'
+    if isinstance(x, str):
+        return 'str'
+    if isinstance(x, list):
+        return 'list'
+    if isinstance(x, dict):
+        return 'dict'
+
+    # Fail by returning the type's actual name
+    return getattr(type_, '__name__', '<no type name>')
+
+
+class _AllowAnyJson:
+    @classmethod
+    def __get_pydantic_core_schema__(cls, source_type: Any, handler: GetCoreSchemaHandler) -> CoreSchema:
+        python_schema = handler(source_type)
+        return core_schema.json_or_python_schema(json_schema=core_schema.any_schema(), python_schema=python_schema)
+
+
+if TYPE_CHECKING:
+    # This seems to only be necessary for mypy
+    JsonValue: TypeAlias = Union[
+        List['JsonValue'],
+        Dict[str, 'JsonValue'],
+        str,
+        bool,
+        int,
+        float,
+        None,
+    ]
+    """A `JsonValue` is used to represent a value that can be serialized to JSON.
+
+    It may be one of:
+
+    * `List['JsonValue']`
+    * `Dict[str, 'JsonValue']`
+    * `str`
+    * `bool`
+    * `int`
+    * `float`
+    * `None`
+
+    The following example demonstrates how to use `JsonValue` to validate JSON data,
+    and what kind of errors to expect when input data is not json serializable.
+
+    ```py
+    import json
+
+    from pydantic import BaseModel, JsonValue, ValidationError
+
+    class Model(BaseModel):
+        j: JsonValue
+
+    valid_json_data = {'j': {'a': {'b': {'c': 1, 'd': [2, None]}}}}
+    invalid_json_data = {'j': {'a': {'b': ...}}}
+
+    print(repr(Model.model_validate(valid_json_data)))
+    #> Model(j={'a': {'b': {'c': 1, 'd': [2, None]}}})
+    print(repr(Model.model_validate_json(json.dumps(valid_json_data))))
+    #> Model(j={'a': {'b': {'c': 1, 'd': [2, None]}}})
+
+    try:
+        Model.model_validate(invalid_json_data)
+    except ValidationError as e:
+        print(e)
+        '''
+        1 validation error for Model
+        j.dict.a.dict.b
+          input was not a valid JSON value [type=invalid-json-value, input_value=Ellipsis, input_type=ellipsis]
+        '''
+    ```
+    """
+
+else:
+    JsonValue = TypeAliasType(
+        'JsonValue',
+        Annotated[
+            Union[
+                Annotated[List['JsonValue'], Tag('list')],
+                Annotated[Dict[str, 'JsonValue'], Tag('dict')],
+                Annotated[str, Tag('str')],
+                Annotated[bool, Tag('bool')],
+                Annotated[int, Tag('int')],
+                Annotated[float, Tag('float')],
+                Annotated[None, Tag('NoneType')],
+            ],
+            Discriminator(
+                _get_type_name,
+                custom_error_type='invalid-json-value',
+                custom_error_message='input was not a valid JSON value',
+            ),
+            _AllowAnyJson,
+        ],
+    )
+
+
+class _OnErrorOmit:
+    @classmethod
+    def __get_pydantic_core_schema__(cls, source_type: Any, handler: GetCoreSchemaHandler) -> CoreSchema:
+        # there is no actual default value here but we use with_default_schema since it already has the on_error
+        # behavior implemented and it would be no more efficient to implement it on every other validator
+        # or as a standalone validator
+        return core_schema.with_default_schema(schema=handler(source_type), on_error='omit')
+
+
+OnErrorOmit = Annotated[T, _OnErrorOmit]
+"""
+When used as an item in a list, the key type in a dict, optional values of a TypedDict, etc.
+this annotation omits the item from the iteration if there is any error validating it.
+That is, instead of a [`ValidationError`][pydantic_core.ValidationError] being propagated up and the entire iterable being discarded
+any invalid items are discarded and the valid ones are returned.
+"""
diff --git a/lib/pydantic/typing.py b/lib/pydantic/typing.py
index 5ccf266c..f1b32ba2 100644
--- a/lib/pydantic/typing.py
+++ b/lib/pydantic/typing.py
@@ -1,602 +1,4 @@
-import sys
-from collections.abc import Callable
-from os import PathLike
-from typing import (  # type: ignore
-    TYPE_CHECKING,
-    AbstractSet,
-    Any,
-    Callable as TypingCallable,
-    ClassVar,
-    Dict,
-    ForwardRef,
-    Generator,
-    Iterable,
-    List,
-    Mapping,
-    NewType,
-    Optional,
-    Sequence,
-    Set,
-    Tuple,
-    Type,
-    TypeVar,
-    Union,
-    _eval_type,
-    cast,
-    get_type_hints,
-)
+"""`typing` module is a backport module from V1."""
+from ._migration import getattr_migration
 
-from typing_extensions import (
-    Annotated,
-    Final,
-    Literal,
-    NotRequired as TypedDictNotRequired,
-    Required as TypedDictRequired,
-)
-
-try:
-    from typing import _TypingBase as typing_base  # type: ignore
-except ImportError:
-    from typing import _Final as typing_base  # type: ignore
-
-try:
-    from typing import GenericAlias as TypingGenericAlias  # type: ignore
-except ImportError:
-    # python < 3.9 does not have GenericAlias (list[int], tuple[str, ...] and so on)
-    TypingGenericAlias = ()
-
-try:
-    from types import UnionType as TypesUnionType  # type: ignore
-except ImportError:
-    # python < 3.10 does not have UnionType (str | int, byte | bool and so on)
-    TypesUnionType = ()
-
-
-if sys.version_info < (3, 9):
-
-    def evaluate_forwardref(type_: ForwardRef, globalns: Any, localns: Any) -> Any:
-        return type_._evaluate(globalns, localns)
-
-else:
-
-    def evaluate_forwardref(type_: ForwardRef, globalns: Any, localns: Any) -> Any:
-        # Even though it is the right signature for python 3.9, mypy complains with
-        # `error: Too many arguments for "_evaluate" of "ForwardRef"` hence the cast...
-        return cast(Any, type_)._evaluate(globalns, localns, set())
-
-
-if sys.version_info < (3, 9):
-    # Ensure we always get all the whole `Annotated` hint, not just the annotated type.
-    # For 3.7 to 3.8, `get_type_hints` doesn't recognize `typing_extensions.Annotated`,
-    # so it already returns the full annotation
-    get_all_type_hints = get_type_hints
-
-else:
-
-    def get_all_type_hints(obj: Any, globalns: Any = None, localns: Any = None) -> Any:
-        return get_type_hints(obj, globalns, localns, include_extras=True)
-
-
-_T = TypeVar('_T')
-
-AnyCallable = TypingCallable[..., Any]
-NoArgAnyCallable = TypingCallable[[], Any]
-
-# workaround for https://github.com/python/mypy/issues/9496
-AnyArgTCallable = TypingCallable[..., _T]
-
-
-# Annotated[...] is implemented by returning an instance of one of these classes, depending on
-# python/typing_extensions version.
-AnnotatedTypeNames = {'AnnotatedMeta', '_AnnotatedAlias'}
-
-
-if sys.version_info < (3, 8):
-
-    def get_origin(t: Type[Any]) -> Optional[Type[Any]]:
-        if type(t).__name__ in AnnotatedTypeNames:
-            # weirdly this is a runtime requirement, as well as for mypy
-            return cast(Type[Any], Annotated)
-        return getattr(t, '__origin__', None)
-
-else:
-    from typing import get_origin as _typing_get_origin
-
-    def get_origin(tp: Type[Any]) -> Optional[Type[Any]]:
-        """
-        We can't directly use `typing.get_origin` since we need a fallback to support
-        custom generic classes like `ConstrainedList`
-        It should be useless once https://github.com/cython/cython/issues/3537 is
-        solved and https://github.com/pydantic/pydantic/pull/1753 is merged.
-        """
-        if type(tp).__name__ in AnnotatedTypeNames:
-            return cast(Type[Any], Annotated)  # mypy complains about _SpecialForm
-        return _typing_get_origin(tp) or getattr(tp, '__origin__', None)
-
-
-if sys.version_info < (3, 8):
-    from typing import _GenericAlias
-
-    def get_args(t: Type[Any]) -> Tuple[Any, ...]:
-        """Compatibility version of get_args for python 3.7.
-
-        Mostly compatible with the python 3.8 `typing` module version
-        and able to handle almost all use cases.
-        """
-        if type(t).__name__ in AnnotatedTypeNames:
-            return t.__args__ + t.__metadata__
-        if isinstance(t, _GenericAlias):
-            res = t.__args__
-            if t.__origin__ is Callable and res and res[0] is not Ellipsis:
-                res = (list(res[:-1]), res[-1])
-            return res
-        return getattr(t, '__args__', ())
-
-else:
-    from typing import get_args as _typing_get_args
-
-    def _generic_get_args(tp: Type[Any]) -> Tuple[Any, ...]:
-        """
-        In python 3.9, `typing.Dict`, `typing.List`, ...
-        do have an empty `__args__` by default (instead of the generic ~T for example).
-        In order to still support `Dict` for example and consider it as `Dict[Any, Any]`,
-        we retrieve the `_nparams` value that tells us how many parameters it needs.
-        """
-        if hasattr(tp, '_nparams'):
-            return (Any,) * tp._nparams
-        # Special case for `tuple[()]`, which used to return ((),) with `typing.Tuple`
-        # in python 3.10- but now returns () for `tuple` and `Tuple`.
-        # This will probably be clarified in pydantic v2
-        try:
-            if tp == Tuple[()] or sys.version_info >= (3, 9) and tp == tuple[()]:  # type: ignore[misc]
-                return ((),)
-        # there is a TypeError when compiled with cython
-        except TypeError:  # pragma: no cover
-            pass
-        return ()
-
-    def get_args(tp: Type[Any]) -> Tuple[Any, ...]:
-        """Get type arguments with all substitutions performed.
-
-        For unions, basic simplifications used by Union constructor are performed.
-        Examples::
-            get_args(Dict[str, int]) == (str, int)
-            get_args(int) == ()
-            get_args(Union[int, Union[T, int], str][int]) == (int, str)
-            get_args(Union[int, Tuple[T, int]][str]) == (int, Tuple[str, int])
-            get_args(Callable[[], T][int]) == ([], int)
-        """
-        if type(tp).__name__ in AnnotatedTypeNames:
-            return tp.__args__ + tp.__metadata__
-        # the fallback is needed for the same reasons as `get_origin` (see above)
-        return _typing_get_args(tp) or getattr(tp, '__args__', ()) or _generic_get_args(tp)
-
-
-if sys.version_info < (3, 9):
-
-    def convert_generics(tp: Type[Any]) -> Type[Any]:
-        """Python 3.9 and older only supports generics from `typing` module.
-        They convert strings to ForwardRef automatically.
-
-        Examples::
-            typing.List['Hero'] == typing.List[ForwardRef('Hero')]
-        """
-        return tp
-
-else:
-    from typing import _UnionGenericAlias  # type: ignore
-
-    from typing_extensions import _AnnotatedAlias
-
-    def convert_generics(tp: Type[Any]) -> Type[Any]:
-        """
-        Recursively searches for `str` type hints and replaces them with ForwardRef.
-
-        Examples::
-            convert_generics(list['Hero']) == list[ForwardRef('Hero')]
-            convert_generics(dict['Hero', 'Team']) == dict[ForwardRef('Hero'), ForwardRef('Team')]
-            convert_generics(typing.Dict['Hero', 'Team']) == typing.Dict[ForwardRef('Hero'), ForwardRef('Team')]
-            convert_generics(list[str | 'Hero'] | int) == list[str | ForwardRef('Hero')] | int
-        """
-        origin = get_origin(tp)
-        if not origin or not hasattr(tp, '__args__'):
-            return tp
-
-        args = get_args(tp)
-
-        # typing.Annotated needs special treatment
-        if origin is Annotated:
-            return _AnnotatedAlias(convert_generics(args[0]), args[1:])
-
-        # recursively replace `str` instances inside of `GenericAlias` with `ForwardRef(arg)`
-        converted = tuple(
-            ForwardRef(arg) if isinstance(arg, str) and isinstance(tp, TypingGenericAlias) else convert_generics(arg)
-            for arg in args
-        )
-
-        if converted == args:
-            return tp
-        elif isinstance(tp, TypingGenericAlias):
-            return TypingGenericAlias(origin, converted)
-        elif isinstance(tp, TypesUnionType):
-            # recreate types.UnionType (PEP604, Python >= 3.10)
-            return _UnionGenericAlias(origin, converted)
-        else:
-            try:
-                setattr(tp, '__args__', converted)
-            except AttributeError:
-                pass
-            return tp
-
-
-if sys.version_info < (3, 10):
-
-    def is_union(tp: Optional[Type[Any]]) -> bool:
-        return tp is Union
-
-    WithArgsTypes = (TypingGenericAlias,)
-
-else:
-    import types
-    import typing
-
-    def is_union(tp: Optional[Type[Any]]) -> bool:
-        return tp is Union or tp is types.UnionType  # noqa: E721
-
-    WithArgsTypes = (typing._GenericAlias, types.GenericAlias, types.UnionType)
-
-
-if sys.version_info < (3, 9):
-    StrPath = Union[str, PathLike]
-else:
-    StrPath = Union[str, PathLike]
-    # TODO: Once we switch to Cython 3 to handle generics properly
-    #  (https://github.com/cython/cython/issues/2753), use following lines instead
-    #  of the one above
-    # # os.PathLike only becomes subscriptable from Python 3.9 onwards
-    # StrPath = Union[str, PathLike[str]]
-
-
-if TYPE_CHECKING:
-    from .fields import ModelField
-
-    TupleGenerator = Generator[Tuple[str, Any], None, None]
-    DictStrAny = Dict[str, Any]
-    DictAny = Dict[Any, Any]
-    SetStr = Set[str]
-    ListStr = List[str]
-    IntStr = Union[int, str]
-    AbstractSetIntStr = AbstractSet[IntStr]
-    DictIntStrAny = Dict[IntStr, Any]
-    MappingIntStrAny = Mapping[IntStr, Any]
-    CallableGenerator = Generator[AnyCallable, None, None]
-    ReprArgs = Sequence[Tuple[Optional[str], Any]]
-    AnyClassMethod = classmethod[Any]
-
-__all__ = (
-    'AnyCallable',
-    'NoArgAnyCallable',
-    'NoneType',
-    'is_none_type',
-    'display_as_type',
-    'resolve_annotations',
-    'is_callable_type',
-    'is_literal_type',
-    'all_literal_values',
-    'is_namedtuple',
-    'is_typeddict',
-    'is_typeddict_special',
-    'is_new_type',
-    'new_type_supertype',
-    'is_classvar',
-    'is_finalvar',
-    'update_field_forward_refs',
-    'update_model_forward_refs',
-    'TupleGenerator',
-    'DictStrAny',
-    'DictAny',
-    'SetStr',
-    'ListStr',
-    'IntStr',
-    'AbstractSetIntStr',
-    'DictIntStrAny',
-    'CallableGenerator',
-    'ReprArgs',
-    'AnyClassMethod',
-    'CallableGenerator',
-    'WithArgsTypes',
-    'get_args',
-    'get_origin',
-    'get_sub_types',
-    'typing_base',
-    'get_all_type_hints',
-    'is_union',
-    'StrPath',
-    'MappingIntStrAny',
-)
-
-
-NoneType = None.__class__
-
-
-NONE_TYPES: Tuple[Any, Any, Any] = (None, NoneType, Literal[None])
-
-
-if sys.version_info < (3, 8):
-    # Even though this implementation is slower, we need it for python 3.7:
-    # In python 3.7 "Literal" is not a builtin type and uses a different
-    # mechanism.
-    # for this reason `Literal[None] is Literal[None]` evaluates to `False`,
-    # breaking the faster implementation used for the other python versions.
-
-    def is_none_type(type_: Any) -> bool:
-        return type_ in NONE_TYPES
-
-elif sys.version_info[:2] == (3, 8):
-
-    def is_none_type(type_: Any) -> bool:
-        for none_type in NONE_TYPES:
-            if type_ is none_type:
-                return True
-        # With python 3.8, specifically 3.8.10, Literal "is" check sare very flakey
-        # can change on very subtle changes like use of types in other modules,
-        # hopefully this check avoids that issue.
-        if is_literal_type(type_):  # pragma: no cover
-            return all_literal_values(type_) == (None,)
-        return False
-
-else:
-
-    def is_none_type(type_: Any) -> bool:
-        for none_type in NONE_TYPES:
-            if type_ is none_type:
-                return True
-        return False
-
-
-def display_as_type(v: Type[Any]) -> str:
-    if not isinstance(v, typing_base) and not isinstance(v, WithArgsTypes) and not isinstance(v, type):
-        v = v.__class__
-
-    if is_union(get_origin(v)):
-        return f'Union[{", ".join(map(display_as_type, get_args(v)))}]'
-
-    if isinstance(v, WithArgsTypes):
-        # Generic alias are constructs like `list[int]`
-        return str(v).replace('typing.', '')
-
-    try:
-        return v.__name__
-    except AttributeError:
-        # happens with typing objects
-        return str(v).replace('typing.', '')
-
-
-def resolve_annotations(raw_annotations: Dict[str, Type[Any]], module_name: Optional[str]) -> Dict[str, Type[Any]]:
-    """
-    Partially taken from typing.get_type_hints.
-
-    Resolve string or ForwardRef annotations into type objects if possible.
-    """
-    base_globals: Optional[Dict[str, Any]] = None
-    if module_name:
-        try:
-            module = sys.modules[module_name]
-        except KeyError:
-            # happens occasionally, see https://github.com/pydantic/pydantic/issues/2363
-            pass
-        else:
-            base_globals = module.__dict__
-
-    annotations = {}
-    for name, value in raw_annotations.items():
-        if isinstance(value, str):
-            if (3, 10) > sys.version_info >= (3, 9, 8) or sys.version_info >= (3, 10, 1):
-                value = ForwardRef(value, is_argument=False, is_class=True)
-            else:
-                value = ForwardRef(value, is_argument=False)
-        try:
-            value = _eval_type(value, base_globals, None)
-        except NameError:
-            # this is ok, it can be fixed with update_forward_refs
-            pass
-        annotations[name] = value
-    return annotations
-
-
-def is_callable_type(type_: Type[Any]) -> bool:
-    return type_ is Callable or get_origin(type_) is Callable
-
-
-def is_literal_type(type_: Type[Any]) -> bool:
-    return Literal is not None and get_origin(type_) is Literal
-
-
-def literal_values(type_: Type[Any]) -> Tuple[Any, ...]:
-    return get_args(type_)
-
-
-def all_literal_values(type_: Type[Any]) -> Tuple[Any, ...]:
-    """
-    This method is used to retrieve all Literal values as
-    Literal can be used recursively (see https://www.python.org/dev/peps/pep-0586)
-    e.g. `Literal[Literal[Literal[1, 2, 3], "foo"], 5, None]`
-    """
-    if not is_literal_type(type_):
-        return (type_,)
-
-    values = literal_values(type_)
-    return tuple(x for value in values for x in all_literal_values(value))
-
-
-def is_namedtuple(type_: Type[Any]) -> bool:
-    """
-    Check if a given class is a named tuple.
-    It can be either a `typing.NamedTuple` or `collections.namedtuple`
-    """
-    from .utils import lenient_issubclass
-
-    return lenient_issubclass(type_, tuple) and hasattr(type_, '_fields')
-
-
-def is_typeddict(type_: Type[Any]) -> bool:
-    """
-    Check if a given class is a typed dict (from `typing` or `typing_extensions`)
-    In 3.10, there will be a public method (https://docs.python.org/3.10/library/typing.html#typing.is_typeddict)
-    """
-    from .utils import lenient_issubclass
-
-    return lenient_issubclass(type_, dict) and hasattr(type_, '__total__')
-
-
-def _check_typeddict_special(type_: Any) -> bool:
-    return type_ is TypedDictRequired or type_ is TypedDictNotRequired
-
-
-def is_typeddict_special(type_: Any) -> bool:
-    """
-    Check if type is a TypedDict special form (Required or NotRequired).
-    """
-    return _check_typeddict_special(type_) or _check_typeddict_special(get_origin(type_))
-
-
-test_type = NewType('test_type', str)
-
-
-def is_new_type(type_: Type[Any]) -> bool:
-    """
-    Check whether type_ was created using typing.NewType
-    """
-    return isinstance(type_, test_type.__class__) and hasattr(type_, '__supertype__')  # type: ignore
-
-
-def new_type_supertype(type_: Type[Any]) -> Type[Any]:
-    while hasattr(type_, '__supertype__'):
-        type_ = type_.__supertype__
-    return type_
-
-
-def _check_classvar(v: Optional[Type[Any]]) -> bool:
-    if v is None:
-        return False
-
-    return v.__class__ == ClassVar.__class__ and getattr(v, '_name', None) == 'ClassVar'
-
-
-def _check_finalvar(v: Optional[Type[Any]]) -> bool:
-    """
-    Check if a given type is a `typing.Final` type.
-    """
-    if v is None:
-        return False
-
-    return v.__class__ == Final.__class__ and (sys.version_info < (3, 8) or getattr(v, '_name', None) == 'Final')
-
-
-def is_classvar(ann_type: Type[Any]) -> bool:
-    if _check_classvar(ann_type) or _check_classvar(get_origin(ann_type)):
-        return True
-
-    # this is an ugly workaround for class vars that contain forward references and are therefore themselves
-    # forward references, see #3679
-    if ann_type.__class__ == ForwardRef and ann_type.__forward_arg__.startswith('ClassVar['):
-        return True
-
-    return False
-
-
-def is_finalvar(ann_type: Type[Any]) -> bool:
-    return _check_finalvar(ann_type) or _check_finalvar(get_origin(ann_type))
-
-
-def update_field_forward_refs(field: 'ModelField', globalns: Any, localns: Any) -> None:
-    """
-    Try to update ForwardRefs on fields based on this ModelField, globalns and localns.
-    """
-    prepare = False
-    if field.type_.__class__ == ForwardRef:
-        prepare = True
-        field.type_ = evaluate_forwardref(field.type_, globalns, localns or None)
-    if field.outer_type_.__class__ == ForwardRef:
-        prepare = True
-        field.outer_type_ = evaluate_forwardref(field.outer_type_, globalns, localns or None)
-    if prepare:
-        field.prepare()
-
-    if field.sub_fields:
-        for sub_f in field.sub_fields:
-            update_field_forward_refs(sub_f, globalns=globalns, localns=localns)
-
-    if field.discriminator_key is not None:
-        field.prepare_discriminated_union_sub_fields()
-
-
-def update_model_forward_refs(
-    model: Type[Any],
-    fields: Iterable['ModelField'],
-    json_encoders: Dict[Union[Type[Any], str, ForwardRef], AnyCallable],
-    localns: 'DictStrAny',
-    exc_to_suppress: Tuple[Type[BaseException], ...] = (),
-) -> None:
-    """
-    Try to update model fields ForwardRefs based on model and localns.
-    """
-    if model.__module__ in sys.modules:
-        globalns = sys.modules[model.__module__].__dict__.copy()
-    else:
-        globalns = {}
-
-    globalns.setdefault(model.__name__, model)
-
-    for f in fields:
-        try:
-            update_field_forward_refs(f, globalns=globalns, localns=localns)
-        except exc_to_suppress:
-            pass
-
-    for key in set(json_encoders.keys()):
-        if isinstance(key, str):
-            fr: ForwardRef = ForwardRef(key)
-        elif isinstance(key, ForwardRef):
-            fr = key
-        else:
-            continue
-
-        try:
-            new_key = evaluate_forwardref(fr, globalns, localns or None)
-        except exc_to_suppress:  # pragma: no cover
-            continue
-
-        json_encoders[new_key] = json_encoders.pop(key)
-
-
-def get_class(type_: Type[Any]) -> Union[None, bool, Type[Any]]:
-    """
-    Tries to get the class of a Type[T] annotation. Returns True if Type is used
-    without brackets. Otherwise returns None.
-    """
-    if type_ is type:
-        return True
-
-    if get_origin(type_) is None:
-        return None
-
-    args = get_args(type_)
-    if not args or not isinstance(args[0], type):
-        return True
-    else:
-        return args[0]
-
-
-def get_sub_types(tp: Any) -> List[Any]:
-    """
-    Return all the types that are allowed by type `tp`
-    `tp` can be a `Union` of allowed types or an `Annotated` type
-    """
-    origin = get_origin(tp)
-    if origin is Annotated:
-        return get_sub_types(get_args(tp)[0])
-    elif is_union(origin):
-        return [x for t in get_args(tp) for x in get_sub_types(t)]
-    else:
-        return [tp]
+__getattr__ = getattr_migration(__name__)
diff --git a/lib/pydantic/utils.py b/lib/pydantic/utils.py
index 1d016c0e..1619d1db 100644
--- a/lib/pydantic/utils.py
+++ b/lib/pydantic/utils.py
@@ -1,841 +1,4 @@
-import keyword
-import warnings
-import weakref
-from collections import OrderedDict, defaultdict, deque
-from copy import deepcopy
-from itertools import islice, zip_longest
-from types import BuiltinFunctionType, CodeType, FunctionType, GeneratorType, LambdaType, ModuleType
-from typing import (
-    TYPE_CHECKING,
-    AbstractSet,
-    Any,
-    Callable,
-    Collection,
-    Dict,
-    Generator,
-    Iterable,
-    Iterator,
-    List,
-    Mapping,
-    MutableMapping,
-    NoReturn,
-    Optional,
-    Set,
-    Tuple,
-    Type,
-    TypeVar,
-    Union,
-)
+"""The `utils` module is a backport module from V1."""
+from ._migration import getattr_migration
 
-from typing_extensions import Annotated
-
-from .errors import ConfigError
-from .typing import (
-    NoneType,
-    WithArgsTypes,
-    all_literal_values,
-    display_as_type,
-    get_args,
-    get_origin,
-    is_literal_type,
-    is_union,
-)
-from .version import version_info
-
-if TYPE_CHECKING:
-    from inspect import Signature
-    from pathlib import Path
-
-    from .config import BaseConfig
-    from .dataclasses import Dataclass
-    from .fields import ModelField
-    from .main import BaseModel
-    from .typing import AbstractSetIntStr, DictIntStrAny, IntStr, MappingIntStrAny, ReprArgs
-
-    RichReprResult = Iterable[Union[Any, Tuple[Any], Tuple[str, Any], Tuple[str, Any, Any]]]
-
-__all__ = (
-    'import_string',
-    'sequence_like',
-    'validate_field_name',
-    'lenient_isinstance',
-    'lenient_issubclass',
-    'in_ipython',
-    'is_valid_identifier',
-    'deep_update',
-    'update_not_none',
-    'almost_equal_floats',
-    'get_model',
-    'to_camel',
-    'is_valid_field',
-    'smart_deepcopy',
-    'PyObjectStr',
-    'Representation',
-    'GetterDict',
-    'ValueItems',
-    'version_info',  # required here to match behaviour in v1.3
-    'ClassAttribute',
-    'path_type',
-    'ROOT_KEY',
-    'get_unique_discriminator_alias',
-    'get_discriminator_alias_and_values',
-    'DUNDER_ATTRIBUTES',
-    'LimitedDict',
-)
-
-ROOT_KEY = '__root__'
-# these are types that are returned unchanged by deepcopy
-IMMUTABLE_NON_COLLECTIONS_TYPES: Set[Type[Any]] = {
-    int,
-    float,
-    complex,
-    str,
-    bool,
-    bytes,
-    type,
-    NoneType,
-    FunctionType,
-    BuiltinFunctionType,
-    LambdaType,
-    weakref.ref,
-    CodeType,
-    # note: including ModuleType will differ from behaviour of deepcopy by not producing error.
-    # It might be not a good idea in general, but considering that this function used only internally
-    # against default values of fields, this will allow to actually have a field with module as default value
-    ModuleType,
-    NotImplemented.__class__,
-    Ellipsis.__class__,
-}
-
-# these are types that if empty, might be copied with simple copy() instead of deepcopy()
-BUILTIN_COLLECTIONS: Set[Type[Any]] = {
-    list,
-    set,
-    tuple,
-    frozenset,
-    dict,
-    OrderedDict,
-    defaultdict,
-    deque,
-}
-
-
-def import_string(dotted_path: str) -> Any:
-    """
-    Stolen approximately from django. Import a dotted module path and return the attribute/class designated by the
-    last name in the path. Raise ImportError if the import fails.
-    """
-    from importlib import import_module
-
-    try:
-        module_path, class_name = dotted_path.strip(' ').rsplit('.', 1)
-    except ValueError as e:
-        raise ImportError(f'"{dotted_path}" doesn\'t look like a module path') from e
-
-    module = import_module(module_path)
-    try:
-        return getattr(module, class_name)
-    except AttributeError as e:
-        raise ImportError(f'Module "{module_path}" does not define a "{class_name}" attribute') from e
-
-
-def truncate(v: Union[str], *, max_len: int = 80) -> str:
-    """
-    Truncate a value and add a unicode ellipsis (three dots) to the end if it was too long
-    """
-    warnings.warn('`truncate` is no-longer used by pydantic and is deprecated', DeprecationWarning)
-    if isinstance(v, str) and len(v) > (max_len - 2):
-        # -3 so quote + string + … + quote has correct length
-        return (v[: (max_len - 3)] + '…').__repr__()
-    try:
-        v = v.__repr__()
-    except TypeError:
-        v = v.__class__.__repr__(v)  # in case v is a type
-    if len(v) > max_len:
-        v = v[: max_len - 1] + '…'
-    return v
-
-
-def sequence_like(v: Any) -> bool:
-    return isinstance(v, (list, tuple, set, frozenset, GeneratorType, deque))
-
-
-def validate_field_name(bases: List[Type['BaseModel']], field_name: str) -> None:
-    """
-    Ensure that the field's name does not shadow an existing attribute of the model.
-    """
-    for base in bases:
-        if getattr(base, field_name, None):
-            raise NameError(
-                f'Field name "{field_name}" shadows a BaseModel attribute; '
-                f'use a different field name with "alias=\'{field_name}\'".'
-            )
-
-
-def lenient_isinstance(o: Any, class_or_tuple: Union[Type[Any], Tuple[Type[Any], ...], None]) -> bool:
-    try:
-        return isinstance(o, class_or_tuple)  # type: ignore[arg-type]
-    except TypeError:
-        return False
-
-
-def lenient_issubclass(cls: Any, class_or_tuple: Union[Type[Any], Tuple[Type[Any], ...], None]) -> bool:
-    try:
-        return isinstance(cls, type) and issubclass(cls, class_or_tuple)  # type: ignore[arg-type]
-    except TypeError:
-        if isinstance(cls, WithArgsTypes):
-            return False
-        raise  # pragma: no cover
-
-
-def in_ipython() -> bool:
-    """
-    Check whether we're in an ipython environment, including jupyter notebooks.
-    """
-    try:
-        eval('__IPYTHON__')
-    except NameError:
-        return False
-    else:  # pragma: no cover
-        return True
-
-
-def is_valid_identifier(identifier: str) -> bool:
-    """
-    Checks that a string is a valid identifier and not a Python keyword.
-    :param identifier: The identifier to test.
-    :return: True if the identifier is valid.
-    """
-    return identifier.isidentifier() and not keyword.iskeyword(identifier)
-
-
-KeyType = TypeVar('KeyType')
-
-
-def deep_update(mapping: Dict[KeyType, Any], *updating_mappings: Dict[KeyType, Any]) -> Dict[KeyType, Any]:
-    updated_mapping = mapping.copy()
-    for updating_mapping in updating_mappings:
-        for k, v in updating_mapping.items():
-            if k in updated_mapping and isinstance(updated_mapping[k], dict) and isinstance(v, dict):
-                updated_mapping[k] = deep_update(updated_mapping[k], v)
-            else:
-                updated_mapping[k] = v
-    return updated_mapping
-
-
-def update_not_none(mapping: Dict[Any, Any], **update: Any) -> None:
-    mapping.update({k: v for k, v in update.items() if v is not None})
-
-
-def almost_equal_floats(value_1: float, value_2: float, *, delta: float = 1e-8) -> bool:
-    """
-    Return True if two floats are almost equal
-    """
-    return abs(value_1 - value_2) <= delta
-
-
-def generate_model_signature(
-    init: Callable[..., None], fields: Dict[str, 'ModelField'], config: Type['BaseConfig']
-) -> 'Signature':
-    """
-    Generate signature for model based on its fields
-    """
-    from inspect import Parameter, Signature, signature
-
-    from .config import Extra
-
-    present_params = signature(init).parameters.values()
-    merged_params: Dict[str, Parameter] = {}
-    var_kw = None
-    use_var_kw = False
-
-    for param in islice(present_params, 1, None):  # skip self arg
-        if param.kind is param.VAR_KEYWORD:
-            var_kw = param
-            continue
-        merged_params[param.name] = param
-
-    if var_kw:  # if custom init has no var_kw, fields which are not declared in it cannot be passed through
-        allow_names = config.allow_population_by_field_name
-        for field_name, field in fields.items():
-            param_name = field.alias
-            if field_name in merged_params or param_name in merged_params:
-                continue
-            elif not is_valid_identifier(param_name):
-                if allow_names and is_valid_identifier(field_name):
-                    param_name = field_name
-                else:
-                    use_var_kw = True
-                    continue
-
-            # TODO: replace annotation with actual expected types once #1055 solved
-            kwargs = {'default': field.default} if not field.required else {}
-            merged_params[param_name] = Parameter(
-                param_name, Parameter.KEYWORD_ONLY, annotation=field.annotation, **kwargs
-            )
-
-    if config.extra is Extra.allow:
-        use_var_kw = True
-
-    if var_kw and use_var_kw:
-        # Make sure the parameter for extra kwargs
-        # does not have the same name as a field
-        default_model_signature = [
-            ('__pydantic_self__', Parameter.POSITIONAL_OR_KEYWORD),
-            ('data', Parameter.VAR_KEYWORD),
-        ]
-        if [(p.name, p.kind) for p in present_params] == default_model_signature:
-            # if this is the standard model signature, use extra_data as the extra args name
-            var_kw_name = 'extra_data'
-        else:
-            # else start from var_kw
-            var_kw_name = var_kw.name
-
-        # generate a name that's definitely unique
-        while var_kw_name in fields:
-            var_kw_name += '_'
-        merged_params[var_kw_name] = var_kw.replace(name=var_kw_name)
-
-    return Signature(parameters=list(merged_params.values()), return_annotation=None)
-
-
-def get_model(obj: Union[Type['BaseModel'], Type['Dataclass']]) -> Type['BaseModel']:
-    from .main import BaseModel
-
-    try:
-        model_cls = obj.__pydantic_model__  # type: ignore
-    except AttributeError:
-        model_cls = obj
-
-    if not issubclass(model_cls, BaseModel):
-        raise TypeError('Unsupported type, must be either BaseModel or dataclass')
-    return model_cls
-
-
-def to_camel(string: str) -> str:
-    return ''.join(word.capitalize() for word in string.split('_'))
-
-
-def to_lower_camel(string: str) -> str:
-    if len(string) >= 1:
-        pascal_string = to_camel(string)
-        return pascal_string[0].lower() + pascal_string[1:]
-    return string.lower()
-
-
-T = TypeVar('T')
-
-
-def unique_list(
-    input_list: Union[List[T], Tuple[T, ...]],
-    *,
-    name_factory: Callable[[T], str] = str,
-) -> List[T]:
-    """
-    Make a list unique while maintaining order.
-    We update the list if another one with the same name is set
-    (e.g. root validator overridden in subclass)
-    """
-    result: List[T] = []
-    result_names: List[str] = []
-    for v in input_list:
-        v_name = name_factory(v)
-        if v_name not in result_names:
-            result_names.append(v_name)
-            result.append(v)
-        else:
-            result[result_names.index(v_name)] = v
-
-    return result
-
-
-class PyObjectStr(str):
-    """
-    String class where repr doesn't include quotes. Useful with Representation when you want to return a string
-    representation of something that valid (or pseudo-valid) python.
-    """
-
-    def __repr__(self) -> str:
-        return str(self)
-
-
-class Representation:
-    """
-    Mixin to provide __str__, __repr__, and __pretty__ methods. See #884 for more details.
-
-    __pretty__ is used by [devtools](https://python-devtools.helpmanual.io/) to provide human readable representations
-    of objects.
-    """
-
-    __slots__: Tuple[str, ...] = tuple()
-
-    def __repr_args__(self) -> 'ReprArgs':
-        """
-        Returns the attributes to show in __str__, __repr__, and __pretty__ this is generally overridden.
-
-        Can either return:
-        * name - value pairs, e.g.: `[('foo_name', 'foo'), ('bar_name', ['b', 'a', 'r'])]`
-        * or, just values, e.g.: `[(None, 'foo'), (None, ['b', 'a', 'r'])]`
-        """
-        attrs = ((s, getattr(self, s)) for s in self.__slots__)
-        return [(a, v) for a, v in attrs if v is not None]
-
-    def __repr_name__(self) -> str:
-        """
-        Name of the instance's class, used in __repr__.
-        """
-        return self.__class__.__name__
-
-    def __repr_str__(self, join_str: str) -> str:
-        return join_str.join(repr(v) if a is None else f'{a}={v!r}' for a, v in self.__repr_args__())
-
-    def __pretty__(self, fmt: Callable[[Any], Any], **kwargs: Any) -> Generator[Any, None, None]:
-        """
-        Used by devtools (https://python-devtools.helpmanual.io/) to provide a human readable representations of objects
-        """
-        yield self.__repr_name__() + '('
-        yield 1
-        for name, value in self.__repr_args__():
-            if name is not None:
-                yield name + '='
-            yield fmt(value)
-            yield ','
-            yield 0
-        yield -1
-        yield ')'
-
-    def __str__(self) -> str:
-        return self.__repr_str__(' ')
-
-    def __repr__(self) -> str:
-        return f'{self.__repr_name__()}({self.__repr_str__(", ")})'
-
-    def __rich_repr__(self) -> 'RichReprResult':
-        """Get fields for Rich library"""
-        for name, field_repr in self.__repr_args__():
-            if name is None:
-                yield field_repr
-            else:
-                yield name, field_repr
-
-
-class GetterDict(Representation):
-    """
-    Hack to make object's smell just enough like dicts for validate_model.
-
-    We can't inherit from Mapping[str, Any] because it upsets cython so we have to implement all methods ourselves.
-    """
-
-    __slots__ = ('_obj',)
-
-    def __init__(self, obj: Any):
-        self._obj = obj
-
-    def __getitem__(self, key: str) -> Any:
-        try:
-            return getattr(self._obj, key)
-        except AttributeError as e:
-            raise KeyError(key) from e
-
-    def get(self, key: Any, default: Any = None) -> Any:
-        return getattr(self._obj, key, default)
-
-    def extra_keys(self) -> Set[Any]:
-        """
-        We don't want to get any other attributes of obj if the model didn't explicitly ask for them
-        """
-        return set()
-
-    def keys(self) -> List[Any]:
-        """
-        Keys of the pseudo dictionary, uses a list not set so order information can be maintained like python
-        dictionaries.
-        """
-        return list(self)
-
-    def values(self) -> List[Any]:
-        return [self[k] for k in self]
-
-    def items(self) -> Iterator[Tuple[str, Any]]:
-        for k in self:
-            yield k, self.get(k)
-
-    def __iter__(self) -> Iterator[str]:
-        for name in dir(self._obj):
-            if not name.startswith('_'):
-                yield name
-
-    def __len__(self) -> int:
-        return sum(1 for _ in self)
-
-    def __contains__(self, item: Any) -> bool:
-        return item in self.keys()
-
-    def __eq__(self, other: Any) -> bool:
-        return dict(self) == dict(other.items())
-
-    def __repr_args__(self) -> 'ReprArgs':
-        return [(None, dict(self))]
-
-    def __repr_name__(self) -> str:
-        return f'GetterDict[{display_as_type(self._obj)}]'
-
-
-class ValueItems(Representation):
-    """
-    Class for more convenient calculation of excluded or included fields on values.
-    """
-
-    __slots__ = ('_items', '_type')
-
-    def __init__(self, value: Any, items: Union['AbstractSetIntStr', 'MappingIntStrAny']) -> None:
-        items = self._coerce_items(items)
-
-        if isinstance(value, (list, tuple)):
-            items = self._normalize_indexes(items, len(value))
-
-        self._items: 'MappingIntStrAny' = items
-
-    def is_excluded(self, item: Any) -> bool:
-        """
-        Check if item is fully excluded.
-
-        :param item: key or index of a value
-        """
-        return self.is_true(self._items.get(item))
-
-    def is_included(self, item: Any) -> bool:
-        """
-        Check if value is contained in self._items
-
-        :param item: key or index of value
-        """
-        return item in self._items
-
-    def for_element(self, e: 'IntStr') -> Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']]:
-        """
-        :param e: key or index of element on value
-        :return: raw values for element if self._items is dict and contain needed element
-        """
-
-        item = self._items.get(e)
-        return item if not self.is_true(item) else None
-
-    def _normalize_indexes(self, items: 'MappingIntStrAny', v_length: int) -> 'DictIntStrAny':
-        """
-        :param items: dict or set of indexes which will be normalized
-        :param v_length: length of sequence indexes of which will be
-
-        >>> self._normalize_indexes({0: True, -2: True, -1: True}, 4)
-        {0: True, 2: True, 3: True}
-        >>> self._normalize_indexes({'__all__': True}, 4)
-        {0: True, 1: True, 2: True, 3: True}
-        """
-
-        normalized_items: 'DictIntStrAny' = {}
-        all_items = None
-        for i, v in items.items():
-            if not (isinstance(v, Mapping) or isinstance(v, AbstractSet) or self.is_true(v)):
-                raise TypeError(f'Unexpected type of exclude value for index "{i}" {v.__class__}')
-            if i == '__all__':
-                all_items = self._coerce_value(v)
-                continue
-            if not isinstance(i, int):
-                raise TypeError(
-                    'Excluding fields from a sequence of sub-models or dicts must be performed index-wise: '
-                    'expected integer keys or keyword "__all__"'
-                )
-            normalized_i = v_length + i if i < 0 else i
-            normalized_items[normalized_i] = self.merge(v, normalized_items.get(normalized_i))
-
-        if not all_items:
-            return normalized_items
-        if self.is_true(all_items):
-            for i in range(v_length):
-                normalized_items.setdefault(i, ...)
-            return normalized_items
-        for i in range(v_length):
-            normalized_item = normalized_items.setdefault(i, {})
-            if not self.is_true(normalized_item):
-                normalized_items[i] = self.merge(all_items, normalized_item)
-        return normalized_items
-
-    @classmethod
-    def merge(cls, base: Any, override: Any, intersect: bool = False) -> Any:
-        """
-        Merge a ``base`` item with an ``override`` item.
-
-        Both ``base`` and ``override`` are converted to dictionaries if possible.
-        Sets are converted to dictionaries with the sets entries as keys and
-        Ellipsis as values.
-
-        Each key-value pair existing in ``base`` is merged with ``override``,
-        while the rest of the key-value pairs are updated recursively with this function.
-
-        Merging takes place based on the "union" of keys if ``intersect`` is
-        set to ``False`` (default) and on the intersection of keys if
-        ``intersect`` is set to ``True``.
-        """
-        override = cls._coerce_value(override)
-        base = cls._coerce_value(base)
-        if override is None:
-            return base
-        if cls.is_true(base) or base is None:
-            return override
-        if cls.is_true(override):
-            return base if intersect else override
-
-        # intersection or union of keys while preserving ordering:
-        if intersect:
-            merge_keys = [k for k in base if k in override] + [k for k in override if k in base]
-        else:
-            merge_keys = list(base) + [k for k in override if k not in base]
-
-        merged: 'DictIntStrAny' = {}
-        for k in merge_keys:
-            merged_item = cls.merge(base.get(k), override.get(k), intersect=intersect)
-            if merged_item is not None:
-                merged[k] = merged_item
-
-        return merged
-
-    @staticmethod
-    def _coerce_items(items: Union['AbstractSetIntStr', 'MappingIntStrAny']) -> 'MappingIntStrAny':
-        if isinstance(items, Mapping):
-            pass
-        elif isinstance(items, AbstractSet):
-            items = dict.fromkeys(items, ...)
-        else:
-            class_name = getattr(items, '__class__', '???')
-            assert_never(
-                items,
-                f'Unexpected type of exclude value {class_name}',
-            )
-        return items
-
-    @classmethod
-    def _coerce_value(cls, value: Any) -> Any:
-        if value is None or cls.is_true(value):
-            return value
-        return cls._coerce_items(value)
-
-    @staticmethod
-    def is_true(v: Any) -> bool:
-        return v is True or v is ...
-
-    def __repr_args__(self) -> 'ReprArgs':
-        return [(None, self._items)]
-
-
-class ClassAttribute:
-    """
-    Hide class attribute from its instances
-    """
-
-    __slots__ = (
-        'name',
-        'value',
-    )
-
-    def __init__(self, name: str, value: Any) -> None:
-        self.name = name
-        self.value = value
-
-    def __get__(self, instance: Any, owner: Type[Any]) -> None:
-        if instance is None:
-            return self.value
-        raise AttributeError(f'{self.name!r} attribute of {owner.__name__!r} is class-only')
-
-
-path_types = {
-    'is_dir': 'directory',
-    'is_file': 'file',
-    'is_mount': 'mount point',
-    'is_symlink': 'symlink',
-    'is_block_device': 'block device',
-    'is_char_device': 'char device',
-    'is_fifo': 'FIFO',
-    'is_socket': 'socket',
-}
-
-
-def path_type(p: 'Path') -> str:
-    """
-    Find out what sort of thing a path is.
-    """
-    assert p.exists(), 'path does not exist'
-    for method, name in path_types.items():
-        if getattr(p, method)():
-            return name
-
-    return 'unknown'
-
-
-Obj = TypeVar('Obj')
-
-
-def smart_deepcopy(obj: Obj) -> Obj:
-    """
-    Return type as is for immutable built-in types
-    Use obj.copy() for built-in empty collections
-    Use copy.deepcopy() for non-empty collections and unknown objects
-    """
-
-    obj_type = obj.__class__
-    if obj_type in IMMUTABLE_NON_COLLECTIONS_TYPES:
-        return obj  # fastest case: obj is immutable and not collection therefore will not be copied anyway
-    try:
-        if not obj and obj_type in BUILTIN_COLLECTIONS:
-            # faster way for empty collections, no need to copy its members
-            return obj if obj_type is tuple else obj.copy()  # type: ignore  # tuple doesn't have copy method
-    except (TypeError, ValueError, RuntimeError):
-        # do we really dare to catch ALL errors? Seems a bit risky
-        pass
-
-    return deepcopy(obj)  # slowest way when we actually might need a deepcopy
-
-
-def is_valid_field(name: str) -> bool:
-    if not name.startswith('_'):
-        return True
-    return ROOT_KEY == name
-
-
-DUNDER_ATTRIBUTES = {
-    '__annotations__',
-    '__classcell__',
-    '__doc__',
-    '__module__',
-    '__orig_bases__',
-    '__orig_class__',
-    '__qualname__',
-}
-
-
-def is_valid_private_name(name: str) -> bool:
-    return not is_valid_field(name) and name not in DUNDER_ATTRIBUTES
-
-
-_EMPTY = object()
-
-
-def all_identical(left: Iterable[Any], right: Iterable[Any]) -> bool:
-    """
-    Check that the items of `left` are the same objects as those in `right`.
-
-    >>> a, b = object(), object()
-    >>> all_identical([a, b, a], [a, b, a])
-    True
-    >>> all_identical([a, b, [a]], [a, b, [a]])  # new list object, while "equal" is not "identical"
-    False
-    """
-    for left_item, right_item in zip_longest(left, right, fillvalue=_EMPTY):
-        if left_item is not right_item:
-            return False
-    return True
-
-
-def assert_never(obj: NoReturn, msg: str) -> NoReturn:
-    """
-    Helper to make sure that we have covered all possible types.
-
-    This is mostly useful for ``mypy``, docs:
-    https://mypy.readthedocs.io/en/latest/literal_types.html#exhaustive-checks
-    """
-    raise TypeError(msg)
-
-
-def get_unique_discriminator_alias(all_aliases: Collection[str], discriminator_key: str) -> str:
-    """Validate that all aliases are the same and if that's the case return the alias"""
-    unique_aliases = set(all_aliases)
-    if len(unique_aliases) > 1:
-        raise ConfigError(
-            f'Aliases for discriminator {discriminator_key!r} must be the same (got {", ".join(sorted(all_aliases))})'
-        )
-    return unique_aliases.pop()
-
-
-def get_discriminator_alias_and_values(tp: Any, discriminator_key: str) -> Tuple[str, Tuple[str, ...]]:
-    """
-    Get alias and all valid values in the `Literal` type of the discriminator field
-    `tp` can be a `BaseModel` class or directly an `Annotated` `Union` of many.
-    """
-    is_root_model = getattr(tp, '__custom_root_type__', False)
-
-    if get_origin(tp) is Annotated:
-        tp = get_args(tp)[0]
-
-    if hasattr(tp, '__pydantic_model__'):
-        tp = tp.__pydantic_model__
-
-    if is_union(get_origin(tp)):
-        alias, all_values = _get_union_alias_and_all_values(tp, discriminator_key)
-        return alias, tuple(v for values in all_values for v in values)
-    elif is_root_model:
-        union_type = tp.__fields__[ROOT_KEY].type_
-        alias, all_values = _get_union_alias_and_all_values(union_type, discriminator_key)
-
-        if len(set(all_values)) > 1:
-            raise ConfigError(
-                f'Field {discriminator_key!r} is not the same for all submodels of {display_as_type(tp)!r}'
-            )
-
-        return alias, all_values[0]
-
-    else:
-        try:
-            t_discriminator_type = tp.__fields__[discriminator_key].type_
-        except AttributeError as e:
-            raise TypeError(f'Type {tp.__name__!r} is not a valid `BaseModel` or `dataclass`') from e
-        except KeyError as e:
-            raise ConfigError(f'Model {tp.__name__!r} needs a discriminator field for key {discriminator_key!r}') from e
-
-        if not is_literal_type(t_discriminator_type):
-            raise ConfigError(f'Field {discriminator_key!r} of model {tp.__name__!r} needs to be a `Literal`')
-
-        return tp.__fields__[discriminator_key].alias, all_literal_values(t_discriminator_type)
-
-
-def _get_union_alias_and_all_values(
-    union_type: Type[Any], discriminator_key: str
-) -> Tuple[str, Tuple[Tuple[str, ...], ...]]:
-    zipped_aliases_values = [get_discriminator_alias_and_values(t, discriminator_key) for t in get_args(union_type)]
-    # unzip: [('alias_a',('v1', 'v2)), ('alias_b', ('v3',))] => [('alias_a', 'alias_b'), (('v1', 'v2'), ('v3',))]
-    all_aliases, all_values = zip(*zipped_aliases_values)
-    return get_unique_discriminator_alias(all_aliases, discriminator_key), all_values
-
-
-KT = TypeVar('KT')
-VT = TypeVar('VT')
-if TYPE_CHECKING:
-    # Annoying inheriting from `MutableMapping` and `dict` breaks cython, hence this work around
-    class LimitedDict(dict, MutableMapping[KT, VT]):  # type: ignore[type-arg]
-        def __init__(self, size_limit: int = 1000):
-            ...
-
-else:
-
-    class LimitedDict(dict):
-        """
-        Limit the size/length of a dict used for caching to avoid unlimited increase in memory usage.
-
-        Since the dict is ordered, and we always remove elements from the beginning, this is effectively a FIFO cache.
-
-        Annoying inheriting from `MutableMapping` breaks cython.
-        """
-
-        def __init__(self, size_limit: int = 1000):
-            self.size_limit = size_limit
-            super().__init__()
-
-        def __setitem__(self, __key: Any, __value: Any) -> None:
-            super().__setitem__(__key, __value)
-            if len(self) > self.size_limit:
-                excess = len(self) - self.size_limit + self.size_limit // 10
-                to_remove = list(self.keys())[:excess]
-                for key in to_remove:
-                    del self[key]
-
-        def __class_getitem__(cls, *args: Any) -> Any:
-            # to avoid errors with 3.7
-            pass
+__getattr__ = getattr_migration(__name__)
diff --git a/lib/pydantic/v1/__init__.py b/lib/pydantic/v1/__init__.py
new file mode 100644
index 00000000..3bf1418f
--- /dev/null
+++ b/lib/pydantic/v1/__init__.py
@@ -0,0 +1,131 @@
+# flake8: noqa
+from . import dataclasses
+from .annotated_types import create_model_from_namedtuple, create_model_from_typeddict
+from .class_validators import root_validator, validator
+from .config import BaseConfig, ConfigDict, Extra
+from .decorator import validate_arguments
+from .env_settings import BaseSettings
+from .error_wrappers import ValidationError
+from .errors import *
+from .fields import Field, PrivateAttr, Required
+from .main import *
+from .networks import *
+from .parse import Protocol
+from .tools import *
+from .types import *
+from .version import VERSION, compiled
+
+__version__ = VERSION
+
+# WARNING __all__ from .errors is not included here, it will be removed as an export here in v2
+# please use "from pydantic.errors import ..." instead
+__all__ = [
+    # annotated types utils
+    'create_model_from_namedtuple',
+    'create_model_from_typeddict',
+    # dataclasses
+    'dataclasses',
+    # class_validators
+    'root_validator',
+    'validator',
+    # config
+    'BaseConfig',
+    'ConfigDict',
+    'Extra',
+    # decorator
+    'validate_arguments',
+    # env_settings
+    'BaseSettings',
+    # error_wrappers
+    'ValidationError',
+    # fields
+    'Field',
+    'Required',
+    # main
+    'BaseModel',
+    'create_model',
+    'validate_model',
+    # network
+    'AnyUrl',
+    'AnyHttpUrl',
+    'FileUrl',
+    'HttpUrl',
+    'stricturl',
+    'EmailStr',
+    'NameEmail',
+    'IPvAnyAddress',
+    'IPvAnyInterface',
+    'IPvAnyNetwork',
+    'PostgresDsn',
+    'CockroachDsn',
+    'AmqpDsn',
+    'RedisDsn',
+    'MongoDsn',
+    'KafkaDsn',
+    'validate_email',
+    # parse
+    'Protocol',
+    # tools
+    'parse_file_as',
+    'parse_obj_as',
+    'parse_raw_as',
+    'schema_of',
+    'schema_json_of',
+    # types
+    'NoneStr',
+    'NoneBytes',
+    'StrBytes',
+    'NoneStrBytes',
+    'StrictStr',
+    'ConstrainedBytes',
+    'conbytes',
+    'ConstrainedList',
+    'conlist',
+    'ConstrainedSet',
+    'conset',
+    'ConstrainedFrozenSet',
+    'confrozenset',
+    'ConstrainedStr',
+    'constr',
+    'PyObject',
+    'ConstrainedInt',
+    'conint',
+    'PositiveInt',
+    'NegativeInt',
+    'NonNegativeInt',
+    'NonPositiveInt',
+    'ConstrainedFloat',
+    'confloat',
+    'PositiveFloat',
+    'NegativeFloat',
+    'NonNegativeFloat',
+    'NonPositiveFloat',
+    'FiniteFloat',
+    'ConstrainedDecimal',
+    'condecimal',
+    'ConstrainedDate',
+    'condate',
+    'UUID1',
+    'UUID3',
+    'UUID4',
+    'UUID5',
+    'FilePath',
+    'DirectoryPath',
+    'Json',
+    'JsonWrapper',
+    'SecretField',
+    'SecretStr',
+    'SecretBytes',
+    'StrictBool',
+    'StrictBytes',
+    'StrictInt',
+    'StrictFloat',
+    'PaymentCardNumber',
+    'PrivateAttr',
+    'ByteSize',
+    'PastDate',
+    'FutureDate',
+    # version
+    'compiled',
+    'VERSION',
+]
diff --git a/lib/pydantic/_hypothesis_plugin.py b/lib/pydantic/v1/_hypothesis_plugin.py
similarity index 97%
rename from lib/pydantic/_hypothesis_plugin.py
rename to lib/pydantic/v1/_hypothesis_plugin.py
index a56d2b98..0c529620 100644
--- a/lib/pydantic/_hypothesis_plugin.py
+++ b/lib/pydantic/v1/_hypothesis_plugin.py
@@ -10,7 +10,7 @@ Pydantic is installed.  See also:
 https://hypothesis.readthedocs.io/en/latest/strategies.html#registering-strategies-via-setuptools-entry-points
 https://hypothesis.readthedocs.io/en/latest/data.html#hypothesis.strategies.register_type_strategy
 https://hypothesis.readthedocs.io/en/latest/strategies.html#interaction-with-pytest-cov
-https://pydantic-docs.helpmanual.io/usage/types/#pydantic-types
+https://docs.pydantic.dev/usage/types/#pydantic-types
 
 Note that because our motivation is to *improve user experience*, the strategies
 are always sound (never generate invalid data) but sacrifice completeness for
@@ -46,7 +46,7 @@ from pydantic.utils import lenient_issubclass
 #
 # conlist() and conset() are unsupported for now, because the workarounds for
 # Cython and Hypothesis to handle parametrized generic types are incompatible.
-# Once Cython can support 'normal' generics we'll revisit this.
+# We are rethinking Hypothesis compatibility in Pydantic v2.
 
 # Emails
 try:
@@ -168,6 +168,11 @@ st.register_type_strategy(pydantic.StrictBool, st.booleans())
 st.register_type_strategy(pydantic.StrictStr, st.text())
 
 
+# FutureDate, PastDate
+st.register_type_strategy(pydantic.FutureDate, st.dates(min_value=datetime.date.today() + datetime.timedelta(days=1)))
+st.register_type_strategy(pydantic.PastDate, st.dates(max_value=datetime.date.today() - datetime.timedelta(days=1)))
+
+
 # Constrained-type resolver functions
 #
 # For these ones, we actually want to inspect the type in order to work out a
diff --git a/lib/pydantic/annotated_types.py b/lib/pydantic/v1/annotated_types.py
similarity index 100%
rename from lib/pydantic/annotated_types.py
rename to lib/pydantic/v1/annotated_types.py
diff --git a/lib/pydantic/v1/class_validators.py b/lib/pydantic/v1/class_validators.py
new file mode 100644
index 00000000..71e66509
--- /dev/null
+++ b/lib/pydantic/v1/class_validators.py
@@ -0,0 +1,361 @@
+import warnings
+from collections import ChainMap
+from functools import partial, partialmethod, wraps
+from itertools import chain
+from types import FunctionType
+from typing import TYPE_CHECKING, Any, Callable, Dict, Iterable, List, Optional, Set, Tuple, Type, Union, overload
+
+from .errors import ConfigError
+from .typing import AnyCallable
+from .utils import ROOT_KEY, in_ipython
+
+if TYPE_CHECKING:
+    from .typing import AnyClassMethod
+
+
+class Validator:
+    __slots__ = 'func', 'pre', 'each_item', 'always', 'check_fields', 'skip_on_failure'
+
+    def __init__(
+        self,
+        func: AnyCallable,
+        pre: bool = False,
+        each_item: bool = False,
+        always: bool = False,
+        check_fields: bool = False,
+        skip_on_failure: bool = False,
+    ):
+        self.func = func
+        self.pre = pre
+        self.each_item = each_item
+        self.always = always
+        self.check_fields = check_fields
+        self.skip_on_failure = skip_on_failure
+
+
+if TYPE_CHECKING:
+    from inspect import Signature
+
+    from .config import BaseConfig
+    from .fields import ModelField
+    from .types import ModelOrDc
+
+    ValidatorCallable = Callable[[Optional[ModelOrDc], Any, Dict[str, Any], ModelField, Type[BaseConfig]], Any]
+    ValidatorsList = List[ValidatorCallable]
+    ValidatorListDict = Dict[str, List[Validator]]
+
+_FUNCS: Set[str] = set()
+VALIDATOR_CONFIG_KEY = '__validator_config__'
+ROOT_VALIDATOR_CONFIG_KEY = '__root_validator_config__'
+
+
+def validator(
+    *fields: str,
+    pre: bool = False,
+    each_item: bool = False,
+    always: bool = False,
+    check_fields: bool = True,
+    whole: Optional[bool] = None,
+    allow_reuse: bool = False,
+) -> Callable[[AnyCallable], 'AnyClassMethod']:
+    """
+    Decorate methods on the class indicating that they should be used to validate fields
+    :param fields: which field(s) the method should be called on
+    :param pre: whether or not this validator should be called before the standard validators (else after)
+    :param each_item: for complex objects (sets, lists etc.) whether to validate individual elements rather than the
+      whole object
+    :param always: whether this method and other validators should be called even if the value is missing
+    :param check_fields: whether to check that the fields actually exist on the model
+    :param allow_reuse: whether to track and raise an error if another validator refers to the decorated function
+    """
+    if not fields:
+        raise ConfigError('validator with no fields specified')
+    elif isinstance(fields[0], FunctionType):
+        raise ConfigError(
+            "validators should be used with fields and keyword arguments, not bare. "  # noqa: Q000
+            "E.g. usage should be `@validator('<field_name>', ...)`"
+        )
+    elif not all(isinstance(field, str) for field in fields):
+        raise ConfigError(
+            "validator fields should be passed as separate string args. "  # noqa: Q000
+            "E.g. usage should be `@validator('<field_name_1>', '<field_name_2>', ...)`"
+        )
+
+    if whole is not None:
+        warnings.warn(
+            'The "whole" keyword argument is deprecated, use "each_item" (inverse meaning, default False) instead',
+            DeprecationWarning,
+        )
+        assert each_item is False, '"each_item" and "whole" conflict, remove "whole"'
+        each_item = not whole
+
+    def dec(f: AnyCallable) -> 'AnyClassMethod':
+        f_cls = _prepare_validator(f, allow_reuse)
+        setattr(
+            f_cls,
+            VALIDATOR_CONFIG_KEY,
+            (
+                fields,
+                Validator(func=f_cls.__func__, pre=pre, each_item=each_item, always=always, check_fields=check_fields),
+            ),
+        )
+        return f_cls
+
+    return dec
+
+
+@overload
+def root_validator(_func: AnyCallable) -> 'AnyClassMethod':
+    ...
+
+
+@overload
+def root_validator(
+    *, pre: bool = False, allow_reuse: bool = False, skip_on_failure: bool = False
+) -> Callable[[AnyCallable], 'AnyClassMethod']:
+    ...
+
+
+def root_validator(
+    _func: Optional[AnyCallable] = None, *, pre: bool = False, allow_reuse: bool = False, skip_on_failure: bool = False
+) -> Union['AnyClassMethod', Callable[[AnyCallable], 'AnyClassMethod']]:
+    """
+    Decorate methods on a model indicating that they should be used to validate (and perhaps modify) data either
+    before or after standard model parsing/validation is performed.
+    """
+    if _func:
+        f_cls = _prepare_validator(_func, allow_reuse)
+        setattr(
+            f_cls, ROOT_VALIDATOR_CONFIG_KEY, Validator(func=f_cls.__func__, pre=pre, skip_on_failure=skip_on_failure)
+        )
+        return f_cls
+
+    def dec(f: AnyCallable) -> 'AnyClassMethod':
+        f_cls = _prepare_validator(f, allow_reuse)
+        setattr(
+            f_cls, ROOT_VALIDATOR_CONFIG_KEY, Validator(func=f_cls.__func__, pre=pre, skip_on_failure=skip_on_failure)
+        )
+        return f_cls
+
+    return dec
+
+
+def _prepare_validator(function: AnyCallable, allow_reuse: bool) -> 'AnyClassMethod':
+    """
+    Avoid validators with duplicated names since without this, validators can be overwritten silently
+    which generally isn't the intended behaviour, don't run in ipython (see #312) or if allow_reuse is False.
+    """
+    f_cls = function if isinstance(function, classmethod) else classmethod(function)
+    if not in_ipython() and not allow_reuse:
+        ref = (
+            getattr(f_cls.__func__, '__module__', '<No __module__>')
+            + '.'
+            + getattr(f_cls.__func__, '__qualname__', f'<No __qualname__: id:{id(f_cls.__func__)}>')
+        )
+        if ref in _FUNCS:
+            raise ConfigError(f'duplicate validator function "{ref}"; if this is intended, set `allow_reuse=True`')
+        _FUNCS.add(ref)
+    return f_cls
+
+
+class ValidatorGroup:
+    def __init__(self, validators: 'ValidatorListDict') -> None:
+        self.validators = validators
+        self.used_validators = {'*'}
+
+    def get_validators(self, name: str) -> Optional[Dict[str, Validator]]:
+        self.used_validators.add(name)
+        validators = self.validators.get(name, [])
+        if name != ROOT_KEY:
+            validators += self.validators.get('*', [])
+        if validators:
+            return {getattr(v.func, '__name__', f'<No __name__: id:{id(v.func)}>'): v for v in validators}
+        else:
+            return None
+
+    def check_for_unused(self) -> None:
+        unused_validators = set(
+            chain.from_iterable(
+                (
+                    getattr(v.func, '__name__', f'<No __name__: id:{id(v.func)}>')
+                    for v in self.validators[f]
+                    if v.check_fields
+                )
+                for f in (self.validators.keys() - self.used_validators)
+            )
+        )
+        if unused_validators:
+            fn = ', '.join(unused_validators)
+            raise ConfigError(
+                f"Validators defined with incorrect fields: {fn} "  # noqa: Q000
+                f"(use check_fields=False if you're inheriting from the model and intended this)"
+            )
+
+
+def extract_validators(namespace: Dict[str, Any]) -> Dict[str, List[Validator]]:
+    validators: Dict[str, List[Validator]] = {}
+    for var_name, value in namespace.items():
+        validator_config = getattr(value, VALIDATOR_CONFIG_KEY, None)
+        if validator_config:
+            fields, v = validator_config
+            for field in fields:
+                if field in validators:
+                    validators[field].append(v)
+                else:
+                    validators[field] = [v]
+    return validators
+
+
+def extract_root_validators(namespace: Dict[str, Any]) -> Tuple[List[AnyCallable], List[Tuple[bool, AnyCallable]]]:
+    from inspect import signature
+
+    pre_validators: List[AnyCallable] = []
+    post_validators: List[Tuple[bool, AnyCallable]] = []
+    for name, value in namespace.items():
+        validator_config: Optional[Validator] = getattr(value, ROOT_VALIDATOR_CONFIG_KEY, None)
+        if validator_config:
+            sig = signature(validator_config.func)
+            args = list(sig.parameters.keys())
+            if args[0] == 'self':
+                raise ConfigError(
+                    f'Invalid signature for root validator {name}: {sig}, "self" not permitted as first argument, '
+                    f'should be: (cls, values).'
+                )
+            if len(args) != 2:
+                raise ConfigError(f'Invalid signature for root validator {name}: {sig}, should be: (cls, values).')
+            # check function signature
+            if validator_config.pre:
+                pre_validators.append(validator_config.func)
+            else:
+                post_validators.append((validator_config.skip_on_failure, validator_config.func))
+    return pre_validators, post_validators
+
+
+def inherit_validators(base_validators: 'ValidatorListDict', validators: 'ValidatorListDict') -> 'ValidatorListDict':
+    for field, field_validators in base_validators.items():
+        if field not in validators:
+            validators[field] = []
+        validators[field] += field_validators
+    return validators
+
+
+def make_generic_validator(validator: AnyCallable) -> 'ValidatorCallable':
+    """
+    Make a generic function which calls a validator with the right arguments.
+
+    Unfortunately other approaches (eg. return a partial of a function that builds the arguments) is slow,
+    hence this laborious way of doing things.
+
+    It's done like this so validators don't all need **kwargs in their signature, eg. any combination of
+    the arguments "values", "fields" and/or "config" are permitted.
+    """
+    from inspect import signature
+
+    if not isinstance(validator, (partial, partialmethod)):
+        # This should be the default case, so overhead is reduced
+        sig = signature(validator)
+        args = list(sig.parameters.keys())
+    else:
+        # Fix the generated argument lists of partial methods
+        sig = signature(validator.func)
+        args = [
+            k
+            for k in signature(validator.func).parameters.keys()
+            if k not in validator.args | validator.keywords.keys()
+        ]
+
+    first_arg = args.pop(0)
+    if first_arg == 'self':
+        raise ConfigError(
+            f'Invalid signature for validator {validator}: {sig}, "self" not permitted as first argument, '
+            f'should be: (cls, value, values, config, field), "values", "config" and "field" are all optional.'
+        )
+    elif first_arg == 'cls':
+        # assume the second argument is value
+        return wraps(validator)(_generic_validator_cls(validator, sig, set(args[1:])))
+    else:
+        # assume the first argument was value which has already been removed
+        return wraps(validator)(_generic_validator_basic(validator, sig, set(args)))
+
+
+def prep_validators(v_funcs: Iterable[AnyCallable]) -> 'ValidatorsList':
+    return [make_generic_validator(f) for f in v_funcs if f]
+
+
+all_kwargs = {'values', 'field', 'config'}
+
+
+def _generic_validator_cls(validator: AnyCallable, sig: 'Signature', args: Set[str]) -> 'ValidatorCallable':
+    # assume the first argument is value
+    has_kwargs = False
+    if 'kwargs' in args:
+        has_kwargs = True
+        args -= {'kwargs'}
+
+    if not args.issubset(all_kwargs):
+        raise ConfigError(
+            f'Invalid signature for validator {validator}: {sig}, should be: '
+            f'(cls, value, values, config, field), "values", "config" and "field" are all optional.'
+        )
+
+    if has_kwargs:
+        return lambda cls, v, values, field, config: validator(cls, v, values=values, field=field, config=config)
+    elif args == set():
+        return lambda cls, v, values, field, config: validator(cls, v)
+    elif args == {'values'}:
+        return lambda cls, v, values, field, config: validator(cls, v, values=values)
+    elif args == {'field'}:
+        return lambda cls, v, values, field, config: validator(cls, v, field=field)
+    elif args == {'config'}:
+        return lambda cls, v, values, field, config: validator(cls, v, config=config)
+    elif args == {'values', 'field'}:
+        return lambda cls, v, values, field, config: validator(cls, v, values=values, field=field)
+    elif args == {'values', 'config'}:
+        return lambda cls, v, values, field, config: validator(cls, v, values=values, config=config)
+    elif args == {'field', 'config'}:
+        return lambda cls, v, values, field, config: validator(cls, v, field=field, config=config)
+    else:
+        # args == {'values', 'field', 'config'}
+        return lambda cls, v, values, field, config: validator(cls, v, values=values, field=field, config=config)
+
+
+def _generic_validator_basic(validator: AnyCallable, sig: 'Signature', args: Set[str]) -> 'ValidatorCallable':
+    has_kwargs = False
+    if 'kwargs' in args:
+        has_kwargs = True
+        args -= {'kwargs'}
+
+    if not args.issubset(all_kwargs):
+        raise ConfigError(
+            f'Invalid signature for validator {validator}: {sig}, should be: '
+            f'(value, values, config, field), "values", "config" and "field" are all optional.'
+        )
+
+    if has_kwargs:
+        return lambda cls, v, values, field, config: validator(v, values=values, field=field, config=config)
+    elif args == set():
+        return lambda cls, v, values, field, config: validator(v)
+    elif args == {'values'}:
+        return lambda cls, v, values, field, config: validator(v, values=values)
+    elif args == {'field'}:
+        return lambda cls, v, values, field, config: validator(v, field=field)
+    elif args == {'config'}:
+        return lambda cls, v, values, field, config: validator(v, config=config)
+    elif args == {'values', 'field'}:
+        return lambda cls, v, values, field, config: validator(v, values=values, field=field)
+    elif args == {'values', 'config'}:
+        return lambda cls, v, values, field, config: validator(v, values=values, config=config)
+    elif args == {'field', 'config'}:
+        return lambda cls, v, values, field, config: validator(v, field=field, config=config)
+    else:
+        # args == {'values', 'field', 'config'}
+        return lambda cls, v, values, field, config: validator(v, values=values, field=field, config=config)
+
+
+def gather_all_validators(type_: 'ModelOrDc') -> Dict[str, 'AnyClassMethod']:
+    all_attributes = ChainMap(*[cls.__dict__ for cls in type_.__mro__])  # type: ignore[arg-type,var-annotated]
+    return {
+        k: v
+        for k, v in all_attributes.items()
+        if hasattr(v, VALIDATOR_CONFIG_KEY) or hasattr(v, ROOT_VALIDATOR_CONFIG_KEY)
+    }
diff --git a/lib/pydantic/v1/color.py b/lib/pydantic/v1/color.py
new file mode 100644
index 00000000..6fdc9fb1
--- /dev/null
+++ b/lib/pydantic/v1/color.py
@@ -0,0 +1,494 @@
+"""
+Color definitions are  used as per CSS3 specification:
+http://www.w3.org/TR/css3-color/#svg-color
+
+A few colors have multiple names referring to the sames colors, eg. `grey` and `gray` or `aqua` and `cyan`.
+
+In these cases the LAST color when sorted alphabetically takes preferences,
+eg. Color((0, 255, 255)).as_named() == 'cyan' because "cyan" comes after "aqua".
+"""
+import math
+import re
+from colorsys import hls_to_rgb, rgb_to_hls
+from typing import TYPE_CHECKING, Any, Dict, Optional, Tuple, Union, cast
+
+from .errors import ColorError
+from .utils import Representation, almost_equal_floats
+
+if TYPE_CHECKING:
+    from .typing import CallableGenerator, ReprArgs
+
+ColorTuple = Union[Tuple[int, int, int], Tuple[int, int, int, float]]
+ColorType = Union[ColorTuple, str]
+HslColorTuple = Union[Tuple[float, float, float], Tuple[float, float, float, float]]
+
+
+class RGBA:
+    """
+    Internal use only as a representation of a color.
+    """
+
+    __slots__ = 'r', 'g', 'b', 'alpha', '_tuple'
+
+    def __init__(self, r: float, g: float, b: float, alpha: Optional[float]):
+        self.r = r
+        self.g = g
+        self.b = b
+        self.alpha = alpha
+
+        self._tuple: Tuple[float, float, float, Optional[float]] = (r, g, b, alpha)
+
+    def __getitem__(self, item: Any) -> Any:
+        return self._tuple[item]
+
+
+# these are not compiled here to avoid import slowdown, they'll be compiled the first time they're used, then cached
+r_hex_short = r'\s*(?:#|0x)?([0-9a-f])([0-9a-f])([0-9a-f])([0-9a-f])?\s*'
+r_hex_long = r'\s*(?:#|0x)?([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})?\s*'
+_r_255 = r'(\d{1,3}(?:\.\d+)?)'
+_r_comma = r'\s*,\s*'
+r_rgb = fr'\s*rgb\(\s*{_r_255}{_r_comma}{_r_255}{_r_comma}{_r_255}\)\s*'
+_r_alpha = r'(\d(?:\.\d+)?|\.\d+|\d{1,2}%)'
+r_rgba = fr'\s*rgba\(\s*{_r_255}{_r_comma}{_r_255}{_r_comma}{_r_255}{_r_comma}{_r_alpha}\s*\)\s*'
+_r_h = r'(-?\d+(?:\.\d+)?|-?\.\d+)(deg|rad|turn)?'
+_r_sl = r'(\d{1,3}(?:\.\d+)?)%'
+r_hsl = fr'\s*hsl\(\s*{_r_h}{_r_comma}{_r_sl}{_r_comma}{_r_sl}\s*\)\s*'
+r_hsla = fr'\s*hsl\(\s*{_r_h}{_r_comma}{_r_sl}{_r_comma}{_r_sl}{_r_comma}{_r_alpha}\s*\)\s*'
+
+# colors where the two hex characters are the same, if all colors match this the short version of hex colors can be used
+repeat_colors = {int(c * 2, 16) for c in '0123456789abcdef'}
+rads = 2 * math.pi
+
+
+class Color(Representation):
+    __slots__ = '_original', '_rgba'
+
+    def __init__(self, value: ColorType) -> None:
+        self._rgba: RGBA
+        self._original: ColorType
+        if isinstance(value, (tuple, list)):
+            self._rgba = parse_tuple(value)
+        elif isinstance(value, str):
+            self._rgba = parse_str(value)
+        elif isinstance(value, Color):
+            self._rgba = value._rgba
+            value = value._original
+        else:
+            raise ColorError(reason='value must be a tuple, list or string')
+
+        # if we've got here value must be a valid color
+        self._original = value
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        field_schema.update(type='string', format='color')
+
+    def original(self) -> ColorType:
+        """
+        Original value passed to Color
+        """
+        return self._original
+
+    def as_named(self, *, fallback: bool = False) -> str:
+        if self._rgba.alpha is None:
+            rgb = cast(Tuple[int, int, int], self.as_rgb_tuple())
+            try:
+                return COLORS_BY_VALUE[rgb]
+            except KeyError as e:
+                if fallback:
+                    return self.as_hex()
+                else:
+                    raise ValueError('no named color found, use fallback=True, as_hex() or as_rgb()') from e
+        else:
+            return self.as_hex()
+
+    def as_hex(self) -> str:
+        """
+        Hex string representing the color can be 3, 4, 6 or 8 characters depending on whether the string
+        a "short" representation of the color is possible and whether there's an alpha channel.
+        """
+        values = [float_to_255(c) for c in self._rgba[:3]]
+        if self._rgba.alpha is not None:
+            values.append(float_to_255(self._rgba.alpha))
+
+        as_hex = ''.join(f'{v:02x}' for v in values)
+        if all(c in repeat_colors for c in values):
+            as_hex = ''.join(as_hex[c] for c in range(0, len(as_hex), 2))
+        return '#' + as_hex
+
+    def as_rgb(self) -> str:
+        """
+        Color as an rgb(<r>, <g>, <b>) or rgba(<r>, <g>, <b>, <a>) string.
+        """
+        if self._rgba.alpha is None:
+            return f'rgb({float_to_255(self._rgba.r)}, {float_to_255(self._rgba.g)}, {float_to_255(self._rgba.b)})'
+        else:
+            return (
+                f'rgba({float_to_255(self._rgba.r)}, {float_to_255(self._rgba.g)}, {float_to_255(self._rgba.b)}, '
+                f'{round(self._alpha_float(), 2)})'
+            )
+
+    def as_rgb_tuple(self, *, alpha: Optional[bool] = None) -> ColorTuple:
+        """
+        Color as an RGB or RGBA tuple; red, green and blue are in the range 0 to 255, alpha if included is
+        in the range 0 to 1.
+
+        :param alpha: whether to include the alpha channel, options are
+          None - (default) include alpha only if it's set (e.g. not None)
+          True - always include alpha,
+          False - always omit alpha,
+        """
+        r, g, b = (float_to_255(c) for c in self._rgba[:3])
+        if alpha is None:
+            if self._rgba.alpha is None:
+                return r, g, b
+            else:
+                return r, g, b, self._alpha_float()
+        elif alpha:
+            return r, g, b, self._alpha_float()
+        else:
+            # alpha is False
+            return r, g, b
+
+    def as_hsl(self) -> str:
+        """
+        Color as an hsl(<h>, <s>, <l>) or hsl(<h>, <s>, <l>, <a>) string.
+        """
+        if self._rgba.alpha is None:
+            h, s, li = self.as_hsl_tuple(alpha=False)  # type: ignore
+            return f'hsl({h * 360:0.0f}, {s:0.0%}, {li:0.0%})'
+        else:
+            h, s, li, a = self.as_hsl_tuple(alpha=True)  # type: ignore
+            return f'hsl({h * 360:0.0f}, {s:0.0%}, {li:0.0%}, {round(a, 2)})'
+
+    def as_hsl_tuple(self, *, alpha: Optional[bool] = None) -> HslColorTuple:
+        """
+        Color as an HSL or HSLA tuple, e.g. hue, saturation, lightness and optionally alpha; all elements are in
+        the range 0 to 1.
+
+        NOTE: this is HSL as used in HTML and most other places, not HLS as used in python's colorsys.
+
+        :param alpha: whether to include the alpha channel, options are
+          None - (default) include alpha only if it's set (e.g. not None)
+          True - always include alpha,
+          False - always omit alpha,
+        """
+        h, l, s = rgb_to_hls(self._rgba.r, self._rgba.g, self._rgba.b)
+        if alpha is None:
+            if self._rgba.alpha is None:
+                return h, s, l
+            else:
+                return h, s, l, self._alpha_float()
+        if alpha:
+            return h, s, l, self._alpha_float()
+        else:
+            # alpha is False
+            return h, s, l
+
+    def _alpha_float(self) -> float:
+        return 1 if self._rgba.alpha is None else self._rgba.alpha
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield cls
+
+    def __str__(self) -> str:
+        return self.as_named(fallback=True)
+
+    def __repr_args__(self) -> 'ReprArgs':
+        return [(None, self.as_named(fallback=True))] + [('rgb', self.as_rgb_tuple())]  # type: ignore
+
+    def __eq__(self, other: Any) -> bool:
+        return isinstance(other, Color) and self.as_rgb_tuple() == other.as_rgb_tuple()
+
+    def __hash__(self) -> int:
+        return hash(self.as_rgb_tuple())
+
+
+def parse_tuple(value: Tuple[Any, ...]) -> RGBA:
+    """
+    Parse a tuple or list as a color.
+    """
+    if len(value) == 3:
+        r, g, b = (parse_color_value(v) for v in value)
+        return RGBA(r, g, b, None)
+    elif len(value) == 4:
+        r, g, b = (parse_color_value(v) for v in value[:3])
+        return RGBA(r, g, b, parse_float_alpha(value[3]))
+    else:
+        raise ColorError(reason='tuples must have length 3 or 4')
+
+
+def parse_str(value: str) -> RGBA:
+    """
+    Parse a string to an RGBA tuple, trying the following formats (in this order):
+    * named color, see COLORS_BY_NAME below
+    * hex short eg. `<prefix>fff` (prefix can be `#`, `0x` or nothing)
+    * hex long eg. `<prefix>ffffff` (prefix can be `#`, `0x` or nothing)
+    * `rgb(<r>, <g>, <b>) `
+    * `rgba(<r>, <g>, <b>, <a>)`
+    """
+    value_lower = value.lower()
+    try:
+        r, g, b = COLORS_BY_NAME[value_lower]
+    except KeyError:
+        pass
+    else:
+        return ints_to_rgba(r, g, b, None)
+
+    m = re.fullmatch(r_hex_short, value_lower)
+    if m:
+        *rgb, a = m.groups()
+        r, g, b = (int(v * 2, 16) for v in rgb)
+        if a:
+            alpha: Optional[float] = int(a * 2, 16) / 255
+        else:
+            alpha = None
+        return ints_to_rgba(r, g, b, alpha)
+
+    m = re.fullmatch(r_hex_long, value_lower)
+    if m:
+        *rgb, a = m.groups()
+        r, g, b = (int(v, 16) for v in rgb)
+        if a:
+            alpha = int(a, 16) / 255
+        else:
+            alpha = None
+        return ints_to_rgba(r, g, b, alpha)
+
+    m = re.fullmatch(r_rgb, value_lower)
+    if m:
+        return ints_to_rgba(*m.groups(), None)  # type: ignore
+
+    m = re.fullmatch(r_rgba, value_lower)
+    if m:
+        return ints_to_rgba(*m.groups())  # type: ignore
+
+    m = re.fullmatch(r_hsl, value_lower)
+    if m:
+        h, h_units, s, l_ = m.groups()
+        return parse_hsl(h, h_units, s, l_)
+
+    m = re.fullmatch(r_hsla, value_lower)
+    if m:
+        h, h_units, s, l_, a = m.groups()
+        return parse_hsl(h, h_units, s, l_, parse_float_alpha(a))
+
+    raise ColorError(reason='string not recognised as a valid color')
+
+
+def ints_to_rgba(r: Union[int, str], g: Union[int, str], b: Union[int, str], alpha: Optional[float]) -> RGBA:
+    return RGBA(parse_color_value(r), parse_color_value(g), parse_color_value(b), parse_float_alpha(alpha))
+
+
+def parse_color_value(value: Union[int, str], max_val: int = 255) -> float:
+    """
+    Parse a value checking it's a valid int in the range 0 to max_val and divide by max_val to give a number
+    in the range 0 to 1
+    """
+    try:
+        color = float(value)
+    except ValueError:
+        raise ColorError(reason='color values must be a valid number')
+    if 0 <= color <= max_val:
+        return color / max_val
+    else:
+        raise ColorError(reason=f'color values must be in the range 0 to {max_val}')
+
+
+def parse_float_alpha(value: Union[None, str, float, int]) -> Optional[float]:
+    """
+    Parse a value checking it's a valid float in the range 0 to 1
+    """
+    if value is None:
+        return None
+    try:
+        if isinstance(value, str) and value.endswith('%'):
+            alpha = float(value[:-1]) / 100
+        else:
+            alpha = float(value)
+    except ValueError:
+        raise ColorError(reason='alpha values must be a valid float')
+
+    if almost_equal_floats(alpha, 1):
+        return None
+    elif 0 <= alpha <= 1:
+        return alpha
+    else:
+        raise ColorError(reason='alpha values must be in the range 0 to 1')
+
+
+def parse_hsl(h: str, h_units: str, sat: str, light: str, alpha: Optional[float] = None) -> RGBA:
+    """
+    Parse raw hue, saturation, lightness and alpha values and convert to RGBA.
+    """
+    s_value, l_value = parse_color_value(sat, 100), parse_color_value(light, 100)
+
+    h_value = float(h)
+    if h_units in {None, 'deg'}:
+        h_value = h_value % 360 / 360
+    elif h_units == 'rad':
+        h_value = h_value % rads / rads
+    else:
+        # turns
+        h_value = h_value % 1
+
+    r, g, b = hls_to_rgb(h_value, l_value, s_value)
+    return RGBA(r, g, b, alpha)
+
+
+def float_to_255(c: float) -> int:
+    return int(round(c * 255))
+
+
+COLORS_BY_NAME = {
+    'aliceblue': (240, 248, 255),
+    'antiquewhite': (250, 235, 215),
+    'aqua': (0, 255, 255),
+    'aquamarine': (127, 255, 212),
+    'azure': (240, 255, 255),
+    'beige': (245, 245, 220),
+    'bisque': (255, 228, 196),
+    'black': (0, 0, 0),
+    'blanchedalmond': (255, 235, 205),
+    'blue': (0, 0, 255),
+    'blueviolet': (138, 43, 226),
+    'brown': (165, 42, 42),
+    'burlywood': (222, 184, 135),
+    'cadetblue': (95, 158, 160),
+    'chartreuse': (127, 255, 0),
+    'chocolate': (210, 105, 30),
+    'coral': (255, 127, 80),
+    'cornflowerblue': (100, 149, 237),
+    'cornsilk': (255, 248, 220),
+    'crimson': (220, 20, 60),
+    'cyan': (0, 255, 255),
+    'darkblue': (0, 0, 139),
+    'darkcyan': (0, 139, 139),
+    'darkgoldenrod': (184, 134, 11),
+    'darkgray': (169, 169, 169),
+    'darkgreen': (0, 100, 0),
+    'darkgrey': (169, 169, 169),
+    'darkkhaki': (189, 183, 107),
+    'darkmagenta': (139, 0, 139),
+    'darkolivegreen': (85, 107, 47),
+    'darkorange': (255, 140, 0),
+    'darkorchid': (153, 50, 204),
+    'darkred': (139, 0, 0),
+    'darksalmon': (233, 150, 122),
+    'darkseagreen': (143, 188, 143),
+    'darkslateblue': (72, 61, 139),
+    'darkslategray': (47, 79, 79),
+    'darkslategrey': (47, 79, 79),
+    'darkturquoise': (0, 206, 209),
+    'darkviolet': (148, 0, 211),
+    'deeppink': (255, 20, 147),
+    'deepskyblue': (0, 191, 255),
+    'dimgray': (105, 105, 105),
+    'dimgrey': (105, 105, 105),
+    'dodgerblue': (30, 144, 255),
+    'firebrick': (178, 34, 34),
+    'floralwhite': (255, 250, 240),
+    'forestgreen': (34, 139, 34),
+    'fuchsia': (255, 0, 255),
+    'gainsboro': (220, 220, 220),
+    'ghostwhite': (248, 248, 255),
+    'gold': (255, 215, 0),
+    'goldenrod': (218, 165, 32),
+    'gray': (128, 128, 128),
+    'green': (0, 128, 0),
+    'greenyellow': (173, 255, 47),
+    'grey': (128, 128, 128),
+    'honeydew': (240, 255, 240),
+    'hotpink': (255, 105, 180),
+    'indianred': (205, 92, 92),
+    'indigo': (75, 0, 130),
+    'ivory': (255, 255, 240),
+    'khaki': (240, 230, 140),
+    'lavender': (230, 230, 250),
+    'lavenderblush': (255, 240, 245),
+    'lawngreen': (124, 252, 0),
+    'lemonchiffon': (255, 250, 205),
+    'lightblue': (173, 216, 230),
+    'lightcoral': (240, 128, 128),
+    'lightcyan': (224, 255, 255),
+    'lightgoldenrodyellow': (250, 250, 210),
+    'lightgray': (211, 211, 211),
+    'lightgreen': (144, 238, 144),
+    'lightgrey': (211, 211, 211),
+    'lightpink': (255, 182, 193),
+    'lightsalmon': (255, 160, 122),
+    'lightseagreen': (32, 178, 170),
+    'lightskyblue': (135, 206, 250),
+    'lightslategray': (119, 136, 153),
+    'lightslategrey': (119, 136, 153),
+    'lightsteelblue': (176, 196, 222),
+    'lightyellow': (255, 255, 224),
+    'lime': (0, 255, 0),
+    'limegreen': (50, 205, 50),
+    'linen': (250, 240, 230),
+    'magenta': (255, 0, 255),
+    'maroon': (128, 0, 0),
+    'mediumaquamarine': (102, 205, 170),
+    'mediumblue': (0, 0, 205),
+    'mediumorchid': (186, 85, 211),
+    'mediumpurple': (147, 112, 219),
+    'mediumseagreen': (60, 179, 113),
+    'mediumslateblue': (123, 104, 238),
+    'mediumspringgreen': (0, 250, 154),
+    'mediumturquoise': (72, 209, 204),
+    'mediumvioletred': (199, 21, 133),
+    'midnightblue': (25, 25, 112),
+    'mintcream': (245, 255, 250),
+    'mistyrose': (255, 228, 225),
+    'moccasin': (255, 228, 181),
+    'navajowhite': (255, 222, 173),
+    'navy': (0, 0, 128),
+    'oldlace': (253, 245, 230),
+    'olive': (128, 128, 0),
+    'olivedrab': (107, 142, 35),
+    'orange': (255, 165, 0),
+    'orangered': (255, 69, 0),
+    'orchid': (218, 112, 214),
+    'palegoldenrod': (238, 232, 170),
+    'palegreen': (152, 251, 152),
+    'paleturquoise': (175, 238, 238),
+    'palevioletred': (219, 112, 147),
+    'papayawhip': (255, 239, 213),
+    'peachpuff': (255, 218, 185),
+    'peru': (205, 133, 63),
+    'pink': (255, 192, 203),
+    'plum': (221, 160, 221),
+    'powderblue': (176, 224, 230),
+    'purple': (128, 0, 128),
+    'red': (255, 0, 0),
+    'rosybrown': (188, 143, 143),
+    'royalblue': (65, 105, 225),
+    'saddlebrown': (139, 69, 19),
+    'salmon': (250, 128, 114),
+    'sandybrown': (244, 164, 96),
+    'seagreen': (46, 139, 87),
+    'seashell': (255, 245, 238),
+    'sienna': (160, 82, 45),
+    'silver': (192, 192, 192),
+    'skyblue': (135, 206, 235),
+    'slateblue': (106, 90, 205),
+    'slategray': (112, 128, 144),
+    'slategrey': (112, 128, 144),
+    'snow': (255, 250, 250),
+    'springgreen': (0, 255, 127),
+    'steelblue': (70, 130, 180),
+    'tan': (210, 180, 140),
+    'teal': (0, 128, 128),
+    'thistle': (216, 191, 216),
+    'tomato': (255, 99, 71),
+    'turquoise': (64, 224, 208),
+    'violet': (238, 130, 238),
+    'wheat': (245, 222, 179),
+    'white': (255, 255, 255),
+    'whitesmoke': (245, 245, 245),
+    'yellow': (255, 255, 0),
+    'yellowgreen': (154, 205, 50),
+}
+
+COLORS_BY_VALUE = {v: k for k, v in COLORS_BY_NAME.items()}
diff --git a/lib/pydantic/v1/config.py b/lib/pydantic/v1/config.py
new file mode 100644
index 00000000..a25973af
--- /dev/null
+++ b/lib/pydantic/v1/config.py
@@ -0,0 +1,191 @@
+import json
+from enum import Enum
+from typing import TYPE_CHECKING, Any, Callable, Dict, ForwardRef, Optional, Tuple, Type, Union
+
+from typing_extensions import Literal, Protocol
+
+from .typing import AnyArgTCallable, AnyCallable
+from .utils import GetterDict
+from .version import compiled
+
+if TYPE_CHECKING:
+    from typing import overload
+
+    from .fields import ModelField
+    from .main import BaseModel
+
+    ConfigType = Type['BaseConfig']
+
+    class SchemaExtraCallable(Protocol):
+        @overload
+        def __call__(self, schema: Dict[str, Any]) -> None:
+            pass
+
+        @overload
+        def __call__(self, schema: Dict[str, Any], model_class: Type[BaseModel]) -> None:
+            pass
+
+else:
+    SchemaExtraCallable = Callable[..., None]
+
+__all__ = 'BaseConfig', 'ConfigDict', 'get_config', 'Extra', 'inherit_config', 'prepare_config'
+
+
+class Extra(str, Enum):
+    allow = 'allow'
+    ignore = 'ignore'
+    forbid = 'forbid'
+
+
+# https://github.com/cython/cython/issues/4003
+# Fixed in Cython 3 and Pydantic v1 won't support Cython 3.
+# Pydantic v2 doesn't depend on Cython at all.
+if not compiled:
+    from typing_extensions import TypedDict
+
+    class ConfigDict(TypedDict, total=False):
+        title: Optional[str]
+        anystr_lower: bool
+        anystr_strip_whitespace: bool
+        min_anystr_length: int
+        max_anystr_length: Optional[int]
+        validate_all: bool
+        extra: Extra
+        allow_mutation: bool
+        frozen: bool
+        allow_population_by_field_name: bool
+        use_enum_values: bool
+        fields: Dict[str, Union[str, Dict[str, str]]]
+        validate_assignment: bool
+        error_msg_templates: Dict[str, str]
+        arbitrary_types_allowed: bool
+        orm_mode: bool
+        getter_dict: Type[GetterDict]
+        alias_generator: Optional[Callable[[str], str]]
+        keep_untouched: Tuple[type, ...]
+        schema_extra: Union[Dict[str, object], 'SchemaExtraCallable']
+        json_loads: Callable[[str], object]
+        json_dumps: AnyArgTCallable[str]
+        json_encoders: Dict[Type[object], AnyCallable]
+        underscore_attrs_are_private: bool
+        allow_inf_nan: bool
+        copy_on_model_validation: Literal['none', 'deep', 'shallow']
+        # whether dataclass `__post_init__` should be run after validation
+        post_init_call: Literal['before_validation', 'after_validation']
+
+else:
+    ConfigDict = dict  # type: ignore
+
+
+class BaseConfig:
+    title: Optional[str] = None
+    anystr_lower: bool = False
+    anystr_upper: bool = False
+    anystr_strip_whitespace: bool = False
+    min_anystr_length: int = 0
+    max_anystr_length: Optional[int] = None
+    validate_all: bool = False
+    extra: Extra = Extra.ignore
+    allow_mutation: bool = True
+    frozen: bool = False
+    allow_population_by_field_name: bool = False
+    use_enum_values: bool = False
+    fields: Dict[str, Union[str, Dict[str, str]]] = {}
+    validate_assignment: bool = False
+    error_msg_templates: Dict[str, str] = {}
+    arbitrary_types_allowed: bool = False
+    orm_mode: bool = False
+    getter_dict: Type[GetterDict] = GetterDict
+    alias_generator: Optional[Callable[[str], str]] = None
+    keep_untouched: Tuple[type, ...] = ()
+    schema_extra: Union[Dict[str, Any], 'SchemaExtraCallable'] = {}
+    json_loads: Callable[[str], Any] = json.loads
+    json_dumps: Callable[..., str] = json.dumps
+    json_encoders: Dict[Union[Type[Any], str, ForwardRef], AnyCallable] = {}
+    underscore_attrs_are_private: bool = False
+    allow_inf_nan: bool = True
+
+    # whether inherited models as fields should be reconstructed as base model,
+    # and whether such a copy should be shallow or deep
+    copy_on_model_validation: Literal['none', 'deep', 'shallow'] = 'shallow'
+
+    # whether `Union` should check all allowed types before even trying to coerce
+    smart_union: bool = False
+    # whether dataclass `__post_init__` should be run before or after validation
+    post_init_call: Literal['before_validation', 'after_validation'] = 'before_validation'
+
+    @classmethod
+    def get_field_info(cls, name: str) -> Dict[str, Any]:
+        """
+        Get properties of FieldInfo from the `fields` property of the config class.
+        """
+
+        fields_value = cls.fields.get(name)
+
+        if isinstance(fields_value, str):
+            field_info: Dict[str, Any] = {'alias': fields_value}
+        elif isinstance(fields_value, dict):
+            field_info = fields_value
+        else:
+            field_info = {}
+
+        if 'alias' in field_info:
+            field_info.setdefault('alias_priority', 2)
+
+        if field_info.get('alias_priority', 0) <= 1 and cls.alias_generator:
+            alias = cls.alias_generator(name)
+            if not isinstance(alias, str):
+                raise TypeError(f'Config.alias_generator must return str, not {alias.__class__}')
+            field_info.update(alias=alias, alias_priority=1)
+        return field_info
+
+    @classmethod
+    def prepare_field(cls, field: 'ModelField') -> None:
+        """
+        Optional hook to check or modify fields during model creation.
+        """
+        pass
+
+
+def get_config(config: Union[ConfigDict, Type[object], None]) -> Type[BaseConfig]:
+    if config is None:
+        return BaseConfig
+
+    else:
+        config_dict = (
+            config
+            if isinstance(config, dict)
+            else {k: getattr(config, k) for k in dir(config) if not k.startswith('__')}
+        )
+
+        class Config(BaseConfig):
+            ...
+
+        for k, v in config_dict.items():
+            setattr(Config, k, v)
+        return Config
+
+
+def inherit_config(self_config: 'ConfigType', parent_config: 'ConfigType', **namespace: Any) -> 'ConfigType':
+    if not self_config:
+        base_classes: Tuple['ConfigType', ...] = (parent_config,)
+    elif self_config == parent_config:
+        base_classes = (self_config,)
+    else:
+        base_classes = self_config, parent_config
+
+    namespace['json_encoders'] = {
+        **getattr(parent_config, 'json_encoders', {}),
+        **getattr(self_config, 'json_encoders', {}),
+        **namespace.get('json_encoders', {}),
+    }
+
+    return type('Config', base_classes, namespace)
+
+
+def prepare_config(config: Type[BaseConfig], cls_name: str) -> None:
+    if not isinstance(config.extra, Extra):
+        try:
+            config.extra = Extra(config.extra)
+        except ValueError:
+            raise ValueError(f'"{cls_name}": {config.extra} is not a valid value for "extra"')
diff --git a/lib/pydantic/v1/dataclasses.py b/lib/pydantic/v1/dataclasses.py
new file mode 100644
index 00000000..2df3987a
--- /dev/null
+++ b/lib/pydantic/v1/dataclasses.py
@@ -0,0 +1,500 @@
+"""
+The main purpose is to enhance stdlib dataclasses by adding validation
+A pydantic dataclass can be generated from scratch or from a stdlib one.
+
+Behind the scene, a pydantic dataclass is just like a regular one on which we attach
+a `BaseModel` and magic methods to trigger the validation of the data.
+`__init__` and `__post_init__` are hence overridden and have extra logic to be
+able to validate input data.
+
+When a pydantic dataclass is generated from scratch, it's just a plain dataclass
+with validation triggered at initialization
+
+The tricky part if for stdlib dataclasses that are converted after into pydantic ones e.g.
+
+```py
+@dataclasses.dataclass
+class M:
+    x: int
+
+ValidatedM = pydantic.dataclasses.dataclass(M)
+```
+
+We indeed still want to support equality, hashing, repr, ... as if it was the stdlib one!
+
+```py
+assert isinstance(ValidatedM(x=1), M)
+assert ValidatedM(x=1) == M(x=1)
+```
+
+This means we **don't want to create a new dataclass that inherits from it**
+The trick is to create a wrapper around `M` that will act as a proxy to trigger
+validation without altering default `M` behaviour.
+"""
+import copy
+import dataclasses
+import sys
+from contextlib import contextmanager
+from functools import wraps
+
+try:
+    from functools import cached_property
+except ImportError:
+    # cached_property available only for python3.8+
+    pass
+
+from typing import TYPE_CHECKING, Any, Callable, ClassVar, Dict, Generator, Optional, Type, TypeVar, Union, overload
+
+from typing_extensions import dataclass_transform
+
+from .class_validators import gather_all_validators
+from .config import BaseConfig, ConfigDict, Extra, get_config
+from .error_wrappers import ValidationError
+from .errors import DataclassTypeError
+from .fields import Field, FieldInfo, Required, Undefined
+from .main import create_model, validate_model
+from .utils import ClassAttribute
+
+if TYPE_CHECKING:
+    from .main import BaseModel
+    from .typing import CallableGenerator, NoArgAnyCallable
+
+    DataclassT = TypeVar('DataclassT', bound='Dataclass')
+
+    DataclassClassOrWrapper = Union[Type['Dataclass'], 'DataclassProxy']
+
+    class Dataclass:
+        # stdlib attributes
+        __dataclass_fields__: ClassVar[Dict[str, Any]]
+        __dataclass_params__: ClassVar[Any]  # in reality `dataclasses._DataclassParams`
+        __post_init__: ClassVar[Callable[..., None]]
+
+        # Added by pydantic
+        __pydantic_run_validation__: ClassVar[bool]
+        __post_init_post_parse__: ClassVar[Callable[..., None]]
+        __pydantic_initialised__: ClassVar[bool]
+        __pydantic_model__: ClassVar[Type[BaseModel]]
+        __pydantic_validate_values__: ClassVar[Callable[['Dataclass'], None]]
+        __pydantic_has_field_info_default__: ClassVar[bool]  # whether a `pydantic.Field` is used as default value
+
+        def __init__(self, *args: object, **kwargs: object) -> None:
+            pass
+
+        @classmethod
+        def __get_validators__(cls: Type['Dataclass']) -> 'CallableGenerator':
+            pass
+
+        @classmethod
+        def __validate__(cls: Type['DataclassT'], v: Any) -> 'DataclassT':
+            pass
+
+
+__all__ = [
+    'dataclass',
+    'set_validation',
+    'create_pydantic_model_from_dataclass',
+    'is_builtin_dataclass',
+    'make_dataclass_validator',
+]
+
+_T = TypeVar('_T')
+
+if sys.version_info >= (3, 10):
+
+    @dataclass_transform(field_specifiers=(dataclasses.field, Field))
+    @overload
+    def dataclass(
+        *,
+        init: bool = True,
+        repr: bool = True,
+        eq: bool = True,
+        order: bool = False,
+        unsafe_hash: bool = False,
+        frozen: bool = False,
+        config: Union[ConfigDict, Type[object], None] = None,
+        validate_on_init: Optional[bool] = None,
+        use_proxy: Optional[bool] = None,
+        kw_only: bool = ...,
+    ) -> Callable[[Type[_T]], 'DataclassClassOrWrapper']:
+        ...
+
+    @dataclass_transform(field_specifiers=(dataclasses.field, Field))
+    @overload
+    def dataclass(
+        _cls: Type[_T],
+        *,
+        init: bool = True,
+        repr: bool = True,
+        eq: bool = True,
+        order: bool = False,
+        unsafe_hash: bool = False,
+        frozen: bool = False,
+        config: Union[ConfigDict, Type[object], None] = None,
+        validate_on_init: Optional[bool] = None,
+        use_proxy: Optional[bool] = None,
+        kw_only: bool = ...,
+    ) -> 'DataclassClassOrWrapper':
+        ...
+
+else:
+
+    @dataclass_transform(field_specifiers=(dataclasses.field, Field))
+    @overload
+    def dataclass(
+        *,
+        init: bool = True,
+        repr: bool = True,
+        eq: bool = True,
+        order: bool = False,
+        unsafe_hash: bool = False,
+        frozen: bool = False,
+        config: Union[ConfigDict, Type[object], None] = None,
+        validate_on_init: Optional[bool] = None,
+        use_proxy: Optional[bool] = None,
+    ) -> Callable[[Type[_T]], 'DataclassClassOrWrapper']:
+        ...
+
+    @dataclass_transform(field_specifiers=(dataclasses.field, Field))
+    @overload
+    def dataclass(
+        _cls: Type[_T],
+        *,
+        init: bool = True,
+        repr: bool = True,
+        eq: bool = True,
+        order: bool = False,
+        unsafe_hash: bool = False,
+        frozen: bool = False,
+        config: Union[ConfigDict, Type[object], None] = None,
+        validate_on_init: Optional[bool] = None,
+        use_proxy: Optional[bool] = None,
+    ) -> 'DataclassClassOrWrapper':
+        ...
+
+
+@dataclass_transform(field_specifiers=(dataclasses.field, Field))
+def dataclass(
+    _cls: Optional[Type[_T]] = None,
+    *,
+    init: bool = True,
+    repr: bool = True,
+    eq: bool = True,
+    order: bool = False,
+    unsafe_hash: bool = False,
+    frozen: bool = False,
+    config: Union[ConfigDict, Type[object], None] = None,
+    validate_on_init: Optional[bool] = None,
+    use_proxy: Optional[bool] = None,
+    kw_only: bool = False,
+) -> Union[Callable[[Type[_T]], 'DataclassClassOrWrapper'], 'DataclassClassOrWrapper']:
+    """
+    Like the python standard lib dataclasses but with type validation.
+    The result is either a pydantic dataclass that will validate input data
+    or a wrapper that will trigger validation around a stdlib dataclass
+    to avoid modifying it directly
+    """
+    the_config = get_config(config)
+
+    def wrap(cls: Type[Any]) -> 'DataclassClassOrWrapper':
+        should_use_proxy = (
+            use_proxy
+            if use_proxy is not None
+            else (
+                is_builtin_dataclass(cls)
+                and (cls.__bases__[0] is object or set(dir(cls)) == set(dir(cls.__bases__[0])))
+            )
+        )
+        if should_use_proxy:
+            dc_cls_doc = ''
+            dc_cls = DataclassProxy(cls)
+            default_validate_on_init = False
+        else:
+            dc_cls_doc = cls.__doc__ or ''  # needs to be done before generating dataclass
+            if sys.version_info >= (3, 10):
+                dc_cls = dataclasses.dataclass(
+                    cls,
+                    init=init,
+                    repr=repr,
+                    eq=eq,
+                    order=order,
+                    unsafe_hash=unsafe_hash,
+                    frozen=frozen,
+                    kw_only=kw_only,
+                )
+            else:
+                dc_cls = dataclasses.dataclass(  # type: ignore
+                    cls, init=init, repr=repr, eq=eq, order=order, unsafe_hash=unsafe_hash, frozen=frozen
+                )
+            default_validate_on_init = True
+
+        should_validate_on_init = default_validate_on_init if validate_on_init is None else validate_on_init
+        _add_pydantic_validation_attributes(cls, the_config, should_validate_on_init, dc_cls_doc)
+        dc_cls.__pydantic_model__.__try_update_forward_refs__(**{cls.__name__: cls})
+        return dc_cls
+
+    if _cls is None:
+        return wrap
+
+    return wrap(_cls)
+
+
+@contextmanager
+def set_validation(cls: Type['DataclassT'], value: bool) -> Generator[Type['DataclassT'], None, None]:
+    original_run_validation = cls.__pydantic_run_validation__
+    try:
+        cls.__pydantic_run_validation__ = value
+        yield cls
+    finally:
+        cls.__pydantic_run_validation__ = original_run_validation
+
+
+class DataclassProxy:
+    __slots__ = '__dataclass__'
+
+    def __init__(self, dc_cls: Type['Dataclass']) -> None:
+        object.__setattr__(self, '__dataclass__', dc_cls)
+
+    def __call__(self, *args: Any, **kwargs: Any) -> Any:
+        with set_validation(self.__dataclass__, True):
+            return self.__dataclass__(*args, **kwargs)
+
+    def __getattr__(self, name: str) -> Any:
+        return getattr(self.__dataclass__, name)
+
+    def __setattr__(self, __name: str, __value: Any) -> None:
+        return setattr(self.__dataclass__, __name, __value)
+
+    def __instancecheck__(self, instance: Any) -> bool:
+        return isinstance(instance, self.__dataclass__)
+
+    def __copy__(self) -> 'DataclassProxy':
+        return DataclassProxy(copy.copy(self.__dataclass__))
+
+    def __deepcopy__(self, memo: Any) -> 'DataclassProxy':
+        return DataclassProxy(copy.deepcopy(self.__dataclass__, memo))
+
+
+def _add_pydantic_validation_attributes(  # noqa: C901 (ignore complexity)
+    dc_cls: Type['Dataclass'],
+    config: Type[BaseConfig],
+    validate_on_init: bool,
+    dc_cls_doc: str,
+) -> None:
+    """
+    We need to replace the right method. If no `__post_init__` has been set in the stdlib dataclass
+    it won't even exist (code is generated on the fly by `dataclasses`)
+    By default, we run validation after `__init__` or `__post_init__` if defined
+    """
+    init = dc_cls.__init__
+
+    @wraps(init)
+    def handle_extra_init(self: 'Dataclass', *args: Any, **kwargs: Any) -> None:
+        if config.extra == Extra.ignore:
+            init(self, *args, **{k: v for k, v in kwargs.items() if k in self.__dataclass_fields__})
+
+        elif config.extra == Extra.allow:
+            for k, v in kwargs.items():
+                self.__dict__.setdefault(k, v)
+            init(self, *args, **{k: v for k, v in kwargs.items() if k in self.__dataclass_fields__})
+
+        else:
+            init(self, *args, **kwargs)
+
+    if hasattr(dc_cls, '__post_init__'):
+        try:
+            post_init = dc_cls.__post_init__.__wrapped__  # type: ignore[attr-defined]
+        except AttributeError:
+            post_init = dc_cls.__post_init__
+
+        @wraps(post_init)
+        def new_post_init(self: 'Dataclass', *args: Any, **kwargs: Any) -> None:
+            if config.post_init_call == 'before_validation':
+                post_init(self, *args, **kwargs)
+
+            if self.__class__.__pydantic_run_validation__:
+                self.__pydantic_validate_values__()
+                if hasattr(self, '__post_init_post_parse__'):
+                    self.__post_init_post_parse__(*args, **kwargs)
+
+            if config.post_init_call == 'after_validation':
+                post_init(self, *args, **kwargs)
+
+        setattr(dc_cls, '__init__', handle_extra_init)
+        setattr(dc_cls, '__post_init__', new_post_init)
+
+    else:
+
+        @wraps(init)
+        def new_init(self: 'Dataclass', *args: Any, **kwargs: Any) -> None:
+            handle_extra_init(self, *args, **kwargs)
+
+            if self.__class__.__pydantic_run_validation__:
+                self.__pydantic_validate_values__()
+
+            if hasattr(self, '__post_init_post_parse__'):
+                # We need to find again the initvars. To do that we use `__dataclass_fields__` instead of
+                # public method `dataclasses.fields`
+
+                # get all initvars and their default values
+                initvars_and_values: Dict[str, Any] = {}
+                for i, f in enumerate(self.__class__.__dataclass_fields__.values()):
+                    if f._field_type is dataclasses._FIELD_INITVAR:  # type: ignore[attr-defined]
+                        try:
+                            # set arg value by default
+                            initvars_and_values[f.name] = args[i]
+                        except IndexError:
+                            initvars_and_values[f.name] = kwargs.get(f.name, f.default)
+
+                self.__post_init_post_parse__(**initvars_and_values)
+
+        setattr(dc_cls, '__init__', new_init)
+
+    setattr(dc_cls, '__pydantic_run_validation__', ClassAttribute('__pydantic_run_validation__', validate_on_init))
+    setattr(dc_cls, '__pydantic_initialised__', False)
+    setattr(dc_cls, '__pydantic_model__', create_pydantic_model_from_dataclass(dc_cls, config, dc_cls_doc))
+    setattr(dc_cls, '__pydantic_validate_values__', _dataclass_validate_values)
+    setattr(dc_cls, '__validate__', classmethod(_validate_dataclass))
+    setattr(dc_cls, '__get_validators__', classmethod(_get_validators))
+
+    if dc_cls.__pydantic_model__.__config__.validate_assignment and not dc_cls.__dataclass_params__.frozen:
+        setattr(dc_cls, '__setattr__', _dataclass_validate_assignment_setattr)
+
+
+def _get_validators(cls: 'DataclassClassOrWrapper') -> 'CallableGenerator':
+    yield cls.__validate__
+
+
+def _validate_dataclass(cls: Type['DataclassT'], v: Any) -> 'DataclassT':
+    with set_validation(cls, True):
+        if isinstance(v, cls):
+            v.__pydantic_validate_values__()
+            return v
+        elif isinstance(v, (list, tuple)):
+            return cls(*v)
+        elif isinstance(v, dict):
+            return cls(**v)
+        else:
+            raise DataclassTypeError(class_name=cls.__name__)
+
+
+def create_pydantic_model_from_dataclass(
+    dc_cls: Type['Dataclass'],
+    config: Type[Any] = BaseConfig,
+    dc_cls_doc: Optional[str] = None,
+) -> Type['BaseModel']:
+    field_definitions: Dict[str, Any] = {}
+    for field in dataclasses.fields(dc_cls):
+        default: Any = Undefined
+        default_factory: Optional['NoArgAnyCallable'] = None
+        field_info: FieldInfo
+
+        if field.default is not dataclasses.MISSING:
+            default = field.default
+        elif field.default_factory is not dataclasses.MISSING:
+            default_factory = field.default_factory
+        else:
+            default = Required
+
+        if isinstance(default, FieldInfo):
+            field_info = default
+            dc_cls.__pydantic_has_field_info_default__ = True
+        else:
+            field_info = Field(default=default, default_factory=default_factory, **field.metadata)
+
+        field_definitions[field.name] = (field.type, field_info)
+
+    validators = gather_all_validators(dc_cls)
+    model: Type['BaseModel'] = create_model(
+        dc_cls.__name__,
+        __config__=config,
+        __module__=dc_cls.__module__,
+        __validators__=validators,
+        __cls_kwargs__={'__resolve_forward_refs__': False},
+        **field_definitions,
+    )
+    model.__doc__ = dc_cls_doc if dc_cls_doc is not None else dc_cls.__doc__ or ''
+    return model
+
+
+if sys.version_info >= (3, 8):
+
+    def _is_field_cached_property(obj: 'Dataclass', k: str) -> bool:
+        return isinstance(getattr(type(obj), k, None), cached_property)
+
+else:
+
+    def _is_field_cached_property(obj: 'Dataclass', k: str) -> bool:
+        return False
+
+
+def _dataclass_validate_values(self: 'Dataclass') -> None:
+    # validation errors can occur if this function is called twice on an already initialised dataclass.
+    # for example if Extra.forbid is enabled, it would consider __pydantic_initialised__ an invalid extra property
+    if getattr(self, '__pydantic_initialised__'):
+        return
+    if getattr(self, '__pydantic_has_field_info_default__', False):
+        # We need to remove `FieldInfo` values since they are not valid as input
+        # It's ok to do that because they are obviously the default values!
+        input_data = {
+            k: v
+            for k, v in self.__dict__.items()
+            if not (isinstance(v, FieldInfo) or _is_field_cached_property(self, k))
+        }
+    else:
+        input_data = {k: v for k, v in self.__dict__.items() if not _is_field_cached_property(self, k)}
+    d, _, validation_error = validate_model(self.__pydantic_model__, input_data, cls=self.__class__)
+    if validation_error:
+        raise validation_error
+    self.__dict__.update(d)
+    object.__setattr__(self, '__pydantic_initialised__', True)
+
+
+def _dataclass_validate_assignment_setattr(self: 'Dataclass', name: str, value: Any) -> None:
+    if self.__pydantic_initialised__:
+        d = dict(self.__dict__)
+        d.pop(name, None)
+        known_field = self.__pydantic_model__.__fields__.get(name, None)
+        if known_field:
+            value, error_ = known_field.validate(value, d, loc=name, cls=self.__class__)
+            if error_:
+                raise ValidationError([error_], self.__class__)
+
+    object.__setattr__(self, name, value)
+
+
+def is_builtin_dataclass(_cls: Type[Any]) -> bool:
+    """
+    Whether a class is a stdlib dataclass
+    (useful to discriminated a pydantic dataclass that is actually a wrapper around a stdlib dataclass)
+
+    we check that
+    - `_cls` is a dataclass
+    - `_cls` is not a processed pydantic dataclass (with a basemodel attached)
+    - `_cls` is not a pydantic dataclass inheriting directly from a stdlib dataclass
+    e.g.
+    ```
+    @dataclasses.dataclass
+    class A:
+        x: int
+
+    @pydantic.dataclasses.dataclass
+    class B(A):
+        y: int
+    ```
+    In this case, when we first check `B`, we make an extra check and look at the annotations ('y'),
+    which won't be a superset of all the dataclass fields (only the stdlib fields i.e. 'x')
+    """
+    return (
+        dataclasses.is_dataclass(_cls)
+        and not hasattr(_cls, '__pydantic_model__')
+        and set(_cls.__dataclass_fields__).issuperset(set(getattr(_cls, '__annotations__', {})))
+    )
+
+
+def make_dataclass_validator(dc_cls: Type['Dataclass'], config: Type[BaseConfig]) -> 'CallableGenerator':
+    """
+    Create a pydantic.dataclass from a builtin dataclass to add type validation
+    and yield the validators
+    It retrieves the parameters of the dataclass and forwards them to the newly created dataclass
+    """
+    yield from _get_validators(dataclass(dc_cls, config=config, use_proxy=True))
diff --git a/lib/pydantic/v1/datetime_parse.py b/lib/pydantic/v1/datetime_parse.py
new file mode 100644
index 00000000..cfd54593
--- /dev/null
+++ b/lib/pydantic/v1/datetime_parse.py
@@ -0,0 +1,248 @@
+"""
+Functions to parse datetime objects.
+
+We're using regular expressions rather than time.strptime because:
+- They provide both validation and parsing.
+- They're more flexible for datetimes.
+- The date/datetime/time constructors produce friendlier error messages.
+
+Stolen from https://raw.githubusercontent.com/django/django/main/django/utils/dateparse.py at
+9718fa2e8abe430c3526a9278dd976443d4ae3c6
+
+Changed to:
+* use standard python datetime types not django.utils.timezone
+* raise ValueError when regex doesn't match rather than returning None
+* support parsing unix timestamps for dates and datetimes
+"""
+import re
+from datetime import date, datetime, time, timedelta, timezone
+from typing import Dict, Optional, Type, Union
+
+from . import errors
+
+date_expr = r'(?P<year>\d{4})-(?P<month>\d{1,2})-(?P<day>\d{1,2})'
+time_expr = (
+    r'(?P<hour>\d{1,2}):(?P<minute>\d{1,2})'
+    r'(?::(?P<second>\d{1,2})(?:\.(?P<microsecond>\d{1,6})\d{0,6})?)?'
+    r'(?P<tzinfo>Z|[+-]\d{2}(?::?\d{2})?)?$'
+)
+
+date_re = re.compile(f'{date_expr}$')
+time_re = re.compile(time_expr)
+datetime_re = re.compile(f'{date_expr}[T ]{time_expr}')
+
+standard_duration_re = re.compile(
+    r'^'
+    r'(?:(?P<days>-?\d+) (days?, )?)?'
+    r'((?:(?P<hours>-?\d+):)(?=\d+:\d+))?'
+    r'(?:(?P<minutes>-?\d+):)?'
+    r'(?P<seconds>-?\d+)'
+    r'(?:\.(?P<microseconds>\d{1,6})\d{0,6})?'
+    r'$'
+)
+
+# Support the sections of ISO 8601 date representation that are accepted by timedelta
+iso8601_duration_re = re.compile(
+    r'^(?P<sign>[-+]?)'
+    r'P'
+    r'(?:(?P<days>\d+(.\d+)?)D)?'
+    r'(?:T'
+    r'(?:(?P<hours>\d+(.\d+)?)H)?'
+    r'(?:(?P<minutes>\d+(.\d+)?)M)?'
+    r'(?:(?P<seconds>\d+(.\d+)?)S)?'
+    r')?'
+    r'$'
+)
+
+EPOCH = datetime(1970, 1, 1)
+# if greater than this, the number is in ms, if less than or equal it's in seconds
+# (in seconds this is 11th October 2603, in ms it's 20th August 1970)
+MS_WATERSHED = int(2e10)
+# slightly more than datetime.max in ns - (datetime.max - EPOCH).total_seconds() * 1e9
+MAX_NUMBER = int(3e20)
+StrBytesIntFloat = Union[str, bytes, int, float]
+
+
+def get_numeric(value: StrBytesIntFloat, native_expected_type: str) -> Union[None, int, float]:
+    if isinstance(value, (int, float)):
+        return value
+    try:
+        return float(value)
+    except ValueError:
+        return None
+    except TypeError:
+        raise TypeError(f'invalid type; expected {native_expected_type}, string, bytes, int or float')
+
+
+def from_unix_seconds(seconds: Union[int, float]) -> datetime:
+    if seconds > MAX_NUMBER:
+        return datetime.max
+    elif seconds < -MAX_NUMBER:
+        return datetime.min
+
+    while abs(seconds) > MS_WATERSHED:
+        seconds /= 1000
+    dt = EPOCH + timedelta(seconds=seconds)
+    return dt.replace(tzinfo=timezone.utc)
+
+
+def _parse_timezone(value: Optional[str], error: Type[Exception]) -> Union[None, int, timezone]:
+    if value == 'Z':
+        return timezone.utc
+    elif value is not None:
+        offset_mins = int(value[-2:]) if len(value) > 3 else 0
+        offset = 60 * int(value[1:3]) + offset_mins
+        if value[0] == '-':
+            offset = -offset
+        try:
+            return timezone(timedelta(minutes=offset))
+        except ValueError:
+            raise error()
+    else:
+        return None
+
+
+def parse_date(value: Union[date, StrBytesIntFloat]) -> date:
+    """
+    Parse a date/int/float/string and return a datetime.date.
+
+    Raise ValueError if the input is well formatted but not a valid date.
+    Raise ValueError if the input isn't well formatted.
+    """
+    if isinstance(value, date):
+        if isinstance(value, datetime):
+            return value.date()
+        else:
+            return value
+
+    number = get_numeric(value, 'date')
+    if number is not None:
+        return from_unix_seconds(number).date()
+
+    if isinstance(value, bytes):
+        value = value.decode()
+
+    match = date_re.match(value)  # type: ignore
+    if match is None:
+        raise errors.DateError()
+
+    kw = {k: int(v) for k, v in match.groupdict().items()}
+
+    try:
+        return date(**kw)
+    except ValueError:
+        raise errors.DateError()
+
+
+def parse_time(value: Union[time, StrBytesIntFloat]) -> time:
+    """
+    Parse a time/string and return a datetime.time.
+
+    Raise ValueError if the input is well formatted but not a valid time.
+    Raise ValueError if the input isn't well formatted, in particular if it contains an offset.
+    """
+    if isinstance(value, time):
+        return value
+
+    number = get_numeric(value, 'time')
+    if number is not None:
+        if number >= 86400:
+            # doesn't make sense since the time time loop back around to 0
+            raise errors.TimeError()
+        return (datetime.min + timedelta(seconds=number)).time()
+
+    if isinstance(value, bytes):
+        value = value.decode()
+
+    match = time_re.match(value)  # type: ignore
+    if match is None:
+        raise errors.TimeError()
+
+    kw = match.groupdict()
+    if kw['microsecond']:
+        kw['microsecond'] = kw['microsecond'].ljust(6, '0')
+
+    tzinfo = _parse_timezone(kw.pop('tzinfo'), errors.TimeError)
+    kw_: Dict[str, Union[None, int, timezone]] = {k: int(v) for k, v in kw.items() if v is not None}
+    kw_['tzinfo'] = tzinfo
+
+    try:
+        return time(**kw_)  # type: ignore
+    except ValueError:
+        raise errors.TimeError()
+
+
+def parse_datetime(value: Union[datetime, StrBytesIntFloat]) -> datetime:
+    """
+    Parse a datetime/int/float/string and return a datetime.datetime.
+
+    This function supports time zone offsets. When the input contains one,
+    the output uses a timezone with a fixed offset from UTC.
+
+    Raise ValueError if the input is well formatted but not a valid datetime.
+    Raise ValueError if the input isn't well formatted.
+    """
+    if isinstance(value, datetime):
+        return value
+
+    number = get_numeric(value, 'datetime')
+    if number is not None:
+        return from_unix_seconds(number)
+
+    if isinstance(value, bytes):
+        value = value.decode()
+
+    match = datetime_re.match(value)  # type: ignore
+    if match is None:
+        raise errors.DateTimeError()
+
+    kw = match.groupdict()
+    if kw['microsecond']:
+        kw['microsecond'] = kw['microsecond'].ljust(6, '0')
+
+    tzinfo = _parse_timezone(kw.pop('tzinfo'), errors.DateTimeError)
+    kw_: Dict[str, Union[None, int, timezone]] = {k: int(v) for k, v in kw.items() if v is not None}
+    kw_['tzinfo'] = tzinfo
+
+    try:
+        return datetime(**kw_)  # type: ignore
+    except ValueError:
+        raise errors.DateTimeError()
+
+
+def parse_duration(value: StrBytesIntFloat) -> timedelta:
+    """
+    Parse a duration int/float/string and return a datetime.timedelta.
+
+    The preferred format for durations in Django is '%d %H:%M:%S.%f'.
+
+    Also supports ISO 8601 representation.
+    """
+    if isinstance(value, timedelta):
+        return value
+
+    if isinstance(value, (int, float)):
+        # below code requires a string
+        value = f'{value:f}'
+    elif isinstance(value, bytes):
+        value = value.decode()
+
+    try:
+        match = standard_duration_re.match(value) or iso8601_duration_re.match(value)
+    except TypeError:
+        raise TypeError('invalid type; expected timedelta, string, bytes, int or float')
+
+    if not match:
+        raise errors.DurationError()
+
+    kw = match.groupdict()
+    sign = -1 if kw.pop('sign', '+') == '-' else 1
+    if kw.get('microseconds'):
+        kw['microseconds'] = kw['microseconds'].ljust(6, '0')
+
+    if kw.get('seconds') and kw.get('microseconds') and kw['seconds'].startswith('-'):
+        kw['microseconds'] = '-' + kw['microseconds']
+
+    kw_ = {k: float(v) for k, v in kw.items() if v is not None}
+
+    return sign * timedelta(**kw_)
diff --git a/lib/pydantic/v1/decorator.py b/lib/pydantic/v1/decorator.py
new file mode 100644
index 00000000..089aab65
--- /dev/null
+++ b/lib/pydantic/v1/decorator.py
@@ -0,0 +1,264 @@
+from functools import wraps
+from typing import TYPE_CHECKING, Any, Callable, Dict, List, Mapping, Optional, Tuple, Type, TypeVar, Union, overload
+
+from . import validator
+from .config import Extra
+from .errors import ConfigError
+from .main import BaseModel, create_model
+from .typing import get_all_type_hints
+from .utils import to_camel
+
+__all__ = ('validate_arguments',)
+
+if TYPE_CHECKING:
+    from .typing import AnyCallable
+
+    AnyCallableT = TypeVar('AnyCallableT', bound=AnyCallable)
+    ConfigType = Union[None, Type[Any], Dict[str, Any]]
+
+
+@overload
+def validate_arguments(func: None = None, *, config: 'ConfigType' = None) -> Callable[['AnyCallableT'], 'AnyCallableT']:
+    ...
+
+
+@overload
+def validate_arguments(func: 'AnyCallableT') -> 'AnyCallableT':
+    ...
+
+
+def validate_arguments(func: Optional['AnyCallableT'] = None, *, config: 'ConfigType' = None) -> Any:
+    """
+    Decorator to validate the arguments passed to a function.
+    """
+
+    def validate(_func: 'AnyCallable') -> 'AnyCallable':
+        vd = ValidatedFunction(_func, config)
+
+        @wraps(_func)
+        def wrapper_function(*args: Any, **kwargs: Any) -> Any:
+            return vd.call(*args, **kwargs)
+
+        wrapper_function.vd = vd  # type: ignore
+        wrapper_function.validate = vd.init_model_instance  # type: ignore
+        wrapper_function.raw_function = vd.raw_function  # type: ignore
+        wrapper_function.model = vd.model  # type: ignore
+        return wrapper_function
+
+    if func:
+        return validate(func)
+    else:
+        return validate
+
+
+ALT_V_ARGS = 'v__args'
+ALT_V_KWARGS = 'v__kwargs'
+V_POSITIONAL_ONLY_NAME = 'v__positional_only'
+V_DUPLICATE_KWARGS = 'v__duplicate_kwargs'
+
+
+class ValidatedFunction:
+    def __init__(self, function: 'AnyCallableT', config: 'ConfigType'):  # noqa C901
+        from inspect import Parameter, signature
+
+        parameters: Mapping[str, Parameter] = signature(function).parameters
+
+        if parameters.keys() & {ALT_V_ARGS, ALT_V_KWARGS, V_POSITIONAL_ONLY_NAME, V_DUPLICATE_KWARGS}:
+            raise ConfigError(
+                f'"{ALT_V_ARGS}", "{ALT_V_KWARGS}", "{V_POSITIONAL_ONLY_NAME}" and "{V_DUPLICATE_KWARGS}" '
+                f'are not permitted as argument names when using the "{validate_arguments.__name__}" decorator'
+            )
+
+        self.raw_function = function
+        self.arg_mapping: Dict[int, str] = {}
+        self.positional_only_args = set()
+        self.v_args_name = 'args'
+        self.v_kwargs_name = 'kwargs'
+
+        type_hints = get_all_type_hints(function)
+        takes_args = False
+        takes_kwargs = False
+        fields: Dict[str, Tuple[Any, Any]] = {}
+        for i, (name, p) in enumerate(parameters.items()):
+            if p.annotation is p.empty:
+                annotation = Any
+            else:
+                annotation = type_hints[name]
+
+            default = ... if p.default is p.empty else p.default
+            if p.kind == Parameter.POSITIONAL_ONLY:
+                self.arg_mapping[i] = name
+                fields[name] = annotation, default
+                fields[V_POSITIONAL_ONLY_NAME] = List[str], None
+                self.positional_only_args.add(name)
+            elif p.kind == Parameter.POSITIONAL_OR_KEYWORD:
+                self.arg_mapping[i] = name
+                fields[name] = annotation, default
+                fields[V_DUPLICATE_KWARGS] = List[str], None
+            elif p.kind == Parameter.KEYWORD_ONLY:
+                fields[name] = annotation, default
+            elif p.kind == Parameter.VAR_POSITIONAL:
+                self.v_args_name = name
+                fields[name] = Tuple[annotation, ...], None
+                takes_args = True
+            else:
+                assert p.kind == Parameter.VAR_KEYWORD, p.kind
+                self.v_kwargs_name = name
+                fields[name] = Dict[str, annotation], None  # type: ignore
+                takes_kwargs = True
+
+        # these checks avoid a clash between "args" and a field with that name
+        if not takes_args and self.v_args_name in fields:
+            self.v_args_name = ALT_V_ARGS
+
+        # same with "kwargs"
+        if not takes_kwargs and self.v_kwargs_name in fields:
+            self.v_kwargs_name = ALT_V_KWARGS
+
+        if not takes_args:
+            # we add the field so validation below can raise the correct exception
+            fields[self.v_args_name] = List[Any], None
+
+        if not takes_kwargs:
+            # same with kwargs
+            fields[self.v_kwargs_name] = Dict[Any, Any], None
+
+        self.create_model(fields, takes_args, takes_kwargs, config)
+
+    def init_model_instance(self, *args: Any, **kwargs: Any) -> BaseModel:
+        values = self.build_values(args, kwargs)
+        return self.model(**values)
+
+    def call(self, *args: Any, **kwargs: Any) -> Any:
+        m = self.init_model_instance(*args, **kwargs)
+        return self.execute(m)
+
+    def build_values(self, args: Tuple[Any, ...], kwargs: Dict[str, Any]) -> Dict[str, Any]:
+        values: Dict[str, Any] = {}
+        if args:
+            arg_iter = enumerate(args)
+            while True:
+                try:
+                    i, a = next(arg_iter)
+                except StopIteration:
+                    break
+                arg_name = self.arg_mapping.get(i)
+                if arg_name is not None:
+                    values[arg_name] = a
+                else:
+                    values[self.v_args_name] = [a] + [a for _, a in arg_iter]
+                    break
+
+        var_kwargs: Dict[str, Any] = {}
+        wrong_positional_args = []
+        duplicate_kwargs = []
+        fields_alias = [
+            field.alias
+            for name, field in self.model.__fields__.items()
+            if name not in (self.v_args_name, self.v_kwargs_name)
+        ]
+        non_var_fields = set(self.model.__fields__) - {self.v_args_name, self.v_kwargs_name}
+        for k, v in kwargs.items():
+            if k in non_var_fields or k in fields_alias:
+                if k in self.positional_only_args:
+                    wrong_positional_args.append(k)
+                if k in values:
+                    duplicate_kwargs.append(k)
+                values[k] = v
+            else:
+                var_kwargs[k] = v
+
+        if var_kwargs:
+            values[self.v_kwargs_name] = var_kwargs
+        if wrong_positional_args:
+            values[V_POSITIONAL_ONLY_NAME] = wrong_positional_args
+        if duplicate_kwargs:
+            values[V_DUPLICATE_KWARGS] = duplicate_kwargs
+        return values
+
+    def execute(self, m: BaseModel) -> Any:
+        d = {k: v for k, v in m._iter() if k in m.__fields_set__ or m.__fields__[k].default_factory}
+        var_kwargs = d.pop(self.v_kwargs_name, {})
+
+        if self.v_args_name in d:
+            args_: List[Any] = []
+            in_kwargs = False
+            kwargs = {}
+            for name, value in d.items():
+                if in_kwargs:
+                    kwargs[name] = value
+                elif name == self.v_args_name:
+                    args_ += value
+                    in_kwargs = True
+                else:
+                    args_.append(value)
+            return self.raw_function(*args_, **kwargs, **var_kwargs)
+        elif self.positional_only_args:
+            args_ = []
+            kwargs = {}
+            for name, value in d.items():
+                if name in self.positional_only_args:
+                    args_.append(value)
+                else:
+                    kwargs[name] = value
+            return self.raw_function(*args_, **kwargs, **var_kwargs)
+        else:
+            return self.raw_function(**d, **var_kwargs)
+
+    def create_model(self, fields: Dict[str, Any], takes_args: bool, takes_kwargs: bool, config: 'ConfigType') -> None:
+        pos_args = len(self.arg_mapping)
+
+        class CustomConfig:
+            pass
+
+        if not TYPE_CHECKING:  # pragma: no branch
+            if isinstance(config, dict):
+                CustomConfig = type('Config', (), config)  # noqa: F811
+            elif config is not None:
+                CustomConfig = config  # noqa: F811
+
+        if hasattr(CustomConfig, 'fields') or hasattr(CustomConfig, 'alias_generator'):
+            raise ConfigError(
+                'Setting the "fields" and "alias_generator" property on custom Config for '
+                '@validate_arguments is not yet supported, please remove.'
+            )
+
+        class DecoratorBaseModel(BaseModel):
+            @validator(self.v_args_name, check_fields=False, allow_reuse=True)
+            def check_args(cls, v: Optional[List[Any]]) -> Optional[List[Any]]:
+                if takes_args or v is None:
+                    return v
+
+                raise TypeError(f'{pos_args} positional arguments expected but {pos_args + len(v)} given')
+
+            @validator(self.v_kwargs_name, check_fields=False, allow_reuse=True)
+            def check_kwargs(cls, v: Optional[Dict[str, Any]]) -> Optional[Dict[str, Any]]:
+                if takes_kwargs or v is None:
+                    return v
+
+                plural = '' if len(v) == 1 else 's'
+                keys = ', '.join(map(repr, v.keys()))
+                raise TypeError(f'unexpected keyword argument{plural}: {keys}')
+
+            @validator(V_POSITIONAL_ONLY_NAME, check_fields=False, allow_reuse=True)
+            def check_positional_only(cls, v: Optional[List[str]]) -> None:
+                if v is None:
+                    return
+
+                plural = '' if len(v) == 1 else 's'
+                keys = ', '.join(map(repr, v))
+                raise TypeError(f'positional-only argument{plural} passed as keyword argument{plural}: {keys}')
+
+            @validator(V_DUPLICATE_KWARGS, check_fields=False, allow_reuse=True)
+            def check_duplicate_kwargs(cls, v: Optional[List[str]]) -> None:
+                if v is None:
+                    return
+
+                plural = '' if len(v) == 1 else 's'
+                keys = ', '.join(map(repr, v))
+                raise TypeError(f'multiple values for argument{plural}: {keys}')
+
+            class Config(CustomConfig):
+                extra = getattr(CustomConfig, 'extra', Extra.forbid)
+
+        self.model = create_model(to_camel(self.raw_function.__name__), __base__=DecoratorBaseModel, **fields)
diff --git a/lib/pydantic/v1/env_settings.py b/lib/pydantic/v1/env_settings.py
new file mode 100644
index 00000000..6c446e51
--- /dev/null
+++ b/lib/pydantic/v1/env_settings.py
@@ -0,0 +1,350 @@
+import os
+import warnings
+from pathlib import Path
+from typing import AbstractSet, Any, Callable, ClassVar, Dict, List, Mapping, Optional, Tuple, Type, Union
+
+from .config import BaseConfig, Extra
+from .fields import ModelField
+from .main import BaseModel
+from .types import JsonWrapper
+from .typing import StrPath, display_as_type, get_origin, is_union
+from .utils import deep_update, lenient_issubclass, path_type, sequence_like
+
+env_file_sentinel = str(object())
+
+SettingsSourceCallable = Callable[['BaseSettings'], Dict[str, Any]]
+DotenvType = Union[StrPath, List[StrPath], Tuple[StrPath, ...]]
+
+
+class SettingsError(ValueError):
+    pass
+
+
+class BaseSettings(BaseModel):
+    """
+    Base class for settings, allowing values to be overridden by environment variables.
+
+    This is useful in production for secrets you do not wish to save in code, it plays nicely with docker(-compose),
+    Heroku and any 12 factor app design.
+    """
+
+    def __init__(
+        __pydantic_self__,
+        _env_file: Optional[DotenvType] = env_file_sentinel,
+        _env_file_encoding: Optional[str] = None,
+        _env_nested_delimiter: Optional[str] = None,
+        _secrets_dir: Optional[StrPath] = None,
+        **values: Any,
+    ) -> None:
+        # Uses something other than `self` the first arg to allow "self" as a settable attribute
+        super().__init__(
+            **__pydantic_self__._build_values(
+                values,
+                _env_file=_env_file,
+                _env_file_encoding=_env_file_encoding,
+                _env_nested_delimiter=_env_nested_delimiter,
+                _secrets_dir=_secrets_dir,
+            )
+        )
+
+    def _build_values(
+        self,
+        init_kwargs: Dict[str, Any],
+        _env_file: Optional[DotenvType] = None,
+        _env_file_encoding: Optional[str] = None,
+        _env_nested_delimiter: Optional[str] = None,
+        _secrets_dir: Optional[StrPath] = None,
+    ) -> Dict[str, Any]:
+        # Configure built-in sources
+        init_settings = InitSettingsSource(init_kwargs=init_kwargs)
+        env_settings = EnvSettingsSource(
+            env_file=(_env_file if _env_file != env_file_sentinel else self.__config__.env_file),
+            env_file_encoding=(
+                _env_file_encoding if _env_file_encoding is not None else self.__config__.env_file_encoding
+            ),
+            env_nested_delimiter=(
+                _env_nested_delimiter if _env_nested_delimiter is not None else self.__config__.env_nested_delimiter
+            ),
+            env_prefix_len=len(self.__config__.env_prefix),
+        )
+        file_secret_settings = SecretsSettingsSource(secrets_dir=_secrets_dir or self.__config__.secrets_dir)
+        # Provide a hook to set built-in sources priority and add / remove sources
+        sources = self.__config__.customise_sources(
+            init_settings=init_settings, env_settings=env_settings, file_secret_settings=file_secret_settings
+        )
+        if sources:
+            return deep_update(*reversed([source(self) for source in sources]))
+        else:
+            # no one should mean to do this, but I think returning an empty dict is marginally preferable
+            # to an informative error and much better than a confusing error
+            return {}
+
+    class Config(BaseConfig):
+        env_prefix: str = ''
+        env_file: Optional[DotenvType] = None
+        env_file_encoding: Optional[str] = None
+        env_nested_delimiter: Optional[str] = None
+        secrets_dir: Optional[StrPath] = None
+        validate_all: bool = True
+        extra: Extra = Extra.forbid
+        arbitrary_types_allowed: bool = True
+        case_sensitive: bool = False
+
+        @classmethod
+        def prepare_field(cls, field: ModelField) -> None:
+            env_names: Union[List[str], AbstractSet[str]]
+            field_info_from_config = cls.get_field_info(field.name)
+
+            env = field_info_from_config.get('env') or field.field_info.extra.get('env')
+            if env is None:
+                if field.has_alias:
+                    warnings.warn(
+                        'aliases are no longer used by BaseSettings to define which environment variables to read. '
+                        'Instead use the "env" field setting. '
+                        'See https://pydantic-docs.helpmanual.io/usage/settings/#environment-variable-names',
+                        FutureWarning,
+                    )
+                env_names = {cls.env_prefix + field.name}
+            elif isinstance(env, str):
+                env_names = {env}
+            elif isinstance(env, (set, frozenset)):
+                env_names = env
+            elif sequence_like(env):
+                env_names = list(env)
+            else:
+                raise TypeError(f'invalid field env: {env!r} ({display_as_type(env)}); should be string, list or set')
+
+            if not cls.case_sensitive:
+                env_names = env_names.__class__(n.lower() for n in env_names)
+            field.field_info.extra['env_names'] = env_names
+
+        @classmethod
+        def customise_sources(
+            cls,
+            init_settings: SettingsSourceCallable,
+            env_settings: SettingsSourceCallable,
+            file_secret_settings: SettingsSourceCallable,
+        ) -> Tuple[SettingsSourceCallable, ...]:
+            return init_settings, env_settings, file_secret_settings
+
+        @classmethod
+        def parse_env_var(cls, field_name: str, raw_val: str) -> Any:
+            return cls.json_loads(raw_val)
+
+    # populated by the metaclass using the Config class defined above, annotated here to help IDEs only
+    __config__: ClassVar[Type[Config]]
+
+
+class InitSettingsSource:
+    __slots__ = ('init_kwargs',)
+
+    def __init__(self, init_kwargs: Dict[str, Any]):
+        self.init_kwargs = init_kwargs
+
+    def __call__(self, settings: BaseSettings) -> Dict[str, Any]:
+        return self.init_kwargs
+
+    def __repr__(self) -> str:
+        return f'InitSettingsSource(init_kwargs={self.init_kwargs!r})'
+
+
+class EnvSettingsSource:
+    __slots__ = ('env_file', 'env_file_encoding', 'env_nested_delimiter', 'env_prefix_len')
+
+    def __init__(
+        self,
+        env_file: Optional[DotenvType],
+        env_file_encoding: Optional[str],
+        env_nested_delimiter: Optional[str] = None,
+        env_prefix_len: int = 0,
+    ):
+        self.env_file: Optional[DotenvType] = env_file
+        self.env_file_encoding: Optional[str] = env_file_encoding
+        self.env_nested_delimiter: Optional[str] = env_nested_delimiter
+        self.env_prefix_len: int = env_prefix_len
+
+    def __call__(self, settings: BaseSettings) -> Dict[str, Any]:  # noqa C901
+        """
+        Build environment variables suitable for passing to the Model.
+        """
+        d: Dict[str, Any] = {}
+
+        if settings.__config__.case_sensitive:
+            env_vars: Mapping[str, Optional[str]] = os.environ
+        else:
+            env_vars = {k.lower(): v for k, v in os.environ.items()}
+
+        dotenv_vars = self._read_env_files(settings.__config__.case_sensitive)
+        if dotenv_vars:
+            env_vars = {**dotenv_vars, **env_vars}
+
+        for field in settings.__fields__.values():
+            env_val: Optional[str] = None
+            for env_name in field.field_info.extra['env_names']:
+                env_val = env_vars.get(env_name)
+                if env_val is not None:
+                    break
+
+            is_complex, allow_parse_failure = self.field_is_complex(field)
+            if is_complex:
+                if env_val is None:
+                    # field is complex but no value found so far, try explode_env_vars
+                    env_val_built = self.explode_env_vars(field, env_vars)
+                    if env_val_built:
+                        d[field.alias] = env_val_built
+                else:
+                    # field is complex and there's a value, decode that as JSON, then add explode_env_vars
+                    try:
+                        env_val = settings.__config__.parse_env_var(field.name, env_val)
+                    except ValueError as e:
+                        if not allow_parse_failure:
+                            raise SettingsError(f'error parsing env var "{env_name}"') from e
+
+                    if isinstance(env_val, dict):
+                        d[field.alias] = deep_update(env_val, self.explode_env_vars(field, env_vars))
+                    else:
+                        d[field.alias] = env_val
+            elif env_val is not None:
+                # simplest case, field is not complex, we only need to add the value if it was found
+                d[field.alias] = env_val
+
+        return d
+
+    def _read_env_files(self, case_sensitive: bool) -> Dict[str, Optional[str]]:
+        env_files = self.env_file
+        if env_files is None:
+            return {}
+
+        if isinstance(env_files, (str, os.PathLike)):
+            env_files = [env_files]
+
+        dotenv_vars = {}
+        for env_file in env_files:
+            env_path = Path(env_file).expanduser()
+            if env_path.is_file():
+                dotenv_vars.update(
+                    read_env_file(env_path, encoding=self.env_file_encoding, case_sensitive=case_sensitive)
+                )
+
+        return dotenv_vars
+
+    def field_is_complex(self, field: ModelField) -> Tuple[bool, bool]:
+        """
+        Find out if a field is complex, and if so whether JSON errors should be ignored
+        """
+        if lenient_issubclass(field.annotation, JsonWrapper):
+            return False, False
+
+        if field.is_complex():
+            allow_parse_failure = False
+        elif is_union(get_origin(field.type_)) and field.sub_fields and any(f.is_complex() for f in field.sub_fields):
+            allow_parse_failure = True
+        else:
+            return False, False
+
+        return True, allow_parse_failure
+
+    def explode_env_vars(self, field: ModelField, env_vars: Mapping[str, Optional[str]]) -> Dict[str, Any]:
+        """
+        Process env_vars and extract the values of keys containing env_nested_delimiter into nested dictionaries.
+
+        This is applied to a single field, hence filtering by env_var prefix.
+        """
+        prefixes = [f'{env_name}{self.env_nested_delimiter}' for env_name in field.field_info.extra['env_names']]
+        result: Dict[str, Any] = {}
+        for env_name, env_val in env_vars.items():
+            if not any(env_name.startswith(prefix) for prefix in prefixes):
+                continue
+            # we remove the prefix before splitting in case the prefix has characters in common with the delimiter
+            env_name_without_prefix = env_name[self.env_prefix_len :]
+            _, *keys, last_key = env_name_without_prefix.split(self.env_nested_delimiter)
+            env_var = result
+            for key in keys:
+                env_var = env_var.setdefault(key, {})
+            env_var[last_key] = env_val
+
+        return result
+
+    def __repr__(self) -> str:
+        return (
+            f'EnvSettingsSource(env_file={self.env_file!r}, env_file_encoding={self.env_file_encoding!r}, '
+            f'env_nested_delimiter={self.env_nested_delimiter!r})'
+        )
+
+
+class SecretsSettingsSource:
+    __slots__ = ('secrets_dir',)
+
+    def __init__(self, secrets_dir: Optional[StrPath]):
+        self.secrets_dir: Optional[StrPath] = secrets_dir
+
+    def __call__(self, settings: BaseSettings) -> Dict[str, Any]:
+        """
+        Build fields from "secrets" files.
+        """
+        secrets: Dict[str, Optional[str]] = {}
+
+        if self.secrets_dir is None:
+            return secrets
+
+        secrets_path = Path(self.secrets_dir).expanduser()
+
+        if not secrets_path.exists():
+            warnings.warn(f'directory "{secrets_path}" does not exist')
+            return secrets
+
+        if not secrets_path.is_dir():
+            raise SettingsError(f'secrets_dir must reference a directory, not a {path_type(secrets_path)}')
+
+        for field in settings.__fields__.values():
+            for env_name in field.field_info.extra['env_names']:
+                path = find_case_path(secrets_path, env_name, settings.__config__.case_sensitive)
+                if not path:
+                    # path does not exist, we currently don't return a warning for this
+                    continue
+
+                if path.is_file():
+                    secret_value = path.read_text().strip()
+                    if field.is_complex():
+                        try:
+                            secret_value = settings.__config__.parse_env_var(field.name, secret_value)
+                        except ValueError as e:
+                            raise SettingsError(f'error parsing env var "{env_name}"') from e
+
+                    secrets[field.alias] = secret_value
+                else:
+                    warnings.warn(
+                        f'attempted to load secret file "{path}" but found a {path_type(path)} instead.',
+                        stacklevel=4,
+                    )
+        return secrets
+
+    def __repr__(self) -> str:
+        return f'SecretsSettingsSource(secrets_dir={self.secrets_dir!r})'
+
+
+def read_env_file(
+    file_path: StrPath, *, encoding: str = None, case_sensitive: bool = False
+) -> Dict[str, Optional[str]]:
+    try:
+        from dotenv import dotenv_values
+    except ImportError as e:
+        raise ImportError('python-dotenv is not installed, run `pip install pydantic[dotenv]`') from e
+
+    file_vars: Dict[str, Optional[str]] = dotenv_values(file_path, encoding=encoding or 'utf8')
+    if not case_sensitive:
+        return {k.lower(): v for k, v in file_vars.items()}
+    else:
+        return file_vars
+
+
+def find_case_path(dir_path: Path, file_name: str, case_sensitive: bool) -> Optional[Path]:
+    """
+    Find a file within path's directory matching filename, optionally ignoring case.
+    """
+    for f in dir_path.iterdir():
+        if f.name == file_name:
+            return f
+        elif not case_sensitive and f.name.lower() == file_name.lower():
+            return f
+    return None
diff --git a/lib/pydantic/v1/error_wrappers.py b/lib/pydantic/v1/error_wrappers.py
new file mode 100644
index 00000000..d89a500c
--- /dev/null
+++ b/lib/pydantic/v1/error_wrappers.py
@@ -0,0 +1,161 @@
+import json
+from typing import TYPE_CHECKING, Any, Dict, Generator, List, Optional, Sequence, Tuple, Type, Union
+
+from .json import pydantic_encoder
+from .utils import Representation
+
+if TYPE_CHECKING:
+    from typing_extensions import TypedDict
+
+    from .config import BaseConfig
+    from .types import ModelOrDc
+    from .typing import ReprArgs
+
+    Loc = Tuple[Union[int, str], ...]
+
+    class _ErrorDictRequired(TypedDict):
+        loc: Loc
+        msg: str
+        type: str
+
+    class ErrorDict(_ErrorDictRequired, total=False):
+        ctx: Dict[str, Any]
+
+
+__all__ = 'ErrorWrapper', 'ValidationError'
+
+
+class ErrorWrapper(Representation):
+    __slots__ = 'exc', '_loc'
+
+    def __init__(self, exc: Exception, loc: Union[str, 'Loc']) -> None:
+        self.exc = exc
+        self._loc = loc
+
+    def loc_tuple(self) -> 'Loc':
+        if isinstance(self._loc, tuple):
+            return self._loc
+        else:
+            return (self._loc,)
+
+    def __repr_args__(self) -> 'ReprArgs':
+        return [('exc', self.exc), ('loc', self.loc_tuple())]
+
+
+# ErrorList is something like Union[List[Union[List[ErrorWrapper], ErrorWrapper]], ErrorWrapper]
+# but recursive, therefore just use:
+ErrorList = Union[Sequence[Any], ErrorWrapper]
+
+
+class ValidationError(Representation, ValueError):
+    __slots__ = 'raw_errors', 'model', '_error_cache'
+
+    def __init__(self, errors: Sequence[ErrorList], model: 'ModelOrDc') -> None:
+        self.raw_errors = errors
+        self.model = model
+        self._error_cache: Optional[List['ErrorDict']] = None
+
+    def errors(self) -> List['ErrorDict']:
+        if self._error_cache is None:
+            try:
+                config = self.model.__config__  # type: ignore
+            except AttributeError:
+                config = self.model.__pydantic_model__.__config__  # type: ignore
+            self._error_cache = list(flatten_errors(self.raw_errors, config))
+        return self._error_cache
+
+    def json(self, *, indent: Union[None, int, str] = 2) -> str:
+        return json.dumps(self.errors(), indent=indent, default=pydantic_encoder)
+
+    def __str__(self) -> str:
+        errors = self.errors()
+        no_errors = len(errors)
+        return (
+            f'{no_errors} validation error{"" if no_errors == 1 else "s"} for {self.model.__name__}\n'
+            f'{display_errors(errors)}'
+        )
+
+    def __repr_args__(self) -> 'ReprArgs':
+        return [('model', self.model.__name__), ('errors', self.errors())]
+
+
+def display_errors(errors: List['ErrorDict']) -> str:
+    return '\n'.join(f'{_display_error_loc(e)}\n  {e["msg"]} ({_display_error_type_and_ctx(e)})' for e in errors)
+
+
+def _display_error_loc(error: 'ErrorDict') -> str:
+    return ' -> '.join(str(e) for e in error['loc'])
+
+
+def _display_error_type_and_ctx(error: 'ErrorDict') -> str:
+    t = 'type=' + error['type']
+    ctx = error.get('ctx')
+    if ctx:
+        return t + ''.join(f'; {k}={v}' for k, v in ctx.items())
+    else:
+        return t
+
+
+def flatten_errors(
+    errors: Sequence[Any], config: Type['BaseConfig'], loc: Optional['Loc'] = None
+) -> Generator['ErrorDict', None, None]:
+    for error in errors:
+        if isinstance(error, ErrorWrapper):
+            if loc:
+                error_loc = loc + error.loc_tuple()
+            else:
+                error_loc = error.loc_tuple()
+
+            if isinstance(error.exc, ValidationError):
+                yield from flatten_errors(error.exc.raw_errors, config, error_loc)
+            else:
+                yield error_dict(error.exc, config, error_loc)
+        elif isinstance(error, list):
+            yield from flatten_errors(error, config, loc=loc)
+        else:
+            raise RuntimeError(f'Unknown error object: {error}')
+
+
+def error_dict(exc: Exception, config: Type['BaseConfig'], loc: 'Loc') -> 'ErrorDict':
+    type_ = get_exc_type(exc.__class__)
+    msg_template = config.error_msg_templates.get(type_) or getattr(exc, 'msg_template', None)
+    ctx = exc.__dict__
+    if msg_template:
+        msg = msg_template.format(**ctx)
+    else:
+        msg = str(exc)
+
+    d: 'ErrorDict' = {'loc': loc, 'msg': msg, 'type': type_}
+
+    if ctx:
+        d['ctx'] = ctx
+
+    return d
+
+
+_EXC_TYPE_CACHE: Dict[Type[Exception], str] = {}
+
+
+def get_exc_type(cls: Type[Exception]) -> str:
+    # slightly more efficient than using lru_cache since we don't need to worry about the cache filling up
+    try:
+        return _EXC_TYPE_CACHE[cls]
+    except KeyError:
+        r = _get_exc_type(cls)
+        _EXC_TYPE_CACHE[cls] = r
+        return r
+
+
+def _get_exc_type(cls: Type[Exception]) -> str:
+    if issubclass(cls, AssertionError):
+        return 'assertion_error'
+
+    base_name = 'type_error' if issubclass(cls, TypeError) else 'value_error'
+    if cls in (TypeError, ValueError):
+        # just TypeError or ValueError, no extra code
+        return base_name
+
+    # if it's not a TypeError or ValueError, we just take the lowercase of the exception name
+    # no chaining or snake case logic, use "code" for more complex error types.
+    code = getattr(cls, 'code', None) or cls.__name__.replace('Error', '').lower()
+    return base_name + '.' + code
diff --git a/lib/pydantic/v1/errors.py b/lib/pydantic/v1/errors.py
new file mode 100644
index 00000000..7bdafdd1
--- /dev/null
+++ b/lib/pydantic/v1/errors.py
@@ -0,0 +1,646 @@
+from decimal import Decimal
+from pathlib import Path
+from typing import TYPE_CHECKING, Any, Callable, Sequence, Set, Tuple, Type, Union
+
+from .typing import display_as_type
+
+if TYPE_CHECKING:
+    from .typing import DictStrAny
+
+# explicitly state exports to avoid "from .errors import *" also importing Decimal, Path etc.
+__all__ = (
+    'PydanticTypeError',
+    'PydanticValueError',
+    'ConfigError',
+    'MissingError',
+    'ExtraError',
+    'NoneIsNotAllowedError',
+    'NoneIsAllowedError',
+    'WrongConstantError',
+    'NotNoneError',
+    'BoolError',
+    'BytesError',
+    'DictError',
+    'EmailError',
+    'UrlError',
+    'UrlSchemeError',
+    'UrlSchemePermittedError',
+    'UrlUserInfoError',
+    'UrlHostError',
+    'UrlHostTldError',
+    'UrlPortError',
+    'UrlExtraError',
+    'EnumError',
+    'IntEnumError',
+    'EnumMemberError',
+    'IntegerError',
+    'FloatError',
+    'PathError',
+    'PathNotExistsError',
+    'PathNotAFileError',
+    'PathNotADirectoryError',
+    'PyObjectError',
+    'SequenceError',
+    'ListError',
+    'SetError',
+    'FrozenSetError',
+    'TupleError',
+    'TupleLengthError',
+    'ListMinLengthError',
+    'ListMaxLengthError',
+    'ListUniqueItemsError',
+    'SetMinLengthError',
+    'SetMaxLengthError',
+    'FrozenSetMinLengthError',
+    'FrozenSetMaxLengthError',
+    'AnyStrMinLengthError',
+    'AnyStrMaxLengthError',
+    'StrError',
+    'StrRegexError',
+    'NumberNotGtError',
+    'NumberNotGeError',
+    'NumberNotLtError',
+    'NumberNotLeError',
+    'NumberNotMultipleError',
+    'DecimalError',
+    'DecimalIsNotFiniteError',
+    'DecimalMaxDigitsError',
+    'DecimalMaxPlacesError',
+    'DecimalWholeDigitsError',
+    'DateTimeError',
+    'DateError',
+    'DateNotInThePastError',
+    'DateNotInTheFutureError',
+    'TimeError',
+    'DurationError',
+    'HashableError',
+    'UUIDError',
+    'UUIDVersionError',
+    'ArbitraryTypeError',
+    'ClassError',
+    'SubclassError',
+    'JsonError',
+    'JsonTypeError',
+    'PatternError',
+    'DataclassTypeError',
+    'CallableError',
+    'IPvAnyAddressError',
+    'IPvAnyInterfaceError',
+    'IPvAnyNetworkError',
+    'IPv4AddressError',
+    'IPv6AddressError',
+    'IPv4NetworkError',
+    'IPv6NetworkError',
+    'IPv4InterfaceError',
+    'IPv6InterfaceError',
+    'ColorError',
+    'StrictBoolError',
+    'NotDigitError',
+    'LuhnValidationError',
+    'InvalidLengthForBrand',
+    'InvalidByteSize',
+    'InvalidByteSizeUnit',
+    'MissingDiscriminator',
+    'InvalidDiscriminator',
+)
+
+
+def cls_kwargs(cls: Type['PydanticErrorMixin'], ctx: 'DictStrAny') -> 'PydanticErrorMixin':
+    """
+    For built-in exceptions like ValueError or TypeError, we need to implement
+    __reduce__ to override the default behaviour (instead of __getstate__/__setstate__)
+    By default pickle protocol 2 calls `cls.__new__(cls, *args)`.
+    Since we only use kwargs, we need a little constructor to change that.
+    Note: the callable can't be a lambda as pickle looks in the namespace to find it
+    """
+    return cls(**ctx)
+
+
+class PydanticErrorMixin:
+    code: str
+    msg_template: str
+
+    def __init__(self, **ctx: Any) -> None:
+        self.__dict__ = ctx
+
+    def __str__(self) -> str:
+        return self.msg_template.format(**self.__dict__)
+
+    def __reduce__(self) -> Tuple[Callable[..., 'PydanticErrorMixin'], Tuple[Type['PydanticErrorMixin'], 'DictStrAny']]:
+        return cls_kwargs, (self.__class__, self.__dict__)
+
+
+class PydanticTypeError(PydanticErrorMixin, TypeError):
+    pass
+
+
+class PydanticValueError(PydanticErrorMixin, ValueError):
+    pass
+
+
+class ConfigError(RuntimeError):
+    pass
+
+
+class MissingError(PydanticValueError):
+    msg_template = 'field required'
+
+
+class ExtraError(PydanticValueError):
+    msg_template = 'extra fields not permitted'
+
+
+class NoneIsNotAllowedError(PydanticTypeError):
+    code = 'none.not_allowed'
+    msg_template = 'none is not an allowed value'
+
+
+class NoneIsAllowedError(PydanticTypeError):
+    code = 'none.allowed'
+    msg_template = 'value is not none'
+
+
+class WrongConstantError(PydanticValueError):
+    code = 'const'
+
+    def __str__(self) -> str:
+        permitted = ', '.join(repr(v) for v in self.permitted)  # type: ignore
+        return f'unexpected value; permitted: {permitted}'
+
+
+class NotNoneError(PydanticTypeError):
+    code = 'not_none'
+    msg_template = 'value is not None'
+
+
+class BoolError(PydanticTypeError):
+    msg_template = 'value could not be parsed to a boolean'
+
+
+class BytesError(PydanticTypeError):
+    msg_template = 'byte type expected'
+
+
+class DictError(PydanticTypeError):
+    msg_template = 'value is not a valid dict'
+
+
+class EmailError(PydanticValueError):
+    msg_template = 'value is not a valid email address'
+
+
+class UrlError(PydanticValueError):
+    code = 'url'
+
+
+class UrlSchemeError(UrlError):
+    code = 'url.scheme'
+    msg_template = 'invalid or missing URL scheme'
+
+
+class UrlSchemePermittedError(UrlError):
+    code = 'url.scheme'
+    msg_template = 'URL scheme not permitted'
+
+    def __init__(self, allowed_schemes: Set[str]):
+        super().__init__(allowed_schemes=allowed_schemes)
+
+
+class UrlUserInfoError(UrlError):
+    code = 'url.userinfo'
+    msg_template = 'userinfo required in URL but missing'
+
+
+class UrlHostError(UrlError):
+    code = 'url.host'
+    msg_template = 'URL host invalid'
+
+
+class UrlHostTldError(UrlError):
+    code = 'url.host'
+    msg_template = 'URL host invalid, top level domain required'
+
+
+class UrlPortError(UrlError):
+    code = 'url.port'
+    msg_template = 'URL port invalid, port cannot exceed 65535'
+
+
+class UrlExtraError(UrlError):
+    code = 'url.extra'
+    msg_template = 'URL invalid, extra characters found after valid URL: {extra!r}'
+
+
+class EnumMemberError(PydanticTypeError):
+    code = 'enum'
+
+    def __str__(self) -> str:
+        permitted = ', '.join(repr(v.value) for v in self.enum_values)  # type: ignore
+        return f'value is not a valid enumeration member; permitted: {permitted}'
+
+
+class IntegerError(PydanticTypeError):
+    msg_template = 'value is not a valid integer'
+
+
+class FloatError(PydanticTypeError):
+    msg_template = 'value is not a valid float'
+
+
+class PathError(PydanticTypeError):
+    msg_template = 'value is not a valid path'
+
+
+class _PathValueError(PydanticValueError):
+    def __init__(self, *, path: Path) -> None:
+        super().__init__(path=str(path))
+
+
+class PathNotExistsError(_PathValueError):
+    code = 'path.not_exists'
+    msg_template = 'file or directory at path "{path}" does not exist'
+
+
+class PathNotAFileError(_PathValueError):
+    code = 'path.not_a_file'
+    msg_template = 'path "{path}" does not point to a file'
+
+
+class PathNotADirectoryError(_PathValueError):
+    code = 'path.not_a_directory'
+    msg_template = 'path "{path}" does not point to a directory'
+
+
+class PyObjectError(PydanticTypeError):
+    msg_template = 'ensure this value contains valid import path or valid callable: {error_message}'
+
+
+class SequenceError(PydanticTypeError):
+    msg_template = 'value is not a valid sequence'
+
+
+class IterableError(PydanticTypeError):
+    msg_template = 'value is not a valid iterable'
+
+
+class ListError(PydanticTypeError):
+    msg_template = 'value is not a valid list'
+
+
+class SetError(PydanticTypeError):
+    msg_template = 'value is not a valid set'
+
+
+class FrozenSetError(PydanticTypeError):
+    msg_template = 'value is not a valid frozenset'
+
+
+class DequeError(PydanticTypeError):
+    msg_template = 'value is not a valid deque'
+
+
+class TupleError(PydanticTypeError):
+    msg_template = 'value is not a valid tuple'
+
+
+class TupleLengthError(PydanticValueError):
+    code = 'tuple.length'
+    msg_template = 'wrong tuple length {actual_length}, expected {expected_length}'
+
+    def __init__(self, *, actual_length: int, expected_length: int) -> None:
+        super().__init__(actual_length=actual_length, expected_length=expected_length)
+
+
+class ListMinLengthError(PydanticValueError):
+    code = 'list.min_items'
+    msg_template = 'ensure this value has at least {limit_value} items'
+
+    def __init__(self, *, limit_value: int) -> None:
+        super().__init__(limit_value=limit_value)
+
+
+class ListMaxLengthError(PydanticValueError):
+    code = 'list.max_items'
+    msg_template = 'ensure this value has at most {limit_value} items'
+
+    def __init__(self, *, limit_value: int) -> None:
+        super().__init__(limit_value=limit_value)
+
+
+class ListUniqueItemsError(PydanticValueError):
+    code = 'list.unique_items'
+    msg_template = 'the list has duplicated items'
+
+
+class SetMinLengthError(PydanticValueError):
+    code = 'set.min_items'
+    msg_template = 'ensure this value has at least {limit_value} items'
+
+    def __init__(self, *, limit_value: int) -> None:
+        super().__init__(limit_value=limit_value)
+
+
+class SetMaxLengthError(PydanticValueError):
+    code = 'set.max_items'
+    msg_template = 'ensure this value has at most {limit_value} items'
+
+    def __init__(self, *, limit_value: int) -> None:
+        super().__init__(limit_value=limit_value)
+
+
+class FrozenSetMinLengthError(PydanticValueError):
+    code = 'frozenset.min_items'
+    msg_template = 'ensure this value has at least {limit_value} items'
+
+    def __init__(self, *, limit_value: int) -> None:
+        super().__init__(limit_value=limit_value)
+
+
+class FrozenSetMaxLengthError(PydanticValueError):
+    code = 'frozenset.max_items'
+    msg_template = 'ensure this value has at most {limit_value} items'
+
+    def __init__(self, *, limit_value: int) -> None:
+        super().__init__(limit_value=limit_value)
+
+
+class AnyStrMinLengthError(PydanticValueError):
+    code = 'any_str.min_length'
+    msg_template = 'ensure this value has at least {limit_value} characters'
+
+    def __init__(self, *, limit_value: int) -> None:
+        super().__init__(limit_value=limit_value)
+
+
+class AnyStrMaxLengthError(PydanticValueError):
+    code = 'any_str.max_length'
+    msg_template = 'ensure this value has at most {limit_value} characters'
+
+    def __init__(self, *, limit_value: int) -> None:
+        super().__init__(limit_value=limit_value)
+
+
+class StrError(PydanticTypeError):
+    msg_template = 'str type expected'
+
+
+class StrRegexError(PydanticValueError):
+    code = 'str.regex'
+    msg_template = 'string does not match regex "{pattern}"'
+
+    def __init__(self, *, pattern: str) -> None:
+        super().__init__(pattern=pattern)
+
+
+class _NumberBoundError(PydanticValueError):
+    def __init__(self, *, limit_value: Union[int, float, Decimal]) -> None:
+        super().__init__(limit_value=limit_value)
+
+
+class NumberNotGtError(_NumberBoundError):
+    code = 'number.not_gt'
+    msg_template = 'ensure this value is greater than {limit_value}'
+
+
+class NumberNotGeError(_NumberBoundError):
+    code = 'number.not_ge'
+    msg_template = 'ensure this value is greater than or equal to {limit_value}'
+
+
+class NumberNotLtError(_NumberBoundError):
+    code = 'number.not_lt'
+    msg_template = 'ensure this value is less than {limit_value}'
+
+
+class NumberNotLeError(_NumberBoundError):
+    code = 'number.not_le'
+    msg_template = 'ensure this value is less than or equal to {limit_value}'
+
+
+class NumberNotFiniteError(PydanticValueError):
+    code = 'number.not_finite_number'
+    msg_template = 'ensure this value is a finite number'
+
+
+class NumberNotMultipleError(PydanticValueError):
+    code = 'number.not_multiple'
+    msg_template = 'ensure this value is a multiple of {multiple_of}'
+
+    def __init__(self, *, multiple_of: Union[int, float, Decimal]) -> None:
+        super().__init__(multiple_of=multiple_of)
+
+
+class DecimalError(PydanticTypeError):
+    msg_template = 'value is not a valid decimal'
+
+
+class DecimalIsNotFiniteError(PydanticValueError):
+    code = 'decimal.not_finite'
+    msg_template = 'value is not a valid decimal'
+
+
+class DecimalMaxDigitsError(PydanticValueError):
+    code = 'decimal.max_digits'
+    msg_template = 'ensure that there are no more than {max_digits} digits in total'
+
+    def __init__(self, *, max_digits: int) -> None:
+        super().__init__(max_digits=max_digits)
+
+
+class DecimalMaxPlacesError(PydanticValueError):
+    code = 'decimal.max_places'
+    msg_template = 'ensure that there are no more than {decimal_places} decimal places'
+
+    def __init__(self, *, decimal_places: int) -> None:
+        super().__init__(decimal_places=decimal_places)
+
+
+class DecimalWholeDigitsError(PydanticValueError):
+    code = 'decimal.whole_digits'
+    msg_template = 'ensure that there are no more than {whole_digits} digits before the decimal point'
+
+    def __init__(self, *, whole_digits: int) -> None:
+        super().__init__(whole_digits=whole_digits)
+
+
+class DateTimeError(PydanticValueError):
+    msg_template = 'invalid datetime format'
+
+
+class DateError(PydanticValueError):
+    msg_template = 'invalid date format'
+
+
+class DateNotInThePastError(PydanticValueError):
+    code = 'date.not_in_the_past'
+    msg_template = 'date is not in the past'
+
+
+class DateNotInTheFutureError(PydanticValueError):
+    code = 'date.not_in_the_future'
+    msg_template = 'date is not in the future'
+
+
+class TimeError(PydanticValueError):
+    msg_template = 'invalid time format'
+
+
+class DurationError(PydanticValueError):
+    msg_template = 'invalid duration format'
+
+
+class HashableError(PydanticTypeError):
+    msg_template = 'value is not a valid hashable'
+
+
+class UUIDError(PydanticTypeError):
+    msg_template = 'value is not a valid uuid'
+
+
+class UUIDVersionError(PydanticValueError):
+    code = 'uuid.version'
+    msg_template = 'uuid version {required_version} expected'
+
+    def __init__(self, *, required_version: int) -> None:
+        super().__init__(required_version=required_version)
+
+
+class ArbitraryTypeError(PydanticTypeError):
+    code = 'arbitrary_type'
+    msg_template = 'instance of {expected_arbitrary_type} expected'
+
+    def __init__(self, *, expected_arbitrary_type: Type[Any]) -> None:
+        super().__init__(expected_arbitrary_type=display_as_type(expected_arbitrary_type))
+
+
+class ClassError(PydanticTypeError):
+    code = 'class'
+    msg_template = 'a class is expected'
+
+
+class SubclassError(PydanticTypeError):
+    code = 'subclass'
+    msg_template = 'subclass of {expected_class} expected'
+
+    def __init__(self, *, expected_class: Type[Any]) -> None:
+        super().__init__(expected_class=display_as_type(expected_class))
+
+
+class JsonError(PydanticValueError):
+    msg_template = 'Invalid JSON'
+
+
+class JsonTypeError(PydanticTypeError):
+    code = 'json'
+    msg_template = 'JSON object must be str, bytes or bytearray'
+
+
+class PatternError(PydanticValueError):
+    code = 'regex_pattern'
+    msg_template = 'Invalid regular expression'
+
+
+class DataclassTypeError(PydanticTypeError):
+    code = 'dataclass'
+    msg_template = 'instance of {class_name}, tuple or dict expected'
+
+
+class CallableError(PydanticTypeError):
+    msg_template = '{value} is not callable'
+
+
+class EnumError(PydanticTypeError):
+    code = 'enum_instance'
+    msg_template = '{value} is not a valid Enum instance'
+
+
+class IntEnumError(PydanticTypeError):
+    code = 'int_enum_instance'
+    msg_template = '{value} is not a valid IntEnum instance'
+
+
+class IPvAnyAddressError(PydanticValueError):
+    msg_template = 'value is not a valid IPv4 or IPv6 address'
+
+
+class IPvAnyInterfaceError(PydanticValueError):
+    msg_template = 'value is not a valid IPv4 or IPv6 interface'
+
+
+class IPvAnyNetworkError(PydanticValueError):
+    msg_template = 'value is not a valid IPv4 or IPv6 network'
+
+
+class IPv4AddressError(PydanticValueError):
+    msg_template = 'value is not a valid IPv4 address'
+
+
+class IPv6AddressError(PydanticValueError):
+    msg_template = 'value is not a valid IPv6 address'
+
+
+class IPv4NetworkError(PydanticValueError):
+    msg_template = 'value is not a valid IPv4 network'
+
+
+class IPv6NetworkError(PydanticValueError):
+    msg_template = 'value is not a valid IPv6 network'
+
+
+class IPv4InterfaceError(PydanticValueError):
+    msg_template = 'value is not a valid IPv4 interface'
+
+
+class IPv6InterfaceError(PydanticValueError):
+    msg_template = 'value is not a valid IPv6 interface'
+
+
+class ColorError(PydanticValueError):
+    msg_template = 'value is not a valid color: {reason}'
+
+
+class StrictBoolError(PydanticValueError):
+    msg_template = 'value is not a valid boolean'
+
+
+class NotDigitError(PydanticValueError):
+    code = 'payment_card_number.digits'
+    msg_template = 'card number is not all digits'
+
+
+class LuhnValidationError(PydanticValueError):
+    code = 'payment_card_number.luhn_check'
+    msg_template = 'card number is not luhn valid'
+
+
+class InvalidLengthForBrand(PydanticValueError):
+    code = 'payment_card_number.invalid_length_for_brand'
+    msg_template = 'Length for a {brand} card must be {required_length}'
+
+
+class InvalidByteSize(PydanticValueError):
+    msg_template = 'could not parse value and unit from byte string'
+
+
+class InvalidByteSizeUnit(PydanticValueError):
+    msg_template = 'could not interpret byte unit: {unit}'
+
+
+class MissingDiscriminator(PydanticValueError):
+    code = 'discriminated_union.missing_discriminator'
+    msg_template = 'Discriminator {discriminator_key!r} is missing in value'
+
+
+class InvalidDiscriminator(PydanticValueError):
+    code = 'discriminated_union.invalid_discriminator'
+    msg_template = (
+        'No match for discriminator {discriminator_key!r} and value {discriminator_value!r} '
+        '(allowed values: {allowed_values})'
+    )
+
+    def __init__(self, *, discriminator_key: str, discriminator_value: Any, allowed_values: Sequence[Any]) -> None:
+        super().__init__(
+            discriminator_key=discriminator_key,
+            discriminator_value=discriminator_value,
+            allowed_values=', '.join(map(repr, allowed_values)),
+        )
diff --git a/lib/pydantic/v1/fields.py b/lib/pydantic/v1/fields.py
new file mode 100644
index 00000000..60d260e9
--- /dev/null
+++ b/lib/pydantic/v1/fields.py
@@ -0,0 +1,1253 @@
+import copy
+import re
+from collections import Counter as CollectionCounter, defaultdict, deque
+from collections.abc import Callable, Hashable as CollectionsHashable, Iterable as CollectionsIterable
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Counter,
+    DefaultDict,
+    Deque,
+    Dict,
+    ForwardRef,
+    FrozenSet,
+    Generator,
+    Iterable,
+    Iterator,
+    List,
+    Mapping,
+    Optional,
+    Pattern,
+    Sequence,
+    Set,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+)
+
+from typing_extensions import Annotated, Final
+
+from . import errors as errors_
+from .class_validators import Validator, make_generic_validator, prep_validators
+from .error_wrappers import ErrorWrapper
+from .errors import ConfigError, InvalidDiscriminator, MissingDiscriminator, NoneIsNotAllowedError
+from .types import Json, JsonWrapper
+from .typing import (
+    NoArgAnyCallable,
+    convert_generics,
+    display_as_type,
+    get_args,
+    get_origin,
+    is_finalvar,
+    is_literal_type,
+    is_new_type,
+    is_none_type,
+    is_typeddict,
+    is_typeddict_special,
+    is_union,
+    new_type_supertype,
+)
+from .utils import (
+    PyObjectStr,
+    Representation,
+    ValueItems,
+    get_discriminator_alias_and_values,
+    get_unique_discriminator_alias,
+    lenient_isinstance,
+    lenient_issubclass,
+    sequence_like,
+    smart_deepcopy,
+)
+from .validators import constant_validator, dict_validator, find_validators, validate_json
+
+Required: Any = Ellipsis
+
+T = TypeVar('T')
+
+
+class UndefinedType:
+    def __repr__(self) -> str:
+        return 'PydanticUndefined'
+
+    def __copy__(self: T) -> T:
+        return self
+
+    def __reduce__(self) -> str:
+        return 'Undefined'
+
+    def __deepcopy__(self: T, _: Any) -> T:
+        return self
+
+
+Undefined = UndefinedType()
+
+if TYPE_CHECKING:
+    from .class_validators import ValidatorsList
+    from .config import BaseConfig
+    from .error_wrappers import ErrorList
+    from .types import ModelOrDc
+    from .typing import AbstractSetIntStr, MappingIntStrAny, ReprArgs
+
+    ValidateReturn = Tuple[Optional[Any], Optional[ErrorList]]
+    LocStr = Union[Tuple[Union[int, str], ...], str]
+    BoolUndefined = Union[bool, UndefinedType]
+
+
+class FieldInfo(Representation):
+    """
+    Captures extra information about a field.
+    """
+
+    __slots__ = (
+        'default',
+        'default_factory',
+        'alias',
+        'alias_priority',
+        'title',
+        'description',
+        'exclude',
+        'include',
+        'const',
+        'gt',
+        'ge',
+        'lt',
+        'le',
+        'multiple_of',
+        'allow_inf_nan',
+        'max_digits',
+        'decimal_places',
+        'min_items',
+        'max_items',
+        'unique_items',
+        'min_length',
+        'max_length',
+        'allow_mutation',
+        'repr',
+        'regex',
+        'discriminator',
+        'extra',
+    )
+
+    # field constraints with the default value, it's also used in update_from_config below
+    __field_constraints__ = {
+        'min_length': None,
+        'max_length': None,
+        'regex': None,
+        'gt': None,
+        'lt': None,
+        'ge': None,
+        'le': None,
+        'multiple_of': None,
+        'allow_inf_nan': None,
+        'max_digits': None,
+        'decimal_places': None,
+        'min_items': None,
+        'max_items': None,
+        'unique_items': None,
+        'allow_mutation': True,
+    }
+
+    def __init__(self, default: Any = Undefined, **kwargs: Any) -> None:
+        self.default = default
+        self.default_factory = kwargs.pop('default_factory', None)
+        self.alias = kwargs.pop('alias', None)
+        self.alias_priority = kwargs.pop('alias_priority', 2 if self.alias is not None else None)
+        self.title = kwargs.pop('title', None)
+        self.description = kwargs.pop('description', None)
+        self.exclude = kwargs.pop('exclude', None)
+        self.include = kwargs.pop('include', None)
+        self.const = kwargs.pop('const', None)
+        self.gt = kwargs.pop('gt', None)
+        self.ge = kwargs.pop('ge', None)
+        self.lt = kwargs.pop('lt', None)
+        self.le = kwargs.pop('le', None)
+        self.multiple_of = kwargs.pop('multiple_of', None)
+        self.allow_inf_nan = kwargs.pop('allow_inf_nan', None)
+        self.max_digits = kwargs.pop('max_digits', None)
+        self.decimal_places = kwargs.pop('decimal_places', None)
+        self.min_items = kwargs.pop('min_items', None)
+        self.max_items = kwargs.pop('max_items', None)
+        self.unique_items = kwargs.pop('unique_items', None)
+        self.min_length = kwargs.pop('min_length', None)
+        self.max_length = kwargs.pop('max_length', None)
+        self.allow_mutation = kwargs.pop('allow_mutation', True)
+        self.regex = kwargs.pop('regex', None)
+        self.discriminator = kwargs.pop('discriminator', None)
+        self.repr = kwargs.pop('repr', True)
+        self.extra = kwargs
+
+    def __repr_args__(self) -> 'ReprArgs':
+        field_defaults_to_hide: Dict[str, Any] = {
+            'repr': True,
+            **self.__field_constraints__,
+        }
+
+        attrs = ((s, getattr(self, s)) for s in self.__slots__)
+        return [(a, v) for a, v in attrs if v != field_defaults_to_hide.get(a, None)]
+
+    def get_constraints(self) -> Set[str]:
+        """
+        Gets the constraints set on the field by comparing the constraint value with its default value
+
+        :return: the constraints set on field_info
+        """
+        return {attr for attr, default in self.__field_constraints__.items() if getattr(self, attr) != default}
+
+    def update_from_config(self, from_config: Dict[str, Any]) -> None:
+        """
+        Update this FieldInfo based on a dict from get_field_info, only fields which have not been set are dated.
+        """
+        for attr_name, value in from_config.items():
+            try:
+                current_value = getattr(self, attr_name)
+            except AttributeError:
+                # attr_name is not an attribute of FieldInfo, it should therefore be added to extra
+                # (except if extra already has this value!)
+                self.extra.setdefault(attr_name, value)
+            else:
+                if current_value is self.__field_constraints__.get(attr_name, None):
+                    setattr(self, attr_name, value)
+                elif attr_name == 'exclude':
+                    self.exclude = ValueItems.merge(value, current_value)
+                elif attr_name == 'include':
+                    self.include = ValueItems.merge(value, current_value, intersect=True)
+
+    def _validate(self) -> None:
+        if self.default is not Undefined and self.default_factory is not None:
+            raise ValueError('cannot specify both default and default_factory')
+
+
+def Field(
+    default: Any = Undefined,
+    *,
+    default_factory: Optional[NoArgAnyCallable] = None,
+    alias: Optional[str] = None,
+    title: Optional[str] = None,
+    description: Optional[str] = None,
+    exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny', Any]] = None,
+    include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny', Any]] = None,
+    const: Optional[bool] = None,
+    gt: Optional[float] = None,
+    ge: Optional[float] = None,
+    lt: Optional[float] = None,
+    le: Optional[float] = None,
+    multiple_of: Optional[float] = None,
+    allow_inf_nan: Optional[bool] = None,
+    max_digits: Optional[int] = None,
+    decimal_places: Optional[int] = None,
+    min_items: Optional[int] = None,
+    max_items: Optional[int] = None,
+    unique_items: Optional[bool] = None,
+    min_length: Optional[int] = None,
+    max_length: Optional[int] = None,
+    allow_mutation: bool = True,
+    regex: Optional[str] = None,
+    discriminator: Optional[str] = None,
+    repr: bool = True,
+    **extra: Any,
+) -> Any:
+    """
+    Used to provide extra information about a field, either for the model schema or complex validation. Some arguments
+    apply only to number fields (``int``, ``float``, ``Decimal``) and some apply only to ``str``.
+
+    :param default: since this is replacing the field’s default, its first argument is used
+      to set the default, use ellipsis (``...``) to indicate the field is required
+    :param default_factory: callable that will be called when a default value is needed for this field
+      If both `default` and `default_factory` are set, an error is raised.
+    :param alias: the public name of the field
+    :param title: can be any string, used in the schema
+    :param description: can be any string, used in the schema
+    :param exclude: exclude this field while dumping.
+      Takes same values as the ``include`` and ``exclude`` arguments on the ``.dict`` method.
+    :param include: include this field while dumping.
+      Takes same values as the ``include`` and ``exclude`` arguments on the ``.dict`` method.
+    :param const: this field is required and *must* take it's default value
+    :param gt: only applies to numbers, requires the field to be "greater than". The schema
+      will have an ``exclusiveMinimum`` validation keyword
+    :param ge: only applies to numbers, requires the field to be "greater than or equal to". The
+      schema will have a ``minimum`` validation keyword
+    :param lt: only applies to numbers, requires the field to be "less than". The schema
+      will have an ``exclusiveMaximum`` validation keyword
+    :param le: only applies to numbers, requires the field to be "less than or equal to". The
+      schema will have a ``maximum`` validation keyword
+    :param multiple_of: only applies to numbers, requires the field to be "a multiple of". The
+      schema will have a ``multipleOf`` validation keyword
+    :param allow_inf_nan: only applies to numbers, allows the field to be NaN or infinity (+inf or -inf),
+        which is a valid Python float. Default True, set to False for compatibility with JSON.
+    :param max_digits: only applies to Decimals, requires the field to have a maximum number
+      of digits within the decimal. It does not include a zero before the decimal point or trailing decimal zeroes.
+    :param decimal_places: only applies to Decimals, requires the field to have at most a number of decimal places
+      allowed. It does not include trailing decimal zeroes.
+    :param min_items: only applies to lists, requires the field to have a minimum number of
+      elements. The schema will have a ``minItems`` validation keyword
+    :param max_items: only applies to lists, requires the field to have a maximum number of
+      elements. The schema will have a ``maxItems`` validation keyword
+    :param unique_items: only applies to lists, requires the field not to have duplicated
+      elements. The schema will have a ``uniqueItems`` validation keyword
+    :param min_length: only applies to strings, requires the field to have a minimum length. The
+      schema will have a ``minLength`` validation keyword
+    :param max_length: only applies to strings, requires the field to have a maximum length. The
+      schema will have a ``maxLength`` validation keyword
+    :param allow_mutation: a boolean which defaults to True. When False, the field raises a TypeError if the field is
+      assigned on an instance.  The BaseModel Config must set validate_assignment to True
+    :param regex: only applies to strings, requires the field match against a regular expression
+      pattern string. The schema will have a ``pattern`` validation keyword
+    :param discriminator: only useful with a (discriminated a.k.a. tagged) `Union` of sub models with a common field.
+      The `discriminator` is the name of this common field to shorten validation and improve generated schema
+    :param repr: show this field in the representation
+    :param **extra: any additional keyword arguments will be added as is to the schema
+    """
+    field_info = FieldInfo(
+        default,
+        default_factory=default_factory,
+        alias=alias,
+        title=title,
+        description=description,
+        exclude=exclude,
+        include=include,
+        const=const,
+        gt=gt,
+        ge=ge,
+        lt=lt,
+        le=le,
+        multiple_of=multiple_of,
+        allow_inf_nan=allow_inf_nan,
+        max_digits=max_digits,
+        decimal_places=decimal_places,
+        min_items=min_items,
+        max_items=max_items,
+        unique_items=unique_items,
+        min_length=min_length,
+        max_length=max_length,
+        allow_mutation=allow_mutation,
+        regex=regex,
+        discriminator=discriminator,
+        repr=repr,
+        **extra,
+    )
+    field_info._validate()
+    return field_info
+
+
+# used to be an enum but changed to int's for small performance improvement as less access overhead
+SHAPE_SINGLETON = 1
+SHAPE_LIST = 2
+SHAPE_SET = 3
+SHAPE_MAPPING = 4
+SHAPE_TUPLE = 5
+SHAPE_TUPLE_ELLIPSIS = 6
+SHAPE_SEQUENCE = 7
+SHAPE_FROZENSET = 8
+SHAPE_ITERABLE = 9
+SHAPE_GENERIC = 10
+SHAPE_DEQUE = 11
+SHAPE_DICT = 12
+SHAPE_DEFAULTDICT = 13
+SHAPE_COUNTER = 14
+SHAPE_NAME_LOOKUP = {
+    SHAPE_LIST: 'List[{}]',
+    SHAPE_SET: 'Set[{}]',
+    SHAPE_TUPLE_ELLIPSIS: 'Tuple[{}, ...]',
+    SHAPE_SEQUENCE: 'Sequence[{}]',
+    SHAPE_FROZENSET: 'FrozenSet[{}]',
+    SHAPE_ITERABLE: 'Iterable[{}]',
+    SHAPE_DEQUE: 'Deque[{}]',
+    SHAPE_DICT: 'Dict[{}]',
+    SHAPE_DEFAULTDICT: 'DefaultDict[{}]',
+    SHAPE_COUNTER: 'Counter[{}]',
+}
+
+MAPPING_LIKE_SHAPES: Set[int] = {SHAPE_DEFAULTDICT, SHAPE_DICT, SHAPE_MAPPING, SHAPE_COUNTER}
+
+
+class ModelField(Representation):
+    __slots__ = (
+        'type_',
+        'outer_type_',
+        'annotation',
+        'sub_fields',
+        'sub_fields_mapping',
+        'key_field',
+        'validators',
+        'pre_validators',
+        'post_validators',
+        'default',
+        'default_factory',
+        'required',
+        'final',
+        'model_config',
+        'name',
+        'alias',
+        'has_alias',
+        'field_info',
+        'discriminator_key',
+        'discriminator_alias',
+        'validate_always',
+        'allow_none',
+        'shape',
+        'class_validators',
+        'parse_json',
+    )
+
+    def __init__(
+        self,
+        *,
+        name: str,
+        type_: Type[Any],
+        class_validators: Optional[Dict[str, Validator]],
+        model_config: Type['BaseConfig'],
+        default: Any = None,
+        default_factory: Optional[NoArgAnyCallable] = None,
+        required: 'BoolUndefined' = Undefined,
+        final: bool = False,
+        alias: Optional[str] = None,
+        field_info: Optional[FieldInfo] = None,
+    ) -> None:
+        self.name: str = name
+        self.has_alias: bool = alias is not None
+        self.alias: str = alias if alias is not None else name
+        self.annotation = type_
+        self.type_: Any = convert_generics(type_)
+        self.outer_type_: Any = type_
+        self.class_validators = class_validators or {}
+        self.default: Any = default
+        self.default_factory: Optional[NoArgAnyCallable] = default_factory
+        self.required: 'BoolUndefined' = required
+        self.final: bool = final
+        self.model_config = model_config
+        self.field_info: FieldInfo = field_info or FieldInfo(default)
+        self.discriminator_key: Optional[str] = self.field_info.discriminator
+        self.discriminator_alias: Optional[str] = self.discriminator_key
+
+        self.allow_none: bool = False
+        self.validate_always: bool = False
+        self.sub_fields: Optional[List[ModelField]] = None
+        self.sub_fields_mapping: Optional[Dict[str, 'ModelField']] = None  # used for discriminated union
+        self.key_field: Optional[ModelField] = None
+        self.validators: 'ValidatorsList' = []
+        self.pre_validators: Optional['ValidatorsList'] = None
+        self.post_validators: Optional['ValidatorsList'] = None
+        self.parse_json: bool = False
+        self.shape: int = SHAPE_SINGLETON
+        self.model_config.prepare_field(self)
+        self.prepare()
+
+    def get_default(self) -> Any:
+        return smart_deepcopy(self.default) if self.default_factory is None else self.default_factory()
+
+    @staticmethod
+    def _get_field_info(
+        field_name: str, annotation: Any, value: Any, config: Type['BaseConfig']
+    ) -> Tuple[FieldInfo, Any]:
+        """
+        Get a FieldInfo from a root typing.Annotated annotation, value, or config default.
+
+        The FieldInfo may be set in typing.Annotated or the value, but not both. If neither contain
+        a FieldInfo, a new one will be created using the config.
+
+        :param field_name: name of the field for use in error messages
+        :param annotation: a type hint such as `str` or `Annotated[str, Field(..., min_length=5)]`
+        :param value: the field's assigned value
+        :param config: the model's config object
+        :return: the FieldInfo contained in the `annotation`, the value, or a new one from the config.
+        """
+        field_info_from_config = config.get_field_info(field_name)
+
+        field_info = None
+        if get_origin(annotation) is Annotated:
+            field_infos = [arg for arg in get_args(annotation)[1:] if isinstance(arg, FieldInfo)]
+            if len(field_infos) > 1:
+                raise ValueError(f'cannot specify multiple `Annotated` `Field`s for {field_name!r}')
+            field_info = next(iter(field_infos), None)
+            if field_info is not None:
+                field_info = copy.copy(field_info)
+                field_info.update_from_config(field_info_from_config)
+                if field_info.default not in (Undefined, Required):
+                    raise ValueError(f'`Field` default cannot be set in `Annotated` for {field_name!r}')
+                if value is not Undefined and value is not Required:
+                    # check also `Required` because of `validate_arguments` that sets `...` as default value
+                    field_info.default = value
+
+        if isinstance(value, FieldInfo):
+            if field_info is not None:
+                raise ValueError(f'cannot specify `Annotated` and value `Field`s together for {field_name!r}')
+            field_info = value
+            field_info.update_from_config(field_info_from_config)
+        elif field_info is None:
+            field_info = FieldInfo(value, **field_info_from_config)
+        value = None if field_info.default_factory is not None else field_info.default
+        field_info._validate()
+        return field_info, value
+
+    @classmethod
+    def infer(
+        cls,
+        *,
+        name: str,
+        value: Any,
+        annotation: Any,
+        class_validators: Optional[Dict[str, Validator]],
+        config: Type['BaseConfig'],
+    ) -> 'ModelField':
+        from .schema import get_annotation_from_field_info
+
+        field_info, value = cls._get_field_info(name, annotation, value, config)
+        required: 'BoolUndefined' = Undefined
+        if value is Required:
+            required = True
+            value = None
+        elif value is not Undefined:
+            required = False
+        annotation = get_annotation_from_field_info(annotation, field_info, name, config.validate_assignment)
+
+        return cls(
+            name=name,
+            type_=annotation,
+            alias=field_info.alias,
+            class_validators=class_validators,
+            default=value,
+            default_factory=field_info.default_factory,
+            required=required,
+            model_config=config,
+            field_info=field_info,
+        )
+
+    def set_config(self, config: Type['BaseConfig']) -> None:
+        self.model_config = config
+        info_from_config = config.get_field_info(self.name)
+        config.prepare_field(self)
+        new_alias = info_from_config.get('alias')
+        new_alias_priority = info_from_config.get('alias_priority') or 0
+        if new_alias and new_alias_priority >= (self.field_info.alias_priority or 0):
+            self.field_info.alias = new_alias
+            self.field_info.alias_priority = new_alias_priority
+            self.alias = new_alias
+        new_exclude = info_from_config.get('exclude')
+        if new_exclude is not None:
+            self.field_info.exclude = ValueItems.merge(self.field_info.exclude, new_exclude)
+        new_include = info_from_config.get('include')
+        if new_include is not None:
+            self.field_info.include = ValueItems.merge(self.field_info.include, new_include, intersect=True)
+
+    @property
+    def alt_alias(self) -> bool:
+        return self.name != self.alias
+
+    def prepare(self) -> None:
+        """
+        Prepare the field but inspecting self.default, self.type_ etc.
+
+        Note: this method is **not** idempotent (because _type_analysis is not idempotent),
+        e.g. calling it it multiple times may modify the field and configure it incorrectly.
+        """
+        self._set_default_and_type()
+        if self.type_.__class__ is ForwardRef or self.type_.__class__ is DeferredType:
+            # self.type_ is currently a ForwardRef and there's nothing we can do now,
+            # user will need to call model.update_forward_refs()
+            return
+
+        self._type_analysis()
+        if self.required is Undefined:
+            self.required = True
+        if self.default is Undefined and self.default_factory is None:
+            self.default = None
+        self.populate_validators()
+
+    def _set_default_and_type(self) -> None:
+        """
+        Set the default value, infer the type if needed and check if `None` value is valid.
+        """
+        if self.default_factory is not None:
+            if self.type_ is Undefined:
+                raise errors_.ConfigError(
+                    f'you need to set the type of field {self.name!r} when using `default_factory`'
+                )
+            return
+
+        default_value = self.get_default()
+
+        if default_value is not None and self.type_ is Undefined:
+            self.type_ = default_value.__class__
+            self.outer_type_ = self.type_
+            self.annotation = self.type_
+
+        if self.type_ is Undefined:
+            raise errors_.ConfigError(f'unable to infer type for attribute "{self.name}"')
+
+        if self.required is False and default_value is None:
+            self.allow_none = True
+
+    def _type_analysis(self) -> None:  # noqa: C901 (ignore complexity)
+        # typing interface is horrible, we have to do some ugly checks
+        if lenient_issubclass(self.type_, JsonWrapper):
+            self.type_ = self.type_.inner_type
+            self.parse_json = True
+        elif lenient_issubclass(self.type_, Json):
+            self.type_ = Any
+            self.parse_json = True
+        elif isinstance(self.type_, TypeVar):
+            if self.type_.__bound__:
+                self.type_ = self.type_.__bound__
+            elif self.type_.__constraints__:
+                self.type_ = Union[self.type_.__constraints__]
+            else:
+                self.type_ = Any
+        elif is_new_type(self.type_):
+            self.type_ = new_type_supertype(self.type_)
+
+        if self.type_ is Any or self.type_ is object:
+            if self.required is Undefined:
+                self.required = False
+            self.allow_none = True
+            return
+        elif self.type_ is Pattern or self.type_ is re.Pattern:
+            # python 3.7 only, Pattern is a typing object but without sub fields
+            return
+        elif is_literal_type(self.type_):
+            return
+        elif is_typeddict(self.type_):
+            return
+
+        if is_finalvar(self.type_):
+            self.final = True
+
+            if self.type_ is Final:
+                self.type_ = Any
+            else:
+                self.type_ = get_args(self.type_)[0]
+
+            self._type_analysis()
+            return
+
+        origin = get_origin(self.type_)
+
+        if origin is Annotated or is_typeddict_special(origin):
+            self.type_ = get_args(self.type_)[0]
+            self._type_analysis()
+            return
+
+        if self.discriminator_key is not None and not is_union(origin):
+            raise TypeError('`discriminator` can only be used with `Union` type with more than one variant')
+
+        # add extra check for `collections.abc.Hashable` for python 3.10+ where origin is not `None`
+        if origin is None or origin is CollectionsHashable:
+            # field is not "typing" object eg. Union, Dict, List etc.
+            # allow None for virtual superclasses of NoneType, e.g. Hashable
+            if isinstance(self.type_, type) and isinstance(None, self.type_):
+                self.allow_none = True
+            return
+        elif origin is Callable:
+            return
+        elif is_union(origin):
+            types_ = []
+            for type_ in get_args(self.type_):
+                if is_none_type(type_) or type_ is Any or type_ is object:
+                    if self.required is Undefined:
+                        self.required = False
+                    self.allow_none = True
+                if is_none_type(type_):
+                    continue
+                types_.append(type_)
+
+            if len(types_) == 1:
+                # Optional[]
+                self.type_ = types_[0]
+                # this is the one case where the "outer type" isn't just the original type
+                self.outer_type_ = self.type_
+                # re-run to correctly interpret the new self.type_
+                self._type_analysis()
+            else:
+                self.sub_fields = [self._create_sub_type(t, f'{self.name}_{display_as_type(t)}') for t in types_]
+
+                if self.discriminator_key is not None:
+                    self.prepare_discriminated_union_sub_fields()
+            return
+        elif issubclass(origin, Tuple):  # type: ignore
+            # origin == Tuple without item type
+            args = get_args(self.type_)
+            if not args:  # plain tuple
+                self.type_ = Any
+                self.shape = SHAPE_TUPLE_ELLIPSIS
+            elif len(args) == 2 and args[1] is Ellipsis:  # e.g. Tuple[int, ...]
+                self.type_ = args[0]
+                self.shape = SHAPE_TUPLE_ELLIPSIS
+                self.sub_fields = [self._create_sub_type(args[0], f'{self.name}_0')]
+            elif args == ((),):  # Tuple[()] means empty tuple
+                self.shape = SHAPE_TUPLE
+                self.type_ = Any
+                self.sub_fields = []
+            else:
+                self.shape = SHAPE_TUPLE
+                self.sub_fields = [self._create_sub_type(t, f'{self.name}_{i}') for i, t in enumerate(args)]
+            return
+        elif issubclass(origin, List):
+            # Create self validators
+            get_validators = getattr(self.type_, '__get_validators__', None)
+            if get_validators:
+                self.class_validators.update(
+                    {f'list_{i}': Validator(validator, pre=True) for i, validator in enumerate(get_validators())}
+                )
+
+            self.type_ = get_args(self.type_)[0]
+            self.shape = SHAPE_LIST
+        elif issubclass(origin, Set):
+            # Create self validators
+            get_validators = getattr(self.type_, '__get_validators__', None)
+            if get_validators:
+                self.class_validators.update(
+                    {f'set_{i}': Validator(validator, pre=True) for i, validator in enumerate(get_validators())}
+                )
+
+            self.type_ = get_args(self.type_)[0]
+            self.shape = SHAPE_SET
+        elif issubclass(origin, FrozenSet):
+            # Create self validators
+            get_validators = getattr(self.type_, '__get_validators__', None)
+            if get_validators:
+                self.class_validators.update(
+                    {f'frozenset_{i}': Validator(validator, pre=True) for i, validator in enumerate(get_validators())}
+                )
+
+            self.type_ = get_args(self.type_)[0]
+            self.shape = SHAPE_FROZENSET
+        elif issubclass(origin, Deque):
+            self.type_ = get_args(self.type_)[0]
+            self.shape = SHAPE_DEQUE
+        elif issubclass(origin, Sequence):
+            self.type_ = get_args(self.type_)[0]
+            self.shape = SHAPE_SEQUENCE
+        # priority to most common mapping: dict
+        elif origin is dict or origin is Dict:
+            self.key_field = self._create_sub_type(get_args(self.type_)[0], 'key_' + self.name, for_keys=True)
+            self.type_ = get_args(self.type_)[1]
+            self.shape = SHAPE_DICT
+        elif issubclass(origin, DefaultDict):
+            self.key_field = self._create_sub_type(get_args(self.type_)[0], 'key_' + self.name, for_keys=True)
+            self.type_ = get_args(self.type_)[1]
+            self.shape = SHAPE_DEFAULTDICT
+        elif issubclass(origin, Counter):
+            self.key_field = self._create_sub_type(get_args(self.type_)[0], 'key_' + self.name, for_keys=True)
+            self.type_ = int
+            self.shape = SHAPE_COUNTER
+        elif issubclass(origin, Mapping):
+            self.key_field = self._create_sub_type(get_args(self.type_)[0], 'key_' + self.name, for_keys=True)
+            self.type_ = get_args(self.type_)[1]
+            self.shape = SHAPE_MAPPING
+        # Equality check as almost everything inherits form Iterable, including str
+        # check for Iterable and CollectionsIterable, as it could receive one even when declared with the other
+        elif origin in {Iterable, CollectionsIterable}:
+            self.type_ = get_args(self.type_)[0]
+            self.shape = SHAPE_ITERABLE
+            self.sub_fields = [self._create_sub_type(self.type_, f'{self.name}_type')]
+        elif issubclass(origin, Type):  # type: ignore
+            return
+        elif hasattr(origin, '__get_validators__') or self.model_config.arbitrary_types_allowed:
+            # Is a Pydantic-compatible generic that handles itself
+            # or we have arbitrary_types_allowed = True
+            self.shape = SHAPE_GENERIC
+            self.sub_fields = [self._create_sub_type(t, f'{self.name}_{i}') for i, t in enumerate(get_args(self.type_))]
+            self.type_ = origin
+            return
+        else:
+            raise TypeError(f'Fields of type "{origin}" are not supported.')
+
+        # type_ has been refined eg. as the type of a List and sub_fields needs to be populated
+        self.sub_fields = [self._create_sub_type(self.type_, '_' + self.name)]
+
+    def prepare_discriminated_union_sub_fields(self) -> None:
+        """
+        Prepare the mapping <discriminator key> -> <ModelField> and update `sub_fields`
+        Note that this process can be aborted if a `ForwardRef` is encountered
+        """
+        assert self.discriminator_key is not None
+
+        if self.type_.__class__ is DeferredType:
+            return
+
+        assert self.sub_fields is not None
+        sub_fields_mapping: Dict[str, 'ModelField'] = {}
+        all_aliases: Set[str] = set()
+
+        for sub_field in self.sub_fields:
+            t = sub_field.type_
+            if t.__class__ is ForwardRef:
+                # Stopping everything...will need to call `update_forward_refs`
+                return
+
+            alias, discriminator_values = get_discriminator_alias_and_values(t, self.discriminator_key)
+            all_aliases.add(alias)
+            for discriminator_value in discriminator_values:
+                sub_fields_mapping[discriminator_value] = sub_field
+
+        self.sub_fields_mapping = sub_fields_mapping
+        self.discriminator_alias = get_unique_discriminator_alias(all_aliases, self.discriminator_key)
+
+    def _create_sub_type(self, type_: Type[Any], name: str, *, for_keys: bool = False) -> 'ModelField':
+        if for_keys:
+            class_validators = None
+        else:
+            # validators for sub items should not have `each_item` as we want to check only the first sublevel
+            class_validators = {
+                k: Validator(
+                    func=v.func,
+                    pre=v.pre,
+                    each_item=False,
+                    always=v.always,
+                    check_fields=v.check_fields,
+                    skip_on_failure=v.skip_on_failure,
+                )
+                for k, v in self.class_validators.items()
+                if v.each_item
+            }
+
+        field_info, _ = self._get_field_info(name, type_, None, self.model_config)
+
+        return self.__class__(
+            type_=type_,
+            name=name,
+            class_validators=class_validators,
+            model_config=self.model_config,
+            field_info=field_info,
+        )
+
+    def populate_validators(self) -> None:
+        """
+        Prepare self.pre_validators, self.validators, and self.post_validators based on self.type_'s  __get_validators__
+        and class validators. This method should be idempotent, e.g. it should be safe to call multiple times
+        without mis-configuring the field.
+        """
+        self.validate_always = getattr(self.type_, 'validate_always', False) or any(
+            v.always for v in self.class_validators.values()
+        )
+
+        class_validators_ = self.class_validators.values()
+        if not self.sub_fields or self.shape == SHAPE_GENERIC:
+            get_validators = getattr(self.type_, '__get_validators__', None)
+            v_funcs = (
+                *[v.func for v in class_validators_ if v.each_item and v.pre],
+                *(get_validators() if get_validators else list(find_validators(self.type_, self.model_config))),
+                *[v.func for v in class_validators_ if v.each_item and not v.pre],
+            )
+            self.validators = prep_validators(v_funcs)
+
+        self.pre_validators = []
+        self.post_validators = []
+
+        if self.field_info and self.field_info.const:
+            self.post_validators.append(make_generic_validator(constant_validator))
+
+        if class_validators_:
+            self.pre_validators += prep_validators(v.func for v in class_validators_ if not v.each_item and v.pre)
+            self.post_validators += prep_validators(v.func for v in class_validators_ if not v.each_item and not v.pre)
+
+        if self.parse_json:
+            self.pre_validators.append(make_generic_validator(validate_json))
+
+        self.pre_validators = self.pre_validators or None
+        self.post_validators = self.post_validators or None
+
+    def validate(
+        self, v: Any, values: Dict[str, Any], *, loc: 'LocStr', cls: Optional['ModelOrDc'] = None
+    ) -> 'ValidateReturn':
+        assert self.type_.__class__ is not DeferredType
+
+        if self.type_.__class__ is ForwardRef:
+            assert cls is not None
+            raise ConfigError(
+                f'field "{self.name}" not yet prepared so type is still a ForwardRef, '
+                f'you might need to call {cls.__name__}.update_forward_refs().'
+            )
+
+        errors: Optional['ErrorList']
+        if self.pre_validators:
+            v, errors = self._apply_validators(v, values, loc, cls, self.pre_validators)
+            if errors:
+                return v, errors
+
+        if v is None:
+            if is_none_type(self.type_):
+                # keep validating
+                pass
+            elif self.allow_none:
+                if self.post_validators:
+                    return self._apply_validators(v, values, loc, cls, self.post_validators)
+                else:
+                    return None, None
+            else:
+                return v, ErrorWrapper(NoneIsNotAllowedError(), loc)
+
+        if self.shape == SHAPE_SINGLETON:
+            v, errors = self._validate_singleton(v, values, loc, cls)
+        elif self.shape in MAPPING_LIKE_SHAPES:
+            v, errors = self._validate_mapping_like(v, values, loc, cls)
+        elif self.shape == SHAPE_TUPLE:
+            v, errors = self._validate_tuple(v, values, loc, cls)
+        elif self.shape == SHAPE_ITERABLE:
+            v, errors = self._validate_iterable(v, values, loc, cls)
+        elif self.shape == SHAPE_GENERIC:
+            v, errors = self._apply_validators(v, values, loc, cls, self.validators)
+        else:
+            #  sequence, list, set, generator, tuple with ellipsis, frozen set
+            v, errors = self._validate_sequence_like(v, values, loc, cls)
+
+        if not errors and self.post_validators:
+            v, errors = self._apply_validators(v, values, loc, cls, self.post_validators)
+        return v, errors
+
+    def _validate_sequence_like(  # noqa: C901 (ignore complexity)
+        self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc']
+    ) -> 'ValidateReturn':
+        """
+        Validate sequence-like containers: lists, tuples, sets and generators
+        Note that large if-else blocks are necessary to enable Cython
+        optimization, which is why we disable the complexity check above.
+        """
+        if not sequence_like(v):
+            e: errors_.PydanticTypeError
+            if self.shape == SHAPE_LIST:
+                e = errors_.ListError()
+            elif self.shape in (SHAPE_TUPLE, SHAPE_TUPLE_ELLIPSIS):
+                e = errors_.TupleError()
+            elif self.shape == SHAPE_SET:
+                e = errors_.SetError()
+            elif self.shape == SHAPE_FROZENSET:
+                e = errors_.FrozenSetError()
+            else:
+                e = errors_.SequenceError()
+            return v, ErrorWrapper(e, loc)
+
+        loc = loc if isinstance(loc, tuple) else (loc,)
+        result = []
+        errors: List[ErrorList] = []
+        for i, v_ in enumerate(v):
+            v_loc = *loc, i
+            r, ee = self._validate_singleton(v_, values, v_loc, cls)
+            if ee:
+                errors.append(ee)
+            else:
+                result.append(r)
+
+        if errors:
+            return v, errors
+
+        converted: Union[List[Any], Set[Any], FrozenSet[Any], Tuple[Any, ...], Iterator[Any], Deque[Any]] = result
+
+        if self.shape == SHAPE_SET:
+            converted = set(result)
+        elif self.shape == SHAPE_FROZENSET:
+            converted = frozenset(result)
+        elif self.shape == SHAPE_TUPLE_ELLIPSIS:
+            converted = tuple(result)
+        elif self.shape == SHAPE_DEQUE:
+            converted = deque(result, maxlen=getattr(v, 'maxlen', None))
+        elif self.shape == SHAPE_SEQUENCE:
+            if isinstance(v, tuple):
+                converted = tuple(result)
+            elif isinstance(v, set):
+                converted = set(result)
+            elif isinstance(v, Generator):
+                converted = iter(result)
+            elif isinstance(v, deque):
+                converted = deque(result, maxlen=getattr(v, 'maxlen', None))
+        return converted, None
+
+    def _validate_iterable(
+        self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc']
+    ) -> 'ValidateReturn':
+        """
+        Validate Iterables.
+
+        This intentionally doesn't validate values to allow infinite generators.
+        """
+
+        try:
+            iterable = iter(v)
+        except TypeError:
+            return v, ErrorWrapper(errors_.IterableError(), loc)
+        return iterable, None
+
+    def _validate_tuple(
+        self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc']
+    ) -> 'ValidateReturn':
+        e: Optional[Exception] = None
+        if not sequence_like(v):
+            e = errors_.TupleError()
+        else:
+            actual_length, expected_length = len(v), len(self.sub_fields)  # type: ignore
+            if actual_length != expected_length:
+                e = errors_.TupleLengthError(actual_length=actual_length, expected_length=expected_length)
+
+        if e:
+            return v, ErrorWrapper(e, loc)
+
+        loc = loc if isinstance(loc, tuple) else (loc,)
+        result = []
+        errors: List[ErrorList] = []
+        for i, (v_, field) in enumerate(zip(v, self.sub_fields)):  # type: ignore
+            v_loc = *loc, i
+            r, ee = field.validate(v_, values, loc=v_loc, cls=cls)
+            if ee:
+                errors.append(ee)
+            else:
+                result.append(r)
+
+        if errors:
+            return v, errors
+        else:
+            return tuple(result), None
+
+    def _validate_mapping_like(
+        self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc']
+    ) -> 'ValidateReturn':
+        try:
+            v_iter = dict_validator(v)
+        except TypeError as exc:
+            return v, ErrorWrapper(exc, loc)
+
+        loc = loc if isinstance(loc, tuple) else (loc,)
+        result, errors = {}, []
+        for k, v_ in v_iter.items():
+            v_loc = *loc, '__key__'
+            key_result, key_errors = self.key_field.validate(k, values, loc=v_loc, cls=cls)  # type: ignore
+            if key_errors:
+                errors.append(key_errors)
+                continue
+
+            v_loc = *loc, k
+            value_result, value_errors = self._validate_singleton(v_, values, v_loc, cls)
+            if value_errors:
+                errors.append(value_errors)
+                continue
+
+            result[key_result] = value_result
+        if errors:
+            return v, errors
+        elif self.shape == SHAPE_DICT:
+            return result, None
+        elif self.shape == SHAPE_DEFAULTDICT:
+            return defaultdict(self.type_, result), None
+        elif self.shape == SHAPE_COUNTER:
+            return CollectionCounter(result), None
+        else:
+            return self._get_mapping_value(v, result), None
+
+    def _get_mapping_value(self, original: T, converted: Dict[Any, Any]) -> Union[T, Dict[Any, Any]]:
+        """
+        When type is `Mapping[KT, KV]` (or another unsupported mapping), we try to avoid
+        coercing to `dict` unwillingly.
+        """
+        original_cls = original.__class__
+
+        if original_cls == dict or original_cls == Dict:
+            return converted
+        elif original_cls in {defaultdict, DefaultDict}:
+            return defaultdict(self.type_, converted)
+        else:
+            try:
+                # Counter, OrderedDict, UserDict, ...
+                return original_cls(converted)  # type: ignore
+            except TypeError:
+                raise RuntimeError(f'Could not convert dictionary to {original_cls.__name__!r}') from None
+
+    def _validate_singleton(
+        self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc']
+    ) -> 'ValidateReturn':
+        if self.sub_fields:
+            if self.discriminator_key is not None:
+                return self._validate_discriminated_union(v, values, loc, cls)
+
+            errors = []
+
+            if self.model_config.smart_union and is_union(get_origin(self.type_)):
+                # 1st pass: check if the value is an exact instance of one of the Union types
+                # (e.g. to avoid coercing a bool into an int)
+                for field in self.sub_fields:
+                    if v.__class__ is field.outer_type_:
+                        return v, None
+
+                # 2nd pass: check if the value is an instance of any subclass of the Union types
+                for field in self.sub_fields:
+                    # This whole logic will be improved later on to support more complex `isinstance` checks
+                    # It will probably be done once a strict mode is added and be something like:
+                    # ```
+                    #     value, error = field.validate(v, values, strict=True)
+                    #     if error is None:
+                    #         return value, None
+                    # ```
+                    try:
+                        if isinstance(v, field.outer_type_):
+                            return v, None
+                    except TypeError:
+                        # compound type
+                        if lenient_isinstance(v, get_origin(field.outer_type_)):
+                            value, error = field.validate(v, values, loc=loc, cls=cls)
+                            if not error:
+                                return value, None
+
+            # 1st pass by default or 3rd pass with `smart_union` enabled:
+            # check if the value can be coerced into one of the Union types
+            for field in self.sub_fields:
+                value, error = field.validate(v, values, loc=loc, cls=cls)
+                if error:
+                    errors.append(error)
+                else:
+                    return value, None
+            return v, errors
+        else:
+            return self._apply_validators(v, values, loc, cls, self.validators)
+
+    def _validate_discriminated_union(
+        self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc']
+    ) -> 'ValidateReturn':
+        assert self.discriminator_key is not None
+        assert self.discriminator_alias is not None
+
+        try:
+            try:
+                discriminator_value = v[self.discriminator_alias]
+            except KeyError:
+                if self.model_config.allow_population_by_field_name:
+                    discriminator_value = v[self.discriminator_key]
+                else:
+                    raise
+        except KeyError:
+            return v, ErrorWrapper(MissingDiscriminator(discriminator_key=self.discriminator_key), loc)
+        except TypeError:
+            try:
+                # BaseModel or dataclass
+                discriminator_value = getattr(v, self.discriminator_key)
+            except (AttributeError, TypeError):
+                return v, ErrorWrapper(MissingDiscriminator(discriminator_key=self.discriminator_key), loc)
+
+        if self.sub_fields_mapping is None:
+            assert cls is not None
+            raise ConfigError(
+                f'field "{self.name}" not yet prepared so type is still a ForwardRef, '
+                f'you might need to call {cls.__name__}.update_forward_refs().'
+            )
+
+        try:
+            sub_field = self.sub_fields_mapping[discriminator_value]
+        except (KeyError, TypeError):
+            # KeyError: `discriminator_value` is not in the dictionary.
+            # TypeError: `discriminator_value` is unhashable.
+            assert self.sub_fields_mapping is not None
+            return v, ErrorWrapper(
+                InvalidDiscriminator(
+                    discriminator_key=self.discriminator_key,
+                    discriminator_value=discriminator_value,
+                    allowed_values=list(self.sub_fields_mapping),
+                ),
+                loc,
+            )
+        else:
+            if not isinstance(loc, tuple):
+                loc = (loc,)
+            return sub_field.validate(v, values, loc=(*loc, display_as_type(sub_field.type_)), cls=cls)
+
+    def _apply_validators(
+        self, v: Any, values: Dict[str, Any], loc: 'LocStr', cls: Optional['ModelOrDc'], validators: 'ValidatorsList'
+    ) -> 'ValidateReturn':
+        for validator in validators:
+            try:
+                v = validator(cls, v, values, self, self.model_config)
+            except (ValueError, TypeError, AssertionError) as exc:
+                return v, ErrorWrapper(exc, loc)
+        return v, None
+
+    def is_complex(self) -> bool:
+        """
+        Whether the field is "complex" eg. env variables should be parsed as JSON.
+        """
+        from .main import BaseModel
+
+        return (
+            self.shape != SHAPE_SINGLETON
+            or hasattr(self.type_, '__pydantic_model__')
+            or lenient_issubclass(self.type_, (BaseModel, list, set, frozenset, dict))
+        )
+
+    def _type_display(self) -> PyObjectStr:
+        t = display_as_type(self.type_)
+
+        if self.shape in MAPPING_LIKE_SHAPES:
+            t = f'Mapping[{display_as_type(self.key_field.type_)}, {t}]'  # type: ignore
+        elif self.shape == SHAPE_TUPLE:
+            t = 'Tuple[{}]'.format(', '.join(display_as_type(f.type_) for f in self.sub_fields))  # type: ignore
+        elif self.shape == SHAPE_GENERIC:
+            assert self.sub_fields
+            t = '{}[{}]'.format(
+                display_as_type(self.type_), ', '.join(display_as_type(f.type_) for f in self.sub_fields)
+            )
+        elif self.shape != SHAPE_SINGLETON:
+            t = SHAPE_NAME_LOOKUP[self.shape].format(t)
+
+        if self.allow_none and (self.shape != SHAPE_SINGLETON or not self.sub_fields):
+            t = f'Optional[{t}]'
+        return PyObjectStr(t)
+
+    def __repr_args__(self) -> 'ReprArgs':
+        args = [('name', self.name), ('type', self._type_display()), ('required', self.required)]
+
+        if not self.required:
+            if self.default_factory is not None:
+                args.append(('default_factory', f'<function {self.default_factory.__name__}>'))
+            else:
+                args.append(('default', self.default))
+
+        if self.alt_alias:
+            args.append(('alias', self.alias))
+        return args
+
+
+class ModelPrivateAttr(Representation):
+    __slots__ = ('default', 'default_factory')
+
+    def __init__(self, default: Any = Undefined, *, default_factory: Optional[NoArgAnyCallable] = None) -> None:
+        self.default = default
+        self.default_factory = default_factory
+
+    def get_default(self) -> Any:
+        return smart_deepcopy(self.default) if self.default_factory is None else self.default_factory()
+
+    def __eq__(self, other: Any) -> bool:
+        return isinstance(other, self.__class__) and (self.default, self.default_factory) == (
+            other.default,
+            other.default_factory,
+        )
+
+
+def PrivateAttr(
+    default: Any = Undefined,
+    *,
+    default_factory: Optional[NoArgAnyCallable] = None,
+) -> Any:
+    """
+    Indicates that attribute is only used internally and never mixed with regular fields.
+
+    Types or values of private attrs are not checked by pydantic and it's up to you to keep them relevant.
+
+    Private attrs are stored in model __slots__.
+
+    :param default: the attribute’s default value
+    :param default_factory: callable that will be called when a default value is needed for this attribute
+      If both `default` and `default_factory` are set, an error is raised.
+    """
+    if default is not Undefined and default_factory is not None:
+        raise ValueError('cannot specify both default and default_factory')
+
+    return ModelPrivateAttr(
+        default,
+        default_factory=default_factory,
+    )
+
+
+class DeferredType:
+    """
+    Used to postpone field preparation, while creating recursive generic models.
+    """
+
+
+def is_finalvar_with_default_val(type_: Type[Any], val: Any) -> bool:
+    return is_finalvar(type_) and val is not Undefined and not isinstance(val, FieldInfo)
diff --git a/lib/pydantic/v1/generics.py b/lib/pydantic/v1/generics.py
new file mode 100644
index 00000000..a75b6b98
--- /dev/null
+++ b/lib/pydantic/v1/generics.py
@@ -0,0 +1,400 @@
+import sys
+import types
+import typing
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    ClassVar,
+    Dict,
+    ForwardRef,
+    Generic,
+    Iterator,
+    List,
+    Mapping,
+    Optional,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+    cast,
+)
+from weakref import WeakKeyDictionary, WeakValueDictionary
+
+from typing_extensions import Annotated, Literal as ExtLiteral
+
+from .class_validators import gather_all_validators
+from .fields import DeferredType
+from .main import BaseModel, create_model
+from .types import JsonWrapper
+from .typing import display_as_type, get_all_type_hints, get_args, get_origin, typing_base
+from .utils import all_identical, lenient_issubclass
+
+if sys.version_info >= (3, 10):
+    from typing import _UnionGenericAlias
+if sys.version_info >= (3, 8):
+    from typing import Literal
+
+GenericModelT = TypeVar('GenericModelT', bound='GenericModel')
+TypeVarType = Any  # since mypy doesn't allow the use of TypeVar as a type
+
+CacheKey = Tuple[Type[Any], Any, Tuple[Any, ...]]
+Parametrization = Mapping[TypeVarType, Type[Any]]
+
+# weak dictionaries allow the dynamically created parametrized versions of generic models to get collected
+# once they are no longer referenced by the caller.
+if sys.version_info >= (3, 9):  # Typing for weak dictionaries available at 3.9
+    GenericTypesCache = WeakValueDictionary[CacheKey, Type[BaseModel]]
+    AssignedParameters = WeakKeyDictionary[Type[BaseModel], Parametrization]
+else:
+    GenericTypesCache = WeakValueDictionary
+    AssignedParameters = WeakKeyDictionary
+
+# _generic_types_cache is a Mapping from __class_getitem__ arguments to the parametrized version of generic models.
+# This ensures multiple calls of e.g. A[B] return always the same class.
+_generic_types_cache = GenericTypesCache()
+
+# _assigned_parameters is a Mapping from parametrized version of generic models to assigned types of parametrizations
+# as captured during construction of the class (not instances).
+# E.g., for generic model `Model[A, B]`, when parametrized model `Model[int, str]` is created,
+# `Model[int, str]`: {A: int, B: str}` will be stored in `_assigned_parameters`.
+# (This information is only otherwise available after creation from the class name string).
+_assigned_parameters = AssignedParameters()
+
+
+class GenericModel(BaseModel):
+    __slots__ = ()
+    __concrete__: ClassVar[bool] = False
+
+    if TYPE_CHECKING:
+        # Putting this in a TYPE_CHECKING block allows us to replace `if Generic not in cls.__bases__` with
+        # `not hasattr(cls, "__parameters__")`. This means we don't need to force non-concrete subclasses of
+        # `GenericModel` to also inherit from `Generic`, which would require changes to the use of `create_model` below.
+        __parameters__: ClassVar[Tuple[TypeVarType, ...]]
+
+    # Setting the return type as Type[Any] instead of Type[BaseModel] prevents PyCharm warnings
+    def __class_getitem__(cls: Type[GenericModelT], params: Union[Type[Any], Tuple[Type[Any], ...]]) -> Type[Any]:
+        """Instantiates a new class from a generic class `cls` and type variables `params`.
+
+        :param params: Tuple of types the class . Given a generic class
+            `Model` with 2 type variables and a concrete model `Model[str, int]`,
+            the value `(str, int)` would be passed to `params`.
+        :return: New model class inheriting from `cls` with instantiated
+            types described by `params`. If no parameters are given, `cls` is
+            returned as is.
+
+        """
+
+        def _cache_key(_params: Any) -> CacheKey:
+            args = get_args(_params)
+            # python returns a list for Callables, which is not hashable
+            if len(args) == 2 and isinstance(args[0], list):
+                args = (tuple(args[0]), args[1])
+            return cls, _params, args
+
+        cached = _generic_types_cache.get(_cache_key(params))
+        if cached is not None:
+            return cached
+        if cls.__concrete__ and Generic not in cls.__bases__:
+            raise TypeError('Cannot parameterize a concrete instantiation of a generic model')
+        if not isinstance(params, tuple):
+            params = (params,)
+        if cls is GenericModel and any(isinstance(param, TypeVar) for param in params):
+            raise TypeError('Type parameters should be placed on typing.Generic, not GenericModel')
+        if not hasattr(cls, '__parameters__'):
+            raise TypeError(f'Type {cls.__name__} must inherit from typing.Generic before being parameterized')
+
+        check_parameters_count(cls, params)
+        # Build map from generic typevars to passed params
+        typevars_map: Dict[TypeVarType, Type[Any]] = dict(zip(cls.__parameters__, params))
+        if all_identical(typevars_map.keys(), typevars_map.values()) and typevars_map:
+            return cls  # if arguments are equal to parameters it's the same object
+
+        # Create new model with original model as parent inserting fields with DeferredType.
+        model_name = cls.__concrete_name__(params)
+        validators = gather_all_validators(cls)
+
+        type_hints = get_all_type_hints(cls).items()
+        instance_type_hints = {k: v for k, v in type_hints if get_origin(v) is not ClassVar}
+
+        fields = {k: (DeferredType(), cls.__fields__[k].field_info) for k in instance_type_hints if k in cls.__fields__}
+
+        model_module, called_globally = get_caller_frame_info()
+        created_model = cast(
+            Type[GenericModel],  # casting ensures mypy is aware of the __concrete__ and __parameters__ attributes
+            create_model(
+                model_name,
+                __module__=model_module or cls.__module__,
+                __base__=(cls,) + tuple(cls.__parameterized_bases__(typevars_map)),
+                __config__=None,
+                __validators__=validators,
+                __cls_kwargs__=None,
+                **fields,
+            ),
+        )
+
+        _assigned_parameters[created_model] = typevars_map
+
+        if called_globally:  # create global reference and therefore allow pickling
+            object_by_reference = None
+            reference_name = model_name
+            reference_module_globals = sys.modules[created_model.__module__].__dict__
+            while object_by_reference is not created_model:
+                object_by_reference = reference_module_globals.setdefault(reference_name, created_model)
+                reference_name += '_'
+
+        created_model.Config = cls.Config
+
+        # Find any typevars that are still present in the model.
+        # If none are left, the model is fully "concrete", otherwise the new
+        # class is a generic class as well taking the found typevars as
+        # parameters.
+        new_params = tuple(
+            {param: None for param in iter_contained_typevars(typevars_map.values())}
+        )  # use dict as ordered set
+        created_model.__concrete__ = not new_params
+        if new_params:
+            created_model.__parameters__ = new_params
+
+        # Save created model in cache so we don't end up creating duplicate
+        # models that should be identical.
+        _generic_types_cache[_cache_key(params)] = created_model
+        if len(params) == 1:
+            _generic_types_cache[_cache_key(params[0])] = created_model
+
+        # Recursively walk class type hints and replace generic typevars
+        # with concrete types that were passed.
+        _prepare_model_fields(created_model, fields, instance_type_hints, typevars_map)
+
+        return created_model
+
+    @classmethod
+    def __concrete_name__(cls: Type[Any], params: Tuple[Type[Any], ...]) -> str:
+        """Compute class name for child classes.
+
+        :param params: Tuple of types the class . Given a generic class
+            `Model` with 2 type variables and a concrete model `Model[str, int]`,
+            the value `(str, int)` would be passed to `params`.
+        :return: String representing a the new class where `params` are
+            passed to `cls` as type variables.
+
+        This method can be overridden to achieve a custom naming scheme for GenericModels.
+        """
+        param_names = [display_as_type(param) for param in params]
+        params_component = ', '.join(param_names)
+        return f'{cls.__name__}[{params_component}]'
+
+    @classmethod
+    def __parameterized_bases__(cls, typevars_map: Parametrization) -> Iterator[Type[Any]]:
+        """
+        Returns unbound bases of cls parameterised to given type variables
+
+        :param typevars_map: Dictionary of type applications for binding subclasses.
+            Given a generic class `Model` with 2 type variables [S, T]
+            and a concrete model `Model[str, int]`,
+            the value `{S: str, T: int}` would be passed to `typevars_map`.
+        :return: an iterator of generic sub classes, parameterised by `typevars_map`
+            and other assigned parameters of `cls`
+
+        e.g.:
+        ```
+        class A(GenericModel, Generic[T]):
+            ...
+
+        class B(A[V], Generic[V]):
+            ...
+
+        assert A[int] in B.__parameterized_bases__({V: int})
+        ```
+        """
+
+        def build_base_model(
+            base_model: Type[GenericModel], mapped_types: Parametrization
+        ) -> Iterator[Type[GenericModel]]:
+            base_parameters = tuple(mapped_types[param] for param in base_model.__parameters__)
+            parameterized_base = base_model.__class_getitem__(base_parameters)
+            if parameterized_base is base_model or parameterized_base is cls:
+                # Avoid duplication in MRO
+                return
+            yield parameterized_base
+
+        for base_model in cls.__bases__:
+            if not issubclass(base_model, GenericModel):
+                # not a class that can be meaningfully parameterized
+                continue
+            elif not getattr(base_model, '__parameters__', None):
+                # base_model is "GenericModel"  (and has no __parameters__)
+                # or
+                # base_model is already concrete, and will be included transitively via cls.
+                continue
+            elif cls in _assigned_parameters:
+                if base_model in _assigned_parameters:
+                    # cls is partially parameterised but not from base_model
+                    # e.g. cls = B[S], base_model = A[S]
+                    # B[S][int] should subclass A[int],  (and will be transitively via B[int])
+                    # but it's not viable to consistently subclass types with arbitrary construction
+                    # So don't attempt to include A[S][int]
+                    continue
+                else:  # base_model not in _assigned_parameters:
+                    # cls is partially parameterized, base_model is original generic
+                    # e.g.  cls = B[str, T], base_model = B[S, T]
+                    # Need to determine the mapping for the base_model parameters
+                    mapped_types: Parametrization = {
+                        key: typevars_map.get(value, value) for key, value in _assigned_parameters[cls].items()
+                    }
+                    yield from build_base_model(base_model, mapped_types)
+            else:
+                # cls is base generic, so base_class has a distinct base
+                # can construct the Parameterised base model using typevars_map directly
+                yield from build_base_model(base_model, typevars_map)
+
+
+def replace_types(type_: Any, type_map: Mapping[Any, Any]) -> Any:
+    """Return type with all occurrences of `type_map` keys recursively replaced with their values.
+
+    :param type_: Any type, class or generic alias
+    :param type_map: Mapping from `TypeVar` instance to concrete types.
+    :return: New type representing the basic structure of `type_` with all
+        `typevar_map` keys recursively replaced.
+
+    >>> replace_types(Tuple[str, Union[List[str], float]], {str: int})
+    Tuple[int, Union[List[int], float]]
+
+    """
+    if not type_map:
+        return type_
+
+    type_args = get_args(type_)
+    origin_type = get_origin(type_)
+
+    if origin_type is Annotated:
+        annotated_type, *annotations = type_args
+        return Annotated[replace_types(annotated_type, type_map), tuple(annotations)]
+
+    if (origin_type is ExtLiteral) or (sys.version_info >= (3, 8) and origin_type is Literal):
+        return type_map.get(type_, type_)
+    # Having type args is a good indicator that this is a typing module
+    # class instantiation or a generic alias of some sort.
+    if type_args:
+        resolved_type_args = tuple(replace_types(arg, type_map) for arg in type_args)
+        if all_identical(type_args, resolved_type_args):
+            # If all arguments are the same, there is no need to modify the
+            # type or create a new object at all
+            return type_
+        if (
+            origin_type is not None
+            and isinstance(type_, typing_base)
+            and not isinstance(origin_type, typing_base)
+            and getattr(type_, '_name', None) is not None
+        ):
+            # In python < 3.9 generic aliases don't exist so any of these like `list`,
+            # `type` or `collections.abc.Callable` need to be translated.
+            # See: https://www.python.org/dev/peps/pep-0585
+            origin_type = getattr(typing, type_._name)
+        assert origin_type is not None
+        # PEP-604 syntax (Ex.: list | str) is represented with a types.UnionType object that does not have __getitem__.
+        # We also cannot use isinstance() since we have to compare types.
+        if sys.version_info >= (3, 10) and origin_type is types.UnionType:  # noqa: E721
+            return _UnionGenericAlias(origin_type, resolved_type_args)
+        return origin_type[resolved_type_args]
+
+    # We handle pydantic generic models separately as they don't have the same
+    # semantics as "typing" classes or generic aliases
+    if not origin_type and lenient_issubclass(type_, GenericModel) and not type_.__concrete__:
+        type_args = type_.__parameters__
+        resolved_type_args = tuple(replace_types(t, type_map) for t in type_args)
+        if all_identical(type_args, resolved_type_args):
+            return type_
+        return type_[resolved_type_args]
+
+    # Handle special case for typehints that can have lists as arguments.
+    # `typing.Callable[[int, str], int]` is an example for this.
+    if isinstance(type_, (List, list)):
+        resolved_list = list(replace_types(element, type_map) for element in type_)
+        if all_identical(type_, resolved_list):
+            return type_
+        return resolved_list
+
+    # For JsonWrapperValue, need to handle its inner type to allow correct parsing
+    # of generic Json arguments like Json[T]
+    if not origin_type and lenient_issubclass(type_, JsonWrapper):
+        type_.inner_type = replace_types(type_.inner_type, type_map)
+        return type_
+
+    # If all else fails, we try to resolve the type directly and otherwise just
+    # return the input with no modifications.
+    new_type = type_map.get(type_, type_)
+    # Convert string to ForwardRef
+    if isinstance(new_type, str):
+        return ForwardRef(new_type)
+    else:
+        return new_type
+
+
+def check_parameters_count(cls: Type[GenericModel], parameters: Tuple[Any, ...]) -> None:
+    actual = len(parameters)
+    expected = len(cls.__parameters__)
+    if actual != expected:
+        description = 'many' if actual > expected else 'few'
+        raise TypeError(f'Too {description} parameters for {cls.__name__}; actual {actual}, expected {expected}')
+
+
+DictValues: Type[Any] = {}.values().__class__
+
+
+def iter_contained_typevars(v: Any) -> Iterator[TypeVarType]:
+    """Recursively iterate through all subtypes and type args of `v` and yield any typevars that are found."""
+    if isinstance(v, TypeVar):
+        yield v
+    elif hasattr(v, '__parameters__') and not get_origin(v) and lenient_issubclass(v, GenericModel):
+        yield from v.__parameters__
+    elif isinstance(v, (DictValues, list)):
+        for var in v:
+            yield from iter_contained_typevars(var)
+    else:
+        args = get_args(v)
+        for arg in args:
+            yield from iter_contained_typevars(arg)
+
+
+def get_caller_frame_info() -> Tuple[Optional[str], bool]:
+    """
+    Used inside a function to check whether it was called globally
+
+    Will only work against non-compiled code, therefore used only in pydantic.generics
+
+    :returns Tuple[module_name, called_globally]
+    """
+    try:
+        previous_caller_frame = sys._getframe(2)
+    except ValueError as e:
+        raise RuntimeError('This function must be used inside another function') from e
+    except AttributeError:  # sys module does not have _getframe function, so there's nothing we can do about it
+        return None, False
+    frame_globals = previous_caller_frame.f_globals
+    return frame_globals.get('__name__'), previous_caller_frame.f_locals is frame_globals
+
+
+def _prepare_model_fields(
+    created_model: Type[GenericModel],
+    fields: Mapping[str, Any],
+    instance_type_hints: Mapping[str, type],
+    typevars_map: Mapping[Any, type],
+) -> None:
+    """
+    Replace DeferredType fields with concrete type hints and prepare them.
+    """
+
+    for key, field in created_model.__fields__.items():
+        if key not in fields:
+            assert field.type_.__class__ is not DeferredType
+            # https://github.com/nedbat/coveragepy/issues/198
+            continue  # pragma: no cover
+
+        assert field.type_.__class__ is DeferredType, field.type_.__class__
+
+        field_type_hint = instance_type_hints[key]
+        concrete_type = replace_types(field_type_hint, typevars_map)
+        field.type_ = concrete_type
+        field.outer_type_ = concrete_type
+        field.prepare()
+        created_model.__annotations__[key] = concrete_type
diff --git a/lib/pydantic/v1/json.py b/lib/pydantic/v1/json.py
new file mode 100644
index 00000000..b358b850
--- /dev/null
+++ b/lib/pydantic/v1/json.py
@@ -0,0 +1,112 @@
+import datetime
+from collections import deque
+from decimal import Decimal
+from enum import Enum
+from ipaddress import IPv4Address, IPv4Interface, IPv4Network, IPv6Address, IPv6Interface, IPv6Network
+from pathlib import Path
+from re import Pattern
+from types import GeneratorType
+from typing import Any, Callable, Dict, Type, Union
+from uuid import UUID
+
+from .color import Color
+from .networks import NameEmail
+from .types import SecretBytes, SecretStr
+
+__all__ = 'pydantic_encoder', 'custom_pydantic_encoder', 'timedelta_isoformat'
+
+
+def isoformat(o: Union[datetime.date, datetime.time]) -> str:
+    return o.isoformat()
+
+
+def decimal_encoder(dec_value: Decimal) -> Union[int, float]:
+    """
+    Encodes a Decimal as int of there's no exponent, otherwise float
+
+    This is useful when we use ConstrainedDecimal to represent Numeric(x,0)
+    where a integer (but not int typed) is used. Encoding this as a float
+    results in failed round-tripping between encode and parse.
+    Our Id type is a prime example of this.
+
+    >>> decimal_encoder(Decimal("1.0"))
+    1.0
+
+    >>> decimal_encoder(Decimal("1"))
+    1
+    """
+    if dec_value.as_tuple().exponent >= 0:
+        return int(dec_value)
+    else:
+        return float(dec_value)
+
+
+ENCODERS_BY_TYPE: Dict[Type[Any], Callable[[Any], Any]] = {
+    bytes: lambda o: o.decode(),
+    Color: str,
+    datetime.date: isoformat,
+    datetime.datetime: isoformat,
+    datetime.time: isoformat,
+    datetime.timedelta: lambda td: td.total_seconds(),
+    Decimal: decimal_encoder,
+    Enum: lambda o: o.value,
+    frozenset: list,
+    deque: list,
+    GeneratorType: list,
+    IPv4Address: str,
+    IPv4Interface: str,
+    IPv4Network: str,
+    IPv6Address: str,
+    IPv6Interface: str,
+    IPv6Network: str,
+    NameEmail: str,
+    Path: str,
+    Pattern: lambda o: o.pattern,
+    SecretBytes: str,
+    SecretStr: str,
+    set: list,
+    UUID: str,
+}
+
+
+def pydantic_encoder(obj: Any) -> Any:
+    from dataclasses import asdict, is_dataclass
+
+    from .main import BaseModel
+
+    if isinstance(obj, BaseModel):
+        return obj.dict()
+    elif is_dataclass(obj):
+        return asdict(obj)
+
+    # Check the class type and its superclasses for a matching encoder
+    for base in obj.__class__.__mro__[:-1]:
+        try:
+            encoder = ENCODERS_BY_TYPE[base]
+        except KeyError:
+            continue
+        return encoder(obj)
+    else:  # We have exited the for loop without finding a suitable encoder
+        raise TypeError(f"Object of type '{obj.__class__.__name__}' is not JSON serializable")
+
+
+def custom_pydantic_encoder(type_encoders: Dict[Any, Callable[[Type[Any]], Any]], obj: Any) -> Any:
+    # Check the class type and its superclasses for a matching encoder
+    for base in obj.__class__.__mro__[:-1]:
+        try:
+            encoder = type_encoders[base]
+        except KeyError:
+            continue
+
+        return encoder(obj)
+    else:  # We have exited the for loop without finding a suitable encoder
+        return pydantic_encoder(obj)
+
+
+def timedelta_isoformat(td: datetime.timedelta) -> str:
+    """
+    ISO 8601 encoding for Python timedelta object.
+    """
+    minutes, seconds = divmod(td.seconds, 60)
+    hours, minutes = divmod(minutes, 60)
+    return f'{"-" if td.days < 0 else ""}P{abs(td.days)}DT{hours:d}H{minutes:d}M{seconds:d}.{td.microseconds:06d}S'
diff --git a/lib/pydantic/v1/main.py b/lib/pydantic/v1/main.py
new file mode 100644
index 00000000..08b8af55
--- /dev/null
+++ b/lib/pydantic/v1/main.py
@@ -0,0 +1,1107 @@
+import warnings
+from abc import ABCMeta
+from copy import deepcopy
+from enum import Enum
+from functools import partial
+from pathlib import Path
+from types import FunctionType, prepare_class, resolve_bases
+from typing import (
+    TYPE_CHECKING,
+    AbstractSet,
+    Any,
+    Callable,
+    ClassVar,
+    Dict,
+    List,
+    Mapping,
+    Optional,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+    cast,
+    no_type_check,
+    overload,
+)
+
+from typing_extensions import dataclass_transform
+
+from .class_validators import ValidatorGroup, extract_root_validators, extract_validators, inherit_validators
+from .config import BaseConfig, Extra, inherit_config, prepare_config
+from .error_wrappers import ErrorWrapper, ValidationError
+from .errors import ConfigError, DictError, ExtraError, MissingError
+from .fields import (
+    MAPPING_LIKE_SHAPES,
+    Field,
+    ModelField,
+    ModelPrivateAttr,
+    PrivateAttr,
+    Undefined,
+    is_finalvar_with_default_val,
+)
+from .json import custom_pydantic_encoder, pydantic_encoder
+from .parse import Protocol, load_file, load_str_bytes
+from .schema import default_ref_template, model_schema
+from .types import PyObject, StrBytes
+from .typing import (
+    AnyCallable,
+    get_args,
+    get_origin,
+    is_classvar,
+    is_namedtuple,
+    is_union,
+    resolve_annotations,
+    update_model_forward_refs,
+)
+from .utils import (
+    DUNDER_ATTRIBUTES,
+    ROOT_KEY,
+    ClassAttribute,
+    GetterDict,
+    Representation,
+    ValueItems,
+    generate_model_signature,
+    is_valid_field,
+    is_valid_private_name,
+    lenient_issubclass,
+    sequence_like,
+    smart_deepcopy,
+    unique_list,
+    validate_field_name,
+)
+
+if TYPE_CHECKING:
+    from inspect import Signature
+
+    from .class_validators import ValidatorListDict
+    from .types import ModelOrDc
+    from .typing import (
+        AbstractSetIntStr,
+        AnyClassMethod,
+        CallableGenerator,
+        DictAny,
+        DictStrAny,
+        MappingIntStrAny,
+        ReprArgs,
+        SetStr,
+        TupleGenerator,
+    )
+
+    Model = TypeVar('Model', bound='BaseModel')
+
+__all__ = 'BaseModel', 'create_model', 'validate_model'
+
+_T = TypeVar('_T')
+
+
+def validate_custom_root_type(fields: Dict[str, ModelField]) -> None:
+    if len(fields) > 1:
+        raise ValueError(f'{ROOT_KEY} cannot be mixed with other fields')
+
+
+def generate_hash_function(frozen: bool) -> Optional[Callable[[Any], int]]:
+    def hash_function(self_: Any) -> int:
+        return hash(self_.__class__) + hash(tuple(self_.__dict__.values()))
+
+    return hash_function if frozen else None
+
+
+# If a field is of type `Callable`, its default value should be a function and cannot to ignored.
+ANNOTATED_FIELD_UNTOUCHED_TYPES: Tuple[Any, ...] = (property, type, classmethod, staticmethod)
+# When creating a `BaseModel` instance, we bypass all the methods, properties... added to the model
+UNTOUCHED_TYPES: Tuple[Any, ...] = (FunctionType,) + ANNOTATED_FIELD_UNTOUCHED_TYPES
+# Note `ModelMetaclass` refers to `BaseModel`, but is also used to *create* `BaseModel`, so we need to add this extra
+# (somewhat hacky) boolean to keep track of whether we've created the `BaseModel` class yet, and therefore whether it's
+# safe to refer to it. If it *hasn't* been created, we assume that the `__new__` call we're in the middle of is for
+# the `BaseModel` class, since that's defined immediately after the metaclass.
+_is_base_model_class_defined = False
+
+
+@dataclass_transform(kw_only_default=True, field_specifiers=(Field,))
+class ModelMetaclass(ABCMeta):
+    @no_type_check  # noqa C901
+    def __new__(mcs, name, bases, namespace, **kwargs):  # noqa C901
+        fields: Dict[str, ModelField] = {}
+        config = BaseConfig
+        validators: 'ValidatorListDict' = {}
+
+        pre_root_validators, post_root_validators = [], []
+        private_attributes: Dict[str, ModelPrivateAttr] = {}
+        base_private_attributes: Dict[str, ModelPrivateAttr] = {}
+        slots: SetStr = namespace.get('__slots__', ())
+        slots = {slots} if isinstance(slots, str) else set(slots)
+        class_vars: SetStr = set()
+        hash_func: Optional[Callable[[Any], int]] = None
+
+        for base in reversed(bases):
+            if _is_base_model_class_defined and issubclass(base, BaseModel) and base != BaseModel:
+                fields.update(smart_deepcopy(base.__fields__))
+                config = inherit_config(base.__config__, config)
+                validators = inherit_validators(base.__validators__, validators)
+                pre_root_validators += base.__pre_root_validators__
+                post_root_validators += base.__post_root_validators__
+                base_private_attributes.update(base.__private_attributes__)
+                class_vars.update(base.__class_vars__)
+                hash_func = base.__hash__
+
+        resolve_forward_refs = kwargs.pop('__resolve_forward_refs__', True)
+        allowed_config_kwargs: SetStr = {
+            key
+            for key in dir(config)
+            if not (key.startswith('__') and key.endswith('__'))  # skip dunder methods and attributes
+        }
+        config_kwargs = {key: kwargs.pop(key) for key in kwargs.keys() & allowed_config_kwargs}
+        config_from_namespace = namespace.get('Config')
+        if config_kwargs and config_from_namespace:
+            raise TypeError('Specifying config in two places is ambiguous, use either Config attribute or class kwargs')
+        config = inherit_config(config_from_namespace, config, **config_kwargs)
+
+        validators = inherit_validators(extract_validators(namespace), validators)
+        vg = ValidatorGroup(validators)
+
+        for f in fields.values():
+            f.set_config(config)
+            extra_validators = vg.get_validators(f.name)
+            if extra_validators:
+                f.class_validators.update(extra_validators)
+                # re-run prepare to add extra validators
+                f.populate_validators()
+
+        prepare_config(config, name)
+
+        untouched_types = ANNOTATED_FIELD_UNTOUCHED_TYPES
+
+        def is_untouched(v: Any) -> bool:
+            return isinstance(v, untouched_types) or v.__class__.__name__ == 'cython_function_or_method'
+
+        if (namespace.get('__module__'), namespace.get('__qualname__')) != ('pydantic.main', 'BaseModel'):
+            annotations = resolve_annotations(namespace.get('__annotations__', {}), namespace.get('__module__', None))
+            # annotation only fields need to come first in fields
+            for ann_name, ann_type in annotations.items():
+                if is_classvar(ann_type):
+                    class_vars.add(ann_name)
+                elif is_finalvar_with_default_val(ann_type, namespace.get(ann_name, Undefined)):
+                    class_vars.add(ann_name)
+                elif is_valid_field(ann_name):
+                    validate_field_name(bases, ann_name)
+                    value = namespace.get(ann_name, Undefined)
+                    allowed_types = get_args(ann_type) if is_union(get_origin(ann_type)) else (ann_type,)
+                    if (
+                        is_untouched(value)
+                        and ann_type != PyObject
+                        and not any(
+                            lenient_issubclass(get_origin(allowed_type), Type) for allowed_type in allowed_types
+                        )
+                    ):
+                        continue
+                    fields[ann_name] = ModelField.infer(
+                        name=ann_name,
+                        value=value,
+                        annotation=ann_type,
+                        class_validators=vg.get_validators(ann_name),
+                        config=config,
+                    )
+                elif ann_name not in namespace and config.underscore_attrs_are_private:
+                    private_attributes[ann_name] = PrivateAttr()
+
+            untouched_types = UNTOUCHED_TYPES + config.keep_untouched
+            for var_name, value in namespace.items():
+                can_be_changed = var_name not in class_vars and not is_untouched(value)
+                if isinstance(value, ModelPrivateAttr):
+                    if not is_valid_private_name(var_name):
+                        raise NameError(
+                            f'Private attributes "{var_name}" must not be a valid field name; '
+                            f'Use sunder or dunder names, e. g. "_{var_name}" or "__{var_name}__"'
+                        )
+                    private_attributes[var_name] = value
+                elif config.underscore_attrs_are_private and is_valid_private_name(var_name) and can_be_changed:
+                    private_attributes[var_name] = PrivateAttr(default=value)
+                elif is_valid_field(var_name) and var_name not in annotations and can_be_changed:
+                    validate_field_name(bases, var_name)
+                    inferred = ModelField.infer(
+                        name=var_name,
+                        value=value,
+                        annotation=annotations.get(var_name, Undefined),
+                        class_validators=vg.get_validators(var_name),
+                        config=config,
+                    )
+                    if var_name in fields:
+                        if lenient_issubclass(inferred.type_, fields[var_name].type_):
+                            inferred.type_ = fields[var_name].type_
+                        else:
+                            raise TypeError(
+                                f'The type of {name}.{var_name} differs from the new default value; '
+                                f'if you wish to change the type of this field, please use a type annotation'
+                            )
+                    fields[var_name] = inferred
+
+        _custom_root_type = ROOT_KEY in fields
+        if _custom_root_type:
+            validate_custom_root_type(fields)
+        vg.check_for_unused()
+        if config.json_encoders:
+            json_encoder = partial(custom_pydantic_encoder, config.json_encoders)
+        else:
+            json_encoder = pydantic_encoder
+        pre_rv_new, post_rv_new = extract_root_validators(namespace)
+
+        if hash_func is None:
+            hash_func = generate_hash_function(config.frozen)
+
+        exclude_from_namespace = fields | private_attributes.keys() | {'__slots__'}
+        new_namespace = {
+            '__config__': config,
+            '__fields__': fields,
+            '__exclude_fields__': {
+                name: field.field_info.exclude for name, field in fields.items() if field.field_info.exclude is not None
+            }
+            or None,
+            '__include_fields__': {
+                name: field.field_info.include for name, field in fields.items() if field.field_info.include is not None
+            }
+            or None,
+            '__validators__': vg.validators,
+            '__pre_root_validators__': unique_list(
+                pre_root_validators + pre_rv_new,
+                name_factory=lambda v: v.__name__,
+            ),
+            '__post_root_validators__': unique_list(
+                post_root_validators + post_rv_new,
+                name_factory=lambda skip_on_failure_and_v: skip_on_failure_and_v[1].__name__,
+            ),
+            '__schema_cache__': {},
+            '__json_encoder__': staticmethod(json_encoder),
+            '__custom_root_type__': _custom_root_type,
+            '__private_attributes__': {**base_private_attributes, **private_attributes},
+            '__slots__': slots | private_attributes.keys(),
+            '__hash__': hash_func,
+            '__class_vars__': class_vars,
+            **{n: v for n, v in namespace.items() if n not in exclude_from_namespace},
+        }
+
+        cls = super().__new__(mcs, name, bases, new_namespace, **kwargs)
+        # set __signature__ attr only for model class, but not for its instances
+        cls.__signature__ = ClassAttribute('__signature__', generate_model_signature(cls.__init__, fields, config))
+        if resolve_forward_refs:
+            cls.__try_update_forward_refs__()
+
+        # preserve `__set_name__` protocol defined in https://peps.python.org/pep-0487
+        # for attributes not in `new_namespace` (e.g. private attributes)
+        for name, obj in namespace.items():
+            if name not in new_namespace:
+                set_name = getattr(obj, '__set_name__', None)
+                if callable(set_name):
+                    set_name(cls, name)
+
+        return cls
+
+    def __instancecheck__(self, instance: Any) -> bool:
+        """
+        Avoid calling ABC _abc_subclasscheck unless we're pretty sure.
+
+        See #3829 and python/cpython#92810
+        """
+        return hasattr(instance, '__fields__') and super().__instancecheck__(instance)
+
+
+object_setattr = object.__setattr__
+
+
+class BaseModel(Representation, metaclass=ModelMetaclass):
+    if TYPE_CHECKING:
+        # populated by the metaclass, defined here to help IDEs only
+        __fields__: ClassVar[Dict[str, ModelField]] = {}
+        __include_fields__: ClassVar[Optional[Mapping[str, Any]]] = None
+        __exclude_fields__: ClassVar[Optional[Mapping[str, Any]]] = None
+        __validators__: ClassVar[Dict[str, AnyCallable]] = {}
+        __pre_root_validators__: ClassVar[List[AnyCallable]]
+        __post_root_validators__: ClassVar[List[Tuple[bool, AnyCallable]]]
+        __config__: ClassVar[Type[BaseConfig]] = BaseConfig
+        __json_encoder__: ClassVar[Callable[[Any], Any]] = lambda x: x
+        __schema_cache__: ClassVar['DictAny'] = {}
+        __custom_root_type__: ClassVar[bool] = False
+        __signature__: ClassVar['Signature']
+        __private_attributes__: ClassVar[Dict[str, ModelPrivateAttr]]
+        __class_vars__: ClassVar[SetStr]
+        __fields_set__: ClassVar[SetStr] = set()
+
+    Config = BaseConfig
+    __slots__ = ('__dict__', '__fields_set__')
+    __doc__ = ''  # Null out the Representation docstring
+
+    def __init__(__pydantic_self__, **data: Any) -> None:
+        """
+        Create a new model by parsing and validating input data from keyword arguments.
+
+        Raises ValidationError if the input data cannot be parsed to form a valid model.
+        """
+        # Uses something other than `self` the first arg to allow "self" as a settable attribute
+        values, fields_set, validation_error = validate_model(__pydantic_self__.__class__, data)
+        if validation_error:
+            raise validation_error
+        try:
+            object_setattr(__pydantic_self__, '__dict__', values)
+        except TypeError as e:
+            raise TypeError(
+                'Model values must be a dict; you may not have returned a dictionary from a root validator'
+            ) from e
+        object_setattr(__pydantic_self__, '__fields_set__', fields_set)
+        __pydantic_self__._init_private_attributes()
+
+    @no_type_check
+    def __setattr__(self, name, value):  # noqa: C901 (ignore complexity)
+        if name in self.__private_attributes__ or name in DUNDER_ATTRIBUTES:
+            return object_setattr(self, name, value)
+
+        if self.__config__.extra is not Extra.allow and name not in self.__fields__:
+            raise ValueError(f'"{self.__class__.__name__}" object has no field "{name}"')
+        elif not self.__config__.allow_mutation or self.__config__.frozen:
+            raise TypeError(f'"{self.__class__.__name__}" is immutable and does not support item assignment')
+        elif name in self.__fields__ and self.__fields__[name].final:
+            raise TypeError(
+                f'"{self.__class__.__name__}" object "{name}" field is final and does not support reassignment'
+            )
+        elif self.__config__.validate_assignment:
+            new_values = {**self.__dict__, name: value}
+
+            for validator in self.__pre_root_validators__:
+                try:
+                    new_values = validator(self.__class__, new_values)
+                except (ValueError, TypeError, AssertionError) as exc:
+                    raise ValidationError([ErrorWrapper(exc, loc=ROOT_KEY)], self.__class__)
+
+            known_field = self.__fields__.get(name, None)
+            if known_field:
+                # We want to
+                # - make sure validators are called without the current value for this field inside `values`
+                # - keep other values (e.g. submodels) untouched (using `BaseModel.dict()` will change them into dicts)
+                # - keep the order of the fields
+                if not known_field.field_info.allow_mutation:
+                    raise TypeError(f'"{known_field.name}" has allow_mutation set to False and cannot be assigned')
+                dict_without_original_value = {k: v for k, v in self.__dict__.items() if k != name}
+                value, error_ = known_field.validate(value, dict_without_original_value, loc=name, cls=self.__class__)
+                if error_:
+                    raise ValidationError([error_], self.__class__)
+                else:
+                    new_values[name] = value
+
+            errors = []
+            for skip_on_failure, validator in self.__post_root_validators__:
+                if skip_on_failure and errors:
+                    continue
+                try:
+                    new_values = validator(self.__class__, new_values)
+                except (ValueError, TypeError, AssertionError) as exc:
+                    errors.append(ErrorWrapper(exc, loc=ROOT_KEY))
+            if errors:
+                raise ValidationError(errors, self.__class__)
+
+            # update the whole __dict__ as other values than just `value`
+            # may be changed (e.g. with `root_validator`)
+            object_setattr(self, '__dict__', new_values)
+        else:
+            self.__dict__[name] = value
+
+        self.__fields_set__.add(name)
+
+    def __getstate__(self) -> 'DictAny':
+        private_attrs = ((k, getattr(self, k, Undefined)) for k in self.__private_attributes__)
+        return {
+            '__dict__': self.__dict__,
+            '__fields_set__': self.__fields_set__,
+            '__private_attribute_values__': {k: v for k, v in private_attrs if v is not Undefined},
+        }
+
+    def __setstate__(self, state: 'DictAny') -> None:
+        object_setattr(self, '__dict__', state['__dict__'])
+        object_setattr(self, '__fields_set__', state['__fields_set__'])
+        for name, value in state.get('__private_attribute_values__', {}).items():
+            object_setattr(self, name, value)
+
+    def _init_private_attributes(self) -> None:
+        for name, private_attr in self.__private_attributes__.items():
+            default = private_attr.get_default()
+            if default is not Undefined:
+                object_setattr(self, name, default)
+
+    def dict(
+        self,
+        *,
+        include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
+        exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
+        by_alias: bool = False,
+        skip_defaults: Optional[bool] = None,
+        exclude_unset: bool = False,
+        exclude_defaults: bool = False,
+        exclude_none: bool = False,
+    ) -> 'DictStrAny':
+        """
+        Generate a dictionary representation of the model, optionally specifying which fields to include or exclude.
+
+        """
+        if skip_defaults is not None:
+            warnings.warn(
+                f'{self.__class__.__name__}.dict(): "skip_defaults" is deprecated and replaced by "exclude_unset"',
+                DeprecationWarning,
+            )
+            exclude_unset = skip_defaults
+
+        return dict(
+            self._iter(
+                to_dict=True,
+                by_alias=by_alias,
+                include=include,
+                exclude=exclude,
+                exclude_unset=exclude_unset,
+                exclude_defaults=exclude_defaults,
+                exclude_none=exclude_none,
+            )
+        )
+
+    def json(
+        self,
+        *,
+        include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
+        exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
+        by_alias: bool = False,
+        skip_defaults: Optional[bool] = None,
+        exclude_unset: bool = False,
+        exclude_defaults: bool = False,
+        exclude_none: bool = False,
+        encoder: Optional[Callable[[Any], Any]] = None,
+        models_as_dict: bool = True,
+        **dumps_kwargs: Any,
+    ) -> str:
+        """
+        Generate a JSON representation of the model, `include` and `exclude` arguments as per `dict()`.
+
+        `encoder` is an optional function to supply as `default` to json.dumps(), other arguments as per `json.dumps()`.
+        """
+        if skip_defaults is not None:
+            warnings.warn(
+                f'{self.__class__.__name__}.json(): "skip_defaults" is deprecated and replaced by "exclude_unset"',
+                DeprecationWarning,
+            )
+            exclude_unset = skip_defaults
+        encoder = cast(Callable[[Any], Any], encoder or self.__json_encoder__)
+
+        # We don't directly call `self.dict()`, which does exactly this with `to_dict=True`
+        # because we want to be able to keep raw `BaseModel` instances and not as `dict`.
+        # This allows users to write custom JSON encoders for given `BaseModel` classes.
+        data = dict(
+            self._iter(
+                to_dict=models_as_dict,
+                by_alias=by_alias,
+                include=include,
+                exclude=exclude,
+                exclude_unset=exclude_unset,
+                exclude_defaults=exclude_defaults,
+                exclude_none=exclude_none,
+            )
+        )
+        if self.__custom_root_type__:
+            data = data[ROOT_KEY]
+        return self.__config__.json_dumps(data, default=encoder, **dumps_kwargs)
+
+    @classmethod
+    def _enforce_dict_if_root(cls, obj: Any) -> Any:
+        if cls.__custom_root_type__ and (
+            not (isinstance(obj, dict) and obj.keys() == {ROOT_KEY})
+            and not (isinstance(obj, BaseModel) and obj.__fields__.keys() == {ROOT_KEY})
+            or cls.__fields__[ROOT_KEY].shape in MAPPING_LIKE_SHAPES
+        ):
+            return {ROOT_KEY: obj}
+        else:
+            return obj
+
+    @classmethod
+    def parse_obj(cls: Type['Model'], obj: Any) -> 'Model':
+        obj = cls._enforce_dict_if_root(obj)
+        if not isinstance(obj, dict):
+            try:
+                obj = dict(obj)
+            except (TypeError, ValueError) as e:
+                exc = TypeError(f'{cls.__name__} expected dict not {obj.__class__.__name__}')
+                raise ValidationError([ErrorWrapper(exc, loc=ROOT_KEY)], cls) from e
+        return cls(**obj)
+
+    @classmethod
+    def parse_raw(
+        cls: Type['Model'],
+        b: StrBytes,
+        *,
+        content_type: str = None,
+        encoding: str = 'utf8',
+        proto: Protocol = None,
+        allow_pickle: bool = False,
+    ) -> 'Model':
+        try:
+            obj = load_str_bytes(
+                b,
+                proto=proto,
+                content_type=content_type,
+                encoding=encoding,
+                allow_pickle=allow_pickle,
+                json_loads=cls.__config__.json_loads,
+            )
+        except (ValueError, TypeError, UnicodeDecodeError) as e:
+            raise ValidationError([ErrorWrapper(e, loc=ROOT_KEY)], cls)
+        return cls.parse_obj(obj)
+
+    @classmethod
+    def parse_file(
+        cls: Type['Model'],
+        path: Union[str, Path],
+        *,
+        content_type: str = None,
+        encoding: str = 'utf8',
+        proto: Protocol = None,
+        allow_pickle: bool = False,
+    ) -> 'Model':
+        obj = load_file(
+            path,
+            proto=proto,
+            content_type=content_type,
+            encoding=encoding,
+            allow_pickle=allow_pickle,
+            json_loads=cls.__config__.json_loads,
+        )
+        return cls.parse_obj(obj)
+
+    @classmethod
+    def from_orm(cls: Type['Model'], obj: Any) -> 'Model':
+        if not cls.__config__.orm_mode:
+            raise ConfigError('You must have the config attribute orm_mode=True to use from_orm')
+        obj = {ROOT_KEY: obj} if cls.__custom_root_type__ else cls._decompose_class(obj)
+        m = cls.__new__(cls)
+        values, fields_set, validation_error = validate_model(cls, obj)
+        if validation_error:
+            raise validation_error
+        object_setattr(m, '__dict__', values)
+        object_setattr(m, '__fields_set__', fields_set)
+        m._init_private_attributes()
+        return m
+
+    @classmethod
+    def construct(cls: Type['Model'], _fields_set: Optional['SetStr'] = None, **values: Any) -> 'Model':
+        """
+        Creates a new model setting __dict__ and __fields_set__ from trusted or pre-validated data.
+        Default values are respected, but no other validation is performed.
+        Behaves as if `Config.extra = 'allow'` was set since it adds all passed values
+        """
+        m = cls.__new__(cls)
+        fields_values: Dict[str, Any] = {}
+        for name, field in cls.__fields__.items():
+            if field.alt_alias and field.alias in values:
+                fields_values[name] = values[field.alias]
+            elif name in values:
+                fields_values[name] = values[name]
+            elif not field.required:
+                fields_values[name] = field.get_default()
+        fields_values.update(values)
+        object_setattr(m, '__dict__', fields_values)
+        if _fields_set is None:
+            _fields_set = set(values.keys())
+        object_setattr(m, '__fields_set__', _fields_set)
+        m._init_private_attributes()
+        return m
+
+    def _copy_and_set_values(self: 'Model', values: 'DictStrAny', fields_set: 'SetStr', *, deep: bool) -> 'Model':
+        if deep:
+            # chances of having empty dict here are quite low for using smart_deepcopy
+            values = deepcopy(values)
+
+        cls = self.__class__
+        m = cls.__new__(cls)
+        object_setattr(m, '__dict__', values)
+        object_setattr(m, '__fields_set__', fields_set)
+        for name in self.__private_attributes__:
+            value = getattr(self, name, Undefined)
+            if value is not Undefined:
+                if deep:
+                    value = deepcopy(value)
+                object_setattr(m, name, value)
+
+        return m
+
+    def copy(
+        self: 'Model',
+        *,
+        include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
+        exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
+        update: Optional['DictStrAny'] = None,
+        deep: bool = False,
+    ) -> 'Model':
+        """
+        Duplicate a model, optionally choose which fields to include, exclude and change.
+
+        :param include: fields to include in new model
+        :param exclude: fields to exclude from new model, as with values this takes precedence over include
+        :param update: values to change/add in the new model. Note: the data is not validated before creating
+            the new model: you should trust this data
+        :param deep: set to `True` to make a deep copy of the model
+        :return: new model instance
+        """
+
+        values = dict(
+            self._iter(to_dict=False, by_alias=False, include=include, exclude=exclude, exclude_unset=False),
+            **(update or {}),
+        )
+
+        # new `__fields_set__` can have unset optional fields with a set value in `update` kwarg
+        if update:
+            fields_set = self.__fields_set__ | update.keys()
+        else:
+            fields_set = set(self.__fields_set__)
+
+        return self._copy_and_set_values(values, fields_set, deep=deep)
+
+    @classmethod
+    def schema(cls, by_alias: bool = True, ref_template: str = default_ref_template) -> 'DictStrAny':
+        cached = cls.__schema_cache__.get((by_alias, ref_template))
+        if cached is not None:
+            return cached
+        s = model_schema(cls, by_alias=by_alias, ref_template=ref_template)
+        cls.__schema_cache__[(by_alias, ref_template)] = s
+        return s
+
+    @classmethod
+    def schema_json(
+        cls, *, by_alias: bool = True, ref_template: str = default_ref_template, **dumps_kwargs: Any
+    ) -> str:
+        from .json import pydantic_encoder
+
+        return cls.__config__.json_dumps(
+            cls.schema(by_alias=by_alias, ref_template=ref_template), default=pydantic_encoder, **dumps_kwargs
+        )
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield cls.validate
+
+    @classmethod
+    def validate(cls: Type['Model'], value: Any) -> 'Model':
+        if isinstance(value, cls):
+            copy_on_model_validation = cls.__config__.copy_on_model_validation
+            # whether to deep or shallow copy the model on validation, None means do not copy
+            deep_copy: Optional[bool] = None
+            if copy_on_model_validation not in {'deep', 'shallow', 'none'}:
+                # Warn about deprecated behavior
+                warnings.warn(
+                    "`copy_on_model_validation` should be a string: 'deep', 'shallow' or 'none'", DeprecationWarning
+                )
+                if copy_on_model_validation:
+                    deep_copy = False
+
+            if copy_on_model_validation == 'shallow':
+                # shallow copy
+                deep_copy = False
+            elif copy_on_model_validation == 'deep':
+                # deep copy
+                deep_copy = True
+
+            if deep_copy is None:
+                return value
+            else:
+                return value._copy_and_set_values(value.__dict__, value.__fields_set__, deep=deep_copy)
+
+        value = cls._enforce_dict_if_root(value)
+
+        if isinstance(value, dict):
+            return cls(**value)
+        elif cls.__config__.orm_mode:
+            return cls.from_orm(value)
+        else:
+            try:
+                value_as_dict = dict(value)
+            except (TypeError, ValueError) as e:
+                raise DictError() from e
+            return cls(**value_as_dict)
+
+    @classmethod
+    def _decompose_class(cls: Type['Model'], obj: Any) -> GetterDict:
+        if isinstance(obj, GetterDict):
+            return obj
+        return cls.__config__.getter_dict(obj)
+
+    @classmethod
+    @no_type_check
+    def _get_value(
+        cls,
+        v: Any,
+        to_dict: bool,
+        by_alias: bool,
+        include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']],
+        exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']],
+        exclude_unset: bool,
+        exclude_defaults: bool,
+        exclude_none: bool,
+    ) -> Any:
+        if isinstance(v, BaseModel):
+            if to_dict:
+                v_dict = v.dict(
+                    by_alias=by_alias,
+                    exclude_unset=exclude_unset,
+                    exclude_defaults=exclude_defaults,
+                    include=include,
+                    exclude=exclude,
+                    exclude_none=exclude_none,
+                )
+                if ROOT_KEY in v_dict:
+                    return v_dict[ROOT_KEY]
+                return v_dict
+            else:
+                return v.copy(include=include, exclude=exclude)
+
+        value_exclude = ValueItems(v, exclude) if exclude else None
+        value_include = ValueItems(v, include) if include else None
+
+        if isinstance(v, dict):
+            return {
+                k_: cls._get_value(
+                    v_,
+                    to_dict=to_dict,
+                    by_alias=by_alias,
+                    exclude_unset=exclude_unset,
+                    exclude_defaults=exclude_defaults,
+                    include=value_include and value_include.for_element(k_),
+                    exclude=value_exclude and value_exclude.for_element(k_),
+                    exclude_none=exclude_none,
+                )
+                for k_, v_ in v.items()
+                if (not value_exclude or not value_exclude.is_excluded(k_))
+                and (not value_include or value_include.is_included(k_))
+            }
+
+        elif sequence_like(v):
+            seq_args = (
+                cls._get_value(
+                    v_,
+                    to_dict=to_dict,
+                    by_alias=by_alias,
+                    exclude_unset=exclude_unset,
+                    exclude_defaults=exclude_defaults,
+                    include=value_include and value_include.for_element(i),
+                    exclude=value_exclude and value_exclude.for_element(i),
+                    exclude_none=exclude_none,
+                )
+                for i, v_ in enumerate(v)
+                if (not value_exclude or not value_exclude.is_excluded(i))
+                and (not value_include or value_include.is_included(i))
+            )
+
+            return v.__class__(*seq_args) if is_namedtuple(v.__class__) else v.__class__(seq_args)
+
+        elif isinstance(v, Enum) and getattr(cls.Config, 'use_enum_values', False):
+            return v.value
+
+        else:
+            return v
+
+    @classmethod
+    def __try_update_forward_refs__(cls, **localns: Any) -> None:
+        """
+        Same as update_forward_refs but will not raise exception
+        when forward references are not defined.
+        """
+        update_model_forward_refs(cls, cls.__fields__.values(), cls.__config__.json_encoders, localns, (NameError,))
+
+    @classmethod
+    def update_forward_refs(cls, **localns: Any) -> None:
+        """
+        Try to update ForwardRefs on fields based on this Model, globalns and localns.
+        """
+        update_model_forward_refs(cls, cls.__fields__.values(), cls.__config__.json_encoders, localns)
+
+    def __iter__(self) -> 'TupleGenerator':
+        """
+        so `dict(model)` works
+        """
+        yield from self.__dict__.items()
+
+    def _iter(
+        self,
+        to_dict: bool = False,
+        by_alias: bool = False,
+        include: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
+        exclude: Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']] = None,
+        exclude_unset: bool = False,
+        exclude_defaults: bool = False,
+        exclude_none: bool = False,
+    ) -> 'TupleGenerator':
+        # Merge field set excludes with explicit exclude parameter with explicit overriding field set options.
+        # The extra "is not None" guards are not logically necessary but optimizes performance for the simple case.
+        if exclude is not None or self.__exclude_fields__ is not None:
+            exclude = ValueItems.merge(self.__exclude_fields__, exclude)
+
+        if include is not None or self.__include_fields__ is not None:
+            include = ValueItems.merge(self.__include_fields__, include, intersect=True)
+
+        allowed_keys = self._calculate_keys(
+            include=include, exclude=exclude, exclude_unset=exclude_unset  # type: ignore
+        )
+        if allowed_keys is None and not (to_dict or by_alias or exclude_unset or exclude_defaults or exclude_none):
+            # huge boost for plain _iter()
+            yield from self.__dict__.items()
+            return
+
+        value_exclude = ValueItems(self, exclude) if exclude is not None else None
+        value_include = ValueItems(self, include) if include is not None else None
+
+        for field_key, v in self.__dict__.items():
+            if (allowed_keys is not None and field_key not in allowed_keys) or (exclude_none and v is None):
+                continue
+
+            if exclude_defaults:
+                model_field = self.__fields__.get(field_key)
+                if not getattr(model_field, 'required', True) and getattr(model_field, 'default', _missing) == v:
+                    continue
+
+            if by_alias and field_key in self.__fields__:
+                dict_key = self.__fields__[field_key].alias
+            else:
+                dict_key = field_key
+
+            if to_dict or value_include or value_exclude:
+                v = self._get_value(
+                    v,
+                    to_dict=to_dict,
+                    by_alias=by_alias,
+                    include=value_include and value_include.for_element(field_key),
+                    exclude=value_exclude and value_exclude.for_element(field_key),
+                    exclude_unset=exclude_unset,
+                    exclude_defaults=exclude_defaults,
+                    exclude_none=exclude_none,
+                )
+            yield dict_key, v
+
+    def _calculate_keys(
+        self,
+        include: Optional['MappingIntStrAny'],
+        exclude: Optional['MappingIntStrAny'],
+        exclude_unset: bool,
+        update: Optional['DictStrAny'] = None,
+    ) -> Optional[AbstractSet[str]]:
+        if include is None and exclude is None and exclude_unset is False:
+            return None
+
+        keys: AbstractSet[str]
+        if exclude_unset:
+            keys = self.__fields_set__.copy()
+        else:
+            keys = self.__dict__.keys()
+
+        if include is not None:
+            keys &= include.keys()
+
+        if update:
+            keys -= update.keys()
+
+        if exclude:
+            keys -= {k for k, v in exclude.items() if ValueItems.is_true(v)}
+
+        return keys
+
+    def __eq__(self, other: Any) -> bool:
+        if isinstance(other, BaseModel):
+            return self.dict() == other.dict()
+        else:
+            return self.dict() == other
+
+    def __repr_args__(self) -> 'ReprArgs':
+        return [
+            (k, v)
+            for k, v in self.__dict__.items()
+            if k not in DUNDER_ATTRIBUTES and (k not in self.__fields__ or self.__fields__[k].field_info.repr)
+        ]
+
+
+_is_base_model_class_defined = True
+
+
+@overload
+def create_model(
+    __model_name: str,
+    *,
+    __config__: Optional[Type[BaseConfig]] = None,
+    __base__: None = None,
+    __module__: str = __name__,
+    __validators__: Dict[str, 'AnyClassMethod'] = None,
+    __cls_kwargs__: Dict[str, Any] = None,
+    **field_definitions: Any,
+) -> Type['BaseModel']:
+    ...
+
+
+@overload
+def create_model(
+    __model_name: str,
+    *,
+    __config__: Optional[Type[BaseConfig]] = None,
+    __base__: Union[Type['Model'], Tuple[Type['Model'], ...]],
+    __module__: str = __name__,
+    __validators__: Dict[str, 'AnyClassMethod'] = None,
+    __cls_kwargs__: Dict[str, Any] = None,
+    **field_definitions: Any,
+) -> Type['Model']:
+    ...
+
+
+def create_model(
+    __model_name: str,
+    *,
+    __config__: Optional[Type[BaseConfig]] = None,
+    __base__: Union[None, Type['Model'], Tuple[Type['Model'], ...]] = None,
+    __module__: str = __name__,
+    __validators__: Dict[str, 'AnyClassMethod'] = None,
+    __cls_kwargs__: Dict[str, Any] = None,
+    __slots__: Optional[Tuple[str, ...]] = None,
+    **field_definitions: Any,
+) -> Type['Model']:
+    """
+    Dynamically create a model.
+    :param __model_name: name of the created model
+    :param __config__: config class to use for the new model
+    :param __base__: base class for the new model to inherit from
+    :param __module__: module of the created model
+    :param __validators__: a dict of method names and @validator class methods
+    :param __cls_kwargs__: a dict for class creation
+    :param __slots__: Deprecated, `__slots__` should not be passed to `create_model`
+    :param field_definitions: fields of the model (or extra fields if a base is supplied)
+        in the format `<name>=(<type>, <default default>)` or `<name>=<default value>, e.g.
+        `foobar=(str, ...)` or `foobar=123`, or, for complex use-cases, in the format
+        `<name>=<Field>` or `<name>=(<type>, <FieldInfo>)`, e.g.
+        `foo=Field(datetime, default_factory=datetime.utcnow, alias='bar')` or
+        `foo=(str, FieldInfo(title='Foo'))`
+    """
+    if __slots__ is not None:
+        # __slots__ will be ignored from here on
+        warnings.warn('__slots__ should not be passed to create_model', RuntimeWarning)
+
+    if __base__ is not None:
+        if __config__ is not None:
+            raise ConfigError('to avoid confusion __config__ and __base__ cannot be used together')
+        if not isinstance(__base__, tuple):
+            __base__ = (__base__,)
+    else:
+        __base__ = (cast(Type['Model'], BaseModel),)
+
+    __cls_kwargs__ = __cls_kwargs__ or {}
+
+    fields = {}
+    annotations = {}
+
+    for f_name, f_def in field_definitions.items():
+        if not is_valid_field(f_name):
+            warnings.warn(f'fields may not start with an underscore, ignoring "{f_name}"', RuntimeWarning)
+        if isinstance(f_def, tuple):
+            try:
+                f_annotation, f_value = f_def
+            except ValueError as e:
+                raise ConfigError(
+                    'field definitions should either be a tuple of (<type>, <default>) or just a '
+                    'default value, unfortunately this means tuples as '
+                    'default values are not allowed'
+                ) from e
+        else:
+            f_annotation, f_value = None, f_def
+
+        if f_annotation:
+            annotations[f_name] = f_annotation
+        fields[f_name] = f_value
+
+    namespace: 'DictStrAny' = {'__annotations__': annotations, '__module__': __module__}
+    if __validators__:
+        namespace.update(__validators__)
+    namespace.update(fields)
+    if __config__:
+        namespace['Config'] = inherit_config(__config__, BaseConfig)
+    resolved_bases = resolve_bases(__base__)
+    meta, ns, kwds = prepare_class(__model_name, resolved_bases, kwds=__cls_kwargs__)
+    if resolved_bases is not __base__:
+        ns['__orig_bases__'] = __base__
+    namespace.update(ns)
+    return meta(__model_name, resolved_bases, namespace, **kwds)
+
+
+_missing = object()
+
+
+def validate_model(  # noqa: C901 (ignore complexity)
+    model: Type[BaseModel], input_data: 'DictStrAny', cls: 'ModelOrDc' = None
+) -> Tuple['DictStrAny', 'SetStr', Optional[ValidationError]]:
+    """
+    validate data against a model.
+    """
+    values = {}
+    errors = []
+    # input_data names, possibly alias
+    names_used = set()
+    # field names, never aliases
+    fields_set = set()
+    config = model.__config__
+    check_extra = config.extra is not Extra.ignore
+    cls_ = cls or model
+
+    for validator in model.__pre_root_validators__:
+        try:
+            input_data = validator(cls_, input_data)
+        except (ValueError, TypeError, AssertionError) as exc:
+            return {}, set(), ValidationError([ErrorWrapper(exc, loc=ROOT_KEY)], cls_)
+
+    for name, field in model.__fields__.items():
+        value = input_data.get(field.alias, _missing)
+        using_name = False
+        if value is _missing and config.allow_population_by_field_name and field.alt_alias:
+            value = input_data.get(field.name, _missing)
+            using_name = True
+
+        if value is _missing:
+            if field.required:
+                errors.append(ErrorWrapper(MissingError(), loc=field.alias))
+                continue
+
+            value = field.get_default()
+
+            if not config.validate_all and not field.validate_always:
+                values[name] = value
+                continue
+        else:
+            fields_set.add(name)
+            if check_extra:
+                names_used.add(field.name if using_name else field.alias)
+
+        v_, errors_ = field.validate(value, values, loc=field.alias, cls=cls_)
+        if isinstance(errors_, ErrorWrapper):
+            errors.append(errors_)
+        elif isinstance(errors_, list):
+            errors.extend(errors_)
+        else:
+            values[name] = v_
+
+    if check_extra:
+        if isinstance(input_data, GetterDict):
+            extra = input_data.extra_keys() - names_used
+        else:
+            extra = input_data.keys() - names_used
+        if extra:
+            fields_set |= extra
+            if config.extra is Extra.allow:
+                for f in extra:
+                    values[f] = input_data[f]
+            else:
+                for f in sorted(extra):
+                    errors.append(ErrorWrapper(ExtraError(), loc=f))
+
+    for skip_on_failure, validator in model.__post_root_validators__:
+        if skip_on_failure and errors:
+            continue
+        try:
+            values = validator(cls_, values)
+        except (ValueError, TypeError, AssertionError) as exc:
+            errors.append(ErrorWrapper(exc, loc=ROOT_KEY))
+
+    if errors:
+        return values, fields_set, ValidationError(errors, cls_)
+    else:
+        return values, fields_set, None
diff --git a/lib/pydantic/v1/mypy.py b/lib/pydantic/v1/mypy.py
new file mode 100644
index 00000000..1d6d5ae2
--- /dev/null
+++ b/lib/pydantic/v1/mypy.py
@@ -0,0 +1,944 @@
+import sys
+from configparser import ConfigParser
+from typing import Any, Callable, Dict, List, Optional, Set, Tuple, Type as TypingType, Union
+
+from mypy.errorcodes import ErrorCode
+from mypy.nodes import (
+    ARG_NAMED,
+    ARG_NAMED_OPT,
+    ARG_OPT,
+    ARG_POS,
+    ARG_STAR2,
+    MDEF,
+    Argument,
+    AssignmentStmt,
+    Block,
+    CallExpr,
+    ClassDef,
+    Context,
+    Decorator,
+    EllipsisExpr,
+    FuncBase,
+    FuncDef,
+    JsonDict,
+    MemberExpr,
+    NameExpr,
+    PassStmt,
+    PlaceholderNode,
+    RefExpr,
+    StrExpr,
+    SymbolNode,
+    SymbolTableNode,
+    TempNode,
+    TypeInfo,
+    TypeVarExpr,
+    Var,
+)
+from mypy.options import Options
+from mypy.plugin import (
+    CheckerPluginInterface,
+    ClassDefContext,
+    FunctionContext,
+    MethodContext,
+    Plugin,
+    ReportConfigContext,
+    SemanticAnalyzerPluginInterface,
+)
+from mypy.plugins import dataclasses
+from mypy.semanal import set_callable_name  # type: ignore
+from mypy.server.trigger import make_wildcard_trigger
+from mypy.types import (
+    AnyType,
+    CallableType,
+    Instance,
+    NoneType,
+    Overloaded,
+    ProperType,
+    Type,
+    TypeOfAny,
+    TypeType,
+    TypeVarType,
+    UnionType,
+    get_proper_type,
+)
+from mypy.typevars import fill_typevars
+from mypy.util import get_unique_redefinition_name
+from mypy.version import __version__ as mypy_version
+
+from pydantic.utils import is_valid_field
+
+try:
+    from mypy.types import TypeVarDef  # type: ignore[attr-defined]
+except ImportError:  # pragma: no cover
+    # Backward-compatible with TypeVarDef from Mypy 0.910.
+    from mypy.types import TypeVarType as TypeVarDef
+
+CONFIGFILE_KEY = 'pydantic-mypy'
+METADATA_KEY = 'pydantic-mypy-metadata'
+_NAMESPACE = __name__[:-5]  # 'pydantic' in 1.10.X, 'pydantic.v1' in v2.X
+BASEMODEL_FULLNAME = f'{_NAMESPACE}.main.BaseModel'
+BASESETTINGS_FULLNAME = f'{_NAMESPACE}.env_settings.BaseSettings'
+MODEL_METACLASS_FULLNAME = f'{_NAMESPACE}.main.ModelMetaclass'
+FIELD_FULLNAME = f'{_NAMESPACE}.fields.Field'
+DATACLASS_FULLNAME = f'{_NAMESPACE}.dataclasses.dataclass'
+
+
+def parse_mypy_version(version: str) -> Tuple[int, ...]:
+    return tuple(map(int, version.partition('+')[0].split('.')))
+
+
+MYPY_VERSION_TUPLE = parse_mypy_version(mypy_version)
+BUILTINS_NAME = 'builtins' if MYPY_VERSION_TUPLE >= (0, 930) else '__builtins__'
+
+# Increment version if plugin changes and mypy caches should be invalidated
+__version__ = 2
+
+
+def plugin(version: str) -> 'TypingType[Plugin]':
+    """
+    `version` is the mypy version string
+
+    We might want to use this to print a warning if the mypy version being used is
+    newer, or especially older, than we expect (or need).
+    """
+    return PydanticPlugin
+
+
+class PydanticPlugin(Plugin):
+    def __init__(self, options: Options) -> None:
+        self.plugin_config = PydanticPluginConfig(options)
+        self._plugin_data = self.plugin_config.to_data()
+        super().__init__(options)
+
+    def get_base_class_hook(self, fullname: str) -> 'Optional[Callable[[ClassDefContext], None]]':
+        sym = self.lookup_fully_qualified(fullname)
+        if sym and isinstance(sym.node, TypeInfo):  # pragma: no branch
+            # No branching may occur if the mypy cache has not been cleared
+            if any(get_fullname(base) == BASEMODEL_FULLNAME for base in sym.node.mro):
+                return self._pydantic_model_class_maker_callback
+        return None
+
+    def get_metaclass_hook(self, fullname: str) -> Optional[Callable[[ClassDefContext], None]]:
+        if fullname == MODEL_METACLASS_FULLNAME:
+            return self._pydantic_model_metaclass_marker_callback
+        return None
+
+    def get_function_hook(self, fullname: str) -> 'Optional[Callable[[FunctionContext], Type]]':
+        sym = self.lookup_fully_qualified(fullname)
+        if sym and sym.fullname == FIELD_FULLNAME:
+            return self._pydantic_field_callback
+        return None
+
+    def get_method_hook(self, fullname: str) -> Optional[Callable[[MethodContext], Type]]:
+        if fullname.endswith('.from_orm'):
+            return from_orm_callback
+        return None
+
+    def get_class_decorator_hook(self, fullname: str) -> Optional[Callable[[ClassDefContext], None]]:
+        """Mark pydantic.dataclasses as dataclass.
+
+        Mypy version 1.1.1 added support for `@dataclass_transform` decorator.
+        """
+        if fullname == DATACLASS_FULLNAME and MYPY_VERSION_TUPLE < (1, 1):
+            return dataclasses.dataclass_class_maker_callback  # type: ignore[return-value]
+        return None
+
+    def report_config_data(self, ctx: ReportConfigContext) -> Dict[str, Any]:
+        """Return all plugin config data.
+
+        Used by mypy to determine if cache needs to be discarded.
+        """
+        return self._plugin_data
+
+    def _pydantic_model_class_maker_callback(self, ctx: ClassDefContext) -> None:
+        transformer = PydanticModelTransformer(ctx, self.plugin_config)
+        transformer.transform()
+
+    def _pydantic_model_metaclass_marker_callback(self, ctx: ClassDefContext) -> None:
+        """Reset dataclass_transform_spec attribute of ModelMetaclass.
+
+        Let the plugin handle it. This behavior can be disabled
+        if 'debug_dataclass_transform' is set to True', for testing purposes.
+        """
+        if self.plugin_config.debug_dataclass_transform:
+            return
+        info_metaclass = ctx.cls.info.declared_metaclass
+        assert info_metaclass, "callback not passed from 'get_metaclass_hook'"
+        if getattr(info_metaclass.type, 'dataclass_transform_spec', None):
+            info_metaclass.type.dataclass_transform_spec = None  # type: ignore[attr-defined]
+
+    def _pydantic_field_callback(self, ctx: FunctionContext) -> 'Type':
+        """
+        Extract the type of the `default` argument from the Field function, and use it as the return type.
+
+        In particular:
+        * Check whether the default and default_factory argument is specified.
+        * Output an error if both are specified.
+        * Retrieve the type of the argument which is specified, and use it as return type for the function.
+        """
+        default_any_type = ctx.default_return_type
+
+        assert ctx.callee_arg_names[0] == 'default', '"default" is no longer first argument in Field()'
+        assert ctx.callee_arg_names[1] == 'default_factory', '"default_factory" is no longer second argument in Field()'
+        default_args = ctx.args[0]
+        default_factory_args = ctx.args[1]
+
+        if default_args and default_factory_args:
+            error_default_and_default_factory_specified(ctx.api, ctx.context)
+            return default_any_type
+
+        if default_args:
+            default_type = ctx.arg_types[0][0]
+            default_arg = default_args[0]
+
+            # Fallback to default Any type if the field is required
+            if not isinstance(default_arg, EllipsisExpr):
+                return default_type
+
+        elif default_factory_args:
+            default_factory_type = ctx.arg_types[1][0]
+
+            # Functions which use `ParamSpec` can be overloaded, exposing the callable's types as a parameter
+            # Pydantic calls the default factory without any argument, so we retrieve the first item
+            if isinstance(default_factory_type, Overloaded):
+                if MYPY_VERSION_TUPLE > (0, 910):
+                    default_factory_type = default_factory_type.items[0]
+                else:
+                    # Mypy0.910 exposes the items of overloaded types in a function
+                    default_factory_type = default_factory_type.items()[0]  # type: ignore[operator]
+
+            if isinstance(default_factory_type, CallableType):
+                ret_type = default_factory_type.ret_type
+                # mypy doesn't think `ret_type` has `args`, you'd think mypy should know,
+                # add this check in case it varies by version
+                args = getattr(ret_type, 'args', None)
+                if args:
+                    if all(isinstance(arg, TypeVarType) for arg in args):
+                        # Looks like the default factory is a type like `list` or `dict`, replace all args with `Any`
+                        ret_type.args = tuple(default_any_type for _ in args)  # type: ignore[attr-defined]
+                return ret_type
+
+        return default_any_type
+
+
+class PydanticPluginConfig:
+    __slots__ = (
+        'init_forbid_extra',
+        'init_typed',
+        'warn_required_dynamic_aliases',
+        'warn_untyped_fields',
+        'debug_dataclass_transform',
+    )
+    init_forbid_extra: bool
+    init_typed: bool
+    warn_required_dynamic_aliases: bool
+    warn_untyped_fields: bool
+    debug_dataclass_transform: bool  # undocumented
+
+    def __init__(self, options: Options) -> None:
+        if options.config_file is None:  # pragma: no cover
+            return
+
+        toml_config = parse_toml(options.config_file)
+        if toml_config is not None:
+            config = toml_config.get('tool', {}).get('pydantic-mypy', {})
+            for key in self.__slots__:
+                setting = config.get(key, False)
+                if not isinstance(setting, bool):
+                    raise ValueError(f'Configuration value must be a boolean for key: {key}')
+                setattr(self, key, setting)
+        else:
+            plugin_config = ConfigParser()
+            plugin_config.read(options.config_file)
+            for key in self.__slots__:
+                setting = plugin_config.getboolean(CONFIGFILE_KEY, key, fallback=False)
+                setattr(self, key, setting)
+
+    def to_data(self) -> Dict[str, Any]:
+        return {key: getattr(self, key) for key in self.__slots__}
+
+
+def from_orm_callback(ctx: MethodContext) -> Type:
+    """
+    Raise an error if orm_mode is not enabled
+    """
+    model_type: Instance
+    ctx_type = ctx.type
+    if isinstance(ctx_type, TypeType):
+        ctx_type = ctx_type.item
+    if isinstance(ctx_type, CallableType) and isinstance(ctx_type.ret_type, Instance):
+        model_type = ctx_type.ret_type  # called on the class
+    elif isinstance(ctx_type, Instance):
+        model_type = ctx_type  # called on an instance (unusual, but still valid)
+    else:  # pragma: no cover
+        detail = f'ctx.type: {ctx_type} (of type {ctx_type.__class__.__name__})'
+        error_unexpected_behavior(detail, ctx.api, ctx.context)
+        return ctx.default_return_type
+    pydantic_metadata = model_type.type.metadata.get(METADATA_KEY)
+    if pydantic_metadata is None:
+        return ctx.default_return_type
+    orm_mode = pydantic_metadata.get('config', {}).get('orm_mode')
+    if orm_mode is not True:
+        error_from_orm(get_name(model_type.type), ctx.api, ctx.context)
+    return ctx.default_return_type
+
+
+class PydanticModelTransformer:
+    tracked_config_fields: Set[str] = {
+        'extra',
+        'allow_mutation',
+        'frozen',
+        'orm_mode',
+        'allow_population_by_field_name',
+        'alias_generator',
+    }
+
+    def __init__(self, ctx: ClassDefContext, plugin_config: PydanticPluginConfig) -> None:
+        self._ctx = ctx
+        self.plugin_config = plugin_config
+
+    def transform(self) -> None:
+        """
+        Configures the BaseModel subclass according to the plugin settings.
+
+        In particular:
+        * determines the model config and fields,
+        * adds a fields-aware signature for the initializer and construct methods
+        * freezes the class if allow_mutation = False or frozen = True
+        * stores the fields, config, and if the class is settings in the mypy metadata for access by subclasses
+        """
+        ctx = self._ctx
+        info = ctx.cls.info
+
+        self.adjust_validator_signatures()
+        config = self.collect_config()
+        fields = self.collect_fields(config)
+        is_settings = any(get_fullname(base) == BASESETTINGS_FULLNAME for base in info.mro[:-1])
+        self.add_initializer(fields, config, is_settings)
+        self.add_construct_method(fields)
+        self.set_frozen(fields, frozen=config.allow_mutation is False or config.frozen is True)
+        info.metadata[METADATA_KEY] = {
+            'fields': {field.name: field.serialize() for field in fields},
+            'config': config.set_values_dict(),
+        }
+
+    def adjust_validator_signatures(self) -> None:
+        """When we decorate a function `f` with `pydantic.validator(...), mypy sees
+        `f` as a regular method taking a `self` instance, even though pydantic
+        internally wraps `f` with `classmethod` if necessary.
+
+        Teach mypy this by marking any function whose outermost decorator is a
+        `validator()` call as a classmethod.
+        """
+        for name, sym in self._ctx.cls.info.names.items():
+            if isinstance(sym.node, Decorator):
+                first_dec = sym.node.original_decorators[0]
+                if (
+                    isinstance(first_dec, CallExpr)
+                    and isinstance(first_dec.callee, NameExpr)
+                    and first_dec.callee.fullname == f'{_NAMESPACE}.class_validators.validator'
+                ):
+                    sym.node.func.is_class = True
+
+    def collect_config(self) -> 'ModelConfigData':
+        """
+        Collects the values of the config attributes that are used by the plugin, accounting for parent classes.
+        """
+        ctx = self._ctx
+        cls = ctx.cls
+        config = ModelConfigData()
+        for stmt in cls.defs.body:
+            if not isinstance(stmt, ClassDef):
+                continue
+            if stmt.name == 'Config':
+                for substmt in stmt.defs.body:
+                    if not isinstance(substmt, AssignmentStmt):
+                        continue
+                    config.update(self.get_config_update(substmt))
+                if (
+                    config.has_alias_generator
+                    and not config.allow_population_by_field_name
+                    and self.plugin_config.warn_required_dynamic_aliases
+                ):
+                    error_required_dynamic_aliases(ctx.api, stmt)
+        for info in cls.info.mro[1:]:  # 0 is the current class
+            if METADATA_KEY not in info.metadata:
+                continue
+
+            # Each class depends on the set of fields in its ancestors
+            ctx.api.add_plugin_dependency(make_wildcard_trigger(get_fullname(info)))
+            for name, value in info.metadata[METADATA_KEY]['config'].items():
+                config.setdefault(name, value)
+        return config
+
+    def collect_fields(self, model_config: 'ModelConfigData') -> List['PydanticModelField']:
+        """
+        Collects the fields for the model, accounting for parent classes
+        """
+        # First, collect fields belonging to the current class.
+        ctx = self._ctx
+        cls = self._ctx.cls
+        fields = []  # type: List[PydanticModelField]
+        known_fields = set()  # type: Set[str]
+        for stmt in cls.defs.body:
+            if not isinstance(stmt, AssignmentStmt):  # `and stmt.new_syntax` to require annotation
+                continue
+
+            lhs = stmt.lvalues[0]
+            if not isinstance(lhs, NameExpr) or not is_valid_field(lhs.name):
+                continue
+
+            if not stmt.new_syntax and self.plugin_config.warn_untyped_fields:
+                error_untyped_fields(ctx.api, stmt)
+
+            # if lhs.name == '__config__':  # BaseConfig not well handled; I'm not sure why yet
+            #     continue
+
+            sym = cls.info.names.get(lhs.name)
+            if sym is None:  # pragma: no cover
+                # This is likely due to a star import (see the dataclasses plugin for a more detailed explanation)
+                # This is the same logic used in the dataclasses plugin
+                continue
+
+            node = sym.node
+            if isinstance(node, PlaceholderNode):  # pragma: no cover
+                # See the PlaceholderNode docstring for more detail about how this can occur
+                # Basically, it is an edge case when dealing with complex import logic
+                # This is the same logic used in the dataclasses plugin
+                continue
+            if not isinstance(node, Var):  # pragma: no cover
+                # Don't know if this edge case still happens with the `is_valid_field` check above
+                # but better safe than sorry
+                continue
+
+            # x: ClassVar[int] is ignored by dataclasses.
+            if node.is_classvar:
+                continue
+
+            is_required = self.get_is_required(cls, stmt, lhs)
+            alias, has_dynamic_alias = self.get_alias_info(stmt)
+            if (
+                has_dynamic_alias
+                and not model_config.allow_population_by_field_name
+                and self.plugin_config.warn_required_dynamic_aliases
+            ):
+                error_required_dynamic_aliases(ctx.api, stmt)
+            fields.append(
+                PydanticModelField(
+                    name=lhs.name,
+                    is_required=is_required,
+                    alias=alias,
+                    has_dynamic_alias=has_dynamic_alias,
+                    line=stmt.line,
+                    column=stmt.column,
+                )
+            )
+            known_fields.add(lhs.name)
+        all_fields = fields.copy()
+        for info in cls.info.mro[1:]:  # 0 is the current class, -2 is BaseModel, -1 is object
+            if METADATA_KEY not in info.metadata:
+                continue
+
+            superclass_fields = []
+            # Each class depends on the set of fields in its ancestors
+            ctx.api.add_plugin_dependency(make_wildcard_trigger(get_fullname(info)))
+
+            for name, data in info.metadata[METADATA_KEY]['fields'].items():
+                if name not in known_fields:
+                    field = PydanticModelField.deserialize(info, data)
+                    known_fields.add(name)
+                    superclass_fields.append(field)
+                else:
+                    (field,) = (a for a in all_fields if a.name == name)
+                    all_fields.remove(field)
+                    superclass_fields.append(field)
+            all_fields = superclass_fields + all_fields
+        return all_fields
+
+    def add_initializer(self, fields: List['PydanticModelField'], config: 'ModelConfigData', is_settings: bool) -> None:
+        """
+        Adds a fields-aware `__init__` method to the class.
+
+        The added `__init__` will be annotated with types vs. all `Any` depending on the plugin settings.
+        """
+        ctx = self._ctx
+        typed = self.plugin_config.init_typed
+        use_alias = config.allow_population_by_field_name is not True
+        force_all_optional = is_settings or bool(
+            config.has_alias_generator and not config.allow_population_by_field_name
+        )
+        init_arguments = self.get_field_arguments(
+            fields, typed=typed, force_all_optional=force_all_optional, use_alias=use_alias
+        )
+        if not self.should_init_forbid_extra(fields, config):
+            var = Var('kwargs')
+            init_arguments.append(Argument(var, AnyType(TypeOfAny.explicit), None, ARG_STAR2))
+
+        if '__init__' not in ctx.cls.info.names:
+            add_method(ctx, '__init__', init_arguments, NoneType())
+
+    def add_construct_method(self, fields: List['PydanticModelField']) -> None:
+        """
+        Adds a fully typed `construct` classmethod to the class.
+
+        Similar to the fields-aware __init__ method, but always uses the field names (not aliases),
+        and does not treat settings fields as optional.
+        """
+        ctx = self._ctx
+        set_str = ctx.api.named_type(f'{BUILTINS_NAME}.set', [ctx.api.named_type(f'{BUILTINS_NAME}.str')])
+        optional_set_str = UnionType([set_str, NoneType()])
+        fields_set_argument = Argument(Var('_fields_set', optional_set_str), optional_set_str, None, ARG_OPT)
+        construct_arguments = self.get_field_arguments(fields, typed=True, force_all_optional=False, use_alias=False)
+        construct_arguments = [fields_set_argument] + construct_arguments
+
+        obj_type = ctx.api.named_type(f'{BUILTINS_NAME}.object')
+        self_tvar_name = '_PydanticBaseModel'  # Make sure it does not conflict with other names in the class
+        tvar_fullname = ctx.cls.fullname + '.' + self_tvar_name
+        if MYPY_VERSION_TUPLE >= (1, 4):
+            tvd = TypeVarType(
+                self_tvar_name,
+                tvar_fullname,
+                -1,
+                [],
+                obj_type,
+                AnyType(TypeOfAny.from_omitted_generics),  # type: ignore[arg-type]
+            )
+            self_tvar_expr = TypeVarExpr(
+                self_tvar_name,
+                tvar_fullname,
+                [],
+                obj_type,
+                AnyType(TypeOfAny.from_omitted_generics),  # type: ignore[arg-type]
+            )
+        else:
+            tvd = TypeVarDef(self_tvar_name, tvar_fullname, -1, [], obj_type)
+            self_tvar_expr = TypeVarExpr(self_tvar_name, tvar_fullname, [], obj_type)
+        ctx.cls.info.names[self_tvar_name] = SymbolTableNode(MDEF, self_tvar_expr)
+
+        # Backward-compatible with TypeVarDef from Mypy 0.910.
+        if isinstance(tvd, TypeVarType):
+            self_type = tvd
+        else:
+            self_type = TypeVarType(tvd)
+
+        add_method(
+            ctx,
+            'construct',
+            construct_arguments,
+            return_type=self_type,
+            self_type=self_type,
+            tvar_def=tvd,
+            is_classmethod=True,
+        )
+
+    def set_frozen(self, fields: List['PydanticModelField'], frozen: bool) -> None:
+        """
+        Marks all fields as properties so that attempts to set them trigger mypy errors.
+
+        This is the same approach used by the attrs and dataclasses plugins.
+        """
+        ctx = self._ctx
+        info = ctx.cls.info
+        for field in fields:
+            sym_node = info.names.get(field.name)
+            if sym_node is not None:
+                var = sym_node.node
+                if isinstance(var, Var):
+                    var.is_property = frozen
+                elif isinstance(var, PlaceholderNode) and not ctx.api.final_iteration:
+                    # See https://github.com/pydantic/pydantic/issues/5191 to hit this branch for test coverage
+                    ctx.api.defer()
+                else:  # pragma: no cover
+                    # I don't know whether it's possible to hit this branch, but I've added it for safety
+                    try:
+                        var_str = str(var)
+                    except TypeError:
+                        # This happens for PlaceholderNode; perhaps it will happen for other types in the future..
+                        var_str = repr(var)
+                    detail = f'sym_node.node: {var_str} (of type {var.__class__})'
+                    error_unexpected_behavior(detail, ctx.api, ctx.cls)
+            else:
+                var = field.to_var(info, use_alias=False)
+                var.info = info
+                var.is_property = frozen
+                var._fullname = get_fullname(info) + '.' + get_name(var)
+                info.names[get_name(var)] = SymbolTableNode(MDEF, var)
+
+    def get_config_update(self, substmt: AssignmentStmt) -> Optional['ModelConfigData']:
+        """
+        Determines the config update due to a single statement in the Config class definition.
+
+        Warns if a tracked config attribute is set to a value the plugin doesn't know how to interpret (e.g., an int)
+        """
+        lhs = substmt.lvalues[0]
+        if not (isinstance(lhs, NameExpr) and lhs.name in self.tracked_config_fields):
+            return None
+        if lhs.name == 'extra':
+            if isinstance(substmt.rvalue, StrExpr):
+                forbid_extra = substmt.rvalue.value == 'forbid'
+            elif isinstance(substmt.rvalue, MemberExpr):
+                forbid_extra = substmt.rvalue.name == 'forbid'
+            else:
+                error_invalid_config_value(lhs.name, self._ctx.api, substmt)
+                return None
+            return ModelConfigData(forbid_extra=forbid_extra)
+        if lhs.name == 'alias_generator':
+            has_alias_generator = True
+            if isinstance(substmt.rvalue, NameExpr) and substmt.rvalue.fullname == 'builtins.None':
+                has_alias_generator = False
+            return ModelConfigData(has_alias_generator=has_alias_generator)
+        if isinstance(substmt.rvalue, NameExpr) and substmt.rvalue.fullname in ('builtins.True', 'builtins.False'):
+            return ModelConfigData(**{lhs.name: substmt.rvalue.fullname == 'builtins.True'})
+        error_invalid_config_value(lhs.name, self._ctx.api, substmt)
+        return None
+
+    @staticmethod
+    def get_is_required(cls: ClassDef, stmt: AssignmentStmt, lhs: NameExpr) -> bool:
+        """
+        Returns a boolean indicating whether the field defined in `stmt` is a required field.
+        """
+        expr = stmt.rvalue
+        if isinstance(expr, TempNode):
+            # TempNode means annotation-only, so only non-required if Optional
+            value_type = get_proper_type(cls.info[lhs.name].type)
+            return not PydanticModelTransformer.type_has_implicit_default(value_type)
+        if isinstance(expr, CallExpr) and isinstance(expr.callee, RefExpr) and expr.callee.fullname == FIELD_FULLNAME:
+            # The "default value" is a call to `Field`; at this point, the field is
+            # only required if default is Ellipsis (i.e., `field_name: Annotation = Field(...)`) or if default_factory
+            # is specified.
+            for arg, name in zip(expr.args, expr.arg_names):
+                # If name is None, then this arg is the default because it is the only positional argument.
+                if name is None or name == 'default':
+                    return arg.__class__ is EllipsisExpr
+                if name == 'default_factory':
+                    return False
+            # In this case, default and default_factory are not specified, so we need to look at the annotation
+            value_type = get_proper_type(cls.info[lhs.name].type)
+            return not PydanticModelTransformer.type_has_implicit_default(value_type)
+        # Only required if the "default value" is Ellipsis (i.e., `field_name: Annotation = ...`)
+        return isinstance(expr, EllipsisExpr)
+
+    @staticmethod
+    def type_has_implicit_default(type_: Optional[ProperType]) -> bool:
+        """
+        Returns True if the passed type will be given an implicit default value.
+
+        In pydantic v1, this is the case for Optional types and Any (with default value None).
+        """
+        if isinstance(type_, AnyType):
+            # Annotated as Any
+            return True
+        if isinstance(type_, UnionType) and any(
+            isinstance(item, NoneType) or isinstance(item, AnyType) for item in type_.items
+        ):
+            # Annotated as Optional, or otherwise having NoneType or AnyType in the union
+            return True
+        return False
+
+    @staticmethod
+    def get_alias_info(stmt: AssignmentStmt) -> Tuple[Optional[str], bool]:
+        """
+        Returns a pair (alias, has_dynamic_alias), extracted from the declaration of the field defined in `stmt`.
+
+        `has_dynamic_alias` is True if and only if an alias is provided, but not as a string literal.
+        If `has_dynamic_alias` is True, `alias` will be None.
+        """
+        expr = stmt.rvalue
+        if isinstance(expr, TempNode):
+            # TempNode means annotation-only
+            return None, False
+
+        if not (
+            isinstance(expr, CallExpr) and isinstance(expr.callee, RefExpr) and expr.callee.fullname == FIELD_FULLNAME
+        ):
+            # Assigned value is not a call to pydantic.fields.Field
+            return None, False
+
+        for i, arg_name in enumerate(expr.arg_names):
+            if arg_name != 'alias':
+                continue
+            arg = expr.args[i]
+            if isinstance(arg, StrExpr):
+                return arg.value, False
+            else:
+                return None, True
+        return None, False
+
+    def get_field_arguments(
+        self, fields: List['PydanticModelField'], typed: bool, force_all_optional: bool, use_alias: bool
+    ) -> List[Argument]:
+        """
+        Helper function used during the construction of the `__init__` and `construct` method signatures.
+
+        Returns a list of mypy Argument instances for use in the generated signatures.
+        """
+        info = self._ctx.cls.info
+        arguments = [
+            field.to_argument(info, typed=typed, force_optional=force_all_optional, use_alias=use_alias)
+            for field in fields
+            if not (use_alias and field.has_dynamic_alias)
+        ]
+        return arguments
+
+    def should_init_forbid_extra(self, fields: List['PydanticModelField'], config: 'ModelConfigData') -> bool:
+        """
+        Indicates whether the generated `__init__` should get a `**kwargs` at the end of its signature
+
+        We disallow arbitrary kwargs if the extra config setting is "forbid", or if the plugin config says to,
+        *unless* a required dynamic alias is present (since then we can't determine a valid signature).
+        """
+        if not config.allow_population_by_field_name:
+            if self.is_dynamic_alias_present(fields, bool(config.has_alias_generator)):
+                return False
+        if config.forbid_extra:
+            return True
+        return self.plugin_config.init_forbid_extra
+
+    @staticmethod
+    def is_dynamic_alias_present(fields: List['PydanticModelField'], has_alias_generator: bool) -> bool:
+        """
+        Returns whether any fields on the model have a "dynamic alias", i.e., an alias that cannot be
+        determined during static analysis.
+        """
+        for field in fields:
+            if field.has_dynamic_alias:
+                return True
+        if has_alias_generator:
+            for field in fields:
+                if field.alias is None:
+                    return True
+        return False
+
+
+class PydanticModelField:
+    def __init__(
+        self, name: str, is_required: bool, alias: Optional[str], has_dynamic_alias: bool, line: int, column: int
+    ):
+        self.name = name
+        self.is_required = is_required
+        self.alias = alias
+        self.has_dynamic_alias = has_dynamic_alias
+        self.line = line
+        self.column = column
+
+    def to_var(self, info: TypeInfo, use_alias: bool) -> Var:
+        name = self.name
+        if use_alias and self.alias is not None:
+            name = self.alias
+        return Var(name, info[self.name].type)
+
+    def to_argument(self, info: TypeInfo, typed: bool, force_optional: bool, use_alias: bool) -> Argument:
+        if typed and info[self.name].type is not None:
+            type_annotation = info[self.name].type
+        else:
+            type_annotation = AnyType(TypeOfAny.explicit)
+        return Argument(
+            variable=self.to_var(info, use_alias),
+            type_annotation=type_annotation,
+            initializer=None,
+            kind=ARG_NAMED_OPT if force_optional or not self.is_required else ARG_NAMED,
+        )
+
+    def serialize(self) -> JsonDict:
+        return self.__dict__
+
+    @classmethod
+    def deserialize(cls, info: TypeInfo, data: JsonDict) -> 'PydanticModelField':
+        return cls(**data)
+
+
+class ModelConfigData:
+    def __init__(
+        self,
+        forbid_extra: Optional[bool] = None,
+        allow_mutation: Optional[bool] = None,
+        frozen: Optional[bool] = None,
+        orm_mode: Optional[bool] = None,
+        allow_population_by_field_name: Optional[bool] = None,
+        has_alias_generator: Optional[bool] = None,
+    ):
+        self.forbid_extra = forbid_extra
+        self.allow_mutation = allow_mutation
+        self.frozen = frozen
+        self.orm_mode = orm_mode
+        self.allow_population_by_field_name = allow_population_by_field_name
+        self.has_alias_generator = has_alias_generator
+
+    def set_values_dict(self) -> Dict[str, Any]:
+        return {k: v for k, v in self.__dict__.items() if v is not None}
+
+    def update(self, config: Optional['ModelConfigData']) -> None:
+        if config is None:
+            return
+        for k, v in config.set_values_dict().items():
+            setattr(self, k, v)
+
+    def setdefault(self, key: str, value: Any) -> None:
+        if getattr(self, key) is None:
+            setattr(self, key, value)
+
+
+ERROR_ORM = ErrorCode('pydantic-orm', 'Invalid from_orm call', 'Pydantic')
+ERROR_CONFIG = ErrorCode('pydantic-config', 'Invalid config value', 'Pydantic')
+ERROR_ALIAS = ErrorCode('pydantic-alias', 'Dynamic alias disallowed', 'Pydantic')
+ERROR_UNEXPECTED = ErrorCode('pydantic-unexpected', 'Unexpected behavior', 'Pydantic')
+ERROR_UNTYPED = ErrorCode('pydantic-field', 'Untyped field disallowed', 'Pydantic')
+ERROR_FIELD_DEFAULTS = ErrorCode('pydantic-field', 'Invalid Field defaults', 'Pydantic')
+
+
+def error_from_orm(model_name: str, api: CheckerPluginInterface, context: Context) -> None:
+    api.fail(f'"{model_name}" does not have orm_mode=True', context, code=ERROR_ORM)
+
+
+def error_invalid_config_value(name: str, api: SemanticAnalyzerPluginInterface, context: Context) -> None:
+    api.fail(f'Invalid value for "Config.{name}"', context, code=ERROR_CONFIG)
+
+
+def error_required_dynamic_aliases(api: SemanticAnalyzerPluginInterface, context: Context) -> None:
+    api.fail('Required dynamic aliases disallowed', context, code=ERROR_ALIAS)
+
+
+def error_unexpected_behavior(
+    detail: str, api: Union[CheckerPluginInterface, SemanticAnalyzerPluginInterface], context: Context
+) -> None:  # pragma: no cover
+    # Can't think of a good way to test this, but I confirmed it renders as desired by adding to a non-error path
+    link = 'https://github.com/pydantic/pydantic/issues/new/choose'
+    full_message = f'The pydantic mypy plugin ran into unexpected behavior: {detail}\n'
+    full_message += f'Please consider reporting this bug at {link} so we can try to fix it!'
+    api.fail(full_message, context, code=ERROR_UNEXPECTED)
+
+
+def error_untyped_fields(api: SemanticAnalyzerPluginInterface, context: Context) -> None:
+    api.fail('Untyped fields disallowed', context, code=ERROR_UNTYPED)
+
+
+def error_default_and_default_factory_specified(api: CheckerPluginInterface, context: Context) -> None:
+    api.fail('Field default and default_factory cannot be specified together', context, code=ERROR_FIELD_DEFAULTS)
+
+
+def add_method(
+    ctx: ClassDefContext,
+    name: str,
+    args: List[Argument],
+    return_type: Type,
+    self_type: Optional[Type] = None,
+    tvar_def: Optional[TypeVarDef] = None,
+    is_classmethod: bool = False,
+    is_new: bool = False,
+    # is_staticmethod: bool = False,
+) -> None:
+    """
+    Adds a new method to a class.
+
+    This can be dropped if/when https://github.com/python/mypy/issues/7301 is merged
+    """
+    info = ctx.cls.info
+
+    # First remove any previously generated methods with the same name
+    # to avoid clashes and problems in the semantic analyzer.
+    if name in info.names:
+        sym = info.names[name]
+        if sym.plugin_generated and isinstance(sym.node, FuncDef):
+            ctx.cls.defs.body.remove(sym.node)  # pragma: no cover
+
+    self_type = self_type or fill_typevars(info)
+    if is_classmethod or is_new:
+        first = [Argument(Var('_cls'), TypeType.make_normalized(self_type), None, ARG_POS)]
+    # elif is_staticmethod:
+    #     first = []
+    else:
+        self_type = self_type or fill_typevars(info)
+        first = [Argument(Var('__pydantic_self__'), self_type, None, ARG_POS)]
+    args = first + args
+    arg_types, arg_names, arg_kinds = [], [], []
+    for arg in args:
+        assert arg.type_annotation, 'All arguments must be fully typed.'
+        arg_types.append(arg.type_annotation)
+        arg_names.append(get_name(arg.variable))
+        arg_kinds.append(arg.kind)
+
+    function_type = ctx.api.named_type(f'{BUILTINS_NAME}.function')
+    signature = CallableType(arg_types, arg_kinds, arg_names, return_type, function_type)
+    if tvar_def:
+        signature.variables = [tvar_def]
+
+    func = FuncDef(name, args, Block([PassStmt()]))
+    func.info = info
+    func.type = set_callable_name(signature, func)
+    func.is_class = is_classmethod
+    # func.is_static = is_staticmethod
+    func._fullname = get_fullname(info) + '.' + name
+    func.line = info.line
+
+    # NOTE: we would like the plugin generated node to dominate, but we still
+    # need to keep any existing definitions so they get semantically analyzed.
+    if name in info.names:
+        # Get a nice unique name instead.
+        r_name = get_unique_redefinition_name(name, info.names)
+        info.names[r_name] = info.names[name]
+
+    if is_classmethod:  # or is_staticmethod:
+        func.is_decorated = True
+        v = Var(name, func.type)
+        v.info = info
+        v._fullname = func._fullname
+        # if is_classmethod:
+        v.is_classmethod = True
+        dec = Decorator(func, [NameExpr('classmethod')], v)
+        # else:
+        #     v.is_staticmethod = True
+        #     dec = Decorator(func, [NameExpr('staticmethod')], v)
+
+        dec.line = info.line
+        sym = SymbolTableNode(MDEF, dec)
+    else:
+        sym = SymbolTableNode(MDEF, func)
+    sym.plugin_generated = True
+
+    info.names[name] = sym
+    info.defn.defs.body.append(func)
+
+
+def get_fullname(x: Union[FuncBase, SymbolNode]) -> str:
+    """
+    Used for compatibility with mypy 0.740; can be dropped once support for 0.740 is dropped.
+    """
+    fn = x.fullname
+    if callable(fn):  # pragma: no cover
+        return fn()
+    return fn
+
+
+def get_name(x: Union[FuncBase, SymbolNode]) -> str:
+    """
+    Used for compatibility with mypy 0.740; can be dropped once support for 0.740 is dropped.
+    """
+    fn = x.name
+    if callable(fn):  # pragma: no cover
+        return fn()
+    return fn
+
+
+def parse_toml(config_file: str) -> Optional[Dict[str, Any]]:
+    if not config_file.endswith('.toml'):
+        return None
+
+    read_mode = 'rb'
+    if sys.version_info >= (3, 11):
+        import tomllib as toml_
+    else:
+        try:
+            import tomli as toml_
+        except ImportError:
+            # older versions of mypy have toml as a dependency, not tomli
+            read_mode = 'r'
+            try:
+                import toml as toml_  # type: ignore[no-redef]
+            except ImportError:  # pragma: no cover
+                import warnings
+
+                warnings.warn('No TOML parser installed, cannot read configuration from `pyproject.toml`.')
+                return None
+
+    with open(config_file, read_mode) as rf:
+        return toml_.load(rf)  # type: ignore[arg-type]
diff --git a/lib/pydantic/v1/networks.py b/lib/pydantic/v1/networks.py
new file mode 100644
index 00000000..cfebe588
--- /dev/null
+++ b/lib/pydantic/v1/networks.py
@@ -0,0 +1,747 @@
+import re
+from ipaddress import (
+    IPv4Address,
+    IPv4Interface,
+    IPv4Network,
+    IPv6Address,
+    IPv6Interface,
+    IPv6Network,
+    _BaseAddress,
+    _BaseNetwork,
+)
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Collection,
+    Dict,
+    Generator,
+    List,
+    Match,
+    Optional,
+    Pattern,
+    Set,
+    Tuple,
+    Type,
+    Union,
+    cast,
+    no_type_check,
+)
+
+from . import errors
+from .utils import Representation, update_not_none
+from .validators import constr_length_validator, str_validator
+
+if TYPE_CHECKING:
+    import email_validator
+    from typing_extensions import TypedDict
+
+    from .config import BaseConfig
+    from .fields import ModelField
+    from .typing import AnyCallable
+
+    CallableGenerator = Generator[AnyCallable, None, None]
+
+    class Parts(TypedDict, total=False):
+        scheme: str
+        user: Optional[str]
+        password: Optional[str]
+        ipv4: Optional[str]
+        ipv6: Optional[str]
+        domain: Optional[str]
+        port: Optional[str]
+        path: Optional[str]
+        query: Optional[str]
+        fragment: Optional[str]
+
+    class HostParts(TypedDict, total=False):
+        host: str
+        tld: Optional[str]
+        host_type: Optional[str]
+        port: Optional[str]
+        rebuild: bool
+
+else:
+    email_validator = None
+
+    class Parts(dict):
+        pass
+
+
+NetworkType = Union[str, bytes, int, Tuple[Union[str, bytes, int], Union[str, int]]]
+
+__all__ = [
+    'AnyUrl',
+    'AnyHttpUrl',
+    'FileUrl',
+    'HttpUrl',
+    'stricturl',
+    'EmailStr',
+    'NameEmail',
+    'IPvAnyAddress',
+    'IPvAnyInterface',
+    'IPvAnyNetwork',
+    'PostgresDsn',
+    'CockroachDsn',
+    'AmqpDsn',
+    'RedisDsn',
+    'MongoDsn',
+    'KafkaDsn',
+    'validate_email',
+]
+
+_url_regex_cache = None
+_multi_host_url_regex_cache = None
+_ascii_domain_regex_cache = None
+_int_domain_regex_cache = None
+_host_regex_cache = None
+
+_host_regex = (
+    r'(?:'
+    r'(?P<ipv4>(?:\d{1,3}\.){3}\d{1,3})(?=$|[/:#?])|'  # ipv4
+    r'(?P<ipv6>\[[A-F0-9]*:[A-F0-9:]+\])(?=$|[/:#?])|'  # ipv6
+    r'(?P<domain>[^\s/:?#]+)'  # domain, validation occurs later
+    r')?'
+    r'(?::(?P<port>\d+))?'  # port
+)
+_scheme_regex = r'(?:(?P<scheme>[a-z][a-z0-9+\-.]+)://)?'  # scheme https://tools.ietf.org/html/rfc3986#appendix-A
+_user_info_regex = r'(?:(?P<user>[^\s:/]*)(?::(?P<password>[^\s/]*))?@)?'
+_path_regex = r'(?P<path>/[^\s?#]*)?'
+_query_regex = r'(?:\?(?P<query>[^\s#]*))?'
+_fragment_regex = r'(?:#(?P<fragment>[^\s#]*))?'
+
+
+def url_regex() -> Pattern[str]:
+    global _url_regex_cache
+    if _url_regex_cache is None:
+        _url_regex_cache = re.compile(
+            rf'{_scheme_regex}{_user_info_regex}{_host_regex}{_path_regex}{_query_regex}{_fragment_regex}',
+            re.IGNORECASE,
+        )
+    return _url_regex_cache
+
+
+def multi_host_url_regex() -> Pattern[str]:
+    """
+    Compiled multi host url regex.
+
+    Additionally to `url_regex` it allows to match multiple hosts.
+    E.g. host1.db.net,host2.db.net
+    """
+    global _multi_host_url_regex_cache
+    if _multi_host_url_regex_cache is None:
+        _multi_host_url_regex_cache = re.compile(
+            rf'{_scheme_regex}{_user_info_regex}'
+            r'(?P<hosts>([^/]*))'  # validation occurs later
+            rf'{_path_regex}{_query_regex}{_fragment_regex}',
+            re.IGNORECASE,
+        )
+    return _multi_host_url_regex_cache
+
+
+def ascii_domain_regex() -> Pattern[str]:
+    global _ascii_domain_regex_cache
+    if _ascii_domain_regex_cache is None:
+        ascii_chunk = r'[_0-9a-z](?:[-_0-9a-z]{0,61}[_0-9a-z])?'
+        ascii_domain_ending = r'(?P<tld>\.[a-z]{2,63})?\.?'
+        _ascii_domain_regex_cache = re.compile(
+            fr'(?:{ascii_chunk}\.)*?{ascii_chunk}{ascii_domain_ending}', re.IGNORECASE
+        )
+    return _ascii_domain_regex_cache
+
+
+def int_domain_regex() -> Pattern[str]:
+    global _int_domain_regex_cache
+    if _int_domain_regex_cache is None:
+        int_chunk = r'[_0-9a-\U00040000](?:[-_0-9a-\U00040000]{0,61}[_0-9a-\U00040000])?'
+        int_domain_ending = r'(?P<tld>(\.[^\W\d_]{2,63})|(\.(?:xn--)[_0-9a-z-]{2,63}))?\.?'
+        _int_domain_regex_cache = re.compile(fr'(?:{int_chunk}\.)*?{int_chunk}{int_domain_ending}', re.IGNORECASE)
+    return _int_domain_regex_cache
+
+
+def host_regex() -> Pattern[str]:
+    global _host_regex_cache
+    if _host_regex_cache is None:
+        _host_regex_cache = re.compile(
+            _host_regex,
+            re.IGNORECASE,
+        )
+    return _host_regex_cache
+
+
+class AnyUrl(str):
+    strip_whitespace = True
+    min_length = 1
+    max_length = 2**16
+    allowed_schemes: Optional[Collection[str]] = None
+    tld_required: bool = False
+    user_required: bool = False
+    host_required: bool = True
+    hidden_parts: Set[str] = set()
+
+    __slots__ = ('scheme', 'user', 'password', 'host', 'tld', 'host_type', 'port', 'path', 'query', 'fragment')
+
+    @no_type_check
+    def __new__(cls, url: Optional[str], **kwargs) -> object:
+        return str.__new__(cls, cls.build(**kwargs) if url is None else url)
+
+    def __init__(
+        self,
+        url: str,
+        *,
+        scheme: str,
+        user: Optional[str] = None,
+        password: Optional[str] = None,
+        host: Optional[str] = None,
+        tld: Optional[str] = None,
+        host_type: str = 'domain',
+        port: Optional[str] = None,
+        path: Optional[str] = None,
+        query: Optional[str] = None,
+        fragment: Optional[str] = None,
+    ) -> None:
+        str.__init__(url)
+        self.scheme = scheme
+        self.user = user
+        self.password = password
+        self.host = host
+        self.tld = tld
+        self.host_type = host_type
+        self.port = port
+        self.path = path
+        self.query = query
+        self.fragment = fragment
+
+    @classmethod
+    def build(
+        cls,
+        *,
+        scheme: str,
+        user: Optional[str] = None,
+        password: Optional[str] = None,
+        host: str,
+        port: Optional[str] = None,
+        path: Optional[str] = None,
+        query: Optional[str] = None,
+        fragment: Optional[str] = None,
+        **_kwargs: str,
+    ) -> str:
+        parts = Parts(
+            scheme=scheme,
+            user=user,
+            password=password,
+            host=host,
+            port=port,
+            path=path,
+            query=query,
+            fragment=fragment,
+            **_kwargs,  # type: ignore[misc]
+        )
+
+        url = scheme + '://'
+        if user:
+            url += user
+        if password:
+            url += ':' + password
+        if user or password:
+            url += '@'
+        url += host
+        if port and ('port' not in cls.hidden_parts or cls.get_default_parts(parts).get('port') != port):
+            url += ':' + port
+        if path:
+            url += path
+        if query:
+            url += '?' + query
+        if fragment:
+            url += '#' + fragment
+        return url
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        update_not_none(field_schema, minLength=cls.min_length, maxLength=cls.max_length, format='uri')
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield cls.validate
+
+    @classmethod
+    def validate(cls, value: Any, field: 'ModelField', config: 'BaseConfig') -> 'AnyUrl':
+        if value.__class__ == cls:
+            return value
+        value = str_validator(value)
+        if cls.strip_whitespace:
+            value = value.strip()
+        url: str = cast(str, constr_length_validator(value, field, config))
+
+        m = cls._match_url(url)
+        # the regex should always match, if it doesn't please report with details of the URL tried
+        assert m, 'URL regex failed unexpectedly'
+
+        original_parts = cast('Parts', m.groupdict())
+        parts = cls.apply_default_parts(original_parts)
+        parts = cls.validate_parts(parts)
+
+        if m.end() != len(url):
+            raise errors.UrlExtraError(extra=url[m.end() :])
+
+        return cls._build_url(m, url, parts)
+
+    @classmethod
+    def _build_url(cls, m: Match[str], url: str, parts: 'Parts') -> 'AnyUrl':
+        """
+        Validate hosts and build the AnyUrl object. Split from `validate` so this method
+        can be altered in `MultiHostDsn`.
+        """
+        host, tld, host_type, rebuild = cls.validate_host(parts)
+
+        return cls(
+            None if rebuild else url,
+            scheme=parts['scheme'],
+            user=parts['user'],
+            password=parts['password'],
+            host=host,
+            tld=tld,
+            host_type=host_type,
+            port=parts['port'],
+            path=parts['path'],
+            query=parts['query'],
+            fragment=parts['fragment'],
+        )
+
+    @staticmethod
+    def _match_url(url: str) -> Optional[Match[str]]:
+        return url_regex().match(url)
+
+    @staticmethod
+    def _validate_port(port: Optional[str]) -> None:
+        if port is not None and int(port) > 65_535:
+            raise errors.UrlPortError()
+
+    @classmethod
+    def validate_parts(cls, parts: 'Parts', validate_port: bool = True) -> 'Parts':
+        """
+        A method used to validate parts of a URL.
+        Could be overridden to set default values for parts if missing
+        """
+        scheme = parts['scheme']
+        if scheme is None:
+            raise errors.UrlSchemeError()
+
+        if cls.allowed_schemes and scheme.lower() not in cls.allowed_schemes:
+            raise errors.UrlSchemePermittedError(set(cls.allowed_schemes))
+
+        if validate_port:
+            cls._validate_port(parts['port'])
+
+        user = parts['user']
+        if cls.user_required and user is None:
+            raise errors.UrlUserInfoError()
+
+        return parts
+
+    @classmethod
+    def validate_host(cls, parts: 'Parts') -> Tuple[str, Optional[str], str, bool]:
+        tld, host_type, rebuild = None, None, False
+        for f in ('domain', 'ipv4', 'ipv6'):
+            host = parts[f]  # type: ignore[literal-required]
+            if host:
+                host_type = f
+                break
+
+        if host is None:
+            if cls.host_required:
+                raise errors.UrlHostError()
+        elif host_type == 'domain':
+            is_international = False
+            d = ascii_domain_regex().fullmatch(host)
+            if d is None:
+                d = int_domain_regex().fullmatch(host)
+                if d is None:
+                    raise errors.UrlHostError()
+                is_international = True
+
+            tld = d.group('tld')
+            if tld is None and not is_international:
+                d = int_domain_regex().fullmatch(host)
+                assert d is not None
+                tld = d.group('tld')
+                is_international = True
+
+            if tld is not None:
+                tld = tld[1:]
+            elif cls.tld_required:
+                raise errors.UrlHostTldError()
+
+            if is_international:
+                host_type = 'int_domain'
+                rebuild = True
+                host = host.encode('idna').decode('ascii')
+                if tld is not None:
+                    tld = tld.encode('idna').decode('ascii')
+
+        return host, tld, host_type, rebuild  # type: ignore
+
+    @staticmethod
+    def get_default_parts(parts: 'Parts') -> 'Parts':
+        return {}
+
+    @classmethod
+    def apply_default_parts(cls, parts: 'Parts') -> 'Parts':
+        for key, value in cls.get_default_parts(parts).items():
+            if not parts[key]:  # type: ignore[literal-required]
+                parts[key] = value  # type: ignore[literal-required]
+        return parts
+
+    def __repr__(self) -> str:
+        extra = ', '.join(f'{n}={getattr(self, n)!r}' for n in self.__slots__ if getattr(self, n) is not None)
+        return f'{self.__class__.__name__}({super().__repr__()}, {extra})'
+
+
+class AnyHttpUrl(AnyUrl):
+    allowed_schemes = {'http', 'https'}
+
+    __slots__ = ()
+
+
+class HttpUrl(AnyHttpUrl):
+    tld_required = True
+    # https://stackoverflow.com/questions/417142/what-is-the-maximum-length-of-a-url-in-different-browsers
+    max_length = 2083
+    hidden_parts = {'port'}
+
+    @staticmethod
+    def get_default_parts(parts: 'Parts') -> 'Parts':
+        return {'port': '80' if parts['scheme'] == 'http' else '443'}
+
+
+class FileUrl(AnyUrl):
+    allowed_schemes = {'file'}
+    host_required = False
+
+    __slots__ = ()
+
+
+class MultiHostDsn(AnyUrl):
+    __slots__ = AnyUrl.__slots__ + ('hosts',)
+
+    def __init__(self, *args: Any, hosts: Optional[List['HostParts']] = None, **kwargs: Any):
+        super().__init__(*args, **kwargs)
+        self.hosts = hosts
+
+    @staticmethod
+    def _match_url(url: str) -> Optional[Match[str]]:
+        return multi_host_url_regex().match(url)
+
+    @classmethod
+    def validate_parts(cls, parts: 'Parts', validate_port: bool = True) -> 'Parts':
+        return super().validate_parts(parts, validate_port=False)
+
+    @classmethod
+    def _build_url(cls, m: Match[str], url: str, parts: 'Parts') -> 'MultiHostDsn':
+        hosts_parts: List['HostParts'] = []
+        host_re = host_regex()
+        for host in m.groupdict()['hosts'].split(','):
+            d: Parts = host_re.match(host).groupdict()  # type: ignore
+            host, tld, host_type, rebuild = cls.validate_host(d)
+            port = d.get('port')
+            cls._validate_port(port)
+            hosts_parts.append(
+                {
+                    'host': host,
+                    'host_type': host_type,
+                    'tld': tld,
+                    'rebuild': rebuild,
+                    'port': port,
+                }
+            )
+
+        if len(hosts_parts) > 1:
+            return cls(
+                None if any([hp['rebuild'] for hp in hosts_parts]) else url,
+                scheme=parts['scheme'],
+                user=parts['user'],
+                password=parts['password'],
+                path=parts['path'],
+                query=parts['query'],
+                fragment=parts['fragment'],
+                host_type=None,
+                hosts=hosts_parts,
+            )
+        else:
+            # backwards compatibility with single host
+            host_part = hosts_parts[0]
+            return cls(
+                None if host_part['rebuild'] else url,
+                scheme=parts['scheme'],
+                user=parts['user'],
+                password=parts['password'],
+                host=host_part['host'],
+                tld=host_part['tld'],
+                host_type=host_part['host_type'],
+                port=host_part.get('port'),
+                path=parts['path'],
+                query=parts['query'],
+                fragment=parts['fragment'],
+            )
+
+
+class PostgresDsn(MultiHostDsn):
+    allowed_schemes = {
+        'postgres',
+        'postgresql',
+        'postgresql+asyncpg',
+        'postgresql+pg8000',
+        'postgresql+psycopg',
+        'postgresql+psycopg2',
+        'postgresql+psycopg2cffi',
+        'postgresql+py-postgresql',
+        'postgresql+pygresql',
+    }
+    user_required = True
+
+    __slots__ = ()
+
+
+class CockroachDsn(AnyUrl):
+    allowed_schemes = {
+        'cockroachdb',
+        'cockroachdb+psycopg2',
+        'cockroachdb+asyncpg',
+    }
+    user_required = True
+
+
+class AmqpDsn(AnyUrl):
+    allowed_schemes = {'amqp', 'amqps'}
+    host_required = False
+
+
+class RedisDsn(AnyUrl):
+    __slots__ = ()
+    allowed_schemes = {'redis', 'rediss'}
+    host_required = False
+
+    @staticmethod
+    def get_default_parts(parts: 'Parts') -> 'Parts':
+        return {
+            'domain': 'localhost' if not (parts['ipv4'] or parts['ipv6']) else '',
+            'port': '6379',
+            'path': '/0',
+        }
+
+
+class MongoDsn(AnyUrl):
+    allowed_schemes = {'mongodb'}
+
+    # TODO: Needed to generic "Parts" for "Replica Set", "Sharded Cluster", and other mongodb deployment modes
+    @staticmethod
+    def get_default_parts(parts: 'Parts') -> 'Parts':
+        return {
+            'port': '27017',
+        }
+
+
+class KafkaDsn(AnyUrl):
+    allowed_schemes = {'kafka'}
+
+    @staticmethod
+    def get_default_parts(parts: 'Parts') -> 'Parts':
+        return {
+            'domain': 'localhost',
+            'port': '9092',
+        }
+
+
+def stricturl(
+    *,
+    strip_whitespace: bool = True,
+    min_length: int = 1,
+    max_length: int = 2**16,
+    tld_required: bool = True,
+    host_required: bool = True,
+    allowed_schemes: Optional[Collection[str]] = None,
+) -> Type[AnyUrl]:
+    # use kwargs then define conf in a dict to aid with IDE type hinting
+    namespace = dict(
+        strip_whitespace=strip_whitespace,
+        min_length=min_length,
+        max_length=max_length,
+        tld_required=tld_required,
+        host_required=host_required,
+        allowed_schemes=allowed_schemes,
+    )
+    return type('UrlValue', (AnyUrl,), namespace)
+
+
+def import_email_validator() -> None:
+    global email_validator
+    try:
+        import email_validator
+    except ImportError as e:
+        raise ImportError('email-validator is not installed, run `pip install pydantic[email]`') from e
+
+
+class EmailStr(str):
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        field_schema.update(type='string', format='email')
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        # included here and below so the error happens straight away
+        import_email_validator()
+
+        yield str_validator
+        yield cls.validate
+
+    @classmethod
+    def validate(cls, value: Union[str]) -> str:
+        return validate_email(value)[1]
+
+
+class NameEmail(Representation):
+    __slots__ = 'name', 'email'
+
+    def __init__(self, name: str, email: str):
+        self.name = name
+        self.email = email
+
+    def __eq__(self, other: Any) -> bool:
+        return isinstance(other, NameEmail) and (self.name, self.email) == (other.name, other.email)
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        field_schema.update(type='string', format='name-email')
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        import_email_validator()
+
+        yield cls.validate
+
+    @classmethod
+    def validate(cls, value: Any) -> 'NameEmail':
+        if value.__class__ == cls:
+            return value
+        value = str_validator(value)
+        return cls(*validate_email(value))
+
+    def __str__(self) -> str:
+        return f'{self.name} <{self.email}>'
+
+
+class IPvAnyAddress(_BaseAddress):
+    __slots__ = ()
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        field_schema.update(type='string', format='ipvanyaddress')
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield cls.validate
+
+    @classmethod
+    def validate(cls, value: Union[str, bytes, int]) -> Union[IPv4Address, IPv6Address]:
+        try:
+            return IPv4Address(value)
+        except ValueError:
+            pass
+
+        try:
+            return IPv6Address(value)
+        except ValueError:
+            raise errors.IPvAnyAddressError()
+
+
+class IPvAnyInterface(_BaseAddress):
+    __slots__ = ()
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        field_schema.update(type='string', format='ipvanyinterface')
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield cls.validate
+
+    @classmethod
+    def validate(cls, value: NetworkType) -> Union[IPv4Interface, IPv6Interface]:
+        try:
+            return IPv4Interface(value)
+        except ValueError:
+            pass
+
+        try:
+            return IPv6Interface(value)
+        except ValueError:
+            raise errors.IPvAnyInterfaceError()
+
+
+class IPvAnyNetwork(_BaseNetwork):  # type: ignore
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        field_schema.update(type='string', format='ipvanynetwork')
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield cls.validate
+
+    @classmethod
+    def validate(cls, value: NetworkType) -> Union[IPv4Network, IPv6Network]:
+        # Assume IP Network is defined with a default value for ``strict`` argument.
+        # Define your own class if you want to specify network address check strictness.
+        try:
+            return IPv4Network(value)
+        except ValueError:
+            pass
+
+        try:
+            return IPv6Network(value)
+        except ValueError:
+            raise errors.IPvAnyNetworkError()
+
+
+pretty_email_regex = re.compile(r'([\w ]*?) *<(.*)> *')
+MAX_EMAIL_LENGTH = 2048
+"""Maximum length for an email.
+A somewhat arbitrary but very generous number compared to what is allowed by most implementations.
+"""
+
+
+def validate_email(value: Union[str]) -> Tuple[str, str]:
+    """
+    Email address validation using https://pypi.org/project/email-validator/
+    Notes:
+    * raw ip address (literal) domain parts are not allowed.
+    * "John Doe <local_part@domain.com>" style "pretty" email addresses are processed
+    * spaces are striped from the beginning and end of addresses but no error is raised
+    """
+    if email_validator is None:
+        import_email_validator()
+
+    if len(value) > MAX_EMAIL_LENGTH:
+        raise errors.EmailError()
+
+    m = pretty_email_regex.fullmatch(value)
+    name: Union[str, None] = None
+    if m:
+        name, value = m.groups()
+    email = value.strip()
+    try:
+        parts = email_validator.validate_email(email, check_deliverability=False)
+    except email_validator.EmailNotValidError as e:
+        raise errors.EmailError from e
+
+    if hasattr(parts, 'normalized'):
+        # email-validator >= 2
+        email = parts.normalized
+        assert email is not None
+        name = name or parts.local_part
+        return name, email
+    else:
+        # email-validator >1, <2
+        at_index = email.index('@')
+        local_part = email[:at_index]  # RFC 5321, local part must be case-sensitive.
+        global_part = email[at_index:].lower()
+
+        return name or local_part, local_part + global_part
diff --git a/lib/pydantic/v1/parse.py b/lib/pydantic/v1/parse.py
new file mode 100644
index 00000000..7ac330ca
--- /dev/null
+++ b/lib/pydantic/v1/parse.py
@@ -0,0 +1,66 @@
+import json
+import pickle
+from enum import Enum
+from pathlib import Path
+from typing import Any, Callable, Union
+
+from .types import StrBytes
+
+
+class Protocol(str, Enum):
+    json = 'json'
+    pickle = 'pickle'
+
+
+def load_str_bytes(
+    b: StrBytes,
+    *,
+    content_type: str = None,
+    encoding: str = 'utf8',
+    proto: Protocol = None,
+    allow_pickle: bool = False,
+    json_loads: Callable[[str], Any] = json.loads,
+) -> Any:
+    if proto is None and content_type:
+        if content_type.endswith(('json', 'javascript')):
+            pass
+        elif allow_pickle and content_type.endswith('pickle'):
+            proto = Protocol.pickle
+        else:
+            raise TypeError(f'Unknown content-type: {content_type}')
+
+    proto = proto or Protocol.json
+
+    if proto == Protocol.json:
+        if isinstance(b, bytes):
+            b = b.decode(encoding)
+        return json_loads(b)
+    elif proto == Protocol.pickle:
+        if not allow_pickle:
+            raise RuntimeError('Trying to decode with pickle with allow_pickle=False')
+        bb = b if isinstance(b, bytes) else b.encode()
+        return pickle.loads(bb)
+    else:
+        raise TypeError(f'Unknown protocol: {proto}')
+
+
+def load_file(
+    path: Union[str, Path],
+    *,
+    content_type: str = None,
+    encoding: str = 'utf8',
+    proto: Protocol = None,
+    allow_pickle: bool = False,
+    json_loads: Callable[[str], Any] = json.loads,
+) -> Any:
+    path = Path(path)
+    b = path.read_bytes()
+    if content_type is None:
+        if path.suffix in ('.js', '.json'):
+            proto = Protocol.json
+        elif path.suffix == '.pkl':
+            proto = Protocol.pickle
+
+    return load_str_bytes(
+        b, proto=proto, content_type=content_type, encoding=encoding, allow_pickle=allow_pickle, json_loads=json_loads
+    )
diff --git a/lib/pydantic/v1/py.typed b/lib/pydantic/v1/py.typed
new file mode 100644
index 00000000..e69de29b
diff --git a/lib/pydantic/v1/schema.py b/lib/pydantic/v1/schema.py
new file mode 100644
index 00000000..ea16a72a
--- /dev/null
+++ b/lib/pydantic/v1/schema.py
@@ -0,0 +1,1163 @@
+import re
+import warnings
+from collections import defaultdict
+from dataclasses import is_dataclass
+from datetime import date, datetime, time, timedelta
+from decimal import Decimal
+from enum import Enum
+from ipaddress import IPv4Address, IPv4Interface, IPv4Network, IPv6Address, IPv6Interface, IPv6Network
+from pathlib import Path
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    Dict,
+    ForwardRef,
+    FrozenSet,
+    Generic,
+    Iterable,
+    List,
+    Optional,
+    Pattern,
+    Sequence,
+    Set,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+    cast,
+)
+from uuid import UUID
+
+from typing_extensions import Annotated, Literal
+
+from .fields import (
+    MAPPING_LIKE_SHAPES,
+    SHAPE_DEQUE,
+    SHAPE_FROZENSET,
+    SHAPE_GENERIC,
+    SHAPE_ITERABLE,
+    SHAPE_LIST,
+    SHAPE_SEQUENCE,
+    SHAPE_SET,
+    SHAPE_SINGLETON,
+    SHAPE_TUPLE,
+    SHAPE_TUPLE_ELLIPSIS,
+    FieldInfo,
+    ModelField,
+)
+from .json import pydantic_encoder
+from .networks import AnyUrl, EmailStr
+from .types import (
+    ConstrainedDecimal,
+    ConstrainedFloat,
+    ConstrainedFrozenSet,
+    ConstrainedInt,
+    ConstrainedList,
+    ConstrainedSet,
+    ConstrainedStr,
+    SecretBytes,
+    SecretStr,
+    StrictBytes,
+    StrictStr,
+    conbytes,
+    condecimal,
+    confloat,
+    confrozenset,
+    conint,
+    conlist,
+    conset,
+    constr,
+)
+from .typing import (
+    all_literal_values,
+    get_args,
+    get_origin,
+    get_sub_types,
+    is_callable_type,
+    is_literal_type,
+    is_namedtuple,
+    is_none_type,
+    is_union,
+)
+from .utils import ROOT_KEY, get_model, lenient_issubclass
+
+if TYPE_CHECKING:
+    from .dataclasses import Dataclass
+    from .main import BaseModel
+
+default_prefix = '#/definitions/'
+default_ref_template = '#/definitions/{model}'
+
+TypeModelOrEnum = Union[Type['BaseModel'], Type[Enum]]
+TypeModelSet = Set[TypeModelOrEnum]
+
+
+def _apply_modify_schema(
+    modify_schema: Callable[..., None], field: Optional[ModelField], field_schema: Dict[str, Any]
+) -> None:
+    from inspect import signature
+
+    sig = signature(modify_schema)
+    args = set(sig.parameters.keys())
+    if 'field' in args or 'kwargs' in args:
+        modify_schema(field_schema, field=field)
+    else:
+        modify_schema(field_schema)
+
+
+def schema(
+    models: Sequence[Union[Type['BaseModel'], Type['Dataclass']]],
+    *,
+    by_alias: bool = True,
+    title: Optional[str] = None,
+    description: Optional[str] = None,
+    ref_prefix: Optional[str] = None,
+    ref_template: str = default_ref_template,
+) -> Dict[str, Any]:
+    """
+    Process a list of models and generate a single JSON Schema with all of them defined in the ``definitions``
+    top-level JSON key, including their sub-models.
+
+    :param models: a list of models to include in the generated JSON Schema
+    :param by_alias: generate the schemas using the aliases defined, if any
+    :param title: title for the generated schema that includes the definitions
+    :param description: description for the generated schema
+    :param ref_prefix: the JSON Pointer prefix for schema references with ``$ref``, if None, will be set to the
+      default of ``#/definitions/``. Update it if you want the schemas to reference the definitions somewhere
+      else, e.g. for OpenAPI use ``#/components/schemas/``. The resulting generated schemas will still be at the
+      top-level key ``definitions``, so you can extract them from there. But all the references will have the set
+      prefix.
+    :param ref_template: Use a ``string.format()`` template for ``$ref`` instead of a prefix. This can be useful
+      for references that cannot be represented by ``ref_prefix`` such as a definition stored in another file. For
+      a sibling json file in a ``/schemas`` directory use ``"/schemas/${model}.json#"``.
+    :return: dict with the JSON Schema with a ``definitions`` top-level key including the schema definitions for
+      the models and sub-models passed in ``models``.
+    """
+    clean_models = [get_model(model) for model in models]
+    flat_models = get_flat_models_from_models(clean_models)
+    model_name_map = get_model_name_map(flat_models)
+    definitions = {}
+    output_schema: Dict[str, Any] = {}
+    if title:
+        output_schema['title'] = title
+    if description:
+        output_schema['description'] = description
+    for model in clean_models:
+        m_schema, m_definitions, m_nested_models = model_process_schema(
+            model,
+            by_alias=by_alias,
+            model_name_map=model_name_map,
+            ref_prefix=ref_prefix,
+            ref_template=ref_template,
+        )
+        definitions.update(m_definitions)
+        model_name = model_name_map[model]
+        definitions[model_name] = m_schema
+    if definitions:
+        output_schema['definitions'] = definitions
+    return output_schema
+
+
+def model_schema(
+    model: Union[Type['BaseModel'], Type['Dataclass']],
+    by_alias: bool = True,
+    ref_prefix: Optional[str] = None,
+    ref_template: str = default_ref_template,
+) -> Dict[str, Any]:
+    """
+    Generate a JSON Schema for one model. With all the sub-models defined in the ``definitions`` top-level
+    JSON key.
+
+    :param model: a Pydantic model (a class that inherits from BaseModel)
+    :param by_alias: generate the schemas using the aliases defined, if any
+    :param ref_prefix: the JSON Pointer prefix for schema references with ``$ref``, if None, will be set to the
+      default of ``#/definitions/``. Update it if you want the schemas to reference the definitions somewhere
+      else, e.g. for OpenAPI use ``#/components/schemas/``. The resulting generated schemas will still be at the
+      top-level key ``definitions``, so you can extract them from there. But all the references will have the set
+      prefix.
+    :param ref_template: Use a ``string.format()`` template for ``$ref`` instead of a prefix. This can be useful for
+      references that cannot be represented by ``ref_prefix`` such as a definition stored in another file. For a
+      sibling json file in a ``/schemas`` directory use ``"/schemas/${model}.json#"``.
+    :return: dict with the JSON Schema for the passed ``model``
+    """
+    model = get_model(model)
+    flat_models = get_flat_models_from_model(model)
+    model_name_map = get_model_name_map(flat_models)
+    model_name = model_name_map[model]
+    m_schema, m_definitions, nested_models = model_process_schema(
+        model, by_alias=by_alias, model_name_map=model_name_map, ref_prefix=ref_prefix, ref_template=ref_template
+    )
+    if model_name in nested_models:
+        # model_name is in Nested models, it has circular references
+        m_definitions[model_name] = m_schema
+        m_schema = get_schema_ref(model_name, ref_prefix, ref_template, False)
+    if m_definitions:
+        m_schema.update({'definitions': m_definitions})
+    return m_schema
+
+
+def get_field_info_schema(field: ModelField, schema_overrides: bool = False) -> Tuple[Dict[str, Any], bool]:
+    # If no title is explicitly set, we don't set title in the schema for enums.
+    # The behaviour is the same as `BaseModel` reference, where the default title
+    # is in the definitions part of the schema.
+    schema_: Dict[str, Any] = {}
+    if field.field_info.title or not lenient_issubclass(field.type_, Enum):
+        schema_['title'] = field.field_info.title or field.alias.title().replace('_', ' ')
+
+    if field.field_info.title:
+        schema_overrides = True
+
+    if field.field_info.description:
+        schema_['description'] = field.field_info.description
+        schema_overrides = True
+
+    if not field.required and field.default is not None and not is_callable_type(field.outer_type_):
+        schema_['default'] = encode_default(field.default)
+        schema_overrides = True
+
+    return schema_, schema_overrides
+
+
+def field_schema(
+    field: ModelField,
+    *,
+    by_alias: bool = True,
+    model_name_map: Dict[TypeModelOrEnum, str],
+    ref_prefix: Optional[str] = None,
+    ref_template: str = default_ref_template,
+    known_models: Optional[TypeModelSet] = None,
+) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]:
+    """
+    Process a Pydantic field and return a tuple with a JSON Schema for it as the first item.
+    Also return a dictionary of definitions with models as keys and their schemas as values. If the passed field
+    is a model and has sub-models, and those sub-models don't have overrides (as ``title``, ``default``, etc), they
+    will be included in the definitions and referenced in the schema instead of included recursively.
+
+    :param field: a Pydantic ``ModelField``
+    :param by_alias: use the defined alias (if any) in the returned schema
+    :param model_name_map: used to generate the JSON Schema references to other models included in the definitions
+    :param ref_prefix: the JSON Pointer prefix to use for references to other schemas, if None, the default of
+      #/definitions/ will be used
+    :param ref_template: Use a ``string.format()`` template for ``$ref`` instead of a prefix. This can be useful for
+      references that cannot be represented by ``ref_prefix`` such as a definition stored in another file. For a
+      sibling json file in a ``/schemas`` directory use ``"/schemas/${model}.json#"``.
+    :param known_models: used to solve circular references
+    :return: tuple of the schema for this field and additional definitions
+    """
+    s, schema_overrides = get_field_info_schema(field)
+
+    validation_schema = get_field_schema_validations(field)
+    if validation_schema:
+        s.update(validation_schema)
+        schema_overrides = True
+
+    f_schema, f_definitions, f_nested_models = field_type_schema(
+        field,
+        by_alias=by_alias,
+        model_name_map=model_name_map,
+        schema_overrides=schema_overrides,
+        ref_prefix=ref_prefix,
+        ref_template=ref_template,
+        known_models=known_models or set(),
+    )
+
+    # $ref will only be returned when there are no schema_overrides
+    if '$ref' in f_schema:
+        return f_schema, f_definitions, f_nested_models
+    else:
+        s.update(f_schema)
+        return s, f_definitions, f_nested_models
+
+
+numeric_types = (int, float, Decimal)
+_str_types_attrs: Tuple[Tuple[str, Union[type, Tuple[type, ...]], str], ...] = (
+    ('max_length', numeric_types, 'maxLength'),
+    ('min_length', numeric_types, 'minLength'),
+    ('regex', str, 'pattern'),
+)
+
+_numeric_types_attrs: Tuple[Tuple[str, Union[type, Tuple[type, ...]], str], ...] = (
+    ('gt', numeric_types, 'exclusiveMinimum'),
+    ('lt', numeric_types, 'exclusiveMaximum'),
+    ('ge', numeric_types, 'minimum'),
+    ('le', numeric_types, 'maximum'),
+    ('multiple_of', numeric_types, 'multipleOf'),
+)
+
+
+def get_field_schema_validations(field: ModelField) -> Dict[str, Any]:
+    """
+    Get the JSON Schema validation keywords for a ``field`` with an annotation of
+    a Pydantic ``FieldInfo`` with validation arguments.
+    """
+    f_schema: Dict[str, Any] = {}
+
+    if lenient_issubclass(field.type_, Enum):
+        # schema is already updated by `enum_process_schema`; just update with field extra
+        if field.field_info.extra:
+            f_schema.update(field.field_info.extra)
+        return f_schema
+
+    if lenient_issubclass(field.type_, (str, bytes)):
+        for attr_name, t, keyword in _str_types_attrs:
+            attr = getattr(field.field_info, attr_name, None)
+            if isinstance(attr, t):
+                f_schema[keyword] = attr
+    if lenient_issubclass(field.type_, numeric_types) and not issubclass(field.type_, bool):
+        for attr_name, t, keyword in _numeric_types_attrs:
+            attr = getattr(field.field_info, attr_name, None)
+            if isinstance(attr, t):
+                f_schema[keyword] = attr
+    if field.field_info is not None and field.field_info.const:
+        f_schema['const'] = field.default
+    if field.field_info.extra:
+        f_schema.update(field.field_info.extra)
+    modify_schema = getattr(field.outer_type_, '__modify_schema__', None)
+    if modify_schema:
+        _apply_modify_schema(modify_schema, field, f_schema)
+    return f_schema
+
+
+def get_model_name_map(unique_models: TypeModelSet) -> Dict[TypeModelOrEnum, str]:
+    """
+    Process a set of models and generate unique names for them to be used as keys in the JSON Schema
+    definitions. By default the names are the same as the class name. But if two models in different Python
+    modules have the same name (e.g. "users.Model" and "items.Model"), the generated names will be
+    based on the Python module path for those conflicting models to prevent name collisions.
+
+    :param unique_models: a Python set of models
+    :return: dict mapping models to names
+    """
+    name_model_map = {}
+    conflicting_names: Set[str] = set()
+    for model in unique_models:
+        model_name = normalize_name(model.__name__)
+        if model_name in conflicting_names:
+            model_name = get_long_model_name(model)
+            name_model_map[model_name] = model
+        elif model_name in name_model_map:
+            conflicting_names.add(model_name)
+            conflicting_model = name_model_map.pop(model_name)
+            name_model_map[get_long_model_name(conflicting_model)] = conflicting_model
+            name_model_map[get_long_model_name(model)] = model
+        else:
+            name_model_map[model_name] = model
+    return {v: k for k, v in name_model_map.items()}
+
+
+def get_flat_models_from_model(model: Type['BaseModel'], known_models: Optional[TypeModelSet] = None) -> TypeModelSet:
+    """
+    Take a single ``model`` and generate a set with itself and all the sub-models in the tree. I.e. if you pass
+    model ``Foo`` (subclass of Pydantic ``BaseModel``) as ``model``, and it has a field of type ``Bar`` (also
+    subclass of ``BaseModel``) and that model ``Bar`` has a field of type ``Baz`` (also subclass of ``BaseModel``),
+    the return value will be ``set([Foo, Bar, Baz])``.
+
+    :param model: a Pydantic ``BaseModel`` subclass
+    :param known_models: used to solve circular references
+    :return: a set with the initial model and all its sub-models
+    """
+    known_models = known_models or set()
+    flat_models: TypeModelSet = set()
+    flat_models.add(model)
+    known_models |= flat_models
+    fields = cast(Sequence[ModelField], model.__fields__.values())
+    flat_models |= get_flat_models_from_fields(fields, known_models=known_models)
+    return flat_models
+
+
+def get_flat_models_from_field(field: ModelField, known_models: TypeModelSet) -> TypeModelSet:
+    """
+    Take a single Pydantic ``ModelField`` (from a model) that could have been declared as a subclass of BaseModel
+    (so, it could be a submodel), and generate a set with its model and all the sub-models in the tree.
+    I.e. if you pass a field that was declared to be of type ``Foo`` (subclass of BaseModel) as ``field``, and that
+    model ``Foo`` has a field of type ``Bar`` (also subclass of ``BaseModel``) and that model ``Bar`` has a field of
+    type ``Baz`` (also subclass of ``BaseModel``), the return value will be ``set([Foo, Bar, Baz])``.
+
+    :param field: a Pydantic ``ModelField``
+    :param known_models: used to solve circular references
+    :return: a set with the model used in the declaration for this field, if any, and all its sub-models
+    """
+    from .main import BaseModel
+
+    flat_models: TypeModelSet = set()
+
+    field_type = field.type_
+    if lenient_issubclass(getattr(field_type, '__pydantic_model__', None), BaseModel):
+        field_type = field_type.__pydantic_model__
+
+    if field.sub_fields and not lenient_issubclass(field_type, BaseModel):
+        flat_models |= get_flat_models_from_fields(field.sub_fields, known_models=known_models)
+    elif lenient_issubclass(field_type, BaseModel) and field_type not in known_models:
+        flat_models |= get_flat_models_from_model(field_type, known_models=known_models)
+    elif lenient_issubclass(field_type, Enum):
+        flat_models.add(field_type)
+    return flat_models
+
+
+def get_flat_models_from_fields(fields: Sequence[ModelField], known_models: TypeModelSet) -> TypeModelSet:
+    """
+    Take a list of Pydantic  ``ModelField``s (from a model) that could have been declared as subclasses of ``BaseModel``
+    (so, any of them could be a submodel), and generate a set with their models and all the sub-models in the tree.
+    I.e. if you pass a the fields of a model ``Foo`` (subclass of ``BaseModel``) as ``fields``, and on of them has a
+    field of type ``Bar`` (also subclass of ``BaseModel``) and that model ``Bar`` has a field of type ``Baz`` (also
+    subclass of ``BaseModel``), the return value will be ``set([Foo, Bar, Baz])``.
+
+    :param fields: a list of Pydantic ``ModelField``s
+    :param known_models: used to solve circular references
+    :return: a set with any model declared in the fields, and all their sub-models
+    """
+    flat_models: TypeModelSet = set()
+    for field in fields:
+        flat_models |= get_flat_models_from_field(field, known_models=known_models)
+    return flat_models
+
+
+def get_flat_models_from_models(models: Sequence[Type['BaseModel']]) -> TypeModelSet:
+    """
+    Take a list of ``models`` and generate a set with them and all their sub-models in their trees. I.e. if you pass
+    a list of two models, ``Foo`` and ``Bar``, both subclasses of Pydantic ``BaseModel`` as models, and ``Bar`` has
+    a field of type ``Baz`` (also subclass of ``BaseModel``), the return value will be ``set([Foo, Bar, Baz])``.
+    """
+    flat_models: TypeModelSet = set()
+    for model in models:
+        flat_models |= get_flat_models_from_model(model)
+    return flat_models
+
+
+def get_long_model_name(model: TypeModelOrEnum) -> str:
+    return f'{model.__module__}__{model.__qualname__}'.replace('.', '__')
+
+
+def field_type_schema(
+    field: ModelField,
+    *,
+    by_alias: bool,
+    model_name_map: Dict[TypeModelOrEnum, str],
+    ref_template: str,
+    schema_overrides: bool = False,
+    ref_prefix: Optional[str] = None,
+    known_models: TypeModelSet,
+) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]:
+    """
+    Used by ``field_schema()``, you probably should be using that function.
+
+    Take a single ``field`` and generate the schema for its type only, not including additional
+    information as title, etc. Also return additional schema definitions, from sub-models.
+    """
+    from .main import BaseModel  # noqa: F811
+
+    definitions = {}
+    nested_models: Set[str] = set()
+    f_schema: Dict[str, Any]
+    if field.shape in {
+        SHAPE_LIST,
+        SHAPE_TUPLE_ELLIPSIS,
+        SHAPE_SEQUENCE,
+        SHAPE_SET,
+        SHAPE_FROZENSET,
+        SHAPE_ITERABLE,
+        SHAPE_DEQUE,
+    }:
+        items_schema, f_definitions, f_nested_models = field_singleton_schema(
+            field,
+            by_alias=by_alias,
+            model_name_map=model_name_map,
+            ref_prefix=ref_prefix,
+            ref_template=ref_template,
+            known_models=known_models,
+        )
+        definitions.update(f_definitions)
+        nested_models.update(f_nested_models)
+        f_schema = {'type': 'array', 'items': items_schema}
+        if field.shape in {SHAPE_SET, SHAPE_FROZENSET}:
+            f_schema['uniqueItems'] = True
+
+    elif field.shape in MAPPING_LIKE_SHAPES:
+        f_schema = {'type': 'object'}
+        key_field = cast(ModelField, field.key_field)
+        regex = getattr(key_field.type_, 'regex', None)
+        items_schema, f_definitions, f_nested_models = field_singleton_schema(
+            field,
+            by_alias=by_alias,
+            model_name_map=model_name_map,
+            ref_prefix=ref_prefix,
+            ref_template=ref_template,
+            known_models=known_models,
+        )
+        definitions.update(f_definitions)
+        nested_models.update(f_nested_models)
+        if regex:
+            # Dict keys have a regex pattern
+            # items_schema might be a schema or empty dict, add it either way
+            f_schema['patternProperties'] = {ConstrainedStr._get_pattern(regex): items_schema}
+        if items_schema:
+            # The dict values are not simply Any, so they need a schema
+            f_schema['additionalProperties'] = items_schema
+    elif field.shape == SHAPE_TUPLE or (field.shape == SHAPE_GENERIC and not issubclass(field.type_, BaseModel)):
+        sub_schema = []
+        sub_fields = cast(List[ModelField], field.sub_fields)
+        for sf in sub_fields:
+            sf_schema, sf_definitions, sf_nested_models = field_type_schema(
+                sf,
+                by_alias=by_alias,
+                model_name_map=model_name_map,
+                ref_prefix=ref_prefix,
+                ref_template=ref_template,
+                known_models=known_models,
+            )
+            definitions.update(sf_definitions)
+            nested_models.update(sf_nested_models)
+            sub_schema.append(sf_schema)
+
+        sub_fields_len = len(sub_fields)
+        if field.shape == SHAPE_GENERIC:
+            all_of_schemas = sub_schema[0] if sub_fields_len == 1 else {'type': 'array', 'items': sub_schema}
+            f_schema = {'allOf': [all_of_schemas]}
+        else:
+            f_schema = {
+                'type': 'array',
+                'minItems': sub_fields_len,
+                'maxItems': sub_fields_len,
+            }
+            if sub_fields_len >= 1:
+                f_schema['items'] = sub_schema
+    else:
+        assert field.shape in {SHAPE_SINGLETON, SHAPE_GENERIC}, field.shape
+        f_schema, f_definitions, f_nested_models = field_singleton_schema(
+            field,
+            by_alias=by_alias,
+            model_name_map=model_name_map,
+            schema_overrides=schema_overrides,
+            ref_prefix=ref_prefix,
+            ref_template=ref_template,
+            known_models=known_models,
+        )
+        definitions.update(f_definitions)
+        nested_models.update(f_nested_models)
+
+    # check field type to avoid repeated calls to the same __modify_schema__ method
+    if field.type_ != field.outer_type_:
+        if field.shape == SHAPE_GENERIC:
+            field_type = field.type_
+        else:
+            field_type = field.outer_type_
+        modify_schema = getattr(field_type, '__modify_schema__', None)
+        if modify_schema:
+            _apply_modify_schema(modify_schema, field, f_schema)
+    return f_schema, definitions, nested_models
+
+
+def model_process_schema(
+    model: TypeModelOrEnum,
+    *,
+    by_alias: bool = True,
+    model_name_map: Dict[TypeModelOrEnum, str],
+    ref_prefix: Optional[str] = None,
+    ref_template: str = default_ref_template,
+    known_models: Optional[TypeModelSet] = None,
+    field: Optional[ModelField] = None,
+) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]:
+    """
+    Used by ``model_schema()``, you probably should be using that function.
+
+    Take a single ``model`` and generate its schema. Also return additional schema definitions, from sub-models. The
+    sub-models of the returned schema will be referenced, but their definitions will not be included in the schema. All
+    the definitions are returned as the second value.
+    """
+    from inspect import getdoc, signature
+
+    known_models = known_models or set()
+    if lenient_issubclass(model, Enum):
+        model = cast(Type[Enum], model)
+        s = enum_process_schema(model, field=field)
+        return s, {}, set()
+    model = cast(Type['BaseModel'], model)
+    s = {'title': model.__config__.title or model.__name__}
+    doc = getdoc(model)
+    if doc:
+        s['description'] = doc
+    known_models.add(model)
+    m_schema, m_definitions, nested_models = model_type_schema(
+        model,
+        by_alias=by_alias,
+        model_name_map=model_name_map,
+        ref_prefix=ref_prefix,
+        ref_template=ref_template,
+        known_models=known_models,
+    )
+    s.update(m_schema)
+    schema_extra = model.__config__.schema_extra
+    if callable(schema_extra):
+        if len(signature(schema_extra).parameters) == 1:
+            schema_extra(s)
+        else:
+            schema_extra(s, model)
+    else:
+        s.update(schema_extra)
+    return s, m_definitions, nested_models
+
+
+def model_type_schema(
+    model: Type['BaseModel'],
+    *,
+    by_alias: bool,
+    model_name_map: Dict[TypeModelOrEnum, str],
+    ref_template: str,
+    ref_prefix: Optional[str] = None,
+    known_models: TypeModelSet,
+) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]:
+    """
+    You probably should be using ``model_schema()``, this function is indirectly used by that function.
+
+    Take a single ``model`` and generate the schema for its type only, not including additional
+    information as title, etc. Also return additional schema definitions, from sub-models.
+    """
+    properties = {}
+    required = []
+    definitions: Dict[str, Any] = {}
+    nested_models: Set[str] = set()
+    for k, f in model.__fields__.items():
+        try:
+            f_schema, f_definitions, f_nested_models = field_schema(
+                f,
+                by_alias=by_alias,
+                model_name_map=model_name_map,
+                ref_prefix=ref_prefix,
+                ref_template=ref_template,
+                known_models=known_models,
+            )
+        except SkipField as skip:
+            warnings.warn(skip.message, UserWarning)
+            continue
+        definitions.update(f_definitions)
+        nested_models.update(f_nested_models)
+        if by_alias:
+            properties[f.alias] = f_schema
+            if f.required:
+                required.append(f.alias)
+        else:
+            properties[k] = f_schema
+            if f.required:
+                required.append(k)
+    if ROOT_KEY in properties:
+        out_schema = properties[ROOT_KEY]
+        out_schema['title'] = model.__config__.title or model.__name__
+    else:
+        out_schema = {'type': 'object', 'properties': properties}
+        if required:
+            out_schema['required'] = required
+    if model.__config__.extra == 'forbid':
+        out_schema['additionalProperties'] = False
+    return out_schema, definitions, nested_models
+
+
+def enum_process_schema(enum: Type[Enum], *, field: Optional[ModelField] = None) -> Dict[str, Any]:
+    """
+    Take a single `enum` and generate its schema.
+
+    This is similar to the `model_process_schema` function, but applies to ``Enum`` objects.
+    """
+    import inspect
+
+    schema_: Dict[str, Any] = {
+        'title': enum.__name__,
+        # Python assigns all enums a default docstring value of 'An enumeration', so
+        # all enums will have a description field even if not explicitly provided.
+        'description': inspect.cleandoc(enum.__doc__ or 'An enumeration.'),
+        # Add enum values and the enum field type to the schema.
+        'enum': [item.value for item in cast(Iterable[Enum], enum)],
+    }
+
+    add_field_type_to_schema(enum, schema_)
+
+    modify_schema = getattr(enum, '__modify_schema__', None)
+    if modify_schema:
+        _apply_modify_schema(modify_schema, field, schema_)
+
+    return schema_
+
+
+def field_singleton_sub_fields_schema(
+    field: ModelField,
+    *,
+    by_alias: bool,
+    model_name_map: Dict[TypeModelOrEnum, str],
+    ref_template: str,
+    schema_overrides: bool = False,
+    ref_prefix: Optional[str] = None,
+    known_models: TypeModelSet,
+) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]:
+    """
+    This function is indirectly used by ``field_schema()``, you probably should be using that function.
+
+    Take a list of Pydantic ``ModelField`` from the declaration of a type with parameters, and generate their
+    schema. I.e., fields used as "type parameters", like ``str`` and ``int`` in ``Tuple[str, int]``.
+    """
+    sub_fields = cast(List[ModelField], field.sub_fields)
+    definitions = {}
+    nested_models: Set[str] = set()
+    if len(sub_fields) == 1:
+        return field_type_schema(
+            sub_fields[0],
+            by_alias=by_alias,
+            model_name_map=model_name_map,
+            schema_overrides=schema_overrides,
+            ref_prefix=ref_prefix,
+            ref_template=ref_template,
+            known_models=known_models,
+        )
+    else:
+        s: Dict[str, Any] = {}
+        # https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#discriminator-object
+        field_has_discriminator: bool = field.discriminator_key is not None
+        if field_has_discriminator:
+            assert field.sub_fields_mapping is not None
+
+            discriminator_models_refs: Dict[str, Union[str, Dict[str, Any]]] = {}
+
+            for discriminator_value, sub_field in field.sub_fields_mapping.items():
+                if isinstance(discriminator_value, Enum):
+                    discriminator_value = str(discriminator_value.value)
+                # sub_field is either a `BaseModel` or directly an `Annotated` `Union` of many
+                if is_union(get_origin(sub_field.type_)):
+                    sub_models = get_sub_types(sub_field.type_)
+                    discriminator_models_refs[discriminator_value] = {
+                        model_name_map[sub_model]: get_schema_ref(
+                            model_name_map[sub_model], ref_prefix, ref_template, False
+                        )
+                        for sub_model in sub_models
+                    }
+                else:
+                    sub_field_type = sub_field.type_
+                    if hasattr(sub_field_type, '__pydantic_model__'):
+                        sub_field_type = sub_field_type.__pydantic_model__
+
+                    discriminator_model_name = model_name_map[sub_field_type]
+                    discriminator_model_ref = get_schema_ref(discriminator_model_name, ref_prefix, ref_template, False)
+                    discriminator_models_refs[discriminator_value] = discriminator_model_ref['$ref']
+
+            s['discriminator'] = {
+                'propertyName': field.discriminator_alias,
+                'mapping': discriminator_models_refs,
+            }
+
+        sub_field_schemas = []
+        for sf in sub_fields:
+            sub_schema, sub_definitions, sub_nested_models = field_type_schema(
+                sf,
+                by_alias=by_alias,
+                model_name_map=model_name_map,
+                schema_overrides=schema_overrides,
+                ref_prefix=ref_prefix,
+                ref_template=ref_template,
+                known_models=known_models,
+            )
+            definitions.update(sub_definitions)
+            if schema_overrides and 'allOf' in sub_schema:
+                # if the sub_field is a referenced schema we only need the referenced
+                # object. Otherwise we will end up with several allOf inside anyOf/oneOf.
+                # See https://github.com/pydantic/pydantic/issues/1209
+                sub_schema = sub_schema['allOf'][0]
+
+            if sub_schema.keys() == {'discriminator', 'oneOf'}:
+                # we don't want discriminator information inside oneOf choices, this is dealt with elsewhere
+                sub_schema.pop('discriminator')
+            sub_field_schemas.append(sub_schema)
+            nested_models.update(sub_nested_models)
+        s['oneOf' if field_has_discriminator else 'anyOf'] = sub_field_schemas
+        return s, definitions, nested_models
+
+
+# Order is important, e.g. subclasses of str must go before str
+# this is used only for standard library types, custom types should use __modify_schema__ instead
+field_class_to_schema: Tuple[Tuple[Any, Dict[str, Any]], ...] = (
+    (Path, {'type': 'string', 'format': 'path'}),
+    (datetime, {'type': 'string', 'format': 'date-time'}),
+    (date, {'type': 'string', 'format': 'date'}),
+    (time, {'type': 'string', 'format': 'time'}),
+    (timedelta, {'type': 'number', 'format': 'time-delta'}),
+    (IPv4Network, {'type': 'string', 'format': 'ipv4network'}),
+    (IPv6Network, {'type': 'string', 'format': 'ipv6network'}),
+    (IPv4Interface, {'type': 'string', 'format': 'ipv4interface'}),
+    (IPv6Interface, {'type': 'string', 'format': 'ipv6interface'}),
+    (IPv4Address, {'type': 'string', 'format': 'ipv4'}),
+    (IPv6Address, {'type': 'string', 'format': 'ipv6'}),
+    (Pattern, {'type': 'string', 'format': 'regex'}),
+    (str, {'type': 'string'}),
+    (bytes, {'type': 'string', 'format': 'binary'}),
+    (bool, {'type': 'boolean'}),
+    (int, {'type': 'integer'}),
+    (float, {'type': 'number'}),
+    (Decimal, {'type': 'number'}),
+    (UUID, {'type': 'string', 'format': 'uuid'}),
+    (dict, {'type': 'object'}),
+    (list, {'type': 'array', 'items': {}}),
+    (tuple, {'type': 'array', 'items': {}}),
+    (set, {'type': 'array', 'items': {}, 'uniqueItems': True}),
+    (frozenset, {'type': 'array', 'items': {}, 'uniqueItems': True}),
+)
+
+json_scheme = {'type': 'string', 'format': 'json-string'}
+
+
+def add_field_type_to_schema(field_type: Any, schema_: Dict[str, Any]) -> None:
+    """
+    Update the given `schema` with the type-specific metadata for the given `field_type`.
+
+    This function looks through `field_class_to_schema` for a class that matches the given `field_type`,
+    and then modifies the given `schema` with the information from that type.
+    """
+    for type_, t_schema in field_class_to_schema:
+        # Fallback for `typing.Pattern` and `re.Pattern` as they are not a valid class
+        if lenient_issubclass(field_type, type_) or field_type is type_ is Pattern:
+            schema_.update(t_schema)
+            break
+
+
+def get_schema_ref(name: str, ref_prefix: Optional[str], ref_template: str, schema_overrides: bool) -> Dict[str, Any]:
+    if ref_prefix:
+        schema_ref = {'$ref': ref_prefix + name}
+    else:
+        schema_ref = {'$ref': ref_template.format(model=name)}
+    return {'allOf': [schema_ref]} if schema_overrides else schema_ref
+
+
+def field_singleton_schema(  # noqa: C901 (ignore complexity)
+    field: ModelField,
+    *,
+    by_alias: bool,
+    model_name_map: Dict[TypeModelOrEnum, str],
+    ref_template: str,
+    schema_overrides: bool = False,
+    ref_prefix: Optional[str] = None,
+    known_models: TypeModelSet,
+) -> Tuple[Dict[str, Any], Dict[str, Any], Set[str]]:
+    """
+    This function is indirectly used by ``field_schema()``, you should probably be using that function.
+
+    Take a single Pydantic ``ModelField``, and return its schema and any additional definitions from sub-models.
+    """
+    from .main import BaseModel
+
+    definitions: Dict[str, Any] = {}
+    nested_models: Set[str] = set()
+    field_type = field.type_
+
+    # Recurse into this field if it contains sub_fields and is NOT a
+    # BaseModel OR that BaseModel is a const
+    if field.sub_fields and (
+        (field.field_info and field.field_info.const) or not lenient_issubclass(field_type, BaseModel)
+    ):
+        return field_singleton_sub_fields_schema(
+            field,
+            by_alias=by_alias,
+            model_name_map=model_name_map,
+            schema_overrides=schema_overrides,
+            ref_prefix=ref_prefix,
+            ref_template=ref_template,
+            known_models=known_models,
+        )
+    if field_type is Any or field_type is object or field_type.__class__ == TypeVar or get_origin(field_type) is type:
+        return {}, definitions, nested_models  # no restrictions
+    if is_none_type(field_type):
+        return {'type': 'null'}, definitions, nested_models
+    if is_callable_type(field_type):
+        raise SkipField(f'Callable {field.name} was excluded from schema since JSON schema has no equivalent type.')
+    f_schema: Dict[str, Any] = {}
+    if field.field_info is not None and field.field_info.const:
+        f_schema['const'] = field.default
+
+    if is_literal_type(field_type):
+        values = tuple(x.value if isinstance(x, Enum) else x for x in all_literal_values(field_type))
+
+        if len({v.__class__ for v in values}) > 1:
+            return field_schema(
+                multitypes_literal_field_for_schema(values, field),
+                by_alias=by_alias,
+                model_name_map=model_name_map,
+                ref_prefix=ref_prefix,
+                ref_template=ref_template,
+                known_models=known_models,
+            )
+
+        # All values have the same type
+        field_type = values[0].__class__
+        f_schema['enum'] = list(values)
+        add_field_type_to_schema(field_type, f_schema)
+    elif lenient_issubclass(field_type, Enum):
+        enum_name = model_name_map[field_type]
+        f_schema, schema_overrides = get_field_info_schema(field, schema_overrides)
+        f_schema.update(get_schema_ref(enum_name, ref_prefix, ref_template, schema_overrides))
+        definitions[enum_name] = enum_process_schema(field_type, field=field)
+    elif is_namedtuple(field_type):
+        sub_schema, *_ = model_process_schema(
+            field_type.__pydantic_model__,
+            by_alias=by_alias,
+            model_name_map=model_name_map,
+            ref_prefix=ref_prefix,
+            ref_template=ref_template,
+            known_models=known_models,
+            field=field,
+        )
+        items_schemas = list(sub_schema['properties'].values())
+        f_schema.update(
+            {
+                'type': 'array',
+                'items': items_schemas,
+                'minItems': len(items_schemas),
+                'maxItems': len(items_schemas),
+            }
+        )
+    elif not hasattr(field_type, '__pydantic_model__'):
+        add_field_type_to_schema(field_type, f_schema)
+
+        modify_schema = getattr(field_type, '__modify_schema__', None)
+        if modify_schema:
+            _apply_modify_schema(modify_schema, field, f_schema)
+
+    if f_schema:
+        return f_schema, definitions, nested_models
+
+    # Handle dataclass-based models
+    if lenient_issubclass(getattr(field_type, '__pydantic_model__', None), BaseModel):
+        field_type = field_type.__pydantic_model__
+
+    if issubclass(field_type, BaseModel):
+        model_name = model_name_map[field_type]
+        if field_type not in known_models:
+            sub_schema, sub_definitions, sub_nested_models = model_process_schema(
+                field_type,
+                by_alias=by_alias,
+                model_name_map=model_name_map,
+                ref_prefix=ref_prefix,
+                ref_template=ref_template,
+                known_models=known_models,
+                field=field,
+            )
+            definitions.update(sub_definitions)
+            definitions[model_name] = sub_schema
+            nested_models.update(sub_nested_models)
+        else:
+            nested_models.add(model_name)
+        schema_ref = get_schema_ref(model_name, ref_prefix, ref_template, schema_overrides)
+        return schema_ref, definitions, nested_models
+
+    # For generics with no args
+    args = get_args(field_type)
+    if args is not None and not args and Generic in field_type.__bases__:
+        return f_schema, definitions, nested_models
+
+    raise ValueError(f'Value not declarable with JSON Schema, field: {field}')
+
+
+def multitypes_literal_field_for_schema(values: Tuple[Any, ...], field: ModelField) -> ModelField:
+    """
+    To support `Literal` with values of different types, we split it into multiple `Literal` with same type
+    e.g. `Literal['qwe', 'asd', 1, 2]` becomes `Union[Literal['qwe', 'asd'], Literal[1, 2]]`
+    """
+    literal_distinct_types = defaultdict(list)
+    for v in values:
+        literal_distinct_types[v.__class__].append(v)
+    distinct_literals = (Literal[tuple(same_type_values)] for same_type_values in literal_distinct_types.values())
+
+    return ModelField(
+        name=field.name,
+        type_=Union[tuple(distinct_literals)],  # type: ignore
+        class_validators=field.class_validators,
+        model_config=field.model_config,
+        default=field.default,
+        required=field.required,
+        alias=field.alias,
+        field_info=field.field_info,
+    )
+
+
+def encode_default(dft: Any) -> Any:
+    from .main import BaseModel
+
+    if isinstance(dft, BaseModel) or is_dataclass(dft):
+        dft = cast('dict[str, Any]', pydantic_encoder(dft))
+
+    if isinstance(dft, dict):
+        return {encode_default(k): encode_default(v) for k, v in dft.items()}
+    elif isinstance(dft, Enum):
+        return dft.value
+    elif isinstance(dft, (int, float, str)):
+        return dft
+    elif isinstance(dft, (list, tuple)):
+        t = dft.__class__
+        seq_args = (encode_default(v) for v in dft)
+        return t(*seq_args) if is_namedtuple(t) else t(seq_args)
+    elif dft is None:
+        return None
+    else:
+        return pydantic_encoder(dft)
+
+
+_map_types_constraint: Dict[Any, Callable[..., type]] = {int: conint, float: confloat, Decimal: condecimal}
+
+
+def get_annotation_from_field_info(
+    annotation: Any, field_info: FieldInfo, field_name: str, validate_assignment: bool = False
+) -> Type[Any]:
+    """
+    Get an annotation with validation implemented for numbers and strings based on the field_info.
+    :param annotation: an annotation from a field specification, as ``str``, ``ConstrainedStr``
+    :param field_info: an instance of FieldInfo, possibly with declarations for validations and JSON Schema
+    :param field_name: name of the field for use in error messages
+    :param validate_assignment: default False, flag for BaseModel Config value of validate_assignment
+    :return: the same ``annotation`` if unmodified or a new annotation with validation in place
+    """
+    constraints = field_info.get_constraints()
+    used_constraints: Set[str] = set()
+    if constraints:
+        annotation, used_constraints = get_annotation_with_constraints(annotation, field_info)
+    if validate_assignment:
+        used_constraints.add('allow_mutation')
+
+    unused_constraints = constraints - used_constraints
+    if unused_constraints:
+        raise ValueError(
+            f'On field "{field_name}" the following field constraints are set but not enforced: '
+            f'{", ".join(unused_constraints)}. '
+            f'\nFor more details see https://docs.pydantic.dev/usage/schema/#unenforced-field-constraints'
+        )
+
+    return annotation
+
+
+def get_annotation_with_constraints(annotation: Any, field_info: FieldInfo) -> Tuple[Type[Any], Set[str]]:  # noqa: C901
+    """
+    Get an annotation with used constraints implemented for numbers and strings based on the field_info.
+
+    :param annotation: an annotation from a field specification, as ``str``, ``ConstrainedStr``
+    :param field_info: an instance of FieldInfo, possibly with declarations for validations and JSON Schema
+    :return: the same ``annotation`` if unmodified or a new annotation along with the used constraints.
+    """
+    used_constraints: Set[str] = set()
+
+    def go(type_: Any) -> Type[Any]:
+        if (
+            is_literal_type(type_)
+            or isinstance(type_, ForwardRef)
+            or lenient_issubclass(type_, (ConstrainedList, ConstrainedSet, ConstrainedFrozenSet))
+        ):
+            return type_
+        origin = get_origin(type_)
+        if origin is not None:
+            args: Tuple[Any, ...] = get_args(type_)
+            if any(isinstance(a, ForwardRef) for a in args):
+                # forward refs cause infinite recursion below
+                return type_
+
+            if origin is Annotated:
+                return go(args[0])
+            if is_union(origin):
+                return Union[tuple(go(a) for a in args)]  # type: ignore
+
+            if issubclass(origin, List) and (
+                field_info.min_items is not None
+                or field_info.max_items is not None
+                or field_info.unique_items is not None
+            ):
+                used_constraints.update({'min_items', 'max_items', 'unique_items'})
+                return conlist(
+                    go(args[0]),
+                    min_items=field_info.min_items,
+                    max_items=field_info.max_items,
+                    unique_items=field_info.unique_items,
+                )
+
+            if issubclass(origin, Set) and (field_info.min_items is not None or field_info.max_items is not None):
+                used_constraints.update({'min_items', 'max_items'})
+                return conset(go(args[0]), min_items=field_info.min_items, max_items=field_info.max_items)
+
+            if issubclass(origin, FrozenSet) and (field_info.min_items is not None or field_info.max_items is not None):
+                used_constraints.update({'min_items', 'max_items'})
+                return confrozenset(go(args[0]), min_items=field_info.min_items, max_items=field_info.max_items)
+
+            for t in (Tuple, List, Set, FrozenSet, Sequence):
+                if issubclass(origin, t):  # type: ignore
+                    return t[tuple(go(a) for a in args)]  # type: ignore
+
+            if issubclass(origin, Dict):
+                return Dict[args[0], go(args[1])]  # type: ignore
+
+        attrs: Optional[Tuple[str, ...]] = None
+        constraint_func: Optional[Callable[..., type]] = None
+        if isinstance(type_, type):
+            if issubclass(type_, (SecretStr, SecretBytes)):
+                attrs = ('max_length', 'min_length')
+
+                def constraint_func(**kw: Any) -> Type[Any]:
+                    return type(type_.__name__, (type_,), kw)
+
+            elif issubclass(type_, str) and not issubclass(type_, (EmailStr, AnyUrl)):
+                attrs = ('max_length', 'min_length', 'regex')
+                if issubclass(type_, StrictStr):
+
+                    def constraint_func(**kw: Any) -> Type[Any]:
+                        return type(type_.__name__, (type_,), kw)
+
+                else:
+                    constraint_func = constr
+            elif issubclass(type_, bytes):
+                attrs = ('max_length', 'min_length', 'regex')
+                if issubclass(type_, StrictBytes):
+
+                    def constraint_func(**kw: Any) -> Type[Any]:
+                        return type(type_.__name__, (type_,), kw)
+
+                else:
+                    constraint_func = conbytes
+            elif issubclass(type_, numeric_types) and not issubclass(
+                type_,
+                (
+                    ConstrainedInt,
+                    ConstrainedFloat,
+                    ConstrainedDecimal,
+                    ConstrainedList,
+                    ConstrainedSet,
+                    ConstrainedFrozenSet,
+                    bool,
+                ),
+            ):
+                # Is numeric type
+                attrs = ('gt', 'lt', 'ge', 'le', 'multiple_of')
+                if issubclass(type_, float):
+                    attrs += ('allow_inf_nan',)
+                if issubclass(type_, Decimal):
+                    attrs += ('max_digits', 'decimal_places')
+                numeric_type = next(t for t in numeric_types if issubclass(type_, t))  # pragma: no branch
+                constraint_func = _map_types_constraint[numeric_type]
+
+        if attrs:
+            used_constraints.update(set(attrs))
+            kwargs = {
+                attr_name: attr
+                for attr_name, attr in ((attr_name, getattr(field_info, attr_name)) for attr_name in attrs)
+                if attr is not None
+            }
+            if kwargs:
+                constraint_func = cast(Callable[..., type], constraint_func)
+                return constraint_func(**kwargs)
+        return type_
+
+    return go(annotation), used_constraints
+
+
+def normalize_name(name: str) -> str:
+    """
+    Normalizes the given name. This can be applied to either a model *or* enum.
+    """
+    return re.sub(r'[^a-zA-Z0-9.\-_]', '_', name)
+
+
+class SkipField(Exception):
+    """
+    Utility exception used to exclude fields from schema.
+    """
+
+    def __init__(self, message: str) -> None:
+        self.message = message
diff --git a/lib/pydantic/v1/tools.py b/lib/pydantic/v1/tools.py
new file mode 100644
index 00000000..45be2770
--- /dev/null
+++ b/lib/pydantic/v1/tools.py
@@ -0,0 +1,92 @@
+import json
+from functools import lru_cache
+from pathlib import Path
+from typing import TYPE_CHECKING, Any, Callable, Optional, Type, TypeVar, Union
+
+from .parse import Protocol, load_file, load_str_bytes
+from .types import StrBytes
+from .typing import display_as_type
+
+__all__ = ('parse_file_as', 'parse_obj_as', 'parse_raw_as', 'schema_of', 'schema_json_of')
+
+NameFactory = Union[str, Callable[[Type[Any]], str]]
+
+if TYPE_CHECKING:
+    from .typing import DictStrAny
+
+
+def _generate_parsing_type_name(type_: Any) -> str:
+    return f'ParsingModel[{display_as_type(type_)}]'
+
+
+@lru_cache(maxsize=2048)
+def _get_parsing_type(type_: Any, *, type_name: Optional[NameFactory] = None) -> Any:
+    from .main import create_model
+
+    if type_name is None:
+        type_name = _generate_parsing_type_name
+    if not isinstance(type_name, str):
+        type_name = type_name(type_)
+    return create_model(type_name, __root__=(type_, ...))
+
+
+T = TypeVar('T')
+
+
+def parse_obj_as(type_: Type[T], obj: Any, *, type_name: Optional[NameFactory] = None) -> T:
+    model_type = _get_parsing_type(type_, type_name=type_name)  # type: ignore[arg-type]
+    return model_type(__root__=obj).__root__
+
+
+def parse_file_as(
+    type_: Type[T],
+    path: Union[str, Path],
+    *,
+    content_type: str = None,
+    encoding: str = 'utf8',
+    proto: Protocol = None,
+    allow_pickle: bool = False,
+    json_loads: Callable[[str], Any] = json.loads,
+    type_name: Optional[NameFactory] = None,
+) -> T:
+    obj = load_file(
+        path,
+        proto=proto,
+        content_type=content_type,
+        encoding=encoding,
+        allow_pickle=allow_pickle,
+        json_loads=json_loads,
+    )
+    return parse_obj_as(type_, obj, type_name=type_name)
+
+
+def parse_raw_as(
+    type_: Type[T],
+    b: StrBytes,
+    *,
+    content_type: str = None,
+    encoding: str = 'utf8',
+    proto: Protocol = None,
+    allow_pickle: bool = False,
+    json_loads: Callable[[str], Any] = json.loads,
+    type_name: Optional[NameFactory] = None,
+) -> T:
+    obj = load_str_bytes(
+        b,
+        proto=proto,
+        content_type=content_type,
+        encoding=encoding,
+        allow_pickle=allow_pickle,
+        json_loads=json_loads,
+    )
+    return parse_obj_as(type_, obj, type_name=type_name)
+
+
+def schema_of(type_: Any, *, title: Optional[NameFactory] = None, **schema_kwargs: Any) -> 'DictStrAny':
+    """Generate a JSON schema (as dict) for the passed model or dynamically generated one"""
+    return _get_parsing_type(type_, type_name=title).schema(**schema_kwargs)
+
+
+def schema_json_of(type_: Any, *, title: Optional[NameFactory] = None, **schema_json_kwargs: Any) -> str:
+    """Generate a JSON schema (as JSON) for the passed model or dynamically generated one"""
+    return _get_parsing_type(type_, type_name=title).schema_json(**schema_json_kwargs)
diff --git a/lib/pydantic/v1/types.py b/lib/pydantic/v1/types.py
new file mode 100644
index 00000000..754e58ff
--- /dev/null
+++ b/lib/pydantic/v1/types.py
@@ -0,0 +1,1205 @@
+import abc
+import math
+import re
+import warnings
+from datetime import date
+from decimal import Decimal, InvalidOperation
+from enum import Enum
+from pathlib import Path
+from types import new_class
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    ClassVar,
+    Dict,
+    FrozenSet,
+    List,
+    Optional,
+    Pattern,
+    Set,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+    cast,
+    overload,
+)
+from uuid import UUID
+from weakref import WeakSet
+
+from . import errors
+from .datetime_parse import parse_date
+from .utils import import_string, update_not_none
+from .validators import (
+    bytes_validator,
+    constr_length_validator,
+    constr_lower,
+    constr_strip_whitespace,
+    constr_upper,
+    decimal_validator,
+    float_finite_validator,
+    float_validator,
+    frozenset_validator,
+    int_validator,
+    list_validator,
+    number_multiple_validator,
+    number_size_validator,
+    path_exists_validator,
+    path_validator,
+    set_validator,
+    str_validator,
+    strict_bytes_validator,
+    strict_float_validator,
+    strict_int_validator,
+    strict_str_validator,
+)
+
+__all__ = [
+    'NoneStr',
+    'NoneBytes',
+    'StrBytes',
+    'NoneStrBytes',
+    'StrictStr',
+    'ConstrainedBytes',
+    'conbytes',
+    'ConstrainedList',
+    'conlist',
+    'ConstrainedSet',
+    'conset',
+    'ConstrainedFrozenSet',
+    'confrozenset',
+    'ConstrainedStr',
+    'constr',
+    'PyObject',
+    'ConstrainedInt',
+    'conint',
+    'PositiveInt',
+    'NegativeInt',
+    'NonNegativeInt',
+    'NonPositiveInt',
+    'ConstrainedFloat',
+    'confloat',
+    'PositiveFloat',
+    'NegativeFloat',
+    'NonNegativeFloat',
+    'NonPositiveFloat',
+    'FiniteFloat',
+    'ConstrainedDecimal',
+    'condecimal',
+    'UUID1',
+    'UUID3',
+    'UUID4',
+    'UUID5',
+    'FilePath',
+    'DirectoryPath',
+    'Json',
+    'JsonWrapper',
+    'SecretField',
+    'SecretStr',
+    'SecretBytes',
+    'StrictBool',
+    'StrictBytes',
+    'StrictInt',
+    'StrictFloat',
+    'PaymentCardNumber',
+    'ByteSize',
+    'PastDate',
+    'FutureDate',
+    'ConstrainedDate',
+    'condate',
+]
+
+NoneStr = Optional[str]
+NoneBytes = Optional[bytes]
+StrBytes = Union[str, bytes]
+NoneStrBytes = Optional[StrBytes]
+OptionalInt = Optional[int]
+OptionalIntFloat = Union[OptionalInt, float]
+OptionalIntFloatDecimal = Union[OptionalIntFloat, Decimal]
+OptionalDate = Optional[date]
+StrIntFloat = Union[str, int, float]
+
+if TYPE_CHECKING:
+    from typing_extensions import Annotated
+
+    from .dataclasses import Dataclass
+    from .main import BaseModel
+    from .typing import CallableGenerator
+
+    ModelOrDc = Type[Union[BaseModel, Dataclass]]
+
+T = TypeVar('T')
+_DEFINED_TYPES: 'WeakSet[type]' = WeakSet()
+
+
+@overload
+def _registered(typ: Type[T]) -> Type[T]:
+    pass
+
+
+@overload
+def _registered(typ: 'ConstrainedNumberMeta') -> 'ConstrainedNumberMeta':
+    pass
+
+
+def _registered(typ: Union[Type[T], 'ConstrainedNumberMeta']) -> Union[Type[T], 'ConstrainedNumberMeta']:
+    # In order to generate valid examples of constrained types, Hypothesis needs
+    # to inspect the type object - so we keep a weakref to each contype object
+    # until it can be registered.  When (or if) our Hypothesis plugin is loaded,
+    # it monkeypatches this function.
+    # If Hypothesis is never used, the total effect is to keep a weak reference
+    # which has minimal memory usage and doesn't even affect garbage collection.
+    _DEFINED_TYPES.add(typ)
+    return typ
+
+
+class ConstrainedNumberMeta(type):
+    def __new__(cls, name: str, bases: Any, dct: Dict[str, Any]) -> 'ConstrainedInt':  # type: ignore
+        new_cls = cast('ConstrainedInt', type.__new__(cls, name, bases, dct))
+
+        if new_cls.gt is not None and new_cls.ge is not None:
+            raise errors.ConfigError('bounds gt and ge cannot be specified at the same time')
+        if new_cls.lt is not None and new_cls.le is not None:
+            raise errors.ConfigError('bounds lt and le cannot be specified at the same time')
+
+        return _registered(new_cls)  # type: ignore
+
+
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ BOOLEAN TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+if TYPE_CHECKING:
+    StrictBool = bool
+else:
+
+    class StrictBool(int):
+        """
+        StrictBool to allow for bools which are not type-coerced.
+        """
+
+        @classmethod
+        def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+            field_schema.update(type='boolean')
+
+        @classmethod
+        def __get_validators__(cls) -> 'CallableGenerator':
+            yield cls.validate
+
+        @classmethod
+        def validate(cls, value: Any) -> bool:
+            """
+            Ensure that we only allow bools.
+            """
+            if isinstance(value, bool):
+                return value
+
+            raise errors.StrictBoolError()
+
+
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ INTEGER TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+
+class ConstrainedInt(int, metaclass=ConstrainedNumberMeta):
+    strict: bool = False
+    gt: OptionalInt = None
+    ge: OptionalInt = None
+    lt: OptionalInt = None
+    le: OptionalInt = None
+    multiple_of: OptionalInt = None
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        update_not_none(
+            field_schema,
+            exclusiveMinimum=cls.gt,
+            exclusiveMaximum=cls.lt,
+            minimum=cls.ge,
+            maximum=cls.le,
+            multipleOf=cls.multiple_of,
+        )
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield strict_int_validator if cls.strict else int_validator
+        yield number_size_validator
+        yield number_multiple_validator
+
+
+def conint(
+    *,
+    strict: bool = False,
+    gt: Optional[int] = None,
+    ge: Optional[int] = None,
+    lt: Optional[int] = None,
+    le: Optional[int] = None,
+    multiple_of: Optional[int] = None,
+) -> Type[int]:
+    # use kwargs then define conf in a dict to aid with IDE type hinting
+    namespace = dict(strict=strict, gt=gt, ge=ge, lt=lt, le=le, multiple_of=multiple_of)
+    return type('ConstrainedIntValue', (ConstrainedInt,), namespace)
+
+
+if TYPE_CHECKING:
+    PositiveInt = int
+    NegativeInt = int
+    NonPositiveInt = int
+    NonNegativeInt = int
+    StrictInt = int
+else:
+
+    class PositiveInt(ConstrainedInt):
+        gt = 0
+
+    class NegativeInt(ConstrainedInt):
+        lt = 0
+
+    class NonPositiveInt(ConstrainedInt):
+        le = 0
+
+    class NonNegativeInt(ConstrainedInt):
+        ge = 0
+
+    class StrictInt(ConstrainedInt):
+        strict = True
+
+
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ FLOAT TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+
+class ConstrainedFloat(float, metaclass=ConstrainedNumberMeta):
+    strict: bool = False
+    gt: OptionalIntFloat = None
+    ge: OptionalIntFloat = None
+    lt: OptionalIntFloat = None
+    le: OptionalIntFloat = None
+    multiple_of: OptionalIntFloat = None
+    allow_inf_nan: Optional[bool] = None
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        update_not_none(
+            field_schema,
+            exclusiveMinimum=cls.gt,
+            exclusiveMaximum=cls.lt,
+            minimum=cls.ge,
+            maximum=cls.le,
+            multipleOf=cls.multiple_of,
+        )
+        # Modify constraints to account for differences between IEEE floats and JSON
+        if field_schema.get('exclusiveMinimum') == -math.inf:
+            del field_schema['exclusiveMinimum']
+        if field_schema.get('minimum') == -math.inf:
+            del field_schema['minimum']
+        if field_schema.get('exclusiveMaximum') == math.inf:
+            del field_schema['exclusiveMaximum']
+        if field_schema.get('maximum') == math.inf:
+            del field_schema['maximum']
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield strict_float_validator if cls.strict else float_validator
+        yield number_size_validator
+        yield number_multiple_validator
+        yield float_finite_validator
+
+
+def confloat(
+    *,
+    strict: bool = False,
+    gt: float = None,
+    ge: float = None,
+    lt: float = None,
+    le: float = None,
+    multiple_of: float = None,
+    allow_inf_nan: Optional[bool] = None,
+) -> Type[float]:
+    # use kwargs then define conf in a dict to aid with IDE type hinting
+    namespace = dict(strict=strict, gt=gt, ge=ge, lt=lt, le=le, multiple_of=multiple_of, allow_inf_nan=allow_inf_nan)
+    return type('ConstrainedFloatValue', (ConstrainedFloat,), namespace)
+
+
+if TYPE_CHECKING:
+    PositiveFloat = float
+    NegativeFloat = float
+    NonPositiveFloat = float
+    NonNegativeFloat = float
+    StrictFloat = float
+    FiniteFloat = float
+else:
+
+    class PositiveFloat(ConstrainedFloat):
+        gt = 0
+
+    class NegativeFloat(ConstrainedFloat):
+        lt = 0
+
+    class NonPositiveFloat(ConstrainedFloat):
+        le = 0
+
+    class NonNegativeFloat(ConstrainedFloat):
+        ge = 0
+
+    class StrictFloat(ConstrainedFloat):
+        strict = True
+
+    class FiniteFloat(ConstrainedFloat):
+        allow_inf_nan = False
+
+
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ BYTES TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+
+class ConstrainedBytes(bytes):
+    strip_whitespace = False
+    to_upper = False
+    to_lower = False
+    min_length: OptionalInt = None
+    max_length: OptionalInt = None
+    strict: bool = False
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        update_not_none(field_schema, minLength=cls.min_length, maxLength=cls.max_length)
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield strict_bytes_validator if cls.strict else bytes_validator
+        yield constr_strip_whitespace
+        yield constr_upper
+        yield constr_lower
+        yield constr_length_validator
+
+
+def conbytes(
+    *,
+    strip_whitespace: bool = False,
+    to_upper: bool = False,
+    to_lower: bool = False,
+    min_length: Optional[int] = None,
+    max_length: Optional[int] = None,
+    strict: bool = False,
+) -> Type[bytes]:
+    # use kwargs then define conf in a dict to aid with IDE type hinting
+    namespace = dict(
+        strip_whitespace=strip_whitespace,
+        to_upper=to_upper,
+        to_lower=to_lower,
+        min_length=min_length,
+        max_length=max_length,
+        strict=strict,
+    )
+    return _registered(type('ConstrainedBytesValue', (ConstrainedBytes,), namespace))
+
+
+if TYPE_CHECKING:
+    StrictBytes = bytes
+else:
+
+    class StrictBytes(ConstrainedBytes):
+        strict = True
+
+
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ STRING TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+
+class ConstrainedStr(str):
+    strip_whitespace = False
+    to_upper = False
+    to_lower = False
+    min_length: OptionalInt = None
+    max_length: OptionalInt = None
+    curtail_length: OptionalInt = None
+    regex: Optional[Union[str, Pattern[str]]] = None
+    strict = False
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        update_not_none(
+            field_schema,
+            minLength=cls.min_length,
+            maxLength=cls.max_length,
+            pattern=cls.regex and cls._get_pattern(cls.regex),
+        )
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield strict_str_validator if cls.strict else str_validator
+        yield constr_strip_whitespace
+        yield constr_upper
+        yield constr_lower
+        yield constr_length_validator
+        yield cls.validate
+
+    @classmethod
+    def validate(cls, value: Union[str]) -> Union[str]:
+        if cls.curtail_length and len(value) > cls.curtail_length:
+            value = value[: cls.curtail_length]
+
+        if cls.regex:
+            if not re.match(cls.regex, value):
+                raise errors.StrRegexError(pattern=cls._get_pattern(cls.regex))
+
+        return value
+
+    @staticmethod
+    def _get_pattern(regex: Union[str, Pattern[str]]) -> str:
+        return regex if isinstance(regex, str) else regex.pattern
+
+
+def constr(
+    *,
+    strip_whitespace: bool = False,
+    to_upper: bool = False,
+    to_lower: bool = False,
+    strict: bool = False,
+    min_length: Optional[int] = None,
+    max_length: Optional[int] = None,
+    curtail_length: Optional[int] = None,
+    regex: Optional[str] = None,
+) -> Type[str]:
+    # use kwargs then define conf in a dict to aid with IDE type hinting
+    namespace = dict(
+        strip_whitespace=strip_whitespace,
+        to_upper=to_upper,
+        to_lower=to_lower,
+        strict=strict,
+        min_length=min_length,
+        max_length=max_length,
+        curtail_length=curtail_length,
+        regex=regex and re.compile(regex),
+    )
+    return _registered(type('ConstrainedStrValue', (ConstrainedStr,), namespace))
+
+
+if TYPE_CHECKING:
+    StrictStr = str
+else:
+
+    class StrictStr(ConstrainedStr):
+        strict = True
+
+
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ SET TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+
+# This types superclass should be Set[T], but cython chokes on that...
+class ConstrainedSet(set):  # type: ignore
+    # Needed for pydantic to detect that this is a set
+    __origin__ = set
+    __args__: Set[Type[T]]  # type: ignore
+
+    min_items: Optional[int] = None
+    max_items: Optional[int] = None
+    item_type: Type[T]  # type: ignore
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield cls.set_length_validator
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        update_not_none(field_schema, minItems=cls.min_items, maxItems=cls.max_items)
+
+    @classmethod
+    def set_length_validator(cls, v: 'Optional[Set[T]]') -> 'Optional[Set[T]]':
+        if v is None:
+            return None
+
+        v = set_validator(v)
+        v_len = len(v)
+
+        if cls.min_items is not None and v_len < cls.min_items:
+            raise errors.SetMinLengthError(limit_value=cls.min_items)
+
+        if cls.max_items is not None and v_len > cls.max_items:
+            raise errors.SetMaxLengthError(limit_value=cls.max_items)
+
+        return v
+
+
+def conset(item_type: Type[T], *, min_items: Optional[int] = None, max_items: Optional[int] = None) -> Type[Set[T]]:
+    # __args__ is needed to conform to typing generics api
+    namespace = {'min_items': min_items, 'max_items': max_items, 'item_type': item_type, '__args__': [item_type]}
+    # We use new_class to be able to deal with Generic types
+    return new_class('ConstrainedSetValue', (ConstrainedSet,), {}, lambda ns: ns.update(namespace))
+
+
+# This types superclass should be FrozenSet[T], but cython chokes on that...
+class ConstrainedFrozenSet(frozenset):  # type: ignore
+    # Needed for pydantic to detect that this is a set
+    __origin__ = frozenset
+    __args__: FrozenSet[Type[T]]  # type: ignore
+
+    min_items: Optional[int] = None
+    max_items: Optional[int] = None
+    item_type: Type[T]  # type: ignore
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield cls.frozenset_length_validator
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        update_not_none(field_schema, minItems=cls.min_items, maxItems=cls.max_items)
+
+    @classmethod
+    def frozenset_length_validator(cls, v: 'Optional[FrozenSet[T]]') -> 'Optional[FrozenSet[T]]':
+        if v is None:
+            return None
+
+        v = frozenset_validator(v)
+        v_len = len(v)
+
+        if cls.min_items is not None and v_len < cls.min_items:
+            raise errors.FrozenSetMinLengthError(limit_value=cls.min_items)
+
+        if cls.max_items is not None and v_len > cls.max_items:
+            raise errors.FrozenSetMaxLengthError(limit_value=cls.max_items)
+
+        return v
+
+
+def confrozenset(
+    item_type: Type[T], *, min_items: Optional[int] = None, max_items: Optional[int] = None
+) -> Type[FrozenSet[T]]:
+    # __args__ is needed to conform to typing generics api
+    namespace = {'min_items': min_items, 'max_items': max_items, 'item_type': item_type, '__args__': [item_type]}
+    # We use new_class to be able to deal with Generic types
+    return new_class('ConstrainedFrozenSetValue', (ConstrainedFrozenSet,), {}, lambda ns: ns.update(namespace))
+
+
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ LIST TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+
+# This types superclass should be List[T], but cython chokes on that...
+class ConstrainedList(list):  # type: ignore
+    # Needed for pydantic to detect that this is a list
+    __origin__ = list
+    __args__: Tuple[Type[T], ...]  # type: ignore
+
+    min_items: Optional[int] = None
+    max_items: Optional[int] = None
+    unique_items: Optional[bool] = None
+    item_type: Type[T]  # type: ignore
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield cls.list_length_validator
+        if cls.unique_items:
+            yield cls.unique_items_validator
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        update_not_none(field_schema, minItems=cls.min_items, maxItems=cls.max_items, uniqueItems=cls.unique_items)
+
+    @classmethod
+    def list_length_validator(cls, v: 'Optional[List[T]]') -> 'Optional[List[T]]':
+        if v is None:
+            return None
+
+        v = list_validator(v)
+        v_len = len(v)
+
+        if cls.min_items is not None and v_len < cls.min_items:
+            raise errors.ListMinLengthError(limit_value=cls.min_items)
+
+        if cls.max_items is not None and v_len > cls.max_items:
+            raise errors.ListMaxLengthError(limit_value=cls.max_items)
+
+        return v
+
+    @classmethod
+    def unique_items_validator(cls, v: 'Optional[List[T]]') -> 'Optional[List[T]]':
+        if v is None:
+            return None
+
+        for i, value in enumerate(v, start=1):
+            if value in v[i:]:
+                raise errors.ListUniqueItemsError()
+
+        return v
+
+
+def conlist(
+    item_type: Type[T], *, min_items: Optional[int] = None, max_items: Optional[int] = None, unique_items: bool = None
+) -> Type[List[T]]:
+    # __args__ is needed to conform to typing generics api
+    namespace = dict(
+        min_items=min_items, max_items=max_items, unique_items=unique_items, item_type=item_type, __args__=(item_type,)
+    )
+    # We use new_class to be able to deal with Generic types
+    return new_class('ConstrainedListValue', (ConstrainedList,), {}, lambda ns: ns.update(namespace))
+
+
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ PYOBJECT TYPE ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+
+if TYPE_CHECKING:
+    PyObject = Callable[..., Any]
+else:
+
+    class PyObject:
+        validate_always = True
+
+        @classmethod
+        def __get_validators__(cls) -> 'CallableGenerator':
+            yield cls.validate
+
+        @classmethod
+        def validate(cls, value: Any) -> Any:
+            if isinstance(value, Callable):
+                return value
+
+            try:
+                value = str_validator(value)
+            except errors.StrError:
+                raise errors.PyObjectError(error_message='value is neither a valid import path not a valid callable')
+
+            try:
+                return import_string(value)
+            except ImportError as e:
+                raise errors.PyObjectError(error_message=str(e))
+
+
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ DECIMAL TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+
+class ConstrainedDecimal(Decimal, metaclass=ConstrainedNumberMeta):
+    gt: OptionalIntFloatDecimal = None
+    ge: OptionalIntFloatDecimal = None
+    lt: OptionalIntFloatDecimal = None
+    le: OptionalIntFloatDecimal = None
+    max_digits: OptionalInt = None
+    decimal_places: OptionalInt = None
+    multiple_of: OptionalIntFloatDecimal = None
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        update_not_none(
+            field_schema,
+            exclusiveMinimum=cls.gt,
+            exclusiveMaximum=cls.lt,
+            minimum=cls.ge,
+            maximum=cls.le,
+            multipleOf=cls.multiple_of,
+        )
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield decimal_validator
+        yield number_size_validator
+        yield number_multiple_validator
+        yield cls.validate
+
+    @classmethod
+    def validate(cls, value: Decimal) -> Decimal:
+        try:
+            normalized_value = value.normalize()
+        except InvalidOperation:
+            normalized_value = value
+        digit_tuple, exponent = normalized_value.as_tuple()[1:]
+        if exponent in {'F', 'n', 'N'}:
+            raise errors.DecimalIsNotFiniteError()
+
+        if exponent >= 0:
+            # A positive exponent adds that many trailing zeros.
+            digits = len(digit_tuple) + exponent
+            decimals = 0
+        else:
+            # If the absolute value of the negative exponent is larger than the
+            # number of digits, then it's the same as the number of digits,
+            # because it'll consume all of the digits in digit_tuple and then
+            # add abs(exponent) - len(digit_tuple) leading zeros after the
+            # decimal point.
+            if abs(exponent) > len(digit_tuple):
+                digits = decimals = abs(exponent)
+            else:
+                digits = len(digit_tuple)
+                decimals = abs(exponent)
+        whole_digits = digits - decimals
+
+        if cls.max_digits is not None and digits > cls.max_digits:
+            raise errors.DecimalMaxDigitsError(max_digits=cls.max_digits)
+
+        if cls.decimal_places is not None and decimals > cls.decimal_places:
+            raise errors.DecimalMaxPlacesError(decimal_places=cls.decimal_places)
+
+        if cls.max_digits is not None and cls.decimal_places is not None:
+            expected = cls.max_digits - cls.decimal_places
+            if whole_digits > expected:
+                raise errors.DecimalWholeDigitsError(whole_digits=expected)
+
+        return value
+
+
+def condecimal(
+    *,
+    gt: Decimal = None,
+    ge: Decimal = None,
+    lt: Decimal = None,
+    le: Decimal = None,
+    max_digits: Optional[int] = None,
+    decimal_places: Optional[int] = None,
+    multiple_of: Decimal = None,
+) -> Type[Decimal]:
+    # use kwargs then define conf in a dict to aid with IDE type hinting
+    namespace = dict(
+        gt=gt, ge=ge, lt=lt, le=le, max_digits=max_digits, decimal_places=decimal_places, multiple_of=multiple_of
+    )
+    return type('ConstrainedDecimalValue', (ConstrainedDecimal,), namespace)
+
+
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ UUID TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+if TYPE_CHECKING:
+    UUID1 = UUID
+    UUID3 = UUID
+    UUID4 = UUID
+    UUID5 = UUID
+else:
+
+    class UUID1(UUID):
+        _required_version = 1
+
+        @classmethod
+        def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+            field_schema.update(type='string', format=f'uuid{cls._required_version}')
+
+    class UUID3(UUID1):
+        _required_version = 3
+
+    class UUID4(UUID1):
+        _required_version = 4
+
+    class UUID5(UUID1):
+        _required_version = 5
+
+
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ PATH TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+if TYPE_CHECKING:
+    FilePath = Path
+    DirectoryPath = Path
+else:
+
+    class FilePath(Path):
+        @classmethod
+        def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+            field_schema.update(format='file-path')
+
+        @classmethod
+        def __get_validators__(cls) -> 'CallableGenerator':
+            yield path_validator
+            yield path_exists_validator
+            yield cls.validate
+
+        @classmethod
+        def validate(cls, value: Path) -> Path:
+            if not value.is_file():
+                raise errors.PathNotAFileError(path=value)
+
+            return value
+
+    class DirectoryPath(Path):
+        @classmethod
+        def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+            field_schema.update(format='directory-path')
+
+        @classmethod
+        def __get_validators__(cls) -> 'CallableGenerator':
+            yield path_validator
+            yield path_exists_validator
+            yield cls.validate
+
+        @classmethod
+        def validate(cls, value: Path) -> Path:
+            if not value.is_dir():
+                raise errors.PathNotADirectoryError(path=value)
+
+            return value
+
+
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ JSON TYPE ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+
+class JsonWrapper:
+    pass
+
+
+class JsonMeta(type):
+    def __getitem__(self, t: Type[Any]) -> Type[JsonWrapper]:
+        if t is Any:
+            return Json  # allow Json[Any] to replecate plain Json
+        return _registered(type('JsonWrapperValue', (JsonWrapper,), {'inner_type': t}))
+
+
+if TYPE_CHECKING:
+    Json = Annotated[T, ...]  # Json[list[str]] will be recognized by type checkers as list[str]
+
+else:
+
+    class Json(metaclass=JsonMeta):
+        @classmethod
+        def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+            field_schema.update(type='string', format='json-string')
+
+
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ SECRET TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+
+class SecretField(abc.ABC):
+    """
+    Note: this should be implemented as a generic like `SecretField(ABC, Generic[T])`,
+          the `__init__()` should be part of the abstract class and the
+          `get_secret_value()` method should use the generic `T` type.
+
+          However Cython doesn't support very well generics at the moment and
+          the generated code fails to be imported (see
+          https://github.com/cython/cython/issues/2753).
+    """
+
+    def __eq__(self, other: Any) -> bool:
+        return isinstance(other, self.__class__) and self.get_secret_value() == other.get_secret_value()
+
+    def __str__(self) -> str:
+        return '**********' if self.get_secret_value() else ''
+
+    def __hash__(self) -> int:
+        return hash(self.get_secret_value())
+
+    @abc.abstractmethod
+    def get_secret_value(self) -> Any:  # pragma: no cover
+        ...
+
+
+class SecretStr(SecretField):
+    min_length: OptionalInt = None
+    max_length: OptionalInt = None
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        update_not_none(
+            field_schema,
+            type='string',
+            writeOnly=True,
+            format='password',
+            minLength=cls.min_length,
+            maxLength=cls.max_length,
+        )
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield cls.validate
+        yield constr_length_validator
+
+    @classmethod
+    def validate(cls, value: Any) -> 'SecretStr':
+        if isinstance(value, cls):
+            return value
+        value = str_validator(value)
+        return cls(value)
+
+    def __init__(self, value: str):
+        self._secret_value = value
+
+    def __repr__(self) -> str:
+        return f"SecretStr('{self}')"
+
+    def __len__(self) -> int:
+        return len(self._secret_value)
+
+    def display(self) -> str:
+        warnings.warn('`secret_str.display()` is deprecated, use `str(secret_str)` instead', DeprecationWarning)
+        return str(self)
+
+    def get_secret_value(self) -> str:
+        return self._secret_value
+
+
+class SecretBytes(SecretField):
+    min_length: OptionalInt = None
+    max_length: OptionalInt = None
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        update_not_none(
+            field_schema,
+            type='string',
+            writeOnly=True,
+            format='password',
+            minLength=cls.min_length,
+            maxLength=cls.max_length,
+        )
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield cls.validate
+        yield constr_length_validator
+
+    @classmethod
+    def validate(cls, value: Any) -> 'SecretBytes':
+        if isinstance(value, cls):
+            return value
+        value = bytes_validator(value)
+        return cls(value)
+
+    def __init__(self, value: bytes):
+        self._secret_value = value
+
+    def __repr__(self) -> str:
+        return f"SecretBytes(b'{self}')"
+
+    def __len__(self) -> int:
+        return len(self._secret_value)
+
+    def display(self) -> str:
+        warnings.warn('`secret_bytes.display()` is deprecated, use `str(secret_bytes)` instead', DeprecationWarning)
+        return str(self)
+
+    def get_secret_value(self) -> bytes:
+        return self._secret_value
+
+
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ PAYMENT CARD TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+
+class PaymentCardBrand(str, Enum):
+    # If you add another card type, please also add it to the
+    # Hypothesis strategy in `pydantic._hypothesis_plugin`.
+    amex = 'American Express'
+    mastercard = 'Mastercard'
+    visa = 'Visa'
+    other = 'other'
+
+    def __str__(self) -> str:
+        return self.value
+
+
+class PaymentCardNumber(str):
+    """
+    Based on: https://en.wikipedia.org/wiki/Payment_card_number
+    """
+
+    strip_whitespace: ClassVar[bool] = True
+    min_length: ClassVar[int] = 12
+    max_length: ClassVar[int] = 19
+    bin: str
+    last4: str
+    brand: PaymentCardBrand
+
+    def __init__(self, card_number: str):
+        self.bin = card_number[:6]
+        self.last4 = card_number[-4:]
+        self.brand = self._get_brand(card_number)
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield str_validator
+        yield constr_strip_whitespace
+        yield constr_length_validator
+        yield cls.validate_digits
+        yield cls.validate_luhn_check_digit
+        yield cls
+        yield cls.validate_length_for_brand
+
+    @property
+    def masked(self) -> str:
+        num_masked = len(self) - 10  # len(bin) + len(last4) == 10
+        return f'{self.bin}{"*" * num_masked}{self.last4}'
+
+    @classmethod
+    def validate_digits(cls, card_number: str) -> str:
+        if not card_number.isdigit():
+            raise errors.NotDigitError
+        return card_number
+
+    @classmethod
+    def validate_luhn_check_digit(cls, card_number: str) -> str:
+        """
+        Based on: https://en.wikipedia.org/wiki/Luhn_algorithm
+        """
+        sum_ = int(card_number[-1])
+        length = len(card_number)
+        parity = length % 2
+        for i in range(length - 1):
+            digit = int(card_number[i])
+            if i % 2 == parity:
+                digit *= 2
+            if digit > 9:
+                digit -= 9
+            sum_ += digit
+        valid = sum_ % 10 == 0
+        if not valid:
+            raise errors.LuhnValidationError
+        return card_number
+
+    @classmethod
+    def validate_length_for_brand(cls, card_number: 'PaymentCardNumber') -> 'PaymentCardNumber':
+        """
+        Validate length based on BIN for major brands:
+        https://en.wikipedia.org/wiki/Payment_card_number#Issuer_identification_number_(IIN)
+        """
+        required_length: Union[None, int, str] = None
+        if card_number.brand in PaymentCardBrand.mastercard:
+            required_length = 16
+            valid = len(card_number) == required_length
+        elif card_number.brand == PaymentCardBrand.visa:
+            required_length = '13, 16 or 19'
+            valid = len(card_number) in {13, 16, 19}
+        elif card_number.brand == PaymentCardBrand.amex:
+            required_length = 15
+            valid = len(card_number) == required_length
+        else:
+            valid = True
+        if not valid:
+            raise errors.InvalidLengthForBrand(brand=card_number.brand, required_length=required_length)
+        return card_number
+
+    @staticmethod
+    def _get_brand(card_number: str) -> PaymentCardBrand:
+        if card_number[0] == '4':
+            brand = PaymentCardBrand.visa
+        elif 51 <= int(card_number[:2]) <= 55:
+            brand = PaymentCardBrand.mastercard
+        elif card_number[:2] in {'34', '37'}:
+            brand = PaymentCardBrand.amex
+        else:
+            brand = PaymentCardBrand.other
+        return brand
+
+
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ BYTE SIZE TYPE ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+BYTE_SIZES = {
+    'b': 1,
+    'kb': 10**3,
+    'mb': 10**6,
+    'gb': 10**9,
+    'tb': 10**12,
+    'pb': 10**15,
+    'eb': 10**18,
+    'kib': 2**10,
+    'mib': 2**20,
+    'gib': 2**30,
+    'tib': 2**40,
+    'pib': 2**50,
+    'eib': 2**60,
+}
+BYTE_SIZES.update({k.lower()[0]: v for k, v in BYTE_SIZES.items() if 'i' not in k})
+byte_string_re = re.compile(r'^\s*(\d*\.?\d+)\s*(\w+)?', re.IGNORECASE)
+
+
+class ByteSize(int):
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield cls.validate
+
+    @classmethod
+    def validate(cls, v: StrIntFloat) -> 'ByteSize':
+        try:
+            return cls(int(v))
+        except ValueError:
+            pass
+
+        str_match = byte_string_re.match(str(v))
+        if str_match is None:
+            raise errors.InvalidByteSize()
+
+        scalar, unit = str_match.groups()
+        if unit is None:
+            unit = 'b'
+
+        try:
+            unit_mult = BYTE_SIZES[unit.lower()]
+        except KeyError:
+            raise errors.InvalidByteSizeUnit(unit=unit)
+
+        return cls(int(float(scalar) * unit_mult))
+
+    def human_readable(self, decimal: bool = False) -> str:
+        if decimal:
+            divisor = 1000
+            units = ['B', 'KB', 'MB', 'GB', 'TB', 'PB']
+            final_unit = 'EB'
+        else:
+            divisor = 1024
+            units = ['B', 'KiB', 'MiB', 'GiB', 'TiB', 'PiB']
+            final_unit = 'EiB'
+
+        num = float(self)
+        for unit in units:
+            if abs(num) < divisor:
+                return f'{num:0.1f}{unit}'
+            num /= divisor
+
+        return f'{num:0.1f}{final_unit}'
+
+    def to(self, unit: str) -> float:
+        try:
+            unit_div = BYTE_SIZES[unit.lower()]
+        except KeyError:
+            raise errors.InvalidByteSizeUnit(unit=unit)
+
+        return self / unit_div
+
+
+# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ DATE TYPES ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+if TYPE_CHECKING:
+    PastDate = date
+    FutureDate = date
+else:
+
+    class PastDate(date):
+        @classmethod
+        def __get_validators__(cls) -> 'CallableGenerator':
+            yield parse_date
+            yield cls.validate
+
+        @classmethod
+        def validate(cls, value: date) -> date:
+            if value >= date.today():
+                raise errors.DateNotInThePastError()
+
+            return value
+
+    class FutureDate(date):
+        @classmethod
+        def __get_validators__(cls) -> 'CallableGenerator':
+            yield parse_date
+            yield cls.validate
+
+        @classmethod
+        def validate(cls, value: date) -> date:
+            if value <= date.today():
+                raise errors.DateNotInTheFutureError()
+
+            return value
+
+
+class ConstrainedDate(date, metaclass=ConstrainedNumberMeta):
+    gt: OptionalDate = None
+    ge: OptionalDate = None
+    lt: OptionalDate = None
+    le: OptionalDate = None
+
+    @classmethod
+    def __modify_schema__(cls, field_schema: Dict[str, Any]) -> None:
+        update_not_none(field_schema, exclusiveMinimum=cls.gt, exclusiveMaximum=cls.lt, minimum=cls.ge, maximum=cls.le)
+
+    @classmethod
+    def __get_validators__(cls) -> 'CallableGenerator':
+        yield parse_date
+        yield number_size_validator
+
+
+def condate(
+    *,
+    gt: date = None,
+    ge: date = None,
+    lt: date = None,
+    le: date = None,
+) -> Type[date]:
+    # use kwargs then define conf in a dict to aid with IDE type hinting
+    namespace = dict(gt=gt, ge=ge, lt=lt, le=le)
+    return type('ConstrainedDateValue', (ConstrainedDate,), namespace)
diff --git a/lib/pydantic/v1/typing.py b/lib/pydantic/v1/typing.py
new file mode 100644
index 00000000..a690a053
--- /dev/null
+++ b/lib/pydantic/v1/typing.py
@@ -0,0 +1,603 @@
+import sys
+import typing
+from collections.abc import Callable
+from os import PathLike
+from typing import (  # type: ignore
+    TYPE_CHECKING,
+    AbstractSet,
+    Any,
+    Callable as TypingCallable,
+    ClassVar,
+    Dict,
+    ForwardRef,
+    Generator,
+    Iterable,
+    List,
+    Mapping,
+    NewType,
+    Optional,
+    Sequence,
+    Set,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+    _eval_type,
+    cast,
+    get_type_hints,
+)
+
+from typing_extensions import (
+    Annotated,
+    Final,
+    Literal,
+    NotRequired as TypedDictNotRequired,
+    Required as TypedDictRequired,
+)
+
+try:
+    from typing import _TypingBase as typing_base  # type: ignore
+except ImportError:
+    from typing import _Final as typing_base  # type: ignore
+
+try:
+    from typing import GenericAlias as TypingGenericAlias  # type: ignore
+except ImportError:
+    # python < 3.9 does not have GenericAlias (list[int], tuple[str, ...] and so on)
+    TypingGenericAlias = ()
+
+try:
+    from types import UnionType as TypesUnionType  # type: ignore
+except ImportError:
+    # python < 3.10 does not have UnionType (str | int, byte | bool and so on)
+    TypesUnionType = ()
+
+
+if sys.version_info < (3, 9):
+
+    def evaluate_forwardref(type_: ForwardRef, globalns: Any, localns: Any) -> Any:
+        return type_._evaluate(globalns, localns)
+
+else:
+
+    def evaluate_forwardref(type_: ForwardRef, globalns: Any, localns: Any) -> Any:
+        # Even though it is the right signature for python 3.9, mypy complains with
+        # `error: Too many arguments for "_evaluate" of "ForwardRef"` hence the cast...
+        return cast(Any, type_)._evaluate(globalns, localns, set())
+
+
+if sys.version_info < (3, 9):
+    # Ensure we always get all the whole `Annotated` hint, not just the annotated type.
+    # For 3.7 to 3.8, `get_type_hints` doesn't recognize `typing_extensions.Annotated`,
+    # so it already returns the full annotation
+    get_all_type_hints = get_type_hints
+
+else:
+
+    def get_all_type_hints(obj: Any, globalns: Any = None, localns: Any = None) -> Any:
+        return get_type_hints(obj, globalns, localns, include_extras=True)
+
+
+_T = TypeVar('_T')
+
+AnyCallable = TypingCallable[..., Any]
+NoArgAnyCallable = TypingCallable[[], Any]
+
+# workaround for https://github.com/python/mypy/issues/9496
+AnyArgTCallable = TypingCallable[..., _T]
+
+
+# Annotated[...] is implemented by returning an instance of one of these classes, depending on
+# python/typing_extensions version.
+AnnotatedTypeNames = {'AnnotatedMeta', '_AnnotatedAlias'}
+
+
+LITERAL_TYPES: Set[Any] = {Literal}
+if hasattr(typing, 'Literal'):
+    LITERAL_TYPES.add(typing.Literal)
+
+
+if sys.version_info < (3, 8):
+
+    def get_origin(t: Type[Any]) -> Optional[Type[Any]]:
+        if type(t).__name__ in AnnotatedTypeNames:
+            # weirdly this is a runtime requirement, as well as for mypy
+            return cast(Type[Any], Annotated)
+        return getattr(t, '__origin__', None)
+
+else:
+    from typing import get_origin as _typing_get_origin
+
+    def get_origin(tp: Type[Any]) -> Optional[Type[Any]]:
+        """
+        We can't directly use `typing.get_origin` since we need a fallback to support
+        custom generic classes like `ConstrainedList`
+        It should be useless once https://github.com/cython/cython/issues/3537 is
+        solved and https://github.com/pydantic/pydantic/pull/1753 is merged.
+        """
+        if type(tp).__name__ in AnnotatedTypeNames:
+            return cast(Type[Any], Annotated)  # mypy complains about _SpecialForm
+        return _typing_get_origin(tp) or getattr(tp, '__origin__', None)
+
+
+if sys.version_info < (3, 8):
+    from typing import _GenericAlias
+
+    def get_args(t: Type[Any]) -> Tuple[Any, ...]:
+        """Compatibility version of get_args for python 3.7.
+
+        Mostly compatible with the python 3.8 `typing` module version
+        and able to handle almost all use cases.
+        """
+        if type(t).__name__ in AnnotatedTypeNames:
+            return t.__args__ + t.__metadata__
+        if isinstance(t, _GenericAlias):
+            res = t.__args__
+            if t.__origin__ is Callable and res and res[0] is not Ellipsis:
+                res = (list(res[:-1]), res[-1])
+            return res
+        return getattr(t, '__args__', ())
+
+else:
+    from typing import get_args as _typing_get_args
+
+    def _generic_get_args(tp: Type[Any]) -> Tuple[Any, ...]:
+        """
+        In python 3.9, `typing.Dict`, `typing.List`, ...
+        do have an empty `__args__` by default (instead of the generic ~T for example).
+        In order to still support `Dict` for example and consider it as `Dict[Any, Any]`,
+        we retrieve the `_nparams` value that tells us how many parameters it needs.
+        """
+        if hasattr(tp, '_nparams'):
+            return (Any,) * tp._nparams
+        # Special case for `tuple[()]`, which used to return ((),) with `typing.Tuple`
+        # in python 3.10- but now returns () for `tuple` and `Tuple`.
+        # This will probably be clarified in pydantic v2
+        try:
+            if tp == Tuple[()] or sys.version_info >= (3, 9) and tp == tuple[()]:  # type: ignore[misc]
+                return ((),)
+        # there is a TypeError when compiled with cython
+        except TypeError:  # pragma: no cover
+            pass
+        return ()
+
+    def get_args(tp: Type[Any]) -> Tuple[Any, ...]:
+        """Get type arguments with all substitutions performed.
+
+        For unions, basic simplifications used by Union constructor are performed.
+        Examples::
+            get_args(Dict[str, int]) == (str, int)
+            get_args(int) == ()
+            get_args(Union[int, Union[T, int], str][int]) == (int, str)
+            get_args(Union[int, Tuple[T, int]][str]) == (int, Tuple[str, int])
+            get_args(Callable[[], T][int]) == ([], int)
+        """
+        if type(tp).__name__ in AnnotatedTypeNames:
+            return tp.__args__ + tp.__metadata__
+        # the fallback is needed for the same reasons as `get_origin` (see above)
+        return _typing_get_args(tp) or getattr(tp, '__args__', ()) or _generic_get_args(tp)
+
+
+if sys.version_info < (3, 9):
+
+    def convert_generics(tp: Type[Any]) -> Type[Any]:
+        """Python 3.9 and older only supports generics from `typing` module.
+        They convert strings to ForwardRef automatically.
+
+        Examples::
+            typing.List['Hero'] == typing.List[ForwardRef('Hero')]
+        """
+        return tp
+
+else:
+    from typing import _UnionGenericAlias  # type: ignore
+
+    from typing_extensions import _AnnotatedAlias
+
+    def convert_generics(tp: Type[Any]) -> Type[Any]:
+        """
+        Recursively searches for `str` type hints and replaces them with ForwardRef.
+
+        Examples::
+            convert_generics(list['Hero']) == list[ForwardRef('Hero')]
+            convert_generics(dict['Hero', 'Team']) == dict[ForwardRef('Hero'), ForwardRef('Team')]
+            convert_generics(typing.Dict['Hero', 'Team']) == typing.Dict[ForwardRef('Hero'), ForwardRef('Team')]
+            convert_generics(list[str | 'Hero'] | int) == list[str | ForwardRef('Hero')] | int
+        """
+        origin = get_origin(tp)
+        if not origin or not hasattr(tp, '__args__'):
+            return tp
+
+        args = get_args(tp)
+
+        # typing.Annotated needs special treatment
+        if origin is Annotated:
+            return _AnnotatedAlias(convert_generics(args[0]), args[1:])
+
+        # recursively replace `str` instances inside of `GenericAlias` with `ForwardRef(arg)`
+        converted = tuple(
+            ForwardRef(arg) if isinstance(arg, str) and isinstance(tp, TypingGenericAlias) else convert_generics(arg)
+            for arg in args
+        )
+
+        if converted == args:
+            return tp
+        elif isinstance(tp, TypingGenericAlias):
+            return TypingGenericAlias(origin, converted)
+        elif isinstance(tp, TypesUnionType):
+            # recreate types.UnionType (PEP604, Python >= 3.10)
+            return _UnionGenericAlias(origin, converted)
+        else:
+            try:
+                setattr(tp, '__args__', converted)
+            except AttributeError:
+                pass
+            return tp
+
+
+if sys.version_info < (3, 10):
+
+    def is_union(tp: Optional[Type[Any]]) -> bool:
+        return tp is Union
+
+    WithArgsTypes = (TypingGenericAlias,)
+
+else:
+    import types
+    import typing
+
+    def is_union(tp: Optional[Type[Any]]) -> bool:
+        return tp is Union or tp is types.UnionType  # noqa: E721
+
+    WithArgsTypes = (typing._GenericAlias, types.GenericAlias, types.UnionType)
+
+
+StrPath = Union[str, PathLike]
+
+
+if TYPE_CHECKING:
+    from .fields import ModelField
+
+    TupleGenerator = Generator[Tuple[str, Any], None, None]
+    DictStrAny = Dict[str, Any]
+    DictAny = Dict[Any, Any]
+    SetStr = Set[str]
+    ListStr = List[str]
+    IntStr = Union[int, str]
+    AbstractSetIntStr = AbstractSet[IntStr]
+    DictIntStrAny = Dict[IntStr, Any]
+    MappingIntStrAny = Mapping[IntStr, Any]
+    CallableGenerator = Generator[AnyCallable, None, None]
+    ReprArgs = Sequence[Tuple[Optional[str], Any]]
+
+    MYPY = False
+    if MYPY:
+        AnyClassMethod = classmethod[Any]
+    else:
+        # classmethod[TargetType, CallableParamSpecType, CallableReturnType]
+        AnyClassMethod = classmethod[Any, Any, Any]
+
+__all__ = (
+    'AnyCallable',
+    'NoArgAnyCallable',
+    'NoneType',
+    'is_none_type',
+    'display_as_type',
+    'resolve_annotations',
+    'is_callable_type',
+    'is_literal_type',
+    'all_literal_values',
+    'is_namedtuple',
+    'is_typeddict',
+    'is_typeddict_special',
+    'is_new_type',
+    'new_type_supertype',
+    'is_classvar',
+    'is_finalvar',
+    'update_field_forward_refs',
+    'update_model_forward_refs',
+    'TupleGenerator',
+    'DictStrAny',
+    'DictAny',
+    'SetStr',
+    'ListStr',
+    'IntStr',
+    'AbstractSetIntStr',
+    'DictIntStrAny',
+    'CallableGenerator',
+    'ReprArgs',
+    'AnyClassMethod',
+    'CallableGenerator',
+    'WithArgsTypes',
+    'get_args',
+    'get_origin',
+    'get_sub_types',
+    'typing_base',
+    'get_all_type_hints',
+    'is_union',
+    'StrPath',
+    'MappingIntStrAny',
+)
+
+
+NoneType = None.__class__
+
+
+NONE_TYPES: Tuple[Any, Any, Any] = (None, NoneType, Literal[None])
+
+
+if sys.version_info < (3, 8):
+    # Even though this implementation is slower, we need it for python 3.7:
+    # In python 3.7 "Literal" is not a builtin type and uses a different
+    # mechanism.
+    # for this reason `Literal[None] is Literal[None]` evaluates to `False`,
+    # breaking the faster implementation used for the other python versions.
+
+    def is_none_type(type_: Any) -> bool:
+        return type_ in NONE_TYPES
+
+elif sys.version_info[:2] == (3, 8):
+
+    def is_none_type(type_: Any) -> bool:
+        for none_type in NONE_TYPES:
+            if type_ is none_type:
+                return True
+        # With python 3.8, specifically 3.8.10, Literal "is" check sare very flakey
+        # can change on very subtle changes like use of types in other modules,
+        # hopefully this check avoids that issue.
+        if is_literal_type(type_):  # pragma: no cover
+            return all_literal_values(type_) == (None,)
+        return False
+
+else:
+
+    def is_none_type(type_: Any) -> bool:
+        return type_ in NONE_TYPES
+
+
+def display_as_type(v: Type[Any]) -> str:
+    if not isinstance(v, typing_base) and not isinstance(v, WithArgsTypes) and not isinstance(v, type):
+        v = v.__class__
+
+    if is_union(get_origin(v)):
+        return f'Union[{", ".join(map(display_as_type, get_args(v)))}]'
+
+    if isinstance(v, WithArgsTypes):
+        # Generic alias are constructs like `list[int]`
+        return str(v).replace('typing.', '')
+
+    try:
+        return v.__name__
+    except AttributeError:
+        # happens with typing objects
+        return str(v).replace('typing.', '')
+
+
+def resolve_annotations(raw_annotations: Dict[str, Type[Any]], module_name: Optional[str]) -> Dict[str, Type[Any]]:
+    """
+    Partially taken from typing.get_type_hints.
+
+    Resolve string or ForwardRef annotations into type objects if possible.
+    """
+    base_globals: Optional[Dict[str, Any]] = None
+    if module_name:
+        try:
+            module = sys.modules[module_name]
+        except KeyError:
+            # happens occasionally, see https://github.com/pydantic/pydantic/issues/2363
+            pass
+        else:
+            base_globals = module.__dict__
+
+    annotations = {}
+    for name, value in raw_annotations.items():
+        if isinstance(value, str):
+            if (3, 10) > sys.version_info >= (3, 9, 8) or sys.version_info >= (3, 10, 1):
+                value = ForwardRef(value, is_argument=False, is_class=True)
+            else:
+                value = ForwardRef(value, is_argument=False)
+        try:
+            value = _eval_type(value, base_globals, None)
+        except NameError:
+            # this is ok, it can be fixed with update_forward_refs
+            pass
+        annotations[name] = value
+    return annotations
+
+
+def is_callable_type(type_: Type[Any]) -> bool:
+    return type_ is Callable or get_origin(type_) is Callable
+
+
+def is_literal_type(type_: Type[Any]) -> bool:
+    return Literal is not None and get_origin(type_) in LITERAL_TYPES
+
+
+def literal_values(type_: Type[Any]) -> Tuple[Any, ...]:
+    return get_args(type_)
+
+
+def all_literal_values(type_: Type[Any]) -> Tuple[Any, ...]:
+    """
+    This method is used to retrieve all Literal values as
+    Literal can be used recursively (see https://www.python.org/dev/peps/pep-0586)
+    e.g. `Literal[Literal[Literal[1, 2, 3], "foo"], 5, None]`
+    """
+    if not is_literal_type(type_):
+        return (type_,)
+
+    values = literal_values(type_)
+    return tuple(x for value in values for x in all_literal_values(value))
+
+
+def is_namedtuple(type_: Type[Any]) -> bool:
+    """
+    Check if a given class is a named tuple.
+    It can be either a `typing.NamedTuple` or `collections.namedtuple`
+    """
+    from .utils import lenient_issubclass
+
+    return lenient_issubclass(type_, tuple) and hasattr(type_, '_fields')
+
+
+def is_typeddict(type_: Type[Any]) -> bool:
+    """
+    Check if a given class is a typed dict (from `typing` or `typing_extensions`)
+    In 3.10, there will be a public method (https://docs.python.org/3.10/library/typing.html#typing.is_typeddict)
+    """
+    from .utils import lenient_issubclass
+
+    return lenient_issubclass(type_, dict) and hasattr(type_, '__total__')
+
+
+def _check_typeddict_special(type_: Any) -> bool:
+    return type_ is TypedDictRequired or type_ is TypedDictNotRequired
+
+
+def is_typeddict_special(type_: Any) -> bool:
+    """
+    Check if type is a TypedDict special form (Required or NotRequired).
+    """
+    return _check_typeddict_special(type_) or _check_typeddict_special(get_origin(type_))
+
+
+test_type = NewType('test_type', str)
+
+
+def is_new_type(type_: Type[Any]) -> bool:
+    """
+    Check whether type_ was created using typing.NewType
+    """
+    return isinstance(type_, test_type.__class__) and hasattr(type_, '__supertype__')  # type: ignore
+
+
+def new_type_supertype(type_: Type[Any]) -> Type[Any]:
+    while hasattr(type_, '__supertype__'):
+        type_ = type_.__supertype__
+    return type_
+
+
+def _check_classvar(v: Optional[Type[Any]]) -> bool:
+    if v is None:
+        return False
+
+    return v.__class__ == ClassVar.__class__ and getattr(v, '_name', None) == 'ClassVar'
+
+
+def _check_finalvar(v: Optional[Type[Any]]) -> bool:
+    """
+    Check if a given type is a `typing.Final` type.
+    """
+    if v is None:
+        return False
+
+    return v.__class__ == Final.__class__ and (sys.version_info < (3, 8) or getattr(v, '_name', None) == 'Final')
+
+
+def is_classvar(ann_type: Type[Any]) -> bool:
+    if _check_classvar(ann_type) or _check_classvar(get_origin(ann_type)):
+        return True
+
+    # this is an ugly workaround for class vars that contain forward references and are therefore themselves
+    # forward references, see #3679
+    if ann_type.__class__ == ForwardRef and ann_type.__forward_arg__.startswith('ClassVar['):
+        return True
+
+    return False
+
+
+def is_finalvar(ann_type: Type[Any]) -> bool:
+    return _check_finalvar(ann_type) or _check_finalvar(get_origin(ann_type))
+
+
+def update_field_forward_refs(field: 'ModelField', globalns: Any, localns: Any) -> None:
+    """
+    Try to update ForwardRefs on fields based on this ModelField, globalns and localns.
+    """
+    prepare = False
+    if field.type_.__class__ == ForwardRef:
+        prepare = True
+        field.type_ = evaluate_forwardref(field.type_, globalns, localns or None)
+    if field.outer_type_.__class__ == ForwardRef:
+        prepare = True
+        field.outer_type_ = evaluate_forwardref(field.outer_type_, globalns, localns or None)
+    if prepare:
+        field.prepare()
+
+    if field.sub_fields:
+        for sub_f in field.sub_fields:
+            update_field_forward_refs(sub_f, globalns=globalns, localns=localns)
+
+    if field.discriminator_key is not None:
+        field.prepare_discriminated_union_sub_fields()
+
+
+def update_model_forward_refs(
+    model: Type[Any],
+    fields: Iterable['ModelField'],
+    json_encoders: Dict[Union[Type[Any], str, ForwardRef], AnyCallable],
+    localns: 'DictStrAny',
+    exc_to_suppress: Tuple[Type[BaseException], ...] = (),
+) -> None:
+    """
+    Try to update model fields ForwardRefs based on model and localns.
+    """
+    if model.__module__ in sys.modules:
+        globalns = sys.modules[model.__module__].__dict__.copy()
+    else:
+        globalns = {}
+
+    globalns.setdefault(model.__name__, model)
+
+    for f in fields:
+        try:
+            update_field_forward_refs(f, globalns=globalns, localns=localns)
+        except exc_to_suppress:
+            pass
+
+    for key in set(json_encoders.keys()):
+        if isinstance(key, str):
+            fr: ForwardRef = ForwardRef(key)
+        elif isinstance(key, ForwardRef):
+            fr = key
+        else:
+            continue
+
+        try:
+            new_key = evaluate_forwardref(fr, globalns, localns or None)
+        except exc_to_suppress:  # pragma: no cover
+            continue
+
+        json_encoders[new_key] = json_encoders.pop(key)
+
+
+def get_class(type_: Type[Any]) -> Union[None, bool, Type[Any]]:
+    """
+    Tries to get the class of a Type[T] annotation. Returns True if Type is used
+    without brackets. Otherwise returns None.
+    """
+    if type_ is type:
+        return True
+
+    if get_origin(type_) is None:
+        return None
+
+    args = get_args(type_)
+    if not args or not isinstance(args[0], type):
+        return True
+    else:
+        return args[0]
+
+
+def get_sub_types(tp: Any) -> List[Any]:
+    """
+    Return all the types that are allowed by type `tp`
+    `tp` can be a `Union` of allowed types or an `Annotated` type
+    """
+    origin = get_origin(tp)
+    if origin is Annotated:
+        return get_sub_types(get_args(tp)[0])
+    elif is_union(origin):
+        return [x for t in get_args(tp) for x in get_sub_types(t)]
+    else:
+        return [tp]
diff --git a/lib/pydantic/v1/utils.py b/lib/pydantic/v1/utils.py
new file mode 100644
index 00000000..4d0f68ed
--- /dev/null
+++ b/lib/pydantic/v1/utils.py
@@ -0,0 +1,803 @@
+import keyword
+import warnings
+import weakref
+from collections import OrderedDict, defaultdict, deque
+from copy import deepcopy
+from itertools import islice, zip_longest
+from types import BuiltinFunctionType, CodeType, FunctionType, GeneratorType, LambdaType, ModuleType
+from typing import (
+    TYPE_CHECKING,
+    AbstractSet,
+    Any,
+    Callable,
+    Collection,
+    Dict,
+    Generator,
+    Iterable,
+    Iterator,
+    List,
+    Mapping,
+    NoReturn,
+    Optional,
+    Set,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+)
+
+from typing_extensions import Annotated
+
+from .errors import ConfigError
+from .typing import (
+    NoneType,
+    WithArgsTypes,
+    all_literal_values,
+    display_as_type,
+    get_args,
+    get_origin,
+    is_literal_type,
+    is_union,
+)
+from .version import version_info
+
+if TYPE_CHECKING:
+    from inspect import Signature
+    from pathlib import Path
+
+    from .config import BaseConfig
+    from .dataclasses import Dataclass
+    from .fields import ModelField
+    from .main import BaseModel
+    from .typing import AbstractSetIntStr, DictIntStrAny, IntStr, MappingIntStrAny, ReprArgs
+
+    RichReprResult = Iterable[Union[Any, Tuple[Any], Tuple[str, Any], Tuple[str, Any, Any]]]
+
+__all__ = (
+    'import_string',
+    'sequence_like',
+    'validate_field_name',
+    'lenient_isinstance',
+    'lenient_issubclass',
+    'in_ipython',
+    'is_valid_identifier',
+    'deep_update',
+    'update_not_none',
+    'almost_equal_floats',
+    'get_model',
+    'to_camel',
+    'is_valid_field',
+    'smart_deepcopy',
+    'PyObjectStr',
+    'Representation',
+    'GetterDict',
+    'ValueItems',
+    'version_info',  # required here to match behaviour in v1.3
+    'ClassAttribute',
+    'path_type',
+    'ROOT_KEY',
+    'get_unique_discriminator_alias',
+    'get_discriminator_alias_and_values',
+    'DUNDER_ATTRIBUTES',
+)
+
+ROOT_KEY = '__root__'
+# these are types that are returned unchanged by deepcopy
+IMMUTABLE_NON_COLLECTIONS_TYPES: Set[Type[Any]] = {
+    int,
+    float,
+    complex,
+    str,
+    bool,
+    bytes,
+    type,
+    NoneType,
+    FunctionType,
+    BuiltinFunctionType,
+    LambdaType,
+    weakref.ref,
+    CodeType,
+    # note: including ModuleType will differ from behaviour of deepcopy by not producing error.
+    # It might be not a good idea in general, but considering that this function used only internally
+    # against default values of fields, this will allow to actually have a field with module as default value
+    ModuleType,
+    NotImplemented.__class__,
+    Ellipsis.__class__,
+}
+
+# these are types that if empty, might be copied with simple copy() instead of deepcopy()
+BUILTIN_COLLECTIONS: Set[Type[Any]] = {
+    list,
+    set,
+    tuple,
+    frozenset,
+    dict,
+    OrderedDict,
+    defaultdict,
+    deque,
+}
+
+
+def import_string(dotted_path: str) -> Any:
+    """
+    Stolen approximately from django. Import a dotted module path and return the attribute/class designated by the
+    last name in the path. Raise ImportError if the import fails.
+    """
+    from importlib import import_module
+
+    try:
+        module_path, class_name = dotted_path.strip(' ').rsplit('.', 1)
+    except ValueError as e:
+        raise ImportError(f'"{dotted_path}" doesn\'t look like a module path') from e
+
+    module = import_module(module_path)
+    try:
+        return getattr(module, class_name)
+    except AttributeError as e:
+        raise ImportError(f'Module "{module_path}" does not define a "{class_name}" attribute') from e
+
+
+def truncate(v: Union[str], *, max_len: int = 80) -> str:
+    """
+    Truncate a value and add a unicode ellipsis (three dots) to the end if it was too long
+    """
+    warnings.warn('`truncate` is no-longer used by pydantic and is deprecated', DeprecationWarning)
+    if isinstance(v, str) and len(v) > (max_len - 2):
+        # -3 so quote + string + … + quote has correct length
+        return (v[: (max_len - 3)] + '…').__repr__()
+    try:
+        v = v.__repr__()
+    except TypeError:
+        v = v.__class__.__repr__(v)  # in case v is a type
+    if len(v) > max_len:
+        v = v[: max_len - 1] + '…'
+    return v
+
+
+def sequence_like(v: Any) -> bool:
+    return isinstance(v, (list, tuple, set, frozenset, GeneratorType, deque))
+
+
+def validate_field_name(bases: List[Type['BaseModel']], field_name: str) -> None:
+    """
+    Ensure that the field's name does not shadow an existing attribute of the model.
+    """
+    for base in bases:
+        if getattr(base, field_name, None):
+            raise NameError(
+                f'Field name "{field_name}" shadows a BaseModel attribute; '
+                f'use a different field name with "alias=\'{field_name}\'".'
+            )
+
+
+def lenient_isinstance(o: Any, class_or_tuple: Union[Type[Any], Tuple[Type[Any], ...], None]) -> bool:
+    try:
+        return isinstance(o, class_or_tuple)  # type: ignore[arg-type]
+    except TypeError:
+        return False
+
+
+def lenient_issubclass(cls: Any, class_or_tuple: Union[Type[Any], Tuple[Type[Any], ...], None]) -> bool:
+    try:
+        return isinstance(cls, type) and issubclass(cls, class_or_tuple)  # type: ignore[arg-type]
+    except TypeError:
+        if isinstance(cls, WithArgsTypes):
+            return False
+        raise  # pragma: no cover
+
+
+def in_ipython() -> bool:
+    """
+    Check whether we're in an ipython environment, including jupyter notebooks.
+    """
+    try:
+        eval('__IPYTHON__')
+    except NameError:
+        return False
+    else:  # pragma: no cover
+        return True
+
+
+def is_valid_identifier(identifier: str) -> bool:
+    """
+    Checks that a string is a valid identifier and not a Python keyword.
+    :param identifier: The identifier to test.
+    :return: True if the identifier is valid.
+    """
+    return identifier.isidentifier() and not keyword.iskeyword(identifier)
+
+
+KeyType = TypeVar('KeyType')
+
+
+def deep_update(mapping: Dict[KeyType, Any], *updating_mappings: Dict[KeyType, Any]) -> Dict[KeyType, Any]:
+    updated_mapping = mapping.copy()
+    for updating_mapping in updating_mappings:
+        for k, v in updating_mapping.items():
+            if k in updated_mapping and isinstance(updated_mapping[k], dict) and isinstance(v, dict):
+                updated_mapping[k] = deep_update(updated_mapping[k], v)
+            else:
+                updated_mapping[k] = v
+    return updated_mapping
+
+
+def update_not_none(mapping: Dict[Any, Any], **update: Any) -> None:
+    mapping.update({k: v for k, v in update.items() if v is not None})
+
+
+def almost_equal_floats(value_1: float, value_2: float, *, delta: float = 1e-8) -> bool:
+    """
+    Return True if two floats are almost equal
+    """
+    return abs(value_1 - value_2) <= delta
+
+
+def generate_model_signature(
+    init: Callable[..., None], fields: Dict[str, 'ModelField'], config: Type['BaseConfig']
+) -> 'Signature':
+    """
+    Generate signature for model based on its fields
+    """
+    from inspect import Parameter, Signature, signature
+
+    from .config import Extra
+
+    present_params = signature(init).parameters.values()
+    merged_params: Dict[str, Parameter] = {}
+    var_kw = None
+    use_var_kw = False
+
+    for param in islice(present_params, 1, None):  # skip self arg
+        if param.kind is param.VAR_KEYWORD:
+            var_kw = param
+            continue
+        merged_params[param.name] = param
+
+    if var_kw:  # if custom init has no var_kw, fields which are not declared in it cannot be passed through
+        allow_names = config.allow_population_by_field_name
+        for field_name, field in fields.items():
+            param_name = field.alias
+            if field_name in merged_params or param_name in merged_params:
+                continue
+            elif not is_valid_identifier(param_name):
+                if allow_names and is_valid_identifier(field_name):
+                    param_name = field_name
+                else:
+                    use_var_kw = True
+                    continue
+
+            # TODO: replace annotation with actual expected types once #1055 solved
+            kwargs = {'default': field.default} if not field.required else {}
+            merged_params[param_name] = Parameter(
+                param_name, Parameter.KEYWORD_ONLY, annotation=field.annotation, **kwargs
+            )
+
+    if config.extra is Extra.allow:
+        use_var_kw = True
+
+    if var_kw and use_var_kw:
+        # Make sure the parameter for extra kwargs
+        # does not have the same name as a field
+        default_model_signature = [
+            ('__pydantic_self__', Parameter.POSITIONAL_OR_KEYWORD),
+            ('data', Parameter.VAR_KEYWORD),
+        ]
+        if [(p.name, p.kind) for p in present_params] == default_model_signature:
+            # if this is the standard model signature, use extra_data as the extra args name
+            var_kw_name = 'extra_data'
+        else:
+            # else start from var_kw
+            var_kw_name = var_kw.name
+
+        # generate a name that's definitely unique
+        while var_kw_name in fields:
+            var_kw_name += '_'
+        merged_params[var_kw_name] = var_kw.replace(name=var_kw_name)
+
+    return Signature(parameters=list(merged_params.values()), return_annotation=None)
+
+
+def get_model(obj: Union[Type['BaseModel'], Type['Dataclass']]) -> Type['BaseModel']:
+    from .main import BaseModel
+
+    try:
+        model_cls = obj.__pydantic_model__  # type: ignore
+    except AttributeError:
+        model_cls = obj
+
+    if not issubclass(model_cls, BaseModel):
+        raise TypeError('Unsupported type, must be either BaseModel or dataclass')
+    return model_cls
+
+
+def to_camel(string: str) -> str:
+    return ''.join(word.capitalize() for word in string.split('_'))
+
+
+def to_lower_camel(string: str) -> str:
+    if len(string) >= 1:
+        pascal_string = to_camel(string)
+        return pascal_string[0].lower() + pascal_string[1:]
+    return string.lower()
+
+
+T = TypeVar('T')
+
+
+def unique_list(
+    input_list: Union[List[T], Tuple[T, ...]],
+    *,
+    name_factory: Callable[[T], str] = str,
+) -> List[T]:
+    """
+    Make a list unique while maintaining order.
+    We update the list if another one with the same name is set
+    (e.g. root validator overridden in subclass)
+    """
+    result: List[T] = []
+    result_names: List[str] = []
+    for v in input_list:
+        v_name = name_factory(v)
+        if v_name not in result_names:
+            result_names.append(v_name)
+            result.append(v)
+        else:
+            result[result_names.index(v_name)] = v
+
+    return result
+
+
+class PyObjectStr(str):
+    """
+    String class where repr doesn't include quotes. Useful with Representation when you want to return a string
+    representation of something that valid (or pseudo-valid) python.
+    """
+
+    def __repr__(self) -> str:
+        return str(self)
+
+
+class Representation:
+    """
+    Mixin to provide __str__, __repr__, and __pretty__ methods. See #884 for more details.
+
+    __pretty__ is used by [devtools](https://python-devtools.helpmanual.io/) to provide human readable representations
+    of objects.
+    """
+
+    __slots__: Tuple[str, ...] = tuple()
+
+    def __repr_args__(self) -> 'ReprArgs':
+        """
+        Returns the attributes to show in __str__, __repr__, and __pretty__ this is generally overridden.
+
+        Can either return:
+        * name - value pairs, e.g.: `[('foo_name', 'foo'), ('bar_name', ['b', 'a', 'r'])]`
+        * or, just values, e.g.: `[(None, 'foo'), (None, ['b', 'a', 'r'])]`
+        """
+        attrs = ((s, getattr(self, s)) for s in self.__slots__)
+        return [(a, v) for a, v in attrs if v is not None]
+
+    def __repr_name__(self) -> str:
+        """
+        Name of the instance's class, used in __repr__.
+        """
+        return self.__class__.__name__
+
+    def __repr_str__(self, join_str: str) -> str:
+        return join_str.join(repr(v) if a is None else f'{a}={v!r}' for a, v in self.__repr_args__())
+
+    def __pretty__(self, fmt: Callable[[Any], Any], **kwargs: Any) -> Generator[Any, None, None]:
+        """
+        Used by devtools (https://python-devtools.helpmanual.io/) to provide a human readable representations of objects
+        """
+        yield self.__repr_name__() + '('
+        yield 1
+        for name, value in self.__repr_args__():
+            if name is not None:
+                yield name + '='
+            yield fmt(value)
+            yield ','
+            yield 0
+        yield -1
+        yield ')'
+
+    def __str__(self) -> str:
+        return self.__repr_str__(' ')
+
+    def __repr__(self) -> str:
+        return f'{self.__repr_name__()}({self.__repr_str__(", ")})'
+
+    def __rich_repr__(self) -> 'RichReprResult':
+        """Get fields for Rich library"""
+        for name, field_repr in self.__repr_args__():
+            if name is None:
+                yield field_repr
+            else:
+                yield name, field_repr
+
+
+class GetterDict(Representation):
+    """
+    Hack to make object's smell just enough like dicts for validate_model.
+
+    We can't inherit from Mapping[str, Any] because it upsets cython so we have to implement all methods ourselves.
+    """
+
+    __slots__ = ('_obj',)
+
+    def __init__(self, obj: Any):
+        self._obj = obj
+
+    def __getitem__(self, key: str) -> Any:
+        try:
+            return getattr(self._obj, key)
+        except AttributeError as e:
+            raise KeyError(key) from e
+
+    def get(self, key: Any, default: Any = None) -> Any:
+        return getattr(self._obj, key, default)
+
+    def extra_keys(self) -> Set[Any]:
+        """
+        We don't want to get any other attributes of obj if the model didn't explicitly ask for them
+        """
+        return set()
+
+    def keys(self) -> List[Any]:
+        """
+        Keys of the pseudo dictionary, uses a list not set so order information can be maintained like python
+        dictionaries.
+        """
+        return list(self)
+
+    def values(self) -> List[Any]:
+        return [self[k] for k in self]
+
+    def items(self) -> Iterator[Tuple[str, Any]]:
+        for k in self:
+            yield k, self.get(k)
+
+    def __iter__(self) -> Iterator[str]:
+        for name in dir(self._obj):
+            if not name.startswith('_'):
+                yield name
+
+    def __len__(self) -> int:
+        return sum(1 for _ in self)
+
+    def __contains__(self, item: Any) -> bool:
+        return item in self.keys()
+
+    def __eq__(self, other: Any) -> bool:
+        return dict(self) == dict(other.items())
+
+    def __repr_args__(self) -> 'ReprArgs':
+        return [(None, dict(self))]
+
+    def __repr_name__(self) -> str:
+        return f'GetterDict[{display_as_type(self._obj)}]'
+
+
+class ValueItems(Representation):
+    """
+    Class for more convenient calculation of excluded or included fields on values.
+    """
+
+    __slots__ = ('_items', '_type')
+
+    def __init__(self, value: Any, items: Union['AbstractSetIntStr', 'MappingIntStrAny']) -> None:
+        items = self._coerce_items(items)
+
+        if isinstance(value, (list, tuple)):
+            items = self._normalize_indexes(items, len(value))
+
+        self._items: 'MappingIntStrAny' = items
+
+    def is_excluded(self, item: Any) -> bool:
+        """
+        Check if item is fully excluded.
+
+        :param item: key or index of a value
+        """
+        return self.is_true(self._items.get(item))
+
+    def is_included(self, item: Any) -> bool:
+        """
+        Check if value is contained in self._items
+
+        :param item: key or index of value
+        """
+        return item in self._items
+
+    def for_element(self, e: 'IntStr') -> Optional[Union['AbstractSetIntStr', 'MappingIntStrAny']]:
+        """
+        :param e: key or index of element on value
+        :return: raw values for element if self._items is dict and contain needed element
+        """
+
+        item = self._items.get(e)
+        return item if not self.is_true(item) else None
+
+    def _normalize_indexes(self, items: 'MappingIntStrAny', v_length: int) -> 'DictIntStrAny':
+        """
+        :param items: dict or set of indexes which will be normalized
+        :param v_length: length of sequence indexes of which will be
+
+        >>> self._normalize_indexes({0: True, -2: True, -1: True}, 4)
+        {0: True, 2: True, 3: True}
+        >>> self._normalize_indexes({'__all__': True}, 4)
+        {0: True, 1: True, 2: True, 3: True}
+        """
+
+        normalized_items: 'DictIntStrAny' = {}
+        all_items = None
+        for i, v in items.items():
+            if not (isinstance(v, Mapping) or isinstance(v, AbstractSet) or self.is_true(v)):
+                raise TypeError(f'Unexpected type of exclude value for index "{i}" {v.__class__}')
+            if i == '__all__':
+                all_items = self._coerce_value(v)
+                continue
+            if not isinstance(i, int):
+                raise TypeError(
+                    'Excluding fields from a sequence of sub-models or dicts must be performed index-wise: '
+                    'expected integer keys or keyword "__all__"'
+                )
+            normalized_i = v_length + i if i < 0 else i
+            normalized_items[normalized_i] = self.merge(v, normalized_items.get(normalized_i))
+
+        if not all_items:
+            return normalized_items
+        if self.is_true(all_items):
+            for i in range(v_length):
+                normalized_items.setdefault(i, ...)
+            return normalized_items
+        for i in range(v_length):
+            normalized_item = normalized_items.setdefault(i, {})
+            if not self.is_true(normalized_item):
+                normalized_items[i] = self.merge(all_items, normalized_item)
+        return normalized_items
+
+    @classmethod
+    def merge(cls, base: Any, override: Any, intersect: bool = False) -> Any:
+        """
+        Merge a ``base`` item with an ``override`` item.
+
+        Both ``base`` and ``override`` are converted to dictionaries if possible.
+        Sets are converted to dictionaries with the sets entries as keys and
+        Ellipsis as values.
+
+        Each key-value pair existing in ``base`` is merged with ``override``,
+        while the rest of the key-value pairs are updated recursively with this function.
+
+        Merging takes place based on the "union" of keys if ``intersect`` is
+        set to ``False`` (default) and on the intersection of keys if
+        ``intersect`` is set to ``True``.
+        """
+        override = cls._coerce_value(override)
+        base = cls._coerce_value(base)
+        if override is None:
+            return base
+        if cls.is_true(base) or base is None:
+            return override
+        if cls.is_true(override):
+            return base if intersect else override
+
+        # intersection or union of keys while preserving ordering:
+        if intersect:
+            merge_keys = [k for k in base if k in override] + [k for k in override if k in base]
+        else:
+            merge_keys = list(base) + [k for k in override if k not in base]
+
+        merged: 'DictIntStrAny' = {}
+        for k in merge_keys:
+            merged_item = cls.merge(base.get(k), override.get(k), intersect=intersect)
+            if merged_item is not None:
+                merged[k] = merged_item
+
+        return merged
+
+    @staticmethod
+    def _coerce_items(items: Union['AbstractSetIntStr', 'MappingIntStrAny']) -> 'MappingIntStrAny':
+        if isinstance(items, Mapping):
+            pass
+        elif isinstance(items, AbstractSet):
+            items = dict.fromkeys(items, ...)
+        else:
+            class_name = getattr(items, '__class__', '???')
+            assert_never(
+                items,
+                f'Unexpected type of exclude value {class_name}',
+            )
+        return items
+
+    @classmethod
+    def _coerce_value(cls, value: Any) -> Any:
+        if value is None or cls.is_true(value):
+            return value
+        return cls._coerce_items(value)
+
+    @staticmethod
+    def is_true(v: Any) -> bool:
+        return v is True or v is ...
+
+    def __repr_args__(self) -> 'ReprArgs':
+        return [(None, self._items)]
+
+
+class ClassAttribute:
+    """
+    Hide class attribute from its instances
+    """
+
+    __slots__ = (
+        'name',
+        'value',
+    )
+
+    def __init__(self, name: str, value: Any) -> None:
+        self.name = name
+        self.value = value
+
+    def __get__(self, instance: Any, owner: Type[Any]) -> None:
+        if instance is None:
+            return self.value
+        raise AttributeError(f'{self.name!r} attribute of {owner.__name__!r} is class-only')
+
+
+path_types = {
+    'is_dir': 'directory',
+    'is_file': 'file',
+    'is_mount': 'mount point',
+    'is_symlink': 'symlink',
+    'is_block_device': 'block device',
+    'is_char_device': 'char device',
+    'is_fifo': 'FIFO',
+    'is_socket': 'socket',
+}
+
+
+def path_type(p: 'Path') -> str:
+    """
+    Find out what sort of thing a path is.
+    """
+    assert p.exists(), 'path does not exist'
+    for method, name in path_types.items():
+        if getattr(p, method)():
+            return name
+
+    return 'unknown'
+
+
+Obj = TypeVar('Obj')
+
+
+def smart_deepcopy(obj: Obj) -> Obj:
+    """
+    Return type as is for immutable built-in types
+    Use obj.copy() for built-in empty collections
+    Use copy.deepcopy() for non-empty collections and unknown objects
+    """
+
+    obj_type = obj.__class__
+    if obj_type in IMMUTABLE_NON_COLLECTIONS_TYPES:
+        return obj  # fastest case: obj is immutable and not collection therefore will not be copied anyway
+    try:
+        if not obj and obj_type in BUILTIN_COLLECTIONS:
+            # faster way for empty collections, no need to copy its members
+            return obj if obj_type is tuple else obj.copy()  # type: ignore  # tuple doesn't have copy method
+    except (TypeError, ValueError, RuntimeError):
+        # do we really dare to catch ALL errors? Seems a bit risky
+        pass
+
+    return deepcopy(obj)  # slowest way when we actually might need a deepcopy
+
+
+def is_valid_field(name: str) -> bool:
+    if not name.startswith('_'):
+        return True
+    return ROOT_KEY == name
+
+
+DUNDER_ATTRIBUTES = {
+    '__annotations__',
+    '__classcell__',
+    '__doc__',
+    '__module__',
+    '__orig_bases__',
+    '__orig_class__',
+    '__qualname__',
+}
+
+
+def is_valid_private_name(name: str) -> bool:
+    return not is_valid_field(name) and name not in DUNDER_ATTRIBUTES
+
+
+_EMPTY = object()
+
+
+def all_identical(left: Iterable[Any], right: Iterable[Any]) -> bool:
+    """
+    Check that the items of `left` are the same objects as those in `right`.
+
+    >>> a, b = object(), object()
+    >>> all_identical([a, b, a], [a, b, a])
+    True
+    >>> all_identical([a, b, [a]], [a, b, [a]])  # new list object, while "equal" is not "identical"
+    False
+    """
+    for left_item, right_item in zip_longest(left, right, fillvalue=_EMPTY):
+        if left_item is not right_item:
+            return False
+    return True
+
+
+def assert_never(obj: NoReturn, msg: str) -> NoReturn:
+    """
+    Helper to make sure that we have covered all possible types.
+
+    This is mostly useful for ``mypy``, docs:
+    https://mypy.readthedocs.io/en/latest/literal_types.html#exhaustive-checks
+    """
+    raise TypeError(msg)
+
+
+def get_unique_discriminator_alias(all_aliases: Collection[str], discriminator_key: str) -> str:
+    """Validate that all aliases are the same and if that's the case return the alias"""
+    unique_aliases = set(all_aliases)
+    if len(unique_aliases) > 1:
+        raise ConfigError(
+            f'Aliases for discriminator {discriminator_key!r} must be the same (got {", ".join(sorted(all_aliases))})'
+        )
+    return unique_aliases.pop()
+
+
+def get_discriminator_alias_and_values(tp: Any, discriminator_key: str) -> Tuple[str, Tuple[str, ...]]:
+    """
+    Get alias and all valid values in the `Literal` type of the discriminator field
+    `tp` can be a `BaseModel` class or directly an `Annotated` `Union` of many.
+    """
+    is_root_model = getattr(tp, '__custom_root_type__', False)
+
+    if get_origin(tp) is Annotated:
+        tp = get_args(tp)[0]
+
+    if hasattr(tp, '__pydantic_model__'):
+        tp = tp.__pydantic_model__
+
+    if is_union(get_origin(tp)):
+        alias, all_values = _get_union_alias_and_all_values(tp, discriminator_key)
+        return alias, tuple(v for values in all_values for v in values)
+    elif is_root_model:
+        union_type = tp.__fields__[ROOT_KEY].type_
+        alias, all_values = _get_union_alias_and_all_values(union_type, discriminator_key)
+
+        if len(set(all_values)) > 1:
+            raise ConfigError(
+                f'Field {discriminator_key!r} is not the same for all submodels of {display_as_type(tp)!r}'
+            )
+
+        return alias, all_values[0]
+
+    else:
+        try:
+            t_discriminator_type = tp.__fields__[discriminator_key].type_
+        except AttributeError as e:
+            raise TypeError(f'Type {tp.__name__!r} is not a valid `BaseModel` or `dataclass`') from e
+        except KeyError as e:
+            raise ConfigError(f'Model {tp.__name__!r} needs a discriminator field for key {discriminator_key!r}') from e
+
+        if not is_literal_type(t_discriminator_type):
+            raise ConfigError(f'Field {discriminator_key!r} of model {tp.__name__!r} needs to be a `Literal`')
+
+        return tp.__fields__[discriminator_key].alias, all_literal_values(t_discriminator_type)
+
+
+def _get_union_alias_and_all_values(
+    union_type: Type[Any], discriminator_key: str
+) -> Tuple[str, Tuple[Tuple[str, ...], ...]]:
+    zipped_aliases_values = [get_discriminator_alias_and_values(t, discriminator_key) for t in get_args(union_type)]
+    # unzip: [('alias_a',('v1', 'v2)), ('alias_b', ('v3',))] => [('alias_a', 'alias_b'), (('v1', 'v2'), ('v3',))]
+    all_aliases, all_values = zip(*zipped_aliases_values)
+    return get_unique_discriminator_alias(all_aliases, discriminator_key), all_values
diff --git a/lib/pydantic/v1/validators.py b/lib/pydantic/v1/validators.py
new file mode 100644
index 00000000..549a235e
--- /dev/null
+++ b/lib/pydantic/v1/validators.py
@@ -0,0 +1,765 @@
+import math
+import re
+from collections import OrderedDict, deque
+from collections.abc import Hashable as CollectionsHashable
+from datetime import date, datetime, time, timedelta
+from decimal import Decimal, DecimalException
+from enum import Enum, IntEnum
+from ipaddress import IPv4Address, IPv4Interface, IPv4Network, IPv6Address, IPv6Interface, IPv6Network
+from pathlib import Path
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    Deque,
+    Dict,
+    ForwardRef,
+    FrozenSet,
+    Generator,
+    Hashable,
+    List,
+    NamedTuple,
+    Pattern,
+    Set,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+)
+from uuid import UUID
+
+from . import errors
+from .datetime_parse import parse_date, parse_datetime, parse_duration, parse_time
+from .typing import (
+    AnyCallable,
+    all_literal_values,
+    display_as_type,
+    get_class,
+    is_callable_type,
+    is_literal_type,
+    is_namedtuple,
+    is_none_type,
+    is_typeddict,
+)
+from .utils import almost_equal_floats, lenient_issubclass, sequence_like
+
+if TYPE_CHECKING:
+    from typing_extensions import Literal, TypedDict
+
+    from .config import BaseConfig
+    from .fields import ModelField
+    from .types import ConstrainedDecimal, ConstrainedFloat, ConstrainedInt
+
+    ConstrainedNumber = Union[ConstrainedDecimal, ConstrainedFloat, ConstrainedInt]
+    AnyOrderedDict = OrderedDict[Any, Any]
+    Number = Union[int, float, Decimal]
+    StrBytes = Union[str, bytes]
+
+
+def str_validator(v: Any) -> Union[str]:
+    if isinstance(v, str):
+        if isinstance(v, Enum):
+            return v.value
+        else:
+            return v
+    elif isinstance(v, (float, int, Decimal)):
+        # is there anything else we want to add here? If you think so, create an issue.
+        return str(v)
+    elif isinstance(v, (bytes, bytearray)):
+        return v.decode()
+    else:
+        raise errors.StrError()
+
+
+def strict_str_validator(v: Any) -> Union[str]:
+    if isinstance(v, str) and not isinstance(v, Enum):
+        return v
+    raise errors.StrError()
+
+
+def bytes_validator(v: Any) -> Union[bytes]:
+    if isinstance(v, bytes):
+        return v
+    elif isinstance(v, bytearray):
+        return bytes(v)
+    elif isinstance(v, str):
+        return v.encode()
+    elif isinstance(v, (float, int, Decimal)):
+        return str(v).encode()
+    else:
+        raise errors.BytesError()
+
+
+def strict_bytes_validator(v: Any) -> Union[bytes]:
+    if isinstance(v, bytes):
+        return v
+    elif isinstance(v, bytearray):
+        return bytes(v)
+    else:
+        raise errors.BytesError()
+
+
+BOOL_FALSE = {0, '0', 'off', 'f', 'false', 'n', 'no'}
+BOOL_TRUE = {1, '1', 'on', 't', 'true', 'y', 'yes'}
+
+
+def bool_validator(v: Any) -> bool:
+    if v is True or v is False:
+        return v
+    if isinstance(v, bytes):
+        v = v.decode()
+    if isinstance(v, str):
+        v = v.lower()
+    try:
+        if v in BOOL_TRUE:
+            return True
+        if v in BOOL_FALSE:
+            return False
+    except TypeError:
+        raise errors.BoolError()
+    raise errors.BoolError()
+
+
+# matches the default limit cpython, see https://github.com/python/cpython/pull/96500
+max_str_int = 4_300
+
+
+def int_validator(v: Any) -> int:
+    if isinstance(v, int) and not (v is True or v is False):
+        return v
+
+    # see https://github.com/pydantic/pydantic/issues/1477 and in turn, https://github.com/python/cpython/issues/95778
+    # this check should be unnecessary once patch releases are out for 3.7, 3.8, 3.9 and 3.10
+    # but better to check here until then.
+    # NOTICE: this does not fully protect user from the DOS risk since the standard library JSON implementation
+    # (and other std lib modules like xml) use `int()` and are likely called before this, the best workaround is to
+    # 1. update to the latest patch release of python once released, 2. use a different JSON library like ujson
+    if isinstance(v, (str, bytes, bytearray)) and len(v) > max_str_int:
+        raise errors.IntegerError()
+
+    try:
+        return int(v)
+    except (TypeError, ValueError, OverflowError):
+        raise errors.IntegerError()
+
+
+def strict_int_validator(v: Any) -> int:
+    if isinstance(v, int) and not (v is True or v is False):
+        return v
+    raise errors.IntegerError()
+
+
+def float_validator(v: Any) -> float:
+    if isinstance(v, float):
+        return v
+
+    try:
+        return float(v)
+    except (TypeError, ValueError):
+        raise errors.FloatError()
+
+
+def strict_float_validator(v: Any) -> float:
+    if isinstance(v, float):
+        return v
+    raise errors.FloatError()
+
+
+def float_finite_validator(v: 'Number', field: 'ModelField', config: 'BaseConfig') -> 'Number':
+    allow_inf_nan = getattr(field.type_, 'allow_inf_nan', None)
+    if allow_inf_nan is None:
+        allow_inf_nan = config.allow_inf_nan
+
+    if allow_inf_nan is False and (math.isnan(v) or math.isinf(v)):
+        raise errors.NumberNotFiniteError()
+    return v
+
+
+def number_multiple_validator(v: 'Number', field: 'ModelField') -> 'Number':
+    field_type: ConstrainedNumber = field.type_
+    if field_type.multiple_of is not None:
+        mod = float(v) / float(field_type.multiple_of) % 1
+        if not almost_equal_floats(mod, 0.0) and not almost_equal_floats(mod, 1.0):
+            raise errors.NumberNotMultipleError(multiple_of=field_type.multiple_of)
+    return v
+
+
+def number_size_validator(v: 'Number', field: 'ModelField') -> 'Number':
+    field_type: ConstrainedNumber = field.type_
+    if field_type.gt is not None and not v > field_type.gt:
+        raise errors.NumberNotGtError(limit_value=field_type.gt)
+    elif field_type.ge is not None and not v >= field_type.ge:
+        raise errors.NumberNotGeError(limit_value=field_type.ge)
+
+    if field_type.lt is not None and not v < field_type.lt:
+        raise errors.NumberNotLtError(limit_value=field_type.lt)
+    if field_type.le is not None and not v <= field_type.le:
+        raise errors.NumberNotLeError(limit_value=field_type.le)
+
+    return v
+
+
+def constant_validator(v: 'Any', field: 'ModelField') -> 'Any':
+    """Validate ``const`` fields.
+
+    The value provided for a ``const`` field must be equal to the default value
+    of the field. This is to support the keyword of the same name in JSON
+    Schema.
+    """
+    if v != field.default:
+        raise errors.WrongConstantError(given=v, permitted=[field.default])
+
+    return v
+
+
+def anystr_length_validator(v: 'StrBytes', config: 'BaseConfig') -> 'StrBytes':
+    v_len = len(v)
+
+    min_length = config.min_anystr_length
+    if v_len < min_length:
+        raise errors.AnyStrMinLengthError(limit_value=min_length)
+
+    max_length = config.max_anystr_length
+    if max_length is not None and v_len > max_length:
+        raise errors.AnyStrMaxLengthError(limit_value=max_length)
+
+    return v
+
+
+def anystr_strip_whitespace(v: 'StrBytes') -> 'StrBytes':
+    return v.strip()
+
+
+def anystr_upper(v: 'StrBytes') -> 'StrBytes':
+    return v.upper()
+
+
+def anystr_lower(v: 'StrBytes') -> 'StrBytes':
+    return v.lower()
+
+
+def ordered_dict_validator(v: Any) -> 'AnyOrderedDict':
+    if isinstance(v, OrderedDict):
+        return v
+
+    try:
+        return OrderedDict(v)
+    except (TypeError, ValueError):
+        raise errors.DictError()
+
+
+def dict_validator(v: Any) -> Dict[Any, Any]:
+    if isinstance(v, dict):
+        return v
+
+    try:
+        return dict(v)
+    except (TypeError, ValueError):
+        raise errors.DictError()
+
+
+def list_validator(v: Any) -> List[Any]:
+    if isinstance(v, list):
+        return v
+    elif sequence_like(v):
+        return list(v)
+    else:
+        raise errors.ListError()
+
+
+def tuple_validator(v: Any) -> Tuple[Any, ...]:
+    if isinstance(v, tuple):
+        return v
+    elif sequence_like(v):
+        return tuple(v)
+    else:
+        raise errors.TupleError()
+
+
+def set_validator(v: Any) -> Set[Any]:
+    if isinstance(v, set):
+        return v
+    elif sequence_like(v):
+        return set(v)
+    else:
+        raise errors.SetError()
+
+
+def frozenset_validator(v: Any) -> FrozenSet[Any]:
+    if isinstance(v, frozenset):
+        return v
+    elif sequence_like(v):
+        return frozenset(v)
+    else:
+        raise errors.FrozenSetError()
+
+
+def deque_validator(v: Any) -> Deque[Any]:
+    if isinstance(v, deque):
+        return v
+    elif sequence_like(v):
+        return deque(v)
+    else:
+        raise errors.DequeError()
+
+
+def enum_member_validator(v: Any, field: 'ModelField', config: 'BaseConfig') -> Enum:
+    try:
+        enum_v = field.type_(v)
+    except ValueError:
+        # field.type_ should be an enum, so will be iterable
+        raise errors.EnumMemberError(enum_values=list(field.type_))
+    return enum_v.value if config.use_enum_values else enum_v
+
+
+def uuid_validator(v: Any, field: 'ModelField') -> UUID:
+    try:
+        if isinstance(v, str):
+            v = UUID(v)
+        elif isinstance(v, (bytes, bytearray)):
+            try:
+                v = UUID(v.decode())
+            except ValueError:
+                # 16 bytes in big-endian order as the bytes argument fail
+                # the above check
+                v = UUID(bytes=v)
+    except ValueError:
+        raise errors.UUIDError()
+
+    if not isinstance(v, UUID):
+        raise errors.UUIDError()
+
+    required_version = getattr(field.type_, '_required_version', None)
+    if required_version and v.version != required_version:
+        raise errors.UUIDVersionError(required_version=required_version)
+
+    return v
+
+
+def decimal_validator(v: Any) -> Decimal:
+    if isinstance(v, Decimal):
+        return v
+    elif isinstance(v, (bytes, bytearray)):
+        v = v.decode()
+
+    v = str(v).strip()
+
+    try:
+        v = Decimal(v)
+    except DecimalException:
+        raise errors.DecimalError()
+
+    if not v.is_finite():
+        raise errors.DecimalIsNotFiniteError()
+
+    return v
+
+
+def hashable_validator(v: Any) -> Hashable:
+    if isinstance(v, Hashable):
+        return v
+
+    raise errors.HashableError()
+
+
+def ip_v4_address_validator(v: Any) -> IPv4Address:
+    if isinstance(v, IPv4Address):
+        return v
+
+    try:
+        return IPv4Address(v)
+    except ValueError:
+        raise errors.IPv4AddressError()
+
+
+def ip_v6_address_validator(v: Any) -> IPv6Address:
+    if isinstance(v, IPv6Address):
+        return v
+
+    try:
+        return IPv6Address(v)
+    except ValueError:
+        raise errors.IPv6AddressError()
+
+
+def ip_v4_network_validator(v: Any) -> IPv4Network:
+    """
+    Assume IPv4Network initialised with a default ``strict`` argument
+
+    See more:
+    https://docs.python.org/library/ipaddress.html#ipaddress.IPv4Network
+    """
+    if isinstance(v, IPv4Network):
+        return v
+
+    try:
+        return IPv4Network(v)
+    except ValueError:
+        raise errors.IPv4NetworkError()
+
+
+def ip_v6_network_validator(v: Any) -> IPv6Network:
+    """
+    Assume IPv6Network initialised with a default ``strict`` argument
+
+    See more:
+    https://docs.python.org/library/ipaddress.html#ipaddress.IPv6Network
+    """
+    if isinstance(v, IPv6Network):
+        return v
+
+    try:
+        return IPv6Network(v)
+    except ValueError:
+        raise errors.IPv6NetworkError()
+
+
+def ip_v4_interface_validator(v: Any) -> IPv4Interface:
+    if isinstance(v, IPv4Interface):
+        return v
+
+    try:
+        return IPv4Interface(v)
+    except ValueError:
+        raise errors.IPv4InterfaceError()
+
+
+def ip_v6_interface_validator(v: Any) -> IPv6Interface:
+    if isinstance(v, IPv6Interface):
+        return v
+
+    try:
+        return IPv6Interface(v)
+    except ValueError:
+        raise errors.IPv6InterfaceError()
+
+
+def path_validator(v: Any) -> Path:
+    if isinstance(v, Path):
+        return v
+
+    try:
+        return Path(v)
+    except TypeError:
+        raise errors.PathError()
+
+
+def path_exists_validator(v: Any) -> Path:
+    if not v.exists():
+        raise errors.PathNotExistsError(path=v)
+
+    return v
+
+
+def callable_validator(v: Any) -> AnyCallable:
+    """
+    Perform a simple check if the value is callable.
+
+    Note: complete matching of argument type hints and return types is not performed
+    """
+    if callable(v):
+        return v
+
+    raise errors.CallableError(value=v)
+
+
+def enum_validator(v: Any) -> Enum:
+    if isinstance(v, Enum):
+        return v
+
+    raise errors.EnumError(value=v)
+
+
+def int_enum_validator(v: Any) -> IntEnum:
+    if isinstance(v, IntEnum):
+        return v
+
+    raise errors.IntEnumError(value=v)
+
+
+def make_literal_validator(type_: Any) -> Callable[[Any], Any]:
+    permitted_choices = all_literal_values(type_)
+
+    # To have a O(1) complexity and still return one of the values set inside the `Literal`,
+    # we create a dict with the set values (a set causes some problems with the way intersection works).
+    # In some cases the set value and checked value can indeed be different (see `test_literal_validator_str_enum`)
+    allowed_choices = {v: v for v in permitted_choices}
+
+    def literal_validator(v: Any) -> Any:
+        try:
+            return allowed_choices[v]
+        except (KeyError, TypeError):
+            raise errors.WrongConstantError(given=v, permitted=permitted_choices)
+
+    return literal_validator
+
+
+def constr_length_validator(v: 'StrBytes', field: 'ModelField', config: 'BaseConfig') -> 'StrBytes':
+    v_len = len(v)
+
+    min_length = field.type_.min_length if field.type_.min_length is not None else config.min_anystr_length
+    if v_len < min_length:
+        raise errors.AnyStrMinLengthError(limit_value=min_length)
+
+    max_length = field.type_.max_length if field.type_.max_length is not None else config.max_anystr_length
+    if max_length is not None and v_len > max_length:
+        raise errors.AnyStrMaxLengthError(limit_value=max_length)
+
+    return v
+
+
+def constr_strip_whitespace(v: 'StrBytes', field: 'ModelField', config: 'BaseConfig') -> 'StrBytes':
+    strip_whitespace = field.type_.strip_whitespace or config.anystr_strip_whitespace
+    if strip_whitespace:
+        v = v.strip()
+
+    return v
+
+
+def constr_upper(v: 'StrBytes', field: 'ModelField', config: 'BaseConfig') -> 'StrBytes':
+    upper = field.type_.to_upper or config.anystr_upper
+    if upper:
+        v = v.upper()
+
+    return v
+
+
+def constr_lower(v: 'StrBytes', field: 'ModelField', config: 'BaseConfig') -> 'StrBytes':
+    lower = field.type_.to_lower or config.anystr_lower
+    if lower:
+        v = v.lower()
+    return v
+
+
+def validate_json(v: Any, config: 'BaseConfig') -> Any:
+    if v is None:
+        # pass None through to other validators
+        return v
+    try:
+        return config.json_loads(v)  # type: ignore
+    except ValueError:
+        raise errors.JsonError()
+    except TypeError:
+        raise errors.JsonTypeError()
+
+
+T = TypeVar('T')
+
+
+def make_arbitrary_type_validator(type_: Type[T]) -> Callable[[T], T]:
+    def arbitrary_type_validator(v: Any) -> T:
+        if isinstance(v, type_):
+            return v
+        raise errors.ArbitraryTypeError(expected_arbitrary_type=type_)
+
+    return arbitrary_type_validator
+
+
+def make_class_validator(type_: Type[T]) -> Callable[[Any], Type[T]]:
+    def class_validator(v: Any) -> Type[T]:
+        if lenient_issubclass(v, type_):
+            return v
+        raise errors.SubclassError(expected_class=type_)
+
+    return class_validator
+
+
+def any_class_validator(v: Any) -> Type[T]:
+    if isinstance(v, type):
+        return v
+    raise errors.ClassError()
+
+
+def none_validator(v: Any) -> 'Literal[None]':
+    if v is None:
+        return v
+    raise errors.NotNoneError()
+
+
+def pattern_validator(v: Any) -> Pattern[str]:
+    if isinstance(v, Pattern):
+        return v
+
+    str_value = str_validator(v)
+
+    try:
+        return re.compile(str_value)
+    except re.error:
+        raise errors.PatternError()
+
+
+NamedTupleT = TypeVar('NamedTupleT', bound=NamedTuple)
+
+
+def make_namedtuple_validator(
+    namedtuple_cls: Type[NamedTupleT], config: Type['BaseConfig']
+) -> Callable[[Tuple[Any, ...]], NamedTupleT]:
+    from .annotated_types import create_model_from_namedtuple
+
+    NamedTupleModel = create_model_from_namedtuple(
+        namedtuple_cls,
+        __config__=config,
+        __module__=namedtuple_cls.__module__,
+    )
+    namedtuple_cls.__pydantic_model__ = NamedTupleModel  # type: ignore[attr-defined]
+
+    def namedtuple_validator(values: Tuple[Any, ...]) -> NamedTupleT:
+        annotations = NamedTupleModel.__annotations__
+
+        if len(values) > len(annotations):
+            raise errors.ListMaxLengthError(limit_value=len(annotations))
+
+        dict_values: Dict[str, Any] = dict(zip(annotations, values))
+        validated_dict_values: Dict[str, Any] = dict(NamedTupleModel(**dict_values))
+        return namedtuple_cls(**validated_dict_values)
+
+    return namedtuple_validator
+
+
+def make_typeddict_validator(
+    typeddict_cls: Type['TypedDict'], config: Type['BaseConfig']  # type: ignore[valid-type]
+) -> Callable[[Any], Dict[str, Any]]:
+    from .annotated_types import create_model_from_typeddict
+
+    TypedDictModel = create_model_from_typeddict(
+        typeddict_cls,
+        __config__=config,
+        __module__=typeddict_cls.__module__,
+    )
+    typeddict_cls.__pydantic_model__ = TypedDictModel  # type: ignore[attr-defined]
+
+    def typeddict_validator(values: 'TypedDict') -> Dict[str, Any]:  # type: ignore[valid-type]
+        return TypedDictModel.parse_obj(values).dict(exclude_unset=True)
+
+    return typeddict_validator
+
+
+class IfConfig:
+    def __init__(self, validator: AnyCallable, *config_attr_names: str, ignored_value: Any = False) -> None:
+        self.validator = validator
+        self.config_attr_names = config_attr_names
+        self.ignored_value = ignored_value
+
+    def check(self, config: Type['BaseConfig']) -> bool:
+        return any(getattr(config, name) not in {None, self.ignored_value} for name in self.config_attr_names)
+
+
+# order is important here, for example: bool is a subclass of int so has to come first, datetime before date same,
+# IPv4Interface before IPv4Address, etc
+_VALIDATORS: List[Tuple[Type[Any], List[Any]]] = [
+    (IntEnum, [int_validator, enum_member_validator]),
+    (Enum, [enum_member_validator]),
+    (
+        str,
+        [
+            str_validator,
+            IfConfig(anystr_strip_whitespace, 'anystr_strip_whitespace'),
+            IfConfig(anystr_upper, 'anystr_upper'),
+            IfConfig(anystr_lower, 'anystr_lower'),
+            IfConfig(anystr_length_validator, 'min_anystr_length', 'max_anystr_length'),
+        ],
+    ),
+    (
+        bytes,
+        [
+            bytes_validator,
+            IfConfig(anystr_strip_whitespace, 'anystr_strip_whitespace'),
+            IfConfig(anystr_upper, 'anystr_upper'),
+            IfConfig(anystr_lower, 'anystr_lower'),
+            IfConfig(anystr_length_validator, 'min_anystr_length', 'max_anystr_length'),
+        ],
+    ),
+    (bool, [bool_validator]),
+    (int, [int_validator]),
+    (float, [float_validator, IfConfig(float_finite_validator, 'allow_inf_nan', ignored_value=True)]),
+    (Path, [path_validator]),
+    (datetime, [parse_datetime]),
+    (date, [parse_date]),
+    (time, [parse_time]),
+    (timedelta, [parse_duration]),
+    (OrderedDict, [ordered_dict_validator]),
+    (dict, [dict_validator]),
+    (list, [list_validator]),
+    (tuple, [tuple_validator]),
+    (set, [set_validator]),
+    (frozenset, [frozenset_validator]),
+    (deque, [deque_validator]),
+    (UUID, [uuid_validator]),
+    (Decimal, [decimal_validator]),
+    (IPv4Interface, [ip_v4_interface_validator]),
+    (IPv6Interface, [ip_v6_interface_validator]),
+    (IPv4Address, [ip_v4_address_validator]),
+    (IPv6Address, [ip_v6_address_validator]),
+    (IPv4Network, [ip_v4_network_validator]),
+    (IPv6Network, [ip_v6_network_validator]),
+]
+
+
+def find_validators(  # noqa: C901 (ignore complexity)
+    type_: Type[Any], config: Type['BaseConfig']
+) -> Generator[AnyCallable, None, None]:
+    from .dataclasses import is_builtin_dataclass, make_dataclass_validator
+
+    if type_ is Any or type_ is object:
+        return
+    type_type = type_.__class__
+    if type_type == ForwardRef or type_type == TypeVar:
+        return
+
+    if is_none_type(type_):
+        yield none_validator
+        return
+    if type_ is Pattern or type_ is re.Pattern:
+        yield pattern_validator
+        return
+    if type_ is Hashable or type_ is CollectionsHashable:
+        yield hashable_validator
+        return
+    if is_callable_type(type_):
+        yield callable_validator
+        return
+    if is_literal_type(type_):
+        yield make_literal_validator(type_)
+        return
+    if is_builtin_dataclass(type_):
+        yield from make_dataclass_validator(type_, config)
+        return
+    if type_ is Enum:
+        yield enum_validator
+        return
+    if type_ is IntEnum:
+        yield int_enum_validator
+        return
+    if is_namedtuple(type_):
+        yield tuple_validator
+        yield make_namedtuple_validator(type_, config)
+        return
+    if is_typeddict(type_):
+        yield make_typeddict_validator(type_, config)
+        return
+
+    class_ = get_class(type_)
+    if class_ is not None:
+        if class_ is not Any and isinstance(class_, type):
+            yield make_class_validator(class_)
+        else:
+            yield any_class_validator
+        return
+
+    for val_type, validators in _VALIDATORS:
+        try:
+            if issubclass(type_, val_type):
+                for v in validators:
+                    if isinstance(v, IfConfig):
+                        if v.check(config):
+                            yield v.validator
+                    else:
+                        yield v
+                return
+        except TypeError:
+            raise RuntimeError(f'error checking inheritance of {type_!r} (type: {display_as_type(type_)})')
+
+    if config.arbitrary_types_allowed:
+        yield make_arbitrary_type_validator(type_)
+    else:
+        raise RuntimeError(f'no validator found for {type_}, see `arbitrary_types_allowed` in Config')
diff --git a/lib/pydantic/v1/version.py b/lib/pydantic/v1/version.py
new file mode 100644
index 00000000..ec982ba7
--- /dev/null
+++ b/lib/pydantic/v1/version.py
@@ -0,0 +1,38 @@
+__all__ = 'compiled', 'VERSION', 'version_info'
+
+VERSION = '1.10.14'
+
+try:
+    import cython  # type: ignore
+except ImportError:
+    compiled: bool = False
+else:  # pragma: no cover
+    try:
+        compiled = cython.compiled
+    except AttributeError:
+        compiled = False
+
+
+def version_info() -> str:
+    import platform
+    import sys
+    from importlib import import_module
+    from pathlib import Path
+
+    optional_deps = []
+    for p in ('devtools', 'dotenv', 'email-validator', 'typing-extensions'):
+        try:
+            import_module(p.replace('-', '_'))
+        except ImportError:
+            continue
+        optional_deps.append(p)
+
+    info = {
+        'pydantic version': VERSION,
+        'pydantic compiled': compiled,
+        'install path': Path(__file__).resolve().parent,
+        'python version': sys.version,
+        'platform': platform.platform(),
+        'optional deps. installed': optional_deps,
+    }
+    return '\n'.join('{:>30} {}'.format(k + ':', str(v).replace('\n', ' ')) for k, v in info.items())
diff --git a/lib/pydantic/validate_call_decorator.py b/lib/pydantic/validate_call_decorator.py
new file mode 100644
index 00000000..b95fa3b6
--- /dev/null
+++ b/lib/pydantic/validate_call_decorator.py
@@ -0,0 +1,67 @@
+"""Decorator for validating function calls."""
+from __future__ import annotations as _annotations
+
+import functools
+from typing import TYPE_CHECKING, Any, Callable, TypeVar, overload
+
+from ._internal import _validate_call
+
+__all__ = ('validate_call',)
+
+if TYPE_CHECKING:
+    from .config import ConfigDict
+
+    AnyCallableT = TypeVar('AnyCallableT', bound=Callable[..., Any])
+
+
+@overload
+def validate_call(
+    *, config: ConfigDict | None = None, validate_return: bool = False
+) -> Callable[[AnyCallableT], AnyCallableT]:
+    ...
+
+
+@overload
+def validate_call(__func: AnyCallableT) -> AnyCallableT:
+    ...
+
+
+def validate_call(
+    __func: AnyCallableT | None = None,
+    *,
+    config: ConfigDict | None = None,
+    validate_return: bool = False,
+) -> AnyCallableT | Callable[[AnyCallableT], AnyCallableT]:
+    """Usage docs: https://docs.pydantic.dev/2.6/concepts/validation_decorator/
+
+    Returns a decorated wrapper around the function that validates the arguments and, optionally, the return value.
+
+    Usage may be either as a plain decorator `@validate_call` or with arguments `@validate_call(...)`.
+
+    Args:
+        __func: The function to be decorated.
+        config: The configuration dictionary.
+        validate_return: Whether to validate the return value.
+
+    Returns:
+        The decorated function.
+    """
+
+    def validate(function: AnyCallableT) -> AnyCallableT:
+        if isinstance(function, (classmethod, staticmethod)):
+            name = type(function).__name__
+            raise TypeError(f'The `@{name}` decorator should be applied after `@validate_call` (put `@{name}` on top)')
+        validate_call_wrapper = _validate_call.ValidateCallWrapper(function, config, validate_return)
+
+        @functools.wraps(function)
+        def wrapper_function(*args, **kwargs):
+            return validate_call_wrapper(*args, **kwargs)
+
+        wrapper_function.raw_function = function  # type: ignore
+
+        return wrapper_function  # type: ignore
+
+    if __func:
+        return validate(__func)
+    else:
+        return validate
diff --git a/lib/pydantic/validators.py b/lib/pydantic/validators.py
index fb6d0418..55b0339e 100644
--- a/lib/pydantic/validators.py
+++ b/lib/pydantic/validators.py
@@ -1,765 +1,4 @@
-import math
-import re
-from collections import OrderedDict, deque
-from collections.abc import Hashable as CollectionsHashable
-from datetime import date, datetime, time, timedelta
-from decimal import Decimal, DecimalException
-from enum import Enum, IntEnum
-from ipaddress import IPv4Address, IPv4Interface, IPv4Network, IPv6Address, IPv6Interface, IPv6Network
-from pathlib import Path
-from typing import (
-    TYPE_CHECKING,
-    Any,
-    Callable,
-    Deque,
-    Dict,
-    ForwardRef,
-    FrozenSet,
-    Generator,
-    Hashable,
-    List,
-    NamedTuple,
-    Pattern,
-    Set,
-    Tuple,
-    Type,
-    TypeVar,
-    Union,
-)
-from uuid import UUID
+"""The `validators` module is a backport module from V1."""
+from ._migration import getattr_migration
 
-from . import errors
-from .datetime_parse import parse_date, parse_datetime, parse_duration, parse_time
-from .typing import (
-    AnyCallable,
-    all_literal_values,
-    display_as_type,
-    get_class,
-    is_callable_type,
-    is_literal_type,
-    is_namedtuple,
-    is_none_type,
-    is_typeddict,
-)
-from .utils import almost_equal_floats, lenient_issubclass, sequence_like
-
-if TYPE_CHECKING:
-    from typing_extensions import Literal, TypedDict
-
-    from .config import BaseConfig
-    from .fields import ModelField
-    from .types import ConstrainedDecimal, ConstrainedFloat, ConstrainedInt
-
-    ConstrainedNumber = Union[ConstrainedDecimal, ConstrainedFloat, ConstrainedInt]
-    AnyOrderedDict = OrderedDict[Any, Any]
-    Number = Union[int, float, Decimal]
-    StrBytes = Union[str, bytes]
-
-
-def str_validator(v: Any) -> Union[str]:
-    if isinstance(v, str):
-        if isinstance(v, Enum):
-            return v.value
-        else:
-            return v
-    elif isinstance(v, (float, int, Decimal)):
-        # is there anything else we want to add here? If you think so, create an issue.
-        return str(v)
-    elif isinstance(v, (bytes, bytearray)):
-        return v.decode()
-    else:
-        raise errors.StrError()
-
-
-def strict_str_validator(v: Any) -> Union[str]:
-    if isinstance(v, str) and not isinstance(v, Enum):
-        return v
-    raise errors.StrError()
-
-
-def bytes_validator(v: Any) -> Union[bytes]:
-    if isinstance(v, bytes):
-        return v
-    elif isinstance(v, bytearray):
-        return bytes(v)
-    elif isinstance(v, str):
-        return v.encode()
-    elif isinstance(v, (float, int, Decimal)):
-        return str(v).encode()
-    else:
-        raise errors.BytesError()
-
-
-def strict_bytes_validator(v: Any) -> Union[bytes]:
-    if isinstance(v, bytes):
-        return v
-    elif isinstance(v, bytearray):
-        return bytes(v)
-    else:
-        raise errors.BytesError()
-
-
-BOOL_FALSE = {0, '0', 'off', 'f', 'false', 'n', 'no'}
-BOOL_TRUE = {1, '1', 'on', 't', 'true', 'y', 'yes'}
-
-
-def bool_validator(v: Any) -> bool:
-    if v is True or v is False:
-        return v
-    if isinstance(v, bytes):
-        v = v.decode()
-    if isinstance(v, str):
-        v = v.lower()
-    try:
-        if v in BOOL_TRUE:
-            return True
-        if v in BOOL_FALSE:
-            return False
-    except TypeError:
-        raise errors.BoolError()
-    raise errors.BoolError()
-
-
-# matches the default limit cpython, see https://github.com/python/cpython/pull/96500
-max_str_int = 4_300
-
-
-def int_validator(v: Any) -> int:
-    if isinstance(v, int) and not (v is True or v is False):
-        return v
-
-    # see https://github.com/pydantic/pydantic/issues/1477 and in turn, https://github.com/python/cpython/issues/95778
-    # this check should be unnecessary once patch releases are out for 3.7, 3.8, 3.9 and 3.10
-    # but better to check here until then.
-    # NOTICE: this does not fully protect user from the DOS risk since the standard library JSON implementation
-    # (and other std lib modules like xml) use `int()` and are likely called before this, the best workaround is to
-    # 1. update to the latest patch release of python once released, 2. use a different JSON library like ujson
-    if isinstance(v, (str, bytes, bytearray)) and len(v) > max_str_int:
-        raise errors.IntegerError()
-
-    try:
-        return int(v)
-    except (TypeError, ValueError, OverflowError):
-        raise errors.IntegerError()
-
-
-def strict_int_validator(v: Any) -> int:
-    if isinstance(v, int) and not (v is True or v is False):
-        return v
-    raise errors.IntegerError()
-
-
-def float_validator(v: Any) -> float:
-    if isinstance(v, float):
-        return v
-
-    try:
-        return float(v)
-    except (TypeError, ValueError):
-        raise errors.FloatError()
-
-
-def strict_float_validator(v: Any) -> float:
-    if isinstance(v, float):
-        return v
-    raise errors.FloatError()
-
-
-def float_finite_validator(v: 'Number', field: 'ModelField', config: 'BaseConfig') -> 'Number':
-    allow_inf_nan = getattr(field.type_, 'allow_inf_nan', None)
-    if allow_inf_nan is None:
-        allow_inf_nan = config.allow_inf_nan
-
-    if allow_inf_nan is False and (math.isnan(v) or math.isinf(v)):
-        raise errors.NumberNotFiniteError()
-    return v
-
-
-def number_multiple_validator(v: 'Number', field: 'ModelField') -> 'Number':
-    field_type: ConstrainedNumber = field.type_
-    if field_type.multiple_of is not None:
-        mod = float(v) / float(field_type.multiple_of) % 1
-        if not almost_equal_floats(mod, 0.0) and not almost_equal_floats(mod, 1.0):
-            raise errors.NumberNotMultipleError(multiple_of=field_type.multiple_of)
-    return v
-
-
-def number_size_validator(v: 'Number', field: 'ModelField') -> 'Number':
-    field_type: ConstrainedNumber = field.type_
-    if field_type.gt is not None and not v > field_type.gt:
-        raise errors.NumberNotGtError(limit_value=field_type.gt)
-    elif field_type.ge is not None and not v >= field_type.ge:
-        raise errors.NumberNotGeError(limit_value=field_type.ge)
-
-    if field_type.lt is not None and not v < field_type.lt:
-        raise errors.NumberNotLtError(limit_value=field_type.lt)
-    if field_type.le is not None and not v <= field_type.le:
-        raise errors.NumberNotLeError(limit_value=field_type.le)
-
-    return v
-
-
-def constant_validator(v: 'Any', field: 'ModelField') -> 'Any':
-    """Validate ``const`` fields.
-
-    The value provided for a ``const`` field must be equal to the default value
-    of the field. This is to support the keyword of the same name in JSON
-    Schema.
-    """
-    if v != field.default:
-        raise errors.WrongConstantError(given=v, permitted=[field.default])
-
-    return v
-
-
-def anystr_length_validator(v: 'StrBytes', config: 'BaseConfig') -> 'StrBytes':
-    v_len = len(v)
-
-    min_length = config.min_anystr_length
-    if v_len < min_length:
-        raise errors.AnyStrMinLengthError(limit_value=min_length)
-
-    max_length = config.max_anystr_length
-    if max_length is not None and v_len > max_length:
-        raise errors.AnyStrMaxLengthError(limit_value=max_length)
-
-    return v
-
-
-def anystr_strip_whitespace(v: 'StrBytes') -> 'StrBytes':
-    return v.strip()
-
-
-def anystr_upper(v: 'StrBytes') -> 'StrBytes':
-    return v.upper()
-
-
-def anystr_lower(v: 'StrBytes') -> 'StrBytes':
-    return v.lower()
-
-
-def ordered_dict_validator(v: Any) -> 'AnyOrderedDict':
-    if isinstance(v, OrderedDict):
-        return v
-
-    try:
-        return OrderedDict(v)
-    except (TypeError, ValueError):
-        raise errors.DictError()
-
-
-def dict_validator(v: Any) -> Dict[Any, Any]:
-    if isinstance(v, dict):
-        return v
-
-    try:
-        return dict(v)
-    except (TypeError, ValueError):
-        raise errors.DictError()
-
-
-def list_validator(v: Any) -> List[Any]:
-    if isinstance(v, list):
-        return v
-    elif sequence_like(v):
-        return list(v)
-    else:
-        raise errors.ListError()
-
-
-def tuple_validator(v: Any) -> Tuple[Any, ...]:
-    if isinstance(v, tuple):
-        return v
-    elif sequence_like(v):
-        return tuple(v)
-    else:
-        raise errors.TupleError()
-
-
-def set_validator(v: Any) -> Set[Any]:
-    if isinstance(v, set):
-        return v
-    elif sequence_like(v):
-        return set(v)
-    else:
-        raise errors.SetError()
-
-
-def frozenset_validator(v: Any) -> FrozenSet[Any]:
-    if isinstance(v, frozenset):
-        return v
-    elif sequence_like(v):
-        return frozenset(v)
-    else:
-        raise errors.FrozenSetError()
-
-
-def deque_validator(v: Any) -> Deque[Any]:
-    if isinstance(v, deque):
-        return v
-    elif sequence_like(v):
-        return deque(v)
-    else:
-        raise errors.DequeError()
-
-
-def enum_member_validator(v: Any, field: 'ModelField', config: 'BaseConfig') -> Enum:
-    try:
-        enum_v = field.type_(v)
-    except ValueError:
-        # field.type_ should be an enum, so will be iterable
-        raise errors.EnumMemberError(enum_values=list(field.type_))
-    return enum_v.value if config.use_enum_values else enum_v
-
-
-def uuid_validator(v: Any, field: 'ModelField') -> UUID:
-    try:
-        if isinstance(v, str):
-            v = UUID(v)
-        elif isinstance(v, (bytes, bytearray)):
-            try:
-                v = UUID(v.decode())
-            except ValueError:
-                # 16 bytes in big-endian order as the bytes argument fail
-                # the above check
-                v = UUID(bytes=v)
-    except ValueError:
-        raise errors.UUIDError()
-
-    if not isinstance(v, UUID):
-        raise errors.UUIDError()
-
-    required_version = getattr(field.type_, '_required_version', None)
-    if required_version and v.version != required_version:
-        raise errors.UUIDVersionError(required_version=required_version)
-
-    return v
-
-
-def decimal_validator(v: Any) -> Decimal:
-    if isinstance(v, Decimal):
-        return v
-    elif isinstance(v, (bytes, bytearray)):
-        v = v.decode()
-
-    v = str(v).strip()
-
-    try:
-        v = Decimal(v)
-    except DecimalException:
-        raise errors.DecimalError()
-
-    if not v.is_finite():
-        raise errors.DecimalIsNotFiniteError()
-
-    return v
-
-
-def hashable_validator(v: Any) -> Hashable:
-    if isinstance(v, Hashable):
-        return v
-
-    raise errors.HashableError()
-
-
-def ip_v4_address_validator(v: Any) -> IPv4Address:
-    if isinstance(v, IPv4Address):
-        return v
-
-    try:
-        return IPv4Address(v)
-    except ValueError:
-        raise errors.IPv4AddressError()
-
-
-def ip_v6_address_validator(v: Any) -> IPv6Address:
-    if isinstance(v, IPv6Address):
-        return v
-
-    try:
-        return IPv6Address(v)
-    except ValueError:
-        raise errors.IPv6AddressError()
-
-
-def ip_v4_network_validator(v: Any) -> IPv4Network:
-    """
-    Assume IPv4Network initialised with a default ``strict`` argument
-
-    See more:
-    https://docs.python.org/library/ipaddress.html#ipaddress.IPv4Network
-    """
-    if isinstance(v, IPv4Network):
-        return v
-
-    try:
-        return IPv4Network(v)
-    except ValueError:
-        raise errors.IPv4NetworkError()
-
-
-def ip_v6_network_validator(v: Any) -> IPv6Network:
-    """
-    Assume IPv6Network initialised with a default ``strict`` argument
-
-    See more:
-    https://docs.python.org/library/ipaddress.html#ipaddress.IPv6Network
-    """
-    if isinstance(v, IPv6Network):
-        return v
-
-    try:
-        return IPv6Network(v)
-    except ValueError:
-        raise errors.IPv6NetworkError()
-
-
-def ip_v4_interface_validator(v: Any) -> IPv4Interface:
-    if isinstance(v, IPv4Interface):
-        return v
-
-    try:
-        return IPv4Interface(v)
-    except ValueError:
-        raise errors.IPv4InterfaceError()
-
-
-def ip_v6_interface_validator(v: Any) -> IPv6Interface:
-    if isinstance(v, IPv6Interface):
-        return v
-
-    try:
-        return IPv6Interface(v)
-    except ValueError:
-        raise errors.IPv6InterfaceError()
-
-
-def path_validator(v: Any) -> Path:
-    if isinstance(v, Path):
-        return v
-
-    try:
-        return Path(v)
-    except TypeError:
-        raise errors.PathError()
-
-
-def path_exists_validator(v: Any) -> Path:
-    if not v.exists():
-        raise errors.PathNotExistsError(path=v)
-
-    return v
-
-
-def callable_validator(v: Any) -> AnyCallable:
-    """
-    Perform a simple check if the value is callable.
-
-    Note: complete matching of argument type hints and return types is not performed
-    """
-    if callable(v):
-        return v
-
-    raise errors.CallableError(value=v)
-
-
-def enum_validator(v: Any) -> Enum:
-    if isinstance(v, Enum):
-        return v
-
-    raise errors.EnumError(value=v)
-
-
-def int_enum_validator(v: Any) -> IntEnum:
-    if isinstance(v, IntEnum):
-        return v
-
-    raise errors.IntEnumError(value=v)
-
-
-def make_literal_validator(type_: Any) -> Callable[[Any], Any]:
-    permitted_choices = all_literal_values(type_)
-
-    # To have a O(1) complexity and still return one of the values set inside the `Literal`,
-    # we create a dict with the set values (a set causes some problems with the way intersection works).
-    # In some cases the set value and checked value can indeed be different (see `test_literal_validator_str_enum`)
-    allowed_choices = {v: v for v in permitted_choices}
-
-    def literal_validator(v: Any) -> Any:
-        try:
-            return allowed_choices[v]
-        except KeyError:
-            raise errors.WrongConstantError(given=v, permitted=permitted_choices)
-
-    return literal_validator
-
-
-def constr_length_validator(v: 'StrBytes', field: 'ModelField', config: 'BaseConfig') -> 'StrBytes':
-    v_len = len(v)
-
-    min_length = field.type_.min_length if field.type_.min_length is not None else config.min_anystr_length
-    if v_len < min_length:
-        raise errors.AnyStrMinLengthError(limit_value=min_length)
-
-    max_length = field.type_.max_length if field.type_.max_length is not None else config.max_anystr_length
-    if max_length is not None and v_len > max_length:
-        raise errors.AnyStrMaxLengthError(limit_value=max_length)
-
-    return v
-
-
-def constr_strip_whitespace(v: 'StrBytes', field: 'ModelField', config: 'BaseConfig') -> 'StrBytes':
-    strip_whitespace = field.type_.strip_whitespace or config.anystr_strip_whitespace
-    if strip_whitespace:
-        v = v.strip()
-
-    return v
-
-
-def constr_upper(v: 'StrBytes', field: 'ModelField', config: 'BaseConfig') -> 'StrBytes':
-    upper = field.type_.to_upper or config.anystr_upper
-    if upper:
-        v = v.upper()
-
-    return v
-
-
-def constr_lower(v: 'StrBytes', field: 'ModelField', config: 'BaseConfig') -> 'StrBytes':
-    lower = field.type_.to_lower or config.anystr_lower
-    if lower:
-        v = v.lower()
-    return v
-
-
-def validate_json(v: Any, config: 'BaseConfig') -> Any:
-    if v is None:
-        # pass None through to other validators
-        return v
-    try:
-        return config.json_loads(v)  # type: ignore
-    except ValueError:
-        raise errors.JsonError()
-    except TypeError:
-        raise errors.JsonTypeError()
-
-
-T = TypeVar('T')
-
-
-def make_arbitrary_type_validator(type_: Type[T]) -> Callable[[T], T]:
-    def arbitrary_type_validator(v: Any) -> T:
-        if isinstance(v, type_):
-            return v
-        raise errors.ArbitraryTypeError(expected_arbitrary_type=type_)
-
-    return arbitrary_type_validator
-
-
-def make_class_validator(type_: Type[T]) -> Callable[[Any], Type[T]]:
-    def class_validator(v: Any) -> Type[T]:
-        if lenient_issubclass(v, type_):
-            return v
-        raise errors.SubclassError(expected_class=type_)
-
-    return class_validator
-
-
-def any_class_validator(v: Any) -> Type[T]:
-    if isinstance(v, type):
-        return v
-    raise errors.ClassError()
-
-
-def none_validator(v: Any) -> 'Literal[None]':
-    if v is None:
-        return v
-    raise errors.NotNoneError()
-
-
-def pattern_validator(v: Any) -> Pattern[str]:
-    if isinstance(v, Pattern):
-        return v
-
-    str_value = str_validator(v)
-
-    try:
-        return re.compile(str_value)
-    except re.error:
-        raise errors.PatternError()
-
-
-NamedTupleT = TypeVar('NamedTupleT', bound=NamedTuple)
-
-
-def make_namedtuple_validator(
-    namedtuple_cls: Type[NamedTupleT], config: Type['BaseConfig']
-) -> Callable[[Tuple[Any, ...]], NamedTupleT]:
-    from .annotated_types import create_model_from_namedtuple
-
-    NamedTupleModel = create_model_from_namedtuple(
-        namedtuple_cls,
-        __config__=config,
-        __module__=namedtuple_cls.__module__,
-    )
-    namedtuple_cls.__pydantic_model__ = NamedTupleModel  # type: ignore[attr-defined]
-
-    def namedtuple_validator(values: Tuple[Any, ...]) -> NamedTupleT:
-        annotations = NamedTupleModel.__annotations__
-
-        if len(values) > len(annotations):
-            raise errors.ListMaxLengthError(limit_value=len(annotations))
-
-        dict_values: Dict[str, Any] = dict(zip(annotations, values))
-        validated_dict_values: Dict[str, Any] = dict(NamedTupleModel(**dict_values))
-        return namedtuple_cls(**validated_dict_values)
-
-    return namedtuple_validator
-
-
-def make_typeddict_validator(
-    typeddict_cls: Type['TypedDict'], config: Type['BaseConfig']  # type: ignore[valid-type]
-) -> Callable[[Any], Dict[str, Any]]:
-    from .annotated_types import create_model_from_typeddict
-
-    TypedDictModel = create_model_from_typeddict(
-        typeddict_cls,
-        __config__=config,
-        __module__=typeddict_cls.__module__,
-    )
-    typeddict_cls.__pydantic_model__ = TypedDictModel  # type: ignore[attr-defined]
-
-    def typeddict_validator(values: 'TypedDict') -> Dict[str, Any]:  # type: ignore[valid-type]
-        return TypedDictModel.parse_obj(values).dict(exclude_unset=True)
-
-    return typeddict_validator
-
-
-class IfConfig:
-    def __init__(self, validator: AnyCallable, *config_attr_names: str, ignored_value: Any = False) -> None:
-        self.validator = validator
-        self.config_attr_names = config_attr_names
-        self.ignored_value = ignored_value
-
-    def check(self, config: Type['BaseConfig']) -> bool:
-        return any(getattr(config, name) not in {None, self.ignored_value} for name in self.config_attr_names)
-
-
-# order is important here, for example: bool is a subclass of int so has to come first, datetime before date same,
-# IPv4Interface before IPv4Address, etc
-_VALIDATORS: List[Tuple[Type[Any], List[Any]]] = [
-    (IntEnum, [int_validator, enum_member_validator]),
-    (Enum, [enum_member_validator]),
-    (
-        str,
-        [
-            str_validator,
-            IfConfig(anystr_strip_whitespace, 'anystr_strip_whitespace'),
-            IfConfig(anystr_upper, 'anystr_upper'),
-            IfConfig(anystr_lower, 'anystr_lower'),
-            IfConfig(anystr_length_validator, 'min_anystr_length', 'max_anystr_length'),
-        ],
-    ),
-    (
-        bytes,
-        [
-            bytes_validator,
-            IfConfig(anystr_strip_whitespace, 'anystr_strip_whitespace'),
-            IfConfig(anystr_upper, 'anystr_upper'),
-            IfConfig(anystr_lower, 'anystr_lower'),
-            IfConfig(anystr_length_validator, 'min_anystr_length', 'max_anystr_length'),
-        ],
-    ),
-    (bool, [bool_validator]),
-    (int, [int_validator]),
-    (float, [float_validator, IfConfig(float_finite_validator, 'allow_inf_nan', ignored_value=True)]),
-    (Path, [path_validator]),
-    (datetime, [parse_datetime]),
-    (date, [parse_date]),
-    (time, [parse_time]),
-    (timedelta, [parse_duration]),
-    (OrderedDict, [ordered_dict_validator]),
-    (dict, [dict_validator]),
-    (list, [list_validator]),
-    (tuple, [tuple_validator]),
-    (set, [set_validator]),
-    (frozenset, [frozenset_validator]),
-    (deque, [deque_validator]),
-    (UUID, [uuid_validator]),
-    (Decimal, [decimal_validator]),
-    (IPv4Interface, [ip_v4_interface_validator]),
-    (IPv6Interface, [ip_v6_interface_validator]),
-    (IPv4Address, [ip_v4_address_validator]),
-    (IPv6Address, [ip_v6_address_validator]),
-    (IPv4Network, [ip_v4_network_validator]),
-    (IPv6Network, [ip_v6_network_validator]),
-]
-
-
-def find_validators(  # noqa: C901 (ignore complexity)
-    type_: Type[Any], config: Type['BaseConfig']
-) -> Generator[AnyCallable, None, None]:
-    from .dataclasses import is_builtin_dataclass, make_dataclass_validator
-
-    if type_ is Any or type_ is object:
-        return
-    type_type = type_.__class__
-    if type_type == ForwardRef or type_type == TypeVar:
-        return
-
-    if is_none_type(type_):
-        yield none_validator
-        return
-    if type_ is Pattern or type_ is re.Pattern:
-        yield pattern_validator
-        return
-    if type_ is Hashable or type_ is CollectionsHashable:
-        yield hashable_validator
-        return
-    if is_callable_type(type_):
-        yield callable_validator
-        return
-    if is_literal_type(type_):
-        yield make_literal_validator(type_)
-        return
-    if is_builtin_dataclass(type_):
-        yield from make_dataclass_validator(type_, config)
-        return
-    if type_ is Enum:
-        yield enum_validator
-        return
-    if type_ is IntEnum:
-        yield int_enum_validator
-        return
-    if is_namedtuple(type_):
-        yield tuple_validator
-        yield make_namedtuple_validator(type_, config)
-        return
-    if is_typeddict(type_):
-        yield make_typeddict_validator(type_, config)
-        return
-
-    class_ = get_class(type_)
-    if class_ is not None:
-        if class_ is not Any and isinstance(class_, type):
-            yield make_class_validator(class_)
-        else:
-            yield any_class_validator
-        return
-
-    for val_type, validators in _VALIDATORS:
-        try:
-            if issubclass(type_, val_type):
-                for v in validators:
-                    if isinstance(v, IfConfig):
-                        if v.check(config):
-                            yield v.validator
-                    else:
-                        yield v
-                return
-        except TypeError:
-            raise RuntimeError(f'error checking inheritance of {type_!r} (type: {display_as_type(type_)})')
-
-    if config.arbitrary_types_allowed:
-        yield make_arbitrary_type_validator(type_)
-    else:
-        raise RuntimeError(f'no validator found for {type_}, see `arbitrary_types_allowed` in Config')
+__getattr__ = getattr_migration(__name__)
diff --git a/lib/pydantic/version.py b/lib/pydantic/version.py
index 32c61633..3e233771 100644
--- a/lib/pydantic/version.py
+++ b/lib/pydantic/version.py
@@ -1,38 +1,80 @@
-__all__ = 'compiled', 'VERSION', 'version_info'
+"""The `version` module holds the version information for Pydantic."""
+from __future__ import annotations as _annotations
 
-VERSION = '1.10.2'
+__all__ = 'VERSION', 'version_info'
 
-try:
-    import cython  # type: ignore
-except ImportError:
-    compiled: bool = False
-else:  # pragma: no cover
-    try:
-        compiled = cython.compiled
-    except AttributeError:
-        compiled = False
+VERSION = '2.6.4'
+"""The version of Pydantic."""
+
+
+def version_short() -> str:
+    """Return the `major.minor` part of Pydantic version.
+
+    It returns '2.1' if Pydantic version is '2.1.1'.
+    """
+    return '.'.join(VERSION.split('.')[:2])
 
 
 def version_info() -> str:
+    """Return complete version information for Pydantic and its dependencies."""
+    import importlib.metadata as importlib_metadata
+    import os
     import platform
     import sys
-    from importlib import import_module
     from pathlib import Path
 
-    optional_deps = []
-    for p in ('devtools', 'dotenv', 'email-validator', 'typing-extensions'):
-        try:
-            import_module(p.replace('-', '_'))
-        except ImportError:
-            continue
-        optional_deps.append(p)
+    import pydantic_core._pydantic_core as pdc
+
+    from ._internal import _git as git
+
+    # get data about packages that are closely related to pydantic, use pydantic or often conflict with pydantic
+    package_names = {
+        'email-validator',
+        'fastapi',
+        'mypy',
+        'pydantic-extra-types',
+        'pydantic-settings',
+        'pyright',
+        'typing_extensions',
+    }
+    related_packages = []
+
+    for dist in importlib_metadata.distributions():
+        name = dist.metadata['Name']
+        if name in package_names:
+            related_packages.append(f'{name}-{dist.version}')
+
+    pydantic_dir = os.path.abspath(os.path.dirname(os.path.dirname(__file__)))
+    most_recent_commit = (
+        git.git_revision(pydantic_dir) if git.is_git_repo(pydantic_dir) and git.have_git() else 'unknown'
+    )
 
     info = {
         'pydantic version': VERSION,
-        'pydantic compiled': compiled,
+        'pydantic-core version': pdc.__version__,
+        'pydantic-core build': getattr(pdc, 'build_info', None) or pdc.build_profile,
         'install path': Path(__file__).resolve().parent,
         'python version': sys.version,
         'platform': platform.platform(),
-        'optional deps. installed': optional_deps,
+        'related packages': ' '.join(related_packages),
+        'commit': most_recent_commit,
     }
     return '\n'.join('{:>30} {}'.format(k + ':', str(v).replace('\n', ' ')) for k, v in info.items())
+
+
+def parse_mypy_version(version: str) -> tuple[int, ...]:
+    """Parse mypy string version to tuple of ints.
+
+    This function is included here rather than the mypy plugin file because the mypy plugin file cannot be imported
+    outside a mypy run.
+
+    It parses normal version like `0.930` and dev version
+    like `0.940+dev.04cac4b5d911c4f9529e6ce86a27b44f28846f5d.dirty`.
+
+    Args:
+        version: The mypy version string.
+
+    Returns:
+        A tuple of ints. e.g. (0, 930).
+    """
+    return tuple(map(int, version.partition('+')[0].split('.')))
diff --git a/lib/pydantic/warnings.py b/lib/pydantic/warnings.py
new file mode 100644
index 00000000..aedd4fba
--- /dev/null
+++ b/lib/pydantic/warnings.py
@@ -0,0 +1,58 @@
+"""Pydantic-specific warnings."""
+from __future__ import annotations as _annotations
+
+from .version import version_short
+
+__all__ = 'PydanticDeprecatedSince20', 'PydanticDeprecationWarning'
+
+
+class PydanticDeprecationWarning(DeprecationWarning):
+    """A Pydantic specific deprecation warning.
+
+    This warning is raised when using deprecated functionality in Pydantic. It provides information on when the
+    deprecation was introduced and the expected version in which the corresponding functionality will be removed.
+
+    Attributes:
+        message: Description of the warning.
+        since: Pydantic version in what the deprecation was introduced.
+        expected_removal: Pydantic version in what the corresponding functionality expected to be removed.
+    """
+
+    message: str
+    since: tuple[int, int]
+    expected_removal: tuple[int, int]
+
+    def __init__(
+        self, message: str, *args: object, since: tuple[int, int], expected_removal: tuple[int, int] | None = None
+    ) -> None:
+        super().__init__(message, *args)
+        self.message = message.rstrip('.')
+        self.since = since
+        self.expected_removal = expected_removal if expected_removal is not None else (since[0] + 1, 0)
+
+    def __str__(self) -> str:
+        message = (
+            f'{self.message}. Deprecated in Pydantic V{self.since[0]}.{self.since[1]}'
+            f' to be removed in V{self.expected_removal[0]}.{self.expected_removal[1]}.'
+        )
+        if self.since == (2, 0):
+            message += f' See Pydantic V2 Migration Guide at https://errors.pydantic.dev/{version_short()}/migration/'
+        return message
+
+
+class PydanticDeprecatedSince20(PydanticDeprecationWarning):
+    """A specific `PydanticDeprecationWarning` subclass defining functionality deprecated since Pydantic 2.0."""
+
+    def __init__(self, message: str, *args: object) -> None:
+        super().__init__(message, *args, since=(2, 0), expected_removal=(3, 0))
+
+
+class PydanticDeprecatedSince26(PydanticDeprecationWarning):
+    """A specific `PydanticDeprecationWarning` subclass defining functionality deprecated since Pydantic 2.6."""
+
+    def __init__(self, message: str, *args: object) -> None:
+        super().__init__(message, *args, since=(2, 0), expected_removal=(3, 0))
+
+
+class GenericBeforeBaseModelWarning(Warning):
+    pass
diff --git a/lib/pydantic_core/__init__.py b/lib/pydantic_core/__init__.py
new file mode 100644
index 00000000..5b2655c9
--- /dev/null
+++ b/lib/pydantic_core/__init__.py
@@ -0,0 +1,139 @@
+from __future__ import annotations
+
+import sys as _sys
+from typing import Any as _Any
+
+from ._pydantic_core import (
+    ArgsKwargs,
+    MultiHostUrl,
+    PydanticCustomError,
+    PydanticKnownError,
+    PydanticOmit,
+    PydanticSerializationError,
+    PydanticSerializationUnexpectedValue,
+    PydanticUndefined,
+    PydanticUndefinedType,
+    PydanticUseDefault,
+    SchemaError,
+    SchemaSerializer,
+    SchemaValidator,
+    Some,
+    TzInfo,
+    Url,
+    ValidationError,
+    __version__,
+    from_json,
+    to_json,
+    to_jsonable_python,
+    validate_core_schema,
+)
+from .core_schema import CoreConfig, CoreSchema, CoreSchemaType, ErrorType
+
+if _sys.version_info < (3, 11):
+    from typing_extensions import NotRequired as _NotRequired
+else:
+    from typing import NotRequired as _NotRequired
+
+if _sys.version_info < (3, 9):
+    from typing_extensions import TypedDict as _TypedDict
+else:
+    from typing import TypedDict as _TypedDict
+
+__all__ = [
+    '__version__',
+    'CoreConfig',
+    'CoreSchema',
+    'CoreSchemaType',
+    'SchemaValidator',
+    'SchemaSerializer',
+    'Some',
+    'Url',
+    'MultiHostUrl',
+    'ArgsKwargs',
+    'PydanticUndefined',
+    'PydanticUndefinedType',
+    'SchemaError',
+    'ErrorDetails',
+    'InitErrorDetails',
+    'ValidationError',
+    'PydanticCustomError',
+    'PydanticKnownError',
+    'PydanticOmit',
+    'PydanticUseDefault',
+    'PydanticSerializationError',
+    'PydanticSerializationUnexpectedValue',
+    'TzInfo',
+    'to_json',
+    'from_json',
+    'to_jsonable_python',
+    'validate_core_schema',
+]
+
+
+class ErrorDetails(_TypedDict):
+    type: str
+    """
+    The type of error that occurred, this is an identifier designed for
+    programmatic use that will change rarely or never.
+
+    `type` is unique for each error message, and can hence be used as an identifier to build custom error messages.
+    """
+    loc: tuple[int | str, ...]
+    """Tuple of strings and ints identifying where in the schema the error occurred."""
+    msg: str
+    """A human readable error message."""
+    input: _Any
+    """The input data at this `loc` that caused the error."""
+    ctx: _NotRequired[dict[str, _Any]]
+    """
+    Values which are required to render the error message, and could hence be useful in rendering custom error messages.
+    Also useful for passing custom error data forward.
+    """
+
+
+class InitErrorDetails(_TypedDict):
+    type: str | PydanticCustomError
+    """The type of error that occurred, this should a "slug" identifier that changes rarely or never."""
+    loc: _NotRequired[tuple[int | str, ...]]
+    """Tuple of strings and ints identifying where in the schema the error occurred."""
+    input: _Any
+    """The input data at this `loc` that caused the error."""
+    ctx: _NotRequired[dict[str, _Any]]
+    """
+    Values which are required to render the error message, and could hence be useful in rendering custom error messages.
+    Also useful for passing custom error data forward.
+    """
+
+
+class ErrorTypeInfo(_TypedDict):
+    """
+    Gives information about errors.
+    """
+
+    type: ErrorType
+    """The type of error that occurred, this should a "slug" identifier that changes rarely or never."""
+    message_template_python: str
+    """String template to render a human readable error message from using context, when the input is Python."""
+    example_message_python: str
+    """Example of a human readable error message, when the input is Python."""
+    message_template_json: _NotRequired[str]
+    """String template to render a human readable error message from using context, when the input is JSON data."""
+    example_message_json: _NotRequired[str]
+    """Example of a human readable error message, when the input is JSON data."""
+    example_context: dict[str, _Any] | None
+    """Example of context values."""
+
+
+class MultiHostHost(_TypedDict):
+    """
+    A host part of a multi-host URL.
+    """
+
+    username: str | None
+    """The username part of this host, or `None`."""
+    password: str | None
+    """The password part of this host, or `None`."""
+    host: str | None
+    """The host part of this host, or `None`."""
+    port: int | None
+    """The port part of this host, or `None`."""
diff --git a/lib/pydantic_core/_pydantic_core.pyi b/lib/pydantic_core/_pydantic_core.pyi
new file mode 100644
index 00000000..a7b727f8
--- /dev/null
+++ b/lib/pydantic_core/_pydantic_core.pyi
@@ -0,0 +1,882 @@
+from __future__ import annotations
+
+import datetime
+import sys
+from typing import Any, Callable, Generic, Optional, Type, TypeVar
+
+from pydantic_core import ErrorDetails, ErrorTypeInfo, InitErrorDetails, MultiHostHost
+from pydantic_core.core_schema import CoreConfig, CoreSchema, ErrorType
+
+if sys.version_info < (3, 8):
+    from typing_extensions import final
+else:
+    from typing import final
+
+if sys.version_info < (3, 11):
+    from typing_extensions import Literal, LiteralString, Self, TypeAlias
+else:
+    from typing import Literal, LiteralString, Self, TypeAlias
+
+from _typeshed import SupportsAllComparisons
+
+__all__ = [
+    '__version__',
+    'build_profile',
+    'build_info',
+    '_recursion_limit',
+    'ArgsKwargs',
+    'SchemaValidator',
+    'SchemaSerializer',
+    'Url',
+    'MultiHostUrl',
+    'SchemaError',
+    'ValidationError',
+    'PydanticCustomError',
+    'PydanticKnownError',
+    'PydanticOmit',
+    'PydanticUseDefault',
+    'PydanticSerializationError',
+    'PydanticSerializationUnexpectedValue',
+    'PydanticUndefined',
+    'PydanticUndefinedType',
+    'Some',
+    'to_json',
+    'from_json',
+    'to_jsonable_python',
+    'list_all_errors',
+    'TzInfo',
+    'validate_core_schema',
+]
+__version__: str
+build_profile: str
+build_info: str
+_recursion_limit: int
+
+_T = TypeVar('_T', default=Any, covariant=True)
+
+_StringInput: TypeAlias = 'dict[str, _StringInput]'
+
+@final
+class Some(Generic[_T]):
+    """
+    Similar to Rust's [`Option::Some`](https://doc.rust-lang.org/std/option/enum.Option.html) type, this
+    identifies a value as being present, and provides a way to access it.
+
+    Generally used in a union with `None` to different between "some value which could be None" and no value.
+    """
+
+    __match_args__ = ('value',)
+
+    @property
+    def value(self) -> _T:
+        """
+        Returns the value wrapped by `Some`.
+        """
+    @classmethod
+    def __class_getitem__(cls, __item: Any) -> Type[Self]: ...
+
+@final
+class SchemaValidator:
+    """
+    `SchemaValidator` is the Python wrapper for `pydantic-core`'s Rust validation logic, internally it owns one
+    `CombinedValidator` which may in turn own more `CombinedValidator`s which make up the full schema validator.
+    """
+
+    def __new__(cls, schema: CoreSchema, config: CoreConfig | None = None) -> Self:
+        """
+        Create a new SchemaValidator.
+
+        Arguments:
+            schema: The [`CoreSchema`][pydantic_core.core_schema.CoreSchema] to use for validation.
+            config: Optionally a [`CoreConfig`][pydantic_core.core_schema.CoreConfig] to configure validation.
+        """
+    @property
+    def title(self) -> str:
+        """
+        The title of the schema, as used in the heading of [`ValidationError.__str__()`][pydantic_core.ValidationError].
+        """
+    def validate_python(
+        self,
+        input: Any,
+        *,
+        strict: bool | None = None,
+        from_attributes: bool | None = None,
+        context: 'dict[str, Any] | None' = None,
+        self_instance: Any | None = None,
+    ) -> Any:
+        """
+        Validate a Python object against the schema and return the validated object.
+
+        Arguments:
+            input: The Python object to validate.
+            strict: Whether to validate the object in strict mode.
+                If `None`, the value of [`CoreConfig.strict`][pydantic_core.core_schema.CoreConfig] is used.
+            from_attributes: Whether to validate objects as inputs to models by extracting attributes.
+                If `None`, the value of [`CoreConfig.from_attributes`][pydantic_core.core_schema.CoreConfig] is used.
+            context: The context to use for validation, this is passed to functional validators as
+                [`info.context`][pydantic_core.core_schema.ValidationInfo.context].
+            self_instance: An instance of a model set attributes on from validation, this is used when running
+                validation from the `__init__` method of a model.
+
+        Raises:
+            ValidationError: If validation fails.
+            Exception: Other error types maybe raised if internal errors occur.
+
+        Returns:
+            The validated object.
+        """
+    def isinstance_python(
+        self,
+        input: Any,
+        *,
+        strict: bool | None = None,
+        from_attributes: bool | None = None,
+        context: 'dict[str, Any] | None' = None,
+        self_instance: Any | None = None,
+    ) -> bool:
+        """
+        Similar to [`validate_python()`][pydantic_core.SchemaValidator.validate_python] but returns a boolean.
+
+        Arguments match `validate_python()`. This method will not raise `ValidationError`s but will raise internal
+        errors.
+
+        Returns:
+            `True` if validation succeeds, `False` if validation fails.
+        """
+    def validate_json(
+        self,
+        input: str | bytes | bytearray,
+        *,
+        strict: bool | None = None,
+        context: 'dict[str, Any] | None' = None,
+        self_instance: Any | None = None,
+    ) -> Any:
+        """
+        Validate JSON data directly against the schema and return the validated Python object.
+
+        This method should be significantly faster than `validate_python(json.loads(json_data))` as it avoids the
+        need to create intermediate Python objects
+
+        It also handles constructing the correct Python type even in strict mode, where
+        `validate_python(json.loads(json_data))` would fail validation.
+
+        Arguments:
+            input: The JSON data to validate.
+            strict: Whether to validate the object in strict mode.
+                If `None`, the value of [`CoreConfig.strict`][pydantic_core.core_schema.CoreConfig] is used.
+            context: The context to use for validation, this is passed to functional validators as
+                [`info.context`][pydantic_core.core_schema.ValidationInfo.context].
+            self_instance: An instance of a model set attributes on from validation.
+
+        Raises:
+            ValidationError: If validation fails or if the JSON data is invalid.
+            Exception: Other error types maybe raised if internal errors occur.
+
+        Returns:
+            The validated Python object.
+        """
+    def validate_strings(
+        self, input: _StringInput, *, strict: bool | None = None, context: 'dict[str, Any] | None' = None
+    ) -> Any:
+        """
+        Validate a string against the schema and return the validated Python object.
+
+        This is similar to `validate_json` but applies to scenarios where the input will be a string but not
+        JSON data, e.g. URL fragments, query parameters, etc.
+
+        Arguments:
+            input: The input as a string, or bytes/bytearray if `strict=False`.
+            strict: Whether to validate the object in strict mode.
+                If `None`, the value of [`CoreConfig.strict`][pydantic_core.core_schema.CoreConfig] is used.
+            context: The context to use for validation, this is passed to functional validators as
+                [`info.context`][pydantic_core.core_schema.ValidationInfo.context].
+
+        Raises:
+            ValidationError: If validation fails or if the JSON data is invalid.
+            Exception: Other error types maybe raised if internal errors occur.
+
+        Returns:
+            The validated Python object.
+        """
+    def validate_assignment(
+        self,
+        obj: Any,
+        field_name: str,
+        field_value: Any,
+        *,
+        strict: bool | None = None,
+        from_attributes: bool | None = None,
+        context: 'dict[str, Any] | None' = None,
+    ) -> dict[str, Any] | tuple[dict[str, Any], dict[str, Any] | None, set[str]]:
+        """
+        Validate an assignment to a field on a model.
+
+        Arguments:
+            obj: The model instance being assigned to.
+            field_name: The name of the field to validate assignment for.
+            field_value: The value to assign to the field.
+            strict: Whether to validate the object in strict mode.
+                If `None`, the value of [`CoreConfig.strict`][pydantic_core.core_schema.CoreConfig] is used.
+            from_attributes: Whether to validate objects as inputs to models by extracting attributes.
+                If `None`, the value of [`CoreConfig.from_attributes`][pydantic_core.core_schema.CoreConfig] is used.
+            context: The context to use for validation, this is passed to functional validators as
+                [`info.context`][pydantic_core.core_schema.ValidationInfo.context].
+
+        Raises:
+            ValidationError: If validation fails.
+            Exception: Other error types maybe raised if internal errors occur.
+
+        Returns:
+            Either the model dict or a tuple of `(model_data, model_extra, fields_set)`
+        """
+    def get_default_value(self, *, strict: bool | None = None, context: Any = None) -> Some | None:
+        """
+        Get the default value for the schema, including running default value validation.
+
+        Arguments:
+            strict: Whether to validate the default value in strict mode.
+                If `None`, the value of [`CoreConfig.strict`][pydantic_core.core_schema.CoreConfig] is used.
+            context: The context to use for validation, this is passed to functional validators as
+                [`info.context`][pydantic_core.core_schema.ValidationInfo.context].
+
+        Raises:
+            ValidationError: If validation fails.
+            Exception: Other error types maybe raised if internal errors occur.
+
+        Returns:
+            `None` if the schema has no default value, otherwise a [`Some`][pydantic_core.Some] containing the default.
+        """
+
+_IncEx: TypeAlias = set[int] | set[str] | dict[int, _IncEx] | dict[str, _IncEx] | None
+
+@final
+class SchemaSerializer:
+    """
+    `SchemaSerializer` is the Python wrapper for `pydantic-core`'s Rust serialization logic, internally it owns one
+    `CombinedSerializer` which may in turn own more `CombinedSerializer`s which make up the full schema serializer.
+    """
+
+    def __new__(cls, schema: CoreSchema, config: CoreConfig | None = None) -> Self:
+        """
+        Create a new SchemaSerializer.
+
+        Arguments:
+            schema: The [`CoreSchema`][pydantic_core.core_schema.CoreSchema] to use for serialization.
+            config: Optionally a [`CoreConfig`][pydantic_core.core_schema.CoreConfig] to to configure serialization.
+        """
+    def to_python(
+        self,
+        value: Any,
+        *,
+        mode: str | None = None,
+        include: _IncEx = None,
+        exclude: _IncEx = None,
+        by_alias: bool = True,
+        exclude_unset: bool = False,
+        exclude_defaults: bool = False,
+        exclude_none: bool = False,
+        round_trip: bool = False,
+        warnings: bool = True,
+        fallback: Callable[[Any], Any] | None = None,
+    ) -> Any:
+        """
+        Serialize/marshal a Python object to a Python object including transforming and filtering data.
+
+        Arguments:
+            value: The Python object to serialize.
+            mode: The serialization mode to use, either `'python'` or `'json'`, defaults to `'python'`. In JSON mode,
+                all values are converted to JSON compatible types, e.g. `None`, `int`, `float`, `str`, `list`, `dict`.
+            include: A set of fields to include, if `None` all fields are included.
+            exclude: A set of fields to exclude, if `None` no fields are excluded.
+            by_alias: Whether to use the alias names of fields.
+            exclude_unset: Whether to exclude fields that are not set,
+                e.g. are not included in `__pydantic_fields_set__`.
+            exclude_defaults: Whether to exclude fields that are equal to their default value.
+            exclude_none: Whether to exclude fields that have a value of `None`.
+            round_trip: Whether to enable serialization and validation round-trip support.
+            warnings: Whether to log warnings when invalid fields are encountered.
+            fallback: A function to call when an unknown value is encountered,
+                if `None` a [`PydanticSerializationError`][pydantic_core.PydanticSerializationError] error is raised.
+
+        Raises:
+            PydanticSerializationError: If serialization fails and no `fallback` function is provided.
+
+        Returns:
+            The serialized Python object.
+        """
+    def to_json(
+        self,
+        value: Any,
+        *,
+        indent: int | None = None,
+        include: _IncEx = None,
+        exclude: _IncEx = None,
+        by_alias: bool = True,
+        exclude_unset: bool = False,
+        exclude_defaults: bool = False,
+        exclude_none: bool = False,
+        round_trip: bool = False,
+        warnings: bool = True,
+        fallback: Callable[[Any], Any] | None = None,
+    ) -> bytes:
+        """
+        Serialize a Python object to JSON including transforming and filtering data.
+
+        Arguments:
+            value: The Python object to serialize.
+            indent: If `None`, the JSON will be compact, otherwise it will be pretty-printed with the indent provided.
+            include: A set of fields to include, if `None` all fields are included.
+            exclude: A set of fields to exclude, if `None` no fields are excluded.
+            by_alias: Whether to use the alias names of fields.
+            exclude_unset: Whether to exclude fields that are not set,
+                e.g. are not included in `__pydantic_fields_set__`.
+            exclude_defaults: Whether to exclude fields that are equal to their default value.
+            exclude_none: Whether to exclude fields that have a value of `None`.
+            round_trip: Whether to enable serialization and validation round-trip support.
+            warnings: Whether to log warnings when invalid fields are encountered.
+            fallback: A function to call when an unknown value is encountered,
+                if `None` a [`PydanticSerializationError`][pydantic_core.PydanticSerializationError] error is raised.
+
+        Raises:
+            PydanticSerializationError: If serialization fails and no `fallback` function is provided.
+
+        Returns:
+           JSON bytes.
+        """
+
+def to_json(
+    value: Any,
+    *,
+    indent: int | None = None,
+    include: _IncEx = None,
+    exclude: _IncEx = None,
+    by_alias: bool = True,
+    exclude_none: bool = False,
+    round_trip: bool = False,
+    timedelta_mode: Literal['iso8601', 'float'] = 'iso8601',
+    bytes_mode: Literal['utf8', 'base64'] = 'utf8',
+    inf_nan_mode: Literal['null', 'constants'] = 'constants',
+    serialize_unknown: bool = False,
+    fallback: Callable[[Any], Any] | None = None,
+) -> bytes:
+    """
+    Serialize a Python object to JSON including transforming and filtering data.
+
+    This is effectively a standalone version of [`SchemaSerializer.to_json`][pydantic_core.SchemaSerializer.to_json].
+
+    Arguments:
+        value: The Python object to serialize.
+        indent: If `None`, the JSON will be compact, otherwise it will be pretty-printed with the indent provided.
+        include: A set of fields to include, if `None` all fields are included.
+        exclude: A set of fields to exclude, if `None` no fields are excluded.
+        by_alias: Whether to use the alias names of fields.
+        exclude_none: Whether to exclude fields that have a value of `None`.
+        round_trip: Whether to enable serialization and validation round-trip support.
+        timedelta_mode: How to serialize `timedelta` objects, either `'iso8601'` or `'float'`.
+        bytes_mode: How to serialize `bytes` objects, either `'utf8'` or `'base64'`.
+        inf_nan_mode: How to serialize `Infinity`, `-Infinity` and `NaN` values, either `'null'` or `'constants'`.
+        serialize_unknown: Attempt to serialize unknown types, `str(value)` will be used, if that fails
+            `"<Unserializable {value_type} object>"` will be used.
+        fallback: A function to call when an unknown value is encountered,
+            if `None` a [`PydanticSerializationError`][pydantic_core.PydanticSerializationError] error is raised.
+
+    Raises:
+        PydanticSerializationError: If serialization fails and no `fallback` function is provided.
+
+    Returns:
+       JSON bytes.
+    """
+
+def from_json(data: str | bytes | bytearray, *, allow_inf_nan: bool = True, cache_strings: bool = True) -> Any:
+    """
+    Deserialize JSON data to a Python object.
+
+    This is effectively a faster version of `json.loads()`.
+
+    Arguments:
+        data: The JSON data to deserialize.
+        allow_inf_nan: Whether to allow `Infinity`, `-Infinity` and `NaN` values as `json.loads()` does by default.
+        cache_strings: Whether to cache strings to avoid constructing new Python objects,
+            this should have a significant impact on performance while increasing memory usage slightly.
+
+    Raises:
+        ValueError: If deserialization fails.
+
+    Returns:
+        The deserialized Python object.
+    """
+
+def to_jsonable_python(
+    value: Any,
+    *,
+    include: _IncEx = None,
+    exclude: _IncEx = None,
+    by_alias: bool = True,
+    exclude_none: bool = False,
+    round_trip: bool = False,
+    timedelta_mode: Literal['iso8601', 'float'] = 'iso8601',
+    bytes_mode: Literal['utf8', 'base64'] = 'utf8',
+    inf_nan_mode: Literal['null', 'constants'] = 'constants',
+    serialize_unknown: bool = False,
+    fallback: Callable[[Any], Any] | None = None,
+) -> Any:
+    """
+    Serialize/marshal a Python object to a JSON-serializable Python object including transforming and filtering data.
+
+    This is effectively a standalone version of
+    [`SchemaSerializer.to_python(mode='json')`][pydantic_core.SchemaSerializer.to_python].
+
+    Args:
+        value: The Python object to serialize.
+        include: A set of fields to include, if `None` all fields are included.
+        exclude: A set of fields to exclude, if `None` no fields are excluded.
+        by_alias: Whether to use the alias names of fields.
+        exclude_none: Whether to exclude fields that have a value of `None`.
+        round_trip: Whether to enable serialization and validation round-trip support.
+        timedelta_mode: How to serialize `timedelta` objects, either `'iso8601'` or `'float'`.
+        bytes_mode: How to serialize `bytes` objects, either `'utf8'` or `'base64'`.
+        inf_nan_mode: How to serialize `Infinity`, `-Infinity` and `NaN` values, either `'null'` or `'constants'`.
+        serialize_unknown: Attempt to serialize unknown types, `str(value)` will be used, if that fails
+            `"<Unserializable {value_type} object>"` will be used.
+        fallback: A function to call when an unknown value is encountered,
+            if `None` a [`PydanticSerializationError`][pydantic_core.PydanticSerializationError] error is raised.
+
+    Raises:
+        PydanticSerializationError: If serialization fails and no `fallback` function is provided.
+
+    Returns:
+        The serialized Python object.
+    """
+
+class Url(SupportsAllComparisons):
+    """
+    A URL type, internal logic uses the [url rust crate](https://docs.rs/url/latest/url/) originally developed
+    by Mozilla.
+    """
+
+    def __new__(cls, url: str) -> Self:
+        """
+        Create a new `Url` instance.
+
+        Args:
+            url: String representation of a URL.
+
+        Returns:
+            A new `Url` instance.
+
+        Raises:
+            ValidationError: If the URL is invalid.
+        """
+    @property
+    def scheme(self) -> str:
+        """
+        The scheme part of the URL.
+
+        e.g. `https` in `https://user:pass@host:port/path?query#fragment`
+        """
+    @property
+    def username(self) -> str | None:
+        """
+        The username part of the URL, or `None`.
+
+        e.g. `user` in `https://user:pass@host:port/path?query#fragment`
+        """
+    @property
+    def password(self) -> str | None:
+        """
+        The password part of the URL, or `None`.
+
+        e.g. `pass` in `https://user:pass@host:port/path?query#fragment`
+        """
+    @property
+    def host(self) -> str | None:
+        """
+        The host part of the URL, or `None`.
+
+        If the URL must be punycode encoded, this is the encoded host, e.g if the input URL is `https://£££.com`,
+        `host` will be `xn--9aaa.com`
+        """
+    def unicode_host(self) -> str | None:
+        """
+        The host part of the URL as a unicode string, or `None`.
+
+        e.g. `host` in `https://user:pass@host:port/path?query#fragment`
+
+        If the URL must be punycode encoded, this is the decoded host, e.g if the input URL is `https://£££.com`,
+        `unicode_host()` will be `£££.com`
+        """
+    @property
+    def port(self) -> int | None:
+        """
+        The port part of the URL, or `None`.
+
+        e.g. `port` in `https://user:pass@host:port/path?query#fragment`
+        """
+    @property
+    def path(self) -> str | None:
+        """
+        The path part of the URL, or `None`.
+
+        e.g. `/path` in `https://user:pass@host:port/path?query#fragment`
+        """
+    @property
+    def query(self) -> str | None:
+        """
+        The query part of the URL, or `None`.
+
+        e.g. `query` in `https://user:pass@host:port/path?query#fragment`
+        """
+    def query_params(self) -> list[tuple[str, str]]:
+        """
+        The query part of the URL as a list of key-value pairs.
+
+        e.g. `[('foo', 'bar')]` in `https://user:pass@host:port/path?foo=bar#fragment`
+        """
+    @property
+    def fragment(self) -> str | None:
+        """
+        The fragment part of the URL, or `None`.
+
+        e.g. `fragment` in `https://user:pass@host:port/path?query#fragment`
+        """
+    def unicode_string(self) -> str:
+        """
+        The URL as a unicode string, unlike `__str__()` this will not punycode encode the host.
+
+        If the URL must be punycode encoded, this is the decoded string, e.g if the input URL is `https://£££.com`,
+        `unicode_string()` will be `https://£££.com`
+        """
+    def __repr__(self) -> str: ...
+    def __str__(self) -> str:
+        """
+        The URL as a string, this will punycode encode the host if required.
+        """
+    def __deepcopy__(self, memo: dict) -> str: ...
+    @classmethod
+    def build(
+        cls,
+        *,
+        scheme: str,
+        username: Optional[str] = None,
+        password: Optional[str] = None,
+        host: str,
+        port: Optional[int] = None,
+        path: Optional[str] = None,
+        query: Optional[str] = None,
+        fragment: Optional[str] = None,
+    ) -> Self:
+        """
+        Build a new `Url` instance from its component parts.
+
+        Args:
+            scheme: The scheme part of the URL.
+            username: The username part of the URL, or omit for no username.
+            password: The password part of the URL, or omit for no password.
+            host: The host part of the URL.
+            port: The port part of the URL, or omit for no port.
+            path: The path part of the URL, or omit for no path.
+            query: The query part of the URL, or omit for no query.
+            fragment: The fragment part of the URL, or omit for no fragment.
+
+        Returns:
+            An instance of URL
+        """
+
+class MultiHostUrl(SupportsAllComparisons):
+    """
+    A URL type with support for multiple hosts, as used by some databases for DSNs, e.g. `https://foo.com,bar.com/path`.
+
+    Internal URL logic uses the [url rust crate](https://docs.rs/url/latest/url/) originally developed
+    by Mozilla.
+    """
+
+    def __new__(cls, url: str) -> Self:
+        """
+        Create a new `MultiHostUrl` instance.
+
+        Args:
+            url: String representation of a URL.
+
+        Returns:
+            A new `MultiHostUrl` instance.
+
+        Raises:
+            ValidationError: If the URL is invalid.
+        """
+    @property
+    def scheme(self) -> str:
+        """
+        The scheme part of the URL.
+
+        e.g. `https` in `https://foo.com,bar.com/path?query#fragment`
+        """
+    @property
+    def path(self) -> str | None:
+        """
+        The path part of the URL, or `None`.
+
+        e.g. `/path` in `https://foo.com,bar.com/path?query#fragment`
+        """
+    @property
+    def query(self) -> str | None:
+        """
+        The query part of the URL, or `None`.
+
+        e.g. `query` in `https://foo.com,bar.com/path?query#fragment`
+        """
+    def query_params(self) -> list[tuple[str, str]]:
+        """
+        The query part of the URL as a list of key-value pairs.
+
+        e.g. `[('foo', 'bar')]` in `https://foo.com,bar.com/path?query#fragment`
+        """
+    @property
+    def fragment(self) -> str | None:
+        """
+        The fragment part of the URL, or `None`.
+
+        e.g. `fragment` in `https://foo.com,bar.com/path?query#fragment`
+        """
+    def hosts(self) -> list[MultiHostHost]:
+        '''
+
+        The hosts of the `MultiHostUrl` as [`MultiHostHost`][pydantic_core.MultiHostHost] typed dicts.
+
+        ```py
+        from pydantic_core import MultiHostUrl
+
+        mhu = MultiHostUrl('https://foo.com:123,foo:bar@bar.com/path')
+        print(mhu.hosts())
+        """
+        [
+            {'username': None, 'password': None, 'host': 'foo.com', 'port': 123},
+            {'username': 'foo', 'password': 'bar', 'host': 'bar.com', 'port': 443}
+        ]
+        ```
+        Returns:
+            A list of dicts, each representing a host.
+        '''
+    def unicode_string(self) -> str:
+        """
+        The URL as a unicode string, unlike `__str__()` this will not punycode encode the hosts.
+        """
+    def __repr__(self) -> str: ...
+    def __str__(self) -> str:
+        """
+        The URL as a string, this will punycode encode the hosts if required.
+        """
+    def __deepcopy__(self, memo: dict) -> Self: ...
+    @classmethod
+    def build(
+        cls,
+        *,
+        scheme: str,
+        hosts: Optional[list[MultiHostHost]] = None,
+        username: Optional[str] = None,
+        password: Optional[str] = None,
+        host: Optional[str] = None,
+        port: Optional[int] = None,
+        path: Optional[str] = None,
+        query: Optional[str] = None,
+        fragment: Optional[str] = None,
+    ) -> Self:
+        """
+        Build a new `MultiHostUrl` instance from its component parts.
+
+        This method takes either `hosts` - a list of `MultiHostHost` typed dicts, or the individual components
+        `username`, `password`, `host` and `port`.
+
+        Args:
+            scheme: The scheme part of the URL.
+            hosts: Multiple hosts to build the URL from.
+            username: The username part of the URL.
+            password: The password part of the URL.
+            host: The host part of the URL.
+            port: The port part of the URL.
+            path: The path part of the URL.
+            query: The query part of the URL, or omit for no query.
+            fragment: The fragment part of the URL, or omit for no fragment.
+
+        Returns:
+            An instance of `MultiHostUrl`
+        """
+
+@final
+class SchemaError(Exception):
+    """
+    Information about errors that occur while building a [`SchemaValidator`][pydantic_core.SchemaValidator]
+    or [`SchemaSerializer`][pydantic_core.SchemaSerializer].
+    """
+
+    def error_count(self) -> int:
+        """
+        Returns:
+            The number of errors in the schema.
+        """
+    def errors(self) -> list[ErrorDetails]:
+        """
+        Returns:
+            A list of [`ErrorDetails`][pydantic_core.ErrorDetails] for each error in the schema.
+        """
+
+@final
+class ValidationError(ValueError):
+    """
+    `ValidationError` is the exception raised by `pydantic-core` when validation fails, it contains a list of errors
+    which detail why validation failed.
+    """
+
+    @staticmethod
+    def from_exception_data(
+        title: str,
+        line_errors: list[InitErrorDetails],
+        input_type: Literal['python', 'json'] = 'python',
+        hide_input: bool = False,
+    ) -> ValidationError:
+        """
+        Python constructor for a Validation Error.
+
+        The API for constructing validation errors will probably change in the future,
+        hence the static method rather than `__init__`.
+
+        Arguments:
+            title: The title of the error, as used in the heading of `str(validation_error)`
+            line_errors: A list of [`InitErrorDetails`][pydantic_core.InitErrorDetails] which contain information
+                about errors that occurred during validation.
+            input_type: Whether the error is for a Python object or JSON.
+            hide_input: Whether to hide the input value in the error message.
+        """
+    @property
+    def title(self) -> str:
+        """
+        The title of the error, as used in the heading of `str(validation_error)`.
+        """
+    def error_count(self) -> int:
+        """
+        Returns:
+            The number of errors in the validation error.
+        """
+    def errors(
+        self, *, include_url: bool = True, include_context: bool = True, include_input: bool = True
+    ) -> list[ErrorDetails]:
+        """
+        Details about each error in the validation error.
+
+        Args:
+            include_url: Whether to include a URL to documentation on the error each error.
+            include_context: Whether to include the context of each error.
+            include_input: Whether to include the input value of each error.
+
+        Returns:
+            A list of [`ErrorDetails`][pydantic_core.ErrorDetails] for each error in the validation error.
+        """
+    def json(
+        self,
+        *,
+        indent: int | None = None,
+        include_url: bool = True,
+        include_context: bool = True,
+        include_input: bool = True,
+    ) -> str:
+        """
+        Same as [`errors()`][pydantic_core.ValidationError.errors] but returns a JSON string.
+
+        Args:
+            indent: The number of spaces to indent the JSON by, or `None` for no indentation - compact JSON.
+            include_url: Whether to include a URL to documentation on the error each error.
+            include_context: Whether to include the context of each error.
+            include_input: Whether to include the input value of each error.
+
+        Returns:
+            a JSON string.
+        """
+
+    def __repr__(self) -> str:
+        """
+        A string representation of the validation error.
+
+        Whether or not documentation URLs are included in the repr is controlled by the
+        environment variable `PYDANTIC_ERRORS_INCLUDE_URL` being set to `1` or
+        `true`; by default, URLs are shown.
+
+        Due to implementation details, this environment variable can only be set once,
+        before the first validation error is created.
+        """
+
+@final
+class PydanticCustomError(ValueError):
+    def __new__(
+        cls, error_type: LiteralString, message_template: LiteralString, context: dict[str, Any] | None = None
+    ) -> Self: ...
+    @property
+    def context(self) -> dict[str, Any] | None: ...
+    @property
+    def type(self) -> str: ...
+    @property
+    def message_template(self) -> str: ...
+    def message(self) -> str: ...
+
+@final
+class PydanticKnownError(ValueError):
+    def __new__(cls, error_type: ErrorType, context: dict[str, Any] | None = None) -> Self: ...
+    @property
+    def context(self) -> dict[str, Any] | None: ...
+    @property
+    def type(self) -> ErrorType: ...
+    @property
+    def message_template(self) -> str: ...
+    def message(self) -> str: ...
+
+@final
+class PydanticOmit(Exception):
+    def __new__(cls) -> Self: ...
+
+@final
+class PydanticUseDefault(Exception):
+    def __new__(cls) -> Self: ...
+
+@final
+class PydanticSerializationError(ValueError):
+    def __new__(cls, message: str) -> Self: ...
+
+@final
+class PydanticSerializationUnexpectedValue(ValueError):
+    def __new__(cls, message: str | None = None) -> Self: ...
+
+@final
+class ArgsKwargs:
+    def __new__(cls, args: tuple[Any, ...], kwargs: dict[str, Any] | None = None) -> Self: ...
+    @property
+    def args(self) -> tuple[Any, ...]: ...
+    @property
+    def kwargs(self) -> dict[str, Any] | None: ...
+
+@final
+class PydanticUndefinedType:
+    def __copy__(self) -> Self: ...
+    def __deepcopy__(self, memo: Any) -> Self: ...
+
+PydanticUndefined: PydanticUndefinedType
+
+def list_all_errors() -> list[ErrorTypeInfo]:
+    """
+    Get information about all built-in errors.
+
+    Returns:
+        A list of `ErrorTypeInfo` typed dicts.
+    """
+@final
+class TzInfo(datetime.tzinfo):
+    def tzname(self, _dt: datetime.datetime | None) -> str | None: ...
+    def utcoffset(self, _dt: datetime.datetime | None) -> datetime.timedelta: ...
+    def dst(self, _dt: datetime.datetime | None) -> datetime.timedelta: ...
+    def fromutc(self, dt: datetime.datetime) -> datetime.datetime: ...
+    def __deepcopy__(self, _memo: dict[Any, Any]) -> 'TzInfo': ...
+
+def validate_core_schema(schema: CoreSchema, *, strict: bool | None = None) -> CoreSchema:
+    """Validate a CoreSchema
+    This currently uses lax mode for validation (i.e. will coerce strings to dates and such)
+    but may use strict mode in the future.
+    We may also remove this function altogether, do not rely on it being present if you are
+    using pydantic-core directly.
+    """
diff --git a/lib/pydantic_core/core_schema.py b/lib/pydantic_core/core_schema.py
new file mode 100644
index 00000000..31bf4878
--- /dev/null
+++ b/lib/pydantic_core/core_schema.py
@@ -0,0 +1,3980 @@
+"""
+This module contains definitions to build schemas which `pydantic_core` can
+validate and serialize.
+"""
+
+from __future__ import annotations as _annotations
+
+import sys
+import warnings
+from collections.abc import Mapping
+from datetime import date, datetime, time, timedelta
+from decimal import Decimal
+from typing import TYPE_CHECKING, Any, Callable, Dict, Hashable, List, Set, Tuple, Type, Union
+
+from typing_extensions import deprecated
+
+if sys.version_info < (3, 12):
+    from typing_extensions import TypedDict
+else:
+    from typing import TypedDict
+
+if sys.version_info < (3, 11):
+    from typing_extensions import Protocol, Required, TypeAlias
+else:
+    from typing import Protocol, Required, TypeAlias
+
+if sys.version_info < (3, 9):
+    from typing_extensions import Literal
+else:
+    from typing import Literal
+
+if TYPE_CHECKING:
+    from pydantic_core import PydanticUndefined
+else:
+    # The initial build of pydantic_core requires PydanticUndefined to generate
+    # the core schema; so we need to conditionally skip it. mypy doesn't like
+    # this at all, hence the TYPE_CHECKING branch above.
+    try:
+        from pydantic_core import PydanticUndefined
+    except ImportError:
+        PydanticUndefined = object()
+
+
+ExtraBehavior = Literal['allow', 'forbid', 'ignore']
+
+
+class CoreConfig(TypedDict, total=False):
+    """
+    Base class for schema configuration options.
+
+    Attributes:
+        title: The name of the configuration.
+        strict: Whether the configuration should strictly adhere to specified rules.
+        extra_fields_behavior: The behavior for handling extra fields.
+        typed_dict_total: Whether the TypedDict should be considered total. Default is `True`.
+        from_attributes: Whether to use attributes for models, dataclasses, and tagged union keys.
+        loc_by_alias: Whether to use the used alias (or first alias for "field required" errors) instead of
+            `field_names` to construct error `loc`s. Default is `True`.
+        revalidate_instances: Whether instances of models and dataclasses should re-validate. Default is 'never'.
+        validate_default: Whether to validate default values during validation. Default is `False`.
+        populate_by_name: Whether an aliased field may be populated by its name as given by the model attribute,
+            as well as the alias. (Replaces 'allow_population_by_field_name' in Pydantic v1.) Default is `False`.
+        str_max_length: The maximum length for string fields.
+        str_min_length: The minimum length for string fields.
+        str_strip_whitespace: Whether to strip whitespace from string fields.
+        str_to_lower: Whether to convert string fields to lowercase.
+        str_to_upper: Whether to convert string fields to uppercase.
+        allow_inf_nan: Whether to allow infinity and NaN values for float fields. Default is `True`.
+        ser_json_timedelta: The serialization option for `timedelta` values. Default is 'iso8601'.
+        ser_json_bytes: The serialization option for `bytes` values. Default is 'utf8'.
+        ser_json_inf_nan: The serialization option for infinity and NaN values
+            in float fields. Default is 'null'.
+        hide_input_in_errors: Whether to hide input data from `ValidationError` representation.
+        validation_error_cause: Whether to add user-python excs to the __cause__ of a ValidationError.
+            Requires exceptiongroup backport pre Python 3.11.
+        coerce_numbers_to_str: Whether to enable coercion of any `Number` type to `str` (not applicable in `strict` mode).
+        regex_engine: The regex engine to use for regex pattern validation. Default is 'rust-regex'. See `StringSchema`.
+    """
+
+    title: str
+    strict: bool
+    # settings related to typed dicts, model fields, dataclass fields
+    extra_fields_behavior: ExtraBehavior
+    typed_dict_total: bool  # default: True
+    # used for models, dataclasses, and tagged union keys
+    from_attributes: bool
+    # whether to use the used alias (or first alias for "field required" errors) instead of field_names
+    # to construct error `loc`s, default True
+    loc_by_alias: bool
+    # whether instances of models and dataclasses (including subclass instances) should re-validate, default 'never'
+    revalidate_instances: Literal['always', 'never', 'subclass-instances']
+    # whether to validate default values during validation, default False
+    validate_default: bool
+    # used on typed-dicts and arguments
+    populate_by_name: bool  # replaces `allow_population_by_field_name` in pydantic v1
+    # fields related to string fields only
+    str_max_length: int
+    str_min_length: int
+    str_strip_whitespace: bool
+    str_to_lower: bool
+    str_to_upper: bool
+    # fields related to float fields only
+    allow_inf_nan: bool  # default: True
+    # the config options are used to customise serialization to JSON
+    ser_json_timedelta: Literal['iso8601', 'float']  # default: 'iso8601'
+    ser_json_bytes: Literal['utf8', 'base64', 'hex']  # default: 'utf8'
+    ser_json_inf_nan: Literal['null', 'constants']  # default: 'null'
+    # used to hide input data from ValidationError repr
+    hide_input_in_errors: bool
+    validation_error_cause: bool  # default: False
+    coerce_numbers_to_str: bool  # default: False
+    regex_engine: Literal['rust-regex', 'python-re']  # default: 'rust-regex'
+
+
+IncExCall: TypeAlias = 'set[int | str] | dict[int | str, IncExCall] | None'
+
+
+class SerializationInfo(Protocol):
+    @property
+    def include(self) -> IncExCall:
+        ...
+
+    @property
+    def exclude(self) -> IncExCall:
+        ...
+
+    @property
+    def mode(self) -> str:
+        ...
+
+    @property
+    def by_alias(self) -> bool:
+        ...
+
+    @property
+    def exclude_unset(self) -> bool:
+        ...
+
+    @property
+    def exclude_defaults(self) -> bool:
+        ...
+
+    @property
+    def exclude_none(self) -> bool:
+        ...
+
+    @property
+    def round_trip(self) -> bool:
+        ...
+
+    def mode_is_json(self) -> bool:
+        ...
+
+    def __str__(self) -> str:
+        ...
+
+    def __repr__(self) -> str:
+        ...
+
+
+class FieldSerializationInfo(SerializationInfo, Protocol):
+    @property
+    def field_name(self) -> str:
+        ...
+
+
+class ValidationInfo(Protocol):
+    """
+    Argument passed to validation functions.
+    """
+
+    @property
+    def context(self) -> Any | None:
+        """Current validation context."""
+        ...
+
+    @property
+    def config(self) -> CoreConfig | None:
+        """The CoreConfig that applies to this validation."""
+        ...
+
+    @property
+    def mode(self) -> Literal['python', 'json']:
+        """The type of input data we are currently validating"""
+        ...
+
+    @property
+    def data(self) -> Dict[str, Any]:
+        """The data being validated for this model."""
+        ...
+
+    @property
+    def field_name(self) -> str | None:
+        """
+        The name of the current field being validated if this validator is
+        attached to a model field.
+        """
+        ...
+
+
+ExpectedSerializationTypes = Literal[
+    'none',
+    'int',
+    'bool',
+    'float',
+    'str',
+    'bytes',
+    'bytearray',
+    'list',
+    'tuple',
+    'set',
+    'frozenset',
+    'generator',
+    'dict',
+    'datetime',
+    'date',
+    'time',
+    'timedelta',
+    'url',
+    'multi-host-url',
+    'json',
+    'uuid',
+]
+
+
+class SimpleSerSchema(TypedDict, total=False):
+    type: Required[ExpectedSerializationTypes]
+
+
+def simple_ser_schema(type: ExpectedSerializationTypes) -> SimpleSerSchema:
+    """
+    Returns a schema for serialization with a custom type.
+
+    Args:
+        type: The type to use for serialization
+    """
+    return SimpleSerSchema(type=type)
+
+
+# (__input_value: Any) -> Any
+GeneralPlainNoInfoSerializerFunction = Callable[[Any], Any]
+# (__input_value: Any, __info: FieldSerializationInfo) -> Any
+GeneralPlainInfoSerializerFunction = Callable[[Any, SerializationInfo], Any]
+# (__model: Any, __input_value: Any) -> Any
+FieldPlainNoInfoSerializerFunction = Callable[[Any, Any], Any]
+# (__model: Any, __input_value: Any, __info: FieldSerializationInfo) -> Any
+FieldPlainInfoSerializerFunction = Callable[[Any, Any, FieldSerializationInfo], Any]
+SerializerFunction = Union[
+    GeneralPlainNoInfoSerializerFunction,
+    GeneralPlainInfoSerializerFunction,
+    FieldPlainNoInfoSerializerFunction,
+    FieldPlainInfoSerializerFunction,
+]
+
+WhenUsed = Literal['always', 'unless-none', 'json', 'json-unless-none']
+"""
+Values have the following meanings:
+
+* `'always'` means always use
+* `'unless-none'` means use unless the value is `None`
+* `'json'` means use when serializing to JSON
+* `'json-unless-none'` means use when serializing to JSON and the value is not `None`
+"""
+
+
+class PlainSerializerFunctionSerSchema(TypedDict, total=False):
+    type: Required[Literal['function-plain']]
+    function: Required[SerializerFunction]
+    is_field_serializer: bool  # default False
+    info_arg: bool  # default False
+    return_schema: CoreSchema  # if omitted, AnySchema is used
+    when_used: WhenUsed  # default: 'always'
+
+
+def plain_serializer_function_ser_schema(
+    function: SerializerFunction,
+    *,
+    is_field_serializer: bool | None = None,
+    info_arg: bool | None = None,
+    return_schema: CoreSchema | None = None,
+    when_used: WhenUsed = 'always',
+) -> PlainSerializerFunctionSerSchema:
+    """
+    Returns a schema for serialization with a function, can be either a "general" or "field" function.
+
+    Args:
+        function: The function to use for serialization
+        is_field_serializer: Whether the serializer is for a field, e.g. takes `model` as the first argument,
+            and `info` includes `field_name`
+        info_arg: Whether the function takes an `__info` argument
+        return_schema: Schema to use for serializing return value
+        when_used: When the function should be called
+    """
+    if when_used == 'always':
+        # just to avoid extra elements in schema, and to use the actual default defined in rust
+        when_used = None  # type: ignore
+    return _dict_not_none(
+        type='function-plain',
+        function=function,
+        is_field_serializer=is_field_serializer,
+        info_arg=info_arg,
+        return_schema=return_schema,
+        when_used=when_used,
+    )
+
+
+class SerializerFunctionWrapHandler(Protocol):  # pragma: no cover
+    def __call__(self, __input_value: Any, __index_key: int | str | None = None) -> Any:
+        ...
+
+
+# (__input_value: Any, __serializer: SerializerFunctionWrapHandler) -> Any
+GeneralWrapNoInfoSerializerFunction = Callable[[Any, SerializerFunctionWrapHandler], Any]
+# (__input_value: Any, __serializer: SerializerFunctionWrapHandler, __info: SerializationInfo) -> Any
+GeneralWrapInfoSerializerFunction = Callable[[Any, SerializerFunctionWrapHandler, SerializationInfo], Any]
+# (__model: Any, __input_value: Any, __serializer: SerializerFunctionWrapHandler) -> Any
+FieldWrapNoInfoSerializerFunction = Callable[[Any, Any, SerializerFunctionWrapHandler], Any]
+# (__model: Any, __input_value: Any, __serializer: SerializerFunctionWrapHandler, __info: FieldSerializationInfo) -> Any
+FieldWrapInfoSerializerFunction = Callable[[Any, Any, SerializerFunctionWrapHandler, FieldSerializationInfo], Any]
+WrapSerializerFunction = Union[
+    GeneralWrapNoInfoSerializerFunction,
+    GeneralWrapInfoSerializerFunction,
+    FieldWrapNoInfoSerializerFunction,
+    FieldWrapInfoSerializerFunction,
+]
+
+
+class WrapSerializerFunctionSerSchema(TypedDict, total=False):
+    type: Required[Literal['function-wrap']]
+    function: Required[WrapSerializerFunction]
+    is_field_serializer: bool  # default False
+    info_arg: bool  # default False
+    schema: CoreSchema  # if omitted, the schema on which this serializer is defined is used
+    return_schema: CoreSchema  # if omitted, AnySchema is used
+    when_used: WhenUsed  # default: 'always'
+
+
+def wrap_serializer_function_ser_schema(
+    function: WrapSerializerFunction,
+    *,
+    is_field_serializer: bool | None = None,
+    info_arg: bool | None = None,
+    schema: CoreSchema | None = None,
+    return_schema: CoreSchema | None = None,
+    when_used: WhenUsed = 'always',
+) -> WrapSerializerFunctionSerSchema:
+    """
+    Returns a schema for serialization with a wrap function, can be either a "general" or "field" function.
+
+    Args:
+        function: The function to use for serialization
+        is_field_serializer: Whether the serializer is for a field, e.g. takes `model` as the first argument,
+            and `info` includes `field_name`
+        info_arg: Whether the function takes an `__info` argument
+        schema: The schema to use for the inner serialization
+        return_schema: Schema to use for serializing return value
+        when_used: When the function should be called
+    """
+    if when_used == 'always':
+        # just to avoid extra elements in schema, and to use the actual default defined in rust
+        when_used = None  # type: ignore
+    return _dict_not_none(
+        type='function-wrap',
+        function=function,
+        is_field_serializer=is_field_serializer,
+        info_arg=info_arg,
+        schema=schema,
+        return_schema=return_schema,
+        when_used=when_used,
+    )
+
+
+class FormatSerSchema(TypedDict, total=False):
+    type: Required[Literal['format']]
+    formatting_string: Required[str]
+    when_used: WhenUsed  # default: 'json-unless-none'
+
+
+def format_ser_schema(formatting_string: str, *, when_used: WhenUsed = 'json-unless-none') -> FormatSerSchema:
+    """
+    Returns a schema for serialization using python's `format` method.
+
+    Args:
+        formatting_string: String defining the format to use
+        when_used: Same meaning as for [general_function_plain_ser_schema], but with a different default
+    """
+    if when_used == 'json-unless-none':
+        # just to avoid extra elements in schema, and to use the actual default defined in rust
+        when_used = None  # type: ignore
+    return _dict_not_none(type='format', formatting_string=formatting_string, when_used=when_used)
+
+
+class ToStringSerSchema(TypedDict, total=False):
+    type: Required[Literal['to-string']]
+    when_used: WhenUsed  # default: 'json-unless-none'
+
+
+def to_string_ser_schema(*, when_used: WhenUsed = 'json-unless-none') -> ToStringSerSchema:
+    """
+    Returns a schema for serialization using python's `str()` / `__str__` method.
+
+    Args:
+        when_used: Same meaning as for [general_function_plain_ser_schema], but with a different default
+    """
+    s = dict(type='to-string')
+    if when_used != 'json-unless-none':
+        # just to avoid extra elements in schema, and to use the actual default defined in rust
+        s['when_used'] = when_used
+    return s  # type: ignore
+
+
+class ModelSerSchema(TypedDict, total=False):
+    type: Required[Literal['model']]
+    cls: Required[Type[Any]]
+    schema: Required[CoreSchema]
+
+
+def model_ser_schema(cls: Type[Any], schema: CoreSchema) -> ModelSerSchema:
+    """
+    Returns a schema for serialization using a model.
+
+    Args:
+        cls: The expected class type, used to generate warnings if the wrong type is passed
+        schema: Internal schema to use to serialize the model dict
+    """
+    return ModelSerSchema(type='model', cls=cls, schema=schema)
+
+
+SerSchema = Union[
+    SimpleSerSchema,
+    PlainSerializerFunctionSerSchema,
+    WrapSerializerFunctionSerSchema,
+    FormatSerSchema,
+    ToStringSerSchema,
+    ModelSerSchema,
+]
+
+
+class ComputedField(TypedDict, total=False):
+    type: Required[Literal['computed-field']]
+    property_name: Required[str]
+    return_schema: Required[CoreSchema]
+    alias: str
+    metadata: Any
+
+
+def computed_field(
+    property_name: str, return_schema: CoreSchema, *, alias: str | None = None, metadata: Any = None
+) -> ComputedField:
+    """
+    ComputedFields are properties of a model or dataclass that are included in serialization.
+
+    Args:
+        property_name: The name of the property on the model or dataclass
+        return_schema: The schema used for the type returned by the computed field
+        alias: The name to use in the serialized output
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+    """
+    return _dict_not_none(
+        type='computed-field', property_name=property_name, return_schema=return_schema, alias=alias, metadata=metadata
+    )
+
+
+class AnySchema(TypedDict, total=False):
+    type: Required[Literal['any']]
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def any_schema(*, ref: str | None = None, metadata: Any = None, serialization: SerSchema | None = None) -> AnySchema:
+    """
+    Returns a schema that matches any value, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.any_schema()
+    v = SchemaValidator(schema)
+    assert v.validate_python(1) == 1
+    ```
+
+    Args:
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(type='any', ref=ref, metadata=metadata, serialization=serialization)
+
+
+class NoneSchema(TypedDict, total=False):
+    type: Required[Literal['none']]
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def none_schema(*, ref: str | None = None, metadata: Any = None, serialization: SerSchema | None = None) -> NoneSchema:
+    """
+    Returns a schema that matches a None value, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.none_schema()
+    v = SchemaValidator(schema)
+    assert v.validate_python(None) is None
+    ```
+
+    Args:
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(type='none', ref=ref, metadata=metadata, serialization=serialization)
+
+
+class BoolSchema(TypedDict, total=False):
+    type: Required[Literal['bool']]
+    strict: bool
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def bool_schema(
+    strict: bool | None = None, ref: str | None = None, metadata: Any = None, serialization: SerSchema | None = None
+) -> BoolSchema:
+    """
+    Returns a schema that matches a bool value, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.bool_schema()
+    v = SchemaValidator(schema)
+    assert v.validate_python('True') is True
+    ```
+
+    Args:
+        strict: Whether the value should be a bool or a value that can be converted to a bool
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(type='bool', strict=strict, ref=ref, metadata=metadata, serialization=serialization)
+
+
+class IntSchema(TypedDict, total=False):
+    type: Required[Literal['int']]
+    multiple_of: int
+    le: int
+    ge: int
+    lt: int
+    gt: int
+    strict: bool
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def int_schema(
+    *,
+    multiple_of: int | None = None,
+    le: int | None = None,
+    ge: int | None = None,
+    lt: int | None = None,
+    gt: int | None = None,
+    strict: bool | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> IntSchema:
+    """
+    Returns a schema that matches a int value, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.int_schema(multiple_of=2, le=6, ge=2)
+    v = SchemaValidator(schema)
+    assert v.validate_python('4') == 4
+    ```
+
+    Args:
+        multiple_of: The value must be a multiple of this number
+        le: The value must be less than or equal to this number
+        ge: The value must be greater than or equal to this number
+        lt: The value must be strictly less than this number
+        gt: The value must be strictly greater than this number
+        strict: Whether the value should be a int or a value that can be converted to a int
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='int',
+        multiple_of=multiple_of,
+        le=le,
+        ge=ge,
+        lt=lt,
+        gt=gt,
+        strict=strict,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class FloatSchema(TypedDict, total=False):
+    type: Required[Literal['float']]
+    allow_inf_nan: bool  # whether 'NaN', '+inf', '-inf' should be forbidden. default: True
+    multiple_of: float
+    le: float
+    ge: float
+    lt: float
+    gt: float
+    strict: bool
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def float_schema(
+    *,
+    allow_inf_nan: bool | None = None,
+    multiple_of: float | None = None,
+    le: float | None = None,
+    ge: float | None = None,
+    lt: float | None = None,
+    gt: float | None = None,
+    strict: bool | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> FloatSchema:
+    """
+    Returns a schema that matches a float value, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.float_schema(le=0.8, ge=0.2)
+    v = SchemaValidator(schema)
+    assert v.validate_python('0.5') == 0.5
+    ```
+
+    Args:
+        allow_inf_nan: Whether to allow inf and nan values
+        multiple_of: The value must be a multiple of this number
+        le: The value must be less than or equal to this number
+        ge: The value must be greater than or equal to this number
+        lt: The value must be strictly less than this number
+        gt: The value must be strictly greater than this number
+        strict: Whether the value should be a float or a value that can be converted to a float
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='float',
+        allow_inf_nan=allow_inf_nan,
+        multiple_of=multiple_of,
+        le=le,
+        ge=ge,
+        lt=lt,
+        gt=gt,
+        strict=strict,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class DecimalSchema(TypedDict, total=False):
+    type: Required[Literal['decimal']]
+    allow_inf_nan: bool  # whether 'NaN', '+inf', '-inf' should be forbidden. default: False
+    multiple_of: Decimal
+    le: Decimal
+    ge: Decimal
+    lt: Decimal
+    gt: Decimal
+    max_digits: int
+    decimal_places: int
+    strict: bool
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def decimal_schema(
+    *,
+    allow_inf_nan: bool = None,
+    multiple_of: Decimal | None = None,
+    le: Decimal | None = None,
+    ge: Decimal | None = None,
+    lt: Decimal | None = None,
+    gt: Decimal | None = None,
+    max_digits: int | None = None,
+    decimal_places: int | None = None,
+    strict: bool | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> DecimalSchema:
+    """
+    Returns a schema that matches a decimal value, e.g.:
+
+    ```py
+    from decimal import Decimal
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.decimal_schema(le=0.8, ge=0.2)
+    v = SchemaValidator(schema)
+    assert v.validate_python('0.5') == Decimal('0.5')
+    ```
+
+    Args:
+        allow_inf_nan: Whether to allow inf and nan values
+        multiple_of: The value must be a multiple of this number
+        le: The value must be less than or equal to this number
+        ge: The value must be greater than or equal to this number
+        lt: The value must be strictly less than this number
+        gt: The value must be strictly greater than this number
+        max_digits: The maximum number of decimal digits allowed
+        decimal_places: The maximum number of decimal places allowed
+        strict: Whether the value should be a float or a value that can be converted to a float
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='decimal',
+        gt=gt,
+        ge=ge,
+        lt=lt,
+        le=le,
+        max_digits=max_digits,
+        decimal_places=decimal_places,
+        multiple_of=multiple_of,
+        allow_inf_nan=allow_inf_nan,
+        strict=strict,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class StringSchema(TypedDict, total=False):
+    type: Required[Literal['str']]
+    pattern: str
+    max_length: int
+    min_length: int
+    strip_whitespace: bool
+    to_lower: bool
+    to_upper: bool
+    regex_engine: Literal['rust-regex', 'python-re']  # default: 'rust-regex'
+    strict: bool
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def str_schema(
+    *,
+    pattern: str | None = None,
+    max_length: int | None = None,
+    min_length: int | None = None,
+    strip_whitespace: bool | None = None,
+    to_lower: bool | None = None,
+    to_upper: bool | None = None,
+    regex_engine: Literal['rust-regex', 'python-re'] | None = None,
+    strict: bool | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> StringSchema:
+    """
+    Returns a schema that matches a string value, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.str_schema(max_length=10, min_length=2)
+    v = SchemaValidator(schema)
+    assert v.validate_python('hello') == 'hello'
+    ```
+
+    Args:
+        pattern: A regex pattern that the value must match
+        max_length: The value must be at most this length
+        min_length: The value must be at least this length
+        strip_whitespace: Whether to strip whitespace from the value
+        to_lower: Whether to convert the value to lowercase
+        to_upper: Whether to convert the value to uppercase
+        regex_engine: The regex engine to use for pattern validation. Default is 'rust-regex'.
+            - `rust-regex` uses the [`regex`](https://docs.rs/regex) Rust
+              crate, which is non-backtracking and therefore more DDoS
+              resistant, but does not support all regex features.
+            - `python-re` use the [`re`](https://docs.python.org/3/library/re.html) module,
+              which supports all regex features, but may be slower.
+        strict: Whether the value should be a string or a value that can be converted to a string
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='str',
+        pattern=pattern,
+        max_length=max_length,
+        min_length=min_length,
+        strip_whitespace=strip_whitespace,
+        to_lower=to_lower,
+        to_upper=to_upper,
+        regex_engine=regex_engine,
+        strict=strict,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class BytesSchema(TypedDict, total=False):
+    type: Required[Literal['bytes']]
+    max_length: int
+    min_length: int
+    strict: bool
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def bytes_schema(
+    *,
+    max_length: int | None = None,
+    min_length: int | None = None,
+    strict: bool | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> BytesSchema:
+    """
+    Returns a schema that matches a bytes value, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.bytes_schema(max_length=10, min_length=2)
+    v = SchemaValidator(schema)
+    assert v.validate_python(b'hello') == b'hello'
+    ```
+
+    Args:
+        max_length: The value must be at most this length
+        min_length: The value must be at least this length
+        strict: Whether the value should be a bytes or a value that can be converted to a bytes
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='bytes',
+        max_length=max_length,
+        min_length=min_length,
+        strict=strict,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class DateSchema(TypedDict, total=False):
+    type: Required[Literal['date']]
+    strict: bool
+    le: date
+    ge: date
+    lt: date
+    gt: date
+    now_op: Literal['past', 'future']
+    # defaults to current local utc offset from `time.localtime().tm_gmtoff`
+    # value is restricted to -86_400 < offset < 86_400 by bounds in generate_self_schema.py
+    now_utc_offset: int
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def date_schema(
+    *,
+    strict: bool | None = None,
+    le: date | None = None,
+    ge: date | None = None,
+    lt: date | None = None,
+    gt: date | None = None,
+    now_op: Literal['past', 'future'] | None = None,
+    now_utc_offset: int | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> DateSchema:
+    """
+    Returns a schema that matches a date value, e.g.:
+
+    ```py
+    from datetime import date
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.date_schema(le=date(2020, 1, 1), ge=date(2019, 1, 1))
+    v = SchemaValidator(schema)
+    assert v.validate_python(date(2019, 6, 1)) == date(2019, 6, 1)
+    ```
+
+    Args:
+        strict: Whether the value should be a date or a value that can be converted to a date
+        le: The value must be less than or equal to this date
+        ge: The value must be greater than or equal to this date
+        lt: The value must be strictly less than this date
+        gt: The value must be strictly greater than this date
+        now_op: The value must be in the past or future relative to the current date
+        now_utc_offset: The value must be in the past or future relative to the current date with this utc offset
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='date',
+        strict=strict,
+        le=le,
+        ge=ge,
+        lt=lt,
+        gt=gt,
+        now_op=now_op,
+        now_utc_offset=now_utc_offset,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class TimeSchema(TypedDict, total=False):
+    type: Required[Literal['time']]
+    strict: bool
+    le: time
+    ge: time
+    lt: time
+    gt: time
+    tz_constraint: Union[Literal['aware', 'naive'], int]
+    microseconds_precision: Literal['truncate', 'error']
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def time_schema(
+    *,
+    strict: bool | None = None,
+    le: time | None = None,
+    ge: time | None = None,
+    lt: time | None = None,
+    gt: time | None = None,
+    tz_constraint: Literal['aware', 'naive'] | int | None = None,
+    microseconds_precision: Literal['truncate', 'error'] = 'truncate',
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> TimeSchema:
+    """
+    Returns a schema that matches a time value, e.g.:
+
+    ```py
+    from datetime import time
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.time_schema(le=time(12, 0, 0), ge=time(6, 0, 0))
+    v = SchemaValidator(schema)
+    assert v.validate_python(time(9, 0, 0)) == time(9, 0, 0)
+    ```
+
+    Args:
+        strict: Whether the value should be a time or a value that can be converted to a time
+        le: The value must be less than or equal to this time
+        ge: The value must be greater than or equal to this time
+        lt: The value must be strictly less than this time
+        gt: The value must be strictly greater than this time
+        tz_constraint: The value must be timezone aware or naive, or an int to indicate required tz offset
+        microseconds_precision: The behavior when seconds have more than 6 digits or microseconds is too large
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='time',
+        strict=strict,
+        le=le,
+        ge=ge,
+        lt=lt,
+        gt=gt,
+        tz_constraint=tz_constraint,
+        microseconds_precision=microseconds_precision,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class DatetimeSchema(TypedDict, total=False):
+    type: Required[Literal['datetime']]
+    strict: bool
+    le: datetime
+    ge: datetime
+    lt: datetime
+    gt: datetime
+    now_op: Literal['past', 'future']
+    tz_constraint: Union[Literal['aware', 'naive'], int]
+    # defaults to current local utc offset from `time.localtime().tm_gmtoff`
+    # value is restricted to -86_400 < offset < 86_400 by bounds in generate_self_schema.py
+    now_utc_offset: int
+    microseconds_precision: Literal['truncate', 'error']  # default: 'truncate'
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def datetime_schema(
+    *,
+    strict: bool | None = None,
+    le: datetime | None = None,
+    ge: datetime | None = None,
+    lt: datetime | None = None,
+    gt: datetime | None = None,
+    now_op: Literal['past', 'future'] | None = None,
+    tz_constraint: Literal['aware', 'naive'] | int | None = None,
+    now_utc_offset: int | None = None,
+    microseconds_precision: Literal['truncate', 'error'] = 'truncate',
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> DatetimeSchema:
+    """
+    Returns a schema that matches a datetime value, e.g.:
+
+    ```py
+    from datetime import datetime
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.datetime_schema()
+    v = SchemaValidator(schema)
+    now = datetime.now()
+    assert v.validate_python(str(now)) == now
+    ```
+
+    Args:
+        strict: Whether the value should be a datetime or a value that can be converted to a datetime
+        le: The value must be less than or equal to this datetime
+        ge: The value must be greater than or equal to this datetime
+        lt: The value must be strictly less than this datetime
+        gt: The value must be strictly greater than this datetime
+        now_op: The value must be in the past or future relative to the current datetime
+        tz_constraint: The value must be timezone aware or naive, or an int to indicate required tz offset
+            TODO: use of a tzinfo where offset changes based on the datetime is not yet supported
+        now_utc_offset: The value must be in the past or future relative to the current datetime with this utc offset
+        microseconds_precision: The behavior when seconds have more than 6 digits or microseconds is too large
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='datetime',
+        strict=strict,
+        le=le,
+        ge=ge,
+        lt=lt,
+        gt=gt,
+        now_op=now_op,
+        tz_constraint=tz_constraint,
+        now_utc_offset=now_utc_offset,
+        microseconds_precision=microseconds_precision,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class TimedeltaSchema(TypedDict, total=False):
+    type: Required[Literal['timedelta']]
+    strict: bool
+    le: timedelta
+    ge: timedelta
+    lt: timedelta
+    gt: timedelta
+    microseconds_precision: Literal['truncate', 'error']
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def timedelta_schema(
+    *,
+    strict: bool | None = None,
+    le: timedelta | None = None,
+    ge: timedelta | None = None,
+    lt: timedelta | None = None,
+    gt: timedelta | None = None,
+    microseconds_precision: Literal['truncate', 'error'] = 'truncate',
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> TimedeltaSchema:
+    """
+    Returns a schema that matches a timedelta value, e.g.:
+
+    ```py
+    from datetime import timedelta
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.timedelta_schema(le=timedelta(days=1), ge=timedelta(days=0))
+    v = SchemaValidator(schema)
+    assert v.validate_python(timedelta(hours=12)) == timedelta(hours=12)
+    ```
+
+    Args:
+        strict: Whether the value should be a timedelta or a value that can be converted to a timedelta
+        le: The value must be less than or equal to this timedelta
+        ge: The value must be greater than or equal to this timedelta
+        lt: The value must be strictly less than this timedelta
+        gt: The value must be strictly greater than this timedelta
+        microseconds_precision: The behavior when seconds have more than 6 digits or microseconds is too large
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='timedelta',
+        strict=strict,
+        le=le,
+        ge=ge,
+        lt=lt,
+        gt=gt,
+        microseconds_precision=microseconds_precision,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class LiteralSchema(TypedDict, total=False):
+    type: Required[Literal['literal']]
+    expected: Required[List[Any]]
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def literal_schema(
+    expected: list[Any], *, ref: str | None = None, metadata: Any = None, serialization: SerSchema | None = None
+) -> LiteralSchema:
+    """
+    Returns a schema that matches a literal value, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.literal_schema(['hello', 'world'])
+    v = SchemaValidator(schema)
+    assert v.validate_python('hello') == 'hello'
+    ```
+
+    Args:
+        expected: The value must be one of these values
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(type='literal', expected=expected, ref=ref, metadata=metadata, serialization=serialization)
+
+
+# must match input/parse_json.rs::JsonType::try_from
+JsonType = Literal['null', 'bool', 'int', 'float', 'str', 'list', 'dict']
+
+
+class IsInstanceSchema(TypedDict, total=False):
+    type: Required[Literal['is-instance']]
+    cls: Required[Any]
+    cls_repr: str
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def is_instance_schema(
+    cls: Any,
+    *,
+    cls_repr: str | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> IsInstanceSchema:
+    """
+    Returns a schema that checks if a value is an instance of a class, equivalent to python's `isinstance` method, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    class A:
+        pass
+
+    schema = core_schema.is_instance_schema(cls=A)
+    v = SchemaValidator(schema)
+    v.validate_python(A())
+    ```
+
+    Args:
+        cls: The value must be an instance of this class
+        cls_repr: If provided this string is used in the validator name instead of `repr(cls)`
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='is-instance', cls=cls, cls_repr=cls_repr, ref=ref, metadata=metadata, serialization=serialization
+    )
+
+
+class IsSubclassSchema(TypedDict, total=False):
+    type: Required[Literal['is-subclass']]
+    cls: Required[Type[Any]]
+    cls_repr: str
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def is_subclass_schema(
+    cls: Type[Any],
+    *,
+    cls_repr: str | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> IsInstanceSchema:
+    """
+    Returns a schema that checks if a value is a subtype of a class, equivalent to python's `issubclass` method, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    class A:
+        pass
+
+    class B(A):
+        pass
+
+    schema = core_schema.is_subclass_schema(cls=A)
+    v = SchemaValidator(schema)
+    v.validate_python(B)
+    ```
+
+    Args:
+        cls: The value must be a subclass of this class
+        cls_repr: If provided this string is used in the validator name instead of `repr(cls)`
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='is-subclass', cls=cls, cls_repr=cls_repr, ref=ref, metadata=metadata, serialization=serialization
+    )
+
+
+class CallableSchema(TypedDict, total=False):
+    type: Required[Literal['callable']]
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def callable_schema(
+    *, ref: str | None = None, metadata: Any = None, serialization: SerSchema | None = None
+) -> CallableSchema:
+    """
+    Returns a schema that checks if a value is callable, equivalent to python's `callable` method, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.callable_schema()
+    v = SchemaValidator(schema)
+    v.validate_python(min)
+    ```
+
+    Args:
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(type='callable', ref=ref, metadata=metadata, serialization=serialization)
+
+
+class UuidSchema(TypedDict, total=False):
+    type: Required[Literal['uuid']]
+    version: Literal[1, 3, 4, 5]
+    strict: bool
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def uuid_schema(
+    *,
+    version: Literal[1, 3, 4, 5] | None = None,
+    strict: bool | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> UuidSchema:
+    return _dict_not_none(
+        type='uuid', version=version, strict=strict, ref=ref, metadata=metadata, serialization=serialization
+    )
+
+
+class IncExSeqSerSchema(TypedDict, total=False):
+    type: Required[Literal['include-exclude-sequence']]
+    include: Set[int]
+    exclude: Set[int]
+
+
+def filter_seq_schema(*, include: Set[int] | None = None, exclude: Set[int] | None = None) -> IncExSeqSerSchema:
+    return _dict_not_none(type='include-exclude-sequence', include=include, exclude=exclude)
+
+
+IncExSeqOrElseSerSchema = Union[IncExSeqSerSchema, SerSchema]
+
+
+class ListSchema(TypedDict, total=False):
+    type: Required[Literal['list']]
+    items_schema: CoreSchema
+    min_length: int
+    max_length: int
+    strict: bool
+    ref: str
+    metadata: Any
+    serialization: IncExSeqOrElseSerSchema
+
+
+def list_schema(
+    items_schema: CoreSchema | None = None,
+    *,
+    min_length: int | None = None,
+    max_length: int | None = None,
+    strict: bool | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: IncExSeqOrElseSerSchema | None = None,
+) -> ListSchema:
+    """
+    Returns a schema that matches a list value, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.list_schema(core_schema.int_schema(), min_length=0, max_length=10)
+    v = SchemaValidator(schema)
+    assert v.validate_python(['4']) == [4]
+    ```
+
+    Args:
+        items_schema: The value must be a list of items that match this schema
+        min_length: The value must be a list with at least this many items
+        max_length: The value must be a list with at most this many items
+        strict: The value must be a list with exactly this many items
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='list',
+        items_schema=items_schema,
+        min_length=min_length,
+        max_length=max_length,
+        strict=strict,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+# @deprecated('tuple_positional_schema is deprecated. Use pydantic_core.core_schema.tuple_schema instead.')
+def tuple_positional_schema(
+    items_schema: list[CoreSchema],
+    *,
+    extras_schema: CoreSchema | None = None,
+    strict: bool | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: IncExSeqOrElseSerSchema | None = None,
+) -> TupleSchema:
+    """
+    Returns a schema that matches a tuple of schemas, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.tuple_positional_schema(
+        [core_schema.int_schema(), core_schema.str_schema()]
+    )
+    v = SchemaValidator(schema)
+    assert v.validate_python((1, 'hello')) == (1, 'hello')
+    ```
+
+    Args:
+        items_schema: The value must be a tuple with items that match these schemas
+        extras_schema: The value must be a tuple with items that match this schema
+            This was inspired by JSON schema's `prefixItems` and `items` fields.
+            In python's `typing.Tuple`, you can't specify a type for "extra" items -- they must all be the same type
+            if the length is variable. So this field won't be set from a `typing.Tuple` annotation on a pydantic model.
+        strict: The value must be a tuple with exactly this many items
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    if extras_schema is not None:
+        variadic_item_index = len(items_schema)
+        items_schema = items_schema + [extras_schema]
+    else:
+        variadic_item_index = None
+    return tuple_schema(
+        items_schema=items_schema,
+        variadic_item_index=variadic_item_index,
+        strict=strict,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+# @deprecated('tuple_variable_schema is deprecated. Use pydantic_core.core_schema.tuple_schema instead.')
+def tuple_variable_schema(
+    items_schema: CoreSchema | None = None,
+    *,
+    min_length: int | None = None,
+    max_length: int | None = None,
+    strict: bool | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: IncExSeqOrElseSerSchema | None = None,
+) -> TupleSchema:
+    """
+    Returns a schema that matches a tuple of a given schema, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.tuple_variable_schema(
+        items_schema=core_schema.int_schema(), min_length=0, max_length=10
+    )
+    v = SchemaValidator(schema)
+    assert v.validate_python(('1', 2, 3)) == (1, 2, 3)
+    ```
+
+    Args:
+        items_schema: The value must be a tuple with items that match this schema
+        min_length: The value must be a tuple with at least this many items
+        max_length: The value must be a tuple with at most this many items
+        strict: The value must be a tuple with exactly this many items
+        ref: Optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return tuple_schema(
+        items_schema=[items_schema or any_schema()],
+        variadic_item_index=0,
+        min_length=min_length,
+        max_length=max_length,
+        strict=strict,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class TupleSchema(TypedDict, total=False):
+    type: Required[Literal['tuple']]
+    items_schema: Required[List[CoreSchema]]
+    variadic_item_index: int
+    min_length: int
+    max_length: int
+    strict: bool
+    ref: str
+    metadata: Any
+    serialization: IncExSeqOrElseSerSchema
+
+
+def tuple_schema(
+    items_schema: list[CoreSchema],
+    *,
+    variadic_item_index: int | None = None,
+    min_length: int | None = None,
+    max_length: int | None = None,
+    strict: bool | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: IncExSeqOrElseSerSchema | None = None,
+) -> TupleSchema:
+    """
+    Returns a schema that matches a tuple of schemas, with an optional variadic item, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.tuple_schema(
+        [core_schema.int_schema(), core_schema.str_schema(), core_schema.float_schema()],
+        variadic_item_index=1,
+    )
+    v = SchemaValidator(schema)
+    assert v.validate_python((1, 'hello', 'world', 1.5)) == (1, 'hello', 'world', 1.5)
+    ```
+
+    Args:
+        items_schema: The value must be a tuple with items that match these schemas
+        variadic_item_index: The index of the schema in `items_schema` to be treated as variadic (following PEP 646)
+        min_length: The value must be a tuple with at least this many items
+        max_length: The value must be a tuple with at most this many items
+        strict: The value must be a tuple with exactly this many items
+        ref: Optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='tuple',
+        items_schema=items_schema,
+        variadic_item_index=variadic_item_index,
+        min_length=min_length,
+        max_length=max_length,
+        strict=strict,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class SetSchema(TypedDict, total=False):
+    type: Required[Literal['set']]
+    items_schema: CoreSchema
+    min_length: int
+    max_length: int
+    strict: bool
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def set_schema(
+    items_schema: CoreSchema | None = None,
+    *,
+    min_length: int | None = None,
+    max_length: int | None = None,
+    strict: bool | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> SetSchema:
+    """
+    Returns a schema that matches a set of a given schema, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.set_schema(
+        items_schema=core_schema.int_schema(), min_length=0, max_length=10
+    )
+    v = SchemaValidator(schema)
+    assert v.validate_python({1, '2', 3}) == {1, 2, 3}
+    ```
+
+    Args:
+        items_schema: The value must be a set with items that match this schema
+        min_length: The value must be a set with at least this many items
+        max_length: The value must be a set with at most this many items
+        strict: The value must be a set with exactly this many items
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='set',
+        items_schema=items_schema,
+        min_length=min_length,
+        max_length=max_length,
+        strict=strict,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class FrozenSetSchema(TypedDict, total=False):
+    type: Required[Literal['frozenset']]
+    items_schema: CoreSchema
+    min_length: int
+    max_length: int
+    strict: bool
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def frozenset_schema(
+    items_schema: CoreSchema | None = None,
+    *,
+    min_length: int | None = None,
+    max_length: int | None = None,
+    strict: bool | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> FrozenSetSchema:
+    """
+    Returns a schema that matches a frozenset of a given schema, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.frozenset_schema(
+        items_schema=core_schema.int_schema(), min_length=0, max_length=10
+    )
+    v = SchemaValidator(schema)
+    assert v.validate_python(frozenset(range(3))) == frozenset({0, 1, 2})
+    ```
+
+    Args:
+        items_schema: The value must be a frozenset with items that match this schema
+        min_length: The value must be a frozenset with at least this many items
+        max_length: The value must be a frozenset with at most this many items
+        strict: The value must be a frozenset with exactly this many items
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='frozenset',
+        items_schema=items_schema,
+        min_length=min_length,
+        max_length=max_length,
+        strict=strict,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class GeneratorSchema(TypedDict, total=False):
+    type: Required[Literal['generator']]
+    items_schema: CoreSchema
+    min_length: int
+    max_length: int
+    ref: str
+    metadata: Any
+    serialization: IncExSeqOrElseSerSchema
+
+
+def generator_schema(
+    items_schema: CoreSchema | None = None,
+    *,
+    min_length: int | None = None,
+    max_length: int | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: IncExSeqOrElseSerSchema | None = None,
+) -> GeneratorSchema:
+    """
+    Returns a schema that matches a generator value, e.g.:
+
+    ```py
+    from typing import Iterator
+    from pydantic_core import SchemaValidator, core_schema
+
+    def gen() -> Iterator[int]:
+        yield 1
+
+    schema = core_schema.generator_schema(items_schema=core_schema.int_schema())
+    v = SchemaValidator(schema)
+    v.validate_python(gen())
+    ```
+
+    Unlike other types, validated generators do not raise ValidationErrors eagerly,
+    but instead will raise a ValidationError when a violating value is actually read from the generator.
+    This is to ensure that "validated" generators retain the benefit of lazy evaluation.
+
+    Args:
+        items_schema: The value must be a generator with items that match this schema
+        min_length: The value must be a generator that yields at least this many items
+        max_length: The value must be a generator that yields at most this many items
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='generator',
+        items_schema=items_schema,
+        min_length=min_length,
+        max_length=max_length,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+IncExDict = Set[Union[int, str]]
+
+
+class IncExDictSerSchema(TypedDict, total=False):
+    type: Required[Literal['include-exclude-dict']]
+    include: IncExDict
+    exclude: IncExDict
+
+
+def filter_dict_schema(*, include: IncExDict | None = None, exclude: IncExDict | None = None) -> IncExDictSerSchema:
+    return _dict_not_none(type='include-exclude-dict', include=include, exclude=exclude)
+
+
+IncExDictOrElseSerSchema = Union[IncExDictSerSchema, SerSchema]
+
+
+class DictSchema(TypedDict, total=False):
+    type: Required[Literal['dict']]
+    keys_schema: CoreSchema  # default: AnySchema
+    values_schema: CoreSchema  # default: AnySchema
+    min_length: int
+    max_length: int
+    strict: bool
+    ref: str
+    metadata: Any
+    serialization: IncExDictOrElseSerSchema
+
+
+def dict_schema(
+    keys_schema: CoreSchema | None = None,
+    values_schema: CoreSchema | None = None,
+    *,
+    min_length: int | None = None,
+    max_length: int | None = None,
+    strict: bool | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> DictSchema:
+    """
+    Returns a schema that matches a dict value, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.dict_schema(
+        keys_schema=core_schema.str_schema(), values_schema=core_schema.int_schema()
+    )
+    v = SchemaValidator(schema)
+    assert v.validate_python({'a': '1', 'b': 2}) == {'a': 1, 'b': 2}
+    ```
+
+    Args:
+        keys_schema: The value must be a dict with keys that match this schema
+        values_schema: The value must be a dict with values that match this schema
+        min_length: The value must be a dict with at least this many items
+        max_length: The value must be a dict with at most this many items
+        strict: Whether the keys and values should be validated with strict mode
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='dict',
+        keys_schema=keys_schema,
+        values_schema=values_schema,
+        min_length=min_length,
+        max_length=max_length,
+        strict=strict,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+# (__input_value: Any) -> Any
+NoInfoValidatorFunction = Callable[[Any], Any]
+
+
+class NoInfoValidatorFunctionSchema(TypedDict):
+    type: Literal['no-info']
+    function: NoInfoValidatorFunction
+
+
+# (__input_value: Any, __info: ValidationInfo) -> Any
+WithInfoValidatorFunction = Callable[[Any, ValidationInfo], Any]
+
+
+class WithInfoValidatorFunctionSchema(TypedDict, total=False):
+    type: Required[Literal['with-info']]
+    function: Required[WithInfoValidatorFunction]
+    field_name: str
+
+
+ValidationFunction = Union[NoInfoValidatorFunctionSchema, WithInfoValidatorFunctionSchema]
+
+
+class _ValidatorFunctionSchema(TypedDict, total=False):
+    function: Required[ValidationFunction]
+    schema: Required[CoreSchema]
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+class BeforeValidatorFunctionSchema(_ValidatorFunctionSchema, total=False):
+    type: Required[Literal['function-before']]
+
+
+def no_info_before_validator_function(
+    function: NoInfoValidatorFunction,
+    schema: CoreSchema,
+    *,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> BeforeValidatorFunctionSchema:
+    """
+    Returns a schema that calls a validator function before validating, no `info` argument is provided, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    def fn(v: bytes) -> str:
+        return v.decode() + 'world'
+
+    func_schema = core_schema.no_info_before_validator_function(
+        function=fn, schema=core_schema.str_schema()
+    )
+    schema = core_schema.typed_dict_schema({'a': core_schema.typed_dict_field(func_schema)})
+
+    v = SchemaValidator(schema)
+    assert v.validate_python({'a': b'hello '}) == {'a': 'hello world'}
+    ```
+
+    Args:
+        function: The validator function to call
+        schema: The schema to validate the output of the validator function
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='function-before',
+        function={'type': 'no-info', 'function': function},
+        schema=schema,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+def with_info_before_validator_function(
+    function: WithInfoValidatorFunction,
+    schema: CoreSchema,
+    *,
+    field_name: str | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> BeforeValidatorFunctionSchema:
+    """
+    Returns a schema that calls a validator function before validation, the function is called with
+    an `info` argument, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    def fn(v: bytes, info: core_schema.ValidationInfo) -> str:
+        assert info.data is not None
+        assert info.field_name is not None
+        return v.decode() + 'world'
+
+    func_schema = core_schema.with_info_before_validator_function(
+        function=fn, schema=core_schema.str_schema(), field_name='a'
+    )
+    schema = core_schema.typed_dict_schema({'a': core_schema.typed_dict_field(func_schema)})
+
+    v = SchemaValidator(schema)
+    assert v.validate_python({'a': b'hello '}) == {'a': 'hello world'}
+    ```
+
+    Args:
+        function: The validator function to call
+        field_name: The name of the field
+        schema: The schema to validate the output of the validator function
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='function-before',
+        function=_dict_not_none(type='with-info', function=function, field_name=field_name),
+        schema=schema,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class AfterValidatorFunctionSchema(_ValidatorFunctionSchema, total=False):
+    type: Required[Literal['function-after']]
+
+
+def no_info_after_validator_function(
+    function: NoInfoValidatorFunction,
+    schema: CoreSchema,
+    *,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> AfterValidatorFunctionSchema:
+    """
+    Returns a schema that calls a validator function after validating, no `info` argument is provided, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    def fn(v: str) -> str:
+        return v + 'world'
+
+    func_schema = core_schema.no_info_after_validator_function(fn, core_schema.str_schema())
+    schema = core_schema.typed_dict_schema({'a': core_schema.typed_dict_field(func_schema)})
+
+    v = SchemaValidator(schema)
+    assert v.validate_python({'a': b'hello '}) == {'a': 'hello world'}
+    ```
+
+    Args:
+        function: The validator function to call after the schema is validated
+        schema: The schema to validate before the validator function
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='function-after',
+        function={'type': 'no-info', 'function': function},
+        schema=schema,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+def with_info_after_validator_function(
+    function: WithInfoValidatorFunction,
+    schema: CoreSchema,
+    *,
+    field_name: str | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> AfterValidatorFunctionSchema:
+    """
+    Returns a schema that calls a validator function after validation, the function is called with
+    an `info` argument, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    def fn(v: str, info: core_schema.ValidationInfo) -> str:
+        assert info.data is not None
+        assert info.field_name is not None
+        return v + 'world'
+
+    func_schema = core_schema.with_info_after_validator_function(
+        function=fn, schema=core_schema.str_schema(), field_name='a'
+    )
+    schema = core_schema.typed_dict_schema({'a': core_schema.typed_dict_field(func_schema)})
+
+    v = SchemaValidator(schema)
+    assert v.validate_python({'a': b'hello '}) == {'a': 'hello world'}
+    ```
+
+    Args:
+        function: The validator function to call after the schema is validated
+        schema: The schema to validate before the validator function
+        field_name: The name of the field this validators is applied to, if any
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='function-after',
+        function=_dict_not_none(type='with-info', function=function, field_name=field_name),
+        schema=schema,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class ValidatorFunctionWrapHandler(Protocol):
+    def __call__(self, input_value: Any, outer_location: str | int | None = None) -> Any:  # pragma: no cover
+        ...
+
+
+# (__input_value: Any, __validator: ValidatorFunctionWrapHandler) -> Any
+NoInfoWrapValidatorFunction = Callable[[Any, ValidatorFunctionWrapHandler], Any]
+
+
+class NoInfoWrapValidatorFunctionSchema(TypedDict):
+    type: Literal['no-info']
+    function: NoInfoWrapValidatorFunction
+
+
+# (__input_value: Any, __validator: ValidatorFunctionWrapHandler, __info: ValidationInfo) -> Any
+WithInfoWrapValidatorFunction = Callable[[Any, ValidatorFunctionWrapHandler, ValidationInfo], Any]
+
+
+class WithInfoWrapValidatorFunctionSchema(TypedDict, total=False):
+    type: Required[Literal['with-info']]
+    function: Required[WithInfoWrapValidatorFunction]
+    field_name: str
+
+
+WrapValidatorFunction = Union[NoInfoWrapValidatorFunctionSchema, WithInfoWrapValidatorFunctionSchema]
+
+
+class WrapValidatorFunctionSchema(TypedDict, total=False):
+    type: Required[Literal['function-wrap']]
+    function: Required[WrapValidatorFunction]
+    schema: Required[CoreSchema]
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def no_info_wrap_validator_function(
+    function: NoInfoWrapValidatorFunction,
+    schema: CoreSchema,
+    *,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> WrapValidatorFunctionSchema:
+    """
+    Returns a schema which calls a function with a `validator` callable argument which can
+    optionally be used to call inner validation with the function logic, this is much like the
+    "onion" implementation of middleware in many popular web frameworks, no `info` argument is passed, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    def fn(
+        v: str,
+        validator: core_schema.ValidatorFunctionWrapHandler,
+    ) -> str:
+        return validator(input_value=v) + 'world'
+
+    schema = core_schema.no_info_wrap_validator_function(
+        function=fn, schema=core_schema.str_schema()
+    )
+    v = SchemaValidator(schema)
+    assert v.validate_python('hello ') == 'hello world'
+    ```
+
+    Args:
+        function: The validator function to call
+        schema: The schema to validate the output of the validator function
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='function-wrap',
+        function={'type': 'no-info', 'function': function},
+        schema=schema,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+def with_info_wrap_validator_function(
+    function: WithInfoWrapValidatorFunction,
+    schema: CoreSchema,
+    *,
+    field_name: str | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> WrapValidatorFunctionSchema:
+    """
+    Returns a schema which calls a function with a `validator` callable argument which can
+    optionally be used to call inner validation with the function logic, this is much like the
+    "onion" implementation of middleware in many popular web frameworks, an `info` argument is also passed, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    def fn(
+        v: str,
+        validator: core_schema.ValidatorFunctionWrapHandler,
+        info: core_schema.ValidationInfo,
+    ) -> str:
+        return validator(input_value=v) + 'world'
+
+    schema = core_schema.with_info_wrap_validator_function(
+        function=fn, schema=core_schema.str_schema()
+    )
+    v = SchemaValidator(schema)
+    assert v.validate_python('hello ') == 'hello world'
+    ```
+
+    Args:
+        function: The validator function to call
+        schema: The schema to validate the output of the validator function
+        field_name: The name of the field this validators is applied to, if any
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='function-wrap',
+        function=_dict_not_none(type='with-info', function=function, field_name=field_name),
+        schema=schema,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class PlainValidatorFunctionSchema(TypedDict, total=False):
+    type: Required[Literal['function-plain']]
+    function: Required[ValidationFunction]
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def no_info_plain_validator_function(
+    function: NoInfoValidatorFunction,
+    *,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> PlainValidatorFunctionSchema:
+    """
+    Returns a schema that uses the provided function for validation, no `info` argument is passed, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    def fn(v: str) -> str:
+        assert 'hello' in v
+        return v + 'world'
+
+    schema = core_schema.no_info_plain_validator_function(function=fn)
+    v = SchemaValidator(schema)
+    assert v.validate_python('hello ') == 'hello world'
+    ```
+
+    Args:
+        function: The validator function to call
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='function-plain',
+        function={'type': 'no-info', 'function': function},
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+def with_info_plain_validator_function(
+    function: WithInfoValidatorFunction,
+    *,
+    field_name: str | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> PlainValidatorFunctionSchema:
+    """
+    Returns a schema that uses the provided function for validation, an `info` argument is passed, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    def fn(v: str, info: core_schema.ValidationInfo) -> str:
+        assert 'hello' in v
+        return v + 'world'
+
+    schema = core_schema.with_info_plain_validator_function(function=fn)
+    v = SchemaValidator(schema)
+    assert v.validate_python('hello ') == 'hello world'
+    ```
+
+    Args:
+        function: The validator function to call
+        field_name: The name of the field this validators is applied to, if any
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='function-plain',
+        function=_dict_not_none(type='with-info', function=function, field_name=field_name),
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class WithDefaultSchema(TypedDict, total=False):
+    type: Required[Literal['default']]
+    schema: Required[CoreSchema]
+    default: Any
+    default_factory: Callable[[], Any]
+    on_error: Literal['raise', 'omit', 'default']  # default: 'raise'
+    validate_default: bool  # default: False
+    strict: bool
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def with_default_schema(
+    schema: CoreSchema,
+    *,
+    default: Any = PydanticUndefined,
+    default_factory: Callable[[], Any] | None = None,
+    on_error: Literal['raise', 'omit', 'default'] | None = None,
+    validate_default: bool | None = None,
+    strict: bool | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> WithDefaultSchema:
+    """
+    Returns a schema that adds a default value to the given schema, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.with_default_schema(core_schema.str_schema(), default='hello')
+    wrapper_schema = core_schema.typed_dict_schema(
+        {'a': core_schema.typed_dict_field(schema)}
+    )
+    v = SchemaValidator(wrapper_schema)
+    assert v.validate_python({}) == v.validate_python({'a': 'hello'})
+    ```
+
+    Args:
+        schema: The schema to add a default value to
+        default: The default value to use
+        default_factory: A function that returns the default value to use
+        on_error: What to do if the schema validation fails. One of 'raise', 'omit', 'default'
+        validate_default: Whether the default value should be validated
+        strict: Whether the underlying schema should be validated with strict mode
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    s = _dict_not_none(
+        type='default',
+        schema=schema,
+        default_factory=default_factory,
+        on_error=on_error,
+        validate_default=validate_default,
+        strict=strict,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+    if default is not PydanticUndefined:
+        s['default'] = default
+    return s
+
+
+class NullableSchema(TypedDict, total=False):
+    type: Required[Literal['nullable']]
+    schema: Required[CoreSchema]
+    strict: bool
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def nullable_schema(
+    schema: CoreSchema,
+    *,
+    strict: bool | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> NullableSchema:
+    """
+    Returns a schema that matches a nullable value, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.nullable_schema(core_schema.str_schema())
+    v = SchemaValidator(schema)
+    assert v.validate_python(None) is None
+    ```
+
+    Args:
+        schema: The schema to wrap
+        strict: Whether the underlying schema should be validated with strict mode
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='nullable', schema=schema, strict=strict, ref=ref, metadata=metadata, serialization=serialization
+    )
+
+
+class UnionSchema(TypedDict, total=False):
+    type: Required[Literal['union']]
+    choices: Required[List[Union[CoreSchema, Tuple[CoreSchema, str]]]]
+    # default true, whether to automatically collapse unions with one element to the inner validator
+    auto_collapse: bool
+    custom_error_type: str
+    custom_error_message: str
+    custom_error_context: Dict[str, Union[str, int, float]]
+    mode: Literal['smart', 'left_to_right']  # default: 'smart'
+    strict: bool
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def union_schema(
+    choices: list[CoreSchema | tuple[CoreSchema, str]],
+    *,
+    auto_collapse: bool | None = None,
+    custom_error_type: str | None = None,
+    custom_error_message: str | None = None,
+    custom_error_context: dict[str, str | int] | None = None,
+    mode: Literal['smart', 'left_to_right'] | None = None,
+    strict: bool | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> UnionSchema:
+    """
+    Returns a schema that matches a union value, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.union_schema([core_schema.str_schema(), core_schema.int_schema()])
+    v = SchemaValidator(schema)
+    assert v.validate_python('hello') == 'hello'
+    assert v.validate_python(1) == 1
+    ```
+
+    Args:
+        choices: The schemas to match. If a tuple, the second item is used as the label for the case.
+        auto_collapse: whether to automatically collapse unions with one element to the inner validator, default true
+        custom_error_type: The custom error type to use if the validation fails
+        custom_error_message: The custom error message to use if the validation fails
+        custom_error_context: The custom error context to use if the validation fails
+        mode: How to select which choice to return
+            * `smart` (default) will try to return the choice which is the closest match to the input value
+            * `left_to_right` will return the first choice in `choices` which succeeds validation
+        strict: Whether the underlying schemas should be validated with strict mode
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='union',
+        choices=choices,
+        auto_collapse=auto_collapse,
+        custom_error_type=custom_error_type,
+        custom_error_message=custom_error_message,
+        custom_error_context=custom_error_context,
+        mode=mode,
+        strict=strict,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class TaggedUnionSchema(TypedDict, total=False):
+    type: Required[Literal['tagged-union']]
+    choices: Required[Dict[Hashable, CoreSchema]]
+    discriminator: Required[Union[str, List[Union[str, int]], List[List[Union[str, int]]], Callable[[Any], Hashable]]]
+    custom_error_type: str
+    custom_error_message: str
+    custom_error_context: Dict[str, Union[str, int, float]]
+    strict: bool
+    from_attributes: bool  # default: True
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def tagged_union_schema(
+    choices: Dict[Hashable, CoreSchema],
+    discriminator: str | list[str | int] | list[list[str | int]] | Callable[[Any], Hashable],
+    *,
+    custom_error_type: str | None = None,
+    custom_error_message: str | None = None,
+    custom_error_context: dict[str, int | str | float] | None = None,
+    strict: bool | None = None,
+    from_attributes: bool | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> TaggedUnionSchema:
+    """
+    Returns a schema that matches a tagged union value, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    apple_schema = core_schema.typed_dict_schema(
+        {
+            'foo': core_schema.typed_dict_field(core_schema.str_schema()),
+            'bar': core_schema.typed_dict_field(core_schema.int_schema()),
+        }
+    )
+    banana_schema = core_schema.typed_dict_schema(
+        {
+            'foo': core_schema.typed_dict_field(core_schema.str_schema()),
+            'spam': core_schema.typed_dict_field(
+                core_schema.list_schema(items_schema=core_schema.int_schema())
+            ),
+        }
+    )
+    schema = core_schema.tagged_union_schema(
+        choices={
+            'apple': apple_schema,
+            'banana': banana_schema,
+        },
+        discriminator='foo',
+    )
+    v = SchemaValidator(schema)
+    assert v.validate_python({'foo': 'apple', 'bar': '123'}) == {'foo': 'apple', 'bar': 123}
+    assert v.validate_python({'foo': 'banana', 'spam': [1, 2, 3]}) == {
+        'foo': 'banana',
+        'spam': [1, 2, 3],
+    }
+    ```
+
+    Args:
+        choices: The schemas to match
+            When retrieving a schema from `choices` using the discriminator value, if the value is a str,
+            it should be fed back into the `choices` map until a schema is obtained
+            (This approach is to prevent multiple ownership of a single schema in Rust)
+        discriminator: The discriminator to use to determine the schema to use
+            * If `discriminator` is a str, it is the name of the attribute to use as the discriminator
+            * If `discriminator` is a list of int/str, it should be used as a "path" to access the discriminator
+            * If `discriminator` is a list of lists, each inner list is a path, and the first path that exists is used
+            * If `discriminator` is a callable, it should return the discriminator when called on the value to validate;
+              the callable can return `None` to indicate that there is no matching discriminator present on the input
+        custom_error_type: The custom error type to use if the validation fails
+        custom_error_message: The custom error message to use if the validation fails
+        custom_error_context: The custom error context to use if the validation fails
+        strict: Whether the underlying schemas should be validated with strict mode
+        from_attributes: Whether to use the attributes of the object to retrieve the discriminator value
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='tagged-union',
+        choices=choices,
+        discriminator=discriminator,
+        custom_error_type=custom_error_type,
+        custom_error_message=custom_error_message,
+        custom_error_context=custom_error_context,
+        strict=strict,
+        from_attributes=from_attributes,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class ChainSchema(TypedDict, total=False):
+    type: Required[Literal['chain']]
+    steps: Required[List[CoreSchema]]
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def chain_schema(
+    steps: list[CoreSchema], *, ref: str | None = None, metadata: Any = None, serialization: SerSchema | None = None
+) -> ChainSchema:
+    """
+    Returns a schema that chains the provided validation schemas, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    def fn(v: str, info: core_schema.ValidationInfo) -> str:
+        assert 'hello' in v
+        return v + ' world'
+
+    fn_schema = core_schema.with_info_plain_validator_function(function=fn)
+    schema = core_schema.chain_schema(
+        [fn_schema, fn_schema, fn_schema, core_schema.str_schema()]
+    )
+    v = SchemaValidator(schema)
+    assert v.validate_python('hello') == 'hello world world world'
+    ```
+
+    Args:
+        steps: The schemas to chain
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(type='chain', steps=steps, ref=ref, metadata=metadata, serialization=serialization)
+
+
+class LaxOrStrictSchema(TypedDict, total=False):
+    type: Required[Literal['lax-or-strict']]
+    lax_schema: Required[CoreSchema]
+    strict_schema: Required[CoreSchema]
+    strict: bool
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def lax_or_strict_schema(
+    lax_schema: CoreSchema,
+    strict_schema: CoreSchema,
+    *,
+    strict: bool | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> LaxOrStrictSchema:
+    """
+    Returns a schema that uses the lax or strict schema, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    def fn(v: str, info: core_schema.ValidationInfo) -> str:
+        assert 'hello' in v
+        return v + ' world'
+
+    lax_schema = core_schema.int_schema(strict=False)
+    strict_schema = core_schema.int_schema(strict=True)
+
+    schema = core_schema.lax_or_strict_schema(
+        lax_schema=lax_schema, strict_schema=strict_schema, strict=True
+    )
+    v = SchemaValidator(schema)
+    assert v.validate_python(123) == 123
+
+    schema = core_schema.lax_or_strict_schema(
+        lax_schema=lax_schema, strict_schema=strict_schema, strict=False
+    )
+    v = SchemaValidator(schema)
+    assert v.validate_python('123') == 123
+    ```
+
+    Args:
+        lax_schema: The lax schema to use
+        strict_schema: The strict schema to use
+        strict: Whether the strict schema should be used
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='lax-or-strict',
+        lax_schema=lax_schema,
+        strict_schema=strict_schema,
+        strict=strict,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class JsonOrPythonSchema(TypedDict, total=False):
+    type: Required[Literal['json-or-python']]
+    json_schema: Required[CoreSchema]
+    python_schema: Required[CoreSchema]
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def json_or_python_schema(
+    json_schema: CoreSchema,
+    python_schema: CoreSchema,
+    *,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> JsonOrPythonSchema:
+    """
+    Returns a schema that uses the Json or Python schema depending on the input:
+
+    ```py
+    from pydantic_core import SchemaValidator, ValidationError, core_schema
+
+    v = SchemaValidator(
+        core_schema.json_or_python_schema(
+            json_schema=core_schema.int_schema(),
+            python_schema=core_schema.int_schema(strict=True),
+        )
+    )
+
+    assert v.validate_json('"123"') == 123
+
+    try:
+        v.validate_python('123')
+    except ValidationError:
+        pass
+    else:
+        raise AssertionError('Validation should have failed')
+    ```
+
+    Args:
+        json_schema: The schema to use for Json inputs
+        python_schema: The schema to use for Python inputs
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='json-or-python',
+        json_schema=json_schema,
+        python_schema=python_schema,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class TypedDictField(TypedDict, total=False):
+    type: Required[Literal['typed-dict-field']]
+    schema: Required[CoreSchema]
+    required: bool
+    validation_alias: Union[str, List[Union[str, int]], List[List[Union[str, int]]]]
+    serialization_alias: str
+    serialization_exclude: bool  # default: False
+    metadata: Any
+
+
+def typed_dict_field(
+    schema: CoreSchema,
+    *,
+    required: bool | None = None,
+    validation_alias: str | list[str | int] | list[list[str | int]] | None = None,
+    serialization_alias: str | None = None,
+    serialization_exclude: bool | None = None,
+    metadata: Any = None,
+) -> TypedDictField:
+    """
+    Returns a schema that matches a typed dict field, e.g.:
+
+    ```py
+    from pydantic_core import core_schema
+
+    field = core_schema.typed_dict_field(schema=core_schema.int_schema(), required=True)
+    ```
+
+    Args:
+        schema: The schema to use for the field
+        required: Whether the field is required
+        validation_alias: The alias(es) to use to find the field in the validation data
+        serialization_alias: The alias to use as a key when serializing
+        serialization_exclude: Whether to exclude the field when serializing
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+    """
+    return _dict_not_none(
+        type='typed-dict-field',
+        schema=schema,
+        required=required,
+        validation_alias=validation_alias,
+        serialization_alias=serialization_alias,
+        serialization_exclude=serialization_exclude,
+        metadata=metadata,
+    )
+
+
+class TypedDictSchema(TypedDict, total=False):
+    type: Required[Literal['typed-dict']]
+    fields: Required[Dict[str, TypedDictField]]
+    computed_fields: List[ComputedField]
+    strict: bool
+    extras_schema: CoreSchema
+    # all these values can be set via config, equivalent fields have `typed_dict_` prefix
+    extra_behavior: ExtraBehavior
+    total: bool  # default: True
+    populate_by_name: bool  # replaces `allow_population_by_field_name` in pydantic v1
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+    config: CoreConfig
+
+
+def typed_dict_schema(
+    fields: Dict[str, TypedDictField],
+    *,
+    computed_fields: list[ComputedField] | None = None,
+    strict: bool | None = None,
+    extras_schema: CoreSchema | None = None,
+    extra_behavior: ExtraBehavior | None = None,
+    total: bool | None = None,
+    populate_by_name: bool | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+    config: CoreConfig | None = None,
+) -> TypedDictSchema:
+    """
+    Returns a schema that matches a typed dict, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    wrapper_schema = core_schema.typed_dict_schema(
+        {'a': core_schema.typed_dict_field(core_schema.str_schema())}
+    )
+    v = SchemaValidator(wrapper_schema)
+    assert v.validate_python({'a': 'hello'}) == {'a': 'hello'}
+    ```
+
+    Args:
+        fields: The fields to use for the typed dict
+        computed_fields: Computed fields to use when serializing the model, only applies when directly inside a model
+        strict: Whether the typed dict is strict
+        extras_schema: The extra validator to use for the typed dict
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        extra_behavior: The extra behavior to use for the typed dict
+        total: Whether the typed dict is total
+        populate_by_name: Whether the typed dict should populate by name
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='typed-dict',
+        fields=fields,
+        computed_fields=computed_fields,
+        strict=strict,
+        extras_schema=extras_schema,
+        extra_behavior=extra_behavior,
+        total=total,
+        populate_by_name=populate_by_name,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+        config=config,
+    )
+
+
+class ModelField(TypedDict, total=False):
+    type: Required[Literal['model-field']]
+    schema: Required[CoreSchema]
+    validation_alias: Union[str, List[Union[str, int]], List[List[Union[str, int]]]]
+    serialization_alias: str
+    serialization_exclude: bool  # default: False
+    frozen: bool
+    metadata: Any
+
+
+def model_field(
+    schema: CoreSchema,
+    *,
+    validation_alias: str | list[str | int] | list[list[str | int]] | None = None,
+    serialization_alias: str | None = None,
+    serialization_exclude: bool | None = None,
+    frozen: bool | None = None,
+    metadata: Any = None,
+) -> ModelField:
+    """
+    Returns a schema for a model field, e.g.:
+
+    ```py
+    from pydantic_core import core_schema
+
+    field = core_schema.model_field(schema=core_schema.int_schema())
+    ```
+
+    Args:
+        schema: The schema to use for the field
+        validation_alias: The alias(es) to use to find the field in the validation data
+        serialization_alias: The alias to use as a key when serializing
+        serialization_exclude: Whether to exclude the field when serializing
+        frozen: Whether the field is frozen
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+    """
+    return _dict_not_none(
+        type='model-field',
+        schema=schema,
+        validation_alias=validation_alias,
+        serialization_alias=serialization_alias,
+        serialization_exclude=serialization_exclude,
+        frozen=frozen,
+        metadata=metadata,
+    )
+
+
+class ModelFieldsSchema(TypedDict, total=False):
+    type: Required[Literal['model-fields']]
+    fields: Required[Dict[str, ModelField]]
+    model_name: str
+    computed_fields: List[ComputedField]
+    strict: bool
+    extras_schema: CoreSchema
+    # all these values can be set via config, equivalent fields have `typed_dict_` prefix
+    extra_behavior: ExtraBehavior
+    populate_by_name: bool  # replaces `allow_population_by_field_name` in pydantic v1
+    from_attributes: bool
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def model_fields_schema(
+    fields: Dict[str, ModelField],
+    *,
+    model_name: str | None = None,
+    computed_fields: list[ComputedField] | None = None,
+    strict: bool | None = None,
+    extras_schema: CoreSchema | None = None,
+    extra_behavior: ExtraBehavior | None = None,
+    populate_by_name: bool | None = None,
+    from_attributes: bool | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> ModelFieldsSchema:
+    """
+    Returns a schema that matches a typed dict, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    wrapper_schema = core_schema.model_fields_schema(
+        {'a': core_schema.model_field(core_schema.str_schema())}
+    )
+    v = SchemaValidator(wrapper_schema)
+    print(v.validate_python({'a': 'hello'}))
+    #> ({'a': 'hello'}, None, {'a'})
+    ```
+
+    Args:
+        fields: The fields to use for the typed dict
+        model_name: The name of the model, used for error messages, defaults to "Model"
+        computed_fields: Computed fields to use when serializing the model, only applies when directly inside a model
+        strict: Whether the typed dict is strict
+        extras_schema: The extra validator to use for the typed dict
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        extra_behavior: The extra behavior to use for the typed dict
+        populate_by_name: Whether the typed dict should populate by name
+        from_attributes: Whether the typed dict should be populated from attributes
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='model-fields',
+        fields=fields,
+        model_name=model_name,
+        computed_fields=computed_fields,
+        strict=strict,
+        extras_schema=extras_schema,
+        extra_behavior=extra_behavior,
+        populate_by_name=populate_by_name,
+        from_attributes=from_attributes,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class ModelSchema(TypedDict, total=False):
+    type: Required[Literal['model']]
+    cls: Required[Type[Any]]
+    schema: Required[CoreSchema]
+    custom_init: bool
+    root_model: bool
+    post_init: str
+    revalidate_instances: Literal['always', 'never', 'subclass-instances']  # default: 'never'
+    strict: bool
+    frozen: bool
+    extra_behavior: ExtraBehavior
+    config: CoreConfig
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def model_schema(
+    cls: Type[Any],
+    schema: CoreSchema,
+    *,
+    custom_init: bool | None = None,
+    root_model: bool | None = None,
+    post_init: str | None = None,
+    revalidate_instances: Literal['always', 'never', 'subclass-instances'] | None = None,
+    strict: bool | None = None,
+    frozen: bool | None = None,
+    extra_behavior: ExtraBehavior | None = None,
+    config: CoreConfig | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> ModelSchema:
+    """
+    A model schema generally contains a typed-dict schema.
+    It will run the typed dict validator, then create a new class
+    and set the dict and fields set returned from the typed dict validator
+    to `__dict__` and `__pydantic_fields_set__` respectively.
+
+    Example:
+
+    ```py
+    from pydantic_core import CoreConfig, SchemaValidator, core_schema
+
+    class MyModel:
+        __slots__ = (
+            '__dict__',
+            '__pydantic_fields_set__',
+            '__pydantic_extra__',
+            '__pydantic_private__',
+        )
+
+    schema = core_schema.model_schema(
+        cls=MyModel,
+        config=CoreConfig(str_max_length=5),
+        schema=core_schema.model_fields_schema(
+            fields={'a': core_schema.model_field(core_schema.str_schema())},
+        ),
+    )
+    v = SchemaValidator(schema)
+    assert v.isinstance_python({'a': 'hello'}) is True
+    assert v.isinstance_python({'a': 'too long'}) is False
+    ```
+
+    Args:
+        cls: The class to use for the model
+        schema: The schema to use for the model
+        custom_init: Whether the model has a custom init method
+        root_model: Whether the model is a `RootModel`
+        post_init: The call after init to use for the model
+        revalidate_instances: whether instances of models and dataclasses (including subclass instances)
+            should re-validate defaults to config.revalidate_instances, else 'never'
+        strict: Whether the model is strict
+        frozen: Whether the model is frozen
+        extra_behavior: The extra behavior to use for the model, used in serialization
+        config: The config to use for the model
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='model',
+        cls=cls,
+        schema=schema,
+        custom_init=custom_init,
+        root_model=root_model,
+        post_init=post_init,
+        revalidate_instances=revalidate_instances,
+        strict=strict,
+        frozen=frozen,
+        extra_behavior=extra_behavior,
+        config=config,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class DataclassField(TypedDict, total=False):
+    type: Required[Literal['dataclass-field']]
+    name: Required[str]
+    schema: Required[CoreSchema]
+    kw_only: bool  # default: True
+    init: bool  # default: True
+    init_only: bool  # default: False
+    frozen: bool  # default: False
+    validation_alias: Union[str, List[Union[str, int]], List[List[Union[str, int]]]]
+    serialization_alias: str
+    serialization_exclude: bool  # default: False
+    metadata: Any
+
+
+def dataclass_field(
+    name: str,
+    schema: CoreSchema,
+    *,
+    kw_only: bool | None = None,
+    init: bool | None = None,
+    init_only: bool | None = None,
+    validation_alias: str | list[str | int] | list[list[str | int]] | None = None,
+    serialization_alias: str | None = None,
+    serialization_exclude: bool | None = None,
+    metadata: Any = None,
+    frozen: bool | None = None,
+) -> DataclassField:
+    """
+    Returns a schema for a dataclass field, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    field = core_schema.dataclass_field(
+        name='a', schema=core_schema.str_schema(), kw_only=False
+    )
+    schema = core_schema.dataclass_args_schema('Foobar', [field])
+    v = SchemaValidator(schema)
+    assert v.validate_python({'a': 'hello'}) == ({'a': 'hello'}, None)
+    ```
+
+    Args:
+        name: The name to use for the argument parameter
+        schema: The schema to use for the argument parameter
+        kw_only: Whether the field can be set with a positional argument as well as a keyword argument
+        init: Whether the field should be validated during initialization
+        init_only: Whether the field should be omitted  from `__dict__` and passed to `__post_init__`
+        validation_alias: The alias(es) to use to find the field in the validation data
+        serialization_alias: The alias to use as a key when serializing
+        serialization_exclude: Whether to exclude the field when serializing
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        frozen: Whether the field is frozen
+    """
+    return _dict_not_none(
+        type='dataclass-field',
+        name=name,
+        schema=schema,
+        kw_only=kw_only,
+        init=init,
+        init_only=init_only,
+        validation_alias=validation_alias,
+        serialization_alias=serialization_alias,
+        serialization_exclude=serialization_exclude,
+        metadata=metadata,
+        frozen=frozen,
+    )
+
+
+class DataclassArgsSchema(TypedDict, total=False):
+    type: Required[Literal['dataclass-args']]
+    dataclass_name: Required[str]
+    fields: Required[List[DataclassField]]
+    computed_fields: List[ComputedField]
+    populate_by_name: bool  # default: False
+    collect_init_only: bool  # default: False
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+    extra_behavior: ExtraBehavior
+
+
+def dataclass_args_schema(
+    dataclass_name: str,
+    fields: list[DataclassField],
+    *,
+    computed_fields: List[ComputedField] | None = None,
+    populate_by_name: bool | None = None,
+    collect_init_only: bool | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+    extra_behavior: ExtraBehavior | None = None,
+) -> DataclassArgsSchema:
+    """
+    Returns a schema for validating dataclass arguments, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    field_a = core_schema.dataclass_field(
+        name='a', schema=core_schema.str_schema(), kw_only=False
+    )
+    field_b = core_schema.dataclass_field(
+        name='b', schema=core_schema.bool_schema(), kw_only=False
+    )
+    schema = core_schema.dataclass_args_schema('Foobar', [field_a, field_b])
+    v = SchemaValidator(schema)
+    assert v.validate_python({'a': 'hello', 'b': True}) == ({'a': 'hello', 'b': True}, None)
+    ```
+
+    Args:
+        dataclass_name: The name of the dataclass being validated
+        fields: The fields to use for the dataclass
+        computed_fields: Computed fields to use when serializing the dataclass
+        populate_by_name: Whether to populate by name
+        collect_init_only: Whether to collect init only fields into a dict to pass to `__post_init__`
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+        extra_behavior: How to handle extra fields
+    """
+    return _dict_not_none(
+        type='dataclass-args',
+        dataclass_name=dataclass_name,
+        fields=fields,
+        computed_fields=computed_fields,
+        populate_by_name=populate_by_name,
+        collect_init_only=collect_init_only,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+        extra_behavior=extra_behavior,
+    )
+
+
+class DataclassSchema(TypedDict, total=False):
+    type: Required[Literal['dataclass']]
+    cls: Required[Type[Any]]
+    schema: Required[CoreSchema]
+    fields: Required[List[str]]
+    cls_name: str
+    post_init: bool  # default: False
+    revalidate_instances: Literal['always', 'never', 'subclass-instances']  # default: 'never'
+    strict: bool  # default: False
+    frozen: bool  # default False
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+    slots: bool
+    config: CoreConfig
+
+
+def dataclass_schema(
+    cls: Type[Any],
+    schema: CoreSchema,
+    fields: List[str],
+    *,
+    cls_name: str | None = None,
+    post_init: bool | None = None,
+    revalidate_instances: Literal['always', 'never', 'subclass-instances'] | None = None,
+    strict: bool | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+    frozen: bool | None = None,
+    slots: bool | None = None,
+    config: CoreConfig | None = None,
+) -> DataclassSchema:
+    """
+    Returns a schema for a dataclass. As with `ModelSchema`, this schema can only be used as a field within
+    another schema, not as the root type.
+
+    Args:
+        cls: The dataclass type, used to perform subclass checks
+        schema: The schema to use for the dataclass fields
+        fields: Fields of the dataclass, this is used in serialization and in validation during re-validation
+            and while validating assignment
+        cls_name: The name to use in error locs, etc; this is useful for generics (default: `cls.__name__`)
+        post_init: Whether to call `__post_init__` after validation
+        revalidate_instances: whether instances of models and dataclasses (including subclass instances)
+            should re-validate defaults to config.revalidate_instances, else 'never'
+        strict: Whether to require an exact instance of `cls`
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+        frozen: Whether the dataclass is frozen
+        slots: Whether `slots=True` on the dataclass, means each field is assigned independently, rather than
+            simply setting `__dict__`, default false
+    """
+    return _dict_not_none(
+        type='dataclass',
+        cls=cls,
+        fields=fields,
+        cls_name=cls_name,
+        schema=schema,
+        post_init=post_init,
+        revalidate_instances=revalidate_instances,
+        strict=strict,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+        frozen=frozen,
+        slots=slots,
+        config=config,
+    )
+
+
+class ArgumentsParameter(TypedDict, total=False):
+    name: Required[str]
+    schema: Required[CoreSchema]
+    mode: Literal['positional_only', 'positional_or_keyword', 'keyword_only']  # default positional_or_keyword
+    alias: Union[str, List[Union[str, int]], List[List[Union[str, int]]]]
+
+
+def arguments_parameter(
+    name: str,
+    schema: CoreSchema,
+    *,
+    mode: Literal['positional_only', 'positional_or_keyword', 'keyword_only'] | None = None,
+    alias: str | list[str | int] | list[list[str | int]] | None = None,
+) -> ArgumentsParameter:
+    """
+    Returns a schema that matches an argument parameter, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    param = core_schema.arguments_parameter(
+        name='a', schema=core_schema.str_schema(), mode='positional_only'
+    )
+    schema = core_schema.arguments_schema([param])
+    v = SchemaValidator(schema)
+    assert v.validate_python(('hello',)) == (('hello',), {})
+    ```
+
+    Args:
+        name: The name to use for the argument parameter
+        schema: The schema to use for the argument parameter
+        mode: The mode to use for the argument parameter
+        alias: The alias to use for the argument parameter
+    """
+    return _dict_not_none(name=name, schema=schema, mode=mode, alias=alias)
+
+
+class ArgumentsSchema(TypedDict, total=False):
+    type: Required[Literal['arguments']]
+    arguments_schema: Required[List[ArgumentsParameter]]
+    populate_by_name: bool
+    var_args_schema: CoreSchema
+    var_kwargs_schema: CoreSchema
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def arguments_schema(
+    arguments: list[ArgumentsParameter],
+    *,
+    populate_by_name: bool | None = None,
+    var_args_schema: CoreSchema | None = None,
+    var_kwargs_schema: CoreSchema | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> ArgumentsSchema:
+    """
+    Returns a schema that matches an arguments schema, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    param_a = core_schema.arguments_parameter(
+        name='a', schema=core_schema.str_schema(), mode='positional_only'
+    )
+    param_b = core_schema.arguments_parameter(
+        name='b', schema=core_schema.bool_schema(), mode='positional_only'
+    )
+    schema = core_schema.arguments_schema([param_a, param_b])
+    v = SchemaValidator(schema)
+    assert v.validate_python(('hello', True)) == (('hello', True), {})
+    ```
+
+    Args:
+        arguments: The arguments to use for the arguments schema
+        populate_by_name: Whether to populate by name
+        var_args_schema: The variable args schema to use for the arguments schema
+        var_kwargs_schema: The variable kwargs schema to use for the arguments schema
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='arguments',
+        arguments_schema=arguments,
+        populate_by_name=populate_by_name,
+        var_args_schema=var_args_schema,
+        var_kwargs_schema=var_kwargs_schema,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class CallSchema(TypedDict, total=False):
+    type: Required[Literal['call']]
+    arguments_schema: Required[CoreSchema]
+    function: Required[Callable[..., Any]]
+    function_name: str  # default function.__name__
+    return_schema: CoreSchema
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def call_schema(
+    arguments: CoreSchema,
+    function: Callable[..., Any],
+    *,
+    function_name: str | None = None,
+    return_schema: CoreSchema | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> CallSchema:
+    """
+    Returns a schema that matches an arguments schema, then calls a function, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    param_a = core_schema.arguments_parameter(
+        name='a', schema=core_schema.str_schema(), mode='positional_only'
+    )
+    param_b = core_schema.arguments_parameter(
+        name='b', schema=core_schema.bool_schema(), mode='positional_only'
+    )
+    args_schema = core_schema.arguments_schema([param_a, param_b])
+
+    schema = core_schema.call_schema(
+        arguments=args_schema,
+        function=lambda a, b: a + str(not b),
+        return_schema=core_schema.str_schema(),
+    )
+    v = SchemaValidator(schema)
+    assert v.validate_python((('hello', True))) == 'helloFalse'
+    ```
+
+    Args:
+        arguments: The arguments to use for the arguments schema
+        function: The function to use for the call schema
+        function_name: The function name to use for the call schema, if not provided `function.__name__` is used
+        return_schema: The return schema to use for the call schema
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='call',
+        arguments_schema=arguments,
+        function=function,
+        function_name=function_name,
+        return_schema=return_schema,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class CustomErrorSchema(TypedDict, total=False):
+    type: Required[Literal['custom-error']]
+    schema: Required[CoreSchema]
+    custom_error_type: Required[str]
+    custom_error_message: str
+    custom_error_context: Dict[str, Union[str, int, float]]
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def custom_error_schema(
+    schema: CoreSchema,
+    custom_error_type: str,
+    *,
+    custom_error_message: str | None = None,
+    custom_error_context: dict[str, Any] | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> CustomErrorSchema:
+    """
+    Returns a schema that matches a custom error value, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.custom_error_schema(
+        schema=core_schema.int_schema(),
+        custom_error_type='MyError',
+        custom_error_message='Error msg',
+    )
+    v = SchemaValidator(schema)
+    v.validate_python(1)
+    ```
+
+    Args:
+        schema: The schema to use for the custom error schema
+        custom_error_type: The custom error type to use for the custom error schema
+        custom_error_message: The custom error message to use for the custom error schema
+        custom_error_context: The custom error context to use for the custom error schema
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='custom-error',
+        schema=schema,
+        custom_error_type=custom_error_type,
+        custom_error_message=custom_error_message,
+        custom_error_context=custom_error_context,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class JsonSchema(TypedDict, total=False):
+    type: Required[Literal['json']]
+    schema: CoreSchema
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def json_schema(
+    schema: CoreSchema | None = None,
+    *,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> JsonSchema:
+    """
+    Returns a schema that matches a JSON value, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    dict_schema = core_schema.model_fields_schema(
+        {
+            'field_a': core_schema.model_field(core_schema.str_schema()),
+            'field_b': core_schema.model_field(core_schema.bool_schema()),
+        },
+    )
+
+    class MyModel:
+        __slots__ = (
+            '__dict__',
+            '__pydantic_fields_set__',
+            '__pydantic_extra__',
+            '__pydantic_private__',
+        )
+        field_a: str
+        field_b: bool
+
+    json_schema = core_schema.json_schema(schema=dict_schema)
+    schema = core_schema.model_schema(cls=MyModel, schema=json_schema)
+    v = SchemaValidator(schema)
+    m = v.validate_python('{"field_a": "hello", "field_b": true}')
+    assert isinstance(m, MyModel)
+    ```
+
+    Args:
+        schema: The schema to use for the JSON schema
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(type='json', schema=schema, ref=ref, metadata=metadata, serialization=serialization)
+
+
+class UrlSchema(TypedDict, total=False):
+    type: Required[Literal['url']]
+    max_length: int
+    allowed_schemes: List[str]
+    host_required: bool  # default False
+    default_host: str
+    default_port: int
+    default_path: str
+    strict: bool
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def url_schema(
+    *,
+    max_length: int | None = None,
+    allowed_schemes: list[str] | None = None,
+    host_required: bool | None = None,
+    default_host: str | None = None,
+    default_port: int | None = None,
+    default_path: str | None = None,
+    strict: bool | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> UrlSchema:
+    """
+    Returns a schema that matches a URL value, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.url_schema()
+    v = SchemaValidator(schema)
+    print(v.validate_python('https://example.com'))
+    #> https://example.com/
+    ```
+
+    Args:
+        max_length: The maximum length of the URL
+        allowed_schemes: The allowed URL schemes
+        host_required: Whether the URL must have a host
+        default_host: The default host to use if the URL does not have a host
+        default_port: The default port to use if the URL does not have a port
+        default_path: The default path to use if the URL does not have a path
+        strict: Whether to use strict URL parsing
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='url',
+        max_length=max_length,
+        allowed_schemes=allowed_schemes,
+        host_required=host_required,
+        default_host=default_host,
+        default_port=default_port,
+        default_path=default_path,
+        strict=strict,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class MultiHostUrlSchema(TypedDict, total=False):
+    type: Required[Literal['multi-host-url']]
+    max_length: int
+    allowed_schemes: List[str]
+    host_required: bool  # default False
+    default_host: str
+    default_port: int
+    default_path: str
+    strict: bool
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def multi_host_url_schema(
+    *,
+    max_length: int | None = None,
+    allowed_schemes: list[str] | None = None,
+    host_required: bool | None = None,
+    default_host: str | None = None,
+    default_port: int | None = None,
+    default_path: str | None = None,
+    strict: bool | None = None,
+    ref: str | None = None,
+    metadata: Any = None,
+    serialization: SerSchema | None = None,
+) -> MultiHostUrlSchema:
+    """
+    Returns a schema that matches a URL value with possibly multiple hosts, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.multi_host_url_schema()
+    v = SchemaValidator(schema)
+    print(v.validate_python('redis://localhost,0.0.0.0,127.0.0.1'))
+    #> redis://localhost,0.0.0.0,127.0.0.1
+    ```
+
+    Args:
+        max_length: The maximum length of the URL
+        allowed_schemes: The allowed URL schemes
+        host_required: Whether the URL must have a host
+        default_host: The default host to use if the URL does not have a host
+        default_port: The default port to use if the URL does not have a port
+        default_path: The default path to use if the URL does not have a path
+        strict: Whether to use strict URL parsing
+        ref: optional unique identifier of the schema, used to reference the schema in other places
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='multi-host-url',
+        max_length=max_length,
+        allowed_schemes=allowed_schemes,
+        host_required=host_required,
+        default_host=default_host,
+        default_port=default_port,
+        default_path=default_path,
+        strict=strict,
+        ref=ref,
+        metadata=metadata,
+        serialization=serialization,
+    )
+
+
+class DefinitionsSchema(TypedDict, total=False):
+    type: Required[Literal['definitions']]
+    schema: Required[CoreSchema]
+    definitions: Required[List[CoreSchema]]
+    metadata: Any
+    serialization: SerSchema
+
+
+def definitions_schema(schema: CoreSchema, definitions: list[CoreSchema]) -> DefinitionsSchema:
+    """
+    Build a schema that contains both an inner schema and a list of definitions which can be used
+    within the inner schema.
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema = core_schema.definitions_schema(
+        core_schema.list_schema(core_schema.definition_reference_schema('foobar')),
+        [core_schema.int_schema(ref='foobar')],
+    )
+    v = SchemaValidator(schema)
+    assert v.validate_python([1, 2, '3']) == [1, 2, 3]
+    ```
+
+    Args:
+        schema: The inner schema
+        definitions: List of definitions which can be referenced within inner schema
+    """
+    return DefinitionsSchema(type='definitions', schema=schema, definitions=definitions)
+
+
+class DefinitionReferenceSchema(TypedDict, total=False):
+    type: Required[Literal['definition-ref']]
+    schema_ref: Required[str]
+    ref: str
+    metadata: Any
+    serialization: SerSchema
+
+
+def definition_reference_schema(
+    schema_ref: str, ref: str | None = None, metadata: Any = None, serialization: SerSchema | None = None
+) -> DefinitionReferenceSchema:
+    """
+    Returns a schema that points to a schema stored in "definitions", this is useful for nested recursive
+    models and also when you want to define validators separately from the main schema, e.g.:
+
+    ```py
+    from pydantic_core import SchemaValidator, core_schema
+
+    schema_definition = core_schema.definition_reference_schema('list-schema')
+    schema = core_schema.definitions_schema(
+        schema=schema_definition,
+        definitions=[
+            core_schema.list_schema(items_schema=schema_definition, ref='list-schema'),
+        ],
+    )
+    v = SchemaValidator(schema)
+    assert v.validate_python([()]) == [[]]
+    ```
+
+    Args:
+        schema_ref: The schema ref to use for the definition reference schema
+        metadata: Any other information you want to include with the schema, not used by pydantic-core
+        serialization: Custom serialization schema
+    """
+    return _dict_not_none(
+        type='definition-ref', schema_ref=schema_ref, ref=ref, metadata=metadata, serialization=serialization
+    )
+
+
+MYPY = False
+# See https://github.com/python/mypy/issues/14034 for details, in summary mypy is extremely slow to process this
+# union which kills performance not just for pydantic, but even for code using pydantic
+if not MYPY:
+    CoreSchema = Union[
+        AnySchema,
+        NoneSchema,
+        BoolSchema,
+        IntSchema,
+        FloatSchema,
+        DecimalSchema,
+        StringSchema,
+        BytesSchema,
+        DateSchema,
+        TimeSchema,
+        DatetimeSchema,
+        TimedeltaSchema,
+        LiteralSchema,
+        IsInstanceSchema,
+        IsSubclassSchema,
+        CallableSchema,
+        ListSchema,
+        TupleSchema,
+        SetSchema,
+        FrozenSetSchema,
+        GeneratorSchema,
+        DictSchema,
+        AfterValidatorFunctionSchema,
+        BeforeValidatorFunctionSchema,
+        WrapValidatorFunctionSchema,
+        PlainValidatorFunctionSchema,
+        WithDefaultSchema,
+        NullableSchema,
+        UnionSchema,
+        TaggedUnionSchema,
+        ChainSchema,
+        LaxOrStrictSchema,
+        JsonOrPythonSchema,
+        TypedDictSchema,
+        ModelFieldsSchema,
+        ModelSchema,
+        DataclassArgsSchema,
+        DataclassSchema,
+        ArgumentsSchema,
+        CallSchema,
+        CustomErrorSchema,
+        JsonSchema,
+        UrlSchema,
+        MultiHostUrlSchema,
+        DefinitionsSchema,
+        DefinitionReferenceSchema,
+        UuidSchema,
+    ]
+elif False:
+    CoreSchema: TypeAlias = Mapping[str, Any]
+
+
+# to update this, call `pytest -k test_core_schema_type_literal` and copy the output
+CoreSchemaType = Literal[
+    'any',
+    'none',
+    'bool',
+    'int',
+    'float',
+    'decimal',
+    'str',
+    'bytes',
+    'date',
+    'time',
+    'datetime',
+    'timedelta',
+    'literal',
+    'is-instance',
+    'is-subclass',
+    'callable',
+    'list',
+    'tuple',
+    'set',
+    'frozenset',
+    'generator',
+    'dict',
+    'function-after',
+    'function-before',
+    'function-wrap',
+    'function-plain',
+    'default',
+    'nullable',
+    'union',
+    'tagged-union',
+    'chain',
+    'lax-or-strict',
+    'json-or-python',
+    'typed-dict',
+    'model-fields',
+    'model',
+    'dataclass-args',
+    'dataclass',
+    'arguments',
+    'call',
+    'custom-error',
+    'json',
+    'url',
+    'multi-host-url',
+    'definitions',
+    'definition-ref',
+    'uuid',
+]
+
+CoreSchemaFieldType = Literal['model-field', 'dataclass-field', 'typed-dict-field', 'computed-field']
+
+
+# used in _pydantic_core.pyi::PydanticKnownError
+# to update this, call `pytest -k test_all_errors` and copy the output
+ErrorType = Literal[
+    'no_such_attribute',
+    'json_invalid',
+    'json_type',
+    'recursion_loop',
+    'missing',
+    'frozen_field',
+    'frozen_instance',
+    'extra_forbidden',
+    'invalid_key',
+    'get_attribute_error',
+    'model_type',
+    'model_attributes_type',
+    'dataclass_type',
+    'dataclass_exact_type',
+    'none_required',
+    'greater_than',
+    'greater_than_equal',
+    'less_than',
+    'less_than_equal',
+    'multiple_of',
+    'finite_number',
+    'too_short',
+    'too_long',
+    'iterable_type',
+    'iteration_error',
+    'string_type',
+    'string_sub_type',
+    'string_unicode',
+    'string_too_short',
+    'string_too_long',
+    'string_pattern_mismatch',
+    'enum',
+    'dict_type',
+    'mapping_type',
+    'list_type',
+    'tuple_type',
+    'set_type',
+    'bool_type',
+    'bool_parsing',
+    'int_type',
+    'int_parsing',
+    'int_parsing_size',
+    'int_from_float',
+    'float_type',
+    'float_parsing',
+    'bytes_type',
+    'bytes_too_short',
+    'bytes_too_long',
+    'value_error',
+    'assertion_error',
+    'literal_error',
+    'date_type',
+    'date_parsing',
+    'date_from_datetime_parsing',
+    'date_from_datetime_inexact',
+    'date_past',
+    'date_future',
+    'time_type',
+    'time_parsing',
+    'datetime_type',
+    'datetime_parsing',
+    'datetime_object_invalid',
+    'datetime_from_date_parsing',
+    'datetime_past',
+    'datetime_future',
+    'timezone_naive',
+    'timezone_aware',
+    'timezone_offset',
+    'time_delta_type',
+    'time_delta_parsing',
+    'frozen_set_type',
+    'is_instance_of',
+    'is_subclass_of',
+    'callable_type',
+    'union_tag_invalid',
+    'union_tag_not_found',
+    'arguments_type',
+    'missing_argument',
+    'unexpected_keyword_argument',
+    'missing_keyword_only_argument',
+    'unexpected_positional_argument',
+    'missing_positional_only_argument',
+    'multiple_argument_values',
+    'url_type',
+    'url_parsing',
+    'url_syntax_violation',
+    'url_too_long',
+    'url_scheme',
+    'uuid_type',
+    'uuid_parsing',
+    'uuid_version',
+    'decimal_type',
+    'decimal_parsing',
+    'decimal_max_digits',
+    'decimal_max_places',
+    'decimal_whole_digits',
+]
+
+
+def _dict_not_none(**kwargs: Any) -> Any:
+    return {k: v for k, v in kwargs.items() if v is not None}
+
+
+###############################################################################
+# All this stuff is deprecated by #980 and will be removed eventually
+# They're kept because some code external code will be using them
+
+
+@deprecated('`field_before_validator_function` is deprecated, use `with_info_before_validator_function` instead.')
+def field_before_validator_function(function: WithInfoValidatorFunction, field_name: str, schema: CoreSchema, **kwargs):
+    warnings.warn(
+        '`field_before_validator_function` is deprecated, use `with_info_before_validator_function` instead.',
+        DeprecationWarning,
+    )
+    return with_info_before_validator_function(function, schema, field_name=field_name, **kwargs)
+
+
+@deprecated('`general_before_validator_function` is deprecated, use `with_info_before_validator_function` instead.')
+def general_before_validator_function(*args, **kwargs):
+    warnings.warn(
+        '`general_before_validator_function` is deprecated, use `with_info_before_validator_function` instead.',
+        DeprecationWarning,
+    )
+    return with_info_before_validator_function(*args, **kwargs)
+
+
+@deprecated('`field_after_validator_function` is deprecated, use `with_info_after_validator_function` instead.')
+def field_after_validator_function(function: WithInfoValidatorFunction, field_name: str, schema: CoreSchema, **kwargs):
+    warnings.warn(
+        '`field_after_validator_function` is deprecated, use `with_info_after_validator_function` instead.',
+        DeprecationWarning,
+    )
+    return with_info_after_validator_function(function, schema, field_name=field_name, **kwargs)
+
+
+@deprecated('`general_after_validator_function` is deprecated, use `with_info_after_validator_function` instead.')
+def general_after_validator_function(*args, **kwargs):
+    warnings.warn(
+        '`general_after_validator_function` is deprecated, use `with_info_after_validator_function` instead.',
+        DeprecationWarning,
+    )
+    return with_info_after_validator_function(*args, **kwargs)
+
+
+@deprecated('`field_wrap_validator_function` is deprecated, use `with_info_wrap_validator_function` instead.')
+def field_wrap_validator_function(
+    function: WithInfoWrapValidatorFunction, field_name: str, schema: CoreSchema, **kwargs
+):
+    warnings.warn(
+        '`field_wrap_validator_function` is deprecated, use `with_info_wrap_validator_function` instead.',
+        DeprecationWarning,
+    )
+    return with_info_wrap_validator_function(function, schema, field_name=field_name, **kwargs)
+
+
+@deprecated('`general_wrap_validator_function` is deprecated, use `with_info_wrap_validator_function` instead.')
+def general_wrap_validator_function(*args, **kwargs):
+    warnings.warn(
+        '`general_wrap_validator_function` is deprecated, use `with_info_wrap_validator_function` instead.',
+        DeprecationWarning,
+    )
+    return with_info_wrap_validator_function(*args, **kwargs)
+
+
+@deprecated('`field_plain_validator_function` is deprecated, use `with_info_plain_validator_function` instead.')
+def field_plain_validator_function(function: WithInfoValidatorFunction, field_name: str, **kwargs):
+    warnings.warn(
+        '`field_plain_validator_function` is deprecated, use `with_info_plain_validator_function` instead.',
+        DeprecationWarning,
+    )
+    return with_info_plain_validator_function(function, field_name=field_name, **kwargs)
+
+
+@deprecated('`general_plain_validator_function` is deprecated, use `with_info_plain_validator_function` instead.')
+def general_plain_validator_function(*args, **kwargs):
+    warnings.warn(
+        '`general_plain_validator_function` is deprecated, use `with_info_plain_validator_function` instead.',
+        DeprecationWarning,
+    )
+    return with_info_plain_validator_function(*args, **kwargs)
+
+
+_deprecated_import_lookup = {
+    'FieldValidationInfo': ValidationInfo,
+    'FieldValidatorFunction': WithInfoValidatorFunction,
+    'GeneralValidatorFunction': WithInfoValidatorFunction,
+    'FieldWrapValidatorFunction': WithInfoWrapValidatorFunction,
+}
+
+if TYPE_CHECKING:
+    FieldValidationInfo = ValidationInfo
+
+
+def __getattr__(attr_name: str) -> object:
+    new_attr = _deprecated_import_lookup.get(attr_name)
+    if new_attr is None:
+        raise AttributeError(f"module 'pydantic_core' has no attribute '{attr_name}'")
+    else:
+        import warnings
+
+        msg = f'`{attr_name}` is deprecated, use `{new_attr.__name__}` instead.'
+        warnings.warn(msg, DeprecationWarning, stacklevel=1)
+        return new_attr
diff --git a/lib/pydantic_core/py.typed b/lib/pydantic_core/py.typed
new file mode 100644
index 00000000..e69de29b
diff --git a/lib/tempora/timing.py b/lib/tempora/timing.py
index aed0d336..e74b8962 100644
--- a/lib/tempora/timing.py
+++ b/lib/tempora/timing.py
@@ -1,22 +1,21 @@
+import collections.abc
+import contextlib
 import datetime
 import functools
 import numbers
 import time
-import collections.abc
-import contextlib
 
 import jaraco.functools
 
 
 class Stopwatch:
     """
-    A simple stopwatch which starts automatically.
+    A simple stopwatch that starts automatically.
 
     >>> w = Stopwatch()
     >>> _1_sec = datetime.timedelta(seconds=1)
     >>> w.split() < _1_sec
     True
-    >>> import time
     >>> time.sleep(1.0)
     >>> w.split() >= _1_sec
     True
@@ -27,13 +26,13 @@ class Stopwatch:
     >>> w.split() < _1_sec
     True
 
-    It should be possible to launch the Stopwatch in a context:
+    Launch the Stopwatch in a context:
 
     >>> with Stopwatch() as watch:
     ...     assert isinstance(watch.split(), datetime.timedelta)
 
-    In that case, the watch is stopped when the context is exited,
-    so to read the elapsed time:
+    After exiting the context, the watch is stopped; read the
+    elapsed time directly:
 
     >>> watch.elapsed
     datetime.timedelta(...)
diff --git a/lib/typing_extensions.py b/lib/typing_extensions.py
index ef42417c..f3132ea4 100644
--- a/lib/typing_extensions.py
+++ b/lib/typing_extensions.py
@@ -2,11 +2,12 @@ import abc
 import collections
 import collections.abc
 import functools
+import inspect
 import operator
 import sys
 import types as _types
 import typing
-
+import warnings
 
 __all__ = [
     # Super-special typing primitives.
@@ -31,6 +32,7 @@ __all__ = [
     'Coroutine',
     'AsyncGenerator',
     'AsyncContextManager',
+    'Buffer',
     'ChainMap',
 
     # Concrete collection types.
@@ -43,7 +45,13 @@ __all__ = [
     'TypedDict',
 
     # Structural checks, a.k.a. protocols.
+    'SupportsAbs',
+    'SupportsBytes',
+    'SupportsComplex',
+    'SupportsFloat',
     'SupportsIndex',
+    'SupportsInt',
+    'SupportsRound',
 
     # One-off things.
     'Annotated',
@@ -51,12 +59,17 @@ __all__ = [
     'assert_type',
     'clear_overloads',
     'dataclass_transform',
+    'deprecated',
+    'Doc',
     'get_overloads',
     'final',
     'get_args',
     'get_origin',
+    'get_original_bases',
+    'get_protocol_members',
     'get_type_hints',
     'IntVar',
+    'is_protocol',
     'is_typeddict',
     'Literal',
     'NewType',
@@ -68,12 +81,54 @@ __all__ = [
     'runtime_checkable',
     'Text',
     'TypeAlias',
+    'TypeAliasType',
     'TypeGuard',
+    'TypeIs',
     'TYPE_CHECKING',
     'Never',
     'NoReturn',
+    'ReadOnly',
     'Required',
     'NotRequired',
+
+    # Pure aliases, have always been in typing
+    'AbstractSet',
+    'AnyStr',
+    'BinaryIO',
+    'Callable',
+    'Collection',
+    'Container',
+    'Dict',
+    'ForwardRef',
+    'FrozenSet',
+    'Generator',
+    'Generic',
+    'Hashable',
+    'IO',
+    'ItemsView',
+    'Iterable',
+    'Iterator',
+    'KeysView',
+    'List',
+    'Mapping',
+    'MappingView',
+    'Match',
+    'MutableMapping',
+    'MutableSequence',
+    'MutableSet',
+    'Optional',
+    'Pattern',
+    'Reversible',
+    'Sequence',
+    'Set',
+    'Sized',
+    'TextIO',
+    'Tuple',
+    'Union',
+    'ValuesView',
+    'cast',
+    'no_type_check',
+    'no_type_check_decorator',
 ]
 
 # for backward compatibility
@@ -83,7 +138,13 @@ GenericMeta = type
 # The functions below are modified copies of typing internal helpers.
 # They are needed by _ProtocolMeta and they provide support for PEP 646.
 
-_marker = object()
+
+class _Sentinel:
+    def __repr__(self):
+        return "<sentinel>"
+
+
+_marker = _Sentinel()
 
 
 def _check_generic(cls, parameters, elen=_marker):
@@ -184,36 +245,13 @@ else:
 
 ClassVar = typing.ClassVar
 
-# On older versions of typing there is an internal class named "Final".
-# 3.8+
-if hasattr(typing, 'Final') and sys.version_info[:2] >= (3, 7):
-    Final = typing.Final
-# 3.7
-else:
-    class _FinalForm(typing._SpecialForm, _root=True):
 
-        def __repr__(self):
-            return 'typing_extensions.' + self._name
+class _ExtensionsSpecialForm(typing._SpecialForm, _root=True):
+    def __repr__(self):
+        return 'typing_extensions.' + self._name
 
-        def __getitem__(self, parameters):
-            item = typing._type_check(parameters,
-                                      f'{self._name} accepts only a single type.')
-            return typing._GenericAlias(self, (item,))
 
-    Final = _FinalForm('Final',
-                       doc="""A special typing construct to indicate that a name
-                       cannot be re-assigned or overridden in a subclass.
-                       For example:
-
-                           MAX_SIZE: Final = 9000
-                           MAX_SIZE += 1  # Error reported by type checker
-
-                           class Connection:
-                               TIMEOUT: Final[int] = 10
-                           class FastConnector(Connection):
-                               TIMEOUT = 1  # Error reported by type checker
-
-                       There is no runtime checking of these properties.""")
+Final = typing.Final
 
 if sys.version_info >= (3, 11):
     final = typing.final
@@ -257,21 +295,67 @@ def IntVar(name):
     return typing.TypeVar(name)
 
 
-# 3.8+:
-if hasattr(typing, 'Literal'):
+# A Literal bug was fixed in 3.11.0, 3.10.1 and 3.9.8
+if sys.version_info >= (3, 10, 1):
     Literal = typing.Literal
-# 3.7:
 else:
-    class _LiteralForm(typing._SpecialForm, _root=True):
+    def _flatten_literal_params(parameters):
+        """An internal helper for Literal creation: flatten Literals among parameters"""
+        params = []
+        for p in parameters:
+            if isinstance(p, _LiteralGenericAlias):
+                params.extend(p.__args__)
+            else:
+                params.append(p)
+        return tuple(params)
 
-        def __repr__(self):
-            return 'typing_extensions.' + self._name
+    def _value_and_type_iter(params):
+        for p in params:
+            yield p, type(p)
+
+    class _LiteralGenericAlias(typing._GenericAlias, _root=True):
+        def __eq__(self, other):
+            if not isinstance(other, _LiteralGenericAlias):
+                return NotImplemented
+            these_args_deduped = set(_value_and_type_iter(self.__args__))
+            other_args_deduped = set(_value_and_type_iter(other.__args__))
+            return these_args_deduped == other_args_deduped
+
+        def __hash__(self):
+            return hash(frozenset(_value_and_type_iter(self.__args__)))
+
+    class _LiteralForm(_ExtensionsSpecialForm, _root=True):
+        def __init__(self, doc: str):
+            self._name = 'Literal'
+            self._doc = self.__doc__ = doc
 
         def __getitem__(self, parameters):
-            return typing._GenericAlias(self, parameters)
+            if not isinstance(parameters, tuple):
+                parameters = (parameters,)
 
-    Literal = _LiteralForm('Literal',
-                           doc="""A type that can be used to indicate to type checkers
+            parameters = _flatten_literal_params(parameters)
+
+            val_type_pairs = list(_value_and_type_iter(parameters))
+            try:
+                deduped_pairs = set(val_type_pairs)
+            except TypeError:
+                # unhashable parameters
+                pass
+            else:
+                # similar logic to typing._deduplicate on Python 3.9+
+                if len(deduped_pairs) < len(val_type_pairs):
+                    new_parameters = []
+                    for pair in val_type_pairs:
+                        if pair in deduped_pairs:
+                            new_parameters.append(pair[0])
+                            deduped_pairs.remove(pair)
+                    assert not deduped_pairs, deduped_pairs
+                    parameters = tuple(new_parameters)
+
+            return _LiteralGenericAlias(self, parameters)
+
+    Literal = _LiteralForm(doc="""\
+                           A type that can be used to indicate to type checkers
                            that the corresponding value has a value literally equivalent
                            to the provided parameter. For example:
 
@@ -285,7 +369,7 @@ else:
                            instead of a type.""")
 
 
-_overload_dummy = typing._overload_dummy  # noqa
+_overload_dummy = typing._overload_dummy
 
 
 if hasattr(typing, "get_overloads"):  # 3.11+
@@ -359,8 +443,6 @@ Type = typing.Type
 
 # Various ABCs mimicking those in collections.abc.
 # A few are simply re-exported for completeness.
-
-
 Awaitable = typing.Awaitable
 Coroutine = typing.Coroutine
 AsyncIterable = typing.AsyncIterable
@@ -369,278 +451,343 @@ Deque = typing.Deque
 ContextManager = typing.ContextManager
 AsyncContextManager = typing.AsyncContextManager
 DefaultDict = typing.DefaultDict
-
-# 3.7.2+
-if hasattr(typing, 'OrderedDict'):
-    OrderedDict = typing.OrderedDict
-# 3.7.0-3.7.2
-else:
-    OrderedDict = typing._alias(collections.OrderedDict, (KT, VT))
-
+OrderedDict = typing.OrderedDict
 Counter = typing.Counter
 ChainMap = typing.ChainMap
 AsyncGenerator = typing.AsyncGenerator
-NewType = typing.NewType
 Text = typing.Text
 TYPE_CHECKING = typing.TYPE_CHECKING
 
 
-_PROTO_WHITELIST = ['Callable', 'Awaitable',
-                    'Iterable', 'Iterator', 'AsyncIterable', 'AsyncIterator',
-                    'Hashable', 'Sized', 'Container', 'Collection', 'Reversible',
-                    'ContextManager', 'AsyncContextManager']
+_PROTO_ALLOWLIST = {
+    'collections.abc': [
+        'Callable', 'Awaitable', 'Iterable', 'Iterator', 'AsyncIterable',
+        'Hashable', 'Sized', 'Container', 'Collection', 'Reversible', 'Buffer',
+    ],
+    'contextlib': ['AbstractContextManager', 'AbstractAsyncContextManager'],
+    'typing_extensions': ['Buffer'],
+}
+
+
+_EXCLUDED_ATTRS = {
+    "__abstractmethods__", "__annotations__", "__weakref__", "_is_protocol",
+    "_is_runtime_protocol", "__dict__", "__slots__", "__parameters__",
+    "__orig_bases__", "__module__", "_MutableMapping__marker", "__doc__",
+    "__subclasshook__", "__orig_class__", "__init__", "__new__",
+    "__protocol_attrs__", "__non_callable_proto_members__",
+    "__match_args__",
+}
+
+if sys.version_info >= (3, 9):
+    _EXCLUDED_ATTRS.add("__class_getitem__")
+
+if sys.version_info >= (3, 12):
+    _EXCLUDED_ATTRS.add("__type_params__")
+
+_EXCLUDED_ATTRS = frozenset(_EXCLUDED_ATTRS)
 
 
 def _get_protocol_attrs(cls):
     attrs = set()
     for base in cls.__mro__[:-1]:  # without object
-        if base.__name__ in ('Protocol', 'Generic'):
+        if base.__name__ in {'Protocol', 'Generic'}:
             continue
         annotations = getattr(base, '__annotations__', {})
-        for attr in list(base.__dict__.keys()) + list(annotations.keys()):
-            if (not attr.startswith('_abc_') and attr not in (
-                    '__abstractmethods__', '__annotations__', '__weakref__',
-                    '_is_protocol', '_is_runtime_protocol', '__dict__',
-                    '__args__', '__slots__',
-                    '__next_in_mro__', '__parameters__', '__origin__',
-                    '__orig_bases__', '__extra__', '__tree_hash__',
-                    '__doc__', '__subclasshook__', '__init__', '__new__',
-                    '__module__', '_MutableMapping__marker', '_gorg')):
+        for attr in (*base.__dict__, *annotations):
+            if (not attr.startswith('_abc_') and attr not in _EXCLUDED_ATTRS):
                 attrs.add(attr)
     return attrs
 
 
-def _is_callable_members_only(cls):
-    return all(callable(getattr(cls, attr, None)) for attr in _get_protocol_attrs(cls))
+def _caller(depth=2):
+    try:
+        return sys._getframe(depth).f_globals.get('__name__', '__main__')
+    except (AttributeError, ValueError):  # For platforms without _getframe()
+        return None
 
 
-def _maybe_adjust_parameters(cls):
-    """Helper function used in Protocol.__init_subclass__ and _TypedDictMeta.__new__.
-
-    The contents of this function are very similar
-    to logic found in typing.Generic.__init_subclass__
-    on the CPython main branch.
-    """
-    tvars = []
-    if '__orig_bases__' in cls.__dict__:
-        tvars = typing._collect_type_vars(cls.__orig_bases__)
-        # Look for Generic[T1, ..., Tn] or Protocol[T1, ..., Tn].
-        # If found, tvars must be a subset of it.
-        # If not found, tvars is it.
-        # Also check for and reject plain Generic,
-        # and reject multiple Generic[...] and/or Protocol[...].
-        gvars = None
-        for base in cls.__orig_bases__:
-            if (isinstance(base, typing._GenericAlias) and
-                    base.__origin__ in (typing.Generic, Protocol)):
-                # for error messages
-                the_base = base.__origin__.__name__
-                if gvars is not None:
-                    raise TypeError(
-                        "Cannot inherit from Generic[...]"
-                        " and/or Protocol[...] multiple types.")
-                gvars = base.__parameters__
-        if gvars is None:
-            gvars = tvars
-        else:
-            tvarset = set(tvars)
-            gvarset = set(gvars)
-            if not tvarset <= gvarset:
-                s_vars = ', '.join(str(t) for t in tvars if t not in gvarset)
-                s_args = ', '.join(str(g) for g in gvars)
-                raise TypeError(f"Some type variables ({s_vars}) are"
-                                f" not listed in {the_base}[{s_args}]")
-            tvars = gvars
-    cls.__parameters__ = tuple(tvars)
-
-
-# 3.8+
-if hasattr(typing, 'Protocol'):
+# `__match_args__` attribute was removed from protocol members in 3.13,
+# we want to backport this change to older Python versions.
+if sys.version_info >= (3, 13):
     Protocol = typing.Protocol
-# 3.7
 else:
+    def _allow_reckless_class_checks(depth=3):
+        """Allow instance and class checks for special stdlib modules.
+        The abc and functools modules indiscriminately call isinstance() and
+        issubclass() on the whole MRO of a user class, which may contain protocols.
+        """
+        return _caller(depth) in {'abc', 'functools', None}
 
     def _no_init(self, *args, **kwargs):
         if type(self)._is_protocol:
             raise TypeError('Protocols cannot be instantiated')
 
-    class _ProtocolMeta(abc.ABCMeta):  # noqa: B024
-        # This metaclass is a bit unfortunate and exists only because of the lack
-        # of __instancehook__.
+    def _type_check_issubclass_arg_1(arg):
+        """Raise TypeError if `arg` is not an instance of `type`
+        in `issubclass(arg, <protocol>)`.
+
+        In most cases, this is verified by type.__subclasscheck__.
+        Checking it again unnecessarily would slow down issubclass() checks,
+        so, we don't perform this check unless we absolutely have to.
+
+        For various error paths, however,
+        we want to ensure that *this* error message is shown to the user
+        where relevant, rather than a typing.py-specific error message.
+        """
+        if not isinstance(arg, type):
+            # Same error message as for issubclass(1, int).
+            raise TypeError('issubclass() arg 1 must be a class')
+
+    # Inheriting from typing._ProtocolMeta isn't actually desirable,
+    # but is necessary to allow typing.Protocol and typing_extensions.Protocol
+    # to mix without getting TypeErrors about "metaclass conflict"
+    class _ProtocolMeta(type(typing.Protocol)):
+        # This metaclass is somewhat unfortunate,
+        # but is necessary for several reasons...
+        #
+        # NOTE: DO NOT call super() in any methods in this class
+        # That would call the methods on typing._ProtocolMeta on Python 3.8-3.11
+        # and those are slow
+        def __new__(mcls, name, bases, namespace, **kwargs):
+            if name == "Protocol" and len(bases) < 2:
+                pass
+            elif {Protocol, typing.Protocol} & set(bases):
+                for base in bases:
+                    if not (
+                        base in {object, typing.Generic, Protocol, typing.Protocol}
+                        or base.__name__ in _PROTO_ALLOWLIST.get(base.__module__, [])
+                        or is_protocol(base)
+                    ):
+                        raise TypeError(
+                            f"Protocols can only inherit from other protocols, "
+                            f"got {base!r}"
+                        )
+            return abc.ABCMeta.__new__(mcls, name, bases, namespace, **kwargs)
+
+        def __init__(cls, *args, **kwargs):
+            abc.ABCMeta.__init__(cls, *args, **kwargs)
+            if getattr(cls, "_is_protocol", False):
+                cls.__protocol_attrs__ = _get_protocol_attrs(cls)
+
+        def __subclasscheck__(cls, other):
+            if cls is Protocol:
+                return type.__subclasscheck__(cls, other)
+            if (
+                getattr(cls, '_is_protocol', False)
+                and not _allow_reckless_class_checks()
+            ):
+                if not getattr(cls, '_is_runtime_protocol', False):
+                    _type_check_issubclass_arg_1(other)
+                    raise TypeError(
+                        "Instance and class checks can only be used with "
+                        "@runtime_checkable protocols"
+                    )
+                if (
+                    # this attribute is set by @runtime_checkable:
+                    cls.__non_callable_proto_members__
+                    and cls.__dict__.get("__subclasshook__") is _proto_hook
+                ):
+                    _type_check_issubclass_arg_1(other)
+                    non_method_attrs = sorted(cls.__non_callable_proto_members__)
+                    raise TypeError(
+                        "Protocols with non-method members don't support issubclass()."
+                        f" Non-method members: {str(non_method_attrs)[1:-1]}."
+                    )
+            return abc.ABCMeta.__subclasscheck__(cls, other)
+
         def __instancecheck__(cls, instance):
             # We need this method for situations where attributes are
             # assigned in __init__.
-            if ((not getattr(cls, '_is_protocol', False) or
-                 _is_callable_members_only(cls)) and
-                    issubclass(instance.__class__, cls)):
+            if cls is Protocol:
+                return type.__instancecheck__(cls, instance)
+            if not getattr(cls, "_is_protocol", False):
+                # i.e., it's a concrete subclass of a protocol
+                return abc.ABCMeta.__instancecheck__(cls, instance)
+
+            if (
+                not getattr(cls, '_is_runtime_protocol', False) and
+                not _allow_reckless_class_checks()
+            ):
+                raise TypeError("Instance and class checks can only be used with"
+                                " @runtime_checkable protocols")
+
+            if abc.ABCMeta.__instancecheck__(cls, instance):
                 return True
-            if cls._is_protocol:
-                if all(hasattr(instance, attr) and
-                       (not callable(getattr(cls, attr, None)) or
-                        getattr(instance, attr) is not None)
-                       for attr in _get_protocol_attrs(cls)):
-                    return True
-            return super().__instancecheck__(instance)
 
-    class Protocol(metaclass=_ProtocolMeta):
-        # There is quite a lot of overlapping code with typing.Generic.
-        # Unfortunately it is hard to avoid this while these live in two different
-        # modules. The duplicated code will be removed when Protocol is moved to typing.
-        """Base class for protocol classes. Protocol classes are defined as::
+            for attr in cls.__protocol_attrs__:
+                try:
+                    val = inspect.getattr_static(instance, attr)
+                except AttributeError:
+                    break
+                # this attribute is set by @runtime_checkable:
+                if val is None and attr not in cls.__non_callable_proto_members__:
+                    break
+            else:
+                return True
 
-            class Proto(Protocol):
-                def meth(self) -> int:
-                    ...
+            return False
 
-        Such classes are primarily used with static type checkers that recognize
-        structural subtyping (static duck-typing), for example::
+        def __eq__(cls, other):
+            # Hack so that typing.Generic.__class_getitem__
+            # treats typing_extensions.Protocol
+            # as equivalent to typing.Protocol
+            if abc.ABCMeta.__eq__(cls, other) is True:
+                return True
+            return cls is Protocol and other is typing.Protocol
 
-            class C:
-                def meth(self) -> int:
-                    return 0
+        # This has to be defined, or the abc-module cache
+        # complains about classes with this metaclass being unhashable,
+        # if we define only __eq__!
+        def __hash__(cls) -> int:
+            return type.__hash__(cls)
 
-            def func(x: Proto) -> int:
-                return x.meth()
+    @classmethod
+    def _proto_hook(cls, other):
+        if not cls.__dict__.get('_is_protocol', False):
+            return NotImplemented
 
-            func(C())  # Passes static type check
+        for attr in cls.__protocol_attrs__:
+            for base in other.__mro__:
+                # Check if the members appears in the class dictionary...
+                if attr in base.__dict__:
+                    if base.__dict__[attr] is None:
+                        return NotImplemented
+                    break
 
-        See PEP 544 for details. Protocol classes decorated with
-        @typing_extensions.runtime act as simple-minded runtime protocol that checks
-        only the presence of given attributes, ignoring their type signatures.
+                # ...or in annotations, if it is a sub-protocol.
+                annotations = getattr(base, '__annotations__', {})
+                if (
+                    isinstance(annotations, collections.abc.Mapping)
+                    and attr in annotations
+                    and is_protocol(other)
+                ):
+                    break
+            else:
+                return NotImplemented
+        return True
 
-        Protocol classes can be generic, they are defined as::
-
-            class GenProto(Protocol[T]):
-                def meth(self) -> T:
-                    ...
-        """
+    class Protocol(typing.Generic, metaclass=_ProtocolMeta):
+        __doc__ = typing.Protocol.__doc__
         __slots__ = ()
         _is_protocol = True
-
-        def __new__(cls, *args, **kwds):
-            if cls is Protocol:
-                raise TypeError("Type Protocol cannot be instantiated; "
-                                "it can only be used as a base class")
-            return super().__new__(cls)
-
-        @typing._tp_cache
-        def __class_getitem__(cls, params):
-            if not isinstance(params, tuple):
-                params = (params,)
-            if not params and cls is not typing.Tuple:
-                raise TypeError(
-                    f"Parameter list to {cls.__qualname__}[...] cannot be empty")
-            msg = "Parameters to generic types must be types."
-            params = tuple(typing._type_check(p, msg) for p in params)  # noqa
-            if cls is Protocol:
-                # Generic can only be subscripted with unique type variables.
-                if not all(isinstance(p, typing.TypeVar) for p in params):
-                    i = 0
-                    while isinstance(params[i], typing.TypeVar):
-                        i += 1
-                    raise TypeError(
-                        "Parameters to Protocol[...] must all be type variables."
-                        f" Parameter {i + 1} is {params[i]}")
-                if len(set(params)) != len(params):
-                    raise TypeError(
-                        "Parameters to Protocol[...] must all be unique")
-            else:
-                # Subscripting a regular Generic subclass.
-                _check_generic(cls, params, len(cls.__parameters__))
-            return typing._GenericAlias(cls, params)
+        _is_runtime_protocol = False
 
         def __init_subclass__(cls, *args, **kwargs):
-            if '__orig_bases__' in cls.__dict__:
-                error = typing.Generic in cls.__orig_bases__
-            else:
-                error = typing.Generic in cls.__bases__
-            if error:
-                raise TypeError("Cannot inherit from plain Generic")
-            _maybe_adjust_parameters(cls)
+            super().__init_subclass__(*args, **kwargs)
 
             # Determine if this is a protocol or a concrete subclass.
-            if not cls.__dict__.get('_is_protocol', None):
+            if not cls.__dict__.get('_is_protocol', False):
                 cls._is_protocol = any(b is Protocol for b in cls.__bases__)
 
             # Set (or override) the protocol subclass hook.
-            def _proto_hook(other):
-                if not cls.__dict__.get('_is_protocol', None):
-                    return NotImplemented
-                if not getattr(cls, '_is_runtime_protocol', False):
-                    if sys._getframe(2).f_globals['__name__'] in ['abc', 'functools']:
-                        return NotImplemented
-                    raise TypeError("Instance and class checks can only be used with"
-                                    " @runtime protocols")
-                if not _is_callable_members_only(cls):
-                    if sys._getframe(2).f_globals['__name__'] in ['abc', 'functools']:
-                        return NotImplemented
-                    raise TypeError("Protocols with non-method members"
-                                    " don't support issubclass()")
-                if not isinstance(other, type):
-                    # Same error as for issubclass(1, int)
-                    raise TypeError('issubclass() arg 1 must be a class')
-                for attr in _get_protocol_attrs(cls):
-                    for base in other.__mro__:
-                        if attr in base.__dict__:
-                            if base.__dict__[attr] is None:
-                                return NotImplemented
-                            break
-                        annotations = getattr(base, '__annotations__', {})
-                        if (isinstance(annotations, typing.Mapping) and
-                                attr in annotations and
-                                isinstance(other, _ProtocolMeta) and
-                                other._is_protocol):
-                            break
-                    else:
-                        return NotImplemented
-                return True
             if '__subclasshook__' not in cls.__dict__:
                 cls.__subclasshook__ = _proto_hook
 
-            # We have nothing more to do for non-protocols.
-            if not cls._is_protocol:
-                return
-
-            # Check consistency of bases.
-            for base in cls.__bases__:
-                if not (base in (object, typing.Generic) or
-                        base.__module__ == 'collections.abc' and
-                        base.__name__ in _PROTO_WHITELIST or
-                        isinstance(base, _ProtocolMeta) and base._is_protocol):
-                    raise TypeError('Protocols can only inherit from other'
-                                    f' protocols, got {repr(base)}')
-            cls.__init__ = _no_init
+            # Prohibit instantiation for protocol classes
+            if cls._is_protocol and cls.__init__ is Protocol.__init__:
+                cls.__init__ = _no_init
 
 
-# 3.8+
-if hasattr(typing, 'runtime_checkable'):
+if sys.version_info >= (3, 13):
     runtime_checkable = typing.runtime_checkable
-# 3.7
 else:
     def runtime_checkable(cls):
-        """Mark a protocol class as a runtime protocol, so that it
-        can be used with isinstance() and issubclass(). Raise TypeError
-        if applied to a non-protocol class.
+        """Mark a protocol class as a runtime protocol.
 
-        This allows a simple-minded structural check very similar to the
-        one-offs in collections.abc such as Hashable.
+        Such protocol can be used with isinstance() and issubclass().
+        Raise TypeError if applied to a non-protocol class.
+        This allows a simple-minded structural check very similar to
+        one trick ponies in collections.abc such as Iterable.
+
+        For example::
+
+            @runtime_checkable
+            class Closable(Protocol):
+                def close(self): ...
+
+            assert isinstance(open('/some/file'), Closable)
+
+        Warning: this will check only the presence of the required methods,
+        not their type signatures!
         """
-        if not isinstance(cls, _ProtocolMeta) or not cls._is_protocol:
+        if not issubclass(cls, typing.Generic) or not getattr(cls, '_is_protocol', False):
             raise TypeError('@runtime_checkable can be only applied to protocol classes,'
-                            f' got {cls!r}')
+                            ' got %r' % cls)
         cls._is_runtime_protocol = True
+
+        # Only execute the following block if it's a typing_extensions.Protocol class.
+        # typing.Protocol classes don't need it.
+        if isinstance(cls, _ProtocolMeta):
+            # PEP 544 prohibits using issubclass()
+            # with protocols that have non-method members.
+            # See gh-113320 for why we compute this attribute here,
+            # rather than in `_ProtocolMeta.__init__`
+            cls.__non_callable_proto_members__ = set()
+            for attr in cls.__protocol_attrs__:
+                try:
+                    is_callable = callable(getattr(cls, attr, None))
+                except Exception as e:
+                    raise TypeError(
+                        f"Failed to determine whether protocol member {attr!r} "
+                        "is a method member"
+                    ) from e
+                else:
+                    if not is_callable:
+                        cls.__non_callable_proto_members__.add(attr)
+
         return cls
 
 
-# Exists for backwards compatibility.
+# The "runtime" alias exists for backwards compatibility.
 runtime = runtime_checkable
 
 
-# 3.8+
-if hasattr(typing, 'SupportsIndex'):
+# Our version of runtime-checkable protocols is faster on Python 3.8-3.11
+if sys.version_info >= (3, 12):
+    SupportsInt = typing.SupportsInt
+    SupportsFloat = typing.SupportsFloat
+    SupportsComplex = typing.SupportsComplex
+    SupportsBytes = typing.SupportsBytes
     SupportsIndex = typing.SupportsIndex
-# 3.7
+    SupportsAbs = typing.SupportsAbs
+    SupportsRound = typing.SupportsRound
 else:
+    @runtime_checkable
+    class SupportsInt(Protocol):
+        """An ABC with one abstract method __int__."""
+        __slots__ = ()
+
+        @abc.abstractmethod
+        def __int__(self) -> int:
+            pass
+
+    @runtime_checkable
+    class SupportsFloat(Protocol):
+        """An ABC with one abstract method __float__."""
+        __slots__ = ()
+
+        @abc.abstractmethod
+        def __float__(self) -> float:
+            pass
+
+    @runtime_checkable
+    class SupportsComplex(Protocol):
+        """An ABC with one abstract method __complex__."""
+        __slots__ = ()
+
+        @abc.abstractmethod
+        def __complex__(self) -> complex:
+            pass
+
+    @runtime_checkable
+    class SupportsBytes(Protocol):
+        """An ABC with one abstract method __bytes__."""
+        __slots__ = ()
+
+        @abc.abstractmethod
+        def __bytes__(self) -> bytes:
+            pass
+
     @runtime_checkable
     class SupportsIndex(Protocol):
         __slots__ = ()
@@ -649,8 +796,45 @@ else:
         def __index__(self) -> int:
             pass
 
+    @runtime_checkable
+    class SupportsAbs(Protocol[T_co]):
+        """
+        An ABC with one abstract method __abs__ that is covariant in its return type.
+        """
+        __slots__ = ()
 
-if hasattr(typing, "Required"):
+        @abc.abstractmethod
+        def __abs__(self) -> T_co:
+            pass
+
+    @runtime_checkable
+    class SupportsRound(Protocol[T_co]):
+        """
+        An ABC with one abstract method __round__ that is covariant in its return type.
+        """
+        __slots__ = ()
+
+        @abc.abstractmethod
+        def __round__(self, ndigits: int = 0) -> T_co:
+            pass
+
+
+def _ensure_subclassable(mro_entries):
+    def inner(func):
+        if sys.implementation.name == "pypy" and sys.version_info < (3, 9):
+            cls_dict = {
+                "__call__": staticmethod(func),
+                "__mro_entries__": staticmethod(mro_entries)
+            }
+            t = type(func.__name__, (), cls_dict)
+            return functools.update_wrapper(t(), func)
+        else:
+            func.__mro_entries__ = mro_entries
+            return func
+    return inner
+
+
+if hasattr(typing, "ReadOnly"):
     # The standard library TypedDict in Python 3.8 does not store runtime information
     # about which (if any) keys are optional.  See https://bugs.python.org/issue38834
     # The standard library TypedDict in Python 3.9.0/1 does not honour the "total"
@@ -658,148 +842,164 @@ if hasattr(typing, "Required"):
     # The standard library TypedDict below Python 3.11 does not store runtime
     # information about optional and required keys when using Required or NotRequired.
     # Generic TypedDicts are also impossible using typing.TypedDict on Python <3.11.
+    # Aaaand on 3.12 we add __orig_bases__ to TypedDict
+    # to enable better runtime introspection.
+    # On 3.13 we deprecate some odd ways of creating TypedDicts.
+    # PEP 705 proposes adding the ReadOnly[] qualifier.
     TypedDict = typing.TypedDict
     _TypedDictMeta = typing._TypedDictMeta
     is_typeddict = typing.is_typeddict
 else:
-    def _check_fails(cls, other):
-        try:
-            if sys._getframe(1).f_globals['__name__'] not in ['abc',
-                                                              'functools',
-                                                              'typing']:
-                # Typed dicts are only for static structural subtyping.
-                raise TypeError('TypedDict does not support instance and class checks')
-        except (AttributeError, ValueError):
-            pass
-        return False
+    # 3.10.0 and later
+    _TAKES_MODULE = "module" in inspect.signature(typing._type_check).parameters
 
-    def _dict_new(*args, **kwargs):
-        if not args:
-            raise TypeError('TypedDict.__new__(): not enough arguments')
-        _, args = args[0], args[1:]  # allow the "cls" keyword be passed
-        return dict(*args, **kwargs)
-
-    _dict_new.__text_signature__ = '($cls, _typename, _fields=None, /, **kwargs)'
-
-    def _typeddict_new(*args, total=True, **kwargs):
-        if not args:
-            raise TypeError('TypedDict.__new__(): not enough arguments')
-        _, args = args[0], args[1:]  # allow the "cls" keyword be passed
-        if args:
-            typename, args = args[0], args[1:]  # allow the "_typename" keyword be passed
-        elif '_typename' in kwargs:
-            typename = kwargs.pop('_typename')
-            import warnings
-            warnings.warn("Passing '_typename' as keyword argument is deprecated",
-                          DeprecationWarning, stacklevel=2)
-        else:
-            raise TypeError("TypedDict.__new__() missing 1 required positional "
-                            "argument: '_typename'")
-        if args:
-            try:
-                fields, = args  # allow the "_fields" keyword be passed
-            except ValueError:
-                raise TypeError('TypedDict.__new__() takes from 2 to 3 '
-                                f'positional arguments but {len(args) + 2} '
-                                'were given')
-        elif '_fields' in kwargs and len(kwargs) == 1:
-            fields = kwargs.pop('_fields')
-            import warnings
-            warnings.warn("Passing '_fields' as keyword argument is deprecated",
-                          DeprecationWarning, stacklevel=2)
-        else:
-            fields = None
-
-        if fields is None:
-            fields = kwargs
-        elif kwargs:
-            raise TypeError("TypedDict takes either a dict or keyword arguments,"
-                            " but not both")
-
-        ns = {'__annotations__': dict(fields)}
-        try:
-            # Setting correct module is necessary to make typed dict classes pickleable.
-            ns['__module__'] = sys._getframe(1).f_globals.get('__name__', '__main__')
-        except (AttributeError, ValueError):
-            pass
-
-        return _TypedDictMeta(typename, (), ns, total=total)
-
-    _typeddict_new.__text_signature__ = ('($cls, _typename, _fields=None,'
-                                         ' /, *, total=True, **kwargs)')
+    def _get_typeddict_qualifiers(annotation_type):
+        while True:
+            annotation_origin = get_origin(annotation_type)
+            if annotation_origin is Annotated:
+                annotation_args = get_args(annotation_type)
+                if annotation_args:
+                    annotation_type = annotation_args[0]
+                else:
+                    break
+            elif annotation_origin is Required:
+                yield Required
+                annotation_type, = get_args(annotation_type)
+            elif annotation_origin is NotRequired:
+                yield NotRequired
+                annotation_type, = get_args(annotation_type)
+            elif annotation_origin is ReadOnly:
+                yield ReadOnly
+                annotation_type, = get_args(annotation_type)
+            else:
+                break
 
     class _TypedDictMeta(type):
-        def __init__(cls, name, bases, ns, total=True):
-            super().__init__(name, bases, ns)
+        def __new__(cls, name, bases, ns, *, total=True, closed=False):
+            """Create new typed dict class object.
 
-        def __new__(cls, name, bases, ns, total=True):
-            # Create new typed dict class object.
-            # This method is called directly when TypedDict is subclassed,
-            # or via _typeddict_new when TypedDict is instantiated. This way
-            # TypedDict supports all three syntaxes described in its docstring.
-            # Subclasses and instances of TypedDict return actual dictionaries
-            # via _dict_new.
-            ns['__new__'] = _typeddict_new if name == 'TypedDict' else _dict_new
-            # Don't insert typing.Generic into __bases__ here,
-            # or Generic.__init_subclass__ will raise TypeError
-            # in the super().__new__() call.
-            # Instead, monkey-patch __bases__ onto the class after it's been created.
-            tp_dict = super().__new__(cls, name, (dict,), ns)
+            This method is called when TypedDict is subclassed,
+            or when TypedDict is instantiated. This way
+            TypedDict supports all three syntax forms described in its docstring.
+            Subclasses and instances of TypedDict return actual dictionaries.
+            """
+            for base in bases:
+                if type(base) is not _TypedDictMeta and base is not typing.Generic:
+                    raise TypeError('cannot inherit from both a TypedDict type '
+                                    'and a non-TypedDict base class')
 
-            if any(issubclass(base, typing.Generic) for base in bases):
-                tp_dict.__bases__ = (typing.Generic, dict)
-                _maybe_adjust_parameters(tp_dict)
+            if any(issubclass(b, typing.Generic) for b in bases):
+                generic_base = (typing.Generic,)
+            else:
+                generic_base = ()
+
+            # typing.py generally doesn't let you inherit from plain Generic, unless
+            # the name of the class happens to be "Protocol"
+            tp_dict = type.__new__(_TypedDictMeta, "Protocol", (*generic_base, dict), ns)
+            tp_dict.__name__ = name
+            if tp_dict.__qualname__ == "Protocol":
+                tp_dict.__qualname__ = name
+
+            if not hasattr(tp_dict, '__orig_bases__'):
+                tp_dict.__orig_bases__ = bases
 
             annotations = {}
             own_annotations = ns.get('__annotations__', {})
             msg = "TypedDict('Name', {f0: t0, f1: t1, ...}); each t must be a type"
-            own_annotations = {
-                n: typing._type_check(tp, msg) for n, tp in own_annotations.items()
-            }
+            if _TAKES_MODULE:
+                own_annotations = {
+                    n: typing._type_check(tp, msg, module=tp_dict.__module__)
+                    for n, tp in own_annotations.items()
+                }
+            else:
+                own_annotations = {
+                    n: typing._type_check(tp, msg)
+                    for n, tp in own_annotations.items()
+                }
             required_keys = set()
             optional_keys = set()
+            readonly_keys = set()
+            mutable_keys = set()
+            extra_items_type = None
 
             for base in bases:
-                annotations.update(base.__dict__.get('__annotations__', {}))
-                required_keys.update(base.__dict__.get('__required_keys__', ()))
-                optional_keys.update(base.__dict__.get('__optional_keys__', ()))
+                base_dict = base.__dict__
+
+                annotations.update(base_dict.get('__annotations__', {}))
+                required_keys.update(base_dict.get('__required_keys__', ()))
+                optional_keys.update(base_dict.get('__optional_keys__', ()))
+                readonly_keys.update(base_dict.get('__readonly_keys__', ()))
+                mutable_keys.update(base_dict.get('__mutable_keys__', ()))
+                base_extra_items_type = base_dict.get('__extra_items__', None)
+                if base_extra_items_type is not None:
+                    extra_items_type = base_extra_items_type
+
+            if closed and extra_items_type is None:
+                extra_items_type = Never
+            if closed and "__extra_items__" in own_annotations:
+                annotation_type = own_annotations.pop("__extra_items__")
+                qualifiers = set(_get_typeddict_qualifiers(annotation_type))
+                if Required in qualifiers:
+                    raise TypeError(
+                        "Special key __extra_items__ does not support "
+                        "Required"
+                    )
+                if NotRequired in qualifiers:
+                    raise TypeError(
+                        "Special key __extra_items__ does not support "
+                        "NotRequired"
+                    )
+                extra_items_type = annotation_type
 
             annotations.update(own_annotations)
             for annotation_key, annotation_type in own_annotations.items():
-                annotation_origin = get_origin(annotation_type)
-                if annotation_origin is Annotated:
-                    annotation_args = get_args(annotation_type)
-                    if annotation_args:
-                        annotation_type = annotation_args[0]
-                        annotation_origin = get_origin(annotation_type)
+                qualifiers = set(_get_typeddict_qualifiers(annotation_type))
 
-                if annotation_origin is Required:
+                if Required in qualifiers:
                     required_keys.add(annotation_key)
-                elif annotation_origin is NotRequired:
+                elif NotRequired in qualifiers:
                     optional_keys.add(annotation_key)
                 elif total:
                     required_keys.add(annotation_key)
                 else:
                     optional_keys.add(annotation_key)
+                if ReadOnly in qualifiers:
+                    mutable_keys.discard(annotation_key)
+                    readonly_keys.add(annotation_key)
+                else:
+                    mutable_keys.add(annotation_key)
+                    readonly_keys.discard(annotation_key)
 
             tp_dict.__annotations__ = annotations
             tp_dict.__required_keys__ = frozenset(required_keys)
             tp_dict.__optional_keys__ = frozenset(optional_keys)
+            tp_dict.__readonly_keys__ = frozenset(readonly_keys)
+            tp_dict.__mutable_keys__ = frozenset(mutable_keys)
             if not hasattr(tp_dict, '__total__'):
                 tp_dict.__total__ = total
+            tp_dict.__closed__ = closed
+            tp_dict.__extra_items__ = extra_items_type
             return tp_dict
 
-        __instancecheck__ = __subclasscheck__ = _check_fails
+        __call__ = dict  # static method
 
-    TypedDict = _TypedDictMeta('TypedDict', (dict,), {})
-    TypedDict.__module__ = __name__
-    TypedDict.__doc__ = \
-        """A simple typed name space. At runtime it is equivalent to a plain dict.
+        def __subclasscheck__(cls, other):
+            # Typed dicts are only for static structural subtyping.
+            raise TypeError('TypedDict does not support instance and class checks')
 
-        TypedDict creates a dictionary type that expects all of its
-        instances to have a certain set of keys, with each key
+        __instancecheck__ = __subclasscheck__
+
+    _TypedDict = type.__new__(_TypedDictMeta, 'TypedDict', (), {})
+
+    @_ensure_subclassable(lambda bases: (_TypedDict,))
+    def TypedDict(typename, fields=_marker, /, *, total=True, closed=False, **kwargs):
+        """A simple typed namespace. At runtime it is equivalent to a plain dict.
+
+        TypedDict creates a dictionary type such that a type checker will expect all
+        instances to have a certain set of keys, where each key is
         associated with a value of a consistent type. This expectation
-        is not checked at runtime but is only enforced by type checkers.
+        is not checked at runtime.
+
         Usage::
 
             class Point2D(TypedDict):
@@ -814,14 +1014,71 @@ else:
 
         The type info can be accessed via the Point2D.__annotations__ dict, and
         the Point2D.__required_keys__ and Point2D.__optional_keys__ frozensets.
-        TypedDict supports two additional equivalent forms::
+        TypedDict supports an additional equivalent form::
 
-            Point2D = TypedDict('Point2D', x=int, y=int, label=str)
             Point2D = TypedDict('Point2D', {'x': int, 'y': int, 'label': str})
 
-        The class syntax is only supported in Python 3.6+, while two other
-        syntax forms work for Python 2.7 and 3.2+
+        By default, all keys must be present in a TypedDict. It is possible
+        to override this by specifying totality::
+
+            class Point2D(TypedDict, total=False):
+                x: int
+                y: int
+
+        This means that a Point2D TypedDict can have any of the keys omitted. A type
+        checker is only expected to support a literal False or True as the value of
+        the total argument. True is the default, and makes all items defined in the
+        class body be required.
+
+        The Required and NotRequired special forms can also be used to mark
+        individual keys as being required or not required::
+
+            class Point2D(TypedDict):
+                x: int  # the "x" key must always be present (Required is the default)
+                y: NotRequired[int]  # the "y" key can be omitted
+
+        See PEP 655 for more details on Required and NotRequired.
         """
+        if fields is _marker or fields is None:
+            if fields is _marker:
+                deprecated_thing = "Failing to pass a value for the 'fields' parameter"
+            else:
+                deprecated_thing = "Passing `None` as the 'fields' parameter"
+
+            example = f"`{typename} = TypedDict({typename!r}, {{}})`"
+            deprecation_msg = (
+                f"{deprecated_thing} is deprecated and will be disallowed in "
+                "Python 3.15. To create a TypedDict class with 0 fields "
+                "using the functional syntax, pass an empty dictionary, e.g. "
+            ) + example + "."
+            warnings.warn(deprecation_msg, DeprecationWarning, stacklevel=2)
+            if closed is not False and closed is not True:
+                kwargs["closed"] = closed
+                closed = False
+            fields = kwargs
+        elif kwargs:
+            raise TypeError("TypedDict takes either a dict or keyword arguments,"
+                            " but not both")
+        if kwargs:
+            if sys.version_info >= (3, 13):
+                raise TypeError("TypedDict takes no keyword arguments")
+            warnings.warn(
+                "The kwargs-based syntax for TypedDict definitions is deprecated "
+                "in Python 3.11, will be removed in Python 3.13, and may not be "
+                "understood by third-party type checkers.",
+                DeprecationWarning,
+                stacklevel=2,
+            )
+
+        ns = {'__annotations__': dict(fields)}
+        module = _caller()
+        if module is not None:
+            # Setting correct module is necessary to make typed dict classes pickleable.
+            ns['__module__'] = module
+
+        td = _TypedDictMeta(typename, (), ns, total=total, closed=closed)
+        td.__orig_bases__ = (TypedDict,)
+        return td
 
     if hasattr(typing, "_TypedDictMeta"):
         _TYPEDDICT_TYPES = (typing._TypedDictMeta, _TypedDictMeta)
@@ -839,14 +1096,17 @@ else:
             is_typeddict(Film)  # => True
             is_typeddict(Union[list, str])  # => False
         """
-        return isinstance(tp, tuple(_TYPEDDICT_TYPES))
+        # On 3.8, this would otherwise return True
+        if hasattr(typing, "TypedDict") and tp is typing.TypedDict:
+            return False
+        return isinstance(tp, _TYPEDDICT_TYPES)
 
 
 if hasattr(typing, "assert_type"):
     assert_type = typing.assert_type
 
 else:
-    def assert_type(__val, __typ):
+    def assert_type(val, typ, /):
         """Assert (to the type checker) that the value is of the given type.
 
         When the type checker encounters a call to assert_type(), it
@@ -859,15 +1119,12 @@ else:
         At runtime this returns the first argument unchanged and otherwise
         does nothing.
         """
-        return __val
+        return val
 
 
-if hasattr(typing, "Required"):
+if hasattr(typing, "Required"):  # 3.11+
     get_type_hints = typing.get_type_hints
-else:
-    import functools
-    import types
-
+else:  # <=3.10
     # replaces _strip_annotations()
     def _strip_extras(t):
         """Strips Annotated, Required and NotRequired from a given type."""
@@ -880,12 +1137,12 @@ else:
             if stripped_args == t.__args__:
                 return t
             return t.copy_with(stripped_args)
-        if hasattr(types, "GenericAlias") and isinstance(t, types.GenericAlias):
+        if hasattr(_types, "GenericAlias") and isinstance(t, _types.GenericAlias):
             stripped_args = tuple(_strip_extras(a) for a in t.__args__)
             if stripped_args == t.__args__:
                 return t
-            return types.GenericAlias(t.__origin__, stripped_args)
-        if hasattr(types, "UnionType") and isinstance(t, types.UnionType):
+            return _types.GenericAlias(t.__origin__, stripped_args)
+        if hasattr(_types, "UnionType") and isinstance(t, _types.UnionType):
             stripped_args = tuple(_strip_extras(a) for a in t.__args__)
             if stripped_args == t.__args__:
                 return t
@@ -925,11 +1182,11 @@ else:
         - If two dict arguments are passed, they specify globals and
           locals, respectively.
         """
-        if hasattr(typing, "Annotated"):
+        if hasattr(typing, "Annotated"):  # 3.9+
             hint = typing.get_type_hints(
                 obj, globalns=globalns, localns=localns, include_extras=True
             )
-        else:
+        else:  # 3.8
             hint = typing.get_type_hints(obj, globalns=globalns, localns=localns)
         if include_extras:
             return hint
@@ -942,7 +1199,7 @@ if hasattr(typing, 'Annotated'):
     # Not exported and not a public API, but needed for get_origin() and get_args()
     # to work.
     _AnnotatedAlias = typing._AnnotatedAlias
-# 3.7-3.8
+# 3.8
 else:
     class _AnnotatedAlias(typing._GenericAlias, _root=True):
         """Runtime representation of an annotated type.
@@ -1047,7 +1304,7 @@ else:
 if sys.version_info[:2] >= (3, 10):
     get_origin = typing.get_origin
     get_args = typing.get_args
-# 3.7-3.9
+# 3.8-3.9
 else:
     try:
         # 3.9+
@@ -1112,11 +1369,7 @@ if hasattr(typing, 'TypeAlias'):
     TypeAlias = typing.TypeAlias
 # 3.9
 elif sys.version_info[:2] >= (3, 9):
-    class _TypeAliasForm(typing._SpecialForm, _root=True):
-        def __repr__(self):
-            return 'typing_extensions.' + self._name
-
-    @_TypeAliasForm
+    @_ExtensionsSpecialForm
     def TypeAlias(self, parameters):
         """Special marker indicating that an assignment should
         be recognized as a proper type alias definition by type
@@ -1129,68 +1382,89 @@ elif sys.version_info[:2] >= (3, 9):
         It's invalid when used anywhere except as in the example above.
         """
         raise TypeError(f"{self} is not subscriptable")
-# 3.7-3.8
+# 3.8
 else:
-    class _TypeAliasForm(typing._SpecialForm, _root=True):
-        def __repr__(self):
-            return 'typing_extensions.' + self._name
+    TypeAlias = _ExtensionsSpecialForm(
+        'TypeAlias',
+        doc="""Special marker indicating that an assignment should
+        be recognized as a proper type alias definition by type
+        checkers.
 
-    TypeAlias = _TypeAliasForm('TypeAlias',
-                               doc="""Special marker indicating that an assignment should
-                               be recognized as a proper type alias definition by type
-                               checkers.
+        For example::
 
-                               For example::
+            Predicate: TypeAlias = Callable[..., bool]
 
-                                   Predicate: TypeAlias = Callable[..., bool]
+        It's invalid when used anywhere except as in the example
+        above."""
+    )
 
-                               It's invalid when used anywhere except as in the example
-                               above.""")
+
+def _set_default(type_param, default):
+    if isinstance(default, (tuple, list)):
+        type_param.__default__ = tuple((typing._type_check(d, "Default must be a type")
+                                        for d in default))
+    elif default != _marker:
+        if isinstance(type_param, ParamSpec) and default is ...:  # ... not valid <3.11
+            type_param.__default__ = default
+        else:
+            type_param.__default__ = typing._type_check(default, "Default must be a type")
+    else:
+        type_param.__default__ = None
+
+
+def _set_module(typevarlike):
+    # for pickling:
+    def_mod = _caller(depth=3)
+    if def_mod != 'typing_extensions':
+        typevarlike.__module__ = def_mod
 
 
 class _DefaultMixin:
     """Mixin for TypeVarLike defaults."""
 
     __slots__ = ()
+    __init__ = _set_default
 
-    def __init__(self, default):
-        if isinstance(default, (tuple, list)):
-            self.__default__ = tuple((typing._type_check(d, "Default must be a type")
-                                      for d in default))
-        elif default:
-            self.__default__ = typing._type_check(default, "Default must be a type")
-        else:
-            self.__default__ = None
+
+# Classes using this metaclass must provide a _backported_typevarlike ClassVar
+class _TypeVarLikeMeta(type):
+    def __instancecheck__(cls, __instance: Any) -> bool:
+        return isinstance(__instance, cls._backported_typevarlike)
 
 
 # Add default and infer_variance parameters from PEP 696 and 695
-class TypeVar(typing.TypeVar, _DefaultMixin, _root=True):
+class TypeVar(metaclass=_TypeVarLikeMeta):
     """Type variable."""
 
-    __module__ = 'typing'
+    _backported_typevarlike = typing.TypeVar
 
-    def __init__(self, name, *constraints, bound=None,
-                 covariant=False, contravariant=False,
-                 default=None, infer_variance=False):
-        super().__init__(name, *constraints, bound=bound, covariant=covariant,
-                         contravariant=contravariant)
-        _DefaultMixin.__init__(self, default)
-        self.__infer_variance__ = infer_variance
+    def __new__(cls, name, *constraints, bound=None,
+                covariant=False, contravariant=False,
+                default=_marker, infer_variance=False):
+        if hasattr(typing, "TypeAliasType"):
+            # PEP 695 implemented (3.12+), can pass infer_variance to typing.TypeVar
+            typevar = typing.TypeVar(name, *constraints, bound=bound,
+                                     covariant=covariant, contravariant=contravariant,
+                                     infer_variance=infer_variance)
+        else:
+            typevar = typing.TypeVar(name, *constraints, bound=bound,
+                                     covariant=covariant, contravariant=contravariant)
+            if infer_variance and (covariant or contravariant):
+                raise ValueError("Variance cannot be specified with infer_variance.")
+            typevar.__infer_variance__ = infer_variance
+        _set_default(typevar, default)
+        _set_module(typevar)
+        return typevar
 
-        # for pickling:
-        try:
-            def_mod = sys._getframe(1).f_globals.get('__name__', '__main__')
-        except (AttributeError, ValueError):
-            def_mod = None
-        if def_mod != 'typing_extensions':
-            self.__module__ = def_mod
+    def __init_subclass__(cls) -> None:
+        raise TypeError(f"type '{__name__}.TypeVar' is not an acceptable base type")
 
 
 # Python 3.10+ has PEP 612
 if hasattr(typing, 'ParamSpecArgs'):
     ParamSpecArgs = typing.ParamSpecArgs
     ParamSpecKwargs = typing.ParamSpecKwargs
-# 3.7-3.9
+# 3.8-3.9
 else:
     class _Immutable:
         """Mixin to indicate that object should not be copied."""
@@ -1251,27 +1525,35 @@ else:
 # 3.10+
 if hasattr(typing, 'ParamSpec'):
 
-    # Add default Parameter - PEP 696
-    class ParamSpec(typing.ParamSpec, _DefaultMixin, _root=True):
-        """Parameter specification variable."""
+    # Add default parameter - PEP 696
+    class ParamSpec(metaclass=_TypeVarLikeMeta):
+        """Parameter specification."""
 
-        __module__ = 'typing'
+        _backported_typevarlike = typing.ParamSpec
 
-        def __init__(self, name, *, bound=None, covariant=False, contravariant=False,
-                     default=None):
-            super().__init__(name, bound=bound, covariant=covariant,
-                             contravariant=contravariant)
-            _DefaultMixin.__init__(self, default)
+        def __new__(cls, name, *, bound=None,
+                    covariant=False, contravariant=False,
+                    infer_variance=False, default=_marker):
+            if hasattr(typing, "TypeAliasType"):
+                # PEP 695 implemented, can pass infer_variance to typing.TypeVar
+                paramspec = typing.ParamSpec(name, bound=bound,
+                                             covariant=covariant,
+                                             contravariant=contravariant,
+                                             infer_variance=infer_variance)
+            else:
+                paramspec = typing.ParamSpec(name, bound=bound,
+                                             covariant=covariant,
+                                             contravariant=contravariant)
+                paramspec.__infer_variance__ = infer_variance
 
-            # for pickling:
-            try:
-                def_mod = sys._getframe(1).f_globals.get('__name__', '__main__')
-            except (AttributeError, ValueError):
-                def_mod = None
-            if def_mod != 'typing_extensions':
-                self.__module__ = def_mod
+            _set_default(paramspec, default)
+            _set_module(paramspec)
+            return paramspec
 
-# 3.7-3.9
+        def __init_subclass__(cls) -> None:
+            raise TypeError(f"type '{__name__}.ParamSpec' is not an acceptable base type")
+
+# 3.8-3.9
 else:
 
     # Inherits from list as a workaround for Callable checks in Python < 3.9.2.
@@ -1334,11 +1616,12 @@ else:
             return ParamSpecKwargs(self)
 
         def __init__(self, name, *, bound=None, covariant=False, contravariant=False,
-                     default=None):
+                     infer_variance=False, default=_marker):
             super().__init__([self])
             self.__name__ = name
             self.__covariant__ = bool(covariant)
             self.__contravariant__ = bool(contravariant)
+            self.__infer_variance__ = bool(infer_variance)
             if bound:
                 self.__bound__ = typing._type_check(bound, 'Bound must be a type.')
             else:
@@ -1346,15 +1629,14 @@ else:
             _DefaultMixin.__init__(self, default)
 
             # for pickling:
-            try:
-                def_mod = sys._getframe(1).f_globals.get('__name__', '__main__')
-            except (AttributeError, ValueError):
-                def_mod = None
+            def_mod = _caller()
             if def_mod != 'typing_extensions':
                 self.__module__ = def_mod
 
         def __repr__(self):
-            if self.__covariant__:
+            if self.__infer_variance__:
+                prefix = ''
+            elif self.__covariant__:
                 prefix = '+'
             elif self.__contravariant__:
                 prefix = '-'
@@ -1376,7 +1658,7 @@ else:
             pass
 
 
-# 3.7-3.9
+# 3.8-3.9
 if not hasattr(typing, 'Concatenate'):
     # Inherits from list as a workaround for Callable checks in Python < 3.9.2.
     class _ConcatenateGenericAlias(list):
@@ -1411,7 +1693,7 @@ if not hasattr(typing, 'Concatenate'):
             )
 
 
-# 3.7-3.9
+# 3.8-3.9
 @typing._tp_cache
 def _concatenate_getitem(self, parameters):
     if parameters == ():
@@ -1429,10 +1711,10 @@ def _concatenate_getitem(self, parameters):
 # 3.10+
 if hasattr(typing, 'Concatenate'):
     Concatenate = typing.Concatenate
-    _ConcatenateGenericAlias = typing._ConcatenateGenericAlias # noqa
+    _ConcatenateGenericAlias = typing._ConcatenateGenericAlias  # noqa: F811
 # 3.9
 elif sys.version_info[:2] >= (3, 9):
-    @_TypeAliasForm
+    @_ExtensionsSpecialForm
     def Concatenate(self, parameters):
         """Used in conjunction with ``ParamSpec`` and ``Callable`` to represent a
         higher order function which adds, removes or transforms parameters of a
@@ -1445,12 +1727,9 @@ elif sys.version_info[:2] >= (3, 9):
         See PEP 612 for detailed information.
         """
         return _concatenate_getitem(self, parameters)
-# 3.7-8
+# 3.8
 else:
-    class _ConcatenateForm(typing._SpecialForm, _root=True):
-        def __repr__(self):
-            return 'typing_extensions.' + self._name
-
+    class _ConcatenateForm(_ExtensionsSpecialForm, _root=True):
         def __getitem__(self, parameters):
             return _concatenate_getitem(self, parameters)
 
@@ -1472,11 +1751,7 @@ if hasattr(typing, 'TypeGuard'):
     TypeGuard = typing.TypeGuard
 # 3.9
 elif sys.version_info[:2] >= (3, 9):
-    class _TypeGuardForm(typing._SpecialForm, _root=True):
-        def __repr__(self):
-            return 'typing_extensions.' + self._name
-
-    @_TypeGuardForm
+    @_ExtensionsSpecialForm
     def TypeGuard(self, parameters):
         """Special typing form used to annotate the return type of a user-defined
         type guard function.  ``TypeGuard`` only accepts a single type argument.
@@ -1522,13 +1797,9 @@ elif sys.version_info[:2] >= (3, 9):
         """
         item = typing._type_check(parameters, f'{self} accepts only a single type.')
         return typing._GenericAlias(self, (item,))
-# 3.7-3.8
+# 3.8
 else:
-    class _TypeGuardForm(typing._SpecialForm, _root=True):
-
-        def __repr__(self):
-            return 'typing_extensions.' + self._name
-
+    class _TypeGuardForm(_ExtensionsSpecialForm, _root=True):
         def __getitem__(self, parameters):
             item = typing._type_check(parameters,
                                       f'{self._name} accepts only a single type')
@@ -1579,6 +1850,98 @@ else:
         PEP 647 (User-Defined Type Guards).
         """)
 
+# 3.13+
+if hasattr(typing, 'TypeIs'):
+    TypeIs = typing.TypeIs
+# 3.9
+elif sys.version_info[:2] >= (3, 9):
+    @_ExtensionsSpecialForm
+    def TypeIs(self, parameters):
+        """Special typing form used to annotate the return type of a user-defined
+        type narrower function.  ``TypeIs`` only accepts a single type argument.
+        At runtime, functions marked this way should return a boolean.
+
+        ``TypeIs`` aims to benefit *type narrowing* -- a technique used by static
+        type checkers to determine a more precise type of an expression within a
+        program's code flow.  Usually type narrowing is done by analyzing
+        conditional code flow and applying the narrowing to a block of code.  The
+        conditional expression here is sometimes referred to as a "type guard".
+
+        Sometimes it would be convenient to use a user-defined boolean function
+        as a type guard.  Such a function should use ``TypeIs[...]`` as its
+        return type to alert static type checkers to this intention.
+
+        Using  ``-> TypeIs`` tells the static type checker that for a given
+        function:
+
+        1. The return value is a boolean.
+        2. If the return value is ``True``, the type of its argument
+        is the intersection of the type inside ``TypeGuard`` and the argument's
+        previously known type.
+
+        For example::
+
+            def is_awaitable(val: object) -> TypeIs[Awaitable[Any]]:
+                return hasattr(val, '__await__')
+
+            def f(val: Union[int, Awaitable[int]]) -> int:
+                if is_awaitable(val):
+                    assert_type(val, Awaitable[int])
+                else:
+                    assert_type(val, int)
+
+        ``TypeIs`` also works with type variables.  For more information, see
+        PEP 742 (Narrowing types with TypeIs).
+        """
+        item = typing._type_check(parameters, f'{self} accepts only a single type.')
+        return typing._GenericAlias(self, (item,))
+# 3.8
+else:
+    class _TypeIsForm(_ExtensionsSpecialForm, _root=True):
+        def __getitem__(self, parameters):
+            item = typing._type_check(parameters,
+                                      f'{self._name} accepts only a single type')
+            return typing._GenericAlias(self, (item,))
+
+    TypeIs = _TypeIsForm(
+        'TypeIs',
+        doc="""Special typing form used to annotate the return type of a user-defined
+        type narrower function.  ``TypeIs`` only accepts a single type argument.
+        At runtime, functions marked this way should return a boolean.
+
+        ``TypeIs`` aims to benefit *type narrowing* -- a technique used by static
+        type checkers to determine a more precise type of an expression within a
+        program's code flow.  Usually type narrowing is done by analyzing
+        conditional code flow and applying the narrowing to a block of code.  The
+        conditional expression here is sometimes referred to as a "type guard".
+
+        Sometimes it would be convenient to use a user-defined boolean function
+        as a type guard.  Such a function should use ``TypeIs[...]`` as its
+        return type to alert static type checkers to this intention.
+
+        Using  ``-> TypeIs`` tells the static type checker that for a given
+        function:
+
+        1. The return value is a boolean.
+        2. If the return value is ``True``, the type of its argument
+        is the intersection of the type inside ``TypeGuard`` and the argument's
+        previously known type.
+
+        For example::
+
+            def is_awaitable(val: object) -> TypeIs[Awaitable[Any]]:
+                return hasattr(val, '__await__')
+
+            def f(val: Union[int, Awaitable[int]]) -> int:
+                if is_awaitable(val):
+                    assert_type(val, Awaitable[int])
+                else:
+                    assert_type(val, int)
+
+        ``TypeIs`` also works with type variables.  For more information, see
+        PEP 742 (Narrowing types with TypeIs).
+        """)
+
 
 # Vendored from cpython typing._SpecialFrom
 class _SpecialForm(typing._Final, _root=True):
@@ -1624,7 +1987,7 @@ class _SpecialForm(typing._Final, _root=True):
         return self._getitem(self, parameters)
 
 
-if hasattr(typing, "LiteralString"):
+if hasattr(typing, "LiteralString"):  # 3.11+
     LiteralString = typing.LiteralString
 else:
     @_SpecialForm
@@ -1647,7 +2010,7 @@ else:
         raise TypeError(f"{self} is not subscriptable")
 
 
-if hasattr(typing, "Self"):
+if hasattr(typing, "Self"):  # 3.11+
     Self = typing.Self
 else:
     @_SpecialForm
@@ -1668,7 +2031,7 @@ else:
         raise TypeError(f"{self} is not subscriptable")
 
 
-if hasattr(typing, "Never"):
+if hasattr(typing, "Never"):  # 3.11+
     Never = typing.Never
 else:
     @_SpecialForm
@@ -1698,14 +2061,10 @@ else:
         raise TypeError(f"{self} is not subscriptable")
 
 
-if hasattr(typing, 'Required'):
+if hasattr(typing, 'Required'):  # 3.11+
     Required = typing.Required
     NotRequired = typing.NotRequired
-elif sys.version_info[:2] >= (3, 9):
-    class _ExtensionsSpecialForm(typing._SpecialForm, _root=True):
-        def __repr__(self):
-            return 'typing_extensions.' + self._name
-
+elif sys.version_info[:2] >= (3, 9):  # 3.9-3.10
     @_ExtensionsSpecialForm
     def Required(self, parameters):
         """A special typing construct to mark a key of a total=False TypedDict
@@ -1743,11 +2102,8 @@ elif sys.version_info[:2] >= (3, 9):
         item = typing._type_check(parameters, f'{self._name} accepts only a single type.')
         return typing._GenericAlias(self, (item,))
 
-else:
-    class _RequiredForm(typing._SpecialForm, _root=True):
-        def __repr__(self):
-            return 'typing_extensions.' + self._name
-
+else:  # 3.8
+    class _RequiredForm(_ExtensionsSpecialForm, _root=True):
         def __getitem__(self, parameters):
             item = typing._type_check(parameters,
                                       f'{self._name} accepts only a single type.')
@@ -1786,59 +2142,129 @@ else:
         """)
 
 
-if hasattr(typing, "Unpack"):  # 3.11+
+if hasattr(typing, 'ReadOnly'):
+    ReadOnly = typing.ReadOnly
+elif sys.version_info[:2] >= (3, 9):  # 3.9-3.12
+    @_ExtensionsSpecialForm
+    def ReadOnly(self, parameters):
+        """A special typing construct to mark an item of a TypedDict as read-only.
+
+        For example:
+
+            class Movie(TypedDict):
+                title: ReadOnly[str]
+                year: int
+
+            def mutate_movie(m: Movie) -> None:
+                m["year"] = 1992  # allowed
+                m["title"] = "The Matrix"  # typechecker error
+
+        There is no runtime checking for this property.
+        """
+        item = typing._type_check(parameters, f'{self._name} accepts only a single type.')
+        return typing._GenericAlias(self, (item,))
+
+else:  # 3.8
+    class _ReadOnlyForm(_ExtensionsSpecialForm, _root=True):
+        def __getitem__(self, parameters):
+            item = typing._type_check(parameters,
+                                      f'{self._name} accepts only a single type.')
+            return typing._GenericAlias(self, (item,))
+
+    ReadOnly = _ReadOnlyForm(
+        'ReadOnly',
+        doc="""A special typing construct to mark a key of a TypedDict as read-only.
+
+        For example:
+
+            class Movie(TypedDict):
+                title: ReadOnly[str]
+                year: int
+
+            def mutate_movie(m: Movie) -> None:
+                m["year"] = 1992  # allowed
+                m["title"] = "The Matrix"  # typechecker error
+
+        There is no runtime checking for this propery.
+        """)
+
+
+_UNPACK_DOC = """\
+Type unpack operator.
+
+The type unpack operator takes the child types from some container type,
+such as `tuple[int, str]` or a `TypeVarTuple`, and 'pulls them out'. For
+example:
+
+  # For some generic class `Foo`:
+  Foo[Unpack[tuple[int, str]]]  # Equivalent to Foo[int, str]
+
+  Ts = TypeVarTuple('Ts')
+  # Specifies that `Bar` is generic in an arbitrary number of types.
+  # (Think of `Ts` as a tuple of an arbitrary number of individual
+  #  `TypeVar`s, which the `Unpack` is 'pulling out' directly into the
+  #  `Generic[]`.)
+  class Bar(Generic[Unpack[Ts]]): ...
+  Bar[int]  # Valid
+  Bar[int, str]  # Also valid
+
+From Python 3.11, this can also be done using the `*` operator:
+
+    Foo[*tuple[int, str]]
+    class Bar(Generic[*Ts]): ...
+
+The operator can also be used along with a `TypedDict` to annotate
+`**kwargs` in a function signature. For instance:
+
+  class Movie(TypedDict):
+    name: str
+    year: int
+
+  # This function expects two keyword arguments - *name* of type `str` and
+  # *year* of type `int`.
+  def foo(**kwargs: Unpack[Movie]): ...
+
+Note that there is only some runtime checking of this operator. Not
+everything the runtime allows may be accepted by static type checkers.
+
+For more information, see PEP 646 and PEP 692.
+"""
+
+
+if sys.version_info >= (3, 12):  # PEP 692 changed the repr of Unpack[]
     Unpack = typing.Unpack
-elif sys.version_info[:2] >= (3, 9):
-    class _UnpackSpecialForm(typing._SpecialForm, _root=True):
-        def __repr__(self):
-            return 'typing_extensions.' + self._name
+
+    def _is_unpack(obj):
+        return get_origin(obj) is Unpack
+
+elif sys.version_info[:2] >= (3, 9):  # 3.9+
+    class _UnpackSpecialForm(_ExtensionsSpecialForm, _root=True):
+        def __init__(self, getitem):
+            super().__init__(getitem)
+            self.__doc__ = _UNPACK_DOC
 
     class _UnpackAlias(typing._GenericAlias, _root=True):
         __class__ = typing.TypeVar
 
     @_UnpackSpecialForm
     def Unpack(self, parameters):
-        """A special typing construct to unpack a variadic type. For example:
-
-            Shape = TypeVarTuple('Shape')
-            Batch = NewType('Batch', int)
-
-            def add_batch_axis(
-                x: Array[Unpack[Shape]]
-            ) -> Array[Batch, Unpack[Shape]]: ...
-
-        """
         item = typing._type_check(parameters, f'{self._name} accepts only a single type.')
         return _UnpackAlias(self, (item,))
 
     def _is_unpack(obj):
         return isinstance(obj, _UnpackAlias)
 
-else:
+else:  # 3.8
     class _UnpackAlias(typing._GenericAlias, _root=True):
         __class__ = typing.TypeVar
 
-    class _UnpackForm(typing._SpecialForm, _root=True):
-        def __repr__(self):
-            return 'typing_extensions.' + self._name
-
+    class _UnpackForm(_ExtensionsSpecialForm, _root=True):
         def __getitem__(self, parameters):
             item = typing._type_check(parameters,
                                       f'{self._name} accepts only a single type.')
             return _UnpackAlias(self, (item,))
 
-    Unpack = _UnpackForm(
-        'Unpack',
-        doc="""A special typing construct to unpack a variadic type. For example:
-
-            Shape = TypeVarTuple('Shape')
-            Batch = NewType('Batch', int)
-
-            def add_batch_axis(
-                x: Array[Unpack[Shape]]
-            ) -> Array[Batch, Unpack[Shape]]: ...
-
-        """)
+    Unpack = _UnpackForm('Unpack', doc=_UNPACK_DOC)
 
     def _is_unpack(obj):
         return isinstance(obj, _UnpackAlias)
@@ -1846,23 +2272,22 @@ else:
 
 if hasattr(typing, "TypeVarTuple"):  # 3.11+
 
-    # Add default Parameter - PEP 696
-    class TypeVarTuple(typing.TypeVarTuple, _DefaultMixin, _root=True):
+    # Add default parameter - PEP 696
+    class TypeVarTuple(metaclass=_TypeVarLikeMeta):
         """Type variable tuple."""
 
-        def __init__(self, name, *, default=None):
-            super().__init__(name)
-            _DefaultMixin.__init__(self, default)
+        _backported_typevarlike = typing.TypeVarTuple
 
-            # for pickling:
-            try:
-                def_mod = sys._getframe(1).f_globals.get('__name__', '__main__')
-            except (AttributeError, ValueError):
-                def_mod = None
-            if def_mod != 'typing_extensions':
-                self.__module__ = def_mod
+        def __new__(cls, name, *, default=_marker):
+            tvt = typing.TypeVarTuple(name)
+            _set_default(tvt, default)
+            _set_module(tvt)
+            return tvt
 
-else:
+        def __init_subclass__(self, *args, **kwds):
+            raise TypeError("Cannot subclass special typing classes")
+
+else:  # <=3.10
     class TypeVarTuple(_DefaultMixin):
         """Type variable tuple.
 
@@ -1913,15 +2338,12 @@ else:
         def __iter__(self):
             yield self.__unpacked__
 
-        def __init__(self, name, *, default=None):
+        def __init__(self, name, *, default=_marker):
             self.__name__ = name
             _DefaultMixin.__init__(self, default)
 
             # for pickling:
-            try:
-                def_mod = sys._getframe(1).f_globals.get('__name__', '__main__')
-            except (AttributeError, ValueError):
-                def_mod = None
+            def_mod = _caller()
             if def_mod != 'typing_extensions':
                 self.__module__ = def_mod
 
@@ -1944,10 +2366,10 @@ else:
                 raise TypeError("Cannot subclass special typing classes")
 
 
-if hasattr(typing, "reveal_type"):
+if hasattr(typing, "reveal_type"):  # 3.11+
     reveal_type = typing.reveal_type
-else:
-    def reveal_type(__obj: T) -> T:
+else:  # <=3.10
+    def reveal_type(obj: T, /) -> T:
         """Reveal the inferred type of a variable.
 
         When a static type checker encounters a call to ``reveal_type()``,
@@ -1963,14 +2385,14 @@ else:
         argument and returns it unchanged.
 
         """
-        print(f"Runtime type is {type(__obj).__name__!r}", file=sys.stderr)
-        return __obj
+        print(f"Runtime type is {type(obj).__name__!r}", file=sys.stderr)
+        return obj
 
 
-if hasattr(typing, "assert_never"):
+if hasattr(typing, "assert_never"):  # 3.11+
     assert_never = typing.assert_never
-else:
-    def assert_never(__arg: Never) -> Never:
+else:  # <=3.10
+    def assert_never(arg: Never, /) -> Never:
         """Assert to the type checker that a line of code is unreachable.
 
         Example::
@@ -1993,14 +2415,16 @@ else:
         raise AssertionError("Expected code to be unreachable")
 
 
-if hasattr(typing, 'dataclass_transform'):
+if sys.version_info >= (3, 12):  # 3.12+
+    # dataclass_transform exists in 3.11 but lacks the frozen_default parameter
     dataclass_transform = typing.dataclass_transform
-else:
+else:  # <=3.11
     def dataclass_transform(
         *,
         eq_default: bool = True,
         order_default: bool = False,
         kw_only_default: bool = False,
+        frozen_default: bool = False,
         field_specifiers: typing.Tuple[
             typing.Union[typing.Type[typing.Any], typing.Callable[..., typing.Any]],
             ...
@@ -2057,6 +2481,8 @@ else:
           assumed to be True or False if it is omitted by the caller.
         - ``kw_only_default`` indicates whether the ``kw_only`` parameter is
           assumed to be True or False if it is omitted by the caller.
+        - ``frozen_default`` indicates whether the ``frozen`` parameter is
+          assumed to be True or False if it is omitted by the caller.
         - ``field_specifiers`` specifies a static list of supported classes
           or functions that describe fields, similar to ``dataclasses.field()``.
 
@@ -2071,6 +2497,7 @@ else:
                 "eq_default": eq_default,
                 "order_default": order_default,
                 "kw_only_default": kw_only_default,
+                "frozen_default": frozen_default,
                 "field_specifiers": field_specifiers,
                 "kwargs": kwargs,
             }
@@ -2078,18 +2505,18 @@ else:
         return decorator
 
 
-if hasattr(typing, "override"):
+if hasattr(typing, "override"):  # 3.12+
     override = typing.override
-else:
+else:  # <=3.11
     _F = typing.TypeVar("_F", bound=typing.Callable[..., typing.Any])
 
-    def override(__arg: _F) -> _F:
+    def override(arg: _F, /) -> _F:
         """Indicate that a method is intended to override a method in a base class.
 
         Usage:
 
             class Base:
-                def method(self) -> None: ...
+                def method(self) -> None:
                     pass
 
             class Child(Base):
@@ -2102,10 +2529,156 @@ else:
         This helps prevent bugs that may occur when a base class is changed
         without an equivalent change to a child class.
 
+        There is no runtime checking of these properties. The decorator
+        sets the ``__override__`` attribute to ``True`` on the decorated object
+        to allow runtime introspection.
+
         See PEP 698 for details.
 
         """
-        return __arg
+        try:
+            arg.__override__ = True
+        except (AttributeError, TypeError):
+            # Skip the attribute silently if it is not writable.
+            # AttributeError happens if the object has __slots__ or a
+            # read-only property, TypeError if it's a builtin class.
+            pass
+        return arg
+
+
+if hasattr(warnings, "deprecated"):
+    deprecated = warnings.deprecated
+else:
+    _T = typing.TypeVar("_T")
+
+    class deprecated:
+        """Indicate that a class, function or overload is deprecated.
+
+        When this decorator is applied to an object, the type checker
+        will generate a diagnostic on usage of the deprecated object.
+
+        Usage:
+
+            @deprecated("Use B instead")
+            class A:
+                pass
+
+            @deprecated("Use g instead")
+            def f():
+                pass
+
+            @overload
+            @deprecated("int support is deprecated")
+            def g(x: int) -> int: ...
+            @overload
+            def g(x: str) -> int: ...
+
+        The warning specified by *category* will be emitted at runtime
+        on use of deprecated objects. For functions, that happens on calls;
+        for classes, on instantiation and on creation of subclasses.
+        If the *category* is ``None``, no warning is emitted at runtime.
+        The *stacklevel* determines where the
+        warning is emitted. If it is ``1`` (the default), the warning
+        is emitted at the direct caller of the deprecated object; if it
+        is higher, it is emitted further up the stack.
+        Static type checker behavior is not affected by the *category*
+        and *stacklevel* arguments.
+
+        The deprecation message passed to the decorator is saved in the
+        ``__deprecated__`` attribute on the decorated object.
+        If applied to an overload, the decorator
+        must be after the ``@overload`` decorator for the attribute to
+        exist on the overload as returned by ``get_overloads()``.
+
+        See PEP 702 for details.
+
+        """
+        def __init__(
+            self,
+            message: str,
+            /,
+            *,
+            category: typing.Optional[typing.Type[Warning]] = DeprecationWarning,
+            stacklevel: int = 1,
+        ) -> None:
+            if not isinstance(message, str):
+                raise TypeError(
+                    "Expected an object of type str for 'message', not "
+                    f"{type(message).__name__!r}"
+                )
+            self.message = message
+            self.category = category
+            self.stacklevel = stacklevel
+
+        def __call__(self, arg: _T, /) -> _T:
+            # Make sure the inner functions created below don't
+            # retain a reference to self.
+            msg = self.message
+            category = self.category
+            stacklevel = self.stacklevel
+            if category is None:
+                arg.__deprecated__ = msg
+                return arg
+            elif isinstance(arg, type):
+                import functools
+                from types import MethodType
+
+                original_new = arg.__new__
+
+                @functools.wraps(original_new)
+                def __new__(cls, *args, **kwargs):
+                    if cls is arg:
+                        warnings.warn(msg, category=category, stacklevel=stacklevel + 1)
+                    if original_new is not object.__new__:
+                        return original_new(cls, *args, **kwargs)
+                    # Mirrors a similar check in object.__new__.
+                    elif cls.__init__ is object.__init__ and (args or kwargs):
+                        raise TypeError(f"{cls.__name__}() takes no arguments")
+                    else:
+                        return original_new(cls)
+
+                arg.__new__ = staticmethod(__new__)
+
+                original_init_subclass = arg.__init_subclass__
+                # We need slightly different behavior if __init_subclass__
+                # is a bound method (likely if it was implemented in Python)
+                if isinstance(original_init_subclass, MethodType):
+                    original_init_subclass = original_init_subclass.__func__
+
+                    @functools.wraps(original_init_subclass)
+                    def __init_subclass__(*args, **kwargs):
+                        warnings.warn(msg, category=category, stacklevel=stacklevel + 1)
+                        return original_init_subclass(*args, **kwargs)
+
+                    arg.__init_subclass__ = classmethod(__init_subclass__)
+                # Or otherwise, which likely means it's a builtin such as
+                # object's implementation of __init_subclass__.
+                else:
+                    @functools.wraps(original_init_subclass)
+                    def __init_subclass__(*args, **kwargs):
+                        warnings.warn(msg, category=category, stacklevel=stacklevel + 1)
+                        return original_init_subclass(*args, **kwargs)
+
+                    arg.__init_subclass__ = __init_subclass__
+
+                arg.__deprecated__ = __new__.__deprecated__ = msg
+                __init_subclass__.__deprecated__ = msg
+                return arg
+            elif callable(arg):
+                import functools
+
+                @functools.wraps(arg)
+                def wrapper(*args, **kwargs):
+                    warnings.warn(msg, category=category, stacklevel=stacklevel + 1)
+                    return arg(*args, **kwargs)
+
+                arg.__deprecated__ = wrapper.__deprecated__ = msg
+                return wrapper
+            else:
+                raise TypeError(
+                    "@deprecated decorator with non-None category must be applied to "
+                    f"a class or callable, not {arg!r}"
+                )
 
 
 # We have to do some monkey patching to deal with the dual nature of
@@ -2120,18 +2693,14 @@ if not hasattr(typing, "TypeVarTuple"):
     typing._check_generic = _check_generic
 
 
-# Backport typing.NamedTuple as it exists in Python 3.11.
+# Backport typing.NamedTuple as it exists in Python 3.13.
 # In 3.11, the ability to define generic `NamedTuple`s was supported.
 # This was explicitly disallowed in 3.9-3.10, and only half-worked in <=3.8.
-if sys.version_info >= (3, 11):
+# On 3.12, we added __orig_bases__ to call-based NamedTuples
+# On 3.13, we deprecated kwargs-based NamedTuples
+if sys.version_info >= (3, 13):
     NamedTuple = typing.NamedTuple
 else:
-    def _caller():
-        try:
-            return sys._getframe(2).f_globals.get('__name__', '__main__')
-        except (AttributeError, ValueError):  # For platforms without _getframe()
-            return None
-
     def _make_nmtuple(name, types, module, defaults=()):
         fields = [n for n, t in types]
         annotations = {n: typing._type_check(t, f"field {n} annotation must be a type")
@@ -2173,37 +2742,486 @@ else:
             )
             nm_tpl.__bases__ = bases
             if typing.Generic in bases:
-                class_getitem = typing.Generic.__class_getitem__.__func__
-                nm_tpl.__class_getitem__ = classmethod(class_getitem)
+                if hasattr(typing, '_generic_class_getitem'):  # 3.12+
+                    nm_tpl.__class_getitem__ = classmethod(typing._generic_class_getitem)
+                else:
+                    class_getitem = typing.Generic.__class_getitem__.__func__
+                    nm_tpl.__class_getitem__ = classmethod(class_getitem)
             # update from user namespace without overriding special namedtuple attributes
-            for key in ns:
+            for key, val in ns.items():
                 if key in _prohibited_namedtuple_fields:
                     raise AttributeError("Cannot overwrite NamedTuple attribute " + key)
-                elif key not in _special_namedtuple_fields and key not in nm_tpl._fields:
-                    setattr(nm_tpl, key, ns[key])
+                elif key not in _special_namedtuple_fields:
+                    if key not in nm_tpl._fields:
+                        setattr(nm_tpl, key, ns[key])
+                    try:
+                        set_name = type(val).__set_name__
+                    except AttributeError:
+                        pass
+                    else:
+                        try:
+                            set_name(val, nm_tpl, key)
+                        except BaseException as e:
+                            msg = (
+                                f"Error calling __set_name__ on {type(val).__name__!r} "
+                                f"instance {key!r} in {typename!r}"
+                            )
+                            # BaseException.add_note() existed on py311,
+                            # but the __set_name__ machinery didn't start
+                            # using add_note() until py312.
+                            # Making sure exceptions are raised in the same way
+                            # as in "normal" classes seems most important here.
+                            if sys.version_info >= (3, 12):
+                                e.add_note(msg)
+                                raise
+                            else:
+                                raise RuntimeError(msg) from e
+
             if typing.Generic in bases:
                 nm_tpl.__init_subclass__()
             return nm_tpl
 
-    def NamedTuple(__typename, __fields=None, **kwargs):
-        if __fields is None:
-            __fields = kwargs.items()
-        elif kwargs:
-            raise TypeError("Either list of fields or keywords"
-                            " can be provided to NamedTuple, not both")
-        return _make_nmtuple(__typename, __fields, module=_caller())
-
-    NamedTuple.__doc__ = typing.NamedTuple.__doc__
     _NamedTuple = type.__new__(_NamedTupleMeta, 'NamedTuple', (), {})
 
-    # On 3.8+, alter the signature so that it matches typing.NamedTuple.
-    # The signature of typing.NamedTuple on >=3.8 is invalid syntax in Python 3.7,
-    # so just leave the signature as it is on 3.7.
-    if sys.version_info >= (3, 8):
-        NamedTuple.__text_signature__ = '(typename, fields=None, /, **kwargs)'
-
     def _namedtuple_mro_entries(bases):
         assert NamedTuple in bases
         return (_NamedTuple,)
 
-    NamedTuple.__mro_entries__ = _namedtuple_mro_entries
+    @_ensure_subclassable(_namedtuple_mro_entries)
+    def NamedTuple(typename, fields=_marker, /, **kwargs):
+        """Typed version of namedtuple.
+
+        Usage::
+
+            class Employee(NamedTuple):
+                name: str
+                id: int
+
+        This is equivalent to::
+
+            Employee = collections.namedtuple('Employee', ['name', 'id'])
+
+        The resulting class has an extra __annotations__ attribute, giving a
+        dict that maps field names to types.  (The field names are also in
+        the _fields attribute, which is part of the namedtuple API.)
+        An alternative equivalent functional syntax is also accepted::
+
+            Employee = NamedTuple('Employee', [('name', str), ('id', int)])
+        """
+        if fields is _marker:
+            if kwargs:
+                deprecated_thing = "Creating NamedTuple classes using keyword arguments"
+                deprecation_msg = (
+                    "{name} is deprecated and will be disallowed in Python {remove}. "
+                    "Use the class-based or functional syntax instead."
+                )
+            else:
+                deprecated_thing = "Failing to pass a value for the 'fields' parameter"
+                example = f"`{typename} = NamedTuple({typename!r}, [])`"
+                deprecation_msg = (
+                    "{name} is deprecated and will be disallowed in Python {remove}. "
+                    "To create a NamedTuple class with 0 fields "
+                    "using the functional syntax, "
+                    "pass an empty list, e.g. "
+                ) + example + "."
+        elif fields is None:
+            if kwargs:
+                raise TypeError(
+                    "Cannot pass `None` as the 'fields' parameter "
+                    "and also specify fields using keyword arguments"
+                )
+            else:
+                deprecated_thing = "Passing `None` as the 'fields' parameter"
+                example = f"`{typename} = NamedTuple({typename!r}, [])`"
+                deprecation_msg = (
+                    "{name} is deprecated and will be disallowed in Python {remove}. "
+                    "To create a NamedTuple class with 0 fields "
+                    "using the functional syntax, "
+                    "pass an empty list, e.g. "
+                ) + example + "."
+        elif kwargs:
+            raise TypeError("Either list of fields or keywords"
+                            " can be provided to NamedTuple, not both")
+        if fields is _marker or fields is None:
+            warnings.warn(
+                deprecation_msg.format(name=deprecated_thing, remove="3.15"),
+                DeprecationWarning,
+                stacklevel=2,
+            )
+            fields = kwargs.items()
+        nt = _make_nmtuple(typename, fields, module=_caller())
+        nt.__orig_bases__ = (NamedTuple,)
+        return nt
+
+
+if hasattr(collections.abc, "Buffer"):
+    Buffer = collections.abc.Buffer
+else:
+    class Buffer(abc.ABC):
+        """Base class for classes that implement the buffer protocol.
+
+        The buffer protocol allows Python objects to expose a low-level
+        memory buffer interface. Before Python 3.12, it is not possible
+        to implement the buffer protocol in pure Python code, or even
+        to check whether a class implements the buffer protocol. In
+        Python 3.12 and higher, the ``__buffer__`` method allows access
+        to the buffer protocol from Python code, and the
+        ``collections.abc.Buffer`` ABC allows checking whether a class
+        implements the buffer protocol.
+
+        To indicate support for the buffer protocol in earlier versions,
+        inherit from this ABC, either in a stub file or at runtime,
+        or use ABC registration. This ABC provides no methods, because
+        there is no Python-accessible methods shared by pre-3.12 buffer
+        classes. It is useful primarily for static checks.
+
+        """
+
+    # As a courtesy, register the most common stdlib buffer classes.
+    Buffer.register(memoryview)
+    Buffer.register(bytearray)
+    Buffer.register(bytes)
+
+
+# Backport of types.get_original_bases, available on 3.12+ in CPython
+if hasattr(_types, "get_original_bases"):
+    get_original_bases = _types.get_original_bases
+else:
+    def get_original_bases(cls, /):
+        """Return the class's "original" bases prior to modification by `__mro_entries__`.
+
+        Examples::
+
+            from typing import TypeVar, Generic
+            from typing_extensions import NamedTuple, TypedDict
+
+            T = TypeVar("T")
+            class Foo(Generic[T]): ...
+            class Bar(Foo[int], float): ...
+            class Baz(list[str]): ...
+            Eggs = NamedTuple("Eggs", [("a", int), ("b", str)])
+            Spam = TypedDict("Spam", {"a": int, "b": str})
+
+            assert get_original_bases(Bar) == (Foo[int], float)
+            assert get_original_bases(Baz) == (list[str],)
+            assert get_original_bases(Eggs) == (NamedTuple,)
+            assert get_original_bases(Spam) == (TypedDict,)
+            assert get_original_bases(int) == (object,)
+        """
+        try:
+            return cls.__dict__.get("__orig_bases__", cls.__bases__)
+        except AttributeError:
+            raise TypeError(
+                f'Expected an instance of type, not {type(cls).__name__!r}'
+            ) from None
+
+
+# NewType is a class on Python 3.10+, making it pickleable
+# The error message for subclassing instances of NewType was improved on 3.11+
+if sys.version_info >= (3, 11):
+    NewType = typing.NewType
+else:
+    class NewType:
+        """NewType creates simple unique types with almost zero
+        runtime overhead. NewType(name, tp) is considered a subtype of tp
+        by static type checkers. At runtime, NewType(name, tp) returns
+        a dummy callable that simply returns its argument. Usage::
+            UserId = NewType('UserId', int)
+            def name_by_id(user_id: UserId) -> str:
+                ...
+            UserId('user')          # Fails type check
+            name_by_id(42)          # Fails type check
+            name_by_id(UserId(42))  # OK
+            num = UserId(5) + 1     # type: int
+        """
+
+        def __call__(self, obj, /):
+            return obj
+
+        def __init__(self, name, tp):
+            self.__qualname__ = name
+            if '.' in name:
+                name = name.rpartition('.')[-1]
+            self.__name__ = name
+            self.__supertype__ = tp
+            def_mod = _caller()
+            if def_mod != 'typing_extensions':
+                self.__module__ = def_mod
+
+        def __mro_entries__(self, bases):
+            # We defined __mro_entries__ to get a better error message
+            # if a user attempts to subclass a NewType instance. bpo-46170
+            supercls_name = self.__name__
+
+            class Dummy:
+                def __init_subclass__(cls):
+                    subcls_name = cls.__name__
+                    raise TypeError(
+                        f"Cannot subclass an instance of NewType. "
+                        f"Perhaps you were looking for: "
+                        f"`{subcls_name} = NewType({subcls_name!r}, {supercls_name})`"
+                    )
+
+            return (Dummy,)
+
+        def __repr__(self):
+            return f'{self.__module__}.{self.__qualname__}'
+
+        def __reduce__(self):
+            return self.__qualname__
+
+        if sys.version_info >= (3, 10):
+            # PEP 604 methods
+            # It doesn't make sense to have these methods on Python <3.10
+
+            def __or__(self, other):
+                return typing.Union[self, other]
+
+            def __ror__(self, other):
+                return typing.Union[other, self]
+
+
+if hasattr(typing, "TypeAliasType"):
+    TypeAliasType = typing.TypeAliasType
+else:
+    def _is_unionable(obj):
+        """Corresponds to is_unionable() in unionobject.c in CPython."""
+        return obj is None or isinstance(obj, (
+            type,
+            _types.GenericAlias,
+            _types.UnionType,
+            TypeAliasType,
+        ))
+
+    class TypeAliasType:
+        """Create named, parameterized type aliases.
+
+        This provides a backport of the new `type` statement in Python 3.12:
+
+            type ListOrSet[T] = list[T] | set[T]
+
+        is equivalent to:
+
+            T = TypeVar("T")
+            ListOrSet = TypeAliasType("ListOrSet", list[T] | set[T], type_params=(T,))
+
+        The name ListOrSet can then be used as an alias for the type it refers to.
+
+        The type_params argument should contain all the type parameters used
+        in the value of the type alias. If the alias is not generic, this
+        argument is omitted.
+
+        Static type checkers should only support type aliases declared using
+        TypeAliasType that follow these rules:
+
+        - The first argument (the name) must be a string literal.
+        - The TypeAliasType instance must be immediately assigned to a variable
+          of the same name. (For example, 'X = TypeAliasType("Y", int)' is invalid,
+          as is 'X, Y = TypeAliasType("X", int), TypeAliasType("Y", int)').
+
+        """
+
+        def __init__(self, name: str, value, *, type_params=()):
+            if not isinstance(name, str):
+                raise TypeError("TypeAliasType name must be a string")
+            self.__value__ = value
+            self.__type_params__ = type_params
+
+            parameters = []
+            for type_param in type_params:
+                if isinstance(type_param, TypeVarTuple):
+                    parameters.extend(type_param)
+                else:
+                    parameters.append(type_param)
+            self.__parameters__ = tuple(parameters)
+            def_mod = _caller()
+            if def_mod != 'typing_extensions':
+                self.__module__ = def_mod
+            # Setting this attribute closes the TypeAliasType from further modification
+            self.__name__ = name
+
+        def __setattr__(self, name: str, value: object, /) -> None:
+            if hasattr(self, "__name__"):
+                self._raise_attribute_error(name)
+            super().__setattr__(name, value)
+
+        def __delattr__(self, name: str, /) -> Never:
+            self._raise_attribute_error(name)
+
+        def _raise_attribute_error(self, name: str) -> Never:
+            # Match the Python 3.12 error messages exactly
+            if name == "__name__":
+                raise AttributeError("readonly attribute")
+            elif name in {"__value__", "__type_params__", "__parameters__", "__module__"}:
+                raise AttributeError(
+                    f"attribute '{name}' of 'typing.TypeAliasType' objects "
+                    "is not writable"
+                )
+            else:
+                raise AttributeError(
+                    f"'typing.TypeAliasType' object has no attribute '{name}'"
+                )
+
+        def __repr__(self) -> str:
+            return self.__name__
+
+        def __getitem__(self, parameters):
+            if not isinstance(parameters, tuple):
+                parameters = (parameters,)
+            parameters = [
+                typing._type_check(
+                    item, f'Subscripting {self.__name__} requires a type.'
+                )
+                for item in parameters
+            ]
+            return typing._GenericAlias(self, tuple(parameters))
+
+        def __reduce__(self):
+            return self.__name__
+
+        def __init_subclass__(cls, *args, **kwargs):
+            raise TypeError(
+                "type 'typing_extensions.TypeAliasType' is not an acceptable base type"
+            )
+
+        # The presence of this method convinces typing._type_check
+        # that TypeAliasTypes are types.
+        def __call__(self):
+            raise TypeError("Type alias is not callable")
+
+        if sys.version_info >= (3, 10):
+            def __or__(self, right):
+                # For forward compatibility with 3.12, reject Unions
+                # that are not accepted by the built-in Union.
+                if not _is_unionable(right):
+                    return NotImplemented
+                return typing.Union[self, right]
+
+            def __ror__(self, left):
+                if not _is_unionable(left):
+                    return NotImplemented
+                return typing.Union[left, self]
+
+
+if hasattr(typing, "is_protocol"):
+    is_protocol = typing.is_protocol
+    get_protocol_members = typing.get_protocol_members
+else:
+    def is_protocol(tp: type, /) -> bool:
+        """Return True if the given type is a Protocol.
+
+        Example::
+
+            >>> from typing_extensions import Protocol, is_protocol
+            >>> class P(Protocol):
+            ...     def a(self) -> str: ...
+            ...     b: int
+            >>> is_protocol(P)
+            True
+            >>> is_protocol(int)
+            False
+        """
+        return (
+            isinstance(tp, type)
+            and getattr(tp, '_is_protocol', False)
+            and tp is not Protocol
+            and tp is not typing.Protocol
+        )
+
+    def get_protocol_members(tp: type, /) -> typing.FrozenSet[str]:
+        """Return the set of members defined in a Protocol.
+
+        Example::
+
+            >>> from typing_extensions import Protocol, get_protocol_members
+            >>> class P(Protocol):
+            ...     def a(self) -> str: ...
+            ...     b: int
+            >>> get_protocol_members(P)
+            frozenset({'a', 'b'})
+
+        Raise a TypeError for arguments that are not Protocols.
+        """
+        if not is_protocol(tp):
+            raise TypeError(f'{tp!r} is not a Protocol')
+        if hasattr(tp, '__protocol_attrs__'):
+            return frozenset(tp.__protocol_attrs__)
+        return frozenset(_get_protocol_attrs(tp))
+
+
+if hasattr(typing, "Doc"):
+    Doc = typing.Doc
+else:
+    class Doc:
+        """Define the documentation of a type annotation using ``Annotated``, to be
+         used in class attributes, function and method parameters, return values,
+         and variables.
+
+        The value should be a positional-only string literal to allow static tools
+        like editors and documentation generators to use it.
+
+        This complements docstrings.
+
+        The string value passed is available in the attribute ``documentation``.
+
+        Example::
+
+            >>> from typing_extensions import Annotated, Doc
+            >>> def hi(to: Annotated[str, Doc("Who to say hi to")]) -> None: ...
+        """
+        def __init__(self, documentation: str, /) -> None:
+            self.documentation = documentation
+
+        def __repr__(self) -> str:
+            return f"Doc({self.documentation!r})"
+
+        def __hash__(self) -> int:
+            return hash(self.documentation)
+
+        def __eq__(self, other: object) -> bool:
+            if not isinstance(other, Doc):
+                return NotImplemented
+            return self.documentation == other.documentation
+
+
+# Aliases for items that have always been in typing.
+# Explicitly assign these (rather than using `from typing import *` at the top),
+# so that we get a CI error if one of these is deleted from typing.py
+# in a future version of Python
+AbstractSet = typing.AbstractSet
+AnyStr = typing.AnyStr
+BinaryIO = typing.BinaryIO
+Callable = typing.Callable
+Collection = typing.Collection
+Container = typing.Container
+Dict = typing.Dict
+ForwardRef = typing.ForwardRef
+FrozenSet = typing.FrozenSet
+Generator = typing.Generator
+Generic = typing.Generic
+Hashable = typing.Hashable
+IO = typing.IO
+ItemsView = typing.ItemsView
+Iterable = typing.Iterable
+Iterator = typing.Iterator
+KeysView = typing.KeysView
+List = typing.List
+Mapping = typing.Mapping
+MappingView = typing.MappingView
+Match = typing.Match
+MutableMapping = typing.MutableMapping
+MutableSequence = typing.MutableSequence
+MutableSet = typing.MutableSet
+Optional = typing.Optional
+Pattern = typing.Pattern
+Reversible = typing.Reversible
+Sequence = typing.Sequence
+Set = typing.Set
+Sized = typing.Sized
+TextIO = typing.TextIO
+Tuple = typing.Tuple
+Union = typing.Union
+ValuesView = typing.ValuesView
+cast = typing.cast
+no_type_check = typing.no_type_check
+no_type_check_decorator = typing.no_type_check_decorator
diff --git a/lib/zc/lockfile/__init__.py b/lib/zc/lockfile/__init__.py
index b541fa2d..f93917b0 100644
--- a/lib/zc/lockfile/__init__.py
+++ b/lib/zc/lockfile/__init__.py
@@ -11,18 +11,18 @@
 # FOR A PARTICULAR PURPOSE
 #
 ##############################################################################
-
-import os
-import errno
 import logging
+import os
+
+
 logger = logging.getLogger("zc.lockfile")
 
-__metaclass__ = type
 
 class LockError(Exception):
     """Couldn't get a lock
     """
 
+
 try:
     import fcntl
 except ImportError:
@@ -31,6 +31,7 @@ except ImportError:
     except ImportError:
         def _lock_file(file):
             raise TypeError('No file-locking support on this platform')
+
         def _unlock_file(file):
             raise TypeError('No file-locking support on this platform')
 
@@ -40,14 +41,14 @@ except ImportError:
             # Lock just the first byte
             try:
                 msvcrt.locking(file.fileno(), msvcrt.LK_NBLCK, 1)
-            except IOError:
+            except OSError:
                 raise LockError("Couldn't lock %r" % file.name)
 
         def _unlock_file(file):
             try:
                 file.seek(0)
                 msvcrt.locking(file.fileno(), msvcrt.LK_UNLCK, 1)
-            except IOError:
+            except OSError:
                 raise LockError("Couldn't unlock %r" % file.name)
 
 else:
@@ -57,14 +58,16 @@ else:
     def _lock_file(file):
         try:
             fcntl.flock(file.fileno(), _flags)
-        except IOError:
+        except OSError:
             raise LockError("Couldn't lock %r" % file.name)
 
     def _unlock_file(file):
         fcntl.flock(file.fileno(), fcntl.LOCK_UN)
 
+
 class LazyHostName:
     """Avoid importing socket and calling gethostname() unnecessarily"""
+
     def __str__(self):
         import socket
         return socket.gethostname()
@@ -79,7 +82,7 @@ class SimpleLockFile:
         try:
             # Try to open for writing without truncation:
             fp = open(path, 'r+')
-        except IOError:
+        except OSError:
             # If the file doesn't exist, we'll get an IO error, try a+
             # Note that there may be a race here. Multiple processes
             # could fail on the r+ open and open the file a+, but only
@@ -89,7 +92,7 @@ class SimpleLockFile:
         try:
             _lock_file(fp)
             self._fp = fp
-        except:
+        except BaseException:
             fp.close()
             raise
 
@@ -114,7 +117,7 @@ class LockFile(SimpleLockFile):
 
     def __init__(self, path, content_template='{pid}'):
         self._content_template = content_template
-        super(LockFile, self).__init__(path)
+        super().__init__(path)
 
     def _on_lock(self):
         content = self._content_template.format(
diff --git a/lib/zc/lockfile/tests.py b/lib/zc/lockfile/tests.py
index 4c890539..ae9ffca5 100644
--- a/lib/zc/lockfile/tests.py
+++ b/lib/zc/lockfile/tests.py
@@ -11,23 +11,22 @@
 # FOR A PARTICULAR PURPOSE.
 #
 ##############################################################################
-import os, re, sys, unittest, doctest
-import zc.lockfile, time, threading
-from zope.testing import renormalizing, setupstack
+import doctest
+import os
 import tempfile
-try:
-    from unittest.mock import Mock, patch
-except ImportError:
-    from mock import Mock, patch
+import threading
+import time
+import unittest
+from unittest.mock import Mock
+from unittest.mock import patch
+
+from zope.testing import setupstack
+
+import zc.lockfile
 
-checker = renormalizing.RENormalizing([
-    # Python 3 adds module path to error class name.
-    (re.compile("zc\.lockfile\.LockError:"),
-     r"LockError:"),
-    ])
 
 def inc():
-    while 1:
+    while True:
         try:
             lock = zc.lockfile.LockFile('f.lock')
         except zc.lockfile.LockError:
@@ -43,6 +42,7 @@ def inc():
     f.close()
     lock.close()
 
+
 def many_threads_read_and_write():
     r"""
     >>> with open('f', 'w+b') as file:
@@ -72,6 +72,7 @@ def many_threads_read_and_write():
 
     """
 
+
 def pid_in_lockfile():
     r"""
     >>> import os, zc.lockfile
@@ -88,7 +89,7 @@ def pid_in_lockfile():
     >>> lock = zc.lockfile.LockFile("f.lock")
     Traceback (most recent call last):
       ...
-    LockError: Couldn't lock 'f.lock'
+    zc.lockfile.LockError: Couldn't lock 'f.lock'
 
     >>> f = open("f.lock")
     >>> _ = f.seek(1)
@@ -107,7 +108,8 @@ def hostname_in_lockfile():
 
     >>> import zc.lockfile
     >>> with patch('socket.gethostname', Mock(return_value='myhostname')):
-    ...     lock = zc.lockfile.LockFile("f.lock", content_template='{hostname}')
+    ...     lock = zc.lockfile.LockFile(
+    ...         "f.lock", content_template='{hostname}')
     >>> f = open("f.lock")
     >>> _ = f.seek(1)
     >>> f.read().rstrip()
@@ -119,7 +121,7 @@ def hostname_in_lockfile():
     >>> lock = zc.lockfile.LockFile("f.lock", content_template='{hostname}')
     Traceback (most recent call last):
       ...
-    LockError: Couldn't lock 'f.lock'
+    zc.lockfile.LockError: Couldn't lock 'f.lock'
 
     >>> f = open("f.lock")
     >>> _ = f.seek(1)
@@ -131,7 +133,7 @@ def hostname_in_lockfile():
     """
 
 
-class TestLogger(object):
+class TestLogger:
     def __init__(self):
         self.log_entries = []
 
@@ -141,6 +143,7 @@ class TestLogger(object):
 
 class LockFileLogEntryTestCase(unittest.TestCase):
     """Tests for logging in case of lock failure"""
+
     def setUp(self):
         self.here = os.getcwd()
         self.tmp = tempfile.mkdtemp(prefix='zc.lockfile-test-')
@@ -154,8 +157,8 @@ class LockFileLogEntryTestCase(unittest.TestCase):
         # PID and hostname are parsed and logged from lock file on failure
         with patch('os.getpid', Mock(return_value=123)):
             with patch('socket.gethostname', Mock(return_value='myhostname')):
-                lock = zc.lockfile.LockFile('f.lock',
-                                            content_template='{pid}/{hostname}')
+                lock = zc.lockfile.LockFile(
+                    'f.lock', content_template='{pid}/{hostname}')
                 with open('f.lock') as f:
                     self.assertEqual(' 123/myhostname\n', f.read())
 
@@ -191,11 +194,10 @@ class LockFileLogEntryTestCase(unittest.TestCase):
 def test_suite():
     suite = unittest.TestSuite()
     suite.addTest(doctest.DocFileSuite(
-        'README.txt', checker=checker,
+        'README.txt',
         setUp=setupstack.setUpDirectory, tearDown=setupstack.tearDown))
     suite.addTest(doctest.DocTestSuite(
-        setUp=setupstack.setUpDirectory, tearDown=setupstack.tearDown,
-        checker=checker))
+        setUp=setupstack.setUpDirectory, tearDown=setupstack.tearDown))
     # Add unittest test cases from this module
     suite.addTest(unittest.defaultTestLoader.loadTestsFromName(__name__))
     return suite

From 75a1750a4e1882efc2f0a2fcc3843006e20c3e3b Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 26 Mar 2024 15:10:51 -0700
Subject: [PATCH 556/743] Bump cherrypy from 18.8.0 to 18.9.0 (#2289)

Bumps [cherrypy](https://github.com/cherrypy/cherrypy) from 18.8.0 to 18.9.0.
- [Changelog](https://github.com/cherrypy/cherrypy/blob/main/CHANGES.rst)
- [Commits](https://github.com/cherrypy/cherrypy/compare/v18.8.0...v18.9.0)

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

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements.txt b/requirements.txt
index dea2b2a3..baf358c5 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -8,7 +8,7 @@ bleach==6.1.0
 certifi==2024.2.2
 cheroot==10.0.0
 cloudinary==1.39.1
-cherrypy==18.8.0
+cherrypy==18.9.0
 distro==1.9.0
 dnspython==2.6.1
 facebook-sdk==3.1.0

From f82aecb88ce3f3df4dba6b3e5173cb8b269a858d Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 30 Mar 2024 15:27:16 -0700
Subject: [PATCH 557/743] Bump paho-mqtt from 1.6.1 to 2.0.0 (#2288)

* Bump paho-mqtt from 1.6.1 to 2.0.0

Bumps [paho-mqtt](https://github.com/eclipse/paho.mqtt.python) from 1.6.1 to 2.0.0.
- [Release notes](https://github.com/eclipse/paho.mqtt.python/releases)
- [Changelog](https://github.com/eclipse/paho.mqtt.python/blob/master/ChangeLog.txt)
- [Commits](https://github.com/eclipse/paho.mqtt.python/compare/v1.6.1...v2.0.0)

---
updated-dependencies:
- dependency-name: paho-mqtt
  dependency-type: direct:production
  update-type: version-update:semver-major
...

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

* Update paho-mqtt==2.0.0

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/paho/mqtt/__init__.py         |    2 +-
 lib/paho/mqtt/client.py           | 3454 +++++++++++++++++++----------
 lib/paho/mqtt/enums.py            |  113 +
 lib/paho/mqtt/matcher.py          |   12 +-
 lib/paho/mqtt/packettypes.py      |    6 +-
 lib/paho/mqtt/properties.py       |   87 +-
 lib/paho/mqtt/publish.py          |  177 +-
 lib/paho/mqtt/py.typed            |    0
 lib/paho/mqtt/reasoncodes.py      |   93 +-
 lib/paho/mqtt/subscribe.py        |   97 +-
 lib/paho/mqtt/subscribeoptions.py |   43 +-
 requirements.txt                  |    2 +-
 12 files changed, 2643 insertions(+), 1443 deletions(-)
 create mode 100644 lib/paho/mqtt/enums.py
 create mode 100644 lib/paho/mqtt/py.typed

diff --git a/lib/paho/mqtt/__init__.py b/lib/paho/mqtt/__init__.py
index 0d349fc3..19b6a4ab 100644
--- a/lib/paho/mqtt/__init__.py
+++ b/lib/paho/mqtt/__init__.py
@@ -1,4 +1,4 @@
-__version__ = "1.6.1"
+__version__ = "2.0.0"
 
 
 class MQTTException(Exception):
diff --git a/lib/paho/mqtt/client.py b/lib/paho/mqtt/client.py
index 1c0236e4..f5897328 100644
--- a/lib/paho/mqtt/client.py
+++ b/lib/paho/mqtt/client.py
@@ -5,61 +5,105 @@
 # and Eclipse Distribution License v1.0 which accompany this distribution.
 #
 # The Eclipse Public License is available at
-#    http://www.eclipse.org/legal/epl-v10.html
+#    http://www.eclipse.org/legal/epl-v20.html
 # and the Eclipse Distribution License is available at
 #   http://www.eclipse.org/org/documents/edl-v10.php.
 #
 # Contributors:
 #    Roger Light - initial API and implementation
 #    Ian Craggs - MQTT V5 support
-
-import base64
-import hashlib
-import logging
-import string
-import struct
-import sys
-import threading
-import time
-import uuid
-
-from .matcher import MQTTMatcher
-from .properties import Properties
-from .reasoncodes import ReasonCodes
-from .subscribeoptions import SubscribeOptions
-
 """
 This is an MQTT client module. MQTT is a lightweight pub/sub messaging
 protocol that is easy to implement and suitable for low powered devices.
 """
+from __future__ import annotations
+
+import base64
 import collections
 import errno
+import hashlib
+import logging
 import os
 import platform
 import select
 import socket
+import string
+import struct
+import threading
+import time
+import urllib.parse
+import urllib.request
+import uuid
+import warnings
+from typing import TYPE_CHECKING, Any, Callable, Dict, Iterator, List, NamedTuple, Sequence, Tuple, Union, cast
+
+from paho.mqtt.packettypes import PacketTypes
+
+from .enums import CallbackAPIVersion, ConnackCode, LogLevel, MessageState, MessageType, MQTTErrorCode, MQTTProtocolVersion, PahoClientMode, _ConnectionState
+from .matcher import MQTTMatcher
+from .properties import Properties
+from .reasoncodes import ReasonCode, ReasonCodes
+from .subscribeoptions import SubscribeOptions
+
+try:
+    from typing import Literal
+except ImportError:
+    from typing_extensions import Literal  # type: ignore
+
+if TYPE_CHECKING:
+    try:
+        from typing import TypedDict  # type: ignore
+    except ImportError:
+        from typing_extensions import TypedDict
+
+    try:
+        from typing import Protocol  # type: ignore
+    except ImportError:
+        from typing_extensions import Protocol  # type: ignore
+
+    class _InPacket(TypedDict):
+        command: int
+        have_remaining: int
+        remaining_count: list[int]
+        remaining_mult: int
+        remaining_length: int
+        packet: bytearray
+        to_process: int
+        pos: int
+
+
+    class _OutPacket(TypedDict):
+        command: int
+        mid: int
+        qos: int
+        pos: int
+        to_process: int
+        packet: bytes
+        info: MQTTMessageInfo | None
+
+    class SocketLike(Protocol):
+        def recv(self, buffer_size: int) -> bytes:
+            ...
+        def send(self, buffer: bytes) -> int:
+            ...
+        def close(self) -> None:
+            ...
+        def fileno(self) -> int:
+            ...
+        def setblocking(self, flag: bool) -> None:
+            ...
+
 
-ssl = None
 try:
     import ssl
 except ImportError:
-    pass
+    ssl = None  # type: ignore[assignment]
 
-socks = None
-try:
-    import socks
-except ImportError:
-    pass
 
 try:
-    # Python 3
-    from urllib import parse as urllib_dot_parse
-    from urllib import request as urllib_dot_request
+    import socks  # type: ignore[import-untyped]
 except ImportError:
-    # Python 2
-    import urllib as urllib_dot_request
-
-    import urlparse as urllib_dot_parse
+    socks = None  # type: ignore[assignment]
 
 
 try:
@@ -70,123 +114,181 @@ except AttributeError:
 
 try:
     import dns.resolver
+
+    HAVE_DNS = True
 except ImportError:
     HAVE_DNS = False
-else:
-    HAVE_DNS = True
 
 
 if platform.system() == 'Windows':
-    EAGAIN = errno.WSAEWOULDBLOCK
+    EAGAIN = errno.WSAEWOULDBLOCK  # type: ignore[attr-defined]
 else:
     EAGAIN = errno.EAGAIN
 
-# Python 2.7 does not have BlockingIOError.  Fall back to IOError
-try:
-    BlockingIOError
-except NameError:
-    BlockingIOError  = IOError
+# Avoid linter complain. We kept importing it as ReasonCodes (plural) for compatibility
+_ = ReasonCodes
 
-MQTTv31 = 3
-MQTTv311 = 4
-MQTTv5 = 5
-
-if sys.version_info[0] >= 3:
-    # define some alias for python2 compatibility
-    unicode = str
-    basestring = str
-
-# Message types
-CONNECT = 0x10
-CONNACK = 0x20
-PUBLISH = 0x30
-PUBACK = 0x40
-PUBREC = 0x50
-PUBREL = 0x60
-PUBCOMP = 0x70
-SUBSCRIBE = 0x80
-SUBACK = 0x90
-UNSUBSCRIBE = 0xA0
-UNSUBACK = 0xB0
-PINGREQ = 0xC0
-PINGRESP = 0xD0
-DISCONNECT = 0xE0
-AUTH = 0xF0
+# Keep copy of enums values for compatibility.
+CONNECT = MessageType.CONNECT
+CONNACK = MessageType.CONNACK
+PUBLISH = MessageType.PUBLISH
+PUBACK = MessageType.PUBACK
+PUBREC = MessageType.PUBREC
+PUBREL = MessageType.PUBREL
+PUBCOMP = MessageType.PUBCOMP
+SUBSCRIBE = MessageType.SUBSCRIBE
+SUBACK = MessageType.SUBACK
+UNSUBSCRIBE = MessageType.UNSUBSCRIBE
+UNSUBACK = MessageType.UNSUBACK
+PINGREQ = MessageType.PINGREQ
+PINGRESP = MessageType.PINGRESP
+DISCONNECT = MessageType.DISCONNECT
+AUTH = MessageType.AUTH
 
 # Log levels
-MQTT_LOG_INFO = 0x01
-MQTT_LOG_NOTICE = 0x02
-MQTT_LOG_WARNING = 0x04
-MQTT_LOG_ERR = 0x08
-MQTT_LOG_DEBUG = 0x10
+MQTT_LOG_INFO = LogLevel.MQTT_LOG_INFO
+MQTT_LOG_NOTICE = LogLevel.MQTT_LOG_NOTICE
+MQTT_LOG_WARNING = LogLevel.MQTT_LOG_WARNING
+MQTT_LOG_ERR = LogLevel.MQTT_LOG_ERR
+MQTT_LOG_DEBUG = LogLevel.MQTT_LOG_DEBUG
 LOGGING_LEVEL = {
-    MQTT_LOG_DEBUG: logging.DEBUG,
-    MQTT_LOG_INFO: logging.INFO,
-    MQTT_LOG_NOTICE: logging.INFO,  # This has no direct equivalent level
-    MQTT_LOG_WARNING: logging.WARNING,
-    MQTT_LOG_ERR: logging.ERROR,
+    LogLevel.MQTT_LOG_DEBUG: logging.DEBUG,
+    LogLevel.MQTT_LOG_INFO: logging.INFO,
+    LogLevel.MQTT_LOG_NOTICE: logging.INFO,  # This has no direct equivalent level
+    LogLevel.MQTT_LOG_WARNING: logging.WARNING,
+    LogLevel.MQTT_LOG_ERR: logging.ERROR,
 }
 
 # CONNACK codes
-CONNACK_ACCEPTED = 0
-CONNACK_REFUSED_PROTOCOL_VERSION = 1
-CONNACK_REFUSED_IDENTIFIER_REJECTED = 2
-CONNACK_REFUSED_SERVER_UNAVAILABLE = 3
-CONNACK_REFUSED_BAD_USERNAME_PASSWORD = 4
-CONNACK_REFUSED_NOT_AUTHORIZED = 5
-
-# Connection state
-mqtt_cs_new = 0
-mqtt_cs_connected = 1
-mqtt_cs_disconnecting = 2
-mqtt_cs_connect_async = 3
+CONNACK_ACCEPTED = ConnackCode.CONNACK_ACCEPTED
+CONNACK_REFUSED_PROTOCOL_VERSION = ConnackCode.CONNACK_REFUSED_PROTOCOL_VERSION
+CONNACK_REFUSED_IDENTIFIER_REJECTED = ConnackCode.CONNACK_REFUSED_IDENTIFIER_REJECTED
+CONNACK_REFUSED_SERVER_UNAVAILABLE = ConnackCode.CONNACK_REFUSED_SERVER_UNAVAILABLE
+CONNACK_REFUSED_BAD_USERNAME_PASSWORD = ConnackCode.CONNACK_REFUSED_BAD_USERNAME_PASSWORD
+CONNACK_REFUSED_NOT_AUTHORIZED = ConnackCode.CONNACK_REFUSED_NOT_AUTHORIZED
 
 # Message state
-mqtt_ms_invalid = 0
-mqtt_ms_publish = 1
-mqtt_ms_wait_for_puback = 2
-mqtt_ms_wait_for_pubrec = 3
-mqtt_ms_resend_pubrel = 4
-mqtt_ms_wait_for_pubrel = 5
-mqtt_ms_resend_pubcomp = 6
-mqtt_ms_wait_for_pubcomp = 7
-mqtt_ms_send_pubrec = 8
-mqtt_ms_queued = 9
+mqtt_ms_invalid = MessageState.MQTT_MS_INVALID
+mqtt_ms_publish = MessageState.MQTT_MS_PUBLISH
+mqtt_ms_wait_for_puback = MessageState.MQTT_MS_WAIT_FOR_PUBACK
+mqtt_ms_wait_for_pubrec = MessageState.MQTT_MS_WAIT_FOR_PUBREC
+mqtt_ms_resend_pubrel = MessageState.MQTT_MS_RESEND_PUBREL
+mqtt_ms_wait_for_pubrel = MessageState.MQTT_MS_WAIT_FOR_PUBREL
+mqtt_ms_resend_pubcomp = MessageState.MQTT_MS_RESEND_PUBCOMP
+mqtt_ms_wait_for_pubcomp = MessageState.MQTT_MS_WAIT_FOR_PUBCOMP
+mqtt_ms_send_pubrec = MessageState.MQTT_MS_SEND_PUBREC
+mqtt_ms_queued = MessageState.MQTT_MS_QUEUED
 
-# Error values
-MQTT_ERR_AGAIN = -1
-MQTT_ERR_SUCCESS = 0
-MQTT_ERR_NOMEM = 1
-MQTT_ERR_PROTOCOL = 2
-MQTT_ERR_INVAL = 3
-MQTT_ERR_NO_CONN = 4
-MQTT_ERR_CONN_REFUSED = 5
-MQTT_ERR_NOT_FOUND = 6
-MQTT_ERR_CONN_LOST = 7
-MQTT_ERR_TLS = 8
-MQTT_ERR_PAYLOAD_SIZE = 9
-MQTT_ERR_NOT_SUPPORTED = 10
-MQTT_ERR_AUTH = 11
-MQTT_ERR_ACL_DENIED = 12
-MQTT_ERR_UNKNOWN = 13
-MQTT_ERR_ERRNO = 14
-MQTT_ERR_QUEUE_SIZE = 15
-MQTT_ERR_KEEPALIVE = 16
+MQTT_ERR_AGAIN = MQTTErrorCode.MQTT_ERR_AGAIN
+MQTT_ERR_SUCCESS = MQTTErrorCode.MQTT_ERR_SUCCESS
+MQTT_ERR_NOMEM = MQTTErrorCode.MQTT_ERR_NOMEM
+MQTT_ERR_PROTOCOL = MQTTErrorCode.MQTT_ERR_PROTOCOL
+MQTT_ERR_INVAL = MQTTErrorCode.MQTT_ERR_INVAL
+MQTT_ERR_NO_CONN = MQTTErrorCode.MQTT_ERR_NO_CONN
+MQTT_ERR_CONN_REFUSED = MQTTErrorCode.MQTT_ERR_CONN_REFUSED
+MQTT_ERR_NOT_FOUND = MQTTErrorCode.MQTT_ERR_NOT_FOUND
+MQTT_ERR_CONN_LOST = MQTTErrorCode.MQTT_ERR_CONN_LOST
+MQTT_ERR_TLS = MQTTErrorCode.MQTT_ERR_TLS
+MQTT_ERR_PAYLOAD_SIZE = MQTTErrorCode.MQTT_ERR_PAYLOAD_SIZE
+MQTT_ERR_NOT_SUPPORTED = MQTTErrorCode.MQTT_ERR_NOT_SUPPORTED
+MQTT_ERR_AUTH = MQTTErrorCode.MQTT_ERR_AUTH
+MQTT_ERR_ACL_DENIED = MQTTErrorCode.MQTT_ERR_ACL_DENIED
+MQTT_ERR_UNKNOWN = MQTTErrorCode.MQTT_ERR_UNKNOWN
+MQTT_ERR_ERRNO = MQTTErrorCode.MQTT_ERR_ERRNO
+MQTT_ERR_QUEUE_SIZE = MQTTErrorCode.MQTT_ERR_QUEUE_SIZE
+MQTT_ERR_KEEPALIVE = MQTTErrorCode.MQTT_ERR_KEEPALIVE
 
-MQTT_CLIENT = 0
-MQTT_BRIDGE = 1
+MQTTv31 = MQTTProtocolVersion.MQTTv31
+MQTTv311 = MQTTProtocolVersion.MQTTv311
+MQTTv5 = MQTTProtocolVersion.MQTTv5
+
+MQTT_CLIENT = PahoClientMode.MQTT_CLIENT
+MQTT_BRIDGE = PahoClientMode.MQTT_BRIDGE
 
 # For MQTT V5, use the clean start flag only on the first successful connect
-MQTT_CLEAN_START_FIRST_ONLY = 3
+MQTT_CLEAN_START_FIRST_ONLY: CleanStartOption = 3
 
 sockpair_data = b"0"
 
+# Payload support all those type and will be converted to bytes:
+# * str are utf8 encoded
+# * int/float are converted to string and utf8 encoded (e.g. 1 is converted to b"1")
+# * None is converted to a zero-length payload (i.e. b"")
+PayloadType = Union[str, bytes, bytearray, int, float, None]
 
-class WebsocketConnectionError(ValueError):
+HTTPHeader = Dict[str, str]
+WebSocketHeaders = Union[Callable[[HTTPHeader], HTTPHeader], HTTPHeader]
+
+CleanStartOption = Union[bool, Literal[3]]
+
+
+class ConnectFlags(NamedTuple):
+    """Contains additional information passed to `on_connect` callback"""
+
+    session_present: bool
+    """
+    this flag is useful for clients that are
+    using clean session set to False only (MQTTv3) or clean_start = False (MQTTv5).
+    In that case, if client  that reconnects to a broker that it has previously
+    connected to, this flag indicates whether the broker still has the
+    session information for the client. If true, the session still exists.
+    """
+
+
+class DisconnectFlags(NamedTuple):
+    """Contains additional information passed to `on_disconnect` callback"""
+
+    is_disconnect_packet_from_server: bool
+    """
+    tells whether this on_disconnect call is the result
+    of receiving an DISCONNECT packet from the broker or if the on_disconnect is only
+    generated by the client library.
+    When true, the reason code is generated by the broker.
+    """
+
+
+CallbackOnConnect_v1_mqtt3 = Callable[["Client", Any, Dict[str, Any], MQTTErrorCode], None]
+CallbackOnConnect_v1_mqtt5 = Callable[["Client", Any, Dict[str, Any], ReasonCode, Union[Properties, None]], None]
+CallbackOnConnect_v1 = Union[CallbackOnConnect_v1_mqtt5, CallbackOnConnect_v1_mqtt3]
+CallbackOnConnect_v2 = Callable[["Client", Any, ConnectFlags, ReasonCode, Union[Properties, None]], None]
+CallbackOnConnect = Union[CallbackOnConnect_v1, CallbackOnConnect_v2]
+CallbackOnConnectFail = Callable[["Client", Any], None]
+CallbackOnDisconnect_v1_mqtt3 = Callable[["Client", Any, MQTTErrorCode], None]
+CallbackOnDisconnect_v1_mqtt5 = Callable[["Client", Any, Union[ReasonCode, int, None], Union[Properties, None]], None]
+CallbackOnDisconnect_v1 = Union[CallbackOnDisconnect_v1_mqtt3, CallbackOnDisconnect_v1_mqtt5]
+CallbackOnDisconnect_v2 = Callable[["Client", Any, DisconnectFlags, ReasonCode, Union[Properties, None]], None]
+CallbackOnDisconnect = Union[CallbackOnDisconnect_v1, CallbackOnDisconnect_v2]
+CallbackOnLog = Callable[["Client", Any, int, str], None]
+CallbackOnMessage = Callable[["Client", Any, "MQTTMessage"], None]
+CallbackOnPreConnect = Callable[["Client", Any], None]
+CallbackOnPublish_v1 = Callable[["Client", Any, int], None]
+CallbackOnPublish_v2 = Callable[["Client", Any, int, ReasonCode, Properties], None]
+CallbackOnPublish = Union[CallbackOnPublish_v1, CallbackOnPublish_v2]
+CallbackOnSocket = Callable[["Client", Any, "SocketLike"], None]
+CallbackOnSubscribe_v1_mqtt3 = Callable[["Client", Any, int, Tuple[int, ...]], None]
+CallbackOnSubscribe_v1_mqtt5 = Callable[["Client", Any, int, List[ReasonCode], Properties], None]
+CallbackOnSubscribe_v1 = Union[CallbackOnSubscribe_v1_mqtt3, CallbackOnSubscribe_v1_mqtt5]
+CallbackOnSubscribe_v2 = Callable[["Client", Any, int, List[ReasonCode], Union[Properties, None]], None]
+CallbackOnSubscribe = Union[CallbackOnSubscribe_v1, CallbackOnSubscribe_v2]
+CallbackOnUnsubscribe_v1_mqtt3 = Callable[["Client", Any, int], None]
+CallbackOnUnsubscribe_v1_mqtt5 = Callable[["Client", Any, int, Properties, Union[ReasonCode, List[ReasonCode]]], None]
+CallbackOnUnsubscribe_v1 = Union[CallbackOnUnsubscribe_v1_mqtt3, CallbackOnUnsubscribe_v1_mqtt5]
+CallbackOnUnsubscribe_v2 = Callable[["Client", Any, int, List[ReasonCode], Union[Properties, None]], None]
+CallbackOnUnsubscribe = Union[CallbackOnUnsubscribe_v1, CallbackOnUnsubscribe_v2]
+
+# This is needed for typing because class Client redefined the name "socket"
+_socket = socket
+
+
+class WebsocketConnectionError(ConnectionError):
+    """ WebsocketConnectionError is a subclass of ConnectionError.
+
+        It's raised when unable to perform the Websocket handshake.
+    """
     pass
 
 
-def error_string(mqtt_errno):
+def error_string(mqtt_errno: MQTTErrorCode) -> str:
     """Return the error string associated with an mqtt error number."""
     if mqtt_errno == MQTT_ERR_SUCCESS:
         return "No error."
@@ -226,8 +328,11 @@ def error_string(mqtt_errno):
         return "Unknown error."
 
 
-def connack_string(connack_code):
-    """Return the string associated with a CONNACK result."""
+def connack_string(connack_code: int|ReasonCode) -> str:
+    """Return the string associated with a CONNACK result or CONNACK reason code."""
+    if isinstance(connack_code, ReasonCode):
+        return str(connack_code)
+
     if connack_code == CONNACK_ACCEPTED:
         return "Connection Accepted."
     elif connack_code == CONNACK_REFUSED_PROTOCOL_VERSION:
@@ -244,9 +349,69 @@ def connack_string(connack_code):
         return "Connection Refused: unknown reason."
 
 
-def base62(num, base=string.digits + string.ascii_letters, padding=1):
+def convert_connack_rc_to_reason_code(connack_code: ConnackCode) -> ReasonCode:
+    """Convert a MQTTv3 / MQTTv3.1.1 connack result to `ReasonCode`.
+
+    This is used in `on_connect` callback to have a consistent API.
+
+    Be careful that the numeric value isn't the same, for example:
+
+    >>> ConnackCode.CONNACK_REFUSED_SERVER_UNAVAILABLE == 3
+    >>> convert_connack_rc_to_reason_code(ConnackCode.CONNACK_REFUSED_SERVER_UNAVAILABLE) == 136
+
+    It's recommended to compare by names
+
+    >>> code_to_test = ReasonCode(PacketTypes.CONNACK, "Server unavailable")
+    >>> convert_connack_rc_to_reason_code(ConnackCode.CONNACK_REFUSED_SERVER_UNAVAILABLE) == code_to_test
+    """
+    if connack_code == ConnackCode.CONNACK_ACCEPTED:
+        return ReasonCode(PacketTypes.CONNACK, "Success")
+    if connack_code == ConnackCode.CONNACK_REFUSED_PROTOCOL_VERSION:
+        return ReasonCode(PacketTypes.CONNACK, "Unsupported protocol version")
+    if connack_code == ConnackCode.CONNACK_REFUSED_IDENTIFIER_REJECTED:
+        return ReasonCode(PacketTypes.CONNACK, "Client identifier not valid")
+    if connack_code == ConnackCode.CONNACK_REFUSED_SERVER_UNAVAILABLE:
+        return ReasonCode(PacketTypes.CONNACK, "Server unavailable")
+    if connack_code == ConnackCode.CONNACK_REFUSED_BAD_USERNAME_PASSWORD:
+        return ReasonCode(PacketTypes.CONNACK, "Bad user name or password")
+    if connack_code == ConnackCode.CONNACK_REFUSED_NOT_AUTHORIZED:
+        return ReasonCode(PacketTypes.CONNACK, "Not authorized")
+
+    return ReasonCode(PacketTypes.CONNACK, "Unspecified error")
+
+
+def convert_disconnect_error_code_to_reason_code(rc: MQTTErrorCode) -> ReasonCode:
+    """Convert an MQTTErrorCode to Reason code.
+
+    This is used in `on_disconnect` callback to have a consistent API.
+
+    Be careful that the numeric value isn't the same, for example:
+
+    >>> MQTTErrorCode.MQTT_ERR_PROTOCOL == 2
+    >>> convert_disconnect_error_code_to_reason_code(MQTTErrorCode.MQTT_ERR_PROTOCOL) == 130
+
+    It's recommended to compare by names
+
+    >>> code_to_test = ReasonCode(PacketTypes.DISCONNECT, "Protocol error")
+    >>> convert_disconnect_error_code_to_reason_code(MQTTErrorCode.MQTT_ERR_PROTOCOL) == code_to_test
+    """
+    if rc == MQTTErrorCode.MQTT_ERR_SUCCESS:
+        return ReasonCode(PacketTypes.DISCONNECT, "Success")
+    if rc == MQTTErrorCode.MQTT_ERR_KEEPALIVE:
+        return ReasonCode(PacketTypes.DISCONNECT, "Keep alive timeout")
+    if rc == MQTTErrorCode.MQTT_ERR_CONN_LOST:
+        return ReasonCode(PacketTypes.DISCONNECT, "Unspecified error")
+    return ReasonCode(PacketTypes.DISCONNECT, "Unspecified error")
+
+
+def _base62(
+    num: int,
+    base: str = string.digits + string.ascii_letters,
+    padding: int = 1,
+) -> str:
     """Convert a number to base-62 representation."""
-    assert num >= 0
+    if num < 0:
+        raise ValueError("Number must be positive or zero")
     digits = []
     while num:
         num, rest = divmod(num, 62)
@@ -255,13 +420,13 @@ def base62(num, base=string.digits + string.ascii_letters, padding=1):
     return ''.join(reversed(digits))
 
 
-def topic_matches_sub(sub, topic):
+def topic_matches_sub(sub: str, topic: str) -> bool:
     """Check whether a topic matches a subscription.
 
     For example:
 
-    foo/bar would match the subscription foo/# or +/bar
-    non/matching would not match the subscription non/+/+
+    * Topic "foo/bar" would match the subscription "foo/#" or "+/bar"
+    * Topic "non/matching" would not match the subscription "non/+/+"
     """
     matcher = MQTTMatcher()
     matcher[sub] = True
@@ -272,7 +437,7 @@ def topic_matches_sub(sub, topic):
         return False
 
 
-def _socketpair_compat():
+def _socketpair_compat() -> tuple[socket.socket, socket.socket]:
     """TCP/IP socketpair including Windows support"""
     listensock = socket.socket(
         socket.AF_INET, socket.SOCK_STREAM, socket.IPPROTO_IP)
@@ -283,43 +448,70 @@ def _socketpair_compat():
     iface, port = listensock.getsockname()
     sock1 = socket.socket(
         socket.AF_INET, socket.SOCK_STREAM, socket.IPPROTO_IP)
-    sock1.setblocking(0)
+    sock1.setblocking(False)
     try:
         sock1.connect(("127.0.0.1", port))
     except BlockingIOError:
         pass
     sock2, address = listensock.accept()
-    sock2.setblocking(0)
+    sock2.setblocking(False)
     listensock.close()
     return (sock1, sock2)
 
 
-class MQTTMessageInfo(object):
-    """This is a class returned from Client.publish() and can be used to find
+def _force_bytes(s: str | bytes) -> bytes:
+    if isinstance(s, str):
+        return s.encode("utf-8")
+    return s
+
+
+def _encode_payload(payload: str | bytes | bytearray | int | float | None) -> bytes:
+    if isinstance(payload, str):
+        return payload.encode("utf-8")
+
+    if isinstance(payload, (int, float)):
+        return str(payload).encode("ascii")
+
+    if payload is None:
+        return b""
+
+    if not isinstance(payload, (bytes, bytearray)):
+        raise TypeError(
+            "payload must be a string, bytearray, int, float or None."
+        )
+
+    return payload
+
+
+class MQTTMessageInfo:
+    """This is a class returned from `Client.publish()` and can be used to find
     out the mid of the message that was published, and to determine whether the
     message has been published, and/or wait until it is published.
     """
 
     __slots__ = 'mid', '_published', '_condition', 'rc', '_iterpos'
 
-    def __init__(self, mid):
+    def __init__(self, mid: int):
         self.mid = mid
+        """ The message Id (int)"""
         self._published = False
         self._condition = threading.Condition()
-        self.rc = 0
+        self.rc: MQTTErrorCode = MQTTErrorCode.MQTT_ERR_SUCCESS
+        """ The `MQTTErrorCode` that give status for this message.
+        This value could change until the message `is_published`"""
         self._iterpos = 0
 
-    def __str__(self):
+    def __str__(self) -> str:
         return str((self.rc, self.mid))
 
-    def __iter__(self):
+    def __iter__(self) -> Iterator[MQTTErrorCode | int]:
         self._iterpos = 0
         return self
 
-    def __next__(self):
+    def __next__(self) -> MQTTErrorCode | int:
         return self.next()
 
-    def next(self):
+    def next(self) -> MQTTErrorCode | int:
         if self._iterpos == 0:
             self._iterpos = 1
             return self.rc
@@ -329,7 +521,7 @@ class MQTTMessageInfo(object):
         else:
             raise StopIteration
 
-    def __getitem__(self, index):
+    def __getitem__(self, index: int) -> MQTTErrorCode | int:
         if index == 0:
             return self.rc
         elif index == 1:
@@ -337,162 +529,129 @@ class MQTTMessageInfo(object):
         else:
             raise IndexError("index out of range")
 
-    def _set_as_published(self):
+    def _set_as_published(self) -> None:
         with self._condition:
             self._published = True
             self._condition.notify()
 
-    def wait_for_publish(self, timeout=None):
+    def wait_for_publish(self, timeout: float | None = None) -> None:
         """Block until the message associated with this object is published, or
         until the timeout occurs. If timeout is None, this will never time out.
         Set timeout to a positive number of seconds, e.g. 1.2, to enable the
         timeout.
 
-        Raises ValueError if the message was not queued due to the outgoing
-        queue being full.
+        :raises ValueError: if the message was not queued due to the outgoing
+            queue being full.
 
-        Raises RuntimeError if the message was not published for another
-        reason.
+        :raises RuntimeError: if the message was not published for another
+            reason.
         """
         if self.rc == MQTT_ERR_QUEUE_SIZE:
             raise ValueError('Message is not queued due to ERR_QUEUE_SIZE')
         elif self.rc == MQTT_ERR_AGAIN:
             pass
         elif self.rc > 0:
-            raise RuntimeError('Message publish failed: %s' % (error_string(self.rc)))
+            raise RuntimeError(f'Message publish failed: {error_string(self.rc)}')
 
-        timeout_time = None if timeout is None else time.time() + timeout
+        timeout_time = None if timeout is None else time_func() + timeout
         timeout_tenth = None if timeout is None else timeout / 10.
-        def timed_out():
-            return False if timeout is None else time.time() > timeout_time
+        def timed_out() -> bool:
+            return False if timeout_time is None else time_func() > timeout_time
 
         with self._condition:
             while not self._published and not timed_out():
                 self._condition.wait(timeout_tenth)
 
-    def is_published(self):
+        if self.rc > 0:
+            raise RuntimeError(f'Message publish failed: {error_string(self.rc)}')
+
+    def is_published(self) -> bool:
         """Returns True if the message associated with this object has been
-        published, else returns False."""
-        if self.rc == MQTT_ERR_QUEUE_SIZE:
+        published, else returns False.
+
+        To wait for this to become true, look at `wait_for_publish`.
+        """
+        if self.rc == MQTTErrorCode.MQTT_ERR_QUEUE_SIZE:
             raise ValueError('Message is not queued due to ERR_QUEUE_SIZE')
-        elif self.rc == MQTT_ERR_AGAIN:
+        elif self.rc == MQTTErrorCode.MQTT_ERR_AGAIN:
             pass
         elif self.rc > 0:
-            raise RuntimeError('Message publish failed: %s' % (error_string(self.rc)))
+            raise RuntimeError(f'Message publish failed: {error_string(self.rc)}')
 
         with self._condition:
             return self._published
 
 
-class MQTTMessage(object):
-    """ This is a class that describes an incoming or outgoing message. It is
-    passed to the on_message callback as the message parameter.
-
-    Members:
-
-    topic : String. topic that the message was published on.
-    payload : Bytes/Byte array. the message payload.
-    qos : Integer. The message Quality of Service 0, 1 or 2.
-    retain : Boolean. If true, the message is a retained message and not fresh.
-    mid : Integer. The message id.
-    properties: Properties class. In MQTT v5.0, the properties associated with the message.
+class MQTTMessage:
+    """ This is a class that describes an incoming message. It is
+    passed to the `on_message` callback as the message parameter.
     """
-
     __slots__ = 'timestamp', 'state', 'dup', 'mid', '_topic', 'payload', 'qos', 'retain', 'info', 'properties'
 
-    def __init__(self, mid=0, topic=b""):
-        self.timestamp = 0
+    def __init__(self, mid: int = 0, topic: bytes = b""):
+        self.timestamp = 0.0
         self.state = mqtt_ms_invalid
         self.dup = False
         self.mid = mid
+        """ The message id (int)."""
         self._topic = topic
         self.payload = b""
+        """the message payload (bytes)"""
         self.qos = 0
+        """ The message Quality of Service (0, 1 or 2)."""
         self.retain = False
+        """ If true, the message is a retained message and not fresh."""
         self.info = MQTTMessageInfo(mid)
+        self.properties: Properties | None = None
+        """ In MQTT v5.0, the properties associated with the message. (`Properties`)"""
 
-    def __eq__(self, other):
+    def __eq__(self, other: object) -> bool:
         """Override the default Equals behavior"""
         if isinstance(other, self.__class__):
             return self.mid == other.mid
         return False
 
-    def __ne__(self, other):
+    def __ne__(self, other: object) -> bool:
         """Define a non-equality test"""
         return not self.__eq__(other)
 
     @property
-    def topic(self):
+    def topic(self) -> str:
+        """topic that the message was published on.
+
+        This property is read-only.
+        """
         return self._topic.decode('utf-8')
 
     @topic.setter
-    def topic(self, value):
+    def topic(self, value: bytes) -> None:
         self._topic = value
 
 
-class Client(object):
+class Client:
     """MQTT version 3.1/3.1.1/5.0 client class.
 
     This is the main class for use communicating with an MQTT broker.
 
     General usage flow:
 
-    * Use connect()/connect_async() to connect to a broker
-    * Call loop() frequently to maintain network traffic flow with the broker
-    * Or use loop_start() to set a thread running to call loop() for you.
-    * Or use loop_forever() to handle calling loop() for you in a blocking
-    * function.
-    * Use subscribe() to subscribe to a topic and receive messages
-    * Use publish() to send messages
-    * Use disconnect() to disconnect from the broker
+    * Use `connect()`, `connect_async()` or `connect_srv()` to connect to a broker
+    * Use `loop_start()` to set a thread running to call `loop()` for you.
+    * Or use `loop_forever()` to handle calling `loop()` for you in a blocking function.
+    * Or call `loop()` frequently to maintain network traffic flow with the broker
+    * Use `subscribe()` to subscribe to a topic and receive messages
+    * Use `publish()` to send messages
+    * Use `disconnect()` to disconnect from the broker
 
     Data returned from the broker is made available with the use of callback
     functions as described below.
 
-    Callbacks
-    =========
+    :param CallbackAPIVersion callback_api_version: define the API version for user-callback (on_connect, on_publish,...).
+        This field is required and it's recommended to use the latest version (CallbackAPIVersion.API_VERSION2).
+        See each callback for description of API for each version. The file migrations.md contains details on
+        how to migrate between version.
 
-    A number of callback functions are available to receive data back from the
-    broker. To use a callback, define a function and then assign it to the
-    client:
-
-    def on_connect(client, userdata, flags, rc):
-        print("Connection returned " + str(rc))
-
-    client.on_connect = on_connect
-
-    Callbacks can also be attached using decorators:
-
-    client = paho.mqtt.Client()
-
-    @client.connect_callback()
-    def on_connect(client, userdata, flags, rc):
-        print("Connection returned " + str(rc))
-
-
-    **IMPORTANT** the required function signature for a callback can differ
-    depending on whether you are using MQTT v5 or MQTT v3.1.1/v3.1. See the
-    documentation for each callback.
-
-    All of the callbacks as described below have a "client" and an "userdata"
-    argument. "client" is the Client instance that is calling the callback.
-    "userdata" is user data of any type and can be set when creating a new client
-    instance or with user_data_set(userdata).
-
-    If you wish to suppress exceptions within a callback, you should set
-    `client.suppress_exceptions = True`
-
-    The callbacks are listed below, documentation for each of them can be found
-    at the same function name:
-
-    on_connect, on_connect_fail, on_disconnect, on_message, on_publish,
-    on_subscribe, on_unsubscribe, on_log, on_socket_open, on_socket_close,
-    on_socket_register_write, on_socket_unregister_write
-    """
-
-    def __init__(self, client_id="", clean_session=None, userdata=None,
-                 protocol=MQTTv311, transport="tcp", reconnect_on_failure=True):
-        """client_id is the unique client id string used when connecting to the
+    :param str client_id: the unique client id string used when connecting to the
         broker. If client_id is zero length or None, then the behaviour is
         defined by which protocol version is in use. If using MQTT v3.1.1, then
         a zero length client id will be sent to the broker and the broker will
@@ -500,7 +659,7 @@ class Client(object):
         randomly generated. In both cases, clean_session must be True. If this
         is not the case a ValueError will be raised.
 
-        clean_session is a boolean that determines the client type. If True,
+    :param bool clean_session: a boolean that determines the client type. If True,
         the broker will remove all information about this client when it
         disconnects. If False, the client is a persistent client and
         subscription information and queued messages will be retained when the
@@ -512,30 +671,105 @@ class Client(object):
         It is not accepted if the MQTT version is v5.0 - use the clean_start
         argument on connect() instead.
 
-        userdata is user defined data of any type that is passed as the "userdata"
+    :param userdata: user defined data of any type that is passed as the "userdata"
         parameter to callbacks. It may be updated at a later point with the
         user_data_set() function.
 
-        The protocol argument allows explicit setting of the MQTT version to
+    :param int protocol: allows explicit setting of the MQTT version to
         use for this client. Can be paho.mqtt.client.MQTTv311 (v3.1.1),
         paho.mqtt.client.MQTTv31 (v3.1) or paho.mqtt.client.MQTTv5 (v5.0),
         with the default being v3.1.1.
 
-        Set transport to "websockets" to use WebSockets as the transport
+    :param transport: use "websockets" to use WebSockets as the transport
         mechanism. Set to "tcp" to use raw TCP, which is the default.
-        """
 
-        if transport.lower() not in ('websockets', 'tcp'):
+    :param bool manual_ack: normally, when a message is received, the library automatically
+        acknowledges after on_message callback returns.  manual_ack=True allows the application to
+        acknowledge receipt after it has completed processing of a message
+        using a the ack() method. This addresses vulnerability to message loss
+        if applications fails while processing a message, or while it pending
+        locally.
+
+    Callbacks
+    =========
+
+    A number of callback functions are available to receive data back from the
+    broker. To use a callback, define a function and then assign it to the
+    client::
+
+        def on_connect(client, userdata, flags, reason_code, properties):
+            print(f"Connected with result code {reason_code}")
+
+        client.on_connect = on_connect
+
+    Callbacks can also be attached using decorators::
+
+        mqttc = paho.mqtt.Client()
+
+        @mqttc.connect_callback()
+        def on_connect(client, userdata, flags, reason_code, properties):
+            print(f"Connected with result code {reason_code}")
+
+    All of the callbacks as described below have a "client" and an "userdata"
+    argument. "client" is the `Client` instance that is calling the callback.
+    userdata" is user data of any type and can be set when creating a new client
+    instance or with `user_data_set()`.
+
+    If you wish to suppress exceptions within a callback, you should set
+    ``mqttc.suppress_exceptions = True``
+
+    The callbacks are listed below, documentation for each of them can be found
+    at the same function name:
+
+    `on_connect`, `on_connect_fail`, `on_disconnect`, `on_message`, `on_publish`,
+    `on_subscribe`, `on_unsubscribe`, `on_log`, `on_socket_open`, `on_socket_close`,
+    `on_socket_register_write`, `on_socket_unregister_write`
+    """
+
+    def __init__(
+        self,
+        callback_api_version: CallbackAPIVersion,
+        client_id: str = "",
+        clean_session: bool | None = None,
+        userdata: Any = None,
+        protocol: int = MQTTv311,
+        transport: Literal["tcp", "websockets"] = "tcp",
+        reconnect_on_failure: bool = True,
+        manual_ack: bool = False,
+    ) -> None:
+        transport = transport.lower()  # type: ignore
+        if transport not in ("websockets", "tcp"):
             raise ValueError(
-                'transport must be "websockets" or "tcp", not %s' % transport)
-        self._transport = transport.lower()
+                f'transport must be "websockets" or "tcp", not {transport}')
+
+        self._manual_ack = manual_ack
+        self._transport = transport
         self._protocol = protocol
         self._userdata = userdata
-        self._sock = None
-        self._sockpairR, self._sockpairW = (None, None,)
+        self._sock: SocketLike | None = None
+        self._sockpairR: socket.socket | None = None
+        self._sockpairW: socket.socket | None = None
         self._keepalive = 60
         self._connect_timeout = 5.0
         self._client_mode = MQTT_CLIENT
+        self._callback_api_version = callback_api_version
+
+        if self._callback_api_version == CallbackAPIVersion.VERSION1:
+            warnings.warn(
+                "Callback API version 1 is deprecated, update to latest version",
+                category=DeprecationWarning,
+                stacklevel=2,
+            )
+        if isinstance(self._callback_api_version, str):
+            # Help user to migrate, it probably provided a client id
+            # as first arguments
+            raise ValueError(
+                "Unsupported callback API version: version 2.0 added a callback_api_version, see migrations.md for details"
+            )
+        if self._callback_api_version not in CallbackAPIVersion:
+            raise ValueError("Unsupported callback API version")
+
+        self._clean_start: int = MQTT_CLEAN_START_FIRST_ONLY
 
         if protocol == MQTTv5:
             if clean_session is not None:
@@ -551,17 +785,15 @@ class Client(object):
         # [MQTT-3.1.3-4] Client Id must be UTF-8 encoded string.
         if client_id == "" or client_id is None:
             if protocol == MQTTv31:
-                self._client_id = base62(uuid.uuid4().int, padding=22)
+                self._client_id = _base62(uuid.uuid4().int, padding=22).encode("utf8")
             else:
                 self._client_id = b""
         else:
-            self._client_id = client_id
-        if isinstance(self._client_id, unicode):
-            self._client_id = self._client_id.encode('utf-8')
+            self._client_id = _force_bytes(client_id)
 
-        self._username = None
-        self._password = None
-        self._in_packet = {
+        self._username: bytes | None = None
+        self._password: bytes | None = None
+        self._in_packet: _InPacket = {
             "command": 0,
             "have_remaining": 0,
             "remaining_count": [],
@@ -569,24 +801,29 @@ class Client(object):
             "remaining_length": 0,
             "packet": bytearray(b""),
             "to_process": 0,
-            "pos": 0}
-        self._out_packet = collections.deque()
+            "pos": 0,
+        }
+        self._out_packet: collections.deque[_OutPacket] = collections.deque()
         self._last_msg_in = time_func()
         self._last_msg_out = time_func()
         self._reconnect_min_delay = 1
         self._reconnect_max_delay = 120
-        self._reconnect_delay = None
+        self._reconnect_delay: int | None = None
         self._reconnect_on_failure = reconnect_on_failure
-        self._ping_t = 0
+        self._ping_t = 0.0
         self._last_mid = 0
-        self._state = mqtt_cs_new
-        self._out_messages = collections.OrderedDict()
-        self._in_messages = collections.OrderedDict()
+        self._state = _ConnectionState.MQTT_CS_NEW
+        self._out_messages: collections.OrderedDict[
+            int, MQTTMessage
+        ] = collections.OrderedDict()
+        self._in_messages: collections.OrderedDict[
+            int, MQTTMessage
+        ] = collections.OrderedDict()
         self._max_inflight_messages = 20
         self._inflight_messages = 0
         self._max_queued_messages = 0
-        self._connect_properties = None
-        self._will_properties = None
+        self._connect_properties: Properties | None = None
+        self._will_properties: Properties | None = None
         self._will = False
         self._will_topic = b""
         self._will_payload = b""
@@ -597,7 +834,7 @@ class Client(object):
         self._port = 1883
         self._bind_address = ""
         self._bind_port = 0
-        self._proxy = {}
+        self._proxy: Any = {}
         self._in_callback_mutex = threading.Lock()
         self._callback_mutex = threading.RLock()
         self._msgtime_mutex = threading.Lock()
@@ -605,58 +842,279 @@ class Client(object):
         self._in_message_mutex = threading.Lock()
         self._reconnect_delay_mutex = threading.Lock()
         self._mid_generate_mutex = threading.Lock()
-        self._thread = None
+        self._thread: threading.Thread | None = None
         self._thread_terminate = False
         self._ssl = False
-        self._ssl_context = None
+        self._ssl_context: ssl.SSLContext | None = None
         # Only used when SSL context does not have check_hostname attribute
         self._tls_insecure = False
-        self._logger = None
+        self._logger: logging.Logger | None = None
         self._registered_write = False
         # No default callbacks
-        self._on_log = None
-        self._on_connect = None
-        self._on_connect_fail = None
-        self._on_subscribe = None
-        self._on_message = None
-        self._on_publish = None
-        self._on_unsubscribe = None
-        self._on_disconnect = None
-        self._on_socket_open = None
-        self._on_socket_close = None
-        self._on_socket_register_write = None
-        self._on_socket_unregister_write = None
+        self._on_log: CallbackOnLog | None = None
+        self._on_pre_connect: CallbackOnPreConnect | None = None
+        self._on_connect: CallbackOnConnect | None = None
+        self._on_connect_fail: CallbackOnConnectFail | None = None
+        self._on_subscribe: CallbackOnSubscribe | None = None
+        self._on_message: CallbackOnMessage | None = None
+        self._on_publish: CallbackOnPublish | None = None
+        self._on_unsubscribe: CallbackOnUnsubscribe | None = None
+        self._on_disconnect: CallbackOnDisconnect | None = None
+        self._on_socket_open: CallbackOnSocket | None = None
+        self._on_socket_close: CallbackOnSocket | None = None
+        self._on_socket_register_write: CallbackOnSocket | None = None
+        self._on_socket_unregister_write: CallbackOnSocket | None = None
         self._websocket_path = "/mqtt"
-        self._websocket_extra_headers = None
+        self._websocket_extra_headers: WebSocketHeaders | None = None
         # for clean_start == MQTT_CLEAN_START_FIRST_ONLY
         self._mqttv5_first_connect = True
         self.suppress_exceptions = False # For callbacks
 
-    def __del__(self):
+    def __del__(self) -> None:
         self._reset_sockets()
 
-    def _sock_recv(self, bufsize):
+    @property
+    def host(self) -> str:
+        """
+        Host to connect to. If `connect()` hasn't been called yet, returns an empty string.
+
+        This property may not be changed if the connection is already open.
+        """
+        return self._host
+
+    @host.setter
+    def host(self, value: str) -> None:
+        if not self._connection_closed():
+            raise RuntimeError("updating host on established connection is not supported")
+
+        if not value:
+            raise ValueError("Invalid host.")
+        self._host = value
+
+    @property
+    def port(self) -> int:
+        """
+        Broker TCP port to connect to.
+
+        This property may not be changed if the connection is already open.
+        """
+        return self._port
+
+    @port.setter
+    def port(self, value: int) -> None:
+        if not self._connection_closed():
+            raise RuntimeError("updating port on established connection is not supported")
+
+        if value <= 0:
+            raise ValueError("Invalid port number.")
+        self._port = value
+
+    @property
+    def keepalive(self) -> int:
+        """
+        Client keepalive interval (in seconds).
+
+        This property may not be changed if the connection is already open.
+        """
+        return self._keepalive
+
+    @keepalive.setter
+    def keepalive(self, value: int) -> None:
+        if not self._connection_closed():
+            # The issue here is that the previous value of keepalive matter to possibly
+            # sent ping packet.
+            raise RuntimeError("updating keepalive on established connection is not supported")
+
+        if value < 0:
+            raise ValueError("Keepalive must be >=0.")
+
+        self._keepalive = value
+
+    @property
+    def transport(self) -> Literal["tcp", "websockets"]:
+        """
+        Transport method used for the connection ("tcp" or "websockets").
+
+        This property may not be changed if the connection is already open.
+        """
+        return self._transport
+
+    @transport.setter
+    def transport(self, value: Literal["tcp", "websockets"]) -> None:
+        if not self._connection_closed():
+            raise RuntimeError("updating transport on established connection is not supported")
+
+        self._transport = value
+
+    @property
+    def protocol(self) -> MQTTProtocolVersion:
+        """
+        Protocol version used (MQTT v3, MQTT v3.11, MQTTv5)
+
+        This property is read-only.
+        """
+        return self.protocol
+
+    @property
+    def connect_timeout(self) -> float:
+        """
+        Connection establishment timeout in seconds.
+
+        This property may not be changed if the connection is already open.
+        """
+        return self._connect_timeout
+
+    @connect_timeout.setter
+    def connect_timeout(self, value: float) -> None:
+        if not self._connection_closed():
+            raise RuntimeError("updating connect_timeout on established connection is not supported")
+
+        if value <= 0.0:
+            raise ValueError("timeout must be a positive number")
+
+        self._connect_timeout = value
+
+    @property
+    def username(self) -> str | None:
+        """The username used to connect to the MQTT broker, or None if no username is used.
+
+        This property may not be changed if the connection is already open.
+        """
+        if self._username is None:
+            return None
+        return self._username.decode("utf-8")
+
+    @username.setter
+    def username(self, value: str | None) -> None:
+        if not self._connection_closed():
+            raise RuntimeError("updating username on established connection is not supported")
+
+        if value is None:
+            self._username = None
+        else:
+            self._username = value.encode("utf-8")
+
+    @property
+    def password(self) -> str | None:
+        """The password used to connect to the MQTT broker, or None if no password is used.
+
+        This property may not be changed if the connection is already open.
+        """
+        if self._password is None:
+            return None
+        return self._password.decode("utf-8")
+
+    @password.setter
+    def password(self, value: str | None) -> None:
+        if not self._connection_closed():
+            raise RuntimeError("updating password on established connection is not supported")
+
+        if value is None:
+            self._password = None
+        else:
+            self._password = value.encode("utf-8")
+
+    @property
+    def max_inflight_messages(self) -> int:
+        """
+        Maximum number of messages with QoS > 0 that can be partway through the network flow at once
+
+        This property may not be changed if the connection is already open.
+        """
+        return self._max_inflight_messages
+
+    @max_inflight_messages.setter
+    def max_inflight_messages(self, value: int) -> None:
+        if not self._connection_closed():
+            # Not tested. Some doubt that everything is okay when max_inflight change between 0
+            # and > 0 value because _update_inflight is skipped when _max_inflight_messages == 0
+            raise RuntimeError("updating max_inflight_messages on established connection is not supported")
+
+        if value < 0:
+            raise ValueError("Invalid inflight.")
+
+        self._max_inflight_messages = value
+
+    @property
+    def max_queued_messages(self) -> int:
+        """
+        Maximum number of message in the outgoing message queue, 0 means unlimited
+
+        This property may not be changed if the connection is already open.
+        """
+        return self._max_queued_messages
+
+    @max_queued_messages.setter
+    def max_queued_messages(self, value: int) -> None:
+        if not self._connection_closed():
+            # Not tested.
+            raise RuntimeError("updating max_queued_messages on established connection is not supported")
+
+        if value < 0:
+            raise ValueError("Invalid queue size.")
+
+        self._max_queued_messages = value
+
+    @property
+    def will_topic(self) -> str | None:
+        """
+        The topic name a will message is sent to when disconnecting unexpectedly. None if a will shall not be sent.
+
+        This property is read-only. Use `will_set()` to change its value.
+        """
+        if self._will_topic is None:
+            return None
+
+        return self._will_topic.decode("utf-8")
+
+    @property
+    def will_payload(self) -> bytes | None:
+        """
+        The payload for the will message that is sent when disconnecting unexpectedly. None if a will shall not be sent.
+
+        This property is read-only. Use `will_set()` to change its value.
+        """
+        return self._will_payload
+
+    @property
+    def logger(self) -> logging.Logger | None:
+        return self._logger
+
+    @logger.setter
+    def logger(self, value: logging.Logger | None) -> None:
+        self._logger = value
+
+    def _sock_recv(self, bufsize: int) -> bytes:
+        if self._sock is None:
+            raise ConnectionError("self._sock is None")
         try:
             return self._sock.recv(bufsize)
-        except ssl.SSLWantReadError:
-            raise BlockingIOError
-        except ssl.SSLWantWriteError:
+        except ssl.SSLWantReadError as err:
+            raise BlockingIOError() from err
+        except ssl.SSLWantWriteError as err:
             self._call_socket_register_write()
-            raise BlockingIOError
+            raise BlockingIOError() from err
+        except AttributeError as err:
+            self._easy_log(
+                MQTT_LOG_DEBUG, "socket was None: %s", err)
+            raise ConnectionError() from err
+
+    def _sock_send(self, buf: bytes) -> int:
+        if self._sock is None:
+            raise ConnectionError("self._sock is None")
 
-    def _sock_send(self, buf):
         try:
             return self._sock.send(buf)
-        except ssl.SSLWantReadError:
-            raise BlockingIOError
-        except ssl.SSLWantWriteError:
+        except ssl.SSLWantReadError as err:
+            raise BlockingIOError() from err
+        except ssl.SSLWantWriteError as err:
             self._call_socket_register_write()
-            raise BlockingIOError
-        except BlockingIOError:
+            raise BlockingIOError() from err
+        except BlockingIOError as err:
             self._call_socket_register_write()
-            raise BlockingIOError
+            raise BlockingIOError() from err
 
-    def _sock_close(self):
+    def _sock_close(self) -> None:
         """Close the connection to the server."""
         if not self._sock:
             return
@@ -670,8 +1128,8 @@ class Client(object):
             # In case a callback fails, still close the socket to avoid leaking the file descriptor.
             sock.close()
 
-    def _reset_sockets(self, sockpair_only=False):
-        if sockpair_only == False:
+    def _reset_sockets(self, sockpair_only: bool = False) -> None:
+        if not sockpair_only:
             self._sock_close()
 
         if self._sockpairR:
@@ -681,21 +1139,30 @@ class Client(object):
             self._sockpairW.close()
             self._sockpairW = None
 
-    def reinitialise(self, client_id="", clean_session=True, userdata=None):
+    def reinitialise(
+        self,
+        client_id: str = "",
+        clean_session: bool = True,
+        userdata: Any = None,
+    ) -> None:
         self._reset_sockets()
 
-        self.__init__(client_id, clean_session, userdata)
+        self.__init__(client_id, clean_session, userdata)  # type: ignore[misc]
 
-    def ws_set_options(self, path="/mqtt", headers=None):
+    def ws_set_options(
+        self,
+        path: str = "/mqtt",
+        headers: WebSocketHeaders | None = None,
+    ) -> None:
         """ Set the path and headers for a websocket connection
 
-        path is a string starting with / which should be the endpoint of the
-        mqtt connection on the remote server
+        :param str path: a string starting with / which should be the endpoint of the
+            mqtt connection on the remote server
 
-        headers can be either a dict or a callable object. If it is a dict then
-        the extra items in the dict are added to the websocket headers. If it is
-        a callable, then the default websocket headers are passed into this
-        function and the result is used as the new headers.
+        :param headers:  can be either a dict or a callable object. If it is a dict then
+            the extra items in the dict are added to the websocket headers. If it is
+            a callable, then the default websocket headers are passed into this
+            function and the result is used as the new headers.
         """
         self._websocket_path = path
 
@@ -706,24 +1173,21 @@ class Client(object):
                 raise ValueError(
                     "'headers' option to ws_set_options has to be either a dictionary or callable")
 
-    def tls_set_context(self, context=None):
+    def tls_set_context(
+        self,
+        context: ssl.SSLContext | None = None,
+    ) -> None:
         """Configure network encryption and authentication context. Enables SSL/TLS support.
 
-        context : an ssl.SSLContext object. By default this is given by
-        `ssl.create_default_context()`, if available.
+        :param context: an ssl.SSLContext object. By default this is given by
+            ``ssl.create_default_context()``, if available.
 
-        Must be called before connect() or connect_async()."""
+        Must be called before `connect()`, `connect_async()` or `connect_srv()`."""
         if self._ssl_context is not None:
             raise ValueError('SSL/TLS has already been configured.')
 
-        # Assume that have SSL support, or at least that context input behaves like ssl.SSLContext
-        # in current versions of Python
-
         if context is None:
-            if hasattr(ssl, 'create_default_context'):
-                context = ssl.create_default_context()
-            else:
-                raise ValueError('SSL/TLS context must be specified')
+            context = ssl.create_default_context()
 
         self._ssl = True
         self._ssl_context = context
@@ -732,46 +1196,59 @@ class Client(object):
         if hasattr(context, 'check_hostname'):
             self._tls_insecure = not context.check_hostname
 
-    def tls_set(self, ca_certs=None, certfile=None, keyfile=None, cert_reqs=None, tls_version=None, ciphers=None, keyfile_password=None):
+    def tls_set(
+        self,
+        ca_certs: str | None = None,
+        certfile: str | None = None,
+        keyfile: str | None = None,
+        cert_reqs: ssl.VerifyMode | None = None,
+        tls_version: int | None = None,
+        ciphers: str | None = None,
+        keyfile_password: str | None = None,
+        alpn_protocols: list[str] | None = None,
+    ) -> None:
         """Configure network encryption and authentication options. Enables SSL/TLS support.
 
-        ca_certs : a string path to the Certificate Authority certificate files
-        that are to be treated as trusted by this client. If this is the only
-        option given then the client will operate in a similar manner to a web
-        browser. That is to say it will require the broker to have a
-        certificate signed by the Certificate Authorities in ca_certs and will
-        communicate using TLS v1,2, but will not attempt any form of
-        authentication. This provides basic network encryption but may not be
-        sufficient depending on how the broker is configured.
-        By default, on Python 2.7.9+ or 3.4+, the default certification
-        authority of the system is used. On older Python version this parameter
-        is mandatory.
+        :param str ca_certs: a string path to the Certificate Authority certificate files
+            that are to be treated as trusted by this client. If this is the only
+            option given then the client will operate in a similar manner to a web
+            browser. That is to say it will require the broker to have a
+            certificate signed by the Certificate Authorities in ca_certs and will
+            communicate using TLS v1,2, but will not attempt any form of
+            authentication. This provides basic network encryption but may not be
+            sufficient depending on how the broker is configured.
 
-        certfile and keyfile are strings pointing to the PEM encoded client
-        certificate and private keys respectively. If these arguments are not
-        None then they will be used as client information for TLS based
-        authentication.  Support for this feature is broker dependent. Note
-        that if either of these files in encrypted and needs a password to
-        decrypt it, then this can be passed using the keyfile_password
-        argument - you should take precautions to ensure that your password is
-        not hard coded into your program by loading the password from a file
-        for example. If you do not provide keyfile_password, the password will
-        be requested to be typed in at a terminal window.
+            By default, on Python 2.7.9+ or 3.4+, the default certification
+            authority of the system is used. On older Python version this parameter
+            is mandatory.
+        :param str certfile: PEM encoded client certificate filename. Used with
+            keyfile for client TLS based authentication. Support for this feature is
+            broker dependent. Note that if the files in encrypted and needs a password to
+            decrypt it, then this can be passed using the keyfile_password argument - you
+            should take precautions to ensure that your password is
+            not hard coded into your program by loading the password from a file
+            for example. If you do not provide keyfile_password, the password will
+            be requested to be typed in at a terminal window.
+        :param str keyfile: PEM encoded client private keys filename. Used with
+            certfile for client TLS based authentication. Support for this feature is
+            broker dependent. Note that if the files in encrypted and needs a password to
+            decrypt it, then this can be passed using the keyfile_password argument - you
+            should take precautions to ensure that your password is
+            not hard coded into your program by loading the password from a file
+            for example. If you do not provide keyfile_password, the password will
+            be requested to be typed in at a terminal window.
+        :param cert_reqs: the certificate requirements that the client imposes
+            on the broker to be changed. By default this is ssl.CERT_REQUIRED,
+            which means that the broker must provide a certificate. See the ssl
+            pydoc for more information on this parameter.
+        :param tls_version: the version of the SSL/TLS protocol used to be
+            specified. By default TLS v1.2 is used. Previous versions are allowed
+            but not recommended due to possible security problems.
+        :param str ciphers: encryption ciphers that are allowed
+            for this connection, or None to use the defaults. See the ssl pydoc for
+            more information.
 
-        cert_reqs allows the certificate requirements that the client imposes
-        on the broker to be changed. By default this is ssl.CERT_REQUIRED,
-        which means that the broker must provide a certificate. See the ssl
-        pydoc for more information on this parameter.
-
-        tls_version allows the version of the SSL/TLS protocol used to be
-        specified. By default TLS v1.2 is used. Previous versions are allowed
-        but not recommended due to possible security problems.
-
-        ciphers is a string specifying which encryption ciphers are allowable
-        for this connection, or None to use the defaults. See the ssl pydoc for
-        more information.
-
-        Must be called before connect() or connect_async()."""
+        Must be called before `connect()`, `connect_async()` or `connect_srv()`."""
         if ssl is None:
             raise ValueError('This platform has no SSL/TLS.')
 
@@ -787,11 +1264,17 @@ class Client(object):
         if tls_version is None:
             tls_version = ssl.PROTOCOL_TLSv1_2
             # If the python version supports it, use highest TLS version automatically
-            if hasattr(ssl, "PROTOCOL_TLS"):
+            if hasattr(ssl, "PROTOCOL_TLS_CLIENT"):
+                # This also enables CERT_REQUIRED and check_hostname by default.
+                tls_version = ssl.PROTOCOL_TLS_CLIENT
+            elif hasattr(ssl, "PROTOCOL_TLS"):
                 tls_version = ssl.PROTOCOL_TLS
         context = ssl.SSLContext(tls_version)
 
         # Configure context
+        if ciphers is not None:
+            context.set_ciphers(ciphers)
+
         if certfile is not None:
             context.load_cert_chain(certfile, keyfile, keyfile_password)
 
@@ -805,8 +1288,10 @@ class Client(object):
         else:
             context.load_default_certs()
 
-        if ciphers is not None:
-            context.set_ciphers(ciphers)
+        if alpn_protocols is not None:
+            if not getattr(ssl, "HAS_ALPN", None):
+                raise ValueError("SSL library has no support for ALPN")
+            context.set_alpn_protocols(alpn_protocols)
 
         self.tls_set_context(context)
 
@@ -818,7 +1303,7 @@ class Client(object):
             # But with ssl.CERT_NONE, we can not check_hostname
             self.tls_insecure_set(True)
 
-    def tls_insecure_set(self, value):
+    def tls_insecure_set(self, value: bool) -> None:
         """Configure verification of the server hostname in the server certificate.
 
         If value is set to true, it is impossible to guarantee that the host
@@ -830,8 +1315,8 @@ class Client(object):
         Do not use this function in a real system. Setting value to true means
         there is no point using encryption.
 
-        Must be called before connect() and after either tls_set() or
-        tls_set_context()."""
+        Must be called before `connect()` and after either `tls_set()` or
+        `tls_set_context()`."""
 
         if self._ssl_context is None:
             raise ValueError(
@@ -845,7 +1330,7 @@ class Client(object):
             # If verify_mode is CERT_NONE then the host name will never be checked
             self._ssl_context.check_hostname = not value
 
-    def proxy_set(self, **proxy_args):
+    def proxy_set(self, **proxy_args: Any) -> None:
         """Configure proxying of MQTT connection. Enables support for SOCKS or
         HTTP proxies.
 
@@ -853,16 +1338,23 @@ class Client(object):
         proxy_args parameters are below; see the PySocks docs for more info.
 
         (Required)
-        proxy_type: One of {socks.HTTP, socks.SOCKS4, or socks.SOCKS5}
-        proxy_addr: IP address or DNS name of proxy server
+
+        :param proxy_type: One of {socks.HTTP, socks.SOCKS4, or socks.SOCKS5}
+        :param proxy_addr: IP address or DNS name of proxy server
 
         (Optional)
-        proxy_rdns: boolean indicating whether proxy lookup should be performed
-            remotely (True, default) or locally (False)
-        proxy_username: username for SOCKS5 proxy, or userid for SOCKS4 proxy
-        proxy_password: password for SOCKS5 proxy
 
-        Must be called before connect() or connect_async()."""
+        :param proxy_port: (int) port number of the proxy server. If not provided,
+            the PySocks package default value will be utilized, which differs by proxy_type.
+        :param proxy_rdns: boolean indicating whether proxy lookup should be performed
+            remotely (True, default) or locally (False)
+        :param proxy_username: username for SOCKS5 proxy, or userid for SOCKS4 proxy
+        :param proxy_password: password for SOCKS5 proxy
+
+        Example::
+
+            mqttc.proxy_set(proxy_type=socks.HTTP, proxy_addr='1.2.3.4', proxy_port=4231)
+        """
         if socks is None:
             raise ValueError("PySocks must be installed for proxy support.")
         elif not self._proxy_is_valid(proxy_args):
@@ -870,35 +1362,58 @@ class Client(object):
         else:
             self._proxy = proxy_args
 
-    def enable_logger(self, logger=None):
-        """ Enables a logger to send log messages to """
+    def enable_logger(self, logger: logging.Logger | None = None) -> None:
+        """
+        Enables a logger to send log messages to
+
+        :param logging.Logger logger: if specified, that ``logging.Logger`` object will be used, otherwise
+            one will be created automatically.
+
+        See `disable_logger` to undo this action.
+        """
         if logger is None:
             if self._logger is not None:
                 # Do not replace existing logger
                 return
             logger = logging.getLogger(__name__)
-        self._logger = logger
+        self.logger = logger
 
-    def disable_logger(self):
+    def disable_logger(self) -> None:
+        """
+        Disable logging using standard python logging package. This has no effect on the `on_log` callback.
+        """
         self._logger = None
 
-    def connect(self, host, port=1883, keepalive=60, bind_address="", bind_port=0,
-                clean_start=MQTT_CLEAN_START_FIRST_ONLY, properties=None):
-        """Connect to a remote broker.
+    def connect(
+        self,
+        host: str,
+        port: int = 1883,
+        keepalive: int = 60,
+        bind_address: str = "",
+        bind_port: int = 0,
+        clean_start: CleanStartOption = MQTT_CLEAN_START_FIRST_ONLY,
+        properties: Properties | None = None,
+    ) -> MQTTErrorCode:
+        """Connect to a remote broker. This is a blocking call that establishes
+        the underlying connection and transmits a CONNECT packet.
+        Note that the connection status will not be updated until a CONNACK is received and
+        processed (this requires a running network loop, see `loop_start`, `loop_forever`, `loop`...).
 
-        host is the hostname or IP address of the remote broker.
-        port is the network port of the server host to connect to. Defaults to
-        1883. Note that the default port for MQTT over SSL/TLS is 8883 so if you
-        are using tls_set() the port may need providing.
-        keepalive: Maximum period in seconds between communications with the
-        broker. If no other messages are being exchanged, this controls the
-        rate at which the client will send ping messages to the broker.
-        clean_start: (MQTT v5.0 only) True, False or MQTT_CLEAN_START_FIRST_ONLY.
-        Sets the MQTT v5.0 clean_start flag always, never or on the first successful connect only,
-        respectively.  MQTT session data (such as outstanding messages and subscriptions)
-        is cleared on successful connect when the clean_start flag is set.
-        properties: (MQTT v5.0 only) the MQTT v5.0 properties to be sent in the
-        MQTT connect packet.
+        :param str host: the hostname or IP address of the remote broker.
+        :param int port: the network port of the server host to connect to. Defaults to
+            1883. Note that the default port for MQTT over SSL/TLS is 8883 so if you
+            are using `tls_set()` the port may need providing.
+        :param int keepalive: Maximum period in seconds between communications with the
+            broker. If no other messages are being exchanged, this controls the
+            rate at which the client will send ping messages to the broker.
+        :param bool clean_start: (MQTT v5.0 only) True, False or MQTT_CLEAN_START_FIRST_ONLY.
+            Sets the MQTT v5.0 clean_start flag always, never or on the first successful connect only,
+            respectively.  MQTT session data (such as outstanding messages and subscriptions)
+            is cleared on successful connect when the clean_start flag is set.
+            For MQTT v3.1.1, the ``clean_session`` argument of `Client` should be used for similar
+            result.
+        :param Properties properties: (MQTT v5.0 only) the MQTT v5.0 properties to be sent in the
+            MQTT connect packet.
         """
 
         if self._protocol == MQTTv5:
@@ -906,97 +1421,110 @@ class Client(object):
         else:
             if clean_start != MQTT_CLEAN_START_FIRST_ONLY:
                 raise ValueError("Clean start only applies to MQTT V5")
-            if properties != None:
+            if properties:
                 raise ValueError("Properties only apply to MQTT V5")
 
         self.connect_async(host, port, keepalive,
                            bind_address, bind_port, clean_start, properties)
         return self.reconnect()
 
-    def connect_srv(self, domain=None, keepalive=60, bind_address="",
-                    clean_start=MQTT_CLEAN_START_FIRST_ONLY, properties=None):
+    def connect_srv(
+        self,
+        domain: str | None = None,
+        keepalive: int = 60,
+        bind_address: str = "",
+        bind_port: int = 0,
+        clean_start: CleanStartOption = MQTT_CLEAN_START_FIRST_ONLY,
+        properties: Properties | None = None,
+    ) -> MQTTErrorCode:
         """Connect to a remote broker.
 
-        domain is the DNS domain to search for SRV records; if None,
-        try to determine local domain name.
-        keepalive, bind_address, clean_start and properties are as for connect()
+        :param str domain: the DNS domain to search for SRV records; if None,
+            try to determine local domain name.
+        :param keepalive, bind_address, clean_start and properties: see `connect()`
         """
 
         if HAVE_DNS is False:
             raise ValueError(
-                'No DNS resolver library found, try "pip install dnspython" or "pip3 install dnspython3".')
+                'No DNS resolver library found, try "pip install dnspython".')
 
         if domain is None:
             domain = socket.getfqdn()
             domain = domain[domain.find('.') + 1:]
 
         try:
-            rr = '_mqtt._tcp.%s' % domain
+            rr = f'_mqtt._tcp.{domain}'
             if self._ssl:
                 # IANA specifies secure-mqtt (not mqtts) for port 8883
-                rr = '_secure-mqtt._tcp.%s' % domain
+                rr = f'_secure-mqtt._tcp.{domain}'
             answers = []
             for answer in dns.resolver.query(rr, dns.rdatatype.SRV):
                 addr = answer.target.to_text()[:-1]
                 answers.append(
                     (addr, answer.port, answer.priority, answer.weight))
-        except (dns.resolver.NXDOMAIN, dns.resolver.NoAnswer, dns.resolver.NoNameservers):
-            raise ValueError("No answer/NXDOMAIN for SRV in %s" % (domain))
+        except (dns.resolver.NXDOMAIN, dns.resolver.NoAnswer, dns.resolver.NoNameservers) as err:
+            raise ValueError(f"No answer/NXDOMAIN for SRV in {domain}") from err
 
         # FIXME: doesn't account for weight
         for answer in answers:
             host, port, prio, weight = answer
 
             try:
-                return self.connect(host, port, keepalive, bind_address, clean_start, properties)
-            except Exception:
+                return self.connect(host, port, keepalive, bind_address, bind_port, clean_start, properties)
+            except Exception:  # noqa: S110
                 pass
 
         raise ValueError("No SRV hosts responded")
 
-    def connect_async(self, host, port=1883, keepalive=60, bind_address="", bind_port=0,
-                      clean_start=MQTT_CLEAN_START_FIRST_ONLY, properties=None):
+    def connect_async(
+        self,
+        host: str,
+        port: int = 1883,
+        keepalive: int = 60,
+        bind_address: str = "",
+        bind_port: int = 0,
+        clean_start: CleanStartOption = MQTT_CLEAN_START_FIRST_ONLY,
+        properties: Properties | None = None,
+    ) -> None:
         """Connect to a remote broker asynchronously. This is a non-blocking
-        connect call that can be used with loop_start() to provide very quick
+        connect call that can be used with `loop_start()` to provide very quick
         start.
 
-        host is the hostname or IP address of the remote broker.
-        port is the network port of the server host to connect to. Defaults to
-        1883. Note that the default port for MQTT over SSL/TLS is 8883 so if you
-        are using tls_set() the port may need providing.
-        keepalive: Maximum period in seconds between communications with the
-        broker. If no other messages are being exchanged, this controls the
-        rate at which the client will send ping messages to the broker.
-        clean_start: (MQTT v5.0 only) True, False or MQTT_CLEAN_START_FIRST_ONLY.
-        Sets the MQTT v5.0 clean_start flag always, never or on the first successful connect only,
-        respectively.  MQTT session data (such as outstanding messages and subscriptions)
-        is cleared on successful connect when the clean_start flag is set.
-        properties: (MQTT v5.0 only) the MQTT v5.0 properties to be sent in the
-        MQTT connect packet.  Use the Properties class.
+        Any already established connection will be terminated immediately.
+
+        :param str host: the hostname or IP address of the remote broker.
+        :param int port: the network port of the server host to connect to. Defaults to
+            1883. Note that the default port for MQTT over SSL/TLS is 8883 so if you
+            are using `tls_set()` the port may need providing.
+        :param int keepalive: Maximum period in seconds between communications with the
+            broker. If no other messages are being exchanged, this controls the
+            rate at which the client will send ping messages to the broker.
+        :param bool clean_start: (MQTT v5.0 only) True, False or MQTT_CLEAN_START_FIRST_ONLY.
+            Sets the MQTT v5.0 clean_start flag always, never or on the first successful connect only,
+            respectively.  MQTT session data (such as outstanding messages and subscriptions)
+            is cleared on successful connect when the clean_start flag is set.
+            For MQTT v3.1.1, the ``clean_session`` argument of `Client` should be used for similar
+            result.
+        :param Properties properties: (MQTT v5.0 only) the MQTT v5.0 properties to be sent in the
+            MQTT connect packet.
         """
-        if host is None or len(host) == 0:
-            raise ValueError('Invalid host.')
-        if port <= 0:
-            raise ValueError('Invalid port number.')
-        if keepalive < 0:
-            raise ValueError('Keepalive must be >=0.')
-        if bind_address != "" and bind_address is not None:
-            if sys.version_info < (2, 7) or (3, 0) < sys.version_info < (3, 2):
-                raise ValueError('bind_address requires Python 2.7 or 3.2.')
         if bind_port < 0:
             raise ValueError('Invalid bind port number.')
 
-        self._host = host
-        self._port = port
-        self._keepalive = keepalive
+        # Switch to state NEW to allow update of host, port & co.
+        self._sock_close()
+        self._state = _ConnectionState.MQTT_CS_NEW
+
+        self.host = host
+        self.port = port
+        self.keepalive = keepalive
         self._bind_address = bind_address
         self._bind_port = bind_port
         self._clean_start = clean_start
         self._connect_properties = properties
-        self._state = mqtt_cs_connect_async
+        self._state = _ConnectionState.MQTT_CS_CONNECT_ASYNC
 
-
-    def reconnect_delay_set(self, min_delay=1, max_delay=120):
+    def reconnect_delay_set(self, min_delay: int = 1, max_delay: int = 120) -> None:
         """ Configure the exponential reconnect delay
 
             When connection is lost, wait initially min_delay seconds and
@@ -1009,7 +1537,7 @@ class Client(object):
             self._reconnect_max_delay = max_delay
             self._reconnect_delay = None
 
-    def reconnect(self):
+    def reconnect(self) -> MQTTErrorCode:
         """Reconnect the client after a disconnect. Can only be called after
         connect()/connect_async()."""
         if len(self._host) == 0:
@@ -1025,88 +1553,69 @@ class Client(object):
             "remaining_length": 0,
             "packet": bytearray(b""),
             "to_process": 0,
-            "pos": 0}
+            "pos": 0,
+        }
 
-        self._out_packet = collections.deque()
+        self._ping_t = 0.0
+        self._state = _ConnectionState.MQTT_CS_CONNECTING
+
+        self._sock_close()
+
+        # Mark all currently outgoing QoS = 0 packets as lost,
+        # or `wait_for_publish()` could hang forever
+        for pkt in self._out_packet:
+            if pkt["command"] & 0xF0 == PUBLISH and pkt["qos"] == 0 and pkt["info"] is not None:
+                pkt["info"].rc = MQTT_ERR_CONN_LOST
+                pkt["info"]._set_as_published()
+
+        self._out_packet.clear()
 
         with self._msgtime_mutex:
             self._last_msg_in = time_func()
             self._last_msg_out = time_func()
 
-        self._ping_t = 0
-        self._state = mqtt_cs_new
-
-        self._sock_close()
-
         # Put messages in progress in a valid state.
         self._messages_reconnect_reset()
 
-        sock = self._create_socket_connection()
+        with self._callback_mutex:
+            on_pre_connect = self.on_pre_connect
 
-        if self._ssl:
-            # SSL is only supported when SSLContext is available (implies Python >= 2.7.9 or >= 3.2)
-
-            verify_host = not self._tls_insecure
+        if on_pre_connect:
             try:
-                # Try with server_hostname, even it's not supported in certain scenarios
-                sock = self._ssl_context.wrap_socket(
-                    sock,
-                    server_hostname=self._host,
-                    do_handshake_on_connect=False,
-                )
-            except ssl.CertificateError:
-                # CertificateError is derived from ValueError
-                raise
-            except ValueError:
-                # Python version requires SNI in order to handle server_hostname, but SNI is not available
-                sock = self._ssl_context.wrap_socket(
-                    sock,
-                    do_handshake_on_connect=False,
-                )
-            else:
-                # If SSL context has already checked hostname, then don't need to do it again
-                if (hasattr(self._ssl_context, 'check_hostname') and
-                        self._ssl_context.check_hostname):
-                    verify_host = False
+                on_pre_connect(self, self._userdata)
+            except Exception as err:
+                self._easy_log(
+                    MQTT_LOG_ERR, 'Caught exception in on_pre_connect: %s', err)
+                if not self.suppress_exceptions:
+                    raise
 
-            sock.settimeout(self._keepalive)
-            sock.do_handshake()
+        self._sock = self._create_socket()
 
-            if verify_host:
-                ssl.match_hostname(sock.getpeercert(), self._host)
-
-        if self._transport == "websockets":
-            sock.settimeout(self._keepalive)
-            sock = WebsocketWrapper(sock, self._host, self._port, self._ssl,
-                                    self._websocket_path, self._websocket_extra_headers)
-
-        self._sock = sock
-        self._sock.setblocking(0)
+        self._sock.setblocking(False)  # type: ignore[attr-defined]
         self._registered_write = False
-        self._call_socket_open()
+        self._call_socket_open(self._sock)
 
         return self._send_connect(self._keepalive)
 
-    def loop(self, timeout=1.0, max_packets=1):
+    def loop(self, timeout: float = 1.0) -> MQTTErrorCode:
         """Process network events.
 
-        It is strongly recommended that you use loop_start(), or
-        loop_forever(), or if you are using an external event loop using
-        loop_read(), loop_write(), and loop_misc(). Using loop() on it's own is
+        It is strongly recommended that you use `loop_start()`, or
+        `loop_forever()`, or if you are using an external event loop using
+        `loop_read()`, `loop_write()`, and `loop_misc()`. Using loop() on it's own is
         no longer recommended.
 
         This function must be called regularly to ensure communication with the
         broker is carried out. It calls select() on the network socket to wait
         for network events. If incoming data is present it will then be
-        processed. Outgoing commands, from e.g. publish(), are normally sent
+        processed. Outgoing commands, from e.g. `publish()`, are normally sent
         immediately that their function is called, but this is not always
         possible. loop() will also attempt to send any remaining outgoing
         messages, which also includes commands that are part of the flow for
         messages with QoS>0.
 
-        timeout: The time in seconds to wait for incoming/outgoing network
+        :param int timeout: The time in seconds to wait for incoming/outgoing network
             traffic before timing out and returning.
-        max_packets: Not currently used.
 
         Returns MQTT_ERR_SUCCESS on success.
         Returns >0 on error.
@@ -1119,21 +1628,19 @@ class Client(object):
 
         return self._loop(timeout)
 
-    def _loop(self, timeout=1.0):
+    def _loop(self, timeout: float = 1.0) -> MQTTErrorCode:
         if timeout < 0.0:
             raise ValueError('Invalid timeout.')
 
-        try:
-            packet = self._out_packet.popleft()
-            self._out_packet.appendleft(packet)
+        if self.want_write():
             wlist = [self._sock]
-        except IndexError:
+        else:
             wlist = []
 
         # used to check if there are any bytes left in the (SSL) socket
         pending_bytes = 0
         if hasattr(self._sock, 'pending'):
-            pending_bytes = self._sock.pending()
+            pending_bytes = self._sock.pending()  # type: ignore[union-attr]
 
         # if bytes are pending do not wait in select
         if pending_bytes > 0:
@@ -1150,15 +1657,24 @@ class Client(object):
             socklist = select.select(rlist, wlist, [], timeout)
         except TypeError:
             # Socket isn't correct type, in likelihood connection is lost
-            return MQTT_ERR_CONN_LOST
+            # ... or we called disconnect(). In that case the socket will
+            # be closed but some loop (like loop_forever) will continue to
+            # call _loop(). We still want to break that loop by returning an
+            # rc != MQTT_ERR_SUCCESS and we don't want state to change from
+            # mqtt_cs_disconnecting.
+            if self._state not in (_ConnectionState.MQTT_CS_DISCONNECTING, _ConnectionState.MQTT_CS_DISCONNECTED):
+                self._state = _ConnectionState.MQTT_CS_CONNECTION_LOST
+            return MQTTErrorCode.MQTT_ERR_CONN_LOST
         except ValueError:
             # Can occur if we just reconnected but rlist/wlist contain a -1 for
             # some reason.
-            return MQTT_ERR_CONN_LOST
+            if self._state not in (_ConnectionState.MQTT_CS_DISCONNECTING, _ConnectionState.MQTT_CS_DISCONNECTED):
+                self._state = _ConnectionState.MQTT_CS_CONNECTION_LOST
+            return MQTTErrorCode.MQTT_ERR_CONN_LOST
         except Exception:
             # Note that KeyboardInterrupt, etc. can still terminate since they
             # are not derived from Exception
-            return MQTT_ERR_UNKNOWN
+            return MQTTErrorCode.MQTT_ERR_UNKNOWN
 
         if self._sock in socklist[0] or pending_bytes > 0:
             rc = self.loop_read()
@@ -1184,32 +1700,38 @@ class Client(object):
 
         return self.loop_misc()
 
-    def publish(self, topic, payload=None, qos=0, retain=False, properties=None):
+    def publish(
+        self,
+        topic: str,
+        payload: PayloadType = None,
+        qos: int = 0,
+        retain: bool = False,
+        properties: Properties | None = None,
+    ) -> MQTTMessageInfo:
         """Publish a message on a topic.
 
         This causes a message to be sent to the broker and subsequently from
         the broker to any clients subscribing to matching topics.
 
-        topic: The topic that the message should be published on.
-        payload: The actual message to send. If not given, or set to None a
-        zero length message will be used. Passing an int or float will result
-        in the payload being converted to a string representing that number. If
-        you wish to send a true int/float, use struct.pack() to create the
-        payload you require.
-        qos: The quality of service level to use.
-        retain: If set to true, the message will be set as the "last known
-        good"/retained message for the topic.
-        properties: (MQTT v5.0 only) the MQTT v5.0 properties to be included.
-        Use the Properties class.
+        :param str topic: The topic that the message should be published on.
+        :param payload: The actual message to send. If not given, or set to None a
+            zero length message will be used. Passing an int or float will result
+            in the payload being converted to a string representing that number. If
+            you wish to send a true int/float, use struct.pack() to create the
+            payload you require.
+        :param int qos: The quality of service level to use.
+        :param bool retain: If set to true, the message will be set as the "last known
+            good"/retained message for the topic.
+        :param Properties properties: (MQTT v5.0 only) the MQTT v5.0 properties to be included.
 
-        Returns a MQTTMessageInfo class, which can be used to determine whether
-        the message has been delivered (using info.is_published()) or to block
-        waiting for the message to be delivered (info.wait_for_publish()). The
+        Returns a `MQTTMessageInfo` class, which can be used to determine whether
+        the message has been delivered (using `is_published()`) or to block
+        waiting for the message to be delivered (`wait_for_publish()`). The
         message ID and return code of the publish() call can be found at
-        info.mid and info.rc.
+        :py:attr:`info.mid <MQTTMessage.mid>` and :py:attr:`info.rc <MQTTMessage.rc>`.
 
-        For backwards compatibility, the MQTTMessageInfo class is iterable so
-        the old construct of (rc, mid) = client.publish(...) is still valid.
+        For backwards compatibility, the `MQTTMessageInfo` class is iterable so
+        the old construct of ``(rc, mid) = client.publish(...)`` is still valid.
 
         rc is MQTT_ERR_SUCCESS to indicate success or MQTT_ERR_NO_CONN if the
         client is not currently connected.  mid is the message ID for the
@@ -1217,35 +1739,24 @@ class Client(object):
         by checking against the mid argument in the on_publish() callback if it
         is defined.
 
-        A ValueError will be raised if topic is None, has zero length or is
-        invalid (contains a wildcard), except if the MQTT version used is v5.0.
-        For v5.0, a zero length topic can be used when a Topic Alias has been set.
-
-        A ValueError will be raised if qos is not one of 0, 1 or 2, or if
-        the length of the payload is greater than 268435455 bytes."""
+        :raises ValueError: if topic is None, has zero length or is
+            invalid (contains a wildcard), except if the MQTT version used is v5.0.
+            For v5.0, a zero length topic can be used when a Topic Alias has been set.
+        :raises ValueError: if qos is not one of 0, 1 or 2
+        :raises ValueError: if the length of the payload is greater than 268435455 bytes.
+        """
         if self._protocol != MQTTv5:
             if topic is None or len(topic) == 0:
                 raise ValueError('Invalid topic.')
 
-        topic = topic.encode('utf-8')
+        topic_bytes = topic.encode('utf-8')
 
-        if self._topic_wildcard_len_check(topic) != MQTT_ERR_SUCCESS:
-            raise ValueError('Publish topic cannot contain wildcards.')
+        self._raise_for_invalid_topic(topic_bytes)
 
         if qos < 0 or qos > 2:
             raise ValueError('Invalid QoS level.')
 
-        if isinstance(payload, unicode):
-            local_payload = payload.encode('utf-8')
-        elif isinstance(payload, (bytes, bytearray)):
-            local_payload = payload
-        elif isinstance(payload, (int, float)):
-            local_payload = str(payload).encode('ascii')
-        elif payload is None:
-            local_payload = b''
-        else:
-            raise TypeError(
-                'payload must be a string, bytearray, int, float or None.')
+        local_payload = _encode_payload(payload)
 
         if len(local_payload) > 268435455:
             raise ValueError('Payload too large.')
@@ -1255,11 +1766,11 @@ class Client(object):
         if qos == 0:
             info = MQTTMessageInfo(local_mid)
             rc = self._send_publish(
-                local_mid, topic, local_payload, qos, retain, False, info, properties)
+                local_mid, topic_bytes, local_payload, qos, retain, False, info, properties)
             info.rc = rc
             return info
         else:
-            message = MQTTMessage(local_mid, topic)
+            message = MQTTMessage(local_mid, topic_bytes)
             message.timestamp = time_func()
             message.payload = local_payload
             message.qos = qos
@@ -1269,11 +1780,11 @@ class Client(object):
 
             with self._out_message_mutex:
                 if self._max_queued_messages > 0 and len(self._out_messages) >= self._max_queued_messages:
-                    message.info.rc = MQTT_ERR_QUEUE_SIZE
+                    message.info.rc = MQTTErrorCode.MQTT_ERR_QUEUE_SIZE
                     return message.info
 
                 if local_mid in self._out_messages:
-                    message.info.rc = MQTT_ERR_QUEUE_SIZE
+                    message.info.rc = MQTTErrorCode.MQTT_ERR_QUEUE_SIZE
                     return message.info
 
                 self._out_messages[message.mid] = message
@@ -1284,11 +1795,11 @@ class Client(object):
                     elif qos == 2:
                         message.state = mqtt_ms_wait_for_pubrec
 
-                    rc = self._send_publish(message.mid, topic, message.payload, message.qos, message.retain,
+                    rc = self._send_publish(message.mid, topic_bytes, message.payload, message.qos, message.retain,
                                             message.dup, message.info, message.properties)
 
                     # remove from inflight messages so it will be send after a connection is made
-                    if rc is MQTT_ERR_NO_CONN:
+                    if rc == MQTTErrorCode.MQTT_ERR_NO_CONN:
                         self._inflight_messages -= 1
                         message.state = mqtt_ms_publish
 
@@ -1296,32 +1807,35 @@ class Client(object):
                     return message.info
                 else:
                     message.state = mqtt_ms_queued
-                    message.info.rc = MQTT_ERR_SUCCESS
+                    message.info.rc = MQTTErrorCode.MQTT_ERR_SUCCESS
                     return message.info
 
-    def username_pw_set(self, username, password=None):
+    def username_pw_set(
+        self, username: str | None, password: str | None = None
+    ) -> None:
         """Set a username and optionally a password for broker authentication.
 
         Must be called before connect() to have any effect.
-        Requires a broker that supports MQTT v3.1.
+        Requires a broker that supports MQTT v3.1 or more.
 
-        username: The username to authenticate with. Need have no relationship to the client id. Must be unicode
+        :param str username: The username to authenticate with. Need have no relationship to the client id. Must be str
             [MQTT-3.1.3-11].
             Set to None to reset client back to not using username/password for broker authentication.
-        password: The password to authenticate with. Optional, set to None if not required. If it is unicode, then it
+        :param str password: The password to authenticate with. Optional, set to None if not required. If it is str, then it
             will be encoded as UTF-8.
         """
 
         # [MQTT-3.1.3-11] User name must be UTF-8 encoded string
         self._username = None if username is None else username.encode('utf-8')
-        self._password = password
-        if isinstance(self._password, unicode):
-            self._password = self._password.encode('utf-8')
+        if isinstance(password, str):
+            self._password = password.encode('utf-8')
+        else:
+            self._password = password
 
-    def enable_bridge_mode(self):
+    def enable_bridge_mode(self) -> None:
         """Sets the client in a bridge mode instead of client mode.
 
-        Must be called before connect() to have any effect.
+        Must be called before `connect()` to have any effect.
         Requires brokers that support bridge mode.
 
         Under bridge mode, the broker will identify the client as a bridge and
@@ -1334,30 +1848,50 @@ class Client(object):
         """
         self._client_mode = MQTT_BRIDGE
 
-    def is_connected(self):
+    def _connection_closed(self) -> bool:
+        """
+        Return true if the connection is closed (and not trying to be opened).
+        """
+        return (
+            self._state == _ConnectionState.MQTT_CS_NEW
+            or (self._state in (_ConnectionState.MQTT_CS_DISCONNECTING, _ConnectionState.MQTT_CS_DISCONNECTED) and self._sock is None))
+
+    def is_connected(self) -> bool:
         """Returns the current status of the connection
 
         True if connection exists
         False if connection is closed
         """
-        return self._state == mqtt_cs_connected
+        return self._state == _ConnectionState.MQTT_CS_CONNECTED
 
-    def disconnect(self, reasoncode=None, properties=None):
+    def disconnect(
+        self,
+        reasoncode: ReasonCode | None = None,
+        properties: Properties | None = None,
+    ) -> MQTTErrorCode:
         """Disconnect a connected client from the broker.
-        reasoncode: (MQTT v5.0 only) a ReasonCodes instance setting the MQTT v5.0
-        reasoncode to be sent with the disconnect.  It is optional, the receiver
-        then assuming that 0 (success) is the value.
-        properties: (MQTT v5.0 only) a Properties instance setting the MQTT v5.0 properties
-        to be included. Optional - if not set, no properties are sent.
-        """
-        self._state = mqtt_cs_disconnecting
 
+        :param ReasonCode reasoncode: (MQTT v5.0 only) a ReasonCode instance setting the MQTT v5.0
+            reasoncode to be sent with the disconnect packet. It is optional, the receiver
+            then assuming that 0 (success) is the value.
+        :param Properties properties: (MQTT v5.0 only) a Properties instance setting the MQTT v5.0 properties
+            to be included. Optional - if not set, no properties are sent.
+        """
         if self._sock is None:
+            self._state = _ConnectionState.MQTT_CS_DISCONNECTED
             return MQTT_ERR_NO_CONN
+        else:
+            self._state = _ConnectionState.MQTT_CS_DISCONNECTING
 
         return self._send_disconnect(reasoncode, properties)
 
-    def subscribe(self, topic, qos=0, options=None, properties=None):
+    def subscribe(
+        self,
+        topic: str | tuple[str, int] | tuple[str, SubscribeOptions] | list[tuple[str, int]] | list[tuple[str, SubscribeOptions]],
+        qos: int = 0,
+        options: SubscribeOptions | None = None,
+        properties: Properties | None = None,
+    ) -> tuple[MQTTErrorCode, int | None]:
         """Subscribe the client to one or more topics.
 
         This function may be called in three different ways (and a further three for MQTT v5.0):
@@ -1366,40 +1900,40 @@ class Client(object):
         -------------------------
         e.g. subscribe("my/topic", 2)
 
-        topic: A string specifying the subscription topic to subscribe to.
-        qos: The desired quality of service level for the subscription.
-             Defaults to 0.
-        options and properties: Not used.
+        :topic: A string specifying the subscription topic to subscribe to.
+        :qos: The desired quality of service level for the subscription.
+            Defaults to 0.
+        :options and properties: Not used.
 
         Simple string and subscribe options (MQTT v5.0 only)
         ----------------------------------------------------
         e.g. subscribe("my/topic", options=SubscribeOptions(qos=2))
 
-        topic: A string specifying the subscription topic to subscribe to.
-        qos: Not used.
-        options: The MQTT v5.0 subscribe options.
-        properties: a Properties instance setting the MQTT v5.0 properties
-        to be included. Optional - if not set, no properties are sent.
+        :topic: A string specifying the subscription topic to subscribe to.
+        :qos: Not used.
+        :options: The MQTT v5.0 subscribe options.
+        :properties: a Properties instance setting the MQTT v5.0 properties
+            to be included. Optional - if not set, no properties are sent.
 
         String and integer tuple
         ------------------------
         e.g. subscribe(("my/topic", 1))
 
-        topic: A tuple of (topic, qos). Both topic and qos must be present in
+        :topic: A tuple of (topic, qos). Both topic and qos must be present in
                the tuple.
-        qos and options: Not used.
-        properties: Only used for MQTT v5.0.  A Properties instance setting the
-        MQTT v5.0 properties. Optional - if not set, no properties are sent.
+        :qos and options: Not used.
+        :properties: Only used for MQTT v5.0.  A Properties instance setting the
+            MQTT v5.0 properties. Optional - if not set, no properties are sent.
 
         String and subscribe options tuple (MQTT v5.0 only)
         ---------------------------------------------------
         e.g. subscribe(("my/topic", SubscribeOptions(qos=1)))
 
-        topic: A tuple of (topic, SubscribeOptions). Both topic and subscribe
+        :topic: A tuple of (topic, SubscribeOptions). Both topic and subscribe
                 options must be present in the tuple.
-        qos and options: Not used.
-        properties: a Properties instance setting the MQTT v5.0 properties
-        to be included. Optional - if not set, no properties are sent.
+        :qos and options: Not used.
+        :properties: a Properties instance setting the MQTT v5.0 properties
+            to be included. Optional - if not set, no properties are sent.
 
         List of string and integer tuples
         ---------------------------------
@@ -1409,9 +1943,9 @@ class Client(object):
         command, which is more efficient than using multiple calls to
         subscribe().
 
-        topic: A list of tuple of format (topic, qos). Both topic and qos must
+        :topic: A list of tuple of format (topic, qos). Both topic and qos must
                be present in all of the tuples.
-        qos, options and properties: Not used.
+        :qos, options and properties: Not used.
 
         List of string and subscribe option tuples (MQTT v5.0 only)
         -----------------------------------------------------------
@@ -1421,11 +1955,11 @@ class Client(object):
         command, which is more efficient than using multiple calls to
         subscribe().
 
-        topic: A list of tuple of format (topic, SubscribeOptions). Both topic and subscribe
+        :topic: A list of tuple of format (topic, SubscribeOptions). Both topic and subscribe
                 options must be present in all of the tuples.
-        qos and options: Not used.
-        properties: a Properties instance setting the MQTT v5.0 properties
-        to be included. Optional - if not set, no properties are sent.
+        :qos and options: Not used.
+        :properties: a Properties instance setting the MQTT v5.0 properties
+            to be included. Optional - if not set, no properties are sent.
 
         The function returns a tuple (result, mid), where result is
         MQTT_ERR_SUCCESS to indicate success or (MQTT_ERR_NO_CONN, None) if the
@@ -1441,14 +1975,14 @@ class Client(object):
 
         if isinstance(topic, tuple):
             if self._protocol == MQTTv5:
-                topic, options = topic
+                topic, options = topic  # type: ignore
                 if not isinstance(options, SubscribeOptions):
                     raise ValueError(
                         'Subscribe options must be instance of SubscribeOptions class.')
             else:
-                topic, qos = topic
+                topic, qos = topic  # type: ignore
 
-        if isinstance(topic, basestring):
+        if isinstance(topic, (bytes, str)):
             if qos < 0 or qos > 2:
                 raise ValueError('Invalid QoS level.')
             if self._protocol == MQTTv5:
@@ -1465,8 +1999,10 @@ class Client(object):
             else:
                 if topic is None or len(topic) == 0:
                     raise ValueError('Invalid topic.')
-                topic_qos_list = [(topic.encode('utf-8'), qos)]
+                topic_qos_list = [(topic.encode('utf-8'), qos)]  # type: ignore
         elif isinstance(topic, list):
+            if len(topic) == 0:
+                raise ValueError('Empty topic list')
             topic_qos_list = []
             if self._protocol == MQTTv5:
                 for t, o in topic:
@@ -1478,11 +2014,11 @@ class Client(object):
                     topic_qos_list.append((t.encode('utf-8'), o))
             else:
                 for t, q in topic:
-                    if q < 0 or q > 2:
+                    if isinstance(q, SubscribeOptions) or q < 0 or q > 2:
                         raise ValueError('Invalid QoS level.')
-                    if t is None or len(t) == 0 or not isinstance(t, basestring):
+                    if t is None or len(t) == 0 or not isinstance(t, (bytes, str)):
                         raise ValueError('Invalid topic.')
-                    topic_qos_list.append((t.encode('utf-8'), q))
+                    topic_qos_list.append((t.encode('utf-8'), q))  # type: ignore
 
         if topic_qos_list is None:
             raise ValueError("No topic specified, or incorrect topic type.")
@@ -1495,13 +2031,15 @@ class Client(object):
 
         return self._send_subscribe(False, topic_qos_list, properties)
 
-    def unsubscribe(self, topic, properties=None):
+    def unsubscribe(
+        self, topic: str, properties: Properties | None = None
+    ) -> tuple[MQTTErrorCode, int | None]:
         """Unsubscribe the client from one or more topics.
 
-        topic: A single string, or list of strings that are the subscription
-               topics to unsubscribe from.
-        properties: (MQTT v5.0 only) a Properties instance setting the MQTT v5.0 properties
-        to be included. Optional - if not set, no properties are sent.
+        :param topic: A single string, or list of strings that are the subscription
+            topics to unsubscribe from.
+        :param properties: (MQTT v5.0 only) a Properties instance setting the MQTT v5.0 properties
+            to be included. Optional - if not set, no properties are sent.
 
         Returns a tuple (result, mid), where result is MQTT_ERR_SUCCESS
         to indicate success or (MQTT_ERR_NO_CONN, None) if the client is not
@@ -1510,20 +2048,20 @@ class Client(object):
         used to track the unsubscribe request by checking against the mid
         argument in the on_unsubscribe() callback if it is defined.
 
-        Raises a ValueError if topic is None or has zero string length, or is
-        not a string or list.
+        :raises ValueError: if topic is None or has zero string length, or is
+            not a string or list.
         """
         topic_list = None
         if topic is None:
             raise ValueError('Invalid topic.')
-        if isinstance(topic, basestring):
+        if isinstance(topic, (bytes, str)):
             if len(topic) == 0:
                 raise ValueError('Invalid topic.')
             topic_list = [topic.encode('utf-8')]
         elif isinstance(topic, list):
             topic_list = []
             for t in topic:
-                if len(t) == 0 or not isinstance(t, basestring):
+                if len(t) == 0 or not isinstance(t, (bytes, str)):
                     raise ValueError('Invalid topic.')
                 topic_list.append(t.encode('utf-8'))
 
@@ -1531,20 +2069,20 @@ class Client(object):
             raise ValueError("No topic specified, or incorrect topic type.")
 
         if self._sock is None:
-            return (MQTT_ERR_NO_CONN, None)
+            return (MQTTErrorCode.MQTT_ERR_NO_CONN, None)
 
         return self._send_unsubscribe(False, topic_list, properties)
 
-    def loop_read(self, max_packets=1):
-        """Process read network events. Use in place of calling loop() if you
+    def loop_read(self, max_packets: int = 1) -> MQTTErrorCode:
+        """Process read network events. Use in place of calling `loop()` if you
         wish to handle your client reads as part of your own application.
 
-        Use socket() to obtain the client socket to call select() or equivalent
+        Use `socket()` to obtain the client socket to call select() or equivalent
         on.
 
-        Do not use if you are using the threaded interface loop_start()."""
+        Do not use if you are using `loop_start()` or `loop_forever()`."""
         if self._sock is None:
-            return MQTT_ERR_NO_CONN
+            return MQTTErrorCode.MQTT_ERR_NO_CONN
 
         max_packets = len(self._out_messages) + len(self._in_messages)
         if max_packets < 1:
@@ -1552,59 +2090,54 @@ class Client(object):
 
         for _ in range(0, max_packets):
             if self._sock is None:
-                return MQTT_ERR_NO_CONN
+                return MQTTErrorCode.MQTT_ERR_NO_CONN
             rc = self._packet_read()
             if rc > 0:
                 return self._loop_rc_handle(rc)
-            elif rc == MQTT_ERR_AGAIN:
-                return MQTT_ERR_SUCCESS
-        return MQTT_ERR_SUCCESS
+            elif rc == MQTTErrorCode.MQTT_ERR_AGAIN:
+                return MQTTErrorCode.MQTT_ERR_SUCCESS
+        return MQTTErrorCode.MQTT_ERR_SUCCESS
 
-    def loop_write(self, max_packets=1):
-        """Process write network events. Use in place of calling loop() if you
+    def loop_write(self) -> MQTTErrorCode:
+        """Process write network events. Use in place of calling `loop()` if you
         wish to handle your client writes as part of your own application.
 
-        Use socket() to obtain the client socket to call select() or equivalent
+        Use `socket()` to obtain the client socket to call select() or equivalent
         on.
 
-        Use want_write() to determine if there is data waiting to be written.
+        Use `want_write()` to determine if there is data waiting to be written.
 
-        Do not use if you are using the threaded interface loop_start()."""
+        Do not use if you are using `loop_start()` or `loop_forever()`."""
         if self._sock is None:
-            return MQTT_ERR_NO_CONN
+            return MQTTErrorCode.MQTT_ERR_NO_CONN
 
         try:
             rc = self._packet_write()
-            if rc == MQTT_ERR_AGAIN:
-                return MQTT_ERR_SUCCESS
+            if rc == MQTTErrorCode.MQTT_ERR_AGAIN:
+                return MQTTErrorCode.MQTT_ERR_SUCCESS
             elif rc > 0:
                 return self._loop_rc_handle(rc)
             else:
-                return MQTT_ERR_SUCCESS
+                return MQTTErrorCode.MQTT_ERR_SUCCESS
         finally:
             if self.want_write():
                 self._call_socket_register_write()
             else:
                 self._call_socket_unregister_write()
 
-    def want_write(self):
+    def want_write(self) -> bool:
         """Call to determine if there is network data waiting to be written.
-        Useful if you are calling select() yourself rather than using loop().
+        Useful if you are calling select() yourself rather than using `loop()`, `loop_start()` or `loop_forever()`.
         """
-        try:
-            packet = self._out_packet.popleft()
-            self._out_packet.appendleft(packet)
-            return True
-        except IndexError:
-            return False
+        return len(self._out_packet) > 0
 
-    def loop_misc(self):
-        """Process miscellaneous network events. Use in place of calling loop() if you
+    def loop_misc(self) -> MQTTErrorCode:
+        """Process miscellaneous network events. Use in place of calling `loop()` if you
         wish to call select() or equivalent on.
 
-        Do not use if you are using the threaded interface loop_start()."""
+        Do not use if you are using `loop_start()` or `loop_forever()`."""
         if self._sock is None:
-            return MQTT_ERR_NO_CONN
+            return MQTTErrorCode.MQTT_ERR_NO_CONN
 
         now = time_func()
         self._check_keepalive()
@@ -1614,61 +2147,72 @@ class Client(object):
             # This hasn't happened in the keepalive time so we should disconnect.
             self._sock_close()
 
-            if self._state == mqtt_cs_disconnecting:
-                rc = MQTT_ERR_SUCCESS
+            if self._state in (_ConnectionState.MQTT_CS_DISCONNECTING, _ConnectionState.MQTT_CS_DISCONNECTED):
+                self._state = _ConnectionState.MQTT_CS_DISCONNECTED
+                rc = MQTTErrorCode.MQTT_ERR_SUCCESS
             else:
-                rc = MQTT_ERR_KEEPALIVE
+                self._state = _ConnectionState.MQTT_CS_CONNECTION_LOST
+                rc = MQTTErrorCode.MQTT_ERR_KEEPALIVE
 
-            self._do_on_disconnect(rc)
+            self._do_on_disconnect(
+                packet_from_broker=False,
+                v1_rc=rc,
+            )
 
-            return MQTT_ERR_CONN_LOST
+            return MQTTErrorCode.MQTT_ERR_CONN_LOST
 
-        return MQTT_ERR_SUCCESS
+        return MQTTErrorCode.MQTT_ERR_SUCCESS
 
-    def max_inflight_messages_set(self, inflight):
+    def max_inflight_messages_set(self, inflight: int) -> None:
         """Set the maximum number of messages with QoS>0 that can be part way
         through their network flow at once. Defaults to 20."""
-        if inflight < 0:
-            raise ValueError('Invalid inflight.')
-        self._max_inflight_messages = inflight
+        self.max_inflight_messages = inflight
 
-    def max_queued_messages_set(self, queue_size):
+    def max_queued_messages_set(self, queue_size: int) -> Client:
         """Set the maximum number of messages in the outgoing message queue.
         0 means unlimited."""
-        if queue_size < 0:
-            raise ValueError('Invalid queue size.')
         if not isinstance(queue_size, int):
             raise ValueError('Invalid type of queue size.')
-        self._max_queued_messages = queue_size
+        self.max_queued_messages = queue_size
         return self
 
-    def message_retry_set(self, retry):
-        """No longer used, remove in version 2.0"""
-        pass
-
-    def user_data_set(self, userdata):
+    def user_data_set(self, userdata: Any) -> None:
         """Set the user data variable passed to callbacks. May be any data type."""
         self._userdata = userdata
 
-    def will_set(self, topic, payload=None, qos=0, retain=False, properties=None):
+    def user_data_get(self) -> Any:
+        """Get the user data variable passed to callbacks. May be any data type."""
+        return self._userdata
+
+    def will_set(
+        self,
+        topic: str,
+        payload: PayloadType = None,
+        qos: int = 0,
+        retain: bool = False,
+        properties: Properties | None = None,
+    ) -> None:
         """Set a Will to be sent by the broker in case the client disconnects unexpectedly.
 
         This must be called before connect() to have any effect.
 
-        topic: The topic that the will message should be published on.
-        payload: The message to send as a will. If not given, or set to None a
-        zero length message will be used as the will. Passing an int or float
-        will result in the payload being converted to a string representing
-        that number. If you wish to send a true int/float, use struct.pack() to
-        create the payload you require.
-        qos: The quality of service level to use for the will.
-        retain: If set to true, the will message will be set as the "last known
-        good"/retained message for the topic.
-        properties: (MQTT v5.0 only) a Properties instance setting the MQTT v5.0 properties
-        to be included with the will message. Optional - if not set, no properties are sent.
+        :param str topic: The topic that the will message should be published on.
+        :param payload: The message to send as a will. If not given, or set to None a
+            zero length message will be used as the will. Passing an int or float
+            will result in the payload being converted to a string representing
+            that number. If you wish to send a true int/float, use struct.pack() to
+            create the payload you require.
+        :param int qos: The quality of service level to use for the will.
+        :param bool retain: If set to true, the will message will be set as the "last known
+            good"/retained message for the topic.
+        :param Properties properties: (MQTT v5.0 only) the MQTT v5.0 properties
+            to be included with the will message. Optional - if not set, no properties are sent.
 
-        Raises a ValueError if qos is not 0, 1 or 2, or if topic is None or has
-        zero string length.
+        :raises ValueError: if qos is not 0, 1 or 2, or if topic is None or has
+            zero string length.
+
+        See `will_clear` to clear will. Note that will are NOT send if the client disconnect cleanly
+        for example by calling `disconnect()`.
         """
         if topic is None or len(topic) == 0:
             raise ValueError('Invalid topic.')
@@ -1676,30 +2220,19 @@ class Client(object):
         if qos < 0 or qos > 2:
             raise ValueError('Invalid QoS level.')
 
-        if properties != None and not isinstance(properties, Properties):
+        if properties and not isinstance(properties, Properties):
             raise ValueError(
                 "The properties argument must be an instance of the Properties class.")
 
-        if isinstance(payload, unicode):
-            self._will_payload = payload.encode('utf-8')
-        elif isinstance(payload, (bytes, bytearray)):
-            self._will_payload = payload
-        elif isinstance(payload, (int, float)):
-            self._will_payload = str(payload).encode('ascii')
-        elif payload is None:
-            self._will_payload = b""
-        else:
-            raise TypeError(
-                'payload must be a string, bytearray, int, float or None.')
-
+        self._will_payload = _encode_payload(payload)
         self._will = True
         self._will_topic = topic.encode('utf-8')
         self._will_qos = qos
         self._will_retain = retain
         self._will_properties = properties
 
-    def will_clear(self):
-        """ Removes a will that was previously configured with will_set().
+    def will_clear(self) -> None:
+        """ Removes a will that was previously configured with `will_set()`.
 
         Must be called before connect() to have any effect."""
         self._will = False
@@ -1708,27 +2241,29 @@ class Client(object):
         self._will_qos = 0
         self._will_retain = False
 
-    def socket(self):
+    def socket(self) -> SocketLike | None:
         """Return the socket or ssl object for this client."""
         return self._sock
 
-    def loop_forever(self, timeout=1.0, max_packets=1, retry_first_connection=False):
+    def loop_forever(
+        self,
+        timeout: float = 1.0,
+        retry_first_connection: bool = False,
+    ) -> MQTTErrorCode:
         """This function calls the network loop functions for you in an
         infinite blocking loop. It is useful for the case where you only want
         to run the MQTT client loop in your program.
 
         loop_forever() will handle reconnecting for you if reconnect_on_failure is
-        true (this is the default behavior). If you call disconnect() in a callback
+        true (this is the default behavior). If you call `disconnect()` in a callback
         it will return.
 
-
-        timeout: The time in seconds to wait for incoming/outgoing network
+        :param int timeout: The time in seconds to wait for incoming/outgoing network
           traffic before timing out and returning.
-        max_packets: Not currently used.
-        retry_first_connection: Should the first connection attempt be retried on failure.
+        :param bool retry_first_connection: Should the first connection attempt be retried on failure.
           This is independent of the reconnect_on_failure setting.
 
-        Raises OSError/WebsocketConnectionError on first connection failures unless retry_first_connection=True
+        :raises OSError: if the first connection fail unless retry_first_connection=True
         """
 
         run = True
@@ -1737,10 +2272,10 @@ class Client(object):
             if self._thread_terminate is True:
                 break
 
-            if self._state == mqtt_cs_connect_async:
+            if self._state == _ConnectionState.MQTT_CS_CONNECT_ASYNC:
                 try:
                     self.reconnect()
-                except (OSError, WebsocketConnectionError):
+                except OSError:
                     self._handle_on_connect_fail()
                     if not retry_first_connection:
                         raise
@@ -1751,8 +2286,8 @@ class Client(object):
                 break
 
         while run:
-            rc = MQTT_ERR_SUCCESS
-            while rc == MQTT_ERR_SUCCESS:
+            rc = MQTTErrorCode.MQTT_ERR_SUCCESS
+            while rc == MQTTErrorCode.MQTT_ERR_SUCCESS:
                 rc = self._loop(timeout)
                 # We don't need to worry about locking here, because we've
                 # either called loop_forever() when in single threaded mode, or
@@ -1761,11 +2296,15 @@ class Client(object):
                 if (self._thread_terminate is True
                     and len(self._out_packet) == 0
                         and len(self._out_messages) == 0):
-                    rc = 1
+                    rc = MQTTErrorCode.MQTT_ERR_NOMEM
                     run = False
 
-            def should_exit():
-                return self._state == mqtt_cs_disconnecting or run is False or self._thread_terminate is True
+            def should_exit() -> bool:
+                return (
+                    self._state in (_ConnectionState.MQTT_CS_DISCONNECTING, _ConnectionState.MQTT_CS_DISCONNECTED) or
+                    run is False or  # noqa: B023 (uses the run variable from the outer scope on purpose)
+                    self._thread_terminate is True
+                )
 
             if should_exit() or not self._reconnect_on_failure:
                 run = False
@@ -1777,99 +2316,153 @@ class Client(object):
                 else:
                     try:
                         self.reconnect()
-                    except (OSError, WebsocketConnectionError):
+                    except OSError:
                         self._handle_on_connect_fail()
                         self._easy_log(
                             MQTT_LOG_DEBUG, "Connection failed, retrying")
 
         return rc
 
-    def loop_start(self):
+    def loop_start(self) -> MQTTErrorCode:
         """This is part of the threaded client interface. Call this once to
         start a new thread to process network traffic. This provides an
-        alternative to repeatedly calling loop() yourself.
+        alternative to repeatedly calling `loop()` yourself.
+
+        Under the hood, this will call `loop_forever` in a thread, which means that
+        the thread will terminate if you call `disconnect()`
         """
         if self._thread is not None:
-            return MQTT_ERR_INVAL
+            return MQTTErrorCode.MQTT_ERR_INVAL
 
         self._sockpairR, self._sockpairW = _socketpair_compat()
         self._thread_terminate = False
-        self._thread = threading.Thread(target=self._thread_main)
+        self._thread = threading.Thread(target=self._thread_main, name=f"paho-mqtt-client-{self._client_id.decode()}")
         self._thread.daemon = True
         self._thread.start()
 
-    def loop_stop(self, force=False):
+        return MQTTErrorCode.MQTT_ERR_SUCCESS
+
+    def loop_stop(self) -> MQTTErrorCode:
         """This is part of the threaded client interface. Call this once to
-        stop the network thread previously created with loop_start(). This call
+        stop the network thread previously created with `loop_start()`. This call
         will block until the network thread finishes.
 
-        The force parameter is currently ignored.
+        This don't guarantee that publish packet are sent, use `wait_for_publish` or
+        `on_publish` to ensure `publish` are sent.
         """
         if self._thread is None:
-            return MQTT_ERR_INVAL
+            return MQTTErrorCode.MQTT_ERR_INVAL
 
         self._thread_terminate = True
         if threading.current_thread() != self._thread:
             self._thread.join()
             self._thread = None
 
+        return MQTTErrorCode.MQTT_ERR_SUCCESS
+
     @property
-    def on_log(self):
-        """If implemented, called when the client has log information.
-        Defined to allow debugging."""
+    def callback_api_version(self) -> CallbackAPIVersion:
+        """
+        Return the callback API version used for user-callback. See docstring for
+        each user-callback (`on_connect`, `on_publish`, ...) for details.
+
+        This property is read-only.
+        """
+        return self._callback_api_version
+
+    @property
+    def on_log(self) -> CallbackOnLog | None:
+        """The callback called when the client has log information.
+        Defined to allow debugging.
+
+        Expected signature is::
+
+            log_callback(client, userdata, level, buf)
+
+        :param Client client: the client instance for this callback
+        :param userdata: the private user data as set in Client() or user_data_set()
+        :param int level: gives the severity of the message and will be one of
+                    MQTT_LOG_INFO, MQTT_LOG_NOTICE, MQTT_LOG_WARNING,
+                    MQTT_LOG_ERR, and MQTT_LOG_DEBUG.
+        :param str buf: the message itself
+
+        Decorator: @client.log_callback() (``client`` is the name of the
+            instance which this callback is being attached to)
+        """
         return self._on_log
 
     @on_log.setter
-    def on_log(self, func):
-        """ Define the logging callback implementation.
-
-        Expected signature is:
-            log_callback(client, userdata, level, buf)
-
-        client:     the client instance for this callback
-        userdata:   the private user data as set in Client() or userdata_set()
-        level:      gives the severity of the message and will be one of
-                    MQTT_LOG_INFO, MQTT_LOG_NOTICE, MQTT_LOG_WARNING,
-                    MQTT_LOG_ERR, and MQTT_LOG_DEBUG.
-        buf:        the message itself
-
-        Decorator: @client.log_callback() (```client``` is the name of the
-            instance which this callback is being attached to)
-        """
+    def on_log(self, func: CallbackOnLog | None) -> None:
         self._on_log = func
 
-    def log_callback(self):
-        def decorator(func):
+    def log_callback(self) -> Callable[[CallbackOnLog], CallbackOnLog]:
+        def decorator(func: CallbackOnLog) -> CallbackOnLog:
             self.on_log = func
             return func
         return decorator
 
     @property
-    def on_connect(self):
-        """If implemented, called when the broker responds to our connection
-        request."""
-        return self._on_connect
+    def on_pre_connect(self) -> CallbackOnPreConnect | None:
+        """The callback called immediately prior to the connection is made
+        request.
 
-    @on_connect.setter
-    def on_connect(self, func):
-        """ Define the connect callback implementation.
+        Expected signature (for all callback API version)::
 
-        Expected signature for MQTT v3.1 and v3.1.1 is:
-            connect_callback(client, userdata, flags, rc)
+            connect_callback(client, userdata)
 
-        and for MQTT v5.0:
-            connect_callback(client, userdata, flags, reasonCode, properties)
+        :parama Client client: the client instance for this callback
+        :parama userdata: the private user data as set in Client() or user_data_set()
 
-        client:     the client instance for this callback
-        userdata:   the private user data as set in Client() or userdata_set()
-        flags:      response flags sent by the broker
-        rc:         the connection result
-        reasonCode: the MQTT v5.0 reason code: an instance of the ReasonCode class.
-                    ReasonCode may be compared to integer.
-        properties: the MQTT v5.0 properties returned from the broker.  An instance
-                    of the Properties class.
-                    For MQTT v3.1 and v3.1.1 properties is not provided but for compatibility
-                    with MQTT v5.0, we recommend adding properties=None.
+        Decorator: @client.pre_connect_callback() (``client`` is the name of the
+            instance which this callback is being attached to)
+
+        """
+        return self._on_pre_connect
+
+    @on_pre_connect.setter
+    def on_pre_connect(self, func: CallbackOnPreConnect | None) -> None:
+        with self._callback_mutex:
+            self._on_pre_connect = func
+
+    def pre_connect_callback(
+        self,
+    ) -> Callable[[CallbackOnPreConnect], CallbackOnPreConnect]:
+        def decorator(func: CallbackOnPreConnect) -> CallbackOnPreConnect:
+            self.on_pre_connect = func
+            return func
+        return decorator
+
+    @property
+    def on_connect(self) -> CallbackOnConnect | None:
+        """The callback called when the broker reponds to our connection request.
+
+        Expected signature for callback API version 2::
+
+            connect_callback(client, userdata, connect_flags, reason_code, properties)
+
+        Expected signature for callback API version 1 change with MQTT protocol version:
+            * For MQTT v3.1 and v3.1.1 it's::
+
+                connect_callback(client, userdata, flags, rc)
+
+            * For MQTT it's v5.0::
+
+                connect_callback(client, userdata, flags, reason_code, properties)
+
+
+        :param Client client: the client instance for this callback
+        :param userdata: the private user data as set in Client() or user_data_set()
+        :param ConnectFlags connect_flags: the flags for this connection
+        :param ReasonCode reason_code: the connection reason code received from the broken.
+                       In MQTT v5.0 it's the reason code defined by the standard.
+                       In MQTT v3, we convert return code to a reason code, see
+                       `convert_connack_rc_to_reason_code()`.
+                       `ReasonCode` may be compared to integer.
+        :param Properties properties: the MQTT v5.0 properties received from the broker.
+                       For MQTT v3.1 and v3.1.1 properties is not provided and an empty Properties
+                       object is always used.
+        :param dict flags: response flags sent by the broker
+        :param int rc: the connection result, should have a value of `ConnackCode`
 
         flags is a dict that contains response flags from the broker:
             flags['session present'] - this flag is useful for clients that are
@@ -1879,272 +2472,339 @@ class Client(object):
                 session information for the client. If 1, the session still exists.
 
         The value of rc indicates success or not:
-            0: Connection successful
-            1: Connection refused - incorrect protocol version
-            2: Connection refused - invalid client identifier
-            3: Connection refused - server unavailable
-            4: Connection refused - bad username or password
-            5: Connection refused - not authorised
-            6-255: Currently unused.
+            - 0: Connection successful
+            - 1: Connection refused - incorrect protocol version
+            - 2: Connection refused - invalid client identifier
+            - 3: Connection refused - server unavailable
+            - 4: Connection refused - bad username or password
+            - 5: Connection refused - not authorised
+            - 6-255: Currently unused.
 
-        Decorator: @client.connect_callback() (```client``` is the name of the
+        Decorator: @client.connect_callback() (``client`` is the name of the
             instance which this callback is being attached to)
-
         """
+        return self._on_connect
+
+    @on_connect.setter
+    def on_connect(self, func: CallbackOnConnect | None) -> None:
         with self._callback_mutex:
             self._on_connect = func
 
-    def connect_callback(self):
-        def decorator(func):
+    def connect_callback(
+        self,
+    ) -> Callable[[CallbackOnConnect], CallbackOnConnect]:
+        def decorator(func: CallbackOnConnect) -> CallbackOnConnect:
             self.on_connect = func
             return func
         return decorator
 
     @property
-    def on_connect_fail(self):
-        """If implemented, called when the client failed to connect
-        to the broker."""
+    def on_connect_fail(self) -> CallbackOnConnectFail | None:
+        """The callback called when the client failed to connect
+        to the broker.
+
+        Expected signature is (for all callback_api_version)::
+
+            connect_fail_callback(client, userdata)
+
+        :param Client client: the client instance for this callback
+        :parama userdata: the private user data as set in Client() or user_data_set()
+
+        Decorator: @client.connect_fail_callback() (``client`` is the name of the
+            instance which this callback is being attached to)
+        """
         return self._on_connect_fail
 
     @on_connect_fail.setter
-    def on_connect_fail(self, func):
-        """ Define the connection failure callback implementation
-
-        Expected signature is:
-            on_connect_fail(client, userdata)
-
-        client:     the client instance for this callback
-        userdata:   the private user data as set in Client() or userdata_set()
-
-        Decorator: @client.connect_fail_callback() (```client``` is the name of the
-            instance which this callback is being attached to)
-
-        """
+    def on_connect_fail(self, func: CallbackOnConnectFail | None) -> None:
         with self._callback_mutex:
             self._on_connect_fail = func
 
-    def connect_fail_callback(self):
-        def decorator(func):
+    def connect_fail_callback(
+        self,
+    ) -> Callable[[CallbackOnConnectFail], CallbackOnConnectFail]:
+        def decorator(func: CallbackOnConnectFail) -> CallbackOnConnectFail:
             self.on_connect_fail = func
             return func
         return decorator
 
     @property
-    def on_subscribe(self):
-        """If implemented, called when the broker responds to a subscribe
-        request."""
+    def on_subscribe(self) -> CallbackOnSubscribe | None:
+        """The callback called when the broker responds to a subscribe
+        request.
+
+        Expected signature for callback API version 2::
+
+            subscribe_callback(client, userdata, mid, reason_code_list, properties)
+
+        Expected signature for callback API version 1 change with MQTT protocol version:
+            * For MQTT v3.1 and v3.1.1 it's::
+
+                subscribe_callback(client, userdata, mid, granted_qos)
+
+            * For MQTT v5.0 it's::
+
+                subscribe_callback(client, userdata, mid, reason_code_list, properties)
+
+        :param Client client: the client instance for this callback
+        :param userdata: the private user data as set in Client() or user_data_set()
+        :param int mid: matches the mid variable returned from the corresponding
+                          subscribe() call.
+        :param list[ReasonCode] reason_code_list: reason codes received from the broker for each subscription.
+                          In MQTT v5.0 it's the reason code defined by the standard.
+                          In MQTT v3, we convert granted QoS to a reason code.
+                          It's a list of ReasonCode instances.
+        :param Properties properties: the MQTT v5.0 properties received from the broker.
+                          For MQTT v3.1 and v3.1.1 properties is not provided and an empty Properties
+                          object is always used.
+        :param list[int] granted_qos: list of integers that give the QoS level the broker has
+                          granted for each of the different subscription requests.
+
+        Decorator: @client.subscribe_callback() (``client`` is the name of the
+            instance which this callback is being attached to)
+        """
         return self._on_subscribe
 
     @on_subscribe.setter
-    def on_subscribe(self, func):
-        """ Define the subscribe callback implementation.
-
-        Expected signature for MQTT v3.1.1 and v3.1 is:
-            subscribe_callback(client, userdata, mid, granted_qos)
-
-        and for MQTT v5.0:
-            subscribe_callback(client, userdata, mid, reasonCodes, properties)
-
-        client:         the client instance for this callback
-        userdata:       the private user data as set in Client() or userdata_set()
-        mid:            matches the mid variable returned from the corresponding
-                        subscribe() call.
-        granted_qos:    list of integers that give the QoS level the broker has
-                        granted for each of the different subscription requests.
-        reasonCodes:    the MQTT v5.0 reason codes received from the broker for each
-                        subscription.  A list of ReasonCodes instances.
-        properties:     the MQTT v5.0 properties received from the broker.  A
-                        list of Properties class instances.
-
-        Decorator: @client.subscribe_callback() (```client``` is the name of the
-            instance which this callback is being attached to)
-        """
+    def on_subscribe(self, func: CallbackOnSubscribe | None) -> None:
         with self._callback_mutex:
             self._on_subscribe = func
 
-    def subscribe_callback(self):
-        def decorator(func):
+    def subscribe_callback(
+        self,
+    ) -> Callable[[CallbackOnSubscribe], CallbackOnSubscribe]:
+        def decorator(func: CallbackOnSubscribe) -> CallbackOnSubscribe:
             self.on_subscribe = func
             return func
         return decorator
 
     @property
-    def on_message(self):
-        """If implemented, called when a message has been received on a topic
+    def on_message(self) -> CallbackOnMessage | None:
+        """The callback called when a message has been received on a topic
         that the client subscribes to.
 
-        This callback will be called for every message received. Use
-        message_callback_add() to define multiple callbacks that will be called
-        for specific topic filters."""
+        This callback will be called for every message received unless a
+        `message_callback_add()` matched the message.
+
+        Expected signature is (for all callback API version):
+            message_callback(client, userdata, message)
+
+        :param Client client: the client instance for this callback
+        :param userdata: the private user data as set in Client() or user_data_set()
+        :param MQTTMessage message: the received message.
+                    This is a class with members topic, payload, qos, retain.
+
+        Decorator: @client.message_callback() (``client`` is the name of the
+            instance which this callback is being attached to)
+        """
         return self._on_message
 
     @on_message.setter
-    def on_message(self, func):
-        """ Define the message received callback implementation.
-
-        Expected signature is:
-            on_message_callback(client, userdata, message)
-
-        client:     the client instance for this callback
-        userdata:   the private user data as set in Client() or userdata_set()
-        message:    an instance of MQTTMessage.
-                    This is a class with members topic, payload, qos, retain.
-
-        Decorator: @client.message_callback() (```client``` is the name of the
-            instance which this callback is being attached to)
-
-        """
+    def on_message(self, func: CallbackOnMessage | None) -> None:
         with self._callback_mutex:
             self._on_message = func
 
-    def message_callback(self):
-        def decorator(func):
+    def message_callback(
+        self,
+    ) -> Callable[[CallbackOnMessage], CallbackOnMessage]:
+        def decorator(func: CallbackOnMessage) -> CallbackOnMessage:
             self.on_message = func
             return func
         return decorator
 
     @property
-    def on_publish(self):
-        """If implemented, called when a message that was to be sent using the
-        publish() call has completed transmission to the broker.
+    def on_publish(self) -> CallbackOnPublish | None:
+        """The callback called when a message that was to be sent using the
+        `publish()` call has completed transmission to the broker.
 
         For messages with QoS levels 1 and 2, this means that the appropriate
         handshakes have completed. For QoS 0, this simply means that the message
         has left the client.
-        This callback is important because even if the publish() call returns
-        success, it does not always mean that the message has been sent."""
-        return self._on_publish
+        This callback is important because even if the `publish()` call returns
+        success, it does not always mean that the message has been sent.
 
-    @on_publish.setter
-    def on_publish(self, func):
-        """ Define the published message callback implementation.
+        See also `wait_for_publish` which could be simpler to use.
 
-        Expected signature is:
-            on_publish_callback(client, userdata, mid)
+        Expected signature for callback API version 2::
 
-        client:     the client instance for this callback
-        userdata:   the private user data as set in Client() or userdata_set()
-        mid:        matches the mid variable returned from the corresponding
-                    publish() call, to allow outgoing messages to be tracked.
+            publish_callback(client, userdata, mid, reason_code, properties)
 
-        Decorator: @client.publish_callback() (```client``` is the name of the
+        Expected signature for callback API version 1::
+
+            publish_callback(client, userdata, mid)
+
+        :param Client client: the client instance for this callback
+        :param userdata: the private user data as set in Client() or user_data_set()
+        :param int mid: matches the mid variable returned from the corresponding
+                     `publish()` call, to allow outgoing messages to be tracked.
+        :param ReasonCode reason_code: the connection reason code received from the broken.
+                     In MQTT v5.0 it's the reason code defined by the standard.
+                     In MQTT v3 it's always the reason code Success
+        :parama Properties properties: the MQTT v5.0 properties received from the broker.
+                     For MQTT v3.1 and v3.1.1 properties is not provided and an empty Properties
+                     object is always used.
+
+        Note: for QoS = 0, the reason_code and the properties don't really exist, it's the client
+        library that generate them. It's always an empty properties and a success reason code.
+        Because the (MQTTv5) standard don't have reason code for PUBLISH packet, the library create them
+        at PUBACK packet, as if the message was sent with QoS = 1.
+
+        Decorator: @client.publish_callback() (``client`` is the name of the
             instance which this callback is being attached to)
 
         """
+        return self._on_publish
+
+    @on_publish.setter
+    def on_publish(self, func: CallbackOnPublish | None) -> None:
         with self._callback_mutex:
             self._on_publish = func
 
-    def publish_callback(self):
-        def decorator(func):
+    def publish_callback(
+        self,
+    ) -> Callable[[CallbackOnPublish], CallbackOnPublish]:
+        def decorator(func: CallbackOnPublish) -> CallbackOnPublish:
             self.on_publish = func
             return func
         return decorator
 
     @property
-    def on_unsubscribe(self):
-        """If implemented, called when the broker responds to an unsubscribe
-        request."""
+    def on_unsubscribe(self) -> CallbackOnUnsubscribe | None:
+        """The callback called when the broker responds to an unsubscribe
+        request.
+
+        Expected signature for callback API version 2::
+
+            unsubscribe_callback(client, userdata, mid, reason_code_list, properties)
+
+        Expected signature for callback API version 1 change with MQTT protocol version:
+            * For MQTT v3.1 and v3.1.1 it's::
+
+                unsubscribe_callback(client, userdata, mid)
+
+            * For MQTT v5.0 it's::
+
+                unsubscribe_callback(client, userdata, mid, properties, v1_reason_codes)
+
+        :param Client client: the client instance for this callback
+        :param userdata: the private user data as set in Client() or user_data_set()
+        :param mid: matches the mid variable returned from the corresponding
+                          unsubscribe() call.
+        :param list[ReasonCode] reason_code_list: reason codes received from the broker for each unsubscription.
+                          In MQTT v5.0 it's the reason code defined by the standard.
+                          In MQTT v3, there is not equivalent from broken and empty list
+                          is always used.
+        :param Properties properties: the MQTT v5.0 properties received from the broker.
+                          For MQTT v3.1 and v3.1.1 properties is not provided and an empty Properties
+                          object is always used.
+        :param v1_reason_codes: the MQTT v5.0 reason codes received from the broker for each
+                          unsubscribe topic.  A list of ReasonCode instances OR a single
+                          ReasonCode when we unsubscribe from a single topic.
+
+        Decorator: @client.unsubscribe_callback() (``client`` is the name of the
+            instance which this callback is being attached to)
+        """
         return self._on_unsubscribe
 
     @on_unsubscribe.setter
-    def on_unsubscribe(self, func):
-        """ Define the unsubscribe callback implementation.
-
-        Expected signature for MQTT v3.1.1 and v3.1 is:
-            unsubscribe_callback(client, userdata, mid)
-
-        and for MQTT v5.0:
-            unsubscribe_callback(client, userdata, mid, properties, reasonCodes)
-
-        client:         the client instance for this callback
-        userdata:       the private user data as set in Client() or userdata_set()
-        mid:            matches the mid variable returned from the corresponding
-                        unsubscribe() call.
-        properties:     the MQTT v5.0 properties received from the broker.  A
-                        list of Properties class instances.
-        reasonCodes:    the MQTT v5.0 reason codes received from the broker for each
-                        unsubscribe topic.  A list of ReasonCodes instances
-
-        Decorator: @client.unsubscribe_callback() (```client``` is the name of the
-            instance which this callback is being attached to)
-        """
+    def on_unsubscribe(self, func: CallbackOnUnsubscribe | None) -> None:
         with self._callback_mutex:
             self._on_unsubscribe = func
 
-    def unsubscribe_callback(self):
-        def decorator(func):
+    def unsubscribe_callback(
+        self,
+    ) -> Callable[[CallbackOnUnsubscribe], CallbackOnUnsubscribe]:
+        def decorator(func: CallbackOnUnsubscribe) -> CallbackOnUnsubscribe:
             self.on_unsubscribe = func
             return func
         return decorator
 
     @property
-    def on_disconnect(self):
-        """If implemented, called when the client disconnects from the broker.
+    def on_disconnect(self) -> CallbackOnDisconnect | None:
+        """The callback called when the client disconnects from the broker.
+
+        Expected signature for callback API version 2::
+
+            disconnect_callback(client, userdata, disconnect_flags, reason_code, properties)
+
+        Expected signature for callback API version 1 change with MQTT protocol version:
+            * For MQTT v3.1 and v3.1.1 it's::
+
+                disconnect_callback(client, userdata, rc)
+
+            * For MQTT it's v5.0::
+
+                disconnect_callback(client, userdata, reason_code, properties)
+
+        :param Client client: the client instance for this callback
+        :param userdata:  the private user data as set in Client() or user_data_set()
+        :param DisconnectFlag disconnect_flags: the flags for this disconnection.
+        :param ReasonCode reason_code:  the disconnection reason code possibly received from the broker (see disconnect_flags).
+                          In MQTT v5.0 it's the reason code defined by the standard.
+                          In MQTT v3 it's never received from the broker, we convert an MQTTErrorCode,
+                          see `convert_disconnect_error_code_to_reason_code()`.
+                          `ReasonCode` may be compared to integer.
+        :param Properties properties: the MQTT v5.0 properties received from the broker.
+                          For MQTT v3.1 and v3.1.1 properties is not provided and an empty Properties
+                          object is always used.
+        :param int rc: the disconnection result
+                          The rc parameter indicates the disconnection state. If
+                          MQTT_ERR_SUCCESS (0), the callback was called in response to
+                          a disconnect() call. If any other value the disconnection
+                          was unexpected, such as might be caused by a network error.
+
+        Decorator: @client.disconnect_callback() (``client`` is the name of the
+            instance which this callback is being attached to)
+
         """
         return self._on_disconnect
 
     @on_disconnect.setter
-    def on_disconnect(self, func):
-        """ Define the disconnect callback implementation.
-
-        Expected signature for MQTT v3.1.1 and v3.1 is:
-            disconnect_callback(client, userdata, rc)
-
-        and for MQTT v5.0:
-            disconnect_callback(client, userdata, reasonCode, properties)
-
-        client:     the client instance for this callback
-        userdata:   the private user data as set in Client() or userdata_set()
-        rc:         the disconnection result
-                    The rc parameter indicates the disconnection state. If
-                    MQTT_ERR_SUCCESS (0), the callback was called in response to
-                    a disconnect() call. If any other value the disconnection
-                    was unexpected, such as might be caused by a network error.
-
-        Decorator: @client.disconnect_callback() (```client``` is the name of the
-            instance which this callback is being attached to)
-
-        """
+    def on_disconnect(self, func: CallbackOnDisconnect | None) -> None:
         with self._callback_mutex:
             self._on_disconnect = func
 
-    def disconnect_callback(self):
-        def decorator(func):
+    def disconnect_callback(
+        self,
+    ) -> Callable[[CallbackOnDisconnect], CallbackOnDisconnect]:
+        def decorator(func: CallbackOnDisconnect) -> CallbackOnDisconnect:
             self.on_disconnect = func
             return func
         return decorator
 
     @property
-    def on_socket_open(self):
-        """If implemented, called just after the socket was opend."""
-        return self._on_socket_open
-
-    @on_socket_open.setter
-    def on_socket_open(self, func):
-        """Define the socket_open callback implementation.
+    def on_socket_open(self) -> CallbackOnSocket | None:
+        """The callback called just after the socket was opend.
 
         This should be used to register the socket to an external event loop for reading.
 
-        Expected signature is:
+        Expected signature is (for all callback API version)::
+
             socket_open_callback(client, userdata, socket)
 
-        client:     the client instance for this callback
-        userdata:   the private user data as set in Client() or userdata_set()
-        sock:       the socket which was just opened.
+        :param Client client:     the client instance for this callback
+        :param userdata:   the private user data as set in Client() or user_data_set()
+        :param SocketLike sock: the socket which was just opened.
 
-        Decorator: @client.socket_open_callback() (```client``` is the name of the
+        Decorator: @client.socket_open_callback() (``client`` is the name of the
             instance which this callback is being attached to)
         """
+        return self._on_socket_open
+
+    @on_socket_open.setter
+    def on_socket_open(self, func: CallbackOnSocket | None) -> None:
         with self._callback_mutex:
             self._on_socket_open = func
 
-    def socket_open_callback(self):
-        def decorator(func):
+    def socket_open_callback(
+        self,
+    ) -> Callable[[CallbackOnSocket], CallbackOnSocket]:
+        def decorator(func: CallbackOnSocket) -> CallbackOnSocket:
             self.on_socket_open = func
             return func
         return decorator
 
-    def _call_socket_open(self):
+    def _call_socket_open(self, sock: SocketLike) -> None:
         """Call the socket_open callback with the just-opened socket"""
         with self._callback_mutex:
             on_socket_open = self.on_socket_open
@@ -2152,7 +2812,7 @@ class Client(object):
         if on_socket_open:
             with self._in_callback_mutex:
                 try:
-                    on_socket_open(self, self._userdata, self._sock)
+                    on_socket_open(self, self._userdata, sock)
                 except Exception as err:
                     self._easy_log(
                         MQTT_LOG_ERR, 'Caught exception in on_socket_open: %s', err)
@@ -2160,36 +2820,38 @@ class Client(object):
                         raise
 
     @property
-    def on_socket_close(self):
-        """If implemented, called just before the socket is closed."""
-        return self._on_socket_close
-
-    @on_socket_close.setter
-    def on_socket_close(self, func):
-        """Define the socket_close callback implementation.
+    def on_socket_close(self) -> CallbackOnSocket | None:
+        """The callback called just before the socket is closed.
 
         This should be used to unregister the socket from an external event loop for reading.
 
-        Expected signature is:
+        Expected signature is (for all callback API version)::
+
             socket_close_callback(client, userdata, socket)
 
-        client:     the client instance for this callback
-        userdata:   the private user data as set in Client() or userdata_set()
-        sock:       the socket which is about to be closed.
+        :param Client client: the client instance for this callback
+        :param userdata: the private user data as set in Client() or user_data_set()
+        :param SocketLike sock: the socket which is about to be closed.
 
-        Decorator: @client.socket_close_callback() (```client``` is the name of the
+        Decorator: @client.socket_close_callback() (``client`` is the name of the
             instance which this callback is being attached to)
         """
+        return self._on_socket_close
+
+    @on_socket_close.setter
+    def on_socket_close(self, func: CallbackOnSocket | None) -> None:
         with self._callback_mutex:
             self._on_socket_close = func
 
-    def socket_close_callback(self):
-        def decorator(func):
+    def socket_close_callback(
+        self,
+    ) -> Callable[[CallbackOnSocket], CallbackOnSocket]:
+        def decorator(func: CallbackOnSocket) -> CallbackOnSocket:
             self.on_socket_close = func
             return func
         return decorator
 
-    def _call_socket_close(self, sock):
+    def _call_socket_close(self, sock: SocketLike) -> None:
         """Call the socket_close callback with the about-to-be-closed socket"""
         with self._callback_mutex:
             on_socket_close = self.on_socket_close
@@ -2205,36 +2867,38 @@ class Client(object):
                         raise
 
     @property
-    def on_socket_register_write(self):
-        """If implemented, called when the socket needs writing but can't."""
-        return self._on_socket_register_write
-
-    @on_socket_register_write.setter
-    def on_socket_register_write(self, func):
-        """Define the socket_register_write callback implementation.
+    def on_socket_register_write(self) -> CallbackOnSocket | None:
+        """The callback called when the socket needs writing but can't.
 
         This should be used to register the socket with an external event loop for writing.
 
-        Expected signature is:
+        Expected signature is (for all callback API version)::
+
             socket_register_write_callback(client, userdata, socket)
 
-        client:     the client instance for this callback
-        userdata:   the private user data as set in Client() or userdata_set()
-        sock:       the socket which should be registered for writing
+        :param Client client: the client instance for this callback
+        :param userdata: the private user data as set in Client() or user_data_set()
+        :param SocketLike sock: the socket which should be registered for writing
 
-        Decorator: @client.socket_register_write_callback() (```client``` is the name of the
+        Decorator: @client.socket_register_write_callback() (``client`` is the name of the
             instance which this callback is being attached to)
         """
+        return self._on_socket_register_write
+
+    @on_socket_register_write.setter
+    def on_socket_register_write(self, func: CallbackOnSocket | None) -> None:
         with self._callback_mutex:
             self._on_socket_register_write = func
 
-    def socket_register_write_callback(self):
-        def decorator(func):
+    def socket_register_write_callback(
+        self,
+    ) -> Callable[[CallbackOnSocket], CallbackOnSocket]:
+        def decorator(func: CallbackOnSocket) -> CallbackOnSocket:
             self._on_socket_register_write = func
             return func
         return decorator
 
-    def _call_socket_register_write(self):
+    def _call_socket_register_write(self) -> None:
         """Call the socket_register_write callback with the unwritable socket"""
         if not self._sock or self._registered_write:
             return
@@ -2253,36 +2917,46 @@ class Client(object):
                     raise
 
     @property
-    def on_socket_unregister_write(self):
-        """If implemented, called when the socket doesn't need writing anymore."""
-        return self._on_socket_unregister_write
-
-    @on_socket_unregister_write.setter
-    def on_socket_unregister_write(self, func):
-        """Define the socket_unregister_write callback implementation.
+    def on_socket_unregister_write(
+        self,
+    ) -> CallbackOnSocket | None:
+        """The callback called when the socket doesn't need writing anymore.
 
         This should be used to unregister the socket from an external event loop for writing.
 
-        Expected signature is:
+        Expected signature is (for all callback API version)::
+
             socket_unregister_write_callback(client, userdata, socket)
 
-        client:     the client instance for this callback
-        userdata:   the private user data as set in Client() or userdata_set()
-        sock:       the socket which should be unregistered for writing
+        :param Client client: the client instance for this callback
+        :param userdata: the private user data as set in Client() or user_data_set()
+        :param SocketLike sock: the socket which should be unregistered for writing
 
-        Decorator: @client.socket_unregister_write_callback() (```client``` is the name of the
+        Decorator: @client.socket_unregister_write_callback() (``client`` is the name of the
             instance which this callback is being attached to)
         """
+        return self._on_socket_unregister_write
+
+    @on_socket_unregister_write.setter
+    def on_socket_unregister_write(
+        self, func: CallbackOnSocket | None
+    ) -> None:
         with self._callback_mutex:
             self._on_socket_unregister_write = func
 
-    def socket_unregister_write_callback(self):
-        def decorator(func):
+    def socket_unregister_write_callback(
+        self,
+    ) -> Callable[[CallbackOnSocket], CallbackOnSocket]:
+        def decorator(
+            func: CallbackOnSocket,
+        ) -> CallbackOnSocket:
             self._on_socket_unregister_write = func
             return func
         return decorator
 
-    def _call_socket_unregister_write(self, sock=None):
+    def _call_socket_unregister_write(
+        self, sock: SocketLike | None = None
+    ) -> None:
         """Call the socket_unregister_write callback with the writable socket"""
         sock = sock or self._sock
         if not sock or not self._registered_write:
@@ -2301,32 +2975,46 @@ class Client(object):
                 if not self.suppress_exceptions:
                     raise
 
-    def message_callback_add(self, sub, callback):
+    def message_callback_add(self, sub: str, callback: CallbackOnMessage) -> None:
         """Register a message callback for a specific topic.
         Messages that match 'sub' will be passed to 'callback'. Any
-        non-matching messages will be passed to the default on_message
+        non-matching messages will be passed to the default `on_message`
         callback.
 
         Call multiple times with different 'sub' to define multiple topic
         specific callbacks.
 
         Topic specific callbacks may be removed with
-        message_callback_remove()."""
+        `message_callback_remove()`.
+
+        See `on_message` for the expected signature of the callback.
+
+        Decorator: @client.topic_callback(sub) (``client`` is the name of the
+            instance which this callback is being attached to)
+
+        Example::
+
+            @client.topic_callback("mytopic/#")
+            def handle_mytopic(client, userdata, message):
+                ...
+        """
         if callback is None or sub is None:
             raise ValueError("sub and callback must both be defined.")
 
         with self._callback_mutex:
             self._on_message_filtered[sub] = callback
 
-    def topic_callback(self, sub):
-        def decorator(func):
+    def topic_callback(
+        self, sub: str
+    ) -> Callable[[CallbackOnMessage], CallbackOnMessage]:
+        def decorator(func: CallbackOnMessage) -> CallbackOnMessage:
             self.message_callback_add(sub, func)
             return func
         return decorator
 
-    def message_callback_remove(self, sub):
+    def message_callback_remove(self, sub: str) -> None:
         """Remove a message callback previously registered with
-        message_callback_add()."""
+        `message_callback_add()`."""
         if sub is None:
             raise ValueError("sub must defined.")
 
@@ -2340,18 +3028,25 @@ class Client(object):
     # Private functions
     # ============================================================
 
-    def _loop_rc_handle(self, rc, properties=None):
+    def _loop_rc_handle(
+        self,
+        rc: MQTTErrorCode,
+    ) -> MQTTErrorCode:
         if rc:
             self._sock_close()
 
-            if self._state == mqtt_cs_disconnecting:
-                rc = MQTT_ERR_SUCCESS
+            if self._state in (_ConnectionState.MQTT_CS_DISCONNECTING, _ConnectionState.MQTT_CS_DISCONNECTED):
+                self._state = _ConnectionState.MQTT_CS_DISCONNECTED
+                rc = MQTTErrorCode.MQTT_ERR_SUCCESS
 
-            self._do_on_disconnect(rc, properties)
+            self._do_on_disconnect(packet_from_broker=False, v1_rc=rc)
+
+        if rc == MQTT_ERR_CONN_LOST:
+            self._state = _ConnectionState.MQTT_CS_CONNECTION_LOST
 
         return rc
 
-    def _packet_read(self):
+    def _packet_read(self) -> MQTTErrorCode:
         # This gets called if pselect() indicates that there is network data
         # available - ie. at least one byte.  What we do depends on what data we
         # already have.
@@ -2369,16 +3064,19 @@ class Client(object):
             try:
                 command = self._sock_recv(1)
             except BlockingIOError:
-                return MQTT_ERR_AGAIN
-            except ConnectionError as err:
+                return MQTTErrorCode.MQTT_ERR_AGAIN
+            except TimeoutError as err:
+                self._easy_log(
+                    MQTT_LOG_ERR, 'timeout on socket: %s', err)
+                return MQTTErrorCode.MQTT_ERR_CONN_LOST
+            except OSError as err:
                 self._easy_log(
                     MQTT_LOG_ERR, 'failed to receive on socket: %s', err)
-                return MQTT_ERR_CONN_LOST
+                return MQTTErrorCode.MQTT_ERR_CONN_LOST
             else:
                 if len(command) == 0:
-                    return MQTT_ERR_CONN_LOST
-                command, = struct.unpack("!B", command)
-                self._in_packet['command'] = command
+                    return MQTTErrorCode.MQTT_ERR_CONN_LOST
+                self._in_packet['command'] = command[0]
 
         if self._in_packet['have_remaining'] == 0:
             # Read remaining
@@ -2388,26 +3086,26 @@ class Client(object):
                 try:
                     byte = self._sock_recv(1)
                 except BlockingIOError:
-                    return MQTT_ERR_AGAIN
-                except ConnectionError as err:
+                    return MQTTErrorCode.MQTT_ERR_AGAIN
+                except OSError as err:
                     self._easy_log(
                         MQTT_LOG_ERR, 'failed to receive on socket: %s', err)
-                    return MQTT_ERR_CONN_LOST
+                    return MQTTErrorCode.MQTT_ERR_CONN_LOST
                 else:
                     if len(byte) == 0:
-                        return MQTT_ERR_CONN_LOST
-                    byte, = struct.unpack("!B", byte)
-                    self._in_packet['remaining_count'].append(byte)
+                        return MQTTErrorCode.MQTT_ERR_CONN_LOST
+                    byte_value = byte[0]
+                    self._in_packet['remaining_count'].append(byte_value)
                     # Max 4 bytes length for remaining length as defined by protocol.
                     # Anything more likely means a broken/malicious client.
                     if len(self._in_packet['remaining_count']) > 4:
-                        return MQTT_ERR_PROTOCOL
+                        return MQTTErrorCode.MQTT_ERR_PROTOCOL
 
                     self._in_packet['remaining_length'] += (
-                        byte & 127) * self._in_packet['remaining_mult']
+                        byte_value & 127) * self._in_packet['remaining_mult']
                     self._in_packet['remaining_mult'] = self._in_packet['remaining_mult'] * 128
 
-                if (byte & 128) == 0:
+                if (byte_value & 128) == 0:
                     break
 
             self._in_packet['have_remaining'] = 1
@@ -2418,21 +3116,21 @@ class Client(object):
             try:
                 data = self._sock_recv(self._in_packet['to_process'])
             except BlockingIOError:
-                return MQTT_ERR_AGAIN
-            except ConnectionError as err:
+                return MQTTErrorCode.MQTT_ERR_AGAIN
+            except OSError as err:
                 self._easy_log(
                     MQTT_LOG_ERR, 'failed to receive on socket: %s', err)
-                return MQTT_ERR_CONN_LOST
+                return MQTTErrorCode.MQTT_ERR_CONN_LOST
             else:
                 if len(data) == 0:
-                    return MQTT_ERR_CONN_LOST
+                    return MQTTErrorCode.MQTT_ERR_CONN_LOST
                 self._in_packet['to_process'] -= len(data)
                 self._in_packet['packet'] += data
             count -= 1
             if count == 0:
                 with self._msgtime_mutex:
                     self._last_msg_in = time_func()
-                return MQTT_ERR_AGAIN
+                return MQTTErrorCode.MQTT_ERR_AGAIN
 
         # All data for this packet is read.
         self._in_packet['pos'] = 0
@@ -2440,40 +3138,41 @@ class Client(object):
 
         # Free data and reset values
         self._in_packet = {
-            'command': 0,
-            'have_remaining': 0,
-            'remaining_count': [],
-            'remaining_mult': 1,
-            'remaining_length': 0,
-            'packet': bytearray(b""),
-            'to_process': 0,
-            'pos': 0}
+            "command": 0,
+            "have_remaining": 0,
+            "remaining_count": [],
+            "remaining_mult": 1,
+            "remaining_length": 0,
+            "packet": bytearray(b""),
+            "to_process": 0,
+            "pos": 0,
+        }
 
         with self._msgtime_mutex:
             self._last_msg_in = time_func()
         return rc
 
-    def _packet_write(self):
+    def _packet_write(self) -> MQTTErrorCode:
         while True:
             try:
                 packet = self._out_packet.popleft()
             except IndexError:
-                return MQTT_ERR_SUCCESS
+                return MQTTErrorCode.MQTT_ERR_SUCCESS
 
             try:
                 write_length = self._sock_send(
                     packet['packet'][packet['pos']:])
             except (AttributeError, ValueError):
                 self._out_packet.appendleft(packet)
-                return MQTT_ERR_SUCCESS
+                return MQTTErrorCode.MQTT_ERR_SUCCESS
             except BlockingIOError:
                 self._out_packet.appendleft(packet)
-                return MQTT_ERR_AGAIN
-            except ConnectionError as err:
+                return MQTTErrorCode.MQTT_ERR_AGAIN
+            except OSError as err:
                 self._out_packet.appendleft(packet)
                 self._easy_log(
                     MQTT_LOG_ERR, 'failed to receive on socket: %s', err)
-                return MQTT_ERR_CONN_LOST
+                return MQTTErrorCode.MQTT_ERR_CONN_LOST
 
             if write_length > 0:
                 packet['to_process'] -= write_length
@@ -2487,23 +3186,49 @@ class Client(object):
                         if on_publish:
                             with self._in_callback_mutex:
                                 try:
-                                    on_publish(
-                                        self, self._userdata, packet['mid'])
+                                    if self._callback_api_version == CallbackAPIVersion.VERSION1:
+                                        on_publish = cast(CallbackOnPublish_v1, on_publish)
+
+                                        on_publish(self, self._userdata, packet["mid"])
+                                    elif self._callback_api_version == CallbackAPIVersion.VERSION2:
+                                        on_publish = cast(CallbackOnPublish_v2, on_publish)
+
+                                        on_publish(
+                                            self,
+                                            self._userdata,
+                                            packet["mid"],
+                                            ReasonCode(PacketTypes.PUBACK),
+                                            Properties(PacketTypes.PUBACK),
+                                        )
+                                    else:
+                                        raise RuntimeError("Unsupported callback API version")
                                 except Exception as err:
                                     self._easy_log(
                                         MQTT_LOG_ERR, 'Caught exception in on_publish: %s', err)
                                     if not self.suppress_exceptions:
                                         raise
 
-                        packet['info']._set_as_published()
+                        # TODO: Something is odd here. I don't see why packet["info"] can't be None.
+                        # A packet could be produced by _handle_connack with qos=0 and no info
+                        # (around line 3645). Ignore the mypy check for now but I feel there is a bug
+                        # somewhere.
+                        packet['info']._set_as_published()  # type: ignore
 
                     if (packet['command'] & 0xF0) == DISCONNECT:
                         with self._msgtime_mutex:
                             self._last_msg_out = time_func()
 
-                        self._do_on_disconnect(MQTT_ERR_SUCCESS)
+                        self._do_on_disconnect(
+                            packet_from_broker=False,
+                            v1_rc=MQTTErrorCode.MQTT_ERR_SUCCESS,
+                        )
                         self._sock_close()
-                        return MQTT_ERR_SUCCESS
+                        # Only change to disconnected if the disconnection was wanted
+                        # by the client (== state was disconnecting). If the broker disconnected
+                        # use unilaterally don't change the state and client may reconnect.
+                        if self._state == _ConnectionState.MQTT_CS_DISCONNECTING:
+                            self._state = _ConnectionState.MQTT_CS_DISCONNECTED
+                        return MQTTErrorCode.MQTT_ERR_SUCCESS
 
                 else:
                     # We haven't finished with this packet
@@ -2514,23 +3239,23 @@ class Client(object):
         with self._msgtime_mutex:
             self._last_msg_out = time_func()
 
-        return MQTT_ERR_SUCCESS
+        return MQTTErrorCode.MQTT_ERR_SUCCESS
 
-    def _easy_log(self, level, fmt, *args):
+    def _easy_log(self, level: LogLevel, fmt: str, *args: Any) -> None:
         if self.on_log is not None:
             buf = fmt % args
             try:
                 self.on_log(self, self._userdata, level, buf)
-            except Exception:
+            except Exception:  # noqa: S110
                 # Can't _easy_log this, as we'll recurse until we break
                 pass  # self._logger will pick this up, so we're fine
         if self._logger is not None:
             level_std = LOGGING_LEVEL[level]
             self._logger.log(level_std, fmt, *args)
 
-    def _check_keepalive(self):
+    def _check_keepalive(self) -> None:
         if self._keepalive == 0:
-            return MQTT_ERR_SUCCESS
+            return
 
         now = time_func()
 
@@ -2539,12 +3264,15 @@ class Client(object):
             last_msg_in = self._last_msg_in
 
         if self._sock is not None and (now - last_msg_out >= self._keepalive or now - last_msg_in >= self._keepalive):
-            if self._state == mqtt_cs_connected and self._ping_t == 0:
+            if self._state == _ConnectionState.MQTT_CS_CONNECTED and self._ping_t == 0:
                 try:
                     self._send_pingreq()
                 except Exception:
                     self._sock_close()
-                    self._do_on_disconnect(MQTT_ERR_CONN_LOST)
+                    self._do_on_disconnect(
+                        packet_from_broker=False,
+                        v1_rc=MQTTErrorCode.MQTT_ERR_CONN_LOST,
+                    )
                 else:
                     with self._msgtime_mutex:
                         self._last_msg_out = now
@@ -2552,14 +3280,18 @@ class Client(object):
             else:
                 self._sock_close()
 
-                if self._state == mqtt_cs_disconnecting:
-                    rc = MQTT_ERR_SUCCESS
+                if self._state in (_ConnectionState.MQTT_CS_DISCONNECTING, _ConnectionState.MQTT_CS_DISCONNECTED):
+                    self._state = _ConnectionState.MQTT_CS_DISCONNECTED
+                    rc = MQTTErrorCode.MQTT_ERR_SUCCESS
                 else:
-                    rc = MQTT_ERR_KEEPALIVE
+                    rc = MQTTErrorCode.MQTT_ERR_KEEPALIVE
 
-                self._do_on_disconnect(rc)
+                self._do_on_disconnect(
+                    packet_from_broker=False,
+                    v1_rc=rc,
+                )
 
-    def _mid_generate(self):
+    def _mid_generate(self) -> int:
         with self._mid_generate_mutex:
             self._last_mid += 1
             if self._last_mid == 65536:
@@ -2567,44 +3299,47 @@ class Client(object):
             return self._last_mid
 
     @staticmethod
-    def _topic_wildcard_len_check(topic):
-        # Search for + or # in a topic. Return MQTT_ERR_INVAL if found.
-        # Also returns MQTT_ERR_INVAL if the topic string is too long.
-        # Returns MQTT_ERR_SUCCESS if everything is fine.
-        if b'+' in topic or b'#' in topic or len(topic) > 65535:
-            return MQTT_ERR_INVAL
-        else:
-            return MQTT_ERR_SUCCESS
+    def _raise_for_invalid_topic(topic: bytes) -> None:
+        """ Check if the topic is a topic without wildcard and valid length.
+
+            Raise ValueError if the topic isn't valid.
+        """
+        if b'+' in topic or b'#' in topic:
+            raise ValueError('Publish topic cannot contain wildcards.')
+        if len(topic) > 65535:
+            raise ValueError('Publish topic is too long.')
 
     @staticmethod
-    def _filter_wildcard_len_check(sub):
+    def _filter_wildcard_len_check(sub: bytes) -> MQTTErrorCode:
         if (len(sub) == 0 or len(sub) > 65535
             or any(b'+' in p or b'#' in p for p in sub.split(b'/') if len(p) > 1)
                 or b'#/' in sub):
-            return MQTT_ERR_INVAL
+            return MQTTErrorCode.MQTT_ERR_INVAL
         else:
-            return MQTT_ERR_SUCCESS
+            return MQTTErrorCode.MQTT_ERR_SUCCESS
 
-    def _send_pingreq(self):
+    def _send_pingreq(self) -> MQTTErrorCode:
         self._easy_log(MQTT_LOG_DEBUG, "Sending PINGREQ")
         rc = self._send_simple_command(PINGREQ)
-        if rc == MQTT_ERR_SUCCESS:
+        if rc == MQTTErrorCode.MQTT_ERR_SUCCESS:
             self._ping_t = time_func()
         return rc
 
-    def _send_pingresp(self):
+    def _send_pingresp(self) -> MQTTErrorCode:
         self._easy_log(MQTT_LOG_DEBUG, "Sending PINGRESP")
         return self._send_simple_command(PINGRESP)
 
-    def _send_puback(self, mid):
+    def _send_puback(self, mid: int) -> MQTTErrorCode:
         self._easy_log(MQTT_LOG_DEBUG, "Sending PUBACK (Mid: %d)", mid)
         return self._send_command_with_mid(PUBACK, mid, False)
 
-    def _send_pubcomp(self, mid):
+    def _send_pubcomp(self, mid: int) -> MQTTErrorCode:
         self._easy_log(MQTT_LOG_DEBUG, "Sending PUBCOMP (Mid: %d)", mid)
         return self._send_command_with_mid(PUBCOMP, mid, False)
 
-    def _pack_remaining_length(self, packet, remaining_length):
+    def _pack_remaining_length(
+        self, packet: bytearray, remaining_length: int
+    ) -> bytearray:
         remaining_bytes = []
         while True:
             byte = remaining_length % 128
@@ -2619,19 +3354,30 @@ class Client(object):
                 # FIXME - this doesn't deal with incorrectly large payloads
                 return packet
 
-    def _pack_str16(self, packet, data):
-        if isinstance(data, unicode):
-            data = data.encode('utf-8')
+    def _pack_str16(self, packet: bytearray, data: bytes | str) -> None:
+        data = _force_bytes(data)
         packet.extend(struct.pack("!H", len(data)))
         packet.extend(data)
 
-    def _send_publish(self, mid, topic, payload=b'', qos=0, retain=False, dup=False, info=None, properties=None):
+    def _send_publish(
+        self,
+        mid: int,
+        topic: bytes,
+        payload: bytes = b"",
+        qos: int = 0,
+        retain: bool = False,
+        dup: bool = False,
+        info: MQTTMessageInfo | None = None,
+        properties: Properties | None = None,
+    ) -> MQTTErrorCode:
         # we assume that topic and payload are already properly encoded
-        assert not isinstance(topic, unicode) and not isinstance(
-            payload, unicode) and payload is not None
+        if not isinstance(topic, bytes):
+            raise TypeError('topic must be bytes, not str')
+        if payload and not isinstance(payload, bytes):
+            raise TypeError('payload must be bytes if set')
 
         if self._sock is None:
-            return MQTT_ERR_NO_CONN
+            return MQTTErrorCode.MQTT_ERR_NO_CONN
 
         command = PUBLISH | ((dup & 0x1) << 3) | (qos << 1) | retain
         packet = bytearray()
@@ -2692,15 +3438,15 @@ class Client(object):
 
         return self._packet_queue(PUBLISH, packet, mid, qos, info)
 
-    def _send_pubrec(self, mid):
+    def _send_pubrec(self, mid: int) -> MQTTErrorCode:
         self._easy_log(MQTT_LOG_DEBUG, "Sending PUBREC (Mid: %d)", mid)
         return self._send_command_with_mid(PUBREC, mid, False)
 
-    def _send_pubrel(self, mid):
+    def _send_pubrel(self, mid: int) -> MQTTErrorCode:
         self._easy_log(MQTT_LOG_DEBUG, "Sending PUBREL (Mid: %d)", mid)
         return self._send_command_with_mid(PUBREL | 2, mid, False)
 
-    def _send_command_with_mid(self, command, mid, dup):
+    def _send_command_with_mid(self, command: int, mid: int, dup: int) -> MQTTErrorCode:
         # For PUBACK, PUBCOMP, PUBREC, and PUBREL
         if dup:
             command |= 0x8
@@ -2709,13 +3455,13 @@ class Client(object):
         packet = struct.pack('!BBH', command, remaining_length, mid)
         return self._packet_queue(command, packet, mid, 1)
 
-    def _send_simple_command(self, command):
+    def _send_simple_command(self, command: int) -> MQTTErrorCode:
         # For DISCONNECT, PINGREQ and PINGRESP
         remaining_length = 0
         packet = struct.pack('!BB', command, remaining_length)
         return self._packet_queue(command, packet, 0, 0)
 
-    def _send_connect(self, keepalive):
+    def _send_connect(self, keepalive: int) -> MQTTErrorCode:
         proto_ver = self._protocol
         # hard-coded UTF-8 encoded string
         protocol = b"MQTT" if proto_ver >= MQTTv311 else b"MQIsdp"
@@ -2725,7 +3471,7 @@ class Client(object):
 
         connect_flags = 0
         if self._protocol == MQTTv5:
-            if self._clean_start == True:
+            if self._clean_start is True:
                 connect_flags |= 0x02
             elif self._clean_start == MQTT_CLEAN_START_FIRST_ONLY and self._mqttv5_first_connect:
                 connect_flags |= 0x02
@@ -2768,8 +3514,10 @@ class Client(object):
             proto_ver |= 0x80
 
         self._pack_remaining_length(packet, remaining_length)
-        packet.extend(struct.pack("!H" + str(len(protocol)) + "sBBH", len(protocol), protocol, proto_ver, connect_flags,
-                                  keepalive))
+        packet.extend(struct.pack(
+            f"!H{len(protocol)}sBBH",
+            len(protocol), protocol, proto_ver, connect_flags, keepalive,
+        ))
 
         if self._protocol == MQTTv5:
             packet += packed_connect_properties
@@ -2818,7 +3566,11 @@ class Client(object):
             )
         return self._packet_queue(command, packet, 0, 0)
 
-    def _send_disconnect(self, reasoncode=None, properties=None):
+    def _send_disconnect(
+        self,
+        reasoncode: ReasonCode | None = None,
+        properties: Properties | None = None,
+    ) -> MQTTErrorCode:
         if self._protocol == MQTTv5:
             self._easy_log(MQTT_LOG_DEBUG, "Sending DISCONNECT reasonCode=%s properties=%s",
                            reasoncode,
@@ -2836,7 +3588,7 @@ class Client(object):
         if self._protocol == MQTTv5:
             if properties is not None or reasoncode is not None:
                 if reasoncode is None:
-                    reasoncode = ReasonCodes(DISCONNECT >> 4, identifier=0)
+                    reasoncode = ReasonCode(DISCONNECT >> 4, identifier=0)
                 remaining_length += 1
                 if properties is not None:
                     packed_props = properties.pack()
@@ -2845,14 +3597,19 @@ class Client(object):
         self._pack_remaining_length(packet, remaining_length)
 
         if self._protocol == MQTTv5:
-            if reasoncode != None:
+            if reasoncode is not None:
                 packet += reasoncode.pack()
-                if properties != None:
+                if properties is not None:
                     packet += packed_props
 
         return self._packet_queue(command, packet, 0, 0)
 
-    def _send_subscribe(self, dup, topics, properties=None):
+    def _send_subscribe(
+        self,
+        dup: int,
+        topics: Sequence[tuple[bytes, SubscribeOptions | int]],
+        properties: Properties | None = None,
+    ) -> tuple[MQTTErrorCode, int]:
         remaining_length = 2
         if self._protocol == MQTTv5:
             if properties is None:
@@ -2876,9 +3633,9 @@ class Client(object):
         for t, q in topics:
             self._pack_str16(packet, t)
             if self._protocol == MQTTv5:
-                packet += q.pack()
+                packet += q.pack()  # type: ignore
             else:
-                packet.append(q)
+                packet.append(q)  # type: ignore
 
         self._easy_log(
             MQTT_LOG_DEBUG,
@@ -2889,7 +3646,12 @@ class Client(object):
         )
         return (self._packet_queue(command, packet, local_mid, 1), local_mid)
 
-    def _send_unsubscribe(self, dup, topics, properties=None):
+    def _send_unsubscribe(
+        self,
+        dup: int,
+        topics: list[bytes],
+        properties: Properties | None = None,
+    ) -> tuple[MQTTErrorCode, int]:
         remaining_length = 2
         if self._protocol == MQTTv5:
             if properties is None:
@@ -2933,16 +3695,16 @@ class Client(object):
             )
         return (self._packet_queue(command, packet, local_mid, 1), local_mid)
 
-    def _check_clean_session(self):
+    def _check_clean_session(self) -> bool:
         if self._protocol == MQTTv5:
             if self._clean_start == MQTT_CLEAN_START_FIRST_ONLY:
                 return self._mqttv5_first_connect
             else:
-                return self._clean_start
+                return self._clean_start  # type: ignore
         else:
             return self._clean_session
 
-    def _messages_reconnect_reset_out(self):
+    def _messages_reconnect_reset_out(self) -> None:
         with self._out_message_mutex:
             self._inflight_messages = 0
             for m in self._out_messages.values():
@@ -2971,7 +3733,7 @@ class Client(object):
                 else:
                     m.state = mqtt_ms_queued
 
-    def _messages_reconnect_reset_in(self):
+    def _messages_reconnect_reset_in(self) -> None:
         with self._in_message_mutex:
             if self._check_clean_session():
                 self._in_messages = collections.OrderedDict()
@@ -2984,19 +3746,27 @@ class Client(object):
                     # Preserve current state
                     pass
 
-    def _messages_reconnect_reset(self):
+    def _messages_reconnect_reset(self) -> None:
         self._messages_reconnect_reset_out()
         self._messages_reconnect_reset_in()
 
-    def _packet_queue(self, command, packet, mid, qos, info=None):
-        mpkt = {
-            'command': command,
-            'mid': mid,
-            'qos': qos,
-            'pos': 0,
-            'to_process': len(packet),
-            'packet': packet,
-            'info': info}
+    def _packet_queue(
+        self,
+        command: int,
+        packet: bytes,
+        mid: int,
+        qos: int,
+        info: MQTTMessageInfo | None = None,
+    ) -> MQTTErrorCode:
+        mpkt: _OutPacket = {
+            "command": command,
+            "mid": mid,
+            "qos": qos,
+            "pos": 0,
+            "to_process": len(packet),
+            "packet": packet,
+            "info": info,
+        }
 
         self._out_packet.append(mpkt)
 
@@ -3017,9 +3787,9 @@ class Client(object):
 
         self._call_socket_register_write()
 
-        return MQTT_ERR_SUCCESS
+        return MQTTErrorCode.MQTT_ERR_SUCCESS
 
-    def _packet_handle(self):
+    def _packet_handle(self) -> MQTTErrorCode:
         cmd = self._in_packet['command'] & 0xF0
         if cmd == PINGREQ:
             return self._handle_pingreq()
@@ -3038,38 +3808,40 @@ class Client(object):
         elif cmd == CONNACK:
             return self._handle_connack()
         elif cmd == SUBACK:
-            return self._handle_suback()
+            self._handle_suback()
+            return MQTTErrorCode.MQTT_ERR_SUCCESS
         elif cmd == UNSUBACK:
             return self._handle_unsuback()
         elif cmd == DISCONNECT and self._protocol == MQTTv5:  # only allowed in MQTT 5.0
-            return self._handle_disconnect()
+            self._handle_disconnect()
+            return MQTTErrorCode.MQTT_ERR_SUCCESS
         else:
             # If we don't recognise the command, return an error straight away.
             self._easy_log(MQTT_LOG_ERR, "Error: Unrecognised command %s", cmd)
-            return MQTT_ERR_PROTOCOL
+            return MQTTErrorCode.MQTT_ERR_PROTOCOL
 
-    def _handle_pingreq(self):
+    def _handle_pingreq(self) -> MQTTErrorCode:
         if self._in_packet['remaining_length'] != 0:
-            return MQTT_ERR_PROTOCOL
+            return MQTTErrorCode.MQTT_ERR_PROTOCOL
 
         self._easy_log(MQTT_LOG_DEBUG, "Received PINGREQ")
         return self._send_pingresp()
 
-    def _handle_pingresp(self):
+    def _handle_pingresp(self) -> MQTTErrorCode:
         if self._in_packet['remaining_length'] != 0:
-            return MQTT_ERR_PROTOCOL
+            return MQTTErrorCode.MQTT_ERR_PROTOCOL
 
         # No longer waiting for a PINGRESP.
         self._ping_t = 0
         self._easy_log(MQTT_LOG_DEBUG, "Received PINGRESP")
-        return MQTT_ERR_SUCCESS
+        return MQTTErrorCode.MQTT_ERR_SUCCESS
 
-    def _handle_connack(self):
+    def _handle_connack(self) -> MQTTErrorCode:
         if self._protocol == MQTTv5:
             if self._in_packet['remaining_length'] < 2:
-                return MQTT_ERR_PROTOCOL
+                return MQTTErrorCode.MQTT_ERR_PROTOCOL
         elif self._in_packet['remaining_length'] != 2:
-            return MQTT_ERR_PROTOCOL
+            return MQTTErrorCode.MQTT_ERR_PROTOCOL
 
         if self._protocol == MQTTv5:
             (flags, result) = struct.unpack(
@@ -3077,14 +3849,16 @@ class Client(object):
             if result == 1:
                 # This is probably a failure from a broker that doesn't support
                 # MQTT v5.
-                reason = 132 # Unsupported protocol version
+                reason = ReasonCode(CONNACK >> 4, aName="Unsupported protocol version")
                 properties = None
             else:
-                reason = ReasonCodes(CONNACK >> 4, identifier=result)
+                reason = ReasonCode(CONNACK >> 4, identifier=result)
                 properties = Properties(CONNACK >> 4)
                 properties.unpack(self._in_packet['packet'][2:])
         else:
             (flags, result) = struct.unpack("!BB", self._in_packet['packet'])
+            reason = convert_connack_rc_to_reason_code(result)
+            properties = None
         if self._protocol == MQTTv311:
             if result == CONNACK_REFUSED_PROTOCOL_VERSION:
                 if not self._reconnect_on_failure:
@@ -3106,11 +3880,11 @@ class Client(object):
                     "Received CONNACK (%s, %s), attempting to use non-empty CID",
                     flags, result,
                 )
-                self._client_id = base62(uuid.uuid4().int, padding=22)
+                self._client_id = _base62(uuid.uuid4().int, padding=22).encode("utf8")
                 return self.reconnect()
 
         if result == 0:
-            self._state = mqtt_cs_connected
+            self._state = _ConnectionState.MQTT_CS_CONNECTED
             self._reconnect_delay = None
 
         if self._protocol == MQTTv5:
@@ -3131,12 +3905,36 @@ class Client(object):
             flags_dict['session present'] = flags & 0x01
             with self._in_callback_mutex:
                 try:
-                    if self._protocol == MQTTv5:
-                        on_connect(self, self._userdata,
-                                        flags_dict, reason, properties)
-                    else:
+                    if self._callback_api_version == CallbackAPIVersion.VERSION1:
+                        if self._protocol == MQTTv5:
+                            on_connect = cast(CallbackOnConnect_v1_mqtt5, on_connect)
+
+                            on_connect(self, self._userdata,
+                                            flags_dict, reason, properties)
+                        else:
+                            on_connect = cast(CallbackOnConnect_v1_mqtt3, on_connect)
+
+                            on_connect(
+                                self, self._userdata, flags_dict, result)
+                    elif self._callback_api_version == CallbackAPIVersion.VERSION2:
+                        on_connect = cast(CallbackOnConnect_v2, on_connect)
+
+                        connect_flags = ConnectFlags(
+                            session_present=flags_dict['session present'] > 0
+                        )
+
+                        if properties is None:
+                            properties = Properties(PacketTypes.CONNACK)
+
                         on_connect(
-                            self, self._userdata, flags_dict, result)
+                            self,
+                            self._userdata,
+                            connect_flags,
+                            reason,
+                            properties,
+                        )
+                    else:
+                        raise RuntimeError("Unsupported callback API version")
                 except Exception as err:
                     self._easy_log(
                         MQTT_LOG_ERR, 'Caught exception in on_connect: %s', err)
@@ -3144,7 +3942,7 @@ class Client(object):
                         raise
 
         if result == 0:
-            rc = 0
+            rc = MQTTErrorCode.MQTT_ERR_SUCCESS
             with self._out_message_mutex:
                 for m in self._out_messages.values():
                     m.timestamp = time_func()
@@ -3163,7 +3961,7 @@ class Client(object):
                                 m.dup,
                                 properties=m.properties
                             )
-                        if rc != 0:
+                        if rc != MQTTErrorCode.MQTT_ERR_SUCCESS:
                             return rc
                     elif m.qos == 1:
                         if m.state == mqtt_ms_publish:
@@ -3179,7 +3977,7 @@ class Client(object):
                                     m.dup,
                                     properties=m.properties
                                 )
-                            if rc != 0:
+                            if rc != MQTTErrorCode.MQTT_ERR_SUCCESS:
                                 return rc
                     elif m.qos == 2:
                         if m.state == mqtt_ms_publish:
@@ -3195,28 +3993,28 @@ class Client(object):
                                     m.dup,
                                     properties=m.properties
                                 )
-                            if rc != 0:
+                            if rc != MQTTErrorCode.MQTT_ERR_SUCCESS:
                                 return rc
                         elif m.state == mqtt_ms_resend_pubrel:
                             self._inflight_messages += 1
                             m.state = mqtt_ms_wait_for_pubcomp
                             with self._in_callback_mutex:  # Don't call loop_write after _send_publish()
                                 rc = self._send_pubrel(m.mid)
-                            if rc != 0:
+                            if rc != MQTTErrorCode.MQTT_ERR_SUCCESS:
                                 return rc
                     self.loop_write()  # Process outgoing messages that have just been queued up
 
             return rc
         elif result > 0 and result < 6:
-            return MQTT_ERR_CONN_REFUSED
+            return MQTTErrorCode.MQTT_ERR_CONN_REFUSED
         else:
-            return MQTT_ERR_PROTOCOL
+            return MQTTErrorCode.MQTT_ERR_PROTOCOL
 
-    def _handle_disconnect(self):
+    def _handle_disconnect(self) -> None:
         packet_type = DISCONNECT >> 4
         reasonCode = properties = None
         if self._in_packet['remaining_length'] > 2:
-            reasonCode = ReasonCodes(packet_type)
+            reasonCode = ReasonCode(packet_type)
             reasonCode.unpack(self._in_packet['packet'])
             if self._in_packet['remaining_length'] > 3:
                 properties = Properties(packet_type)
@@ -3227,26 +4025,28 @@ class Client(object):
                        properties
                        )
 
-        self._loop_rc_handle(reasonCode, properties)
+        self._sock_close()
+        self._do_on_disconnect(
+            packet_from_broker=True,
+            v1_rc=MQTTErrorCode.MQTT_ERR_SUCCESS,  # If reason is absent (remaining length < 1), it means normal disconnection
+            reason=reasonCode,
+            properties=properties,
+        )
 
-        return MQTT_ERR_SUCCESS
-
-    def _handle_suback(self):
+    def _handle_suback(self) -> None:
         self._easy_log(MQTT_LOG_DEBUG, "Received SUBACK")
-        pack_format = "!H" + str(len(self._in_packet['packet']) - 2) + 's'
+        pack_format = f"!H{len(self._in_packet['packet']) - 2}s"
         (mid, packet) = struct.unpack(pack_format, self._in_packet['packet'])
 
         if self._protocol == MQTTv5:
             properties = Properties(SUBACK >> 4)
             props, props_len = properties.unpack(packet)
-            reasoncodes = []
-            for c in packet[props_len:]:
-                if sys.version_info[0] < 3:
-                    c = ord(c)
-                reasoncodes.append(ReasonCodes(SUBACK >> 4, identifier=c))
+            reasoncodes = [ReasonCode(SUBACK >> 4, identifier=c) for c in packet[props_len:]]
         else:
-            pack_format = "!" + "B" * len(packet)
+            pack_format = f"!{'B' * len(packet)}"
             granted_qos = struct.unpack(pack_format, packet)
+            reasoncodes = [ReasonCode(SUBACK >> 4, identifier=c) for c in granted_qos]
+            properties = Properties(SUBACK >> 4)
 
         with self._callback_mutex:
             on_subscribe = self.on_subscribe
@@ -3254,36 +4054,49 @@ class Client(object):
         if on_subscribe:
             with self._in_callback_mutex:  # Don't call loop_write after _send_publish()
                 try:
-                    if self._protocol == MQTTv5:
+                    if self._callback_api_version == CallbackAPIVersion.VERSION1:
+                        if self._protocol == MQTTv5:
+                            on_subscribe = cast(CallbackOnSubscribe_v1_mqtt5, on_subscribe)
+
+                            on_subscribe(
+                                self, self._userdata, mid, reasoncodes, properties)
+                        else:
+                            on_subscribe = cast(CallbackOnSubscribe_v1_mqtt3, on_subscribe)
+
+                            on_subscribe(
+                                self, self._userdata, mid, granted_qos)
+                    elif self._callback_api_version == CallbackAPIVersion.VERSION2:
+                        on_subscribe = cast(CallbackOnSubscribe_v2, on_subscribe)
+
                         on_subscribe(
-                            self, self._userdata, mid, reasoncodes, properties)
+                            self,
+                            self._userdata,
+                            mid,
+                            reasoncodes,
+                            properties,
+                        )
                     else:
-                        on_subscribe(
-                            self, self._userdata, mid, granted_qos)
+                        raise RuntimeError("Unsupported callback API version")
                 except Exception as err:
                     self._easy_log(
                         MQTT_LOG_ERR, 'Caught exception in on_subscribe: %s', err)
                     if not self.suppress_exceptions:
                         raise
 
-        return MQTT_ERR_SUCCESS
-
-    def _handle_publish(self):
-        rc = 0
-
+    def _handle_publish(self) -> MQTTErrorCode:
         header = self._in_packet['command']
         message = MQTTMessage()
-        message.dup = (header & 0x08) >> 3
+        message.dup = ((header & 0x08) >> 3) != 0
         message.qos = (header & 0x06) >> 1
-        message.retain = (header & 0x01)
+        message.retain = (header & 0x01) != 0
 
-        pack_format = "!H" + str(len(self._in_packet['packet']) - 2) + 's'
+        pack_format = f"!H{len(self._in_packet['packet']) - 2}s"
         (slen, packet) = struct.unpack(pack_format, self._in_packet['packet'])
-        pack_format = '!' + str(slen) + 's' + str(len(packet) - slen) + 's'
+        pack_format = f"!{slen}s{len(packet) - slen}s"
         (topic, packet) = struct.unpack(pack_format, packet)
 
         if self._protocol != MQTTv5 and len(topic) == 0:
-            return MQTT_ERR_PROTOCOL
+            return MQTTErrorCode.MQTT_ERR_PROTOCOL
 
         # Handle topics with invalid UTF-8
         # This replaces an invalid topic with a message and the hex
@@ -3292,12 +4105,12 @@ class Client(object):
         try:
             print_topic = topic.decode('utf-8')
         except UnicodeDecodeError:
-            print_topic = "TOPIC WITH INVALID UTF-8: " + str(topic)
+            print_topic = f"TOPIC WITH INVALID UTF-8: {topic!r}"
 
         message.topic = topic
 
         if message.qos > 0:
-            pack_format = "!H" + str(len(packet) - 2) + 's'
+            pack_format = f"!H{len(packet) - 2}s"
             (message.mid, packet) = struct.unpack(pack_format, packet)
 
         if self._protocol == MQTTv5:
@@ -3325,27 +4138,63 @@ class Client(object):
         message.timestamp = time_func()
         if message.qos == 0:
             self._handle_on_message(message)
-            return MQTT_ERR_SUCCESS
+            return MQTTErrorCode.MQTT_ERR_SUCCESS
         elif message.qos == 1:
             self._handle_on_message(message)
-            return self._send_puback(message.mid)
+            if self._manual_ack:
+                return MQTTErrorCode.MQTT_ERR_SUCCESS
+            else:
+                return self._send_puback(message.mid)
         elif message.qos == 2:
+
             rc = self._send_pubrec(message.mid)
+
             message.state = mqtt_ms_wait_for_pubrel
             with self._in_message_mutex:
                 self._in_messages[message.mid] = message
+
             return rc
         else:
-            return MQTT_ERR_PROTOCOL
+            return MQTTErrorCode.MQTT_ERR_PROTOCOL
 
-    def _handle_pubrel(self):
+    def ack(self, mid: int, qos: int) -> MQTTErrorCode:
+        """
+           send an acknowledgement for a given message id (stored in :py:attr:`message.mid <MQTTMessage.mid>`).
+           only useful in QoS>=1 and ``manual_ack=True`` (option of `Client`)
+        """
+        if self._manual_ack :
+            if qos == 1:
+                return self._send_puback(mid)
+            elif qos == 2:
+                return self._send_pubcomp(mid)
+
+        return MQTTErrorCode.MQTT_ERR_SUCCESS
+
+    def manual_ack_set(self, on: bool) -> None:
+        """
+           The paho library normally acknowledges messages as soon as they are delivered to the caller.
+           If manual_ack is turned on, then the caller MUST manually acknowledge every message once
+           application processing is complete using `ack()`
+        """
+        self._manual_ack = on
+
+
+    def _handle_pubrel(self) -> MQTTErrorCode:
         if self._protocol == MQTTv5:
             if self._in_packet['remaining_length'] < 2:
-                return MQTT_ERR_PROTOCOL
+                return MQTTErrorCode.MQTT_ERR_PROTOCOL
         elif self._in_packet['remaining_length'] != 2:
-            return MQTT_ERR_PROTOCOL
+            return MQTTErrorCode.MQTT_ERR_PROTOCOL
 
-        mid, = struct.unpack("!H", self._in_packet['packet'])
+        mid, = struct.unpack("!H", self._in_packet['packet'][:2])
+        if self._protocol == MQTTv5:
+            if self._in_packet['remaining_length'] > 2:
+                reasonCode = ReasonCode(PUBREL >> 4)
+                reasonCode.unpack(self._in_packet['packet'][2:])
+                if self._in_packet['remaining_length'] > 3:
+                    properties = Properties(PUBREL >> 4)
+                    props, props_len = properties.unpack(
+                        self._in_packet['packet'][3:])
         self._easy_log(MQTT_LOG_DEBUG, "Received PUBREL (Mid: %d)", mid)
 
         with self._in_message_mutex:
@@ -3358,18 +4207,21 @@ class Client(object):
                 if self._max_inflight_messages > 0:
                     with self._out_message_mutex:
                         rc = self._update_inflight()
-                    if rc != MQTT_ERR_SUCCESS:
+                    if rc != MQTTErrorCode.MQTT_ERR_SUCCESS:
                         return rc
 
         # FIXME: this should only be done if the message is known
         # If unknown it's a protocol error and we should close the connection.
         # But since we don't have (on disk) persistence for the session, it
         # is possible that we must known about this message.
-        # Choose to acknwoledge this messsage (and thus losing a message) but
+        # Choose to acknowledge this message (thus losing a message) but
         # avoid hanging. See #284.
-        return self._send_pubcomp(mid)
+        if self._manual_ack:
+            return MQTTErrorCode.MQTT_ERR_SUCCESS
+        else:
+            return self._send_pubcomp(mid)
 
-    def _update_inflight(self):
+    def _update_inflight(self) -> MQTTErrorCode:
         # Dont lock message_mutex here
         for m in self._out_messages.values():
             if self._inflight_messages < self._max_inflight_messages:
@@ -3388,23 +4240,23 @@ class Client(object):
                         m.dup,
                         properties=m.properties,
                     )
-                    if rc != 0:
+                    if rc != MQTTErrorCode.MQTT_ERR_SUCCESS:
                         return rc
             else:
-                return MQTT_ERR_SUCCESS
-        return MQTT_ERR_SUCCESS
+                return MQTTErrorCode.MQTT_ERR_SUCCESS
+        return MQTTErrorCode.MQTT_ERR_SUCCESS
 
-    def _handle_pubrec(self):
+    def _handle_pubrec(self) -> MQTTErrorCode:
         if self._protocol == MQTTv5:
             if self._in_packet['remaining_length'] < 2:
-                return MQTT_ERR_PROTOCOL
+                return MQTTErrorCode.MQTT_ERR_PROTOCOL
         elif self._in_packet['remaining_length'] != 2:
-            return MQTT_ERR_PROTOCOL
+            return MQTTErrorCode.MQTT_ERR_PROTOCOL
 
         mid, = struct.unpack("!H", self._in_packet['packet'][:2])
         if self._protocol == MQTTv5:
             if self._in_packet['remaining_length'] > 2:
-                reasonCode = ReasonCodes(PUBREC >> 4)
+                reasonCode = ReasonCode(PUBREC >> 4)
                 reasonCode.unpack(self._in_packet['packet'][2:])
                 if self._in_packet['remaining_length'] > 3:
                     properties = Properties(PUBREC >> 4)
@@ -3419,27 +4271,27 @@ class Client(object):
                 msg.timestamp = time_func()
                 return self._send_pubrel(mid)
 
-        return MQTT_ERR_SUCCESS
+        return MQTTErrorCode.MQTT_ERR_SUCCESS
 
-    def _handle_unsuback(self):
+    def _handle_unsuback(self) -> MQTTErrorCode:
         if self._protocol == MQTTv5:
             if self._in_packet['remaining_length'] < 4:
-                return MQTT_ERR_PROTOCOL
+                return MQTTErrorCode.MQTT_ERR_PROTOCOL
         elif self._in_packet['remaining_length'] != 2:
-            return MQTT_ERR_PROTOCOL
+            return MQTTErrorCode.MQTT_ERR_PROTOCOL
 
         mid, = struct.unpack("!H", self._in_packet['packet'][:2])
         if self._protocol == MQTTv5:
             packet = self._in_packet['packet'][2:]
             properties = Properties(UNSUBACK >> 4)
             props, props_len = properties.unpack(packet)
-            reasoncodes = []
-            for c in packet[props_len:]:
-                if sys.version_info[0] < 3:
-                    c = ord(c)
-                reasoncodes.append(ReasonCodes(UNSUBACK >> 4, identifier=c))
-            if len(reasoncodes) == 1:
-                reasoncodes = reasoncodes[0]
+            reasoncodes_list = [
+                ReasonCode(UNSUBACK >> 4, identifier=c)
+                for c in packet[props_len:]
+            ]
+        else:
+            reasoncodes_list = []
+            properties = Properties(UNSUBACK >> 4)
 
         self._easy_log(MQTT_LOG_DEBUG, "Received UNSUBACK (Mid: %d)", mid)
         with self._callback_mutex:
@@ -3448,45 +4300,119 @@ class Client(object):
         if on_unsubscribe:
             with self._in_callback_mutex:
                 try:
-                    if self._protocol == MQTTv5:
+                    if self._callback_api_version == CallbackAPIVersion.VERSION1:
+                        if self._protocol == MQTTv5:
+                            on_unsubscribe = cast(CallbackOnUnsubscribe_v1_mqtt5, on_unsubscribe)
+
+                            reasoncodes: ReasonCode | list[ReasonCode] = reasoncodes_list
+                            if len(reasoncodes_list) == 1:
+                                reasoncodes = reasoncodes_list[0]
+
+                            on_unsubscribe(
+                                self, self._userdata, mid, properties, reasoncodes)
+                        else:
+                            on_unsubscribe = cast(CallbackOnUnsubscribe_v1_mqtt3, on_unsubscribe)
+
+                            on_unsubscribe(self, self._userdata, mid)
+                    elif self._callback_api_version == CallbackAPIVersion.VERSION2:
+                        on_unsubscribe = cast(CallbackOnUnsubscribe_v2, on_unsubscribe)
+
+                        if properties is None:
+                            properties = Properties(PacketTypes.CONNACK)
+
                         on_unsubscribe(
-                            self, self._userdata, mid, properties, reasoncodes)
+                            self,
+                            self._userdata,
+                            mid,
+                            reasoncodes_list,
+                            properties,
+                        )
                     else:
-                        on_unsubscribe(self, self._userdata, mid)
+                        raise RuntimeError("Unsupported callback API version")
                 except Exception as err:
                     self._easy_log(
                         MQTT_LOG_ERR, 'Caught exception in on_unsubscribe: %s', err)
                     if not self.suppress_exceptions:
                         raise
 
-        return MQTT_ERR_SUCCESS
+        return MQTTErrorCode.MQTT_ERR_SUCCESS
 
-    def _do_on_disconnect(self, rc, properties=None):
+    def _do_on_disconnect(
+        self,
+        packet_from_broker: bool,
+        v1_rc: MQTTErrorCode,
+        reason: ReasonCode | None = None,
+        properties: Properties | None = None,
+    ) -> None:
         with self._callback_mutex:
             on_disconnect = self.on_disconnect
 
         if on_disconnect:
             with self._in_callback_mutex:
                 try:
-                    if self._protocol == MQTTv5:
+                    if self._callback_api_version == CallbackAPIVersion.VERSION1:
+                        if self._protocol == MQTTv5:
+                            on_disconnect = cast(CallbackOnDisconnect_v1_mqtt5, on_disconnect)
+
+                            if packet_from_broker:
+                                on_disconnect(self, self._userdata, reason, properties)
+                            else:
+                                on_disconnect(self, self._userdata, v1_rc, None)
+                        else:
+                            on_disconnect = cast(CallbackOnDisconnect_v1_mqtt3, on_disconnect)
+
+                            on_disconnect(self, self._userdata, v1_rc)
+                    elif self._callback_api_version == CallbackAPIVersion.VERSION2:
+                        on_disconnect = cast(CallbackOnDisconnect_v2, on_disconnect)
+
+                        disconnect_flags = DisconnectFlags(
+                            is_disconnect_packet_from_server=packet_from_broker
+                        )
+
+                        if reason is None:
+                            reason = convert_disconnect_error_code_to_reason_code(v1_rc)
+
+                        if properties is None:
+                            properties = Properties(PacketTypes.DISCONNECT)
+
                         on_disconnect(
-                            self, self._userdata, rc, properties)
+                            self,
+                            self._userdata,
+                            disconnect_flags,
+                            reason,
+                            properties,
+                        )
                     else:
-                        on_disconnect(self, self._userdata, rc)
+                        raise RuntimeError("Unsupported callback API version")
                 except Exception as err:
                     self._easy_log(
                         MQTT_LOG_ERR, 'Caught exception in on_disconnect: %s', err)
                     if not self.suppress_exceptions:
                         raise
 
-    def _do_on_publish(self, mid):
+    def _do_on_publish(self, mid: int, reason_code: ReasonCode, properties: Properties) -> MQTTErrorCode:
         with self._callback_mutex:
             on_publish = self.on_publish
 
         if on_publish:
             with self._in_callback_mutex:
                 try:
-                    on_publish(self, self._userdata, mid)
+                    if self._callback_api_version == CallbackAPIVersion.VERSION1:
+                        on_publish = cast(CallbackOnPublish_v1, on_publish)
+
+                        on_publish(self, self._userdata, mid)
+                    elif self._callback_api_version == CallbackAPIVersion.VERSION2:
+                        on_publish = cast(CallbackOnPublish_v2, on_publish)
+
+                        on_publish(
+                            self,
+                            self._userdata,
+                            mid,
+                            reason_code,
+                            properties,
+                        )
+                    else:
+                        raise RuntimeError("Unsupported callback API version")
                 except Exception as err:
                     self._easy_log(
                         MQTT_LOG_ERR, 'Caught exception in on_publish: %s', err)
@@ -3499,26 +4425,28 @@ class Client(object):
             self._inflight_messages -= 1
             if self._max_inflight_messages > 0:
                 rc = self._update_inflight()
-                if rc != MQTT_ERR_SUCCESS:
+                if rc != MQTTErrorCode.MQTT_ERR_SUCCESS:
                     return rc
-        return MQTT_ERR_SUCCESS
+        return MQTTErrorCode.MQTT_ERR_SUCCESS
 
-    def _handle_pubackcomp(self, cmd):
+    def _handle_pubackcomp(
+        self, cmd: Literal['PUBACK'] | Literal['PUBCOMP']
+    ) -> MQTTErrorCode:
         if self._protocol == MQTTv5:
             if self._in_packet['remaining_length'] < 2:
-                return MQTT_ERR_PROTOCOL
+                return MQTTErrorCode.MQTT_ERR_PROTOCOL
         elif self._in_packet['remaining_length'] != 2:
-            return MQTT_ERR_PROTOCOL
+            return MQTTErrorCode.MQTT_ERR_PROTOCOL
 
-        packet_type = PUBACK if cmd == "PUBACK" else PUBCOMP
-        packet_type = packet_type >> 4
+        packet_type_enum = PUBACK if cmd == "PUBACK" else PUBCOMP
+        packet_type = packet_type_enum.value >> 4
         mid, = struct.unpack("!H", self._in_packet['packet'][:2])
+        reasonCode = ReasonCode(packet_type)
+        properties = Properties(packet_type)
         if self._protocol == MQTTv5:
             if self._in_packet['remaining_length'] > 2:
-                reasonCode = ReasonCodes(packet_type)
                 reasonCode.unpack(self._in_packet['packet'][2:])
                 if self._in_packet['remaining_length'] > 3:
-                    properties = Properties(packet_type)
                     props, props_len = properties.unpack(
                         self._in_packet['packet'][3:])
         self._easy_log(MQTT_LOG_DEBUG, "Received %s (Mid: %d)", cmd, mid)
@@ -3526,13 +4454,12 @@ class Client(object):
         with self._out_message_mutex:
             if mid in self._out_messages:
                 # Only inform the client the message has been sent once.
-                rc = self._do_on_publish(mid)
+                rc = self._do_on_publish(mid, reasonCode, properties)
                 return rc
 
-        return MQTT_ERR_SUCCESS
+        return MQTTErrorCode.MQTT_ERR_SUCCESS
 
-    def _handle_on_message(self, message):
-        matched = False
+    def _handle_on_message(self, message: MQTTMessage) -> None:
 
         try:
             topic = message.topic
@@ -3542,8 +4469,7 @@ class Client(object):
         on_message_callbacks = []
         with self._callback_mutex:
             if topic is not None:
-                for callback in self._on_message_filtered.iter_match(message.topic):
-                    on_message_callbacks.append(callback)
+                on_message_callbacks = list(self._on_message_filtered.iter_match(message.topic))
 
             if len(on_message_callbacks) == 0:
                 on_message = self.on_message
@@ -3575,7 +4501,7 @@ class Client(object):
                         raise
 
 
-    def _handle_on_connect_fail(self):
+    def _handle_on_connect_fail(self) -> None:
         with self._callback_mutex:
             on_connect_fail = self.on_connect_fail
 
@@ -3587,10 +4513,10 @@ class Client(object):
                     self._easy_log(
                         MQTT_LOG_ERR, 'Caught exception in on_connect_fail: %s', err)
 
-    def _thread_main(self):
+    def _thread_main(self) -> None:
         self.loop_forever(retry_first_connection=True)
 
-    def _reconnect_wait(self):
+    def _reconnect_wait(self) -> None:
         # See reconnect_delay_set for details
         now = time_func()
         with self._reconnect_delay_mutex:
@@ -3605,7 +4531,7 @@ class Client(object):
             target_time = now + self._reconnect_delay
 
         remaining = target_time - now
-        while (self._state != mqtt_cs_disconnecting
+        while (self._state not in (_ConnectionState.MQTT_CS_DISCONNECTING, _ConnectionState.MQTT_CS_DISCONNECTED)
                 and not self._thread_terminate
                 and remaining > 0):
 
@@ -3613,10 +4539,10 @@ class Client(object):
             remaining = target_time - time_func()
 
     @staticmethod
-    def _proxy_is_valid(p):
-        def check(t, a):
+    def _proxy_is_valid(p) -> bool:  # type: ignore[no-untyped-def]
+        def check(t, a) -> bool:  # type: ignore[no-untyped-def]
             return (socks is not None and
-                    t in set([socks.HTTP, socks.SOCKS4, socks.SOCKS5]) and a)
+                    t in {socks.HTTP, socks.SOCKS4, socks.SOCKS5} and a)
 
         if isinstance(p, dict):
             return check(p.get("proxy_type"), p.get("proxy_addr"))
@@ -3625,7 +4551,7 @@ class Client(object):
         else:
             return False
 
-    def _get_proxy(self):
+    def _get_proxy(self) -> dict[str, Any] | None:
         if socks is None:
             return None
 
@@ -3636,11 +4562,11 @@ class Client(object):
         # Next, check for an mqtt_proxy environment variable as long as the host
         # we're trying to connect to isn't listed under the no_proxy environment
         # variable (matches built-in module urllib's behavior)
-        if not (hasattr(urllib_dot_request, "proxy_bypass") and
-                urllib_dot_request.proxy_bypass(self._host)):
-            env_proxies = urllib_dot_request.getproxies()
+        if not (hasattr(urllib.request, "proxy_bypass") and
+                urllib.request.proxy_bypass(self._host)):
+            env_proxies = urllib.request.getproxies()
             if "mqtt" in env_proxies:
-                parts = urllib_dot_parse.urlparse(env_proxies["mqtt"])
+                parts = urllib.parse.urlparse(env_proxies["mqtt"])
                 if parts.scheme == "http":
                     proxy = {
                         "proxy_type": socks.HTTP,
@@ -3668,24 +4594,74 @@ class Client(object):
         # None to indicate that the connection should be handled normally
         return None
 
-    def _create_socket_connection(self):
+    def _create_socket(self) -> SocketLike:
+        sock = self._create_socket_connection()
+        if self._ssl:
+            sock = self._ssl_wrap_socket(sock)
+
+        if self._transport == "websockets":
+            sock.settimeout(self._keepalive)
+            return _WebsocketWrapper(
+                socket=sock,
+                host=self._host,
+                port=self._port,
+                is_ssl=self._ssl,
+                path=self._websocket_path,
+                extra_headers=self._websocket_extra_headers,
+            )
+
+        return sock
+
+    def _create_socket_connection(self) -> _socket.socket:
         proxy = self._get_proxy()
         addr = (self._host, self._port)
         source = (self._bind_address, self._bind_port)
 
-
-        if sys.version_info < (2, 7) or (3, 0) < sys.version_info < (3, 2):
-            # Have to short-circuit here because of unsupported source_address
-            # param in earlier Python versions.
-            return socket.create_connection(addr, timeout=self._connect_timeout)
-
         if proxy:
             return socks.create_connection(addr, timeout=self._connect_timeout, source_address=source, **proxy)
         else:
             return socket.create_connection(addr, timeout=self._connect_timeout, source_address=source)
 
+    def _ssl_wrap_socket(self, tcp_sock: _socket.socket) -> ssl.SSLSocket:
+        if self._ssl_context is None:
+            raise ValueError(
+                "Impossible condition. _ssl_context should never be None if _ssl is True"
+            )
 
-class WebsocketWrapper(object):
+        verify_host = not self._tls_insecure
+        try:
+            # Try with server_hostname, even it's not supported in certain scenarios
+            ssl_sock = self._ssl_context.wrap_socket(
+                tcp_sock,
+                server_hostname=self._host,
+                do_handshake_on_connect=False,
+            )
+        except ssl.CertificateError:
+            # CertificateError is derived from ValueError
+            raise
+        except ValueError:
+            # Python version requires SNI in order to handle server_hostname, but SNI is not available
+            ssl_sock = self._ssl_context.wrap_socket(
+                tcp_sock,
+                do_handshake_on_connect=False,
+            )
+        else:
+            # If SSL context has already checked hostname, then don't need to do it again
+            if getattr(self._ssl_context, 'check_hostname', False):  # type: ignore
+                verify_host = False
+
+        ssl_sock.settimeout(self._keepalive)
+        ssl_sock.do_handshake()
+
+        if verify_host:
+            # TODO: this type error is a true error:
+            # error: Module has no attribute "match_hostname"  [attr-defined]
+            # Python 3.12 no longer have this method.
+            ssl.match_hostname(ssl_sock.getpeercert(), self._host)  # type: ignore
+
+        return ssl_sock
+
+class _WebsocketWrapper:
     OPCODE_CONTINUATION = 0x0
     OPCODE_TEXT = 0x1
     OPCODE_BINARY = 0x2
@@ -3693,8 +4669,15 @@ class WebsocketWrapper(object):
     OPCODE_PING = 0x9
     OPCODE_PONG = 0xa
 
-    def __init__(self, socket, host, port, is_ssl, path, extra_headers):
-
+    def __init__(
+        self,
+        socket: socket.socket | ssl.SSLSocket,
+        host: str,
+        port: int,
+        is_ssl: bool,
+        path: str,
+        extra_headers: WebSocketHeaders | None,
+    ):
         self.connected = False
 
         self._ssl = is_ssl
@@ -3712,21 +4695,32 @@ class WebsocketWrapper(object):
 
         self._do_handshake(extra_headers)
 
-    def __del__(self):
+    def __del__(self) -> None:
+        self._sendbuffer = bytearray()
+        self._readbuffer = bytearray()
 
-        self._sendbuffer = None
-        self._readbuffer = None
-
-    def _do_handshake(self, extra_headers):
+    def _do_handshake(self, extra_headers: WebSocketHeaders | None) -> None:
 
         sec_websocket_key = uuid.uuid4().bytes
         sec_websocket_key = base64.b64encode(sec_websocket_key)
 
+        if self._ssl:
+            default_port = 443
+            http_schema = "https"
+        else:
+            default_port = 80
+            http_schema = "http"
+
+        if default_port == self._port:
+            host_port = f"{self._host}"
+        else:
+            host_port = f"{self._host}:{self._port}"
+
         websocket_headers = {
-            "Host": "{self._host:s}:{self._port:d}".format(self=self),
+            "Host": host_port,
             "Upgrade": "websocket",
             "Connection": "Upgrade",
-            "Origin": "https://{self._host:s}:{self._port:d}".format(self=self),
+            "Origin": f"{http_schema}://{host_port}",
             "Sec-WebSocket-Key": sec_websocket_key.decode("utf8"),
             "Sec-Websocket-Version": "13",
             "Sec-Websocket-Protocol": "mqtt",
@@ -3740,9 +4734,8 @@ class WebsocketWrapper(object):
             websocket_headers = extra_headers(websocket_headers)
 
         header = "\r\n".join([
-            "GET {self._path} HTTP/1.1".format(self=self),
-            "\r\n".join("{}: {}".format(i, j)
-                        for i, j in websocket_headers.items()),
+            f"GET {self._path} HTTP/1.1",
+            "\r\n".join(f"{i}: {j}" for i, j in websocket_headers.items()),
             "\r\n",
         ]).encode("utf8")
 
@@ -3753,7 +4746,10 @@ class WebsocketWrapper(object):
 
         while True:
             # read HTTP response header as lines
-            byte = self._socket.recv(1)
+            try:
+                byte = self._socket.recv(1)
+            except ConnectionResetError:
+                byte = b""
 
             self._readbuffer.extend(byte)
 
@@ -3772,13 +4768,14 @@ class WebsocketWrapper(object):
                     if b"sec-websocket-accept" in str(self._readbuffer).lower().encode('utf-8'):
                         GUID = "258EAFA5-E914-47DA-95CA-C5AB0DC85B11"
 
-                        server_hash = self._readbuffer.decode(
+                        server_hash_str = self._readbuffer.decode(
                             'utf-8').split(": ", 1)[1]
-                        server_hash = server_hash.strip().encode('utf-8')
+                        server_hash = server_hash_str.strip().encode('utf-8')
 
-                        client_hash = sec_websocket_key.decode('utf-8') + GUID
-                        client_hash = hashlib.sha1(client_hash.encode('utf-8'))
-                        client_hash = base64.b64encode(client_hash.digest())
+                        client_hash_key = sec_websocket_key.decode('utf-8') + GUID
+                        # Use of SHA-1 is OK here; it's according to the Websocket spec.
+                        client_hash_digest = hashlib.sha1(client_hash_key.encode('utf-8'))  # noqa: S324
+                        client_hash = base64.b64encode(client_hash_digest.digest())
 
                         if server_hash != client_hash:
                             raise WebsocketConnectionError(
@@ -3802,8 +4799,9 @@ class WebsocketWrapper(object):
         self._readbuffer = bytearray()
         self.connected = True
 
-    def _create_frame(self, opcode, data, do_masking=1):
-
+    def _create_frame(
+        self, opcode: int, data: bytearray, do_masking: int = 1
+    ) -> bytearray:
         header = bytearray()
         length = len(data)
 
@@ -3834,7 +4832,7 @@ class WebsocketWrapper(object):
 
         return header + data
 
-    def _buffered_read(self, length):
+    def _buffered_read(self, length: int) -> bytearray:
 
         # try to recv and store needed bytes
         wanted_bytes = length - (len(self._readbuffer) - self._readbuffer_head)
@@ -3853,14 +4851,14 @@ class WebsocketWrapper(object):
         self._readbuffer_head += length
         return self._readbuffer[self._readbuffer_head - length:self._readbuffer_head]
 
-    def _recv_impl(self, length):
+    def _recv_impl(self, length: int) -> bytes:
 
         # try to decode websocket payload part from data
         try:
 
             self._readbuffer_head = 0
 
-            result = None
+            result = b""
 
             chunk_startindex = self._payload_head
             chunk_endindex = self._payload_head + length
@@ -3899,7 +4897,7 @@ class WebsocketWrapper(object):
                 payload = self._buffered_read(readindex)
 
                 # unmask only the needed part
-                if maskbit:
+                if mask_key is not None:
                     for index in range(chunk_startindex, readindex):
                         payload[index] ^= mask_key[index % 4]
 
@@ -3913,20 +4911,20 @@ class WebsocketWrapper(object):
                 self._readbuffer = bytearray()
                 self._payload_head = 0
 
-                # respond to non-binary opcodes, their arrival is not guaranteed beacause of non-blocking sockets
-                if opcode == WebsocketWrapper.OPCODE_CONNCLOSE:
+                # respond to non-binary opcodes, their arrival is not guaranteed because of non-blocking sockets
+                if opcode == _WebsocketWrapper.OPCODE_CONNCLOSE:
                     frame = self._create_frame(
-                        WebsocketWrapper.OPCODE_CONNCLOSE, payload, 0)
+                        _WebsocketWrapper.OPCODE_CONNCLOSE, payload, 0)
                     self._socket.send(frame)
 
-                if opcode == WebsocketWrapper.OPCODE_PING:
+                if opcode == _WebsocketWrapper.OPCODE_PING:
                     frame = self._create_frame(
-                        WebsocketWrapper.OPCODE_PONG, payload, 0)
+                        _WebsocketWrapper.OPCODE_PONG, payload, 0)
                     self._socket.send(frame)
 
             # This isn't *proper* handling of continuation frames, but given
             # that we only support binary frames, it is *probably* good enough.
-            if (opcode == WebsocketWrapper.OPCODE_BINARY or opcode == WebsocketWrapper.OPCODE_CONTINUATION) \
+            if (opcode == _WebsocketWrapper.OPCODE_BINARY or opcode == _WebsocketWrapper.OPCODE_CONTINUATION) \
                     and payload_length > 0:
                 return result
             else:
@@ -3936,13 +4934,13 @@ class WebsocketWrapper(object):
             self.connected = False
             return b''
 
-    def _send_impl(self, data):
+    def _send_impl(self, data: bytes) -> int:
 
         # if previous frame was sent successfully
         if len(self._sendbuffer) == 0:
             # create websocket frame
             frame = self._create_frame(
-                WebsocketWrapper.OPCODE_BINARY, bytearray(data))
+                _WebsocketWrapper.OPCODE_BINARY, bytearray(data))
             self._sendbuffer.extend(frame)
             self._requested_size = len(data)
 
@@ -3958,32 +4956,32 @@ class WebsocketWrapper(object):
             # couldn't send whole data, request the same data again with 0 as sent length
             return 0
 
-    def recv(self, length):
+    def recv(self, length: int) -> bytes:
         return self._recv_impl(length)
 
-    def read(self, length):
+    def read(self, length: int) -> bytes:
         return self._recv_impl(length)
 
-    def send(self, data):
+    def send(self, data: bytes) -> int:
         return self._send_impl(data)
 
-    def write(self, data):
+    def write(self, data: bytes) -> int:
         return self._send_impl(data)
 
-    def close(self):
+    def close(self) -> None:
         self._socket.close()
 
-    def fileno(self):
+    def fileno(self) -> int:
         return self._socket.fileno()
 
-    def pending(self):
+    def pending(self) -> int:
         # Fix for bug #131: a SSL socket may still have data available
         # for reading without select() being aware of it.
         if self._ssl:
-            return self._socket.pending()
+            return self._socket.pending()  # type: ignore[union-attr]
         else:
             # normal socket rely only on select()
             return 0
 
-    def setblocking(self, flag):
+    def setblocking(self, flag: bool) -> None:
         self._socket.setblocking(flag)
diff --git a/lib/paho/mqtt/enums.py b/lib/paho/mqtt/enums.py
new file mode 100644
index 00000000..5428769f
--- /dev/null
+++ b/lib/paho/mqtt/enums.py
@@ -0,0 +1,113 @@
+import enum
+
+
+class MQTTErrorCode(enum.IntEnum):
+    MQTT_ERR_AGAIN = -1
+    MQTT_ERR_SUCCESS = 0
+    MQTT_ERR_NOMEM = 1
+    MQTT_ERR_PROTOCOL = 2
+    MQTT_ERR_INVAL = 3
+    MQTT_ERR_NO_CONN = 4
+    MQTT_ERR_CONN_REFUSED = 5
+    MQTT_ERR_NOT_FOUND = 6
+    MQTT_ERR_CONN_LOST = 7
+    MQTT_ERR_TLS = 8
+    MQTT_ERR_PAYLOAD_SIZE = 9
+    MQTT_ERR_NOT_SUPPORTED = 10
+    MQTT_ERR_AUTH = 11
+    MQTT_ERR_ACL_DENIED = 12
+    MQTT_ERR_UNKNOWN = 13
+    MQTT_ERR_ERRNO = 14
+    MQTT_ERR_QUEUE_SIZE = 15
+    MQTT_ERR_KEEPALIVE = 16
+
+
+class MQTTProtocolVersion(enum.IntEnum):
+    MQTTv31 = 3
+    MQTTv311 = 4
+    MQTTv5 = 5
+
+
+class CallbackAPIVersion(enum.Enum):
+    """Defined the arguments passed to all user-callback.
+
+    See each callbacks for details: `on_connect`, `on_connect_fail`, `on_disconnect`, `on_message`, `on_publish`,
+    `on_subscribe`, `on_unsubscribe`, `on_log`, `on_socket_open`, `on_socket_close`,
+    `on_socket_register_write`, `on_socket_unregister_write`
+    """
+    VERSION1 = 1
+    """The version used with paho-mqtt 1.x before introducing CallbackAPIVersion.
+
+    This version had different arguments depending if MQTTv5 or MQTTv3 was used. `Properties` & `ReasonCode` were missing
+    on some callback (apply only to MQTTv5).
+
+    This version is deprecated and will be removed in version 3.0.
+    """
+    VERSION2 = 2
+    """ This version fix some of the shortcoming of previous version.
+
+    Callback have the same signature if using MQTTv5 or MQTTv3. `ReasonCode` are used in MQTTv3.
+    """
+
+
+class MessageType(enum.IntEnum):
+    CONNECT = 0x10
+    CONNACK = 0x20
+    PUBLISH = 0x30
+    PUBACK = 0x40
+    PUBREC = 0x50
+    PUBREL = 0x60
+    PUBCOMP = 0x70
+    SUBSCRIBE = 0x80
+    SUBACK = 0x90
+    UNSUBSCRIBE = 0xA0
+    UNSUBACK = 0xB0
+    PINGREQ = 0xC0
+    PINGRESP = 0xD0
+    DISCONNECT = 0xE0
+    AUTH = 0xF0
+
+
+class LogLevel(enum.IntEnum):
+    MQTT_LOG_INFO = 0x01
+    MQTT_LOG_NOTICE = 0x02
+    MQTT_LOG_WARNING = 0x04
+    MQTT_LOG_ERR = 0x08
+    MQTT_LOG_DEBUG = 0x10
+
+
+class ConnackCode(enum.IntEnum):
+    CONNACK_ACCEPTED = 0
+    CONNACK_REFUSED_PROTOCOL_VERSION = 1
+    CONNACK_REFUSED_IDENTIFIER_REJECTED = 2
+    CONNACK_REFUSED_SERVER_UNAVAILABLE = 3
+    CONNACK_REFUSED_BAD_USERNAME_PASSWORD = 4
+    CONNACK_REFUSED_NOT_AUTHORIZED = 5
+
+
+class _ConnectionState(enum.Enum):
+    MQTT_CS_NEW = enum.auto()
+    MQTT_CS_CONNECT_ASYNC = enum.auto()
+    MQTT_CS_CONNECTING = enum.auto()
+    MQTT_CS_CONNECTED = enum.auto()
+    MQTT_CS_CONNECTION_LOST = enum.auto()
+    MQTT_CS_DISCONNECTING = enum.auto()
+    MQTT_CS_DISCONNECTED = enum.auto()
+
+
+class MessageState(enum.IntEnum):
+    MQTT_MS_INVALID = 0
+    MQTT_MS_PUBLISH = 1
+    MQTT_MS_WAIT_FOR_PUBACK = 2
+    MQTT_MS_WAIT_FOR_PUBREC = 3
+    MQTT_MS_RESEND_PUBREL = 4
+    MQTT_MS_WAIT_FOR_PUBREL = 5
+    MQTT_MS_RESEND_PUBCOMP = 6
+    MQTT_MS_WAIT_FOR_PUBCOMP = 7
+    MQTT_MS_SEND_PUBREC = 8
+    MQTT_MS_QUEUED = 9
+
+
+class PahoClientMode(enum.IntEnum):
+    MQTT_CLIENT = 0
+    MQTT_BRIDGE = 1
diff --git a/lib/paho/mqtt/matcher.py b/lib/paho/mqtt/matcher.py
index 01ce295c..b73c13ac 100644
--- a/lib/paho/mqtt/matcher.py
+++ b/lib/paho/mqtt/matcher.py
@@ -1,4 +1,4 @@
-class MQTTMatcher(object):
+class MQTTMatcher:
     """Intended to manage topic filters including wildcards.
 
     Internally, MQTTMatcher use a prefix tree (trie) to store
@@ -6,7 +6,7 @@ class MQTTMatcher(object):
     method to iterate efficiently over all filters that match
     some topic name."""
 
-    class Node(object):
+    class Node:
         __slots__ = '_children', '_content'
 
         def __init__(self):
@@ -33,8 +33,8 @@ class MQTTMatcher(object):
             if node._content is None:
                 raise KeyError(key)
             return node._content
-        except KeyError:
-            raise KeyError(key)
+        except KeyError as ke:
+            raise KeyError(key) from ke
 
     def __delitem__(self, key):
         """Delete the value associated with some topic filter :key"""
@@ -46,8 +46,8 @@ class MQTTMatcher(object):
                  lst.append((parent, k, node))
             # TODO
             node._content = None
-        except KeyError:
-            raise KeyError(key)
+        except KeyError as ke:
+            raise KeyError(key) from ke
         else:  # cleanup
             for parent, k, node in reversed(lst):
                 if node._children or node._content is not None:
diff --git a/lib/paho/mqtt/packettypes.py b/lib/paho/mqtt/packettypes.py
index 2fd6a1b5..d2051490 100644
--- a/lib/paho/mqtt/packettypes.py
+++ b/lib/paho/mqtt/packettypes.py
@@ -7,7 +7,7 @@
   and Eclipse Distribution License v1.0 which accompany this distribution.
 
   The Eclipse Public License is available at
-     http://www.eclipse.org/legal/epl-v10.html
+     http://www.eclipse.org/legal/epl-v20.html
   and the Eclipse Distribution License is available at
     http://www.eclipse.org/org/documents/edl-v10.php.
 
@@ -37,7 +37,7 @@ class PacketTypes:
     # Dummy packet type for properties use - will delay only applies to will
     WILLMESSAGE = 99
 
-    Names = [ "reserved", \
+    Names = ( "reserved", \
     "Connect", "Connack", "Publish", "Puback", "Pubrec", "Pubrel", \
     "Pubcomp", "Subscribe", "Suback", "Unsubscribe", "Unsuback", \
-    "Pingreq", "Pingresp", "Disconnect", "Auth"]
+    "Pingreq", "Pingresp", "Disconnect", "Auth")
diff --git a/lib/paho/mqtt/properties.py b/lib/paho/mqtt/properties.py
index dbcf543e..f307b865 100644
--- a/lib/paho/mqtt/properties.py
+++ b/lib/paho/mqtt/properties.py
@@ -1,23 +1,20 @@
-"""
-*******************************************************************
-  Copyright (c) 2017, 2019 IBM Corp.
-
-  All rights reserved. This program and the accompanying materials
-  are made available under the terms of the Eclipse Public License v2.0
-  and Eclipse Distribution License v1.0 which accompany this distribution.
-
-  The Eclipse Public License is available at
-     http://www.eclipse.org/legal/epl-v10.html
-  and the Eclipse Distribution License is available at
-    http://www.eclipse.org/org/documents/edl-v10.php.
-
-  Contributors:
-     Ian Craggs - initial implementation and/or documentation
-*******************************************************************
-"""
+# *******************************************************************
+#   Copyright (c) 2017, 2019 IBM Corp.
+#
+#   All rights reserved. This program and the accompanying materials
+#   are made available under the terms of the Eclipse Public License v2.0
+#   and Eclipse Distribution License v1.0 which accompany this distribution.
+#
+#   The Eclipse Public License is available at
+#      http://www.eclipse.org/legal/epl-v20.html
+#   and the Eclipse Distribution License is available at
+#     http://www.eclipse.org/org/documents/edl-v10.php.
+#
+#   Contributors:
+#      Ian Craggs - initial implementation and/or documentation
+# *******************************************************************
 
 import struct
-import sys
 
 from .packettypes import PacketTypes
 
@@ -52,10 +49,8 @@ def readInt32(buf):
 
 def writeUTF(data):
     # data could be a string, or bytes.  If string, encode into bytes with utf-8
-    if sys.version_info[0] < 3:
-        data = bytearray(data, 'utf-8')
-    else:
-        data = data if type(data) == type(b"") else bytes(data, "utf-8")
+    if not isinstance(data, bytes):
+        data = bytes(data, "utf-8")
     return writeInt16(len(data)) + data
 
 
@@ -100,19 +95,17 @@ class VariableByteIntegers:  # Variable Byte Integer
     def encode(x):
         """
           Convert an integer 0 <= x <= 268435455 into multi-byte format.
-          Returns the buffer convered from the integer.
+          Returns the buffer converted from the integer.
         """
-        assert 0 <= x <= 268435455
+        if not 0 <= x <= 268435455:
+            raise ValueError(f"Value {x!r} must be in range 0-268435455")
         buffer = b''
         while 1:
             digit = x % 128
             x //= 128
             if x > 0:
                 digit |= 0x80
-            if sys.version_info[0] >= 3:
-                buffer += bytes([digit])
-            else:
-                buffer += bytes(chr(digit))
+            buffer += bytes([digit])
             if x == 0:
                 break
         return buffer
@@ -139,21 +132,21 @@ class VariableByteIntegers:  # Variable Byte Integer
         return (value, bytes)
 
 
-class Properties(object):
+class Properties:
     """MQTT v5.0 properties class.
 
     See Properties.names for a list of accepted property names along with their numeric values.
 
     See Properties.properties for the data type of each property.
 
-    Example of use:
+    Example of use::
 
         publish_properties = Properties(PacketTypes.PUBLISH)
         publish_properties.UserProperty = ("a", "2")
         publish_properties.UserProperty = ("c", "3")
 
     First the object is created with packet type as argument, no properties will be present at
-    this point.  Then properties are added as attributes, the name of which is the string property
+    this point. Then properties are added as attributes, the name of which is the string property
     name without the spaces.
 
     """
@@ -264,37 +257,33 @@ class Properties(object):
             # the name could have spaces in, or not.  Remove spaces before assignment
             if name not in [aname.replace(' ', '') for aname in self.names.keys()]:
                 raise MQTTException(
-                    "Property name must be one of "+str(self.names.keys()))
+                    f"Property name must be one of {self.names.keys()}")
             # check that this attribute applies to the packet type
             if self.packetType not in self.properties[self.getIdentFromName(name)][1]:
-                raise MQTTException("Property %s does not apply to packet type %s"
-                                    % (name, PacketTypes.Names[self.packetType]))
+                raise MQTTException(f"Property {name} does not apply to packet type {PacketTypes.Names[self.packetType]}")
 
             # Check for forbidden values
-            if type(value) != type([]):
+            if not isinstance(value, list):
                 if name in ["ReceiveMaximum", "TopicAlias"] \
                         and (value < 1 or value > 65535):
 
-                    raise MQTTException(
-                        "%s property value must be in the range 1-65535" % (name))
+                    raise MQTTException(f"{name} property value must be in the range 1-65535")
                 elif name in ["TopicAliasMaximum"] \
                         and (value < 0 or value > 65535):
 
-                    raise MQTTException(
-                        "%s property value must be in the range 0-65535" % (name))
+                    raise MQTTException(f"{name} property value must be in the range 0-65535")
                 elif name in ["MaximumPacketSize", "SubscriptionIdentifier"] \
                         and (value < 1 or value > 268435455):
 
-                    raise MQTTException(
-                        "%s property value must be in the range 1-268435455" % (name))
+                    raise MQTTException(f"{name} property value must be in the range 1-268435455")
                 elif name in ["RequestResponseInformation", "RequestProblemInformation", "PayloadFormatIndicator"] \
                         and (value != 0 and value != 1):
 
                     raise MQTTException(
-                        "%s property value must be 0 or 1" % (name))
+                        f"{name} property value must be 0 or 1")
 
             if self.allowsMultiple(name):
-                if type(value) != type([]):
+                if not isinstance(value, list):
                     value = [value]
                 if hasattr(self, name):
                     value = object.__getattribute__(self, name) + value
@@ -308,8 +297,7 @@ class Properties(object):
             if hasattr(self, compressedName):
                 if not first:
                     buffer += ", "
-                buffer += compressedName + " : " + \
-                    str(getattr(self, compressedName))
+                buffer += f"{compressedName} : {getattr(self, compressedName)}"
                 first = False
         buffer += "]"
         return buffer
@@ -345,10 +333,7 @@ class Properties(object):
         buffer = b""
         buffer += VariableByteIntegers.encode(identifier)  # identifier
         if type == self.types.index("Byte"):  # value
-            if sys.version_info[0] < 3:
-                buffer += chr(value)
-            else:
-                buffer += bytes([value])
+            buffer += bytes([value])
         elif type == self.types.index("Two Byte Integer"):
             buffer += writeInt16(value)
         elif type == self.types.index("Four Byte Integer"):
@@ -412,8 +397,6 @@ class Properties(object):
         return rc
 
     def unpack(self, buffer):
-        if sys.version_info[0] < 3:
-            buffer = bytearray(buffer)
         self.clear()
         # deserialize properties into attributes from buffer received from network
         propslen, VBIlen = VariableByteIntegers.decode(buffer)
@@ -433,6 +416,6 @@ class Properties(object):
             compressedName = propname.replace(' ', '')
             if not self.allowsMultiple(compressedName) and hasattr(self, compressedName):
                 raise MQTTException(
-                    "Property '%s' must not exist more than once" % property)
+                    f"Property '{property}' must not exist more than once")
             setattr(self, propname, value)
         return self, propslen + VBIlen
diff --git a/lib/paho/mqtt/publish.py b/lib/paho/mqtt/publish.py
index 6d1589a7..42435156 100644
--- a/lib/paho/mqtt/publish.py
+++ b/lib/paho/mqtt/publish.py
@@ -5,7 +5,7 @@
 # and Eclipse Distribution License v1.0 which accompany this distribution.
 #
 # The Eclipse Public License is available at
-#    http://www.eclipse.org/legal/epl-v10.html
+#    http://www.eclipse.org/legal/epl-v20.html
 # and the Eclipse Distribution License is available at
 #   http://www.eclipse.org/org/documents/edl-v10.php.
 #
@@ -18,20 +18,58 @@ of messages in a one-shot manner. In other words, they are useful for the
 situation where you have a single/multiple messages you want to publish to a
 broker, then disconnect and nothing else is required.
 """
-from __future__ import absolute_import
+from __future__ import annotations
 
 import collections
+from collections.abc import Iterable
+from typing import TYPE_CHECKING, Any, List, Tuple, Union
 
-try:
-    from collections.abc import Iterable
-except ImportError:
-    from collections import Iterable
+from paho.mqtt.enums import CallbackAPIVersion
+from paho.mqtt.properties import Properties
+from paho.mqtt.reasoncodes import ReasonCode
 
 from .. import mqtt
 from . import client as paho
 
+if TYPE_CHECKING:
+    try:
+        from typing import NotRequired, Required, TypedDict  # type: ignore
+    except ImportError:
+        from typing_extensions import NotRequired, Required, TypedDict
 
-def _do_publish(client):
+    try:
+        from typing import Literal
+    except ImportError:
+        from typing_extensions import Literal  # type: ignore
+
+
+
+    class AuthParameter(TypedDict, total=False):
+        username: Required[str]
+        password: NotRequired[str]
+
+
+    class TLSParameter(TypedDict, total=False):
+        ca_certs: Required[str]
+        certfile: NotRequired[str]
+        keyfile: NotRequired[str]
+        tls_version: NotRequired[int]
+        ciphers: NotRequired[str]
+        insecure: NotRequired[bool]
+
+
+    class MessageDict(TypedDict, total=False):
+        topic: Required[str]
+        payload: NotRequired[paho.PayloadType]
+        qos: NotRequired[int]
+        retain: NotRequired[bool]
+
+    MessageTuple = Tuple[str, paho.PayloadType, int, bool]
+
+    MessagesList = List[Union[MessageDict, MessageTuple]]
+
+
+def _do_publish(client: paho.Client):
     """Internal function"""
 
     message = client._userdata.popleft()
@@ -44,21 +82,18 @@ def _do_publish(client):
         raise TypeError('message must be a dict, tuple, or list')
 
 
-def _on_connect(client, userdata, flags, rc):
-    """Internal callback"""
-    #pylint: disable=invalid-name, unused-argument
-
-    if rc == 0:
+def _on_connect(client: paho.Client, userdata: MessagesList, flags, reason_code, properties):
+    """Internal v5 callback"""
+    if reason_code == 0:
         if len(userdata) > 0:
             _do_publish(client)
     else:
-        raise mqtt.MQTTException(paho.connack_string(rc))
+        raise mqtt.MQTTException(paho.connack_string(reason_code))
 
-def _on_connect_v5(client, userdata, flags, rc, properties):
-    """Internal v5 callback"""
-    _on_connect(client, userdata, flags, rc)
 
-def _on_publish(client, userdata, mid):
+def _on_publish(
+    client: paho.Client, userdata: collections.deque[MessagesList], mid: int, reason_codes: ReasonCode, properties: Properties,
+) -> None:
     """Internal callback"""
     #pylint: disable=unused-argument
 
@@ -68,16 +103,26 @@ def _on_publish(client, userdata, mid):
         _do_publish(client)
 
 
-def multiple(msgs, hostname="localhost", port=1883, client_id="", keepalive=60,
-             will=None, auth=None, tls=None, protocol=paho.MQTTv311,
-             transport="tcp", proxy_args=None):
+def multiple(
+    msgs: MessagesList,
+    hostname: str = "localhost",
+    port: int = 1883,
+    client_id: str = "",
+    keepalive: int = 60,
+    will: MessageDict | None = None,
+    auth: AuthParameter | None = None,
+    tls: TLSParameter | None = None,
+    protocol: int = paho.MQTTv311,
+    transport: Literal["tcp", "websockets"] = "tcp",
+    proxy_args: Any | None = None,
+) -> None:
     """Publish multiple messages to a broker, then disconnect cleanly.
 
     This function creates an MQTT client, connects to a broker and publishes a
     list of messages. Once the messages have been delivered, it disconnects
     cleanly from the broker.
 
-    msgs : a list of messages to publish. Each message is either a dict or a
+    :param msgs: a list of messages to publish. Each message is either a dict or a
            tuple.
 
            If a dict, only the topic must be present. Default values will be
@@ -94,30 +139,30 @@ def multiple(msgs, hostname="localhost", port=1883, client_id="", keepalive=60,
            If a tuple, then it must be of the form:
            ("<topic>", "<payload>", qos, retain)
 
-    hostname : a string containing the address of the broker to connect to.
+    :param str hostname: the address of the broker to connect to.
                Defaults to localhost.
 
-    port : the port to connect to the broker on. Defaults to 1883.
+    :param int port: the port to connect to the broker on. Defaults to 1883.
 
-    client_id : the MQTT client id to use. If "" or None, the Paho library will
+    :param str client_id: the MQTT client id to use. If "" or None, the Paho library will
                 generate a client id automatically.
 
-    keepalive : the keepalive timeout value for the client. Defaults to 60
+    :param int keepalive: the keepalive timeout value for the client. Defaults to 60
                 seconds.
 
-    will : a dict containing will parameters for the client: will = {'topic':
+    :param will: a dict containing will parameters for the client: will = {'topic':
            "<topic>", 'payload':"<payload">, 'qos':<qos>, 'retain':<retain>}.
            Topic is required, all other parameters are optional and will
            default to None, 0 and False respectively.
            Defaults to None, which indicates no will should be used.
 
-    auth : a dict containing authentication parameters for the client:
+    :param auth: a dict containing authentication parameters for the client:
            auth = {'username':"<username>", 'password':"<password>"}
            Username is required, password is optional and will default to None
            if not provided.
            Defaults to None, which indicates no authentication is to be used.
 
-    tls : a dict containing TLS configuration parameters for the client:
+    :param tls: a dict containing TLS configuration parameters for the client:
           dict = {'ca_certs':"<ca_certs>", 'certfile':"<certfile>",
           'keyfile':"<keyfile>", 'tls_version':"<tls_version>",
           'ciphers':"<ciphers">, 'insecure':"<bool>"}
@@ -128,23 +173,28 @@ def multiple(msgs, hostname="localhost", port=1883, client_id="", keepalive=60,
           processed using the tls_set_context method.
           Defaults to None, which indicates that TLS should not be used.
 
-    transport : set to "tcp" to use the default setting of transport which is
+    :param str transport: set to "tcp" to use the default setting of transport which is
           raw TCP. Set to "websockets" to use WebSockets as the transport.
-    proxy_args: a dictionary that will be given to the client.
+
+    :param proxy_args: a dictionary that will be given to the client.
     """
 
     if not isinstance(msgs, Iterable):
         raise TypeError('msgs must be an iterable')
+    if len(msgs) == 0:
+        raise ValueError('msgs is empty')
 
+    client = paho.Client(
+        CallbackAPIVersion.VERSION2,
+        client_id=client_id,
+        userdata=collections.deque(msgs),
+        protocol=protocol,
+        transport=transport,
+    )
 
-    client = paho.Client(client_id=client_id, userdata=collections.deque(msgs),
-                         protocol=protocol, transport=transport)
-
+    client.enable_logger()
     client.on_publish = _on_publish
-    if protocol == mqtt.client.MQTTv5:
-        client.on_connect = _on_connect_v5
-    else:
-        client.on_connect = _on_connect
+    client.on_connect = _on_connect  # type: ignore
 
     if proxy_args is not None:
         client.proxy_set(**proxy_args)
@@ -164,7 +214,8 @@ def multiple(msgs, hostname="localhost", port=1883, client_id="", keepalive=60,
     if tls is not None:
         if isinstance(tls, dict):
             insecure = tls.pop('insecure', False)
-            client.tls_set(**tls)
+            # mypy don't get that tls no longer contains the key insecure
+            client.tls_set(**tls)  # type: ignore[misc]
             if insecure:
                 # Must be set *after* the `client.tls_set()` call since it sets
                 # up the SSL context that `client.tls_insecure_set` alters.
@@ -177,49 +228,62 @@ def multiple(msgs, hostname="localhost", port=1883, client_id="", keepalive=60,
     client.loop_forever()
 
 
-def single(topic, payload=None, qos=0, retain=False, hostname="localhost",
-           port=1883, client_id="", keepalive=60, will=None, auth=None,
-           tls=None, protocol=paho.MQTTv311, transport="tcp", proxy_args=None):
+def single(
+    topic: str,
+    payload: paho.PayloadType = None,
+    qos: int = 0,
+    retain: bool = False,
+    hostname: str = "localhost",
+    port: int = 1883,
+    client_id: str = "",
+    keepalive: int = 60,
+    will: MessageDict | None = None,
+    auth: AuthParameter | None = None,
+    tls: TLSParameter | None = None,
+    protocol: int = paho.MQTTv311,
+    transport: Literal["tcp", "websockets"] = "tcp",
+    proxy_args: Any | None = None,
+) -> None:
     """Publish a single message to a broker, then disconnect cleanly.
 
     This function creates an MQTT client, connects to a broker and publishes a
     single message. Once the message has been delivered, it disconnects cleanly
     from the broker.
 
-    topic : the only required argument must be the topic string to which the
+    :param str topic: the only required argument must be the topic string to which the
             payload will be published.
 
-    payload : the payload to be published. If "" or None, a zero length payload
+    :param payload: the payload to be published. If "" or None, a zero length payload
               will be published.
 
-    qos : the qos to use when publishing,  default to 0.
+    :param int qos: the qos to use when publishing,  default to 0.
 
-    retain : set the message to be retained (True) or not (False).
+    :param bool retain: set the message to be retained (True) or not (False).
 
-    hostname : a string containing the address of the broker to connect to.
+    :param str hostname: the address of the broker to connect to.
                Defaults to localhost.
 
-    port : the port to connect to the broker on. Defaults to 1883.
+    :param int port: the port to connect to the broker on. Defaults to 1883.
 
-    client_id : the MQTT client id to use. If "" or None, the Paho library will
+    :param str client_id: the MQTT client id to use. If "" or None, the Paho library will
                 generate a client id automatically.
 
-    keepalive : the keepalive timeout value for the client. Defaults to 60
+    :param int keepalive: the keepalive timeout value for the client. Defaults to 60
                 seconds.
 
-    will : a dict containing will parameters for the client: will = {'topic':
+    :param will: a dict containing will parameters for the client: will = {'topic':
            "<topic>", 'payload':"<payload">, 'qos':<qos>, 'retain':<retain>}.
            Topic is required, all other parameters are optional and will
            default to None, 0 and False respectively.
            Defaults to None, which indicates no will should be used.
 
-    auth : a dict containing authentication parameters for the client:
-           auth = {'username':"<username>", 'password':"<password>"}
+    :param auth: a dict containing authentication parameters for the client:
            Username is required, password is optional and will default to None
+           auth = {'username':"<username>", 'password':"<password>"}
            if not provided.
            Defaults to None, which indicates no authentication is to be used.
 
-    tls : a dict containing TLS configuration parameters for the client:
+    :param tls: a dict containing TLS configuration parameters for the client:
           dict = {'ca_certs':"<ca_certs>", 'certfile':"<certfile>",
           'keyfile':"<keyfile>", 'tls_version':"<tls_version>",
           'ciphers':"<ciphers">, 'insecure':"<bool>"}
@@ -230,12 +294,13 @@ def single(topic, payload=None, qos=0, retain=False, hostname="localhost",
           Alternatively, tls input can be an SSLContext object, which will be
           processed using the tls_set_context method.
 
-    transport : set to "tcp" to use the default setting of transport which is
+    :param transport: set to "tcp" to use the default setting of transport which is
           raw TCP. Set to "websockets" to use WebSockets as the transport.
-    proxy_args: a dictionary that will be given to the client.
+
+    :param proxy_args: a dictionary that will be given to the client.
     """
 
-    msg = {'topic':topic, 'payload':payload, 'qos':qos, 'retain':retain}
+    msg: MessageDict = {'topic':topic, 'payload':payload, 'qos':qos, 'retain':retain}
 
     multiple([msg], hostname, port, client_id, keepalive, will, auth, tls,
              protocol, transport, proxy_args)
diff --git a/lib/paho/mqtt/py.typed b/lib/paho/mqtt/py.typed
new file mode 100644
index 00000000..e69de29b
diff --git a/lib/paho/mqtt/reasoncodes.py b/lib/paho/mqtt/reasoncodes.py
index c42e5ba9..6b30cb83 100644
--- a/lib/paho/mqtt/reasoncodes.py
+++ b/lib/paho/mqtt/reasoncodes.py
@@ -1,30 +1,31 @@
-"""
-*******************************************************************
-  Copyright (c) 2017, 2019 IBM Corp.
+# *******************************************************************
+#   Copyright (c) 2017, 2019 IBM Corp.
+#
+#   All rights reserved. This program and the accompanying materials
+#   are made available under the terms of the Eclipse Public License v2.0
+#   and Eclipse Distribution License v1.0 which accompany this distribution.
+#
+#   The Eclipse Public License is available at
+#      http://www.eclipse.org/legal/epl-v20.html
+#   and the Eclipse Distribution License is available at
+#     http://www.eclipse.org/org/documents/edl-v10.php.
+#
+#   Contributors:
+#      Ian Craggs - initial implementation and/or documentation
+# *******************************************************************
 
-  All rights reserved. This program and the accompanying materials
-  are made available under the terms of the Eclipse Public License v2.0
-  and Eclipse Distribution License v1.0 which accompany this distribution.
-
-  The Eclipse Public License is available at
-     http://www.eclipse.org/legal/epl-v10.html
-  and the Eclipse Distribution License is available at
-    http://www.eclipse.org/org/documents/edl-v10.php.
-
-  Contributors:
-     Ian Craggs - initial implementation and/or documentation
-*******************************************************************
-"""
-
-import sys
+import functools
+import warnings
+from typing import Any
 
 from .packettypes import PacketTypes
 
 
-class ReasonCodes:
+@functools.total_ordering
+class ReasonCode:
     """MQTT version 5.0 reason codes class.
 
-    See ReasonCodes.names for a list of possible numeric values along with their
+    See ReasonCode.names for a list of possible numeric values along with their
     names and the packets to which they apply.
 
     """
@@ -135,10 +136,12 @@ class ReasonCodes:
 
         Used when displaying the reason code.
         """
-        assert identifier in self.names.keys(), identifier
+        if identifier not in self.names:
+            raise KeyError(identifier)
         names = self.names[identifier]
         namelist = [name for name in names.keys() if packetType in names[name]]
-        assert len(namelist) == 1
+        if len(namelist) != 1:
+            raise ValueError(f"Expected exactly one name, found {namelist!r}")
         return namelist[0]
 
     def getId(self, name):
@@ -148,22 +151,17 @@ class ReasonCodes:
         Used when setting the reason code for a packetType
         check that only valid codes for the packet are set.
         """
-        identifier = None
         for code in self.names.keys():
             if name in self.names[code].keys():
                 if self.packetType in self.names[code][name]:
-                    identifier = code
-                break
-        assert identifier is not None, name
-        return identifier
+                    return code
+        raise KeyError(f"Reason code name not found: {name}")
 
     def set(self, name):
         self.value = self.getId(name)
 
     def unpack(self, buffer):
         c = buffer[0]
-        if sys.version_info[0] < 3:
-            c = ord(c)
         name = self.__getName__(self.packetType, c)
         self.value = self.getId(name)
         return 1
@@ -177,11 +175,26 @@ class ReasonCodes:
         if isinstance(other, int):
             return self.value == other
         if isinstance(other, str):
-            return self.value == str(self)
-        if isinstance(other, ReasonCodes):
+            return other == str(self)
+        if isinstance(other, ReasonCode):
             return self.value == other.value
         return False
 
+    def __lt__(self, other):
+        if isinstance(other, int):
+            return self.value < other
+        if isinstance(other, ReasonCode):
+            return self.value < other.value
+        return NotImplemented
+
+    def __repr__(self):
+        try:
+            packet_name = PacketTypes.Names[self.packetType]
+        except IndexError:
+            packet_name = "Unknown"
+
+        return f"ReasonCode({packet_name}, {self.getName()!r})"
+
     def __str__(self):
         return self.getName()
 
@@ -190,3 +203,21 @@ class ReasonCodes:
 
     def pack(self):
         return bytearray([self.value])
+
+    @property
+    def is_failure(self) -> bool:
+        return self.value >= 0x80
+
+
+class _CompatibilityIsInstance(type):
+    def __instancecheck__(self, other: Any) -> bool:
+        return isinstance(other, ReasonCode)
+
+
+class ReasonCodes(ReasonCode, metaclass=_CompatibilityIsInstance):
+    def __init__(self, *args, **kwargs):
+        warnings.warn("ReasonCodes is deprecated, use ReasonCode (singular) instead",
+            category=DeprecationWarning,
+            stacklevel=2,
+        )
+        super().__init__(*args, **kwargs)
diff --git a/lib/paho/mqtt/subscribe.py b/lib/paho/mqtt/subscribe.py
index 643df9c1..b6c80f44 100644
--- a/lib/paho/mqtt/subscribe.py
+++ b/lib/paho/mqtt/subscribe.py
@@ -5,7 +5,7 @@
 # and Eclipse Distribution License v1.0 which accompany this distribution.
 #
 # The Eclipse Public License is available at
-#    http://www.eclipse.org/legal/epl-v10.html
+#    http://www.eclipse.org/legal/epl-v20.html
 # and the Eclipse Distribution License is available at
 #   http://www.eclipse.org/org/documents/edl-v10.php.
 #
@@ -18,16 +18,15 @@ to topics and retrieving messages. The two functions are simple(), which
 returns one or messages matching a set of topics, and callback() which allows
 you to pass a callback for processing of messages.
 """
-from __future__ import absolute_import
 
 from .. import mqtt
 from . import client as paho
 
 
-def _on_connect_v5(client, userdata, flags, rc, properties):
+def _on_connect(client, userdata, flags, reason_code, properties):
     """Internal callback"""
-    if rc != 0:
-        raise mqtt.MQTTException(paho.connack_string(rc))
+    if reason_code != 0:
+        raise mqtt.MQTTException(paho.connack_string(reason_code))
 
     if isinstance(userdata['topics'], list):
         for topic in userdata['topics']:
@@ -35,10 +34,6 @@ def _on_connect_v5(client, userdata, flags, rc, properties):
     else:
         client.subscribe(userdata['topics'], userdata['qos'])
 
-def _on_connect(client, userdata, flags, rc):
-    """Internal v5 callback"""
-    _on_connect_v5(client, userdata, flags, rc, None)
-
 
 def _on_message_callback(client, userdata, message):
     """Internal callback"""
@@ -77,40 +72,41 @@ def callback(callback, topics, qos=0, userdata=None, hostname="localhost",
     to a list of topics. Incoming messages are processed by the user provided
     callback.  This is a blocking function and will never return.
 
-    callback : function of the form "on_message(client, userdata, message)" for
+    :param callback: function with the same signature as `on_message` for
                processing the messages received.
 
-    topics : either a string containing a single topic to subscribe to, or a
+    :param topics: either a string containing a single topic to subscribe to, or a
              list of topics to subscribe to.
 
-    qos : the qos to use when subscribing. This is applied to all topics.
+    :param int qos: the qos to use when subscribing. This is applied to all topics.
 
-    userdata : passed to the callback
+    :param userdata: passed to the callback
 
-    hostname : a string containing the address of the broker to connect to.
+    :param str hostname: the address of the broker to connect to.
                Defaults to localhost.
 
-    port : the port to connect to the broker on. Defaults to 1883.
+    :param int port: the port to connect to the broker on. Defaults to 1883.
 
-    client_id : the MQTT client id to use. If "" or None, the Paho library will
+    :param str client_id: the MQTT client id to use. If "" or None, the Paho library will
                 generate a client id automatically.
 
-    keepalive : the keepalive timeout value for the client. Defaults to 60
+    :param int keepalive: the keepalive timeout value for the client. Defaults to 60
                 seconds.
 
-    will : a dict containing will parameters for the client: will = {'topic':
+    :param will: a dict containing will parameters for the client: will = {'topic':
            "<topic>", 'payload':"<payload">, 'qos':<qos>, 'retain':<retain>}.
            Topic is required, all other parameters are optional and will
            default to None, 0 and False respectively.
+
            Defaults to None, which indicates no will should be used.
 
-    auth : a dict containing authentication parameters for the client:
+    :param auth: a dict containing authentication parameters for the client:
            auth = {'username':"<username>", 'password':"<password>"}
            Username is required, password is optional and will default to None
            if not provided.
            Defaults to None, which indicates no authentication is to be used.
 
-    tls : a dict containing TLS configuration parameters for the client:
+    :param tls: a dict containing TLS configuration parameters for the client:
           dict = {'ca_certs':"<ca_certs>", 'certfile':"<certfile>",
           'keyfile':"<keyfile>", 'tls_version':"<tls_version>",
           'ciphers':"<ciphers">, 'insecure':"<bool>"}
@@ -121,17 +117,17 @@ def callback(callback, topics, qos=0, userdata=None, hostname="localhost",
           processed using the tls_set_context method.
           Defaults to None, which indicates that TLS should not be used.
 
-    transport : set to "tcp" to use the default setting of transport which is
+    :param str transport: set to "tcp" to use the default setting of transport which is
           raw TCP. Set to "websockets" to use WebSockets as the transport.
 
-    clean_session : a boolean that determines the client type. If True,
+    :param clean_session: a boolean that determines the client type. If True,
                     the broker will remove all information about this client
                     when it disconnects. If False, the client is a persistent
                     client and subscription information and queued messages
                     will be retained when the client disconnects.
                     Defaults to True.
 
-    proxy_args: a dictionary that will be given to the client.
+    :param proxy_args: a dictionary that will be given to the client.
     """
 
     if qos < 0 or qos > 2:
@@ -143,14 +139,18 @@ def callback(callback, topics, qos=0, userdata=None, hostname="localhost",
         'qos':qos,
         'userdata':userdata}
 
-    client = paho.Client(client_id=client_id, userdata=callback_userdata,
-                         protocol=protocol, transport=transport,
-                         clean_session=clean_session)
+    client = paho.Client(
+        paho.CallbackAPIVersion.VERSION2,
+        client_id=client_id,
+        userdata=callback_userdata,
+        protocol=protocol,
+        transport=transport,
+        clean_session=clean_session,
+    )
+    client.enable_logger()
+
     client.on_message = _on_message_callback
-    if protocol == mqtt.client.MQTTv5:
-        client.on_connect = _on_connect_v5
-    else:
-        client.on_connect = _on_connect
+    client.on_connect = _on_connect
 
     if proxy_args is not None:
         client.proxy_set(**proxy_args)
@@ -193,45 +193,45 @@ def simple(topics, qos=0, msg_count=1, retained=True, hostname="localhost",
     to a list of topics. Once "msg_count" messages have been received, it
     disconnects cleanly from the broker and returns the messages.
 
-    topics : either a string containing a single topic to subscribe to, or a
+    :param topics: either a string containing a single topic to subscribe to, or a
              list of topics to subscribe to.
 
-    qos : the qos to use when subscribing. This is applied to all topics.
+    :param int qos: the qos to use when subscribing. This is applied to all topics.
 
-    msg_count : the number of messages to retrieve from the broker.
+    :param int msg_count: the number of messages to retrieve from the broker.
                 if msg_count == 1 then a single MQTTMessage will be returned.
                 if msg_count > 1 then a list of MQTTMessages will be returned.
 
-    retained : If set to True, retained messages will be processed the same as
+    :param bool retained: If set to True, retained messages will be processed the same as
                non-retained messages. If set to False, retained messages will
                be ignored. This means that with retained=False and msg_count=1,
                the function will return the first message received that does
                not have the retained flag set.
 
-    hostname : a string containing the address of the broker to connect to.
+    :param str hostname: the address of the broker to connect to.
                Defaults to localhost.
 
-    port : the port to connect to the broker on. Defaults to 1883.
+    :param int port: the port to connect to the broker on. Defaults to 1883.
 
-    client_id : the MQTT client id to use. If "" or None, the Paho library will
+    :param str client_id: the MQTT client id to use. If "" or None, the Paho library will
                 generate a client id automatically.
 
-    keepalive : the keepalive timeout value for the client. Defaults to 60
+    :param int keepalive: the keepalive timeout value for the client. Defaults to 60
                 seconds.
 
-    will : a dict containing will parameters for the client: will = {'topic':
+    :param will: a dict containing will parameters for the client: will = {'topic':
            "<topic>", 'payload':"<payload">, 'qos':<qos>, 'retain':<retain>}.
            Topic is required, all other parameters are optional and will
            default to None, 0 and False respectively.
            Defaults to None, which indicates no will should be used.
 
-    auth : a dict containing authentication parameters for the client:
+    :param auth: a dict containing authentication parameters for the client:
            auth = {'username':"<username>", 'password':"<password>"}
            Username is required, password is optional and will default to None
            if not provided.
            Defaults to None, which indicates no authentication is to be used.
 
-    tls : a dict containing TLS configuration parameters for the client:
+    :param tls: a dict containing TLS configuration parameters for the client:
           dict = {'ca_certs':"<ca_certs>", 'certfile':"<certfile>",
           'keyfile':"<keyfile>", 'tls_version':"<tls_version>",
           'ciphers':"<ciphers">, 'insecure':"<bool>"}
@@ -242,17 +242,20 @@ def simple(topics, qos=0, msg_count=1, retained=True, hostname="localhost",
           processed using the tls_set_context method.
           Defaults to None, which indicates that TLS should not be used.
 
-    transport : set to "tcp" to use the default setting of transport which is
+    :param protocol: the MQTT protocol version to use. Defaults to MQTTv311.
+
+    :param transport: set to "tcp" to use the default setting of transport which is
           raw TCP. Set to "websockets" to use WebSockets as the transport.
 
-    clean_session : a boolean that determines the client type. If True,
+    :param clean_session: a boolean that determines the client type. If True,
                     the broker will remove all information about this client
                     when it disconnects. If False, the client is a persistent
                     client and subscription information and queued messages
                     will be retained when the client disconnects.
-                    Defaults to True.
+                    Defaults to True. If protocol is MQTTv50, clean_session
+                    is ignored.
 
-    proxy_args: a dictionary that will be given to the client.
+    :param proxy_args: a dictionary that will be given to the client.
     """
 
     if msg_count < 1:
@@ -265,6 +268,10 @@ def simple(topics, qos=0, msg_count=1, retained=True, hostname="localhost",
     else:
         messages = []
 
+    # Ignore clean_session if protocol is MQTTv50, otherwise Client will raise
+    if protocol == paho.MQTTv5:
+        clean_session = None
+
     userdata = {'retained':retained, 'msg_count':msg_count, 'messages':messages}
 
     callback(_on_message_simple, topics, qos, userdata, hostname, port,
diff --git a/lib/paho/mqtt/subscribeoptions.py b/lib/paho/mqtt/subscribeoptions.py
index 5b4f0733..7e0605de 100644
--- a/lib/paho/mqtt/subscribeoptions.py
+++ b/lib/paho/mqtt/subscribeoptions.py
@@ -7,7 +7,7 @@
   and Eclipse Distribution License v1.0 which accompany this distribution.
 
   The Eclipse Public License is available at
-     http://www.eclipse.org/legal/epl-v10.html
+     http://www.eclipse.org/legal/epl-v20.html
   and the Eclipse Distribution License is available at
     http://www.eclipse.org/org/documents/edl-v10.php.
 
@@ -16,14 +16,13 @@
 *******************************************************************
 """
 
-import sys
 
 
 class MQTTException(Exception):
     pass
 
 
-class SubscribeOptions(object):
+class SubscribeOptions:
     """The MQTT v5.0 subscribe options class.
 
     The options are:
@@ -42,7 +41,13 @@ class SubscribeOptions(object):
     RETAIN_SEND_ON_SUBSCRIBE, RETAIN_SEND_IF_NEW_SUB, RETAIN_DO_NOT_SEND = range(
         0, 3)
 
-    def __init__(self, qos=0, noLocal=False, retainAsPublished=False, retainHandling=RETAIN_SEND_ON_SUBSCRIBE):
+    def __init__(
+        self,
+        qos: int = 0,
+        noLocal: bool = False,
+        retainAsPublished: bool = False,
+        retainHandling: int = RETAIN_SEND_ON_SUBSCRIBE,
+    ):
         """
         qos:                0, 1 or 2.  0 is the default.
         noLocal:            True or False. False is the default and corresponds to MQTT v3.1.1 behavior.
@@ -56,29 +61,27 @@ class SubscribeOptions(object):
         self.noLocal = noLocal  # bit 2
         self.retainAsPublished = retainAsPublished  # bit 3
         self.retainHandling = retainHandling  # bits 4 and 5: 0, 1 or 2
-        assert self.QoS in [0, 1, 2]
-        assert self.retainHandling in [
-            0, 1, 2], "Retain handling should be 0, 1 or 2"
+        if self.retainHandling not in (0, 1, 2):
+            raise AssertionError(f"Retain handling should be 0, 1 or 2, not {self.retainHandling}")
+        if self.QoS not in (0, 1, 2):
+            raise AssertionError(f"QoS should be 0, 1 or 2, not {self.QoS}")
 
     def __setattr__(self, name, value):
         if name not in self.names:
             raise MQTTException(
-                name + " Attribute name must be one of "+str(self.names))
+                f"{name} Attribute name must be one of {self.names}")
         object.__setattr__(self, name, value)
 
     def pack(self):
-        assert self.QoS in [0, 1, 2]
-        assert self.retainHandling in [
-            0, 1, 2], "Retain handling should be 0, 1 or 2"
+        if self.retainHandling not in (0, 1, 2):
+            raise AssertionError(f"Retain handling should be 0, 1 or 2, not {self.retainHandling}")
+        if self.QoS not in (0, 1, 2):
+            raise AssertionError(f"QoS should be 0, 1 or 2, not {self.QoS}")
         noLocal = 1 if self.noLocal else 0
         retainAsPublished = 1 if self.retainAsPublished else 0
         data = [(self.retainHandling << 4) | (retainAsPublished << 3) |
                 (noLocal << 2) | self.QoS]
-        if sys.version_info[0] >= 3:
-            buffer = bytes(data)
-        else:
-            buffer = bytearray(data)
-        return buffer
+        return bytes(data)
 
     def unpack(self, buffer):
         b0 = buffer[0]
@@ -86,10 +89,10 @@ class SubscribeOptions(object):
         self.retainAsPublished = True if ((b0 >> 3) & 0x01) == 1 else False
         self.noLocal = True if ((b0 >> 2) & 0x01) == 1 else False
         self.QoS = (b0 & 0x03)
-        assert self.retainHandling in [
-            0, 1, 2], "Retain handling should be 0, 1 or 2, not %d" % self.retainHandling
-        assert self.QoS in [
-            0, 1, 2], "QoS should be 0, 1 or 2, not %d" % self.QoS
+        if self.retainHandling not in (0, 1, 2):
+            raise AssertionError(f"Retain handling should be 0, 1 or 2, not {self.retainHandling}")
+        if self.QoS not in (0, 1, 2):
+            raise AssertionError(f"QoS should be 0, 1 or 2, not {self.QoS}")
         return 1
 
     def __repr__(self):
diff --git a/requirements.txt b/requirements.txt
index baf358c5..76948175 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -26,7 +26,7 @@ Mako==1.3.2
 MarkupSafe==2.1.3
 musicbrainzngs==0.7.1
 packaging==24.0
-paho-mqtt==1.6.1
+paho-mqtt==2.0.0
 platformdirs==4.2.0
 plexapi==4.15.10
 portend==3.2.0

From bfc4f667396df18e7a4353a848700afd8e320482 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 30 Mar 2024 15:27:31 -0700
Subject: [PATCH 558/743] Bump python-dateutil from 2.8.2 to 2.9.0.post0
 (#2291)

Bumps [python-dateutil](https://github.com/dateutil/dateutil) from 2.8.2 to 2.9.0.post0.
- [Release notes](https://github.com/dateutil/dateutil/releases)
- [Changelog](https://github.com/dateutil/dateutil/blob/master/NEWS)
- [Commits](https://github.com/dateutil/dateutil/compare/2.8.2...2.9.0.post0)

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

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements.txt b/requirements.txt
index 76948175..85ea9fbe 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -33,7 +33,7 @@ portend==3.2.0
 profilehooks==1.12.0
 PyJWT==2.8.0
 pyparsing==3.1.1
-python-dateutil==2.8.2
+python-dateutil==2.9.0.post0
 python-twitter==3.5
 pytz==2024.1
 requests==2.31.0

From 452a4afdcf9bb2cfdd72cd40b5c164e2927454fa Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 30 Mar 2024 15:27:42 -0700
Subject: [PATCH 559/743] Bump tempora from 5.5.0 to 5.5.1 (#2292)

Bumps [tempora](https://github.com/jaraco/tempora) from 5.5.0 to 5.5.1.
- [Release notes](https://github.com/jaraco/tempora/releases)
- [Changelog](https://github.com/jaraco/tempora/blob/main/NEWS.rst)
- [Commits](https://github.com/jaraco/tempora/compare/v5.5.0...v5.5.1)

---
updated-dependencies:
- dependency-name: tempora
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements.txt b/requirements.txt
index 85ea9fbe..fcea2c1c 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -41,7 +41,7 @@ requests-oauthlib==1.3.1
 rumps==0.4.0; platform_system == "Darwin"
 simplejson==3.19.2
 six==1.16.0
-tempora==5.5.0
+tempora==5.5.1
 tokenize-rt==5.2.0
 tzdata==2023.3
 tzlocal==5.0.1

From 0d1d2a3e6b169b8c268c2f5a832617484699c9aa Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 30 Mar 2024 15:28:02 -0700
Subject: [PATCH 560/743] Bump requests-oauthlib from 1.3.1 to 2.0.0 (#2293)

* Bump requests-oauthlib from 1.3.1 to 2.0.0

Bumps [requests-oauthlib](https://github.com/requests/requests-oauthlib) from 1.3.1 to 2.0.0.
- [Release notes](https://github.com/requests/requests-oauthlib/releases)
- [Changelog](https://github.com/requests/requests-oauthlib/blob/master/HISTORY.rst)
- [Commits](https://github.com/requests/requests-oauthlib/compare/v1.3.1...v2.0.0)

---
updated-dependencies:
- dependency-name: requests-oauthlib
  dependency-type: direct:production
  update-type: version-update:semver-major
...

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

* Update requests-oauthlib==2.0.0

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/charset_normalizer/__main__.py            |    4 +
 lib/charset_normalizer/assets/__init__.py     | 1440 ------------
 lib/charset_normalizer/cd.py                  |    9 +-
 lib/charset_normalizer/cli/__init__.py        |    6 +
 .../cli/{normalizer.py => __main__.py}        |    0
 lib/charset_normalizer/constant.py            | 2070 ++++++++++++++---
 lib/charset_normalizer/md.py                  |   49 +-
 lib/charset_normalizer/models.py              |   11 +-
 lib/charset_normalizer/utils.py               |   43 +-
 lib/charset_normalizer/version.py             |    2 +-
 lib/idna/codec.py                             |   34 +-
 lib/idna/core.py                              |   10 +-
 lib/idna/idnadata.py                          |    9 +-
 lib/idna/package_data.py                      |    2 +-
 lib/idna/uts46data.py                         |  454 ++--
 lib/oauthlib/__init__.py                      |    2 +-
 lib/oauthlib/common.py                        |    6 +-
 lib/oauthlib/oauth1/__init__.py               |   35 +-
 lib/oauthlib/oauth1/rfc5849/endpoints/base.py |   11 +-
 .../oauth1/rfc5849/endpoints/request_token.py |    4 +-
 .../oauth1/rfc5849/endpoints/resource.py      |    4 +-
 .../oauth1/rfc5849/request_validator.py       |    6 +-
 lib/oauthlib/oauth1/rfc5849/signature.py      |   65 +-
 .../rfc6749/clients/backend_application.py    |    2 +-
 lib/oauthlib/oauth2/rfc6749/clients/base.py   |  165 +-
 .../rfc6749/clients/legacy_application.py     |    2 +-
 .../rfc6749/clients/mobile_application.py     |    2 +-
 .../rfc6749/clients/service_application.py    |    4 +-
 .../oauth2/rfc6749/clients/web_application.py |    4 +-
 .../oauth2/rfc6749/endpoints/introspect.py    |   10 +-
 .../oauth2/rfc6749/endpoints/metadata.py      |    4 +-
 .../oauth2/rfc6749/endpoints/revocation.py    |    4 +-
 .../rfc6749/grant_types/authorization_code.py |   18 -
 .../oauth2/rfc6749/grant_types/base.py        |   18 +
 .../rfc6749/grant_types/refresh_token.py      |    1 +
 lib/oauthlib/oauth2/rfc6749/parameters.py     |    2 +-
 .../oauth2/rfc6749/request_validator.py       |   10 +-
 lib/oauthlib/oauth2/rfc6749/tokens.py         |    1 +
 lib/oauthlib/oauth2/rfc8628/clients/device.py |    7 +-
 .../openid/connect/core/endpoints/userinfo.py |   21 +-
 .../openid/connect/core/grant_types/base.py   |    1 -
 .../connect/core/grant_types/dispatchers.py   |    2 +-
 lib/oauthlib/openid/connect/core/tokens.py    |    4 +-
 lib/oauthlib/uri_validate.py                  |    2 +-
 lib/requests_oauthlib/__init__.py             |    3 +-
 .../compliance_fixes/__init__.py              |    3 +-
 .../compliance_fixes/douban.py                |    4 +-
 .../compliance_fixes/ebay.py                  |    3 +-
 .../compliance_fixes/facebook.py              |   10 +-
 .../compliance_fixes/fitbit.py                |    4 +-
 .../compliance_fixes/instagram.py             |    5 +-
 .../compliance_fixes/mailchimp.py             |    6 +-
 .../compliance_fixes/plentymarkets.py         |    4 +-
 .../compliance_fixes/slack.py                 |    5 +-
 .../compliance_fixes/weibo.py                 |    4 +-
 lib/requests_oauthlib/oauth1_auth.py          |   13 +-
 lib/requests_oauthlib/oauth1_session.py       |   13 +-
 lib/requests_oauthlib/oauth2_auth.py          |    1 -
 lib/requests_oauthlib/oauth2_session.py       |   65 +-
 requirements.txt                              |    2 +-
 60 files changed, 2414 insertions(+), 2291 deletions(-)
 create mode 100644 lib/charset_normalizer/__main__.py
 delete mode 100644 lib/charset_normalizer/assets/__init__.py
 rename lib/charset_normalizer/cli/{normalizer.py => __main__.py} (100%)

diff --git a/lib/charset_normalizer/__main__.py b/lib/charset_normalizer/__main__.py
new file mode 100644
index 00000000..beae2ef7
--- /dev/null
+++ b/lib/charset_normalizer/__main__.py
@@ -0,0 +1,4 @@
+from .cli import cli_detect
+
+if __name__ == "__main__":
+    cli_detect()
diff --git a/lib/charset_normalizer/assets/__init__.py b/lib/charset_normalizer/assets/__init__.py
deleted file mode 100644
index 9075930d..00000000
--- a/lib/charset_normalizer/assets/__init__.py
+++ /dev/null
@@ -1,1440 +0,0 @@
-# -*- coding: utf-8 -*-
-from typing import Dict, List
-
-# Language label that contain the em dash "—"
-# character are to be considered alternative seq to origin
-FREQUENCIES: Dict[str, List[str]] = {
-    "English": [
-        "e",
-        "a",
-        "t",
-        "i",
-        "o",
-        "n",
-        "s",
-        "r",
-        "h",
-        "l",
-        "d",
-        "c",
-        "u",
-        "m",
-        "f",
-        "p",
-        "g",
-        "w",
-        "y",
-        "b",
-        "v",
-        "k",
-        "x",
-        "j",
-        "z",
-        "q",
-    ],
-    "English—": [
-        "e",
-        "a",
-        "t",
-        "i",
-        "o",
-        "n",
-        "s",
-        "r",
-        "h",
-        "l",
-        "d",
-        "c",
-        "m",
-        "u",
-        "f",
-        "p",
-        "g",
-        "w",
-        "b",
-        "y",
-        "v",
-        "k",
-        "j",
-        "x",
-        "z",
-        "q",
-    ],
-    "German": [
-        "e",
-        "n",
-        "i",
-        "r",
-        "s",
-        "t",
-        "a",
-        "d",
-        "h",
-        "u",
-        "l",
-        "g",
-        "o",
-        "c",
-        "m",
-        "b",
-        "f",
-        "k",
-        "w",
-        "z",
-        "p",
-        "v",
-        "ü",
-        "ä",
-        "ö",
-        "j",
-    ],
-    "French": [
-        "e",
-        "a",
-        "s",
-        "n",
-        "i",
-        "t",
-        "r",
-        "l",
-        "u",
-        "o",
-        "d",
-        "c",
-        "p",
-        "m",
-        "é",
-        "v",
-        "g",
-        "f",
-        "b",
-        "h",
-        "q",
-        "à",
-        "x",
-        "è",
-        "y",
-        "j",
-    ],
-    "Dutch": [
-        "e",
-        "n",
-        "a",
-        "i",
-        "r",
-        "t",
-        "o",
-        "d",
-        "s",
-        "l",
-        "g",
-        "h",
-        "v",
-        "m",
-        "u",
-        "k",
-        "c",
-        "p",
-        "b",
-        "w",
-        "j",
-        "z",
-        "f",
-        "y",
-        "x",
-        "ë",
-    ],
-    "Italian": [
-        "e",
-        "i",
-        "a",
-        "o",
-        "n",
-        "l",
-        "t",
-        "r",
-        "s",
-        "c",
-        "d",
-        "u",
-        "p",
-        "m",
-        "g",
-        "v",
-        "f",
-        "b",
-        "z",
-        "h",
-        "q",
-        "è",
-        "à",
-        "k",
-        "y",
-        "ò",
-    ],
-    "Polish": [
-        "a",
-        "i",
-        "o",
-        "e",
-        "n",
-        "r",
-        "z",
-        "w",
-        "s",
-        "c",
-        "t",
-        "k",
-        "y",
-        "d",
-        "p",
-        "m",
-        "u",
-        "l",
-        "j",
-        "ł",
-        "g",
-        "b",
-        "h",
-        "ą",
-        "ę",
-        "ó",
-    ],
-    "Spanish": [
-        "e",
-        "a",
-        "o",
-        "n",
-        "s",
-        "r",
-        "i",
-        "l",
-        "d",
-        "t",
-        "c",
-        "u",
-        "m",
-        "p",
-        "b",
-        "g",
-        "v",
-        "f",
-        "y",
-        "ó",
-        "h",
-        "q",
-        "í",
-        "j",
-        "z",
-        "á",
-    ],
-    "Russian": [
-        "о",
-        "а",
-        "е",
-        "и",
-        "н",
-        "с",
-        "т",
-        "р",
-        "в",
-        "л",
-        "к",
-        "м",
-        "д",
-        "п",
-        "у",
-        "г",
-        "я",
-        "ы",
-        "з",
-        "б",
-        "й",
-        "ь",
-        "ч",
-        "х",
-        "ж",
-        "ц",
-    ],
-    # Jap-Kanji
-    "Japanese": [
-        "人",
-        "一",
-        "大",
-        "亅",
-        "丁",
-        "丨",
-        "竹",
-        "笑",
-        "口",
-        "日",
-        "今",
-        "二",
-        "彳",
-        "行",
-        "十",
-        "土",
-        "丶",
-        "寸",
-        "寺",
-        "時",
-        "乙",
-        "丿",
-        "乂",
-        "气",
-        "気",
-        "冂",
-        "巾",
-        "亠",
-        "市",
-        "目",
-        "儿",
-        "見",
-        "八",
-        "小",
-        "凵",
-        "県",
-        "月",
-        "彐",
-        "門",
-        "間",
-        "木",
-        "東",
-        "山",
-        "出",
-        "本",
-        "中",
-        "刀",
-        "分",
-        "耳",
-        "又",
-        "取",
-        "最",
-        "言",
-        "田",
-        "心",
-        "思",
-        "刂",
-        "前",
-        "京",
-        "尹",
-        "事",
-        "生",
-        "厶",
-        "云",
-        "会",
-        "未",
-        "来",
-        "白",
-        "冫",
-        "楽",
-        "灬",
-        "馬",
-        "尸",
-        "尺",
-        "駅",
-        "明",
-        "耂",
-        "者",
-        "了",
-        "阝",
-        "都",
-        "高",
-        "卜",
-        "占",
-        "厂",
-        "广",
-        "店",
-        "子",
-        "申",
-        "奄",
-        "亻",
-        "俺",
-        "上",
-        "方",
-        "冖",
-        "学",
-        "衣",
-        "艮",
-        "食",
-        "自",
-    ],
-    # Jap-Katakana
-    "Japanese—": [
-        "ー",
-        "ン",
-        "ス",
-        "・",
-        "ル",
-        "ト",
-        "リ",
-        "イ",
-        "ア",
-        "ラ",
-        "ッ",
-        "ク",
-        "ド",
-        "シ",
-        "レ",
-        "ジ",
-        "タ",
-        "フ",
-        "ロ",
-        "カ",
-        "テ",
-        "マ",
-        "ィ",
-        "グ",
-        "バ",
-        "ム",
-        "プ",
-        "オ",
-        "コ",
-        "デ",
-        "ニ",
-        "ウ",
-        "メ",
-        "サ",
-        "ビ",
-        "ナ",
-        "ブ",
-        "ャ",
-        "エ",
-        "ュ",
-        "チ",
-        "キ",
-        "ズ",
-        "ダ",
-        "パ",
-        "ミ",
-        "ェ",
-        "ョ",
-        "ハ",
-        "セ",
-        "ベ",
-        "ガ",
-        "モ",
-        "ツ",
-        "ネ",
-        "ボ",
-        "ソ",
-        "ノ",
-        "ァ",
-        "ヴ",
-        "ワ",
-        "ポ",
-        "ペ",
-        "ピ",
-        "ケ",
-        "ゴ",
-        "ギ",
-        "ザ",
-        "ホ",
-        "ゲ",
-        "ォ",
-        "ヤ",
-        "ヒ",
-        "ユ",
-        "ヨ",
-        "ヘ",
-        "ゼ",
-        "ヌ",
-        "ゥ",
-        "ゾ",
-        "ヶ",
-        "ヂ",
-        "ヲ",
-        "ヅ",
-        "ヵ",
-        "ヱ",
-        "ヰ",
-        "ヮ",
-        "ヽ",
-        "゠",
-        "ヾ",
-        "ヷ",
-        "ヿ",
-        "ヸ",
-        "ヹ",
-        "ヺ",
-    ],
-    # Jap-Hiragana
-    "Japanese——": [
-        "の",
-        "に",
-        "る",
-        "た",
-        "と",
-        "は",
-        "し",
-        "い",
-        "を",
-        "で",
-        "て",
-        "が",
-        "な",
-        "れ",
-        "か",
-        "ら",
-        "さ",
-        "っ",
-        "り",
-        "す",
-        "あ",
-        "も",
-        "こ",
-        "ま",
-        "う",
-        "く",
-        "よ",
-        "き",
-        "ん",
-        "め",
-        "お",
-        "け",
-        "そ",
-        "つ",
-        "だ",
-        "や",
-        "え",
-        "ど",
-        "わ",
-        "ち",
-        "み",
-        "せ",
-        "じ",
-        "ば",
-        "へ",
-        "び",
-        "ず",
-        "ろ",
-        "ほ",
-        "げ",
-        "む",
-        "べ",
-        "ひ",
-        "ょ",
-        "ゆ",
-        "ぶ",
-        "ご",
-        "ゃ",
-        "ね",
-        "ふ",
-        "ぐ",
-        "ぎ",
-        "ぼ",
-        "ゅ",
-        "づ",
-        "ざ",
-        "ぞ",
-        "ぬ",
-        "ぜ",
-        "ぱ",
-        "ぽ",
-        "ぷ",
-        "ぴ",
-        "ぃ",
-        "ぁ",
-        "ぇ",
-        "ぺ",
-        "ゞ",
-        "ぢ",
-        "ぉ",
-        "ぅ",
-        "ゐ",
-        "ゝ",
-        "ゑ",
-        "゛",
-        "゜",
-        "ゎ",
-        "ゔ",
-        "゚",
-        "ゟ",
-        "゙",
-        "ゕ",
-        "ゖ",
-    ],
-    "Portuguese": [
-        "a",
-        "e",
-        "o",
-        "s",
-        "i",
-        "r",
-        "d",
-        "n",
-        "t",
-        "m",
-        "u",
-        "c",
-        "l",
-        "p",
-        "g",
-        "v",
-        "b",
-        "f",
-        "h",
-        "ã",
-        "q",
-        "é",
-        "ç",
-        "á",
-        "z",
-        "í",
-    ],
-    "Swedish": [
-        "e",
-        "a",
-        "n",
-        "r",
-        "t",
-        "s",
-        "i",
-        "l",
-        "d",
-        "o",
-        "m",
-        "k",
-        "g",
-        "v",
-        "h",
-        "f",
-        "u",
-        "p",
-        "ä",
-        "c",
-        "b",
-        "ö",
-        "å",
-        "y",
-        "j",
-        "x",
-    ],
-    "Chinese": [
-        "的",
-        "一",
-        "是",
-        "不",
-        "了",
-        "在",
-        "人",
-        "有",
-        "我",
-        "他",
-        "这",
-        "个",
-        "们",
-        "中",
-        "来",
-        "上",
-        "大",
-        "为",
-        "和",
-        "国",
-        "地",
-        "到",
-        "以",
-        "说",
-        "时",
-        "要",
-        "就",
-        "出",
-        "会",
-        "可",
-        "也",
-        "你",
-        "对",
-        "生",
-        "能",
-        "而",
-        "子",
-        "那",
-        "得",
-        "于",
-        "着",
-        "下",
-        "自",
-        "之",
-        "年",
-        "过",
-        "发",
-        "后",
-        "作",
-        "里",
-        "用",
-        "道",
-        "行",
-        "所",
-        "然",
-        "家",
-        "种",
-        "事",
-        "成",
-        "方",
-        "多",
-        "经",
-        "么",
-        "去",
-        "法",
-        "学",
-        "如",
-        "都",
-        "同",
-        "现",
-        "当",
-        "没",
-        "动",
-        "面",
-        "起",
-        "看",
-        "定",
-        "天",
-        "分",
-        "还",
-        "进",
-        "好",
-        "小",
-        "部",
-        "其",
-        "些",
-        "主",
-        "样",
-        "理",
-        "心",
-        "她",
-        "本",
-        "前",
-        "开",
-        "但",
-        "因",
-        "只",
-        "从",
-        "想",
-        "实",
-    ],
-    "Ukrainian": [
-        "о",
-        "а",
-        "н",
-        "і",
-        "и",
-        "р",
-        "в",
-        "т",
-        "е",
-        "с",
-        "к",
-        "л",
-        "у",
-        "д",
-        "м",
-        "п",
-        "з",
-        "я",
-        "ь",
-        "б",
-        "г",
-        "й",
-        "ч",
-        "х",
-        "ц",
-        "ї",
-    ],
-    "Norwegian": [
-        "e",
-        "r",
-        "n",
-        "t",
-        "a",
-        "s",
-        "i",
-        "o",
-        "l",
-        "d",
-        "g",
-        "k",
-        "m",
-        "v",
-        "f",
-        "p",
-        "u",
-        "b",
-        "h",
-        "å",
-        "y",
-        "j",
-        "ø",
-        "c",
-        "æ",
-        "w",
-    ],
-    "Finnish": [
-        "a",
-        "i",
-        "n",
-        "t",
-        "e",
-        "s",
-        "l",
-        "o",
-        "u",
-        "k",
-        "ä",
-        "m",
-        "r",
-        "v",
-        "j",
-        "h",
-        "p",
-        "y",
-        "d",
-        "ö",
-        "g",
-        "c",
-        "b",
-        "f",
-        "w",
-        "z",
-    ],
-    "Vietnamese": [
-        "n",
-        "h",
-        "t",
-        "i",
-        "c",
-        "g",
-        "a",
-        "o",
-        "u",
-        "m",
-        "l",
-        "r",
-        "à",
-        "đ",
-        "s",
-        "e",
-        "v",
-        "p",
-        "b",
-        "y",
-        "ư",
-        "d",
-        "á",
-        "k",
-        "ộ",
-        "ế",
-    ],
-    "Czech": [
-        "o",
-        "e",
-        "a",
-        "n",
-        "t",
-        "s",
-        "i",
-        "l",
-        "v",
-        "r",
-        "k",
-        "d",
-        "u",
-        "m",
-        "p",
-        "í",
-        "c",
-        "h",
-        "z",
-        "á",
-        "y",
-        "j",
-        "b",
-        "ě",
-        "é",
-        "ř",
-    ],
-    "Hungarian": [
-        "e",
-        "a",
-        "t",
-        "l",
-        "s",
-        "n",
-        "k",
-        "r",
-        "i",
-        "o",
-        "z",
-        "á",
-        "é",
-        "g",
-        "m",
-        "b",
-        "y",
-        "v",
-        "d",
-        "h",
-        "u",
-        "p",
-        "j",
-        "ö",
-        "f",
-        "c",
-    ],
-    "Korean": [
-        "이",
-        "다",
-        "에",
-        "의",
-        "는",
-        "로",
-        "하",
-        "을",
-        "가",
-        "고",
-        "지",
-        "서",
-        "한",
-        "은",
-        "기",
-        "으",
-        "년",
-        "대",
-        "사",
-        "시",
-        "를",
-        "리",
-        "도",
-        "인",
-        "스",
-        "일",
-    ],
-    "Indonesian": [
-        "a",
-        "n",
-        "e",
-        "i",
-        "r",
-        "t",
-        "u",
-        "s",
-        "d",
-        "k",
-        "m",
-        "l",
-        "g",
-        "p",
-        "b",
-        "o",
-        "h",
-        "y",
-        "j",
-        "c",
-        "w",
-        "f",
-        "v",
-        "z",
-        "x",
-        "q",
-    ],
-    "Turkish": [
-        "a",
-        "e",
-        "i",
-        "n",
-        "r",
-        "l",
-        "ı",
-        "k",
-        "d",
-        "t",
-        "s",
-        "m",
-        "y",
-        "u",
-        "o",
-        "b",
-        "ü",
-        "ş",
-        "v",
-        "g",
-        "z",
-        "h",
-        "c",
-        "p",
-        "ç",
-        "ğ",
-    ],
-    "Romanian": [
-        "e",
-        "i",
-        "a",
-        "r",
-        "n",
-        "t",
-        "u",
-        "l",
-        "o",
-        "c",
-        "s",
-        "d",
-        "p",
-        "m",
-        "ă",
-        "f",
-        "v",
-        "î",
-        "g",
-        "b",
-        "ș",
-        "ț",
-        "z",
-        "h",
-        "â",
-        "j",
-    ],
-    "Farsi": [
-        "ا",
-        "ی",
-        "ر",
-        "د",
-        "ن",
-        "ه",
-        "و",
-        "م",
-        "ت",
-        "ب",
-        "س",
-        "ل",
-        "ک",
-        "ش",
-        "ز",
-        "ف",
-        "گ",
-        "ع",
-        "خ",
-        "ق",
-        "ج",
-        "آ",
-        "پ",
-        "ح",
-        "ط",
-        "ص",
-    ],
-    "Arabic": [
-        "ا",
-        "ل",
-        "ي",
-        "م",
-        "و",
-        "ن",
-        "ر",
-        "ت",
-        "ب",
-        "ة",
-        "ع",
-        "د",
-        "س",
-        "ف",
-        "ه",
-        "ك",
-        "ق",
-        "أ",
-        "ح",
-        "ج",
-        "ش",
-        "ط",
-        "ص",
-        "ى",
-        "خ",
-        "إ",
-    ],
-    "Danish": [
-        "e",
-        "r",
-        "n",
-        "t",
-        "a",
-        "i",
-        "s",
-        "d",
-        "l",
-        "o",
-        "g",
-        "m",
-        "k",
-        "f",
-        "v",
-        "u",
-        "b",
-        "h",
-        "p",
-        "å",
-        "y",
-        "ø",
-        "æ",
-        "c",
-        "j",
-        "w",
-    ],
-    "Serbian": [
-        "а",
-        "и",
-        "о",
-        "е",
-        "н",
-        "р",
-        "с",
-        "у",
-        "т",
-        "к",
-        "ј",
-        "в",
-        "д",
-        "м",
-        "п",
-        "л",
-        "г",
-        "з",
-        "б",
-        "a",
-        "i",
-        "e",
-        "o",
-        "n",
-        "ц",
-        "ш",
-    ],
-    "Lithuanian": [
-        "i",
-        "a",
-        "s",
-        "o",
-        "r",
-        "e",
-        "t",
-        "n",
-        "u",
-        "k",
-        "m",
-        "l",
-        "p",
-        "v",
-        "d",
-        "j",
-        "g",
-        "ė",
-        "b",
-        "y",
-        "ų",
-        "š",
-        "ž",
-        "c",
-        "ą",
-        "į",
-    ],
-    "Slovene": [
-        "e",
-        "a",
-        "i",
-        "o",
-        "n",
-        "r",
-        "s",
-        "l",
-        "t",
-        "j",
-        "v",
-        "k",
-        "d",
-        "p",
-        "m",
-        "u",
-        "z",
-        "b",
-        "g",
-        "h",
-        "č",
-        "c",
-        "š",
-        "ž",
-        "f",
-        "y",
-    ],
-    "Slovak": [
-        "o",
-        "a",
-        "e",
-        "n",
-        "i",
-        "r",
-        "v",
-        "t",
-        "s",
-        "l",
-        "k",
-        "d",
-        "m",
-        "p",
-        "u",
-        "c",
-        "h",
-        "j",
-        "b",
-        "z",
-        "á",
-        "y",
-        "ý",
-        "í",
-        "č",
-        "é",
-    ],
-    "Hebrew": [
-        "י",
-        "ו",
-        "ה",
-        "ל",
-        "ר",
-        "ב",
-        "ת",
-        "מ",
-        "א",
-        "ש",
-        "נ",
-        "ע",
-        "ם",
-        "ד",
-        "ק",
-        "ח",
-        "פ",
-        "ס",
-        "כ",
-        "ג",
-        "ט",
-        "צ",
-        "ן",
-        "ז",
-        "ך",
-    ],
-    "Bulgarian": [
-        "а",
-        "и",
-        "о",
-        "е",
-        "н",
-        "т",
-        "р",
-        "с",
-        "в",
-        "л",
-        "к",
-        "д",
-        "п",
-        "м",
-        "з",
-        "г",
-        "я",
-        "ъ",
-        "у",
-        "б",
-        "ч",
-        "ц",
-        "й",
-        "ж",
-        "щ",
-        "х",
-    ],
-    "Croatian": [
-        "a",
-        "i",
-        "o",
-        "e",
-        "n",
-        "r",
-        "j",
-        "s",
-        "t",
-        "u",
-        "k",
-        "l",
-        "v",
-        "d",
-        "m",
-        "p",
-        "g",
-        "z",
-        "b",
-        "c",
-        "č",
-        "h",
-        "š",
-        "ž",
-        "ć",
-        "f",
-    ],
-    "Hindi": [
-        "क",
-        "र",
-        "स",
-        "न",
-        "त",
-        "म",
-        "ह",
-        "प",
-        "य",
-        "ल",
-        "व",
-        "ज",
-        "द",
-        "ग",
-        "ब",
-        "श",
-        "ट",
-        "अ",
-        "ए",
-        "थ",
-        "भ",
-        "ड",
-        "च",
-        "ध",
-        "ष",
-        "इ",
-    ],
-    "Estonian": [
-        "a",
-        "i",
-        "e",
-        "s",
-        "t",
-        "l",
-        "u",
-        "n",
-        "o",
-        "k",
-        "r",
-        "d",
-        "m",
-        "v",
-        "g",
-        "p",
-        "j",
-        "h",
-        "ä",
-        "b",
-        "õ",
-        "ü",
-        "f",
-        "c",
-        "ö",
-        "y",
-    ],
-    "Thai": [
-        "า",
-        "น",
-        "ร",
-        "อ",
-        "ก",
-        "เ",
-        "ง",
-        "ม",
-        "ย",
-        "ล",
-        "ว",
-        "ด",
-        "ท",
-        "ส",
-        "ต",
-        "ะ",
-        "ป",
-        "บ",
-        "ค",
-        "ห",
-        "แ",
-        "จ",
-        "พ",
-        "ช",
-        "ข",
-        "ใ",
-    ],
-    "Greek": [
-        "α",
-        "τ",
-        "ο",
-        "ι",
-        "ε",
-        "ν",
-        "ρ",
-        "σ",
-        "κ",
-        "η",
-        "π",
-        "ς",
-        "υ",
-        "μ",
-        "λ",
-        "ί",
-        "ό",
-        "ά",
-        "γ",
-        "έ",
-        "δ",
-        "ή",
-        "ω",
-        "χ",
-        "θ",
-        "ύ",
-    ],
-    "Tamil": [
-        "க",
-        "த",
-        "ப",
-        "ட",
-        "ர",
-        "ம",
-        "ல",
-        "ன",
-        "வ",
-        "ற",
-        "ய",
-        "ள",
-        "ச",
-        "ந",
-        "இ",
-        "ண",
-        "அ",
-        "ஆ",
-        "ழ",
-        "ங",
-        "எ",
-        "உ",
-        "ஒ",
-        "ஸ",
-    ],
-    "Kazakh": [
-        "а",
-        "ы",
-        "е",
-        "н",
-        "т",
-        "р",
-        "л",
-        "і",
-        "д",
-        "с",
-        "м",
-        "қ",
-        "к",
-        "о",
-        "б",
-        "и",
-        "у",
-        "ғ",
-        "ж",
-        "ң",
-        "з",
-        "ш",
-        "й",
-        "п",
-        "г",
-        "ө",
-    ],
-}
diff --git a/lib/charset_normalizer/cd.py b/lib/charset_normalizer/cd.py
index 6e56fe84..4ea6760c 100644
--- a/lib/charset_normalizer/cd.py
+++ b/lib/charset_normalizer/cd.py
@@ -4,8 +4,13 @@ from collections import Counter
 from functools import lru_cache
 from typing import Counter as TypeCounter, Dict, List, Optional, Tuple
 
-from .assets import FREQUENCIES
-from .constant import KO_NAMES, LANGUAGE_SUPPORTED_COUNT, TOO_SMALL_SEQUENCE, ZH_NAMES
+from .constant import (
+    FREQUENCIES,
+    KO_NAMES,
+    LANGUAGE_SUPPORTED_COUNT,
+    TOO_SMALL_SEQUENCE,
+    ZH_NAMES,
+)
 from .md import is_suspiciously_successive_range
 from .models import CoherenceMatches
 from .utils import (
diff --git a/lib/charset_normalizer/cli/__init__.py b/lib/charset_normalizer/cli/__init__.py
index e69de29b..d95fedfe 100644
--- a/lib/charset_normalizer/cli/__init__.py
+++ b/lib/charset_normalizer/cli/__init__.py
@@ -0,0 +1,6 @@
+from .__main__ import cli_detect, query_yes_no
+
+__all__ = (
+    "cli_detect",
+    "query_yes_no",
+)
diff --git a/lib/charset_normalizer/cli/normalizer.py b/lib/charset_normalizer/cli/__main__.py
similarity index 100%
rename from lib/charset_normalizer/cli/normalizer.py
rename to lib/charset_normalizer/cli/__main__.py
diff --git a/lib/charset_normalizer/constant.py b/lib/charset_normalizer/constant.py
index 3188108d..86349046 100644
--- a/lib/charset_normalizer/constant.py
+++ b/lib/charset_normalizer/constant.py
@@ -1,10 +1,9 @@
+# -*- coding: utf-8 -*-
 from codecs import BOM_UTF8, BOM_UTF16_BE, BOM_UTF16_LE, BOM_UTF32_BE, BOM_UTF32_LE
 from encodings.aliases import aliases
 from re import IGNORECASE, compile as re_compile
 from typing import Dict, List, Set, Union
 
-from .assets import FREQUENCIES
-
 # Contain for each eligible encoding a list of/item bytes SIG/BOM
 ENCODING_MARKS: Dict[str, Union[bytes, List[bytes]]] = {
     "utf_8": BOM_UTF8,
@@ -23,288 +22,338 @@ ENCODING_MARKS: Dict[str, Union[bytes, List[bytes]]] = {
 TOO_SMALL_SEQUENCE: int = 32
 TOO_BIG_SEQUENCE: int = int(10e6)
 
-UTF8_MAXIMAL_ALLOCATION: int = 1112064
+UTF8_MAXIMAL_ALLOCATION: int = 1_112_064
 
+# Up-to-date Unicode ucd/15.0.0
 UNICODE_RANGES_COMBINED: Dict[str, range] = {
-    "Control character": range(31 + 1),
-    "Basic Latin": range(32, 127 + 1),
-    "Latin-1 Supplement": range(128, 255 + 1),
-    "Latin Extended-A": range(256, 383 + 1),
-    "Latin Extended-B": range(384, 591 + 1),
-    "IPA Extensions": range(592, 687 + 1),
-    "Spacing Modifier Letters": range(688, 767 + 1),
-    "Combining Diacritical Marks": range(768, 879 + 1),
-    "Greek and Coptic": range(880, 1023 + 1),
-    "Cyrillic": range(1024, 1279 + 1),
-    "Cyrillic Supplement": range(1280, 1327 + 1),
-    "Armenian": range(1328, 1423 + 1),
-    "Hebrew": range(1424, 1535 + 1),
-    "Arabic": range(1536, 1791 + 1),
-    "Syriac": range(1792, 1871 + 1),
-    "Arabic Supplement": range(1872, 1919 + 1),
-    "Thaana": range(1920, 1983 + 1),
-    "NKo": range(1984, 2047 + 1),
-    "Samaritan": range(2048, 2111 + 1),
-    "Mandaic": range(2112, 2143 + 1),
-    "Syriac Supplement": range(2144, 2159 + 1),
-    "Arabic Extended-A": range(2208, 2303 + 1),
-    "Devanagari": range(2304, 2431 + 1),
-    "Bengali": range(2432, 2559 + 1),
-    "Gurmukhi": range(2560, 2687 + 1),
-    "Gujarati": range(2688, 2815 + 1),
-    "Oriya": range(2816, 2943 + 1),
-    "Tamil": range(2944, 3071 + 1),
-    "Telugu": range(3072, 3199 + 1),
-    "Kannada": range(3200, 3327 + 1),
-    "Malayalam": range(3328, 3455 + 1),
-    "Sinhala": range(3456, 3583 + 1),
-    "Thai": range(3584, 3711 + 1),
-    "Lao": range(3712, 3839 + 1),
-    "Tibetan": range(3840, 4095 + 1),
-    "Myanmar": range(4096, 4255 + 1),
-    "Georgian": range(4256, 4351 + 1),
-    "Hangul Jamo": range(4352, 4607 + 1),
-    "Ethiopic": range(4608, 4991 + 1),
-    "Ethiopic Supplement": range(4992, 5023 + 1),
-    "Cherokee": range(5024, 5119 + 1),
-    "Unified Canadian Aboriginal Syllabics": range(5120, 5759 + 1),
-    "Ogham": range(5760, 5791 + 1),
-    "Runic": range(5792, 5887 + 1),
-    "Tagalog": range(5888, 5919 + 1),
-    "Hanunoo": range(5920, 5951 + 1),
-    "Buhid": range(5952, 5983 + 1),
-    "Tagbanwa": range(5984, 6015 + 1),
-    "Khmer": range(6016, 6143 + 1),
-    "Mongolian": range(6144, 6319 + 1),
-    "Unified Canadian Aboriginal Syllabics Extended": range(6320, 6399 + 1),
-    "Limbu": range(6400, 6479 + 1),
-    "Tai Le": range(6480, 6527 + 1),
-    "New Tai Lue": range(6528, 6623 + 1),
-    "Khmer Symbols": range(6624, 6655 + 1),
-    "Buginese": range(6656, 6687 + 1),
-    "Tai Tham": range(6688, 6831 + 1),
-    "Combining Diacritical Marks Extended": range(6832, 6911 + 1),
-    "Balinese": range(6912, 7039 + 1),
-    "Sundanese": range(7040, 7103 + 1),
-    "Batak": range(7104, 7167 + 1),
-    "Lepcha": range(7168, 7247 + 1),
-    "Ol Chiki": range(7248, 7295 + 1),
-    "Cyrillic Extended C": range(7296, 7311 + 1),
-    "Sundanese Supplement": range(7360, 7375 + 1),
-    "Vedic Extensions": range(7376, 7423 + 1),
-    "Phonetic Extensions": range(7424, 7551 + 1),
-    "Phonetic Extensions Supplement": range(7552, 7615 + 1),
-    "Combining Diacritical Marks Supplement": range(7616, 7679 + 1),
-    "Latin Extended Additional": range(7680, 7935 + 1),
-    "Greek Extended": range(7936, 8191 + 1),
-    "General Punctuation": range(8192, 8303 + 1),
-    "Superscripts and Subscripts": range(8304, 8351 + 1),
-    "Currency Symbols": range(8352, 8399 + 1),
-    "Combining Diacritical Marks for Symbols": range(8400, 8447 + 1),
-    "Letterlike Symbols": range(8448, 8527 + 1),
-    "Number Forms": range(8528, 8591 + 1),
-    "Arrows": range(8592, 8703 + 1),
-    "Mathematical Operators": range(8704, 8959 + 1),
-    "Miscellaneous Technical": range(8960, 9215 + 1),
-    "Control Pictures": range(9216, 9279 + 1),
-    "Optical Character Recognition": range(9280, 9311 + 1),
-    "Enclosed Alphanumerics": range(9312, 9471 + 1),
-    "Box Drawing": range(9472, 9599 + 1),
-    "Block Elements": range(9600, 9631 + 1),
-    "Geometric Shapes": range(9632, 9727 + 1),
-    "Miscellaneous Symbols": range(9728, 9983 + 1),
-    "Dingbats": range(9984, 10175 + 1),
-    "Miscellaneous Mathematical Symbols-A": range(10176, 10223 + 1),
-    "Supplemental Arrows-A": range(10224, 10239 + 1),
-    "Braille Patterns": range(10240, 10495 + 1),
-    "Supplemental Arrows-B": range(10496, 10623 + 1),
-    "Miscellaneous Mathematical Symbols-B": range(10624, 10751 + 1),
-    "Supplemental Mathematical Operators": range(10752, 11007 + 1),
-    "Miscellaneous Symbols and Arrows": range(11008, 11263 + 1),
-    "Glagolitic": range(11264, 11359 + 1),
-    "Latin Extended-C": range(11360, 11391 + 1),
-    "Coptic": range(11392, 11519 + 1),
-    "Georgian Supplement": range(11520, 11567 + 1),
-    "Tifinagh": range(11568, 11647 + 1),
-    "Ethiopic Extended": range(11648, 11743 + 1),
-    "Cyrillic Extended-A": range(11744, 11775 + 1),
-    "Supplemental Punctuation": range(11776, 11903 + 1),
-    "CJK Radicals Supplement": range(11904, 12031 + 1),
-    "Kangxi Radicals": range(12032, 12255 + 1),
-    "Ideographic Description Characters": range(12272, 12287 + 1),
-    "CJK Symbols and Punctuation": range(12288, 12351 + 1),
-    "Hiragana": range(12352, 12447 + 1),
-    "Katakana": range(12448, 12543 + 1),
-    "Bopomofo": range(12544, 12591 + 1),
-    "Hangul Compatibility Jamo": range(12592, 12687 + 1),
-    "Kanbun": range(12688, 12703 + 1),
-    "Bopomofo Extended": range(12704, 12735 + 1),
-    "CJK Strokes": range(12736, 12783 + 1),
-    "Katakana Phonetic Extensions": range(12784, 12799 + 1),
-    "Enclosed CJK Letters and Months": range(12800, 13055 + 1),
-    "CJK Compatibility": range(13056, 13311 + 1),
-    "CJK Unified Ideographs Extension A": range(13312, 19903 + 1),
-    "Yijing Hexagram Symbols": range(19904, 19967 + 1),
-    "CJK Unified Ideographs": range(19968, 40959 + 1),
-    "Yi Syllables": range(40960, 42127 + 1),
-    "Yi Radicals": range(42128, 42191 + 1),
-    "Lisu": range(42192, 42239 + 1),
-    "Vai": range(42240, 42559 + 1),
-    "Cyrillic Extended-B": range(42560, 42655 + 1),
-    "Bamum": range(42656, 42751 + 1),
-    "Modifier Tone Letters": range(42752, 42783 + 1),
-    "Latin Extended-D": range(42784, 43007 + 1),
-    "Syloti Nagri": range(43008, 43055 + 1),
-    "Common Indic Number Forms": range(43056, 43071 + 1),
-    "Phags-pa": range(43072, 43135 + 1),
-    "Saurashtra": range(43136, 43231 + 1),
-    "Devanagari Extended": range(43232, 43263 + 1),
-    "Kayah Li": range(43264, 43311 + 1),
-    "Rejang": range(43312, 43359 + 1),
-    "Hangul Jamo Extended-A": range(43360, 43391 + 1),
-    "Javanese": range(43392, 43487 + 1),
-    "Myanmar Extended-B": range(43488, 43519 + 1),
-    "Cham": range(43520, 43615 + 1),
-    "Myanmar Extended-A": range(43616, 43647 + 1),
-    "Tai Viet": range(43648, 43743 + 1),
-    "Meetei Mayek Extensions": range(43744, 43775 + 1),
-    "Ethiopic Extended-A": range(43776, 43823 + 1),
-    "Latin Extended-E": range(43824, 43887 + 1),
-    "Cherokee Supplement": range(43888, 43967 + 1),
-    "Meetei Mayek": range(43968, 44031 + 1),
-    "Hangul Syllables": range(44032, 55215 + 1),
-    "Hangul Jamo Extended-B": range(55216, 55295 + 1),
-    "High Surrogates": range(55296, 56191 + 1),
-    "High Private Use Surrogates": range(56192, 56319 + 1),
-    "Low Surrogates": range(56320, 57343 + 1),
-    "Private Use Area": range(57344, 63743 + 1),
-    "CJK Compatibility Ideographs": range(63744, 64255 + 1),
-    "Alphabetic Presentation Forms": range(64256, 64335 + 1),
-    "Arabic Presentation Forms-A": range(64336, 65023 + 1),
-    "Variation Selectors": range(65024, 65039 + 1),
-    "Vertical Forms": range(65040, 65055 + 1),
-    "Combining Half Marks": range(65056, 65071 + 1),
-    "CJK Compatibility Forms": range(65072, 65103 + 1),
-    "Small Form Variants": range(65104, 65135 + 1),
-    "Arabic Presentation Forms-B": range(65136, 65279 + 1),
-    "Halfwidth and Fullwidth Forms": range(65280, 65519 + 1),
-    "Specials": range(65520, 65535 + 1),
-    "Linear B Syllabary": range(65536, 65663 + 1),
-    "Linear B Ideograms": range(65664, 65791 + 1),
-    "Aegean Numbers": range(65792, 65855 + 1),
-    "Ancient Greek Numbers": range(65856, 65935 + 1),
-    "Ancient Symbols": range(65936, 65999 + 1),
-    "Phaistos Disc": range(66000, 66047 + 1),
-    "Lycian": range(66176, 66207 + 1),
-    "Carian": range(66208, 66271 + 1),
-    "Coptic Epact Numbers": range(66272, 66303 + 1),
-    "Old Italic": range(66304, 66351 + 1),
-    "Gothic": range(66352, 66383 + 1),
-    "Old Permic": range(66384, 66431 + 1),
-    "Ugaritic": range(66432, 66463 + 1),
-    "Old Persian": range(66464, 66527 + 1),
-    "Deseret": range(66560, 66639 + 1),
-    "Shavian": range(66640, 66687 + 1),
-    "Osmanya": range(66688, 66735 + 1),
-    "Osage": range(66736, 66815 + 1),
-    "Elbasan": range(66816, 66863 + 1),
-    "Caucasian Albanian": range(66864, 66927 + 1),
-    "Linear A": range(67072, 67455 + 1),
-    "Cypriot Syllabary": range(67584, 67647 + 1),
-    "Imperial Aramaic": range(67648, 67679 + 1),
-    "Palmyrene": range(67680, 67711 + 1),
-    "Nabataean": range(67712, 67759 + 1),
-    "Hatran": range(67808, 67839 + 1),
-    "Phoenician": range(67840, 67871 + 1),
-    "Lydian": range(67872, 67903 + 1),
-    "Meroitic Hieroglyphs": range(67968, 67999 + 1),
-    "Meroitic Cursive": range(68000, 68095 + 1),
-    "Kharoshthi": range(68096, 68191 + 1),
-    "Old South Arabian": range(68192, 68223 + 1),
-    "Old North Arabian": range(68224, 68255 + 1),
-    "Manichaean": range(68288, 68351 + 1),
-    "Avestan": range(68352, 68415 + 1),
-    "Inscriptional Parthian": range(68416, 68447 + 1),
-    "Inscriptional Pahlavi": range(68448, 68479 + 1),
-    "Psalter Pahlavi": range(68480, 68527 + 1),
-    "Old Turkic": range(68608, 68687 + 1),
-    "Old Hungarian": range(68736, 68863 + 1),
-    "Rumi Numeral Symbols": range(69216, 69247 + 1),
-    "Brahmi": range(69632, 69759 + 1),
-    "Kaithi": range(69760, 69839 + 1),
-    "Sora Sompeng": range(69840, 69887 + 1),
-    "Chakma": range(69888, 69967 + 1),
-    "Mahajani": range(69968, 70015 + 1),
-    "Sharada": range(70016, 70111 + 1),
-    "Sinhala Archaic Numbers": range(70112, 70143 + 1),
-    "Khojki": range(70144, 70223 + 1),
-    "Multani": range(70272, 70319 + 1),
-    "Khudawadi": range(70320, 70399 + 1),
-    "Grantha": range(70400, 70527 + 1),
-    "Newa": range(70656, 70783 + 1),
-    "Tirhuta": range(70784, 70879 + 1),
-    "Siddham": range(71040, 71167 + 1),
-    "Modi": range(71168, 71263 + 1),
-    "Mongolian Supplement": range(71264, 71295 + 1),
-    "Takri": range(71296, 71375 + 1),
-    "Ahom": range(71424, 71487 + 1),
-    "Warang Citi": range(71840, 71935 + 1),
-    "Zanabazar Square": range(72192, 72271 + 1),
-    "Soyombo": range(72272, 72367 + 1),
-    "Pau Cin Hau": range(72384, 72447 + 1),
-    "Bhaiksuki": range(72704, 72815 + 1),
-    "Marchen": range(72816, 72895 + 1),
-    "Masaram Gondi": range(72960, 73055 + 1),
-    "Cuneiform": range(73728, 74751 + 1),
-    "Cuneiform Numbers and Punctuation": range(74752, 74879 + 1),
-    "Early Dynastic Cuneiform": range(74880, 75087 + 1),
-    "Egyptian Hieroglyphs": range(77824, 78895 + 1),
-    "Anatolian Hieroglyphs": range(82944, 83583 + 1),
-    "Bamum Supplement": range(92160, 92735 + 1),
-    "Mro": range(92736, 92783 + 1),
-    "Bassa Vah": range(92880, 92927 + 1),
-    "Pahawh Hmong": range(92928, 93071 + 1),
-    "Miao": range(93952, 94111 + 1),
-    "Ideographic Symbols and Punctuation": range(94176, 94207 + 1),
-    "Tangut": range(94208, 100351 + 1),
-    "Tangut Components": range(100352, 101119 + 1),
-    "Kana Supplement": range(110592, 110847 + 1),
-    "Kana Extended-A": range(110848, 110895 + 1),
-    "Nushu": range(110960, 111359 + 1),
-    "Duployan": range(113664, 113823 + 1),
-    "Shorthand Format Controls": range(113824, 113839 + 1),
-    "Byzantine Musical Symbols": range(118784, 119039 + 1),
-    "Musical Symbols": range(119040, 119295 + 1),
-    "Ancient Greek Musical Notation": range(119296, 119375 + 1),
-    "Tai Xuan Jing Symbols": range(119552, 119647 + 1),
-    "Counting Rod Numerals": range(119648, 119679 + 1),
-    "Mathematical Alphanumeric Symbols": range(119808, 120831 + 1),
-    "Sutton SignWriting": range(120832, 121519 + 1),
-    "Glagolitic Supplement": range(122880, 122927 + 1),
-    "Mende Kikakui": range(124928, 125151 + 1),
-    "Adlam": range(125184, 125279 + 1),
-    "Arabic Mathematical Alphabetic Symbols": range(126464, 126719 + 1),
-    "Mahjong Tiles": range(126976, 127023 + 1),
-    "Domino Tiles": range(127024, 127135 + 1),
-    "Playing Cards": range(127136, 127231 + 1),
-    "Enclosed Alphanumeric Supplement": range(127232, 127487 + 1),
-    "Enclosed Ideographic Supplement": range(127488, 127743 + 1),
-    "Miscellaneous Symbols and Pictographs": range(127744, 128511 + 1),
-    "Emoticons range(Emoji)": range(128512, 128591 + 1),
-    "Ornamental Dingbats": range(128592, 128639 + 1),
-    "Transport and Map Symbols": range(128640, 128767 + 1),
-    "Alchemical Symbols": range(128768, 128895 + 1),
-    "Geometric Shapes Extended": range(128896, 129023 + 1),
-    "Supplemental Arrows-C": range(129024, 129279 + 1),
-    "Supplemental Symbols and Pictographs": range(129280, 129535 + 1),
-    "CJK Unified Ideographs Extension B": range(131072, 173791 + 1),
-    "CJK Unified Ideographs Extension C": range(173824, 177983 + 1),
-    "CJK Unified Ideographs Extension D": range(177984, 178207 + 1),
-    "CJK Unified Ideographs Extension E": range(178208, 183983 + 1),
-    "CJK Unified Ideographs Extension F": range(183984, 191471 + 1),
-    "CJK Compatibility Ideographs Supplement": range(194560, 195103 + 1),
-    "Tags": range(917504, 917631 + 1),
-    "Variation Selectors Supplement": range(917760, 917999 + 1),
+    "Control character": range(32),
+    "Basic Latin": range(32, 128),
+    "Latin-1 Supplement": range(128, 256),
+    "Latin Extended-A": range(256, 384),
+    "Latin Extended-B": range(384, 592),
+    "IPA Extensions": range(592, 688),
+    "Spacing Modifier Letters": range(688, 768),
+    "Combining Diacritical Marks": range(768, 880),
+    "Greek and Coptic": range(880, 1024),
+    "Cyrillic": range(1024, 1280),
+    "Cyrillic Supplement": range(1280, 1328),
+    "Armenian": range(1328, 1424),
+    "Hebrew": range(1424, 1536),
+    "Arabic": range(1536, 1792),
+    "Syriac": range(1792, 1872),
+    "Arabic Supplement": range(1872, 1920),
+    "Thaana": range(1920, 1984),
+    "NKo": range(1984, 2048),
+    "Samaritan": range(2048, 2112),
+    "Mandaic": range(2112, 2144),
+    "Syriac Supplement": range(2144, 2160),
+    "Arabic Extended-B": range(2160, 2208),
+    "Arabic Extended-A": range(2208, 2304),
+    "Devanagari": range(2304, 2432),
+    "Bengali": range(2432, 2560),
+    "Gurmukhi": range(2560, 2688),
+    "Gujarati": range(2688, 2816),
+    "Oriya": range(2816, 2944),
+    "Tamil": range(2944, 3072),
+    "Telugu": range(3072, 3200),
+    "Kannada": range(3200, 3328),
+    "Malayalam": range(3328, 3456),
+    "Sinhala": range(3456, 3584),
+    "Thai": range(3584, 3712),
+    "Lao": range(3712, 3840),
+    "Tibetan": range(3840, 4096),
+    "Myanmar": range(4096, 4256),
+    "Georgian": range(4256, 4352),
+    "Hangul Jamo": range(4352, 4608),
+    "Ethiopic": range(4608, 4992),
+    "Ethiopic Supplement": range(4992, 5024),
+    "Cherokee": range(5024, 5120),
+    "Unified Canadian Aboriginal Syllabics": range(5120, 5760),
+    "Ogham": range(5760, 5792),
+    "Runic": range(5792, 5888),
+    "Tagalog": range(5888, 5920),
+    "Hanunoo": range(5920, 5952),
+    "Buhid": range(5952, 5984),
+    "Tagbanwa": range(5984, 6016),
+    "Khmer": range(6016, 6144),
+    "Mongolian": range(6144, 6320),
+    "Unified Canadian Aboriginal Syllabics Extended": range(6320, 6400),
+    "Limbu": range(6400, 6480),
+    "Tai Le": range(6480, 6528),
+    "New Tai Lue": range(6528, 6624),
+    "Khmer Symbols": range(6624, 6656),
+    "Buginese": range(6656, 6688),
+    "Tai Tham": range(6688, 6832),
+    "Combining Diacritical Marks Extended": range(6832, 6912),
+    "Balinese": range(6912, 7040),
+    "Sundanese": range(7040, 7104),
+    "Batak": range(7104, 7168),
+    "Lepcha": range(7168, 7248),
+    "Ol Chiki": range(7248, 7296),
+    "Cyrillic Extended-C": range(7296, 7312),
+    "Georgian Extended": range(7312, 7360),
+    "Sundanese Supplement": range(7360, 7376),
+    "Vedic Extensions": range(7376, 7424),
+    "Phonetic Extensions": range(7424, 7552),
+    "Phonetic Extensions Supplement": range(7552, 7616),
+    "Combining Diacritical Marks Supplement": range(7616, 7680),
+    "Latin Extended Additional": range(7680, 7936),
+    "Greek Extended": range(7936, 8192),
+    "General Punctuation": range(8192, 8304),
+    "Superscripts and Subscripts": range(8304, 8352),
+    "Currency Symbols": range(8352, 8400),
+    "Combining Diacritical Marks for Symbols": range(8400, 8448),
+    "Letterlike Symbols": range(8448, 8528),
+    "Number Forms": range(8528, 8592),
+    "Arrows": range(8592, 8704),
+    "Mathematical Operators": range(8704, 8960),
+    "Miscellaneous Technical": range(8960, 9216),
+    "Control Pictures": range(9216, 9280),
+    "Optical Character Recognition": range(9280, 9312),
+    "Enclosed Alphanumerics": range(9312, 9472),
+    "Box Drawing": range(9472, 9600),
+    "Block Elements": range(9600, 9632),
+    "Geometric Shapes": range(9632, 9728),
+    "Miscellaneous Symbols": range(9728, 9984),
+    "Dingbats": range(9984, 10176),
+    "Miscellaneous Mathematical Symbols-A": range(10176, 10224),
+    "Supplemental Arrows-A": range(10224, 10240),
+    "Braille Patterns": range(10240, 10496),
+    "Supplemental Arrows-B": range(10496, 10624),
+    "Miscellaneous Mathematical Symbols-B": range(10624, 10752),
+    "Supplemental Mathematical Operators": range(10752, 11008),
+    "Miscellaneous Symbols and Arrows": range(11008, 11264),
+    "Glagolitic": range(11264, 11360),
+    "Latin Extended-C": range(11360, 11392),
+    "Coptic": range(11392, 11520),
+    "Georgian Supplement": range(11520, 11568),
+    "Tifinagh": range(11568, 11648),
+    "Ethiopic Extended": range(11648, 11744),
+    "Cyrillic Extended-A": range(11744, 11776),
+    "Supplemental Punctuation": range(11776, 11904),
+    "CJK Radicals Supplement": range(11904, 12032),
+    "Kangxi Radicals": range(12032, 12256),
+    "Ideographic Description Characters": range(12272, 12288),
+    "CJK Symbols and Punctuation": range(12288, 12352),
+    "Hiragana": range(12352, 12448),
+    "Katakana": range(12448, 12544),
+    "Bopomofo": range(12544, 12592),
+    "Hangul Compatibility Jamo": range(12592, 12688),
+    "Kanbun": range(12688, 12704),
+    "Bopomofo Extended": range(12704, 12736),
+    "CJK Strokes": range(12736, 12784),
+    "Katakana Phonetic Extensions": range(12784, 12800),
+    "Enclosed CJK Letters and Months": range(12800, 13056),
+    "CJK Compatibility": range(13056, 13312),
+    "CJK Unified Ideographs Extension A": range(13312, 19904),
+    "Yijing Hexagram Symbols": range(19904, 19968),
+    "CJK Unified Ideographs": range(19968, 40960),
+    "Yi Syllables": range(40960, 42128),
+    "Yi Radicals": range(42128, 42192),
+    "Lisu": range(42192, 42240),
+    "Vai": range(42240, 42560),
+    "Cyrillic Extended-B": range(42560, 42656),
+    "Bamum": range(42656, 42752),
+    "Modifier Tone Letters": range(42752, 42784),
+    "Latin Extended-D": range(42784, 43008),
+    "Syloti Nagri": range(43008, 43056),
+    "Common Indic Number Forms": range(43056, 43072),
+    "Phags-pa": range(43072, 43136),
+    "Saurashtra": range(43136, 43232),
+    "Devanagari Extended": range(43232, 43264),
+    "Kayah Li": range(43264, 43312),
+    "Rejang": range(43312, 43360),
+    "Hangul Jamo Extended-A": range(43360, 43392),
+    "Javanese": range(43392, 43488),
+    "Myanmar Extended-B": range(43488, 43520),
+    "Cham": range(43520, 43616),
+    "Myanmar Extended-A": range(43616, 43648),
+    "Tai Viet": range(43648, 43744),
+    "Meetei Mayek Extensions": range(43744, 43776),
+    "Ethiopic Extended-A": range(43776, 43824),
+    "Latin Extended-E": range(43824, 43888),
+    "Cherokee Supplement": range(43888, 43968),
+    "Meetei Mayek": range(43968, 44032),
+    "Hangul Syllables": range(44032, 55216),
+    "Hangul Jamo Extended-B": range(55216, 55296),
+    "High Surrogates": range(55296, 56192),
+    "High Private Use Surrogates": range(56192, 56320),
+    "Low Surrogates": range(56320, 57344),
+    "Private Use Area": range(57344, 63744),
+    "CJK Compatibility Ideographs": range(63744, 64256),
+    "Alphabetic Presentation Forms": range(64256, 64336),
+    "Arabic Presentation Forms-A": range(64336, 65024),
+    "Variation Selectors": range(65024, 65040),
+    "Vertical Forms": range(65040, 65056),
+    "Combining Half Marks": range(65056, 65072),
+    "CJK Compatibility Forms": range(65072, 65104),
+    "Small Form Variants": range(65104, 65136),
+    "Arabic Presentation Forms-B": range(65136, 65280),
+    "Halfwidth and Fullwidth Forms": range(65280, 65520),
+    "Specials": range(65520, 65536),
+    "Linear B Syllabary": range(65536, 65664),
+    "Linear B Ideograms": range(65664, 65792),
+    "Aegean Numbers": range(65792, 65856),
+    "Ancient Greek Numbers": range(65856, 65936),
+    "Ancient Symbols": range(65936, 66000),
+    "Phaistos Disc": range(66000, 66048),
+    "Lycian": range(66176, 66208),
+    "Carian": range(66208, 66272),
+    "Coptic Epact Numbers": range(66272, 66304),
+    "Old Italic": range(66304, 66352),
+    "Gothic": range(66352, 66384),
+    "Old Permic": range(66384, 66432),
+    "Ugaritic": range(66432, 66464),
+    "Old Persian": range(66464, 66528),
+    "Deseret": range(66560, 66640),
+    "Shavian": range(66640, 66688),
+    "Osmanya": range(66688, 66736),
+    "Osage": range(66736, 66816),
+    "Elbasan": range(66816, 66864),
+    "Caucasian Albanian": range(66864, 66928),
+    "Vithkuqi": range(66928, 67008),
+    "Linear A": range(67072, 67456),
+    "Latin Extended-F": range(67456, 67520),
+    "Cypriot Syllabary": range(67584, 67648),
+    "Imperial Aramaic": range(67648, 67680),
+    "Palmyrene": range(67680, 67712),
+    "Nabataean": range(67712, 67760),
+    "Hatran": range(67808, 67840),
+    "Phoenician": range(67840, 67872),
+    "Lydian": range(67872, 67904),
+    "Meroitic Hieroglyphs": range(67968, 68000),
+    "Meroitic Cursive": range(68000, 68096),
+    "Kharoshthi": range(68096, 68192),
+    "Old South Arabian": range(68192, 68224),
+    "Old North Arabian": range(68224, 68256),
+    "Manichaean": range(68288, 68352),
+    "Avestan": range(68352, 68416),
+    "Inscriptional Parthian": range(68416, 68448),
+    "Inscriptional Pahlavi": range(68448, 68480),
+    "Psalter Pahlavi": range(68480, 68528),
+    "Old Turkic": range(68608, 68688),
+    "Old Hungarian": range(68736, 68864),
+    "Hanifi Rohingya": range(68864, 68928),
+    "Rumi Numeral Symbols": range(69216, 69248),
+    "Yezidi": range(69248, 69312),
+    "Arabic Extended-C": range(69312, 69376),
+    "Old Sogdian": range(69376, 69424),
+    "Sogdian": range(69424, 69488),
+    "Old Uyghur": range(69488, 69552),
+    "Chorasmian": range(69552, 69600),
+    "Elymaic": range(69600, 69632),
+    "Brahmi": range(69632, 69760),
+    "Kaithi": range(69760, 69840),
+    "Sora Sompeng": range(69840, 69888),
+    "Chakma": range(69888, 69968),
+    "Mahajani": range(69968, 70016),
+    "Sharada": range(70016, 70112),
+    "Sinhala Archaic Numbers": range(70112, 70144),
+    "Khojki": range(70144, 70224),
+    "Multani": range(70272, 70320),
+    "Khudawadi": range(70320, 70400),
+    "Grantha": range(70400, 70528),
+    "Newa": range(70656, 70784),
+    "Tirhuta": range(70784, 70880),
+    "Siddham": range(71040, 71168),
+    "Modi": range(71168, 71264),
+    "Mongolian Supplement": range(71264, 71296),
+    "Takri": range(71296, 71376),
+    "Ahom": range(71424, 71504),
+    "Dogra": range(71680, 71760),
+    "Warang Citi": range(71840, 71936),
+    "Dives Akuru": range(71936, 72032),
+    "Nandinagari": range(72096, 72192),
+    "Zanabazar Square": range(72192, 72272),
+    "Soyombo": range(72272, 72368),
+    "Unified Canadian Aboriginal Syllabics Extended-A": range(72368, 72384),
+    "Pau Cin Hau": range(72384, 72448),
+    "Devanagari Extended-A": range(72448, 72544),
+    "Bhaiksuki": range(72704, 72816),
+    "Marchen": range(72816, 72896),
+    "Masaram Gondi": range(72960, 73056),
+    "Gunjala Gondi": range(73056, 73136),
+    "Makasar": range(73440, 73472),
+    "Kawi": range(73472, 73568),
+    "Lisu Supplement": range(73648, 73664),
+    "Tamil Supplement": range(73664, 73728),
+    "Cuneiform": range(73728, 74752),
+    "Cuneiform Numbers and Punctuation": range(74752, 74880),
+    "Early Dynastic Cuneiform": range(74880, 75088),
+    "Cypro-Minoan": range(77712, 77824),
+    "Egyptian Hieroglyphs": range(77824, 78896),
+    "Egyptian Hieroglyph Format Controls": range(78896, 78944),
+    "Anatolian Hieroglyphs": range(82944, 83584),
+    "Bamum Supplement": range(92160, 92736),
+    "Mro": range(92736, 92784),
+    "Tangsa": range(92784, 92880),
+    "Bassa Vah": range(92880, 92928),
+    "Pahawh Hmong": range(92928, 93072),
+    "Medefaidrin": range(93760, 93856),
+    "Miao": range(93952, 94112),
+    "Ideographic Symbols and Punctuation": range(94176, 94208),
+    "Tangut": range(94208, 100352),
+    "Tangut Components": range(100352, 101120),
+    "Khitan Small Script": range(101120, 101632),
+    "Tangut Supplement": range(101632, 101760),
+    "Kana Extended-B": range(110576, 110592),
+    "Kana Supplement": range(110592, 110848),
+    "Kana Extended-A": range(110848, 110896),
+    "Small Kana Extension": range(110896, 110960),
+    "Nushu": range(110960, 111360),
+    "Duployan": range(113664, 113824),
+    "Shorthand Format Controls": range(113824, 113840),
+    "Znamenny Musical Notation": range(118528, 118736),
+    "Byzantine Musical Symbols": range(118784, 119040),
+    "Musical Symbols": range(119040, 119296),
+    "Ancient Greek Musical Notation": range(119296, 119376),
+    "Kaktovik Numerals": range(119488, 119520),
+    "Mayan Numerals": range(119520, 119552),
+    "Tai Xuan Jing Symbols": range(119552, 119648),
+    "Counting Rod Numerals": range(119648, 119680),
+    "Mathematical Alphanumeric Symbols": range(119808, 120832),
+    "Sutton SignWriting": range(120832, 121520),
+    "Latin Extended-G": range(122624, 122880),
+    "Glagolitic Supplement": range(122880, 122928),
+    "Cyrillic Extended-D": range(122928, 123024),
+    "Nyiakeng Puachue Hmong": range(123136, 123216),
+    "Toto": range(123536, 123584),
+    "Wancho": range(123584, 123648),
+    "Nag Mundari": range(124112, 124160),
+    "Ethiopic Extended-B": range(124896, 124928),
+    "Mende Kikakui": range(124928, 125152),
+    "Adlam": range(125184, 125280),
+    "Indic Siyaq Numbers": range(126064, 126144),
+    "Ottoman Siyaq Numbers": range(126208, 126288),
+    "Arabic Mathematical Alphabetic Symbols": range(126464, 126720),
+    "Mahjong Tiles": range(126976, 127024),
+    "Domino Tiles": range(127024, 127136),
+    "Playing Cards": range(127136, 127232),
+    "Enclosed Alphanumeric Supplement": range(127232, 127488),
+    "Enclosed Ideographic Supplement": range(127488, 127744),
+    "Miscellaneous Symbols and Pictographs": range(127744, 128512),
+    "Emoticons range(Emoji)": range(128512, 128592),
+    "Ornamental Dingbats": range(128592, 128640),
+    "Transport and Map Symbols": range(128640, 128768),
+    "Alchemical Symbols": range(128768, 128896),
+    "Geometric Shapes Extended": range(128896, 129024),
+    "Supplemental Arrows-C": range(129024, 129280),
+    "Supplemental Symbols and Pictographs": range(129280, 129536),
+    "Chess Symbols": range(129536, 129648),
+    "Symbols and Pictographs Extended-A": range(129648, 129792),
+    "Symbols for Legacy Computing": range(129792, 130048),
+    "CJK Unified Ideographs Extension B": range(131072, 173792),
+    "CJK Unified Ideographs Extension C": range(173824, 177984),
+    "CJK Unified Ideographs Extension D": range(177984, 178208),
+    "CJK Unified Ideographs Extension E": range(178208, 183984),
+    "CJK Unified Ideographs Extension F": range(183984, 191472),
+    "CJK Compatibility Ideographs Supplement": range(194560, 195104),
+    "CJK Unified Ideographs Extension G": range(196608, 201552),
+    "CJK Unified Ideographs Extension H": range(201552, 205744),
+    "Tags": range(917504, 917632),
+    "Variation Selectors Supplement": range(917760, 918000),
+    "Supplementary Private Use Area-A": range(983040, 1048576),
+    "Supplementary Private Use Area-B": range(1048576, 1114112),
 }
 
 
@@ -331,11 +380,23 @@ RE_POSSIBLE_ENCODING_INDICATION = re_compile(
     IGNORECASE,
 )
 
+IANA_NO_ALIASES = [
+    "cp720",
+    "cp737",
+    "cp856",
+    "cp874",
+    "cp875",
+    "cp1006",
+    "koi8_r",
+    "koi8_t",
+    "koi8_u",
+]
+
 IANA_SUPPORTED: List[str] = sorted(
     filter(
         lambda x: x.endswith("_codec") is False
         and x not in {"rot_13", "tactis", "mbcs"},
-        list(set(aliases.values())),
+        list(set(aliases.values())) + IANA_NO_ALIASES,
     )
 )
 
@@ -489,7 +550,1446 @@ COMMON_SAFE_ASCII_CHARACTERS: Set[str] = {
 KO_NAMES: Set[str] = {"johab", "cp949", "euc_kr"}
 ZH_NAMES: Set[str] = {"big5", "cp950", "big5hkscs", "hz"}
 
-LANGUAGE_SUPPORTED_COUNT: int = len(FREQUENCIES)
-
 # Logging LEVEL below DEBUG
 TRACE: int = 5
+
+
+# Language label that contain the em dash "—"
+# character are to be considered alternative seq to origin
+FREQUENCIES: Dict[str, List[str]] = {
+    "English": [
+        "e",
+        "a",
+        "t",
+        "i",
+        "o",
+        "n",
+        "s",
+        "r",
+        "h",
+        "l",
+        "d",
+        "c",
+        "u",
+        "m",
+        "f",
+        "p",
+        "g",
+        "w",
+        "y",
+        "b",
+        "v",
+        "k",
+        "x",
+        "j",
+        "z",
+        "q",
+    ],
+    "English—": [
+        "e",
+        "a",
+        "t",
+        "i",
+        "o",
+        "n",
+        "s",
+        "r",
+        "h",
+        "l",
+        "d",
+        "c",
+        "m",
+        "u",
+        "f",
+        "p",
+        "g",
+        "w",
+        "b",
+        "y",
+        "v",
+        "k",
+        "j",
+        "x",
+        "z",
+        "q",
+    ],
+    "German": [
+        "e",
+        "n",
+        "i",
+        "r",
+        "s",
+        "t",
+        "a",
+        "d",
+        "h",
+        "u",
+        "l",
+        "g",
+        "o",
+        "c",
+        "m",
+        "b",
+        "f",
+        "k",
+        "w",
+        "z",
+        "p",
+        "v",
+        "ü",
+        "ä",
+        "ö",
+        "j",
+    ],
+    "French": [
+        "e",
+        "a",
+        "s",
+        "n",
+        "i",
+        "t",
+        "r",
+        "l",
+        "u",
+        "o",
+        "d",
+        "c",
+        "p",
+        "m",
+        "é",
+        "v",
+        "g",
+        "f",
+        "b",
+        "h",
+        "q",
+        "à",
+        "x",
+        "è",
+        "y",
+        "j",
+    ],
+    "Dutch": [
+        "e",
+        "n",
+        "a",
+        "i",
+        "r",
+        "t",
+        "o",
+        "d",
+        "s",
+        "l",
+        "g",
+        "h",
+        "v",
+        "m",
+        "u",
+        "k",
+        "c",
+        "p",
+        "b",
+        "w",
+        "j",
+        "z",
+        "f",
+        "y",
+        "x",
+        "ë",
+    ],
+    "Italian": [
+        "e",
+        "i",
+        "a",
+        "o",
+        "n",
+        "l",
+        "t",
+        "r",
+        "s",
+        "c",
+        "d",
+        "u",
+        "p",
+        "m",
+        "g",
+        "v",
+        "f",
+        "b",
+        "z",
+        "h",
+        "q",
+        "è",
+        "à",
+        "k",
+        "y",
+        "ò",
+    ],
+    "Polish": [
+        "a",
+        "i",
+        "o",
+        "e",
+        "n",
+        "r",
+        "z",
+        "w",
+        "s",
+        "c",
+        "t",
+        "k",
+        "y",
+        "d",
+        "p",
+        "m",
+        "u",
+        "l",
+        "j",
+        "ł",
+        "g",
+        "b",
+        "h",
+        "ą",
+        "ę",
+        "ó",
+    ],
+    "Spanish": [
+        "e",
+        "a",
+        "o",
+        "n",
+        "s",
+        "r",
+        "i",
+        "l",
+        "d",
+        "t",
+        "c",
+        "u",
+        "m",
+        "p",
+        "b",
+        "g",
+        "v",
+        "f",
+        "y",
+        "ó",
+        "h",
+        "q",
+        "í",
+        "j",
+        "z",
+        "á",
+    ],
+    "Russian": [
+        "о",
+        "а",
+        "е",
+        "и",
+        "н",
+        "с",
+        "т",
+        "р",
+        "в",
+        "л",
+        "к",
+        "м",
+        "д",
+        "п",
+        "у",
+        "г",
+        "я",
+        "ы",
+        "з",
+        "б",
+        "й",
+        "ь",
+        "ч",
+        "х",
+        "ж",
+        "ц",
+    ],
+    # Jap-Kanji
+    "Japanese": [
+        "人",
+        "一",
+        "大",
+        "亅",
+        "丁",
+        "丨",
+        "竹",
+        "笑",
+        "口",
+        "日",
+        "今",
+        "二",
+        "彳",
+        "行",
+        "十",
+        "土",
+        "丶",
+        "寸",
+        "寺",
+        "時",
+        "乙",
+        "丿",
+        "乂",
+        "气",
+        "気",
+        "冂",
+        "巾",
+        "亠",
+        "市",
+        "目",
+        "儿",
+        "見",
+        "八",
+        "小",
+        "凵",
+        "県",
+        "月",
+        "彐",
+        "門",
+        "間",
+        "木",
+        "東",
+        "山",
+        "出",
+        "本",
+        "中",
+        "刀",
+        "分",
+        "耳",
+        "又",
+        "取",
+        "最",
+        "言",
+        "田",
+        "心",
+        "思",
+        "刂",
+        "前",
+        "京",
+        "尹",
+        "事",
+        "生",
+        "厶",
+        "云",
+        "会",
+        "未",
+        "来",
+        "白",
+        "冫",
+        "楽",
+        "灬",
+        "馬",
+        "尸",
+        "尺",
+        "駅",
+        "明",
+        "耂",
+        "者",
+        "了",
+        "阝",
+        "都",
+        "高",
+        "卜",
+        "占",
+        "厂",
+        "广",
+        "店",
+        "子",
+        "申",
+        "奄",
+        "亻",
+        "俺",
+        "上",
+        "方",
+        "冖",
+        "学",
+        "衣",
+        "艮",
+        "食",
+        "自",
+    ],
+    # Jap-Katakana
+    "Japanese—": [
+        "ー",
+        "ン",
+        "ス",
+        "・",
+        "ル",
+        "ト",
+        "リ",
+        "イ",
+        "ア",
+        "ラ",
+        "ッ",
+        "ク",
+        "ド",
+        "シ",
+        "レ",
+        "ジ",
+        "タ",
+        "フ",
+        "ロ",
+        "カ",
+        "テ",
+        "マ",
+        "ィ",
+        "グ",
+        "バ",
+        "ム",
+        "プ",
+        "オ",
+        "コ",
+        "デ",
+        "ニ",
+        "ウ",
+        "メ",
+        "サ",
+        "ビ",
+        "ナ",
+        "ブ",
+        "ャ",
+        "エ",
+        "ュ",
+        "チ",
+        "キ",
+        "ズ",
+        "ダ",
+        "パ",
+        "ミ",
+        "ェ",
+        "ョ",
+        "ハ",
+        "セ",
+        "ベ",
+        "ガ",
+        "モ",
+        "ツ",
+        "ネ",
+        "ボ",
+        "ソ",
+        "ノ",
+        "ァ",
+        "ヴ",
+        "ワ",
+        "ポ",
+        "ペ",
+        "ピ",
+        "ケ",
+        "ゴ",
+        "ギ",
+        "ザ",
+        "ホ",
+        "ゲ",
+        "ォ",
+        "ヤ",
+        "ヒ",
+        "ユ",
+        "ヨ",
+        "ヘ",
+        "ゼ",
+        "ヌ",
+        "ゥ",
+        "ゾ",
+        "ヶ",
+        "ヂ",
+        "ヲ",
+        "ヅ",
+        "ヵ",
+        "ヱ",
+        "ヰ",
+        "ヮ",
+        "ヽ",
+        "゠",
+        "ヾ",
+        "ヷ",
+        "ヿ",
+        "ヸ",
+        "ヹ",
+        "ヺ",
+    ],
+    # Jap-Hiragana
+    "Japanese——": [
+        "の",
+        "に",
+        "る",
+        "た",
+        "と",
+        "は",
+        "し",
+        "い",
+        "を",
+        "で",
+        "て",
+        "が",
+        "な",
+        "れ",
+        "か",
+        "ら",
+        "さ",
+        "っ",
+        "り",
+        "す",
+        "あ",
+        "も",
+        "こ",
+        "ま",
+        "う",
+        "く",
+        "よ",
+        "き",
+        "ん",
+        "め",
+        "お",
+        "け",
+        "そ",
+        "つ",
+        "だ",
+        "や",
+        "え",
+        "ど",
+        "わ",
+        "ち",
+        "み",
+        "せ",
+        "じ",
+        "ば",
+        "へ",
+        "び",
+        "ず",
+        "ろ",
+        "ほ",
+        "げ",
+        "む",
+        "べ",
+        "ひ",
+        "ょ",
+        "ゆ",
+        "ぶ",
+        "ご",
+        "ゃ",
+        "ね",
+        "ふ",
+        "ぐ",
+        "ぎ",
+        "ぼ",
+        "ゅ",
+        "づ",
+        "ざ",
+        "ぞ",
+        "ぬ",
+        "ぜ",
+        "ぱ",
+        "ぽ",
+        "ぷ",
+        "ぴ",
+        "ぃ",
+        "ぁ",
+        "ぇ",
+        "ぺ",
+        "ゞ",
+        "ぢ",
+        "ぉ",
+        "ぅ",
+        "ゐ",
+        "ゝ",
+        "ゑ",
+        "゛",
+        "゜",
+        "ゎ",
+        "ゔ",
+        "゚",
+        "ゟ",
+        "゙",
+        "ゕ",
+        "ゖ",
+    ],
+    "Portuguese": [
+        "a",
+        "e",
+        "o",
+        "s",
+        "i",
+        "r",
+        "d",
+        "n",
+        "t",
+        "m",
+        "u",
+        "c",
+        "l",
+        "p",
+        "g",
+        "v",
+        "b",
+        "f",
+        "h",
+        "ã",
+        "q",
+        "é",
+        "ç",
+        "á",
+        "z",
+        "í",
+    ],
+    "Swedish": [
+        "e",
+        "a",
+        "n",
+        "r",
+        "t",
+        "s",
+        "i",
+        "l",
+        "d",
+        "o",
+        "m",
+        "k",
+        "g",
+        "v",
+        "h",
+        "f",
+        "u",
+        "p",
+        "ä",
+        "c",
+        "b",
+        "ö",
+        "å",
+        "y",
+        "j",
+        "x",
+    ],
+    "Chinese": [
+        "的",
+        "一",
+        "是",
+        "不",
+        "了",
+        "在",
+        "人",
+        "有",
+        "我",
+        "他",
+        "这",
+        "个",
+        "们",
+        "中",
+        "来",
+        "上",
+        "大",
+        "为",
+        "和",
+        "国",
+        "地",
+        "到",
+        "以",
+        "说",
+        "时",
+        "要",
+        "就",
+        "出",
+        "会",
+        "可",
+        "也",
+        "你",
+        "对",
+        "生",
+        "能",
+        "而",
+        "子",
+        "那",
+        "得",
+        "于",
+        "着",
+        "下",
+        "自",
+        "之",
+        "年",
+        "过",
+        "发",
+        "后",
+        "作",
+        "里",
+        "用",
+        "道",
+        "行",
+        "所",
+        "然",
+        "家",
+        "种",
+        "事",
+        "成",
+        "方",
+        "多",
+        "经",
+        "么",
+        "去",
+        "法",
+        "学",
+        "如",
+        "都",
+        "同",
+        "现",
+        "当",
+        "没",
+        "动",
+        "面",
+        "起",
+        "看",
+        "定",
+        "天",
+        "分",
+        "还",
+        "进",
+        "好",
+        "小",
+        "部",
+        "其",
+        "些",
+        "主",
+        "样",
+        "理",
+        "心",
+        "她",
+        "本",
+        "前",
+        "开",
+        "但",
+        "因",
+        "只",
+        "从",
+        "想",
+        "实",
+    ],
+    "Ukrainian": [
+        "о",
+        "а",
+        "н",
+        "і",
+        "и",
+        "р",
+        "в",
+        "т",
+        "е",
+        "с",
+        "к",
+        "л",
+        "у",
+        "д",
+        "м",
+        "п",
+        "з",
+        "я",
+        "ь",
+        "б",
+        "г",
+        "й",
+        "ч",
+        "х",
+        "ц",
+        "ї",
+    ],
+    "Norwegian": [
+        "e",
+        "r",
+        "n",
+        "t",
+        "a",
+        "s",
+        "i",
+        "o",
+        "l",
+        "d",
+        "g",
+        "k",
+        "m",
+        "v",
+        "f",
+        "p",
+        "u",
+        "b",
+        "h",
+        "å",
+        "y",
+        "j",
+        "ø",
+        "c",
+        "æ",
+        "w",
+    ],
+    "Finnish": [
+        "a",
+        "i",
+        "n",
+        "t",
+        "e",
+        "s",
+        "l",
+        "o",
+        "u",
+        "k",
+        "ä",
+        "m",
+        "r",
+        "v",
+        "j",
+        "h",
+        "p",
+        "y",
+        "d",
+        "ö",
+        "g",
+        "c",
+        "b",
+        "f",
+        "w",
+        "z",
+    ],
+    "Vietnamese": [
+        "n",
+        "h",
+        "t",
+        "i",
+        "c",
+        "g",
+        "a",
+        "o",
+        "u",
+        "m",
+        "l",
+        "r",
+        "à",
+        "đ",
+        "s",
+        "e",
+        "v",
+        "p",
+        "b",
+        "y",
+        "ư",
+        "d",
+        "á",
+        "k",
+        "ộ",
+        "ế",
+    ],
+    "Czech": [
+        "o",
+        "e",
+        "a",
+        "n",
+        "t",
+        "s",
+        "i",
+        "l",
+        "v",
+        "r",
+        "k",
+        "d",
+        "u",
+        "m",
+        "p",
+        "í",
+        "c",
+        "h",
+        "z",
+        "á",
+        "y",
+        "j",
+        "b",
+        "ě",
+        "é",
+        "ř",
+    ],
+    "Hungarian": [
+        "e",
+        "a",
+        "t",
+        "l",
+        "s",
+        "n",
+        "k",
+        "r",
+        "i",
+        "o",
+        "z",
+        "á",
+        "é",
+        "g",
+        "m",
+        "b",
+        "y",
+        "v",
+        "d",
+        "h",
+        "u",
+        "p",
+        "j",
+        "ö",
+        "f",
+        "c",
+    ],
+    "Korean": [
+        "이",
+        "다",
+        "에",
+        "의",
+        "는",
+        "로",
+        "하",
+        "을",
+        "가",
+        "고",
+        "지",
+        "서",
+        "한",
+        "은",
+        "기",
+        "으",
+        "년",
+        "대",
+        "사",
+        "시",
+        "를",
+        "리",
+        "도",
+        "인",
+        "스",
+        "일",
+    ],
+    "Indonesian": [
+        "a",
+        "n",
+        "e",
+        "i",
+        "r",
+        "t",
+        "u",
+        "s",
+        "d",
+        "k",
+        "m",
+        "l",
+        "g",
+        "p",
+        "b",
+        "o",
+        "h",
+        "y",
+        "j",
+        "c",
+        "w",
+        "f",
+        "v",
+        "z",
+        "x",
+        "q",
+    ],
+    "Turkish": [
+        "a",
+        "e",
+        "i",
+        "n",
+        "r",
+        "l",
+        "ı",
+        "k",
+        "d",
+        "t",
+        "s",
+        "m",
+        "y",
+        "u",
+        "o",
+        "b",
+        "ü",
+        "ş",
+        "v",
+        "g",
+        "z",
+        "h",
+        "c",
+        "p",
+        "ç",
+        "ğ",
+    ],
+    "Romanian": [
+        "e",
+        "i",
+        "a",
+        "r",
+        "n",
+        "t",
+        "u",
+        "l",
+        "o",
+        "c",
+        "s",
+        "d",
+        "p",
+        "m",
+        "ă",
+        "f",
+        "v",
+        "î",
+        "g",
+        "b",
+        "ș",
+        "ț",
+        "z",
+        "h",
+        "â",
+        "j",
+    ],
+    "Farsi": [
+        "ا",
+        "ی",
+        "ر",
+        "د",
+        "ن",
+        "ه",
+        "و",
+        "م",
+        "ت",
+        "ب",
+        "س",
+        "ل",
+        "ک",
+        "ش",
+        "ز",
+        "ف",
+        "گ",
+        "ع",
+        "خ",
+        "ق",
+        "ج",
+        "آ",
+        "پ",
+        "ح",
+        "ط",
+        "ص",
+    ],
+    "Arabic": [
+        "ا",
+        "ل",
+        "ي",
+        "م",
+        "و",
+        "ن",
+        "ر",
+        "ت",
+        "ب",
+        "ة",
+        "ع",
+        "د",
+        "س",
+        "ف",
+        "ه",
+        "ك",
+        "ق",
+        "أ",
+        "ح",
+        "ج",
+        "ش",
+        "ط",
+        "ص",
+        "ى",
+        "خ",
+        "إ",
+    ],
+    "Danish": [
+        "e",
+        "r",
+        "n",
+        "t",
+        "a",
+        "i",
+        "s",
+        "d",
+        "l",
+        "o",
+        "g",
+        "m",
+        "k",
+        "f",
+        "v",
+        "u",
+        "b",
+        "h",
+        "p",
+        "å",
+        "y",
+        "ø",
+        "æ",
+        "c",
+        "j",
+        "w",
+    ],
+    "Serbian": [
+        "а",
+        "и",
+        "о",
+        "е",
+        "н",
+        "р",
+        "с",
+        "у",
+        "т",
+        "к",
+        "ј",
+        "в",
+        "д",
+        "м",
+        "п",
+        "л",
+        "г",
+        "з",
+        "б",
+        "a",
+        "i",
+        "e",
+        "o",
+        "n",
+        "ц",
+        "ш",
+    ],
+    "Lithuanian": [
+        "i",
+        "a",
+        "s",
+        "o",
+        "r",
+        "e",
+        "t",
+        "n",
+        "u",
+        "k",
+        "m",
+        "l",
+        "p",
+        "v",
+        "d",
+        "j",
+        "g",
+        "ė",
+        "b",
+        "y",
+        "ų",
+        "š",
+        "ž",
+        "c",
+        "ą",
+        "į",
+    ],
+    "Slovene": [
+        "e",
+        "a",
+        "i",
+        "o",
+        "n",
+        "r",
+        "s",
+        "l",
+        "t",
+        "j",
+        "v",
+        "k",
+        "d",
+        "p",
+        "m",
+        "u",
+        "z",
+        "b",
+        "g",
+        "h",
+        "č",
+        "c",
+        "š",
+        "ž",
+        "f",
+        "y",
+    ],
+    "Slovak": [
+        "o",
+        "a",
+        "e",
+        "n",
+        "i",
+        "r",
+        "v",
+        "t",
+        "s",
+        "l",
+        "k",
+        "d",
+        "m",
+        "p",
+        "u",
+        "c",
+        "h",
+        "j",
+        "b",
+        "z",
+        "á",
+        "y",
+        "ý",
+        "í",
+        "č",
+        "é",
+    ],
+    "Hebrew": [
+        "י",
+        "ו",
+        "ה",
+        "ל",
+        "ר",
+        "ב",
+        "ת",
+        "מ",
+        "א",
+        "ש",
+        "נ",
+        "ע",
+        "ם",
+        "ד",
+        "ק",
+        "ח",
+        "פ",
+        "ס",
+        "כ",
+        "ג",
+        "ט",
+        "צ",
+        "ן",
+        "ז",
+        "ך",
+    ],
+    "Bulgarian": [
+        "а",
+        "и",
+        "о",
+        "е",
+        "н",
+        "т",
+        "р",
+        "с",
+        "в",
+        "л",
+        "к",
+        "д",
+        "п",
+        "м",
+        "з",
+        "г",
+        "я",
+        "ъ",
+        "у",
+        "б",
+        "ч",
+        "ц",
+        "й",
+        "ж",
+        "щ",
+        "х",
+    ],
+    "Croatian": [
+        "a",
+        "i",
+        "o",
+        "e",
+        "n",
+        "r",
+        "j",
+        "s",
+        "t",
+        "u",
+        "k",
+        "l",
+        "v",
+        "d",
+        "m",
+        "p",
+        "g",
+        "z",
+        "b",
+        "c",
+        "č",
+        "h",
+        "š",
+        "ž",
+        "ć",
+        "f",
+    ],
+    "Hindi": [
+        "क",
+        "र",
+        "स",
+        "न",
+        "त",
+        "म",
+        "ह",
+        "प",
+        "य",
+        "ल",
+        "व",
+        "ज",
+        "द",
+        "ग",
+        "ब",
+        "श",
+        "ट",
+        "अ",
+        "ए",
+        "थ",
+        "भ",
+        "ड",
+        "च",
+        "ध",
+        "ष",
+        "इ",
+    ],
+    "Estonian": [
+        "a",
+        "i",
+        "e",
+        "s",
+        "t",
+        "l",
+        "u",
+        "n",
+        "o",
+        "k",
+        "r",
+        "d",
+        "m",
+        "v",
+        "g",
+        "p",
+        "j",
+        "h",
+        "ä",
+        "b",
+        "õ",
+        "ü",
+        "f",
+        "c",
+        "ö",
+        "y",
+    ],
+    "Thai": [
+        "า",
+        "น",
+        "ร",
+        "อ",
+        "ก",
+        "เ",
+        "ง",
+        "ม",
+        "ย",
+        "ล",
+        "ว",
+        "ด",
+        "ท",
+        "ส",
+        "ต",
+        "ะ",
+        "ป",
+        "บ",
+        "ค",
+        "ห",
+        "แ",
+        "จ",
+        "พ",
+        "ช",
+        "ข",
+        "ใ",
+    ],
+    "Greek": [
+        "α",
+        "τ",
+        "ο",
+        "ι",
+        "ε",
+        "ν",
+        "ρ",
+        "σ",
+        "κ",
+        "η",
+        "π",
+        "ς",
+        "υ",
+        "μ",
+        "λ",
+        "ί",
+        "ό",
+        "ά",
+        "γ",
+        "έ",
+        "δ",
+        "ή",
+        "ω",
+        "χ",
+        "θ",
+        "ύ",
+    ],
+    "Tamil": [
+        "க",
+        "த",
+        "ப",
+        "ட",
+        "ர",
+        "ம",
+        "ல",
+        "ன",
+        "வ",
+        "ற",
+        "ய",
+        "ள",
+        "ச",
+        "ந",
+        "இ",
+        "ண",
+        "அ",
+        "ஆ",
+        "ழ",
+        "ங",
+        "எ",
+        "உ",
+        "ஒ",
+        "ஸ",
+    ],
+    "Kazakh": [
+        "а",
+        "ы",
+        "е",
+        "н",
+        "т",
+        "р",
+        "л",
+        "і",
+        "д",
+        "с",
+        "м",
+        "қ",
+        "к",
+        "о",
+        "б",
+        "и",
+        "у",
+        "ғ",
+        "ж",
+        "ң",
+        "з",
+        "ш",
+        "й",
+        "п",
+        "г",
+        "ө",
+    ],
+}
+
+LANGUAGE_SUPPORTED_COUNT: int = len(FREQUENCIES)
diff --git a/lib/charset_normalizer/md.py b/lib/charset_normalizer/md.py
index 13aa062e..77897aae 100644
--- a/lib/charset_normalizer/md.py
+++ b/lib/charset_normalizer/md.py
@@ -9,7 +9,8 @@ from .constant import (
 )
 from .utils import (
     is_accentuated,
-    is_ascii,
+    is_arabic,
+    is_arabic_isolated_form,
     is_case_variable,
     is_cjk,
     is_emoticon,
@@ -128,8 +129,9 @@ class TooManyAccentuatedPlugin(MessDetectorPlugin):
 
     @property
     def ratio(self) -> float:
-        if self._character_count == 0 or self._character_count < 8:
+        if self._character_count < 8:
             return 0.0
+
         ratio_of_accentuation: float = self._accentuated_count / self._character_count
         return ratio_of_accentuation if ratio_of_accentuation >= 0.35 else 0.0
 
@@ -234,16 +236,13 @@ class SuspiciousRange(MessDetectorPlugin):
 
     @property
     def ratio(self) -> float:
-        if self._character_count == 0:
+        if self._character_count <= 24:
             return 0.0
 
         ratio_of_suspicious_range_usage: float = (
             self._suspicious_successive_range_count * 2
         ) / self._character_count
 
-        if ratio_of_suspicious_range_usage < 0.1:
-            return 0.0
-
         return ratio_of_suspicious_range_usage
 
 
@@ -296,7 +295,11 @@ class SuperWeirdWordPlugin(MessDetectorPlugin):
                     self._is_current_word_bad = True
                 # Word/Buffer ending with an upper case accentuated letter are so rare,
                 # that we will consider them all as suspicious. Same weight as foreign_long suspicious.
-                if is_accentuated(self._buffer[-1]) and self._buffer[-1].isupper():
+                if (
+                    is_accentuated(self._buffer[-1])
+                    and self._buffer[-1].isupper()
+                    and all(_.isupper() for _ in self._buffer) is False
+                ):
                     self._foreign_long_count += 1
                     self._is_current_word_bad = True
             if buffer_length >= 24 and self._foreign_long_watch:
@@ -419,7 +422,7 @@ class ArchaicUpperLowerPlugin(MessDetectorPlugin):
 
             return
 
-        if self._current_ascii_only is True and is_ascii(character) is False:
+        if self._current_ascii_only is True and character.isascii() is False:
             self._current_ascii_only = False
 
         if self._last_alpha_seen is not None:
@@ -455,6 +458,34 @@ class ArchaicUpperLowerPlugin(MessDetectorPlugin):
         return self._successive_upper_lower_count_final / self._character_count
 
 
+class ArabicIsolatedFormPlugin(MessDetectorPlugin):
+    def __init__(self) -> None:
+        self._character_count: int = 0
+        self._isolated_form_count: int = 0
+
+    def reset(self) -> None:  # pragma: no cover
+        self._character_count = 0
+        self._isolated_form_count = 0
+
+    def eligible(self, character: str) -> bool:
+        return is_arabic(character)
+
+    def feed(self, character: str) -> None:
+        self._character_count += 1
+
+        if is_arabic_isolated_form(character):
+            self._isolated_form_count += 1
+
+    @property
+    def ratio(self) -> float:
+        if self._character_count < 8:
+            return 0.0
+
+        isolated_form_usage: float = self._isolated_form_count / self._character_count
+
+        return isolated_form_usage
+
+
 @lru_cache(maxsize=1024)
 def is_suspiciously_successive_range(
     unicode_range_a: Optional[str], unicode_range_b: Optional[str]
@@ -522,6 +553,8 @@ def is_suspiciously_successive_range(
             return False
         if "Forms" in unicode_range_a or "Forms" in unicode_range_b:
             return False
+        if unicode_range_a == "Basic Latin" or unicode_range_b == "Basic Latin":
+            return False
 
     return True
 
diff --git a/lib/charset_normalizer/models.py b/lib/charset_normalizer/models.py
index 7f8ca389..a760b9c5 100644
--- a/lib/charset_normalizer/models.py
+++ b/lib/charset_normalizer/models.py
@@ -54,16 +54,19 @@ class CharsetMatch:
 
         # Below 1% difference --> Use Coherence
         if chaos_difference < 0.01 and coherence_difference > 0.02:
-            # When having a tough decision, use the result that decoded as many multi-byte as possible.
-            if chaos_difference == 0.0 and self.coherence == other.coherence:
-                return self.multi_byte_usage > other.multi_byte_usage
             return self.coherence > other.coherence
+        elif chaos_difference < 0.01 and coherence_difference <= 0.02:
+            # When having a difficult decision, use the result that decoded as many multi-byte as possible.
+            # preserve RAM usage!
+            if len(self._payload) >= TOO_BIG_SEQUENCE:
+                return self.chaos < other.chaos
+            return self.multi_byte_usage > other.multi_byte_usage
 
         return self.chaos < other.chaos
 
     @property
     def multi_byte_usage(self) -> float:
-        return 1.0 - len(str(self)) / len(self.raw)
+        return 1.0 - (len(str(self)) / len(self.raw))
 
     def __str__(self) -> str:
         # Lazy Str Loading
diff --git a/lib/charset_normalizer/utils.py b/lib/charset_normalizer/utils.py
index bf2767a0..e5cbbf4c 100644
--- a/lib/charset_normalizer/utils.py
+++ b/lib/charset_normalizer/utils.py
@@ -32,6 +32,8 @@ def is_accentuated(character: str) -> bool:
         or "WITH DIAERESIS" in description
         or "WITH CIRCUMFLEX" in description
         or "WITH TILDE" in description
+        or "WITH MACRON" in description
+        or "WITH RING ABOVE" in description
     )
 
 
@@ -69,15 +71,6 @@ def is_latin(character: str) -> bool:
     return "LATIN" in description
 
 
-@lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION)
-def is_ascii(character: str) -> bool:
-    try:
-        character.encode("ascii")
-    except UnicodeEncodeError:
-        return False
-    return True
-
-
 @lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION)
 def is_punctuation(character: str) -> bool:
     character_category: str = unicodedata.category(character)
@@ -105,7 +98,7 @@ def is_symbol(character: str) -> bool:
     if character_range is None:
         return False
 
-    return "Forms" in character_range
+    return "Forms" in character_range and character_category != "Lo"
 
 
 @lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION)
@@ -115,7 +108,7 @@ def is_emoticon(character: str) -> bool:
     if character_range is None:
         return False
 
-    return "Emoticons" in character_range
+    return "Emoticons" in character_range or "Pictographs" in character_range
 
 
 @lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION)
@@ -133,12 +126,6 @@ def is_case_variable(character: str) -> bool:
     return character.islower() != character.isupper()
 
 
-def is_private_use_only(character: str) -> bool:
-    character_category: str = unicodedata.category(character)
-
-    return character_category == "Co"
-
-
 @lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION)
 def is_cjk(character: str) -> bool:
     try:
@@ -189,6 +176,26 @@ def is_thai(character: str) -> bool:
     return "THAI" in character_name
 
 
+@lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION)
+def is_arabic(character: str) -> bool:
+    try:
+        character_name = unicodedata.name(character)
+    except ValueError:
+        return False
+
+    return "ARABIC" in character_name
+
+
+@lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION)
+def is_arabic_isolated_form(character: str) -> bool:
+    try:
+        character_name = unicodedata.name(character)
+    except ValueError:
+        return False
+
+    return "ARABIC" in character_name and "ISOLATED FORM" in character_name
+
+
 @lru_cache(maxsize=len(UNICODE_RANGES_COMBINED))
 def is_unicode_range_secondary(range_name: str) -> bool:
     return any(keyword in range_name for keyword in UNICODE_SECONDARY_RANGE_KEYWORD)
@@ -205,7 +212,7 @@ def is_unprintable(character: str) -> bool:
     )
 
 
-def any_specified_encoding(sequence: bytes, search_zone: int = 4096) -> Optional[str]:
+def any_specified_encoding(sequence: bytes, search_zone: int = 8192) -> Optional[str]:
     """
     Extract using ASCII-only decoder any specified encoding in the first n-bytes.
     """
diff --git a/lib/charset_normalizer/version.py b/lib/charset_normalizer/version.py
index 5eed49a4..5a4da4ff 100644
--- a/lib/charset_normalizer/version.py
+++ b/lib/charset_normalizer/version.py
@@ -2,5 +2,5 @@
 Expose version
 """
 
-__version__ = "3.2.0"
+__version__ = "3.3.2"
 VERSION = __version__.split(".")
diff --git a/lib/idna/codec.py b/lib/idna/codec.py
index 1ca9ba62..c855a4de 100644
--- a/lib/idna/codec.py
+++ b/lib/idna/codec.py
@@ -1,7 +1,7 @@
 from .core import encode, decode, alabel, ulabel, IDNAError
 import codecs
 import re
-from typing import Tuple, Optional
+from typing import Any, Tuple, Optional
 
 _unicode_dots_re = re.compile('[\u002e\u3002\uff0e\uff61]')
 
@@ -26,24 +26,24 @@ class Codec(codecs.Codec):
         return decode(data), len(data)
 
 class IncrementalEncoder(codecs.BufferedIncrementalEncoder):
-    def _buffer_encode(self, data: str, errors: str, final: bool) -> Tuple[str, int]:  # type: ignore
+    def _buffer_encode(self, data: str, errors: str, final: bool) -> Tuple[bytes, int]:
         if errors != 'strict':
             raise IDNAError('Unsupported error handling \"{}\"'.format(errors))
 
         if not data:
-            return "", 0
+            return b'', 0
 
         labels = _unicode_dots_re.split(data)
-        trailing_dot = ''
+        trailing_dot = b''
         if labels:
             if not labels[-1]:
-                trailing_dot = '.'
+                trailing_dot = b'.'
                 del labels[-1]
             elif not final:
                 # Keep potentially unfinished label until the next call
                 del labels[-1]
                 if labels:
-                    trailing_dot = '.'
+                    trailing_dot = b'.'
 
         result = []
         size = 0
@@ -54,18 +54,21 @@ class IncrementalEncoder(codecs.BufferedIncrementalEncoder):
             size += len(label)
 
         # Join with U+002E
-        result_str = '.'.join(result) + trailing_dot  # type: ignore
+        result_bytes = b'.'.join(result) + trailing_dot
         size += len(trailing_dot)
-        return result_str, size
+        return result_bytes, size
 
 class IncrementalDecoder(codecs.BufferedIncrementalDecoder):
-    def _buffer_decode(self, data: str, errors: str, final: bool) -> Tuple[str, int]:  # type: ignore
+    def _buffer_decode(self, data: Any, errors: str, final: bool) -> Tuple[str, int]:
         if errors != 'strict':
             raise IDNAError('Unsupported error handling \"{}\"'.format(errors))
 
         if not data:
             return ('', 0)
 
+        if not isinstance(data, str):
+            data = str(data, 'ascii')
+
         labels = _unicode_dots_re.split(data)
         trailing_dot = ''
         if labels:
@@ -99,14 +102,17 @@ class StreamReader(Codec, codecs.StreamReader):
     pass
 
 
-def getregentry() -> codecs.CodecInfo:
-    # Compatibility as a search_function for codecs.register()
+def search_function(name: str) -> Optional[codecs.CodecInfo]:
+    if name != 'idna2008':
+        return None
     return codecs.CodecInfo(
-        name='idna',
-        encode=Codec().encode,  # type: ignore
-        decode=Codec().decode,  # type: ignore
+        name=name,
+        encode=Codec().encode,
+        decode=Codec().decode,
         incrementalencoder=IncrementalEncoder,
         incrementaldecoder=IncrementalDecoder,
         streamwriter=StreamWriter,
         streamreader=StreamReader,
     )
+
+codecs.register(search_function)
diff --git a/lib/idna/core.py b/lib/idna/core.py
index 4f300371..aaf7d658 100644
--- a/lib/idna/core.py
+++ b/lib/idna/core.py
@@ -318,7 +318,7 @@ def uts46_remap(domain: str, std3_rules: bool = True, transitional: bool = False
             status = uts46row[1]
             replacement = None  # type: Optional[str]
             if len(uts46row) == 3:
-                replacement = uts46row[2]  # type: ignore
+                replacement = uts46row[2]
             if (status == 'V' or
                     (status == 'D' and not transitional) or
                     (status == '3' and not std3_rules and replacement is None)):
@@ -338,9 +338,9 @@ def uts46_remap(domain: str, std3_rules: bool = True, transitional: bool = False
 
 
 def encode(s: Union[str, bytes, bytearray], strict: bool = False, uts46: bool = False, std3_rules: bool = False, transitional: bool = False) -> bytes:
-    if isinstance(s, (bytes, bytearray)):
+    if not isinstance(s, str):
         try:
-            s = s.decode('ascii')
+            s = str(s, 'ascii')
         except UnicodeDecodeError:
             raise IDNAError('should pass a unicode string to the function rather than a byte string.')
     if uts46:
@@ -372,8 +372,8 @@ def encode(s: Union[str, bytes, bytearray], strict: bool = False, uts46: bool =
 
 def decode(s: Union[str, bytes, bytearray], strict: bool = False, uts46: bool = False, std3_rules: bool = False) -> str:
     try:
-        if isinstance(s, (bytes, bytearray)):
-            s = s.decode('ascii')
+        if not isinstance(s, str):
+            s = str(s, 'ascii')
     except UnicodeDecodeError:
         raise IDNAError('Invalid ASCII in A-label')
     if uts46:
diff --git a/lib/idna/idnadata.py b/lib/idna/idnadata.py
index 67db4625..5cd05d90 100644
--- a/lib/idna/idnadata.py
+++ b/lib/idna/idnadata.py
@@ -1,6 +1,6 @@
 # This file is automatically generated by tools/idna-data
 
-__version__ = '15.0.0'
+__version__ = '15.1.0'
 scripts = {
     'Greek': (
         0x37000000374,
@@ -59,6 +59,7 @@ scripts = {
         0x2b7400002b81e,
         0x2b8200002cea2,
         0x2ceb00002ebe1,
+        0x2ebf00002ee5e,
         0x2f8000002fa1e,
         0x300000003134b,
         0x31350000323b0,
@@ -1834,7 +1835,6 @@ codepoint_classes = {
         0xa7d50000a7d6,
         0xa7d70000a7d8,
         0xa7d90000a7da,
-        0xa7f20000a7f5,
         0xa7f60000a7f8,
         0xa7fa0000a828,
         0xa82c0000a82d,
@@ -1907,9 +1907,7 @@ codepoint_classes = {
         0x1060000010737,
         0x1074000010756,
         0x1076000010768,
-        0x1078000010786,
-        0x10787000107b1,
-        0x107b2000107bb,
+        0x1078000010781,
         0x1080000010806,
         0x1080800010809,
         0x1080a00010836,
@@ -2134,6 +2132,7 @@ codepoint_classes = {
         0x2b7400002b81e,
         0x2b8200002cea2,
         0x2ceb00002ebe1,
+        0x2ebf00002ee5e,
         0x300000003134b,
         0x31350000323b0,
     ),
diff --git a/lib/idna/package_data.py b/lib/idna/package_data.py
index 8501893b..c5b7220c 100644
--- a/lib/idna/package_data.py
+++ b/lib/idna/package_data.py
@@ -1,2 +1,2 @@
-__version__ = '3.4'
+__version__ = '3.6'
 
diff --git a/lib/idna/uts46data.py b/lib/idna/uts46data.py
index 186796c1..6a1eddbf 100644
--- a/lib/idna/uts46data.py
+++ b/lib/idna/uts46data.py
@@ -7,7 +7,7 @@ from typing import List, Tuple, Union
 """IDNA Mapping Table from UTS46."""
 
 
-__version__ = '15.0.0'
+__version__ = '15.1.0'
 def _seg_0() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
     (0x0, '3'),
@@ -1899,7 +1899,7 @@ def _seg_18() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x1E9A, 'M', 'aʾ'),
     (0x1E9B, 'M', 'ṡ'),
     (0x1E9C, 'V'),
-    (0x1E9E, 'M', 'ss'),
+    (0x1E9E, 'M', 'ß'),
     (0x1E9F, 'V'),
     (0x1EA0, 'M', 'ạ'),
     (0x1EA1, 'V'),
@@ -2418,10 +2418,6 @@ def _seg_23() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x222F, 'M', '∮∮'),
     (0x2230, 'M', '∮∮∮'),
     (0x2231, 'V'),
-    (0x2260, '3'),
-    (0x2261, 'V'),
-    (0x226E, '3'),
-    (0x2270, 'V'),
     (0x2329, 'M', '〈'),
     (0x232A, 'M', '〉'),
     (0x232B, 'V'),
@@ -2502,14 +2498,14 @@ def _seg_23() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x24BA, 'M', 'e'),
     (0x24BB, 'M', 'f'),
     (0x24BC, 'M', 'g'),
-    ]
-
-def _seg_24() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x24BD, 'M', 'h'),
     (0x24BE, 'M', 'i'),
     (0x24BF, 'M', 'j'),
     (0x24C0, 'M', 'k'),
+    ]
+
+def _seg_24() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x24C1, 'M', 'l'),
     (0x24C2, 'M', 'm'),
     (0x24C3, 'M', 'n'),
@@ -2606,14 +2602,14 @@ def _seg_24() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x2C26, 'M', 'ⱖ'),
     (0x2C27, 'M', 'ⱗ'),
     (0x2C28, 'M', 'ⱘ'),
-    ]
-
-def _seg_25() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x2C29, 'M', 'ⱙ'),
     (0x2C2A, 'M', 'ⱚ'),
     (0x2C2B, 'M', 'ⱛ'),
     (0x2C2C, 'M', 'ⱜ'),
+    ]
+
+def _seg_25() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x2C2D, 'M', 'ⱝ'),
     (0x2C2E, 'M', 'ⱞ'),
     (0x2C2F, 'M', 'ⱟ'),
@@ -2710,14 +2706,14 @@ def _seg_25() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x2CC0, 'M', 'ⳁ'),
     (0x2CC1, 'V'),
     (0x2CC2, 'M', 'ⳃ'),
-    ]
-
-def _seg_26() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x2CC3, 'V'),
     (0x2CC4, 'M', 'ⳅ'),
     (0x2CC5, 'V'),
     (0x2CC6, 'M', 'ⳇ'),
+    ]
+
+def _seg_26() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x2CC7, 'V'),
     (0x2CC8, 'M', 'ⳉ'),
     (0x2CC9, 'V'),
@@ -2814,14 +2810,14 @@ def _seg_26() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x2F13, 'M', '勹'),
     (0x2F14, 'M', '匕'),
     (0x2F15, 'M', '匚'),
-    ]
-
-def _seg_27() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x2F16, 'M', '匸'),
     (0x2F17, 'M', '十'),
     (0x2F18, 'M', '卜'),
     (0x2F19, 'M', '卩'),
+    ]
+
+def _seg_27() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x2F1A, 'M', '厂'),
     (0x2F1B, 'M', '厶'),
     (0x2F1C, 'M', '又'),
@@ -2918,14 +2914,14 @@ def _seg_27() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x2F77, 'M', '糸'),
     (0x2F78, 'M', '缶'),
     (0x2F79, 'M', '网'),
-    ]
-
-def _seg_28() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x2F7A, 'M', '羊'),
     (0x2F7B, 'M', '羽'),
     (0x2F7C, 'M', '老'),
     (0x2F7D, 'M', '而'),
+    ]
+
+def _seg_28() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x2F7E, 'M', '耒'),
     (0x2F7F, 'M', '耳'),
     (0x2F80, 'M', '聿'),
@@ -3022,14 +3018,14 @@ def _seg_28() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x3036, 'M', '〒'),
     (0x3037, 'V'),
     (0x3038, 'M', '十'),
-    ]
-
-def _seg_29() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x3039, 'M', '卄'),
     (0x303A, 'M', '卅'),
     (0x303B, 'V'),
     (0x3040, 'X'),
+    ]
+
+def _seg_29() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x3041, 'V'),
     (0x3097, 'X'),
     (0x3099, 'V'),
@@ -3126,14 +3122,14 @@ def _seg_29() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x3182, 'M', 'ᇱ'),
     (0x3183, 'M', 'ᇲ'),
     (0x3184, 'M', 'ᅗ'),
-    ]
-
-def _seg_30() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x3185, 'M', 'ᅘ'),
     (0x3186, 'M', 'ᅙ'),
     (0x3187, 'M', 'ᆄ'),
     (0x3188, 'M', 'ᆅ'),
+    ]
+
+def _seg_30() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x3189, 'M', 'ᆈ'),
     (0x318A, 'M', 'ᆑ'),
     (0x318B, 'M', 'ᆒ'),
@@ -3230,14 +3226,14 @@ def _seg_30() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x3244, 'M', '問'),
     (0x3245, 'M', '幼'),
     (0x3246, 'M', '文'),
-    ]
-
-def _seg_31() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x3247, 'M', '箏'),
     (0x3248, 'V'),
     (0x3250, 'M', 'pte'),
     (0x3251, 'M', '21'),
+    ]
+
+def _seg_31() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x3252, 'M', '22'),
     (0x3253, 'M', '23'),
     (0x3254, 'M', '24'),
@@ -3334,14 +3330,14 @@ def _seg_31() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x32AF, 'M', '協'),
     (0x32B0, 'M', '夜'),
     (0x32B1, 'M', '36'),
-    ]
-
-def _seg_32() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x32B2, 'M', '37'),
     (0x32B3, 'M', '38'),
     (0x32B4, 'M', '39'),
     (0x32B5, 'M', '40'),
+    ]
+
+def _seg_32() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x32B6, 'M', '41'),
     (0x32B7, 'M', '42'),
     (0x32B8, 'M', '43'),
@@ -3438,14 +3434,14 @@ def _seg_32() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x3313, 'M', 'ギルダー'),
     (0x3314, 'M', 'キロ'),
     (0x3315, 'M', 'キログラム'),
-    ]
-
-def _seg_33() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x3316, 'M', 'キロメートル'),
     (0x3317, 'M', 'キロワット'),
     (0x3318, 'M', 'グラム'),
     (0x3319, 'M', 'グラムトン'),
+    ]
+
+def _seg_33() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x331A, 'M', 'クルゼイロ'),
     (0x331B, 'M', 'クローネ'),
     (0x331C, 'M', 'ケース'),
@@ -3542,14 +3538,14 @@ def _seg_33() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x3377, 'M', 'dm'),
     (0x3378, 'M', 'dm2'),
     (0x3379, 'M', 'dm3'),
-    ]
-
-def _seg_34() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x337A, 'M', 'iu'),
     (0x337B, 'M', '平成'),
     (0x337C, 'M', '昭和'),
     (0x337D, 'M', '大正'),
+    ]
+
+def _seg_34() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x337E, 'M', '明治'),
     (0x337F, 'M', '株式会社'),
     (0x3380, 'M', 'pa'),
@@ -3646,14 +3642,14 @@ def _seg_34() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x33DB, 'M', 'sr'),
     (0x33DC, 'M', 'sv'),
     (0x33DD, 'M', 'wb'),
-    ]
-
-def _seg_35() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x33DE, 'M', 'v∕m'),
     (0x33DF, 'M', 'a∕m'),
     (0x33E0, 'M', '1日'),
     (0x33E1, 'M', '2日'),
+    ]
+
+def _seg_35() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x33E2, 'M', '3日'),
     (0x33E3, 'M', '4日'),
     (0x33E4, 'M', '5日'),
@@ -3750,14 +3746,14 @@ def _seg_35() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0xA68B, 'V'),
     (0xA68C, 'M', 'ꚍ'),
     (0xA68D, 'V'),
-    ]
-
-def _seg_36() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0xA68E, 'M', 'ꚏ'),
     (0xA68F, 'V'),
     (0xA690, 'M', 'ꚑ'),
     (0xA691, 'V'),
+    ]
+
+def _seg_36() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0xA692, 'M', 'ꚓ'),
     (0xA693, 'V'),
     (0xA694, 'M', 'ꚕ'),
@@ -3854,14 +3850,14 @@ def _seg_36() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0xA779, 'M', 'ꝺ'),
     (0xA77A, 'V'),
     (0xA77B, 'M', 'ꝼ'),
-    ]
-
-def _seg_37() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0xA77C, 'V'),
     (0xA77D, 'M', 'ᵹ'),
     (0xA77E, 'M', 'ꝿ'),
     (0xA77F, 'V'),
+    ]
+
+def _seg_37() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0xA780, 'M', 'ꞁ'),
     (0xA781, 'V'),
     (0xA782, 'M', 'ꞃ'),
@@ -3958,14 +3954,14 @@ def _seg_37() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0xA878, 'X'),
     (0xA880, 'V'),
     (0xA8C6, 'X'),
-    ]
-
-def _seg_38() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0xA8CE, 'V'),
     (0xA8DA, 'X'),
     (0xA8E0, 'V'),
     (0xA954, 'X'),
+    ]
+
+def _seg_38() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0xA95F, 'V'),
     (0xA97D, 'X'),
     (0xA980, 'V'),
@@ -4062,14 +4058,14 @@ def _seg_38() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0xABA8, 'M', 'Ꮨ'),
     (0xABA9, 'M', 'Ꮩ'),
     (0xABAA, 'M', 'Ꮪ'),
-    ]
-
-def _seg_39() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0xABAB, 'M', 'Ꮫ'),
     (0xABAC, 'M', 'Ꮬ'),
     (0xABAD, 'M', 'Ꮭ'),
     (0xABAE, 'M', 'Ꮮ'),
+    ]
+
+def _seg_39() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0xABAF, 'M', 'Ꮯ'),
     (0xABB0, 'M', 'Ꮰ'),
     (0xABB1, 'M', 'Ꮱ'),
@@ -4166,14 +4162,14 @@ def _seg_39() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0xF943, 'M', '弄'),
     (0xF944, 'M', '籠'),
     (0xF945, 'M', '聾'),
-    ]
-
-def _seg_40() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0xF946, 'M', '牢'),
     (0xF947, 'M', '磊'),
     (0xF948, 'M', '賂'),
     (0xF949, 'M', '雷'),
+    ]
+
+def _seg_40() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0xF94A, 'M', '壘'),
     (0xF94B, 'M', '屢'),
     (0xF94C, 'M', '樓'),
@@ -4270,14 +4266,14 @@ def _seg_40() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0xF9A7, 'M', '獵'),
     (0xF9A8, 'M', '令'),
     (0xF9A9, 'M', '囹'),
-    ]
-
-def _seg_41() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0xF9AA, 'M', '寧'),
     (0xF9AB, 'M', '嶺'),
     (0xF9AC, 'M', '怜'),
     (0xF9AD, 'M', '玲'),
+    ]
+
+def _seg_41() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0xF9AE, 'M', '瑩'),
     (0xF9AF, 'M', '羚'),
     (0xF9B0, 'M', '聆'),
@@ -4374,14 +4370,14 @@ def _seg_41() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0xFA0B, 'M', '廓'),
     (0xFA0C, 'M', '兀'),
     (0xFA0D, 'M', '嗀'),
-    ]
-
-def _seg_42() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0xFA0E, 'V'),
     (0xFA10, 'M', '塚'),
     (0xFA11, 'V'),
     (0xFA12, 'M', '晴'),
+    ]
+
+def _seg_42() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0xFA13, 'V'),
     (0xFA15, 'M', '凞'),
     (0xFA16, 'M', '猪'),
@@ -4478,14 +4474,14 @@ def _seg_42() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0xFA76, 'M', '勇'),
     (0xFA77, 'M', '勺'),
     (0xFA78, 'M', '喝'),
-    ]
-
-def _seg_43() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0xFA79, 'M', '啕'),
     (0xFA7A, 'M', '喙'),
     (0xFA7B, 'M', '嗢'),
     (0xFA7C, 'M', '塚'),
+    ]
+
+def _seg_43() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0xFA7D, 'M', '墳'),
     (0xFA7E, 'M', '奄'),
     (0xFA7F, 'M', '奔'),
@@ -4582,14 +4578,14 @@ def _seg_43() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0xFADA, 'X'),
     (0xFB00, 'M', 'ff'),
     (0xFB01, 'M', 'fi'),
-    ]
-
-def _seg_44() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0xFB02, 'M', 'fl'),
     (0xFB03, 'M', 'ffi'),
     (0xFB04, 'M', 'ffl'),
     (0xFB05, 'M', 'st'),
+    ]
+
+def _seg_44() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0xFB07, 'X'),
     (0xFB13, 'M', 'մն'),
     (0xFB14, 'M', 'մե'),
@@ -4686,14 +4682,14 @@ def _seg_44() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0xFBDB, 'M', 'ۈ'),
     (0xFBDD, 'M', 'ۇٴ'),
     (0xFBDE, 'M', 'ۋ'),
-    ]
-
-def _seg_45() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0xFBE0, 'M', 'ۅ'),
     (0xFBE2, 'M', 'ۉ'),
     (0xFBE4, 'M', 'ې'),
     (0xFBE8, 'M', 'ى'),
+    ]
+
+def _seg_45() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0xFBEA, 'M', 'ئا'),
     (0xFBEC, 'M', 'ئە'),
     (0xFBEE, 'M', 'ئو'),
@@ -4790,14 +4786,14 @@ def _seg_45() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0xFC54, 'M', 'هي'),
     (0xFC55, 'M', 'يج'),
     (0xFC56, 'M', 'يح'),
-    ]
-
-def _seg_46() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0xFC57, 'M', 'يخ'),
     (0xFC58, 'M', 'يم'),
     (0xFC59, 'M', 'يى'),
     (0xFC5A, 'M', 'يي'),
+    ]
+
+def _seg_46() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0xFC5B, 'M', 'ذٰ'),
     (0xFC5C, 'M', 'رٰ'),
     (0xFC5D, 'M', 'ىٰ'),
@@ -4894,14 +4890,14 @@ def _seg_46() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0xFCB8, 'M', 'طح'),
     (0xFCB9, 'M', 'ظم'),
     (0xFCBA, 'M', 'عج'),
-    ]
-
-def _seg_47() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0xFCBB, 'M', 'عم'),
     (0xFCBC, 'M', 'غج'),
     (0xFCBD, 'M', 'غم'),
     (0xFCBE, 'M', 'فج'),
+    ]
+
+def _seg_47() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0xFCBF, 'M', 'فح'),
     (0xFCC0, 'M', 'فخ'),
     (0xFCC1, 'M', 'فم'),
@@ -4998,14 +4994,14 @@ def _seg_47() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0xFD1C, 'M', 'حي'),
     (0xFD1D, 'M', 'جى'),
     (0xFD1E, 'M', 'جي'),
-    ]
-
-def _seg_48() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0xFD1F, 'M', 'خى'),
     (0xFD20, 'M', 'خي'),
     (0xFD21, 'M', 'صى'),
     (0xFD22, 'M', 'صي'),
+    ]
+
+def _seg_48() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0xFD23, 'M', 'ضى'),
     (0xFD24, 'M', 'ضي'),
     (0xFD25, 'M', 'شج'),
@@ -5102,14 +5098,14 @@ def _seg_48() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0xFDA4, 'M', 'تمى'),
     (0xFDA5, 'M', 'جمي'),
     (0xFDA6, 'M', 'جحى'),
-    ]
-
-def _seg_49() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0xFDA7, 'M', 'جمى'),
     (0xFDA8, 'M', 'سخى'),
     (0xFDA9, 'M', 'صحي'),
     (0xFDAA, 'M', 'شحي'),
+    ]
+
+def _seg_49() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0xFDAB, 'M', 'ضحي'),
     (0xFDAC, 'M', 'لجي'),
     (0xFDAD, 'M', 'لمي'),
@@ -5206,14 +5202,14 @@ def _seg_49() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0xFE5B, '3', '{'),
     (0xFE5C, '3', '}'),
     (0xFE5D, 'M', '〔'),
-    ]
-
-def _seg_50() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0xFE5E, 'M', '〕'),
     (0xFE5F, '3', '#'),
     (0xFE60, '3', '&'),
     (0xFE61, '3', '*'),
+    ]
+
+def _seg_50() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0xFE62, '3', '+'),
     (0xFE63, 'M', '-'),
     (0xFE64, '3', '<'),
@@ -5310,14 +5306,14 @@ def _seg_50() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0xFF18, 'M', '8'),
     (0xFF19, 'M', '9'),
     (0xFF1A, '3', ':'),
-    ]
-
-def _seg_51() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0xFF1B, '3', ';'),
     (0xFF1C, '3', '<'),
     (0xFF1D, '3', '='),
     (0xFF1E, '3', '>'),
+    ]
+
+def _seg_51() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0xFF1F, '3', '?'),
     (0xFF20, '3', '@'),
     (0xFF21, 'M', 'a'),
@@ -5414,14 +5410,14 @@ def _seg_51() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0xFF7C, 'M', 'シ'),
     (0xFF7D, 'M', 'ス'),
     (0xFF7E, 'M', 'セ'),
-    ]
-
-def _seg_52() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0xFF7F, 'M', 'ソ'),
     (0xFF80, 'M', 'タ'),
     (0xFF81, 'M', 'チ'),
     (0xFF82, 'M', 'ツ'),
+    ]
+
+def _seg_52() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0xFF83, 'M', 'テ'),
     (0xFF84, 'M', 'ト'),
     (0xFF85, 'M', 'ナ'),
@@ -5518,14 +5514,14 @@ def _seg_52() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0xFFE7, 'X'),
     (0xFFE8, 'M', '│'),
     (0xFFE9, 'M', '←'),
-    ]
-
-def _seg_53() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0xFFEA, 'M', '↑'),
     (0xFFEB, 'M', '→'),
     (0xFFEC, 'M', '↓'),
     (0xFFED, 'M', '■'),
+    ]
+
+def _seg_53() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0xFFEE, 'M', '○'),
     (0xFFEF, 'X'),
     (0x10000, 'V'),
@@ -5622,14 +5618,14 @@ def _seg_53() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x104B3, 'M', '𐓛'),
     (0x104B4, 'M', '𐓜'),
     (0x104B5, 'M', '𐓝'),
-    ]
-
-def _seg_54() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x104B6, 'M', '𐓞'),
     (0x104B7, 'M', '𐓟'),
     (0x104B8, 'M', '𐓠'),
     (0x104B9, 'M', '𐓡'),
+    ]
+
+def _seg_54() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x104BA, 'M', '𐓢'),
     (0x104BB, 'M', '𐓣'),
     (0x104BC, 'M', '𐓤'),
@@ -5726,14 +5722,14 @@ def _seg_54() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x10786, 'X'),
     (0x10787, 'M', 'ʣ'),
     (0x10788, 'M', 'ꭦ'),
-    ]
-
-def _seg_55() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x10789, 'M', 'ʥ'),
     (0x1078A, 'M', 'ʤ'),
     (0x1078B, 'M', 'ɖ'),
     (0x1078C, 'M', 'ɗ'),
+    ]
+
+def _seg_55() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x1078D, 'M', 'ᶑ'),
     (0x1078E, 'M', 'ɘ'),
     (0x1078F, 'M', 'ɞ'),
@@ -5830,14 +5826,14 @@ def _seg_55() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x10A60, 'V'),
     (0x10AA0, 'X'),
     (0x10AC0, 'V'),
-    ]
-
-def _seg_56() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x10AE7, 'X'),
     (0x10AEB, 'V'),
     (0x10AF7, 'X'),
     (0x10B00, 'V'),
+    ]
+
+def _seg_56() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x10B36, 'X'),
     (0x10B39, 'V'),
     (0x10B56, 'X'),
@@ -5934,14 +5930,14 @@ def _seg_56() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x1107F, 'V'),
     (0x110BD, 'X'),
     (0x110BE, 'V'),
-    ]
-
-def _seg_57() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x110C3, 'X'),
     (0x110D0, 'V'),
     (0x110E9, 'X'),
     (0x110F0, 'V'),
+    ]
+
+def _seg_57() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x110FA, 'X'),
     (0x11100, 'V'),
     (0x11135, 'X'),
@@ -6038,14 +6034,14 @@ def _seg_57() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x118A4, 'M', '𑣄'),
     (0x118A5, 'M', '𑣅'),
     (0x118A6, 'M', '𑣆'),
-    ]
-
-def _seg_58() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x118A7, 'M', '𑣇'),
     (0x118A8, 'M', '𑣈'),
     (0x118A9, 'M', '𑣉'),
     (0x118AA, 'M', '𑣊'),
+    ]
+
+def _seg_58() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x118AB, 'M', '𑣋'),
     (0x118AC, 'M', '𑣌'),
     (0x118AD, 'M', '𑣍'),
@@ -6142,14 +6138,14 @@ def _seg_58() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x11EE0, 'V'),
     (0x11EF9, 'X'),
     (0x11F00, 'V'),
-    ]
-
-def _seg_59() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x11F11, 'X'),
     (0x11F12, 'V'),
     (0x11F3B, 'X'),
     (0x11F3E, 'V'),
+    ]
+
+def _seg_59() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x11F5A, 'X'),
     (0x11FB0, 'V'),
     (0x11FB1, 'X'),
@@ -6246,14 +6242,14 @@ def _seg_59() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x18D00, 'V'),
     (0x18D09, 'X'),
     (0x1AFF0, 'V'),
-    ]
-
-def _seg_60() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x1AFF4, 'X'),
     (0x1AFF5, 'V'),
     (0x1AFFC, 'X'),
     (0x1AFFD, 'V'),
+    ]
+
+def _seg_60() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x1AFFF, 'X'),
     (0x1B000, 'V'),
     (0x1B123, 'X'),
@@ -6350,14 +6346,14 @@ def _seg_60() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x1D41E, 'M', 'e'),
     (0x1D41F, 'M', 'f'),
     (0x1D420, 'M', 'g'),
-    ]
-
-def _seg_61() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x1D421, 'M', 'h'),
     (0x1D422, 'M', 'i'),
     (0x1D423, 'M', 'j'),
     (0x1D424, 'M', 'k'),
+    ]
+
+def _seg_61() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x1D425, 'M', 'l'),
     (0x1D426, 'M', 'm'),
     (0x1D427, 'M', 'n'),
@@ -6454,14 +6450,14 @@ def _seg_61() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x1D482, 'M', 'a'),
     (0x1D483, 'M', 'b'),
     (0x1D484, 'M', 'c'),
-    ]
-
-def _seg_62() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x1D485, 'M', 'd'),
     (0x1D486, 'M', 'e'),
     (0x1D487, 'M', 'f'),
     (0x1D488, 'M', 'g'),
+    ]
+
+def _seg_62() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x1D489, 'M', 'h'),
     (0x1D48A, 'M', 'i'),
     (0x1D48B, 'M', 'j'),
@@ -6558,14 +6554,14 @@ def _seg_62() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x1D4E9, 'M', 'z'),
     (0x1D4EA, 'M', 'a'),
     (0x1D4EB, 'M', 'b'),
-    ]
-
-def _seg_63() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x1D4EC, 'M', 'c'),
     (0x1D4ED, 'M', 'd'),
     (0x1D4EE, 'M', 'e'),
     (0x1D4EF, 'M', 'f'),
+    ]
+
+def _seg_63() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x1D4F0, 'M', 'g'),
     (0x1D4F1, 'M', 'h'),
     (0x1D4F2, 'M', 'i'),
@@ -6662,14 +6658,14 @@ def _seg_63() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x1D550, 'M', 'y'),
     (0x1D551, 'X'),
     (0x1D552, 'M', 'a'),
-    ]
-
-def _seg_64() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x1D553, 'M', 'b'),
     (0x1D554, 'M', 'c'),
     (0x1D555, 'M', 'd'),
     (0x1D556, 'M', 'e'),
+    ]
+
+def _seg_64() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x1D557, 'M', 'f'),
     (0x1D558, 'M', 'g'),
     (0x1D559, 'M', 'h'),
@@ -6766,14 +6762,14 @@ def _seg_64() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x1D5B4, 'M', 'u'),
     (0x1D5B5, 'M', 'v'),
     (0x1D5B6, 'M', 'w'),
-    ]
-
-def _seg_65() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x1D5B7, 'M', 'x'),
     (0x1D5B8, 'M', 'y'),
     (0x1D5B9, 'M', 'z'),
     (0x1D5BA, 'M', 'a'),
+    ]
+
+def _seg_65() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x1D5BB, 'M', 'b'),
     (0x1D5BC, 'M', 'c'),
     (0x1D5BD, 'M', 'd'),
@@ -6870,14 +6866,14 @@ def _seg_65() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x1D618, 'M', 'q'),
     (0x1D619, 'M', 'r'),
     (0x1D61A, 'M', 's'),
-    ]
-
-def _seg_66() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x1D61B, 'M', 't'),
     (0x1D61C, 'M', 'u'),
     (0x1D61D, 'M', 'v'),
     (0x1D61E, 'M', 'w'),
+    ]
+
+def _seg_66() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x1D61F, 'M', 'x'),
     (0x1D620, 'M', 'y'),
     (0x1D621, 'M', 'z'),
@@ -6974,14 +6970,14 @@ def _seg_66() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x1D67C, 'M', 'm'),
     (0x1D67D, 'M', 'n'),
     (0x1D67E, 'M', 'o'),
-    ]
-
-def _seg_67() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x1D67F, 'M', 'p'),
     (0x1D680, 'M', 'q'),
     (0x1D681, 'M', 'r'),
     (0x1D682, 'M', 's'),
+    ]
+
+def _seg_67() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x1D683, 'M', 't'),
     (0x1D684, 'M', 'u'),
     (0x1D685, 'M', 'v'),
@@ -7078,14 +7074,14 @@ def _seg_67() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x1D6E2, 'M', 'α'),
     (0x1D6E3, 'M', 'β'),
     (0x1D6E4, 'M', 'γ'),
-    ]
-
-def _seg_68() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x1D6E5, 'M', 'δ'),
     (0x1D6E6, 'M', 'ε'),
     (0x1D6E7, 'M', 'ζ'),
     (0x1D6E8, 'M', 'η'),
+    ]
+
+def _seg_68() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x1D6E9, 'M', 'θ'),
     (0x1D6EA, 'M', 'ι'),
     (0x1D6EB, 'M', 'κ'),
@@ -7182,14 +7178,14 @@ def _seg_68() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x1D747, 'M', 'σ'),
     (0x1D749, 'M', 'τ'),
     (0x1D74A, 'M', 'υ'),
-    ]
-
-def _seg_69() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x1D74B, 'M', 'φ'),
     (0x1D74C, 'M', 'χ'),
     (0x1D74D, 'M', 'ψ'),
     (0x1D74E, 'M', 'ω'),
+    ]
+
+def _seg_69() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x1D74F, 'M', '∂'),
     (0x1D750, 'M', 'ε'),
     (0x1D751, 'M', 'θ'),
@@ -7286,14 +7282,14 @@ def _seg_69() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x1D7AD, 'M', 'δ'),
     (0x1D7AE, 'M', 'ε'),
     (0x1D7AF, 'M', 'ζ'),
-    ]
-
-def _seg_70() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x1D7B0, 'M', 'η'),
     (0x1D7B1, 'M', 'θ'),
     (0x1D7B2, 'M', 'ι'),
     (0x1D7B3, 'M', 'κ'),
+    ]
+
+def _seg_70() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x1D7B4, 'M', 'λ'),
     (0x1D7B5, 'M', 'μ'),
     (0x1D7B6, 'M', 'ν'),
@@ -7390,14 +7386,14 @@ def _seg_70() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x1E030, 'M', 'а'),
     (0x1E031, 'M', 'б'),
     (0x1E032, 'M', 'в'),
-    ]
-
-def _seg_71() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x1E033, 'M', 'г'),
     (0x1E034, 'M', 'д'),
     (0x1E035, 'M', 'е'),
     (0x1E036, 'M', 'ж'),
+    ]
+
+def _seg_71() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x1E037, 'M', 'з'),
     (0x1E038, 'M', 'и'),
     (0x1E039, 'M', 'к'),
@@ -7494,14 +7490,14 @@ def _seg_71() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x1E907, 'M', '𞤩'),
     (0x1E908, 'M', '𞤪'),
     (0x1E909, 'M', '𞤫'),
-    ]
-
-def _seg_72() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x1E90A, 'M', '𞤬'),
     (0x1E90B, 'M', '𞤭'),
     (0x1E90C, 'M', '𞤮'),
     (0x1E90D, 'M', '𞤯'),
+    ]
+
+def _seg_72() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x1E90E, 'M', '𞤰'),
     (0x1E90F, 'M', '𞤱'),
     (0x1E910, 'M', '𞤲'),
@@ -7598,14 +7594,14 @@ def _seg_72() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x1EE48, 'X'),
     (0x1EE49, 'M', 'ي'),
     (0x1EE4A, 'X'),
-    ]
-
-def _seg_73() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x1EE4B, 'M', 'ل'),
     (0x1EE4C, 'X'),
     (0x1EE4D, 'M', 'ن'),
     (0x1EE4E, 'M', 'س'),
+    ]
+
+def _seg_73() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x1EE4F, 'M', 'ع'),
     (0x1EE50, 'X'),
     (0x1EE51, 'M', 'ص'),
@@ -7702,14 +7698,14 @@ def _seg_73() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x1EEB2, 'M', 'ق'),
     (0x1EEB3, 'M', 'ر'),
     (0x1EEB4, 'M', 'ش'),
-    ]
-
-def _seg_74() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x1EEB5, 'M', 'ت'),
     (0x1EEB6, 'M', 'ث'),
     (0x1EEB7, 'M', 'خ'),
     (0x1EEB8, 'M', 'ذ'),
+    ]
+
+def _seg_74() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x1EEB9, 'M', 'ض'),
     (0x1EEBA, 'M', 'ظ'),
     (0x1EEBB, 'M', 'غ'),
@@ -7806,14 +7802,14 @@ def _seg_74() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x1F150, 'V'),
     (0x1F16A, 'M', 'mc'),
     (0x1F16B, 'M', 'md'),
-    ]
-
-def _seg_75() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x1F16C, 'M', 'mr'),
     (0x1F16D, 'V'),
     (0x1F190, 'M', 'dj'),
     (0x1F191, 'V'),
+    ]
+
+def _seg_75() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x1F1AE, 'X'),
     (0x1F1E6, 'V'),
     (0x1F200, 'M', 'ほか'),
@@ -7910,14 +7906,14 @@ def _seg_75() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x1FA54, 'X'),
     (0x1FA60, 'V'),
     (0x1FA6E, 'X'),
-    ]
-
-def _seg_76() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
-    return [
     (0x1FA70, 'V'),
     (0x1FA7D, 'X'),
     (0x1FA80, 'V'),
     (0x1FA89, 'X'),
+    ]
+
+def _seg_76() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
+    return [
     (0x1FA90, 'V'),
     (0x1FABE, 'X'),
     (0x1FABF, 'V'),
@@ -7953,6 +7949,8 @@ def _seg_76() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x2CEA2, 'X'),
     (0x2CEB0, 'V'),
     (0x2EBE1, 'X'),
+    (0x2EBF0, 'V'),
+    (0x2EE5E, 'X'),
     (0x2F800, 'M', '丽'),
     (0x2F801, 'M', '丸'),
     (0x2F802, 'M', '乁'),
@@ -8014,12 +8012,12 @@ def _seg_76() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x2F83C, 'M', '咞'),
     (0x2F83D, 'M', '吸'),
     (0x2F83E, 'M', '呈'),
+    (0x2F83F, 'M', '周'),
+    (0x2F840, 'M', '咢'),
     ]
 
 def _seg_77() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x2F83F, 'M', '周'),
-    (0x2F840, 'M', '咢'),
     (0x2F841, 'M', '哶'),
     (0x2F842, 'M', '唐'),
     (0x2F843, 'M', '啓'),
@@ -8118,12 +8116,12 @@ def _seg_77() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x2F8A4, 'M', '𢛔'),
     (0x2F8A5, 'M', '惇'),
     (0x2F8A6, 'M', '慈'),
+    (0x2F8A7, 'M', '慌'),
+    (0x2F8A8, 'M', '慎'),
     ]
 
 def _seg_78() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x2F8A7, 'M', '慌'),
-    (0x2F8A8, 'M', '慎'),
     (0x2F8A9, 'M', '慌'),
     (0x2F8AA, 'M', '慺'),
     (0x2F8AB, 'M', '憎'),
@@ -8222,12 +8220,12 @@ def _seg_78() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x2F908, 'M', '港'),
     (0x2F909, 'M', '湮'),
     (0x2F90A, 'M', '㴳'),
+    (0x2F90B, 'M', '滋'),
+    (0x2F90C, 'M', '滇'),
     ]
 
 def _seg_79() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x2F90B, 'M', '滋'),
-    (0x2F90C, 'M', '滇'),
     (0x2F90D, 'M', '𣻑'),
     (0x2F90E, 'M', '淹'),
     (0x2F90F, 'M', '潮'),
@@ -8326,12 +8324,12 @@ def _seg_79() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x2F96F, 'M', '縂'),
     (0x2F970, 'M', '繅'),
     (0x2F971, 'M', '䌴'),
+    (0x2F972, 'M', '𦈨'),
+    (0x2F973, 'M', '𦉇'),
     ]
 
 def _seg_80() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x2F972, 'M', '𦈨'),
-    (0x2F973, 'M', '𦉇'),
     (0x2F974, 'M', '䍙'),
     (0x2F975, 'M', '𦋙'),
     (0x2F976, 'M', '罺'),
@@ -8430,12 +8428,12 @@ def _seg_80() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     (0x2F9D3, 'M', '𧲨'),
     (0x2F9D4, 'M', '貫'),
     (0x2F9D5, 'M', '賁'),
+    (0x2F9D6, 'M', '贛'),
+    (0x2F9D7, 'M', '起'),
     ]
 
 def _seg_81() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x2F9D6, 'M', '贛'),
-    (0x2F9D7, 'M', '起'),
     (0x2F9D8, 'M', '𧼯'),
     (0x2F9D9, 'M', '𠠄'),
     (0x2F9DA, 'M', '跋'),
diff --git a/lib/oauthlib/__init__.py b/lib/oauthlib/__init__.py
index 5dbffc96..d9a5e38e 100644
--- a/lib/oauthlib/__init__.py
+++ b/lib/oauthlib/__init__.py
@@ -12,7 +12,7 @@ import logging
 from logging import NullHandler
 
 __author__ = 'The OAuthlib Community'
-__version__ = '3.2.0'
+__version__ = '3.2.2'
 
 logging.getLogger('oauthlib').addHandler(NullHandler())
 
diff --git a/lib/oauthlib/common.py b/lib/oauthlib/common.py
index b5fbf52e..395e75ef 100644
--- a/lib/oauthlib/common.py
+++ b/lib/oauthlib/common.py
@@ -18,11 +18,9 @@ from urllib.parse import (
 from . import get_debug
 
 try:
-    from secrets import randbits
-    from secrets import SystemRandom
+    from secrets import SystemRandom, randbits
 except ImportError:
-    from random import getrandbits as randbits
-    from random import SystemRandom
+    from random import SystemRandom, getrandbits as randbits
 
 UNICODE_ASCII_CHARACTER_SET = ('abcdefghijklmnopqrstuvwxyz'
                                'ABCDEFGHIJKLMNOPQRSTUVWXYZ'
diff --git a/lib/oauthlib/oauth1/__init__.py b/lib/oauthlib/oauth1/__init__.py
index 07ef4226..9caf12a9 100644
--- a/lib/oauthlib/oauth1/__init__.py
+++ b/lib/oauthlib/oauth1/__init__.py
@@ -5,24 +5,19 @@ oauthlib.oauth1
 This module is a wrapper for the most recent implementation of OAuth 1.0 Client
 and Server classes.
 """
-from .rfc5849 import Client
-from .rfc5849 import (SIGNATURE_HMAC,
-                      SIGNATURE_HMAC_SHA1,
-                      SIGNATURE_HMAC_SHA256,
-                      SIGNATURE_HMAC_SHA512,
-                      SIGNATURE_RSA,
-                      SIGNATURE_RSA_SHA1,
-                      SIGNATURE_RSA_SHA256,
-                      SIGNATURE_RSA_SHA512,
-                      SIGNATURE_PLAINTEXT)
-from .rfc5849 import SIGNATURE_TYPE_AUTH_HEADER, SIGNATURE_TYPE_QUERY
-from .rfc5849 import SIGNATURE_TYPE_BODY
+from .rfc5849 import (
+    SIGNATURE_HMAC, SIGNATURE_HMAC_SHA1, SIGNATURE_HMAC_SHA256,
+    SIGNATURE_HMAC_SHA512, SIGNATURE_PLAINTEXT, SIGNATURE_RSA,
+    SIGNATURE_RSA_SHA1, SIGNATURE_RSA_SHA256, SIGNATURE_RSA_SHA512,
+    SIGNATURE_TYPE_AUTH_HEADER, SIGNATURE_TYPE_BODY, SIGNATURE_TYPE_QUERY,
+    Client,
+)
+from .rfc5849.endpoints import (
+    AccessTokenEndpoint, AuthorizationEndpoint, RequestTokenEndpoint,
+    ResourceEndpoint, SignatureOnlyEndpoint, WebApplicationServer,
+)
+from .rfc5849.errors import (
+    InsecureTransportError, InvalidClientError, InvalidRequestError,
+    InvalidSignatureMethodError, OAuth1Error,
+)
 from .rfc5849.request_validator import RequestValidator
-from .rfc5849.endpoints import RequestTokenEndpoint, AuthorizationEndpoint
-from .rfc5849.endpoints import AccessTokenEndpoint, ResourceEndpoint
-from .rfc5849.endpoints import SignatureOnlyEndpoint, WebApplicationServer
-from .rfc5849.errors import (InsecureTransportError,
-                             InvalidClientError,
-                             InvalidRequestError,
-                             InvalidSignatureMethodError,
-                             OAuth1Error)
diff --git a/lib/oauthlib/oauth1/rfc5849/endpoints/base.py b/lib/oauthlib/oauth1/rfc5849/endpoints/base.py
index 3a8c2677..7831be7c 100644
--- a/lib/oauthlib/oauth1/rfc5849/endpoints/base.py
+++ b/lib/oauthlib/oauth1/rfc5849/endpoints/base.py
@@ -11,12 +11,11 @@ import time
 from oauthlib.common import CaseInsensitiveDict, Request, generate_token
 
 from .. import (
-    CONTENT_TYPE_FORM_URLENCODED,
-    SIGNATURE_HMAC_SHA1, SIGNATURE_HMAC_SHA256, SIGNATURE_HMAC_SHA512,
-    SIGNATURE_RSA_SHA1, SIGNATURE_RSA_SHA256, SIGNATURE_RSA_SHA512,
-    SIGNATURE_PLAINTEXT,
-    SIGNATURE_TYPE_AUTH_HEADER, SIGNATURE_TYPE_BODY,
-    SIGNATURE_TYPE_QUERY, errors, signature, utils)
+    CONTENT_TYPE_FORM_URLENCODED, SIGNATURE_HMAC_SHA1, SIGNATURE_HMAC_SHA256,
+    SIGNATURE_HMAC_SHA512, SIGNATURE_PLAINTEXT, SIGNATURE_RSA_SHA1,
+    SIGNATURE_RSA_SHA256, SIGNATURE_RSA_SHA512, SIGNATURE_TYPE_AUTH_HEADER,
+    SIGNATURE_TYPE_BODY, SIGNATURE_TYPE_QUERY, errors, signature, utils,
+)
 
 
 class BaseEndpoint:
diff --git a/lib/oauthlib/oauth1/rfc5849/endpoints/request_token.py b/lib/oauthlib/oauth1/rfc5849/endpoints/request_token.py
index bb67e71e..0323cfb8 100644
--- a/lib/oauthlib/oauth1/rfc5849/endpoints/request_token.py
+++ b/lib/oauthlib/oauth1/rfc5849/endpoints/request_token.py
@@ -152,7 +152,7 @@ class RequestTokenEndpoint(BaseEndpoint):
             request.client_key = self.request_validator.dummy_client
 
         # Note that `realm`_ is only used in authorization headers and how
-        # it should be interepreted is not included in the OAuth spec.
+        # it should be interpreted is not included in the OAuth spec.
         # However they could be seen as a scope or realm to which the
         # client has access and as such every client should be checked
         # to ensure it is authorized access to that scope or realm.
@@ -164,7 +164,7 @@ class RequestTokenEndpoint(BaseEndpoint):
         # workflow where a client requests access to a specific realm.
         # This first step (obtaining request token) need not require a realm
         # and can then be identified by checking the require_resource_owner
-        # flag and abscence of realm.
+        # flag and absence of realm.
         #
         # Clients obtaining an access token will not supply a realm and it will
         # not be checked. Instead the previously requested realm should be
diff --git a/lib/oauthlib/oauth1/rfc5849/endpoints/resource.py b/lib/oauthlib/oauth1/rfc5849/endpoints/resource.py
index 45bdaaac..8641152e 100644
--- a/lib/oauthlib/oauth1/rfc5849/endpoints/resource.py
+++ b/lib/oauthlib/oauth1/rfc5849/endpoints/resource.py
@@ -113,7 +113,7 @@ class ResourceEndpoint(BaseEndpoint):
             request.resource_owner_key = self.request_validator.dummy_access_token
 
         # Note that `realm`_ is only used in authorization headers and how
-        # it should be interepreted is not included in the OAuth spec.
+        # it should be interpreted is not included in the OAuth spec.
         # However they could be seen as a scope or realm to which the
         # client has access and as such every client should be checked
         # to ensure it is authorized access to that scope or realm.
@@ -125,7 +125,7 @@ class ResourceEndpoint(BaseEndpoint):
         # workflow where a client requests access to a specific realm.
         # This first step (obtaining request token) need not require a realm
         # and can then be identified by checking the require_resource_owner
-        # flag and abscence of realm.
+        # flag and absence of realm.
         #
         # Clients obtaining an access token will not supply a realm and it will
         # not be checked. Instead the previously requested realm should be
diff --git a/lib/oauthlib/oauth1/rfc5849/request_validator.py b/lib/oauthlib/oauth1/rfc5849/request_validator.py
index dc5bf0eb..e937aabf 100644
--- a/lib/oauthlib/oauth1/rfc5849/request_validator.py
+++ b/lib/oauthlib/oauth1/rfc5849/request_validator.py
@@ -19,7 +19,7 @@ class RequestValidator:
     Methods used to check the format of input parameters. Common tests include
     length, character set, membership, range or pattern. These tests are
     referred to as `whitelisting or blacklisting`_. Whitelisting is better
-    but blacklisting can be usefull to spot malicious activity.
+    but blacklisting can be useful to spot malicious activity.
     The following have methods a default implementation:
 
     - check_client_key
@@ -443,7 +443,7 @@ class RequestValidator:
         :type request: oauthlib.common.Request
         :returns: None
 
-        Per `Section 2.3`__ of the spec:
+        Per `Section 2.3`_ of the spec:
 
         "The server MUST (...) ensure that the temporary
         credentials have not expired or been used before."
@@ -831,7 +831,7 @@ class RequestValidator:
         """Associate an authorization verifier with a request token.
 
         :param token: A request token string.
-        :param verifier A dictionary containing the oauth_verifier and
+        :param verifier: A dictionary containing the oauth_verifier and
                         oauth_token
         :param request: OAuthlib request.
         :type request: oauthlib.common.Request
diff --git a/lib/oauthlib/oauth1/rfc5849/signature.py b/lib/oauthlib/oauth1/rfc5849/signature.py
index a370ccd6..9cb1a517 100644
--- a/lib/oauthlib/oauth1/rfc5849/signature.py
+++ b/lib/oauthlib/oauth1/rfc5849/signature.py
@@ -37,15 +37,15 @@ should have no impact on properly behaving programs.
 import binascii
 import hashlib
 import hmac
+import ipaddress
 import logging
+import urllib.parse as urlparse
 import warnings
 
 from oauthlib.common import extract_params, safe_string_equals, urldecode
-import urllib.parse as urlparse
 
 from . import utils
 
-
 log = logging.getLogger(__name__)
 
 
@@ -131,7 +131,12 @@ def base_string_uri(uri: str, host: str = None) -> str:
         raise ValueError('uri must be a string.')
 
     # FIXME: urlparse does not support unicode
-    scheme, netloc, path, params, query, fragment = urlparse.urlparse(uri)
+    output = urlparse.urlparse(uri)
+    scheme = output.scheme
+    hostname = output.hostname
+    port = output.port
+    path = output.path
+    params = output.params
 
     # The scheme, authority, and path of the request resource URI `RFC3986`
     # are included by constructing an "http" or "https" URI representing
@@ -153,13 +158,22 @@ def base_string_uri(uri: str, host: str = None) -> str:
 
     # 1.  The scheme and host MUST be in lowercase.
     scheme = scheme.lower()
-    netloc = netloc.lower()
     # Note: if ``host`` is used, it will be converted to lowercase below
+    if hostname is not None:
+        hostname = hostname.lower()
 
     # 2.  The host and port values MUST match the content of the HTTP
     #     request "Host" header field.
     if host is not None:
-        netloc = host.lower()  # override value in uri with provided host
+        # NOTE: override value in uri with provided host
+        # Host argument is equal to netloc. It means it's missing scheme.
+        # Add it back, before parsing.
+
+        host = host.lower()
+        host = f"{scheme}://{host}"
+        output = urlparse.urlparse(host)
+        hostname = output.hostname
+        port = output.port
 
     # 3.  The port MUST be included if it is not the default port for the
     #     scheme, and MUST be excluded if it is the default.  Specifically,
@@ -170,33 +184,28 @@ def base_string_uri(uri: str, host: str = None) -> str:
     # .. _`RFC2616`: https://tools.ietf.org/html/rfc2616
     # .. _`RFC2818`: https://tools.ietf.org/html/rfc2818
 
-    if ':' in netloc:
-        # Contains a colon ":", so try to parse as "host:port"
+    if hostname is None:
+        raise ValueError('missing host')
 
-        hostname, port_str = netloc.split(':', 1)
+    # NOTE: Try guessing if we're dealing with IP or hostname
+    try:
+        hostname = ipaddress.ip_address(hostname)
+    except ValueError:
+        pass
 
-        if len(hostname) == 0:
-            raise ValueError('missing host')  # error: netloc was ":port" or ":"
+    if isinstance(hostname, ipaddress.IPv6Address):
+        hostname = f"[{hostname}]"
+    elif isinstance(hostname, ipaddress.IPv4Address):
+        hostname = f"{hostname}"
 
-        if len(port_str) == 0:
-            netloc = hostname  # was "host:", so just use the host part
-        else:
-            try:
-                port_num = int(port_str)  # try to parse into an integer number
-            except ValueError:
-                raise ValueError('port is not an integer')
-
-            if port_num <= 0 or 65535 < port_num:
-                raise ValueError('port out of range')  # 16-bit unsigned ints
-            if (scheme, port_num) in (('http', 80), ('https', 443)):
-                netloc = hostname  # default port for scheme: exclude port num
-            else:
-                netloc = hostname + ':' + str(port_num)  # use hostname:port
+    if port is not None and not (0 < port <= 65535):
+        raise ValueError('port out of range')  # 16-bit unsigned ints
+    if (scheme, port) in (('http', 80), ('https', 443)):
+        netloc = hostname  # default port for scheme: exclude port num
+    elif port:
+        netloc = f"{hostname}:{port}"  # use hostname:port
     else:
-        # Does not contain a colon, so entire value must be the hostname
-
-        if len(netloc) == 0:
-            raise ValueError('missing host')  # error: netloc was empty string
+        netloc = hostname
 
     v = urlparse.urlunparse((scheme, netloc, path, params, '', ''))
 
diff --git a/lib/oauthlib/oauth2/rfc6749/clients/backend_application.py b/lib/oauthlib/oauth2/rfc6749/clients/backend_application.py
index 0e2a8299..e11e8fae 100644
--- a/lib/oauthlib/oauth2/rfc6749/clients/backend_application.py
+++ b/lib/oauthlib/oauth2/rfc6749/clients/backend_application.py
@@ -39,7 +39,7 @@ class BackendApplicationClient(Client):
         format per `Appendix B`_ in the HTTP request entity-body:
 
         :param body: Existing request body (URL encoded string) to embed parameters
-                     into. This may contain extra paramters. Default ''.
+                     into. This may contain extra parameters. Default ''.
         :param scope:   The scope of the access request as described by
                         `Section 3.3`_.
 
diff --git a/lib/oauthlib/oauth2/rfc6749/clients/base.py b/lib/oauthlib/oauth2/rfc6749/clients/base.py
index bb4c1338..d5eb0cc1 100644
--- a/lib/oauthlib/oauth2/rfc6749/clients/base.py
+++ b/lib/oauthlib/oauth2/rfc6749/clients/base.py
@@ -6,12 +6,12 @@ oauthlib.oauth2.rfc6749
 This module is an implementation of various logic needed
 for consuming OAuth 2.0 RFC6749.
 """
+import base64
+import hashlib
+import re
+import secrets
 import time
 import warnings
-import secrets
-import re
-import hashlib
-import base64
 
 from oauthlib.common import generate_token
 from oauthlib.oauth2.rfc6749 import tokens
@@ -228,26 +228,21 @@ class Client:
         required parameters to the authorization URL.
 
         :param authorization_url: Provider authorization endpoint URL.
-
         :param state: CSRF protection string. Will be automatically created if
-        not provided. The generated state is available via the ``state``
-        attribute. Clients should verify that the state is unchanged and
-        present in the authorization response. This verification is done
-        automatically if using the ``authorization_response`` parameter
-        with ``prepare_token_request``.
-
+            not provided. The generated state is available via the ``state``
+            attribute. Clients should verify that the state is unchanged and
+            present in the authorization response. This verification is done
+            automatically if using the ``authorization_response`` parameter
+            with ``prepare_token_request``.
         :param redirect_url: Redirect URL to which the user will be returned
-        after authorization. Must be provided unless previously setup with
-        the provider. If provided then it must also be provided in the
-        token request.
-
+            after authorization. Must be provided unless previously setup with
+            the provider. If provided then it must also be provided in the
+            token request.
         :param scope: List of scopes to request. Must be equal to
-        or a subset of the scopes granted when obtaining the refresh
-        token. If none is provided, the ones provided in the constructor are
-        used.
-
+            or a subset of the scopes granted when obtaining the refresh
+            token. If none is provided, the ones provided in the constructor are
+            used.
         :param kwargs: Additional parameters to included in the request.
-
         :returns: The prepared request tuple with (url, headers, body).
         """
         if not is_secure_transport(authorization_url):
@@ -271,22 +266,16 @@ class Client:
         credentials.
 
         :param token_url: Provider token creation endpoint URL.
-
         :param authorization_response: The full redirection URL string, i.e.
-        the location to which the user was redirected after successfull
-        authorization. Used to mine credentials needed to obtain a token
-        in this step, such as authorization code.
-
+            the location to which the user was redirected after successful
+            authorization. Used to mine credentials needed to obtain a token
+            in this step, such as authorization code.
         :param redirect_url: The redirect_url supplied with the authorization
-        request (if there was one).
-
+            request (if there was one).
         :param state:
-
         :param body: Existing request body (URL encoded string) to embed parameters
-                     into. This may contain extra paramters. Default ''.
-
+                     into. This may contain extra parameters. Default ''.
         :param kwargs: Additional parameters to included in the request.
-
         :returns: The prepared request tuple with (url, headers, body).
         """
         if not is_secure_transport(token_url):
@@ -312,19 +301,14 @@ class Client:
         obtain a new access token, and possibly a new refresh token.
 
         :param token_url: Provider token refresh endpoint URL.
-
         :param refresh_token: Refresh token string.
-
         :param body: Existing request body (URL encoded string) to embed parameters
-                     into. This may contain extra paramters. Default ''.
-
+            into. This may contain extra parameters. Default ''.
         :param scope: List of scopes to request. Must be equal to
-        or a subset of the scopes granted when obtaining the refresh
-        token. If none is provided, the ones provided in the constructor are
-        used.
-
+            or a subset of the scopes granted when obtaining the refresh
+            token. If none is provided, the ones provided in the constructor are
+            used.
         :param kwargs: Additional parameters to included in the request.
-
         :returns: The prepared request tuple with (url, headers, body).
         """
         if not is_secure_transport(token_url):
@@ -341,20 +325,14 @@ class Client:
         """Prepare a token revocation request.
 
         :param revocation_url: Provider token revocation endpoint URL.
-
         :param token: The access or refresh token to be revoked (string).
-
         :param token_type_hint: ``"access_token"`` (default) or
-        ``"refresh_token"``. This is optional and if you wish to not pass it you
-        must provide ``token_type_hint=None``.
-
+            ``"refresh_token"``. This is optional and if you wish to not pass it you
+            must provide ``token_type_hint=None``.
         :param body:
-
         :param callback: A jsonp callback such as ``package.callback`` to be invoked
-        upon receiving the response. Not that it should not include a () suffix.
-
+            upon receiving the response. Not that it should not include a () suffix.
         :param kwargs: Additional parameters to included in the request.
-
         :returns: The prepared request tuple with (url, headers, body).
 
         Note that JSONP request may use GET requests as the parameters will
@@ -362,7 +340,7 @@ class Client:
 
         An example of a revocation request
 
-        .. code-block: http
+        .. code-block:: http
 
             POST /revoke HTTP/1.1
             Host: server.example.com
@@ -373,7 +351,7 @@ class Client:
 
         An example of a jsonp revocation request
 
-        .. code-block: http
+        .. code-block:: http
 
             GET /revoke?token=agabcdefddddafdd&callback=package.myCallback HTTP/1.1
             Host: server.example.com
@@ -382,9 +360,9 @@ class Client:
 
         and an error response
 
-        .. code-block: http
+        .. code-block:: javascript
 
-        package.myCallback({"error":"unsupported_token_type"});
+            package.myCallback({"error":"unsupported_token_type"});
 
         Note that these requests usually require client credentials, client_id in
         the case for public clients and provider specific authentication
@@ -408,9 +386,10 @@ class Client:
 
         :param body: The response body from the token request.
         :param scope: Scopes originally requested. If none is provided, the ones
-        provided in the constructor are used.
+            provided in the constructor are used.
         :return: Dictionary of token parameters.
-        :raises: Warning if scope has changed. OAuth2Error if response is invalid.
+        :raises: Warning if scope has changed. :py:class:`oauthlib.oauth2.errors.OAuth2Error`
+            if response is invalid.
 
         These response are json encoded and could easily be parsed without
         the assistance of OAuthLib. However, there are a few subtle issues
@@ -436,7 +415,7 @@ class Client:
             If omitted, the authorization server SHOULD provide the
             expiration time via other means or document the default value.
 
-           **scope**
+         **scope**
             Providers may supply this in all responses but are required to only
             if it has changed since the authorization request.
 
@@ -454,20 +433,16 @@ class Client:
 
         If the authorization server issued a refresh token to the client, the
         client makes a refresh request to the token endpoint by adding the
-        following parameters using the "application/x-www-form-urlencoded"
+        following parameters using the `application/x-www-form-urlencoded`
         format in the HTTP request entity-body:
 
-        grant_type
-                REQUIRED.  Value MUST be set to "refresh_token".
-        refresh_token
-                REQUIRED.  The refresh token issued to the client.
-        scope
-                OPTIONAL.  The scope of the access request as described by
-                Section 3.3.  The requested scope MUST NOT include any scope
-                not originally granted by the resource owner, and if omitted is
-                treated as equal to the scope originally granted by the
-                resource owner. Note that if none is provided, the ones provided
-                in the constructor are used if any.
+        :param refresh_token: REQUIRED.  The refresh token issued to the client.
+        :param scope:  OPTIONAL.  The scope of the access request as described by
+            Section 3.3.  The requested scope MUST NOT include any scope
+            not originally granted by the resource owner, and if omitted is
+            treated as equal to the scope originally granted by the
+            resource owner. Note that if none is provided, the ones provided
+            in the constructor are used if any.
         """
         refresh_token = refresh_token or self.refresh_token
         scope = self.scope if scope is None else scope
@@ -492,18 +467,21 @@ class Client:
 
     def create_code_verifier(self, length):
         """Create PKCE **code_verifier** used in computing **code_challenge**. 
+        See `RFC7636 Section 4.1`_
 
-           :param length: REQUIRED. The length of the code_verifier.
+        :param length: REQUIRED. The length of the code_verifier.
 
-            The client first creates a code verifier, "code_verifier", for each
-            OAuth 2.0 [RFC6749] Authorization Request, in the following manner:
+        The client first creates a code verifier, "code_verifier", for each
+        OAuth 2.0 [RFC6749] Authorization Request, in the following manner:
 
-            code_verifier = high-entropy cryptographic random STRING using the
-            unreserved characters [A-Z] / [a-z] / [0-9] / "-" / "." / "_" / "~"
-            from Section 2.3 of [RFC3986], with a minimum length of 43 characters
-            and a maximum length of 128 characters.
-            
-            .. _`Section 4.1`: https://tools.ietf.org/html/rfc7636#section-4.1
+        .. code-block:: text
+
+               code_verifier = high-entropy cryptographic random STRING using the
+               unreserved characters [A-Z] / [a-z] / [0-9] / "-" / "." / "_" / "~"
+               from Section 2.3 of [RFC3986], with a minimum length of 43 characters
+               and a maximum length of 128 characters.
+
+        .. _`RFC7636 Section 4.1`: https://tools.ietf.org/html/rfc7636#section-4.1
         """
         code_verifier = None
 
@@ -525,33 +503,30 @@ class Client:
 
     def create_code_challenge(self, code_verifier, code_challenge_method=None):
         """Create PKCE **code_challenge** derived from the  **code_verifier**.
+        See `RFC7636 Section 4.2`_
 
-           :param code_verifier: REQUIRED. The **code_verifier** generated from create_code_verifier().
-           :param code_challenge_method: OPTIONAL. The method used to derive the **code_challenge**. Acceptable
-                values include "S256". DEFAULT is "plain".
+        :param code_verifier: REQUIRED. The **code_verifier** generated from `create_code_verifier()`.
+        :param code_challenge_method: OPTIONAL. The method used to derive the **code_challenge**. Acceptable values include `S256`. DEFAULT is `plain`.
 
-
-            The client then creates a code challenge derived from the code
+               The client then creates a code challenge derived from the code
                verifier by using one of the following transformations on the code
-               verifier:
+               verifier::
 
-               plain
-                  code_challenge = code_verifier
+                   plain
+                      code_challenge = code_verifier
+                   S256
+                      code_challenge = BASE64URL-ENCODE(SHA256(ASCII(code_verifier)))
 
-               S256
-                  code_challenge = BASE64URL-ENCODE(SHA256(ASCII(code_verifier)))
-
-               If the client is capable of using "S256", it MUST use "S256", as
-               "S256" is Mandatory To Implement (MTI) on the server.  Clients are
-               permitted to use "plain" only if they cannot support "S256" for some
+               If the client is capable of using `S256`, it MUST use `S256`, as
+               `S256` is Mandatory To Implement (MTI) on the server.  Clients are
+               permitted to use `plain` only if they cannot support `S256` for some
                technical reason and know via out-of-band configuration that the
-               server supports "plain".
+               server supports `plain`.
 
                The plain transformation is for compatibility with existing
-               deployments and for constrained environments that can't use the S256
-               transformation.
+               deployments and for constrained environments that can't use the S256 transformation.
 
-            .. _`Section 4.2`: https://tools.ietf.org/html/rfc7636#section-4.2
+        .. _`RFC7636 Section 4.2`: https://tools.ietf.org/html/rfc7636#section-4.2
         """
         code_challenge = None
 
diff --git a/lib/oauthlib/oauth2/rfc6749/clients/legacy_application.py b/lib/oauthlib/oauth2/rfc6749/clients/legacy_application.py
index 7af68f34..9920981d 100644
--- a/lib/oauthlib/oauth2/rfc6749/clients/legacy_application.py
+++ b/lib/oauthlib/oauth2/rfc6749/clients/legacy_application.py
@@ -49,7 +49,7 @@ class LegacyApplicationClient(Client):
         :param username:    The resource owner username.
         :param password:    The resource owner password.
         :param body: Existing request body (URL encoded string) to embed parameters
-                     into. This may contain extra paramters. Default ''.
+                     into. This may contain extra parameters. Default ''.
         :param scope:   The scope of the access request as described by
                         `Section 3.3`_.
         :param include_client_id: `True` to send the `client_id` in the
diff --git a/lib/oauthlib/oauth2/rfc6749/clients/mobile_application.py b/lib/oauthlib/oauth2/rfc6749/clients/mobile_application.py
index cd325f4e..b10b41ce 100644
--- a/lib/oauthlib/oauth2/rfc6749/clients/mobile_application.py
+++ b/lib/oauthlib/oauth2/rfc6749/clients/mobile_application.py
@@ -55,7 +55,7 @@ class MobileApplicationClient(Client):
         using the "application/x-www-form-urlencoded" format, per `Appendix B`_:
 
         :param redirect_uri:  OPTIONAL. The redirect URI must be an absolute URI
-                              and it should have been registerd with the OAuth
+                              and it should have been registered with the OAuth
                               provider prior to use. As described in `Section 3.1.2`_.
 
         :param scope:  OPTIONAL. The scope of the access request as described by
diff --git a/lib/oauthlib/oauth2/rfc6749/clients/service_application.py b/lib/oauthlib/oauth2/rfc6749/clients/service_application.py
index c751c8b0..8fb17377 100644
--- a/lib/oauthlib/oauth2/rfc6749/clients/service_application.py
+++ b/lib/oauthlib/oauth2/rfc6749/clients/service_application.py
@@ -31,7 +31,7 @@ class ServiceApplicationClient(Client):
 
     def __init__(self, client_id, private_key=None, subject=None, issuer=None,
                  audience=None, **kwargs):
-        """Initalize a JWT client with defaults for implicit use later.
+        """Initialize a JWT client with defaults for implicit use later.
 
         :param client_id: Client identifier given by the OAuth provider upon
                           registration.
@@ -99,7 +99,7 @@ class ServiceApplicationClient(Client):
         :param extra_claims: A dict of additional claims to include in the JWT.
 
         :param body: Existing request body (URL encoded string) to embed parameters
-                     into. This may contain extra paramters. Default ''.
+                     into. This may contain extra parameters. Default ''.
 
         :param scope: The scope of the access request.
 
diff --git a/lib/oauthlib/oauth2/rfc6749/clients/web_application.py b/lib/oauthlib/oauth2/rfc6749/clients/web_application.py
index 1d3b2b5b..50890fbf 100644
--- a/lib/oauthlib/oauth2/rfc6749/clients/web_application.py
+++ b/lib/oauthlib/oauth2/rfc6749/clients/web_application.py
@@ -49,7 +49,7 @@ class WebApplicationClient(Client):
         using the "application/x-www-form-urlencoded" format, per `Appendix B`_:
 
         :param redirect_uri:  OPTIONAL. The redirect URI must be an absolute URI
-                              and it should have been registerd with the OAuth
+                              and it should have been registered with the OAuth
                               provider prior to use. As described in `Section 3.1.2`_.
 
         :param scope:  OPTIONAL. The scope of the access request as described by
@@ -117,7 +117,7 @@ class WebApplicationClient(Client):
                                 values MUST be identical.
 
         :param body: Existing request body (URL encoded string) to embed parameters
-                     into. This may contain extra paramters. Default ''.
+                     into. This may contain extra parameters. Default ''.
 
         :param include_client_id: `True` (default) to send the `client_id` in the
                                   body of the upstream request. This is required
diff --git a/lib/oauthlib/oauth2/rfc6749/endpoints/introspect.py b/lib/oauthlib/oauth2/rfc6749/endpoints/introspect.py
index 63570d9c..3cc61e66 100644
--- a/lib/oauthlib/oauth2/rfc6749/endpoints/introspect.py
+++ b/lib/oauthlib/oauth2/rfc6749/endpoints/introspect.py
@@ -86,9 +86,9 @@ class IntrospectEndpoint(BaseEndpoint):
         an HTTP POST request with parameters sent as
         "application/x-www-form-urlencoded".
 
-        token REQUIRED.  The string value of the token.
+        * token REQUIRED.  The string value of the token.
+        * token_type_hint OPTIONAL.
 
-        token_type_hint OPTIONAL.
         A hint about the type of the token submitted for
         introspection.  The protected resource MAY pass this parameter to
         help the authorization server optimize the token lookup.  If the
@@ -96,11 +96,9 @@ class IntrospectEndpoint(BaseEndpoint):
         extend its search across all of its supported token types.  An
         authorization server MAY ignore this parameter, particularly if it
         is able to detect the token type automatically.
-            *  access_token: An Access Token as defined in [`RFC6749`],
-                `section 1.4`_
 
-            *  refresh_token: A Refresh Token as defined in [`RFC6749`],
-                `section 1.5`_
+        *  access_token: An Access Token as defined in [`RFC6749`], `section 1.4`_
+        *  refresh_token: A Refresh Token as defined in [`RFC6749`], `section 1.5`_
 
         The introspection endpoint MAY accept other OPTIONAL
         parameters to provide further context to the query.  For
diff --git a/lib/oauthlib/oauth2/rfc6749/endpoints/metadata.py b/lib/oauthlib/oauth2/rfc6749/endpoints/metadata.py
index d43a8247..a2820f28 100644
--- a/lib/oauthlib/oauth2/rfc6749/endpoints/metadata.py
+++ b/lib/oauthlib/oauth2/rfc6749/endpoints/metadata.py
@@ -10,7 +10,7 @@ import copy
 import json
 import logging
 
-from .. import grant_types
+from .. import grant_types, utils
 from .authorization import AuthorizationEndpoint
 from .base import BaseEndpoint, catch_errors_and_unavailability
 from .introspect import IntrospectEndpoint
@@ -68,7 +68,7 @@ class MetadataEndpoint(BaseEndpoint):
                 raise ValueError("key {} is a mandatory metadata.".format(key))
 
         elif is_issuer:
-            if not array[key].startswith("https"):
+            if not utils.is_secure_transport(array[key]):
                 raise ValueError("key {}: {} must be an HTTPS URL".format(key, array[key]))
             if "?" in array[key] or "&" in array[key] or "#" in array[key]:
                 raise ValueError("key {}: {} must not contain query or fragment components".format(key, array[key]))
diff --git a/lib/oauthlib/oauth2/rfc6749/endpoints/revocation.py b/lib/oauthlib/oauth2/rfc6749/endpoints/revocation.py
index 4aa5ec6e..596d0860 100644
--- a/lib/oauthlib/oauth2/rfc6749/endpoints/revocation.py
+++ b/lib/oauthlib/oauth2/rfc6749/endpoints/revocation.py
@@ -42,7 +42,7 @@ class RevocationEndpoint(BaseEndpoint):
 
 
         The authorization server responds with HTTP status code 200 if the
-        token has been revoked sucessfully or if the client submitted an
+        token has been revoked successfully or if the client submitted an
         invalid token.
 
         Note: invalid tokens do not cause an error response since the client
@@ -95,7 +95,7 @@ class RevocationEndpoint(BaseEndpoint):
         submitted for revocation.  Clients MAY pass this parameter in order to
         help the authorization server to optimize the token lookup.  If the
         server is unable to locate the token using the given hint, it MUST
-        extend its search accross all of its supported token types.  An
+        extend its search across all of its supported token types.  An
         authorization server MAY ignore this parameter, particularly if it is
         able to detect the token type automatically.  This specification
         defines two such values:
diff --git a/lib/oauthlib/oauth2/rfc6749/grant_types/authorization_code.py b/lib/oauthlib/oauth2/rfc6749/grant_types/authorization_code.py
index b799823e..858855a1 100644
--- a/lib/oauthlib/oauth2/rfc6749/grant_types/authorization_code.py
+++ b/lib/oauthlib/oauth2/rfc6749/grant_types/authorization_code.py
@@ -10,7 +10,6 @@ import logging
 from oauthlib import common
 
 from .. import errors
-from ..utils import is_secure_transport
 from .base import GrantTypeBase
 
 log = logging.getLogger(__name__)
@@ -547,20 +546,3 @@ class AuthorizationCodeGrant(GrantTypeBase):
         if challenge_method in self._code_challenge_methods:
             return self._code_challenge_methods[challenge_method](verifier, challenge)
         raise NotImplementedError('Unknown challenge_method %s' % challenge_method)
-
-    def _create_cors_headers(self, request):
-        """If CORS is allowed, create the appropriate headers."""
-        if 'origin' not in request.headers:
-            return {}
-
-        origin = request.headers['origin']
-        if not is_secure_transport(origin):
-            log.debug('Origin "%s" is not HTTPS, CORS not allowed.', origin)
-            return {}
-        elif not self.request_validator.is_origin_allowed(
-            request.client_id, origin, request):
-            log.debug('Invalid origin "%s", CORS not allowed.', origin)
-            return {}
-        else:
-            log.debug('Valid origin "%s", injecting CORS headers.', origin)
-            return {'Access-Control-Allow-Origin': origin}
diff --git a/lib/oauthlib/oauth2/rfc6749/grant_types/base.py b/lib/oauthlib/oauth2/rfc6749/grant_types/base.py
index a64f168c..ca343a11 100644
--- a/lib/oauthlib/oauth2/rfc6749/grant_types/base.py
+++ b/lib/oauthlib/oauth2/rfc6749/grant_types/base.py
@@ -10,6 +10,7 @@ from oauthlib.oauth2.rfc6749 import errors, utils
 from oauthlib.uri_validate import is_absolute_uri
 
 from ..request_validator import RequestValidator
+from ..utils import is_secure_transport
 
 log = logging.getLogger(__name__)
 
@@ -248,3 +249,20 @@ class GrantTypeBase:
                 raise errors.MissingRedirectURIError(request=request)
             if not is_absolute_uri(request.redirect_uri):
                 raise errors.InvalidRedirectURIError(request=request)
+
+    def _create_cors_headers(self, request):
+        """If CORS is allowed, create the appropriate headers."""
+        if 'origin' not in request.headers:
+            return {}
+
+        origin = request.headers['origin']
+        if not is_secure_transport(origin):
+            log.debug('Origin "%s" is not HTTPS, CORS not allowed.', origin)
+            return {}
+        elif not self.request_validator.is_origin_allowed(
+            request.client_id, origin, request):
+            log.debug('Invalid origin "%s", CORS not allowed.', origin)
+            return {}
+        else:
+            log.debug('Valid origin "%s", injecting CORS headers.', origin)
+            return {'Access-Control-Allow-Origin': origin}
diff --git a/lib/oauthlib/oauth2/rfc6749/grant_types/refresh_token.py b/lib/oauthlib/oauth2/rfc6749/grant_types/refresh_token.py
index f801de4a..ce33df0e 100644
--- a/lib/oauthlib/oauth2/rfc6749/grant_types/refresh_token.py
+++ b/lib/oauthlib/oauth2/rfc6749/grant_types/refresh_token.py
@@ -69,6 +69,7 @@ class RefreshTokenGrant(GrantTypeBase):
 
         log.debug('Issuing new token to client id %r (%r), %r.',
                   request.client_id, request.client, token)
+        headers.update(self._create_cors_headers(request))
         return headers, json.dumps(token), 200
 
     def validate_token_request(self, request):
diff --git a/lib/oauthlib/oauth2/rfc6749/parameters.py b/lib/oauthlib/oauth2/rfc6749/parameters.py
index 44738bb4..8f6ce2c7 100644
--- a/lib/oauthlib/oauth2/rfc6749/parameters.py
+++ b/lib/oauthlib/oauth2/rfc6749/parameters.py
@@ -45,7 +45,7 @@ def prepare_grant_uri(uri, client_id, response_type, redirect_uri=None,
                   back to the client.  The parameter SHOULD be used for
                   preventing cross-site request forgery as described in
                   `Section 10.12`_.
-    :param code_challenge: PKCE paramater. A challenge derived from the 
+    :param code_challenge: PKCE parameter. A challenge derived from the 
                            code_verifier that is sent in the authorization 
                            request, to be verified against later.
     :param code_challenge_method: PKCE parameter. A method that was used to derive the 
diff --git a/lib/oauthlib/oauth2/rfc6749/request_validator.py b/lib/oauthlib/oauth2/rfc6749/request_validator.py
index 610a708d..3910c0b9 100644
--- a/lib/oauthlib/oauth2/rfc6749/request_validator.py
+++ b/lib/oauthlib/oauth2/rfc6749/request_validator.py
@@ -191,6 +191,7 @@ class RequestValidator:
         claims associated, or `None` in case the token is unknown.
 
         Below the list of registered claims you should be interested in:
+
         - scope : space-separated list of scopes
         - client_id : client identifier
         - username : human-readable identifier for the resource owner
@@ -204,10 +205,10 @@ class RequestValidator:
         - jti : string identifier for the token
 
         Note that most of them are coming directly from JWT RFC. More details
-        can be found in `Introspect Claims`_ or `_JWT Claims`_.
+        can be found in `Introspect Claims`_ or `JWT Claims`_.
 
         The implementation can use *token_type_hint* to improve lookup
-        efficency, but must fallback to other types to be compliant with RFC.
+        efficiency, but must fallback to other types to be compliant with RFC.
 
         The dict of claims is added to request.token after this method.
 
@@ -443,6 +444,7 @@ class RequestValidator:
             - request.user
             - request.scopes
             - request.claims (if given)
+
         OBS! The request.user attribute should be set to the resource owner
         associated with this authorization code. Similarly request.scopes
         must also be set.
@@ -451,6 +453,7 @@ class RequestValidator:
 
         If PKCE is enabled (see 'is_pkce_required' and 'save_authorization_code')
         you MUST set the following based on the information stored:
+
             - request.code_challenge
             - request.code_challenge_method
 
@@ -561,7 +564,7 @@ class RequestValidator:
         OBS! The validation should also set the user attribute of the request
         to a valid resource owner, i.e. request.user = username or similar. If
         not set you will be unable to associate a token with a user in the
-        persistance method used (commonly, save_bearer_token).
+        persistence method used (commonly, save_bearer_token).
 
         :param username: Unicode username.
         :param password: Unicode password.
@@ -671,6 +674,7 @@ class RequestValidator:
 
         Method is used by:
             - Authorization Code Grant
+            - Refresh Token Grant
 
         """
         return False
diff --git a/lib/oauthlib/oauth2/rfc6749/tokens.py b/lib/oauthlib/oauth2/rfc6749/tokens.py
index 6284248d..0757d07e 100644
--- a/lib/oauthlib/oauth2/rfc6749/tokens.py
+++ b/lib/oauthlib/oauth2/rfc6749/tokens.py
@@ -257,6 +257,7 @@ def get_token_from_header(request):
 
 
 class TokenBase:
+    __slots__ = ()
 
     def __call__(self, request, refresh_token=False):
         raise NotImplementedError('Subclasses must implement this method.')
diff --git a/lib/oauthlib/oauth2/rfc8628/clients/device.py b/lib/oauthlib/oauth2/rfc8628/clients/device.py
index 95c4f5a2..b9ba2150 100644
--- a/lib/oauthlib/oauth2/rfc8628/clients/device.py
+++ b/lib/oauthlib/oauth2/rfc8628/clients/device.py
@@ -5,12 +5,11 @@ oauthlib.oauth2.rfc8628
 This module is an implementation of various logic needed
 for consuming and providing OAuth 2.0 Device Authorization RFC8628.
 """
-
+from oauthlib.common import add_params_to_uri
 from oauthlib.oauth2 import BackendApplicationClient, Client
 from oauthlib.oauth2.rfc6749.errors import InsecureTransportError
 from oauthlib.oauth2.rfc6749.parameters import prepare_token_request
 from oauthlib.oauth2.rfc6749.utils import is_secure_transport, list_to_scope
-from oauthlib.common import add_params_to_uri
 
 
 class DeviceClient(Client):
@@ -62,7 +61,7 @@ class DeviceClient(Client):
         body.
 
         :param body: Existing request body (URL encoded string) to embed parameters
-                     into. This may contain extra paramters. Default ''.
+                     into. This may contain extra parameters. Default ''.
         :param scope:   The scope of the access request as described by
                         `Section 3.3`_.
 
@@ -84,6 +83,8 @@ class DeviceClient(Client):
             >>> client.prepare_request_body(scope=['hello', 'world'])
             'grant_type=urn:ietf:params:oauth:grant-type:device_code&scope=hello+world'
 
+        .. _`Section 3.2.1`: https://datatracker.ietf.org/doc/html/rfc6749#section-3.2.1
+        .. _`Section 3.3`: https://datatracker.ietf.org/doc/html/rfc6749#section-3.3
         .. _`Section 3.4`: https://datatracker.ietf.org/doc/html/rfc8628#section-3.4
         """
 
diff --git a/lib/oauthlib/openid/connect/core/endpoints/userinfo.py b/lib/oauthlib/openid/connect/core/endpoints/userinfo.py
index 1c29cc55..7aa2bbe9 100644
--- a/lib/oauthlib/openid/connect/core/endpoints/userinfo.py
+++ b/lib/oauthlib/openid/connect/core/endpoints/userinfo.py
@@ -69,7 +69,7 @@ class UserInfoEndpoint(BaseEndpoint):
         5.3.1.  UserInfo Request
         The Client sends the UserInfo Request using either HTTP GET or HTTP
         POST. The Access Token obtained from an OpenID Connect Authentication
-        Request MUST be sent as a Bearer Token, per Section 2 of OAuth 2.0
+        Request MUST be sent as a Bearer Token, per `Section 2`_ of OAuth 2.0
         Bearer Token Usage [RFC6750].
 
         It is RECOMMENDED that the request use the HTTP GET method and the
@@ -77,21 +77,28 @@ class UserInfoEndpoint(BaseEndpoint):
 
         The following is a non-normative example of a UserInfo Request:
 
-        GET /userinfo HTTP/1.1
-        Host: server.example.com
-        Authorization: Bearer SlAV32hkKG
+        .. code-block:: http
+
+            GET /userinfo HTTP/1.1
+            Host: server.example.com
+            Authorization: Bearer SlAV32hkKG
 
         5.3.3. UserInfo Error Response
         When an error condition occurs, the UserInfo Endpoint returns an Error
-        Response as defined in Section 3 of OAuth 2.0 Bearer Token Usage
+        Response as defined in `Section 3`_ of OAuth 2.0 Bearer Token Usage
         [RFC6750]. (HTTP errors unrelated to RFC 6750 are returned to the User
         Agent using the appropriate HTTP status code.)
 
         The following is a non-normative example of a UserInfo Error Response:
 
-        HTTP/1.1 401 Unauthorized
-        WWW-Authenticate: Bearer error="invalid_token",
+        .. code-block:: http
+
+            HTTP/1.1 401 Unauthorized
+            WWW-Authenticate: Bearer error="invalid_token",
                 error_description="The Access Token expired"
+
+        .. _`Section 2`: https://datatracker.ietf.org/doc/html/rfc6750#section-2
+        .. _`Section 3`: https://datatracker.ietf.org/doc/html/rfc6750#section-3
         """
         if not self.bearer.validate_request(request):
             raise errors.InvalidTokenError()
diff --git a/lib/oauthlib/openid/connect/core/grant_types/base.py b/lib/oauthlib/openid/connect/core/grant_types/base.py
index 76173e6c..33411dad 100644
--- a/lib/oauthlib/openid/connect/core/grant_types/base.py
+++ b/lib/oauthlib/openid/connect/core/grant_types/base.py
@@ -8,7 +8,6 @@ from oauthlib.oauth2.rfc6749.errors import (
     ConsentRequired, InvalidRequestError, LoginRequired,
 )
 
-
 log = logging.getLogger(__name__)
 
 
diff --git a/lib/oauthlib/openid/connect/core/grant_types/dispatchers.py b/lib/oauthlib/openid/connect/core/grant_types/dispatchers.py
index 2734c387..5aa7d469 100644
--- a/lib/oauthlib/openid/connect/core/grant_types/dispatchers.py
+++ b/lib/oauthlib/openid/connect/core/grant_types/dispatchers.py
@@ -84,7 +84,7 @@ class AuthorizationTokenGrantDispatcher(Dispatcher):
         code = parameters.get('code', None)
         redirect_uri = parameters.get('redirect_uri', None)
 
-        # If code is not pressent fallback to `default_grant` which will
+        # If code is not present fallback to `default_grant` which will
         # raise an error for the missing `code` in `create_token_response` step.
         if code:
             scopes = self.request_validator.get_authorization_code_scopes(client_id, code, redirect_uri, request)
diff --git a/lib/oauthlib/openid/connect/core/tokens.py b/lib/oauthlib/openid/connect/core/tokens.py
index a312e2d2..936ab52e 100644
--- a/lib/oauthlib/openid/connect/core/tokens.py
+++ b/lib/oauthlib/openid/connect/core/tokens.py
@@ -4,7 +4,9 @@ authlib.openid.connect.core.tokens
 
 This module contains methods for adding JWT tokens to requests.
 """
-from oauthlib.oauth2.rfc6749.tokens import TokenBase, random_token_generator, get_token_from_header
+from oauthlib.oauth2.rfc6749.tokens import (
+    TokenBase, get_token_from_header, random_token_generator,
+)
 
 
 class JWTToken(TokenBase):
diff --git a/lib/oauthlib/uri_validate.py b/lib/oauthlib/uri_validate.py
index 8a6d9c27..a6fe0fb2 100644
--- a/lib/oauthlib/uri_validate.py
+++ b/lib/oauthlib/uri_validate.py
@@ -66,7 +66,7 @@ IPv4address = r"%(dec_octet)s \. %(dec_octet)s \. %(dec_octet)s \. %(dec_octet)s
 )
 
 #   IPv6address
-IPv6address = r"([A-Fa-f0-9:]+:+)+[A-Fa-f0-9]+"
+IPv6address = r"([A-Fa-f0-9:]+[:$])[A-Fa-f0-9]{1,4}"
 
 #   IPvFuture     = "v" 1*HEXDIG "." 1*( unreserved / sub-delims / ":" )
 IPvFuture = r"v %(HEXDIG)s+ \. (?: %(unreserved)s | %(sub_delims)s | : )+" % locals()
diff --git a/lib/requests_oauthlib/__init__.py b/lib/requests_oauthlib/__init__.py
index 0d3e49f9..865d72fb 100644
--- a/lib/requests_oauthlib/__init__.py
+++ b/lib/requests_oauthlib/__init__.py
@@ -1,3 +1,4 @@
+# ruff: noqa: F401
 import logging
 
 from .oauth1_auth import OAuth1
@@ -5,7 +6,7 @@ from .oauth1_session import OAuth1Session
 from .oauth2_auth import OAuth2
 from .oauth2_session import OAuth2Session, TokenUpdated
 
-__version__ = "1.3.1"
+__version__ = "2.0.0"
 
 import requests
 
diff --git a/lib/requests_oauthlib/compliance_fixes/__init__.py b/lib/requests_oauthlib/compliance_fixes/__init__.py
index 0e8e3ac8..8815ea0b 100644
--- a/lib/requests_oauthlib/compliance_fixes/__init__.py
+++ b/lib/requests_oauthlib/compliance_fixes/__init__.py
@@ -1,5 +1,4 @@
-from __future__ import absolute_import
-
+# ruff: noqa: F401
 from .facebook import facebook_compliance_fix
 from .fitbit import fitbit_compliance_fix
 from .slack import slack_compliance_fix
diff --git a/lib/requests_oauthlib/compliance_fixes/douban.py b/lib/requests_oauthlib/compliance_fixes/douban.py
index ecc57b08..c8b99c72 100644
--- a/lib/requests_oauthlib/compliance_fixes/douban.py
+++ b/lib/requests_oauthlib/compliance_fixes/douban.py
@@ -1,14 +1,12 @@
 import json
 
-from oauthlib.common import to_unicode
-
 
 def douban_compliance_fix(session):
     def fix_token_type(r):
         token = json.loads(r.text)
         token.setdefault("token_type", "Bearer")
         fixed_token = json.dumps(token)
-        r._content = to_unicode(fixed_token).encode("utf-8")
+        r._content = fixed_token.encode()
         return r
 
     session._client_default_token_placement = "query"
diff --git a/lib/requests_oauthlib/compliance_fixes/ebay.py b/lib/requests_oauthlib/compliance_fixes/ebay.py
index 4aa423b3..ef33f391 100644
--- a/lib/requests_oauthlib/compliance_fixes/ebay.py
+++ b/lib/requests_oauthlib/compliance_fixes/ebay.py
@@ -1,5 +1,4 @@
 import json
-from oauthlib.common import to_unicode
 
 
 def ebay_compliance_fix(session):
@@ -13,7 +12,7 @@ def ebay_compliance_fix(session):
         if token.get("token_type") in ["Application Access Token", "User Access Token"]:
             token["token_type"] = "Bearer"
             fixed_token = json.dumps(token)
-            response._content = to_unicode(fixed_token).encode("utf-8")
+            response._content = fixed_token.encode()
 
         return response
 
diff --git a/lib/requests_oauthlib/compliance_fixes/facebook.py b/lib/requests_oauthlib/compliance_fixes/facebook.py
index 90e79212..f44558a8 100644
--- a/lib/requests_oauthlib/compliance_fixes/facebook.py
+++ b/lib/requests_oauthlib/compliance_fixes/facebook.py
@@ -1,11 +1,5 @@
 from json import dumps
-
-try:
-    from urlparse import parse_qsl
-except ImportError:
-    from urllib.parse import parse_qsl
-
-from oauthlib.common import to_unicode
+from urllib.parse import parse_qsl
 
 
 def facebook_compliance_fix(session):
@@ -26,7 +20,7 @@ def facebook_compliance_fix(session):
         if expires is not None:
             token["expires_in"] = expires
         token["token_type"] = "Bearer"
-        r._content = to_unicode(dumps(token)).encode("UTF-8")
+        r._content = dumps(token).encode()
         return r
 
     session.register_compliance_hook("access_token_response", _compliance_fix)
diff --git a/lib/requests_oauthlib/compliance_fixes/fitbit.py b/lib/requests_oauthlib/compliance_fixes/fitbit.py
index 7e627024..aacc68bf 100644
--- a/lib/requests_oauthlib/compliance_fixes/fitbit.py
+++ b/lib/requests_oauthlib/compliance_fixes/fitbit.py
@@ -8,8 +8,6 @@ MissingTokenError.
 
 from json import loads, dumps
 
-from oauthlib.common import to_unicode
-
 
 def fitbit_compliance_fix(session):
     def _missing_error(r):
@@ -17,7 +15,7 @@ def fitbit_compliance_fix(session):
         if "errors" in token:
             # Set the error to the first one we have
             token["error"] = token["errors"][0]["errorType"]
-        r._content = to_unicode(dumps(token)).encode("UTF-8")
+        r._content = dumps(token).encode()
         return r
 
     session.register_compliance_hook("access_token_response", _missing_error)
diff --git a/lib/requests_oauthlib/compliance_fixes/instagram.py b/lib/requests_oauthlib/compliance_fixes/instagram.py
index 4e07fe08..7d5a2ad4 100644
--- a/lib/requests_oauthlib/compliance_fixes/instagram.py
+++ b/lib/requests_oauthlib/compliance_fixes/instagram.py
@@ -1,7 +1,4 @@
-try:
-    from urlparse import urlparse, parse_qs
-except ImportError:
-    from urllib.parse import urlparse, parse_qs
+from urllib.parse import urlparse, parse_qs
 
 from oauthlib.common import add_params_to_uri
 
diff --git a/lib/requests_oauthlib/compliance_fixes/mailchimp.py b/lib/requests_oauthlib/compliance_fixes/mailchimp.py
index c69ce9fd..0d602659 100644
--- a/lib/requests_oauthlib/compliance_fixes/mailchimp.py
+++ b/lib/requests_oauthlib/compliance_fixes/mailchimp.py
@@ -1,21 +1,19 @@
 import json
 
-from oauthlib.common import to_unicode
-
 
 def mailchimp_compliance_fix(session):
     def _null_scope(r):
         token = json.loads(r.text)
         if "scope" in token and token["scope"] is None:
             token.pop("scope")
-        r._content = to_unicode(json.dumps(token)).encode("utf-8")
+        r._content = json.dumps(token).encode()
         return r
 
     def _non_zero_expiration(r):
         token = json.loads(r.text)
         if "expires_in" in token and token["expires_in"] == 0:
             token["expires_in"] = 3600
-        r._content = to_unicode(json.dumps(token)).encode("utf-8")
+        r._content = json.dumps(token).encode()
         return r
 
     session.register_compliance_hook("access_token_response", _null_scope)
diff --git a/lib/requests_oauthlib/compliance_fixes/plentymarkets.py b/lib/requests_oauthlib/compliance_fixes/plentymarkets.py
index 9f605f05..859f0566 100644
--- a/lib/requests_oauthlib/compliance_fixes/plentymarkets.py
+++ b/lib/requests_oauthlib/compliance_fixes/plentymarkets.py
@@ -1,8 +1,6 @@
 from json import dumps, loads
 import re
 
-from oauthlib.common import to_unicode
-
 
 def plentymarkets_compliance_fix(session):
     def _to_snake_case(n):
@@ -22,7 +20,7 @@ def plentymarkets_compliance_fix(session):
         for k, v in token.items():
             fixed_token[_to_snake_case(k)] = v
 
-        r._content = to_unicode(dumps(fixed_token)).encode("UTF-8")
+        r._content = dumps(fixed_token).encode()
         return r
 
     session.register_compliance_hook("access_token_response", _compliance_fix)
diff --git a/lib/requests_oauthlib/compliance_fixes/slack.py b/lib/requests_oauthlib/compliance_fixes/slack.py
index 3f574b03..9095a470 100644
--- a/lib/requests_oauthlib/compliance_fixes/slack.py
+++ b/lib/requests_oauthlib/compliance_fixes/slack.py
@@ -1,7 +1,4 @@
-try:
-    from urlparse import urlparse, parse_qs
-except ImportError:
-    from urllib.parse import urlparse, parse_qs
+from urllib.parse import urlparse, parse_qs
 
 from oauthlib.common import add_params_to_uri
 
diff --git a/lib/requests_oauthlib/compliance_fixes/weibo.py b/lib/requests_oauthlib/compliance_fixes/weibo.py
index 6733abeb..f1623fd6 100644
--- a/lib/requests_oauthlib/compliance_fixes/weibo.py
+++ b/lib/requests_oauthlib/compliance_fixes/weibo.py
@@ -1,13 +1,11 @@
 from json import loads, dumps
 
-from oauthlib.common import to_unicode
-
 
 def weibo_compliance_fix(session):
     def _missing_token_type(r):
         token = loads(r.text)
         token["token_type"] = "Bearer"
-        r._content = to_unicode(dumps(token)).encode("UTF-8")
+        r._content = dumps(token).encode()
         return r
 
     session._client.default_token_placement = "query"
diff --git a/lib/requests_oauthlib/oauth1_auth.py b/lib/requests_oauthlib/oauth1_auth.py
index cfbbd590..f8c0bd6e 100644
--- a/lib/requests_oauthlib/oauth1_auth.py
+++ b/lib/requests_oauthlib/oauth1_auth.py
@@ -1,20 +1,15 @@
 # -*- coding: utf-8 -*-
-from __future__ import unicode_literals
-
 import logging
 
 from oauthlib.common import extract_params
 from oauthlib.oauth1 import Client, SIGNATURE_HMAC, SIGNATURE_TYPE_AUTH_HEADER
 from oauthlib.oauth1 import SIGNATURE_TYPE_BODY
-from requests.compat import is_py3
 from requests.utils import to_native_string
 from requests.auth import AuthBase
 
 CONTENT_TYPE_FORM_URLENCODED = "application/x-www-form-urlencoded"
 CONTENT_TYPE_MULTI_PART = "multipart/form-data"
 
-if is_py3:
-    unicode = str
 
 log = logging.getLogger(__name__)
 
@@ -83,7 +78,7 @@ class OAuth1(AuthBase):
             or self.client.signature_type == SIGNATURE_TYPE_BODY
         ):
             content_type = CONTENT_TYPE_FORM_URLENCODED
-        if not isinstance(content_type, unicode):
+        if not isinstance(content_type, str):
             content_type = content_type.decode("utf-8")
 
         is_form_encoded = CONTENT_TYPE_FORM_URLENCODED in content_type
@@ -96,17 +91,17 @@ class OAuth1(AuthBase):
         if is_form_encoded:
             r.headers["Content-Type"] = CONTENT_TYPE_FORM_URLENCODED
             r.url, headers, r.body = self.client.sign(
-                unicode(r.url), unicode(r.method), r.body or "", r.headers
+                str(r.url), str(r.method), r.body or "", r.headers
             )
         elif self.force_include_body:
             # To allow custom clients to work on non form encoded bodies.
             r.url, headers, r.body = self.client.sign(
-                unicode(r.url), unicode(r.method), r.body or "", r.headers
+                str(r.url), str(r.method), r.body or "", r.headers
             )
         else:
             # Omit body data in the signing of non form-encoded requests
             r.url, headers, _ = self.client.sign(
-                unicode(r.url), unicode(r.method), None, r.headers
+                str(r.url), str(r.method), None, r.headers
             )
 
         r.prepare_headers(headers)
diff --git a/lib/requests_oauthlib/oauth1_session.py b/lib/requests_oauthlib/oauth1_session.py
index 88f2853c..7625c808 100644
--- a/lib/requests_oauthlib/oauth1_session.py
+++ b/lib/requests_oauthlib/oauth1_session.py
@@ -1,9 +1,4 @@
-from __future__ import unicode_literals
-
-try:
-    from urlparse import urlparse
-except ImportError:
-    from urllib.parse import urlparse
+from urllib.parse import urlparse
 
 import logging
 
@@ -85,7 +80,7 @@ class OAuth1Session(requests.Session):
     'https://api.twitter.com/oauth/authorize?oauth_token=sdf0o9823sjdfsdf&oauth_callback=https%3A%2F%2F127.0.0.1%2Fcallback'
     >>>
     >>> # Third step. Fetch the access token
-    >>> redirect_response = raw_input('Paste the full redirect URL here.')
+    >>> redirect_response = input('Paste the full redirect URL here.')
     >>> oauth_session.parse_authorization_response(redirect_response)
     {
         'oauth_token: 'kjerht2309u',
@@ -258,7 +253,7 @@ class OAuth1Session(requests.Session):
         return add_params_to_uri(url, kwargs.items())
 
     def fetch_request_token(self, url, realm=None, **request_kwargs):
-        r"""Fetch a request token.
+        """Fetch a request token.
 
         This is the first step in the OAuth 1 workflow. A request token is
         obtained by making a signed post request to url. The token is then
@@ -267,7 +262,7 @@ class OAuth1Session(requests.Session):
 
         :param url: The request token endpoint URL.
         :param realm: A list of realms to request access to.
-        :param \*\*request_kwargs: Optional arguments passed to ''post''
+        :param request_kwargs: Optional arguments passed to ''post''
             function in ''requests.Session''
         :returns: The response in dict format.
 
diff --git a/lib/requests_oauthlib/oauth2_auth.py b/lib/requests_oauthlib/oauth2_auth.py
index b880f72f..f19f52ac 100644
--- a/lib/requests_oauthlib/oauth2_auth.py
+++ b/lib/requests_oauthlib/oauth2_auth.py
@@ -1,4 +1,3 @@
-from __future__ import unicode_literals
 from oauthlib.oauth2 import WebApplicationClient, InsecureTransportError
 from oauthlib.oauth2 import is_secure_transport
 from requests.auth import AuthBase
diff --git a/lib/requests_oauthlib/oauth2_session.py b/lib/requests_oauthlib/oauth2_session.py
index db446808..93cc4d7b 100644
--- a/lib/requests_oauthlib/oauth2_session.py
+++ b/lib/requests_oauthlib/oauth2_session.py
@@ -1,5 +1,3 @@
-from __future__ import unicode_literals
-
 import logging
 
 from oauthlib.common import generate_token, urldecode
@@ -46,6 +44,7 @@ class OAuth2Session(requests.Session):
         token=None,
         state=None,
         token_updater=None,
+        pkce=None,
         **kwargs
     ):
         """Construct a new OAuth 2 client session.
@@ -72,18 +71,23 @@ class OAuth2Session(requests.Session):
                         set a TokenUpdated warning will be raised when a token
                         has been refreshed. This warning will carry the token
                         in its token argument.
+        :param pkce: Set "S256" or "plain" to enable PKCE. Default is disabled.
         :param kwargs: Arguments to pass to the Session constructor.
         """
         super(OAuth2Session, self).__init__(**kwargs)
         self._client = client or WebApplicationClient(client_id, token=token)
         self.token = token or {}
-        self.scope = scope
+        self._scope = scope
         self.redirect_uri = redirect_uri
         self.state = state or generate_token
         self._state = state
         self.auto_refresh_url = auto_refresh_url
         self.auto_refresh_kwargs = auto_refresh_kwargs or {}
         self.token_updater = token_updater
+        self._pkce = pkce
+
+        if self._pkce not in ["S256", "plain", None]:
+            raise AttributeError("Wrong value for {}(.., pkce={})".format(self.__class__, self._pkce))
 
         # Ensure that requests doesn't do any automatic auth. See #278.
         # The default behavior can be re-enabled by setting auth to None.
@@ -95,8 +99,24 @@ class OAuth2Session(requests.Session):
             "access_token_response": set(),
             "refresh_token_response": set(),
             "protected_request": set(),
+            "refresh_token_request": set(),
+            "access_token_request": set(),
         }
 
+    @property
+    def scope(self):
+        """By default the scope from the client is used, except if overridden"""
+        if self._scope is not None:
+            return self._scope
+        elif self._client is not None:
+            return self._client.scope
+        else:
+            return None
+
+    @scope.setter
+    def scope(self, scope):
+        self._scope = scope
+
     def new_state(self):
         """Generates a state string to be used in authorizations."""
         try:
@@ -161,6 +181,13 @@ class OAuth2Session(requests.Session):
         :return: authorization_url, state
         """
         state = state or self.new_state()
+        if self._pkce:
+            self._code_verifier = self._client.create_code_verifier(43)
+            kwargs["code_challenge_method"] = self._pkce
+            kwargs["code_challenge"] = self._client.create_code_challenge(
+                code_verifier=self._code_verifier,
+                code_challenge_method=self._pkce
+            )
         return (
             self._client.prepare_request_uri(
                 url,
@@ -185,7 +212,7 @@ class OAuth2Session(requests.Session):
         force_querystring=False,
         timeout=None,
         headers=None,
-        verify=True,
+        verify=None,
         proxies=None,
         include_client_id=None,
         client_secret=None,
@@ -252,6 +279,13 @@ class OAuth2Session(requests.Session):
                     "Please supply either code or " "authorization_response parameters."
                 )
 
+        if self._pkce:
+            if self._code_verifier is None:
+                raise ValueError(
+                    "Code verifier is not found, authorization URL must be generated before"
+                )
+            kwargs["code_verifier"] = self._code_verifier
+
         # Earlier versions of this library build an HTTPBasicAuth header out of
         # `username` and `password`. The RFC states, however these attributes
         # must be in the request body and not the header.
@@ -325,7 +359,7 @@ class OAuth2Session(requests.Session):
 
         headers = headers or {
             "Accept": "application/json",
-            "Content-Type": "application/x-www-form-urlencoded;charset=UTF-8",
+            "Content-Type": "application/x-www-form-urlencoded",
         }
         self.token = {}
         request_kwargs = {}
@@ -338,6 +372,12 @@ class OAuth2Session(requests.Session):
         else:
             raise ValueError("The method kwarg must be POST or GET.")
 
+        for hook in self.compliance_hook["access_token_request"]:
+            log.debug("Invoking access_token_request hook %s.", hook)
+            token_url, headers, request_kwargs = hook(
+                token_url, headers, request_kwargs
+            )
+
         r = self.request(
             method=method,
             url=token_url,
@@ -388,7 +428,7 @@ class OAuth2Session(requests.Session):
         auth=None,
         timeout=None,
         headers=None,
-        verify=True,
+        verify=None,
         proxies=None,
         **kwargs
     ):
@@ -426,9 +466,13 @@ class OAuth2Session(requests.Session):
         if headers is None:
             headers = {
                 "Accept": "application/json",
-                "Content-Type": ("application/x-www-form-urlencoded;charset=UTF-8"),
+                "Content-Type": ("application/x-www-form-urlencoded"),
             }
 
+        for hook in self.compliance_hook["refresh_token_request"]:
+            log.debug("Invoking refresh_token_request hook %s.", hook)
+            token_url, headers, body = hook(token_url, headers, body)
+
         r = self.post(
             token_url,
             data=dict(urldecode(body)),
@@ -450,7 +494,7 @@ class OAuth2Session(requests.Session):
             r = hook(r)
 
         self.token = self._client.parse_request_body_response(r.text, scope=self.scope)
-        if not "refresh_token" in self.token:
+        if "refresh_token" not in self.token:
             log.debug("No new refresh token given. Re-using old.")
             self.token["refresh_token"] = refresh_token
         return self.token
@@ -464,6 +508,7 @@ class OAuth2Session(requests.Session):
         withhold_token=False,
         client_id=None,
         client_secret=None,
+        files=None,
         **kwargs
     ):
         """Intercept all requests and add the OAuth 2 token if present."""
@@ -519,7 +564,7 @@ class OAuth2Session(requests.Session):
         log.debug("Supplying headers %s and data %s", headers, data)
         log.debug("Passing through key word arguments %s.", kwargs)
         return super(OAuth2Session, self).request(
-            method, url, headers=headers, data=data, **kwargs
+            method, url, headers=headers, data=data, files=files, **kwargs
         )
 
     def register_compliance_hook(self, hook_type, hook):
@@ -529,6 +574,8 @@ class OAuth2Session(requests.Session):
             access_token_response invoked before token parsing.
             refresh_token_response invoked before refresh token parsing.
             protected_request invoked before making a request.
+            access_token_request invoked before making a token fetch request.
+            refresh_token_request invoked before making a refresh request.
 
         If you find a new hook is needed please send a GitHub PR request
         or open an issue.
diff --git a/requirements.txt b/requirements.txt
index fcea2c1c..f697ecc8 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -37,7 +37,7 @@ python-dateutil==2.9.0.post0
 python-twitter==3.5
 pytz==2024.1
 requests==2.31.0
-requests-oauthlib==1.3.1
+requests-oauthlib==2.0.0
 rumps==0.4.0; platform_system == "Darwin"
 simplejson==3.19.2
 six==1.16.0

From 1d96e0f8599609f134d6f4e64d358fa2e0fe0a10 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 30 Mar 2024 15:28:14 -0700
Subject: [PATCH 561/743] Bump tzdata from 2023.3 to 2024.1 (#2295)

* Bump tzdata from 2023.3 to 2024.1

Bumps [tzdata](https://github.com/python/tzdata) from 2023.3 to 2024.1.
- [Release notes](https://github.com/python/tzdata/releases)
- [Changelog](https://github.com/python/tzdata/blob/master/NEWS.md)
- [Commits](https://github.com/python/tzdata/compare/2023.3...2024.1)

---
updated-dependencies:
- dependency-name: tzdata
  dependency-type: direct:production
  update-type: version-update:semver-major
...

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

* Update tzdata==2024.1

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/tzdata/__init__.py                      |    4 +-
 lib/tzdata/zoneinfo/America/Ensenada        |  Bin 1025 -> 1025 bytes
 lib/tzdata/zoneinfo/America/Godthab         |  Bin 965 -> 965 bytes
 lib/tzdata/zoneinfo/America/Goose_Bay       |  Bin 1580 -> 1580 bytes
 lib/tzdata/zoneinfo/America/Indiana/Winamac |  Bin 612 -> 603 bytes
 lib/tzdata/zoneinfo/America/Matamoros       |  Bin 437 -> 437 bytes
 lib/tzdata/zoneinfo/America/Metlakatla      |  Bin 595 -> 586 bytes
 lib/tzdata/zoneinfo/America/Miquelon        |  Bin 550 -> 550 bytes
 lib/tzdata/zoneinfo/America/Moncton         |  Bin 1493 -> 1493 bytes
 lib/tzdata/zoneinfo/America/Montreal        |  Bin 1717 -> 1717 bytes
 lib/tzdata/zoneinfo/America/Nassau          |  Bin 1717 -> 1717 bytes
 lib/tzdata/zoneinfo/America/Nipigon         |  Bin 1717 -> 1717 bytes
 lib/tzdata/zoneinfo/America/Nuuk            |  Bin 965 -> 965 bytes
 lib/tzdata/zoneinfo/America/Ojinaga         |  Bin 709 -> 718 bytes
 lib/tzdata/zoneinfo/America/Santa_Isabel    |  Bin 1025 -> 1025 bytes
 lib/tzdata/zoneinfo/America/Scoresbysund    |  Bin 479 -> 984 bytes
 lib/tzdata/zoneinfo/America/St_Johns        |  Bin 1878 -> 1878 bytes
 lib/tzdata/zoneinfo/America/Thunder_Bay     |  Bin 1717 -> 1717 bytes
 lib/tzdata/zoneinfo/America/Tijuana         |  Bin 1025 -> 1025 bytes
 lib/tzdata/zoneinfo/America/Toronto         |  Bin 1717 -> 1717 bytes
 lib/tzdata/zoneinfo/Antarctica/Casey        |  Bin 243 -> 287 bytes
 lib/tzdata/zoneinfo/Antarctica/Macquarie    |  Bin 976 -> 976 bytes
 lib/tzdata/zoneinfo/Antarctica/Troll        |  Bin 177 -> 158 bytes
 lib/tzdata/zoneinfo/Antarctica/Vostok       |  Bin 133 -> 170 bytes
 lib/tzdata/zoneinfo/Asia/Almaty             |  Bin 609 -> 618 bytes
 lib/tzdata/zoneinfo/Asia/Gaza               |  Bin 2518 -> 2950 bytes
 lib/tzdata/zoneinfo/Asia/Hebron             |  Bin 2536 -> 2968 bytes
 lib/tzdata/zoneinfo/Asia/Ho_Chi_Minh        |  Bin 236 -> 236 bytes
 lib/tzdata/zoneinfo/Asia/Nicosia            |  Bin 597 -> 597 bytes
 lib/tzdata/zoneinfo/Asia/Qostanay           |  Bin 615 -> 624 bytes
 lib/tzdata/zoneinfo/Asia/Saigon             |  Bin 236 -> 236 bytes
 lib/tzdata/zoneinfo/Canada/Eastern          |  Bin 1717 -> 1717 bytes
 lib/tzdata/zoneinfo/Canada/Newfoundland     |  Bin 1878 -> 1878 bytes
 lib/tzdata/zoneinfo/Europe/Belfast          |  Bin 1599 -> 1599 bytes
 lib/tzdata/zoneinfo/Europe/Bucharest        |  Bin 661 -> 661 bytes
 lib/tzdata/zoneinfo/Europe/Chisinau         |  Bin 755 -> 755 bytes
 lib/tzdata/zoneinfo/Europe/Guernsey         |  Bin 1599 -> 1599 bytes
 lib/tzdata/zoneinfo/Europe/Isle_of_Man      |  Bin 1599 -> 1599 bytes
 lib/tzdata/zoneinfo/Europe/Jersey           |  Bin 1599 -> 1599 bytes
 lib/tzdata/zoneinfo/Europe/Kiev             |  Bin 558 -> 558 bytes
 lib/tzdata/zoneinfo/Europe/Kyiv             |  Bin 558 -> 558 bytes
 lib/tzdata/zoneinfo/Europe/London           |  Bin 1599 -> 1599 bytes
 lib/tzdata/zoneinfo/Europe/Nicosia          |  Bin 597 -> 597 bytes
 lib/tzdata/zoneinfo/Europe/Riga             |  Bin 694 -> 694 bytes
 lib/tzdata/zoneinfo/Europe/Sofia            |  Bin 592 -> 592 bytes
 lib/tzdata/zoneinfo/Europe/Tallinn          |  Bin 675 -> 675 bytes
 lib/tzdata/zoneinfo/Europe/Tiraspol         |  Bin 755 -> 755 bytes
 lib/tzdata/zoneinfo/Europe/Uzhgorod         |  Bin 558 -> 558 bytes
 lib/tzdata/zoneinfo/Europe/Vilnius          |  Bin 676 -> 676 bytes
 lib/tzdata/zoneinfo/Europe/Zaporozhye       |  Bin 558 -> 558 bytes
 lib/tzdata/zoneinfo/GB                      |  Bin 1599 -> 1599 bytes
 lib/tzdata/zoneinfo/GB-Eire                 |  Bin 1599 -> 1599 bytes
 lib/tzdata/zoneinfo/Mexico/BajaNorte        |  Bin 1025 -> 1025 bytes
 lib/tzdata/zoneinfo/Pacific/Norfolk         |  Bin 247 -> 237 bytes
 lib/tzdata/zoneinfo/iso3166.tab             |   17 +-
 lib/tzdata/zoneinfo/leapseconds             |   19 +-
 lib/tzdata/zoneinfo/tzdata.zi               | 3961 ++++++++++---------
 lib/tzdata/zoneinfo/zone.tab                |   24 +-
 lib/tzdata/zoneinfo/zone1970.tab            |   29 +-
 lib/tzdata/zoneinfo/zonenow.tab             |  303 ++
 lib/tzdata/zones                            |  656 +--
 requirements.txt                            |    2 +-
 62 files changed, 2665 insertions(+), 2350 deletions(-)
 create mode 100644 lib/tzdata/zoneinfo/zonenow.tab

diff --git a/lib/tzdata/__init__.py b/lib/tzdata/__init__.py
index a7d6b0b5..b319ed55 100644
--- a/lib/tzdata/__init__.py
+++ b/lib/tzdata/__init__.py
@@ -1,6 +1,6 @@
 # IANA versions like 2020a are not valid PEP 440 identifiers; the recommended
 # way to translate the version is to use YYYY.n where `n` is a 0-based index.
-__version__ = "2023.3"
+__version__ = "2024.1"
 
 # This exposes the original IANA version number.
-IANA_VERSION = "2023c"
+IANA_VERSION = "2024a"
diff --git a/lib/tzdata/zoneinfo/America/Ensenada b/lib/tzdata/zoneinfo/America/Ensenada
index e8be26b139e653e1b07a3db14ea34bd290441947..42087af4cceb049f1395cabaaa85b7c39253ed97 100644
GIT binary patch
delta 21
ccmZqVXyn-7!^~{Ex?!?Eb1Wm%<h9Hp07kY3SpWb4

delta 21
dcmZqVXyn-7!^}Kq^Mc9#%(0Bjlh-nb002!+2H^kz

diff --git a/lib/tzdata/zoneinfo/America/Godthab b/lib/tzdata/zoneinfo/America/Godthab
index 00b57bb13fbfa802e61f8b93d08622163a35a9a4..310774ea4fdd1798782a41f905d16e3548cd191e 100644
GIT binary patch
delta 13
UcmX@gew2Mf9Wx{I<a%Z|03m(^DF6Tf

delta 13
UcmX@gew2Mf9Wx`-<a%Z|03mq<C;$Ke

diff --git a/lib/tzdata/zoneinfo/America/Goose_Bay b/lib/tzdata/zoneinfo/America/Goose_Bay
index 820e0dd2cd7e7629e1a689cd83057ffadb7e83d8..e2cc3eefc273c206ab9d88f94660f587932991fc 100644
GIT binary patch
delta 21
dcmZ3(vxaAb3@h{cgbkDBS*J6yPu|X23II>c2Oa<b

delta 21
dcmZ3(vxaAb3@h_Ck$}natkW4eCU0jg1pr8V26_Mh

diff --git a/lib/tzdata/zoneinfo/America/Indiana/Winamac b/lib/tzdata/zoneinfo/America/Indiana/Winamac
index 8700ed9f065ed7b1cdcb686f6240105ab8f872d6..679d321e3b691b5403d9c9493367651360ea6f15 100644
GIT binary patch
delta 32
mcmaFDa+_sB7^B|C@CrtDCPpA+W|{neQFiigMy|<hOmP61<Or7l

delta 31
lcmcc3@`PnV7^D8i@Crr_1|V?PjejutJfj{X>*T+TaR8hG37`M~

diff --git a/lib/tzdata/zoneinfo/America/Matamoros b/lib/tzdata/zoneinfo/America/Matamoros
index 88cabcd1528c678db4e1ab1218e9dd6c032ed901..993ac47559c154e52af8fba1bcd7c9d0e3bea880 100644
GIT binary patch
delta 22
dcmdnWyp?%F3?s8`f5PNMMmZ)%#>w@JW&lq>1`PlJ

delta 23
fcmdnWyp?%F3?uWL=?#+;8D*K77?~#5GnxSaTeSw4

diff --git a/lib/tzdata/zoneinfo/America/Metlakatla b/lib/tzdata/zoneinfo/America/Metlakatla
index 9fefee388e6fa613f9a273f62ffcc020d44b72ab..71b0eab085dbbb48050d7b6a271ebb1a29fb1926 100644
GIT binary patch
delta 20
ccmcc2a*Aa_7^C*a@C3%m`x&(-zh=w;08f$!h5!Hn

delta 47
zcmX@ba+zg97^BX{@B~I41|W!Od1t`L#LP1JAfx2u3yf@>Z0sP&#Ku1P5n~1bDKZNy

diff --git a/lib/tzdata/zoneinfo/America/Miquelon b/lib/tzdata/zoneinfo/America/Miquelon
index 3b62585d0a13c9b35824ff7ecc91e29428c360e1..ba95cb0b3f755ab94154a54fd8cf6e6b9cdb0556 100644
GIT binary patch
delta 14
VcmZ3+vW#Uy3iEw&jg9I1838A01wsG-

delta 14
WcmZ3+vW#Uy3iCFL6&us{GXel9kOjH`

diff --git a/lib/tzdata/zoneinfo/America/Moncton b/lib/tzdata/zoneinfo/America/Moncton
index ecb69ef2c96a2a7f6fbf185882f060068979c642..020e33d976179e8f61a6040caaef3c8eb7f348bc 100644
GIT binary patch
delta 26
icmcc0eU*E|8y1!s?GB8S1zANWv$9q*GEZ(~4FLdtP6!MD

delta 26
icmcc0eU*E|8y1$&vmP)`7GxEj%*tBL$TYc;H3R^U@(CFL

diff --git a/lib/tzdata/zoneinfo/America/Montreal b/lib/tzdata/zoneinfo/America/Montreal
index fe6be8ea8c97db1c1d99c4198f4b9b024e3aba4c..668e70d765dc3fb0eda16fb0f1932af607b53412 100644
GIT binary patch
delta 55
ycmdnWyOnptUq-ECAN~WuHHG~TK=gIf6=41ihJ|4MP0=ne|CaHjgw5(qeJlV<{U&Ar

delta 55
ycmdnWyOnptUq-D}7ybjmHHF0oK=gIf9x(p~Lo1knQ#23EzhzwJuvwj{j|BiF#U%a!

diff --git a/lib/tzdata/zoneinfo/America/Nassau b/lib/tzdata/zoneinfo/America/Nassau
index fe6be8ea8c97db1c1d99c4198f4b9b024e3aba4c..668e70d765dc3fb0eda16fb0f1932af607b53412 100644
GIT binary patch
delta 55
ycmdnWyOnptUq-ECAN~WuHHG~TK=gIf6=41ihJ|4MP0=ne|CaHjgw5(qeJlV<{U&Ar

delta 55
ycmdnWyOnptUq-D}7ybjmHHF0oK=gIf9x(p~Lo1knQ#23EzhzwJuvwj{j|BiF#U%a!

diff --git a/lib/tzdata/zoneinfo/America/Nipigon b/lib/tzdata/zoneinfo/America/Nipigon
index fe6be8ea8c97db1c1d99c4198f4b9b024e3aba4c..668e70d765dc3fb0eda16fb0f1932af607b53412 100644
GIT binary patch
delta 55
ycmdnWyOnptUq-ECAN~WuHHG~TK=gIf6=41ihJ|4MP0=ne|CaHjgw5(qeJlV<{U&Ar

delta 55
ycmdnWyOnptUq-D}7ybjmHHF0oK=gIf9x(p~Lo1knQ#23EzhzwJuvwj{j|BiF#U%a!

diff --git a/lib/tzdata/zoneinfo/America/Nuuk b/lib/tzdata/zoneinfo/America/Nuuk
index 00b57bb13fbfa802e61f8b93d08622163a35a9a4..310774ea4fdd1798782a41f905d16e3548cd191e 100644
GIT binary patch
delta 13
UcmX@gew2Mf9Wx{I<a%Z|03m(^DF6Tf

delta 13
UcmX@gew2Mf9Wx`-<a%Z|03mq<C;$Ke

diff --git a/lib/tzdata/zoneinfo/America/Ojinaga b/lib/tzdata/zoneinfo/America/Ojinaga
index 2fc74e947389cf4371baece8ac66945df1b208fe..f7e40c08185080d9594d56add6a5c7c5874d0332 100644
GIT binary patch
delta 29
jcmX@gdX9BM7^CgR@E4363_y_F_Az0yJ(JDkDkg6Ll8^~s

delta 20
ccmX@ddX#lS7^BU`@E44e-I;7Aw=j7D08r-#EdT%j

diff --git a/lib/tzdata/zoneinfo/America/Santa_Isabel b/lib/tzdata/zoneinfo/America/Santa_Isabel
index e8be26b139e653e1b07a3db14ea34bd290441947..42087af4cceb049f1395cabaaa85b7c39253ed97 100644
GIT binary patch
delta 21
ccmZqVXyn-7!^~{Ex?!?Eb1Wm%<h9Hp07kY3SpWb4

delta 21
dcmZqVXyn-7!^}Kq^Mc9#%(0Bjlh-nb002!+2H^kz

diff --git a/lib/tzdata/zoneinfo/America/Scoresbysund b/lib/tzdata/zoneinfo/America/Scoresbysund
index 6db49124e2bb017f400ef94591ad3db137041094..fc1b11cbe876cabb53fc1d42db25b0aabd967fc0 100644
GIT binary patch
literal 984
zcmcJ}|4S2b9LMoH=V%OnxH5IMnblm=yv@69n%XwC<wkX9YG<wGTIL)DV?RhlKNJ>8
zKg5U&Mi3S)ihc-NzpVN}?F$hkn!m(|$|x8WeIW{yijeC*ul)i3)aUrz<DT&Oyg4a!
zIOe35T(o+EY_g=KuY}ZNT6Hsux<*e526C@dOtcYKx~d-%%gle$#PZTPnOLEDR&f44
zG~{o?RnOCK_2cu<I5EkP^QN&3th{suu1U(U>i8+RHa-N`^$o!Ff&|U(4p_}LLW{`?
zH<TElRqK<<eCvV>*1WgC+FUu@_+%NZ%l?M!^-s{2dIjwx)3E-?1mvQ(ARm6okhzYb
zEOdItp{wTtY^b~p8y&|AE)K&cV@f9Xn%?xIoBtj~w@mubn_maf?i&&48E=8!GwrZ-
z)CAjNX4pQ`%#e9o{93dxYD90fd_;Hn7SVp~6gpsjiw=DI0Jmu#6`Xwvx96|H9hsX@
zn0X+R`Qo`Gx^wI*dS@bm?n<6Uckek1d*Xv|*QPj>gaGWV=!Co3+Je707%cNMWPb3)
z3iRHE8g%IHPxQW=9^IE-4#U~6aR2Z;jHG7afk+PapZF}3c?VnXp$Eb<=xEhN^q?n$
zj_K~mbP-*w`5#Y_qI@|-QHqj(M-?l|kMFdOyeS>|GrB|&CCbJ*)Xh_M97pNhYIz;%
VoA<J!)81g`>TNtL@*F-n{XgVtt$P3f

delta 74
zcmcb?exI2&Bq}q_XriFlL<RPV3ak^=1sI_`CI+RA;S!9K^_i6>cQPBv7}^=yXd4*V
V>G&G!nd%wn8|e5N8h}}bTmZxI5f%Ud

diff --git a/lib/tzdata/zoneinfo/America/St_Johns b/lib/tzdata/zoneinfo/America/St_Johns
index e5f2aec2bb2b56dbdb66f0c0a00ba243ed788d58..94d790baaccb72298bb577041cf3c8400339a7da 100644
GIT binary patch
delta 29
lcmcb{ca3j@2^;hJ$Q6?v*`y~2uyIX}VVlaxJoyt_3ILka3CjQg

delta 29
lcmcb{ca3j@2^;e^UXRI+Y|@hh*tjOguuWxTnf!?@1ptm*2`2ym

diff --git a/lib/tzdata/zoneinfo/America/Thunder_Bay b/lib/tzdata/zoneinfo/America/Thunder_Bay
index fe6be8ea8c97db1c1d99c4198f4b9b024e3aba4c..668e70d765dc3fb0eda16fb0f1932af607b53412 100644
GIT binary patch
delta 55
ycmdnWyOnptUq-ECAN~WuHHG~TK=gIf6=41ihJ|4MP0=ne|CaHjgw5(qeJlV<{U&Ar

delta 55
ycmdnWyOnptUq-D}7ybjmHHF0oK=gIf9x(p~Lo1knQ#23EzhzwJuvwj{j|BiF#U%a!

diff --git a/lib/tzdata/zoneinfo/America/Tijuana b/lib/tzdata/zoneinfo/America/Tijuana
index e8be26b139e653e1b07a3db14ea34bd290441947..42087af4cceb049f1395cabaaa85b7c39253ed97 100644
GIT binary patch
delta 21
ccmZqVXyn-7!^~{Ex?!?Eb1Wm%<h9Hp07kY3SpWb4

delta 21
dcmZqVXyn-7!^}Kq^Mc9#%(0Bjlh-nb002!+2H^kz

diff --git a/lib/tzdata/zoneinfo/America/Toronto b/lib/tzdata/zoneinfo/America/Toronto
index fe6be8ea8c97db1c1d99c4198f4b9b024e3aba4c..668e70d765dc3fb0eda16fb0f1932af607b53412 100644
GIT binary patch
delta 55
ycmdnWyOnptUq-ECAN~WuHHG~TK=gIf6=41ihJ|4MP0=ne|CaHjgw5(qeJlV<{U&Ar

delta 55
ycmdnWyOnptUq-D}7ybjmHHF0oK=gIf9x(p~Lo1knQ#23EzhzwJuvwj{j|BiF#U%a!

diff --git a/lib/tzdata/zoneinfo/Antarctica/Casey b/lib/tzdata/zoneinfo/Antarctica/Casey
index 30315cc07893d4da19ffd04a655084908c369d29..84f1c61e5c7c35090fd2e628e307cff72389fb02 100644
GIT binary patch
delta 79
zcmey&IG<@k7^C3C@C-`^AV~1p9sr^fBbsbLbdt_YFhAKM1<X(3*vP=hga#*`R%A1<
Ju+z2R0sxFj4Z#2a

delta 35
icmbQw^qFx&7$eWb@C+VCCIp=LLy_Ik&`#ITkP85f+XmqP

diff --git a/lib/tzdata/zoneinfo/Antarctica/Macquarie b/lib/tzdata/zoneinfo/Antarctica/Macquarie
index 3fc1f231cb1d0e262f5940d8c322d35a66fff609..99a8e60edffca85f5caf8eda9d05d85a4978e665 100644
GIT binary patch
delta 29
lcmcb>et~_12{XIw<qM2Vj0}?<nFA*WFtai;O`gPT2LObu2i*Vw

delta 27
jcmcb>et~_12{Ze24+cgiMuy3b%mI`Anb{{#VzvVSX(k5w

diff --git a/lib/tzdata/zoneinfo/Antarctica/Troll b/lib/tzdata/zoneinfo/Antarctica/Troll
index 4e31affb50e350376824492ff086867df62ae130..2359c44bd00ed44d2cdbf4f0aa0d9cea507814ed 100644
GIT binary patch
delta 43
ncmdnUIFE5cm?9$s0|OHfa{w`e6R$f1NB{;{bPWt9cBumZa{UC(

delta 62
zcmbQoxRG%}m<baD0|PS<^8hh}6R$gnVsLU}oxsEhW&#Nr1x6Myn?u*YfI-{9XkxiK
E0N%X@#Q*>R

diff --git a/lib/tzdata/zoneinfo/Antarctica/Vostok b/lib/tzdata/zoneinfo/Antarctica/Vostok
index 69ff7f6fb4973efb1185cad9f553f8c770c75934..4ce8f74784e970731f5f44b84f73780087890fa5 100644
GIT binary patch
delta 91
zcmZo=T*WvcEQE!Dfq@x_dHw^z%ZSbfAe%wg*HQpP>uqfXQ4Fc|t_F+@j7(q-kVq<E
d0P1rKVBpX-FksL&Fb85&1}+;QX{T$-1puRD5byv1

delta 54
zcmZ3**vdE|OrMc~fq@B#IsOB|hJU+KfC51>Kmmr31O^r#-w+0E12YCL8z5<?YsLit
Dn)3}o

diff --git a/lib/tzdata/zoneinfo/Asia/Almaty b/lib/tzdata/zoneinfo/Asia/Almaty
index 3ec4fc89fe99d5ec414ca8f12909802b6133a595..02f047d70fc811f8cc17f2c08ddc1f328576fb94 100644
GIT binary patch
delta 42
wcmaFJ@``0b7^BI?@CA&V3_y_j;FtpAWI-m;$-GRmjEs}Dn2cCW?Q~7K00jyP9smFU

delta 26
icmaFG@{nah7^CsV@CA&M|1%m-HfAznHM7$-;{pJLn+QDs

diff --git a/lib/tzdata/zoneinfo/Asia/Gaza b/lib/tzdata/zoneinfo/Asia/Gaza
index 7e83389819c406774f07f97300106d665dbc12c1..0d79662716b445f61e5577bdb09e7c91e4a40d28 100644
GIT binary patch
delta 707
zcmXBQPe{{Y9LMo*{F=>DOFWFim48m5B~h_Uh2cR$Dbm(XQ3NGQ;6y>9!=6f{Zpyb>
zURt%xL+oH0gEGQR=bD?FZf?3M64W6oHY<?Hpq}UR+vWXxeZS9sdswn!&@^;;$BA*<
zx>iwZ5F|exl{Gmu?;&p9`IDOr<yw7!*k&+m+sBFfWn*c<PT8@0#9rCHEOAP<<%!@e
z*_t!NrXsVJeM4-K4YUci$?_+`{jyyh#7^0>WrDr3Wp@OpWWUuCZxxxFK7?==*P!37
z?(+Ph1%A=JfxErDx}nD8zAz2HI?@V{Hn`!}+8_CQyM8&Y-N1aha~SXO)!l-9|6H)&
zQX<sAf36pv*>fKInMesdTRI8P9=7WK+a=T>;GW2#nQ9f9E4E-imuMBr!JaDY9l`OS
zKKQ;L2R=_8g+t9jIP?Ia(9%hKVgAuR?867U;jndGzK$sT)&xg-e`6o{u?8>H55Nn<
zc{qAyuRKi@^$pl%92CuO3N?uJWN={d)TSaWj@0RnjlfG6Kf>|KI2^zERQFh;P=mxV
z7n~@(!+!a6qg_2L_j!bB^1u|FTyrW?YPUyP{+p>5t3KF%h65{8x8ap9mvZW1wYnhC
nw7@<+`WQ}o3%awNaOVAWJKr@{vCH_Chm7SMGalmm#qIwAn<LS;

delta 308
zcmZn@za~5(jFDwy_+4gU$<quVkS?S20Ze}=YMAWK@`k(F=LuM%IZR-(9;+C$ayL+%
zRhId~kA}(VK>GLshRN+fdY*g3<mEs*drQOQ<3QRehGFt^AT7z<FqxfAmibvh!(??J
zy;p)^vOAFOYGs(54x|%x8YZ^`Y4a-#la~W&R!4@($AR?i7Y&o2v&lMdngF(be%s*!
z5Mx38Uod}R{(Z1J7lkcp00}JiKM3Y8Q4s|5m+CJD^OyeG3AB&>t#!B-Sp3lc`CxMn
v>s|tBV>oh_2h2apQVEtnws<pG-?59&!2IK!<^_`(xfCYLb3K`C%pD8>WS3ir

diff --git a/lib/tzdata/zoneinfo/Asia/Hebron b/lib/tzdata/zoneinfo/Asia/Hebron
index fcf923bd283a4a6f21d789551c29ff5e2680108d..53a3c14312bc770bf9bca1d2e7518763fec7a485 100644
GIT binary patch
delta 707
zcmXBQPe{{Y9LMo*{92o3mUxiDnSTxuS`ksZR2Us3l%#Zek|L;~1Wxo49rh5Cb!&XH
z^wO+pJH!yn2+{~Q-PYRNbn{P}VI9h%WV5<V2K79j-!AXp>-&B7+rz$>43^$+-F9-k
zZ9^-mHVBd*TUk{W&3TF2w*TU0L$OvHAhsFI+SYO6e%W|Rut(N&n>Z-jn;~A8ZFnfy
zxWlYfogqFbn|V%LFB`Zd*e1*G1oz8!+K4@}XNv>}Ws7bJUYGq^O>8up&rODL7uOxX
zUEO8)o&|o=wT8Pry}YKz<ZhaVM-Df_qetEFGwqN3J>!Ps$~DZVJDhlrujU5q`{#oF
zmO`Nh{_{QX%&rUA&qNF1+1(TH>>;b}znwx20`8YtG+n7e!2%2R!DORQ4s};x?+A^D
z^udpPIPiYr2pp~t!Qs0Ig%?iX3m+cr#XeHr1xKu(<m-qcFG}HP&u{FbKUd+o+CF&B
znS*2Pd*o@Nn6J++<Dgh>Q>a0_JB<VLr#2O7eyB!wd<b5+_!dr-CE&#MLEWA@p$5rg
zE;yNgh5h2`I=gyU?DY!OrTtUz(&{5cTHfiEmjC8*gH<1FJ;s5RshjZ1mzJ!0_*j`2
oXi8w88XbUBuk*Sy9dP>1RXaOP6+CA8#>1v!{%ktH0|m|h0VA%_Qvd(}

delta 308
zcmbOs{z7;{7$e)p@VCsulBXF!AYDf31DO6$)G#@m<qdbU&l9jjbC|$nJ617f<!+!j
zt1R<}9}Sbsf%NeO43nn=>3QxAleYuu>@5wGuLEhP7>3E;fwUxZ!(?$bS>|U24U^4*
z^j-;u$>Bh{tCeALIgn1&X_!16NSj|_n7kcGvpO<Nz7C{szi62JolVwx(*&^f^V<#=
zfEWwv|AP4o^Y4S*xhQN&14v-8|3NT+iHabYzf^xQn7{PbPN044Z>__%z~YDg&j*`x
vSoac08^e*aJYfD&mP)YvvBjIg`i@<E2Ie2<G%uJe$fYn@pX=FVSMFc{dR$!s

diff --git a/lib/tzdata/zoneinfo/Asia/Ho_Chi_Minh b/lib/tzdata/zoneinfo/Asia/Ho_Chi_Minh
index de53596d6819e9e2d313be0ec246dc8d596ef812..86e21b0f524426287fb3b21a82369283c4040c0e 100644
GIT binary patch
delta 12
UcmaFE_=a)9RHjc8CQc6p04FyF0RR91

delta 12
UcmaFE_=a)9RHi2l6Q_p)04A{o;{X5v

diff --git a/lib/tzdata/zoneinfo/Asia/Nicosia b/lib/tzdata/zoneinfo/Asia/Nicosia
index c210d0a5989c228886b400ab74c75b6fca94b70a..390347f442a486e296689c189e3346695bba5105 100644
GIT binary patch
delta 25
hcmcc0a+PJnV@4L!*L)Wye`Hjj#Kg(SI9Y<p7661)2z~$n

delta 24
gcmcc0a+PJnV@4J;qY8n^9~spq|7YZ$EWu<80CepLZU6uP

diff --git a/lib/tzdata/zoneinfo/Asia/Qostanay b/lib/tzdata/zoneinfo/Asia/Qostanay
index ff6fe61d50757f9afe24eebe9aa2a9793c40eb18..109fe41562e89a026f828125f960498f62fb5d95 100644
GIT binary patch
delta 37
rcmaFP@_}VS7^BI?@CA$<3_y_j;F!YX?~KNbOp~>kELctLbWOPc<unR&

delta 26
icmeys@|<Nt7^CsV@CA&M|1%m-HfFM5HM7$-;{pJM@d!@<

diff --git a/lib/tzdata/zoneinfo/Asia/Saigon b/lib/tzdata/zoneinfo/Asia/Saigon
index de53596d6819e9e2d313be0ec246dc8d596ef812..86e21b0f524426287fb3b21a82369283c4040c0e 100644
GIT binary patch
delta 12
UcmaFE_=a)9RHjc8CQc6p04FyF0RR91

delta 12
UcmaFE_=a)9RHi2l6Q_p)04A{o;{X5v

diff --git a/lib/tzdata/zoneinfo/Canada/Eastern b/lib/tzdata/zoneinfo/Canada/Eastern
index fe6be8ea8c97db1c1d99c4198f4b9b024e3aba4c..668e70d765dc3fb0eda16fb0f1932af607b53412 100644
GIT binary patch
delta 55
ycmdnWyOnptUq-ECAN~WuHHG~TK=gIf6=41ihJ|4MP0=ne|CaHjgw5(qeJlV<{U&Ar

delta 55
ycmdnWyOnptUq-D}7ybjmHHF0oK=gIf9x(p~Lo1knQ#23EzhzwJuvwj{j|BiF#U%a!

diff --git a/lib/tzdata/zoneinfo/Canada/Newfoundland b/lib/tzdata/zoneinfo/Canada/Newfoundland
index e5f2aec2bb2b56dbdb66f0c0a00ba243ed788d58..94d790baaccb72298bb577041cf3c8400339a7da 100644
GIT binary patch
delta 29
lcmcb{ca3j@2^;hJ$Q6?v*`y~2uyIX}VVlaxJoyt_3ILka3CjQg

delta 29
lcmcb{ca3j@2^;e^UXRI+Y|@hh*tjOguuWxTnf!?@1ptm*2`2ym

diff --git a/lib/tzdata/zoneinfo/Europe/Belfast b/lib/tzdata/zoneinfo/Europe/Belfast
index 323cd3818ac6f77b4394982ea5a342b9ed262777..b9e95d92623c6cc4c35b16f7ceba3006f5ce4934 100644
GIT binary patch
delta 30
mcmdnbv!7=}Fe{6}a}|ckiL4rvAFy&w?qtnjWSabq)e``nbqVMI

delta 30
mcmdnbv!7=}Fe{5;>`j5miL4rvAFy&w?qtnjWSsns)e``rhzcVB

diff --git a/lib/tzdata/zoneinfo/Europe/Bucharest b/lib/tzdata/zoneinfo/Europe/Bucharest
index efa689ba9e0a782c9367f660a59060d9b1965345..c4a391e73b97e1342d352c5cc15a0bace202deef 100644
GIT binary patch
delta 27
jcmbQrI+b;UFcYiM$({#{lNFfsCL1uZGcr&1V{!)oag7H=

delta 25
hcmbQrI+b;UFcYh>?QQ|a$qG!mll7T6C;KtE0{~O_1{44Q

diff --git a/lib/tzdata/zoneinfo/Europe/Chisinau b/lib/tzdata/zoneinfo/Europe/Chisinau
index 6970b14c506c8119341052c2c142ac11b28a4917..9152e68594bb66cc756e0407654a203952fbd4e5 100644
GIT binary patch
delta 22
ecmey&`k8fuH4}@`$({$3?U}3@SteIARR92Fc?abH

delta 22
dcmey&`k8fuH4}@m?OKM(_Dt4{%#*8`Dgaed2ATi>

diff --git a/lib/tzdata/zoneinfo/Europe/Guernsey b/lib/tzdata/zoneinfo/Europe/Guernsey
index 323cd3818ac6f77b4394982ea5a342b9ed262777..b9e95d92623c6cc4c35b16f7ceba3006f5ce4934 100644
GIT binary patch
delta 30
mcmdnbv!7=}Fe{6}a}|ckiL4rvAFy&w?qtnjWSabq)e``nbqVMI

delta 30
mcmdnbv!7=}Fe{5;>`j5miL4rvAFy&w?qtnjWSsns)e``rhzcVB

diff --git a/lib/tzdata/zoneinfo/Europe/Isle_of_Man b/lib/tzdata/zoneinfo/Europe/Isle_of_Man
index 323cd3818ac6f77b4394982ea5a342b9ed262777..b9e95d92623c6cc4c35b16f7ceba3006f5ce4934 100644
GIT binary patch
delta 30
mcmdnbv!7=}Fe{6}a}|ckiL4rvAFy&w?qtnjWSabq)e``nbqVMI

delta 30
mcmdnbv!7=}Fe{5;>`j5miL4rvAFy&w?qtnjWSsns)e``rhzcVB

diff --git a/lib/tzdata/zoneinfo/Europe/Jersey b/lib/tzdata/zoneinfo/Europe/Jersey
index 323cd3818ac6f77b4394982ea5a342b9ed262777..b9e95d92623c6cc4c35b16f7ceba3006f5ce4934 100644
GIT binary patch
delta 30
mcmdnbv!7=}Fe{6}a}|ckiL4rvAFy&w?qtnjWSabq)e``nbqVMI

delta 30
mcmdnbv!7=}Fe{5;>`j5miL4rvAFy&w?qtnjWSsns)e``rhzcVB

diff --git a/lib/tzdata/zoneinfo/Europe/Kiev b/lib/tzdata/zoneinfo/Europe/Kiev
index 4e026859fdee32dd3f77a25274c5ccbebe0ee554..753a6c86f38586797589233f4528837f5b09151c 100644
GIT binary patch
delta 22
ecmZ3-vW{iLWJVUlX@LQgr!%TCvQOT}SO5T4c?U26

delta 22
ecmZ3-vW{iLWJVUFqAdcGr!%TCGELscSO5T4eg`W6

diff --git a/lib/tzdata/zoneinfo/Europe/Kyiv b/lib/tzdata/zoneinfo/Europe/Kyiv
index 4e026859fdee32dd3f77a25274c5ccbebe0ee554..753a6c86f38586797589233f4528837f5b09151c 100644
GIT binary patch
delta 22
ecmZ3-vW{iLWJVUlX@LQgr!%TCvQOT}SO5T4c?U26

delta 22
ecmZ3-vW{iLWJVUFqAdcGr!%TCGELscSO5T4eg`W6

diff --git a/lib/tzdata/zoneinfo/Europe/London b/lib/tzdata/zoneinfo/Europe/London
index 323cd3818ac6f77b4394982ea5a342b9ed262777..b9e95d92623c6cc4c35b16f7ceba3006f5ce4934 100644
GIT binary patch
delta 30
mcmdnbv!7=}Fe{6}a}|ckiL4rvAFy&w?qtnjWSabq)e``nbqVMI

delta 30
mcmdnbv!7=}Fe{5;>`j5miL4rvAFy&w?qtnjWSsns)e``rhzcVB

diff --git a/lib/tzdata/zoneinfo/Europe/Nicosia b/lib/tzdata/zoneinfo/Europe/Nicosia
index c210d0a5989c228886b400ab74c75b6fca94b70a..390347f442a486e296689c189e3346695bba5105 100644
GIT binary patch
delta 25
hcmcc0a+PJnV@4L!*L)Wye`Hjj#Kg(SI9Y<p7661)2z~$n

delta 24
gcmcc0a+PJnV@4J;qY8n^9~spq|7YZ$EWu<80CepLZU6uP

diff --git a/lib/tzdata/zoneinfo/Europe/Riga b/lib/tzdata/zoneinfo/Europe/Riga
index 26af4c90b3b75009916ac78884371bc2d8f5302d..d99170b6420d4b91ec0c0e4652136f765974e0d8 100644
GIT binary patch
delta 21
dcmdnSx{Y-M3lnp|-v^V~nM@d&C)+Sp0RT=D27CYj

delta 21
ccmdnSx{Y-M3lsBRXMxG=OeTyRlWmx)074A~WB>pF

diff --git a/lib/tzdata/zoneinfo/Europe/Sofia b/lib/tzdata/zoneinfo/Europe/Sofia
index eabc972a22df300bf90b8da8897155cbb9655a3b..89450685cd149950dc6d65d1b4f076d96c3dc9a0 100644
GIT binary patch
delta 30
kcmcb>a)D*TVMcDFlRXa@nV4CCaPkF46(%O8$zK>_0G!<k6#xJL

delta 31
lcmcb>a)D*TVMcCa+uZ_;Ow24mIQasjGBYa^>*OztF#wC@2k`&^

diff --git a/lib/tzdata/zoneinfo/Europe/Tallinn b/lib/tzdata/zoneinfo/Europe/Tallinn
index 5321bbd46e7a035956ac16584b13b397e192b5fe..fbebdc6255b547b1f3a547f0f92cc8148f05f186 100644
GIT binary patch
delta 21
dcmZ3?x|nstA4cX9nS{yz8I2iPCL1#q0030o2J`>`

delta 21
dcmZ3?x|nstA4cY7@e?NhXEbJHpKQ!j003O72b=%^

diff --git a/lib/tzdata/zoneinfo/Europe/Tiraspol b/lib/tzdata/zoneinfo/Europe/Tiraspol
index 6970b14c506c8119341052c2c142ac11b28a4917..9152e68594bb66cc756e0407654a203952fbd4e5 100644
GIT binary patch
delta 22
ecmey&`k8fuH4}@`$({$3?U}3@SteIARR92Fc?abH

delta 22
dcmey&`k8fuH4}@m?OKM(_Dt4{%#*8`Dgaed2ATi>

diff --git a/lib/tzdata/zoneinfo/Europe/Uzhgorod b/lib/tzdata/zoneinfo/Europe/Uzhgorod
index 4e026859fdee32dd3f77a25274c5ccbebe0ee554..753a6c86f38586797589233f4528837f5b09151c 100644
GIT binary patch
delta 22
ecmZ3-vW{iLWJVUlX@LQgr!%TCvQOT}SO5T4c?U26

delta 22
ecmZ3-vW{iLWJVUFqAdcGr!%TCGELscSO5T4eg`W6

diff --git a/lib/tzdata/zoneinfo/Europe/Vilnius b/lib/tzdata/zoneinfo/Europe/Vilnius
index 75b2eebb57c54ab1dba6416fb085cc8b6d3a1405..43c3d7f1089366e1c48297906c2693712ac6d99c 100644
GIT binary patch
delta 21
dcmZ3&x`cJZ7e;0w;e^TG8I2fOCTlTO0RT?F273Si

delta 21
dcmZ3&x`cJZ7e?kb#|e|aGa4~+Ox9wm0svU=2T=e3

diff --git a/lib/tzdata/zoneinfo/Europe/Zaporozhye b/lib/tzdata/zoneinfo/Europe/Zaporozhye
index 4e026859fdee32dd3f77a25274c5ccbebe0ee554..753a6c86f38586797589233f4528837f5b09151c 100644
GIT binary patch
delta 22
ecmZ3-vW{iLWJVUlX@LQgr!%TCvQOT}SO5T4c?U26

delta 22
ecmZ3-vW{iLWJVUFqAdcGr!%TCGELscSO5T4eg`W6

diff --git a/lib/tzdata/zoneinfo/GB b/lib/tzdata/zoneinfo/GB
index 323cd3818ac6f77b4394982ea5a342b9ed262777..b9e95d92623c6cc4c35b16f7ceba3006f5ce4934 100644
GIT binary patch
delta 30
mcmdnbv!7=}Fe{6}a}|ckiL4rvAFy&w?qtnjWSabq)e``nbqVMI

delta 30
mcmdnbv!7=}Fe{5;>`j5miL4rvAFy&w?qtnjWSsns)e``rhzcVB

diff --git a/lib/tzdata/zoneinfo/GB-Eire b/lib/tzdata/zoneinfo/GB-Eire
index 323cd3818ac6f77b4394982ea5a342b9ed262777..b9e95d92623c6cc4c35b16f7ceba3006f5ce4934 100644
GIT binary patch
delta 30
mcmdnbv!7=}Fe{6}a}|ckiL4rvAFy&w?qtnjWSabq)e``nbqVMI

delta 30
mcmdnbv!7=}Fe{5;>`j5miL4rvAFy&w?qtnjWSsns)e``rhzcVB

diff --git a/lib/tzdata/zoneinfo/Mexico/BajaNorte b/lib/tzdata/zoneinfo/Mexico/BajaNorte
index e8be26b139e653e1b07a3db14ea34bd290441947..42087af4cceb049f1395cabaaa85b7c39253ed97 100644
GIT binary patch
delta 21
ccmZqVXyn-7!^~{Ex?!?Eb1Wm%<h9Hp07kY3SpWb4

delta 21
dcmZqVXyn-7!^}Kq^Mc9#%(0Bjlh-nb002!+2H^kz

diff --git a/lib/tzdata/zoneinfo/Pacific/Norfolk b/lib/tzdata/zoneinfo/Pacific/Norfolk
index 79e2a9419adfef6279900d8453a361007fb665ed..0c0bdbda2a72022180bde561f6693268e27beb6b 100644
GIT binary patch
delta 83
zcmey)_?B@(6e}wO1B2AWcwGmHO#zHd%uFmS3=DHCfPxHj8yJA>g*zCy7#P-{U=(0r
en6-gH%*Qu`LEF&K&<I2t8vscoFljjPnj!%DcoEP5

delta 93
zcmaFM_?>Y=6e}A81B2YecwMg<>pw6uF*C8SGBC`o017h9ZD3$wU|6_=fs27*{Ru_^
o28LN17{nMDRvciI^6?E}&^9zQGy;*v20+pXOd5h%6VE6D02Kli1ONa4

diff --git a/lib/tzdata/zoneinfo/iso3166.tab b/lib/tzdata/zoneinfo/iso3166.tab
index be3348d1..402c015e 100644
--- a/lib/tzdata/zoneinfo/iso3166.tab
+++ b/lib/tzdata/zoneinfo/iso3166.tab
@@ -3,17 +3,22 @@
 # This file is in the public domain, so clarified as of
 # 2009-05-17 by Arthur David Olson.
 #
-# From Paul Eggert (2022-11-18):
+# From Paul Eggert (2023-09-06):
 # This file contains a table of two-letter country codes.  Columns are
 # separated by a single tab.  Lines beginning with '#' are comments.
 # All text uses UTF-8 encoding.  The columns of the table are as follows:
 #
 # 1.  ISO 3166-1 alpha-2 country code, current as of
-#     ISO 3166-1 N1087 (2022-09-02).  See: Updates on ISO 3166-1
-#     https://isotc.iso.org/livelink/livelink/Open/16944257
-# 2.  The usual English name for the coded region,
-#     chosen so that alphabetic sorting of subsets produces helpful lists.
-#     This is not the same as the English name in the ISO 3166 tables.
+#     ISO/TC 46 N1108 (2023-04-05).  See: ISO/TC 46 Documents
+#     https://www.iso.org/committee/48750.html?view=documents
+# 2.  The usual English name for the coded region.  This sometimes
+#     departs from ISO-listed names, sometimes so that sorted subsets
+#     of names are useful (e.g., "Samoa (American)" and "Samoa
+#     (western)" rather than "American Samoa" and "Samoa"),
+#     sometimes to avoid confusion among non-experts (e.g.,
+#     "Czech Republic" and "Turkey" rather than "Czechia" and "Türkiye"),
+#     and sometimes to omit needless detail or churn (e.g., "Netherlands"
+#     rather than "Netherlands (the)" or "Netherlands (Kingdom of the)").
 #
 # The table is sorted by country code.
 #
diff --git a/lib/tzdata/zoneinfo/leapseconds b/lib/tzdata/zoneinfo/leapseconds
index a6a170aa..ce150bfe 100644
--- a/lib/tzdata/zoneinfo/leapseconds
+++ b/lib/tzdata/zoneinfo/leapseconds
@@ -3,13 +3,10 @@
 # This file is in the public domain.
 
 # This file is generated automatically from the data in the public-domain
-# NIST format leap-seconds.list file, which can be copied from
-# <ftp://ftp.nist.gov/pub/time/leap-seconds.list>
-# or <ftp://ftp.boulder.nist.gov/pub/time/leap-seconds.list>.
-# The NIST file is used instead of its IERS upstream counterpart
+# NIST/IERS format leap-seconds.list file, which can be copied from
 # <https://hpiers.obspm.fr/iers/bul/bulc/ntp/leap-seconds.list>
-# because under US law the NIST file is public domain
-# whereas the IERS file's copyright and license status is unclear.
+# or, in a variant with different comments, from
+# <ftp://ftp.boulder.nist.gov/pub/time/leap-seconds.list>.
 # For more about leap-seconds.list, please see
 # The NTP Timescale and Leap Seconds
 # <https://www.eecis.udel.edu/~mills/leap.html>.
@@ -72,11 +69,11 @@ Leap	2016	Dec	31	23:59:60	+	S
 # Any additional leap seconds will come after this.
 # This Expires line is commented out for now,
 # so that pre-2020a zic implementations do not reject this file.
-#Expires 2023	Dec	28	00:00:00
+#Expires 2024	Dec	28	00:00:00
 
 # POSIX timestamps for the data in this file:
-#updated 1467936000 (2016-07-08 00:00:00 UTC)
-#expires 1703721600 (2023-12-28 00:00:00 UTC)
+#updated 1704708379 (2024-01-08 10:06:19 UTC)
+#expires 1735344000 (2024-12-28 00:00:00 UTC)
 
-#	Updated through IERS Bulletin C65
-#	File expires on:  28 December 2023
+#	Updated through IERS Bulletin C (https://hpiers.obspm.fr/iers/bul/bulc/bulletinc.dat)
+#	File expires on 28 December 2024
diff --git a/lib/tzdata/zoneinfo/tzdata.zi b/lib/tzdata/zoneinfo/tzdata.zi
index b522e395..be1c4085 100644
--- a/lib/tzdata/zoneinfo/tzdata.zi
+++ b/lib/tzdata/zoneinfo/tzdata.zi
@@ -1,4 +1,4 @@
-# version 2023c
+# version 2024a
 # This zic input file is in the public domain.
 R d 1916 o - Jun 14 23s 1 S
 R d 1916 1919 - O Su>=1 23s 0 -
@@ -22,27 +22,6 @@ R d 1978 o - Mar 24 1 1 S
 R d 1978 o - S 22 3 0 -
 R d 1980 o - Ap 25 0 1 S
 R d 1980 o - O 31 2 0 -
-Z Africa/Algiers 0:12:12 - LMT 1891 Mar 16
-0:9:21 - PMT 1911 Mar 11
-0 d WE%sT 1940 F 25 2
-1 d CE%sT 1946 O 7
-0 - WET 1956 Ja 29
-1 - CET 1963 Ap 14
-0 d WE%sT 1977 O 21
-1 d CE%sT 1979 O 26
-0 d WE%sT 1981 May
-1 - CET
-Z Atlantic/Cape_Verde -1:34:4 - LMT 1912 Ja 1 2u
--2 - -02 1942 S
--2 1 -01 1945 O 15
--2 - -02 1975 N 25 2
--1 - -01
-Z Africa/Ndjamena 1:0:12 - LMT 1912
-1 - WAT 1979 O 14
-1 1 WAST 1980 Mar 8
-1 - WAT
-Z Africa/Abidjan -0:16:8 - LMT 1912
-0 - GMT
 R K 1940 o - Jul 15 0 1 S
 R K 1940 o - O 1 0 0 -
 R K 1941 o - Ap 15 0 1 S
@@ -77,21 +56,6 @@ R K 2014 o - Jul 31 24 1 S
 R K 2014 o - S lastTh 24 0 -
 R K 2023 ma - Ap lastF 0 1 S
 R K 2023 ma - O lastTh 24 0 -
-Z Africa/Cairo 2:5:9 - LMT 1900 O
-2 K EE%sT
-Z Africa/Bissau -1:2:20 - LMT 1912 Ja 1 1u
--1 - -01 1975
-0 - GMT
-Z Africa/Nairobi 2:27:16 - LMT 1908 May
-2:30 - +0230 1928 Jun 30 24
-3 - EAT 1930 Ja 4 24
-2:30 - +0230 1936 D 31 24
-2:45 - +0245 1942 Jul 31 24
-3 - EAT
-Z Africa/Monrovia -0:43:8 - LMT 1882
--0:43:8 - MMT 1919 Mar
--0:44:30 - MMT 1972 Ja 7
-0 - GMT
 R L 1951 o - O 14 2 1 S
 R L 1952 o - Ja 1 0 0 -
 R L 1953 o - O 9 2 1 S
@@ -109,21 +73,10 @@ R L 1997 o - Ap 4 0 1 S
 R L 1997 o - O 4 0 0 -
 R L 2013 o - Mar lastF 1 1 S
 R L 2013 o - O lastF 2 0 -
-Z Africa/Tripoli 0:52:44 - LMT 1920
-1 L CE%sT 1959
-2 - EET 1982
-1 L CE%sT 1990 May 4
-2 - EET 1996 S 30
-1 L CE%sT 1997 O 4
-2 - EET 2012 N 10 2
-1 L CE%sT 2013 O 25 2
-2 - EET
 R MU 1982 o - O 10 0 1 -
 R MU 1983 o - Mar 21 0 0 -
 R MU 2008 o - O lastSu 2 1 -
 R MU 2009 o - Mar lastSu 2 0 -
-Z Indian/Mauritius 3:50 - LMT 1907
-4 MU +04/+05
 R M 1939 o - S 12 0 1 -
 R M 1939 o - N 19 0 0 -
 R M 1940 o - F 25 0 1 -
@@ -307,53 +260,15 @@ R M 2086 o - Ap 14 3 -1 -
 R M 2086 o - May 19 2 0 -
 R M 2087 o - Mar 30 3 -1 -
 R M 2087 o - May 11 2 0 -
-Z Africa/Casablanca -0:30:20 - LMT 1913 O 26
-0 M +00/+01 1984 Mar 16
-1 - +01 1986
-0 M +00/+01 2018 O 28 3
-1 M +01/+00
-Z Africa/El_Aaiun -0:52:48 - LMT 1934
--1 - -01 1976 Ap 14
-0 M +00/+01 2018 O 28 3
-1 M +01/+00
-Z Africa/Maputo 2:10:20 - LMT 1903 Mar
-2 - CAT
 R NA 1994 o - Mar 21 0 -1 WAT
 R NA 1994 2017 - S Su>=1 2 0 CAT
 R NA 1995 2017 - Ap Su>=1 2 -1 WAT
-Z Africa/Windhoek 1:8:24 - LMT 1892 F 8
-1:30 - +0130 1903 Mar
-2 - SAST 1942 S 20 2
-2 1 SAST 1943 Mar 21 2
-2 - SAST 1990 Mar 21
-2 NA %s
-Z Africa/Lagos 0:13:35 - LMT 1905 Jul
-0 - GMT 1908 Jul
-0:13:35 - LMT 1914
-0:30 - +0030 1919 S
-1 - WAT
-Z Africa/Sao_Tome 0:26:56 - LMT 1884
--0:36:45 - LMT 1912 Ja 1 0u
-0 - GMT 2018 Ja 1 1
-1 - WAT 2019 Ja 1 2
-0 - GMT
 R SA 1942 1943 - S Su>=15 2 1 -
 R SA 1943 1944 - Mar Su>=15 2 0 -
-Z Africa/Johannesburg 1:52 - LMT 1892 F 8
-1:30 - SAST 1903 Mar
-2 SA SAST
 R SD 1970 o - May 1 0 1 S
 R SD 1970 1985 - O 15 0 0 -
 R SD 1971 o - Ap 30 0 1 S
 R SD 1972 1985 - Ap lastSu 0 1 S
-Z Africa/Khartoum 2:10:8 - LMT 1931
-2 SD CA%sT 2000 Ja 15 12
-3 - EAT 2017 N
-2 - CAT
-Z Africa/Juba 2:6:28 - LMT 1931
-2 SD CA%sT 2000 Ja 15 12
-3 - EAT 2021 F
-2 - CAT
 R n 1939 o - Ap 15 23s 1 S
 R n 1939 o - N 18 23s 0 -
 R n 1940 o - F 25 23s 1 S
@@ -379,80 +294,14 @@ R n 2005 o - May 1 0s 1 S
 R n 2005 o - S 30 1s 0 -
 R n 2006 2008 - Mar lastSu 2s 1 S
 R n 2006 2008 - O lastSu 2s 0 -
-Z Africa/Tunis 0:40:44 - LMT 1881 May 12
-0:9:21 - PMT 1911 Mar 11
-1 n CE%sT
-Z Antarctica/Casey 0 - -00 1969
-8 - +08 2009 O 18 2
-11 - +11 2010 Mar 5 2
-8 - +08 2011 O 28 2
-11 - +11 2012 F 21 17u
-8 - +08 2016 O 22
-11 - +11 2018 Mar 11 4
-8 - +08 2018 O 7 4
-11 - +11 2019 Mar 17 3
-8 - +08 2019 O 4 3
-11 - +11 2020 Mar 8 3
-8 - +08 2020 O 4 0:1
-11 - +11
-Z Antarctica/Davis 0 - -00 1957 Ja 13
-7 - +07 1964 N
-0 - -00 1969 F
-7 - +07 2009 O 18 2
-5 - +05 2010 Mar 10 20u
-7 - +07 2011 O 28 2
-5 - +05 2012 F 21 20u
-7 - +07
-Z Antarctica/Mawson 0 - -00 1954 F 13
-6 - +06 2009 O 18 2
-5 - +05
 R Tr 2005 ma - Mar lastSu 1u 2 +02
 R Tr 2004 ma - O lastSu 1u 0 +00
-Z Antarctica/Troll 0 - -00 2005 F 12
-0 Tr %s
-Z Antarctica/Rothera 0 - -00 1976 D
--3 - -03
-Z Asia/Kabul 4:36:48 - LMT 1890
-4 - +04 1945
-4:30 - +0430
 R AM 2011 o - Mar lastSu 2s 1 -
 R AM 2011 o - O lastSu 2s 0 -
-Z Asia/Yerevan 2:58 - LMT 1924 May 2
-3 - +03 1957 Mar
-4 R +04/+05 1991 Mar 31 2s
-3 R +03/+04 1995 S 24 2s
-4 - +04 1997
-4 R +04/+05 2011
-4 AM +04/+05
 R AZ 1997 2015 - Mar lastSu 4 1 -
 R AZ 1997 2015 - O lastSu 5 0 -
-Z Asia/Baku 3:19:24 - LMT 1924 May 2
-3 - +03 1957 Mar
-4 R +04/+05 1991 Mar 31 2s
-3 R +03/+04 1992 S lastSu 2s
-4 - +04 1996
-4 E +04/+05 1997
-4 AZ +04/+05
 R BD 2009 o - Jun 19 23 1 -
 R BD 2009 o - D 31 24 0 -
-Z Asia/Dhaka 6:1:40 - LMT 1890
-5:53:20 - HMT 1941 O
-6:30 - +0630 1942 May 15
-5:30 - +0530 1942 S
-6:30 - +0630 1951 S 30
-6 - +06 2009
-6 BD +06/+07
-Z Asia/Thimphu 5:58:36 - LMT 1947 Au 15
-5:30 - +0530 1987 O
-6 - +06
-Z Indian/Chagos 4:49:40 - LMT 1907
-5 - +05 1996
-6 - +06
-Z Asia/Yangon 6:24:47 - LMT 1880
-6:24:47 - RMT 1920
-6:30 - +0630 1942 May
-9 - +09 1945 May 3
-6:30 - +0630
 R Sh 1919 o - Ap 12 24 1 D
 R Sh 1919 o - S 30 24 0 S
 R Sh 1940 o - Jun 1 0 1 D
@@ -470,11 +319,6 @@ R Sh 1948 1949 - S 30 24 0 S
 R CN 1986 o - May 4 2 1 D
 R CN 1986 1991 - S Su>=11 2 0 S
 R CN 1987 1991 - Ap Su>=11 2 1 D
-Z Asia/Shanghai 8:5:43 - LMT 1901
-8 Sh C%sT 1949 May 28
-8 CN C%sT
-Z Asia/Urumqi 5:50:20 - LMT 1928
-6 - +06
 R HK 1946 o - Ap 21 0 1 S
 R HK 1946 o - D 1 3:30s 0 -
 R HK 1947 o - Ap 13 3:30s 1 S
@@ -489,12 +333,6 @@ R HK 1965 1976 - O Su>=16 3:30 0 -
 R HK 1973 o - D 30 3:30 1 S
 R HK 1979 o - May 13 3:30 1 S
 R HK 1979 o - O 21 3:30 0 -
-Z Asia/Hong_Kong 7:36:42 - LMT 1904 O 29 17u
-8 - HKT 1941 Jun 15 3
-8 1 HKST 1941 O 1 4
-8 0:30 HKWT 1941 D 25
-9 - JST 1945 N 18 2
-8 HK HK%sT
 R f 1946 o - May 15 0 1 D
 R f 1946 o - O 1 0 0 S
 R f 1947 o - Ap 15 0 1 D
@@ -510,10 +348,6 @@ R f 1974 1975 - Ap 1 0 1 D
 R f 1974 1975 - O 1 0 0 S
 R f 1979 o - Jul 1 0 1 D
 R f 1979 o - O 1 0 0 S
-Z Asia/Taipei 8:6 - LMT 1896
-8 - CST 1937 O
-9 - JST 1945 S 21 1
-8 f C%sT
 R _ 1942 1943 - Ap 30 23 1 -
 R _ 1942 o - N 17 23 0 -
 R _ 1943 o - S 30 23 0 S
@@ -541,10 +375,6 @@ R _ 1973 o - D 30 3:30 1 D
 R _ 1975 1976 - Ap Su>=16 3:30 1 D
 R _ 1979 o - May 13 3:30 1 D
 R _ 1979 o - O Su>=16 3:30 0 S
-Z Asia/Macau 7:34:10 - LMT 1904 O 30
-8 - CST 1941 D 21 23
-9 _ +09/+10 1945 S 30 24
-8 _ C%sT
 R CY 1975 o - Ap 13 0 1 S
 R CY 1975 o - O 12 0 0 -
 R CY 1976 o - May 15 0 1 S
@@ -554,65 +384,6 @@ R CY 1977 o - S 25 0 0 -
 R CY 1978 o - O 2 0 0 -
 R CY 1979 1997 - S lastSu 0 0 -
 R CY 1981 1998 - Mar lastSu 0 1 S
-Z Asia/Nicosia 2:13:28 - LMT 1921 N 14
-2 CY EE%sT 1998 S
-2 E EE%sT
-Z Asia/Famagusta 2:15:48 - LMT 1921 N 14
-2 CY EE%sT 1998 S
-2 E EE%sT 2016 S 8
-3 - +03 2017 O 29 1u
-2 E EE%sT
-Z Asia/Tbilisi 2:59:11 - LMT 1880
-2:59:11 - TBMT 1924 May 2
-3 - +03 1957 Mar
-4 R +04/+05 1991 Mar 31 2s
-3 R +03/+04 1992
-3 e +03/+04 1994 S lastSu
-4 e +04/+05 1996 O lastSu
-4 1 +05 1997 Mar lastSu
-4 e +04/+05 2004 Jun 27
-3 R +03/+04 2005 Mar lastSu 2
-4 - +04
-Z Asia/Dili 8:22:20 - LMT 1912
-8 - +08 1942 F 21 23
-9 - +09 1976 May 3
-8 - +08 2000 S 17
-9 - +09
-Z Asia/Kolkata 5:53:28 - LMT 1854 Jun 28
-5:53:20 - HMT 1870
-5:21:10 - MMT 1906
-5:30 - IST 1941 O
-5:30 1 +0630 1942 May 15
-5:30 - IST 1942 S
-5:30 1 +0630 1945 O 15
-5:30 - IST
-Z Asia/Jakarta 7:7:12 - LMT 1867 Au 10
-7:7:12 - BMT 1923 D 31 16:40u
-7:20 - +0720 1932 N
-7:30 - +0730 1942 Mar 23
-9 - +09 1945 S 23
-7:30 - +0730 1948 May
-8 - +08 1950 May
-7:30 - +0730 1964
-7 - WIB
-Z Asia/Pontianak 7:17:20 - LMT 1908 May
-7:17:20 - PMT 1932 N
-7:30 - +0730 1942 Ja 29
-9 - +09 1945 S 23
-7:30 - +0730 1948 May
-8 - +08 1950 May
-7:30 - +0730 1964
-8 - WITA 1988
-7 - WIB
-Z Asia/Makassar 7:57:36 - LMT 1920
-7:57:36 - MMT 1932 N
-8 - +08 1942 F 9
-9 - +09 1945 S 23
-8 - WITA
-Z Asia/Jayapura 9:22:48 - LMT 1932 N
-9 - +09 1944 S
-9:30 - +0930 1964
-9 - WIT
 R i 1910 o - Ja 1 0 0 -
 R i 1977 o - Mar 21 23 1 -
 R i 1977 o - O 20 24 0 -
@@ -653,11 +424,6 @@ R i 2020 o - Mar 20 24 1 -
 R i 2020 o - S 20 24 0 -
 R i 2021 2022 - Mar 21 24 1 -
 R i 2021 2022 - S 21 24 0 -
-Z Asia/Tehran 3:25:44 - LMT 1916
-3:25:44 - TMT 1935 Jun 13
-3:30 i +0330/+0430 1977 O 20 24
-4 i +04/+05 1979
-3:30 i +0330/+0430
 R IQ 1982 o - May 1 0 1 -
 R IQ 1982 1984 - O 1 0 0 -
 R IQ 1983 o - Mar 31 0 1 -
@@ -666,10 +432,6 @@ R IQ 1985 1990 - S lastSu 1s 0 -
 R IQ 1986 1990 - Mar lastSu 1s 1 -
 R IQ 1991 2007 - Ap 1 3s 1 -
 R IQ 1991 2007 - O 1 3s 0 -
-Z Asia/Baghdad 2:57:40 - LMT 1890
-2:57:36 - BMT 1918
-3 - +03 1982 May
-3 IQ +03/+04
 R Z 1940 o - May 31 24u 1 D
 R Z 1940 o - S 30 24u 0 S
 R Z 1940 o - N 16 24u 1 D
@@ -755,15 +517,10 @@ R Z 2011 o - O 2 2 0 S
 R Z 2012 o - S 23 2 0 S
 R Z 2013 ma - Mar F>=23 2 1 D
 R Z 2013 ma - O lastSu 2 0 S
-Z Asia/Jerusalem 2:20:54 - LMT 1880
-2:20:40 - JMT 1918
-2 Z I%sT
 R JP 1948 o - May Sa>=1 24 1 D
 R JP 1948 1951 - S Sa>=8 25 0 S
 R JP 1949 o - Ap Sa>=1 24 1 D
 R JP 1950 1951 - May Sa>=1 24 1 D
-Z Asia/Tokyo 9:18:59 - LMT 1887 D 31 15u
-9 JP J%sT
 R J 1973 o - Jun 6 0 1 S
 R J 1973 1975 - O 1 0 0 -
 R J 1974 1977 - May 1 0 1 S
@@ -796,83 +553,10 @@ R J 2013 o - D 20 0 0 -
 R J 2014 2021 - Mar lastTh 24 1 S
 R J 2014 2022 - O lastF 0s 0 -
 R J 2022 o - F lastTh 24 1 S
-Z Asia/Amman 2:23:44 - LMT 1931
-2 J EE%sT 2022 O 28 0s
-3 - +03
-Z Asia/Almaty 5:7:48 - LMT 1924 May 2
-5 - +05 1930 Jun 21
-6 R +06/+07 1991 Mar 31 2s
-5 R +05/+06 1992 Ja 19 2s
-6 R +06/+07 2004 O 31 2s
-6 - +06
-Z Asia/Qyzylorda 4:21:52 - LMT 1924 May 2
-4 - +04 1930 Jun 21
-5 - +05 1981 Ap
-5 1 +06 1981 O
-6 - +06 1982 Ap
-5 R +05/+06 1991 Mar 31 2s
-4 R +04/+05 1991 S 29 2s
-5 R +05/+06 1992 Ja 19 2s
-6 R +06/+07 1992 Mar 29 2s
-5 R +05/+06 2004 O 31 2s
-6 - +06 2018 D 21
-5 - +05
-Z Asia/Qostanay 4:14:28 - LMT 1924 May 2
-4 - +04 1930 Jun 21
-5 - +05 1981 Ap
-5 1 +06 1981 O
-6 - +06 1982 Ap
-5 R +05/+06 1991 Mar 31 2s
-4 R +04/+05 1992 Ja 19 2s
-5 R +05/+06 2004 O 31 2s
-6 - +06
-Z Asia/Aqtobe 3:48:40 - LMT 1924 May 2
-4 - +04 1930 Jun 21
-5 - +05 1981 Ap
-5 1 +06 1981 O
-6 - +06 1982 Ap
-5 R +05/+06 1991 Mar 31 2s
-4 R +04/+05 1992 Ja 19 2s
-5 R +05/+06 2004 O 31 2s
-5 - +05
-Z Asia/Aqtau 3:21:4 - LMT 1924 May 2
-4 - +04 1930 Jun 21
-5 - +05 1981 O
-6 - +06 1982 Ap
-5 R +05/+06 1991 Mar 31 2s
-4 R +04/+05 1992 Ja 19 2s
-5 R +05/+06 1994 S 25 2s
-4 R +04/+05 2004 O 31 2s
-5 - +05
-Z Asia/Atyrau 3:27:44 - LMT 1924 May 2
-3 - +03 1930 Jun 21
-5 - +05 1981 O
-6 - +06 1982 Ap
-5 R +05/+06 1991 Mar 31 2s
-4 R +04/+05 1992 Ja 19 2s
-5 R +05/+06 1999 Mar 28 2s
-4 R +04/+05 2004 O 31 2s
-5 - +05
-Z Asia/Oral 3:25:24 - LMT 1924 May 2
-3 - +03 1930 Jun 21
-5 - +05 1981 Ap
-5 1 +06 1981 O
-6 - +06 1982 Ap
-5 R +05/+06 1989 Mar 26 2s
-4 R +04/+05 1992 Ja 19 2s
-5 R +05/+06 1992 Mar 29 2s
-4 R +04/+05 2004 O 31 2s
-5 - +05
 R KG 1992 1996 - Ap Su>=7 0s 1 -
 R KG 1992 1996 - S lastSu 0 0 -
 R KG 1997 2005 - Mar lastSu 2:30 1 -
 R KG 1997 2004 - O lastSu 2:30 0 -
-Z Asia/Bishkek 4:58:24 - LMT 1924 May 2
-5 - +05 1930 Jun 21
-6 R +06/+07 1991 Mar 31 2s
-5 R +05/+06 1991 Au 31 2
-5 KG +05/+06 2005 Au 12
-6 - +06
 R KR 1948 o - Jun 1 0 1 D
 R KR 1948 o - S 12 24 0 S
 R KR 1949 o - Ap 3 0 1 D
@@ -887,18 +571,6 @@ R KR 1957 1960 - May Su>=1 0 1 D
 R KR 1957 1960 - S Sa>=17 24 0 S
 R KR 1987 1988 - May Su>=8 2 1 D
 R KR 1987 1988 - O Su>=8 3 0 S
-Z Asia/Seoul 8:27:52 - LMT 1908 Ap
-8:30 - KST 1912
-9 - JST 1945 S 8
-9 KR K%sT 1954 Mar 21
-8:30 KR K%sT 1961 Au 10
-9 KR K%sT
-Z Asia/Pyongyang 8:23 - LMT 1908 Ap
-8:30 - KST 1912
-9 - JST 1945 Au 24
-9 - KST 2015 Au 15
-8:30 - KST 2018 May 4 23:30
-9 - KST
 R l 1920 o - Mar 28 0 1 S
 R l 1920 o - O 25 0 0 -
 R l 1921 o - Ap 3 0 1 S
@@ -923,18 +595,8 @@ R l 1992 o - O 4 0 0 -
 R l 1993 ma - Mar lastSu 0 1 S
 R l 1993 1998 - S lastSu 0 0 -
 R l 1999 ma - O lastSu 0 0 -
-Z Asia/Beirut 2:22 - LMT 1880
-2 l EE%sT
 R NB 1935 1941 - S 14 0 0:20 -
 R NB 1935 1941 - D 14 0 0 -
-Z Asia/Kuching 7:21:20 - LMT 1926 Mar
-7:30 - +0730 1933
-8 NB +08/+0820 1942 F 16
-9 - +09 1945 S 12
-8 - +08
-Z Indian/Maldives 4:54 - LMT 1880
-4:54 - MMT 1960
-5 - +05
 R X 1983 1984 - Ap 1 0 1 -
 R X 1983 o - O 1 0 0 -
 R X 1985 1998 - Mar lastSu 0 1 -
@@ -944,31 +606,11 @@ R X 2001 2006 - S lastSa 2 0 -
 R X 2002 2006 - Mar lastSa 2 1 -
 R X 2015 2016 - Mar lastSa 2 1 -
 R X 2015 2016 - S lastSa 0 0 -
-Z Asia/Hovd 6:6:36 - LMT 1905 Au
-6 - +06 1978
-7 X +07/+08
-Z Asia/Ulaanbaatar 7:7:32 - LMT 1905 Au
-7 - +07 1978
-8 X +08/+09
-Z Asia/Choibalsan 7:38 - LMT 1905 Au
-7 - +07 1978
-8 - +08 1983 Ap
-9 X +09/+10 2008 Mar 31
-8 X +08/+09
-Z Asia/Kathmandu 5:41:16 - LMT 1920
-5:30 - +0530 1986
-5:45 - +0545
 R PK 2002 o - Ap Su>=2 0 1 S
 R PK 2002 o - O Su>=2 0 0 -
 R PK 2008 o - Jun 1 0 1 S
 R PK 2008 2009 - N 1 0 0 -
 R PK 2009 o - Ap 15 0 1 S
-Z Asia/Karachi 4:28:12 - LMT 1907
-5:30 - +0530 1942 S
-5:30 1 +0630 1945 O 15
-5:30 - +0530 1951 S 30
-5 - +05 1971 Mar 26
-5 PK PK%sT
 R P 1999 2005 - Ap F>=15 0 1 S
 R P 1999 2003 - O F>=15 0 0 -
 R P 2004 o - O 1 1 0 -
@@ -1001,136 +643,90 @@ R P 2021 o - O 29 1 0 -
 R P 2022 o - Mar 27 0 1 S
 R P 2022 2035 - O Sa<=30 2 0 -
 R P 2023 o - Ap 29 2 1 S
-R P 2024 o - Ap 13 2 1 S
-R P 2025 o - Ap 5 2 1 S
+R P 2024 o - Ap 20 2 1 S
+R P 2025 o - Ap 12 2 1 S
 R P 2026 2054 - Mar Sa<=30 2 1 S
 R P 2036 o - O 18 2 0 -
 R P 2037 o - O 10 2 0 -
 R P 2038 o - S 25 2 0 -
 R P 2039 o - S 17 2 0 -
-R P 2039 o - O 22 2 1 S
-R P 2039 2067 - O Sa<=30 2 0 -
 R P 2040 o - S 1 2 0 -
-R P 2040 o - O 13 2 1 S
+R P 2040 o - O 20 2 1 S
+R P 2040 2067 - O Sa<=30 2 0 -
 R P 2041 o - Au 24 2 0 -
-R P 2041 o - S 28 2 1 S
+R P 2041 o - O 5 2 1 S
 R P 2042 o - Au 16 2 0 -
-R P 2042 o - S 20 2 1 S
+R P 2042 o - S 27 2 1 S
 R P 2043 o - Au 1 2 0 -
-R P 2043 o - S 12 2 1 S
+R P 2043 o - S 19 2 1 S
 R P 2044 o - Jul 23 2 0 -
-R P 2044 o - Au 27 2 1 S
+R P 2044 o - S 3 2 1 S
 R P 2045 o - Jul 15 2 0 -
-R P 2045 o - Au 19 2 1 S
+R P 2045 o - Au 26 2 1 S
 R P 2046 o - Jun 30 2 0 -
-R P 2046 o - Au 11 2 1 S
+R P 2046 o - Au 18 2 1 S
 R P 2047 o - Jun 22 2 0 -
-R P 2047 o - Jul 27 2 1 S
+R P 2047 o - Au 3 2 1 S
 R P 2048 o - Jun 6 2 0 -
-R P 2048 o - Jul 18 2 1 S
+R P 2048 o - Jul 25 2 1 S
 R P 2049 o - May 29 2 0 -
-R P 2049 o - Jul 3 2 1 S
+R P 2049 o - Jul 10 2 1 S
 R P 2050 o - May 21 2 0 -
-R P 2050 o - Jun 25 2 1 S
+R P 2050 o - Jul 2 2 1 S
 R P 2051 o - May 6 2 0 -
-R P 2051 o - Jun 17 2 1 S
+R P 2051 o - Jun 24 2 1 S
 R P 2052 o - Ap 27 2 0 -
-R P 2052 o - Jun 1 2 1 S
+R P 2052 o - Jun 8 2 1 S
 R P 2053 o - Ap 12 2 0 -
-R P 2053 o - May 24 2 1 S
+R P 2053 o - May 31 2 1 S
 R P 2054 o - Ap 4 2 0 -
-R P 2054 o - May 16 2 1 S
-R P 2055 o - May 1 2 1 S
-R P 2056 o - Ap 22 2 1 S
-R P 2057 o - Ap 7 2 1 S
-R P 2058 ma - Mar Sa<=30 2 1 S
+R P 2054 o - May 23 2 1 S
+R P 2055 o - May 8 2 1 S
+R P 2056 o - Ap 29 2 1 S
+R P 2057 o - Ap 14 2 1 S
+R P 2058 o - Ap 6 2 1 S
+R P 2059 ma - Mar Sa<=30 2 1 S
 R P 2068 o - O 20 2 0 -
 R P 2069 o - O 12 2 0 -
 R P 2070 o - O 4 2 0 -
 R P 2071 o - S 19 2 0 -
 R P 2072 o - S 10 2 0 -
-R P 2072 o - O 15 2 1 S
+R P 2072 o - O 22 2 1 S
+R P 2072 ma - O Sa<=30 2 0 -
 R P 2073 o - S 2 2 0 -
-R P 2073 o - O 7 2 1 S
+R P 2073 o - O 14 2 1 S
 R P 2074 o - Au 18 2 0 -
-R P 2074 o - S 29 2 1 S
+R P 2074 o - O 6 2 1 S
 R P 2075 o - Au 10 2 0 -
-R P 2075 o - S 14 2 1 S
-R P 2075 ma - O Sa<=30 2 0 -
+R P 2075 o - S 21 2 1 S
 R P 2076 o - Jul 25 2 0 -
-R P 2076 o - S 5 2 1 S
+R P 2076 o - S 12 2 1 S
 R P 2077 o - Jul 17 2 0 -
-R P 2077 o - Au 28 2 1 S
+R P 2077 o - S 4 2 1 S
 R P 2078 o - Jul 9 2 0 -
-R P 2078 o - Au 13 2 1 S
+R P 2078 o - Au 20 2 1 S
 R P 2079 o - Jun 24 2 0 -
-R P 2079 o - Au 5 2 1 S
+R P 2079 o - Au 12 2 1 S
 R P 2080 o - Jun 15 2 0 -
-R P 2080 o - Jul 20 2 1 S
+R P 2080 o - Jul 27 2 1 S
 R P 2081 o - Jun 7 2 0 -
-R P 2081 o - Jul 12 2 1 S
+R P 2081 o - Jul 19 2 1 S
 R P 2082 o - May 23 2 0 -
-R P 2082 o - Jul 4 2 1 S
+R P 2082 o - Jul 11 2 1 S
 R P 2083 o - May 15 2 0 -
-R P 2083 o - Jun 19 2 1 S
+R P 2083 o - Jun 26 2 1 S
 R P 2084 o - Ap 29 2 0 -
-R P 2084 o - Jun 10 2 1 S
+R P 2084 o - Jun 17 2 1 S
 R P 2085 o - Ap 21 2 0 -
-R P 2085 o - Jun 2 2 1 S
+R P 2085 o - Jun 9 2 1 S
 R P 2086 o - Ap 13 2 0 -
-R P 2086 o - May 18 2 1 S
-Z Asia/Gaza 2:17:52 - LMT 1900 O
-2 Z EET/EEST 1948 May 15
-2 K EE%sT 1967 Jun 5
-2 Z I%sT 1996
-2 J EE%sT 1999
-2 P EE%sT 2008 Au 29
-2 - EET 2008 S
-2 P EE%sT 2010
-2 - EET 2010 Mar 27 0:1
-2 P EE%sT 2011 Au
-2 - EET 2012
-2 P EE%sT
-Z Asia/Hebron 2:20:23 - LMT 1900 O
-2 Z EET/EEST 1948 May 15
-2 K EE%sT 1967 Jun 5
-2 Z I%sT 1996
-2 J EE%sT 1999
-2 P EE%sT
+R P 2086 o - May 25 2 1 S
 R PH 1936 o - N 1 0 1 D
 R PH 1937 o - F 1 0 0 S
 R PH 1954 o - Ap 12 0 1 D
 R PH 1954 o - Jul 1 0 0 S
 R PH 1978 o - Mar 22 0 1 D
 R PH 1978 o - S 21 0 0 S
-Z Asia/Manila -15:56 - LMT 1844 D 31
-8:4 - LMT 1899 May 11
-8 PH P%sT 1942 May
-9 - JST 1944 N
-8 PH P%sT
-Z Asia/Qatar 3:26:8 - LMT 1920
-4 - +04 1972 Jun
-3 - +03
-Z Asia/Riyadh 3:6:52 - LMT 1947 Mar 14
-3 - +03
-Z Asia/Singapore 6:55:25 - LMT 1901
-6:55:25 - SMT 1905 Jun
-7 - +07 1933
-7 0:20 +0720 1936
-7:20 - +0720 1941 S
-7:30 - +0730 1942 F 16
-9 - +09 1945 S 12
-7:30 - +0730 1981 D 31 16u
-8 - +08
-Z Asia/Colombo 5:19:24 - LMT 1880
-5:19:32 - MMT 1906
-5:30 - +0530 1942 Ja 5
-5:30 0:30 +06 1942 S
-5:30 1 +0630 1945 O 16 2
-5:30 - +0530 1996 May 25
-6:30 - +0630 1996 O 26 0:30
-6 - +06 2006 Ap 15 0:30
-5:30 - +0530
 R S 1920 1923 - Ap Su>=15 2 1 S
 R S 1920 1923 - O Su>=1 2 0 -
 R S 1962 o - Ap 29 2 1 S
@@ -1172,46 +768,6 @@ R S 2009 o - Mar lastF 0 1 S
 R S 2010 2011 - Ap F>=1 0 1 S
 R S 2012 2022 - Mar lastF 0 1 S
 R S 2009 2022 - O lastF 0 0 -
-Z Asia/Damascus 2:25:12 - LMT 1920
-2 S EE%sT 2022 O 28
-3 - +03
-Z Asia/Dushanbe 4:35:12 - LMT 1924 May 2
-5 - +05 1930 Jun 21
-6 R +06/+07 1991 Mar 31 2s
-5 1 +06 1991 S 9 2s
-5 - +05
-Z Asia/Bangkok 6:42:4 - LMT 1880
-6:42:4 - BMT 1920 Ap
-7 - +07
-Z Asia/Ashgabat 3:53:32 - LMT 1924 May 2
-4 - +04 1930 Jun 21
-5 R +05/+06 1991 Mar 31 2
-4 R +04/+05 1992 Ja 19 2
-5 - +05
-Z Asia/Dubai 3:41:12 - LMT 1920
-4 - +04
-Z Asia/Samarkand 4:27:53 - LMT 1924 May 2
-4 - +04 1930 Jun 21
-5 - +05 1981 Ap
-5 1 +06 1981 O
-6 - +06 1982 Ap
-5 R +05/+06 1992
-5 - +05
-Z Asia/Tashkent 4:37:11 - LMT 1924 May 2
-5 - +05 1930 Jun 21
-6 R +06/+07 1991 Mar 31 2
-5 R +05/+06 1992
-5 - +05
-Z Asia/Ho_Chi_Minh 7:6:30 - LMT 1906 Jul
-7:6:30 - PLMT 1911 May
-7 - +07 1942 D 31 23
-8 - +08 1945 Mar 14 23
-9 - +09 1945 S 2
-7 - +07 1947 Ap
-8 - +08 1955 Jul
-7 - +07 1959 D 31 23
-8 - +08 1975 Jun 13
-7 - +07
 R AU 1917 o - Ja 1 2s 1 D
 R AU 1917 o - Mar lastSu 2s 0 S
 R AU 1942 o - Ja 1 2s 1 D
@@ -1219,9 +775,6 @@ R AU 1942 o - Mar lastSu 2s 0 S
 R AU 1942 o - S 27 2s 1 D
 R AU 1943 1944 - Mar lastSu 2s 0 S
 R AU 1943 o - O 3 2s 1 D
-Z Australia/Darwin 8:43:20 - LMT 1895 F
-9 - ACST 1899 May
-9:30 AU AC%sT
 R AW 1974 o - O lastSu 2s 1 D
 R AW 1975 o - Mar Su>=1 2s 0 S
 R AW 1983 o - O lastSu 2s 1 D
@@ -1231,25 +784,12 @@ R AW 1992 o - Mar Su>=1 2s 0 S
 R AW 2006 o - D 3 2s 1 D
 R AW 2007 2009 - Mar lastSu 2s 0 S
 R AW 2007 2008 - O lastSu 2s 1 D
-Z Australia/Perth 7:43:24 - LMT 1895 D
-8 AU AW%sT 1943 Jul
-8 AW AW%sT
-Z Australia/Eucla 8:35:28 - LMT 1895 D
-8:45 AU +0845/+0945 1943 Jul
-8:45 AW +0845/+0945
 R AQ 1971 o - O lastSu 2s 1 D
 R AQ 1972 o - F lastSu 2s 0 S
 R AQ 1989 1991 - O lastSu 2s 1 D
 R AQ 1990 1992 - Mar Su>=1 2s 0 S
 R Ho 1992 1993 - O lastSu 2s 1 D
 R Ho 1993 1994 - Mar Su>=1 2s 0 S
-Z Australia/Brisbane 10:12:8 - LMT 1895
-10 AU AE%sT 1971
-10 AQ AE%sT
-Z Australia/Lindeman 9:55:56 - LMT 1895
-10 AU AE%sT 1971
-10 AQ AE%sT 1992 Jul
-10 Ho AE%sT
 R AS 1971 1985 - O lastSu 2s 1 D
 R AS 1986 o - O 19 2s 1 D
 R AS 1987 2007 - O lastSu 2s 1 D
@@ -1265,10 +805,6 @@ R AS 2006 o - Ap 2 2s 0 S
 R AS 2007 o - Mar lastSu 2s 0 S
 R AS 2008 ma - Ap Su>=1 2s 0 S
 R AS 2008 ma - O Su>=1 2s 1 D
-Z Australia/Adelaide 9:14:20 - LMT 1895 F
-9 - ACST 1899 May
-9:30 AU AC%sT 1971
-9:30 AS AC%sT
 R AT 1916 o - O Su>=1 2s 1 D
 R AT 1917 o - Mar lastSu 2s 0 S
 R AT 1917 1918 - O Su>=22 2s 1 D
@@ -1292,10 +828,6 @@ R AT 2001 ma - O Su>=1 2s 1 D
 R AT 2006 o - Ap Su>=1 2s 0 S
 R AT 2007 o - Mar lastSu 2s 0 S
 R AT 2008 ma - Ap Su>=1 2s 0 S
-Z Australia/Hobart 9:49:16 - LMT 1895 S
-10 AT AE%sT 1919 O 24
-10 AU AE%sT 1967
-10 AT AE%sT
 R AV 1971 1985 - O lastSu 2s 1 D
 R AV 1972 o - F lastSu 2s 0 S
 R AV 1973 1985 - Mar Su>=1 2s 0 S
@@ -1310,9 +842,6 @@ R AV 2006 o - Ap Su>=1 2s 0 S
 R AV 2007 o - Mar lastSu 2s 0 S
 R AV 2008 ma - Ap Su>=1 2s 0 S
 R AV 2008 ma - O Su>=1 2s 1 D
-Z Australia/Melbourne 9:39:52 - LMT 1895 F
-10 AU AE%sT 1971
-10 AV AE%sT
 R AN 1971 1985 - O lastSu 2s 1 D
 R AN 1972 o - F 27 2s 0 S
 R AN 1973 1981 - Mar Su>=1 2s 0 S
@@ -1329,15 +858,6 @@ R AN 2006 o - Ap Su>=1 2s 0 S
 R AN 2007 o - Mar lastSu 2s 0 S
 R AN 2008 ma - Ap Su>=1 2s 0 S
 R AN 2008 ma - O Su>=1 2s 1 D
-Z Australia/Sydney 10:4:52 - LMT 1895 F
-10 AU AE%sT 1971
-10 AN AE%sT
-Z Australia/Broken_Hill 9:25:48 - LMT 1895 F
-10 - AEST 1896 Au 23
-9 - ACST 1899 May
-9:30 AU AC%sT 1971
-9:30 AN AC%sT 2000
-9:30 AS AC%sT
 R LH 1981 1984 - O lastSu 2 1 -
 R LH 1982 1985 - Mar Su>=1 2 0 -
 R LH 1985 o - O lastSu 2 0:30 -
@@ -1352,19 +872,6 @@ R LH 2006 o - Ap Su>=1 2 0 -
 R LH 2007 o - Mar lastSu 2 0 -
 R LH 2008 ma - Ap Su>=1 2 0 -
 R LH 2008 ma - O Su>=1 2 0:30 -
-Z Australia/Lord_Howe 10:36:20 - LMT 1895 F
-10 - AEST 1981 Mar
-10:30 LH +1030/+1130 1985 Jul
-10:30 LH +1030/+11
-Z Antarctica/Macquarie 0 - -00 1899 N
-10 - AEST 1916 O 1 2
-10 1 AEDT 1917 F
-10 AU AE%sT 1919 Ap 1 0s
-0 - -00 1948 Mar 25
-10 AU AE%sT 1967
-10 AT AE%sT 2010
-10 1 AEDT 2011
-10 AT AE%sT
 R FJ 1998 1999 - N Su>=1 2 1 -
 R FJ 1999 2000 - F lastSu 3 0 -
 R FJ 2009 o - N 29 2 1 -
@@ -1377,14 +884,6 @@ R FJ 2014 2018 - N Su>=1 2 1 -
 R FJ 2015 2021 - Ja Su>=12 3 0 -
 R FJ 2019 o - N Su>=8 2 1 -
 R FJ 2020 o - D 20 2 1 -
-Z Pacific/Fiji 11:55:44 - LMT 1915 O 26
-12 FJ +12/+13
-Z Pacific/Gambier -8:59:48 - LMT 1912 O
--9 - -09
-Z Pacific/Marquesas -9:18 - LMT 1912 O
--9:30 - -0930
-Z Pacific/Tahiti -9:58:16 - LMT 1912 O
--10 - -10
 R Gu 1959 o - Jun 27 2 1 D
 R Gu 1961 o - Ja 29 2 0 S
 R Gu 1967 o - S 1 2 1 D
@@ -1399,50 +898,10 @@ R Gu 1976 o - May 26 2 1 D
 R Gu 1976 o - Au 22 2:1 0 S
 R Gu 1977 o - Ap 24 2 1 D
 R Gu 1977 o - Au 28 2 0 S
-Z Pacific/Guam -14:21 - LMT 1844 D 31
-9:39 - LMT 1901
-10 - GST 1941 D 10
-9 - +09 1944 Jul 31
-10 Gu G%sT 2000 D 23
-10 - ChST
-Z Pacific/Tarawa 11:32:4 - LMT 1901
-12 - +12
-Z Pacific/Kanton 0 - -00 1937 Au 31
--12 - -12 1979 O
--11 - -11 1994 D 31
-13 - +13
-Z Pacific/Kiritimati -10:29:20 - LMT 1901
--10:40 - -1040 1979 O
--10 - -10 1994 D 31
-14 - +14
-Z Pacific/Kwajalein 11:9:20 - LMT 1901
-11 - +11 1937
-10 - +10 1941 Ap
-9 - +09 1944 F 6
-11 - +11 1969 O
--12 - -12 1993 Au 20 24
-12 - +12
-Z Pacific/Kosrae -13:8:4 - LMT 1844 D 31
-10:51:56 - LMT 1901
-11 - +11 1914 O
-9 - +09 1919 F
-11 - +11 1937
-10 - +10 1941 Ap
-9 - +09 1945 Au
-11 - +11 1969 O
-12 - +12 1999
-11 - +11
-Z Pacific/Nauru 11:7:40 - LMT 1921 Ja 15
-11:30 - +1130 1942 Au 29
-9 - +09 1945 S 8
-11:30 - +1130 1979 F 10 2
-12 - +12
 R NC 1977 1978 - D Su>=1 0 1 -
 R NC 1978 1979 - F 27 0 0 -
 R NC 1996 o - D 1 2s 1 -
 R NC 1997 o - Mar 2 2s 0 -
-Z Pacific/Noumea 11:5:48 - LMT 1912 Ja 13
-11 NC +11/+12
 R NZ 1927 o - N 6 2 1 S
 R NZ 1928 o - Mar 4 2 0 M
 R NZ 1928 1933 - O Su>=8 2 0:30 S
@@ -1468,80 +927,26 @@ R NZ 2007 ma - S lastSu 2s 1 D
 R k 2007 ma - S lastSu 2:45s 1 -
 R NZ 2008 ma - Ap Su>=1 2s 0 S
 R k 2008 ma - Ap Su>=1 2:45s 0 -
-Z Pacific/Auckland 11:39:4 - LMT 1868 N 2
-11:30 NZ NZ%sT 1946
-12 NZ NZ%sT
-Z Pacific/Chatham 12:13:48 - LMT 1868 N 2
-12:15 - +1215 1946
-12:45 k +1245/+1345
 R CK 1978 o - N 12 0 0:30 -
 R CK 1979 1991 - Mar Su>=1 0 0 -
 R CK 1979 1990 - O lastSu 0 0:30 -
-Z Pacific/Rarotonga 13:20:56 - LMT 1899 D 26
--10:39:4 - LMT 1952 O 16
--10:30 - -1030 1978 N 12
--10 CK -10/-0930
-Z Pacific/Niue -11:19:40 - LMT 1952 O 16
--11:20 - -1120 1964 Jul
--11 - -11
-Z Pacific/Norfolk 11:11:52 - LMT 1901
-11:12 - +1112 1951
-11:30 - +1130 1974 O 27 2s
-11:30 1 +1230 1975 Mar 2 2s
-11:30 - +1130 2015 O 4 2s
-11 - +11 2019 Jul
-11 AN +11/+12
-Z Pacific/Palau -15:2:4 - LMT 1844 D 31
-8:57:56 - LMT 1901
-9 - +09
-Z Pacific/Port_Moresby 9:48:40 - LMT 1880
-9:48:32 - PMMT 1895
-10 - +10
-Z Pacific/Bougainville 10:22:16 - LMT 1880
-9:48:32 - PMMT 1895
-10 - +10 1942 Jul
-9 - +09 1945 Au 21
-10 - +10 2014 D 28 2
-11 - +11
-Z Pacific/Pitcairn -8:40:20 - LMT 1901
--8:30 - -0830 1998 Ap 27
--8 - -08
-Z Pacific/Pago_Pago 12:37:12 - LMT 1892 Jul 5
--11:22:48 - LMT 1911
--11 - SST
 R WS 2010 o - S lastSu 0 1 -
 R WS 2011 o - Ap Sa>=1 4 0 -
 R WS 2011 o - S lastSa 3 1 -
 R WS 2012 2021 - Ap Su>=1 4 0 -
 R WS 2012 2020 - S lastSu 3 1 -
-Z Pacific/Apia 12:33:4 - LMT 1892 Jul 5
--11:26:56 - LMT 1911
--11:30 - -1130 1950
--11 WS -11/-10 2011 D 29 24
-13 WS +13/+14
-Z Pacific/Guadalcanal 10:39:48 - LMT 1912 O
-11 - +11
-Z Pacific/Fakaofo -11:24:56 - LMT 1901
--11 - -11 2011 D 30
-13 - +13
 R TO 1999 o - O 7 2s 1 -
 R TO 2000 o - Mar 19 2s 0 -
 R TO 2000 2001 - N Su>=1 2 1 -
 R TO 2001 2002 - Ja lastSu 2 0 -
 R TO 2016 o - N Su>=1 2 1 -
 R TO 2017 o - Ja Su>=15 3 0 -
-Z Pacific/Tongatapu 12:19:12 - LMT 1945 S 10
-12:20 - +1220 1961
-13 - +13 1999
-13 TO +13/+14
 R VU 1973 o - D 22 12u 1 -
 R VU 1974 o - Mar 30 12u 0 -
 R VU 1983 1991 - S Sa>=22 24 1 -
 R VU 1984 1991 - Mar Sa>=22 24 0 -
 R VU 1992 1993 - Ja Sa>=22 24 0 -
 R VU 1992 o - O Sa>=22 24 1 -
-Z Pacific/Efate 11:13:16 - LMT 1912 Ja 13
-11 VU +11/+12
 R G 1916 o - May 21 2s 1 BST
 R G 1916 o - O 1 2s 0 GMT
 R G 1917 o - Ap 8 2s 1 BST
@@ -1607,11 +1012,6 @@ R G 1972 1980 - O Su>=23 2s 0 GMT
 R G 1981 1995 - Mar lastSu 1u 1 BST
 R G 1981 1989 - O Su>=23 1u 0 GMT
 R G 1990 1995 - O Su>=22 1u 0 GMT
-Z Europe/London -0:1:15 - LMT 1847 D
-0 G %s 1968 O 27
-1 - BST 1971 O 31 2u
-0 G %s 1996
-0 E GMT/BST
 R IE 1971 o - O 31 2u -1 -
 R IE 1972 1980 - Mar Su>=16 2u 0 -
 R IE 1972 1980 - O Su>=23 2u -1 -
@@ -1619,17 +1019,6 @@ R IE 1981 ma - Mar lastSu 1u 0 -
 R IE 1981 1989 - O Su>=23 1u -1 -
 R IE 1990 1995 - O Su>=22 1u -1 -
 R IE 1996 ma - O lastSu 1u -1 -
-Z Europe/Dublin -0:25:21 - LMT 1880 Au 2
--0:25:21 - DMT 1916 May 21 2s
--0:25:21 1 IST 1916 O 1 2s
-0 G %s 1921 D 6
-0 G GMT/IST 1940 F 25 2s
-0 1 IST 1946 O 6 2s
-0 - GMT 1947 Mar 16 2s
-0 1 IST 1947 N 2 2s
-0 - GMT 1948 Ap 18 2s
-0 G GMT/IST 1968 O 27
-1 IE IST/GMT
 R E 1977 1980 - Ap Su>=1 1u 1 S
 R E 1977 o - S lastSu 1u 0 -
 R E 1978 o - O 1 1u 0 -
@@ -1681,10 +1070,6 @@ R R 1981 1983 - O 1 0 0 -
 R R 1984 1995 - S lastSu 2s 0 -
 R R 1985 2010 - Mar lastSu 2s 1 S
 R R 1996 2010 - O lastSu 2s 0 -
-Z WET 0 E WE%sT
-Z CET 1 c CE%sT
-Z MET 1 c ME%sT
-Z EET 2 E EE%sT
 R q 1940 o - Jun 16 0 1 S
 R q 1942 o - N 2 3 0 -
 R q 1943 o - Mar 29 2 1 S
@@ -1710,14 +1095,6 @@ R q 1982 o - O 3 0 0 -
 R q 1983 o - Ap 18 0 1 S
 R q 1983 o - O 1 0 0 -
 R q 1984 o - Ap 1 0 1 S
-Z Europe/Tirane 1:19:20 - LMT 1914
-1 - CET 1940 Jun 16
-1 q CE%sT 1984 Jul
-1 E CE%sT
-Z Europe/Andorra 0:6:4 - LMT 1901
-0 - WET 1946 S 30
-1 - CET 1985 Mar 31 2
-1 E CE%sT
 R a 1920 o - Ap 5 2s 1 S
 R a 1920 o - S 13 2s 0 -
 R a 1946 o - Ap 14 2s 1 S
@@ -1727,23 +1104,6 @@ R a 1947 o - Ap 6 2s 1 S
 R a 1948 o - Ap 18 2s 1 S
 R a 1980 o - Ap 6 0 1 S
 R a 1980 o - S 28 0 0 -
-Z Europe/Vienna 1:5:21 - LMT 1893 Ap
-1 c CE%sT 1920
-1 a CE%sT 1940 Ap 1 2s
-1 c CE%sT 1945 Ap 2 2s
-1 1 CEST 1945 Ap 12 2s
-1 - CET 1946
-1 a CE%sT 1981
-1 E CE%sT
-Z Europe/Minsk 1:50:16 - LMT 1880
-1:50 - MMT 1924 May 2
-2 - EET 1930 Jun 21
-3 - MSK 1941 Jun 28
-1 c CE%sT 1944 Jul 3
-3 R MSK/MSD 1990
-3 - MSK 1991 Mar 31 2s
-2 R EE%sT 2011 Mar 27 2s
-3 - +03
 R b 1918 o - Mar 9 0s 1 S
 R b 1918 1919 - O Sa>=1 23s 0 -
 R b 1919 o - Mar 1 23s 1 S
@@ -1778,87 +1138,27 @@ R b 1945 o - Ap 2 2s 1 S
 R b 1945 o - S 16 2s 0 -
 R b 1946 o - May 19 2s 1 S
 R b 1946 o - O 7 2s 0 -
-Z Europe/Brussels 0:17:30 - LMT 1880
-0:17:30 - BMT 1892 May 1 0:17:30
-0 - WET 1914 N 8
-1 - CET 1916 May
-1 c CE%sT 1918 N 11 11u
-0 b WE%sT 1940 May 20 2s
-1 c CE%sT 1944 S 3
-1 b CE%sT 1977
-1 E CE%sT
 R BG 1979 o - Mar 31 23 1 S
 R BG 1979 o - O 1 1 0 -
 R BG 1980 1982 - Ap Sa>=1 23 1 S
 R BG 1980 o - S 29 1 0 -
 R BG 1981 o - S 27 2 0 -
-Z Europe/Sofia 1:33:16 - LMT 1880
-1:56:56 - IMT 1894 N 30
-2 - EET 1942 N 2 3
-1 c CE%sT 1945
-1 - CET 1945 Ap 2 3
-2 - EET 1979 Mar 31 23
-2 BG EE%sT 1982 S 26 3
-2 c EE%sT 1991
-2 e EE%sT 1997
-2 E EE%sT
 R CZ 1945 o - Ap M>=1 2s 1 S
 R CZ 1945 o - O 1 2s 0 -
 R CZ 1946 o - May 6 2s 1 S
 R CZ 1946 1949 - O Su>=1 2s 0 -
 R CZ 1947 1948 - Ap Su>=15 2s 1 S
 R CZ 1949 o - Ap 9 2s 1 S
-Z Europe/Prague 0:57:44 - LMT 1850
-0:57:44 - PMT 1891 O
-1 c CE%sT 1945 May 9
-1 CZ CE%sT 1946 D 1 3
-1 -1 GMT 1947 F 23 2
-1 CZ CE%sT 1979
-1 E CE%sT
-Z Atlantic/Faroe -0:27:4 - LMT 1908 Ja 11
-0 - WET 1981
-0 E WE%sT
 R Th 1991 1992 - Mar lastSu 2 1 D
 R Th 1991 1992 - S lastSu 2 0 S
 R Th 1993 2006 - Ap Su>=1 2 1 D
 R Th 1993 2006 - O lastSu 2 0 S
 R Th 2007 ma - Mar Su>=8 2 1 D
 R Th 2007 ma - N Su>=1 2 0 S
-Z America/Danmarkshavn -1:14:40 - LMT 1916 Jul 28
--3 - -03 1980 Ap 6 2
--3 E -03/-02 1996
-0 - GMT
-Z America/Scoresbysund -1:27:52 - LMT 1916 Jul 28
--2 - -02 1980 Ap 6 2
--2 c -02/-01 1981 Mar 29
--1 E -01/+00
-Z America/Nuuk -3:26:56 - LMT 1916 Jul 28
--3 - -03 1980 Ap 6 2
--3 E -03/-02 2023 O 29 1u
--2 E -02/-01
-Z America/Thule -4:35:8 - LMT 1916 Jul 28
--4 Th A%sT
-Z Europe/Tallinn 1:39 - LMT 1880
-1:39 - TMT 1918 F
-1 c CE%sT 1919 Jul
-1:39 - TMT 1921 May
-2 - EET 1940 Au 6
-3 - MSK 1941 S 15
-1 c CE%sT 1944 S 22
-3 R MSK/MSD 1989 Mar 26 2s
-2 1 EEST 1989 S 24 2s
-2 c EE%sT 1998 S 22
-2 E EE%sT 1999 O 31 4
-2 - EET 2002 F 21
-2 E EE%sT
 R FI 1942 o - Ap 2 24 1 S
 R FI 1942 o - O 4 1 0 -
 R FI 1981 1982 - Mar lastSu 2 1 S
 R FI 1981 1982 - S lastSu 3 0 -
-Z Europe/Helsinki 1:39:49 - LMT 1878 May 31
-1:39:49 - HMT 1921 May
-2 FI EE%sT 1983
-2 E EE%sT
 R F 1916 o - Jun 14 23s 1 S
 R F 1916 1919 - O Su>=1 23s 0 -
 R F 1917 o - Mar 24 23s 1 S
@@ -1901,13 +1201,6 @@ R F 1945 o - Ap 2 2 2 M
 R F 1945 o - S 16 3 0 -
 R F 1976 o - Mar 28 1 1 S
 R F 1976 o - S 26 1 0 -
-Z Europe/Paris 0:9:21 - LMT 1891 Mar 16
-0:9:21 - PMT 1911 Mar 11
-0 F WE%sT 1940 Jun 14 23
-1 c CE%sT 1944 Au 25
-0 F WE%sT 1945 S 16 3
-1 F CE%sT 1977
-1 E CE%sT
 R DE 1946 o - Ap 14 2s 1 S
 R DE 1946 o - O 7 2s 0 -
 R DE 1947 1949 - O Su>=1 2s 0 -
@@ -1919,15 +1212,6 @@ R DE 1949 o - Ap 10 2s 1 S
 R So 1945 o - May 24 2 2 M
 R So 1945 o - S 24 3 1 S
 R So 1945 o - N 18 2s 0 -
-Z Europe/Berlin 0:53:28 - LMT 1893 Ap
-1 c CE%sT 1945 May 24 2
-1 So CE%sT 1946
-1 DE CE%sT 1980
-1 E CE%sT
-Z Europe/Gibraltar -0:21:24 - LMT 1880 Au 2
-0 G %s 1957 Ap 14 2
-1 - CET 1982
-1 E CE%sT
 R g 1932 o - Jul 7 0 1 S
 R g 1932 o - S 1 0 0 -
 R g 1941 o - Ap 7 0 1 S
@@ -1947,12 +1231,6 @@ R g 1979 o - Ap 1 9 1 S
 R g 1979 o - S 29 2 0 -
 R g 1980 o - Ap 1 0 1 S
 R g 1980 o - S 28 0 0 -
-Z Europe/Athens 1:34:52 - LMT 1895 S 14
-1:34:52 - AMT 1916 Jul 28 0:1
-2 g EE%sT 1941 Ap 30
-1 g CE%sT 1944 Ap 4
-2 g EE%sT 1981
-2 E EE%sT
 R h 1918 1919 - Ap 15 2 1 S
 R h 1918 1920 - S M>=15 3 0 -
 R h 1920 o - Ap 5 2 1 S
@@ -1972,12 +1250,6 @@ R h 1980 o - Ap 6 0 1 S
 R h 1980 o - S 28 1 0 -
 R h 1981 1983 - Mar lastSu 0 1 S
 R h 1981 1983 - S lastSu 1 0 -
-Z Europe/Budapest 1:16:20 - LMT 1890 N
-1 c CE%sT 1918
-1 h CE%sT 1941 Ap 7 23
-1 c CE%sT 1945
-1 h CE%sT 1984
-1 E CE%sT
 R I 1916 o - Jun 3 24 1 S
 R I 1916 1917 - S 30 24 0 -
 R I 1917 o - Mar 31 24 1 S
@@ -2019,44 +1291,8 @@ R I 1976 o - May 30 0s 1 S
 R I 1977 1979 - May Su>=22 0s 1 S
 R I 1978 o - O 1 0s 0 -
 R I 1979 o - S 30 0s 0 -
-Z Europe/Rome 0:49:56 - LMT 1866 D 12
-0:49:56 - RMT 1893 O 31 23u
-1 I CE%sT 1943 S 10
-1 c CE%sT 1944 Jun 4
-1 I CE%sT 1980
-1 E CE%sT
 R LV 1989 1996 - Mar lastSu 2s 1 S
 R LV 1989 1996 - S lastSu 2s 0 -
-Z Europe/Riga 1:36:34 - LMT 1880
-1:36:34 - RMT 1918 Ap 15 2
-1:36:34 1 LST 1918 S 16 3
-1:36:34 - RMT 1919 Ap 1 2
-1:36:34 1 LST 1919 May 22 3
-1:36:34 - RMT 1926 May 11
-2 - EET 1940 Au 5
-3 - MSK 1941 Jul
-1 c CE%sT 1944 O 13
-3 R MSK/MSD 1989 Mar lastSu 2s
-2 1 EEST 1989 S lastSu 2s
-2 LV EE%sT 1997 Ja 21
-2 E EE%sT 2000 F 29
-2 - EET 2001 Ja 2
-2 E EE%sT
-Z Europe/Vilnius 1:41:16 - LMT 1880
-1:24 - WMT 1917
-1:35:36 - KMT 1919 O 10
-1 - CET 1920 Jul 12
-2 - EET 1920 O 9
-1 - CET 1940 Au 3
-3 - MSK 1941 Jun 24
-1 c CE%sT 1944 Au
-3 R MSK/MSD 1989 Mar 26 2s
-2 R EE%sT 1991 S 29 2s
-2 c EE%sT 1998
-2 - EET 1998 Mar 29 1u
-1 E CE%sT 1999 O 31 1u
-2 - EET 2003
-2 E EE%sT
 R MT 1973 o - Mar 31 0s 1 S
 R MT 1973 o - S 29 0s 0 -
 R MT 1974 o - Ap 21 0s 1 S
@@ -2064,22 +1300,8 @@ R MT 1974 o - S 16 0s 0 -
 R MT 1975 1979 - Ap Su>=15 2 1 S
 R MT 1975 1980 - S Su>=15 2 0 -
 R MT 1980 o - Mar 31 2 1 S
-Z Europe/Malta 0:58:4 - LMT 1893 N 2
-1 I CE%sT 1973 Mar 31
-1 MT CE%sT 1981
-1 E CE%sT
 R MD 1997 ma - Mar lastSu 2 1 S
 R MD 1997 ma - O lastSu 3 0 -
-Z Europe/Chisinau 1:55:20 - LMT 1880
-1:55 - CMT 1918 F 15
-1:44:24 - BMT 1931 Jul 24
-2 z EE%sT 1940 Au 15
-2 1 EEST 1941 Jul 17
-1 c CE%sT 1944 Au 24
-3 R MSK/MSD 1990 May 6 2
-2 R EE%sT 1992
-2 e EE%sT 1997
-2 MD EE%sT
 R O 1918 1919 - S 16 2s 0 -
 R O 1919 o - Ap 15 2s 1 S
 R O 1944 o - Ap 3 2s 1 S
@@ -2100,15 +1322,6 @@ R O 1959 1961 - O Su>=1 1s 0 -
 R O 1960 o - Ap 3 1s 1 S
 R O 1961 1964 - May lastSu 1s 1 S
 R O 1962 1964 - S lastSu 1s 0 -
-Z Europe/Warsaw 1:24 - LMT 1880
-1:24 - WMT 1915 Au 5
-1 c CE%sT 1918 S 16 3
-2 O EE%sT 1922 Jun
-1 O CE%sT 1940 Jun 23 2
-1 c CE%sT 1944 O
-1 O CE%sT 1977
-1 W- CE%sT 1988
-1 E CE%sT
 R p 1916 o - Jun 17 23 1 S
 R p 1916 o - N 1 1 0 -
 R p 1917 o - F 28 23s 1 S
@@ -2157,42 +1370,6 @@ R p 1979 1982 - S lastSu 1s 0 -
 R p 1980 o - Mar lastSu 0s 1 S
 R p 1981 1982 - Mar lastSu 1s 1 S
 R p 1983 o - Mar lastSu 2s 1 S
-Z Europe/Lisbon -0:36:45 - LMT 1884
--0:36:45 - LMT 1912 Ja 1 0u
-0 p WE%sT 1966 Ap 3 2
-1 - CET 1976 S 26 1
-0 p WE%sT 1983 S 25 1s
-0 W- WE%sT 1992 S 27 1s
-1 E CE%sT 1996 Mar 31 1u
-0 E WE%sT
-Z Atlantic/Azores -1:42:40 - LMT 1884
--1:54:32 - HMT 1912 Ja 1 2u
--2 p -02/-01 1942 Ap 25 22s
--2 p +00 1942 Au 15 22s
--2 p -02/-01 1943 Ap 17 22s
--2 p +00 1943 Au 28 22s
--2 p -02/-01 1944 Ap 22 22s
--2 p +00 1944 Au 26 22s
--2 p -02/-01 1945 Ap 21 22s
--2 p +00 1945 Au 25 22s
--2 p -02/-01 1966 Ap 3 2
--1 p -01/+00 1983 S 25 1s
--1 W- -01/+00 1992 S 27 1s
-0 E WE%sT 1993 Mar 28 1u
--1 E -01/+00
-Z Atlantic/Madeira -1:7:36 - LMT 1884
--1:7:36 - FMT 1912 Ja 1 1u
--1 p -01/+00 1942 Ap 25 22s
--1 p +01 1942 Au 15 22s
--1 p -01/+00 1943 Ap 17 22s
--1 p +01 1943 Au 28 22s
--1 p -01/+00 1944 Ap 22 22s
--1 p +01 1944 Au 26 22s
--1 p -01/+00 1945 Ap 21 22s
--1 p +01 1945 Au 25 22s
--1 p -01/+00 1966 Ap 3 2
-0 p WE%sT 1983 S 25 1s
-0 E WE%sT
 R z 1932 o - May 21 0s 1 S
 R z 1932 1939 - O Su>=1 0s 0 -
 R z 1933 1939 - Ap Su>=2 0s 1 S
@@ -2202,252 +1379,6 @@ R z 1980 o - Ap 5 23 1 S
 R z 1980 o - S lastSu 1 0 -
 R z 1991 1993 - Mar lastSu 0s 1 S
 R z 1991 1993 - S lastSu 0s 0 -
-Z Europe/Bucharest 1:44:24 - LMT 1891 O
-1:44:24 - BMT 1931 Jul 24
-2 z EE%sT 1981 Mar 29 2s
-2 c EE%sT 1991
-2 z EE%sT 1994
-2 e EE%sT 1997
-2 E EE%sT
-Z Europe/Kaliningrad 1:22 - LMT 1893 Ap
-1 c CE%sT 1945 Ap 10
-2 O EE%sT 1946 Ap 7
-3 R MSK/MSD 1989 Mar 26 2s
-2 R EE%sT 2011 Mar 27 2s
-3 - +03 2014 O 26 2s
-2 - EET
-Z Europe/Moscow 2:30:17 - LMT 1880
-2:30:17 - MMT 1916 Jul 3
-2:31:19 R %s 1919 Jul 1 0u
-3 R %s 1921 O
-3 R MSK/MSD 1922 O
-2 - EET 1930 Jun 21
-3 R MSK/MSD 1991 Mar 31 2s
-2 R EE%sT 1992 Ja 19 2s
-3 R MSK/MSD 2011 Mar 27 2s
-4 - MSK 2014 O 26 2s
-3 - MSK
-Z Europe/Simferopol 2:16:24 - LMT 1880
-2:16 - SMT 1924 May 2
-2 - EET 1930 Jun 21
-3 - MSK 1941 N
-1 c CE%sT 1944 Ap 13
-3 R MSK/MSD 1990
-3 - MSK 1990 Jul 1 2
-2 - EET 1992 Mar 20
-2 c EE%sT 1994 May
-3 c MSK/MSD 1996 Mar 31 0s
-3 1 MSD 1996 O 27 3s
-3 - MSK 1997 Mar lastSu 1u
-2 E EE%sT 2014 Mar 30 2
-4 - MSK 2014 O 26 2s
-3 - MSK
-Z Europe/Astrakhan 3:12:12 - LMT 1924 May
-3 - +03 1930 Jun 21
-4 R +04/+05 1989 Mar 26 2s
-3 R +03/+04 1991 Mar 31 2s
-4 - +04 1992 Mar 29 2s
-3 R +03/+04 2011 Mar 27 2s
-4 - +04 2014 O 26 2s
-3 - +03 2016 Mar 27 2s
-4 - +04
-Z Europe/Volgograd 2:57:40 - LMT 1920 Ja 3
-3 - +03 1930 Jun 21
-4 - +04 1961 N 11
-4 R +04/+05 1988 Mar 27 2s
-3 R MSK/MSD 1991 Mar 31 2s
-4 - +04 1992 Mar 29 2s
-3 R MSK/MSD 2011 Mar 27 2s
-4 - MSK 2014 O 26 2s
-3 - MSK 2018 O 28 2s
-4 - +04 2020 D 27 2s
-3 - MSK
-Z Europe/Saratov 3:4:18 - LMT 1919 Jul 1 0u
-3 - +03 1930 Jun 21
-4 R +04/+05 1988 Mar 27 2s
-3 R +03/+04 1991 Mar 31 2s
-4 - +04 1992 Mar 29 2s
-3 R +03/+04 2011 Mar 27 2s
-4 - +04 2014 O 26 2s
-3 - +03 2016 D 4 2s
-4 - +04
-Z Europe/Kirov 3:18:48 - LMT 1919 Jul 1 0u
-3 - +03 1930 Jun 21
-4 R +04/+05 1989 Mar 26 2s
-3 R MSK/MSD 1991 Mar 31 2s
-4 - +04 1992 Mar 29 2s
-3 R MSK/MSD 2011 Mar 27 2s
-4 - MSK 2014 O 26 2s
-3 - MSK
-Z Europe/Samara 3:20:20 - LMT 1919 Jul 1 0u
-3 - +03 1930 Jun 21
-4 - +04 1935 Ja 27
-4 R +04/+05 1989 Mar 26 2s
-3 R +03/+04 1991 Mar 31 2s
-2 R +02/+03 1991 S 29 2s
-3 - +03 1991 O 20 3
-4 R +04/+05 2010 Mar 28 2s
-3 R +03/+04 2011 Mar 27 2s
-4 - +04
-Z Europe/Ulyanovsk 3:13:36 - LMT 1919 Jul 1 0u
-3 - +03 1930 Jun 21
-4 R +04/+05 1989 Mar 26 2s
-3 R +03/+04 1991 Mar 31 2s
-2 R +02/+03 1992 Ja 19 2s
-3 R +03/+04 2011 Mar 27 2s
-4 - +04 2014 O 26 2s
-3 - +03 2016 Mar 27 2s
-4 - +04
-Z Asia/Yekaterinburg 4:2:33 - LMT 1916 Jul 3
-3:45:5 - PMT 1919 Jul 15 4
-4 - +04 1930 Jun 21
-5 R +05/+06 1991 Mar 31 2s
-4 R +04/+05 1992 Ja 19 2s
-5 R +05/+06 2011 Mar 27 2s
-6 - +06 2014 O 26 2s
-5 - +05
-Z Asia/Omsk 4:53:30 - LMT 1919 N 14
-5 - +05 1930 Jun 21
-6 R +06/+07 1991 Mar 31 2s
-5 R +05/+06 1992 Ja 19 2s
-6 R +06/+07 2011 Mar 27 2s
-7 - +07 2014 O 26 2s
-6 - +06
-Z Asia/Barnaul 5:35 - LMT 1919 D 10
-6 - +06 1930 Jun 21
-7 R +07/+08 1991 Mar 31 2s
-6 R +06/+07 1992 Ja 19 2s
-7 R +07/+08 1995 May 28
-6 R +06/+07 2011 Mar 27 2s
-7 - +07 2014 O 26 2s
-6 - +06 2016 Mar 27 2s
-7 - +07
-Z Asia/Novosibirsk 5:31:40 - LMT 1919 D 14 6
-6 - +06 1930 Jun 21
-7 R +07/+08 1991 Mar 31 2s
-6 R +06/+07 1992 Ja 19 2s
-7 R +07/+08 1993 May 23
-6 R +06/+07 2011 Mar 27 2s
-7 - +07 2014 O 26 2s
-6 - +06 2016 Jul 24 2s
-7 - +07
-Z Asia/Tomsk 5:39:51 - LMT 1919 D 22
-6 - +06 1930 Jun 21
-7 R +07/+08 1991 Mar 31 2s
-6 R +06/+07 1992 Ja 19 2s
-7 R +07/+08 2002 May 1 3
-6 R +06/+07 2011 Mar 27 2s
-7 - +07 2014 O 26 2s
-6 - +06 2016 May 29 2s
-7 - +07
-Z Asia/Novokuznetsk 5:48:48 - LMT 1924 May
-6 - +06 1930 Jun 21
-7 R +07/+08 1991 Mar 31 2s
-6 R +06/+07 1992 Ja 19 2s
-7 R +07/+08 2010 Mar 28 2s
-6 R +06/+07 2011 Mar 27 2s
-7 - +07
-Z Asia/Krasnoyarsk 6:11:26 - LMT 1920 Ja 6
-6 - +06 1930 Jun 21
-7 R +07/+08 1991 Mar 31 2s
-6 R +06/+07 1992 Ja 19 2s
-7 R +07/+08 2011 Mar 27 2s
-8 - +08 2014 O 26 2s
-7 - +07
-Z Asia/Irkutsk 6:57:5 - LMT 1880
-6:57:5 - IMT 1920 Ja 25
-7 - +07 1930 Jun 21
-8 R +08/+09 1991 Mar 31 2s
-7 R +07/+08 1992 Ja 19 2s
-8 R +08/+09 2011 Mar 27 2s
-9 - +09 2014 O 26 2s
-8 - +08
-Z Asia/Chita 7:33:52 - LMT 1919 D 15
-8 - +08 1930 Jun 21
-9 R +09/+10 1991 Mar 31 2s
-8 R +08/+09 1992 Ja 19 2s
-9 R +09/+10 2011 Mar 27 2s
-10 - +10 2014 O 26 2s
-8 - +08 2016 Mar 27 2
-9 - +09
-Z Asia/Yakutsk 8:38:58 - LMT 1919 D 15
-8 - +08 1930 Jun 21
-9 R +09/+10 1991 Mar 31 2s
-8 R +08/+09 1992 Ja 19 2s
-9 R +09/+10 2011 Mar 27 2s
-10 - +10 2014 O 26 2s
-9 - +09
-Z Asia/Vladivostok 8:47:31 - LMT 1922 N 15
-9 - +09 1930 Jun 21
-10 R +10/+11 1991 Mar 31 2s
-9 R +09/+10 1992 Ja 19 2s
-10 R +10/+11 2011 Mar 27 2s
-11 - +11 2014 O 26 2s
-10 - +10
-Z Asia/Khandyga 9:2:13 - LMT 1919 D 15
-8 - +08 1930 Jun 21
-9 R +09/+10 1991 Mar 31 2s
-8 R +08/+09 1992 Ja 19 2s
-9 R +09/+10 2004
-10 R +10/+11 2011 Mar 27 2s
-11 - +11 2011 S 13 0s
-10 - +10 2014 O 26 2s
-9 - +09
-Z Asia/Sakhalin 9:30:48 - LMT 1905 Au 23
-9 - +09 1945 Au 25
-11 R +11/+12 1991 Mar 31 2s
-10 R +10/+11 1992 Ja 19 2s
-11 R +11/+12 1997 Mar lastSu 2s
-10 R +10/+11 2011 Mar 27 2s
-11 - +11 2014 O 26 2s
-10 - +10 2016 Mar 27 2s
-11 - +11
-Z Asia/Magadan 10:3:12 - LMT 1924 May 2
-10 - +10 1930 Jun 21
-11 R +11/+12 1991 Mar 31 2s
-10 R +10/+11 1992 Ja 19 2s
-11 R +11/+12 2011 Mar 27 2s
-12 - +12 2014 O 26 2s
-10 - +10 2016 Ap 24 2s
-11 - +11
-Z Asia/Srednekolymsk 10:14:52 - LMT 1924 May 2
-10 - +10 1930 Jun 21
-11 R +11/+12 1991 Mar 31 2s
-10 R +10/+11 1992 Ja 19 2s
-11 R +11/+12 2011 Mar 27 2s
-12 - +12 2014 O 26 2s
-11 - +11
-Z Asia/Ust-Nera 9:32:54 - LMT 1919 D 15
-8 - +08 1930 Jun 21
-9 R +09/+10 1981 Ap
-11 R +11/+12 1991 Mar 31 2s
-10 R +10/+11 1992 Ja 19 2s
-11 R +11/+12 2011 Mar 27 2s
-12 - +12 2011 S 13 0s
-11 - +11 2014 O 26 2s
-10 - +10
-Z Asia/Kamchatka 10:34:36 - LMT 1922 N 10
-11 - +11 1930 Jun 21
-12 R +12/+13 1991 Mar 31 2s
-11 R +11/+12 1992 Ja 19 2s
-12 R +12/+13 2010 Mar 28 2s
-11 R +11/+12 2011 Mar 27 2s
-12 - +12
-Z Asia/Anadyr 11:49:56 - LMT 1924 May 2
-12 - +12 1930 Jun 21
-13 R +13/+14 1982 Ap 1 0s
-12 R +12/+13 1991 Mar 31 2s
-11 R +11/+12 1992 Ja 19 2s
-12 R +12/+13 2010 Mar 28 2s
-11 R +11/+12 2011 Mar 27 2s
-12 - +12
-Z Europe/Belgrade 1:22 - LMT 1884
-1 - CET 1941 Ap 18 23
-1 c CE%sT 1945
-1 - CET 1945 May 8 2s
-1 1 CEST 1945 S 16 2s
-1 - CET 1982 N 27
-1 E CE%sT
 R s 1918 o - Ap 15 23 1 S
 R s 1918 1919 - O 6 24s 0 -
 R s 1919 o - Ap 6 23 1 S
@@ -2487,30 +1418,8 @@ R Sp 1976 o - Au 1 0 0 -
 R Sp 1977 o - S 28 0 0 -
 R Sp 1978 o - Jun 1 0 1 S
 R Sp 1978 o - Au 4 0 0 -
-Z Europe/Madrid -0:14:44 - LMT 1901 Ja 1 0u
-0 s WE%sT 1940 Mar 16 23
-1 s CE%sT 1979
-1 E CE%sT
-Z Africa/Ceuta -0:21:16 - LMT 1901 Ja 1 0u
-0 - WET 1918 May 6 23
-0 1 WEST 1918 O 7 23
-0 - WET 1924
-0 s WE%sT 1929
-0 - WET 1967
-0 Sp WE%sT 1984 Mar 16
-1 - CET 1986
-1 E CE%sT
-Z Atlantic/Canary -1:1:36 - LMT 1922 Mar
--1 - -01 1946 S 30 1
-0 - WET 1980 Ap 6 0s
-0 1 WEST 1980 S 28 1u
-0 E WE%sT
 R CH 1941 1942 - May M>=1 1 1 S
 R CH 1941 1942 - O M>=1 2 0 -
-Z Europe/Zurich 0:34:8 - LMT 1853 Jul 16
-0:29:46 - BMT 1894 Jun
-1 CH CE%sT 1981
-1 E CE%sT
 R T 1916 o - May 1 0 1 S
 R T 1916 o - O 1 0 0 -
 R T 1920 o - Mar 28 0 1 S
@@ -2556,28 +1465,6 @@ R T 1986 1995 - S lastSu 1s 0 -
 R T 1994 o - Mar 20 1s 1 S
 R T 1995 2006 - Mar lastSu 1s 1 S
 R T 1996 2006 - O lastSu 1s 0 -
-Z Europe/Istanbul 1:55:52 - LMT 1880
-1:56:56 - IMT 1910 O
-2 T EE%sT 1978 Jun 29
-3 T +03/+04 1984 N 1 2
-2 T EE%sT 2007
-2 E EE%sT 2011 Mar 27 1u
-2 - EET 2011 Mar 28 1u
-2 E EE%sT 2014 Mar 30 1u
-2 - EET 2014 Mar 31 1u
-2 E EE%sT 2015 O 25 1u
-2 1 EEST 2015 N 8 1u
-2 E EE%sT 2016 S 7
-3 - +03
-Z Europe/Kyiv 2:2:4 - LMT 1880
-2:2:4 - KMT 1924 May 2
-2 - EET 1930 Jun 21
-3 - MSK 1941 S 20
-1 c CE%sT 1943 N 6
-3 R MSK/MSD 1990 Jul 1 2
-2 1 EEST 1991 S 29 3
-2 c EE%sT 1996 May 13
-2 E EE%sT
 R u 1918 1919 - Mar lastSu 2 1 D
 R u 1918 1919 - O lastSu 2 0 S
 R u 1942 o - F 9 2 1 W
@@ -2591,172 +1478,34 @@ R u 1976 1986 - Ap lastSu 2 1 D
 R u 1987 2006 - Ap Su>=1 2 1 D
 R u 2007 ma - Mar Su>=8 2 1 D
 R u 2007 ma - N Su>=1 2 0 S
-Z EST -5 - EST
-Z MST -7 - MST
-Z HST -10 - HST
-Z EST5EDT -5 u E%sT
-Z CST6CDT -6 u C%sT
-Z MST7MDT -7 u M%sT
-Z PST8PDT -8 u P%sT
 R NY 1920 o - Mar lastSu 2 1 D
 R NY 1920 o - O lastSu 2 0 S
 R NY 1921 1966 - Ap lastSu 2 1 D
 R NY 1921 1954 - S lastSu 2 0 S
 R NY 1955 1966 - O lastSu 2 0 S
-Z America/New_York -4:56:2 - LMT 1883 N 18 17u
--5 u E%sT 1920
--5 NY E%sT 1942
--5 u E%sT 1946
--5 NY E%sT 1967
--5 u E%sT
 R Ch 1920 o - Jun 13 2 1 D
 R Ch 1920 1921 - O lastSu 2 0 S
 R Ch 1921 o - Mar lastSu 2 1 D
 R Ch 1922 1966 - Ap lastSu 2 1 D
 R Ch 1922 1954 - S lastSu 2 0 S
 R Ch 1955 1966 - O lastSu 2 0 S
-Z America/Chicago -5:50:36 - LMT 1883 N 18 18u
--6 u C%sT 1920
--6 Ch C%sT 1936 Mar 1 2
--5 - EST 1936 N 15 2
--6 Ch C%sT 1942
--6 u C%sT 1946
--6 Ch C%sT 1967
--6 u C%sT
-Z America/North_Dakota/Center -6:45:12 - LMT 1883 N 18 19u
--7 u M%sT 1992 O 25 2
--6 u C%sT
-Z America/North_Dakota/New_Salem -6:45:39 - LMT 1883 N 18 19u
--7 u M%sT 2003 O 26 2
--6 u C%sT
-Z America/North_Dakota/Beulah -6:47:7 - LMT 1883 N 18 19u
--7 u M%sT 2010 N 7 2
--6 u C%sT
 R De 1920 1921 - Mar lastSu 2 1 D
 R De 1920 o - O lastSu 2 0 S
 R De 1921 o - May 22 2 0 S
 R De 1965 1966 - Ap lastSu 2 1 D
 R De 1965 1966 - O lastSu 2 0 S
-Z America/Denver -6:59:56 - LMT 1883 N 18 19u
--7 u M%sT 1920
--7 De M%sT 1942
--7 u M%sT 1946
--7 De M%sT 1967
--7 u M%sT
 R CA 1948 o - Mar 14 2:1 1 D
 R CA 1949 o - Ja 1 2 0 S
 R CA 1950 1966 - Ap lastSu 1 1 D
 R CA 1950 1961 - S lastSu 2 0 S
 R CA 1962 1966 - O lastSu 2 0 S
-Z America/Los_Angeles -7:52:58 - LMT 1883 N 18 20u
--8 u P%sT 1946
--8 CA P%sT 1967
--8 u P%sT
-Z America/Juneau 15:2:19 - LMT 1867 O 19 15:33:32
--8:57:41 - LMT 1900 Au 20 12
--8 - PST 1942
--8 u P%sT 1946
--8 - PST 1969
--8 u P%sT 1980 Ap 27 2
--9 u Y%sT 1980 O 26 2
--8 u P%sT 1983 O 30 2
--9 u Y%sT 1983 N 30
--9 u AK%sT
-Z America/Sitka 14:58:47 - LMT 1867 O 19 15:30
--9:1:13 - LMT 1900 Au 20 12
--8 - PST 1942
--8 u P%sT 1946
--8 - PST 1969
--8 u P%sT 1983 O 30 2
--9 u Y%sT 1983 N 30
--9 u AK%sT
-Z America/Metlakatla 15:13:42 - LMT 1867 O 19 15:44:55
--8:46:18 - LMT 1900 Au 20 12
--8 - PST 1942
--8 u P%sT 1946
--8 - PST 1969
--8 u P%sT 1983 O 30 2
--8 - PST 2015 N 1 2
--9 u AK%sT 2018 N 4 2
--8 - PST 2019 Ja 20 2
--9 u AK%sT
-Z America/Yakutat 14:41:5 - LMT 1867 O 19 15:12:18
--9:18:55 - LMT 1900 Au 20 12
--9 - YST 1942
--9 u Y%sT 1946
--9 - YST 1969
--9 u Y%sT 1983 N 30
--9 u AK%sT
-Z America/Anchorage 14:0:24 - LMT 1867 O 19 14:31:37
--9:59:36 - LMT 1900 Au 20 12
--10 - AST 1942
--10 u A%sT 1967 Ap
--10 - AHST 1969
--10 u AH%sT 1983 O 30 2
--9 u Y%sT 1983 N 30
--9 u AK%sT
-Z America/Nome 12:58:22 - LMT 1867 O 19 13:29:35
--11:1:38 - LMT 1900 Au 20 12
--11 - NST 1942
--11 u N%sT 1946
--11 - NST 1967 Ap
--11 - BST 1969
--11 u B%sT 1983 O 30 2
--9 u Y%sT 1983 N 30
--9 u AK%sT
-Z America/Adak 12:13:22 - LMT 1867 O 19 12:44:35
--11:46:38 - LMT 1900 Au 20 12
--11 - NST 1942
--11 u N%sT 1946
--11 - NST 1967 Ap
--11 - BST 1969
--11 u B%sT 1983 O 30 2
--10 u AH%sT 1983 N 30
--10 u H%sT
-Z Pacific/Honolulu -10:31:26 - LMT 1896 Ja 13 12
--10:30 - HST 1933 Ap 30 2
--10:30 1 HDT 1933 May 21 12
--10:30 u H%sT 1947 Jun 8 2
--10 - HST
-Z America/Phoenix -7:28:18 - LMT 1883 N 18 19u
--7 u M%sT 1944 Ja 1 0:1
--7 - MST 1944 Ap 1 0:1
--7 u M%sT 1944 O 1 0:1
--7 - MST 1967
--7 u M%sT 1968 Mar 21
--7 - MST
-Z America/Boise -7:44:49 - LMT 1883 N 18 20u
--8 u P%sT 1923 May 13 2
--7 u M%sT 1974
--7 - MST 1974 F 3 2
--7 u M%sT
 R In 1941 o - Jun 22 2 1 D
 R In 1941 1954 - S lastSu 2 0 S
 R In 1946 1954 - Ap lastSu 2 1 D
-Z America/Indiana/Indianapolis -5:44:38 - LMT 1883 N 18 18u
--6 u C%sT 1920
--6 In C%sT 1942
--6 u C%sT 1946
--6 In C%sT 1955 Ap 24 2
--5 - EST 1957 S 29 2
--6 - CST 1958 Ap 27 2
--5 - EST 1969
--5 u E%sT 1971
--5 - EST 2006
--5 u E%sT
 R Ma 1951 o - Ap lastSu 2 1 D
 R Ma 1951 o - S lastSu 2 0 S
 R Ma 1954 1960 - Ap lastSu 2 1 D
 R Ma 1954 1960 - S lastSu 2 0 S
-Z America/Indiana/Marengo -5:45:23 - LMT 1883 N 18 18u
--6 u C%sT 1951
--6 Ma C%sT 1961 Ap 30 2
--5 - EST 1969
--5 u E%sT 1974 Ja 6 2
--6 1 CDT 1974 O 27 2
--5 u E%sT 1976
--5 - EST 2006
--5 u E%sT
 R V 1946 o - Ap lastSu 2 1 D
 R V 1946 o - S lastSu 2 0 S
 R V 1953 1954 - Ap lastSu 2 1 D
@@ -2766,68 +1515,23 @@ R V 1956 1963 - Ap lastSu 2 1 D
 R V 1960 o - O lastSu 2 0 S
 R V 1961 o - S lastSu 2 0 S
 R V 1962 1963 - O lastSu 2 0 S
-Z America/Indiana/Vincennes -5:50:7 - LMT 1883 N 18 18u
--6 u C%sT 1946
--6 V C%sT 1964 Ap 26 2
--5 - EST 1969
--5 u E%sT 1971
--5 - EST 2006 Ap 2 2
--6 u C%sT 2007 N 4 2
--5 u E%sT
 R Pe 1955 o - May 1 0 1 D
 R Pe 1955 1960 - S lastSu 2 0 S
 R Pe 1956 1963 - Ap lastSu 2 1 D
 R Pe 1961 1963 - O lastSu 2 0 S
-Z America/Indiana/Tell_City -5:47:3 - LMT 1883 N 18 18u
--6 u C%sT 1946
--6 Pe C%sT 1964 Ap 26 2
--5 - EST 1967 O 29 2
--6 u C%sT 1969 Ap 27 2
--5 u E%sT 1971
--5 - EST 2006 Ap 2 2
--6 u C%sT
 R Pi 1955 o - May 1 0 1 D
 R Pi 1955 1960 - S lastSu 2 0 S
 R Pi 1956 1964 - Ap lastSu 2 1 D
 R Pi 1961 1964 - O lastSu 2 0 S
-Z America/Indiana/Petersburg -5:49:7 - LMT 1883 N 18 18u
--6 u C%sT 1955
--6 Pi C%sT 1965 Ap 25 2
--5 - EST 1966 O 30 2
--6 u C%sT 1977 O 30 2
--5 - EST 2006 Ap 2 2
--6 u C%sT 2007 N 4 2
--5 u E%sT
 R St 1947 1961 - Ap lastSu 2 1 D
 R St 1947 1954 - S lastSu 2 0 S
 R St 1955 1956 - O lastSu 2 0 S
 R St 1957 1958 - S lastSu 2 0 S
 R St 1959 1961 - O lastSu 2 0 S
-Z America/Indiana/Knox -5:46:30 - LMT 1883 N 18 18u
--6 u C%sT 1947
--6 St C%sT 1962 Ap 29 2
--5 - EST 1963 O 27 2
--6 u C%sT 1991 O 27 2
--5 - EST 2006 Ap 2 2
--6 u C%sT
 R Pu 1946 1960 - Ap lastSu 2 1 D
 R Pu 1946 1954 - S lastSu 2 0 S
 R Pu 1955 1956 - O lastSu 2 0 S
 R Pu 1957 1960 - S lastSu 2 0 S
-Z America/Indiana/Winamac -5:46:25 - LMT 1883 N 18 18u
--6 u C%sT 1946
--6 Pu C%sT 1961 Ap 30 2
--5 - EST 1969
--5 u E%sT 1971
--5 - EST 2006 Ap 2 2
--6 u C%sT 2007 Mar 11 2
--5 u E%sT
-Z America/Indiana/Vevay -5:40:16 - LMT 1883 N 18 18u
--6 u C%sT 1954 Ap 25 2
--5 - EST 1969
--5 u E%sT 1973
--5 - EST 2006
--5 u E%sT
 R v 1921 o - May 1 2 1 D
 R v 1921 o - S 1 2 0 S
 R v 1941 o - Ap lastSu 2 1 D
@@ -2837,41 +1541,12 @@ R v 1946 o - Jun 2 2 0 S
 R v 1950 1961 - Ap lastSu 2 1 D
 R v 1950 1955 - S lastSu 2 0 S
 R v 1956 1961 - O lastSu 2 0 S
-Z America/Kentucky/Louisville -5:43:2 - LMT 1883 N 18 18u
--6 u C%sT 1921
--6 v C%sT 1942
--6 u C%sT 1946
--6 v C%sT 1961 Jul 23 2
--5 - EST 1968
--5 u E%sT 1974 Ja 6 2
--6 1 CDT 1974 O 27 2
--5 u E%sT
-Z America/Kentucky/Monticello -5:39:24 - LMT 1883 N 18 18u
--6 u C%sT 1946
--6 - CST 1968
--6 u C%sT 2000 O 29 2
--5 u E%sT
 R Dt 1948 o - Ap lastSu 2 1 D
 R Dt 1948 o - S lastSu 2 0 S
-Z America/Detroit -5:32:11 - LMT 1905
--6 - CST 1915 May 15 2
--5 - EST 1942
--5 u E%sT 1946
--5 Dt E%sT 1967 Jun 14 0:1
--5 u E%sT 1969
--5 - EST 1973
--5 u E%sT 1975
--5 - EST 1975 Ap 27 2
--5 u E%sT
 R Me 1946 o - Ap lastSu 2 1 D
 R Me 1946 o - S lastSu 2 0 S
 R Me 1966 o - Ap lastSu 2 1 D
 R Me 1966 o - O lastSu 2 0 S
-Z America/Menominee -5:50:27 - LMT 1885 S 18 12
--6 u C%sT 1946
--6 Me C%sT 1969 Ap 27 2
--5 - EST 1973 Ap 29 2
--6 u C%sT
 R C 1918 o - Ap 14 2 1 D
 R C 1918 o - O 27 2 0 S
 R C 1942 o - F 9 2 1 W
@@ -2901,24 +1576,6 @@ R j 1988 o - Ap Su>=1 0:1 2 DD
 R j 1989 2006 - Ap Su>=1 0:1 1 D
 R j 2007 2011 - Mar Su>=8 0:1 1 D
 R j 2007 2010 - N Su>=1 0:1 0 S
-Z America/St_Johns -3:30:52 - LMT 1884
--3:30:52 j N%sT 1918
--3:30:52 C N%sT 1919
--3:30:52 j N%sT 1935 Mar 30
--3:30 j N%sT 1942 May 11
--3:30 C N%sT 1946
--3:30 j N%sT 2011 N
--3:30 C N%sT
-Z America/Goose_Bay -4:1:40 - LMT 1884
--3:30:52 - NST 1918
--3:30:52 C N%sT 1919
--3:30:52 - NST 1935 Mar 30
--3:30 - NST 1936
--3:30 j N%sT 1942 May 11
--3:30 C N%sT 1946
--3:30 j N%sT 1966 Mar 15 2
--4 j A%sT 2011 N
--4 C A%sT
 R H 1916 o - Ap 1 0 1 D
 R H 1916 o - O 1 0 0 S
 R H 1920 o - May 9 0 1 D
@@ -2960,19 +1617,6 @@ R H 1956 1959 - Ap lastSu 2 1 D
 R H 1956 1959 - S lastSu 2 0 S
 R H 1962 1973 - Ap lastSu 2 1 D
 R H 1962 1973 - O lastSu 2 0 S
-Z America/Halifax -4:14:24 - LMT 1902 Jun 15
--4 H A%sT 1918
--4 C A%sT 1919
--4 H A%sT 1942 F 9 2s
--4 C A%sT 1946
--4 H A%sT 1974
--4 C A%sT
-Z America/Glace_Bay -3:59:48 - LMT 1902 Jun 15
--4 C A%sT 1953
--4 H A%sT 1954
--4 - AST 1972
--4 H A%sT 1974
--4 C A%sT
 R o 1933 1935 - Jun Su>=8 1 1 D
 R o 1933 1935 - S Su>=8 1 0 S
 R o 1936 1938 - Jun Su>=1 1 1 D
@@ -2986,15 +1630,6 @@ R o 1946 1956 - S lastSu 2 0 S
 R o 1957 1972 - O lastSu 2 0 S
 R o 1993 2006 - Ap Su>=1 0:1 1 D
 R o 1993 2006 - O lastSu 0:1 0 S
-Z America/Moncton -4:19:8 - LMT 1883 D 9
--5 - EST 1902 Jun 15
--4 C A%sT 1933
--4 o A%sT 1942
--4 C A%sT 1946
--4 o A%sT 1973
--4 C A%sT 1993
--4 o A%sT 2007
--4 C A%sT
 R t 1919 o - Mar 30 23:30 1 D
 R t 1919 o - O 26 0 0 S
 R t 1920 o - May 2 2 1 D
@@ -3008,21 +1643,11 @@ R t 1927 1937 - S Su>=25 2 0 S
 R t 1928 1937 - Ap Su>=25 2 1 D
 R t 1938 1940 - Ap lastSu 2 1 D
 R t 1938 1939 - S lastSu 2 0 S
-R t 1945 1946 - S lastSu 2 0 S
-R t 1946 o - Ap lastSu 2 1 D
-R t 1947 1949 - Ap lastSu 0 1 D
-R t 1947 1948 - S lastSu 0 0 S
-R t 1949 o - N lastSu 0 0 S
-R t 1950 1973 - Ap lastSu 2 1 D
-R t 1950 o - N lastSu 2 0 S
+R t 1945 1948 - S lastSu 2 0 S
+R t 1946 1973 - Ap lastSu 2 1 D
+R t 1949 1950 - N lastSu 2 0 S
 R t 1951 1956 - S lastSu 2 0 S
 R t 1957 1973 - O lastSu 2 0 S
-Z America/Toronto -5:17:32 - LMT 1895
--5 C E%sT 1919
--5 t E%sT 1942 F 9 2s
--5 C E%sT 1946
--5 t E%sT 1974
--5 C E%sT
 R W 1916 o - Ap 23 0 1 D
 R W 1916 o - S 17 0 0 S
 R W 1918 o - Ap 14 2 1 D
@@ -3047,9 +1672,6 @@ R W 1963 o - S 22 2 0 S
 R W 1966 1986 - Ap lastSu 2s 1 D
 R W 1966 2005 - O lastSu 2s 0 S
 R W 1987 2005 - Ap Su>=1 2s 1 D
-Z America/Winnipeg -6:28:36 - LMT 1887 Jul 16
--6 W C%sT 2006
--6 C C%sT
 R r 1918 o - Ap 14 2 1 D
 R r 1918 o - O 27 2 0 S
 R r 1930 1934 - May Su>=1 0 1 D
@@ -3072,14 +1694,6 @@ R Sw 1957 o - O lastSu 2 0 S
 R Sw 1959 1961 - Ap lastSu 2 1 D
 R Sw 1959 o - O lastSu 2 0 S
 R Sw 1960 1961 - S lastSu 2 0 S
-Z America/Regina -6:58:36 - LMT 1905 S
--7 r M%sT 1960 Ap lastSu 2
--6 - CST
-Z America/Swift_Current -7:11:20 - LMT 1905 S
--7 C M%sT 1946 Ap lastSu 2
--7 r M%sT 1950
--7 Sw M%sT 1972 Ap lastSu 2
--6 - CST
 R Ed 1918 1919 - Ap Su>=8 2 1 D
 R Ed 1918 o - O 27 2 0 S
 R Ed 1919 o - May 27 2 0 S
@@ -3093,9 +1707,6 @@ R Ed 1947 o - Ap lastSu 2 1 D
 R Ed 1947 o - S lastSu 2 0 S
 R Ed 1972 1986 - Ap lastSu 2 1 D
 R Ed 1972 2006 - O lastSu 2 0 S
-Z America/Edmonton -7:33:52 - LMT 1906 S
--7 Ed M%sT 1987
--7 C M%sT
 R Va 1918 o - Ap 14 2 1 D
 R Va 1918 o - O 27 2 0 S
 R Va 1942 o - F 9 2 1 W
@@ -3105,19 +1716,6 @@ R Va 1946 1986 - Ap lastSu 2 1 D
 R Va 1946 o - S 29 2 0 S
 R Va 1947 1961 - S lastSu 2 0 S
 R Va 1962 2006 - O lastSu 2 0 S
-Z America/Vancouver -8:12:28 - LMT 1884
--8 Va P%sT 1987
--8 C P%sT
-Z America/Dawson_Creek -8:0:56 - LMT 1884
--8 C P%sT 1947
--8 Va P%sT 1972 Au 30 2
--7 - MST
-Z America/Fort_Nelson -8:10:47 - LMT 1884
--8 Va P%sT 1946
--8 - PST 1947
--8 Va P%sT 1987
--8 C P%sT 2015 Mar 8 2
--7 - MST
 R Y 1918 o - Ap 14 2 1 D
 R Y 1918 o - O 27 2 0 S
 R Y 1919 o - May 25 2 1 D
@@ -3130,42 +1728,6 @@ R Y 1972 2006 - O lastSu 2 0 S
 R Y 1987 2006 - Ap Su>=1 2 1 D
 R Yu 1965 o - Ap lastSu 0 2 DD
 R Yu 1965 o - O lastSu 2 0 S
-Z America/Iqaluit 0 - -00 1942 Au
--5 Y E%sT 1999 O 31 2
--6 C C%sT 2000 O 29 2
--5 C E%sT
-Z America/Resolute 0 - -00 1947 Au 31
--6 Y C%sT 2000 O 29 2
--5 - EST 2001 Ap 1 3
--6 C C%sT 2006 O 29 2
--5 - EST 2007 Mar 11 3
--6 C C%sT
-Z America/Rankin_Inlet 0 - -00 1957
--6 Y C%sT 2000 O 29 2
--5 - EST 2001 Ap 1 3
--6 C C%sT
-Z America/Cambridge_Bay 0 - -00 1920
--7 Y M%sT 1999 O 31 2
--6 C C%sT 2000 O 29 2
--5 - EST 2000 N 5
--6 - CST 2001 Ap 1 3
--7 C M%sT
-Z America/Inuvik 0 - -00 1953
--8 Y P%sT 1979 Ap lastSu 2
--7 Y M%sT 1980
--7 C M%sT
-Z America/Whitehorse -9:0:12 - LMT 1900 Au 20
--9 Y Y%sT 1965
--9 Yu Y%sT 1966 F 27
--8 - PST 1980
--8 C P%sT 2020 N
--7 - MST
-Z America/Dawson -9:17:40 - LMT 1900 Au 20
--9 Y Y%sT 1965
--9 Yu Y%sT 1973 O 28
--8 - PST 1980
--8 C P%sT 2020 N
--7 - MST
 R m 1931 o - May 1 23 1 D
 R m 1931 o - O 1 0 0 S
 R m 1939 o - F 5 0 1 D
@@ -3182,107 +1744,6 @@ R m 2001 o - May Su>=1 2 1 D
 R m 2001 o - S lastSu 2 0 S
 R m 2002 2022 - Ap Su>=1 2 1 D
 R m 2002 2022 - O lastSu 2 0 S
-Z America/Cancun -5:47:4 - LMT 1922 Ja 1 6u
--6 - CST 1981 D 23
--5 m E%sT 1998 Au 2 2
--6 m C%sT 2015 F 1 2
--5 - EST
-Z America/Merida -5:58:28 - LMT 1922 Ja 1 6u
--6 - CST 1981 D 23
--5 - EST 1982 D 2
--6 m C%sT
-Z America/Matamoros -6:30 - LMT 1922 Ja 1 6u
--6 - CST 1988
--6 u C%sT 1989
--6 m C%sT 2010
--6 u C%sT
-Z America/Monterrey -6:41:16 - LMT 1922 Ja 1 6u
--6 - CST 1988
--6 u C%sT 1989
--6 m C%sT
-Z America/Mexico_City -6:36:36 - LMT 1922 Ja 1 7u
--7 - MST 1927 Jun 10 23
--6 - CST 1930 N 15
--7 m M%sT 1932 Ap
--6 m C%sT 2001 S 30 2
--6 - CST 2002 F 20
--6 m C%sT
-Z America/Ciudad_Juarez -7:5:56 - LMT 1922 Ja 1 7u
--7 - MST 1927 Jun 10 23
--6 - CST 1930 N 15
--7 m M%sT 1932 Ap
--6 - CST 1996
--6 m C%sT 1998
--6 - CST 1998 Ap Su>=1 3
--7 m M%sT 2010
--7 u M%sT 2022 O 30 2
--6 - CST 2022 N 30
--7 u M%sT
-Z America/Ojinaga -6:57:40 - LMT 1922 Ja 1 7u
--7 - MST 1927 Jun 10 23
--6 - CST 1930 N 15
--7 m M%sT 1932 Ap
--6 - CST 1996
--6 m C%sT 1998
--6 - CST 1998 Ap Su>=1 3
--7 m M%sT 2010
--7 u M%sT 2022 O 30 2
--6 - CST 2022 N 30
--6 u C%sT
-Z America/Chihuahua -7:4:20 - LMT 1922 Ja 1 7u
--7 - MST 1927 Jun 10 23
--6 - CST 1930 N 15
--7 m M%sT 1932 Ap
--6 - CST 1996
--6 m C%sT 1998
--6 - CST 1998 Ap Su>=1 3
--7 m M%sT 2022 O 30 2
--6 - CST
-Z America/Hermosillo -7:23:52 - LMT 1922 Ja 1 7u
--7 - MST 1927 Jun 10 23
--6 - CST 1930 N 15
--7 m M%sT 1932 Ap
--6 - CST 1942 Ap 24
--7 - MST 1949 Ja 14
--8 - PST 1970
--7 m M%sT 1999
--7 - MST
-Z America/Mazatlan -7:5:40 - LMT 1922 Ja 1 7u
--7 - MST 1927 Jun 10 23
--6 - CST 1930 N 15
--7 m M%sT 1932 Ap
--6 - CST 1942 Ap 24
--7 - MST 1949 Ja 14
--8 - PST 1970
--7 m M%sT
-Z America/Bahia_Banderas -7:1 - LMT 1922 Ja 1 7u
--7 - MST 1927 Jun 10 23
--6 - CST 1930 N 15
--7 m M%sT 1932 Ap
--6 - CST 1942 Ap 24
--7 - MST 1949 Ja 14
--8 - PST 1970
--7 m M%sT 2010 Ap 4 2
--6 m C%sT
-Z America/Tijuana -7:48:4 - LMT 1922 Ja 1 7u
--7 - MST 1924
--8 - PST 1927 Jun 10 23
--7 - MST 1930 N 15
--8 - PST 1931 Ap
--8 1 PDT 1931 S 30
--8 - PST 1942 Ap 24
--8 1 PWT 1945 Au 14 23u
--8 1 PPT 1945 N 12
--8 - PST 1948 Ap 5
--8 1 PDT 1949 Ja 14
--8 - PST 1954
--8 CA P%sT 1961
--8 - PST 1976
--8 u P%sT 1996
--8 m P%sT 2001
--8 u P%sT 2002 F 20
--8 m P%sT 2010
--8 u P%sT
 R BB 1942 o - Ap 19 5u 1 D
 R BB 1942 o - Au 31 6u 0 S
 R BB 1943 o - May 2 5u 1 D
@@ -3294,10 +1755,6 @@ R BB 1977 1978 - O Su>=1 2 0 S
 R BB 1978 1980 - Ap Su>=15 2 1 D
 R BB 1979 o - S 30 2 0 S
 R BB 1980 o - S 25 2 0 S
-Z America/Barbados -3:58:29 - LMT 1911 Au 28
--4 BB A%sT 1944
--4 BB AST/-0330 1945
--4 BB A%sT
 R BZ 1918 1941 - O Sa>=1 24 0:30 -0530
 R BZ 1919 1942 - F Sa>=8 24 0 CST
 R BZ 1942 o - Jun 27 24 1 CWT
@@ -3309,8 +1766,6 @@ R BZ 1973 o - D 5 0 1 CDT
 R BZ 1974 o - F 9 0 0 CST
 R BZ 1982 o - D 18 0 1 CDT
 R BZ 1983 o - F 12 0 0 CST
-Z America/Belize -5:52:48 - LMT 1912 Ap
--6 BZ %s
 R Be 1917 o - Ap 5 24 1 -
 R Be 1917 o - S 30 24 0 -
 R Be 1918 o - Ap 13 24 1 -
@@ -3327,19 +1782,11 @@ R Be 1948 1952 - May Su>=22 2 1 D
 R Be 1948 1952 - S Su>=1 2 0 S
 R Be 1956 o - May Su>=22 2 1 D
 R Be 1956 o - O lastSu 2 0 S
-Z Atlantic/Bermuda -4:19:18 - LMT 1890
--4:19:18 Be BMT/BST 1930 Ja 1 2
--4 Be A%sT 1974 Ap 28 2
--4 C A%sT 1976
--4 u A%sT
 R CR 1979 1980 - F lastSu 0 1 D
 R CR 1979 1980 - Jun Su>=1 0 0 S
 R CR 1991 1992 - Ja Sa>=15 0 1 D
 R CR 1991 o - Jul 1 0 0 S
 R CR 1992 o - Mar 15 0 0 S
-Z America/Costa_Rica -5:36:13 - LMT 1890
--5:36:13 - SJMT 1921 Ja 15
--6 CR C%sT
 R Q 1928 o - Jun 10 0 1 D
 R Q 1928 o - O 10 0 0 S
 R Q 1940 1942 - Jun Su>=1 0 1 D
@@ -3379,25 +1826,14 @@ R Q 2011 o - N 13 0s 0 S
 R Q 2012 o - Ap 1 0s 1 D
 R Q 2012 ma - N Su>=1 0s 0 S
 R Q 2013 ma - Mar Su>=8 0s 1 D
-Z America/Havana -5:29:28 - LMT 1890
--5:29:36 - HMT 1925 Jul 19 12
--5 Q C%sT
 R DO 1966 o - O 30 0 1 EDT
 R DO 1967 o - F 28 0 0 EST
 R DO 1969 1973 - O lastSu 0 0:30 -0430
 R DO 1970 o - F 21 0 0 EST
 R DO 1971 o - Ja 20 0 0 EST
 R DO 1972 1974 - Ja 21 0 0 EST
-Z America/Santo_Domingo -4:39:36 - LMT 1890
--4:40 - SDMT 1933 Ap 1 12
--5 DO %s 1974 O 27
--4 - AST 2000 O 29 2
--5 u E%sT 2000 D 3 1
--4 - AST
 R SV 1987 1988 - May Su>=1 0 1 D
 R SV 1987 1988 - S lastSu 0 0 S
-Z America/El_Salvador -5:56:48 - LMT 1921
--6 SV C%sT
 R GT 1973 o - N 25 0 1 D
 R GT 1974 o - F 24 0 0 S
 R GT 1983 o - May 21 0 1 D
@@ -3406,8 +1842,6 @@ R GT 1991 o - Mar 23 0 1 D
 R GT 1991 o - S 7 0 0 S
 R GT 2006 o - Ap 30 0 1 D
 R GT 2006 o - O 1 0 0 S
-Z America/Guatemala -6:2:4 - LMT 1918 O 5
--6 GT C%sT
 R HT 1983 o - May 8 0 1 D
 R HT 1984 1987 - Ap lastSu 0 1 D
 R HT 1983 1987 - O lastSu 0 0 S
@@ -3419,57 +1853,16 @@ R HT 2012 2015 - Mar Su>=8 2 1 D
 R HT 2012 2015 - N Su>=1 2 0 S
 R HT 2017 ma - Mar Su>=8 2 1 D
 R HT 2017 ma - N Su>=1 2 0 S
-Z America/Port-au-Prince -4:49:20 - LMT 1890
--4:49 - PPMT 1917 Ja 24 12
--5 HT E%sT
 R HN 1987 1988 - May Su>=1 0 1 D
 R HN 1987 1988 - S lastSu 0 0 S
 R HN 2006 o - May Su>=1 0 1 D
 R HN 2006 o - Au M>=1 0 0 S
-Z America/Tegucigalpa -5:48:52 - LMT 1921 Ap
--6 HN C%sT
-Z America/Jamaica -5:7:10 - LMT 1890
--5:7:10 - KMT 1912 F
--5 - EST 1974
--5 u E%sT 1984
--5 - EST
-Z America/Martinique -4:4:20 - LMT 1890
--4:4:20 - FFMT 1911 May
--4 - AST 1980 Ap 6
--4 1 ADT 1980 S 28
--4 - AST
 R NI 1979 1980 - Mar Su>=16 0 1 D
 R NI 1979 1980 - Jun M>=23 0 0 S
 R NI 2005 o - Ap 10 0 1 D
 R NI 2005 o - O Su>=1 0 0 S
 R NI 2006 o - Ap 30 2 1 D
 R NI 2006 o - O Su>=1 1 0 S
-Z America/Managua -5:45:8 - LMT 1890
--5:45:12 - MMT 1934 Jun 23
--6 - CST 1973 May
--5 - EST 1975 F 16
--6 NI C%sT 1992 Ja 1 4
--5 - EST 1992 S 24
--6 - CST 1993
--5 - EST 1997
--6 NI C%sT
-Z America/Panama -5:18:8 - LMT 1890
--5:19:36 - CMT 1908 Ap 22
--5 - EST
-Z America/Puerto_Rico -4:24:25 - LMT 1899 Mar 28 12
--4 - AST 1942 May 3
--4 u A%sT 1946
--4 - AST
-Z America/Miquelon -3:44:40 - LMT 1911 May 15
--4 - AST 1980 May
--3 - -03 1987
--3 C -03/-02
-Z America/Grand_Turk -4:44:32 - LMT 1890
--5:7:10 - KMT 1912 F
--5 - EST 1979
--5 u E%sT 2015 Mar 8 2
--4 - AST 2018 Mar 11 3
--5 u E%sT
 R A 1930 o - D 1 0 1 -
 R A 1931 o - Ap 1 0 0 -
 R A 1931 o - O 15 0 1 -
@@ -3499,150 +1892,8 @@ R A 2000 o - Mar 3 0 0 -
 R A 2007 o - D 30 0 1 -
 R A 2008 2009 - Mar Su>=15 0 0 -
 R A 2008 o - O Su>=15 0 1 -
-Z America/Argentina/Buenos_Aires -3:53:48 - LMT 1894 O 31
--4:16:48 - CMT 1920 May
--4 - -04 1930 D
--4 A -04/-03 1969 O 5
--3 A -03/-02 1999 O 3
--4 A -04/-03 2000 Mar 3
--3 A -03/-02
-Z America/Argentina/Cordoba -4:16:48 - LMT 1894 O 31
--4:16:48 - CMT 1920 May
--4 - -04 1930 D
--4 A -04/-03 1969 O 5
--3 A -03/-02 1991 Mar 3
--4 - -04 1991 O 20
--3 A -03/-02 1999 O 3
--4 A -04/-03 2000 Mar 3
--3 A -03/-02
-Z America/Argentina/Salta -4:21:40 - LMT 1894 O 31
--4:16:48 - CMT 1920 May
--4 - -04 1930 D
--4 A -04/-03 1969 O 5
--3 A -03/-02 1991 Mar 3
--4 - -04 1991 O 20
--3 A -03/-02 1999 O 3
--4 A -04/-03 2000 Mar 3
--3 A -03/-02 2008 O 18
--3 - -03
-Z America/Argentina/Tucuman -4:20:52 - LMT 1894 O 31
--4:16:48 - CMT 1920 May
--4 - -04 1930 D
--4 A -04/-03 1969 O 5
--3 A -03/-02 1991 Mar 3
--4 - -04 1991 O 20
--3 A -03/-02 1999 O 3
--4 A -04/-03 2000 Mar 3
--3 - -03 2004 Jun
--4 - -04 2004 Jun 13
--3 A -03/-02
-Z America/Argentina/La_Rioja -4:27:24 - LMT 1894 O 31
--4:16:48 - CMT 1920 May
--4 - -04 1930 D
--4 A -04/-03 1969 O 5
--3 A -03/-02 1991 Mar
--4 - -04 1991 May 7
--3 A -03/-02 1999 O 3
--4 A -04/-03 2000 Mar 3
--3 - -03 2004 Jun
--4 - -04 2004 Jun 20
--3 A -03/-02 2008 O 18
--3 - -03
-Z America/Argentina/San_Juan -4:34:4 - LMT 1894 O 31
--4:16:48 - CMT 1920 May
--4 - -04 1930 D
--4 A -04/-03 1969 O 5
--3 A -03/-02 1991 Mar
--4 - -04 1991 May 7
--3 A -03/-02 1999 O 3
--4 A -04/-03 2000 Mar 3
--3 - -03 2004 May 31
--4 - -04 2004 Jul 25
--3 A -03/-02 2008 O 18
--3 - -03
-Z America/Argentina/Jujuy -4:21:12 - LMT 1894 O 31
--4:16:48 - CMT 1920 May
--4 - -04 1930 D
--4 A -04/-03 1969 O 5
--3 A -03/-02 1990 Mar 4
--4 - -04 1990 O 28
--4 1 -03 1991 Mar 17
--4 - -04 1991 O 6
--3 1 -02 1992
--3 A -03/-02 1999 O 3
--4 A -04/-03 2000 Mar 3
--3 A -03/-02 2008 O 18
--3 - -03
-Z America/Argentina/Catamarca -4:23:8 - LMT 1894 O 31
--4:16:48 - CMT 1920 May
--4 - -04 1930 D
--4 A -04/-03 1969 O 5
--3 A -03/-02 1991 Mar 3
--4 - -04 1991 O 20
--3 A -03/-02 1999 O 3
--4 A -04/-03 2000 Mar 3
--3 - -03 2004 Jun
--4 - -04 2004 Jun 20
--3 A -03/-02 2008 O 18
--3 - -03
-Z America/Argentina/Mendoza -4:35:16 - LMT 1894 O 31
--4:16:48 - CMT 1920 May
--4 - -04 1930 D
--4 A -04/-03 1969 O 5
--3 A -03/-02 1990 Mar 4
--4 - -04 1990 O 15
--4 1 -03 1991 Mar
--4 - -04 1991 O 15
--4 1 -03 1992 Mar
--4 - -04 1992 O 18
--3 A -03/-02 1999 O 3
--4 A -04/-03 2000 Mar 3
--3 - -03 2004 May 23
--4 - -04 2004 S 26
--3 A -03/-02 2008 O 18
--3 - -03
 R Sa 2008 2009 - Mar Su>=8 0 0 -
 R Sa 2007 2008 - O Su>=8 0 1 -
-Z America/Argentina/San_Luis -4:25:24 - LMT 1894 O 31
--4:16:48 - CMT 1920 May
--4 - -04 1930 D
--4 A -04/-03 1969 O 5
--3 A -03/-02 1990
--3 1 -02 1990 Mar 14
--4 - -04 1990 O 15
--4 1 -03 1991 Mar
--4 - -04 1991 Jun
--3 - -03 1999 O 3
--4 1 -03 2000 Mar 3
--3 - -03 2004 May 31
--4 - -04 2004 Jul 25
--3 A -03/-02 2008 Ja 21
--4 Sa -04/-03 2009 O 11
--3 - -03
-Z America/Argentina/Rio_Gallegos -4:36:52 - LMT 1894 O 31
--4:16:48 - CMT 1920 May
--4 - -04 1930 D
--4 A -04/-03 1969 O 5
--3 A -03/-02 1999 O 3
--4 A -04/-03 2000 Mar 3
--3 - -03 2004 Jun
--4 - -04 2004 Jun 20
--3 A -03/-02 2008 O 18
--3 - -03
-Z America/Argentina/Ushuaia -4:33:12 - LMT 1894 O 31
--4:16:48 - CMT 1920 May
--4 - -04 1930 D
--4 A -04/-03 1969 O 5
--3 A -03/-02 1999 O 3
--4 A -04/-03 2000 Mar 3
--3 - -03 2004 May 30
--4 - -04 2004 Jun 20
--3 A -03/-02 2008 O 18
--3 - -03
-Z America/La_Paz -4:32:36 - LMT 1890
--4:32:36 - CMT 1931 O 15
--4:32:36 1 BST 1932 Mar 21
--4 - -04
 R B 1931 o - O 3 11 1 -
 R B 1932 1933 - Ap 1 0 0 -
 R B 1932 o - O 3 0 1 -
@@ -3700,90 +1951,6 @@ R B 2013 2014 - F Su>=15 0 0 -
 R B 2015 o - F Su>=22 0 0 -
 R B 2016 2019 - F Su>=15 0 0 -
 R B 2018 o - N Su>=1 0 1 -
-Z America/Noronha -2:9:40 - LMT 1914
--2 B -02/-01 1990 S 17
--2 - -02 1999 S 30
--2 B -02/-01 2000 O 15
--2 - -02 2001 S 13
--2 B -02/-01 2002 O
--2 - -02
-Z America/Belem -3:13:56 - LMT 1914
--3 B -03/-02 1988 S 12
--3 - -03
-Z America/Santarem -3:38:48 - LMT 1914
--4 B -04/-03 1988 S 12
--4 - -04 2008 Jun 24
--3 - -03
-Z America/Fortaleza -2:34 - LMT 1914
--3 B -03/-02 1990 S 17
--3 - -03 1999 S 30
--3 B -03/-02 2000 O 22
--3 - -03 2001 S 13
--3 B -03/-02 2002 O
--3 - -03
-Z America/Recife -2:19:36 - LMT 1914
--3 B -03/-02 1990 S 17
--3 - -03 1999 S 30
--3 B -03/-02 2000 O 15
--3 - -03 2001 S 13
--3 B -03/-02 2002 O
--3 - -03
-Z America/Araguaina -3:12:48 - LMT 1914
--3 B -03/-02 1990 S 17
--3 - -03 1995 S 14
--3 B -03/-02 2003 S 24
--3 - -03 2012 O 21
--3 B -03/-02 2013 S
--3 - -03
-Z America/Maceio -2:22:52 - LMT 1914
--3 B -03/-02 1990 S 17
--3 - -03 1995 O 13
--3 B -03/-02 1996 S 4
--3 - -03 1999 S 30
--3 B -03/-02 2000 O 22
--3 - -03 2001 S 13
--3 B -03/-02 2002 O
--3 - -03
-Z America/Bahia -2:34:4 - LMT 1914
--3 B -03/-02 2003 S 24
--3 - -03 2011 O 16
--3 B -03/-02 2012 O 21
--3 - -03
-Z America/Sao_Paulo -3:6:28 - LMT 1914
--3 B -03/-02 1963 O 23
--3 1 -02 1964
--3 B -03/-02
-Z America/Campo_Grande -3:38:28 - LMT 1914
--4 B -04/-03
-Z America/Cuiaba -3:44:20 - LMT 1914
--4 B -04/-03 2003 S 24
--4 - -04 2004 O
--4 B -04/-03
-Z America/Porto_Velho -4:15:36 - LMT 1914
--4 B -04/-03 1988 S 12
--4 - -04
-Z America/Boa_Vista -4:2:40 - LMT 1914
--4 B -04/-03 1988 S 12
--4 - -04 1999 S 30
--4 B -04/-03 2000 O 15
--4 - -04
-Z America/Manaus -4:0:4 - LMT 1914
--4 B -04/-03 1988 S 12
--4 - -04 1993 S 28
--4 B -04/-03 1994 S 22
--4 - -04
-Z America/Eirunepe -4:39:28 - LMT 1914
--5 B -05/-04 1988 S 12
--5 - -05 1993 S 28
--5 B -05/-04 1994 S 22
--5 - -05 2008 Jun 24
--4 - -04 2013 N 10
--5 - -05
-Z America/Rio_Branco -4:31:12 - LMT 1914
--5 B -05/-04 1988 S 12
--5 - -05 2008 Jun 24
--4 - -04 2013 N 10
--5 - -05
 R x 1927 1931 - S 1 0 1 -
 R x 1928 1932 - Ap 1 0 0 -
 R x 1968 o - N 3 4u 1 -
@@ -3820,56 +1987,10 @@ R x 2019 ma - Ap Su>=2 3u 0 -
 R x 2019 2021 - S Su>=2 4u 1 -
 R x 2022 o - S Su>=9 4u 1 -
 R x 2023 ma - S Su>=2 4u 1 -
-Z America/Santiago -4:42:45 - LMT 1890
--4:42:45 - SMT 1910 Ja 10
--5 - -05 1916 Jul
--4:42:45 - SMT 1918 S 10
--4 - -04 1919 Jul
--4:42:45 - SMT 1927 S
--5 x -05/-04 1932 S
--4 - -04 1942 Jun
--5 - -05 1942 Au
--4 - -04 1946 Jul 14 24
--4 1 -03 1946 Au 28 24
--5 1 -04 1947 Mar 31 24
--5 - -05 1947 May 21 23
--4 x -04/-03
-Z America/Punta_Arenas -4:43:40 - LMT 1890
--4:42:45 - SMT 1910 Ja 10
--5 - -05 1916 Jul
--4:42:45 - SMT 1918 S 10
--4 - -04 1919 Jul
--4:42:45 - SMT 1927 S
--5 x -05/-04 1932 S
--4 - -04 1942 Jun
--5 - -05 1942 Au
--4 - -04 1946 Au 28 24
--5 1 -04 1947 Mar 31 24
--5 - -05 1947 May 21 23
--4 x -04/-03 2016 D 4
--3 - -03
-Z Pacific/Easter -7:17:28 - LMT 1890
--7:17:28 - EMT 1932 S
--7 x -07/-06 1982 Mar 14 3u
--6 x -06/-05
-Z Antarctica/Palmer 0 - -00 1965
--4 A -04/-03 1969 O 5
--3 A -03/-02 1982 May
--4 x -04/-03 2016 D 4
--3 - -03
 R CO 1992 o - May 3 0 1 -
 R CO 1993 o - F 6 24 0 -
-Z America/Bogota -4:56:16 - LMT 1884 Mar 13
--4:56:16 - BMT 1914 N 23
--5 CO -05/-04
 R EC 1992 o - N 28 0 1 -
 R EC 1993 o - F 5 0 0 -
-Z America/Guayaquil -5:19:20 - LMT 1890
--5:14 - QMT 1931
--5 EC -05/-04
-Z Pacific/Galapagos -5:58:24 - LMT 1931
--5 - -05 1986
--6 EC -06/-05
 R FK 1937 1938 - S lastSu 0 1 -
 R FK 1938 1942 - Mar Su>=19 0 0 -
 R FK 1939 o - O 1 0 1 -
@@ -3882,20 +2003,6 @@ R FK 1985 2000 - S Su>=9 0 1 -
 R FK 1986 2000 - Ap Su>=16 0 0 -
 R FK 2001 2010 - Ap Su>=15 2 0 -
 R FK 2001 2010 - S Su>=1 2 1 -
-Z Atlantic/Stanley -3:51:24 - LMT 1890
--3:51:24 - SMT 1912 Mar 12
--4 FK -04/-03 1983 May
--3 FK -03/-02 1985 S 15
--4 FK -04/-03 2010 S 5 2
--3 - -03
-Z America/Cayenne -3:29:20 - LMT 1911 Jul
--4 - -04 1967 O
--3 - -03
-Z America/Guyana -3:52:39 - LMT 1911 Au
--4 - -04 1915 Mar
--3:45 - -0345 1975 Au
--3 - -03 1992 Mar 29 1
--4 - -04
 R y 1975 1988 - O 1 0 1 -
 R y 1975 1978 - Mar 1 0 0 -
 R y 1979 1991 - Ap 1 0 0 -
@@ -3918,11 +2025,6 @@ R y 2005 2009 - Mar Su>=8 0 0 -
 R y 2010 ma - O Su>=1 0 1 -
 R y 2010 2012 - Ap Su>=8 0 0 -
 R y 2013 ma - Mar Su>=22 0 0 -
-Z America/Asuncion -3:50:40 - LMT 1890
--3:50:40 - AMT 1931 O 10
--4 - -04 1972 O
--3 - -03 1974 Ap
--4 y -04/-03
 R PE 1938 o - Ja 1 0 1 -
 R PE 1938 o - Ap 1 0 0 -
 R PE 1938 1939 - S lastSu 0 1 -
@@ -3933,16 +2035,6 @@ R PE 1990 o - Ja 1 0 1 -
 R PE 1990 o - Ap 1 0 0 -
 R PE 1994 o - Ja 1 0 1 -
 R PE 1994 o - Ap 1 0 0 -
-Z America/Lima -5:8:12 - LMT 1890
--5:8:36 - LMT 1908 Jul 28
--5 PE -05/-04
-Z Atlantic/South_Georgia -2:26:8 - LMT 1890
--2 - -02
-Z America/Paramaribo -3:40:40 - LMT 1911
--3:40:52 - PMT 1935
--3:40:36 - PMT 1945 O
--3:30 - -0330 1984 O
--3 - -03
 R U 1923 1925 - O 1 0 0:30 -
 R U 1924 1926 - Ap 1 0 0 -
 R U 1933 1938 - O lastSu 0 0:30 -
@@ -3991,6 +2083,659 @@ R U 2005 o - Mar 27 2 0 -
 R U 2005 o - O 9 2 1 -
 R U 2006 2015 - Mar Su>=8 2 0 -
 R U 2006 2014 - O Su>=1 2 1 -
+Z Africa/Abidjan -0:16:8 - LMT 1912
+0 - GMT
+Z Africa/Algiers 0:12:12 - LMT 1891 Mar 16
+0:9:21 - PMT 1911 Mar 11
+0 d WE%sT 1940 F 25 2
+1 d CE%sT 1946 O 7
+0 - WET 1956 Ja 29
+1 - CET 1963 Ap 14
+0 d WE%sT 1977 O 21
+1 d CE%sT 1979 O 26
+0 d WE%sT 1981 May
+1 - CET
+Z Africa/Bissau -1:2:20 - LMT 1912 Ja 1 1u
+-1 - -01 1975
+0 - GMT
+Z Africa/Cairo 2:5:9 - LMT 1900 O
+2 K EE%sT
+Z Africa/Casablanca -0:30:20 - LMT 1913 O 26
+0 M +00/+01 1984 Mar 16
+1 - +01 1986
+0 M +00/+01 2018 O 28 3
+1 M +01/+00
+Z Africa/Ceuta -0:21:16 - LMT 1901 Ja 1 0u
+0 - WET 1918 May 6 23
+0 1 WEST 1918 O 7 23
+0 - WET 1924
+0 s WE%sT 1929
+0 - WET 1967
+0 Sp WE%sT 1984 Mar 16
+1 - CET 1986
+1 E CE%sT
+Z Africa/El_Aaiun -0:52:48 - LMT 1934
+-1 - -01 1976 Ap 14
+0 M +00/+01 2018 O 28 3
+1 M +01/+00
+Z Africa/Johannesburg 1:52 - LMT 1892 F 8
+1:30 - SAST 1903 Mar
+2 SA SAST
+Z Africa/Juba 2:6:28 - LMT 1931
+2 SD CA%sT 2000 Ja 15 12
+3 - EAT 2021 F
+2 - CAT
+Z Africa/Khartoum 2:10:8 - LMT 1931
+2 SD CA%sT 2000 Ja 15 12
+3 - EAT 2017 N
+2 - CAT
+Z Africa/Lagos 0:13:35 - LMT 1905 Jul
+0 - GMT 1908 Jul
+0:13:35 - LMT 1914
+0:30 - +0030 1919 S
+1 - WAT
+Z Africa/Maputo 2:10:20 - LMT 1903 Mar
+2 - CAT
+Z Africa/Monrovia -0:43:8 - LMT 1882
+-0:43:8 - MMT 1919 Mar
+-0:44:30 - MMT 1972 Ja 7
+0 - GMT
+Z Africa/Nairobi 2:27:16 - LMT 1908 May
+2:30 - +0230 1928 Jun 30 24
+3 - EAT 1930 Ja 4 24
+2:30 - +0230 1936 D 31 24
+2:45 - +0245 1942 Jul 31 24
+3 - EAT
+Z Africa/Ndjamena 1:0:12 - LMT 1912
+1 - WAT 1979 O 14
+1 1 WAST 1980 Mar 8
+1 - WAT
+Z Africa/Sao_Tome 0:26:56 - LMT 1884
+-0:36:45 - LMT 1912 Ja 1 0u
+0 - GMT 2018 Ja 1 1
+1 - WAT 2019 Ja 1 2
+0 - GMT
+Z Africa/Tripoli 0:52:44 - LMT 1920
+1 L CE%sT 1959
+2 - EET 1982
+1 L CE%sT 1990 May 4
+2 - EET 1996 S 30
+1 L CE%sT 1997 O 4
+2 - EET 2012 N 10 2
+1 L CE%sT 2013 O 25 2
+2 - EET
+Z Africa/Tunis 0:40:44 - LMT 1881 May 12
+0:9:21 - PMT 1911 Mar 11
+1 n CE%sT
+Z Africa/Windhoek 1:8:24 - LMT 1892 F 8
+1:30 - +0130 1903 Mar
+2 - SAST 1942 S 20 2
+2 1 SAST 1943 Mar 21 2
+2 - SAST 1990 Mar 21
+2 NA %s
+Z America/Adak 12:13:22 - LMT 1867 O 19 12:44:35
+-11:46:38 - LMT 1900 Au 20 12
+-11 - NST 1942
+-11 u N%sT 1946
+-11 - NST 1967 Ap
+-11 - BST 1969
+-11 u B%sT 1983 O 30 2
+-10 u AH%sT 1983 N 30
+-10 u H%sT
+Z America/Anchorage 14:0:24 - LMT 1867 O 19 14:31:37
+-9:59:36 - LMT 1900 Au 20 12
+-10 - AST 1942
+-10 u A%sT 1967 Ap
+-10 - AHST 1969
+-10 u AH%sT 1983 O 30 2
+-9 u Y%sT 1983 N 30
+-9 u AK%sT
+Z America/Araguaina -3:12:48 - LMT 1914
+-3 B -03/-02 1990 S 17
+-3 - -03 1995 S 14
+-3 B -03/-02 2003 S 24
+-3 - -03 2012 O 21
+-3 B -03/-02 2013 S
+-3 - -03
+Z America/Argentina/Buenos_Aires -3:53:48 - LMT 1894 O 31
+-4:16:48 - CMT 1920 May
+-4 - -04 1930 D
+-4 A -04/-03 1969 O 5
+-3 A -03/-02 1999 O 3
+-4 A -04/-03 2000 Mar 3
+-3 A -03/-02
+Z America/Argentina/Catamarca -4:23:8 - LMT 1894 O 31
+-4:16:48 - CMT 1920 May
+-4 - -04 1930 D
+-4 A -04/-03 1969 O 5
+-3 A -03/-02 1991 Mar 3
+-4 - -04 1991 O 20
+-3 A -03/-02 1999 O 3
+-4 A -04/-03 2000 Mar 3
+-3 - -03 2004 Jun
+-4 - -04 2004 Jun 20
+-3 A -03/-02 2008 O 18
+-3 - -03
+Z America/Argentina/Cordoba -4:16:48 - LMT 1894 O 31
+-4:16:48 - CMT 1920 May
+-4 - -04 1930 D
+-4 A -04/-03 1969 O 5
+-3 A -03/-02 1991 Mar 3
+-4 - -04 1991 O 20
+-3 A -03/-02 1999 O 3
+-4 A -04/-03 2000 Mar 3
+-3 A -03/-02
+Z America/Argentina/Jujuy -4:21:12 - LMT 1894 O 31
+-4:16:48 - CMT 1920 May
+-4 - -04 1930 D
+-4 A -04/-03 1969 O 5
+-3 A -03/-02 1990 Mar 4
+-4 - -04 1990 O 28
+-4 1 -03 1991 Mar 17
+-4 - -04 1991 O 6
+-3 1 -02 1992
+-3 A -03/-02 1999 O 3
+-4 A -04/-03 2000 Mar 3
+-3 A -03/-02 2008 O 18
+-3 - -03
+Z America/Argentina/La_Rioja -4:27:24 - LMT 1894 O 31
+-4:16:48 - CMT 1920 May
+-4 - -04 1930 D
+-4 A -04/-03 1969 O 5
+-3 A -03/-02 1991 Mar
+-4 - -04 1991 May 7
+-3 A -03/-02 1999 O 3
+-4 A -04/-03 2000 Mar 3
+-3 - -03 2004 Jun
+-4 - -04 2004 Jun 20
+-3 A -03/-02 2008 O 18
+-3 - -03
+Z America/Argentina/Mendoza -4:35:16 - LMT 1894 O 31
+-4:16:48 - CMT 1920 May
+-4 - -04 1930 D
+-4 A -04/-03 1969 O 5
+-3 A -03/-02 1990 Mar 4
+-4 - -04 1990 O 15
+-4 1 -03 1991 Mar
+-4 - -04 1991 O 15
+-4 1 -03 1992 Mar
+-4 - -04 1992 O 18
+-3 A -03/-02 1999 O 3
+-4 A -04/-03 2000 Mar 3
+-3 - -03 2004 May 23
+-4 - -04 2004 S 26
+-3 A -03/-02 2008 O 18
+-3 - -03
+Z America/Argentina/Rio_Gallegos -4:36:52 - LMT 1894 O 31
+-4:16:48 - CMT 1920 May
+-4 - -04 1930 D
+-4 A -04/-03 1969 O 5
+-3 A -03/-02 1999 O 3
+-4 A -04/-03 2000 Mar 3
+-3 - -03 2004 Jun
+-4 - -04 2004 Jun 20
+-3 A -03/-02 2008 O 18
+-3 - -03
+Z America/Argentina/Salta -4:21:40 - LMT 1894 O 31
+-4:16:48 - CMT 1920 May
+-4 - -04 1930 D
+-4 A -04/-03 1969 O 5
+-3 A -03/-02 1991 Mar 3
+-4 - -04 1991 O 20
+-3 A -03/-02 1999 O 3
+-4 A -04/-03 2000 Mar 3
+-3 A -03/-02 2008 O 18
+-3 - -03
+Z America/Argentina/San_Juan -4:34:4 - LMT 1894 O 31
+-4:16:48 - CMT 1920 May
+-4 - -04 1930 D
+-4 A -04/-03 1969 O 5
+-3 A -03/-02 1991 Mar
+-4 - -04 1991 May 7
+-3 A -03/-02 1999 O 3
+-4 A -04/-03 2000 Mar 3
+-3 - -03 2004 May 31
+-4 - -04 2004 Jul 25
+-3 A -03/-02 2008 O 18
+-3 - -03
+Z America/Argentina/San_Luis -4:25:24 - LMT 1894 O 31
+-4:16:48 - CMT 1920 May
+-4 - -04 1930 D
+-4 A -04/-03 1969 O 5
+-3 A -03/-02 1990
+-3 1 -02 1990 Mar 14
+-4 - -04 1990 O 15
+-4 1 -03 1991 Mar
+-4 - -04 1991 Jun
+-3 - -03 1999 O 3
+-4 1 -03 2000 Mar 3
+-3 - -03 2004 May 31
+-4 - -04 2004 Jul 25
+-3 A -03/-02 2008 Ja 21
+-4 Sa -04/-03 2009 O 11
+-3 - -03
+Z America/Argentina/Tucuman -4:20:52 - LMT 1894 O 31
+-4:16:48 - CMT 1920 May
+-4 - -04 1930 D
+-4 A -04/-03 1969 O 5
+-3 A -03/-02 1991 Mar 3
+-4 - -04 1991 O 20
+-3 A -03/-02 1999 O 3
+-4 A -04/-03 2000 Mar 3
+-3 - -03 2004 Jun
+-4 - -04 2004 Jun 13
+-3 A -03/-02
+Z America/Argentina/Ushuaia -4:33:12 - LMT 1894 O 31
+-4:16:48 - CMT 1920 May
+-4 - -04 1930 D
+-4 A -04/-03 1969 O 5
+-3 A -03/-02 1999 O 3
+-4 A -04/-03 2000 Mar 3
+-3 - -03 2004 May 30
+-4 - -04 2004 Jun 20
+-3 A -03/-02 2008 O 18
+-3 - -03
+Z America/Asuncion -3:50:40 - LMT 1890
+-3:50:40 - AMT 1931 O 10
+-4 - -04 1972 O
+-3 - -03 1974 Ap
+-4 y -04/-03
+Z America/Bahia -2:34:4 - LMT 1914
+-3 B -03/-02 2003 S 24
+-3 - -03 2011 O 16
+-3 B -03/-02 2012 O 21
+-3 - -03
+Z America/Bahia_Banderas -7:1 - LMT 1922 Ja 1 7u
+-7 - MST 1927 Jun 10 23
+-6 - CST 1930 N 15
+-7 m M%sT 1932 Ap
+-6 - CST 1942 Ap 24
+-7 - MST 1949 Ja 14
+-8 - PST 1970
+-7 m M%sT 2010 Ap 4 2
+-6 m C%sT
+Z America/Barbados -3:58:29 - LMT 1911 Au 28
+-4 BB A%sT 1944
+-4 BB AST/-0330 1945
+-4 BB A%sT
+Z America/Belem -3:13:56 - LMT 1914
+-3 B -03/-02 1988 S 12
+-3 - -03
+Z America/Belize -5:52:48 - LMT 1912 Ap
+-6 BZ %s
+Z America/Boa_Vista -4:2:40 - LMT 1914
+-4 B -04/-03 1988 S 12
+-4 - -04 1999 S 30
+-4 B -04/-03 2000 O 15
+-4 - -04
+Z America/Bogota -4:56:16 - LMT 1884 Mar 13
+-4:56:16 - BMT 1914 N 23
+-5 CO -05/-04
+Z America/Boise -7:44:49 - LMT 1883 N 18 20u
+-8 u P%sT 1923 May 13 2
+-7 u M%sT 1974
+-7 - MST 1974 F 3 2
+-7 u M%sT
+Z America/Cambridge_Bay 0 - -00 1920
+-7 Y M%sT 1999 O 31 2
+-6 C C%sT 2000 O 29 2
+-5 - EST 2000 N 5
+-6 - CST 2001 Ap 1 3
+-7 C M%sT
+Z America/Campo_Grande -3:38:28 - LMT 1914
+-4 B -04/-03
+Z America/Cancun -5:47:4 - LMT 1922 Ja 1 6u
+-6 - CST 1981 D 23
+-5 m E%sT 1998 Au 2 2
+-6 m C%sT 2015 F 1 2
+-5 - EST
+Z America/Caracas -4:27:44 - LMT 1890
+-4:27:40 - CMT 1912 F 12
+-4:30 - -0430 1965
+-4 - -04 2007 D 9 3
+-4:30 - -0430 2016 May 1 2:30
+-4 - -04
+Z America/Cayenne -3:29:20 - LMT 1911 Jul
+-4 - -04 1967 O
+-3 - -03
+Z America/Chicago -5:50:36 - LMT 1883 N 18 18u
+-6 u C%sT 1920
+-6 Ch C%sT 1936 Mar 1 2
+-5 - EST 1936 N 15 2
+-6 Ch C%sT 1942
+-6 u C%sT 1946
+-6 Ch C%sT 1967
+-6 u C%sT
+Z America/Chihuahua -7:4:20 - LMT 1922 Ja 1 7u
+-7 - MST 1927 Jun 10 23
+-6 - CST 1930 N 15
+-7 m M%sT 1932 Ap
+-6 - CST 1996
+-6 m C%sT 1998
+-6 - CST 1998 Ap Su>=1 3
+-7 m M%sT 2022 O 30 2
+-6 - CST
+Z America/Ciudad_Juarez -7:5:56 - LMT 1922 Ja 1 7u
+-7 - MST 1927 Jun 10 23
+-6 - CST 1930 N 15
+-7 m M%sT 1932 Ap
+-6 - CST 1996
+-6 m C%sT 1998
+-6 - CST 1998 Ap Su>=1 3
+-7 m M%sT 2010
+-7 u M%sT 2022 O 30 2
+-6 - CST 2022 N 30
+-7 u M%sT
+Z America/Costa_Rica -5:36:13 - LMT 1890
+-5:36:13 - SJMT 1921 Ja 15
+-6 CR C%sT
+Z America/Cuiaba -3:44:20 - LMT 1914
+-4 B -04/-03 2003 S 24
+-4 - -04 2004 O
+-4 B -04/-03
+Z America/Danmarkshavn -1:14:40 - LMT 1916 Jul 28
+-3 - -03 1980 Ap 6 2
+-3 E -03/-02 1996
+0 - GMT
+Z America/Dawson -9:17:40 - LMT 1900 Au 20
+-9 Y Y%sT 1965
+-9 Yu Y%sT 1973 O 28
+-8 - PST 1980
+-8 C P%sT 2020 N
+-7 - MST
+Z America/Dawson_Creek -8:0:56 - LMT 1884
+-8 C P%sT 1947
+-8 Va P%sT 1972 Au 30 2
+-7 - MST
+Z America/Denver -6:59:56 - LMT 1883 N 18 19u
+-7 u M%sT 1920
+-7 De M%sT 1942
+-7 u M%sT 1946
+-7 De M%sT 1967
+-7 u M%sT
+Z America/Detroit -5:32:11 - LMT 1905
+-6 - CST 1915 May 15 2
+-5 - EST 1942
+-5 u E%sT 1946
+-5 Dt E%sT 1967 Jun 14 0:1
+-5 u E%sT 1969
+-5 - EST 1973
+-5 u E%sT 1975
+-5 - EST 1975 Ap 27 2
+-5 u E%sT
+Z America/Edmonton -7:33:52 - LMT 1906 S
+-7 Ed M%sT 1987
+-7 C M%sT
+Z America/Eirunepe -4:39:28 - LMT 1914
+-5 B -05/-04 1988 S 12
+-5 - -05 1993 S 28
+-5 B -05/-04 1994 S 22
+-5 - -05 2008 Jun 24
+-4 - -04 2013 N 10
+-5 - -05
+Z America/El_Salvador -5:56:48 - LMT 1921
+-6 SV C%sT
+Z America/Fort_Nelson -8:10:47 - LMT 1884
+-8 Va P%sT 1946
+-8 - PST 1947
+-8 Va P%sT 1987
+-8 C P%sT 2015 Mar 8 2
+-7 - MST
+Z America/Fortaleza -2:34 - LMT 1914
+-3 B -03/-02 1990 S 17
+-3 - -03 1999 S 30
+-3 B -03/-02 2000 O 22
+-3 - -03 2001 S 13
+-3 B -03/-02 2002 O
+-3 - -03
+Z America/Glace_Bay -3:59:48 - LMT 1902 Jun 15
+-4 C A%sT 1953
+-4 H A%sT 1954
+-4 - AST 1972
+-4 H A%sT 1974
+-4 C A%sT
+Z America/Goose_Bay -4:1:40 - LMT 1884
+-3:30:52 - NST 1918
+-3:30:52 C N%sT 1919
+-3:30:52 - NST 1935 Mar 30
+-3:30 - NST 1936
+-3:30 j N%sT 1942 May 11
+-3:30 C N%sT 1946
+-3:30 j N%sT 1966 Mar 15 2
+-4 j A%sT 2011 N
+-4 C A%sT
+Z America/Grand_Turk -4:44:32 - LMT 1890
+-5:7:10 - KMT 1912 F
+-5 - EST 1979
+-5 u E%sT 2015 Mar 8 2
+-4 - AST 2018 Mar 11 3
+-5 u E%sT
+Z America/Guatemala -6:2:4 - LMT 1918 O 5
+-6 GT C%sT
+Z America/Guayaquil -5:19:20 - LMT 1890
+-5:14 - QMT 1931
+-5 EC -05/-04
+Z America/Guyana -3:52:39 - LMT 1911 Au
+-4 - -04 1915 Mar
+-3:45 - -0345 1975 Au
+-3 - -03 1992 Mar 29 1
+-4 - -04
+Z America/Halifax -4:14:24 - LMT 1902 Jun 15
+-4 H A%sT 1918
+-4 C A%sT 1919
+-4 H A%sT 1942 F 9 2s
+-4 C A%sT 1946
+-4 H A%sT 1974
+-4 C A%sT
+Z America/Havana -5:29:28 - LMT 1890
+-5:29:36 - HMT 1925 Jul 19 12
+-5 Q C%sT
+Z America/Hermosillo -7:23:52 - LMT 1922 Ja 1 7u
+-7 - MST 1927 Jun 10 23
+-6 - CST 1930 N 15
+-7 m M%sT 1932 Ap
+-6 - CST 1942 Ap 24
+-7 - MST 1949 Ja 14
+-8 - PST 1970
+-7 m M%sT 1999
+-7 - MST
+Z America/Indiana/Indianapolis -5:44:38 - LMT 1883 N 18 18u
+-6 u C%sT 1920
+-6 In C%sT 1942
+-6 u C%sT 1946
+-6 In C%sT 1955 Ap 24 2
+-5 - EST 1957 S 29 2
+-6 - CST 1958 Ap 27 2
+-5 - EST 1969
+-5 u E%sT 1971
+-5 - EST 2006
+-5 u E%sT
+Z America/Indiana/Knox -5:46:30 - LMT 1883 N 18 18u
+-6 u C%sT 1947
+-6 St C%sT 1962 Ap 29 2
+-5 - EST 1963 O 27 2
+-6 u C%sT 1991 O 27 2
+-5 - EST 2006 Ap 2 2
+-6 u C%sT
+Z America/Indiana/Marengo -5:45:23 - LMT 1883 N 18 18u
+-6 u C%sT 1951
+-6 Ma C%sT 1961 Ap 30 2
+-5 - EST 1969
+-5 u E%sT 1974 Ja 6 2
+-6 1 CDT 1974 O 27 2
+-5 u E%sT 1976
+-5 - EST 2006
+-5 u E%sT
+Z America/Indiana/Petersburg -5:49:7 - LMT 1883 N 18 18u
+-6 u C%sT 1955
+-6 Pi C%sT 1965 Ap 25 2
+-5 - EST 1966 O 30 2
+-6 u C%sT 1977 O 30 2
+-5 - EST 2006 Ap 2 2
+-6 u C%sT 2007 N 4 2
+-5 u E%sT
+Z America/Indiana/Tell_City -5:47:3 - LMT 1883 N 18 18u
+-6 u C%sT 1946
+-6 Pe C%sT 1964 Ap 26 2
+-5 - EST 1967 O 29 2
+-6 u C%sT 1969 Ap 27 2
+-5 u E%sT 1971
+-5 - EST 2006 Ap 2 2
+-6 u C%sT
+Z America/Indiana/Vevay -5:40:16 - LMT 1883 N 18 18u
+-6 u C%sT 1954 Ap 25 2
+-5 - EST 1969
+-5 u E%sT 1973
+-5 - EST 2006
+-5 u E%sT
+Z America/Indiana/Vincennes -5:50:7 - LMT 1883 N 18 18u
+-6 u C%sT 1946
+-6 V C%sT 1964 Ap 26 2
+-5 - EST 1969
+-5 u E%sT 1971
+-5 - EST 2006 Ap 2 2
+-6 u C%sT 2007 N 4 2
+-5 u E%sT
+Z America/Indiana/Winamac -5:46:25 - LMT 1883 N 18 18u
+-6 u C%sT 1946
+-6 Pu C%sT 1961 Ap 30 2
+-5 - EST 1969
+-5 u E%sT 1971
+-5 - EST 2006 Ap 2 2
+-6 u C%sT 2007 Mar 11 2
+-5 u E%sT
+Z America/Inuvik 0 - -00 1953
+-8 Y P%sT 1979 Ap lastSu 2
+-7 Y M%sT 1980
+-7 C M%sT
+Z America/Iqaluit 0 - -00 1942 Au
+-5 Y E%sT 1999 O 31 2
+-6 C C%sT 2000 O 29 2
+-5 C E%sT
+Z America/Jamaica -5:7:10 - LMT 1890
+-5:7:10 - KMT 1912 F
+-5 - EST 1974
+-5 u E%sT 1984
+-5 - EST
+Z America/Juneau 15:2:19 - LMT 1867 O 19 15:33:32
+-8:57:41 - LMT 1900 Au 20 12
+-8 - PST 1942
+-8 u P%sT 1946
+-8 - PST 1969
+-8 u P%sT 1980 Ap 27 2
+-9 u Y%sT 1980 O 26 2
+-8 u P%sT 1983 O 30 2
+-9 u Y%sT 1983 N 30
+-9 u AK%sT
+Z America/Kentucky/Louisville -5:43:2 - LMT 1883 N 18 18u
+-6 u C%sT 1921
+-6 v C%sT 1942
+-6 u C%sT 1946
+-6 v C%sT 1961 Jul 23 2
+-5 - EST 1968
+-5 u E%sT 1974 Ja 6 2
+-6 1 CDT 1974 O 27 2
+-5 u E%sT
+Z America/Kentucky/Monticello -5:39:24 - LMT 1883 N 18 18u
+-6 u C%sT 1946
+-6 - CST 1968
+-6 u C%sT 2000 O 29 2
+-5 u E%sT
+Z America/La_Paz -4:32:36 - LMT 1890
+-4:32:36 - CMT 1931 O 15
+-4:32:36 1 BST 1932 Mar 21
+-4 - -04
+Z America/Lima -5:8:12 - LMT 1890
+-5:8:36 - LMT 1908 Jul 28
+-5 PE -05/-04
+Z America/Los_Angeles -7:52:58 - LMT 1883 N 18 20u
+-8 u P%sT 1946
+-8 CA P%sT 1967
+-8 u P%sT
+Z America/Maceio -2:22:52 - LMT 1914
+-3 B -03/-02 1990 S 17
+-3 - -03 1995 O 13
+-3 B -03/-02 1996 S 4
+-3 - -03 1999 S 30
+-3 B -03/-02 2000 O 22
+-3 - -03 2001 S 13
+-3 B -03/-02 2002 O
+-3 - -03
+Z America/Managua -5:45:8 - LMT 1890
+-5:45:12 - MMT 1934 Jun 23
+-6 - CST 1973 May
+-5 - EST 1975 F 16
+-6 NI C%sT 1992 Ja 1 4
+-5 - EST 1992 S 24
+-6 - CST 1993
+-5 - EST 1997
+-6 NI C%sT
+Z America/Manaus -4:0:4 - LMT 1914
+-4 B -04/-03 1988 S 12
+-4 - -04 1993 S 28
+-4 B -04/-03 1994 S 22
+-4 - -04
+Z America/Martinique -4:4:20 - LMT 1890
+-4:4:20 - FFMT 1911 May
+-4 - AST 1980 Ap 6
+-4 1 ADT 1980 S 28
+-4 - AST
+Z America/Matamoros -6:30 - LMT 1922 Ja 1 6u
+-6 - CST 1988
+-6 u C%sT 1989
+-6 m C%sT 2010
+-6 u C%sT
+Z America/Mazatlan -7:5:40 - LMT 1922 Ja 1 7u
+-7 - MST 1927 Jun 10 23
+-6 - CST 1930 N 15
+-7 m M%sT 1932 Ap
+-6 - CST 1942 Ap 24
+-7 - MST 1949 Ja 14
+-8 - PST 1970
+-7 m M%sT
+Z America/Menominee -5:50:27 - LMT 1885 S 18 12
+-6 u C%sT 1946
+-6 Me C%sT 1969 Ap 27 2
+-5 - EST 1973 Ap 29 2
+-6 u C%sT
+Z America/Merida -5:58:28 - LMT 1922 Ja 1 6u
+-6 - CST 1981 D 23
+-5 - EST 1982 D 2
+-6 m C%sT
+Z America/Metlakatla 15:13:42 - LMT 1867 O 19 15:44:55
+-8:46:18 - LMT 1900 Au 20 12
+-8 - PST 1942
+-8 u P%sT 1946
+-8 - PST 1969
+-8 u P%sT 1983 O 30 2
+-8 - PST 2015 N 1 2
+-9 u AK%sT 2018 N 4 2
+-8 - PST 2019 Ja 20 2
+-9 u AK%sT
+Z America/Mexico_City -6:36:36 - LMT 1922 Ja 1 7u
+-7 - MST 1927 Jun 10 23
+-6 - CST 1930 N 15
+-7 m M%sT 1932 Ap
+-6 m C%sT 2001 S 30 2
+-6 - CST 2002 F 20
+-6 m C%sT
+Z America/Miquelon -3:44:40 - LMT 1911 Jun 15
+-4 - AST 1980 May
+-3 - -03 1987
+-3 C -03/-02
+Z America/Moncton -4:19:8 - LMT 1883 D 9
+-5 - EST 1902 Jun 15
+-4 C A%sT 1933
+-4 o A%sT 1942
+-4 C A%sT 1946
+-4 o A%sT 1973
+-4 C A%sT 1993
+-4 o A%sT 2007
+-4 C A%sT
+Z America/Monterrey -6:41:16 - LMT 1922 Ja 1 6u
+-6 - CST 1988
+-6 u C%sT 1989
+-6 m C%sT
 Z America/Montevideo -3:44:51 - LMT 1908 Jun 10
 -3:44:51 - MMT 1920 May
 -4 - -04 1923 O
@@ -4002,30 +2747,842 @@ Z America/Montevideo -3:44:51 - LMT 1908 Jun 10
 -3 U -03/-0130 1974 Mar 10
 -3 U -03/-0230 1974 D 22
 -3 U -03/-02
-Z America/Caracas -4:27:44 - LMT 1890
--4:27:40 - CMT 1912 F 12
--4:30 - -0430 1965
--4 - -04 2007 D 9 3
--4:30 - -0430 2016 May 1 2:30
+Z America/New_York -4:56:2 - LMT 1883 N 18 17u
+-5 u E%sT 1920
+-5 NY E%sT 1942
+-5 u E%sT 1946
+-5 NY E%sT 1967
+-5 u E%sT
+Z America/Nome 12:58:22 - LMT 1867 O 19 13:29:35
+-11:1:38 - LMT 1900 Au 20 12
+-11 - NST 1942
+-11 u N%sT 1946
+-11 - NST 1967 Ap
+-11 - BST 1969
+-11 u B%sT 1983 O 30 2
+-9 u Y%sT 1983 N 30
+-9 u AK%sT
+Z America/Noronha -2:9:40 - LMT 1914
+-2 B -02/-01 1990 S 17
+-2 - -02 1999 S 30
+-2 B -02/-01 2000 O 15
+-2 - -02 2001 S 13
+-2 B -02/-01 2002 O
+-2 - -02
+Z America/North_Dakota/Beulah -6:47:7 - LMT 1883 N 18 19u
+-7 u M%sT 2010 N 7 2
+-6 u C%sT
+Z America/North_Dakota/Center -6:45:12 - LMT 1883 N 18 19u
+-7 u M%sT 1992 O 25 2
+-6 u C%sT
+Z America/North_Dakota/New_Salem -6:45:39 - LMT 1883 N 18 19u
+-7 u M%sT 2003 O 26 2
+-6 u C%sT
+Z America/Nuuk -3:26:56 - LMT 1916 Jul 28
+-3 - -03 1980 Ap 6 2
+-3 E -03/-02 2023 Mar 26 1u
+-2 - -02 2023 O 29 1u
+-2 E -02/-01
+Z America/Ojinaga -6:57:40 - LMT 1922 Ja 1 7u
+-7 - MST 1927 Jun 10 23
+-6 - CST 1930 N 15
+-7 m M%sT 1932 Ap
+-6 - CST 1996
+-6 m C%sT 1998
+-6 - CST 1998 Ap Su>=1 3
+-7 m M%sT 2010
+-7 u M%sT 2022 O 30 2
+-6 - CST 2022 N 30
+-6 u C%sT
+Z America/Panama -5:18:8 - LMT 1890
+-5:19:36 - CMT 1908 Ap 22
+-5 - EST
+Z America/Paramaribo -3:40:40 - LMT 1911
+-3:40:52 - PMT 1935
+-3:40:36 - PMT 1945 O
+-3:30 - -0330 1984 O
+-3 - -03
+Z America/Phoenix -7:28:18 - LMT 1883 N 18 19u
+-7 u M%sT 1944 Ja 1 0:1
+-7 - MST 1944 Ap 1 0:1
+-7 u M%sT 1944 O 1 0:1
+-7 - MST 1967
+-7 u M%sT 1968 Mar 21
+-7 - MST
+Z America/Port-au-Prince -4:49:20 - LMT 1890
+-4:49 - PPMT 1917 Ja 24 12
+-5 HT E%sT
+Z America/Porto_Velho -4:15:36 - LMT 1914
+-4 B -04/-03 1988 S 12
 -4 - -04
-Z Etc/UTC 0 - UTC
+Z America/Puerto_Rico -4:24:25 - LMT 1899 Mar 28 12
+-4 - AST 1942 May 3
+-4 u A%sT 1946
+-4 - AST
+Z America/Punta_Arenas -4:43:40 - LMT 1890
+-4:42:45 - SMT 1910 Ja 10
+-5 - -05 1916 Jul
+-4:42:45 - SMT 1918 S 10
+-4 - -04 1919 Jul
+-4:42:45 - SMT 1927 S
+-5 x -05/-04 1932 S
+-4 - -04 1942 Jun
+-5 - -05 1942 Au
+-4 - -04 1946 Au 28 24
+-5 1 -04 1947 Mar 31 24
+-5 - -05 1947 May 21 23
+-4 x -04/-03 2016 D 4
+-3 - -03
+Z America/Rankin_Inlet 0 - -00 1957
+-6 Y C%sT 2000 O 29 2
+-5 - EST 2001 Ap 1 3
+-6 C C%sT
+Z America/Recife -2:19:36 - LMT 1914
+-3 B -03/-02 1990 S 17
+-3 - -03 1999 S 30
+-3 B -03/-02 2000 O 15
+-3 - -03 2001 S 13
+-3 B -03/-02 2002 O
+-3 - -03
+Z America/Regina -6:58:36 - LMT 1905 S
+-7 r M%sT 1960 Ap lastSu 2
+-6 - CST
+Z America/Resolute 0 - -00 1947 Au 31
+-6 Y C%sT 2000 O 29 2
+-5 - EST 2001 Ap 1 3
+-6 C C%sT 2006 O 29 2
+-5 - EST 2007 Mar 11 3
+-6 C C%sT
+Z America/Rio_Branco -4:31:12 - LMT 1914
+-5 B -05/-04 1988 S 12
+-5 - -05 2008 Jun 24
+-4 - -04 2013 N 10
+-5 - -05
+Z America/Santarem -3:38:48 - LMT 1914
+-4 B -04/-03 1988 S 12
+-4 - -04 2008 Jun 24
+-3 - -03
+Z America/Santiago -4:42:45 - LMT 1890
+-4:42:45 - SMT 1910 Ja 10
+-5 - -05 1916 Jul
+-4:42:45 - SMT 1918 S 10
+-4 - -04 1919 Jul
+-4:42:45 - SMT 1927 S
+-5 x -05/-04 1932 S
+-4 - -04 1942 Jun
+-5 - -05 1942 Au
+-4 - -04 1946 Jul 14 24
+-4 1 -03 1946 Au 28 24
+-5 1 -04 1947 Mar 31 24
+-5 - -05 1947 May 21 23
+-4 x -04/-03
+Z America/Santo_Domingo -4:39:36 - LMT 1890
+-4:40 - SDMT 1933 Ap 1 12
+-5 DO %s 1974 O 27
+-4 - AST 2000 O 29 2
+-5 u E%sT 2000 D 3 1
+-4 - AST
+Z America/Sao_Paulo -3:6:28 - LMT 1914
+-3 B -03/-02 1963 O 23
+-3 1 -02 1964
+-3 B -03/-02
+Z America/Scoresbysund -1:27:52 - LMT 1916 Jul 28
+-2 - -02 1980 Ap 6 2
+-2 c -02/-01 1981 Mar 29
+-1 E -01/+00 2024 Mar 31
+-2 E -02/-01
+Z America/Sitka 14:58:47 - LMT 1867 O 19 15:30
+-9:1:13 - LMT 1900 Au 20 12
+-8 - PST 1942
+-8 u P%sT 1946
+-8 - PST 1969
+-8 u P%sT 1983 O 30 2
+-9 u Y%sT 1983 N 30
+-9 u AK%sT
+Z America/St_Johns -3:30:52 - LMT 1884
+-3:30:52 j N%sT 1918
+-3:30:52 C N%sT 1919
+-3:30:52 j N%sT 1935 Mar 30
+-3:30 j N%sT 1942 May 11
+-3:30 C N%sT 1946
+-3:30 j N%sT 2011 N
+-3:30 C N%sT
+Z America/Swift_Current -7:11:20 - LMT 1905 S
+-7 C M%sT 1946 Ap lastSu 2
+-7 r M%sT 1950
+-7 Sw M%sT 1972 Ap lastSu 2
+-6 - CST
+Z America/Tegucigalpa -5:48:52 - LMT 1921 Ap
+-6 HN C%sT
+Z America/Thule -4:35:8 - LMT 1916 Jul 28
+-4 Th A%sT
+Z America/Tijuana -7:48:4 - LMT 1922 Ja 1 7u
+-7 - MST 1924
+-8 - PST 1927 Jun 10 23
+-7 - MST 1930 N 15
+-8 - PST 1931 Ap
+-8 1 PDT 1931 S 30
+-8 - PST 1942 Ap 24
+-8 1 PWT 1945 Au 14 23u
+-8 1 PPT 1945 N 12
+-8 - PST 1948 Ap 5
+-8 1 PDT 1949 Ja 14
+-8 - PST 1954
+-8 CA P%sT 1961
+-8 - PST 1976
+-8 u P%sT 1996
+-8 m P%sT 2001
+-8 u P%sT 2002 F 20
+-8 m P%sT 2010
+-8 u P%sT
+Z America/Toronto -5:17:32 - LMT 1895
+-5 C E%sT 1919
+-5 t E%sT 1942 F 9 2s
+-5 C E%sT 1946
+-5 t E%sT 1974
+-5 C E%sT
+Z America/Vancouver -8:12:28 - LMT 1884
+-8 Va P%sT 1987
+-8 C P%sT
+Z America/Whitehorse -9:0:12 - LMT 1900 Au 20
+-9 Y Y%sT 1965
+-9 Yu Y%sT 1966 F 27
+-8 - PST 1980
+-8 C P%sT 2020 N
+-7 - MST
+Z America/Winnipeg -6:28:36 - LMT 1887 Jul 16
+-6 W C%sT 2006
+-6 C C%sT
+Z America/Yakutat 14:41:5 - LMT 1867 O 19 15:12:18
+-9:18:55 - LMT 1900 Au 20 12
+-9 - YST 1942
+-9 u Y%sT 1946
+-9 - YST 1969
+-9 u Y%sT 1983 N 30
+-9 u AK%sT
+Z Antarctica/Casey 0 - -00 1969
+8 - +08 2009 O 18 2
+11 - +11 2010 Mar 5 2
+8 - +08 2011 O 28 2
+11 - +11 2012 F 21 17u
+8 - +08 2016 O 22
+11 - +11 2018 Mar 11 4
+8 - +08 2018 O 7 4
+11 - +11 2019 Mar 17 3
+8 - +08 2019 O 4 3
+11 - +11 2020 Mar 8 3
+8 - +08 2020 O 4 0:1
+11 - +11 2021 Mar 14
+8 - +08 2021 O 3 0:1
+11 - +11 2022 Mar 13
+8 - +08 2022 O 2 0:1
+11 - +11 2023 Mar 9 3
+8 - +08
+Z Antarctica/Davis 0 - -00 1957 Ja 13
+7 - +07 1964 N
+0 - -00 1969 F
+7 - +07 2009 O 18 2
+5 - +05 2010 Mar 10 20u
+7 - +07 2011 O 28 2
+5 - +05 2012 F 21 20u
+7 - +07
+Z Antarctica/Macquarie 0 - -00 1899 N
+10 - AEST 1916 O 1 2
+10 1 AEDT 1917 F
+10 AU AE%sT 1919 Ap 1 0s
+0 - -00 1948 Mar 25
+10 AU AE%sT 1967
+10 AT AE%sT 2010
+10 1 AEDT 2011
+10 AT AE%sT
+Z Antarctica/Mawson 0 - -00 1954 F 13
+6 - +06 2009 O 18 2
+5 - +05
+Z Antarctica/Palmer 0 - -00 1965
+-4 A -04/-03 1969 O 5
+-3 A -03/-02 1982 May
+-4 x -04/-03 2016 D 4
+-3 - -03
+Z Antarctica/Rothera 0 - -00 1976 D
+-3 - -03
+Z Antarctica/Troll 0 - -00 2005 F 12
+0 Tr %s
+Z Antarctica/Vostok 0 - -00 1957 D 16
+7 - +07 1994 F
+0 - -00 1994 N
+7 - +07 2023 D 18 2
+5 - +05
+Z Asia/Almaty 5:7:48 - LMT 1924 May 2
+5 - +05 1930 Jun 21
+6 R +06/+07 1991 Mar 31 2s
+5 R +05/+06 1992 Ja 19 2s
+6 R +06/+07 2004 O 31 2s
+6 - +06 2024 Mar
+5 - +05
+Z Asia/Amman 2:23:44 - LMT 1931
+2 J EE%sT 2022 O 28 0s
+3 - +03
+Z Asia/Anadyr 11:49:56 - LMT 1924 May 2
+12 - +12 1930 Jun 21
+13 R +13/+14 1982 Ap 1 0s
+12 R +12/+13 1991 Mar 31 2s
+11 R +11/+12 1992 Ja 19 2s
+12 R +12/+13 2010 Mar 28 2s
+11 R +11/+12 2011 Mar 27 2s
+12 - +12
+Z Asia/Aqtau 3:21:4 - LMT 1924 May 2
+4 - +04 1930 Jun 21
+5 - +05 1981 O
+6 - +06 1982 Ap
+5 R +05/+06 1991 Mar 31 2s
+4 R +04/+05 1992 Ja 19 2s
+5 R +05/+06 1994 S 25 2s
+4 R +04/+05 2004 O 31 2s
+5 - +05
+Z Asia/Aqtobe 3:48:40 - LMT 1924 May 2
+4 - +04 1930 Jun 21
+5 - +05 1981 Ap
+5 1 +06 1981 O
+6 - +06 1982 Ap
+5 R +05/+06 1991 Mar 31 2s
+4 R +04/+05 1992 Ja 19 2s
+5 R +05/+06 2004 O 31 2s
+5 - +05
+Z Asia/Ashgabat 3:53:32 - LMT 1924 May 2
+4 - +04 1930 Jun 21
+5 R +05/+06 1991 Mar 31 2
+4 R +04/+05 1992 Ja 19 2
+5 - +05
+Z Asia/Atyrau 3:27:44 - LMT 1924 May 2
+3 - +03 1930 Jun 21
+5 - +05 1981 O
+6 - +06 1982 Ap
+5 R +05/+06 1991 Mar 31 2s
+4 R +04/+05 1992 Ja 19 2s
+5 R +05/+06 1999 Mar 28 2s
+4 R +04/+05 2004 O 31 2s
+5 - +05
+Z Asia/Baghdad 2:57:40 - LMT 1890
+2:57:36 - BMT 1918
+3 - +03 1982 May
+3 IQ +03/+04
+Z Asia/Baku 3:19:24 - LMT 1924 May 2
+3 - +03 1957 Mar
+4 R +04/+05 1991 Mar 31 2s
+3 R +03/+04 1992 S lastSu 2s
+4 - +04 1996
+4 E +04/+05 1997
+4 AZ +04/+05
+Z Asia/Bangkok 6:42:4 - LMT 1880
+6:42:4 - BMT 1920 Ap
+7 - +07
+Z Asia/Barnaul 5:35 - LMT 1919 D 10
+6 - +06 1930 Jun 21
+7 R +07/+08 1991 Mar 31 2s
+6 R +06/+07 1992 Ja 19 2s
+7 R +07/+08 1995 May 28
+6 R +06/+07 2011 Mar 27 2s
+7 - +07 2014 O 26 2s
+6 - +06 2016 Mar 27 2s
+7 - +07
+Z Asia/Beirut 2:22 - LMT 1880
+2 l EE%sT
+Z Asia/Bishkek 4:58:24 - LMT 1924 May 2
+5 - +05 1930 Jun 21
+6 R +06/+07 1991 Mar 31 2s
+5 R +05/+06 1991 Au 31 2
+5 KG +05/+06 2005 Au 12
+6 - +06
+Z Asia/Chita 7:33:52 - LMT 1919 D 15
+8 - +08 1930 Jun 21
+9 R +09/+10 1991 Mar 31 2s
+8 R +08/+09 1992 Ja 19 2s
+9 R +09/+10 2011 Mar 27 2s
+10 - +10 2014 O 26 2s
+8 - +08 2016 Mar 27 2
+9 - +09
+Z Asia/Choibalsan 7:38 - LMT 1905 Au
+7 - +07 1978
+8 - +08 1983 Ap
+9 X +09/+10 2008 Mar 31
+8 X +08/+09
+Z Asia/Colombo 5:19:24 - LMT 1880
+5:19:32 - MMT 1906
+5:30 - +0530 1942 Ja 5
+5:30 0:30 +06 1942 S
+5:30 1 +0630 1945 O 16 2
+5:30 - +0530 1996 May 25
+6:30 - +0630 1996 O 26 0:30
+6 - +06 2006 Ap 15 0:30
+5:30 - +0530
+Z Asia/Damascus 2:25:12 - LMT 1920
+2 S EE%sT 2022 O 28
+3 - +03
+Z Asia/Dhaka 6:1:40 - LMT 1890
+5:53:20 - HMT 1941 O
+6:30 - +0630 1942 May 15
+5:30 - +0530 1942 S
+6:30 - +0630 1951 S 30
+6 - +06 2009
+6 BD +06/+07
+Z Asia/Dili 8:22:20 - LMT 1912
+8 - +08 1942 F 21 23
+9 - +09 1976 May 3
+8 - +08 2000 S 17
+9 - +09
+Z Asia/Dubai 3:41:12 - LMT 1920
+4 - +04
+Z Asia/Dushanbe 4:35:12 - LMT 1924 May 2
+5 - +05 1930 Jun 21
+6 R +06/+07 1991 Mar 31 2s
+5 1 +06 1991 S 9 2s
+5 - +05
+Z Asia/Famagusta 2:15:48 - LMT 1921 N 14
+2 CY EE%sT 1998 S
+2 E EE%sT 2016 S 8
+3 - +03 2017 O 29 1u
+2 E EE%sT
+Z Asia/Gaza 2:17:52 - LMT 1900 O
+2 Z EET/EEST 1948 May 15
+2 K EE%sT 1967 Jun 5
+2 Z I%sT 1996
+2 J EE%sT 1999
+2 P EE%sT 2008 Au 29
+2 - EET 2008 S
+2 P EE%sT 2010
+2 - EET 2010 Mar 27 0:1
+2 P EE%sT 2011 Au
+2 - EET 2012
+2 P EE%sT
+Z Asia/Hebron 2:20:23 - LMT 1900 O
+2 Z EET/EEST 1948 May 15
+2 K EE%sT 1967 Jun 5
+2 Z I%sT 1996
+2 J EE%sT 1999
+2 P EE%sT
+Z Asia/Ho_Chi_Minh 7:6:30 - LMT 1906 Jul
+7:6:30 - PLMT 1911 May
+7 - +07 1942 D 31 23
+8 - +08 1945 Mar 14 23
+9 - +09 1945 S 1 24
+7 - +07 1947 Ap
+8 - +08 1955 Jul 1 1
+7 - +07 1959 D 31 23
+8 - +08 1975 Jun 13
+7 - +07
+Z Asia/Hong_Kong 7:36:42 - LMT 1904 O 29 17u
+8 - HKT 1941 Jun 15 3
+8 1 HKST 1941 O 1 4
+8 0:30 HKWT 1941 D 25
+9 - JST 1945 N 18 2
+8 HK HK%sT
+Z Asia/Hovd 6:6:36 - LMT 1905 Au
+6 - +06 1978
+7 X +07/+08
+Z Asia/Irkutsk 6:57:5 - LMT 1880
+6:57:5 - IMT 1920 Ja 25
+7 - +07 1930 Jun 21
+8 R +08/+09 1991 Mar 31 2s
+7 R +07/+08 1992 Ja 19 2s
+8 R +08/+09 2011 Mar 27 2s
+9 - +09 2014 O 26 2s
+8 - +08
+Z Asia/Jakarta 7:7:12 - LMT 1867 Au 10
+7:7:12 - BMT 1923 D 31 16:40u
+7:20 - +0720 1932 N
+7:30 - +0730 1942 Mar 23
+9 - +09 1945 S 23
+7:30 - +0730 1948 May
+8 - +08 1950 May
+7:30 - +0730 1964
+7 - WIB
+Z Asia/Jayapura 9:22:48 - LMT 1932 N
+9 - +09 1944 S
+9:30 - +0930 1964
+9 - WIT
+Z Asia/Jerusalem 2:20:54 - LMT 1880
+2:20:40 - JMT 1918
+2 Z I%sT
+Z Asia/Kabul 4:36:48 - LMT 1890
+4 - +04 1945
+4:30 - +0430
+Z Asia/Kamchatka 10:34:36 - LMT 1922 N 10
+11 - +11 1930 Jun 21
+12 R +12/+13 1991 Mar 31 2s
+11 R +11/+12 1992 Ja 19 2s
+12 R +12/+13 2010 Mar 28 2s
+11 R +11/+12 2011 Mar 27 2s
+12 - +12
+Z Asia/Karachi 4:28:12 - LMT 1907
+5:30 - +0530 1942 S
+5:30 1 +0630 1945 O 15
+5:30 - +0530 1951 S 30
+5 - +05 1971 Mar 26
+5 PK PK%sT
+Z Asia/Kathmandu 5:41:16 - LMT 1920
+5:30 - +0530 1986
+5:45 - +0545
+Z Asia/Khandyga 9:2:13 - LMT 1919 D 15
+8 - +08 1930 Jun 21
+9 R +09/+10 1991 Mar 31 2s
+8 R +08/+09 1992 Ja 19 2s
+9 R +09/+10 2004
+10 R +10/+11 2011 Mar 27 2s
+11 - +11 2011 S 13 0s
+10 - +10 2014 O 26 2s
+9 - +09
+Z Asia/Kolkata 5:53:28 - LMT 1854 Jun 28
+5:53:20 - HMT 1870
+5:21:10 - MMT 1906
+5:30 - IST 1941 O
+5:30 1 +0630 1942 May 15
+5:30 - IST 1942 S
+5:30 1 +0630 1945 O 15
+5:30 - IST
+Z Asia/Krasnoyarsk 6:11:26 - LMT 1920 Ja 6
+6 - +06 1930 Jun 21
+7 R +07/+08 1991 Mar 31 2s
+6 R +06/+07 1992 Ja 19 2s
+7 R +07/+08 2011 Mar 27 2s
+8 - +08 2014 O 26 2s
+7 - +07
+Z Asia/Kuching 7:21:20 - LMT 1926 Mar
+7:30 - +0730 1933
+8 NB +08/+0820 1942 F 16
+9 - +09 1945 S 12
+8 - +08
+Z Asia/Macau 7:34:10 - LMT 1904 O 30
+8 - CST 1941 D 21 23
+9 _ +09/+10 1945 S 30 24
+8 _ C%sT
+Z Asia/Magadan 10:3:12 - LMT 1924 May 2
+10 - +10 1930 Jun 21
+11 R +11/+12 1991 Mar 31 2s
+10 R +10/+11 1992 Ja 19 2s
+11 R +11/+12 2011 Mar 27 2s
+12 - +12 2014 O 26 2s
+10 - +10 2016 Ap 24 2s
+11 - +11
+Z Asia/Makassar 7:57:36 - LMT 1920
+7:57:36 - MMT 1932 N
+8 - +08 1942 F 9
+9 - +09 1945 S 23
+8 - WITA
+Z Asia/Manila -15:56 - LMT 1844 D 31
+8:4 - LMT 1899 May 11
+8 PH P%sT 1942 May
+9 - JST 1944 N
+8 PH P%sT
+Z Asia/Nicosia 2:13:28 - LMT 1921 N 14
+2 CY EE%sT 1998 S
+2 E EE%sT
+Z Asia/Novokuznetsk 5:48:48 - LMT 1924 May
+6 - +06 1930 Jun 21
+7 R +07/+08 1991 Mar 31 2s
+6 R +06/+07 1992 Ja 19 2s
+7 R +07/+08 2010 Mar 28 2s
+6 R +06/+07 2011 Mar 27 2s
+7 - +07
+Z Asia/Novosibirsk 5:31:40 - LMT 1919 D 14 6
+6 - +06 1930 Jun 21
+7 R +07/+08 1991 Mar 31 2s
+6 R +06/+07 1992 Ja 19 2s
+7 R +07/+08 1993 May 23
+6 R +06/+07 2011 Mar 27 2s
+7 - +07 2014 O 26 2s
+6 - +06 2016 Jul 24 2s
+7 - +07
+Z Asia/Omsk 4:53:30 - LMT 1919 N 14
+5 - +05 1930 Jun 21
+6 R +06/+07 1991 Mar 31 2s
+5 R +05/+06 1992 Ja 19 2s
+6 R +06/+07 2011 Mar 27 2s
+7 - +07 2014 O 26 2s
+6 - +06
+Z Asia/Oral 3:25:24 - LMT 1924 May 2
+3 - +03 1930 Jun 21
+5 - +05 1981 Ap
+5 1 +06 1981 O
+6 - +06 1982 Ap
+5 R +05/+06 1989 Mar 26 2s
+4 R +04/+05 1992 Ja 19 2s
+5 R +05/+06 1992 Mar 29 2s
+4 R +04/+05 2004 O 31 2s
+5 - +05
+Z Asia/Pontianak 7:17:20 - LMT 1908 May
+7:17:20 - PMT 1932 N
+7:30 - +0730 1942 Ja 29
+9 - +09 1945 S 23
+7:30 - +0730 1948 May
+8 - +08 1950 May
+7:30 - +0730 1964
+8 - WITA 1988
+7 - WIB
+Z Asia/Pyongyang 8:23 - LMT 1908 Ap
+8:30 - KST 1912
+9 - JST 1945 Au 24
+9 - KST 2015 Au 15
+8:30 - KST 2018 May 4 23:30
+9 - KST
+Z Asia/Qatar 3:26:8 - LMT 1920
+4 - +04 1972 Jun
+3 - +03
+Z Asia/Qostanay 4:14:28 - LMT 1924 May 2
+4 - +04 1930 Jun 21
+5 - +05 1981 Ap
+5 1 +06 1981 O
+6 - +06 1982 Ap
+5 R +05/+06 1991 Mar 31 2s
+4 R +04/+05 1992 Ja 19 2s
+5 R +05/+06 2004 O 31 2s
+6 - +06 2024 Mar
+5 - +05
+Z Asia/Qyzylorda 4:21:52 - LMT 1924 May 2
+4 - +04 1930 Jun 21
+5 - +05 1981 Ap
+5 1 +06 1981 O
+6 - +06 1982 Ap
+5 R +05/+06 1991 Mar 31 2s
+4 R +04/+05 1991 S 29 2s
+5 R +05/+06 1992 Ja 19 2s
+6 R +06/+07 1992 Mar 29 2s
+5 R +05/+06 2004 O 31 2s
+6 - +06 2018 D 21
+5 - +05
+Z Asia/Riyadh 3:6:52 - LMT 1947 Mar 14
+3 - +03
+Z Asia/Sakhalin 9:30:48 - LMT 1905 Au 23
+9 - +09 1945 Au 25
+11 R +11/+12 1991 Mar 31 2s
+10 R +10/+11 1992 Ja 19 2s
+11 R +11/+12 1997 Mar lastSu 2s
+10 R +10/+11 2011 Mar 27 2s
+11 - +11 2014 O 26 2s
+10 - +10 2016 Mar 27 2s
+11 - +11
+Z Asia/Samarkand 4:27:53 - LMT 1924 May 2
+4 - +04 1930 Jun 21
+5 - +05 1981 Ap
+5 1 +06 1981 O
+6 - +06 1982 Ap
+5 R +05/+06 1992
+5 - +05
+Z Asia/Seoul 8:27:52 - LMT 1908 Ap
+8:30 - KST 1912
+9 - JST 1945 S 8
+9 KR K%sT 1954 Mar 21
+8:30 KR K%sT 1961 Au 10
+9 KR K%sT
+Z Asia/Shanghai 8:5:43 - LMT 1901
+8 Sh C%sT 1949 May 28
+8 CN C%sT
+Z Asia/Singapore 6:55:25 - LMT 1901
+6:55:25 - SMT 1905 Jun
+7 - +07 1933
+7 0:20 +0720 1936
+7:20 - +0720 1941 S
+7:30 - +0730 1942 F 16
+9 - +09 1945 S 12
+7:30 - +0730 1981 D 31 16u
+8 - +08
+Z Asia/Srednekolymsk 10:14:52 - LMT 1924 May 2
+10 - +10 1930 Jun 21
+11 R +11/+12 1991 Mar 31 2s
+10 R +10/+11 1992 Ja 19 2s
+11 R +11/+12 2011 Mar 27 2s
+12 - +12 2014 O 26 2s
+11 - +11
+Z Asia/Taipei 8:6 - LMT 1896
+8 - CST 1937 O
+9 - JST 1945 S 21 1
+8 f C%sT
+Z Asia/Tashkent 4:37:11 - LMT 1924 May 2
+5 - +05 1930 Jun 21
+6 R +06/+07 1991 Mar 31 2
+5 R +05/+06 1992
+5 - +05
+Z Asia/Tbilisi 2:59:11 - LMT 1880
+2:59:11 - TBMT 1924 May 2
+3 - +03 1957 Mar
+4 R +04/+05 1991 Mar 31 2s
+3 R +03/+04 1992
+3 e +03/+04 1994 S lastSu
+4 e +04/+05 1996 O lastSu
+4 1 +05 1997 Mar lastSu
+4 e +04/+05 2004 Jun 27
+3 R +03/+04 2005 Mar lastSu 2
+4 - +04
+Z Asia/Tehran 3:25:44 - LMT 1916
+3:25:44 - TMT 1935 Jun 13
+3:30 i +0330/+0430 1977 O 20 24
+4 i +04/+05 1979
+3:30 i +0330/+0430
+Z Asia/Thimphu 5:58:36 - LMT 1947 Au 15
+5:30 - +0530 1987 O
+6 - +06
+Z Asia/Tokyo 9:18:59 - LMT 1887 D 31 15u
+9 JP J%sT
+Z Asia/Tomsk 5:39:51 - LMT 1919 D 22
+6 - +06 1930 Jun 21
+7 R +07/+08 1991 Mar 31 2s
+6 R +06/+07 1992 Ja 19 2s
+7 R +07/+08 2002 May 1 3
+6 R +06/+07 2011 Mar 27 2s
+7 - +07 2014 O 26 2s
+6 - +06 2016 May 29 2s
+7 - +07
+Z Asia/Ulaanbaatar 7:7:32 - LMT 1905 Au
+7 - +07 1978
+8 X +08/+09
+Z Asia/Urumqi 5:50:20 - LMT 1928
+6 - +06
+Z Asia/Ust-Nera 9:32:54 - LMT 1919 D 15
+8 - +08 1930 Jun 21
+9 R +09/+10 1981 Ap
+11 R +11/+12 1991 Mar 31 2s
+10 R +10/+11 1992 Ja 19 2s
+11 R +11/+12 2011 Mar 27 2s
+12 - +12 2011 S 13 0s
+11 - +11 2014 O 26 2s
+10 - +10
+Z Asia/Vladivostok 8:47:31 - LMT 1922 N 15
+9 - +09 1930 Jun 21
+10 R +10/+11 1991 Mar 31 2s
+9 R +09/+10 1992 Ja 19 2s
+10 R +10/+11 2011 Mar 27 2s
+11 - +11 2014 O 26 2s
+10 - +10
+Z Asia/Yakutsk 8:38:58 - LMT 1919 D 15
+8 - +08 1930 Jun 21
+9 R +09/+10 1991 Mar 31 2s
+8 R +08/+09 1992 Ja 19 2s
+9 R +09/+10 2011 Mar 27 2s
+10 - +10 2014 O 26 2s
+9 - +09
+Z Asia/Yangon 6:24:47 - LMT 1880
+6:24:47 - RMT 1920
+6:30 - +0630 1942 May
+9 - +09 1945 May 3
+6:30 - +0630
+Z Asia/Yekaterinburg 4:2:33 - LMT 1916 Jul 3
+3:45:5 - PMT 1919 Jul 15 4
+4 - +04 1930 Jun 21
+5 R +05/+06 1991 Mar 31 2s
+4 R +04/+05 1992 Ja 19 2s
+5 R +05/+06 2011 Mar 27 2s
+6 - +06 2014 O 26 2s
+5 - +05
+Z Asia/Yerevan 2:58 - LMT 1924 May 2
+3 - +03 1957 Mar
+4 R +04/+05 1991 Mar 31 2s
+3 R +03/+04 1995 S 24 2s
+4 - +04 1997
+4 R +04/+05 2011
+4 AM +04/+05
+Z Atlantic/Azores -1:42:40 - LMT 1884
+-1:54:32 - HMT 1912 Ja 1 2u
+-2 p -02/-01 1942 Ap 25 22s
+-2 p +00 1942 Au 15 22s
+-2 p -02/-01 1943 Ap 17 22s
+-2 p +00 1943 Au 28 22s
+-2 p -02/-01 1944 Ap 22 22s
+-2 p +00 1944 Au 26 22s
+-2 p -02/-01 1945 Ap 21 22s
+-2 p +00 1945 Au 25 22s
+-2 p -02/-01 1966 Ap 3 2
+-1 p -01/+00 1983 S 25 1s
+-1 W- -01/+00 1992 S 27 1s
+0 E WE%sT 1993 Mar 28 1u
+-1 E -01/+00
+Z Atlantic/Bermuda -4:19:18 - LMT 1890
+-4:19:18 Be BMT/BST 1930 Ja 1 2
+-4 Be A%sT 1974 Ap 28 2
+-4 C A%sT 1976
+-4 u A%sT
+Z Atlantic/Canary -1:1:36 - LMT 1922 Mar
+-1 - -01 1946 S 30 1
+0 - WET 1980 Ap 6 0s
+0 1 WEST 1980 S 28 1u
+0 E WE%sT
+Z Atlantic/Cape_Verde -1:34:4 - LMT 1912 Ja 1 2u
+-2 - -02 1942 S
+-2 1 -01 1945 O 15
+-2 - -02 1975 N 25 2
+-1 - -01
+Z Atlantic/Faroe -0:27:4 - LMT 1908 Ja 11
+0 - WET 1981
+0 E WE%sT
+Z Atlantic/Madeira -1:7:36 - LMT 1884
+-1:7:36 - FMT 1912 Ja 1 1u
+-1 p -01/+00 1942 Ap 25 22s
+-1 p +01 1942 Au 15 22s
+-1 p -01/+00 1943 Ap 17 22s
+-1 p +01 1943 Au 28 22s
+-1 p -01/+00 1944 Ap 22 22s
+-1 p +01 1944 Au 26 22s
+-1 p -01/+00 1945 Ap 21 22s
+-1 p +01 1945 Au 25 22s
+-1 p -01/+00 1966 Ap 3 2
+0 p WE%sT 1983 S 25 1s
+0 E WE%sT
+Z Atlantic/South_Georgia -2:26:8 - LMT 1890
+-2 - -02
+Z Atlantic/Stanley -3:51:24 - LMT 1890
+-3:51:24 - SMT 1912 Mar 12
+-4 FK -04/-03 1983 May
+-3 FK -03/-02 1985 S 15
+-4 FK -04/-03 2010 S 5 2
+-3 - -03
+Z Australia/Adelaide 9:14:20 - LMT 1895 F
+9 - ACST 1899 May
+9:30 AU AC%sT 1971
+9:30 AS AC%sT
+Z Australia/Brisbane 10:12:8 - LMT 1895
+10 AU AE%sT 1971
+10 AQ AE%sT
+Z Australia/Broken_Hill 9:25:48 - LMT 1895 F
+10 - AEST 1896 Au 23
+9 - ACST 1899 May
+9:30 AU AC%sT 1971
+9:30 AN AC%sT 2000
+9:30 AS AC%sT
+Z Australia/Darwin 8:43:20 - LMT 1895 F
+9 - ACST 1899 May
+9:30 AU AC%sT
+Z Australia/Eucla 8:35:28 - LMT 1895 D
+8:45 AU +0845/+0945 1943 Jul
+8:45 AW +0845/+0945
+Z Australia/Hobart 9:49:16 - LMT 1895 S
+10 AT AE%sT 1919 O 24
+10 AU AE%sT 1967
+10 AT AE%sT
+Z Australia/Lindeman 9:55:56 - LMT 1895
+10 AU AE%sT 1971
+10 AQ AE%sT 1992 Jul
+10 Ho AE%sT
+Z Australia/Lord_Howe 10:36:20 - LMT 1895 F
+10 - AEST 1981 Mar
+10:30 LH +1030/+1130 1985 Jul
+10:30 LH +1030/+11
+Z Australia/Melbourne 9:39:52 - LMT 1895 F
+10 AU AE%sT 1971
+10 AV AE%sT
+Z Australia/Perth 7:43:24 - LMT 1895 D
+8 AU AW%sT 1943 Jul
+8 AW AW%sT
+Z Australia/Sydney 10:4:52 - LMT 1895 F
+10 AU AE%sT 1971
+10 AN AE%sT
+Z CET 1 c CE%sT
+Z CST6CDT -6 u C%sT
+Z EET 2 E EE%sT
+Z EST -5 - EST
+Z EST5EDT -5 u E%sT
 Z Etc/GMT 0 - GMT
-L Etc/GMT GMT
-Z Etc/GMT-14 14 - +14
-Z Etc/GMT-13 13 - +13
-Z Etc/GMT-12 12 - +12
-Z Etc/GMT-11 11 - +11
-Z Etc/GMT-10 10 - +10
-Z Etc/GMT-9 9 - +09
-Z Etc/GMT-8 8 - +08
-Z Etc/GMT-7 7 - +07
-Z Etc/GMT-6 6 - +06
-Z Etc/GMT-5 5 - +05
-Z Etc/GMT-4 4 - +04
-Z Etc/GMT-3 3 - +03
-Z Etc/GMT-2 2 - +02
-Z Etc/GMT-1 1 - +01
 Z Etc/GMT+1 -1 - -01
+Z Etc/GMT+10 -10 - -10
+Z Etc/GMT+11 -11 - -11
+Z Etc/GMT+12 -12 - -12
 Z Etc/GMT+2 -2 - -02
 Z Etc/GMT+3 -3 - -03
 Z Etc/GMT+4 -4 - -04
@@ -4034,10 +3591,463 @@ Z Etc/GMT+6 -6 - -06
 Z Etc/GMT+7 -7 - -07
 Z Etc/GMT+8 -8 - -08
 Z Etc/GMT+9 -9 - -09
-Z Etc/GMT+10 -10 - -10
-Z Etc/GMT+11 -11 - -11
-Z Etc/GMT+12 -12 - -12
+Z Etc/GMT-1 1 - +01
+Z Etc/GMT-10 10 - +10
+Z Etc/GMT-11 11 - +11
+Z Etc/GMT-12 12 - +12
+Z Etc/GMT-13 13 - +13
+Z Etc/GMT-14 14 - +14
+Z Etc/GMT-2 2 - +02
+Z Etc/GMT-3 3 - +03
+Z Etc/GMT-4 4 - +04
+Z Etc/GMT-5 5 - +05
+Z Etc/GMT-6 6 - +06
+Z Etc/GMT-7 7 - +07
+Z Etc/GMT-8 8 - +08
+Z Etc/GMT-9 9 - +09
+Z Etc/UTC 0 - UTC
+Z Europe/Andorra 0:6:4 - LMT 1901
+0 - WET 1946 S 30
+1 - CET 1985 Mar 31 2
+1 E CE%sT
+Z Europe/Astrakhan 3:12:12 - LMT 1924 May
+3 - +03 1930 Jun 21
+4 R +04/+05 1989 Mar 26 2s
+3 R +03/+04 1991 Mar 31 2s
+4 - +04 1992 Mar 29 2s
+3 R +03/+04 2011 Mar 27 2s
+4 - +04 2014 O 26 2s
+3 - +03 2016 Mar 27 2s
+4 - +04
+Z Europe/Athens 1:34:52 - LMT 1895 S 14
+1:34:52 - AMT 1916 Jul 28 0:1
+2 g EE%sT 1941 Ap 30
+1 g CE%sT 1944 Ap 4
+2 g EE%sT 1981
+2 E EE%sT
+Z Europe/Belgrade 1:22 - LMT 1884
+1 - CET 1941 Ap 18 23
+1 c CE%sT 1945
+1 - CET 1945 May 8 2s
+1 1 CEST 1945 S 16 2s
+1 - CET 1982 N 27
+1 E CE%sT
+Z Europe/Berlin 0:53:28 - LMT 1893 Ap
+1 c CE%sT 1945 May 24 2
+1 So CE%sT 1946
+1 DE CE%sT 1980
+1 E CE%sT
+Z Europe/Brussels 0:17:30 - LMT 1880
+0:17:30 - BMT 1892 May 1 0:17:30
+0 - WET 1914 N 8
+1 - CET 1916 May
+1 c CE%sT 1918 N 11 11u
+0 b WE%sT 1940 May 20 2s
+1 c CE%sT 1944 S 3
+1 b CE%sT 1977
+1 E CE%sT
+Z Europe/Bucharest 1:44:24 - LMT 1891 O
+1:44:24 - BMT 1931 Jul 24
+2 z EE%sT 1981 Mar 29 2s
+2 c EE%sT 1991
+2 z EE%sT 1994
+2 e EE%sT 1997
+2 E EE%sT
+Z Europe/Budapest 1:16:20 - LMT 1890 N
+1 c CE%sT 1918
+1 h CE%sT 1941 Ap 7 23
+1 c CE%sT 1945
+1 h CE%sT 1984
+1 E CE%sT
+Z Europe/Chisinau 1:55:20 - LMT 1880
+1:55 - CMT 1918 F 15
+1:44:24 - BMT 1931 Jul 24
+2 z EE%sT 1940 Au 15
+2 1 EEST 1941 Jul 17
+1 c CE%sT 1944 Au 24
+3 R MSK/MSD 1990 May 6 2
+2 R EE%sT 1992
+2 e EE%sT 1997
+2 MD EE%sT
+Z Europe/Dublin -0:25:21 - LMT 1880 Au 2
+-0:25:21 - DMT 1916 May 21 2s
+-0:25:21 1 IST 1916 O 1 2s
+0 G %s 1921 D 6
+0 G GMT/IST 1940 F 25 2s
+0 1 IST 1946 O 6 2s
+0 - GMT 1947 Mar 16 2s
+0 1 IST 1947 N 2 2s
+0 - GMT 1948 Ap 18 2s
+0 G GMT/IST 1968 O 27
+1 IE IST/GMT
+Z Europe/Gibraltar -0:21:24 - LMT 1880 Au 2
+0 G %s 1957 Ap 14 2
+1 - CET 1982
+1 E CE%sT
+Z Europe/Helsinki 1:39:49 - LMT 1878 May 31
+1:39:49 - HMT 1921 May
+2 FI EE%sT 1983
+2 E EE%sT
+Z Europe/Istanbul 1:55:52 - LMT 1880
+1:56:56 - IMT 1910 O
+2 T EE%sT 1978 Jun 29
+3 T +03/+04 1984 N 1 2
+2 T EE%sT 2007
+2 E EE%sT 2011 Mar 27 1u
+2 - EET 2011 Mar 28 1u
+2 E EE%sT 2014 Mar 30 1u
+2 - EET 2014 Mar 31 1u
+2 E EE%sT 2015 O 25 1u
+2 1 EEST 2015 N 8 1u
+2 E EE%sT 2016 S 7
+3 - +03
+Z Europe/Kaliningrad 1:22 - LMT 1893 Ap
+1 c CE%sT 1945 Ap 10
+2 O EE%sT 1946 Ap 7
+3 R MSK/MSD 1989 Mar 26 2s
+2 R EE%sT 2011 Mar 27 2s
+3 - +03 2014 O 26 2s
+2 - EET
+Z Europe/Kirov 3:18:48 - LMT 1919 Jul 1 0u
+3 - +03 1930 Jun 21
+4 R +04/+05 1989 Mar 26 2s
+3 R MSK/MSD 1991 Mar 31 2s
+4 - +04 1992 Mar 29 2s
+3 R MSK/MSD 2011 Mar 27 2s
+4 - MSK 2014 O 26 2s
+3 - MSK
+Z Europe/Kyiv 2:2:4 - LMT 1880
+2:2:4 - KMT 1924 May 2
+2 - EET 1930 Jun 21
+3 - MSK 1941 S 20
+1 c CE%sT 1943 N 6
+3 R MSK/MSD 1990 Jul 1 2
+2 1 EEST 1991 S 29 3
+2 c EE%sT 1996 May 13
+2 E EE%sT
+Z Europe/Lisbon -0:36:45 - LMT 1884
+-0:36:45 - LMT 1912 Ja 1 0u
+0 p WE%sT 1966 Ap 3 2
+1 - CET 1976 S 26 1
+0 p WE%sT 1983 S 25 1s
+0 W- WE%sT 1992 S 27 1s
+1 E CE%sT 1996 Mar 31 1u
+0 E WE%sT
+Z Europe/London -0:1:15 - LMT 1847 D
+0 G %s 1968 O 27
+1 - BST 1971 O 31 2u
+0 G %s 1996
+0 E GMT/BST
+Z Europe/Madrid -0:14:44 - LMT 1901 Ja 1 0u
+0 s WE%sT 1940 Mar 16 23
+1 s CE%sT 1979
+1 E CE%sT
+Z Europe/Malta 0:58:4 - LMT 1893 N 2
+1 I CE%sT 1973 Mar 31
+1 MT CE%sT 1981
+1 E CE%sT
+Z Europe/Minsk 1:50:16 - LMT 1880
+1:50 - MMT 1924 May 2
+2 - EET 1930 Jun 21
+3 - MSK 1941 Jun 28
+1 c CE%sT 1944 Jul 3
+3 R MSK/MSD 1990
+3 - MSK 1991 Mar 31 2s
+2 R EE%sT 2011 Mar 27 2s
+3 - +03
+Z Europe/Moscow 2:30:17 - LMT 1880
+2:30:17 - MMT 1916 Jul 3
+2:31:19 R %s 1919 Jul 1 0u
+3 R %s 1921 O
+3 R MSK/MSD 1922 O
+2 - EET 1930 Jun 21
+3 R MSK/MSD 1991 Mar 31 2s
+2 R EE%sT 1992 Ja 19 2s
+3 R MSK/MSD 2011 Mar 27 2s
+4 - MSK 2014 O 26 2s
+3 - MSK
+Z Europe/Paris 0:9:21 - LMT 1891 Mar 16
+0:9:21 - PMT 1911 Mar 11
+0 F WE%sT 1940 Jun 14 23
+1 c CE%sT 1944 Au 25
+0 F WE%sT 1945 S 16 3
+1 F CE%sT 1977
+1 E CE%sT
+Z Europe/Prague 0:57:44 - LMT 1850
+0:57:44 - PMT 1891 O
+1 c CE%sT 1945 May 9
+1 CZ CE%sT 1946 D 1 3
+1 -1 GMT 1947 F 23 2
+1 CZ CE%sT 1979
+1 E CE%sT
+Z Europe/Riga 1:36:34 - LMT 1880
+1:36:34 - RMT 1918 Ap 15 2
+1:36:34 1 LST 1918 S 16 3
+1:36:34 - RMT 1919 Ap 1 2
+1:36:34 1 LST 1919 May 22 3
+1:36:34 - RMT 1926 May 11
+2 - EET 1940 Au 5
+3 - MSK 1941 Jul
+1 c CE%sT 1944 O 13
+3 R MSK/MSD 1989 Mar lastSu 2s
+2 1 EEST 1989 S lastSu 2s
+2 LV EE%sT 1997 Ja 21
+2 E EE%sT 2000 F 29
+2 - EET 2001 Ja 2
+2 E EE%sT
+Z Europe/Rome 0:49:56 - LMT 1866 D 12
+0:49:56 - RMT 1893 O 31 23u
+1 I CE%sT 1943 S 10
+1 c CE%sT 1944 Jun 4
+1 I CE%sT 1980
+1 E CE%sT
+Z Europe/Samara 3:20:20 - LMT 1919 Jul 1 0u
+3 - +03 1930 Jun 21
+4 - +04 1935 Ja 27
+4 R +04/+05 1989 Mar 26 2s
+3 R +03/+04 1991 Mar 31 2s
+2 R +02/+03 1991 S 29 2s
+3 - +03 1991 O 20 3
+4 R +04/+05 2010 Mar 28 2s
+3 R +03/+04 2011 Mar 27 2s
+4 - +04
+Z Europe/Saratov 3:4:18 - LMT 1919 Jul 1 0u
+3 - +03 1930 Jun 21
+4 R +04/+05 1988 Mar 27 2s
+3 R +03/+04 1991 Mar 31 2s
+4 - +04 1992 Mar 29 2s
+3 R +03/+04 2011 Mar 27 2s
+4 - +04 2014 O 26 2s
+3 - +03 2016 D 4 2s
+4 - +04
+Z Europe/Simferopol 2:16:24 - LMT 1880
+2:16 - SMT 1924 May 2
+2 - EET 1930 Jun 21
+3 - MSK 1941 N
+1 c CE%sT 1944 Ap 13
+3 R MSK/MSD 1990
+3 - MSK 1990 Jul 1 2
+2 - EET 1992 Mar 20
+2 c EE%sT 1994 May
+3 c MSK/MSD 1996 Mar 31 0s
+3 1 MSD 1996 O 27 3s
+3 - MSK 1997 Mar lastSu 1u
+2 E EE%sT 2014 Mar 30 2
+4 - MSK 2014 O 26 2s
+3 - MSK
+Z Europe/Sofia 1:33:16 - LMT 1880
+1:56:56 - IMT 1894 N 30
+2 - EET 1942 N 2 3
+1 c CE%sT 1945
+1 - CET 1945 Ap 2 3
+2 - EET 1979 Mar 31 23
+2 BG EE%sT 1982 S 26 3
+2 c EE%sT 1991
+2 e EE%sT 1997
+2 E EE%sT
+Z Europe/Tallinn 1:39 - LMT 1880
+1:39 - TMT 1918 F
+1 c CE%sT 1919 Jul
+1:39 - TMT 1921 May
+2 - EET 1940 Au 6
+3 - MSK 1941 S 15
+1 c CE%sT 1944 S 22
+3 R MSK/MSD 1989 Mar 26 2s
+2 1 EEST 1989 S 24 2s
+2 c EE%sT 1998 S 22
+2 E EE%sT 1999 O 31 4
+2 - EET 2002 F 21
+2 E EE%sT
+Z Europe/Tirane 1:19:20 - LMT 1914
+1 - CET 1940 Jun 16
+1 q CE%sT 1984 Jul
+1 E CE%sT
+Z Europe/Ulyanovsk 3:13:36 - LMT 1919 Jul 1 0u
+3 - +03 1930 Jun 21
+4 R +04/+05 1989 Mar 26 2s
+3 R +03/+04 1991 Mar 31 2s
+2 R +02/+03 1992 Ja 19 2s
+3 R +03/+04 2011 Mar 27 2s
+4 - +04 2014 O 26 2s
+3 - +03 2016 Mar 27 2s
+4 - +04
+Z Europe/Vienna 1:5:21 - LMT 1893 Ap
+1 c CE%sT 1920
+1 a CE%sT 1940 Ap 1 2s
+1 c CE%sT 1945 Ap 2 2s
+1 1 CEST 1945 Ap 12 2s
+1 - CET 1946
+1 a CE%sT 1981
+1 E CE%sT
+Z Europe/Vilnius 1:41:16 - LMT 1880
+1:24 - WMT 1917
+1:35:36 - KMT 1919 O 10
+1 - CET 1920 Jul 12
+2 - EET 1920 O 9
+1 - CET 1940 Au 3
+3 - MSK 1941 Jun 24
+1 c CE%sT 1944 Au
+3 R MSK/MSD 1989 Mar 26 2s
+2 R EE%sT 1991 S 29 2s
+2 c EE%sT 1998
+2 - EET 1998 Mar 29 1u
+1 E CE%sT 1999 O 31 1u
+2 - EET 2003
+2 E EE%sT
+Z Europe/Volgograd 2:57:40 - LMT 1920 Ja 3
+3 - +03 1930 Jun 21
+4 - +04 1961 N 11
+4 R +04/+05 1988 Mar 27 2s
+3 R MSK/MSD 1991 Mar 31 2s
+4 - +04 1992 Mar 29 2s
+3 R MSK/MSD 2011 Mar 27 2s
+4 - MSK 2014 O 26 2s
+3 - MSK 2018 O 28 2s
+4 - +04 2020 D 27 2s
+3 - MSK
+Z Europe/Warsaw 1:24 - LMT 1880
+1:24 - WMT 1915 Au 5
+1 c CE%sT 1918 S 16 3
+2 O EE%sT 1922 Jun
+1 O CE%sT 1940 Jun 23 2
+1 c CE%sT 1944 O
+1 O CE%sT 1977
+1 W- CE%sT 1988
+1 E CE%sT
+Z Europe/Zurich 0:34:8 - LMT 1853 Jul 16
+0:29:46 - BMT 1894 Jun
+1 CH CE%sT 1981
+1 E CE%sT
 Z Factory 0 - -00
+Z HST -10 - HST
+Z Indian/Chagos 4:49:40 - LMT 1907
+5 - +05 1996
+6 - +06
+Z Indian/Maldives 4:54 - LMT 1880
+4:54 - MMT 1960
+5 - +05
+Z Indian/Mauritius 3:50 - LMT 1907
+4 MU +04/+05
+Z MET 1 c ME%sT
+Z MST -7 - MST
+Z MST7MDT -7 u M%sT
+Z PST8PDT -8 u P%sT
+Z Pacific/Apia 12:33:4 - LMT 1892 Jul 5
+-11:26:56 - LMT 1911
+-11:30 - -1130 1950
+-11 WS -11/-10 2011 D 29 24
+13 WS +13/+14
+Z Pacific/Auckland 11:39:4 - LMT 1868 N 2
+11:30 NZ NZ%sT 1946
+12 NZ NZ%sT
+Z Pacific/Bougainville 10:22:16 - LMT 1880
+9:48:32 - PMMT 1895
+10 - +10 1942 Jul
+9 - +09 1945 Au 21
+10 - +10 2014 D 28 2
+11 - +11
+Z Pacific/Chatham 12:13:48 - LMT 1868 N 2
+12:15 - +1215 1946
+12:45 k +1245/+1345
+Z Pacific/Easter -7:17:28 - LMT 1890
+-7:17:28 - EMT 1932 S
+-7 x -07/-06 1982 Mar 14 3u
+-6 x -06/-05
+Z Pacific/Efate 11:13:16 - LMT 1912 Ja 13
+11 VU +11/+12
+Z Pacific/Fakaofo -11:24:56 - LMT 1901
+-11 - -11 2011 D 30
+13 - +13
+Z Pacific/Fiji 11:55:44 - LMT 1915 O 26
+12 FJ +12/+13
+Z Pacific/Galapagos -5:58:24 - LMT 1931
+-5 - -05 1986
+-6 EC -06/-05
+Z Pacific/Gambier -8:59:48 - LMT 1912 O
+-9 - -09
+Z Pacific/Guadalcanal 10:39:48 - LMT 1912 O
+11 - +11
+Z Pacific/Guam -14:21 - LMT 1844 D 31
+9:39 - LMT 1901
+10 - GST 1941 D 10
+9 - +09 1944 Jul 31
+10 Gu G%sT 2000 D 23
+10 - ChST
+Z Pacific/Honolulu -10:31:26 - LMT 1896 Ja 13 12
+-10:30 - HST 1933 Ap 30 2
+-10:30 1 HDT 1933 May 21 12
+-10:30 u H%sT 1947 Jun 8 2
+-10 - HST
+Z Pacific/Kanton 0 - -00 1937 Au 31
+-12 - -12 1979 O
+-11 - -11 1994 D 31
+13 - +13
+Z Pacific/Kiritimati -10:29:20 - LMT 1901
+-10:40 - -1040 1979 O
+-10 - -10 1994 D 31
+14 - +14
+Z Pacific/Kosrae -13:8:4 - LMT 1844 D 31
+10:51:56 - LMT 1901
+11 - +11 1914 O
+9 - +09 1919 F
+11 - +11 1937
+10 - +10 1941 Ap
+9 - +09 1945 Au
+11 - +11 1969 O
+12 - +12 1999
+11 - +11
+Z Pacific/Kwajalein 11:9:20 - LMT 1901
+11 - +11 1937
+10 - +10 1941 Ap
+9 - +09 1944 F 6
+11 - +11 1969 O
+-12 - -12 1993 Au 20 24
+12 - +12
+Z Pacific/Marquesas -9:18 - LMT 1912 O
+-9:30 - -0930
+Z Pacific/Nauru 11:7:40 - LMT 1921 Ja 15
+11:30 - +1130 1942 Au 29
+9 - +09 1945 S 8
+11:30 - +1130 1979 F 10 2
+12 - +12
+Z Pacific/Niue -11:19:40 - LMT 1952 O 16
+-11:20 - -1120 1964 Jul
+-11 - -11
+Z Pacific/Norfolk 11:11:52 - LMT 1901
+11:12 - +1112 1951
+11:30 - +1130 1974 O 27 2s
+11:30 1 +1230 1975 Mar 2 2s
+11:30 - +1130 2015 O 4 2s
+11 - +11 2019 Jul
+11 AN +11/+12
+Z Pacific/Noumea 11:5:48 - LMT 1912 Ja 13
+11 NC +11/+12
+Z Pacific/Pago_Pago 12:37:12 - LMT 1892 Jul 5
+-11:22:48 - LMT 1911
+-11 - SST
+Z Pacific/Palau -15:2:4 - LMT 1844 D 31
+8:57:56 - LMT 1901
+9 - +09
+Z Pacific/Pitcairn -8:40:20 - LMT 1901
+-8:30 - -0830 1998 Ap 27
+-8 - -08
+Z Pacific/Port_Moresby 9:48:40 - LMT 1880
+9:48:32 - PMMT 1895
+10 - +10
+Z Pacific/Rarotonga 13:20:56 - LMT 1899 D 26
+-10:39:4 - LMT 1952 O 16
+-10:30 - -1030 1978 N 12
+-10 CK -10/-0930
+Z Pacific/Tahiti -9:58:16 - LMT 1912 O
+-10 - -10
+Z Pacific/Tarawa 11:32:4 - LMT 1901
+12 - +12
+Z Pacific/Tongatapu 12:19:12 - LMT 1945 S 10
+12:20 - +1220 1961
+13 - +13 1999
+13 TO +13/+14
+Z WET 0 E WE%sT
+L Etc/GMT GMT
 L Australia/Sydney Australia/ACT
 L Australia/Lord_Howe Australia/LHI
 L Australia/Sydney Australia/NSW
@@ -4185,7 +4195,6 @@ L America/Puerto_Rico America/Tortola
 L Pacific/Port_Moresby Antarctica/DumontDUrville
 L Pacific/Auckland Antarctica/McMurdo
 L Asia/Riyadh Antarctica/Syowa
-L Asia/Urumqi Antarctica/Vostok
 L Europe/Berlin Arctic/Longyearbyen
 L Asia/Riyadh Asia/Aden
 L Asia/Qatar Asia/Bahrain
diff --git a/lib/tzdata/zoneinfo/zone.tab b/lib/tzdata/zoneinfo/zone.tab
index dbcb6179..3fa9306a 100644
--- a/lib/tzdata/zoneinfo/zone.tab
+++ b/lib/tzdata/zoneinfo/zone.tab
@@ -48,7 +48,7 @@ AR	-3124-06411	America/Argentina/Cordoba	Argentina (most areas: CB, CC, CN, ER,
 AR	-2447-06525	America/Argentina/Salta	Salta (SA, LP, NQ, RN)
 AR	-2411-06518	America/Argentina/Jujuy	Jujuy (JY)
 AR	-2649-06513	America/Argentina/Tucuman	Tucuman (TM)
-AR	-2828-06547	America/Argentina/Catamarca	Catamarca (CT); Chubut (CH)
+AR	-2828-06547	America/Argentina/Catamarca	Catamarca (CT), Chubut (CH)
 AR	-2926-06651	America/Argentina/La_Rioja	La Rioja (LR)
 AR	-3132-06831	America/Argentina/San_Juan	San Juan (SJ)
 AR	-3253-06849	America/Argentina/Mendoza	Mendoza (MZ)
@@ -87,7 +87,7 @@ BN	+0456+11455	Asia/Brunei
 BO	-1630-06809	America/La_Paz
 BQ	+120903-0681636	America/Kralendijk
 BR	-0351-03225	America/Noronha	Atlantic islands
-BR	-0127-04829	America/Belem	Para (east); Amapa
+BR	-0127-04829	America/Belem	Para (east), Amapa
 BR	-0343-03830	America/Fortaleza	Brazil (northeast: MA, PI, CE, RN, PB)
 BR	-0803-03454	America/Recife	Pernambuco
 BR	-0712-04812	America/Araguaina	Tocantins
@@ -107,21 +107,21 @@ BT	+2728+08939	Asia/Thimphu
 BW	-2439+02555	Africa/Gaborone
 BY	+5354+02734	Europe/Minsk
 BZ	+1730-08812	America/Belize
-CA	+4734-05243	America/St_Johns	Newfoundland; Labrador (southeast)
-CA	+4439-06336	America/Halifax	Atlantic - NS (most areas); PE
+CA	+4734-05243	America/St_Johns	Newfoundland, Labrador (SE)
+CA	+4439-06336	America/Halifax	Atlantic - NS (most areas), PE
 CA	+4612-05957	America/Glace_Bay	Atlantic - NS (Cape Breton)
 CA	+4606-06447	America/Moncton	Atlantic - New Brunswick
 CA	+5320-06025	America/Goose_Bay	Atlantic - Labrador (most areas)
 CA	+5125-05707	America/Blanc-Sablon	AST - QC (Lower North Shore)
-CA	+4339-07923	America/Toronto	Eastern - ON, QC (most areas)
+CA	+4339-07923	America/Toronto	Eastern - ON & QC (most areas)
 CA	+6344-06828	America/Iqaluit	Eastern - NU (most areas)
-CA	+484531-0913718	America/Atikokan	EST - ON (Atikokan); NU (Coral H)
-CA	+4953-09709	America/Winnipeg	Central - ON (west); Manitoba
+CA	+484531-0913718	America/Atikokan	EST - ON (Atikokan), NU (Coral H)
+CA	+4953-09709	America/Winnipeg	Central - ON (west), Manitoba
 CA	+744144-0944945	America/Resolute	Central - NU (Resolute)
 CA	+624900-0920459	America/Rankin_Inlet	Central - NU (central)
 CA	+5024-10439	America/Regina	CST - SK (most areas)
 CA	+5017-10750	America/Swift_Current	CST - SK (midwest)
-CA	+5333-11328	America/Edmonton	Mountain - AB; BC (E); NT (E); SK (W)
+CA	+5333-11328	America/Edmonton	Mountain - AB, BC(E), NT(E), SK(W)
 CA	+690650-1050310	America/Cambridge_Bay	Mountain - NU (west)
 CA	+682059-1334300	America/Inuvik	Mountain - NT (west)
 CA	+4906-11631	America/Creston	MST - BC (Creston)
@@ -207,8 +207,8 @@ HT	+1832-07220	America/Port-au-Prince
 HU	+4730+01905	Europe/Budapest
 ID	-0610+10648	Asia/Jakarta	Java, Sumatra
 ID	-0002+10920	Asia/Pontianak	Borneo (west, central)
-ID	-0507+11924	Asia/Makassar	Borneo (east, south); Sulawesi/Celebes, Bali, Nusa Tengarra; Timor (west)
-ID	-0232+14042	Asia/Jayapura	New Guinea (West Papua / Irian Jaya); Malukus/Moluccas
+ID	-0507+11924	Asia/Makassar	Borneo (east, south), Sulawesi/Celebes, Bali, Nusa Tengarra, Timor (west)
+ID	-0232+14042	Asia/Jayapura	New Guinea (West Papua / Irian Jaya), Malukus/Moluccas
 IE	+5320-00615	Europe/Dublin
 IL	+314650+0351326	Asia/Jerusalem
 IM	+5409-00428	Europe/Isle_of_Man
@@ -355,7 +355,7 @@ RU	+4310+13156	Asia/Vladivostok	MSK+07 - Amur River
 RU	+643337+1431336	Asia/Ust-Nera	MSK+07 - Oymyakonsky
 RU	+5934+15048	Asia/Magadan	MSK+08 - Magadan
 RU	+4658+14242	Asia/Sakhalin	MSK+08 - Sakhalin Island
-RU	+6728+15343	Asia/Srednekolymsk	MSK+08 - Sakha (E); N Kuril Is
+RU	+6728+15343	Asia/Srednekolymsk	MSK+08 - Sakha (E), N Kuril Is
 RU	+5301+15839	Asia/Kamchatka	MSK+09 - Kamchatka
 RU	+6445+17729	Asia/Anadyr	MSK+09 - Bering Sea
 RW	-0157+03004	Africa/Kigali
@@ -418,7 +418,7 @@ US	+470659-1011757	America/North_Dakota/Center	Central - ND (Oliver)
 US	+465042-1012439	America/North_Dakota/New_Salem	Central - ND (Morton rural)
 US	+471551-1014640	America/North_Dakota/Beulah	Central - ND (Mercer)
 US	+394421-1045903	America/Denver	Mountain (most areas)
-US	+433649-1161209	America/Boise	Mountain - ID (south); OR (east)
+US	+433649-1161209	America/Boise	Mountain - ID (south), OR (east)
 US	+332654-1120424	America/Phoenix	MST - AZ (except Navajo)
 US	+340308-1181434	America/Los_Angeles	Pacific
 US	+611305-1495401	America/Anchorage	Alaska (most areas)
diff --git a/lib/tzdata/zoneinfo/zone1970.tab b/lib/tzdata/zoneinfo/zone1970.tab
index 1f1cecb8..abd94897 100644
--- a/lib/tzdata/zoneinfo/zone1970.tab
+++ b/lib/tzdata/zoneinfo/zone1970.tab
@@ -37,7 +37,7 @@
 #country-
 #codes	coordinates	TZ	comments
 AD	+4230+00131	Europe/Andorra
-AE,OM,RE,SC,TF	+2518+05518	Asia/Dubai	Crozet, Scattered Is
+AE,OM,RE,SC,TF	+2518+05518	Asia/Dubai	Crozet
 AF	+3431+06912	Asia/Kabul
 AL	+4120+01950	Europe/Tirane
 AM	+4011+04430	Asia/Yerevan
@@ -47,12 +47,13 @@ AQ	-6736+06253	Antarctica/Mawson	Mawson
 AQ	-6448-06406	Antarctica/Palmer	Palmer
 AQ	-6734-06808	Antarctica/Rothera	Rothera
 AQ	-720041+0023206	Antarctica/Troll	Troll
+AQ	-7824+10654	Antarctica/Vostok	Vostok
 AR	-3436-05827	America/Argentina/Buenos_Aires	Buenos Aires (BA, CF)
 AR	-3124-06411	America/Argentina/Cordoba	most areas: CB, CC, CN, ER, FM, MN, SE, SF
 AR	-2447-06525	America/Argentina/Salta	Salta (SA, LP, NQ, RN)
 AR	-2411-06518	America/Argentina/Jujuy	Jujuy (JY)
 AR	-2649-06513	America/Argentina/Tucuman	Tucumán (TM)
-AR	-2828-06547	America/Argentina/Catamarca	Catamarca (CT); Chubut (CH)
+AR	-2828-06547	America/Argentina/Catamarca	Catamarca (CT), Chubut (CH)
 AR	-2926-06651	America/Argentina/La_Rioja	La Rioja (LR)
 AR	-3132-06831	America/Argentina/San_Juan	San Juan (SJ)
 AR	-3253-06849	America/Argentina/Mendoza	Mendoza (MZ)
@@ -81,7 +82,7 @@ BG	+4241+02319	Europe/Sofia
 BM	+3217-06446	Atlantic/Bermuda
 BO	-1630-06809	America/La_Paz
 BR	-0351-03225	America/Noronha	Atlantic islands
-BR	-0127-04829	America/Belem	Pará (east); Amapá
+BR	-0127-04829	America/Belem	Pará (east), Amapá
 BR	-0343-03830	America/Fortaleza	Brazil (northeast: MA, PI, CE, RN, PB)
 BR	-0803-03454	America/Recife	Pernambuco
 BR	-0712-04812	America/Araguaina	Tocantins
@@ -99,19 +100,19 @@ BR	-0958-06748	America/Rio_Branco	Acre
 BT	+2728+08939	Asia/Thimphu
 BY	+5354+02734	Europe/Minsk
 BZ	+1730-08812	America/Belize
-CA	+4734-05243	America/St_Johns	Newfoundland; Labrador (southeast)
-CA	+4439-06336	America/Halifax	Atlantic - NS (most areas); PE
+CA	+4734-05243	America/St_Johns	Newfoundland, Labrador (SE)
+CA	+4439-06336	America/Halifax	Atlantic - NS (most areas), PE
 CA	+4612-05957	America/Glace_Bay	Atlantic - NS (Cape Breton)
 CA	+4606-06447	America/Moncton	Atlantic - New Brunswick
 CA	+5320-06025	America/Goose_Bay	Atlantic - Labrador (most areas)
-CA,BS	+4339-07923	America/Toronto	Eastern - ON, QC (most areas)
+CA,BS	+4339-07923	America/Toronto	Eastern - ON & QC (most areas)
 CA	+6344-06828	America/Iqaluit	Eastern - NU (most areas)
-CA	+4953-09709	America/Winnipeg	Central - ON (west); Manitoba
+CA	+4953-09709	America/Winnipeg	Central - ON (west), Manitoba
 CA	+744144-0944945	America/Resolute	Central - NU (Resolute)
 CA	+624900-0920459	America/Rankin_Inlet	Central - NU (central)
 CA	+5024-10439	America/Regina	CST - SK (most areas)
 CA	+5017-10750	America/Swift_Current	CST - SK (midwest)
-CA	+5333-11328	America/Edmonton	Mountain - AB; BC (E); NT (E); SK (W)
+CA	+5333-11328	America/Edmonton	Mountain - AB, BC(E), NT(E), SK(W)
 CA	+690650-1050310	America/Cambridge_Bay	Mountain - NU (west)
 CA	+682059-1334300	America/Inuvik	Mountain - NT (west)
 CA	+5546-12014	America/Dawson_Creek	MST - BC (Dawson Cr, Ft St John)
@@ -126,7 +127,7 @@ CL	-3327-07040	America/Santiago	most of Chile
 CL	-5309-07055	America/Punta_Arenas	Region of Magallanes
 CL	-2709-10926	Pacific/Easter	Easter Island
 CN	+3114+12128	Asia/Shanghai	Beijing Time
-CN,AQ	+4348+08735	Asia/Urumqi	Xinjiang Time, Vostok
+CN	+4348+08735	Asia/Urumqi	Xinjiang Time
 CO	+0436-07405	America/Bogota
 CR	+0956-08405	America/Costa_Rica
 CU	+2308-08222	America/Havana
@@ -171,8 +172,8 @@ HT	+1832-07220	America/Port-au-Prince
 HU	+4730+01905	Europe/Budapest
 ID	-0610+10648	Asia/Jakarta	Java, Sumatra
 ID	-0002+10920	Asia/Pontianak	Borneo (west, central)
-ID	-0507+11924	Asia/Makassar	Borneo (east, south); Sulawesi/Celebes, Bali, Nusa Tengarra; Timor (west)
-ID	-0232+14042	Asia/Jayapura	New Guinea (West Papua / Irian Jaya); Malukus/Moluccas
+ID	-0507+11924	Asia/Makassar	Borneo (east, south), Sulawesi/Celebes, Bali, Nusa Tengarra, Timor (west)
+ID	-0232+14042	Asia/Jayapura	New Guinea (West Papua / Irian Jaya), Malukus/Moluccas
 IE	+5320-00615	Europe/Dublin
 IL	+314650+0351326	Asia/Jerusalem
 IN	+2232+08822	Asia/Kolkata
@@ -251,7 +252,7 @@ PK	+2452+06703	Asia/Karachi
 PL	+5215+02100	Europe/Warsaw
 PM	+4703-05620	America/Miquelon
 PN	-2504-13005	Pacific/Pitcairn
-PR,AG,CA,AI,AW,BL,BQ,CW,DM,GD,GP,KN,LC,MF,MS,SX,TT,VC,VG,VI	+182806-0660622	America/Puerto_Rico	AST
+PR,AG,CA,AI,AW,BL,BQ,CW,DM,GD,GP,KN,LC,MF,MS,SX,TT,VC,VG,VI	+182806-0660622	America/Puerto_Rico	AST - QC (Lower North Shore)
 PS	+3130+03428	Asia/Gaza	Gaza Strip
 PS	+313200+0350542	Asia/Hebron	West Bank
 PT	+3843-00908	Europe/Lisbon	Portugal (mainland)
@@ -287,7 +288,7 @@ RU	+4310+13156	Asia/Vladivostok	MSK+07 - Amur River
 RU	+643337+1431336	Asia/Ust-Nera	MSK+07 - Oymyakonsky
 RU	+5934+15048	Asia/Magadan	MSK+08 - Magadan
 RU	+4658+14242	Asia/Sakhalin	MSK+08 - Sakhalin Island
-RU	+6728+15343	Asia/Srednekolymsk	MSK+08 - Sakha (E); N Kuril Is
+RU	+6728+15343	Asia/Srednekolymsk	MSK+08 - Sakha (E), N Kuril Is
 RU	+5301+15839	Asia/Kamchatka	MSK+09 - Kamchatka
 RU	+6445+17729	Asia/Anadyr	MSK+09 - Bering Sea
 SA,AQ,KW,YE	+2438+04643	Asia/Riyadh	Syowa
@@ -329,7 +330,7 @@ US	+470659-1011757	America/North_Dakota/Center	Central - ND (Oliver)
 US	+465042-1012439	America/North_Dakota/New_Salem	Central - ND (Morton rural)
 US	+471551-1014640	America/North_Dakota/Beulah	Central - ND (Mercer)
 US	+394421-1045903	America/Denver	Mountain (most areas)
-US	+433649-1161209	America/Boise	Mountain - ID (south); OR (east)
+US	+433649-1161209	America/Boise	Mountain - ID (south), OR (east)
 US,CA	+332654-1120424	America/Phoenix	MST - AZ (most areas), Creston BC
 US	+340308-1181434	America/Los_Angeles	Pacific
 US	+611305-1495401	America/Anchorage	Alaska (most areas)
diff --git a/lib/tzdata/zoneinfo/zonenow.tab b/lib/tzdata/zoneinfo/zonenow.tab
new file mode 100644
index 00000000..b6f29109
--- /dev/null
+++ b/lib/tzdata/zoneinfo/zonenow.tab
@@ -0,0 +1,303 @@
+# tzdb timezone descriptions, for users who do not care about old timestamps
+#
+# This file is in the public domain.
+#
+# From Paul Eggert (2023-12-18):
+# This file contains a table where each row stands for a timezone
+# where civil timestamps are predicted to agree from now on.
+# This file is like zone1970.tab (see zone1970.tab's coments),
+# but with the following changes:
+#
+# 1.  Each timezone corresponds to a set of clocks that are planned
+#     to agree from now on.  This is a larger set of clocks than in
+#     zone1970.tab, where each timezone's clocks must agree from 1970 on.
+# 2.  The first column is irrelevant and ignored.
+# 3.  The table is sorted in a different way:
+#     first by standard time UTC offset;
+#     then, if DST is used, by daylight saving UTC offset;
+#     then by time zone abbreviation.
+# 4.  Every timezone has a nonempty comments column, with wording
+#     distinguishing the timezone only from other timezones with the
+#     same UTC offset at some point during the year.
+#
+# The format of this table is experimental, and may change in future versions.
+#
+# This table is intended as an aid for users, to help them select timezones
+# appropriate for their practical needs.  It is not intended to take or
+# endorse any position on legal or territorial claims.
+#
+#XX	coordinates	TZ	comments
+#
+# -11 - SST
+XX	-1416-17042	Pacific/Pago_Pago	Midway; Samoa ("SST")
+#
+# -11
+XX	-1901-16955	Pacific/Niue	Niue
+#
+# -10 - HST
+XX	+211825-1575130	Pacific/Honolulu	Hawaii ("HST")
+#
+# -10
+XX	-1732-14934	Pacific/Tahiti	Tahiti; Cook Islands
+#
+# -10/-09 - HST / HDT (North America DST)
+XX	+515248-1763929	America/Adak	western Aleutians in Alaska ("HST/HDT")
+#
+# -09:30
+XX	-0900-13930	Pacific/Marquesas	Marquesas
+#
+# -09
+XX	-2308-13457	Pacific/Gambier	Gambier
+#
+# -09/-08 - AKST/AKDT (North America DST)
+XX	+611305-1495401	America/Anchorage	most of Alaska ("AKST/AKDT")
+#
+# -08
+XX	-2504-13005	Pacific/Pitcairn	Pitcairn
+#
+# -08/-07 - PST/PDT (North America DST)
+XX	+340308-1181434	America/Los_Angeles	Pacific ("PST/PDT") - US & Canada; Mexico near US border
+#
+# -07 - MST
+XX	+332654-1120424	America/Phoenix	Mountain Standard ("MST") - Arizona; western Mexico; Yukon
+#
+# -07/-06 - MST/MDT (North America DST)
+XX	+394421-1045903	America/Denver	Mountain ("MST/MDT") - US & Canada; Mexico near US border
+#
+# -06
+XX	-0054-08936	Pacific/Galapagos	Galápagos
+#
+# -06 - CST
+XX	+1924-09909	America/Mexico_City	Central Standard ("CST") - Saskatchewan; central Mexico; Central America
+#
+# -06/-05 (Chile DST)
+XX	-2709-10926	Pacific/Easter	Easter Island
+#
+# -06/-05 - CST/CDT (North America DST)
+XX	+415100-0873900	America/Chicago	Central ("CST/CDT") - US & Canada; Mexico near US border
+#
+# -05
+XX	-1203-07703	America/Lima	eastern South America
+#
+# -05 - EST
+XX	+175805-0764736	America/Jamaica	Eastern Standard ("EST") - Caymans; Jamaica; eastern Mexico; Panama
+#
+# -05/-04 - CST/CDT (Cuba DST)
+XX	+2308-08222	America/Havana	Cuba
+#
+# -05/-04 - EST/EDT (North America DST)
+XX	+404251-0740023	America/New_York	Eastern ("EST/EDT") - US & Canada
+#
+# -04
+XX	+1030-06656	America/Caracas	western South America
+#
+# -04 - AST
+XX	+1828-06954	America/Santo_Domingo	Atlantic Standard ("AST") - eastern Caribbean
+#
+# -04/-03 (Chile DST)
+XX	-3327-07040	America/Santiago	most of Chile
+#
+# -04/-03 (Paraguay DST)
+XX	-2516-05740	America/Asuncion	Paraguay
+#
+# -04/-03 - AST/ADT (North America DST)
+XX	+4439-06336	America/Halifax	Atlantic ("AST/ADT") - Canada; Bermuda
+#
+# -03:30/-02:30 - NST/NDT (North America DST)
+XX	+4734-05243	America/St_Johns	Newfoundland ("NST/NDT")
+#
+# -03
+XX	-2332-04637	America/Sao_Paulo	eastern South America
+#
+# -03/-02 (North America DST)
+XX	+4703-05620	America/Miquelon	St Pierre & Miquelon
+#
+# -02
+XX	-0351-03225	America/Noronha	Fernando de Noronha; South Georgia
+#
+# -02/-01 (EU DST)
+XX	+6411-05144	America/Nuuk	most of Greenland
+#
+# -01
+XX	+1455-02331	Atlantic/Cape_Verde	Cape Verde
+#
+# -01/+00 (EU DST)
+XX	+3744-02540	Atlantic/Azores	Azores
+# -01/+00 (EU DST) until 2024-03-31; then -02/-01 (EU DST)
+XX	+7029-02158	America/Scoresbysund	Ittoqqortoormiit
+#
+# +00 - GMT
+XX	+0519-00402	Africa/Abidjan	far western Africa; Iceland ("GMT")
+#
+# +00/+01 - GMT/BST (EU DST)
+XX	+513030-0000731	Europe/London	United Kingdom ("GMT/BST")
+#
+# +00/+01 - WET/WEST (EU DST)
+XX	+3843-00908	Europe/Lisbon	western Europe ("WET/WEST")
+#
+# +00/+02 - Troll DST
+XX	-720041+0023206	Antarctica/Troll	Troll Station in Antarctica
+#
+# +01 - CET
+XX	+3647+00303	Africa/Algiers	Algeria, Tunisia ("CET")
+#
+# +01 - WAT
+XX	+0627+00324	Africa/Lagos	western Africa ("WAT")
+#
+# +01/+00 - IST/GMT (EU DST in reverse)
+XX	+5320-00615	Europe/Dublin	Ireland ("IST/GMT")
+#
+# +01/+00 - (Morocco DST)
+XX	+3339-00735	Africa/Casablanca	Morocco
+#
+# +01/+02 - CET/CEST (EU DST)
+XX	+4852+00220	Europe/Paris	central Europe ("CET/CEST")
+#
+# +02 - CAT
+XX	-2558+03235	Africa/Maputo	central Africa ("CAT")
+#
+# +02 - EET
+XX	+3254+01311	Africa/Tripoli	Libya; Kaliningrad ("EET")
+#
+# +02 - SAST
+XX	-2615+02800	Africa/Johannesburg	southern Africa ("SAST")
+#
+# +02/+03 - EET/EEST (EU DST)
+XX	+3758+02343	Europe/Athens	eastern Europe ("EET/EEST")
+#
+# +02/+03 - EET/EEST (Egypt DST)
+XX	+3003+03115	Africa/Cairo	Egypt
+#
+# +02/+03 - EET/EEST (Lebanon DST)
+XX	+3353+03530	Asia/Beirut	Lebanon
+#
+# +02/+03 - EET/EEST (Moldova DST)
+XX	+4700+02850	Europe/Chisinau	Moldova
+#
+# +02/+03 - EET/EEST (Palestine DST)
+XX	+3130+03428	Asia/Gaza	Palestine
+#
+# +02/+03 - IST/IDT (Israel DST)
+XX	+314650+0351326	Asia/Jerusalem	Israel
+#
+# +03
+XX	+4101+02858	Europe/Istanbul	Near East; Belarus
+#
+# +03 - EAT
+XX	-0117+03649	Africa/Nairobi	eastern Africa ("EAT")
+#
+# +03 - MSK
+XX	+554521+0373704	Europe/Moscow	Moscow ("MSK")
+#
+# +03:30
+XX	+3540+05126	Asia/Tehran	Iran
+#
+# +04
+XX	+2518+05518	Asia/Dubai	Russia; Caucasus; Persian Gulf; Seychelles; Réunion
+#
+# +04:30
+XX	+3431+06912	Asia/Kabul	Afghanistan
+#
+# +05
+XX	+4120+06918	Asia/Tashkent	Russia; west Kazakhstan; Tajikistan; Turkmenistan; Uzbekistan; Maldives
+#
+# +05 - PKT
+XX	+2452+06703	Asia/Karachi	Pakistan ("PKT")
+#
+# +05:30
+XX	+0656+07951	Asia/Colombo	Sri Lanka
+#
+# +05:30 - IST
+XX	+2232+08822	Asia/Kolkata	India ("IST")
+#
+# +05:45
+XX	+2743+08519	Asia/Kathmandu	Nepal
+#
+# +06
+XX	+2343+09025	Asia/Dhaka	Russia; Kyrgyzstan; Bhutan; Bangladesh; Chagos
+# +06 until 2024-03-01; then +05
+XX	+4315+07657	Asia/Almaty	Kazakhstan (except western areas)
+#
+# +06:30
+XX	+1647+09610	Asia/Yangon	Myanmar; Cocos
+#
+# +07
+XX	+1345+10031	Asia/Bangkok	Russia; Indochina; Christmas Island
+#
+# +07 - WIB
+XX	-0610+10648	Asia/Jakarta	Indonesia ("WIB")
+#
+# +08
+XX	+0117+10351	Asia/Singapore	Russia; Brunei; Malaysia; Singapore
+#
+# +08 - AWST
+XX	-3157+11551	Australia/Perth	Western Australia ("AWST")
+#
+# +08 - CST
+XX	+3114+12128	Asia/Shanghai	China ("CST")
+#
+# +08 - HKT
+XX	+2217+11409	Asia/Hong_Kong	Hong Kong ("HKT")
+#
+# +08 - PHT
+XX	+1435+12100	Asia/Manila	Philippines ("PHT")
+#
+# +08 - WITA
+XX	-0507+11924	Asia/Makassar	Indonesia ("WITA")
+#
+# +08:45
+XX	-3143+12852	Australia/Eucla	Eucla
+#
+# +09
+XX	+5203+11328	Asia/Chita	Russia; Palau; East Timor
+#
+# +09 - JST
+XX	+353916+1394441	Asia/Tokyo	Japan ("JST")
+#
+# +09 - KST
+XX	+3733+12658	Asia/Seoul	Korea ("KST")
+#
+# +09 - WIT
+XX	-0232+14042	Asia/Jayapura	Indonesia ("WIT")
+#
+# +09:30 - ACST
+XX	-1228+13050	Australia/Darwin	Northern Territory ("ACST")
+#
+# +09:30/+10:30 - ACST/ACDT (Australia DST)
+XX	-3455+13835	Australia/Adelaide	South Australia ("ACST/ACDT")
+#
+# +10
+XX	+4310+13156	Asia/Vladivostok	Russia; Yap; Chuuk; Papua New Guinea; Dumont d'Urville
+#
+# +10 - AEST
+XX	-2728+15302	Australia/Brisbane	Queensland ("AEST")
+#
+# +10 - ChST
+XX	+1328+14445	Pacific/Guam	Mariana Islands ("ChST")
+#
+# +10/+11 - AEST/AEDT (Australia DST)
+XX	-3352+15113	Australia/Sydney	southeast Australia ("AEST/AEDT")
+#
+# +10:30/+11
+XX	-3133+15905	Australia/Lord_Howe	Lord Howe Island
+#
+# +11
+XX	-0613+15534	Pacific/Bougainville	Russia; Kosrae; Bougainville; Solomons
+#
+# +11/+12 (Australia DST)
+XX	-2903+16758	Pacific/Norfolk	Norfolk Island
+#
+# +12
+XX	+5301+15839	Asia/Kamchatka	Russia; Tuvalu; Fiji; etc.
+#
+# +12/+13 (New Zealand DST)
+XX	-3652+17446	Pacific/Auckland	New Zealand ("NZST/NZDT")
+#
+# +12:45/+13:45 (Chatham DST)
+XX	-4357-17633	Pacific/Chatham	Chatham Islands
+#
+# +13
+XX	-210800-1751200	Pacific/Tongatapu	Kanton; Tokelau; Samoa (western); Tonga
+#
+# +14
+XX	+0152-15720	Pacific/Kiritimati	Kiritimati
diff --git a/lib/tzdata/zones b/lib/tzdata/zones
index 9300ebb0..b054f010 100644
--- a/lib/tzdata/zones
+++ b/lib/tzdata/zones
@@ -1,343 +1,254 @@
-Africa/Algiers
-Atlantic/Cape_Verde
-Africa/Ndjamena
 Africa/Abidjan
-Africa/Cairo
+Africa/Algiers
 Africa/Bissau
-Africa/Nairobi
-Africa/Monrovia
-Africa/Tripoli
-Indian/Mauritius
+Africa/Cairo
 Africa/Casablanca
-Africa/El_Aaiun
-Africa/Maputo
-Africa/Windhoek
-Africa/Lagos
-Africa/Sao_Tome
-Africa/Johannesburg
-Africa/Khartoum
-Africa/Juba
-Africa/Tunis
-Antarctica/Casey
-Antarctica/Davis
-Antarctica/Mawson
-Antarctica/Troll
-Antarctica/Rothera
-Asia/Kabul
-Asia/Yerevan
-Asia/Baku
-Asia/Dhaka
-Asia/Thimphu
-Indian/Chagos
-Asia/Yangon
-Asia/Shanghai
-Asia/Urumqi
-Asia/Hong_Kong
-Asia/Taipei
-Asia/Macau
-Asia/Nicosia
-Asia/Famagusta
-Asia/Tbilisi
-Asia/Dili
-Asia/Kolkata
-Asia/Jakarta
-Asia/Pontianak
-Asia/Makassar
-Asia/Jayapura
-Asia/Tehran
-Asia/Baghdad
-Asia/Jerusalem
-Asia/Tokyo
-Asia/Amman
-Asia/Almaty
-Asia/Qyzylorda
-Asia/Qostanay
-Asia/Aqtobe
-Asia/Aqtau
-Asia/Atyrau
-Asia/Oral
-Asia/Bishkek
-Asia/Seoul
-Asia/Pyongyang
-Asia/Beirut
-Asia/Kuching
-Indian/Maldives
-Asia/Hovd
-Asia/Ulaanbaatar
-Asia/Choibalsan
-Asia/Kathmandu
-Asia/Karachi
-Asia/Gaza
-Asia/Hebron
-Asia/Manila
-Asia/Qatar
-Asia/Riyadh
-Asia/Singapore
-Asia/Colombo
-Asia/Damascus
-Asia/Dushanbe
-Asia/Bangkok
-Asia/Ashgabat
-Asia/Dubai
-Asia/Samarkand
-Asia/Tashkent
-Asia/Ho_Chi_Minh
-Australia/Darwin
-Australia/Perth
-Australia/Eucla
-Australia/Brisbane
-Australia/Lindeman
-Australia/Adelaide
-Australia/Hobart
-Australia/Melbourne
-Australia/Sydney
-Australia/Broken_Hill
-Australia/Lord_Howe
-Antarctica/Macquarie
-Pacific/Fiji
-Pacific/Gambier
-Pacific/Marquesas
-Pacific/Tahiti
-Pacific/Guam
-Pacific/Tarawa
-Pacific/Kanton
-Pacific/Kiritimati
-Pacific/Kwajalein
-Pacific/Kosrae
-Pacific/Nauru
-Pacific/Noumea
-Pacific/Auckland
-Pacific/Chatham
-Pacific/Rarotonga
-Pacific/Niue
-Pacific/Norfolk
-Pacific/Palau
-Pacific/Port_Moresby
-Pacific/Bougainville
-Pacific/Pitcairn
-Pacific/Pago_Pago
-Pacific/Apia
-Pacific/Guadalcanal
-Pacific/Fakaofo
-Pacific/Tongatapu
-Pacific/Efate
-Europe/London
-Europe/Dublin
-WET
-CET
-MET
-EET
-Europe/Tirane
-Europe/Andorra
-Europe/Vienna
-Europe/Minsk
-Europe/Brussels
-Europe/Sofia
-Europe/Prague
-Atlantic/Faroe
-America/Danmarkshavn
-America/Scoresbysund
-America/Nuuk
-America/Thule
-Europe/Tallinn
-Europe/Helsinki
-Europe/Paris
-Europe/Berlin
-Europe/Gibraltar
-Europe/Athens
-Europe/Budapest
-Europe/Rome
-Europe/Riga
-Europe/Vilnius
-Europe/Malta
-Europe/Chisinau
-Europe/Warsaw
-Europe/Lisbon
-Atlantic/Azores
-Atlantic/Madeira
-Europe/Bucharest
-Europe/Kaliningrad
-Europe/Moscow
-Europe/Simferopol
-Europe/Astrakhan
-Europe/Volgograd
-Europe/Saratov
-Europe/Kirov
-Europe/Samara
-Europe/Ulyanovsk
-Asia/Yekaterinburg
-Asia/Omsk
-Asia/Barnaul
-Asia/Novosibirsk
-Asia/Tomsk
-Asia/Novokuznetsk
-Asia/Krasnoyarsk
-Asia/Irkutsk
-Asia/Chita
-Asia/Yakutsk
-Asia/Vladivostok
-Asia/Khandyga
-Asia/Sakhalin
-Asia/Magadan
-Asia/Srednekolymsk
-Asia/Ust-Nera
-Asia/Kamchatka
-Asia/Anadyr
-Europe/Belgrade
-Europe/Madrid
 Africa/Ceuta
-Atlantic/Canary
-Europe/Zurich
-Europe/Istanbul
-Europe/Kyiv
-EST
-MST
-HST
-EST5EDT
-CST6CDT
-MST7MDT
-PST8PDT
-America/New_York
-America/Chicago
-America/North_Dakota/Center
-America/North_Dakota/New_Salem
-America/North_Dakota/Beulah
-America/Denver
-America/Los_Angeles
-America/Juneau
-America/Sitka
-America/Metlakatla
-America/Yakutat
-America/Anchorage
-America/Nome
+Africa/El_Aaiun
+Africa/Johannesburg
+Africa/Juba
+Africa/Khartoum
+Africa/Lagos
+Africa/Maputo
+Africa/Monrovia
+Africa/Nairobi
+Africa/Ndjamena
+Africa/Sao_Tome
+Africa/Tripoli
+Africa/Tunis
+Africa/Windhoek
 America/Adak
-Pacific/Honolulu
-America/Phoenix
+America/Anchorage
+America/Araguaina
+America/Argentina/Buenos_Aires
+America/Argentina/Catamarca
+America/Argentina/Cordoba
+America/Argentina/Jujuy
+America/Argentina/La_Rioja
+America/Argentina/Mendoza
+America/Argentina/Rio_Gallegos
+America/Argentina/Salta
+America/Argentina/San_Juan
+America/Argentina/San_Luis
+America/Argentina/Tucuman
+America/Argentina/Ushuaia
+America/Asuncion
+America/Bahia
+America/Bahia_Banderas
+America/Barbados
+America/Belem
+America/Belize
+America/Boa_Vista
+America/Bogota
 America/Boise
+America/Cambridge_Bay
+America/Campo_Grande
+America/Cancun
+America/Caracas
+America/Cayenne
+America/Chicago
+America/Chihuahua
+America/Ciudad_Juarez
+America/Costa_Rica
+America/Cuiaba
+America/Danmarkshavn
+America/Dawson
+America/Dawson_Creek
+America/Denver
+America/Detroit
+America/Edmonton
+America/Eirunepe
+America/El_Salvador
+America/Fort_Nelson
+America/Fortaleza
+America/Glace_Bay
+America/Goose_Bay
+America/Grand_Turk
+America/Guatemala
+America/Guayaquil
+America/Guyana
+America/Halifax
+America/Havana
+America/Hermosillo
 America/Indiana/Indianapolis
-America/Indiana/Marengo
-America/Indiana/Vincennes
-America/Indiana/Tell_City
-America/Indiana/Petersburg
 America/Indiana/Knox
-America/Indiana/Winamac
+America/Indiana/Marengo
+America/Indiana/Petersburg
+America/Indiana/Tell_City
 America/Indiana/Vevay
+America/Indiana/Vincennes
+America/Indiana/Winamac
+America/Inuvik
+America/Iqaluit
+America/Jamaica
+America/Juneau
 America/Kentucky/Louisville
 America/Kentucky/Monticello
-America/Detroit
-America/Menominee
-America/St_Johns
-America/Goose_Bay
-America/Halifax
-America/Glace_Bay
-America/Moncton
-America/Toronto
-America/Winnipeg
-America/Regina
-America/Swift_Current
-America/Edmonton
-America/Vancouver
-America/Dawson_Creek
-America/Fort_Nelson
-America/Iqaluit
-America/Resolute
-America/Rankin_Inlet
-America/Cambridge_Bay
-America/Inuvik
-America/Whitehorse
-America/Dawson
-America/Cancun
-America/Merida
-America/Matamoros
-America/Monterrey
-America/Mexico_City
-America/Ciudad_Juarez
-America/Ojinaga
-America/Chihuahua
-America/Hermosillo
-America/Mazatlan
-America/Bahia_Banderas
-America/Tijuana
-America/Barbados
-America/Belize
-Atlantic/Bermuda
-America/Costa_Rica
-America/Havana
-America/Santo_Domingo
-America/El_Salvador
-America/Guatemala
-America/Port-au-Prince
-America/Tegucigalpa
-America/Jamaica
-America/Martinique
-America/Managua
-America/Panama
-America/Puerto_Rico
-America/Miquelon
-America/Grand_Turk
-America/Argentina/Buenos_Aires
-America/Argentina/Cordoba
-America/Argentina/Salta
-America/Argentina/Tucuman
-America/Argentina/La_Rioja
-America/Argentina/San_Juan
-America/Argentina/Jujuy
-America/Argentina/Catamarca
-America/Argentina/Mendoza
-America/Argentina/San_Luis
-America/Argentina/Rio_Gallegos
-America/Argentina/Ushuaia
 America/La_Paz
-America/Noronha
-America/Belem
-America/Santarem
-America/Fortaleza
-America/Recife
-America/Araguaina
-America/Maceio
-America/Bahia
-America/Sao_Paulo
-America/Campo_Grande
-America/Cuiaba
-America/Porto_Velho
-America/Boa_Vista
-America/Manaus
-America/Eirunepe
-America/Rio_Branco
-America/Santiago
-America/Punta_Arenas
-Pacific/Easter
-Antarctica/Palmer
-America/Bogota
-America/Guayaquil
-Pacific/Galapagos
-Atlantic/Stanley
-America/Cayenne
-America/Guyana
-America/Asuncion
 America/Lima
-Atlantic/South_Georgia
-America/Paramaribo
+America/Los_Angeles
+America/Maceio
+America/Managua
+America/Manaus
+America/Martinique
+America/Matamoros
+America/Mazatlan
+America/Menominee
+America/Merida
+America/Metlakatla
+America/Mexico_City
+America/Miquelon
+America/Moncton
+America/Monterrey
 America/Montevideo
-America/Caracas
-Etc/UTC
+America/New_York
+America/Nome
+America/Noronha
+America/North_Dakota/Beulah
+America/North_Dakota/Center
+America/North_Dakota/New_Salem
+America/Nuuk
+America/Ojinaga
+America/Panama
+America/Paramaribo
+America/Phoenix
+America/Port-au-Prince
+America/Porto_Velho
+America/Puerto_Rico
+America/Punta_Arenas
+America/Rankin_Inlet
+America/Recife
+America/Regina
+America/Resolute
+America/Rio_Branco
+America/Santarem
+America/Santiago
+America/Santo_Domingo
+America/Sao_Paulo
+America/Scoresbysund
+America/Sitka
+America/St_Johns
+America/Swift_Current
+America/Tegucigalpa
+America/Thule
+America/Tijuana
+America/Toronto
+America/Vancouver
+America/Whitehorse
+America/Winnipeg
+America/Yakutat
+Antarctica/Casey
+Antarctica/Davis
+Antarctica/Macquarie
+Antarctica/Mawson
+Antarctica/Palmer
+Antarctica/Rothera
+Antarctica/Troll
+Antarctica/Vostok
+Asia/Almaty
+Asia/Amman
+Asia/Anadyr
+Asia/Aqtau
+Asia/Aqtobe
+Asia/Ashgabat
+Asia/Atyrau
+Asia/Baghdad
+Asia/Baku
+Asia/Bangkok
+Asia/Barnaul
+Asia/Beirut
+Asia/Bishkek
+Asia/Chita
+Asia/Choibalsan
+Asia/Colombo
+Asia/Damascus
+Asia/Dhaka
+Asia/Dili
+Asia/Dubai
+Asia/Dushanbe
+Asia/Famagusta
+Asia/Gaza
+Asia/Hebron
+Asia/Ho_Chi_Minh
+Asia/Hong_Kong
+Asia/Hovd
+Asia/Irkutsk
+Asia/Jakarta
+Asia/Jayapura
+Asia/Jerusalem
+Asia/Kabul
+Asia/Kamchatka
+Asia/Karachi
+Asia/Kathmandu
+Asia/Khandyga
+Asia/Kolkata
+Asia/Krasnoyarsk
+Asia/Kuching
+Asia/Macau
+Asia/Magadan
+Asia/Makassar
+Asia/Manila
+Asia/Nicosia
+Asia/Novokuznetsk
+Asia/Novosibirsk
+Asia/Omsk
+Asia/Oral
+Asia/Pontianak
+Asia/Pyongyang
+Asia/Qatar
+Asia/Qostanay
+Asia/Qyzylorda
+Asia/Riyadh
+Asia/Sakhalin
+Asia/Samarkand
+Asia/Seoul
+Asia/Shanghai
+Asia/Singapore
+Asia/Srednekolymsk
+Asia/Taipei
+Asia/Tashkent
+Asia/Tbilisi
+Asia/Tehran
+Asia/Thimphu
+Asia/Tokyo
+Asia/Tomsk
+Asia/Ulaanbaatar
+Asia/Urumqi
+Asia/Ust-Nera
+Asia/Vladivostok
+Asia/Yakutsk
+Asia/Yangon
+Asia/Yekaterinburg
+Asia/Yerevan
+Atlantic/Azores
+Atlantic/Bermuda
+Atlantic/Canary
+Atlantic/Cape_Verde
+Atlantic/Faroe
+Atlantic/Madeira
+Atlantic/South_Georgia
+Atlantic/Stanley
+Australia/Adelaide
+Australia/Brisbane
+Australia/Broken_Hill
+Australia/Darwin
+Australia/Eucla
+Australia/Hobart
+Australia/Lindeman
+Australia/Lord_Howe
+Australia/Melbourne
+Australia/Perth
+Australia/Sydney
+CET
+CST6CDT
+EET
+EST
+EST5EDT
 Etc/GMT
-GMT
-Etc/GMT-14
-Etc/GMT-13
-Etc/GMT-12
-Etc/GMT-11
-Etc/GMT-10
-Etc/GMT-9
-Etc/GMT-8
-Etc/GMT-7
-Etc/GMT-6
-Etc/GMT-5
-Etc/GMT-4
-Etc/GMT-3
-Etc/GMT-2
-Etc/GMT-1
 Etc/GMT+1
+Etc/GMT+10
+Etc/GMT+11
+Etc/GMT+12
 Etc/GMT+2
 Etc/GMT+3
 Etc/GMT+4
@@ -346,10 +257,100 @@ Etc/GMT+6
 Etc/GMT+7
 Etc/GMT+8
 Etc/GMT+9
-Etc/GMT+10
-Etc/GMT+11
-Etc/GMT+12
+Etc/GMT-1
+Etc/GMT-10
+Etc/GMT-11
+Etc/GMT-12
+Etc/GMT-13
+Etc/GMT-14
+Etc/GMT-2
+Etc/GMT-3
+Etc/GMT-4
+Etc/GMT-5
+Etc/GMT-6
+Etc/GMT-7
+Etc/GMT-8
+Etc/GMT-9
+Etc/UTC
+Europe/Andorra
+Europe/Astrakhan
+Europe/Athens
+Europe/Belgrade
+Europe/Berlin
+Europe/Brussels
+Europe/Bucharest
+Europe/Budapest
+Europe/Chisinau
+Europe/Dublin
+Europe/Gibraltar
+Europe/Helsinki
+Europe/Istanbul
+Europe/Kaliningrad
+Europe/Kirov
+Europe/Kyiv
+Europe/Lisbon
+Europe/London
+Europe/Madrid
+Europe/Malta
+Europe/Minsk
+Europe/Moscow
+Europe/Paris
+Europe/Prague
+Europe/Riga
+Europe/Rome
+Europe/Samara
+Europe/Saratov
+Europe/Simferopol
+Europe/Sofia
+Europe/Tallinn
+Europe/Tirane
+Europe/Ulyanovsk
+Europe/Vienna
+Europe/Vilnius
+Europe/Volgograd
+Europe/Warsaw
+Europe/Zurich
 Factory
+HST
+Indian/Chagos
+Indian/Maldives
+Indian/Mauritius
+MET
+MST
+MST7MDT
+PST8PDT
+Pacific/Apia
+Pacific/Auckland
+Pacific/Bougainville
+Pacific/Chatham
+Pacific/Easter
+Pacific/Efate
+Pacific/Fakaofo
+Pacific/Fiji
+Pacific/Galapagos
+Pacific/Gambier
+Pacific/Guadalcanal
+Pacific/Guam
+Pacific/Honolulu
+Pacific/Kanton
+Pacific/Kiritimati
+Pacific/Kosrae
+Pacific/Kwajalein
+Pacific/Marquesas
+Pacific/Nauru
+Pacific/Niue
+Pacific/Norfolk
+Pacific/Noumea
+Pacific/Pago_Pago
+Pacific/Palau
+Pacific/Pitcairn
+Pacific/Port_Moresby
+Pacific/Rarotonga
+Pacific/Tahiti
+Pacific/Tarawa
+Pacific/Tongatapu
+WET
+GMT
 Australia/ACT
 Australia/LHI
 Australia/NSW
@@ -497,7 +498,6 @@ America/Tortola
 Antarctica/DumontDUrville
 Antarctica/McMurdo
 Antarctica/Syowa
-Antarctica/Vostok
 Arctic/Longyearbyen
 Asia/Aden
 Asia/Bahrain
diff --git a/requirements.txt b/requirements.txt
index f697ecc8..8dc7afea 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -43,7 +43,7 @@ simplejson==3.19.2
 six==1.16.0
 tempora==5.5.1
 tokenize-rt==5.2.0
-tzdata==2023.3
+tzdata==2024.1
 tzlocal==5.0.1
 urllib3<2
 webencodings==0.5.1

From 26358427cef803501311afb32e405df5d8b8b8a8 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 30 Mar 2024 15:28:45 -0700
Subject: [PATCH 562/743] Bump pyparsing from 3.1.1 to 3.1.2 (#2296)

* Bump pyparsing from 3.1.1 to 3.1.2

Bumps [pyparsing](https://github.com/pyparsing/pyparsing) from 3.1.1 to 3.1.2.
- [Release notes](https://github.com/pyparsing/pyparsing/releases)
- [Changelog](https://github.com/pyparsing/pyparsing/blob/master/CHANGES)
- [Commits](https://github.com/pyparsing/pyparsing/compare/3.1.1...pyparsing_3.1.2)

---
updated-dependencies:
- dependency-name: pyparsing
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

* Update pyparsing==3.1.2

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/pyparsing/__init__.py         |   4 +-
 lib/pyparsing/actions.py          |  21 +-
 lib/pyparsing/common.py           |   9 +-
 lib/pyparsing/core.py             | 762 ++++++++++++++----------------
 lib/pyparsing/diagram/__init__.py |   2 +-
 lib/pyparsing/exceptions.py       |  75 +--
 lib/pyparsing/helpers.py          |  86 ++--
 lib/pyparsing/results.py          | 211 +++++----
 lib/pyparsing/testing.py          | 118 +++--
 lib/pyparsing/unicode.py          |  13 +-
 lib/pyparsing/util.py             |  13 +-
 requirements.txt                  |   2 +-
 12 files changed, 610 insertions(+), 706 deletions(-)

diff --git a/lib/pyparsing/__init__.py b/lib/pyparsing/__init__.py
index 3dbc3cf8..79d8153c 100644
--- a/lib/pyparsing/__init__.py
+++ b/lib/pyparsing/__init__.py
@@ -120,8 +120,8 @@ class version_info(NamedTuple):
         return f"{__name__}.{type(self).__name__}({', '.join('{}={!r}'.format(*nv) for nv in zip(self._fields, self))})"
 
 
-__version_info__ = version_info(3, 1, 1, "final", 1)
-__version_time__ = "29 Jul 2023 22:27 UTC"
+__version_info__ = version_info(3, 1, 2, "final", 1)
+__version_time__ = "06 Mar 2024 07:08 UTC"
 __version__ = __version_info__.__version__
 __versionTime__ = __version_time__
 __author__ = "Paul McGuire <ptmcg.gm+pyparsing@gmail.com>"
diff --git a/lib/pyparsing/actions.py b/lib/pyparsing/actions.py
index ca6e4c6a..ce51b395 100644
--- a/lib/pyparsing/actions.py
+++ b/lib/pyparsing/actions.py
@@ -111,7 +111,6 @@ def with_attribute(*args, **attr_dict):
             <div type="graph">1,3 2,3 1,1</div>
             <div>this has no type</div>
             </div>
-
         '''
         div,div_end = make_html_tags("div")
 
@@ -199,19 +198,9 @@ def with_class(classname, namespace=""):
 
 # pre-PEP8 compatibility symbols
 # fmt: off
-@replaced_by_pep8(replace_with)
-def replaceWith(): ...
-
-@replaced_by_pep8(remove_quotes)
-def removeQuotes(): ...
-
-@replaced_by_pep8(with_attribute)
-def withAttribute(): ...
-
-@replaced_by_pep8(with_class)
-def withClass(): ...
-
-@replaced_by_pep8(match_only_at_col)
-def matchOnlyAtCol(): ...
-
+replaceWith = replaced_by_pep8("replaceWith", replace_with)
+removeQuotes = replaced_by_pep8("removeQuotes", remove_quotes)
+withAttribute = replaced_by_pep8("withAttribute", with_attribute)
+withClass = replaced_by_pep8("withClass", with_class)
+matchOnlyAtCol = replaced_by_pep8("matchOnlyAtCol", match_only_at_col)
 # fmt: on
diff --git a/lib/pyparsing/common.py b/lib/pyparsing/common.py
index 7a666b27..74faa460 100644
--- a/lib/pyparsing/common.py
+++ b/lib/pyparsing/common.py
@@ -206,7 +206,7 @@ class pyparsing_common:
     scientific notation and returns a float"""
 
     # streamlining this expression makes the docs nicer-looking
-    number = (sci_real | real | signed_integer).setName("number").streamline()
+    number = (sci_real | real | signed_integer).set_name("number").streamline()
     """any numeric expression, returns the corresponding Python type"""
 
     fnumber = (
@@ -216,6 +216,13 @@ class pyparsing_common:
     )
     """any int or real number, returned as float"""
 
+    ieee_float = (
+        Regex(r"(?i)[+-]?((\d+\.?\d*(e[+-]?\d+)?)|nan|inf(inity)?)")
+        .set_name("ieee_float")
+        .set_parse_action(convert_to_float)
+    )
+    """any floating-point literal (int, real number, infinity, or NaN), returned as float"""
+
     identifier = Word(identchars, identbodychars).set_name("identifier")
     """typical code identifier (leading alpha or '_', followed by 0 or more alphas, nums, or '_')"""
 
diff --git a/lib/pyparsing/core.py b/lib/pyparsing/core.py
index 73514ed0..b19d1221 100644
--- a/lib/pyparsing/core.py
+++ b/lib/pyparsing/core.py
@@ -571,6 +571,7 @@ class ParserElement(ABC):
 
         Example::
 
+            integer = Word(nums)
             date_str = (integer.set_results_name("year") + '/'
                         + integer.set_results_name("month") + '/'
                         + integer.set_results_name("day"))
@@ -610,9 +611,8 @@ class ParserElement(ABC):
 
             breaker._originalParseMethod = _parseMethod  # type: ignore [attr-defined]
             self._parse = breaker  # type: ignore [assignment]
-        else:
-            if hasattr(self._parse, "_originalParseMethod"):
-                self._parse = self._parse._originalParseMethod  # type: ignore [attr-defined, assignment]
+        elif hasattr(self._parse, "_originalParseMethod"):
+            self._parse = self._parse._originalParseMethod  # type: ignore [attr-defined, assignment]
         return self
 
     def set_parse_action(self, *fns: ParseAction, **kwargs) -> "ParserElement":
@@ -692,13 +692,15 @@ class ParserElement(ABC):
         """
         if list(fns) == [None]:
             self.parseAction = []
-        else:
-            if not all(callable(fn) for fn in fns):
-                raise TypeError("parse actions must be callable")
-            self.parseAction = [_trim_arity(fn) for fn in fns]
-            self.callDuringTry = kwargs.get(
-                "call_during_try", kwargs.get("callDuringTry", False)
-            )
+            return self
+
+        if not all(callable(fn) for fn in fns):
+            raise TypeError("parse actions must be callable")
+        self.parseAction = [_trim_arity(fn) for fn in fns]
+        self.callDuringTry = kwargs.get(
+            "call_during_try", kwargs.get("callDuringTry", False)
+        )
+
         return self
 
     def add_parse_action(self, *fns: ParseAction, **kwargs) -> "ParserElement":
@@ -944,11 +946,9 @@ class ParserElement(ABC):
 
         not_in_cache: bool
 
-        def get(self, *args):
-            ...
+        def get(self, *args): ...
 
-        def set(self, *args):
-            ...
+        def set(self, *args): ...
 
     # argument cache for optimizing repeated calls when backtracking through recursive expressions
     packrat_cache = (
@@ -1080,7 +1080,7 @@ class ParserElement(ABC):
         elif cache_size_limit > 0:
             ParserElement.recursion_memos = _LRUMemo(capacity=cache_size_limit)  # type: ignore[assignment]
         else:
-            raise NotImplementedError("Memo size of %s" % cache_size_limit)
+            raise NotImplementedError(f"Memo size of {cache_size_limit}")
         ParserElement._left_recursion_enabled = True
 
     @staticmethod
@@ -1121,13 +1121,16 @@ class ParserElement(ABC):
             ParserElement.disable_memoization()
         elif ParserElement._left_recursion_enabled:
             raise RuntimeError("Packrat and Bounded Recursion are not compatible")
-        if not ParserElement._packratEnabled:
-            ParserElement._packratEnabled = True
-            if cache_size_limit is None:
-                ParserElement.packrat_cache = _UnboundedCache()
-            else:
-                ParserElement.packrat_cache = _FifoCache(cache_size_limit)  # type: ignore[assignment]
-            ParserElement._parse = ParserElement._parseCache
+
+        if ParserElement._packratEnabled:
+            return
+
+        ParserElement._packratEnabled = True
+        if cache_size_limit is None:
+            ParserElement.packrat_cache = _UnboundedCache()
+        else:
+            ParserElement.packrat_cache = _FifoCache(cache_size_limit)  # type: ignore[assignment]
+        ParserElement._parse = ParserElement._parseCache
 
     def parse_string(
         self, instring: str, parse_all: bool = False, *, parseAll: bool = False
@@ -1285,9 +1288,9 @@ class ParserElement(ABC):
         except ParseBaseException as exc:
             if ParserElement.verbose_stacktrace:
                 raise
-            else:
-                # catch and re-raise exception from here, clears out pyparsing internal stack trace
-                raise exc.with_traceback(None)
+
+            # catch and re-raise exception from here, clears out pyparsing internal stack trace
+            raise exc.with_traceback(None)
 
     def transform_string(self, instring: str, *, debug: bool = False) -> str:
         """
@@ -1317,23 +1320,27 @@ class ParserElement(ABC):
         try:
             for t, s, e in self.scan_string(instring, debug=debug):
                 out.append(instring[lastE:s])
-                if t:
-                    if isinstance(t, ParseResults):
-                        out += t.as_list()
-                    elif isinstance(t, Iterable) and not isinstance(t, str_type):
-                        out.extend(t)
-                    else:
-                        out.append(t)
                 lastE = e
+
+                if not t:
+                    continue
+
+                if isinstance(t, ParseResults):
+                    out += t.as_list()
+                elif isinstance(t, Iterable) and not isinstance(t, str_type):
+                    out.extend(t)
+                else:
+                    out.append(t)
+
             out.append(instring[lastE:])
             out = [o for o in out if o]
             return "".join([str(s) for s in _flatten(out)])
         except ParseBaseException as exc:
             if ParserElement.verbose_stacktrace:
                 raise
-            else:
-                # catch and re-raise exception from here, clears out pyparsing internal stack trace
-                raise exc.with_traceback(None)
+
+            # catch and re-raise exception from here, clears out pyparsing internal stack trace
+            raise exc.with_traceback(None)
 
     def search_string(
         self,
@@ -1371,9 +1378,9 @@ class ParserElement(ABC):
         except ParseBaseException as exc:
             if ParserElement.verbose_stacktrace:
                 raise
-            else:
-                # catch and re-raise exception from here, clears out pyparsing internal stack trace
-                raise exc.with_traceback(None)
+
+            # catch and re-raise exception from here, clears out pyparsing internal stack trace
+            raise exc.with_traceback(None)
 
     def split(
         self,
@@ -1502,9 +1509,12 @@ class ParserElement(ABC):
         elif isinstance(other, tuple) and other[:1] == (Ellipsis,):
             other = ((0,) + other[1:] + (None,))[:2]
 
+        if not isinstance(other, (int, tuple)):
+            return NotImplemented
+
         if isinstance(other, int):
             minElements, optElements = other, 0
-        elif isinstance(other, tuple):
+        else:
             other = tuple(o if o is not Ellipsis else None for o in other)
             other = (other + (None, None))[:2]
             if other[0] is None:
@@ -1521,8 +1531,6 @@ class ParserElement(ABC):
                 optElements -= minElements
             else:
                 return NotImplemented
-        else:
-            return NotImplemented
 
         if minElements < 0:
             raise ValueError("cannot multiply ParserElement by negative value")
@@ -1711,8 +1719,8 @@ class ParserElement(ABC):
         """
         if name is not None:
             return self._setResultsName(name)
-        else:
-            return self.copy()
+
+        return self.copy()
 
     def suppress(self) -> "ParserElement":
         """
@@ -1770,7 +1778,7 @@ class ParserElement(ABC):
 
         Example::
 
-            patt = Word(alphas)[1, ...]
+            patt = Word(alphas)[...]
             patt.parse_string('ablaj /* comment */ lskjd')
             # -> ['ablaj']
 
@@ -1778,8 +1786,6 @@ class ParserElement(ABC):
             patt.parse_string('ablaj /* comment */ lskjd')
             # -> ['ablaj', 'lskjd']
         """
-        import typing
-
         if isinstance(other, str_type):
             other = Suppress(other)
 
@@ -1887,11 +1893,14 @@ class ParserElement(ABC):
 
         Example::
 
-            Word(nums).parse_string("ABC")  # -> Exception: Expected W:(0-9) (at char 0), (line:1, col:1)
-            Word(nums).set_name("integer").parse_string("ABC")  # -> Exception: Expected integer (at char 0), (line:1, col:1)
+            integer = Word(nums)
+            integer.parse_string("ABC")  # -> Exception: Expected W:(0-9) (at char 0), (line:1, col:1)
+
+            integer.set_name("integer")
+            integer.parse_string("ABC")  # -> Exception: Expected integer (at char 0), (line:1, col:1)
         """
         self.customName = name
-        self.errmsg = "Expected " + self.name
+        self.errmsg = f"Expected {self.name}"
         if __diag__.enable_debug_on_named_expressions:
             self.set_debug()
         return self
@@ -1957,9 +1966,9 @@ class ParserElement(ABC):
         except ParseBaseException as exc:
             if ParserElement.verbose_stacktrace:
                 raise
-            else:
-                # catch and re-raise exception from here, clears out pyparsing internal stack trace
-                raise exc.with_traceback(None)
+
+            # catch and re-raise exception from here, clears out pyparsing internal stack trace
+            raise exc.with_traceback(None)
 
     def __eq__(self, other):
         if self is other:
@@ -2137,6 +2146,7 @@ class ParserElement(ABC):
         success = True
         NL = Literal(r"\n").add_parse_action(replace_with("\n")).ignore(quoted_string)
         BOM = "\ufeff"
+        nlstr = "\n"
         for t in tests:
             if comment_specified and comment.matches(t, False) or comments and not t:
                 comments.append(
@@ -2146,7 +2156,7 @@ class ParserElement(ABC):
             if not t:
                 continue
             out = [
-                "\n" + "\n".join(comments) if comments else "",
+                f"{nlstr}{nlstr.join(comments) if comments else ''}",
                 pyparsing_test.with_line_numbers(t) if with_line_numbers else t,
             ]
             comments = []
@@ -2155,9 +2165,9 @@ class ParserElement(ABC):
                 t = NL.transform_string(t.lstrip(BOM))
                 result = self.parse_string(t, parse_all=parseAll)
             except ParseBaseException as pe:
-                fatal = "(FATAL)" if isinstance(pe, ParseFatalException) else ""
+                fatal = "(FATAL) " if isinstance(pe, ParseFatalException) else ""
                 out.append(pe.explain())
-                out.append("FAIL: " + str(pe))
+                out.append(f"FAIL: {fatal}{pe}")
                 if ParserElement.verbose_stacktrace:
                     out.extend(traceback.format_tb(pe.__traceback__))
                 success = success and failureTests
@@ -2244,91 +2254,42 @@ class ParserElement(ABC):
             show_groups=show_groups,
             diagram_kwargs=kwargs,
         )
-        if isinstance(output_html, (str, Path)):
-            with open(output_html, "w", encoding="utf-8") as diag_file:
-                diag_file.write(railroad_to_html(railroad, embed=embed, **kwargs))
-        else:
+        if not isinstance(output_html, (str, Path)):
             # we were passed a file-like object, just write to it
             output_html.write(railroad_to_html(railroad, embed=embed, **kwargs))
+            return
+
+        with open(output_html, "w", encoding="utf-8") as diag_file:
+            diag_file.write(railroad_to_html(railroad, embed=embed, **kwargs))
 
     # Compatibility synonyms
     # fmt: off
-    @staticmethod
-    @replaced_by_pep8(inline_literals_using)
-    def inlineLiteralsUsing(): ...
-
-    @staticmethod
-    @replaced_by_pep8(set_default_whitespace_chars)
-    def setDefaultWhitespaceChars(): ...
-
-    @replaced_by_pep8(set_results_name)
-    def setResultsName(self): ...
-
-    @replaced_by_pep8(set_break)
-    def setBreak(self): ...
-
-    @replaced_by_pep8(set_parse_action)
-    def setParseAction(self): ...
-
-    @replaced_by_pep8(add_parse_action)
-    def addParseAction(self): ...
-
-    @replaced_by_pep8(add_condition)
-    def addCondition(self): ...
-
-    @replaced_by_pep8(set_fail_action)
-    def setFailAction(self): ...
-
-    @replaced_by_pep8(try_parse)
-    def tryParse(self): ...
-
-    @staticmethod
-    @replaced_by_pep8(enable_left_recursion)
-    def enableLeftRecursion(): ...
-
-    @staticmethod
-    @replaced_by_pep8(enable_packrat)
-    def enablePackrat(): ...
-
-    @replaced_by_pep8(parse_string)
-    def parseString(self): ...
-
-    @replaced_by_pep8(scan_string)
-    def scanString(self): ...
-
-    @replaced_by_pep8(transform_string)
-    def transformString(self): ...
-
-    @replaced_by_pep8(search_string)
-    def searchString(self): ...
-
-    @replaced_by_pep8(ignore_whitespace)
-    def ignoreWhitespace(self): ...
-
-    @replaced_by_pep8(leave_whitespace)
-    def leaveWhitespace(self): ...
-
-    @replaced_by_pep8(set_whitespace_chars)
-    def setWhitespaceChars(self): ...
-
-    @replaced_by_pep8(parse_with_tabs)
-    def parseWithTabs(self): ...
-
-    @replaced_by_pep8(set_debug_actions)
-    def setDebugActions(self): ...
-
-    @replaced_by_pep8(set_debug)
-    def setDebug(self): ...
-
-    @replaced_by_pep8(set_name)
-    def setName(self): ...
-
-    @replaced_by_pep8(parse_file)
-    def parseFile(self): ...
-
-    @replaced_by_pep8(run_tests)
-    def runTests(self): ...
-
+    inlineLiteralsUsing = replaced_by_pep8("inlineLiteralsUsing", inline_literals_using)
+    setDefaultWhitespaceChars = replaced_by_pep8(
+        "setDefaultWhitespaceChars", set_default_whitespace_chars
+    )
+    setResultsName = replaced_by_pep8("setResultsName", set_results_name)
+    setBreak = replaced_by_pep8("setBreak", set_break)
+    setParseAction = replaced_by_pep8("setParseAction", set_parse_action)
+    addParseAction = replaced_by_pep8("addParseAction", add_parse_action)
+    addCondition = replaced_by_pep8("addCondition", add_condition)
+    setFailAction = replaced_by_pep8("setFailAction", set_fail_action)
+    tryParse = replaced_by_pep8("tryParse", try_parse)
+    enableLeftRecursion = replaced_by_pep8("enableLeftRecursion", enable_left_recursion)
+    enablePackrat = replaced_by_pep8("enablePackrat", enable_packrat)
+    parseString = replaced_by_pep8("parseString", parse_string)
+    scanString = replaced_by_pep8("scanString", scan_string)
+    transformString = replaced_by_pep8("transformString", transform_string)
+    searchString = replaced_by_pep8("searchString", search_string)
+    ignoreWhitespace = replaced_by_pep8("ignoreWhitespace", ignore_whitespace)
+    leaveWhitespace = replaced_by_pep8("leaveWhitespace", leave_whitespace)
+    setWhitespaceChars = replaced_by_pep8("setWhitespaceChars", set_whitespace_chars)
+    parseWithTabs = replaced_by_pep8("parseWithTabs", parse_with_tabs)
+    setDebugActions = replaced_by_pep8("setDebugActions", set_debug_actions)
+    setDebug = replaced_by_pep8("setDebug", set_debug)
+    setName = replaced_by_pep8("setName", set_name)
+    parseFile = replaced_by_pep8("parseFile", parse_file)
+    runTests = replaced_by_pep8("runTests", run_tests)
     canParseNext = can_parse_next
     resetCache = reset_cache
     defaultName = default_name
@@ -2358,7 +2319,7 @@ class _PendingSkip(ParserElement):
             def show_skip(t):
                 if t._skipped.as_list()[-1:] == [""]:
                     t.pop("_skipped")
-                    t["_skipped"] = "missing <" + repr(self.anchor) + ">"
+                    t["_skipped"] = f"missing <{self.anchor!r}>"
 
             return (
                 self.anchor + skipper().add_parse_action(must_skip)
@@ -2409,9 +2370,9 @@ class Literal(Token):
 
     Example::
 
-        Literal('blah').parse_string('blah')  # -> ['blah']
-        Literal('blah').parse_string('blahfooblah')  # -> ['blah']
-        Literal('blah').parse_string('bla')  # -> Exception: Expected "blah"
+        Literal('abc').parse_string('abc')  # -> ['abc']
+        Literal('abc').parse_string('abcdef')  # -> ['abc']
+        Literal('abc').parse_string('ab')  # -> Exception: Expected "abc"
 
     For case-insensitive matching, use :class:`CaselessLiteral`.
 
@@ -2441,7 +2402,7 @@ class Literal(Token):
         self.match = match_string
         self.matchLen = len(match_string)
         self.firstMatchChar = match_string[:1]
-        self.errmsg = "Expected " + self.name
+        self.errmsg = f"Expected {self.name}"
         self.mayReturnEmpty = False
         self.mayIndexError = False
 
@@ -2555,39 +2516,36 @@ class Keyword(Token):
                         or instring[loc + self.matchLen].upper() not in self.identChars
                     ):
                         return loc + self.matchLen, self.match
-                    else:
-                        # followed by keyword char
-                        errmsg += ", was immediately followed by keyword character"
-                        errloc = loc + self.matchLen
+
+                    # followed by keyword char
+                    errmsg += ", was immediately followed by keyword character"
+                    errloc = loc + self.matchLen
                 else:
                     # preceded by keyword char
                     errmsg += ", keyword was immediately preceded by keyword character"
                     errloc = loc - 1
             # else no match just raise plain exception
 
-        else:
-            if (
-                instring[loc] == self.firstMatchChar
-                and self.matchLen == 1
-                or instring.startswith(self.match, loc)
-            ):
-                if loc == 0 or instring[loc - 1] not in self.identChars:
-                    if (
-                        loc >= len(instring) - self.matchLen
-                        or instring[loc + self.matchLen] not in self.identChars
-                    ):
-                        return loc + self.matchLen, self.match
-                    else:
-                        # followed by keyword char
-                        errmsg += (
-                            ", keyword was immediately followed by keyword character"
-                        )
-                        errloc = loc + self.matchLen
-                else:
-                    # preceded by keyword char
-                    errmsg += ", keyword was immediately preceded by keyword character"
-                    errloc = loc - 1
-            # else no match just raise plain exception
+        elif (
+            instring[loc] == self.firstMatchChar
+            and self.matchLen == 1
+            or instring.startswith(self.match, loc)
+        ):
+            if loc == 0 or instring[loc - 1] not in self.identChars:
+                if (
+                    loc >= len(instring) - self.matchLen
+                    or instring[loc + self.matchLen] not in self.identChars
+                ):
+                    return loc + self.matchLen, self.match
+
+                # followed by keyword char
+                errmsg += ", keyword was immediately followed by keyword character"
+                errloc = loc + self.matchLen
+            else:
+                # preceded by keyword char
+                errmsg += ", keyword was immediately preceded by keyword character"
+                errloc = loc - 1
+        # else no match just raise plain exception
 
         raise ParseException(instring, errloc, errmsg, self)
 
@@ -2620,7 +2578,7 @@ class CaselessLiteral(Literal):
         super().__init__(match_string.upper())
         # Preserve the defining literal.
         self.returnString = match_string
-        self.errmsg = "Expected " + self.name
+        self.errmsg = f"Expected {self.name}"
 
     def parseImpl(self, instring, loc, doActions=True):
         if instring[loc : loc + self.matchLen].upper() == self.match:
@@ -2795,7 +2753,7 @@ class Word(Token):
         integer = Word(nums) # equivalent to Word("0123456789") or Word(srange("0-9"))
 
         # a word with a leading capital, and zero or more lowercase
-        capital_word = Word(alphas.upper(), alphas.lower())
+        capitalized_word = Word(alphas.upper(), alphas.lower())
 
         # hostnames are alphanumeric, with leading alpha, and '-'
         hostname = Word(alphas, alphanums + '-')
@@ -2872,7 +2830,7 @@ class Word(Token):
             self.maxLen = exact
             self.minLen = exact
 
-        self.errmsg = "Expected " + self.name
+        self.errmsg = f"Expected {self.name}"
         self.mayIndexError = False
         self.asKeyword = asKeyword
         if self.asKeyword:
@@ -2929,10 +2887,11 @@ class Word(Token):
         def charsAsStr(s):
             max_repr_len = 16
             s = _collapse_string_to_ranges(s, re_escape=False)
+
             if len(s) > max_repr_len:
                 return s[: max_repr_len - 3] + "..."
-            else:
-                return s
+
+            return s
 
         if self.initChars != self.bodyChars:
             base = f"W:({charsAsStr(self.initChars)}, {charsAsStr(self.bodyChars)})"
@@ -2970,14 +2929,11 @@ class Word(Token):
             throwException = True
         elif self.maxSpecified and loc < instrlen and instring[loc] in bodychars:
             throwException = True
-        elif self.asKeyword:
-            if (
-                start > 0
-                and instring[start - 1] in bodychars
-                or loc < instrlen
-                and instring[loc] in bodychars
-            ):
-                throwException = True
+        elif self.asKeyword and (
+            (start > 0 and instring[start - 1] in bodychars)
+            or (loc < instrlen and instring[loc] in bodychars)
+        ):
+            throwException = True
 
         if throwException:
             raise ParseException(instring, loc, self.errmsg, self)
@@ -3077,7 +3033,7 @@ class Regex(Token):
                 "Regex may only be constructed with a string or a compiled RE object"
             )
 
-        self.errmsg = "Expected " + self.name
+        self.errmsg = f"Expected {self.name}"
         self.mayIndexError = False
         self.asGroupList = asGroupList
         self.asMatch = asMatch
@@ -3090,11 +3046,11 @@ class Regex(Token):
     def re(self):
         if self._re:
             return self._re
-        else:
-            try:
-                return re.compile(self.pattern, self.flags)
-            except re.error:
-                raise ValueError(f"invalid pattern ({self.pattern!r}) passed to Regex")
+
+        try:
+            return re.compile(self.pattern, self.flags)
+        except re.error:
+            raise ValueError(f"invalid pattern ({self.pattern!r}) passed to Regex")
 
     @cached_property
     def re_match(self):
@@ -3115,9 +3071,10 @@ class Regex(Token):
         loc = result.end()
         ret = ParseResults(result.group())
         d = result.groupdict()
-        if d:
-            for k, v in d.items():
-                ret[k] = v
+
+        for k, v in d.items():
+            ret[k] = v
+
         return loc, ret
 
     def parseImplAsGroupList(self, instring, loc, doActions=True):
@@ -3209,6 +3166,7 @@ class QuotedString(Token):
         [['This is the "quote"']]
         [['This is the quote with "embedded" quotes']]
     """
+
     ws_map = dict(((r"\t", "\t"), (r"\n", "\n"), (r"\f", "\f"), (r"\r", "\r")))
 
     def __init__(
@@ -3328,7 +3286,7 @@ class QuotedString(Token):
         except re.error:
             raise ValueError(f"invalid pattern {self.pattern!r} passed to Regex")
 
-        self.errmsg = "Expected " + self.name
+        self.errmsg = f"Expected {self.name}"
         self.mayIndexError = False
         self.mayReturnEmpty = True
 
@@ -3428,8 +3386,8 @@ class CharsNotIn(Token):
 
         if min < 1:
             raise ValueError(
-                "cannot specify a minimum length < 1; use "
-                "Opt(CharsNotIn()) if zero-length char group is permitted"
+                "cannot specify a minimum length < 1; use"
+                " Opt(CharsNotIn()) if zero-length char group is permitted"
             )
 
         self.minLen = min
@@ -3443,7 +3401,7 @@ class CharsNotIn(Token):
             self.maxLen = exact
             self.minLen = exact
 
-        self.errmsg = "Expected " + self.name
+        self.errmsg = f"Expected {self.name}"
         self.mayReturnEmpty = self.minLen == 0
         self.mayIndexError = False
 
@@ -3516,7 +3474,7 @@ class White(Token):
         )
         # self.leave_whitespace()
         self.mayReturnEmpty = True
-        self.errmsg = "Expected " + self.name
+        self.errmsg = f"Expected {self.name}"
 
         self.minLen = min
 
@@ -3565,16 +3523,19 @@ class GoToColumn(PositionToken):
         self.col = colno
 
     def preParse(self, instring: str, loc: int) -> int:
-        if col(loc, instring) != self.col:
-            instrlen = len(instring)
-            if self.ignoreExprs:
-                loc = self._skipIgnorables(instring, loc)
-            while (
-                loc < instrlen
-                and instring[loc].isspace()
-                and col(loc, instring) != self.col
-            ):
-                loc += 1
+        if col(loc, instring) == self.col:
+            return loc
+
+        instrlen = len(instring)
+        if self.ignoreExprs:
+            loc = self._skipIgnorables(instring, loc)
+        while (
+            loc < instrlen
+            and instring[loc].isspace()
+            and col(loc, instring) != self.col
+        ):
+            loc += 1
+
         return loc
 
     def parseImpl(self, instring, loc, doActions=True):
@@ -3620,12 +3581,14 @@ class LineStart(PositionToken):
     def preParse(self, instring: str, loc: int) -> int:
         if loc == 0:
             return loc
-        else:
-            ret = self.skipper.preParse(instring, loc)
-            if "\n" in self.orig_whiteChars:
-                while instring[ret : ret + 1] == "\n":
-                    ret = self.skipper.preParse(instring, ret + 1)
-            return ret
+
+        ret = self.skipper.preParse(instring, loc)
+
+        if "\n" in self.orig_whiteChars:
+            while instring[ret : ret + 1] == "\n":
+                ret = self.skipper.preParse(instring, ret + 1)
+
+        return ret
 
     def parseImpl(self, instring, loc, doActions=True):
         if col(loc, instring) == 1:
@@ -3666,10 +3629,10 @@ class StringStart(PositionToken):
         self.errmsg = "Expected start of text"
 
     def parseImpl(self, instring, loc, doActions=True):
-        if loc != 0:
-            # see if entire string up to here is just whitespace and ignoreables
-            if loc != self.preParse(instring, 0):
-                raise ParseException(instring, loc, self.errmsg, self)
+        # see if entire string up to here is just whitespace and ignoreables
+        if loc != 0 and loc != self.preParse(instring, 0):
+            raise ParseException(instring, loc, self.errmsg, self)
+
         return loc, []
 
 
@@ -3685,12 +3648,12 @@ class StringEnd(PositionToken):
     def parseImpl(self, instring, loc, doActions=True):
         if loc < len(instring):
             raise ParseException(instring, loc, self.errmsg, self)
-        elif loc == len(instring):
+        if loc == len(instring):
             return loc + 1, []
-        elif loc > len(instring):
+        if loc > len(instring):
             return loc, []
-        else:
-            raise ParseException(instring, loc, self.errmsg, self)
+
+        raise ParseException(instring, loc, self.errmsg, self)
 
 
 class WordStart(PositionToken):
@@ -3823,7 +3786,7 @@ class ParseExpression(ParserElement):
         return self
 
     def _generateDefaultName(self) -> str:
-        return f"{self.__class__.__name__}:({str(self.exprs)})"
+        return f"{type(self).__name__}:({self.exprs})"
 
     def streamline(self) -> ParserElement:
         if self.streamlined:
@@ -3862,7 +3825,7 @@ class ParseExpression(ParserElement):
                 self.mayReturnEmpty |= other.mayReturnEmpty
                 self.mayIndexError |= other.mayIndexError
 
-        self.errmsg = "Expected " + str(self)
+        self.errmsg = f"Expected {self}"
 
         return self
 
@@ -3884,38 +3847,36 @@ class ParseExpression(ParserElement):
         return ret
 
     def _setResultsName(self, name, listAllMatches=False):
-        if (
+        if not (
             __diag__.warn_ungrouped_named_tokens_in_collection
             and Diagnostics.warn_ungrouped_named_tokens_in_collection
             not in self.suppress_warnings_
         ):
-            for e in self.exprs:
-                if (
-                    isinstance(e, ParserElement)
-                    and e.resultsName
-                    and Diagnostics.warn_ungrouped_named_tokens_in_collection
+            return super()._setResultsName(name, listAllMatches)
+
+        for e in self.exprs:
+            if (
+                isinstance(e, ParserElement)
+                and e.resultsName
+                and (
+                    Diagnostics.warn_ungrouped_named_tokens_in_collection
                     not in e.suppress_warnings_
-                ):
-                    warnings.warn(
-                        "{}: setting results name {!r} on {} expression "
-                        "collides with {!r} on contained expression".format(
-                            "warn_ungrouped_named_tokens_in_collection",
-                            name,
-                            type(self).__name__,
-                            e.resultsName,
-                        ),
-                        stacklevel=3,
-                    )
+                )
+            ):
+                warning = (
+                    "warn_ungrouped_named_tokens_in_collection:"
+                    f" setting results name {name!r} on {type(self).__name__} expression"
+                    f" collides with {e.resultsName!r} on contained expression"
+                )
+                warnings.warn(warning, stacklevel=3)
+                break
 
         return super()._setResultsName(name, listAllMatches)
 
     # Compatibility synonyms
     # fmt: off
-    @replaced_by_pep8(leave_whitespace)
-    def leaveWhitespace(self): ...
-
-    @replaced_by_pep8(ignore_whitespace)
-    def ignoreWhitespace(self): ...
+    leaveWhitespace = replaced_by_pep8("leaveWhitespace", leave_whitespace)
+    ignoreWhitespace = replaced_by_pep8("ignoreWhitespace", ignore_whitespace)
     # fmt: on
 
 
@@ -3952,18 +3913,18 @@ class And(ParseExpression):
         if exprs and Ellipsis in exprs:
             tmp = []
             for i, expr in enumerate(exprs):
-                if expr is Ellipsis:
-                    if i < len(exprs) - 1:
-                        skipto_arg: ParserElement = typing.cast(
-                            ParseExpression, (Empty() + exprs[i + 1])
-                        ).exprs[-1]
-                        tmp.append(SkipTo(skipto_arg)("_skipped*"))
-                    else:
-                        raise Exception(
-                            "cannot construct And with sequence ending in ..."
-                        )
-                else:
+                if expr is not Ellipsis:
                     tmp.append(expr)
+                    continue
+
+                if i < len(exprs) - 1:
+                    skipto_arg: ParserElement = typing.cast(
+                        ParseExpression, (Empty() + exprs[i + 1])
+                    ).exprs[-1]
+                    tmp.append(SkipTo(skipto_arg)("_skipped*"))
+                    continue
+
+                raise Exception("cannot construct And with sequence ending in ...")
             exprs[:] = tmp
         super().__init__(exprs, savelist)
         if self.exprs:
@@ -3982,25 +3943,24 @@ class And(ParseExpression):
 
     def streamline(self) -> ParserElement:
         # collapse any _PendingSkip's
-        if self.exprs:
-            if any(
-                isinstance(e, ParseExpression)
-                and e.exprs
-                and isinstance(e.exprs[-1], _PendingSkip)
-                for e in self.exprs[:-1]
-            ):
-                deleted_expr_marker = NoMatch()
-                for i, e in enumerate(self.exprs[:-1]):
-                    if e is deleted_expr_marker:
-                        continue
-                    if (
-                        isinstance(e, ParseExpression)
-                        and e.exprs
-                        and isinstance(e.exprs[-1], _PendingSkip)
-                    ):
-                        e.exprs[-1] = e.exprs[-1] + self.exprs[i + 1]
-                        self.exprs[i + 1] = deleted_expr_marker
-                self.exprs = [e for e in self.exprs if e is not deleted_expr_marker]
+        if self.exprs and any(
+            isinstance(e, ParseExpression)
+            and e.exprs
+            and isinstance(e.exprs[-1], _PendingSkip)
+            for e in self.exprs[:-1]
+        ):
+            deleted_expr_marker = NoMatch()
+            for i, e in enumerate(self.exprs[:-1]):
+                if e is deleted_expr_marker:
+                    continue
+                if (
+                    isinstance(e, ParseExpression)
+                    and e.exprs
+                    and isinstance(e.exprs[-1], _PendingSkip)
+                ):
+                    e.exprs[-1] = e.exprs[-1] + self.exprs[i + 1]
+                    self.exprs[i + 1] = deleted_expr_marker
+            self.exprs = [e for e in self.exprs if e is not deleted_expr_marker]
 
         super().streamline()
 
@@ -4079,7 +4039,7 @@ class And(ParseExpression):
         # strip off redundant inner {}'s
         while len(inner) > 1 and inner[0 :: len(inner) - 1] == "{}":
             inner = inner[1:-1]
-        return "{" + inner + "}"
+        return f"{{{inner}}}"
 
 
 class Or(ParseExpression):
@@ -4200,10 +4160,8 @@ class Or(ParseExpression):
             if maxExcLoc == loc:
                 maxException.msg = self.errmsg
             raise maxException
-        else:
-            raise ParseException(
-                instring, loc, "no defined alternatives to match", self
-            )
+
+        raise ParseException(instring, loc, "no defined alternatives to match", self)
 
     def __ixor__(self, other):
         if isinstance(other, str_type):
@@ -4213,7 +4171,7 @@ class Or(ParseExpression):
         return self.append(other)  # Or([self, other])
 
     def _generateDefaultName(self) -> str:
-        return "{" + " ^ ".join(str(e) for e in self.exprs) + "}"
+        return f"{{{' ^ '.join(str(e) for e in self.exprs)}}}"
 
     def _setResultsName(self, name, listAllMatches=False):
         if (
@@ -4227,17 +4185,14 @@ class Or(ParseExpression):
                 not in e.suppress_warnings_
                 for e in self.exprs
             ):
-                warnings.warn(
-                    "{}: setting results name {!r} on {} expression "
-                    "will return a list of all parsed tokens in an And alternative, "
-                    "in prior versions only the first token was returned; enclose "
-                    "contained argument in Group".format(
-                        "warn_multiple_tokens_in_named_alternation",
-                        name,
-                        type(self).__name__,
-                    ),
-                    stacklevel=3,
+                warning = (
+                    "warn_multiple_tokens_in_named_alternation:"
+                    f" setting results name {name!r} on {type(self).__name__} expression"
+                    " will return a list of all parsed tokens in an And alternative,"
+                    " in prior versions only the first token was returned; enclose"
+                    " contained argument in Group"
                 )
+                warnings.warn(warning, stacklevel=3)
 
         return super()._setResultsName(name, listAllMatches)
 
@@ -4290,11 +4245,7 @@ class MatchFirst(ParseExpression):
 
         for e in self.exprs:
             try:
-                return e._parse(
-                    instring,
-                    loc,
-                    doActions,
-                )
+                return e._parse(instring, loc, doActions)
             except ParseFatalException as pfe:
                 pfe.__traceback__ = None
                 pfe.parser_element = e
@@ -4316,10 +4267,8 @@ class MatchFirst(ParseExpression):
             if maxExcLoc == loc:
                 maxException.msg = self.errmsg
             raise maxException
-        else:
-            raise ParseException(
-                instring, loc, "no defined alternatives to match", self
-            )
+
+        raise ParseException(instring, loc, "no defined alternatives to match", self)
 
     def __ior__(self, other):
         if isinstance(other, str_type):
@@ -4329,7 +4278,7 @@ class MatchFirst(ParseExpression):
         return self.append(other)  # MatchFirst([self, other])
 
     def _generateDefaultName(self) -> str:
-        return "{" + " | ".join(str(e) for e in self.exprs) + "}"
+        return f"{{{' | '.join(str(e) for e in self.exprs)}}}"
 
     def _setResultsName(self, name, listAllMatches=False):
         if (
@@ -4343,17 +4292,14 @@ class MatchFirst(ParseExpression):
                 not in e.suppress_warnings_
                 for e in self.exprs
             ):
-                warnings.warn(
-                    "{}: setting results name {!r} on {} expression "
-                    "will return a list of all parsed tokens in an And alternative, "
-                    "in prior versions only the first token was returned; enclose "
-                    "contained argument in Group".format(
-                        "warn_multiple_tokens_in_named_alternation",
-                        name,
-                        type(self).__name__,
-                    ),
-                    stacklevel=3,
+                warning = (
+                    "warn_multiple_tokens_in_named_alternation:"
+                    f" setting results name {name!r} on {type(self).__name__} expression"
+                    " will return a list of all parsed tokens in an And alternative,"
+                    " in prior versions only the first token was returned; enclose"
+                    " contained argument in Group"
                 )
+                warnings.warn(warning, stacklevel=3)
 
         return super()._setResultsName(name, listAllMatches)
 
@@ -4529,7 +4475,7 @@ class Each(ParseExpression):
         return loc, total_results
 
     def _generateDefaultName(self) -> str:
-        return "{" + " & ".join(str(e) for e in self.exprs) + "}"
+        return f"{{{' & '.join(str(e) for e in self.exprs)}}}"
 
 
 class ParseElementEnhance(ParserElement):
@@ -4564,16 +4510,17 @@ class ParseElementEnhance(ParserElement):
         return [self.expr] if self.expr is not None else []
 
     def parseImpl(self, instring, loc, doActions=True):
-        if self.expr is not None:
-            try:
-                return self.expr._parse(instring, loc, doActions, callPreParse=False)
-            except ParseBaseException as pbe:
-                if not isinstance(self, Forward) or self.customName is not None:
-                    pbe.msg = self.errmsg
-                raise
-        else:
+        if self.expr is None:
             raise ParseException(instring, loc, "No expression defined", self)
 
+        try:
+            return self.expr._parse(instring, loc, doActions, callPreParse=False)
+        except ParseBaseException as pbe:
+            if not isinstance(self, Forward) or self.customName is not None:
+                if self.errmsg:
+                    pbe.msg = self.errmsg
+            raise
+
     def leave_whitespace(self, recursive: bool = True) -> ParserElement:
         super().leave_whitespace(recursive)
 
@@ -4593,15 +4540,11 @@ class ParseElementEnhance(ParserElement):
         return self
 
     def ignore(self, other) -> ParserElement:
-        if isinstance(other, Suppress):
-            if other not in self.ignoreExprs:
-                super().ignore(other)
-                if self.expr is not None:
-                    self.expr.ignore(self.ignoreExprs[-1])
-        else:
+        if not isinstance(other, Suppress) or other not in self.ignoreExprs:
             super().ignore(other)
             if self.expr is not None:
                 self.expr.ignore(self.ignoreExprs[-1])
+
         return self
 
     def streamline(self) -> ParserElement:
@@ -4631,15 +4574,12 @@ class ParseElementEnhance(ParserElement):
         self._checkRecursion([])
 
     def _generateDefaultName(self) -> str:
-        return f"{self.__class__.__name__}:({str(self.expr)})"
+        return f"{type(self).__name__}:({self.expr})"
 
     # Compatibility synonyms
     # fmt: off
-    @replaced_by_pep8(leave_whitespace)
-    def leaveWhitespace(self): ...
-
-    @replaced_by_pep8(ignore_whitespace)
-    def ignoreWhitespace(self): ...
+    leaveWhitespace = replaced_by_pep8("leaveWhitespace", leave_whitespace)
+    ignoreWhitespace = replaced_by_pep8("ignoreWhitespace", ignore_whitespace)
     # fmt: on
 
 
@@ -4849,7 +4789,7 @@ class PrecededBy(ParseElementEnhance):
             retreat = 0
             self.exact = True
         self.retreat = retreat
-        self.errmsg = "not preceded by " + str(expr)
+        self.errmsg = f"not preceded by {expr}"
         self.skipWhitespace = False
         self.parseAction.append(lambda s, l, t: t.__delitem__(slice(None, None)))
 
@@ -4859,23 +4799,24 @@ class PrecededBy(ParseElementEnhance):
                 raise ParseException(instring, loc, self.errmsg)
             start = loc - self.retreat
             _, ret = self.expr._parse(instring, start)
-        else:
-            # retreat specified a maximum lookbehind window, iterate
-            test_expr = self.expr + StringEnd()
-            instring_slice = instring[max(0, loc - self.retreat) : loc]
-            last_expr = ParseException(instring, loc, self.errmsg)
-            for offset in range(1, min(loc, self.retreat + 1) + 1):
-                try:
-                    # print('trying', offset, instring_slice, repr(instring_slice[loc - offset:]))
-                    _, ret = test_expr._parse(
-                        instring_slice, len(instring_slice) - offset
-                    )
-                except ParseBaseException as pbe:
-                    last_expr = pbe
-                else:
-                    break
+            return loc, ret
+
+        # retreat specified a maximum lookbehind window, iterate
+        test_expr = self.expr + StringEnd()
+        instring_slice = instring[max(0, loc - self.retreat) : loc]
+        last_expr = ParseException(instring, loc, self.errmsg)
+
+        for offset in range(1, min(loc, self.retreat + 1) + 1):
+            try:
+                # print('trying', offset, instring_slice, repr(instring_slice[loc - offset:]))
+                _, ret = test_expr._parse(instring_slice, len(instring_slice) - offset)
+            except ParseBaseException as pbe:
+                last_expr = pbe
             else:
-                raise last_expr
+                break
+        else:
+            raise last_expr
+
         return loc, ret
 
 
@@ -4953,7 +4894,7 @@ class NotAny(ParseElementEnhance):
         self.skipWhitespace = False
 
         self.mayReturnEmpty = True
-        self.errmsg = "Found unwanted token, " + str(self.expr)
+        self.errmsg = f"Found unwanted token, {self.expr}"
 
     def parseImpl(self, instring, loc, doActions=True):
         if self.expr.can_parse_next(instring, loc, do_actions=doActions):
@@ -4961,7 +4902,7 @@ class NotAny(ParseElementEnhance):
         return loc, []
 
     def _generateDefaultName(self) -> str:
-        return "~{" + str(self.expr) + "}"
+        return f"~{{{self.expr}}}"
 
 
 class _MultipleMatch(ParseElementEnhance):
@@ -5024,19 +4965,18 @@ class _MultipleMatch(ParseElementEnhance):
                 if (
                     isinstance(e, ParserElement)
                     and e.resultsName
-                    and Diagnostics.warn_ungrouped_named_tokens_in_collection
-                    not in e.suppress_warnings_
-                ):
-                    warnings.warn(
-                        "{}: setting results name {!r} on {} expression "
-                        "collides with {!r} on contained expression".format(
-                            "warn_ungrouped_named_tokens_in_collection",
-                            name,
-                            type(self).__name__,
-                            e.resultsName,
-                        ),
-                        stacklevel=3,
+                    and (
+                        Diagnostics.warn_ungrouped_named_tokens_in_collection
+                        not in e.suppress_warnings_
                     )
+                ):
+                    warning = (
+                        "warn_ungrouped_named_tokens_in_collection:"
+                        f" setting results name {name!r} on {type(self).__name__} expression"
+                        f" collides with {e.resultsName!r} on contained expression"
+                    )
+                    warnings.warn(warning, stacklevel=3)
+                    break
 
         return super()._setResultsName(name, listAllMatches)
 
@@ -5070,7 +5010,7 @@ class OneOrMore(_MultipleMatch):
     """
 
     def _generateDefaultName(self) -> str:
-        return "{" + str(self.expr) + "}..."
+        return f"{{{self.expr}}}..."
 
 
 class ZeroOrMore(_MultipleMatch):
@@ -5104,7 +5044,7 @@ class ZeroOrMore(_MultipleMatch):
             return loc, ParseResults([], name=self.resultsName)
 
     def _generateDefaultName(self) -> str:
-        return "[" + str(self.expr) + "]..."
+        return f"[{self.expr}]..."
 
 
 class DelimitedList(ParseElementEnhance):
@@ -5139,12 +5079,11 @@ class DelimitedList(ParseElementEnhance):
             expr = ParserElement._literalStringClass(expr)
         expr = typing.cast(ParserElement, expr)
 
-        if min is not None:
-            if min < 1:
-                raise ValueError("min must be greater than 0")
-        if max is not None:
-            if min is not None and max < min:
-                raise ValueError("max must be greater than, or equal to min")
+        if min is not None and min < 1:
+            raise ValueError("min must be greater than 0")
+
+        if max is not None and min is not None and max < min:
+            raise ValueError("max must be greater than, or equal to min")
 
         self.content = expr
         self.raw_delim = str(delim)
@@ -5169,7 +5108,8 @@ class DelimitedList(ParseElementEnhance):
         super().__init__(delim_list_expr, savelist=True)
 
     def _generateDefaultName(self) -> str:
-        return "{0} [{1} {0}]...".format(self.content.streamline(), self.raw_delim)
+        content_expr = self.content.streamline()
+        return f"{content_expr} [{self.raw_delim} {content_expr}]..."
 
 
 class _NullToken:
@@ -5251,7 +5191,7 @@ class Opt(ParseElementEnhance):
         # strip off redundant inner {}'s
         while len(inner) > 1 and inner[0 :: len(inner) - 1] == "{}":
             inner = inner[1:-1]
-        return "[" + inner + "]"
+        return f"[{inner}]"
 
 
 Optional = Opt
@@ -5586,14 +5526,13 @@ class Forward(ParseElementEnhance):
                         del memo[peek_key]
                         return prev_loc, prev_peek.copy()
                     # the match did get better: see if we can improve further
-                    else:
-                        if doActions:
-                            try:
-                                memo[act_key] = super().parseImpl(instring, loc, True)
-                            except ParseException as e:
-                                memo[peek_key] = memo[act_key] = (new_loc, e)
-                                raise
-                        prev_loc, prev_peek = memo[peek_key] = new_loc, new_peek
+                    if doActions:
+                        try:
+                            memo[act_key] = super().parseImpl(instring, loc, True)
+                        except ParseException as e:
+                            memo[peek_key] = memo[act_key] = (new_loc, e)
+                            raise
+                    prev_loc, prev_peek = memo[peek_key] = new_loc, new_peek
 
     def leave_whitespace(self, recursive: bool = True) -> ParserElement:
         self.skipWhitespace = False
@@ -5637,7 +5576,7 @@ class Forward(ParseElementEnhance):
             else:
                 retString = "None"
         finally:
-            return self.__class__.__name__ + ": " + retString
+            return f"{type(self).__name__}: {retString}"
 
     def copy(self) -> ParserElement:
         if self.expr is not None:
@@ -5648,29 +5587,26 @@ class Forward(ParseElementEnhance):
             return ret
 
     def _setResultsName(self, name, list_all_matches=False):
+        # fmt: off
         if (
             __diag__.warn_name_set_on_empty_Forward
-            and Diagnostics.warn_name_set_on_empty_Forward
-            not in self.suppress_warnings_
+            and Diagnostics.warn_name_set_on_empty_Forward not in self.suppress_warnings_
+            and self.expr is None
         ):
-            if self.expr is None:
-                warnings.warn(
-                    "{}: setting results name {!r} on {} expression "
-                    "that has no contained expression".format(
-                        "warn_name_set_on_empty_Forward", name, type(self).__name__
-                    ),
-                    stacklevel=3,
-                )
+            warning = (
+                "warn_name_set_on_empty_Forward:"
+                f" setting results name {name!r} on {type(self).__name__} expression"
+                " that has no contained expression"
+            )
+            warnings.warn(warning, stacklevel=3)
+        # fmt: on
 
         return super()._setResultsName(name, list_all_matches)
 
     # Compatibility synonyms
     # fmt: off
-    @replaced_by_pep8(leave_whitespace)
-    def leaveWhitespace(self): ...
-
-    @replaced_by_pep8(ignore_whitespace)
-    def ignoreWhitespace(self): ...
+    leaveWhitespace = replaced_by_pep8("leaveWhitespace", leave_whitespace)
+    ignoreWhitespace = replaced_by_pep8("ignoreWhitespace", ignore_whitespace)
     # fmt: on
 
 
@@ -5774,8 +5710,8 @@ class Group(TokenConverter):
                 if isinstance(tokenlist, ParseResults)
                 else list(tokenlist)
             )
-        else:
-            return [tokenlist]
+
+        return [tokenlist]
 
 
 class Dict(TokenConverter):
@@ -5861,8 +5797,8 @@ class Dict(TokenConverter):
 
         if self._asPythonDict:
             return [tokenlist.as_dict()] if self.resultsName else tokenlist.as_dict()
-        else:
-            return [tokenlist] if self.resultsName else tokenlist
+
+        return [tokenlist] if self.resultsName else tokenlist
 
 
 class Suppress(TokenConverter):
@@ -5904,14 +5840,14 @@ class Suppress(TokenConverter):
     def __add__(self, other) -> "ParserElement":
         if isinstance(self.expr, _PendingSkip):
             return Suppress(SkipTo(other)) + other
-        else:
-            return super().__add__(other)
+
+        return super().__add__(other)
 
     def __sub__(self, other) -> "ParserElement":
         if isinstance(self.expr, _PendingSkip):
             return Suppress(SkipTo(other)) - other
-        else:
-            return super().__sub__(other)
+
+        return super().__sub__(other)
 
     def postParse(self, instring, loc, tokenlist):
         return []
@@ -5951,7 +5887,7 @@ def trace_parse_action(f: ParseAction) -> ParseAction:
         thisFunc = f.__name__
         s, l, t = paArgs[-3:]
         if len(paArgs) > 3:
-            thisFunc = paArgs[0].__class__.__name__ + "." + thisFunc
+            thisFunc = f"{type(paArgs[0]).__name__}.{thisFunc}"
         sys.stderr.write(f">>entering {thisFunc}(line: {line(l, s)!r}, {l}, {t!r})\n")
         try:
             ret = f(*paArgs)
@@ -6019,8 +5955,8 @@ def srange(s: str) -> str:
     - any combination of the above (``'aeiouy'``,
       ``'a-zA-Z0-9_$'``, etc.)
     """
-    _expanded = (
-        lambda p: p
+    _expanded = lambda p: (
+        p
         if not isinstance(p, ParseResults)
         else "".join(chr(c) for c in range(ord(p[0]), ord(p[1]) + 1))
     )
@@ -6144,16 +6080,8 @@ lineStart = line_start
 lineEnd = line_end
 stringStart = string_start
 stringEnd = string_end
-
-@replaced_by_pep8(null_debug_action)
-def nullDebugAction(): ...
-
-@replaced_by_pep8(trace_parse_action)
-def traceParseAction(): ...
-
-@replaced_by_pep8(condition_as_parse_action)
-def conditionAsParseAction(): ...
-
-@replaced_by_pep8(token_map)
-def tokenMap(): ...
+nullDebugAction = replaced_by_pep8("nullDebugAction", null_debug_action)
+traceParseAction = replaced_by_pep8("traceParseAction", trace_parse_action)
+conditionAsParseAction = replaced_by_pep8("conditionAsParseAction", condition_as_parse_action)
+tokenMap = replaced_by_pep8("tokenMap", token_map)
 # fmt: on
diff --git a/lib/pyparsing/diagram/__init__.py b/lib/pyparsing/diagram/__init__.py
index 267f3447..700d0b56 100644
--- a/lib/pyparsing/diagram/__init__.py
+++ b/lib/pyparsing/diagram/__init__.py
@@ -473,7 +473,7 @@ def _to_diagram_element(
     :param show_groups: bool flag indicating whether to show groups using bounding box
     """
     exprs = element.recurse()
-    name = name_hint or element.customName or element.__class__.__name__
+    name = name_hint or element.customName or type(element).__name__
 
     # Python's id() is used to provide a unique identifier for elements
     el_id = id(element)
diff --git a/lib/pyparsing/exceptions.py b/lib/pyparsing/exceptions.py
index 12219f12..1aaea56f 100644
--- a/lib/pyparsing/exceptions.py
+++ b/lib/pyparsing/exceptions.py
@@ -14,11 +14,13 @@ from .util import (
 from .unicode import pyparsing_unicode as ppu
 
 
-class ExceptionWordUnicode(ppu.Latin1, ppu.LatinA, ppu.LatinB, ppu.Greek, ppu.Cyrillic):
+class _ExceptionWordUnicodeSet(
+    ppu.Latin1, ppu.LatinA, ppu.LatinB, ppu.Greek, ppu.Cyrillic
+):
     pass
 
 
-_extract_alphanums = _collapse_string_to_ranges(ExceptionWordUnicode.alphanums)
+_extract_alphanums = _collapse_string_to_ranges(_ExceptionWordUnicodeSet.alphanums)
 _exception_word_extractor = re.compile("([" + _extract_alphanums + "]{1,16})|.")
 
 
@@ -86,41 +88,39 @@ class ParseBaseException(Exception):
             ret.append(" " * (exc.column - 1) + "^")
         ret.append(f"{type(exc).__name__}: {exc}")
 
-        if depth > 0:
-            callers = inspect.getinnerframes(exc.__traceback__, context=depth)
-            seen = set()
-            for i, ff in enumerate(callers[-depth:]):
-                frm = ff[0]
+        if depth <= 0:
+            return "\n".join(ret)
 
-                f_self = frm.f_locals.get("self", None)
-                if isinstance(f_self, ParserElement):
-                    if not frm.f_code.co_name.startswith(
-                        ("parseImpl", "_parseNoCache")
-                    ):
-                        continue
-                    if id(f_self) in seen:
-                        continue
-                    seen.add(id(f_self))
+        callers = inspect.getinnerframes(exc.__traceback__, context=depth)
+        seen = set()
+        for ff in callers[-depth:]:
+            frm = ff[0]
 
-                    self_type = type(f_self)
-                    ret.append(
-                        f"{self_type.__module__}.{self_type.__name__} - {f_self}"
-                    )
+            f_self = frm.f_locals.get("self", None)
+            if isinstance(f_self, ParserElement):
+                if not frm.f_code.co_name.startswith(("parseImpl", "_parseNoCache")):
+                    continue
+                if id(f_self) in seen:
+                    continue
+                seen.add(id(f_self))
 
-                elif f_self is not None:
-                    self_type = type(f_self)
-                    ret.append(f"{self_type.__module__}.{self_type.__name__}")
+                self_type = type(f_self)
+                ret.append(f"{self_type.__module__}.{self_type.__name__} - {f_self}")
 
-                else:
-                    code = frm.f_code
-                    if code.co_name in ("wrapper", "<module>"):
-                        continue
+            elif f_self is not None:
+                self_type = type(f_self)
+                ret.append(f"{self_type.__module__}.{self_type.__name__}")
 
-                    ret.append(code.co_name)
+            else:
+                code = frm.f_code
+                if code.co_name in ("wrapper", "<module>"):
+                    continue
 
-                depth -= 1
-                if not depth:
-                    break
+                ret.append(code.co_name)
+
+            depth -= 1
+            if not depth:
+                break
 
         return "\n".join(ret)
 
@@ -220,8 +220,10 @@ class ParseBaseException(Exception):
 
         Example::
 
+            # an expression to parse 3 integers
             expr = pp.Word(pp.nums) * 3
             try:
+                # a failing parse - the third integer is prefixed with "A"
                 expr.parse_string("123 456 A789")
             except pp.ParseException as pe:
                 print(pe.explain(depth=0))
@@ -244,8 +246,7 @@ class ParseBaseException(Exception):
         return self.explain_exception(self, depth)
 
     # fmt: off
-    @replaced_by_pep8(mark_input_line)
-    def markInputline(self): ...
+    markInputline = replaced_by_pep8("markInputline", mark_input_line)
     # fmt: on
 
 
@@ -255,16 +256,16 @@ class ParseException(ParseBaseException):
 
     Example::
 
+        integer = Word(nums).set_name("integer")
         try:
-            Word(nums).set_name("integer").parse_string("ABC")
+            integer.parse_string("ABC")
         except ParseException as pe:
             print(pe)
-            print("column: {}".format(pe.column))
+            print(f"column: {pe.column}")
 
     prints::
 
-       Expected integer (at char 0), (line:1, col:1)
-        column: 1
+       Expected integer (at char 0), (line:1, col:1) column: 1
 
     """
 
diff --git a/lib/pyparsing/helpers.py b/lib/pyparsing/helpers.py
index 018f0d6a..dcfdb8fe 100644
--- a/lib/pyparsing/helpers.py
+++ b/lib/pyparsing/helpers.py
@@ -74,7 +74,7 @@ def counted_array(
         intExpr = intExpr.copy()
     intExpr.set_name("arrayLen")
     intExpr.add_parse_action(count_field_parse_action, call_during_try=True)
-    return (intExpr + array_expr).set_name("(len) " + str(expr) + "...")
+    return (intExpr + array_expr).set_name(f"(len) {expr}...")
 
 
 def match_previous_literal(expr: ParserElement) -> ParserElement:
@@ -95,15 +95,17 @@ def match_previous_literal(expr: ParserElement) -> ParserElement:
     rep = Forward()
 
     def copy_token_to_repeater(s, l, t):
-        if t:
-            if len(t) == 1:
-                rep << t[0]
-            else:
-                # flatten t tokens
-                tflat = _flatten(t.as_list())
-                rep << And(Literal(tt) for tt in tflat)
-        else:
+        if not t:
             rep << Empty()
+            return
+
+        if len(t) == 1:
+            rep << t[0]
+            return
+
+        # flatten t tokens
+        tflat = _flatten(t.as_list())
+        rep << And(Literal(tt) for tt in tflat)
 
     expr.add_parse_action(copy_token_to_repeater, callDuringTry=True)
     rep.set_name("(prev) " + str(expr))
@@ -230,7 +232,7 @@ def one_of(
                 if isequal(other, cur):
                     del symbols[i + j + 1]
                     break
-                elif masks(cur, other):
+                if masks(cur, other):
                     del symbols[i + j + 1]
                     symbols.insert(i, other)
                     break
@@ -534,7 +536,9 @@ def nested_expr(
         )
     else:
         ret <<= Group(Suppress(opener) + ZeroOrMore(ret | content) + Suppress(closer))
-    ret.set_name("nested %s%s expression" % (opener, closer))
+    ret.set_name(f"nested {opener}{closer} expression")
+    # don't override error message from content expressions
+    ret.errmsg = None
     return ret
 
 
@@ -580,7 +584,7 @@ def _makeTags(tagStr, xml, suppress_LT=Suppress("<"), suppress_GT=Suppress(">"))
         )
     closeTag = Combine(Literal("</") + tagStr + ">", adjacent=False)
 
-    openTag.set_name("<%s>" % resname)
+    openTag.set_name(f"<{resname}>")
     # add start<tagname> results name in parse action now that ungrouped names are not reported at two levels
     openTag.add_parse_action(
         lambda t: t.__setitem__(
@@ -589,7 +593,7 @@ def _makeTags(tagStr, xml, suppress_LT=Suppress("<"), suppress_GT=Suppress(">"))
     )
     closeTag = closeTag(
         "end" + "".join(resname.replace(":", " ").title().split())
-    ).set_name("</%s>" % resname)
+    ).set_name(f"</{resname}>")
     openTag.tag = resname
     closeTag.tag = resname
     openTag.tag_body = SkipTo(closeTag())
@@ -777,7 +781,7 @@ def infix_notation(
         rpar = Suppress(rpar)
 
     # if lpar and rpar are not suppressed, wrap in group
-    if not (isinstance(rpar, Suppress) and isinstance(rpar, Suppress)):
+    if not (isinstance(lpar, Suppress) and isinstance(rpar, Suppress)):
         lastExpr = base_expr | Group(lpar + ret + rpar)
     else:
         lastExpr = base_expr | (lpar + ret + rpar)
@@ -787,7 +791,7 @@ def infix_notation(
     pa: typing.Optional[ParseAction]
     opExpr1: ParserElement
     opExpr2: ParserElement
-    for i, operDef in enumerate(op_list):
+    for operDef in op_list:
         opExpr, arity, rightLeftAssoc, pa = (operDef + (None,))[:4]  # type: ignore[assignment]
         if isinstance(opExpr, str_type):
             opExpr = ParserElement._literalStringClass(opExpr)
@@ -1058,43 +1062,17 @@ dblSlashComment = dbl_slash_comment
 cppStyleComment = cpp_style_comment
 javaStyleComment = java_style_comment
 pythonStyleComment = python_style_comment
-
-@replaced_by_pep8(DelimitedList)
-def delimitedList(): ...
-
-@replaced_by_pep8(DelimitedList)
-def delimited_list(): ...
-
-@replaced_by_pep8(counted_array)
-def countedArray(): ...
-
-@replaced_by_pep8(match_previous_literal)
-def matchPreviousLiteral(): ...
-
-@replaced_by_pep8(match_previous_expr)
-def matchPreviousExpr(): ...
-
-@replaced_by_pep8(one_of)
-def oneOf(): ...
-
-@replaced_by_pep8(dict_of)
-def dictOf(): ...
-
-@replaced_by_pep8(original_text_for)
-def originalTextFor(): ...
-
-@replaced_by_pep8(nested_expr)
-def nestedExpr(): ...
-
-@replaced_by_pep8(make_html_tags)
-def makeHTMLTags(): ...
-
-@replaced_by_pep8(make_xml_tags)
-def makeXMLTags(): ...
-
-@replaced_by_pep8(replace_html_entity)
-def replaceHTMLEntity(): ...
-
-@replaced_by_pep8(infix_notation)
-def infixNotation(): ...
+delimitedList = replaced_by_pep8("delimitedList", DelimitedList)
+delimited_list = replaced_by_pep8("delimited_list", DelimitedList)
+countedArray = replaced_by_pep8("countedArray", counted_array)
+matchPreviousLiteral = replaced_by_pep8("matchPreviousLiteral", match_previous_literal)
+matchPreviousExpr = replaced_by_pep8("matchPreviousExpr", match_previous_expr)
+oneOf = replaced_by_pep8("oneOf", one_of)
+dictOf = replaced_by_pep8("dictOf", dict_of)
+originalTextFor = replaced_by_pep8("originalTextFor", original_text_for)
+nestedExpr = replaced_by_pep8("nestedExpr", nested_expr)
+makeHTMLTags = replaced_by_pep8("makeHTMLTags", make_html_tags)
+makeXMLTags = replaced_by_pep8("makeXMLTags", make_xml_tags)
+replaceHTMLEntity = replaced_by_pep8("replaceHTMLEntity", replace_html_entity)
+infixNotation = replaced_by_pep8("infixNotation", infix_notation)
 # fmt: on
diff --git a/lib/pyparsing/results.py b/lib/pyparsing/results.py
index 03130497..3e5fe208 100644
--- a/lib/pyparsing/results.py
+++ b/lib/pyparsing/results.py
@@ -173,42 +173,48 @@ class ParseResults:
     ):
         self._tokdict: Dict[str, _ParseResultsWithOffset]
         self._modal = modal
-        if name is not None and name != "":
-            if isinstance(name, int):
-                name = str(name)
-            if not modal:
-                self._all_names = {name}
-            self._name = name
-            if toklist not in self._null_values:
-                if isinstance(toklist, (str_type, type)):
-                    toklist = [toklist]
-                if asList:
-                    if isinstance(toklist, ParseResults):
-                        self[name] = _ParseResultsWithOffset(
-                            ParseResults(toklist._toklist), 0
-                        )
-                    else:
-                        self[name] = _ParseResultsWithOffset(
-                            ParseResults(toklist[0]), 0
-                        )
-                    self[name]._name = name
-                else:
-                    try:
-                        self[name] = toklist[0]
-                    except (KeyError, TypeError, IndexError):
-                        if toklist is not self:
-                            self[name] = toklist
-                        else:
-                            self._name = name
+
+        if name is None or name == "":
+            return
+
+        if isinstance(name, int):
+            name = str(name)
+
+        if not modal:
+            self._all_names = {name}
+
+        self._name = name
+
+        if toklist in self._null_values:
+            return
+
+        if isinstance(toklist, (str_type, type)):
+            toklist = [toklist]
+
+        if asList:
+            if isinstance(toklist, ParseResults):
+                self[name] = _ParseResultsWithOffset(ParseResults(toklist._toklist), 0)
+            else:
+                self[name] = _ParseResultsWithOffset(ParseResults(toklist[0]), 0)
+            self[name]._name = name
+            return
+
+        try:
+            self[name] = toklist[0]
+        except (KeyError, TypeError, IndexError):
+            if toklist is not self:
+                self[name] = toklist
+            else:
+                self._name = name
 
     def __getitem__(self, i):
         if isinstance(i, (int, slice)):
             return self._toklist[i]
-        else:
-            if i not in self._all_names:
-                return self._tokdict[i][-1][0]
-            else:
-                return ParseResults([v[0] for v in self._tokdict[i]])
+
+        if i not in self._all_names:
+            return self._tokdict[i][-1][0]
+
+        return ParseResults([v[0] for v in self._tokdict[i]])
 
     def __setitem__(self, k, v, isinstance=isinstance):
         if isinstance(v, _ParseResultsWithOffset):
@@ -226,27 +232,28 @@ class ParseResults:
             sub._parent = self
 
     def __delitem__(self, i):
-        if isinstance(i, (int, slice)):
-            mylen = len(self._toklist)
-            del self._toklist[i]
-
-            # convert int to slice
-            if isinstance(i, int):
-                if i < 0:
-                    i += mylen
-                i = slice(i, i + 1)
-            # get removed indices
-            removed = list(range(*i.indices(mylen)))
-            removed.reverse()
-            # fixup indices in token dictionary
-            for name, occurrences in self._tokdict.items():
-                for j in removed:
-                    for k, (value, position) in enumerate(occurrences):
-                        occurrences[k] = _ParseResultsWithOffset(
-                            value, position - (position > j)
-                        )
-        else:
+        if not isinstance(i, (int, slice)):
             del self._tokdict[i]
+            return
+
+        mylen = len(self._toklist)
+        del self._toklist[i]
+
+        # convert int to slice
+        if isinstance(i, int):
+            if i < 0:
+                i += mylen
+            i = slice(i, i + 1)
+        # get removed indices
+        removed = list(range(*i.indices(mylen)))
+        removed.reverse()
+        # fixup indices in token dictionary
+        for occurrences in self._tokdict.values():
+            for j in removed:
+                for k, (value, position) in enumerate(occurrences):
+                    occurrences[k] = _ParseResultsWithOffset(
+                        value, position - (position > j)
+                    )
 
     def __contains__(self, k) -> bool:
         return k in self._tokdict
@@ -376,7 +383,7 @@ class ParseResults:
         """
         self._toklist.insert(index, ins_string)
         # fixup indices in token dictionary
-        for name, occurrences in self._tokdict.items():
+        for occurrences in self._tokdict.values():
             for k, (value, position) in enumerate(occurrences):
                 occurrences[k] = _ParseResultsWithOffset(
                     value, position + (position > index)
@@ -652,58 +659,52 @@ class ParseResults:
         NL = "\n"
         out.append(indent + str(self.as_list()) if include_list else "")
 
-        if full:
-            if self.haskeys():
-                items = sorted((str(k), v) for k, v in self.items())
-                for k, v in items:
-                    if out:
-                        out.append(NL)
-                    out.append(f"{indent}{('  ' * _depth)}- {k}: ")
-                    if isinstance(v, ParseResults):
-                        if v:
-                            out.append(
-                                v.dump(
-                                    indent=indent,
-                                    full=full,
-                                    include_list=include_list,
-                                    _depth=_depth + 1,
-                                )
-                            )
-                        else:
-                            out.append(str(v))
-                    else:
-                        out.append(repr(v))
-            if any(isinstance(vv, ParseResults) for vv in self):
-                v = self
-                for i, vv in enumerate(v):
-                    if isinstance(vv, ParseResults):
-                        out.append(
-                            "\n{}{}[{}]:\n{}{}{}".format(
-                                indent,
-                                ("  " * (_depth)),
-                                i,
-                                indent,
-                                ("  " * (_depth + 1)),
-                                vv.dump(
-                                    indent=indent,
-                                    full=full,
-                                    include_list=include_list,
-                                    _depth=_depth + 1,
-                                ),
-                            )
-                        )
-                    else:
-                        out.append(
-                            "\n%s%s[%d]:\n%s%s%s"
-                            % (
-                                indent,
-                                ("  " * (_depth)),
-                                i,
-                                indent,
-                                ("  " * (_depth + 1)),
-                                str(vv),
-                            )
-                        )
+        if not full:
+            return "".join(out)
+
+        if self.haskeys():
+            items = sorted((str(k), v) for k, v in self.items())
+            for k, v in items:
+                if out:
+                    out.append(NL)
+                out.append(f"{indent}{('  ' * _depth)}- {k}: ")
+                if not isinstance(v, ParseResults):
+                    out.append(repr(v))
+                    continue
+
+                if not v:
+                    out.append(str(v))
+                    continue
+
+                out.append(
+                    v.dump(
+                        indent=indent,
+                        full=full,
+                        include_list=include_list,
+                        _depth=_depth + 1,
+                    )
+                )
+        if not any(isinstance(vv, ParseResults) for vv in self):
+            return "".join(out)
+
+        v = self
+        incr = "  "
+        nl = "\n"
+        for i, vv in enumerate(v):
+            if isinstance(vv, ParseResults):
+                vv_dump = vv.dump(
+                    indent=indent,
+                    full=full,
+                    include_list=include_list,
+                    _depth=_depth + 1,
+                )
+                out.append(
+                    f"{nl}{indent}{incr * _depth}[{i}]:{nl}{indent}{incr * (_depth + 1)}{vv_dump}"
+                )
+            else:
+                out.append(
+                    f"{nl}{indent}{incr * _depth}[{i}]:{nl}{indent}{incr * (_depth + 1)}{vv}"
+                )
 
         return "".join(out)
 
diff --git a/lib/pyparsing/testing.py b/lib/pyparsing/testing.py
index 6a254c1c..5654d47d 100644
--- a/lib/pyparsing/testing.py
+++ b/lib/pyparsing/testing.py
@@ -1,8 +1,10 @@
 # testing.py
 
 from contextlib import contextmanager
+import re
 import typing
 
+
 from .core import (
     ParserElement,
     ParseException,
@@ -49,23 +51,23 @@ class pyparsing_test:
             self._save_context["default_whitespace"] = ParserElement.DEFAULT_WHITE_CHARS
             self._save_context["default_keyword_chars"] = Keyword.DEFAULT_KEYWORD_CHARS
 
-            self._save_context[
-                "literal_string_class"
-            ] = ParserElement._literalStringClass
+            self._save_context["literal_string_class"] = (
+                ParserElement._literalStringClass
+            )
 
             self._save_context["verbose_stacktrace"] = ParserElement.verbose_stacktrace
 
             self._save_context["packrat_enabled"] = ParserElement._packratEnabled
             if ParserElement._packratEnabled:
-                self._save_context[
-                    "packrat_cache_size"
-                ] = ParserElement.packrat_cache.size
+                self._save_context["packrat_cache_size"] = (
+                    ParserElement.packrat_cache.size
+                )
             else:
                 self._save_context["packrat_cache_size"] = None
             self._save_context["packrat_parse"] = ParserElement._parse
-            self._save_context[
-                "recursion_enabled"
-            ] = ParserElement._left_recursion_enabled
+            self._save_context["recursion_enabled"] = (
+                ParserElement._left_recursion_enabled
+            )
 
             self._save_context["__diag__"] = {
                 name: getattr(__diag__, name) for name in __diag__._all_names
@@ -180,49 +182,52 @@ class pyparsing_test:
             """
             run_test_success, run_test_results = run_tests_report
 
-            if expected_parse_results is not None:
-                merged = [
-                    (*rpt, expected)
-                    for rpt, expected in zip(run_test_results, expected_parse_results)
-                ]
-                for test_string, result, expected in merged:
-                    # expected should be a tuple containing a list and/or a dict or an exception,
-                    # and optional failure message string
-                    # an empty tuple will skip any result validation
-                    fail_msg = next(
-                        (exp for exp in expected if isinstance(exp, str)), None
+            if expected_parse_results is None:
+                self.assertTrue(
+                    run_test_success, msg=msg if msg is not None else "failed runTests"
+                )
+                return
+
+            merged = [
+                (*rpt, expected)
+                for rpt, expected in zip(run_test_results, expected_parse_results)
+            ]
+            for test_string, result, expected in merged:
+                # expected should be a tuple containing a list and/or a dict or an exception,
+                # and optional failure message string
+                # an empty tuple will skip any result validation
+                fail_msg = next((exp for exp in expected if isinstance(exp, str)), None)
+                expected_exception = next(
+                    (
+                        exp
+                        for exp in expected
+                        if isinstance(exp, type) and issubclass(exp, Exception)
+                    ),
+                    None,
+                )
+                if expected_exception is not None:
+                    with self.assertRaises(
+                        expected_exception=expected_exception, msg=fail_msg or msg
+                    ):
+                        if isinstance(result, Exception):
+                            raise result
+                else:
+                    expected_list = next(
+                        (exp for exp in expected if isinstance(exp, list)), None
                     )
-                    expected_exception = next(
-                        (
-                            exp
-                            for exp in expected
-                            if isinstance(exp, type) and issubclass(exp, Exception)
-                        ),
-                        None,
+                    expected_dict = next(
+                        (exp for exp in expected if isinstance(exp, dict)), None
                     )
-                    if expected_exception is not None:
-                        with self.assertRaises(
-                            expected_exception=expected_exception, msg=fail_msg or msg
-                        ):
-                            if isinstance(result, Exception):
-                                raise result
+                    if (expected_list, expected_dict) != (None, None):
+                        self.assertParseResultsEquals(
+                            result,
+                            expected_list=expected_list,
+                            expected_dict=expected_dict,
+                            msg=fail_msg or msg,
+                        )
                     else:
-                        expected_list = next(
-                            (exp for exp in expected if isinstance(exp, list)), None
-                        )
-                        expected_dict = next(
-                            (exp for exp in expected if isinstance(exp, dict)), None
-                        )
-                        if (expected_list, expected_dict) != (None, None):
-                            self.assertParseResultsEquals(
-                                result,
-                                expected_list=expected_list,
-                                expected_dict=expected_dict,
-                                msg=fail_msg or msg,
-                            )
-                        else:
-                            # warning here maybe?
-                            print(f"no validation for {test_string!r}")
+                        # warning here maybe?
+                        print(f"no validation for {test_string!r}")
 
             # do this last, in case some specific test results can be reported instead
             self.assertTrue(
@@ -230,9 +235,18 @@ class pyparsing_test:
             )
 
         @contextmanager
-        def assertRaisesParseException(self, exc_type=ParseException, msg=None):
-            with self.assertRaises(exc_type, msg=msg):
-                yield
+        def assertRaisesParseException(
+            self, exc_type=ParseException, expected_msg=None, msg=None
+        ):
+            if expected_msg is not None:
+                if isinstance(expected_msg, str):
+                    expected_msg = re.escape(expected_msg)
+                with self.assertRaisesRegex(exc_type, expected_msg, msg=msg) as ctx:
+                    yield ctx
+
+            else:
+                with self.assertRaises(exc_type, msg=msg) as ctx:
+                    yield ctx
 
     @staticmethod
     def with_line_numbers(
diff --git a/lib/pyparsing/unicode.py b/lib/pyparsing/unicode.py
index b0a87b23..426b8b23 100644
--- a/lib/pyparsing/unicode.py
+++ b/lib/pyparsing/unicode.py
@@ -102,17 +102,10 @@ class unicode_set:
         all characters in this range that are valid identifier body characters,
         plus the digits 0-9, and · (Unicode MIDDLE DOT)
         """
-        return "".join(
-            sorted(
-                set(
-                    cls.identchars
-                    + "0123456789·"
-                    + "".join(
-                        [c for c in cls._chars_for_ranges if ("_" + c).isidentifier()]
-                    )
-                )
-            )
+        identifier_chars = set(
+            c for c in cls._chars_for_ranges if ("_" + c).isidentifier()
         )
+        return "".join(sorted(identifier_chars | set(cls.identchars + "0123456789·")))
 
     @_lazyclassproperty
     def identifier(cls):
diff --git a/lib/pyparsing/util.py b/lib/pyparsing/util.py
index d8d3f414..4ae018a9 100644
--- a/lib/pyparsing/util.py
+++ b/lib/pyparsing/util.py
@@ -237,7 +237,7 @@ def _flatten(ll: list) -> list:
     return ret
 
 
-def _make_synonym_function(compat_name: str, fn: C) -> C:
+def replaced_by_pep8(compat_name: str, fn: C) -> C:
     # In a future version, uncomment the code in the internal _inner() functions
     # to begin emitting DeprecationWarnings.
 
@@ -251,7 +251,7 @@ def _make_synonym_function(compat_name: str, fn: C) -> C:
         @wraps(fn)
         def _inner(self, *args, **kwargs):
             # warnings.warn(
-            #     f"Deprecated - use {fn.__name__}", DeprecationWarning, stacklevel=3
+            #     f"Deprecated - use {fn.__name__}", DeprecationWarning, stacklevel=2
             # )
             return fn(self, *args, **kwargs)
 
@@ -260,7 +260,7 @@ def _make_synonym_function(compat_name: str, fn: C) -> C:
         @wraps(fn)
         def _inner(*args, **kwargs):
             # warnings.warn(
-            #     f"Deprecated - use {fn.__name__}", DeprecationWarning, stacklevel=3
+            #     f"Deprecated - use {fn.__name__}", DeprecationWarning, stacklevel=2
             # )
             return fn(*args, **kwargs)
 
@@ -275,10 +275,3 @@ def _make_synonym_function(compat_name: str, fn: C) -> C:
         _inner.__kwdefaults__ = None
     _inner.__qualname__ = fn.__qualname__
     return cast(C, _inner)
-
-
-def replaced_by_pep8(fn: C) -> Callable[[Callable], C]:
-    """
-    Decorator for pre-PEP8 compatibility synonyms, to link them to the new function.
-    """
-    return lambda other: _make_synonym_function(other.__name__, fn)
diff --git a/requirements.txt b/requirements.txt
index 8dc7afea..b63b1ab9 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -32,7 +32,7 @@ plexapi==4.15.10
 portend==3.2.0
 profilehooks==1.12.0
 PyJWT==2.8.0
-pyparsing==3.1.1
+pyparsing==3.1.2
 python-dateutil==2.9.0.post0
 python-twitter==3.5
 pytz==2024.1

From aa2006c2cc16dcb3e52e4fb8afec72e779a917a6 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 30 Mar 2024 15:29:02 -0700
Subject: [PATCH 563/743] Bump markupsafe from 2.1.3 to 2.1.5 (#2297)

Bumps [markupsafe](https://github.com/pallets/markupsafe) from 2.1.3 to 2.1.5.
- [Release notes](https://github.com/pallets/markupsafe/releases)
- [Changelog](https://github.com/pallets/markupsafe/blob/main/CHANGES.rst)
- [Commits](https://github.com/pallets/markupsafe/compare/2.1.3...2.1.5)

---
updated-dependencies:
- dependency-name: markupsafe
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements.txt b/requirements.txt
index b63b1ab9..e011859c 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -23,7 +23,7 @@ importlib-resources==6.4.0
 git+https://github.com/Tautulli/ipwhois.git@master#egg=ipwhois
 IPy==1.01
 Mako==1.3.2
-MarkupSafe==2.1.3
+MarkupSafe==2.1.5
 musicbrainzngs==0.7.1
 packaging==24.0
 paho-mqtt==2.0.0

From b6eca379fa5f0027571583adf2066736ecb86b0a Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 30 Mar 2024 15:29:14 -0700
Subject: [PATCH 564/743] Bump idna from 3.4 to 3.6 (#2300)

* Bump idna from 3.4 to 3.6

Bumps [idna](https://github.com/kjd/idna) from 3.4 to 3.6.
- [Changelog](https://github.com/kjd/idna/blob/master/HISTORY.rst)
- [Commits](https://github.com/kjd/idna/compare/v3.4...v3.6)

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

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

* Update idna==3.6

---------

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

[skip ci]
---
 requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements.txt b/requirements.txt
index e011859c..63e46b06 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -17,7 +17,7 @@ ga4mp==2.0.4
 gntp==1.0.3
 html5lib==1.1
 httpagentparser==1.9.5
-idna==3.4
+idna==3.6
 importlib-metadata==7.1.0
 importlib-resources==6.4.0
 git+https://github.com/Tautulli/ipwhois.git@master#egg=ipwhois

From cdfffda8774e435fec484748998f813f69823def Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 30 Mar 2024 15:29:25 -0700
Subject: [PATCH 565/743] Bump pyopenssl from 24.0.0 to 24.1.0 (#2290)

Bumps [pyopenssl](https://github.com/pyca/pyopenssl) from 24.0.0 to 24.1.0.
- [Changelog](https://github.com/pyca/pyopenssl/blob/main/CHANGELOG.rst)
- [Commits](https://github.com/pyca/pyopenssl/compare/24.0.0...24.1.0)

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

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 package/requirements-package.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index ee119322..82deb58e 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -2,7 +2,7 @@ apscheduler==3.10.1
 importlib-metadata==7.1.0
 importlib-resources==6.4.0
 pyinstaller==6.4.0
-pyopenssl==24.0.0
+pyopenssl==24.1.0
 pycryptodomex==3.20.0
 
 pyobjc-core==10.1; platform_system == "Darwin"

From 938b48c5aa6914b30087e83ef6971d9adbfdd602 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 30 Mar 2024 15:29:37 -0700
Subject: [PATCH 566/743] Bump pyobjc-core from 10.1 to 10.2 (#2294)

Bumps [pyobjc-core](https://github.com/ronaldoussoren/pyobjc) from 10.1 to 10.2.
- [Release notes](https://github.com/ronaldoussoren/pyobjc/releases)
- [Changelog](https://github.com/ronaldoussoren/pyobjc/blob/master/docs/changelog.rst)
- [Commits](https://github.com/ronaldoussoren/pyobjc/compare/v10.1...v10.2)

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

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 package/requirements-package.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index 82deb58e..3615d0f2 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -5,7 +5,7 @@ pyinstaller==6.4.0
 pyopenssl==24.1.0
 pycryptodomex==3.20.0
 
-pyobjc-core==10.1; platform_system == "Darwin"
+pyobjc-core==10.2; platform_system == "Darwin"
 pyobjc-framework-Cocoa==10.1; platform_system == "Darwin"
 
 pywin32==306; platform_system == "Windows"

From b2a8601c70da13f60a7853d55efb78777ecc56c4 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 30 Mar 2024 15:30:09 -0700
Subject: [PATCH 567/743] Bump pyobjc-framework-cocoa from 10.1 to 10.2 (#2299)

Bumps [pyobjc-framework-cocoa](https://github.com/ronaldoussoren/pyobjc) from 10.1 to 10.2.
- [Release notes](https://github.com/ronaldoussoren/pyobjc/releases)
- [Changelog](https://github.com/ronaldoussoren/pyobjc/blob/master/docs/changelog.rst)
- [Commits](https://github.com/ronaldoussoren/pyobjc/compare/v10.1...v10.2)

---
updated-dependencies:
- dependency-name: pyobjc-framework-cocoa
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 package/requirements-package.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index 3615d0f2..c407344d 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -6,6 +6,6 @@ pyopenssl==24.1.0
 pycryptodomex==3.20.0
 
 pyobjc-core==10.2; platform_system == "Darwin"
-pyobjc-framework-Cocoa==10.1; platform_system == "Darwin"
+pyobjc-framework-Cocoa==10.2; platform_system == "Darwin"
 
 pywin32==306; platform_system == "Windows"

From 653a6d5c12729b99f2380134ba57a7591e58ba9b Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 30 Mar 2024 15:46:44 -0700
Subject: [PATCH 568/743] Bump pyinstaller from 6.4.0 to 6.5.0 (#2298)

Bumps [pyinstaller](https://github.com/pyinstaller/pyinstaller) from 6.4.0 to 6.5.0.
- [Release notes](https://github.com/pyinstaller/pyinstaller/releases)
- [Changelog](https://github.com/pyinstaller/pyinstaller/blob/develop/doc/CHANGES.rst)
- [Commits](https://github.com/pyinstaller/pyinstaller/compare/v6.4.0...v6.5.0)

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

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 package/requirements-package.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index c407344d..99f35df4 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -1,7 +1,7 @@
 apscheduler==3.10.1
 importlib-metadata==7.1.0
 importlib-resources==6.4.0
-pyinstaller==6.4.0
+pyinstaller==6.5.0
 pyopenssl==24.1.0
 pycryptodomex==3.20.0
 

From 85519b1b457fe6d0c945ca0249bcf6f825150574 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 31 Mar 2024 16:11:00 -0700
Subject: [PATCH 569/743] Update plexapi==4.15.11

---
 lib/plexapi/audio.py      |  19 +++++++
 lib/plexapi/base.py       | 112 ++++++++++++++++++++++++++++++++++----
 lib/plexapi/collection.py |   2 +
 lib/plexapi/const.py      |   2 +-
 lib/plexapi/library.py    |  37 ++++++++++++-
 lib/plexapi/playlist.py   |   2 +
 lib/plexapi/utils.py      |  13 +++++
 requirements.txt          |   2 +-
 8 files changed, 173 insertions(+), 16 deletions(-)

diff --git a/lib/plexapi/audio.py b/lib/plexapi/audio.py
index 370fe0dc..0eb397cc 100644
--- a/lib/plexapi/audio.py
+++ b/lib/plexapi/audio.py
@@ -1,4 +1,6 @@
 # -*- coding: utf-8 -*-
+from __future__ import annotations
+
 import os
 from pathlib import Path
 from urllib.parse import quote_plus
@@ -17,6 +19,7 @@ from plexapi.playlist import Playlist
 
 
 TAudio = TypeVar("TAudio", bound="Audio")
+TTrack = TypeVar("TTrack", bound="Track")
 
 
 class Audio(PlexPartialObject, PlayedUnplayedMixin):
@@ -532,6 +535,22 @@ class Track(
         guid_hash = utils.sha1hash(self.parentGuid)
         return str(Path('Metadata') / 'Albums' / guid_hash[0] / f'{guid_hash[1:]}.bundle')
 
+    def sonicAdventure(
+        self: TTrack,
+        to: TTrack,
+        **kwargs: Any,
+    ) -> list[TTrack]:
+        """Returns a sonic adventure from the current track to the specified track.
+
+        Parameters:
+            to (:class:`~plexapi.audio.Track`): The target track for the sonic adventure.
+            **kwargs: Additional options passed into :func:`~plexapi.library.MusicSection.sonicAdventure`.
+
+        Returns:
+            List[:class:`~plexapi.audio.Track`]: list of tracks in the sonic adventure.
+        """
+        return self.section().sonicAdventure(self, to, **kwargs)
+
 
 @utils.registerPlexObject
 class TrackSession(PlexSession, Track):
diff --git a/lib/plexapi/base.py b/lib/plexapi/base.py
index 52063c00..0852426d 100644
--- a/lib/plexapi/base.py
+++ b/lib/plexapi/base.py
@@ -1,13 +1,21 @@
 # -*- coding: utf-8 -*-
 import re
+from typing import TYPE_CHECKING, Generic, Iterable, List, Optional, TypeVar, Union
 import weakref
 from functools import cached_property
 from urllib.parse import urlencode
 from xml.etree import ElementTree
+from xml.etree.ElementTree import Element
 
 from plexapi import CONFIG, X_PLEX_CONTAINER_SIZE, log, utils
 from plexapi.exceptions import BadRequest, NotFound, UnknownType, Unsupported
 
+if TYPE_CHECKING:
+    from plexapi.server import PlexServer
+
+PlexObjectT = TypeVar("PlexObjectT", bound='PlexObject')
+MediaContainerT = TypeVar("MediaContainerT", bound="MediaContainer")
+
 USER_DONT_RELOAD_FOR_KEYS = set()
 _DONT_RELOAD_FOR_KEYS = {'key'}
 OPERATORS = {
@@ -95,7 +103,7 @@ class PlexObject:
             ehash = f"{ehash}.session"
         elif initpath.startswith('/status/sessions/history'):
             ehash = f"{ehash}.history"
-        ecls = utils.PLEXOBJECTS.get(ehash, utils.PLEXOBJECTS.get(elem.tag))
+        ecls = utils.getPlexObject(ehash, default=elem.tag)
         # log.debug('Building %s as %s', elem.tag, ecls.__name__)
         if ecls is not None:
             return ecls(self._server, elem, initpath, parent=self)
@@ -116,14 +124,22 @@ class PlexObject:
             or disable each parameter individually by setting it to False or 0.
         """
         details_key = self.key
+        params = {}
+
         if details_key and hasattr(self, '_INCLUDES'):
-            includes = {}
             for k, v in self._INCLUDES.items():
-                value = kwargs.get(k, v)
+                value = kwargs.pop(k, v)
                 if value not in [False, 0, '0']:
-                    includes[k] = 1 if value is True else value
-            if includes:
-                details_key += '?' + urlencode(sorted(includes.items()))
+                    params[k] = 1 if value is True else value
+
+        if details_key and hasattr(self, '_EXCLUDES'):
+            for k, v in self._EXCLUDES.items():
+                value = kwargs.pop(k, None)
+                if value is not None:
+                    params[k] = 1 if value is True else value
+
+        if params:
+            details_key += '?' + urlencode(sorted(params.items()))
         return details_key
 
     def _isChildOf(self, **kwargs):
@@ -227,7 +243,7 @@ class PlexObject:
 
                     fetchItem(ekey, viewCount__gte=0)
                     fetchItem(ekey, Media__container__in=["mp4", "mkv"])
-                    fetchItem(ekey, guid__regex=r"com\.plexapp\.agents\.(imdb|themoviedb)://|tt\d+")
+                    fetchItem(ekey, guid__regex=r"com\\.plexapp\\.agents\\.(imdb|themoviedb)://|tt\d+")
                     fetchItem(ekey, guid__id__regex=r"(imdb|tmdb|tvdb)://")
                     fetchItem(ekey, Media__Part__file__startswith="D:\\Movies")
 
@@ -245,8 +261,7 @@ class PlexObject:
         if maxresults is not None:
             container_size = min(container_size, maxresults)
 
-        results = []
-        subresults = []
+        results = MediaContainer[cls](self._server, Element('MediaContainer'), initpath=ekey)
         headers = {}
 
         while True:
@@ -324,7 +339,7 @@ class PlexObject:
         if rtag:
             data = next(utils.iterXMLBFS(data, rtag), [])
         # loop through all data elements to find matches
-        items = []
+        items = MediaContainer[cls](self._server, data, initpath=initpath) if data.tag == 'MediaContainer' else []
         for elem in data:
             if self._checkAttrs(elem, **kwargs):
                 item = self._buildItemOrNone(elem, cls, initpath)
@@ -498,7 +513,14 @@ class PlexPartialObject(PlexObject):
         'includeRelated': 1,
         'includeRelatedCount': 1,
         'includeReviews': 1,
-        'includeStations': 1
+        'includeStations': 1,
+    }
+    _EXCLUDES = {
+        'excludeElements': (
+            'Media,Genre,Country,Guid,Rating,Collection,Director,Writer,Role,Producer,Similar,Style,Mood,Format'
+        ),
+        'excludeFields': 'summary,tagline',
+        'skipRefresh': 1,
     }
 
     def __eq__(self, other):
@@ -996,7 +1018,11 @@ class PlexHistory(object):
         return self._server.query(self.historyKey, method=self._server._session.delete)
 
 
-class MediaContainer(PlexObject):
+class MediaContainer(
+    Generic[PlexObjectT],
+    List[PlexObjectT],
+    PlexObject,
+):
     """ Represents a single MediaContainer.
 
         Attributes:
@@ -1009,11 +1035,71 @@ class MediaContainer(PlexObject):
             librarySectionUUID (str): :class:`~plexapi.library.LibrarySection` UUID.
             mediaTagPrefix (str): "/system/bundle/media/flags/"
             mediaTagVersion (int): Unknown
+            offset (int): The offset of current results.
             size (int): The number of items in the hub.
+            totalSize (int): The total number of items for the query.
 
     """
     TAG = 'MediaContainer'
 
+    def __init__(
+        self,
+        server: "PlexServer",
+        data: Element,
+        *args: PlexObjectT,
+        initpath: Optional[str] = None,
+        parent: Optional[PlexObject] = None,
+    ) -> None:
+        # super calls Generic.__init__ which calls list.__init__ eventually
+        super().__init__(*args)
+        PlexObject.__init__(self, server, data, initpath, parent)
+
+    def extend(
+        self: MediaContainerT,
+        __iterable: Union[Iterable[PlexObjectT], MediaContainerT],
+    ) -> None:
+        curr_size = self.size if self.size is not None else len(self)
+        super().extend(__iterable)
+        # update size, totalSize, and offset
+        if not isinstance(__iterable, MediaContainer):
+            return
+
+        # prefer the totalSize of the new iterable even if it is smaller
+        self.totalSize = (
+            __iterable.totalSize
+            if __iterable.totalSize is not None
+            else self.totalSize
+        )  # ideally both should be equal
+
+        # the size of the new iterable is added to the current size
+        self.size = curr_size + (
+            __iterable.size if __iterable.size is not None else len(__iterable)
+        )
+
+        # the offset is the minimum of the two, prefering older values
+        if self.offset is not None and __iterable.offset is not None:
+            self.offset = min(self.offset, __iterable.offset)
+        else:
+            self.offset = (
+                self.offset if self.offset is not None else __iterable.offset
+            )
+
+        # for all other attributes, overwrite with the new iterable's values if previously None
+        for key in (
+            "allowSync",
+            "augmentationKey",
+            "identifier",
+            "librarySectionID",
+            "librarySectionTitle",
+            "librarySectionUUID",
+            "mediaTagPrefix",
+            "mediaTagVersion",
+        ):
+            if (not hasattr(self, key)) or (getattr(self, key) is None):
+                if not hasattr(__iterable, key):
+                    continue
+                setattr(self, key, getattr(__iterable, key))
+
     def _loadData(self, data):
         self._data = data
         self.allowSync = utils.cast(int, data.attrib.get('allowSync'))
@@ -1024,4 +1110,6 @@ class MediaContainer(PlexObject):
         self.librarySectionUUID = data.attrib.get('librarySectionUUID')
         self.mediaTagPrefix = data.attrib.get('mediaTagPrefix')
         self.mediaTagVersion = data.attrib.get('mediaTagVersion')
+        self.offset = utils.cast(int, data.attrib.get("offset"))
         self.size = utils.cast(int, data.attrib.get('size'))
+        self.totalSize = utils.cast(int, data.attrib.get("totalSize"))
diff --git a/lib/plexapi/collection.py b/lib/plexapi/collection.py
index 809455ea..5f591a4a 100644
--- a/lib/plexapi/collection.py
+++ b/lib/plexapi/collection.py
@@ -503,6 +503,8 @@ class Collection(
                 :class:`~plexapi.collection.Collection`: A new instance of the created Collection.
         """
         if smart:
+            if items:
+                raise BadRequest('Cannot create a smart collection with items.')
             return cls._createSmart(server, title, section, limit, libtype, sort, filters, **kwargs)
         else:
             return cls._create(server, title, section, items)
diff --git a/lib/plexapi/const.py b/lib/plexapi/const.py
index c427177f..e043d8c2 100644
--- a/lib/plexapi/const.py
+++ b/lib/plexapi/const.py
@@ -4,6 +4,6 @@
 # Library version
 MAJOR_VERSION = 4
 MINOR_VERSION = 15
-PATCH_VERSION = 10
+PATCH_VERSION = 11
 __short_version__ = f"{MAJOR_VERSION}.{MINOR_VERSION}"
 __version__ = f"{__short_version__}.{PATCH_VERSION}"
diff --git a/lib/plexapi/library.py b/lib/plexapi/library.py
index 5b06f009..662b5462 100644
--- a/lib/plexapi/library.py
+++ b/lib/plexapi/library.py
@@ -1,5 +1,8 @@
 # -*- coding: utf-8 -*-
+from __future__ import annotations
+
 import re
+from typing import Any, TYPE_CHECKING
 import warnings
 from collections import defaultdict
 from datetime import datetime
@@ -17,6 +20,10 @@ from plexapi.settings import Setting
 from plexapi.utils import deprecated
 
 
+if TYPE_CHECKING:
+    from plexapi.audio import Track
+
+
 class Library(PlexObject):
     """ Represents a PlexServer library. This contains all sections of media defined
         in your Plex server including video, shows and audio.
@@ -376,7 +383,8 @@ class Library(PlexObject):
         part = (f'/library/sections?name={quote_plus(name)}&type={type}&agent={agent}'
                 f'&scanner={quote_plus(scanner)}&language={language}&{urlencode(locations, doseq=True)}')
         if kwargs:
-            part += urlencode(kwargs)
+            prefs_params = {f'prefs[{k}]': v for k, v in kwargs.items()}
+            part += f'&{urlencode(prefs_params)}'
         return self._server.query(part, method=self._server._session.post)
 
     def history(self, maxresults=None, mindate=None):
@@ -655,7 +663,7 @@ class LibrarySection(PlexObject):
                     guidLookup = {}
                     for item in library.all():
                         guidLookup[item.guid] = item
-                        guidLookup.update({guid.id: item for guid in item.guids}}
+                        guidLookup.update({guid.id: item for guid in item.guids})
 
                     result1 = guidLookup['plex://show/5d9c086c46115600200aa2fe']
                     result2 = guidLookup['imdb://tt0944947']
@@ -2033,6 +2041,31 @@ class MusicSection(LibrarySection, ArtistEditMixins, AlbumEditMixins, TrackEditM
         kwargs['policy'] = Policy.create(limit)
         return super(MusicSection, self).sync(**kwargs)
 
+    def sonicAdventure(
+            self,
+            start: Track | int,
+            end: Track | int,
+            **kwargs: Any,
+    ) -> list[Track]:
+        """ Returns a list of tracks from this library section that are part of a sonic adventure.
+            ID's should be of a track, other ID's will return an empty list or items itself or an error.
+
+            Parameters:
+                start (Track | int): The :class:`~plexapi.audio.Track` or ID of the first track in the sonic adventure.
+                end (Track | int): The :class:`~plexapi.audio.Track` or ID of the last track in the sonic adventure.
+                kwargs: Additional parameters to pass to :func:`~plexapi.base.PlexObject.fetchItems`.
+
+            Returns:
+                List[:class:`~plexapi.audio.Track`]: a list of tracks from this library section
+                that are part of a sonic adventure.
+        """
+        # can not use Track due to circular import
+        startID = start if isinstance(start, int) else start.ratingKey
+        endID = end if isinstance(end, int) else end.ratingKey
+
+        key = f"/library/sections/{self.key}/computePath?startID={startID}&endID={endID}"
+        return self.fetchItems(key, **kwargs)
+
 
 class PhotoSection(LibrarySection, PhotoalbumEditMixins, PhotoEditMixins):
     """ Represents a :class:`~plexapi.library.LibrarySection` section containing photos.
diff --git a/lib/plexapi/playlist.py b/lib/plexapi/playlist.py
index 14ef88ed..a50b6200 100644
--- a/lib/plexapi/playlist.py
+++ b/lib/plexapi/playlist.py
@@ -434,6 +434,8 @@ class Playlist(
         if m3ufilepath:
             return cls._createFromM3U(server, title, section, m3ufilepath)
         elif smart:
+            if items:
+                raise BadRequest('Cannot create a smart playlist with items.')
             return cls._createSmart(server, title, section, limit, libtype, sort, filters, **kwargs)
         else:
             return cls._create(server, title, items)
diff --git a/lib/plexapi/utils.py b/lib/plexapi/utils.py
index 467ccf05..bb128532 100644
--- a/lib/plexapi/utils.py
+++ b/lib/plexapi/utils.py
@@ -136,6 +136,19 @@ def registerPlexObject(cls):
     return cls
 
 
+def getPlexObject(ehash, default):
+    """ Return the PlexObject class for the specified ehash. This recursively looks up the class
+        with the highest specificity, falling back to the default class if not found.
+    """
+    cls = PLEXOBJECTS.get(ehash)
+    if cls is not None:
+        return cls
+    if '.' in ehash:
+        ehash = ehash.rsplit('.', 1)[0]
+        return getPlexObject(ehash, default=default)
+    return PLEXOBJECTS.get(default)
+
+
 def cast(func, value):
     """ Cast the specified value to the specified type (returned by func). Currently this
         only support str, int, float, bool. Should be extended if needed.
diff --git a/requirements.txt b/requirements.txt
index 63e46b06..af94378a 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -28,7 +28,7 @@ musicbrainzngs==0.7.1
 packaging==24.0
 paho-mqtt==2.0.0
 platformdirs==4.2.0
-plexapi==4.15.10
+plexapi==4.15.11
 portend==3.2.0
 profilehooks==1.12.0
 PyJWT==2.8.0

From b8185afdf98a8f977281b5cea31518e0dda5f10f Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 31 Mar 2024 17:09:35 -0700
Subject: [PATCH 570/743] Temporary fix for live tv session missing duration

---
 plexpy/activity_handler.py   | 3 ++-
 plexpy/activity_processor.py | 3 ++-
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/plexpy/activity_handler.py b/plexpy/activity_handler.py
index 2507cf6f..ea25f0bd 100644
--- a/plexpy/activity_handler.py
+++ b/plexpy/activity_handler.py
@@ -163,7 +163,8 @@ class ActivityHandler(object):
         # Set force_stop to true to disable the state set
         if not force_stop:
             # Set the view offset equal to the duration if it is within the last 10 seconds
-            if self.db_session['duration'] - self.view_offset <= 10000:
+            # TODO: temporary workaround for missing livetv duration
+            if self.db_session['duration'] > 0 and self.db_session['duration'] - self.view_offset <= 10000:
                 view_offset = self.db_session['duration']
             else:
                 view_offset = self.view_offset
diff --git a/plexpy/activity_processor.py b/plexpy/activity_processor.py
index 9115f332..3ece3f11 100644
--- a/plexpy/activity_processor.py
+++ b/plexpy/activity_processor.py
@@ -78,7 +78,8 @@ class ActivityProcessor(object):
                       'added_at': session.get('added_at', ''),
                       'guid': session.get('guid', ''),
                       'view_offset': session.get('view_offset', ''),
-                      'duration': session.get('duration', ''),
+                      # TODO: temporary workaround for missing livetv duration
+                      'duration': session.get('duration', '') or 0,
                       'video_decision': session.get('video_decision', ''),
                       'audio_decision': session.get('audio_decision', ''),
                       'transcode_decision': session.get('transcode_decision', ''),

From 458e89b8d73e62c321d126ea75c52f01468cebfe Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 1 Apr 2024 16:41:41 -0700
Subject: [PATCH 571/743] Get live TV metadata from epg

---
 plexpy/activity_handler.py   |   3 +-
 plexpy/activity_processor.py |   1 -
 plexpy/helpers.py            |   6 +-
 plexpy/http_handler.py       |   6 +-
 plexpy/pmsconnect.py         | 113 +++++++++++++++++++++++++++++++++--
 plexpy/webserve.py           |   6 ++
 6 files changed, 124 insertions(+), 11 deletions(-)

diff --git a/plexpy/activity_handler.py b/plexpy/activity_handler.py
index ea25f0bd..5c572408 100644
--- a/plexpy/activity_handler.py
+++ b/plexpy/activity_handler.py
@@ -1,4 +1,4 @@
-# This file is part of Tautulli.
+# This file is part of Tautulli.
 #
 #  Tautulli is free software: you can redistribute it and/or modify
 #  it under the terms of the GNU General Public License as published by
@@ -163,7 +163,6 @@ class ActivityHandler(object):
         # Set force_stop to true to disable the state set
         if not force_stop:
             # Set the view offset equal to the duration if it is within the last 10 seconds
-            # TODO: temporary workaround for missing livetv duration
             if self.db_session['duration'] > 0 and self.db_session['duration'] - self.view_offset <= 10000:
                 view_offset = self.db_session['duration']
             else:
diff --git a/plexpy/activity_processor.py b/plexpy/activity_processor.py
index 3ece3f11..0de08564 100644
--- a/plexpy/activity_processor.py
+++ b/plexpy/activity_processor.py
@@ -78,7 +78,6 @@ class ActivityProcessor(object):
                       'added_at': session.get('added_at', ''),
                       'guid': session.get('guid', ''),
                       'view_offset': session.get('view_offset', ''),
-                      # TODO: temporary workaround for missing livetv duration
                       'duration': session.get('duration', '') or 0,
                       'video_decision': session.get('video_decision', ''),
                       'audio_decision': session.get('audio_decision', ''),
diff --git a/plexpy/helpers.py b/plexpy/helpers.py
index 04391204..dc83fcb3 100644
--- a/plexpy/helpers.py
+++ b/plexpy/helpers.py
@@ -242,10 +242,14 @@ def YMD_to_timestamp(ymd):
     return datetime.strptime(ymd, "%Y-%m-%d").timestamp()
 
 
-def timestamp_to_YMDHMS(ts, sep=False):
+def timestamp_to_YMDHMS(ts, sep=False, ymd=False):
     dt = timestamp_to_datetime(ts)
     if sep:
+        if ymd:
+            return dt.strftime("%Y-%m-%d")
         return dt.strftime("%Y-%m-%d %H:%M:%S")
+    if ymd:
+        return dt.strftime("%Y%m%d")
     return dt.strftime("%Y%m%d%H%M%S")
 
 
diff --git a/plexpy/http_handler.py b/plexpy/http_handler.py
index 79bb3562..3596fa12 100644
--- a/plexpy/http_handler.py
+++ b/plexpy/http_handler.py
@@ -82,6 +82,7 @@ class HTTPHandler(object):
         self.return_response = False
         self.return_type = False
         self.callback = None
+        self.raise_errors = True
         self.request_kwargs = {}
 
     def make_request(self,
@@ -95,6 +96,7 @@ class HTTPHandler(object):
                      no_token=False,
                      timeout=None,
                      callback=None,
+                     raise_errors=True,
                      **request_kwargs):
         """
         Handle the HTTP requests.
@@ -109,6 +111,7 @@ class HTTPHandler(object):
         self.return_response = return_response
         self.return_type = return_type
         self.callback = callback
+        self.raise_errors = raise_errors
         self.timeout = timeout or self.timeout
         self.request_kwargs = request_kwargs
 
@@ -166,7 +169,8 @@ class HTTPHandler(object):
         try:
             r = self._session.request(self.request_type, url, headers=self.headers, data=self.data,
                                       timeout=self.timeout, verify=self.ssl_verify, **self.request_kwargs)
-            r.raise_for_status()
+            if self.raise_errors:
+                r.raise_for_status()
         except requests.exceptions.Timeout as e:
             err = True
             if not self._silent:
diff --git a/plexpy/pmsconnect.py b/plexpy/pmsconnect.py
index 2e0ec22c..2662abf9 100644
--- a/plexpy/pmsconnect.py
+++ b/plexpy/pmsconnect.py
@@ -147,6 +147,23 @@ class PmsConnect(object):
 
         return request
 
+    def get_epg_metadata(self, epg_key='', output_format=''):
+        """
+        Return epg metadata for request item.
+
+        Parameters required:    epg_key { Plex key }
+        Optional parameters:    output_format { dict, json }
+
+        Output: array
+        """
+        uri = epg_key
+        request = self.request_handler.make_request(uri=uri,
+                                                    request_type='GET',
+                                                    output_format=output_format,
+                                                    raise_errors=False)
+
+        return request
+
     def get_metadata_children(self, rating_key='', collection=False, output_format=''):
         """
         Return metadata for children of the request item.
@@ -515,6 +532,22 @@ class PmsConnect(object):
 
         return request
 
+    def get_dvrs(self, output_format=''):
+        """
+        Return Plex dvrs.
+
+        Parameters required:
+        Optional parameters:    output_format { dict, json }
+
+        Output: array
+        """
+        uri = '/livetv/dvrs'
+        request = self.request_handler.make_request(uri=uri,
+                                                    request_type='GET',
+                                                    output_format=output_format)
+
+        return request
+
     def get_recently_added_details(self, start='0', count='0',  media_type='', section_id=''):
         """
         Return processed and validated list of recently added items.
@@ -654,7 +687,7 @@ class PmsConnect(object):
 
         return output
 
-    def get_metadata_details(self, rating_key='', sync_id='', plex_guid='', section_id='',
+    def get_metadata_details(self, rating_key='', sync_id='', plex_guid='', epg_key='', section_id='',
                              skip_cache=False, cache_key=None, return_cache=False, media_info=True):
         """
         Return processed and validated metadata list for requested item.
@@ -692,6 +725,8 @@ class PmsConnect(object):
             rating_key = plex_guid.rsplit('/', 1)[-1]
             plextv_metadata = PmsConnect(url='https://metadata.provider.plex.tv', token=plexpy.CONFIG.PMS_TOKEN)
             metadata_xml = plextv_metadata.get_metadata(rating_key, output_format='xml')
+        elif epg_key:
+            metadata_xml = self.get_epg_metadata(epg_key, output_format='xml')
         else:
             return metadata
 
@@ -912,7 +947,10 @@ class PmsConnect(object):
             show_details = {}
             if plex_guid and parent_guid:
                 show_details = self.get_metadata_details(plex_guid=parent_guid)
-            elif not plex_guid and parent_rating_key:
+            elif epg_key and parent_guid:
+                epg_key_root = epg_key.rsplit('/', maxsplit=1)[0]
+                show_details = self.get_metadata_details(epg_key=f"{epg_key_root}/{quote_plus(parent_guid)}")
+            elif not plex_guid and not epg_key and parent_rating_key:
                 show_details = self.get_metadata_details(parent_rating_key)
 
             metadata = {'media_type': metadata_type,
@@ -976,6 +1014,9 @@ class PmsConnect(object):
             show_details = {}
             if plex_guid and grandparent_guid:
                 show_details = self.get_metadata_details(plex_guid=grandparent_guid)
+            elif epg_key and grandparent_guid:
+                epg_key_root = epg_key.rsplit('/', maxsplit=1)[0]
+                show_details = self.get_metadata_details(epg_key=f"{epg_key_root}/{quote_plus(grandparent_guid)}")
             elif not plex_guid and grandparent_rating_key:
                 show_details = self.get_metadata_details(grandparent_rating_key)
 
@@ -984,7 +1025,7 @@ class PmsConnect(object):
             parent_thumb = helpers.get_xml_attr(metadata_main, 'parentThumb')
             season_details = self.get_metadata_details(parent_rating_key) if parent_rating_key else {}
 
-            if not plex_guid and not parent_rating_key:
+            if not plex_guid and not epg_key and not parent_rating_key:
                 # Try getting the parent_rating_key from the parent_thumb
                 if parent_thumb.startswith('/library/metadata/'):
                     parent_rating_key = parent_thumb.split('/')[3]
@@ -1474,8 +1515,28 @@ class PmsConnect(object):
         else:
             return metadata
 
+        # Get additional metadata EPG provider
+        epg_metadata = None
+        if not epg_key and metadata['live']:
+            metadata['section_id'] = common.LIVE_TV_SECTION_ID
+            metadata['library_name'] = common.LIVE_TV_SECTION_NAME
+
+            # Don't know the DVR key so need to try them all
+            for dvr in self.get_dvrs_list():
+                epg_metadata = self.get_metadata_details(epg_key=f"/{dvr['epg_identifier']}/metadata/{quote_plus(metadata['guid'])}", media_info=True)
+                if epg_metadata:
+                    metadata['epg_identifier'] = dvr['epg_identifier']
+                    keys_to_update = [
+                        'content_rating', 'summary', 'duration', 'guid',
+                        'grandparent_title', 'grandparent_thumb', 'grandparent_guid',
+                        'parent_title', 'parent_thumb', 'parent_guid'
+                    ]
+                    for key in keys_to_update:
+                        metadata[key] = epg_metadata[key]
+                    metadata['originally_available_at'] = helpers.timestamp_to_YMDHMS(epg_metadata['media_info'][0]['begins_at'], sep=True, ymd=True)
+                    break
         # Get additional metadata from metadata.provider.plex.tv
-        if not plex_guid and metadata['live']:
+        elif not plex_guid and metadata['live']:
             metadata['section_id'] = common.LIVE_TV_SECTION_ID
             metadata['library_name'] = common.LIVE_TV_SECTION_NAME
 
@@ -1577,7 +1638,7 @@ class PmsConnect(object):
 
                 audio_channels = helpers.get_xml_attr(media, 'audioChannels')
 
-                media_info = {'id': helpers.get_xml_attr(media, 'id'),
+                _media_info = {'id': helpers.get_xml_attr(media, 'id'),
                               'container': helpers.get_xml_attr(media, 'container'),
                               'bitrate': helpers.get_xml_attr(media, 'bitrate'),
                               'height': helpers.get_xml_attr(media, 'height'),
@@ -1594,12 +1655,25 @@ class PmsConnect(object):
                               'audio_profile': helpers.get_xml_attr(media, 'audioProfile'),
                               'optimized_version': int(helpers.get_xml_attr(media, 'proxyType') == '42'),
                               'channel_call_sign': helpers.get_xml_attr(media, 'channelCallSign'),
+                              'channel_id': helpers.get_xml_attr(media, 'channelID'),
                               'channel_identifier': helpers.get_xml_attr(media, 'channelIdentifier'),
+                              'channel_title': helpers.get_xml_attr(media, 'channelTitle'),
                               'channel_thumb': helpers.get_xml_attr(media, 'channelThumb'),
+                              'channel_vcn': helpers.get_xml_attr(media, 'channelVcn'),
+                              'protocol': helpers.get_xml_attr(media, 'protocol'),  # livetv
+                              'begins_at': helpers.cast_to_int(helpers.get_xml_attr(media, 'beginsAt')),  # livetv
+                              'ends_at': helpers.cast_to_int(helpers.get_xml_attr(media, 'endsAt')),  # livetv
                               'parts': parts
                               }
 
-                medias.append(media_info)
+                if epg_metadata:
+                    media_info_keys_to_update = [
+                        'channel_id', 'channel_title', 'channel_vcn'
+                    ]
+                    for key in media_info_keys_to_update:
+                        _media_info[key] = epg_metadata['media_info'][0][key]
+
+                medias.append(_media_info)
 
             metadata['media_info'] = medias
 
@@ -3325,3 +3399,30 @@ class PmsConnect(object):
         if not video_dynamic_range:
             return 'SDR'
         return '/'.join(video_dynamic_range)
+
+    def get_dvrs_list(self):
+        dvrs_xml = self.get_dvrs(output_format='xml')
+
+        try:
+            xml_head = dvrs_xml.getElementsByTagName('MediaContainer')
+        except Exception as e:
+            logger.warn("Tautulli Pmsconnect :: Unable to parse XML for get_dvrs_list: %s." % e)
+
+        dvrs_output = []
+
+        for a in xml_head:
+            dvrs = a.getElementsByTagName('Dvr')
+            for dvr in dvrs:
+                dvr_info = {
+                    'key': helpers.get_xml_attr(dvr, 'key'),
+                    'uuid': helpers.get_xml_attr(dvr, 'uuid'),
+                    'language': helpers.get_xml_attr(dvr, 'language'),
+                    'lineup_title': helpers.get_xml_attr(dvr, 'lineupTitle'),
+                    'lineup': helpers.get_xml_attr(dvr, 'lineup'),
+                    'country': helpers.get_xml_attr(dvr, 'country'),
+                    'refreshedAt': helpers.get_xml_attr(dvr, 'refreshedAt'),
+                    'epg_identifier': helpers.get_xml_attr(dvr, 'epgIdentifier')
+                }
+                dvrs_output.append(dvr_info)
+
+        return dvrs_output
diff --git a/plexpy/webserve.py b/plexpy/webserve.py
index 1e73cca9..87196b12 100644
--- a/plexpy/webserve.py
+++ b/plexpy/webserve.py
@@ -5439,8 +5439,11 @@ class WebInterface(object):
                              "audio_profile": "",
                              "bitrate": "10617",
                              "channel_call_sign": "",
+                             "channel_id": "",
                              "channel_identifier": "",
+                             "channel_title": "",
                              "channel_thumb": "",
+                             "channel_vcn": "",
                              "container": "mkv",
                              "height": "1078",
                              "id": "257925",
@@ -5860,9 +5863,12 @@ class WebInterface(object):
                              "bif_thumb": "/library/parts/274169/indexes/sd/1000",
                              "bitrate": "10617",
                              "channel_call_sign": "",
+                             "channel_id": "",
                              "channel_identifier": "",
                              "channel_stream": 0,
+                             "channel_title": "",
                              "channel_thumb": "",
+                             "channel_vcn": "",
                              "children_count": "",
                              "collections": [],
                              "container": "mkv",

From 980fc8a43f35e67e151489661537ab869f564b2e Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 1 Apr 2024 16:06:45 -0700
Subject: [PATCH 572/743] Fix live tv history watched status

---
 plexpy/datafactory.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/plexpy/datafactory.py b/plexpy/datafactory.py
index 037097af..b3c6b138 100644
--- a/plexpy/datafactory.py
+++ b/plexpy/datafactory.py
@@ -283,7 +283,7 @@ class DataFactory(object):
 
             base_watched_value = watched_percent[item['media_type']] / 4.0
 
-            if helpers.check_watched(
+            if item['live'] or helpers.check_watched(
                 item['media_type'], item['view_offset'], item['duration'],
                 item['marker_credits_first'], item['marker_credits_final']
             ):

From 5e4f656155d1736c2bd45155982f97121d46a4a8 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 1 Apr 2024 16:07:01 -0700
Subject: [PATCH 573/743] Add space to session start live tv log message

---
 plexpy/activity_handler.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/plexpy/activity_handler.py b/plexpy/activity_handler.py
index 5c572408..01161649 100644
--- a/plexpy/activity_handler.py
+++ b/plexpy/activity_handler.py
@@ -1,4 +1,4 @@
-# This file is part of Tautulli.
+# This file is part of Tautulli.
 #
 #  Tautulli is free software: you can redistribute it and/or modify
 #  it under the terms of the GNU General Public License as published by
@@ -139,7 +139,7 @@ class ActivityHandler(object):
 
         logger.debug("Tautulli ActivityHandler :: Session %s started by user %s (%s) with ratingKey %s (%s)%s."
                         % (str(self.session['session_key']), str(self.session['user_id']), self.session['username'],
-                        str(self.session['rating_key']), self.session['full_title'], '[Live TV]' if self.session['live'] else ''))
+                        str(self.session['rating_key']), self.session['full_title'], ' [Live TV]' if self.session['live'] else ''))
 
         # Write the new session to our temp session table
         self.update_db_session(notify=True)

From 177962d62691a9fa805b3ae000e290916eeedc84 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 1 Apr 2024 16:42:32 -0700
Subject: [PATCH 574/743] Change live tv text to channel title

---
 data/interfaces/default/current_activity_instance.html | 2 +-
 data/interfaces/default/info.html                      | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/data/interfaces/default/current_activity_instance.html b/data/interfaces/default/current_activity_instance.html
index 64b498e0..fcc1b592 100644
--- a/data/interfaces/default/current_activity_instance.html
+++ b/data/interfaces/default/current_activity_instance.html
@@ -369,7 +369,7 @@ DOCUMENTATION :: END
                 % if data['media_type'] != 'photo':
                 <div class="dashboard-activity-info-time">
                     % if data['live']:
-                    <br /><span class="thumb-tooltip dashboard-activity-info-channel" data-toggle="popover" data-img="${data['channel_thumb']}" data-height="40" data-width="40">${data['channel_call_sign']} ${data['channel_identifier']}</span>
+                    <br /><span class="thumb-tooltip dashboard-activity-info-channel" data-toggle="popover" data-img="${data['channel_thumb']}" data-height="40" data-width="40">${data['channel_title'] or (data['channel_vcn'] + ' ' + data['channel_call_sign'])}</span>
                     % elif data['view_offset']:
                     ETA:
                     <span id="stream-eta-${sk}">
diff --git a/data/interfaces/default/info.html b/data/interfaces/default/info.html
index 87c8f9d8..11b8e5f0 100644
--- a/data/interfaces/default/info.html
+++ b/data/interfaces/default/info.html
@@ -408,8 +408,8 @@ DOCUMENTATION :: END
                                 % endif
                             </div>
                             <div class="summary-content-details-tag" id="channel-icon">
-                                % if media_info['channel_identifier']:
-                                Channel <strong> <span class="thumb-tooltip" data-toggle="popover" data-img="${media_info['channel_thumb']}" data-height="40" data-width="40">${media_info['channel_call_sign']} ${media_info['channel_identifier']}</span> </strong>
+                                % if media_info['channel_vcn']:
+                                Channel <strong> <span class="thumb-tooltip" data-toggle="popover" data-img="${media_info['channel_thumb']}" data-height="40" data-width="40">${media_info['channel_title'] or (media_info['channel_vcn'] + ' ' + media_info['channel_call_sign'])}</span> </strong>
                                 % endif
                             </div>
                         </div>

From 3dc6d226f831274b7503d8e4e92bab5a22dcba1a Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 1 Apr 2024 17:06:25 -0700
Subject: [PATCH 575/743] Add live tv channel keys to database

---
 plexpy/__init__.py           | 36 ++++++++++++++++++++++++++++++++++--
 plexpy/activity_processor.py |  6 ++++++
 2 files changed, 40 insertions(+), 2 deletions(-)

diff --git a/plexpy/__init__.py b/plexpy/__init__.py
index 2590c867..10d153d1 100644
--- a/plexpy/__init__.py
+++ b/plexpy/__init__.py
@@ -660,7 +660,8 @@ def dbcheck():
         "transcode_hw_decoding INTEGER, transcode_hw_encoding INTEGER, "
         "optimized_version INTEGER, optimized_version_profile TEXT, optimized_version_title TEXT, "
         "synced_version INTEGER, synced_version_profile TEXT, "
-        "live INTEGER, live_uuid TEXT, channel_call_sign TEXT, channel_identifier TEXT, channel_thumb TEXT, "
+        "live INTEGER, live_uuid TEXT, "
+        "channel_call_sign TEXT, channel_id TEXT, channel_identifier TEXT, channel_title TEXT, channel_thumb TEXT, channel_vcn TEXT, "
         "secure INTEGER, relayed INTEGER, "
         "buffer_count INTEGER DEFAULT 0, buffer_last_triggered INTEGER, last_paused INTEGER, watched INTEGER DEFAULT 0, "
         "intro INTEGER DEFAULT 0, credits INTEGER DEFAULT 0, commercial INTEGER DEFAULT 0, marker INTEGER DEFAULT 0, "
@@ -721,7 +722,8 @@ def dbcheck():
         "art TEXT, media_type TEXT, year INTEGER, originally_available_at TEXT, added_at INTEGER, updated_at INTEGER, "
         "last_viewed_at INTEGER, content_rating TEXT, summary TEXT, tagline TEXT, rating TEXT, "
         "duration INTEGER DEFAULT 0, guid TEXT, directors TEXT, writers TEXT, actors TEXT, genres TEXT, studio TEXT, "
-        "labels TEXT, live INTEGER DEFAULT 0, channel_call_sign TEXT, channel_identifier TEXT, channel_thumb TEXT, "
+        "labels TEXT, live INTEGER DEFAULT 0, "
+        "channel_call_sign TEXT, channel_id TEXT, channel_identifier TEXT, channel_title TEXT, channel_thumb TEXT, channel_vcn TEXT, "
         "marker_credits_first INTEGER DEFAULT NULL, marker_credits_final INTEGER DEFAULT NULL)"
     )
 
@@ -1443,6 +1445,21 @@ def dbcheck():
             "ALTER TABLE sessions ADD COLUMN marker INTEGER DEFAULT 0"
         )
 
+    # Upgrade sessions table from earlier versions
+    try:
+        c_db.execute("SELECT channel_id FROM sessions")
+    except sqlite3.OperationalError:
+        logger.debug("Altering database. Updating database table sessions.")
+        c_db.execute(
+            "ALTER TABLE sessions ADD COLUMN channel_id TEXT"
+        )
+        c_db.execute(
+            "ALTER TABLE sessions ADD COLUMN channel_title TEXT"
+        )
+        c_db.execute(
+            "ALTER TABLE sessions ADD COLUMN channel_vcn TEXT"
+        )
+
     # Upgrade session_history table from earlier versions
     try:
         c_db.execute("SELECT reference_id FROM session_history")
@@ -1583,6 +1600,21 @@ def dbcheck():
             "ALTER TABLE session_history_metadata ADD COLUMN marker_credits_final INTEGER DEFAULT NULL"
         )
 
+    # Upgrade session_history_metadata table from earlier versions
+    try:
+        c_db.execute("SELECT channel_id FROM session_history_metadata")
+    except sqlite3.OperationalError:
+        logger.debug("Altering database. Updating database table session_history_metadata.")
+        c_db.execute(
+            "ALTER TABLE session_history_metadata ADD COLUMN channel_id TEXT"
+        )
+        c_db.execute(
+            "ALTER TABLE session_history_metadata ADD COLUMN channel_title TEXT"
+        )
+        c_db.execute(
+            "ALTER TABLE session_history_metadata ADD COLUMN channel_vcn TEXT"
+        )
+
     # Upgrade session_history_media_info table from earlier versions
     try:
         c_db.execute("SELECT transcode_decision FROM session_history_media_info")
diff --git a/plexpy/activity_processor.py b/plexpy/activity_processor.py
index 0de08564..96982101 100644
--- a/plexpy/activity_processor.py
+++ b/plexpy/activity_processor.py
@@ -150,8 +150,11 @@ class ActivityProcessor(object):
                       'rating_key_websocket': session.get('rating_key_websocket', ''),
                       'raw_stream_info': json.dumps(session),
                       'channel_call_sign': session.get('channel_call_sign', ''),
+                      'channel_id': session.get('channel_id', ''),
                       'channel_identifier': session.get('channel_identifier', ''),
+                      'channel_title': session.get('channel_title', ''),
                       'channel_thumb': session.get('channel_thumb', ''),
+                      'channel_vcn': session.get('channel_vcn', ''),
                       'stopped': helpers.timestamp()
                       }
 
@@ -470,8 +473,11 @@ class ActivityProcessor(object):
                           'labels': labels,
                           'live': session['live'],
                           'channel_call_sign': media_info.get('channel_call_sign', ''),
+                          'channel_id': media_info.get('channel_id', ''),
                           'channel_identifier': media_info.get('channel_identifier', ''),
+                          'channel_title': media_info.get('channel_title', ''),
                           'channel_thumb': media_info.get('channel_thumb', ''),
+                          'channel_vcn': media_info.get('channel_vcn', ''),
                           'marker_credits_first': marker_credits_first,
                           'marker_credits_final': marker_credits_final
                           }

From e3245bc1260a37ec406adee30ffefb3d9df70f69 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 1 Apr 2024 19:02:13 -0700
Subject: [PATCH 576/743] Add live tv channel keys notification parameters

---
 plexpy/common.py               |  5 ++++-
 plexpy/datafactory.py          | 10 +++++++---
 plexpy/notification_handler.py |  3 +++
 3 files changed, 14 insertions(+), 4 deletions(-)

diff --git a/plexpy/common.py b/plexpy/common.py
index b87caffd..10679449 100644
--- a/plexpy/common.py
+++ b/plexpy/common.py
@@ -437,8 +437,11 @@ NOTIFICATION_PARAMETERS = [
              {'name': 'Credits Marker First', 'type': 'int', 'value': 'credits_marker_first', 'description': 'If the marker is the first credits marker.', 'example': '0 or 1'},
              {'name': 'Credits Marker Final', 'type': 'int', 'value': 'credits_marker_final', 'description': 'If the marker is the final credits marker.', 'example': '0 or 1'},
              {'name': 'Channel Call Sign', 'type': 'str', 'value': 'channel_call_sign', 'description': 'The Live TV channel call sign.'},
-             {'name': 'Channel Identifier', 'type': 'str', 'value': 'channel_identifier', 'description': 'The Live TV channel number.'},
+             {'name': 'Channel ID', 'type': 'str', 'value': 'channel_id', 'description': 'The Live TV channel number.'},
+             {'name': 'Channel Identifier', 'type': 'str', 'value': 'channel_identifier', 'description': 'The Live TV channel identifier.'},
+             {'name': 'Channel Title', 'type': 'str', 'value': 'channel_title', 'description': 'The Live TV channel title.'},
              {'name': 'Channel Thumb', 'type': 'str', 'value': 'channel_thumb', 'description': 'The URL for the Live TV channel logo.'},
+             {'name': 'Channel VCN', 'type': 'str', 'value': 'channel_title', 'description': 'The Live TV tuner channel number.'},
              {'name': 'Secure', 'type': 'int', 'value': 'secure', 'description': 'If the stream is using a secure connection.', 'example': '0 or 1'},
              {'name': 'Relayed', 'type': 'int', 'value': 'relayed', 'description': 'If the stream is using Plex Relay.', 'example': '0 or 1'},
              {'name': 'Stream Local', 'type': 'int', 'value': 'stream_local', 'description': 'If the stream is local.', 'example': '0 or 1'},
diff --git a/plexpy/datafactory.py b/plexpy/datafactory.py
index b3c6b138..041c3e41 100644
--- a/plexpy/datafactory.py
+++ b/plexpy/datafactory.py
@@ -1539,8 +1539,9 @@ class DataFactory(object):
                     "session_history_media_info.video_full_resolution, " \
                     "session_history_media_info.video_framerate, session_history_media_info.audio_codec, " \
                     "session_history_media_info.audio_channels, session_history_metadata.live, " \
-                    "session_history_metadata.channel_call_sign, session_history_metadata.channel_identifier, " \
-                    "session_history_metadata.channel_thumb " \
+                    "session_history_metadata.channel_call_sign, session_history_metadata.channel_id, " \
+                    "session_history_metadata.channel_identifier, session_history_metadata.channel_title, " \
+                    "session_history_metadata.channel_thumb, session_history_metadata.channel_vcn " \
                     "FROM session_history_metadata " \
                     "JOIN library_sections ON session_history.section_id = library_sections.section_id " \
                     "JOIN session_history ON session_history_metadata.id = session_history.id " \
@@ -1570,8 +1571,11 @@ class DataFactory(object):
                            'audio_codec': item['audio_codec'],
                            'audio_channels': item['audio_channels'],
                            'channel_call_sign': item['channel_call_sign'],
+                           'channel_id': item['channel_id'],
                            'channel_identifier': item['channel_identifier'],
-                           'channel_thumb': item['channel_thumb']
+                           'channel_title': item['channel_title'],
+                           'channel_thumb': item['channel_thumb'],
+                           'channel_vcn': item['channel_vcn']
                            }]
 
             metadata = {'media_type': item['media_type'],
diff --git a/plexpy/notification_handler.py b/plexpy/notification_handler.py
index b2780835..c58bae9a 100644
--- a/plexpy/notification_handler.py
+++ b/plexpy/notification_handler.py
@@ -1047,8 +1047,11 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
         'credits_marker_first': helpers.cast_to_int(marker['first']),
         'credits_marker_final': helpers.cast_to_int(marker['final']),
         'channel_call_sign': notify_params['channel_call_sign'],
+        'channel_id': notify_params['channel_id'],
         'channel_identifier': notify_params['channel_identifier'],
+        'channel_title': notify_params['channel_title'],
         'channel_thumb': notify_params['channel_thumb'],
+        'channel_vcn': notify_params['channel_vcn'],
         'secure': 'unknown' if notify_params['secure'] is None else notify_params['secure'],
         'relayed': notify_params['relayed'],
         'stream_local': notify_params['local'],

From 10e62ca42d40a0872c8ed09e16f5092bbd837fd5 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 1 Apr 2024 17:35:40 -0700
Subject: [PATCH 577/743] Fix stats on live tv info pages

---
 data/interfaces/default/info.html | 14 ++++++++---
 plexpy/datafactory.py             | 40 ++++++++++++++++++++++++++++---
 plexpy/webserve.py                | 12 +++++-----
 3 files changed, 54 insertions(+), 12 deletions(-)

diff --git a/data/interfaces/default/info.html b/data/interfaces/default/info.html
index 11b8e5f0..ead534a1 100644
--- a/data/interfaces/default/info.html
+++ b/data/interfaces/default/info.html
@@ -878,7 +878,7 @@ DOCUMENTATION :: END
                     transcode_decision: transcode_decision,
                     user_id: "${history_user_id}",
                     % if data['live']:
-                    guid: "${data['guid']}
+                    guid: "${data['guid']}"
                     % elif data['media_type'] in ('show', 'artist'):
                     grandparent_rating_key: "${data['rating_key']}"
                     % elif data['media_type'] in ('season', 'album'):
@@ -947,8 +947,12 @@ DOCUMENTATION :: END
         url: 'item_watch_time_stats',
         async: true,
         data: { 
+            % if data['live']:
+            guid: "${data['guid']}"
+            % else:
             rating_key: "${data['rating_key']}",
-            media_type: "${data['media_type']}"    
+            media_type: "${data['media_type']}"
+            % endif
         },
         complete: function(xhr, status) {
             $("#watch-time-stats").html(xhr.responseText);
@@ -959,8 +963,12 @@ DOCUMENTATION :: END
         url: 'item_user_stats',
         async: true,
         data: { 
+            % if data['live']:
+            guid: "${data['guid']}"
+            % else:
             rating_key: "${data['rating_key']}",
-            media_type: "${data['media_type']}"    
+            media_type: "${data['media_type']}"
+            % endif
         },
         complete: function(xhr, status) {
             $("#user-stats").html(xhr.responseText);
diff --git a/plexpy/datafactory.py b/plexpy/datafactory.py
index 041c3e41..d525c9c9 100644
--- a/plexpy/datafactory.py
+++ b/plexpy/datafactory.py
@@ -1203,8 +1203,8 @@ class DataFactory(object):
 
         return library_stats
 
-    def get_watch_time_stats(self, rating_key=None, media_type=None, grouping=None, query_days=None):
-        if rating_key is None:
+    def get_watch_time_stats(self, rating_key=None, guid=None, media_type=None, grouping=None, query_days=None):
+        if rating_key is None and guid is None:
             return []
 
         if grouping is None:
@@ -1253,6 +1253,16 @@ class DataFactory(object):
                                 )
                         
                         result = monitor_db.select(query, args=[timestamp_query] + rating_keys * 3)
+                    elif guid:
+                        query = "SELECT (SUM(stopped - started) - " \
+                                "SUM(CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END)) AS total_time, " \
+                                "COUNT(DISTINCT %s) AS total_plays, section_id " \
+                                "FROM session_history " \
+                                "JOIN session_history_metadata ON session_history_metadata.id = session_history.id " \
+                                "WHERE stopped >= ? " \
+                                "AND session_history_metadata.guid = ? " % group_by
+
+                        result = monitor_db.select(query, args=[timestamp_query, guid])
                     else:
                         result = []
                 else:
@@ -1269,6 +1279,15 @@ class DataFactory(object):
                                 )
                         
                         result = monitor_db.select(query, args=rating_keys * 3)
+                    elif guid:
+                        query = "SELECT (SUM(stopped - started) - " \
+                                "SUM(CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END)) AS total_time, " \
+                                "COUNT(DISTINCT %s) AS total_plays, section_id " \
+                                "FROM session_history " \
+                                "JOIN session_history_metadata ON session_history_metadata.id = session_history.id " \
+                                "WHERE session_history_metadata.guid = ? " % group_by
+
+                        result = monitor_db.select(query, args=[guid])
                     else:
                         result = []
             except Exception as e:
@@ -1297,7 +1316,7 @@ class DataFactory(object):
 
         return item_watch_time_stats
 
-    def get_user_stats(self, rating_key=None, media_type=None, grouping=None):
+    def get_user_stats(self, rating_key=None, guid=None, media_type=None, grouping=None):
         if grouping is None:
             grouping = plexpy.CONFIG.GROUP_HISTORY_TABLES
 
@@ -1338,6 +1357,21 @@ class DataFactory(object):
                         )
 
                 result = monitor_db.select(query, args=rating_keys * 3)
+            elif guid:
+                query = "SELECT (CASE WHEN users.friendly_name IS NULL OR TRIM(users.friendly_name) = '' " \
+                        "THEN users.username ELSE users.friendly_name END) AS friendly_name, " \
+                        "users.user_id, users.username, users.thumb, users.custom_avatar_url AS custom_thumb, " \
+                        "COUNT(DISTINCT %s) AS total_plays, (SUM(stopped - started) - " \
+                        "SUM(CASE WHEN paused_counter IS NULL THEN 0 ELSE paused_counter END)) AS total_time, " \
+                        "section_id " \
+                        "FROM session_history " \
+                        "JOIN session_history_metadata ON session_history_metadata.id = session_history.id " \
+                        "JOIN users ON users.user_id = session_history.user_id " \
+                        "WHERE session_history_metadata.guid = ? " \
+                        "GROUP BY users.user_id " \
+                        "ORDER BY total_plays DESC, total_time DESC" % group_by
+
+                result = monitor_db.select(query, args=[guid])
             else:
                 result = []
         except Exception as e:
diff --git a/plexpy/webserve.py b/plexpy/webserve.py
index 87196b12..7e0c083b 100644
--- a/plexpy/webserve.py
+++ b/plexpy/webserve.py
@@ -4497,10 +4497,10 @@ class WebInterface(object):
 
     @cherrypy.expose
     @requireAuth()
-    def item_watch_time_stats(self, rating_key=None, media_type=None, **kwargs):
-        if rating_key:
+    def item_watch_time_stats(self, rating_key=None, guid=None, media_type=None, **kwargs):
+        if rating_key or guid:
             item_data = datafactory.DataFactory()
-            result = item_data.get_watch_time_stats(rating_key=rating_key, media_type=media_type)
+            result = item_data.get_watch_time_stats(rating_key=rating_key, guid=guid, media_type=media_type)
         else:
             result = None
 
@@ -4512,10 +4512,10 @@ class WebInterface(object):
 
     @cherrypy.expose
     @requireAuth()
-    def item_user_stats(self, rating_key=None, media_type=None, **kwargs):
-        if rating_key:
+    def item_user_stats(self, rating_key=None, guid=None, media_type=None, **kwargs):
+        if rating_key or guid:
             item_data = datafactory.DataFactory()
-            result = item_data.get_user_stats(rating_key=rating_key, media_type=media_type)
+            result = item_data.get_user_stats(rating_key=rating_key, guid=guid, media_type=media_type)
         else:
             result = None
 

From 4582ff4a568f0e5a2d6942203bdc1e799ed8ec07 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 1 Apr 2024 21:47:33 -0700
Subject: [PATCH 578/743] Fix grouping live tv history

---
 plexpy/activity_processor.py | 24 +++++++++++++++---------
 1 file changed, 15 insertions(+), 9 deletions(-)

diff --git a/plexpy/activity_processor.py b/plexpy/activity_processor.py
index 96982101..89c75b4a 100644
--- a/plexpy/activity_processor.py
+++ b/plexpy/activity_processor.py
@@ -494,11 +494,13 @@ class ActivityProcessor(object):
         prev_watched = None
 
         if session['live']:
-            # Check if we should group the session, select the last guid from the user
+            # Check if we should group the session, select the last guid from the user within the last day
             query = "SELECT session_history.id, session_history_metadata.guid, session_history.reference_id " \
                     "FROM session_history " \
                     "JOIN session_history_metadata ON session_history.id == session_history_metadata.id " \
-                    "WHERE session_history.id <= ? AND session_history.user_id = ? ORDER BY session_history.id DESC LIMIT 1 "
+                    "WHERE session_history.id <= ? AND session_history.user_id = ? " \
+                    "AND datetime(session_history.started, 'unixepoch', 'localtime') > datetime('now', '-1 day') " \
+                    "ORDER BY session_history.id DESC LIMIT 1 "
 
             args = [last_id, session['user_id']]
 
@@ -506,12 +508,14 @@ class ActivityProcessor(object):
 
             if len(result) > 0:
                 new_session = {'id': last_id,
-                                'guid': metadata['guid'] if metadata else session['guid'],
-                                'reference_id': last_id}
+                               'guid': metadata['guid'] if metadata else session['guid'],
+                               'reference_id': last_id}
 
                 prev_session = {'id': result[0]['id'],
                                 'guid': result[0]['guid'],
                                 'reference_id': result[0]['reference_id']}
+                
+                prev_watched = False
 
         else:
             # Check if we should group the session, select the last two rows from the user
@@ -524,9 +528,9 @@ class ActivityProcessor(object):
 
             if len(result) > 1:
                 new_session = {'id': result[0]['id'],
-                                'rating_key': result[0]['rating_key'],
-                                'view_offset': helpers.cast_to_int(result[0]['view_offset']),
-                                'reference_id': result[0]['reference_id']}
+                               'rating_key': result[0]['rating_key'],
+                               'view_offset': helpers.cast_to_int(result[0]['view_offset']),
+                               'reference_id': result[0]['reference_id']}
 
                 prev_session = {'id': result[1]['id'],
                                 'rating_key': result[1]['rating_key'],
@@ -550,8 +554,10 @@ class ActivityProcessor(object):
         # and new session view offset is greater,
         # then set the reference_id to the previous row,
         # else set the reference_id to the new id
-        if (prev_watched is False and prev_session['view_offset'] <= new_session['view_offset'] or 
-                session['live'] and prev_session['guid'] == new_session['guid']):
+        if prev_watched is False and (
+            not session['live'] and prev_session['view_offset'] <= new_session['view_offset'] or 
+            session['live'] and prev_session['guid'] == new_session['guid']
+        ):
             if metadata:
                 logger.debug("Tautulli ActivityProcessor :: Grouping history for sessionKey %s", session['session_key'])
             args = [prev_session['reference_id'], new_session['id']]

From 282810e9ca403a43e30d85148ad00301abc9fd3d Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 4 Apr 2024 22:57:17 -0700
Subject: [PATCH 579/743] Increase Remote app PBKDF2 iterations to 600,000 and
 SHA256 hash

OWASP Cheat Sheet recommends 600,000 iterations for SHA256.

https://cheatsheetseries.owasp.org/cheatsheets/Password_Storage_Cheat_Sheet.html#pbkdf2
---
 plexpy/notifiers.py | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/plexpy/notifiers.py b/plexpy/notifiers.py
index bf033a9f..d871e679 100644
--- a/plexpy/notifiers.py
+++ b/plexpy/notifiers.py
@@ -44,14 +44,14 @@ try:
     from Cryptodome.Protocol.KDF import PBKDF2
     from Cryptodome.Cipher import AES
     from Cryptodome.Random import get_random_bytes
-    from Cryptodome.Hash import HMAC, SHA1
+    from Cryptodome.Hash import SHA256
     CRYPTODOME = True
 except ImportError:
     try:
         from Crypto.Protocol.KDF import PBKDF2
         from Crypto.Cipher import AES
         from Crypto.Random import get_random_bytes
-        from Crypto.Hash import HMAC, SHA1
+        from Crypto.Hash import SHA256
         CRYPTODOME = True
     except ImportError:
         CRYPTODOME = False
@@ -3825,9 +3825,8 @@ class TAUTULLIREMOTEAPP(Notifier):
             salt = get_random_bytes(16)
             passphrase = device['device_token']
             key_length = 32  # AES256
-            iterations = 1000
-            key = PBKDF2(passphrase, salt, dkLen=key_length, count=iterations,
-                         prf=lambda p, s: HMAC.new(p, s, SHA1).digest())
+            iterations = 600000
+            key = PBKDF2(passphrase, salt, dkLen=key_length, count=iterations, hmac_hash_module=SHA256)
 
             #logger.debug("Encryption key (base64): {}".format(base64.b64encode(key)))
 
@@ -3846,6 +3845,7 @@ class TAUTULLIREMOTEAPP(Notifier):
                        'include_player_ids': [device['onesignal_id']],
                        'contents': {'en': 'Tautulli Notification'},
                        'data': {'encrypted': True,
+                                'version': 2,
                                 'cipher_text': base64.b64encode(encrypted_data),
                                 'nonce': base64.b64encode(nonce),
                                 'salt': base64.b64encode(salt),

From 2258a88168caf444b3154aa27eeb673df19d91fc Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 7 Apr 2024 15:58:01 -0700
Subject: [PATCH 580/743] Use metadata from session for stale live tv sessions

---
 plexpy/activity_processor.py | 19 +++++++++++--------
 1 file changed, 11 insertions(+), 8 deletions(-)

diff --git a/plexpy/activity_processor.py b/plexpy/activity_processor.py
index 89c75b4a..d2b4b163 100644
--- a/plexpy/activity_processor.py
+++ b/plexpy/activity_processor.py
@@ -272,6 +272,7 @@ class ActivityProcessor(object):
                 logger.debug("Tautulli ActivityProcessor :: History logging for library '%s' is disabled." % library_details['section_name'])
 
             if logging_enabled:
+                media_info = {}
 
                 # Fetch metadata first so we can return false if it fails
                 if not is_import:
@@ -283,10 +284,12 @@ class ActivityProcessor(object):
                                                                     return_cache=True)
                     else:
                         metadata = pms_connect.get_metadata_details(rating_key=str(session['rating_key']))
-                    if not metadata:
+
+                    if session['live'] and not metadata:
+                        metadata = session
+                    elif not metadata:
                         return False
                     else:
-                        media_info = {}
                         if 'media_info' in metadata and len(metadata['media_info']) > 0:
                             media_info = metadata['media_info'][0]
                 else:
@@ -472,12 +475,12 @@ class ActivityProcessor(object):
                           'studio': metadata['studio'],
                           'labels': labels,
                           'live': session['live'],
-                          'channel_call_sign': media_info.get('channel_call_sign', ''),
-                          'channel_id': media_info.get('channel_id', ''),
-                          'channel_identifier': media_info.get('channel_identifier', ''),
-                          'channel_title': media_info.get('channel_title', ''),
-                          'channel_thumb': media_info.get('channel_thumb', ''),
-                          'channel_vcn': media_info.get('channel_vcn', ''),
+                          'channel_call_sign': media_info.get('channel_call_sign', session.get('channel_call_sign', '')),
+                          'channel_id': media_info.get('channel_id', session.get('channel_id', '')),
+                          'channel_identifier': media_info.get('channel_identifier', session.get('channel_identifier', '')),
+                          'channel_title': media_info.get('channel_title', session.get('channel_title', '')),
+                          'channel_thumb': media_info.get('channel_thumb', session.get('channel_thumb', '')),
+                          'channel_vcn': media_info.get('channel_vcn', session.get('channel_vcn', '')),
                           'marker_credits_first': marker_credits_first,
                           'marker_credits_final': marker_credits_final
                           }

From 6a9e5328058c2c984f812aed9a85487418d2cd89 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 7 Apr 2024 15:58:28 -0700
Subject: [PATCH 581/743] Change path join for session metadata cache

---
 plexpy/activity_handler.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/plexpy/activity_handler.py b/plexpy/activity_handler.py
index 01161649..e98b881f 100644
--- a/plexpy/activity_handler.py
+++ b/plexpy/activity_handler.py
@@ -746,7 +746,7 @@ def on_created(rating_key, **kwargs):
 
 def delete_metadata_cache(session_key):
     try:
-        os.remove(os.path.join(plexpy.CONFIG.CACHE_DIR, 'session_metadata/metadata-sessionKey-%s.json' % session_key))
+        os.remove(os.path.join(plexpy.CONFIG.CACHE_DIR, 'session_metadata', 'metadata-sessionKey-%s.json' % session_key))
     except OSError as e:
         logger.error("Tautulli ActivityHandler :: Failed to remove metadata cache file (sessionKey %s): %s"
                      % (session_key, e))

From 80984bd29667e5365e728a7f9a94e2a93a1c27f3 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 18 Apr 2024 13:01:09 -0700
Subject: [PATCH 582/743] Bump mako from 1.3.2 to 1.3.3 (#2303)

* Bump mako from 1.3.2 to 1.3.3

Bumps [mako](https://github.com/sqlalchemy/mako) from 1.3.2 to 1.3.3.
- [Release notes](https://github.com/sqlalchemy/mako/releases)
- [Changelog](https://github.com/sqlalchemy/mako/blob/main/CHANGES)
- [Commits](https://github.com/sqlalchemy/mako/commits)

---
updated-dependencies:
- dependency-name: mako
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

* Update mako==1.3.3

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/mako/__init__.py |  2 +-
 lib/mako/codegen.py  | 26 +++++++++++++++++++-------
 lib/mako/pyparser.py | 20 ++++++++++++++++++++
 requirements.txt     |  2 +-
 4 files changed, 41 insertions(+), 9 deletions(-)

diff --git a/lib/mako/__init__.py b/lib/mako/__init__.py
index d022cf82..5811e68c 100644
--- a/lib/mako/__init__.py
+++ b/lib/mako/__init__.py
@@ -5,4 +5,4 @@
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
 
 
-__version__ = "1.3.2"
+__version__ = "1.3.3"
diff --git a/lib/mako/codegen.py b/lib/mako/codegen.py
index ce6f83aa..b9fea937 100644
--- a/lib/mako/codegen.py
+++ b/lib/mako/codegen.py
@@ -838,13 +838,24 @@ class _GenerateRenderMethod:
                 text = node.text
             self.printer.writeline(text)
             children = node.get_children()
-            # this covers the three situations where we want to insert a pass:
-            #    1) a ternary control line with no children,
-            #    2) a primary control line with nothing but its own ternary
-            #          and end control lines, and
-            #    3) any control line with no content other than comments
-            if not children or (
-                all(
+
+            # this covers the four situations where we want to insert a pass:
+            # 1) a ternary control line with no children,
+            # 2) a primary control line with nothing but its own ternary
+            #       and end control lines, and
+            # 3) any control line with no content other than comments
+            # 4) the first control block with no content other than comments
+            def _search_for_control_line():
+                for c in children:
+                    if isinstance(c, parsetree.Comment):
+                        continue
+                    elif isinstance(c, parsetree.ControlLine):
+                        return True
+                    return False
+
+            if (
+                not children
+                or all(
                     isinstance(c, (parsetree.Comment, parsetree.ControlLine))
                     for c in children
                 )
@@ -853,6 +864,7 @@ class _GenerateRenderMethod:
                     for c in children
                     if isinstance(c, parsetree.ControlLine)
                 )
+                or _search_for_control_line()
             ):
                 self.printer.writeline("pass")
 
diff --git a/lib/mako/pyparser.py b/lib/mako/pyparser.py
index 9b63dc33..b25ef6e4 100644
--- a/lib/mako/pyparser.py
+++ b/lib/mako/pyparser.py
@@ -90,6 +90,26 @@ class FindIdentifiers(_ast_util.NodeVisitor):
         self._add_declared(node.name)
         self._visit_function(node, False)
 
+    def visit_ListComp(self, node):
+        if self.in_function:
+            if not isinstance(node.elt, _ast.Name):
+                self.visit(node.elt)
+            for comp in node.generators:
+                self.visit(comp.iter)
+        else:
+            self.generic_visit(node)
+
+    visit_SetComp = visit_GeneratorExp = visit_ListComp
+
+    def visit_DictComp(self, node):
+        if self.in_function:
+            if not isinstance(node.key, _ast.Name):
+                self.visit(node.elt)
+            for comp in node.generators:
+                self.visit(comp.iter)
+        else:
+            self.generic_visit(node)
+
     def _expand_tuples(self, args):
         for arg in args:
             if isinstance(arg, _ast.Tuple):
diff --git a/requirements.txt b/requirements.txt
index af94378a..8d9ca973 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -22,7 +22,7 @@ importlib-metadata==7.1.0
 importlib-resources==6.4.0
 git+https://github.com/Tautulli/ipwhois.git@master#egg=ipwhois
 IPy==1.01
-Mako==1.3.2
+Mako==1.3.3
 MarkupSafe==2.1.5
 musicbrainzngs==0.7.1
 packaging==24.0

From 07166ae6b277e6ada69a1887fa0e08bda2e568db Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 18 Apr 2024 13:01:25 -0700
Subject: [PATCH 583/743] Bump idna from 3.6 to 3.7 (#2304)

* Bump idna from 3.6 to 3.7

Bumps [idna](https://github.com/kjd/idna) from 3.6 to 3.7.
- [Release notes](https://github.com/kjd/idna/releases)
- [Changelog](https://github.com/kjd/idna/blob/master/HISTORY.rst)
- [Commits](https://github.com/kjd/idna/compare/v3.6...v3.7)

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

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

* Update idna==3.7

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/idna/core.py         |   23 +-
 lib/idna/idnadata.py     | 2197 +++++++++++++++++++++++++++++++++++++-
 lib/idna/package_data.py |    2 +-
 requirements.txt         |    2 +-
 4 files changed, 2157 insertions(+), 67 deletions(-)

diff --git a/lib/idna/core.py b/lib/idna/core.py
index aaf7d658..0dae61ac 100644
--- a/lib/idna/core.py
+++ b/lib/idna/core.py
@@ -150,9 +150,11 @@ def valid_contextj(label: str, pos: int) -> bool:
             joining_type = idnadata.joining_types.get(ord(label[i]))
             if joining_type == ord('T'):
                 continue
-            if joining_type in [ord('L'), ord('D')]:
+            elif joining_type in [ord('L'), ord('D')]:
                 ok = True
                 break
+            else:
+                break
 
         if not ok:
             return False
@@ -162,9 +164,11 @@ def valid_contextj(label: str, pos: int) -> bool:
             joining_type = idnadata.joining_types.get(ord(label[i]))
             if joining_type == ord('T'):
                 continue
-            if joining_type in [ord('R'), ord('D')]:
+            elif joining_type in [ord('R'), ord('D')]:
                 ok = True
                 break
+            else:
+                break
         return ok
 
     if cp_value == 0x200d:
@@ -236,12 +240,8 @@ def check_label(label: Union[str, bytes, bytearray]) -> None:
         if intranges_contain(cp_value, idnadata.codepoint_classes['PVALID']):
             continue
         elif intranges_contain(cp_value, idnadata.codepoint_classes['CONTEXTJ']):
-            try:
-                if not valid_contextj(label, pos):
-                    raise InvalidCodepointContext('Joiner {} not allowed at position {} in {}'.format(
-                        _unot(cp_value), pos+1, repr(label)))
-            except ValueError:
-                raise IDNAError('Unknown codepoint adjacent to joiner {} at position {} in {}'.format(
+            if not valid_contextj(label, pos):
+                raise InvalidCodepointContext('Joiner {} not allowed at position {} in {}'.format(
                     _unot(cp_value), pos+1, repr(label)))
         elif intranges_contain(cp_value, idnadata.codepoint_classes['CONTEXTO']):
             if not valid_contexto(label, pos):
@@ -262,13 +262,8 @@ def alabel(label: str) -> bytes:
     except UnicodeEncodeError:
         pass
 
-    if not label:
-        raise IDNAError('No Input')
-
-    label = str(label)
     check_label(label)
-    label_bytes = _punycode(label)
-    label_bytes = _alabel_prefix + label_bytes
+    label_bytes = _alabel_prefix + _punycode(label)
 
     if not valid_label_length(label_bytes):
         raise IDNAError('Label too long')
diff --git a/lib/idna/idnadata.py b/lib/idna/idnadata.py
index 5cd05d90..c61dcf97 100644
--- a/lib/idna/idnadata.py
+++ b/lib/idna/idnadata.py
@@ -101,16 +101,190 @@ scripts = {
     ),
 }
 joining_types = {
-    0x600: 85,
-    0x601: 85,
-    0x602: 85,
-    0x603: 85,
-    0x604: 85,
-    0x605: 85,
-    0x608: 85,
-    0x60b: 85,
+    0xad: 84,
+    0x300: 84,
+    0x301: 84,
+    0x302: 84,
+    0x303: 84,
+    0x304: 84,
+    0x305: 84,
+    0x306: 84,
+    0x307: 84,
+    0x308: 84,
+    0x309: 84,
+    0x30a: 84,
+    0x30b: 84,
+    0x30c: 84,
+    0x30d: 84,
+    0x30e: 84,
+    0x30f: 84,
+    0x310: 84,
+    0x311: 84,
+    0x312: 84,
+    0x313: 84,
+    0x314: 84,
+    0x315: 84,
+    0x316: 84,
+    0x317: 84,
+    0x318: 84,
+    0x319: 84,
+    0x31a: 84,
+    0x31b: 84,
+    0x31c: 84,
+    0x31d: 84,
+    0x31e: 84,
+    0x31f: 84,
+    0x320: 84,
+    0x321: 84,
+    0x322: 84,
+    0x323: 84,
+    0x324: 84,
+    0x325: 84,
+    0x326: 84,
+    0x327: 84,
+    0x328: 84,
+    0x329: 84,
+    0x32a: 84,
+    0x32b: 84,
+    0x32c: 84,
+    0x32d: 84,
+    0x32e: 84,
+    0x32f: 84,
+    0x330: 84,
+    0x331: 84,
+    0x332: 84,
+    0x333: 84,
+    0x334: 84,
+    0x335: 84,
+    0x336: 84,
+    0x337: 84,
+    0x338: 84,
+    0x339: 84,
+    0x33a: 84,
+    0x33b: 84,
+    0x33c: 84,
+    0x33d: 84,
+    0x33e: 84,
+    0x33f: 84,
+    0x340: 84,
+    0x341: 84,
+    0x342: 84,
+    0x343: 84,
+    0x344: 84,
+    0x345: 84,
+    0x346: 84,
+    0x347: 84,
+    0x348: 84,
+    0x349: 84,
+    0x34a: 84,
+    0x34b: 84,
+    0x34c: 84,
+    0x34d: 84,
+    0x34e: 84,
+    0x34f: 84,
+    0x350: 84,
+    0x351: 84,
+    0x352: 84,
+    0x353: 84,
+    0x354: 84,
+    0x355: 84,
+    0x356: 84,
+    0x357: 84,
+    0x358: 84,
+    0x359: 84,
+    0x35a: 84,
+    0x35b: 84,
+    0x35c: 84,
+    0x35d: 84,
+    0x35e: 84,
+    0x35f: 84,
+    0x360: 84,
+    0x361: 84,
+    0x362: 84,
+    0x363: 84,
+    0x364: 84,
+    0x365: 84,
+    0x366: 84,
+    0x367: 84,
+    0x368: 84,
+    0x369: 84,
+    0x36a: 84,
+    0x36b: 84,
+    0x36c: 84,
+    0x36d: 84,
+    0x36e: 84,
+    0x36f: 84,
+    0x483: 84,
+    0x484: 84,
+    0x485: 84,
+    0x486: 84,
+    0x487: 84,
+    0x488: 84,
+    0x489: 84,
+    0x591: 84,
+    0x592: 84,
+    0x593: 84,
+    0x594: 84,
+    0x595: 84,
+    0x596: 84,
+    0x597: 84,
+    0x598: 84,
+    0x599: 84,
+    0x59a: 84,
+    0x59b: 84,
+    0x59c: 84,
+    0x59d: 84,
+    0x59e: 84,
+    0x59f: 84,
+    0x5a0: 84,
+    0x5a1: 84,
+    0x5a2: 84,
+    0x5a3: 84,
+    0x5a4: 84,
+    0x5a5: 84,
+    0x5a6: 84,
+    0x5a7: 84,
+    0x5a8: 84,
+    0x5a9: 84,
+    0x5aa: 84,
+    0x5ab: 84,
+    0x5ac: 84,
+    0x5ad: 84,
+    0x5ae: 84,
+    0x5af: 84,
+    0x5b0: 84,
+    0x5b1: 84,
+    0x5b2: 84,
+    0x5b3: 84,
+    0x5b4: 84,
+    0x5b5: 84,
+    0x5b6: 84,
+    0x5b7: 84,
+    0x5b8: 84,
+    0x5b9: 84,
+    0x5ba: 84,
+    0x5bb: 84,
+    0x5bc: 84,
+    0x5bd: 84,
+    0x5bf: 84,
+    0x5c1: 84,
+    0x5c2: 84,
+    0x5c4: 84,
+    0x5c5: 84,
+    0x5c7: 84,
+    0x610: 84,
+    0x611: 84,
+    0x612: 84,
+    0x613: 84,
+    0x614: 84,
+    0x615: 84,
+    0x616: 84,
+    0x617: 84,
+    0x618: 84,
+    0x619: 84,
+    0x61a: 84,
+    0x61c: 84,
     0x620: 68,
-    0x621: 85,
     0x622: 82,
     0x623: 82,
     0x624: 82,
@@ -152,12 +326,33 @@ joining_types = {
     0x648: 82,
     0x649: 68,
     0x64a: 68,
+    0x64b: 84,
+    0x64c: 84,
+    0x64d: 84,
+    0x64e: 84,
+    0x64f: 84,
+    0x650: 84,
+    0x651: 84,
+    0x652: 84,
+    0x653: 84,
+    0x654: 84,
+    0x655: 84,
+    0x656: 84,
+    0x657: 84,
+    0x658: 84,
+    0x659: 84,
+    0x65a: 84,
+    0x65b: 84,
+    0x65c: 84,
+    0x65d: 84,
+    0x65e: 84,
+    0x65f: 84,
     0x66e: 68,
     0x66f: 68,
+    0x670: 84,
     0x671: 82,
     0x672: 82,
     0x673: 82,
-    0x674: 85,
     0x675: 82,
     0x676: 82,
     0x677: 82,
@@ -254,7 +449,25 @@ joining_types = {
     0x6d2: 82,
     0x6d3: 82,
     0x6d5: 82,
-    0x6dd: 85,
+    0x6d6: 84,
+    0x6d7: 84,
+    0x6d8: 84,
+    0x6d9: 84,
+    0x6da: 84,
+    0x6db: 84,
+    0x6dc: 84,
+    0x6df: 84,
+    0x6e0: 84,
+    0x6e1: 84,
+    0x6e2: 84,
+    0x6e3: 84,
+    0x6e4: 84,
+    0x6e7: 84,
+    0x6e8: 84,
+    0x6ea: 84,
+    0x6eb: 84,
+    0x6ec: 84,
+    0x6ed: 84,
     0x6ee: 82,
     0x6ef: 82,
     0x6fa: 68,
@@ -263,6 +476,7 @@ joining_types = {
     0x6ff: 68,
     0x70f: 84,
     0x710: 82,
+    0x711: 84,
     0x712: 68,
     0x713: 68,
     0x714: 68,
@@ -293,6 +507,33 @@ joining_types = {
     0x72d: 68,
     0x72e: 68,
     0x72f: 82,
+    0x730: 84,
+    0x731: 84,
+    0x732: 84,
+    0x733: 84,
+    0x734: 84,
+    0x735: 84,
+    0x736: 84,
+    0x737: 84,
+    0x738: 84,
+    0x739: 84,
+    0x73a: 84,
+    0x73b: 84,
+    0x73c: 84,
+    0x73d: 84,
+    0x73e: 84,
+    0x73f: 84,
+    0x740: 84,
+    0x741: 84,
+    0x742: 84,
+    0x743: 84,
+    0x744: 84,
+    0x745: 84,
+    0x746: 84,
+    0x747: 84,
+    0x748: 84,
+    0x749: 84,
+    0x74a: 84,
     0x74d: 82,
     0x74e: 68,
     0x74f: 68,
@@ -344,6 +585,17 @@ joining_types = {
     0x77d: 68,
     0x77e: 68,
     0x77f: 68,
+    0x7a6: 84,
+    0x7a7: 84,
+    0x7a8: 84,
+    0x7a9: 84,
+    0x7aa: 84,
+    0x7ab: 84,
+    0x7ac: 84,
+    0x7ad: 84,
+    0x7ae: 84,
+    0x7af: 84,
+    0x7b0: 84,
     0x7ca: 68,
     0x7cb: 68,
     0x7cc: 68,
@@ -377,7 +629,38 @@ joining_types = {
     0x7e8: 68,
     0x7e9: 68,
     0x7ea: 68,
+    0x7eb: 84,
+    0x7ec: 84,
+    0x7ed: 84,
+    0x7ee: 84,
+    0x7ef: 84,
+    0x7f0: 84,
+    0x7f1: 84,
+    0x7f2: 84,
+    0x7f3: 84,
     0x7fa: 67,
+    0x7fd: 84,
+    0x816: 84,
+    0x817: 84,
+    0x818: 84,
+    0x819: 84,
+    0x81b: 84,
+    0x81c: 84,
+    0x81d: 84,
+    0x81e: 84,
+    0x81f: 84,
+    0x820: 84,
+    0x821: 84,
+    0x822: 84,
+    0x823: 84,
+    0x825: 84,
+    0x826: 84,
+    0x827: 84,
+    0x829: 84,
+    0x82a: 84,
+    0x82b: 84,
+    0x82c: 84,
+    0x82d: 84,
     0x840: 82,
     0x841: 68,
     0x842: 68,
@@ -403,13 +686,14 @@ joining_types = {
     0x856: 82,
     0x857: 82,
     0x858: 82,
+    0x859: 84,
+    0x85a: 84,
+    0x85b: 84,
     0x860: 68,
-    0x861: 85,
     0x862: 68,
     0x863: 68,
     0x864: 68,
     0x865: 68,
-    0x866: 85,
     0x867: 82,
     0x868: 68,
     0x869: 82,
@@ -437,16 +721,20 @@ joining_types = {
     0x884: 67,
     0x885: 67,
     0x886: 68,
-    0x887: 85,
-    0x888: 85,
     0x889: 68,
     0x88a: 68,
     0x88b: 68,
     0x88c: 68,
     0x88d: 68,
     0x88e: 82,
-    0x890: 85,
-    0x891: 85,
+    0x898: 84,
+    0x899: 84,
+    0x89a: 84,
+    0x89b: 84,
+    0x89c: 84,
+    0x89d: 84,
+    0x89e: 84,
+    0x89f: 84,
     0x8a0: 68,
     0x8a1: 68,
     0x8a2: 68,
@@ -460,7 +748,6 @@ joining_types = {
     0x8aa: 82,
     0x8ab: 82,
     0x8ac: 82,
-    0x8ad: 85,
     0x8ae: 82,
     0x8af: 68,
     0x8b0: 68,
@@ -488,11 +775,357 @@ joining_types = {
     0x8c6: 68,
     0x8c7: 68,
     0x8c8: 68,
-    0x8e2: 85,
-    0x1806: 85,
+    0x8ca: 84,
+    0x8cb: 84,
+    0x8cc: 84,
+    0x8cd: 84,
+    0x8ce: 84,
+    0x8cf: 84,
+    0x8d0: 84,
+    0x8d1: 84,
+    0x8d2: 84,
+    0x8d3: 84,
+    0x8d4: 84,
+    0x8d5: 84,
+    0x8d6: 84,
+    0x8d7: 84,
+    0x8d8: 84,
+    0x8d9: 84,
+    0x8da: 84,
+    0x8db: 84,
+    0x8dc: 84,
+    0x8dd: 84,
+    0x8de: 84,
+    0x8df: 84,
+    0x8e0: 84,
+    0x8e1: 84,
+    0x8e3: 84,
+    0x8e4: 84,
+    0x8e5: 84,
+    0x8e6: 84,
+    0x8e7: 84,
+    0x8e8: 84,
+    0x8e9: 84,
+    0x8ea: 84,
+    0x8eb: 84,
+    0x8ec: 84,
+    0x8ed: 84,
+    0x8ee: 84,
+    0x8ef: 84,
+    0x8f0: 84,
+    0x8f1: 84,
+    0x8f2: 84,
+    0x8f3: 84,
+    0x8f4: 84,
+    0x8f5: 84,
+    0x8f6: 84,
+    0x8f7: 84,
+    0x8f8: 84,
+    0x8f9: 84,
+    0x8fa: 84,
+    0x8fb: 84,
+    0x8fc: 84,
+    0x8fd: 84,
+    0x8fe: 84,
+    0x8ff: 84,
+    0x900: 84,
+    0x901: 84,
+    0x902: 84,
+    0x93a: 84,
+    0x93c: 84,
+    0x941: 84,
+    0x942: 84,
+    0x943: 84,
+    0x944: 84,
+    0x945: 84,
+    0x946: 84,
+    0x947: 84,
+    0x948: 84,
+    0x94d: 84,
+    0x951: 84,
+    0x952: 84,
+    0x953: 84,
+    0x954: 84,
+    0x955: 84,
+    0x956: 84,
+    0x957: 84,
+    0x962: 84,
+    0x963: 84,
+    0x981: 84,
+    0x9bc: 84,
+    0x9c1: 84,
+    0x9c2: 84,
+    0x9c3: 84,
+    0x9c4: 84,
+    0x9cd: 84,
+    0x9e2: 84,
+    0x9e3: 84,
+    0x9fe: 84,
+    0xa01: 84,
+    0xa02: 84,
+    0xa3c: 84,
+    0xa41: 84,
+    0xa42: 84,
+    0xa47: 84,
+    0xa48: 84,
+    0xa4b: 84,
+    0xa4c: 84,
+    0xa4d: 84,
+    0xa51: 84,
+    0xa70: 84,
+    0xa71: 84,
+    0xa75: 84,
+    0xa81: 84,
+    0xa82: 84,
+    0xabc: 84,
+    0xac1: 84,
+    0xac2: 84,
+    0xac3: 84,
+    0xac4: 84,
+    0xac5: 84,
+    0xac7: 84,
+    0xac8: 84,
+    0xacd: 84,
+    0xae2: 84,
+    0xae3: 84,
+    0xafa: 84,
+    0xafb: 84,
+    0xafc: 84,
+    0xafd: 84,
+    0xafe: 84,
+    0xaff: 84,
+    0xb01: 84,
+    0xb3c: 84,
+    0xb3f: 84,
+    0xb41: 84,
+    0xb42: 84,
+    0xb43: 84,
+    0xb44: 84,
+    0xb4d: 84,
+    0xb55: 84,
+    0xb56: 84,
+    0xb62: 84,
+    0xb63: 84,
+    0xb82: 84,
+    0xbc0: 84,
+    0xbcd: 84,
+    0xc00: 84,
+    0xc04: 84,
+    0xc3c: 84,
+    0xc3e: 84,
+    0xc3f: 84,
+    0xc40: 84,
+    0xc46: 84,
+    0xc47: 84,
+    0xc48: 84,
+    0xc4a: 84,
+    0xc4b: 84,
+    0xc4c: 84,
+    0xc4d: 84,
+    0xc55: 84,
+    0xc56: 84,
+    0xc62: 84,
+    0xc63: 84,
+    0xc81: 84,
+    0xcbc: 84,
+    0xcbf: 84,
+    0xcc6: 84,
+    0xccc: 84,
+    0xccd: 84,
+    0xce2: 84,
+    0xce3: 84,
+    0xd00: 84,
+    0xd01: 84,
+    0xd3b: 84,
+    0xd3c: 84,
+    0xd41: 84,
+    0xd42: 84,
+    0xd43: 84,
+    0xd44: 84,
+    0xd4d: 84,
+    0xd62: 84,
+    0xd63: 84,
+    0xd81: 84,
+    0xdca: 84,
+    0xdd2: 84,
+    0xdd3: 84,
+    0xdd4: 84,
+    0xdd6: 84,
+    0xe31: 84,
+    0xe34: 84,
+    0xe35: 84,
+    0xe36: 84,
+    0xe37: 84,
+    0xe38: 84,
+    0xe39: 84,
+    0xe3a: 84,
+    0xe47: 84,
+    0xe48: 84,
+    0xe49: 84,
+    0xe4a: 84,
+    0xe4b: 84,
+    0xe4c: 84,
+    0xe4d: 84,
+    0xe4e: 84,
+    0xeb1: 84,
+    0xeb4: 84,
+    0xeb5: 84,
+    0xeb6: 84,
+    0xeb7: 84,
+    0xeb8: 84,
+    0xeb9: 84,
+    0xeba: 84,
+    0xebb: 84,
+    0xebc: 84,
+    0xec8: 84,
+    0xec9: 84,
+    0xeca: 84,
+    0xecb: 84,
+    0xecc: 84,
+    0xecd: 84,
+    0xece: 84,
+    0xf18: 84,
+    0xf19: 84,
+    0xf35: 84,
+    0xf37: 84,
+    0xf39: 84,
+    0xf71: 84,
+    0xf72: 84,
+    0xf73: 84,
+    0xf74: 84,
+    0xf75: 84,
+    0xf76: 84,
+    0xf77: 84,
+    0xf78: 84,
+    0xf79: 84,
+    0xf7a: 84,
+    0xf7b: 84,
+    0xf7c: 84,
+    0xf7d: 84,
+    0xf7e: 84,
+    0xf80: 84,
+    0xf81: 84,
+    0xf82: 84,
+    0xf83: 84,
+    0xf84: 84,
+    0xf86: 84,
+    0xf87: 84,
+    0xf8d: 84,
+    0xf8e: 84,
+    0xf8f: 84,
+    0xf90: 84,
+    0xf91: 84,
+    0xf92: 84,
+    0xf93: 84,
+    0xf94: 84,
+    0xf95: 84,
+    0xf96: 84,
+    0xf97: 84,
+    0xf99: 84,
+    0xf9a: 84,
+    0xf9b: 84,
+    0xf9c: 84,
+    0xf9d: 84,
+    0xf9e: 84,
+    0xf9f: 84,
+    0xfa0: 84,
+    0xfa1: 84,
+    0xfa2: 84,
+    0xfa3: 84,
+    0xfa4: 84,
+    0xfa5: 84,
+    0xfa6: 84,
+    0xfa7: 84,
+    0xfa8: 84,
+    0xfa9: 84,
+    0xfaa: 84,
+    0xfab: 84,
+    0xfac: 84,
+    0xfad: 84,
+    0xfae: 84,
+    0xfaf: 84,
+    0xfb0: 84,
+    0xfb1: 84,
+    0xfb2: 84,
+    0xfb3: 84,
+    0xfb4: 84,
+    0xfb5: 84,
+    0xfb6: 84,
+    0xfb7: 84,
+    0xfb8: 84,
+    0xfb9: 84,
+    0xfba: 84,
+    0xfbb: 84,
+    0xfbc: 84,
+    0xfc6: 84,
+    0x102d: 84,
+    0x102e: 84,
+    0x102f: 84,
+    0x1030: 84,
+    0x1032: 84,
+    0x1033: 84,
+    0x1034: 84,
+    0x1035: 84,
+    0x1036: 84,
+    0x1037: 84,
+    0x1039: 84,
+    0x103a: 84,
+    0x103d: 84,
+    0x103e: 84,
+    0x1058: 84,
+    0x1059: 84,
+    0x105e: 84,
+    0x105f: 84,
+    0x1060: 84,
+    0x1071: 84,
+    0x1072: 84,
+    0x1073: 84,
+    0x1074: 84,
+    0x1082: 84,
+    0x1085: 84,
+    0x1086: 84,
+    0x108d: 84,
+    0x109d: 84,
+    0x135d: 84,
+    0x135e: 84,
+    0x135f: 84,
+    0x1712: 84,
+    0x1713: 84,
+    0x1714: 84,
+    0x1732: 84,
+    0x1733: 84,
+    0x1752: 84,
+    0x1753: 84,
+    0x1772: 84,
+    0x1773: 84,
+    0x17b4: 84,
+    0x17b5: 84,
+    0x17b7: 84,
+    0x17b8: 84,
+    0x17b9: 84,
+    0x17ba: 84,
+    0x17bb: 84,
+    0x17bc: 84,
+    0x17bd: 84,
+    0x17c6: 84,
+    0x17c9: 84,
+    0x17ca: 84,
+    0x17cb: 84,
+    0x17cc: 84,
+    0x17cd: 84,
+    0x17ce: 84,
+    0x17cf: 84,
+    0x17d0: 84,
+    0x17d1: 84,
+    0x17d2: 84,
+    0x17d3: 84,
+    0x17dd: 84,
     0x1807: 68,
     0x180a: 67,
-    0x180e: 85,
+    0x180b: 84,
+    0x180c: 84,
+    0x180d: 84,
+    0x180f: 84,
     0x1820: 68,
     0x1821: 68,
     0x1822: 68,
@@ -582,11 +1215,6 @@ joining_types = {
     0x1876: 68,
     0x1877: 68,
     0x1878: 68,
-    0x1880: 85,
-    0x1881: 85,
-    0x1882: 85,
-    0x1883: 85,
-    0x1884: 85,
     0x1885: 84,
     0x1886: 84,
     0x1887: 68,
@@ -623,14 +1251,339 @@ joining_types = {
     0x18a6: 68,
     0x18a7: 68,
     0x18a8: 68,
+    0x18a9: 84,
     0x18aa: 68,
-    0x200c: 85,
+    0x1920: 84,
+    0x1921: 84,
+    0x1922: 84,
+    0x1927: 84,
+    0x1928: 84,
+    0x1932: 84,
+    0x1939: 84,
+    0x193a: 84,
+    0x193b: 84,
+    0x1a17: 84,
+    0x1a18: 84,
+    0x1a1b: 84,
+    0x1a56: 84,
+    0x1a58: 84,
+    0x1a59: 84,
+    0x1a5a: 84,
+    0x1a5b: 84,
+    0x1a5c: 84,
+    0x1a5d: 84,
+    0x1a5e: 84,
+    0x1a60: 84,
+    0x1a62: 84,
+    0x1a65: 84,
+    0x1a66: 84,
+    0x1a67: 84,
+    0x1a68: 84,
+    0x1a69: 84,
+    0x1a6a: 84,
+    0x1a6b: 84,
+    0x1a6c: 84,
+    0x1a73: 84,
+    0x1a74: 84,
+    0x1a75: 84,
+    0x1a76: 84,
+    0x1a77: 84,
+    0x1a78: 84,
+    0x1a79: 84,
+    0x1a7a: 84,
+    0x1a7b: 84,
+    0x1a7c: 84,
+    0x1a7f: 84,
+    0x1ab0: 84,
+    0x1ab1: 84,
+    0x1ab2: 84,
+    0x1ab3: 84,
+    0x1ab4: 84,
+    0x1ab5: 84,
+    0x1ab6: 84,
+    0x1ab7: 84,
+    0x1ab8: 84,
+    0x1ab9: 84,
+    0x1aba: 84,
+    0x1abb: 84,
+    0x1abc: 84,
+    0x1abd: 84,
+    0x1abe: 84,
+    0x1abf: 84,
+    0x1ac0: 84,
+    0x1ac1: 84,
+    0x1ac2: 84,
+    0x1ac3: 84,
+    0x1ac4: 84,
+    0x1ac5: 84,
+    0x1ac6: 84,
+    0x1ac7: 84,
+    0x1ac8: 84,
+    0x1ac9: 84,
+    0x1aca: 84,
+    0x1acb: 84,
+    0x1acc: 84,
+    0x1acd: 84,
+    0x1ace: 84,
+    0x1b00: 84,
+    0x1b01: 84,
+    0x1b02: 84,
+    0x1b03: 84,
+    0x1b34: 84,
+    0x1b36: 84,
+    0x1b37: 84,
+    0x1b38: 84,
+    0x1b39: 84,
+    0x1b3a: 84,
+    0x1b3c: 84,
+    0x1b42: 84,
+    0x1b6b: 84,
+    0x1b6c: 84,
+    0x1b6d: 84,
+    0x1b6e: 84,
+    0x1b6f: 84,
+    0x1b70: 84,
+    0x1b71: 84,
+    0x1b72: 84,
+    0x1b73: 84,
+    0x1b80: 84,
+    0x1b81: 84,
+    0x1ba2: 84,
+    0x1ba3: 84,
+    0x1ba4: 84,
+    0x1ba5: 84,
+    0x1ba8: 84,
+    0x1ba9: 84,
+    0x1bab: 84,
+    0x1bac: 84,
+    0x1bad: 84,
+    0x1be6: 84,
+    0x1be8: 84,
+    0x1be9: 84,
+    0x1bed: 84,
+    0x1bef: 84,
+    0x1bf0: 84,
+    0x1bf1: 84,
+    0x1c2c: 84,
+    0x1c2d: 84,
+    0x1c2e: 84,
+    0x1c2f: 84,
+    0x1c30: 84,
+    0x1c31: 84,
+    0x1c32: 84,
+    0x1c33: 84,
+    0x1c36: 84,
+    0x1c37: 84,
+    0x1cd0: 84,
+    0x1cd1: 84,
+    0x1cd2: 84,
+    0x1cd4: 84,
+    0x1cd5: 84,
+    0x1cd6: 84,
+    0x1cd7: 84,
+    0x1cd8: 84,
+    0x1cd9: 84,
+    0x1cda: 84,
+    0x1cdb: 84,
+    0x1cdc: 84,
+    0x1cdd: 84,
+    0x1cde: 84,
+    0x1cdf: 84,
+    0x1ce0: 84,
+    0x1ce2: 84,
+    0x1ce3: 84,
+    0x1ce4: 84,
+    0x1ce5: 84,
+    0x1ce6: 84,
+    0x1ce7: 84,
+    0x1ce8: 84,
+    0x1ced: 84,
+    0x1cf4: 84,
+    0x1cf8: 84,
+    0x1cf9: 84,
+    0x1dc0: 84,
+    0x1dc1: 84,
+    0x1dc2: 84,
+    0x1dc3: 84,
+    0x1dc4: 84,
+    0x1dc5: 84,
+    0x1dc6: 84,
+    0x1dc7: 84,
+    0x1dc8: 84,
+    0x1dc9: 84,
+    0x1dca: 84,
+    0x1dcb: 84,
+    0x1dcc: 84,
+    0x1dcd: 84,
+    0x1dce: 84,
+    0x1dcf: 84,
+    0x1dd0: 84,
+    0x1dd1: 84,
+    0x1dd2: 84,
+    0x1dd3: 84,
+    0x1dd4: 84,
+    0x1dd5: 84,
+    0x1dd6: 84,
+    0x1dd7: 84,
+    0x1dd8: 84,
+    0x1dd9: 84,
+    0x1dda: 84,
+    0x1ddb: 84,
+    0x1ddc: 84,
+    0x1ddd: 84,
+    0x1dde: 84,
+    0x1ddf: 84,
+    0x1de0: 84,
+    0x1de1: 84,
+    0x1de2: 84,
+    0x1de3: 84,
+    0x1de4: 84,
+    0x1de5: 84,
+    0x1de6: 84,
+    0x1de7: 84,
+    0x1de8: 84,
+    0x1de9: 84,
+    0x1dea: 84,
+    0x1deb: 84,
+    0x1dec: 84,
+    0x1ded: 84,
+    0x1dee: 84,
+    0x1def: 84,
+    0x1df0: 84,
+    0x1df1: 84,
+    0x1df2: 84,
+    0x1df3: 84,
+    0x1df4: 84,
+    0x1df5: 84,
+    0x1df6: 84,
+    0x1df7: 84,
+    0x1df8: 84,
+    0x1df9: 84,
+    0x1dfa: 84,
+    0x1dfb: 84,
+    0x1dfc: 84,
+    0x1dfd: 84,
+    0x1dfe: 84,
+    0x1dff: 84,
+    0x200b: 84,
     0x200d: 67,
-    0x202f: 85,
-    0x2066: 85,
-    0x2067: 85,
-    0x2068: 85,
-    0x2069: 85,
+    0x200e: 84,
+    0x200f: 84,
+    0x202a: 84,
+    0x202b: 84,
+    0x202c: 84,
+    0x202d: 84,
+    0x202e: 84,
+    0x2060: 84,
+    0x2061: 84,
+    0x2062: 84,
+    0x2063: 84,
+    0x2064: 84,
+    0x206a: 84,
+    0x206b: 84,
+    0x206c: 84,
+    0x206d: 84,
+    0x206e: 84,
+    0x206f: 84,
+    0x20d0: 84,
+    0x20d1: 84,
+    0x20d2: 84,
+    0x20d3: 84,
+    0x20d4: 84,
+    0x20d5: 84,
+    0x20d6: 84,
+    0x20d7: 84,
+    0x20d8: 84,
+    0x20d9: 84,
+    0x20da: 84,
+    0x20db: 84,
+    0x20dc: 84,
+    0x20dd: 84,
+    0x20de: 84,
+    0x20df: 84,
+    0x20e0: 84,
+    0x20e1: 84,
+    0x20e2: 84,
+    0x20e3: 84,
+    0x20e4: 84,
+    0x20e5: 84,
+    0x20e6: 84,
+    0x20e7: 84,
+    0x20e8: 84,
+    0x20e9: 84,
+    0x20ea: 84,
+    0x20eb: 84,
+    0x20ec: 84,
+    0x20ed: 84,
+    0x20ee: 84,
+    0x20ef: 84,
+    0x20f0: 84,
+    0x2cef: 84,
+    0x2cf0: 84,
+    0x2cf1: 84,
+    0x2d7f: 84,
+    0x2de0: 84,
+    0x2de1: 84,
+    0x2de2: 84,
+    0x2de3: 84,
+    0x2de4: 84,
+    0x2de5: 84,
+    0x2de6: 84,
+    0x2de7: 84,
+    0x2de8: 84,
+    0x2de9: 84,
+    0x2dea: 84,
+    0x2deb: 84,
+    0x2dec: 84,
+    0x2ded: 84,
+    0x2dee: 84,
+    0x2def: 84,
+    0x2df0: 84,
+    0x2df1: 84,
+    0x2df2: 84,
+    0x2df3: 84,
+    0x2df4: 84,
+    0x2df5: 84,
+    0x2df6: 84,
+    0x2df7: 84,
+    0x2df8: 84,
+    0x2df9: 84,
+    0x2dfa: 84,
+    0x2dfb: 84,
+    0x2dfc: 84,
+    0x2dfd: 84,
+    0x2dfe: 84,
+    0x2dff: 84,
+    0x302a: 84,
+    0x302b: 84,
+    0x302c: 84,
+    0x302d: 84,
+    0x3099: 84,
+    0x309a: 84,
+    0xa66f: 84,
+    0xa670: 84,
+    0xa671: 84,
+    0xa672: 84,
+    0xa674: 84,
+    0xa675: 84,
+    0xa676: 84,
+    0xa677: 84,
+    0xa678: 84,
+    0xa679: 84,
+    0xa67a: 84,
+    0xa67b: 84,
+    0xa67c: 84,
+    0xa67d: 84,
+    0xa69e: 84,
+    0xa69f: 84,
+    0xa6f0: 84,
+    0xa6f1: 84,
+    0xa802: 84,
+    0xa806: 84,
+    0xa80b: 84,
+    0xa825: 84,
+    0xa826: 84,
+    0xa82c: 84,
     0xa840: 68,
     0xa841: 68,
     0xa842: 68,
@@ -682,20 +1635,151 @@ joining_types = {
     0xa870: 68,
     0xa871: 68,
     0xa872: 76,
-    0xa873: 85,
+    0xa8c4: 84,
+    0xa8c5: 84,
+    0xa8e0: 84,
+    0xa8e1: 84,
+    0xa8e2: 84,
+    0xa8e3: 84,
+    0xa8e4: 84,
+    0xa8e5: 84,
+    0xa8e6: 84,
+    0xa8e7: 84,
+    0xa8e8: 84,
+    0xa8e9: 84,
+    0xa8ea: 84,
+    0xa8eb: 84,
+    0xa8ec: 84,
+    0xa8ed: 84,
+    0xa8ee: 84,
+    0xa8ef: 84,
+    0xa8f0: 84,
+    0xa8f1: 84,
+    0xa8ff: 84,
+    0xa926: 84,
+    0xa927: 84,
+    0xa928: 84,
+    0xa929: 84,
+    0xa92a: 84,
+    0xa92b: 84,
+    0xa92c: 84,
+    0xa92d: 84,
+    0xa947: 84,
+    0xa948: 84,
+    0xa949: 84,
+    0xa94a: 84,
+    0xa94b: 84,
+    0xa94c: 84,
+    0xa94d: 84,
+    0xa94e: 84,
+    0xa94f: 84,
+    0xa950: 84,
+    0xa951: 84,
+    0xa980: 84,
+    0xa981: 84,
+    0xa982: 84,
+    0xa9b3: 84,
+    0xa9b6: 84,
+    0xa9b7: 84,
+    0xa9b8: 84,
+    0xa9b9: 84,
+    0xa9bc: 84,
+    0xa9bd: 84,
+    0xa9e5: 84,
+    0xaa29: 84,
+    0xaa2a: 84,
+    0xaa2b: 84,
+    0xaa2c: 84,
+    0xaa2d: 84,
+    0xaa2e: 84,
+    0xaa31: 84,
+    0xaa32: 84,
+    0xaa35: 84,
+    0xaa36: 84,
+    0xaa43: 84,
+    0xaa4c: 84,
+    0xaa7c: 84,
+    0xaab0: 84,
+    0xaab2: 84,
+    0xaab3: 84,
+    0xaab4: 84,
+    0xaab7: 84,
+    0xaab8: 84,
+    0xaabe: 84,
+    0xaabf: 84,
+    0xaac1: 84,
+    0xaaec: 84,
+    0xaaed: 84,
+    0xaaf6: 84,
+    0xabe5: 84,
+    0xabe8: 84,
+    0xabed: 84,
+    0xfb1e: 84,
+    0xfe00: 84,
+    0xfe01: 84,
+    0xfe02: 84,
+    0xfe03: 84,
+    0xfe04: 84,
+    0xfe05: 84,
+    0xfe06: 84,
+    0xfe07: 84,
+    0xfe08: 84,
+    0xfe09: 84,
+    0xfe0a: 84,
+    0xfe0b: 84,
+    0xfe0c: 84,
+    0xfe0d: 84,
+    0xfe0e: 84,
+    0xfe0f: 84,
+    0xfe20: 84,
+    0xfe21: 84,
+    0xfe22: 84,
+    0xfe23: 84,
+    0xfe24: 84,
+    0xfe25: 84,
+    0xfe26: 84,
+    0xfe27: 84,
+    0xfe28: 84,
+    0xfe29: 84,
+    0xfe2a: 84,
+    0xfe2b: 84,
+    0xfe2c: 84,
+    0xfe2d: 84,
+    0xfe2e: 84,
+    0xfe2f: 84,
+    0xfeff: 84,
+    0xfff9: 84,
+    0xfffa: 84,
+    0xfffb: 84,
+    0x101fd: 84,
+    0x102e0: 84,
+    0x10376: 84,
+    0x10377: 84,
+    0x10378: 84,
+    0x10379: 84,
+    0x1037a: 84,
+    0x10a01: 84,
+    0x10a02: 84,
+    0x10a03: 84,
+    0x10a05: 84,
+    0x10a06: 84,
+    0x10a0c: 84,
+    0x10a0d: 84,
+    0x10a0e: 84,
+    0x10a0f: 84,
+    0x10a38: 84,
+    0x10a39: 84,
+    0x10a3a: 84,
+    0x10a3f: 84,
     0x10ac0: 68,
     0x10ac1: 68,
     0x10ac2: 68,
     0x10ac3: 68,
     0x10ac4: 68,
     0x10ac5: 82,
-    0x10ac6: 85,
     0x10ac7: 82,
-    0x10ac8: 85,
     0x10ac9: 82,
     0x10aca: 82,
-    0x10acb: 85,
-    0x10acc: 85,
     0x10acd: 76,
     0x10ace: 82,
     0x10acf: 82,
@@ -717,9 +1801,9 @@ joining_types = {
     0x10adf: 68,
     0x10ae0: 68,
     0x10ae1: 82,
-    0x10ae2: 85,
-    0x10ae3: 85,
     0x10ae4: 82,
+    0x10ae5: 84,
+    0x10ae6: 84,
     0x10aeb: 68,
     0x10aec: 68,
     0x10aed: 68,
@@ -749,7 +1833,6 @@ joining_types = {
     0x10bac: 82,
     0x10bad: 68,
     0x10bae: 68,
-    0x10baf: 85,
     0x10d00: 76,
     0x10d01: 68,
     0x10d02: 68,
@@ -786,6 +1869,15 @@ joining_types = {
     0x10d21: 68,
     0x10d22: 82,
     0x10d23: 68,
+    0x10d24: 84,
+    0x10d25: 84,
+    0x10d26: 84,
+    0x10d27: 84,
+    0x10eab: 84,
+    0x10eac: 84,
+    0x10efd: 84,
+    0x10efe: 84,
+    0x10eff: 84,
     0x10f30: 68,
     0x10f31: 68,
     0x10f32: 68,
@@ -807,7 +1899,17 @@ joining_types = {
     0x10f42: 68,
     0x10f43: 68,
     0x10f44: 68,
-    0x10f45: 85,
+    0x10f46: 84,
+    0x10f47: 84,
+    0x10f48: 84,
+    0x10f49: 84,
+    0x10f4a: 84,
+    0x10f4b: 84,
+    0x10f4c: 84,
+    0x10f4d: 84,
+    0x10f4e: 84,
+    0x10f4f: 84,
+    0x10f50: 84,
     0x10f51: 68,
     0x10f52: 68,
     0x10f53: 68,
@@ -830,14 +1932,16 @@ joining_types = {
     0x10f7f: 68,
     0x10f80: 68,
     0x10f81: 68,
+    0x10f82: 84,
+    0x10f83: 84,
+    0x10f84: 84,
+    0x10f85: 84,
     0x10fb0: 68,
-    0x10fb1: 85,
     0x10fb2: 68,
     0x10fb3: 68,
     0x10fb4: 82,
     0x10fb5: 82,
     0x10fb6: 82,
-    0x10fb7: 85,
     0x10fb8: 68,
     0x10fb9: 82,
     0x10fba: 82,
@@ -846,20 +1950,668 @@ joining_types = {
     0x10fbd: 82,
     0x10fbe: 68,
     0x10fbf: 68,
-    0x10fc0: 85,
     0x10fc1: 68,
     0x10fc2: 82,
     0x10fc3: 82,
     0x10fc4: 68,
-    0x10fc5: 85,
-    0x10fc6: 85,
-    0x10fc7: 85,
-    0x10fc8: 85,
     0x10fc9: 82,
     0x10fca: 68,
     0x10fcb: 76,
-    0x110bd: 85,
-    0x110cd: 85,
+    0x11001: 84,
+    0x11038: 84,
+    0x11039: 84,
+    0x1103a: 84,
+    0x1103b: 84,
+    0x1103c: 84,
+    0x1103d: 84,
+    0x1103e: 84,
+    0x1103f: 84,
+    0x11040: 84,
+    0x11041: 84,
+    0x11042: 84,
+    0x11043: 84,
+    0x11044: 84,
+    0x11045: 84,
+    0x11046: 84,
+    0x11070: 84,
+    0x11073: 84,
+    0x11074: 84,
+    0x1107f: 84,
+    0x11080: 84,
+    0x11081: 84,
+    0x110b3: 84,
+    0x110b4: 84,
+    0x110b5: 84,
+    0x110b6: 84,
+    0x110b9: 84,
+    0x110ba: 84,
+    0x110c2: 84,
+    0x11100: 84,
+    0x11101: 84,
+    0x11102: 84,
+    0x11127: 84,
+    0x11128: 84,
+    0x11129: 84,
+    0x1112a: 84,
+    0x1112b: 84,
+    0x1112d: 84,
+    0x1112e: 84,
+    0x1112f: 84,
+    0x11130: 84,
+    0x11131: 84,
+    0x11132: 84,
+    0x11133: 84,
+    0x11134: 84,
+    0x11173: 84,
+    0x11180: 84,
+    0x11181: 84,
+    0x111b6: 84,
+    0x111b7: 84,
+    0x111b8: 84,
+    0x111b9: 84,
+    0x111ba: 84,
+    0x111bb: 84,
+    0x111bc: 84,
+    0x111bd: 84,
+    0x111be: 84,
+    0x111c9: 84,
+    0x111ca: 84,
+    0x111cb: 84,
+    0x111cc: 84,
+    0x111cf: 84,
+    0x1122f: 84,
+    0x11230: 84,
+    0x11231: 84,
+    0x11234: 84,
+    0x11236: 84,
+    0x11237: 84,
+    0x1123e: 84,
+    0x11241: 84,
+    0x112df: 84,
+    0x112e3: 84,
+    0x112e4: 84,
+    0x112e5: 84,
+    0x112e6: 84,
+    0x112e7: 84,
+    0x112e8: 84,
+    0x112e9: 84,
+    0x112ea: 84,
+    0x11300: 84,
+    0x11301: 84,
+    0x1133b: 84,
+    0x1133c: 84,
+    0x11340: 84,
+    0x11366: 84,
+    0x11367: 84,
+    0x11368: 84,
+    0x11369: 84,
+    0x1136a: 84,
+    0x1136b: 84,
+    0x1136c: 84,
+    0x11370: 84,
+    0x11371: 84,
+    0x11372: 84,
+    0x11373: 84,
+    0x11374: 84,
+    0x11438: 84,
+    0x11439: 84,
+    0x1143a: 84,
+    0x1143b: 84,
+    0x1143c: 84,
+    0x1143d: 84,
+    0x1143e: 84,
+    0x1143f: 84,
+    0x11442: 84,
+    0x11443: 84,
+    0x11444: 84,
+    0x11446: 84,
+    0x1145e: 84,
+    0x114b3: 84,
+    0x114b4: 84,
+    0x114b5: 84,
+    0x114b6: 84,
+    0x114b7: 84,
+    0x114b8: 84,
+    0x114ba: 84,
+    0x114bf: 84,
+    0x114c0: 84,
+    0x114c2: 84,
+    0x114c3: 84,
+    0x115b2: 84,
+    0x115b3: 84,
+    0x115b4: 84,
+    0x115b5: 84,
+    0x115bc: 84,
+    0x115bd: 84,
+    0x115bf: 84,
+    0x115c0: 84,
+    0x115dc: 84,
+    0x115dd: 84,
+    0x11633: 84,
+    0x11634: 84,
+    0x11635: 84,
+    0x11636: 84,
+    0x11637: 84,
+    0x11638: 84,
+    0x11639: 84,
+    0x1163a: 84,
+    0x1163d: 84,
+    0x1163f: 84,
+    0x11640: 84,
+    0x116ab: 84,
+    0x116ad: 84,
+    0x116b0: 84,
+    0x116b1: 84,
+    0x116b2: 84,
+    0x116b3: 84,
+    0x116b4: 84,
+    0x116b5: 84,
+    0x116b7: 84,
+    0x1171d: 84,
+    0x1171e: 84,
+    0x1171f: 84,
+    0x11722: 84,
+    0x11723: 84,
+    0x11724: 84,
+    0x11725: 84,
+    0x11727: 84,
+    0x11728: 84,
+    0x11729: 84,
+    0x1172a: 84,
+    0x1172b: 84,
+    0x1182f: 84,
+    0x11830: 84,
+    0x11831: 84,
+    0x11832: 84,
+    0x11833: 84,
+    0x11834: 84,
+    0x11835: 84,
+    0x11836: 84,
+    0x11837: 84,
+    0x11839: 84,
+    0x1183a: 84,
+    0x1193b: 84,
+    0x1193c: 84,
+    0x1193e: 84,
+    0x11943: 84,
+    0x119d4: 84,
+    0x119d5: 84,
+    0x119d6: 84,
+    0x119d7: 84,
+    0x119da: 84,
+    0x119db: 84,
+    0x119e0: 84,
+    0x11a01: 84,
+    0x11a02: 84,
+    0x11a03: 84,
+    0x11a04: 84,
+    0x11a05: 84,
+    0x11a06: 84,
+    0x11a07: 84,
+    0x11a08: 84,
+    0x11a09: 84,
+    0x11a0a: 84,
+    0x11a33: 84,
+    0x11a34: 84,
+    0x11a35: 84,
+    0x11a36: 84,
+    0x11a37: 84,
+    0x11a38: 84,
+    0x11a3b: 84,
+    0x11a3c: 84,
+    0x11a3d: 84,
+    0x11a3e: 84,
+    0x11a47: 84,
+    0x11a51: 84,
+    0x11a52: 84,
+    0x11a53: 84,
+    0x11a54: 84,
+    0x11a55: 84,
+    0x11a56: 84,
+    0x11a59: 84,
+    0x11a5a: 84,
+    0x11a5b: 84,
+    0x11a8a: 84,
+    0x11a8b: 84,
+    0x11a8c: 84,
+    0x11a8d: 84,
+    0x11a8e: 84,
+    0x11a8f: 84,
+    0x11a90: 84,
+    0x11a91: 84,
+    0x11a92: 84,
+    0x11a93: 84,
+    0x11a94: 84,
+    0x11a95: 84,
+    0x11a96: 84,
+    0x11a98: 84,
+    0x11a99: 84,
+    0x11c30: 84,
+    0x11c31: 84,
+    0x11c32: 84,
+    0x11c33: 84,
+    0x11c34: 84,
+    0x11c35: 84,
+    0x11c36: 84,
+    0x11c38: 84,
+    0x11c39: 84,
+    0x11c3a: 84,
+    0x11c3b: 84,
+    0x11c3c: 84,
+    0x11c3d: 84,
+    0x11c3f: 84,
+    0x11c92: 84,
+    0x11c93: 84,
+    0x11c94: 84,
+    0x11c95: 84,
+    0x11c96: 84,
+    0x11c97: 84,
+    0x11c98: 84,
+    0x11c99: 84,
+    0x11c9a: 84,
+    0x11c9b: 84,
+    0x11c9c: 84,
+    0x11c9d: 84,
+    0x11c9e: 84,
+    0x11c9f: 84,
+    0x11ca0: 84,
+    0x11ca1: 84,
+    0x11ca2: 84,
+    0x11ca3: 84,
+    0x11ca4: 84,
+    0x11ca5: 84,
+    0x11ca6: 84,
+    0x11ca7: 84,
+    0x11caa: 84,
+    0x11cab: 84,
+    0x11cac: 84,
+    0x11cad: 84,
+    0x11cae: 84,
+    0x11caf: 84,
+    0x11cb0: 84,
+    0x11cb2: 84,
+    0x11cb3: 84,
+    0x11cb5: 84,
+    0x11cb6: 84,
+    0x11d31: 84,
+    0x11d32: 84,
+    0x11d33: 84,
+    0x11d34: 84,
+    0x11d35: 84,
+    0x11d36: 84,
+    0x11d3a: 84,
+    0x11d3c: 84,
+    0x11d3d: 84,
+    0x11d3f: 84,
+    0x11d40: 84,
+    0x11d41: 84,
+    0x11d42: 84,
+    0x11d43: 84,
+    0x11d44: 84,
+    0x11d45: 84,
+    0x11d47: 84,
+    0x11d90: 84,
+    0x11d91: 84,
+    0x11d95: 84,
+    0x11d97: 84,
+    0x11ef3: 84,
+    0x11ef4: 84,
+    0x11f00: 84,
+    0x11f01: 84,
+    0x11f36: 84,
+    0x11f37: 84,
+    0x11f38: 84,
+    0x11f39: 84,
+    0x11f3a: 84,
+    0x11f40: 84,
+    0x11f42: 84,
+    0x13430: 84,
+    0x13431: 84,
+    0x13432: 84,
+    0x13433: 84,
+    0x13434: 84,
+    0x13435: 84,
+    0x13436: 84,
+    0x13437: 84,
+    0x13438: 84,
+    0x13439: 84,
+    0x1343a: 84,
+    0x1343b: 84,
+    0x1343c: 84,
+    0x1343d: 84,
+    0x1343e: 84,
+    0x1343f: 84,
+    0x13440: 84,
+    0x13447: 84,
+    0x13448: 84,
+    0x13449: 84,
+    0x1344a: 84,
+    0x1344b: 84,
+    0x1344c: 84,
+    0x1344d: 84,
+    0x1344e: 84,
+    0x1344f: 84,
+    0x13450: 84,
+    0x13451: 84,
+    0x13452: 84,
+    0x13453: 84,
+    0x13454: 84,
+    0x13455: 84,
+    0x16af0: 84,
+    0x16af1: 84,
+    0x16af2: 84,
+    0x16af3: 84,
+    0x16af4: 84,
+    0x16b30: 84,
+    0x16b31: 84,
+    0x16b32: 84,
+    0x16b33: 84,
+    0x16b34: 84,
+    0x16b35: 84,
+    0x16b36: 84,
+    0x16f4f: 84,
+    0x16f8f: 84,
+    0x16f90: 84,
+    0x16f91: 84,
+    0x16f92: 84,
+    0x16fe4: 84,
+    0x1bc9d: 84,
+    0x1bc9e: 84,
+    0x1bca0: 84,
+    0x1bca1: 84,
+    0x1bca2: 84,
+    0x1bca3: 84,
+    0x1cf00: 84,
+    0x1cf01: 84,
+    0x1cf02: 84,
+    0x1cf03: 84,
+    0x1cf04: 84,
+    0x1cf05: 84,
+    0x1cf06: 84,
+    0x1cf07: 84,
+    0x1cf08: 84,
+    0x1cf09: 84,
+    0x1cf0a: 84,
+    0x1cf0b: 84,
+    0x1cf0c: 84,
+    0x1cf0d: 84,
+    0x1cf0e: 84,
+    0x1cf0f: 84,
+    0x1cf10: 84,
+    0x1cf11: 84,
+    0x1cf12: 84,
+    0x1cf13: 84,
+    0x1cf14: 84,
+    0x1cf15: 84,
+    0x1cf16: 84,
+    0x1cf17: 84,
+    0x1cf18: 84,
+    0x1cf19: 84,
+    0x1cf1a: 84,
+    0x1cf1b: 84,
+    0x1cf1c: 84,
+    0x1cf1d: 84,
+    0x1cf1e: 84,
+    0x1cf1f: 84,
+    0x1cf20: 84,
+    0x1cf21: 84,
+    0x1cf22: 84,
+    0x1cf23: 84,
+    0x1cf24: 84,
+    0x1cf25: 84,
+    0x1cf26: 84,
+    0x1cf27: 84,
+    0x1cf28: 84,
+    0x1cf29: 84,
+    0x1cf2a: 84,
+    0x1cf2b: 84,
+    0x1cf2c: 84,
+    0x1cf2d: 84,
+    0x1cf30: 84,
+    0x1cf31: 84,
+    0x1cf32: 84,
+    0x1cf33: 84,
+    0x1cf34: 84,
+    0x1cf35: 84,
+    0x1cf36: 84,
+    0x1cf37: 84,
+    0x1cf38: 84,
+    0x1cf39: 84,
+    0x1cf3a: 84,
+    0x1cf3b: 84,
+    0x1cf3c: 84,
+    0x1cf3d: 84,
+    0x1cf3e: 84,
+    0x1cf3f: 84,
+    0x1cf40: 84,
+    0x1cf41: 84,
+    0x1cf42: 84,
+    0x1cf43: 84,
+    0x1cf44: 84,
+    0x1cf45: 84,
+    0x1cf46: 84,
+    0x1d167: 84,
+    0x1d168: 84,
+    0x1d169: 84,
+    0x1d173: 84,
+    0x1d174: 84,
+    0x1d175: 84,
+    0x1d176: 84,
+    0x1d177: 84,
+    0x1d178: 84,
+    0x1d179: 84,
+    0x1d17a: 84,
+    0x1d17b: 84,
+    0x1d17c: 84,
+    0x1d17d: 84,
+    0x1d17e: 84,
+    0x1d17f: 84,
+    0x1d180: 84,
+    0x1d181: 84,
+    0x1d182: 84,
+    0x1d185: 84,
+    0x1d186: 84,
+    0x1d187: 84,
+    0x1d188: 84,
+    0x1d189: 84,
+    0x1d18a: 84,
+    0x1d18b: 84,
+    0x1d1aa: 84,
+    0x1d1ab: 84,
+    0x1d1ac: 84,
+    0x1d1ad: 84,
+    0x1d242: 84,
+    0x1d243: 84,
+    0x1d244: 84,
+    0x1da00: 84,
+    0x1da01: 84,
+    0x1da02: 84,
+    0x1da03: 84,
+    0x1da04: 84,
+    0x1da05: 84,
+    0x1da06: 84,
+    0x1da07: 84,
+    0x1da08: 84,
+    0x1da09: 84,
+    0x1da0a: 84,
+    0x1da0b: 84,
+    0x1da0c: 84,
+    0x1da0d: 84,
+    0x1da0e: 84,
+    0x1da0f: 84,
+    0x1da10: 84,
+    0x1da11: 84,
+    0x1da12: 84,
+    0x1da13: 84,
+    0x1da14: 84,
+    0x1da15: 84,
+    0x1da16: 84,
+    0x1da17: 84,
+    0x1da18: 84,
+    0x1da19: 84,
+    0x1da1a: 84,
+    0x1da1b: 84,
+    0x1da1c: 84,
+    0x1da1d: 84,
+    0x1da1e: 84,
+    0x1da1f: 84,
+    0x1da20: 84,
+    0x1da21: 84,
+    0x1da22: 84,
+    0x1da23: 84,
+    0x1da24: 84,
+    0x1da25: 84,
+    0x1da26: 84,
+    0x1da27: 84,
+    0x1da28: 84,
+    0x1da29: 84,
+    0x1da2a: 84,
+    0x1da2b: 84,
+    0x1da2c: 84,
+    0x1da2d: 84,
+    0x1da2e: 84,
+    0x1da2f: 84,
+    0x1da30: 84,
+    0x1da31: 84,
+    0x1da32: 84,
+    0x1da33: 84,
+    0x1da34: 84,
+    0x1da35: 84,
+    0x1da36: 84,
+    0x1da3b: 84,
+    0x1da3c: 84,
+    0x1da3d: 84,
+    0x1da3e: 84,
+    0x1da3f: 84,
+    0x1da40: 84,
+    0x1da41: 84,
+    0x1da42: 84,
+    0x1da43: 84,
+    0x1da44: 84,
+    0x1da45: 84,
+    0x1da46: 84,
+    0x1da47: 84,
+    0x1da48: 84,
+    0x1da49: 84,
+    0x1da4a: 84,
+    0x1da4b: 84,
+    0x1da4c: 84,
+    0x1da4d: 84,
+    0x1da4e: 84,
+    0x1da4f: 84,
+    0x1da50: 84,
+    0x1da51: 84,
+    0x1da52: 84,
+    0x1da53: 84,
+    0x1da54: 84,
+    0x1da55: 84,
+    0x1da56: 84,
+    0x1da57: 84,
+    0x1da58: 84,
+    0x1da59: 84,
+    0x1da5a: 84,
+    0x1da5b: 84,
+    0x1da5c: 84,
+    0x1da5d: 84,
+    0x1da5e: 84,
+    0x1da5f: 84,
+    0x1da60: 84,
+    0x1da61: 84,
+    0x1da62: 84,
+    0x1da63: 84,
+    0x1da64: 84,
+    0x1da65: 84,
+    0x1da66: 84,
+    0x1da67: 84,
+    0x1da68: 84,
+    0x1da69: 84,
+    0x1da6a: 84,
+    0x1da6b: 84,
+    0x1da6c: 84,
+    0x1da75: 84,
+    0x1da84: 84,
+    0x1da9b: 84,
+    0x1da9c: 84,
+    0x1da9d: 84,
+    0x1da9e: 84,
+    0x1da9f: 84,
+    0x1daa1: 84,
+    0x1daa2: 84,
+    0x1daa3: 84,
+    0x1daa4: 84,
+    0x1daa5: 84,
+    0x1daa6: 84,
+    0x1daa7: 84,
+    0x1daa8: 84,
+    0x1daa9: 84,
+    0x1daaa: 84,
+    0x1daab: 84,
+    0x1daac: 84,
+    0x1daad: 84,
+    0x1daae: 84,
+    0x1daaf: 84,
+    0x1e000: 84,
+    0x1e001: 84,
+    0x1e002: 84,
+    0x1e003: 84,
+    0x1e004: 84,
+    0x1e005: 84,
+    0x1e006: 84,
+    0x1e008: 84,
+    0x1e009: 84,
+    0x1e00a: 84,
+    0x1e00b: 84,
+    0x1e00c: 84,
+    0x1e00d: 84,
+    0x1e00e: 84,
+    0x1e00f: 84,
+    0x1e010: 84,
+    0x1e011: 84,
+    0x1e012: 84,
+    0x1e013: 84,
+    0x1e014: 84,
+    0x1e015: 84,
+    0x1e016: 84,
+    0x1e017: 84,
+    0x1e018: 84,
+    0x1e01b: 84,
+    0x1e01c: 84,
+    0x1e01d: 84,
+    0x1e01e: 84,
+    0x1e01f: 84,
+    0x1e020: 84,
+    0x1e021: 84,
+    0x1e023: 84,
+    0x1e024: 84,
+    0x1e026: 84,
+    0x1e027: 84,
+    0x1e028: 84,
+    0x1e029: 84,
+    0x1e02a: 84,
+    0x1e08f: 84,
+    0x1e130: 84,
+    0x1e131: 84,
+    0x1e132: 84,
+    0x1e133: 84,
+    0x1e134: 84,
+    0x1e135: 84,
+    0x1e136: 84,
+    0x1e2ae: 84,
+    0x1e2ec: 84,
+    0x1e2ed: 84,
+    0x1e2ee: 84,
+    0x1e2ef: 84,
+    0x1e4ec: 84,
+    0x1e4ed: 84,
+    0x1e4ee: 84,
+    0x1e4ef: 84,
+    0x1e8d0: 84,
+    0x1e8d1: 84,
+    0x1e8d2: 84,
+    0x1e8d3: 84,
+    0x1e8d4: 84,
+    0x1e8d5: 84,
+    0x1e8d6: 84,
     0x1e900: 68,
     0x1e901: 68,
     0x1e902: 68,
@@ -928,7 +2680,351 @@ joining_types = {
     0x1e941: 68,
     0x1e942: 68,
     0x1e943: 68,
+    0x1e944: 84,
+    0x1e945: 84,
+    0x1e946: 84,
+    0x1e947: 84,
+    0x1e948: 84,
+    0x1e949: 84,
+    0x1e94a: 84,
     0x1e94b: 84,
+    0xe0001: 84,
+    0xe0020: 84,
+    0xe0021: 84,
+    0xe0022: 84,
+    0xe0023: 84,
+    0xe0024: 84,
+    0xe0025: 84,
+    0xe0026: 84,
+    0xe0027: 84,
+    0xe0028: 84,
+    0xe0029: 84,
+    0xe002a: 84,
+    0xe002b: 84,
+    0xe002c: 84,
+    0xe002d: 84,
+    0xe002e: 84,
+    0xe002f: 84,
+    0xe0030: 84,
+    0xe0031: 84,
+    0xe0032: 84,
+    0xe0033: 84,
+    0xe0034: 84,
+    0xe0035: 84,
+    0xe0036: 84,
+    0xe0037: 84,
+    0xe0038: 84,
+    0xe0039: 84,
+    0xe003a: 84,
+    0xe003b: 84,
+    0xe003c: 84,
+    0xe003d: 84,
+    0xe003e: 84,
+    0xe003f: 84,
+    0xe0040: 84,
+    0xe0041: 84,
+    0xe0042: 84,
+    0xe0043: 84,
+    0xe0044: 84,
+    0xe0045: 84,
+    0xe0046: 84,
+    0xe0047: 84,
+    0xe0048: 84,
+    0xe0049: 84,
+    0xe004a: 84,
+    0xe004b: 84,
+    0xe004c: 84,
+    0xe004d: 84,
+    0xe004e: 84,
+    0xe004f: 84,
+    0xe0050: 84,
+    0xe0051: 84,
+    0xe0052: 84,
+    0xe0053: 84,
+    0xe0054: 84,
+    0xe0055: 84,
+    0xe0056: 84,
+    0xe0057: 84,
+    0xe0058: 84,
+    0xe0059: 84,
+    0xe005a: 84,
+    0xe005b: 84,
+    0xe005c: 84,
+    0xe005d: 84,
+    0xe005e: 84,
+    0xe005f: 84,
+    0xe0060: 84,
+    0xe0061: 84,
+    0xe0062: 84,
+    0xe0063: 84,
+    0xe0064: 84,
+    0xe0065: 84,
+    0xe0066: 84,
+    0xe0067: 84,
+    0xe0068: 84,
+    0xe0069: 84,
+    0xe006a: 84,
+    0xe006b: 84,
+    0xe006c: 84,
+    0xe006d: 84,
+    0xe006e: 84,
+    0xe006f: 84,
+    0xe0070: 84,
+    0xe0071: 84,
+    0xe0072: 84,
+    0xe0073: 84,
+    0xe0074: 84,
+    0xe0075: 84,
+    0xe0076: 84,
+    0xe0077: 84,
+    0xe0078: 84,
+    0xe0079: 84,
+    0xe007a: 84,
+    0xe007b: 84,
+    0xe007c: 84,
+    0xe007d: 84,
+    0xe007e: 84,
+    0xe007f: 84,
+    0xe0100: 84,
+    0xe0101: 84,
+    0xe0102: 84,
+    0xe0103: 84,
+    0xe0104: 84,
+    0xe0105: 84,
+    0xe0106: 84,
+    0xe0107: 84,
+    0xe0108: 84,
+    0xe0109: 84,
+    0xe010a: 84,
+    0xe010b: 84,
+    0xe010c: 84,
+    0xe010d: 84,
+    0xe010e: 84,
+    0xe010f: 84,
+    0xe0110: 84,
+    0xe0111: 84,
+    0xe0112: 84,
+    0xe0113: 84,
+    0xe0114: 84,
+    0xe0115: 84,
+    0xe0116: 84,
+    0xe0117: 84,
+    0xe0118: 84,
+    0xe0119: 84,
+    0xe011a: 84,
+    0xe011b: 84,
+    0xe011c: 84,
+    0xe011d: 84,
+    0xe011e: 84,
+    0xe011f: 84,
+    0xe0120: 84,
+    0xe0121: 84,
+    0xe0122: 84,
+    0xe0123: 84,
+    0xe0124: 84,
+    0xe0125: 84,
+    0xe0126: 84,
+    0xe0127: 84,
+    0xe0128: 84,
+    0xe0129: 84,
+    0xe012a: 84,
+    0xe012b: 84,
+    0xe012c: 84,
+    0xe012d: 84,
+    0xe012e: 84,
+    0xe012f: 84,
+    0xe0130: 84,
+    0xe0131: 84,
+    0xe0132: 84,
+    0xe0133: 84,
+    0xe0134: 84,
+    0xe0135: 84,
+    0xe0136: 84,
+    0xe0137: 84,
+    0xe0138: 84,
+    0xe0139: 84,
+    0xe013a: 84,
+    0xe013b: 84,
+    0xe013c: 84,
+    0xe013d: 84,
+    0xe013e: 84,
+    0xe013f: 84,
+    0xe0140: 84,
+    0xe0141: 84,
+    0xe0142: 84,
+    0xe0143: 84,
+    0xe0144: 84,
+    0xe0145: 84,
+    0xe0146: 84,
+    0xe0147: 84,
+    0xe0148: 84,
+    0xe0149: 84,
+    0xe014a: 84,
+    0xe014b: 84,
+    0xe014c: 84,
+    0xe014d: 84,
+    0xe014e: 84,
+    0xe014f: 84,
+    0xe0150: 84,
+    0xe0151: 84,
+    0xe0152: 84,
+    0xe0153: 84,
+    0xe0154: 84,
+    0xe0155: 84,
+    0xe0156: 84,
+    0xe0157: 84,
+    0xe0158: 84,
+    0xe0159: 84,
+    0xe015a: 84,
+    0xe015b: 84,
+    0xe015c: 84,
+    0xe015d: 84,
+    0xe015e: 84,
+    0xe015f: 84,
+    0xe0160: 84,
+    0xe0161: 84,
+    0xe0162: 84,
+    0xe0163: 84,
+    0xe0164: 84,
+    0xe0165: 84,
+    0xe0166: 84,
+    0xe0167: 84,
+    0xe0168: 84,
+    0xe0169: 84,
+    0xe016a: 84,
+    0xe016b: 84,
+    0xe016c: 84,
+    0xe016d: 84,
+    0xe016e: 84,
+    0xe016f: 84,
+    0xe0170: 84,
+    0xe0171: 84,
+    0xe0172: 84,
+    0xe0173: 84,
+    0xe0174: 84,
+    0xe0175: 84,
+    0xe0176: 84,
+    0xe0177: 84,
+    0xe0178: 84,
+    0xe0179: 84,
+    0xe017a: 84,
+    0xe017b: 84,
+    0xe017c: 84,
+    0xe017d: 84,
+    0xe017e: 84,
+    0xe017f: 84,
+    0xe0180: 84,
+    0xe0181: 84,
+    0xe0182: 84,
+    0xe0183: 84,
+    0xe0184: 84,
+    0xe0185: 84,
+    0xe0186: 84,
+    0xe0187: 84,
+    0xe0188: 84,
+    0xe0189: 84,
+    0xe018a: 84,
+    0xe018b: 84,
+    0xe018c: 84,
+    0xe018d: 84,
+    0xe018e: 84,
+    0xe018f: 84,
+    0xe0190: 84,
+    0xe0191: 84,
+    0xe0192: 84,
+    0xe0193: 84,
+    0xe0194: 84,
+    0xe0195: 84,
+    0xe0196: 84,
+    0xe0197: 84,
+    0xe0198: 84,
+    0xe0199: 84,
+    0xe019a: 84,
+    0xe019b: 84,
+    0xe019c: 84,
+    0xe019d: 84,
+    0xe019e: 84,
+    0xe019f: 84,
+    0xe01a0: 84,
+    0xe01a1: 84,
+    0xe01a2: 84,
+    0xe01a3: 84,
+    0xe01a4: 84,
+    0xe01a5: 84,
+    0xe01a6: 84,
+    0xe01a7: 84,
+    0xe01a8: 84,
+    0xe01a9: 84,
+    0xe01aa: 84,
+    0xe01ab: 84,
+    0xe01ac: 84,
+    0xe01ad: 84,
+    0xe01ae: 84,
+    0xe01af: 84,
+    0xe01b0: 84,
+    0xe01b1: 84,
+    0xe01b2: 84,
+    0xe01b3: 84,
+    0xe01b4: 84,
+    0xe01b5: 84,
+    0xe01b6: 84,
+    0xe01b7: 84,
+    0xe01b8: 84,
+    0xe01b9: 84,
+    0xe01ba: 84,
+    0xe01bb: 84,
+    0xe01bc: 84,
+    0xe01bd: 84,
+    0xe01be: 84,
+    0xe01bf: 84,
+    0xe01c0: 84,
+    0xe01c1: 84,
+    0xe01c2: 84,
+    0xe01c3: 84,
+    0xe01c4: 84,
+    0xe01c5: 84,
+    0xe01c6: 84,
+    0xe01c7: 84,
+    0xe01c8: 84,
+    0xe01c9: 84,
+    0xe01ca: 84,
+    0xe01cb: 84,
+    0xe01cc: 84,
+    0xe01cd: 84,
+    0xe01ce: 84,
+    0xe01cf: 84,
+    0xe01d0: 84,
+    0xe01d1: 84,
+    0xe01d2: 84,
+    0xe01d3: 84,
+    0xe01d4: 84,
+    0xe01d5: 84,
+    0xe01d6: 84,
+    0xe01d7: 84,
+    0xe01d8: 84,
+    0xe01d9: 84,
+    0xe01da: 84,
+    0xe01db: 84,
+    0xe01dc: 84,
+    0xe01dd: 84,
+    0xe01de: 84,
+    0xe01df: 84,
+    0xe01e0: 84,
+    0xe01e1: 84,
+    0xe01e2: 84,
+    0xe01e3: 84,
+    0xe01e4: 84,
+    0xe01e5: 84,
+    0xe01e6: 84,
+    0xe01e7: 84,
+    0xe01e8: 84,
+    0xe01e9: 84,
+    0xe01ea: 84,
+    0xe01eb: 84,
+    0xe01ec: 84,
+    0xe01ed: 84,
+    0xe01ee: 84,
+    0xe01ef: 84,
 }
 codepoint_classes = {
     'PVALID': (
@@ -2110,7 +4206,6 @@ codepoint_classes = {
         0x1e01b0001e022,
         0x1e0230001e025,
         0x1e0260001e02b,
-        0x1e0300001e06e,
         0x1e08f0001e090,
         0x1e1000001e12d,
         0x1e1300001e13e,
diff --git a/lib/idna/package_data.py b/lib/idna/package_data.py
index c5b7220c..ed811133 100644
--- a/lib/idna/package_data.py
+++ b/lib/idna/package_data.py
@@ -1,2 +1,2 @@
-__version__ = '3.6'
+__version__ = '3.7'
 
diff --git a/requirements.txt b/requirements.txt
index 8d9ca973..dceda760 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -17,7 +17,7 @@ ga4mp==2.0.4
 gntp==1.0.3
 html5lib==1.1
 httpagentparser==1.9.5
-idna==3.6
+idna==3.7
 importlib-metadata==7.1.0
 importlib-resources==6.4.0
 git+https://github.com/Tautulli/ipwhois.git@master#egg=ipwhois

From acf1b2384abb6b6b868c3fce6fcd37507960f815 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 18 Apr 2024 13:03:30 -0700
Subject: [PATCH 584/743] Bump pyinstaller from 6.5.0 to 6.6.0 (#2307)

Bumps [pyinstaller](https://github.com/pyinstaller/pyinstaller) from 6.5.0 to 6.6.0.
- [Release notes](https://github.com/pyinstaller/pyinstaller/releases)
- [Changelog](https://github.com/pyinstaller/pyinstaller/blob/develop/doc/CHANGES.rst)
- [Commits](https://github.com/pyinstaller/pyinstaller/compare/v6.5.0...v6.6.0)

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

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 package/requirements-package.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index 99f35df4..0664c249 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -1,7 +1,7 @@
 apscheduler==3.10.1
 importlib-metadata==7.1.0
 importlib-resources==6.4.0
-pyinstaller==6.5.0
+pyinstaller==6.6.0
 pyopenssl==24.1.0
 pycryptodomex==3.20.0
 

From 52e2950aa9b115d2301d9c56125a7de27a9fed42 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 18 Apr 2024 10:06:21 -0700
Subject: [PATCH 585/743] Add no-referrer policy

---
 data/interfaces/default/base.html    |  1 +
 data/interfaces/default/login.html   |  1 +
 data/interfaces/default/support.html |  2 +-
 data/interfaces/default/welcome.html |  1 +
 plexpy/notifiers.py                  | 13 +++++++------
 5 files changed, 11 insertions(+), 7 deletions(-)

diff --git a/data/interfaces/default/base.html b/data/interfaces/default/base.html
index 6ef08805..5ff448b8 100644
--- a/data/interfaces/default/base.html
+++ b/data/interfaces/default/base.html
@@ -13,6 +13,7 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
     <meta name="description" content="">
     <meta name="author" content="">
+    <meta name="referrer" content="no-referrer">
     <link href="${http_root}css/bootstrap3/bootstrap.min.css" rel="stylesheet">
     <link href="${http_root}css/pnotify.custom.min.css" rel="stylesheet" />
     <link href="${http_root}css/selectize.bootstrap3.css" rel="stylesheet" />
diff --git a/data/interfaces/default/login.html b/data/interfaces/default/login.html
index 63b48deb..f8179fd1 100644
--- a/data/interfaces/default/login.html
+++ b/data/interfaces/default/login.html
@@ -11,6 +11,7 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
     <meta name="description" content="">
     <meta name="author" content="">
+    <meta name="referrer" content="no-referrer">
     <link href="${http_root}css/bootstrap3/bootstrap.min.css" rel="stylesheet">
     <link href="${http_root}css/tautulli.css${cache_param}" rel="stylesheet">
     <link href="${http_root}css/opensans.min.css" rel="stylesheet">
diff --git a/data/interfaces/default/support.html b/data/interfaces/default/support.html
index ab874fad..658fcf61 100644
--- a/data/interfaces/default/support.html
+++ b/data/interfaces/default/support.html
@@ -30,7 +30,7 @@
         <div class="iframe-container">
             <iframe class="iframe" allowfullscreen="true" id="support-iframe" data-name="Tautulli-Support" data-src="https://support.tautulli.com"
                     sandbox="allow-presentation allow-forms allow-same-origin allow-pointer-lock allow-scripts allow-popups allow-modals allow-top-navigation"
-                    style="display: none;">
+                    style="display: none;" rel="noreferrer">
             </iframe>
             <div class="iframe-overlay">
                 <div class="iframe-button-container">
diff --git a/data/interfaces/default/welcome.html b/data/interfaces/default/welcome.html
index e67deb49..39fc19b4 100644
--- a/data/interfaces/default/welcome.html
+++ b/data/interfaces/default/welcome.html
@@ -12,6 +12,7 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
     <meta name="description" content="">
     <meta name="author" content="">
+    <meta name="referrer" content="no-referrer">
     <link href="${http_root}css/bootstrap3/bootstrap.min.css" rel="stylesheet">
     <link href="${http_root}css/bootstrap-wizard.css" rel="stylesheet">
     <link href="${http_root}css/tautulli.css${cache_param}" rel="stylesheet">
diff --git a/plexpy/notifiers.py b/plexpy/notifiers.py
index d871e679..4d7c9735 100644
--- a/plexpy/notifiers.py
+++ b/plexpy/notifiers.py
@@ -2004,7 +2004,8 @@ class IFTTT(Notifier):
                           'value': self.config['key'],
                           'name': 'ifttt_key',
                           'description': 'Your IFTTT webhook key. You can get a key from'
-                                         ' <a href="' + helpers.anon_url('https://ifttt.com/maker_webhooks') + '" target="_blank">here</a>.',
+                                         ' <a href="' + helpers.anon_url('https://ifttt.com/maker_webhooks') +
+                                         '" target="_blank" rel="noreferrer">here</a>.',
                           'input_type': 'token'
                           },
                          {'label': 'IFTTT Event',
@@ -3893,7 +3894,7 @@ class TAUTULLIREMOTEAPP(Notifier):
                                'Instructions can be found in the '
                                '<a href="' + helpers.anon_url(
                                  'https://github.com/%s/%s/wiki/Frequently-Asked-Questions#notifications-pycryptodome'
-                                 % (plexpy.CONFIG.GIT_USER, plexpy.CONFIG.GIT_REPO)) + '" target="_blank">FAQ</a>.' ,
+                                 % (plexpy.CONFIG.GIT_USER, plexpy.CONFIG.GIT_REPO)) + '" target="_blank" rel="noreferrer">FAQ</a>.' ,
                 'input_type': 'help'
             })
         else:
@@ -3905,10 +3906,10 @@ class TAUTULLIREMOTEAPP(Notifier):
             })
 
         config_option[-1]['description'] += ('<br><br>Notifications are sent using '
-            '<a href="' + helpers.anon_url('https://onesignal.com') + '" target="_blank">'
+            '<a href="' + helpers.anon_url('https://onesignal.com') + '" target="_blank" rel="noreferrer">'
             'OneSignal</a>. Some user data is collected and cannot be encrypted.<br>'
             'Please read the <a href="' + helpers.anon_url(
-                'https://onesignal.com/privacy_policy') + '" target="_blank">'
+                'https://onesignal.com/privacy_policy') + '" target="_blank" rel="noreferrer">'
             'OneSignal Privacy Policy</a> for more details.')
 
         devices = self.get_devices()
@@ -4057,7 +4058,7 @@ class TELEGRAM(Notifier):
                           'name': 'telegram_bot_token',
                           'description': 'Your Telegram bot token. '
                                          'Contact <a href="' + helpers.anon_url('https://telegram.me/BotFather') +
-                                         '" target="_blank">@BotFather</a>'
+                                         '" target="_blank" rel="noreferrer">@BotFather</a>'
                                          ' on Telegram to get one.',
                           'input_type': 'token'
                           },
@@ -4066,7 +4067,7 @@ class TELEGRAM(Notifier):
                           'name': 'telegram_chat_id',
                           'description': 'Your Telegram Chat ID, Group ID, Channel ID or @channelusername. '
                                          'Contact <a href="' + helpers.anon_url('https://telegram.me/myidbot') +
-                                         '" target="_blank">@myidbot</a>'
+                                         '" target="_blank" rel="noreferrer">@myidbot</a>'
                                          ' on Telegram to get an ID. '
                                          'For a group topic, append <span class="inline-pre">/topicID</span> to the group ID.',
                           'input_type': 'text'

From 5e02db897fe5931428eb952086a012155eee38ce Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 18 Apr 2024 12:15:01 -0700
Subject: [PATCH 586/743] Remove anonymous redirect

---
 data/interfaces/default/settings.html | 22 -------------------
 plexpy/helpers.py                     | 31 ++-------------------------
 2 files changed, 2 insertions(+), 51 deletions(-)

diff --git a/data/interfaces/default/settings.html b/data/interfaces/default/settings.html
index 883d4d3d..2dd20ff8 100644
--- a/data/interfaces/default/settings.html
+++ b/data/interfaces/default/settings.html
@@ -676,27 +676,6 @@
                             </div>
                         </div>
 
-                        <div class="checkbox advanced-setting">
-                            <label>
-                                <input type="checkbox" name="anon_redirect_dynamic" id="anon_redirect_dynamic" value="1" ${config['anon_redirect_dynamic']} /> Use Dynamic Anonymous Redirect Service
-                            </label>
-                            <p class="help-block">
-                                Allow Tautulli to use the dynamic anonymous redirect service listed <a href="${anon_url('https://tautulli.com/anonymizer.txt')}" target="_blank" rel="noreferrer">here</a>.
-                                Disable to specify your own service.
-                            </p>
-                        </div>
-                        <div id="anon_redirect_options">
-                            <div class="form-group advanced-setting">
-                                <label for="anon_redirect">Anonymous Redirect Service</label>
-                                <div class="row">
-                                    <div class="col-md-4">
-                                        <input type="text" class="form-control" id="anon_redirect" name="anon_redirect" value="${config['anon_redirect']}" size="30">
-                                    </div>
-                                </div>
-                                <p class="help-block">Backlink protection via anonymizer service, must end in "?". Leave blank to disable.</p>
-                            </div>
-                        </div>
-
                         <div class="padded-header">
                             <h3>Authentication</h3>
                         </div>
@@ -2416,7 +2395,6 @@ $(document).ready(function() {
 
     initConfigCheckbox('#api_enabled');
     initConfigCheckbox('#enable_https');
-    initConfigCheckbox('#anon_redirect_dynamic', null, true);
     initConfigCheckbox('#https_create_cert');
     initConfigCheckbox('#check_github');
     initConfigCheckbox('#monitor_pms_updates');
diff --git a/plexpy/helpers.py b/plexpy/helpers.py
index dc83fcb3..c2594412 100644
--- a/plexpy/helpers.py
+++ b/plexpy/helpers.py
@@ -784,36 +784,9 @@ def whois_lookup(ip_address):
     return whois_info
 
 
-# Taken from SickRage
 def anon_url(*url):
-    """
-    Return a URL string consisting of the Anonymous redirect URL and an arbitrary number of values appended.
-    """
-    if plexpy.CONFIG.ANON_REDIRECT_DYNAMIC:
-        cache_time = timestamp()
-        cache_filepath = os.path.join(plexpy.CONFIG.CACHE_DIR, 'anonymizer.json')
-        try:
-            with open(cache_filepath, 'r', encoding='utf-8') as cache_file:
-                cache_data = json.load(cache_file)
-                if cache_time - cache_data['_cache_time'] < 86400:  # 24 hours
-                    anon_redirect = cache_data['anon_redirect']
-                else:
-                    raise
-        except:
-            try:
-                anon_redirect = request.request_content('https://tautulli.com/anonymizer.txt').decode('utf-8')
-                cache_data = {
-                    'anon_redirect': anon_redirect,
-                    '_cache_time': cache_time
-                }
-                with open(cache_filepath, 'w', encoding='utf-8') as cache_file:
-                    json.dump(cache_data, cache_file)
-            except:
-                anon_redirect = plexpy.CONFIG.ANON_REDIRECT
-    else:
-        anon_redirect = plexpy.CONFIG.ANON_REDIRECT
-
-    return '' if None in url else '%s%s' % (anon_redirect, ''.join(str(s) for s in url))
+    # Removed anonymous redirect and just return the URL
+    return '' if None in url else ''.join(str(s) for s in url)
 
 
 def get_img_service(include_self=False):

From a7660d5c0312732bff4b73b5ec20b85ed22de68e Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 18 Apr 2024 22:41:23 -0700
Subject: [PATCH 587/743] v2.14.0-beta

---
 CHANGELOG.md      | 35 +++++++++++++++++++++++++++++++++++
 plexpy/version.py |  4 ++--
 2 files changed, 37 insertions(+), 2 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 26dc180c..f9a00257 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,40 @@
 # Changelog
 
+## v2.14.0-beta (2024-04-19)
+
+* History:
+  * Fix: Live TV activity not logging to history.
+  * Fix: Incorrect grouping of live TV history.
+* Notifications:
+  * Fix: Pushover configuration settings refreshing after entering a token.
+  * Fix: Plex remote access down notifications not triggering.
+  * Fix: Deleting all images from Cloudinary only deleting 1000 images.
+  * New: Added platform version and product version notification parameters.
+  * New: Added LAN streams and WAN streams notification parameters.
+  * New: Added Dolby Vision notification parameters.
+  * New: Added live TV channel notification parameters.
+  * Change: Improved Tautulli Remote App notification encryption method.
+    * Note: Requires Tautulli Remote App version 3.2.4.
+* Exporter:
+  * New: Added slug attribute to exporter fields.
+  * New: Added track genres to exporter fields.
+  * New: Added playlist source URI to exporter fields.
+* UI:
+  * Fix: Mask deleted usernames in the logs.
+  * Fix: Live TV watch stats not showing on the media info page.
+  * Removed: Deprecated synced item pages.
+  * Removed: Anonymous redirect settings. Links now use browser no-referrer policy instead.
+* API:
+  * New: Added Dolby Vision info to the get_metadata API command.
+  * New: Added before and after parameters to the get_home_stats API command.
+* Packages:
+  * New: Universal binary for macOS for Apple silicon.
+  * New: Bump Snap package to core22.
+* Other:
+  * Change: Login cookie expires changed to max-age.
+  * Change: Improved key generation for login password. It is recommended to reenter your HTTP Password in the settings after upgrading.
+
+
 ## v2.13.4 (2023-12-07)
 
 * UI:
diff --git a/plexpy/version.py b/plexpy/version.py
index 433710bc..e0d43b73 100644
--- a/plexpy/version.py
+++ b/plexpy/version.py
@@ -17,5 +17,5 @@
 
 from __future__ import unicode_literals
 
-PLEXPY_BRANCH = "master"
-PLEXPY_RELEASE_VERSION = "v2.13.4"
\ No newline at end of file
+PLEXPY_BRANCH = "beta"
+PLEXPY_RELEASE_VERSION = "v2.14.0-beta"
\ No newline at end of file

From 5de2cf85c380e09bb2614dbaf952dd61ff9f951c Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 9 May 2024 20:49:06 -0700
Subject: [PATCH 588/743] Workaround users remaining in friends list without
 shared libraries

---
 plexpy/users.py | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/plexpy/users.py b/plexpy/users.py
index 974d30cd..67293800 100644
--- a/plexpy/users.py
+++ b/plexpy/users.py
@@ -63,13 +63,15 @@ def refresh_users():
         new_users = []
 
         for item in result:
-            user_ids.append(helpers.cast_to_int(item['user_id']))
-
             if item.get('shared_libraries'):
                 item['shared_libraries'] = ';'.join(item['shared_libraries'])
+                # Only add user if libraries are shared
+                user_ids.add(helpers.cast_to_int(item['user_id']))
             elif item.get('server_token'):
                 libs = libraries.Libraries().get_sections()
                 item['shared_libraries'] = ';'.join([str(l['section_id']) for l in libs])
+                # Only add user if libraries are shared
+                user_ids.add(helpers.cast_to_int(item['user_id']))
 
             keys_dict = {"user_id": item.pop('user_id')}
 
@@ -101,7 +103,7 @@ def refresh_users():
         query = "UPDATE users SET is_active = 0 WHERE user_id NOT IN ({})".format(", ".join(["?"] * len(user_ids)))
         monitor_db.action(query=query, args=user_ids)
 
-        # Add new users to loger username filter
+        # Add new users to logger username filter
         logger.filter_usernames(new_users)
 
         logger.info("Tautulli Users :: Users list refreshed.")

From 65905a6647de6a52a87a357c2f144d5ed567783f Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 9 May 2024 21:52:39 -0700
Subject: [PATCH 589/743] Fix escaping regex string

---
 plexpy/helpers.py | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/plexpy/helpers.py b/plexpy/helpers.py
index c2594412..b2be62e2 100644
--- a/plexpy/helpers.py
+++ b/plexpy/helpers.py
@@ -345,7 +345,7 @@ def bytes_to_mb(bytes):
 
 
 def mb_to_bytes(mb_str):
-    result = re.search('^(\d+(?:\.\d+)?)\s?(?:mb)?', mb_str, flags=re.I)
+    result = re.search(r'^(\d+(?:\.\d+)?)\s?(?:mb)?', mb_str, flags=re.I)
     if result:
         return int(float(result.group(1)) * 1048576)
 
@@ -395,9 +395,9 @@ def replace_all(text, dic, normalize=False):
 
 def replace_illegal_chars(string, type="file"):
     if type == "file":
-        string = re.sub('[\?"*:|<>/]', '_', string)
+        string = re.sub(r'[\?"*:|<>/]', '_', string)
     if type == "folder":
-        string = re.sub('[:\?<>"|]', '_', string)
+        string = re.sub(r'[:\?<>"|]', '_', string)
 
     return string
 
@@ -405,14 +405,14 @@ def replace_illegal_chars(string, type="file"):
 def cleanName(string):
 
     pass1 = latinToAscii(string).lower()
-    out_string = re.sub('[\.\-\/\!\@\#\$\%\^\&\*\(\)\+\-\"\'\,\;\:\[\]\{\}\<\>\=\_]', '', pass1).encode('utf-8')
+    out_string = re.sub(r'[\.\-\/\!\@\#\$\%\^\&\*\(\)\+\-\"\'\,\;\:\[\]\{\}\<\>\=\_]', '', pass1).encode('utf-8')
 
     return out_string
 
 
 def cleanTitle(title):
 
-    title = re.sub('[\.\-\/\_]', ' ', title).lower()
+    title = re.sub(r'[\.\-\/\_]', ' ', title).lower()
 
     # Strip out extra whitespace
     title = ' '.join(title.split())

From dcec1f6f5f661164ef39856cc01f9b91b1b9158a Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 9 May 2024 21:55:26 -0700
Subject: [PATCH 590/743] Update snapcraft git data folder

---
 snap/snapcraft.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/snap/snapcraft.yaml b/snap/snapcraft.yaml
index 612b189d..6f76e8cc 100644
--- a/snap/snapcraft.yaml
+++ b/snap/snapcraft.yaml
@@ -38,7 +38,7 @@ parts:
       - python3-pkg-resources
     override-pull: |
       craftctl default
-      git config --global --add safe.directory /root/parts/tautulli/src
+      git config --global --add safe.directory /data/parts/tautulli/src
       TAG_FULL=$(git describe --tag)
       TAG=$(echo $TAG_FULL | grep -oP '(v\d+\.\d+\.\d+(?>-beta)?)')
       BRANCH=$(git rev-parse --abbrev-ref HEAD)

From de3393d62b3bef3c83a1f368ab12bc77b0114a87 Mon Sep 17 00:00:00 2001
From: Tom Niget <zippedfire@free.fr>
Date: Fri, 10 May 2024 07:18:08 +0200
Subject: [PATCH 591/743] Remove Python 2 handling code (#2098)

* Remove Python 2 update modal

* Remove Python 2 handling code

* Remove backports dependencies

* Remove uses of future and __future__

* Fix import

* Remove requirements

* Update lib folder

* Clean up imports and blank lines

---------

Co-authored-by: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
---
 Tautulli.py                                   |    1 -
 data/interfaces/default/index.html            |   34 -
 .../default/newsletter_preview.html           |    2 +-
 lib/backports/__init__.py                     |    2 +-
 lib/backports/csv.py                          |  979 ------
 lib/backports/functools_lru_cache.py          |  243 --
 lib/backports/tarfile/__init__.py             | 2902 +++++++++++++++++
 lib/backports/tarfile/__main__.py             |    5 +
 .../tarfile}/compat/__init__.py               |    0
 lib/backports/tarfile/compat/py38.py          |   24 +
 lib/future/__init__.py                        |   19 +-
 lib/future/backports/datetime.py              |    2 +-
 .../backports/email/_header_value_parser.py   |    2 +-
 lib/future/backports/email/parser.py          |    4 +-
 lib/future/backports/http/cookiejar.py        |    2 +-
 lib/future/backports/test/support.py          |   32 -
 lib/future/backports/xmlrpc/client.py         |    9 +-
 lib/future/builtins/__init__.py               |    2 +-
 lib/future/moves/_dummy_thread.py             |   11 +-
 lib/future/moves/multiprocessing.py           |    7 +
 lib/future/moves/test/support.py              |    9 +
 lib/future/standard_library/__init__.py       |   14 +-
 lib/future/types/newint.py                    |    8 +-
 lib/future/types/newrange.py                  |    2 +-
 lib/inflect/__init__.py                       |  313 +-
 lib/inflect/compat/pydantic.py                |   19 -
 lib/inflect/compat/pydantic1.py               |    8 -
 lib/jaraco/classes/ancestry.py                |   68 -
 lib/jaraco/classes/meta.py                    |   66 -
 lib/jaraco/classes/properties.py              |  170 -
 lib/jaraco/collections/__init__.py            |   56 +-
 lib/jaraco/context.py                         |  137 +-
 lib/jaraco/functools/__init__.pyi             |    3 -
 lib/libfuturize/fixer_util.py                 |   12 +-
 lib/libfuturize/fixes/fix_metaclass.py        |    4 +-
 lib/libpasteurize/fixes/fix_imports.py        |    1 +
 lib/libpasteurize/fixes/fix_unpacking.py      |    8 +-
 lib/past/__init__.py                          |    4 +-
 lib/past/builtins/misc.py                     |    9 +-
 lib/past/translation/__init__.py              |  258 +-
 lib/typeguard/__init__.py                     |   48 +
 lib/typeguard/_checkers.py                    |  910 ++++++
 lib/typeguard/_config.py                      |  108 +
 lib/typeguard/_decorators.py                  |  235 ++
 lib/typeguard/_exceptions.py                  |   42 +
 lib/typeguard/_functions.py                   |  308 ++
 lib/typeguard/_importhook.py                  |  213 ++
 lib/typeguard/_memo.py                        |   48 +
 lib/typeguard/_pytest_plugin.py               |  126 +
 lib/typeguard/_suppression.py                 |   86 +
 lib/typeguard/_transformer.py                 | 1229 +++++++
 lib/typeguard/_union_transformer.py           |   55 +
 lib/typeguard/_utils.py                       |  163 +
 lib/typeguard/py.typed                        |    0
 lib/typing_extensions.py                      |  203 +-
 plexpy/__init__.py                            |   82 +-
 plexpy/activity_handler.py                    |   27 +-
 plexpy/activity_pinger.py                     |   34 +-
 plexpy/activity_processor.py                  |   24 +-
 plexpy/api2.py                                |   46 +-
 plexpy/classes.py                             |   75 -
 plexpy/common.py                              |    8 +-
 plexpy/config.py                              |   12 +-
 plexpy/database.py                            |   12 +-
 plexpy/datafactory.py                         |   34 +-
 plexpy/datatables.py                          |   14 +-
 plexpy/exceptions.py                          |    2 -
 plexpy/exporter.py                            |   25 +-
 plexpy/graphs.py                              |   27 +-
 plexpy/helpers.py                             |   34 +-
 plexpy/http_handler.py                        |   14 +-
 plexpy/libraries.py                           |   38 +-
 plexpy/lock.py                                |   10 +-
 plexpy/log_reader.py                          |    9 +-
 plexpy/logger.py                              |   12 +-
 plexpy/macos.py                               |   11 +-
 plexpy/mobile_app.py                          |   15 +-
 plexpy/newsletter_handler.py                  |   16 +-
 plexpy/newsletters.py                         |   38 +-
 plexpy/notification_handler.py                |   61 +-
 plexpy/notifiers.py                           |   53 +-
 plexpy/plex.py                                |    9 -
 plexpy/plexivity_import.py                    |   24 +-
 plexpy/plextv.py                              |   33 +-
 plexpy/plexwatch_import.py                    |   21 +-
 plexpy/pmsconnect.py                          |   36 +-
 plexpy/request.py                             |   15 +-
 plexpy/session.py                             |   11 +-
 plexpy/users.py                               |   33 +-
 plexpy/version.py                             |    2 -
 plexpy/versioncheck.py                        |   26 +-
 plexpy/web_socket.py                          |   20 +-
 plexpy/webauth.py                             |   21 +-
 plexpy/webserve.py                            |  119 +-
 plexpy/webstart.py                            |   14 +-
 plexpy/windows.py                             |   12 +-
 requirements.txt                              |    6 +-
 97 files changed, 7443 insertions(+), 2917 deletions(-)
 delete mode 100644 lib/backports/csv.py
 delete mode 100644 lib/backports/functools_lru_cache.py
 create mode 100644 lib/backports/tarfile/__init__.py
 create mode 100644 lib/backports/tarfile/__main__.py
 rename lib/{inflect => backports/tarfile}/compat/__init__.py (100%)
 create mode 100644 lib/backports/tarfile/compat/py38.py
 create mode 100644 lib/future/moves/multiprocessing.py
 delete mode 100644 lib/inflect/compat/pydantic.py
 delete mode 100644 lib/inflect/compat/pydantic1.py
 delete mode 100644 lib/jaraco/classes/ancestry.py
 delete mode 100644 lib/jaraco/classes/meta.py
 delete mode 100644 lib/jaraco/classes/properties.py
 create mode 100644 lib/typeguard/__init__.py
 create mode 100644 lib/typeguard/_checkers.py
 create mode 100644 lib/typeguard/_config.py
 create mode 100644 lib/typeguard/_decorators.py
 create mode 100644 lib/typeguard/_exceptions.py
 create mode 100644 lib/typeguard/_functions.py
 create mode 100644 lib/typeguard/_importhook.py
 create mode 100644 lib/typeguard/_memo.py
 create mode 100644 lib/typeguard/_pytest_plugin.py
 create mode 100644 lib/typeguard/_suppression.py
 create mode 100644 lib/typeguard/_transformer.py
 create mode 100644 lib/typeguard/_union_transformer.py
 create mode 100644 lib/typeguard/_utils.py
 create mode 100644 lib/typeguard/py.typed
 delete mode 100644 plexpy/classes.py

diff --git a/Tautulli.py b/Tautulli.py
index 04a6778e..8616df81 100755
--- a/Tautulli.py
+++ b/Tautulli.py
@@ -23,7 +23,6 @@ import sys
 # Ensure lib added to path, before any other imports
 sys.path.insert(0, os.path.join(os.path.dirname(os.path.abspath(__file__)), 'lib'))
 
-from future.builtins import str
 
 import argparse
 import datetime
diff --git a/data/interfaces/default/index.html b/data/interfaces/default/index.html
index 4a74b2e4..6e4818c7 100644
--- a/data/interfaces/default/index.html
+++ b/data/interfaces/default/index.html
@@ -212,28 +212,6 @@
         </div>
     </div>
 </div>
-<% from plexpy.helpers import anon_url %>
-<div id="python2-modal" class="modal fade wide" tabindex="-1" role="dialog" aria-labelledby="python2-modal">
-    <div class="modal-dialog" role="document">
-        <div class="modal-content">
-            <div class="modal-header">
-                <button type="button" class="close" data-dismiss="modal" aria-hidden="true"><i class="fa fa-remove"></i></button>
-                <h4 class="modal-title">Unable to Update</h4>
-            </div>
-            <div class="modal-body" style="text-align: center;">
-                <p>Tautulli is still running using Python 2 and cannot be updated past v2.6.3.</p>
-                <p>Python 3 is required to continue receiving updates.</p>
-                <p>
-                    <strong>Please see the <a href="${anon_url('https://github.com/Tautulli/Tautulli/wiki/Upgrading-to-Python-3-%28Tautulli-v2.5%29')}" target="_blank" rel="noreferrer">wiki</a>
-                    for instructions on how to upgrade to Python 3.</strong>
-                </p>
-            </div>
-            <div class="modal-footer">
-                <input type="button" class="btn btn-bright" data-dismiss="modal" value="Close">
-            </div>
-        </div>
-    </div>
-</div>
 % endif
 
 <div class="modal fade" id="ip-info-modal" tabindex="-1" role="dialog" aria-labelledby="ip-info-modal">
@@ -1067,16 +1045,4 @@
     });
 </script>
 % endif
-% if _session['user_group'] == 'admin':
-<script>
-    const queryString = window.location.search;
-    const urlParams = new URLSearchParams(queryString);
-    if (urlParams.get('update') === 'python2') {
-        $("#python2-modal").modal({
-                backdrop: 'static',
-                keyboard: false
-        });
-    }
-</script>
-% endif
 </%def>
diff --git a/data/interfaces/default/newsletter_preview.html b/data/interfaces/default/newsletter_preview.html
index 97a9073c..41534d3f 100644
--- a/data/interfaces/default/newsletter_preview.html
+++ b/data/interfaces/default/newsletter_preview.html
@@ -1,5 +1,5 @@
 <%
-    from six.moves.urllib.parse import urlencode
+    from urllib.parse import urlencode
 %>
 <!doctype html>
 
diff --git a/lib/backports/__init__.py b/lib/backports/__init__.py
index 0d1f7edf..8db66d3d 100644
--- a/lib/backports/__init__.py
+++ b/lib/backports/__init__.py
@@ -1 +1 @@
-__path__ = __import__('pkgutil').extend_path(__path__, __name__)  # type: ignore
+__path__ = __import__("pkgutil").extend_path(__path__, __name__)
diff --git a/lib/backports/csv.py b/lib/backports/csv.py
deleted file mode 100644
index 4694a28e..00000000
--- a/lib/backports/csv.py
+++ /dev/null
@@ -1,979 +0,0 @@
-# -*- coding: utf-8 -*-
-"""A port of Python 3's csv module to Python 2.
-
-The API of the csv module in Python 2 is drastically different from
-the csv module in Python 3. This is due, for the most part, to the
-difference between str in Python 2 and Python 3.
-
-The semantics of Python 3's version are more useful because they support
-unicode natively, while Python 2's csv does not.
-"""
-from __future__ import unicode_literals, absolute_import
-
-__all__ = [ "QUOTE_MINIMAL", "QUOTE_ALL", "QUOTE_NONNUMERIC", "QUOTE_NONE",
-            "Error", "Dialect", "__doc__", "excel", "excel_tab",
-            "field_size_limit", "reader", "writer",
-            "register_dialect", "get_dialect", "list_dialects", "Sniffer",
-            "unregister_dialect", "__version__", "DictReader", "DictWriter" ]
-
-import re
-import numbers
-from io import StringIO
-from csv import (
-    QUOTE_MINIMAL, QUOTE_ALL, QUOTE_NONNUMERIC, QUOTE_NONE,
-    __version__, __doc__, Error, field_size_limit,
-)
-
-# Stuff needed from six
-import sys
-PY3 = sys.version_info[0] == 3
-if PY3:
-    string_types = str
-    text_type = str
-    binary_type = bytes
-    unichr = chr
-else:
-    string_types = basestring
-    text_type = unicode
-    binary_type = str
-
-
-class QuoteStrategy(object):
-    quoting = None
-
-    def __init__(self, dialect):
-        if self.quoting is not None:
-            assert dialect.quoting == self.quoting
-        self.dialect = dialect
-        self.setup()
-
-        escape_pattern_quoted = r'({quotechar})'.format(
-            quotechar=re.escape(self.dialect.quotechar or '"'))
-        escape_pattern_unquoted = r'([{specialchars}])'.format(
-            specialchars=re.escape(self.specialchars))
-
-        self.escape_re_quoted = re.compile(escape_pattern_quoted)
-        self.escape_re_unquoted = re.compile(escape_pattern_unquoted)
-
-    def setup(self):
-        """Optional method for strategy-wide optimizations."""
-
-    def quoted(self, field=None, raw_field=None, only=None):
-        """Determine whether this field should be quoted."""
-        raise NotImplementedError(
-            'quoted must be implemented by a subclass')
-
-    @property
-    def specialchars(self):
-        """The special characters that need to be escaped."""
-        raise NotImplementedError(
-            'specialchars must be implemented by a subclass')
-
-    def escape_re(self, quoted=None):
-        if quoted:
-            return self.escape_re_quoted
-        return self.escape_re_unquoted
-
-    def escapechar(self, quoted=None):
-        if quoted and self.dialect.doublequote:
-            return self.dialect.quotechar
-        return self.dialect.escapechar
-
-    def prepare(self, raw_field, only=None):
-        field = text_type(raw_field if raw_field is not None else '')
-        quoted = self.quoted(field=field, raw_field=raw_field, only=only)
-
-        escape_re = self.escape_re(quoted=quoted)
-        escapechar = self.escapechar(quoted=quoted)
-
-        if escape_re.search(field):
-            escapechar = '\\\\' if escapechar == '\\' else escapechar
-            if not escapechar:
-                raise Error('No escapechar is set')
-            escape_replace = r'{escapechar}\1'.format(escapechar=escapechar)
-            field = escape_re.sub(escape_replace, field)
-
-        if quoted:
-            field = '{quotechar}{field}{quotechar}'.format(
-                quotechar=self.dialect.quotechar, field=field)
-
-        return field
-
-
-class QuoteMinimalStrategy(QuoteStrategy):
-    quoting = QUOTE_MINIMAL
-
-    def setup(self):
-        self.quoted_re = re.compile(r'[{specialchars}]'.format(
-            specialchars=re.escape(self.specialchars)))
-
-    @property
-    def specialchars(self):
-        return (
-            self.dialect.lineterminator +
-            self.dialect.quotechar +
-            self.dialect.delimiter +
-            (self.dialect.escapechar or '')
-        )
-
-    def quoted(self, field, only, **kwargs):
-        if field == self.dialect.quotechar and not self.dialect.doublequote:
-            # If the only character in the field is the quotechar, and
-            # doublequote is false, then just escape without outer quotes.
-            return False
-        return field == '' and only or bool(self.quoted_re.search(field))
-
-
-class QuoteAllStrategy(QuoteStrategy):
-    quoting = QUOTE_ALL
-
-    @property
-    def specialchars(self):
-        return self.dialect.quotechar
-
-    def quoted(self, **kwargs):
-        return True
-
-
-class QuoteNonnumericStrategy(QuoteStrategy):
-    quoting = QUOTE_NONNUMERIC
-
-    @property
-    def specialchars(self):
-        return (
-            self.dialect.lineterminator +
-            self.dialect.quotechar +
-            self.dialect.delimiter +
-            (self.dialect.escapechar or '')
-        )
-
-    def quoted(self, raw_field, **kwargs):
-        return not isinstance(raw_field, numbers.Number)
-
-
-class QuoteNoneStrategy(QuoteStrategy):
-    quoting = QUOTE_NONE
-
-    @property
-    def specialchars(self):
-        return (
-            self.dialect.lineterminator +
-            (self.dialect.quotechar or '') +
-            self.dialect.delimiter +
-            (self.dialect.escapechar or '')
-        )
-
-    def quoted(self, field, only, **kwargs):
-        if field == '' and only:
-            raise Error('single empty field record must be quoted')
-        return False
-
-
-class writer(object):
-    def __init__(self, fileobj, dialect='excel', **fmtparams):
-        if fileobj is None:
-            raise TypeError('fileobj must be file-like, not None')
-
-        self.fileobj = fileobj
-
-        if isinstance(dialect, text_type):
-            dialect = get_dialect(dialect)
-
-        try:
-            self.dialect = Dialect.combine(dialect, fmtparams)
-        except Error as e:
-            raise TypeError(*e.args)
-
-        strategies = {
-            QUOTE_MINIMAL: QuoteMinimalStrategy,
-            QUOTE_ALL: QuoteAllStrategy,
-            QUOTE_NONNUMERIC: QuoteNonnumericStrategy,
-            QUOTE_NONE: QuoteNoneStrategy,
-        }
-        self.strategy = strategies[self.dialect.quoting](self.dialect)
-
-    def writerow(self, row):
-        if row is None:
-            raise Error('row must be an iterable')
-
-        row = list(row)
-        only = len(row) == 1
-        row = [self.strategy.prepare(field, only=only) for field in row]
-
-        line = self.dialect.delimiter.join(row) + self.dialect.lineterminator
-        return self.fileobj.write(line)
-
-    def writerows(self, rows):
-        for row in rows:
-            self.writerow(row)
-
-
-START_RECORD = 0
-START_FIELD = 1
-ESCAPED_CHAR = 2
-IN_FIELD = 3
-IN_QUOTED_FIELD = 4
-ESCAPE_IN_QUOTED_FIELD = 5
-QUOTE_IN_QUOTED_FIELD = 6
-EAT_CRNL = 7
-AFTER_ESCAPED_CRNL = 8
-
-
-class reader(object):
-    def __init__(self, fileobj, dialect='excel', **fmtparams):
-        self.input_iter = iter(fileobj)
-
-        if isinstance(dialect, text_type):
-            dialect = get_dialect(dialect)
-
-        try:
-            self.dialect = Dialect.combine(dialect, fmtparams)
-        except Error as e:
-            raise TypeError(*e.args)
-
-        self.fields = None
-        self.field = None
-        self.line_num = 0
-
-    def parse_reset(self):
-        self.fields = []
-        self.field = []
-        self.state = START_RECORD
-        self.numeric_field = False
-
-    def parse_save_field(self):
-        field = ''.join(self.field)
-        self.field = []
-        if self.numeric_field:
-            field = float(field)
-            self.numeric_field = False
-        self.fields.append(field)
-
-    def parse_add_char(self, c):
-        if len(self.field) >= field_size_limit():
-            raise Error('field size limit exceeded')
-        self.field.append(c)
-
-    def parse_process_char(self, c):
-        switch = {
-            START_RECORD: self._parse_start_record,
-            START_FIELD: self._parse_start_field,
-            ESCAPED_CHAR: self._parse_escaped_char,
-            AFTER_ESCAPED_CRNL: self._parse_after_escaped_crnl,
-            IN_FIELD: self._parse_in_field,
-            IN_QUOTED_FIELD: self._parse_in_quoted_field,
-            ESCAPE_IN_QUOTED_FIELD: self._parse_escape_in_quoted_field,
-            QUOTE_IN_QUOTED_FIELD: self._parse_quote_in_quoted_field,
-            EAT_CRNL: self._parse_eat_crnl,
-        }
-        return switch[self.state](c)
-
-    def _parse_start_record(self, c):
-        if c == '\0':
-            return
-        elif c == '\n' or c == '\r':
-            self.state = EAT_CRNL
-            return
-
-        self.state = START_FIELD
-        return self._parse_start_field(c)
-
-    def _parse_start_field(self, c):
-        if c == '\n' or c == '\r' or c == '\0':
-            self.parse_save_field()
-            self.state = START_RECORD if c == '\0' else EAT_CRNL
-        elif (c == self.dialect.quotechar and
-              self.dialect.quoting != QUOTE_NONE):
-            self.state = IN_QUOTED_FIELD
-        elif c == self.dialect.escapechar:
-            self.state = ESCAPED_CHAR
-        elif c == ' ' and self.dialect.skipinitialspace:
-            pass  # Ignore space at start of field
-        elif c == self.dialect.delimiter:
-            # Save empty field
-            self.parse_save_field()
-        else:
-            # Begin new unquoted field
-            if self.dialect.quoting == QUOTE_NONNUMERIC:
-                self.numeric_field = True
-            self.parse_add_char(c)
-            self.state = IN_FIELD
-
-    def _parse_escaped_char(self, c):
-        if c == '\n' or c == '\r':
-            self.parse_add_char(c)
-            self.state = AFTER_ESCAPED_CRNL
-            return
-        if c == '\0':
-            c = '\n'
-        self.parse_add_char(c)
-        self.state = IN_FIELD
-
-    def _parse_after_escaped_crnl(self, c):
-        if c == '\0':
-            return
-        return self._parse_in_field(c)
-
-    def _parse_in_field(self, c):
-        # In unquoted field
-        if c == '\n' or c == '\r' or c == '\0':
-            # End of line - return [fields]
-            self.parse_save_field()
-            self.state = START_RECORD if c == '\0' else EAT_CRNL
-        elif c == self.dialect.escapechar:
-            self.state = ESCAPED_CHAR
-        elif c == self.dialect.delimiter:
-            self.parse_save_field()
-            self.state = START_FIELD
-        else:
-            # Normal character - save in field
-            self.parse_add_char(c)
-
-    def _parse_in_quoted_field(self, c):
-        if c == '\0':
-            pass
-        elif c == self.dialect.escapechar:
-            self.state = ESCAPE_IN_QUOTED_FIELD
-        elif (c == self.dialect.quotechar and
-              self.dialect.quoting != QUOTE_NONE):
-            if self.dialect.doublequote:
-                self.state = QUOTE_IN_QUOTED_FIELD
-            else:
-                self.state = IN_FIELD
-        else:
-            self.parse_add_char(c)
-
-    def _parse_escape_in_quoted_field(self, c):
-        if c == '\0':
-            c = '\n'
-
-        self.parse_add_char(c)
-        self.state = IN_QUOTED_FIELD
-
-    def _parse_quote_in_quoted_field(self, c):
-        if (self.dialect.quoting != QUOTE_NONE and
-                c == self.dialect.quotechar):
-            # save "" as "
-            self.parse_add_char(c)
-            self.state = IN_QUOTED_FIELD
-        elif c == self.dialect.delimiter:
-            self.parse_save_field()
-            self.state = START_FIELD
-        elif c == '\n' or c == '\r' or c == '\0':
-            # End of line = return [fields]
-            self.parse_save_field()
-            self.state = START_RECORD if c == '\0' else EAT_CRNL
-        elif not self.dialect.strict:
-            self.parse_add_char(c)
-            self.state = IN_FIELD
-        else:
-            # illegal
-            raise Error("{delimiter}' expected after '{quotechar}".format(
-                delimiter=self.dialect.delimiter,
-                quotechar=self.dialect.quotechar,
-            ))
-
-    def _parse_eat_crnl(self, c):
-        if c == '\n' or c == '\r':
-            pass
-        elif c == '\0':
-            self.state = START_RECORD
-        else:
-            raise Error('new-line character seen in unquoted field - do you '
-                        'need to open the file in universal-newline mode?')
-
-
-    def __iter__(self):
-        return self
-
-    def __next__(self):
-        self.parse_reset()
-
-        while True:
-            try:
-                lineobj = next(self.input_iter)
-            except StopIteration:
-                if len(self.field) != 0 or self.state == IN_QUOTED_FIELD:
-                    if self.dialect.strict:
-                        raise Error('unexpected end of data')
-                    self.parse_save_field()
-                if self.fields:
-                    break
-                raise
-
-            if not isinstance(lineobj, text_type):
-                typ = type(lineobj)
-                typ_name = 'bytes' if typ == bytes else typ.__name__
-                err_str = ('iterator should return strings, not {0}'
-                           ' (did you open the file in text mode?)')
-                raise Error(err_str.format(typ_name))
-
-            self.line_num += 1
-            for c in lineobj:
-                if c == '\0':
-                    raise Error('line contains NULL byte')
-                self.parse_process_char(c)
-
-            self.parse_process_char('\0')
-
-            if self.state == START_RECORD:
-                break
-
-        fields = self.fields
-        self.fields = None
-        return fields
-
-    next = __next__
-
-
-_dialect_registry = {}
-def register_dialect(name, dialect='excel', **fmtparams):
-    if not isinstance(name, text_type):
-        raise TypeError('"name" must be a string')
-
-    dialect = Dialect.extend(dialect, fmtparams)
-
-    try:
-        Dialect.validate(dialect)
-    except:
-        raise TypeError('dialect is invalid')
-
-    assert name not in _dialect_registry
-    _dialect_registry[name] = dialect
-
-def unregister_dialect(name):
-    try:
-        _dialect_registry.pop(name)
-    except KeyError:
-        raise Error('"{name}" not a registered dialect'.format(name=name))
-
-def get_dialect(name):
-    try:
-        return _dialect_registry[name]
-    except KeyError:
-        raise Error('Could not find dialect {0}'.format(name))
-
-def list_dialects():
-    return list(_dialect_registry)
-
-
-class Dialect(object):
-    """Describe a CSV dialect.
-    This must be subclassed (see csv.excel).  Valid attributes are:
-    delimiter, quotechar, escapechar, doublequote, skipinitialspace,
-    lineterminator, quoting, strict.
-    """
-    _name = ""
-    _valid = False
-    # placeholders
-    delimiter = None
-    quotechar = None
-    escapechar = None
-    doublequote = None
-    skipinitialspace = None
-    lineterminator = None
-    quoting = None
-    strict = None
-
-    def __init__(self):
-        self.validate(self)
-        if self.__class__ != Dialect:
-            self._valid = True
-
-    @classmethod
-    def validate(cls, dialect):
-        dialect = cls.extend(dialect)
-
-        if not isinstance(dialect.quoting, int):
-            raise Error('"quoting" must be an integer')
-
-        if dialect.delimiter is None:
-            raise Error('delimiter must be set')
-        cls.validate_text(dialect, 'delimiter')
-
-        if dialect.lineterminator is None:
-            raise Error('lineterminator must be set')
-        if not isinstance(dialect.lineterminator, text_type):
-            raise Error('"lineterminator" must be a string')
-
-        if dialect.quoting not in [
-                QUOTE_NONE, QUOTE_MINIMAL, QUOTE_NONNUMERIC, QUOTE_ALL]:
-            raise Error('Invalid quoting specified')
-
-        if dialect.quoting != QUOTE_NONE:
-            if dialect.quotechar is None and dialect.escapechar is None:
-                raise Error('quotechar must be set if quoting enabled')
-            if dialect.quotechar is not None:
-                cls.validate_text(dialect, 'quotechar')
-
-    @staticmethod
-    def validate_text(dialect, attr):
-        val = getattr(dialect, attr)
-        if not isinstance(val, text_type):
-            if type(val) == bytes:
-                raise Error('"{0}" must be string, not bytes'.format(attr))
-            raise Error('"{0}" must be string, not {1}'.format(
-                attr, type(val).__name__))
-
-        if len(val) != 1:
-            raise Error('"{0}" must be a 1-character string'.format(attr))
-
-    @staticmethod
-    def defaults():
-        return {
-            'delimiter': ',',
-            'doublequote': True,
-            'escapechar': None,
-            'lineterminator': '\r\n',
-            'quotechar': '"',
-            'quoting': QUOTE_MINIMAL,
-            'skipinitialspace': False,
-            'strict': False,
-        }
-
-    @classmethod
-    def extend(cls, dialect, fmtparams=None):
-        if isinstance(dialect, string_types):
-            dialect = get_dialect(dialect)
-
-        if fmtparams is None:
-            return dialect
-
-        defaults = cls.defaults()
-
-        if any(param not in defaults for param in fmtparams):
-            raise TypeError('Invalid fmtparam')
-
-        specified = dict(
-            (attr, getattr(dialect, attr, None))
-            for attr in cls.defaults()
-        )
-
-        specified.update(fmtparams)
-        return type(str('ExtendedDialect'), (cls,), specified)
-
-    @classmethod
-    def combine(cls, dialect, fmtparams):
-        """Create a new dialect with defaults and added parameters."""
-        dialect = cls.extend(dialect, fmtparams)
-        defaults = cls.defaults()
-        specified = dict(
-            (attr, getattr(dialect, attr, None))
-            for attr in defaults
-            if getattr(dialect, attr, None) is not None or
-                attr in ['quotechar', 'delimiter', 'lineterminator', 'quoting']
-        )
-
-        defaults.update(specified)
-        dialect = type(str('CombinedDialect'), (cls,), defaults)
-        cls.validate(dialect)
-        return dialect()
-
-    def __delattr__(self, attr):
-        if self._valid:
-            raise AttributeError('dialect is immutable.')
-        super(Dialect, self).__delattr__(attr)
-
-    def __setattr__(self, attr, value):
-        if self._valid:
-            raise AttributeError('dialect is immutable.')
-        super(Dialect, self).__setattr__(attr, value)
-
-
-class excel(Dialect):
-    """Describe the usual properties of Excel-generated CSV files."""
-    delimiter = ','
-    quotechar = '"'
-    doublequote = True
-    skipinitialspace = False
-    lineterminator = '\r\n'
-    quoting = QUOTE_MINIMAL
-register_dialect("excel", excel)
-
-class excel_tab(excel):
-    """Describe the usual properties of Excel-generated TAB-delimited files."""
-    delimiter = '\t'
-register_dialect("excel-tab", excel_tab)
-
-class unix_dialect(Dialect):
-    """Describe the usual properties of Unix-generated CSV files."""
-    delimiter = ','
-    quotechar = '"'
-    doublequote = True
-    skipinitialspace = False
-    lineterminator = '\n'
-    quoting = QUOTE_ALL
-register_dialect("unix", unix_dialect)
-
-
-class DictReader(object):
-    def __init__(self, f, fieldnames=None, restkey=None, restval=None,
-                 dialect="excel", *args, **kwds):
-        self._fieldnames = fieldnames   # list of keys for the dict
-        self.restkey = restkey          # key to catch long rows
-        self.restval = restval          # default value for short rows
-        self.reader = reader(f, dialect, *args, **kwds)
-        self.dialect = dialect
-        self.line_num = 0
-
-    def __iter__(self):
-        return self
-
-    @property
-    def fieldnames(self):
-        if self._fieldnames is None:
-            try:
-                self._fieldnames = next(self.reader)
-            except StopIteration:
-                pass
-        self.line_num = self.reader.line_num
-        return self._fieldnames
-
-    @fieldnames.setter
-    def fieldnames(self, value):
-        self._fieldnames = value
-
-    def __next__(self):
-        if self.line_num == 0:
-            # Used only for its side effect.
-            self.fieldnames
-        row = next(self.reader)
-        self.line_num = self.reader.line_num
-
-        # unlike the basic reader, we prefer not to return blanks,
-        # because we will typically wind up with a dict full of None
-        # values
-        while row == []:
-            row = next(self.reader)
-        d = dict(zip(self.fieldnames, row))
-        lf = len(self.fieldnames)
-        lr = len(row)
-        if lf < lr:
-            d[self.restkey] = row[lf:]
-        elif lf > lr:
-            for key in self.fieldnames[lr:]:
-                d[key] = self.restval
-        return d
-
-    next = __next__
-
-
-class DictWriter(object):
-    def __init__(self, f, fieldnames, restval="", extrasaction="raise",
-                 dialect="excel", *args, **kwds):
-        self.fieldnames = fieldnames    # list of keys for the dict
-        self.restval = restval          # for writing short dicts
-        if extrasaction.lower() not in ("raise", "ignore"):
-            raise ValueError("extrasaction (%s) must be 'raise' or 'ignore'"
-                             % extrasaction)
-        self.extrasaction = extrasaction
-        self.writer = writer(f, dialect, *args, **kwds)
-
-    def writeheader(self):
-        header = dict(zip(self.fieldnames, self.fieldnames))
-        self.writerow(header)
-
-    def _dict_to_list(self, rowdict):
-        if self.extrasaction == "raise":
-            wrong_fields = [k for k in rowdict if k not in self.fieldnames]
-            if wrong_fields:
-                raise ValueError("dict contains fields not in fieldnames: "
-                                 + ", ".join([repr(x) for x in wrong_fields]))
-        return (rowdict.get(key, self.restval) for key in self.fieldnames)
-
-    def writerow(self, rowdict):
-        return self.writer.writerow(self._dict_to_list(rowdict))
-
-    def writerows(self, rowdicts):
-        return self.writer.writerows(map(self._dict_to_list, rowdicts))
-
-# Guard Sniffer's type checking against builds that exclude complex()
-try:
-    complex
-except NameError:
-    complex = float
-
-class Sniffer(object):
-    '''
-    "Sniffs" the format of a CSV file (i.e. delimiter, quotechar)
-    Returns a Dialect object.
-    '''
-    def __init__(self):
-        # in case there is more than one possible delimiter
-        self.preferred = [',', '\t', ';', ' ', ':']
-
-
-    def sniff(self, sample, delimiters=None):
-        """
-        Returns a dialect (or None) corresponding to the sample
-        """
-
-        quotechar, doublequote, delimiter, skipinitialspace = \
-                   self._guess_quote_and_delimiter(sample, delimiters)
-        if not delimiter:
-            delimiter, skipinitialspace = self._guess_delimiter(sample,
-                                                                delimiters)
-
-        if not delimiter:
-            raise Error("Could not determine delimiter")
-
-        class dialect(Dialect):
-            _name = "sniffed"
-            lineterminator = '\r\n'
-            quoting = QUOTE_MINIMAL
-            # escapechar = ''
-
-        dialect.doublequote = doublequote
-        dialect.delimiter = delimiter
-        # _csv.reader won't accept a quotechar of ''
-        dialect.quotechar = quotechar or '"'
-        dialect.skipinitialspace = skipinitialspace
-
-        return dialect
-
-
-    def _guess_quote_and_delimiter(self, data, delimiters):
-        """
-        Looks for text enclosed between two identical quotes
-        (the probable quotechar) which are preceded and followed
-        by the same character (the probable delimiter).
-        For example:
-                         ,'some text',
-        The quote with the most wins, same with the delimiter.
-        If there is no quotechar the delimiter can't be determined
-        this way.
-        """
-
-        matches = []
-        for restr in ('(?P<delim>[^\w\n"\'])(?P<space> ?)(?P<quote>["\']).*?(?P=quote)(?P=delim)', # ,".*?",
-                      '(?:^|\n)(?P<quote>["\']).*?(?P=quote)(?P<delim>[^\w\n"\'])(?P<space> ?)',   #  ".*?",
-                      '(?P<delim>>[^\w\n"\'])(?P<space> ?)(?P<quote>["\']).*?(?P=quote)(?:$|\n)',  # ,".*?"
-                      '(?:^|\n)(?P<quote>["\']).*?(?P=quote)(?:$|\n)'):                            #  ".*?" (no delim, no space)
-            regexp = re.compile(restr, re.DOTALL | re.MULTILINE)
-            matches = regexp.findall(data)
-            if matches:
-                break
-
-        if not matches:
-            # (quotechar, doublequote, delimiter, skipinitialspace)
-            return ('', False, None, 0)
-        quotes = {}
-        delims = {}
-        spaces = 0
-        groupindex = regexp.groupindex
-        for m in matches:
-            n = groupindex['quote'] - 1
-            key = m[n]
-            if key:
-                quotes[key] = quotes.get(key, 0) + 1
-            try:
-                n = groupindex['delim'] - 1
-                key = m[n]
-            except KeyError:
-                continue
-            if key and (delimiters is None or key in delimiters):
-                delims[key] = delims.get(key, 0) + 1
-            try:
-                n = groupindex['space'] - 1
-            except KeyError:
-                continue
-            if m[n]:
-                spaces += 1
-
-        quotechar = max(quotes, key=quotes.get)
-
-        if delims:
-            delim = max(delims, key=delims.get)
-            skipinitialspace = delims[delim] == spaces
-            if delim == '\n': # most likely a file with a single column
-                delim = ''
-        else:
-            # there is *no* delimiter, it's a single column of quoted data
-            delim = ''
-            skipinitialspace = 0
-
-        # if we see an extra quote between delimiters, we've got a
-        # double quoted format
-        dq_regexp = re.compile(
-                               r"((%(delim)s)|^)\W*%(quote)s[^%(delim)s\n]*%(quote)s[^%(delim)s\n]*%(quote)s\W*((%(delim)s)|$)" % \
-                               {'delim':re.escape(delim), 'quote':quotechar}, re.MULTILINE)
-
-
-
-        if dq_regexp.search(data):
-            doublequote = True
-        else:
-            doublequote = False
-
-        return (quotechar, doublequote, delim, skipinitialspace)
-
-
-    def _guess_delimiter(self, data, delimiters):
-        """
-        The delimiter /should/ occur the same number of times on
-        each row. However, due to malformed data, it may not. We don't want
-        an all or nothing approach, so we allow for small variations in this
-        number.
-          1) build a table of the frequency of each character on every line.
-          2) build a table of frequencies of this frequency (meta-frequency?),
-             e.g.  'x occurred 5 times in 10 rows, 6 times in 1000 rows,
-             7 times in 2 rows'
-          3) use the mode of the meta-frequency to determine the /expected/
-             frequency for that character
-          4) find out how often the character actually meets that goal
-          5) the character that best meets its goal is the delimiter
-        For performance reasons, the data is evaluated in chunks, so it can
-        try and evaluate the smallest portion of the data possible, evaluating
-        additional chunks as necessary.
-        """
-
-        data = list(filter(None, data.split('\n')))
-
-        ascii = [unichr(c) for c in range(127)] # 7-bit ASCII
-
-        # build frequency tables
-        chunkLength = min(10, len(data))
-        iteration = 0
-        charFrequency = {}
-        modes = {}
-        delims = {}
-        start, end = 0, min(chunkLength, len(data))
-        while start < len(data):
-            iteration += 1
-            for line in data[start:end]:
-                for char in ascii:
-                    metaFrequency = charFrequency.get(char, {})
-                    # must count even if frequency is 0
-                    freq = line.count(char)
-                    # value is the mode
-                    metaFrequency[freq] = metaFrequency.get(freq, 0) + 1
-                    charFrequency[char] = metaFrequency
-
-            for char in charFrequency.keys():
-                items = list(charFrequency[char].items())
-                if len(items) == 1 and items[0][0] == 0:
-                    continue
-                # get the mode of the frequencies
-                if len(items) > 1:
-                    modes[char] = max(items, key=lambda x: x[1])
-                    # adjust the mode - subtract the sum of all
-                    # other frequencies
-                    items.remove(modes[char])
-                    modes[char] = (modes[char][0], modes[char][1]
-                                   - sum(item[1] for item in items))
-                else:
-                    modes[char] = items[0]
-
-            # build a list of possible delimiters
-            modeList = modes.items()
-            total = float(chunkLength * iteration)
-            # (rows of consistent data) / (number of rows) = 100%
-            consistency = 1.0
-            # minimum consistency threshold
-            threshold = 0.9
-            while len(delims) == 0 and consistency >= threshold:
-                for k, v in modeList:
-                    if v[0] > 0 and v[1] > 0:
-                        if ((v[1]/total) >= consistency and
-                            (delimiters is None or k in delimiters)):
-                            delims[k] = v
-                consistency -= 0.01
-
-            if len(delims) == 1:
-                delim = list(delims.keys())[0]
-                skipinitialspace = (data[0].count(delim) ==
-                                    data[0].count("%c " % delim))
-                return (delim, skipinitialspace)
-
-            # analyze another chunkLength lines
-            start = end
-            end += chunkLength
-
-        if not delims:
-            return ('', 0)
-
-        # if there's more than one, fall back to a 'preferred' list
-        if len(delims) > 1:
-            for d in self.preferred:
-                if d in delims.keys():
-                    skipinitialspace = (data[0].count(d) ==
-                                        data[0].count("%c " % d))
-                    return (d, skipinitialspace)
-
-        # nothing else indicates a preference, pick the character that
-        # dominates(?)
-        items = [(v,k) for (k,v) in delims.items()]
-        items.sort()
-        delim = items[-1][1]
-
-        skipinitialspace = (data[0].count(delim) ==
-                            data[0].count("%c " % delim))
-        return (delim, skipinitialspace)
-
-
-    def has_header(self, sample):
-        # Creates a dictionary of types of data in each column. If any
-        # column is of a single type (say, integers), *except* for the first
-        # row, then the first row is presumed to be labels. If the type
-        # can't be determined, it is assumed to be a string in which case
-        # the length of the string is the determining factor: if all of the
-        # rows except for the first are the same length, it's a header.
-        # Finally, a 'vote' is taken at the end for each column, adding or
-        # subtracting from the likelihood of the first row being a header.
-
-        rdr = reader(StringIO(sample), self.sniff(sample))
-
-        header = next(rdr) # assume first row is header
-
-        columns = len(header)
-        columnTypes = {}
-        for i in range(columns): columnTypes[i] = None
-
-        checked = 0
-        for row in rdr:
-            # arbitrary number of rows to check, to keep it sane
-            if checked > 20:
-                break
-            checked += 1
-
-            if len(row) != columns:
-                continue # skip rows that have irregular number of columns
-
-            for col in list(columnTypes.keys()):
-
-                for thisType in [int, float, complex]:
-                    try:
-                        thisType(row[col])
-                        break
-                    except (ValueError, OverflowError):
-                        pass
-                else:
-                    # fallback to length of string
-                    thisType = len(row[col])
-
-                if thisType != columnTypes[col]:
-                    if columnTypes[col] is None: # add new column type
-                        columnTypes[col] = thisType
-                    else:
-                        # type is inconsistent, remove column from
-                        # consideration
-                        del columnTypes[col]
-
-        # finally, compare results against first row and "vote"
-        # on whether it's a header
-        hasHeader = 0
-        for col, colType in columnTypes.items():
-            if type(colType) == type(0): # it's a length
-                if len(header[col]) != colType:
-                    hasHeader += 1
-                else:
-                    hasHeader -= 1
-            else: # attempt typecast
-                try:
-                    colType(header[col])
-                except (ValueError, TypeError):
-                    hasHeader += 1
-                else:
-                    hasHeader -= 1
-
-        return hasHeader > 0
diff --git a/lib/backports/functools_lru_cache.py b/lib/backports/functools_lru_cache.py
deleted file mode 100644
index e372cff3..00000000
--- a/lib/backports/functools_lru_cache.py
+++ /dev/null
@@ -1,243 +0,0 @@
-from __future__ import absolute_import
-
-import functools
-from collections import namedtuple
-from threading import RLock
-
-_CacheInfo = namedtuple("_CacheInfo", ["hits", "misses", "maxsize", "currsize"])
-
-
-@functools.wraps(functools.update_wrapper)
-def update_wrapper(
-    wrapper,
-    wrapped,
-    assigned=functools.WRAPPER_ASSIGNMENTS,
-    updated=functools.WRAPPER_UPDATES,
-):
-    """
-    Patch two bugs in functools.update_wrapper.
-    """
-    # workaround for http://bugs.python.org/issue3445
-    assigned = tuple(attr for attr in assigned if hasattr(wrapped, attr))
-    wrapper = functools.update_wrapper(wrapper, wrapped, assigned, updated)
-    # workaround for https://bugs.python.org/issue17482
-    wrapper.__wrapped__ = wrapped
-    return wrapper
-
-
-class _HashedSeq(list):
-    """This class guarantees that hash() will be called no more than once
-    per element.  This is important because the lru_cache() will hash
-    the key multiple times on a cache miss.
-
-    """
-
-    __slots__ = 'hashvalue'
-
-    def __init__(self, tup, hash=hash):
-        self[:] = tup
-        self.hashvalue = hash(tup)
-
-    def __hash__(self):
-        return self.hashvalue
-
-
-def _make_key(
-    args,
-    kwds,
-    typed,
-    kwd_mark=(object(),),
-    fasttypes={int, str},
-    tuple=tuple,
-    type=type,
-    len=len,
-):
-    """Make a cache key from optionally typed positional and keyword arguments
-
-    The key is constructed in a way that is flat as possible rather than
-    as a nested structure that would take more memory.
-
-    If there is only a single argument and its data type is known to cache
-    its hash value, then that argument is returned without a wrapper.  This
-    saves space and improves lookup speed.
-
-    """
-    # All of code below relies on kwds preserving the order input by the user.
-    # Formerly, we sorted() the kwds before looping.  The new way is *much*
-    # faster; however, it means that f(x=1, y=2) will now be treated as a
-    # distinct call from f(y=2, x=1) which will be cached separately.
-    key = args
-    if kwds:
-        key += kwd_mark
-        for item in kwds.items():
-            key += item
-    if typed:
-        key += tuple(type(v) for v in args)
-        if kwds:
-            key += tuple(type(v) for v in kwds.values())
-    elif len(key) == 1 and type(key[0]) in fasttypes:
-        return key[0]
-    return _HashedSeq(key)
-
-
-def lru_cache(maxsize=128, typed=False):
-    """Least-recently-used cache decorator.
-
-    If *maxsize* is set to None, the LRU features are disabled and the cache
-    can grow without bound.
-
-    If *typed* is True, arguments of different types will be cached separately.
-    For example, f(decimal.Decimal("3.0")) and f(3.0) will be treated as
-    distinct calls with distinct results. Some types such as str and int may
-    be cached separately even when typed is false.
-
-    Arguments to the cached function must be hashable.
-
-    View the cache statistics named tuple (hits, misses, maxsize, currsize)
-    with f.cache_info().  Clear the cache and statistics with f.cache_clear().
-    Access the underlying function with f.__wrapped__.
-
-    See:  https://en.wikipedia.org/wiki/Cache_replacement_policies#Least_recently_used_(LRU)
-
-    """
-
-    # Users should only access the lru_cache through its public API:
-    #       cache_info, cache_clear, and f.__wrapped__
-    # The internals of the lru_cache are encapsulated for thread safety and
-    # to allow the implementation to change (including a possible C version).
-
-    if isinstance(maxsize, int):
-        # Negative maxsize is treated as 0
-        if maxsize < 0:
-            maxsize = 0
-    elif callable(maxsize) and isinstance(typed, bool):
-        # The user_function was passed in directly via the maxsize argument
-        user_function, maxsize = maxsize, 128
-        wrapper = _lru_cache_wrapper(user_function, maxsize, typed, _CacheInfo)
-        wrapper.cache_parameters = lambda: {'maxsize': maxsize, 'typed': typed}
-        return update_wrapper(wrapper, user_function)
-    elif maxsize is not None:
-        raise TypeError('Expected first argument to be an integer, a callable, or None')
-
-    def decorating_function(user_function):
-        wrapper = _lru_cache_wrapper(user_function, maxsize, typed, _CacheInfo)
-        wrapper.cache_parameters = lambda: {'maxsize': maxsize, 'typed': typed}
-        return update_wrapper(wrapper, user_function)
-
-    return decorating_function
-
-
-def _lru_cache_wrapper(user_function, maxsize, typed, _CacheInfo):
-    # Constants shared by all lru cache instances:
-    sentinel = object()  # unique object used to signal cache misses
-    make_key = _make_key  # build a key from the function arguments
-    PREV, NEXT, KEY, RESULT = 0, 1, 2, 3  # names for the link fields
-
-    cache = {}
-    hits = misses = 0
-    full = False
-    cache_get = cache.get  # bound method to lookup a key or return None
-    cache_len = cache.__len__  # get cache size without calling len()
-    lock = RLock()  # because linkedlist updates aren't threadsafe
-    root = []  # root of the circular doubly linked list
-    root[:] = [root, root, None, None]  # initialize by pointing to self
-
-    if maxsize == 0:
-
-        def wrapper(*args, **kwds):
-            # No caching -- just a statistics update
-            nonlocal misses
-            misses += 1
-            result = user_function(*args, **kwds)
-            return result
-
-    elif maxsize is None:
-
-        def wrapper(*args, **kwds):
-            # Simple caching without ordering or size limit
-            nonlocal hits, misses
-            key = make_key(args, kwds, typed)
-            result = cache_get(key, sentinel)
-            if result is not sentinel:
-                hits += 1
-                return result
-            misses += 1
-            result = user_function(*args, **kwds)
-            cache[key] = result
-            return result
-
-    else:
-
-        def wrapper(*args, **kwds):
-            # Size limited caching that tracks accesses by recency
-            nonlocal root, hits, misses, full
-            key = make_key(args, kwds, typed)
-            with lock:
-                link = cache_get(key)
-                if link is not None:
-                    # Move the link to the front of the circular queue
-                    link_prev, link_next, _key, result = link
-                    link_prev[NEXT] = link_next
-                    link_next[PREV] = link_prev
-                    last = root[PREV]
-                    last[NEXT] = root[PREV] = link
-                    link[PREV] = last
-                    link[NEXT] = root
-                    hits += 1
-                    return result
-                misses += 1
-            result = user_function(*args, **kwds)
-            with lock:
-                if key in cache:
-                    # Getting here means that this same key was added to the
-                    # cache while the lock was released.  Since the link
-                    # update is already done, we need only return the
-                    # computed result and update the count of misses.
-                    pass
-                elif full:
-                    # Use the old root to store the new key and result.
-                    oldroot = root
-                    oldroot[KEY] = key
-                    oldroot[RESULT] = result
-                    # Empty the oldest link and make it the new root.
-                    # Keep a reference to the old key and old result to
-                    # prevent their ref counts from going to zero during the
-                    # update. That will prevent potentially arbitrary object
-                    # clean-up code (i.e. __del__) from running while we're
-                    # still adjusting the links.
-                    root = oldroot[NEXT]
-                    oldkey = root[KEY]
-                    root[KEY] = root[RESULT] = None
-                    # Now update the cache dictionary.
-                    del cache[oldkey]
-                    # Save the potentially reentrant cache[key] assignment
-                    # for last, after the root and links have been put in
-                    # a consistent state.
-                    cache[key] = oldroot
-                else:
-                    # Put result in a new link at the front of the queue.
-                    last = root[PREV]
-                    link = [last, root, key, result]
-                    last[NEXT] = root[PREV] = cache[key] = link
-                    # Use the cache_len bound method instead of the len() function
-                    # which could potentially be wrapped in an lru_cache itself.
-                    full = cache_len() >= maxsize
-            return result
-
-    def cache_info():
-        """Report cache statistics"""
-        with lock:
-            return _CacheInfo(hits, misses, maxsize, cache_len())
-
-    def cache_clear():
-        """Clear the cache and cache statistics"""
-        nonlocal hits, misses, full
-        with lock:
-            cache.clear()
-            root[:] = [root, root, None, None]
-            hits = misses = 0
-            full = False
-
-    wrapper.cache_info = cache_info
-    wrapper.cache_clear = cache_clear
-    return wrapper
diff --git a/lib/backports/tarfile/__init__.py b/lib/backports/tarfile/__init__.py
new file mode 100644
index 00000000..6dd498dc
--- /dev/null
+++ b/lib/backports/tarfile/__init__.py
@@ -0,0 +1,2902 @@
+#!/usr/bin/env python3
+#-------------------------------------------------------------------
+# tarfile.py
+#-------------------------------------------------------------------
+# Copyright (C) 2002 Lars Gustaebel <lars@gustaebel.de>
+# All rights reserved.
+#
+# Permission  is  hereby granted,  free  of charge,  to  any person
+# obtaining a  copy of  this software  and associated documentation
+# files  (the  "Software"),  to   deal  in  the  Software   without
+# restriction,  including  without limitation  the  rights to  use,
+# copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies  of  the  Software,  and to  permit  persons  to  whom the
+# Software  is  furnished  to  do  so,  subject  to  the  following
+# conditions:
+#
+# The above copyright  notice and this  permission notice shall  be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS  IS", WITHOUT WARRANTY OF ANY  KIND,
+# EXPRESS OR IMPLIED, INCLUDING  BUT NOT LIMITED TO  THE WARRANTIES
+# OF  MERCHANTABILITY,  FITNESS   FOR  A  PARTICULAR   PURPOSE  AND
+# NONINFRINGEMENT.  IN  NO  EVENT SHALL  THE  AUTHORS  OR COPYRIGHT
+# HOLDERS  BE LIABLE  FOR ANY  CLAIM, DAMAGES  OR OTHER  LIABILITY,
+# WHETHER  IN AN  ACTION OF  CONTRACT, TORT  OR OTHERWISE,  ARISING
+# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+# OTHER DEALINGS IN THE SOFTWARE.
+#
+"""Read from and write to tar format archives.
+"""
+
+version     = "0.9.0"
+__author__  = "Lars Gust\u00e4bel (lars@gustaebel.de)"
+__credits__ = "Gustavo Niemeyer, Niels Gust\u00e4bel, Richard Townsend."
+
+#---------
+# Imports
+#---------
+from builtins import open as bltn_open
+import sys
+import os
+import io
+import shutil
+import stat
+import time
+import struct
+import copy
+import re
+import warnings
+
+from .compat.py38 import removesuffix
+
+try:
+    import pwd
+except ImportError:
+    pwd = None
+try:
+    import grp
+except ImportError:
+    grp = None
+
+# os.symlink on Windows prior to 6.0 raises NotImplementedError
+# OSError (winerror=1314) will be raised if the caller does not hold the
+# SeCreateSymbolicLinkPrivilege privilege
+symlink_exception = (AttributeError, NotImplementedError, OSError)
+
+# from tarfile import *
+__all__ = ["TarFile", "TarInfo", "is_tarfile", "TarError", "ReadError",
+           "CompressionError", "StreamError", "ExtractError", "HeaderError",
+           "ENCODING", "USTAR_FORMAT", "GNU_FORMAT", "PAX_FORMAT",
+           "DEFAULT_FORMAT", "open","fully_trusted_filter", "data_filter",
+           "tar_filter", "FilterError", "AbsoluteLinkError",
+           "OutsideDestinationError", "SpecialFileError", "AbsolutePathError",
+           "LinkOutsideDestinationError"]
+
+
+#---------------------------------------------------------
+# tar constants
+#---------------------------------------------------------
+NUL = b"\0"                     # the null character
+BLOCKSIZE = 512                 # length of processing blocks
+RECORDSIZE = BLOCKSIZE * 20     # length of records
+GNU_MAGIC = b"ustar  \0"        # magic gnu tar string
+POSIX_MAGIC = b"ustar\x0000"    # magic posix tar string
+
+LENGTH_NAME = 100               # maximum length of a filename
+LENGTH_LINK = 100               # maximum length of a linkname
+LENGTH_PREFIX = 155             # maximum length of the prefix field
+
+REGTYPE = b"0"                  # regular file
+AREGTYPE = b"\0"                # regular file
+LNKTYPE = b"1"                  # link (inside tarfile)
+SYMTYPE = b"2"                  # symbolic link
+CHRTYPE = b"3"                  # character special device
+BLKTYPE = b"4"                  # block special device
+DIRTYPE = b"5"                  # directory
+FIFOTYPE = b"6"                 # fifo special device
+CONTTYPE = b"7"                 # contiguous file
+
+GNUTYPE_LONGNAME = b"L"         # GNU tar longname
+GNUTYPE_LONGLINK = b"K"         # GNU tar longlink
+GNUTYPE_SPARSE = b"S"           # GNU tar sparse file
+
+XHDTYPE = b"x"                  # POSIX.1-2001 extended header
+XGLTYPE = b"g"                  # POSIX.1-2001 global header
+SOLARIS_XHDTYPE = b"X"          # Solaris extended header
+
+USTAR_FORMAT = 0                # POSIX.1-1988 (ustar) format
+GNU_FORMAT = 1                  # GNU tar format
+PAX_FORMAT = 2                  # POSIX.1-2001 (pax) format
+DEFAULT_FORMAT = PAX_FORMAT
+
+#---------------------------------------------------------
+# tarfile constants
+#---------------------------------------------------------
+# File types that tarfile supports:
+SUPPORTED_TYPES = (REGTYPE, AREGTYPE, LNKTYPE,
+                   SYMTYPE, DIRTYPE, FIFOTYPE,
+                   CONTTYPE, CHRTYPE, BLKTYPE,
+                   GNUTYPE_LONGNAME, GNUTYPE_LONGLINK,
+                   GNUTYPE_SPARSE)
+
+# File types that will be treated as a regular file.
+REGULAR_TYPES = (REGTYPE, AREGTYPE,
+                 CONTTYPE, GNUTYPE_SPARSE)
+
+# File types that are part of the GNU tar format.
+GNU_TYPES = (GNUTYPE_LONGNAME, GNUTYPE_LONGLINK,
+             GNUTYPE_SPARSE)
+
+# Fields from a pax header that override a TarInfo attribute.
+PAX_FIELDS = ("path", "linkpath", "size", "mtime",
+              "uid", "gid", "uname", "gname")
+
+# Fields from a pax header that are affected by hdrcharset.
+PAX_NAME_FIELDS = {"path", "linkpath", "uname", "gname"}
+
+# Fields in a pax header that are numbers, all other fields
+# are treated as strings.
+PAX_NUMBER_FIELDS = {
+    "atime": float,
+    "ctime": float,
+    "mtime": float,
+    "uid": int,
+    "gid": int,
+    "size": int
+}
+
+#---------------------------------------------------------
+# initialization
+#---------------------------------------------------------
+if os.name == "nt":
+    ENCODING = "utf-8"
+else:
+    ENCODING = sys.getfilesystemencoding()
+
+#---------------------------------------------------------
+# Some useful functions
+#---------------------------------------------------------
+
+def stn(s, length, encoding, errors):
+    """Convert a string to a null-terminated bytes object.
+    """
+    if s is None:
+        raise ValueError("metadata cannot contain None")
+    s = s.encode(encoding, errors)
+    return s[:length] + (length - len(s)) * NUL
+
+def nts(s, encoding, errors):
+    """Convert a null-terminated bytes object to a string.
+    """
+    p = s.find(b"\0")
+    if p != -1:
+        s = s[:p]
+    return s.decode(encoding, errors)
+
+def nti(s):
+    """Convert a number field to a python number.
+    """
+    # There are two possible encodings for a number field, see
+    # itn() below.
+    if s[0] in (0o200, 0o377):
+        n = 0
+        for i in range(len(s) - 1):
+            n <<= 8
+            n += s[i + 1]
+        if s[0] == 0o377:
+            n = -(256 ** (len(s) - 1) - n)
+    else:
+        try:
+            s = nts(s, "ascii", "strict")
+            n = int(s.strip() or "0", 8)
+        except ValueError:
+            raise InvalidHeaderError("invalid header")
+    return n
+
+def itn(n, digits=8, format=DEFAULT_FORMAT):
+    """Convert a python number to a number field.
+    """
+    # POSIX 1003.1-1988 requires numbers to be encoded as a string of
+    # octal digits followed by a null-byte, this allows values up to
+    # (8**(digits-1))-1. GNU tar allows storing numbers greater than
+    # that if necessary. A leading 0o200 or 0o377 byte indicate this
+    # particular encoding, the following digits-1 bytes are a big-endian
+    # base-256 representation. This allows values up to (256**(digits-1))-1.
+    # A 0o200 byte indicates a positive number, a 0o377 byte a negative
+    # number.
+    original_n = n
+    n = int(n)
+    if 0 <= n < 8 ** (digits - 1):
+        s = bytes("%0*o" % (digits - 1, n), "ascii") + NUL
+    elif format == GNU_FORMAT and -256 ** (digits - 1) <= n < 256 ** (digits - 1):
+        if n >= 0:
+            s = bytearray([0o200])
+        else:
+            s = bytearray([0o377])
+            n = 256 ** digits + n
+
+        for i in range(digits - 1):
+            s.insert(1, n & 0o377)
+            n >>= 8
+    else:
+        raise ValueError("overflow in number field")
+
+    return s
+
+def calc_chksums(buf):
+    """Calculate the checksum for a member's header by summing up all
+       characters except for the chksum field which is treated as if
+       it was filled with spaces. According to the GNU tar sources,
+       some tars (Sun and NeXT) calculate chksum with signed char,
+       which will be different if there are chars in the buffer with
+       the high bit set. So we calculate two checksums, unsigned and
+       signed.
+    """
+    unsigned_chksum = 256 + sum(struct.unpack_from("148B8x356B", buf))
+    signed_chksum = 256 + sum(struct.unpack_from("148b8x356b", buf))
+    return unsigned_chksum, signed_chksum
+
+def copyfileobj(src, dst, length=None, exception=OSError, bufsize=None):
+    """Copy length bytes from fileobj src to fileobj dst.
+       If length is None, copy the entire content.
+    """
+    bufsize = bufsize or 16 * 1024
+    if length == 0:
+        return
+    if length is None:
+        shutil.copyfileobj(src, dst, bufsize)
+        return
+
+    blocks, remainder = divmod(length, bufsize)
+    for b in range(blocks):
+        buf = src.read(bufsize)
+        if len(buf) < bufsize:
+            raise exception("unexpected end of data")
+        dst.write(buf)
+
+    if remainder != 0:
+        buf = src.read(remainder)
+        if len(buf) < remainder:
+            raise exception("unexpected end of data")
+        dst.write(buf)
+    return
+
+def _safe_print(s):
+    encoding = getattr(sys.stdout, 'encoding', None)
+    if encoding is not None:
+        s = s.encode(encoding, 'backslashreplace').decode(encoding)
+    print(s, end=' ')
+
+
+class TarError(Exception):
+    """Base exception."""
+    pass
+class ExtractError(TarError):
+    """General exception for extract errors."""
+    pass
+class ReadError(TarError):
+    """Exception for unreadable tar archives."""
+    pass
+class CompressionError(TarError):
+    """Exception for unavailable compression methods."""
+    pass
+class StreamError(TarError):
+    """Exception for unsupported operations on stream-like TarFiles."""
+    pass
+class HeaderError(TarError):
+    """Base exception for header errors."""
+    pass
+class EmptyHeaderError(HeaderError):
+    """Exception for empty headers."""
+    pass
+class TruncatedHeaderError(HeaderError):
+    """Exception for truncated headers."""
+    pass
+class EOFHeaderError(HeaderError):
+    """Exception for end of file headers."""
+    pass
+class InvalidHeaderError(HeaderError):
+    """Exception for invalid headers."""
+    pass
+class SubsequentHeaderError(HeaderError):
+    """Exception for missing and invalid extended headers."""
+    pass
+
+#---------------------------
+# internal stream interface
+#---------------------------
+class _LowLevelFile:
+    """Low-level file object. Supports reading and writing.
+       It is used instead of a regular file object for streaming
+       access.
+    """
+
+    def __init__(self, name, mode):
+        mode = {
+            "r": os.O_RDONLY,
+            "w": os.O_WRONLY | os.O_CREAT | os.O_TRUNC,
+        }[mode]
+        if hasattr(os, "O_BINARY"):
+            mode |= os.O_BINARY
+        self.fd = os.open(name, mode, 0o666)
+
+    def close(self):
+        os.close(self.fd)
+
+    def read(self, size):
+        return os.read(self.fd, size)
+
+    def write(self, s):
+        os.write(self.fd, s)
+
+class _Stream:
+    """Class that serves as an adapter between TarFile and
+       a stream-like object.  The stream-like object only
+       needs to have a read() or write() method that works with bytes,
+       and the method is accessed blockwise.
+       Use of gzip or bzip2 compression is possible.
+       A stream-like object could be for example: sys.stdin.buffer,
+       sys.stdout.buffer, a socket, a tape device etc.
+
+       _Stream is intended to be used only internally.
+    """
+
+    def __init__(self, name, mode, comptype, fileobj, bufsize,
+                 compresslevel):
+        """Construct a _Stream object.
+        """
+        self._extfileobj = True
+        if fileobj is None:
+            fileobj = _LowLevelFile(name, mode)
+            self._extfileobj = False
+
+        if comptype == '*':
+            # Enable transparent compression detection for the
+            # stream interface
+            fileobj = _StreamProxy(fileobj)
+            comptype = fileobj.getcomptype()
+
+        self.name     = name or ""
+        self.mode     = mode
+        self.comptype = comptype
+        self.fileobj  = fileobj
+        self.bufsize  = bufsize
+        self.buf      = b""
+        self.pos      = 0
+        self.closed   = False
+
+        try:
+            if comptype == "gz":
+                try:
+                    import zlib
+                except ImportError:
+                    raise CompressionError("zlib module is not available") from None
+                self.zlib = zlib
+                self.crc = zlib.crc32(b"")
+                if mode == "r":
+                    self.exception = zlib.error
+                    self._init_read_gz()
+                else:
+                    self._init_write_gz(compresslevel)
+
+            elif comptype == "bz2":
+                try:
+                    import bz2
+                except ImportError:
+                    raise CompressionError("bz2 module is not available") from None
+                if mode == "r":
+                    self.dbuf = b""
+                    self.cmp = bz2.BZ2Decompressor()
+                    self.exception = OSError
+                else:
+                    self.cmp = bz2.BZ2Compressor(compresslevel)
+
+            elif comptype == "xz":
+                try:
+                    import lzma
+                except ImportError:
+                    raise CompressionError("lzma module is not available") from None
+                if mode == "r":
+                    self.dbuf = b""
+                    self.cmp = lzma.LZMADecompressor()
+                    self.exception = lzma.LZMAError
+                else:
+                    self.cmp = lzma.LZMACompressor()
+
+            elif comptype != "tar":
+                raise CompressionError("unknown compression type %r" % comptype)
+
+        except:
+            if not self._extfileobj:
+                self.fileobj.close()
+            self.closed = True
+            raise
+
+    def __del__(self):
+        if hasattr(self, "closed") and not self.closed:
+            self.close()
+
+    def _init_write_gz(self, compresslevel):
+        """Initialize for writing with gzip compression.
+        """
+        self.cmp = self.zlib.compressobj(compresslevel,
+                                         self.zlib.DEFLATED,
+                                         -self.zlib.MAX_WBITS,
+                                         self.zlib.DEF_MEM_LEVEL,
+                                         0)
+        timestamp = struct.pack("<L", int(time.time()))
+        self.__write(b"\037\213\010\010" + timestamp + b"\002\377")
+        if self.name.endswith(".gz"):
+            self.name = self.name[:-3]
+        # Honor "directory components removed" from RFC1952
+        self.name = os.path.basename(self.name)
+        # RFC1952 says we must use ISO-8859-1 for the FNAME field.
+        self.__write(self.name.encode("iso-8859-1", "replace") + NUL)
+
+    def write(self, s):
+        """Write string s to the stream.
+        """
+        if self.comptype == "gz":
+            self.crc = self.zlib.crc32(s, self.crc)
+        self.pos += len(s)
+        if self.comptype != "tar":
+            s = self.cmp.compress(s)
+        self.__write(s)
+
+    def __write(self, s):
+        """Write string s to the stream if a whole new block
+           is ready to be written.
+        """
+        self.buf += s
+        while len(self.buf) > self.bufsize:
+            self.fileobj.write(self.buf[:self.bufsize])
+            self.buf = self.buf[self.bufsize:]
+
+    def close(self):
+        """Close the _Stream object. No operation should be
+           done on it afterwards.
+        """
+        if self.closed:
+            return
+
+        self.closed = True
+        try:
+            if self.mode == "w" and self.comptype != "tar":
+                self.buf += self.cmp.flush()
+
+            if self.mode == "w" and self.buf:
+                self.fileobj.write(self.buf)
+                self.buf = b""
+                if self.comptype == "gz":
+                    self.fileobj.write(struct.pack("<L", self.crc))
+                    self.fileobj.write(struct.pack("<L", self.pos & 0xffffFFFF))
+        finally:
+            if not self._extfileobj:
+                self.fileobj.close()
+
+    def _init_read_gz(self):
+        """Initialize for reading a gzip compressed fileobj.
+        """
+        self.cmp = self.zlib.decompressobj(-self.zlib.MAX_WBITS)
+        self.dbuf = b""
+
+        # taken from gzip.GzipFile with some alterations
+        if self.__read(2) != b"\037\213":
+            raise ReadError("not a gzip file")
+        if self.__read(1) != b"\010":
+            raise CompressionError("unsupported compression method")
+
+        flag = ord(self.__read(1))
+        self.__read(6)
+
+        if flag & 4:
+            xlen = ord(self.__read(1)) + 256 * ord(self.__read(1))
+            self.read(xlen)
+        if flag & 8:
+            while True:
+                s = self.__read(1)
+                if not s or s == NUL:
+                    break
+        if flag & 16:
+            while True:
+                s = self.__read(1)
+                if not s or s == NUL:
+                    break
+        if flag & 2:
+            self.__read(2)
+
+    def tell(self):
+        """Return the stream's file pointer position.
+        """
+        return self.pos
+
+    def seek(self, pos=0):
+        """Set the stream's file pointer to pos. Negative seeking
+           is forbidden.
+        """
+        if pos - self.pos >= 0:
+            blocks, remainder = divmod(pos - self.pos, self.bufsize)
+            for i in range(blocks):
+                self.read(self.bufsize)
+            self.read(remainder)
+        else:
+            raise StreamError("seeking backwards is not allowed")
+        return self.pos
+
+    def read(self, size):
+        """Return the next size number of bytes from the stream."""
+        assert size is not None
+        buf = self._read(size)
+        self.pos += len(buf)
+        return buf
+
+    def _read(self, size):
+        """Return size bytes from the stream.
+        """
+        if self.comptype == "tar":
+            return self.__read(size)
+
+        c = len(self.dbuf)
+        t = [self.dbuf]
+        while c < size:
+            # Skip underlying buffer to avoid unaligned double buffering.
+            if self.buf:
+                buf = self.buf
+                self.buf = b""
+            else:
+                buf = self.fileobj.read(self.bufsize)
+                if not buf:
+                    break
+            try:
+                buf = self.cmp.decompress(buf)
+            except self.exception as e:
+                raise ReadError("invalid compressed data") from e
+            t.append(buf)
+            c += len(buf)
+        t = b"".join(t)
+        self.dbuf = t[size:]
+        return t[:size]
+
+    def __read(self, size):
+        """Return size bytes from stream. If internal buffer is empty,
+           read another block from the stream.
+        """
+        c = len(self.buf)
+        t = [self.buf]
+        while c < size:
+            buf = self.fileobj.read(self.bufsize)
+            if not buf:
+                break
+            t.append(buf)
+            c += len(buf)
+        t = b"".join(t)
+        self.buf = t[size:]
+        return t[:size]
+# class _Stream
+
+class _StreamProxy(object):
+    """Small proxy class that enables transparent compression
+       detection for the Stream interface (mode 'r|*').
+    """
+
+    def __init__(self, fileobj):
+        self.fileobj = fileobj
+        self.buf = self.fileobj.read(BLOCKSIZE)
+
+    def read(self, size):
+        self.read = self.fileobj.read
+        return self.buf
+
+    def getcomptype(self):
+        if self.buf.startswith(b"\x1f\x8b\x08"):
+            return "gz"
+        elif self.buf[0:3] == b"BZh" and self.buf[4:10] == b"1AY&SY":
+            return "bz2"
+        elif self.buf.startswith((b"\x5d\x00\x00\x80", b"\xfd7zXZ")):
+            return "xz"
+        else:
+            return "tar"
+
+    def close(self):
+        self.fileobj.close()
+# class StreamProxy
+
+#------------------------
+# Extraction file object
+#------------------------
+class _FileInFile(object):
+    """A thin wrapper around an existing file object that
+       provides a part of its data as an individual file
+       object.
+    """
+
+    def __init__(self, fileobj, offset, size, name, blockinfo=None):
+        self.fileobj = fileobj
+        self.offset = offset
+        self.size = size
+        self.position = 0
+        self.name = name
+        self.closed = False
+
+        if blockinfo is None:
+            blockinfo = [(0, size)]
+
+        # Construct a map with data and zero blocks.
+        self.map_index = 0
+        self.map = []
+        lastpos = 0
+        realpos = self.offset
+        for offset, size in blockinfo:
+            if offset > lastpos:
+                self.map.append((False, lastpos, offset, None))
+            self.map.append((True, offset, offset + size, realpos))
+            realpos += size
+            lastpos = offset + size
+        if lastpos < self.size:
+            self.map.append((False, lastpos, self.size, None))
+
+    def flush(self):
+        pass
+
+    def readable(self):
+        return True
+
+    def writable(self):
+        return False
+
+    def seekable(self):
+        return self.fileobj.seekable()
+
+    def tell(self):
+        """Return the current file position.
+        """
+        return self.position
+
+    def seek(self, position, whence=io.SEEK_SET):
+        """Seek to a position in the file.
+        """
+        if whence == io.SEEK_SET:
+            self.position = min(max(position, 0), self.size)
+        elif whence == io.SEEK_CUR:
+            if position < 0:
+                self.position = max(self.position + position, 0)
+            else:
+                self.position = min(self.position + position, self.size)
+        elif whence == io.SEEK_END:
+            self.position = max(min(self.size + position, self.size), 0)
+        else:
+            raise ValueError("Invalid argument")
+        return self.position
+
+    def read(self, size=None):
+        """Read data from the file.
+        """
+        if size is None:
+            size = self.size - self.position
+        else:
+            size = min(size, self.size - self.position)
+
+        buf = b""
+        while size > 0:
+            while True:
+                data, start, stop, offset = self.map[self.map_index]
+                if start <= self.position < stop:
+                    break
+                else:
+                    self.map_index += 1
+                    if self.map_index == len(self.map):
+                        self.map_index = 0
+            length = min(size, stop - self.position)
+            if data:
+                self.fileobj.seek(offset + (self.position - start))
+                b = self.fileobj.read(length)
+                if len(b) != length:
+                    raise ReadError("unexpected end of data")
+                buf += b
+            else:
+                buf += NUL * length
+            size -= length
+            self.position += length
+        return buf
+
+    def readinto(self, b):
+        buf = self.read(len(b))
+        b[:len(buf)] = buf
+        return len(buf)
+
+    def close(self):
+        self.closed = True
+#class _FileInFile
+
+class ExFileObject(io.BufferedReader):
+
+    def __init__(self, tarfile, tarinfo):
+        fileobj = _FileInFile(tarfile.fileobj, tarinfo.offset_data,
+                tarinfo.size, tarinfo.name, tarinfo.sparse)
+        super().__init__(fileobj)
+#class ExFileObject
+
+
+#-----------------------------
+# extraction filters (PEP 706)
+#-----------------------------
+
+class FilterError(TarError):
+    pass
+
+class AbsolutePathError(FilterError):
+    def __init__(self, tarinfo):
+        self.tarinfo = tarinfo
+        super().__init__(f'member {tarinfo.name!r} has an absolute path')
+
+class OutsideDestinationError(FilterError):
+    def __init__(self, tarinfo, path):
+        self.tarinfo = tarinfo
+        self._path = path
+        super().__init__(f'{tarinfo.name!r} would be extracted to {path!r}, '
+                         + 'which is outside the destination')
+
+class SpecialFileError(FilterError):
+    def __init__(self, tarinfo):
+        self.tarinfo = tarinfo
+        super().__init__(f'{tarinfo.name!r} is a special file')
+
+class AbsoluteLinkError(FilterError):
+    def __init__(self, tarinfo):
+        self.tarinfo = tarinfo
+        super().__init__(f'{tarinfo.name!r} is a link to an absolute path')
+
+class LinkOutsideDestinationError(FilterError):
+    def __init__(self, tarinfo, path):
+        self.tarinfo = tarinfo
+        self._path = path
+        super().__init__(f'{tarinfo.name!r} would link to {path!r}, '
+                         + 'which is outside the destination')
+
+def _get_filtered_attrs(member, dest_path, for_data=True):
+    new_attrs = {}
+    name = member.name
+    dest_path = os.path.realpath(dest_path)
+    # Strip leading / (tar's directory separator) from filenames.
+    # Include os.sep (target OS directory separator) as well.
+    if name.startswith(('/', os.sep)):
+        name = new_attrs['name'] = member.path.lstrip('/' + os.sep)
+    if os.path.isabs(name):
+        # Path is absolute even after stripping.
+        # For example, 'C:/foo' on Windows.
+        raise AbsolutePathError(member)
+    # Ensure we stay in the destination
+    target_path = os.path.realpath(os.path.join(dest_path, name))
+    if os.path.commonpath([target_path, dest_path]) != dest_path:
+        raise OutsideDestinationError(member, target_path)
+    # Limit permissions (no high bits, and go-w)
+    mode = member.mode
+    if mode is not None:
+        # Strip high bits & group/other write bits
+        mode = mode & 0o755
+        if for_data:
+            # For data, handle permissions & file types
+            if member.isreg() or member.islnk():
+                if not mode & 0o100:
+                    # Clear executable bits if not executable by user
+                    mode &= ~0o111
+                # Ensure owner can read & write
+                mode |= 0o600
+            elif member.isdir() or member.issym():
+                # Ignore mode for directories & symlinks
+                mode = None
+            else:
+                # Reject special files
+                raise SpecialFileError(member)
+        if mode != member.mode:
+            new_attrs['mode'] = mode
+    if for_data:
+        # Ignore ownership for 'data'
+        if member.uid is not None:
+            new_attrs['uid'] = None
+        if member.gid is not None:
+            new_attrs['gid'] = None
+        if member.uname is not None:
+            new_attrs['uname'] = None
+        if member.gname is not None:
+            new_attrs['gname'] = None
+        # Check link destination for 'data'
+        if member.islnk() or member.issym():
+            if os.path.isabs(member.linkname):
+                raise AbsoluteLinkError(member)
+            if member.issym():
+                target_path = os.path.join(dest_path,
+                                           os.path.dirname(name),
+                                           member.linkname)
+            else:
+                target_path = os.path.join(dest_path,
+                                           member.linkname)
+            target_path = os.path.realpath(target_path)
+            if os.path.commonpath([target_path, dest_path]) != dest_path:
+                raise LinkOutsideDestinationError(member, target_path)
+    return new_attrs
+
+def fully_trusted_filter(member, dest_path):
+    return member
+
+def tar_filter(member, dest_path):
+    new_attrs = _get_filtered_attrs(member, dest_path, False)
+    if new_attrs:
+        return member.replace(**new_attrs, deep=False)
+    return member
+
+def data_filter(member, dest_path):
+    new_attrs = _get_filtered_attrs(member, dest_path, True)
+    if new_attrs:
+        return member.replace(**new_attrs, deep=False)
+    return member
+
+_NAMED_FILTERS = {
+    "fully_trusted": fully_trusted_filter,
+    "tar": tar_filter,
+    "data": data_filter,
+}
+
+#------------------
+# Exported Classes
+#------------------
+
+# Sentinel for replace() defaults, meaning "don't change the attribute"
+_KEEP = object()
+
+class TarInfo(object):
+    """Informational class which holds the details about an
+       archive member given by a tar header block.
+       TarInfo objects are returned by TarFile.getmember(),
+       TarFile.getmembers() and TarFile.gettarinfo() and are
+       usually created internally.
+    """
+
+    __slots__ = dict(
+        name = 'Name of the archive member.',
+        mode = 'Permission bits.',
+        uid = 'User ID of the user who originally stored this member.',
+        gid = 'Group ID of the user who originally stored this member.',
+        size = 'Size in bytes.',
+        mtime = 'Time of last modification.',
+        chksum = 'Header checksum.',
+        type = ('File type. type is usually one of these constants: '
+                'REGTYPE, AREGTYPE, LNKTYPE, SYMTYPE, DIRTYPE, FIFOTYPE, '
+                'CONTTYPE, CHRTYPE, BLKTYPE, GNUTYPE_SPARSE.'),
+        linkname = ('Name of the target file name, which is only present '
+                    'in TarInfo objects of type LNKTYPE and SYMTYPE.'),
+        uname = 'User name.',
+        gname = 'Group name.',
+        devmajor = 'Device major number.',
+        devminor = 'Device minor number.',
+        offset = 'The tar header starts here.',
+        offset_data = "The file's data starts here.",
+        pax_headers = ('A dictionary containing key-value pairs of an '
+                       'associated pax extended header.'),
+        sparse = 'Sparse member information.',
+        tarfile = None,
+        _sparse_structs = None,
+        _link_target = None,
+        )
+
+    def __init__(self, name=""):
+        """Construct a TarInfo object. name is the optional name
+           of the member.
+        """
+        self.name = name        # member name
+        self.mode = 0o644       # file permissions
+        self.uid = 0            # user id
+        self.gid = 0            # group id
+        self.size = 0           # file size
+        self.mtime = 0          # modification time
+        self.chksum = 0         # header checksum
+        self.type = REGTYPE     # member type
+        self.linkname = ""      # link name
+        self.uname = ""         # user name
+        self.gname = ""         # group name
+        self.devmajor = 0       # device major number
+        self.devminor = 0       # device minor number
+
+        self.offset = 0         # the tar header starts here
+        self.offset_data = 0    # the file's data starts here
+
+        self.sparse = None      # sparse member information
+        self.pax_headers = {}   # pax header information
+
+    @property
+    def path(self):
+        'In pax headers, "name" is called "path".'
+        return self.name
+
+    @path.setter
+    def path(self, name):
+        self.name = name
+
+    @property
+    def linkpath(self):
+        'In pax headers, "linkname" is called "linkpath".'
+        return self.linkname
+
+    @linkpath.setter
+    def linkpath(self, linkname):
+        self.linkname = linkname
+
+    def __repr__(self):
+        return "<%s %r at %#x>" % (self.__class__.__name__,self.name,id(self))
+
+    def replace(self, *,
+                name=_KEEP, mtime=_KEEP, mode=_KEEP, linkname=_KEEP,
+                uid=_KEEP, gid=_KEEP, uname=_KEEP, gname=_KEEP,
+                deep=True, _KEEP=_KEEP):
+        """Return a deep copy of self with the given attributes replaced.
+        """
+        if deep:
+            result = copy.deepcopy(self)
+        else:
+            result = copy.copy(self)
+        if name is not _KEEP:
+            result.name = name
+        if mtime is not _KEEP:
+            result.mtime = mtime
+        if mode is not _KEEP:
+            result.mode = mode
+        if linkname is not _KEEP:
+            result.linkname = linkname
+        if uid is not _KEEP:
+            result.uid = uid
+        if gid is not _KEEP:
+            result.gid = gid
+        if uname is not _KEEP:
+            result.uname = uname
+        if gname is not _KEEP:
+            result.gname = gname
+        return result
+
+    def get_info(self):
+        """Return the TarInfo's attributes as a dictionary.
+        """
+        if self.mode is None:
+            mode = None
+        else:
+            mode = self.mode & 0o7777
+        info = {
+            "name":     self.name,
+            "mode":     mode,
+            "uid":      self.uid,
+            "gid":      self.gid,
+            "size":     self.size,
+            "mtime":    self.mtime,
+            "chksum":   self.chksum,
+            "type":     self.type,
+            "linkname": self.linkname,
+            "uname":    self.uname,
+            "gname":    self.gname,
+            "devmajor": self.devmajor,
+            "devminor": self.devminor
+        }
+
+        if info["type"] == DIRTYPE and not info["name"].endswith("/"):
+            info["name"] += "/"
+
+        return info
+
+    def tobuf(self, format=DEFAULT_FORMAT, encoding=ENCODING, errors="surrogateescape"):
+        """Return a tar header as a string of 512 byte blocks.
+        """
+        info = self.get_info()
+        for name, value in info.items():
+            if value is None:
+                raise ValueError("%s may not be None" % name)
+
+        if format == USTAR_FORMAT:
+            return self.create_ustar_header(info, encoding, errors)
+        elif format == GNU_FORMAT:
+            return self.create_gnu_header(info, encoding, errors)
+        elif format == PAX_FORMAT:
+            return self.create_pax_header(info, encoding)
+        else:
+            raise ValueError("invalid format")
+
+    def create_ustar_header(self, info, encoding, errors):
+        """Return the object as a ustar header block.
+        """
+        info["magic"] = POSIX_MAGIC
+
+        if len(info["linkname"].encode(encoding, errors)) > LENGTH_LINK:
+            raise ValueError("linkname is too long")
+
+        if len(info["name"].encode(encoding, errors)) > LENGTH_NAME:
+            info["prefix"], info["name"] = self._posix_split_name(info["name"], encoding, errors)
+
+        return self._create_header(info, USTAR_FORMAT, encoding, errors)
+
+    def create_gnu_header(self, info, encoding, errors):
+        """Return the object as a GNU header block sequence.
+        """
+        info["magic"] = GNU_MAGIC
+
+        buf = b""
+        if len(info["linkname"].encode(encoding, errors)) > LENGTH_LINK:
+            buf += self._create_gnu_long_header(info["linkname"], GNUTYPE_LONGLINK, encoding, errors)
+
+        if len(info["name"].encode(encoding, errors)) > LENGTH_NAME:
+            buf += self._create_gnu_long_header(info["name"], GNUTYPE_LONGNAME, encoding, errors)
+
+        return buf + self._create_header(info, GNU_FORMAT, encoding, errors)
+
+    def create_pax_header(self, info, encoding):
+        """Return the object as a ustar header block. If it cannot be
+           represented this way, prepend a pax extended header sequence
+           with supplement information.
+        """
+        info["magic"] = POSIX_MAGIC
+        pax_headers = self.pax_headers.copy()
+
+        # Test string fields for values that exceed the field length or cannot
+        # be represented in ASCII encoding.
+        for name, hname, length in (
+                ("name", "path", LENGTH_NAME), ("linkname", "linkpath", LENGTH_LINK),
+                ("uname", "uname", 32), ("gname", "gname", 32)):
+
+            if hname in pax_headers:
+                # The pax header has priority.
+                continue
+
+            # Try to encode the string as ASCII.
+            try:
+                info[name].encode("ascii", "strict")
+            except UnicodeEncodeError:
+                pax_headers[hname] = info[name]
+                continue
+
+            if len(info[name]) > length:
+                pax_headers[hname] = info[name]
+
+        # Test number fields for values that exceed the field limit or values
+        # that like to be stored as float.
+        for name, digits in (("uid", 8), ("gid", 8), ("size", 12), ("mtime", 12)):
+            needs_pax = False
+
+            val = info[name]
+            val_is_float = isinstance(val, float)
+            val_int = round(val) if val_is_float else val
+            if not 0 <= val_int < 8 ** (digits - 1):
+                # Avoid overflow.
+                info[name] = 0
+                needs_pax = True
+            elif val_is_float:
+                # Put rounded value in ustar header, and full
+                # precision value in pax header.
+                info[name] = val_int
+                needs_pax = True
+
+            # The existing pax header has priority.
+            if needs_pax and name not in pax_headers:
+                pax_headers[name] = str(val)
+
+        # Create a pax extended header if necessary.
+        if pax_headers:
+            buf = self._create_pax_generic_header(pax_headers, XHDTYPE, encoding)
+        else:
+            buf = b""
+
+        return buf + self._create_header(info, USTAR_FORMAT, "ascii", "replace")
+
+    @classmethod
+    def create_pax_global_header(cls, pax_headers):
+        """Return the object as a pax global header block sequence.
+        """
+        return cls._create_pax_generic_header(pax_headers, XGLTYPE, "utf-8")
+
+    def _posix_split_name(self, name, encoding, errors):
+        """Split a name longer than 100 chars into a prefix
+           and a name part.
+        """
+        components = name.split("/")
+        for i in range(1, len(components)):
+            prefix = "/".join(components[:i])
+            name = "/".join(components[i:])
+            if len(prefix.encode(encoding, errors)) <= LENGTH_PREFIX and \
+                    len(name.encode(encoding, errors)) <= LENGTH_NAME:
+                break
+        else:
+            raise ValueError("name is too long")
+
+        return prefix, name
+
+    @staticmethod
+    def _create_header(info, format, encoding, errors):
+        """Return a header block. info is a dictionary with file
+           information, format must be one of the *_FORMAT constants.
+        """
+        has_device_fields = info.get("type") in (CHRTYPE, BLKTYPE)
+        if has_device_fields:
+            devmajor = itn(info.get("devmajor", 0), 8, format)
+            devminor = itn(info.get("devminor", 0), 8, format)
+        else:
+            devmajor = stn("", 8, encoding, errors)
+            devminor = stn("", 8, encoding, errors)
+
+        # None values in metadata should cause ValueError.
+        # itn()/stn() do this for all fields except type.
+        filetype = info.get("type", REGTYPE)
+        if filetype is None:
+            raise ValueError("TarInfo.type must not be None")
+
+        parts = [
+            stn(info.get("name", ""), 100, encoding, errors),
+            itn(info.get("mode", 0) & 0o7777, 8, format),
+            itn(info.get("uid", 0), 8, format),
+            itn(info.get("gid", 0), 8, format),
+            itn(info.get("size", 0), 12, format),
+            itn(info.get("mtime", 0), 12, format),
+            b"        ", # checksum field
+            filetype,
+            stn(info.get("linkname", ""), 100, encoding, errors),
+            info.get("magic", POSIX_MAGIC),
+            stn(info.get("uname", ""), 32, encoding, errors),
+            stn(info.get("gname", ""), 32, encoding, errors),
+            devmajor,
+            devminor,
+            stn(info.get("prefix", ""), 155, encoding, errors)
+        ]
+
+        buf = struct.pack("%ds" % BLOCKSIZE, b"".join(parts))
+        chksum = calc_chksums(buf[-BLOCKSIZE:])[0]
+        buf = buf[:-364] + bytes("%06o\0" % chksum, "ascii") + buf[-357:]
+        return buf
+
+    @staticmethod
+    def _create_payload(payload):
+        """Return the string payload filled with zero bytes
+           up to the next 512 byte border.
+        """
+        blocks, remainder = divmod(len(payload), BLOCKSIZE)
+        if remainder > 0:
+            payload += (BLOCKSIZE - remainder) * NUL
+        return payload
+
+    @classmethod
+    def _create_gnu_long_header(cls, name, type, encoding, errors):
+        """Return a GNUTYPE_LONGNAME or GNUTYPE_LONGLINK sequence
+           for name.
+        """
+        name = name.encode(encoding, errors) + NUL
+
+        info = {}
+        info["name"] = "././@LongLink"
+        info["type"] = type
+        info["size"] = len(name)
+        info["magic"] = GNU_MAGIC
+
+        # create extended header + name blocks.
+        return cls._create_header(info, USTAR_FORMAT, encoding, errors) + \
+                cls._create_payload(name)
+
+    @classmethod
+    def _create_pax_generic_header(cls, pax_headers, type, encoding):
+        """Return a POSIX.1-2008 extended or global header sequence
+           that contains a list of keyword, value pairs. The values
+           must be strings.
+        """
+        # Check if one of the fields contains surrogate characters and thereby
+        # forces hdrcharset=BINARY, see _proc_pax() for more information.
+        binary = False
+        for keyword, value in pax_headers.items():
+            try:
+                value.encode("utf-8", "strict")
+            except UnicodeEncodeError:
+                binary = True
+                break
+
+        records = b""
+        if binary:
+            # Put the hdrcharset field at the beginning of the header.
+            records += b"21 hdrcharset=BINARY\n"
+
+        for keyword, value in pax_headers.items():
+            keyword = keyword.encode("utf-8")
+            if binary:
+                # Try to restore the original byte representation of `value'.
+                # Needless to say, that the encoding must match the string.
+                value = value.encode(encoding, "surrogateescape")
+            else:
+                value = value.encode("utf-8")
+
+            l = len(keyword) + len(value) + 3   # ' ' + '=' + '\n'
+            n = p = 0
+            while True:
+                n = l + len(str(p))
+                if n == p:
+                    break
+                p = n
+            records += bytes(str(p), "ascii") + b" " + keyword + b"=" + value + b"\n"
+
+        # We use a hardcoded "././@PaxHeader" name like star does
+        # instead of the one that POSIX recommends.
+        info = {}
+        info["name"] = "././@PaxHeader"
+        info["type"] = type
+        info["size"] = len(records)
+        info["magic"] = POSIX_MAGIC
+
+        # Create pax header + record blocks.
+        return cls._create_header(info, USTAR_FORMAT, "ascii", "replace") + \
+                cls._create_payload(records)
+
+    @classmethod
+    def frombuf(cls, buf, encoding, errors):
+        """Construct a TarInfo object from a 512 byte bytes object.
+        """
+        if len(buf) == 0:
+            raise EmptyHeaderError("empty header")
+        if len(buf) != BLOCKSIZE:
+            raise TruncatedHeaderError("truncated header")
+        if buf.count(NUL) == BLOCKSIZE:
+            raise EOFHeaderError("end of file header")
+
+        chksum = nti(buf[148:156])
+        if chksum not in calc_chksums(buf):
+            raise InvalidHeaderError("bad checksum")
+
+        obj = cls()
+        obj.name = nts(buf[0:100], encoding, errors)
+        obj.mode = nti(buf[100:108])
+        obj.uid = nti(buf[108:116])
+        obj.gid = nti(buf[116:124])
+        obj.size = nti(buf[124:136])
+        obj.mtime = nti(buf[136:148])
+        obj.chksum = chksum
+        obj.type = buf[156:157]
+        obj.linkname = nts(buf[157:257], encoding, errors)
+        obj.uname = nts(buf[265:297], encoding, errors)
+        obj.gname = nts(buf[297:329], encoding, errors)
+        obj.devmajor = nti(buf[329:337])
+        obj.devminor = nti(buf[337:345])
+        prefix = nts(buf[345:500], encoding, errors)
+
+        # Old V7 tar format represents a directory as a regular
+        # file with a trailing slash.
+        if obj.type == AREGTYPE and obj.name.endswith("/"):
+            obj.type = DIRTYPE
+
+        # The old GNU sparse format occupies some of the unused
+        # space in the buffer for up to 4 sparse structures.
+        # Save them for later processing in _proc_sparse().
+        if obj.type == GNUTYPE_SPARSE:
+            pos = 386
+            structs = []
+            for i in range(4):
+                try:
+                    offset = nti(buf[pos:pos + 12])
+                    numbytes = nti(buf[pos + 12:pos + 24])
+                except ValueError:
+                    break
+                structs.append((offset, numbytes))
+                pos += 24
+            isextended = bool(buf[482])
+            origsize = nti(buf[483:495])
+            obj._sparse_structs = (structs, isextended, origsize)
+
+        # Remove redundant slashes from directories.
+        if obj.isdir():
+            obj.name = obj.name.rstrip("/")
+
+        # Reconstruct a ustar longname.
+        if prefix and obj.type not in GNU_TYPES:
+            obj.name = prefix + "/" + obj.name
+        return obj
+
+    @classmethod
+    def fromtarfile(cls, tarfile):
+        """Return the next TarInfo object from TarFile object
+           tarfile.
+        """
+        buf = tarfile.fileobj.read(BLOCKSIZE)
+        obj = cls.frombuf(buf, tarfile.encoding, tarfile.errors)
+        obj.offset = tarfile.fileobj.tell() - BLOCKSIZE
+        return obj._proc_member(tarfile)
+
+    #--------------------------------------------------------------------------
+    # The following are methods that are called depending on the type of a
+    # member. The entry point is _proc_member() which can be overridden in a
+    # subclass to add custom _proc_*() methods. A _proc_*() method MUST
+    # implement the following
+    # operations:
+    # 1. Set self.offset_data to the position where the data blocks begin,
+    #    if there is data that follows.
+    # 2. Set tarfile.offset to the position where the next member's header will
+    #    begin.
+    # 3. Return self or another valid TarInfo object.
+    def _proc_member(self, tarfile):
+        """Choose the right processing method depending on
+           the type and call it.
+        """
+        if self.type in (GNUTYPE_LONGNAME, GNUTYPE_LONGLINK):
+            return self._proc_gnulong(tarfile)
+        elif self.type == GNUTYPE_SPARSE:
+            return self._proc_sparse(tarfile)
+        elif self.type in (XHDTYPE, XGLTYPE, SOLARIS_XHDTYPE):
+            return self._proc_pax(tarfile)
+        else:
+            return self._proc_builtin(tarfile)
+
+    def _proc_builtin(self, tarfile):
+        """Process a builtin type or an unknown type which
+           will be treated as a regular file.
+        """
+        self.offset_data = tarfile.fileobj.tell()
+        offset = self.offset_data
+        if self.isreg() or self.type not in SUPPORTED_TYPES:
+            # Skip the following data blocks.
+            offset += self._block(self.size)
+        tarfile.offset = offset
+
+        # Patch the TarInfo object with saved global
+        # header information.
+        self._apply_pax_info(tarfile.pax_headers, tarfile.encoding, tarfile.errors)
+
+        # Remove redundant slashes from directories. This is to be consistent
+        # with frombuf().
+        if self.isdir():
+            self.name = self.name.rstrip("/")
+
+        return self
+
+    def _proc_gnulong(self, tarfile):
+        """Process the blocks that hold a GNU longname
+           or longlink member.
+        """
+        buf = tarfile.fileobj.read(self._block(self.size))
+
+        # Fetch the next header and process it.
+        try:
+            next = self.fromtarfile(tarfile)
+        except HeaderError as e:
+            raise SubsequentHeaderError(str(e)) from None
+
+        # Patch the TarInfo object from the next header with
+        # the longname information.
+        next.offset = self.offset
+        if self.type == GNUTYPE_LONGNAME:
+            next.name = nts(buf, tarfile.encoding, tarfile.errors)
+        elif self.type == GNUTYPE_LONGLINK:
+            next.linkname = nts(buf, tarfile.encoding, tarfile.errors)
+
+        # Remove redundant slashes from directories. This is to be consistent
+        # with frombuf().
+        if next.isdir():
+            next.name = removesuffix(next.name, "/")
+
+        return next
+
+    def _proc_sparse(self, tarfile):
+        """Process a GNU sparse header plus extra headers.
+        """
+        # We already collected some sparse structures in frombuf().
+        structs, isextended, origsize = self._sparse_structs
+        del self._sparse_structs
+
+        # Collect sparse structures from extended header blocks.
+        while isextended:
+            buf = tarfile.fileobj.read(BLOCKSIZE)
+            pos = 0
+            for i in range(21):
+                try:
+                    offset = nti(buf[pos:pos + 12])
+                    numbytes = nti(buf[pos + 12:pos + 24])
+                except ValueError:
+                    break
+                if offset and numbytes:
+                    structs.append((offset, numbytes))
+                pos += 24
+            isextended = bool(buf[504])
+        self.sparse = structs
+
+        self.offset_data = tarfile.fileobj.tell()
+        tarfile.offset = self.offset_data + self._block(self.size)
+        self.size = origsize
+        return self
+
+    def _proc_pax(self, tarfile):
+        """Process an extended or global header as described in
+           POSIX.1-2008.
+        """
+        # Read the header information.
+        buf = tarfile.fileobj.read(self._block(self.size))
+
+        # A pax header stores supplemental information for either
+        # the following file (extended) or all following files
+        # (global).
+        if self.type == XGLTYPE:
+            pax_headers = tarfile.pax_headers
+        else:
+            pax_headers = tarfile.pax_headers.copy()
+
+        # Check if the pax header contains a hdrcharset field. This tells us
+        # the encoding of the path, linkpath, uname and gname fields. Normally,
+        # these fields are UTF-8 encoded but since POSIX.1-2008 tar
+        # implementations are allowed to store them as raw binary strings if
+        # the translation to UTF-8 fails.
+        match = re.search(br"\d+ hdrcharset=([^\n]+)\n", buf)
+        if match is not None:
+            pax_headers["hdrcharset"] = match.group(1).decode("utf-8")
+
+        # For the time being, we don't care about anything other than "BINARY".
+        # The only other value that is currently allowed by the standard is
+        # "ISO-IR 10646 2000 UTF-8" in other words UTF-8.
+        hdrcharset = pax_headers.get("hdrcharset")
+        if hdrcharset == "BINARY":
+            encoding = tarfile.encoding
+        else:
+            encoding = "utf-8"
+
+        # Parse pax header information. A record looks like that:
+        # "%d %s=%s\n" % (length, keyword, value). length is the size
+        # of the complete record including the length field itself and
+        # the newline. keyword and value are both UTF-8 encoded strings.
+        regex = re.compile(br"(\d+) ([^=]+)=")
+        pos = 0
+        while match := regex.match(buf, pos):
+            length, keyword = match.groups()
+            length = int(length)
+            if length == 0:
+                raise InvalidHeaderError("invalid header")
+            value = buf[match.end(2) + 1:match.start(1) + length - 1]
+
+            # Normally, we could just use "utf-8" as the encoding and "strict"
+            # as the error handler, but we better not take the risk. For
+            # example, GNU tar <= 1.23 is known to store filenames it cannot
+            # translate to UTF-8 as raw strings (unfortunately without a
+            # hdrcharset=BINARY header).
+            # We first try the strict standard encoding, and if that fails we
+            # fall back on the user's encoding and error handler.
+            keyword = self._decode_pax_field(keyword, "utf-8", "utf-8",
+                    tarfile.errors)
+            if keyword in PAX_NAME_FIELDS:
+                value = self._decode_pax_field(value, encoding, tarfile.encoding,
+                        tarfile.errors)
+            else:
+                value = self._decode_pax_field(value, "utf-8", "utf-8",
+                        tarfile.errors)
+
+            pax_headers[keyword] = value
+            pos += length
+
+        # Fetch the next header.
+        try:
+            next = self.fromtarfile(tarfile)
+        except HeaderError as e:
+            raise SubsequentHeaderError(str(e)) from None
+
+        # Process GNU sparse information.
+        if "GNU.sparse.map" in pax_headers:
+            # GNU extended sparse format version 0.1.
+            self._proc_gnusparse_01(next, pax_headers)
+
+        elif "GNU.sparse.size" in pax_headers:
+            # GNU extended sparse format version 0.0.
+            self._proc_gnusparse_00(next, pax_headers, buf)
+
+        elif pax_headers.get("GNU.sparse.major") == "1" and pax_headers.get("GNU.sparse.minor") == "0":
+            # GNU extended sparse format version 1.0.
+            self._proc_gnusparse_10(next, pax_headers, tarfile)
+
+        if self.type in (XHDTYPE, SOLARIS_XHDTYPE):
+            # Patch the TarInfo object with the extended header info.
+            next._apply_pax_info(pax_headers, tarfile.encoding, tarfile.errors)
+            next.offset = self.offset
+
+            if "size" in pax_headers:
+                # If the extended header replaces the size field,
+                # we need to recalculate the offset where the next
+                # header starts.
+                offset = next.offset_data
+                if next.isreg() or next.type not in SUPPORTED_TYPES:
+                    offset += next._block(next.size)
+                tarfile.offset = offset
+
+        return next
+
+    def _proc_gnusparse_00(self, next, pax_headers, buf):
+        """Process a GNU tar extended sparse header, version 0.0.
+        """
+        offsets = []
+        for match in re.finditer(br"\d+ GNU.sparse.offset=(\d+)\n", buf):
+            offsets.append(int(match.group(1)))
+        numbytes = []
+        for match in re.finditer(br"\d+ GNU.sparse.numbytes=(\d+)\n", buf):
+            numbytes.append(int(match.group(1)))
+        next.sparse = list(zip(offsets, numbytes))
+
+    def _proc_gnusparse_01(self, next, pax_headers):
+        """Process a GNU tar extended sparse header, version 0.1.
+        """
+        sparse = [int(x) for x in pax_headers["GNU.sparse.map"].split(",")]
+        next.sparse = list(zip(sparse[::2], sparse[1::2]))
+
+    def _proc_gnusparse_10(self, next, pax_headers, tarfile):
+        """Process a GNU tar extended sparse header, version 1.0.
+        """
+        fields = None
+        sparse = []
+        buf = tarfile.fileobj.read(BLOCKSIZE)
+        fields, buf = buf.split(b"\n", 1)
+        fields = int(fields)
+        while len(sparse) < fields * 2:
+            if b"\n" not in buf:
+                buf += tarfile.fileobj.read(BLOCKSIZE)
+            number, buf = buf.split(b"\n", 1)
+            sparse.append(int(number))
+        next.offset_data = tarfile.fileobj.tell()
+        next.sparse = list(zip(sparse[::2], sparse[1::2]))
+
+    def _apply_pax_info(self, pax_headers, encoding, errors):
+        """Replace fields with supplemental information from a previous
+           pax extended or global header.
+        """
+        for keyword, value in pax_headers.items():
+            if keyword == "GNU.sparse.name":
+                setattr(self, "path", value)
+            elif keyword == "GNU.sparse.size":
+                setattr(self, "size", int(value))
+            elif keyword == "GNU.sparse.realsize":
+                setattr(self, "size", int(value))
+            elif keyword in PAX_FIELDS:
+                if keyword in PAX_NUMBER_FIELDS:
+                    try:
+                        value = PAX_NUMBER_FIELDS[keyword](value)
+                    except ValueError:
+                        value = 0
+                if keyword == "path":
+                    value = value.rstrip("/")
+                setattr(self, keyword, value)
+
+        self.pax_headers = pax_headers.copy()
+
+    def _decode_pax_field(self, value, encoding, fallback_encoding, fallback_errors):
+        """Decode a single field from a pax record.
+        """
+        try:
+            return value.decode(encoding, "strict")
+        except UnicodeDecodeError:
+            return value.decode(fallback_encoding, fallback_errors)
+
+    def _block(self, count):
+        """Round up a byte count by BLOCKSIZE and return it,
+           e.g. _block(834) => 1024.
+        """
+        blocks, remainder = divmod(count, BLOCKSIZE)
+        if remainder:
+            blocks += 1
+        return blocks * BLOCKSIZE
+
+    def isreg(self):
+        'Return True if the Tarinfo object is a regular file.'
+        return self.type in REGULAR_TYPES
+
+    def isfile(self):
+        'Return True if the Tarinfo object is a regular file.'
+        return self.isreg()
+
+    def isdir(self):
+        'Return True if it is a directory.'
+        return self.type == DIRTYPE
+
+    def issym(self):
+        'Return True if it is a symbolic link.'
+        return self.type == SYMTYPE
+
+    def islnk(self):
+        'Return True if it is a hard link.'
+        return self.type == LNKTYPE
+
+    def ischr(self):
+        'Return True if it is a character device.'
+        return self.type == CHRTYPE
+
+    def isblk(self):
+        'Return True if it is a block device.'
+        return self.type == BLKTYPE
+
+    def isfifo(self):
+        'Return True if it is a FIFO.'
+        return self.type == FIFOTYPE
+
+    def issparse(self):
+        return self.sparse is not None
+
+    def isdev(self):
+        'Return True if it is one of character device, block device or FIFO.'
+        return self.type in (CHRTYPE, BLKTYPE, FIFOTYPE)
+# class TarInfo
+
+class TarFile(object):
+    """The TarFile Class provides an interface to tar archives.
+    """
+
+    debug = 0                   # May be set from 0 (no msgs) to 3 (all msgs)
+
+    dereference = False         # If true, add content of linked file to the
+                                # tar file, else the link.
+
+    ignore_zeros = False        # If true, skips empty or invalid blocks and
+                                # continues processing.
+
+    errorlevel = 1              # If 0, fatal errors only appear in debug
+                                # messages (if debug >= 0). If > 0, errors
+                                # are passed to the caller as exceptions.
+
+    format = DEFAULT_FORMAT     # The format to use when creating an archive.
+
+    encoding = ENCODING         # Encoding for 8-bit character strings.
+
+    errors = None               # Error handler for unicode conversion.
+
+    tarinfo = TarInfo           # The default TarInfo class to use.
+
+    fileobject = ExFileObject   # The file-object for extractfile().
+
+    extraction_filter = None    # The default filter for extraction.
+
+    def __init__(self, name=None, mode="r", fileobj=None, format=None,
+            tarinfo=None, dereference=None, ignore_zeros=None, encoding=None,
+            errors="surrogateescape", pax_headers=None, debug=None,
+            errorlevel=None, copybufsize=None):
+        """Open an (uncompressed) tar archive `name'. `mode' is either 'r' to
+           read from an existing archive, 'a' to append data to an existing
+           file or 'w' to create a new file overwriting an existing one. `mode'
+           defaults to 'r'.
+           If `fileobj' is given, it is used for reading or writing data. If it
+           can be determined, `mode' is overridden by `fileobj's mode.
+           `fileobj' is not closed, when TarFile is closed.
+        """
+        modes = {"r": "rb", "a": "r+b", "w": "wb", "x": "xb"}
+        if mode not in modes:
+            raise ValueError("mode must be 'r', 'a', 'w' or 'x'")
+        self.mode = mode
+        self._mode = modes[mode]
+
+        if not fileobj:
+            if self.mode == "a" and not os.path.exists(name):
+                # Create nonexistent files in append mode.
+                self.mode = "w"
+                self._mode = "wb"
+            fileobj = bltn_open(name, self._mode)
+            self._extfileobj = False
+        else:
+            if (name is None and hasattr(fileobj, "name") and
+                isinstance(fileobj.name, (str, bytes))):
+                name = fileobj.name
+            if hasattr(fileobj, "mode"):
+                self._mode = fileobj.mode
+            self._extfileobj = True
+        self.name = os.path.abspath(name) if name else None
+        self.fileobj = fileobj
+
+        # Init attributes.
+        if format is not None:
+            self.format = format
+        if tarinfo is not None:
+            self.tarinfo = tarinfo
+        if dereference is not None:
+            self.dereference = dereference
+        if ignore_zeros is not None:
+            self.ignore_zeros = ignore_zeros
+        if encoding is not None:
+            self.encoding = encoding
+        self.errors = errors
+
+        if pax_headers is not None and self.format == PAX_FORMAT:
+            self.pax_headers = pax_headers
+        else:
+            self.pax_headers = {}
+
+        if debug is not None:
+            self.debug = debug
+        if errorlevel is not None:
+            self.errorlevel = errorlevel
+
+        # Init datastructures.
+        self.copybufsize = copybufsize
+        self.closed = False
+        self.members = []       # list of members as TarInfo objects
+        self._loaded = False    # flag if all members have been read
+        self.offset = self.fileobj.tell()
+                                # current position in the archive file
+        self.inodes = {}        # dictionary caching the inodes of
+                                # archive members already added
+
+        try:
+            if self.mode == "r":
+                self.firstmember = None
+                self.firstmember = self.next()
+
+            if self.mode == "a":
+                # Move to the end of the archive,
+                # before the first empty block.
+                while True:
+                    self.fileobj.seek(self.offset)
+                    try:
+                        tarinfo = self.tarinfo.fromtarfile(self)
+                        self.members.append(tarinfo)
+                    except EOFHeaderError:
+                        self.fileobj.seek(self.offset)
+                        break
+                    except HeaderError as e:
+                        raise ReadError(str(e)) from None
+
+            if self.mode in ("a", "w", "x"):
+                self._loaded = True
+
+                if self.pax_headers:
+                    buf = self.tarinfo.create_pax_global_header(self.pax_headers.copy())
+                    self.fileobj.write(buf)
+                    self.offset += len(buf)
+        except:
+            if not self._extfileobj:
+                self.fileobj.close()
+            self.closed = True
+            raise
+
+    #--------------------------------------------------------------------------
+    # Below are the classmethods which act as alternate constructors to the
+    # TarFile class. The open() method is the only one that is needed for
+    # public use; it is the "super"-constructor and is able to select an
+    # adequate "sub"-constructor for a particular compression using the mapping
+    # from OPEN_METH.
+    #
+    # This concept allows one to subclass TarFile without losing the comfort of
+    # the super-constructor. A sub-constructor is registered and made available
+    # by adding it to the mapping in OPEN_METH.
+
+    @classmethod
+    def open(cls, name=None, mode="r", fileobj=None, bufsize=RECORDSIZE, **kwargs):
+        r"""Open a tar archive for reading, writing or appending. Return
+           an appropriate TarFile class.
+
+           mode:
+           'r' or 'r:\*' open for reading with transparent compression
+           'r:'         open for reading exclusively uncompressed
+           'r:gz'       open for reading with gzip compression
+           'r:bz2'      open for reading with bzip2 compression
+           'r:xz'       open for reading with lzma compression
+           'a' or 'a:'  open for appending, creating the file if necessary
+           'w' or 'w:'  open for writing without compression
+           'w:gz'       open for writing with gzip compression
+           'w:bz2'      open for writing with bzip2 compression
+           'w:xz'       open for writing with lzma compression
+
+           'x' or 'x:'  create a tarfile exclusively without compression, raise
+                        an exception if the file is already created
+           'x:gz'       create a gzip compressed tarfile, raise an exception
+                        if the file is already created
+           'x:bz2'      create a bzip2 compressed tarfile, raise an exception
+                        if the file is already created
+           'x:xz'       create an lzma compressed tarfile, raise an exception
+                        if the file is already created
+
+           'r|\*'        open a stream of tar blocks with transparent compression
+           'r|'         open an uncompressed stream of tar blocks for reading
+           'r|gz'       open a gzip compressed stream of tar blocks
+           'r|bz2'      open a bzip2 compressed stream of tar blocks
+           'r|xz'       open an lzma compressed stream of tar blocks
+           'w|'         open an uncompressed stream for writing
+           'w|gz'       open a gzip compressed stream for writing
+           'w|bz2'      open a bzip2 compressed stream for writing
+           'w|xz'       open an lzma compressed stream for writing
+        """
+
+        if not name and not fileobj:
+            raise ValueError("nothing to open")
+
+        if mode in ("r", "r:*"):
+            # Find out which *open() is appropriate for opening the file.
+            def not_compressed(comptype):
+                return cls.OPEN_METH[comptype] == 'taropen'
+            error_msgs = []
+            for comptype in sorted(cls.OPEN_METH, key=not_compressed):
+                func = getattr(cls, cls.OPEN_METH[comptype])
+                if fileobj is not None:
+                    saved_pos = fileobj.tell()
+                try:
+                    return func(name, "r", fileobj, **kwargs)
+                except (ReadError, CompressionError) as e:
+                    error_msgs.append(f'- method {comptype}: {e!r}')
+                    if fileobj is not None:
+                        fileobj.seek(saved_pos)
+                    continue
+            error_msgs_summary = '\n'.join(error_msgs)
+            raise ReadError(f"file could not be opened successfully:\n{error_msgs_summary}")
+
+        elif ":" in mode:
+            filemode, comptype = mode.split(":", 1)
+            filemode = filemode or "r"
+            comptype = comptype or "tar"
+
+            # Select the *open() function according to
+            # given compression.
+            if comptype in cls.OPEN_METH:
+                func = getattr(cls, cls.OPEN_METH[comptype])
+            else:
+                raise CompressionError("unknown compression type %r" % comptype)
+            return func(name, filemode, fileobj, **kwargs)
+
+        elif "|" in mode:
+            filemode, comptype = mode.split("|", 1)
+            filemode = filemode or "r"
+            comptype = comptype or "tar"
+
+            if filemode not in ("r", "w"):
+                raise ValueError("mode must be 'r' or 'w'")
+
+            compresslevel = kwargs.pop("compresslevel", 9)
+            stream = _Stream(name, filemode, comptype, fileobj, bufsize,
+                             compresslevel)
+            try:
+                t = cls(name, filemode, stream, **kwargs)
+            except:
+                stream.close()
+                raise
+            t._extfileobj = False
+            return t
+
+        elif mode in ("a", "w", "x"):
+            return cls.taropen(name, mode, fileobj, **kwargs)
+
+        raise ValueError("undiscernible mode")
+
+    @classmethod
+    def taropen(cls, name, mode="r", fileobj=None, **kwargs):
+        """Open uncompressed tar archive name for reading or writing.
+        """
+        if mode not in ("r", "a", "w", "x"):
+            raise ValueError("mode must be 'r', 'a', 'w' or 'x'")
+        return cls(name, mode, fileobj, **kwargs)
+
+    @classmethod
+    def gzopen(cls, name, mode="r", fileobj=None, compresslevel=9, **kwargs):
+        """Open gzip compressed tar archive name for reading or writing.
+           Appending is not allowed.
+        """
+        if mode not in ("r", "w", "x"):
+            raise ValueError("mode must be 'r', 'w' or 'x'")
+
+        try:
+            from gzip import GzipFile
+        except ImportError:
+            raise CompressionError("gzip module is not available") from None
+
+        try:
+            fileobj = GzipFile(name, mode + "b", compresslevel, fileobj)
+        except OSError as e:
+            if fileobj is not None and mode == 'r':
+                raise ReadError("not a gzip file") from e
+            raise
+
+        try:
+            t = cls.taropen(name, mode, fileobj, **kwargs)
+        except OSError as e:
+            fileobj.close()
+            if mode == 'r':
+                raise ReadError("not a gzip file") from e
+            raise
+        except:
+            fileobj.close()
+            raise
+        t._extfileobj = False
+        return t
+
+    @classmethod
+    def bz2open(cls, name, mode="r", fileobj=None, compresslevel=9, **kwargs):
+        """Open bzip2 compressed tar archive name for reading or writing.
+           Appending is not allowed.
+        """
+        if mode not in ("r", "w", "x"):
+            raise ValueError("mode must be 'r', 'w' or 'x'")
+
+        try:
+            from bz2 import BZ2File
+        except ImportError:
+            raise CompressionError("bz2 module is not available") from None
+
+        fileobj = BZ2File(fileobj or name, mode, compresslevel=compresslevel)
+
+        try:
+            t = cls.taropen(name, mode, fileobj, **kwargs)
+        except (OSError, EOFError) as e:
+            fileobj.close()
+            if mode == 'r':
+                raise ReadError("not a bzip2 file") from e
+            raise
+        except:
+            fileobj.close()
+            raise
+        t._extfileobj = False
+        return t
+
+    @classmethod
+    def xzopen(cls, name, mode="r", fileobj=None, preset=None, **kwargs):
+        """Open lzma compressed tar archive name for reading or writing.
+           Appending is not allowed.
+        """
+        if mode not in ("r", "w", "x"):
+            raise ValueError("mode must be 'r', 'w' or 'x'")
+
+        try:
+            from lzma import LZMAFile, LZMAError
+        except ImportError:
+            raise CompressionError("lzma module is not available") from None
+
+        fileobj = LZMAFile(fileobj or name, mode, preset=preset)
+
+        try:
+            t = cls.taropen(name, mode, fileobj, **kwargs)
+        except (LZMAError, EOFError) as e:
+            fileobj.close()
+            if mode == 'r':
+                raise ReadError("not an lzma file") from e
+            raise
+        except:
+            fileobj.close()
+            raise
+        t._extfileobj = False
+        return t
+
+    # All *open() methods are registered here.
+    OPEN_METH = {
+        "tar": "taropen",   # uncompressed tar
+        "gz":  "gzopen",    # gzip compressed tar
+        "bz2": "bz2open",   # bzip2 compressed tar
+        "xz":  "xzopen"     # lzma compressed tar
+    }
+
+    #--------------------------------------------------------------------------
+    # The public methods which TarFile provides:
+
+    def close(self):
+        """Close the TarFile. In write-mode, two finishing zero blocks are
+           appended to the archive.
+        """
+        if self.closed:
+            return
+
+        self.closed = True
+        try:
+            if self.mode in ("a", "w", "x"):
+                self.fileobj.write(NUL * (BLOCKSIZE * 2))
+                self.offset += (BLOCKSIZE * 2)
+                # fill up the end with zero-blocks
+                # (like option -b20 for tar does)
+                blocks, remainder = divmod(self.offset, RECORDSIZE)
+                if remainder > 0:
+                    self.fileobj.write(NUL * (RECORDSIZE - remainder))
+        finally:
+            if not self._extfileobj:
+                self.fileobj.close()
+
+    def getmember(self, name):
+        """Return a TarInfo object for member ``name``. If ``name`` can not be
+           found in the archive, KeyError is raised. If a member occurs more
+           than once in the archive, its last occurrence is assumed to be the
+           most up-to-date version.
+        """
+        tarinfo = self._getmember(name.rstrip('/'))
+        if tarinfo is None:
+            raise KeyError("filename %r not found" % name)
+        return tarinfo
+
+    def getmembers(self):
+        """Return the members of the archive as a list of TarInfo objects. The
+           list has the same order as the members in the archive.
+        """
+        self._check()
+        if not self._loaded:    # if we want to obtain a list of
+            self._load()        # all members, we first have to
+                                # scan the whole archive.
+        return self.members
+
+    def getnames(self):
+        """Return the members of the archive as a list of their names. It has
+           the same order as the list returned by getmembers().
+        """
+        return [tarinfo.name for tarinfo in self.getmembers()]
+
+    def gettarinfo(self, name=None, arcname=None, fileobj=None):
+        """Create a TarInfo object from the result of os.stat or equivalent
+           on an existing file. The file is either named by ``name``, or
+           specified as a file object ``fileobj`` with a file descriptor. If
+           given, ``arcname`` specifies an alternative name for the file in the
+           archive, otherwise, the name is taken from the 'name' attribute of
+           'fileobj', or the 'name' argument. The name should be a text
+           string.
+        """
+        self._check("awx")
+
+        # When fileobj is given, replace name by
+        # fileobj's real name.
+        if fileobj is not None:
+            name = fileobj.name
+
+        # Building the name of the member in the archive.
+        # Backward slashes are converted to forward slashes,
+        # Absolute paths are turned to relative paths.
+        if arcname is None:
+            arcname = name
+        drv, arcname = os.path.splitdrive(arcname)
+        arcname = arcname.replace(os.sep, "/")
+        arcname = arcname.lstrip("/")
+
+        # Now, fill the TarInfo object with
+        # information specific for the file.
+        tarinfo = self.tarinfo()
+        tarinfo.tarfile = self  # Not needed
+
+        # Use os.stat or os.lstat, depending on if symlinks shall be resolved.
+        if fileobj is None:
+            if not self.dereference:
+                statres = os.lstat(name)
+            else:
+                statres = os.stat(name)
+        else:
+            statres = os.fstat(fileobj.fileno())
+        linkname = ""
+
+        stmd = statres.st_mode
+        if stat.S_ISREG(stmd):
+            inode = (statres.st_ino, statres.st_dev)
+            if not self.dereference and statres.st_nlink > 1 and \
+                    inode in self.inodes and arcname != self.inodes[inode]:
+                # Is it a hardlink to an already
+                # archived file?
+                type = LNKTYPE
+                linkname = self.inodes[inode]
+            else:
+                # The inode is added only if its valid.
+                # For win32 it is always 0.
+                type = REGTYPE
+                if inode[0]:
+                    self.inodes[inode] = arcname
+        elif stat.S_ISDIR(stmd):
+            type = DIRTYPE
+        elif stat.S_ISFIFO(stmd):
+            type = FIFOTYPE
+        elif stat.S_ISLNK(stmd):
+            type = SYMTYPE
+            linkname = os.readlink(name)
+        elif stat.S_ISCHR(stmd):
+            type = CHRTYPE
+        elif stat.S_ISBLK(stmd):
+            type = BLKTYPE
+        else:
+            return None
+
+        # Fill the TarInfo object with all
+        # information we can get.
+        tarinfo.name = arcname
+        tarinfo.mode = stmd
+        tarinfo.uid = statres.st_uid
+        tarinfo.gid = statres.st_gid
+        if type == REGTYPE:
+            tarinfo.size = statres.st_size
+        else:
+            tarinfo.size = 0
+        tarinfo.mtime = statres.st_mtime
+        tarinfo.type = type
+        tarinfo.linkname = linkname
+        if pwd:
+            try:
+                tarinfo.uname = pwd.getpwuid(tarinfo.uid)[0]
+            except KeyError:
+                pass
+        if grp:
+            try:
+                tarinfo.gname = grp.getgrgid(tarinfo.gid)[0]
+            except KeyError:
+                pass
+
+        if type in (CHRTYPE, BLKTYPE):
+            if hasattr(os, "major") and hasattr(os, "minor"):
+                tarinfo.devmajor = os.major(statres.st_rdev)
+                tarinfo.devminor = os.minor(statres.st_rdev)
+        return tarinfo
+
+    def list(self, verbose=True, *, members=None):
+        """Print a table of contents to sys.stdout. If ``verbose`` is False, only
+           the names of the members are printed. If it is True, an `ls -l'-like
+           output is produced. ``members`` is optional and must be a subset of the
+           list returned by getmembers().
+        """
+        self._check()
+
+        if members is None:
+            members = self
+        for tarinfo in members:
+            if verbose:
+                if tarinfo.mode is None:
+                    _safe_print("??????????")
+                else:
+                    _safe_print(stat.filemode(tarinfo.mode))
+                _safe_print("%s/%s" % (tarinfo.uname or tarinfo.uid,
+                                       tarinfo.gname or tarinfo.gid))
+                if tarinfo.ischr() or tarinfo.isblk():
+                    _safe_print("%10s" %
+                            ("%d,%d" % (tarinfo.devmajor, tarinfo.devminor)))
+                else:
+                    _safe_print("%10d" % tarinfo.size)
+                if tarinfo.mtime is None:
+                    _safe_print("????-??-?? ??:??:??")
+                else:
+                    _safe_print("%d-%02d-%02d %02d:%02d:%02d" \
+                                % time.localtime(tarinfo.mtime)[:6])
+
+            _safe_print(tarinfo.name + ("/" if tarinfo.isdir() else ""))
+
+            if verbose:
+                if tarinfo.issym():
+                    _safe_print("-> " + tarinfo.linkname)
+                if tarinfo.islnk():
+                    _safe_print("link to " + tarinfo.linkname)
+            print()
+
+    def add(self, name, arcname=None, recursive=True, *, filter=None):
+        """Add the file ``name`` to the archive. ``name`` may be any type of file
+           (directory, fifo, symbolic link, etc.). If given, ``arcname``
+           specifies an alternative name for the file in the archive.
+           Directories are added recursively by default. This can be avoided by
+           setting ``recursive`` to False. ``filter`` is a function
+           that expects a TarInfo object argument and returns the changed
+           TarInfo object, if it returns None the TarInfo object will be
+           excluded from the archive.
+        """
+        self._check("awx")
+
+        if arcname is None:
+            arcname = name
+
+        # Skip if somebody tries to archive the archive...
+        if self.name is not None and os.path.abspath(name) == self.name:
+            self._dbg(2, "tarfile: Skipped %r" % name)
+            return
+
+        self._dbg(1, name)
+
+        # Create a TarInfo object from the file.
+        tarinfo = self.gettarinfo(name, arcname)
+
+        if tarinfo is None:
+            self._dbg(1, "tarfile: Unsupported type %r" % name)
+            return
+
+        # Change or exclude the TarInfo object.
+        if filter is not None:
+            tarinfo = filter(tarinfo)
+            if tarinfo is None:
+                self._dbg(2, "tarfile: Excluded %r" % name)
+                return
+
+        # Append the tar header and data to the archive.
+        if tarinfo.isreg():
+            with bltn_open(name, "rb") as f:
+                self.addfile(tarinfo, f)
+
+        elif tarinfo.isdir():
+            self.addfile(tarinfo)
+            if recursive:
+                for f in sorted(os.listdir(name)):
+                    self.add(os.path.join(name, f), os.path.join(arcname, f),
+                            recursive, filter=filter)
+
+        else:
+            self.addfile(tarinfo)
+
+    def addfile(self, tarinfo, fileobj=None):
+        """Add the TarInfo object ``tarinfo`` to the archive. If ``fileobj`` is
+           given, it should be a binary file, and tarinfo.size bytes are read
+           from it and added to the archive. You can create TarInfo objects
+           directly, or by using gettarinfo().
+        """
+        self._check("awx")
+
+        tarinfo = copy.copy(tarinfo)
+
+        buf = tarinfo.tobuf(self.format, self.encoding, self.errors)
+        self.fileobj.write(buf)
+        self.offset += len(buf)
+        bufsize=self.copybufsize
+        # If there's data to follow, append it.
+        if fileobj is not None:
+            copyfileobj(fileobj, self.fileobj, tarinfo.size, bufsize=bufsize)
+            blocks, remainder = divmod(tarinfo.size, BLOCKSIZE)
+            if remainder > 0:
+                self.fileobj.write(NUL * (BLOCKSIZE - remainder))
+                blocks += 1
+            self.offset += blocks * BLOCKSIZE
+
+        self.members.append(tarinfo)
+
+    def _get_filter_function(self, filter):
+        if filter is None:
+            filter = self.extraction_filter
+            if filter is None:
+                warnings.warn(
+                    'Python 3.14 will, by default, filter extracted tar '
+                    + 'archives and reject files or modify their metadata. '
+                    + 'Use the filter argument to control this behavior.',
+                    DeprecationWarning)
+                return fully_trusted_filter
+            if isinstance(filter, str):
+                raise TypeError(
+                    'String names are not supported for '
+                    + 'TarFile.extraction_filter. Use a function such as '
+                    + 'tarfile.data_filter directly.')
+            return filter
+        if callable(filter):
+            return filter
+        try:
+            return _NAMED_FILTERS[filter]
+        except KeyError:
+            raise ValueError(f"filter {filter!r} not found") from None
+
+    def extractall(self, path=".", members=None, *, numeric_owner=False,
+                   filter=None):
+        """Extract all members from the archive to the current working
+           directory and set owner, modification time and permissions on
+           directories afterwards. `path' specifies a different directory
+           to extract to. `members' is optional and must be a subset of the
+           list returned by getmembers(). If `numeric_owner` is True, only
+           the numbers for user/group names are used and not the names.
+
+           The `filter` function will be called on each member just
+           before extraction.
+           It can return a changed TarInfo or None to skip the member.
+           String names of common filters are accepted.
+        """
+        directories = []
+
+        filter_function = self._get_filter_function(filter)
+        if members is None:
+            members = self
+
+        for member in members:
+            tarinfo = self._get_extract_tarinfo(member, filter_function, path)
+            if tarinfo is None:
+                continue
+            if tarinfo.isdir():
+                # For directories, delay setting attributes until later,
+                # since permissions can interfere with extraction and
+                # extracting contents can reset mtime.
+                directories.append(tarinfo)
+            self._extract_one(tarinfo, path, set_attrs=not tarinfo.isdir(),
+                              numeric_owner=numeric_owner)
+
+        # Reverse sort directories.
+        directories.sort(key=lambda a: a.name, reverse=True)
+
+        # Set correct owner, mtime and filemode on directories.
+        for tarinfo in directories:
+            dirpath = os.path.join(path, tarinfo.name)
+            try:
+                self.chown(tarinfo, dirpath, numeric_owner=numeric_owner)
+                self.utime(tarinfo, dirpath)
+                self.chmod(tarinfo, dirpath)
+            except ExtractError as e:
+                self._handle_nonfatal_error(e)
+
+    def extract(self, member, path="", set_attrs=True, *, numeric_owner=False,
+                filter=None):
+        """Extract a member from the archive to the current working directory,
+           using its full name. Its file information is extracted as accurately
+           as possible. `member' may be a filename or a TarInfo object. You can
+           specify a different directory using `path'. File attributes (owner,
+           mtime, mode) are set unless `set_attrs' is False. If `numeric_owner`
+           is True, only the numbers for user/group names are used and not
+           the names.
+
+           The `filter` function will be called before extraction.
+           It can return a changed TarInfo or None to skip the member.
+           String names of common filters are accepted.
+        """
+        filter_function = self._get_filter_function(filter)
+        tarinfo = self._get_extract_tarinfo(member, filter_function, path)
+        if tarinfo is not None:
+            self._extract_one(tarinfo, path, set_attrs, numeric_owner)
+
+    def _get_extract_tarinfo(self, member, filter_function, path):
+        """Get filtered TarInfo (or None) from member, which might be a str"""
+        if isinstance(member, str):
+            tarinfo = self.getmember(member)
+        else:
+            tarinfo = member
+
+        unfiltered = tarinfo
+        try:
+            tarinfo = filter_function(tarinfo, path)
+        except (OSError, FilterError) as e:
+            self._handle_fatal_error(e)
+        except ExtractError as e:
+            self._handle_nonfatal_error(e)
+        if tarinfo is None:
+            self._dbg(2, "tarfile: Excluded %r" % unfiltered.name)
+            return None
+        # Prepare the link target for makelink().
+        if tarinfo.islnk():
+            tarinfo = copy.copy(tarinfo)
+            tarinfo._link_target = os.path.join(path, tarinfo.linkname)
+        return tarinfo
+
+    def _extract_one(self, tarinfo, path, set_attrs, numeric_owner):
+        """Extract from filtered tarinfo to disk"""
+        self._check("r")
+
+        try:
+            self._extract_member(tarinfo, os.path.join(path, tarinfo.name),
+                                 set_attrs=set_attrs,
+                                 numeric_owner=numeric_owner)
+        except OSError as e:
+            self._handle_fatal_error(e)
+        except ExtractError as e:
+            self._handle_nonfatal_error(e)
+
+    def _handle_nonfatal_error(self, e):
+        """Handle non-fatal error (ExtractError) according to errorlevel"""
+        if self.errorlevel > 1:
+            raise
+        else:
+            self._dbg(1, "tarfile: %s" % e)
+
+    def _handle_fatal_error(self, e):
+        """Handle "fatal" error according to self.errorlevel"""
+        if self.errorlevel > 0:
+            raise
+        elif isinstance(e, OSError):
+            if e.filename is None:
+                self._dbg(1, "tarfile: %s" % e.strerror)
+            else:
+                self._dbg(1, "tarfile: %s %r" % (e.strerror, e.filename))
+        else:
+            self._dbg(1, "tarfile: %s %s" % (type(e).__name__, e))
+
+    def extractfile(self, member):
+        """Extract a member from the archive as a file object. ``member`` may be
+           a filename or a TarInfo object. If ``member`` is a regular file or
+           a link, an io.BufferedReader object is returned. For all other
+           existing members, None is returned. If ``member`` does not appear
+           in the archive, KeyError is raised.
+        """
+        self._check("r")
+
+        if isinstance(member, str):
+            tarinfo = self.getmember(member)
+        else:
+            tarinfo = member
+
+        if tarinfo.isreg() or tarinfo.type not in SUPPORTED_TYPES:
+            # Members with unknown types are treated as regular files.
+            return self.fileobject(self, tarinfo)
+
+        elif tarinfo.islnk() or tarinfo.issym():
+            if isinstance(self.fileobj, _Stream):
+                # A small but ugly workaround for the case that someone tries
+                # to extract a (sym)link as a file-object from a non-seekable
+                # stream of tar blocks.
+                raise StreamError("cannot extract (sym)link as file object")
+            else:
+                # A (sym)link's file object is its target's file object.
+                return self.extractfile(self._find_link_target(tarinfo))
+        else:
+            # If there's no data associated with the member (directory, chrdev,
+            # blkdev, etc.), return None instead of a file object.
+            return None
+
+    def _extract_member(self, tarinfo, targetpath, set_attrs=True,
+                        numeric_owner=False):
+        """Extract the TarInfo object tarinfo to a physical
+           file called targetpath.
+        """
+        # Fetch the TarInfo object for the given name
+        # and build the destination pathname, replacing
+        # forward slashes to platform specific separators.
+        targetpath = targetpath.rstrip("/")
+        targetpath = targetpath.replace("/", os.sep)
+
+        # Create all upper directories.
+        upperdirs = os.path.dirname(targetpath)
+        if upperdirs and not os.path.exists(upperdirs):
+            # Create directories that are not part of the archive with
+            # default permissions.
+            os.makedirs(upperdirs)
+
+        if tarinfo.islnk() or tarinfo.issym():
+            self._dbg(1, "%s -> %s" % (tarinfo.name, tarinfo.linkname))
+        else:
+            self._dbg(1, tarinfo.name)
+
+        if tarinfo.isreg():
+            self.makefile(tarinfo, targetpath)
+        elif tarinfo.isdir():
+            self.makedir(tarinfo, targetpath)
+        elif tarinfo.isfifo():
+            self.makefifo(tarinfo, targetpath)
+        elif tarinfo.ischr() or tarinfo.isblk():
+            self.makedev(tarinfo, targetpath)
+        elif tarinfo.islnk() or tarinfo.issym():
+            self.makelink(tarinfo, targetpath)
+        elif tarinfo.type not in SUPPORTED_TYPES:
+            self.makeunknown(tarinfo, targetpath)
+        else:
+            self.makefile(tarinfo, targetpath)
+
+        if set_attrs:
+            self.chown(tarinfo, targetpath, numeric_owner)
+            if not tarinfo.issym():
+                self.chmod(tarinfo, targetpath)
+                self.utime(tarinfo, targetpath)
+
+    #--------------------------------------------------------------------------
+    # Below are the different file methods. They are called via
+    # _extract_member() when extract() is called. They can be replaced in a
+    # subclass to implement other functionality.
+
+    def makedir(self, tarinfo, targetpath):
+        """Make a directory called targetpath.
+        """
+        try:
+            if tarinfo.mode is None:
+                # Use the system's default mode
+                os.mkdir(targetpath)
+            else:
+                # Use a safe mode for the directory, the real mode is set
+                # later in _extract_member().
+                os.mkdir(targetpath, 0o700)
+        except FileExistsError:
+            if not os.path.isdir(targetpath):
+                raise
+
+    def makefile(self, tarinfo, targetpath):
+        """Make a file called targetpath.
+        """
+        source = self.fileobj
+        source.seek(tarinfo.offset_data)
+        bufsize = self.copybufsize
+        with bltn_open(targetpath, "wb") as target:
+            if tarinfo.sparse is not None:
+                for offset, size in tarinfo.sparse:
+                    target.seek(offset)
+                    copyfileobj(source, target, size, ReadError, bufsize)
+                target.seek(tarinfo.size)
+                target.truncate()
+            else:
+                copyfileobj(source, target, tarinfo.size, ReadError, bufsize)
+
+    def makeunknown(self, tarinfo, targetpath):
+        """Make a file from a TarInfo object with an unknown type
+           at targetpath.
+        """
+        self.makefile(tarinfo, targetpath)
+        self._dbg(1, "tarfile: Unknown file type %r, " \
+                     "extracted as regular file." % tarinfo.type)
+
+    def makefifo(self, tarinfo, targetpath):
+        """Make a fifo called targetpath.
+        """
+        if hasattr(os, "mkfifo"):
+            os.mkfifo(targetpath)
+        else:
+            raise ExtractError("fifo not supported by system")
+
+    def makedev(self, tarinfo, targetpath):
+        """Make a character or block device called targetpath.
+        """
+        if not hasattr(os, "mknod") or not hasattr(os, "makedev"):
+            raise ExtractError("special devices not supported by system")
+
+        mode = tarinfo.mode
+        if mode is None:
+            # Use mknod's default
+            mode = 0o600
+        if tarinfo.isblk():
+            mode |= stat.S_IFBLK
+        else:
+            mode |= stat.S_IFCHR
+
+        os.mknod(targetpath, mode,
+                 os.makedev(tarinfo.devmajor, tarinfo.devminor))
+
+    def makelink(self, tarinfo, targetpath):
+        """Make a (symbolic) link called targetpath. If it cannot be created
+          (platform limitation), we try to make a copy of the referenced file
+          instead of a link.
+        """
+        try:
+            # For systems that support symbolic and hard links.
+            if tarinfo.issym():
+                if os.path.lexists(targetpath):
+                    # Avoid FileExistsError on following os.symlink.
+                    os.unlink(targetpath)
+                os.symlink(tarinfo.linkname, targetpath)
+            else:
+                if os.path.exists(tarinfo._link_target):
+                    os.link(tarinfo._link_target, targetpath)
+                else:
+                    self._extract_member(self._find_link_target(tarinfo),
+                                         targetpath)
+        except symlink_exception:
+            try:
+                self._extract_member(self._find_link_target(tarinfo),
+                                     targetpath)
+            except KeyError:
+                raise ExtractError("unable to resolve link inside archive") from None
+
+    def chown(self, tarinfo, targetpath, numeric_owner):
+        """Set owner of targetpath according to tarinfo. If numeric_owner
+           is True, use .gid/.uid instead of .gname/.uname. If numeric_owner
+           is False, fall back to .gid/.uid when the search based on name
+           fails.
+        """
+        if hasattr(os, "geteuid") and os.geteuid() == 0:
+            # We have to be root to do so.
+            g = tarinfo.gid
+            u = tarinfo.uid
+            if not numeric_owner:
+                try:
+                    if grp and tarinfo.gname:
+                        g = grp.getgrnam(tarinfo.gname)[2]
+                except KeyError:
+                    pass
+                try:
+                    if pwd and tarinfo.uname:
+                        u = pwd.getpwnam(tarinfo.uname)[2]
+                except KeyError:
+                    pass
+            if g is None:
+                g = -1
+            if u is None:
+                u = -1
+            try:
+                if tarinfo.issym() and hasattr(os, "lchown"):
+                    os.lchown(targetpath, u, g)
+                else:
+                    os.chown(targetpath, u, g)
+            except OSError as e:
+                raise ExtractError("could not change owner") from e
+
+    def chmod(self, tarinfo, targetpath):
+        """Set file permissions of targetpath according to tarinfo.
+        """
+        if tarinfo.mode is None:
+            return
+        try:
+            os.chmod(targetpath, tarinfo.mode)
+        except OSError as e:
+            raise ExtractError("could not change mode") from e
+
+    def utime(self, tarinfo, targetpath):
+        """Set modification time of targetpath according to tarinfo.
+        """
+        mtime = tarinfo.mtime
+        if mtime is None:
+            return
+        if not hasattr(os, 'utime'):
+            return
+        try:
+            os.utime(targetpath, (mtime, mtime))
+        except OSError as e:
+            raise ExtractError("could not change modification time") from e
+
+    #--------------------------------------------------------------------------
+    def next(self):
+        """Return the next member of the archive as a TarInfo object, when
+           TarFile is opened for reading. Return None if there is no more
+           available.
+        """
+        self._check("ra")
+        if self.firstmember is not None:
+            m = self.firstmember
+            self.firstmember = None
+            return m
+
+        # Advance the file pointer.
+        if self.offset != self.fileobj.tell():
+            if self.offset == 0:
+                return None
+            self.fileobj.seek(self.offset - 1)
+            if not self.fileobj.read(1):
+                raise ReadError("unexpected end of data")
+
+        # Read the next block.
+        tarinfo = None
+        while True:
+            try:
+                tarinfo = self.tarinfo.fromtarfile(self)
+            except EOFHeaderError as e:
+                if self.ignore_zeros:
+                    self._dbg(2, "0x%X: %s" % (self.offset, e))
+                    self.offset += BLOCKSIZE
+                    continue
+            except InvalidHeaderError as e:
+                if self.ignore_zeros:
+                    self._dbg(2, "0x%X: %s" % (self.offset, e))
+                    self.offset += BLOCKSIZE
+                    continue
+                elif self.offset == 0:
+                    raise ReadError(str(e)) from None
+            except EmptyHeaderError:
+                if self.offset == 0:
+                    raise ReadError("empty file") from None
+            except TruncatedHeaderError as e:
+                if self.offset == 0:
+                    raise ReadError(str(e)) from None
+            except SubsequentHeaderError as e:
+                raise ReadError(str(e)) from None
+            except Exception as e:
+                try:
+                    import zlib
+                    if isinstance(e, zlib.error):
+                        raise ReadError(f'zlib error: {e}') from None
+                    else:
+                        raise e
+                except ImportError:
+                    raise e
+            break
+
+        if tarinfo is not None:
+            self.members.append(tarinfo)
+        else:
+            self._loaded = True
+
+        return tarinfo
+
+    #--------------------------------------------------------------------------
+    # Little helper methods:
+
+    def _getmember(self, name, tarinfo=None, normalize=False):
+        """Find an archive member by name from bottom to top.
+           If tarinfo is given, it is used as the starting point.
+        """
+        # Ensure that all members have been loaded.
+        members = self.getmembers()
+
+        # Limit the member search list up to tarinfo.
+        skipping = False
+        if tarinfo is not None:
+            try:
+                index = members.index(tarinfo)
+            except ValueError:
+                # The given starting point might be a (modified) copy.
+                # We'll later skip members until we find an equivalent.
+                skipping = True
+            else:
+                # Happy fast path
+                members = members[:index]
+
+        if normalize:
+            name = os.path.normpath(name)
+
+        for member in reversed(members):
+            if skipping:
+                if tarinfo.offset == member.offset:
+                    skipping = False
+                continue
+            if normalize:
+                member_name = os.path.normpath(member.name)
+            else:
+                member_name = member.name
+
+            if name == member_name:
+                return member
+
+        if skipping:
+            # Starting point was not found
+            raise ValueError(tarinfo)
+
+    def _load(self):
+        """Read through the entire archive file and look for readable
+           members.
+        """
+        while self.next() is not None:
+            pass
+        self._loaded = True
+
+    def _check(self, mode=None):
+        """Check if TarFile is still open, and if the operation's mode
+           corresponds to TarFile's mode.
+        """
+        if self.closed:
+            raise OSError("%s is closed" % self.__class__.__name__)
+        if mode is not None and self.mode not in mode:
+            raise OSError("bad operation for mode %r" % self.mode)
+
+    def _find_link_target(self, tarinfo):
+        """Find the target member of a symlink or hardlink member in the
+           archive.
+        """
+        if tarinfo.issym():
+            # Always search the entire archive.
+            linkname = "/".join(filter(None, (os.path.dirname(tarinfo.name), tarinfo.linkname)))
+            limit = None
+        else:
+            # Search the archive before the link, because a hard link is
+            # just a reference to an already archived file.
+            linkname = tarinfo.linkname
+            limit = tarinfo
+
+        member = self._getmember(linkname, tarinfo=limit, normalize=True)
+        if member is None:
+            raise KeyError("linkname %r not found" % linkname)
+        return member
+
+    def __iter__(self):
+        """Provide an iterator object.
+        """
+        if self._loaded:
+            yield from self.members
+            return
+
+        # Yield items using TarFile's next() method.
+        # When all members have been read, set TarFile as _loaded.
+        index = 0
+        # Fix for SF #1100429: Under rare circumstances it can
+        # happen that getmembers() is called during iteration,
+        # which will have already exhausted the next() method.
+        if self.firstmember is not None:
+            tarinfo = self.next()
+            index += 1
+            yield tarinfo
+
+        while True:
+            if index < len(self.members):
+                tarinfo = self.members[index]
+            elif not self._loaded:
+                tarinfo = self.next()
+                if not tarinfo:
+                    self._loaded = True
+                    return
+            else:
+                return
+            index += 1
+            yield tarinfo
+
+    def _dbg(self, level, msg):
+        """Write debugging output to sys.stderr.
+        """
+        if level <= self.debug:
+            print(msg, file=sys.stderr)
+
+    def __enter__(self):
+        self._check()
+        return self
+
+    def __exit__(self, type, value, traceback):
+        if type is None:
+            self.close()
+        else:
+            # An exception occurred. We must not call close() because
+            # it would try to write end-of-archive blocks and padding.
+            if not self._extfileobj:
+                self.fileobj.close()
+            self.closed = True
+
+#--------------------
+# exported functions
+#--------------------
+
+def is_tarfile(name):
+    """Return True if name points to a tar archive that we
+       are able to handle, else return False.
+
+       'name' should be a string, file, or file-like object.
+    """
+    try:
+        if hasattr(name, "read"):
+            pos = name.tell()
+            t = open(fileobj=name)
+            name.seek(pos)
+        else:
+            t = open(name)
+        t.close()
+        return True
+    except TarError:
+        return False
+
+open = TarFile.open
+
+
+def main():
+    import argparse
+
+    description = 'A simple command-line interface for tarfile module.'
+    parser = argparse.ArgumentParser(description=description)
+    parser.add_argument('-v', '--verbose', action='store_true', default=False,
+                        help='Verbose output')
+    parser.add_argument('--filter', metavar='<filtername>',
+                        choices=_NAMED_FILTERS,
+                        help='Filter for extraction')
+
+    group = parser.add_mutually_exclusive_group(required=True)
+    group.add_argument('-l', '--list', metavar='<tarfile>',
+                       help='Show listing of a tarfile')
+    group.add_argument('-e', '--extract', nargs='+',
+                       metavar=('<tarfile>', '<output_dir>'),
+                       help='Extract tarfile into target dir')
+    group.add_argument('-c', '--create', nargs='+',
+                       metavar=('<name>', '<file>'),
+                       help='Create tarfile from sources')
+    group.add_argument('-t', '--test', metavar='<tarfile>',
+                       help='Test if a tarfile is valid')
+
+    args = parser.parse_args()
+
+    if args.filter and args.extract is None:
+        parser.exit(1, '--filter is only valid for extraction\n')
+
+    if args.test is not None:
+        src = args.test
+        if is_tarfile(src):
+            with open(src, 'r') as tar:
+                tar.getmembers()
+                print(tar.getmembers(), file=sys.stderr)
+            if args.verbose:
+                print('{!r} is a tar archive.'.format(src))
+        else:
+            parser.exit(1, '{!r} is not a tar archive.\n'.format(src))
+
+    elif args.list is not None:
+        src = args.list
+        if is_tarfile(src):
+            with TarFile.open(src, 'r:*') as tf:
+                tf.list(verbose=args.verbose)
+        else:
+            parser.exit(1, '{!r} is not a tar archive.\n'.format(src))
+
+    elif args.extract is not None:
+        if len(args.extract) == 1:
+            src = args.extract[0]
+            curdir = os.curdir
+        elif len(args.extract) == 2:
+            src, curdir = args.extract
+        else:
+            parser.exit(1, parser.format_help())
+
+        if is_tarfile(src):
+            with TarFile.open(src, 'r:*') as tf:
+                tf.extractall(path=curdir, filter=args.filter)
+            if args.verbose:
+                if curdir == '.':
+                    msg = '{!r} file is extracted.'.format(src)
+                else:
+                    msg = ('{!r} file is extracted '
+                           'into {!r} directory.').format(src, curdir)
+                print(msg)
+        else:
+            parser.exit(1, '{!r} is not a tar archive.\n'.format(src))
+
+    elif args.create is not None:
+        tar_name = args.create.pop(0)
+        _, ext = os.path.splitext(tar_name)
+        compressions = {
+            # gz
+            '.gz': 'gz',
+            '.tgz': 'gz',
+            # xz
+            '.xz': 'xz',
+            '.txz': 'xz',
+            # bz2
+            '.bz2': 'bz2',
+            '.tbz': 'bz2',
+            '.tbz2': 'bz2',
+            '.tb2': 'bz2',
+        }
+        tar_mode = 'w:' + compressions[ext] if ext in compressions else 'w'
+        tar_files = args.create
+
+        with TarFile.open(tar_name, tar_mode) as tf:
+            for file_name in tar_files:
+                tf.add(file_name)
+
+        if args.verbose:
+            print('{!r} file created.'.format(tar_name))
+
+if __name__ == '__main__':
+    main()
diff --git a/lib/backports/tarfile/__main__.py b/lib/backports/tarfile/__main__.py
new file mode 100644
index 00000000..daf55090
--- /dev/null
+++ b/lib/backports/tarfile/__main__.py
@@ -0,0 +1,5 @@
+from . import main
+
+
+if __name__ == '__main__':
+    main()
diff --git a/lib/inflect/compat/__init__.py b/lib/backports/tarfile/compat/__init__.py
similarity index 100%
rename from lib/inflect/compat/__init__.py
rename to lib/backports/tarfile/compat/__init__.py
diff --git a/lib/backports/tarfile/compat/py38.py b/lib/backports/tarfile/compat/py38.py
new file mode 100644
index 00000000..20fbbfc1
--- /dev/null
+++ b/lib/backports/tarfile/compat/py38.py
@@ -0,0 +1,24 @@
+import sys
+
+
+if sys.version_info < (3, 9):
+
+    def removesuffix(self, suffix):
+        # suffix='' should not call self[:-0].
+        if suffix and self.endswith(suffix):
+            return self[: -len(suffix)]
+        else:
+            return self[:]
+
+    def removeprefix(self, prefix):
+        if self.startswith(prefix):
+            return self[len(prefix) :]
+        else:
+            return self[:]
+else:
+
+    def removesuffix(self, suffix):
+        return self.removesuffix(suffix)
+
+    def removeprefix(self, prefix):
+        return self.removeprefix(prefix)
diff --git a/lib/future/__init__.py b/lib/future/__init__.py
index b609299a..b097fd81 100644
--- a/lib/future/__init__.py
+++ b/lib/future/__init__.py
@@ -52,7 +52,7 @@ Automatic conversion
 --------------------
 
 An included script called `futurize
-<http://python-future.org/automatic_conversion.html>`_ aids in converting
+<https://python-future.org/automatic_conversion.html>`_ aids in converting
 code (from either Python 2 or Python 3) to code compatible with both
 platforms. It is similar to ``python-modernize`` but goes further in
 providing Python 3 compatibility through the use of the backported types
@@ -62,21 +62,20 @@ and builtin functions in ``future``.
 Documentation
 -------------
 
-See: http://python-future.org
+See: https://python-future.org
 
 
 Credits
 -------
 
 :Author:  Ed Schofield, Jordan M. Adler, et al
-:Sponsor: Python Charmers Pty Ltd, Australia, and Python Charmers Pte
-          Ltd, Singapore. http://pythoncharmers.com
-:Others:  See docs/credits.rst or http://python-future.org/credits.html
+:Sponsor: Python Charmers: https://pythoncharmers.com
+:Others:  See docs/credits.rst or https://python-future.org/credits.html
 
 
 Licensing
 ---------
-Copyright 2013-2019 Python Charmers Pty Ltd, Australia.
+Copyright 2013-2024 Python Charmers, Australia.
 The software is distributed under an MIT licence. See LICENSE.txt.
 
 """
@@ -84,10 +83,10 @@ The software is distributed under an MIT licence. See LICENSE.txt.
 __title__ = 'future'
 __author__ = 'Ed Schofield'
 __license__ = 'MIT'
-__copyright__ = 'Copyright 2013-2019 Python Charmers Pty Ltd'
-__ver_major__ = 0
-__ver_minor__ = 18
-__ver_patch__ = 3
+__copyright__ = 'Copyright 2013-2024 Python Charmers (https://pythoncharmers.com)'
+__ver_major__ = 1
+__ver_minor__ = 0
+__ver_patch__ = 0
 __ver_sub__ = ''
 __version__ = "%d.%d.%d%s" % (__ver_major__, __ver_minor__,
                               __ver_patch__, __ver_sub__)
diff --git a/lib/future/backports/datetime.py b/lib/future/backports/datetime.py
index 3261014e..8cd62ddf 100644
--- a/lib/future/backports/datetime.py
+++ b/lib/future/backports/datetime.py
@@ -689,7 +689,7 @@ class date(object):
 
     @classmethod
     def fromordinal(cls, n):
-        """Contruct a date from a proleptic Gregorian ordinal.
+        """Construct a date from a proleptic Gregorian ordinal.
 
         January 1 of year 1 is day 1.  Only the year, month and day are
         non-zero in the result.
diff --git a/lib/future/backports/email/_header_value_parser.py b/lib/future/backports/email/_header_value_parser.py
index 43957edc..59b1b318 100644
--- a/lib/future/backports/email/_header_value_parser.py
+++ b/lib/future/backports/email/_header_value_parser.py
@@ -2867,7 +2867,7 @@ def parse_content_type_header(value):
         _find_mime_parameters(ctype, value)
         return ctype
     ctype.append(token)
-    # XXX: If we really want to follow the formal grammer we should make
+    # XXX: If we really want to follow the formal grammar we should make
     # mantype and subtype specialized TokenLists here.  Probably not worth it.
     if not value or value[0] != '/':
         ctype.defects.append(errors.InvalidHeaderDefect(
diff --git a/lib/future/backports/email/parser.py b/lib/future/backports/email/parser.py
index df1c6e28..79f0e5a3 100644
--- a/lib/future/backports/email/parser.py
+++ b/lib/future/backports/email/parser.py
@@ -26,7 +26,7 @@ class Parser(object):
         textual representation of the message.
 
         The string must be formatted as a block of RFC 2822 headers and header
-        continuation lines, optionally preceeded by a `Unix-from' header.  The
+        continuation lines, optionally preceded by a `Unix-from' header.  The
         header block is terminated either by the end of the string or by a
         blank line.
 
@@ -92,7 +92,7 @@ class BytesParser(object):
         textual representation of the message.
 
         The input must be formatted as a block of RFC 2822 headers and header
-        continuation lines, optionally preceeded by a `Unix-from' header.  The
+        continuation lines, optionally preceded by a `Unix-from' header.  The
         header block is terminated either by the end of the input or by a
         blank line.
 
diff --git a/lib/future/backports/http/cookiejar.py b/lib/future/backports/http/cookiejar.py
index 0ad80a02..a39242c0 100644
--- a/lib/future/backports/http/cookiejar.py
+++ b/lib/future/backports/http/cookiejar.py
@@ -1851,7 +1851,7 @@ def lwp_cookie_str(cookie):
 class LWPCookieJar(FileCookieJar):
     """
     The LWPCookieJar saves a sequence of "Set-Cookie3" lines.
-    "Set-Cookie3" is the format used by the libwww-perl libary, not known
+    "Set-Cookie3" is the format used by the libwww-perl library, not known
     to be compatible with any browser, but which is easy to read and
     doesn't lose information about RFC 2965 cookies.
 
diff --git a/lib/future/backports/test/support.py b/lib/future/backports/test/support.py
index 1999e208..6639372b 100644
--- a/lib/future/backports/test/support.py
+++ b/lib/future/backports/test/support.py
@@ -28,7 +28,6 @@ import importlib
 # import collections.abc    # not present on Py2.7
 import re
 import subprocess
-import imp
 import time
 try:
     import sysconfig
@@ -341,37 +340,6 @@ def rmtree(path):
         if error.errno != errno.ENOENT:
             raise
 
-def make_legacy_pyc(source):
-    """Move a PEP 3147 pyc/pyo file to its legacy pyc/pyo location.
-
-    The choice of .pyc or .pyo extension is done based on the __debug__ flag
-    value.
-
-    :param source: The file system path to the source file.  The source file
-        does not need to exist, however the PEP 3147 pyc file must exist.
-    :return: The file system path to the legacy pyc file.
-    """
-    pyc_file = imp.cache_from_source(source)
-    up_one = os.path.dirname(os.path.abspath(source))
-    legacy_pyc = os.path.join(up_one, source + ('c' if __debug__ else 'o'))
-    os.rename(pyc_file, legacy_pyc)
-    return legacy_pyc
-
-def forget(modname):
-    """'Forget' a module was ever imported.
-
-    This removes the module from sys.modules and deletes any PEP 3147 or
-    legacy .pyc and .pyo files.
-    """
-    unload(modname)
-    for dirname in sys.path:
-        source = os.path.join(dirname, modname + '.py')
-        # It doesn't matter if they exist or not, unlink all possible
-        # combinations of PEP 3147 and legacy pyc and pyo files.
-        unlink(source + 'c')
-        unlink(source + 'o')
-        unlink(imp.cache_from_source(source, debug_override=True))
-        unlink(imp.cache_from_source(source, debug_override=False))
 
 # On some platforms, should not run gui test even if it is allowed
 # in `use_resources'.
diff --git a/lib/future/backports/xmlrpc/client.py b/lib/future/backports/xmlrpc/client.py
index b78e5bad..0838f61a 100644
--- a/lib/future/backports/xmlrpc/client.py
+++ b/lib/future/backports/xmlrpc/client.py
@@ -134,10 +134,11 @@ from __future__ import (absolute_import, division, print_function,
 from future.builtins import bytes, dict, int, range, str
 
 import base64
-# Py2.7 compatibility hack
-base64.encodebytes = base64.encodestring
-base64.decodebytes = base64.decodestring
 import sys
+if sys.version_info < (3, 9):
+    # Py2.7 compatibility hack
+    base64.encodebytes = base64.encodestring
+    base64.decodebytes = base64.decodestring
 import time
 from datetime import datetime
 from future.backports.http import client as http_client
@@ -1251,7 +1252,7 @@ class Transport(object):
     # Send HTTP request.
     #
     # @param host Host descriptor (URL or (URL, x509 info) tuple).
-    # @param handler Targer RPC handler (a path relative to host)
+    # @param handler Target RPC handler (a path relative to host)
     # @param request_body The XML-RPC request body
     # @param debug Enable debugging if debug is true.
     # @return An HTTPConnection.
diff --git a/lib/future/builtins/__init__.py b/lib/future/builtins/__init__.py
index 8bc1649d..1734cd45 100644
--- a/lib/future/builtins/__init__.py
+++ b/lib/future/builtins/__init__.py
@@ -2,7 +2,7 @@
 A module that brings in equivalents of the new and modified Python 3
 builtins into Py2. Has no effect on Py3.
 
-See the docs `here <http://python-future.org/what-else.html>`_
+See the docs `here <https://python-future.org/what-else.html>`_
 (``docs/what-else.rst``) for more information.
 
 """
diff --git a/lib/future/moves/_dummy_thread.py b/lib/future/moves/_dummy_thread.py
index 688d249b..6633f42e 100644
--- a/lib/future/moves/_dummy_thread.py
+++ b/lib/future/moves/_dummy_thread.py
@@ -1,8 +1,13 @@
 from __future__ import absolute_import
-from future.utils import PY3
+from future.utils import PY3, PY39_PLUS
 
-if PY3:
-    from _dummy_thread import *
+
+if PY39_PLUS:
+    # _dummy_thread and dummy_threading modules were both deprecated in
+    # Python 3.7 and removed in Python 3.9
+    from _thread import *
+elif PY3:
+        from _dummy_thread import *
 else:
     __future_module__ = True
     from dummy_thread import *
diff --git a/lib/future/moves/multiprocessing.py b/lib/future/moves/multiprocessing.py
new file mode 100644
index 00000000..a871b676
--- /dev/null
+++ b/lib/future/moves/multiprocessing.py
@@ -0,0 +1,7 @@
+from __future__ import absolute_import
+from future.utils import PY3
+
+from multiprocessing import *
+if not PY3:
+    __future_module__ = True
+    from multiprocessing.queues import SimpleQueue
diff --git a/lib/future/moves/test/support.py b/lib/future/moves/test/support.py
index e9aa0f48..f70c9d7d 100644
--- a/lib/future/moves/test/support.py
+++ b/lib/future/moves/test/support.py
@@ -1,9 +1,18 @@
 from __future__ import absolute_import
+
+import sys
+
 from future.standard_library import suspend_hooks
 from future.utils import PY3
 
 if PY3:
     from test.support import *
+    if sys.version_info[:2] >= (3, 10):
+        from test.support.os_helper import (
+            EnvironmentVarGuard,
+            TESTFN,
+        )
+        from test.support.warnings_helper import check_warnings
 else:
     __future_module__ = True
     with suspend_hooks():
diff --git a/lib/future/standard_library/__init__.py b/lib/future/standard_library/__init__.py
index cff02f95..d467aaf4 100644
--- a/lib/future/standard_library/__init__.py
+++ b/lib/future/standard_library/__init__.py
@@ -17,7 +17,7 @@ And then these normal Py3 imports work on both Py3 and Py2::
     import socketserver
     import winreg    # on Windows only
     import test.support
-    import html, html.parser, html.entites
+    import html, html.parser, html.entities
     import http, http.client, http.server
     import http.cookies, http.cookiejar
     import urllib.parse, urllib.request, urllib.response, urllib.error, urllib.robotparser
@@ -33,6 +33,7 @@ And then these normal Py3 imports work on both Py3 and Py2::
     from collections import OrderedDict, Counter, ChainMap     # even on Py2.6
     from subprocess import getoutput, getstatusoutput
     from subprocess import check_output              # even on Py2.6
+    from multiprocessing import SimpleQueue
 
 (The renamed modules and functions are still available under their old
 names on Python 2.)
@@ -62,9 +63,12 @@ from __future__ import absolute_import, division, print_function
 
 import sys
 import logging
-import imp
+# imp was deprecated in python 3.6
+if sys.version_info >= (3, 6):
+    import importlib as imp
+else:
+    import imp
 import contextlib
-import types
 import copy
 import os
 
@@ -108,6 +112,7 @@ RENAMES = {
            'future.moves.socketserver': 'socketserver',
            'ConfigParser': 'configparser',
            'repr': 'reprlib',
+           'multiprocessing.queues': 'multiprocessing',
            # 'FileDialog': 'tkinter.filedialog',
            # 'tkFileDialog': 'tkinter.filedialog',
            # 'SimpleDialog': 'tkinter.simpledialog',
@@ -125,7 +130,7 @@ RENAMES = {
            # 'Tkinter': 'tkinter',
            '_winreg': 'winreg',
            'thread': '_thread',
-           'dummy_thread': '_dummy_thread',
+           'dummy_thread': '_dummy_thread' if sys.version_info < (3, 9) else '_thread',
            # 'anydbm': 'dbm',   # causes infinite import loop
            # 'whichdb': 'dbm',  # causes infinite import loop
            # anydbm and whichdb are handled by fix_imports2
@@ -184,6 +189,7 @@ MOVES = [('collections', 'UserList', 'UserList', 'UserList'),
          ('itertools', 'filterfalse','itertools', 'ifilterfalse'),
          ('itertools', 'zip_longest','itertools', 'izip_longest'),
          ('sys', 'intern','__builtin__', 'intern'),
+         ('multiprocessing', 'SimpleQueue', 'multiprocessing.queues', 'SimpleQueue'),
          # The re module has no ASCII flag in Py2, but this is the default.
          # Set re.ASCII to a zero constant. stat.ST_MODE just happens to be one
          # (and it exists on Py2.6+).
diff --git a/lib/future/types/newint.py b/lib/future/types/newint.py
index 04a411e9..ebc5715e 100644
--- a/lib/future/types/newint.py
+++ b/lib/future/types/newint.py
@@ -223,9 +223,11 @@ class newint(with_metaclass(BaseNewInt, long)):
 
     def __rpow__(self, other):
         value = super(newint, self).__rpow__(other)
-        if value is NotImplemented:
+        if isint(value):
+            return newint(value)
+        elif value is NotImplemented:
             return other ** long(self)
-        return newint(value)
+        return value
 
     def __lshift__(self, other):
         if not isint(other):
@@ -318,7 +320,7 @@ class newint(with_metaclass(BaseNewInt, long)):
             bits = length * 8
             num = (2**bits) + self
             if num <= 0:
-                raise OverflowError("int too smal to convert")
+                raise OverflowError("int too small to convert")
         else:
             if self < 0:
                 raise OverflowError("can't convert negative int to unsigned")
diff --git a/lib/future/types/newrange.py b/lib/future/types/newrange.py
index 6d4ebe2f..dc5eb802 100644
--- a/lib/future/types/newrange.py
+++ b/lib/future/types/newrange.py
@@ -105,7 +105,7 @@ class newrange(Sequence):
         raise ValueError('%r is not in range' % value)
 
     def count(self, value):
-        """Return the number of ocurrences of integer `value`
+        """Return the number of occurrences of integer `value`
         in the sequence this range represents."""
         # a value can occur exactly zero or one times
         return int(value in self)
diff --git a/lib/inflect/__init__.py b/lib/inflect/__init__.py
index b638c6b8..d0eded16 100644
--- a/lib/inflect/__init__.py
+++ b/lib/inflect/__init__.py
@@ -3,6 +3,8 @@ inflect: english language inflection
  - correctly generate plurals, ordinals, indefinite articles
  - convert numbers to words
 
+Copyright (C) 2010 Paul Dyson
+
 Based upon the Perl module
 `Lingua::EN::Inflect <https://metacpan.org/pod/Lingua::EN::Inflect>`_.
 
@@ -50,34 +52,33 @@ Exceptions:
 
 """
 
+from __future__ import annotations
+
 import ast
-import re
-import functools
 import collections
 import contextlib
+import functools
+import itertools
+import re
+from numbers import Number
 from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
     Dict,
-    Union,
-    Optional,
     Iterable,
     List,
     Match,
-    Tuple,
-    Callable,
+    Optional,
     Sequence,
+    Tuple,
+    Union,
     cast,
-    Any,
 )
-from typing_extensions import Literal
-from numbers import Number
 
-
-from pydantic import Field
-from typing_extensions import Annotated
-
-
-from .compat.pydantic1 import validate_call
-from .compat.pydantic import same_method
+from more_itertools import windowed_complete
+from typeguard import typechecked
+from typing_extensions import Annotated, Literal
 
 
 class UnknownClassicalModeError(Exception):
@@ -258,9 +259,9 @@ si_sb_irregular_compound = {v: k for (k, v) in pl_sb_irregular_compound.items()}
 for k in list(si_sb_irregular_compound):
     if "|" in k:
         k1, k2 = k.split("|")
-        si_sb_irregular_compound[k1] = si_sb_irregular_compound[
-            k2
-        ] = si_sb_irregular_compound[k]
+        si_sb_irregular_compound[k1] = si_sb_irregular_compound[k2] = (
+            si_sb_irregular_compound[k]
+        )
         del si_sb_irregular_compound[k]
 
 # si_sb_irregular_keys = enclose('|'.join(si_sb_irregular.keys()))
@@ -1597,7 +1598,7 @@ pl_prep_bysize = bysize(pl_prep_list_da)
 
 pl_prep = enclose("|".join(pl_prep_list_da))
 
-pl_sb_prep_dual_compound = fr"(.*?)((?:-|\s+)(?:{pl_prep})(?:-|\s+))a(?:-|\s+)(.*)"
+pl_sb_prep_dual_compound = rf"(.*?)((?:-|\s+)(?:{pl_prep})(?:-|\s+))a(?:-|\s+)(.*)"
 
 
 singular_pronoun_genders = {
@@ -1764,7 +1765,7 @@ plverb_ambiguous_pres = {
 }
 
 plverb_ambiguous_pres_keys = re.compile(
-    fr"^({enclose('|'.join(plverb_ambiguous_pres))})((\s.*)?)$", re.IGNORECASE
+    rf"^({enclose('|'.join(plverb_ambiguous_pres))})((\s.*)?)$", re.IGNORECASE
 )
 
 
@@ -1804,7 +1805,7 @@ pl_count_one = ("1", "a", "an", "one", "each", "every", "this", "that")
 pl_adj_special = {"a": "some", "an": "some", "this": "these", "that": "those"}
 
 pl_adj_special_keys = re.compile(
-    fr"^({enclose('|'.join(pl_adj_special))})$", re.IGNORECASE
+    rf"^({enclose('|'.join(pl_adj_special))})$", re.IGNORECASE
 )
 
 pl_adj_poss = {
@@ -1816,7 +1817,7 @@ pl_adj_poss = {
     "their": "their",
 }
 
-pl_adj_poss_keys = re.compile(fr"^({enclose('|'.join(pl_adj_poss))})$", re.IGNORECASE)
+pl_adj_poss_keys = re.compile(rf"^({enclose('|'.join(pl_adj_poss))})$", re.IGNORECASE)
 
 
 # 2. INDEFINITE ARTICLES
@@ -1883,7 +1884,7 @@ ordinal = dict(
     twelve="twelfth",
 )
 
-ordinal_suff = re.compile(fr"({'|'.join(ordinal)})\Z")
+ordinal_suff = re.compile(rf"({'|'.join(ordinal)})\Z")
 
 
 # NUMBERS
@@ -1948,13 +1949,13 @@ DOLLAR_DIGITS = re.compile(r"\$(\d+)")
 FUNCTION_CALL = re.compile(r"((\w+)\([^)]*\)*)", re.IGNORECASE)
 PARTITION_WORD = re.compile(r"\A(\s*)(.+?)(\s*)\Z")
 PL_SB_POSTFIX_ADJ_STEMS_RE = re.compile(
-    fr"^(?:{pl_sb_postfix_adj_stems})$", re.IGNORECASE
+    rf"^(?:{pl_sb_postfix_adj_stems})$", re.IGNORECASE
 )
 PL_SB_PREP_DUAL_COMPOUND_RE = re.compile(
-    fr"^(?:{pl_sb_prep_dual_compound})$", re.IGNORECASE
+    rf"^(?:{pl_sb_prep_dual_compound})$", re.IGNORECASE
 )
 DENOMINATOR = re.compile(r"(?P<denominator>.+)( (per|a) .+)")
-PLVERB_SPECIAL_S_RE = re.compile(fr"^({plverb_special_s})$")
+PLVERB_SPECIAL_S_RE = re.compile(rf"^({plverb_special_s})$")
 WHITESPACE = re.compile(r"\s")
 ENDS_WITH_S = re.compile(r"^(.*[^s])s$", re.IGNORECASE)
 ENDS_WITH_APOSTROPHE_S = re.compile(r"^(.*)'s?$")
@@ -2020,10 +2021,25 @@ class Words(str):
         self.last = self.split_[-1]
 
 
-Word = Annotated[str, Field(min_length=1)]
 Falsish = Any  # ideally, falsish would only validate on bool(value) is False
 
 
+_STATIC_TYPE_CHECKING = TYPE_CHECKING
+# ^-- Workaround for typeguard AST manipulation:
+#     https://github.com/agronholm/typeguard/issues/353#issuecomment-1556306554
+
+if _STATIC_TYPE_CHECKING:  # pragma: no cover
+    Word = Annotated[str, "String with at least 1 character"]
+else:
+
+    class _WordMeta(type):  # Too dynamic to be supported by mypy...
+        def __instancecheck__(self, instance: Any) -> bool:
+            return isinstance(instance, str) and len(instance) >= 1
+
+    class Word(metaclass=_WordMeta):  # type: ignore[no-redef]
+        """String with at least 1 character"""
+
+
 class engine:
     def __init__(self) -> None:
         self.classical_dict = def_classical.copy()
@@ -2045,7 +2061,7 @@ class engine:
     def _number_args(self, val):
         self.__number_args = val
 
-    @validate_call
+    @typechecked
     def defnoun(self, singular: Optional[Word], plural: Optional[Word]) -> int:
         """
         Set the noun plural of singular to plural.
@@ -2057,7 +2073,7 @@ class engine:
         self.si_sb_user_defined.extend((plural, singular))
         return 1
 
-    @validate_call
+    @typechecked
     def defverb(
         self,
         s1: Optional[Word],
@@ -2082,7 +2098,7 @@ class engine:
         self.pl_v_user_defined.extend((s1, p1, s2, p2, s3, p3))
         return 1
 
-    @validate_call
+    @typechecked
     def defadj(self, singular: Optional[Word], plural: Optional[Word]) -> int:
         """
         Set the adjective plural of singular to plural.
@@ -2093,7 +2109,7 @@ class engine:
         self.pl_adj_user_defined.extend((singular, plural))
         return 1
 
-    @validate_call
+    @typechecked
     def defa(self, pattern: Optional[Word]) -> int:
         """
         Define the indefinite article as 'a' for words matching pattern.
@@ -2103,7 +2119,7 @@ class engine:
         self.A_a_user_defined.extend((pattern, "a"))
         return 1
 
-    @validate_call
+    @typechecked
     def defan(self, pattern: Optional[Word]) -> int:
         """
         Define the indefinite article as 'an' for words matching pattern.
@@ -2121,8 +2137,8 @@ class engine:
             return
         try:
             re.match(pattern, "")
-        except re.error:
-            raise BadUserDefinedPatternError(pattern)
+        except re.error as err:
+            raise BadUserDefinedPatternError(pattern) from err
 
     def checkpatplural(self, pattern: Optional[Word]) -> None:
         """
@@ -2130,10 +2146,10 @@ class engine:
         """
         return
 
-    @validate_call
+    @typechecked
     def ud_match(self, word: Word, wordlist: Sequence[Optional[Word]]) -> Optional[str]:
         for i in range(len(wordlist) - 2, -2, -2):  # backwards through even elements
-            mo = re.search(fr"^{wordlist[i]}$", word, re.IGNORECASE)
+            mo = re.search(rf"^{wordlist[i]}$", word, re.IGNORECASE)
             if mo:
                 if wordlist[i + 1] is None:
                     return None
@@ -2191,8 +2207,8 @@ class engine:
         if count is not None:
             try:
                 self.persistent_count = int(count)
-            except ValueError:
-                raise BadNumValueError
+            except ValueError as err:
+                raise BadNumValueError from err
             if (show is None) or show:
                 return str(count)
         else:
@@ -2270,7 +2286,7 @@ class engine:
 
     # 0. PERFORM GENERAL INFLECTIONS IN A STRING
 
-    @validate_call
+    @typechecked
     def inflect(self, text: Word) -> str:
         """
         Perform inflections in a string.
@@ -2347,7 +2363,7 @@ class engine:
         else:
             return "", "", ""
 
-    @validate_call
+    @typechecked
     def plural(self, text: Word, count: Optional[Union[str, int, Any]] = None) -> str:
         """
         Return the plural of text.
@@ -2371,7 +2387,7 @@ class engine:
         )
         return f"{pre}{plural}{post}"
 
-    @validate_call
+    @typechecked
     def plural_noun(
         self, text: Word, count: Optional[Union[str, int, Any]] = None
     ) -> str:
@@ -2392,7 +2408,7 @@ class engine:
         plural = self.postprocess(word, self._plnoun(word, count))
         return f"{pre}{plural}{post}"
 
-    @validate_call
+    @typechecked
     def plural_verb(
         self, text: Word, count: Optional[Union[str, int, Any]] = None
     ) -> str:
@@ -2416,7 +2432,7 @@ class engine:
         )
         return f"{pre}{plural}{post}"
 
-    @validate_call
+    @typechecked
     def plural_adj(
         self, text: Word, count: Optional[Union[str, int, Any]] = None
     ) -> str:
@@ -2437,7 +2453,7 @@ class engine:
         plural = self.postprocess(word, self._pl_special_adjective(word, count) or word)
         return f"{pre}{plural}{post}"
 
-    @validate_call
+    @typechecked
     def compare(self, word1: Word, word2: Word) -> Union[str, bool]:
         """
         compare word1 and word2 for equality regardless of plurality
@@ -2460,15 +2476,13 @@ class engine:
         >>> compare('egg', '')
         Traceback (most recent call last):
         ...
-        pydantic...ValidationError: ...
-        ...
-          ...at least 1 characters...
+        typeguard.TypeCheckError:...is not an instance of inflect.Word
         """
         norms = self.plural_noun, self.plural_verb, self.plural_adj
         results = (self._plequal(word1, word2, norm) for norm in norms)
         return next(filter(None, results), False)
 
-    @validate_call
+    @typechecked
     def compare_nouns(self, word1: Word, word2: Word) -> Union[str, bool]:
         """
         compare word1 and word2 for equality regardless of plurality
@@ -2484,7 +2498,7 @@ class engine:
         """
         return self._plequal(word1, word2, self.plural_noun)
 
-    @validate_call
+    @typechecked
     def compare_verbs(self, word1: Word, word2: Word) -> Union[str, bool]:
         """
         compare word1 and word2 for equality regardless of plurality
@@ -2500,7 +2514,7 @@ class engine:
         """
         return self._plequal(word1, word2, self.plural_verb)
 
-    @validate_call
+    @typechecked
     def compare_adjs(self, word1: Word, word2: Word) -> Union[str, bool]:
         """
         compare word1 and word2 for equality regardless of plurality
@@ -2516,7 +2530,7 @@ class engine:
         """
         return self._plequal(word1, word2, self.plural_adj)
 
-    @validate_call
+    @typechecked
     def singular_noun(
         self,
         text: Word,
@@ -2574,18 +2588,18 @@ class engine:
             return "s:p"
         self.classical_dict = classval.copy()
 
-        if same_method(pl, self.plural) or same_method(pl, self.plural_noun):
+        if pl == self.plural or pl == self.plural_noun:
             if self._pl_check_plurals_N(word1, word2):
                 return "p:p"
             if self._pl_check_plurals_N(word2, word1):
                 return "p:p"
-        if same_method(pl, self.plural) or same_method(pl, self.plural_adj):
+        if pl == self.plural or pl == self.plural_adj:
             if self._pl_check_plurals_adj(word1, word2):
                 return "p:p"
         return False
 
     def _pl_reg_plurals(self, pair: str, stems: str, end1: str, end2: str) -> bool:
-        pattern = fr"({stems})({end1}\|\1{end2}|{end2}\|\1{end1})"
+        pattern = rf"({stems})({end1}\|\1{end2}|{end2}\|\1{end1})"
         return bool(re.search(pattern, pair))
 
     def _pl_check_plurals_N(self, word1: str, word2: str) -> bool:
@@ -2679,6 +2693,8 @@ class engine:
         word = Words(word)
 
         if word.last.lower() in pl_sb_uninflected_complete:
+            if len(word.split_) >= 3:
+                return self._handle_long_compounds(word, count=2) or word
             return word
 
         if word in pl_sb_uninflected_caps:
@@ -2707,13 +2723,9 @@ class engine:
                 )
 
         if len(word.split_) >= 3:
-            for numword in range(1, len(word.split_) - 1):
-                if word.split_[numword] in pl_prep_list_da:
-                    return " ".join(
-                        word.split_[: numword - 1]
-                        + [self._plnoun(word.split_[numword - 1], 2)]
-                        + word.split_[numword:]
-                    )
+            handled_words = self._handle_long_compounds(word, count=2)
+            if handled_words is not None:
+                return handled_words
 
         # only pluralize denominators in units
         mo = DENOMINATOR.search(word.lowered)
@@ -2972,6 +2984,30 @@ class engine:
             parts[: pivot - 1] + [sep.join([transformed, parts[pivot], ''])]
         ) + " ".join(parts[(pivot + 1) :])
 
+    def _handle_long_compounds(self, word: Words, count: int) -> Union[str, None]:
+        """
+        Handles the plural and singular for compound `Words` that
+        have three or more words, based on the given count.
+
+        >>> engine()._handle_long_compounds(Words("pair of scissors"), 2)
+        'pairs of scissors'
+        >>> engine()._handle_long_compounds(Words("men beyond hills"), 1)
+        'man beyond hills'
+        """
+        inflection = self._sinoun if count == 1 else self._plnoun
+        solutions = (  # type: ignore
+            " ".join(
+                itertools.chain(
+                    leader,
+                    [inflection(cand, count), prep],  # type: ignore
+                    trailer,
+                )
+            )
+            for leader, (cand, prep), trailer in windowed_complete(word.split_, 2)
+            if prep in pl_prep_list_da  # type: ignore
+        )
+        return next(solutions, None)
+
     @staticmethod
     def _find_pivot(words, candidates):
         pivots = (
@@ -2980,7 +3016,7 @@ class engine:
         try:
             return next(pivots)
         except StopIteration:
-            raise ValueError("No pivot found")
+            raise ValueError("No pivot found") from None
 
     def _pl_special_verb(  # noqa: C901
         self, word: str, count: Optional[Union[str, int]] = None
@@ -3145,8 +3181,8 @@ class engine:
                 gender = self.thegender
             elif gender not in singular_pronoun_genders:
                 raise BadGenderError
-        except (TypeError, IndexError):
-            raise BadGenderError
+        except (TypeError, IndexError) as err:
+            raise BadGenderError from err
 
         # HANDLE USER-DEFINED NOUNS
 
@@ -3165,6 +3201,8 @@ class engine:
         words = Words(word)
 
         if words.last.lower() in pl_sb_uninflected_complete:
+            if len(words.split_) >= 3:
+                return self._handle_long_compounds(words, count=1) or word
             return word
 
         if word in pl_sb_uninflected_caps:
@@ -3450,7 +3488,7 @@ class engine:
 
     # ADJECTIVES
 
-    @validate_call
+    @typechecked
     def a(self, text: Word, count: Optional[Union[int, str, Any]] = 1) -> str:
         """
         Return the appropriate indefinite article followed by text.
@@ -3531,7 +3569,7 @@ class engine:
 
     # 2. TRANSLATE ZERO-QUANTIFIED $word TO "no plural($word)"
 
-    @validate_call
+    @typechecked
     def no(self, text: Word, count: Optional[Union[int, str]] = None) -> str:
         """
         If count is 0, no, zero or nil, return 'no' followed by the plural
@@ -3569,7 +3607,7 @@ class engine:
 
     # PARTICIPLES
 
-    @validate_call
+    @typechecked
     def present_participle(self, word: Word) -> str:
         """
         Return the present participle for word.
@@ -3588,7 +3626,7 @@ class engine:
 
     # NUMERICAL INFLECTIONS
 
-    @validate_call(config=dict(arbitrary_types_allowed=True))
+    @typechecked
     def ordinal(self, num: Union[Number, Word]) -> str:
         """
         Return the ordinal of num.
@@ -3619,16 +3657,7 @@ class engine:
                 post = nth[n % 10]
             return f"{num}{post}"
         else:
-            # Mad props to Damian Conway (?) whose ordinal()
-            # algorithm is type-bendy enough to foil MyPy
-            str_num: str = num  # type: ignore[assignment]
-            mo = ordinal_suff.search(str_num)
-            if mo:
-                post = ordinal[mo.group(1)]
-                rval = ordinal_suff.sub(post, str_num)
-            else:
-                rval = f"{str_num}th"
-            return rval
+            return self._sub_ord(num)
 
     def millfn(self, ind: int = 0) -> str:
         if ind > len(mill) - 1:
@@ -3747,7 +3776,36 @@ class engine:
             num = ONE_DIGIT_WORD.sub(self.unitsub, num, 1)
         return num
 
-    @validate_call(config=dict(arbitrary_types_allowed=True))  # noqa: C901
+    @staticmethod
+    def _sub_ord(val):
+        new = ordinal_suff.sub(lambda match: ordinal[match.group(1)], val)
+        return new + "th" * (new == val)
+
+    @classmethod
+    def _chunk_num(cls, num, decimal, group):
+        if decimal:
+            max_split = -1 if group != 0 else 1
+            chunks = num.split(".", max_split)
+        else:
+            chunks = [num]
+        return cls._remove_last_blank(chunks)
+
+    @staticmethod
+    def _remove_last_blank(chunks):
+        """
+        Remove the last item from chunks if it's a blank string.
+
+        Return the resultant chunks and whether the last item was removed.
+        """
+        removed = chunks[-1] == ""
+        result = chunks[:-1] if removed else chunks
+        return result, removed
+
+    @staticmethod
+    def _get_sign(num):
+        return {'+': 'plus', '-': 'minus'}.get(num.lstrip()[0], '')
+
+    @typechecked
     def number_to_words(  # noqa: C901
         self,
         num: Union[Number, Word],
@@ -3794,13 +3852,8 @@ class engine:
 
         if group < 0 or group > 3:
             raise BadChunkingOptionError
-        nowhite = num.lstrip()
-        if nowhite[0] == "+":
-            sign = "plus"
-        elif nowhite[0] == "-":
-            sign = "minus"
-        else:
-            sign = ""
+
+        sign = self._get_sign(num)
 
         if num in nth_suff:
             num = zero
@@ -3808,34 +3861,21 @@ class engine:
         myord = num[-2:] in nth_suff
         if myord:
             num = num[:-2]
-        finalpoint = False
-        if decimal:
-            if group != 0:
-                chunks = num.split(".")
-            else:
-                chunks = num.split(".", 1)
-            if chunks[-1] == "":  # remove blank string if nothing after decimal
-                chunks = chunks[:-1]
-                finalpoint = True  # add 'point' to end of output
-        else:
-            chunks = [num]
 
-        first: Union[int, str, bool] = 1
-        loopstart = 0
+        chunks, finalpoint = self._chunk_num(num, decimal, group)
 
-        if chunks[0] == "":
-            first = 0
-            if len(chunks) > 1:
-                loopstart = 1
+        loopstart = chunks[0] == ""
+        first: bool | None = not loopstart
+
+        def _handle_chunk(chunk):
+            nonlocal first
 
-        for i in range(loopstart, len(chunks)):
-            chunk = chunks[i]
             # remove all non numeric \D
             chunk = NON_DIGIT.sub("", chunk)
             if chunk == "":
                 chunk = "0"
 
-            if group == 0 and (first == 0 or first == ""):
+            if group == 0 and not first:
                 chunk = self.enword(chunk, 1)
             else:
                 chunk = self.enword(chunk, group)
@@ -3850,20 +3890,17 @@ class engine:
             # chunk = re.sub(r"(\A\s|\s\Z)", self.blankfn, chunk)
             chunk = chunk.strip()
             if first:
-                first = ""
-            chunks[i] = chunk
+                first = None
+            return chunk
+
+        chunks[loopstart:] = map(_handle_chunk, chunks[loopstart:])
 
         numchunks = []
         if first != 0:
             numchunks = chunks[0].split(f"{comma} ")
 
         if myord and numchunks:
-            # TODO: can this be just one re as it is in perl?
-            mo = ordinal_suff.search(numchunks[-1])
-            if mo:
-                numchunks[-1] = ordinal_suff.sub(ordinal[mo.group(1)], numchunks[-1])
-            else:
-                numchunks[-1] += "th"
+            numchunks[-1] = self._sub_ord(numchunks[-1])
 
         for chunk in chunks[1:]:
             numchunks.append(decimal)
@@ -3872,34 +3909,30 @@ class engine:
         if finalpoint:
             numchunks.append(decimal)
 
-        # wantlist: Perl list context. can explicitly specify in Python
         if wantlist:
-            if sign:
-                numchunks = [sign] + numchunks
-            return numchunks
-        elif group:
-            signout = f"{sign} " if sign else ""
-            return f"{signout}{', '.join(numchunks)}"
-        else:
-            signout = f"{sign} " if sign else ""
-            num = f"{signout}{numchunks.pop(0)}"
-            if decimal is None:
-                first = True
-            else:
-                first = not num.endswith(decimal)
-            for nc in numchunks:
-                if nc == decimal:
-                    num += f" {nc}"
-                    first = 0
-                elif first:
-                    num += f"{comma} {nc}"
-                else:
-                    num += f" {nc}"
-            return num
+            return [sign] * bool(sign) + numchunks
 
-    # Join words with commas and a trailing 'and' (when appropriate)...
+        signout = f"{sign} " if sign else ""
+        valout = (
+            ', '.join(numchunks)
+            if group
+            else ''.join(self._render(numchunks, decimal, comma))
+        )
+        return signout + valout
 
-    @validate_call
+    @staticmethod
+    def _render(chunks, decimal, comma):
+        first_item = chunks.pop(0)
+        yield first_item
+        first = decimal is None or not first_item.endswith(decimal)
+        for nc in chunks:
+            if nc == decimal:
+                first = False
+            elif first:
+                yield comma
+            yield f" {nc}"
+
+    @typechecked
     def join(
         self,
         words: Optional[Sequence[Word]],
diff --git a/lib/inflect/compat/pydantic.py b/lib/inflect/compat/pydantic.py
deleted file mode 100644
index d777564a..00000000
--- a/lib/inflect/compat/pydantic.py
+++ /dev/null
@@ -1,19 +0,0 @@
-class ValidateCallWrapperWrapper:
-    def __init__(self, wrapped):
-        self.orig = wrapped
-
-    def __eq__(self, other):
-        return self.raw_function == other.raw_function
-
-    @property
-    def raw_function(self):
-        return getattr(self.orig, 'raw_function') or self.orig
-
-
-def same_method(m1, m2) -> bool:
-    """
-    Return whether m1 and m2 are the same method.
-
-    Workaround for pydantic/pydantic#6390.
-    """
-    return ValidateCallWrapperWrapper(m1) == ValidateCallWrapperWrapper(m2)
diff --git a/lib/inflect/compat/pydantic1.py b/lib/inflect/compat/pydantic1.py
deleted file mode 100644
index 8262fdcf..00000000
--- a/lib/inflect/compat/pydantic1.py
+++ /dev/null
@@ -1,8 +0,0 @@
-try:
-    from pydantic import validate_call  # type: ignore
-except ImportError:
-    # Pydantic 1
-    from pydantic import validate_arguments as validate_call  # type: ignore
-
-
-__all__ = ['validate_call']
diff --git a/lib/jaraco/classes/ancestry.py b/lib/jaraco/classes/ancestry.py
deleted file mode 100644
index dd9b2e92..00000000
--- a/lib/jaraco/classes/ancestry.py
+++ /dev/null
@@ -1,68 +0,0 @@
-"""
-Routines for obtaining the class names
-of an object and its parent classes.
-"""
-
-from more_itertools import unique_everseen
-
-
-def all_bases(c):
-    """
-    return a tuple of all base classes the class c has as a parent.
-    >>> object in all_bases(list)
-    True
-    """
-    return c.mro()[1:]
-
-
-def all_classes(c):
-    """
-    return a tuple of all classes to which c belongs
-    >>> list in all_classes(list)
-    True
-    """
-    return c.mro()
-
-
-# borrowed from
-# http://code.activestate.com/recipes/576949-find-all-subclasses-of-a-given-class/
-
-
-def iter_subclasses(cls):
-    """
-    Generator over all subclasses of a given class, in depth-first order.
-
-    >>> bool in list(iter_subclasses(int))
-    True
-    >>> class A(object): pass
-    >>> class B(A): pass
-    >>> class C(A): pass
-    >>> class D(B,C): pass
-    >>> class E(D): pass
-    >>>
-    >>> for cls in iter_subclasses(A):
-    ...     print(cls.__name__)
-    B
-    D
-    E
-    C
-    >>> # get ALL classes currently defined
-    >>> res = [cls.__name__ for cls in iter_subclasses(object)]
-    >>> 'type' in res
-    True
-    >>> 'tuple' in res
-    True
-    >>> len(res) > 100
-    True
-    """
-    return unique_everseen(_iter_all_subclasses(cls))
-
-
-def _iter_all_subclasses(cls):
-    try:
-        subs = cls.__subclasses__()
-    except TypeError:  # fails only when cls is type
-        subs = cls.__subclasses__(cls)
-    for sub in subs:
-        yield sub
-        yield from iter_subclasses(sub)
diff --git a/lib/jaraco/classes/meta.py b/lib/jaraco/classes/meta.py
deleted file mode 100644
index bd41a1d9..00000000
--- a/lib/jaraco/classes/meta.py
+++ /dev/null
@@ -1,66 +0,0 @@
-"""
-meta.py
-
-Some useful metaclasses.
-"""
-
-
-class LeafClassesMeta(type):
-    """
-    A metaclass for classes that keeps track of all of them that
-    aren't base classes.
-
-    >>> Parent = LeafClassesMeta('MyParentClass', (), {})
-    >>> Parent in Parent._leaf_classes
-    True
-    >>> Child = LeafClassesMeta('MyChildClass', (Parent,), {})
-    >>> Child in Parent._leaf_classes
-    True
-    >>> Parent in Parent._leaf_classes
-    False
-
-    >>> Other = LeafClassesMeta('OtherClass', (), {})
-    >>> Parent in Other._leaf_classes
-    False
-    >>> len(Other._leaf_classes)
-    1
-    """
-
-    def __init__(cls, name, bases, attrs):
-        if not hasattr(cls, '_leaf_classes'):
-            cls._leaf_classes = set()
-        leaf_classes = getattr(cls, '_leaf_classes')
-        leaf_classes.add(cls)
-        # remove any base classes
-        leaf_classes -= set(bases)
-
-
-class TagRegistered(type):
-    """
-    As classes of this metaclass are created, they keep a registry in the
-    base class of all classes by a class attribute, indicated by attr_name.
-
-    >>> FooObject = TagRegistered('FooObject', (), dict(tag='foo'))
-    >>> FooObject._registry['foo'] is FooObject
-    True
-    >>> BarObject = TagRegistered('Barobject', (FooObject,), dict(tag='bar'))
-    >>> FooObject._registry is BarObject._registry
-    True
-    >>> len(FooObject._registry)
-    2
-
-    '...' below should be 'jaraco.classes' but for pytest-dev/pytest#3396
-    >>> FooObject._registry['bar']
-    <class '....meta.Barobject'>
-    """
-
-    attr_name = 'tag'
-
-    def __init__(cls, name, bases, namespace):
-        super(TagRegistered, cls).__init__(name, bases, namespace)
-        if not hasattr(cls, '_registry'):
-            cls._registry = {}
-        meta = cls.__class__
-        attr = getattr(cls, meta.attr_name, None)
-        if attr:
-            cls._registry[attr] = cls
diff --git a/lib/jaraco/classes/properties.py b/lib/jaraco/classes/properties.py
deleted file mode 100644
index 62f9e200..00000000
--- a/lib/jaraco/classes/properties.py
+++ /dev/null
@@ -1,170 +0,0 @@
-class NonDataProperty:
-    """Much like the property builtin, but only implements __get__,
-    making it a non-data property, and can be subsequently reset.
-
-    See http://users.rcn.com/python/download/Descriptor.htm for more
-    information.
-
-    >>> class X(object):
-    ...   @NonDataProperty
-    ...   def foo(self):
-    ...     return 3
-    >>> x = X()
-    >>> x.foo
-    3
-    >>> x.foo = 4
-    >>> x.foo
-    4
-
-    '...' below should be 'jaraco.classes' but for pytest-dev/pytest#3396
-    >>> X.foo
-    <....properties.NonDataProperty object at ...>
-    """
-
-    def __init__(self, fget):
-        assert fget is not None, "fget cannot be none"
-        assert callable(fget), "fget must be callable"
-        self.fget = fget
-
-    def __get__(self, obj, objtype=None):
-        if obj is None:
-            return self
-        return self.fget(obj)
-
-
-class classproperty:
-    """
-    Like @property but applies at the class level.
-
-
-    >>> class X(metaclass=classproperty.Meta):
-    ...   val = None
-    ...   @classproperty
-    ...   def foo(cls):
-    ...     return cls.val
-    ...   @foo.setter
-    ...   def foo(cls, val):
-    ...     cls.val = val
-    >>> X.foo
-    >>> X.foo = 3
-    >>> X.foo
-    3
-    >>> x = X()
-    >>> x.foo
-    3
-    >>> X.foo = 4
-    >>> x.foo
-    4
-
-    Setting the property on an instance affects the class.
-
-    >>> x.foo = 5
-    >>> x.foo
-    5
-    >>> X.foo
-    5
-    >>> vars(x)
-    {}
-    >>> X().foo
-    5
-
-    Attempting to set an attribute where no setter was defined
-    results in an AttributeError:
-
-    >>> class GetOnly(metaclass=classproperty.Meta):
-    ...   @classproperty
-    ...   def foo(cls):
-    ...     return 'bar'
-    >>> GetOnly.foo = 3
-    Traceback (most recent call last):
-    ...
-    AttributeError: can't set attribute
-
-    It is also possible to wrap a classmethod or staticmethod in
-    a classproperty.
-
-    >>> class Static(metaclass=classproperty.Meta):
-    ...   @classproperty
-    ...   @classmethod
-    ...   def foo(cls):
-    ...     return 'foo'
-    ...   @classproperty
-    ...   @staticmethod
-    ...   def bar():
-    ...     return 'bar'
-    >>> Static.foo
-    'foo'
-    >>> Static.bar
-    'bar'
-
-    *Legacy*
-
-    For compatibility, if the metaclass isn't specified, the
-    legacy behavior will be invoked.
-
-    >>> class X:
-    ...   val = None
-    ...   @classproperty
-    ...   def foo(cls):
-    ...     return cls.val
-    ...   @foo.setter
-    ...   def foo(cls, val):
-    ...     cls.val = val
-    >>> X.foo
-    >>> X.foo = 3
-    >>> X.foo
-    3
-    >>> x = X()
-    >>> x.foo
-    3
-    >>> X.foo = 4
-    >>> x.foo
-    4
-
-    Note, because the metaclass was not specified, setting
-    a value on an instance does not have the intended effect.
-
-    >>> x.foo = 5
-    >>> x.foo
-    5
-    >>> X.foo  # should be 5
-    4
-    >>> vars(x)  # should be empty
-    {'foo': 5}
-    >>> X().foo  # should be 5
-    4
-    """
-
-    class Meta(type):
-        def __setattr__(self, key, value):
-            obj = self.__dict__.get(key, None)
-            if type(obj) is classproperty:
-                return obj.__set__(self, value)
-            return super().__setattr__(key, value)
-
-    def __init__(self, fget, fset=None):
-        self.fget = self._ensure_method(fget)
-        self.fset = fset
-        fset and self.setter(fset)
-
-    def __get__(self, instance, owner=None):
-        return self.fget.__get__(None, owner)()
-
-    def __set__(self, owner, value):
-        if not self.fset:
-            raise AttributeError("can't set attribute")
-        if type(owner) is not classproperty.Meta:
-            owner = type(owner)
-        return self.fset.__get__(None, owner)(value)
-
-    def setter(self, fset):
-        self.fset = self._ensure_method(fset)
-        return self
-
-    @classmethod
-    def _ensure_method(cls, fn):
-        """
-        Ensure fn is a classmethod or staticmethod.
-        """
-        needs_method = not isinstance(fn, (classmethod, staticmethod))
-        return classmethod(fn) if needs_method else fn
diff --git a/lib/jaraco/collections/__init__.py b/lib/jaraco/collections/__init__.py
index abedf002..5c276da9 100644
--- a/lib/jaraco/collections/__init__.py
+++ b/lib/jaraco/collections/__init__.py
@@ -1,16 +1,17 @@
-import re
-import operator
+from __future__ import annotations
+
 import collections.abc
-import itertools
 import copy
 import functools
+import itertools
+import operator
 import random
+import re
 from collections.abc import Container, Iterable, Mapping
-from typing import Callable, Union
+from typing import Any, Callable, Union
 
 import jaraco.text
 
-
 _Matchable = Union[Callable, Container, Iterable, re.Pattern]
 
 
@@ -199,7 +200,12 @@ class RangeMap(dict):
 
     """
 
-    def __init__(self, source, sort_params={}, key_match_comparator=operator.le):
+    def __init__(
+        self,
+        source,
+        sort_params: Mapping[str, Any] = {},
+        key_match_comparator=operator.le,
+    ):
         dict.__init__(self, source)
         self.sort_params = sort_params
         self.match = key_match_comparator
@@ -291,7 +297,7 @@ class KeyTransformingDict(dict):
         return key
 
     def __init__(self, *args, **kargs):
-        super(KeyTransformingDict, self).__init__()
+        super().__init__()
         # build a dictionary using the default constructs
         d = dict(*args, **kargs)
         # build this dictionary using transformed keys.
@@ -300,31 +306,31 @@ class KeyTransformingDict(dict):
 
     def __setitem__(self, key, val):
         key = self.transform_key(key)
-        super(KeyTransformingDict, self).__setitem__(key, val)
+        super().__setitem__(key, val)
 
     def __getitem__(self, key):
         key = self.transform_key(key)
-        return super(KeyTransformingDict, self).__getitem__(key)
+        return super().__getitem__(key)
 
     def __contains__(self, key):
         key = self.transform_key(key)
-        return super(KeyTransformingDict, self).__contains__(key)
+        return super().__contains__(key)
 
     def __delitem__(self, key):
         key = self.transform_key(key)
-        return super(KeyTransformingDict, self).__delitem__(key)
+        return super().__delitem__(key)
 
     def get(self, key, *args, **kwargs):
         key = self.transform_key(key)
-        return super(KeyTransformingDict, self).get(key, *args, **kwargs)
+        return super().get(key, *args, **kwargs)
 
     def setdefault(self, key, *args, **kwargs):
         key = self.transform_key(key)
-        return super(KeyTransformingDict, self).setdefault(key, *args, **kwargs)
+        return super().setdefault(key, *args, **kwargs)
 
     def pop(self, key, *args, **kwargs):
         key = self.transform_key(key)
-        return super(KeyTransformingDict, self).pop(key, *args, **kwargs)
+        return super().pop(key, *args, **kwargs)
 
     def matching_key_for(self, key):
         """
@@ -333,8 +339,8 @@ class KeyTransformingDict(dict):
         """
         try:
             return next(e_key for e_key in self.keys() if e_key == key)
-        except StopIteration:
-            raise KeyError(key)
+        except StopIteration as err:
+            raise KeyError(key) from err
 
 
 class FoldedCaseKeyedDict(KeyTransformingDict):
@@ -483,7 +489,7 @@ class ItemsAsAttributes:
 
     def __getattr__(self, key):
         try:
-            return getattr(super(ItemsAsAttributes, self), key)
+            return getattr(super(), key)
         except AttributeError as e:
             # attempt to get the value from the mapping (return self[key])
             #  but be careful not to lose the original exception context.
@@ -677,7 +683,7 @@ class BijectiveMap(dict):
     """
 
     def __init__(self, *args, **kwargs):
-        super(BijectiveMap, self).__init__()
+        super().__init__()
         self.update(*args, **kwargs)
 
     def __setitem__(self, item, value):
@@ -691,19 +697,19 @@ class BijectiveMap(dict):
         )
         if overlap:
             raise ValueError("Key/Value pairs may not overlap")
-        super(BijectiveMap, self).__setitem__(item, value)
-        super(BijectiveMap, self).__setitem__(value, item)
+        super().__setitem__(item, value)
+        super().__setitem__(value, item)
 
     def __delitem__(self, item):
         self.pop(item)
 
     def __len__(self):
-        return super(BijectiveMap, self).__len__() // 2
+        return super().__len__() // 2
 
     def pop(self, key, *args, **kwargs):
         mirror = self[key]
-        super(BijectiveMap, self).__delitem__(mirror)
-        return super(BijectiveMap, self).pop(key, *args, **kwargs)
+        super().__delitem__(mirror)
+        return super().pop(key, *args, **kwargs)
 
     def update(self, *args, **kwargs):
         # build a dictionary using the default constructs
@@ -769,7 +775,7 @@ class FrozenDict(collections.abc.Mapping, collections.abc.Hashable):
     __slots__ = ['__data']
 
     def __new__(cls, *args, **kwargs):
-        self = super(FrozenDict, cls).__new__(cls)
+        self = super().__new__(cls)
         self.__data = dict(*args, **kwargs)
         return self
 
@@ -844,7 +850,7 @@ class Enumeration(ItemsAsAttributes, BijectiveMap):
             names = names.split()
         if codes is None:
             codes = itertools.count()
-        super(Enumeration, self).__init__(zip(names, codes))
+        super().__init__(zip(names, codes))
 
     @property
     def names(self):
diff --git a/lib/jaraco/context.py b/lib/jaraco/context.py
index b0d1ef37..61b27135 100644
--- a/lib/jaraco/context.py
+++ b/lib/jaraco/context.py
@@ -1,15 +1,26 @@
-import os
-import subprocess
+from __future__ import annotations
+
 import contextlib
 import functools
-import tempfile
-import shutil
 import operator
+import os
+import shutil
+import subprocess
+import sys
+import tempfile
+import urllib.request
 import warnings
+from typing import Iterator
+
+
+if sys.version_info < (3, 12):
+    from backports import tarfile
+else:
+    import tarfile
 
 
 @contextlib.contextmanager
-def pushd(dir):
+def pushd(dir: str | os.PathLike) -> Iterator[str | os.PathLike]:
     """
     >>> tmp_path = getfixture('tmp_path')
     >>> with pushd(tmp_path):
@@ -26,33 +37,88 @@ def pushd(dir):
 
 
 @contextlib.contextmanager
-def tarball_context(url, target_dir=None, runner=None, pushd=pushd):
+def tarball(
+    url, target_dir: str | os.PathLike | None = None
+) -> Iterator[str | os.PathLike]:
     """
-    Get a tarball, extract it, change to that directory, yield, then
-    clean up.
-    `runner` is the function to invoke commands.
-    `pushd` is a context manager for changing the directory.
+    Get a tarball, extract it, yield, then clean up.
+
+    >>> import urllib.request
+    >>> url = getfixture('tarfile_served')
+    >>> target = getfixture('tmp_path') / 'out'
+    >>> tb = tarball(url, target_dir=target)
+    >>> import pathlib
+    >>> with tb as extracted:
+    ...     contents = pathlib.Path(extracted, 'contents.txt').read_text(encoding='utf-8')
+    >>> assert not os.path.exists(extracted)
     """
     if target_dir is None:
         target_dir = os.path.basename(url).replace('.tar.gz', '').replace('.tgz', '')
-    if runner is None:
-        runner = functools.partial(subprocess.check_call, shell=True)
-    else:
-        warnings.warn("runner parameter is deprecated", DeprecationWarning)
     # In the tar command, use --strip-components=1 to strip the first path and
     #  then
     #  use -C to cause the files to be extracted to {target_dir}. This ensures
     #  that we always know where the files were extracted.
-    runner('mkdir {target_dir}'.format(**vars()))
+    os.mkdir(target_dir)
     try:
-        getter = 'wget {url} -O -'
-        extract = 'tar x{compression} --strip-components=1 -C {target_dir}'
-        cmd = ' | '.join((getter, extract))
-        runner(cmd.format(compression=infer_compression(url), **vars()))
-        with pushd(target_dir):
-            yield target_dir
+        req = urllib.request.urlopen(url)
+        with tarfile.open(fileobj=req, mode='r|*') as tf:
+            tf.extractall(path=target_dir, filter=strip_first_component)
+        yield target_dir
     finally:
-        runner('rm -Rf {target_dir}'.format(**vars()))
+        shutil.rmtree(target_dir)
+
+
+def strip_first_component(
+    member: tarfile.TarInfo,
+    path,
+) -> tarfile.TarInfo:
+    _, member.name = member.name.split('/', 1)
+    return member
+
+
+def _compose(*cmgrs):
+    """
+    Compose any number of dependent context managers into a single one.
+
+    The last, innermost context manager may take arbitrary arguments, but
+    each successive context manager should accept the result from the
+    previous as a single parameter.
+
+    Like :func:`jaraco.functools.compose`, behavior works from right to
+    left, so the context manager should be indicated from outermost to
+    innermost.
+
+    Example, to create a context manager to change to a temporary
+    directory:
+
+    >>> temp_dir_as_cwd = _compose(pushd, temp_dir)
+    >>> with temp_dir_as_cwd() as dir:
+    ...     assert os.path.samefile(os.getcwd(), dir)
+    """
+
+    def compose_two(inner, outer):
+        def composed(*args, **kwargs):
+            with inner(*args, **kwargs) as saved, outer(saved) as res:
+                yield res
+
+        return contextlib.contextmanager(composed)
+
+    return functools.reduce(compose_two, reversed(cmgrs))
+
+
+tarball_cwd = _compose(pushd, tarball)
+
+
+@contextlib.contextmanager
+def tarball_context(*args, **kwargs):
+    warnings.warn(
+        "tarball_context is deprecated. Use tarball or tarball_cwd instead.",
+        DeprecationWarning,
+        stacklevel=2,
+    )
+    pushd_ctx = kwargs.pop('pushd', pushd)
+    with tarball(*args, **kwargs) as tball, pushd_ctx(tball) as dir:
+        yield dir
 
 
 def infer_compression(url):
@@ -68,6 +134,11 @@ def infer_compression(url):
     >>> infer_compression('file.xz')
     'J'
     """
+    warnings.warn(
+        "infer_compression is deprecated with no replacement",
+        DeprecationWarning,
+        stacklevel=2,
+    )
     # cheat and just assume it's the last two characters
     compression_indicator = url[-2:]
     mapping = dict(gz='z', bz='j', xz='J')
@@ -84,7 +155,7 @@ def temp_dir(remover=shutil.rmtree):
     >>> import pathlib
     >>> with temp_dir() as the_dir:
     ...     assert os.path.isdir(the_dir)
-    ...     _ = pathlib.Path(the_dir).joinpath('somefile').write_text('contents')
+    ...     _ = pathlib.Path(the_dir).joinpath('somefile').write_text('contents', encoding='utf-8')
     >>> assert not os.path.exists(the_dir)
     """
     temp_dir = tempfile.mkdtemp()
@@ -113,15 +184,23 @@ def repo_context(url, branch=None, quiet=True, dest_ctx=temp_dir):
         yield repo_dir
 
 
-@contextlib.contextmanager
 def null():
     """
     A null context suitable to stand in for a meaningful context.
 
     >>> with null() as value:
     ...     assert value is None
+
+    This context is most useful when dealing with two or more code
+    branches but only some need a context. Wrap the others in a null
+    context to provide symmetry across all options.
     """
-    yield
+    warnings.warn(
+        "null is deprecated. Use contextlib.nullcontext",
+        DeprecationWarning,
+        stacklevel=2,
+    )
+    return contextlib.nullcontext()
 
 
 class ExceptionTrap:
@@ -267,13 +346,7 @@ class on_interrupt(contextlib.ContextDecorator):
     ...     on_interrupt('ignore')(do_interrupt)()
     """
 
-    def __init__(
-        self,
-        action='error',
-        # py3.7 compat
-        # /,
-        code=1,
-    ):
+    def __init__(self, action='error', /, code=1):
         self.action = action
         self.code = code
 
diff --git a/lib/jaraco/functools/__init__.pyi b/lib/jaraco/functools/__init__.pyi
index c2b9ab17..19191bf9 100644
--- a/lib/jaraco/functools/__init__.pyi
+++ b/lib/jaraco/functools/__init__.pyi
@@ -74,9 +74,6 @@ def result_invoke(
 def invoke(
     f: Callable[_P, _R], /, *args: _P.args, **kwargs: _P.kwargs
 ) -> Callable[_P, _R]: ...
-def call_aside(
-    f: Callable[_P, _R], *args: _P.args, **kwargs: _P.kwargs
-) -> Callable[_P, _R]: ...
 
 class Throttler(Generic[_R]):
     last_called: float
diff --git a/lib/libfuturize/fixer_util.py b/lib/libfuturize/fixer_util.py
index 48e4689d..b5c123f6 100644
--- a/lib/libfuturize/fixer_util.py
+++ b/lib/libfuturize/fixer_util.py
@@ -9,11 +9,11 @@ python-modernize licence: BSD (from python-modernize/LICENSE)
 """
 
 from lib2to3.fixer_util import (FromImport, Newline, is_import,
-                                find_root, does_tree_import, Comma)
+                                find_root, does_tree_import,
+                                Call, Name, Comma)
 from lib2to3.pytree import Leaf, Node
-from lib2to3.pygram import python_symbols as syms, python_grammar
+from lib2to3.pygram import python_symbols as syms
 from lib2to3.pygram import token
-from lib2to3.fixer_util import (Node, Call, Name, syms, Comma, Number)
 import re
 
 
@@ -116,7 +116,7 @@ def suitify(parent):
     """
     for node in parent.children:
         if node.type == syms.suite:
-            # already in the prefered format, do nothing
+            # already in the preferred format, do nothing
             return
 
     # One-liners have no suite node, we have to fake one up
@@ -390,6 +390,7 @@ def touch_import_top(package, name_to_import, node):
                 break
         insert_pos = idx
 
+    children_hooks = []
     if package is None:
         import_ = Node(syms.import_name, [
             Leaf(token.NAME, u"import"),
@@ -413,8 +414,6 @@ def touch_import_top(package, name_to_import, node):
                                  ]
                                 )
             children_hooks = [install_hooks, Newline()]
-        else:
-            children_hooks = []
 
         # FromImport(package, [Leaf(token.NAME, name_to_import, prefix=u" ")])
 
@@ -448,7 +447,6 @@ def check_future_import(node):
     else:
         node = node.children[3]
     # now node is the import_as_name[s]
-    # print(python_grammar.number2symbol[node.type])  # breaks sometimes
     if node.type == syms.import_as_names:
         result = set()
         for n in node.children:
diff --git a/lib/libfuturize/fixes/fix_metaclass.py b/lib/libfuturize/fixes/fix_metaclass.py
index 2ac41c97..a7eee40d 100644
--- a/lib/libfuturize/fixes/fix_metaclass.py
+++ b/lib/libfuturize/fixes/fix_metaclass.py
@@ -37,7 +37,7 @@ from lib2to3.fixer_util import Name, syms, Node, Leaf, touch_import, Call, \
 
 def has_metaclass(parent):
     """ we have to check the cls_node without changing it.
-        There are two possiblities:
+        There are two possibilities:
           1)  clsdef => suite => simple_stmt => expr_stmt => Leaf('__meta')
           2)  clsdef => simple_stmt => expr_stmt => Leaf('__meta')
     """
@@ -63,7 +63,7 @@ def fixup_parse_tree(cls_node):
             # already in the preferred format, do nothing
             return
 
-    # !%@#! oneliners have no suite node, we have to fake one up
+    # !%@#! one-liners have no suite node, we have to fake one up
     for i, node in enumerate(cls_node.children):
         if node.type == token.COLON:
             break
diff --git a/lib/libpasteurize/fixes/fix_imports.py b/lib/libpasteurize/fixes/fix_imports.py
index 2d6718f1..b18ecf3d 100644
--- a/lib/libpasteurize/fixes/fix_imports.py
+++ b/lib/libpasteurize/fixes/fix_imports.py
@@ -16,6 +16,7 @@ MAPPING = {u"reprlib": u"repr",
            u"winreg": u"_winreg",
            u"configparser": u"ConfigParser",
            u"copyreg": u"copy_reg",
+           u"multiprocessing.SimpleQueue": u"multiprocessing.queues.SimpleQueue",
            u"queue": u"Queue",
            u"socketserver": u"SocketServer",
            u"_markupbase": u"markupbase",
diff --git a/lib/libpasteurize/fixes/fix_unpacking.py b/lib/libpasteurize/fixes/fix_unpacking.py
index c2d3207a..6e839e6b 100644
--- a/lib/libpasteurize/fixes/fix_unpacking.py
+++ b/lib/libpasteurize/fixes/fix_unpacking.py
@@ -18,8 +18,12 @@ def assignment_source(num_pre, num_post, LISTNAME, ITERNAME):
     Returns a source fit for Assign() from fixer_util
     """
     children = []
-    pre = unicode(num_pre)
-    post = unicode(num_post)
+    try:
+        pre = unicode(num_pre)
+        post = unicode(num_post)
+    except NameError:
+        pre = str(num_pre)
+        post = str(num_post)
     # This code builds the assignment source from lib2to3 tree primitives.
     # It's not very readable, but it seems like the most correct way to do it.
     if num_pre > 0:
diff --git a/lib/past/__init__.py b/lib/past/__init__.py
index 14713039..54619e0a 100644
--- a/lib/past/__init__.py
+++ b/lib/past/__init__.py
@@ -75,12 +75,12 @@ Credits
 -------
 
 :Author:  Ed Schofield, Jordan M. Adler, et al
-:Sponsor: Python Charmers Pty Ltd, Australia: http://pythoncharmers.com
+:Sponsor: Python Charmers: https://pythoncharmers.com
 
 
 Licensing
 ---------
-Copyright 2013-2019 Python Charmers Pty Ltd, Australia.
+Copyright 2013-2024 Python Charmers, Australia.
 The software is distributed under an MIT licence. See LICENSE.txt.
 """
 
diff --git a/lib/past/builtins/misc.py b/lib/past/builtins/misc.py
index 3600695c..0b8e6a98 100644
--- a/lib/past/builtins/misc.py
+++ b/lib/past/builtins/misc.py
@@ -1,11 +1,13 @@
 from __future__ import unicode_literals
 
 import inspect
+import sys
 import math
 import numbers
 
 from future.utils import PY2, PY3, exec_
 
+
 if PY2:
     from collections import Mapping
 else:
@@ -103,13 +105,12 @@ if PY3:
         return '0' + builtins.oct(number)[2:]
 
     raw_input = input
-
-    try:
+    # imp was deprecated in python 3.6
+    if sys.version_info >= (3, 6):
         from importlib import reload
-    except ImportError:
+    else:
         # for python2, python3 <= 3.4
         from imp import reload
-
     unicode = str
     unichr = chr
     xrange = range
diff --git a/lib/past/translation/__init__.py b/lib/past/translation/__init__.py
index 7c678866..ae6c0d90 100644
--- a/lib/past/translation/__init__.py
+++ b/lib/past/translation/__init__.py
@@ -32,17 +32,31 @@ Author: Ed Schofield.
 Inspired by and based on ``uprefix`` by Vinay M. Sajip.
 """
 
-import imp
-import logging
-import marshal
-import os
 import sys
+# imp was deprecated in python 3.6
+if sys.version_info >= (3, 6):
+    import importlib as imp
+else:
+    import imp
+import logging
+import os
 import copy
 from lib2to3.pgen2.parse import ParseError
 from lib2to3.refactor import RefactoringTool
 
 from libfuturize import fixes
 
+try:
+    from importlib.machinery import (
+        PathFinder,
+        SourceFileLoader,
+    )
+except ImportError:
+    PathFinder = None
+    SourceFileLoader = object
+
+if sys.version_info[:2] < (3, 4):
+    import imp
 
 logger = logging.getLogger(__name__)
 logger.setLevel(logging.DEBUG)
@@ -225,6 +239,81 @@ def detect_python2(source, pathname):
         return False
 
 
+def transform(source, pathname):
+    # This implementation uses lib2to3,
+    # you can override and use something else
+    # if that's better for you
+
+    # lib2to3 likes a newline at the end
+    RTs.setup()
+    source += '\n'
+    try:
+        tree = RTs._rt.refactor_string(source, pathname)
+    except ParseError as e:
+        if e.msg != 'bad input' or e.value != '=':
+            raise
+        tree = RTs._rtp.refactor_string(source, pathname)
+    # could optimise a bit for only doing str(tree) if
+    # getattr(tree, 'was_changed', False) returns True
+    return str(tree)[:-1]  # remove added newline
+
+
+class PastSourceFileLoader(SourceFileLoader):
+    exclude_paths = []
+    include_paths = []
+
+    def _convert_needed(self):
+        fullname = self.name
+        if any(fullname.startswith(path) for path in self.exclude_paths):
+            convert = False
+        elif any(fullname.startswith(path) for path in self.include_paths):
+            convert = True
+        else:
+            convert = False
+        return convert
+
+    def _exec_transformed_module(self, module):
+        source = self.get_source(self.name)
+        pathname = self.path
+        if detect_python2(source, pathname):
+            source = transform(source, pathname)
+        code = compile(source, pathname, "exec")
+        exec(code, module.__dict__)
+
+    # For Python 3.3
+    def load_module(self, fullname):
+        logger.debug("Running load_module for %s", fullname)
+        if fullname in sys.modules:
+            mod = sys.modules[fullname]
+        else:
+            if self._convert_needed():
+                logger.debug("Autoconverting %s", fullname)
+                mod = imp.new_module(fullname)
+                sys.modules[fullname] = mod
+
+                # required by PEP 302
+                mod.__file__ = self.path
+                mod.__loader__ = self
+                if self.is_package(fullname):
+                    mod.__path__ = []
+                    mod.__package__ = fullname
+                else:
+                    mod.__package__ = fullname.rpartition('.')[0]
+                self._exec_transformed_module(mod)
+            else:
+                mod = super().load_module(fullname)
+        return mod
+
+    # For Python >=3.4
+    def exec_module(self, module):
+        logger.debug("Running exec_module for %s", module)
+        if self._convert_needed():
+            logger.debug("Autoconverting %s", self.name)
+            self._exec_transformed_module(module)
+        else:
+            super().exec_module(module)
+
+
 class Py2Fixer(object):
     """
     An import hook class that uses lib2to3 for source-to-source translation of
@@ -258,151 +347,30 @@ class Py2Fixer(object):
         """
         self.exclude_paths += paths
 
+    # For Python 3.3
     def find_module(self, fullname, path=None):
-        logger.debug('Running find_module: {0}...'.format(fullname))
-        if '.' in fullname:
-            parent, child = fullname.rsplit('.', 1)
-            if path is None:
-                loader = self.find_module(parent, path)
-                mod = loader.load_module(parent)
-                path = mod.__path__
-            fullname = child
-
-        # Perhaps we should try using the new importlib functionality in Python
-        # 3.3: something like this?
-        # thing = importlib.machinery.PathFinder.find_module(fullname, path)
-        try:
-            self.found = imp.find_module(fullname, path)
-        except Exception as e:
-            logger.debug('Py2Fixer could not find {0}')
-            logger.debug('Exception was: {0})'.format(fullname, e))
+        logger.debug("Running find_module: (%s, %s)", fullname, path)
+        loader = PathFinder.find_module(fullname, path)
+        if not loader:
+            logger.debug("Py2Fixer could not find %s", fullname)
             return None
-        self.kind = self.found[-1][-1]
-        if self.kind == imp.PKG_DIRECTORY:
-            self.pathname = os.path.join(self.found[1], '__init__.py')
-        elif self.kind == imp.PY_SOURCE:
-            self.pathname = self.found[1]
-        return self
+        loader.__class__ = PastSourceFileLoader
+        loader.exclude_paths = self.exclude_paths
+        loader.include_paths = self.include_paths
+        return loader
 
-    def transform(self, source):
-        # This implementation uses lib2to3,
-        # you can override and use something else
-        # if that's better for you
+    # For Python >=3.4
+    def find_spec(self, fullname, path=None, target=None):
+        logger.debug("Running find_spec: (%s, %s, %s)", fullname, path, target)
+        spec = PathFinder.find_spec(fullname, path, target)
+        if not spec:
+            logger.debug("Py2Fixer could not find %s", fullname)
+            return None
+        spec.loader.__class__ = PastSourceFileLoader
+        spec.loader.exclude_paths = self.exclude_paths
+        spec.loader.include_paths = self.include_paths
+        return spec
 
-        # lib2to3 likes a newline at the end
-        RTs.setup()
-        source += '\n'
-        try:
-            tree = RTs._rt.refactor_string(source, self.pathname)
-        except ParseError as e:
-            if e.msg != 'bad input' or e.value != '=':
-                raise
-            tree = RTs._rtp.refactor_string(source, self.pathname)
-        # could optimise a bit for only doing str(tree) if
-        # getattr(tree, 'was_changed', False) returns True
-        return str(tree)[:-1] # remove added newline
-
-    def load_module(self, fullname):
-        logger.debug('Running load_module for {0}...'.format(fullname))
-        if fullname in sys.modules:
-            mod = sys.modules[fullname]
-        else:
-            if self.kind in (imp.PY_COMPILED, imp.C_EXTENSION, imp.C_BUILTIN,
-                             imp.PY_FROZEN):
-                convert = False
-            # elif (self.pathname.startswith(_stdlibprefix)
-            #       and 'site-packages' not in self.pathname):
-            #     # We assume it's a stdlib package in this case. Is this too brittle?
-            #     # Please file a bug report at https://github.com/PythonCharmers/python-future
-            #     # if so.
-            #     convert = False
-            # in theory, other paths could be configured to be excluded here too
-            elif any([fullname.startswith(path) for path in self.exclude_paths]):
-                convert = False
-            elif any([fullname.startswith(path) for path in self.include_paths]):
-                convert = True
-            else:
-                convert = False
-            if not convert:
-                logger.debug('Excluded {0} from translation'.format(fullname))
-                mod = imp.load_module(fullname, *self.found)
-            else:
-                logger.debug('Autoconverting {0} ...'.format(fullname))
-                mod = imp.new_module(fullname)
-                sys.modules[fullname] = mod
-
-                # required by PEP 302
-                mod.__file__ = self.pathname
-                mod.__name__ = fullname
-                mod.__loader__ = self
-
-                # This:
-                #     mod.__package__ = '.'.join(fullname.split('.')[:-1])
-                # seems to result in "SystemError: Parent module '' not loaded,
-                # cannot perform relative import" for a package's __init__.py
-                # file. We use the approach below. Another option to try is the
-                # minimal load_module pattern from the PEP 302 text instead.
-
-                # Is the test in the next line more or less robust than the
-                # following one? Presumably less ...
-                # ispkg = self.pathname.endswith('__init__.py')
-
-                if self.kind == imp.PKG_DIRECTORY:
-                    mod.__path__ = [ os.path.dirname(self.pathname) ]
-                    mod.__package__ = fullname
-                else:
-                    #else, regular module
-                    mod.__path__ = []
-                    mod.__package__ = fullname.rpartition('.')[0]
-
-                try:
-                    cachename = imp.cache_from_source(self.pathname)
-                    if not os.path.exists(cachename):
-                        update_cache = True
-                    else:
-                        sourcetime = os.stat(self.pathname).st_mtime
-                        cachetime = os.stat(cachename).st_mtime
-                        update_cache = cachetime < sourcetime
-                    # # Force update_cache to work around a problem with it being treated as Py3 code???
-                    # update_cache = True
-                    if not update_cache:
-                        with open(cachename, 'rb') as f:
-                            data = f.read()
-                            try:
-                                code = marshal.loads(data)
-                            except Exception:
-                                # pyc could be corrupt. Regenerate it
-                                update_cache = True
-                    if update_cache:
-                        if self.found[0]:
-                            source = self.found[0].read()
-                        elif self.kind == imp.PKG_DIRECTORY:
-                            with open(self.pathname) as f:
-                                source = f.read()
-
-                        if detect_python2(source, self.pathname):
-                            source = self.transform(source)
-
-                        code = compile(source, self.pathname, 'exec')
-
-                        dirname = os.path.dirname(cachename)
-                        try:
-                            if not os.path.exists(dirname):
-                                os.makedirs(dirname)
-                            with open(cachename, 'wb') as f:
-                                data = marshal.dumps(code)
-                                f.write(data)
-                        except Exception:   # could be write-protected
-                            pass
-                    exec(code, mod.__dict__)
-                except Exception as e:
-                    # must remove module from sys.modules
-                    del sys.modules[fullname]
-                    raise # keep it simple
-
-        if self.found[0]:
-            self.found[0].close()
-        return mod
 
 _hook = Py2Fixer()
 
diff --git a/lib/typeguard/__init__.py b/lib/typeguard/__init__.py
new file mode 100644
index 00000000..6781cad0
--- /dev/null
+++ b/lib/typeguard/__init__.py
@@ -0,0 +1,48 @@
+import os
+from typing import Any
+
+from ._checkers import TypeCheckerCallable as TypeCheckerCallable
+from ._checkers import TypeCheckLookupCallback as TypeCheckLookupCallback
+from ._checkers import check_type_internal as check_type_internal
+from ._checkers import checker_lookup_functions as checker_lookup_functions
+from ._checkers import load_plugins as load_plugins
+from ._config import CollectionCheckStrategy as CollectionCheckStrategy
+from ._config import ForwardRefPolicy as ForwardRefPolicy
+from ._config import TypeCheckConfiguration as TypeCheckConfiguration
+from ._decorators import typechecked as typechecked
+from ._decorators import typeguard_ignore as typeguard_ignore
+from ._exceptions import InstrumentationWarning as InstrumentationWarning
+from ._exceptions import TypeCheckError as TypeCheckError
+from ._exceptions import TypeCheckWarning as TypeCheckWarning
+from ._exceptions import TypeHintWarning as TypeHintWarning
+from ._functions import TypeCheckFailCallback as TypeCheckFailCallback
+from ._functions import check_type as check_type
+from ._functions import warn_on_error as warn_on_error
+from ._importhook import ImportHookManager as ImportHookManager
+from ._importhook import TypeguardFinder as TypeguardFinder
+from ._importhook import install_import_hook as install_import_hook
+from ._memo import TypeCheckMemo as TypeCheckMemo
+from ._suppression import suppress_type_checks as suppress_type_checks
+from ._utils import Unset as Unset
+
+# Re-export imports so they look like they live directly in this package
+for value in list(locals().values()):
+    if getattr(value, "__module__", "").startswith(f"{__name__}."):
+        value.__module__ = __name__
+
+
+config: TypeCheckConfiguration
+
+
+def __getattr__(name: str) -> Any:
+    if name == "config":
+        from ._config import global_config
+
+        return global_config
+
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+
+
+# Automatically load checker lookup functions unless explicitly disabled
+if "TYPEGUARD_DISABLE_PLUGIN_AUTOLOAD" not in os.environ:
+    load_plugins()
diff --git a/lib/typeguard/_checkers.py b/lib/typeguard/_checkers.py
new file mode 100644
index 00000000..2f8de6f3
--- /dev/null
+++ b/lib/typeguard/_checkers.py
@@ -0,0 +1,910 @@
+from __future__ import annotations
+
+import collections.abc
+import inspect
+import sys
+import types
+import typing
+import warnings
+from enum import Enum
+from inspect import Parameter, isclass, isfunction
+from io import BufferedIOBase, IOBase, RawIOBase, TextIOBase
+from textwrap import indent
+from typing import (
+    IO,
+    AbstractSet,
+    Any,
+    BinaryIO,
+    Callable,
+    Dict,
+    ForwardRef,
+    List,
+    Mapping,
+    MutableMapping,
+    NewType,
+    Optional,
+    Sequence,
+    Set,
+    TextIO,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+)
+from unittest.mock import Mock
+
+try:
+    import typing_extensions
+except ImportError:
+    typing_extensions = None  # type: ignore[assignment]
+
+from ._config import ForwardRefPolicy
+from ._exceptions import TypeCheckError, TypeHintWarning
+from ._memo import TypeCheckMemo
+from ._utils import evaluate_forwardref, get_stacklevel, get_type_name, qualified_name
+
+if sys.version_info >= (3, 13):
+    from typing import is_typeddict
+else:
+    from typing_extensions import is_typeddict
+
+if sys.version_info >= (3, 11):
+    from typing import (
+        Annotated,
+        NotRequired,
+        TypeAlias,
+        get_args,
+        get_origin,
+    )
+
+    SubclassableAny = Any
+else:
+    from typing_extensions import (
+        Annotated,
+        NotRequired,
+        TypeAlias,
+        get_args,
+        get_origin,
+    )
+    from typing_extensions import Any as SubclassableAny
+
+if sys.version_info >= (3, 10):
+    from importlib.metadata import entry_points
+    from typing import ParamSpec
+else:
+    from importlib_metadata import entry_points
+    from typing_extensions import ParamSpec
+
+TypeCheckerCallable: TypeAlias = Callable[
+    [Any, Any, Tuple[Any, ...], TypeCheckMemo], Any
+]
+TypeCheckLookupCallback: TypeAlias = Callable[
+    [Any, Tuple[Any, ...], Tuple[Any, ...]], Optional[TypeCheckerCallable]
+]
+
+checker_lookup_functions: list[TypeCheckLookupCallback] = []
+generic_alias_types: tuple[type, ...] = (type(List), type(List[Any]))
+if sys.version_info >= (3, 9):
+    generic_alias_types += (types.GenericAlias,)
+
+
+# Sentinel
+_missing = object()
+
+# Lifted from mypy.sharedparse
+BINARY_MAGIC_METHODS = {
+    "__add__",
+    "__and__",
+    "__cmp__",
+    "__divmod__",
+    "__div__",
+    "__eq__",
+    "__floordiv__",
+    "__ge__",
+    "__gt__",
+    "__iadd__",
+    "__iand__",
+    "__idiv__",
+    "__ifloordiv__",
+    "__ilshift__",
+    "__imatmul__",
+    "__imod__",
+    "__imul__",
+    "__ior__",
+    "__ipow__",
+    "__irshift__",
+    "__isub__",
+    "__itruediv__",
+    "__ixor__",
+    "__le__",
+    "__lshift__",
+    "__lt__",
+    "__matmul__",
+    "__mod__",
+    "__mul__",
+    "__ne__",
+    "__or__",
+    "__pow__",
+    "__radd__",
+    "__rand__",
+    "__rdiv__",
+    "__rfloordiv__",
+    "__rlshift__",
+    "__rmatmul__",
+    "__rmod__",
+    "__rmul__",
+    "__ror__",
+    "__rpow__",
+    "__rrshift__",
+    "__rshift__",
+    "__rsub__",
+    "__rtruediv__",
+    "__rxor__",
+    "__sub__",
+    "__truediv__",
+    "__xor__",
+}
+
+
+def check_callable(
+    value: Any,
+    origin_type: Any,
+    args: tuple[Any, ...],
+    memo: TypeCheckMemo,
+) -> None:
+    if not callable(value):
+        raise TypeCheckError("is not callable")
+
+    if args:
+        try:
+            signature = inspect.signature(value)
+        except (TypeError, ValueError):
+            return
+
+        argument_types = args[0]
+        if isinstance(argument_types, list) and not any(
+            type(item) is ParamSpec for item in argument_types
+        ):
+            # The callable must not have keyword-only arguments without defaults
+            unfulfilled_kwonlyargs = [
+                param.name
+                for param in signature.parameters.values()
+                if param.kind == Parameter.KEYWORD_ONLY
+                and param.default == Parameter.empty
+            ]
+            if unfulfilled_kwonlyargs:
+                raise TypeCheckError(
+                    f"has mandatory keyword-only arguments in its declaration: "
+                    f'{", ".join(unfulfilled_kwonlyargs)}'
+                )
+
+            num_positional_args = num_mandatory_pos_args = 0
+            has_varargs = False
+            for param in signature.parameters.values():
+                if param.kind in (
+                    Parameter.POSITIONAL_ONLY,
+                    Parameter.POSITIONAL_OR_KEYWORD,
+                ):
+                    num_positional_args += 1
+                    if param.default is Parameter.empty:
+                        num_mandatory_pos_args += 1
+                elif param.kind == Parameter.VAR_POSITIONAL:
+                    has_varargs = True
+
+            if num_mandatory_pos_args > len(argument_types):
+                raise TypeCheckError(
+                    f"has too many mandatory positional arguments in its declaration; "
+                    f"expected {len(argument_types)} but {num_mandatory_pos_args} "
+                    f"mandatory positional argument(s) declared"
+                )
+            elif not has_varargs and num_positional_args < len(argument_types):
+                raise TypeCheckError(
+                    f"has too few arguments in its declaration; expected "
+                    f"{len(argument_types)} but {num_positional_args} argument(s) "
+                    f"declared"
+                )
+
+
+def check_mapping(
+    value: Any,
+    origin_type: Any,
+    args: tuple[Any, ...],
+    memo: TypeCheckMemo,
+) -> None:
+    if origin_type is Dict or origin_type is dict:
+        if not isinstance(value, dict):
+            raise TypeCheckError("is not a dict")
+    if origin_type is MutableMapping or origin_type is collections.abc.MutableMapping:
+        if not isinstance(value, collections.abc.MutableMapping):
+            raise TypeCheckError("is not a mutable mapping")
+    elif not isinstance(value, collections.abc.Mapping):
+        raise TypeCheckError("is not a mapping")
+
+    if args:
+        key_type, value_type = args
+        if key_type is not Any or value_type is not Any:
+            samples = memo.config.collection_check_strategy.iterate_samples(
+                value.items()
+            )
+            for k, v in samples:
+                try:
+                    check_type_internal(k, key_type, memo)
+                except TypeCheckError as exc:
+                    exc.append_path_element(f"key {k!r}")
+                    raise
+
+                try:
+                    check_type_internal(v, value_type, memo)
+                except TypeCheckError as exc:
+                    exc.append_path_element(f"value of key {k!r}")
+                    raise
+
+
+def check_typed_dict(
+    value: Any,
+    origin_type: Any,
+    args: tuple[Any, ...],
+    memo: TypeCheckMemo,
+) -> None:
+    if not isinstance(value, dict):
+        raise TypeCheckError("is not a dict")
+
+    declared_keys = frozenset(origin_type.__annotations__)
+    if hasattr(origin_type, "__required_keys__"):
+        required_keys = set(origin_type.__required_keys__)
+    else:  # py3.8 and lower
+        required_keys = set(declared_keys) if origin_type.__total__ else set()
+
+    existing_keys = set(value)
+    extra_keys = existing_keys - declared_keys
+    if extra_keys:
+        keys_formatted = ", ".join(f'"{key}"' for key in sorted(extra_keys, key=repr))
+        raise TypeCheckError(f"has unexpected extra key(s): {keys_formatted}")
+
+    # Detect NotRequired fields which are hidden by get_type_hints()
+    type_hints: dict[str, type] = {}
+    for key, annotation in origin_type.__annotations__.items():
+        if isinstance(annotation, ForwardRef):
+            annotation = evaluate_forwardref(annotation, memo)
+            if get_origin(annotation) is NotRequired:
+                required_keys.discard(key)
+                annotation = get_args(annotation)[0]
+
+        type_hints[key] = annotation
+
+    missing_keys = required_keys - existing_keys
+    if missing_keys:
+        keys_formatted = ", ".join(f'"{key}"' for key in sorted(missing_keys, key=repr))
+        raise TypeCheckError(f"is missing required key(s): {keys_formatted}")
+
+    for key, argtype in type_hints.items():
+        argvalue = value.get(key, _missing)
+        if argvalue is not _missing:
+            try:
+                check_type_internal(argvalue, argtype, memo)
+            except TypeCheckError as exc:
+                exc.append_path_element(f"value of key {key!r}")
+                raise
+
+
+def check_list(
+    value: Any,
+    origin_type: Any,
+    args: tuple[Any, ...],
+    memo: TypeCheckMemo,
+) -> None:
+    if not isinstance(value, list):
+        raise TypeCheckError("is not a list")
+
+    if args and args != (Any,):
+        samples = memo.config.collection_check_strategy.iterate_samples(value)
+        for i, v in enumerate(samples):
+            try:
+                check_type_internal(v, args[0], memo)
+            except TypeCheckError as exc:
+                exc.append_path_element(f"item {i}")
+                raise
+
+
+def check_sequence(
+    value: Any,
+    origin_type: Any,
+    args: tuple[Any, ...],
+    memo: TypeCheckMemo,
+) -> None:
+    if not isinstance(value, collections.abc.Sequence):
+        raise TypeCheckError("is not a sequence")
+
+    if args and args != (Any,):
+        samples = memo.config.collection_check_strategy.iterate_samples(value)
+        for i, v in enumerate(samples):
+            try:
+                check_type_internal(v, args[0], memo)
+            except TypeCheckError as exc:
+                exc.append_path_element(f"item {i}")
+                raise
+
+
+def check_set(
+    value: Any,
+    origin_type: Any,
+    args: tuple[Any, ...],
+    memo: TypeCheckMemo,
+) -> None:
+    if origin_type is frozenset:
+        if not isinstance(value, frozenset):
+            raise TypeCheckError("is not a frozenset")
+    elif not isinstance(value, AbstractSet):
+        raise TypeCheckError("is not a set")
+
+    if args and args != (Any,):
+        samples = memo.config.collection_check_strategy.iterate_samples(value)
+        for v in samples:
+            try:
+                check_type_internal(v, args[0], memo)
+            except TypeCheckError as exc:
+                exc.append_path_element(f"[{v}]")
+                raise
+
+
+def check_tuple(
+    value: Any,
+    origin_type: Any,
+    args: tuple[Any, ...],
+    memo: TypeCheckMemo,
+) -> None:
+    # Specialized check for NamedTuples
+    if field_types := getattr(origin_type, "__annotations__", None):
+        if not isinstance(value, origin_type):
+            raise TypeCheckError(
+                f"is not a named tuple of type {qualified_name(origin_type)}"
+            )
+
+        for name, field_type in field_types.items():
+            try:
+                check_type_internal(getattr(value, name), field_type, memo)
+            except TypeCheckError as exc:
+                exc.append_path_element(f"attribute {name!r}")
+                raise
+
+        return
+    elif not isinstance(value, tuple):
+        raise TypeCheckError("is not a tuple")
+
+    if args:
+        use_ellipsis = args[-1] is Ellipsis
+        tuple_params = args[: -1 if use_ellipsis else None]
+    else:
+        # Unparametrized Tuple or plain tuple
+        return
+
+    if use_ellipsis:
+        element_type = tuple_params[0]
+        samples = memo.config.collection_check_strategy.iterate_samples(value)
+        for i, element in enumerate(samples):
+            try:
+                check_type_internal(element, element_type, memo)
+            except TypeCheckError as exc:
+                exc.append_path_element(f"item {i}")
+                raise
+    elif tuple_params == ((),):
+        if value != ():
+            raise TypeCheckError("is not an empty tuple")
+    else:
+        if len(value) != len(tuple_params):
+            raise TypeCheckError(
+                f"has wrong number of elements (expected {len(tuple_params)}, got "
+                f"{len(value)} instead)"
+            )
+
+        for i, (element, element_type) in enumerate(zip(value, tuple_params)):
+            try:
+                check_type_internal(element, element_type, memo)
+            except TypeCheckError as exc:
+                exc.append_path_element(f"item {i}")
+                raise
+
+
+def check_union(
+    value: Any,
+    origin_type: Any,
+    args: tuple[Any, ...],
+    memo: TypeCheckMemo,
+) -> None:
+    errors: dict[str, TypeCheckError] = {}
+    try:
+        for type_ in args:
+            try:
+                check_type_internal(value, type_, memo)
+                return
+            except TypeCheckError as exc:
+                errors[get_type_name(type_)] = exc
+
+        formatted_errors = indent(
+            "\n".join(f"{key}: {error}" for key, error in errors.items()), "  "
+        )
+    finally:
+        del errors  # avoid creating ref cycle
+    raise TypeCheckError(f"did not match any element in the union:\n{formatted_errors}")
+
+
+def check_uniontype(
+    value: Any,
+    origin_type: Any,
+    args: tuple[Any, ...],
+    memo: TypeCheckMemo,
+) -> None:
+    errors: dict[str, TypeCheckError] = {}
+    for type_ in args:
+        try:
+            check_type_internal(value, type_, memo)
+            return
+        except TypeCheckError as exc:
+            errors[get_type_name(type_)] = exc
+
+    formatted_errors = indent(
+        "\n".join(f"{key}: {error}" for key, error in errors.items()), "  "
+    )
+    raise TypeCheckError(f"did not match any element in the union:\n{formatted_errors}")
+
+
+def check_class(
+    value: Any,
+    origin_type: Any,
+    args: tuple[Any, ...],
+    memo: TypeCheckMemo,
+) -> None:
+    if not isclass(value) and not isinstance(value, generic_alias_types):
+        raise TypeCheckError("is not a class")
+
+    if not args:
+        return
+
+    if isinstance(args[0], ForwardRef):
+        expected_class = evaluate_forwardref(args[0], memo)
+    else:
+        expected_class = args[0]
+
+    if expected_class is Any:
+        return
+    elif getattr(expected_class, "_is_protocol", False):
+        check_protocol(value, expected_class, (), memo)
+    elif isinstance(expected_class, TypeVar):
+        check_typevar(value, expected_class, (), memo, subclass_check=True)
+    elif get_origin(expected_class) is Union:
+        errors: dict[str, TypeCheckError] = {}
+        for arg in get_args(expected_class):
+            if arg is Any:
+                return
+
+            try:
+                check_class(value, type, (arg,), memo)
+                return
+            except TypeCheckError as exc:
+                errors[get_type_name(arg)] = exc
+        else:
+            formatted_errors = indent(
+                "\n".join(f"{key}: {error}" for key, error in errors.items()), "  "
+            )
+            raise TypeCheckError(
+                f"did not match any element in the union:\n{formatted_errors}"
+            )
+    elif not issubclass(value, expected_class):  # type: ignore[arg-type]
+        raise TypeCheckError(f"is not a subclass of {qualified_name(expected_class)}")
+
+
+def check_newtype(
+    value: Any,
+    origin_type: Any,
+    args: tuple[Any, ...],
+    memo: TypeCheckMemo,
+) -> None:
+    check_type_internal(value, origin_type.__supertype__, memo)
+
+
+def check_instance(
+    value: Any,
+    origin_type: Any,
+    args: tuple[Any, ...],
+    memo: TypeCheckMemo,
+) -> None:
+    if not isinstance(value, origin_type):
+        raise TypeCheckError(f"is not an instance of {qualified_name(origin_type)}")
+
+
+def check_typevar(
+    value: Any,
+    origin_type: TypeVar,
+    args: tuple[Any, ...],
+    memo: TypeCheckMemo,
+    *,
+    subclass_check: bool = False,
+) -> None:
+    if origin_type.__bound__ is not None:
+        annotation = (
+            Type[origin_type.__bound__] if subclass_check else origin_type.__bound__
+        )
+        check_type_internal(value, annotation, memo)
+    elif origin_type.__constraints__:
+        for constraint in origin_type.__constraints__:
+            annotation = Type[constraint] if subclass_check else constraint
+            try:
+                check_type_internal(value, annotation, memo)
+            except TypeCheckError:
+                pass
+            else:
+                break
+        else:
+            formatted_constraints = ", ".join(
+                get_type_name(constraint) for constraint in origin_type.__constraints__
+            )
+            raise TypeCheckError(
+                f"does not match any of the constraints " f"({formatted_constraints})"
+            )
+
+
+if typing_extensions is None:
+
+    def _is_literal_type(typ: object) -> bool:
+        return typ is typing.Literal
+
+else:
+
+    def _is_literal_type(typ: object) -> bool:
+        return typ is typing.Literal or typ is typing_extensions.Literal
+
+
+def check_literal(
+    value: Any,
+    origin_type: Any,
+    args: tuple[Any, ...],
+    memo: TypeCheckMemo,
+) -> None:
+    def get_literal_args(literal_args: tuple[Any, ...]) -> tuple[Any, ...]:
+        retval: list[Any] = []
+        for arg in literal_args:
+            if _is_literal_type(get_origin(arg)):
+                retval.extend(get_literal_args(arg.__args__))
+            elif arg is None or isinstance(arg, (int, str, bytes, bool, Enum)):
+                retval.append(arg)
+            else:
+                raise TypeError(
+                    f"Illegal literal value: {arg}"
+                )  # TypeError here is deliberate
+
+        return tuple(retval)
+
+    final_args = tuple(get_literal_args(args))
+    try:
+        index = final_args.index(value)
+    except ValueError:
+        pass
+    else:
+        if type(final_args[index]) is type(value):
+            return
+
+    formatted_args = ", ".join(repr(arg) for arg in final_args)
+    raise TypeCheckError(f"is not any of ({formatted_args})") from None
+
+
+def check_literal_string(
+    value: Any,
+    origin_type: Any,
+    args: tuple[Any, ...],
+    memo: TypeCheckMemo,
+) -> None:
+    check_type_internal(value, str, memo)
+
+
+def check_typeguard(
+    value: Any,
+    origin_type: Any,
+    args: tuple[Any, ...],
+    memo: TypeCheckMemo,
+) -> None:
+    check_type_internal(value, bool, memo)
+
+
+def check_none(
+    value: Any,
+    origin_type: Any,
+    args: tuple[Any, ...],
+    memo: TypeCheckMemo,
+) -> None:
+    if value is not None:
+        raise TypeCheckError("is not None")
+
+
+def check_number(
+    value: Any,
+    origin_type: Any,
+    args: tuple[Any, ...],
+    memo: TypeCheckMemo,
+) -> None:
+    if origin_type is complex and not isinstance(value, (complex, float, int)):
+        raise TypeCheckError("is neither complex, float or int")
+    elif origin_type is float and not isinstance(value, (float, int)):
+        raise TypeCheckError("is neither float or int")
+
+
+def check_io(
+    value: Any,
+    origin_type: Any,
+    args: tuple[Any, ...],
+    memo: TypeCheckMemo,
+) -> None:
+    if origin_type is TextIO or (origin_type is IO and args == (str,)):
+        if not isinstance(value, TextIOBase):
+            raise TypeCheckError("is not a text based I/O object")
+    elif origin_type is BinaryIO or (origin_type is IO and args == (bytes,)):
+        if not isinstance(value, (RawIOBase, BufferedIOBase)):
+            raise TypeCheckError("is not a binary I/O object")
+    elif not isinstance(value, IOBase):
+        raise TypeCheckError("is not an I/O object")
+
+
+def check_protocol(
+    value: Any,
+    origin_type: Any,
+    args: tuple[Any, ...],
+    memo: TypeCheckMemo,
+) -> None:
+    # TODO: implement proper compatibility checking and support non-runtime protocols
+    if getattr(origin_type, "_is_runtime_protocol", False):
+        if not isinstance(value, origin_type):
+            raise TypeCheckError(
+                f"is not compatible with the {origin_type.__qualname__} protocol"
+            )
+    else:
+        warnings.warn(
+            f"Typeguard cannot check the {origin_type.__qualname__} protocol because "
+            f"it is a non-runtime protocol. If you would like to type check this "
+            f"protocol, please use @typing.runtime_checkable",
+            stacklevel=get_stacklevel(),
+        )
+
+
+def check_byteslike(
+    value: Any,
+    origin_type: Any,
+    args: tuple[Any, ...],
+    memo: TypeCheckMemo,
+) -> None:
+    if not isinstance(value, (bytearray, bytes, memoryview)):
+        raise TypeCheckError("is not bytes-like")
+
+
+def check_self(
+    value: Any,
+    origin_type: Any,
+    args: tuple[Any, ...],
+    memo: TypeCheckMemo,
+) -> None:
+    if memo.self_type is None:
+        raise TypeCheckError("cannot be checked against Self outside of a method call")
+
+    if isclass(value):
+        if not issubclass(value, memo.self_type):
+            raise TypeCheckError(
+                f"is not an instance of the self type "
+                f"({qualified_name(memo.self_type)})"
+            )
+    elif not isinstance(value, memo.self_type):
+        raise TypeCheckError(
+            f"is not an instance of the self type ({qualified_name(memo.self_type)})"
+        )
+
+
+def check_paramspec(
+    value: Any,
+    origin_type: Any,
+    args: tuple[Any, ...],
+    memo: TypeCheckMemo,
+) -> None:
+    pass  # No-op for now
+
+
+def check_instanceof(
+    value: Any,
+    origin_type: Any,
+    args: tuple[Any, ...],
+    memo: TypeCheckMemo,
+) -> None:
+    if not isinstance(value, origin_type):
+        raise TypeCheckError(f"is not an instance of {qualified_name(origin_type)}")
+
+
+def check_type_internal(
+    value: Any,
+    annotation: Any,
+    memo: TypeCheckMemo,
+) -> None:
+    """
+    Check that the given object is compatible with the given type annotation.
+
+    This function should only be used by type checker callables. Applications should use
+    :func:`~.check_type` instead.
+
+    :param value: the value to check
+    :param annotation: the type annotation to check against
+    :param memo: a memo object containing configuration and information necessary for
+        looking up forward references
+    """
+
+    if isinstance(annotation, ForwardRef):
+        try:
+            annotation = evaluate_forwardref(annotation, memo)
+        except NameError:
+            if memo.config.forward_ref_policy is ForwardRefPolicy.ERROR:
+                raise
+            elif memo.config.forward_ref_policy is ForwardRefPolicy.WARN:
+                warnings.warn(
+                    f"Cannot resolve forward reference {annotation.__forward_arg__!r}",
+                    TypeHintWarning,
+                    stacklevel=get_stacklevel(),
+                )
+
+            return
+
+    if annotation is Any or annotation is SubclassableAny or isinstance(value, Mock):
+        return
+
+    # Skip type checks if value is an instance of a class that inherits from Any
+    if not isclass(value) and SubclassableAny in type(value).__bases__:
+        return
+
+    extras: tuple[Any, ...]
+    origin_type = get_origin(annotation)
+    if origin_type is Annotated:
+        annotation, *extras_ = get_args(annotation)
+        extras = tuple(extras_)
+        origin_type = get_origin(annotation)
+    else:
+        extras = ()
+
+    if origin_type is not None:
+        args = get_args(annotation)
+
+        # Compatibility hack to distinguish between unparametrized and empty tuple
+        # (tuple[()]), necessary due to https://github.com/python/cpython/issues/91137
+        if origin_type in (tuple, Tuple) and annotation is not Tuple and not args:
+            args = ((),)
+    else:
+        origin_type = annotation
+        args = ()
+
+    for lookup_func in checker_lookup_functions:
+        checker = lookup_func(origin_type, args, extras)
+        if checker:
+            checker(value, origin_type, args, memo)
+            return
+
+    if isclass(origin_type):
+        if not isinstance(value, origin_type):
+            raise TypeCheckError(f"is not an instance of {qualified_name(origin_type)}")
+    elif type(origin_type) is str:  # noqa: E721
+        warnings.warn(
+            f"Skipping type check against {origin_type!r}; this looks like a "
+            f"string-form forward reference imported from another module",
+            TypeHintWarning,
+            stacklevel=get_stacklevel(),
+        )
+
+
+# Equality checks are applied to these
+origin_type_checkers = {
+    bytes: check_byteslike,
+    AbstractSet: check_set,
+    BinaryIO: check_io,
+    Callable: check_callable,
+    collections.abc.Callable: check_callable,
+    complex: check_number,
+    dict: check_mapping,
+    Dict: check_mapping,
+    float: check_number,
+    frozenset: check_set,
+    IO: check_io,
+    list: check_list,
+    List: check_list,
+    typing.Literal: check_literal,
+    Mapping: check_mapping,
+    MutableMapping: check_mapping,
+    None: check_none,
+    collections.abc.Mapping: check_mapping,
+    collections.abc.MutableMapping: check_mapping,
+    Sequence: check_sequence,
+    collections.abc.Sequence: check_sequence,
+    collections.abc.Set: check_set,
+    set: check_set,
+    Set: check_set,
+    TextIO: check_io,
+    tuple: check_tuple,
+    Tuple: check_tuple,
+    type: check_class,
+    Type: check_class,
+    Union: check_union,
+}
+if sys.version_info >= (3, 10):
+    origin_type_checkers[types.UnionType] = check_uniontype
+    origin_type_checkers[typing.TypeGuard] = check_typeguard
+if sys.version_info >= (3, 11):
+    origin_type_checkers.update(
+        {typing.LiteralString: check_literal_string, typing.Self: check_self}
+    )
+if typing_extensions is not None:
+    # On some Python versions, these may simply be re-exports from typing,
+    # but exactly which Python versions is subject to change,
+    # so it's best to err on the safe side
+    # and update the dictionary on all Python versions
+    # if typing_extensions is installed
+    origin_type_checkers[typing_extensions.Literal] = check_literal
+    origin_type_checkers[typing_extensions.LiteralString] = check_literal_string
+    origin_type_checkers[typing_extensions.Self] = check_self
+    origin_type_checkers[typing_extensions.TypeGuard] = check_typeguard
+
+
+def builtin_checker_lookup(
+    origin_type: Any, args: tuple[Any, ...], extras: tuple[Any, ...]
+) -> TypeCheckerCallable | None:
+    checker = origin_type_checkers.get(origin_type)
+    if checker is not None:
+        return checker
+    elif is_typeddict(origin_type):
+        return check_typed_dict
+    elif isclass(origin_type) and issubclass(
+        origin_type, Tuple  # type: ignore[arg-type]
+    ):
+        # NamedTuple
+        return check_tuple
+    elif getattr(origin_type, "_is_protocol", False):
+        return check_protocol
+    elif isinstance(origin_type, ParamSpec):
+        return check_paramspec
+    elif isinstance(origin_type, TypeVar):
+        return check_typevar
+    elif origin_type.__class__ is NewType:
+        # typing.NewType on Python 3.10+
+        return check_newtype
+    elif (
+        isfunction(origin_type)
+        and getattr(origin_type, "__module__", None) == "typing"
+        and getattr(origin_type, "__qualname__", "").startswith("NewType.")
+        and hasattr(origin_type, "__supertype__")
+    ):
+        # typing.NewType on Python 3.9 and below
+        return check_newtype
+
+    return None
+
+
+checker_lookup_functions.append(builtin_checker_lookup)
+
+
+def load_plugins() -> None:
+    """
+    Load all type checker lookup functions from entry points.
+
+    All entry points from the ``typeguard.checker_lookup`` group are loaded, and the
+    returned lookup functions are added to :data:`typeguard.checker_lookup_functions`.
+
+    .. note:: This function is called implicitly on import, unless the
+        ``TYPEGUARD_DISABLE_PLUGIN_AUTOLOAD`` environment variable is present.
+    """
+
+    for ep in entry_points(group="typeguard.checker_lookup"):
+        try:
+            plugin = ep.load()
+        except Exception as exc:
+            warnings.warn(
+                f"Failed to load plugin {ep.name!r}: " f"{qualified_name(exc)}: {exc}",
+                stacklevel=2,
+            )
+            continue
+
+        if not callable(plugin):
+            warnings.warn(
+                f"Plugin {ep} returned a non-callable object: {plugin!r}", stacklevel=2
+            )
+            continue
+
+        checker_lookup_functions.insert(0, plugin)
diff --git a/lib/typeguard/_config.py b/lib/typeguard/_config.py
new file mode 100644
index 00000000..36efad53
--- /dev/null
+++ b/lib/typeguard/_config.py
@@ -0,0 +1,108 @@
+from __future__ import annotations
+
+from collections.abc import Iterable
+from dataclasses import dataclass
+from enum import Enum, auto
+from typing import TYPE_CHECKING, TypeVar
+
+if TYPE_CHECKING:
+    from ._functions import TypeCheckFailCallback
+
+T = TypeVar("T")
+
+
+class ForwardRefPolicy(Enum):
+    """
+    Defines how unresolved forward references are handled.
+
+    Members:
+
+    * ``ERROR``: propagate the :exc:`NameError` when the forward reference lookup fails
+    * ``WARN``: emit a :class:`~.TypeHintWarning` if the forward reference lookup fails
+    * ``IGNORE``: silently skip checks for unresolveable forward references
+    """
+
+    ERROR = auto()
+    WARN = auto()
+    IGNORE = auto()
+
+
+class CollectionCheckStrategy(Enum):
+    """
+    Specifies how thoroughly the contents of collections are type checked.
+
+    This has an effect on the following built-in checkers:
+
+    * ``AbstractSet``
+    * ``Dict``
+    * ``List``
+    * ``Mapping``
+    * ``Set``
+    * ``Tuple[<type>, ...]`` (arbitrarily sized tuples)
+
+    Members:
+
+    * ``FIRST_ITEM``: check only the first item
+    * ``ALL_ITEMS``: check all items
+    """
+
+    FIRST_ITEM = auto()
+    ALL_ITEMS = auto()
+
+    def iterate_samples(self, collection: Iterable[T]) -> Iterable[T]:
+        if self is CollectionCheckStrategy.FIRST_ITEM:
+            try:
+                return [next(iter(collection))]
+            except StopIteration:
+                return ()
+        else:
+            return collection
+
+
+@dataclass
+class TypeCheckConfiguration:
+    """
+     You can change Typeguard's behavior with these settings.
+
+    .. attribute:: typecheck_fail_callback
+       :type: Callable[[TypeCheckError, TypeCheckMemo], Any]
+
+         Callable that is called when type checking fails.
+
+         Default: ``None`` (the :exc:`~.TypeCheckError` is raised directly)
+
+    .. attribute:: forward_ref_policy
+       :type: ForwardRefPolicy
+
+         Specifies what to do when a forward reference fails to resolve.
+
+         Default: ``WARN``
+
+    .. attribute:: collection_check_strategy
+       :type: CollectionCheckStrategy
+
+         Specifies how thoroughly the contents of collections (list, dict, etc.) are
+         type checked.
+
+         Default: ``FIRST_ITEM``
+
+    .. attribute:: debug_instrumentation
+       :type: bool
+
+         If set to ``True``, the code of modules or functions instrumented by typeguard
+         is printed to ``sys.stderr`` after the instrumentation is done
+
+         Requires Python 3.9 or newer.
+
+         Default: ``False``
+    """
+
+    forward_ref_policy: ForwardRefPolicy = ForwardRefPolicy.WARN
+    typecheck_fail_callback: TypeCheckFailCallback | None = None
+    collection_check_strategy: CollectionCheckStrategy = (
+        CollectionCheckStrategy.FIRST_ITEM
+    )
+    debug_instrumentation: bool = False
+
+
+global_config = TypeCheckConfiguration()
diff --git a/lib/typeguard/_decorators.py b/lib/typeguard/_decorators.py
new file mode 100644
index 00000000..cf325335
--- /dev/null
+++ b/lib/typeguard/_decorators.py
@@ -0,0 +1,235 @@
+from __future__ import annotations
+
+import ast
+import inspect
+import sys
+from collections.abc import Sequence
+from functools import partial
+from inspect import isclass, isfunction
+from types import CodeType, FrameType, FunctionType
+from typing import TYPE_CHECKING, Any, Callable, ForwardRef, TypeVar, cast, overload
+from warnings import warn
+
+from ._config import CollectionCheckStrategy, ForwardRefPolicy, global_config
+from ._exceptions import InstrumentationWarning
+from ._functions import TypeCheckFailCallback
+from ._transformer import TypeguardTransformer
+from ._utils import Unset, function_name, get_stacklevel, is_method_of, unset
+
+if TYPE_CHECKING:
+    from typeshed.stdlib.types import _Cell
+
+    _F = TypeVar("_F")
+
+    def typeguard_ignore(f: _F) -> _F:
+        """This decorator is a noop during static type-checking."""
+        return f
+
+else:
+    from typing import no_type_check as typeguard_ignore  # noqa: F401
+
+T_CallableOrType = TypeVar("T_CallableOrType", bound=Callable[..., Any])
+
+
+def make_cell(value: object) -> _Cell:
+    return (lambda: value).__closure__[0]  # type: ignore[index]
+
+
+def find_target_function(
+    new_code: CodeType, target_path: Sequence[str], firstlineno: int
+) -> CodeType | None:
+    target_name = target_path[0]
+    for const in new_code.co_consts:
+        if isinstance(const, CodeType):
+            if const.co_name == target_name:
+                if const.co_firstlineno == firstlineno:
+                    return const
+                elif len(target_path) > 1:
+                    target_code = find_target_function(
+                        const, target_path[1:], firstlineno
+                    )
+                    if target_code:
+                        return target_code
+
+    return None
+
+
+def instrument(f: T_CallableOrType) -> FunctionType | str:
+    if not getattr(f, "__code__", None):
+        return "no code associated"
+    elif not getattr(f, "__module__", None):
+        return "__module__ attribute is not set"
+    elif f.__code__.co_filename == "<stdin>":
+        return "cannot instrument functions defined in a REPL"
+    elif hasattr(f, "__wrapped__"):
+        return (
+            "@typechecked only supports instrumenting functions wrapped with "
+            "@classmethod, @staticmethod or @property"
+        )
+
+    target_path = [item for item in f.__qualname__.split(".") if item != "<locals>"]
+    module_source = inspect.getsource(sys.modules[f.__module__])
+    module_ast = ast.parse(module_source)
+    instrumentor = TypeguardTransformer(target_path, f.__code__.co_firstlineno)
+    instrumentor.visit(module_ast)
+
+    if not instrumentor.target_node or instrumentor.target_lineno is None:
+        return "instrumentor did not find the target function"
+
+    module_code = compile(module_ast, f.__code__.co_filename, "exec", dont_inherit=True)
+    new_code = find_target_function(
+        module_code, target_path, instrumentor.target_lineno
+    )
+    if not new_code:
+        return "cannot find the target function in the AST"
+
+    if global_config.debug_instrumentation and sys.version_info >= (3, 9):
+        # Find the matching AST node, then unparse it to source and print to stdout
+        print(
+            f"Source code of {f.__qualname__}() after instrumentation:"
+            "\n----------------------------------------------",
+            file=sys.stderr,
+        )
+        print(ast.unparse(instrumentor.target_node), file=sys.stderr)
+        print(
+            "----------------------------------------------",
+            file=sys.stderr,
+        )
+
+    closure = f.__closure__
+    if new_code.co_freevars != f.__code__.co_freevars:
+        # Create a new closure and find values for the new free variables
+        frame = cast(FrameType, inspect.currentframe())
+        frame = cast(FrameType, frame.f_back)
+        frame_locals = cast(FrameType, frame.f_back).f_locals
+        cells: list[_Cell] = []
+        for key in new_code.co_freevars:
+            if key in instrumentor.names_used_in_annotations:
+                # Find the value and make a new cell from it
+                value = frame_locals.get(key) or ForwardRef(key)
+                cells.append(make_cell(value))
+            else:
+                # Reuse the cell from the existing closure
+                assert f.__closure__
+                cells.append(f.__closure__[f.__code__.co_freevars.index(key)])
+
+        closure = tuple(cells)
+
+    new_function = FunctionType(new_code, f.__globals__, f.__name__, closure=closure)
+    new_function.__module__ = f.__module__
+    new_function.__name__ = f.__name__
+    new_function.__qualname__ = f.__qualname__
+    new_function.__annotations__ = f.__annotations__
+    new_function.__doc__ = f.__doc__
+    new_function.__defaults__ = f.__defaults__
+    new_function.__kwdefaults__ = f.__kwdefaults__
+    return new_function
+
+
+@overload
+def typechecked(
+    *,
+    forward_ref_policy: ForwardRefPolicy | Unset = unset,
+    typecheck_fail_callback: TypeCheckFailCallback | Unset = unset,
+    collection_check_strategy: CollectionCheckStrategy | Unset = unset,
+    debug_instrumentation: bool | Unset = unset,
+) -> Callable[[T_CallableOrType], T_CallableOrType]: ...
+
+
+@overload
+def typechecked(target: T_CallableOrType) -> T_CallableOrType: ...
+
+
+def typechecked(
+    target: T_CallableOrType | None = None,
+    *,
+    forward_ref_policy: ForwardRefPolicy | Unset = unset,
+    typecheck_fail_callback: TypeCheckFailCallback | Unset = unset,
+    collection_check_strategy: CollectionCheckStrategy | Unset = unset,
+    debug_instrumentation: bool | Unset = unset,
+) -> Any:
+    """
+    Instrument the target function to perform run-time type checking.
+
+    This decorator recompiles the target function, injecting code to type check
+    arguments, return values, yield values (excluding ``yield from``) and assignments to
+    annotated local variables.
+
+    This can also be used as a class decorator. This will instrument all type annotated
+    methods, including :func:`@classmethod <classmethod>`,
+    :func:`@staticmethod <staticmethod>`,  and :class:`@property <property>` decorated
+    methods in the class.
+
+    .. note:: When Python is run in optimized mode (``-O`` or ``-OO``, this decorator
+        is a no-op). This is a feature meant for selectively introducing type checking
+        into a code base where the checks aren't meant to be run in production.
+
+    :param target: the function or class to enable type checking for
+    :param forward_ref_policy: override for
+        :attr:`.TypeCheckConfiguration.forward_ref_policy`
+    :param typecheck_fail_callback: override for
+        :attr:`.TypeCheckConfiguration.typecheck_fail_callback`
+    :param collection_check_strategy: override for
+        :attr:`.TypeCheckConfiguration.collection_check_strategy`
+    :param debug_instrumentation: override for
+        :attr:`.TypeCheckConfiguration.debug_instrumentation`
+
+    """
+    if target is None:
+        return partial(
+            typechecked,
+            forward_ref_policy=forward_ref_policy,
+            typecheck_fail_callback=typecheck_fail_callback,
+            collection_check_strategy=collection_check_strategy,
+            debug_instrumentation=debug_instrumentation,
+        )
+
+    if not __debug__:
+        return target
+
+    if isclass(target):
+        for key, attr in target.__dict__.items():
+            if is_method_of(attr, target):
+                retval = instrument(attr)
+                if isfunction(retval):
+                    setattr(target, key, retval)
+            elif isinstance(attr, (classmethod, staticmethod)):
+                if is_method_of(attr.__func__, target):
+                    retval = instrument(attr.__func__)
+                    if isfunction(retval):
+                        wrapper = attr.__class__(retval)
+                        setattr(target, key, wrapper)
+            elif isinstance(attr, property):
+                kwargs: dict[str, Any] = dict(doc=attr.__doc__)
+                for name in ("fset", "fget", "fdel"):
+                    property_func = kwargs[name] = getattr(attr, name)
+                    if is_method_of(property_func, target):
+                        retval = instrument(property_func)
+                        if isfunction(retval):
+                            kwargs[name] = retval
+
+                setattr(target, key, attr.__class__(**kwargs))
+
+        return target
+
+    # Find either the first Python wrapper or the actual function
+    wrapper_class: (
+        type[classmethod[Any, Any, Any]] | type[staticmethod[Any, Any]] | None
+    ) = None
+    if isinstance(target, (classmethod, staticmethod)):
+        wrapper_class = target.__class__
+        target = target.__func__
+
+    retval = instrument(target)
+    if isinstance(retval, str):
+        warn(
+            f"{retval} -- not typechecking {function_name(target)}",
+            InstrumentationWarning,
+            stacklevel=get_stacklevel(),
+        )
+        return target
+
+    if wrapper_class is None:
+        return retval
+    else:
+        return wrapper_class(retval)
diff --git a/lib/typeguard/_exceptions.py b/lib/typeguard/_exceptions.py
new file mode 100644
index 00000000..625437a6
--- /dev/null
+++ b/lib/typeguard/_exceptions.py
@@ -0,0 +1,42 @@
+from collections import deque
+from typing import Deque
+
+
+class TypeHintWarning(UserWarning):
+    """
+    A warning that is emitted when a type hint in string form could not be resolved to
+    an actual type.
+    """
+
+
+class TypeCheckWarning(UserWarning):
+    """Emitted by typeguard's type checkers when a type mismatch is detected."""
+
+    def __init__(self, message: str):
+        super().__init__(message)
+
+
+class InstrumentationWarning(UserWarning):
+    """Emitted when there's a problem with instrumenting a function for type checks."""
+
+    def __init__(self, message: str):
+        super().__init__(message)
+
+
+class TypeCheckError(Exception):
+    """
+    Raised by typeguard's type checkers when a type mismatch is detected.
+    """
+
+    def __init__(self, message: str):
+        super().__init__(message)
+        self._path: Deque[str] = deque()
+
+    def append_path_element(self, element: str) -> None:
+        self._path.append(element)
+
+    def __str__(self) -> str:
+        if self._path:
+            return " of ".join(self._path) + " " + str(self.args[0])
+        else:
+            return str(self.args[0])
diff --git a/lib/typeguard/_functions.py b/lib/typeguard/_functions.py
new file mode 100644
index 00000000..28497856
--- /dev/null
+++ b/lib/typeguard/_functions.py
@@ -0,0 +1,308 @@
+from __future__ import annotations
+
+import sys
+import warnings
+from typing import Any, Callable, NoReturn, TypeVar, Union, overload
+
+from . import _suppression
+from ._checkers import BINARY_MAGIC_METHODS, check_type_internal
+from ._config import (
+    CollectionCheckStrategy,
+    ForwardRefPolicy,
+    TypeCheckConfiguration,
+)
+from ._exceptions import TypeCheckError, TypeCheckWarning
+from ._memo import TypeCheckMemo
+from ._utils import get_stacklevel, qualified_name
+
+if sys.version_info >= (3, 11):
+    from typing import Literal, Never, TypeAlias
+else:
+    from typing_extensions import Literal, Never, TypeAlias
+
+T = TypeVar("T")
+TypeCheckFailCallback: TypeAlias = Callable[[TypeCheckError, TypeCheckMemo], Any]
+
+
+@overload
+def check_type(
+    value: object,
+    expected_type: type[T],
+    *,
+    forward_ref_policy: ForwardRefPolicy = ...,
+    typecheck_fail_callback: TypeCheckFailCallback | None = ...,
+    collection_check_strategy: CollectionCheckStrategy = ...,
+) -> T: ...
+
+
+@overload
+def check_type(
+    value: object,
+    expected_type: Any,
+    *,
+    forward_ref_policy: ForwardRefPolicy = ...,
+    typecheck_fail_callback: TypeCheckFailCallback | None = ...,
+    collection_check_strategy: CollectionCheckStrategy = ...,
+) -> Any: ...
+
+
+def check_type(
+    value: object,
+    expected_type: Any,
+    *,
+    forward_ref_policy: ForwardRefPolicy = TypeCheckConfiguration().forward_ref_policy,
+    typecheck_fail_callback: TypeCheckFailCallback | None = (
+        TypeCheckConfiguration().typecheck_fail_callback
+    ),
+    collection_check_strategy: CollectionCheckStrategy = (
+        TypeCheckConfiguration().collection_check_strategy
+    ),
+) -> Any:
+    """
+    Ensure that ``value`` matches ``expected_type``.
+
+    The types from the :mod:`typing` module do not support :func:`isinstance` or
+    :func:`issubclass` so a number of type specific checks are required. This function
+    knows which checker to call for which type.
+
+    This function wraps :func:`~.check_type_internal` in the following ways:
+
+    * Respects type checking suppression (:func:`~.suppress_type_checks`)
+    * Forms a :class:`~.TypeCheckMemo` from the current stack frame
+    * Calls the configured type check fail callback if the check fails
+
+    Note that this function is independent of the globally shared configuration in
+    :data:`typeguard.config`. This means that usage within libraries is safe from being
+    affected configuration changes made by other libraries or by the integrating
+    application. Instead, configuration options have the same default values as their
+    corresponding fields in :class:`TypeCheckConfiguration`.
+
+    :param value: value to be checked against ``expected_type``
+    :param expected_type: a class or generic type instance, or a tuple of such things
+    :param forward_ref_policy: see :attr:`TypeCheckConfiguration.forward_ref_policy`
+    :param typecheck_fail_callback:
+        see :attr`TypeCheckConfiguration.typecheck_fail_callback`
+    :param collection_check_strategy:
+        see :attr:`TypeCheckConfiguration.collection_check_strategy`
+    :return: ``value``, unmodified
+    :raises TypeCheckError: if there is a type mismatch
+
+    """
+    if type(expected_type) is tuple:
+        expected_type = Union[expected_type]
+
+    config = TypeCheckConfiguration(
+        forward_ref_policy=forward_ref_policy,
+        typecheck_fail_callback=typecheck_fail_callback,
+        collection_check_strategy=collection_check_strategy,
+    )
+
+    if _suppression.type_checks_suppressed or expected_type is Any:
+        return value
+
+    frame = sys._getframe(1)
+    memo = TypeCheckMemo(frame.f_globals, frame.f_locals, config=config)
+    try:
+        check_type_internal(value, expected_type, memo)
+    except TypeCheckError as exc:
+        exc.append_path_element(qualified_name(value, add_class_prefix=True))
+        if config.typecheck_fail_callback:
+            config.typecheck_fail_callback(exc, memo)
+        else:
+            raise
+
+    return value
+
+
+def check_argument_types(
+    func_name: str,
+    arguments: dict[str, tuple[Any, Any]],
+    memo: TypeCheckMemo,
+) -> Literal[True]:
+    if _suppression.type_checks_suppressed:
+        return True
+
+    for argname, (value, annotation) in arguments.items():
+        if annotation is NoReturn or annotation is Never:
+            exc = TypeCheckError(
+                f"{func_name}() was declared never to be called but it was"
+            )
+            if memo.config.typecheck_fail_callback:
+                memo.config.typecheck_fail_callback(exc, memo)
+            else:
+                raise exc
+
+        try:
+            check_type_internal(value, annotation, memo)
+        except TypeCheckError as exc:
+            qualname = qualified_name(value, add_class_prefix=True)
+            exc.append_path_element(f'argument "{argname}" ({qualname})')
+            if memo.config.typecheck_fail_callback:
+                memo.config.typecheck_fail_callback(exc, memo)
+            else:
+                raise
+
+    return True
+
+
+def check_return_type(
+    func_name: str,
+    retval: T,
+    annotation: Any,
+    memo: TypeCheckMemo,
+) -> T:
+    if _suppression.type_checks_suppressed:
+        return retval
+
+    if annotation is NoReturn or annotation is Never:
+        exc = TypeCheckError(f"{func_name}() was declared never to return but it did")
+        if memo.config.typecheck_fail_callback:
+            memo.config.typecheck_fail_callback(exc, memo)
+        else:
+            raise exc
+
+    try:
+        check_type_internal(retval, annotation, memo)
+    except TypeCheckError as exc:
+        # Allow NotImplemented if this is a binary magic method (__eq__() et al)
+        if retval is NotImplemented and annotation is bool:
+            # This does (and cannot) not check if it's actually a method
+            func_name = func_name.rsplit(".", 1)[-1]
+            if func_name in BINARY_MAGIC_METHODS:
+                return retval
+
+        qualname = qualified_name(retval, add_class_prefix=True)
+        exc.append_path_element(f"the return value ({qualname})")
+        if memo.config.typecheck_fail_callback:
+            memo.config.typecheck_fail_callback(exc, memo)
+        else:
+            raise
+
+    return retval
+
+
+def check_send_type(
+    func_name: str,
+    sendval: T,
+    annotation: Any,
+    memo: TypeCheckMemo,
+) -> T:
+    if _suppression.type_checks_suppressed:
+        return sendval
+
+    if annotation is NoReturn or annotation is Never:
+        exc = TypeCheckError(
+            f"{func_name}() was declared never to be sent a value to but it was"
+        )
+        if memo.config.typecheck_fail_callback:
+            memo.config.typecheck_fail_callback(exc, memo)
+        else:
+            raise exc
+
+    try:
+        check_type_internal(sendval, annotation, memo)
+    except TypeCheckError as exc:
+        qualname = qualified_name(sendval, add_class_prefix=True)
+        exc.append_path_element(f"the value sent to generator ({qualname})")
+        if memo.config.typecheck_fail_callback:
+            memo.config.typecheck_fail_callback(exc, memo)
+        else:
+            raise
+
+    return sendval
+
+
+def check_yield_type(
+    func_name: str,
+    yieldval: T,
+    annotation: Any,
+    memo: TypeCheckMemo,
+) -> T:
+    if _suppression.type_checks_suppressed:
+        return yieldval
+
+    if annotation is NoReturn or annotation is Never:
+        exc = TypeCheckError(f"{func_name}() was declared never to yield but it did")
+        if memo.config.typecheck_fail_callback:
+            memo.config.typecheck_fail_callback(exc, memo)
+        else:
+            raise exc
+
+    try:
+        check_type_internal(yieldval, annotation, memo)
+    except TypeCheckError as exc:
+        qualname = qualified_name(yieldval, add_class_prefix=True)
+        exc.append_path_element(f"the yielded value ({qualname})")
+        if memo.config.typecheck_fail_callback:
+            memo.config.typecheck_fail_callback(exc, memo)
+        else:
+            raise
+
+    return yieldval
+
+
+def check_variable_assignment(
+    value: object, varname: str, annotation: Any, memo: TypeCheckMemo
+) -> Any:
+    if _suppression.type_checks_suppressed:
+        return value
+
+    try:
+        check_type_internal(value, annotation, memo)
+    except TypeCheckError as exc:
+        qualname = qualified_name(value, add_class_prefix=True)
+        exc.append_path_element(f"value assigned to {varname} ({qualname})")
+        if memo.config.typecheck_fail_callback:
+            memo.config.typecheck_fail_callback(exc, memo)
+        else:
+            raise
+
+    return value
+
+
+def check_multi_variable_assignment(
+    value: Any, targets: list[dict[str, Any]], memo: TypeCheckMemo
+) -> Any:
+    if max(len(target) for target in targets) == 1:
+        iterated_values = [value]
+    else:
+        iterated_values = list(value)
+
+    if not _suppression.type_checks_suppressed:
+        for expected_types in targets:
+            value_index = 0
+            for ann_index, (varname, expected_type) in enumerate(
+                expected_types.items()
+            ):
+                if varname.startswith("*"):
+                    varname = varname[1:]
+                    keys_left = len(expected_types) - 1 - ann_index
+                    next_value_index = len(iterated_values) - keys_left
+                    obj: object = iterated_values[value_index:next_value_index]
+                    value_index = next_value_index
+                else:
+                    obj = iterated_values[value_index]
+                    value_index += 1
+
+                try:
+                    check_type_internal(obj, expected_type, memo)
+                except TypeCheckError as exc:
+                    qualname = qualified_name(obj, add_class_prefix=True)
+                    exc.append_path_element(f"value assigned to {varname} ({qualname})")
+                    if memo.config.typecheck_fail_callback:
+                        memo.config.typecheck_fail_callback(exc, memo)
+                    else:
+                        raise
+
+    return iterated_values[0] if len(iterated_values) == 1 else iterated_values
+
+
+def warn_on_error(exc: TypeCheckError, memo: TypeCheckMemo) -> None:
+    """
+    Emit a warning on a type mismatch.
+
+    This is intended to be used as an error handler in
+    :attr:`TypeCheckConfiguration.typecheck_fail_callback`.
+
+    """
+    warnings.warn(TypeCheckWarning(str(exc)), stacklevel=get_stacklevel())
diff --git a/lib/typeguard/_importhook.py b/lib/typeguard/_importhook.py
new file mode 100644
index 00000000..8590540a
--- /dev/null
+++ b/lib/typeguard/_importhook.py
@@ -0,0 +1,213 @@
+from __future__ import annotations
+
+import ast
+import sys
+import types
+from collections.abc import Callable, Iterable
+from importlib.abc import MetaPathFinder
+from importlib.machinery import ModuleSpec, SourceFileLoader
+from importlib.util import cache_from_source, decode_source
+from inspect import isclass
+from os import PathLike
+from types import CodeType, ModuleType, TracebackType
+from typing import Sequence, TypeVar
+from unittest.mock import patch
+
+from ._config import global_config
+from ._transformer import TypeguardTransformer
+
+if sys.version_info >= (3, 12):
+    from collections.abc import Buffer
+else:
+    from typing_extensions import Buffer
+
+if sys.version_info >= (3, 11):
+    from typing import ParamSpec
+else:
+    from typing_extensions import ParamSpec
+
+if sys.version_info >= (3, 10):
+    from importlib.metadata import PackageNotFoundError, version
+else:
+    from importlib_metadata import PackageNotFoundError, version
+
+try:
+    OPTIMIZATION = "typeguard" + "".join(version("typeguard").split(".")[:3])
+except PackageNotFoundError:
+    OPTIMIZATION = "typeguard"
+
+P = ParamSpec("P")
+T = TypeVar("T")
+
+
+# The name of this function is magical
+def _call_with_frames_removed(
+    f: Callable[P, T], *args: P.args, **kwargs: P.kwargs
+) -> T:
+    return f(*args, **kwargs)
+
+
+def optimized_cache_from_source(path: str, debug_override: bool | None = None) -> str:
+    return cache_from_source(path, debug_override, optimization=OPTIMIZATION)
+
+
+class TypeguardLoader(SourceFileLoader):
+    @staticmethod
+    def source_to_code(
+        data: Buffer | str | ast.Module | ast.Expression | ast.Interactive,
+        path: Buffer | str | PathLike[str] = "<string>",
+    ) -> CodeType:
+        if isinstance(data, (ast.Module, ast.Expression, ast.Interactive)):
+            tree = data
+        else:
+            if isinstance(data, str):
+                source = data
+            else:
+                source = decode_source(data)
+
+            tree = _call_with_frames_removed(
+                ast.parse,
+                source,
+                path,
+                "exec",
+            )
+
+        tree = TypeguardTransformer().visit(tree)
+        ast.fix_missing_locations(tree)
+
+        if global_config.debug_instrumentation and sys.version_info >= (3, 9):
+            print(
+                f"Source code of {path!r} after instrumentation:\n"
+                "----------------------------------------------",
+                file=sys.stderr,
+            )
+            print(ast.unparse(tree), file=sys.stderr)
+            print("----------------------------------------------", file=sys.stderr)
+
+        return _call_with_frames_removed(
+            compile, tree, path, "exec", 0, dont_inherit=True
+        )
+
+    def exec_module(self, module: ModuleType) -> None:
+        # Use a custom optimization marker – the import lock should make this monkey
+        # patch safe
+        with patch(
+            "importlib._bootstrap_external.cache_from_source",
+            optimized_cache_from_source,
+        ):
+            super().exec_module(module)
+
+
+class TypeguardFinder(MetaPathFinder):
+    """
+    Wraps another path finder and instruments the module with
+    :func:`@typechecked <typeguard.typechecked>` if :meth:`should_instrument` returns
+    ``True``.
+
+    Should not be used directly, but rather via :func:`~.install_import_hook`.
+
+    .. versionadded:: 2.6
+    """
+
+    def __init__(self, packages: list[str] | None, original_pathfinder: MetaPathFinder):
+        self.packages = packages
+        self._original_pathfinder = original_pathfinder
+
+    def find_spec(
+        self,
+        fullname: str,
+        path: Sequence[str] | None,
+        target: types.ModuleType | None = None,
+    ) -> ModuleSpec | None:
+        if self.should_instrument(fullname):
+            spec = self._original_pathfinder.find_spec(fullname, path, target)
+            if spec is not None and isinstance(spec.loader, SourceFileLoader):
+                spec.loader = TypeguardLoader(spec.loader.name, spec.loader.path)
+                return spec
+
+        return None
+
+    def should_instrument(self, module_name: str) -> bool:
+        """
+        Determine whether the module with the given name should be instrumented.
+
+        :param module_name: full name of the module that is about to be imported (e.g.
+            ``xyz.abc``)
+
+        """
+        if self.packages is None:
+            return True
+
+        for package in self.packages:
+            if module_name == package or module_name.startswith(package + "."):
+                return True
+
+        return False
+
+
+class ImportHookManager:
+    """
+    A handle that can be used to uninstall the Typeguard import hook.
+    """
+
+    def __init__(self, hook: MetaPathFinder):
+        self.hook = hook
+
+    def __enter__(self) -> None:
+        pass
+
+    def __exit__(
+        self,
+        exc_type: type[BaseException],
+        exc_val: BaseException,
+        exc_tb: TracebackType,
+    ) -> None:
+        self.uninstall()
+
+    def uninstall(self) -> None:
+        """Uninstall the import hook."""
+        try:
+            sys.meta_path.remove(self.hook)
+        except ValueError:
+            pass  # already removed
+
+
+def install_import_hook(
+    packages: Iterable[str] | None = None,
+    *,
+    cls: type[TypeguardFinder] = TypeguardFinder,
+) -> ImportHookManager:
+    """
+    Install an import hook that instruments functions for automatic type checking.
+
+    This only affects modules loaded **after** this hook has been installed.
+
+    :param packages: an iterable of package names to instrument, or ``None`` to
+        instrument all packages
+    :param cls: a custom meta path finder class
+    :return: a context manager that uninstalls the hook on exit (or when you call
+        ``.uninstall()``)
+
+    .. versionadded:: 2.6
+
+    """
+    if packages is None:
+        target_packages: list[str] | None = None
+    elif isinstance(packages, str):
+        target_packages = [packages]
+    else:
+        target_packages = list(packages)
+
+    for finder in sys.meta_path:
+        if (
+            isclass(finder)
+            and finder.__name__ == "PathFinder"
+            and hasattr(finder, "find_spec")
+        ):
+            break
+    else:
+        raise RuntimeError("Cannot find a PathFinder in sys.meta_path")
+
+    hook = cls(target_packages, finder)
+    sys.meta_path.insert(0, hook)
+    return ImportHookManager(hook)
diff --git a/lib/typeguard/_memo.py b/lib/typeguard/_memo.py
new file mode 100644
index 00000000..1d0d80c6
--- /dev/null
+++ b/lib/typeguard/_memo.py
@@ -0,0 +1,48 @@
+from __future__ import annotations
+
+from typing import Any
+
+from typeguard._config import TypeCheckConfiguration, global_config
+
+
+class TypeCheckMemo:
+    """
+    Contains information necessary for type checkers to do their work.
+
+    .. attribute:: globals
+       :type: dict[str, Any]
+
+        Dictionary of global variables to use for resolving forward references.
+
+    .. attribute:: locals
+       :type: dict[str, Any]
+
+        Dictionary of local variables to use for resolving forward references.
+
+    .. attribute:: self_type
+       :type: type | None
+
+        When running type checks within an instance method or class method, this is the
+        class object that the first argument (usually named ``self`` or ``cls``) refers
+        to.
+
+    .. attribute:: config
+       :type: TypeCheckConfiguration
+
+         Contains the configuration for a particular set of type checking operations.
+    """
+
+    __slots__ = "globals", "locals", "self_type", "config"
+
+    def __init__(
+        self,
+        globals: dict[str, Any],
+        locals: dict[str, Any],
+        *,
+        self_type: type | None = None,
+        config: TypeCheckConfiguration = global_config,
+    ):
+        self.globals = globals
+        self.locals = locals
+        self.self_type = self_type
+        self.config = config
diff --git a/lib/typeguard/_pytest_plugin.py b/lib/typeguard/_pytest_plugin.py
new file mode 100644
index 00000000..7bca9c26
--- /dev/null
+++ b/lib/typeguard/_pytest_plugin.py
@@ -0,0 +1,126 @@
+from __future__ import annotations
+
+import sys
+import warnings
+from typing import Any, Literal
+
+from pytest import Config, Parser
+
+from typeguard._config import CollectionCheckStrategy, ForwardRefPolicy, global_config
+from typeguard._exceptions import InstrumentationWarning
+from typeguard._importhook import install_import_hook
+from typeguard._utils import qualified_name, resolve_reference
+
+
+def pytest_addoption(parser: Parser) -> None:
+    def add_ini_option(
+        opt_type: (
+            Literal["string", "paths", "pathlist", "args", "linelist", "bool"] | None
+        )
+    ) -> None:
+        parser.addini(
+            group.options[-1].names()[0][2:],
+            group.options[-1].attrs()["help"],
+            opt_type,
+        )
+
+    group = parser.getgroup("typeguard")
+    group.addoption(
+        "--typeguard-packages",
+        action="store",
+        help="comma separated name list of packages and modules to instrument for "
+        "type checking, or :all: to instrument all modules loaded after typeguard",
+    )
+    add_ini_option("linelist")
+
+    group.addoption(
+        "--typeguard-debug-instrumentation",
+        action="store_true",
+        help="print all instrumented code to stderr",
+    )
+    add_ini_option("bool")
+
+    group.addoption(
+        "--typeguard-typecheck-fail-callback",
+        action="store",
+        help=(
+            "a module:varname (e.g. typeguard:warn_on_error) reference to a function "
+            "that is called (with the exception, and memo object as arguments) to "
+            "handle a TypeCheckError"
+        ),
+    )
+    add_ini_option("string")
+
+    group.addoption(
+        "--typeguard-forward-ref-policy",
+        action="store",
+        choices=list(ForwardRefPolicy.__members__),
+        help=(
+            "determines how to deal with unresolveable forward references in type "
+            "annotations"
+        ),
+    )
+    add_ini_option("string")
+
+    group.addoption(
+        "--typeguard-collection-check-strategy",
+        action="store",
+        choices=list(CollectionCheckStrategy.__members__),
+        help="determines how thoroughly to check collections (list, dict, etc)",
+    )
+    add_ini_option("string")
+
+
+def pytest_configure(config: Config) -> None:
+    def getoption(name: str) -> Any:
+        return config.getoption(name.replace("-", "_")) or config.getini(name)
+
+    packages: list[str] | None = []
+    if packages_option := config.getoption("typeguard_packages"):
+        packages = [pkg.strip() for pkg in packages_option.split(",")]
+    elif packages_ini := config.getini("typeguard-packages"):
+        packages = packages_ini
+
+    if packages:
+        if packages == [":all:"]:
+            packages = None
+        else:
+            already_imported_packages = sorted(
+                package for package in packages if package in sys.modules
+            )
+            if already_imported_packages:
+                warnings.warn(
+                    f"typeguard cannot check these packages because they are already "
+                    f"imported: {', '.join(already_imported_packages)}",
+                    InstrumentationWarning,
+                    stacklevel=1,
+                )
+
+        install_import_hook(packages=packages)
+
+    debug_option = getoption("typeguard-debug-instrumentation")
+    if debug_option:
+        global_config.debug_instrumentation = True
+
+    fail_callback_option = getoption("typeguard-typecheck-fail-callback")
+    if fail_callback_option:
+        callback = resolve_reference(fail_callback_option)
+        if not callable(callback):
+            raise TypeError(
+                f"{fail_callback_option} ({qualified_name(callback.__class__)}) is not "
+                f"a callable"
+            )
+
+        global_config.typecheck_fail_callback = callback
+
+    forward_ref_policy_option = getoption("typeguard-forward-ref-policy")
+    if forward_ref_policy_option:
+        forward_ref_policy = ForwardRefPolicy.__members__[forward_ref_policy_option]
+        global_config.forward_ref_policy = forward_ref_policy
+
+    collection_check_strategy_option = getoption("typeguard-collection-check-strategy")
+    if collection_check_strategy_option:
+        collection_check_strategy = CollectionCheckStrategy.__members__[
+            collection_check_strategy_option
+        ]
+        global_config.collection_check_strategy = collection_check_strategy
diff --git a/lib/typeguard/_suppression.py b/lib/typeguard/_suppression.py
new file mode 100644
index 00000000..f6899a9f
--- /dev/null
+++ b/lib/typeguard/_suppression.py
@@ -0,0 +1,86 @@
+from __future__ import annotations
+
+import sys
+from collections.abc import Callable, Generator
+from contextlib import contextmanager
+from functools import update_wrapper
+from threading import Lock
+from typing import ContextManager, TypeVar, overload
+
+if sys.version_info >= (3, 10):
+    from typing import ParamSpec
+else:
+    from typing_extensions import ParamSpec
+
+P = ParamSpec("P")
+T = TypeVar("T")
+
+type_checks_suppressed = 0
+type_checks_suppress_lock = Lock()
+
+
+@overload
+def suppress_type_checks(func: Callable[P, T]) -> Callable[P, T]: ...
+
+
+@overload
+def suppress_type_checks() -> ContextManager[None]: ...
+
+
+def suppress_type_checks(
+    func: Callable[P, T] | None = None
+) -> Callable[P, T] | ContextManager[None]:
+    """
+    Temporarily suppress all type checking.
+
+    This function has two operating modes, based on how it's used:
+
+    #. as a context manager (``with suppress_type_checks(): ...``)
+    #. as a decorator (``@suppress_type_checks``)
+
+    When used as a context manager, :func:`check_type` and any automatically
+    instrumented functions skip the actual type checking. These context managers can be
+    nested.
+
+    When used as a decorator, all type checking is suppressed while the function is
+    running.
+
+    Type checking will resume once no more context managers are active and no decorated
+    functions are running.
+
+    Both operating modes are thread-safe.
+
+    """
+
+    def wrapper(*args: P.args, **kwargs: P.kwargs) -> T:
+        global type_checks_suppressed
+
+        with type_checks_suppress_lock:
+            type_checks_suppressed += 1
+
+        assert func is not None
+        try:
+            return func(*args, **kwargs)
+        finally:
+            with type_checks_suppress_lock:
+                type_checks_suppressed -= 1
+
+    def cm() -> Generator[None, None, None]:
+        global type_checks_suppressed
+
+        with type_checks_suppress_lock:
+            type_checks_suppressed += 1
+
+        try:
+            yield
+        finally:
+            with type_checks_suppress_lock:
+                type_checks_suppressed -= 1
+
+    if func is None:
+        # Context manager mode
+        return contextmanager(cm)()
+    else:
+        # Decorator mode
+        update_wrapper(wrapper, func)
+        return wrapper
diff --git a/lib/typeguard/_transformer.py b/lib/typeguard/_transformer.py
new file mode 100644
index 00000000..13ac3630
--- /dev/null
+++ b/lib/typeguard/_transformer.py
@@ -0,0 +1,1229 @@
+from __future__ import annotations
+
+import ast
+import builtins
+import sys
+import typing
+from ast import (
+    AST,
+    Add,
+    AnnAssign,
+    Assign,
+    AsyncFunctionDef,
+    Attribute,
+    AugAssign,
+    BinOp,
+    BitAnd,
+    BitOr,
+    BitXor,
+    Call,
+    ClassDef,
+    Constant,
+    Dict,
+    Div,
+    Expr,
+    Expression,
+    FloorDiv,
+    FunctionDef,
+    If,
+    Import,
+    ImportFrom,
+    Index,
+    List,
+    Load,
+    LShift,
+    MatMult,
+    Mod,
+    Module,
+    Mult,
+    Name,
+    NamedExpr,
+    NodeTransformer,
+    NodeVisitor,
+    Pass,
+    Pow,
+    Return,
+    RShift,
+    Starred,
+    Store,
+    Sub,
+    Subscript,
+    Tuple,
+    Yield,
+    YieldFrom,
+    alias,
+    copy_location,
+    expr,
+    fix_missing_locations,
+    keyword,
+    walk,
+)
+from collections import defaultdict
+from collections.abc import Generator, Sequence
+from contextlib import contextmanager
+from copy import deepcopy
+from dataclasses import dataclass, field
+from typing import Any, ClassVar, cast, overload
+
+generator_names = (
+    "typing.Generator",
+    "collections.abc.Generator",
+    "typing.Iterator",
+    "collections.abc.Iterator",
+    "typing.Iterable",
+    "collections.abc.Iterable",
+    "typing.AsyncIterator",
+    "collections.abc.AsyncIterator",
+    "typing.AsyncIterable",
+    "collections.abc.AsyncIterable",
+    "typing.AsyncGenerator",
+    "collections.abc.AsyncGenerator",
+)
+anytype_names = (
+    "typing.Any",
+    "typing_extensions.Any",
+)
+literal_names = (
+    "typing.Literal",
+    "typing_extensions.Literal",
+)
+annotated_names = (
+    "typing.Annotated",
+    "typing_extensions.Annotated",
+)
+ignore_decorators = (
+    "typing.no_type_check",
+    "typeguard.typeguard_ignore",
+)
+aug_assign_functions = {
+    Add: "iadd",
+    Sub: "isub",
+    Mult: "imul",
+    MatMult: "imatmul",
+    Div: "itruediv",
+    FloorDiv: "ifloordiv",
+    Mod: "imod",
+    Pow: "ipow",
+    LShift: "ilshift",
+    RShift: "irshift",
+    BitAnd: "iand",
+    BitXor: "ixor",
+    BitOr: "ior",
+}
+
+
+@dataclass
+class TransformMemo:
+    node: Module | ClassDef | FunctionDef | AsyncFunctionDef | None
+    parent: TransformMemo | None
+    path: tuple[str, ...]
+    joined_path: Constant = field(init=False)
+    return_annotation: expr | None = None
+    yield_annotation: expr | None = None
+    send_annotation: expr | None = None
+    is_async: bool = False
+    local_names: set[str] = field(init=False, default_factory=set)
+    imported_names: dict[str, str] = field(init=False, default_factory=dict)
+    ignored_names: set[str] = field(init=False, default_factory=set)
+    load_names: defaultdict[str, dict[str, Name]] = field(
+        init=False, default_factory=lambda: defaultdict(dict)
+    )
+    has_yield_expressions: bool = field(init=False, default=False)
+    has_return_expressions: bool = field(init=False, default=False)
+    memo_var_name: Name | None = field(init=False, default=None)
+    should_instrument: bool = field(init=False, default=True)
+    variable_annotations: dict[str, expr] = field(init=False, default_factory=dict)
+    configuration_overrides: dict[str, Any] = field(init=False, default_factory=dict)
+    code_inject_index: int = field(init=False, default=0)
+
+    def __post_init__(self) -> None:
+        elements: list[str] = []
+        memo = self
+        while isinstance(memo.node, (ClassDef, FunctionDef, AsyncFunctionDef)):
+            elements.insert(0, memo.node.name)
+            if not memo.parent:
+                break
+
+            memo = memo.parent
+            if isinstance(memo.node, (FunctionDef, AsyncFunctionDef)):
+                elements.insert(0, "<locals>")
+
+        self.joined_path = Constant(".".join(elements))
+
+        # Figure out where to insert instrumentation code
+        if self.node:
+            for index, child in enumerate(self.node.body):
+                if isinstance(child, ImportFrom) and child.module == "__future__":
+                    # (module only) __future__ imports must come first
+                    continue
+                elif (
+                    isinstance(child, Expr)
+                    and isinstance(child.value, Constant)
+                    and isinstance(child.value.value, str)
+                ):
+                    continue  # docstring
+
+                self.code_inject_index = index
+                break
+
+    def get_unused_name(self, name: str) -> str:
+        memo: TransformMemo | None = self
+        while memo is not None:
+            if name in memo.local_names:
+                memo = self
+                name += "_"
+            else:
+                memo = memo.parent
+
+        self.local_names.add(name)
+        return name
+
+    def is_ignored_name(self, expression: expr | Expr | None) -> bool:
+        top_expression = (
+            expression.value if isinstance(expression, Expr) else expression
+        )
+
+        if isinstance(top_expression, Attribute) and isinstance(
+            top_expression.value, Name
+        ):
+            name = top_expression.value.id
+        elif isinstance(top_expression, Name):
+            name = top_expression.id
+        else:
+            return False
+
+        memo: TransformMemo | None = self
+        while memo is not None:
+            if name in memo.ignored_names:
+                return True
+
+            memo = memo.parent
+
+        return False
+
+    def get_memo_name(self) -> Name:
+        if not self.memo_var_name:
+            self.memo_var_name = Name(id="memo", ctx=Load())
+
+        return self.memo_var_name
+
+    def get_import(self, module: str, name: str) -> Name:
+        if module in self.load_names and name in self.load_names[module]:
+            return self.load_names[module][name]
+
+        qualified_name = f"{module}.{name}"
+        if name in self.imported_names and self.imported_names[name] == qualified_name:
+            return Name(id=name, ctx=Load())
+
+        alias = self.get_unused_name(name)
+        node = self.load_names[module][name] = Name(id=alias, ctx=Load())
+        self.imported_names[name] = qualified_name
+        return node
+
+    def insert_imports(self, node: Module | FunctionDef | AsyncFunctionDef) -> None:
+        """Insert imports needed by injected code."""
+        if not self.load_names:
+            return
+
+        # Insert imports after any "from __future__ ..." imports and any docstring
+        for modulename, names in self.load_names.items():
+            aliases = [
+                alias(orig_name, new_name.id if orig_name != new_name.id else None)
+                for orig_name, new_name in sorted(names.items())
+            ]
+            node.body.insert(self.code_inject_index, ImportFrom(modulename, aliases, 0))
+
+    def name_matches(self, expression: expr | Expr | None, *names: str) -> bool:
+        if expression is None:
+            return False
+
+        path: list[str] = []
+        top_expression = (
+            expression.value if isinstance(expression, Expr) else expression
+        )
+
+        if isinstance(top_expression, Subscript):
+            top_expression = top_expression.value
+        elif isinstance(top_expression, Call):
+            top_expression = top_expression.func
+
+        while isinstance(top_expression, Attribute):
+            path.insert(0, top_expression.attr)
+            top_expression = top_expression.value
+
+        if not isinstance(top_expression, Name):
+            return False
+
+        if top_expression.id in self.imported_names:
+            translated = self.imported_names[top_expression.id]
+        elif hasattr(builtins, top_expression.id):
+            translated = "builtins." + top_expression.id
+        else:
+            translated = top_expression.id
+
+        path.insert(0, translated)
+        joined_path = ".".join(path)
+        if joined_path in names:
+            return True
+        elif self.parent:
+            return self.parent.name_matches(expression, *names)
+        else:
+            return False
+
+    def get_config_keywords(self) -> list[keyword]:
+        if self.parent and isinstance(self.parent.node, ClassDef):
+            overrides = self.parent.configuration_overrides.copy()
+        else:
+            overrides = {}
+
+        overrides.update(self.configuration_overrides)
+        return [keyword(key, value) for key, value in overrides.items()]
+
+
+class NameCollector(NodeVisitor):
+    def __init__(self) -> None:
+        self.names: set[str] = set()
+
+    def visit_Import(self, node: Import) -> None:
+        for name in node.names:
+            self.names.add(name.asname or name.name)
+
+    def visit_ImportFrom(self, node: ImportFrom) -> None:
+        for name in node.names:
+            self.names.add(name.asname or name.name)
+
+    def visit_Assign(self, node: Assign) -> None:
+        for target in node.targets:
+            if isinstance(target, Name):
+                self.names.add(target.id)
+
+    def visit_NamedExpr(self, node: NamedExpr) -> Any:
+        if isinstance(node.target, Name):
+            self.names.add(node.target.id)
+
+    def visit_FunctionDef(self, node: FunctionDef) -> None:
+        pass
+
+    def visit_ClassDef(self, node: ClassDef) -> None:
+        pass
+
+
+class GeneratorDetector(NodeVisitor):
+    """Detects if a function node is a generator function."""
+
+    contains_yields: bool = False
+    in_root_function: bool = False
+
+    def visit_Yield(self, node: Yield) -> Any:
+        self.contains_yields = True
+
+    def visit_YieldFrom(self, node: YieldFrom) -> Any:
+        self.contains_yields = True
+
+    def visit_ClassDef(self, node: ClassDef) -> Any:
+        pass
+
+    def visit_FunctionDef(self, node: FunctionDef | AsyncFunctionDef) -> Any:
+        if not self.in_root_function:
+            self.in_root_function = True
+            self.generic_visit(node)
+            self.in_root_function = False
+
+    def visit_AsyncFunctionDef(self, node: AsyncFunctionDef) -> Any:
+        self.visit_FunctionDef(node)
+
+
+class AnnotationTransformer(NodeTransformer):
+    type_substitutions: ClassVar[dict[str, tuple[str, str]]] = {
+        "builtins.dict": ("typing", "Dict"),
+        "builtins.list": ("typing", "List"),
+        "builtins.tuple": ("typing", "Tuple"),
+        "builtins.set": ("typing", "Set"),
+        "builtins.frozenset": ("typing", "FrozenSet"),
+    }
+
+    def __init__(self, transformer: TypeguardTransformer):
+        self.transformer = transformer
+        self._memo = transformer._memo
+        self._level = 0
+
+    def visit(self, node: AST) -> Any:
+        # Don't process Literals
+        if isinstance(node, expr) and self._memo.name_matches(node, *literal_names):
+            return node
+
+        self._level += 1
+        new_node = super().visit(node)
+        self._level -= 1
+
+        if isinstance(new_node, Expression) and not hasattr(new_node, "body"):
+            return None
+
+        # Return None if this new node matches a variation of typing.Any
+        if (
+            self._level == 0
+            and isinstance(new_node, expr)
+            and self._memo.name_matches(new_node, *anytype_names)
+        ):
+            return None
+
+        return new_node
+
+    def visit_BinOp(self, node: BinOp) -> Any:
+        self.generic_visit(node)
+
+        if isinstance(node.op, BitOr):
+            # If either branch of the BinOp has been transformed to `None`, it means
+            # that a type in the union was ignored, so the entire annotation should e
+            # ignored
+            if not hasattr(node, "left") or not hasattr(node, "right"):
+                return None
+
+            # Return Any if either side is Any
+            if self._memo.name_matches(node.left, *anytype_names):
+                return node.left
+            elif self._memo.name_matches(node.right, *anytype_names):
+                return node.right
+
+            if sys.version_info < (3, 10):
+                union_name = self.transformer._get_import("typing", "Union")
+                return Subscript(
+                    value=union_name,
+                    slice=Index(
+                        Tuple(elts=[node.left, node.right], ctx=Load()), ctx=Load()
+                    ),
+                    ctx=Load(),
+                )
+
+        return node
+
+    def visit_Attribute(self, node: Attribute) -> Any:
+        if self._memo.is_ignored_name(node):
+            return None
+
+        return node
+
+    def visit_Subscript(self, node: Subscript) -> Any:
+        if self._memo.is_ignored_name(node.value):
+            return None
+
+        # The subscript of typing(_extensions).Literal can be any arbitrary string, so
+        # don't try to evaluate it as code
+        if node.slice:
+            if isinstance(node.slice, Index):
+                # Python 3.8
+                slice_value = node.slice.value  # type: ignore[attr-defined]
+            else:
+                slice_value = node.slice
+
+            if isinstance(slice_value, Tuple):
+                if self._memo.name_matches(node.value, *annotated_names):
+                    # Only treat the first argument to typing.Annotated as a potential
+                    # forward reference
+                    items = cast(
+                        typing.List[expr],
+                        [self.visit(slice_value.elts[0])] + slice_value.elts[1:],
+                    )
+                else:
+                    items = cast(
+                        typing.List[expr],
+                        [self.visit(item) for item in slice_value.elts],
+                    )
+
+                # If this is a Union and any of the items is Any, erase the entire
+                # annotation
+                if self._memo.name_matches(node.value, "typing.Union") and any(
+                    item is None
+                    or (
+                        isinstance(item, expr)
+                        and self._memo.name_matches(item, *anytype_names)
+                    )
+                    for item in items
+                ):
+                    return None
+
+                # If all items in the subscript were Any, erase the subscript entirely
+                if all(item is None for item in items):
+                    return node.value
+
+                for index, item in enumerate(items):
+                    if item is None:
+                        items[index] = self.transformer._get_import("typing", "Any")
+
+                slice_value.elts = items
+            else:
+                self.generic_visit(node)
+
+                # If the transformer erased the slice entirely, just return the node
+                # value without the subscript (unless it's Optional, in which case erase
+                # the node entirely
+                if self._memo.name_matches(
+                    node.value, "typing.Optional"
+                ) and not hasattr(node, "slice"):
+                    return None
+                if sys.version_info >= (3, 9) and not hasattr(node, "slice"):
+                    return node.value
+                elif sys.version_info < (3, 9) and not hasattr(node.slice, "value"):
+                    return node.value
+
+        return node
+
+    def visit_Name(self, node: Name) -> Any:
+        if self._memo.is_ignored_name(node):
+            return None
+
+        if sys.version_info < (3, 9):
+            for typename, substitute in self.type_substitutions.items():
+                if self._memo.name_matches(node, typename):
+                    new_node = self.transformer._get_import(*substitute)
+                    return copy_location(new_node, node)
+
+        return node
+
+    def visit_Call(self, node: Call) -> Any:
+        # Don't recurse into calls
+        return node
+
+    def visit_Constant(self, node: Constant) -> Any:
+        if isinstance(node.value, str):
+            expression = ast.parse(node.value, mode="eval")
+            new_node = self.visit(expression)
+            if new_node:
+                return copy_location(new_node.body, node)
+            else:
+                return None
+
+        return node
+
+
+class TypeguardTransformer(NodeTransformer):
+    def __init__(
+        self, target_path: Sequence[str] | None = None, target_lineno: int | None = None
+    ) -> None:
+        self._target_path = tuple(target_path) if target_path else None
+        self._memo = self._module_memo = TransformMemo(None, None, ())
+        self.names_used_in_annotations: set[str] = set()
+        self.target_node: FunctionDef | AsyncFunctionDef | None = None
+        self.target_lineno = target_lineno
+
+    def generic_visit(self, node: AST) -> AST:
+        has_non_empty_body_initially = bool(getattr(node, "body", None))
+        initial_type = type(node)
+
+        node = super().generic_visit(node)
+
+        if (
+            type(node) is initial_type
+            and has_non_empty_body_initially
+            and hasattr(node, "body")
+            and not node.body
+        ):
+            # If we have still the same node type after transformation
+            # but we've optimised it's body away, we add a `pass` statement.
+            node.body = [Pass()]
+
+        return node
+
+    @contextmanager
+    def _use_memo(
+        self, node: ClassDef | FunctionDef | AsyncFunctionDef
+    ) -> Generator[None, Any, None]:
+        new_memo = TransformMemo(node, self._memo, self._memo.path + (node.name,))
+        old_memo = self._memo
+        self._memo = new_memo
+
+        if isinstance(node, (FunctionDef, AsyncFunctionDef)):
+            new_memo.should_instrument = (
+                self._target_path is None or new_memo.path == self._target_path
+            )
+            if new_memo.should_instrument:
+                # Check if the function is a generator function
+                detector = GeneratorDetector()
+                detector.visit(node)
+
+                # Extract yield, send and return types where possible from a subscripted
+                # annotation like Generator[int, str, bool]
+                return_annotation = deepcopy(node.returns)
+                if detector.contains_yields and new_memo.name_matches(
+                    return_annotation, *generator_names
+                ):
+                    if isinstance(return_annotation, Subscript):
+                        annotation_slice = return_annotation.slice
+
+                        # Python < 3.9
+                        if isinstance(annotation_slice, Index):
+                            annotation_slice = (
+                                annotation_slice.value  # type: ignore[attr-defined]
+                            )
+
+                        if isinstance(annotation_slice, Tuple):
+                            items = annotation_slice.elts
+                        else:
+                            items = [annotation_slice]
+
+                        if len(items) > 0:
+                            new_memo.yield_annotation = self._convert_annotation(
+                                items[0]
+                            )
+
+                        if len(items) > 1:
+                            new_memo.send_annotation = self._convert_annotation(
+                                items[1]
+                            )
+
+                        if len(items) > 2:
+                            new_memo.return_annotation = self._convert_annotation(
+                                items[2]
+                            )
+                else:
+                    new_memo.return_annotation = self._convert_annotation(
+                        return_annotation
+                    )
+
+        if isinstance(node, AsyncFunctionDef):
+            new_memo.is_async = True
+
+        yield
+        self._memo = old_memo
+
+    def _get_import(self, module: str, name: str) -> Name:
+        memo = self._memo if self._target_path else self._module_memo
+        return memo.get_import(module, name)
+
+    @overload
+    def _convert_annotation(self, annotation: None) -> None: ...
+
+    @overload
+    def _convert_annotation(self, annotation: expr) -> expr: ...
+
+    def _convert_annotation(self, annotation: expr | None) -> expr | None:
+        if annotation is None:
+            return None
+
+        # Convert PEP 604 unions (x | y) and generic built-in collections where
+        # necessary, and undo forward references
+        new_annotation = cast(expr, AnnotationTransformer(self).visit(annotation))
+        if isinstance(new_annotation, expr):
+            new_annotation = ast.copy_location(new_annotation, annotation)
+
+            # Store names used in the annotation
+            names = {node.id for node in walk(new_annotation) if isinstance(node, Name)}
+            self.names_used_in_annotations.update(names)
+
+        return new_annotation
+
+    def visit_Name(self, node: Name) -> Name:
+        self._memo.local_names.add(node.id)
+        return node
+
+    def visit_Module(self, node: Module) -> Module:
+        self._module_memo = self._memo = TransformMemo(node, None, ())
+        self.generic_visit(node)
+        self._module_memo.insert_imports(node)
+
+        fix_missing_locations(node)
+        return node
+
+    def visit_Import(self, node: Import) -> Import:
+        for name in node.names:
+            self._memo.local_names.add(name.asname or name.name)
+            self._memo.imported_names[name.asname or name.name] = name.name
+
+        return node
+
+    def visit_ImportFrom(self, node: ImportFrom) -> ImportFrom:
+        for name in node.names:
+            if name.name != "*":
+                alias = name.asname or name.name
+                self._memo.local_names.add(alias)
+                self._memo.imported_names[alias] = f"{node.module}.{name.name}"
+
+        return node
+
+    def visit_ClassDef(self, node: ClassDef) -> ClassDef | None:
+        self._memo.local_names.add(node.name)
+
+        # Eliminate top level classes not belonging to the target path
+        if (
+            self._target_path is not None
+            and not self._memo.path
+            and node.name != self._target_path[0]
+        ):
+            return None
+
+        with self._use_memo(node):
+            for decorator in node.decorator_list.copy():
+                if self._memo.name_matches(decorator, "typeguard.typechecked"):
+                    # Remove the decorator to prevent duplicate instrumentation
+                    node.decorator_list.remove(decorator)
+
+                    # Store any configuration overrides
+                    if isinstance(decorator, Call) and decorator.keywords:
+                        self._memo.configuration_overrides.update(
+                            {kw.arg: kw.value for kw in decorator.keywords if kw.arg}
+                        )
+
+            self.generic_visit(node)
+            return node
+
+    def visit_FunctionDef(
+        self, node: FunctionDef | AsyncFunctionDef
+    ) -> FunctionDef | AsyncFunctionDef | None:
+        """
+        Injects type checks for function arguments, and for a return of None if the
+        function is annotated to return something else than Any or None, and the body
+        ends without an explicit "return".
+
+        """
+        self._memo.local_names.add(node.name)
+
+        # Eliminate top level functions not belonging to the target path
+        if (
+            self._target_path is not None
+            and not self._memo.path
+            and node.name != self._target_path[0]
+        ):
+            return None
+
+        # Skip instrumentation if we're instrumenting the whole module and the function
+        # contains either @no_type_check or @typeguard_ignore
+        if self._target_path is None:
+            for decorator in node.decorator_list:
+                if self._memo.name_matches(decorator, *ignore_decorators):
+                    return node
+
+        with self._use_memo(node):
+            arg_annotations: dict[str, Any] = {}
+            if self._target_path is None or self._memo.path == self._target_path:
+                # Find line number we're supposed to match against
+                if node.decorator_list:
+                    first_lineno = node.decorator_list[0].lineno
+                else:
+                    first_lineno = node.lineno
+
+                for decorator in node.decorator_list.copy():
+                    if self._memo.name_matches(decorator, "typing.overload"):
+                        # Remove overloads entirely
+                        return None
+                    elif self._memo.name_matches(decorator, "typeguard.typechecked"):
+                        # Remove the decorator to prevent duplicate instrumentation
+                        node.decorator_list.remove(decorator)
+
+                        # Store any configuration overrides
+                        if isinstance(decorator, Call) and decorator.keywords:
+                            self._memo.configuration_overrides = {
+                                kw.arg: kw.value for kw in decorator.keywords if kw.arg
+                            }
+
+                if self.target_lineno == first_lineno:
+                    assert self.target_node is None
+                    self.target_node = node
+                    if node.decorator_list:
+                        self.target_lineno = node.decorator_list[0].lineno
+                    else:
+                        self.target_lineno = node.lineno
+
+                all_args = node.args.args + node.args.kwonlyargs + node.args.posonlyargs
+
+                # Ensure that any type shadowed by the positional or keyword-only
+                # argument names are ignored in this function
+                for arg in all_args:
+                    self._memo.ignored_names.add(arg.arg)
+
+                # Ensure that any type shadowed by the variable positional argument name
+                # (e.g. "args" in *args) is ignored this function
+                if node.args.vararg:
+                    self._memo.ignored_names.add(node.args.vararg.arg)
+
+                # Ensure that any type shadowed by the variable keywrod argument name
+                # (e.g. "kwargs" in *kwargs) is ignored this function
+                if node.args.kwarg:
+                    self._memo.ignored_names.add(node.args.kwarg.arg)
+
+                for arg in all_args:
+                    annotation = self._convert_annotation(deepcopy(arg.annotation))
+                    if annotation:
+                        arg_annotations[arg.arg] = annotation
+
+                if node.args.vararg:
+                    annotation_ = self._convert_annotation(node.args.vararg.annotation)
+                    if annotation_:
+                        if sys.version_info >= (3, 9):
+                            container = Name("tuple", ctx=Load())
+                        else:
+                            container = self._get_import("typing", "Tuple")
+
+                        subscript_slice: Tuple | Index = Tuple(
+                            [
+                                annotation_,
+                                Constant(Ellipsis),
+                            ],
+                            ctx=Load(),
+                        )
+                        if sys.version_info < (3, 9):
+                            subscript_slice = Index(subscript_slice, ctx=Load())
+
+                        arg_annotations[node.args.vararg.arg] = Subscript(
+                            container, subscript_slice, ctx=Load()
+                        )
+
+                if node.args.kwarg:
+                    annotation_ = self._convert_annotation(node.args.kwarg.annotation)
+                    if annotation_:
+                        if sys.version_info >= (3, 9):
+                            container = Name("dict", ctx=Load())
+                        else:
+                            container = self._get_import("typing", "Dict")
+
+                        subscript_slice = Tuple(
+                            [
+                                Name("str", ctx=Load()),
+                                annotation_,
+                            ],
+                            ctx=Load(),
+                        )
+                        if sys.version_info < (3, 9):
+                            subscript_slice = Index(subscript_slice, ctx=Load())
+
+                        arg_annotations[node.args.kwarg.arg] = Subscript(
+                            container, subscript_slice, ctx=Load()
+                        )
+
+                if arg_annotations:
+                    self._memo.variable_annotations.update(arg_annotations)
+
+            self.generic_visit(node)
+
+            if arg_annotations:
+                annotations_dict = Dict(
+                    keys=[Constant(key) for key in arg_annotations.keys()],
+                    values=[
+                        Tuple([Name(key, ctx=Load()), annotation], ctx=Load())
+                        for key, annotation in arg_annotations.items()
+                    ],
+                )
+                func_name = self._get_import(
+                    "typeguard._functions", "check_argument_types"
+                )
+                args = [
+                    self._memo.joined_path,
+                    annotations_dict,
+                    self._memo.get_memo_name(),
+                ]
+                node.body.insert(
+                    self._memo.code_inject_index, Expr(Call(func_name, args, []))
+                )
+
+            # Add a checked "return None" to the end if there's no explicit return
+            # Skip if the return annotation is None or Any
+            if (
+                self._memo.return_annotation
+                and (not self._memo.is_async or not self._memo.has_yield_expressions)
+                and not isinstance(node.body[-1], Return)
+                and (
+                    not isinstance(self._memo.return_annotation, Constant)
+                    or self._memo.return_annotation.value is not None
+                )
+            ):
+                func_name = self._get_import(
+                    "typeguard._functions", "check_return_type"
+                )
+                return_node = Return(
+                    Call(
+                        func_name,
+                        [
+                            self._memo.joined_path,
+                            Constant(None),
+                            self._memo.return_annotation,
+                            self._memo.get_memo_name(),
+                        ],
+                        [],
+                    )
+                )
+
+                # Replace a placeholder "pass" at the end
+                if isinstance(node.body[-1], Pass):
+                    copy_location(return_node, node.body[-1])
+                    del node.body[-1]
+
+                node.body.append(return_node)
+
+            # Insert code to create the call memo, if it was ever needed for this
+            # function
+            if self._memo.memo_var_name:
+                memo_kwargs: dict[str, Any] = {}
+                if self._memo.parent and isinstance(self._memo.parent.node, ClassDef):
+                    for decorator in node.decorator_list:
+                        if (
+                            isinstance(decorator, Name)
+                            and decorator.id == "staticmethod"
+                        ):
+                            break
+                        elif (
+                            isinstance(decorator, Name)
+                            and decorator.id == "classmethod"
+                        ):
+                            memo_kwargs["self_type"] = Name(
+                                id=node.args.args[0].arg, ctx=Load()
+                            )
+                            break
+                    else:
+                        if node.args.args:
+                            if node.name == "__new__":
+                                memo_kwargs["self_type"] = Name(
+                                    id=node.args.args[0].arg, ctx=Load()
+                                )
+                            else:
+                                memo_kwargs["self_type"] = Attribute(
+                                    Name(id=node.args.args[0].arg, ctx=Load()),
+                                    "__class__",
+                                    ctx=Load(),
+                                )
+
+                # Construct the function reference
+                # Nested functions get special treatment: the function name is added
+                # to free variables (and the closure of the resulting function)
+                names: list[str] = [node.name]
+                memo = self._memo.parent
+                while memo:
+                    if isinstance(memo.node, (FunctionDef, AsyncFunctionDef)):
+                        # This is a nested function. Use the function name as-is.
+                        del names[:-1]
+                        break
+                    elif not isinstance(memo.node, ClassDef):
+                        break
+
+                    names.insert(0, memo.node.name)
+                    memo = memo.parent
+
+                config_keywords = self._memo.get_config_keywords()
+                if config_keywords:
+                    memo_kwargs["config"] = Call(
+                        self._get_import("dataclasses", "replace"),
+                        [self._get_import("typeguard._config", "global_config")],
+                        config_keywords,
+                    )
+
+                self._memo.memo_var_name.id = self._memo.get_unused_name("memo")
+                memo_store_name = Name(id=self._memo.memo_var_name.id, ctx=Store())
+                globals_call = Call(Name(id="globals", ctx=Load()), [], [])
+                locals_call = Call(Name(id="locals", ctx=Load()), [], [])
+                memo_expr = Call(
+                    self._get_import("typeguard", "TypeCheckMemo"),
+                    [globals_call, locals_call],
+                    [keyword(key, value) for key, value in memo_kwargs.items()],
+                )
+                node.body.insert(
+                    self._memo.code_inject_index,
+                    Assign([memo_store_name], memo_expr),
+                )
+
+                self._memo.insert_imports(node)
+
+                # Special case the __new__() method to create a local alias from the
+                # class name to the first argument (usually "cls")
+                if (
+                    isinstance(node, FunctionDef)
+                    and node.args
+                    and self._memo.parent is not None
+                    and isinstance(self._memo.parent.node, ClassDef)
+                    and node.name == "__new__"
+                ):
+                    first_args_expr = Name(node.args.args[0].arg, ctx=Load())
+                    cls_name = Name(self._memo.parent.node.name, ctx=Store())
+                    node.body.insert(
+                        self._memo.code_inject_index,
+                        Assign([cls_name], first_args_expr),
+                    )
+
+                # Rmove any placeholder "pass" at the end
+                if isinstance(node.body[-1], Pass):
+                    del node.body[-1]
+
+        return node
+
+    def visit_AsyncFunctionDef(
+        self, node: AsyncFunctionDef
+    ) -> FunctionDef | AsyncFunctionDef | None:
+        return self.visit_FunctionDef(node)
+
+    def visit_Return(self, node: Return) -> Return:
+        """This injects type checks into "return" statements."""
+        self.generic_visit(node)
+        if (
+            self._memo.return_annotation
+            and self._memo.should_instrument
+            and not self._memo.is_ignored_name(self._memo.return_annotation)
+        ):
+            func_name = self._get_import("typeguard._functions", "check_return_type")
+            old_node = node
+            retval = old_node.value or Constant(None)
+            node = Return(
+                Call(
+                    func_name,
+                    [
+                        self._memo.joined_path,
+                        retval,
+                        self._memo.return_annotation,
+                        self._memo.get_memo_name(),
+                    ],
+                    [],
+                )
+            )
+            copy_location(node, old_node)
+
+        return node
+
+    def visit_Yield(self, node: Yield) -> Yield | Call:
+        """
+        This injects type checks into "yield" expressions, checking both the yielded
+        value and the value sent back to the generator, when appropriate.
+
+        """
+        self._memo.has_yield_expressions = True
+        self.generic_visit(node)
+
+        if (
+            self._memo.yield_annotation
+            and self._memo.should_instrument
+            and not self._memo.is_ignored_name(self._memo.yield_annotation)
+        ):
+            func_name = self._get_import("typeguard._functions", "check_yield_type")
+            yieldval = node.value or Constant(None)
+            node.value = Call(
+                func_name,
+                [
+                    self._memo.joined_path,
+                    yieldval,
+                    self._memo.yield_annotation,
+                    self._memo.get_memo_name(),
+                ],
+                [],
+            )
+
+        if (
+            self._memo.send_annotation
+            and self._memo.should_instrument
+            and not self._memo.is_ignored_name(self._memo.send_annotation)
+        ):
+            func_name = self._get_import("typeguard._functions", "check_send_type")
+            old_node = node
+            call_node = Call(
+                func_name,
+                [
+                    self._memo.joined_path,
+                    old_node,
+                    self._memo.send_annotation,
+                    self._memo.get_memo_name(),
+                ],
+                [],
+            )
+            copy_location(call_node, old_node)
+            return call_node
+
+        return node
+
+    def visit_AnnAssign(self, node: AnnAssign) -> Any:
+        """
+        This injects a type check into a local variable annotation-assignment within a
+        function body.
+
+        """
+        self.generic_visit(node)
+
+        if (
+            isinstance(self._memo.node, (FunctionDef, AsyncFunctionDef))
+            and node.annotation
+            and isinstance(node.target, Name)
+        ):
+            self._memo.ignored_names.add(node.target.id)
+            annotation = self._convert_annotation(deepcopy(node.annotation))
+            if annotation:
+                self._memo.variable_annotations[node.target.id] = annotation
+                if node.value:
+                    func_name = self._get_import(
+                        "typeguard._functions", "check_variable_assignment"
+                    )
+                    node.value = Call(
+                        func_name,
+                        [
+                            node.value,
+                            Constant(node.target.id),
+                            annotation,
+                            self._memo.get_memo_name(),
+                        ],
+                        [],
+                    )
+
+        return node
+
+    def visit_Assign(self, node: Assign) -> Any:
+        """
+        This injects a type check into a local variable assignment within a function
+        body. The variable must have been annotated earlier in the function body.
+
+        """
+        self.generic_visit(node)
+
+        # Only instrument function-local assignments
+        if isinstance(self._memo.node, (FunctionDef, AsyncFunctionDef)):
+            targets: list[dict[Constant, expr | None]] = []
+            check_required = False
+            for target in node.targets:
+                elts: Sequence[expr]
+                if isinstance(target, Name):
+                    elts = [target]
+                elif isinstance(target, Tuple):
+                    elts = target.elts
+                else:
+                    continue
+
+                annotations_: dict[Constant, expr | None] = {}
+                for exp in elts:
+                    prefix = ""
+                    if isinstance(exp, Starred):
+                        exp = exp.value
+                        prefix = "*"
+
+                    if isinstance(exp, Name):
+                        self._memo.ignored_names.add(exp.id)
+                        name = prefix + exp.id
+                        annotation = self._memo.variable_annotations.get(exp.id)
+                        if annotation:
+                            annotations_[Constant(name)] = annotation
+                            check_required = True
+                        else:
+                            annotations_[Constant(name)] = None
+
+                targets.append(annotations_)
+
+            if check_required:
+                # Replace missing annotations with typing.Any
+                for item in targets:
+                    for key, expression in item.items():
+                        if expression is None:
+                            item[key] = self._get_import("typing", "Any")
+
+                if len(targets) == 1 and len(targets[0]) == 1:
+                    func_name = self._get_import(
+                        "typeguard._functions", "check_variable_assignment"
+                    )
+                    target_varname = next(iter(targets[0]))
+                    node.value = Call(
+                        func_name,
+                        [
+                            node.value,
+                            target_varname,
+                            targets[0][target_varname],
+                            self._memo.get_memo_name(),
+                        ],
+                        [],
+                    )
+                elif targets:
+                    func_name = self._get_import(
+                        "typeguard._functions", "check_multi_variable_assignment"
+                    )
+                    targets_arg = List(
+                        [
+                            Dict(keys=list(target), values=list(target.values()))
+                            for target in targets
+                        ],
+                        ctx=Load(),
+                    )
+                    node.value = Call(
+                        func_name,
+                        [node.value, targets_arg, self._memo.get_memo_name()],
+                        [],
+                    )
+
+        return node
+
+    def visit_NamedExpr(self, node: NamedExpr) -> Any:
+        """This injects a type check into an assignment expression (a := foo())."""
+        self.generic_visit(node)
+
+        # Only instrument function-local assignments
+        if isinstance(self._memo.node, (FunctionDef, AsyncFunctionDef)) and isinstance(
+            node.target, Name
+        ):
+            self._memo.ignored_names.add(node.target.id)
+
+            # Bail out if no matching annotation is found
+            annotation = self._memo.variable_annotations.get(node.target.id)
+            if annotation is None:
+                return node
+
+            func_name = self._get_import(
+                "typeguard._functions", "check_variable_assignment"
+            )
+            node.value = Call(
+                func_name,
+                [
+                    node.value,
+                    Constant(node.target.id),
+                    annotation,
+                    self._memo.get_memo_name(),
+                ],
+                [],
+            )
+
+        return node
+
+    def visit_AugAssign(self, node: AugAssign) -> Any:
+        """
+        This injects a type check into an augmented assignment expression (a += 1).
+
+        """
+        self.generic_visit(node)
+
+        # Only instrument function-local assignments
+        if isinstance(self._memo.node, (FunctionDef, AsyncFunctionDef)) and isinstance(
+            node.target, Name
+        ):
+            # Bail out if no matching annotation is found
+            annotation = self._memo.variable_annotations.get(node.target.id)
+            if annotation is None:
+                return node
+
+            # Bail out if the operator is not found (newer Python version?)
+            try:
+                operator_func_name = aug_assign_functions[node.op.__class__]
+            except KeyError:
+                return node
+
+            operator_func = self._get_import("operator", operator_func_name)
+            operator_call = Call(
+                operator_func, [Name(node.target.id, ctx=Load()), node.value], []
+            )
+            check_call = Call(
+                self._get_import("typeguard._functions", "check_variable_assignment"),
+                [
+                    operator_call,
+                    Constant(node.target.id),
+                    annotation,
+                    self._memo.get_memo_name(),
+                ],
+                [],
+            )
+            return Assign(targets=[node.target], value=check_call)
+
+        return node
+
+    def visit_If(self, node: If) -> Any:
+        """
+        This blocks names from being collected from a module-level
+        "if typing.TYPE_CHECKING:" block, so that they won't be type checked.
+
+        """
+        self.generic_visit(node)
+
+        if (
+            self._memo is self._module_memo
+            and isinstance(node.test, Name)
+            and self._memo.name_matches(node.test, "typing.TYPE_CHECKING")
+        ):
+            collector = NameCollector()
+            collector.visit(node)
+            self._memo.ignored_names.update(collector.names)
+
+        return node
diff --git a/lib/typeguard/_union_transformer.py b/lib/typeguard/_union_transformer.py
new file mode 100644
index 00000000..19617e6a
--- /dev/null
+++ b/lib/typeguard/_union_transformer.py
@@ -0,0 +1,55 @@
+"""
+Transforms lazily evaluated PEP 604 unions into typing.Unions, for compatibility with
+Python versions older than 3.10.
+"""
+
+from __future__ import annotations
+
+from ast import (
+    BinOp,
+    BitOr,
+    Index,
+    Load,
+    Name,
+    NodeTransformer,
+    Subscript,
+    fix_missing_locations,
+    parse,
+)
+from ast import Tuple as ASTTuple
+from types import CodeType
+from typing import Any, Dict, FrozenSet, List, Set, Tuple, Union
+
+type_substitutions = {
+    "dict": Dict,
+    "list": List,
+    "tuple": Tuple,
+    "set": Set,
+    "frozenset": FrozenSet,
+    "Union": Union,
+}
+
+
+class UnionTransformer(NodeTransformer):
+    def __init__(self, union_name: Name | None = None):
+        self.union_name = union_name or Name(id="Union", ctx=Load())
+
+    def visit_BinOp(self, node: BinOp) -> Any:
+        self.generic_visit(node)
+        if isinstance(node.op, BitOr):
+            return Subscript(
+                value=self.union_name,
+                slice=Index(
+                    ASTTuple(elts=[node.left, node.right], ctx=Load()), ctx=Load()
+                ),
+                ctx=Load(),
+            )
+
+        return node
+
+
+def compile_type_hint(hint: str) -> CodeType:
+    parsed = parse(hint, "<string>", "eval")
+    UnionTransformer().visit(parsed)
+    fix_missing_locations(parsed)
+    return compile(parsed, "<string>", "eval", flags=0)
diff --git a/lib/typeguard/_utils.py b/lib/typeguard/_utils.py
new file mode 100644
index 00000000..96818fd2
--- /dev/null
+++ b/lib/typeguard/_utils.py
@@ -0,0 +1,163 @@
+from __future__ import annotations
+
+import inspect
+import sys
+from importlib import import_module
+from inspect import currentframe
+from types import CodeType, FrameType, FunctionType
+from typing import TYPE_CHECKING, Any, Callable, ForwardRef, Union, cast, final
+from weakref import WeakValueDictionary
+
+if TYPE_CHECKING:
+    from ._memo import TypeCheckMemo
+
+if sys.version_info >= (3, 10):
+    from typing import get_args, get_origin
+
+    def evaluate_forwardref(forwardref: ForwardRef, memo: TypeCheckMemo) -> Any:
+        return forwardref._evaluate(memo.globals, memo.locals, frozenset())
+
+else:
+    from typing_extensions import get_args, get_origin
+
+    evaluate_extra_args: tuple[frozenset[Any], ...] = (
+        (frozenset(),) if sys.version_info >= (3, 9) else ()
+    )
+
+    def evaluate_forwardref(forwardref: ForwardRef, memo: TypeCheckMemo) -> Any:
+        from ._union_transformer import compile_type_hint, type_substitutions
+
+        if not forwardref.__forward_evaluated__:
+            forwardref.__forward_code__ = compile_type_hint(forwardref.__forward_arg__)
+
+        try:
+            return forwardref._evaluate(memo.globals, memo.locals, *evaluate_extra_args)
+        except NameError:
+            if sys.version_info < (3, 10):
+                # Try again, with the type substitutions (list -> List etc.) in place
+                new_globals = memo.globals.copy()
+                new_globals.setdefault("Union", Union)
+                if sys.version_info < (3, 9):
+                    new_globals.update(type_substitutions)
+
+                return forwardref._evaluate(
+                    new_globals, memo.locals or new_globals, *evaluate_extra_args
+                )
+
+            raise
+
+
+_functions_map: WeakValueDictionary[CodeType, FunctionType] = WeakValueDictionary()
+
+
+def get_type_name(type_: Any) -> str:
+    name: str
+    for attrname in "__name__", "_name", "__forward_arg__":
+        candidate = getattr(type_, attrname, None)
+        if isinstance(candidate, str):
+            name = candidate
+            break
+    else:
+        origin = get_origin(type_)
+        candidate = getattr(origin, "_name", None)
+        if candidate is None:
+            candidate = type_.__class__.__name__.strip("_")
+
+        if isinstance(candidate, str):
+            name = candidate
+        else:
+            return "(unknown)"
+
+    args = get_args(type_)
+    if args:
+        if name == "Literal":
+            formatted_args = ", ".join(repr(arg) for arg in args)
+        else:
+            formatted_args = ", ".join(get_type_name(arg) for arg in args)
+
+        name += f"[{formatted_args}]"
+
+    module = getattr(type_, "__module__", None)
+    if module and module not in (None, "typing", "typing_extensions", "builtins"):
+        name = module + "." + name
+
+    return name
+
+
+def qualified_name(obj: Any, *, add_class_prefix: bool = False) -> str:
+    """
+    Return the qualified name (e.g. package.module.Type) for the given object.
+
+    Builtins and types from the :mod:`typing` package get special treatment by having
+    the module name stripped from the generated name.
+
+    """
+    if obj is None:
+        return "None"
+    elif inspect.isclass(obj):
+        prefix = "class " if add_class_prefix else ""
+        type_ = obj
+    else:
+        prefix = ""
+        type_ = type(obj)
+
+    module = type_.__module__
+    qualname = type_.__qualname__
+    name = qualname if module in ("typing", "builtins") else f"{module}.{qualname}"
+    return prefix + name
+
+
+def function_name(func: Callable[..., Any]) -> str:
+    """
+    Return the qualified name of the given function.
+
+    Builtins and types from the :mod:`typing` package get special treatment by having
+    the module name stripped from the generated name.
+
+    """
+    # For partial functions and objects with __call__ defined, __qualname__ does not
+    # exist
+    module = getattr(func, "__module__", "")
+    qualname = (module + ".") if module not in ("builtins", "") else ""
+    return qualname + getattr(func, "__qualname__", repr(func))
+
+
+def resolve_reference(reference: str) -> Any:
+    modulename, varname = reference.partition(":")[::2]
+    if not modulename or not varname:
+        raise ValueError(f"{reference!r} is not a module:varname reference")
+
+    obj = import_module(modulename)
+    for attr in varname.split("."):
+        obj = getattr(obj, attr)
+
+    return obj
+
+
+def is_method_of(obj: object, cls: type) -> bool:
+    return (
+        inspect.isfunction(obj)
+        and obj.__module__ == cls.__module__
+        and obj.__qualname__.startswith(cls.__qualname__ + ".")
+    )
+
+
+def get_stacklevel() -> int:
+    level = 1
+    frame = cast(FrameType, currentframe()).f_back
+    while frame and frame.f_globals.get("__name__", "").startswith("typeguard."):
+        level += 1
+        frame = frame.f_back
+
+    return level
+
+
+@final
+class Unset:
+    __slots__ = ()
+
+    def __repr__(self) -> str:
+        return "<unset>"
+
+
+unset = Unset()
diff --git a/lib/typeguard/py.typed b/lib/typeguard/py.typed
new file mode 100644
index 00000000..e69de29b
diff --git a/lib/typing_extensions.py b/lib/typing_extensions.py
index f3132ea4..9ccd519c 100644
--- a/lib/typing_extensions.py
+++ b/lib/typing_extensions.py
@@ -147,27 +147,6 @@ class _Sentinel:
 _marker = _Sentinel()
 
 
-def _check_generic(cls, parameters, elen=_marker):
-    """Check correct count for parameters of a generic cls (internal helper).
-    This gives a nice error message in case of count mismatch.
-    """
-    if not elen:
-        raise TypeError(f"{cls} is not a generic class")
-    if elen is _marker:
-        if not hasattr(cls, "__parameters__") or not cls.__parameters__:
-            raise TypeError(f"{cls} is not a generic class")
-        elen = len(cls.__parameters__)
-    alen = len(parameters)
-    if alen != elen:
-        if hasattr(cls, "__parameters__"):
-            parameters = [p for p in cls.__parameters__ if not _is_unpack(p)]
-            num_tv_tuples = sum(isinstance(p, TypeVarTuple) for p in parameters)
-            if (num_tv_tuples > 0) and (alen >= elen - num_tv_tuples):
-                return
-        raise TypeError(f"Too {'many' if alen > elen else 'few'} parameters for {cls};"
-                        f" actual {alen}, expected {elen}")
-
-
 if sys.version_info >= (3, 10):
     def _should_collect_from_parameters(t):
         return isinstance(
@@ -181,27 +160,6 @@ else:
         return isinstance(t, typing._GenericAlias) and not t._special
 
 
-def _collect_type_vars(types, typevar_types=None):
-    """Collect all type variable contained in types in order of
-    first appearance (lexicographic order). For example::
-
-        _collect_type_vars((T, List[S, T])) == (T, S)
-    """
-    if typevar_types is None:
-        typevar_types = typing.TypeVar
-    tvars = []
-    for t in types:
-        if (
-            isinstance(t, typevar_types) and
-            t not in tvars and
-            not _is_unpack(t)
-        ):
-            tvars.append(t)
-        if _should_collect_from_parameters(t):
-            tvars.extend([t for t in t.__parameters__ if t not in tvars])
-    return tuple(tvars)
-
-
 NoReturn = typing.NoReturn
 
 # Some unconstrained type variables.  These are used by the container types.
@@ -834,7 +792,11 @@ def _ensure_subclassable(mro_entries):
     return inner
 
 
-if hasattr(typing, "ReadOnly"):
+# Update this to something like >=3.13.0b1 if and when
+# PEP 728 is implemented in CPython
+_PEP_728_IMPLEMENTED = False
+
+if _PEP_728_IMPLEMENTED:
     # The standard library TypedDict in Python 3.8 does not store runtime information
     # about which (if any) keys are optional.  See https://bugs.python.org/issue38834
     # The standard library TypedDict in Python 3.9.0/1 does not honour the "total"
@@ -845,7 +807,8 @@ if hasattr(typing, "ReadOnly"):
     # Aaaand on 3.12 we add __orig_bases__ to TypedDict
     # to enable better runtime introspection.
     # On 3.13 we deprecate some odd ways of creating TypedDicts.
-    # PEP 705 proposes adding the ReadOnly[] qualifier.
+    # Also on 3.13, PEP 705 adds the ReadOnly[] qualifier.
+    # PEP 728 (still pending) makes more changes.
     TypedDict = typing.TypedDict
     _TypedDictMeta = typing._TypedDictMeta
     is_typeddict = typing.is_typeddict
@@ -1122,15 +1085,15 @@ else:
         return val
 
 
-if hasattr(typing, "Required"):  # 3.11+
+if hasattr(typing, "ReadOnly"):  # 3.13+
     get_type_hints = typing.get_type_hints
-else:  # <=3.10
+else:  # <=3.13
     # replaces _strip_annotations()
     def _strip_extras(t):
         """Strips Annotated, Required and NotRequired from a given type."""
         if isinstance(t, _AnnotatedAlias):
             return _strip_extras(t.__origin__)
-        if hasattr(t, "__origin__") and t.__origin__ in (Required, NotRequired):
+        if hasattr(t, "__origin__") and t.__origin__ in (Required, NotRequired, ReadOnly):
             return _strip_extras(t.__args__[0])
         if isinstance(t, typing._GenericAlias):
             stripped_args = tuple(_strip_extras(a) for a in t.__args__)
@@ -2689,9 +2652,151 @@ else:
 #   counting generic parameters, so that when we subscript a generic,
 #   the runtime doesn't try to substitute the Unpack with the subscripted type.
 if not hasattr(typing, "TypeVarTuple"):
-    typing._collect_type_vars = _collect_type_vars
-    typing._check_generic = _check_generic
+    def _check_generic(cls, parameters, elen=_marker):
+        """Check correct count for parameters of a generic cls (internal helper).
 
+        This gives a nice error message in case of count mismatch.
+        """
+        if not elen:
+            raise TypeError(f"{cls} is not a generic class")
+        if elen is _marker:
+            if not hasattr(cls, "__parameters__") or not cls.__parameters__:
+                raise TypeError(f"{cls} is not a generic class")
+            elen = len(cls.__parameters__)
+        alen = len(parameters)
+        if alen != elen:
+            expect_val = elen
+            if hasattr(cls, "__parameters__"):
+                parameters = [p for p in cls.__parameters__ if not _is_unpack(p)]
+                num_tv_tuples = sum(isinstance(p, TypeVarTuple) for p in parameters)
+                if (num_tv_tuples > 0) and (alen >= elen - num_tv_tuples):
+                    return
+
+                # deal with TypeVarLike defaults
+                # required TypeVarLikes cannot appear after a defaulted one.
+                if alen < elen:
+                    # since we validate TypeVarLike default in _collect_type_vars
+                    # or _collect_parameters we can safely check parameters[alen]
+                    if getattr(parameters[alen], '__default__', None) is not None:
+                        return
+
+                    num_default_tv = sum(getattr(p, '__default__', None)
+                                         is not None for p in parameters)
+
+                    elen -= num_default_tv
+
+                    expect_val = f"at least {elen}"
+
+            things = "arguments" if sys.version_info >= (3, 10) else "parameters"
+            raise TypeError(f"Too {'many' if alen > elen else 'few'} {things}"
+                            f" for {cls}; actual {alen}, expected {expect_val}")
+else:
+    # Python 3.11+
+
+    def _check_generic(cls, parameters, elen):
+        """Check correct count for parameters of a generic cls (internal helper).
+
+        This gives a nice error message in case of count mismatch.
+        """
+        if not elen:
+            raise TypeError(f"{cls} is not a generic class")
+        alen = len(parameters)
+        if alen != elen:
+            expect_val = elen
+            if hasattr(cls, "__parameters__"):
+                parameters = [p for p in cls.__parameters__ if not _is_unpack(p)]
+
+                # deal with TypeVarLike defaults
+                # required TypeVarLikes cannot appear after a defaulted one.
+                if alen < elen:
+                    # since we validate TypeVarLike default in _collect_type_vars
+                    # or _collect_parameters we can safely check parameters[alen]
+                    if getattr(parameters[alen], '__default__', None) is not None:
+                        return
+
+                    num_default_tv = sum(getattr(p, '__default__', None)
+                                         is not None for p in parameters)
+
+                    elen -= num_default_tv
+
+                    expect_val = f"at least {elen}"
+
+            raise TypeError(f"Too {'many' if alen > elen else 'few'} arguments"
+                            f" for {cls}; actual {alen}, expected {expect_val}")
+
+typing._check_generic = _check_generic
+
+# Python 3.11+ _collect_type_vars was renamed to _collect_parameters
+if hasattr(typing, '_collect_type_vars'):
+    def _collect_type_vars(types, typevar_types=None):
+        """Collect all type variable contained in types in order of
+        first appearance (lexicographic order). For example::
+
+            _collect_type_vars((T, List[S, T])) == (T, S)
+        """
+        if typevar_types is None:
+            typevar_types = typing.TypeVar
+        tvars = []
+        # required TypeVarLike cannot appear after TypeVarLike with default
+        default_encountered = False
+        for t in types:
+            if (
+                isinstance(t, typevar_types) and
+                t not in tvars and
+                not _is_unpack(t)
+            ):
+                if getattr(t, '__default__', None) is not None:
+                    default_encountered = True
+                elif default_encountered:
+                    raise TypeError(f'Type parameter {t!r} without a default'
+                                    ' follows type parameter with a default')
+
+                tvars.append(t)
+            if _should_collect_from_parameters(t):
+                tvars.extend([t for t in t.__parameters__ if t not in tvars])
+        return tuple(tvars)
+
+    typing._collect_type_vars = _collect_type_vars
+else:
+    def _collect_parameters(args):
+        """Collect all type variables and parameter specifications in args
+        in order of first appearance (lexicographic order).
+
+        For example::
+
+            assert _collect_parameters((T, Callable[P, T])) == (T, P)
+        """
+        parameters = []
+        # required TypeVarLike cannot appear after TypeVarLike with default
+        default_encountered = False
+        for t in args:
+            if isinstance(t, type):
+                # We don't want __parameters__ descriptor of a bare Python class.
+                pass
+            elif isinstance(t, tuple):
+                # `t` might be a tuple, when `ParamSpec` is substituted with
+                # `[T, int]`, or `[int, *Ts]`, etc.
+                for x in t:
+                    for collected in _collect_parameters([x]):
+                        if collected not in parameters:
+                            parameters.append(collected)
+            elif hasattr(t, '__typing_subst__'):
+                if t not in parameters:
+                    if getattr(t, '__default__', None) is not None:
+                        default_encountered = True
+                    elif default_encountered:
+                        raise TypeError(f'Type parameter {t!r} without a default'
+                                        ' follows type parameter with a default')
+
+                    parameters.append(t)
+            else:
+                for x in getattr(t, '__parameters__', ()):
+                    if x not in parameters:
+                        parameters.append(x)
+
+        return tuple(parameters)
+
+    typing._collect_parameters = _collect_parameters
 
 # Backport typing.NamedTuple as it exists in Python 3.13.
 # In 3.11, the ability to define generic `NamedTuple`s was supported.
diff --git a/plexpy/__init__.py b/plexpy/__init__.py
index 10d153d1..0366fcde 100644
--- a/plexpy/__init__.py
+++ b/plexpy/__init__.py
@@ -13,14 +13,10 @@
 #  You should have received a copy of the GNU General Public License
 #  along with Tautulli.  If not, see <http://www.gnu.org/licenses/>.
 
-from __future__ import unicode_literals
-from future.builtins import range
-from future.builtins import str
-
 import ctypes
 import datetime
 import os
-import future.moves.queue as queue
+import queue
 import sqlite3
 import sys
 import subprocess
@@ -39,52 +35,27 @@ from apscheduler.triggers.interval import IntervalTrigger
 from ga4mp import GtagMP
 import pytz
 
-PYTHON2 = sys.version_info[0] == 2
-
-if PYTHON2:
-    import activity_handler
-    import activity_pinger
-    import common
-    import database
-    import datafactory
-    import exporter
-    import helpers
-    import libraries
-    import logger
-    import mobile_app
-    import newsletters
-    import newsletter_handler
-    import notification_handler
-    import notifiers
-    import plex
-    import plextv
-    import users
-    import versioncheck
-    import web_socket
-    import webstart
-    import config
-else:
-    from plexpy import activity_handler
-    from plexpy import activity_pinger
-    from plexpy import common
-    from plexpy import database
-    from plexpy import datafactory
-    from plexpy import exporter
-    from plexpy import helpers
-    from plexpy import libraries
-    from plexpy import logger
-    from plexpy import mobile_app
-    from plexpy import newsletters
-    from plexpy import newsletter_handler
-    from plexpy import notification_handler
-    from plexpy import notifiers
-    from plexpy import plex
-    from plexpy import plextv
-    from plexpy import users
-    from plexpy import versioncheck
-    from plexpy import web_socket
-    from plexpy import webstart
-    from plexpy import config
+from plexpy import activity_handler
+from plexpy import activity_pinger
+from plexpy import common
+from plexpy import database
+from plexpy import datafactory
+from plexpy import exporter
+from plexpy import helpers
+from plexpy import libraries
+from plexpy import logger
+from plexpy import mobile_app
+from plexpy import newsletters
+from plexpy import newsletter_handler
+from plexpy import notification_handler
+from plexpy import notifiers
+from plexpy import plex
+from plexpy import plextv
+from plexpy import users
+from plexpy import versioncheck
+from plexpy import web_socket
+from plexpy import webstart
+from plexpy import config
 
 
 PROG_DIR = None
@@ -214,11 +185,10 @@ def initialize(config_file):
         logger.initLogger(console=not QUIET, log_dir=CONFIG.LOG_DIR if log_writable else None,
                           verbose=VERBOSE)
 
-        if not PYTHON2:
-            os.environ['PLEXAPI_CONFIG_PATH'] = os.path.join(DATA_DIR, 'plexapi.config.ini')
-            os.environ['PLEXAPI_LOG_PATH'] = os.path.join(CONFIG.LOG_DIR, 'plexapi.log')
-            os.environ['PLEXAPI_LOG_LEVEL'] = 'DEBUG'
-            plex.initialize_plexapi()
+        os.environ['PLEXAPI_CONFIG_PATH'] = os.path.join(DATA_DIR, 'plexapi.config.ini')
+        os.environ['PLEXAPI_LOG_PATH'] = os.path.join(CONFIG.LOG_DIR, 'plexapi.log')
+        os.environ['PLEXAPI_LOG_LEVEL'] = 'DEBUG'
+        plex.initialize_plexapi()
 
         if DOCKER:
             build = '[Docker] '
diff --git a/plexpy/activity_handler.py b/plexpy/activity_handler.py
index e98b881f..2758133b 100644
--- a/plexpy/activity_handler.py
+++ b/plexpy/activity_handler.py
@@ -13,10 +13,6 @@
 #  You should have received a copy of the GNU General Public License
 #  along with Tautulli.  If not, see <http://www.gnu.org/licenses/>.
 
-from __future__ import unicode_literals
-from future.builtins import str
-from future.builtins import object
-
 import datetime
 import os
 import time
@@ -25,22 +21,13 @@ from apscheduler.triggers.date import DateTrigger
 import pytz
 
 import plexpy
-if plexpy.PYTHON2:
-    import activity_processor
-    import common
-    import datafactory
-    import helpers
-    import logger
-    import notification_handler
-    import pmsconnect
-else:
-    from plexpy import activity_processor
-    from plexpy import common
-    from plexpy import datafactory
-    from plexpy import helpers
-    from plexpy import logger
-    from plexpy import notification_handler
-    from plexpy import pmsconnect
+from plexpy import activity_processor
+from plexpy import common
+from plexpy import datafactory
+from plexpy import helpers
+from plexpy import logger
+from plexpy import notification_handler
+from plexpy import pmsconnect
 
 
 ACTIVITY_SCHED = None
diff --git a/plexpy/activity_pinger.py b/plexpy/activity_pinger.py
index f349268c..9e8487fb 100644
--- a/plexpy/activity_pinger.py
+++ b/plexpy/activity_pinger.py
@@ -13,34 +13,18 @@
 #  You should have received a copy of the GNU General Public License
 #  along with Tautulli.  If not, see <http://www.gnu.org/licenses/>.
 
-from __future__ import unicode_literals
-from future.builtins import str
-
 import threading
 
 import plexpy
-if plexpy.PYTHON2:
-    import activity_handler
-    import activity_processor
-    import database
-    import helpers
-    import libraries
-    import logger
-    import notification_handler
-    import plextv
-    import pmsconnect
-    import web_socket
-else:
-    from plexpy import activity_handler
-    from plexpy import activity_processor
-    from plexpy import database
-    from plexpy import helpers
-    from plexpy import libraries
-    from plexpy import logger
-    from plexpy import notification_handler
-    from plexpy import plextv
-    from plexpy import pmsconnect
-    from plexpy import web_socket
+from plexpy import activity_handler
+from plexpy import activity_processor
+from plexpy import database
+from plexpy import helpers
+from plexpy import logger
+from plexpy import notification_handler
+from plexpy import plextv
+from plexpy import pmsconnect
+from plexpy import web_socket
 
 
 monitor_lock = threading.Lock()
diff --git a/plexpy/activity_processor.py b/plexpy/activity_processor.py
index d2b4b163..952d8e59 100644
--- a/plexpy/activity_processor.py
+++ b/plexpy/activity_processor.py
@@ -13,28 +13,16 @@
 #  You should have received a copy of the GNU General Public License
 #  along with Tautulli.  If not, see <http://www.gnu.org/licenses/>.
 
-from __future__ import unicode_literals
-from future.builtins import str
-from future.builtins import object
-
 from collections import defaultdict
 import json
 
 import plexpy
-if plexpy.PYTHON2:
-    import database
-    import helpers
-    import libraries
-    import logger
-    import pmsconnect
-    import users
-else:
-    from plexpy import database
-    from plexpy import helpers
-    from plexpy import libraries
-    from plexpy import logger
-    from plexpy import pmsconnect
-    from plexpy import users
+from plexpy import database
+from plexpy import helpers
+from plexpy import libraries
+from plexpy import logger
+from plexpy import pmsconnect
+from plexpy import users
 
 
 class ActivityProcessor(object):
diff --git a/plexpy/api2.py b/plexpy/api2.py
index eefaa9fd..9cc36b49 100644
--- a/plexpy/api2.py
+++ b/plexpy/api2.py
@@ -15,11 +15,6 @@
 #  You should have received a copy of the GNU General Public License
 #  along with Tautulli.  If not, see <http://www.gnu.org/licenses/>.
 
-
-from __future__ import unicode_literals
-from future.builtins import str
-from future.builtins import object
-
 from hashing_passwords import check_hash
 from io import open
 
@@ -36,34 +31,19 @@ import cherrypy
 import xmltodict
 
 import plexpy
-if plexpy.PYTHON2:
-    import common
-    import config
-    import database
-    import helpers
-    import libraries
-    import logger
-    import mobile_app
-    import notification_handler
-    import notifiers
-    import newsletter_handler
-    import newsletters
-    import plextv
-    import users
-else:
-    from plexpy import common
-    from plexpy import config
-    from plexpy import database
-    from plexpy import helpers
-    from plexpy import libraries
-    from plexpy import logger
-    from plexpy import mobile_app
-    from plexpy import notification_handler
-    from plexpy import notifiers
-    from plexpy import newsletter_handler
-    from plexpy import newsletters
-    from plexpy import plextv
-    from plexpy import users
+from plexpy import common
+from plexpy import config
+from plexpy import database
+from plexpy import helpers
+from plexpy import libraries
+from plexpy import logger
+from plexpy import mobile_app
+from plexpy import notification_handler
+from plexpy import notifiers
+from plexpy import newsletter_handler
+from plexpy import newsletters
+from plexpy import plextv
+from plexpy import users
 
 
 class API2(object):
diff --git a/plexpy/classes.py b/plexpy/classes.py
deleted file mode 100644
index 8480b952..00000000
--- a/plexpy/classes.py
+++ /dev/null
@@ -1,75 +0,0 @@
-# -*- coding: utf-8 -*-
-
-#  This file is part of Tautulli.
-#
-#  Tautulli is free software: you can redistribute it and/or modify
-#  it under the terms of the GNU General Public License as published by
-#  the Free Software Foundation, either version 3 of the License, or
-#  (at your option) any later version.
-#
-#  Tautulli is distributed in the hope that it will be useful,
-#  but WITHOUT ANY WARRANTY; without even the implied warranty of
-#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-#  GNU General Public License for more details.
-#
-#  You should have received a copy of the GNU General Public License
-#  along with Tautulli.  If not, see <http://www.gnu.org/licenses/>.
-
-#########################################
-## Stolen from Sick-Beard's classes.py ##
-#########################################
-
-
-from __future__ import unicode_literals
-
-from future.moves.urllib.request import FancyURLopener
-
-import plexpy
-if plexpy.PYTHON2:
-    from common import USER_AGENT
-else:
-    from plexpy.common import USER_AGENT
-
-
-class PlexPyURLopener(FancyURLopener):
-    version = USER_AGENT
-
-
-class AuthURLOpener(PlexPyURLopener):
-    """
-    URLOpener class that supports http auth without needing interactive password entry.
-    If the provided username/password don't work it simply fails.
-
-    user: username to use for HTTP auth
-    pw: password to use for HTTP auth
-    """
-
-    def __init__(self, user, pw):
-        self.username = user
-        self.password = pw
-
-        # remember if we've tried the username/password before
-        self.numTries = 0
-
-        # call the base class
-        FancyURLopener.__init__(self)
-
-    def prompt_user_passwd(self, host, realm):
-        """
-        Override this function and instead of prompting just give the
-        username/password that were provided when the class was instantiated.
-        """
-
-        # if this is the first try then provide a username/password
-        if self.numTries == 0:
-            self.numTries = 1
-            return (self.username, self.password)
-
-        # if we've tried before then return blank which cancels the request
-        else:
-            return ('', '')
-
-    # this is pretty much just a hack for convenience
-    def openit(self, url):
-        self.numTries = 0
-        return PlexPyURLopener.open(self, url)
diff --git a/plexpy/common.py b/plexpy/common.py
index 10679449..ae6f6c98 100644
--- a/plexpy/common.py
+++ b/plexpy/common.py
@@ -15,17 +15,11 @@
 #  You should have received a copy of the GNU General Public License
 #  along with Tautulli.  If not, see <http://www.gnu.org/licenses/>.
 
-from __future__ import unicode_literals
-
 import distro
 import platform
 from collections import OrderedDict
 
-import plexpy
-if plexpy.PYTHON2:
-    import version
-else:
-    from plexpy import version
+from plexpy import version
 
 
 # Identify Our Application
diff --git a/plexpy/config.py b/plexpy/config.py
index dbcd294d..c41e3b59 100644
--- a/plexpy/config.py
+++ b/plexpy/config.py
@@ -13,10 +13,6 @@
 #  You should have received a copy of the GNU General Public License
 #  along with Tautulli.  If not, see <http://www.gnu.org/licenses/>.
 
-from __future__ import unicode_literals
-from future.builtins import object
-from future.builtins import str
-
 import os
 import re
 import shutil
@@ -27,12 +23,8 @@ from configobj import ConfigObj, ParseError
 from hashing_passwords import make_hash
 
 import plexpy
-if plexpy.PYTHON2:
-    import helpers
-    import logger
-else:
-    from plexpy import helpers
-    from plexpy import logger
+from plexpy import helpers
+from plexpy import logger
 
 
 def bool_int(value):
diff --git a/plexpy/database.py b/plexpy/database.py
index 859d9274..4762805f 100644
--- a/plexpy/database.py
+++ b/plexpy/database.py
@@ -13,10 +13,6 @@
 #  You should have received a copy of the GNU General Public License
 #  along with Tautulli.  If not, see <http://www.gnu.org/licenses/>.
 
-from __future__ import unicode_literals
-from future.builtins import str
-from future.builtins import object
-
 import os
 import sqlite3
 import shutil
@@ -24,12 +20,8 @@ import threading
 import time
 
 import plexpy
-if plexpy.PYTHON2:
-    import helpers
-    import logger
-else:
-    from plexpy import helpers
-    from plexpy import logger
+from plexpy import helpers
+from plexpy import logger
 
 
 FILENAME = "tautulli.db"
diff --git a/plexpy/datafactory.py b/plexpy/datafactory.py
index d525c9c9..d48d3ea8 100644
--- a/plexpy/datafactory.py
+++ b/plexpy/datafactory.py
@@ -15,35 +15,17 @@
 #  You should have received a copy of the GNU General Public License
 #  along with Tautulli.  If not, see <http://www.gnu.org/licenses/>.
 
-from __future__ import division
-from __future__ import unicode_literals
-from future.builtins import next
-from future.builtins import str
-from future.builtins import object
-
 import json
 
 import plexpy
-if plexpy.PYTHON2:
-    import common
-    import database
-    import datatables
-    import libraries
-    import helpers
-    import logger
-    import pmsconnect
-    import session
-    import users
-else:
-    from plexpy import libraries
-    from plexpy import common
-    from plexpy import database
-    from plexpy import datatables
-    from plexpy import helpers
-    from plexpy import logger
-    from plexpy import pmsconnect
-    from plexpy import session
-    from plexpy import users
+from plexpy import common
+from plexpy import database
+from plexpy import datatables
+from plexpy import helpers
+from plexpy import logger
+from plexpy import pmsconnect
+from plexpy import session
+from plexpy import users
 
 # Temporarily store update_metadata row ids in memory to prevent rating_key collisions
 _UPDATE_METADATA_IDS = {
diff --git a/plexpy/datatables.py b/plexpy/datatables.py
index 47a913d6..68c76c57 100644
--- a/plexpy/datatables.py
+++ b/plexpy/datatables.py
@@ -13,20 +13,12 @@
 #  You should have received a copy of the GNU General Public License
 #  along with Tautulli.  If not, see <http://www.gnu.org/licenses/>.
 
-from __future__ import unicode_literals
-from future.builtins import object
-
 import re
 
 import plexpy
-if plexpy.PYTHON2:
-    import database
-    import helpers
-    import logger
-else:
-    from plexpy import database
-    from plexpy import helpers
-    from plexpy import logger
+from plexpy import database
+from plexpy import helpers
+from plexpy import logger
 
 
 class DataTables(object):
diff --git a/plexpy/exceptions.py b/plexpy/exceptions.py
index 96bb1032..cbbb0b2a 100644
--- a/plexpy/exceptions.py
+++ b/plexpy/exceptions.py
@@ -13,8 +13,6 @@
 #  You should have received a copy of the GNU General Public License
 #  along with Tautulli.  If not, see <http://www.gnu.org/licenses/>.
 
-from __future__ import unicode_literals
-
 
 class PlexPyException(Exception):
     """
diff --git a/plexpy/exporter.py b/plexpy/exporter.py
index efb1abf3..ef6e0da7 100644
--- a/plexpy/exporter.py
+++ b/plexpy/exporter.py
@@ -15,10 +15,7 @@
 #  You should have received a copy of the GNU General Public License
 #  along with Tautulli.  If not, see <http://www.gnu.org/licenses/>.
 
-from __future__ import unicode_literals
-from future.builtins import str
-from backports import csv
-
+import csv
 import json
 import os
 import requests
@@ -30,20 +27,12 @@ from io import open
 from multiprocessing.dummy import Pool as ThreadPool
 
 import plexpy
-if plexpy.PYTHON2:
-    import database
-    import datatables
-    import helpers
-    import logger
-    import users
-    from plex import Plex
-else:
-    from plexpy import database
-    from plexpy import datatables
-    from plexpy import helpers
-    from plexpy import logger
-    from plexpy import users
-    from plexpy.plex import Plex
+from plexpy import database
+from plexpy import datatables
+from plexpy import helpers
+from plexpy import logger
+from plexpy import users
+from plexpy.plex import Plex
 
 
 class Export(object):
diff --git a/plexpy/graphs.py b/plexpy/graphs.py
index 8758f71f..70122aee 100644
--- a/plexpy/graphs.py
+++ b/plexpy/graphs.py
@@ -15,28 +15,17 @@
 #  You should have received a copy of the GNU General Public License
 #  along with Tautulli.  If not, see <http://www.gnu.org/licenses/>.
 
-from __future__ import unicode_literals
-from future.builtins import str
-from future.builtins import range
-from future.builtins import object
+import datetime
 
 import arrow
-import datetime
+
 import plexpy
-if plexpy.PYTHON2:
-    import common
-    import database
-    import helpers
-    import logger
-    import libraries
-    import session
-else:
-    from plexpy import common
-    from plexpy import database
-    from plexpy import helpers
-    from plexpy import logger
-    from plexpy import libraries
-    from plexpy import session
+from plexpy import common
+from plexpy import database
+from plexpy import helpers
+from plexpy import logger
+from plexpy import libraries
+from plexpy import session
 
 
 class Graphs(object):
diff --git a/plexpy/helpers.py b/plexpy/helpers.py
index b2be62e2..014f1359 100644
--- a/plexpy/helpers.py
+++ b/plexpy/helpers.py
@@ -15,12 +15,6 @@
 #  You should have received a copy of the GNU General Public License
 #  along with Tautulli.  If not, see <http://www.gnu.org/licenses/>.
 
-from __future__ import division
-from __future__ import unicode_literals
-
-from future.builtins import zip
-from future.builtins import str
-
 import arrow
 import base64
 import cloudinary
@@ -50,21 +44,15 @@ import string
 import sys
 import time
 import unicodedata
-from future.moves.urllib.parse import urlencode
+from urllib.parse import urlencode
 from xml.dom import minidom
 import xmltodict
 
 import plexpy
-if plexpy.PYTHON2:
-    import common
-    import logger
-    import request
-    from api2 import API2
-else:
-    from plexpy import common
-    from plexpy import logger
-    from plexpy import request
-    from plexpy.api2 import API2
+from plexpy import common
+from plexpy import logger
+from plexpy import request
+from plexpy.api2 import API2
 
 
 def addtoapi(*dargs, **dkwargs):
@@ -870,17 +858,11 @@ def upload_to_cloudinary(img_data, img_title='', rating_key='', fallback=''):
         api_secret=plexpy.CONFIG.CLOUDINARY_API_SECRET
     )
 
-    # Cloudinary library has very poor support for non-ASCII characters on Python 2
-    if plexpy.PYTHON2:
-        _img_title = latinToAscii(img_title, replace=True)
-    else:
-        _img_title = img_title
-
     try:
         response = upload((img_title, img_data),
                           public_id='{}_{}'.format(fallback, rating_key),
                           tags=['tautulli', fallback, str(rating_key)],
-                          context={'title': _img_title, 'rating_key': str(rating_key), 'fallback': fallback})
+                          context={'title': img_title, 'rating_key': str(rating_key), 'fallback': fallback})
         logger.debug("Tautulli Helpers :: Image '{}' ({}) uploaded to Cloudinary.".format(img_title, fallback))
         img_url = response.get('url', '')
     except Exception as e:
@@ -1266,11 +1248,7 @@ def split_args(args=None):
     if isinstance(args, list):
         return args
     elif isinstance(args, str):
-        if plexpy.PYTHON2:
-            args = args.encode('utf-8')
         args = shlex.split(args)
-        if plexpy.PYTHON2:
-            args = [a.decode('utf-8') for a in args]
         return args
     return []
 
diff --git a/plexpy/http_handler.py b/plexpy/http_handler.py
index 3596fa12..3ba32a6e 100644
--- a/plexpy/http_handler.py
+++ b/plexpy/http_handler.py
@@ -15,24 +15,16 @@
 #  You should have received a copy of the GNU General Public License
 #  along with PlexPy.  If not, see <http://www.gnu.org/licenses/>.
 
-from __future__ import unicode_literals
-from future.builtins import object
-from future.builtins import str
-
 from multiprocessing.dummy import Pool as ThreadPool
-from future.moves.urllib.parse import urljoin
+from urllib.parse import urljoin
 
 import certifi
 import requests
 import urllib3
 
 import plexpy
-if plexpy.PYTHON2:
-    import helpers
-    import logger
-else:
-    from plexpy import helpers
-    from plexpy import logger
+from plexpy import helpers
+from plexpy import logger
 
 
 class HTTPHandler(object):
diff --git a/plexpy/libraries.py b/plexpy/libraries.py
index 33832aba..454f6128 100644
--- a/plexpy/libraries.py
+++ b/plexpy/libraries.py
@@ -15,38 +15,20 @@
 #  You should have received a copy of the GNU General Public License
 #  along with Tautulli.  If not, see <http://www.gnu.org/licenses/>.
 
-from __future__ import unicode_literals
-from future.builtins import str
-from future.builtins import next
-from future.builtins import object
-
 import json
 import os
-from datetime import datetime, timedelta
 
 import plexpy
-if plexpy.PYTHON2:
-    import common
-    import database
-    import datatables
-    import helpers
-    import logger
-    import plextv
-    import pmsconnect
-    import session
-    import users
-    from plex import Plex
-else:
-    from plexpy import common
-    from plexpy import database
-    from plexpy import datatables
-    from plexpy import helpers
-    from plexpy import logger
-    from plexpy import plextv
-    from plexpy import pmsconnect
-    from plexpy import session
-    from plexpy import users
-    from plexpy.plex import Plex
+from plexpy import common
+from plexpy import database
+from plexpy import datatables
+from plexpy import helpers
+from plexpy import logger
+from plexpy import plextv
+from plexpy import pmsconnect
+from plexpy import session
+from plexpy import users
+from plexpy.plex import Plex
 
 
 def refresh_libraries():
diff --git a/plexpy/lock.py b/plexpy/lock.py
index 6cdc6800..570803bc 100644
--- a/plexpy/lock.py
+++ b/plexpy/lock.py
@@ -15,18 +15,12 @@
 #  You should have received a copy of the GNU General Public License
 #  along with Tautulli.  If not, see <http://www.gnu.org/licenses/>.
 
-from __future__ import unicode_literals
-from future.builtins import object
-
-import future.moves.queue as queue
+import queue
 import time
 import threading
 
 import plexpy
-if plexpy.PYTHON2:
-    import logger
-else:
-    from plexpy import logger
+from plexpy import logger
 
 
 class TimedLock(object):
diff --git a/plexpy/log_reader.py b/plexpy/log_reader.py
index 358ca86c..63a55d71 100644
--- a/plexpy/log_reader.py
+++ b/plexpy/log_reader.py
@@ -15,18 +15,13 @@
 #  You should have received a copy of the GNU General Public License
 #  along with Tautulli.  If not, see <http://www.gnu.org/licenses/>.
 
-from __future__ import unicode_literals
 from io import open
 
 import os
 
 import plexpy
-if plexpy.PYTHON2:
-    import helpers
-    import logger
-else:
-    from plexpy import helpers
-    from plexpy import logger
+from plexpy import helpers
+from plexpy import logger
 
 
 def list_plex_logs():
diff --git a/plexpy/logger.py b/plexpy/logger.py
index 7227ab10..b4f0f3f3 100644
--- a/plexpy/logger.py
+++ b/plexpy/logger.py
@@ -15,9 +15,6 @@
 #  You should have received a copy of the GNU General Public License
 #  along with Tautulli.  If not, see <http://www.gnu.org/licenses/>.
 
-from __future__ import unicode_literals
-from future.builtins import str
-
 from logging import handlers
 
 import cherrypy
@@ -29,13 +26,8 @@ import threading
 import traceback
 
 import plexpy
-if plexpy.PYTHON2:
-    import helpers
-    import users
-    from config import _BLACKLIST_KEYS, _WHITELIST_KEYS
-else:
-    from plexpy import helpers, users
-    from plexpy.config import _BLACKLIST_KEYS, _WHITELIST_KEYS
+from plexpy import helpers, users
+from plexpy.config import _BLACKLIST_KEYS, _WHITELIST_KEYS
 
 
 # These settings are for file logging only
diff --git a/plexpy/macos.py b/plexpy/macos.py
index 4dafaa13..d2589fad 100644
--- a/plexpy/macos.py
+++ b/plexpy/macos.py
@@ -31,14 +31,9 @@ if HAS_PYOBJC:
     import rumps
 
 import plexpy
-if plexpy.PYTHON2:
-    import common
-    import logger
-    import versioncheck
-else:
-    from plexpy import common
-    from plexpy import logger
-    from plexpy import versioncheck
+from plexpy import common
+from plexpy import logger
+from plexpy import versioncheck
 
 
 class MacOSSystemTray(object):
diff --git a/plexpy/mobile_app.py b/plexpy/mobile_app.py
index 57734975..4d1267a1 100644
--- a/plexpy/mobile_app.py
+++ b/plexpy/mobile_app.py
@@ -15,21 +15,12 @@
 #  You should have received a copy of the GNU General Public License
 #  along with Tautulli.  If not, see <http://www.gnu.org/licenses/>.
 
-from __future__ import unicode_literals
-from future.builtins import str
-
 import requests
 import threading
 
-import plexpy
-if plexpy.PYTHON2:
-    import database
-    import helpers
-    import logger
-else:
-    from plexpy import database
-    from plexpy import helpers
-    from plexpy import logger
+from plexpy import database
+from plexpy import helpers
+from plexpy import logger
 
 
 _ONESIGNAL_APP_ID = '3b4b666a-d557-4b92-acdf-e2c8c4b95357'
diff --git a/plexpy/newsletter_handler.py b/plexpy/newsletter_handler.py
index 471a5984..69d646d9 100644
--- a/plexpy/newsletter_handler.py
+++ b/plexpy/newsletter_handler.py
@@ -15,8 +15,6 @@
 #  You should have received a copy of the GNU General Public License
 #  along with Tautulli.  If not, see <http://www.gnu.org/licenses/>.
 
-from __future__ import unicode_literals
-
 from io import open
 import os
 
@@ -24,16 +22,10 @@ from apscheduler.triggers.cron import CronTrigger
 import email.utils
 
 import plexpy
-if plexpy.PYTHON2:
-    import database
-    import helpers
-    import logger
-    import newsletters
-else:
-    from plexpy import database
-    from plexpy import helpers
-    from plexpy import logger
-    from plexpy import newsletters
+from plexpy import database
+from plexpy import helpers
+from plexpy import logger
+from plexpy import newsletters
 
 
 NEWSLETTER_SCHED = None
diff --git a/plexpy/newsletters.py b/plexpy/newsletters.py
index 5fe8448c..7641decf 100644
--- a/plexpy/newsletters.py
+++ b/plexpy/newsletters.py
@@ -15,39 +15,25 @@
 #  You should have received a copy of the GNU General Public License
 #  along with Tautulli.  If not, see <http://www.gnu.org/licenses/>.
 
-from __future__ import unicode_literals
-from future.builtins import next
-from future.builtins import str
-from future.builtins import object
-
-import arrow
 from collections import OrderedDict
 import json
 from itertools import groupby
-from mako.lookup import TemplateLookup
-from mako import exceptions
 import os
 import re
 
+import arrow
+from mako.lookup import TemplateLookup
+from mako import exceptions
+
 import plexpy
-if plexpy.PYTHON2:
-    import common
-    import database
-    import helpers
-    import libraries
-    import logger
-    import newsletter_handler
-    import pmsconnect
-    from notifiers import send_notification, EMAIL
-else:
-    from plexpy import common
-    from plexpy import database
-    from plexpy import helpers
-    from plexpy import libraries
-    from plexpy import logger
-    from plexpy import newsletter_handler
-    from plexpy import pmsconnect
-    from plexpy.notifiers import send_notification, EMAIL
+from plexpy import common
+from plexpy import database
+from plexpy import helpers
+from plexpy import libraries
+from plexpy import logger
+from plexpy import newsletter_handler
+from plexpy import pmsconnect
+from plexpy.notifiers import send_notification, EMAIL
 
 
 AGENT_IDS = {
diff --git a/plexpy/notification_handler.py b/plexpy/notification_handler.py
index c58bae9a..e981b17b 100644
--- a/plexpy/notification_handler.py
+++ b/plexpy/notification_handler.py
@@ -15,16 +15,6 @@
 #  You should have received a copy of the GNU General Public License
 #  along with Tautulli.  If not, see <http://www.gnu.org/licenses/>.
 
-
-from __future__ import division
-from __future__ import unicode_literals
-from typing import Optional
-from future.builtins import next
-from future.builtins import map
-from future.builtins import str
-from future.builtins import range
-
-import arrow
 import bleach
 from collections import Counter, defaultdict
 from functools import partial
@@ -36,32 +26,22 @@ import os
 import re
 from string import Formatter
 import threading
+from typing import Optional
 
+import arrow
 import musicbrainzngs
 
 import plexpy
-if plexpy.PYTHON2:
-    import activity_processor
-    import common
-    import database
-    import datafactory
-    import logger
-    import helpers
-    import notifiers
-    import pmsconnect
-    import request
-    from newsletter_handler import notify as notify_newsletter
-else:
-    from plexpy import activity_processor
-    from plexpy import common
-    from plexpy import database
-    from plexpy import datafactory
-    from plexpy import logger
-    from plexpy import helpers
-    from plexpy import notifiers
-    from plexpy import pmsconnect
-    from plexpy import request
-    from plexpy.newsletter_handler import notify as notify_newsletter
+from plexpy import activity_processor
+from plexpy import common
+from plexpy import database
+from plexpy import datafactory
+from plexpy import logger
+from plexpy import helpers
+from plexpy import notifiers
+from plexpy import pmsconnect
+from plexpy import request
+from plexpy.newsletter_handler import notify as notify_newsletter
 
 
 def process_queue():
@@ -2090,14 +2070,10 @@ class CustomFormatter(Formatter):
                 obj = self.convert_field(obj, conversion)
 
                 # expand the format spec, if needed
-                if plexpy.PYTHON2:
-                    format_spec = self._vformat(format_spec, args, kwargs,
-                                                used_args, recursion_depth - 1)
-                else:
-                    format_spec, auto_arg_index = self._vformat(
-                        format_spec, args, kwargs,
-                        used_args, recursion_depth-1,
-                        auto_arg_index=auto_arg_index)
+                format_spec, auto_arg_index = self._vformat(
+                    format_spec, args, kwargs,
+                    used_args, recursion_depth-1,
+                    auto_arg_index=auto_arg_index)
 
                 # format the object and append to the result
                 formatted_field = self.format_field(obj, format_spec)
@@ -2109,10 +2085,7 @@ class CustomFormatter(Formatter):
                         result.append(suffix)
                 # result.append(self.format_field(obj, format_spec))
 
-        if plexpy.PYTHON2:
-            return ''.join(result)
-        else:
-            return ''.join(result), auto_arg_index
+        return ''.join(result), auto_arg_index
 
 
 class CustomArrow:
diff --git a/plexpy/notifiers.py b/plexpy/notifiers.py
index 4d7c9735..5305ffa2 100644
--- a/plexpy/notifiers.py
+++ b/plexpy/notifiers.py
@@ -15,30 +15,27 @@
 #  You should have received a copy of the GNU General Public License
 #  along with Tautulli.  If not, see <http://www.gnu.org/licenses/>.
 
-from __future__ import unicode_literals
-from future.builtins import str
-from future.builtins import object
-
 import base64
-import bleach
 from collections import defaultdict
-import json
 from email.mime.multipart import MIMEMultipart
 from email.mime.text import MIMEText
 import email.utils
-import paho.mqtt.client
-import paho.mqtt.publish
+import json
 import os
 import re
-import requests
-from requests.auth import HTTPBasicAuth
 import smtplib
 import subprocess
 import sys
 import threading
 import time
-from future.moves.urllib.parse import urlencode
-from future.moves.urllib.parse import urlparse
+from urllib.parse import urlencode
+from urllib.parse import urlparse
+
+import bleach
+import paho.mqtt.client
+import paho.mqtt.publish
+import requests
+from requests.auth import HTTPBasicAuth
 
 try:
     from Cryptodome.Protocol.KDF import PBKDF2
@@ -61,24 +58,14 @@ import facebook
 import twitter
 
 import plexpy
-if plexpy.PYTHON2:
-    import common
-    import database
-    import helpers
-    import logger
-    import mobile_app
-    import pmsconnect
-    import request
-    import users
-else:
-    from plexpy import common
-    from plexpy import database
-    from plexpy import helpers
-    from plexpy import logger
-    from plexpy import mobile_app
-    from plexpy import pmsconnect
-    from plexpy import request
-    from plexpy import users
+from plexpy import common
+from plexpy import database
+from plexpy import helpers
+from plexpy import logger
+from plexpy import mobile_app
+from plexpy import pmsconnect
+from plexpy import request
+from plexpy import users
 
 
 BROWSER_NOTIFIERS = {}
@@ -3451,9 +3438,6 @@ class SCRIPTS(Notifier):
         if self.pythonpath and plexpy.INSTALL_TYPE not in ('windows', 'macos'):
             custom_env['PYTHONPATH'] = os.pathsep.join([p for p in sys.path if p])
 
-        if plexpy.PYTHON2:
-            custom_env = {k.encode('utf-8'): v.encode('utf-8') for k, v in custom_env.items()}
-
         env = os.environ.copy()
         env.update(custom_env)
 
@@ -3558,9 +3542,6 @@ class SCRIPTS(Notifier):
 
         script.extend(script_args)
 
-        if plexpy.PYTHON2:
-            script = [s.encode(plexpy.SYS_ENCODING, 'ignore') for s in script]
-
         logger.debug("Tautulli Notifiers :: Full script is: %s" % script)
         logger.debug("Tautulli Notifiers :: Executing script in a new thread.")
         thread = threading.Thread(target=self.run_script, args=(script, user_id)).start()
diff --git a/plexpy/plex.py b/plexpy/plex.py
index 29379053..05a1bbb8 100644
--- a/plexpy/plex.py
+++ b/plexpy/plex.py
@@ -15,16 +15,7 @@
 #  You should have received a copy of the GNU General Public License
 #  along with Tautulli.  If not, see <http://www.gnu.org/licenses/>.
 
-from __future__ import unicode_literals
-from future.builtins import object
-from future.builtins import str
-
 import plexpy
-if plexpy.PYTHON2:
-    import logger
-else:
-    from plexpy import logger
-
 
 class DummyObject(object):
     def __init__(self, *args, **kwargs):
diff --git a/plexpy/plexivity_import.py b/plexpy/plexivity_import.py
index 644782a2..291abf19 100644
--- a/plexpy/plexivity_import.py
+++ b/plexpy/plexivity_import.py
@@ -15,26 +15,16 @@
 #  You should have received a copy of the GNU General Public License
 #  along with Tautulli.  If not, see <http://www.gnu.org/licenses/>.
 
-from __future__ import unicode_literals
-from future.builtins import str
-
-import arrow
 import sqlite3
 from xml.dom import minidom
 
-import plexpy
-if plexpy.PYTHON2:
-    import activity_processor
-    import database
-    import helpers
-    import logger
-    import users
-else:
-    from plexpy import activity_processor
-    from plexpy import database
-    from plexpy import helpers
-    from plexpy import logger
-    from plexpy import users
+import arrow
+
+from plexpy import activity_processor
+from plexpy import database
+from plexpy import helpers
+from plexpy import logger
+from plexpy import users
 
 
 def extract_plexivity_xml(xml=None):
diff --git a/plexpy/plextv.py b/plexpy/plextv.py
index d3afb26a..d45ce785 100644
--- a/plexpy/plextv.py
+++ b/plexpy/plextv.py
@@ -15,33 +15,18 @@
 #  You should have received a copy of the GNU General Public License
 #  along with Tautulli.  If not, see <http://www.gnu.org/licenses/>.
 
-from __future__ import unicode_literals
-from future.builtins import next
-from future.builtins import str
-from future.builtins import object
-from future.moves.urllib.parse import unquote
-
 import json
+from urllib.parse import unquote
 
 import plexpy
-if plexpy.PYTHON2:
-    import common
-    import helpers
-    import http_handler
-    import logger
-    import users
-    import pmsconnect
-    import session
-    from plex import Plex
-else:
-    from plexpy import common
-    from plexpy import helpers
-    from plexpy import http_handler
-    from plexpy import logger
-    from plexpy import users
-    from plexpy import pmsconnect
-    from plexpy import session
-    from plexpy.plex import Plex
+from plexpy import common
+from plexpy import helpers
+from plexpy import http_handler
+from plexpy import logger
+from plexpy import users
+from plexpy import pmsconnect
+from plexpy import session
+from plexpy.plex import Plex
 
 
 def get_server_resources(return_presence=False, return_server=False, return_info=False, **kwargs):
diff --git a/plexpy/plexwatch_import.py b/plexpy/plexwatch_import.py
index 4d8ec80b..ac4ffdbe 100644
--- a/plexpy/plexwatch_import.py
+++ b/plexpy/plexwatch_import.py
@@ -15,25 +15,14 @@
 #  You should have received a copy of the GNU General Public License
 #  along with Tautulli.  If not, see <http://www.gnu.org/licenses/>.
 
-from __future__ import unicode_literals
-from future.builtins import str
-
 import sqlite3
 from xml.dom import minidom
 
-import plexpy
-if plexpy.PYTHON2:
-    import activity_processor
-    import database
-    import helpers
-    import logger
-    import users
-else:
-    from plexpy import activity_processor
-    from plexpy import database
-    from plexpy import helpers
-    from plexpy import logger
-    from plexpy import users
+from plexpy import activity_processor
+from plexpy import database
+from plexpy import helpers
+from plexpy import logger
+from plexpy import users
 
 
 def extract_plexwatch_xml(xml=None):
diff --git a/plexpy/pmsconnect.py b/plexpy/pmsconnect.py
index 2662abf9..fa36219f 100644
--- a/plexpy/pmsconnect.py
+++ b/plexpy/pmsconnect.py
@@ -15,38 +15,22 @@
 #  You should have received a copy of the GNU General Public License
 #  along with Tautulli.  If not, see <http://www.gnu.org/licenses/>.
 
-from __future__ import unicode_literals
-from future.builtins import next
-from future.builtins import str
-from future.builtins import object
-
 import json
 import os
 import time
-from future.moves.urllib.parse import quote, quote_plus, urlencode
+from urllib.parse import quote, quote_plus, urlencode
 from xml.dom.minidom import Node
 
 import plexpy
-if plexpy.PYTHON2:
-    import activity_processor
-    import common
-    import helpers
-    import http_handler
-    import libraries
-    import logger
-    import plextv
-    import session
-    import users
-else:
-    from plexpy import activity_processor
-    from plexpy import common
-    from plexpy import helpers
-    from plexpy import http_handler
-    from plexpy import libraries
-    from plexpy import logger
-    from plexpy import plextv
-    from plexpy import session
-    from plexpy import users
+from plexpy import activity_processor
+from plexpy import common
+from plexpy import helpers
+from plexpy import http_handler
+from plexpy import libraries
+from plexpy import logger
+from plexpy import plextv
+from plexpy import session
+from plexpy import users
 
 
 def get_server_friendly_name():
diff --git a/plexpy/request.py b/plexpy/request.py
index 50bb8a0a..c2f0967f 100644
--- a/plexpy/request.py
+++ b/plexpy/request.py
@@ -15,23 +15,16 @@
 #  You should have received a copy of the GNU General Public License
 #  along with Tautulli.  If not, see <http://www.gnu.org/licenses/>.
 
-from __future__ import unicode_literals
-from future.builtins import str
-
-from bs4 import BeautifulSoup
+import collections
 from xml.dom import minidom
 
-import collections
+from bs4 import BeautifulSoup
 import requests
 from requests.packages import urllib3
 
 import plexpy
-if plexpy.PYTHON2:
-    import lock
-    import logger
-else:
-    from plexpy import lock
-    from plexpy import logger
+from plexpy import lock
+from plexpy import logger
 
 
 # Dictionary with last request times, for rate limiting.
diff --git a/plexpy/session.py b/plexpy/session.py
index 21c14430..368e5da7 100644
--- a/plexpy/session.py
+++ b/plexpy/session.py
@@ -15,18 +15,11 @@
 #  You should have received a copy of the GNU General Public License
 #  along with Tautulli.  If not, see <http://www.gnu.org/licenses/>.
 
-from __future__ import unicode_literals
-from future.builtins import str
-
 import cherrypy
 
 import plexpy
-if plexpy.PYTHON2:
-    import common
-    import users
-else:
-    from plexpy import common
-    from plexpy import users
+from plexpy import common
+from plexpy import users
 
 
 def get_session_info():
diff --git a/plexpy/users.py b/plexpy/users.py
index 67293800..447f20a1 100644
--- a/plexpy/users.py
+++ b/plexpy/users.py
@@ -15,35 +15,20 @@
 #  You should have received a copy of the GNU General Public License
 #  along with Tautulli.  If not, see <http://www.gnu.org/licenses/>.
 
-from __future__ import unicode_literals
-from future.builtins import next
-from future.builtins import str
-from future.builtins import object
-from future.moves.urllib.parse import parse_qsl
+from urllib.parse import parse_qsl
 
 import arrow
 import httpagentparser
-from datetime import datetime, timedelta
 
 import plexpy
-if plexpy.PYTHON2:
-    import common
-    import database
-    import datatables
-    import helpers
-    import libraries
-    import logger
-    import plextv
-    import session
-else:
-    from plexpy import common
-    from plexpy import database
-    from plexpy import datatables
-    from plexpy import helpers
-    from plexpy import libraries
-    from plexpy import logger
-    from plexpy import plextv
-    from plexpy import session
+from plexpy import common
+from plexpy import database
+from plexpy import datatables
+from plexpy import helpers
+from plexpy import libraries
+from plexpy import logger
+from plexpy import plextv
+from plexpy import session
 
 
 def refresh_users():
diff --git a/plexpy/version.py b/plexpy/version.py
index e0d43b73..46b4390e 100644
--- a/plexpy/version.py
+++ b/plexpy/version.py
@@ -15,7 +15,5 @@
 #  You should have received a copy of the GNU General Public License
 #  along with Tautulli.  If not, see <http://www.gnu.org/licenses/>.
 
-from __future__ import unicode_literals
-
 PLEXPY_BRANCH = "beta"
 PLEXPY_RELEASE_VERSION = "v2.14.0-beta"
\ No newline at end of file
diff --git a/plexpy/versioncheck.py b/plexpy/versioncheck.py
index 2f07d7ae..442dcc23 100644
--- a/plexpy/versioncheck.py
+++ b/plexpy/versioncheck.py
@@ -15,11 +15,6 @@
 #  You should have received a copy of the GNU General Public License
 #  along with Tautulli.  If not, see <http://www.gnu.org/licenses/>.
 
-from __future__ import division
-from __future__ import unicode_literals
-from future.builtins import next
-from future.builtins import str
-
 import json
 import os
 import platform
@@ -29,16 +24,10 @@ import subprocess
 import tarfile
 
 import plexpy
-if plexpy.PYTHON2:
-    import common
-    import helpers
-    import logger
-    import request
-else:
-    from plexpy import common
-    from plexpy import helpers
-    from plexpy import logger
-    from plexpy import request
+from plexpy import common
+from plexpy import helpers
+from plexpy import logger
+from plexpy import request
 
 
 def runGit(args):
@@ -292,9 +281,6 @@ def check_github(scheduler=False, notify=False, use_cache=False):
                                      'plexpy_update_commit': plexpy.LATEST_VERSION,
                                      'plexpy_update_behind': plexpy.COMMITS_BEHIND})
 
-        if plexpy.PYTHON2:
-            logger.warn('Tautulli is running using Python 2. Unable to run automatic update.')
-
         elif scheduler and plexpy.CONFIG.PLEXPY_AUTO_UPDATE and \
                 not plexpy.DOCKER and not plexpy.SNAP and not plexpy.FROZEN:
             logger.info('Running automatic update.')
@@ -307,10 +293,6 @@ def check_github(scheduler=False, notify=False, use_cache=False):
 
 
 def update():
-    if plexpy.PYTHON2:
-        logger.warn('Tautulli is running using Python 2. Unable to update.')
-        return
-
     if not plexpy.UPDATE_AVAILABLE:
         return
 
diff --git a/plexpy/web_socket.py b/plexpy/web_socket.py
index b70d4b6e..1737c02d 100644
--- a/plexpy/web_socket.py
+++ b/plexpy/web_socket.py
@@ -17,9 +17,6 @@
 
 # Mostly borrowed from https://github.com/trakt/Plex-Trakt-Scrobbler
 
-from __future__ import unicode_literals
-from future.builtins import str
-
 import json
 import ssl
 import threading
@@ -29,18 +26,11 @@ import certifi
 import websocket
 
 import plexpy
-if plexpy.PYTHON2:
-    import activity_handler
-    import activity_pinger
-    import activity_processor
-    import database
-    import logger
-else:
-    from plexpy import activity_handler
-    from plexpy import activity_pinger
-    from plexpy import activity_processor
-    from plexpy import database
-    from plexpy import logger
+from plexpy import activity_handler
+from plexpy import activity_pinger
+from plexpy import activity_processor
+from plexpy import database
+from plexpy import logger
 
 
 name = 'websocket'
diff --git a/plexpy/webauth.py b/plexpy/webauth.py
index 768b2d64..05c81a81 100644
--- a/plexpy/webauth.py
+++ b/plexpy/webauth.py
@@ -20,28 +20,19 @@
 # Form based authentication for CherryPy. Requires the
 # Session tool to be loaded.
 
-from future.builtins import object
-
 from datetime import datetime, timedelta, timezone
-from future.moves.urllib.parse import quote, unquote
+from urllib.parse import quote, unquote
 
 import cherrypy
 from hashing_passwords import check_hash
 import jwt
 
 import plexpy
-if plexpy.PYTHON2:
-    import logger
-    from database import MonitorDatabase
-    from helpers import timestamp
-    from users import Users, refresh_users
-    from plextv import PlexTV
-else:
-    from plexpy import logger
-    from plexpy.database import MonitorDatabase
-    from plexpy.helpers import timestamp
-    from plexpy.users import Users, refresh_users
-    from plexpy.plextv import PlexTV
+from plexpy import logger
+from plexpy.database import MonitorDatabase
+from plexpy.helpers import timestamp
+from plexpy.users import Users, refresh_users
+from plexpy.plextv import PlexTV
 
 # Monkey patch SameSite support into cookies.
 # https://stackoverflow.com/a/50813092
diff --git a/plexpy/webserve.py b/plexpy/webserve.py
index 7e0c083b..444d5a68 100644
--- a/plexpy/webserve.py
+++ b/plexpy/webserve.py
@@ -15,23 +15,18 @@
 #  You should have received a copy of the GNU General Public License
 #  along with Tautulli.  If not, see <http://www.gnu.org/licenses/>.
 
-from __future__ import unicode_literals
-from future.builtins import next
-from future.builtins import object
-from future.builtins import str
-from backports import csv
-
-from io import open, BytesIO
 import base64
+import csv
+from io import open, BytesIO
 import json
-import ssl as _ssl
 import linecache
 import os
 import shutil
+import ssl as _ssl
 import sys
 import threading
 import zipfile
-from future.moves.urllib.parse import urlencode
+from urllib.parse import urlencode
 
 import cherrypy
 from cherrypy.lib.static import serve_file, serve_fileobj, serve_download
@@ -49,76 +44,40 @@ if sys.version_info >= (3, 6):
     import secrets
 
 import plexpy
-if plexpy.PYTHON2:
-    import activity_pinger
-    import activity_processor
-    import common
-    import config
-    import database
-    import datafactory
-    import exporter
-    import graphs
-    import helpers
-    import http_handler
-    import libraries
-    import log_reader
-    import logger
-    import newsletter_handler
-    import newsletters
-    import mobile_app
-    import notification_handler
-    import notifiers
-    import plextv
-    import plexivity_import
-    import plexwatch_import
-    import pmsconnect
-    import users
-    import versioncheck
-    import web_socket
-    import webstart
-    from api2 import API2
-    from helpers import checked, addtoapi, get_ip, create_https_certificates, build_datatables_json, sanitize_out
-    from session import get_session_info, get_session_user_id, allow_session_user, allow_session_library
-    from webauth import AuthController, requireAuth, member_of, check_auth, get_jwt_token
-    if common.PLATFORM == 'Windows':
-        import windows
-    elif common.PLATFORM == 'Darwin':
-        import macos
-else:
-    from plexpy import activity_pinger
-    from plexpy import activity_processor
-    from plexpy import common
-    from plexpy import config
-    from plexpy import database
-    from plexpy import datafactory
-    from plexpy import exporter
-    from plexpy import graphs
-    from plexpy import helpers
-    from plexpy import http_handler
-    from plexpy import libraries
-    from plexpy import log_reader
-    from plexpy import logger
-    from plexpy import newsletter_handler
-    from plexpy import newsletters
-    from plexpy import mobile_app
-    from plexpy import notification_handler
-    from plexpy import notifiers
-    from plexpy import plextv
-    from plexpy import plexivity_import
-    from plexpy import plexwatch_import
-    from plexpy import pmsconnect
-    from plexpy import users
-    from plexpy import versioncheck
-    from plexpy import web_socket
-    from plexpy import webstart
-    from plexpy.api2 import API2
-    from plexpy.helpers import checked, addtoapi, get_ip, create_https_certificates, build_datatables_json, sanitize_out
-    from plexpy.session import get_session_info, get_session_user_id, allow_session_user, allow_session_library
-    from plexpy.webauth import AuthController, requireAuth, member_of, check_auth, get_jwt_token
-    if common.PLATFORM == 'Windows':
-        from plexpy import windows
-    elif common.PLATFORM == 'Darwin':
-        from plexpy import macos
+from plexpy import activity_pinger
+from plexpy import activity_processor
+from plexpy import common
+from plexpy import config
+from plexpy import database
+from plexpy import datafactory
+from plexpy import exporter
+from plexpy import graphs
+from plexpy import helpers
+from plexpy import http_handler
+from plexpy import libraries
+from plexpy import log_reader
+from plexpy import logger
+from plexpy import newsletter_handler
+from plexpy import newsletters
+from plexpy import mobile_app
+from plexpy import notification_handler
+from plexpy import notifiers
+from plexpy import plextv
+from plexpy import plexivity_import
+from plexpy import plexwatch_import
+from plexpy import pmsconnect
+from plexpy import users
+from plexpy import versioncheck
+from plexpy import web_socket
+from plexpy import webstart
+from plexpy.api2 import API2
+from plexpy.helpers import checked, addtoapi, get_ip, create_https_certificates, build_datatables_json, sanitize_out
+from plexpy.session import get_session_info, get_session_user_id, allow_session_user, allow_session_library
+from plexpy.webauth import AuthController, requireAuth, member_of, check_auth, get_jwt_token
+if common.PLATFORM == 'Windows':
+    from plexpy import windows
+elif common.PLATFORM == 'Darwin':
+    from plexpy import macos
 
 
 TEMPLATE_LOOKUP = None
@@ -4367,8 +4326,6 @@ class WebInterface(object):
     @cherrypy.expose
     @requireAuth(member_of("admin"))
     def update(self, **kwargs):
-        if plexpy.PYTHON2:
-            raise cherrypy.HTTPRedirect(plexpy.HTTP_ROOT + "home?update=python2")
         if plexpy.DOCKER or plexpy.SNAP:
             raise cherrypy.HTTPRedirect(plexpy.HTTP_ROOT + "home")
 
diff --git a/plexpy/webstart.py b/plexpy/webstart.py
index c8ed258f..b02e9ec1 100644
--- a/plexpy/webstart.py
+++ b/plexpy/webstart.py
@@ -22,16 +22,10 @@ import sys
 import cherrypy
 
 import plexpy
-if plexpy.PYTHON2:
-    import logger
-    import webauth
-    from helpers import create_https_certificates
-    from webserve import WebInterface, BaseRedirect
-else:
-    from plexpy import logger
-    from plexpy import webauth
-    from plexpy.helpers import create_https_certificates
-    from plexpy.webserve import WebInterface, BaseRedirect
+from plexpy import logger
+from plexpy import webauth
+from plexpy.helpers import create_https_certificates
+from plexpy.webserve import WebInterface, BaseRedirect
 
 
 def start():
diff --git a/plexpy/windows.py b/plexpy/windows.py
index 3f94b9f0..857e8a0e 100644
--- a/plexpy/windows.py
+++ b/plexpy/windows.py
@@ -17,6 +17,7 @@
 
 import os
 import sys
+
 from infi.systray import SysTrayIcon
 
 try:
@@ -30,14 +31,9 @@ except ImportError:
     import _winreg as winreg
 
 import plexpy
-if plexpy.PYTHON2:
-    import common
-    import logger
-    import versioncheck
-else:
-    from plexpy import common
-    from plexpy import logger
-    from plexpy import versioncheck
+from plexpy import common
+from plexpy import logger
+from plexpy import versioncheck
 
 
 class WindowsSystemTray(object):
diff --git a/requirements.txt b/requirements.txt
index dceda760..2d8c8448 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,18 +1,16 @@
 apscheduler==3.10.1
 arrow==1.3.0
-backports.csv==1.0.7
-backports.functools-lru-cache==2.0.0
 backports.zoneinfo==0.2.1;python_version<"3.9"
 beautifulsoup4==4.12.3
 bleach==6.1.0
 certifi==2024.2.2
 cheroot==10.0.0
-cloudinary==1.39.1
 cherrypy==18.9.0
+cloudinary==1.39.1
 distro==1.9.0
 dnspython==2.6.1
 facebook-sdk==3.1.0
-future==0.18.3
+future==1.0.0
 ga4mp==2.0.4
 gntp==1.0.3
 html5lib==1.1

From bcac5b7897eddabd736405cbf84f0a669d02a46b Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 9 May 2024 22:20:53 -0700
Subject: [PATCH 592/743] Bump cloudinary from 1.39.1 to 1.40.0 (#2308)

Bumps [cloudinary](https://github.com/cloudinary/pycloudinary) from 1.39.1 to 1.40.0.
- [Release notes](https://github.com/cloudinary/pycloudinary/releases)
- [Changelog](https://github.com/cloudinary/pycloudinary/blob/master/CHANGELOG.md)
- [Commits](https://github.com/cloudinary/pycloudinary/compare/1.39.1...1.40.0)

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

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements.txt b/requirements.txt
index 2d8c8448..7b261f3d 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -6,7 +6,7 @@ bleach==6.1.0
 certifi==2024.2.2
 cheroot==10.0.0
 cherrypy==18.9.0
-cloudinary==1.39.1
+cloudinary==1.40.0
 distro==1.9.0
 dnspython==2.6.1
 facebook-sdk==3.1.0

From 6414a0ba12bb57da04bec2dbd6680930cfb4a340 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 9 May 2024 22:27:04 -0700
Subject: [PATCH 593/743] Bump cheroot from 10.0.0 to 10.0.1 (#2310)

* Bump cheroot from 10.0.0 to 10.0.1

Bumps [cheroot](https://github.com/cherrypy/cheroot) from 10.0.0 to 10.0.1.
- [Release notes](https://github.com/cherrypy/cheroot/releases)
- [Changelog](https://github.com/cherrypy/cheroot/blob/main/CHANGES.rst)
- [Commits](https://github.com/cherrypy/cheroot/compare/v10.0.0...v10.0.1)

---
updated-dependencies:
- dependency-name: cheroot
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

* Update cheroot==10.0.1

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/cheroot/connections.py        |  17 +-
 lib/cheroot/server.py             |  35 ++--
 lib/cheroot/ssl/builtin.py        |  76 +++-----
 lib/cheroot/ssl/pyopenssl.py      |   6 +-
 lib/cheroot/test/conftest.py      |  27 ++-
 lib/cheroot/test/test_conn.py     | 303 ++++++++++++++++++++++++++++--
 lib/cheroot/test/test_core.py     |   2 +-
 lib/cheroot/testing.py            |  49 +++--
 lib/cheroot/workers/threadpool.py | 145 +++++++++++---
 requirements.txt                  |   2 +-
 10 files changed, 534 insertions(+), 128 deletions(-)

diff --git a/lib/cheroot/connections.py b/lib/cheroot/connections.py
index 9346bc6a..df70e6ea 100644
--- a/lib/cheroot/connections.py
+++ b/lib/cheroot/connections.py
@@ -292,7 +292,20 @@ class ConnectionManager:
             if self.server.ssl_adapter is not None:
                 try:
                     s, ssl_env = self.server.ssl_adapter.wrap(s)
-                except errors.NoSSLError:
+                except errors.FatalSSLAlert as tls_connection_drop_error:
+                    self.server.error_log(
+                        f'Client {addr !s} lost — peer dropped the TLS '
+                        'connection suddenly, during handshake: '
+                        f'{tls_connection_drop_error !s}',
+                    )
+                    return
+                except errors.NoSSLError as http_over_https_err:
+                    self.server.error_log(
+                        f'Client {addr !s} attempted to speak plain HTTP into '
+                        'a TCP connection configured for TLS-only traffic — '
+                        'trying to send back a plain HTTP error response: '
+                        f'{http_over_https_err !s}',
+                    )
                     msg = (
                         'The client sent a plain HTTP request, but '
                         'this server only speaks HTTPS on this port.'
@@ -311,8 +324,6 @@ class ConnectionManager:
                         if ex.args[0] not in errors.socket_errors_to_ignore:
                             raise
                     return
-                if not s:
-                    return
                 mf = self.server.ssl_adapter.makefile
                 # Re-apply our timeout since we may have a new socket object
                 if hasattr(s, 'settimeout'):
diff --git a/lib/cheroot/server.py b/lib/cheroot/server.py
index bceeb2c9..91564611 100644
--- a/lib/cheroot/server.py
+++ b/lib/cheroot/server.py
@@ -157,7 +157,7 @@ QUOTED_SLASH = b'%2F'
 QUOTED_SLASH_REGEX = re.compile(b''.join((b'(?i)', QUOTED_SLASH)))
 
 
-_STOPPING_FOR_INTERRUPT = object()  # sentinel used during shutdown
+_STOPPING_FOR_INTERRUPT = Exception()  # sentinel used during shutdown
 
 
 comma_separated_headers = [
@@ -209,7 +209,11 @@ class HeaderReader:
             if not line.endswith(CRLF):
                 raise ValueError('HTTP requires CRLF terminators')
 
-            if line[0] in (SPACE, TAB):
+            if line[:1] in (SPACE, TAB):
+                # NOTE: `type(line[0]) is int` and `type(line[:1]) is bytes`.
+                # NOTE: The former causes a the following warning:
+                # NOTE: `BytesWarning('Comparison between bytes and int')`
+                # NOTE: The latter is equivalent and does not.
                 # It's a continuation line.
                 v = line.strip()
             else:
@@ -1725,16 +1729,16 @@ class HTTPServer:
         """Run the server forever, and stop it cleanly on exit."""
         try:
             self.start()
-        except (KeyboardInterrupt, IOError):
-            # The time.sleep call might raise
-            # "IOError: [Errno 4] Interrupted function call" on KBInt.
-            self.error_log('Keyboard Interrupt: shutting down')
-            self.stop()
-            raise
-        except SystemExit:
-            self.error_log('SystemExit raised: shutting down')
-            self.stop()
-            raise
+        except KeyboardInterrupt as kb_intr_exc:
+            underlying_interrupt = self.interrupt
+            if not underlying_interrupt:
+                self.interrupt = kb_intr_exc
+            raise kb_intr_exc from underlying_interrupt
+        except SystemExit as sys_exit_exc:
+            underlying_interrupt = self.interrupt
+            if not underlying_interrupt:
+                self.interrupt = sys_exit_exc
+            raise sys_exit_exc from underlying_interrupt
 
     def prepare(self):  # noqa: C901  # FIXME
         """Prepare server to serving requests.
@@ -2111,6 +2115,13 @@ class HTTPServer:
         has completed.
         """
         self._interrupt = _STOPPING_FOR_INTERRUPT
+
+        if isinstance(interrupt, KeyboardInterrupt):
+            self.error_log('Keyboard Interrupt: shutting down')
+
+        if isinstance(interrupt, SystemExit):
+            self.error_log('SystemExit raised: shutting down')
+
         self.stop()
         self._interrupt = interrupt
 
diff --git a/lib/cheroot/ssl/builtin.py b/lib/cheroot/ssl/builtin.py
index b22d4ae6..e28e5df1 100644
--- a/lib/cheroot/ssl/builtin.py
+++ b/lib/cheroot/ssl/builtin.py
@@ -27,12 +27,9 @@ except ImportError:
 
 from . import Adapter
 from .. import errors
-from .._compat import IS_ABOVE_OPENSSL10
 from ..makefile import StreamReader, StreamWriter
 from ..server import HTTPServer
 
-generic_socket_error = OSError
-
 
 def _assert_ssl_exc_contains(exc, *msgs):
     """Check whether SSL exception contains either of messages provided."""
@@ -265,62 +262,35 @@ class BuiltinSSLAdapter(Adapter):
 
     def wrap(self, sock):
         """Wrap and return the given socket, plus WSGI environ entries."""
-        EMPTY_RESULT = None, {}
         try:
             s = self.context.wrap_socket(
                 sock, do_handshake_on_connect=True, server_side=True,
             )
-        except ssl.SSLError as ex:
-            if ex.errno == ssl.SSL_ERROR_EOF:
-                # This is almost certainly due to the cherrypy engine
-                # 'pinging' the socket to assert it's connectable;
-                # the 'ping' isn't SSL.
-                return EMPTY_RESULT
-            elif ex.errno == ssl.SSL_ERROR_SSL:
-                if _assert_ssl_exc_contains(ex, 'http request'):
-                    # The client is speaking HTTP to an HTTPS server.
-                    raise errors.NoSSLError
+        except (
+            ssl.SSLEOFError,
+            ssl.SSLZeroReturnError,
+        ) as tls_connection_drop_error:
+            raise errors.FatalSSLAlert(
+                *tls_connection_drop_error.args,
+            ) from tls_connection_drop_error
+        except ssl.SSLError as generic_tls_error:
+            peer_speaks_plain_http_over_https = (
+                generic_tls_error.errno == ssl.SSL_ERROR_SSL and
+                _assert_ssl_exc_contains(generic_tls_error, 'http request')
+            )
+            if peer_speaks_plain_http_over_https:
+                reraised_connection_drop_exc_cls = errors.NoSSLError
+            else:
+                reraised_connection_drop_exc_cls = errors.FatalSSLAlert
 
-                # Check if it's one of the known errors
-                # Errors that are caught by PyOpenSSL, but thrown by
-                # built-in ssl
-                _block_errors = (
-                    'unknown protocol', 'unknown ca', 'unknown_ca',
-                    'unknown error',
-                    'https proxy request', 'inappropriate fallback',
-                    'wrong version number',
-                    'no shared cipher', 'certificate unknown',
-                    'ccs received early',
-                    'certificate verify failed',  # client cert w/o trusted CA
-                    'version too low',  # caused by SSL3 connections
-                    'unsupported protocol',  # caused by TLS1 connections
-                )
-                if _assert_ssl_exc_contains(ex, *_block_errors):
-                    # Accepted error, let's pass
-                    return EMPTY_RESULT
-            elif _assert_ssl_exc_contains(ex, 'handshake operation timed out'):
-                # This error is thrown by builtin SSL after a timeout
-                # when client is speaking HTTP to an HTTPS server.
-                # The connection can safely be dropped.
-                return EMPTY_RESULT
-            raise
-        except generic_socket_error as exc:
-            """It is unclear why exactly this happens.
+            raise reraised_connection_drop_exc_cls(
+                *generic_tls_error.args,
+            ) from generic_tls_error
+        except OSError as tcp_connection_drop_error:
+            raise errors.FatalSSLAlert(
+                *tcp_connection_drop_error.args,
+            ) from tcp_connection_drop_error
 
-            It's reproducible only with openssl>1.0 and stdlib
-            :py:mod:`ssl` wrapper.
-            In CherryPy it's triggered by Checker plugin, which connects
-            to the app listening to the socket port in TLS mode via plain
-            HTTP during startup (from the same process).
-
-
-            Ref: https://github.com/cherrypy/cherrypy/issues/1618
-            """
-            is_error0 = exc.args == (0, 'Error')
-
-            if is_error0 and IS_ABOVE_OPENSSL10:
-                return EMPTY_RESULT
-            raise
         return s, self.get_environ(s)
 
     def get_environ(self, sock):
diff --git a/lib/cheroot/ssl/pyopenssl.py b/lib/cheroot/ssl/pyopenssl.py
index 548200f7..8b01b348 100644
--- a/lib/cheroot/ssl/pyopenssl.py
+++ b/lib/cheroot/ssl/pyopenssl.py
@@ -150,7 +150,7 @@ class SSLFileobjectMixin:
         return self._safe_call(
             False,
             super(SSLFileobjectMixin, self).sendall,
-            *args, **kwargs
+            *args, **kwargs,
         )
 
     def send(self, *args, **kwargs):
@@ -158,7 +158,7 @@ class SSLFileobjectMixin:
         return self._safe_call(
             False,
             super(SSLFileobjectMixin, self).send,
-            *args, **kwargs
+            *args, **kwargs,
         )
 
 
@@ -196,6 +196,7 @@ class SSLConnectionProxyMeta:
 
         def lock_decorator(method):
             """Create a proxy method for a new class."""
+
             def proxy_wrapper(self, *args):
                 self._lock.acquire()
                 try:
@@ -212,6 +213,7 @@ class SSLConnectionProxyMeta:
 
         def make_property(property_):
             """Create a proxy method for a new class."""
+
             def proxy_prop_wrapper(self):
                 return getattr(self._ssl_conn, property_)
             proxy_prop_wrapper.__name__ = property_
diff --git a/lib/cheroot/test/conftest.py b/lib/cheroot/test/conftest.py
index 205753b1..2beff2bf 100644
--- a/lib/cheroot/test/conftest.py
+++ b/lib/cheroot/test/conftest.py
@@ -12,7 +12,10 @@ import pytest
 from .._compat import IS_MACOS, IS_WINDOWS  # noqa: WPS436
 from ..server import Gateway, HTTPServer
 from ..testing import (  # noqa: F401  # pylint: disable=unused-import
-    native_server, wsgi_server,
+    native_server,
+    thread_and_wsgi_server,
+    thread_and_native_server,
+    wsgi_server,
 )
 from ..testing import get_server_client
 
@@ -31,6 +34,28 @@ def http_request_timeout():
     return computed_timeout
 
 
+@pytest.fixture
+# pylint: disable=redefined-outer-name
+def wsgi_server_thread(thread_and_wsgi_server):  # noqa: F811
+    """Set up and tear down a Cheroot WSGI server instance.
+
+    This exposes the server thread.
+    """
+    server_thread, _srv = thread_and_wsgi_server
+    return server_thread
+
+
+@pytest.fixture
+# pylint: disable=redefined-outer-name
+def native_server_thread(thread_and_native_server):  # noqa: F811
+    """Set up and tear down a Cheroot HTTP server instance.
+
+    This exposes the server thread.
+    """
+    server_thread, _srv = thread_and_native_server
+    return server_thread
+
+
 @pytest.fixture
 # pylint: disable=redefined-outer-name
 def wsgi_server_client(wsgi_server):  # noqa: F811
diff --git a/lib/cheroot/test/test_conn.py b/lib/cheroot/test/test_conn.py
index f2d2cdb2..21dff855 100644
--- a/lib/cheroot/test/test_conn.py
+++ b/lib/cheroot/test/test_conn.py
@@ -1,7 +1,9 @@
 """Tests for TCP connection handling, including proper and timely close."""
 
 import errno
+from re import match as _matches_pattern
 import socket
+import sys
 import time
 import logging
 import traceback as traceback_
@@ -17,6 +19,7 @@ from cheroot._compat import IS_CI, IS_MACOS, IS_PYPY, IS_WINDOWS
 import cheroot.server
 
 
+IS_PY36 = sys.version_info[:2] == (3, 6)
 IS_SLOW_ENV = IS_MACOS or IS_WINDOWS
 
 
@@ -53,7 +56,8 @@ class Controller(helper.Controller):
                 "'POST' != request.method %r" %
                 req.environ['REQUEST_METHOD'],
             )
-        return "thanks for '%s'" % req.environ['wsgi.input'].read()
+        input_contents = req.environ['wsgi.input'].read().decode('utf-8')
+        return f"thanks for '{input_contents !s}'"
 
     def custom_204(req, resp):
         """Render response with status 204."""
@@ -605,18 +609,18 @@ def test_keepalive_conn_management(test_client):
         pytest.param(RuntimeError, 666, True, id='RuntimeError(666)'),
         pytest.param(socket.error, -1, True, id='socket.error(-1)'),
     ) + (
-            pytest.param(
-                ConnectionResetError, errno.ECONNRESET, False,
-                id='ConnectionResetError(ECONNRESET)',
-            ),
-            pytest.param(
-                BrokenPipeError, errno.EPIPE, False,
-                id='BrokenPipeError(EPIPE)',
-            ),
-            pytest.param(
-                BrokenPipeError, errno.ESHUTDOWN, False,
-                id='BrokenPipeError(ESHUTDOWN)',
-            ),
+        pytest.param(
+            ConnectionResetError, errno.ECONNRESET, False,
+            id='ConnectionResetError(ECONNRESET)',
+        ),
+        pytest.param(
+            BrokenPipeError, errno.EPIPE, False,
+            id='BrokenPipeError(EPIPE)',
+        ),
+        pytest.param(
+            BrokenPipeError, errno.ESHUTDOWN, False,
+            id='BrokenPipeError(ESHUTDOWN)',
+        ),
     ),
 )
 def test_broken_connection_during_tcp_fin(
@@ -699,6 +703,275 @@ def test_broken_connection_during_tcp_fin(
     assert _close_kernel_socket.exception_leaked is exception_leaks
 
 
+def test_broken_connection_during_http_communication_fallback(  # noqa: WPS118
+        monkeypatch,
+        test_client,
+        testing_server,
+        wsgi_server_thread,
+):
+    """Test that unhandled internal error cascades into shutdown."""
+    def _raise_connection_reset(*_args, **_kwargs):
+        raise ConnectionResetError(666)
+
+    def _read_request_line(self):
+        monkeypatch.setattr(self.conn.rfile, 'close', _raise_connection_reset)
+        monkeypatch.setattr(self.conn.wfile, 'write', _raise_connection_reset)
+        _raise_connection_reset()
+
+    monkeypatch.setattr(
+        test_client.server_instance.ConnectionClass.RequestHandlerClass,
+        'read_request_line',
+        _read_request_line,
+    )
+
+    test_client.get_connection().send(b'GET / HTTP/1.1')
+    wsgi_server_thread.join()  # no extra logs upon server termination
+
+    actual_log_entries = testing_server.error_log.calls[:]
+    testing_server.error_log.calls.clear()  # prevent post-test assertions
+
+    expected_log_entries = (
+        (logging.WARNING, r'^socket\.error 666$'),
+        (
+            logging.INFO,
+            '^Got a connection error while handling a connection '
+            r'from .*:\d{1,5} \(666\)',
+        ),
+        (
+            logging.CRITICAL,
+            r'A fatal exception happened\. Setting the server interrupt flag '
+            r'to ConnectionResetError\(666,?\) and giving up\.\n\nPlease, '
+            'report this on the Cheroot tracker at '
+            r'<https://github\.com/cherrypy/cheroot/issues/new/choose>, '
+            'providing a full reproducer with as much context and details '
+            r'as possible\.$',
+        ),
+    )
+
+    assert len(actual_log_entries) == len(expected_log_entries)
+
+    for (  # noqa: WPS352
+            (expected_log_level, expected_msg_regex),
+            (actual_msg, actual_log_level, _tb),
+    ) in zip(expected_log_entries, actual_log_entries):
+        assert expected_log_level == actual_log_level
+        assert _matches_pattern(expected_msg_regex, actual_msg) is not None, (
+            f'{actual_msg !r} does not match {expected_msg_regex !r}'
+        )
+
+
+def test_kb_int_from_http_handler(
+        test_client,
+        testing_server,
+        wsgi_server_thread,
+):
+    """Test that a keyboard interrupt from HTTP handler causes shutdown."""
+    def _trigger_kb_intr(_req, _resp):
+        raise KeyboardInterrupt('simulated test handler keyboard interrupt')
+    testing_server.wsgi_app.handlers['/kb_intr'] = _trigger_kb_intr
+
+    http_conn = test_client.get_connection()
+    http_conn.putrequest('GET', '/kb_intr', skip_host=True)
+    http_conn.putheader('Host', http_conn.host)
+    http_conn.endheaders()
+    wsgi_server_thread.join()  # no extra logs upon server termination
+
+    actual_log_entries = testing_server.error_log.calls[:]
+    testing_server.error_log.calls.clear()  # prevent post-test assertions
+
+    expected_log_entries = (
+        (
+            logging.DEBUG,
+            '^Got a server shutdown request while handling a connection '
+            r'from .*:\d{1,5} \(simulated test handler keyboard interrupt\)$',
+        ),
+        (
+            logging.DEBUG,
+            '^Setting the server interrupt flag to KeyboardInterrupt'
+            r"\('simulated test handler keyboard interrupt',?\)$",
+        ),
+        (
+            logging.INFO,
+            '^Keyboard Interrupt: shutting down$',
+        ),
+    )
+
+    assert len(actual_log_entries) == len(expected_log_entries)
+
+    for (  # noqa: WPS352
+            (expected_log_level, expected_msg_regex),
+            (actual_msg, actual_log_level, _tb),
+    ) in zip(expected_log_entries, actual_log_entries):
+        assert expected_log_level == actual_log_level
+        assert _matches_pattern(expected_msg_regex, actual_msg) is not None, (
+            f'{actual_msg !r} does not match {expected_msg_regex !r}'
+        )
+
+
+@pytest.mark.xfail(
+    IS_CI and IS_PYPY and IS_PY36 and not IS_SLOW_ENV,
+    reason='Fails under PyPy 3.6 under Ubuntu 20.04 in CI for unknown reason',
+    # NOTE: Actually covers any Linux
+    strict=False,
+)
+def test_unhandled_exception_in_request_handler(
+        mocker,
+        monkeypatch,
+        test_client,
+        testing_server,
+        wsgi_server_thread,
+):
+    """Ensure worker threads are resilient to in-handler exceptions."""
+
+    class SillyMistake(BaseException):  # noqa: WPS418, WPS431
+        """A simulated crash within an HTTP handler."""
+
+    def _trigger_scary_exc(_req, _resp):
+        raise SillyMistake('simulated unhandled exception 💣 in test handler')
+
+    testing_server.wsgi_app.handlers['/scary_exc'] = _trigger_scary_exc
+
+    server_connection_close_spy = mocker.spy(
+        test_client.server_instance.ConnectionClass,
+        'close',
+    )
+
+    http_conn = test_client.get_connection()
+    http_conn.putrequest('GET', '/scary_exc', skip_host=True)
+    http_conn.putheader('Host', http_conn.host)
+    http_conn.endheaders()
+
+    # NOTE: This spy ensure the log entry gets recorded before we're testing
+    # NOTE: them and before server shutdown, preserving their order and making
+    # NOTE: the log entry presence non-flaky.
+    while not server_connection_close_spy.called:  # noqa: WPS328
+        pass
+
+    assert len(testing_server.requests._threads) == 10
+    while testing_server.requests.idle < 10:  # noqa: WPS328
+        pass
+    assert len(testing_server.requests._threads) == 10
+    testing_server.interrupt = SystemExit('test requesting shutdown')
+    assert not testing_server.requests._threads
+    wsgi_server_thread.join()  # no extra logs upon server termination
+
+    actual_log_entries = testing_server.error_log.calls[:]
+    testing_server.error_log.calls.clear()  # prevent post-test assertions
+
+    expected_log_entries = (
+        (
+            logging.ERROR,
+            '^Unhandled error while processing an incoming connection '
+            'SillyMistake'
+            r"\('simulated unhandled exception 💣 in test handler',?\)$",
+        ),
+        (
+            logging.INFO,
+            '^SystemExit raised: shutting down$',
+        ),
+    )
+
+    assert len(actual_log_entries) == len(expected_log_entries)
+
+    for (  # noqa: WPS352
+            (expected_log_level, expected_msg_regex),
+            (actual_msg, actual_log_level, _tb),
+    ) in zip(expected_log_entries, actual_log_entries):
+        assert expected_log_level == actual_log_level
+        assert _matches_pattern(expected_msg_regex, actual_msg) is not None, (
+            f'{actual_msg !r} does not match {expected_msg_regex !r}'
+        )
+
+
+@pytest.mark.xfail(
+    IS_CI and IS_PYPY and IS_PY36 and not IS_SLOW_ENV,
+    reason='Fails under PyPy 3.6 under Ubuntu 20.04 in CI for unknown reason',
+    # NOTE: Actually covers any Linux
+    strict=False,
+)
+def test_remains_alive_post_unhandled_exception(
+        mocker,
+        monkeypatch,
+        test_client,
+        testing_server,
+        wsgi_server_thread,
+):
+    """Ensure worker threads are resilient to unhandled exceptions."""
+
+    class ScaryCrash(BaseException):  # noqa: WPS418, WPS431
+        """A simulated crash during HTTP parsing."""
+
+    _orig_read_request_line = (
+        test_client.server_instance.
+        ConnectionClass.RequestHandlerClass.
+        read_request_line
+    )
+
+    def _read_request_line(self):
+        _orig_read_request_line(self)
+        raise ScaryCrash(666)
+
+    monkeypatch.setattr(
+        test_client.server_instance.ConnectionClass.RequestHandlerClass,
+        'read_request_line',
+        _read_request_line,
+    )
+
+    server_connection_close_spy = mocker.spy(
+        test_client.server_instance.ConnectionClass,
+        'close',
+    )
+
+    # NOTE: The initial worker thread count is 10.
+    assert len(testing_server.requests._threads) == 10
+
+    test_client.get_connection().send(b'GET / HTTP/1.1')
+
+    # NOTE: This spy ensure the log entry gets recorded before we're testing
+    # NOTE: them and before server shutdown, preserving their order and making
+    # NOTE: the log entry presence non-flaky.
+    while not server_connection_close_spy.called:  # noqa: WPS328
+        pass
+
+    # NOTE: This checks for whether there's any crashed threads
+    while testing_server.requests.idle < 10:  # noqa: WPS328
+        pass
+    assert len(testing_server.requests._threads) == 10
+    assert all(
+        worker_thread.is_alive()
+        for worker_thread in testing_server.requests._threads
+    )
+    testing_server.interrupt = SystemExit('test requesting shutdown')
+    assert not testing_server.requests._threads
+    wsgi_server_thread.join()  # no extra logs upon server termination
+
+    actual_log_entries = testing_server.error_log.calls[:]
+    testing_server.error_log.calls.clear()  # prevent post-test assertions
+
+    expected_log_entries = (
+        (
+            logging.ERROR,
+            '^Unhandled error while processing an incoming connection '
+            r'ScaryCrash\(666,?\)$',
+        ),
+        (
+            logging.INFO,
+            '^SystemExit raised: shutting down$',
+        ),
+    )
+
+    assert len(actual_log_entries) == len(expected_log_entries)
+
+    for (  # noqa: WPS352
+            (expected_log_level, expected_msg_regex),
+            (actual_msg, actual_log_level, _tb),
+    ) in zip(expected_log_entries, actual_log_entries):
+        assert expected_log_level == actual_log_level
+        assert _matches_pattern(expected_msg_regex, actual_msg) is not None, (
+            f'{actual_msg !r} does not match {expected_msg_regex !r}'
+        )
+
+
 @pytest.mark.parametrize(
     'timeout_before_headers',
     (
@@ -917,7 +1190,7 @@ def test_100_Continue(test_client):
     status_line, _actual_headers, actual_resp_body = webtest.shb(response)
     actual_status = int(status_line[:3])
     assert actual_status == 200
-    expected_resp_body = ("thanks for '%s'" % body).encode()
+    expected_resp_body = f"thanks for '{body.decode() !s}'".encode()
     assert actual_resp_body == expected_resp_body
     conn.close()
 
@@ -987,7 +1260,7 @@ def test_readall_or_close(test_client, max_request_body_size):
     status_line, actual_headers, actual_resp_body = webtest.shb(response)
     actual_status = int(status_line[:3])
     assert actual_status == 200
-    expected_resp_body = ("thanks for '%s'" % body).encode()
+    expected_resp_body = f"thanks for '{body.decode() !s}'".encode()
     assert actual_resp_body == expected_resp_body
     conn.close()
 
diff --git a/lib/cheroot/test/test_core.py b/lib/cheroot/test/test_core.py
index 7732b6f7..d3364788 100644
--- a/lib/cheroot/test/test_core.py
+++ b/lib/cheroot/test/test_core.py
@@ -134,7 +134,7 @@ def test_query_string_request(test_client):
         '/hello',  # plain
         '/query_string?test=True',  # query
         '/{0}?{1}={2}'.format(  # quoted unicode
-            *map(urllib.parse.quote, ('Юххууу', 'ї', 'йо'))
+            *map(urllib.parse.quote, ('Юххууу', 'ї', 'йо')),
         ),
     ),
 )
diff --git a/lib/cheroot/testing.py b/lib/cheroot/testing.py
index 3e404e59..5457a4b1 100644
--- a/lib/cheroot/testing.py
+++ b/lib/cheroot/testing.py
@@ -31,7 +31,7 @@ config = {
 
 
 @contextmanager
-def cheroot_server(server_factory):
+def cheroot_server(server_factory):  # noqa: WPS210
     """Set up and tear down a Cheroot server instance."""
     conf = config[server_factory].copy()
     bind_port = conf.pop('bind_addr')[-1]
@@ -41,7 +41,7 @@ def cheroot_server(server_factory):
             actual_bind_addr = (interface, bind_port)
             httpserver = server_factory(  # create it
                 bind_addr=actual_bind_addr,
-                **conf
+                **conf,
             )
         except OSError:
             pass
@@ -50,27 +50,52 @@ def cheroot_server(server_factory):
 
     httpserver.shutdown_timeout = 0  # Speed-up tests teardown
 
-    threading.Thread(target=httpserver.safe_start).start()  # spawn it
+    # FIXME: Expose this thread through a fixture so that it
+    # FIXME: could be awaited in tests.
+    server_thread = threading.Thread(target=httpserver.safe_start)
+    server_thread.start()  # spawn it
     while not httpserver.ready:  # wait until fully initialized and bound
         time.sleep(0.1)
 
-    yield httpserver
-
-    httpserver.stop()  # destroy it
+    try:
+        yield server_thread, httpserver
+    finally:
+        httpserver.stop()  # destroy it
+        server_thread.join()  # wait for the thread to be turn down
 
 
 @pytest.fixture
-def wsgi_server():
+def thread_and_wsgi_server():
+    """Set up and tear down a Cheroot WSGI server instance.
+
+    This emits a tuple of a thread and a server instance.
+    """
+    with cheroot_server(cheroot.wsgi.Server) as (server_thread, srv):
+        yield server_thread, srv
+
+
+@pytest.fixture
+def thread_and_native_server():
+    """Set up and tear down a Cheroot HTTP server instance.
+
+    This emits a tuple of a thread and a server instance.
+    """
+    with cheroot_server(cheroot.server.HTTPServer) as (server_thread, srv):
+        yield server_thread, srv
+
+
+@pytest.fixture
+def wsgi_server(thread_and_wsgi_server):  # noqa: WPS442
     """Set up and tear down a Cheroot WSGI server instance."""
-    with cheroot_server(cheroot.wsgi.Server) as srv:
-        yield srv
+    _server_thread, srv = thread_and_wsgi_server
+    return srv
 
 
 @pytest.fixture
-def native_server():
+def native_server(thread_and_native_server):  # noqa: WPS442
     """Set up and tear down a Cheroot HTTP server instance."""
-    with cheroot_server(cheroot.server.HTTPServer) as srv:
-        yield srv
+    _server_thread, srv = thread_and_native_server
+    return srv
 
 
 class _TestClient:
diff --git a/lib/cheroot/workers/threadpool.py b/lib/cheroot/workers/threadpool.py
index 3437d9bd..cd28450a 100644
--- a/lib/cheroot/workers/threadpool.py
+++ b/lib/cheroot/workers/threadpool.py
@@ -6,6 +6,7 @@
 """
 
 import collections
+import logging
 import threading
 import time
 import socket
@@ -30,7 +31,7 @@ class TrueyZero:
 
 trueyzero = TrueyZero()
 
-_SHUTDOWNREQUEST = None
+_SHUTDOWNREQUEST = object()
 
 
 class WorkerThread(threading.Thread):
@@ -99,39 +100,127 @@ class WorkerThread(threading.Thread):
         threading.Thread.__init__(self)
 
     def run(self):
-        """Process incoming HTTP connections.
+        """Set up incoming HTTP connection processing loop.
 
-        Retrieves incoming connections from thread pool.
+        This is the thread's entry-point. It performs lop-layer
+        exception handling and interrupt processing.
+        :exc:`KeyboardInterrupt` and :exc:`SystemExit` bubbling up
+        from the inner-layer code constitute a global server interrupt
+        request. When they happen, the worker thread exits.
+
+        :raises BaseException: when an unexpected non-interrupt
+                               exception leaks from the inner layers
+
+        # noqa: DAR401 KeyboardInterrupt SystemExit
         """
         self.server.stats['Worker Threads'][self.name] = self.stats
+        self.ready = True
         try:
-            self.ready = True
-            while True:
-                conn = self.server.requests.get()
-                if conn is _SHUTDOWNREQUEST:
-                    return
+            self._process_connections_until_interrupted()
+        except (KeyboardInterrupt, SystemExit) as interrupt_exc:
+            interrupt_cause = interrupt_exc.__cause__ or interrupt_exc
+            self.server.error_log(
+                f'Setting the server interrupt flag to {interrupt_cause !r}',
+                level=logging.DEBUG,
+            )
+            self.server.interrupt = interrupt_cause
+        except BaseException as underlying_exc:  # noqa: WPS424
+            # NOTE: This is the last resort logging with the last dying breath
+            # NOTE: of the worker. It is only reachable when exceptions happen
+            # NOTE: in the `finally` branch of the internal try/except block.
+            self.server.error_log(
+                'A fatal exception happened. Setting the server interrupt flag'
+                f' to {underlying_exc !r} and giving up.'
+                '\N{NEW LINE}\N{NEW LINE}'
+                'Please, report this on the Cheroot tracker at '
+                '<https://github.com/cherrypy/cheroot/issues/new/choose>, '
+                'providing a full reproducer with as much context and details as possible.',
+                level=logging.CRITICAL,
+                traceback=True,
+            )
+            self.server.interrupt = underlying_exc
+            raise
+        finally:
+            self.ready = False
 
-                self.conn = conn
-                is_stats_enabled = self.server.stats['Enabled']
+    def _process_connections_until_interrupted(self):
+        """Process incoming HTTP connections in an infinite loop.
+
+        Retrieves incoming connections from thread pool, processing
+        them one by one.
+
+        :raises SystemExit: on the internal requests to stop the
+                            server instance
+        """
+        while True:
+            conn = self.server.requests.get()
+            if conn is _SHUTDOWNREQUEST:
+                return
+
+            self.conn = conn
+            is_stats_enabled = self.server.stats['Enabled']
+            if is_stats_enabled:
+                self.start_time = time.time()
+            keep_conn_open = False
+            try:
+                keep_conn_open = conn.communicate()
+            except ConnectionError as connection_error:
+                keep_conn_open = False  # Drop the connection cleanly
+                self.server.error_log(
+                    'Got a connection error while handling a '
+                    f'connection from {conn.remote_addr !s}:'
+                    f'{conn.remote_port !s} ({connection_error !s})',
+                    level=logging.INFO,
+                )
+                continue
+            except (KeyboardInterrupt, SystemExit) as shutdown_request:
+                # Shutdown request
+                keep_conn_open = False  # Drop the connection cleanly
+                self.server.error_log(
+                    'Got a server shutdown request while handling a '
+                    f'connection from {conn.remote_addr !s}:'
+                    f'{conn.remote_port !s} ({shutdown_request !s})',
+                    level=logging.DEBUG,
+                )
+                raise SystemExit(
+                    str(shutdown_request),
+                ) from shutdown_request
+            except BaseException as unhandled_error:  # noqa: WPS424
+                # NOTE: Only a shutdown request should bubble up to the
+                # NOTE: external cleanup code. Otherwise, this thread dies.
+                # NOTE: If this were to happen, the threadpool would still
+                # NOTE: list a dead thread without knowing its state. And
+                # NOTE: the calling code would fail to schedule processing
+                # NOTE: of new requests.
+                self.server.error_log(
+                    'Unhandled error while processing an incoming '
+                    f'connection {unhandled_error !r}',
+                    level=logging.ERROR,
+                    traceback=True,
+                )
+                continue  # Prevent the thread from dying
+            finally:
+                # NOTE: Any exceptions coming from within `finally` may
+                # NOTE: kill the thread, causing the threadpool to only
+                # NOTE: contain references to dead threads rendering the
+                # NOTE: server defunct, effectively meaning a DoS.
+                # NOTE: Ideally, things called here should process
+                # NOTE: everything recoverable internally. Any unhandled
+                # NOTE: errors will bubble up into the outer try/except
+                # NOTE: block. They will be treated as fatal and turned
+                # NOTE: into server shutdown requests and then reraised
+                # NOTE: unconditionally.
+                if keep_conn_open:
+                    self.server.put_conn(conn)
+                else:
+                    conn.close()
                 if is_stats_enabled:
-                    self.start_time = time.time()
-                keep_conn_open = False
-                try:
-                    keep_conn_open = conn.communicate()
-                finally:
-                    if keep_conn_open:
-                        self.server.put_conn(conn)
-                    else:
-                        conn.close()
-                    if is_stats_enabled:
-                        self.requests_seen += self.conn.requests_seen
-                        self.bytes_read += self.conn.rfile.bytes_read
-                        self.bytes_written += self.conn.wfile.bytes_written
-                        self.work_time += time.time() - self.start_time
-                        self.start_time = None
-                    self.conn = None
-        except (KeyboardInterrupt, SystemExit) as ex:
-            self.server.interrupt = ex
+                    self.requests_seen += conn.requests_seen
+                    self.bytes_read += conn.rfile.bytes_read
+                    self.bytes_written += conn.wfile.bytes_written
+                    self.work_time += time.time() - self.start_time
+                    self.start_time = None
+                self.conn = None
 
 
 class ThreadPool:
diff --git a/requirements.txt b/requirements.txt
index 7b261f3d..ea940f73 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -4,7 +4,7 @@ backports.zoneinfo==0.2.1;python_version<"3.9"
 beautifulsoup4==4.12.3
 bleach==6.1.0
 certifi==2024.2.2
-cheroot==10.0.0
+cheroot==10.0.1
 cherrypy==18.9.0
 cloudinary==1.40.0
 distro==1.9.0

From 3e8a5663a3abcdc4bd6e8af7ff08beac6d18fbb3 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 9 May 2024 22:27:15 -0700
Subject: [PATCH 594/743] Bump plexapi from 4.15.11 to 4.15.12 (#2311)

* Bump plexapi from 4.15.11 to 4.15.12

Bumps [plexapi](https://github.com/pkkid/python-plexapi) from 4.15.11 to 4.15.12.
- [Release notes](https://github.com/pkkid/python-plexapi/releases)
- [Commits](https://github.com/pkkid/python-plexapi/compare/4.15.11...4.15.12)

---
updated-dependencies:
- dependency-name: plexapi
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

* Update plexapi==4.15.12

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/plexapi/base.py   | 26 ++++++++++++++++++--------
 lib/plexapi/const.py  |  2 +-
 lib/plexapi/server.py |  4 ++--
 requirements.txt      |  2 +-
 4 files changed, 22 insertions(+), 12 deletions(-)

diff --git a/lib/plexapi/base.py b/lib/plexapi/base.py
index 0852426d..c08334f9 100644
--- a/lib/plexapi/base.py
+++ b/lib/plexapi/base.py
@@ -170,7 +170,16 @@ class PlexObject:
         elem = ElementTree.fromstring(xml)
         return self._buildItemOrNone(elem, cls)
 
-    def fetchItems(self, ekey, cls=None, container_start=None, container_size=None, maxresults=None, **kwargs):
+    def fetchItems(
+        self,
+        ekey,
+        cls=None,
+        container_start=None,
+        container_size=None,
+        maxresults=None,
+        params=None,
+        **kwargs,
+    ):
         """ Load the specified key to find and build all items with the specified tag
             and attrs.
 
@@ -186,6 +195,7 @@ class PlexObject:
                 container_start (None, int): offset to get a subset of the data
                 container_size (None, int): How many items in data
                 maxresults (int, optional): Only return the specified number of results.
+                params (dict, optional): Any additional params to add to the request.
                 **kwargs (dict): Optionally add XML attribute to filter the items.
                     See the details below for more info.
 
@@ -268,7 +278,7 @@ class PlexObject:
             headers['X-Plex-Container-Start'] = str(container_start)
             headers['X-Plex-Container-Size'] = str(container_size)
 
-            data = self._server.query(ekey, headers=headers)
+            data = self._server.query(ekey, headers=headers, params=params)
             subresults = self.findItems(data, cls, ekey, **kwargs)
             total_size = utils.cast(int, data.attrib.get('totalSize') or data.attrib.get('size')) or len(subresults)
 
@@ -283,6 +293,11 @@ class PlexObject:
 
             results.extend(subresults)
 
+            container_start += container_size
+
+            if container_start > total_size:
+                break
+
             wanted_number_of_items = total_size - offset
             if maxresults is not None:
                 wanted_number_of_items = min(maxresults, wanted_number_of_items)
@@ -291,11 +306,6 @@ class PlexObject:
             if wanted_number_of_items <= len(results):
                 break
 
-            container_start += container_size
-
-            if container_start > total_size:
-                break
-
         return results
 
     def fetchItem(self, ekey, cls=None, **kwargs):
@@ -337,7 +347,7 @@ class PlexObject:
             kwargs['type'] = cls.TYPE
         # rtag to iter on a specific root tag using breadth-first search
         if rtag:
-            data = next(utils.iterXMLBFS(data, rtag), [])
+            data = next(utils.iterXMLBFS(data, rtag), Element('Empty'))
         # loop through all data elements to find matches
         items = MediaContainer[cls](self._server, data, initpath=initpath) if data.tag == 'MediaContainer' else []
         for elem in data:
diff --git a/lib/plexapi/const.py b/lib/plexapi/const.py
index e043d8c2..c987e305 100644
--- a/lib/plexapi/const.py
+++ b/lib/plexapi/const.py
@@ -4,6 +4,6 @@
 # Library version
 MAJOR_VERSION = 4
 MINOR_VERSION = 15
-PATCH_VERSION = 11
+PATCH_VERSION = 12
 __short_version__ = f"{MAJOR_VERSION}.{MINOR_VERSION}"
 __version__ = f"{__short_version__}.{PATCH_VERSION}"
diff --git a/lib/plexapi/server.py b/lib/plexapi/server.py
index bdd330f7..178ce82b 100644
--- a/lib/plexapi/server.py
+++ b/lib/plexapi/server.py
@@ -746,7 +746,7 @@ class PlexServer(PlexObject):
         """ Returns list of all :class:`~plexapi.media.TranscodeJob` objects running or paused on server. """
         return self.fetchItems('/status/sessions/background')
 
-    def query(self, key, method=None, headers=None, timeout=None, **kwargs):
+    def query(self, key, method=None, headers=None, params=None, timeout=None, **kwargs):
         """ Main method used to handle HTTPS requests to the Plex server. This method helps
             by encoding the response to utf-8 and parsing the returned XML into and
             ElementTree object. Returns None if no data exists in the response.
@@ -756,7 +756,7 @@ class PlexServer(PlexObject):
         timeout = timeout or self._timeout
         log.debug('%s %s', method.__name__.upper(), url)
         headers = self._headers(**headers or {})
-        response = method(url, headers=headers, timeout=timeout, **kwargs)
+        response = method(url, headers=headers, params=params, timeout=timeout, **kwargs)
         if response.status_code not in (200, 201, 204):
             codename = codes.get(response.status_code)[0]
             errtext = response.text.replace('\n', ' ')
diff --git a/requirements.txt b/requirements.txt
index ea940f73..cdf89bb5 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -26,7 +26,7 @@ musicbrainzngs==0.7.1
 packaging==24.0
 paho-mqtt==2.0.0
 platformdirs==4.2.0
-plexapi==4.15.11
+plexapi==4.15.12
 portend==3.2.0
 profilehooks==1.12.0
 PyJWT==2.8.0

From 5d0ba8b222bf1ce5ac48e759383f519c30863691 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 9 May 2024 22:27:59 -0700
Subject: [PATCH 595/743] Bump platformdirs from 4.2.0 to 4.2.1 (#2312)

* Bump platformdirs from 4.2.0 to 4.2.1

Bumps [platformdirs](https://github.com/platformdirs/platformdirs) from 4.2.0 to 4.2.1.
- [Release notes](https://github.com/platformdirs/platformdirs/releases)
- [Changelog](https://github.com/platformdirs/platformdirs/blob/main/CHANGES.rst)
- [Commits](https://github.com/platformdirs/platformdirs/compare/4.2.0...4.2.1)

---
updated-dependencies:
- dependency-name: platformdirs
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

* Update platformdirs==4.2.1

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/platformdirs/__init__.py | 84 ++++++++++++++++++------------------
 lib/platformdirs/__main__.py |  2 +-
 lib/platformdirs/android.py  | 27 ++++++------
 lib/platformdirs/api.py      | 33 +++++++++-----
 lib/platformdirs/macos.py    | 11 +++--
 lib/platformdirs/unix.py     | 37 +++++++++-------
 lib/platformdirs/version.py  |  4 +-
 lib/platformdirs/windows.py  | 35 ++++++++-------
 requirements.txt             |  2 +-
 9 files changed, 132 insertions(+), 103 deletions(-)

diff --git a/lib/platformdirs/__init__.py b/lib/platformdirs/__init__.py
index 75c8bff9..3f7d9490 100644
--- a/lib/platformdirs/__init__.py
+++ b/lib/platformdirs/__init__.py
@@ -1,6 +1,8 @@
 """
-Utilities for determining application-specific dirs. See <https://github.com/platformdirs/platformdirs> for details and
-usage.
+Utilities for determining application-specific dirs.
+
+See <https://github.com/platformdirs/platformdirs> for details and usage.
+
 """
 
 from __future__ import annotations
@@ -20,22 +22,22 @@ if TYPE_CHECKING:
 
 def _set_platform_dir_class() -> type[PlatformDirsABC]:
     if sys.platform == "win32":
-        from platformdirs.windows import Windows as Result
+        from platformdirs.windows import Windows as Result  # noqa: PLC0415
     elif sys.platform == "darwin":
-        from platformdirs.macos import MacOS as Result
+        from platformdirs.macos import MacOS as Result  # noqa: PLC0415
     else:
-        from platformdirs.unix import Unix as Result
+        from platformdirs.unix import Unix as Result  # noqa: PLC0415
 
     if os.getenv("ANDROID_DATA") == "/data" and os.getenv("ANDROID_ROOT") == "/system":
         if os.getenv("SHELL") or os.getenv("PREFIX"):
             return Result
 
-        from platformdirs.android import _android_folder
+        from platformdirs.android import _android_folder  # noqa: PLC0415
 
         if _android_folder() is not None:
-            from platformdirs.android import Android
+            from platformdirs.android import Android  # noqa: PLC0415
 
-            return Android  # return to avoid redefinition of result
+            return Android  # return to avoid redefinition of a result
 
     return Result
 
@@ -507,7 +509,7 @@ def user_log_path(
 
 
 def user_documents_path() -> Path:
-    """:returns: documents path tied to the user"""
+    """:returns: documents a path tied to the user"""
     return PlatformDirs().user_documents_path
 
 
@@ -585,41 +587,41 @@ def site_runtime_path(
 
 
 __all__ = [
+    "AppDirs",
+    "PlatformDirs",
+    "PlatformDirsABC",
     "__version__",
     "__version_info__",
-    "PlatformDirs",
-    "AppDirs",
-    "PlatformDirsABC",
-    "user_data_dir",
-    "user_config_dir",
-    "user_cache_dir",
-    "user_state_dir",
-    "user_log_dir",
-    "user_documents_dir",
-    "user_downloads_dir",
-    "user_pictures_dir",
-    "user_videos_dir",
-    "user_music_dir",
-    "user_desktop_dir",
-    "user_runtime_dir",
-    "site_data_dir",
-    "site_config_dir",
     "site_cache_dir",
-    "site_runtime_dir",
-    "user_data_path",
-    "user_config_path",
-    "user_cache_path",
-    "user_state_path",
-    "user_log_path",
-    "user_documents_path",
-    "user_downloads_path",
-    "user_pictures_path",
-    "user_videos_path",
-    "user_music_path",
-    "user_desktop_path",
-    "user_runtime_path",
-    "site_data_path",
-    "site_config_path",
     "site_cache_path",
+    "site_config_dir",
+    "site_config_path",
+    "site_data_dir",
+    "site_data_path",
+    "site_runtime_dir",
     "site_runtime_path",
+    "user_cache_dir",
+    "user_cache_path",
+    "user_config_dir",
+    "user_config_path",
+    "user_data_dir",
+    "user_data_path",
+    "user_desktop_dir",
+    "user_desktop_path",
+    "user_documents_dir",
+    "user_documents_path",
+    "user_downloads_dir",
+    "user_downloads_path",
+    "user_log_dir",
+    "user_log_path",
+    "user_music_dir",
+    "user_music_path",
+    "user_pictures_dir",
+    "user_pictures_path",
+    "user_runtime_dir",
+    "user_runtime_path",
+    "user_state_dir",
+    "user_state_path",
+    "user_videos_dir",
+    "user_videos_path",
 ]
diff --git a/lib/platformdirs/__main__.py b/lib/platformdirs/__main__.py
index 4bf27c9c..922c5213 100644
--- a/lib/platformdirs/__main__.py
+++ b/lib/platformdirs/__main__.py
@@ -24,7 +24,7 @@ PROPS = (
 
 
 def main() -> None:
-    """Run main entry point."""
+    """Run the main entry point."""
     app_name = "MyApp"
     app_author = "MyCompany"
 
diff --git a/lib/platformdirs/android.py b/lib/platformdirs/android.py
index 4acdb638..fefafd32 100644
--- a/lib/platformdirs/android.py
+++ b/lib/platformdirs/android.py
@@ -13,10 +13,11 @@ from .api import PlatformDirsABC
 
 class Android(PlatformDirsABC):
     """
-    Follows the guidance `from here <https://android.stackexchange.com/a/216132>`_. Makes use of the
-    `appname <platformdirs.api.PlatformDirsABC.appname>`,
-    `version <platformdirs.api.PlatformDirsABC.version>`,
-    `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
+    Follows the guidance `from here <https://android.stackexchange.com/a/216132>`_.
+
+    Makes use of the `appname <platformdirs.api.PlatformDirsABC.appname>`, `version
+    <platformdirs.api.PlatformDirsABC.version>`, `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
+
     """
 
     @property
@@ -44,7 +45,7 @@ class Android(PlatformDirsABC):
 
     @property
     def user_cache_dir(self) -> str:
-        """:return: cache directory tied to the user, e.g. e.g. ``/data/user/<userid>/<packagename>/cache/<AppName>``"""
+        """:return: cache directory tied to the user, e.g.,``/data/user/<userid>/<packagename>/cache/<AppName>``"""
         return self._append_app_name_and_version(cast(str, _android_folder()), "cache")
 
     @property
@@ -119,13 +120,13 @@ class Android(PlatformDirsABC):
 def _android_folder() -> str | None:
     """:return: base folder for the Android OS or None if it cannot be found"""
     try:
-        # First try to get path to android app via pyjnius
-        from jnius import autoclass
+        # First try to get a path to android app via pyjnius
+        from jnius import autoclass  # noqa: PLC0415
 
         context = autoclass("android.content.Context")
         result: str | None = context.getFilesDir().getParentFile().getAbsolutePath()
     except Exception:  # noqa: BLE001
-        # if fails find an android folder looking path on the sys.path
+        # if fails find an android folder looking a path on the sys.path
         pattern = re.compile(r"/data/(data|user/\d+)/(.+)/files")
         for path in sys.path:
             if pattern.match(path):
@@ -141,7 +142,7 @@ def _android_documents_folder() -> str:
     """:return: documents folder for the Android OS"""
     # Get directories with pyjnius
     try:
-        from jnius import autoclass
+        from jnius import autoclass  # noqa: PLC0415
 
         context = autoclass("android.content.Context")
         environment = autoclass("android.os.Environment")
@@ -157,7 +158,7 @@ def _android_downloads_folder() -> str:
     """:return: downloads folder for the Android OS"""
     # Get directories with pyjnius
     try:
-        from jnius import autoclass
+        from jnius import autoclass  # noqa: PLC0415
 
         context = autoclass("android.content.Context")
         environment = autoclass("android.os.Environment")
@@ -173,7 +174,7 @@ def _android_pictures_folder() -> str:
     """:return: pictures folder for the Android OS"""
     # Get directories with pyjnius
     try:
-        from jnius import autoclass
+        from jnius import autoclass  # noqa: PLC0415
 
         context = autoclass("android.content.Context")
         environment = autoclass("android.os.Environment")
@@ -189,7 +190,7 @@ def _android_videos_folder() -> str:
     """:return: videos folder for the Android OS"""
     # Get directories with pyjnius
     try:
-        from jnius import autoclass
+        from jnius import autoclass  # noqa: PLC0415
 
         context = autoclass("android.content.Context")
         environment = autoclass("android.os.Environment")
@@ -205,7 +206,7 @@ def _android_music_folder() -> str:
     """:return: music folder for the Android OS"""
     # Get directories with pyjnius
     try:
-        from jnius import autoclass
+        from jnius import autoclass  # noqa: PLC0415
 
         context = autoclass("android.content.Context")
         environment = autoclass("android.os.Environment")
diff --git a/lib/platformdirs/api.py b/lib/platformdirs/api.py
index 031a38a3..c50caa64 100644
--- a/lib/platformdirs/api.py
+++ b/lib/platformdirs/api.py
@@ -11,10 +11,10 @@ if TYPE_CHECKING:
     from typing import Iterator, Literal
 
 
-class PlatformDirsABC(ABC):
+class PlatformDirsABC(ABC):  # noqa: PLR0904
     """Abstract base class for platform directories."""
 
-    def __init__(  # noqa: PLR0913
+    def __init__(  # noqa: PLR0913, PLR0917
         self,
         appname: str | None = None,
         appauthor: str | None | Literal[False] = None,
@@ -34,34 +34,47 @@ class PlatformDirsABC(ABC):
         :param multipath: See `multipath`.
         :param opinion: See `opinion`.
         :param ensure_exists: See `ensure_exists`.
+
         """
         self.appname = appname  #: The name of application.
         self.appauthor = appauthor
         """
-        The name of the app author or distributing body for this application. Typically, it is the owning company name.
-        Defaults to `appname`. You may pass ``False`` to disable it.
+        The name of the app author or distributing body for this application.
+
+        Typically, it is the owning company name. Defaults to `appname`. You may pass ``False`` to disable it.
+
         """
         self.version = version
         """
-        An optional version path element to append to the path. You might want to use this if you want multiple versions
-        of your app to be able to run independently. If used, this would typically be ``<major>.<minor>``.
+        An optional version path element to append to the path.
+
+        You might want to use this if you want multiple versions of your app to be able to run independently. If used,
+        this would typically be ``<major>.<minor>``.
+
         """
         self.roaming = roaming
         """
-        Whether to use the roaming appdata directory on Windows. That means that for users on a Windows network setup
-        for roaming profiles, this user data will be synced on login (see
-        `here <http://technet.microsoft.com/en-us/library/cc766489(WS.10).aspx>`_).
+        Whether to use the roaming appdata directory on Windows.
+
+        That means that for users on a Windows network setup for roaming profiles, this user data will be synced on
+        login (see
+        `here <https://technet.microsoft.com/en-us/library/cc766489(WS.10).aspx>`_).
+
         """
         self.multipath = multipath
         """
         An optional parameter which indicates that the entire list of data dirs should be returned.
+
         By default, the first item would only be returned.
+
         """
         self.opinion = opinion  #: A flag to indicating to use opinionated values.
         self.ensure_exists = ensure_exists
         """
         Optionally create the directory (and any missing parents) upon access if it does not exist.
+
         By default, no directories are created.
+
         """
 
     def _append_app_name_and_version(self, *base: str) -> str:
@@ -200,7 +213,7 @@ class PlatformDirsABC(ABC):
 
     @property
     def user_documents_path(self) -> Path:
-        """:return: documents path tied to the user"""
+        """:return: documents a path tied to the user"""
         return Path(self.user_documents_dir)
 
     @property
diff --git a/lib/platformdirs/macos.py b/lib/platformdirs/macos.py
index b7b48808..eb1ba5df 100644
--- a/lib/platformdirs/macos.py
+++ b/lib/platformdirs/macos.py
@@ -10,11 +10,14 @@ from .api import PlatformDirsABC
 
 class MacOS(PlatformDirsABC):
     """
-    Platform directories for the macOS operating system. Follows the guidance from `Apple documentation
-    <https://developer.apple.com/library/archive/documentation/FileManagement/Conceptual/FileSystemProgrammingGuide/MacOSXDirectories/MacOSXDirectories.html>`_.
+    Platform directories for the macOS operating system.
+
+    Follows the guidance from
+    `Apple documentation <https://developer.apple.com/library/archive/documentation/FileManagement/Conceptual/FileSystemProgrammingGuide/MacOSXDirectories/MacOSXDirectories.html>`_.
     Makes use of the `appname <platformdirs.api.PlatformDirsABC.appname>`,
     `version <platformdirs.api.PlatformDirsABC.version>`,
     `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
+
     """
 
     @property
@@ -28,7 +31,7 @@ class MacOS(PlatformDirsABC):
         :return: data directory shared by users, e.g. ``/Library/Application Support/$appname/$version``.
           If we're using a Python binary managed by `Homebrew <https://brew.sh>`_, the directory
           will be under the Homebrew prefix, e.g. ``/opt/homebrew/share/$appname/$version``.
-          If `multipath <platformdirs.api.PlatformDirsABC.multipath>` is enabled and we're in Homebrew,
+          If `multipath <platformdirs.api.PlatformDirsABC.multipath>` is enabled, and we're in Homebrew,
           the response is a multi-path string separated by ":", e.g.
           ``/opt/homebrew/share/$appname/$version:/Library/Application Support/$appname/$version``
         """
@@ -60,7 +63,7 @@ class MacOS(PlatformDirsABC):
         :return: cache directory shared by users, e.g. ``/Library/Caches/$appname/$version``.
           If we're using a Python binary managed by `Homebrew <https://brew.sh>`_, the directory
           will be under the Homebrew prefix, e.g. ``/opt/homebrew/var/cache/$appname/$version``.
-          If `multipath <platformdirs.api.PlatformDirsABC.multipath>` is enabled and we're in Homebrew,
+          If `multipath <platformdirs.api.PlatformDirsABC.multipath>` is enabled, and we're in Homebrew,
           the response is a multi-path string separated by ":", e.g.
           ``/opt/homebrew/var/cache/$appname/$version:/Library/Caches/$appname/$version``
         """
diff --git a/lib/platformdirs/unix.py b/lib/platformdirs/unix.py
index ca4728e6..9500ade6 100644
--- a/lib/platformdirs/unix.py
+++ b/lib/platformdirs/unix.py
@@ -6,13 +6,13 @@ import os
 import sys
 from configparser import ConfigParser
 from pathlib import Path
-from typing import Iterator
+from typing import Iterator, NoReturn
 
 from .api import PlatformDirsABC
 
 if sys.platform == "win32":
 
-    def getuid() -> int:
+    def getuid() -> NoReturn:
         msg = "should only be used on Unix"
         raise RuntimeError(msg)
 
@@ -20,17 +20,17 @@ else:
     from os import getuid
 
 
-class Unix(PlatformDirsABC):
+class Unix(PlatformDirsABC):  # noqa: PLR0904
     """
-    On Unix/Linux, we follow the
-    `XDG Basedir Spec <https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html>`_. The spec allows
-    overriding directories with environment variables. The examples show are the default values, alongside the name of
-    the environment variable that overrides them. Makes use of the
-    `appname <platformdirs.api.PlatformDirsABC.appname>`,
-    `version <platformdirs.api.PlatformDirsABC.version>`,
-    `multipath <platformdirs.api.PlatformDirsABC.multipath>`,
-    `opinion <platformdirs.api.PlatformDirsABC.opinion>`,
-    `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
+    On Unix/Linux, we follow the `XDG Basedir Spec <https://specifications.freedesktop.org/basedir-spec/basedir-spec-
+    latest.html>`_.
+
+    The spec allows overriding directories with environment variables. The examples shown are the default values,
+    alongside the name of the environment variable that overrides them. Makes use of the `appname
+    <platformdirs.api.PlatformDirsABC.appname>`, `version <platformdirs.api.PlatformDirsABC.version>`, `multipath
+    <platformdirs.api.PlatformDirsABC.multipath>`, `opinion <platformdirs.api.PlatformDirsABC.opinion>`, `ensure_exists
+    <platformdirs.api.PlatformDirsABC.ensure_exists>`.
+
     """
 
     @property
@@ -205,17 +205,17 @@ class Unix(PlatformDirsABC):
 
     @property
     def site_data_path(self) -> Path:
-        """:return: data path shared by users. Only return first item, even if ``multipath`` is set to ``True``"""
+        """:return: data path shared by users. Only return the first item, even if ``multipath`` is set to ``True``"""
         return self._first_item_as_path_if_multipath(self.site_data_dir)
 
     @property
     def site_config_path(self) -> Path:
-        """:return: config path shared by the users. Only return first item, even if ``multipath`` is set to ``True``"""
+        """:return: config path shared by the users, returns the first item, even if ``multipath`` is set to ``True``"""
         return self._first_item_as_path_if_multipath(self.site_config_dir)
 
     @property
     def site_cache_path(self) -> Path:
-        """:return: cache path shared by users. Only return first item, even if ``multipath`` is set to ``True``"""
+        """:return: cache path shared by users. Only return the first item, even if ``multipath`` is set to ``True``"""
         return self._first_item_as_path_if_multipath(self.site_cache_dir)
 
     def _first_item_as_path_if_multipath(self, directory: str) -> Path:
@@ -246,7 +246,12 @@ def _get_user_media_dir(env_var: str, fallback_tilde_path: str) -> str:
 
 
 def _get_user_dirs_folder(key: str) -> str | None:
-    """Return directory from user-dirs.dirs config file. See https://freedesktop.org/wiki/Software/xdg-user-dirs/."""
+    """
+    Return directory from user-dirs.dirs config file.
+
+    See https://freedesktop.org/wiki/Software/xdg-user-dirs/.
+
+    """
     user_dirs_config_path = Path(Unix().user_config_dir) / "user-dirs.dirs"
     if user_dirs_config_path.exists():
         parser = ConfigParser()
diff --git a/lib/platformdirs/version.py b/lib/platformdirs/version.py
index cc1e3456..c418cd0c 100644
--- a/lib/platformdirs/version.py
+++ b/lib/platformdirs/version.py
@@ -12,5 +12,5 @@ __version__: str
 __version_tuple__: VERSION_TUPLE
 version_tuple: VERSION_TUPLE
 
-__version__ = version = '4.2.0'
-__version_tuple__ = version_tuple = (4, 2, 0)
+__version__ = version = '4.2.1'
+__version_tuple__ = version_tuple = (4, 2, 1)
diff --git a/lib/platformdirs/windows.py b/lib/platformdirs/windows.py
index c62d0c8d..d7bc9609 100644
--- a/lib/platformdirs/windows.py
+++ b/lib/platformdirs/windows.py
@@ -2,7 +2,6 @@
 
 from __future__ import annotations
 
-import ctypes
 import os
 import sys
 from functools import lru_cache
@@ -16,15 +15,13 @@ if TYPE_CHECKING:
 
 class Windows(PlatformDirsABC):
     """
-    `MSDN on where to store app data files
-    <http://support.microsoft.com/default.aspx?scid=kb;en-us;310294#XSLTH3194121123120121120120>`_.
-    Makes use of the
-    `appname <platformdirs.api.PlatformDirsABC.appname>`,
-    `appauthor <platformdirs.api.PlatformDirsABC.appauthor>`,
-    `version <platformdirs.api.PlatformDirsABC.version>`,
-    `roaming <platformdirs.api.PlatformDirsABC.roaming>`,
-    `opinion <platformdirs.api.PlatformDirsABC.opinion>`,
-    `ensure_exists <platformdirs.api.PlatformDirsABC.ensure_exists>`.
+    `MSDN on where to store app data files <https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid>`_.
+
+    Makes use of the `appname <platformdirs.api.PlatformDirsABC.appname>`, `appauthor
+    <platformdirs.api.PlatformDirsABC.appauthor>`, `version <platformdirs.api.PlatformDirsABC.version>`, `roaming
+    <platformdirs.api.PlatformDirsABC.roaming>`, `opinion <platformdirs.api.PlatformDirsABC.opinion>`, `ensure_exists
+    <platformdirs.api.PlatformDirsABC.ensure_exists>`.
+
     """
 
     @property
@@ -165,7 +162,7 @@ def get_win_folder_from_env_vars(csidl_name: str) -> str:
 
 
 def get_win_folder_if_csidl_name_not_env_var(csidl_name: str) -> str | None:
-    """Get folder for a CSIDL name that does not exist as an environment variable."""
+    """Get a folder for a CSIDL name that does not exist as an environment variable."""
     if csidl_name == "CSIDL_PERSONAL":
         return os.path.join(os.path.normpath(os.environ["USERPROFILE"]), "Documents")  # noqa: PTH118
 
@@ -189,6 +186,7 @@ def get_win_folder_from_registry(csidl_name: str) -> str:
 
     This is a fallback technique at best. I'm not sure if using the registry for these guarantees us the correct answer
     for all CSIDL_* names.
+
     """
     shell_folder_name = {
         "CSIDL_APPDATA": "AppData",
@@ -205,7 +203,7 @@ def get_win_folder_from_registry(csidl_name: str) -> str:
         raise ValueError(msg)
     if sys.platform != "win32":  # only needed for mypy type checker to know that this code runs only on Windows
         raise NotImplementedError
-    import winreg
+    import winreg  # noqa: PLC0415
 
     key = winreg.OpenKey(winreg.HKEY_CURRENT_USER, r"Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders")
     directory, _ = winreg.QueryValueEx(key, shell_folder_name)
@@ -218,6 +216,8 @@ def get_win_folder_via_ctypes(csidl_name: str) -> str:
     # Use 'CSIDL_PROFILE' (40) and append the default folder 'Downloads' instead.
     # https://learn.microsoft.com/en-us/windows/win32/shell/knownfolderid
 
+    import ctypes  # noqa: PLC0415
+
     csidl_const = {
         "CSIDL_APPDATA": 26,
         "CSIDL_COMMON_APPDATA": 35,
@@ -250,10 +250,15 @@ def get_win_folder_via_ctypes(csidl_name: str) -> str:
 
 
 def _pick_get_win_folder() -> Callable[[str], str]:
-    if hasattr(ctypes, "windll"):
-        return get_win_folder_via_ctypes
     try:
-        import winreg  # noqa: F401
+        import ctypes  # noqa: PLC0415
+    except ImportError:
+        pass
+    else:
+        if hasattr(ctypes, "windll"):
+            return get_win_folder_via_ctypes
+    try:
+        import winreg  # noqa: PLC0415, F401
     except ImportError:
         return get_win_folder_from_env_vars
     else:
diff --git a/requirements.txt b/requirements.txt
index cdf89bb5..e630e23a 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -25,7 +25,7 @@ MarkupSafe==2.1.5
 musicbrainzngs==0.7.1
 packaging==24.0
 paho-mqtt==2.0.0
-platformdirs==4.2.0
+platformdirs==4.2.1
 plexapi==4.15.12
 portend==3.2.0
 profilehooks==1.12.0

From dab46249f252841dba053a668ce1b05bd070931f Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 9 May 2024 22:28:14 -0700
Subject: [PATCH 596/743] Bump websocket-client from 1.7.0 to 1.8.0 (#2313)

* Bump websocket-client from 1.7.0 to 1.8.0

Bumps [websocket-client](https://github.com/websocket-client/websocket-client) from 1.7.0 to 1.8.0.
- [Release notes](https://github.com/websocket-client/websocket-client/releases)
- [Changelog](https://github.com/websocket-client/websocket-client/blob/master/ChangeLog)
- [Commits](https://github.com/websocket-client/websocket-client/compare/v1.7.0...v1.8.0)

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

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

* Update websocket-client==1.8.0

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/websocket/__init__.py             |  6 +-
 lib/websocket/_abnf.py                |  4 +-
 lib/websocket/_app.py                 | 18 +++++-
 lib/websocket/_cookiejar.py           | 20 +++----
 lib/websocket/_core.py                | 20 +++----
 lib/websocket/_exceptions.py          |  2 +-
 lib/websocket/_handshake.py           | 10 ++--
 lib/websocket/_http.py                | 34 ++++++-----
 lib/websocket/_logging.py             |  2 +-
 lib/websocket/_socket.py              | 11 ++--
 lib/websocket/_ssl_compat.py          | 16 +++++-
 lib/websocket/_url.py                 |  5 +-
 lib/websocket/_utils.py               |  2 +-
 lib/websocket/_wsdump.py              |  2 +-
 lib/websocket/tests/echo-server.py    |  2 +-
 lib/websocket/tests/test_abnf.py      | 28 ++++-----
 lib/websocket/tests/test_app.py       | 53 +++++++++--------
 lib/websocket/tests/test_cookiejar.py |  8 +--
 lib/websocket/tests/test_http.py      | 29 +++++-----
 lib/websocket/tests/test_url.py       | 53 +++++++++++------
 lib/websocket/tests/test_websocket.py | 82 ++++++++++++---------------
 requirements.txt                      |  2 +-
 22 files changed, 225 insertions(+), 184 deletions(-)

diff --git a/lib/websocket/__init__.py b/lib/websocket/__init__.py
index 2ff75879..559b38a6 100644
--- a/lib/websocket/__init__.py
+++ b/lib/websocket/__init__.py
@@ -2,7 +2,7 @@
 __init__.py
 websocket - WebSocket client library for Python
 
-Copyright 2023 engn33r
+Copyright 2024 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
@@ -17,10 +17,10 @@ See the License for the specific language governing permissions and
 limitations under the License.
 """
 from ._abnf import *
-from ._app import WebSocketApp, setReconnect
+from ._app import WebSocketApp as WebSocketApp, setReconnect as setReconnect
 from ._core import *
 from ._exceptions import *
 from ._logging import *
 from ._socket import *
 
-__version__ = "1.7.0"
+__version__ = "1.8.0"
diff --git a/lib/websocket/_abnf.py b/lib/websocket/_abnf.py
index 416ebc8f..d7754e0d 100644
--- a/lib/websocket/_abnf.py
+++ b/lib/websocket/_abnf.py
@@ -5,14 +5,14 @@ import sys
 from threading import Lock
 from typing import Callable, Optional, Union
 
-from ._exceptions import *
+from ._exceptions import WebSocketPayloadException, WebSocketProtocolException
 from ._utils import validate_utf8
 
 """
 _abnf.py
 websocket - WebSocket client library for Python
 
-Copyright 2023 engn33r
+Copyright 2024 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
diff --git a/lib/websocket/_app.py b/lib/websocket/_app.py
index 4d8af3b5..9fee7654 100644
--- a/lib/websocket/_app.py
+++ b/lib/websocket/_app.py
@@ -13,13 +13,14 @@ from ._exceptions import (
     WebSocketException,
     WebSocketTimeoutException,
 )
+from ._ssl_compat import SSLEOFError
 from ._url import parse_url
 
 """
 _app.py
 websocket - WebSocket client library for Python
 
-Copyright 2023 engn33r
+Copyright 2024 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
@@ -165,6 +166,7 @@ class WebSocketApp:
         url: str,
         header: Union[list, dict, Callable, None] = None,
         on_open: Optional[Callable[[WebSocket], None]] = None,
+        on_reconnect: Optional[Callable[[WebSocket], None]] = None,
         on_message: Optional[Callable[[WebSocket, Any], None]] = None,
         on_error: Optional[Callable[[WebSocket, Any], None]] = None,
         on_close: Optional[Callable[[WebSocket, Any, Any], None]] = None,
@@ -194,6 +196,10 @@ class WebSocketApp:
             Callback object which is called at opening websocket.
             on_open has one argument.
             The 1st argument is this class object.
+        on_reconnect: function
+            Callback object which is called at reconnecting websocket.
+            on_reconnect has one argument.
+            The 1st argument is this class object.
         on_message: function
             Callback object which is called when received data.
             on_message has 2 arguments.
@@ -244,6 +250,7 @@ class WebSocketApp:
         self.cookie = cookie
 
         self.on_open = on_open
+        self.on_reconnect = on_reconnect
         self.on_message = on_message
         self.on_data = on_data
         self.on_error = on_error
@@ -424,6 +431,7 @@ class WebSocketApp:
         self.ping_interval = ping_interval
         self.ping_timeout = ping_timeout
         self.ping_payload = ping_payload
+        self.has_done_teardown = False
         self.keep_running = True
 
         def teardown(close_frame: ABNF = None):
@@ -495,7 +503,10 @@ class WebSocketApp:
                 if self.ping_interval:
                     self._start_ping_thread()
 
-                self._callback(self.on_open)
+                if reconnecting and self.on_reconnect:
+                    self._callback(self.on_reconnect)
+                else:
+                    self._callback(self.on_open)
 
                 dispatcher.read(self.sock.sock, read, check)
             except (
@@ -516,9 +527,10 @@ class WebSocketApp:
             except (
                 WebSocketConnectionClosedException,
                 KeyboardInterrupt,
+                SSLEOFError,
             ) as e:
                 if custom_dispatcher:
-                    return handleDisconnect(e)
+                    return handleDisconnect(e, bool(reconnect))
                 else:
                     raise e
 
diff --git a/lib/websocket/_cookiejar.py b/lib/websocket/_cookiejar.py
index 61079402..7480e5fc 100644
--- a/lib/websocket/_cookiejar.py
+++ b/lib/websocket/_cookiejar.py
@@ -5,7 +5,7 @@ from typing import Optional
 _cookiejar.py
 websocket - WebSocket client library for Python
 
-Copyright 2023 engn33r
+Copyright 2024 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
@@ -23,13 +23,13 @@ limitations under the License.
 
 class SimpleCookieJar:
     def __init__(self) -> None:
-        self.jar: dict = dict()
+        self.jar: dict = {}
 
     def add(self, set_cookie: Optional[str]) -> None:
         if set_cookie:
-            simpleCookie = http.cookies.SimpleCookie(set_cookie)
+            simple_cookie = http.cookies.SimpleCookie(set_cookie)
 
-            for k, v in simpleCookie.items():
+            for v in simple_cookie.values():
                 if domain := v.get("domain"):
                     if not domain.startswith("."):
                         domain = f".{domain}"
@@ -38,25 +38,25 @@ class SimpleCookieJar:
                         if self.jar.get(domain)
                         else http.cookies.SimpleCookie()
                     )
-                    cookie.update(simpleCookie)
+                    cookie.update(simple_cookie)
                     self.jar[domain.lower()] = cookie
 
     def set(self, set_cookie: str) -> None:
         if set_cookie:
-            simpleCookie = http.cookies.SimpleCookie(set_cookie)
+            simple_cookie = http.cookies.SimpleCookie(set_cookie)
 
-            for k, v in simpleCookie.items():
+            for v in simple_cookie.values():
                 if domain := v.get("domain"):
                     if not domain.startswith("."):
                         domain = f".{domain}"
-                    self.jar[domain.lower()] = simpleCookie
+                    self.jar[domain.lower()] = simple_cookie
 
     def get(self, host: str) -> str:
         if not host:
             return ""
 
         cookies = []
-        for domain, simpleCookie in self.jar.items():
+        for domain, _ in self.jar.items():
             host = host.lower()
             if host.endswith(domain) or host == domain[1:]:
                 cookies.append(self.jar.get(domain))
@@ -66,7 +66,7 @@ class SimpleCookieJar:
                 None,
                 sorted(
                     [
-                        "%s=%s" % (k, v.value)
+                        f"{k}={v.value}"
                         for cookie in filter(None, cookies)
                         for k, v in cookie.items()
                     ]
diff --git a/lib/websocket/_core.py b/lib/websocket/_core.py
index f28ca4b9..f940ed05 100644
--- a/lib/websocket/_core.py
+++ b/lib/websocket/_core.py
@@ -5,20 +5,20 @@ import time
 from typing import Optional, Union
 
 # websocket modules
-from ._abnf import *
-from ._exceptions import *
-from ._handshake import *
-from ._http import *
-from ._logging import *
-from ._socket import *
-from ._ssl_compat import *
-from ._utils import *
+from ._abnf import ABNF, STATUS_NORMAL, continuous_frame, frame_buffer
+from ._exceptions import WebSocketProtocolException, WebSocketConnectionClosedException
+from ._handshake import SUPPORTED_REDIRECT_STATUSES, handshake
+from ._http import connect, proxy_info
+from ._logging import debug, error, trace, isEnabledForError, isEnabledForTrace
+from ._socket import getdefaulttimeout, recv, send, sock_opt
+from ._ssl_compat import ssl
+from ._utils import NoLock
 
 """
 _core.py
 websocket - WebSocket client library for Python
 
-Copyright 2023 engn33r
+Copyright 2024 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
@@ -259,7 +259,7 @@ class WebSocket:
 
         try:
             self.handshake_response = handshake(self.sock, url, *addrs, **options)
-            for attempt in range(options.pop("redirect_limit", 3)):
+            for _ in range(options.pop("redirect_limit", 3)):
                 if self.handshake_response.status in SUPPORTED_REDIRECT_STATUSES:
                     url = self.handshake_response.headers["location"]
                     self.sock.close()
diff --git a/lib/websocket/_exceptions.py b/lib/websocket/_exceptions.py
index c146fa5d..cd196e44 100644
--- a/lib/websocket/_exceptions.py
+++ b/lib/websocket/_exceptions.py
@@ -2,7 +2,7 @@
 _exceptions.py
 websocket - WebSocket client library for Python
 
-Copyright 2023 engn33r
+Copyright 2024 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
diff --git a/lib/websocket/_handshake.py b/lib/websocket/_handshake.py
index e63dc979..7bd61b82 100644
--- a/lib/websocket/_handshake.py
+++ b/lib/websocket/_handshake.py
@@ -2,7 +2,7 @@
 _handshake.py
 websocket - WebSocket client library for Python
 
-Copyright 2023 engn33r
+Copyright 2024 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
@@ -23,10 +23,10 @@ from base64 import encodebytes as base64encode
 from http import HTTPStatus
 
 from ._cookiejar import SimpleCookieJar
-from ._exceptions import *
-from ._http import *
-from ._logging import *
-from ._socket import *
+from ._exceptions import WebSocketException, WebSocketBadStatusException
+from ._http import read_headers
+from ._logging import dump, error
+from ._socket import send
 
 __all__ = ["handshake_response", "handshake", "SUPPORTED_REDIRECT_STATUSES"]
 
diff --git a/lib/websocket/_http.py b/lib/websocket/_http.py
index 977a30f1..9b1bf859 100644
--- a/lib/websocket/_http.py
+++ b/lib/websocket/_http.py
@@ -2,7 +2,7 @@
 _http.py
 websocket - WebSocket client library for Python
 
-Copyright 2023 engn33r
+Copyright 2024 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
@@ -21,11 +21,15 @@ import os
 import socket
 from base64 import encodebytes as base64encode
 
-from ._exceptions import *
-from ._logging import *
-from ._socket import *
-from ._ssl_compat import *
-from ._url import *
+from ._exceptions import (
+    WebSocketAddressException,
+    WebSocketException,
+    WebSocketProxyException,
+)
+from ._logging import debug, dump, trace
+from ._socket import DEFAULT_SOCKET_OPTION, recv_line, send
+from ._ssl_compat import HAVE_SSL, ssl
+from ._url import get_proxy_info, parse_url
 
 __all__ = ["proxy_info", "connect", "read_headers"]
 
@@ -283,22 +287,22 @@ def _wrap_sni_socket(sock: socket.socket, sslopt: dict, hostname, check_hostname
 
 
 def _ssl_socket(sock: socket.socket, user_sslopt: dict, hostname):
-    sslopt: dict = dict(cert_reqs=ssl.CERT_REQUIRED)
+    sslopt: dict = {"cert_reqs": ssl.CERT_REQUIRED}
     sslopt.update(user_sslopt)
 
-    certPath = os.environ.get("WEBSOCKET_CLIENT_CA_BUNDLE")
+    cert_path = os.environ.get("WEBSOCKET_CLIENT_CA_BUNDLE")
     if (
-        certPath
-        and os.path.isfile(certPath)
+        cert_path
+        and os.path.isfile(cert_path)
         and user_sslopt.get("ca_certs", None) is None
     ):
-        sslopt["ca_certs"] = certPath
+        sslopt["ca_certs"] = cert_path
     elif (
-        certPath
-        and os.path.isdir(certPath)
+        cert_path
+        and os.path.isdir(cert_path)
         and user_sslopt.get("ca_cert_path", None) is None
     ):
-        sslopt["ca_cert_path"] = certPath
+        sslopt["ca_cert_path"] = cert_path
 
     if sslopt.get("server_hostname", None):
         hostname = sslopt["server_hostname"]
@@ -327,7 +331,7 @@ def _tunnel(sock: socket.socket, host, port: int, auth) -> socket.socket:
     send(sock, connect_header)
 
     try:
-        status, resp_headers, status_message = read_headers(sock)
+        status, _, _ = read_headers(sock)
     except Exception as e:
         raise WebSocketProxyException(str(e))
 
diff --git a/lib/websocket/_logging.py b/lib/websocket/_logging.py
index b88cda37..0f673d3a 100644
--- a/lib/websocket/_logging.py
+++ b/lib/websocket/_logging.py
@@ -4,7 +4,7 @@ import logging
 _logging.py
 websocket - WebSocket client library for Python
 
-Copyright 2023 engn33r
+Copyright 2024 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
diff --git a/lib/websocket/_socket.py b/lib/websocket/_socket.py
index f0ad27a5..81094ffc 100644
--- a/lib/websocket/_socket.py
+++ b/lib/websocket/_socket.py
@@ -3,15 +3,18 @@ import selectors
 import socket
 from typing import Union
 
-from ._exceptions import *
-from ._ssl_compat import *
-from ._utils import *
+from ._exceptions import (
+    WebSocketConnectionClosedException,
+    WebSocketTimeoutException,
+)
+from ._ssl_compat import SSLError, SSLWantReadError, SSLWantWriteError
+from ._utils import extract_error_code, extract_err_message
 
 """
 _socket.py
 websocket - WebSocket client library for Python
 
-Copyright 2023 engn33r
+Copyright 2024 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
diff --git a/lib/websocket/_ssl_compat.py b/lib/websocket/_ssl_compat.py
index 029a5c6e..0a8a32b5 100644
--- a/lib/websocket/_ssl_compat.py
+++ b/lib/websocket/_ssl_compat.py
@@ -2,7 +2,7 @@
 _ssl_compat.py
 websocket - WebSocket client library for Python
 
-Copyright 2023 engn33r
+Copyright 2024 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
@@ -16,11 +16,18 @@ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.
 """
-__all__ = ["HAVE_SSL", "ssl", "SSLError", "SSLWantReadError", "SSLWantWriteError"]
+__all__ = [
+    "HAVE_SSL",
+    "ssl",
+    "SSLError",
+    "SSLEOFError",
+    "SSLWantReadError",
+    "SSLWantWriteError",
+]
 
 try:
     import ssl
-    from ssl import SSLError, SSLWantReadError, SSLWantWriteError
+    from ssl import SSLError, SSLEOFError, SSLWantReadError, SSLWantWriteError
 
     HAVE_SSL = True
 except ImportError:
@@ -28,6 +35,9 @@ except ImportError:
     class SSLError(Exception):
         pass
 
+    class SSLEOFError(Exception):
+        pass
+
     class SSLWantReadError(Exception):
         pass
 
diff --git a/lib/websocket/_url.py b/lib/websocket/_url.py
index 7d53830e..90213171 100644
--- a/lib/websocket/_url.py
+++ b/lib/websocket/_url.py
@@ -3,12 +3,13 @@ import socket
 import struct
 from typing import Optional
 from urllib.parse import unquote, urlparse
+from ._exceptions import WebSocketProxyException
 
 """
 _url.py
 websocket - WebSocket client library for Python
 
-Copyright 2023 engn33r
+Copyright 2024 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
@@ -167,6 +168,8 @@ def get_proxy_info(
         return None, 0, None
 
     if proxy_host:
+        if not proxy_port:
+            raise WebSocketProxyException("Cannot use port 0 when proxy_host specified")
         port = proxy_port
         auth = proxy_auth
         return proxy_host, port, auth
diff --git a/lib/websocket/_utils.py b/lib/websocket/_utils.py
index c63adfa5..65f3c0da 100644
--- a/lib/websocket/_utils.py
+++ b/lib/websocket/_utils.py
@@ -4,7 +4,7 @@ from typing import Union
 _url.py
 websocket - WebSocket client library for Python
 
-Copyright 2023 engn33r
+Copyright 2024 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
diff --git a/lib/websocket/_wsdump.py b/lib/websocket/_wsdump.py
index 34c3d127..d4d76dc5 100644
--- a/lib/websocket/_wsdump.py
+++ b/lib/websocket/_wsdump.py
@@ -4,7 +4,7 @@
 wsdump.py
 websocket - WebSocket client library for Python
 
-Copyright 2023 engn33r
+Copyright 2024 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
diff --git a/lib/websocket/tests/echo-server.py b/lib/websocket/tests/echo-server.py
index a32c6503..5d1e8708 100644
--- a/lib/websocket/tests/echo-server.py
+++ b/lib/websocket/tests/echo-server.py
@@ -10,7 +10,7 @@ import websockets
 LOCAL_WS_SERVER_PORT = int(os.environ.get("LOCAL_WS_SERVER_PORT", "8765"))
 
 
-async def echo(websocket, path):
+async def echo(websocket):
     async for message in websocket:
         await websocket.send(message)
 
diff --git a/lib/websocket/tests/test_abnf.py b/lib/websocket/tests/test_abnf.py
index df5bc6bd..a749f13b 100644
--- a/lib/websocket/tests/test_abnf.py
+++ b/lib/websocket/tests/test_abnf.py
@@ -2,14 +2,14 @@
 #
 import unittest
 
-import websocket as ws
-from websocket._abnf import *
+from websocket._abnf import ABNF, frame_buffer
+from websocket._exceptions import WebSocketProtocolException
 
 """
 test_abnf.py
 websocket - WebSocket client library for Python
 
-Copyright 2023 engn33r
+Copyright 2024 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
@@ -26,7 +26,7 @@ limitations under the License.
 
 
 class ABNFTest(unittest.TestCase):
-    def testInit(self):
+    def test_init(self):
         a = ABNF(0, 0, 0, 0, opcode=ABNF.OPCODE_PING)
         self.assertEqual(a.fin, 0)
         self.assertEqual(a.rsv1, 0)
@@ -38,28 +38,28 @@ class ABNFTest(unittest.TestCase):
         self.assertEqual(a_bad.rsv1, 1)
         self.assertEqual(a_bad.opcode, 77)
 
-    def testValidate(self):
+    def test_validate(self):
         a_invalid_ping = ABNF(0, 0, 0, 0, opcode=ABNF.OPCODE_PING)
         self.assertRaises(
-            ws._exceptions.WebSocketProtocolException,
+            WebSocketProtocolException,
             a_invalid_ping.validate,
             skip_utf8_validation=False,
         )
         a_bad_rsv_value = ABNF(0, 1, 0, 0, opcode=ABNF.OPCODE_TEXT)
         self.assertRaises(
-            ws._exceptions.WebSocketProtocolException,
+            WebSocketProtocolException,
             a_bad_rsv_value.validate,
             skip_utf8_validation=False,
         )
         a_bad_opcode = ABNF(0, 0, 0, 0, opcode=77)
         self.assertRaises(
-            ws._exceptions.WebSocketProtocolException,
+            WebSocketProtocolException,
             a_bad_opcode.validate,
             skip_utf8_validation=False,
         )
         a_bad_close_frame = ABNF(0, 0, 0, 0, opcode=ABNF.OPCODE_CLOSE, data=b"\x01")
         self.assertRaises(
-            ws._exceptions.WebSocketProtocolException,
+            WebSocketProtocolException,
             a_bad_close_frame.validate,
             skip_utf8_validation=False,
         )
@@ -67,7 +67,7 @@ class ABNFTest(unittest.TestCase):
             0, 0, 0, 0, opcode=ABNF.OPCODE_CLOSE, data=b"\x01\x8a\xaa\xff\xdd"
         )
         self.assertRaises(
-            ws._exceptions.WebSocketProtocolException,
+            WebSocketProtocolException,
             a_bad_close_frame_2.validate,
             skip_utf8_validation=False,
         )
@@ -75,12 +75,12 @@ class ABNFTest(unittest.TestCase):
             0, 0, 0, 0, opcode=ABNF.OPCODE_CLOSE, data=b"\x03\xe7"
         )
         self.assertRaises(
-            ws._exceptions.WebSocketProtocolException,
+            WebSocketProtocolException,
             a_bad_close_frame_3.validate,
             skip_utf8_validation=True,
         )
 
-    def testMask(self):
+    def test_mask(self):
         abnf_none_data = ABNF(
             0, 0, 0, 0, opcode=ABNF.OPCODE_PING, mask_value=1, data=None
         )
@@ -91,7 +91,7 @@ class ABNFTest(unittest.TestCase):
         )
         self.assertEqual(abnf_str_data._get_masked(bytes_val), b"aaaa\x00")
 
-    def testFormat(self):
+    def test_format(self):
         abnf_bad_rsv_bits = ABNF(2, 0, 0, 0, opcode=ABNF.OPCODE_TEXT)
         self.assertRaises(ValueError, abnf_bad_rsv_bits.format)
         abnf_bad_opcode = ABNF(0, 0, 0, 0, opcode=5)
@@ -110,7 +110,7 @@ class ABNFTest(unittest.TestCase):
         )
         self.assertEqual(b"\x01\x03\x01\x8a\xcc", abnf_no_mask.format())
 
-    def testFrameBuffer(self):
+    def test_frame_buffer(self):
         fb = frame_buffer(0, True)
         self.assertEqual(fb.recv, 0)
         self.assertEqual(fb.skip_utf8_validation, True)
diff --git a/lib/websocket/tests/test_app.py b/lib/websocket/tests/test_app.py
index 5ed9a22e..18eace54 100644
--- a/lib/websocket/tests/test_app.py
+++ b/lib/websocket/tests/test_app.py
@@ -12,7 +12,7 @@ import websocket as ws
 test_app.py
 websocket - WebSocket client library for Python
 
-Copyright 2023 engn33r
+Copyright 2024 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
@@ -53,10 +53,13 @@ class WebSocketAppTest(unittest.TestCase):
         WebSocketAppTest.get_mask_key_id = WebSocketAppTest.NotSetYet()
         WebSocketAppTest.on_error_data = WebSocketAppTest.NotSetYet()
 
+    def close(self):
+        pass
+
     @unittest.skipUnless(
         TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled"
     )
-    def testKeepRunning(self):
+    def test_keep_running(self):
         """A WebSocketApp should keep running as long as its self.keep_running
         is not False (in the boolean context).
         """
@@ -69,7 +72,7 @@ class WebSocketAppTest(unittest.TestCase):
             WebSocketAppTest.keep_running_open = self.keep_running
             self.keep_running = False
 
-        def on_message(wsapp, message):
+        def on_message(_, message):
             print(message)
             self.close()
 
@@ -87,7 +90,7 @@ class WebSocketAppTest(unittest.TestCase):
 
     #    @unittest.skipUnless(TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled")
     @unittest.skipUnless(False, "Test disabled for now (requires rel)")
-    def testRunForeverDispatcher(self):
+    def test_run_forever_dispatcher(self):
         """A WebSocketApp should keep running as long as its self.keep_running
         is not False (in the boolean context).
         """
@@ -98,7 +101,7 @@ class WebSocketAppTest(unittest.TestCase):
             self.recv()
             self.send("goodbye!")
 
-        def on_message(wsapp, message):
+        def on_message(_, message):
             print(message)
             self.close()
 
@@ -115,7 +118,7 @@ class WebSocketAppTest(unittest.TestCase):
     @unittest.skipUnless(
         TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled"
     )
-    def testRunForeverTeardownCleanExit(self):
+    def test_run_forever_teardown_clean_exit(self):
         """The WebSocketApp.run_forever() method should return `False` when the application ends gracefully."""
         app = ws.WebSocketApp(f"ws://127.0.0.1:{LOCAL_WS_SERVER_PORT}")
         threading.Timer(interval=0.2, function=app.close).start()
@@ -123,7 +126,7 @@ class WebSocketAppTest(unittest.TestCase):
         self.assertEqual(teardown, False)
 
     @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled")
-    def testSockMaskKey(self):
+    def test_sock_mask_key(self):
         """A WebSocketApp should forward the received mask_key function down
         to the actual socket.
         """
@@ -140,14 +143,14 @@ class WebSocketAppTest(unittest.TestCase):
         self.assertEqual(id(app.get_mask_key), id(my_mask_key_func))
 
     @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled")
-    def testInvalidPingIntervalPingTimeout(self):
+    def test_invalid_ping_interval_ping_timeout(self):
         """Test exception handling if ping_interval < ping_timeout"""
 
-        def on_ping(app, msg):
+        def on_ping(app, _):
             print("Got a ping!")
             app.close()
 
-        def on_pong(app, msg):
+        def on_pong(app, _):
             print("Got a pong! No need to respond")
             app.close()
 
@@ -163,14 +166,14 @@ class WebSocketAppTest(unittest.TestCase):
         )
 
     @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled")
-    def testPingInterval(self):
+    def test_ping_interval(self):
         """Test WebSocketApp proper ping functionality"""
 
-        def on_ping(app, msg):
+        def on_ping(app, _):
             print("Got a ping!")
             app.close()
 
-        def on_pong(app, msg):
+        def on_pong(app, _):
             print("Got a pong! No need to respond")
             app.close()
 
@@ -182,7 +185,7 @@ class WebSocketAppTest(unittest.TestCase):
         )
 
     @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled")
-    def testOpcodeClose(self):
+    def test_opcode_close(self):
         """Test WebSocketApp close opcode"""
 
         app = ws.WebSocketApp("wss://tsock.us1.twilio.com/v3/wsconnect")
@@ -197,7 +200,7 @@ class WebSocketAppTest(unittest.TestCase):
     #     app.run_forever(ping_interval=2, ping_timeout=1, ping_payload="Ping payload")
 
     @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled")
-    def testBadPingInterval(self):
+    def test_bad_ping_interval(self):
         """A WebSocketApp handling of negative ping_interval"""
         app = ws.WebSocketApp("wss://api-pub.bitfinex.com/ws/1")
         self.assertRaises(
@@ -208,7 +211,7 @@ class WebSocketAppTest(unittest.TestCase):
         )
 
     @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled")
-    def testBadPingTimeout(self):
+    def test_bad_ping_timeout(self):
         """A WebSocketApp handling of negative ping_timeout"""
         app = ws.WebSocketApp("wss://api-pub.bitfinex.com/ws/1")
         self.assertRaises(
@@ -219,7 +222,7 @@ class WebSocketAppTest(unittest.TestCase):
         )
 
     @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled")
-    def testCloseStatusCode(self):
+    def test_close_status_code(self):
         """Test extraction of close frame status code and close reason in WebSocketApp"""
 
         def on_close(wsapp, close_status_code, close_msg):
@@ -249,7 +252,7 @@ class WebSocketAppTest(unittest.TestCase):
     @unittest.skipUnless(
         TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled"
     )
-    def testCallbackFunctionException(self):
+    def test_callback_function_exception(self):
         """Test callback function exception handling"""
 
         exc = None
@@ -264,7 +267,7 @@ class WebSocketAppTest(unittest.TestCase):
             nonlocal exc
             exc = err
 
-        def on_pong(app, msg):
+        def on_pong(app, _):
             app.close()
 
         app = ws.WebSocketApp(
@@ -282,7 +285,7 @@ class WebSocketAppTest(unittest.TestCase):
     @unittest.skipUnless(
         TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled"
     )
-    def testCallbackMethodException(self):
+    def test_callback_method_exception(self):
         """Test callback method exception handling"""
 
         class Callbacks:
@@ -297,14 +300,14 @@ class WebSocketAppTest(unittest.TestCase):
                 )
                 self.app.run_forever(ping_interval=2, ping_timeout=1)
 
-            def on_open(self, app):
+            def on_open(self, _):
                 raise RuntimeError("Callback failed")
 
             def on_error(self, app, err):
                 self.passed_app = app
                 self.exc = err
 
-            def on_pong(self, app, msg):
+            def on_pong(self, app, _):
                 app.close()
 
         callbacks = Callbacks()
@@ -316,16 +319,16 @@ class WebSocketAppTest(unittest.TestCase):
     @unittest.skipUnless(
         TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled"
     )
-    def testReconnect(self):
+    def test_reconnect(self):
         """Test reconnect"""
         pong_count = 0
         exc = None
 
-        def on_error(app, err):
+        def on_error(_, err):
             nonlocal exc
             exc = err
 
-        def on_pong(app, msg):
+        def on_pong(app, _):
             nonlocal pong_count
             pong_count += 1
             if pong_count == 1:
diff --git a/lib/websocket/tests/test_cookiejar.py b/lib/websocket/tests/test_cookiejar.py
index 0de87517..67eddb62 100644
--- a/lib/websocket/tests/test_cookiejar.py
+++ b/lib/websocket/tests/test_cookiejar.py
@@ -6,7 +6,7 @@ from websocket._cookiejar import SimpleCookieJar
 test_cookiejar.py
 websocket - WebSocket client library for Python
 
-Copyright 2023 engn33r
+Copyright 2024 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
@@ -23,7 +23,7 @@ limitations under the License.
 
 
 class CookieJarTest(unittest.TestCase):
-    def testAdd(self):
+    def test_add(self):
         cookie_jar = SimpleCookieJar()
         cookie_jar.add("")
         self.assertFalse(
@@ -67,7 +67,7 @@ class CookieJarTest(unittest.TestCase):
         self.assertEqual(cookie_jar.get("xyz"), "e=f")
         self.assertEqual(cookie_jar.get("something"), "")
 
-    def testSet(self):
+    def test_set(self):
         cookie_jar = SimpleCookieJar()
         cookie_jar.set("a=b")
         self.assertFalse(
@@ -104,7 +104,7 @@ class CookieJarTest(unittest.TestCase):
         self.assertEqual(cookie_jar.get("xyz"), "e=f")
         self.assertEqual(cookie_jar.get("something"), "")
 
-    def testGet(self):
+    def test_get(self):
         cookie_jar = SimpleCookieJar()
         cookie_jar.set("a=b; c=d; domain=abc.com")
         self.assertEqual(cookie_jar.get("abc.com"), "a=b; c=d")
diff --git a/lib/websocket/tests/test_http.py b/lib/websocket/tests/test_http.py
index 0d6031a3..f495e635 100644
--- a/lib/websocket/tests/test_http.py
+++ b/lib/websocket/tests/test_http.py
@@ -7,7 +7,7 @@ import ssl
 import unittest
 
 import websocket
-import websocket as ws
+from websocket._exceptions import WebSocketProxyException, WebSocketException
 from websocket._http import (
     _get_addrinfo_list,
     _start_proxied_socket,
@@ -15,13 +15,14 @@ from websocket._http import (
     connect,
     proxy_info,
     read_headers,
+    HAVE_PYTHON_SOCKS,
 )
 
 """
 test_http.py
 websocket - WebSocket client library for Python
 
-Copyright 2023 engn33r
+Copyright 2024 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
@@ -93,20 +94,18 @@ class OptsList:
 
 
 class HttpTest(unittest.TestCase):
-    def testReadHeader(self):
-        status, header, status_message = read_headers(
-            HeaderSockMock("data/header01.txt")
-        )
+    def test_read_header(self):
+        status, header, _ = read_headers(HeaderSockMock("data/header01.txt"))
         self.assertEqual(status, 101)
         self.assertEqual(header["connection"], "Upgrade")
         # header02.txt is intentionally malformed
         self.assertRaises(
-            ws.WebSocketException, read_headers, HeaderSockMock("data/header02.txt")
+            WebSocketException, read_headers, HeaderSockMock("data/header02.txt")
         )
 
-    def testTunnel(self):
+    def test_tunnel(self):
         self.assertRaises(
-            ws.WebSocketProxyException,
+            WebSocketProxyException,
             _tunnel,
             HeaderSockMock("data/header01.txt"),
             "example.com",
@@ -114,7 +113,7 @@ class HttpTest(unittest.TestCase):
             ("username", "password"),
         )
         self.assertRaises(
-            ws.WebSocketProxyException,
+            WebSocketProxyException,
             _tunnel,
             HeaderSockMock("data/header02.txt"),
             "example.com",
@@ -123,9 +122,9 @@ class HttpTest(unittest.TestCase):
         )
 
     @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled")
-    def testConnect(self):
+    def test_connect(self):
         # Not currently testing an actual proxy connection, so just check whether proxy errors are raised. This requires internet for a DNS lookup
-        if ws._http.HAVE_PYTHON_SOCKS:
+        if HAVE_PYTHON_SOCKS:
             # Need this check, otherwise case where python_socks is not installed triggers
             # websocket._exceptions.WebSocketException: Python Socks is needed for SOCKS proxying but is not available
             self.assertRaises(
@@ -244,7 +243,7 @@ class HttpTest(unittest.TestCase):
     @unittest.skipUnless(
         TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled"
     )
-    def testProxyConnect(self):
+    def test_proxy_connect(self):
         ws = websocket.WebSocket()
         ws.connect(
             f"ws://127.0.0.1:{LOCAL_WS_SERVER_PORT}",
@@ -289,7 +288,7 @@ class HttpTest(unittest.TestCase):
         # TODO: Test SOCKS4 and SOCK5 proxies with unit tests
 
     @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled")
-    def testSSLopt(self):
+    def test_sslopt(self):
         ssloptions = {
             "check_hostname": False,
             "server_hostname": "ServerName",
@@ -315,7 +314,7 @@ class HttpTest(unittest.TestCase):
         ws_ssl2.connect("wss://api.bitfinex.com/ws/2")
         ws_ssl2.close
 
-    def testProxyInfo(self):
+    def test_proxy_info(self):
         self.assertEqual(
             proxy_info(
                 http_proxy_host="127.0.0.1", http_proxy_port="8080", proxy_type="http"
diff --git a/lib/websocket/tests/test_url.py b/lib/websocket/tests/test_url.py
index 792399eb..110fdfad 100644
--- a/lib/websocket/tests/test_url.py
+++ b/lib/websocket/tests/test_url.py
@@ -9,12 +9,13 @@ from websocket._url import (
     get_proxy_info,
     parse_url,
 )
+from websocket._exceptions import WebSocketProxyException
 
 """
 test_url.py
 websocket - WebSocket client library for Python
 
-Copyright 2023 engn33r
+Copyright 2024 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
@@ -36,7 +37,7 @@ class UrlTest(unittest.TestCase):
         self.assertTrue(_is_address_in_network("127.1.0.1", "127.0.0.0/8"))
         self.assertFalse(_is_address_in_network("127.1.0.1", "127.0.0.0/24"))
 
-    def testParseUrl(self):
+    def test_parse_url(self):
         p = parse_url("ws://www.example.com/r")
         self.assertEqual(p[0], "www.example.com")
         self.assertEqual(p[1], 80)
@@ -130,9 +131,13 @@ class IsNoProxyHostTest(unittest.TestCase):
         elif "no_proxy" in os.environ:
             del os.environ["no_proxy"]
 
-    def testMatchAll(self):
+    def test_match_all(self):
         self.assertTrue(_is_no_proxy_host("any.websocket.org", ["*"]))
         self.assertTrue(_is_no_proxy_host("192.168.0.1", ["*"]))
+        self.assertFalse(_is_no_proxy_host("192.168.0.1", ["192.168.1.1"]))
+        self.assertFalse(
+            _is_no_proxy_host("any.websocket.org", ["other.websocket.org"])
+        )
         self.assertTrue(
             _is_no_proxy_host("any.websocket.org", ["other.websocket.org", "*"])
         )
@@ -142,7 +147,7 @@ class IsNoProxyHostTest(unittest.TestCase):
         os.environ["no_proxy"] = "other.websocket.org, *"
         self.assertTrue(_is_no_proxy_host("any.websocket.org", None))
 
-    def testIpAddress(self):
+    def test_ip_address(self):
         self.assertTrue(_is_no_proxy_host("127.0.0.1", ["127.0.0.1"]))
         self.assertFalse(_is_no_proxy_host("127.0.0.2", ["127.0.0.1"]))
         self.assertTrue(
@@ -158,7 +163,7 @@ class IsNoProxyHostTest(unittest.TestCase):
         self.assertTrue(_is_no_proxy_host("127.0.0.1", None))
         self.assertFalse(_is_no_proxy_host("127.0.0.2", None))
 
-    def testIpAddressInRange(self):
+    def test_ip_address_in_range(self):
         self.assertTrue(_is_no_proxy_host("127.0.0.1", ["127.0.0.0/8"]))
         self.assertTrue(_is_no_proxy_host("127.0.0.2", ["127.0.0.0/8"]))
         self.assertFalse(_is_no_proxy_host("127.1.0.1", ["127.0.0.0/24"]))
@@ -168,7 +173,7 @@ class IsNoProxyHostTest(unittest.TestCase):
         os.environ["no_proxy"] = "127.0.0.0/24"
         self.assertFalse(_is_no_proxy_host("127.1.0.1", None))
 
-    def testHostnameMatch(self):
+    def test_hostname_match(self):
         self.assertTrue(_is_no_proxy_host("my.websocket.org", ["my.websocket.org"]))
         self.assertTrue(
             _is_no_proxy_host(
@@ -182,7 +187,7 @@ class IsNoProxyHostTest(unittest.TestCase):
         os.environ["no_proxy"] = "other.websocket.org, my.websocket.org"
         self.assertTrue(_is_no_proxy_host("my.websocket.org", None))
 
-    def testHostnameMatchDomain(self):
+    def test_hostname_match_domain(self):
         self.assertTrue(_is_no_proxy_host("any.websocket.org", [".websocket.org"]))
         self.assertTrue(_is_no_proxy_host("my.other.websocket.org", [".websocket.org"]))
         self.assertTrue(
@@ -227,10 +232,13 @@ class ProxyInfoTest(unittest.TestCase):
         elif "no_proxy" in os.environ:
             del os.environ["no_proxy"]
 
-    def testProxyFromArgs(self):
-        self.assertEqual(
-            get_proxy_info("echo.websocket.events", False, proxy_host="localhost"),
-            ("localhost", 0, None),
+    def test_proxy_from_args(self):
+        self.assertRaises(
+            WebSocketProxyException,
+            get_proxy_info,
+            "echo.websocket.events",
+            False,
+            proxy_host="localhost",
         )
         self.assertEqual(
             get_proxy_info(
@@ -238,10 +246,6 @@ class ProxyInfoTest(unittest.TestCase):
             ),
             ("localhost", 3128, None),
         )
-        self.assertEqual(
-            get_proxy_info("echo.websocket.events", True, proxy_host="localhost"),
-            ("localhost", 0, None),
-        )
         self.assertEqual(
             get_proxy_info(
                 "echo.websocket.events", True, proxy_host="localhost", proxy_port=3128
@@ -254,9 +258,10 @@ class ProxyInfoTest(unittest.TestCase):
                 "echo.websocket.events",
                 False,
                 proxy_host="localhost",
+                proxy_port=9001,
                 proxy_auth=("a", "b"),
             ),
-            ("localhost", 0, ("a", "b")),
+            ("localhost", 9001, ("a", "b")),
         )
         self.assertEqual(
             get_proxy_info(
@@ -273,9 +278,10 @@ class ProxyInfoTest(unittest.TestCase):
                 "echo.websocket.events",
                 True,
                 proxy_host="localhost",
+                proxy_port=8765,
                 proxy_auth=("a", "b"),
             ),
-            ("localhost", 0, ("a", "b")),
+            ("localhost", 8765, ("a", "b")),
         )
         self.assertEqual(
             get_proxy_info(
@@ -311,7 +317,18 @@ class ProxyInfoTest(unittest.TestCase):
             (None, 0, None),
         )
 
-    def testProxyFromEnv(self):
+        self.assertEqual(
+            get_proxy_info(
+                "echo.websocket.events",
+                True,
+                proxy_host="localhost",
+                proxy_port=3128,
+                no_proxy=[".websocket.events"],
+            ),
+            (None, 0, None),
+        )
+
+    def test_proxy_from_env(self):
         os.environ["http_proxy"] = "http://localhost/"
         self.assertEqual(
             get_proxy_info("echo.websocket.events", False), ("localhost", None, None)
diff --git a/lib/websocket/tests/test_websocket.py b/lib/websocket/tests/test_websocket.py
index 498def57..a1d7ad5b 100644
--- a/lib/websocket/tests/test_websocket.py
+++ b/lib/websocket/tests/test_websocket.py
@@ -7,6 +7,7 @@ import unittest
 from base64 import decodebytes as base64decode
 
 import websocket as ws
+from websocket._exceptions import WebSocketBadStatusException, WebSocketAddressException
 from websocket._handshake import _create_sec_websocket_key
 from websocket._handshake import _validate as _validate_header
 from websocket._http import read_headers
@@ -16,7 +17,7 @@ from websocket._utils import validate_utf8
 test_websocket.py
 websocket - WebSocket client library for Python
 
-Copyright 2023 engn33r
+Copyright 2024 engn33r
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
@@ -33,7 +34,6 @@ limitations under the License.
 
 try:
     import ssl
-    from ssl import SSLError
 except ImportError:
     # dummy class of SSLError for ssl none-support environment.
     class SSLError(Exception):
@@ -95,24 +95,24 @@ class WebSocketTest(unittest.TestCase):
     def tearDown(self):
         pass
 
-    def testDefaultTimeout(self):
+    def test_default_timeout(self):
         self.assertEqual(ws.getdefaulttimeout(), None)
         ws.setdefaulttimeout(10)
         self.assertEqual(ws.getdefaulttimeout(), 10)
         ws.setdefaulttimeout(None)
 
-    def testWSKey(self):
+    def test_ws_key(self):
         key = _create_sec_websocket_key()
         self.assertTrue(key != 24)
         self.assertTrue("¥n" not in key)
 
-    def testNonce(self):
+    def test_nonce(self):
         """WebSocket key should be a random 16-byte nonce."""
         key = _create_sec_websocket_key()
         nonce = base64decode(key.encode("utf-8"))
         self.assertEqual(16, len(nonce))
 
-    def testWsUtils(self):
+    def test_ws_utils(self):
         key = "c6b8hTg4EeGb2gQMztV1/g=="
         required_header = {
             "upgrade": "websocket",
@@ -157,16 +157,12 @@ class WebSocketTest(unittest.TestCase):
         # This case will print out a logging error using the error() function, but that is expected
         self.assertEqual(_validate_header(header, key, ["Sub1", "suB2"]), (False, None))
 
-    def testReadHeader(self):
-        status, header, status_message = read_headers(
-            HeaderSockMock("data/header01.txt")
-        )
+    def test_read_header(self):
+        status, header, _ = read_headers(HeaderSockMock("data/header01.txt"))
         self.assertEqual(status, 101)
         self.assertEqual(header["connection"], "Upgrade")
 
-        status, header, status_message = read_headers(
-            HeaderSockMock("data/header03.txt")
-        )
+        status, header, _ = read_headers(HeaderSockMock("data/header03.txt"))
         self.assertEqual(status, 101)
         self.assertEqual(header["connection"], "Upgrade, Keep-Alive")
 
@@ -175,7 +171,7 @@ class WebSocketTest(unittest.TestCase):
             ws.WebSocketException, read_headers, HeaderSockMock("data/header02.txt")
         )
 
-    def testSend(self):
+    def test_send(self):
         # TODO: add longer frame data
         sock = ws.WebSocket()
         sock.set_mask_key(create_mask_key)
@@ -194,7 +190,7 @@ class WebSocketTest(unittest.TestCase):
 
         self.assertEqual(sock.send_binary(b"1111111111101"), 19)
 
-    def testRecv(self):
+    def test_recv(self):
         # TODO: add longer frame data
         sock = ws.WebSocket()
         s = sock.sock = SockMock()
@@ -210,7 +206,7 @@ class WebSocketTest(unittest.TestCase):
         self.assertEqual(data, "Hello")
 
     @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled")
-    def testIter(self):
+    def test_iter(self):
         count = 2
         s = ws.create_connection("wss://api.bitfinex.com/ws/2")
         s.send('{"event": "subscribe", "channel": "ticker"}')
@@ -220,11 +216,11 @@ class WebSocketTest(unittest.TestCase):
                 break
 
     @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled")
-    def testNext(self):
+    def test_next(self):
         sock = ws.create_connection("wss://api.bitfinex.com/ws/2")
         self.assertEqual(str, type(next(sock)))
 
-    def testInternalRecvStrict(self):
+    def test_internal_recv_strict(self):
         sock = ws.WebSocket()
         s = sock.sock = SockMock()
         s.add_packet(b"foo")
@@ -241,7 +237,7 @@ class WebSocketTest(unittest.TestCase):
         with self.assertRaises(ws.WebSocketConnectionClosedException):
             sock.frame_buffer.recv_strict(1)
 
-    def testRecvTimeout(self):
+    def test_recv_timeout(self):
         sock = ws.WebSocket()
         s = sock.sock = SockMock()
         s.add_packet(b"\x81")
@@ -258,7 +254,7 @@ class WebSocketTest(unittest.TestCase):
         with self.assertRaises(ws.WebSocketConnectionClosedException):
             sock.recv()
 
-    def testRecvWithSimpleFragmentation(self):
+    def test_recv_with_simple_fragmentation(self):
         sock = ws.WebSocket()
         s = sock.sock = SockMock()
         # OPCODE=TEXT, FIN=0, MSG="Brevity is "
@@ -270,7 +266,7 @@ class WebSocketTest(unittest.TestCase):
         with self.assertRaises(ws.WebSocketConnectionClosedException):
             sock.recv()
 
-    def testRecvWithFireEventOfFragmentation(self):
+    def test_recv_with_fire_event_of_fragmentation(self):
         sock = ws.WebSocket(fire_cont_frame=True)
         s = sock.sock = SockMock()
         # OPCODE=TEXT, FIN=0, MSG="Brevity is "
@@ -296,7 +292,7 @@ class WebSocketTest(unittest.TestCase):
         with self.assertRaises(ws.WebSocketConnectionClosedException):
             sock.recv()
 
-    def testClose(self):
+    def test_close(self):
         sock = ws.WebSocket()
         sock.connected = True
         sock.close
@@ -308,14 +304,14 @@ class WebSocketTest(unittest.TestCase):
         sock.recv()
         self.assertEqual(sock.connected, False)
 
-    def testRecvContFragmentation(self):
+    def test_recv_cont_fragmentation(self):
         sock = ws.WebSocket()
         s = sock.sock = SockMock()
         # OPCODE=CONT, FIN=1, MSG="the soul of wit"
         s.add_packet(b"\x80\x8fabcd\x15\n\x06D\x12\r\x16\x08A\r\x05D\x16\x0b\x17")
         self.assertRaises(ws.WebSocketException, sock.recv)
 
-    def testRecvWithProlongedFragmentation(self):
+    def test_recv_with_prolonged_fragmentation(self):
         sock = ws.WebSocket()
         s = sock.sock = SockMock()
         # OPCODE=TEXT, FIN=0, MSG="Once more unto the breach, "
@@ -331,7 +327,7 @@ class WebSocketTest(unittest.TestCase):
         with self.assertRaises(ws.WebSocketConnectionClosedException):
             sock.recv()
 
-    def testRecvWithFragmentationAndControlFrame(self):
+    def test_recv_with_fragmentation_and_control_frame(self):
         sock = ws.WebSocket()
         sock.set_mask_key(create_mask_key)
         s = sock.sock = SockMock()
@@ -352,7 +348,7 @@ class WebSocketTest(unittest.TestCase):
     @unittest.skipUnless(
         TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled"
     )
-    def testWebSocket(self):
+    def test_websocket(self):
         s = ws.create_connection(f"ws://127.0.0.1:{LOCAL_WS_SERVER_PORT}")
         self.assertNotEqual(s, None)
         s.send("Hello, World")
@@ -369,7 +365,7 @@ class WebSocketTest(unittest.TestCase):
     @unittest.skipUnless(
         TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled"
     )
-    def testPingPong(self):
+    def test_ping_pong(self):
         s = ws.create_connection(f"ws://127.0.0.1:{LOCAL_WS_SERVER_PORT}")
         self.assertNotEqual(s, None)
         s.ping("Hello")
@@ -377,17 +373,13 @@ class WebSocketTest(unittest.TestCase):
         s.close()
 
     @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled")
-    def testSupportRedirect(self):
+    def test_support_redirect(self):
         s = ws.WebSocket()
-        self.assertRaises(
-            ws._exceptions.WebSocketBadStatusException, s.connect, "ws://google.com/"
-        )
+        self.assertRaises(WebSocketBadStatusException, s.connect, "ws://google.com/")
         # Need to find a URL that has a redirect code leading to a websocket
 
     @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled")
-    def testSecureWebSocket(self):
-        import ssl
-
+    def test_secure_websocket(self):
         s = ws.create_connection("wss://api.bitfinex.com/ws/2")
         self.assertNotEqual(s, None)
         self.assertTrue(isinstance(s.sock, ssl.SSLSocket))
@@ -401,7 +393,7 @@ class WebSocketTest(unittest.TestCase):
     @unittest.skipUnless(
         TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled"
     )
-    def testWebSocketWithCustomHeader(self):
+    def test_websocket_with_custom_header(self):
         s = ws.create_connection(
             f"ws://127.0.0.1:{LOCAL_WS_SERVER_PORT}",
             headers={"User-Agent": "PythonWebsocketClient"},
@@ -417,7 +409,7 @@ class WebSocketTest(unittest.TestCase):
     @unittest.skipUnless(
         TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled"
     )
-    def testAfterClose(self):
+    def test_after_close(self):
         s = ws.create_connection(f"ws://127.0.0.1:{LOCAL_WS_SERVER_PORT}")
         self.assertNotEqual(s, None)
         s.close()
@@ -429,7 +421,7 @@ class SockOptTest(unittest.TestCase):
     @unittest.skipUnless(
         TEST_WITH_LOCAL_SERVER, "Tests using local websocket server are disabled"
     )
-    def testSockOpt(self):
+    def test_sockopt(self):
         sockopt = ((socket.IPPROTO_TCP, socket.TCP_NODELAY, 1),)
         s = ws.create_connection(
             f"ws://127.0.0.1:{LOCAL_WS_SERVER_PORT}", sockopt=sockopt
@@ -441,7 +433,7 @@ class SockOptTest(unittest.TestCase):
 
 
 class UtilsTest(unittest.TestCase):
-    def testUtf8Validator(self):
+    def test_utf8_validator(self):
         state = validate_utf8(b"\xf0\x90\x80\x80")
         self.assertEqual(state, True)
         state = validate_utf8(
@@ -454,7 +446,7 @@ class UtilsTest(unittest.TestCase):
 
 class HandshakeTest(unittest.TestCase):
     @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled")
-    def test_http_SSL(self):
+    def test_http_ssl(self):
         websock1 = ws.WebSocket(
             sslopt={"cert_chain": ssl.get_default_verify_paths().capath},
             enable_multithread=False,
@@ -466,7 +458,7 @@ class HandshakeTest(unittest.TestCase):
         )
 
     @unittest.skipUnless(TEST_WITH_INTERNET, "Internet-requiring tests are disabled")
-    def testManualHeaders(self):
+    def test_manual_headers(self):
         websock3 = ws.WebSocket(
             sslopt={
                 "ca_certs": ssl.get_default_verify_paths().cafile,
@@ -474,7 +466,7 @@ class HandshakeTest(unittest.TestCase):
             }
         )
         self.assertRaises(
-            ws._exceptions.WebSocketBadStatusException,
+            WebSocketBadStatusException,
             websock3.connect,
             "wss://api.bitfinex.com/ws/2",
             cookie="chocolate",
@@ -490,16 +482,14 @@ class HandshakeTest(unittest.TestCase):
             },
         )
 
-    def testIPv6(self):
+    def test_ipv6(self):
         websock2 = ws.WebSocket()
         self.assertRaises(ValueError, websock2.connect, "2001:4860:4860::8888")
 
-    def testBadURLs(self):
+    def test_bad_urls(self):
         websock3 = ws.WebSocket()
         self.assertRaises(ValueError, websock3.connect, "ws//example.com")
-        self.assertRaises(
-            ws.WebSocketAddressException, websock3.connect, "ws://example"
-        )
+        self.assertRaises(WebSocketAddressException, websock3.connect, "ws://example")
         self.assertRaises(ValueError, websock3.connect, "example.com")
 
 
diff --git a/requirements.txt b/requirements.txt
index e630e23a..590f4fc1 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -45,7 +45,7 @@ tzdata==2024.1
 tzlocal==5.0.1
 urllib3<2
 webencodings==0.5.1
-websocket-client==1.7.0
+websocket-client==1.8.0
 xmltodict==0.13.0
 zipp==3.18.1
 

From 5e90f3bb31761b19c9763a24476b33e4d75497bc Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 9 May 2024 22:28:50 -0700
Subject: [PATCH 597/743] Bump paho-mqtt from 2.0.0 to 2.1.0 (#2316)

* Bump paho-mqtt from 2.0.0 to 2.1.0

Bumps [paho-mqtt](https://github.com/eclipse/paho.mqtt.python) from 2.0.0 to 2.1.0.
- [Release notes](https://github.com/eclipse/paho.mqtt.python/releases)
- [Changelog](https://github.com/eclipse/paho.mqtt.python/blob/master/ChangeLog.txt)
- [Commits](https://github.com/eclipse/paho.mqtt.python/compare/v2.0.0...v2.1.0)

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

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

* Update paho-mqtt==2.1.0

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/paho/mqtt/__init__.py    |  2 +-
 lib/paho/mqtt/client.py      | 59 +++++++++++++++++++++++-------------
 lib/paho/mqtt/publish.py     |  6 ++--
 lib/paho/mqtt/reasoncodes.py |  2 +-
 requirements.txt             |  2 +-
 5 files changed, 44 insertions(+), 27 deletions(-)

diff --git a/lib/paho/mqtt/__init__.py b/lib/paho/mqtt/__init__.py
index 19b6a4ab..377cecc7 100644
--- a/lib/paho/mqtt/__init__.py
+++ b/lib/paho/mqtt/__init__.py
@@ -1,4 +1,4 @@
-__version__ = "2.0.0"
+__version__ = "2.1.0"
 
 
 class MQTTException(Exception):
diff --git a/lib/paho/mqtt/client.py b/lib/paho/mqtt/client.py
index f5897328..4ccc8696 100644
--- a/lib/paho/mqtt/client.py
+++ b/lib/paho/mqtt/client.py
@@ -288,7 +288,7 @@ class WebsocketConnectionError(ConnectionError):
     pass
 
 
-def error_string(mqtt_errno: MQTTErrorCode) -> str:
+def error_string(mqtt_errno: MQTTErrorCode | int) -> str:
     """Return the error string associated with an mqtt error number."""
     if mqtt_errno == MQTT_ERR_SUCCESS:
         return "No error."
@@ -465,7 +465,7 @@ def _force_bytes(s: str | bytes) -> bytes:
     return s
 
 
-def _encode_payload(payload: str | bytes | bytearray | int | float | None) -> bytes:
+def _encode_payload(payload: str | bytes | bytearray | int | float | None) -> bytes|bytearray:
     if isinstance(payload, str):
         return payload.encode("utf-8")
 
@@ -648,7 +648,7 @@ class Client:
 
     :param CallbackAPIVersion callback_api_version: define the API version for user-callback (on_connect, on_publish,...).
         This field is required and it's recommended to use the latest version (CallbackAPIVersion.API_VERSION2).
-        See each callback for description of API for each version. The file migrations.md contains details on
+        See each callback for description of API for each version. The file docs/migrations.rst contains details on
         how to migrate between version.
 
     :param str client_id: the unique client id string used when connecting to the
@@ -682,6 +682,10 @@ class Client:
 
     :param transport: use "websockets" to use WebSockets as the transport
         mechanism. Set to "tcp" to use raw TCP, which is the default.
+        Use "unix" to use Unix sockets as the transport mechanism; note that
+        this option is only available on platforms that support Unix sockets,
+        and the "host" argument is interpreted as the path to the Unix socket
+        file in this case.
 
     :param bool manual_ack: normally, when a message is received, the library automatically
         acknowledges after on_message callback returns.  manual_ack=True allows the application to
@@ -728,19 +732,21 @@ class Client:
 
     def __init__(
         self,
-        callback_api_version: CallbackAPIVersion,
-        client_id: str = "",
+        callback_api_version: CallbackAPIVersion = CallbackAPIVersion.VERSION1,
+        client_id: str | None = "",
         clean_session: bool | None = None,
         userdata: Any = None,
-        protocol: int = MQTTv311,
-        transport: Literal["tcp", "websockets"] = "tcp",
+        protocol: MQTTProtocolVersion = MQTTv311,
+        transport: Literal["tcp", "websockets", "unix"] = "tcp",
         reconnect_on_failure: bool = True,
         manual_ack: bool = False,
     ) -> None:
         transport = transport.lower()  # type: ignore
-        if transport not in ("websockets", "tcp"):
+        if transport == "unix" and not hasattr(socket, "AF_UNIX"):
+            raise ValueError('"unix" transport not supported')
+        elif transport not in ("websockets", "tcp", "unix"):
             raise ValueError(
-                f'transport must be "websockets" or "tcp", not {transport}')
+                f'transport must be "websockets", "tcp" or "unix", not {transport}')
 
         self._manual_ack = manual_ack
         self._transport = transport
@@ -764,7 +770,7 @@ class Client:
             # Help user to migrate, it probably provided a client id
             # as first arguments
             raise ValueError(
-                "Unsupported callback API version: version 2.0 added a callback_api_version, see migrations.md for details"
+                "Unsupported callback API version: version 2.0 added a callback_api_version, see docs/migrations.rst for details"
             )
         if self._callback_api_version not in CallbackAPIVersion:
             raise ValueError("Unsupported callback API version")
@@ -931,7 +937,7 @@ class Client:
         self._keepalive = value
 
     @property
-    def transport(self) -> Literal["tcp", "websockets"]:
+    def transport(self) -> Literal["tcp", "websockets", "unix"]:
         """
         Transport method used for the connection ("tcp" or "websockets").
 
@@ -953,7 +959,7 @@ class Client:
 
         This property is read-only.
         """
-        return self.protocol
+        return self._protocol
 
     @property
     def connect_timeout(self) -> float:
@@ -2032,7 +2038,7 @@ class Client:
         return self._send_subscribe(False, topic_qos_list, properties)
 
     def unsubscribe(
-        self, topic: str, properties: Properties | None = None
+        self, topic: str | list[str], properties: Properties | None = None
     ) -> tuple[MQTTErrorCode, int | None]:
         """Unsubscribe the client from one or more topics.
 
@@ -2356,7 +2362,6 @@ class Client:
         self._thread_terminate = True
         if threading.current_thread() != self._thread:
             self._thread.join()
-            self._thread = None
 
         return MQTTErrorCode.MQTT_ERR_SUCCESS
 
@@ -2445,7 +2450,7 @@ class Client:
 
                 connect_callback(client, userdata, flags, rc)
 
-            * For MQTT it's v5.0::
+            * For MQTT v5.0 it's::
 
                 connect_callback(client, userdata, flags, reason_code, properties)
 
@@ -2732,7 +2737,7 @@ class Client:
 
                 disconnect_callback(client, userdata, rc)
 
-            * For MQTT it's v5.0::
+            * For MQTT v5.0 it's::
 
                 disconnect_callback(client, userdata, reason_code, properties)
 
@@ -3363,7 +3368,7 @@ class Client:
         self,
         mid: int,
         topic: bytes,
-        payload: bytes = b"",
+        payload: bytes|bytearray = b"",
         qos: int = 0,
         retain: bool = False,
         dup: bool = False,
@@ -3373,7 +3378,7 @@ class Client:
         # we assume that topic and payload are already properly encoded
         if not isinstance(topic, bytes):
             raise TypeError('topic must be bytes, not str')
-        if payload and not isinstance(payload, bytes):
+        if payload and not isinstance(payload, (bytes, bytearray)):
             raise TypeError('payload must be bytes if set')
 
         if self._sock is None:
@@ -3462,7 +3467,7 @@ class Client:
         return self._packet_queue(command, packet, 0, 0)
 
     def _send_connect(self, keepalive: int) -> MQTTErrorCode:
-        proto_ver = self._protocol
+        proto_ver = int(self._protocol)
         # hard-coded UTF-8 encoded string
         protocol = b"MQTT" if proto_ver >= MQTTv311 else b"MQIsdp"
 
@@ -4514,7 +4519,10 @@ class Client:
                         MQTT_LOG_ERR, 'Caught exception in on_connect_fail: %s', err)
 
     def _thread_main(self) -> None:
-        self.loop_forever(retry_first_connection=True)
+        try:
+            self.loop_forever(retry_first_connection=True)
+        finally:
+            self._thread = None
 
     def _reconnect_wait(self) -> None:
         # See reconnect_delay_set for details
@@ -4595,7 +4603,11 @@ class Client:
         return None
 
     def _create_socket(self) -> SocketLike:
-        sock = self._create_socket_connection()
+        if self._transport == "unix":
+            sock = self._create_unix_socket_connection()
+        else:
+            sock = self._create_socket_connection()
+
         if self._ssl:
             sock = self._ssl_wrap_socket(sock)
 
@@ -4612,6 +4624,11 @@ class Client:
 
         return sock
 
+    def _create_unix_socket_connection(self) -> _socket.socket:
+        unix_socket = socket.socket(socket.AF_UNIX, socket.SOCK_STREAM)
+        unix_socket.connect(self._host)
+        return unix_socket
+
     def _create_socket_connection(self) -> _socket.socket:
         proxy = self._get_proxy()
         addr = (self._host, self._port)
diff --git a/lib/paho/mqtt/publish.py b/lib/paho/mqtt/publish.py
index 42435156..333c190a 100644
--- a/lib/paho/mqtt/publish.py
+++ b/lib/paho/mqtt/publish.py
@@ -24,7 +24,7 @@ import collections
 from collections.abc import Iterable
 from typing import TYPE_CHECKING, Any, List, Tuple, Union
 
-from paho.mqtt.enums import CallbackAPIVersion
+from paho.mqtt.enums import CallbackAPIVersion, MQTTProtocolVersion
 from paho.mqtt.properties import Properties
 from paho.mqtt.reasoncodes import ReasonCode
 
@@ -112,7 +112,7 @@ def multiple(
     will: MessageDict | None = None,
     auth: AuthParameter | None = None,
     tls: TLSParameter | None = None,
-    protocol: int = paho.MQTTv311,
+    protocol: MQTTProtocolVersion = paho.MQTTv311,
     transport: Literal["tcp", "websockets"] = "tcp",
     proxy_args: Any | None = None,
 ) -> None:
@@ -240,7 +240,7 @@ def single(
     will: MessageDict | None = None,
     auth: AuthParameter | None = None,
     tls: TLSParameter | None = None,
-    protocol: int = paho.MQTTv311,
+    protocol: MQTTProtocolVersion = paho.MQTTv311,
     transport: Literal["tcp", "websockets"] = "tcp",
     proxy_args: Any | None = None,
 ) -> None:
diff --git a/lib/paho/mqtt/reasoncodes.py b/lib/paho/mqtt/reasoncodes.py
index 6b30cb83..243ac96f 100644
--- a/lib/paho/mqtt/reasoncodes.py
+++ b/lib/paho/mqtt/reasoncodes.py
@@ -30,7 +30,7 @@ class ReasonCode:
 
     """
 
-    def __init__(self, packetType, aName="Success", identifier=-1):
+    def __init__(self, packetType: int, aName: str ="Success", identifier: int =-1):
         """
         packetType: the type of the packet, such as PacketTypes.CONNECT that
             this reason code will be used with.  Some reason codes have different
diff --git a/requirements.txt b/requirements.txt
index 590f4fc1..f2d316c2 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -24,7 +24,7 @@ Mako==1.3.3
 MarkupSafe==2.1.5
 musicbrainzngs==0.7.1
 packaging==24.0
-paho-mqtt==2.0.0
+paho-mqtt==2.1.0
 platformdirs==4.2.1
 plexapi==4.15.12
 portend==3.2.0

From 96c20ad893386408ac67b816e22299fa47dbdad1 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 9 May 2024 22:31:06 -0700
Subject: [PATCH 598/743] Update cloudinary==1.40.0

---
 lib/cloudinary/__init__.py                               | 2 +-
 lib/cloudinary/api.py                                    | 4 +++-
 lib/cloudinary/static/cloudinary/js/jquery.cloudinary.js | 6 +++---
 3 files changed, 7 insertions(+), 5 deletions(-)

diff --git a/lib/cloudinary/__init__.py b/lib/cloudinary/__init__.py
index 7702ca9f..f9b79955 100644
--- a/lib/cloudinary/__init__.py
+++ b/lib/cloudinary/__init__.py
@@ -38,7 +38,7 @@ CL_BLANK = "data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAA
 URI_SCHEME = "cloudinary"
 API_VERSION = "v1_1"
 
-VERSION = "1.39.1"
+VERSION = "1.40.0"
 
 _USER_PLATFORM_DETAILS = "; ".join((platform(), "Python {}".format(python_version())))
 
diff --git a/lib/cloudinary/api.py b/lib/cloudinary/api.py
index cf5b2fca..0ae0fb33 100644
--- a/lib/cloudinary/api.py
+++ b/lib/cloudinary/api.py
@@ -565,7 +565,9 @@ def delete_folder(path, **options):
 
     :rtype: Response
     """
-    return call_api("delete", ["folders", path], {}, **options)
+
+    params = only(options, "skip_backup")
+    return call_api("delete", ["folders", path], params, **options)
 
 
 def restore(public_ids, **options):
diff --git a/lib/cloudinary/static/cloudinary/js/jquery.cloudinary.js b/lib/cloudinary/static/cloudinary/js/jquery.cloudinary.js
index 7b41a0f2..b61c442f 100644
--- a/lib/cloudinary/static/cloudinary/js/jquery.cloudinary.js
+++ b/lib/cloudinary/static/cloudinary/js/jquery.cloudinary.js
@@ -422,7 +422,7 @@ var slice = [].slice,
    * @returns {boolean} true if item is empty
    */
   isEmpty = function(item) {
-    return (item == null) || (jQuery.isArray(item) || Util.isString(item)) && item.length === 0 || (jQuery.isPlainObject(item) && jQuery.isEmptyObject(item));
+    return (item == null) || (Array.isArray(item) || Util.isString(item)) && item.length === 0 || (jQuery.isPlainObject(item) && jQuery.isEmptyObject(item));
   };
 
   /**
@@ -565,7 +565,7 @@ var slice = [].slice,
     setData: setData,
     width: width,
     isString: isString,
-    isArray: jQuery.isArray,
+    isArray: Array.isArray,
     isEmpty: isEmpty,
 
     /**
@@ -4728,7 +4728,7 @@ var slice = [].slice,
           return k + '=' + v;
         }).join('|');
       } else if (Util.isArray(value)) {
-        if (value.length > 0 && jQuery.isArray(value[0])) {
+        if (value.length > 0 && Array.isArray(value[0])) {
           upload_params[key] = jQuery.map(value, function(array_value) {
             return array_value.join(',');
           }).join('|');

From dd9d3b97a2bb47045d58470961ad85437d5bb45e Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 9 May 2024 22:41:07 -0700
Subject: [PATCH 599/743] Update workflow joncloud/makensis-action@v4.1

[skip ci]
---
 .github/workflows/publish-installers.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/publish-installers.yml b/.github/workflows/publish-installers.yml
index 7b79eea6..5e218a0c 100644
--- a/.github/workflows/publish-installers.yml
+++ b/.github/workflows/publish-installers.yml
@@ -75,7 +75,7 @@ jobs:
           pyinstaller -y ./package/Tautulli-${{ matrix.os }}.spec
 
       - name: Create Windows Installer
-        uses: joncloud/makensis-action@v4
+        uses: joncloud/makensis-action@v4.1
         if: matrix.os == 'windows'
         with:
           script-file: ./package/Tautulli.nsi

From af01b8c6cc5db1d27361f1ca52ac8d6d69fdce5e Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 9 May 2024 22:43:57 -0700
Subject: [PATCH 600/743] Fix appending user ids

---
 plexpy/users.py | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/plexpy/users.py b/plexpy/users.py
index 447f20a1..a62e49fd 100644
--- a/plexpy/users.py
+++ b/plexpy/users.py
@@ -50,13 +50,13 @@ def refresh_users():
         for item in result:
             if item.get('shared_libraries'):
                 item['shared_libraries'] = ';'.join(item['shared_libraries'])
-                # Only add user if libraries are shared
-                user_ids.add(helpers.cast_to_int(item['user_id']))
+                # Only append user if libraries are shared
+                user_ids.append(helpers.cast_to_int(item['user_id']))
             elif item.get('server_token'):
                 libs = libraries.Libraries().get_sections()
                 item['shared_libraries'] = ';'.join([str(l['section_id']) for l in libs])
-                # Only add user if libraries are shared
-                user_ids.add(helpers.cast_to_int(item['user_id']))
+                # Only append user if libraries are shared
+                user_ids.append(helpers.cast_to_int(item['user_id']))
 
             keys_dict = {"user_id": item.pop('user_id')}
 

From 1d77f32665372773df2e20b5e98411b24e4ca29b Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 11 May 2024 09:33:39 -0700
Subject: [PATCH 601/743] v2.14.1-beta

---
 CHANGELOG.md      | 16 ++++++++++++----
 plexpy/version.py |  2 +-
 2 files changed, 13 insertions(+), 5 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index f9a00257..48e02c60 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,13 @@
 # Changelog
 
+## v2.14.1-beta (2024-05-11)
+
+* UI:
+  * Fix: Users without access to Plex server not showing as inactive.
+* Other:
+  * Removed: Python 2 compatibility code. (#2098, #2226) (Thanks @zdimension)
+
+
 ## v2.14.0-beta (2024-04-19)
 
 * History:
@@ -9,9 +17,9 @@
   * Fix: Pushover configuration settings refreshing after entering a token.
   * Fix: Plex remote access down notifications not triggering.
   * Fix: Deleting all images from Cloudinary only deleting 1000 images.
-  * New: Added platform version and product version notification parameters.
-  * New: Added LAN streams and WAN streams notification parameters.
-  * New: Added Dolby Vision notification parameters.
+  * New: Added platform version and product version notification parameters. (#2244)
+  * New: Added LAN streams and WAN streams notification parameters. (#2276)
+  * New: Added Dolby Vision notification parameters. (#2240)
   * New: Added live TV channel notification parameters.
   * Change: Improved Tautulli Remote App notification encryption method.
     * Note: Requires Tautulli Remote App version 3.2.4.
@@ -26,7 +34,7 @@
   * Removed: Anonymous redirect settings. Links now use browser no-referrer policy instead.
 * API:
   * New: Added Dolby Vision info to the get_metadata API command.
-  * New: Added before and after parameters to the get_home_stats API command.
+  * New: Added before and after parameters to the get_home_stats API command. (#2231)
 * Packages:
   * New: Universal binary for macOS for Apple silicon.
   * New: Bump Snap package to core22.
diff --git a/plexpy/version.py b/plexpy/version.py
index 46b4390e..cf3944db 100644
--- a/plexpy/version.py
+++ b/plexpy/version.py
@@ -16,4 +16,4 @@
 #  along with Tautulli.  If not, see <http://www.gnu.org/licenses/>.
 
 PLEXPY_BRANCH = "beta"
-PLEXPY_RELEASE_VERSION = "v2.14.0-beta"
\ No newline at end of file
+PLEXPY_RELEASE_VERSION = "v2.14.1-beta"
\ No newline at end of file

From 5c115dec68effbaf8d89e8a951e8e5f22e6f7afa Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 11 May 2024 09:51:05 -0700
Subject: [PATCH 602/743] Fix uploading MacOS installer release asset

---
 .github/workflows/publish-installers.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/publish-installers.yml b/.github/workflows/publish-installers.yml
index 5e218a0c..e3f7fe85 100644
--- a/.github/workflows/publish-installers.yml
+++ b/.github/workflows/publish-installers.yml
@@ -143,7 +143,7 @@ jobs:
           prerelease: ${{ endsWith(steps.get_version.outputs.RELEASE_VERSION, '-beta') }}
           files: |
             Tautulli-windows-installer/Tautulli-windows-${{ steps.get_version.outputs.RELEASE_VERSION }}-x64.exe
-            Tautulli-macos-installer/Tautulli-macos-${{ steps.get_version.outputs.RELEASE_VERSION }}-x64.pkg
+            Tautulli-macos-installer/Tautulli-macos-${{ steps.get_version.outputs.RELEASE_VERSION }}-universal.pkg
 
   discord:
     name: Discord Notification

From ee0b4c0602c6f706bc88f78859e930ea540295ae Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 12 May 2024 22:38:05 -0700
Subject: [PATCH 603/743] Add artProvider and thumbProvider to exporter fields

---
 plexpy/exporter.py | 36 +++++++++++++++++++++++++++++++++---
 1 file changed, 33 insertions(+), 3 deletions(-)

diff --git a/plexpy/exporter.py b/plexpy/exporter.py
index ef6e0da7..8dcefbc1 100644
--- a/plexpy/exporter.py
+++ b/plexpy/exporter.py
@@ -148,6 +148,7 @@ class Export(object):
                 'art': None,
                 'artBlurHash': None,
                 'artFile': lambda o: self.get_image(o, 'art'),
+                'artProvider': lambda o: self.get_image_attr(o, 'art', 'provider'),
                 'audienceRating': None,
                 'audienceRatingImage': None,
                 'chapters': {
@@ -384,6 +385,7 @@ class Export(object):
                 'thumb': None,
                 'thumbBlurHash': None,
                 'thumbFile': lambda o: self.get_image(o, 'thumb'),
+                'thumbProvider': lambda o: self.get_image_attr(o, 'thumb', 'provider'),
                 'title': None,
                 'titleSort': None,
                 'type': None,
@@ -406,6 +408,7 @@ class Export(object):
                 'art': None,
                 'artBlurHash': None,
                 'artFile': lambda o: self.get_image(o, 'art'),
+                'artProvider': lambda o: self.get_image_attr(o, 'art', 'provider'),
                 'audienceRating': None,
                 'audienceRatingImage': None,
                 'audioLanguage': None,
@@ -472,6 +475,7 @@ class Export(object):
                 'thumb': None,
                 'thumbBlurHash': None,
                 'thumbFile': lambda o: self.get_image(o, 'thumb'),
+                'thumbProvider': lambda o: self.get_image_attr(o, 'thumb', 'provider'),
                 'title': None,
                 'titleSort': None,
                 'type': None,
@@ -491,6 +495,7 @@ class Export(object):
                 'art': None,
                 'artBlurHash': None,
                 'artFile': lambda o: self.get_image(o, 'art'),
+                'artProvider': lambda o: self.get_image_attr(o, 'art', 'provider'),
                 'audioLanguage': None,
                 'collections': {
                     'id': None,
@@ -534,6 +539,7 @@ class Export(object):
                 'thumb': None,
                 'thumbBlurHash': None,
                 'thumbFile': lambda o: self.get_image(o, 'thumb'),
+                'thumbProvider': lambda o: self.get_image_attr(o, 'thumb', 'provider'),
                 'title': None,
                 'titleSort': None,
                 'type': None,
@@ -552,6 +558,7 @@ class Export(object):
                 'art': None,
                 'artBlurHash': None,
                 'artFile': lambda o: self.get_image(o, 'art'),
+                'artProvider': lambda o: self.get_image_attr(o, 'art', 'provider'),
                 'audienceRating': None,
                 'audienceRatingImage': None,
                 'chapters': {
@@ -792,6 +799,7 @@ class Export(object):
                 'thumb': None,
                 'thumbBlurHash': None,
                 'thumbFile': lambda o: self.get_image(o, 'thumb'),
+                'thumbProvider': lambda o: self.get_image_attr(o, 'thumb', 'provider'),
                 'title': None,
                 'titleSort': None,
                 'type': None,
@@ -814,6 +822,7 @@ class Export(object):
                 'art': None,
                 'artBlurHash': None,
                 'artFile': lambda o: self.get_image(o, 'art'),
+                'artProvider': lambda o: self.get_image_attr(o, 'art', 'provider'),
                 'collections': {
                     'id': None,
                     'tag': None
@@ -866,6 +875,7 @@ class Export(object):
                 'thumb': None,
                 'thumbBlurHash': None,
                 'thumbFile': lambda o: self.get_image(o, 'thumb'),
+                'thumbProvider': lambda o: self.get_image_attr(o, 'thumb', 'provider'),
                 'title': None,
                 'titleSort': None,
                 'type': None,
@@ -882,6 +892,7 @@ class Export(object):
                 'art': None,
                 'artBlurHash': None,
                 'artFile': lambda o: self.get_image(o, 'art'),
+                'artProvider': lambda o: self.get_image_attr(o, 'art', 'provider'),
                 'collections': {
                     'id': None,
                     'tag': None
@@ -944,6 +955,7 @@ class Export(object):
                 'thumb': None,
                 'thumbBlurHash': None,
                 'thumbFile': lambda o: self.get_image(o, 'thumb'),
+                'thumbProvider': lambda o: self.get_image_attr(o, 'thumb', 'provider'),
                 'title': None,
                 'titleSort': None,
                 'type': None,
@@ -1223,6 +1235,7 @@ class Export(object):
                 'art': None,
                 'artBlurHash': None,
                 'artFile': lambda o: self.get_image(o, 'art'),
+                'artProvider': lambda o: self.get_image_attr(o, 'art', 'provider'),
                 'childCount': None,
                 'collectionFilterBasedOnUser': None,
                 'collectionMode': None,
@@ -1253,6 +1266,7 @@ class Export(object):
                 'thumb': None,
                 'thumbBlurHash': None,
                 'thumbFile': lambda o: self.get_image(o, 'thumb'),
+                'thumbProvider': lambda o: self.get_image_attr(o, 'thumb', 'provider'),
                 'title': None,
                 'titleSort': None,
                 'type': None,
@@ -2239,15 +2253,25 @@ class Export(object):
         media = helpers.get_attrs_to_dict(item, attrs)
         return any(vs.get('hdr') for p in media.get('parts', []) for vs in p.get('videoStreams', []))
 
+    def _get_cached_images(self, item, image):
+        if image == 'art':
+            if not hasattr(item, '_arts'):
+                item._arts = item.arts()
+            return getattr(item, '_arts', [])
+        else:
+            if not hasattr(item, '_posters'):
+                item._posters = item.posters()
+            return getattr(item, '_posters', [])
+
     def get_image(self, item, image):
         media_type = item.type
         rating_key = item.ratingKey
 
         export_image = True
         if self.thumb_level == 1 or self.art_level == 1:
-            posters = item.arts() if image == 'art' else item.posters()
-            export_image = any(poster.selected and poster.ratingKey.startswith('upload://')
-                               for poster in posters)
+            images = self._get_cached_images(item, image)
+            export_image = any(im.selected and im.ratingKey.startswith('upload://')
+                               for im in images)
         elif self.thumb_level == 2 or self.art_level == 2:
             export_image = any(field.locked and field.name == image
                                for field in item.fields)
@@ -2293,6 +2317,12 @@ class Export(object):
 
         return os.path.join(os.path.basename(dirpath), filename)
 
+    def get_image_attr(self, item, image, attr):
+        images = self._get_cached_images(item, image)
+        selected = next((im for im in images if im.selected), None)
+        if selected:
+            return getattr(selected, attr)
+
 
 class ExportObject(Export):
     def __init__(self, export, obj):

From 68bf1c70f71a9ee047ff69200b57f3db17a2cd87 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 13 May 2024 20:56:40 -0700
Subject: [PATCH 604/743] Overwrite image provider export field for uploaded
 assets

---
 plexpy/exporter.py | 44 +++++++++++++++++++++++---------------------
 1 file changed, 23 insertions(+), 21 deletions(-)

diff --git a/plexpy/exporter.py b/plexpy/exporter.py
index 8dcefbc1..08ea1176 100644
--- a/plexpy/exporter.py
+++ b/plexpy/exporter.py
@@ -148,7 +148,7 @@ class Export(object):
                 'art': None,
                 'artBlurHash': None,
                 'artFile': lambda o: self.get_image(o, 'art'),
-                'artProvider': lambda o: self.get_image_attr(o, 'art', 'provider'),
+                'artProvider': lambda o: self.get_image_provider(o, 'art'),
                 'audienceRating': None,
                 'audienceRatingImage': None,
                 'chapters': {
@@ -385,7 +385,7 @@ class Export(object):
                 'thumb': None,
                 'thumbBlurHash': None,
                 'thumbFile': lambda o: self.get_image(o, 'thumb'),
-                'thumbProvider': lambda o: self.get_image_attr(o, 'thumb', 'provider'),
+                'thumbProvider': lambda o: self.get_image_provider(o, 'thumb'),
                 'title': None,
                 'titleSort': None,
                 'type': None,
@@ -408,7 +408,7 @@ class Export(object):
                 'art': None,
                 'artBlurHash': None,
                 'artFile': lambda o: self.get_image(o, 'art'),
-                'artProvider': lambda o: self.get_image_attr(o, 'art', 'provider'),
+                'artProvider': lambda o: self.get_image_provider(o, 'art'),
                 'audienceRating': None,
                 'audienceRatingImage': None,
                 'audioLanguage': None,
@@ -475,7 +475,7 @@ class Export(object):
                 'thumb': None,
                 'thumbBlurHash': None,
                 'thumbFile': lambda o: self.get_image(o, 'thumb'),
-                'thumbProvider': lambda o: self.get_image_attr(o, 'thumb', 'provider'),
+                'thumbProvider': lambda o: self.get_image_provider(o, 'thumb'),
                 'title': None,
                 'titleSort': None,
                 'type': None,
@@ -495,7 +495,7 @@ class Export(object):
                 'art': None,
                 'artBlurHash': None,
                 'artFile': lambda o: self.get_image(o, 'art'),
-                'artProvider': lambda o: self.get_image_attr(o, 'art', 'provider'),
+                'artProvider': lambda o: self.get_image_provider(o, 'art'),
                 'audioLanguage': None,
                 'collections': {
                     'id': None,
@@ -539,7 +539,7 @@ class Export(object):
                 'thumb': None,
                 'thumbBlurHash': None,
                 'thumbFile': lambda o: self.get_image(o, 'thumb'),
-                'thumbProvider': lambda o: self.get_image_attr(o, 'thumb', 'provider'),
+                'thumbProvider': lambda o: self.get_image_provider(o, 'thumb'),
                 'title': None,
                 'titleSort': None,
                 'type': None,
@@ -558,7 +558,7 @@ class Export(object):
                 'art': None,
                 'artBlurHash': None,
                 'artFile': lambda o: self.get_image(o, 'art'),
-                'artProvider': lambda o: self.get_image_attr(o, 'art', 'provider'),
+                'artProvider': lambda o: self.get_image_provider(o, 'art'),
                 'audienceRating': None,
                 'audienceRatingImage': None,
                 'chapters': {
@@ -799,7 +799,7 @@ class Export(object):
                 'thumb': None,
                 'thumbBlurHash': None,
                 'thumbFile': lambda o: self.get_image(o, 'thumb'),
-                'thumbProvider': lambda o: self.get_image_attr(o, 'thumb', 'provider'),
+                'thumbProvider': lambda o: self.get_image_provider(o, 'thumb'),
                 'title': None,
                 'titleSort': None,
                 'type': None,
@@ -822,7 +822,7 @@ class Export(object):
                 'art': None,
                 'artBlurHash': None,
                 'artFile': lambda o: self.get_image(o, 'art'),
-                'artProvider': lambda o: self.get_image_attr(o, 'art', 'provider'),
+                'artProvider': lambda o: self.get_image_provider(o, 'art'),
                 'collections': {
                     'id': None,
                     'tag': None
@@ -875,7 +875,7 @@ class Export(object):
                 'thumb': None,
                 'thumbBlurHash': None,
                 'thumbFile': lambda o: self.get_image(o, 'thumb'),
-                'thumbProvider': lambda o: self.get_image_attr(o, 'thumb', 'provider'),
+                'thumbProvider': lambda o: self.get_image_provider(o, 'thumb'),
                 'title': None,
                 'titleSort': None,
                 'type': None,
@@ -892,7 +892,7 @@ class Export(object):
                 'art': None,
                 'artBlurHash': None,
                 'artFile': lambda o: self.get_image(o, 'art'),
-                'artProvider': lambda o: self.get_image_attr(o, 'art', 'provider'),
+                'artProvider': lambda o: self.get_image_provider(o, 'art'),
                 'collections': {
                     'id': None,
                     'tag': None
@@ -955,7 +955,7 @@ class Export(object):
                 'thumb': None,
                 'thumbBlurHash': None,
                 'thumbFile': lambda o: self.get_image(o, 'thumb'),
-                'thumbProvider': lambda o: self.get_image_attr(o, 'thumb', 'provider'),
+                'thumbProvider': lambda o: self.get_image_provider(o, 'thumb'),
                 'title': None,
                 'titleSort': None,
                 'type': None,
@@ -1235,7 +1235,7 @@ class Export(object):
                 'art': None,
                 'artBlurHash': None,
                 'artFile': lambda o: self.get_image(o, 'art'),
-                'artProvider': lambda o: self.get_image_attr(o, 'art', 'provider'),
+                'artProvider': lambda o: self.get_image_provider(o, 'art'),
                 'childCount': None,
                 'collectionFilterBasedOnUser': None,
                 'collectionMode': None,
@@ -1266,7 +1266,7 @@ class Export(object):
                 'thumb': None,
                 'thumbBlurHash': None,
                 'thumbFile': lambda o: self.get_image(o, 'thumb'),
-                'thumbProvider': lambda o: self.get_image_attr(o, 'thumb', 'provider'),
+                'thumbProvider': lambda o: self.get_image_provider(o, 'poster'),
                 'title': None,
                 'titleSort': None,
                 'type': None,
@@ -2262,6 +2262,10 @@ class Export(object):
             if not hasattr(item, '_posters'):
                 item._posters = item.posters()
             return getattr(item, '_posters', [])
+        
+    def _get_selected_image(self, item, image):
+        images = self._get_cached_images(item, image)
+        return next((im for im in images if im.selected), None)
 
     def get_image(self, item, image):
         media_type = item.type
@@ -2269,9 +2273,8 @@ class Export(object):
 
         export_image = True
         if self.thumb_level == 1 or self.art_level == 1:
-            images = self._get_cached_images(item, image)
-            export_image = any(im.selected and im.ratingKey.startswith('upload://')
-                               for im in images)
+            selected = self._get_selected_image(item, image)
+            export_image = selected and selected.ratingKey.startswith('upload://')
         elif self.thumb_level == 2 or self.art_level == 2:
             export_image = any(field.locked and field.name == image
                                for field in item.fields)
@@ -2317,11 +2320,10 @@ class Export(object):
 
         return os.path.join(os.path.basename(dirpath), filename)
 
-    def get_image_attr(self, item, image, attr):
-        images = self._get_cached_images(item, image)
-        selected = next((im for im in images if im.selected), None)
+    def get_image_provider(self, item, image):
+        selected = self._get_selected_image(item, image)
         if selected:
-            return getattr(selected, attr)
+            return 'upload' if selected.ratingKey.startswith('upload://') else selected.provider
 
 
 class ExportObject(Export):

From dc9e77811108353b847c8b2a15735aa2805be352 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 18 May 2024 11:17:01 -0700
Subject: [PATCH 605/743] Bump platformdirs from 4.2.1 to 4.2.2 (#2324)

* Bump platformdirs from 4.2.1 to 4.2.2

Bumps [platformdirs](https://github.com/platformdirs/platformdirs) from 4.2.1 to 4.2.2.
- [Release notes](https://github.com/platformdirs/platformdirs/releases)
- [Changelog](https://github.com/platformdirs/platformdirs/blob/main/CHANGES.rst)
- [Commits](https://github.com/platformdirs/platformdirs/compare/4.2.1...4.2.2)

---
updated-dependencies:
- dependency-name: platformdirs
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

* Update platformdirs==4.2.2

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/platformdirs/android.py | 45 +++++++++++++++++++++++++++++--------
 lib/platformdirs/version.py |  4 ++--
 requirements.txt            |  2 +-
 3 files changed, 39 insertions(+), 12 deletions(-)

diff --git a/lib/platformdirs/android.py b/lib/platformdirs/android.py
index fefafd32..afd3141c 100644
--- a/lib/platformdirs/android.py
+++ b/lib/platformdirs/android.py
@@ -6,7 +6,7 @@ import os
 import re
 import sys
 from functools import lru_cache
-from typing import cast
+from typing import TYPE_CHECKING, cast
 
 from .api import PlatformDirsABC
 
@@ -117,16 +117,33 @@ class Android(PlatformDirsABC):
 
 
 @lru_cache(maxsize=1)
-def _android_folder() -> str | None:
+def _android_folder() -> str | None:  # noqa: C901, PLR0912
     """:return: base folder for the Android OS or None if it cannot be found"""
-    try:
-        # First try to get a path to android app via pyjnius
-        from jnius import autoclass  # noqa: PLC0415
+    result: str | None = None
+    # type checker isn't happy with our "import android", just don't do this when type checking see
+    # https://stackoverflow.com/a/61394121
+    if not TYPE_CHECKING:
+        try:
+            # First try to get a path to android app using python4android (if available)...
+            from android import mActivity  # noqa: PLC0415
 
-        context = autoclass("android.content.Context")
-        result: str | None = context.getFilesDir().getParentFile().getAbsolutePath()
-    except Exception:  # noqa: BLE001
-        # if fails find an android folder looking a path on the sys.path
+            context = cast("android.content.Context", mActivity.getApplicationContext())  # noqa: F821
+            result = context.getFilesDir().getParentFile().getAbsolutePath()
+        except Exception:  # noqa: BLE001
+            result = None
+    if result is None:
+        try:
+            # ...and fall back to using plain pyjnius, if python4android isn't available or doesn't deliver any useful
+            # result...
+            from jnius import autoclass  # noqa: PLC0415
+
+            context = autoclass("android.content.Context")
+            result = context.getFilesDir().getParentFile().getAbsolutePath()
+        except Exception:  # noqa: BLE001
+            result = None
+    if result is None:
+        # and if that fails, too, find an android folder looking at path on the sys.path
+        # warning: only works for apps installed under /data, not adopted storage etc.
         pattern = re.compile(r"/data/(data|user/\d+)/(.+)/files")
         for path in sys.path:
             if pattern.match(path):
@@ -134,6 +151,16 @@ def _android_folder() -> str | None:
                 break
         else:
             result = None
+    if result is None:
+        # one last try: find an android folder looking at path on the sys.path taking adopted storage paths into
+        # account
+        pattern = re.compile(r"/mnt/expand/[a-fA-F0-9-]{36}/(data|user/\d+)/(.+)/files")
+        for path in sys.path:
+            if pattern.match(path):
+                result = path.split("/files")[0]
+                break
+        else:
+            result = None
     return result
 
 
diff --git a/lib/platformdirs/version.py b/lib/platformdirs/version.py
index c418cd0c..6483ddce 100644
--- a/lib/platformdirs/version.py
+++ b/lib/platformdirs/version.py
@@ -12,5 +12,5 @@ __version__: str
 __version_tuple__: VERSION_TUPLE
 version_tuple: VERSION_TUPLE
 
-__version__ = version = '4.2.1'
-__version_tuple__ = version_tuple = (4, 2, 1)
+__version__ = version = '4.2.2'
+__version_tuple__ = version_tuple = (4, 2, 2)
diff --git a/requirements.txt b/requirements.txt
index f2d316c2..4e95ca75 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -25,7 +25,7 @@ MarkupSafe==2.1.5
 musicbrainzngs==0.7.1
 packaging==24.0
 paho-mqtt==2.1.0
-platformdirs==4.2.1
+platformdirs==4.2.2
 plexapi==4.15.12
 portend==3.2.0
 profilehooks==1.12.0

From 37ffe68ce2e0790e25b20c36aff6ccd73312ef2e Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 18 May 2024 11:17:13 -0700
Subject: [PATCH 606/743] Bump mako from 1.3.3 to 1.3.5 (#2325)

* Bump mako from 1.3.3 to 1.3.5

Bumps [mako](https://github.com/sqlalchemy/mako) from 1.3.3 to 1.3.5.
- [Release notes](https://github.com/sqlalchemy/mako/releases)
- [Changelog](https://github.com/sqlalchemy/mako/blob/main/CHANGES)
- [Commits](https://github.com/sqlalchemy/mako/commits)

---
updated-dependencies:
- dependency-name: mako
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

* Update mako==1.3.5

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/mako/__init__.py | 2 +-
 lib/mako/pyparser.py | 4 ----
 requirements.txt     | 2 +-
 3 files changed, 2 insertions(+), 6 deletions(-)

diff --git a/lib/mako/__init__.py b/lib/mako/__init__.py
index 5811e68c..0ac3dd68 100644
--- a/lib/mako/__init__.py
+++ b/lib/mako/__init__.py
@@ -5,4 +5,4 @@
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
 
 
-__version__ = "1.3.3"
+__version__ = "1.3.5"
diff --git a/lib/mako/pyparser.py b/lib/mako/pyparser.py
index b25ef6e4..714e0043 100644
--- a/lib/mako/pyparser.py
+++ b/lib/mako/pyparser.py
@@ -92,8 +92,6 @@ class FindIdentifiers(_ast_util.NodeVisitor):
 
     def visit_ListComp(self, node):
         if self.in_function:
-            if not isinstance(node.elt, _ast.Name):
-                self.visit(node.elt)
             for comp in node.generators:
                 self.visit(comp.iter)
         else:
@@ -103,8 +101,6 @@ class FindIdentifiers(_ast_util.NodeVisitor):
 
     def visit_DictComp(self, node):
         if self.in_function:
-            if not isinstance(node.key, _ast.Name):
-                self.visit(node.elt)
             for comp in node.generators:
                 self.visit(comp.iter)
         else:
diff --git a/requirements.txt b/requirements.txt
index 4e95ca75..49e2246c 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -20,7 +20,7 @@ importlib-metadata==7.1.0
 importlib-resources==6.4.0
 git+https://github.com/Tautulli/ipwhois.git@master#egg=ipwhois
 IPy==1.01
-Mako==1.3.3
+Mako==1.3.5
 MarkupSafe==2.1.5
 musicbrainzngs==0.7.1
 packaging==24.0

From c505e26656cab55b70adec83fd3401f30a49127f Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 18 May 2024 11:17:26 -0700
Subject: [PATCH 607/743] Bump zipp from 3.18.1 to 3.18.2 (#2326)

* Bump zipp from 3.18.1 to 3.18.2

Bumps [zipp](https://github.com/jaraco/zipp) from 3.18.1 to 3.18.2.
- [Release notes](https://github.com/jaraco/zipp/releases)
- [Changelog](https://github.com/jaraco/zipp/blob/main/NEWS.rst)
- [Commits](https://github.com/jaraco/zipp/compare/v3.18.1...v3.18.2)

---
updated-dependencies:
- dependency-name: zipp
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

* Update zipp==3.18.2

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/zipp/__init__.py | 2 +-
 requirements.txt     | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/lib/zipp/__init__.py b/lib/zipp/__init__.py
index 6d05d9a0..df3293aa 100644
--- a/lib/zipp/__init__.py
+++ b/lib/zipp/__init__.py
@@ -263,7 +263,7 @@ class Path:
     >>> str(path.parent)
     'mem'
 
-    If the zipfile has no filename, such attribtues are not
+    If the zipfile has no filename, such attributes are not
     valid and accessing them will raise an Exception.
 
     >>> zf.filename = None
diff --git a/requirements.txt b/requirements.txt
index 49e2246c..3d624c3a 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -47,7 +47,7 @@ urllib3<2
 webencodings==0.5.1
 websocket-client==1.8.0
 xmltodict==0.13.0
-zipp==3.18.1
+zipp==3.18.2
 
 # configobj==5.1.0
 # sgmllib3k==1.0.0

From 8419eee4b207fa8585c1925e761a3c5b446963d0 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 17 May 2024 15:41:59 -0700
Subject: [PATCH 608/743] Catch exception when decoding server response message

---
 plexpy/request.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/plexpy/request.py b/plexpy/request.py
index c2f0967f..82c8cee0 100644
--- a/plexpy/request.py
+++ b/plexpy/request.py
@@ -308,7 +308,10 @@ def server_message(response, return_msg=False):
         message = response.content.strip()
 
     if message:
-        message = str(message, 'utf-8', 'replace')
+        try:
+            message = message.decode('utf-8', errors='replace')
+        except (UnicodeDecodeError, AttributeError):
+            pass
 
         # Truncate message if it is too long.
         if len(message) > 150:

From 8396a04ce86e8e1974c0eda0fc417b30c2cedfb5 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 18 May 2024 13:52:52 -0700
Subject: [PATCH 609/743] Update plexapi==4.15.13

---
 lib/plexapi/audio.py      | 10 ++++++++
 lib/plexapi/base.py       |  2 +-
 lib/plexapi/collection.py |  4 +++
 lib/plexapi/const.py      |  2 +-
 lib/plexapi/library.py    |  4 +--
 lib/plexapi/mixins.py     | 52 ++++++++++++++++++++++++++++++++-------
 lib/plexapi/myplex.py     |  2 +-
 lib/plexapi/playlist.py   | 27 +++++++++++---------
 lib/plexapi/video.py      |  4 +++
 requirements.txt          |  2 +-
 10 files changed, 83 insertions(+), 26 deletions(-)

diff --git a/lib/plexapi/audio.py b/lib/plexapi/audio.py
index 0eb397cc..8f84f3be 100644
--- a/lib/plexapi/audio.py
+++ b/lib/plexapi/audio.py
@@ -181,6 +181,7 @@ class Artist(
             TYPE (str): 'artist'
             albumSort (int): Setting that indicates how albums are sorted for the artist
                 (-1 = Library default, 0 = Newest first, 1 = Oldest first, 2 = By name).
+            audienceRating (float): Audience rating.
             collections (List<:class:`~plexapi.media.Collection`>): List of collection objects.
             countries (List<:class:`~plexapi.media.Country`>): List country objects.
             genres (List<:class:`~plexapi.media.Genre`>): List of genre objects.
@@ -188,6 +189,7 @@ class Artist(
             key (str): API URL (/library/metadata/<ratingkey>).
             labels (List<:class:`~plexapi.media.Label`>): List of label objects.
             locations (List<str>): List of folder paths where the artist is found on disk.
+            rating (float): Artist rating (7.9; 9.8; 8.1).
             similar (List<:class:`~plexapi.media.Similar`>): List of similar objects.
             styles (List<:class:`~plexapi.media.Style`>): List of style objects.
             theme (str): URL to theme resource (/library/metadata/<ratingkey>/theme/<themeid>).
@@ -199,6 +201,7 @@ class Artist(
         """ Load attribute values from Plex XML response. """
         Audio._loadData(self, data)
         self.albumSort = utils.cast(int, data.attrib.get('albumSort', '-1'))
+        self.audienceRating = utils.cast(float, data.attrib.get('audienceRating'))
         self.collections = self.findItems(data, media.Collection)
         self.countries = self.findItems(data, media.Country)
         self.genres = self.findItems(data, media.Genre)
@@ -206,6 +209,7 @@ class Artist(
         self.key = self.key.replace('/children', '')  # FIX_BUG_50
         self.labels = self.findItems(data, media.Label)
         self.locations = self.listAttrs(data, 'path', etag='Location')
+        self.rating = utils.cast(float, data.attrib.get('rating'))
         self.similar = self.findItems(data, media.Similar)
         self.styles = self.findItems(data, media.Style)
         self.theme = data.attrib.get('theme')
@@ -301,6 +305,7 @@ class Album(
         Attributes:
             TAG (str): 'Directory'
             TYPE (str): 'album'
+            audienceRating (float): Audience rating.
             collections (List<:class:`~plexapi.media.Collection`>): List of collection objects.
             formats (List<:class:`~plexapi.media.Format`>): List of format objects.
             genres (List<:class:`~plexapi.media.Genre`>): List of genre objects.
@@ -329,6 +334,7 @@ class Album(
     def _loadData(self, data):
         """ Load attribute values from Plex XML response. """
         Audio._loadData(self, data)
+        self.audienceRating = utils.cast(float, data.attrib.get('audienceRating'))
         self.collections = self.findItems(data, media.Collection)
         self.formats = self.findItems(data, media.Format)
         self.genres = self.findItems(data, media.Genre)
@@ -426,6 +432,7 @@ class Track(
         Attributes:
             TAG (str): 'Directory'
             TYPE (str): 'track'
+            audienceRating (float): Audience rating.
             chapters (List<:class:`~plexapi.media.Chapter`>): List of Chapter objects.
             chapterSource (str): Unknown
             collections (List<:class:`~plexapi.media.Collection`>): List of collection objects.
@@ -451,6 +458,7 @@ class Track(
             parentThumb (str): URL to album thumbnail image (/library/metadata/<parentRatingKey>/thumb/<thumbid>).
             parentTitle (str): Name of the album for the track.
             primaryExtraKey (str) API URL for the primary extra for the track.
+            rating (float): Track rating (7.9; 9.8; 8.1).
             ratingCount (int): Number of listeners who have scrobbled this track, as reported by Last.fm.
             skipCount (int): Number of times the track has been skipped.
             sourceURI (str): Remote server URI (server://<machineIdentifier>/com.plexapp.plugins.library)
@@ -465,6 +473,7 @@ class Track(
         """ Load attribute values from Plex XML response. """
         Audio._loadData(self, data)
         Playable._loadData(self, data)
+        self.audienceRating = utils.cast(float, data.attrib.get('audienceRating'))
         self.chapters = self.findItems(data, media.Chapter)
         self.chapterSource = data.attrib.get('chapterSource')
         self.collections = self.findItems(data, media.Collection)
@@ -488,6 +497,7 @@ class Track(
         self.parentThumb = data.attrib.get('parentThumb')
         self.parentTitle = data.attrib.get('parentTitle')
         self.primaryExtraKey = data.attrib.get('primaryExtraKey')
+        self.rating = utils.cast(float, data.attrib.get('rating'))
         self.ratingCount = utils.cast(int, data.attrib.get('ratingCount'))
         self.skipCount = utils.cast(int, data.attrib.get('skipCount'))
         self.sourceURI = data.attrib.get('source')  # remote playlist item
diff --git a/lib/plexapi/base.py b/lib/plexapi/base.py
index c08334f9..9c735373 100644
--- a/lib/plexapi/base.py
+++ b/lib/plexapi/base.py
@@ -253,7 +253,7 @@ class PlexObject:
 
                     fetchItem(ekey, viewCount__gte=0)
                     fetchItem(ekey, Media__container__in=["mp4", "mkv"])
-                    fetchItem(ekey, guid__regex=r"com\\.plexapp\\.agents\\.(imdb|themoviedb)://|tt\d+")
+                    fetchItem(ekey, guid__regex=r"com\\.plexapp\\.agents\\.(imdb|themoviedb)://|tt\\d+")
                     fetchItem(ekey, guid__id__regex=r"(imdb|tmdb|tvdb)://")
                     fetchItem(ekey, Media__Part__file__startswith="D:\\Movies")
 
diff --git a/lib/plexapi/collection.py b/lib/plexapi/collection.py
index 5f591a4a..d71ddf2f 100644
--- a/lib/plexapi/collection.py
+++ b/lib/plexapi/collection.py
@@ -29,6 +29,7 @@ class Collection(
             addedAt (datetime): Datetime the collection was added to the library.
             art (str): URL to artwork image (/library/metadata/<ratingKey>/art/<artid>).
             artBlurHash (str): BlurHash string for artwork image.
+            audienceRating (float): Audience rating.
             childCount (int): Number of items in the collection.
             collectionFilterBasedOnUser (int): Which user's activity is used for the collection filtering.
             collectionMode (int): How the items in the collection are displayed.
@@ -47,6 +48,7 @@ class Collection(
             librarySectionTitle (str): :class:`~plexapi.library.LibrarySection` title.
             maxYear (int): Maximum year for the items in the collection.
             minYear (int): Minimum year for the items in the collection.
+            rating (float): Collection rating (7.9; 9.8; 8.1).
             ratingCount (int): The number of ratings.
             ratingKey (int): Unique key identifying the collection.
             smart (bool): True if the collection is a smart collection.
@@ -69,6 +71,7 @@ class Collection(
         self.addedAt = utils.toDatetime(data.attrib.get('addedAt'))
         self.art = data.attrib.get('art')
         self.artBlurHash = data.attrib.get('artBlurHash')
+        self.audienceRating = utils.cast(float, data.attrib.get('audienceRating'))
         self.childCount = utils.cast(int, data.attrib.get('childCount'))
         self.collectionFilterBasedOnUser = utils.cast(int, data.attrib.get('collectionFilterBasedOnUser', '0'))
         self.collectionMode = utils.cast(int, data.attrib.get('collectionMode', '-1'))
@@ -87,6 +90,7 @@ class Collection(
         self.librarySectionTitle = data.attrib.get('librarySectionTitle')
         self.maxYear = utils.cast(int, data.attrib.get('maxYear'))
         self.minYear = utils.cast(int, data.attrib.get('minYear'))
+        self.rating = utils.cast(float, data.attrib.get('rating'))
         self.ratingCount = utils.cast(int, data.attrib.get('ratingCount'))
         self.ratingKey = utils.cast(int, data.attrib.get('ratingKey'))
         self.smart = utils.cast(bool, data.attrib.get('smart', '0'))
diff --git a/lib/plexapi/const.py b/lib/plexapi/const.py
index c987e305..7568344e 100644
--- a/lib/plexapi/const.py
+++ b/lib/plexapi/const.py
@@ -4,6 +4,6 @@
 # Library version
 MAJOR_VERSION = 4
 MINOR_VERSION = 15
-PATCH_VERSION = 12
+PATCH_VERSION = 13
 __short_version__ = f"{MAJOR_VERSION}.{MINOR_VERSION}"
 __version__ = f"{__short_version__}.{PATCH_VERSION}"
diff --git a/lib/plexapi/library.py b/lib/plexapi/library.py
index 662b5462..f1bf5375 100644
--- a/lib/plexapi/library.py
+++ b/lib/plexapi/library.py
@@ -226,7 +226,7 @@ class Library(PlexObject):
             section.deleteMediaPreviews()
         return self
 
-    def add(self, name='', type='', agent='', scanner='', location='', language='en', *args, **kwargs):
+    def add(self, name='', type='', agent='', scanner='', location='', language='en-US', *args, **kwargs):
         """ Simplified add for the most common options.
 
             Parameters:
@@ -234,7 +234,7 @@ class Library(PlexObject):
                 agent (str): Example com.plexapp.agents.imdb
                 type (str): movie, show, # check me
                 location (str or list): /path/to/files, ["/path/to/files", "/path/to/morefiles"]
-                language (str): Two letter language fx en
+                language (str): Four letter language code (e.g. en-US)
                 kwargs (dict): Advanced options should be passed as a dict. where the id is the key.
 
             **Photo Preferences**
diff --git a/lib/plexapi/mixins.py b/lib/plexapi/mixins.py
index 60c24e26..8571ba63 100644
--- a/lib/plexapi/mixins.py
+++ b/lib/plexapi/mixins.py
@@ -567,6 +567,19 @@ class AddedAtMixin(EditFieldMixin):
         return self.editField('addedAt', addedAt, locked=locked)
 
 
+class AudienceRatingMixin(EditFieldMixin):
+    """ Mixin for Plex objects that can have an audience rating. """
+
+    def editAudienceRating(self, audienceRating, locked=True):
+        """ Edit the audience rating.
+
+            Parameters:
+                audienceRating (float): The new value.
+                locked (bool): True (default) to lock the field, False to unlock the field.
+        """
+        return self.editField('audienceRating', audienceRating, locked=locked)
+
+
 class ContentRatingMixin(EditFieldMixin):
     """ Mixin for Plex objects that can have a content rating. """
 
@@ -580,6 +593,19 @@ class ContentRatingMixin(EditFieldMixin):
         return self.editField('contentRating', contentRating, locked=locked)
 
 
+class CriticRatingMixin(EditFieldMixin):
+    """ Mixin for Plex objects that can have a critic rating. """
+
+    def editCriticRating(self, criticRating, locked=True):
+        """ Edit the critic rating.
+
+            Parameters:
+                criticRating (float): The new value.
+                locked (bool): True (default) to lock the field, False to unlock the field.
+        """
+        return self.editField('rating', criticRating, locked=locked)
+
+
 class EditionTitleMixin(EditFieldMixin):
     """ Mixin for Plex objects that can have an edition title. """
 
@@ -751,7 +777,7 @@ class UserRatingMixin(EditFieldMixin):
         """ Edit the user rating.
 
             Parameters:
-                userRating (int): The new value.
+                userRating (float): The new value.
                 locked (bool): True (default) to lock the field, False to unlock the field.
         """
         return self.editField('userRating', userRating, locked=locked)
@@ -1145,7 +1171,8 @@ class WatchlistMixin:
 
 class MovieEditMixins(
     ArtLockMixin, PosterLockMixin, ThemeLockMixin,
-    AddedAtMixin, ContentRatingMixin, EditionTitleMixin, OriginallyAvailableMixin, OriginalTitleMixin, SortTitleMixin,
+    AddedAtMixin, AudienceRatingMixin, ContentRatingMixin, CriticRatingMixin, EditionTitleMixin,
+    OriginallyAvailableMixin, OriginalTitleMixin, SortTitleMixin,
     StudioMixin, SummaryMixin, TaglineMixin, TitleMixin, UserRatingMixin,
     CollectionMixin, CountryMixin, DirectorMixin, GenreMixin, LabelMixin, ProducerMixin, WriterMixin
 ):
@@ -1154,7 +1181,8 @@ class MovieEditMixins(
 
 class ShowEditMixins(
     ArtLockMixin, PosterLockMixin, ThemeLockMixin,
-    AddedAtMixin, ContentRatingMixin, OriginallyAvailableMixin, OriginalTitleMixin, SortTitleMixin, StudioMixin,
+    AddedAtMixin, AudienceRatingMixin, ContentRatingMixin, CriticRatingMixin,
+    OriginallyAvailableMixin, OriginalTitleMixin, SortTitleMixin, StudioMixin,
     SummaryMixin, TaglineMixin, TitleMixin, UserRatingMixin,
     CollectionMixin, GenreMixin, LabelMixin,
 ):
@@ -1163,7 +1191,8 @@ class ShowEditMixins(
 
 class SeasonEditMixins(
     ArtLockMixin, PosterLockMixin, ThemeLockMixin,
-    AddedAtMixin, SummaryMixin, TitleMixin, UserRatingMixin,
+    AddedAtMixin, AudienceRatingMixin, CriticRatingMixin,
+    SummaryMixin, TitleMixin, UserRatingMixin,
     CollectionMixin, LabelMixin
 ):
     pass
@@ -1171,7 +1200,8 @@ class SeasonEditMixins(
 
 class EpisodeEditMixins(
     ArtLockMixin, PosterLockMixin, ThemeLockMixin,
-    AddedAtMixin, ContentRatingMixin, OriginallyAvailableMixin, SortTitleMixin, SummaryMixin, TitleMixin, UserRatingMixin,
+    AddedAtMixin, AudienceRatingMixin, ContentRatingMixin, CriticRatingMixin,
+    OriginallyAvailableMixin, SortTitleMixin, SummaryMixin, TitleMixin, UserRatingMixin,
     CollectionMixin, DirectorMixin, LabelMixin, WriterMixin
 ):
     pass
@@ -1179,7 +1209,8 @@ class EpisodeEditMixins(
 
 class ArtistEditMixins(
     ArtLockMixin, PosterLockMixin, ThemeLockMixin,
-    AddedAtMixin, SortTitleMixin, SummaryMixin, TitleMixin, UserRatingMixin,
+    AddedAtMixin, AudienceRatingMixin, CriticRatingMixin,
+    SortTitleMixin, SummaryMixin, TitleMixin, UserRatingMixin,
     CollectionMixin, CountryMixin, GenreMixin, LabelMixin, MoodMixin, SimilarArtistMixin, StyleMixin
 ):
     pass
@@ -1187,7 +1218,8 @@ class ArtistEditMixins(
 
 class AlbumEditMixins(
     ArtLockMixin, PosterLockMixin, ThemeLockMixin,
-    AddedAtMixin, OriginallyAvailableMixin, SortTitleMixin, StudioMixin, SummaryMixin, TitleMixin, UserRatingMixin,
+    AddedAtMixin, AudienceRatingMixin, CriticRatingMixin,
+    OriginallyAvailableMixin, SortTitleMixin, StudioMixin, SummaryMixin, TitleMixin, UserRatingMixin,
     CollectionMixin, GenreMixin, LabelMixin, MoodMixin, StyleMixin
 ):
     pass
@@ -1195,7 +1227,8 @@ class AlbumEditMixins(
 
 class TrackEditMixins(
     ArtLockMixin, PosterLockMixin, ThemeLockMixin,
-    AddedAtMixin, TitleMixin, TrackArtistMixin, TrackNumberMixin, TrackDiscNumberMixin, UserRatingMixin,
+    AddedAtMixin, AudienceRatingMixin, CriticRatingMixin,
+    TitleMixin, TrackArtistMixin, TrackNumberMixin, TrackDiscNumberMixin, UserRatingMixin,
     CollectionMixin, GenreMixin, LabelMixin, MoodMixin
 ):
     pass
@@ -1218,7 +1251,8 @@ class PhotoEditMixins(
 
 class CollectionEditMixins(
     ArtLockMixin, PosterLockMixin, ThemeLockMixin,
-    AddedAtMixin, ContentRatingMixin, SortTitleMixin, SummaryMixin, TitleMixin, UserRatingMixin,
+    AddedAtMixin, AudienceRatingMixin, ContentRatingMixin, CriticRatingMixin,
+    SortTitleMixin, SummaryMixin, TitleMixin, UserRatingMixin,
     LabelMixin
 ):
     pass
diff --git a/lib/plexapi/myplex.py b/lib/plexapi/myplex.py
index 8d697924..740b2398 100644
--- a/lib/plexapi/myplex.py
+++ b/lib/plexapi/myplex.py
@@ -99,7 +99,7 @@ class MyPlexAccount(PlexObject):
     EXISTINGUSER = 'https://plex.tv/api/home/users?invitedEmail={username}'                     # post with data
     FRIENDSERVERS = 'https://plex.tv/api/servers/{machineId}/shared_servers/{serverId}'         # put with data
     PLEXSERVERS = 'https://plex.tv/api/servers/{machineId}'                                     # get
-    FRIENDUPDATE = 'https://plex.tv/api/friends/{userId}'                                       # put with args, delete
+    FRIENDUPDATE = 'https://plex.tv/api/v2/sharings/{userId}'                                   # put with args, delete
     HOMEUSER = 'https://plex.tv/api/home/users/{userId}'                                        # delete, put
     MANAGEDHOMEUSER = 'https://plex.tv/api/v2/home/users/restricted/{userId}'                   # put
     SIGNIN = 'https://plex.tv/api/v2/users/signin'                                              # post with auth
diff --git a/lib/plexapi/playlist.py b/lib/plexapi/playlist.py
index a50b6200..dda3bdf5 100644
--- a/lib/plexapi/playlist.py
+++ b/lib/plexapi/playlist.py
@@ -1,5 +1,6 @@
 # -*- coding: utf-8 -*-
 import re
+from itertools import groupby
 from pathlib import Path
 from urllib.parse import quote_plus, unquote
 
@@ -212,19 +213,23 @@ class Playlist(
         if items and not isinstance(items, (list, tuple)):
             items = [items]
 
-        ratingKeys = []
-        for item in items:
-            if item.listType != self.playlistType:  # pragma: no cover
-                raise BadRequest(f'Can not mix media types when building a playlist: '
-                                 f'{self.playlistType} and {item.listType}')
-            ratingKeys.append(str(item.ratingKey))
+        # Group items by server to maintain order when adding items from multiple servers
+        for server, _items in groupby(items, key=lambda item: item._server):
 
-        ratingKeys = ','.join(ratingKeys)
-        uri = f'{self._server._uriRoot()}/library/metadata/{ratingKeys}'
+            ratingKeys = []
+            for item in _items:
+                if item.listType != self.playlistType:  # pragma: no cover
+                    raise BadRequest(f'Can not mix media types when building a playlist: '
+                                     f'{self.playlistType} and {item.listType}')
+                ratingKeys.append(str(item.ratingKey))
+
+            ratingKeys = ','.join(ratingKeys)
+            uri = f'{server._uriRoot()}/library/metadata/{ratingKeys}'
+
+            args = {'uri': uri}
+            key = f"{self.key}/items{utils.joinArgs(args)}"
+            self._server.query(key, method=self._server._session.put)
 
-        args = {'uri': uri}
-        key = f"{self.key}/items{utils.joinArgs(args)}"
-        self._server.query(key, method=self._server._session.put)
         return self
 
     @deprecated('use "removeItems" instead')
diff --git a/lib/plexapi/video.py b/lib/plexapi/video.py
index 727ba0f8..609f57f6 100644
--- a/lib/plexapi/video.py
+++ b/lib/plexapi/video.py
@@ -713,6 +713,7 @@ class Season(
         Attributes:
             TAG (str): 'Directory'
             TYPE (str): 'season'
+            audienceRating (float): Audience rating.
             audioLanguage (str): Setting that indicates the preferred audio language.
             collections (List<:class:`~plexapi.media.Collection`>): List of collection objects.
             guids (List<:class:`~plexapi.media.Guid`>): List of guid objects.
@@ -729,6 +730,7 @@ class Season(
             parentTheme (str): URL to show theme resource (/library/metadata/<parentRatingkey>/theme/<themeid>).
             parentThumb (str): URL to show thumbnail image (/library/metadata/<parentRatingKey>/thumb/<thumbid>).
             parentTitle (str): Name of the show for the season.
+            rating (float): Season rating (7.9; 9.8; 8.1).
             ratings (List<:class:`~plexapi.media.Rating`>): List of rating objects.
             subtitleLanguage (str): Setting that indicates the preferred subtitle language.
             subtitleMode (int): Setting that indicates the auto-select subtitle mode.
@@ -743,6 +745,7 @@ class Season(
     def _loadData(self, data):
         """ Load attribute values from Plex XML response. """
         Video._loadData(self, data)
+        self.audienceRating = utils.cast(float, data.attrib.get('audienceRating'))
         self.audioLanguage = data.attrib.get('audioLanguage', '')
         self.collections = self.findItems(data, media.Collection)
         self.guids = self.findItems(data, media.Guid)
@@ -759,6 +762,7 @@ class Season(
         self.parentTheme = data.attrib.get('parentTheme')
         self.parentThumb = data.attrib.get('parentThumb')
         self.parentTitle = data.attrib.get('parentTitle')
+        self.rating = utils.cast(float, data.attrib.get('rating'))
         self.ratings = self.findItems(data, media.Rating)
         self.subtitleLanguage = data.attrib.get('subtitleLanguage', '')
         self.subtitleMode = utils.cast(int, data.attrib.get('subtitleMode', '-1'))
diff --git a/requirements.txt b/requirements.txt
index 3d624c3a..6edced4e 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -26,7 +26,7 @@ musicbrainzngs==0.7.1
 packaging==24.0
 paho-mqtt==2.1.0
 platformdirs==4.2.2
-plexapi==4.15.12
+plexapi==4.15.13
 portend==3.2.0
 profilehooks==1.12.0
 PyJWT==2.8.0

From 795d568df2431c14ae4a2d1e1ee7716c94d07e0e Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 18 May 2024 13:56:06 -0700
Subject: [PATCH 610/743] v2.14.2

---
 CHANGELOG.md      | 13 ++++---------
 plexpy/version.py |  4 ++--
 2 files changed, 6 insertions(+), 11 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 48e02c60..e876fbb6 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,14 +1,6 @@
 # Changelog
 
-## v2.14.1-beta (2024-05-11)
-
-* UI:
-  * Fix: Users without access to Plex server not showing as inactive.
-* Other:
-  * Removed: Python 2 compatibility code. (#2098, #2226) (Thanks @zdimension)
-
-
-## v2.14.0-beta (2024-04-19)
+## v2.14.2 (2024-05-18)
 
 * History:
   * Fix: Live TV activity not logging to history.
@@ -27,9 +19,11 @@
   * New: Added slug attribute to exporter fields.
   * New: Added track genres to exporter fields.
   * New: Added playlist source URI to exporter fields.
+  * New: Added artProvider and thumbProvider to exporter fields.
 * UI:
   * Fix: Mask deleted usernames in the logs.
   * Fix: Live TV watch stats not showing on the media info page.
+  * Fix: Users without access to Plex server not showing as inactive.
   * Removed: Deprecated synced item pages.
   * Removed: Anonymous redirect settings. Links now use browser no-referrer policy instead.
 * API:
@@ -41,6 +35,7 @@
 * Other:
   * Change: Login cookie expires changed to max-age.
   * Change: Improved key generation for login password. It is recommended to reenter your HTTP Password in the settings after upgrading.
+  * Removed: Python 2 compatibility code. (#2098, #2226) (Thanks @zdimension)
 
 
 ## v2.13.4 (2023-12-07)
diff --git a/plexpy/version.py b/plexpy/version.py
index cf3944db..698d7d45 100644
--- a/plexpy/version.py
+++ b/plexpy/version.py
@@ -15,5 +15,5 @@
 #  You should have received a copy of the GNU General Public License
 #  along with Tautulli.  If not, see <http://www.gnu.org/licenses/>.
 
-PLEXPY_BRANCH = "beta"
-PLEXPY_RELEASE_VERSION = "v2.14.1-beta"
\ No newline at end of file
+PLEXPY_BRANCH = "master"
+PLEXPY_RELEASE_VERSION = "v2.14.2"
\ No newline at end of file

From 73cfa8e0c09191bb66365807b62a51e2056d6ad4 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 18 May 2024 14:29:53 -0700
Subject: [PATCH 611/743] Add `git clean` to reset git install

---
 plexpy/versioncheck.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/plexpy/versioncheck.py b/plexpy/versioncheck.py
index 442dcc23..2c161dd3 100644
--- a/plexpy/versioncheck.py
+++ b/plexpy/versioncheck.py
@@ -394,6 +394,7 @@ def reset_git_install():
         output, err = runGit('branch -u {}/{}'.format(plexpy.CONFIG.GIT_REMOTE,
                                                       plexpy.CONFIG.GIT_BRANCH))
         output, err = runGit('reset --hard {}'.format(common.RELEASE))
+        _, _ = runGit('clean -fd')
 
         if not output:
             logger.error('Unable to reset Tautulli installation.')

From dcdf5a2992228ee133373c8497111707df54615f Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 21 May 2024 10:40:00 -0700
Subject: [PATCH 612/743] Fix SQLite quotes for history date filters

---
 plexpy/webserve.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/plexpy/webserve.py b/plexpy/webserve.py
index 444d5a68..ec98baf2 100644
--- a/plexpy/webserve.py
+++ b/plexpy/webserve.py
@@ -1997,15 +1997,15 @@ class WebInterface(object):
         if 'start_date' in kwargs:
             start_date = helpers.split_strip(kwargs.pop('start_date', ''))
             if start_date:
-                custom_where.append(['strftime("%Y-%m-%d", datetime(started, "unixepoch", "localtime"))', start_date])
+                custom_where.append(["strftime('%Y-%m-%d', datetime(started, 'unixepoch', 'localtime'))", start_date])
         if 'before' in kwargs:
             before = helpers.split_strip(kwargs.pop('before', ''))
             if before:
-                custom_where.append(['strftime("%Y-%m-%d", datetime(started, "unixepoch", "localtime")) <', before])
+                custom_where.append(["strftime('%Y-%m-%d', datetime(started, 'unixepoch', 'localtime')) <", before])
         if 'after' in kwargs:
             after = helpers.split_strip(kwargs.pop('after', ''))
             if after:
-                custom_where.append(['strftime("%Y-%m-%d", datetime(started, "unixepoch", "localtime")) >', after])
+                custom_where.append(["strftime('%Y-%m-%d', datetime(started, 'unixepoch', 'localtime')) >", after])
         if 'reference_id' in kwargs:
             reference_id = helpers.split_strip(kwargs.pop('reference_id', ''))
             if reference_id:

From 5778672dabfbed37fc9dbef94ca75570477dbbd7 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 25 May 2024 18:41:17 -0700
Subject: [PATCH 613/743] Fix webserver restarting

---
 plexpy/webstart.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/plexpy/webstart.py b/plexpy/webstart.py
index b02e9ec1..62ab41ae 100644
--- a/plexpy/webstart.py
+++ b/plexpy/webstart.py
@@ -51,6 +51,7 @@ def start():
 def stop():
     logger.info("Tautulli WebStart :: Stopping Tautulli web server...")
     cherrypy.engine.exit()
+    cherrypy.server.httpserver = None
 
 
 def restart():

From 912fd75a2fce2a75ce6181e0e6b8c92d75a156aa Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 3 Jun 2024 23:14:04 -0700
Subject: [PATCH 614/743] Remove pms_is_remote setting

* Automatically determine if a server is local or remote
---
 data/interfaces/default/settings.html | 15 --------------
 data/interfaces/default/welcome.html  | 20 +-----------------
 plexpy/plextv.py                      | 30 +++++++++++----------------
 plexpy/webserve.py                    |  5 +----
 4 files changed, 14 insertions(+), 56 deletions(-)

diff --git a/data/interfaces/default/settings.html b/data/interfaces/default/settings.html
index 2dd20ff8..562a53af 100644
--- a/data/interfaces/default/settings.html
+++ b/data/interfaces/default/settings.html
@@ -767,7 +767,6 @@
                                                     data-identifier="${config['pms_identifier']}"
                                                     data-ip="${config['pms_ip']}"
                                                     data-port="${config['pms_port']}"
-                                                    data-local="${int(not int(config['pms_is_remote']))}"
                                                     data-ssl="${config['pms_ssl']}"
                                                     data-is_cloud="${config['pms_is_cloud']}"
                                                     data-label="${config['pms_name'] or 'Local'}"
@@ -800,13 +799,6 @@
                             </label>
                             <p class="help-block">Connect to your Plex server using HTTPS if you have <a href="${anon_url('https://support.plex.tv/articles/206225077-how-to-use-secure-server-connections')}" target="_blank" rel="noreferrer">secure connections</a> enabled.</p>
                         </div>
-                        <div class="checkbox">
-                            <label>
-                                <input type="checkbox" id="pms_is_remote_checkbox" class="checkbox-toggle pms-settings" data-id="pms_is_remote" value="1" ${checked(config['pms_is_remote'])}> Remote Server
-                                <input type="hidden" id="pms_is_remote" name="pms_is_remote" value="${config['pms_is_remote']}">
-                            </label>
-                            <p class="help-block">Check this if your Plex Server is not on the same local network as Tautulli.</p>
-                        </div>
                         <div class="form-group">
                             <label for="pms_url">Plex Server URL</label>
                             <div class="row">
@@ -2597,7 +2589,6 @@ $(document).ready(function() {
                 return '<div data-identifier="' + item.clientIdentifier +
                         '" data-ip="' + item.ip +
                         '" data-port="' + item.port +
-                        '" data-local="' + item.local +
                         '" data-ssl="' + item.httpsRequired +
                         '" data-is_cloud="' + item.is_cloud +
                         '" data-label="' + item.label + '">' +
@@ -2611,7 +2602,6 @@ $(document).ready(function() {
                 return '<div data-identifier="' + item.clientIdentifier +
                         '" data-ip="' + item.ip +
                         '" data-port="' + item.port +
-                        '" data-local="' + item.local +
                         '" data-ssl="' + item.httpsRequired +
                         '" data-is_cloud="' + item.is_cloud +
                         '" data-label="' + item.label + '">' +
@@ -2634,7 +2624,6 @@ $(document).ready(function() {
             var identifier = $(pms_ip_selected).data('identifier');
             var ip = $(pms_ip_selected).data('ip');
             var port = $(pms_ip_selected).data('port');
-            var local = $(pms_ip_selected).data('local');
             var ssl = $(pms_ip_selected).data('ssl');
             var is_cloud = $(pms_ip_selected).data('is_cloud');
             var value = $(pms_ip_selected).data('value');
@@ -2642,8 +2631,6 @@ $(document).ready(function() {
             $("#pms_identifier").val(identifier !== 'undefined' ? identifier : '');
             $('#pms_ip').val(ip !== 'undefined' ? ip : value);
             $('#pms_port').val(port !== 'undefined' ? port : 32400);
-            $('#pms_is_remote_checkbox').prop('checked', (local !== 'undefined' && local === 0));
-            $('#pms_is_remote').val(local !== 'undefined' && local === 0 ? 1 : 0);
             $('#pms_ssl_checkbox').prop('checked', (ssl !== 'undefined' && ssl === 1));
             $('#pms_ssl').val(ssl !== 'undefined' && ssl === 1 ? 1 : 0);
             $('#pms_is_cloud').val(is_cloud !== 'undefined' && is_cloud === true ? 1 : 0);
@@ -2681,7 +2668,6 @@ $(document).ready(function() {
         var pms_port = $("#pms_port").val();
         var pms_identifier = $("#pms_identifier").val();
         var pms_ssl = $("#pms_ssl").val();
-        var pms_is_remote = $("#pms_is_remote").val();
         var pms_url_manual = $("#pms_url_manual").is(':checked') ? 1 : 0;
 
         if (($("#pms_ip").val() !== '') || ($("#pms_port").val() !== '')) {
@@ -2693,7 +2679,6 @@ $(document).ready(function() {
                     hostname: pms_ip,
                     port: pms_port,
                     ssl: pms_ssl,
-                    remote: pms_is_remote,
                     manual: pms_url_manual,
                     get_url: true,
                     test_websocket: true
diff --git a/data/interfaces/default/welcome.html b/data/interfaces/default/welcome.html
index 39fc19b4..e3b4bc56 100644
--- a/data/interfaces/default/welcome.html
+++ b/data/interfaces/default/welcome.html
@@ -135,7 +135,6 @@
                                             data-identifier="${config['pms_identifier']}"
                                             data-ip="${config['pms_ip']}"
                                             data-port="${config['pms_port']}"
-                                            data-local="${int(not int(config['pms_is_remote']))}"
                                             data-ssl="${config['pms_ssl']}"
                                             data-is_cloud="${config['pms_is_cloud']}"
                                             data-label="${config['pms_name'] or 'Local'}"
@@ -159,14 +158,6 @@
                                     </label>
                                 </div>
                             </div>
-                            <div class="col-xs-4">
-                                <div class="checkbox">
-                                    <label>
-                                        <input type="checkbox" id="pms_is_remote_checkbox" class="checkbox-toggle pms-settings" data-id="pms_is_remote" value="1" ${helpers.checked(config['pms_is_remote'])}> Remote Server
-                                        <input type="hidden" id="pms_is_remote" name="pms_is_remote" value="${config['pms_is_remote']}">
-                                    </label>
-                                </div>
-                            </div>
                         </div>
                     </div>
                     <input type="hidden" id="pms_valid" data-validate="validatePMSip" value="">
@@ -391,7 +382,6 @@ $(document).ready(function() {
                 return '<div data-identifier="' + item.clientIdentifier +
                         '" data-ip="' + item.ip +
                         '" data-port="' + item.port +
-                        '" data-local="' + item.local +
                         '" data-ssl="' + item.httpsRequired +
                         '" data-is_cloud="' + item.is_cloud +
                         '" data-label="' + item.label + '">' +
@@ -405,7 +395,6 @@ $(document).ready(function() {
                 return '<div data-identifier="' + item.clientIdentifier +
                         '" data-ip="' + item.ip +
                         '" data-port="' + item.port +
-                        '" data-local="' + item.local +
                         '" data-ssl="' + item.httpsRequired +
                         '" data-is_cloud="' + item.is_cloud +
                         '" data-label="' + item.label + '">' +
@@ -428,7 +417,6 @@ $(document).ready(function() {
             var identifier = $(pms_ip_selected).data('identifier');
             var ip = $(pms_ip_selected).data('ip');
             var port = $(pms_ip_selected).data('port');
-            var local = $(pms_ip_selected).data('local');
             var ssl = $(pms_ip_selected).data('ssl');
             var is_cloud = $(pms_ip_selected).data('is_cloud');
             var value = $(pms_ip_selected).data('value');
@@ -439,19 +427,15 @@ $(document).ready(function() {
             $("#pms_identifier").val(identifier !== 'undefined' ? identifier : '');
             $('#pms_ip').val(ip !== 'undefined' ? ip : value);
             $('#pms_port').val(port !== 'undefined' ? port : 32400);
-            $('#pms_is_remote_checkbox').prop('checked', (local !== 'undefined' && local === 0));
-            $('#pms_is_remote').val(local !== 'undefined' && local === 0 ? 1 : 0);
             $('#pms_ssl_checkbox').prop('checked', (ssl !== 'undefined' && ssl === 1));
             $('#pms_ssl').val(ssl !== 'undefined' && ssl === 1 ? 1 : 0);
             $('#pms_is_cloud').val(is_cloud !== 'undefined' && is_cloud === true ? 1 : 0);
 
             if (is_cloud === true) {
                 $('#pms_port').prop('readonly', true);
-                $('#pms_is_remote_checkbox').prop('disabled', true);
                 $('#pms_ssl_checkbox').prop('disabled', true);
             } else {
                 $('#pms_port').prop('readonly', false);
-                $('#pms_is_remote_checkbox').prop('disabled', false);
                 $('#pms_ssl_checkbox').prop('disabled', false);
             }
         },
@@ -488,7 +472,6 @@ $(document).ready(function() {
             var pms_port = $("#pms_port").val().trim();
             var pms_identifier = $("#pms_identifier").val();
             var pms_ssl = $("#pms_ssl").val();
-            var pms_is_remote = $("#pms_is_remote").val();
             if ((pms_ip !== '') || (pms_port !== '')) {
                 $("#pms-verify-status").html('<i class="fa fa-refresh fa-spin"></i>&nbsp; Verifying server...');
                 $('#pms-verify-status').fadeIn('fast');
@@ -498,8 +481,7 @@ $(document).ready(function() {
                         hostname: pms_ip,
                         port: pms_port,
                         identifier: pms_identifier,
-                        ssl: pms_ssl,
-                        remote: pms_is_remote
+                        ssl: pms_ssl
                     },
                     cache: true,
                     async: true,
diff --git a/plexpy/plextv.py b/plexpy/plextv.py
index d45ce785..eed9d50e 100644
--- a/plexpy/plextv.py
+++ b/plexpy/plextv.py
@@ -39,7 +39,6 @@ def get_server_resources(return_presence=False, return_server=False, return_info
               'pms_ip': plexpy.CONFIG.PMS_IP,
               'pms_port': plexpy.CONFIG.PMS_PORT,
               'pms_ssl': plexpy.CONFIG.PMS_SSL,
-              'pms_is_remote': plexpy.CONFIG.PMS_IS_REMOTE,
               'pms_is_cloud': plexpy.CONFIG.PMS_IS_CLOUD,
               'pms_url': plexpy.CONFIG.PMS_URL,
               'pms_url_manual': plexpy.CONFIG.PMS_URL_MANUAL,
@@ -52,7 +51,7 @@ def get_server_resources(return_presence=False, return_server=False, return_info
 
     if kwargs:
         server.update(kwargs)
-        for k in ['pms_ssl', 'pms_is_remote', 'pms_is_cloud', 'pms_url_manual']:
+        for k in ['pms_ssl', 'pms_is_cloud', 'pms_url_manual']:
             server[k] = int(server[k])
 
     if server['pms_url_manual'] and server['pms_ssl'] or server['pms_is_cloud']:
@@ -88,30 +87,25 @@ def get_server_resources(return_presence=False, return_server=False, return_info
     # Only need to retrieve PMS_URL if using SSL
     if not server['pms_url_manual'] and server['pms_ssl']:
         if connections:
-            if server['pms_is_remote']:
-                # Get all remote connections
-                conns = [c for c in connections if
-                         c['local'] == '0' and ('plex.direct' in c['uri'] or 'plex.service' in c['uri'])]
-            else:
-                # Get all local connections
-                conns = [c for c in connections if
-                         c['local'] == '1' and ('plex.direct' in c['uri'] or 'plex.service' in c['uri'])]
-
-            if conns:
-                # Get connection with matching address, otherwise return first connection
-                conn = next((c for c in conns if c['address'] == server['pms_ip']
-                             and c['port'] == str(server['pms_port'])), conns[0])
-                server['pms_url'] = conn['uri']
-                logger.info("Tautulli PlexTV :: Server URL retrieved.")
+            # Get connection with matching address, otherwise return first connection
+            connection = next(
+                (c for c in connections if c['address'] == server['pms_ip'] and c['port'] == str(server['pms_port'])),
+                connections[0]
+            )
+            server['pms_url'] = connection['uri']
+            server['pms_is_remote'] = int(connection['local'] == '0')
+            logger.info("Tautulli PlexTV :: Server URL retrieved.")
 
         # get_server_urls() failed or PMS_URL not found, fallback url doesn't use SSL
         if not server['pms_url']:
             server['pms_url'] = fallback_url
+            server['pms_is_remote'] = 0
             logger.warn("Tautulli PlexTV :: Unable to retrieve server URLs. Using user-defined value without SSL.")
 
-        # Not using SSL, remote has no effect
+    # Not using SSL
     else:
         server['pms_url'] = fallback_url
+        server['pms_is_remote'] = 0
         logger.info("Tautulli PlexTV :: Using user-defined URL.")
 
     if return_server:
diff --git a/plexpy/webserve.py b/plexpy/webserve.py
index ec98baf2..150bc18d 100644
--- a/plexpy/webserve.py
+++ b/plexpy/webserve.py
@@ -175,7 +175,6 @@ class WebInterface(object):
             "pms_identifier": plexpy.CONFIG.PMS_IDENTIFIER,
             "pms_ip": plexpy.CONFIG.PMS_IP,
             "pms_port": plexpy.CONFIG.PMS_PORT,
-            "pms_is_remote": plexpy.CONFIG.PMS_IS_REMOTE,
             "pms_ssl": plexpy.CONFIG.PMS_SSL,
             "pms_is_cloud": plexpy.CONFIG.PMS_IS_CLOUD,
             "pms_name": helpers.pms_name(),
@@ -3247,7 +3246,6 @@ class WebInterface(object):
 
         # If we change the SSL setting for PMS or PMS remote setting, make sure we grab the new url.
         if kwargs.get('pms_ssl') != str(plexpy.CONFIG.PMS_SSL) or \
-                kwargs.get('pms_is_remote') != str(plexpy.CONFIG.PMS_IS_REMOTE) or \
                 kwargs.get('pms_url_manual') != plexpy.CONFIG.PMS_URL_MANUAL:
             server_changed = True
 
@@ -4060,7 +4058,7 @@ class WebInterface(object):
     @cherrypy.tools.json_out()
     @requireAuth(member_of("admin"))
     @addtoapi()
-    def get_server_id(self, hostname=None, port=None, identifier=None, ssl=0, remote=0, manual=0,
+    def get_server_id(self, hostname=None, port=None, identifier=None, ssl=0, manual=0,
                       get_url=False, test_websocket=False, **kwargs):
         """ Get the PMS server identifier.
 
@@ -4115,7 +4113,6 @@ class WebInterface(object):
                 server = self.get_server_resources(pms_ip=hostname,
                                                    pms_port=port,
                                                    pms_ssl=ssl,
-                                                   pms_is_remote=remote,
                                                    pms_url_manual=manual,
                                                    pms_identifier=identifier)
                 result['url'] = server['pms_url']

From a3af8ed36210e49350c5233487ebf5b832190a39 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 3 Jun 2024 23:07:11 -0700
Subject: [PATCH 615/743] Fix width of use secure connection checkbox in wizard

---
 data/interfaces/default/welcome.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/data/interfaces/default/welcome.html b/data/interfaces/default/welcome.html
index e3b4bc56..baf1b57e 100644
--- a/data/interfaces/default/welcome.html
+++ b/data/interfaces/default/welcome.html
@@ -150,7 +150,7 @@
                             <div class="col-xs-3">
                                 <input type="text" class="form-control pms-settings" name="pms_port" id="pms_port" placeholder="32400" value="${config['pms_port']}" required>
                             </div>
-                            <div class="col-xs-4">
+                            <div class="col-xs-9">
                                 <div class="checkbox">
                                     <label>
                                         <input type="checkbox" id="pms_ssl_checkbox" class="checkbox-toggle pms-settings" data-id="pms_ssl" value="1" ${helpers.checked(config['pms_ssl'])}> Use Secure Connection

From f1d44c051dfa5f6219551dc4ffae04be7952fb31 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 6 Jun 2024 21:39:33 -0700
Subject: [PATCH 616/743] Fix loading of scheduled tasks when tasks are
 disabled

---
 data/interfaces/default/scheduler_table.html | 7 ++-----
 plexpy/common.py                             | 2 +-
 2 files changed, 3 insertions(+), 6 deletions(-)

diff --git a/data/interfaces/default/scheduler_table.html b/data/interfaces/default/scheduler_table.html
index 8d264aa9..c4087f17 100644
--- a/data/interfaces/default/scheduler_table.html
+++ b/data/interfaces/default/scheduler_table.html
@@ -13,8 +13,6 @@ DOCUMENTATION :: END
     import datetime
     import plexpy
     from plexpy import common, helpers
-
-    scheduled_jobs = [j.id for j in plexpy.SCHED.get_jobs()]
 %>
 
 <table class="config-scheduler-table small-muted">
@@ -29,16 +27,15 @@ DOCUMENTATION :: END
     </thead>
     <tbody>
         % for job, job_type in common.SCHEDULER_LIST.items():
-        % if job in scheduled_jobs:
         <%
             sched_job = plexpy.SCHED.get_job(job)
-            now = datetime.datetime.now(sched_job.next_run_time.tzinfo)
         %>
+        % if sched_job:
         <tr>
             <td>${sched_job.id}</td>
             <td><i class="fa fa-sm fa-fw fa-check"></i> Active</td>
             <td>${helpers.format_timedelta_Hms(sched_job.trigger.interval)}</td>
-            <td>${helpers.format_timedelta_Hms(sched_job.next_run_time - now)}</td>
+            <td>${helpers.format_timedelta_Hms(sched_job.next_run_time - datetime.datetime.now(sched_job.next_run_time.tzinfo))}</td>
             <td>${sched_job.next_run_time.astimezone(plexpy.SYS_TIMEZONE).strftime('%Y-%m-%d %H:%M:%S')}</td>
         </tr>
         % elif job_type == 'websocket' and plexpy.WS_CONNECTED:
diff --git a/plexpy/common.py b/plexpy/common.py
index ae6f6c98..fb35beb3 100644
--- a/plexpy/common.py
+++ b/plexpy/common.py
@@ -237,7 +237,7 @@ EXTRA_TYPES = {
 }
 
 SCHEDULER_LIST = [
-    ('Check GitHub for updates', 'websocket'),
+    ('Check GitHub for updates', 'scheduled'),
     ('Check for server response', 'websocket'),
     ('Check for active sessions', 'websocket'),
     ('Check for recently added items', 'websocket'),

From 55573d26eaa7d9f98a84215c757a5b5b2030ce52 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 18 Jun 2024 19:19:18 -0700
Subject: [PATCH 617/743] Ignore shutdown exception in cheroot

---
 plexpy/webstart.py | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/plexpy/webstart.py b/plexpy/webstart.py
index 62ab41ae..8a6edc6e 100644
--- a/plexpy/webstart.py
+++ b/plexpy/webstart.py
@@ -19,6 +19,7 @@ import os
 import ssl
 import sys
 
+import cheroot.errors
 import cherrypy
 
 import plexpy
@@ -260,6 +261,13 @@ def initialize(options):
         }
     }
 
+    # Catch shutdown errors that can break cherrypy/cheroot
+    # See https://github.com/cherrypy/cheroot/issues/710
+    try:
+        cheroot.errors.acceptable_sock_shutdown_exceptions += (OSError,)
+    except AttributeError:
+        pass
+
     cherrypy.tree.mount(WebInterface(), options['http_root'], config=conf)
     if plexpy.HTTP_ROOT != '/':
         cherrypy.tree.mount(BaseRedirect(), '/')

From 43e71d836a7e7b21cf96acd9d85f2bd02b1d227b Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 19 Jun 2024 00:01:34 -0700
Subject: [PATCH 618/743] Bump requests from 2.31.0 to 2.32.3 (#2338)

* Bump requests from 2.31.0 to 2.32.3

Bumps [requests](https://github.com/psf/requests) from 2.31.0 to 2.32.3.
- [Release notes](https://github.com/psf/requests/releases)
- [Changelog](https://github.com/psf/requests/blob/main/HISTORY.md)
- [Commits](https://github.com/psf/requests/compare/v2.31.0...v2.32.3)

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

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

* Update requests==2.32.3

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/requests/__init__.py     |   6 +-
 lib/requests/__version__.py  |   6 +-
 lib/requests/adapters.py     | 225 +++++++++++++++++++++++++++++++----
 lib/requests/api.py          |   2 +-
 lib/requests/auth.py         |   1 -
 lib/requests/compat.py       |  25 +++-
 lib/requests/cookies.py      |  16 +--
 lib/requests/exceptions.py   |  10 ++
 lib/requests/models.py       |  13 +-
 lib/requests/packages.py     |  23 ++--
 lib/requests/sessions.py     |  12 +-
 lib/requests/status_codes.py |  10 +-
 lib/requests/utils.py        |  16 +--
 requirements.txt             |   2 +-
 14 files changed, 287 insertions(+), 80 deletions(-)

diff --git a/lib/requests/__init__.py b/lib/requests/__init__.py
index 300a16c5..051cda13 100644
--- a/lib/requests/__init__.py
+++ b/lib/requests/__init__.py
@@ -83,7 +83,11 @@ def check_compatibility(urllib3_version, chardet_version, charset_normalizer_ver
         # charset_normalizer >= 2.0.0 < 4.0.0
         assert (2, 0, 0) <= (major, minor, patch) < (4, 0, 0)
     else:
-        raise Exception("You need either charset_normalizer or chardet installed")
+        warnings.warn(
+            "Unable to find acceptable character detection dependency "
+            "(chardet or charset_normalizer).",
+            RequestsDependencyWarning,
+        )
 
 
 def _check_cryptography(cryptography_version):
diff --git a/lib/requests/__version__.py b/lib/requests/__version__.py
index 5063c3f8..2c105aca 100644
--- a/lib/requests/__version__.py
+++ b/lib/requests/__version__.py
@@ -5,10 +5,10 @@
 __title__ = "requests"
 __description__ = "Python HTTP for Humans."
 __url__ = "https://requests.readthedocs.io"
-__version__ = "2.31.0"
-__build__ = 0x023100
+__version__ = "2.32.3"
+__build__ = 0x023203
 __author__ = "Kenneth Reitz"
 __author_email__ = "me@kennethreitz.org"
-__license__ = "Apache 2.0"
+__license__ = "Apache-2.0"
 __copyright__ = "Copyright Kenneth Reitz"
 __cake__ = "\u2728 \U0001f370 \u2728"
diff --git a/lib/requests/adapters.py b/lib/requests/adapters.py
index 78e3bb6e..9a58b160 100644
--- a/lib/requests/adapters.py
+++ b/lib/requests/adapters.py
@@ -8,6 +8,8 @@ and maintain connections.
 
 import os.path
 import socket  # noqa: F401
+import typing
+import warnings
 
 from urllib3.exceptions import ClosedPoolError, ConnectTimeoutError
 from urllib3.exceptions import HTTPError as _HTTPError
@@ -25,6 +27,7 @@ from urllib3.poolmanager import PoolManager, proxy_from_url
 from urllib3.util import Timeout as TimeoutSauce
 from urllib3.util import parse_url
 from urllib3.util.retry import Retry
+from urllib3.util.ssl_ import create_urllib3_context
 
 from .auth import _basic_auth_str
 from .compat import basestring, urlparse
@@ -61,12 +64,76 @@ except ImportError:
         raise InvalidSchema("Missing dependencies for SOCKS support.")
 
 
+if typing.TYPE_CHECKING:
+    from .models import PreparedRequest
+
+
 DEFAULT_POOLBLOCK = False
 DEFAULT_POOLSIZE = 10
 DEFAULT_RETRIES = 0
 DEFAULT_POOL_TIMEOUT = None
 
 
+try:
+    import ssl  # noqa: F401
+
+    _preloaded_ssl_context = create_urllib3_context()
+    _preloaded_ssl_context.load_verify_locations(
+        extract_zipped_paths(DEFAULT_CA_BUNDLE_PATH)
+    )
+except ImportError:
+    # Bypass default SSLContext creation when Python
+    # interpreter isn't built with the ssl module.
+    _preloaded_ssl_context = None
+
+
+def _urllib3_request_context(
+    request: "PreparedRequest",
+    verify: "bool | str | None",
+    client_cert: "typing.Tuple[str, str] | str | None",
+    poolmanager: "PoolManager",
+) -> "(typing.Dict[str, typing.Any], typing.Dict[str, typing.Any])":
+    host_params = {}
+    pool_kwargs = {}
+    parsed_request_url = urlparse(request.url)
+    scheme = parsed_request_url.scheme.lower()
+    port = parsed_request_url.port
+
+    # Determine if we have and should use our default SSLContext
+    # to optimize performance on standard requests.
+    poolmanager_kwargs = getattr(poolmanager, "connection_pool_kw", {})
+    has_poolmanager_ssl_context = poolmanager_kwargs.get("ssl_context")
+    should_use_default_ssl_context = (
+        _preloaded_ssl_context is not None and not has_poolmanager_ssl_context
+    )
+
+    cert_reqs = "CERT_REQUIRED"
+    if verify is False:
+        cert_reqs = "CERT_NONE"
+    elif verify is True and should_use_default_ssl_context:
+        pool_kwargs["ssl_context"] = _preloaded_ssl_context
+    elif isinstance(verify, str):
+        if not os.path.isdir(verify):
+            pool_kwargs["ca_certs"] = verify
+        else:
+            pool_kwargs["ca_cert_dir"] = verify
+    pool_kwargs["cert_reqs"] = cert_reqs
+    if client_cert is not None:
+        if isinstance(client_cert, tuple) and len(client_cert) == 2:
+            pool_kwargs["cert_file"] = client_cert[0]
+            pool_kwargs["key_file"] = client_cert[1]
+        else:
+            # According to our docs, we allow users to specify just the client
+            # cert path
+            pool_kwargs["cert_file"] = client_cert
+    host_params = {
+        "scheme": scheme,
+        "host": parsed_request_url.hostname,
+        "port": port,
+    }
+    return host_params, pool_kwargs
+
+
 class BaseAdapter:
     """The Base Transport Adapter"""
 
@@ -247,28 +314,26 @@ class HTTPAdapter(BaseAdapter):
         :param cert: The SSL certificate to verify.
         """
         if url.lower().startswith("https") and verify:
-
-            cert_loc = None
-
-            # Allow self-specified cert location.
-            if verify is not True:
-                cert_loc = verify
-
-            if not cert_loc:
-                cert_loc = extract_zipped_paths(DEFAULT_CA_BUNDLE_PATH)
-
-            if not cert_loc or not os.path.exists(cert_loc):
-                raise OSError(
-                    f"Could not find a suitable TLS CA certificate bundle, "
-                    f"invalid path: {cert_loc}"
-                )
-
             conn.cert_reqs = "CERT_REQUIRED"
 
-            if not os.path.isdir(cert_loc):
-                conn.ca_certs = cert_loc
-            else:
-                conn.ca_cert_dir = cert_loc
+            # Only load the CA certificates if 'verify' is a string indicating the CA bundle to use.
+            # Otherwise, if verify is a boolean, we don't load anything since
+            # the connection will be using a context with the default certificates already loaded,
+            # and this avoids a call to the slow load_verify_locations()
+            if verify is not True:
+                # `verify` must be a str with a path then
+                cert_loc = verify
+
+                if not os.path.exists(cert_loc):
+                    raise OSError(
+                        f"Could not find a suitable TLS CA certificate bundle, "
+                        f"invalid path: {cert_loc}"
+                    )
+
+                if not os.path.isdir(cert_loc):
+                    conn.ca_certs = cert_loc
+                else:
+                    conn.ca_cert_dir = cert_loc
         else:
             conn.cert_reqs = "CERT_NONE"
             conn.ca_certs = None
@@ -328,8 +393,110 @@ class HTTPAdapter(BaseAdapter):
 
         return response
 
+    def build_connection_pool_key_attributes(self, request, verify, cert=None):
+        """Build the PoolKey attributes used by urllib3 to return a connection.
+
+        This looks at the PreparedRequest, the user-specified verify value,
+        and the value of the cert parameter to determine what PoolKey values
+        to use to select a connection from a given urllib3 Connection Pool.
+
+        The SSL related pool key arguments are not consistently set. As of
+        this writing, use the following to determine what keys may be in that
+        dictionary:
+
+        * If ``verify`` is ``True``, ``"ssl_context"`` will be set and will be the
+          default Requests SSL Context
+        * If ``verify`` is ``False``, ``"ssl_context"`` will not be set but
+          ``"cert_reqs"`` will be set
+        * If ``verify`` is a string, (i.e., it is a user-specified trust bundle)
+          ``"ca_certs"`` will be set if the string is not a directory recognized
+          by :py:func:`os.path.isdir`, otherwise ``"ca_certs_dir"`` will be
+          set.
+        * If ``"cert"`` is specified, ``"cert_file"`` will always be set. If
+          ``"cert"`` is a tuple with a second item, ``"key_file"`` will also
+          be present
+
+        To override these settings, one may subclass this class, call this
+        method and use the above logic to change parameters as desired. For
+        example, if one wishes to use a custom :py:class:`ssl.SSLContext` one
+        must both set ``"ssl_context"`` and based on what else they require,
+        alter the other keys to ensure the desired behaviour.
+
+        :param request:
+            The PreparedReqest being sent over the connection.
+        :type request:
+            :class:`~requests.models.PreparedRequest`
+        :param verify:
+            Either a boolean, in which case it controls whether
+            we verify the server's TLS certificate, or a string, in which case it
+            must be a path to a CA bundle to use.
+        :param cert:
+            (optional) Any user-provided SSL certificate for client
+            authentication (a.k.a., mTLS). This may be a string (i.e., just
+            the path to a file which holds both certificate and key) or a
+            tuple of length 2 with the certificate file path and key file
+            path.
+        :returns:
+            A tuple of two dictionaries. The first is the "host parameters"
+            portion of the Pool Key including scheme, hostname, and port. The
+            second is a dictionary of SSLContext related parameters.
+        """
+        return _urllib3_request_context(request, verify, cert, self.poolmanager)
+
+    def get_connection_with_tls_context(self, request, verify, proxies=None, cert=None):
+        """Returns a urllib3 connection for the given request and TLS settings.
+        This should not be called from user code, and is only exposed for use
+        when subclassing the :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`.
+
+        :param request:
+            The :class:`PreparedRequest <PreparedRequest>` object to be sent
+            over the connection.
+        :param verify:
+            Either a boolean, in which case it controls whether we verify the
+            server's TLS certificate, or a string, in which case it must be a
+            path to a CA bundle to use.
+        :param proxies:
+            (optional) The proxies dictionary to apply to the request.
+        :param cert:
+            (optional) Any user-provided SSL certificate to be used for client
+            authentication (a.k.a., mTLS).
+        :rtype:
+            urllib3.ConnectionPool
+        """
+        proxy = select_proxy(request.url, proxies)
+        try:
+            host_params, pool_kwargs = self.build_connection_pool_key_attributes(
+                request,
+                verify,
+                cert,
+            )
+        except ValueError as e:
+            raise InvalidURL(e, request=request)
+        if proxy:
+            proxy = prepend_scheme_if_needed(proxy, "http")
+            proxy_url = parse_url(proxy)
+            if not proxy_url.host:
+                raise InvalidProxyURL(
+                    "Please check proxy URL. It is malformed "
+                    "and could be missing the host."
+                )
+            proxy_manager = self.proxy_manager_for(proxy)
+            conn = proxy_manager.connection_from_host(
+                **host_params, pool_kwargs=pool_kwargs
+            )
+        else:
+            # Only scheme should be lower case
+            conn = self.poolmanager.connection_from_host(
+                **host_params, pool_kwargs=pool_kwargs
+            )
+
+        return conn
+
     def get_connection(self, url, proxies=None):
-        """Returns a urllib3 connection for the given URL. This should not be
+        """DEPRECATED: Users should move to `get_connection_with_tls_context`
+        for all subclasses of HTTPAdapter using Requests>=2.32.2.
+
+        Returns a urllib3 connection for the given URL. This should not be
         called from user code, and is only exposed for use when subclassing the
         :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`.
 
@@ -337,6 +504,15 @@ class HTTPAdapter(BaseAdapter):
         :param proxies: (optional) A Requests-style dictionary of proxies used on this request.
         :rtype: urllib3.ConnectionPool
         """
+        warnings.warn(
+            (
+                "`get_connection` has been deprecated in favor of "
+                "`get_connection_with_tls_context`. Custom HTTPAdapter subclasses "
+                "will need to migrate for Requests>=2.32.2. Please see "
+                "https://github.com/psf/requests/pull/6710 for more details."
+            ),
+            DeprecationWarning,
+        )
         proxy = select_proxy(url, proxies)
 
         if proxy:
@@ -391,6 +567,9 @@ class HTTPAdapter(BaseAdapter):
             using_socks_proxy = proxy_scheme.startswith("socks")
 
         url = request.path_url
+        if url.startswith("//"):  # Don't confuse urllib3
+            url = f"/{url.lstrip('/')}"
+
         if is_proxied_http_request and not using_socks_proxy:
             url = urldefragauth(request.url)
 
@@ -451,7 +630,9 @@ class HTTPAdapter(BaseAdapter):
         """
 
         try:
-            conn = self.get_connection(request.url, proxies)
+            conn = self.get_connection_with_tls_context(
+                request, verify, proxies=proxies, cert=cert
+            )
         except LocationValueError as e:
             raise InvalidURL(e, request=request)
 
diff --git a/lib/requests/api.py b/lib/requests/api.py
index cd0b3eea..59607445 100644
--- a/lib/requests/api.py
+++ b/lib/requests/api.py
@@ -25,7 +25,7 @@ def request(method, url, **kwargs):
     :param cookies: (optional) Dict or CookieJar object to send with the :class:`Request`.
     :param files: (optional) Dictionary of ``'name': file-like-objects`` (or ``{'name': file-tuple}``) for multipart encoding upload.
         ``file-tuple`` can be a 2-tuple ``('filename', fileobj)``, 3-tuple ``('filename', fileobj, 'content_type')``
-        or a 4-tuple ``('filename', fileobj, 'content_type', custom_headers)``, where ``'content-type'`` is a string
+        or a 4-tuple ``('filename', fileobj, 'content_type', custom_headers)``, where ``'content_type'`` is a string
         defining the content type of the given file and ``custom_headers`` a dict-like object containing additional headers
         to add for the file.
     :param auth: (optional) Auth tuple to enable Basic/Digest/Custom HTTP Auth.
diff --git a/lib/requests/auth.py b/lib/requests/auth.py
index 9733686d..4a7ce6dc 100644
--- a/lib/requests/auth.py
+++ b/lib/requests/auth.py
@@ -258,7 +258,6 @@ class HTTPDigestAuth(AuthBase):
         s_auth = r.headers.get("www-authenticate", "")
 
         if "digest" in s_auth.lower() and self._thread_local.num_401_calls < 2:
-
             self._thread_local.num_401_calls += 1
             pat = re.compile(r"digest ", flags=re.IGNORECASE)
             self._thread_local.chal = parse_dict_header(pat.sub("", s_auth, count=1))
diff --git a/lib/requests/compat.py b/lib/requests/compat.py
index 6776163c..095de1b6 100644
--- a/lib/requests/compat.py
+++ b/lib/requests/compat.py
@@ -7,13 +7,28 @@ between Python 2 and Python 3. It remains for backwards
 compatibility until the next major version.
 """
 
-try:
-    import chardet
-except ImportError:
-    import charset_normalizer as chardet
-
+import importlib
 import sys
 
+# -------------------
+# Character Detection
+# -------------------
+
+
+def _resolve_char_detection():
+    """Find supported character detection libraries."""
+    chardet = None
+    for lib in ("chardet", "charset_normalizer"):
+        if chardet is None:
+            try:
+                chardet = importlib.import_module(lib)
+            except ImportError:
+                pass
+    return chardet
+
+
+chardet = _resolve_char_detection()
+
 # -------
 # Pythons
 # -------
diff --git a/lib/requests/cookies.py b/lib/requests/cookies.py
index bf54ab23..f69d0cda 100644
--- a/lib/requests/cookies.py
+++ b/lib/requests/cookies.py
@@ -2,7 +2,7 @@
 requests.cookies
 ~~~~~~~~~~~~~~~~
 
-Compatibility code to be able to use `cookielib.CookieJar` with requests.
+Compatibility code to be able to use `http.cookiejar.CookieJar` with requests.
 
 requests.utils imports from here, so be careful with imports.
 """
@@ -23,7 +23,7 @@ except ImportError:
 class MockRequest:
     """Wraps a `requests.Request` to mimic a `urllib2.Request`.
 
-    The code in `cookielib.CookieJar` expects this interface in order to correctly
+    The code in `http.cookiejar.CookieJar` expects this interface in order to correctly
     manage cookie policies, i.e., determine whether a cookie can be set, given the
     domains of the request and the cookie.
 
@@ -76,7 +76,7 @@ class MockRequest:
         return self._r.headers.get(name, self._new_headers.get(name, default))
 
     def add_header(self, key, val):
-        """cookielib has no legitimate use for this method; add it back if you find one."""
+        """cookiejar has no legitimate use for this method; add it back if you find one."""
         raise NotImplementedError(
             "Cookie headers should be added with add_unredirected_header()"
         )
@@ -104,11 +104,11 @@ class MockResponse:
     """Wraps a `httplib.HTTPMessage` to mimic a `urllib.addinfourl`.
 
     ...what? Basically, expose the parsed HTTP headers from the server response
-    the way `cookielib` expects to see them.
+    the way `http.cookiejar` expects to see them.
     """
 
     def __init__(self, headers):
-        """Make a MockResponse for `cookielib` to read.
+        """Make a MockResponse for `cookiejar` to read.
 
         :param headers: a httplib.HTTPMessage or analogous carrying the headers
         """
@@ -124,7 +124,7 @@ class MockResponse:
 def extract_cookies_to_jar(jar, request, response):
     """Extract the cookies from the response into a CookieJar.
 
-    :param jar: cookielib.CookieJar (not necessarily a RequestsCookieJar)
+    :param jar: http.cookiejar.CookieJar (not necessarily a RequestsCookieJar)
     :param request: our own requests.Request object
     :param response: urllib3.HTTPResponse object
     """
@@ -174,7 +174,7 @@ class CookieConflictError(RuntimeError):
 
 
 class RequestsCookieJar(cookielib.CookieJar, MutableMapping):
-    """Compatibility class; is a cookielib.CookieJar, but exposes a dict
+    """Compatibility class; is a http.cookiejar.CookieJar, but exposes a dict
     interface.
 
     This is the CookieJar we create by default for requests and sessions that
@@ -341,7 +341,7 @@ class RequestsCookieJar(cookielib.CookieJar, MutableMapping):
         self.set(name, value)
 
     def __delitem__(self, name):
-        """Deletes a cookie given a name. Wraps ``cookielib.CookieJar``'s
+        """Deletes a cookie given a name. Wraps ``http.cookiejar.CookieJar``'s
         ``remove_cookie_by_name()``.
         """
         remove_cookie_by_name(self, name)
diff --git a/lib/requests/exceptions.py b/lib/requests/exceptions.py
index e1cedf88..83986b48 100644
--- a/lib/requests/exceptions.py
+++ b/lib/requests/exceptions.py
@@ -41,6 +41,16 @@ class JSONDecodeError(InvalidJSONError, CompatJSONDecodeError):
         CompatJSONDecodeError.__init__(self, *args)
         InvalidJSONError.__init__(self, *self.args, **kwargs)
 
+    def __reduce__(self):
+        """
+        The __reduce__ method called when pickling the object must
+        be the one from the JSONDecodeError (be it json/simplejson)
+        as it expects all the arguments for instantiation, not just
+        one like the IOError, and the MRO would by default call the
+        __reduce__ method from the IOError due to the inheritance order.
+        """
+        return CompatJSONDecodeError.__reduce__(self)
+
 
 class HTTPError(RequestException):
     """An HTTP error occurred."""
diff --git a/lib/requests/models.py b/lib/requests/models.py
index 617a4134..8f56ca7d 100644
--- a/lib/requests/models.py
+++ b/lib/requests/models.py
@@ -170,7 +170,7 @@ class RequestEncodingMixin:
                         )
                     )
 
-        for (k, v) in files:
+        for k, v in files:
             # support for explicit filename
             ft = None
             fh = None
@@ -268,7 +268,6 @@ class Request(RequestHooksMixin):
         hooks=None,
         json=None,
     ):
-
         # Default empty dicts for dict params.
         data = [] if data is None else data
         files = [] if files is None else files
@@ -277,7 +276,7 @@ class Request(RequestHooksMixin):
         hooks = {} if hooks is None else hooks
 
         self.hooks = default_hooks()
-        for (k, v) in list(hooks.items()):
+        for k, v in list(hooks.items()):
             self.register_hook(event=k, hook=v)
 
         self.method = method
@@ -790,7 +789,12 @@ class Response:
     @property
     def apparent_encoding(self):
         """The apparent encoding, provided by the charset_normalizer or chardet libraries."""
-        return chardet.detect(self.content)["encoding"]
+        if chardet is not None:
+            return chardet.detect(self.content)["encoding"]
+        else:
+            # If no character detection library is available, we'll fall back
+            # to a standard Python utf-8 str.
+            return "utf-8"
 
     def iter_content(self, chunk_size=1, decode_unicode=False):
         """Iterates over the response data.  When stream=True is set on the
@@ -865,7 +869,6 @@ class Response:
         for chunk in self.iter_content(
             chunk_size=chunk_size, decode_unicode=decode_unicode
         ):
-
             if pending is not None:
                 chunk = pending + chunk
 
diff --git a/lib/requests/packages.py b/lib/requests/packages.py
index 77c45c9e..5ab3d8e2 100644
--- a/lib/requests/packages.py
+++ b/lib/requests/packages.py
@@ -1,13 +1,6 @@
 import sys
 
-try:
-    import chardet
-except ImportError:
-    import warnings
-
-    import charset_normalizer as chardet
-
-    warnings.filterwarnings("ignore", "Trying to detect", module="charset_normalizer")
+from .compat import chardet
 
 # This code exists for backwards compatibility reasons.
 # I don't like it either. Just look the other way. :)
@@ -20,9 +13,11 @@ for package in ("urllib3", "idna"):
         if mod == package or mod.startswith(f"{package}."):
             sys.modules[f"requests.packages.{mod}"] = sys.modules[mod]
 
-target = chardet.__name__
-for mod in list(sys.modules):
-    if mod == target or mod.startswith(f"{target}."):
-        target = target.replace(target, "chardet")
-        sys.modules[f"requests.packages.{target}"] = sys.modules[mod]
-# Kinda cool, though, right?
+if chardet is not None:
+    target = chardet.__name__
+    for mod in list(sys.modules):
+        if mod == target or mod.startswith(f"{target}."):
+            imported_mod = sys.modules[mod]
+            sys.modules[f"requests.packages.{mod}"] = imported_mod
+            mod = mod.replace(target, "chardet")
+            sys.modules[f"requests.packages.{mod}"] = imported_mod
diff --git a/lib/requests/sessions.py b/lib/requests/sessions.py
index dbcf2a7b..b387bc36 100644
--- a/lib/requests/sessions.py
+++ b/lib/requests/sessions.py
@@ -262,7 +262,6 @@ class SessionRedirectMixin:
             if yield_requests:
                 yield req
             else:
-
                 resp = self.send(
                     req,
                     stream=stream,
@@ -326,7 +325,7 @@ class SessionRedirectMixin:
 
         # urllib3 handles proxy authorization for us in the standard adapter.
         # Avoid appending this to TLS tunneled requests where it may be leaked.
-        if not scheme.startswith('https') and username and password:
+        if not scheme.startswith("https") and username and password:
             headers["Proxy-Authorization"] = _basic_auth_str(username, password)
 
         return new_proxies
@@ -389,7 +388,6 @@ class Session(SessionRedirectMixin):
     ]
 
     def __init__(self):
-
         #: A case-insensitive dictionary of headers to be sent on each
         #: :class:`Request <Request>` sent from this
         #: :class:`Session <Session>`.
@@ -545,6 +543,8 @@ class Session(SessionRedirectMixin):
         :type allow_redirects: bool
         :param proxies: (optional) Dictionary mapping protocol or protocol and
             hostname to the URL of the proxy.
+        :param hooks: (optional) Dictionary mapping hook name to one event or
+            list of events, event must be callable.
         :param stream: (optional) whether to immediately download the response
             content. Defaults to ``False``.
         :param verify: (optional) Either a boolean, in which case it controls whether we verify
@@ -711,7 +711,6 @@ class Session(SessionRedirectMixin):
 
         # Persist cookies
         if r.history:
-
             # If the hooks create history then we want those cookies too
             for resp in r.history:
                 extract_cookies_to_jar(self.cookies, resp.request, resp.raw)
@@ -759,7 +758,7 @@ class Session(SessionRedirectMixin):
             # Set environment's proxies.
             no_proxy = proxies.get("no_proxy") if proxies is not None else None
             env_proxies = get_environ_proxies(url, no_proxy=no_proxy)
-            for (k, v) in env_proxies.items():
+            for k, v in env_proxies.items():
                 proxies.setdefault(k, v)
 
             # Look for requests environment configuration
@@ -785,8 +784,7 @@ class Session(SessionRedirectMixin):
 
         :rtype: requests.adapters.BaseAdapter
         """
-        for (prefix, adapter) in self.adapters.items():
-
+        for prefix, adapter in self.adapters.items():
             if url.lower().startswith(prefix.lower()):
                 return adapter
 
diff --git a/lib/requests/status_codes.py b/lib/requests/status_codes.py
index 4bd072be..c7945a2f 100644
--- a/lib/requests/status_codes.py
+++ b/lib/requests/status_codes.py
@@ -24,7 +24,7 @@ _codes = {
     # Informational.
     100: ("continue",),
     101: ("switching_protocols",),
-    102: ("processing",),
+    102: ("processing", "early-hints"),
     103: ("checkpoint",),
     122: ("uri_too_long", "request_uri_too_long"),
     200: ("ok", "okay", "all_ok", "all_okay", "all_good", "\\o/", "✓"),
@@ -65,8 +65,8 @@ _codes = {
     410: ("gone",),
     411: ("length_required",),
     412: ("precondition_failed", "precondition"),
-    413: ("request_entity_too_large",),
-    414: ("request_uri_too_large",),
+    413: ("request_entity_too_large", "content_too_large"),
+    414: ("request_uri_too_large", "uri_too_long"),
     415: ("unsupported_media_type", "unsupported_media", "media_type"),
     416: (
         "requested_range_not_satisfiable",
@@ -76,10 +76,10 @@ _codes = {
     417: ("expectation_failed",),
     418: ("im_a_teapot", "teapot", "i_am_a_teapot"),
     421: ("misdirected_request",),
-    422: ("unprocessable_entity", "unprocessable"),
+    422: ("unprocessable_entity", "unprocessable", "unprocessable_content"),
     423: ("locked",),
     424: ("failed_dependency", "dependency"),
-    425: ("unordered_collection", "unordered"),
+    425: ("unordered_collection", "unordered", "too_early"),
     426: ("upgrade_required", "upgrade"),
     428: ("precondition_required", "precondition"),
     429: ("too_many_requests", "too_many"),
diff --git a/lib/requests/utils.py b/lib/requests/utils.py
index a367417f..ae6c42f6 100644
--- a/lib/requests/utils.py
+++ b/lib/requests/utils.py
@@ -97,6 +97,8 @@ if sys.platform == "win32":
         # '<local>' string by the localhost entry and the corresponding
         # canonical entry.
         proxyOverride = proxyOverride.split(";")
+        # filter out empty strings to avoid re.match return true in the following code.
+        proxyOverride = filter(None, proxyOverride)
         # now check if we match one of the registry values.
         for test in proxyOverride:
             if test == "<local>":
@@ -134,6 +136,9 @@ def super_len(o):
     total_length = None
     current_position = 0
 
+    if isinstance(o, str):
+        o = o.encode("utf-8")
+
     if hasattr(o, "__len__"):
         total_length = len(o)
 
@@ -466,11 +471,7 @@ def dict_from_cookiejar(cj):
     :rtype: dict
     """
 
-    cookie_dict = {}
-
-    for cookie in cj:
-        cookie_dict[cookie.name] = cookie.value
-
+    cookie_dict = {cookie.name: cookie.value for cookie in cj}
     return cookie_dict
 
 
@@ -767,6 +768,7 @@ def should_bypass_proxies(url, no_proxy):
 
     :rtype: bool
     """
+
     # Prioritize lowercase environment variables over uppercase
     # to keep a consistent behaviour with other http projects (curl, wget).
     def get_proxy(key):
@@ -862,7 +864,7 @@ def select_proxy(url, proxies):
 def resolve_proxies(request, proxies, trust_env=True):
     """This method takes proxy information from a request and configuration
     input to resolve a mapping of target proxies. This will consider settings
-    such a NO_PROXY to strip proxy configurations.
+    such as NO_PROXY to strip proxy configurations.
 
     :param request: Request or PreparedRequest
     :param proxies: A dictionary of schemes or schemes and hosts to proxy URLs
@@ -1054,7 +1056,7 @@ def _validate_header_part(header, header_part, header_validator_index):
     if not validator.match(header_part):
         header_kind = "name" if header_validator_index == 0 else "value"
         raise InvalidHeader(
-            f"Invalid leading whitespace, reserved character(s), or return"
+            f"Invalid leading whitespace, reserved character(s), or return "
             f"character(s) in header {header_kind}: {header_part!r}"
         )
 
diff --git a/requirements.txt b/requirements.txt
index 6edced4e..5e3825d1 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -34,7 +34,7 @@ pyparsing==3.1.2
 python-dateutil==2.9.0.post0
 python-twitter==3.5
 pytz==2024.1
-requests==2.31.0
+requests==2.32.3
 requests-oauthlib==2.0.0
 rumps==0.4.0; platform_system == "Darwin"
 simplejson==3.19.2

From afa25d45f67cb26191f248e94f2de313775ae829 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 19 Jun 2024 00:01:47 -0700
Subject: [PATCH 619/743] Bump certifi from 2024.2.2 to 2024.6.2 (#2342)

* Bump certifi from 2024.2.2 to 2024.6.2

Bumps [certifi](https://github.com/certifi/python-certifi) from 2024.2.2 to 2024.6.2.
- [Commits](https://github.com/certifi/python-certifi/compare/2024.02.02...2024.06.02)

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

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

* Update certifi==2024.6.2

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/certifi/__init__.py |  2 +-
 lib/certifi/cacert.pem  | 24 ++++++++++++++++++++++++
 requirements.txt        |  2 +-
 3 files changed, 26 insertions(+), 2 deletions(-)

diff --git a/lib/certifi/__init__.py b/lib/certifi/__init__.py
index 1c91f3ec..62b27b63 100644
--- a/lib/certifi/__init__.py
+++ b/lib/certifi/__init__.py
@@ -1,4 +1,4 @@
 from .core import contents, where
 
 __all__ = ["contents", "where"]
-__version__ = "2024.02.02"
+__version__ = "2024.06.02"
diff --git a/lib/certifi/cacert.pem b/lib/certifi/cacert.pem
index fac3c319..6e1f1a67 100644
--- a/lib/certifi/cacert.pem
+++ b/lib/certifi/cacert.pem
@@ -4812,3 +4812,27 @@ X273CXE2whJdV/LItM3z7gLfEdxquVeEHVlNjM7IDiPCtyaaEBRx/pOyiriA8A4Q
 ntOoUAw3gi/q4Iqd4Sw5/7W0cwDk90imc6y/st53BIe0o82bNSQ3+pCTE4FCxpgm
 dTdmQRCsu/WU48IxK63nI1bMNSWSs1A=
 -----END CERTIFICATE-----
+
+# Issuer: CN=FIRMAPROFESIONAL CA ROOT-A WEB O=Firmaprofesional SA
+# Subject: CN=FIRMAPROFESIONAL CA ROOT-A WEB O=Firmaprofesional SA
+# Label: "FIRMAPROFESIONAL CA ROOT-A WEB"
+# Serial: 65916896770016886708751106294915943533
+# MD5 Fingerprint: 82:b2:ad:45:00:82:b0:66:63:f8:5f:c3:67:4e:ce:a3
+# SHA1 Fingerprint: a8:31:11:74:a6:14:15:0d:ca:77:dd:0e:e4:0c:5d:58:fc:a0:72:a5
+# SHA256 Fingerprint: be:f2:56:da:f2:6e:9c:69:bd:ec:16:02:35:97:98:f3:ca:f7:18:21:a0:3e:01:82:57:c5:3c:65:61:7f:3d:4a
+-----BEGIN CERTIFICATE-----
+MIICejCCAgCgAwIBAgIQMZch7a+JQn81QYehZ1ZMbTAKBggqhkjOPQQDAzBuMQsw
+CQYDVQQGEwJFUzEcMBoGA1UECgwTRmlybWFwcm9mZXNpb25hbCBTQTEYMBYGA1UE
+YQwPVkFURVMtQTYyNjM0MDY4MScwJQYDVQQDDB5GSVJNQVBST0ZFU0lPTkFMIENB
+IFJPT1QtQSBXRUIwHhcNMjIwNDA2MDkwMTM2WhcNNDcwMzMxMDkwMTM2WjBuMQsw
+CQYDVQQGEwJFUzEcMBoGA1UECgwTRmlybWFwcm9mZXNpb25hbCBTQTEYMBYGA1UE
+YQwPVkFURVMtQTYyNjM0MDY4MScwJQYDVQQDDB5GSVJNQVBST0ZFU0lPTkFMIENB
+IFJPT1QtQSBXRUIwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAARHU+osEaR3xyrq89Zf
+e9MEkVz6iMYiuYMQYneEMy3pA4jU4DP37XcsSmDq5G+tbbT4TIqk5B/K6k84Si6C
+cyvHZpsKjECcfIr28jlgst7L7Ljkb+qbXbdTkBgyVcUgt5SjYzBhMA8GA1UdEwEB
+/wQFMAMBAf8wHwYDVR0jBBgwFoAUk+FDY1w8ndYn81LsF7Kpryz3dvgwHQYDVR0O
+BBYEFJPhQ2NcPJ3WJ/NS7Beyqa8s93b4MA4GA1UdDwEB/wQEAwIBBjAKBggqhkjO
+PQQDAwNoADBlAjAdfKR7w4l1M+E7qUW/Runpod3JIha3RxEL2Jq68cgLcFBTApFw
+hVmpHqTm6iMxoAACMQD94vizrxa5HnPEluPBMBnYfubDl94cT7iJLzPrSA8Z94dG
+XSaQpYXFuXqUPoeovQA=
+-----END CERTIFICATE-----
diff --git a/requirements.txt b/requirements.txt
index 5e3825d1..a0c32ad9 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -3,7 +3,7 @@ arrow==1.3.0
 backports.zoneinfo==0.2.1;python_version<"3.9"
 beautifulsoup4==4.12.3
 bleach==6.1.0
-certifi==2024.2.2
+certifi==2024.6.2
 cheroot==10.0.1
 cherrypy==18.9.0
 cloudinary==1.40.0

From 5e977c044ae65ad32304a6e1f28480967bcd7ac2 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 19 Jun 2024 00:02:06 -0700
Subject: [PATCH 620/743] Bump zipp from 3.18.2 to 3.19.2 (#2343)

* Bump zipp from 3.18.2 to 3.19.2

Bumps [zipp](https://github.com/jaraco/zipp) from 3.18.2 to 3.19.2.
- [Release notes](https://github.com/jaraco/zipp/releases)
- [Changelog](https://github.com/jaraco/zipp/blob/main/NEWS.rst)
- [Commits](https://github.com/jaraco/zipp/compare/v3.18.2...v3.19.2)

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

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

* Update zipp==3.19.2

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/zipp/__init__.py | 76 +++++++++++++++++++++++++++++++++++++++++---
 requirements.txt     |  2 +-
 2 files changed, 73 insertions(+), 5 deletions(-)

diff --git a/lib/zipp/__init__.py b/lib/zipp/__init__.py
index df3293aa..d65297b8 100644
--- a/lib/zipp/__init__.py
+++ b/lib/zipp/__init__.py
@@ -5,6 +5,7 @@ import itertools
 import contextlib
 import pathlib
 import re
+import stat
 import sys
 
 from .compat.py310 import text_encoding
@@ -85,7 +86,69 @@ class InitializedState:
         super().__init__(*args, **kwargs)
 
 
-class CompleteDirs(InitializedState, zipfile.ZipFile):
+class SanitizedNames:
+    """
+    ZipFile mix-in to ensure names are sanitized.
+    """
+
+    def namelist(self):
+        return list(map(self._sanitize, super().namelist()))
+
+    @staticmethod
+    def _sanitize(name):
+        r"""
+        Ensure a relative path with posix separators and no dot names.
+
+        Modeled after
+        https://github.com/python/cpython/blob/bcc1be39cb1d04ad9fc0bd1b9193d3972835a57c/Lib/zipfile/__init__.py#L1799-L1813
+        but provides consistent cross-platform behavior.
+
+        >>> san = SanitizedNames._sanitize
+        >>> san('/foo/bar')
+        'foo/bar'
+        >>> san('//foo.txt')
+        'foo.txt'
+        >>> san('foo/.././bar.txt')
+        'foo/bar.txt'
+        >>> san('foo../.bar.txt')
+        'foo../.bar.txt'
+        >>> san('\\foo\\bar.txt')
+        'foo/bar.txt'
+        >>> san('D:\\foo.txt')
+        'D/foo.txt'
+        >>> san('\\\\server\\share\\file.txt')
+        'server/share/file.txt'
+        >>> san('\\\\?\\GLOBALROOT\\Volume3')
+        '?/GLOBALROOT/Volume3'
+        >>> san('\\\\.\\PhysicalDrive1\\root')
+        'PhysicalDrive1/root'
+
+        Retain any trailing slash.
+        >>> san('abc/')
+        'abc/'
+
+        Raises a ValueError if the result is empty.
+        >>> san('../..')
+        Traceback (most recent call last):
+        ...
+        ValueError: Empty filename
+        """
+
+        def allowed(part):
+            return part and part not in {'..', '.'}
+
+        # Remove the drive letter.
+        # Don't use ntpath.splitdrive, because that also strips UNC paths
+        bare = re.sub('^([A-Z]):', r'\1', name, flags=re.IGNORECASE)
+        clean = bare.replace('\\', '/')
+        parts = clean.split('/')
+        joined = '/'.join(filter(allowed, parts))
+        if not joined:
+            raise ValueError("Empty filename")
+        return joined + '/' * name.endswith('/')
+
+
+class CompleteDirs(InitializedState, SanitizedNames, zipfile.ZipFile):
     """
     A ZipFile subclass that ensures that implied directories
     are always included in the namelist.
@@ -188,7 +251,10 @@ def _extract_text_encoding(encoding=None, *args, **kwargs):
 
 class Path:
     """
-    A pathlib-compatible interface for zip files.
+    A :class:`importlib.resources.abc.Traversable` interface for zip files.
+
+    Implements many of the features users enjoy from
+    :class:`pathlib.Path`.
 
     Consider a zip file with this structure::
 
@@ -391,9 +457,11 @@ class Path:
 
     def is_symlink(self):
         """
-        Return whether this path is a symlink. Always false (python/cpython#82102).
+        Return whether this path is a symlink.
         """
-        return False
+        info = self.root.getinfo(self.at)
+        mode = info.external_attr >> 16
+        return stat.S_ISLNK(mode)
 
     def glob(self, pattern):
         if not pattern:
diff --git a/requirements.txt b/requirements.txt
index a0c32ad9..7d8c9cb7 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -47,7 +47,7 @@ urllib3<2
 webencodings==0.5.1
 websocket-client==1.8.0
 xmltodict==0.13.0
-zipp==3.18.2
+zipp==3.19.2
 
 # configobj==5.1.0
 # sgmllib3k==1.0.0

From a528f052b99200ffe7ba30fda14e35ac6dcf7400 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 19 Jun 2024 00:02:35 -0700
Subject: [PATCH 621/743] Bump cherrypy from 18.9.0 to 18.10.0 (#2353)

* Bump cherrypy from 18.9.0 to 18.10.0

Bumps [cherrypy](https://github.com/cherrypy/cherrypy) from 18.9.0 to 18.10.0.
- [Changelog](https://github.com/cherrypy/cherrypy/blob/main/CHANGES.rst)
- [Commits](https://github.com/cherrypy/cherrypy/compare/v18.9.0...v18.10.0)

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

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

* Update cherrypy==18.10.0

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/backports/__init__.py                     |   2 +-
 lib/backports/tarfile/__init__.py             | 125 +++--
 lib/cherrypy/__init__.py                      |  40 +-
 lib/cherrypy/_cpchecker.py                    |   5 +-
 lib/cherrypy/_cpconfig.py                     |   7 +-
 lib/cherrypy/_cpdispatch.py                   |  54 +-
 lib/cherrypy/_cperror.py                      |  44 +-
 lib/cherrypy/_cplogging.py                    |  19 +-
 lib/cherrypy/_cpmodpy.py                      |   2 +-
 lib/cherrypy/_cpnative_server.py              |   8 +-
 lib/cherrypy/_cpreqbody.py                    |  45 +-
 lib/cherrypy/_cprequest.py                    | 201 ++++---
 lib/cherrypy/_cpserver.py                     |  36 +-
 lib/cherrypy/_cptools.py                      |  47 +-
 lib/cherrypy/_cptree.py                       |  50 +-
 lib/cherrypy/_cpwsgi.py                       |  60 ++-
 lib/cherrypy/_cpwsgi_server.py                |  15 +-
 lib/cherrypy/_helper.py                       |  18 +-
 lib/cherrypy/_json.py                         |   3 +-
 lib/cherrypy/lib/__init__.py                  |   4 +-
 lib/cherrypy/lib/auth_basic.py                |   1 -
 lib/cherrypy/lib/auth_digest.py               |  28 +-
 lib/cherrypy/lib/caching.py                   |  19 +-
 lib/cherrypy/lib/covercp.py                   |   6 +-
 lib/cherrypy/lib/cpstats.py                   |   7 +-
 lib/cherrypy/lib/cptools.py                   |  61 ++-
 lib/cherrypy/lib/encoding.py                  |   5 +-
 lib/cherrypy/lib/gctools.py                   |   2 -
 lib/cherrypy/lib/headers.py                   |  39 ++
 lib/cherrypy/lib/httputil.py                  |  33 +-
 lib/cherrypy/lib/locking.py                   |  20 +-
 lib/cherrypy/lib/profiler.py                  |   1 -
 lib/cherrypy/lib/reprconf.py                  |  25 +-
 lib/cherrypy/lib/sessions.py                  |  38 +-
 lib/cherrypy/lib/static.py                    |  16 +-
 lib/cherrypy/process/plugins.py               |  54 +-
 lib/cherrypy/process/servers.py               |   8 +-
 lib/cherrypy/process/win32.py                 |  12 +-
 lib/cherrypy/process/wspbus.py                |  57 +-
 lib/cherrypy/scaffold/__init__.py             |   1 -
 lib/cherrypy/test/__init__.py                 |   4 +-
 lib/cherrypy/test/_test_decorators.py         |   2 +-
 lib/cherrypy/test/benchmark.py                | 135 +++--
 lib/cherrypy/test/checkerdemo.py              |   6 +-
 lib/cherrypy/test/helper.py                   |  28 +-
 lib/cherrypy/test/logtest.py                  |  34 +-
 lib/cherrypy/test/modwsgi.py                  |   1 -
 lib/cherrypy/test/sessiondemo.py              |   8 +-
 lib/cherrypy/test/test_core.py                |   2 -
 .../test/test_dynamicobjectmapping.py         |  24 +-
 lib/cherrypy/test/test_http.py                |  12 +-
 lib/cherrypy/test/test_logging.py             |   4 +-
 lib/cherrypy/test/test_plugins.py             |   3 +-
 lib/cherrypy/test/test_request_obj.py         |   5 +-
 lib/cherrypy/test/test_session.py             |  15 +-
 lib/cherrypy/test/test_states.py              |  13 +-
 lib/cherrypy/test/test_tools.py               |   4 +-
 lib/cherrypy/test/test_tutorials.py           |   8 +-
 lib/cherrypy/test/test_wsgi_unix_socket.py    |   4 +-
 lib/cherrypy/tutorial/tut01_helloworld.py     |   3 +-
 lib/more_itertools/__init__.py                |   2 +-
 lib/more_itertools/more.py                    | 376 +++++++++----
 lib/more_itertools/more.pyi                   |  14 +
 lib/more_itertools/recipes.py                 |  76 ++-
 lib/more_itertools/recipes.pyi                |  10 +-
 lib/tempora/schedule.py                       |  53 +-
 lib/tempora/utc.py                            |  12 +-
 lib/typeguard/_checkers.py                    | 117 +++-
 lib/typeguard/_pytest_plugin.py               |   9 +-
 lib/typeguard/_suppression.py                 |   2 +-
 lib/typeguard/_utils.py                       |  14 +-
 lib/typing_extensions.py                      | 501 ++++++++++++++----
 requirements.txt                              |   2 +-
 73 files changed, 1713 insertions(+), 1008 deletions(-)
 create mode 100644 lib/cherrypy/lib/headers.py

diff --git a/lib/backports/__init__.py b/lib/backports/__init__.py
index 8db66d3d..0d1f7edf 100644
--- a/lib/backports/__init__.py
+++ b/lib/backports/__init__.py
@@ -1 +1 @@
-__path__ = __import__("pkgutil").extend_path(__path__, __name__)
+__path__ = __import__('pkgutil').extend_path(__path__, __name__)  # type: ignore
diff --git a/lib/backports/tarfile/__init__.py b/lib/backports/tarfile/__init__.py
index 6dd498dc..8c16881c 100644
--- a/lib/backports/tarfile/__init__.py
+++ b/lib/backports/tarfile/__init__.py
@@ -1,4 +1,3 @@
-#!/usr/bin/env python3
 #-------------------------------------------------------------------
 # tarfile.py
 #-------------------------------------------------------------------
@@ -46,7 +45,6 @@ import time
 import struct
 import copy
 import re
-import warnings
 
 from .compat.py38 import removesuffix
 
@@ -639,6 +637,10 @@ class _FileInFile(object):
     def flush(self):
         pass
 
+    @property
+    def mode(self):
+        return 'rb'
+
     def readable(self):
         return True
 
@@ -875,7 +877,7 @@ class TarInfo(object):
         pax_headers = ('A dictionary containing key-value pairs of an '
                        'associated pax extended header.'),
         sparse = 'Sparse member information.',
-        tarfile = None,
+        _tarfile = None,
         _sparse_structs = None,
         _link_target = None,
         )
@@ -904,6 +906,24 @@ class TarInfo(object):
         self.sparse = None      # sparse member information
         self.pax_headers = {}   # pax header information
 
+    @property
+    def tarfile(self):
+        import warnings
+        warnings.warn(
+            'The undocumented "tarfile" attribute of TarInfo objects '
+            + 'is deprecated and will be removed in Python 3.16',
+            DeprecationWarning, stacklevel=2)
+        return self._tarfile
+
+    @tarfile.setter
+    def tarfile(self, tarfile):
+        import warnings
+        warnings.warn(
+            'The undocumented "tarfile" attribute of TarInfo objects '
+            + 'is deprecated and will be removed in Python 3.16',
+            DeprecationWarning, stacklevel=2)
+        self._tarfile = tarfile
+
     @property
     def path(self):
         'In pax headers, "name" is called "path".'
@@ -1198,7 +1218,7 @@ class TarInfo(object):
         for keyword, value in pax_headers.items():
             keyword = keyword.encode("utf-8")
             if binary:
-                # Try to restore the original byte representation of `value'.
+                # Try to restore the original byte representation of 'value'.
                 # Needless to say, that the encoding must match the string.
                 value = value.encode(encoding, "surrogateescape")
             else:
@@ -1643,14 +1663,14 @@ class TarFile(object):
     def __init__(self, name=None, mode="r", fileobj=None, format=None,
             tarinfo=None, dereference=None, ignore_zeros=None, encoding=None,
             errors="surrogateescape", pax_headers=None, debug=None,
-            errorlevel=None, copybufsize=None):
-        """Open an (uncompressed) tar archive `name'. `mode' is either 'r' to
+            errorlevel=None, copybufsize=None, stream=False):
+        """Open an (uncompressed) tar archive 'name'. 'mode' is either 'r' to
            read from an existing archive, 'a' to append data to an existing
-           file or 'w' to create a new file overwriting an existing one. `mode'
+           file or 'w' to create a new file overwriting an existing one. 'mode'
            defaults to 'r'.
-           If `fileobj' is given, it is used for reading or writing data. If it
-           can be determined, `mode' is overridden by `fileobj's mode.
-           `fileobj' is not closed, when TarFile is closed.
+           If 'fileobj' is given, it is used for reading or writing data. If it
+           can be determined, 'mode' is overridden by 'fileobj's mode.
+           'fileobj' is not closed, when TarFile is closed.
         """
         modes = {"r": "rb", "a": "r+b", "w": "wb", "x": "xb"}
         if mode not in modes:
@@ -1675,6 +1695,8 @@ class TarFile(object):
         self.name = os.path.abspath(name) if name else None
         self.fileobj = fileobj
 
+        self.stream = stream
+
         # Init attributes.
         if format is not None:
             self.format = format
@@ -1977,7 +1999,7 @@ class TarFile(object):
                 self.fileobj.close()
 
     def getmember(self, name):
-        """Return a TarInfo object for member ``name``. If ``name`` can not be
+        """Return a TarInfo object for member 'name'. If 'name' can not be
            found in the archive, KeyError is raised. If a member occurs more
            than once in the archive, its last occurrence is assumed to be the
            most up-to-date version.
@@ -2005,9 +2027,9 @@ class TarFile(object):
 
     def gettarinfo(self, name=None, arcname=None, fileobj=None):
         """Create a TarInfo object from the result of os.stat or equivalent
-           on an existing file. The file is either named by ``name``, or
-           specified as a file object ``fileobj`` with a file descriptor. If
-           given, ``arcname`` specifies an alternative name for the file in the
+           on an existing file. The file is either named by 'name', or
+           specified as a file object 'fileobj' with a file descriptor. If
+           given, 'arcname' specifies an alternative name for the file in the
            archive, otherwise, the name is taken from the 'name' attribute of
            'fileobj', or the 'name' argument. The name should be a text
            string.
@@ -2031,7 +2053,7 @@ class TarFile(object):
         # Now, fill the TarInfo object with
         # information specific for the file.
         tarinfo = self.tarinfo()
-        tarinfo.tarfile = self  # Not needed
+        tarinfo._tarfile = self  # To be removed in 3.16.
 
         # Use os.stat or os.lstat, depending on if symlinks shall be resolved.
         if fileobj is None:
@@ -2103,11 +2125,15 @@ class TarFile(object):
         return tarinfo
 
     def list(self, verbose=True, *, members=None):
-        """Print a table of contents to sys.stdout. If ``verbose`` is False, only
-           the names of the members are printed. If it is True, an `ls -l'-like
-           output is produced. ``members`` is optional and must be a subset of the
+        """Print a table of contents to sys.stdout. If 'verbose' is False, only
+           the names of the members are printed. If it is True, an 'ls -l'-like
+           output is produced. 'members' is optional and must be a subset of the
            list returned by getmembers().
         """
+        # Convert tarinfo type to stat type.
+        type2mode = {REGTYPE: stat.S_IFREG, SYMTYPE: stat.S_IFLNK,
+                     FIFOTYPE: stat.S_IFIFO, CHRTYPE: stat.S_IFCHR,
+                     DIRTYPE: stat.S_IFDIR, BLKTYPE: stat.S_IFBLK}
         self._check()
 
         if members is None:
@@ -2117,7 +2143,8 @@ class TarFile(object):
                 if tarinfo.mode is None:
                     _safe_print("??????????")
                 else:
-                    _safe_print(stat.filemode(tarinfo.mode))
+                    modetype = type2mode.get(tarinfo.type, 0)
+                    _safe_print(stat.filemode(modetype | tarinfo.mode))
                 _safe_print("%s/%s" % (tarinfo.uname or tarinfo.uid,
                                        tarinfo.gname or tarinfo.gid))
                 if tarinfo.ischr() or tarinfo.isblk():
@@ -2141,11 +2168,11 @@ class TarFile(object):
             print()
 
     def add(self, name, arcname=None, recursive=True, *, filter=None):
-        """Add the file ``name`` to the archive. ``name`` may be any type of file
-           (directory, fifo, symbolic link, etc.). If given, ``arcname``
+        """Add the file 'name' to the archive. 'name' may be any type of file
+           (directory, fifo, symbolic link, etc.). If given, 'arcname'
            specifies an alternative name for the file in the archive.
            Directories are added recursively by default. This can be avoided by
-           setting ``recursive`` to False. ``filter`` is a function
+           setting 'recursive' to False. 'filter' is a function
            that expects a TarInfo object argument and returns the changed
            TarInfo object, if it returns None the TarInfo object will be
            excluded from the archive.
@@ -2192,13 +2219,16 @@ class TarFile(object):
             self.addfile(tarinfo)
 
     def addfile(self, tarinfo, fileobj=None):
-        """Add the TarInfo object ``tarinfo`` to the archive. If ``fileobj`` is
-           given, it should be a binary file, and tarinfo.size bytes are read
-           from it and added to the archive. You can create TarInfo objects
-           directly, or by using gettarinfo().
+        """Add the TarInfo object 'tarinfo' to the archive. If 'tarinfo' represents
+           a non zero-size regular file, the 'fileobj' argument should be a binary file,
+           and tarinfo.size bytes are read from it and added to the archive.
+           You can create TarInfo objects directly, or by using gettarinfo().
         """
         self._check("awx")
 
+        if fileobj is None and tarinfo.isreg() and tarinfo.size != 0:
+            raise ValueError("fileobj not provided for non zero-size regular file")
+
         tarinfo = copy.copy(tarinfo)
 
         buf = tarinfo.tobuf(self.format, self.encoding, self.errors)
@@ -2220,11 +2250,12 @@ class TarFile(object):
         if filter is None:
             filter = self.extraction_filter
             if filter is None:
+                import warnings
                 warnings.warn(
                     'Python 3.14 will, by default, filter extracted tar '
                     + 'archives and reject files or modify their metadata. '
                     + 'Use the filter argument to control this behavior.',
-                    DeprecationWarning)
+                    DeprecationWarning, stacklevel=3)
                 return fully_trusted_filter
             if isinstance(filter, str):
                 raise TypeError(
@@ -2243,12 +2274,12 @@ class TarFile(object):
                    filter=None):
         """Extract all members from the archive to the current working
            directory and set owner, modification time and permissions on
-           directories afterwards. `path' specifies a different directory
-           to extract to. `members' is optional and must be a subset of the
-           list returned by getmembers(). If `numeric_owner` is True, only
+           directories afterwards. 'path' specifies a different directory
+           to extract to. 'members' is optional and must be a subset of the
+           list returned by getmembers(). If 'numeric_owner' is True, only
            the numbers for user/group names are used and not the names.
 
-           The `filter` function will be called on each member just
+           The 'filter' function will be called on each member just
            before extraction.
            It can return a changed TarInfo or None to skip the member.
            String names of common filters are accepted.
@@ -2288,13 +2319,13 @@ class TarFile(object):
                 filter=None):
         """Extract a member from the archive to the current working directory,
            using its full name. Its file information is extracted as accurately
-           as possible. `member' may be a filename or a TarInfo object. You can
-           specify a different directory using `path'. File attributes (owner,
-           mtime, mode) are set unless `set_attrs' is False. If `numeric_owner`
+           as possible. 'member' may be a filename or a TarInfo object. You can
+           specify a different directory using 'path'. File attributes (owner,
+           mtime, mode) are set unless 'set_attrs' is False. If 'numeric_owner'
            is True, only the numbers for user/group names are used and not
            the names.
 
-           The `filter` function will be called before extraction.
+           The 'filter' function will be called before extraction.
            It can return a changed TarInfo or None to skip the member.
            String names of common filters are accepted.
         """
@@ -2359,10 +2390,10 @@ class TarFile(object):
             self._dbg(1, "tarfile: %s %s" % (type(e).__name__, e))
 
     def extractfile(self, member):
-        """Extract a member from the archive as a file object. ``member`` may be
-           a filename or a TarInfo object. If ``member`` is a regular file or
+        """Extract a member from the archive as a file object. 'member' may be
+           a filename or a TarInfo object. If 'member' is a regular file or
            a link, an io.BufferedReader object is returned. For all other
-           existing members, None is returned. If ``member`` does not appear
+           existing members, None is returned. If 'member' does not appear
            in the archive, KeyError is raised.
         """
         self._check("r")
@@ -2406,7 +2437,7 @@ class TarFile(object):
         if upperdirs and not os.path.exists(upperdirs):
             # Create directories that are not part of the archive with
             # default permissions.
-            os.makedirs(upperdirs)
+            os.makedirs(upperdirs, exist_ok=True)
 
         if tarinfo.islnk() or tarinfo.issym():
             self._dbg(1, "%s -> %s" % (tarinfo.name, tarinfo.linkname))
@@ -2559,7 +2590,8 @@ class TarFile(object):
                     os.lchown(targetpath, u, g)
                 else:
                     os.chown(targetpath, u, g)
-            except OSError as e:
+            except (OSError, OverflowError) as e:
+                # OverflowError can be raised if an ID doesn't fit in 'id_t'
                 raise ExtractError("could not change owner") from e
 
     def chmod(self, tarinfo, targetpath):
@@ -2642,7 +2674,9 @@ class TarFile(object):
             break
 
         if tarinfo is not None:
-            self.members.append(tarinfo)
+            # if streaming the file we do not want to cache the tarinfo
+            if not self.stream:
+                self.members.append(tarinfo)
         else:
             self._loaded = True
 
@@ -2693,11 +2727,12 @@ class TarFile(object):
 
     def _load(self):
         """Read through the entire archive file and look for readable
-           members.
+           members. This should not run if the file is set to stream.
         """
-        while self.next() is not None:
-            pass
-        self._loaded = True
+        if not self.stream:
+            while self.next() is not None:
+                pass
+            self._loaded = True
 
     def _check(self, mode=None):
         """Check if TarFile is still open, and if the operation's mode
diff --git a/lib/cherrypy/__init__.py b/lib/cherrypy/__init__.py
index 8e27c812..49e955f8 100644
--- a/lib/cherrypy/__init__.py
+++ b/lib/cherrypy/__init__.py
@@ -57,9 +57,11 @@ These API's are described in the `CherryPy specification
 """
 
 try:
-    import pkg_resources
+    import importlib.metadata as importlib_metadata
 except ImportError:
-    pass
+    # fall back for python <= 3.7
+    # This try/except can be removed with py <= 3.7 support
+    import importlib_metadata
 
 from threading import local as _local
 
@@ -109,7 +111,7 @@ tree = _cptree.Tree()
 
 
 try:
-    __version__ = pkg_resources.require('cherrypy')[0].version
+    __version__ = importlib_metadata.version('cherrypy')
 except Exception:
     __version__ = 'unknown'
 
@@ -181,24 +183,28 @@ def quickstart(root=None, script_name='', config=None):
 class _Serving(_local):
     """An interface for registering request and response objects.
 
-    Rather than have a separate "thread local" object for the request and
-    the response, this class works as a single threadlocal container for
-    both objects (and any others which developers wish to define). In this
-    way, we can easily dump those objects when we stop/start a new HTTP
-    conversation, yet still refer to them as module-level globals in a
-    thread-safe way.
+    Rather than have a separate "thread local" object for the request
+    and the response, this class works as a single threadlocal container
+    for both objects (and any others which developers wish to define).
+    In this way, we can easily dump those objects when we stop/start a
+    new HTTP conversation, yet still refer to them as module-level
+    globals in a thread-safe way.
     """
 
     request = _cprequest.Request(_httputil.Host('127.0.0.1', 80),
                                  _httputil.Host('127.0.0.1', 1111))
+    """The request object for the current thread.
+
+    In the main thread, and any threads which are not receiving HTTP
+    requests, this is None.
     """
-    The request object for the current thread. In the main thread,
-    and any threads which are not receiving HTTP requests, this is None."""
 
     response = _cprequest.Response()
+    """The response object for the current thread.
+
+    In the main thread, and any threads which are not receiving HTTP
+    requests, this is None.
     """
-    The response object for the current thread. In the main thread,
-    and any threads which are not receiving HTTP requests, this is None."""
 
     def load(self, request, response):
         self.request = request
@@ -316,8 +322,8 @@ class _GlobalLogManager(_cplogging.LogManager):
     def __call__(self, *args, **kwargs):
         """Log the given message to the app.log or global log.
 
-        Log the given message to the app.log or global
-        log as appropriate.
+        Log the given message to the app.log or global log as
+        appropriate.
         """
         # Do NOT use try/except here. See
         # https://github.com/cherrypy/cherrypy/issues/945
@@ -330,8 +336,8 @@ class _GlobalLogManager(_cplogging.LogManager):
     def access(self):
         """Log an access message to the app.log or global log.
 
-        Log the given message to the app.log or global
-        log as appropriate.
+        Log the given message to the app.log or global log as
+        appropriate.
         """
         try:
             return request.app.log.access()
diff --git a/lib/cherrypy/_cpchecker.py b/lib/cherrypy/_cpchecker.py
index f26f319c..096b19c3 100644
--- a/lib/cherrypy/_cpchecker.py
+++ b/lib/cherrypy/_cpchecker.py
@@ -313,7 +313,10 @@ class Checker(object):
 
     # -------------------- Specific config warnings -------------------- #
     def check_localhost(self):
-        """Warn if any socket_host is 'localhost'. See #711."""
+        """Warn if any socket_host is 'localhost'.
+
+        See #711.
+        """
         for k, v in cherrypy.config.items():
             if k == 'server.socket_host' and v == 'localhost':
                 warnings.warn("The use of 'localhost' as a socket host can "
diff --git a/lib/cherrypy/_cpconfig.py b/lib/cherrypy/_cpconfig.py
index 8e3fd612..c22937d3 100644
--- a/lib/cherrypy/_cpconfig.py
+++ b/lib/cherrypy/_cpconfig.py
@@ -1,5 +1,4 @@
-"""
-Configuration system for CherryPy.
+"""Configuration system for CherryPy.
 
 Configuration in CherryPy is implemented via dictionaries. Keys are strings
 which name the mapped value, which may be of any type.
@@ -132,8 +131,8 @@ def _if_filename_register_autoreload(ob):
 def merge(base, other):
     """Merge one app config (from a dict, file, or filename) into another.
 
-    If the given config is a filename, it will be appended to
-    the list of files to monitor for "autoreload" changes.
+    If the given config is a filename, it will be appended to the list
+    of files to monitor for "autoreload" changes.
     """
     _if_filename_register_autoreload(other)
 
diff --git a/lib/cherrypy/_cpdispatch.py b/lib/cherrypy/_cpdispatch.py
index 5c506e99..5a3a8ad6 100644
--- a/lib/cherrypy/_cpdispatch.py
+++ b/lib/cherrypy/_cpdispatch.py
@@ -1,9 +1,10 @@
 """CherryPy dispatchers.
 
 A 'dispatcher' is the object which looks up the 'page handler' callable
-and collects config for the current request based on the path_info, other
-request attributes, and the application architecture. The core calls the
-dispatcher as early as possible, passing it a 'path_info' argument.
+and collects config for the current request based on the path_info,
+other request attributes, and the application architecture. The core
+calls the dispatcher as early as possible, passing it a 'path_info'
+argument.
 
 The default dispatcher discovers the page handler by matching path_info
 to a hierarchical arrangement of objects, starting at request.app.root.
@@ -21,7 +22,6 @@ import cherrypy
 
 
 class PageHandler(object):
-
     """Callable which sets response.body."""
 
     def __init__(self, callable, *args, **kwargs):
@@ -64,8 +64,7 @@ class PageHandler(object):
 
 
 def test_callable_spec(callable, callable_args, callable_kwargs):
-    """
-    Inspect callable and test to see if the given args are suitable for it.
+    """Inspect callable and test to see if the given args are suitable for it.
 
     When an error occurs during the handler's invoking stage there are 2
     erroneous cases:
@@ -252,16 +251,16 @@ else:
 
 
 class Dispatcher(object):
-
     """CherryPy Dispatcher which walks a tree of objects to find a handler.
 
-    The tree is rooted at cherrypy.request.app.root, and each hierarchical
-    component in the path_info argument is matched to a corresponding nested
-    attribute of the root object. Matching handlers must have an 'exposed'
-    attribute which evaluates to True. The special method name "index"
-    matches a URI which ends in a slash ("/"). The special method name
-    "default" may match a portion of the path_info (but only when no longer
-    substring of the path_info matches some other object).
+    The tree is rooted at cherrypy.request.app.root, and each
+    hierarchical component in the path_info argument is matched to a
+    corresponding nested attribute of the root object. Matching handlers
+    must have an 'exposed' attribute which evaluates to True. The
+    special method name "index" matches a URI which ends in a slash
+    ("/"). The special method name "default" may match a portion of the
+    path_info (but only when no longer substring of the path_info
+    matches some other object).
 
     This is the default, built-in dispatcher for CherryPy.
     """
@@ -306,9 +305,9 @@ class Dispatcher(object):
 
         The second object returned will be a list of names which are
         'virtual path' components: parts of the URL which are dynamic,
-        and were not used when looking up the handler.
-        These virtual path components are passed to the handler as
-        positional arguments.
+        and were not used when looking up the handler. These virtual
+        path components are passed to the handler as positional
+        arguments.
         """
         request = cherrypy.serving.request
         app = request.app
@@ -448,13 +447,11 @@ class Dispatcher(object):
 
 
 class MethodDispatcher(Dispatcher):
-
     """Additional dispatch based on cherrypy.request.method.upper().
 
-    Methods named GET, POST, etc will be called on an exposed class.
-    The method names must be all caps; the appropriate Allow header
-    will be output showing all capitalized method names as allowable
-    HTTP verbs.
+    Methods named GET, POST, etc will be called on an exposed class. The
+    method names must be all caps; the appropriate Allow header will be
+    output showing all capitalized method names as allowable HTTP verbs.
 
     Note that the containing class must be exposed, not the methods.
     """
@@ -492,16 +489,14 @@ class MethodDispatcher(Dispatcher):
 
 
 class RoutesDispatcher(object):
-
     """A Routes based dispatcher for CherryPy."""
 
     def __init__(self, full_result=False, **mapper_options):
-        """
-        Routes dispatcher
+        """Routes dispatcher.
 
-        Set full_result to True if you wish the controller
-        and the action to be passed on to the page handler
-        parameters. By default they won't be.
+        Set full_result to True if you wish the controller and the
+        action to be passed on to the page handler parameters. By
+        default they won't be.
         """
         import routes
         self.full_result = full_result
@@ -617,8 +612,7 @@ def XMLRPCDispatcher(next_dispatcher=Dispatcher()):
 
 def VirtualHost(next_dispatcher=Dispatcher(), use_x_forwarded_host=True,
                 **domains):
-    """
-    Select a different handler based on the Host header.
+    """Select a different handler based on the Host header.
 
     This can be useful when running multiple sites within one CP server.
     It allows several domains to point to different parts of a single
diff --git a/lib/cherrypy/_cperror.py b/lib/cherrypy/_cperror.py
index f6ff2913..203fabf5 100644
--- a/lib/cherrypy/_cperror.py
+++ b/lib/cherrypy/_cperror.py
@@ -136,19 +136,17 @@ from cherrypy.lib import httputil as _httputil
 
 
 class CherryPyException(Exception):
-
     """A base class for CherryPy exceptions."""
     pass
 
 
 class InternalRedirect(CherryPyException):
-
     """Exception raised to switch to the handler for a different URL.
 
-    This exception will redirect processing to another path within the site
-    (without informing the client). Provide the new path as an argument when
-    raising the exception. Provide any params in the querystring for the new
-    URL.
+    This exception will redirect processing to another path within the
+    site (without informing the client). Provide the new path as an
+    argument when raising the exception. Provide any params in the
+    querystring for the new URL.
     """
 
     def __init__(self, path, query_string=''):
@@ -173,7 +171,6 @@ class InternalRedirect(CherryPyException):
 
 
 class HTTPRedirect(CherryPyException):
-
     """Exception raised when the request should be redirected.
 
     This exception will force a HTTP redirect to the URL or URL's you give it.
@@ -202,7 +199,7 @@ class HTTPRedirect(CherryPyException):
     """The list of URL's to emit."""
 
     encoding = 'utf-8'
-    """The encoding when passed urls are not native strings"""
+    """The encoding when passed urls are not native strings."""
 
     def __init__(self, urls, status=None, encoding=None):
         self.urls = abs_urls = [
@@ -230,8 +227,7 @@ class HTTPRedirect(CherryPyException):
 
     @classproperty
     def default_status(cls):
-        """
-        The default redirect status for the request.
+        """The default redirect status for the request.
 
         RFC 2616 indicates a 301 response code fits our goal; however,
         browser support for 301 is quite messy. Use 302/303 instead. See
@@ -249,8 +245,9 @@ class HTTPRedirect(CherryPyException):
         """Modify cherrypy.response status, headers, and body to represent
         self.
 
-        CherryPy uses this internally, but you can also use it to create an
-        HTTPRedirect object and set its output without *raising* the exception.
+        CherryPy uses this internally, but you can also use it to create
+        an HTTPRedirect object and set its output without *raising* the
+        exception.
         """
         response = cherrypy.serving.response
         response.status = status = self.status
@@ -339,7 +336,6 @@ def clean_headers(status):
 
 
 class HTTPError(CherryPyException):
-
     """Exception used to return an HTTP error code (4xx-5xx) to the client.
 
     This exception can be used to automatically send a response using a
@@ -358,7 +354,9 @@ class HTTPError(CherryPyException):
     """
 
     status = None
-    """The HTTP status code. May be of type int or str (with a Reason-Phrase).
+    """The HTTP status code.
+
+    May be of type int or str (with a Reason-Phrase).
     """
 
     code = None
@@ -386,8 +384,9 @@ class HTTPError(CherryPyException):
         """Modify cherrypy.response status, headers, and body to represent
         self.
 
-        CherryPy uses this internally, but you can also use it to create an
-        HTTPError object and set its output without *raising* the exception.
+        CherryPy uses this internally, but you can also use it to create
+        an HTTPError object and set its output without *raising* the
+        exception.
         """
         response = cherrypy.serving.response
 
@@ -426,11 +425,10 @@ class HTTPError(CherryPyException):
 
 
 class NotFound(HTTPError):
-
     """Exception raised when a URL could not be mapped to any handler (404).
 
-    This is equivalent to raising
-    :class:`HTTPError("404 Not Found") <cherrypy._cperror.HTTPError>`.
+    This is equivalent to raising :class:`HTTPError("404 Not Found")
+    <cherrypy._cperror.HTTPError>`.
     """
 
     def __init__(self, path=None):
@@ -477,8 +475,8 @@ _HTTPErrorTemplate = '''<!DOCTYPE html PUBLIC
 def get_error_page(status, **kwargs):
     """Return an HTML page, containing a pretty error response.
 
-    status should be an int or a str.
-    kwargs will be interpolated into the page template.
+    status should be an int or a str. kwargs will be interpolated into
+    the page template.
     """
     try:
         code, reason, message = _httputil.valid_status(status)
@@ -595,8 +593,8 @@ def bare_error(extrabody=None):
     """Produce status, headers, body for a critical error.
 
     Returns a triple without calling any other questionable functions,
-    so it should be as error-free as possible. Call it from an HTTP server
-    if you get errors outside of the request.
+    so it should be as error-free as possible. Call it from an HTTP
+    server if you get errors outside of the request.
 
     If extrabody is None, a friendly but rather unhelpful error message
     is set in the body. If extrabody is a string, it will be appended
diff --git a/lib/cherrypy/_cplogging.py b/lib/cherrypy/_cplogging.py
index bce1c87b..754ac7bf 100644
--- a/lib/cherrypy/_cplogging.py
+++ b/lib/cherrypy/_cplogging.py
@@ -123,7 +123,6 @@ logfmt = logging.Formatter('%(message)s')
 
 
 class NullHandler(logging.Handler):
-
     """A no-op logging handler to silence the logging.lastResort handler."""
 
     def handle(self, record):
@@ -137,15 +136,16 @@ class NullHandler(logging.Handler):
 
 
 class LogManager(object):
-
     """An object to assist both simple and advanced logging.
 
     ``cherrypy.log`` is an instance of this class.
     """
 
     appid = None
-    """The id() of the Application object which owns this log manager. If this
-    is a global log manager, appid is None."""
+    """The id() of the Application object which owns this log manager.
+
+    If this is a global log manager, appid is None.
+    """
 
     error_log = None
     """The actual :class:`logging.Logger` instance for error messages."""
@@ -317,8 +317,8 @@ class LogManager(object):
     def screen(self):
         """Turn stderr/stdout logging on or off.
 
-        If you set this to True, it'll add the appropriate StreamHandler for
-        you. If you set it to False, it will remove the handler.
+        If you set this to True, it'll add the appropriate StreamHandler
+        for you. If you set it to False, it will remove the handler.
         """
         h = self._get_builtin_handler
         has_h = h(self.error_log, 'screen') or h(self.access_log, 'screen')
@@ -414,7 +414,6 @@ class LogManager(object):
 
 
 class WSGIErrorHandler(logging.Handler):
-
     "A handler class which writes logging records to environ['wsgi.errors']."
 
     def flush(self):
@@ -452,6 +451,8 @@ class WSGIErrorHandler(logging.Handler):
 
 class LazyRfc3339UtcTime(object):
     def __str__(self):
-        """Return utcnow() in RFC3339 UTC Format."""
-        iso_formatted_now = datetime.datetime.utcnow().isoformat('T')
+        """Return datetime in RFC3339 UTC Format."""
+        iso_formatted_now = datetime.datetime.now(
+            datetime.timezone.utc,
+        ).isoformat('T')
         return f'{iso_formatted_now!s}Z'
diff --git a/lib/cherrypy/_cpmodpy.py b/lib/cherrypy/_cpmodpy.py
index a08f0ed9..7c01233d 100644
--- a/lib/cherrypy/_cpmodpy.py
+++ b/lib/cherrypy/_cpmodpy.py
@@ -1,4 +1,4 @@
-"""Native adapter for serving CherryPy via mod_python
+"""Native adapter for serving CherryPy via mod_python.
 
 Basic usage:
 
diff --git a/lib/cherrypy/_cpnative_server.py b/lib/cherrypy/_cpnative_server.py
index e9671d28..0dfc3682 100644
--- a/lib/cherrypy/_cpnative_server.py
+++ b/lib/cherrypy/_cpnative_server.py
@@ -120,10 +120,10 @@ class NativeGateway(cheroot.server.Gateway):
 class CPHTTPServer(cheroot.server.HTTPServer):
     """Wrapper for cheroot.server.HTTPServer.
 
-    cheroot has been designed to not reference CherryPy in any way,
-    so that it can be used in other frameworks and applications.
-    Therefore, we wrap it here, so we can apply some attributes
-    from config -> cherrypy.server -> HTTPServer.
+    cheroot has been designed to not reference CherryPy in any way, so
+    that it can be used in other frameworks and applications. Therefore,
+    we wrap it here, so we can apply some attributes from config ->
+    cherrypy.server -> HTTPServer.
     """
 
     def __init__(self, server_adapter=cherrypy.server):
diff --git a/lib/cherrypy/_cpreqbody.py b/lib/cherrypy/_cpreqbody.py
index 4d3cefe7..7e0d98be 100644
--- a/lib/cherrypy/_cpreqbody.py
+++ b/lib/cherrypy/_cpreqbody.py
@@ -248,7 +248,10 @@ def process_multipart_form_data(entity):
 
 
 def _old_process_multipart(entity):
-    """The behavior of 3.2 and lower. Deprecated and will be changed in 3.3."""
+    """The behavior of 3.2 and lower.
+
+    Deprecated and will be changed in 3.3.
+    """
     process_multipart(entity)
 
     params = entity.params
@@ -277,7 +280,6 @@ def _old_process_multipart(entity):
 
 # -------------------------------- Entities --------------------------------- #
 class Entity(object):
-
     """An HTTP request body, or MIME multipart body.
 
     This class collects information about the HTTP request entity. When a
@@ -346,13 +348,15 @@ class Entity(object):
     content_type = None
     """The value of the Content-Type request header.
 
-    If the Entity is part of a multipart payload, this will be the Content-Type
-    given in the MIME headers for this part.
+    If the Entity is part of a multipart payload, this will be the
+    Content-Type given in the MIME headers for this part.
     """
 
     default_content_type = 'application/x-www-form-urlencoded'
     """This defines a default ``Content-Type`` to use if no Content-Type header
-    is given. The empty string is used for RequestBody, which results in the
+    is given.
+
+    The empty string is used for RequestBody, which results in the
     request body not being read or parsed at all. This is by design; a missing
     ``Content-Type`` header in the HTTP request entity is an error at best,
     and a security hole at worst. For multipart parts, however, the MIME spec
@@ -402,8 +406,8 @@ class Entity(object):
     part_class = None
     """The class used for multipart parts.
 
-    You can replace this with custom subclasses to alter the processing of
-    multipart parts.
+    You can replace this with custom subclasses to alter the processing
+    of multipart parts.
     """
 
     def __init__(self, fp, headers, params=None, parts=None):
@@ -509,7 +513,8 @@ class Entity(object):
         """Return a file-like object into which the request body will be read.
 
         By default, this will return a TemporaryFile. Override as needed.
-        See also :attr:`cherrypy._cpreqbody.Part.maxrambytes`."""
+        See also :attr:`cherrypy._cpreqbody.Part.maxrambytes`.
+        """
         return tempfile.TemporaryFile()
 
     def fullvalue(self):
@@ -525,7 +530,7 @@ class Entity(object):
         return value
 
     def decode_entity(self, value):
-        """Return a given byte encoded value as a string"""
+        """Return a given byte encoded value as a string."""
         for charset in self.attempt_charsets:
             try:
                 value = value.decode(charset)
@@ -569,7 +574,6 @@ class Entity(object):
 
 
 class Part(Entity):
-
     """A MIME part entity, part of a multipart entity."""
 
     # "The default character set, which must be assumed in the absence of a
@@ -653,8 +657,8 @@ class Part(Entity):
     def read_lines_to_boundary(self, fp_out=None):
         """Read bytes from self.fp and return or write them to a file.
 
-        If the 'fp_out' argument is None (the default), all bytes read are
-        returned in a single byte string.
+        If the 'fp_out' argument is None (the default), all bytes read
+        are returned in a single byte string.
 
         If the 'fp_out' argument is not None, it must be a file-like
         object that supports the 'write' method; all bytes read will be
@@ -755,15 +759,15 @@ class SizedReader:
     def read(self, size=None, fp_out=None):
         """Read bytes from the request body and return or write them to a file.
 
-        A number of bytes less than or equal to the 'size' argument are read
-        off the socket. The actual number of bytes read are tracked in
-        self.bytes_read. The number may be smaller than 'size' when 1) the
-        client sends fewer bytes, 2) the 'Content-Length' request header
-        specifies fewer bytes than requested, or 3) the number of bytes read
-        exceeds self.maxbytes (in which case, 413 is raised).
+        A number of bytes less than or equal to the 'size' argument are
+        read off the socket. The actual number of bytes read are tracked
+        in self.bytes_read. The number may be smaller than 'size' when
+        1) the client sends fewer bytes, 2) the 'Content-Length' request
+        header specifies fewer bytes than requested, or 3) the number of
+        bytes read exceeds self.maxbytes (in which case, 413 is raised).
 
-        If the 'fp_out' argument is None (the default), all bytes read are
-        returned in a single byte string.
+        If the 'fp_out' argument is None (the default), all bytes read
+        are returned in a single byte string.
 
         If the 'fp_out' argument is not None, it must be a file-like
         object that supports the 'write' method; all bytes read will be
@@ -918,7 +922,6 @@ class SizedReader:
 
 
 class RequestBody(Entity):
-
     """The entity of the HTTP request."""
 
     bufsize = 8 * 1024
diff --git a/lib/cherrypy/_cprequest.py b/lib/cherrypy/_cprequest.py
index a661112c..a4ad298b 100644
--- a/lib/cherrypy/_cprequest.py
+++ b/lib/cherrypy/_cprequest.py
@@ -16,7 +16,6 @@ from cherrypy.lib import httputil, reprconf, encoding
 
 
 class Hook(object):
-
     """A callback and its metadata: failsafe, priority, and kwargs."""
 
     callback = None
@@ -30,10 +29,12 @@ class Hook(object):
     from the same call point raise exceptions."""
 
     priority = 50
+    """Defines the order of execution for a list of Hooks.
+
+    Priority numbers should be limited to the closed interval [0, 100],
+    but values outside this range are acceptable, as are fractional
+    values.
     """
-    Defines the order of execution for a list of Hooks. Priority numbers
-    should be limited to the closed interval [0, 100], but values outside
-    this range are acceptable, as are fractional values."""
 
     kwargs = {}
     """
@@ -74,7 +75,6 @@ class Hook(object):
 
 
 class HookMap(dict):
-
     """A map of call points to lists of callbacks (Hook objects)."""
 
     def __new__(cls, points=None):
@@ -190,23 +190,23 @@ hookpoints = ['on_start_resource', 'before_request_body',
 
 
 class Request(object):
-
     """An HTTP request.
 
-    This object represents the metadata of an HTTP request message;
-    that is, it contains attributes which describe the environment
-    in which the request URL, headers, and body were sent (if you
-    want tools to interpret the headers and body, those are elsewhere,
-    mostly in Tools). This 'metadata' consists of socket data,
-    transport characteristics, and the Request-Line. This object
-    also contains data regarding the configuration in effect for
-    the given URL, and the execution plan for generating a response.
+    This object represents the metadata of an HTTP request message; that
+    is, it contains attributes which describe the environment in which
+    the request URL, headers, and body were sent (if you want tools to
+    interpret the headers and body, those are elsewhere, mostly in
+    Tools). This 'metadata' consists of socket data, transport
+    characteristics, and the Request-Line. This object also contains
+    data regarding the configuration in effect for the given URL, and
+    the execution plan for generating a response.
     """
 
     prev = None
+    """The previous Request object (if any).
+
+    This should be None unless we are processing an InternalRedirect.
     """
-    The previous Request object (if any). This should be None
-    unless we are processing an InternalRedirect."""
 
     # Conversation/connection attributes
     local = httputil.Host('127.0.0.1', 80)
@@ -216,9 +216,10 @@ class Request(object):
     'An httputil.Host(ip, port, hostname) object for the client socket.'
 
     scheme = 'http'
+    """The protocol used between client and server.
+
+    In most cases, this will be either 'http' or 'https'.
     """
-    The protocol used between client and server. In most cases,
-    this will be either 'http' or 'https'."""
 
     server_protocol = 'HTTP/1.1'
     """
@@ -227,25 +228,30 @@ class Request(object):
 
     base = ''
     """The (scheme://host) portion of the requested URL.
+
     In some cases (e.g. when proxying via mod_rewrite), this may contain
     path segments which cherrypy.url uses when constructing url's, but
-    which otherwise are ignored by CherryPy. Regardless, this value
-    MUST NOT end in a slash."""
+    which otherwise are ignored by CherryPy. Regardless, this value MUST
+    NOT end in a slash.
+    """
 
     # Request-Line attributes
     request_line = ''
+    """The complete Request-Line received from the client.
+
+    This is a single string consisting of the request method, URI, and
+    protocol version (joined by spaces). Any final CRLF is removed.
     """
-    The complete Request-Line received from the client. This is a
-    single string consisting of the request method, URI, and protocol
-    version (joined by spaces). Any final CRLF is removed."""
 
     method = 'GET'
+    """Indicates the HTTP method to be performed on the resource identified by
+    the Request-URI.
+
+    Common methods include GET, HEAD, POST, PUT, and DELETE. CherryPy
+    allows any extension method; however, various HTTP servers and
+    gateways may restrict the set of allowable methods. CherryPy
+    applications SHOULD restrict the set (on a per-URI basis).
     """
-    Indicates the HTTP method to be performed on the resource identified
-    by the Request-URI. Common methods include GET, HEAD, POST, PUT, and
-    DELETE. CherryPy allows any extension method; however, various HTTP
-    servers and gateways may restrict the set of allowable methods.
-    CherryPy applications SHOULD restrict the set (on a per-URI basis)."""
 
     query_string = ''
     """
@@ -277,22 +283,26 @@ class Request(object):
     A dict which combines query string (GET) and request entity (POST)
     variables. This is populated in two stages: GET params are added
     before the 'on_start_resource' hook, and POST params are added
-    between the 'before_request_body' and 'before_handler' hooks."""
+    between the 'before_request_body' and 'before_handler' hooks.
+    """
 
     # Message attributes
     header_list = []
+    """A list of the HTTP request headers as (name, value) tuples.
+
+    In general, you should use request.headers (a dict) instead.
     """
-    A list of the HTTP request headers as (name, value) tuples.
-    In general, you should use request.headers (a dict) instead."""
 
     headers = httputil.HeaderMap()
-    """
-    A dict-like object containing the request headers. Keys are header
+    """A dict-like object containing the request headers.
+
+    Keys are header
     names (in Title-Case format); however, you may get and set them in
     a case-insensitive manner. That is, headers['Content-Type'] and
     headers['content-type'] refer to the same value. Values are header
     values (decoded according to :rfc:`2047` if necessary). See also:
-    httputil.HeaderMap, httputil.HeaderElement."""
+    httputil.HeaderMap, httputil.HeaderElement.
+    """
 
     cookie = SimpleCookie()
     """See help(Cookie)."""
@@ -336,7 +346,8 @@ class Request(object):
     or multipart, this will be None. Otherwise, this will be an instance
     of :class:`RequestBody<cherrypy._cpreqbody.RequestBody>` (which you
     can .read()); this value is set between the 'before_request_body' and
-    'before_handler' hooks (assuming that process_request_body is True)."""
+    'before_handler' hooks (assuming that process_request_body is True).
+    """
 
     # Dispatch attributes
     dispatch = cherrypy.dispatch.Dispatcher()
@@ -347,23 +358,24 @@ class Request(object):
     calls the dispatcher as early as possible, passing it a 'path_info'
     argument.
 
-    The default dispatcher discovers the page handler by matching path_info
-    to a hierarchical arrangement of objects, starting at request.app.root.
-    See help(cherrypy.dispatch) for more information."""
+    The default dispatcher discovers the page handler by matching
+    path_info to a hierarchical arrangement of objects, starting at
+    request.app.root. See help(cherrypy.dispatch) for more information.
+    """
 
     script_name = ''
-    """
-    The 'mount point' of the application which is handling this request.
+    """The 'mount point' of the application which is handling this request.
 
     This attribute MUST NOT end in a slash. If the script_name refers to
     the root of the URI, it MUST be an empty string (not "/").
     """
 
     path_info = '/'
+    """The 'relative path' portion of the Request-URI.
+
+    This is relative to the script_name ('mount point') of the
+    application which is handling this request.
     """
-    The 'relative path' portion of the Request-URI. This is relative
-    to the script_name ('mount point') of the application which is
-    handling this request."""
 
     login = None
     """
@@ -391,14 +403,16 @@ class Request(object):
     of the form: {Toolbox.namespace: {Tool.name: config dict}}."""
 
     config = None
+    """A flat dict of all configuration entries which apply to the current
+    request.
+
+    These entries are collected from global config, application config
+    (based on request.path_info), and from handler config (exactly how
+    is governed by the request.dispatch object in effect for this
+    request; by default, handler config can be attached anywhere in the
+    tree between request.app.root and the final handler, and inherits
+    downward).
     """
-    A flat dict of all configuration entries which apply to the
-    current request. These entries are collected from global config,
-    application config (based on request.path_info), and from handler
-    config (exactly how is governed by the request.dispatch object in
-    effect for this request; by default, handler config can be attached
-    anywhere in the tree between request.app.root and the final handler,
-    and inherits downward)."""
 
     is_index = None
     """
@@ -409,13 +423,14 @@ class Request(object):
     the trailing slash. See cherrypy.tools.trailing_slash."""
 
     hooks = HookMap(hookpoints)
-    """
-    A HookMap (dict-like object) of the form: {hookpoint: [hook, ...]}.
+    """A HookMap (dict-like object) of the form: {hookpoint: [hook, ...]}.
+
     Each key is a str naming the hook point, and each value is a list
     of hooks which will be called at that hook point during this request.
     The list of hooks is generally populated as early as possible (mostly
     from Tools specified in config), but may be extended at any time.
-    See also: _cprequest.Hook, _cprequest.HookMap, and cherrypy.tools."""
+    See also: _cprequest.Hook, _cprequest.HookMap, and cherrypy.tools.
+    """
 
     error_response = cherrypy.HTTPError(500).set_response
     """
@@ -428,12 +443,11 @@ class Request(object):
     error response to the user-agent."""
 
     error_page = {}
-    """
-    A dict of {error code: response filename or callable} pairs.
+    """A dict of {error code: response filename or callable} pairs.
 
     The error code must be an int representing a given HTTP error code,
-    or the string 'default', which will be used if no matching entry
-    is found for a given numeric code.
+    or the string 'default', which will be used if no matching entry is
+    found for a given numeric code.
 
     If a filename is provided, the file should contain a Python string-
     formatting template, and can expect by default to receive format
@@ -447,8 +461,8 @@ class Request(object):
     iterable of strings which will be set to response.body. It may also
     override headers or perform any other processing.
 
-    If no entry is given for an error code, and no 'default' entry exists,
-    a default template will be used.
+    If no entry is given for an error code, and no 'default' entry
+    exists, a default template will be used.
     """
 
     show_tracebacks = True
@@ -473,9 +487,10 @@ class Request(object):
     """True once the close method has been called, False otherwise."""
 
     stage = None
+    """A string containing the stage reached in the request-handling process.
+
+    This is useful when debugging a live server with hung requests.
     """
-    A string containing the stage reached in the request-handling process.
-    This is useful when debugging a live server with hung requests."""
 
     unique_id = None
     """A lazy object generating and memorizing UUID4 on ``str()`` render."""
@@ -492,9 +507,10 @@ class Request(object):
                  server_protocol='HTTP/1.1'):
         """Populate a new Request object.
 
-        local_host should be an httputil.Host object with the server info.
-        remote_host should be an httputil.Host object with the client info.
-        scheme should be a string, either "http" or "https".
+        local_host should be an httputil.Host object with the server
+        info. remote_host should be an httputil.Host object with the
+        client info. scheme should be a string, either "http" or
+        "https".
         """
         self.local = local_host
         self.remote = remote_host
@@ -514,7 +530,10 @@ class Request(object):
         self.unique_id = LazyUUID4()
 
     def close(self):
-        """Run cleanup code. (Core)"""
+        """Run cleanup code.
+
+        (Core)
+        """
         if not self.closed:
             self.closed = True
             self.stage = 'on_end_request'
@@ -551,7 +570,6 @@ class Request(object):
 
         Consumer code (HTTP servers) should then access these response
         attributes to build the outbound stream.
-
         """
         response = cherrypy.serving.response
         self.stage = 'run'
@@ -631,7 +649,10 @@ class Request(object):
         return response
 
     def respond(self, path_info):
-        """Generate a response for the resource at self.path_info. (Core)"""
+        """Generate a response for the resource at self.path_info.
+
+        (Core)
+        """
         try:
             try:
                 try:
@@ -702,7 +723,10 @@ class Request(object):
         response.finalize()
 
     def process_query_string(self):
-        """Parse the query string into Python structures. (Core)"""
+        """Parse the query string into Python structures.
+
+        (Core)
+        """
         try:
             p = httputil.parse_query_string(
                 self.query_string, encoding=self.query_string_encoding)
@@ -715,7 +739,10 @@ class Request(object):
         self.params.update(p)
 
     def process_headers(self):
-        """Parse HTTP header data into Python structures. (Core)"""
+        """Parse HTTP header data into Python structures.
+
+        (Core)
+        """
         # Process the headers into self.headers
         headers = self.headers
         for name, value in self.header_list:
@@ -751,7 +778,10 @@ class Request(object):
         self.base = '%s://%s' % (self.scheme, host)
 
     def get_resource(self, path):
-        """Call a dispatcher (which sets self.handler and .config). (Core)"""
+        """Call a dispatcher (which sets self.handler and .config).
+
+        (Core)
+        """
         # First, see if there is a custom dispatch at this URI. Custom
         # dispatchers can only be specified in app.config, not in _cp_config
         # (since custom dispatchers may not even have an app.root).
@@ -762,7 +792,10 @@ class Request(object):
         dispatch(path)
 
     def handle_error(self):
-        """Handle the last unanticipated exception. (Core)"""
+        """Handle the last unanticipated exception.
+
+        (Core)
+        """
         try:
             self.hooks.run('before_error_response')
             if self.error_response:
@@ -776,7 +809,6 @@ class Request(object):
 
 
 class ResponseBody(object):
-
     """The body of the HTTP response (the response entity)."""
 
     unicode_err = ('Page handlers MUST return bytes. Use tools.encode '
@@ -802,18 +834,18 @@ class ResponseBody(object):
 
 
 class Response(object):
-
     """An HTTP Response, including status, headers, and body."""
 
     status = ''
     """The HTTP Status-Code and Reason-Phrase."""
 
     header_list = []
-    """
-    A list of the HTTP response headers as (name, value) tuples.
+    """A list of the HTTP response headers as (name, value) tuples.
+
     In general, you should use response.headers (a dict) instead. This
     attribute is generated from response.headers and is not valid until
-    after the finalize phase."""
+    after the finalize phase.
+    """
 
     headers = httputil.HeaderMap()
     """
@@ -833,7 +865,10 @@ class Response(object):
     """The body (entity) of the HTTP response."""
 
     time = None
-    """The value of time.time() when created. Use in HTTP dates."""
+    """The value of time.time() when created.
+
+    Use in HTTP dates.
+    """
 
     stream = False
     """If False, buffer the response body."""
@@ -861,15 +896,15 @@ class Response(object):
         return new_body
 
     def _flush_body(self):
-        """
-        Discard self.body but consume any generator such that
-        any finalization can occur, such as is required by
-        caching.tee_output().
-        """
+        """Discard self.body but consume any generator such that any
+        finalization can occur, such as is required by caching.tee_output()."""
         consume(iter(self.body))
 
     def finalize(self):
-        """Transform headers (and cookies) into self.header_list. (Core)"""
+        """Transform headers (and cookies) into self.header_list.
+
+        (Core)
+        """
         try:
             code, reason, _ = httputil.valid_status(self.status)
         except ValueError:
diff --git a/lib/cherrypy/_cpserver.py b/lib/cherrypy/_cpserver.py
index 5f8d98fa..62331673 100644
--- a/lib/cherrypy/_cpserver.py
+++ b/lib/cherrypy/_cpserver.py
@@ -50,7 +50,8 @@ class Server(ServerAdapter):
     """If given, the name of the UNIX socket to use instead of TCP/IP.
 
     When this option is not None, the `socket_host` and `socket_port` options
-    are ignored."""
+    are ignored.
+    """
 
     socket_queue_size = 5
     """The 'backlog' argument to socket.listen(); specifies the maximum number
@@ -79,17 +80,24 @@ class Server(ServerAdapter):
     """The number of worker threads to start up in the pool."""
 
     thread_pool_max = -1
-    """The maximum size of the worker-thread pool. Use -1 to indicate no limit.
+    """The maximum size of the worker-thread pool.
+
+    Use -1 to indicate no limit.
     """
 
     max_request_header_size = 500 * 1024
     """The maximum number of bytes allowable in the request headers.
-    If exceeded, the HTTP server should return "413 Request Entity Too Large".
+
+    If exceeded, the HTTP server should return "413 Request Entity Too
+    Large".
     """
 
     max_request_body_size = 100 * 1024 * 1024
-    """The maximum number of bytes allowable in the request body. If exceeded,
-    the HTTP server should return "413 Request Entity Too Large"."""
+    """The maximum number of bytes allowable in the request body.
+
+    If exceeded, the HTTP server should return "413 Request Entity Too
+    Large".
+    """
 
     instance = None
     """If not None, this should be an HTTP server instance (such as
@@ -119,7 +127,8 @@ class Server(ServerAdapter):
     the builtin WSGI server. Builtin options are: 'builtin' (to
     use the SSL library built into recent versions of Python).
     You may also register your own classes in the
-    cheroot.server.ssl_adapters dict."""
+    cheroot.server.ssl_adapters dict.
+    """
 
     statistics = False
     """Turns statistics-gathering on or off for aware HTTP servers."""
@@ -129,11 +138,13 @@ class Server(ServerAdapter):
 
     wsgi_version = (1, 0)
     """The WSGI version tuple to use with the builtin WSGI server.
-    The provided options are (1, 0) [which includes support for PEP 3333,
-    which declares it covers WSGI version 1.0.1 but still mandates the
-    wsgi.version (1, 0)] and ('u', 0), an experimental unicode version.
-    You may create and register your own experimental versions of the WSGI
-    protocol by adding custom classes to the cheroot.server.wsgi_gateways dict.
+
+    The provided options are (1, 0) [which includes support for PEP
+    3333, which declares it covers WSGI version 1.0.1 but still mandates
+    the wsgi.version (1, 0)] and ('u', 0), an experimental unicode
+    version. You may create and register your own experimental versions
+    of the WSGI protocol by adding custom classes to the
+    cheroot.server.wsgi_gateways dict.
     """
 
     peercreds = False
@@ -184,7 +195,8 @@ class Server(ServerAdapter):
     def bind_addr(self):
         """Return bind address.
 
-        A (host, port) tuple for TCP sockets or a str for Unix domain sockts.
+        A (host, port) tuple for TCP sockets or a str for Unix domain
+        sockets.
         """
         if self.socket_file:
             return self.socket_file
diff --git a/lib/cherrypy/_cptools.py b/lib/cherrypy/_cptools.py
index 716f99a4..e47c046e 100644
--- a/lib/cherrypy/_cptools.py
+++ b/lib/cherrypy/_cptools.py
@@ -1,7 +1,7 @@
 """CherryPy tools. A "tool" is any helper, adapted to CP.
 
-Tools are usually designed to be used in a variety of ways (although some
-may only offer one if they choose):
+Tools are usually designed to be used in a variety of ways (although
+some may only offer one if they choose):
 
     Library calls
         All tools are callables that can be used wherever needed.
@@ -48,10 +48,10 @@ _attr_error = (
 
 
 class Tool(object):
-
     """A registered function for use with CherryPy request-processing hooks.
 
-    help(tool.callable) should give you more information about this Tool.
+    help(tool.callable) should give you more information about this
+    Tool.
     """
 
     namespace = 'tools'
@@ -135,8 +135,8 @@ class Tool(object):
     def _setup(self):
         """Hook this tool into cherrypy.request.
 
-        The standard CherryPy request object will automatically call this
-        method when the tool is "turned on" in config.
+        The standard CherryPy request object will automatically call
+        this method when the tool is "turned on" in config.
         """
         conf = self._merged_args()
         p = conf.pop('priority', None)
@@ -147,15 +147,15 @@ class Tool(object):
 
 
 class HandlerTool(Tool):
-
     """Tool which is called 'before main', that may skip normal handlers.
 
-    If the tool successfully handles the request (by setting response.body),
-    if should return True. This will cause CherryPy to skip any 'normal' page
-    handler. If the tool did not handle the request, it should return False
-    to tell CherryPy to continue on and call the normal page handler. If the
-    tool is declared AS a page handler (see the 'handler' method), returning
-    False will raise NotFound.
+    If the tool successfully handles the request (by setting
+    response.body), if should return True. This will cause CherryPy to
+    skip any 'normal' page handler. If the tool did not handle the
+    request, it should return False to tell CherryPy to continue on and
+    call the normal page handler. If the tool is declared AS a page
+    handler (see the 'handler' method), returning False will raise
+    NotFound.
     """
 
     def __init__(self, callable, name=None):
@@ -185,8 +185,8 @@ class HandlerTool(Tool):
     def _setup(self):
         """Hook this tool into cherrypy.request.
 
-        The standard CherryPy request object will automatically call this
-        method when the tool is "turned on" in config.
+        The standard CherryPy request object will automatically call
+        this method when the tool is "turned on" in config.
         """
         conf = self._merged_args()
         p = conf.pop('priority', None)
@@ -197,7 +197,6 @@ class HandlerTool(Tool):
 
 
 class HandlerWrapperTool(Tool):
-
     """Tool which wraps request.handler in a provided wrapper function.
 
     The 'newhandler' arg must be a handler wrapper function that takes a
@@ -232,7 +231,6 @@ class HandlerWrapperTool(Tool):
 
 
 class ErrorTool(Tool):
-
     """Tool which is used to replace the default request.error_response."""
 
     def __init__(self, callable, name=None):
@@ -244,8 +242,8 @@ class ErrorTool(Tool):
     def _setup(self):
         """Hook this tool into cherrypy.request.
 
-        The standard CherryPy request object will automatically call this
-        method when the tool is "turned on" in config.
+        The standard CherryPy request object will automatically call
+        this method when the tool is "turned on" in config.
         """
         cherrypy.serving.request.error_response = self._wrapper
 
@@ -254,7 +252,6 @@ class ErrorTool(Tool):
 
 
 class SessionTool(Tool):
-
     """Session Tool for CherryPy.
 
     sessions.locking
@@ -282,8 +279,8 @@ class SessionTool(Tool):
     def _setup(self):
         """Hook this tool into cherrypy.request.
 
-        The standard CherryPy request object will automatically call this
-        method when the tool is "turned on" in config.
+        The standard CherryPy request object will automatically call
+        this method when the tool is "turned on" in config.
         """
         hooks = cherrypy.serving.request.hooks
 
@@ -325,7 +322,6 @@ class SessionTool(Tool):
 
 
 class XMLRPCController(object):
-
     """A Controller (page handler collection) for XML-RPC.
 
     To use it, have your controllers subclass this base class (it will
@@ -392,7 +388,6 @@ class SessionAuthTool(HandlerTool):
 
 
 class CachingTool(Tool):
-
     """Caching Tool for CherryPy."""
 
     def _wrapper(self, **kwargs):
@@ -416,11 +411,11 @@ class CachingTool(Tool):
 
 
 class Toolbox(object):
-
     """A collection of Tools.
 
     This object also functions as a config namespace handler for itself.
-    Custom toolboxes should be added to each Application's toolboxes dict.
+    Custom toolboxes should be added to each Application's toolboxes
+    dict.
     """
 
     def __init__(self, namespace):
diff --git a/lib/cherrypy/_cptree.py b/lib/cherrypy/_cptree.py
index 917c5b1a..3dea1c29 100644
--- a/lib/cherrypy/_cptree.py
+++ b/lib/cherrypy/_cptree.py
@@ -10,19 +10,22 @@ from cherrypy.lib import httputil, reprconf
 class Application(object):
     """A CherryPy Application.
 
-    Servers and gateways should not instantiate Request objects directly.
-    Instead, they should ask an Application object for a request object.
+    Servers and gateways should not instantiate Request objects
+    directly. Instead, they should ask an Application object for a
+    request object.
 
-    An instance of this class may also be used as a WSGI callable
-    (WSGI application object) for itself.
+    An instance of this class may also be used as a WSGI callable (WSGI
+    application object) for itself.
     """
 
     root = None
-    """The top-most container of page handlers for this app. Handlers should
-    be arranged in a hierarchy of attributes, matching the expected URI
-    hierarchy; the default dispatcher then searches this hierarchy for a
-    matching handler. When using a dispatcher other than the default,
-    this value may be None."""
+    """The top-most container of page handlers for this app.
+
+    Handlers should be arranged in a hierarchy of attributes, matching
+    the expected URI hierarchy; the default dispatcher then searches
+    this hierarchy for a matching handler. When using a dispatcher other
+    than the default, this value may be None.
+    """
 
     config = {}
     """A dict of {path: pathconf} pairs, where 'pathconf' is itself a dict
@@ -32,10 +35,16 @@ class Application(object):
     toolboxes = {'tools': cherrypy.tools}
 
     log = None
-    """A LogManager instance. See _cplogging."""
+    """A LogManager instance.
+
+    See _cplogging.
+    """
 
     wsgiapp = None
-    """A CPWSGIApp instance. See _cpwsgi."""
+    """A CPWSGIApp instance.
+
+    See _cpwsgi.
+    """
 
     request_class = _cprequest.Request
     response_class = _cprequest.Response
@@ -82,12 +91,15 @@ class Application(object):
     def script_name(self):  # noqa: D401; irrelevant for properties
         """The URI "mount point" for this app.
 
-        A mount point is that portion of the URI which is constant for all URIs
-        that are serviced by this application; it does not include scheme,
-        host, or proxy ("virtual host") portions of the URI.
+        A mount point is that portion of the URI which is constant for
+        all URIs that are serviced by this application; it does not
+        include scheme, host, or proxy ("virtual host") portions of the
+        URI.
 
-        For example, if script_name is "/my/cool/app", then the URL
-        "http://www.example.com/my/cool/app/page1" might be handled by a
+        For example, if script_name is "/my/cool/app", then the URL "
+
+        http://www.example.com/my/cool/app/page1"
+        might be handled by a
         "page1" method on the root object.
 
         The value of script_name MUST NOT end in a slash. If the script_name
@@ -171,9 +183,9 @@ class Application(object):
 class Tree(object):
     """A registry of CherryPy applications, mounted at diverse points.
 
-    An instance of this class may also be used as a WSGI callable
-    (WSGI application object), in which case it dispatches to all
-    mounted apps.
+    An instance of this class may also be used as a WSGI callable (WSGI
+    application object), in which case it dispatches to all mounted
+    apps.
     """
 
     apps = {}
diff --git a/lib/cherrypy/_cpwsgi.py b/lib/cherrypy/_cpwsgi.py
index b4f55fd6..b2a6da52 100644
--- a/lib/cherrypy/_cpwsgi.py
+++ b/lib/cherrypy/_cpwsgi.py
@@ -1,10 +1,10 @@
 """WSGI interface (see PEP 333 and 3333).
 
 Note that WSGI environ keys and values are 'native strings'; that is,
-whatever the type of "" is. For Python 2, that's a byte string; for Python 3,
-it's a unicode string. But PEP 3333 says: "even if Python's str type is
-actually Unicode "under the hood", the content of native strings must
-still be translatable to bytes via the Latin-1 encoding!"
+whatever the type of "" is. For Python 2, that's a byte string; for
+Python 3, it's a unicode string. But PEP 3333 says: "even if Python's
+str type is actually Unicode "under the hood", the content of native
+strings must still be translatable to bytes via the Latin-1 encoding!"
 """
 
 import sys as _sys
@@ -34,7 +34,6 @@ def downgrade_wsgi_ux_to_1x(environ):
 
 
 class VirtualHost(object):
-
     """Select a different WSGI application based on the Host header.
 
     This can be useful when running multiple sites within one CP server.
@@ -56,7 +55,10 @@ class VirtualHost(object):
         cherrypy.tree.graft(vhost)
     """
     default = None
-    """Required. The default WSGI application."""
+    """Required.
+
+    The default WSGI application.
+    """
 
     use_x_forwarded_host = True
     """If True (the default), any "X-Forwarded-Host"
@@ -65,11 +67,12 @@ class VirtualHost(object):
 
     domains = {}
     """A dict of {host header value: application} pairs.
-    The incoming "Host" request header is looked up in this dict,
-    and, if a match is found, the corresponding WSGI application
-    will be called instead of the default. Note that you often need
-    separate entries for "example.com" and "www.example.com".
-    In addition, "Host" headers may contain the port number.
+
+    The incoming "Host" request header is looked up in this dict, and,
+    if a match is found, the corresponding WSGI application will be
+    called instead of the default. Note that you often need separate
+    entries for "example.com" and "www.example.com". In addition, "Host"
+    headers may contain the port number.
     """
 
     def __init__(self, default, domains=None, use_x_forwarded_host=True):
@@ -89,7 +92,6 @@ class VirtualHost(object):
 
 
 class InternalRedirector(object):
-
     """WSGI middleware that handles raised cherrypy.InternalRedirect."""
 
     def __init__(self, nextapp, recursive=False):
@@ -137,7 +139,6 @@ class InternalRedirector(object):
 
 
 class ExceptionTrapper(object):
-
     """WSGI middleware that traps exceptions."""
 
     def __init__(self, nextapp, throws=(KeyboardInterrupt, SystemExit)):
@@ -226,7 +227,6 @@ class _TrappedResponse(object):
 
 
 class AppResponse(object):
-
     """WSGI response iterable for CherryPy applications."""
 
     def __init__(self, environ, start_response, cpapp):
@@ -277,7 +277,10 @@ class AppResponse(object):
         return next(self.iter_response)
 
     def close(self):
-        """Close and de-reference the current request and response. (Core)"""
+        """Close and de-reference the current request and response.
+
+        (Core)
+        """
         streaming = _cherrypy.serving.response.stream
         self.cpapp.release_serving()
 
@@ -380,18 +383,20 @@ class AppResponse(object):
 
 
 class CPWSGIApp(object):
-
     """A WSGI application object for a CherryPy Application."""
 
     pipeline = [
         ('ExceptionTrapper', ExceptionTrapper),
         ('InternalRedirector', InternalRedirector),
     ]
-    """A list of (name, wsgiapp) pairs. Each 'wsgiapp' MUST be a
-    constructor that takes an initial, positional 'nextapp' argument,
-    plus optional keyword arguments, and returns a WSGI application
-    (that takes environ and start_response arguments). The 'name' can
-    be any you choose, and will correspond to keys in self.config."""
+    """A list of (name, wsgiapp) pairs.
+
+    Each 'wsgiapp' MUST be a constructor that takes an initial,
+    positional 'nextapp' argument, plus optional keyword arguments, and
+    returns a WSGI application (that takes environ and start_response
+    arguments). The 'name' can be any you choose, and will correspond to
+    keys in self.config.
+    """
 
     head = None
     """Rather than nest all apps in the pipeline on each call, it's only
@@ -399,9 +404,12 @@ class CPWSGIApp(object):
     this to None again if you change self.pipeline after calling self."""
 
     config = {}
-    """A dict whose keys match names listed in the pipeline. Each
-    value is a further dict which will be passed to the corresponding
-    named WSGI callable (from the pipeline) as keyword arguments."""
+    """A dict whose keys match names listed in the pipeline.
+
+    Each value is a further dict which will be passed to the
+    corresponding named WSGI callable (from the pipeline) as keyword
+    arguments.
+    """
 
     response_class = AppResponse
     """The class to instantiate and return as the next app in the WSGI chain.
@@ -417,8 +425,8 @@ class CPWSGIApp(object):
     def tail(self, environ, start_response):
         """WSGI application callable for the actual CherryPy application.
 
-        You probably shouldn't call this; call self.__call__ instead,
-        so that any WSGI middleware in self.pipeline can run first.
+        You probably shouldn't call this; call self.__call__ instead, so
+        that any WSGI middleware in self.pipeline can run first.
         """
         return self.response_class(environ, start_response, self.cpapp)
 
diff --git a/lib/cherrypy/_cpwsgi_server.py b/lib/cherrypy/_cpwsgi_server.py
index 11dd846a..b8e96deb 100644
--- a/lib/cherrypy/_cpwsgi_server.py
+++ b/lib/cherrypy/_cpwsgi_server.py
@@ -1,7 +1,7 @@
-"""
-WSGI server interface (see PEP 333).
+"""WSGI server interface (see PEP 333).
 
-This adds some CP-specific bits to the framework-agnostic cheroot package.
+This adds some CP-specific bits to the framework-agnostic cheroot
+package.
 """
 import sys
 
@@ -35,10 +35,11 @@ class CPWSGIHTTPRequest(cheroot.server.HTTPRequest):
 class CPWSGIServer(cheroot.wsgi.Server):
     """Wrapper for cheroot.wsgi.Server.
 
-    cheroot has been designed to not reference CherryPy in any way,
-    so that it can be used in other frameworks and applications. Therefore,
-    we wrap it here, so we can set our own mount points from cherrypy.tree
-    and apply some attributes from config -> cherrypy.server -> wsgi.Server.
+    cheroot has been designed to not reference CherryPy in any way, so
+    that it can be used in other frameworks and applications. Therefore,
+    we wrap it here, so we can set our own mount points from
+    cherrypy.tree and apply some attributes from config ->
+    cherrypy.server -> wsgi.Server.
     """
 
     fmt = 'CherryPy/{cherrypy.__version__} {cheroot.wsgi.Server.version}'
diff --git a/lib/cherrypy/_helper.py b/lib/cherrypy/_helper.py
index d57cd1f9..497438eb 100644
--- a/lib/cherrypy/_helper.py
+++ b/lib/cherrypy/_helper.py
@@ -137,7 +137,6 @@ def popargs(*args, **kwargs):
         class Root:
             def index(self):
                 #...
-
     """
     # Since keyword arg comes after *args, we have to process it ourselves
     # for lower versions of python.
@@ -201,16 +200,17 @@ def url(path='', qs='', script_name=None, base=None, relative=None):
     If it does not start with a slash, this returns
         (base + script_name [+ request.path_info] + path + qs).
 
-    If script_name is None, cherrypy.request will be used
-    to find a script_name, if available.
+    If script_name is None, cherrypy.request will be used to find a
+    script_name, if available.
 
     If base is None, cherrypy.request.base will be used (if available).
     Note that you can use cherrypy.tools.proxy to change this.
 
-    Finally, note that this function can be used to obtain an absolute URL
-    for the current request path (minus the querystring) by passing no args.
-    If you call url(qs=cherrypy.request.query_string), you should get the
-    original browser URL (assuming no internal redirections).
+    Finally, note that this function can be used to obtain an absolute
+    URL for the current request path (minus the querystring) by passing
+    no args. If you call url(qs=cherrypy.request.query_string), you
+    should get the original browser URL (assuming no internal
+    redirections).
 
     If relative is None or not provided, request.app.relative_urls will
     be used (if available, else False). If False, the output will be an
@@ -320,8 +320,8 @@ def normalize_path(path):
 class _ClassPropertyDescriptor(object):
     """Descript for read-only class-based property.
 
-    Turns a classmethod-decorated func into a read-only property of that class
-    type (means the value cannot be set).
+    Turns a classmethod-decorated func into a read-only property of that
+    class type (means the value cannot be set).
     """
 
     def __init__(self, fget, fset=None):
diff --git a/lib/cherrypy/_json.py b/lib/cherrypy/_json.py
index 0c2a0f0e..4ef85580 100644
--- a/lib/cherrypy/_json.py
+++ b/lib/cherrypy/_json.py
@@ -1,5 +1,4 @@
-"""
-JSON support.
+"""JSON support.
 
 Expose preferred json module as json and provide encode/decode
 convenience functions.
diff --git a/lib/cherrypy/lib/__init__.py b/lib/cherrypy/lib/__init__.py
index 0edaaf20..9788ffdf 100644
--- a/lib/cherrypy/lib/__init__.py
+++ b/lib/cherrypy/lib/__init__.py
@@ -6,8 +6,8 @@ def is_iterator(obj):
 
     (i.e. like a generator).
 
-    This will return False for objects which are iterable,
-    but not iterators themselves.
+    This will return False for objects which are iterable, but not
+    iterators themselves.
     """
     from types import GeneratorType
     if isinstance(obj, GeneratorType):
diff --git a/lib/cherrypy/lib/auth_basic.py b/lib/cherrypy/lib/auth_basic.py
index ad379a26..b938a560 100644
--- a/lib/cherrypy/lib/auth_basic.py
+++ b/lib/cherrypy/lib/auth_basic.py
@@ -18,7 +18,6 @@ as the credentials store::
                   'tools.auth_basic.accept_charset': 'UTF-8',
     }
     app_config = { '/' : basic_auth }
-
 """
 
 import binascii
diff --git a/lib/cherrypy/lib/auth_digest.py b/lib/cherrypy/lib/auth_digest.py
index 981e9a5d..46749268 100644
--- a/lib/cherrypy/lib/auth_digest.py
+++ b/lib/cherrypy/lib/auth_digest.py
@@ -55,7 +55,7 @@ def TRACE(msg):
 
 
 def get_ha1_dict_plain(user_password_dict):
-    """Returns a get_ha1 function which obtains a plaintext password from a
+    """Return a get_ha1 function which obtains a plaintext password from a
     dictionary of the form: {username : password}.
 
     If you want a simple dictionary-based authentication scheme, with plaintext
@@ -72,7 +72,7 @@ def get_ha1_dict_plain(user_password_dict):
 
 
 def get_ha1_dict(user_ha1_dict):
-    """Returns a get_ha1 function which obtains a HA1 password hash from a
+    """Return a get_ha1 function which obtains a HA1 password hash from a
     dictionary of the form: {username : HA1}.
 
     If you want a dictionary-based authentication scheme, but with
@@ -87,7 +87,7 @@ def get_ha1_dict(user_ha1_dict):
 
 
 def get_ha1_file_htdigest(filename):
-    """Returns a get_ha1 function which obtains a HA1 password hash from a
+    """Return a get_ha1 function which obtains a HA1 password hash from a
     flat file with lines of the same format as that produced by the Apache
     htdigest utility. For example, for realm 'wonderland', username 'alice',
     and password '4x5istwelve', the htdigest line would be::
@@ -135,7 +135,7 @@ def synthesize_nonce(s, key, timestamp=None):
 
 
 def H(s):
-    """The hash function H"""
+    """The hash function H."""
     return md5_hex(s)
 
 
@@ -259,10 +259,11 @@ class HttpDigestAuthorization(object):
         return False
 
     def is_nonce_stale(self, max_age_seconds=600):
-        """Returns True if a validated nonce is stale. The nonce contains a
-        timestamp in plaintext and also a secure hash of the timestamp.
-        You should first validate the nonce to ensure the plaintext
-        timestamp is not spoofed.
+        """Return True if a validated nonce is stale.
+
+        The nonce contains a timestamp in plaintext and also a secure
+        hash of the timestamp. You should first validate the nonce to
+        ensure the plaintext timestamp is not spoofed.
         """
         try:
             timestamp, hashpart = self.nonce.split(':', 1)
@@ -275,7 +276,10 @@ class HttpDigestAuthorization(object):
         return True
 
     def HA2(self, entity_body=''):
-        """Returns the H(A2) string. See :rfc:`2617` section 3.2.2.3."""
+        """Return the H(A2) string.
+
+        See :rfc:`2617` section 3.2.2.3.
+        """
         # RFC 2617 3.2.2.3
         # If the "qop" directive's value is "auth" or is unspecified,
         # then A2 is:
@@ -306,7 +310,6 @@ class HttpDigestAuthorization(object):
             4.3.  This refers to the entity the user agent sent in the
             request which has the Authorization header. Typically GET
             requests don't have an entity, and POST requests do.
-
         """
         ha2 = self.HA2(entity_body)
         # Request-Digest -- RFC 2617 3.2.2.1
@@ -395,7 +398,6 @@ def digest_auth(realm, get_ha1, key, debug=False, accept_charset='utf-8'):
     key
         A secret string known only to the server, used in the synthesis
         of nonces.
-
     """
     request = cherrypy.serving.request
 
@@ -447,9 +449,7 @@ def digest_auth(realm, get_ha1, key, debug=False, accept_charset='utf-8'):
 
 
 def _respond_401(realm, key, accept_charset, debug, **kwargs):
-    """
-    Respond with 401 status and a WWW-Authenticate header
-    """
+    """Respond with 401 status and a WWW-Authenticate header."""
     header = www_authenticate(
         realm, key,
         accept_charset=accept_charset,
diff --git a/lib/cherrypy/lib/caching.py b/lib/cherrypy/lib/caching.py
index 08d2d8e4..89cb0442 100644
--- a/lib/cherrypy/lib/caching.py
+++ b/lib/cherrypy/lib/caching.py
@@ -42,7 +42,6 @@ from cherrypy.lib import cptools, httputil
 
 
 class Cache(object):
-
     """Base class for Cache implementations."""
 
     def get(self):
@@ -64,17 +63,16 @@ class Cache(object):
 
 # ------------------------------ Memory Cache ------------------------------- #
 class AntiStampedeCache(dict):
-
     """A storage system for cached items which reduces stampede collisions."""
 
     def wait(self, key, timeout=5, debug=False):
         """Return the cached value for the given key, or None.
 
-        If timeout is not None, and the value is already
-        being calculated by another thread, wait until the given timeout has
-        elapsed. If the value is available before the timeout expires, it is
-        returned. If not, None is returned, and a sentinel placed in the cache
-        to signal other threads to wait.
+        If timeout is not None, and the value is already being
+        calculated by another thread, wait until the given timeout has
+        elapsed. If the value is available before the timeout expires,
+        it is returned. If not, None is returned, and a sentinel placed
+        in the cache to signal other threads to wait.
 
         If timeout is None, no waiting is performed nor sentinels used.
         """
@@ -127,7 +125,6 @@ class AntiStampedeCache(dict):
 
 
 class MemoryCache(Cache):
-
     """An in-memory cache for varying response content.
 
     Each key in self.store is a URI, and each value is an AntiStampedeCache.
@@ -381,7 +378,10 @@ def get(invalid_methods=('POST', 'PUT', 'DELETE'), debug=False, **kwargs):
 
 
 def tee_output():
-    """Tee response output to cache storage. Internal."""
+    """Tee response output to cache storage.
+
+    Internal.
+    """
     # Used by CachingTool by attaching to request.hooks
 
     request = cherrypy.serving.request
@@ -441,7 +441,6 @@ def expires(secs=0, force=False, debug=False):
             * Expires
 
         If any are already present, none of the above response headers are set.
-
     """
 
     response = cherrypy.serving.response
diff --git a/lib/cherrypy/lib/covercp.py b/lib/cherrypy/lib/covercp.py
index 6c3871fc..f22cce74 100644
--- a/lib/cherrypy/lib/covercp.py
+++ b/lib/cherrypy/lib/covercp.py
@@ -22,7 +22,7 @@ it will call ``serve()`` for you.
 
 import re
 import sys
-import cgi
+import html
 import os
 import os.path
 import urllib.parse
@@ -352,9 +352,9 @@ class CoverStats(object):
                 buffer.append((lineno, line))
             if empty_the_buffer:
                 for lno, pastline in buffer:
-                    yield template % (lno, cgi.escape(pastline))
+                    yield template % (lno, html.escape(pastline))
                 buffer = []
-                yield template % (lineno, cgi.escape(line))
+                yield template % (lineno, html.escape(line))
 
     @cherrypy.expose
     def report(self, name):
diff --git a/lib/cherrypy/lib/cpstats.py b/lib/cherrypy/lib/cpstats.py
index 111af063..5dff319b 100644
--- a/lib/cherrypy/lib/cpstats.py
+++ b/lib/cherrypy/lib/cpstats.py
@@ -184,7 +184,6 @@ To report statistics::
 To format statistics reports::
 
     See 'Reporting', above.
-
 """
 
 import logging
@@ -254,7 +253,6 @@ def proc_time(s):
 
 
 class ByteCountWrapper(object):
-
     """Wraps a file-like object, counting the number of bytes read."""
 
     def __init__(self, rfile):
@@ -307,7 +305,6 @@ def _get_threading_ident():
 
 
 class StatsTool(cherrypy.Tool):
-
     """Record various information about the current request."""
 
     def __init__(self):
@@ -316,8 +313,8 @@ class StatsTool(cherrypy.Tool):
     def _setup(self):
         """Hook this tool into cherrypy.request.
 
-        The standard CherryPy request object will automatically call this
-        method when the tool is "turned on" in config.
+        The standard CherryPy request object will automatically call
+        this method when the tool is "turned on" in config.
         """
         if appstats.get('Enabled', False):
             cherrypy.Tool._setup(self)
diff --git a/lib/cherrypy/lib/cptools.py b/lib/cherrypy/lib/cptools.py
index 13b4c567..61d4d36b 100644
--- a/lib/cherrypy/lib/cptools.py
+++ b/lib/cherrypy/lib/cptools.py
@@ -94,8 +94,8 @@ def validate_etags(autotags=False, debug=False):
 def validate_since():
     """Validate the current Last-Modified against If-Modified-Since headers.
 
-    If no code has set the Last-Modified response header, then no validation
-    will be performed.
+    If no code has set the Last-Modified response header, then no
+    validation will be performed.
     """
     response = cherrypy.serving.response
     lastmod = response.headers.get('Last-Modified')
@@ -123,9 +123,9 @@ def validate_since():
 def allow(methods=None, debug=False):
     """Raise 405 if request.method not in methods (default ['GET', 'HEAD']).
 
-    The given methods are case-insensitive, and may be in any order.
-    If only one method is allowed, you may supply a single string;
-    if more than one, supply a list of strings.
+    The given methods are case-insensitive, and may be in any order. If
+    only one method is allowed, you may supply a single string; if more
+    than one, supply a list of strings.
 
     Regardless of whether the current method is allowed or not, this
     also emits an 'Allow' response header, containing the given methods.
@@ -154,22 +154,23 @@ def proxy(base=None, local='X-Forwarded-Host', remote='X-Forwarded-For',
           scheme='X-Forwarded-Proto', debug=False):
     """Change the base URL (scheme://host[:port][/path]).
 
-    For running a CP server behind Apache, lighttpd, or other HTTP server.
+    For running a CP server behind Apache, lighttpd, or other HTTP
+    server.
 
-    For Apache and lighttpd, you should leave the 'local' argument at the
-    default value of 'X-Forwarded-Host'. For Squid, you probably want to set
-    tools.proxy.local = 'Origin'.
+    For Apache and lighttpd, you should leave the 'local' argument at
+    the default value of 'X-Forwarded-Host'. For Squid, you probably
+    want to set tools.proxy.local = 'Origin'.
 
-    If you want the new request.base to include path info (not just the host),
-    you must explicitly set base to the full base path, and ALSO set 'local'
-    to '', so that the X-Forwarded-Host request header (which never includes
-    path info) does not override it. Regardless, the value for 'base' MUST
-    NOT end in a slash.
+    If you want the new request.base to include path info (not just the
+    host), you must explicitly set base to the full base path, and ALSO
+    set 'local' to '', so that the X-Forwarded-Host request header
+    (which never includes path info) does not override it. Regardless,
+    the value for 'base' MUST NOT end in a slash.
 
     cherrypy.request.remote.ip (the IP address of the client) will be
-    rewritten if the header specified by the 'remote' arg is valid.
-    By default, 'remote' is set to 'X-Forwarded-For'. If you do not
-    want to rewrite remote.ip, set the 'remote' arg to an empty string.
+    rewritten if the header specified by the 'remote' arg is valid. By
+    default, 'remote' is set to 'X-Forwarded-For'. If you do not want to
+    rewrite remote.ip, set the 'remote' arg to an empty string.
     """
 
     request = cherrypy.serving.request
@@ -217,8 +218,8 @@ def proxy(base=None, local='X-Forwarded-Host', remote='X-Forwarded-For',
 def ignore_headers(headers=('Range',), debug=False):
     """Delete request headers whose field names are included in 'headers'.
 
-    This is a useful tool for working behind certain HTTP servers;
-    for example, Apache duplicates the work that CP does for 'Range'
+    This is a useful tool for working behind certain HTTP servers; for
+    example, Apache duplicates the work that CP does for 'Range'
     headers, and will doubly-truncate the response.
     """
     request = cherrypy.serving.request
@@ -281,7 +282,6 @@ def referer(pattern, accept=True, accept_missing=False, error=403,
 
 
 class SessionAuth(object):
-
     """Assert that the user is logged in."""
 
     session_key = 'username'
@@ -319,7 +319,10 @@ Message: %(error_msg)s
 </body></html>""") % vars()).encode('utf-8')
 
     def do_login(self, username, password, from_page='..', **kwargs):
-        """Login. May raise redirect, or return True if request handled."""
+        """Login.
+
+        May raise redirect, or return True if request handled.
+        """
         response = cherrypy.serving.response
         error_msg = self.check_username_and_password(username, password)
         if error_msg:
@@ -336,7 +339,10 @@ Message: %(error_msg)s
             raise cherrypy.HTTPRedirect(from_page or '/')
 
     def do_logout(self, from_page='..', **kwargs):
-        """Logout. May raise redirect, or return True if request handled."""
+        """Logout.
+
+        May raise redirect, or return True if request handled.
+        """
         sess = cherrypy.session
         username = sess.get(self.session_key)
         sess[self.session_key] = None
@@ -346,7 +352,9 @@ Message: %(error_msg)s
         raise cherrypy.HTTPRedirect(from_page)
 
     def do_check(self):
-        """Assert username. Raise redirect, or return True if request handled.
+        """Assert username.
+
+        Raise redirect, or return True if request handled.
         """
         sess = cherrypy.session
         request = cherrypy.serving.request
@@ -408,8 +416,7 @@ def session_auth(**kwargs):
 
     Any attribute of the SessionAuth class may be overridden
     via a keyword arg to this function:
-
-    """ + '\n    '.join(
+    """ + '\n' + '\n    '.join(
         '{!s}: {!s}'.format(k, type(getattr(SessionAuth, k)).__name__)
         for k in dir(SessionAuth)
         if not k.startswith('__')
@@ -490,8 +497,8 @@ def trailing_slash(missing=True, extra=False, status=None, debug=False):
 def flatten(debug=False):
     """Wrap response.body in a generator that recursively iterates over body.
 
-    This allows cherrypy.response.body to consist of 'nested generators';
-    that is, a set of generators that yield generators.
+    This allows cherrypy.response.body to consist of 'nested
+    generators'; that is, a set of generators that yield generators.
     """
     def flattener(input):
         numchunks = 0
diff --git a/lib/cherrypy/lib/encoding.py b/lib/cherrypy/lib/encoding.py
index c2c478a5..068c88d2 100644
--- a/lib/cherrypy/lib/encoding.py
+++ b/lib/cherrypy/lib/encoding.py
@@ -261,9 +261,7 @@ class ResponseEncoder:
 
 
 def prepare_iter(value):
-    """
-    Ensure response body is iterable and resolves to False when empty.
-    """
+    """Ensure response body is iterable and resolves to False when empty."""
     if isinstance(value, text_or_bytes):
         # strings get wrapped in a list because iterating over a single
         # item list is much faster than iterating over every character
@@ -360,7 +358,6 @@ def gzip(compress_level=5, mime_types=['text/html', 'text/plain'],
         * No 'gzip' or 'x-gzip' is present in the Accept-Encoding header
         * No 'gzip' or 'x-gzip' with a qvalue > 0 is present
         * The 'identity' value is given with a qvalue > 0.
-
     """
     request = cherrypy.serving.request
     response = cherrypy.serving.response
diff --git a/lib/cherrypy/lib/gctools.py b/lib/cherrypy/lib/gctools.py
index 26746d78..14d3ba7e 100644
--- a/lib/cherrypy/lib/gctools.py
+++ b/lib/cherrypy/lib/gctools.py
@@ -14,7 +14,6 @@ from cherrypy.process.plugins import SimplePlugin
 
 
 class ReferrerTree(object):
-
     """An object which gathers all referrers of an object to a given depth."""
 
     peek_length = 40
@@ -132,7 +131,6 @@ def get_context(obj):
 
 
 class GCRoot(object):
-
     """A CherryPy page handler for testing reference leaks."""
 
     classes = [
diff --git a/lib/cherrypy/lib/headers.py b/lib/cherrypy/lib/headers.py
new file mode 100644
index 00000000..ddbe515b
--- /dev/null
+++ b/lib/cherrypy/lib/headers.py
@@ -0,0 +1,39 @@
+"""headers."""
+
+
+def _parse_param(s):
+    while s[:1] == ';':
+        s = s[1:]
+        end = s.find(';')
+        while end > 0 and (s.count('"', 0, end) - s.count('\\"', 0, end)) % 2:
+            end = s.find(';', end + 1)
+        if end < 0:
+            end = len(s)
+        f = s[:end]
+        yield f.strip()
+        s = s[end:]
+
+
+def parse_header(line):
+    """Parse a Content-type like header.
+
+    Return the main content-type and a dictionary of options.
+
+    Copied from removed stdlib cgi module. See
+    `cherrypy/cherrypy#2014 (comment)
+    <https://github.com/cherrypy/cherrypy/issues/2014#issuecomment-1883774891>`_
+    for background.
+    """
+    parts = _parse_param(';' + line)
+    key = parts.__next__()
+    pdict = {}
+    for p in parts:
+        i = p.find('=')
+        if i >= 0:
+            name = p[:i].strip().lower()
+            value = p[i + 1:].strip()
+            if len(value) >= 2 and value[0] == value[-1] == '"':
+                value = value[1:-1]
+                value = value.replace('\\\\', '\\').replace('\\"', '"')
+            pdict[name] = value
+    return key, pdict
diff --git a/lib/cherrypy/lib/httputil.py b/lib/cherrypy/lib/httputil.py
index ced310a0..7f0a2425 100644
--- a/lib/cherrypy/lib/httputil.py
+++ b/lib/cherrypy/lib/httputil.py
@@ -12,7 +12,6 @@ import email.utils
 import re
 import builtins
 from binascii import b2a_base64
-from cgi import parse_header
 from email.header import decode_header
 from http.server import BaseHTTPRequestHandler
 from urllib.parse import unquote_plus
@@ -21,6 +20,7 @@ import jaraco.collections
 
 import cherrypy
 from cherrypy._cpcompat import ntob, ntou
+from .headers import parse_header
 
 response_codes = BaseHTTPRequestHandler.responses.copy()
 
@@ -71,10 +71,10 @@ def protocol_from_http(protocol_str):
 def get_ranges(headervalue, content_length):
     """Return a list of (start, stop) indices from a Range header, or None.
 
-    Each (start, stop) tuple will be composed of two ints, which are suitable
-    for use in a slicing operation. That is, the header "Range: bytes=3-6",
-    if applied against a Python string, is requesting resource[3:7]. This
-    function will return the list [(3, 7)].
+    Each (start, stop) tuple will be composed of two ints, which are
+    suitable for use in a slicing operation. That is, the header "Range:
+    bytes=3-6", if applied against a Python string, is requesting
+    resource[3:7]. This function will return the list [(3, 7)].
 
     If this function returns an empty list, you should return HTTP 416.
     """
@@ -127,7 +127,6 @@ def get_ranges(headervalue, content_length):
 
 
 class HeaderElement(object):
-
     """An element (with parameters) from an HTTP header's element list."""
 
     def __init__(self, value, params=None):
@@ -169,14 +168,14 @@ q_separator = re.compile(r'; *q *=')
 
 
 class AcceptElement(HeaderElement):
-
     """An element (with parameters) from an Accept* header's element list.
 
-    AcceptElement objects are comparable; the more-preferred object will be
-    "less than" the less-preferred object. They are also therefore sortable;
-    if you sort a list of AcceptElement objects, they will be listed in
-    priority order; the most preferred value will be first. Yes, it should
-    have been the other way around, but it's too late to fix now.
+    AcceptElement objects are comparable; the more-preferred object will
+    be "less than" the less-preferred object. They are also therefore
+    sortable; if you sort a list of AcceptElement objects, they will be
+    listed in priority order; the most preferred value will be first.
+    Yes, it should have been the other way around, but it's too late to
+    fix now.
     """
 
     @classmethod
@@ -249,8 +248,7 @@ def header_elements(fieldname, fieldvalue):
 
 
 def decode_TEXT(value):
-    r"""
-    Decode :rfc:`2047` TEXT
+    r"""Decode :rfc:`2047` TEXT.
 
     >>> decode_TEXT("=?utf-8?q?f=C3=BCr?=") == b'f\xfcr'.decode('latin-1')
     True
@@ -265,9 +263,7 @@ def decode_TEXT(value):
 
 
 def decode_TEXT_maybe(value):
-    """
-    Decode the text but only if '=?' appears in it.
-    """
+    """Decode the text but only if '=?' appears in it."""
     return decode_TEXT(value) if '=?' in value else value
 
 
@@ -388,7 +384,6 @@ def parse_query_string(query_string, keep_blank_values=True, encoding='utf-8'):
 
 
 class CaseInsensitiveDict(jaraco.collections.KeyTransformingDict):
-
     """A case-insensitive dict subclass.
 
     Each key is changed on entry to title case.
@@ -417,7 +412,6 @@ else:
 
 
 class HeaderMap(CaseInsensitiveDict):
-
     """A dict subclass for HTTP request and response headers.
 
     Each key is changed on entry to str(key).title(). This allows headers
@@ -494,7 +488,6 @@ class HeaderMap(CaseInsensitiveDict):
 
 
 class Host(object):
-
     """An internet address.
 
     name
diff --git a/lib/cherrypy/lib/locking.py b/lib/cherrypy/lib/locking.py
index 317fb58c..ea76450a 100644
--- a/lib/cherrypy/lib/locking.py
+++ b/lib/cherrypy/lib/locking.py
@@ -7,22 +7,22 @@ class NeverExpires(object):
 
 
 class Timer(object):
-    """
-    A simple timer that will indicate when an expiration time has passed.
-    """
+    """A simple timer that will indicate when an expiration time has passed."""
     def __init__(self, expiration):
         'Create a timer that expires at `expiration` (UTC datetime)'
         self.expiration = expiration
 
     @classmethod
     def after(cls, elapsed):
-        """
-        Return a timer that will expire after `elapsed` passes.
-        """
-        return cls(datetime.datetime.utcnow() + elapsed)
+        """Return a timer that will expire after `elapsed` passes."""
+        return cls(
+            datetime.datetime.now(datetime.timezone.utc) + elapsed,
+        )
 
     def expired(self):
-        return datetime.datetime.utcnow() >= self.expiration
+        return datetime.datetime.now(
+            datetime.timezone.utc,
+        ) >= self.expiration
 
 
 class LockTimeout(Exception):
@@ -30,9 +30,7 @@ class LockTimeout(Exception):
 
 
 class LockChecker(object):
-    """
-    Keep track of the time and detect if a timeout has expired
-    """
+    """Keep track of the time and detect if a timeout has expired."""
     def __init__(self, session_id, timeout):
         self.session_id = session_id
         if timeout:
diff --git a/lib/cherrypy/lib/profiler.py b/lib/cherrypy/lib/profiler.py
index 7182278a..9cda41d8 100644
--- a/lib/cherrypy/lib/profiler.py
+++ b/lib/cherrypy/lib/profiler.py
@@ -30,7 +30,6 @@ to get a quick sanity-check on overall CP performance. Use the
 ``--profile`` flag when running the test suite. Then, use the ``serve()``
 function to browse the results in a web browser. If you run this
 module from the command line, it will call ``serve()`` for you.
-
 """
 
 import io
diff --git a/lib/cherrypy/lib/reprconf.py b/lib/cherrypy/lib/reprconf.py
index 536b9417..53261094 100644
--- a/lib/cherrypy/lib/reprconf.py
+++ b/lib/cherrypy/lib/reprconf.py
@@ -27,18 +27,17 @@ from cherrypy._cpcompat import text_or_bytes
 
 
 class NamespaceSet(dict):
-
     """A dict of config namespace names and handlers.
 
-    Each config entry should begin with a namespace name; the corresponding
-    namespace handler will be called once for each config entry in that
-    namespace, and will be passed two arguments: the config key (with the
-    namespace removed) and the config value.
+    Each config entry should begin with a namespace name; the
+    corresponding namespace handler will be called once for each config
+    entry in that namespace, and will be passed two arguments: the
+    config key (with the namespace removed) and the config value.
 
     Namespace handlers may be any Python callable; they may also be
-    context managers, in which case their __enter__
-    method should return a callable to be used as the handler.
-    See cherrypy.tools (the Toolbox class) for an example.
+    context managers, in which case their __enter__ method should return
+    a callable to be used as the handler. See cherrypy.tools (the
+    Toolbox class) for an example.
     """
 
     def __call__(self, config):
@@ -48,9 +47,10 @@ class NamespaceSet(dict):
             A flat dict, where keys use dots to separate
             namespaces, and values are arbitrary.
 
-        The first name in each config key is used to look up the corresponding
-        namespace handler. For example, a config entry of {'tools.gzip.on': v}
-        will call the 'tools' namespace handler with the args: ('gzip.on', v)
+        The first name in each config key is used to look up the
+        corresponding namespace handler. For example, a config entry of
+        {'tools.gzip.on': v} will call the 'tools' namespace handler
+        with the args: ('gzip.on', v)
         """
         # Separate the given config into namespaces
         ns_confs = {}
@@ -103,7 +103,6 @@ class NamespaceSet(dict):
 
 
 class Config(dict):
-
     """A dict-like set of configuration data, with defaults and namespaces.
 
     May take a file, filename, or dict.
@@ -167,7 +166,7 @@ class Parser(configparser.ConfigParser):
                 self._read(fp, filename)
 
     def as_dict(self, raw=False, vars=None):
-        """Convert an INI file to a dictionary"""
+        """Convert an INI file to a dictionary."""
         # Load INI file into a dict
         result = {}
         for section in self.sections():
diff --git a/lib/cherrypy/lib/sessions.py b/lib/cherrypy/lib/sessions.py
index 0f56a4fa..68badd93 100644
--- a/lib/cherrypy/lib/sessions.py
+++ b/lib/cherrypy/lib/sessions.py
@@ -120,7 +120,6 @@ missing = object()
 
 
 class Session(object):
-
     """A CherryPy dict-like Session object (one per request)."""
 
     _id = None
@@ -148,9 +147,11 @@ class Session(object):
     to session data."""
 
     loaded = False
+    """If True, data has been retrieved from storage.
+
+    This should happen automatically on the first attempt to access
+    session data.
     """
-    If True, data has been retrieved from storage. This should happen
-    automatically on the first attempt to access session data."""
 
     clean_thread = None
     'Class-level Monitor which calls self.clean_up.'
@@ -165,9 +166,10 @@ class Session(object):
     'True if the session requested by the client did not exist.'
 
     regenerated = False
+    """True if the application called session.regenerate().
+
+    This is not set by internal calls to regenerate the session id.
     """
-    True if the application called session.regenerate(). This is not set by
-    internal calls to regenerate the session id."""
 
     debug = False
     'If True, log debug information.'
@@ -335,8 +337,9 @@ class Session(object):
 
     def pop(self, key, default=missing):
         """Remove the specified key and return the corresponding value.
-        If key is not found, default is returned if given,
-        otherwise KeyError is raised.
+
+        If key is not found, default is returned if given, otherwise
+        KeyError is raised.
         """
         if not self.loaded:
             self.load()
@@ -351,13 +354,19 @@ class Session(object):
         return key in self._data
 
     def get(self, key, default=None):
-        """D.get(k[,d]) -> D[k] if k in D, else d.  d defaults to None."""
+        """D.get(k[,d]) -> D[k] if k in D, else d.
+
+        d defaults to None.
+        """
         if not self.loaded:
             self.load()
         return self._data.get(key, default)
 
     def update(self, d):
-        """D.update(E) -> None.  Update D from E: for k in E: D[k] = E[k]."""
+        """D.update(E) -> None.
+
+        Update D from E: for k in E: D[k] = E[k].
+        """
         if not self.loaded:
             self.load()
         self._data.update(d)
@@ -369,7 +378,10 @@ class Session(object):
         return self._data.setdefault(key, default)
 
     def clear(self):
-        """D.clear() -> None.  Remove all items from D."""
+        """D.clear() -> None.
+
+        Remove all items from D.
+        """
         if not self.loaded:
             self.load()
         self._data.clear()
@@ -492,7 +504,8 @@ class FileSession(Session):
         """Set up the storage system for file-based sessions.
 
         This should only be called once per process; this will be done
-        automatically when using sessions.init (as the built-in Tool does).
+        automatically when using sessions.init (as the built-in Tool
+        does).
         """
         # The 'storage_path' arg is required for file-based sessions.
         kwargs['storage_path'] = os.path.abspath(kwargs['storage_path'])
@@ -616,7 +629,8 @@ class MemcachedSession(Session):
         """Set up the storage system for memcached-based sessions.
 
         This should only be called once per process; this will be done
-        automatically when using sessions.init (as the built-in Tool does).
+        automatically when using sessions.init (as the built-in Tool
+        does).
         """
         for k, v in kwargs.items():
             setattr(cls, k, v)
diff --git a/lib/cherrypy/lib/static.py b/lib/cherrypy/lib/static.py
index c1ad95f3..a942b1b5 100644
--- a/lib/cherrypy/lib/static.py
+++ b/lib/cherrypy/lib/static.py
@@ -56,15 +56,15 @@ def serve_file(path, content_type=None, disposition=None, name=None,
                debug=False):
     """Set status, headers, and body in order to serve the given path.
 
-    The Content-Type header will be set to the content_type arg, if provided.
-    If not provided, the Content-Type will be guessed by the file extension
-    of the 'path' argument.
+    The Content-Type header will be set to the content_type arg, if
+    provided. If not provided, the Content-Type will be guessed by the
+    file extension of the 'path' argument.
 
-    If disposition is not None, the Content-Disposition header will be set
-    to "<disposition>; filename=<name>; filename*=utf-8''<name>"
-    as described in :rfc:`6266#appendix-D`.
-    If name is None, it will be set to the basename of path.
-    If disposition is None, no Content-Disposition header will be written.
+    If disposition is not None, the Content-Disposition header will be
+    set to "<disposition>; filename=<name>; filename*=utf-8''<name>" as
+    described in :rfc:`6266#appendix-D`. If name is None, it will be set
+    to the basename of path. If disposition is None, no Content-
+    Disposition header will be written.
     """
     response = cherrypy.serving.response
 
diff --git a/lib/cherrypy/process/plugins.py b/lib/cherrypy/process/plugins.py
index e96fb1ce..20bf1c66 100644
--- a/lib/cherrypy/process/plugins.py
+++ b/lib/cherrypy/process/plugins.py
@@ -31,7 +31,6 @@ _module__file__base = os.getcwd()
 
 
 class SimplePlugin(object):
-
     """Plugin base class which auto-subscribes methods for known channels."""
 
     bus = None
@@ -59,7 +58,6 @@ class SimplePlugin(object):
 
 
 class SignalHandler(object):
-
     """Register bus channels (and listeners) for system signals.
 
     You can modify what signals your application listens for, and what it does
@@ -171,8 +169,8 @@ class SignalHandler(object):
         If the optional 'listener' argument is provided, it will be
         subscribed as a listener for the given signal's channel.
 
-        If the given signal name or number is not available on the current
-        platform, ValueError is raised.
+        If the given signal name or number is not available on the
+        current platform, ValueError is raised.
         """
         if isinstance(signal, text_or_bytes):
             signum = getattr(_signal, signal, None)
@@ -218,11 +216,10 @@ except ImportError:
 
 
 class DropPrivileges(SimplePlugin):
-
     """Drop privileges. uid/gid arguments not available on Windows.
 
     Special thanks to `Gavin Baker
-    <http://antonym.org/2005/12/dropping-privileges-in-python.html>`_
+    <http://antonym.org/2005/12/dropping-privileges-in-python.html>`_.
     """
 
     def __init__(self, bus, umask=None, uid=None, gid=None):
@@ -234,7 +231,10 @@ class DropPrivileges(SimplePlugin):
 
     @property
     def uid(self):
-        """The uid under which to run. Availability: Unix."""
+        """The uid under which to run.
+
+        Availability: Unix.
+        """
         return self._uid
 
     @uid.setter
@@ -250,7 +250,10 @@ class DropPrivileges(SimplePlugin):
 
     @property
     def gid(self):
-        """The gid under which to run. Availability: Unix."""
+        """The gid under which to run.
+
+        Availability: Unix.
+        """
         return self._gid
 
     @gid.setter
@@ -332,7 +335,6 @@ class DropPrivileges(SimplePlugin):
 
 
 class Daemonizer(SimplePlugin):
-
     """Daemonize the running script.
 
     Use this with a Web Site Process Bus via::
@@ -423,7 +425,6 @@ class Daemonizer(SimplePlugin):
 
 
 class PIDFile(SimplePlugin):
-
     """Maintain a PID file via a WSPBus."""
 
     def __init__(self, bus, pidfile):
@@ -453,12 +454,11 @@ class PIDFile(SimplePlugin):
 
 
 class PerpetualTimer(threading.Timer):
-
     """A responsive subclass of threading.Timer whose run() method repeats.
 
     Use this timer only when you really need a very interruptible timer;
-    this checks its 'finished' condition up to 20 times a second, which can
-    results in pretty high CPU usage
+    this checks its 'finished' condition up to 20 times a second, which
+    can results in pretty high CPU usage
     """
 
     def __init__(self, *args, **kwargs):
@@ -483,14 +483,14 @@ class PerpetualTimer(threading.Timer):
 
 
 class BackgroundTask(threading.Thread):
-
     """A subclass of threading.Thread whose run() method repeats.
 
-    Use this class for most repeating tasks. It uses time.sleep() to wait
-    for each interval, which isn't very responsive; that is, even if you call
-    self.cancel(), you'll have to wait until the sleep() call finishes before
-    the thread stops. To compensate, it defaults to being daemonic, which means
-    it won't delay stopping the whole process.
+    Use this class for most repeating tasks. It uses time.sleep() to
+    wait for each interval, which isn't very responsive; that is, even
+    if you call self.cancel(), you'll have to wait until the sleep()
+    call finishes before the thread stops. To compensate, it defaults to
+    being daemonic, which means it won't delay stopping the whole
+    process.
     """
 
     def __init__(self, interval, function, args=[], kwargs={}, bus=None):
@@ -525,7 +525,6 @@ class BackgroundTask(threading.Thread):
 
 
 class Monitor(SimplePlugin):
-
     """WSPBus listener to periodically run a callback in its own thread."""
 
     callback = None
@@ -582,7 +581,6 @@ class Monitor(SimplePlugin):
 
 
 class Autoreloader(Monitor):
-
     """Monitor which re-executes the process when files change.
 
     This :ref:`plugin<plugins>` restarts the process (via :func:`os.execv`)
@@ -699,20 +697,20 @@ class Autoreloader(Monitor):
 
 
 class ThreadManager(SimplePlugin):
-
     """Manager for HTTP request threads.
 
     If you have control over thread creation and destruction, publish to
-    the 'acquire_thread' and 'release_thread' channels (for each thread).
-    This will register/unregister the current thread and publish to
-    'start_thread' and 'stop_thread' listeners in the bus as needed.
+    the 'acquire_thread' and 'release_thread' channels (for each
+    thread). This will register/unregister the current thread and
+    publish to 'start_thread' and 'stop_thread' listeners in the bus as
+    needed.
 
     If threads are created and destroyed by code you do not control
     (e.g., Apache), then, at the beginning of every HTTP request,
     publish to 'acquire_thread' only. You should not publish to
-    'release_thread' in this case, since you do not know whether
-    the thread will be re-used or not. The bus will call
-    'stop_thread' listeners for you when it stops.
+    'release_thread' in this case, since you do not know whether the
+    thread will be re-used or not. The bus will call 'stop_thread'
+    listeners for you when it stops.
     """
 
     threads = None
diff --git a/lib/cherrypy/process/servers.py b/lib/cherrypy/process/servers.py
index 717a8de0..fdd4bb68 100644
--- a/lib/cherrypy/process/servers.py
+++ b/lib/cherrypy/process/servers.py
@@ -132,7 +132,6 @@ class Timeouts:
 
 
 class ServerAdapter(object):
-
     """Adapter for an HTTP server.
 
     If you need to start more than one HTTP server (to serve on multiple
@@ -188,9 +187,7 @@ class ServerAdapter(object):
 
     @property
     def description(self):
-        """
-        A description about where this server is bound.
-        """
+        """A description about where this server is bound."""
         if self.bind_addr is None:
             on_what = 'unknown interface (dynamic?)'
         elif isinstance(self.bind_addr, tuple):
@@ -292,7 +289,6 @@ class ServerAdapter(object):
 
 
 class FlupCGIServer(object):
-
     """Adapter for a flup.server.cgi.WSGIServer."""
 
     def __init__(self, *args, **kwargs):
@@ -316,7 +312,6 @@ class FlupCGIServer(object):
 
 
 class FlupFCGIServer(object):
-
     """Adapter for a flup.server.fcgi.WSGIServer."""
 
     def __init__(self, *args, **kwargs):
@@ -362,7 +357,6 @@ class FlupFCGIServer(object):
 
 
 class FlupSCGIServer(object):
-
     """Adapter for a flup.server.scgi.WSGIServer."""
 
     def __init__(self, *args, **kwargs):
diff --git a/lib/cherrypy/process/win32.py b/lib/cherrypy/process/win32.py
index b7a79b1b..305596ba 100644
--- a/lib/cherrypy/process/win32.py
+++ b/lib/cherrypy/process/win32.py
@@ -1,4 +1,7 @@
-"""Windows service. Requires pywin32."""
+"""Windows service.
+
+Requires pywin32.
+"""
 
 import os
 import win32api
@@ -11,7 +14,6 @@ from cherrypy.process import wspbus, plugins
 
 
 class ConsoleCtrlHandler(plugins.SimplePlugin):
-
     """A WSPBus plugin for handling Win32 console events (like Ctrl-C)."""
 
     def __init__(self, bus):
@@ -69,10 +71,10 @@ class ConsoleCtrlHandler(plugins.SimplePlugin):
 
 
 class Win32Bus(wspbus.Bus):
-
     """A Web Site Process Bus implementation for Win32.
 
-    Instead of time.sleep, this bus blocks using native win32event objects.
+    Instead of time.sleep, this bus blocks using native win32event
+    objects.
     """
 
     def __init__(self):
@@ -120,7 +122,6 @@ class Win32Bus(wspbus.Bus):
 
 
 class _ControlCodes(dict):
-
     """Control codes used to "signal" a service via ControlService.
 
     User-defined control codes are in the range 128-255. We generally use
@@ -152,7 +153,6 @@ def signal_child(service, command):
 
 
 class PyWebService(win32serviceutil.ServiceFramework):
-
     """Python Web Service."""
 
     _svc_name_ = 'Python Web Service'
diff --git a/lib/cherrypy/process/wspbus.py b/lib/cherrypy/process/wspbus.py
index a60cd51e..57b08b83 100644
--- a/lib/cherrypy/process/wspbus.py
+++ b/lib/cherrypy/process/wspbus.py
@@ -57,7 +57,6 @@ the new state.::
           |        \    |
           |         V   V
         STARTED <-- STARTING
-
 """
 
 import atexit
@@ -65,7 +64,7 @@ import atexit
 try:
     import ctypes
 except ImportError:
-    """Google AppEngine is shipped without ctypes
+    """Google AppEngine is shipped without ctypes.
 
     :seealso: http://stackoverflow.com/a/6523777/70170
     """
@@ -165,8 +164,8 @@ class Bus(object):
     All listeners for a given channel are guaranteed to be called even
     if others at the same channel fail. Each failure is logged, but
     execution proceeds on to the next listener. The only way to stop all
-    processing from inside a listener is to raise SystemExit and stop the
-    whole server.
+    processing from inside a listener is to raise SystemExit and stop
+    the whole server.
     """
 
     states = states
@@ -312,8 +311,9 @@ class Bus(object):
     def restart(self):
         """Restart the process (may close connections).
 
-        This method does not restart the process from the calling thread;
-        instead, it stops the bus and asks the main thread to call execv.
+        This method does not restart the process from the calling
+        thread; instead, it stops the bus and asks the main thread to
+        call execv.
         """
         self.execv = True
         self.exit()
@@ -327,10 +327,11 @@ class Bus(object):
         """Wait for the EXITING state, KeyboardInterrupt or SystemExit.
 
         This function is intended to be called only by the main thread.
-        After waiting for the EXITING state, it also waits for all threads
-        to terminate, and then calls os.execv if self.execv is True. This
-        design allows another thread to call bus.restart, yet have the main
-        thread perform the actual execv call (required on some platforms).
+        After waiting for the EXITING state, it also waits for all
+        threads to terminate, and then calls os.execv if self.execv is
+        True. This design allows another thread to call bus.restart, yet
+        have the main thread perform the actual execv call (required on
+        some platforms).
         """
         try:
             self.wait(states.EXITING, interval=interval, channel='main')
@@ -379,13 +380,14 @@ class Bus(object):
     def _do_execv(self):
         """Re-execute the current process.
 
-        This must be called from the main thread, because certain platforms
-        (OS X) don't allow execv to be called in a child thread very well.
+        This must be called from the main thread, because certain
+        platforms (OS X) don't allow execv to be called in a child
+        thread very well.
         """
         try:
             args = self._get_true_argv()
         except NotImplementedError:
-            """It's probably win32 or GAE"""
+            """It's probably win32 or GAE."""
             args = [sys.executable] + self._get_interpreter_argv() + sys.argv
 
         self.log('Re-spawning %s' % ' '.join(args))
@@ -472,7 +474,7 @@ class Bus(object):
                 c_ind = None
 
             if is_module:
-                """It's containing `-m -m` sequence of arguments"""
+                """It's containing `-m -m` sequence of arguments."""
                 if is_command and c_ind < m_ind:
                     """There's `-c -c` before `-m`"""
                     raise RuntimeError(
@@ -481,7 +483,7 @@ class Bus(object):
                 # Survive module argument here
                 original_module = sys.argv[0]
                 if not os.access(original_module, os.R_OK):
-                    """There's no such module exist"""
+                    """There's no such module exist."""
                     raise AttributeError(
                         "{} doesn't seem to be a module "
                         'accessible by current user'.format(original_module))
@@ -489,7 +491,7 @@ class Bus(object):
                 # ... and substitute it with the original module path:
                 _argv.insert(m_ind, original_module)
             elif is_command:
-                """It's containing just `-c -c` sequence of arguments"""
+                """It's containing just `-c -c` sequence of arguments."""
                 raise RuntimeError(
                     "Cannot reconstruct command from '-c'. "
                     'Ref: https://github.com/cherrypy/cherrypy/issues/1545')
@@ -512,13 +514,13 @@ class Bus(object):
         """Prepend current working dir to PATH environment variable if needed.
 
         If sys.path[0] is an empty string, the interpreter was likely
-        invoked with -m and the effective path is about to change on
-        re-exec.  Add the current directory to $PYTHONPATH to ensure
-        that the new process sees the same path.
+        invoked with -m and the effective path is about to change on re-
+        exec.  Add the current directory to $PYTHONPATH to ensure that
+        the new process sees the same path.
 
         This issue cannot be addressed in the general case because
-        Python cannot reliably reconstruct the
-        original command line (http://bugs.python.org/issue14208).
+        Python cannot reliably reconstruct the original command line (
+        http://bugs.python.org/issue14208).
 
         (This idea filched from tornado.autoreload)
         """
@@ -536,10 +538,10 @@ class Bus(object):
         """Set the CLOEXEC flag on all open files (except stdin/out/err).
 
         If self.max_cloexec_files is an integer (the default), then on
-        platforms which support it, it represents the max open files setting
-        for the operating system. This function will be called just before
-        the process is restarted via os.execv() to prevent open files
-        from persisting into the new process.
+        platforms which support it, it represents the max open files
+        setting for the operating system. This function will be called
+        just before the process is restarted via os.execv() to prevent
+        open files from persisting into the new process.
 
         Set self.max_cloexec_files to 0 to disable this behavior.
         """
@@ -578,7 +580,10 @@ class Bus(object):
         return t
 
     def log(self, msg='', level=20, traceback=False):
-        """Log the given message. Append the last traceback if requested."""
+        """Log the given message.
+
+        Append the last traceback if requested.
+        """
         if traceback:
             msg += '\n' + ''.join(_traceback.format_exception(*sys.exc_info()))
         self.publish('log', msg, level)
diff --git a/lib/cherrypy/scaffold/__init__.py b/lib/cherrypy/scaffold/__init__.py
index bcddba2d..1fa26bee 100644
--- a/lib/cherrypy/scaffold/__init__.py
+++ b/lib/cherrypy/scaffold/__init__.py
@@ -9,7 +9,6 @@ Even before any tweaking, this should serve a few demonstration pages.
 Change to this directory and run:
 
     cherryd -c site.conf
-
 """
 
 import cherrypy
diff --git a/lib/cherrypy/test/__init__.py b/lib/cherrypy/test/__init__.py
index 068382be..72c4c261 100644
--- a/lib/cherrypy/test/__init__.py
+++ b/lib/cherrypy/test/__init__.py
@@ -1,6 +1,4 @@
-"""
-Regression test suite for CherryPy.
-"""
+"""Regression test suite for CherryPy."""
 
 import os
 import sys
diff --git a/lib/cherrypy/test/_test_decorators.py b/lib/cherrypy/test/_test_decorators.py
index 74832e40..02effbee 100644
--- a/lib/cherrypy/test/_test_decorators.py
+++ b/lib/cherrypy/test/_test_decorators.py
@@ -1,4 +1,4 @@
-"""Test module for the @-decorator syntax, which is version-specific"""
+"""Test module for the @-decorator syntax, which is version-specific."""
 
 import cherrypy
 from cherrypy import expose, tools
diff --git a/lib/cherrypy/test/benchmark.py b/lib/cherrypy/test/benchmark.py
index 44dfeff1..9c65e17b 100644
--- a/lib/cherrypy/test/benchmark.py
+++ b/lib/cherrypy/test/benchmark.py
@@ -1,24 +1,24 @@
-"""CherryPy Benchmark Tool
+"""CherryPy Benchmark Tool.
 
-    Usage:
-        benchmark.py [options]
+Usage:
+    benchmark.py [options]
 
-    --null:        use a null Request object (to bench the HTTP server only)
-    --notests:     start the server but do not run the tests; this allows
-                   you to check the tested pages with a browser
-    --help:        show this help message
-    --cpmodpy:     run tests via apache on 54583 (with the builtin _cpmodpy)
-    --modpython:   run tests via apache on 54583 (with modpython_gateway)
-    --ab=path:     Use the ab script/executable at 'path' (see below)
-    --apache=path: Use the apache script/exe at 'path' (see below)
+--null:        use a null Request object (to bench the HTTP server only)
+--notests:     start the server but do not run the tests; this allows
+               you to check the tested pages with a browser
+--help:        show this help message
+--cpmodpy:     run tests via apache on 54583 (with the builtin _cpmodpy)
+--modpython:   run tests via apache on 54583 (with modpython_gateway)
+--ab=path:     Use the ab script/executable at 'path' (see below)
+--apache=path: Use the apache script/exe at 'path' (see below)
 
-    To run the benchmarks, the Apache Benchmark tool "ab" must either be on
-    your system path, or specified via the --ab=path option.
+To run the benchmarks, the Apache Benchmark tool "ab" must either be on
+your system path, or specified via the --ab=path option.
 
-    To run the modpython tests, the "apache" executable or script must be
-    on your system path, or provided via the --apache=path option. On some
-    platforms, "apache" may be called "apachectl" or "apache2ctl"--create
-    a symlink to them if needed.
+To run the modpython tests, the "apache" executable or script must be
+on your system path, or provided via the --apache=path option. On some
+platforms, "apache" may be called "apachectl" or "apache2ctl"--create
+a symlink to them if needed.
 """
 
 import getopt
@@ -106,7 +106,6 @@ def init():
 
 
 class NullRequest:
-
     """A null HTTP request class, returning 200 and an empty body."""
 
     def __init__(self, local, remote, scheme='http'):
@@ -131,65 +130,66 @@ class NullResponse:
 
 
 class ABSession:
-
     """A session of 'ab', the Apache HTTP server benchmarking tool.
 
-Example output from ab:
+    Example output from ab:
 
-This is ApacheBench, Version 2.0.40-dev <$Revision: 1.121.2.1 $> apache-2.0
-Copyright (c) 1996 Adam Twiss, Zeus Technology Ltd, http://www.zeustech.net/
-Copyright (c) 1998-2002 The Apache Software Foundation, http://www.apache.org/
+    This is ApacheBench, Version 2.0.40-dev <$Revision: 1.121.2.1 $> apache-2.0
+    Copyright (c) 1996 Adam Twiss, Zeus Technology Ltd,
+    http://www.zeustech.net/
+    Copyright (c) 1998-2002 The Apache Software Foundation,
+    http://www.apache.org/
 
-Benchmarking 127.0.0.1 (be patient)
-Completed 100 requests
-Completed 200 requests
-Completed 300 requests
-Completed 400 requests
-Completed 500 requests
-Completed 600 requests
-Completed 700 requests
-Completed 800 requests
-Completed 900 requests
+    Benchmarking 127.0.0.1 (be patient)
+    Completed 100 requests
+    Completed 200 requests
+    Completed 300 requests
+    Completed 400 requests
+    Completed 500 requests
+    Completed 600 requests
+    Completed 700 requests
+    Completed 800 requests
+    Completed 900 requests
 
 
-Server Software:        CherryPy/3.1beta
-Server Hostname:        127.0.0.1
-Server Port:            54583
+    Server Software:        CherryPy/3.1beta
+    Server Hostname:        127.0.0.1
+    Server Port:            54583
 
-Document Path:          /static/index.html
-Document Length:        14 bytes
+    Document Path:          /static/index.html
+    Document Length:        14 bytes
 
-Concurrency Level:      10
-Time taken for tests:   9.643867 seconds
-Complete requests:      1000
-Failed requests:        0
-Write errors:           0
-Total transferred:      189000 bytes
-HTML transferred:       14000 bytes
-Requests per second:    103.69 [#/sec] (mean)
-Time per request:       96.439 [ms] (mean)
-Time per request:       9.644 [ms] (mean, across all concurrent requests)
-Transfer rate:          19.08 [Kbytes/sec] received
+    Concurrency Level:      10
+    Time taken for tests:   9.643867 seconds
+    Complete requests:      1000
+    Failed requests:        0
+    Write errors:           0
+    Total transferred:      189000 bytes
+    HTML transferred:       14000 bytes
+    Requests per second:    103.69 [#/sec] (mean)
+    Time per request:       96.439 [ms] (mean)
+    Time per request:       9.644 [ms] (mean, across all concurrent requests)
+    Transfer rate:          19.08 [Kbytes/sec] received
 
-Connection Times (ms)
-              min  mean[+/-sd] median   max
-Connect:        0    0   2.9      0      10
-Processing:    20   94   7.3     90     130
-Waiting:        0   43  28.1     40     100
-Total:         20   95   7.3    100     130
+    Connection Times (ms)
+                  min  mean[+/-sd] median   max
+    Connect:        0    0   2.9      0      10
+    Processing:    20   94   7.3     90     130
+    Waiting:        0   43  28.1     40     100
+    Total:         20   95   7.3    100     130
 
-Percentage of the requests served within a certain time (ms)
-  50%    100
-  66%    100
-  75%    100
-  80%    100
-  90%    100
-  95%    100
-  98%    100
-  99%    110
- 100%    130 (longest request)
-Finished 1000 requests
-"""
+    Percentage of the requests served within a certain time (ms)
+      50%    100
+      66%    100
+      75%    100
+      80%    100
+      90%    100
+      95%    100
+      98%    100
+      99%    110
+     100%    130 (longest request)
+    Finished 1000 requests
+    """
 
     parse_patterns = [
         ('complete_requests', 'Completed',
@@ -403,7 +403,6 @@ if __name__ == '__main__':
     print('Starting CherryPy app server...')
 
     class NullWriter(object):
-
         """Suppresses the printing of socket errors."""
 
         def write(self, data):
diff --git a/lib/cherrypy/test/checkerdemo.py b/lib/cherrypy/test/checkerdemo.py
index 3438bd0c..02553ab0 100644
--- a/lib/cherrypy/test/checkerdemo.py
+++ b/lib/cherrypy/test/checkerdemo.py
@@ -1,8 +1,8 @@
 """Demonstration app for cherrypy.checker.
 
-This application is intentionally broken and badly designed.
-To demonstrate the output of the CherryPy Checker, simply execute
-this module.
+This application is intentionally broken and badly designed. To
+demonstrate the output of the CherryPy Checker, simply execute this
+module.
 """
 
 import os
diff --git a/lib/cherrypy/test/helper.py b/lib/cherrypy/test/helper.py
index cae49533..5cf93d0c 100644
--- a/lib/cherrypy/test/helper.py
+++ b/lib/cherrypy/test/helper.py
@@ -28,7 +28,6 @@ serverpem = os.path.join(os.getcwd(), thisdir, 'test.pem')
 
 
 class Supervisor(object):
-
     """Base class for modeling and controlling servers during testing."""
 
     def __init__(self, **kwargs):
@@ -43,14 +42,13 @@ def log_to_stderr(msg, level):
 
 
 class LocalSupervisor(Supervisor):
-
     """Base class for modeling/controlling servers which run in the same
     process.
 
-    When the server side runs in a different process, start/stop can dump all
-    state between each test module easily. When the server side runs in the
-    same process as the client, however, we have to do a bit more work to
-    ensure config and mounted apps are reset between tests.
+    When the server side runs in a different process, start/stop can
+    dump all state between each test module easily. When the server side
+    runs in the same process as the client, however, we have to do a bit
+    more work to ensure config and mounted apps are reset between tests.
     """
 
     using_apache = False
@@ -99,7 +97,6 @@ class LocalSupervisor(Supervisor):
 
 
 class NativeServerSupervisor(LocalSupervisor):
-
     """Server supervisor for the builtin HTTP server."""
 
     httpserver_class = 'cherrypy._cpnative_server.CPHTTPServer'
@@ -111,7 +108,6 @@ class NativeServerSupervisor(LocalSupervisor):
 
 
 class LocalWSGISupervisor(LocalSupervisor):
-
     """Server supervisor for the builtin WSGI server."""
 
     httpserver_class = 'cherrypy._cpwsgi_server.CPWSGIServer'
@@ -311,8 +307,7 @@ class CPWebCase(webtest.WebCase):
         sys.exit()
 
     def getPage(self, url, *args, **kwargs):
-        """Open the url.
-        """
+        """Open the url."""
         if self.script_name:
             url = httputil.urljoin(self.script_name, url)
         return webtest.WebCase.getPage(self, url, *args, **kwargs)
@@ -323,8 +318,9 @@ class CPWebCase(webtest.WebCase):
     def assertErrorPage(self, status, message=None, pattern=''):
         """Compare the response body with a built in error page.
 
-        The function will optionally look for the regexp pattern,
-        within the exception embedded in the error page."""
+        The function will optionally look for the regexp pattern, within
+        the exception embedded in the error page.
+        """
 
         # This will never contain a traceback
         page = cherrypy._cperror.get_error_page(status, message=message)
@@ -453,19 +449,17 @@ server.ssl_private_key: r'%s'
             '-c', self.config_file,
             '-p', self.pid_file,
         ]
-        r"""
-        Command for running cherryd server with autoreload enabled
+        r"""Command for running cherryd server with autoreload enabled.
 
         Using
 
         ```
         ['-c',
          "__requires__ = 'CherryPy'; \
-         import pkg_resources, re, sys; \
+         import importlib.metadata, re, sys; \
          sys.argv[0] = re.sub(r'(-script\.pyw?|\.exe)?$', '', sys.argv[0]); \
          sys.exit(\
-            pkg_resources.load_entry_point(\
-                'CherryPy', 'console_scripts', 'cherryd')())"]
+            importlib.metadata.distribution('cherrypy').entry_points[0])"]
         ```
 
         doesn't work as it's impossible to reconstruct the `-c`'s contents.
diff --git a/lib/cherrypy/test/logtest.py b/lib/cherrypy/test/logtest.py
index 112bdc25..acdc9587 100644
--- a/lib/cherrypy/test/logtest.py
+++ b/lib/cherrypy/test/logtest.py
@@ -1,4 +1,4 @@
-"""logtest, a unittest.TestCase helper for testing log output."""
+"""Logtest, a unittest.TestCase helper for testing log output."""
 
 import sys
 import time
@@ -32,7 +32,6 @@ except ImportError:
 
 
 class LogCase(object):
-
     """unittest.TestCase mixin for testing log messages.
 
     logfile: a filename for the desired log. Yes, I know modes are evil,
@@ -116,7 +115,8 @@ class LogCase(object):
         """Return lines from self.logfile in the marked region.
 
         If marker is None, self.lastmarker is used. If the log hasn't
-        been marked (using self.markLog), the entire log will be returned.
+        been marked (using self.markLog), the entire log will be
+        returned.
         """
 # Give the logger time to finish writing?
 # time.sleep(0.5)
@@ -146,9 +146,10 @@ class LogCase(object):
     def assertInLog(self, line, marker=None):
         """Fail if the given (partial) line is not in the log.
 
-        The log will be searched from the given marker to the next marker.
-        If marker is None, self.lastmarker is used. If the log hasn't
-        been marked (using self.markLog), the entire log will be searched.
+        The log will be searched from the given marker to the next
+        marker. If marker is None, self.lastmarker is used. If the log
+        hasn't been marked (using self.markLog), the entire log will be
+        searched.
         """
         data = self._read_marked_region(marker)
         for logline in data:
@@ -160,9 +161,10 @@ class LogCase(object):
     def assertNotInLog(self, line, marker=None):
         """Fail if the given (partial) line is in the log.
 
-        The log will be searched from the given marker to the next marker.
-        If marker is None, self.lastmarker is used. If the log hasn't
-        been marked (using self.markLog), the entire log will be searched.
+        The log will be searched from the given marker to the next
+        marker. If marker is None, self.lastmarker is used. If the log
+        hasn't been marked (using self.markLog), the entire log will be
+        searched.
         """
         data = self._read_marked_region(marker)
         for logline in data:
@@ -173,9 +175,10 @@ class LogCase(object):
     def assertValidUUIDv4(self, marker=None):
         """Fail if the given UUIDv4 is not valid.
 
-        The log will be searched from the given marker to the next marker.
-        If marker is None, self.lastmarker is used. If the log hasn't
-        been marked (using self.markLog), the entire log will be searched.
+        The log will be searched from the given marker to the next
+        marker. If marker is None, self.lastmarker is used. If the log
+        hasn't been marked (using self.markLog), the entire log will be
+        searched.
         """
         data = self._read_marked_region(marker)
         data = [
@@ -200,9 +203,10 @@ class LogCase(object):
     def assertLog(self, sliceargs, lines, marker=None):
         """Fail if log.readlines()[sliceargs] is not contained in 'lines'.
 
-        The log will be searched from the given marker to the next marker.
-        If marker is None, self.lastmarker is used. If the log hasn't
-        been marked (using self.markLog), the entire log will be searched.
+        The log will be searched from the given marker to the next
+        marker. If marker is None, self.lastmarker is used. If the log
+        hasn't been marked (using self.markLog), the entire log will be
+        searched.
         """
         data = self._read_marked_region(marker)
         if isinstance(sliceargs, int):
diff --git a/lib/cherrypy/test/modwsgi.py b/lib/cherrypy/test/modwsgi.py
index c3216284..911d4819 100644
--- a/lib/cherrypy/test/modwsgi.py
+++ b/lib/cherrypy/test/modwsgi.py
@@ -94,7 +94,6 @@ SetEnv testmod %(testmod)s
 
 
 class ModWSGISupervisor(helper.Supervisor):
-
     """Server Controller for ModWSGI and CherryPy."""
 
     using_apache = True
diff --git a/lib/cherrypy/test/sessiondemo.py b/lib/cherrypy/test/sessiondemo.py
index 3849a259..0eb13cf7 100644
--- a/lib/cherrypy/test/sessiondemo.py
+++ b/lib/cherrypy/test/sessiondemo.py
@@ -3,6 +3,7 @@
 
 import calendar
 from datetime import datetime
+from datetime import timezone as _timezone
 import sys
 
 import cherrypy
@@ -123,9 +124,12 @@ class Root(object):
             'reqcookie': cherrypy.request.cookie.output(),
             'sessiondata': list(cherrypy.session.items()),
             'servertime': (
-                datetime.utcnow().strftime('%Y/%m/%d %H:%M') + ' UTC'
+                datetime.now(_timezone.utc).strftime('%Y/%m/%d %H:%M UTC')
+            ),
+            'serverunixtime':
+            calendar.timegm(
+                datetime.utcnow(_timezone.utc).timetuple(),
             ),
-            'serverunixtime': calendar.timegm(datetime.utcnow().timetuple()),
             'cpversion': cherrypy.__version__,
             'pyversion': sys.version,
             'expires': expires,
diff --git a/lib/cherrypy/test/test_core.py b/lib/cherrypy/test/test_core.py
index 42460b3f..1753957a 100644
--- a/lib/cherrypy/test/test_core.py
+++ b/lib/cherrypy/test/test_core.py
@@ -1,5 +1,4 @@
 # coding: utf-8
-
 """Basic tests for the CherryPy core: request handling."""
 
 import os
@@ -48,7 +47,6 @@ class CoreRequestHandlingTest(helper.CPWebCase):
         root.expose_dec = ExposeExamples()
 
         class TestType(type):
-
             """Metaclass which automatically exposes all functions in each
             subclass, and adds an instance of the subclass as an attribute
             of root.
diff --git a/lib/cherrypy/test/test_dynamicobjectmapping.py b/lib/cherrypy/test/test_dynamicobjectmapping.py
index aaa89ca7..6ac33932 100644
--- a/lib/cherrypy/test/test_dynamicobjectmapping.py
+++ b/lib/cherrypy/test/test_dynamicobjectmapping.py
@@ -97,9 +97,7 @@ def setup_server():
     class UserContainerNode(object):
 
         def POST(self, name):
-            """
-            Allow the creation of a new Object
-            """
+            """Allow the creation of a new Object."""
             return 'POST %d' % make_user(name)
 
         def GET(self):
@@ -125,15 +123,11 @@ def setup_server():
                 raise cherrypy.HTTPError(404)
 
         def GET(self, *args, **kwargs):
-            """
-            Return the appropriate representation of the instance.
-            """
+            """Return the appropriate representation of the instance."""
             return str(self.user)
 
         def POST(self, name):
-            """
-            Update the fields of the user instance.
-            """
+            """Update the fields of the user instance."""
             self.user.name = name
             return 'POST %d' % self.user.id
 
@@ -151,9 +145,7 @@ def setup_server():
                 return 'PUT %d' % make_user(name, self.id)
 
         def DELETE(self):
-            """
-            Delete the user specified at the id.
-            """
+            """Delete the user specified at the id."""
             id = self.user.id
             del user_lookup[self.user.id]
             del self.user
@@ -199,7 +191,6 @@ def setup_server():
             return 'IndexOnly index'
 
     class DecoratedPopArgs:
-
         """Test _cp_dispatch with @cherrypy.popargs."""
 
         @cherrypy.expose
@@ -213,7 +204,6 @@ def setup_server():
         'a', 'b', handler=ABHandler())(DecoratedPopArgs)
 
     class NonDecoratedPopArgs:
-
         """Test _cp_dispatch = cherrypy.popargs()"""
 
         _cp_dispatch = cherrypy.popargs('a')
@@ -223,8 +213,7 @@ def setup_server():
             return 'index: ' + str(a)
 
     class ParameterizedHandler:
-
-        """Special handler created for each request"""
+        """Special handler created for each request."""
 
         def __init__(self, a):
             self.a = a
@@ -238,8 +227,7 @@ def setup_server():
             return self.a
 
     class ParameterizedPopArgs:
-
-        """Test cherrypy.popargs() with a function call handler"""
+        """Test cherrypy.popargs() with a function call handler."""
     ParameterizedPopArgs = cherrypy.popargs(
         'a', handler=ParameterizedHandler)(ParameterizedPopArgs)
 
diff --git a/lib/cherrypy/test/test_http.py b/lib/cherrypy/test/test_http.py
index 9a7e9331..4fae0ea8 100644
--- a/lib/cherrypy/test/test_http.py
+++ b/lib/cherrypy/test/test_http.py
@@ -16,9 +16,7 @@ from cherrypy.test import helper
 
 
 def is_ascii(text):
-    """
-    Return True if the text encodes as ascii.
-    """
+    """Return True if the text encodes as ascii."""
     try:
         text.encode('ascii')
         return True
@@ -28,9 +26,9 @@ def is_ascii(text):
 
 
 def encode_filename(filename):
-    """
-    Given a filename to be used in a multipart/form-data,
-    encode the name. Return the key and encoded filename.
+    """Given a filename to be used in a multipart/form-data, encode the name.
+
+    Return the key and encoded filename.
     """
     if is_ascii(filename):
         return 'filename', '"{filename}"'.format(**locals())
@@ -114,7 +112,7 @@ class HTTPTests(helper.CPWebCase):
 
             @cherrypy.expose
             def post_filename(self, myfile):
-                '''Return the name of the file which was uploaded.'''
+                """Return the name of the file which was uploaded."""
                 return myfile.filename
 
         cherrypy.tree.mount(Root())
diff --git a/lib/cherrypy/test/test_logging.py b/lib/cherrypy/test/test_logging.py
index 49d41d0a..05203926 100644
--- a/lib/cherrypy/test/test_logging.py
+++ b/lib/cherrypy/test/test_logging.py
@@ -199,7 +199,7 @@ def test_custom_log_format(log_tracker, monkeypatch, server):
 
 
 def test_utc_in_timez(monkeypatch):
-    """Test that ``LazyRfc3339UtcTime`` is rendered as ``str`` using UTC timestamp."""
+    """Test ``LazyRfc3339UtcTime`` renders as ``str`` UTC timestamp."""
     utcoffset8_local_time_in_naive_utc = (
         datetime.datetime(
             year=2020,
@@ -216,7 +216,7 @@ def test_utc_in_timez(monkeypatch):
 
     class mock_datetime:
         @classmethod
-        def utcnow(cls):
+        def now(cls, tz):
             return utcoffset8_local_time_in_naive_utc
 
     monkeypatch.setattr('datetime.datetime', mock_datetime)
diff --git a/lib/cherrypy/test/test_plugins.py b/lib/cherrypy/test/test_plugins.py
index 4d3aa6b1..e69212db 100644
--- a/lib/cherrypy/test/test_plugins.py
+++ b/lib/cherrypy/test/test_plugins.py
@@ -6,8 +6,7 @@ __metaclass__ = type
 
 class TestAutoreloader:
     def test_file_for_file_module_when_None(self):
-        """No error when module.__file__ is None.
-        """
+        """No error when ``module.__file__`` is :py:data:`None`."""
         class test_module:
             __file__ = None
 
diff --git a/lib/cherrypy/test/test_request_obj.py b/lib/cherrypy/test/test_request_obj.py
index 2478aabe..2b3f60f0 100644
--- a/lib/cherrypy/test/test_request_obj.py
+++ b/lib/cherrypy/test/test_request_obj.py
@@ -275,7 +275,6 @@ class RequestObjectTests(helper.CPWebCase):
                 return 'success'
 
         class Divorce(Test):
-
             """HTTP Method handlers shouldn't collide with normal method names.
             For example, a GET-handler shouldn't collide with a method named
             'get'.
@@ -757,8 +756,8 @@ class RequestObjectTests(helper.CPWebCase):
         self.assertBody('application/json')
 
     def test_dangerous_host(self):
-        """
-        Dangerous characters like newlines should be elided.
+        """Dangerous characters like newlines should be elided.
+
         Ref #1974.
         """
         # foo\nbar
diff --git a/lib/cherrypy/test/test_session.py b/lib/cherrypy/test/test_session.py
index 2d869e4b..ec1f8d70 100644
--- a/lib/cherrypy/test/test_session.py
+++ b/lib/cherrypy/test/test_session.py
@@ -4,7 +4,7 @@ import threading
 import time
 from http.client import HTTPConnection
 
-from distutils.spawn import find_executable
+from shutil import which
 import pytest
 from path import Path
 from more_itertools import consume
@@ -146,9 +146,14 @@ class SessionTest(helper.CPWebCase):
     def teardown_class(cls):
         """Clean up sessions."""
         super(cls, cls).teardown_class()
+        try:
+            files_to_clean = localDir.iterdir()  # Python 3.8+
+        except AttributeError:
+            files_to_clean = localDir.listdir()  # Python 3.6-3.7
+
         consume(
             file.remove_p()
-            for file in localDir.listdir()
+            for file in files_to_clean
             if file.basename().startswith(
                 sessions.FileSession.SESSION_PREFIX
             )
@@ -402,7 +407,7 @@ class SessionTest(helper.CPWebCase):
 
 
 def is_memcached_present():
-    executable = find_executable('memcached')
+    executable = which('memcached')
     return bool(executable)
 
 
@@ -418,9 +423,7 @@ def memcached_client_present():
 
 @pytest.fixture(scope='session')
 def memcached_instance(request, watcher_getter, memcached_server_present):
-    """
-    Start up an instance of memcached.
-    """
+    """Start up an instance of memcached."""
 
     port = portend.find_available_local_port()
 
diff --git a/lib/cherrypy/test/test_states.py b/lib/cherrypy/test/test_states.py
index d59a4d87..64177762 100644
--- a/lib/cherrypy/test/test_states.py
+++ b/lib/cherrypy/test/test_states.py
@@ -433,14 +433,13 @@ test_case_name: "test_signal_handler_unsubscribe"
 
 
 def test_safe_wait_INADDR_ANY():  # pylint: disable=invalid-name
-    """
-    Wait on INADDR_ANY should not raise IOError
+    """Wait on INADDR_ANY should not raise IOError.
 
-    In cases where the loopback interface does not exist, CherryPy cannot
-    effectively determine if a port binding to INADDR_ANY was effected.
-    In this situation, CherryPy should assume that it failed to detect
-    the binding (not that the binding failed) and only warn that it could
-    not verify it.
+    In cases where the loopback interface does not exist, CherryPy
+    cannot effectively determine if a port binding to INADDR_ANY was
+    effected. In this situation, CherryPy should assume that it failed
+    to detect the binding (not that the binding failed) and only warn
+    that it could not verify it.
     """
     # At such a time that CherryPy can reliably determine one or more
     #  viable IP addresses of the host, this test may be removed.
diff --git a/lib/cherrypy/test/test_tools.py b/lib/cherrypy/test/test_tools.py
index 40de2e52..23c59bc2 100644
--- a/lib/cherrypy/test/test_tools.py
+++ b/lib/cherrypy/test/test_tools.py
@@ -460,9 +460,7 @@ class SessionAuthTest(unittest.TestCase):
 
 class TestHooks:
     def test_priorities(self):
-        """
-        Hooks should sort by priority order.
-        """
+        """Hooks should sort by priority order."""
         Hook = cherrypy._cprequest.Hook
         hooks = [
             Hook(None, priority=48),
diff --git a/lib/cherrypy/test/test_tutorials.py b/lib/cherrypy/test/test_tutorials.py
index 390caac8..4594faa1 100644
--- a/lib/cherrypy/test/test_tutorials.py
+++ b/lib/cherrypy/test/test_tutorials.py
@@ -9,18 +9,14 @@ class TutorialTest(helper.CPWebCase):
 
     @classmethod
     def setup_server(cls):
-        """
-        Mount something so the engine starts.
-        """
+        """Mount something so the engine starts."""
         class Dummy:
             pass
         cherrypy.tree.mount(Dummy())
 
     @staticmethod
     def load_module(name):
-        """
-        Import or reload tutorial module as needed.
-        """
+        """Import or reload tutorial module as needed."""
         target = 'cherrypy.tutorial.' + name
         if target in sys.modules:
             module = importlib.reload(sys.modules[target])
diff --git a/lib/cherrypy/test/test_wsgi_unix_socket.py b/lib/cherrypy/test/test_wsgi_unix_socket.py
index df0ab5f8..32a3fca8 100644
--- a/lib/cherrypy/test/test_wsgi_unix_socket.py
+++ b/lib/cherrypy/test/test_wsgi_unix_socket.py
@@ -21,9 +21,7 @@ USOCKET_PATH = usocket_path()
 
 
 class USocketHTTPConnection(HTTPConnection):
-    """
-    HTTPConnection over a unix socket.
-    """
+    """HTTPConnection over a unix socket."""
 
     def __init__(self, path):
         HTTPConnection.__init__(self, 'localhost')
diff --git a/lib/cherrypy/tutorial/tut01_helloworld.py b/lib/cherrypy/tutorial/tut01_helloworld.py
index e86793c8..e575a9e2 100644
--- a/lib/cherrypy/tutorial/tut01_helloworld.py
+++ b/lib/cherrypy/tutorial/tut01_helloworld.py
@@ -11,8 +11,7 @@ import cherrypy
 
 
 class HelloWorld:
-
-    """ Sample request handler class. """
+    """Sample request handler class."""
 
     # Expose the index method through the web. CherryPy will never
     # publish methods that don't have the exposed attribute set to True.
diff --git a/lib/more_itertools/__init__.py b/lib/more_itertools/__init__.py
index aff94a9a..9c4662fc 100644
--- a/lib/more_itertools/__init__.py
+++ b/lib/more_itertools/__init__.py
@@ -3,4 +3,4 @@
 from .more import *  # noqa
 from .recipes import *  # noqa
 
-__version__ = '10.2.0'
+__version__ = '10.3.0'
diff --git a/lib/more_itertools/more.py b/lib/more_itertools/more.py
index dd711a47..7b481907 100755
--- a/lib/more_itertools/more.py
+++ b/lib/more_itertools/more.py
@@ -1,3 +1,4 @@
+import math
 import warnings
 
 from collections import Counter, defaultdict, deque, abc
@@ -6,6 +7,7 @@ from functools import cached_property, partial, reduce, wraps
 from heapq import heapify, heapreplace, heappop
 from itertools import (
     chain,
+    combinations,
     compress,
     count,
     cycle,
@@ -19,7 +21,7 @@ from itertools import (
     zip_longest,
     product,
 )
-from math import exp, factorial, floor, log, perm, comb
+from math import comb, e, exp, factorial, floor, fsum, log, perm, tau
 from queue import Empty, Queue
 from random import random, randrange, uniform
 from operator import itemgetter, mul, sub, gt, lt, ge, le
@@ -61,11 +63,13 @@ __all__ = [
     'consumer',
     'count_cycle',
     'countable',
+    'dft',
     'difference',
     'distinct_combinations',
     'distinct_permutations',
     'distribute',
     'divide',
+    'doublestarmap',
     'duplicates_everseen',
     'duplicates_justseen',
     'classify_unique',
@@ -77,6 +81,7 @@ __all__ = [
     'groupby_transform',
     'ichunked',
     'iequals',
+    'idft',
     'ilen',
     'interleave',
     'interleave_evenly',
@@ -86,6 +91,7 @@ __all__ = [
     'islice_extended',
     'iterate',
     'iter_suppress',
+    'join_mappings',
     'last',
     'locate',
     'longest_common_prefix',
@@ -109,6 +115,7 @@ __all__ = [
     'partitions',
     'peekable',
     'permutation_index',
+    'powerset_of_sets',
     'product_index',
     'raise_',
     'repeat_each',
@@ -148,6 +155,9 @@ __all__ = [
     'zip_offset',
 ]
 
+# math.sumprod is available for Python 3.12+
+_fsumprod = getattr(math, 'sumprod', lambda x, y: fsum(map(mul, x, y)))
+
 
 def chunked(iterable, n, strict=False):
     """Break *iterable* into lists of length *n*:
@@ -550,10 +560,10 @@ def one(iterable, too_short=None, too_long=None):
 
     try:
         first_value = next(it)
-    except StopIteration as e:
+    except StopIteration as exc:
         raise (
             too_short or ValueError('too few items in iterable (expected 1)')
-        ) from e
+        ) from exc
 
     try:
         second_value = next(it)
@@ -840,26 +850,31 @@ def windowed(seq, n, fillvalue=None, step=1):
     if n < 0:
         raise ValueError('n must be >= 0')
     if n == 0:
-        yield tuple()
+        yield ()
         return
     if step < 1:
         raise ValueError('step must be >= 1')
 
-    window = deque(maxlen=n)
-    i = n
-    for _ in map(window.append, seq):
-        i -= 1
-        if not i:
-            i = step
-            yield tuple(window)
+    iterable = iter(seq)
 
-    size = len(window)
-    if size == 0:
+    # Generate first window
+    window = deque(islice(iterable, n), maxlen=n)
+
+    # Deal with the first window not being full
+    if not window:
         return
-    elif size < n:
-        yield tuple(chain(window, repeat(fillvalue, n - size)))
-    elif 0 < i < min(step, n):
-        window += (fillvalue,) * i
+    if len(window) < n:
+        yield tuple(window) + ((fillvalue,) * (n - len(window)))
+        return
+    yield tuple(window)
+
+    # Create the filler for the next windows. The padding ensures
+    # we have just enough elements to fill the last window.
+    padding = (fillvalue,) * (n - 1 if step >= n else step - 1)
+    filler = map(window.append, chain(iterable, padding))
+
+    # Generate the rest of the windows
+    for _ in islice(filler, step - 1, None, step):
         yield tuple(window)
 
 
@@ -1151,8 +1166,8 @@ def interleave_evenly(iterables, lengths=None):
 
         # those iterables for which the error is negative are yielded
         # ("diagonal step" in Bresenham)
-        for i, e in enumerate(errors):
-            if e < 0:
+        for i, e_ in enumerate(errors):
+            if e_ < 0:
                 yield next(iters_secondary[i])
                 to_yield -= 1
                 errors[i] += delta_primary
@@ -1184,26 +1199,38 @@ def collapse(iterable, base_type=None, levels=None):
     ['a', ['b'], 'c', ['d']]
 
     """
+    stack = deque()
+    # Add our first node group, treat the iterable as a single node
+    stack.appendleft((0, repeat(iterable, 1)))
 
-    def walk(node, level):
-        if (
-            ((levels is not None) and (level > levels))
-            or isinstance(node, (str, bytes))
-            or ((base_type is not None) and isinstance(node, base_type))
-        ):
-            yield node
-            return
+    while stack:
+        node_group = stack.popleft()
+        level, nodes = node_group
 
-        try:
-            tree = iter(node)
-        except TypeError:
-            yield node
-            return
-        else:
-            for child in tree:
-                yield from walk(child, level + 1)
+        # Check if beyond max level
+        if levels is not None and level > levels:
+            yield from nodes
+            continue
 
-    yield from walk(iterable, 0)
+        for node in nodes:
+            # Check if done iterating
+            if isinstance(node, (str, bytes)) or (
+                (base_type is not None) and isinstance(node, base_type)
+            ):
+                yield node
+            # Otherwise try to create child nodes
+            else:
+                try:
+                    tree = iter(node)
+                except TypeError:
+                    yield node
+                else:
+                    # Save our current location
+                    stack.appendleft(node_group)
+                    # Append the new child node
+                    stack.appendleft((level + 1, tree))
+                    # Break to process child node
+                    break
 
 
 def side_effect(func, iterable, chunk_size=None, before=None, after=None):
@@ -1516,28 +1543,41 @@ def padded(iterable, fillvalue=None, n=None, next_multiple=False):
         [1, 2, 3, '?', '?']
 
     If *next_multiple* is ``True``, *fillvalue* will be emitted until the
-    number of items emitted is a multiple of *n*::
+    number of items emitted is a multiple of *n*:
 
         >>> list(padded([1, 2, 3, 4], n=3, next_multiple=True))
         [1, 2, 3, 4, None, None]
 
     If *n* is ``None``, *fillvalue* will be emitted indefinitely.
 
+    To create an *iterable* of exactly size *n*, you can truncate with
+    :func:`islice`.
+
+        >>> list(islice(padded([1, 2, 3], '?'), 5))
+        [1, 2, 3, '?', '?']
+        >>> list(islice(padded([1, 2, 3, 4, 5, 6, 7, 8], '?'), 5))
+        [1, 2, 3, 4, 5]
+
     """
-    it = iter(iterable)
+    iterable = iter(iterable)
+    iterable_with_repeat = chain(iterable, repeat(fillvalue))
+
     if n is None:
-        yield from chain(it, repeat(fillvalue))
+        return iterable_with_repeat
     elif n < 1:
         raise ValueError('n must be at least 1')
-    else:
-        item_count = 0
-        for item in it:
-            yield item
-            item_count += 1
+    elif next_multiple:
 
-        remaining = (n - item_count) % n if next_multiple else n - item_count
-        for _ in range(remaining):
-            yield fillvalue
+        def slice_generator():
+            for first in iterable:
+                yield (first,)
+                yield islice(iterable_with_repeat, n - 1)
+
+        # While elements exist produce slices of size n
+        return chain.from_iterable(slice_generator())
+    else:
+        # Ensure the first batch is at least size n then iterate
+        return chain(islice(iterable_with_repeat, n), iterable)
 
 
 def repeat_each(iterable, n=2):
@@ -1592,7 +1632,9 @@ def distribute(n, iterable):
         [[1], [2], [3], [], []]
 
     This function uses :func:`itertools.tee` and may require significant
-    storage. If you need the order items in the smaller iterables to match the
+    storage.
+
+    If you need the order items in the smaller iterables to match the
     original iterable, see :func:`divide`.
 
     """
@@ -1840,9 +1882,9 @@ def divide(n, iterable):
         >>> [list(c) for c in children]
         [[1], [2], [3], [], []]
 
-    This function will exhaust the iterable before returning and may require
-    significant storage. If order is not important, see :func:`distribute`,
-    which does not first pull the iterable into memory.
+    This function will exhaust the iterable before returning.
+    If order is not important, see :func:`distribute`, which does not first
+    pull the iterable into memory.
 
     """
     if n < 1:
@@ -3296,25 +3338,38 @@ def only(iterable, default=None, too_long=None):
     return first_value
 
 
-class _IChunk:
-    def __init__(self, iterable, n):
-        self._it = islice(iterable, n)
-        self._cache = deque()
+def _ichunk(iterable, n):
+    cache = deque()
+    chunk = islice(iterable, n)
 
-    def fill_cache(self):
-        self._cache.extend(self._it)
-
-    def __iter__(self):
-        return self
-
-    def __next__(self):
-        try:
-            return next(self._it)
-        except StopIteration:
-            if self._cache:
-                return self._cache.popleft()
+    def generator():
+        while True:
+            if cache:
+                yield cache.popleft()
             else:
-                raise
+                try:
+                    item = next(chunk)
+                except StopIteration:
+                    return
+                else:
+                    yield item
+
+    def materialize_next(n=1):
+        # if n not specified materialize everything
+        if n is None:
+            cache.extend(chunk)
+            return len(cache)
+
+        to_cache = n - len(cache)
+
+        # materialize up to n
+        if to_cache > 0:
+            cache.extend(islice(chunk, to_cache))
+
+        # return number materialized up to n
+        return min(n, len(cache))
+
+    return (generator(), materialize_next)
 
 
 def ichunked(iterable, n):
@@ -3338,19 +3393,19 @@ def ichunked(iterable, n):
     [8, 9, 10, 11]
 
     """
-    source = peekable(iter(iterable))
-    ichunk_marker = object()
+    iterable = iter(iterable)
     while True:
+        # Create new chunk
+        chunk, materialize_next = _ichunk(iterable, n)
+
         # Check to see whether we're at the end of the source iterable
-        item = source.peek(ichunk_marker)
-        if item is ichunk_marker:
+        if not materialize_next():
             return
 
-        chunk = _IChunk(source, n)
         yield chunk
 
-        # Advance the source iterable and fill previous chunk's cache
-        chunk.fill_cache()
+        # Fill previous chunk's cache
+        materialize_next(None)
 
 
 def iequals(*iterables):
@@ -3864,6 +3919,7 @@ def nth_permutation(iterable, r, index):
         raise ValueError
     else:
         c = perm(n, r)
+    assert c > 0  # factortial(n)>0, and r<n so perm(n,r) is never zero
 
     if index < 0:
         index += c
@@ -3871,9 +3927,6 @@ def nth_permutation(iterable, r, index):
     if not 0 <= index < c:
         raise IndexError
 
-    if c == 0:
-        return tuple()
-
     result = [0] * r
     q = index * factorial(n) // c if r < n else index
     for d in range(1, n + 1):
@@ -3946,6 +3999,12 @@ def value_chain(*args):
         >>> list(value_chain('12', '34', ['56', '78']))
         ['12', '34', '56', '78']
 
+    Pre- or postpend a single element to an iterable:
+
+        >>> list(value_chain(1, [2, 3, 4, 5, 6]))
+        [1, 2, 3, 4, 5, 6]
+        >>> list(value_chain([1, 2, 3, 4, 5], 6))
+        [1, 2, 3, 4, 5, 6]
 
     Multiple levels of nesting are not flattened.
 
@@ -4154,53 +4213,41 @@ def chunked_even(iterable, n):
     [[1, 2, 3], [4, 5, 6], [7]]
 
     """
+    iterable = iter(iterable)
 
-    len_method = getattr(iterable, '__len__', None)
+    # Initialize a buffer to process the chunks while keeping
+    # some back to fill any underfilled chunks
+    min_buffer = (n - 1) * (n - 2)
+    buffer = list(islice(iterable, min_buffer))
 
-    if len_method is None:
-        return _chunked_even_online(iterable, n)
-    else:
-        return _chunked_even_finite(iterable, len_method(), n)
+    # Append items until we have a completed chunk
+    for _ in islice(map(buffer.append, iterable), n, None, n):
+        yield buffer[:n]
+        del buffer[:n]
 
-
-def _chunked_even_online(iterable, n):
-    buffer = []
-    maxbuf = n + (n - 2) * (n - 1)
-    for x in iterable:
-        buffer.append(x)
-        if len(buffer) == maxbuf:
-            yield buffer[:n]
-            buffer = buffer[n:]
-    yield from _chunked_even_finite(buffer, len(buffer), n)
-
-
-def _chunked_even_finite(iterable, N, n):
-    if N < 1:
+    # Check if any chunks need addition processing
+    if not buffer:
         return
+    length = len(buffer)
 
-    # Lists are either size `full_size <= n` or `partial_size = full_size - 1`
-    q, r = divmod(N, n)
+    # Chunks are either size `full_size <= n` or `partial_size = full_size - 1`
+    q, r = divmod(length, n)
     num_lists = q + (1 if r > 0 else 0)
-    q, r = divmod(N, num_lists)
+    q, r = divmod(length, num_lists)
     full_size = q + (1 if r > 0 else 0)
     partial_size = full_size - 1
-    num_full = N - partial_size * num_lists
-    num_partial = num_lists - num_full
+    num_full = length - partial_size * num_lists
 
-    # Yield num_full lists of full_size
+    # Yield chunks of full size
     partial_start_idx = num_full * full_size
     if full_size > 0:
         for i in range(0, partial_start_idx, full_size):
-            yield list(islice(iterable, i, i + full_size))
+            yield buffer[i : i + full_size]
 
-    # Yield num_partial lists of partial_size
+    # Yield chunks of partial size
     if partial_size > 0:
-        for i in range(
-            partial_start_idx,
-            partial_start_idx + (num_partial * partial_size),
-            partial_size,
-        ):
-            yield list(islice(iterable, i, i + partial_size))
+        for i in range(partial_start_idx, length, partial_size):
+            yield buffer[i : i + partial_size]
 
 
 def zip_broadcast(*objects, scalar_types=(str, bytes), strict=False):
@@ -4419,12 +4466,12 @@ def minmax(iterable_or_value, *others, key=None, default=_marker):
 
     try:
         lo = hi = next(it)
-    except StopIteration as e:
+    except StopIteration as exc:
         if default is _marker:
             raise ValueError(
                 '`minmax()` argument is an empty iterable. '
                 'Provide a `default` value to suppress this error.'
-            ) from e
+            ) from exc
         return default
 
     # Different branches depending on the presence of key. This saves a lot
@@ -4654,3 +4701,106 @@ def filter_map(func, iterable):
         y = func(x)
         if y is not None:
             yield y
+
+
+def powerset_of_sets(iterable):
+    """Yields all possible subsets of the iterable.
+
+        >>> list(powerset_of_sets([1, 2, 3]))  # doctest: +SKIP
+        [set(), {1}, {2}, {3}, {1, 2}, {1, 3}, {2, 3}, {1, 2, 3}]
+        >>> list(powerset_of_sets([1, 1, 0]))  # doctest: +SKIP
+        [set(), {1}, {0}, {0, 1}]
+
+    :func:`powerset_of_sets` takes care to minimize the number
+    of hash operations performed.
+    """
+    sets = tuple(map(set, dict.fromkeys(map(frozenset, zip(iterable)))))
+    for r in range(len(sets) + 1):
+        yield from starmap(set().union, combinations(sets, r))
+
+
+def join_mappings(**field_to_map):
+    """
+    Joins multiple mappings together using their common keys.
+
+    >>> user_scores = {'elliot': 50, 'claris': 60}
+    >>> user_times = {'elliot': 30, 'claris': 40}
+    >>> join_mappings(score=user_scores, time=user_times)
+    {'elliot': {'score': 50, 'time': 30}, 'claris': {'score': 60, 'time': 40}}
+    """
+    ret = defaultdict(dict)
+
+    for field_name, mapping in field_to_map.items():
+        for key, value in mapping.items():
+            ret[key][field_name] = value
+
+    return dict(ret)
+
+
+def _complex_sumprod(v1, v2):
+    """High precision sumprod() for complex numbers.
+    Used by :func:`dft` and :func:`idft`.
+    """
+
+    r1 = chain((p.real for p in v1), (-p.imag for p in v1))
+    r2 = chain((q.real for q in v2), (q.imag for q in v2))
+    i1 = chain((p.real for p in v1), (p.imag for p in v1))
+    i2 = chain((q.imag for q in v2), (q.real for q in v2))
+    return complex(_fsumprod(r1, r2), _fsumprod(i1, i2))
+
+
+def dft(xarr):
+    """Discrete Fourier Tranform. *xarr* is a sequence of complex numbers.
+    Yields the components of the corresponding transformed output vector.
+
+    >>> import cmath
+    >>> xarr = [1, 2-1j, -1j, -1+2j]
+    >>> Xarr = [2, -2-2j, -2j, 4+4j]
+    >>> all(map(cmath.isclose, dft(xarr), Xarr))
+    True
+
+    See :func:`idft` for the inverse Discrete Fourier Transform.
+    """
+    N = len(xarr)
+    roots_of_unity = [e ** (n / N * tau * -1j) for n in range(N)]
+    for k in range(N):
+        coeffs = [roots_of_unity[k * n % N] for n in range(N)]
+        yield _complex_sumprod(xarr, coeffs)
+
+
+def idft(Xarr):
+    """Inverse Discrete Fourier Tranform. *Xarr* is a sequence of
+    complex numbers. Yields the components of the corresponding
+    inverse-transformed output vector.
+
+    >>> import cmath
+    >>> xarr = [1, 2-1j, -1j, -1+2j]
+    >>> Xarr = [2, -2-2j, -2j, 4+4j]
+    >>> all(map(cmath.isclose, idft(Xarr), xarr))
+    True
+
+    See :func:`dft` for the Discrete Fourier Transform.
+    """
+    N = len(Xarr)
+    roots_of_unity = [e ** (n / N * tau * 1j) for n in range(N)]
+    for k in range(N):
+        coeffs = [roots_of_unity[k * n % N] for n in range(N)]
+        yield _complex_sumprod(Xarr, coeffs) / N
+
+
+def doublestarmap(func, iterable):
+    """Apply *func* to every item of *iterable* by dictionary unpacking
+    the item into *func*.
+
+    The difference between :func:`itertools.starmap` and :func:`doublestarmap`
+    parallels the distinction between ``func(*a)`` and ``func(**a)``.
+
+    >>> iterable = [{'a': 1, 'b': 2}, {'a': 40, 'b': 60}]
+    >>> list(doublestarmap(lambda a, b: a + b, iterable))
+    [3, 100]
+
+    ``TypeError`` will be raised if *func*'s signature doesn't match the
+    mapping contained in *iterable* or if *iterable* does not contain mappings.
+    """
+    for item in iterable:
+        yield func(**item)
diff --git a/lib/more_itertools/more.pyi b/lib/more_itertools/more.pyi
index 9a5fc911..e9460232 100644
--- a/lib/more_itertools/more.pyi
+++ b/lib/more_itertools/more.pyi
@@ -1,4 +1,5 @@
 """Stubs for more_itertools.more"""
+
 from __future__ import annotations
 
 from types import TracebackType
@@ -9,8 +10,10 @@ from typing import (
     ContextManager,
     Generic,
     Hashable,
+    Mapping,
     Iterable,
     Iterator,
+    Mapping,
     overload,
     Reversible,
     Sequence,
@@ -602,6 +605,7 @@ class countable(Generic[_T], Iterator[_T]):
     def __init__(self, iterable: Iterable[_T]) -> None: ...
     def __iter__(self) -> countable[_T]: ...
     def __next__(self) -> _T: ...
+    items_seen: int
 
 def chunked_even(iterable: Iterable[_T], n: int) -> Iterator[list[_T]]: ...
 def zip_broadcast(
@@ -693,3 +697,13 @@ def filter_map(
     func: Callable[[_T], _V | None],
     iterable: Iterable[_T],
 ) -> Iterator[_V]: ...
+def powerset_of_sets(iterable: Iterable[_T]) -> Iterator[set[_T]]: ...
+def join_mappings(
+    **field_to_map: Mapping[_T, _V]
+) -> dict[_T, dict[str, _V]]: ...
+def doublestarmap(
+    func: Callable[..., _T],
+    iterable: Iterable[Mapping[str, Any]],
+) -> Iterator[_T]: ...
+def dft(xarr: Sequence[complex]) -> Iterator[complex]: ...
+def idft(Xarr: Sequence[complex]) -> Iterator[complex]: ...
diff --git a/lib/more_itertools/recipes.py b/lib/more_itertools/recipes.py
index 145e3cb5..b32fa955 100644
--- a/lib/more_itertools/recipes.py
+++ b/lib/more_itertools/recipes.py
@@ -7,6 +7,7 @@ Some backward-compatible usability improvements have been made.
 .. [1] http://docs.python.org/library/itertools.html#recipes
 
 """
+
 import math
 import operator
 
@@ -74,6 +75,7 @@ __all__ = [
     'totient',
     'transpose',
     'triplewise',
+    'unique',
     'unique_everseen',
     'unique_justseen',
 ]
@@ -198,7 +200,7 @@ def nth(iterable, n, default=None):
     return next(islice(iterable, n, None), default)
 
 
-def all_equal(iterable):
+def all_equal(iterable, key=None):
     """
     Returns ``True`` if all the elements are equal to each other.
 
@@ -207,9 +209,16 @@ def all_equal(iterable):
         >>> all_equal('aaab')
         False
 
+    A function that accepts a single argument and returns a transformed version
+    of each input item can be specified with *key*:
+
+        >>> all_equal('AaaA', key=str.casefold)
+        True
+        >>> all_equal([1, 2, 3], key=lambda x: x < 10)
+        True
+
     """
-    g = groupby(iterable)
-    return next(g, True) and not next(g, False)
+    return len(list(islice(groupby(iterable, key), 2))) <= 1
 
 
 def quantify(iterable, pred=bool):
@@ -410,16 +419,11 @@ def roundrobin(*iterables):
     iterables is small).
 
     """
-    # Recipe credited to George Sakkis
-    pending = len(iterables)
-    nexts = cycle(iter(it).__next__ for it in iterables)
-    while pending:
-        try:
-            for next in nexts:
-                yield next()
-        except StopIteration:
-            pending -= 1
-            nexts = cycle(islice(nexts, pending))
+    # Algorithm credited to George Sakkis
+    iterators = map(iter, iterables)
+    for num_active in range(len(iterables), 0, -1):
+        iterators = cycle(islice(iterators, num_active))
+        yield from map(next, iterators)
 
 
 def partition(pred, iterable):
@@ -458,16 +462,14 @@ def powerset(iterable):
 
     :func:`powerset` will operate on iterables that aren't :class:`set`
     instances, so repeated elements in the input will produce repeated elements
-    in the output. Use :func:`unique_everseen` on the input to avoid generating
-    duplicates:
+    in the output.
 
         >>> seq = [1, 1, 0]
         >>> list(powerset(seq))
         [(), (1,), (1,), (0,), (1, 1), (1, 0), (1, 0), (1, 1, 0)]
-        >>> from more_itertools import unique_everseen
-        >>> list(powerset(unique_everseen(seq)))
-        [(), (1,), (0,), (1, 0)]
 
+    For a variant that efficiently yields actual :class:`set` instances, see
+    :func:`powerset_of_sets`.
     """
     s = list(iterable)
     return chain.from_iterable(combinations(s, r) for r in range(len(s) + 1))
@@ -533,6 +535,25 @@ def unique_justseen(iterable, key=None):
     return map(next, map(operator.itemgetter(1), groupby(iterable, key)))
 
 
+def unique(iterable, key=None, reverse=False):
+    """Yields unique elements in sorted order.
+
+    >>> list(unique([[1, 2], [3, 4], [1, 2]]))
+    [[1, 2], [3, 4]]
+
+    *key* and *reverse* are passed to :func:`sorted`.
+
+    >>> list(unique('ABBcCAD', str.casefold))
+    ['A', 'B', 'c', 'D']
+    >>> list(unique('ABBcCAD', str.casefold, reverse=True))
+    ['D', 'c', 'B', 'A']
+
+    The elements in *iterable* need not be hashable, but they must be
+    comparable for sorting to work.
+    """
+    return unique_justseen(sorted(iterable, key=key, reverse=reverse), key=key)
+
+
 def iter_except(func, exception, first=None):
     """Yields results from a function repeatedly until an exception is raised.
 
@@ -827,8 +848,6 @@ def iter_index(iterable, value, start=0, stop=None):
     """Yield the index of each place in *iterable* that *value* occurs,
     beginning with index *start* and ending before index *stop*.
 
-    See :func:`locate` for a more general means of finding the indexes
-    associated with particular values.
 
     >>> list(iter_index('AABCADEAF', 'A'))
     [0, 1, 4, 7]
@@ -836,6 +855,19 @@ def iter_index(iterable, value, start=0, stop=None):
     [1, 4, 7]
     >>> list(iter_index('AABCADEAF', 'A', 1, 7))  # stop index is not inclusive
     [1, 4]
+
+    The behavior for non-scalar *values* matches the built-in Python types.
+
+    >>> list(iter_index('ABCDABCD', 'AB'))
+    [0, 4]
+    >>> list(iter_index([0, 1, 2, 3, 0, 1, 2, 3], [0, 1]))
+    []
+    >>> list(iter_index([[0, 1], [2, 3], [0, 1], [2, 3]], [0, 1]))
+    [0, 2]
+
+    See :func:`locate` for a more general means of finding the indexes
+    associated with particular values.
+
     """
     seq_index = getattr(iterable, 'index', None)
     if seq_index is None:
@@ -1006,7 +1038,9 @@ def totient(n):
     >>> totient(12)
     4
     """
-    for p in unique_justseen(factor(n)):
+    # The itertools docs use unique_justseen instead of set; see
+    # https://github.com/more-itertools/more-itertools/issues/823
+    for p in set(factor(n)):
         n = n // p * (p - 1)
 
     return n
diff --git a/lib/more_itertools/recipes.pyi b/lib/more_itertools/recipes.pyi
index ed4c19db..739acec0 100644
--- a/lib/more_itertools/recipes.pyi
+++ b/lib/more_itertools/recipes.pyi
@@ -1,4 +1,5 @@
 """Stubs for more_itertools.recipes"""
+
 from __future__ import annotations
 
 from typing import (
@@ -28,7 +29,9 @@ def consume(iterator: Iterable[_T], n: int | None = ...) -> None: ...
 def nth(iterable: Iterable[_T], n: int) -> _T | None: ...
 @overload
 def nth(iterable: Iterable[_T], n: int, default: _U) -> _T | _U: ...
-def all_equal(iterable: Iterable[_T]) -> bool: ...
+def all_equal(
+    iterable: Iterable[_T], key: Callable[[_T], _U] | None = ...
+) -> bool: ...
 def quantify(
     iterable: Iterable[_T], pred: Callable[[_T], bool] = ...
 ) -> int: ...
@@ -58,6 +61,11 @@ def unique_everseen(
 def unique_justseen(
     iterable: Iterable[_T], key: Callable[[_T], object] | None = ...
 ) -> Iterator[_T]: ...
+def unique(
+    iterable: Iterable[_T],
+    key: Callable[[_T], object] | None = ...,
+    reverse: bool = False,
+) -> Iterator[_T]: ...
 @overload
 def iter_except(
     func: Callable[[], _T],
diff --git a/lib/tempora/schedule.py b/lib/tempora/schedule.py
index 49c70b10..7f06fdcd 100644
--- a/lib/tempora/schedule.py
+++ b/lib/tempora/schedule.py
@@ -3,14 +3,24 @@ Classes for calling functions a schedule. Has time zone support.
 
 For example, to run a job at 08:00 every morning in 'Asia/Calcutta':
 
+>>> from tests.compat.py38 import zoneinfo
 >>> job = lambda: print("time is now", datetime.datetime())
->>> time = datetime.time(8, tzinfo=pytz.timezone('Asia/Calcutta'))
+>>> time = datetime.time(8, tzinfo=zoneinfo.ZoneInfo('Asia/Calcutta'))
 >>> cmd = PeriodicCommandFixedDelay.daily_at(time, job)
 >>> sched = InvokeScheduler()
 >>> sched.add(cmd)
 >>> while True:  # doctest: +SKIP
 ...     sched.run_pending()
 ...     time.sleep(.1)
+
+By default, the scheduler uses timezone-aware times in UTC. A
+client may override the default behavior by overriding ``now``
+and ``from_timestamp`` functions.
+
+>>> now()
+datetime.datetime(...utc)
+>>> from_timestamp(1718723533.7685602)
+datetime.datetime(...utc)
 """
 
 import datetime
@@ -18,27 +28,7 @@ import numbers
 import abc
 import bisect
 
-import pytz
-
-
-def now():
-    """
-    Provide the current timezone-aware datetime.
-
-    A client may override this function to change the default behavior,
-    such as to use local time or timezone-naïve times.
-    """
-    return datetime.datetime.now(pytz.utc)
-
-
-def from_timestamp(ts):
-    """
-    Convert a numeric timestamp to a timezone-aware datetime.
-
-    A client may override this function to change the default behavior,
-    such as to use local time or timezone-naïve times.
-    """
-    return datetime.datetime.fromtimestamp(ts, pytz.utc)
+from .utc import now, fromtimestamp as from_timestamp
 
 
 class DelayedCommand(datetime.datetime):
@@ -106,18 +96,7 @@ class PeriodicCommand(DelayedCommand):
         """
         Add delay to self, localized
         """
-        return self._localize(self + self.delay)
-
-    @staticmethod
-    def _localize(dt):
-        """
-        Rely on pytz.localize to ensure new result honors DST.
-        """
-        try:
-            tz = dt.tzinfo
-            return tz.localize(dt.replace(tzinfo=None))
-        except AttributeError:
-            return dt
+        return self + self.delay
 
     def next(self):
         cmd = self.__class__.from_datetime(self._next_time())
@@ -127,9 +106,7 @@ class PeriodicCommand(DelayedCommand):
 
     def __setattr__(self, key, value):
         if key == 'delay' and not value > datetime.timedelta():
-            raise ValueError(
-                "A PeriodicCommand must have a positive, " "non-zero delay."
-            )
+            raise ValueError("A PeriodicCommand must have a positive, non-zero delay.")
         super().__setattr__(key, value)
 
 
@@ -172,7 +149,7 @@ class PeriodicCommandFixedDelay(PeriodicCommand):
         when -= daily
         while when < now():
             when += daily
-        return cls.at_time(cls._localize(when), daily, target)
+        return cls.at_time(when, daily, target)
 
 
 class Scheduler:
diff --git a/lib/tempora/utc.py b/lib/tempora/utc.py
index a585fb54..08c5f1f6 100644
--- a/lib/tempora/utc.py
+++ b/lib/tempora/utc.py
@@ -21,6 +21,13 @@ datetime.timezone.utc
 
 >>> time(0, 0).tzinfo
 datetime.timezone.utc
+
+Now should be affected by freezegun.
+
+>>> freezer = getfixture('freezer')
+>>> freezer.move_to('1999-12-31 17:00:00 -0700')
+>>> print(now())
+2000-01-01 00:00:00+00:00
 """
 
 import datetime as std
@@ -30,7 +37,10 @@ import functools
 __all__ = ['now', 'fromtimestamp', 'datetime', 'time']
 
 
-now = functools.partial(std.datetime.now, std.timezone.utc)
+def now():
+    return std.datetime.now(std.timezone.utc)
+
+
 fromtimestamp = functools.partial(std.datetime.fromtimestamp, tz=std.timezone.utc)
 datetime = functools.partial(std.datetime, tzinfo=std.timezone.utc)
 time = functools.partial(std.time, tzinfo=std.timezone.utc)
diff --git a/lib/typeguard/_checkers.py b/lib/typeguard/_checkers.py
index 2f8de6f3..67dd5ad4 100644
--- a/lib/typeguard/_checkers.py
+++ b/lib/typeguard/_checkers.py
@@ -32,22 +32,24 @@ from typing import (
     Union,
 )
 from unittest.mock import Mock
+from weakref import WeakKeyDictionary
 
 try:
     import typing_extensions
 except ImportError:
     typing_extensions = None  # type: ignore[assignment]
 
+# Must use this because typing.is_typeddict does not recognize
+# TypedDict from typing_extensions, and as of version 4.12.0
+# typing_extensions.TypedDict is different from typing.TypedDict
+# on all versions.
+from typing_extensions import is_typeddict
+
 from ._config import ForwardRefPolicy
 from ._exceptions import TypeCheckError, TypeHintWarning
 from ._memo import TypeCheckMemo
 from ._utils import evaluate_forwardref, get_stacklevel, get_type_name, qualified_name
 
-if sys.version_info >= (3, 13):
-    from typing import is_typeddict
-else:
-    from typing_extensions import is_typeddict
-
 if sys.version_info >= (3, 11):
     from typing import (
         Annotated,
@@ -87,6 +89,9 @@ generic_alias_types: tuple[type, ...] = (type(List), type(List[Any]))
 if sys.version_info >= (3, 9):
     generic_alias_types += (types.GenericAlias,)
 
+protocol_check_cache: WeakKeyDictionary[
+    type[Any], dict[type[Any], TypeCheckError | None]
+] = WeakKeyDictionary()
 
 # Sentinel
 _missing = object()
@@ -649,19 +654,96 @@ def check_protocol(
     args: tuple[Any, ...],
     memo: TypeCheckMemo,
 ) -> None:
-    # TODO: implement proper compatibility checking and support non-runtime protocols
-    if getattr(origin_type, "_is_runtime_protocol", False):
-        if not isinstance(value, origin_type):
-            raise TypeCheckError(
-                f"is not compatible with the {origin_type.__qualname__} protocol"
+    subject: type[Any] = value if isclass(value) else type(value)
+
+    if subject in protocol_check_cache:
+        result_map = protocol_check_cache[subject]
+        if origin_type in result_map:
+            if exc := result_map[origin_type]:
+                raise exc
+            else:
+                return
+
+    # Collect a set of methods and non-method attributes present in the protocol
+    ignored_attrs = set(dir(typing.Protocol)) | {
+        "__annotations__",
+        "__non_callable_proto_members__",
+    }
+    expected_methods: dict[str, tuple[Any, Any]] = {}
+    expected_noncallable_members: dict[str, Any] = {}
+    for attrname in dir(origin_type):
+        # Skip attributes present in typing.Protocol
+        if attrname in ignored_attrs:
+            continue
+
+        member = getattr(origin_type, attrname)
+        if callable(member):
+            signature = inspect.signature(member)
+            argtypes = [
+                (p.annotation if p.annotation is not Parameter.empty else Any)
+                for p in signature.parameters.values()
+                if p.kind is not Parameter.KEYWORD_ONLY
+            ] or Ellipsis
+            return_annotation = (
+                signature.return_annotation
+                if signature.return_annotation is not Parameter.empty
+                else Any
             )
+            expected_methods[attrname] = argtypes, return_annotation
+        else:
+            expected_noncallable_members[attrname] = member
+
+    for attrname, annotation in typing.get_type_hints(origin_type).items():
+        expected_noncallable_members[attrname] = annotation
+
+    subject_annotations = typing.get_type_hints(subject)
+
+    # Check that all required methods are present and their signatures are compatible
+    result_map = protocol_check_cache.setdefault(subject, {})
+    try:
+        for attrname, callable_args in expected_methods.items():
+            try:
+                method = getattr(subject, attrname)
+            except AttributeError:
+                if attrname in subject_annotations:
+                    raise TypeCheckError(
+                        f"is not compatible with the {origin_type.__qualname__} protocol "
+                        f"because its {attrname!r} attribute is not a method"
+                    ) from None
+                else:
+                    raise TypeCheckError(
+                        f"is not compatible with the {origin_type.__qualname__} protocol "
+                        f"because it has no method named {attrname!r}"
+                    ) from None
+
+            if not callable(method):
+                raise TypeCheckError(
+                    f"is not compatible with the {origin_type.__qualname__} protocol "
+                    f"because its {attrname!r} attribute is not a callable"
+                )
+
+            # TODO: raise exception on added keyword-only arguments without defaults
+            try:
+                check_callable(method, Callable, callable_args, memo)
+            except TypeCheckError as exc:
+                raise TypeCheckError(
+                    f"is not compatible with the {origin_type.__qualname__} protocol "
+                    f"because its {attrname!r} method {exc}"
+                ) from None
+
+        # Check that all required non-callable members are present
+        for attrname in expected_noncallable_members:
+            # TODO: implement assignability checks for non-callable members
+            if attrname not in subject_annotations and not hasattr(subject, attrname):
+                raise TypeCheckError(
+                    f"is not compatible with the {origin_type.__qualname__} protocol "
+                    f"because it has no attribute named {attrname!r}"
+                )
+    except TypeCheckError as exc:
+        result_map[origin_type] = exc
+        raise
     else:
-        warnings.warn(
-            f"Typeguard cannot check the {origin_type.__qualname__} protocol because "
-            f"it is a non-runtime protocol. If you would like to type check this "
-            f"protocol, please use @typing.runtime_checkable",
-            stacklevel=get_stacklevel(),
-        )
+        result_map[origin_type] = None
 
 
 def check_byteslike(
@@ -852,7 +934,8 @@ def builtin_checker_lookup(
     elif is_typeddict(origin_type):
         return check_typed_dict
     elif isclass(origin_type) and issubclass(
-        origin_type, Tuple  # type: ignore[arg-type]
+        origin_type,
+        Tuple,  # type: ignore[arg-type]
     ):
         # NamedTuple
         return check_tuple
diff --git a/lib/typeguard/_pytest_plugin.py b/lib/typeguard/_pytest_plugin.py
index 7bca9c26..7b2f494e 100644
--- a/lib/typeguard/_pytest_plugin.py
+++ b/lib/typeguard/_pytest_plugin.py
@@ -2,21 +2,22 @@ from __future__ import annotations
 
 import sys
 import warnings
-from typing import Any, Literal
-
-from pytest import Config, Parser
+from typing import TYPE_CHECKING, Any, Literal
 
 from typeguard._config import CollectionCheckStrategy, ForwardRefPolicy, global_config
 from typeguard._exceptions import InstrumentationWarning
 from typeguard._importhook import install_import_hook
 from typeguard._utils import qualified_name, resolve_reference
 
+if TYPE_CHECKING:
+    from pytest import Config, Parser
+
 
 def pytest_addoption(parser: Parser) -> None:
     def add_ini_option(
         opt_type: (
             Literal["string", "paths", "pathlist", "args", "linelist", "bool"] | None
-        )
+        ),
     ) -> None:
         parser.addini(
             group.options[-1].names()[0][2:],
diff --git a/lib/typeguard/_suppression.py b/lib/typeguard/_suppression.py
index f6899a9f..bbbfbfbe 100644
--- a/lib/typeguard/_suppression.py
+++ b/lib/typeguard/_suppression.py
@@ -28,7 +28,7 @@ def suppress_type_checks() -> ContextManager[None]: ...
 
 
 def suppress_type_checks(
-    func: Callable[P, T] | None = None
+    func: Callable[P, T] | None = None,
 ) -> Callable[P, T] | ContextManager[None]:
     """
     Temporarily suppress all type checking.
diff --git a/lib/typeguard/_utils.py b/lib/typeguard/_utils.py
index 96818fd2..9bcc8417 100644
--- a/lib/typeguard/_utils.py
+++ b/lib/typeguard/_utils.py
@@ -11,11 +11,21 @@ from weakref import WeakValueDictionary
 if TYPE_CHECKING:
     from ._memo import TypeCheckMemo
 
-if sys.version_info >= (3, 10):
+if sys.version_info >= (3, 13):
     from typing import get_args, get_origin
 
     def evaluate_forwardref(forwardref: ForwardRef, memo: TypeCheckMemo) -> Any:
-        return forwardref._evaluate(memo.globals, memo.locals, frozenset())
+        return forwardref._evaluate(
+            memo.globals, memo.locals, type_params=(), recursive_guard=frozenset()
+        )
+
+elif sys.version_info >= (3, 10):
+    from typing import get_args, get_origin
+
+    def evaluate_forwardref(forwardref: ForwardRef, memo: TypeCheckMemo) -> Any:
+        return forwardref._evaluate(
+            memo.globals, memo.locals, recursive_guard=frozenset()
+        )
 
 else:
     from typing_extensions import get_args, get_origin
diff --git a/lib/typing_extensions.py b/lib/typing_extensions.py
index 9ccd519c..dec429ca 100644
--- a/lib/typing_extensions.py
+++ b/lib/typing_extensions.py
@@ -1,6 +1,7 @@
 import abc
 import collections
 import collections.abc
+import contextlib
 import functools
 import inspect
 import operator
@@ -116,6 +117,7 @@ __all__ = [
     'MutableMapping',
     'MutableSequence',
     'MutableSet',
+    'NoDefault',
     'Optional',
     'Pattern',
     'Reversible',
@@ -134,6 +136,7 @@ __all__ = [
 # for backward compatibility
 PEP_560 = True
 GenericMeta = type
+_PEP_696_IMPLEMENTED = sys.version_info >= (3, 13, 0, "beta")
 
 # The functions below are modified copies of typing internal helpers.
 # They are needed by _ProtocolMeta and they provide support for PEP 646.
@@ -406,17 +409,96 @@ Coroutine = typing.Coroutine
 AsyncIterable = typing.AsyncIterable
 AsyncIterator = typing.AsyncIterator
 Deque = typing.Deque
-ContextManager = typing.ContextManager
-AsyncContextManager = typing.AsyncContextManager
 DefaultDict = typing.DefaultDict
 OrderedDict = typing.OrderedDict
 Counter = typing.Counter
 ChainMap = typing.ChainMap
-AsyncGenerator = typing.AsyncGenerator
 Text = typing.Text
 TYPE_CHECKING = typing.TYPE_CHECKING
 
 
+if sys.version_info >= (3, 13, 0, "beta"):
+    from typing import AsyncContextManager, AsyncGenerator, ContextManager, Generator
+else:
+    def _is_dunder(attr):
+        return attr.startswith('__') and attr.endswith('__')
+
+    # Python <3.9 doesn't have typing._SpecialGenericAlias
+    _special_generic_alias_base = getattr(
+        typing, "_SpecialGenericAlias", typing._GenericAlias
+    )
+
+    class _SpecialGenericAlias(_special_generic_alias_base, _root=True):
+        def __init__(self, origin, nparams, *, inst=True, name=None, defaults=()):
+            if _special_generic_alias_base is typing._GenericAlias:
+                # Python <3.9
+                self.__origin__ = origin
+                self._nparams = nparams
+                super().__init__(origin, nparams, special=True, inst=inst, name=name)
+            else:
+                # Python >= 3.9
+                super().__init__(origin, nparams, inst=inst, name=name)
+            self._defaults = defaults
+
+        def __setattr__(self, attr, val):
+            allowed_attrs = {'_name', '_inst', '_nparams', '_defaults'}
+            if _special_generic_alias_base is typing._GenericAlias:
+                # Python <3.9
+                allowed_attrs.add("__origin__")
+            if _is_dunder(attr) or attr in allowed_attrs:
+                object.__setattr__(self, attr, val)
+            else:
+                setattr(self.__origin__, attr, val)
+
+        @typing._tp_cache
+        def __getitem__(self, params):
+            if not isinstance(params, tuple):
+                params = (params,)
+            msg = "Parameters to generic types must be types."
+            params = tuple(typing._type_check(p, msg) for p in params)
+            if (
+                self._defaults
+                and len(params) < self._nparams
+                and len(params) + len(self._defaults) >= self._nparams
+            ):
+                params = (*params, *self._defaults[len(params) - self._nparams:])
+            actual_len = len(params)
+
+            if actual_len != self._nparams:
+                if self._defaults:
+                    expected = f"at least {self._nparams - len(self._defaults)}"
+                else:
+                    expected = str(self._nparams)
+                if not self._nparams:
+                    raise TypeError(f"{self} is not a generic class")
+                raise TypeError(
+                    f"Too {'many' if actual_len > self._nparams else 'few'}"
+                    f" arguments for {self};"
+                    f" actual {actual_len}, expected {expected}"
+                )
+            return self.copy_with(params)
+
+    _NoneType = type(None)
+    Generator = _SpecialGenericAlias(
+        collections.abc.Generator, 3, defaults=(_NoneType, _NoneType)
+    )
+    AsyncGenerator = _SpecialGenericAlias(
+        collections.abc.AsyncGenerator, 2, defaults=(_NoneType,)
+    )
+    ContextManager = _SpecialGenericAlias(
+        contextlib.AbstractContextManager,
+        2,
+        name="ContextManager",
+        defaults=(typing.Optional[bool],)
+    )
+    AsyncContextManager = _SpecialGenericAlias(
+        contextlib.AbstractAsyncContextManager,
+        2,
+        name="AsyncContextManager",
+        defaults=(typing.Optional[bool],)
+    )
+
+
 _PROTO_ALLOWLIST = {
     'collections.abc': [
         'Callable', 'Awaitable', 'Iterable', 'Iterator', 'AsyncIterable',
@@ -427,23 +509,11 @@ _PROTO_ALLOWLIST = {
 }
 
 
-_EXCLUDED_ATTRS = {
-    "__abstractmethods__", "__annotations__", "__weakref__", "_is_protocol",
-    "_is_runtime_protocol", "__dict__", "__slots__", "__parameters__",
-    "__orig_bases__", "__module__", "_MutableMapping__marker", "__doc__",
-    "__subclasshook__", "__orig_class__", "__init__", "__new__",
-    "__protocol_attrs__", "__non_callable_proto_members__",
-    "__match_args__",
+_EXCLUDED_ATTRS = frozenset(typing.EXCLUDED_ATTRIBUTES) | {
+    "__match_args__", "__protocol_attrs__", "__non_callable_proto_members__",
+    "__final__",
 }
 
-if sys.version_info >= (3, 9):
-    _EXCLUDED_ATTRS.add("__class_getitem__")
-
-if sys.version_info >= (3, 12):
-    _EXCLUDED_ATTRS.add("__type_params__")
-
-_EXCLUDED_ATTRS = frozenset(_EXCLUDED_ATTRS)
-
 
 def _get_protocol_attrs(cls):
     attrs = set()
@@ -669,13 +739,18 @@ else:
         not their type signatures!
         """
         if not issubclass(cls, typing.Generic) or not getattr(cls, '_is_protocol', False):
-            raise TypeError('@runtime_checkable can be only applied to protocol classes,'
-                            ' got %r' % cls)
+            raise TypeError(f'@runtime_checkable can be only applied to protocol classes,'
+                            f' got {cls!r}')
         cls._is_runtime_protocol = True
 
-        # Only execute the following block if it's a typing_extensions.Protocol class.
-        # typing.Protocol classes don't need it.
-        if isinstance(cls, _ProtocolMeta):
+        # typing.Protocol classes on <=3.11 break if we execute this block,
+        # because typing.Protocol classes on <=3.11 don't have a
+        # `__protocol_attrs__` attribute, and this block relies on the
+        # `__protocol_attrs__` attribute. Meanwhile, typing.Protocol classes on 3.12.2+
+        # break if we *don't* execute this block, because *they* assume that all
+        # protocol classes have a `__non_callable_proto_members__` attribute
+        # (which this block sets)
+        if isinstance(cls, _ProtocolMeta) or sys.version_info >= (3, 12, 2):
             # PEP 544 prohibits using issubclass()
             # with protocols that have non-method members.
             # See gh-113320 for why we compute this attribute here,
@@ -867,7 +942,13 @@ else:
                 tp_dict.__orig_bases__ = bases
 
             annotations = {}
-            own_annotations = ns.get('__annotations__', {})
+            if "__annotations__" in ns:
+                own_annotations = ns["__annotations__"]
+            elif "__annotate__" in ns:
+                # TODO: Use inspect.VALUE here, and make the annotations lazily evaluated
+                own_annotations = ns["__annotate__"](1)
+            else:
+                own_annotations = {}
             msg = "TypedDict('Name', {f0: t0, f1: t1, ...}); each t must be a type"
             if _TAKES_MODULE:
                 own_annotations = {
@@ -1190,7 +1271,7 @@ else:
 
         def __reduce__(self):
             return operator.getitem, (
-                Annotated, (self.__origin__,) + self.__metadata__
+                Annotated, (self.__origin__, *self.__metadata__)
             )
 
         def __eq__(self, other):
@@ -1316,7 +1397,7 @@ else:
             get_args(Callable[[], T][int]) == ([], int)
         """
         if isinstance(tp, _AnnotatedAlias):
-            return (tp.__origin__,) + tp.__metadata__
+            return (tp.__origin__, *tp.__metadata__)
         if isinstance(tp, (typing._GenericAlias, _typing_GenericAlias)):
             if getattr(tp, "_special", False):
                 return ()
@@ -1362,17 +1443,37 @@ else:
     )
 
 
+if hasattr(typing, "NoDefault"):
+    NoDefault = typing.NoDefault
+else:
+    class NoDefaultTypeMeta(type):
+        def __setattr__(cls, attr, value):
+            # TypeError is consistent with the behavior of NoneType
+            raise TypeError(
+                f"cannot set {attr!r} attribute of immutable type {cls.__name__!r}"
+            )
+
+    class NoDefaultType(metaclass=NoDefaultTypeMeta):
+        """The type of the NoDefault singleton."""
+
+        __slots__ = ()
+
+        def __new__(cls):
+            return globals().get("NoDefault") or object.__new__(cls)
+
+        def __repr__(self):
+            return "typing_extensions.NoDefault"
+
+        def __reduce__(self):
+            return "NoDefault"
+
+    NoDefault = NoDefaultType()
+    del NoDefaultType, NoDefaultTypeMeta
+
+
 def _set_default(type_param, default):
-    if isinstance(default, (tuple, list)):
-        type_param.__default__ = tuple((typing._type_check(d, "Default must be a type")
-                                        for d in default))
-    elif default != _marker:
-        if isinstance(type_param, ParamSpec) and default is ...:  # ... not valid <3.11
-            type_param.__default__ = default
-        else:
-            type_param.__default__ = typing._type_check(default, "Default must be a type")
-    else:
-        type_param.__default__ = None
+    type_param.has_default = lambda: default is not NoDefault
+    type_param.__default__ = default
 
 
 def _set_module(typevarlike):
@@ -1395,32 +1496,46 @@ class _TypeVarLikeMeta(type):
         return isinstance(__instance, cls._backported_typevarlike)
 
 
-# Add default and infer_variance parameters from PEP 696 and 695
-class TypeVar(metaclass=_TypeVarLikeMeta):
-    """Type variable."""
+if _PEP_696_IMPLEMENTED:
+    from typing import TypeVar
+else:
+    # Add default and infer_variance parameters from PEP 696 and 695
+    class TypeVar(metaclass=_TypeVarLikeMeta):
+        """Type variable."""
 
-    _backported_typevarlike = typing.TypeVar
+        _backported_typevarlike = typing.TypeVar
 
-    def __new__(cls, name, *constraints, bound=None,
-                covariant=False, contravariant=False,
-                default=_marker, infer_variance=False):
-        if hasattr(typing, "TypeAliasType"):
-            # PEP 695 implemented (3.12+), can pass infer_variance to typing.TypeVar
-            typevar = typing.TypeVar(name, *constraints, bound=bound,
-                                     covariant=covariant, contravariant=contravariant,
-                                     infer_variance=infer_variance)
-        else:
-            typevar = typing.TypeVar(name, *constraints, bound=bound,
-                                     covariant=covariant, contravariant=contravariant)
-            if infer_variance and (covariant or contravariant):
-                raise ValueError("Variance cannot be specified with infer_variance.")
-            typevar.__infer_variance__ = infer_variance
-        _set_default(typevar, default)
-        _set_module(typevar)
-        return typevar
+        def __new__(cls, name, *constraints, bound=None,
+                    covariant=False, contravariant=False,
+                    default=NoDefault, infer_variance=False):
+            if hasattr(typing, "TypeAliasType"):
+                # PEP 695 implemented (3.12+), can pass infer_variance to typing.TypeVar
+                typevar = typing.TypeVar(name, *constraints, bound=bound,
+                                         covariant=covariant, contravariant=contravariant,
+                                         infer_variance=infer_variance)
+            else:
+                typevar = typing.TypeVar(name, *constraints, bound=bound,
+                                         covariant=covariant, contravariant=contravariant)
+                if infer_variance and (covariant or contravariant):
+                    raise ValueError("Variance cannot be specified with infer_variance.")
+                typevar.__infer_variance__ = infer_variance
 
-    def __init_subclass__(cls) -> None:
-        raise TypeError(f"type '{__name__}.TypeVar' is not an acceptable base type")
+            _set_default(typevar, default)
+            _set_module(typevar)
+
+            def _tvar_prepare_subst(alias, args):
+                if (
+                    typevar.has_default()
+                    and alias.__parameters__.index(typevar) == len(args)
+                ):
+                    args += (typevar.__default__,)
+                return args
+
+            typevar.__typing_prepare_subst__ = _tvar_prepare_subst
+            return typevar
+
+        def __init_subclass__(cls) -> None:
+            raise TypeError(f"type '{__name__}.TypeVar' is not an acceptable base type")
 
 
 # Python 3.10+ has PEP 612
@@ -1485,8 +1600,12 @@ else:
                 return NotImplemented
             return self.__origin__ == other.__origin__
 
+
+if _PEP_696_IMPLEMENTED:
+    from typing import ParamSpec
+
 # 3.10+
-if hasattr(typing, 'ParamSpec'):
+elif hasattr(typing, 'ParamSpec'):
 
     # Add default parameter - PEP 696
     class ParamSpec(metaclass=_TypeVarLikeMeta):
@@ -1496,7 +1615,7 @@ if hasattr(typing, 'ParamSpec'):
 
         def __new__(cls, name, *, bound=None,
                     covariant=False, contravariant=False,
-                    infer_variance=False, default=_marker):
+                    infer_variance=False, default=NoDefault):
             if hasattr(typing, "TypeAliasType"):
                 # PEP 695 implemented, can pass infer_variance to typing.TypeVar
                 paramspec = typing.ParamSpec(name, bound=bound,
@@ -1511,6 +1630,24 @@ if hasattr(typing, 'ParamSpec'):
 
             _set_default(paramspec, default)
             _set_module(paramspec)
+
+            def _paramspec_prepare_subst(alias, args):
+                params = alias.__parameters__
+                i = params.index(paramspec)
+                if i == len(args) and paramspec.has_default():
+                    args = [*args, paramspec.__default__]
+                if i >= len(args):
+                    raise TypeError(f"Too few arguments for {alias}")
+                # Special case where Z[[int, str, bool]] == Z[int, str, bool] in PEP 612.
+                if len(params) == 1 and not typing._is_param_expr(args[0]):
+                    assert i == 0
+                    args = (args,)
+                # Convert lists to tuples to help other libraries cache the results.
+                elif isinstance(args[i], list):
+                    args = (*args[:i], tuple(args[i]), *args[i + 1:])
+                return args
+
+            paramspec.__typing_prepare_subst__ = _paramspec_prepare_subst
             return paramspec
 
         def __init_subclass__(cls) -> None:
@@ -1579,8 +1716,8 @@ else:
             return ParamSpecKwargs(self)
 
         def __init__(self, name, *, bound=None, covariant=False, contravariant=False,
-                     infer_variance=False, default=_marker):
-            super().__init__([self])
+                     infer_variance=False, default=NoDefault):
+            list.__init__(self, [self])
             self.__name__ = name
             self.__covariant__ = bool(covariant)
             self.__contravariant__ = bool(contravariant)
@@ -1674,7 +1811,7 @@ def _concatenate_getitem(self, parameters):
 # 3.10+
 if hasattr(typing, 'Concatenate'):
     Concatenate = typing.Concatenate
-    _ConcatenateGenericAlias = typing._ConcatenateGenericAlias  # noqa: F811
+    _ConcatenateGenericAlias = typing._ConcatenateGenericAlias
 # 3.9
 elif sys.version_info[:2] >= (3, 9):
     @_ExtensionsSpecialForm
@@ -2209,6 +2346,17 @@ elif sys.version_info[:2] >= (3, 9):  # 3.9+
     class _UnpackAlias(typing._GenericAlias, _root=True):
         __class__ = typing.TypeVar
 
+        @property
+        def __typing_unpacked_tuple_args__(self):
+            assert self.__origin__ is Unpack
+            assert len(self.__args__) == 1
+            arg, = self.__args__
+            if isinstance(arg, (typing._GenericAlias, _types.GenericAlias)):
+                if arg.__origin__ is not tuple:
+                    raise TypeError("Unpack[...] must be used with a tuple type")
+                return arg.__args__
+            return None
+
     @_UnpackSpecialForm
     def Unpack(self, parameters):
         item = typing._type_check(parameters, f'{self._name} accepts only a single type.')
@@ -2233,7 +2381,20 @@ else:  # 3.8
         return isinstance(obj, _UnpackAlias)
 
 
-if hasattr(typing, "TypeVarTuple"):  # 3.11+
+if _PEP_696_IMPLEMENTED:
+    from typing import TypeVarTuple
+
+elif hasattr(typing, "TypeVarTuple"):  # 3.11+
+
+    def _unpack_args(*args):
+        newargs = []
+        for arg in args:
+            subargs = getattr(arg, '__typing_unpacked_tuple_args__', None)
+            if subargs is not None and not (subargs and subargs[-1] is ...):
+                newargs.extend(subargs)
+            else:
+                newargs.append(arg)
+        return newargs
 
     # Add default parameter - PEP 696
     class TypeVarTuple(metaclass=_TypeVarLikeMeta):
@@ -2241,10 +2402,57 @@ if hasattr(typing, "TypeVarTuple"):  # 3.11+
 
         _backported_typevarlike = typing.TypeVarTuple
 
-        def __new__(cls, name, *, default=_marker):
+        def __new__(cls, name, *, default=NoDefault):
             tvt = typing.TypeVarTuple(name)
             _set_default(tvt, default)
             _set_module(tvt)
+
+            def _typevartuple_prepare_subst(alias, args):
+                params = alias.__parameters__
+                typevartuple_index = params.index(tvt)
+                for param in params[typevartuple_index + 1:]:
+                    if isinstance(param, TypeVarTuple):
+                        raise TypeError(
+                            f"More than one TypeVarTuple parameter in {alias}"
+                        )
+
+                alen = len(args)
+                plen = len(params)
+                left = typevartuple_index
+                right = plen - typevartuple_index - 1
+                var_tuple_index = None
+                fillarg = None
+                for k, arg in enumerate(args):
+                    if not isinstance(arg, type):
+                        subargs = getattr(arg, '__typing_unpacked_tuple_args__', None)
+                        if subargs and len(subargs) == 2 and subargs[-1] is ...:
+                            if var_tuple_index is not None:
+                                raise TypeError(
+                                    "More than one unpacked "
+                                    "arbitrary-length tuple argument"
+                                )
+                            var_tuple_index = k
+                            fillarg = subargs[0]
+                if var_tuple_index is not None:
+                    left = min(left, var_tuple_index)
+                    right = min(right, alen - var_tuple_index - 1)
+                elif left + right > alen:
+                    raise TypeError(f"Too few arguments for {alias};"
+                                    f" actual {alen}, expected at least {plen - 1}")
+                if left == alen - right and tvt.has_default():
+                    replacement = _unpack_args(tvt.__default__)
+                else:
+                    replacement = args[left: alen - right]
+
+                return (
+                    *args[:left],
+                    *([fillarg] * (typevartuple_index - left)),
+                    replacement,
+                    *([fillarg] * (plen - right - left - typevartuple_index - 1)),
+                    *args[alen - right:],
+                )
+
+            tvt.__typing_prepare_subst__ = _typevartuple_prepare_subst
             return tvt
 
         def __init_subclass__(self, *args, **kwds):
@@ -2301,7 +2509,7 @@ else:  # <=3.10
         def __iter__(self):
             yield self.__unpacked__
 
-        def __init__(self, name, *, default=_marker):
+        def __init__(self, name, *, default=NoDefault):
             self.__name__ = name
             _DefaultMixin.__init__(self, default)
 
@@ -2352,6 +2560,12 @@ else:  # <=3.10
         return obj
 
 
+if hasattr(typing, "_ASSERT_NEVER_REPR_MAX_LENGTH"):  # 3.11+
+    _ASSERT_NEVER_REPR_MAX_LENGTH = typing._ASSERT_NEVER_REPR_MAX_LENGTH
+else:  # <=3.10
+    _ASSERT_NEVER_REPR_MAX_LENGTH = 100
+
+
 if hasattr(typing, "assert_never"):  # 3.11+
     assert_never = typing.assert_never
 else:  # <=3.10
@@ -2375,7 +2589,10 @@ else:  # <=3.10
         At runtime, this throws an exception when called.
 
         """
-        raise AssertionError("Expected code to be unreachable")
+        value = repr(arg)
+        if len(value) > _ASSERT_NEVER_REPR_MAX_LENGTH:
+            value = value[:_ASSERT_NEVER_REPR_MAX_LENGTH] + '...'
+        raise AssertionError(f"Expected code to be unreachable, but got: {value}")
 
 
 if sys.version_info >= (3, 12):  # 3.12+
@@ -2677,11 +2894,14 @@ if not hasattr(typing, "TypeVarTuple"):
                 if alen < elen:
                     # since we validate TypeVarLike default in _collect_type_vars
                     # or _collect_parameters we can safely check parameters[alen]
-                    if getattr(parameters[alen], '__default__', None) is not None:
+                    if (
+                        getattr(parameters[alen], '__default__', NoDefault)
+                        is not NoDefault
+                    ):
                         return
 
-                    num_default_tv = sum(getattr(p, '__default__', None)
-                                         is not None for p in parameters)
+                    num_default_tv = sum(getattr(p, '__default__', NoDefault)
+                                         is not NoDefault for p in parameters)
 
                     elen -= num_default_tv
 
@@ -2711,11 +2931,14 @@ else:
                 if alen < elen:
                     # since we validate TypeVarLike default in _collect_type_vars
                     # or _collect_parameters we can safely check parameters[alen]
-                    if getattr(parameters[alen], '__default__', None) is not None:
+                    if (
+                        getattr(parameters[alen], '__default__', NoDefault)
+                        is not NoDefault
+                    ):
                         return
 
-                    num_default_tv = sum(getattr(p, '__default__', None)
-                                         is not None for p in parameters)
+                    num_default_tv = sum(getattr(p, '__default__', NoDefault)
+                                         is not NoDefault for p in parameters)
 
                     elen -= num_default_tv
 
@@ -2724,7 +2947,42 @@ else:
             raise TypeError(f"Too {'many' if alen > elen else 'few'} arguments"
                             f" for {cls}; actual {alen}, expected {expect_val}")
 
-typing._check_generic = _check_generic
+if not _PEP_696_IMPLEMENTED:
+    typing._check_generic = _check_generic
+
+
+def _has_generic_or_protocol_as_origin() -> bool:
+    try:
+        frame = sys._getframe(2)
+    # - Catch AttributeError: not all Python implementations have sys._getframe()
+    # - Catch ValueError: maybe we're called from an unexpected module
+    #   and the call stack isn't deep enough
+    except (AttributeError, ValueError):
+        return False  # err on the side of leniency
+    else:
+        # If we somehow get invoked from outside typing.py,
+        # also err on the side of leniency
+        if frame.f_globals.get("__name__") != "typing":
+            return False
+        origin = frame.f_locals.get("origin")
+        # Cannot use "in" because origin may be an object with a buggy __eq__ that
+        # throws an error.
+        return origin is typing.Generic or origin is Protocol or origin is typing.Protocol
+
+
+_TYPEVARTUPLE_TYPES = {TypeVarTuple, getattr(typing, "TypeVarTuple", None)}
+
+
+def _is_unpacked_typevartuple(x) -> bool:
+    if get_origin(x) is not Unpack:
+        return False
+    args = get_args(x)
+    return (
+        bool(args)
+        and len(args) == 1
+        and type(args[0]) in _TYPEVARTUPLE_TYPES
+    )
+
 
 # Python 3.11+ _collect_type_vars was renamed to _collect_parameters
 if hasattr(typing, '_collect_type_vars'):
@@ -2737,19 +2995,29 @@ if hasattr(typing, '_collect_type_vars'):
         if typevar_types is None:
             typevar_types = typing.TypeVar
         tvars = []
-        # required TypeVarLike cannot appear after TypeVarLike with default
+
+        # A required TypeVarLike cannot appear after a TypeVarLike with a default
+        # if it was a direct call to `Generic[]` or `Protocol[]`
+        enforce_default_ordering = _has_generic_or_protocol_as_origin()
         default_encountered = False
+
+        # Also, a TypeVarLike with a default cannot appear after a TypeVarTuple
+        type_var_tuple_encountered = False
+
         for t in types:
-            if (
-                isinstance(t, typevar_types) and
-                t not in tvars and
-                not _is_unpack(t)
-            ):
-                if getattr(t, '__default__', None) is not None:
-                    default_encountered = True
-                elif default_encountered:
-                    raise TypeError(f'Type parameter {t!r} without a default'
-                                    ' follows type parameter with a default')
+            if _is_unpacked_typevartuple(t):
+                type_var_tuple_encountered = True
+            elif isinstance(t, typevar_types) and t not in tvars:
+                if enforce_default_ordering:
+                    has_default = getattr(t, '__default__', NoDefault) is not NoDefault
+                    if has_default:
+                        if type_var_tuple_encountered:
+                            raise TypeError('Type parameter with a default'
+                                            ' follows TypeVarTuple')
+                        default_encountered = True
+                    elif default_encountered:
+                        raise TypeError(f'Type parameter {t!r} without a default'
+                                        ' follows type parameter with a default')
 
                 tvars.append(t)
             if _should_collect_from_parameters(t):
@@ -2767,8 +3035,15 @@ else:
             assert _collect_parameters((T, Callable[P, T])) == (T, P)
         """
         parameters = []
-        # required TypeVarLike cannot appear after TypeVarLike with default
+
+        # A required TypeVarLike cannot appear after a TypeVarLike with default
+        # if it was a direct call to `Generic[]` or `Protocol[]`
+        enforce_default_ordering = _has_generic_or_protocol_as_origin()
         default_encountered = False
+
+        # Also, a TypeVarLike with a default cannot appear after a TypeVarTuple
+        type_var_tuple_encountered = False
+
         for t in args:
             if isinstance(t, type):
                 # We don't want __parameters__ descriptor of a bare Python class.
@@ -2782,21 +3057,33 @@ else:
                             parameters.append(collected)
             elif hasattr(t, '__typing_subst__'):
                 if t not in parameters:
-                    if getattr(t, '__default__', None) is not None:
-                        default_encountered = True
-                    elif default_encountered:
-                        raise TypeError(f'Type parameter {t!r} without a default'
-                                        ' follows type parameter with a default')
+                    if enforce_default_ordering:
+                        has_default = (
+                            getattr(t, '__default__', NoDefault) is not NoDefault
+                        )
+
+                        if type_var_tuple_encountered and has_default:
+                            raise TypeError('Type parameter with a default'
+                                            ' follows TypeVarTuple')
+
+                        if has_default:
+                            default_encountered = True
+                        elif default_encountered:
+                            raise TypeError(f'Type parameter {t!r} without a default'
+                                            ' follows type parameter with a default')
 
                     parameters.append(t)
             else:
+                if _is_unpacked_typevartuple(t):
+                    type_var_tuple_encountered = True
                 for x in getattr(t, '__parameters__', ()):
                     if x not in parameters:
                         parameters.append(x)
 
         return tuple(parameters)
 
-    typing._collect_parameters = _collect_parameters
+    if not _PEP_696_IMPLEMENTED:
+        typing._collect_parameters = _collect_parameters
 
 # Backport typing.NamedTuple as it exists in Python 3.13.
 # In 3.11, the ability to define generic `NamedTuple`s was supported.
@@ -2830,7 +3117,13 @@ else:
                     raise TypeError(
                         'can only inherit from a NamedTuple type and Generic')
             bases = tuple(tuple if base is _NamedTuple else base for base in bases)
-            types = ns.get('__annotations__', {})
+            if "__annotations__" in ns:
+                types = ns["__annotations__"]
+            elif "__annotate__" in ns:
+                # TODO: Use inspect.VALUE here, and make the annotations lazily evaluated
+                types = ns["__annotate__"](1)
+            else:
+                types = {}
             default_names = []
             for field_name in types:
                 if field_name in ns:
@@ -2962,7 +3255,7 @@ else:
 if hasattr(collections.abc, "Buffer"):
     Buffer = collections.abc.Buffer
 else:
-    class Buffer(abc.ABC):
+    class Buffer(abc.ABC):  # noqa: B024
         """Base class for classes that implement the buffer protocol.
 
         The buffer protocol allows Python objects to expose a low-level
@@ -3289,6 +3582,23 @@ else:
             return self.documentation == other.documentation
 
 
+_CapsuleType = getattr(_types, "CapsuleType", None)
+
+if _CapsuleType is None:
+    try:
+        import _socket
+    except ImportError:
+        pass
+    else:
+        _CAPI = getattr(_socket, "CAPI", None)
+        if _CAPI is not None:
+            _CapsuleType = type(_CAPI)
+
+if _CapsuleType is not None:
+    CapsuleType = _CapsuleType
+    __all__.append("CapsuleType")
+
+
 # Aliases for items that have always been in typing.
 # Explicitly assign these (rather than using `from typing import *` at the top),
 # so that we get a CI error if one of these is deleted from typing.py
@@ -3302,7 +3612,6 @@ Container = typing.Container
 Dict = typing.Dict
 ForwardRef = typing.ForwardRef
 FrozenSet = typing.FrozenSet
-Generator = typing.Generator
 Generic = typing.Generic
 Hashable = typing.Hashable
 IO = typing.IO
diff --git a/requirements.txt b/requirements.txt
index 7d8c9cb7..313e0562 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -5,7 +5,7 @@ beautifulsoup4==4.12.3
 bleach==6.1.0
 certifi==2024.6.2
 cheroot==10.0.1
-cherrypy==18.9.0
+cherrypy==18.10.0
 cloudinary==1.40.0
 distro==1.9.0
 dnspython==2.6.1

From 3bc94cad6cd8fad28f8fb5f696908871927d22a9 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 19 Jun 2024 00:02:54 -0700
Subject: [PATCH 622/743] Bump tempora from 5.5.1 to 5.6.0 (#2355)

* Bump tempora from 5.5.1 to 5.6.0

Bumps [tempora](https://github.com/jaraco/tempora) from 5.5.1 to 5.6.0.
- [Release notes](https://github.com/jaraco/tempora/releases)
- [Changelog](https://github.com/jaraco/tempora/blob/main/NEWS.rst)
- [Commits](https://github.com/jaraco/tempora/compare/v5.5.1...v5.6.0)

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

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

* Update tempora==5.6.0

---------

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

[skip ci]
---
 requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements.txt b/requirements.txt
index 313e0562..f095fe03 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -39,7 +39,7 @@ requests-oauthlib==2.0.0
 rumps==0.4.0; platform_system == "Darwin"
 simplejson==3.19.2
 six==1.16.0
-tempora==5.5.1
+tempora==5.6.0
 tokenize-rt==5.2.0
 tzdata==2024.1
 tzlocal==5.0.1

From f1a8164b94d8eb25775dbbaaa3b7ea8886175805 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 19 Jun 2024 00:03:23 -0700
Subject: [PATCH 623/743] Bump pyobjc-core from 10.2 to 10.3.1 (#2349)

Bumps [pyobjc-core](https://github.com/ronaldoussoren/pyobjc) from 10.2 to 10.3.1.
- [Release notes](https://github.com/ronaldoussoren/pyobjc/releases)
- [Changelog](https://github.com/ronaldoussoren/pyobjc/blob/master/docs/changelog.rst)
- [Commits](https://github.com/ronaldoussoren/pyobjc/compare/v10.2...v10.3.1)

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

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 package/requirements-package.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index 0664c249..cbb1d737 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -5,7 +5,7 @@ pyinstaller==6.6.0
 pyopenssl==24.1.0
 pycryptodomex==3.20.0
 
-pyobjc-core==10.2; platform_system == "Darwin"
+pyobjc-core==10.3.1; platform_system == "Darwin"
 pyobjc-framework-Cocoa==10.2; platform_system == "Darwin"
 
 pywin32==306; platform_system == "Windows"

From 28ad2716ba6bf69348d1a69858b39cbe1824d48c Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 19 Jun 2024 00:04:15 -0700
Subject: [PATCH 624/743] Bump pyobjc-framework-cocoa from 10.2 to 10.3.1
 (#2348)

Bumps [pyobjc-framework-cocoa](https://github.com/ronaldoussoren/pyobjc) from 10.2 to 10.3.1.
- [Release notes](https://github.com/ronaldoussoren/pyobjc/releases)
- [Changelog](https://github.com/ronaldoussoren/pyobjc/blob/master/docs/changelog.rst)
- [Commits](https://github.com/ronaldoussoren/pyobjc/compare/v10.2...v10.3.1)

---
updated-dependencies:
- dependency-name: pyobjc-framework-cocoa
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

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

[skip ci]
---
 package/requirements-package.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index cbb1d737..a34a987e 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -6,6 +6,6 @@ pyopenssl==24.1.0
 pycryptodomex==3.20.0
 
 pyobjc-core==10.3.1; platform_system == "Darwin"
-pyobjc-framework-Cocoa==10.2; platform_system == "Darwin"
+pyobjc-framework-Cocoa==10.3.1; platform_system == "Darwin"
 
 pywin32==306; platform_system == "Windows"

From 2f1607b96bc8f26303d04052df1419535f4cd500 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 19 Jun 2024 00:04:34 -0700
Subject: [PATCH 625/743] Bump packaging from 24.0 to 24.1 (#2347)

* Bump packaging from 24.0 to 24.1

Bumps [packaging](https://github.com/pypa/packaging) from 24.0 to 24.1.
- [Release notes](https://github.com/pypa/packaging/releases)
- [Changelog](https://github.com/pypa/packaging/blob/main/CHANGELOG.rst)
- [Commits](https://github.com/pypa/packaging/compare/24.0...24.1)

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

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

* Update packaging==24.1

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/packaging/__init__.py     |   2 +-
 lib/packaging/_elffile.py     |   8 +-
 lib/packaging/_manylinux.py   |  22 ++---
 lib/packaging/_musllinux.py   |  10 ++-
 lib/packaging/_parser.py      |  26 +++---
 lib/packaging/_tokenizer.py   |  18 ++--
 lib/packaging/markers.py      | 113 ++++++++++++++++++++-----
 lib/packaging/metadata.py     | 153 +++++++++++++++-------------------
 lib/packaging/requirements.py |   9 +-
 lib/packaging/specifiers.py   |  56 ++++++-------
 lib/packaging/tags.py         |  43 +++++-----
 lib/packaging/utils.py        |  10 ++-
 lib/packaging/version.py      |  54 ++++++------
 requirements.txt              |   2 +-
 14 files changed, 288 insertions(+), 238 deletions(-)

diff --git a/lib/packaging/__init__.py b/lib/packaging/__init__.py
index e7c0aa12..9ba41d83 100644
--- a/lib/packaging/__init__.py
+++ b/lib/packaging/__init__.py
@@ -6,7 +6,7 @@ __title__ = "packaging"
 __summary__ = "Core utilities for Python packages"
 __uri__ = "https://github.com/pypa/packaging"
 
-__version__ = "24.0"
+__version__ = "24.1"
 
 __author__ = "Donald Stufft and individual contributors"
 __email__ = "donald@stufft.io"
diff --git a/lib/packaging/_elffile.py b/lib/packaging/_elffile.py
index 6fb19b30..f7a02180 100644
--- a/lib/packaging/_elffile.py
+++ b/lib/packaging/_elffile.py
@@ -8,10 +8,12 @@ Based on: https://gist.github.com/lyssdod/f51579ae8d93c8657a5564aefc2ffbca
 ELF header: https://refspecs.linuxfoundation.org/elf/gabi4+/ch4.eheader.html
 """
 
+from __future__ import annotations
+
 import enum
 import os
 import struct
-from typing import IO, Optional, Tuple
+from typing import IO
 
 
 class ELFInvalid(ValueError):
@@ -87,11 +89,11 @@ class ELFFile:
         except struct.error as e:
             raise ELFInvalid("unable to parse machine and section information") from e
 
-    def _read(self, fmt: str) -> Tuple[int, ...]:
+    def _read(self, fmt: str) -> tuple[int, ...]:
         return struct.unpack(fmt, self._f.read(struct.calcsize(fmt)))
 
     @property
-    def interpreter(self) -> Optional[str]:
+    def interpreter(self) -> str | None:
         """
         The path recorded in the ``PT_INTERP`` section header.
         """
diff --git a/lib/packaging/_manylinux.py b/lib/packaging/_manylinux.py
index ad62505f..08f651fb 100644
--- a/lib/packaging/_manylinux.py
+++ b/lib/packaging/_manylinux.py
@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import collections
 import contextlib
 import functools
@@ -5,7 +7,7 @@ import os
 import re
 import sys
 import warnings
-from typing import Dict, Generator, Iterator, NamedTuple, Optional, Sequence, Tuple
+from typing import Generator, Iterator, NamedTuple, Sequence
 
 from ._elffile import EIClass, EIData, ELFFile, EMachine
 
@@ -17,7 +19,7 @@ EF_ARM_ABI_FLOAT_HARD = 0x00000400
 # `os.PathLike` not a generic type until Python 3.9, so sticking with `str`
 # as the type for `path` until then.
 @contextlib.contextmanager
-def _parse_elf(path: str) -> Generator[Optional[ELFFile], None, None]:
+def _parse_elf(path: str) -> Generator[ELFFile | None, None, None]:
     try:
         with open(path, "rb") as f:
             yield ELFFile(f)
@@ -72,7 +74,7 @@ def _have_compatible_abi(executable: str, archs: Sequence[str]) -> bool:
 # For now, guess what the highest minor version might be, assume it will
 # be 50 for testing. Once this actually happens, update the dictionary
 # with the actual value.
-_LAST_GLIBC_MINOR: Dict[int, int] = collections.defaultdict(lambda: 50)
+_LAST_GLIBC_MINOR: dict[int, int] = collections.defaultdict(lambda: 50)
 
 
 class _GLibCVersion(NamedTuple):
@@ -80,7 +82,7 @@ class _GLibCVersion(NamedTuple):
     minor: int
 
 
-def _glibc_version_string_confstr() -> Optional[str]:
+def _glibc_version_string_confstr() -> str | None:
     """
     Primary implementation of glibc_version_string using os.confstr.
     """
@@ -90,7 +92,7 @@ def _glibc_version_string_confstr() -> Optional[str]:
     # https://github.com/python/cpython/blob/fcf1d003bf4f0100c/Lib/platform.py#L175-L183
     try:
         # Should be a string like "glibc 2.17".
-        version_string: Optional[str] = os.confstr("CS_GNU_LIBC_VERSION")
+        version_string: str | None = os.confstr("CS_GNU_LIBC_VERSION")
         assert version_string is not None
         _, version = version_string.rsplit()
     except (AssertionError, AttributeError, OSError, ValueError):
@@ -99,7 +101,7 @@ def _glibc_version_string_confstr() -> Optional[str]:
     return version
 
 
-def _glibc_version_string_ctypes() -> Optional[str]:
+def _glibc_version_string_ctypes() -> str | None:
     """
     Fallback implementation of glibc_version_string using ctypes.
     """
@@ -143,12 +145,12 @@ def _glibc_version_string_ctypes() -> Optional[str]:
     return version_str
 
 
-def _glibc_version_string() -> Optional[str]:
+def _glibc_version_string() -> str | None:
     """Returns glibc version string, or None if not using glibc."""
     return _glibc_version_string_confstr() or _glibc_version_string_ctypes()
 
 
-def _parse_glibc_version(version_str: str) -> Tuple[int, int]:
+def _parse_glibc_version(version_str: str) -> tuple[int, int]:
     """Parse glibc version.
 
     We use a regexp instead of str.split because we want to discard any
@@ -167,8 +169,8 @@ def _parse_glibc_version(version_str: str) -> Tuple[int, int]:
     return int(m.group("major")), int(m.group("minor"))
 
 
-@functools.lru_cache()
-def _get_glibc_version() -> Tuple[int, int]:
+@functools.lru_cache
+def _get_glibc_version() -> tuple[int, int]:
     version_str = _glibc_version_string()
     if version_str is None:
         return (-1, -1)
diff --git a/lib/packaging/_musllinux.py b/lib/packaging/_musllinux.py
index 86419df9..d2bf30b5 100644
--- a/lib/packaging/_musllinux.py
+++ b/lib/packaging/_musllinux.py
@@ -4,11 +4,13 @@ This module implements logic to detect if the currently running Python is
 linked against musl, and what musl version is used.
 """
 
+from __future__ import annotations
+
 import functools
 import re
 import subprocess
 import sys
-from typing import Iterator, NamedTuple, Optional, Sequence
+from typing import Iterator, NamedTuple, Sequence
 
 from ._elffile import ELFFile
 
@@ -18,7 +20,7 @@ class _MuslVersion(NamedTuple):
     minor: int
 
 
-def _parse_musl_version(output: str) -> Optional[_MuslVersion]:
+def _parse_musl_version(output: str) -> _MuslVersion | None:
     lines = [n for n in (n.strip() for n in output.splitlines()) if n]
     if len(lines) < 2 or lines[0][:4] != "musl":
         return None
@@ -28,8 +30,8 @@ def _parse_musl_version(output: str) -> Optional[_MuslVersion]:
     return _MuslVersion(major=int(m.group(1)), minor=int(m.group(2)))
 
 
-@functools.lru_cache()
-def _get_musl_version(executable: str) -> Optional[_MuslVersion]:
+@functools.lru_cache
+def _get_musl_version(executable: str) -> _MuslVersion | None:
     """Detect currently-running musl runtime version.
 
     This is done by checking the specified executable's dynamic linking
diff --git a/lib/packaging/_parser.py b/lib/packaging/_parser.py
index 684df754..c1238c06 100644
--- a/lib/packaging/_parser.py
+++ b/lib/packaging/_parser.py
@@ -1,11 +1,13 @@
 """Handwritten parser of dependency specifiers.
 
-The docstring for each __parse_* function contains ENBF-inspired grammar representing
+The docstring for each __parse_* function contains EBNF-inspired grammar representing
 the implementation.
 """
 
+from __future__ import annotations
+
 import ast
-from typing import Any, List, NamedTuple, Optional, Tuple, Union
+from typing import NamedTuple, Sequence, Tuple, Union
 
 from ._tokenizer import DEFAULT_RULES, Tokenizer
 
@@ -41,20 +43,16 @@ class Op(Node):
 
 MarkerVar = Union[Variable, Value]
 MarkerItem = Tuple[MarkerVar, Op, MarkerVar]
-# MarkerAtom = Union[MarkerItem, List["MarkerAtom"]]
-# MarkerList = List[Union["MarkerList", MarkerAtom, str]]
-# mypy does not support recursive type definition
-# https://github.com/python/mypy/issues/731
-MarkerAtom = Any
-MarkerList = List[Any]
+MarkerAtom = Union[MarkerItem, Sequence["MarkerAtom"]]
+MarkerList = Sequence[Union["MarkerList", MarkerAtom, str]]
 
 
 class ParsedRequirement(NamedTuple):
     name: str
     url: str
-    extras: List[str]
+    extras: list[str]
     specifier: str
-    marker: Optional[MarkerList]
+    marker: MarkerList | None
 
 
 # --------------------------------------------------------------------------------------
@@ -87,7 +85,7 @@ def _parse_requirement(tokenizer: Tokenizer) -> ParsedRequirement:
 
 def _parse_requirement_details(
     tokenizer: Tokenizer,
-) -> Tuple[str, str, Optional[MarkerList]]:
+) -> tuple[str, str, MarkerList | None]:
     """
     requirement_details = AT URL (WS requirement_marker?)?
                         | specifier WS? (requirement_marker)?
@@ -156,7 +154,7 @@ def _parse_requirement_marker(
     return marker
 
 
-def _parse_extras(tokenizer: Tokenizer) -> List[str]:
+def _parse_extras(tokenizer: Tokenizer) -> list[str]:
     """
     extras = (LEFT_BRACKET wsp* extras_list? wsp* RIGHT_BRACKET)?
     """
@@ -175,11 +173,11 @@ def _parse_extras(tokenizer: Tokenizer) -> List[str]:
     return extras
 
 
-def _parse_extras_list(tokenizer: Tokenizer) -> List[str]:
+def _parse_extras_list(tokenizer: Tokenizer) -> list[str]:
     """
     extras_list = identifier (wsp* ',' wsp* identifier)*
     """
-    extras: List[str] = []
+    extras: list[str] = []
 
     if not tokenizer.check("IDENTIFIER"):
         return extras
diff --git a/lib/packaging/_tokenizer.py b/lib/packaging/_tokenizer.py
index dd0d648d..89d04160 100644
--- a/lib/packaging/_tokenizer.py
+++ b/lib/packaging/_tokenizer.py
@@ -1,7 +1,9 @@
+from __future__ import annotations
+
 import contextlib
 import re
 from dataclasses import dataclass
-from typing import Dict, Iterator, NoReturn, Optional, Tuple, Union
+from typing import Iterator, NoReturn
 
 from .specifiers import Specifier
 
@@ -21,7 +23,7 @@ class ParserSyntaxError(Exception):
         message: str,
         *,
         source: str,
-        span: Tuple[int, int],
+        span: tuple[int, int],
     ) -> None:
         self.span = span
         self.message = message
@@ -34,7 +36,7 @@ class ParserSyntaxError(Exception):
         return "\n    ".join([self.message, self.source, marker])
 
 
-DEFAULT_RULES: "Dict[str, Union[str, re.Pattern[str]]]" = {
+DEFAULT_RULES: dict[str, str | re.Pattern[str]] = {
     "LEFT_PARENTHESIS": r"\(",
     "RIGHT_PARENTHESIS": r"\)",
     "LEFT_BRACKET": r"\[",
@@ -96,13 +98,13 @@ class Tokenizer:
         self,
         source: str,
         *,
-        rules: "Dict[str, Union[str, re.Pattern[str]]]",
+        rules: dict[str, str | re.Pattern[str]],
     ) -> None:
         self.source = source
-        self.rules: Dict[str, re.Pattern[str]] = {
+        self.rules: dict[str, re.Pattern[str]] = {
             name: re.compile(pattern) for name, pattern in rules.items()
         }
-        self.next_token: Optional[Token] = None
+        self.next_token: Token | None = None
         self.position = 0
 
     def consume(self, name: str) -> None:
@@ -154,8 +156,8 @@ class Tokenizer:
         self,
         message: str,
         *,
-        span_start: Optional[int] = None,
-        span_end: Optional[int] = None,
+        span_start: int | None = None,
+        span_end: int | None = None,
     ) -> NoReturn:
         """Raise ParserSyntaxError at the given position."""
         span = (
diff --git a/lib/packaging/markers.py b/lib/packaging/markers.py
index 8b98fca7..7ac7bb69 100644
--- a/lib/packaging/markers.py
+++ b/lib/packaging/markers.py
@@ -2,20 +2,16 @@
 # 2.0, and the BSD License. See the LICENSE file in the root of this repository
 # for complete details.
 
+from __future__ import annotations
+
 import operator
 import os
 import platform
 import sys
-from typing import Any, Callable, Dict, List, Optional, Tuple, Union
+from typing import Any, Callable, TypedDict, cast
 
-from ._parser import (
-    MarkerAtom,
-    MarkerList,
-    Op,
-    Value,
-    Variable,
-    parse_marker as _parse_marker,
-)
+from ._parser import MarkerAtom, MarkerList, Op, Value, Variable
+from ._parser import parse_marker as _parse_marker
 from ._tokenizer import ParserSyntaxError
 from .specifiers import InvalidSpecifier, Specifier
 from .utils import canonicalize_name
@@ -50,6 +46,78 @@ class UndefinedEnvironmentName(ValueError):
     """
 
 
+class Environment(TypedDict):
+    implementation_name: str
+    """The implementation's identifier, e.g. ``'cpython'``."""
+
+    implementation_version: str
+    """
+    The implementation's version, e.g. ``'3.13.0a2'`` for CPython 3.13.0a2, or
+    ``'7.3.13'`` for PyPy3.10 v7.3.13.
+    """
+
+    os_name: str
+    """
+    The value of :py:data:`os.name`. The name of the operating system dependent module
+    imported, e.g. ``'posix'``.
+    """
+
+    platform_machine: str
+    """
+    Returns the machine type, e.g. ``'i386'``.
+
+    An empty string if the value cannot be determined.
+    """
+
+    platform_release: str
+    """
+    The system's release, e.g. ``'2.2.0'`` or ``'NT'``.
+
+    An empty string if the value cannot be determined.
+    """
+
+    platform_system: str
+    """
+    The system/OS name, e.g. ``'Linux'``, ``'Windows'`` or ``'Java'``.
+
+    An empty string if the value cannot be determined.
+    """
+
+    platform_version: str
+    """
+    The system's release version, e.g. ``'#3 on degas'``.
+
+    An empty string if the value cannot be determined.
+    """
+
+    python_full_version: str
+    """
+    The Python version as string ``'major.minor.patchlevel'``.
+
+    Note that unlike the Python :py:data:`sys.version`, this value will always include
+    the patchlevel (it defaults to 0).
+    """
+
+    platform_python_implementation: str
+    """
+    A string identifying the Python implementation, e.g. ``'CPython'``.
+    """
+
+    python_version: str
+    """The Python version as string ``'major.minor'``."""
+
+    sys_platform: str
+    """
+    This string contains a platform identifier that can be used to append
+    platform-specific components to :py:data:`sys.path`, for instance.
+
+    For Unix systems, except on Linux and AIX, this is the lowercased OS name as
+    returned by ``uname -s`` with the first part of the version as returned by
+    ``uname -r`` appended, e.g. ``'sunos5'`` or ``'freebsd8'``, at the time when Python
+    was built.
+    """
+
+
 def _normalize_extra_values(results: Any) -> Any:
     """
     Normalize extra values.
@@ -67,9 +135,8 @@ def _normalize_extra_values(results: Any) -> Any:
 
 
 def _format_marker(
-    marker: Union[List[str], MarkerAtom, str], first: Optional[bool] = True
+    marker: list[str] | MarkerAtom | str, first: bool | None = True
 ) -> str:
-
     assert isinstance(marker, (list, tuple, str))
 
     # Sometimes we have a structure like [[...]] which is a single item list
@@ -95,7 +162,7 @@ def _format_marker(
         return marker
 
 
-_operators: Dict[str, Operator] = {
+_operators: dict[str, Operator] = {
     "in": lambda lhs, rhs: lhs in rhs,
     "not in": lambda lhs, rhs: lhs not in rhs,
     "<": operator.lt,
@@ -115,14 +182,14 @@ def _eval_op(lhs: str, op: Op, rhs: str) -> bool:
     else:
         return spec.contains(lhs, prereleases=True)
 
-    oper: Optional[Operator] = _operators.get(op.serialize())
+    oper: Operator | None = _operators.get(op.serialize())
     if oper is None:
         raise UndefinedComparison(f"Undefined {op!r} on {lhs!r} and {rhs!r}.")
 
     return oper(lhs, rhs)
 
 
-def _normalize(*values: str, key: str) -> Tuple[str, ...]:
+def _normalize(*values: str, key: str) -> tuple[str, ...]:
     # PEP 685 – Comparison of extra names for optional distribution dependencies
     # https://peps.python.org/pep-0685/
     # > When comparing extra names, tools MUST normalize the names being
@@ -134,8 +201,8 @@ def _normalize(*values: str, key: str) -> Tuple[str, ...]:
     return values
 
 
-def _evaluate_markers(markers: MarkerList, environment: Dict[str, str]) -> bool:
-    groups: List[List[bool]] = [[]]
+def _evaluate_markers(markers: MarkerList, environment: dict[str, str]) -> bool:
+    groups: list[list[bool]] = [[]]
 
     for marker in markers:
         assert isinstance(marker, (list, tuple, str))
@@ -164,7 +231,7 @@ def _evaluate_markers(markers: MarkerList, environment: Dict[str, str]) -> bool:
     return any(all(item) for item in groups)
 
 
-def format_full_version(info: "sys._version_info") -> str:
+def format_full_version(info: sys._version_info) -> str:
     version = "{0.major}.{0.minor}.{0.micro}".format(info)
     kind = info.releaselevel
     if kind != "final":
@@ -172,7 +239,7 @@ def format_full_version(info: "sys._version_info") -> str:
     return version
 
 
-def default_environment() -> Dict[str, str]:
+def default_environment() -> Environment:
     iver = format_full_version(sys.implementation.version)
     implementation_name = sys.implementation.name
     return {
@@ -231,7 +298,7 @@ class Marker:
 
         return str(self) == str(other)
 
-    def evaluate(self, environment: Optional[Dict[str, str]] = None) -> bool:
+    def evaluate(self, environment: dict[str, str] | None = None) -> bool:
         """Evaluate a marker.
 
         Return the boolean from evaluating the given marker against the
@@ -240,8 +307,14 @@ class Marker:
 
         The environment is determined from the current Python process.
         """
-        current_environment = default_environment()
+        current_environment = cast("dict[str, str]", default_environment())
         current_environment["extra"] = ""
+        # Work around platform.python_version() returning something that is not PEP 440
+        # compliant for non-tagged Python builds. We preserve default_environment()'s
+        # behavior of returning platform.python_version() verbatim, and leave it to the
+        # caller to provide a syntactically valid version if they want to override it.
+        if current_environment["python_full_version"].endswith("+"):
+            current_environment["python_full_version"] += "local"
         if environment is not None:
             current_environment.update(environment)
             # The API used to allow setting extra to None. We need to handle this
diff --git a/lib/packaging/metadata.py b/lib/packaging/metadata.py
index fb274930..eb8dc844 100644
--- a/lib/packaging/metadata.py
+++ b/lib/packaging/metadata.py
@@ -1,50 +1,31 @@
+from __future__ import annotations
+
 import email.feedparser
 import email.header
 import email.message
 import email.parser
 import email.policy
-import sys
 import typing
 from typing import (
     Any,
     Callable,
-    Dict,
     Generic,
-    List,
-    Optional,
-    Tuple,
-    Type,
-    Union,
+    Literal,
+    TypedDict,
     cast,
 )
 
-from . import requirements, specifiers, utils, version as version_module
+from . import requirements, specifiers, utils
+from . import version as version_module
 
 T = typing.TypeVar("T")
-if sys.version_info[:2] >= (3, 8):  # pragma: no cover
-    from typing import Literal, TypedDict
-else:  # pragma: no cover
-    if typing.TYPE_CHECKING:
-        from typing_extensions import Literal, TypedDict
-    else:
-        try:
-            from typing_extensions import Literal, TypedDict
-        except ImportError:
-
-            class Literal:
-                def __init_subclass__(*_args, **_kwargs):
-                    pass
-
-            class TypedDict:
-                def __init_subclass__(*_args, **_kwargs):
-                    pass
 
 
 try:
     ExceptionGroup
 except NameError:  # pragma: no cover
 
-    class ExceptionGroup(Exception):  # noqa: N818
+    class ExceptionGroup(Exception):
         """A minimal implementation of :external:exc:`ExceptionGroup` from Python 3.11.
 
         If :external:exc:`ExceptionGroup` is already defined by Python itself,
@@ -52,9 +33,9 @@ except NameError:  # pragma: no cover
         """
 
         message: str
-        exceptions: List[Exception]
+        exceptions: list[Exception]
 
-        def __init__(self, message: str, exceptions: List[Exception]) -> None:
+        def __init__(self, message: str, exceptions: list[Exception]) -> None:
             self.message = message
             self.exceptions = exceptions
 
@@ -100,32 +81,32 @@ class RawMetadata(TypedDict, total=False):
     metadata_version: str
     name: str
     version: str
-    platforms: List[str]
+    platforms: list[str]
     summary: str
     description: str
-    keywords: List[str]
+    keywords: list[str]
     home_page: str
     author: str
     author_email: str
     license: str
 
     # Metadata 1.1 - PEP 314
-    supported_platforms: List[str]
+    supported_platforms: list[str]
     download_url: str
-    classifiers: List[str]
-    requires: List[str]
-    provides: List[str]
-    obsoletes: List[str]
+    classifiers: list[str]
+    requires: list[str]
+    provides: list[str]
+    obsoletes: list[str]
 
     # Metadata 1.2 - PEP 345
     maintainer: str
     maintainer_email: str
-    requires_dist: List[str]
-    provides_dist: List[str]
-    obsoletes_dist: List[str]
+    requires_dist: list[str]
+    provides_dist: list[str]
+    obsoletes_dist: list[str]
     requires_python: str
-    requires_external: List[str]
-    project_urls: Dict[str, str]
+    requires_external: list[str]
+    project_urls: dict[str, str]
 
     # Metadata 2.0
     # PEP 426 attempted to completely revamp the metadata format
@@ -138,10 +119,10 @@ class RawMetadata(TypedDict, total=False):
 
     # Metadata 2.1 - PEP 566
     description_content_type: str
-    provides_extra: List[str]
+    provides_extra: list[str]
 
     # Metadata 2.2 - PEP 643
-    dynamic: List[str]
+    dynamic: list[str]
 
     # Metadata 2.3 - PEP 685
     # No new fields were added in PEP 685, just some edge case were
@@ -185,12 +166,12 @@ _DICT_FIELDS = {
 }
 
 
-def _parse_keywords(data: str) -> List[str]:
+def _parse_keywords(data: str) -> list[str]:
     """Split a string of comma-separate keyboards into a list of keywords."""
     return [k.strip() for k in data.split(",")]
 
 
-def _parse_project_urls(data: List[str]) -> Dict[str, str]:
+def _parse_project_urls(data: list[str]) -> dict[str, str]:
     """Parse a list of label/URL string pairings separated by a comma."""
     urls = {}
     for pair in data:
@@ -230,7 +211,7 @@ def _parse_project_urls(data: List[str]) -> Dict[str, str]:
     return urls
 
 
-def _get_payload(msg: email.message.Message, source: Union[bytes, str]) -> str:
+def _get_payload(msg: email.message.Message, source: bytes | str) -> str:
     """Get the body of the message."""
     # If our source is a str, then our caller has managed encodings for us,
     # and we don't need to deal with it.
@@ -292,7 +273,7 @@ _EMAIL_TO_RAW_MAPPING = {
 _RAW_TO_EMAIL_MAPPING = {raw: email for email, raw in _EMAIL_TO_RAW_MAPPING.items()}
 
 
-def parse_email(data: Union[bytes, str]) -> Tuple[RawMetadata, Dict[str, List[str]]]:
+def parse_email(data: bytes | str) -> tuple[RawMetadata, dict[str, list[str]]]:
     """Parse a distribution's metadata stored as email headers (e.g. from ``METADATA``).
 
     This function returns a two-item tuple of dicts. The first dict is of
@@ -308,8 +289,8 @@ def parse_email(data: Union[bytes, str]) -> Tuple[RawMetadata, Dict[str, List[st
     included in this dict.
 
     """
-    raw: Dict[str, Union[str, List[str], Dict[str, str]]] = {}
-    unparsed: Dict[str, List[str]] = {}
+    raw: dict[str, str | list[str] | dict[str, str]] = {}
+    unparsed: dict[str, list[str]] = {}
 
     if isinstance(data, str):
         parsed = email.parser.Parser(policy=email.policy.compat32).parsestr(data)
@@ -357,7 +338,7 @@ def parse_email(data: Union[bytes, str]) -> Tuple[RawMetadata, Dict[str, List[st
                 # The Header object stores it's data as chunks, and each chunk
                 # can be independently encoded, so we'll need to check each
                 # of them.
-                chunks: List[Tuple[bytes, Optional[str]]] = []
+                chunks: list[tuple[bytes, str | None]] = []
                 for bin, encoding in email.header.decode_header(h):
                     try:
                         bin.decode("utf8", "strict")
@@ -499,11 +480,11 @@ class _Validator(Generic[T]):
     ) -> None:
         self.added = added
 
-    def __set_name__(self, _owner: "Metadata", name: str) -> None:
+    def __set_name__(self, _owner: Metadata, name: str) -> None:
         self.name = name
         self.raw_name = _RAW_TO_EMAIL_MAPPING[name]
 
-    def __get__(self, instance: "Metadata", _owner: Type["Metadata"]) -> T:
+    def __get__(self, instance: Metadata, _owner: type[Metadata]) -> T:
         # With Python 3.8, the caching can be replaced with functools.cached_property().
         # No need to check the cache as attribute lookup will resolve into the
         # instance's __dict__ before __get__ is called.
@@ -531,7 +512,7 @@ class _Validator(Generic[T]):
         return cast(T, value)
 
     def _invalid_metadata(
-        self, msg: str, cause: Optional[Exception] = None
+        self, msg: str, cause: Exception | None = None
     ) -> InvalidMetadata:
         exc = InvalidMetadata(
             self.raw_name, msg.format_map({"field": repr(self.raw_name)})
@@ -606,7 +587,7 @@ class _Validator(Generic[T]):
             )
         return value
 
-    def _process_dynamic(self, value: List[str]) -> List[str]:
+    def _process_dynamic(self, value: list[str]) -> list[str]:
         for dynamic_field in map(str.lower, value):
             if dynamic_field in {"name", "version", "metadata-version"}:
                 raise self._invalid_metadata(
@@ -618,8 +599,8 @@ class _Validator(Generic[T]):
 
     def _process_provides_extra(
         self,
-        value: List[str],
-    ) -> List[utils.NormalizedName]:
+        value: list[str],
+    ) -> list[utils.NormalizedName]:
         normalized_names = []
         try:
             for name in value:
@@ -641,8 +622,8 @@ class _Validator(Generic[T]):
 
     def _process_requires_dist(
         self,
-        value: List[str],
-    ) -> List[requirements.Requirement]:
+        value: list[str],
+    ) -> list[requirements.Requirement]:
         reqs = []
         try:
             for req in value:
@@ -665,7 +646,7 @@ class Metadata:
     _raw: RawMetadata
 
     @classmethod
-    def from_raw(cls, data: RawMetadata, *, validate: bool = True) -> "Metadata":
+    def from_raw(cls, data: RawMetadata, *, validate: bool = True) -> Metadata:
         """Create an instance from :class:`RawMetadata`.
 
         If *validate* is true, all metadata will be validated. All exceptions
@@ -675,7 +656,7 @@ class Metadata:
         ins._raw = data.copy()  # Mutations occur due to caching enriched values.
 
         if validate:
-            exceptions: List[Exception] = []
+            exceptions: list[Exception] = []
             try:
                 metadata_version = ins.metadata_version
                 metadata_age = _VALID_METADATA_VERSIONS.index(metadata_version)
@@ -722,9 +703,7 @@ class Metadata:
         return ins
 
     @classmethod
-    def from_email(
-        cls, data: Union[bytes, str], *, validate: bool = True
-    ) -> "Metadata":
+    def from_email(cls, data: bytes | str, *, validate: bool = True) -> Metadata:
         """Parse metadata from email headers.
 
         If *validate* is true, the metadata will be validated. All exceptions
@@ -760,66 +739,66 @@ class Metadata:
     *validate* parameter)"""
     version: _Validator[version_module.Version] = _Validator()
     """:external:ref:`core-metadata-version` (required)"""
-    dynamic: _Validator[Optional[List[str]]] = _Validator(
+    dynamic: _Validator[list[str] | None] = _Validator(
         added="2.2",
     )
     """:external:ref:`core-metadata-dynamic`
     (validated against core metadata field names and lowercased)"""
-    platforms: _Validator[Optional[List[str]]] = _Validator()
+    platforms: _Validator[list[str] | None] = _Validator()
     """:external:ref:`core-metadata-platform`"""
-    supported_platforms: _Validator[Optional[List[str]]] = _Validator(added="1.1")
+    supported_platforms: _Validator[list[str] | None] = _Validator(added="1.1")
     """:external:ref:`core-metadata-supported-platform`"""
-    summary: _Validator[Optional[str]] = _Validator()
+    summary: _Validator[str | None] = _Validator()
     """:external:ref:`core-metadata-summary` (validated to contain no newlines)"""
-    description: _Validator[Optional[str]] = _Validator()  # TODO 2.1: can be in body
+    description: _Validator[str | None] = _Validator()  # TODO 2.1: can be in body
     """:external:ref:`core-metadata-description`"""
-    description_content_type: _Validator[Optional[str]] = _Validator(added="2.1")
+    description_content_type: _Validator[str | None] = _Validator(added="2.1")
     """:external:ref:`core-metadata-description-content-type` (validated)"""
-    keywords: _Validator[Optional[List[str]]] = _Validator()
+    keywords: _Validator[list[str] | None] = _Validator()
     """:external:ref:`core-metadata-keywords`"""
-    home_page: _Validator[Optional[str]] = _Validator()
+    home_page: _Validator[str | None] = _Validator()
     """:external:ref:`core-metadata-home-page`"""
-    download_url: _Validator[Optional[str]] = _Validator(added="1.1")
+    download_url: _Validator[str | None] = _Validator(added="1.1")
     """:external:ref:`core-metadata-download-url`"""
-    author: _Validator[Optional[str]] = _Validator()
+    author: _Validator[str | None] = _Validator()
     """:external:ref:`core-metadata-author`"""
-    author_email: _Validator[Optional[str]] = _Validator()
+    author_email: _Validator[str | None] = _Validator()
     """:external:ref:`core-metadata-author-email`"""
-    maintainer: _Validator[Optional[str]] = _Validator(added="1.2")
+    maintainer: _Validator[str | None] = _Validator(added="1.2")
     """:external:ref:`core-metadata-maintainer`"""
-    maintainer_email: _Validator[Optional[str]] = _Validator(added="1.2")
+    maintainer_email: _Validator[str | None] = _Validator(added="1.2")
     """:external:ref:`core-metadata-maintainer-email`"""
-    license: _Validator[Optional[str]] = _Validator()
+    license: _Validator[str | None] = _Validator()
     """:external:ref:`core-metadata-license`"""
-    classifiers: _Validator[Optional[List[str]]] = _Validator(added="1.1")
+    classifiers: _Validator[list[str] | None] = _Validator(added="1.1")
     """:external:ref:`core-metadata-classifier`"""
-    requires_dist: _Validator[Optional[List[requirements.Requirement]]] = _Validator(
+    requires_dist: _Validator[list[requirements.Requirement] | None] = _Validator(
         added="1.2"
     )
     """:external:ref:`core-metadata-requires-dist`"""
-    requires_python: _Validator[Optional[specifiers.SpecifierSet]] = _Validator(
+    requires_python: _Validator[specifiers.SpecifierSet | None] = _Validator(
         added="1.2"
     )
     """:external:ref:`core-metadata-requires-python`"""
     # Because `Requires-External` allows for non-PEP 440 version specifiers, we
     # don't do any processing on the values.
-    requires_external: _Validator[Optional[List[str]]] = _Validator(added="1.2")
+    requires_external: _Validator[list[str] | None] = _Validator(added="1.2")
     """:external:ref:`core-metadata-requires-external`"""
-    project_urls: _Validator[Optional[Dict[str, str]]] = _Validator(added="1.2")
+    project_urls: _Validator[dict[str, str] | None] = _Validator(added="1.2")
     """:external:ref:`core-metadata-project-url`"""
     # PEP 685 lets us raise an error if an extra doesn't pass `Name` validation
     # regardless of metadata version.
-    provides_extra: _Validator[Optional[List[utils.NormalizedName]]] = _Validator(
+    provides_extra: _Validator[list[utils.NormalizedName] | None] = _Validator(
         added="2.1",
     )
     """:external:ref:`core-metadata-provides-extra`"""
-    provides_dist: _Validator[Optional[List[str]]] = _Validator(added="1.2")
+    provides_dist: _Validator[list[str] | None] = _Validator(added="1.2")
     """:external:ref:`core-metadata-provides-dist`"""
-    obsoletes_dist: _Validator[Optional[List[str]]] = _Validator(added="1.2")
+    obsoletes_dist: _Validator[list[str] | None] = _Validator(added="1.2")
     """:external:ref:`core-metadata-obsoletes-dist`"""
-    requires: _Validator[Optional[List[str]]] = _Validator(added="1.1")
+    requires: _Validator[list[str] | None] = _Validator(added="1.1")
     """``Requires`` (deprecated)"""
-    provides: _Validator[Optional[List[str]]] = _Validator(added="1.1")
+    provides: _Validator[list[str] | None] = _Validator(added="1.1")
     """``Provides`` (deprecated)"""
-    obsoletes: _Validator[Optional[List[str]]] = _Validator(added="1.1")
+    obsoletes: _Validator[list[str] | None] = _Validator(added="1.1")
     """``Obsoletes`` (deprecated)"""
diff --git a/lib/packaging/requirements.py b/lib/packaging/requirements.py
index bdc43a7e..4e068c95 100644
--- a/lib/packaging/requirements.py
+++ b/lib/packaging/requirements.py
@@ -1,8 +1,9 @@
 # This file is dual licensed under the terms of the Apache License, Version
 # 2.0, and the BSD License. See the LICENSE file in the root of this repository
 # for complete details.
+from __future__ import annotations
 
-from typing import Any, Iterator, Optional, Set
+from typing import Any, Iterator
 
 from ._parser import parse_requirement as _parse_requirement
 from ._tokenizer import ParserSyntaxError
@@ -37,10 +38,10 @@ class Requirement:
             raise InvalidRequirement(str(e)) from e
 
         self.name: str = parsed.name
-        self.url: Optional[str] = parsed.url or None
-        self.extras: Set[str] = set(parsed.extras or [])
+        self.url: str | None = parsed.url or None
+        self.extras: set[str] = set(parsed.extras or [])
         self.specifier: SpecifierSet = SpecifierSet(parsed.specifier)
-        self.marker: Optional[Marker] = None
+        self.marker: Marker | None = None
         if parsed.marker is not None:
             self.marker = Marker.__new__(Marker)
             self.marker._markers = _normalize_extra_values(parsed.marker)
diff --git a/lib/packaging/specifiers.py b/lib/packaging/specifiers.py
index 2d015bab..2fa75f7a 100644
--- a/lib/packaging/specifiers.py
+++ b/lib/packaging/specifiers.py
@@ -8,10 +8,12 @@
     from packaging.version import Version
 """
 
+from __future__ import annotations
+
 import abc
 import itertools
 import re
-from typing import Callable, Iterable, Iterator, List, Optional, Tuple, TypeVar, Union
+from typing import Callable, Iterable, Iterator, TypeVar, Union
 
 from .utils import canonicalize_version
 from .version import Version
@@ -64,7 +66,7 @@ class BaseSpecifier(metaclass=abc.ABCMeta):
 
     @property
     @abc.abstractmethod
-    def prereleases(self) -> Optional[bool]:
+    def prereleases(self) -> bool | None:
         """Whether or not pre-releases as a whole are allowed.
 
         This can be set to either ``True`` or ``False`` to explicitly enable or disable
@@ -79,14 +81,14 @@ class BaseSpecifier(metaclass=abc.ABCMeta):
         """
 
     @abc.abstractmethod
-    def contains(self, item: str, prereleases: Optional[bool] = None) -> bool:
+    def contains(self, item: str, prereleases: bool | None = None) -> bool:
         """
         Determines if the given item is contained within this specifier.
         """
 
     @abc.abstractmethod
     def filter(
-        self, iterable: Iterable[UnparsedVersionVar], prereleases: Optional[bool] = None
+        self, iterable: Iterable[UnparsedVersionVar], prereleases: bool | None = None
     ) -> Iterator[UnparsedVersionVar]:
         """
         Takes an iterable of items and filters them so that only items which
@@ -217,7 +219,7 @@ class Specifier(BaseSpecifier):
         "===": "arbitrary",
     }
 
-    def __init__(self, spec: str = "", prereleases: Optional[bool] = None) -> None:
+    def __init__(self, spec: str = "", prereleases: bool | None = None) -> None:
         """Initialize a Specifier instance.
 
         :param spec:
@@ -234,7 +236,7 @@ class Specifier(BaseSpecifier):
         if not match:
             raise InvalidSpecifier(f"Invalid specifier: '{spec}'")
 
-        self._spec: Tuple[str, str] = (
+        self._spec: tuple[str, str] = (
             match.group("operator").strip(),
             match.group("version").strip(),
         )
@@ -318,7 +320,7 @@ class Specifier(BaseSpecifier):
         return "{}{}".format(*self._spec)
 
     @property
-    def _canonical_spec(self) -> Tuple[str, str]:
+    def _canonical_spec(self) -> tuple[str, str]:
         canonical_version = canonicalize_version(
             self._spec[1],
             strip_trailing_zero=(self._spec[0] != "~="),
@@ -364,7 +366,6 @@ class Specifier(BaseSpecifier):
         return operator_callable
 
     def _compare_compatible(self, prospective: Version, spec: str) -> bool:
-
         # Compatible releases have an equivalent combination of >= and ==. That
         # is that ~=2.2 is equivalent to >=2.2,==2.*. This allows us to
         # implement this in terms of the other specifiers instead of
@@ -385,7 +386,6 @@ class Specifier(BaseSpecifier):
         )
 
     def _compare_equal(self, prospective: Version, spec: str) -> bool:
-
         # We need special logic to handle prefix matching
         if spec.endswith(".*"):
             # In the case of prefix matching we want to ignore local segment.
@@ -429,21 +429,18 @@ class Specifier(BaseSpecifier):
         return not self._compare_equal(prospective, spec)
 
     def _compare_less_than_equal(self, prospective: Version, spec: str) -> bool:
-
         # NB: Local version identifiers are NOT permitted in the version
         # specifier, so local version labels can be universally removed from
         # the prospective version.
         return Version(prospective.public) <= Version(spec)
 
     def _compare_greater_than_equal(self, prospective: Version, spec: str) -> bool:
-
         # NB: Local version identifiers are NOT permitted in the version
         # specifier, so local version labels can be universally removed from
         # the prospective version.
         return Version(prospective.public) >= Version(spec)
 
     def _compare_less_than(self, prospective: Version, spec_str: str) -> bool:
-
         # Convert our spec to a Version instance, since we'll want to work with
         # it as a version.
         spec = Version(spec_str)
@@ -468,7 +465,6 @@ class Specifier(BaseSpecifier):
         return True
 
     def _compare_greater_than(self, prospective: Version, spec_str: str) -> bool:
-
         # Convert our spec to a Version instance, since we'll want to work with
         # it as a version.
         spec = Version(spec_str)
@@ -501,7 +497,7 @@ class Specifier(BaseSpecifier):
     def _compare_arbitrary(self, prospective: Version, spec: str) -> bool:
         return str(prospective).lower() == str(spec).lower()
 
-    def __contains__(self, item: Union[str, Version]) -> bool:
+    def __contains__(self, item: str | Version) -> bool:
         """Return whether or not the item is contained in this specifier.
 
         :param item: The item to check for.
@@ -522,9 +518,7 @@ class Specifier(BaseSpecifier):
         """
         return self.contains(item)
 
-    def contains(
-        self, item: UnparsedVersion, prereleases: Optional[bool] = None
-    ) -> bool:
+    def contains(self, item: UnparsedVersion, prereleases: bool | None = None) -> bool:
         """Return whether or not the item is contained in this specifier.
 
         :param item:
@@ -569,7 +563,7 @@ class Specifier(BaseSpecifier):
         return operator_callable(normalized_item, self.version)
 
     def filter(
-        self, iterable: Iterable[UnparsedVersionVar], prereleases: Optional[bool] = None
+        self, iterable: Iterable[UnparsedVersionVar], prereleases: bool | None = None
     ) -> Iterator[UnparsedVersionVar]:
         """Filter items in the given iterable, that match the specifier.
 
@@ -633,7 +627,7 @@ class Specifier(BaseSpecifier):
 _prefix_regex = re.compile(r"^([0-9]+)((?:a|b|c|rc)[0-9]+)$")
 
 
-def _version_split(version: str) -> List[str]:
+def _version_split(version: str) -> list[str]:
     """Split version into components.
 
     The split components are intended for version comparison. The logic does
@@ -641,7 +635,7 @@ def _version_split(version: str) -> List[str]:
     components back with :func:`_version_join` may not produce the original
     version string.
     """
-    result: List[str] = []
+    result: list[str] = []
 
     epoch, _, rest = version.rpartition("!")
     result.append(epoch or "0")
@@ -655,7 +649,7 @@ def _version_split(version: str) -> List[str]:
     return result
 
 
-def _version_join(components: List[str]) -> str:
+def _version_join(components: list[str]) -> str:
     """Join split version components into a version string.
 
     This function assumes the input came from :func:`_version_split`, where the
@@ -672,7 +666,7 @@ def _is_not_suffix(segment: str) -> bool:
     )
 
 
-def _pad_version(left: List[str], right: List[str]) -> Tuple[List[str], List[str]]:
+def _pad_version(left: list[str], right: list[str]) -> tuple[list[str], list[str]]:
     left_split, right_split = [], []
 
     # Get the release segment of our versions
@@ -700,9 +694,7 @@ class SpecifierSet(BaseSpecifier):
     specifiers (``>=3.0,!=3.1``), or no specifier at all.
     """
 
-    def __init__(
-        self, specifiers: str = "", prereleases: Optional[bool] = None
-    ) -> None:
+    def __init__(self, specifiers: str = "", prereleases: bool | None = None) -> None:
         """Initialize a SpecifierSet instance.
 
         :param specifiers:
@@ -730,7 +722,7 @@ class SpecifierSet(BaseSpecifier):
         self._prereleases = prereleases
 
     @property
-    def prereleases(self) -> Optional[bool]:
+    def prereleases(self) -> bool | None:
         # If we have been given an explicit prerelease modifier, then we'll
         # pass that through here.
         if self._prereleases is not None:
@@ -787,7 +779,7 @@ class SpecifierSet(BaseSpecifier):
     def __hash__(self) -> int:
         return hash(self._specs)
 
-    def __and__(self, other: Union["SpecifierSet", str]) -> "SpecifierSet":
+    def __and__(self, other: SpecifierSet | str) -> SpecifierSet:
         """Return a SpecifierSet which is a combination of the two sets.
 
         :param other: The other object to combine with.
@@ -883,8 +875,8 @@ class SpecifierSet(BaseSpecifier):
     def contains(
         self,
         item: UnparsedVersion,
-        prereleases: Optional[bool] = None,
-        installed: Optional[bool] = None,
+        prereleases: bool | None = None,
+        installed: bool | None = None,
     ) -> bool:
         """Return whether or not the item is contained in this SpecifierSet.
 
@@ -938,7 +930,7 @@ class SpecifierSet(BaseSpecifier):
         return all(s.contains(item, prereleases=prereleases) for s in self._specs)
 
     def filter(
-        self, iterable: Iterable[UnparsedVersionVar], prereleases: Optional[bool] = None
+        self, iterable: Iterable[UnparsedVersionVar], prereleases: bool | None = None
     ) -> Iterator[UnparsedVersionVar]:
         """Filter items in the given iterable, that match the specifiers in this set.
 
@@ -995,8 +987,8 @@ class SpecifierSet(BaseSpecifier):
         # which will filter out any pre-releases, unless there are no final
         # releases.
         else:
-            filtered: List[UnparsedVersionVar] = []
-            found_prereleases: List[UnparsedVersionVar] = []
+            filtered: list[UnparsedVersionVar] = []
+            found_prereleases: list[UnparsedVersionVar] = []
 
             for item in iterable:
                 parsed_version = _coerce_version(item)
diff --git a/lib/packaging/tags.py b/lib/packaging/tags.py
index 89f19261..6667d299 100644
--- a/lib/packaging/tags.py
+++ b/lib/packaging/tags.py
@@ -2,6 +2,8 @@
 # 2.0, and the BSD License. See the LICENSE file in the root of this repository
 # for complete details.
 
+from __future__ import annotations
+
 import logging
 import platform
 import re
@@ -11,15 +13,10 @@ import sys
 import sysconfig
 from importlib.machinery import EXTENSION_SUFFIXES
 from typing import (
-    Dict,
-    FrozenSet,
     Iterable,
     Iterator,
-    List,
-    Optional,
     Sequence,
     Tuple,
-    Union,
     cast,
 )
 
@@ -30,7 +27,7 @@ logger = logging.getLogger(__name__)
 PythonVersion = Sequence[int]
 MacVersion = Tuple[int, int]
 
-INTERPRETER_SHORT_NAMES: Dict[str, str] = {
+INTERPRETER_SHORT_NAMES: dict[str, str] = {
     "python": "py",  # Generic.
     "cpython": "cp",
     "pypy": "pp",
@@ -96,7 +93,7 @@ class Tag:
         return f"<{self} @ {id(self)}>"
 
 
-def parse_tag(tag: str) -> FrozenSet[Tag]:
+def parse_tag(tag: str) -> frozenset[Tag]:
     """
     Parses the provided tag (e.g. `py3-none-any`) into a frozenset of Tag instances.
 
@@ -112,8 +109,8 @@ def parse_tag(tag: str) -> FrozenSet[Tag]:
     return frozenset(tags)
 
 
-def _get_config_var(name: str, warn: bool = False) -> Union[int, str, None]:
-    value: Union[int, str, None] = sysconfig.get_config_var(name)
+def _get_config_var(name: str, warn: bool = False) -> int | str | None:
+    value: int | str | None = sysconfig.get_config_var(name)
     if value is None and warn:
         logger.debug(
             "Config variable '%s' is unset, Python ABI tag may be incorrect", name
@@ -125,7 +122,7 @@ def _normalize_string(string: str) -> str:
     return string.replace(".", "_").replace("-", "_").replace(" ", "_")
 
 
-def _is_threaded_cpython(abis: List[str]) -> bool:
+def _is_threaded_cpython(abis: list[str]) -> bool:
     """
     Determine if the ABI corresponds to a threaded (`--disable-gil`) build.
 
@@ -151,7 +148,7 @@ def _abi3_applies(python_version: PythonVersion, threading: bool) -> bool:
     return len(python_version) > 1 and tuple(python_version) >= (3, 2) and not threading
 
 
-def _cpython_abis(py_version: PythonVersion, warn: bool = False) -> List[str]:
+def _cpython_abis(py_version: PythonVersion, warn: bool = False) -> list[str]:
     py_version = tuple(py_version)  # To allow for version comparison.
     abis = []
     version = _version_nodot(py_version[:2])
@@ -185,9 +182,9 @@ def _cpython_abis(py_version: PythonVersion, warn: bool = False) -> List[str]:
 
 
 def cpython_tags(
-    python_version: Optional[PythonVersion] = None,
-    abis: Optional[Iterable[str]] = None,
-    platforms: Optional[Iterable[str]] = None,
+    python_version: PythonVersion | None = None,
+    abis: Iterable[str] | None = None,
+    platforms: Iterable[str] | None = None,
     *,
     warn: bool = False,
 ) -> Iterator[Tag]:
@@ -244,7 +241,7 @@ def cpython_tags(
                 yield Tag(interpreter, "abi3", platform_)
 
 
-def _generic_abi() -> List[str]:
+def _generic_abi() -> list[str]:
     """
     Return the ABI tag based on EXT_SUFFIX.
     """
@@ -286,9 +283,9 @@ def _generic_abi() -> List[str]:
 
 
 def generic_tags(
-    interpreter: Optional[str] = None,
-    abis: Optional[Iterable[str]] = None,
-    platforms: Optional[Iterable[str]] = None,
+    interpreter: str | None = None,
+    abis: Iterable[str] | None = None,
+    platforms: Iterable[str] | None = None,
     *,
     warn: bool = False,
 ) -> Iterator[Tag]:
@@ -332,9 +329,9 @@ def _py_interpreter_range(py_version: PythonVersion) -> Iterator[str]:
 
 
 def compatible_tags(
-    python_version: Optional[PythonVersion] = None,
-    interpreter: Optional[str] = None,
-    platforms: Optional[Iterable[str]] = None,
+    python_version: PythonVersion | None = None,
+    interpreter: str | None = None,
+    platforms: Iterable[str] | None = None,
 ) -> Iterator[Tag]:
     """
     Yields the sequence of tags that are compatible with a specific version of Python.
@@ -366,7 +363,7 @@ def _mac_arch(arch: str, is_32bit: bool = _32_BIT_INTERPRETER) -> str:
     return "i386"
 
 
-def _mac_binary_formats(version: MacVersion, cpu_arch: str) -> List[str]:
+def _mac_binary_formats(version: MacVersion, cpu_arch: str) -> list[str]:
     formats = [cpu_arch]
     if cpu_arch == "x86_64":
         if version < (10, 4):
@@ -399,7 +396,7 @@ def _mac_binary_formats(version: MacVersion, cpu_arch: str) -> List[str]:
 
 
 def mac_platforms(
-    version: Optional[MacVersion] = None, arch: Optional[str] = None
+    version: MacVersion | None = None, arch: str | None = None
 ) -> Iterator[str]:
     """
     Yields the platform tags for a macOS system.
diff --git a/lib/packaging/utils.py b/lib/packaging/utils.py
index c2c2f75a..d33da5bb 100644
--- a/lib/packaging/utils.py
+++ b/lib/packaging/utils.py
@@ -2,8 +2,10 @@
 # 2.0, and the BSD License. See the LICENSE file in the root of this repository
 # for complete details.
 
+from __future__ import annotations
+
 import re
-from typing import FrozenSet, NewType, Tuple, Union, cast
+from typing import NewType, Tuple, Union, cast
 
 from .tags import Tag, parse_tag
 from .version import InvalidVersion, Version
@@ -53,7 +55,7 @@ def is_normalized_name(name: str) -> bool:
 
 
 def canonicalize_version(
-    version: Union[Version, str], *, strip_trailing_zero: bool = True
+    version: Version | str, *, strip_trailing_zero: bool = True
 ) -> str:
     """
     This is very similar to Version.__str__, but has one subtle difference
@@ -102,7 +104,7 @@ def canonicalize_version(
 
 def parse_wheel_filename(
     filename: str,
-) -> Tuple[NormalizedName, Version, BuildTag, FrozenSet[Tag]]:
+) -> tuple[NormalizedName, Version, BuildTag, frozenset[Tag]]:
     if not filename.endswith(".whl"):
         raise InvalidWheelFilename(
             f"Invalid wheel filename (extension must be '.whl'): {filename}"
@@ -143,7 +145,7 @@ def parse_wheel_filename(
     return (name, version, build, tags)
 
 
-def parse_sdist_filename(filename: str) -> Tuple[NormalizedName, Version]:
+def parse_sdist_filename(filename: str) -> tuple[NormalizedName, Version]:
     if filename.endswith(".tar.gz"):
         file_stem = filename[: -len(".tar.gz")]
     elif filename.endswith(".zip"):
diff --git a/lib/packaging/version.py b/lib/packaging/version.py
index 5faab9bd..46bc2613 100644
--- a/lib/packaging/version.py
+++ b/lib/packaging/version.py
@@ -7,9 +7,11 @@
     from packaging.version import parse, Version
 """
 
+from __future__ import annotations
+
 import itertools
 import re
-from typing import Any, Callable, NamedTuple, Optional, SupportsInt, Tuple, Union
+from typing import Any, Callable, NamedTuple, SupportsInt, Tuple, Union
 
 from ._structures import Infinity, InfinityType, NegativeInfinity, NegativeInfinityType
 
@@ -35,14 +37,14 @@ VersionComparisonMethod = Callable[[CmpKey, CmpKey], bool]
 
 class _Version(NamedTuple):
     epoch: int
-    release: Tuple[int, ...]
-    dev: Optional[Tuple[str, int]]
-    pre: Optional[Tuple[str, int]]
-    post: Optional[Tuple[str, int]]
-    local: Optional[LocalType]
+    release: tuple[int, ...]
+    dev: tuple[str, int] | None
+    pre: tuple[str, int] | None
+    post: tuple[str, int] | None
+    local: LocalType | None
 
 
-def parse(version: str) -> "Version":
+def parse(version: str) -> Version:
     """Parse the given version string.
 
     >>> parse('1.0.dev1')
@@ -65,7 +67,7 @@ class InvalidVersion(ValueError):
 
 
 class _BaseVersion:
-    _key: Tuple[Any, ...]
+    _key: tuple[Any, ...]
 
     def __hash__(self) -> int:
         return hash(self._key)
@@ -73,13 +75,13 @@ class _BaseVersion:
     # Please keep the duplicated `isinstance` check
     # in the six comparisons hereunder
     # unless you find a way to avoid adding overhead function calls.
-    def __lt__(self, other: "_BaseVersion") -> bool:
+    def __lt__(self, other: _BaseVersion) -> bool:
         if not isinstance(other, _BaseVersion):
             return NotImplemented
 
         return self._key < other._key
 
-    def __le__(self, other: "_BaseVersion") -> bool:
+    def __le__(self, other: _BaseVersion) -> bool:
         if not isinstance(other, _BaseVersion):
             return NotImplemented
 
@@ -91,13 +93,13 @@ class _BaseVersion:
 
         return self._key == other._key
 
-    def __ge__(self, other: "_BaseVersion") -> bool:
+    def __ge__(self, other: _BaseVersion) -> bool:
         if not isinstance(other, _BaseVersion):
             return NotImplemented
 
         return self._key >= other._key
 
-    def __gt__(self, other: "_BaseVersion") -> bool:
+    def __gt__(self, other: _BaseVersion) -> bool:
         if not isinstance(other, _BaseVersion):
             return NotImplemented
 
@@ -274,7 +276,7 @@ class Version(_BaseVersion):
         return self._version.epoch
 
     @property
-    def release(self) -> Tuple[int, ...]:
+    def release(self) -> tuple[int, ...]:
         """The components of the "release" segment of the version.
 
         >>> Version("1.2.3").release
@@ -290,7 +292,7 @@ class Version(_BaseVersion):
         return self._version.release
 
     @property
-    def pre(self) -> Optional[Tuple[str, int]]:
+    def pre(self) -> tuple[str, int] | None:
         """The pre-release segment of the version.
 
         >>> print(Version("1.2.3").pre)
@@ -305,7 +307,7 @@ class Version(_BaseVersion):
         return self._version.pre
 
     @property
-    def post(self) -> Optional[int]:
+    def post(self) -> int | None:
         """The post-release number of the version.
 
         >>> print(Version("1.2.3").post)
@@ -316,7 +318,7 @@ class Version(_BaseVersion):
         return self._version.post[1] if self._version.post else None
 
     @property
-    def dev(self) -> Optional[int]:
+    def dev(self) -> int | None:
         """The development number of the version.
 
         >>> print(Version("1.2.3").dev)
@@ -327,7 +329,7 @@ class Version(_BaseVersion):
         return self._version.dev[1] if self._version.dev else None
 
     @property
-    def local(self) -> Optional[str]:
+    def local(self) -> str | None:
         """The local version segment of the version.
 
         >>> print(Version("1.2.3").local)
@@ -450,9 +452,8 @@ class Version(_BaseVersion):
 
 
 def _parse_letter_version(
-    letter: Optional[str], number: Union[str, bytes, SupportsInt, None]
-) -> Optional[Tuple[str, int]]:
-
+    letter: str | None, number: str | bytes | SupportsInt | None
+) -> tuple[str, int] | None:
     if letter:
         # We consider there to be an implicit 0 in a pre-release if there is
         # not a numeral associated with it.
@@ -488,7 +489,7 @@ def _parse_letter_version(
 _local_version_separators = re.compile(r"[\._-]")
 
 
-def _parse_local_version(local: Optional[str]) -> Optional[LocalType]:
+def _parse_local_version(local: str | None) -> LocalType | None:
     """
     Takes a string like abc.1.twelve and turns it into ("abc", 1, "twelve").
     """
@@ -502,13 +503,12 @@ def _parse_local_version(local: Optional[str]) -> Optional[LocalType]:
 
 def _cmpkey(
     epoch: int,
-    release: Tuple[int, ...],
-    pre: Optional[Tuple[str, int]],
-    post: Optional[Tuple[str, int]],
-    dev: Optional[Tuple[str, int]],
-    local: Optional[LocalType],
+    release: tuple[int, ...],
+    pre: tuple[str, int] | None,
+    post: tuple[str, int] | None,
+    dev: tuple[str, int] | None,
+    local: LocalType | None,
 ) -> CmpKey:
-
     # When we compare a release version, we want to compare it with all of the
     # trailing zeros removed. So we'll use a reverse the list, drop all the now
     # leading zeros until we come to something non zero, then take the rest
diff --git a/requirements.txt b/requirements.txt
index f095fe03..2cdc0e3c 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -23,7 +23,7 @@ IPy==1.01
 Mako==1.3.5
 MarkupSafe==2.1.5
 musicbrainzngs==0.7.1
-packaging==24.0
+packaging==24.1
 paho-mqtt==2.1.0
 platformdirs==4.2.2
 plexapi==4.15.13

From 709db66b100e379d2e213d955ea0c6a555546022 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 19 Jun 2024 00:06:02 -0700
Subject: [PATCH 626/743] Bump pyinstaller from 6.6.0 to 6.8.0 (#2346)

Bumps [pyinstaller](https://github.com/pyinstaller/pyinstaller) from 6.6.0 to 6.8.0.
- [Release notes](https://github.com/pyinstaller/pyinstaller/releases)
- [Changelog](https://github.com/pyinstaller/pyinstaller/blob/develop/doc/CHANGES.rst)
- [Commits](https://github.com/pyinstaller/pyinstaller/compare/v6.6.0...v6.8.0)

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

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 package/requirements-package.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index a34a987e..85f0e61b 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -1,7 +1,7 @@
 apscheduler==3.10.1
 importlib-metadata==7.1.0
 importlib-resources==6.4.0
-pyinstaller==6.6.0
+pyinstaller==6.8.0
 pyopenssl==24.1.0
 pycryptodomex==3.20.0
 

From 6f84ce8048579661ca9347871ad77162bde8e4a3 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 19 Jun 2024 00:06:18 -0700
Subject: [PATCH 627/743] Bump docker/build-push-action from 5 to 6 (#2354)

Bumps [docker/build-push-action](https://github.com/docker/build-push-action) from 5 to 6.
- [Release notes](https://github.com/docker/build-push-action/releases)
- [Commits](https://github.com/docker/build-push-action/compare/v5...v6)

---
updated-dependencies:
- dependency-name: docker/build-push-action
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 .github/workflows/publish-docker.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/publish-docker.yml b/.github/workflows/publish-docker.yml
index 1185e5eb..41ccb093 100644
--- a/.github/workflows/publish-docker.yml
+++ b/.github/workflows/publish-docker.yml
@@ -70,7 +70,7 @@ jobs:
           password: ${{ secrets.GHCR_TOKEN }}
 
       - name: Docker Build and Push
-        uses: docker/build-push-action@v5
+        uses: docker/build-push-action@v6
         if: success()
         with:
           context: .

From 7d00383d1ca10d4af058e4308951ab80d537b757 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Wed, 19 Jun 2024 19:14:20 -0700
Subject: [PATCH 628/743] v2.14.3

---
 CHANGELOG.md      | 12 ++++++++++++
 plexpy/version.py |  2 +-
 2 files changed, 13 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index e876fbb6..22e42d9b 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,17 @@
 # Changelog
 
+## v2.14.3 (2024-06-19)
+
+* Graphs:
+  * Fix: History table not loading when clicking on the graphs in some instances.
+* UI:
+  * Fix: Scheduled tasks table not loading when certain tasks are disabled.
+  * Removed: Unnecessary Remote Server checkbox from the settings page.
+* Other:
+  * Fix: Webserver not restarting after the setup wizard.
+  * Fix: Workaround webserver crashing in some instances.
+
+
 ## v2.14.2 (2024-05-18)
 
 * History:
diff --git a/plexpy/version.py b/plexpy/version.py
index 698d7d45..94da76a1 100644
--- a/plexpy/version.py
+++ b/plexpy/version.py
@@ -16,4 +16,4 @@
 #  along with Tautulli.  If not, see <http://www.gnu.org/licenses/>.
 
 PLEXPY_BRANCH = "master"
-PLEXPY_RELEASE_VERSION = "v2.14.2"
\ No newline at end of file
+PLEXPY_RELEASE_VERSION = "v2.14.3"
\ No newline at end of file

From 193b82c54a2796d398971248615798f2e5f8f5db Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 30 Jun 2024 14:15:11 -0700
Subject: [PATCH 629/743] Update Slack notification attachment

---
 plexpy/notifiers.py | 92 ++++++++++++++++++++++++++++++++-------------
 1 file changed, 66 insertions(+), 26 deletions(-)

diff --git a/plexpy/notifiers.py b/plexpy/notifiers.py
index 5305ffa2..8d2906d1 100644
--- a/plexpy/notifiers.py
+++ b/plexpy/notifiers.py
@@ -3601,7 +3601,7 @@ class SLACK(Notifier):
 
     def agent_notify(self, subject='', body='', action='', **kwargs):
         if self.config['incl_subject']:
-            text = subject + '\r\n' + body
+            text = subject + '\n' + body
         else:
             text = body
 
@@ -3636,35 +3636,75 @@ class SLACK(Notifier):
             description = pretty_metadata.get_description()
             plex_url = pretty_metadata.get_plex_url()
 
-            # Build Slack post attachment
-            attachment = {'fallback': 'Image for %s' % title,
-                          'title': title
-                          }
+            if provider_link:
+                text = f"*<{provider_link}|{title}>*"
+            else:
+                text = f"*{title}*"
+
+            if self.config['incl_description']:
+                text = f'{text}\n{description}'
+
+            # Max length of text is 3000 characters
+            text = (text[:2997] + (text[2997:] and '...'))
+
+            section = {
+                'type': 'section',
+                'text': {
+                   'type': 'mrkdwn',
+                    'text': text,
+                }
+            }
+            if self.config['incl_thumbnail']:
+                section['accessory'] = {
+                    'type': 'image',
+                    'image_url': poster_url,
+                    'alt_text': title,
+                }
+            blocks = [section]
+
+            fields = []
+            field_title = {
+                'type': 'mrkdwn',
+                'text': 'View Details',
+            }
+            if provider_link:
+                fields.append(field_title)
+                fields.append({
+                    'type': 'mrkdwn',
+                    'text': f'<{provider_link}|{provider_name}>',
+                })
+            if self.config['incl_pmslink']:
+                fields.append(field_title)
+                fields.append({
+                    'type': 'mrkdwn',
+                    'text': f'<{plex_url}|Plex Web>',
+                })
+            if fields:
+                if len(fields) <= 2:
+                    fields.append({
+                        'type': 'plain_text',
+                        'text': ' ',
+                    })
+                blocks.append({
+                    'type': 'section',
+                    'fields': fields[::2] + fields[1::2],
+                })
+
+            if not self.config['incl_thumbnail']:
+                blocks.append({
+                    'type': 'image',
+                    'image_url': poster_url,
+                    'alt_text': title,
+                })
+
+            attachment = {
+                'blocks': blocks,
+
+            }
 
             if self.config['color'] and re.match(r'^#(?:[0-9a-fA-F]{3}){1,2}$', self.config['color']):
                 attachment['color'] = self.config['color']
 
-            if self.config['incl_thumbnail']:
-                attachment['thumb_url'] = poster_url
-            else:
-                attachment['image_url'] = poster_url
-
-            if self.config['incl_description']:
-                attachment['text'] = description
-
-            fields = []
-            if provider_link:
-                attachment['title_link'] = provider_link
-                fields.append({'title': 'View Details',
-                               'value': '<%s|%s>' % (provider_link, provider_name),
-                               'short': True})
-            if self.config['incl_pmslink']:
-                fields.append({'title': 'View Details',
-                               'value': '<%s|%s>' % (plex_url, 'Plex Web'),
-                               'short': True})
-            if fields:
-                attachment['fields'] = fields
-
             data['attachments'] = [attachment]
 
         headers = {'Content-type': 'application/json'}

From 2ee2ab652cd57d8ef1e0f0d8d11e115becec6fa6 Mon Sep 17 00:00:00 2001
From: Nate Harris <nwithan8@users.noreply.github.com>
Date: Sat, 6 Jul 2024 13:02:36 -0400
Subject: [PATCH 630/743] [FEAT] Add ntfy as a notifier (#2356)

* - Add ntfy as a notifier

* - Fix media poster attachment in ntfy
---
 plexpy/notifiers.py | 190 +++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 189 insertions(+), 1 deletion(-)

diff --git a/plexpy/notifiers.py b/plexpy/notifiers.py
index 8d2906d1..dbd0cccf 100644
--- a/plexpy/notifiers.py
+++ b/plexpy/notifiers.py
@@ -96,7 +96,8 @@ AGENT_IDS = {'growl': 0,
              'plexmobileapp': 26,
              'lunasea': 27,
              'microsoftteams': 28,
-             'gotify': 29
+             'gotify': 29,
+             'ntfy': 30
              }
 
 DEFAULT_CUSTOM_CONDITIONS = [{'parameter': '', 'operator': '', 'value': [], 'type': None}]
@@ -198,6 +199,12 @@ def available_notification_agents():
                'class': MQTT,
                'action_types': ('all',)
                },
+              {'label': 'ntfy',
+               'name': 'ntfy',
+               'id': AGENT_IDS['ntfy'],
+               'class': NTFY,
+               'action_types': ('all',)
+               },
               {'label': 'Plex Home Theater',
                'name': 'plex',
                'id': AGENT_IDS['plex'],
@@ -2592,6 +2599,187 @@ class MQTT(Notifier):
         return config_option
 
 
+class NTFY(Notifier):
+    """
+    ntfy notifications
+    """
+    NAME = 'ntfy'
+    _DEFAULT_CONFIG = {'host': '',
+                       'access_token': '',
+                       'topic': '',
+                       'priority': 'default',
+                       'incl_subject': 1,
+                       'incl_description': 1,
+                       'incl_poster': 0,
+                       'incl_url': 0,
+                       'incl_pmslink': 0,
+                       'movie_provider': '',
+                       'tv_provider': '',
+                       'music_provider': ''
+                       }
+
+    def agent_notify(self, subject='', body='', action='', **kwargs):
+        method = "POST"
+        url = f"{self.config['host']}/{self.config['topic']}"
+        params = {}
+        data = body
+        headers = {
+            'Priority': self.config['priority'],
+            'Authorization': f'Bearer {self.config["access_token"]}',
+            'Icon': 'https://tautulli.com/images/favicon.ico'
+        }
+
+        # Add optional subject
+        if self.config['incl_subject']:
+            headers['Title'] = subject
+
+        # Add optional parameters (dependent on notification type + metadata extraction)
+        if kwargs.get('parameters', {}).get('media_type'):
+            # Grab formatted metadata
+            pretty_metadata = PrettyMetadata(kwargs['parameters'])
+
+            # Add optional description
+            if self.config['incl_description']:
+                description = pretty_metadata.get_description()
+                if description:
+                    data = f"{data}\n\n{description}"
+
+            # Add optional poster
+            if self.config['incl_poster']:
+                method = "PUT"  # Need to use PUT instead of POST to send attachments
+                image_file_name, image_content, image_file_type = pretty_metadata.get_image()
+
+                if image_file_name and image_content:
+                    # Image data will take up "data", message content needs to shift to the "message" query parameter
+                    params['message'] = data
+                    data = image_content
+                    headers['Filename'] = image_file_name
+                else:
+                    # Fallback to default Tautulli media type poster
+                    # Can keep message content in "data" payload and just add a header for the attachment
+                    poster_url = pretty_metadata.get_poster_url()
+                    headers['Attach'] = poster_url
+
+            # Add optional links (actions)
+            actions = []
+
+            if self.config['incl_url']:
+                if pretty_metadata.media_type == 'movie':
+                    provider = self.config['movie_provider']
+                elif pretty_metadata.media_type in ('show', 'season', 'episode'):
+                    provider = self.config['tv_provider']
+                elif pretty_metadata.media_type in ('artist', 'album', 'track'):
+                    provider = self.config['music_provider']
+                else:
+                    provider = None
+
+                provider_name = pretty_metadata.get_provider_name(provider)
+                provider_link = pretty_metadata.get_provider_link(provider)
+                actions.append(f"view, View on {provider_name}, {provider_link}, clear=true")
+
+            if self.config['incl_pmslink']:
+                plex_url = pretty_metadata.get_plex_url()
+                actions.append(f"view, View on Plex, {plex_url}, clear=true")
+
+            if actions:
+                headers['Actions'] = ';'.join(actions)
+
+        return self.make_request(url=url, method=method, headers=headers, params=params, data=data)
+
+    def _return_config_options(self):
+        config_option = [{'label': 'ntfy Host Address',
+                          'value': self.config['host'],
+                          'name': 'ntfy_host',
+                          'description': 'Host running ntfy (e.g. http://localhost:80).',
+                          'input_type': 'text'
+                          },
+                         {'label': 'ntfy Access Token',
+                          'value': self.config['access_token'],
+                          'name': 'ntfy_access_token',
+                          'description': 'Your ntfy access token.',
+                          'input_type': 'token'
+                          },
+                         {'label': 'ntfy Topic',
+                          'value': self.config['topic'],
+                          'name': 'ntfy_topic',
+                          'description': 'The topic to publish notifications to.',
+                          'input_type': 'text'
+                          },
+                         {'label': 'Priority',
+                          'value': self.config['priority'],
+                          'name': 'ntfy_priority',
+                          'description': 'Set the notification priority.',
+                          'input_type': 'select',
+                          'select_options': {
+                              'min': 1,
+                              'low': 2,
+                              'default': 3,
+                              'high': 4,
+                              'max': 5
+                          }
+                          },
+                         {'label': 'Include Subject Line',
+                          'value': self.config['incl_subject'],
+                          'name': 'ntfy_incl_subject',
+                          'description': 'Include a subject line in the notification.',
+                          'input_type': 'checkbox'
+                          },
+                         {'label': 'Include Poster Image',
+                          'value': self.config['incl_poster'],
+                          'name': 'ntfy_incl_poster',
+                          'description': 'Include a poster of the media item in the notification.',
+                          'input_type': 'checkbox'
+                          },
+                         {'label': 'Include Summary',
+                          'value': self.config['incl_description'],
+                          'name': 'ntfy_incl_description',
+                          'description': 'Include a summary of the media item in the notification.',
+                          'input_type': 'checkbox'
+                          },
+                         {'label': 'Include Link to Metadata Provider',
+                          'value': self.config['incl_url'],
+                          'name': 'ntfy_incl_url',
+                          'description': 'Include a link to the media item on the metadata provider in the notification.',
+                          'input_type': 'checkbox'
+                          },
+                         {'label': 'Include Link to Plex Web',
+                          'value': self.config['incl_pmslink'],
+                          'name': 'ntfy_incl_pmslink',
+                          'description': 'Include a link to the media item in Plex Web in the notification.',
+                          'input_type': 'checkbox'
+                          },
+                         {'label': 'Movie Link Source',
+                          'value': self.config['movie_provider'],
+                          'name': 'ntfy_movie_provider',
+                          'description': 'Select the source for movie links in the notification. Leave blank to disable.<br>'
+                                         'Note: <a data-tab-destination="3rd_party_apis" data-dismiss="modal" >Metadata Lookups</a> '
+                                         'may need to be enabled under the 3rd Party APIs settings tab.',
+                          'input_type': 'select',
+                          'select_options': PrettyMetadata().get_movie_providers()
+                          },
+                         {'label': 'TV Show Link Source',
+                          'value': self.config['tv_provider'],
+                          'name': 'ntfy_tv_provider',
+                          'description': 'Select the source for TV show links in the notification. Leave blank to disable.<br>'
+                                         'Note: <a data-tab-destination="3rd_party_apis" data-dismiss="modal" >Metadata Lookups</a> '
+                                         'may need to be enabled under the 3rd Party APIs settings tab.',
+                          'input_type': 'select',
+                          'select_options': PrettyMetadata().get_tv_providers()
+                          },
+                         {'label': 'Music Link Source',
+                          'value': self.config['music_provider'],
+                          'name': 'ntfy_music_provider',
+                          'description': 'Select the source for music links in the notification. Leave blank to disable.<br>'
+                                         'Note: <a data-tab-destination="3rd_party_apis" data-dismiss="modal" >Metadata Lookups</a> '
+                                         'may need to be enabled under the 3rd Party APIs settings tab.',
+                          'input_type': 'select',
+                          'select_options': PrettyMetadata().get_music_providers()
+                          }
+                         ]
+
+        return config_option
+
+
 class OSX(Notifier):
     """
     macOS notifications

From 96c5cb216cd381070552eaf08526d22a745e78e1 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 6 Jul 2024 11:02:21 -0700
Subject: [PATCH 631/743] Update plexapi==4.15.15

---
 lib/plexapi/base.py   | 2 ++
 lib/plexapi/const.py  | 2 +-
 lib/plexapi/media.py  | 1 +
 lib/plexapi/myplex.py | 6 +++++-
 lib/plexapi/server.py | 7 ++++---
 5 files changed, 13 insertions(+), 5 deletions(-)

diff --git a/lib/plexapi/base.py b/lib/plexapi/base.py
index 9c735373..26b103b9 100644
--- a/lib/plexapi/base.py
+++ b/lib/plexapi/base.py
@@ -866,6 +866,8 @@ class Playable:
 
             if kwargs:
                 # So this seems to be a a lot slower but allows transcode.
+                kwargs['mediaIndex'] = self.media.index(part._parent())
+                kwargs['partIndex'] = part._parent().parts.index(part)
                 download_url = self.getStreamURL(**kwargs)
             else:
                 download_url = self._server.url(f'{part.key}?download=1')
diff --git a/lib/plexapi/const.py b/lib/plexapi/const.py
index 7568344e..b0fe7e7d 100644
--- a/lib/plexapi/const.py
+++ b/lib/plexapi/const.py
@@ -4,6 +4,6 @@
 # Library version
 MAJOR_VERSION = 4
 MINOR_VERSION = 15
-PATCH_VERSION = 13
+PATCH_VERSION = 15
 __short_version__ = f"{MAJOR_VERSION}.{MINOR_VERSION}"
 __version__ = f"{__short_version__}.{PATCH_VERSION}"
diff --git a/lib/plexapi/media.py b/lib/plexapi/media.py
index 43c5636d..56126dcb 100644
--- a/lib/plexapi/media.py
+++ b/lib/plexapi/media.py
@@ -478,6 +478,7 @@ class SubtitleStream(MediaPartStream):
         return self.setSelected()
 
 
+@utils.registerPlexObject
 class LyricStream(MediaPartStream):
     """ Represents a lyric stream within a :class:`~plexapi.media.MediaPart`.
 
diff --git a/lib/plexapi/myplex.py b/lib/plexapi/myplex.py
index 740b2398..bc40583e 100644
--- a/lib/plexapi/myplex.py
+++ b/lib/plexapi/myplex.py
@@ -1049,7 +1049,7 @@ class MyPlexAccount(PlexObject):
         self.query(key, params=params)
         return self
 
-    def searchDiscover(self, query, limit=30, libtype=None):
+    def searchDiscover(self, query, limit=30, libtype=None, providers='discover'):
         """ Search for movies and TV shows in Discover.
             Returns a list of :class:`~plexapi.video.Movie` and :class:`~plexapi.video.Show` objects.
 
@@ -1057,6 +1057,9 @@ class MyPlexAccount(PlexObject):
                 query (str): Search query.
                 limit (int, optional): Limit to the specified number of results. Default 30.
                 libtype (str, optional): 'movie' or 'show' to only return movies or shows, otherwise return all items.
+                providers (str, optional): 'discover' for default behavior
+                    or 'discover,PLEXAVOD' to also include the Plex ad-suported video service
+                    or 'discover,PLEXAVOD,PLEXTVOD' to also include the Plex video rental service
         """
         libtypes = {'movie': 'movies', 'show': 'tv'}
         libtype = libtypes.get(libtype, 'movies,tv')
@@ -1068,6 +1071,7 @@ class MyPlexAccount(PlexObject):
             'query': query,
             'limit': limit,
             'searchTypes': libtype,
+            'searchProviders': providers,
             'includeMetadata': 1
         }
 
diff --git a/lib/plexapi/server.py b/lib/plexapi/server.py
index 178ce82b..f39a423f 100644
--- a/lib/plexapi/server.py
+++ b/lib/plexapi/server.py
@@ -413,16 +413,17 @@ class PlexServer(PlexObject):
         return items
 
     def client(self, name):
-        """ Returns the :class:`~plexapi.client.PlexClient` that matches the specified name.
+        """ Returns the :class:`~plexapi.client.PlexClient` that matches the specified name
+            or machine identifier.
 
             Parameters:
-                name (str): Name of the client to return.
+                name (str): Name or machine identifier of the client to return.
 
             Raises:
                 :exc:`~plexapi.exceptions.NotFound`: Unknown client name.
         """
         for client in self.clients():
-            if client and client.title == name:
+            if client and (client.title == name or client.machineIdentifier == name):
                 return client
 
         raise NotFound(f'Unknown client name: {name}')

From e934d09eff500a589194e3241ef0df7e9c92e490 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 6 Jul 2024 11:03:05 -0700
Subject: [PATCH 632/743] Update plexapi==4.15.15 requirements.txt

---
 requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements.txt b/requirements.txt
index 2cdc0e3c..c42251a4 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -26,7 +26,7 @@ musicbrainzngs==0.7.1
 packaging==24.1
 paho-mqtt==2.1.0
 platformdirs==4.2.2
-plexapi==4.15.13
+plexapi==4.15.15
 portend==3.2.0
 profilehooks==1.12.0
 PyJWT==2.8.0

From 50ced86ba52c06ba8f1be0e0693e6f87a8f6dc9f Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 6 Jul 2024 11:04:54 -0700
Subject: [PATCH 633/743] Bump importlib-metadata from 7.1.0 to 8.0.0 (#2360)

* Bump importlib-metadata from 7.1.0 to 8.0.0

Bumps [importlib-metadata](https://github.com/python/importlib_metadata) from 7.1.0 to 8.0.0.
- [Release notes](https://github.com/python/importlib_metadata/releases)
- [Changelog](https://github.com/python/importlib_metadata/blob/main/NEWS.rst)
- [Commits](https://github.com/python/importlib_metadata/compare/v7.1.0...v8.0.0)

---
updated-dependencies:
- dependency-name: importlib-metadata
  dependency-type: direct:production
  update-type: version-update:semver-major
...

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

* Update importlib-metadata==8.0.0

---------

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
---
 lib/importlib_metadata/__init__.py     | 35 ++++++--------------------
 lib/importlib_metadata/_adapters.py    | 23 ++++++-----------
 lib/importlib_metadata/compat/py311.py | 22 ++++++++++++++++
 package/requirements-package.txt       |  2 +-
 requirements.txt                       |  2 +-
 5 files changed, 40 insertions(+), 44 deletions(-)
 create mode 100644 lib/importlib_metadata/compat/py311.py

diff --git a/lib/importlib_metadata/__init__.py b/lib/importlib_metadata/__init__.py
index 32ee3b4d..ed481355 100644
--- a/lib/importlib_metadata/__init__.py
+++ b/lib/importlib_metadata/__init__.py
@@ -12,14 +12,13 @@ import inspect
 import pathlib
 import operator
 import textwrap
-import warnings
 import functools
 import itertools
 import posixpath
 import collections
 
-from . import _adapters, _meta
-from .compat import py39
+from . import _meta
+from .compat import py39, py311
 from ._collections import FreezableDefaultDict, Pair
 from ._compat import (
     NullFinder,
@@ -334,27 +333,7 @@ class FileHash:
         return f'<FileHash mode: {self.mode} value: {self.value}>'
 
 
-class DeprecatedNonAbstract:
-    # Required until Python 3.14
-    def __new__(cls, *args, **kwargs):
-        all_names = {
-            name for subclass in inspect.getmro(cls) for name in vars(subclass)
-        }
-        abstract = {
-            name
-            for name in all_names
-            if getattr(getattr(cls, name), '__isabstractmethod__', False)
-        }
-        if abstract:
-            warnings.warn(
-                f"Unimplemented abstract methods {abstract}",
-                DeprecationWarning,
-                stacklevel=2,
-            )
-        return super().__new__(cls)
-
-
-class Distribution(DeprecatedNonAbstract):
+class Distribution(metaclass=abc.ABCMeta):
     """
     An abstract Python distribution package.
 
@@ -461,6 +440,9 @@ class Distribution(DeprecatedNonAbstract):
         Custom providers may provide the METADATA file or override this
         property.
         """
+        # deferred for performance (python/cpython#109829)
+        from . import _adapters
+
         opt_text = (
             self.read_text('METADATA')
             or self.read_text('PKG-INFO')
@@ -567,9 +549,8 @@ class Distribution(DeprecatedNonAbstract):
             return
 
         paths = (
-            (subdir / name)
-            .resolve()
-            .relative_to(self.locate_file('').resolve())
+            py311.relative_fix((subdir / name).resolve())
+            .relative_to(self.locate_file('').resolve(), walk_up=True)
             .as_posix()
             for name in text.splitlines()
         )
diff --git a/lib/importlib_metadata/_adapters.py b/lib/importlib_metadata/_adapters.py
index 120e43a0..6223263e 100644
--- a/lib/importlib_metadata/_adapters.py
+++ b/lib/importlib_metadata/_adapters.py
@@ -1,20 +1,8 @@
-import functools
-import warnings
 import re
 import textwrap
 import email.message
 
 from ._text import FoldedCase
-from ._compat import pypy_partial
-
-
-# Do not remove prior to 2024-01-01 or Python 3.14
-_warn = functools.partial(
-    warnings.warn,
-    "Implicit None on return values is deprecated and will raise KeyErrors.",
-    DeprecationWarning,
-    stacklevel=pypy_partial(2),
-)
 
 
 class Message(email.message.Message):
@@ -53,12 +41,17 @@ class Message(email.message.Message):
 
     def __getitem__(self, item):
         """
-        Warn users that a ``KeyError`` can be expected when a
-        missing key is supplied. Ref python/importlib_metadata#371.
+        Override parent behavior to typical dict behavior.
+
+        ``email.message.Message`` will emit None values for missing
+        keys. Typical mappings, including this ``Message``, will raise
+        a key error for missing keys.
+
+        Ref python/importlib_metadata#371.
         """
         res = super().__getitem__(item)
         if res is None:
-            _warn()
+            raise KeyError(item)
         return res
 
     def _repair_headers(self):
diff --git a/lib/importlib_metadata/compat/py311.py b/lib/importlib_metadata/compat/py311.py
new file mode 100644
index 00000000..3a532743
--- /dev/null
+++ b/lib/importlib_metadata/compat/py311.py
@@ -0,0 +1,22 @@
+import os
+import pathlib
+import sys
+import types
+
+
+def wrap(path):  # pragma: no cover
+    """
+    Workaround for https://github.com/python/cpython/issues/84538
+    to add backward compatibility for walk_up=True.
+    An example affected package is dask-labextension, which uses
+    jupyter-packaging to install JupyterLab javascript files outside
+    of site-packages.
+    """
+
+    def relative_to(root, *, walk_up=False):
+        return pathlib.Path(os.path.relpath(path, root))
+
+    return types.SimpleNamespace(relative_to=relative_to)
+
+
+relative_fix = wrap if sys.version_info < (3, 12) else lambda x: x
diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index 85f0e61b..2f21fea4 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -1,5 +1,5 @@
 apscheduler==3.10.1
-importlib-metadata==7.1.0
+importlib-metadata==8.0.0
 importlib-resources==6.4.0
 pyinstaller==6.8.0
 pyopenssl==24.1.0
diff --git a/requirements.txt b/requirements.txt
index c42251a4..f1593fe6 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -16,7 +16,7 @@ gntp==1.0.3
 html5lib==1.1
 httpagentparser==1.9.5
 idna==3.7
-importlib-metadata==7.1.0
+importlib-metadata==8.0.0
 importlib-resources==6.4.0
 git+https://github.com/Tautulli/ipwhois.git@master#egg=ipwhois
 IPy==1.01

From 7696d031d3ed327bde2c28bd607c2011e570ff23 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 6 Jul 2024 11:05:03 -0700
Subject: [PATCH 634/743] Bump certifi from 2024.6.2 to 2024.7.4 (#2361)

* Bump certifi from 2024.6.2 to 2024.7.4

Bumps [certifi](https://github.com/certifi/python-certifi) from 2024.6.2 to 2024.7.4.
- [Commits](https://github.com/certifi/python-certifi/compare/2024.06.02...2024.07.04)

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

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

* Update certifi==2024.7.4

---------

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
---
 lib/certifi/__init__.py |  2 +-
 lib/certifi/cacert.pem  | 40 ----------------------------------------
 requirements.txt        |  2 +-
 3 files changed, 2 insertions(+), 42 deletions(-)

diff --git a/lib/certifi/__init__.py b/lib/certifi/__init__.py
index 62b27b63..d321f1bc 100644
--- a/lib/certifi/__init__.py
+++ b/lib/certifi/__init__.py
@@ -1,4 +1,4 @@
 from .core import contents, where
 
 __all__ = ["contents", "where"]
-__version__ = "2024.06.02"
+__version__ = "2024.07.04"
diff --git a/lib/certifi/cacert.pem b/lib/certifi/cacert.pem
index 6e1f1a67..a6581589 100644
--- a/lib/certifi/cacert.pem
+++ b/lib/certifi/cacert.pem
@@ -3485,46 +3485,6 @@ DgQWBBQxCpCPtsad0kRLgLWi5h+xEk8blTAKBggqhkjOPQQDAwNoADBlAjEA31SQ
 +RHUjE7AwWHCFUyqqx0LMV87HOIAl0Qx5v5zli/altP+CAezNIm8BZ/3Hobui3A=
 -----END CERTIFICATE-----
 
-# Issuer: CN=GLOBALTRUST 2020 O=e-commerce monitoring GmbH
-# Subject: CN=GLOBALTRUST 2020 O=e-commerce monitoring GmbH
-# Label: "GLOBALTRUST 2020"
-# Serial: 109160994242082918454945253
-# MD5 Fingerprint: 8a:c7:6f:cb:6d:e3:cc:a2:f1:7c:83:fa:0e:78:d7:e8
-# SHA1 Fingerprint: d0:67:c1:13:51:01:0c:aa:d0:c7:6a:65:37:31:16:26:4f:53:71:a2
-# SHA256 Fingerprint: 9a:29:6a:51:82:d1:d4:51:a2:e3:7f:43:9b:74:da:af:a2:67:52:33:29:f9:0f:9a:0d:20:07:c3:34:e2:3c:9a
------BEGIN CERTIFICATE-----
-MIIFgjCCA2qgAwIBAgILWku9WvtPilv6ZeUwDQYJKoZIhvcNAQELBQAwTTELMAkG
-A1UEBhMCQVQxIzAhBgNVBAoTGmUtY29tbWVyY2UgbW9uaXRvcmluZyBHbWJIMRkw
-FwYDVQQDExBHTE9CQUxUUlVTVCAyMDIwMB4XDTIwMDIxMDAwMDAwMFoXDTQwMDYx
-MDAwMDAwMFowTTELMAkGA1UEBhMCQVQxIzAhBgNVBAoTGmUtY29tbWVyY2UgbW9u
-aXRvcmluZyBHbWJIMRkwFwYDVQQDExBHTE9CQUxUUlVTVCAyMDIwMIICIjANBgkq
-hkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAri5WrRsc7/aVj6B3GyvTY4+ETUWiD59b
-RatZe1E0+eyLinjF3WuvvcTfk0Uev5E4C64OFudBc/jbu9G4UeDLgztzOG53ig9Z
-YybNpyrOVPu44sB8R85gfD+yc/LAGbaKkoc1DZAoouQVBGM+uq/ufF7MpotQsjj3
-QWPKzv9pj2gOlTblzLmMCcpL3TGQlsjMH/1WljTbjhzqLL6FLmPdqqmV0/0plRPw
-yJiT2S0WR5ARg6I6IqIoV6Lr/sCMKKCmfecqQjuCgGOlYx8ZzHyyZqjC0203b+J+
-BlHZRYQfEs4kUmSFC0iAToexIiIwquuuvuAC4EDosEKAA1GqtH6qRNdDYfOiaxaJ
-SaSjpCuKAsR49GiKweR6NrFvG5Ybd0mN1MkGco/PU+PcF4UgStyYJ9ORJitHHmkH
-r96i5OTUawuzXnzUJIBHKWk7buis/UDr2O1xcSvy6Fgd60GXIsUf1DnQJ4+H4xj0
-4KlGDfV0OoIu0G4skaMxXDtG6nsEEFZegB31pWXogvziB4xiRfUg3kZwhqG8k9Me
-dKZssCz3AwyIDMvUclOGvGBG85hqwvG/Q/lwIHfKN0F5VVJjjVsSn8VoxIidrPIw
-q7ejMZdnrY8XD2zHc+0klGvIg5rQmjdJBKuxFshsSUktq6HQjJLyQUp5ISXbY9e2
-nKd+Qmn7OmMCAwEAAaNjMGEwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMC
-AQYwHQYDVR0OBBYEFNwuH9FhN3nkq9XVsxJxaD1qaJwiMB8GA1UdIwQYMBaAFNwu
-H9FhN3nkq9XVsxJxaD1qaJwiMA0GCSqGSIb3DQEBCwUAA4ICAQCR8EICaEDuw2jA
-VC/f7GLDw56KoDEoqoOOpFaWEhCGVrqXctJUMHytGdUdaG/7FELYjQ7ztdGl4wJC
-XtzoRlgHNQIw4Lx0SsFDKv/bGtCwr2zD/cuz9X9tAy5ZVp0tLTWMstZDFyySCstd
-6IwPS3BD0IL/qMy/pJTAvoe9iuOTe8aPmxadJ2W8esVCgmxcB9CpwYhgROmYhRZf
-+I/KARDOJcP5YBugxZfD0yyIMaK9MOzQ0MAS8cE54+X1+NZK3TTN+2/BT+MAi1bi
-kvcoskJ3ciNnxz8RFbLEAwW+uxF7Cr+obuf/WEPPm2eggAe2HcqtbepBEX4tdJP7
-wry+UUTF72glJ4DjyKDUEuzZpTcdN3y0kcra1LGWge9oXHYQSa9+pTeAsRxSvTOB
-TI/53WXZFM2KJVj04sWDpQmQ1GwUY7VA3+vA/MRYfg0UFodUJ25W5HCEuGwyEn6C
-MUO+1918oa2u1qsgEu8KwxCMSZY13At1XrFP1U80DhEgB3VDRemjEdqso5nCtnkn
-4rnvyOL2NSl6dPrFf4IFYqYK6miyeUcGbvJXqBUzxvd4Sj1Ce2t+/vdG6tHrju+I
-aFvowdlxfv1k7/9nR4hYJS8+hge9+6jlgqispdNpQ80xiEmEU5LAsTkbOYMBMMTy
-qfrQA71yN2BWHzZ8vTmR9W0Nv3vXkg==
------END CERTIFICATE-----
-
 # Issuer: CN=ANF Secure Server Root CA O=ANF Autoridad de Certificacion OU=ANF CA Raiz
 # Subject: CN=ANF Secure Server Root CA O=ANF Autoridad de Certificacion OU=ANF CA Raiz
 # Label: "ANF Secure Server Root CA"
diff --git a/requirements.txt b/requirements.txt
index f1593fe6..b1eb7ca1 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -3,7 +3,7 @@ arrow==1.3.0
 backports.zoneinfo==0.2.1;python_version<"3.9"
 beautifulsoup4==4.12.3
 bleach==6.1.0
-certifi==2024.6.2
+certifi==2024.7.4
 cheroot==10.0.1
 cherrypy==18.10.0
 cloudinary==1.40.0

From 822d5a452c61ac424a238ce022ad87cfbac05aa5 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 12 Jul 2024 14:29:48 -0700
Subject: [PATCH 635/743] Capitalize macOS platform

---
 plexpy/__init__.py | 12 ++++++++++++
 plexpy/common.py   |  3 ++-
 2 files changed, 14 insertions(+), 1 deletion(-)

diff --git a/plexpy/__init__.py b/plexpy/__init__.py
index 0366fcde..21b5ef6d 100644
--- a/plexpy/__init__.py
+++ b/plexpy/__init__.py
@@ -1504,6 +1504,18 @@ def dbcheck():
     except sqlite3.OperationalError:
         logger.warn("Unable to capitalize Windows platform values in session_history table.")
 
+    # Upgrade session_history table from earlier versions
+    try:
+        result = c_db.execute("SELECT platform FROM session_history "
+                              "WHERE platform = 'macos'").fetchall()
+        if len(result) > 0:
+            logger.debug("Altering database. Capitalizing macOS platform values in session_history table.")
+            c_db.execute(
+                "UPDATE session_history SET platform = 'macOS' WHERE platform = 'macos' "
+            )
+    except sqlite3.OperationalError:
+        logger.warn("Unable to capitalize macOS platform values in session_history table.")
+
     # Upgrade session_history_metadata table from earlier versions
     try:
         c_db.execute("SELECT full_title FROM session_history_metadata")
diff --git a/plexpy/common.py b/plexpy/common.py
index fb35beb3..8d68e2ad 100644
--- a/plexpy/common.py
+++ b/plexpy/common.py
@@ -102,7 +102,8 @@ PLATFORM_NAME_OVERRIDES = {
     'Mystery 5': 'Xbox 360',
     'WebMAF': 'Playstation 4',
     'windows': 'Windows',
-    'osx': 'macOS'
+    'osx': 'macOS',
+    'macos': 'macOS',
 }
 
 PMS_PLATFORM_NAME_OVERRIDES = {

From 2e6f541ec295f8f36fdf394690b0b6bc3c88f72f Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 10 Aug 2024 19:16:03 -0700
Subject: [PATCH 636/743] Bump importlib-metadata from 8.0.0 to 8.2.0 (#2370)

* Bump importlib-metadata from 8.0.0 to 8.2.0

Bumps [importlib-metadata](https://github.com/python/importlib_metadata) from 8.0.0 to 8.2.0.
- [Release notes](https://github.com/python/importlib_metadata/releases)
- [Changelog](https://github.com/python/importlib_metadata/blob/main/NEWS.rst)
- [Commits](https://github.com/python/importlib_metadata/compare/v8.0.0...v8.2.0)

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

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

* Update importlib-metadata==8.2.0

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/importlib_metadata/__init__.py   | 15 ++++-
 lib/importlib_metadata/_itertools.py | 98 ++++++++++++++++++++++++++++
 package/requirements-package.txt     |  2 +-
 requirements.txt                     |  2 +-
 4 files changed, 113 insertions(+), 4 deletions(-)

diff --git a/lib/importlib_metadata/__init__.py b/lib/importlib_metadata/__init__.py
index ed481355..2c71d33c 100644
--- a/lib/importlib_metadata/__init__.py
+++ b/lib/importlib_metadata/__init__.py
@@ -25,7 +25,7 @@ from ._compat import (
     install,
 )
 from ._functools import method_cache, pass_none
-from ._itertools import always_iterable, unique_everseen
+from ._itertools import always_iterable, bucket, unique_everseen
 from ._meta import PackageMetadata, SimplePath
 
 from contextlib import suppress
@@ -39,6 +39,7 @@ __all__ = [
     'DistributionFinder',
     'PackageMetadata',
     'PackageNotFoundError',
+    'SimplePath',
     'distribution',
     'distributions',
     'entry_points',
@@ -388,7 +389,7 @@ class Distribution(metaclass=abc.ABCMeta):
         if not name:
             raise ValueError("A distribution name is required.")
         try:
-            return next(iter(cls.discover(name=name)))
+            return next(iter(cls._prefer_valid(cls.discover(name=name))))
         except StopIteration:
             raise PackageNotFoundError(name)
 
@@ -412,6 +413,16 @@ class Distribution(metaclass=abc.ABCMeta):
             resolver(context) for resolver in cls._discover_resolvers()
         )
 
+    @staticmethod
+    def _prefer_valid(dists: Iterable[Distribution]) -> Iterable[Distribution]:
+        """
+        Prefer (move to the front) distributions that have metadata.
+
+        Ref python/importlib_resources#489.
+        """
+        buckets = bucket(dists, lambda dist: bool(dist.metadata))
+        return itertools.chain(buckets[True], buckets[False])
+
     @staticmethod
     def at(path: str | os.PathLike[str]) -> Distribution:
         """Return a Distribution for the indicated metadata path.
diff --git a/lib/importlib_metadata/_itertools.py b/lib/importlib_metadata/_itertools.py
index d4ca9b91..79d37198 100644
--- a/lib/importlib_metadata/_itertools.py
+++ b/lib/importlib_metadata/_itertools.py
@@ -1,3 +1,4 @@
+from collections import defaultdict, deque
 from itertools import filterfalse
 
 
@@ -71,3 +72,100 @@ def always_iterable(obj, base_type=(str, bytes)):
         return iter(obj)
     except TypeError:
         return iter((obj,))
+
+
+# Copied from more_itertools 10.3
+class bucket:
+    """Wrap *iterable* and return an object that buckets the iterable into
+    child iterables based on a *key* function.
+
+        >>> iterable = ['a1', 'b1', 'c1', 'a2', 'b2', 'c2', 'b3']
+        >>> s = bucket(iterable, key=lambda x: x[0])  # Bucket by 1st character
+        >>> sorted(list(s))  # Get the keys
+        ['a', 'b', 'c']
+        >>> a_iterable = s['a']
+        >>> next(a_iterable)
+        'a1'
+        >>> next(a_iterable)
+        'a2'
+        >>> list(s['b'])
+        ['b1', 'b2', 'b3']
+
+    The original iterable will be advanced and its items will be cached until
+    they are used by the child iterables. This may require significant storage.
+
+    By default, attempting to select a bucket to which no items belong  will
+    exhaust the iterable and cache all values.
+    If you specify a *validator* function, selected buckets will instead be
+    checked against it.
+
+        >>> from itertools import count
+        >>> it = count(1, 2)  # Infinite sequence of odd numbers
+        >>> key = lambda x: x % 10  # Bucket by last digit
+        >>> validator = lambda x: x in {1, 3, 5, 7, 9}  # Odd digits only
+        >>> s = bucket(it, key=key, validator=validator)
+        >>> 2 in s
+        False
+        >>> list(s[2])
+        []
+
+    """
+
+    def __init__(self, iterable, key, validator=None):
+        self._it = iter(iterable)
+        self._key = key
+        self._cache = defaultdict(deque)
+        self._validator = validator or (lambda x: True)
+
+    def __contains__(self, value):
+        if not self._validator(value):
+            return False
+
+        try:
+            item = next(self[value])
+        except StopIteration:
+            return False
+        else:
+            self._cache[value].appendleft(item)
+
+        return True
+
+    def _get_values(self, value):
+        """
+        Helper to yield items from the parent iterator that match *value*.
+        Items that don't match are stored in the local cache as they
+        are encountered.
+        """
+        while True:
+            # If we've cached some items that match the target value, emit
+            # the first one and evict it from the cache.
+            if self._cache[value]:
+                yield self._cache[value].popleft()
+            # Otherwise we need to advance the parent iterator to search for
+            # a matching item, caching the rest.
+            else:
+                while True:
+                    try:
+                        item = next(self._it)
+                    except StopIteration:
+                        return
+                    item_value = self._key(item)
+                    if item_value == value:
+                        yield item
+                        break
+                    elif self._validator(item_value):
+                        self._cache[item_value].append(item)
+
+    def __iter__(self):
+        for item in self._it:
+            item_value = self._key(item)
+            if self._validator(item_value):
+                self._cache[item_value].append(item)
+
+        yield from self._cache.keys()
+
+    def __getitem__(self, value):
+        if not self._validator(value):
+            return iter(())
+
+        return self._get_values(value)
diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index 2f21fea4..0eed49c9 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -1,5 +1,5 @@
 apscheduler==3.10.1
-importlib-metadata==8.0.0
+importlib-metadata==8.2.0
 importlib-resources==6.4.0
 pyinstaller==6.8.0
 pyopenssl==24.1.0
diff --git a/requirements.txt b/requirements.txt
index b1eb7ca1..e553b686 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -16,7 +16,7 @@ gntp==1.0.3
 html5lib==1.1
 httpagentparser==1.9.5
 idna==3.7
-importlib-metadata==8.0.0
+importlib-metadata==8.2.0
 importlib-resources==6.4.0
 git+https://github.com/Tautulli/ipwhois.git@master#egg=ipwhois
 IPy==1.01

From 43cb027592351e2a5226f949c65bb95210f23d46 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 10 Aug 2024 19:16:20 -0700
Subject: [PATCH 637/743] Bump tempora from 5.6.0 to 5.7.0 (#2371)

* Bump tempora from 5.6.0 to 5.7.0

Bumps [tempora](https://github.com/jaraco/tempora) from 5.6.0 to 5.7.0.
- [Release notes](https://github.com/jaraco/tempora/releases)
- [Changelog](https://github.com/jaraco/tempora/blob/main/NEWS.rst)
- [Commits](https://github.com/jaraco/tempora/compare/v5.6.0...v5.7.0)

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

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

* Update tempora==5.7.0

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/jaraco/functools/__init__.py |   8 +
 lib/more_itertools/__init__.py   |   2 +-
 lib/more_itertools/more.py       | 326 ++++++++++++++++++++++++-------
 lib/more_itertools/more.pyi      | 128 ++++++++++--
 lib/more_itertools/recipes.py    |  48 +++--
 lib/tempora/__init__.py          |  40 ++++
 requirements.txt                 |   2 +-
 7 files changed, 453 insertions(+), 101 deletions(-)

diff --git a/lib/jaraco/functools/__init__.py b/lib/jaraco/functools/__init__.py
index ca6c22fa..d66f1af1 100644
--- a/lib/jaraco/functools/__init__.py
+++ b/lib/jaraco/functools/__init__.py
@@ -14,6 +14,14 @@ def compose(*funcs):
     """
     Compose any number of unary functions into a single unary function.
 
+    Comparable to
+    `function composition <https://en.wikipedia.org/wiki/Function_composition>`_
+    in mathematics:
+
+    ``h = g ∘ f`` implies ``h(x) = g(f(x))``.
+
+    In Python, ``h = compose(g, f)``.
+
     >>> import textwrap
     >>> expected = str.strip(textwrap.dedent(compose.__doc__))
     >>> strip_and_dedent = compose(str.strip, textwrap.dedent)
diff --git a/lib/more_itertools/__init__.py b/lib/more_itertools/__init__.py
index 9c4662fc..2e2fcbbe 100644
--- a/lib/more_itertools/__init__.py
+++ b/lib/more_itertools/__init__.py
@@ -3,4 +3,4 @@
 from .more import *  # noqa
 from .recipes import *  # noqa
 
-__version__ = '10.3.0'
+__version__ = '10.4.0'
diff --git a/lib/more_itertools/more.py b/lib/more_itertools/more.py
index 7b481907..3bf2c76b 100755
--- a/lib/more_itertools/more.py
+++ b/lib/more_itertools/more.py
@@ -3,8 +3,9 @@ import warnings
 
 from collections import Counter, defaultdict, deque, abc
 from collections.abc import Sequence
+from contextlib import suppress
 from functools import cached_property, partial, reduce, wraps
-from heapq import heapify, heapreplace, heappop
+from heapq import heapify, heapreplace
 from itertools import (
     chain,
     combinations,
@@ -21,10 +22,10 @@ from itertools import (
     zip_longest,
     product,
 )
-from math import comb, e, exp, factorial, floor, fsum, log, perm, tau
+from math import comb, e, exp, factorial, floor, fsum, log, log1p, perm, tau
 from queue import Empty, Queue
-from random import random, randrange, uniform
-from operator import itemgetter, mul, sub, gt, lt, ge, le
+from random import random, randrange, shuffle, uniform
+from operator import itemgetter, mul, sub, gt, lt, le
 from sys import hexversion, maxsize
 from time import monotonic
 
@@ -34,7 +35,6 @@ from .recipes import (
     UnequalIterablesError,
     consume,
     flatten,
-    pairwise,
     powerset,
     take,
     unique_everseen,
@@ -473,12 +473,10 @@ def ilen(iterable):
     This consumes the iterable, so handle with care.
 
     """
-    # This approach was selected because benchmarks showed it's likely the
-    # fastest of the known implementations at the time of writing.
-    # See GitHub tracker: #236, #230.
-    counter = count()
-    deque(zip(iterable, counter), maxlen=0)
-    return next(counter)
+    # This is the "most beautiful of the fast variants" of this function.
+    # If you think you can improve on it, please ensure that your version
+    # is both 10x faster and 10x more beautiful.
+    return sum(compress(repeat(1), zip(iterable)))
 
 
 def iterate(func, start):
@@ -666,9 +664,9 @@ def distinct_permutations(iterable, r=None):
         >>> sorted(distinct_permutations([1, 0, 1]))
         [(0, 1, 1), (1, 0, 1), (1, 1, 0)]
 
-    Equivalent to ``set(permutations(iterable))``, except duplicates are not
-    generated and thrown away. For larger input sequences this is much more
-    efficient.
+    Equivalent to yielding from ``set(permutations(iterable))``, except
+    duplicates are not generated and thrown away. For larger input sequences
+    this is much more efficient.
 
     Duplicate permutations arise when there are duplicated elements in the
     input iterable. The number of items returned is
@@ -683,6 +681,25 @@ def distinct_permutations(iterable, r=None):
         >>> sorted(distinct_permutations(range(3), r=2))
         [(0, 1), (0, 2), (1, 0), (1, 2), (2, 0), (2, 1)]
 
+    *iterable* need not be sortable, but note that using equal (``x == y``)
+    but non-identical (``id(x) != id(y)``) elements may produce surprising
+    behavior. For example, ``1`` and ``True`` are equal but non-identical:
+
+        >>> list(distinct_permutations([1, True, '3']))  # doctest: +SKIP
+        [
+            (1, True, '3'),
+            (1, '3', True),
+            ('3', 1, True)
+        ]
+        >>> list(distinct_permutations([1, 2, '3']))  # doctest: +SKIP
+        [
+            (1, 2, '3'),
+            (1, '3', 2),
+            (2, 1, '3'),
+            (2, '3', 1),
+            ('3', 1, 2),
+            ('3', 2, 1)
+        ]
     """
 
     # Algorithm: https://w.wiki/Qai
@@ -749,14 +766,44 @@ def distinct_permutations(iterable, r=None):
             i += 1
             head[i:], tail[:] = tail[: r - i], tail[r - i :]
 
-    items = sorted(iterable)
+    items = list(iterable)
+
+    try:
+        items.sort()
+        sortable = True
+    except TypeError:
+        sortable = False
+
+        indices_dict = defaultdict(list)
+
+        for item in items:
+            indices_dict[items.index(item)].append(item)
+
+        indices = [items.index(item) for item in items]
+        indices.sort()
+
+        equivalent_items = {k: cycle(v) for k, v in indices_dict.items()}
+
+        def permuted_items(permuted_indices):
+            return tuple(
+                next(equivalent_items[index]) for index in permuted_indices
+            )
 
     size = len(items)
     if r is None:
         r = size
 
+    # functools.partial(_partial, ... )
+    algorithm = _full if (r == size) else partial(_partial, r=r)
+
     if 0 < r <= size:
-        return _full(items) if (r == size) else _partial(items, r)
+        if sortable:
+            return algorithm(items)
+        else:
+            return (
+                permuted_items(permuted_indices)
+                for permuted_indices in algorithm(indices)
+            )
 
     return iter(() if r else ((),))
 
@@ -1743,7 +1790,9 @@ def zip_offset(*iterables, offsets, longest=False, fillvalue=None):
     return zip(*staggered)
 
 
-def sort_together(iterables, key_list=(0,), key=None, reverse=False):
+def sort_together(
+    iterables, key_list=(0,), key=None, reverse=False, strict=False
+):
     """Return the input iterables sorted together, with *key_list* as the
     priority for sorting. All iterables are trimmed to the length of the
     shortest one.
@@ -1782,6 +1831,10 @@ def sort_together(iterables, key_list=(0,), key=None, reverse=False):
         >>> sort_together([(1, 2, 3), ('c', 'b', 'a')], reverse=True)
         [(3, 2, 1), ('a', 'b', 'c')]
 
+    If the *strict* keyword argument is ``True``, then
+    ``UnequalIterablesError`` will be raised if any of the iterables have
+    different lengths.
+
     """
     if key is None:
         # if there is no key function, the key argument to sorted is an
@@ -1804,8 +1857,9 @@ def sort_together(iterables, key_list=(0,), key=None, reverse=False):
                 *get_key_items(zipped_items)
             )
 
+    zipper = zip_equal if strict else zip
     return list(
-        zip(*sorted(zip(*iterables), key=key_argument, reverse=reverse))
+        zipper(*sorted(zipper(*iterables), key=key_argument, reverse=reverse))
     )
 
 
@@ -2747,8 +2801,6 @@ class seekable:
         >>> it.seek(0)
         >>> next(it), next(it), next(it)
         ('0', '1', '2')
-        >>> next(it)
-        '3'
 
     You can also seek forward:
 
@@ -2756,15 +2808,29 @@ class seekable:
         >>> it.seek(10)
         >>> next(it)
         '10'
-        >>> it.relative_seek(-2)  # Seeking relative to the current position
-        >>> next(it)
-        '9'
         >>> it.seek(20)  # Seeking past the end of the source isn't a problem
         >>> list(it)
         []
         >>> it.seek(0)  # Resetting works even after hitting the end
+        >>> next(it)
+        '0'
+
+    Call :meth:`relative_seek` to seek relative to the source iterator's
+    current position.
+
+        >>> it = seekable((str(n) for n in range(20)))
         >>> next(it), next(it), next(it)
         ('0', '1', '2')
+        >>> it.relative_seek(2)
+        >>> next(it)
+        '5'
+        >>> it.relative_seek(-3)  # Source is at '6', we move back to '3'
+        >>> next(it)
+        '3'
+        >>> it.relative_seek(-3)  # Source is at '4', we move back to '1'
+        >>> next(it)
+        '1'
+
 
     Call :meth:`peek` to look ahead one item without advancing the iterator:
 
@@ -2873,8 +2939,10 @@ class seekable:
             consume(self, remainder)
 
     def relative_seek(self, count):
-        index = len(self._cache)
-        self.seek(max(index + count, 0))
+        if self._index is None:
+            self._index = len(self._cache)
+
+        self.seek(max(self._index + count, 0))
 
 
 class run_length:
@@ -2903,7 +2971,7 @@ class run_length:
 
     @staticmethod
     def decode(iterable):
-        return chain.from_iterable(repeat(k, n) for k, n in iterable)
+        return chain.from_iterable(starmap(repeat, iterable))
 
 
 def exactly_n(iterable, n, predicate=bool):
@@ -2924,14 +2992,34 @@ def exactly_n(iterable, n, predicate=bool):
     return len(take(n + 1, filter(predicate, iterable))) == n
 
 
-def circular_shifts(iterable):
-    """Return a list of circular shifts of *iterable*.
+def circular_shifts(iterable, steps=1):
+    """Yield the circular shifts of *iterable*.
 
-    >>> circular_shifts(range(4))
+    >>> list(circular_shifts(range(4)))
     [(0, 1, 2, 3), (1, 2, 3, 0), (2, 3, 0, 1), (3, 0, 1, 2)]
+
+    Set *steps* to the number of places to rotate to the left
+    (or to the right if negative).  Defaults to 1.
+
+    >>> list(circular_shifts(range(4), 2))
+    [(0, 1, 2, 3), (2, 3, 0, 1)]
+
+    >>> list(circular_shifts(range(4), -1))
+    [(0, 1, 2, 3), (3, 0, 1, 2), (2, 3, 0, 1), (1, 2, 3, 0)]
+
     """
-    lst = list(iterable)
-    return take(len(lst), windowed(cycle(lst), len(lst)))
+    buffer = deque(iterable)
+    if steps == 0:
+        raise ValueError('Steps should be a non-zero integer')
+
+    buffer.rotate(steps)
+    steps = -steps
+    n = len(buffer)
+    n //= math.gcd(n, steps)
+
+    for __ in repeat(None, n):
+        buffer.rotate(steps)
+        yield tuple(buffer)
 
 
 def make_decorator(wrapping_func, result_index=0):
@@ -3191,7 +3279,7 @@ def partitions(iterable):
         yield [sequence[i:j] for i, j in zip((0,) + i, i + (n,))]
 
 
-def set_partitions(iterable, k=None):
+def set_partitions(iterable, k=None, min_size=None, max_size=None):
     """
     Yield the set partitions of *iterable* into *k* parts. Set partitions are
     not order-preserving.
@@ -3215,6 +3303,20 @@ def set_partitions(iterable, k=None):
     ['b', 'ac']
     ['a', 'b', 'c']
 
+    if *min_size* and/or *max_size* are given, the minimum and/or maximum size
+    per block in partition is set.
+
+    >>> iterable = 'abc'
+    >>> for part in set_partitions(iterable, min_size=2):
+    ...     print([''.join(p) for p in part])
+    ['abc']
+    >>> for part in set_partitions(iterable, max_size=2):
+    ...     print([''.join(p) for p in part])
+    ['a', 'bc']
+    ['ab', 'c']
+    ['b', 'ac']
+    ['a', 'b', 'c']
+
     """
     L = list(iterable)
     n = len(L)
@@ -3226,6 +3328,11 @@ def set_partitions(iterable, k=None):
         elif k > n:
             return
 
+    min_size = min_size if min_size is not None else 0
+    max_size = max_size if max_size is not None else n
+    if min_size > max_size:
+        return
+
     def set_partitions_helper(L, k):
         n = len(L)
         if k == 1:
@@ -3242,9 +3349,15 @@ def set_partitions(iterable, k=None):
 
     if k is None:
         for k in range(1, n + 1):
-            yield from set_partitions_helper(L, k)
+            yield from filter(
+                lambda z: all(min_size <= len(bk) <= max_size for bk in z),
+                set_partitions_helper(L, k),
+            )
     else:
-        yield from set_partitions_helper(L, k)
+        yield from filter(
+            lambda z: all(min_size <= len(bk) <= max_size for bk in z),
+            set_partitions_helper(L, k),
+        )
 
 
 class time_limited:
@@ -3535,32 +3648,27 @@ def map_if(iterable, pred, func, func_else=lambda x: x):
         yield func(item) if pred(item) else func_else(item)
 
 
-def _sample_unweighted(iterable, k):
-    # Implementation of "Algorithm L" from the 1994 paper by Kim-Hung Li:
+def _sample_unweighted(iterator, k, strict):
+    # Algorithm L in the 1994 paper by Kim-Hung Li:
     # "Reservoir-Sampling Algorithms of Time Complexity O(n(1+log(N/n)))".
 
-    # Fill up the reservoir (collection of samples) with the first `k` samples
-    reservoir = take(k, iterable)
+    reservoir = list(islice(iterator, k))
+    if strict and len(reservoir) < k:
+        raise ValueError('Sample larger than population')
+    W = 1.0
 
-    # Generate random number that's the largest in a sample of k U(0,1) numbers
-    # Largest order statistic: https://en.wikipedia.org/wiki/Order_statistic
-    W = exp(log(random()) / k)
-
-    # The number of elements to skip before changing the reservoir is a random
-    # number with a geometric distribution. Sample it using random() and logs.
-    next_index = k + floor(log(random()) / log(1 - W))
-
-    for index, element in enumerate(iterable, k):
-        if index == next_index:
-            reservoir[randrange(k)] = element
-            # The new W is the largest in a sample of k U(0, `old_W`) numbers
+    with suppress(StopIteration):
+        while True:
             W *= exp(log(random()) / k)
-            next_index += floor(log(random()) / log(1 - W)) + 1
+            skip = floor(log(random()) / log1p(-W))
+            element = next(islice(iterator, skip, None))
+            reservoir[randrange(k)] = element
 
+    shuffle(reservoir)
     return reservoir
 
 
-def _sample_weighted(iterable, k, weights):
+def _sample_weighted(iterator, k, weights, strict):
     # Implementation of "A-ExpJ" from the 2006 paper by Efraimidis et al. :
     # "Weighted random sampling with a reservoir".
 
@@ -3569,7 +3677,10 @@ def _sample_weighted(iterable, k, weights):
 
     # Fill up the reservoir (collection of samples) with the first `k`
     # weight-keys and elements, then heapify the list.
-    reservoir = take(k, zip(weight_keys, iterable))
+    reservoir = take(k, zip(weight_keys, iterator))
+    if strict and len(reservoir) < k:
+        raise ValueError('Sample larger than population')
+
     heapify(reservoir)
 
     # The number of jumps before changing the reservoir is a random variable
@@ -3577,7 +3688,7 @@ def _sample_weighted(iterable, k, weights):
     smallest_weight_key, _ = reservoir[0]
     weights_to_skip = log(random()) / smallest_weight_key
 
-    for weight, element in zip(weights, iterable):
+    for weight, element in zip(weights, iterator):
         if weight >= weights_to_skip:
             # The notation here is consistent with the paper, but we store
             # the weight-keys in log-space for better numerical stability.
@@ -3591,44 +3702,103 @@ def _sample_weighted(iterable, k, weights):
         else:
             weights_to_skip -= weight
 
-    # Equivalent to [element for weight_key, element in sorted(reservoir)]
-    return [heappop(reservoir)[1] for _ in range(k)]
+    ret = [element for weight_key, element in reservoir]
+    shuffle(ret)
+    return ret
 
 
-def sample(iterable, k, weights=None):
+def _sample_counted(population, k, counts, strict):
+    element = None
+    remaining = 0
+
+    def feed(i):
+        # Advance *i* steps ahead and consume an element
+        nonlocal element, remaining
+
+        while i + 1 > remaining:
+            i = i - remaining
+            element = next(population)
+            remaining = next(counts)
+        remaining -= i + 1
+        return element
+
+    with suppress(StopIteration):
+        reservoir = []
+        for _ in range(k):
+            reservoir.append(feed(0))
+        if strict and len(reservoir) < k:
+            raise ValueError('Sample larger than population')
+
+        W = 1.0
+        while True:
+            W *= exp(log(random()) / k)
+            skip = floor(log(random()) / log1p(-W))
+            element = feed(skip)
+            reservoir[randrange(k)] = element
+
+    shuffle(reservoir)
+    return reservoir
+
+
+def sample(iterable, k, weights=None, *, counts=None, strict=False):
     """Return a *k*-length list of elements chosen (without replacement)
-    from the *iterable*. Like :func:`random.sample`, but works on iterables
-    of unknown length.
+    from the *iterable*. Similar to :func:`random.sample`, but works on
+    iterables of unknown length.
 
     >>> iterable = range(100)
     >>> sample(iterable, 5)  # doctest: +SKIP
     [81, 60, 96, 16, 4]
 
-    An iterable with *weights* may also be given:
+    For iterables with repeated elements, you may supply *counts* to
+    indicate the repeats.
+
+    >>> iterable = ['a', 'b']
+    >>> counts = [3, 4]  # Equivalent to 'a', 'a', 'a', 'b', 'b', 'b', 'b'
+    >>> sample(iterable, k=3, counts=counts)  # doctest: +SKIP
+    ['a', 'a', 'b']
+
+    An iterable with *weights* may be given:
 
     >>> iterable = range(100)
     >>> weights = (i * i + 1 for i in range(100))
     >>> sampled = sample(iterable, 5, weights=weights)  # doctest: +SKIP
     [79, 67, 74, 66, 78]
 
-    The algorithm can also be used to generate weighted random permutations.
-    The relative weight of each item determines the probability that it
-    appears late in the permutation.
+    Weighted selections are made without replacement.
+    After an element is selected, it is removed from the pool and the
+    relative weights of the other elements increase (this
+    does not match the behavior of :func:`random.sample`'s *counts*
+    parameter). Note that *weights* may not be used with *counts*.
 
-    >>> data = "abcdefgh"
-    >>> weights = range(1, len(data) + 1)
-    >>> sample(data, k=len(data), weights=weights)  # doctest: +SKIP
-    ['c', 'a', 'b', 'e', 'g', 'd', 'h', 'f']
+    If the length of *iterable* is less than *k*,
+    ``ValueError`` is raised if *strict* is ``True`` and
+    all elements are returned (in shuffled order) if *strict* is ``False``.
+
+    By default, the `Algorithm L <https://w.wiki/ANrM>`__ reservoir sampling
+    technique is used. When *weights* are provided,
+    `Algorithm A-ExpJ <https://w.wiki/ANrS>`__ is used.
     """
+    iterator = iter(iterable)
+
+    if k < 0:
+        raise ValueError('k must be non-negative')
+
     if k == 0:
         return []
 
-    iterable = iter(iterable)
-    if weights is None:
-        return _sample_unweighted(iterable, k)
-    else:
+    if weights is not None and counts is not None:
+        raise TypeError('weights and counts are mutally exclusive')
+
+    elif weights is not None:
         weights = iter(weights)
-        return _sample_weighted(iterable, k, weights)
+        return _sample_weighted(iterator, k, weights, strict)
+
+    elif counts is not None:
+        counts = iter(counts)
+        return _sample_counted(iterator, k, counts, strict)
+
+    else:
+        return _sample_unweighted(iterator, k, strict)
 
 
 def is_sorted(iterable, key=None, reverse=False, strict=False):
@@ -3650,12 +3820,16 @@ def is_sorted(iterable, key=None, reverse=False, strict=False):
     False
 
     The function returns ``False`` after encountering the first out-of-order
-    item. If there are no out-of-order items, the iterable is exhausted.
+    item, which means it may produce results that differ from the built-in
+    :func:`sorted` function for objects with unusual comparison dynamics.
+    If there are no out-of-order items, the iterable is exhausted.
     """
+    compare = le if strict else lt
+    it = iterable if (key is None) else map(key, iterable)
+    it_1, it_2 = tee(it)
+    next(it_2 if reverse else it_1, None)
 
-    compare = (le if reverse else ge) if strict else (lt if reverse else gt)
-    it = iterable if key is None else map(key, iterable)
-    return not any(starmap(compare, pairwise(it)))
+    return not any(map(compare, it_1, it_2))
 
 
 class AbortThread(BaseException):
diff --git a/lib/more_itertools/more.pyi b/lib/more_itertools/more.pyi
index e9460232..f1a155dc 100644
--- a/lib/more_itertools/more.pyi
+++ b/lib/more_itertools/more.pyi
@@ -2,6 +2,8 @@
 
 from __future__ import annotations
 
+import sys
+
 from types import TracebackType
 from typing import (
     Any,
@@ -28,6 +30,9 @@ from typing_extensions import Protocol
 _T = TypeVar('_T')
 _T1 = TypeVar('_T1')
 _T2 = TypeVar('_T2')
+_T3 = TypeVar('_T3')
+_T4 = TypeVar('_T4')
+_T5 = TypeVar('_T5')
 _U = TypeVar('_U')
 _V = TypeVar('_V')
 _W = TypeVar('_W')
@@ -35,6 +40,12 @@ _T_co = TypeVar('_T_co', covariant=True)
 _GenFn = TypeVar('_GenFn', bound=Callable[..., Iterator[Any]])
 _Raisable = BaseException | Type[BaseException]
 
+# The type of isinstance's second argument (from typeshed builtins)
+if sys.version_info >= (3, 10):
+    _ClassInfo = type | UnionType | tuple[_ClassInfo, ...]
+else:
+    _ClassInfo = type | tuple[_ClassInfo, ...]
+
 @type_check_only
 class _SizedIterable(Protocol[_T_co], Sized, Iterable[_T_co]): ...
 
@@ -135,7 +146,7 @@ def interleave_evenly(
 ) -> Iterator[_T]: ...
 def collapse(
     iterable: Iterable[Any],
-    base_type: type | None = ...,
+    base_type: _ClassInfo | None = ...,
     levels: int | None = ...,
 ) -> Iterator[Any]: ...
 @overload
@@ -213,6 +224,7 @@ def stagger(
 class UnequalIterablesError(ValueError):
     def __init__(self, details: tuple[int, int, int] | None = ...) -> None: ...
 
+# zip_equal
 @overload
 def zip_equal(__iter1: Iterable[_T1]) -> Iterator[tuple[_T1]]: ...
 @overload
@@ -221,11 +233,35 @@ def zip_equal(
 ) -> Iterator[tuple[_T1, _T2]]: ...
 @overload
 def zip_equal(
-    __iter1: Iterable[_T],
-    __iter2: Iterable[_T],
-    __iter3: Iterable[_T],
-    *iterables: Iterable[_T],
-) -> Iterator[tuple[_T, ...]]: ...
+    __iter1: Iterable[_T1], __iter2: Iterable[_T2], __iter3: Iterable[_T3]
+) -> Iterator[tuple[_T1, _T2, _T3]]: ...
+@overload
+def zip_equal(
+    __iter1: Iterable[_T1],
+    __iter2: Iterable[_T2],
+    __iter3: Iterable[_T3],
+    __iter4: Iterable[_T4],
+) -> Iterator[tuple[_T1, _T2, _T3, _T4]]: ...
+@overload
+def zip_equal(
+    __iter1: Iterable[_T1],
+    __iter2: Iterable[_T2],
+    __iter3: Iterable[_T3],
+    __iter4: Iterable[_T4],
+    __iter5: Iterable[_T5],
+) -> Iterator[tuple[_T1, _T2, _T3, _T4, _T5]]: ...
+@overload
+def zip_equal(
+    __iter1: Iterable[Any],
+    __iter2: Iterable[Any],
+    __iter3: Iterable[Any],
+    __iter4: Iterable[Any],
+    __iter5: Iterable[Any],
+    __iter6: Iterable[Any],
+    *iterables: Iterable[Any],
+) -> Iterator[tuple[Any, ...]]: ...
+
+# zip_offset
 @overload
 def zip_offset(
     __iter1: Iterable[_T1],
@@ -285,12 +321,13 @@ def sort_together(
     key_list: Iterable[int] = ...,
     key: Callable[..., Any] | None = ...,
     reverse: bool = ...,
+    strict: bool = ...,
 ) -> list[tuple[_T, ...]]: ...
 def unzip(iterable: Iterable[Sequence[_T]]) -> tuple[Iterator[_T], ...]: ...
 def divide(n: int, iterable: Iterable[_T]) -> list[Iterator[_T]]: ...
 def always_iterable(
     obj: object,
-    base_type: type | tuple[type | tuple[Any, ...], ...] | None = ...,
+    base_type: _ClassInfo | None = ...,
 ) -> Iterator[Any]: ...
 def adjacent(
     predicate: Callable[[_T], bool],
@@ -454,7 +491,9 @@ class run_length:
 def exactly_n(
     iterable: Iterable[_T], n: int, predicate: Callable[[_T], object] = ...
 ) -> bool: ...
-def circular_shifts(iterable: Iterable[_T]) -> list[tuple[_T, ...]]: ...
+def circular_shifts(
+    iterable: Iterable[_T], steps: int = 1
+) -> list[tuple[_T, ...]]: ...
 def make_decorator(
     wrapping_func: Callable[..., _U], result_index: int = ...
 ) -> Callable[..., Callable[[Callable[..., Any]], Callable[..., _U]]]: ...
@@ -500,7 +539,10 @@ def replace(
 ) -> Iterator[_T | _U]: ...
 def partitions(iterable: Iterable[_T]) -> Iterator[list[list[_T]]]: ...
 def set_partitions(
-    iterable: Iterable[_T], k: int | None = ...
+    iterable: Iterable[_T],
+    k: int | None = ...,
+    min_size: int | None = ...,
+    max_size: int | None = ...,
 ) -> Iterator[list[list[_T]]]: ...
 
 class time_limited(Generic[_T], Iterator[_T]):
@@ -538,10 +580,22 @@ def map_if(
     func: Callable[[Any], Any],
     func_else: Callable[[Any], Any] | None = ...,
 ) -> Iterator[Any]: ...
+def _sample_unweighted(
+    iterator: Iterator[_T], k: int, strict: bool
+) -> list[_T]: ...
+def _sample_counted(
+    population: Iterator[_T], k: int, counts: Iterable[int], strict: bool
+) -> list[_T]: ...
+def _sample_weighted(
+    iterator: Iterator[_T], k: int, weights, strict
+) -> list[_T]: ...
 def sample(
     iterable: Iterable[_T],
     k: int,
     weights: Iterable[float] | None = ...,
+    *,
+    counts: Iterable[int] | None = ...,
+    strict: bool = False,
 ) -> list[_T]: ...
 def is_sorted(
     iterable: Iterable[_T],
@@ -577,7 +631,7 @@ class callback_iter(Generic[_T], Iterator[_T]):
 
 def windowed_complete(
     iterable: Iterable[_T], n: int
-) -> Iterator[tuple[_T, ...]]: ...
+) -> Iterator[tuple[tuple[_T, ...], tuple[_T, ...], tuple[_T, ...]]]: ...
 def all_unique(
     iterable: Iterable[_T], key: Callable[[_T], _U] | None = ...
 ) -> bool: ...
@@ -608,9 +662,61 @@ class countable(Generic[_T], Iterator[_T]):
     items_seen: int
 
 def chunked_even(iterable: Iterable[_T], n: int) -> Iterator[list[_T]]: ...
+@overload
 def zip_broadcast(
+    __obj1: _T | Iterable[_T],
+    *,
+    scalar_types: _ClassInfo | None = ...,
+    strict: bool = ...,
+) -> Iterable[tuple[_T, ...]]: ...
+@overload
+def zip_broadcast(
+    __obj1: _T | Iterable[_T],
+    __obj2: _T | Iterable[_T],
+    *,
+    scalar_types: _ClassInfo | None = ...,
+    strict: bool = ...,
+) -> Iterable[tuple[_T, ...]]: ...
+@overload
+def zip_broadcast(
+    __obj1: _T | Iterable[_T],
+    __obj2: _T | Iterable[_T],
+    __obj3: _T | Iterable[_T],
+    *,
+    scalar_types: _ClassInfo | None = ...,
+    strict: bool = ...,
+) -> Iterable[tuple[_T, ...]]: ...
+@overload
+def zip_broadcast(
+    __obj1: _T | Iterable[_T],
+    __obj2: _T | Iterable[_T],
+    __obj3: _T | Iterable[_T],
+    __obj4: _T | Iterable[_T],
+    *,
+    scalar_types: _ClassInfo | None = ...,
+    strict: bool = ...,
+) -> Iterable[tuple[_T, ...]]: ...
+@overload
+def zip_broadcast(
+    __obj1: _T | Iterable[_T],
+    __obj2: _T | Iterable[_T],
+    __obj3: _T | Iterable[_T],
+    __obj4: _T | Iterable[_T],
+    __obj5: _T | Iterable[_T],
+    *,
+    scalar_types: _ClassInfo | None = ...,
+    strict: bool = ...,
+) -> Iterable[tuple[_T, ...]]: ...
+@overload
+def zip_broadcast(
+    __obj1: _T | Iterable[_T],
+    __obj2: _T | Iterable[_T],
+    __obj3: _T | Iterable[_T],
+    __obj4: _T | Iterable[_T],
+    __obj5: _T | Iterable[_T],
+    __obj6: _T | Iterable[_T],
     *objects: _T | Iterable[_T],
-    scalar_types: type | tuple[type | tuple[Any, ...], ...] | None = ...,
+    scalar_types: _ClassInfo | None = ...,
     strict: bool = ...,
 ) -> Iterable[tuple[_T, ...]]: ...
 def unique_in_window(
diff --git a/lib/more_itertools/recipes.py b/lib/more_itertools/recipes.py
index b32fa955..a21a1f5d 100644
--- a/lib/more_itertools/recipes.py
+++ b/lib/more_itertools/recipes.py
@@ -795,8 +795,30 @@ def triplewise(iterable):
     [('A', 'B', 'C'), ('B', 'C', 'D'), ('C', 'D', 'E')]
 
     """
-    for (a, _), (b, c) in pairwise(pairwise(iterable)):
-        yield a, b, c
+    # This deviates from the itertools documentation reciple - see
+    # https://github.com/more-itertools/more-itertools/issues/889
+    t1, t2, t3 = tee(iterable, 3)
+    next(t3, None)
+    next(t3, None)
+    next(t2, None)
+    return zip(t1, t2, t3)
+
+
+def _sliding_window_islice(iterable, n):
+    # Fast path for small, non-zero values of n.
+    iterators = tee(iterable, n)
+    for i, iterator in enumerate(iterators):
+        next(islice(iterator, i, i), None)
+    return zip(*iterators)
+
+
+def _sliding_window_deque(iterable, n):
+    # Normal path for other values of n.
+    it = iter(iterable)
+    window = deque(islice(it, n - 1), maxlen=n)
+    for x in it:
+        window.append(x)
+        yield tuple(window)
 
 
 def sliding_window(iterable, n):
@@ -812,11 +834,16 @@ def sliding_window(iterable, n):
 
     For a variant with more features, see :func:`windowed`.
     """
-    it = iter(iterable)
-    window = deque(islice(it, n - 1), maxlen=n)
-    for x in it:
-        window.append(x)
-        yield tuple(window)
+    if n > 20:
+        return _sliding_window_deque(iterable, n)
+    elif n > 2:
+        return _sliding_window_islice(iterable, n)
+    elif n == 2:
+        return pairwise(iterable)
+    elif n == 1:
+        return zip(iterable)
+    else:
+        raise ValueError(f'n should be at least one, not {n}')
 
 
 def subslices(iterable):
@@ -1038,9 +1065,6 @@ def totient(n):
     >>> totient(12)
     4
     """
-    # The itertools docs use unique_justseen instead of set; see
-    # https://github.com/more-itertools/more-itertools/issues/823
-    for p in set(factor(n)):
-        n = n // p * (p - 1)
-
+    for prime in set(factor(n)):
+        n -= n // prime
     return n
diff --git a/lib/tempora/__init__.py b/lib/tempora/__init__.py
index b2690a74..a41d02c2 100644
--- a/lib/tempora/__init__.py
+++ b/lib/tempora/__init__.py
@@ -10,6 +10,9 @@ from numbers import Number
 from typing import Union, Tuple, Iterable
 from typing import cast
 
+import dateutil.parser
+import dateutil.tz
+
 
 # some useful constants
 osc_per_year = 290_091_329_207_984_000
@@ -611,3 +614,40 @@ def date_range(start=None, stop=None, step=None):
     while start < stop:
         yield start
         start += step
+
+
+tzinfos = dict(
+    AEST=dateutil.tz.gettz("Australia/Sydney"),
+    AEDT=dateutil.tz.gettz("Australia/Sydney"),
+    ACST=dateutil.tz.gettz("Australia/Darwin"),
+    ACDT=dateutil.tz.gettz("Australia/Adelaide"),
+    AWST=dateutil.tz.gettz("Australia/Perth"),
+    EST=dateutil.tz.gettz("America/New_York"),
+    EDT=dateutil.tz.gettz("America/New_York"),
+    CST=dateutil.tz.gettz("America/Chicago"),
+    CDT=dateutil.tz.gettz("America/Chicago"),
+    MST=dateutil.tz.gettz("America/Denver"),
+    MDT=dateutil.tz.gettz("America/Denver"),
+    PST=dateutil.tz.gettz("America/Los_Angeles"),
+    PDT=dateutil.tz.gettz("America/Los_Angeles"),
+    GMT=dateutil.tz.gettz("Etc/GMT"),
+    UTC=dateutil.tz.gettz("UTC"),
+    CET=dateutil.tz.gettz("Europe/Berlin"),
+    CEST=dateutil.tz.gettz("Europe/Berlin"),
+    IST=dateutil.tz.gettz("Asia/Kolkata"),
+    BST=dateutil.tz.gettz("Europe/London"),
+    MSK=dateutil.tz.gettz("Europe/Moscow"),
+    EET=dateutil.tz.gettz("Europe/Helsinki"),
+    EEST=dateutil.tz.gettz("Europe/Helsinki"),
+    # Add more mappings as needed
+)
+
+
+def parse(*args, **kwargs):
+    """
+    Parse the input using dateutil.parser.parse with friendly tz support.
+
+    >>> parse('2024-07-26 12:59:00 EDT')
+    datetime.datetime(...America/New_York...)
+    """
+    return dateutil.parser.parse(*args, tzinfos=tzinfos, **kwargs)
diff --git a/requirements.txt b/requirements.txt
index e553b686..bbbfe81e 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -39,7 +39,7 @@ requests-oauthlib==2.0.0
 rumps==0.4.0; platform_system == "Darwin"
 simplejson==3.19.2
 six==1.16.0
-tempora==5.6.0
+tempora==5.7.0
 tokenize-rt==5.2.0
 tzdata==2024.1
 tzlocal==5.0.1

From da501df846ed74e621e5563b4a0f5279afb78520 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 10 Aug 2024 19:18:24 -0700
Subject: [PATCH 638/743] Bump pyjwt from 2.8.0 to 2.9.0 (#2374)

* Bump pyjwt from 2.8.0 to 2.9.0

Bumps [pyjwt](https://github.com/jpadilla/pyjwt) from 2.8.0 to 2.9.0.
- [Release notes](https://github.com/jpadilla/pyjwt/releases)
- [Changelog](https://github.com/jpadilla/pyjwt/blob/master/CHANGELOG.rst)
- [Commits](https://github.com/jpadilla/pyjwt/compare/2.8.0...2.9.0)

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

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

* Update pyjwt==2.9.0

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/jwt/__init__.py   |  2 +-
 lib/jwt/algorithms.py | 86 +++++++++++++++++++++----------------------
 lib/jwt/api_jwk.py    | 32 +++++++++++-----
 lib/jwt/api_jws.py    | 25 ++++++++-----
 lib/jwt/api_jwt.py    | 21 +++++++----
 lib/jwt/exceptions.py |  4 ++
 lib/jwt/utils.py      | 17 ++-------
 requirements.txt      |  2 +-
 8 files changed, 102 insertions(+), 87 deletions(-)

diff --git a/lib/jwt/__init__.py b/lib/jwt/__init__.py
index 68d09c1c..b7a258d7 100644
--- a/lib/jwt/__init__.py
+++ b/lib/jwt/__init__.py
@@ -27,7 +27,7 @@ from .exceptions import (
 )
 from .jwks_client import PyJWKClient
 
-__version__ = "2.8.0"
+__version__ = "2.9.0"
 
 __title__ = "PyJWT"
 __description__ = "JSON Web Token implementation in Python"
diff --git a/lib/jwt/algorithms.py b/lib/jwt/algorithms.py
index ed187152..9be50b20 100644
--- a/lib/jwt/algorithms.py
+++ b/lib/jwt/algorithms.py
@@ -3,9 +3,8 @@ from __future__ import annotations
 import hashlib
 import hmac
 import json
-import sys
 from abc import ABC, abstractmethod
-from typing import TYPE_CHECKING, Any, ClassVar, NoReturn, Union, cast, overload
+from typing import TYPE_CHECKING, Any, ClassVar, Literal, NoReturn, cast, overload
 
 from .exceptions import InvalidKeyError
 from .types import HashlibHash, JWKDict
@@ -21,14 +20,8 @@ from .utils import (
     to_base64url_uint,
 )
 
-if sys.version_info >= (3, 8):
-    from typing import Literal
-else:
-    from typing_extensions import Literal
-
-
 try:
-    from cryptography.exceptions import InvalidSignature
+    from cryptography.exceptions import InvalidSignature, UnsupportedAlgorithm
     from cryptography.hazmat.backends import default_backend
     from cryptography.hazmat.primitives import hashes
     from cryptography.hazmat.primitives.asymmetric import padding
@@ -194,18 +187,16 @@ class Algorithm(ABC):
     @overload
     @staticmethod
     @abstractmethod
-    def to_jwk(key_obj, as_dict: Literal[True]) -> JWKDict:
-        ...  # pragma: no cover
+    def to_jwk(key_obj, as_dict: Literal[True]) -> JWKDict: ...  # pragma: no cover
 
     @overload
     @staticmethod
     @abstractmethod
-    def to_jwk(key_obj, as_dict: Literal[False] = False) -> str:
-        ...  # pragma: no cover
+    def to_jwk(key_obj, as_dict: Literal[False] = False) -> str: ...  # pragma: no cover
 
     @staticmethod
     @abstractmethod
-    def to_jwk(key_obj, as_dict: bool = False) -> Union[JWKDict, str]:
+    def to_jwk(key_obj, as_dict: bool = False) -> JWKDict | str:
         """
         Serializes a given key into a JWK
         """
@@ -274,16 +265,18 @@ class HMACAlgorithm(Algorithm):
 
     @overload
     @staticmethod
-    def to_jwk(key_obj: str | bytes, as_dict: Literal[True]) -> JWKDict:
-        ...  # pragma: no cover
+    def to_jwk(
+        key_obj: str | bytes, as_dict: Literal[True]
+    ) -> JWKDict: ...  # pragma: no cover
 
     @overload
     @staticmethod
-    def to_jwk(key_obj: str | bytes, as_dict: Literal[False] = False) -> str:
-        ...  # pragma: no cover
+    def to_jwk(
+        key_obj: str | bytes, as_dict: Literal[False] = False
+    ) -> str: ...  # pragma: no cover
 
     @staticmethod
-    def to_jwk(key_obj: str | bytes, as_dict: bool = False) -> Union[JWKDict, str]:
+    def to_jwk(key_obj: str | bytes, as_dict: bool = False) -> JWKDict | str:
         jwk = {
             "k": base64url_encode(force_bytes(key_obj)).decode(),
             "kty": "oct",
@@ -350,22 +343,25 @@ if has_crypto:
                         RSAPrivateKey, load_pem_private_key(key_bytes, password=None)
                     )
             except ValueError:
-                return cast(RSAPublicKey, load_pem_public_key(key_bytes))
+                try:
+                    return cast(RSAPublicKey, load_pem_public_key(key_bytes))
+                except (ValueError, UnsupportedAlgorithm):
+                    raise InvalidKeyError("Could not parse the provided public key.")
 
         @overload
-        @staticmethod
-        def to_jwk(key_obj: AllowedRSAKeys, as_dict: Literal[True]) -> JWKDict:
-            ...  # pragma: no cover
-
-        @overload
-        @staticmethod
-        def to_jwk(key_obj: AllowedRSAKeys, as_dict: Literal[False] = False) -> str:
-            ...  # pragma: no cover
-
         @staticmethod
         def to_jwk(
-            key_obj: AllowedRSAKeys, as_dict: bool = False
-        ) -> Union[JWKDict, str]:
+            key_obj: AllowedRSAKeys, as_dict: Literal[True]
+        ) -> JWKDict: ...  # pragma: no cover
+
+        @overload
+        @staticmethod
+        def to_jwk(
+            key_obj: AllowedRSAKeys, as_dict: Literal[False] = False
+        ) -> str: ...  # pragma: no cover
+
+        @staticmethod
+        def to_jwk(key_obj: AllowedRSAKeys, as_dict: bool = False) -> JWKDict | str:
             obj: dict[str, Any] | None = None
 
             if hasattr(key_obj, "private_numbers"):
@@ -533,7 +529,7 @@ if has_crypto:
 
             return der_to_raw_signature(der_sig, key.curve)
 
-        def verify(self, msg: bytes, key: "AllowedECKeys", sig: bytes) -> bool:
+        def verify(self, msg: bytes, key: AllowedECKeys, sig: bytes) -> bool:
             try:
                 der_sig = raw_to_der_signature(sig, key.curve)
             except ValueError:
@@ -552,18 +548,18 @@ if has_crypto:
 
         @overload
         @staticmethod
-        def to_jwk(key_obj: AllowedECKeys, as_dict: Literal[True]) -> JWKDict:
-            ...  # pragma: no cover
+        def to_jwk(
+            key_obj: AllowedECKeys, as_dict: Literal[True]
+        ) -> JWKDict: ...  # pragma: no cover
 
         @overload
         @staticmethod
-        def to_jwk(key_obj: AllowedECKeys, as_dict: Literal[False] = False) -> str:
-            ...  # pragma: no cover
+        def to_jwk(
+            key_obj: AllowedECKeys, as_dict: Literal[False] = False
+        ) -> str: ...  # pragma: no cover
 
         @staticmethod
-        def to_jwk(
-            key_obj: AllowedECKeys, as_dict: bool = False
-        ) -> Union[JWKDict, str]:
+        def to_jwk(key_obj: AllowedECKeys, as_dict: bool = False) -> JWKDict | str:
             if isinstance(key_obj, EllipticCurvePrivateKey):
                 public_numbers = key_obj.public_key().public_numbers()
             elif isinstance(key_obj, EllipticCurvePublicKey):
@@ -771,16 +767,18 @@ if has_crypto:
 
         @overload
         @staticmethod
-        def to_jwk(key: AllowedOKPKeys, as_dict: Literal[True]) -> JWKDict:
-            ...  # pragma: no cover
+        def to_jwk(
+            key: AllowedOKPKeys, as_dict: Literal[True]
+        ) -> JWKDict: ...  # pragma: no cover
 
         @overload
         @staticmethod
-        def to_jwk(key: AllowedOKPKeys, as_dict: Literal[False] = False) -> str:
-            ...  # pragma: no cover
+        def to_jwk(
+            key: AllowedOKPKeys, as_dict: Literal[False] = False
+        ) -> str: ...  # pragma: no cover
 
         @staticmethod
-        def to_jwk(key: AllowedOKPKeys, as_dict: bool = False) -> Union[JWKDict, str]:
+        def to_jwk(key: AllowedOKPKeys, as_dict: bool = False) -> JWKDict | str:
             if isinstance(key, (Ed25519PublicKey, Ed448PublicKey)):
                 x = key.public_bytes(
                     encoding=Encoding.Raw,
diff --git a/lib/jwt/api_jwk.py b/lib/jwt/api_jwk.py
index 456c7f4d..02f4679c 100644
--- a/lib/jwt/api_jwk.py
+++ b/lib/jwt/api_jwk.py
@@ -5,7 +5,13 @@ import time
 from typing import Any
 
 from .algorithms import get_default_algorithms, has_crypto, requires_cryptography
-from .exceptions import InvalidKeyError, PyJWKError, PyJWKSetError, PyJWTError
+from .exceptions import (
+    InvalidKeyError,
+    MissingCryptographyError,
+    PyJWKError,
+    PyJWKSetError,
+    PyJWTError,
+)
 from .types import JWKDict
 
 
@@ -50,21 +56,25 @@ class PyJWK:
                 raise InvalidKeyError(f"Unsupported kty: {kty}")
 
         if not has_crypto and algorithm in requires_cryptography:
-            raise PyJWKError(f"{algorithm} requires 'cryptography' to be installed.")
+            raise MissingCryptographyError(
+                f"{algorithm} requires 'cryptography' to be installed."
+            )
 
-        self.Algorithm = self._algorithms.get(algorithm)
+        self.algorithm_name = algorithm
 
-        if not self.Algorithm:
+        if algorithm in self._algorithms:
+            self.Algorithm = self._algorithms[algorithm]
+        else:
             raise PyJWKError(f"Unable to find an algorithm for key: {self._jwk_data}")
 
         self.key = self.Algorithm.from_jwk(self._jwk_data)
 
     @staticmethod
-    def from_dict(obj: JWKDict, algorithm: str | None = None) -> "PyJWK":
+    def from_dict(obj: JWKDict, algorithm: str | None = None) -> PyJWK:
         return PyJWK(obj, algorithm)
 
     @staticmethod
-    def from_json(data: str, algorithm: None = None) -> "PyJWK":
+    def from_json(data: str, algorithm: None = None) -> PyJWK:
         obj = json.loads(data)
         return PyJWK.from_dict(obj, algorithm)
 
@@ -94,7 +104,9 @@ class PyJWKSet:
         for key in keys:
             try:
                 self.keys.append(PyJWK(key))
-            except PyJWTError:
+            except PyJWTError as error:
+                if isinstance(error, MissingCryptographyError):
+                    raise error
                 # skip unusable keys
                 continue
 
@@ -104,16 +116,16 @@ class PyJWKSet:
             )
 
     @staticmethod
-    def from_dict(obj: dict[str, Any]) -> "PyJWKSet":
+    def from_dict(obj: dict[str, Any]) -> PyJWKSet:
         keys = obj.get("keys", [])
         return PyJWKSet(keys)
 
     @staticmethod
-    def from_json(data: str) -> "PyJWKSet":
+    def from_json(data: str) -> PyJWKSet:
         obj = json.loads(data)
         return PyJWKSet.from_dict(obj)
 
-    def __getitem__(self, kid: str) -> "PyJWK":
+    def __getitem__(self, kid: str) -> PyJWK:
         for key in self.keys:
             if key.key_id == kid:
                 return key
diff --git a/lib/jwt/api_jws.py b/lib/jwt/api_jws.py
index fa6708cc..5822ebf6 100644
--- a/lib/jwt/api_jws.py
+++ b/lib/jwt/api_jws.py
@@ -11,6 +11,7 @@ from .algorithms import (
     has_crypto,
     requires_cryptography,
 )
+from .api_jwk import PyJWK
 from .exceptions import (
     DecodeError,
     InvalidAlgorithmError,
@@ -172,7 +173,7 @@ class PyJWS:
     def decode_complete(
         self,
         jwt: str | bytes,
-        key: AllowedPublicKeys | str | bytes = "",
+        key: AllowedPublicKeys | PyJWK | str | bytes = "",
         algorithms: list[str] | None = None,
         options: dict[str, Any] | None = None,
         detached_payload: bytes | None = None,
@@ -190,7 +191,7 @@ class PyJWS:
         merged_options = {**self.options, **options}
         verify_signature = merged_options["verify_signature"]
 
-        if verify_signature and not algorithms:
+        if verify_signature and not algorithms and not isinstance(key, PyJWK):
             raise DecodeError(
                 'It is required that you pass in a value for the "algorithms" argument when calling decode().'
             )
@@ -217,7 +218,7 @@ class PyJWS:
     def decode(
         self,
         jwt: str | bytes,
-        key: AllowedPublicKeys | str | bytes = "",
+        key: AllowedPublicKeys | PyJWK | str | bytes = "",
         algorithms: list[str] | None = None,
         options: dict[str, Any] | None = None,
         detached_payload: bytes | None = None,
@@ -289,9 +290,11 @@ class PyJWS:
         signing_input: bytes,
         header: dict[str, Any],
         signature: bytes,
-        key: AllowedPublicKeys | str | bytes = "",
+        key: AllowedPublicKeys | PyJWK | str | bytes = "",
         algorithms: list[str] | None = None,
     ) -> None:
+        if algorithms is None and isinstance(key, PyJWK):
+            algorithms = [key.algorithm_name]
         try:
             alg = header["alg"]
         except KeyError:
@@ -300,11 +303,15 @@ class PyJWS:
         if not alg or (algorithms is not None and alg not in algorithms):
             raise InvalidAlgorithmError("The specified alg value is not allowed")
 
-        try:
-            alg_obj = self.get_algorithm_by_name(alg)
-        except NotImplementedError as e:
-            raise InvalidAlgorithmError("Algorithm not supported") from e
-        prepared_key = alg_obj.prepare_key(key)
+        if isinstance(key, PyJWK):
+            alg_obj = key.Algorithm
+            prepared_key = key.key
+        else:
+            try:
+                alg_obj = self.get_algorithm_by_name(alg)
+            except NotImplementedError as e:
+                raise InvalidAlgorithmError("Algorithm not supported") from e
+            prepared_key = alg_obj.prepare_key(key)
 
         if not alg_obj.verify(signing_input, prepared_key, signature):
             raise InvalidSignatureError("Signature verification failed")
diff --git a/lib/jwt/api_jwt.py b/lib/jwt/api_jwt.py
index 48d739ad..7a07c336 100644
--- a/lib/jwt/api_jwt.py
+++ b/lib/jwt/api_jwt.py
@@ -5,7 +5,7 @@ import warnings
 from calendar import timegm
 from collections.abc import Iterable
 from datetime import datetime, timedelta, timezone
-from typing import TYPE_CHECKING, Any
+from typing import TYPE_CHECKING, Any, List
 
 from . import api_jws
 from .exceptions import (
@@ -21,6 +21,7 @@ from .warnings import RemovedInPyjwt3Warning
 
 if TYPE_CHECKING:
     from .algorithms import AllowedPrivateKeys, AllowedPublicKeys
+    from .api_jwk import PyJWK
 
 
 class PyJWT:
@@ -100,7 +101,7 @@ class PyJWT:
     def decode_complete(
         self,
         jwt: str | bytes,
-        key: AllowedPublicKeys | str | bytes = "",
+        key: AllowedPublicKeys | PyJWK | str | bytes = "",
         algorithms: list[str] | None = None,
         options: dict[str, Any] | None = None,
         # deprecated arg, remove in pyjwt3
@@ -110,7 +111,7 @@ class PyJWT:
         # passthrough arguments to _validate_claims
         # consider putting in options
         audience: str | Iterable[str] | None = None,
-        issuer: str | None = None,
+        issuer: str | List[str] | None = None,
         leeway: float | timedelta = 0,
         # kwargs
         **kwargs: Any,
@@ -185,7 +186,7 @@ class PyJWT:
     def decode(
         self,
         jwt: str | bytes,
-        key: AllowedPublicKeys | str | bytes = "",
+        key: AllowedPublicKeys | PyJWK | str | bytes = "",
         algorithms: list[str] | None = None,
         options: dict[str, Any] | None = None,
         # deprecated arg, remove in pyjwt3
@@ -195,7 +196,7 @@ class PyJWT:
         # passthrough arguments to _validate_claims
         # consider putting in options
         audience: str | Iterable[str] | None = None,
-        issuer: str | None = None,
+        issuer: str | List[str] | None = None,
         leeway: float | timedelta = 0,
         # kwargs
         **kwargs: Any,
@@ -300,7 +301,7 @@ class PyJWT:
         try:
             exp = int(payload["exp"])
         except ValueError:
-            raise DecodeError("Expiration Time claim (exp) must be an" " integer.")
+            raise DecodeError("Expiration Time claim (exp) must be an integer.")
 
         if exp <= (now - leeway):
             raise ExpiredSignatureError("Signature has expired")
@@ -362,8 +363,12 @@ class PyJWT:
         if "iss" not in payload:
             raise MissingRequiredClaimError("iss")
 
-        if payload["iss"] != issuer:
-            raise InvalidIssuerError("Invalid issuer")
+        if isinstance(issuer, list):
+            if payload["iss"] not in issuer:
+                raise InvalidIssuerError("Invalid issuer")
+        else:
+            if payload["iss"] != issuer:
+                raise InvalidIssuerError("Invalid issuer")
 
 
 _jwt_global_obj = PyJWT()
diff --git a/lib/jwt/exceptions.py b/lib/jwt/exceptions.py
index 8ac6ecf7..0d985882 100644
--- a/lib/jwt/exceptions.py
+++ b/lib/jwt/exceptions.py
@@ -58,6 +58,10 @@ class PyJWKError(PyJWTError):
     pass
 
 
+class MissingCryptographyError(PyJWKError):
+    pass
+
+
 class PyJWKSetError(PyJWTError):
     pass
 
diff --git a/lib/jwt/utils.py b/lib/jwt/utils.py
index 81c5ee41..d469139b 100644
--- a/lib/jwt/utils.py
+++ b/lib/jwt/utils.py
@@ -131,26 +131,15 @@ def is_pem_format(key: bytes) -> bool:
 
 
 # Based on https://github.com/pyca/cryptography/blob/bcb70852d577b3f490f015378c75cba74986297b/src/cryptography/hazmat/primitives/serialization/ssh.py#L40-L46
-_CERT_SUFFIX = b"-cert-v01@openssh.com"
-_SSH_PUBKEY_RC = re.compile(rb"\A(\S+)[ \t]+(\S+)")
-_SSH_KEY_FORMATS = [
+_SSH_KEY_FORMATS = (
     b"ssh-ed25519",
     b"ssh-rsa",
     b"ssh-dss",
     b"ecdsa-sha2-nistp256",
     b"ecdsa-sha2-nistp384",
     b"ecdsa-sha2-nistp521",
-]
+)
 
 
 def is_ssh_key(key: bytes) -> bool:
-    if any(string_value in key for string_value in _SSH_KEY_FORMATS):
-        return True
-
-    ssh_pubkey_match = _SSH_PUBKEY_RC.match(key)
-    if ssh_pubkey_match:
-        key_type = ssh_pubkey_match.group(1)
-        if _CERT_SUFFIX == key_type[-len(_CERT_SUFFIX) :]:
-            return True
-
-    return False
+    return key.startswith(_SSH_KEY_FORMATS)
diff --git a/requirements.txt b/requirements.txt
index bbbfe81e..0e7f8cf0 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -29,7 +29,7 @@ platformdirs==4.2.2
 plexapi==4.15.15
 portend==3.2.0
 profilehooks==1.12.0
-PyJWT==2.8.0
+PyJWT==2.9.0
 pyparsing==3.1.2
 python-dateutil==2.9.0.post0
 python-twitter==3.5

From 509d18801bc38e215272d35768248574a40af8b1 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 10 Aug 2024 19:18:37 -0700
Subject: [PATCH 639/743] Bump cloudinary from 1.40.0 to 1.41.0 (#2375)

* Bump cloudinary from 1.40.0 to 1.41.0

Bumps [cloudinary](https://github.com/cloudinary/pycloudinary) from 1.40.0 to 1.41.0.
- [Release notes](https://github.com/cloudinary/pycloudinary/releases)
- [Changelog](https://github.com/cloudinary/pycloudinary/blob/master/CHANGELOG.md)
- [Commits](https://github.com/cloudinary/pycloudinary/compare/1.40.0...1.41.0)

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

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

* Update cloudinary==1.41.0

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/cloudinary/__init__.py   |  2 +-
 lib/cloudinary/api.py        | 24 +++++++++++++++++++-----
 lib/cloudinary/auth_token.py |  2 +-
 lib/cloudinary/utils.py      |  2 +-
 requirements.txt             |  2 +-
 5 files changed, 23 insertions(+), 9 deletions(-)

diff --git a/lib/cloudinary/__init__.py b/lib/cloudinary/__init__.py
index f9b79955..877340c9 100644
--- a/lib/cloudinary/__init__.py
+++ b/lib/cloudinary/__init__.py
@@ -38,7 +38,7 @@ CL_BLANK = "data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAA
 URI_SCHEME = "cloudinary"
 API_VERSION = "v1_1"
 
-VERSION = "1.40.0"
+VERSION = "1.41.0"
 
 _USER_PLATFORM_DETAILS = "; ".join((platform(), "Python {}".format(python_version())))
 
diff --git a/lib/cloudinary/api.py b/lib/cloudinary/api.py
index 0ae0fb33..95543d32 100644
--- a/lib/cloudinary/api.py
+++ b/lib/cloudinary/api.py
@@ -543,10 +543,6 @@ def create_upload_preset(**options):
     return call_api("post", uri, params, **options)
 
 
-def create_folder(path, **options):
-    return call_api("post", ["folders", path], {}, **options)
-
-
 def root_folders(**options):
     return call_api("get", ["folders"], only(options, "next_cursor", "max_results"), **options)
 
@@ -555,6 +551,24 @@ def subfolders(of_folder_path, **options):
     return call_api("get", ["folders", of_folder_path], only(options, "next_cursor", "max_results"), **options)
 
 
+def create_folder(path, **options):
+    return call_api("post", ["folders", path], {}, **options)
+
+
+def rename_folder(from_path, to_path, **options):
+    """
+    Renames folder
+
+    :param from_path: The full path of an existing asset folder.
+    :param to_path:   The full path of the new asset folder.
+    :param options:   Additional options
+
+    :rtype: Response
+    """
+    params = {"to_folder": to_path}
+    return call_api("put", ["folders", from_path], params, **options)
+
+
 def delete_folder(path, **options):
     """Deletes folder
 
@@ -727,7 +741,7 @@ def update_metadata_field(field_external_id, field, **options):
 
 def __metadata_field_params(field):
     return only(field, "type", "external_id", "label", "mandatory", "restrictions",
-                "default_value", "validation", "datasource")
+                "default_value", "default_disabled", "validation", "datasource")
 
 
 def delete_metadata_field(field_external_id, **options):
diff --git a/lib/cloudinary/auth_token.py b/lib/cloudinary/auth_token.py
index 4f6c1fe1..8ddeacdf 100644
--- a/lib/cloudinary/auth_token.py
+++ b/lib/cloudinary/auth_token.py
@@ -11,7 +11,7 @@ AUTH_TOKEN_UNSAFE_RE = r'([ "#%&\'\/:;<=>?@\[\\\]^`{\|}~]+)'
 
 
 def generate(url=None, acl=None, start_time=None, duration=None,
-             expiration=None, ip=None, key=None, token_name=AUTH_TOKEN_NAME):
+             expiration=None, ip=None, key=None, token_name=AUTH_TOKEN_NAME, **_):
 
     if expiration is None:
         if duration is not None:
diff --git a/lib/cloudinary/utils.py b/lib/cloudinary/utils.py
index 1b7b7215..297bdb7a 100644
--- a/lib/cloudinary/utils.py
+++ b/lib/cloudinary/utils.py
@@ -820,7 +820,7 @@ def cloudinary_url(source, **options):
     transformation = re.sub(r'([^:])/+', r'\1/', transformation)
 
     signature = None
-    if sign_url and not auth_token:
+    if sign_url and (not auth_token or auth_token.pop('set_url_signature', False)):
         to_sign = "/".join(__compact([transformation, source_to_sign]))
         if long_url_signature:
             # Long signature forces SHA256
diff --git a/requirements.txt b/requirements.txt
index 0e7f8cf0..94a65531 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -6,7 +6,7 @@ bleach==6.1.0
 certifi==2024.7.4
 cheroot==10.0.1
 cherrypy==18.10.0
-cloudinary==1.40.0
+cloudinary==1.41.0
 distro==1.9.0
 dnspython==2.6.1
 facebook-sdk==3.1.0

From 7d4efac75d68be516e2008f0257d23be19ab3a56 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 10 Aug 2024 19:19:28 -0700
Subject: [PATCH 640/743] Bump tokenize-rt from 5.2.0 to 6.0.0 (#2376)

* Bump tokenize-rt from 5.2.0 to 6.0.0

Bumps [tokenize-rt](https://github.com/asottile/tokenize-rt) from 5.2.0 to 6.0.0.
- [Commits](https://github.com/asottile/tokenize-rt/compare/v5.2.0...v6.0.0)

---
updated-dependencies:
- dependency-name: tokenize-rt
  dependency-type: direct:production
  update-type: version-update:semver-major
...

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

* Update tokenize-rt==6.0.0

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/tokenize_rt.py | 7 ++++++-
 requirements.txt   | 2 +-
 2 files changed, 7 insertions(+), 2 deletions(-)

diff --git a/lib/tokenize_rt.py b/lib/tokenize_rt.py
index ae91cc40..9f12e01f 100644
--- a/lib/tokenize_rt.py
+++ b/lib/tokenize_rt.py
@@ -99,6 +99,11 @@ def src_to_tokens(src: str) -> list[Token]:
             end_offset += len(newtok.encode())
 
         tok_name = tokenize.tok_name[tok_type]
+
+        if tok_name == 'FSTRING_MIDDLE':  # pragma: >=3.12 cover
+            ecol += tok_text.count('{') + tok_text.count('}')
+            tok_text = tok_text.replace('{', '{{').replace('}', '}}')
+
         tokens.append(Token(tok_name, tok_text, sline, end_offset))
         last_line, last_col = eline, ecol
         if sline != eline:
@@ -115,7 +120,7 @@ def tokens_to_src(tokens: Iterable[Token]) -> str:
 
 def reversed_enumerate(
         tokens: Sequence[Token],
-) -> Generator[tuple[int, Token], None, None]:
+) -> Generator[tuple[int, Token]]:
     for i in reversed(range(len(tokens))):
         yield i, tokens[i]
 
diff --git a/requirements.txt b/requirements.txt
index 94a65531..d0ee1941 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -40,7 +40,7 @@ rumps==0.4.0; platform_system == "Darwin"
 simplejson==3.19.2
 six==1.16.0
 tempora==5.7.0
-tokenize-rt==5.2.0
+tokenize-rt==6.0.0
 tzdata==2024.1
 tzlocal==5.0.1
 urllib3<2

From fb4f0046f3added3cd1d57f3d398eaf201803eb6 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 10 Aug 2024 19:20:21 -0700
Subject: [PATCH 641/743] Bump pyopenssl from 24.1.0 to 24.2.1 (#2368)

Bumps [pyopenssl](https://github.com/pyca/pyopenssl) from 24.1.0 to 24.2.1.
- [Changelog](https://github.com/pyca/pyopenssl/blob/main/CHANGELOG.rst)
- [Commits](https://github.com/pyca/pyopenssl/compare/24.1.0...24.2.1)

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

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 package/requirements-package.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index 0eed49c9..484bdc55 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -2,7 +2,7 @@ apscheduler==3.10.1
 importlib-metadata==8.2.0
 importlib-resources==6.4.0
 pyinstaller==6.8.0
-pyopenssl==24.1.0
+pyopenssl==24.2.1
 pycryptodomex==3.20.0
 
 pyobjc-core==10.3.1; platform_system == "Darwin"

From cfd81684b7bfb4e330b2612bc132587922df7619 Mon Sep 17 00:00:00 2001
From: Teodor-Stelian Baltaretu <teodorstelian98@yahoo.com>
Date: Sun, 11 Aug 2024 05:24:06 +0300
Subject: [PATCH 642/743] Removed deprecated getdefaultlocale (#2345) (#2364)

* Removed deprecated getdefaultlocale (#2345)

* Added Special Case For Windows (#2345)

* Refactored the changes into a cleaner code with comments (#2345)

* Changed the encoding method used and the selection of language

* Removed hardcoded encoding in Windows handling
---
 Tautulli.py | 23 +++++++++++++++++++++--
 1 file changed, 21 insertions(+), 2 deletions(-)

diff --git a/Tautulli.py b/Tautulli.py
index 8616df81..200cd39d 100755
--- a/Tautulli.py
+++ b/Tautulli.py
@@ -34,6 +34,7 @@ import shutil
 import time
 import threading
 import tzlocal
+import ctypes
 
 import plexpy
 from plexpy import common, config, database, helpers, logger, webstart
@@ -69,8 +70,26 @@ def main():
     plexpy.SYS_ENCODING = None
 
     try:
-        locale.setlocale(locale.LC_ALL, "")
-        plexpy.SYS_LANGUAGE, plexpy.SYS_ENCODING = locale.getdefaultlocale()
+
+        # Attempt to get the system's locale settings
+        language_code, encoding = locale.getlocale()
+
+        # Special handling for Windows platform
+        if sys.platform == 'win32':
+            # Get the user's current language settings on Windows
+            windll = ctypes.windll.kernel32
+            lang_id = windll.GetUserDefaultLCID()
+
+            # Map Windows language ID to locale identifier
+            language_code = locale.windows_locale.get(lang_id, '')
+
+        # Get the preferred encoding
+        encoding = locale.getpreferredencoding()
+
+        # Assign values to application-specific variable
+        plexpy.SYS_LANGUAGE = language_code
+        plexpy.SYS_ENCODING = encoding
+
     except (locale.Error, IOError):
         pass
 

From 3fb46a9ab78e5d153b853570297918497be827de Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 10 Aug 2024 19:30:12 -0700
Subject: [PATCH 643/743] Update workflow snapcraft actions branch

---
 .github/workflows/publish-snap.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/publish-snap.yml b/.github/workflows/publish-snap.yml
index 539282e1..b3898a38 100644
--- a/.github/workflows/publish-snap.yml
+++ b/.github/workflows/publish-snap.yml
@@ -38,7 +38,7 @@ jobs:
         uses: docker/setup-qemu-action@v3
 
       - name: Build Snap Package
-        uses: diddlesnaps/snapcraft-multiarch-action@v1
+        uses: diddlesnaps/snapcraft-multiarch-action@master
         id: build
         with:
           architecture: ${{ matrix.architecture }}
@@ -50,7 +50,7 @@ jobs:
           path: ${{ steps.build.outputs.snap }}
 
       - name: Review Snap Package
-        uses: diddlesnaps/snapcraft-review-tools-action@v1
+        uses: diddlesnaps/snapcraft-review-tools-action@master
         with:
           snap: ${{ steps.build.outputs.snap }}
 

From 623a9f291926fd279bc2f15e17d40429e1d78219 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 10 Aug 2024 19:41:23 -0700
Subject: [PATCH 644/743] v2.14.4

---
 CHANGELOG.md      | 11 +++++++++++
 plexpy/version.py |  2 +-
 2 files changed, 12 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 22e42d9b..4ad54157 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,16 @@
 # Changelog
 
+## v2.14.4 (2024-08-10)
+
+* Notifications:
+  * Fix: Update Slack notification info card.
+  * New: Added ntfy notification agent. (Thanks @nwithan8) (#2356, #2000)
+* UI:
+  * Fix: macOS platform capitalization.
+* Other:
+  * Fix: Remove deprecated getdefaultlocale (Thanks @teodorstelian) (#2364, #2345)
+
+
 ## v2.14.3 (2024-06-19)
 
 * Graphs:
diff --git a/plexpy/version.py b/plexpy/version.py
index 94da76a1..feccd9cc 100644
--- a/plexpy/version.py
+++ b/plexpy/version.py
@@ -16,4 +16,4 @@
 #  along with Tautulli.  If not, see <http://www.gnu.org/licenses/>.
 
 PLEXPY_BRANCH = "master"
-PLEXPY_RELEASE_VERSION = "v2.14.3"
\ No newline at end of file
+PLEXPY_RELEASE_VERSION = "v2.14.4"
\ No newline at end of file

From cf8fb2e65d568ffc4f6eecd77a835408f6b123d2 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 16 Aug 2024 19:32:53 -0700
Subject: [PATCH 645/743] Catch exception trying to remove PID file

---
 plexpy/__init__.py | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/plexpy/__init__.py b/plexpy/__init__.py
index 21b5ef6d..0c782752 100644
--- a/plexpy/__init__.py
+++ b/plexpy/__init__.py
@@ -2815,8 +2815,11 @@ def shutdown(restart=False, update=False, checkout=False, reset=False):
             logger.warn("Tautulli failed to reset git install: %s. Restarting." % e)
 
     if CREATEPID:
-        logger.info("Removing pidfile %s", PIDFILE)
-        os.remove(PIDFILE)
+        logger.info("Removing PID file: %s", PIDFILE)
+        try:
+            os.remove(PIDFILE)
+        except OSError:
+            logger.warn("Failed to remove PID file '%s'", PIDFILE)
 
     if restart:
         logger.info("Tautulli is restarting...")

From 14c9c7a3936bf764a49475b5efdd8c07de8e65a0 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 16 Aug 2024 20:00:17 -0700
Subject: [PATCH 646/743] Replace PyCryptodome with Cryptography

---
 package/requirements-package.txt |  2 +-
 plexpy/notifiers.py              | 42 +++++++++++++-------------------
 2 files changed, 18 insertions(+), 26 deletions(-)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index 484bdc55..9ac6fba1 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -1,9 +1,9 @@
 apscheduler==3.10.1
+cryptography==43.0.0
 importlib-metadata==8.2.0
 importlib-resources==6.4.0
 pyinstaller==6.8.0
 pyopenssl==24.2.1
-pycryptodomex==3.20.0
 
 pyobjc-core==10.3.1; platform_system == "Darwin"
 pyobjc-framework-Cocoa==10.3.1; platform_system == "Darwin"
diff --git a/plexpy/notifiers.py b/plexpy/notifiers.py
index dbd0cccf..ea538544 100644
--- a/plexpy/notifiers.py
+++ b/plexpy/notifiers.py
@@ -38,20 +38,12 @@ import requests
 from requests.auth import HTTPBasicAuth
 
 try:
-    from Cryptodome.Protocol.KDF import PBKDF2
-    from Cryptodome.Cipher import AES
-    from Cryptodome.Random import get_random_bytes
-    from Cryptodome.Hash import SHA256
-    CRYPTODOME = True
+    from cryptography.hazmat.primitives import hashes
+    from cryptography.hazmat.primitives.ciphers.aead import AESGCM
+    from cryptography.hazmat.primitives.kdf.pbkdf2 import PBKDF2HMAC
+    _CRYPTOGRAPHY = True
 except ImportError:
-    try:
-        from Crypto.Protocol.KDF import PBKDF2
-        from Crypto.Cipher import AES
-        from Crypto.Random import get_random_bytes
-        from Crypto.Hash import SHA256
-        CRYPTODOME = True
-    except ImportError:
-        CRYPTODOME = False
+    _CRYPTOGRAPHY = False
 
 import gntp.notifier
 import facebook
@@ -4030,21 +4022,21 @@ class TAUTULLIREMOTEAPP(Notifier):
 
         #logger.debug("Plaintext data: {}".format(plaintext_data))
 
-        if CRYPTODOME:
+        if _CRYPTOGRAPHY:
             # Key generation
-            salt = get_random_bytes(16)
+            salt = os.urandom(16)
             passphrase = device['device_token']
             key_length = 32  # AES256
             iterations = 600000
-            key = PBKDF2(passphrase, salt, dkLen=key_length, count=iterations, hmac_hash_module=SHA256)
+            kdf = PBKDF2HMAC(algorithm=hashes.SHA256(), length=key_length, salt=salt, iterations=iterations)
+            key = kdf.derive(passphrase.encode())
 
             #logger.debug("Encryption key (base64): {}".format(base64.b64encode(key)))
 
             # Encrypt using AES GCM
-            nonce = get_random_bytes(16)
-            cipher = AES.new(key, AES.MODE_GCM, nonce)
-            encrypted_data, gcm_tag = cipher.encrypt_and_digest(json.dumps(plaintext_data).encode('utf-8'))
-            encrypted_data += gcm_tag
+            nonce = os.urandom(16)
+            cipher = AESGCM(key)
+            encrypted_data = cipher.encrypt(nonce, json.dumps(plaintext_data).encode('utf-8'), None)
 
             #logger.debug("Encrypted data (base64): {}".format(base64.b64encode(encrypted_data)))
             #logger.debug("GCM tag (base64): {}".format(base64.b64encode(gcm_tag)))
@@ -4062,7 +4054,7 @@ class TAUTULLIREMOTEAPP(Notifier):
                                 'server_id': plexpy.CONFIG.PMS_UUID}
                        }
         else:
-            logger.warn("Tautulli Notifiers :: PyCryptodome library is missing. "
+            logger.warn("Tautulli Notifiers :: Cryptography library is missing. "
                         "Tautulli Remote app notifications will be sent unecrypted. "
                         "Install the library to encrypt the notifications.")
 
@@ -4094,22 +4086,22 @@ class TAUTULLIREMOTEAPP(Notifier):
     def _return_config_options(self):
         config_option = []
 
-        if not CRYPTODOME:
+        if not _CRYPTOGRAPHY:
             config_option.append({
                 'label': 'Warning',
-                'description': '<strong>The PyCryptodome library is missing. '
+                'description': '<strong>The Cryptography library is missing. '
                                'The content of your notifications will be sent unencrypted!</strong><br>'
                                'Please install the library to encrypt the notification contents. '
                                'Instructions can be found in the '
                                '<a href="' + helpers.anon_url(
-                                 'https://github.com/%s/%s/wiki/Frequently-Asked-Questions#notifications-pycryptodome'
+                                 'https://github.com/%s/%s/wiki/Frequently-Asked-Questions#notifications-cryptography'
                                  % (plexpy.CONFIG.GIT_USER, plexpy.CONFIG.GIT_REPO)) + '" target="_blank" rel="noreferrer">FAQ</a>.' ,
                 'input_type': 'help'
             })
         else:
             config_option.append({
                 'label': 'Note',
-                'description': 'The PyCryptodome library was found. '
+                'description': 'The Cryptography library was found. '
                                'The content of your notifications will be sent encrypted!',
                 'input_type': 'help'
             })

From 5cf39cb09724ac11ddb9a88d1021171869e7743d Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 17 Aug 2024 11:27:17 -0700
Subject: [PATCH 647/743] Add Docker image labels

---
 .github/workflows/publish-docker.yml | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/publish-docker.yml b/.github/workflows/publish-docker.yml
index 41ccb093..62c3f86c 100644
--- a/.github/workflows/publish-docker.yml
+++ b/.github/workflows/publish-docker.yml
@@ -33,7 +33,6 @@ jobs:
             echo "branch=${GITHUB_REF#refs/heads/}" >> $GITHUB_OUTPUT
           fi
           echo "commit=${GITHUB_SHA}" >> $GITHUB_OUTPUT
-          echo "build_date=$(date -u +'%Y-%m-%dT%H:%M:%SZ')" >> $GITHUB_OUTPUT
           echo "docker_platforms=linux/amd64,linux/arm64/v8,linux/arm/v7,linux/arm/v6" >> $GITHUB_OUTPUT
           echo "docker_image=${{ secrets.DOCKER_REPO }}/tautulli" >> $GITHUB_OUTPUT
 
@@ -59,7 +58,7 @@ jobs:
         if: success()
         with:
           username: ${{ secrets.DOCKER_USERNAME }}
-          password: ${{ secrets.DOCKER_PASSWORD }}
+          password: ${{ secrets.DOCKER_TOKEN }}
 
       - name: Login to GitHub Container Registry
         uses: docker/login-action@v3
@@ -69,6 +68,12 @@ jobs:
           username: ${{ secrets.DOCKER_USERNAME }}
           password: ${{ secrets.GHCR_TOKEN }}
 
+      - name: Extract Docker Metadata
+        id: metadata
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{ steps.prepare.outputs.docker_image }}
+
       - name: Docker Build and Push
         uses: docker/build-push-action@v6
         if: success()
@@ -81,10 +86,10 @@ jobs:
             TAG=${{ steps.prepare.outputs.tag }}
             BRANCH=${{ steps.prepare.outputs.branch }}
             COMMIT=${{ steps.prepare.outputs.commit }}
-            BUILD_DATE=${{ steps.prepare.outputs.build_date }}
           tags: |
             ${{ steps.prepare.outputs.docker_image }}:${{ steps.prepare.outputs.tag }}
             ghcr.io/${{ steps.prepare.outputs.docker_image }}:${{ steps.prepare.outputs.tag }}
+          labels: ${{ steps.metadata.outputs.labels }}
           cache-from: type=local,src=/tmp/.buildx-cache
           cache-to: type=local,dest=/tmp/.buildx-cache
 

From 330b8a3a8238ff50506645b35f17fdb015aa9d60 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 31 Aug 2024 16:10:00 -0700
Subject: [PATCH 648/743] Encode ntfy payload

---
 plexpy/notifiers.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/plexpy/notifiers.py b/plexpy/notifiers.py
index ea538544..eb63df33 100644
--- a/plexpy/notifiers.py
+++ b/plexpy/notifiers.py
@@ -2614,7 +2614,7 @@ class NTFY(Notifier):
         method = "POST"
         url = f"{self.config['host']}/{self.config['topic']}"
         params = {}
-        data = body
+        data = body.encode('utf-8')
         headers = {
             'Priority': self.config['priority'],
             'Authorization': f'Bearer {self.config["access_token"]}',
@@ -2623,7 +2623,7 @@ class NTFY(Notifier):
 
         # Add optional subject
         if self.config['incl_subject']:
-            headers['Title'] = subject
+            headers['Title'] = subject.encode('utf-8')
 
         # Add optional parameters (dependent on notification type + metadata extraction)
         if kwargs.get('parameters', {}).get('media_type'):
@@ -2634,7 +2634,7 @@ class NTFY(Notifier):
             if self.config['incl_description']:
                 description = pretty_metadata.get_description()
                 if description:
-                    data = f"{data}\n\n{description}"
+                    data += f"\n\n{description}".encode('utf-8')
 
             # Add optional poster
             if self.config['incl_poster']:

From ac322971600fad9ce21b574cf38543029881e9fd Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Wed, 4 Sep 2024 13:28:54 -0700
Subject: [PATCH 649/743] Close database connection on garbage collection

---
 plexpy/database.py | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/plexpy/database.py b/plexpy/database.py
index 4762805f..e70d6c77 100644
--- a/plexpy/database.py
+++ b/plexpy/database.py
@@ -490,4 +490,8 @@ class MonitorDatabase(object):
         # Get the last insert row id
         result = self.select_single(query="SELECT last_insert_rowid() AS last_id")
         if result:
-            return result.get('last_id', None)
\ No newline at end of file
+            return result.get('last_id', None)
+        
+    def __del__(self):
+        # Close the database connection when object is garbage collected
+        self.connection.close()

From 596cf57d616dd9d9c70715e8014a1eb86775a836 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 15 Sep 2024 14:26:45 -0700
Subject: [PATCH 650/743] Do no initialize db connection in ActivityProcessor

---
 plexpy/activity_processor.py | 82 ++++++++++++++++++++++--------------
 1 file changed, 51 insertions(+), 31 deletions(-)

diff --git a/plexpy/activity_processor.py b/plexpy/activity_processor.py
index 952d8e59..db0545da 100644
--- a/plexpy/activity_processor.py
+++ b/plexpy/activity_processor.py
@@ -27,11 +27,10 @@ from plexpy import users
 
 class ActivityProcessor(object):
 
-    def __init__(self):
-        self.db = database.MonitorDatabase()
-
     def write_session(self, session=None, notify=True):
         if session:
+            db = database.MonitorDatabase()
+
             values = {'session_key': session.get('session_key', ''),
                       'session_id': session.get('session_id', ''),
                       'transcode_key': session.get('transcode_key', ''),
@@ -149,7 +148,7 @@ class ActivityProcessor(object):
             keys = {'session_key': session.get('session_key', ''),
                     'rating_key': session.get('rating_key', '')}
 
-            result = self.db.upsert('sessions', values, keys)
+            result = db.upsert('sessions', values, keys)
 
             if result == 'insert':
                 # If it's our first write then time stamp it.
@@ -159,7 +158,7 @@ class ActivityProcessor(object):
                                                         media_type=values['media_type'],
                                                         started=started)
                 timestamp = {'started': started, 'initial_stream': initial_stream}
-                self.db.upsert('sessions', timestamp, keys)
+                db.upsert('sessions', timestamp, keys)
 
                 # Check if any notification agents have notifications enabled
                 if notify:
@@ -260,6 +259,8 @@ class ActivityProcessor(object):
                 logger.debug("Tautulli ActivityProcessor :: History logging for library '%s' is disabled." % library_details['section_name'])
 
             if logging_enabled:
+                db = database.MonitorDatabase()
+
                 media_info = {}
 
                 # Fetch metadata first so we can return false if it fails
@@ -316,10 +317,10 @@ class ActivityProcessor(object):
 
                 # logger.debug("Tautulli ActivityProcessor :: Writing sessionKey %s session_history transaction..."
                 #              % session['session_key'])
-                self.db.upsert(table_name='session_history', key_dict=keys, value_dict=values)
+                db.upsert(table_name='session_history', key_dict=keys, value_dict=values)
 
                 # Get the last insert row id
-                last_id = self.db.last_insert_id()
+                last_id = db.last_insert_id()
                 self.group_history(last_id, session, metadata)
                 
                 # logger.debug("Tautulli ActivityProcessor :: Successfully written history item, last id for session_history is %s"
@@ -410,7 +411,7 @@ class ActivityProcessor(object):
 
                 # logger.debug("Tautulli ActivityProcessor :: Writing sessionKey %s session_history_media_info transaction..."
                 #              % session['session_key'])
-                self.db.upsert(table_name='session_history_media_info', key_dict=keys, value_dict=values)
+                db.upsert(table_name='session_history_media_info', key_dict=keys, value_dict=values)
 
                 # Write the session_history_metadata table
                 directors = ";".join(metadata['directors'])
@@ -475,7 +476,7 @@ class ActivityProcessor(object):
 
                 # logger.debug("Tautulli ActivityProcessor :: Writing sessionKey %s session_history_metadata transaction..."
                 #              % session['session_key'])
-                self.db.upsert(table_name='session_history_metadata', key_dict=keys, value_dict=values)
+                db.upsert(table_name='session_history_metadata', key_dict=keys, value_dict=values)
 
             # Return the session row id when the session is successfully written to the database
             return session['id']
@@ -484,6 +485,8 @@ class ActivityProcessor(object):
         new_session = prev_session = None
         prev_watched = None
 
+        db = database.MonitorDatabase()
+
         if session['live']:
             # Check if we should group the session, select the last guid from the user within the last day
             query = "SELECT session_history.id, session_history_metadata.guid, session_history.reference_id " \
@@ -495,7 +498,7 @@ class ActivityProcessor(object):
 
             args = [last_id, session['user_id']]
 
-            result = self.db.select(query=query, args=args)
+            result = db.select(query=query, args=args)
 
             if len(result) > 0:
                 new_session = {'id': last_id,
@@ -515,7 +518,7 @@ class ActivityProcessor(object):
 
             args = [last_id, session['user_id'], session['rating_key']]
 
-            result = self.db.select(query=query, args=args)
+            result = db.select(query=query, args=args)
 
             if len(result) > 1:
                 new_session = {'id': result[0]['id'],
@@ -558,9 +561,10 @@ class ActivityProcessor(object):
                 logger.debug("Tautulli ActivityProcessor :: Not grouping history for sessionKey %s", session['session_key'])
             args = [last_id, last_id]
 
-        self.db.action(query=query, args=args)
+        db.action(query=query, args=args)
 
     def get_sessions(self, user_id=None, ip_address=None):
+        db = database.MonitorDatabase()
         query = "SELECT * FROM sessions"
         args = []
 
@@ -569,12 +573,13 @@ class ActivityProcessor(object):
             query += " WHERE user_id = ?" + ip
             args.append(user_id)
 
-        sessions = self.db.select(query, args)
+        sessions = db.select(query, args)
         return sessions
 
     def get_session_by_key(self, session_key=None):
+        db = database.MonitorDatabase()
         if str(session_key).isdigit():
-            session = self.db.select_single("SELECT * FROM sessions "
+            session = db.select_single("SELECT * FROM sessions "
                                             "WHERE session_key = ? ",
                                             args=[session_key])
             if session:
@@ -583,8 +588,9 @@ class ActivityProcessor(object):
         return None
 
     def get_session_by_id(self, session_id=None):
+        db = database.MonitorDatabase()
         if session_id:
-            session = self.db.select_single("SELECT * FROM sessions "
+            session = db.select_single("SELECT * FROM sessions "
                                             "WHERE session_id = ? ",
                                             args=[session_id])
             if session:
@@ -593,6 +599,7 @@ class ActivityProcessor(object):
         return None
 
     def set_session_state(self, session_key=None, state=None, **kwargs):
+        db = database.MonitorDatabase()
         if str(session_key).isdigit():
             values = {}
 
@@ -603,21 +610,23 @@ class ActivityProcessor(object):
                 values[k] = v
 
             keys = {'session_key': session_key}
-            result = self.db.upsert('sessions', values, keys)
+            result = db.upsert('sessions', values, keys)
 
             return result
 
         return None
 
     def delete_session(self, session_key=None, row_id=None):
+        db = database.MonitorDatabase()
         if str(session_key).isdigit():
-            self.db.action("DELETE FROM sessions WHERE session_key = ?", [session_key])
+            db.action("DELETE FROM sessions WHERE session_key = ?", [session_key])
         elif str(row_id).isdigit():
-            self.db.action("DELETE FROM sessions WHERE id = ?", [row_id])
+            db.action("DELETE FROM sessions WHERE id = ?", [row_id])
 
     def set_session_last_paused(self, session_key=None, timestamp=None):
+        db = database.MonitorDatabase()
         if str(session_key).isdigit():
-            result = self.db.select("SELECT last_paused, paused_counter "
+            result = db.select("SELECT last_paused, paused_counter "
                                     "FROM sessions "
                                     "WHERE session_key = ?", args=[session_key])
 
@@ -636,17 +645,19 @@ class ActivityProcessor(object):
                 values['paused_counter'] = paused_counter
 
             keys = {'session_key': session_key}
-            self.db.upsert('sessions', values, keys)
+            db.upsert('sessions', values, keys)
 
     def increment_session_buffer_count(self, session_key=None):
+        db = database.MonitorDatabase()
         if str(session_key).isdigit():
-            self.db.action("UPDATE sessions SET buffer_count = buffer_count + 1 "
+            db.action("UPDATE sessions SET buffer_count = buffer_count + 1 "
                            "WHERE session_key = ?",
                            [session_key])
 
     def get_session_buffer_count(self, session_key=None):
+        db = database.MonitorDatabase()
         if str(session_key).isdigit():
-            buffer_count = self.db.select_single("SELECT buffer_count "
+            buffer_count = db.select_single("SELECT buffer_count "
                                                  "FROM sessions "
                                                  "WHERE session_key = ?",
                                                  [session_key])
@@ -656,14 +667,16 @@ class ActivityProcessor(object):
             return 0
 
     def set_session_buffer_trigger_time(self, session_key=None):
+        db = database.MonitorDatabase()
         if str(session_key).isdigit():
-            self.db.action("UPDATE sessions SET buffer_last_triggered = strftime('%s', 'now') "
+            db.action("UPDATE sessions SET buffer_last_triggered = strftime('%s', 'now') "
                            "WHERE session_key = ?",
                            [session_key])
 
     def get_session_buffer_trigger_time(self, session_key=None):
+        db = database.MonitorDatabase()
         if str(session_key).isdigit():
-            last_time = self.db.select_single("SELECT buffer_last_triggered "
+            last_time = db.select_single("SELECT buffer_last_triggered "
                                               "FROM sessions "
                                               "WHERE session_key = ?",
                                               [session_key])
@@ -673,37 +686,43 @@ class ActivityProcessor(object):
             return None
 
     def set_temp_stopped(self):
+        db = database.MonitorDatabase()
         stopped_time = helpers.timestamp()
-        self.db.action("UPDATE sessions SET stopped = ?", [stopped_time])
+        db.action("UPDATE sessions SET stopped = ?", [stopped_time])
 
     def increment_write_attempts(self, session_key=None):
+        db = database.MonitorDatabase()
         if str(session_key).isdigit():
             session = self.get_session_by_key(session_key=session_key)
-            self.db.action("UPDATE sessions SET write_attempts = ? WHERE session_key = ?",
+            db.action("UPDATE sessions SET write_attempts = ? WHERE session_key = ?",
                            [session['write_attempts'] + 1, session_key])
 
     def set_marker(self, session_key=None, marker_idx=None, marker_type=None):
+        db = database.MonitorDatabase()
         marker_args = [
             int(marker_type == 'intro'),
             int(marker_type == 'commercial'),
             int(marker_type == 'credits')
         ]
-        self.db.action("UPDATE sessions SET intro = ?, commercial = ?, credits = ?, marker = ? "
+        db.action("UPDATE sessions SET intro = ?, commercial = ?, credits = ?, marker = ? "
                        "WHERE session_key = ?",
                        marker_args + [marker_idx, session_key])
 
     def set_watched(self, session_key=None):
-        self.db.action("UPDATE sessions SET watched = ? "
+        db = database.MonitorDatabase()
+        db.action("UPDATE sessions SET watched = ? "
                        "WHERE session_key = ?",
                        [1, session_key])
 
     def write_continued_session(self, user_id=None, machine_id=None, media_type=None, stopped=None):
+        db = database.MonitorDatabase()
         keys = {'user_id': user_id, 'machine_id': machine_id, 'media_type': media_type}
         values = {'stopped': stopped}
-        self.db.upsert(table_name='sessions_continued', key_dict=keys, value_dict=values)
+        db.upsert(table_name='sessions_continued', key_dict=keys, value_dict=values)
 
     def is_initial_stream(self, user_id=None, machine_id=None, media_type=None, started=None):
-        last_session = self.db.select_single("SELECT stopped "
+        db = database.MonitorDatabase()
+        last_session = db.select_single("SELECT stopped "
                                              "FROM sessions_continued "
                                              "WHERE user_id = ? AND machine_id = ? AND media_type = ? "
                                              "ORDER BY stopped DESC",
@@ -717,11 +736,12 @@ class ActivityProcessor(object):
 
         logger.info("Tautulli ActivityProcessor :: Regrouping session history...")
 
+        db = database.MonitorDatabase()
         query = (
             "SELECT * FROM session_history "
             "JOIN session_history_metadata ON session_history.id = session_history_metadata.id"
         )
-        results = self.db.select(query)
+        results = db.select(query)
         count = len(results)
         progress = 0
 

From de697cb2ca995292feef43fc28fb13fb17b4d726 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 15 Sep 2024 14:27:05 -0700
Subject: [PATCH 651/743] Add 2k resolution override

---
 plexpy/common.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/plexpy/common.py b/plexpy/common.py
index 8d68e2ad..59c8aeaa 100644
--- a/plexpy/common.py
+++ b/plexpy/common.py
@@ -170,6 +170,7 @@ AUDIO_CODEC_OVERRIDES = {
 
 VIDEO_RESOLUTION_OVERRIDES = {
     'sd': 'SD',
+    '2k': '2k',
     '4k': '4k'
 }
 

From cc1a325eac71b3150b813986bb6bd4a0a38203f9 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Fri, 20 Sep 2024 20:24:00 -0700
Subject: [PATCH 652/743] Bump plexapi from 4.15.15 to 4.15.16 (#2383)

* Bump plexapi from 4.15.15 to 4.15.16

Bumps [plexapi](https://github.com/pkkid/python-plexapi) from 4.15.15 to 4.15.16.
- [Release notes](https://github.com/pkkid/python-plexapi/releases)
- [Commits](https://github.com/pkkid/python-plexapi/compare/4.15.15...4.15.16)

---
updated-dependencies:
- dependency-name: plexapi
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

* Update plexapi==4.15.16

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/plexapi/audio.py      | 19 ++++++++++++
 lib/plexapi/base.py       | 61 +++++++++++++++++++++++----------------
 lib/plexapi/client.py     |  2 +-
 lib/plexapi/collection.py |  2 ++
 lib/plexapi/const.py      |  2 +-
 lib/plexapi/library.py    |  3 +-
 lib/plexapi/media.py      | 26 +++++++++++++++++
 lib/plexapi/mixins.py     | 14 ++++-----
 lib/plexapi/myplex.py     |  2 +-
 lib/plexapi/server.py     |  2 +-
 lib/plexapi/utils.py      | 43 +++++++++++++++++++++++++++
 lib/plexapi/video.py      | 20 +++++++++----
 requirements.txt          |  2 +-
 13 files changed, 153 insertions(+), 45 deletions(-)

diff --git a/lib/plexapi/audio.py b/lib/plexapi/audio.py
index 8f84f3be..686073a3 100644
--- a/lib/plexapi/audio.py
+++ b/lib/plexapi/audio.py
@@ -193,6 +193,7 @@ class Artist(
             similar (List<:class:`~plexapi.media.Similar`>): List of similar objects.
             styles (List<:class:`~plexapi.media.Style`>): List of style objects.
             theme (str): URL to theme resource (/library/metadata/<ratingkey>/theme/<themeid>).
+            ultraBlurColors (:class:`~plexapi.media.UltraBlurColors`): Ultra blur color object.
     """
     TAG = 'Directory'
     TYPE = 'artist'
@@ -213,6 +214,7 @@ class Artist(
         self.similar = self.findItems(data, media.Similar)
         self.styles = self.findItems(data, media.Style)
         self.theme = data.attrib.get('theme')
+        self.ultraBlurColors = self.findItem(data, media.UltraBlurColors)
 
     def __iter__(self):
         for album in self.albums():
@@ -281,6 +283,21 @@ class Artist(
             filepaths += track.download(_savepath, keep_original_name, **kwargs)
         return filepaths
 
+    def popularTracks(self):
+        """ Returns a list of :class:`~plexapi.audio.Track` popular tracks by the artist. """
+        filters = {
+            'album.subformat!': 'Compilation,Live',
+            'artist.id': self.ratingKey,
+            'group': 'title',
+            'ratingCount>>': 0,
+        }
+        return self.section().search(
+            libtype='track',
+            filters=filters,
+            sort='ratingCount:desc',
+            limit=100
+        )
+
     def station(self):
         """ Returns a :class:`~plexapi.playlist.Playlist` artist radio station or `None`. """
         key = f'{self.key}?includeStations=1'
@@ -325,6 +342,7 @@ class Album(
             studio (str): Studio that released the album.
             styles (List<:class:`~plexapi.media.Style`>): List of style objects.
             subformats (List<:class:`~plexapi.media.Subformat`>): List of subformat objects.
+            ultraBlurColors (:class:`~plexapi.media.UltraBlurColors`): Ultra blur color object.
             viewedLeafCount (int): Number of items marked as played in the album view.
             year (int): Year the album was released.
     """
@@ -354,6 +372,7 @@ class Album(
         self.studio = data.attrib.get('studio')
         self.styles = self.findItems(data, media.Style)
         self.subformats = self.findItems(data, media.Subformat)
+        self.ultraBlurColors = self.findItem(data, media.UltraBlurColors)
         self.viewedLeafCount = utils.cast(int, data.attrib.get('viewedLeafCount'))
         self.year = utils.cast(int, data.attrib.get('year'))
 
diff --git a/lib/plexapi/base.py b/lib/plexapi/base.py
index 26b103b9..a7fa82ee 100644
--- a/lib/plexapi/base.py
+++ b/lib/plexapi/base.py
@@ -3,7 +3,7 @@ import re
 from typing import TYPE_CHECKING, Generic, Iterable, List, Optional, TypeVar, Union
 import weakref
 from functools import cached_property
-from urllib.parse import urlencode
+from urllib.parse import parse_qsl, urlencode, urlparse
 from xml.etree import ElementTree
 from xml.etree.ElementTree import Element
 
@@ -391,10 +391,9 @@ class PlexObject:
 
             Parameters:
                 key (string, optional): Override the key to reload.
-                **kwargs (dict): A dictionary of XML include parameters to exclude or override.
-                    All parameters are included by default with the option to override each parameter
-                    or disable each parameter individually by setting it to False or 0.
+                **kwargs (dict): A dictionary of XML include parameters to include/exclude or override.
                     See :class:`~plexapi.base.PlexPartialObject` for all the available include parameters.
+                    Set parameter to True to include and False to exclude.
 
             Example:
 
@@ -402,20 +401,28 @@ class PlexObject:
 
                     from plexapi.server import PlexServer
                     plex = PlexServer('http://localhost:32400', token='xxxxxxxxxxxxxxxxxxxx')
-                    movie = plex.library.section('Movies').get('Cars')
 
-                    # Partial reload of the movie without the `checkFiles` parameter.
-                    # Excluding `checkFiles` will prevent the Plex server from reading the
-                    # file to check if the file still exists and is accessible.
-                    # The movie object will remain as a partial object.
-                    movie.reload(checkFiles=False)
+                    # Search results are partial objects.
+                    movie = plex.library.section('Movies').get('Cars')
                     movie.isPartialObject()  # Returns True
 
-                    # Full reload of the movie with all include parameters.
+                    # Partial reload of the movie without a default include parameter.
+                    # The movie object will remain as a partial object.
+                    movie.reload(includeMarkers=False)
+                    movie.isPartialObject()  # Returns True
+
+                    # Full reload of the movie with all default include parameters.
                     # The movie object will be a full object.
                     movie.reload()
                     movie.isFullObject()  # Returns True
 
+                    # Full reload of the movie with all default and extra include parameter.
+                    # Including `checkFiles` will tell the Plex server to check if the file
+                    # still exists and is accessible.
+                    # The movie object will be a full object.
+                    movie.reload(checkFiles=True)
+                    movie.isFullObject()  # Returns True
+
         """
         return self._reload(key=key, **kwargs)
 
@@ -505,25 +512,25 @@ class PlexPartialObject(PlexObject):
         automatically and update itself.
     """
     _INCLUDES = {
-        'checkFiles': 1,
-        'includeAllConcerts': 1,
+        'checkFiles': 0,
+        'includeAllConcerts': 0,
         'includeBandwidths': 1,
         'includeChapters': 1,
-        'includeChildren': 1,
-        'includeConcerts': 1,
-        'includeExternalMedia': 1,
-        'includeExtras': 1,
+        'includeChildren': 0,
+        'includeConcerts': 0,
+        'includeExternalMedia': 0,
+        'includeExtras': 0,
         'includeFields': 'thumbBlurHash,artBlurHash',
         'includeGeolocation': 1,
         'includeLoudnessRamps': 1,
         'includeMarkers': 1,
-        'includeOnDeck': 1,
-        'includePopularLeaves': 1,
-        'includePreferences': 1,
-        'includeRelated': 1,
-        'includeRelatedCount': 1,
-        'includeReviews': 1,
-        'includeStations': 1,
+        'includeOnDeck': 0,
+        'includePopularLeaves': 0,
+        'includePreferences': 0,
+        'includeRelated': 0,
+        'includeRelatedCount': 0,
+        'includeReviews': 0,
+        'includeStations': 0,
     }
     _EXCLUDES = {
         'excludeElements': (
@@ -592,7 +599,11 @@ class PlexPartialObject(PlexObject):
             search result for a movie often only contain a portion of the attributes a full
             object (main url) for that movie would contain.
         """
-        return not self.key or (self._details_key or self.key) == self._initpath
+        parsed_key = urlparse(self._details_key or self.key)
+        parsed_initpath = urlparse(self._initpath)
+        query_key = set(parse_qsl(parsed_key.query))
+        query_init = set(parse_qsl(parsed_initpath.query))
+        return not self.key or (parsed_key.path == parsed_initpath.path and query_key <= query_init)
 
     def isPartialObject(self):
         """ Returns True if this is not a full object. """
diff --git a/lib/plexapi/client.py b/lib/plexapi/client.py
index 76513e79..3d89e3dc 100644
--- a/lib/plexapi/client.py
+++ b/lib/plexapi/client.py
@@ -197,7 +197,7 @@ class PlexClient(PlexObject):
                 raise NotFound(message)
             else:
                 raise BadRequest(message)
-        data = response.text.encode('utf8')
+        data = utils.cleanXMLString(response.text).encode('utf8')
         return ElementTree.fromstring(data) if data.strip() else None
 
     def sendCommand(self, command, proxy=None, **params):
diff --git a/lib/plexapi/collection.py b/lib/plexapi/collection.py
index d71ddf2f..1c3ba3f7 100644
--- a/lib/plexapi/collection.py
+++ b/lib/plexapi/collection.py
@@ -60,6 +60,7 @@ class Collection(
             title (str): Name of the collection.
             titleSort (str): Title to use when sorting (defaults to title).
             type (str): 'collection'
+            ultraBlurColors (:class:`~plexapi.media.UltraBlurColors`): Ultra blur color object.
             updatedAt (datetime): Datetime the collection was updated.
             userRating (float): Rating of the collection (0.0 - 10.0) equaling (0 stars - 5 stars).
     """
@@ -102,6 +103,7 @@ class Collection(
         self.title = data.attrib.get('title')
         self.titleSort = data.attrib.get('titleSort', self.title)
         self.type = data.attrib.get('type')
+        self.ultraBlurColors = self.findItem(data, media.UltraBlurColors)
         self.updatedAt = utils.toDatetime(data.attrib.get('updatedAt'))
         self.userRating = utils.cast(float, data.attrib.get('userRating'))
         self._items = None  # cache for self.items
diff --git a/lib/plexapi/const.py b/lib/plexapi/const.py
index b0fe7e7d..130555ad 100644
--- a/lib/plexapi/const.py
+++ b/lib/plexapi/const.py
@@ -4,6 +4,6 @@
 # Library version
 MAJOR_VERSION = 4
 MINOR_VERSION = 15
-PATCH_VERSION = 15
+PATCH_VERSION = 16
 __short_version__ = f"{MAJOR_VERSION}.{MINOR_VERSION}"
 __version__ = f"{__short_version__}.{PATCH_VERSION}"
diff --git a/lib/plexapi/library.py b/lib/plexapi/library.py
index f1bf5375..6913b829 100644
--- a/lib/plexapi/library.py
+++ b/lib/plexapi/library.py
@@ -2823,7 +2823,8 @@ class FilteringType(PlexObject):
             additionalFields.extend([
                 ('duration', 'integer', 'Duration'),
                 ('viewOffset', 'integer', 'View Offset'),
-                ('label', 'tag', 'Label')
+                ('label', 'tag', 'Label'),
+                ('ratingCount', 'integer', 'Rating Count'),
             ])
         elif self.type == 'collection':
             additionalFields.extend([
diff --git a/lib/plexapi/media.py b/lib/plexapi/media.py
index 56126dcb..2f76d722 100644
--- a/lib/plexapi/media.py
+++ b/lib/plexapi/media.py
@@ -106,12 +106,16 @@ class MediaPart(PlexObject):
         Attributes:
             TAG (str): 'Part'
             accessible (bool): True if the file is accessible.
+                Requires reloading the media with ``checkFiles=True``.
+                Refer to :func:`~plexapi.base.PlexObject.reload`.
             audioProfile (str): The audio profile of the file.
             container (str): The container type of the file (ex: avi).
             decision (str): Unknown.
             deepAnalysisVersion (int): The Plex deep analysis version for the file.
             duration (int): The duration of the file in milliseconds.
             exists (bool): True if the file exists.
+                Requires reloading the media with ``checkFiles=True``.
+                Refer to :func:`~plexapi.base.PlexObject.reload`.
             file (str): The path to this file on disk (ex: /media/Movies/Cars (2006)/Cars (2006).mkv)
             has64bitOffsets (bool): True if the file has 64 bit offsets.
             hasThumbnail (bool): True if the file (track) has an embedded thumbnail.
@@ -999,6 +1003,28 @@ class Review(PlexObject):
         self.text = data.attrib.get('text')
 
 
+@utils.registerPlexObject
+class UltraBlurColors(PlexObject):
+    """ Represents a single UltraBlurColors media tag.
+
+        Attributes:
+            TAG (str): 'UltraBlurColors'
+            bottomLeft (str): The bottom left hex color.
+            bottomRight (str): The bottom right hex color.
+            topLeft (str): The top left hex color.
+            topRight (str): The top right hex color.
+    """
+    TAG = 'UltraBlurColors'
+
+    def _loadData(self, data):
+        """ Load attribute values from Plex XML response. """
+        self._data = data
+        self.bottomLeft = data.attrib.get('bottomLeft')
+        self.bottomRight = data.attrib.get('bottomRight')
+        self.topLeft = data.attrib.get('topLeft')
+        self.topRight = data.attrib.get('topRight')
+
+
 class BaseResource(PlexObject):
     """ Base class for all Art, Poster, and Theme objects.
 
diff --git a/lib/plexapi/mixins.py b/lib/plexapi/mixins.py
index 8571ba63..bdf4607e 100644
--- a/lib/plexapi/mixins.py
+++ b/lib/plexapi/mixins.py
@@ -14,8 +14,8 @@ class AdvancedSettingsMixin:
 
     def preferences(self):
         """ Returns a list of :class:`~plexapi.settings.Preferences` objects. """
-        data = self._server.query(self._details_key)
-        return self.findItems(data, settings.Preferences, rtag='Preferences')
+        key = f'{self.key}?includePreferences=1'
+        return self.fetchItems(key, cls=settings.Preferences, rtag='Preferences')
 
     def preference(self, pref):
         """ Returns a :class:`~plexapi.settings.Preferences` object for the specified pref.
@@ -240,8 +240,7 @@ class UnmatchMatchMixin:
                     params['agent'] = utils.getAgentIdentifier(self.section(), agent)
 
         key = key + '?' + urlencode(params)
-        data = self._server.query(key, method=self._server._session.get)
-        return self.findItems(data, initpath=key)
+        return self.fetchItems(key, cls=media.SearchResult)
 
     def fixMatch(self, searchResult=None, auto=False, agent=None):
         """ Use match result to update show metadata.
@@ -278,8 +277,8 @@ class ExtrasMixin:
     def extras(self):
         """ Returns a list of :class:`~plexapi.video.Extra` objects. """
         from plexapi.video import Extra
-        data = self._server.query(self._details_key)
-        return self.findItems(data, Extra, rtag='Extras')
+        key = f'{self.key}/extras'
+        return self.fetchItems(key, cls=Extra)
 
 
 class HubsMixin:
@@ -289,8 +288,7 @@ class HubsMixin:
         """ Returns a list of :class:`~plexapi.library.Hub` objects. """
         from plexapi.library import Hub
         key = f'{self.key}/related'
-        data = self._server.query(key)
-        return self.findItems(data, Hub)
+        return self.fetchItems(key, cls=Hub)
 
 
 class PlayedUnplayedMixin:
diff --git a/lib/plexapi/myplex.py b/lib/plexapi/myplex.py
index bc40583e..24e32e6b 100644
--- a/lib/plexapi/myplex.py
+++ b/lib/plexapi/myplex.py
@@ -250,7 +250,7 @@ class MyPlexAccount(PlexObject):
             return response.json()
         elif 'text/plain' in response.headers.get('Content-Type', ''):
             return response.text.strip()
-        data = response.text.encode('utf8')
+        data = utils.cleanXMLString(response.text).encode('utf8')
         return ElementTree.fromstring(data) if data.strip() else None
 
     def ping(self):
diff --git a/lib/plexapi/server.py b/lib/plexapi/server.py
index f39a423f..8cd110d8 100644
--- a/lib/plexapi/server.py
+++ b/lib/plexapi/server.py
@@ -768,7 +768,7 @@ class PlexServer(PlexObject):
                 raise NotFound(message)
             else:
                 raise BadRequest(message)
-        data = response.text.encode('utf8')
+        data = utils.cleanXMLString(response.text).encode('utf8')
         return ElementTree.fromstring(data) if data.strip() else None
 
     def search(self, query, mediatype=None, limit=None, sectionId=None):
diff --git a/lib/plexapi/utils.py b/lib/plexapi/utils.py
index bb128532..549afc5b 100644
--- a/lib/plexapi/utils.py
+++ b/lib/plexapi/utils.py
@@ -6,6 +6,7 @@ import logging
 import os
 import re
 import string
+import sys
 import time
 import unicodedata
 import warnings
@@ -673,3 +674,45 @@ def openOrRead(file):
 def sha1hash(guid):
     """ Return the SHA1 hash of a guid. """
     return sha1(guid.encode('utf-8')).hexdigest()
+
+
+# https://stackoverflow.com/a/64570125
+_illegal_XML_characters = [
+    (0x00, 0x08),
+    (0x0B, 0x0C),
+    (0x0E, 0x1F),
+    (0x7F, 0x84),
+    (0x86, 0x9F),
+    (0xFDD0, 0xFDDF),
+    (0xFFFE, 0xFFFF),
+]
+if sys.maxunicode >= 0x10000:  # not narrow build
+    _illegal_XML_characters.extend(
+        [
+            (0x1FFFE, 0x1FFFF),
+            (0x2FFFE, 0x2FFFF),
+            (0x3FFFE, 0x3FFFF),
+            (0x4FFFE, 0x4FFFF),
+            (0x5FFFE, 0x5FFFF),
+            (0x6FFFE, 0x6FFFF),
+            (0x7FFFE, 0x7FFFF),
+            (0x8FFFE, 0x8FFFF),
+            (0x9FFFE, 0x9FFFF),
+            (0xAFFFE, 0xAFFFF),
+            (0xBFFFE, 0xBFFFF),
+            (0xCFFFE, 0xCFFFF),
+            (0xDFFFE, 0xDFFFF),
+            (0xEFFFE, 0xEFFFF),
+            (0xFFFFE, 0xFFFFF),
+            (0x10FFFE, 0x10FFFF),
+        ]
+    )
+_illegal_XML_ranges = [
+    fr'{chr(low)}-{chr(high)}'
+    for (low, high) in _illegal_XML_characters
+]
+_illegal_XML_re = re.compile(fr'[{"".join(_illegal_XML_ranges)}]')
+
+
+def cleanXMLString(s):
+    return _illegal_XML_re.sub('', s)
diff --git a/lib/plexapi/video.py b/lib/plexapi/video.py
index 609f57f6..15755415 100644
--- a/lib/plexapi/video.py
+++ b/lib/plexapi/video.py
@@ -375,6 +375,7 @@ class Movie(
             studio (str): Studio that created movie (Di Bonaventura Pictures; 21 Laps Entertainment).
             tagline (str): Movie tag line (Back 2 Work; Who says men can't change?).
             theme (str): URL to theme resource (/library/metadata/<ratingkey>/theme/<themeid>).
+            ultraBlurColors (:class:`~plexapi.media.UltraBlurColors`): Ultra blur color object.
             useOriginalTitle (int): Setting that indicates if the original title is used for the movie
                 (-1 = Library default, 0 = No, 1 = Yes).
             viewOffset (int): View offset in milliseconds.
@@ -420,6 +421,7 @@ class Movie(
         self.studio = data.attrib.get('studio')
         self.tagline = data.attrib.get('tagline')
         self.theme = data.attrib.get('theme')
+        self.ultraBlurColors = self.findItem(data, media.UltraBlurColors)
         self.useOriginalTitle = utils.cast(int, data.attrib.get('useOriginalTitle', '-1'))
         self.viewOffset = utils.cast(int, data.attrib.get('viewOffset', 0))
         self.writers = self.findItems(data, media.Writer)
@@ -456,8 +458,8 @@ class Movie(
 
     def reviews(self):
         """ Returns a list of :class:`~plexapi.media.Review` objects. """
-        data = self._server.query(self._details_key)
-        return self.findItems(data, media.Review, rtag='Video')
+        key = f'{self.key}?includeReviews=1'
+        return self.fetchItems(key, cls=media.Review, rtag='Video')
 
     def editions(self):
         """ Returns a list of :class:`~plexapi.video.Movie` objects
@@ -543,6 +545,7 @@ class Show(
                 (-1 = Account default, 0 = Manually selected, 1 = Shown with foreign audio, 2 = Always enabled).
             tagline (str): Show tag line.
             theme (str): URL to theme resource (/library/metadata/<ratingkey>/theme/<themeid>).
+            ultraBlurColors (:class:`~plexapi.media.UltraBlurColors`): Ultra blur color object.
             useOriginalTitle (int): Setting that indicates if the original title is used for the show
                 (-1 = Library default, 0 = No, 1 = Yes).
             viewedLeafCount (int): Number of items marked as played in the show view.
@@ -592,6 +595,7 @@ class Show(
         self.subtitleMode = utils.cast(int, data.attrib.get('subtitleMode', '-1'))
         self.tagline = data.attrib.get('tagline')
         self.theme = data.attrib.get('theme')
+        self.ultraBlurColors = self.findItem(data, media.UltraBlurColors)
         self.useOriginalTitle = utils.cast(int, data.attrib.get('useOriginalTitle', '-1'))
         self.viewedLeafCount = utils.cast(int, data.attrib.get('viewedLeafCount'))
         self.year = utils.cast(int, data.attrib.get('year'))
@@ -614,8 +618,8 @@ class Show(
         """ Returns show's On Deck :class:`~plexapi.video.Video` object or `None`.
             If show is unwatched, return will likely be the first episode.
         """
-        data = self._server.query(self._details_key)
-        return next(iter(self.findItems(data, rtag='OnDeck')), None)
+        key = f'{self.key}?includeOnDeck=1'
+        return next(iter(self.fetchItems(key, cls=Episode, rtag='OnDeck')), None)
 
     def season(self, title=None, season=None):
         """ Returns the season with the specified title or number.
@@ -735,6 +739,7 @@ class Season(
             subtitleLanguage (str): Setting that indicates the preferred subtitle language.
             subtitleMode (int): Setting that indicates the auto-select subtitle mode.
                 (-1 = Series default, 0 = Manually selected, 1 = Shown with foreign audio, 2 = Always enabled).
+            ultraBlurColors (:class:`~plexapi.media.UltraBlurColors`): Ultra blur color object.
             viewedLeafCount (int): Number of items marked as played in the season view.
             year (int): Year the season was released.
     """
@@ -766,6 +771,7 @@ class Season(
         self.ratings = self.findItems(data, media.Rating)
         self.subtitleLanguage = data.attrib.get('subtitleLanguage', '')
         self.subtitleMode = utils.cast(int, data.attrib.get('subtitleMode', '-1'))
+        self.ultraBlurColors = self.findItem(data, media.UltraBlurColors)
         self.viewedLeafCount = utils.cast(int, data.attrib.get('viewedLeafCount'))
         self.year = utils.cast(int, data.attrib.get('year'))
 
@@ -796,8 +802,8 @@ class Season(
         """ Returns season's On Deck :class:`~plexapi.video.Video` object or `None`.
             Will only return a match if the show's On Deck episode is in this season.
         """
-        data = self._server.query(self._details_key)
-        return next(iter(self.findItems(data, rtag='OnDeck')), None)
+        key = f'{self.key}?includeOnDeck=1'
+        return next(iter(self.fetchItems(key, cls=Episode, rtag='OnDeck')), None)
 
     def episode(self, title=None, episode=None):
         """ Returns the episode with the given title or number.
@@ -914,6 +920,7 @@ class Episode(
             skipParent (bool): True if the show's seasons are set to hidden.
             sourceURI (str): Remote server URI (server://<machineIdentifier>/com.plexapp.plugins.library)
                 (remote playlist item only).
+            ultraBlurColors (:class:`~plexapi.media.UltraBlurColors`): Ultra blur color object.
             viewOffset (int): View offset in milliseconds.
             writers (List<:class:`~plexapi.media.Writer`>): List of writers objects.
             year (int): Year the episode was released.
@@ -958,6 +965,7 @@ class Episode(
         self.roles = self.findItems(data, media.Role)
         self.skipParent = utils.cast(bool, data.attrib.get('skipParent', '0'))
         self.sourceURI = data.attrib.get('source')  # remote playlist item
+        self.ultraBlurColors = self.findItem(data, media.UltraBlurColors)
         self.viewOffset = utils.cast(int, data.attrib.get('viewOffset', 0))
         self.writers = self.findItems(data, media.Writer)
         self.year = utils.cast(int, data.attrib.get('year'))
diff --git a/requirements.txt b/requirements.txt
index d0ee1941..d37487f1 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -26,7 +26,7 @@ musicbrainzngs==0.7.1
 packaging==24.1
 paho-mqtt==2.1.0
 platformdirs==4.2.2
-plexapi==4.15.15
+plexapi==4.15.16
 portend==3.2.0
 profilehooks==1.12.0
 PyJWT==2.9.0

From 6979a4025fbf332694e10c3e264aa4a3cfdda065 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 20 Sep 2024 20:29:15 -0700
Subject: [PATCH 653/743] v2.14.5

---
 CHANGELOG.md      | 12 +++++++++++-
 plexpy/version.py |  2 +-
 2 files changed, 12 insertions(+), 2 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 4ad54157..ba0bd908 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,15 @@
 # Changelog
 
+## v2.14.5 (2024-09-20)
+
+* Activity:
+  * Fix: Display of 2k resolution on activity card.
+* Notifications:
+  * Fix: ntfy notifications with special characters failing to send.
+* Other:
+  * Fix: Memory leak with database closing. (#2404)
+
+
 ## v2.14.4 (2024-08-10)
 
 * Notifications:
@@ -8,7 +18,7 @@
 * UI:
   * Fix: macOS platform capitalization.
 * Other:
-  * Fix: Remove deprecated getdefaultlocale (Thanks @teodorstelian) (#2364, #2345)
+  * Fix: Remove deprecated getdefaultlocale. (Thanks @teodorstelian) (#2364, #2345)
 
 
 ## v2.14.3 (2024-06-19)
diff --git a/plexpy/version.py b/plexpy/version.py
index feccd9cc..c4d017e2 100644
--- a/plexpy/version.py
+++ b/plexpy/version.py
@@ -16,4 +16,4 @@
 #  along with Tautulli.  If not, see <http://www.gnu.org/licenses/>.
 
 PLEXPY_BRANCH = "master"
-PLEXPY_RELEASE_VERSION = "v2.14.4"
\ No newline at end of file
+PLEXPY_RELEASE_VERSION = "v2.14.5"
\ No newline at end of file

From 3bb53f480ed809a6f4f95680ec3afe76e7b04b4e Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 21 Sep 2024 14:17:08 -0700
Subject: [PATCH 654/743] Change snap package to cryptography

---
 snap/snapcraft.yaml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/snap/snapcraft.yaml b/snap/snapcraft.yaml
index 6f76e8cc..35c22479 100644
--- a/snap/snapcraft.yaml
+++ b/snap/snapcraft.yaml
@@ -26,14 +26,14 @@ parts:
     stage-packages:
       - python3
       - python3-openssl
-      - python3-pycryptodome
+      - python3-cryptography
       - python3-setuptools
       - python3-pkg-resources
     build-packages:
       - git
       - python3
       - python3-openssl
-      - python3-pycryptodome
+      - python3-cryptography
       - python3-setuptools
       - python3-pkg-resources
     override-pull: |

From 921a3a0af99f999eea387988f34a0603ab3173a2 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 22 Sep 2024 18:03:28 -0700
Subject: [PATCH 655/743] Round human duration to nearest significant base

---
 data/interfaces/default/js/script.js | 3 ++-
 plexpy/helpers.py                    | 3 ++-
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/data/interfaces/default/js/script.js b/data/interfaces/default/js/script.js
index 2df5daeb..c04ce6ef 100644
--- a/data/interfaces/default/js/script.js
+++ b/data/interfaces/default/js/script.js
@@ -360,7 +360,8 @@ function humanDuration(ms, sig='dhm', units='ms', return_seconds=300000) {
             sig = 'dhms'
         }
 
-        ms = ms * factors[units];
+        r = factors[sig.slice(-1)];
+        ms = Math.round(ms * factors[units] / r) * r;
 
         h =  ms % factors['d'];
         d = Math.trunc(ms / factors['d']);
diff --git a/plexpy/helpers.py b/plexpy/helpers.py
index 014f1359..dfc82d25 100644
--- a/plexpy/helpers.py
+++ b/plexpy/helpers.py
@@ -272,7 +272,8 @@ def human_duration(ms, sig='dhm', units='ms', return_seconds=300000):
         if return_seconds and ms < return_seconds:
             sig = 'dhms'
 
-        ms = ms * factors[units]
+        r = factors[sig[-1]]
+        ms = round(ms * factors[units] / r) * r
 
         d, h = divmod(ms, factors['d'])
         h, m = divmod(h, factors['h'])

From 9ca8d59372519470f0e5f9892ef533fb7748af6d Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 23 Sep 2024 16:52:17 -0700
Subject: [PATCH 656/743] Fix auto-update not running

---
 plexpy/versioncheck.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/plexpy/versioncheck.py b/plexpy/versioncheck.py
index 2c161dd3..9f546594 100644
--- a/plexpy/versioncheck.py
+++ b/plexpy/versioncheck.py
@@ -281,7 +281,7 @@ def check_github(scheduler=False, notify=False, use_cache=False):
                                      'plexpy_update_commit': plexpy.LATEST_VERSION,
                                      'plexpy_update_behind': plexpy.COMMITS_BEHIND})
 
-        elif scheduler and plexpy.CONFIG.PLEXPY_AUTO_UPDATE and \
+        if scheduler and plexpy.CONFIG.PLEXPY_AUTO_UPDATE and \
                 not plexpy.DOCKER and not plexpy.SNAP and not plexpy.FROZEN:
             logger.info('Running automatic update.')
             plexpy.shutdown(restart=True, update=True)

From 3cf6560de3ead25e377912748cdc3a602b81e0a6 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Wed, 25 Sep 2024 11:54:55 -0700
Subject: [PATCH 657/743] Support apscheduler cron expressions

---
 .../interfaces/default/newsletter_config.html |  7 ++--
 plexpy/newsletter_handler.py                  | 34 +++++++++++++------
 2 files changed, 28 insertions(+), 13 deletions(-)

diff --git a/data/interfaces/default/newsletter_config.html b/data/interfaces/default/newsletter_config.html
index 10583707..3c1c68ee 100644
--- a/data/interfaces/default/newsletter_config.html
+++ b/data/interfaces/default/newsletter_config.html
@@ -50,7 +50,10 @@
                                         </div>
                                         <p class="help-block">
                                             <span id="simple_cron_message">Set the schedule for the newsletter.</span>
-                                            <span id="custom_cron_message">Set the schedule for the newsletter using a <a href="${anon_url('https://crontab.guru')}" target="_blank" rel="noreferrer">custom crontab</a>. Only standard cron values are valid.</span>
+                                            <span id="custom_cron_message">
+                                                Set the schedule for the newsletter using a <a href="${anon_url('https://crontab.guru')}" target="_blank" rel="noreferrer">custom crontab</a>.
+                                                <a href="${anon_url('https://apscheduler.readthedocs.io/en/3.x/modules/triggers/cron.html#expression-types')}" target="_blank" rel="noreferrer">Click here</a> for a list of supported expressions.
+                                            </span>
                                         </p>
                                     </div>
                                     <div class="form-group">
@@ -481,7 +484,7 @@
     });
 
     if (${newsletter['config']['custom_cron']}) {
-        $('#cron_value').val('${newsletter['cron']}');
+        $('#cron_value').val('${newsletter['cron'] | n}');
     } else {
         try {
             cron_widget.cron('value', '${newsletter['cron']}');
diff --git a/plexpy/newsletter_handler.py b/plexpy/newsletter_handler.py
index 69d646d9..05cb52fa 100644
--- a/plexpy/newsletter_handler.py
+++ b/plexpy/newsletter_handler.py
@@ -17,6 +17,7 @@
 
 from io import open
 import os
+import shlex
 
 from apscheduler.triggers.cron import CronTrigger
 import email.utils
@@ -58,25 +59,36 @@ def schedule_newsletters(newsletter_id=None):
 
 
 def schedule_newsletter_job(newsletter_job_id, name='', func=None, remove_job=False, args=None, cron=None):
-    # apscheduler day_of_week uses 0-6 = mon-sun
     if cron:
-        cron = cron.split(' ')
-        cron[4] = str((int(cron[4]) - 1) % 7) if cron[4].isdigit() else cron[4]
-        cron = ' '.join(cron)
+        values = shlex.split(cron)
+        # apscheduler day_of_week uses 0-6 = mon-sun
+        values[4] = str((int(values[4]) - 1) % 7) if values[4].isdigit() else values[4]
 
     if NEWSLETTER_SCHED.get_job(newsletter_job_id):
         if remove_job:
             NEWSLETTER_SCHED.remove_job(newsletter_job_id)
             logger.info("Tautulli NewsletterHandler :: Removed scheduled newsletter: %s" % name)
         else:
-            NEWSLETTER_SCHED.reschedule_job(
-                newsletter_job_id, args=args, trigger=CronTrigger.from_crontab(cron))
-            logger.info("Tautulli NewsletterHandler :: Re-scheduled newsletter: %s" % name)
+            try:
+                NEWSLETTER_SCHED.reschedule_job(
+                    newsletter_job_id, args=args, trigger=CronTrigger(
+                        minute=values[0], hour=values[1], day=values[2], month=values[3], day_of_week=values[4]
+                    )
+                )
+                logger.info("Tautulli NewsletterHandler :: Re-scheduled newsletter: %s" % name)
+            except ValueError as e:
+                logger.error("Tautulli NewsletterHandler :: Failed to re-schedule newsletter: %s" % e)
     elif not remove_job:
-        NEWSLETTER_SCHED.add_job(
-            func, args=args, id=newsletter_job_id, trigger=CronTrigger.from_crontab(cron),
-            misfire_grace_time=None)
-        logger.info("Tautulli NewsletterHandler :: Scheduled newsletter: %s" % name)
+        try:
+            NEWSLETTER_SCHED.add_job(
+                func, args=args, id=newsletter_job_id, trigger=CronTrigger(
+                    minute=values[0], hour=values[1], day=values[2], month=values[3], day_of_week=values[4]
+                ),
+                misfire_grace_time=None
+            )
+            logger.info("Tautulli NewsletterHandler :: Scheduled newsletter: %s" % name)
+        except ValueError as e:
+            logger.error("Tautulli NewsletterHandler :: Failed to schedule newsletter: %s" % e)
 
 
 def notify(newsletter_id=None, notify_action=None, **kwargs):

From 1353247b55289957f1f3147a194075b60ff63a41 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Wed, 25 Sep 2024 15:11:21 -0700
Subject: [PATCH 658/743] Allow formatting newsletter date parameters

---
 plexpy/newsletters.py | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/plexpy/newsletters.py b/plexpy/newsletters.py
index 7641decf..b49077a2 100644
--- a/plexpy/newsletters.py
+++ b/plexpy/newsletters.py
@@ -586,6 +586,8 @@ class Newsletter(object):
         return parameters
 
     def _build_params(self):
+        from plexpy.notification_handler import CustomArrow
+        
         date_format = helpers.momentjs_to_arrow(plexpy.CONFIG.DATE_FORMAT)
 
         if plexpy.CONFIG.NEWSLETTER_SELF_HOSTED and plexpy.CONFIG.HTTP_BASE_URL:
@@ -595,8 +597,8 @@ class Newsletter(object):
 
         parameters = {
             'server_name': helpers.pms_name(),
-            'start_date': self.start_date.format(date_format),
-            'end_date': self.end_date.format(date_format),
+            'start_date': CustomArrow(self.start_date, date_format),
+            'end_date': CustomArrow(self.end_date, date_format),
             'current_year': self.start_date.year,
             'current_month': self.start_date.month,
             'current_day': self.start_date.day,

From e3f4851883af5a2800c145f68f6762a6c6da6a07 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 28 Sep 2024 13:17:09 -0700
Subject: [PATCH 659/743] Make recent rows touch scrollable

---
 data/interfaces/default/css/tautulli.css      |  3 +-
 data/interfaces/default/index.html            | 25 +++++++------
 data/interfaces/default/library.html          | 36 +++++++++----------
 .../default/library_recently_added.html       |  2 +-
 data/interfaces/default/recently_added.html   |  2 +-
 data/interfaces/default/user.html             | 18 +++++-----
 .../default/user_recently_watched.html        |  2 +-
 7 files changed, 44 insertions(+), 44 deletions(-)

diff --git a/data/interfaces/default/css/tautulli.css b/data/interfaces/default/css/tautulli.css
index f8b15890..2835488d 100644
--- a/data/interfaces/default/css/tautulli.css
+++ b/data/interfaces/default/css/tautulli.css
@@ -1478,7 +1478,8 @@ a:hover .dashboard-stats-square {
     text-align: center;
     position: relative;
     z-index: 0;
-    overflow: hidden;
+    overflow: auto;
+    scrollbar-width: none;
 }
 .dashboard-recent-media {
     width: 100%;
diff --git a/data/interfaces/default/index.html b/data/interfaces/default/index.html
index 6e4818c7..00cbfb85 100644
--- a/data/interfaces/default/index.html
+++ b/data/interfaces/default/index.html
@@ -92,10 +92,10 @@
                 <h3 class="pull-left"><span id="recently-added-xml">Recently Added</span></h3>
                 <ul class="nav nav-header nav-dashboard pull-right" style="margin-top: -3px;">
                     <li>
-                        <a href="#" id="recently-added-page-left" class="paginate btn-gray disabled" data-id="+1"><i class="fa fa-lg fa-chevron-left"></i></a>
+                        <a href="#" id="recently-added-page-left" class="paginate btn-gray disabled" data-id="-1"><i class="fa fa-lg fa-chevron-left"></i></a>
                     </li>
                     <li>
-                        <a href="#" id="recently-added-page-right" class="paginate btn-gray disabled" data-id="-1"><i class="fa fa-lg fa-chevron-right"></i></a>
+                        <a href="#" id="recently-added-page-right" class="paginate btn-gray disabled" data-id="+1"><i class="fa fa-lg fa-chevron-right"></i></a>
                     </li>
                 </ul>
                 <div class="button-bar">
@@ -971,29 +971,28 @@
     });
 
     function resetScroller() {
-        leftTotal = 0;
-        $("#recently-added-row-scroller").animate({ left: leftTotal }, 1000);
+        $(".dashboard-recent-media-row").animate({ scrollLeft: 0 }, 1000);
         $("#recently-added-page-left").addClass("disabled").blur();
     }
 
-    var leftTotal = 0;
     $(".paginate").click(function (e) {
         e.preventDefault();
         var scroller = $("#recently-added-row-scroller");
+        var scrollerParent = scroller.parent();
         var containerWidth = $("body").find(".container-fluid").width();
+        var scrollCurrent = scrollerParent.scrollLeft();
         var scrollAmount = $(this).data("id") * parseInt((containerWidth - 15) / 175) * 175;
-        var leftMax = Math.min(-parseInt(scroller.width()) + Math.abs(scrollAmount), 0);
+        var scrollMax = parseInt(scroller.width()) - Math.abs(scrollAmount);
+        var scrollTotal = Math.min(scrollCurrent + scrollAmount, scrollMax);
+        scrollerParent.animate({ scrollLeft: scrollTotal }, 250);
 
-        leftTotal = Math.max(Math.min(leftTotal + scrollAmount, 0), leftMax);
-        scroller.animate({ left: leftTotal }, 250);
-
-        if (leftTotal === 0) {
+        if (scrollTotal === 0) {
             $("#recently-added-page-left").addClass("disabled").blur();
         } else {
             $("#recently-added-page-left").removeClass("disabled");
         }
 
-        if (leftTotal === leftMax) {
+        if (scrollTotal === scrollMax) {
             $("#recently-added-page-right").addClass("disabled").blur();
         } else {
             $("#recently-added-page-right").removeClass("disabled");
@@ -1005,17 +1004,17 @@
         selected_filter = $('input[name=recently-added-toggle]:checked', '#recently-added-toggles');
         $(selected_filter).closest('label').addClass('active');
         recently_added_type = $(selected_filter).val();
-        resetScroller();
         setLocalStorage('home_stats_recently_added_type', recently_added_type);
         recentlyAdded(recently_added_count, recently_added_type);
+        resetScroller();
     });
 
     $('#recently-added-count').change(function () {
         forceMinMax($(this));
         recently_added_count = $(this).val();
-        resetScroller();
         setLocalStorage('home_stats_recently_added_count', recently_added_count);
         recentlyAdded(recently_added_count, recently_added_type);
+        resetScroller();
     });
 
     $('#recently-added-count').tooltip({ container: 'body', placement: 'top', html: true });
diff --git a/data/interfaces/default/library.html b/data/interfaces/default/library.html
index b1fe8b6f..df9298d0 100644
--- a/data/interfaces/default/library.html
+++ b/data/interfaces/default/library.html
@@ -149,10 +149,10 @@ DOCUMENTATION :: END
                                     <div class="table-card-header">
                                         <ul class="nav nav-header nav-dashboard pull-right">
                                             <li>
-                                                <a href="#" id="recently-watched-page-left" class="paginate-watched btn-gray disabled" data-id="+1"><i class="fa fa-lg fa-chevron-left"></i></a>
+                                                <a href="#" id="recently-watched-page-left" class="paginate-watched btn-gray disabled" data-id="-1"><i class="fa fa-lg fa-chevron-left"></i></a>
                                             </li>
                                             <li>
-                                                <a href="#" id="recently-watched-page-right" class="paginate-watched btn-gray disabled" data-id="-1"><i class="fa fa-lg fa-chevron-right"></i></a>
+                                                <a href="#" id="recently-watched-page-right" class="paginate-watched btn-gray disabled" data-id="+1"><i class="fa fa-lg fa-chevron-right"></i></a>
                                             </li>
                                         </ul>
                                         <div class="header-bar">
@@ -175,10 +175,10 @@ DOCUMENTATION :: END
                                     <div class="table-card-header">
                                         <ul class="nav nav-header nav-dashboard pull-right">
                                             <li>
-                                                <a href="#" id="recently-added-page-left" class="paginate-added btn-gray disabled" data-id="+1"><i class="fa fa-lg fa-chevron-left"></i></a>
+                                                <a href="#" id="recently-added-page-left" class="paginate-added btn-gray disabled" data-id="-1"><i class="fa fa-lg fa-chevron-left"></i></a>
                                             </li>
                                             <li>
-                                                <a href="#" id="recently-added-page-right" class="paginate-added btn-gray disabled" data-id="-1"><i class="fa fa-lg fa-chevron-right"></i></a>
+                                                <a href="#" id="recently-added-page-right" class="paginate-added btn-gray disabled" data-id="+1"><i class="fa fa-lg fa-chevron-right"></i></a>
                                             </li>
                                         </ul>
                                         <div class="header-bar">
@@ -745,48 +745,48 @@ DOCUMENTATION :: END
 
     $('div.art-face').animate({ opacity: 0.2 }, { duration: 1000 });
 
-    var leftTotalWatched = 0;
     $(".paginate-watched").click(function (e) {
         e.preventDefault();
         var scroller = $("#recently-watched-row-scroller");
+        var scrollerParent = scroller.parent();
         var containerWidth = $("#library-recently-watched").width();
+        var scrollCurrent = scrollerParent.scrollLeft();
         var scrollAmount = $(this).data("id") * parseInt(containerWidth / 175) * 175;
-        var leftMax = Math.min(-parseInt(scroller.width()) + Math.abs(scrollAmount), 0);
+        var scrollMax = parseInt(scroller.width()) - Math.abs(scrollAmount);
+        var scrollTotal = Math.min(scrollCurrent + scrollAmount, scrollMax);
+        scrollerParent.animate({ scrollLeft: scrollTotal }, 250);
 
-        leftTotalWatched = Math.max(Math.min(leftTotalWatched + scrollAmount, 0), leftMax);
-        scroller.animate({ left: leftTotalWatched }, 250);
-
-        if (leftTotalWatched == 0) {
+        if (scrollTotal == 0) {
             $("#recently-watched-page-left").addClass("disabled").blur();
         } else {
             $("#recently-watched-page-left").removeClass("disabled");
         }
 
-        if (leftTotalWatched == leftMax) {
+        if (scrollTotal == scrollMax) {
             $("#recently-watched-page-right").addClass("disabled").blur();
         } else {
             $("#recently-watched-page-right").removeClass("disabled");
         }
     });
 
-    var leftTotalAdded = 0;
     $(".paginate-added").click(function (e) {
         e.preventDefault();
         var scroller = $("#recently-added-row-scroller");
+        var scrollerParent = scroller.parent();
         var containerWidth = $("#library-recently-added").width();
+        var scrollCurrent = scrollerParent.scrollLeft();
         var scrollAmount = $(this).data("id") * parseInt(containerWidth / 175) * 175;
-        var leftMax = Math.min(-parseInt(scroller.width()) + Math.abs(scrollAmount), 0);
+        var scrollMax = parseInt(scroller.width()) - Math.abs(scrollAmount);
+        var scrollTotal = Math.min(scrollCurrent + scrollAmount, scrollMax);
+        scrollerParent.animate({ scrollLeft: scrollTotal }, 250);
 
-        leftTotalAdded = Math.max(Math.min(leftTotalAdded + scrollAmount, 0), leftMax);
-        scroller.animate({ left: leftTotalAdded }, 250);
-
-        if (leftTotalAdded == 0) {
+        if (scrollTotal == 0) {
             $("#recently-added-page-left").addClass("disabled").blur();
         } else {
             $("#recently-added-page-left").removeClass("disabled");
         }
 
-        if (leftTotalAdded == leftMax) {
+        if (scrollTotal == scrollMax) {
             $("#recently-added-page-right").addClass("disabled").blur();
         } else {
             $("#recently-added-page-right").removeClass("disabled");
diff --git a/data/interfaces/default/library_recently_added.html b/data/interfaces/default/library_recently_added.html
index fb53f9a5..4cf56d8e 100644
--- a/data/interfaces/default/library_recently_added.html
+++ b/data/interfaces/default/library_recently_added.html
@@ -36,7 +36,7 @@ DOCUMENTATION :: END
 
 %>
 <div class="dashboard-recent-media-row">
-    <div id="recently-added-row-scroller" style="left: 0;">
+    <div id="recently-added-row-scroller">
         <ul class="dashboard-recent-media list-unstyled">
             % for item in data:
             <li>
diff --git a/data/interfaces/default/recently_added.html b/data/interfaces/default/recently_added.html
index 52920817..74d5e561 100644
--- a/data/interfaces/default/recently_added.html
+++ b/data/interfaces/default/recently_added.html
@@ -36,7 +36,7 @@ DOCUMENTATION :: END
 %>
 % if data:
 <div class="dashboard-recent-media-row">
-    <div id="recently-added-row-scroller" style="left: 0;">
+    <div id="recently-added-row-scroller">
         <ul class="dashboard-recent-media list-unstyled">
             % for item in data:
             <div class="dashboard-recent-media-instance">
diff --git a/data/interfaces/default/user.html b/data/interfaces/default/user.html
index 6ec74620..cd13cc83 100644
--- a/data/interfaces/default/user.html
+++ b/data/interfaces/default/user.html
@@ -125,10 +125,10 @@ DOCUMENTATION :: END
                                     <div class="table-card-header">
                                         <ul class="nav nav-header nav-dashboard pull-right">
                                             <li>
-                                                <a href="#" id="recently-watched-page-left" class="paginate btn-gray disabled" data-id="+1"><i class="fa fa-lg fa-chevron-left"></i></a>
+                                                <a href="#" id="recently-watched-page-left" class="paginate btn-gray disabled" data-id="-1"><i class="fa fa-lg fa-chevron-left"></i></a>
                                             </li>
                                             <li>
-                                                <a href="#" id="recently-watched-page-right" class="paginate btn-gray" data-id="-1"><i class="fa fa-lg fa-chevron-right"></i></a>
+                                                <a href="#" id="recently-watched-page-right" class="paginate btn-gray" data-id="+1"><i class="fa fa-lg fa-chevron-right"></i></a>
                                             </li>
                                         </ul>
                                         <div class="header-bar">
@@ -688,24 +688,24 @@ DOCUMENTATION :: END
         highlightWatchedScrollerButton();
     });
 
-    var leftTotal = 0;
     $(".paginate").click(function (e) {
         e.preventDefault();
         var scroller = $("#recently-watched-row-scroller");
+        var scrollerParent = scroller.parent();
         var containerWidth = $("#user-recently-watched").width();
+        var scrollCurrent = scrollerParent.scrollLeft();
         var scrollAmount = $(this).data("id") * parseInt(containerWidth / 175) * 175;
-        var leftMax = Math.min(-parseInt(scroller.width()) + Math.abs(scrollAmount), 0);
+        var scrollMax = parseInt(scroller.width()) - Math.abs(scrollAmount);
+        var scrollTotal = Math.min(scrollCurrent + scrollAmount, scrollMax);
+        scrollerParent.animate({ scrollLeft: scrollTotal }, 250);
 
-        leftTotal = Math.max(Math.min(leftTotal + scrollAmount, 0), leftMax);
-        scroller.animate({ left: leftTotal }, 250);
-
-        if (leftTotal == 0) {
+        if (scrollTotal == 0) {
             $("#recently-watched-page-left").addClass("disabled").blur();
         } else {
             $("#recently-watched-page-left").removeClass("disabled");
         }
 
-        if (leftTotal == leftMax) {
+        if (scrollTotal == scrollMax) {
             $("#recently-watched-page-right").addClass("disabled").blur();
         } else {
             $("#recently-watched-page-right").removeClass("disabled");
diff --git a/data/interfaces/default/user_recently_watched.html b/data/interfaces/default/user_recently_watched.html
index 39243766..b9f8a8a1 100644
--- a/data/interfaces/default/user_recently_watched.html
+++ b/data/interfaces/default/user_recently_watched.html
@@ -31,7 +31,7 @@ DOCUMENTATION :: END
     from plexpy.helpers import page, short_season
 %>
 <div class="dashboard-recent-media-row">
-    <div id="recently-watched-row-scroller" style="left: 0;">
+    <div id="recently-watched-row-scroller">
         <ul class="dashboard-recent-media list-unstyled">
             % for item in data:
             <li>

From 1cdfd5f30a6c4b080f4bab3225267b70123639a4 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 28 Sep 2024 14:08:39 -0700
Subject: [PATCH 660/743] Refactor scroller code

---
 data/interfaces/default/index.html   | 56 +++----------------
 data/interfaces/default/js/script.js | 47 ++++++++++++++++
 data/interfaces/default/library.html | 81 ++--------------------------
 data/interfaces/default/user.html    | 46 ++--------------
 4 files changed, 62 insertions(+), 168 deletions(-)

diff --git a/data/interfaces/default/index.html b/data/interfaces/default/index.html
index 00cbfb85..582ac93f 100644
--- a/data/interfaces/default/index.html
+++ b/data/interfaces/default/index.html
@@ -92,10 +92,10 @@
                 <h3 class="pull-left"><span id="recently-added-xml">Recently Added</span></h3>
                 <ul class="nav nav-header nav-dashboard pull-right" style="margin-top: -3px;">
                     <li>
-                        <a href="#" id="recently-added-page-left" class="paginate btn-gray disabled" data-id="-1"><i class="fa fa-lg fa-chevron-left"></i></a>
+                        <a href="#" id="recently-added-page-left" class="paginate-added btn-gray disabled" data-id="-1"><i class="fa fa-lg fa-chevron-left"></i></a>
                     </li>
                     <li>
-                        <a href="#" id="recently-added-page-right" class="paginate btn-gray disabled" data-id="+1"><i class="fa fa-lg fa-chevron-right"></i></a>
+                        <a href="#" id="recently-added-page-right" class="paginate-added btn-gray disabled" data-id="+1"><i class="fa fa-lg fa-chevron-right"></i></a>
                     </li>
                 </ul>
                 <div class="button-bar">
@@ -936,10 +936,14 @@
                 count: recently_added_count,
                 media_type: recently_added_type
             },
+            beforeSend: function () {
+                $(".dashboard-recent-media-row").animate({ scrollLeft: 0 }, 1000);
+            },
             complete: function (xhr, status) {
                 $("#recentlyAdded").html(xhr.responseText);
                 $('#ajaxMsg').fadeOut();
-                highlightAddedScrollerButton();
+                highlightScrollerButton("#recently-added");
+                paginateScroller("#recently-added", ".paginate-added");
             }
         });
     }
@@ -955,50 +959,6 @@
         recentlyAdded(recently_added_count, recently_added_type);
     }
 
-    function highlightAddedScrollerButton() {
-        var scroller = $("#recently-added-row-scroller");
-        var numElems = scroller.find("li:visible").length;
-        scroller.width(numElems * 175);
-        if (scroller.width() > $("body").find(".container-fluid").width()) {
-            $("#recently-added-page-right").removeClass("disabled");
-        } else {
-            $("#recently-added-page-right").addClass("disabled");
-        }
-    }
-
-    $(window).resize(function () {
-        highlightAddedScrollerButton();
-    });
-
-    function resetScroller() {
-        $(".dashboard-recent-media-row").animate({ scrollLeft: 0 }, 1000);
-        $("#recently-added-page-left").addClass("disabled").blur();
-    }
-
-    $(".paginate").click(function (e) {
-        e.preventDefault();
-        var scroller = $("#recently-added-row-scroller");
-        var scrollerParent = scroller.parent();
-        var containerWidth = $("body").find(".container-fluid").width();
-        var scrollCurrent = scrollerParent.scrollLeft();
-        var scrollAmount = $(this).data("id") * parseInt((containerWidth - 15) / 175) * 175;
-        var scrollMax = parseInt(scroller.width()) - Math.abs(scrollAmount);
-        var scrollTotal = Math.min(scrollCurrent + scrollAmount, scrollMax);
-        scrollerParent.animate({ scrollLeft: scrollTotal }, 250);
-
-        if (scrollTotal === 0) {
-            $("#recently-added-page-left").addClass("disabled").blur();
-        } else {
-            $("#recently-added-page-left").removeClass("disabled");
-        }
-
-        if (scrollTotal === scrollMax) {
-            $("#recently-added-page-right").addClass("disabled").blur();
-        } else {
-            $("#recently-added-page-right").removeClass("disabled");
-        }
-    });
-
     $('#recently-added-toggles').on('change', function () {
         $('#recently-added-toggles > label').removeClass('active');
         selected_filter = $('input[name=recently-added-toggle]:checked', '#recently-added-toggles');
@@ -1006,7 +966,6 @@
         recently_added_type = $(selected_filter).val();
         setLocalStorage('home_stats_recently_added_type', recently_added_type);
         recentlyAdded(recently_added_count, recently_added_type);
-        resetScroller();
     });
 
     $('#recently-added-count').change(function () {
@@ -1014,7 +973,6 @@
         recently_added_count = $(this).val();
         setLocalStorage('home_stats_recently_added_count', recently_added_count);
         recentlyAdded(recently_added_count, recently_added_type);
-        resetScroller();
     });
 
     $('#recently-added-count').tooltip({ container: 'body', placement: 'top', html: true });
diff --git a/data/interfaces/default/js/script.js b/data/interfaces/default/js/script.js
index c04ce6ef..5d75c69d 100644
--- a/data/interfaces/default/js/script.js
+++ b/data/interfaces/default/js/script.js
@@ -930,3 +930,50 @@ $('.modal').on('hide.bs.modal', function (e) {
 $.fn.hasScrollBar = function() {
     return this.get(0).scrollHeight > this.get(0).clientHeight;
 }
+
+function paginateScroller(scrollerId, buttonClass) {
+    $(buttonClass).click(function (e) {
+        e.preventDefault();
+        var scroller = $(scrollerId + "-row-scroller");
+        var scrollerParent = scroller.parent();
+        var containerWidth = scrollerParent.width();
+        var scrollCurrent = scrollerParent.scrollLeft();
+        var scrollAmount = $(this).data("id") * parseInt(containerWidth / 175) * 175;
+        var scrollMax = scroller.width() - Math.abs(scrollAmount);
+        var scrollTotal = Math.min(parseInt(scrollCurrent / 175) * 175 + scrollAmount, scrollMax);
+        scrollerParent.animate({ scrollLeft: scrollTotal }, 250);
+    });    
+}
+
+function highlightScrollerButton(scrollerId) {
+    var scroller = $(scrollerId + "-row-scroller");
+    var scrollerParent = scroller.parent();
+    var buttonLeft = $(scrollerId + "-page-left");
+    var buttonRight = $(scrollerId + "-page-right");
+
+    var numElems = scroller.find("li").length;
+    scroller.width(numElems * 175);
+    $(buttonLeft).addClass("disabled").blur();
+    if (scroller.width() > scrollerParent.width()) {
+        $(buttonRight).removeClass("disabled");
+    } else {
+        $(buttonRight).addClass("disabled");
+    }
+
+    scrollerParent.scroll(function () {
+        var scrollCurrent = $(this).scrollLeft();
+        var scrollMax = scroller.width() - $(this).width();
+
+        if (scrollCurrent == 0) {
+            $(buttonLeft).addClass("disabled").blur();
+        } else {
+            $(buttonLeft).removeClass("disabled");
+        }
+
+        if (scrollCurrent >= scrollMax) {
+            $(buttonRight).addClass("disabled").blur();
+        } else {
+            $(buttonRight).removeClass("disabled");
+        }
+    });
+}
diff --git a/data/interfaces/default/library.html b/data/interfaces/default/library.html
index df9298d0..ba61153d 100644
--- a/data/interfaces/default/library.html
+++ b/data/interfaces/default/library.html
@@ -690,7 +690,8 @@ DOCUMENTATION :: END
             },
             complete: function(xhr, status) {
                 $("#library-recently-watched").html(xhr.responseText);
-                highlightWatchedScrollerButton();
+                highlightScrollerButton("#recently-watched");
+                paginateScroller("#recently-watched", ".paginate-watched");
             }
         });
     }
@@ -706,7 +707,8 @@ DOCUMENTATION :: END
             },
             complete: function(xhr, status) {
                 $("#library-recently-added").html(xhr.responseText);
-                highlightAddedScrollerButton();
+                highlightScrollerButton("#recently-added");
+                paginateScroller("#recently-added", ".paginate-added");
             }
         });
     }
@@ -716,83 +718,8 @@ DOCUMENTATION :: END
     recentlyAdded();
     % endif
 
-    function highlightWatchedScrollerButton() {
-        var scroller = $("#recently-watched-row-scroller");
-        var numElems = scroller.find("li").length;
-        scroller.width(numElems * 175);
-        if (scroller.width() > $("#library-recently-watched").width()) {
-            $("#recently-watched-page-right").removeClass("disabled");
-        } else {
-            $("#recently-watched-page-right").addClass("disabled");
-        }
-    }
-
-    function highlightAddedScrollerButton() {
-        var scroller = $("#recently-added-row-scroller");
-        var numElems = scroller.find("li").length;
-        scroller.width(numElems * 175);
-        if (scroller.width() > $("#library-recently-added").width()) {
-            $("#recently-added-page-right").removeClass("disabled");
-        } else {
-            $("#recently-added-page-right").addClass("disabled");
-        }
-    }
-
-    $(window).resize(function() {
-        highlightWatchedScrollerButton();
-        highlightAddedScrollerButton();
-    });
-
     $('div.art-face').animate({ opacity: 0.2 }, { duration: 1000 });
 
-    $(".paginate-watched").click(function (e) {
-        e.preventDefault();
-        var scroller = $("#recently-watched-row-scroller");
-        var scrollerParent = scroller.parent();
-        var containerWidth = $("#library-recently-watched").width();
-        var scrollCurrent = scrollerParent.scrollLeft();
-        var scrollAmount = $(this).data("id") * parseInt(containerWidth / 175) * 175;
-        var scrollMax = parseInt(scroller.width()) - Math.abs(scrollAmount);
-        var scrollTotal = Math.min(scrollCurrent + scrollAmount, scrollMax);
-        scrollerParent.animate({ scrollLeft: scrollTotal }, 250);
-
-        if (scrollTotal == 0) {
-            $("#recently-watched-page-left").addClass("disabled").blur();
-        } else {
-            $("#recently-watched-page-left").removeClass("disabled");
-        }
-
-        if (scrollTotal == scrollMax) {
-            $("#recently-watched-page-right").addClass("disabled").blur();
-        } else {
-            $("#recently-watched-page-right").removeClass("disabled");
-        }
-    });
-
-    $(".paginate-added").click(function (e) {
-        e.preventDefault();
-        var scroller = $("#recently-added-row-scroller");
-        var scrollerParent = scroller.parent();
-        var containerWidth = $("#library-recently-added").width();
-        var scrollCurrent = scrollerParent.scrollLeft();
-        var scrollAmount = $(this).data("id") * parseInt(containerWidth / 175) * 175;
-        var scrollMax = parseInt(scroller.width()) - Math.abs(scrollAmount);
-        var scrollTotal = Math.min(scrollCurrent + scrollAmount, scrollMax);
-        scrollerParent.animate({ scrollLeft: scrollTotal }, 250);
-
-        if (scrollTotal == 0) {
-            $("#recently-added-page-left").addClass("disabled").blur();
-        } else {
-            $("#recently-added-page-left").removeClass("disabled");
-        }
-
-        if (scrollTotal == scrollMax) {
-            $("#recently-added-page-right").addClass("disabled").blur();
-        } else {
-            $("#recently-added-page-right").removeClass("disabled");
-        }
-    });
-
     $(document).ready(function () {
 
         // Javascript to enable link to tab
diff --git a/data/interfaces/default/user.html b/data/interfaces/default/user.html
index cd13cc83..adfd6c39 100644
--- a/data/interfaces/default/user.html
+++ b/data/interfaces/default/user.html
@@ -125,10 +125,10 @@ DOCUMENTATION :: END
                                     <div class="table-card-header">
                                         <ul class="nav nav-header nav-dashboard pull-right">
                                             <li>
-                                                <a href="#" id="recently-watched-page-left" class="paginate btn-gray disabled" data-id="-1"><i class="fa fa-lg fa-chevron-left"></i></a>
+                                                <a href="#" id="recently-watched-page-left" class="paginate-watched btn-gray disabled" data-id="-1"><i class="fa fa-lg fa-chevron-left"></i></a>
                                             </li>
                                             <li>
-                                                <a href="#" id="recently-watched-page-right" class="paginate btn-gray" data-id="+1"><i class="fa fa-lg fa-chevron-right"></i></a>
+                                                <a href="#" id="recently-watched-page-right" class="paginate-watched btn-gray" data-id="+1"><i class="fa fa-lg fa-chevron-right"></i></a>
                                             </li>
                                         </ul>
                                         <div class="header-bar">
@@ -666,52 +666,14 @@ DOCUMENTATION :: END
             },
             complete: function(xhr, status) {
                 $("#user-recently-watched").html(xhr.responseText);
-                highlightWatchedScrollerButton();
+                highlightScrollerButton("#recently-watched");
+                paginateScroller("#recently-watched", ".paginate-watched");
             }
         });
     }
 
     recentlyWatched();
 
-    function highlightWatchedScrollerButton() {
-        var scroller = $("#recently-watched-row-scroller");
-        var numElems = scroller.find("li").length;
-        scroller.width(numElems * 175);
-        if (scroller.width() > $("#user-recently-watched").width()) {
-            $("#recently-watched-page-right").removeClass("disabled");
-        } else {
-            $("#recently-watched-page-right").addClass("disabled");
-        }
-    }
-
-    $(window).resize(function() {
-        highlightWatchedScrollerButton();
-    });
-
-    $(".paginate").click(function (e) {
-        e.preventDefault();
-        var scroller = $("#recently-watched-row-scroller");
-        var scrollerParent = scroller.parent();
-        var containerWidth = $("#user-recently-watched").width();
-        var scrollCurrent = scrollerParent.scrollLeft();
-        var scrollAmount = $(this).data("id") * parseInt(containerWidth / 175) * 175;
-        var scrollMax = parseInt(scroller.width()) - Math.abs(scrollAmount);
-        var scrollTotal = Math.min(scrollCurrent + scrollAmount, scrollMax);
-        scrollerParent.animate({ scrollLeft: scrollTotal }, 250);
-
-        if (scrollTotal == 0) {
-            $("#recently-watched-page-left").addClass("disabled").blur();
-        } else {
-            $("#recently-watched-page-left").removeClass("disabled");
-        }
-
-        if (scrollTotal == scrollMax) {
-            $("#recently-watched-page-right").addClass("disabled").blur();
-        } else {
-            $("#recently-watched-page-right").removeClass("disabled");
-        }
-    });
-
     $(document).ready(function () {
         // Javascript to enable link to tab
         var hash = document.location.hash;

From 940c2ae6cd064817512aa7646386a31fa9f465fa Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 12 Oct 2024 16:55:38 -0700
Subject: [PATCH 661/743] v2.14.6

---
 CHANGELOG.md      | 12 ++++++++++++
 plexpy/version.py |  2 +-
 2 files changed, 13 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index ba0bd908..26dda362 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,17 @@
 # Changelog
 
+## v2.14.6 (2024-10-12)
+
+* Newsletters:
+  * Fix: Allow formatting newsletter date parameters.
+  * Change: Support apscheduler compatible cron expressions.
+* UI:
+  * Fix: Round runtime before converting to human duration.
+  * Fix: Make recently added/watched rows touch scrollable.
+* Other:
+  * Fix: Auto-updater not running.
+
+
 ## v2.14.5 (2024-09-20)
 
 * Activity:
diff --git a/plexpy/version.py b/plexpy/version.py
index c4d017e2..08fcf9e3 100644
--- a/plexpy/version.py
+++ b/plexpy/version.py
@@ -16,4 +16,4 @@
 #  along with Tautulli.  If not, see <http://www.gnu.org/licenses/>.
 
 PLEXPY_BRANCH = "master"
-PLEXPY_RELEASE_VERSION = "v2.14.5"
\ No newline at end of file
+PLEXPY_RELEASE_VERSION = "v2.14.6"
\ No newline at end of file

From 2d3271376be809e4760b258fa7381dabfa701c43 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 2 Nov 2024 11:13:37 -0700
Subject: [PATCH 662/743] Remove unused cache_image function

Fixes #2426
---
 plexpy/helpers.py | 35 -----------------------------------
 1 file changed, 35 deletions(-)

diff --git a/plexpy/helpers.py b/plexpy/helpers.py
index dfc82d25..fdb79830 100644
--- a/plexpy/helpers.py
+++ b/plexpy/helpers.py
@@ -24,8 +24,6 @@ from cloudinary.utils import cloudinary_url
 from collections import OrderedDict
 from datetime import date, datetime, timezone
 from functools import reduce, wraps
-import hashlib
-import imghdr
 from itertools import groupby
 from future.moves.itertools import islice, zip_longest
 from ipaddress import ip_address, ip_network, IPv4Address
@@ -943,39 +941,6 @@ def cloudinary_transform(rating_key=None, width=1000, height=1500, opacity=100,
     return url
 
 
-def cache_image(url, image=None):
-    """
-    Saves an image to the cache directory.
-    If no image is provided, tries to return the image from the cache directory.
-    """
-    # Create image directory if it doesn't exist
-    imgdir = os.path.join(plexpy.CONFIG.CACHE_DIR, 'images/')
-    if not os.path.exists(imgdir):
-        logger.debug("Tautulli Helpers :: Creating image cache directory at %s" % imgdir)
-        os.makedirs(imgdir)
-
-    # Create a hash of the url to use as the filename
-    imghash = hashlib.md5(url).hexdigest()
-    imagefile = os.path.join(imgdir, imghash)
-
-    # If an image is provided, save it to the cache directory
-    if image:
-        try:
-            with open(imagefile, 'wb') as cache_file:
-                cache_file.write(image)
-        except IOError as e:
-            logger.error("Tautulli Helpers :: Failed to cache image %s: %s" % (imagefile, e))
-
-    # Try to return the image from the cache directory
-    if os.path.isfile(imagefile):
-        imagetype = 'image/' + imghdr.what(os.path.abspath(imagefile))
-    else:
-        imagefile = None
-        imagetype = 'image/jpeg'
-
-    return imagefile, imagetype
-
-
 def build_datatables_json(kwargs, dt_columns, default_sort_col=None):
     """ Builds datatables json data
 

From 2f3d24a0e75576694f364255817f0ad8d5c50e1d Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 16 Nov 2024 14:47:38 -0800
Subject: [PATCH 663/743] Bump simplejson from 3.19.2 to 3.19.3 (#2379)

* Bump simplejson from 3.19.2 to 3.19.3

Bumps [simplejson](https://github.com/simplejson/simplejson) from 3.19.2 to 3.19.3.
- [Release notes](https://github.com/simplejson/simplejson/releases)
- [Changelog](https://github.com/simplejson/simplejson/blob/master/CHANGES.txt)
- [Commits](https://github.com/simplejson/simplejson/compare/v3.19.2...v3.19.3)

---
updated-dependencies:
- dependency-name: simplejson
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

* Update simplejson==3.19.3

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/simplejson/__init__.py | 2 +-
 requirements.txt           | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/lib/simplejson/__init__.py b/lib/simplejson/__init__.py
index 2d1900d8..d3ff141d 100644
--- a/lib/simplejson/__init__.py
+++ b/lib/simplejson/__init__.py
@@ -118,7 +118,7 @@ Serializing multiple objects to JSON lines (newline-delimited JSON)::
 
 """
 from __future__ import absolute_import
-__version__ = '3.19.2'
+__version__ = '3.19.3'
 __all__ = [
     'dump', 'dumps', 'load', 'loads',
     'JSONDecoder', 'JSONDecodeError', 'JSONEncoder',
diff --git a/requirements.txt b/requirements.txt
index d37487f1..77c42d60 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -37,7 +37,7 @@ pytz==2024.1
 requests==2.32.3
 requests-oauthlib==2.0.0
 rumps==0.4.0; platform_system == "Darwin"
-simplejson==3.19.2
+simplejson==3.19.3
 six==1.16.0
 tempora==5.7.0
 tokenize-rt==6.0.0

From d3f7eef84f1e8f88b93f4d86a41a4c39d093a4de Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 16 Nov 2024 14:47:48 -0800
Subject: [PATCH 664/743] Bump pyparsing from 3.1.2 to 3.1.4 (#2388)

* Bump pyparsing from 3.1.2 to 3.1.4

Bumps [pyparsing](https://github.com/pyparsing/pyparsing) from 3.1.2 to 3.1.4.
- [Release notes](https://github.com/pyparsing/pyparsing/releases)
- [Changelog](https://github.com/pyparsing/pyparsing/blob/master/CHANGES)
- [Commits](https://github.com/pyparsing/pyparsing/compare/pyparsing_3.1.2...3.1.4)

---
updated-dependencies:
- dependency-name: pyparsing
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

* Update pyparsing==3.1.4

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/pyparsing/__init__.py         |   6 +-
 lib/pyparsing/actions.py          |   2 +-
 lib/pyparsing/common.py           |  23 +-
 lib/pyparsing/core.py             | 405 +++++++++++++++++-------------
 lib/pyparsing/diagram/__init__.py |  45 +++-
 lib/pyparsing/exceptions.py       |   3 +-
 lib/pyparsing/helpers.py          |  10 +-
 lib/pyparsing/results.py          |  16 +-
 lib/pyparsing/unicode.py          |  32 +--
 lib/pyparsing/util.py             |   2 +-
 requirements.txt                  |   2 +-
 11 files changed, 323 insertions(+), 223 deletions(-)

diff --git a/lib/pyparsing/__init__.py b/lib/pyparsing/__init__.py
index 79d8153c..a440cfbe 100644
--- a/lib/pyparsing/__init__.py
+++ b/lib/pyparsing/__init__.py
@@ -120,8 +120,8 @@ class version_info(NamedTuple):
         return f"{__name__}.{type(self).__name__}({', '.join('{}={!r}'.format(*nv) for nv in zip(self._fields, self))})"
 
 
-__version_info__ = version_info(3, 1, 2, "final", 1)
-__version_time__ = "06 Mar 2024 07:08 UTC"
+__version_info__ = version_info(3, 1, 4, "final", 1)
+__version_time__ = "25 Aug 2024 14:40 UTC"
 __version__ = __version_info__.__version__
 __versionTime__ = __version_time__
 __author__ = "Paul McGuire <ptmcg.gm+pyparsing@gmail.com>"
@@ -143,7 +143,7 @@ from .common import (
     _builtin_exprs as common_builtin_exprs,
 )
 
-# define backward compat synonyms
+# Compatibility synonyms
 if "pyparsing_unicode" not in globals():
     pyparsing_unicode = unicode  # type: ignore[misc]
 if "pyparsing_common" not in globals():
diff --git a/lib/pyparsing/actions.py b/lib/pyparsing/actions.py
index ce51b395..1d2dce99 100644
--- a/lib/pyparsing/actions.py
+++ b/lib/pyparsing/actions.py
@@ -196,7 +196,7 @@ def with_class(classname, namespace=""):
     return with_attribute(**{classattr: classname})
 
 
-# pre-PEP8 compatibility symbols
+# Compatibility synonyms
 # fmt: off
 replaceWith = replaced_by_pep8("replaceWith", replace_with)
 removeQuotes = replaced_by_pep8("removeQuotes", remove_quotes)
diff --git a/lib/pyparsing/common.py b/lib/pyparsing/common.py
index 74faa460..649aad00 100644
--- a/lib/pyparsing/common.py
+++ b/lib/pyparsing/common.py
@@ -418,20 +418,15 @@ class pyparsing_common:
     # fmt: on
 
     # pre-PEP8 compatibility names
-    convertToInteger = convert_to_integer
-    """Deprecated - use :class:`convert_to_integer`"""
-    convertToFloat = convert_to_float
-    """Deprecated - use :class:`convert_to_float`"""
-    convertToDate = convert_to_date
-    """Deprecated - use :class:`convert_to_date`"""
-    convertToDatetime = convert_to_datetime
-    """Deprecated - use :class:`convert_to_datetime`"""
-    stripHTMLTags = strip_html_tags
-    """Deprecated - use :class:`strip_html_tags`"""
-    upcaseTokens = upcase_tokens
-    """Deprecated - use :class:`upcase_tokens`"""
-    downcaseTokens = downcase_tokens
-    """Deprecated - use :class:`downcase_tokens`"""
+    # fmt: off
+    convertToInteger = staticmethod(replaced_by_pep8("convertToInteger", convert_to_integer))
+    convertToFloat = staticmethod(replaced_by_pep8("convertToFloat", convert_to_float))
+    convertToDate = staticmethod(replaced_by_pep8("convertToDate", convert_to_date))
+    convertToDatetime = staticmethod(replaced_by_pep8("convertToDatetime", convert_to_datetime))
+    stripHTMLTags = staticmethod(replaced_by_pep8("stripHTMLTags", strip_html_tags))
+    upcaseTokens = staticmethod(replaced_by_pep8("upcaseTokens", upcase_tokens))
+    downcaseTokens = staticmethod(replaced_by_pep8("downcaseTokens", downcase_tokens))
+    # fmt: on
 
 
 _builtin_exprs = [
diff --git a/lib/pyparsing/core.py b/lib/pyparsing/core.py
index b19d1221..cbe73c98 100644
--- a/lib/pyparsing/core.py
+++ b/lib/pyparsing/core.py
@@ -53,6 +53,11 @@ from .unicode import pyparsing_unicode
 _MAX_INT = sys.maxsize
 str_type: Tuple[type, ...] = (str, bytes)
 
+if sys.version_info >= (3, 7):
+    _RePattern = re.Pattern
+else:
+    _RePattern = typing.Pattern
+
 #
 # Copyright (c) 2003-2022  Paul T. McGuire
 #
@@ -218,19 +223,11 @@ if _should_enable_warnings(
 
 
 # build list of single arg builtins, that can be used as parse actions
+# fmt: off
 _single_arg_builtins = {
-    sum,
-    len,
-    sorted,
-    reversed,
-    list,
-    tuple,
-    set,
-    any,
-    all,
-    min,
-    max,
+    sum, len, sorted, reversed, list, tuple, set, any, all, min, max
 }
+# fmt: on
 
 _generatorType = types.GeneratorType
 ParseImplReturnType = Tuple[int, Any]
@@ -255,13 +252,13 @@ DebugSuccessAction = Callable[
 DebugExceptionAction = Callable[[str, int, "ParserElement", Exception, bool], None]
 
 
-alphas = string.ascii_uppercase + string.ascii_lowercase
-identchars = pyparsing_unicode.Latin1.identchars
-identbodychars = pyparsing_unicode.Latin1.identbodychars
-nums = "0123456789"
-hexnums = nums + "ABCDEFabcdef"
-alphanums = alphas + nums
-printables = "".join([c for c in string.printable if c not in string.whitespace])
+alphas: str = string.ascii_uppercase + string.ascii_lowercase
+identchars: str = pyparsing_unicode.Latin1.identchars
+identbodychars: str = pyparsing_unicode.Latin1.identbodychars
+nums: str = "0123456789"
+hexnums: str = nums + "ABCDEFabcdef"
+alphanums: str = alphas + nums
+printables: str = "".join([c for c in string.printable if c not in string.whitespace])
 
 _trim_arity_call_line: traceback.StackSummary = None  # type: ignore[assignment]
 
@@ -280,7 +277,7 @@ def _trim_arity(func, max_limit=3):
     # user's parse action 'func', so that we don't incur call penalty at parse time
 
     # fmt: off
-    LINE_DIFF = 7
+    LINE_DIFF = 9
     # IF ANY CODE CHANGES, EVEN JUST COMMENTS OR BLANK LINES, BETWEEN THE NEXT LINE AND
     # THE CALL TO FUNC INSIDE WRAPPER, LINE_DIFF MUST BE MODIFIED!!!!
     _trim_arity_call_line = (_trim_arity_call_line or traceback.extract_stack(limit=2)[-1])
@@ -288,6 +285,8 @@ def _trim_arity(func, max_limit=3):
 
     def wrapper(*args):
         nonlocal found_arity, limit
+        if found_arity:
+            return func(*args[limit:])
         while 1:
             try:
                 ret = func(*args[limit:])
@@ -476,7 +475,7 @@ class ParserElement(ABC):
         self.streamlined = False
         # optimize exception handling for subclasses that don't advance parse index
         self.mayIndexError = True
-        self.errmsg = ""
+        self.errmsg: Union[str, None] = ""
         # mark results names as modal (report only last) or cumulative (list all)
         self.modalResults = True
         # custom debug actions
@@ -582,15 +581,15 @@ class ParserElement(ABC):
         listAllMatches = listAllMatches or list_all_matches
         return self._setResultsName(name, listAllMatches)
 
-    def _setResultsName(self, name, listAllMatches=False):
+    def _setResultsName(self, name, list_all_matches=False) -> "ParserElement":
         if name is None:
             return self
         newself = self.copy()
         if name.endswith("*"):
             name = name[:-1]
-            listAllMatches = True
+            list_all_matches = True
         newself.resultsName = name
-        newself.modalResults = not listAllMatches
+        newself.modalResults = not list_all_matches
         return newself
 
     def set_break(self, break_flag: bool = True) -> "ParserElement":
@@ -602,12 +601,12 @@ class ParserElement(ABC):
         if break_flag:
             _parseMethod = self._parse
 
-            def breaker(instring, loc, doActions=True, callPreParse=True):
+            def breaker(instring, loc, do_actions=True, callPreParse=True):
                 import pdb
 
                 # this call to pdb.set_trace() is intentional, not a checkin error
                 pdb.set_trace()
-                return _parseMethod(instring, loc, doActions, callPreParse)
+                return _parseMethod(instring, loc, do_actions, callPreParse)
 
             breaker._originalParseMethod = _parseMethod  # type: ignore [attr-defined]
             self._parse = breaker  # type: ignore [assignment]
@@ -615,7 +614,7 @@ class ParserElement(ABC):
             self._parse = self._parse._originalParseMethod  # type: ignore [attr-defined, assignment]
         return self
 
-    def set_parse_action(self, *fns: ParseAction, **kwargs) -> "ParserElement":
+    def set_parse_action(self, *fns: ParseAction, **kwargs: Any) -> "ParserElement":
         """
         Define one or more actions to perform when successfully matching parse element definition.
 
@@ -691,19 +690,19 @@ class ParserElement(ABC):
                 ''')
         """
         if list(fns) == [None]:
-            self.parseAction = []
+            self.parseAction.clear()
             return self
 
         if not all(callable(fn) for fn in fns):
             raise TypeError("parse actions must be callable")
-        self.parseAction = [_trim_arity(fn) for fn in fns]
+        self.parseAction[:] = [_trim_arity(fn) for fn in fns]
         self.callDuringTry = kwargs.get(
             "call_during_try", kwargs.get("callDuringTry", False)
         )
 
         return self
 
-    def add_parse_action(self, *fns: ParseAction, **kwargs) -> "ParserElement":
+    def add_parse_action(self, *fns: ParseAction, **kwargs: Any) -> "ParserElement":
         """
         Add one or more parse actions to expression's list of parse actions. See :class:`set_parse_action`.
 
@@ -715,7 +714,7 @@ class ParserElement(ABC):
         )
         return self
 
-    def add_condition(self, *fns: ParseCondition, **kwargs) -> "ParserElement":
+    def add_condition(self, *fns: ParseCondition, **kwargs: Any) -> "ParserElement":
         """Add a boolean predicate function to expression's list of parse actions. See
         :class:`set_parse_action` for function call signatures. Unlike ``set_parse_action``,
         functions passed to ``add_condition`` need to return boolean success/fail of the condition.
@@ -801,7 +800,7 @@ class ParserElement(ABC):
 
         return loc
 
-    def parseImpl(self, instring, loc, doActions=True):
+    def parseImpl(self, instring, loc, do_actions=True) -> ParseImplReturnType:
         return loc, []
 
     def postParse(self, instring, loc, tokenlist):
@@ -809,10 +808,10 @@ class ParserElement(ABC):
 
     # @profile
     def _parseNoCache(
-        self, instring, loc, doActions=True, callPreParse=True
+        self, instring, loc, do_actions=True, callPreParse=True
     ) -> Tuple[int, ParseResults]:
         TRY, MATCH, FAIL = 0, 1, 2
-        debugging = self.debug  # and doActions)
+        debugging = self.debug  # and do_actions)
         len_instring = len(instring)
 
         if debugging or self.failAction:
@@ -827,11 +826,11 @@ class ParserElement(ABC):
                     self.debugActions.debug_try(instring, tokens_start, self, False)
                 if self.mayIndexError or pre_loc >= len_instring:
                     try:
-                        loc, tokens = self.parseImpl(instring, pre_loc, doActions)
+                        loc, tokens = self.parseImpl(instring, pre_loc, do_actions)
                     except IndexError:
                         raise ParseException(instring, len_instring, self.errmsg, self)
                 else:
-                    loc, tokens = self.parseImpl(instring, pre_loc, doActions)
+                    loc, tokens = self.parseImpl(instring, pre_loc, do_actions)
             except Exception as err:
                 # print("Exception raised:", err)
                 if self.debugActions.debug_fail:
@@ -849,18 +848,18 @@ class ParserElement(ABC):
             tokens_start = pre_loc
             if self.mayIndexError or pre_loc >= len_instring:
                 try:
-                    loc, tokens = self.parseImpl(instring, pre_loc, doActions)
+                    loc, tokens = self.parseImpl(instring, pre_loc, do_actions)
                 except IndexError:
                     raise ParseException(instring, len_instring, self.errmsg, self)
             else:
-                loc, tokens = self.parseImpl(instring, pre_loc, doActions)
+                loc, tokens = self.parseImpl(instring, pre_loc, do_actions)
 
         tokens = self.postParse(instring, loc, tokens)
 
         ret_tokens = ParseResults(
             tokens, self.resultsName, asList=self.saveAsList, modal=self.modalResults
         )
-        if self.parseAction and (doActions or self.callDuringTry):
+        if self.parseAction and (do_actions or self.callDuringTry):
             if debugging:
                 try:
                     for fn in self.parseAction:
@@ -919,7 +918,7 @@ class ParserElement(ABC):
         do_actions: bool = False,
     ) -> int:
         try:
-            return self._parse(instring, loc, doActions=do_actions)[0]
+            return self._parse(instring, loc, do_actions=do_actions)[0]
         except ParseFatalException:
             if raise_fatal:
                 raise
@@ -960,18 +959,18 @@ class ParserElement(ABC):
     # this method gets repeatedly called during backtracking with the same arguments -
     # we can cache these arguments and save ourselves the trouble of re-parsing the contained expression
     def _parseCache(
-        self, instring, loc, doActions=True, callPreParse=True
+        self, instring, loc, do_actions=True, callPreParse=True
     ) -> Tuple[int, ParseResults]:
         HIT, MISS = 0, 1
         TRY, MATCH, FAIL = 0, 1, 2
-        lookup = (self, instring, loc, callPreParse, doActions)
+        lookup = (self, instring, loc, callPreParse, do_actions)
         with ParserElement.packrat_cache_lock:
             cache = ParserElement.packrat_cache
             value = cache.get(lookup)
             if value is cache.not_in_cache:
                 ParserElement.packrat_cache_stats[MISS] += 1
                 try:
-                    value = self._parseNoCache(instring, loc, doActions, callPreParse)
+                    value = self._parseNoCache(instring, loc, do_actions, callPreParse)
                 except ParseBaseException as pe:
                     # cache a copy of the exception, without the traceback
                     cache.set(lookup, pe.__class__(*pe.args))
@@ -1190,7 +1189,7 @@ class ParserElement(ABC):
             loc, tokens = self._parse(instring, 0)
             if parseAll:
                 loc = self.preParse(instring, loc)
-                se = Empty() + StringEnd()
+                se = Empty() + StringEnd().set_debug(False)
                 se._parse(instring, loc)
         except ParseBaseException as exc:
             if ParserElement.verbose_stacktrace:
@@ -1887,9 +1886,14 @@ class ParserElement(ABC):
         Child classes must define this method, which defines how the ``default_name`` is set.
         """
 
-    def set_name(self, name: str) -> "ParserElement":
+    def set_name(self, name: typing.Optional[str]) -> "ParserElement":
         """
-        Define name for this expression, makes debugging and exception messages clearer.
+        Define name for this expression, makes debugging and exception messages clearer. If
+        `__diag__.enable_debug_on_named_expressions` is set to True, setting a name will also
+        enable debug for this expression.
+
+        If `name` is None, clears any custom name for this expression, and clears the
+        debug flag is it was enabled via `__diag__.enable_debug_on_named_expressions`.
 
         Example::
 
@@ -1900,9 +1904,11 @@ class ParserElement(ABC):
             integer.parse_string("ABC")  # -> Exception: Expected integer (at char 0), (line:1, col:1)
         """
         self.customName = name
-        self.errmsg = f"Expected {self.name}"
+        self.errmsg = f"Expected {str(self)}"
+
         if __diag__.enable_debug_on_named_expressions:
-            self.set_debug()
+            self.set_debug(name is not None)
+
         return self
 
     @property
@@ -1910,6 +1916,10 @@ class ParserElement(ABC):
         # This will use a user-defined name if available, but otherwise defaults back to the auto-generated name
         return self.customName if self.customName is not None else self.default_name
 
+    @name.setter
+    def name(self, new_name) -> None:
+        self.set_name(new_name)
+
     def __str__(self) -> str:
         return self.name
 
@@ -2014,7 +2024,9 @@ class ParserElement(ABC):
         full_dump: bool = True,
         print_results: bool = True,
         failure_tests: bool = False,
-        post_parse: typing.Optional[Callable[[str, ParseResults], str]] = None,
+        post_parse: typing.Optional[
+            Callable[[str, ParseResults], typing.Optional[str]]
+        ] = None,
         file: typing.Optional[TextIO] = None,
         with_line_numbers: bool = False,
         *,
@@ -2022,7 +2034,9 @@ class ParserElement(ABC):
         fullDump: bool = True,
         printResults: bool = True,
         failureTests: bool = False,
-        postParse: typing.Optional[Callable[[str, ParseResults], str]] = None,
+        postParse: typing.Optional[
+            Callable[[str, ParseResults], typing.Optional[str]]
+        ] = None,
     ) -> Tuple[bool, List[Tuple[str, Union[ParseResults, Exception]]]]:
         """
         Execute the parse expression on a series of test strings, showing each
@@ -2159,7 +2173,7 @@ class ParserElement(ABC):
                 f"{nlstr}{nlstr.join(comments) if comments else ''}",
                 pyparsing_test.with_line_numbers(t) if with_line_numbers else t,
             ]
-            comments = []
+            comments.clear()
             try:
                 # convert newline marks to actual newlines, and strip leading BOM if present
                 t = NL.transform_string(t.lstrip(BOM))
@@ -2264,10 +2278,15 @@ class ParserElement(ABC):
 
     # Compatibility synonyms
     # fmt: off
-    inlineLiteralsUsing = replaced_by_pep8("inlineLiteralsUsing", inline_literals_using)
-    setDefaultWhitespaceChars = replaced_by_pep8(
+    inlineLiteralsUsing = staticmethod(replaced_by_pep8("inlineLiteralsUsing", inline_literals_using))
+    setDefaultWhitespaceChars = staticmethod(replaced_by_pep8(
         "setDefaultWhitespaceChars", set_default_whitespace_chars
-    )
+    ))
+    disableMemoization = staticmethod(replaced_by_pep8("disableMemoization", disable_memoization))
+    enableLeftRecursion = staticmethod(replaced_by_pep8("enableLeftRecursion", enable_left_recursion))
+    enablePackrat = staticmethod(replaced_by_pep8("enablePackrat", enable_packrat))
+    resetCache = staticmethod(replaced_by_pep8("resetCache", reset_cache))
+
     setResultsName = replaced_by_pep8("setResultsName", set_results_name)
     setBreak = replaced_by_pep8("setBreak", set_break)
     setParseAction = replaced_by_pep8("setParseAction", set_parse_action)
@@ -2275,8 +2294,6 @@ class ParserElement(ABC):
     addCondition = replaced_by_pep8("addCondition", add_condition)
     setFailAction = replaced_by_pep8("setFailAction", set_fail_action)
     tryParse = replaced_by_pep8("tryParse", try_parse)
-    enableLeftRecursion = replaced_by_pep8("enableLeftRecursion", enable_left_recursion)
-    enablePackrat = replaced_by_pep8("enablePackrat", enable_packrat)
     parseString = replaced_by_pep8("parseString", parse_string)
     scanString = replaced_by_pep8("scanString", scan_string)
     transformString = replaced_by_pep8("transformString", transform_string)
@@ -2290,8 +2307,7 @@ class ParserElement(ABC):
     setName = replaced_by_pep8("setName", set_name)
     parseFile = replaced_by_pep8("parseFile", parse_file)
     runTests = replaced_by_pep8("runTests", run_tests)
-    canParseNext = can_parse_next
-    resetCache = reset_cache
+    canParseNext = replaced_by_pep8("canParseNext", can_parse_next)
     defaultName = default_name
     # fmt: on
 
@@ -2331,7 +2347,7 @@ class _PendingSkip(ParserElement):
     def __repr__(self):
         return self.defaultName
 
-    def parseImpl(self, *args):
+    def parseImpl(self, *args) -> ParseImplReturnType:
         raise Exception(
             "use of `...` expression without following SkipTo target expression"
         )
@@ -2360,7 +2376,7 @@ class NoMatch(Token):
         self.mayIndexError = False
         self.errmsg = "Unmatchable token"
 
-    def parseImpl(self, instring, loc, doActions=True):
+    def parseImpl(self, instring, loc, do_actions=True) -> ParseImplReturnType:
         raise ParseException(instring, loc, self.errmsg, self)
 
 
@@ -2409,7 +2425,7 @@ class Literal(Token):
     def _generateDefaultName(self) -> str:
         return repr(self.match)
 
-    def parseImpl(self, instring, loc, doActions=True):
+    def parseImpl(self, instring, loc, do_actions=True) -> ParseImplReturnType:
         if instring[loc] == self.firstMatchChar and instring.startswith(
             self.match, loc
         ):
@@ -2430,12 +2446,12 @@ class Empty(Literal):
     def _generateDefaultName(self) -> str:
         return "Empty"
 
-    def parseImpl(self, instring, loc, doActions=True):
+    def parseImpl(self, instring, loc, do_actions=True) -> ParseImplReturnType:
         return loc, []
 
 
 class _SingleCharLiteral(Literal):
-    def parseImpl(self, instring, loc, doActions=True):
+    def parseImpl(self, instring, loc, do_actions=True) -> ParseImplReturnType:
         if instring[loc] == self.firstMatchChar:
             return loc + 1, self.match
         raise ParseException(instring, loc, self.errmsg, self)
@@ -2505,7 +2521,7 @@ class Keyword(Token):
     def _generateDefaultName(self) -> str:
         return repr(self.match)
 
-    def parseImpl(self, instring, loc, doActions=True):
+    def parseImpl(self, instring, loc, do_actions=True) -> ParseImplReturnType:
         errmsg = self.errmsg
         errloc = loc
         if self.caseless:
@@ -2556,7 +2572,10 @@ class Keyword(Token):
         """
         Keyword.DEFAULT_KEYWORD_CHARS = chars
 
-    setDefaultKeywordChars = set_default_keyword_chars
+    # Compatibility synonyms
+    setDefaultKeywordChars = staticmethod(
+        replaced_by_pep8("setDefaultKeywordChars", set_default_keyword_chars)
+    )
 
 
 class CaselessLiteral(Literal):
@@ -2580,7 +2599,7 @@ class CaselessLiteral(Literal):
         self.returnString = match_string
         self.errmsg = f"Expected {self.name}"
 
-    def parseImpl(self, instring, loc, doActions=True):
+    def parseImpl(self, instring, loc, do_actions=True) -> ParseImplReturnType:
         if instring[loc : loc + self.matchLen].upper() == self.match:
             return loc + self.matchLen, self.returnString
         raise ParseException(instring, loc, self.errmsg, self)
@@ -2666,7 +2685,7 @@ class CloseMatch(Token):
     def _generateDefaultName(self) -> str:
         return f"{type(self).__name__}:{self.match_string!r}"
 
-    def parseImpl(self, instring, loc, doActions=True):
+    def parseImpl(self, instring, loc, do_actions=True) -> ParseImplReturnType:
         start = loc
         instrlen = len(instring)
         maxloc = start + len(self.match_string)
@@ -2911,36 +2930,36 @@ class Word(Token):
                 return base + f"{{{self.minLen},{self.maxLen}}}"
         return base
 
-    def parseImpl(self, instring, loc, doActions=True):
+    def parseImpl(self, instring, loc, do_actions=True) -> ParseImplReturnType:
         if instring[loc] not in self.initChars:
             raise ParseException(instring, loc, self.errmsg, self)
 
         start = loc
         loc += 1
         instrlen = len(instring)
-        bodychars = self.bodyChars
+        body_chars: set[str] = self.bodyChars
         maxloc = start + self.maxLen
         maxloc = min(maxloc, instrlen)
-        while loc < maxloc and instring[loc] in bodychars:
+        while loc < maxloc and instring[loc] in body_chars:
             loc += 1
 
-        throwException = False
+        throw_exception = False
         if loc - start < self.minLen:
-            throwException = True
-        elif self.maxSpecified and loc < instrlen and instring[loc] in bodychars:
-            throwException = True
+            throw_exception = True
+        elif self.maxSpecified and loc < instrlen and instring[loc] in body_chars:
+            throw_exception = True
         elif self.asKeyword and (
-            (start > 0 and instring[start - 1] in bodychars)
-            or (loc < instrlen and instring[loc] in bodychars)
+            (start > 0 and instring[start - 1] in body_chars)
+            or (loc < instrlen and instring[loc] in body_chars)
         ):
-            throwException = True
+            throw_exception = True
 
-        if throwException:
+        if throw_exception:
             raise ParseException(instring, loc, self.errmsg, self)
 
         return loc, instring[start:loc]
 
-    def parseImpl_regex(self, instring, loc, doActions=True):
+    def parseImpl_regex(self, instring, loc, do_actions=True) -> ParseImplReturnType:
         result = self.re_match(instring, loc)
         if not result:
             raise ParseException(instring, loc, self.errmsg, self)
@@ -3043,7 +3062,7 @@ class Regex(Token):
             self.parseImpl = self.parseImplAsMatch  # type: ignore [assignment]
 
     @cached_property
-    def re(self):
+    def re(self) -> _RePattern:
         if self._re:
             return self._re
 
@@ -3053,17 +3072,18 @@ class Regex(Token):
             raise ValueError(f"invalid pattern ({self.pattern!r}) passed to Regex")
 
     @cached_property
-    def re_match(self):
+    def re_match(self) -> Callable[[str], Any]:
         return self.re.match
 
     @cached_property
-    def mayReturnEmpty(self):
+    def mayReturnEmpty(self) -> bool:
         return self.re_match("") is not None
 
     def _generateDefaultName(self) -> str:
-        return "Re:({})".format(repr(self.pattern).replace("\\\\", "\\"))
+        unescaped = self.pattern.replace("\\\\", "\\")
+        return f"Re:({unescaped!r})"
 
-    def parseImpl(self, instring, loc, doActions=True):
+    def parseImpl(self, instring, loc, do_actions=True) -> ParseImplReturnType:
         result = self.re_match(instring, loc)
         if not result:
             raise ParseException(instring, loc, self.errmsg, self)
@@ -3077,7 +3097,7 @@ class Regex(Token):
 
         return loc, ret
 
-    def parseImplAsGroupList(self, instring, loc, doActions=True):
+    def parseImplAsGroupList(self, instring, loc, do_actions=True):
         result = self.re_match(instring, loc)
         if not result:
             raise ParseException(instring, loc, self.errmsg, self)
@@ -3086,7 +3106,7 @@ class Regex(Token):
         ret = result.groups()
         return loc, ret
 
-    def parseImplAsMatch(self, instring, loc, doActions=True):
+    def parseImplAsMatch(self, instring, loc, do_actions=True):
         result = self.re_match(instring, loc)
         if not result:
             raise ParseException(instring, loc, self.errmsg, self)
@@ -3223,7 +3243,7 @@ class QuotedString(Token):
 
         # fmt: off
         # build up re pattern for the content between the quote delimiters
-        inner_pattern = []
+        inner_pattern: List[str] = []
 
         if esc_quote:
             inner_pattern.append(rf"(?:{re.escape(esc_quote)})")
@@ -3245,12 +3265,12 @@ class QuotedString(Token):
             self.re_flags |= re.MULTILINE | re.DOTALL
             inner_pattern.append(
                 rf"(?:[^{_escape_regex_range_chars(self.end_quote_char[0])}"
-                rf"{(_escape_regex_range_chars(esc_char) if self.has_esc_char else '')}])"
+                rf"{(_escape_regex_range_chars(self.esc_char) if self.has_esc_char else '')}])"
             )
         else:
             inner_pattern.append(
                 rf"(?:[^{_escape_regex_range_chars(self.end_quote_char[0])}\n\r"
-                rf"{(_escape_regex_range_chars(esc_char) if self.has_esc_char else '')}])"
+                rf"{(_escape_regex_range_chars(self.esc_char) if self.has_esc_char else '')}])"
             )
 
         self.pattern = "".join(
@@ -3298,7 +3318,7 @@ class QuotedString(Token):
 
         return f"quoted string, starting with {self.quote_char} ending with {self.end_quote_char}"
 
-    def parseImpl(self, instring, loc, doActions=True):
+    def parseImpl(self, instring, loc, do_actions=True) -> ParseImplReturnType:
         # check first character of opening quote to see if that is a match
         # before doing the more complicated regex match
         result = (
@@ -3412,7 +3432,7 @@ class CharsNotIn(Token):
         else:
             return f"!W:({self.notChars})"
 
-    def parseImpl(self, instring, loc, doActions=True):
+    def parseImpl(self, instring, loc, do_actions=True) -> ParseImplReturnType:
         notchars = self.notCharsSet
         if instring[loc] in notchars:
             raise ParseException(instring, loc, self.errmsg, self)
@@ -3490,7 +3510,7 @@ class White(Token):
     def _generateDefaultName(self) -> str:
         return "".join(White.whiteStrs[c] for c in self.matchWhite)
 
-    def parseImpl(self, instring, loc, doActions=True):
+    def parseImpl(self, instring, loc, do_actions=True) -> ParseImplReturnType:
         if instring[loc] not in self.matchWhite:
             raise ParseException(instring, loc, self.errmsg, self)
         start = loc
@@ -3538,7 +3558,7 @@ class GoToColumn(PositionToken):
 
         return loc
 
-    def parseImpl(self, instring, loc, doActions=True):
+    def parseImpl(self, instring, loc, do_actions=True) -> ParseImplReturnType:
         thiscol = col(loc, instring)
         if thiscol > self.col:
             raise ParseException(instring, loc, "Text not in expected column", self)
@@ -3576,7 +3596,7 @@ class LineStart(PositionToken):
         self.orig_whiteChars = set() | self.whiteChars
         self.whiteChars.discard("\n")
         self.skipper = Empty().set_whitespace_chars(self.whiteChars)
-        self.errmsg = "Expected start of line"
+        self.set_name("start of line")
 
     def preParse(self, instring: str, loc: int) -> int:
         if loc == 0:
@@ -3590,7 +3610,7 @@ class LineStart(PositionToken):
 
         return ret
 
-    def parseImpl(self, instring, loc, doActions=True):
+    def parseImpl(self, instring, loc, do_actions=True) -> ParseImplReturnType:
         if col(loc, instring) == 1:
             return loc, []
         raise ParseException(instring, loc, self.errmsg, self)
@@ -3605,9 +3625,9 @@ class LineEnd(PositionToken):
         super().__init__()
         self.whiteChars.discard("\n")
         self.set_whitespace_chars(self.whiteChars, copy_defaults=False)
-        self.errmsg = "Expected end of line"
+        self.set_name("end of line")
 
-    def parseImpl(self, instring, loc, doActions=True):
+    def parseImpl(self, instring, loc, do_actions=True) -> ParseImplReturnType:
         if loc < len(instring):
             if instring[loc] == "\n":
                 return loc + 1, "\n"
@@ -3626,9 +3646,9 @@ class StringStart(PositionToken):
 
     def __init__(self):
         super().__init__()
-        self.errmsg = "Expected start of text"
+        self.set_name("start of text")
 
-    def parseImpl(self, instring, loc, doActions=True):
+    def parseImpl(self, instring, loc, do_actions=True) -> ParseImplReturnType:
         # see if entire string up to here is just whitespace and ignoreables
         if loc != 0 and loc != self.preParse(instring, 0):
             raise ParseException(instring, loc, self.errmsg, self)
@@ -3643,9 +3663,9 @@ class StringEnd(PositionToken):
 
     def __init__(self):
         super().__init__()
-        self.errmsg = "Expected end of text"
+        self.set_name("end of text")
 
-    def parseImpl(self, instring, loc, doActions=True):
+    def parseImpl(self, instring, loc, do_actions=True) -> ParseImplReturnType:
         if loc < len(instring):
             raise ParseException(instring, loc, self.errmsg, self)
         if loc == len(instring):
@@ -3670,9 +3690,9 @@ class WordStart(PositionToken):
         wordChars = word_chars if wordChars == printables else wordChars
         super().__init__()
         self.wordChars = set(wordChars)
-        self.errmsg = "Not at the start of a word"
+        self.set_name("start of a word")
 
-    def parseImpl(self, instring, loc, doActions=True):
+    def parseImpl(self, instring, loc, do_actions=True) -> ParseImplReturnType:
         if loc != 0:
             if (
                 instring[loc - 1] in self.wordChars
@@ -3696,9 +3716,9 @@ class WordEnd(PositionToken):
         super().__init__()
         self.wordChars = set(wordChars)
         self.skipWhitespace = False
-        self.errmsg = "Not at the end of a word"
+        self.set_name("end of a word")
 
-    def parseImpl(self, instring, loc, doActions=True):
+    def parseImpl(self, instring, loc, do_actions=True) -> ParseImplReturnType:
         instrlen = len(instring)
         if instrlen > 0 and loc < instrlen:
             if (
@@ -3709,6 +3729,47 @@ class WordEnd(PositionToken):
         return loc, []
 
 
+class Tag(Token):
+    """
+    A meta-element for inserting a named result into the parsed
+    tokens that may be checked later in a parse action or while
+    processing the parsed results. Accepts an optional tag value,
+    defaulting to `True`.
+
+    Example::
+
+        end_punc = "." | ("!" + Tag("enthusiastic")))
+        greeting = "Hello," + Word(alphas) + end_punc
+
+        result = greeting.parse_string("Hello, World.")
+        print(result.dump())
+
+        result = greeting.parse_string("Hello, World!")
+        print(result.dump())
+
+    prints::
+
+        ['Hello,', 'World', '.']
+
+        ['Hello,', 'World', '!']
+        - enthusiastic: True
+    """
+    def __init__(self, tag_name: str, value: Any = True):
+        super().__init__()
+        self.mayReturnEmpty = True
+        self.mayIndexError = False
+        self.leave_whitespace()
+        self.tag_name = tag_name
+        self.tag_value = value
+        self.add_parse_action(self._add_tag)
+
+    def _add_tag(self, tokens: ParseResults):
+        tokens[self.tag_name] = self.tag_value
+
+    def _generateDefaultName(self) -> str:
+        return f"{type(self).__name__}:{self.tag_name}={self.tag_value!r}"
+
+
 class ParseExpression(ParserElement):
     """Abstract subclass of ParserElement, for combining and
     post-processing parsed tokens.
@@ -3846,13 +3907,13 @@ class ParseExpression(ParserElement):
         ret.exprs = [e.copy() for e in self.exprs]
         return ret
 
-    def _setResultsName(self, name, listAllMatches=False):
+    def _setResultsName(self, name, list_all_matches=False) -> ParserElement:
         if not (
             __diag__.warn_ungrouped_named_tokens_in_collection
             and Diagnostics.warn_ungrouped_named_tokens_in_collection
             not in self.suppress_warnings_
         ):
-            return super()._setResultsName(name, listAllMatches)
+            return super()._setResultsName(name, list_all_matches)
 
         for e in self.exprs:
             if (
@@ -3871,7 +3932,7 @@ class ParseExpression(ParserElement):
                 warnings.warn(warning, stacklevel=3)
                 break
 
-        return super()._setResultsName(name, listAllMatches)
+        return super()._setResultsName(name, list_all_matches)
 
     # Compatibility synonyms
     # fmt: off
@@ -3911,7 +3972,7 @@ class And(ParseExpression):
     ):
         exprs: List[ParserElement] = list(exprs_arg)
         if exprs and Ellipsis in exprs:
-            tmp = []
+            tmp: List[ParserElement] = []
             for i, expr in enumerate(exprs):
                 if expr is not Ellipsis:
                     tmp.append(expr)
@@ -3991,11 +4052,11 @@ class And(ParseExpression):
         self.mayReturnEmpty = all(e.mayReturnEmpty for e in self.exprs)
         return self
 
-    def parseImpl(self, instring, loc, doActions=True):
+    def parseImpl(self, instring, loc, do_actions=True):
         # pass False as callPreParse arg to _parse for first element, since we already
         # pre-parsed the string as part of our And pre-parsing
         loc, resultlist = self.exprs[0]._parse(
-            instring, loc, doActions, callPreParse=False
+            instring, loc, do_actions, callPreParse=False
         )
         errorStop = False
         for e in self.exprs[1:]:
@@ -4005,7 +4066,7 @@ class And(ParseExpression):
                 continue
             if errorStop:
                 try:
-                    loc, exprtokens = e._parse(instring, loc, doActions)
+                    loc, exprtokens = e._parse(instring, loc, do_actions)
                 except ParseSyntaxException:
                     raise
                 except ParseBaseException as pe:
@@ -4016,7 +4077,7 @@ class And(ParseExpression):
                         instring, len(instring), self.errmsg, self
                     )
             else:
-                loc, exprtokens = e._parse(instring, loc, doActions)
+                loc, exprtokens = e._parse(instring, loc, do_actions)
             resultlist += exprtokens
         return loc, resultlist
 
@@ -4080,11 +4141,11 @@ class Or(ParseExpression):
             self.saveAsList = False
         return self
 
-    def parseImpl(self, instring, loc, doActions=True):
+    def parseImpl(self, instring, loc, do_actions=True) -> ParseImplReturnType:
         maxExcLoc = -1
         maxException = None
-        matches = []
-        fatals = []
+        matches: List[Tuple[int, ParserElement]] = []
+        fatals: List[ParseFatalException] = []
         if all(e.callPreparse for e in self.exprs):
             loc = self.preParse(instring, loc)
         for e in self.exprs:
@@ -4117,11 +4178,11 @@ class Or(ParseExpression):
             # might change whether or how much they match of the input.
             matches.sort(key=itemgetter(0), reverse=True)
 
-            if not doActions:
+            if not do_actions:
                 # no further conditions or parse actions to change the selection of
                 # alternative, so the first match will be the best match
                 best_expr = matches[0][1]
-                return best_expr._parse(instring, loc, doActions)
+                return best_expr._parse(instring, loc, do_actions)
 
             longest = -1, None
             for loc1, expr1 in matches:
@@ -4130,7 +4191,7 @@ class Or(ParseExpression):
                     return longest
 
                 try:
-                    loc2, toks = expr1._parse(instring, loc, doActions)
+                    loc2, toks = expr1._parse(instring, loc, do_actions)
                 except ParseException as err:
                     err.__traceback__ = None
                     if err.loc > maxExcLoc:
@@ -4173,7 +4234,7 @@ class Or(ParseExpression):
     def _generateDefaultName(self) -> str:
         return f"{{{' ^ '.join(str(e) for e in self.exprs)}}}"
 
-    def _setResultsName(self, name, listAllMatches=False):
+    def _setResultsName(self, name, list_all_matches=False) -> ParserElement:
         if (
             __diag__.warn_multiple_tokens_in_named_alternation
             and Diagnostics.warn_multiple_tokens_in_named_alternation
@@ -4194,7 +4255,7 @@ class Or(ParseExpression):
                 )
                 warnings.warn(warning, stacklevel=3)
 
-        return super()._setResultsName(name, listAllMatches)
+        return super()._setResultsName(name, list_all_matches)
 
 
 class MatchFirst(ParseExpression):
@@ -4239,13 +4300,13 @@ class MatchFirst(ParseExpression):
             self.mayReturnEmpty = True
         return self
 
-    def parseImpl(self, instring, loc, doActions=True):
+    def parseImpl(self, instring, loc, do_actions=True) -> ParseImplReturnType:
         maxExcLoc = -1
         maxException = None
 
         for e in self.exprs:
             try:
-                return e._parse(instring, loc, doActions)
+                return e._parse(instring, loc, do_actions)
             except ParseFatalException as pfe:
                 pfe.__traceback__ = None
                 pfe.parser_element = e
@@ -4280,7 +4341,7 @@ class MatchFirst(ParseExpression):
     def _generateDefaultName(self) -> str:
         return f"{{{' | '.join(str(e) for e in self.exprs)}}}"
 
-    def _setResultsName(self, name, listAllMatches=False):
+    def _setResultsName(self, name, list_all_matches=False) -> ParserElement:
         if (
             __diag__.warn_multiple_tokens_in_named_alternation
             and Diagnostics.warn_multiple_tokens_in_named_alternation
@@ -4301,7 +4362,7 @@ class MatchFirst(ParseExpression):
                 )
                 warnings.warn(warning, stacklevel=3)
 
-        return super()._setResultsName(name, listAllMatches)
+        return super()._setResultsName(name, list_all_matches)
 
 
 class Each(ParseExpression):
@@ -4387,7 +4448,7 @@ class Each(ParseExpression):
             self.mayReturnEmpty = True
         return self
 
-    def parseImpl(self, instring, loc, doActions=True):
+    def parseImpl(self, instring, loc, do_actions=True) -> ParseImplReturnType:
         if self.initExprGroups:
             self.opt1map = dict(
                 (id(e.expr), e) for e in self.exprs if isinstance(e, Opt)
@@ -4419,11 +4480,11 @@ class Each(ParseExpression):
         tmpReqd = self.required[:]
         tmpOpt = self.optionals[:]
         multis = self.multioptionals[:]
-        matchOrder = []
+        matchOrder: List[ParserElement] = []
 
         keepMatching = True
-        failed = []
-        fatals = []
+        failed: List[ParserElement] = []
+        fatals: List[ParseFatalException] = []
         while keepMatching:
             tmpExprs = tmpReqd + tmpOpt + multis
             failed.clear()
@@ -4469,7 +4530,7 @@ class Each(ParseExpression):
 
         total_results = ParseResults([])
         for e in matchOrder:
-            loc, results = e._parse(instring, loc, doActions)
+            loc, results = e._parse(instring, loc, do_actions)
             total_results += results
 
         return loc, total_results
@@ -4509,12 +4570,14 @@ class ParseElementEnhance(ParserElement):
     def recurse(self) -> List[ParserElement]:
         return [self.expr] if self.expr is not None else []
 
-    def parseImpl(self, instring, loc, doActions=True):
+    def parseImpl(self, instring, loc, do_actions=True):
         if self.expr is None:
             raise ParseException(instring, loc, "No expression defined", self)
 
         try:
-            return self.expr._parse(instring, loc, doActions, callPreParse=False)
+            return self.expr._parse(instring, loc, do_actions, callPreParse=False)
+        except ParseSyntaxException:
+            raise
         except ParseBaseException as pbe:
             if not isinstance(self, Forward) or self.customName is not None:
                 if self.errmsg:
@@ -4611,14 +4674,14 @@ class IndentedBlock(ParseElementEnhance):
         self._grouped = grouped
         self.parent_anchor = 1
 
-    def parseImpl(self, instring, loc, doActions=True):
+    def parseImpl(self, instring, loc, do_actions=True) -> ParseImplReturnType:
         # advance parse position to non-whitespace by using an Empty()
         # this should be the column to be used for all subsequent indented lines
         anchor_loc = Empty().preParse(instring, loc)
 
         # see if self.expr matches at the current location - if not it will raise an exception
         # and no further work is necessary
-        self.expr.try_parse(instring, anchor_loc, do_actions=doActions)
+        self.expr.try_parse(instring, anchor_loc, do_actions=do_actions)
 
         indent_col = col(anchor_loc, instring)
         peer_detect_expr = self._Indent(indent_col)
@@ -4643,7 +4706,7 @@ class IndentedBlock(ParseElementEnhance):
         else:
             wrapper = lambda expr: expr
         return (wrapper(block) + Optional(trailing_undent)).parseImpl(
-            instring, anchor_loc, doActions
+            instring, anchor_loc, do_actions
         )
 
 
@@ -4662,10 +4725,10 @@ class AtStringStart(ParseElementEnhance):
         super().__init__(expr)
         self.callPreparse = False
 
-    def parseImpl(self, instring, loc, doActions=True):
+    def parseImpl(self, instring, loc, do_actions=True) -> ParseImplReturnType:
         if loc != 0:
             raise ParseException(instring, loc, "not found at string start")
-        return super().parseImpl(instring, loc, doActions)
+        return super().parseImpl(instring, loc, do_actions)
 
 
 class AtLineStart(ParseElementEnhance):
@@ -4695,10 +4758,10 @@ class AtLineStart(ParseElementEnhance):
         super().__init__(expr)
         self.callPreparse = False
 
-    def parseImpl(self, instring, loc, doActions=True):
+    def parseImpl(self, instring, loc, do_actions=True) -> ParseImplReturnType:
         if col(loc, instring) != 1:
             raise ParseException(instring, loc, "not found at line start")
-        return super().parseImpl(instring, loc, doActions)
+        return super().parseImpl(instring, loc, do_actions)
 
 
 class FollowedBy(ParseElementEnhance):
@@ -4728,10 +4791,10 @@ class FollowedBy(ParseElementEnhance):
         super().__init__(expr)
         self.mayReturnEmpty = True
 
-    def parseImpl(self, instring, loc, doActions=True):
+    def parseImpl(self, instring, loc, do_actions=True) -> ParseImplReturnType:
         # by using self._expr.parse and deleting the contents of the returned ParseResults list
         # we keep any named results that were defined in the FollowedBy expression
-        _, ret = self.expr._parse(instring, loc, doActions=doActions)
+        _, ret = self.expr._parse(instring, loc, do_actions=do_actions)
         del ret[:]
 
         return loc, ret
@@ -4793,7 +4856,7 @@ class PrecededBy(ParseElementEnhance):
         self.skipWhitespace = False
         self.parseAction.append(lambda s, l, t: t.__delitem__(slice(None, None)))
 
-    def parseImpl(self, instring, loc=0, doActions=True):
+    def parseImpl(self, instring, loc=0, do_actions=True) -> ParseImplReturnType:
         if self.exact:
             if loc < self.retreat:
                 raise ParseException(instring, loc, self.errmsg)
@@ -4848,9 +4911,9 @@ class Located(ParseElementEnhance):
 
     """
 
-    def parseImpl(self, instring, loc, doActions=True):
+    def parseImpl(self, instring, loc, do_actions=True) -> ParseImplReturnType:
         start = loc
-        loc, tokens = self.expr._parse(instring, start, doActions, callPreParse=False)
+        loc, tokens = self.expr._parse(instring, start, do_actions, callPreParse=False)
         ret_tokens = ParseResults([start, tokens, loc])
         ret_tokens["locn_start"] = start
         ret_tokens["value"] = tokens
@@ -4896,8 +4959,8 @@ class NotAny(ParseElementEnhance):
         self.mayReturnEmpty = True
         self.errmsg = f"Found unwanted token, {self.expr}"
 
-    def parseImpl(self, instring, loc, doActions=True):
-        if self.expr.can_parse_next(instring, loc, do_actions=doActions):
+    def parseImpl(self, instring, loc, do_actions=True) -> ParseImplReturnType:
+        if self.expr.can_parse_next(instring, loc, do_actions=do_actions):
             raise ParseException(instring, loc, self.errmsg, self)
         return loc, []
 
@@ -4927,7 +4990,7 @@ class _MultipleMatch(ParseElementEnhance):
         self.not_ender = ~ender if ender is not None else None
         return self
 
-    def parseImpl(self, instring, loc, doActions=True):
+    def parseImpl(self, instring, loc, do_actions=True) -> ParseImplReturnType:
         self_expr_parse = self.expr._parse
         self_skip_ignorables = self._skipIgnorables
         check_ender = self.not_ender is not None
@@ -4938,7 +5001,7 @@ class _MultipleMatch(ParseElementEnhance):
         # if so, fail)
         if check_ender:
             try_not_ender(instring, loc)
-        loc, tokens = self_expr_parse(instring, loc, doActions)
+        loc, tokens = self_expr_parse(instring, loc, do_actions)
         try:
             hasIgnoreExprs = not not self.ignoreExprs
             while 1:
@@ -4948,14 +5011,14 @@ class _MultipleMatch(ParseElementEnhance):
                     preloc = self_skip_ignorables(instring, loc)
                 else:
                     preloc = loc
-                loc, tmptokens = self_expr_parse(instring, preloc, doActions)
+                loc, tmptokens = self_expr_parse(instring, preloc, do_actions)
                 tokens += tmptokens
         except (ParseException, IndexError):
             pass
 
         return loc, tokens
 
-    def _setResultsName(self, name, listAllMatches=False):
+    def _setResultsName(self, name, list_all_matches=False) -> ParserElement:
         if (
             __diag__.warn_ungrouped_named_tokens_in_collection
             and Diagnostics.warn_ungrouped_named_tokens_in_collection
@@ -4978,7 +5041,7 @@ class _MultipleMatch(ParseElementEnhance):
                     warnings.warn(warning, stacklevel=3)
                     break
 
-        return super()._setResultsName(name, listAllMatches)
+        return super()._setResultsName(name, list_all_matches)
 
 
 class OneOrMore(_MultipleMatch):
@@ -5037,9 +5100,9 @@ class ZeroOrMore(_MultipleMatch):
         super().__init__(expr, stopOn=stopOn or stop_on)
         self.mayReturnEmpty = True
 
-    def parseImpl(self, instring, loc, doActions=True):
+    def parseImpl(self, instring, loc, do_actions=True) -> ParseImplReturnType:
         try:
-            return super().parseImpl(instring, loc, doActions)
+            return super().parseImpl(instring, loc, do_actions)
         except (ParseException, IndexError):
             return loc, ParseResults([], name=self.resultsName)
 
@@ -5170,10 +5233,10 @@ class Opt(ParseElementEnhance):
         self.defaultValue = default
         self.mayReturnEmpty = True
 
-    def parseImpl(self, instring, loc, doActions=True):
+    def parseImpl(self, instring, loc, do_actions=True) -> ParseImplReturnType:
         self_expr = self.expr
         try:
-            loc, tokens = self_expr._parse(instring, loc, doActions, callPreParse=False)
+            loc, tokens = self_expr._parse(instring, loc, do_actions, callPreParse=False)
         except (ParseException, IndexError):
             default_value = self.defaultValue
             if default_value is not self.__optionalNotMatched:
@@ -5279,7 +5342,7 @@ class SkipTo(ParseElementEnhance):
             self.failOn = self._literalStringClass(failOn)
         else:
             self.failOn = failOn
-        self.errmsg = "No match found for " + str(self.expr)
+        self.errmsg = f"No match found for {self.expr}"
         self.ignorer = Empty().leave_whitespace()
         self._update_ignorer()
 
@@ -5295,7 +5358,7 @@ class SkipTo(ParseElementEnhance):
         super().ignore(expr)
         self._update_ignorer()
 
-    def parseImpl(self, instring, loc, doActions=True):
+    def parseImpl(self, instring, loc, do_actions=True):
         startloc = loc
         instrlen = len(instring)
         self_expr_parse = self.expr._parse
@@ -5325,7 +5388,7 @@ class SkipTo(ParseElementEnhance):
                     prev_tmploc = tmploc
 
             try:
-                self_expr_parse(instring, tmploc, doActions=False, callPreParse=False)
+                self_expr_parse(instring, tmploc, do_actions=False, callPreParse=False)
             except (ParseException, IndexError):
                 # no match, advance loc in string
                 tmploc += 1
@@ -5343,7 +5406,7 @@ class SkipTo(ParseElementEnhance):
         skipresult = ParseResults(skiptext)
 
         if self.includeMatch:
-            loc, mat = self_expr_parse(instring, loc, doActions, callPreParse=False)
+            loc, mat = self_expr_parse(instring, loc, do_actions, callPreParse=False)
             skipresult += mat
 
         return loc, skipresult
@@ -5440,7 +5503,7 @@ class Forward(ParseElementEnhance):
                 lineno=self.caller_frame.lineno,
             )
 
-    def parseImpl(self, instring, loc, doActions=True):
+    def parseImpl(self, instring, loc, do_actions=True) -> ParseImplReturnType:
         if (
             self.expr is None
             and __diag__.warn_on_parse_using_empty_Forward
@@ -5466,7 +5529,7 @@ class Forward(ParseElementEnhance):
                 stacklevel=stacklevel,
             )
         if not ParserElement._left_recursion_enabled:
-            return super().parseImpl(instring, loc, doActions)
+            return super().parseImpl(instring, loc, do_actions)
         # ## Bounded Recursion algorithm ##
         # Recursion only needs to be processed at ``Forward`` elements, since they are
         # the only ones that can actually refer to themselves. The general idea is
@@ -5484,13 +5547,13 @@ class Forward(ParseElementEnhance):
         #
         # There is a complication since we not only *parse* but also *transform* via
         # actions: We do not want to run the actions too often while expanding. Thus,
-        # we expand using `doActions=False` and only run `doActions=True` if the next
+        # we expand using `do_actions=False` and only run `do_actions=True` if the next
         # recursion level is acceptable.
         with ParserElement.recursion_lock:
             memo = ParserElement.recursion_memos
             try:
                 # we are parsing at a specific recursion expansion - use it as-is
-                prev_loc, prev_result = memo[loc, self, doActions]
+                prev_loc, prev_result = memo[loc, self, do_actions]
                 if isinstance(prev_result, Exception):
                     raise prev_result
                 return prev_loc, prev_result.copy()
@@ -5498,14 +5561,14 @@ class Forward(ParseElementEnhance):
                 act_key = (loc, self, True)
                 peek_key = (loc, self, False)
                 # we are searching for the best recursion expansion - keep on improving
-                # both `doActions` cases must be tracked separately here!
+                # both `do_actions` cases must be tracked separately here!
                 prev_loc, prev_peek = memo[peek_key] = (
                     loc - 1,
                     ParseException(
                         instring, loc, "Forward recursion without base case", self
                     ),
                 )
-                if doActions:
+                if do_actions:
                     memo[act_key] = memo[peek_key]
                 while True:
                     try:
@@ -5517,8 +5580,8 @@ class Forward(ParseElementEnhance):
                         new_loc, new_peek = prev_loc, prev_peek
                     # the match did not get better: we are done
                     if new_loc <= prev_loc:
-                        if doActions:
-                            # replace the match for doActions=False as well,
+                        if do_actions:
+                            # replace the match for do_actions=False as well,
                             # in case the action did backtrack
                             prev_loc, prev_result = memo[peek_key] = memo[act_key]
                             del memo[peek_key], memo[act_key]
@@ -5526,7 +5589,7 @@ class Forward(ParseElementEnhance):
                         del memo[peek_key]
                         return prev_loc, prev_peek.copy()
                     # the match did get better: see if we can improve further
-                    if doActions:
+                    if do_actions:
                         try:
                             memo[act_key] = super().parseImpl(instring, loc, True)
                         except ParseException as e:
@@ -5586,7 +5649,7 @@ class Forward(ParseElementEnhance):
             ret <<= self
             return ret
 
-    def _setResultsName(self, name, list_all_matches=False):
+    def _setResultsName(self, name, list_all_matches=False) -> ParserElement:
         # fmt: off
         if (
             __diag__.warn_name_set_on_empty_Forward
@@ -5892,7 +5955,9 @@ def trace_parse_action(f: ParseAction) -> ParseAction:
         try:
             ret = f(*paArgs)
         except Exception as exc:
-            sys.stderr.write(f"<<leaving {thisFunc} (exception: {exc})\n")
+            sys.stderr.write(
+                f"<<leaving {thisFunc} (exception: {type(exc).__name__}: {exc})\n"
+            )
             raise
         sys.stderr.write(f"<<leaving {thisFunc} (ret: {ret!r})\n")
         return ret
@@ -6070,7 +6135,7 @@ _builtin_exprs: List[ParserElement] = [
     v for v in vars().values() if isinstance(v, ParserElement)
 ]
 
-# backward compatibility names
+# Compatibility synonyms
 # fmt: off
 sglQuotedString = sgl_quoted_string
 dblQuotedString = dbl_quoted_string
diff --git a/lib/pyparsing/diagram/__init__.py b/lib/pyparsing/diagram/__init__.py
index 700d0b56..3275adaf 100644
--- a/lib/pyparsing/diagram/__init__.py
+++ b/lib/pyparsing/diagram/__init__.py
@@ -36,6 +36,7 @@ jinja2_template_source = """\
 </head>
 <body>
 {% endif %}
+<meta charset="UTF-8"/>
 {{ body | safe }}
 {% for diagram in diagrams %}
     <div class="railroad-group">
@@ -89,7 +90,7 @@ class AnnotatedItem(railroad.Group):
     """
 
     def __init__(self, label: str, item):
-        super().__init__(item=item, label="[{}]".format(label) if label else label)
+        super().__init__(item=item, label=f"[{label}]")
 
 
 class EditablePartial(Generic[T]):
@@ -145,7 +146,7 @@ def railroad_to_html(diagrams: List[NamedDiagram], embed=False, **kwargs) -> str
             continue
         io = StringIO()
         try:
-            css = kwargs.get('css')
+            css = kwargs.get("css")
             diagram.diagram.writeStandalone(io.write, css=css)
         except AttributeError:
             diagram.diagram.writeSvg(io.write)
@@ -425,9 +426,11 @@ def _apply_diagram_item_enhancements(fn):
             element_results_name = element.resultsName
             if element_results_name:
                 # add "*" to indicate if this is a "list all results" name
-                element_results_name += "" if element.modalResults else "*"
+                modal_tag = "" if element.modalResults else "*"
                 ret = EditablePartial.from_call(
-                    railroad.Group, item=ret, label=element_results_name
+                    railroad.Group,
+                    item=ret,
+                    label=f"{repr(element_results_name)}{modal_tag}",
                 )
 
         return ret
@@ -534,7 +537,7 @@ def _to_diagram_element(
         # (all will have the same name, and resultsName)
         if not exprs:
             return None
-        if len(set((e.name, e.resultsName) for e in exprs)) == 1:
+        if len(set((e.name, e.resultsName) for e in exprs)) == 1 and len(exprs) > 2:
             ret = EditablePartial.from_call(
                 railroad.OneOrMore, item="", repeat=str(len(exprs))
             )
@@ -563,7 +566,7 @@ def _to_diagram_element(
         if show_groups:
             ret = EditablePartial.from_call(AnnotatedItem, label="", item="")
         else:
-            ret = EditablePartial.from_call(railroad.Group, label="", item="")
+            ret = EditablePartial.from_call(railroad.Sequence, items=[])
     elif isinstance(element, pyparsing.TokenConverter):
         label = type(element).__name__.lower()
         if label == "tokenconverter":
@@ -573,8 +576,36 @@ def _to_diagram_element(
     elif isinstance(element, pyparsing.Opt):
         ret = EditablePartial.from_call(railroad.Optional, item="")
     elif isinstance(element, pyparsing.OneOrMore):
-        ret = EditablePartial.from_call(railroad.OneOrMore, item="")
+        if element.not_ender is not None:
+            args = [
+                parent,
+                lookup,
+                vertical,
+                index,
+                name_hint,
+                show_results_names,
+                show_groups,
+            ]
+            return _to_diagram_element(
+                (~element.not_ender.expr + element.expr)[1, ...].set_name(element.name),
+                *args,
+            )
+        ret = EditablePartial.from_call(railroad.OneOrMore, item=None)
     elif isinstance(element, pyparsing.ZeroOrMore):
+        if element.not_ender is not None:
+            args = [
+                parent,
+                lookup,
+                vertical,
+                index,
+                name_hint,
+                show_results_names,
+                show_groups,
+            ]
+            return _to_diagram_element(
+                (~element.not_ender.expr + element.expr)[...].set_name(element.name),
+                *args,
+            )
         ret = EditablePartial.from_call(railroad.ZeroOrMore, item="")
     elif isinstance(element, pyparsing.Group):
         ret = EditablePartial.from_call(
diff --git a/lib/pyparsing/exceptions.py b/lib/pyparsing/exceptions.py
index 1aaea56f..8db34f19 100644
--- a/lib/pyparsing/exceptions.py
+++ b/lib/pyparsing/exceptions.py
@@ -85,7 +85,7 @@ class ParseBaseException(Exception):
         ret = []
         if isinstance(exc, ParseBaseException):
             ret.append(exc.line)
-            ret.append(" " * (exc.column - 1) + "^")
+            ret.append(f"{' ' * (exc.column - 1)}^")
         ret.append(f"{type(exc).__name__}: {exc}")
 
         if depth <= 0:
@@ -245,6 +245,7 @@ class ParseBaseException(Exception):
         """
         return self.explain_exception(self, depth)
 
+    # Compatibility synonyms
     # fmt: off
     markInputline = replaced_by_pep8("markInputline", mark_input_line)
     # fmt: on
diff --git a/lib/pyparsing/helpers.py b/lib/pyparsing/helpers.py
index dcfdb8fe..d5d14a08 100644
--- a/lib/pyparsing/helpers.py
+++ b/lib/pyparsing/helpers.py
@@ -782,9 +782,12 @@ def infix_notation(
 
     # if lpar and rpar are not suppressed, wrap in group
     if not (isinstance(lpar, Suppress) and isinstance(rpar, Suppress)):
-        lastExpr = base_expr | Group(lpar + ret + rpar)
+        lastExpr = base_expr | Group(lpar + ret + rpar).set_name(
+            f"nested_{base_expr.name}"
+        )
     else:
-        lastExpr = base_expr | (lpar + ret + rpar)
+        lastExpr = base_expr | (lpar + ret + rpar).set_name(f"nested_{base_expr.name}")
+    root_expr = lastExpr
 
     arity: int
     rightLeftAssoc: opAssoc
@@ -855,6 +858,7 @@ def infix_notation(
         thisExpr <<= (matchExpr | lastExpr).setName(term_name)
         lastExpr = thisExpr
     ret <<= lastExpr
+    root_expr.set_name("base_expr")
     return ret
 
 
@@ -1049,7 +1053,7 @@ def delimited_list(
     )
 
 
-# pre-PEP8 compatible names
+# Compatibility synonyms
 # fmt: off
 opAssoc = OpAssoc
 anyOpenTag = any_open_tag
diff --git a/lib/pyparsing/results.py b/lib/pyparsing/results.py
index 3e5fe208..3bb7c948 100644
--- a/lib/pyparsing/results.py
+++ b/lib/pyparsing/results.py
@@ -4,12 +4,14 @@ from collections.abc import (
     Mapping,
     MutableSequence,
     Iterator,
-    Sequence,
-    Container,
+    Iterable,
 )
 import pprint
 from typing import Tuple, Any, Dict, Set, List
 
+from .util import replaced_by_pep8
+
+
 str_type: Tuple[type, ...] = (str, bytes)
 _generator_type = type((_ for _ in ()))
 
@@ -573,20 +575,20 @@ class ParseResults:
         # replace values with copies if they are of known mutable types
         for i, obj in enumerate(self._toklist):
             if isinstance(obj, ParseResults):
-                self._toklist[i] = obj.deepcopy()
+                ret._toklist[i] = obj.deepcopy()
             elif isinstance(obj, (str, bytes)):
                 pass
             elif isinstance(obj, MutableMapping):
-                self._toklist[i] = dest = type(obj)()
+                ret._toklist[i] = dest = type(obj)()
                 for k, v in obj.items():
                     dest[k] = v.deepcopy() if isinstance(v, ParseResults) else v
-            elif isinstance(obj, Container):
-                self._toklist[i] = type(obj)(
+            elif isinstance(obj, Iterable):
+                ret._toklist[i] = type(obj)(
                     v.deepcopy() if isinstance(v, ParseResults) else v for v in obj
                 )
         return ret
 
-    def get_name(self):
+    def get_name(self) -> str:
         r"""
         Returns the results name for this token expression. Useful when several
         different expressions might match at a particular location.
diff --git a/lib/pyparsing/unicode.py b/lib/pyparsing/unicode.py
index 426b8b23..0e3e0657 100644
--- a/lib/pyparsing/unicode.py
+++ b/lib/pyparsing/unicode.py
@@ -53,51 +53,51 @@ class unicode_set:
     _ranges: UnicodeRangeList = []
 
     @_lazyclassproperty
-    def _chars_for_ranges(cls):
-        ret = []
+    def _chars_for_ranges(cls) -> List[str]:
+        ret: List[int] = []
         for cc in cls.__mro__:
             if cc is unicode_set:
                 break
             for rr in getattr(cc, "_ranges", ()):
                 ret.extend(range(rr[0], rr[-1] + 1))
-        return [chr(c) for c in sorted(set(ret))]
+        return sorted(chr(c) for c in set(ret))
 
     @_lazyclassproperty
-    def printables(cls):
+    def printables(cls) -> str:
         """all non-whitespace characters in this range"""
         return "".join(filterfalse(str.isspace, cls._chars_for_ranges))
 
     @_lazyclassproperty
-    def alphas(cls):
+    def alphas(cls) -> str:
         """all alphabetic characters in this range"""
         return "".join(filter(str.isalpha, cls._chars_for_ranges))
 
     @_lazyclassproperty
-    def nums(cls):
+    def nums(cls) -> str:
         """all numeric digit characters in this range"""
         return "".join(filter(str.isdigit, cls._chars_for_ranges))
 
     @_lazyclassproperty
-    def alphanums(cls):
+    def alphanums(cls) -> str:
         """all alphanumeric characters in this range"""
         return cls.alphas + cls.nums
 
     @_lazyclassproperty
-    def identchars(cls):
+    def identchars(cls) -> str:
         """all characters in this range that are valid identifier characters, plus underscore '_'"""
         return "".join(
             sorted(
-                set(
-                    "".join(filter(str.isidentifier, cls._chars_for_ranges))
-                    + "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyzªµº"
-                    + "ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖØÙÚÛÜÝÞßàáâãäåæçèéêëìíîïðñòóôõöøùúûüýþÿ"
-                    + "_"
+                set(filter(str.isidentifier, cls._chars_for_ranges))
+                | set(
+                    "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyzªµº"
+                    "ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖØÙÚÛÜÝÞßàáâãäåæçèéêëìíîïðñòóôõöøùúûüýþÿ"
+                    "_"
                 )
             )
         )
 
     @_lazyclassproperty
-    def identbodychars(cls):
+    def identbodychars(cls) -> str:
         """
         all characters in this range that are valid identifier body characters,
         plus the digits 0-9, and · (Unicode MIDDLE DOT)
@@ -105,7 +105,9 @@ class unicode_set:
         identifier_chars = set(
             c for c in cls._chars_for_ranges if ("_" + c).isidentifier()
         )
-        return "".join(sorted(identifier_chars | set(cls.identchars + "0123456789·")))
+        return "".join(
+            sorted(identifier_chars | set(cls.identchars) | set("0123456789·"))
+        )
 
     @_lazyclassproperty
     def identifier(cls):
diff --git a/lib/pyparsing/util.py b/lib/pyparsing/util.py
index 4ae018a9..94837fea 100644
--- a/lib/pyparsing/util.py
+++ b/lib/pyparsing/util.py
@@ -246,7 +246,7 @@ def replaced_by_pep8(compat_name: str, fn: C) -> C:
 
     # (Presence of 'self' arg in signature is used by explain_exception() methods, so we take
     # some extra steps to add it if present in decorated function.)
-    if "self" == list(inspect.signature(fn).parameters)[0]:
+    if ["self"] == list(inspect.signature(fn).parameters)[:1]:
 
         @wraps(fn)
         def _inner(self, *args, **kwargs):
diff --git a/requirements.txt b/requirements.txt
index 77c42d60..1e1ec908 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -30,7 +30,7 @@ plexapi==4.15.16
 portend==3.2.0
 profilehooks==1.12.0
 PyJWT==2.9.0
-pyparsing==3.1.2
+pyparsing==3.1.4
 python-dateutil==2.9.0.post0
 python-twitter==3.5
 pytz==2024.1

From f3a2c02e960d3a101205302628a22e1615163e48 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 16 Nov 2024 14:47:58 -0800
Subject: [PATCH 665/743] Bump certifi from 2024.7.4 to 2024.8.30 (#2391)

* Bump certifi from 2024.7.4 to 2024.8.30

Bumps [certifi](https://github.com/certifi/python-certifi) from 2024.7.4 to 2024.8.30.
- [Commits](https://github.com/certifi/python-certifi/compare/2024.07.04...2024.08.30)

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

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

* Update certifi==2024.8.30

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/certifi/__init__.py |   2 +-
 lib/certifi/cacert.pem  | 131 ++++++++++++++++++++++++++++++++++++++++
 requirements.txt        |   2 +-
 3 files changed, 133 insertions(+), 2 deletions(-)

diff --git a/lib/certifi/__init__.py b/lib/certifi/__init__.py
index d321f1bc..f61d77fa 100644
--- a/lib/certifi/__init__.py
+++ b/lib/certifi/__init__.py
@@ -1,4 +1,4 @@
 from .core import contents, where
 
 __all__ = ["contents", "where"]
-__version__ = "2024.07.04"
+__version__ = "2024.08.30"
diff --git a/lib/certifi/cacert.pem b/lib/certifi/cacert.pem
index a6581589..3c165a1b 100644
--- a/lib/certifi/cacert.pem
+++ b/lib/certifi/cacert.pem
@@ -4796,3 +4796,134 @@ PQQDAwNoADBlAjAdfKR7w4l1M+E7qUW/Runpod3JIha3RxEL2Jq68cgLcFBTApFw
 hVmpHqTm6iMxoAACMQD94vizrxa5HnPEluPBMBnYfubDl94cT7iJLzPrSA8Z94dG
 XSaQpYXFuXqUPoeovQA=
 -----END CERTIFICATE-----
+
+# Issuer: CN=TWCA CYBER Root CA O=TAIWAN-CA OU=Root CA
+# Subject: CN=TWCA CYBER Root CA O=TAIWAN-CA OU=Root CA
+# Label: "TWCA CYBER Root CA"
+# Serial: 85076849864375384482682434040119489222
+# MD5 Fingerprint: 0b:33:a0:97:52:95:d4:a9:fd:bb:db:6e:a3:55:5b:51
+# SHA1 Fingerprint: f6:b1:1c:1a:83:38:e9:7b:db:b3:a8:c8:33:24:e0:2d:9c:7f:26:66
+# SHA256 Fingerprint: 3f:63:bb:28:14:be:17:4e:c8:b6:43:9c:f0:8d:6d:56:f0:b7:c4:05:88:3a:56:48:a3:34:42:4d:6b:3e:c5:58
+-----BEGIN CERTIFICATE-----
+MIIFjTCCA3WgAwIBAgIQQAE0jMIAAAAAAAAAATzyxjANBgkqhkiG9w0BAQwFADBQ
+MQswCQYDVQQGEwJUVzESMBAGA1UEChMJVEFJV0FOLUNBMRAwDgYDVQQLEwdSb290
+IENBMRswGQYDVQQDExJUV0NBIENZQkVSIFJvb3QgQ0EwHhcNMjIxMTIyMDY1NDI5
+WhcNNDcxMTIyMTU1OTU5WjBQMQswCQYDVQQGEwJUVzESMBAGA1UEChMJVEFJV0FO
+LUNBMRAwDgYDVQQLEwdSb290IENBMRswGQYDVQQDExJUV0NBIENZQkVSIFJvb3Qg
+Q0EwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDG+Moe2Qkgfh1sTs6P
+40czRJzHyWmqOlt47nDSkvgEs1JSHWdyKKHfi12VCv7qze33Kc7wb3+szT3vsxxF
+avcokPFhV8UMxKNQXd7UtcsZyoC5dc4pztKFIuwCY8xEMCDa6pFbVuYdHNWdZsc/
+34bKS1PE2Y2yHer43CdTo0fhYcx9tbD47nORxc5zb87uEB8aBs/pJ2DFTxnk684i
+JkXXYJndzk834H/nY62wuFm40AZoNWDTNq5xQwTxaWV4fPMf88oon1oglWa0zbfu
+j3ikRRjpJi+NmykosaS3Om251Bw4ckVYsV7r8Cibt4LK/c/WMw+f+5eesRycnupf
+Xtuq3VTpMCEobY5583WSjCb+3MX2w7DfRFlDo7YDKPYIMKoNM+HvnKkHIuNZW0CP
+2oi3aQiotyMuRAlZN1vH4xfyIutuOVLF3lSnmMlLIJXcRolftBL5hSmO68gnFSDA
+S9TMfAxsNAwmmyYxpjyn9tnQS6Jk/zuZQXLB4HCX8SS7K8R0IrGsayIyJNN4KsDA
+oS/xUgXJP+92ZuJF2A09rZXIx4kmyA+upwMu+8Ff+iDhcK2wZSA3M2Cw1a/XDBzC
+kHDXShi8fgGwsOsVHkQGzaRP6AzRwyAQ4VRlnrZR0Bp2a0JaWHY06rc3Ga4udfmW
+5cFZ95RXKSWNOkyrTZpB0F8mAwIDAQABo2MwYTAOBgNVHQ8BAf8EBAMCAQYwDwYD
+VR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBSdhWEUfMFib5do5E83QOGt4A1WNzAd
+BgNVHQ4EFgQUnYVhFHzBYm+XaORPN0DhreANVjcwDQYJKoZIhvcNAQEMBQADggIB
+AGSPesRiDrWIzLjHhg6hShbNcAu3p4ULs3a2D6f/CIsLJc+o1IN1KriWiLb73y0t
+tGlTITVX1olNc79pj3CjYcya2x6a4CD4bLubIp1dhDGaLIrdaqHXKGnK/nZVekZn
+68xDiBaiA9a5F/gZbG0jAn/xX9AKKSM70aoK7akXJlQKTcKlTfjF/biBzysseKNn
+TKkHmvPfXvt89YnNdJdhEGoHK4Fa0o635yDRIG4kqIQnoVesqlVYL9zZyvpoBJ7t
+RCT5dEA7IzOrg1oYJkK2bVS1FmAwbLGg+LhBoF1JSdJlBTrq/p1hvIbZv97Tujqx
+f36SNI7JAG7cmL3c7IAFrQI932XtCwP39xaEBDG6k5TY8hL4iuO/Qq+n1M0RFxbI
+Qh0UqEL20kCGoE8jypZFVmAGzbdVAaYBlGX+bgUJurSkquLvWL69J1bY73NxW0Qz
+8ppy6rBePm6pUlvscG21h483XjyMnM7k8M4MZ0HMzvaAq07MTFb1wWFZk7Q+ptq4
+NxKfKjLji7gh7MMrZQzvIt6IKTtM1/r+t+FHvpw+PoP7UV31aPcuIYXcv/Fa4nzX
+xeSDwWrruoBa3lwtcHb4yOWHh8qgnaHlIhInD0Q9HWzq1MKLL295q39QpsQZp6F6
+t5b5wR9iWqJDB0BeJsas7a5wFsWqynKKTbDPAYsDP27X
+-----END CERTIFICATE-----
+
+# Issuer: CN=SecureSign Root CA12 O=Cybertrust Japan Co., Ltd.
+# Subject: CN=SecureSign Root CA12 O=Cybertrust Japan Co., Ltd.
+# Label: "SecureSign Root CA12"
+# Serial: 587887345431707215246142177076162061960426065942
+# MD5 Fingerprint: c6:89:ca:64:42:9b:62:08:49:0b:1e:7f:e9:07:3d:e8
+# SHA1 Fingerprint: 7a:22:1e:3d:de:1b:06:ac:9e:c8:47:70:16:8e:3c:e5:f7:6b:06:f4
+# SHA256 Fingerprint: 3f:03:4b:b5:70:4d:44:b2:d0:85:45:a0:20:57:de:93:eb:f3:90:5f:ce:72:1a:cb:c7:30:c0:6d:da:ee:90:4e
+-----BEGIN CERTIFICATE-----
+MIIDcjCCAlqgAwIBAgIUZvnHwa/swlG07VOX5uaCwysckBYwDQYJKoZIhvcNAQEL
+BQAwUTELMAkGA1UEBhMCSlAxIzAhBgNVBAoTGkN5YmVydHJ1c3QgSmFwYW4gQ28u
+LCBMdGQuMR0wGwYDVQQDExRTZWN1cmVTaWduIFJvb3QgQ0ExMjAeFw0yMDA0MDgw
+NTM2NDZaFw00MDA0MDgwNTM2NDZaMFExCzAJBgNVBAYTAkpQMSMwIQYDVQQKExpD
+eWJlcnRydXN0IEphcGFuIENvLiwgTHRkLjEdMBsGA1UEAxMUU2VjdXJlU2lnbiBS
+b290IENBMTIwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQC6OcE3emhF
+KxS06+QT61d1I02PJC0W6K6OyX2kVzsqdiUzg2zqMoqUm048luT9Ub+ZyZN+v/mt
+p7JIKwccJ/VMvHASd6SFVLX9kHrko+RRWAPNEHl57muTH2SOa2SroxPjcf59q5zd
+J1M3s6oYwlkm7Fsf0uZlfO+TvdhYXAvA42VvPMfKWeP+bl+sg779XSVOKik71gur
+FzJ4pOE+lEa+Ym6b3kaosRbnhW70CEBFEaCeVESE99g2zvVQR9wsMJvuwPWW0v4J
+hscGWa5Pro4RmHvzC1KqYiaqId+OJTN5lxZJjfU+1UefNzFJM3IFTQy2VYzxV4+K
+h9GtxRESOaCtAgMBAAGjQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQD
+AgEGMB0GA1UdDgQWBBRXNPN0zwRL1SXm8UC2LEzZLemgrTANBgkqhkiG9w0BAQsF
+AAOCAQEAPrvbFxbS8hQBICw4g0utvsqFepq2m2um4fylOqyttCg6r9cBg0krY6Ld
+mmQOmFxv3Y67ilQiLUoT865AQ9tPkbeGGuwAtEGBpE/6aouIs3YIcipJQMPTw4WJ
+mBClnW8Zt7vPemVV2zfrPIpyMpcemik+rY3moxtt9XUa5rBouVui7mlHJzWhhpmA
+8zNL4WukJsPvdFlseqJkth5Ew1DgDzk9qTPxpfPSvWKErI4cqc1avTc7bgoitPQV
+55FYxTpE05Uo2cBl6XLK0A+9H7MV2anjpEcJnuDLN/v9vZfVvhgaaaI5gdka9at/
+yOPiZwud9AzqVN/Ssq+xIvEg37xEHA==
+-----END CERTIFICATE-----
+
+# Issuer: CN=SecureSign Root CA14 O=Cybertrust Japan Co., Ltd.
+# Subject: CN=SecureSign Root CA14 O=Cybertrust Japan Co., Ltd.
+# Label: "SecureSign Root CA14"
+# Serial: 575790784512929437950770173562378038616896959179
+# MD5 Fingerprint: 71:0d:72:fa:92:19:65:5e:89:04:ac:16:33:f0:bc:d5
+# SHA1 Fingerprint: dd:50:c0:f7:79:b3:64:2e:74:a2:b8:9d:9f:d3:40:dd:bb:f0:f2:4f
+# SHA256 Fingerprint: 4b:00:9c:10:34:49:4f:9a:b5:6b:ba:3b:a1:d6:27:31:fc:4d:20:d8:95:5a:dc:ec:10:a9:25:60:72:61:e3:38
+-----BEGIN CERTIFICATE-----
+MIIFcjCCA1qgAwIBAgIUZNtaDCBO6Ncpd8hQJ6JaJ90t8sswDQYJKoZIhvcNAQEM
+BQAwUTELMAkGA1UEBhMCSlAxIzAhBgNVBAoTGkN5YmVydHJ1c3QgSmFwYW4gQ28u
+LCBMdGQuMR0wGwYDVQQDExRTZWN1cmVTaWduIFJvb3QgQ0ExNDAeFw0yMDA0MDgw
+NzA2MTlaFw00NTA0MDgwNzA2MTlaMFExCzAJBgNVBAYTAkpQMSMwIQYDVQQKExpD
+eWJlcnRydXN0IEphcGFuIENvLiwgTHRkLjEdMBsGA1UEAxMUU2VjdXJlU2lnbiBS
+b290IENBMTQwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDF0nqh1oq/
+FjHQmNE6lPxauG4iwWL3pwon71D2LrGeaBLwbCRjOfHw3xDG3rdSINVSW0KZnvOg
+vlIfX8xnbacuUKLBl422+JX1sLrcneC+y9/3OPJH9aaakpUqYllQC6KxNedlsmGy
+6pJxaeQp8E+BgQQ8sqVb1MWoWWd7VRxJq3qdwudzTe/NCcLEVxLbAQ4jeQkHO6Lo
+/IrPj8BGJJw4J+CDnRugv3gVEOuGTgpa/d/aLIJ+7sr2KeH6caH3iGicnPCNvg9J
+kdjqOvn90Ghx2+m1K06Ckm9mH+Dw3EzsytHqunQG+bOEkJTRX45zGRBdAuVwpcAQ
+0BB8b8VYSbSwbprafZX1zNoCr7gsfXmPvkPx+SgojQlD+Ajda8iLLCSxjVIHvXib
+y8posqTdDEx5YMaZ0ZPxMBoH064iwurO8YQJzOAUbn8/ftKChazcqRZOhaBgy/ac
+18izju3Gm5h1DVXoX+WViwKkrkMpKBGk5hIwAUt1ax5mnXkvpXYvHUC0bcl9eQjs
+0Wq2XSqypWa9a4X0dFbD9ed1Uigspf9mR6XU/v6eVL9lfgHWMI+lNpyiUBzuOIAB
+SMbHdPTGrMNASRZhdCyvjG817XsYAFs2PJxQDcqSMxDxJklt33UkN4Ii1+iW/RVL
+ApY+B3KVfqs9TC7XyvDf4Fg/LS8EmjijAQIDAQABo0IwQDAPBgNVHRMBAf8EBTAD
+AQH/MA4GA1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQUBpOjCl4oaTeqYR3r6/wtbyPk
+86AwDQYJKoZIhvcNAQEMBQADggIBAJaAcgkGfpzMkwQWu6A6jZJOtxEaCnFxEM0E
+rX+lRVAQZk5KQaID2RFPeje5S+LGjzJmdSX7684/AykmjbgWHfYfM25I5uj4V7Ib
+ed87hwriZLoAymzvftAj63iP/2SbNDefNWWipAA9EiOWWF3KY4fGoweITedpdopT
+zfFP7ELyk+OZpDc8h7hi2/DsHzc/N19DzFGdtfCXwreFamgLRB7lUe6TzktuhsHS
+DCRZNhqfLJGP4xjblJUK7ZGqDpncllPjYYPGFrojutzdfhrGe0K22VoF3Jpf1d+4
+2kd92jjbrDnVHmtsKheMYc2xbXIBw8MgAGJoFjHVdqqGuw6qnsb58Nn4DSEC5MUo
+FlkRudlpcyqSeLiSV5sI8jrlL5WwWLdrIBRtFO8KvH7YVdiI2i/6GaX7i+B/OfVy
+K4XELKzvGUWSTLNhB9xNH27SgRNcmvMSZ4PPmz+Ln52kuaiWA3rF7iDeM9ovnhp6
+dB7h7sxaOgTdsxoEqBRjrLdHEoOabPXm6RUVkRqEGQ6UROcSjiVbgGcZ3GOTEAtl
+Lor6CZpO2oYofaphNdgOpygau1LgePhsumywbrmHXumZNTfxPWQrqaA0k89jL9WB
+365jJ6UeTo3cKXhZ+PmhIIynJkBugnLNeLLIjzwec+fBH7/PzqUqm9tEZDKgu39c
+JRNItX+S
+-----END CERTIFICATE-----
+
+# Issuer: CN=SecureSign Root CA15 O=Cybertrust Japan Co., Ltd.
+# Subject: CN=SecureSign Root CA15 O=Cybertrust Japan Co., Ltd.
+# Label: "SecureSign Root CA15"
+# Serial: 126083514594751269499665114766174399806381178503
+# MD5 Fingerprint: 13:30:fc:c4:62:a6:a9:de:b5:c1:68:af:b5:d2:31:47
+# SHA1 Fingerprint: cb:ba:83:c8:c1:5a:5d:f1:f9:73:6f:ca:d7:ef:28:13:06:4a:07:7d
+# SHA256 Fingerprint: e7:78:f0:f0:95:fe:84:37:29:cd:1a:00:82:17:9e:53:14:a9:c2:91:44:28:05:e1:fb:1d:8f:b6:b8:88:6c:3a
+-----BEGIN CERTIFICATE-----
+MIICIzCCAamgAwIBAgIUFhXHw9hJp75pDIqI7fBw+d23PocwCgYIKoZIzj0EAwMw
+UTELMAkGA1UEBhMCSlAxIzAhBgNVBAoTGkN5YmVydHJ1c3QgSmFwYW4gQ28uLCBM
+dGQuMR0wGwYDVQQDExRTZWN1cmVTaWduIFJvb3QgQ0ExNTAeFw0yMDA0MDgwODMy
+NTZaFw00NTA0MDgwODMyNTZaMFExCzAJBgNVBAYTAkpQMSMwIQYDVQQKExpDeWJl
+cnRydXN0IEphcGFuIENvLiwgTHRkLjEdMBsGA1UEAxMUU2VjdXJlU2lnbiBSb290
+IENBMTUwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAAQLUHSNZDKZmbPSYAi4Io5GdCx4
+wCtELW1fHcmuS1Iggz24FG1Th2CeX2yF2wYUleDHKP+dX+Sq8bOLbe1PL0vJSpSR
+ZHX+AezB2Ot6lHhWGENfa4HL9rzatAy2KZMIaY+jQjBAMA8GA1UdEwEB/wQFMAMB
+Af8wDgYDVR0PAQH/BAQDAgEGMB0GA1UdDgQWBBTrQciu/NWeUUj1vYv0hyCTQSvT
+9DAKBggqhkjOPQQDAwNoADBlAjEA2S6Jfl5OpBEHvVnCB96rMjhTKkZEBhd6zlHp
+4P9mLQlO4E/0BdGF9jVg3PVys0Z9AjBEmEYagoUeYWmJSwdLZrWeqrqgHkHZAXQ6
+bkU6iYAZezKYVWOr62Nuk22rGwlgMU4=
+-----END CERTIFICATE-----
diff --git a/requirements.txt b/requirements.txt
index 1e1ec908..373b82d0 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -3,7 +3,7 @@ arrow==1.3.0
 backports.zoneinfo==0.2.1;python_version<"3.9"
 beautifulsoup4==4.12.3
 bleach==6.1.0
-certifi==2024.7.4
+certifi==2024.8.30
 cheroot==10.0.1
 cherrypy==18.10.0
 cloudinary==1.41.0

From 01589cb8b0bf0c6578da1d8792d8ba14e60546c0 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 16 Nov 2024 14:48:10 -0800
Subject: [PATCH 666/743] Bump importlib-resources from 6.4.0 to 6.4.5 (#2394)

* Bump importlib-resources from 6.4.0 to 6.4.5

Bumps [importlib-resources](https://github.com/python/importlib_resources) from 6.4.0 to 6.4.5.
- [Release notes](https://github.com/python/importlib_resources/releases)
- [Changelog](https://github.com/python/importlib_resources/blob/main/NEWS.rst)
- [Commits](https://github.com/python/importlib_resources/compare/v6.4.0...v6.4.5)

---
updated-dependencies:
- dependency-name: importlib-resources
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

* Update importlib-resources==6.4.5

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/importlib_resources/__init__.py           |  11 +-
 lib/importlib_resources/_common.py            |  11 +-
 .../{functional.py => _functional.py}         |   0
 lib/importlib_resources/compat/py39.py        |   4 +-
 lib/importlib_resources/readers.py            |  25 ++-
 lib/importlib_resources/simple.py             |   2 +-
 lib/importlib_resources/tests/_path.py        |  52 +++++-
 lib/importlib_resources/tests/compat/py39.py  |   3 +
 .../tests/data01/__init__.py                  |   0
 .../tests/data01/binary.file                  | Bin 4 -> 0 bytes
 .../tests/data01/subdirectory/__init__.py     |   0
 .../tests/data01/subdirectory/binary.file     |   1 -
 .../tests/data01/utf-16.file                  | Bin 44 -> 0 bytes
 .../tests/data01/utf-8.file                   |   1 -
 .../tests/data02/__init__.py                  |   0
 .../tests/data02/one/__init__.py              |   0
 .../tests/data02/one/resource1.txt            |   1 -
 .../subdirectory/subsubdir/resource.txt       |   1 -
 .../tests/data02/two/__init__.py              |   0
 .../tests/data02/two/resource2.txt            |   1 -
 .../tests/namespacedata01/binary.file         | Bin 4 -> 0 bytes
 .../namespacedata01/subdirectory/binary.file  |   1 -
 .../tests/namespacedata01/utf-16.file         | Bin 44 -> 0 bytes
 .../tests/namespacedata01/utf-8.file          |   1 -
 .../tests/test_contents.py                    |  15 +-
 lib/importlib_resources/tests/test_files.py   | 157 +++++++++++++-----
 .../tests/test_functional.py                  |  73 ++++----
 lib/importlib_resources/tests/test_open.py    |  15 +-
 lib/importlib_resources/tests/test_path.py    |   5 +-
 lib/importlib_resources/tests/test_read.py    |  14 +-
 lib/importlib_resources/tests/test_reader.py  |  48 +++---
 .../tests/test_resource.py                    |  64 ++++---
 lib/importlib_resources/tests/util.py         |  70 ++++++--
 lib/importlib_resources/tests/zip.py          |  26 ++-
 lib/zipp/__init__.py                          | 120 +++++--------
 lib/zipp/_functools.py                        |  20 +++
 lib/zipp/compat/overlay.py                    |  37 +++++
 lib/zipp/compat/py310.py                      |   6 +-
 lib/zipp/glob.py                              |  11 +-
 package/requirements-package.txt              |   2 +-
 requirements.txt                              |   2 +-
 41 files changed, 484 insertions(+), 316 deletions(-)
 rename lib/importlib_resources/{functional.py => _functional.py} (100%)
 delete mode 100644 lib/importlib_resources/tests/data01/__init__.py
 delete mode 100644 lib/importlib_resources/tests/data01/binary.file
 delete mode 100644 lib/importlib_resources/tests/data01/subdirectory/__init__.py
 delete mode 100644 lib/importlib_resources/tests/data01/subdirectory/binary.file
 delete mode 100644 lib/importlib_resources/tests/data01/utf-16.file
 delete mode 100644 lib/importlib_resources/tests/data01/utf-8.file
 delete mode 100644 lib/importlib_resources/tests/data02/__init__.py
 delete mode 100644 lib/importlib_resources/tests/data02/one/__init__.py
 delete mode 100644 lib/importlib_resources/tests/data02/one/resource1.txt
 delete mode 100644 lib/importlib_resources/tests/data02/subdirectory/subsubdir/resource.txt
 delete mode 100644 lib/importlib_resources/tests/data02/two/__init__.py
 delete mode 100644 lib/importlib_resources/tests/data02/two/resource2.txt
 delete mode 100644 lib/importlib_resources/tests/namespacedata01/binary.file
 delete mode 100644 lib/importlib_resources/tests/namespacedata01/subdirectory/binary.file
 delete mode 100644 lib/importlib_resources/tests/namespacedata01/utf-16.file
 delete mode 100644 lib/importlib_resources/tests/namespacedata01/utf-8.file
 create mode 100644 lib/zipp/_functools.py
 create mode 100644 lib/zipp/compat/overlay.py

diff --git a/lib/importlib_resources/__init__.py b/lib/importlib_resources/__init__.py
index 0d029abd..723c9f9e 100644
--- a/lib/importlib_resources/__init__.py
+++ b/lib/importlib_resources/__init__.py
@@ -1,4 +1,11 @@
-"""Read resources contained within a package."""
+"""
+Read resources contained within a package.
+
+This codebase is shared between importlib.resources in the stdlib
+and importlib_resources in PyPI. See
+https://github.com/python/importlib_metadata/wiki/Development-Methodology
+for more detail.
+"""
 
 from ._common import (
     as_file,
@@ -7,7 +14,7 @@ from ._common import (
     Anchor,
 )
 
-from .functional import (
+from ._functional import (
     contents,
     is_resource,
     open_binary,
diff --git a/lib/importlib_resources/_common.py b/lib/importlib_resources/_common.py
index 8df6b39e..f065d493 100644
--- a/lib/importlib_resources/_common.py
+++ b/lib/importlib_resources/_common.py
@@ -66,10 +66,10 @@ def get_resource_reader(package: types.ModuleType) -> Optional[ResourceReader]:
     # zipimport.zipimporter does not support weak references, resulting in a
     # TypeError.  That seems terrible.
     spec = package.__spec__
-    reader = getattr(spec.loader, 'get_resource_reader', None)  # type: ignore
+    reader = getattr(spec.loader, 'get_resource_reader', None)  # type: ignore[union-attr]
     if reader is None:
         return None
-    return reader(spec.name)  # type: ignore
+    return reader(spec.name)  # type: ignore[union-attr]
 
 
 @functools.singledispatch
@@ -93,12 +93,13 @@ def _infer_caller():
     """
 
     def is_this_file(frame_info):
-        return frame_info.filename == __file__
+        return frame_info.filename == stack[0].filename
 
     def is_wrapper(frame_info):
         return frame_info.function == 'wrapper'
 
-    not_this_file = itertools.filterfalse(is_this_file, inspect.stack())
+    stack = inspect.stack()
+    not_this_file = itertools.filterfalse(is_this_file, stack)
     # also exclude 'wrapper' due to singledispatch in the call stack
     callers = itertools.filterfalse(is_wrapper, not_this_file)
     return next(callers).frame
@@ -182,7 +183,7 @@ def _(path):
 @contextlib.contextmanager
 def _temp_path(dir: tempfile.TemporaryDirectory):
     """
-    Wrap tempfile.TemporyDirectory to return a pathlib object.
+    Wrap tempfile.TemporaryDirectory to return a pathlib object.
     """
     with dir as result:
         yield pathlib.Path(result)
diff --git a/lib/importlib_resources/functional.py b/lib/importlib_resources/_functional.py
similarity index 100%
rename from lib/importlib_resources/functional.py
rename to lib/importlib_resources/_functional.py
diff --git a/lib/importlib_resources/compat/py39.py b/lib/importlib_resources/compat/py39.py
index ab87b9dc..ed5abd5e 100644
--- a/lib/importlib_resources/compat/py39.py
+++ b/lib/importlib_resources/compat/py39.py
@@ -5,6 +5,6 @@ __all__ = ['ZipPath']
 
 
 if sys.version_info >= (3, 10):
-    from zipfile import Path as ZipPath  # type: ignore
+    from zipfile import Path as ZipPath
 else:
-    from zipp import Path as ZipPath  # type: ignore
+    from zipp import Path as ZipPath
diff --git a/lib/importlib_resources/readers.py b/lib/importlib_resources/readers.py
index 4a80a774..4f761c64 100644
--- a/lib/importlib_resources/readers.py
+++ b/lib/importlib_resources/readers.py
@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import collections
 import contextlib
 import itertools
@@ -5,6 +7,7 @@ import pathlib
 import operator
 import re
 import warnings
+from collections.abc import Iterator
 
 from . import abc
 
@@ -34,8 +37,10 @@ class FileReader(abc.TraversableResources):
 
 class ZipReader(abc.TraversableResources):
     def __init__(self, loader, module):
-        _, _, name = module.rpartition('.')
-        self.prefix = loader.prefix.replace('\\', '/') + name + '/'
+        self.prefix = loader.prefix.replace('\\', '/')
+        if loader.is_package(module):
+            _, _, name = module.rpartition('.')
+            self.prefix += name + '/'
         self.archive = loader.archive
 
     def open_resource(self, resource):
@@ -133,27 +138,31 @@ class NamespaceReader(abc.TraversableResources):
     def __init__(self, namespace_path):
         if 'NamespacePath' not in str(namespace_path):
             raise ValueError('Invalid path')
-        self.path = MultiplexedPath(*map(self._resolve, namespace_path))
+        self.path = MultiplexedPath(*filter(bool, map(self._resolve, namespace_path)))
 
     @classmethod
-    def _resolve(cls, path_str) -> abc.Traversable:
+    def _resolve(cls, path_str) -> abc.Traversable | None:
         r"""
         Given an item from a namespace path, resolve it to a Traversable.
 
         path_str might be a directory on the filesystem or a path to a
         zipfile plus the path within the zipfile, e.g. ``/foo/bar`` or
         ``/foo/baz.zip/inner_dir`` or ``foo\baz.zip\inner_dir\sub``.
+
+        path_str might also be a sentinel used by editable packages to
+        trigger other behaviors (see python/importlib_resources#311).
+        In that case, return None.
         """
-        (dir,) = (cand for cand in cls._candidate_paths(path_str) if cand.is_dir())
-        return dir
+        dirs = (cand for cand in cls._candidate_paths(path_str) if cand.is_dir())
+        return next(dirs, None)
 
     @classmethod
-    def _candidate_paths(cls, path_str):
+    def _candidate_paths(cls, path_str: str) -> Iterator[abc.Traversable]:
         yield pathlib.Path(path_str)
         yield from cls._resolve_zip_path(path_str)
 
     @staticmethod
-    def _resolve_zip_path(path_str):
+    def _resolve_zip_path(path_str: str):
         for match in reversed(list(re.finditer(r'[\\/]', path_str))):
             with contextlib.suppress(
                 FileNotFoundError,
diff --git a/lib/importlib_resources/simple.py b/lib/importlib_resources/simple.py
index 96f117fe..2e75299b 100644
--- a/lib/importlib_resources/simple.py
+++ b/lib/importlib_resources/simple.py
@@ -77,7 +77,7 @@ class ResourceHandle(Traversable):
 
     def __init__(self, parent: ResourceContainer, name: str):
         self.parent = parent
-        self.name = name  # type: ignore
+        self.name = name  # type: ignore[misc]
 
     def is_file(self):
         return True
diff --git a/lib/importlib_resources/tests/_path.py b/lib/importlib_resources/tests/_path.py
index 1f97c961..b144628c 100644
--- a/lib/importlib_resources/tests/_path.py
+++ b/lib/importlib_resources/tests/_path.py
@@ -2,15 +2,44 @@ import pathlib
 import functools
 
 from typing import Dict, Union
+from typing import runtime_checkable
+from typing import Protocol
 
 
 ####
-# from jaraco.path 3.4.1
-
-FilesSpec = Dict[str, Union[str, bytes, 'FilesSpec']]  # type: ignore
+# from jaraco.path 3.7.1
 
 
-def build(spec: FilesSpec, prefix=pathlib.Path()):
+class Symlink(str):
+    """
+    A string indicating the target of a symlink.
+    """
+
+
+FilesSpec = Dict[str, Union[str, bytes, Symlink, 'FilesSpec']]
+
+
+@runtime_checkable
+class TreeMaker(Protocol):
+    def __truediv__(self, *args, **kwargs): ...  # pragma: no cover
+
+    def mkdir(self, **kwargs): ...  # pragma: no cover
+
+    def write_text(self, content, **kwargs): ...  # pragma: no cover
+
+    def write_bytes(self, content): ...  # pragma: no cover
+
+    def symlink_to(self, target): ...  # pragma: no cover
+
+
+def _ensure_tree_maker(obj: Union[str, TreeMaker]) -> TreeMaker:
+    return obj if isinstance(obj, TreeMaker) else pathlib.Path(obj)  # type: ignore[return-value]
+
+
+def build(
+    spec: FilesSpec,
+    prefix: Union[str, TreeMaker] = pathlib.Path(),  # type: ignore[assignment]
+):
     """
     Build a set of files/directories, as described by the spec.
 
@@ -25,21 +54,25 @@ def build(spec: FilesSpec, prefix=pathlib.Path()):
     ...             "__init__.py": "",
     ...         },
     ...         "baz.py": "# Some code",
-    ...     }
+    ...         "bar.py": Symlink("baz.py"),
+    ...     },
+    ...     "bing": Symlink("foo"),
     ... }
     >>> target = getfixture('tmp_path')
     >>> build(spec, target)
     >>> target.joinpath('foo/baz.py').read_text(encoding='utf-8')
     '# Some code'
+    >>> target.joinpath('bing/bar.py').read_text(encoding='utf-8')
+    '# Some code'
     """
     for name, contents in spec.items():
-        create(contents, pathlib.Path(prefix) / name)
+        create(contents, _ensure_tree_maker(prefix) / name)
 
 
 @functools.singledispatch
 def create(content: Union[str, bytes, FilesSpec], path):
     path.mkdir(exist_ok=True)
-    build(content, prefix=path)  # type: ignore
+    build(content, prefix=path)  # type: ignore[arg-type]
 
 
 @create.register
@@ -52,5 +85,10 @@ def _(content: str, path):
     path.write_text(content, encoding='utf-8')
 
 
+@create.register
+def _(content: Symlink, path):
+    path.symlink_to(content)
+
+
 # end from jaraco.path
 ####
diff --git a/lib/importlib_resources/tests/compat/py39.py b/lib/importlib_resources/tests/compat/py39.py
index e158eb85..e01d276b 100644
--- a/lib/importlib_resources/tests/compat/py39.py
+++ b/lib/importlib_resources/tests/compat/py39.py
@@ -8,3 +8,6 @@ import_helper = try_import('import_helper') or from_test_support(
     'modules_setup', 'modules_cleanup', 'DirsOnSysPath'
 )
 os_helper = try_import('os_helper') or from_test_support('temp_dir')
+warnings_helper = try_import('warnings_helper') or from_test_support(
+    'ignore_warnings', 'check_warnings'
+)
diff --git a/lib/importlib_resources/tests/data01/__init__.py b/lib/importlib_resources/tests/data01/__init__.py
deleted file mode 100644
index e69de29b..00000000
diff --git a/lib/importlib_resources/tests/data01/binary.file b/lib/importlib_resources/tests/data01/binary.file
deleted file mode 100644
index eaf36c1daccfdf325514461cd1a2ffbc139b5464..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 4
LcmZQzWMT#Y01f~L

diff --git a/lib/importlib_resources/tests/data01/subdirectory/__init__.py b/lib/importlib_resources/tests/data01/subdirectory/__init__.py
deleted file mode 100644
index e69de29b..00000000
diff --git a/lib/importlib_resources/tests/data01/subdirectory/binary.file b/lib/importlib_resources/tests/data01/subdirectory/binary.file
deleted file mode 100644
index 5bd8bb89..00000000
--- a/lib/importlib_resources/tests/data01/subdirectory/binary.file
+++ /dev/null
@@ -1 +0,0 @@
-
\ No newline at end of file
diff --git a/lib/importlib_resources/tests/data01/utf-16.file b/lib/importlib_resources/tests/data01/utf-16.file
deleted file mode 100644
index 2cb772295ef4b480a8d83725bd5006a0236d8f68..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 44
ucmezW&x0YAAqNQa8FUyF7(y9B7~B|i84MZBfV^^`Xc15@g+Y;liva-T)Ce>H

diff --git a/lib/importlib_resources/tests/data01/utf-8.file b/lib/importlib_resources/tests/data01/utf-8.file
deleted file mode 100644
index 1c0132ad..00000000
--- a/lib/importlib_resources/tests/data01/utf-8.file
+++ /dev/null
@@ -1 +0,0 @@
-Hello, UTF-8 world!
diff --git a/lib/importlib_resources/tests/data02/__init__.py b/lib/importlib_resources/tests/data02/__init__.py
deleted file mode 100644
index e69de29b..00000000
diff --git a/lib/importlib_resources/tests/data02/one/__init__.py b/lib/importlib_resources/tests/data02/one/__init__.py
deleted file mode 100644
index e69de29b..00000000
diff --git a/lib/importlib_resources/tests/data02/one/resource1.txt b/lib/importlib_resources/tests/data02/one/resource1.txt
deleted file mode 100644
index 61a813e4..00000000
--- a/lib/importlib_resources/tests/data02/one/resource1.txt
+++ /dev/null
@@ -1 +0,0 @@
-one resource
diff --git a/lib/importlib_resources/tests/data02/subdirectory/subsubdir/resource.txt b/lib/importlib_resources/tests/data02/subdirectory/subsubdir/resource.txt
deleted file mode 100644
index 48f587a2..00000000
--- a/lib/importlib_resources/tests/data02/subdirectory/subsubdir/resource.txt
+++ /dev/null
@@ -1 +0,0 @@
-a resource
\ No newline at end of file
diff --git a/lib/importlib_resources/tests/data02/two/__init__.py b/lib/importlib_resources/tests/data02/two/__init__.py
deleted file mode 100644
index e69de29b..00000000
diff --git a/lib/importlib_resources/tests/data02/two/resource2.txt b/lib/importlib_resources/tests/data02/two/resource2.txt
deleted file mode 100644
index a80ce46e..00000000
--- a/lib/importlib_resources/tests/data02/two/resource2.txt
+++ /dev/null
@@ -1 +0,0 @@
-two resource
diff --git a/lib/importlib_resources/tests/namespacedata01/binary.file b/lib/importlib_resources/tests/namespacedata01/binary.file
deleted file mode 100644
index eaf36c1daccfdf325514461cd1a2ffbc139b5464..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 4
LcmZQzWMT#Y01f~L

diff --git a/lib/importlib_resources/tests/namespacedata01/subdirectory/binary.file b/lib/importlib_resources/tests/namespacedata01/subdirectory/binary.file
deleted file mode 100644
index 100f5064..00000000
--- a/lib/importlib_resources/tests/namespacedata01/subdirectory/binary.file
+++ /dev/null
@@ -1 +0,0 @@
-

\ No newline at end of file
diff --git a/lib/importlib_resources/tests/namespacedata01/utf-16.file b/lib/importlib_resources/tests/namespacedata01/utf-16.file
deleted file mode 100644
index 2cb772295ef4b480a8d83725bd5006a0236d8f68..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 44
ucmezW&x0YAAqNQa8FUyF7(y9B7~B|i84MZBfV^^`Xc15@g+Y;liva-T)Ce>H

diff --git a/lib/importlib_resources/tests/namespacedata01/utf-8.file b/lib/importlib_resources/tests/namespacedata01/utf-8.file
deleted file mode 100644
index 1c0132ad..00000000
--- a/lib/importlib_resources/tests/namespacedata01/utf-8.file
+++ /dev/null
@@ -1 +0,0 @@
-Hello, UTF-8 world!
diff --git a/lib/importlib_resources/tests/test_contents.py b/lib/importlib_resources/tests/test_contents.py
index 7dc3b0a6..741a7407 100644
--- a/lib/importlib_resources/tests/test_contents.py
+++ b/lib/importlib_resources/tests/test_contents.py
@@ -1,7 +1,6 @@
 import unittest
 import importlib_resources as resources
 
-from . import data01
 from . import util
 
 
@@ -19,16 +18,17 @@ class ContentsTests:
         assert self.expected <= contents
 
 
-class ContentsDiskTests(ContentsTests, unittest.TestCase):
-    def setUp(self):
-        self.data = data01
+class ContentsDiskTests(ContentsTests, util.DiskSetup, unittest.TestCase):
+    pass
 
 
 class ContentsZipTests(ContentsTests, util.ZipSetup, unittest.TestCase):
     pass
 
 
-class ContentsNamespaceTests(ContentsTests, unittest.TestCase):
+class ContentsNamespaceTests(ContentsTests, util.DiskSetup, unittest.TestCase):
+    MODULE = 'namespacedata01'
+
     expected = {
         # no __init__ because of namespace design
         'binary.file',
@@ -36,8 +36,3 @@ class ContentsNamespaceTests(ContentsTests, unittest.TestCase):
         'utf-16.file',
         'utf-8.file',
     }
-
-    def setUp(self):
-        from . import namespacedata01
-
-        self.data = namespacedata01
diff --git a/lib/importlib_resources/tests/test_files.py b/lib/importlib_resources/tests/test_files.py
index 3e86ec64..f1fe2337 100644
--- a/lib/importlib_resources/tests/test_files.py
+++ b/lib/importlib_resources/tests/test_files.py
@@ -1,3 +1,7 @@
+import os
+import pathlib
+import py_compile
+import shutil
 import textwrap
 import unittest
 import warnings
@@ -6,11 +10,8 @@ import contextlib
 
 import importlib_resources as resources
 from ..abc import Traversable
-from . import data01
 from . import util
-from . import _path
-from .compat.py39 import os_helper
-from .compat.py312 import import_helper
+from .compat.py39 import os_helper, import_helper
 
 
 @contextlib.contextmanager
@@ -48,70 +49,146 @@ class FilesTests:
             resources.files(package=self.data)
 
 
-class OpenDiskTests(FilesTests, unittest.TestCase):
-    def setUp(self):
-        self.data = data01
+class OpenDiskTests(FilesTests, util.DiskSetup, unittest.TestCase):
+    pass
 
 
 class OpenZipTests(FilesTests, util.ZipSetup, unittest.TestCase):
     pass
 
 
-class OpenNamespaceTests(FilesTests, unittest.TestCase):
-    def setUp(self):
-        from . import namespacedata01
+class OpenNamespaceTests(FilesTests, util.DiskSetup, unittest.TestCase):
+    MODULE = 'namespacedata01'
 
-        self.data = namespacedata01
+    def test_non_paths_in_dunder_path(self):
+        """
+        Non-path items in a namespace package's ``__path__`` are ignored.
+
+        As reported in python/importlib_resources#311, some tools
+        like Setuptools, when creating editable packages, will inject
+        non-paths into a namespace package's ``__path__``, a
+        sentinel like
+        ``__editable__.sample_namespace-1.0.finder.__path_hook__``
+        to cause the ``PathEntryFinder`` to be called when searching
+        for packages. In that case, resources should still be loadable.
+        """
+        import namespacedata01
+
+        namespacedata01.__path__.append(
+            '__editable__.sample_namespace-1.0.finder.__path_hook__'
+        )
+
+        resources.files(namespacedata01)
 
 
 class OpenNamespaceZipTests(FilesTests, util.ZipSetup, unittest.TestCase):
     ZIP_MODULE = 'namespacedata01'
 
 
-class SiteDir:
-    def setUp(self):
-        self.fixtures = contextlib.ExitStack()
-        self.addCleanup(self.fixtures.close)
-        self.site_dir = self.fixtures.enter_context(os_helper.temp_dir())
-        self.fixtures.enter_context(import_helper.DirsOnSysPath(self.site_dir))
-        self.fixtures.enter_context(import_helper.isolated_modules())
+class DirectSpec:
+    """
+    Override behavior of ModuleSetup to write a full spec directly.
+    """
+
+    MODULE = 'unused'
+
+    def load_fixture(self, name):
+        self.tree_on_path(self.spec)
 
 
-class ModulesFilesTests(SiteDir, unittest.TestCase):
+class ModulesFiles:
+    spec = {
+        'mod.py': '',
+        'res.txt': 'resources are the best',
+    }
+
     def test_module_resources(self):
         """
         A module can have resources found adjacent to the module.
         """
-        spec = {
-            'mod.py': '',
-            'res.txt': 'resources are the best',
-        }
-        _path.build(spec, self.site_dir)
-        import mod
+        import mod  # type: ignore[import-not-found]
 
         actual = resources.files(mod).joinpath('res.txt').read_text(encoding='utf-8')
-        assert actual == spec['res.txt']
+        assert actual == self.spec['res.txt']
 
 
-class ImplicitContextFilesTests(SiteDir, unittest.TestCase):
-    def test_implicit_files(self):
+class ModuleFilesDiskTests(DirectSpec, util.DiskSetup, ModulesFiles, unittest.TestCase):
+    pass
+
+
+class ModuleFilesZipTests(DirectSpec, util.ZipSetup, ModulesFiles, unittest.TestCase):
+    pass
+
+
+class ImplicitContextFiles:
+    set_val = textwrap.dedent(
+        f"""
+        import {resources.__name__} as res
+        val = res.files().joinpath('res.txt').read_text(encoding='utf-8')
+        """
+    )
+    spec = {
+        'somepkg': {
+            '__init__.py': set_val,
+            'submod.py': set_val,
+            'res.txt': 'resources are the best',
+        },
+        'frozenpkg': {
+            '__init__.py': set_val.replace(resources.__name__, 'c_resources'),
+            'res.txt': 'resources are the best',
+        },
+    }
+
+    def test_implicit_files_package(self):
         """
         Without any parameter, files() will infer the location as the caller.
         """
-        spec = {
-            'somepkg': {
-                '__init__.py': textwrap.dedent(
-                    """
-                    import importlib_resources as res
-                    val = res.files().joinpath('res.txt').read_text(encoding='utf-8')
-                    """
-                ),
-                'res.txt': 'resources are the best',
-            },
-        }
-        _path.build(spec, self.site_dir)
         assert importlib.import_module('somepkg').val == 'resources are the best'
 
+    def test_implicit_files_submodule(self):
+        """
+        Without any parameter, files() will infer the location as the caller.
+        """
+        assert importlib.import_module('somepkg.submod').val == 'resources are the best'
+
+    def _compile_importlib(self):
+        """
+        Make a compiled-only copy of the importlib resources package.
+        """
+        bin_site = self.fixtures.enter_context(os_helper.temp_dir())
+        c_resources = pathlib.Path(bin_site, 'c_resources')
+        sources = pathlib.Path(resources.__file__).parent
+        shutil.copytree(sources, c_resources, ignore=lambda *_: ['__pycache__'])
+
+        for dirpath, _, filenames in os.walk(c_resources):
+            for filename in filenames:
+                source_path = pathlib.Path(dirpath) / filename
+                cfile = source_path.with_suffix('.pyc')
+                py_compile.compile(source_path, cfile)
+                pathlib.Path.unlink(source_path)
+        self.fixtures.enter_context(import_helper.DirsOnSysPath(bin_site))
+
+    def test_implicit_files_with_compiled_importlib(self):
+        """
+        Caller detection works for compiled-only resources module.
+
+        python/cpython#123085
+        """
+        self._compile_importlib()
+        assert importlib.import_module('frozenpkg').val == 'resources are the best'
+
+
+class ImplicitContextFilesDiskTests(
+    DirectSpec, util.DiskSetup, ImplicitContextFiles, unittest.TestCase
+):
+    pass
+
+
+class ImplicitContextFilesZipTests(
+    DirectSpec, util.ZipSetup, ImplicitContextFiles, unittest.TestCase
+):
+    pass
+
 
 if __name__ == '__main__':
     unittest.main()
diff --git a/lib/importlib_resources/tests/test_functional.py b/lib/importlib_resources/tests/test_functional.py
index 69706cf7..1851edfb 100644
--- a/lib/importlib_resources/tests/test_functional.py
+++ b/lib/importlib_resources/tests/test_functional.py
@@ -1,31 +1,38 @@
 import unittest
 import os
-import contextlib
+import importlib
 
-try:
-    from test.support.warnings_helper import ignore_warnings, check_warnings
-except ImportError:
-    # older Python versions
-    from test.support import ignore_warnings, check_warnings
+from .compat.py39 import warnings_helper
 
 import importlib_resources as resources
 
+from . import util
+
 # Since the functional API forwards to Traversable, we only test
 # filesystem resources here -- not zip files, namespace packages etc.
 # We do test for two kinds of Anchor, though.
 
 
 class StringAnchorMixin:
-    anchor01 = 'importlib_resources.tests.data01'
-    anchor02 = 'importlib_resources.tests.data02'
+    anchor01 = 'data01'
+    anchor02 = 'data02'
 
 
 class ModuleAnchorMixin:
-    from . import data01 as anchor01
-    from . import data02 as anchor02
+    @property
+    def anchor01(self):
+        return importlib.import_module('data01')
+
+    @property
+    def anchor02(self):
+        return importlib.import_module('data02')
 
 
-class FunctionalAPIBase:
+class FunctionalAPIBase(util.DiskSetup):
+    def setUp(self):
+        super().setUp()
+        self.load_fixture('data02')
+
     def _gen_resourcetxt_path_parts(self):
         """Yield various names of a text file in anchor02, each in a subTest"""
         for path_parts in (
@@ -36,6 +43,12 @@ class FunctionalAPIBase:
             with self.subTest(path_parts=path_parts):
                 yield path_parts
 
+    def assertEndsWith(self, string, suffix):
+        """Assert that `string` ends with `suffix`.
+
+        Used to ignore an architecture-specific UTF-16 byte-order mark."""
+        self.assertEqual(string[-len(suffix) :], suffix)
+
     def test_read_text(self):
         self.assertEqual(
             resources.read_text(self.anchor01, 'utf-8.file'),
@@ -76,13 +89,13 @@ class FunctionalAPIBase:
             ),
             '\x00\x01\x02\x03',
         )
-        self.assertEqual(
+        self.assertEndsWith(  # ignore the BOM
             resources.read_text(
                 self.anchor01,
                 'utf-16.file',
                 errors='backslashreplace',
             ),
-            'Hello, UTF-16 world!\n'.encode('utf-16').decode(
+            'Hello, UTF-16 world!\n'.encode('utf-16-le').decode(
                 errors='backslashreplace',
             ),
         )
@@ -128,9 +141,9 @@ class FunctionalAPIBase:
             'utf-16.file',
             errors='backslashreplace',
         ) as f:
-            self.assertEqual(
+            self.assertEndsWith(  # ignore the BOM
                 f.read(),
-                'Hello, UTF-16 world!\n'.encode('utf-16').decode(
+                'Hello, UTF-16 world!\n'.encode('utf-16-le').decode(
                     errors='backslashreplace',
                 ),
             )
@@ -163,32 +176,32 @@ class FunctionalAPIBase:
             self.assertTrue(is_resource(self.anchor02, *path_parts))
 
     def test_contents(self):
-        with check_warnings((".*contents.*", DeprecationWarning)):
+        with warnings_helper.check_warnings((".*contents.*", DeprecationWarning)):
             c = resources.contents(self.anchor01)
         self.assertGreaterEqual(
             set(c),
             {'utf-8.file', 'utf-16.file', 'binary.file', 'subdirectory'},
         )
-        with contextlib.ExitStack() as cm:
-            cm.enter_context(self.assertRaises(OSError))
-            cm.enter_context(check_warnings((".*contents.*", DeprecationWarning)))
-
+        with self.assertRaises(OSError), warnings_helper.check_warnings((
+            ".*contents.*",
+            DeprecationWarning,
+        )):
             list(resources.contents(self.anchor01, 'utf-8.file'))
 
         for path_parts in self._gen_resourcetxt_path_parts():
-            with contextlib.ExitStack() as cm:
-                cm.enter_context(self.assertRaises(OSError))
-                cm.enter_context(check_warnings((".*contents.*", DeprecationWarning)))
-
+            with self.assertRaises(OSError), warnings_helper.check_warnings((
+                ".*contents.*",
+                DeprecationWarning,
+            )):
                 list(resources.contents(self.anchor01, *path_parts))
-        with check_warnings((".*contents.*", DeprecationWarning)):
+        with warnings_helper.check_warnings((".*contents.*", DeprecationWarning)):
             c = resources.contents(self.anchor01, 'subdirectory')
         self.assertGreaterEqual(
             set(c),
             {'binary.file'},
         )
 
-    @ignore_warnings(category=DeprecationWarning)
+    @warnings_helper.ignore_warnings(category=DeprecationWarning)
     def test_common_errors(self):
         for func in (
             resources.read_text,
@@ -227,16 +240,16 @@ class FunctionalAPIBase:
 
 
 class FunctionalAPITest_StringAnchor(
-    unittest.TestCase,
-    FunctionalAPIBase,
     StringAnchorMixin,
+    FunctionalAPIBase,
+    unittest.TestCase,
 ):
     pass
 
 
 class FunctionalAPITest_ModuleAnchor(
-    unittest.TestCase,
-    FunctionalAPIBase,
     ModuleAnchorMixin,
+    FunctionalAPIBase,
+    unittest.TestCase,
 ):
     pass
diff --git a/lib/importlib_resources/tests/test_open.py b/lib/importlib_resources/tests/test_open.py
index 44f1018a..c40bb8c6 100644
--- a/lib/importlib_resources/tests/test_open.py
+++ b/lib/importlib_resources/tests/test_open.py
@@ -1,7 +1,6 @@
 import unittest
 
 import importlib_resources as resources
-from . import data01
 from . import util
 
 
@@ -65,16 +64,12 @@ class OpenTests:
             target.open(encoding='utf-8')
 
 
-class OpenDiskTests(OpenTests, unittest.TestCase):
-    def setUp(self):
-        self.data = data01
+class OpenDiskTests(OpenTests, util.DiskSetup, unittest.TestCase):
+    pass
 
 
-class OpenDiskNamespaceTests(OpenTests, unittest.TestCase):
-    def setUp(self):
-        from . import namespacedata01
-
-        self.data = namespacedata01
+class OpenDiskNamespaceTests(OpenTests, util.DiskSetup, unittest.TestCase):
+    MODULE = 'namespacedata01'
 
 
 class OpenZipTests(OpenTests, util.ZipSetup, unittest.TestCase):
@@ -82,7 +77,7 @@ class OpenZipTests(OpenTests, util.ZipSetup, unittest.TestCase):
 
 
 class OpenNamespaceZipTests(OpenTests, util.ZipSetup, unittest.TestCase):
-    ZIP_MODULE = 'namespacedata01'
+    MODULE = 'namespacedata01'
 
 
 if __name__ == '__main__':
diff --git a/lib/importlib_resources/tests/test_path.py b/lib/importlib_resources/tests/test_path.py
index c3e1cbb4..1e30f2bc 100644
--- a/lib/importlib_resources/tests/test_path.py
+++ b/lib/importlib_resources/tests/test_path.py
@@ -3,7 +3,6 @@ import pathlib
 import unittest
 
 import importlib_resources as resources
-from . import data01
 from . import util
 
 
@@ -25,9 +24,7 @@ class PathTests:
             self.assertEqual('Hello, UTF-8 world!\n', path.read_text(encoding='utf-8'))
 
 
-class PathDiskTests(PathTests, unittest.TestCase):
-    data = data01
-
+class PathDiskTests(PathTests, util.DiskSetup, unittest.TestCase):
     def test_natural_path(self):
         """
         Guarantee the internal implementation detail that
diff --git a/lib/importlib_resources/tests/test_read.py b/lib/importlib_resources/tests/test_read.py
index 97d90128..6780a2d1 100644
--- a/lib/importlib_resources/tests/test_read.py
+++ b/lib/importlib_resources/tests/test_read.py
@@ -1,7 +1,6 @@
 import unittest
 import importlib_resources as resources
 
-from . import data01
 from . import util
 from importlib import import_module
 
@@ -52,8 +51,8 @@ class ReadTests:
         )
 
 
-class ReadDiskTests(ReadTests, unittest.TestCase):
-    data = data01
+class ReadDiskTests(ReadTests, util.DiskSetup, unittest.TestCase):
+    pass
 
 
 class ReadZipTests(ReadTests, util.ZipSetup, unittest.TestCase):
@@ -69,15 +68,12 @@ class ReadZipTests(ReadTests, util.ZipSetup, unittest.TestCase):
         self.assertEqual(result, bytes(range(4, 8)))
 
 
-class ReadNamespaceTests(ReadTests, unittest.TestCase):
-    def setUp(self):
-        from . import namespacedata01
-
-        self.data = namespacedata01
+class ReadNamespaceTests(ReadTests, util.DiskSetup, unittest.TestCase):
+    MODULE = 'namespacedata01'
 
 
 class ReadNamespaceZipTests(ReadTests, util.ZipSetup, unittest.TestCase):
-    ZIP_MODULE = 'namespacedata01'
+    MODULE = 'namespacedata01'
 
     def test_read_submodule_resource(self):
         submodule = import_module('namespacedata01.subdirectory')
diff --git a/lib/importlib_resources/tests/test_reader.py b/lib/importlib_resources/tests/test_reader.py
index 95c2fc85..0a77eb40 100644
--- a/lib/importlib_resources/tests/test_reader.py
+++ b/lib/importlib_resources/tests/test_reader.py
@@ -1,16 +1,21 @@
 import os.path
-import sys
 import pathlib
 import unittest
 
 from importlib import import_module
 from importlib_resources.readers import MultiplexedPath, NamespaceReader
 
+from . import util
 
-class MultiplexedPathTest(unittest.TestCase):
-    @classmethod
-    def setUpClass(cls):
-        cls.folder = pathlib.Path(__file__).parent / 'namespacedata01'
+
+class MultiplexedPathTest(util.DiskSetup, unittest.TestCase):
+    MODULE = 'namespacedata01'
+
+    def setUp(self):
+        super().setUp()
+        self.folder = pathlib.Path(self.data.__path__[0])
+        self.data01 = pathlib.Path(self.load_fixture('data01').__file__).parent
+        self.data02 = pathlib.Path(self.load_fixture('data02').__file__).parent
 
     def test_init_no_paths(self):
         with self.assertRaises(FileNotFoundError):
@@ -31,9 +36,8 @@ class MultiplexedPathTest(unittest.TestCase):
         )
 
     def test_iterdir_duplicate(self):
-        data01 = pathlib.Path(__file__).parent.joinpath('data01')
         contents = {
-            path.name for path in MultiplexedPath(self.folder, data01).iterdir()
+            path.name for path in MultiplexedPath(self.folder, self.data01).iterdir()
         }
         for remove in ('__pycache__', '__init__.pyc'):
             try:
@@ -61,9 +65,8 @@ class MultiplexedPathTest(unittest.TestCase):
             path.open()
 
     def test_join_path(self):
-        data01 = pathlib.Path(__file__).parent.joinpath('data01')
-        prefix = str(data01.parent)
-        path = MultiplexedPath(self.folder, data01)
+        prefix = str(self.folder.parent)
+        path = MultiplexedPath(self.folder, self.data01)
         self.assertEqual(
             str(path.joinpath('binary.file'))[len(prefix) + 1 :],
             os.path.join('namespacedata01', 'binary.file'),
@@ -83,10 +86,8 @@ class MultiplexedPathTest(unittest.TestCase):
         assert not path.joinpath('imaginary/foo.py').exists()
 
     def test_join_path_common_subdir(self):
-        data01 = pathlib.Path(__file__).parent.joinpath('data01')
-        data02 = pathlib.Path(__file__).parent.joinpath('data02')
-        prefix = str(data01.parent)
-        path = MultiplexedPath(data01, data02)
+        prefix = str(self.data02.parent)
+        path = MultiplexedPath(self.data01, self.data02)
         self.assertIsInstance(path.joinpath('subdirectory'), MultiplexedPath)
         self.assertEqual(
             str(path.joinpath('subdirectory', 'subsubdir'))[len(prefix) + 1 :],
@@ -106,16 +107,8 @@ class MultiplexedPathTest(unittest.TestCase):
         )
 
 
-class NamespaceReaderTest(unittest.TestCase):
-    site_dir = str(pathlib.Path(__file__).parent)
-
-    @classmethod
-    def setUpClass(cls):
-        sys.path.append(cls.site_dir)
-
-    @classmethod
-    def tearDownClass(cls):
-        sys.path.remove(cls.site_dir)
+class NamespaceReaderTest(util.DiskSetup, unittest.TestCase):
+    MODULE = 'namespacedata01'
 
     def test_init_error(self):
         with self.assertRaises(ValueError):
@@ -125,7 +118,7 @@ class NamespaceReaderTest(unittest.TestCase):
         namespacedata01 = import_module('namespacedata01')
         reader = NamespaceReader(namespacedata01.__spec__.submodule_search_locations)
 
-        root = os.path.abspath(os.path.join(__file__, '..', 'namespacedata01'))
+        root = self.data.__path__[0]
         self.assertEqual(
             reader.resource_path('binary.file'), os.path.join(root, 'binary.file')
         )
@@ -134,9 +127,8 @@ class NamespaceReaderTest(unittest.TestCase):
         )
 
     def test_files(self):
-        namespacedata01 = import_module('namespacedata01')
-        reader = NamespaceReader(namespacedata01.__spec__.submodule_search_locations)
-        root = os.path.abspath(os.path.join(__file__, '..', 'namespacedata01'))
+        reader = NamespaceReader(self.data.__spec__.submodule_search_locations)
+        root = self.data.__path__[0]
         self.assertIsInstance(reader.files(), MultiplexedPath)
         self.assertEqual(repr(reader.files()), f"MultiplexedPath('{root}')")
 
diff --git a/lib/importlib_resources/tests/test_resource.py b/lib/importlib_resources/tests/test_resource.py
index dc2a108c..a0da6a35 100644
--- a/lib/importlib_resources/tests/test_resource.py
+++ b/lib/importlib_resources/tests/test_resource.py
@@ -1,9 +1,6 @@
-import sys
 import unittest
 import importlib_resources as resources
-import pathlib
 
-from . import data01
 from . import util
 from importlib import import_module
 
@@ -25,9 +22,8 @@ class ResourceTests:
         self.assertTrue(target.is_dir())
 
 
-class ResourceDiskTests(ResourceTests, unittest.TestCase):
-    def setUp(self):
-        self.data = data01
+class ResourceDiskTests(ResourceTests, util.DiskSetup, unittest.TestCase):
+    pass
 
 
 class ResourceZipTests(ResourceTests, util.ZipSetup, unittest.TestCase):
@@ -38,33 +34,39 @@ def names(traversable):
     return {item.name for item in traversable.iterdir()}
 
 
-class ResourceLoaderTests(unittest.TestCase):
+class ResourceLoaderTests(util.DiskSetup, unittest.TestCase):
     def test_resource_contents(self):
         package = util.create_package(
-            file=data01, path=data01.__file__, contents=['A', 'B', 'C']
+            file=self.data, path=self.data.__file__, contents=['A', 'B', 'C']
         )
         self.assertEqual(names(resources.files(package)), {'A', 'B', 'C'})
 
     def test_is_file(self):
         package = util.create_package(
-            file=data01, path=data01.__file__, contents=['A', 'B', 'C', 'D/E', 'D/F']
+            file=self.data,
+            path=self.data.__file__,
+            contents=['A', 'B', 'C', 'D/E', 'D/F'],
         )
         self.assertTrue(resources.files(package).joinpath('B').is_file())
 
     def test_is_dir(self):
         package = util.create_package(
-            file=data01, path=data01.__file__, contents=['A', 'B', 'C', 'D/E', 'D/F']
+            file=self.data,
+            path=self.data.__file__,
+            contents=['A', 'B', 'C', 'D/E', 'D/F'],
         )
         self.assertTrue(resources.files(package).joinpath('D').is_dir())
 
     def test_resource_missing(self):
         package = util.create_package(
-            file=data01, path=data01.__file__, contents=['A', 'B', 'C', 'D/E', 'D/F']
+            file=self.data,
+            path=self.data.__file__,
+            contents=['A', 'B', 'C', 'D/E', 'D/F'],
         )
         self.assertFalse(resources.files(package).joinpath('Z').is_file())
 
 
-class ResourceCornerCaseTests(unittest.TestCase):
+class ResourceCornerCaseTests(util.DiskSetup, unittest.TestCase):
     def test_package_has_no_reader_fallback(self):
         """
         Test odd ball packages which:
@@ -73,7 +75,7 @@ class ResourceCornerCaseTests(unittest.TestCase):
         # 3. Are not in a zip file
         """
         module = util.create_package(
-            file=data01, path=data01.__file__, contents=['A', 'B', 'C']
+            file=self.data, path=self.data.__file__, contents=['A', 'B', 'C']
         )
         # Give the module a dummy loader.
         module.__loader__ = object()
@@ -84,9 +86,7 @@ class ResourceCornerCaseTests(unittest.TestCase):
         self.assertFalse(resources.files(module).joinpath('A').is_file())
 
 
-class ResourceFromZipsTest01(util.ZipSetupBase, unittest.TestCase):
-    ZIP_MODULE = 'data01'
-
+class ResourceFromZipsTest01(util.ZipSetup, unittest.TestCase):
     def test_is_submodule_resource(self):
         submodule = import_module('data01.subdirectory')
         self.assertTrue(resources.files(submodule).joinpath('binary.file').is_file())
@@ -117,8 +117,8 @@ class ResourceFromZipsTest01(util.ZipSetupBase, unittest.TestCase):
         assert not data.parent.exists()
 
 
-class ResourceFromZipsTest02(util.ZipSetupBase, unittest.TestCase):
-    ZIP_MODULE = 'data02'
+class ResourceFromZipsTest02(util.ZipSetup, unittest.TestCase):
+    MODULE = 'data02'
 
     def test_unrelated_contents(self):
         """
@@ -135,7 +135,7 @@ class ResourceFromZipsTest02(util.ZipSetupBase, unittest.TestCase):
         )
 
 
-class DeletingZipsTest(util.ZipSetupBase, unittest.TestCase):
+class DeletingZipsTest(util.ZipSetup, unittest.TestCase):
     """Having accessed resources in a zip file should not keep an open
     reference to the zip.
     """
@@ -217,24 +217,20 @@ class ResourceFromNamespaceTests:
         self.assertEqual(contents, {'binary.file'})
 
 
-class ResourceFromNamespaceDiskTests(ResourceFromNamespaceTests, unittest.TestCase):
-    site_dir = str(pathlib.Path(__file__).parent)
-
-    @classmethod
-    def setUpClass(cls):
-        sys.path.append(cls.site_dir)
-
-    @classmethod
-    def tearDownClass(cls):
-        sys.path.remove(cls.site_dir)
-
-
-class ResourceFromNamespaceZipTests(
-    util.ZipSetupBase,
+class ResourceFromNamespaceDiskTests(
+    util.DiskSetup,
     ResourceFromNamespaceTests,
     unittest.TestCase,
 ):
-    ZIP_MODULE = 'namespacedata01'
+    MODULE = 'namespacedata01'
+
+
+class ResourceFromNamespaceZipTests(
+    util.ZipSetup,
+    ResourceFromNamespaceTests,
+    unittest.TestCase,
+):
+    MODULE = 'namespacedata01'
 
 
 if __name__ == '__main__':
diff --git a/lib/importlib_resources/tests/util.py b/lib/importlib_resources/tests/util.py
index fb827d2f..a4eafac3 100644
--- a/lib/importlib_resources/tests/util.py
+++ b/lib/importlib_resources/tests/util.py
@@ -6,10 +6,10 @@ import types
 import pathlib
 import contextlib
 
-from . import data01
 from ..abc import ResourceReader
 from .compat.py39 import import_helper, os_helper
 from . import zip as zip_
+from . import _path
 
 
 from importlib.machinery import ModuleSpec
@@ -68,7 +68,7 @@ def create_package(file=None, path=None, is_package=True, contents=()):
     )
 
 
-class CommonTests(metaclass=abc.ABCMeta):
+class CommonTestsBase(metaclass=abc.ABCMeta):
     """
     Tests shared by test_open, test_path, and test_read.
     """
@@ -84,34 +84,34 @@ class CommonTests(metaclass=abc.ABCMeta):
         """
         Passing in the package name should succeed.
         """
-        self.execute(data01.__name__, 'utf-8.file')
+        self.execute(self.data.__name__, 'utf-8.file')
 
     def test_package_object(self):
         """
         Passing in the package itself should succeed.
         """
-        self.execute(data01, 'utf-8.file')
+        self.execute(self.data, 'utf-8.file')
 
     def test_string_path(self):
         """
         Passing in a string for the path should succeed.
         """
         path = 'utf-8.file'
-        self.execute(data01, path)
+        self.execute(self.data, path)
 
     def test_pathlib_path(self):
         """
         Passing in a pathlib.PurePath object for the path should succeed.
         """
         path = pathlib.PurePath('utf-8.file')
-        self.execute(data01, path)
+        self.execute(self.data, path)
 
     def test_importing_module_as_side_effect(self):
         """
         The anchor package can already be imported.
         """
-        del sys.modules[data01.__name__]
-        self.execute(data01.__name__, 'utf-8.file')
+        del sys.modules[self.data.__name__]
+        self.execute(self.data.__name__, 'utf-8.file')
 
     def test_missing_path(self):
         """
@@ -141,24 +141,66 @@ class CommonTests(metaclass=abc.ABCMeta):
             self.execute(package, 'utf-8.file')
 
 
-class ZipSetupBase:
-    ZIP_MODULE = 'data01'
+fixtures = dict(
+    data01={
+        '__init__.py': '',
+        'binary.file': bytes(range(4)),
+        'utf-16.file': 'Hello, UTF-16 world!\n'.encode('utf-16'),
+        'utf-8.file': 'Hello, UTF-8 world!\n'.encode('utf-8'),
+        'subdirectory': {
+            '__init__.py': '',
+            'binary.file': bytes(range(4, 8)),
+        },
+    },
+    data02={
+        '__init__.py': '',
+        'one': {'__init__.py': '', 'resource1.txt': 'one resource'},
+        'two': {'__init__.py': '', 'resource2.txt': 'two resource'},
+        'subdirectory': {'subsubdir': {'resource.txt': 'a resource'}},
+    },
+    namespacedata01={
+        'binary.file': bytes(range(4)),
+        'utf-16.file': 'Hello, UTF-16 world!\n'.encode('utf-16'),
+        'utf-8.file': 'Hello, UTF-8 world!\n'.encode('utf-8'),
+        'subdirectory': {
+            'binary.file': bytes(range(12, 16)),
+        },
+    },
+)
 
+
+class ModuleSetup:
     def setUp(self):
         self.fixtures = contextlib.ExitStack()
         self.addCleanup(self.fixtures.close)
 
         self.fixtures.enter_context(import_helper.isolated_modules())
+        self.data = self.load_fixture(self.MODULE)
 
+    def load_fixture(self, module):
+        self.tree_on_path({module: fixtures[module]})
+        return importlib.import_module(module)
+
+
+class ZipSetup(ModuleSetup):
+    MODULE = 'data01'
+
+    def tree_on_path(self, spec):
         temp_dir = self.fixtures.enter_context(os_helper.temp_dir())
         modules = pathlib.Path(temp_dir) / 'zipped modules.zip'
-        src_path = pathlib.Path(__file__).parent.joinpath(self.ZIP_MODULE)
         self.fixtures.enter_context(
-            import_helper.DirsOnSysPath(str(zip_.make_zip_file(src_path, modules)))
+            import_helper.DirsOnSysPath(str(zip_.make_zip_file(spec, modules)))
         )
 
-        self.data = importlib.import_module(self.ZIP_MODULE)
+
+class DiskSetup(ModuleSetup):
+    MODULE = 'data01'
+
+    def tree_on_path(self, spec):
+        temp_dir = self.fixtures.enter_context(os_helper.temp_dir())
+        _path.build(spec, pathlib.Path(temp_dir))
+        self.fixtures.enter_context(import_helper.DirsOnSysPath(temp_dir))
 
 
-class ZipSetup(ZipSetupBase):
+class CommonTests(DiskSetup, CommonTestsBase):
     pass
diff --git a/lib/importlib_resources/tests/zip.py b/lib/importlib_resources/tests/zip.py
index 962195a9..51ee5648 100644
--- a/lib/importlib_resources/tests/zip.py
+++ b/lib/importlib_resources/tests/zip.py
@@ -2,31 +2,25 @@
 Generate zip test data files.
 """
 
-import contextlib
-import os
-import pathlib
 import zipfile
 
 import zipp
 
 
-def make_zip_file(src, dst):
+def make_zip_file(tree, dst):
     """
-    Zip the files in src into a new zipfile at dst.
+    Zip the files in tree into a new zipfile at dst.
     """
     with zipfile.ZipFile(dst, 'w') as zf:
-        for src_path, rel in walk(src):
-            dst_name = src.name / pathlib.PurePosixPath(rel.as_posix())
-            zf.write(src_path, dst_name)
+        for name, contents in walk(tree):
+            zf.writestr(name, contents)
         zipp.CompleteDirs.inject(zf)
     return dst
 
 
-def walk(datapath):
-    for dirpath, dirnames, filenames in os.walk(datapath):
-        with contextlib.suppress(ValueError):
-            dirnames.remove('__pycache__')
-        for filename in filenames:
-            res = pathlib.Path(dirpath) / filename
-            rel = res.relative_to(datapath)
-            yield res, rel
+def walk(tree, prefix=''):
+    for name, contents in tree.items():
+        if isinstance(contents, dict):
+            yield from walk(contents, prefix=f'{prefix}{name}/')
+        else:
+            yield f'{prefix}{name}', contents
diff --git a/lib/zipp/__init__.py b/lib/zipp/__init__.py
index d65297b8..031d9d4f 100644
--- a/lib/zipp/__init__.py
+++ b/lib/zipp/__init__.py
@@ -1,16 +1,27 @@
+"""
+A Path-like interface for zipfiles.
+
+This codebase is shared between zipfile.Path in the stdlib
+and zipp in PyPI. See
+https://github.com/python/importlib_metadata/wiki/Development-Methodology
+for more detail.
+"""
+
+import functools
 import io
-import posixpath
-import zipfile
 import itertools
-import contextlib
 import pathlib
+import posixpath
 import re
 import stat
 import sys
+import zipfile
 
 from .compat.py310 import text_encoding
 from .glob import Translator
 
+from ._functools import save_method_args
+
 
 __all__ = ['Path']
 
@@ -37,7 +48,7 @@ def _parents(path):
 def _ancestry(path):
     """
     Given a path with elements separated by
-    posixpath.sep, generate all elements of that path
+    posixpath.sep, generate all elements of that path.
 
     >>> list(_ancestry('b/d'))
     ['b/d', 'b']
@@ -49,9 +60,14 @@ def _ancestry(path):
     ['b']
     >>> list(_ancestry(''))
     []
+
+    Multiple separators are treated like a single.
+
+    >>> list(_ancestry('//b//d///f//'))
+    ['//b//d///f', '//b//d', '//b']
     """
     path = path.rstrip(posixpath.sep)
-    while path and path != posixpath.sep:
+    while path.rstrip(posixpath.sep):
         yield path
         path, tail = posixpath.split(path)
 
@@ -73,82 +89,19 @@ class InitializedState:
     Mix-in to save the initialization state for pickling.
     """
 
+    @save_method_args
     def __init__(self, *args, **kwargs):
-        self.__args = args
-        self.__kwargs = kwargs
         super().__init__(*args, **kwargs)
 
     def __getstate__(self):
-        return self.__args, self.__kwargs
+        return self._saved___init__.args, self._saved___init__.kwargs
 
     def __setstate__(self, state):
         args, kwargs = state
         super().__init__(*args, **kwargs)
 
 
-class SanitizedNames:
-    """
-    ZipFile mix-in to ensure names are sanitized.
-    """
-
-    def namelist(self):
-        return list(map(self._sanitize, super().namelist()))
-
-    @staticmethod
-    def _sanitize(name):
-        r"""
-        Ensure a relative path with posix separators and no dot names.
-
-        Modeled after
-        https://github.com/python/cpython/blob/bcc1be39cb1d04ad9fc0bd1b9193d3972835a57c/Lib/zipfile/__init__.py#L1799-L1813
-        but provides consistent cross-platform behavior.
-
-        >>> san = SanitizedNames._sanitize
-        >>> san('/foo/bar')
-        'foo/bar'
-        >>> san('//foo.txt')
-        'foo.txt'
-        >>> san('foo/.././bar.txt')
-        'foo/bar.txt'
-        >>> san('foo../.bar.txt')
-        'foo../.bar.txt'
-        >>> san('\\foo\\bar.txt')
-        'foo/bar.txt'
-        >>> san('D:\\foo.txt')
-        'D/foo.txt'
-        >>> san('\\\\server\\share\\file.txt')
-        'server/share/file.txt'
-        >>> san('\\\\?\\GLOBALROOT\\Volume3')
-        '?/GLOBALROOT/Volume3'
-        >>> san('\\\\.\\PhysicalDrive1\\root')
-        'PhysicalDrive1/root'
-
-        Retain any trailing slash.
-        >>> san('abc/')
-        'abc/'
-
-        Raises a ValueError if the result is empty.
-        >>> san('../..')
-        Traceback (most recent call last):
-        ...
-        ValueError: Empty filename
-        """
-
-        def allowed(part):
-            return part and part not in {'..', '.'}
-
-        # Remove the drive letter.
-        # Don't use ntpath.splitdrive, because that also strips UNC paths
-        bare = re.sub('^([A-Z]):', r'\1', name, flags=re.IGNORECASE)
-        clean = bare.replace('\\', '/')
-        parts = clean.split('/')
-        joined = '/'.join(filter(allowed, parts))
-        if not joined:
-            raise ValueError("Empty filename")
-        return joined + '/' * name.endswith('/')
-
-
-class CompleteDirs(InitializedState, SanitizedNames, zipfile.ZipFile):
+class CompleteDirs(InitializedState, zipfile.ZipFile):
     """
     A ZipFile subclass that ensures that implied directories
     are always included in the namelist.
@@ -230,16 +183,18 @@ class FastLookup(CompleteDirs):
     """
 
     def namelist(self):
-        with contextlib.suppress(AttributeError):
-            return self.__names
-        self.__names = super().namelist()
-        return self.__names
+        return self._namelist
+
+    @functools.cached_property
+    def _namelist(self):
+        return super().namelist()
 
     def _name_set(self):
-        with contextlib.suppress(AttributeError):
-            return self.__lookup
-        self.__lookup = super()._name_set()
-        return self.__lookup
+        return self._name_set_prop
+
+    @functools.cached_property
+    def _name_set_prop(self):
+        return super()._name_set()
 
 
 def _extract_text_encoding(encoding=None, *args, **kwargs):
@@ -329,7 +284,7 @@ class Path:
     >>> str(path.parent)
     'mem'
 
-    If the zipfile has no filename, such attributes are not
+    If the zipfile has no filename, such attributes are not
     valid and accessing them will raise an Exception.
 
     >>> zf.filename = None
@@ -388,7 +343,7 @@ class Path:
         if self.is_dir():
             raise IsADirectoryError(self)
         zip_mode = mode[0]
-        if not self.exists() and zip_mode == 'r':
+        if zip_mode == 'r' and not self.exists():
             raise FileNotFoundError(self)
         stream = self.root.open(self.at, zip_mode, pwd=pwd)
         if 'b' in mode:
@@ -470,8 +425,7 @@ class Path:
         prefix = re.escape(self.at)
         tr = Translator(seps='/')
         matches = re.compile(prefix + tr.translate(pattern)).fullmatch
-        names = (data.filename for data in self.root.filelist)
-        return map(self._next, filter(matches, names))
+        return map(self._next, filter(matches, self.root.namelist()))
 
     def rglob(self, pattern):
         return self.glob(f'**/{pattern}')
diff --git a/lib/zipp/_functools.py b/lib/zipp/_functools.py
new file mode 100644
index 00000000..f75ae2b0
--- /dev/null
+++ b/lib/zipp/_functools.py
@@ -0,0 +1,20 @@
+import collections
+import functools
+
+
+# from jaraco.functools 4.0.2
+def save_method_args(method):
+    """
+    Wrap a method such that when it is called, the args and kwargs are
+    saved on the method.
+    """
+    args_and_kwargs = collections.namedtuple('args_and_kwargs', 'args kwargs')
+
+    @functools.wraps(method)
+    def wrapper(self, /, *args, **kwargs):
+        attr_name = '_saved_' + method.__name__
+        attr = args_and_kwargs(args, kwargs)
+        setattr(self, attr_name, attr)
+        return method(self, *args, **kwargs)
+
+    return wrapper
diff --git a/lib/zipp/compat/overlay.py b/lib/zipp/compat/overlay.py
new file mode 100644
index 00000000..5a97ee7c
--- /dev/null
+++ b/lib/zipp/compat/overlay.py
@@ -0,0 +1,37 @@
+"""
+Expose zipp.Path as .zipfile.Path.
+
+Includes everything else in ``zipfile`` to match future usage. Just
+use:
+
+>>> from zipp.compat.overlay import zipfile
+
+in place of ``import zipfile``.
+
+Relative imports are supported too.
+
+>>> from zipp.compat.overlay.zipfile import ZipInfo
+
+The ``zipfile`` object added to ``sys.modules`` needs to be
+hashable (#126).
+
+>>> _ = hash(sys.modules['zipp.compat.overlay.zipfile'])
+"""
+
+import importlib
+import sys
+import types
+
+import zipp
+
+
+class HashableNamespace(types.SimpleNamespace):
+    def __hash__(self):
+        return hash(tuple(vars(self)))
+
+
+zipfile = HashableNamespace(**vars(importlib.import_module('zipfile')))
+zipfile.Path = zipp.Path
+zipfile._path = zipp
+
+sys.modules[__name__ + '.zipfile'] = zipfile  # type: ignore[assignment]
diff --git a/lib/zipp/compat/py310.py b/lib/zipp/compat/py310.py
index d5ca53e0..e1e7ec22 100644
--- a/lib/zipp/compat/py310.py
+++ b/lib/zipp/compat/py310.py
@@ -1,5 +1,5 @@
-import sys
 import io
+import sys
 
 
 def _text_encoding(encoding, stacklevel=2, /):  # pragma: no cover
@@ -7,5 +7,7 @@ def _text_encoding(encoding, stacklevel=2, /):  # pragma: no cover
 
 
 text_encoding = (
-    io.text_encoding if sys.version_info > (3, 10) else _text_encoding  # type: ignore
+    io.text_encoding  # type: ignore[unused-ignore, attr-defined]
+    if sys.version_info > (3, 10)
+    else _text_encoding
 )
diff --git a/lib/zipp/glob.py b/lib/zipp/glob.py
index 69c41d77..4ed74cc4 100644
--- a/lib/zipp/glob.py
+++ b/lib/zipp/glob.py
@@ -1,7 +1,6 @@
 import os
 import re
 
-
 _default_seps = os.sep + str(os.altsep) * bool(os.altsep)
 
 
@@ -28,7 +27,7 @@ class Translator:
         """
         Given a glob pattern, produce a regex that matches it.
         """
-        return self.extend(self.translate_core(pattern))
+        return self.extend(self.match_dirs(self.translate_core(pattern)))
 
     def extend(self, pattern):
         r"""
@@ -41,6 +40,14 @@ class Translator:
         """
         return rf'(?s:{pattern})\Z'
 
+    def match_dirs(self, pattern):
+        """
+        Ensure that zipfile.Path directory names are matched.
+
+        zipfile.Path directory names always end in a slash.
+        """
+        return rf'{pattern}[/]?'
+
     def translate_core(self, pattern):
         r"""
         Given a glob pattern, produce a regex that matches it.
diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index 9ac6fba1..59ea02bf 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -1,7 +1,7 @@
 apscheduler==3.10.1
 cryptography==43.0.0
 importlib-metadata==8.2.0
-importlib-resources==6.4.0
+importlib-resources==6.4.5
 pyinstaller==6.8.0
 pyopenssl==24.2.1
 
diff --git a/requirements.txt b/requirements.txt
index 373b82d0..384f0a59 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -17,7 +17,7 @@ html5lib==1.1
 httpagentparser==1.9.5
 idna==3.7
 importlib-metadata==8.2.0
-importlib-resources==6.4.0
+importlib-resources==6.4.5
 git+https://github.com/Tautulli/ipwhois.git@master#egg=ipwhois
 IPy==1.01
 Mako==1.3.5

From e69852fa0e3c8d0d34dc982f712069ac4360ecbf Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 16 Nov 2024 14:48:53 -0800
Subject: [PATCH 667/743] Bump importlib-metadata from 8.2.0 to 8.5.0 (#2397)

* Bump importlib-metadata from 8.2.0 to 8.5.0

Bumps [importlib-metadata](https://github.com/python/importlib_metadata) from 8.2.0 to 8.5.0.
- [Release notes](https://github.com/python/importlib_metadata/releases)
- [Changelog](https://github.com/python/importlib_metadata/blob/main/NEWS.rst)
- [Commits](https://github.com/python/importlib_metadata/compare/v8.2.0...v8.5.0)

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

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

* Update importlib-metadata==8.5.0

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/importlib_metadata/__init__.py   | 94 +++++++++++++++++++---------
 lib/importlib_metadata/_adapters.py  |  2 +-
 lib/importlib_metadata/_compat.py    |  3 +-
 lib/importlib_metadata/_functools.py |  2 +-
 lib/importlib_metadata/_meta.py      | 14 ++++-
 package/requirements-package.txt     |  2 +-
 requirements.txt                     |  2 +-
 7 files changed, 82 insertions(+), 37 deletions(-)

diff --git a/lib/importlib_metadata/__init__.py b/lib/importlib_metadata/__init__.py
index 2c71d33c..46a14e64 100644
--- a/lib/importlib_metadata/__init__.py
+++ b/lib/importlib_metadata/__init__.py
@@ -1,24 +1,34 @@
+"""
+APIs exposing metadata from third-party Python packages.
+
+This codebase is shared between importlib.metadata in the stdlib
+and importlib_metadata in PyPI. See
+https://github.com/python/importlib_metadata/wiki/Development-Methodology
+for more detail.
+"""
+
 from __future__ import annotations
 
-import os
-import re
 import abc
-import sys
-import json
-import zipp
+import collections
 import email
-import types
-import inspect
-import pathlib
-import operator
-import textwrap
 import functools
 import itertools
+import operator
+import os
+import pathlib
 import posixpath
-import collections
+import re
+import sys
+import textwrap
+import types
+from contextlib import suppress
+from importlib import import_module
+from importlib.abc import MetaPathFinder
+from itertools import starmap
+from typing import Any, Iterable, List, Mapping, Match, Optional, Set, cast
 
 from . import _meta
-from .compat import py39, py311
 from ._collections import FreezableDefaultDict, Pair
 from ._compat import (
     NullFinder,
@@ -27,12 +37,7 @@ from ._compat import (
 from ._functools import method_cache, pass_none
 from ._itertools import always_iterable, bucket, unique_everseen
 from ._meta import PackageMetadata, SimplePath
-
-from contextlib import suppress
-from importlib import import_module
-from importlib.abc import MetaPathFinder
-from itertools import starmap
-from typing import Any, Iterable, List, Mapping, Match, Optional, Set, cast
+from .compat import py39, py311
 
 __all__ = [
     'Distribution',
@@ -58,7 +63,7 @@ class PackageNotFoundError(ModuleNotFoundError):
         return f"No package metadata was found for {self.name}"
 
     @property
-    def name(self) -> str:  # type: ignore[override]
+    def name(self) -> str:  # type: ignore[override] # make readonly
         (name,) = self.args
         return name
 
@@ -227,9 +232,26 @@ class EntryPoint:
         >>> ep.matches(attr='bong')
         True
         """
+        self._disallow_dist(params)
         attrs = (getattr(self, param) for param in params)
         return all(map(operator.eq, params.values(), attrs))
 
+    @staticmethod
+    def _disallow_dist(params):
+        """
+        Querying by dist is not allowed (dist objects are not comparable).
+        >>> EntryPoint(name='fan', value='fav', group='fag').matches(dist='foo')
+        Traceback (most recent call last):
+        ...
+        ValueError: "dist" is not suitable for matching...
+        """
+        if "dist" in params:
+            raise ValueError(
+                '"dist" is not suitable for matching. '
+                "Instead, use Distribution.entry_points.select() on a "
+                "located distribution."
+            )
+
     def _key(self):
         return self.name, self.value, self.group
 
@@ -259,7 +281,7 @@ class EntryPoints(tuple):
 
     __slots__ = ()
 
-    def __getitem__(self, name: str) -> EntryPoint:  # type: ignore[override]
+    def __getitem__(self, name: str) -> EntryPoint:  # type: ignore[override] # Work with str instead of int
         """
         Get the EntryPoint in self matching name.
         """
@@ -315,7 +337,7 @@ class PackagePath(pathlib.PurePosixPath):
     size: int
     dist: Distribution
 
-    def read_text(self, encoding: str = 'utf-8') -> str:  # type: ignore[override]
+    def read_text(self, encoding: str = 'utf-8') -> str:
         return self.locate().read_text(encoding=encoding)
 
     def read_binary(self) -> bytes:
@@ -373,6 +395,17 @@ class Distribution(metaclass=abc.ABCMeta):
         """
         Given a path to a file in this distribution, return a SimplePath
         to it.
+
+        This method is used by callers of ``Distribution.files()`` to
+        locate files within the distribution. If it's possible for a
+        Distribution to represent files in the distribution as
+        ``SimplePath`` objects, it should implement this method
+        to resolve such objects.
+
+        Some Distribution providers may elect not to resolve SimplePath
+        objects within the distribution by raising a
+        NotImplementedError, but consumers of such a Distribution would
+        be unable to invoke ``Distribution.files()``.
         """
 
     @classmethod
@@ -639,6 +672,9 @@ class Distribution(metaclass=abc.ABCMeta):
         return self._load_json('direct_url.json')
 
     def _load_json(self, filename):
+        # Deferred for performance (python/importlib_metadata#503)
+        import json
+
         return pass_none(json.loads)(
             self.read_text(filename),
             object_hook=lambda data: types.SimpleNamespace(**data),
@@ -723,7 +759,7 @@ class FastPath:
     True
     """
 
-    @functools.lru_cache()  # type: ignore
+    @functools.lru_cache()  # type: ignore[misc]
     def __new__(cls, root):
         return super().__new__(cls)
 
@@ -741,7 +777,10 @@ class FastPath:
         return []
 
     def zip_children(self):
-        zip_path = zipp.Path(self.root)
+        # deferred for performance (python/importlib_metadata#502)
+        from zipp.compat.overlay import zipfile
+
+        zip_path = zipfile.Path(self.root)
         names = zip_path.root.namelist()
         self.joinpath = zip_path.joinpath
 
@@ -1078,11 +1117,10 @@ def _get_toplevel_name(name: PackagePath) -> str:
     >>> _get_toplevel_name(PackagePath('foo.dist-info'))
     'foo.dist-info'
     """
-    return _topmost(name) or (
-        # python/typeshed#10328
-        inspect.getmodulename(name)  # type: ignore
-        or str(name)
-    )
+    # Defer import of inspect for performance (python/cpython#118761)
+    import inspect
+
+    return _topmost(name) or inspect.getmodulename(name) or str(name)
 
 
 def _top_level_inferred(dist):
diff --git a/lib/importlib_metadata/_adapters.py b/lib/importlib_metadata/_adapters.py
index 6223263e..3b516a2d 100644
--- a/lib/importlib_metadata/_adapters.py
+++ b/lib/importlib_metadata/_adapters.py
@@ -1,6 +1,6 @@
+import email.message
 import re
 import textwrap
-import email.message
 
 from ._text import FoldedCase
 
diff --git a/lib/importlib_metadata/_compat.py b/lib/importlib_metadata/_compat.py
index df312b1c..01356d69 100644
--- a/lib/importlib_metadata/_compat.py
+++ b/lib/importlib_metadata/_compat.py
@@ -1,6 +1,5 @@
-import sys
 import platform
-
+import sys
 
 __all__ = ['install', 'NullFinder']
 
diff --git a/lib/importlib_metadata/_functools.py b/lib/importlib_metadata/_functools.py
index 71f66bd0..5dda6a21 100644
--- a/lib/importlib_metadata/_functools.py
+++ b/lib/importlib_metadata/_functools.py
@@ -1,5 +1,5 @@
-import types
 import functools
+import types
 
 
 # from jaraco.functools 3.3
diff --git a/lib/importlib_metadata/_meta.py b/lib/importlib_metadata/_meta.py
index 1927d0f6..0942bbd9 100644
--- a/lib/importlib_metadata/_meta.py
+++ b/lib/importlib_metadata/_meta.py
@@ -1,9 +1,17 @@
 from __future__ import annotations
 
 import os
-from typing import Protocol
-from typing import Any, Dict, Iterator, List, Optional, TypeVar, Union, overload
-
+from typing import (
+    Any,
+    Dict,
+    Iterator,
+    List,
+    Optional,
+    Protocol,
+    TypeVar,
+    Union,
+    overload,
+)
 
 _T = TypeVar("_T")
 
diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index 59ea02bf..7e3c7a1c 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -1,6 +1,6 @@
 apscheduler==3.10.1
 cryptography==43.0.0
-importlib-metadata==8.2.0
+importlib-metadata==8.5.0
 importlib-resources==6.4.5
 pyinstaller==6.8.0
 pyopenssl==24.2.1
diff --git a/requirements.txt b/requirements.txt
index 384f0a59..64daed44 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -16,7 +16,7 @@ gntp==1.0.3
 html5lib==1.1
 httpagentparser==1.9.5
 idna==3.7
-importlib-metadata==8.2.0
+importlib-metadata==8.5.0
 importlib-resources==6.4.5
 git+https://github.com/Tautulli/ipwhois.git@master#egg=ipwhois
 IPy==1.01

From 48b1c7b522408cfb858f5a0639043aa7a43113bc Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 16 Nov 2024 14:49:08 -0800
Subject: [PATCH 668/743] Bump pytz from 2024.1 to 2024.2 (#2398)

* Bump pytz from 2024.1 to 2024.2

Bumps [pytz](https://github.com/stub42/pytz) from 2024.1 to 2024.2.
- [Release notes](https://github.com/stub42/pytz/releases)
- [Commits](https://github.com/stub42/pytz/compare/release_2024.1...release_2024.2)

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

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

* Update pytz==2024.2

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/pytz/__init__.py                     |    5 +-
 lib/pytz/zoneinfo/Africa/Blantyre        |  Bin 149 -> 149 bytes
 lib/pytz/zoneinfo/Africa/Bujumbura       |  Bin 149 -> 149 bytes
 lib/pytz/zoneinfo/Africa/Gaborone        |  Bin 149 -> 149 bytes
 lib/pytz/zoneinfo/Africa/Harare          |  Bin 149 -> 149 bytes
 lib/pytz/zoneinfo/Africa/Kigali          |  Bin 149 -> 149 bytes
 lib/pytz/zoneinfo/Africa/Lubumbashi      |  Bin 149 -> 149 bytes
 lib/pytz/zoneinfo/Africa/Lusaka          |  Bin 149 -> 149 bytes
 lib/pytz/zoneinfo/Africa/Maputo          |  Bin 149 -> 149 bytes
 lib/pytz/zoneinfo/America/Bahia_Banderas |  Bin 1152 -> 1100 bytes
 lib/pytz/zoneinfo/America/Cancun         |  Bin 834 -> 864 bytes
 lib/pytz/zoneinfo/America/Chihuahua      |  Bin 1102 -> 1102 bytes
 lib/pytz/zoneinfo/America/Ciudad_Juarez  |  Bin 1538 -> 1538 bytes
 lib/pytz/zoneinfo/America/Ensenada       |  Bin 2374 -> 2458 bytes
 lib/pytz/zoneinfo/America/Hermosillo     |  Bin 456 -> 388 bytes
 lib/pytz/zoneinfo/America/Mazatlan       |  Bin 1128 -> 1060 bytes
 lib/pytz/zoneinfo/America/Merida         |  Bin 1004 -> 1004 bytes
 lib/pytz/zoneinfo/America/Mexico_City    |  Bin 1222 -> 1222 bytes
 lib/pytz/zoneinfo/America/Monterrey      |  Bin 980 -> 1114 bytes
 lib/pytz/zoneinfo/America/Ojinaga        |  Bin 1524 -> 1524 bytes
 lib/pytz/zoneinfo/America/Santa_Isabel   |  Bin 2374 -> 2458 bytes
 lib/pytz/zoneinfo/America/Tijuana        |  Bin 2374 -> 2458 bytes
 lib/pytz/zoneinfo/Asia/Choibalsan        |  Bin 935 -> 877 bytes
 lib/pytz/zoneinfo/Asia/Dili              |  Bin 213 -> 257 bytes
 lib/pytz/zoneinfo/Atlantic/Azores        |  Bin 3498 -> 3442 bytes
 lib/pytz/zoneinfo/Atlantic/Madeira       |  Bin 3503 -> 3377 bytes
 lib/pytz/zoneinfo/CET                    |  Bin 2094 -> 2933 bytes
 lib/pytz/zoneinfo/CST6CDT                |  Bin 2310 -> 3592 bytes
 lib/pytz/zoneinfo/EET                    |  Bin 1908 -> 2262 bytes
 lib/pytz/zoneinfo/EST                    |  Bin 114 -> 182 bytes
 lib/pytz/zoneinfo/EST5EDT                |  Bin 2310 -> 3552 bytes
 lib/pytz/zoneinfo/Europe/Lisbon          |  Bin 3497 -> 3527 bytes
 lib/pytz/zoneinfo/HST                    |  Bin 115 -> 329 bytes
 lib/pytz/zoneinfo/MET                    |  Bin 2094 -> 2933 bytes
 lib/pytz/zoneinfo/MST                    |  Bin 114 -> 360 bytes
 lib/pytz/zoneinfo/MST7MDT                |  Bin 2310 -> 2460 bytes
 lib/pytz/zoneinfo/Mexico/BajaNorte       |  Bin 2374 -> 2458 bytes
 lib/pytz/zoneinfo/Mexico/BajaSur         |  Bin 1128 -> 1060 bytes
 lib/pytz/zoneinfo/Mexico/General         |  Bin 1222 -> 1222 bytes
 lib/pytz/zoneinfo/PST8PDT                |  Bin 2310 -> 2852 bytes
 lib/pytz/zoneinfo/Portugal               |  Bin 3497 -> 3527 bytes
 lib/pytz/zoneinfo/WET                    |  Bin 1905 -> 3527 bytes
 lib/pytz/zoneinfo/leapseconds            |    8 +-
 lib/pytz/zoneinfo/tzdata.zi              | 1651 +++++++++++-----------
 lib/pytz/zoneinfo/zone.tab               |    3 +-
 lib/pytz/zoneinfo/zone1970.tab           |    3 +-
 lib/pytz/zoneinfo/zonenow.tab            |    8 +-
 requirements.txt                         |    2 +-
 48 files changed, 830 insertions(+), 850 deletions(-)

diff --git a/lib/pytz/__init__.py b/lib/pytz/__init__.py
index 2355f8b4..96409e2d 100644
--- a/lib/pytz/__init__.py
+++ b/lib/pytz/__init__.py
@@ -22,8 +22,8 @@ from pytz.tzfile import build_tzinfo
 
 
 # The IANA (nee Olson) database is updated several times a year.
-OLSON_VERSION = '2024a'
-VERSION = '2024.1'  # pip compatible version number.
+OLSON_VERSION = '2024b'
+VERSION = '2024.2'  # pip compatible version number.
 __version__ = VERSION
 
 OLSEN_VERSION = OLSON_VERSION  # Old releases had this misspelling
@@ -1340,7 +1340,6 @@ common_timezones = \
  'Asia/Bishkek',
  'Asia/Brunei',
  'Asia/Chita',
- 'Asia/Choibalsan',
  'Asia/Colombo',
  'Asia/Damascus',
  'Asia/Dhaka',
diff --git a/lib/pytz/zoneinfo/Africa/Blantyre b/lib/pytz/zoneinfo/Africa/Blantyre
index 52753c0f87bbfa457ada89d400908a3d6537ac0e..65f043f1d1833d26b5fe42a460f84b35d1dcba63 100644
GIT binary patch
delta 32
ecmbQrIF)gN4ri~^)iOo~2Dz?@rVdD)I&lD@?Fp>_

delta 32
ecmbQrIF)gN4ri0w(Jzb)401gaO&yRpb>aZ7J_>&T

diff --git a/lib/pytz/zoneinfo/Africa/Bujumbura b/lib/pytz/zoneinfo/Africa/Bujumbura
index 52753c0f87bbfa457ada89d400908a3d6537ac0e..65f043f1d1833d26b5fe42a460f84b35d1dcba63 100644
GIT binary patch
delta 32
ecmbQrIF)gN4ri~^)iOo~2Dz?@rVdD)I&lD@?Fp>_

delta 32
ecmbQrIF)gN4ri0w(Jzb)401gaO&yRpb>aZ7J_>&T

diff --git a/lib/pytz/zoneinfo/Africa/Gaborone b/lib/pytz/zoneinfo/Africa/Gaborone
index 52753c0f87bbfa457ada89d400908a3d6537ac0e..65f043f1d1833d26b5fe42a460f84b35d1dcba63 100644
GIT binary patch
delta 32
ecmbQrIF)gN4ri~^)iOo~2Dz?@rVdD)I&lD@?Fp>_

delta 32
ecmbQrIF)gN4ri0w(Jzb)401gaO&yRpb>aZ7J_>&T

diff --git a/lib/pytz/zoneinfo/Africa/Harare b/lib/pytz/zoneinfo/Africa/Harare
index 52753c0f87bbfa457ada89d400908a3d6537ac0e..65f043f1d1833d26b5fe42a460f84b35d1dcba63 100644
GIT binary patch
delta 32
ecmbQrIF)gN4ri~^)iOo~2Dz?@rVdD)I&lD@?Fp>_

delta 32
ecmbQrIF)gN4ri0w(Jzb)401gaO&yRpb>aZ7J_>&T

diff --git a/lib/pytz/zoneinfo/Africa/Kigali b/lib/pytz/zoneinfo/Africa/Kigali
index 52753c0f87bbfa457ada89d400908a3d6537ac0e..65f043f1d1833d26b5fe42a460f84b35d1dcba63 100644
GIT binary patch
delta 32
ecmbQrIF)gN4ri~^)iOo~2Dz?@rVdD)I&lD@?Fp>_

delta 32
ecmbQrIF)gN4ri0w(Jzb)401gaO&yRpb>aZ7J_>&T

diff --git a/lib/pytz/zoneinfo/Africa/Lubumbashi b/lib/pytz/zoneinfo/Africa/Lubumbashi
index 52753c0f87bbfa457ada89d400908a3d6537ac0e..65f043f1d1833d26b5fe42a460f84b35d1dcba63 100644
GIT binary patch
delta 32
ecmbQrIF)gN4ri~^)iOo~2Dz?@rVdD)I&lD@?Fp>_

delta 32
ecmbQrIF)gN4ri0w(Jzb)401gaO&yRpb>aZ7J_>&T

diff --git a/lib/pytz/zoneinfo/Africa/Lusaka b/lib/pytz/zoneinfo/Africa/Lusaka
index 52753c0f87bbfa457ada89d400908a3d6537ac0e..65f043f1d1833d26b5fe42a460f84b35d1dcba63 100644
GIT binary patch
delta 32
ecmbQrIF)gN4ri~^)iOo~2Dz?@rVdD)I&lD@?Fp>_

delta 32
ecmbQrIF)gN4ri0w(Jzb)401gaO&yRpb>aZ7J_>&T

diff --git a/lib/pytz/zoneinfo/Africa/Maputo b/lib/pytz/zoneinfo/Africa/Maputo
index 52753c0f87bbfa457ada89d400908a3d6537ac0e..65f043f1d1833d26b5fe42a460f84b35d1dcba63 100644
GIT binary patch
delta 32
ecmbQrIF)gN4ri~^)iOo~2Dz?@rVdD)I&lD@?Fp>_

delta 32
ecmbQrIF)gN4ri0w(Jzb)401gaO&yRpb>aZ7J_>&T

diff --git a/lib/pytz/zoneinfo/America/Bahia_Banderas b/lib/pytz/zoneinfo/America/Bahia_Banderas
index ae4a8a754617b8b918daffb6a45a067df2fd2fe6..3a493e3d5a93f08201c41cb25616015963254589 100644
GIT binary patch
delta 280
zcmZqRJi{?T+>o7tfdPa;z!r!>Y>}ngUKFhVs9mrvEi7TXqiw+s9<ziUf7?EsepQ$-
zG2s5>Pt0PISlA?4nQ*|#iY$sOJ2x;2OrFRnCgkiA!oa`?vH(U+5ckDu?|&cw*$tvW
q_Je4U8$dM39UvOy7BCHT4~Pc2X|plYc1F@%C4uQGF6ZD7GcEvc+)=Io

delta 374
zcmX@Z(ZD%D+>(QVfdPa;z#fP}Y>B1YUKFhVl=om;T3Et%=SvAYc+3)Z{B8Si`c+}V
zjfq=6FfbG}O!T;K&dS1!2eL8YfRkew6}kEw7zF<R-?@QNWO5^;m_$Hu2!pdr2m=En
z$R$7kr6-8TVs+wwAOJZNM1!0PqCw6D(I6*-XppnPG|=fF8svNs4e<iVl7fcKyiD5}
Rspt_oTpr<a4h}Kn0sv2zWo7^X

diff --git a/lib/pytz/zoneinfo/America/Cancun b/lib/pytz/zoneinfo/America/Cancun
index e7acbff18a2469c79f4ce77064adeb189d60bf10..0f7771e851b0e4242bcc65a9b838b8a1675541fb 100644
GIT binary patch
delta 407
zcmX@a_JD1IxFH7v0|N+yfHn|=*dj}}-AWMadd478e&&K<dKrUJF-L*1djx|?(5r%p
zE)(mSSeRLunOK1Y0m$_K|GE_n4FCVHUckWe|NqVn3>+Ymkq0Jn`~af>OavtB;~T=@
z92~;n3dGJXKpKb{7(tE$0w^6akx|SStGoXL0m$tj#US^C0LTv@8srZU0Qm((gZu*m
VAU|zh#;C|Rz`o*Q1^U^P3ji|ZWQYI&

delta 385
zcmaFBc8G0)xGp;b0|N+yfEEyg*dj}}-AWK^yP9B_p8mn8=vRWVyXOa!pgRc@Jto#O
zGl3v03n9q-|Npub3=IGOuU^2w^8f$w1B@L1|L@$uzylN6xq(ptBI4s4!r&Yn!r<xx
z#6a2^NHZ{kTm+*+qB7Hr!2F3^yslW?{2vHF?gps>xgA7<+z+BbegM%Re}HI^UpDV%
QRAj6k5Z`bCJ!#4X0AcZ9e*gdg

diff --git a/lib/pytz/zoneinfo/America/Chihuahua b/lib/pytz/zoneinfo/America/Chihuahua
index e0910396704ffda1d7f39e70a369249aeb4b0353..667a2191145170e34271bb2200b93a2eec41d2ba 100644
GIT binary patch
delta 47
ucmX@dagJkxA@@h^f^BJG3ELfQ3pU!UWE2MS{{sO?3`B#(H~(M^V*&sm=@=yd

delta 47
ucmX@dagJkxA@`@e2iwxZ61F>EO4w+#l2I7Q{|^KpF%S(B-~59yj0pf=(Hffo

diff --git a/lib/pytz/zoneinfo/America/Ciudad_Juarez b/lib/pytz/zoneinfo/America/Ciudad_Juarez
index eb1e53961c1ebe1e147dd42248753ad30817a349..29af5982ac1c04357634570f15454d6f7fc30e04 100644
GIT binary patch
delta 47
tcmZqTY2uk+$o)~fU|U*P!gfd7f{ivdOu|6^e;@#ffoPEU=5D5PW&rvh7T*8>

delta 47
tcmZqTY2uk+$o(nr!M3!pgze6k5;oe{FbM<s|A7D`2BJaYo4c9HnE^Q#8C3uP

diff --git a/lib/pytz/zoneinfo/America/Ensenada b/lib/pytz/zoneinfo/America/Ensenada
index 63dfdf48a68d02240737ecd6af081e02eb0b6317..0fe73912cacab6c8aabef4f4264d1710825888e7 100644
GIT binary patch
delta 180
zcmX>mG)s7bvhQpL1_llwmRP#&MZwBS|AO@&EgQC_r4($J7GT)H_36XuSG^6Fl)n^Q
zn!E19b?Hck8xyyDxXr-MaQi^<hdcK+FSxsM&4hdVrY^YO**9Th#9pS!2^?&buW>|7
z&Sh3+oIQCWvn(^v#K{|(b(w)COn%5Lq65<Y9|%B3fM}30AR1&8hz1!4qCrM({>c24
I1!`si0In-yJOBUy

delta 115
zcmbOwd`xJ9vguR?1_llwmRP#&MZwBS|AO_OYCddBODWhcEx@pY>(htRuX-CUDSs)r
zG;>$Mb?Hck8xyyD*jTWaX|fh)#N=*fWyYzK*E7p919eS4&#Ws9RP`SSKq^5rNcCoW
KmZvO0<plu35;v*<

diff --git a/lib/pytz/zoneinfo/America/Hermosillo b/lib/pytz/zoneinfo/America/Hermosillo
index 86bd1a20a3fca3908723ffbe0201d3b162474066..441fe3f2dd133fd081247131d860bac327107499 100644
GIT binary patch
delta 187
zcmX@X+`>FT+>n)lfdPa;fES2CY=NcQUKFhVs9mrvEi7TXqiw+s9<ziUf7?EsepQ$-
zF+hG|p^CVVZwP~La0r7l5c|4>FfcHJOkkXNK*|)Wk^g}JWGsjV84aRA#)D{(6_fcH
WB_^9Qngh*Nz+pDfd@i7s=3D@&tvSm8

literal 456
zcmWHE%1kq2zyRz(5fBCeejo<1MV4-RQLz3~-h*vvVF}xvFD2~YF-zF-x9!8}SA_{T
zCT{t_z);X&nBF2_R4mqD?4BlI67-|NRNX_s%;;7FBNGcV3lj?~kOaa1|EK?8VEF%k
z?gR!Pd-Vba4iL%60~6_QU=V<?eSAY0e1k(6oPpTaC4?aWNHZ{k+y$dTNbtgcAOLv-
zM1#BnqCwsP(I78@XppzSG|+1x8st3?4e=t#-hu`Y3Gyn426-1mgS-r)LEZ+@Ag_aH
M8hf7$7&_)$0Qr5DMgRZ+

diff --git a/lib/pytz/zoneinfo/America/Mazatlan b/lib/pytz/zoneinfo/America/Mazatlan
index 06fa22749d0a3157b5a693f0797086f78e1201c5..386616a59cdb2a21f1f24a6c72526bce0360cd24 100644
GIT binary patch
delta 199
zcmaFCv4mrSxFIV80|N+yfGrS%*aAzpy(n1!QM+JUT3Et%N85rOJZ1?y{<eKM{i-lw
zV!-{$kC;s+r!p#t`}l@1_y&hCI0Lb-O9%r4Bgh!W$r~7@OtBjL9|%B(gJ_TiAR1%|
ehz40S`9Gt?W_70Rj4&${a99Dfh6`x3ITrwuP(SDZ

delta 235
zcmZ3&@q%N5xFtIS0|N+yfISd{*dj}}y(n1!Deu9yw6KKj&X*E)@R%j+_}lj3^sB;z
z8xyyDU|=X{nCNkzk#+J$X4A>hj0$Z3|MxdA2u%LREG85X9KyiB2r>^wO%ON5YR!Kj
w09gg1LDqq2kd+`BWbNdKj1mGM4#ZB7fdvhle==@o#A>qyrp;Ww!6D{c0Ki95D*ylh

diff --git a/lib/pytz/zoneinfo/America/Merida b/lib/pytz/zoneinfo/America/Merida
index 17654cb59991e52537f87d9d9a2b56396f9c5c7e..c4b9b4e8801cd9447d3bbb6ebff71e26df669c3c 100644
GIT binary patch
delta 35
lcmaFE{)T;mA$!*|1__m01sg4z7`cIL5CHKvA7xZ$0s!a83$y?L

delta 35
mcmaFE{)T;mA$!}^1PLGSfQ=SSjNCvr0}z1tn~yT8GXVhP3=2E}

diff --git a/lib/pytz/zoneinfo/America/Mexico_City b/lib/pytz/zoneinfo/America/Mexico_City
index 68176daa4976b015fb79026f3053e74e4a7457ab..ad70cf3e08498845aaafc38e4eccca7461c8d337 100644
GIT binary patch
delta 47
ucmX@cd5m*{A@@h^f^BJG3ELfQ3pUzZWfTVT{{sO?3`B#(H>)r$VgdjlQWv}c

delta 47
ucmX@cd5m*{A@`@e2iwxZ61F>EO4w*~l~EYT{|^KpF%S(B->ky4hzS5+IvO$n

diff --git a/lib/pytz/zoneinfo/America/Monterrey b/lib/pytz/zoneinfo/America/Monterrey
index 5eb723c80949d0cf2a99603ea6aba4688ade6b21..2d7993a0d71720493175bd05b2b0b7409d67407a 100644
GIT binary patch
delta 414
zcmcb@ev4y*xGp;b0|N+yfE^Hn*dj}}-AY*hQM+JUT3Et%N85rOJZ1?y{<eLXXz-|>
zg_(tkl}z~m|H3Z}4FCVnoxs5I|NrU*3>+Ymkq0KSa|5FQMBK+WguypBguxkzeO-Vw
z5Hm0W-Np&TAew<;g19SI$NvWckOx3C$P*wM<Pi`J@(hRuc?e7cJ+*ly;~~a@_7*?f
LTU<adn{fdE%}jMy

delta 278
zcmcb`afN+?xFib$0|N+yfF%%v*gQ+O-Ab6~@+g^^i7fd4|H3Z}4FCVHUckWe|NqVn
zj2sZQk8cQrb1)FQgfK8L0xbgK3F5L?o$wzBK+f3A#dL@<lPqU2F_YpDE}+ZIxB&4<
BGx-1j

diff --git a/lib/pytz/zoneinfo/America/Ojinaga b/lib/pytz/zoneinfo/America/Ojinaga
index f97946d1e269bf9c83fd4a02591b7ef04e8eb6a8..45118a4f4b73e55879aaa81a8536e7214538f0e8 100644
GIT binary patch
delta 47
tcmeyu{e^piA@@h^f^BJG3ELfQ3pU!AGYJFv|A7D`2BJaYo7<T3m;oXm7p?#R

delta 47
ucmeyu{e^piA@`@e2iwxZ61F>EO4w*)&Lj-v{|5q)7>EXmZ*F7CV+H_W2O1;*

diff --git a/lib/pytz/zoneinfo/America/Santa_Isabel b/lib/pytz/zoneinfo/America/Santa_Isabel
index 63dfdf48a68d02240737ecd6af081e02eb0b6317..0fe73912cacab6c8aabef4f4264d1710825888e7 100644
GIT binary patch
delta 180
zcmX>mG)s7bvhQpL1_llwmRP#&MZwBS|AO@&EgQC_r4($J7GT)H_36XuSG^6Fl)n^Q
zn!E19b?Hck8xyyDxXr-MaQi^<hdcK+FSxsM&4hdVrY^YO**9Th#9pS!2^?&buW>|7
z&Sh3+oIQCWvn(^v#K{|(b(w)COn%5Lq65<Y9|%B3fM}30AR1&8hz1!4qCrM({>c24
I1!`si0In-yJOBUy

delta 115
zcmbOwd`xJ9vguR?1_llwmRP#&MZwBS|AO_OYCddBODWhcEx@pY>(htRuX-CUDSs)r
zG;>$Mb?Hck8xyyD*jTWaX|fh)#N=*fWyYzK*E7p919eS4&#Ws9RP`SSKq^5rNcCoW
KmZvO0<plu35;v*<

diff --git a/lib/pytz/zoneinfo/America/Tijuana b/lib/pytz/zoneinfo/America/Tijuana
index 63dfdf48a68d02240737ecd6af081e02eb0b6317..0fe73912cacab6c8aabef4f4264d1710825888e7 100644
GIT binary patch
delta 180
zcmX>mG)s7bvhQpL1_llwmRP#&MZwBS|AO@&EgQC_r4($J7GT)H_36XuSG^6Fl)n^Q
zn!E19b?Hck8xyyDxXr-MaQi^<hdcK+FSxsM&4hdVrY^YO**9Th#9pS!2^?&buW>|7
z&Sh3+oIQCWvn(^v#K{|(b(w)COn%5Lq65<Y9|%B3fM}30AR1&8hz1!4qCrM({>c24
I1!`si0In-yJOBUy

delta 115
zcmbOwd`xJ9vguR?1_llwmRP#&MZwBS|AO_OYCddBODWhcEx@pY>(htRuX-CUDSs)r
zG;>$Mb?Hck8xyyD*jTWaX|fh)#N=*fWyYzK*E7p919eS4&#Ws9RP`SSKq^5rNcCoW
KmZvO0<plu35;v*<

diff --git a/lib/pytz/zoneinfo/Asia/Choibalsan b/lib/pytz/zoneinfo/Asia/Choibalsan
index c5f4bb0b3858f7078b35cb7a63021d7dc0262605..2aa5cc4b84d369b03684c30cdb66b7abf087f467 100644
GIT binary patch
literal 877
zcmcK2yDvjw9Eb6@R3a`>5(%oUOI@oJb#LoFX$MjyE(2*KV(<=~5P1hNA!jgDV>m-M
zHiE%uFxXrMF)~=>B-kXJr+<LN;FXil(8Tb4e$kobr8e>F<7cb+*|u-r!UefcTFL9R
zDt-Ji%5Eace(96t$1TcnSR|c0h03-5AuCqiRpso1tQxyl)qNMz?KxL9_N1)MJy3Pl
zGo$X~Ow>OojE1{}XuMi8Jf~}-DK%$!_vb|OR>)|HhlDRyVYJTAsJ2K@wg&^s?{&!z
zhf{UtTV(I+iQad5tOZg>dT@VF3vKP{{c))c#8&me=!7;jGOiE%{o07TT_1If+a`;X
z`c&3}oci3*r(cGpB{SoXe?r9kY_up@VpFqZ3n7)r3rC{D<LffN9`oxK(Lb#DZ9W#|
z|FSBwEV3@LFtReTG_p3bII=pjJhDDg0I7hKKx!aGkSb}-GCb-ag?Lm#O7W<L6ys41
zDaWH8QV^+#ltgMGMUkpVS)?vf7^#euMrtF)k?Kf!q&{*1$Q2-$fLudb^CIwnuOcU4
K-bTpVo$~|H*}FLa

literal 935
zcmc)Iy-yQi0LSsCa6|)5C<YU-mN$9R(sz)T@}^hAV9Qhsk&rx)hQ!q28Q3Iv12GXh
z+|bFW=}-a^M@B{y8Q63p4mSXX1ug++c)t7rMknub`CQuJlIQ!&K7X+k7k|7G`rjM+
zX?*kjS8sjYPrK=4&uTt6b?)p>DF1GUy!)kH1wI(ErC6<6UmeS~!jWp9+mjtnzo~o4
zZP^+8th)R~*<JTe^%z@D&&8(Od${i0|MAv+@b#q=+$p$ym1!qb%DCaRs1sR^xY7JA
zCpMo}@k~S}#=@#U)F1}}KK0OhE=Nu_?BvcTYqavw9xGYa_}XiGVtLV;%rDrFvMK9v
z%Cyb?ZY$N<Wj_g+V(M($eRlhOIajlwa=%x~Ge@TKR2kKOe^=G$TZqCe2eqh#A%wET
zO(9lo;T57-_V{@B=y!fkXR;y~9n{Z|euhOb78TilIOt1#aoBu~14j-WIe6sokpM^p
zBm@!z34%mH!XR;wKu9Dc6cP&wcCC(vghS#X0g;GENF*i_6p4z2MdBiXk;q7BBsLNp
yiH?Lv;v)k<Mt}?f83Qs1WE99SkZ~Xb;bJ7nP>``)s|SPsWi+*;dP3u&q1r1)fy&_k

diff --git a/lib/pytz/zoneinfo/Asia/Dili b/lib/pytz/zoneinfo/Asia/Dili
index c1af113af0a87e5c96033c83f199161062073bf0..4614e4fc4353a7094ba5173a0bd09158ef49d9a9 100644
GIT binary patch
literal 257
zcmWHE%1kq2zyPd35fBCe79a+(c_uxRV>mt2=mYmFg96LLGZ`3}n3)(DO80;i6*Pd<
z)lFdFKxX^+hA?OwSOBpl0|O&S9f$}a!Os6c0J0ZEgX{*G0kR)NQ{o0L8=#x)bS=36
D@gXX2

literal 213
zcmWHE%1kq2zzbM_vdlotGwGSck<&AcK5)M>D6l*{lYx<mk%@t!bPq^(K?4I&UEKr*
s4j<nT25kciAhu)(A;I+jKmf7<M1yPrnF_KAL=$HlmkrQPJ6%gI0JM@Pw*UYD

diff --git a/lib/pytz/zoneinfo/Atlantic/Azores b/lib/pytz/zoneinfo/Atlantic/Azores
index 10232ab38ec595b889167a3f0f037a940ef2ac98..dd2c235bf9c4cc3c2ec4c2725a7cd5deac128fea 100644
GIT binary patch
delta 1093
zcmds#O-K}B7{}k)k5O~Ro<lk7=We^LYr1_%k(Y!hJSj=I5K-a5@KSV$j*D9nh~(kf
zrkmPMWtYJU+Kzr<bda#i5@@Gjv86*{Nst%c-v6ZOA?VVn_u-k}^FD`RnE%hM`&P?V
zYPS#qjkBa0bHh#bxcAX@M!SZ2bff5uja$z6LXIB{c13b-ft<cU=i!LXk52iW$Jg%i
zM65mXq-T~~y^`HhI(ucn=l_x|e9o*Fd*>|wB3o-S94bENnu5c%ud-Y>HBI%C&!}N6
zM~x#);q)zvT)j^FF7{KjJ4LY*owPrBoZ|HfYBEBU2%hG|_ha0=66XW&s=4KL8Mk&+
zMOt6};AD87k`tf!;QjY}=*}BHd}E4_Tz<-JmzMJvd}lPX%;(=OyUhrjdLS71-D;Dt
zPa1(txxQHyyLOgQx%2jKXDLgoLP)vNECP158ER2KUT7p`@q;j={JJX2w>H1#D$@2~
zBWmn!GaBzriF2JPZ=r1;@2=h>)Jip5d;gfSeKgo~-g2Zm2p2@aAVLNaG>EW41P&r}
z5W#~8AA|rNOKJN>@U5~Se_LPHGT6Zdd>MT3sGI=d1qe4l_yNKZ5T1Z=1%xjkoB`nt
z2zNmE1HvItd34qrAQKi43WQW1l~^F;0wEX($v}waQOO2ExO{)bg6}^zEBbe{>>)Gu
E6C5lIwEzGB

delta 1090
zcmdtgKWGzC0LSsWw3p_RJ3Vb<+BB^%O`9~;LGaJyqSUEE5wi$_AnMX03LS;(;36&c
z)f>|`Pp!*UMW|yzK{}L*OK=beg`h&AV6_EZyx#W;oz%_6JMKO&nL>WwZ&|-nW-7L(
zX*^sX!iRJFc=)>a*;mz}JF@z#p=M@HIlEGmbMBO^`E^HKx*_jR#^r-kTk_%c2{~UV
zJCBB6IDR}O{mq5xk!vx1Xu7`c+SRhNXCmwDy?sVHV<+UkD<!$VQdF&jrffTwQ0c-?
zb)a=kWt!fr%=g!-y|MbNqyAK7U)5CS(yGWkUJ_k1Pek|RoH%&vt`MW+B7gCw=s9~?
z6i%KOy@v-yU+%alT18PZ&Z*MYY1RMfs4BnhRRhauLmhhlLoW8muIhT++eqcTBUaLG
zX*Qa7A1`l}UBhfi{Pj+ztbcU}!58nPmG2IM#z)Nx|9DMzf?(sTme_gojn?L+?4DdD
zI_q2-&(25Qx-K*6-%jcE8N~~x48n^Akrk08ku{M;kyVjpk#&)Uk(DDi7rc4nO*r-9
zSp1#t@<SLL866oO86OD%i2w-!i2(@$i2?~DGK>QW1c?L*1;bce!GU6sYLIe}dXR#U
uijb0!nvkN9s*tjfx+25EkjjwKa9}x^jt)_AUFJ&cKPax_kHvYzc3~R@ehRbz

diff --git a/lib/pytz/zoneinfo/Atlantic/Madeira b/lib/pytz/zoneinfo/Atlantic/Madeira
index 7ddcd883fedcb493b7ab527483c7d4a6d4fc5055..6725a0ffc1f7cfc6cad54361ca91500e087e2b64 100644
GIT binary patch
delta 588
zcmc(bze_?<6vxl|<u82UkZ77ENKl0E92*)UjG&?*p|PzckoG7pH8dFXo_ADB`>{x%
z;?NQ_L_<r9B(w!WPJt1D1!ebZlz&3!aLxzLy~8=5Qm_&*BeQiP(nW=sXz8b{nVH*U
znXh{@n{%4ETZ<iTPkN4uH<Vx9Fbk<RJDz$oPm){gG&1HnTdYt~`((vt(pq1Wl}D@g
zJo?^<mwoOJ^1YUszfoWVwKNM{@3P=!i3ZQ}6v|pOw7)}Dx15u7yR7t*mz81NrfTY6
ziOC4RQfw}V%i;V<9#&IvqCSu0>2zLN<Q9t)^>-)!-`<<dFC=J2)VN_#)QAbjXeFKy
zwai<p*G`i7D@kTVs&hk&PK&cUB5*p0^Fb&8p#g*n5IR680ilKGHLu)E@(b-wIH~U0
s9;79_!3=hVoi2qT5SBog0$~e;F$An3U=Go>*LF-O|87qvi67|UZ*DNObN~PV

delta 719
zcmchUPbfq|9LHzuTNdxF!Sm;NyV%x2%E>_v4w6!ogDu&Ml3bLNn`DX;4zuRCZ|(Yb
z*+g>1MGg*J<e=0Z6iSLXh*<NTgSa^QP4oNApTjht?{3|WE26zQLWrein5(vY<B4S7
zG*5nB2+w=xsgnd>ndLm4JtmovQNFtP%GbJX`TFDx--x<ob6}Tb{U1F0l1faB7tqec
z`9r^zbV+d0BxUpMoJ}?J@-c^3#A-!l_dB=S-b7XOUQ}0Ji5lOjsChmVwbut3=R70o
zjuOJ%KVYG)Z5H;@tbR$by*rwsv``9PL^89)Dl+`W_mtFZP^YEAl0fl~A*nGenPJPg
z(bSU9KRptYkRYQ>cUygv5a)MSx3<ig)sev%8S07YOR9@ds&_<#QW2#&>GQY7m7TmQ
z7y@AlgeefVKo|pI4TL!m_COc}VNvrXB^Uf>O66X>@RH8raR^00Dhgsj$OR!7gk%t+
xLC6Ln9E5Zb;x(0g5CMP)0Yng>3d3PoAQ2F$fI6AEK!@-Dk_r8lj4ZbrzW_J3(gXki

diff --git a/lib/pytz/zoneinfo/CET b/lib/pytz/zoneinfo/CET
index 122e934210cabf0b29a2dd7d11eb8220ed1cad43..40d7124e5346af056c75e2f7012a51d94e8154b7 100644
GIT binary patch
delta 1334
zcmbu;O-NKh0KoBizFl2Es8^JdMNEkZQ6{1gU9!xBxs{NV6j=~N5XIslDyX$nNtd+^
z5<ECrw%LcJrmfkReYrtdsaSLg3Nkv>6a?M2`M+fetb^#x&i>~;X5VFhuhaRJ9m-jf
zDTH7#qGqwrZZKcX>nj^tvho8>Me~BK!@rBv?sk3t_&}hoaIU^^)UPj=p3v=ed4Ws$
zr8-j3qAxGAbVu4T-SMp?aAjhbzWTOWUmIGhuRo9I&PblVp*9C@p7iRj#{IfG;8#8M
z-Rf3#q3W&NF8hicb-VbGiq8J2qVZ3v|NEG_Gk#hQy!#>V#y-}{d(lyOzqL_4XzrB{
zTNcW}!{_9qeW&E(+9UGGnw9G5svYv#>OnbFJFbS_r>oe81@gs2mGiPACp6qv?z}ov
z;=Dds7kX2l?Tl<H3yn6FIb&6MU3<P-!4z+b?Xf++)U+v2&L?Ji#!P2$x(^V-lWYDb
zhDV55j_?VwNLpEw_tu=`nZ(JzXZ#y$#I}Np8d2`9E#|7ie3@Zc=3|EYOZVCe<&>I7
z3l^i_EcUr^Gq(19_)HIci3y4wil6Wbd$|jU8z7=UqF|zcqM)L{qTr$cqadR|b8E0s
zz){dq;8F0I1mg(g1_~(>DH<svDJm&4DLN@aDM~3)-5RYFu@towxzy-2-5ZZ1m>Vdj
zNTz6}h^DBf$foF~2&X8gNOx<rQ^bdN+WAY3a;}k1(M}OhjryLm_J|!!u~Ti2*W*o3
z^G$hjJ~1;gXE=k?en8T_(Qn+FVcZ-22BVSfOx|1blV=hqlV^%W7W~)o3jFU4_~#W6
JR@m_^{sVNL<_!P<

delta 507
zcmew=woYJzxDNvmuz(04=m266n{zggc*5+fw?53dxo*PTC0i%V+c{yv{FdnxPH+}Z
zIP=_F;Ot8A3Fj6$3!I;1B5<KeRp4Tgn7}1Jht0~2uNdnYn3x9=YQrpNVBiyAU}a#C
zQD6l62||KIoLz%M7@S>0fP#|^SR`eEG-e3=2LeziOs-?mVF7u2G9R0&5YVe236OU|
RG|0=LY?qjal$XP~<p9<8L%IL}

diff --git a/lib/pytz/zoneinfo/CST6CDT b/lib/pytz/zoneinfo/CST6CDT
index ca67929fbeb05083c63e8319dd9ebf65b3d75e4d..c6981a06b1d9c26f447518efe265a6454726eae7 100644
GIT binary patch
literal 3592
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

delta 527
zcmeB>X%m_tZotaGzyQJ^FcpYFY=L>pbQ<RG`dP4`jjv(htlI^rJN`9XQvOnKDUoyY
zVn$1*dPW9D1}0`8F)+{%yS4xSuU^2w^8f$N4U7z6k^@ZgK*XJ0LKvKbfjAt9142L^
sW`qzE#6__N!{iWF6=9Iy{{sQY|6m#z2G$&fECU?|UepVN$!~aN05(rj<p2Nx

diff --git a/lib/pytz/zoneinfo/EET b/lib/pytz/zoneinfo/EET
index cbdb71ddd38be8f4a23e57bdb4b86e52195e9f89..9f3a0678d766881389e129c93def7fffd74f14f1 100644
GIT binary patch
delta 877
zcmeyucTI4Dcs&;b0|N+yKo<~$*isEZVs?XK!_JzQ4|X0~f8pe(<Oin&Rs@`R?k#Y3
zmCuKBizFVLpPX56UwB@^{q0-<oNwY1xFx<MaGzbrz_WKg1Mia12ELxy2L2ZF27#<U
z0)i>kAB2KdeGqnQN)RzV6d<bndV-knoeAR18^iW9)-y9PGqJL;vH)o|b}$5qFmrIy
z2i7C3VPFum0s0+8vM?}c88C7%Fvut{@G>y)2`~tP*o>m6;s`Z9z99^bK<w%o3?f1p
zoWU5#fdEDzfHD~v8AGBn(~Kb8iQGKcqv1agl-SR30nwo70MVc*0n@-}0nwnS0nwo7
z0nwl+0@0vo0@0wT0@0x80@0u-1Jl5016dD>ItGR?1_n_4fdoKt2m+vZ1OZT7f@n~D
yf@n~jf@n~@f@o0Of@o0uf@n}2gJ@7ZZ&qfW$UGvWmkXExbd5ksL1%IzyD$JO3AnES

delta 487
zcmca6_=RtRxG4(*0|N+yKot;!*qppek|*$WO9}9|xK0o#F`FQmqCP<=L}G%luZw_)
z@vjLRdrmUeGcXPiWMGg{U|>~dV9+vP1iBVNf`nXMgF_fxT|*ccp<se|C|3Ugbuoba
y2%<s$1koVBf@qL`K{UwEAR6Rv5DoG>hz9w8vkA*Y=7A0XMVQxd2EgQP90~xH_a)r`

diff --git a/lib/pytz/zoneinfo/EST b/lib/pytz/zoneinfo/EST
index 21ebc00b3fc096035b9810519d778d04a3562a44..9964b9a33452f4b636f43703b7cdec4891cbda5f 100644
GIT binary patch
literal 182
zcmWHE%1kq2zzdjwvdlot(*Pv8za+k3WcvSqYXJiTkd$Cx`Tu|C1_llv-w+08Aa)H7
ZVF)3?%>O`;*{&u4qKPq^3uu8U7XX0%EG7T|

literal 114
lcmWHE%1kq2AP5+NDp>yi-?@Q-!8JI9A%rYlTtKa+TmXY14MYF{

diff --git a/lib/pytz/zoneinfo/EST5EDT b/lib/pytz/zoneinfo/EST5EDT
index 9bce5007d4dbb871974a69cb0f68151c1ee22556..a8b9ab1992257d721ad627b14f535c3d4b020888 100644
GIT binary patch
literal 3552
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
KM8-r$`~MBRGsCk0

delta 503
zcmaDL-6k|a+<=vVfdPa;U@8!U*aGvG$ra4s^*Uie8$-duS!WYYcYG+gr2M7eQo`@e
ziy1AM>KPdr8JL)X#K1rk?AHGOzjFfv%m4q!4=^%-Ne(c{0}-G6fkhPLJ4S{H;$Q}b
xw<kNWs!Tq@Cb3zEBZp<k`cW3_M=sak5K~u|5FKA*JtI8>9bZF3JwrVME&!7BM*si-

diff --git a/lib/pytz/zoneinfo/Europe/Lisbon b/lib/pytz/zoneinfo/Europe/Lisbon
index 55f01930ba92ff6852ae4745e78adb5f96c5b057..616de167b8a1c534c1c526e7bbff82f7d5da94f2 100644
GIT binary patch
delta 775
zcmd6kKS%;m9LL}Nu{6%qw9dN9z#(vPh!R>N$SI-*ms*U78lt+PxgOb+5T|d{O3j8W
zC=!~4h6ZVI$f=<rgoGdxS}LKs@6jMNw)A_v`@DO%9G}mTQdBfKWF>@PWA62hvqJSp
z{9%VC#+TK^N0BCzb-H^UQTNvUWIuONONHlXI{K()MyvE-WmV036>>P4spU-1YOWfN
zEiLfEO|1Mh^;QX_q+=hkCKS>dm56OCsM*(sG{=0u))sPW&WSO*Yv5gL_ukPCXNk(f
zC6!;!sJoJ;o#i;~x{6Sxa7wyQQluvtBYBC>au$yNUd$o(u~{j=3Cu3K7R^l!%hF=3
zhMUH(e>t<LILLD%D~Q8R&KO;nJ{&P#G}-Y>D)XCs({=i(4?Kc!3Bo4`ry#t7a0|jO
z2*)5igK%xI8fNFFk}f>I*>uY_<4)JkX3U<Apoaf~a1hc#hzB7bL;w&GK!gAh!=N4n
hL=+HVK*RwN2!lu%gu?XZU(F-JKdNQ>QHyO`Jzrpb$t(Z>

delta 707
zcmc)HF-Sr|9LMo{@AXW>SI?}}Ug;n~xHLpL6ht%@w7AsLP_#sKM7syI33hg)mSzTJ
z(IPZu4Gq#zi<8h01Pz7sAg6-rey*)S|Ksj^<MFwQbz*T}%uNWv#yrZ6yT#<O`<!Iy
z=~bHks<2F^PWNuN=ze^IW{VegZXrew5-&7AS)+$*>$DJd+efo`yQsg>Vk4PaSyq*y
zRJA_iK8+9~ZISkbn{;ePnYlU0JWB!A8S``R)F<m2{@~r=SKi}&;6Ck+``)j(|EZh{
zRCB!dCdIAGve|cbZuV!gX310wim<f-QPalMR#jd@^G;WDwK@KL3Enay7L8GZC~_o-
z9EAu|w>-bh#JC=rtJ7~eU_wEKf(r#13N{pUDELqiqF_Wp*=!>zuJwEAS=w>b6hWQA
zc$DEWutedB!W4xo3R@JuD2!1!H!H1Cc%v{!;f}%{g+GcvK!YX2HKG0cM;sfWA9E7P
A6951J

diff --git a/lib/pytz/zoneinfo/HST b/lib/pytz/zoneinfo/HST
index cccd45eb8cb2f56b6a1b75e2d7b9530cb5abf2e1..c7cd060159bd22fc5e6f10ac5a2089afb2c19c6a 100644
GIT binary patch
literal 329
zcmWHE%1kq2zyNGO5fBCeb|40^MH+y_ZdPZH-HL?~r#o#=TvGm0a4FH#;%aZP2O|?B
zGYcc@|Nl8m3=BXrf`R4#|Edf|4lv0BCI$ZgFHT@!@$n5|@CXKC7a$G?;(!pK!3+$H
uP%?xBC;bP4k_QF*Ks3l{U>fK=5Dju7hz2<mOaq+?qN(g$E}&lw4Y&a7X=UL6

literal 115
mcmWHE%1kq2AP5+NDp>yiFHT@!@CXiJ2q8-s7f`FA0T%#a4Gc{H

diff --git a/lib/pytz/zoneinfo/MET b/lib/pytz/zoneinfo/MET
index 4a826bb185531c34eb37959037c68fbf08c23f71..40d7124e5346af056c75e2f7012a51d94e8154b7 100644
GIT binary patch
delta 1360
zcmbu;O-NKh0KoBizFj|7saKSeb(j(nLf182h%Q;?!PF9xk|GO&2%=a#L<O~WD(SLj
zkl?||GP4g$O<S`s`_iDSR4lp#1sNS`3W9Fi{C8Ob>mWL_v;X%Vv+uIM>2iLhhccF@
z3L#jGuvuKE*PE~A4Q2H$Y1x5B-=bja=x?9e-LB6c9}Kj47wQW~EA&PG3Ef_s6}Xh`
z*Bv=6`tnLkcP1Uvo!^QASEhF9t8c6Hwc&O8`tuIm)sdxdsLg?!C*8WcVZZJPRH)v%
z9(AkAtNO~e%YL7uZm&9|!t;NsaO9I3_&%ZTOrDm5?|#U;BOhzzz3{la-`b!aH22Ae
zElcIl;dAoQzEkpX%@O%zZN7TCdWU?rW=Ia#Ose7cDQaZn68U1P+<DoV5gKhPabBG%
za$X;-4ZW#Lcg8jqhsGO=or&_S?mb_vV1hfrcG<4v#H1Nd_Qz(5XRb3i+ZPDo$~6BI
z!zIK#M<ffeOj>EvudM~~J+YmC_f%9?i)}fj)uJT2wwSw8^JRu*nU5LKUq<h(P=?>U
zTCf-cW^tVvF=K20htKrDmk~j+L-Es;XXi!%@c={=NEA#IP!v=YSQK0oU=(B&Xwe#M
z6mS%D6nGSTCcy{-d4NKSM2bd=NQz2|Oo~p5P>NED)M$-Xidc$Tid<^+n(mE65X=J<
zQzTO~Q$$l#Q)E+gQ-o8LQ=~_0v{S@4?X<I380Fj}ouZv0o*MPNXYDaNm|!Q`F1O2_
zl9W8-$^O{%q|R{$XZ?b>d!ygDH^aC$`VB@S+nIiCEspPr?TqiK5^3;X&k^|F3Hav-
da3DP9pyU;lm_w3VS?Kk9eYuqdKAK<X`2!&H>q`It

delta 516
zcmew=woYJzxDNvmuz(04=m266n{zggc*5+fw?53dxo*PTC0i%V+c{yv{FdnxPH+}Z
zIP=_F;Ot8A3Fj6$3!I;1B5<KeRp4Tgn7}1Jht0~2uNdnYn3x9=YQrpNVBiyAU}a#C
zQD6l62||KId|iV>7<^qrfP#|^SR`eEG-e3=2LeziOs-?mVF7u2G9R0&5YVe236OU|
eG|0=LY?qh^+RG*+c$txr3+Q)UL*K~>+@b(d<wb}9

diff --git a/lib/pytz/zoneinfo/MST b/lib/pytz/zoneinfo/MST
index c93a58eee8b32f672fd3a96ca3e6ada5b0a0e168..ab37e845566aa95659b7b85be0051d0c67a7e53a 100644
GIT binary patch
literal 360
zcmWHE%1kq2zyPd35fBCeZXgD+1sZ_Fyk%As=I>^2SkNXjVd1Qo4W~PKCY%?)FLS>C
z>6#0TQZm1OlnVTQ5y8O1$i&FR41|nK|Nl>W$H4Ia|LO&dEdT${oxs2WX7fPUKE5Fg
zzAiu<48-9fKr0v+7{Npc2~PVD1aT}p8$dM3i69!}Ob`unDu@O-7es@c45C5K2Gc;N
WgJ_WRK{Ut<Aeu_v-~#&0oC^SE_l4#F

literal 114
lcmWHE%1kq2AP5+NDp>yipF4qp!8bUBA%rYlTtKbnTmW*V4CVj;

diff --git a/lib/pytz/zoneinfo/MST7MDT b/lib/pytz/zoneinfo/MST7MDT
index 4506a6e150dfd73884811c8c0f5a0e21dc76a756..abb2b974a47eb3e5c8b4f5d4370baf4898b239ab 100644
GIT binary patch
delta 656
zcmZn@nj<_xJcNybfdPa;U>*>I*dh%e&N8bB^LMj1ENGLNuyEGPhDE9WCM<4YV_4$)
zV8W9AWeul0c_v&^{!(x$QG(&Se%XW{8dDg4@<&Yg#Zk7=-IA%EnUM(sSy-VAm;hbq
zWCE7{|37yM1H=FSs~0e`0NE25IAA1Dga<4x;Nu&@;Ohd!!9W}i!~r3|fMH++LNGZ&
zTo!Ba{Re_L7M=~0E16ZKLE#1x0EHch28AD(?q4=}2D7X*DC|IdQ22ppP#A(}U^s5x
Pz+A{O5(0AaI}Ql|#Yu{v

delta 534
zcmbOu+$J<Z+<=vVfdPa;U@8!U*aGvGSxuO~o4sK{o6LlTvtBlw?&O(pN%>2`r9_F1
z*_KT8j0}tnOw2%HV4xp%YybbBJAr}a|Nqqs7#YAM2bko6i2J&PF!%-oaX1hMgn<0Z
z2q7kji((Ch$-9_UCjVoW*lfm<!!po*PNS}$xqv}o4h#|<Ut>KZJp&zILqk17Jp(QP
Duq{Wd

diff --git a/lib/pytz/zoneinfo/Mexico/BajaNorte b/lib/pytz/zoneinfo/Mexico/BajaNorte
index 63dfdf48a68d02240737ecd6af081e02eb0b6317..0fe73912cacab6c8aabef4f4264d1710825888e7 100644
GIT binary patch
delta 180
zcmX>mG)s7bvhQpL1_llwmRP#&MZwBS|AO@&EgQC_r4($J7GT)H_36XuSG^6Fl)n^Q
zn!E19b?Hck8xyyDxXr-MaQi^<hdcK+FSxsM&4hdVrY^YO**9Th#9pS!2^?&buW>|7
z&Sh3+oIQCWvn(^v#K{|(b(w)COn%5Lq65<Y9|%B3fM}30AR1&8hz1!4qCrM({>c24
I1!`si0In-yJOBUy

delta 115
zcmbOwd`xJ9vguR?1_llwmRP#&MZwBS|AO_OYCddBODWhcEx@pY>(htRuX-CUDSs)r
zG;>$Mb?Hck8xyyD*jTWaX|fh)#N=*fWyYzK*E7p919eS4&#Ws9RP`SSKq^5rNcCoW
KmZvO0<plu35;v*<

diff --git a/lib/pytz/zoneinfo/Mexico/BajaSur b/lib/pytz/zoneinfo/Mexico/BajaSur
index 06fa22749d0a3157b5a693f0797086f78e1201c5..386616a59cdb2a21f1f24a6c72526bce0360cd24 100644
GIT binary patch
delta 199
zcmaFCv4mrSxFIV80|N+yfGrS%*aAzpy(n1!QM+JUT3Et%N85rOJZ1?y{<eKM{i-lw
zV!-{$kC;s+r!p#t`}l@1_y&hCI0Lb-O9%r4Bgh!W$r~7@OtBjL9|%B(gJ_TiAR1%|
ehz40S`9Gt?W_70Rj4&${a99Dfh6`x3ITrwuP(SDZ

delta 235
zcmZ3&@q%N5xFtIS0|N+yfISd{*dj}}y(n1!Deu9yw6KKj&X*E)@R%j+_}lj3^sB;z
z8xyyDU|=X{nCNkzk#+J$X4A>hj0$Z3|MxdA2u%LREG85X9KyiB2r>^wO%ON5YR!Kj
w09gg1LDqq2kd+`BWbNdKj1mGM4#ZB7fdvhle==@o#A>qyrp;Ww!6D{c0Ki95D*ylh

diff --git a/lib/pytz/zoneinfo/Mexico/General b/lib/pytz/zoneinfo/Mexico/General
index 68176daa4976b015fb79026f3053e74e4a7457ab..ad70cf3e08498845aaafc38e4eccca7461c8d337 100644
GIT binary patch
delta 47
ucmX@cd5m*{A@@h^f^BJG3ELfQ3pUzZWfTVT{{sO?3`B#(H>)r$VgdjlQWv}c

delta 47
ucmX@cd5m*{A@`@e2iwxZ61F>EO4w*~l~EYT{|^KpF%S(B->ky4hzS5+IvO$n

diff --git a/lib/pytz/zoneinfo/PST8PDT b/lib/pytz/zoneinfo/PST8PDT
index 99d246baa35cb9c6f56d50adbec163452e2a47fa..610e7af5fc13d9784de30d272c7c39d7938873a0 100644
GIT binary patch
delta 1027
zcmd^-Jxo(k7(nl9AKJmlO(Rx~T@jKJ2VF==SV$WGV$~)(m@;?LCWM5=*8w#y_G@6(
z!JolIqm>O4Q$xaRIv5eCf>N6TrBtxMz~!EHbz^YgzI@-gxyu{Qc@TVYTtX)gDWw?B
zq#f?Z(spGdr@b$`L$|-C-^jP!DVfcSo-4kT`B$%{`0=59fAm;>JWa|%@~$l2yCgp^
zT$f*o9$D%>FQw>3{X2L~m(N6WxqePp4j<K(LWf>1)$~fPp;xC1x|*HQYj3MkOMTGm
zna@)9KFOau?`31~xoln?m%sh@wKUES%U0Jjz1@CGb^@chXs^#}b9|1^@7ncWK5rkt
zH747slrc}lagE8ORiJr4(%icBa`{SJ#Rlx$uyfN+EN*Qm<v6V^q3}PQ8G91$sr=Z8
zzpp8d2joEnLL@>&LS#aOLZm{(LgYdOLnK2)Lu5mQL!?`H2J<{%A5uV*wgN~AkQyLG
wK&pV00jUF02&587DUezq#Xwt)W!M<X;emP}1wmWU#5;e=J?I&YRRbsX0J{ryp8x;=

delta 486
zcmZ1?)+RJTT$Gi8fdPa;U@8!U*a8y`WH#QhV5(<iU}Ruo1`-1U{jgj6|9^i21Iz#a
zb0;t|fJqK8$paA&a0y`u2nOPCAPxut`HK-k;PUNcHx`@Ci&%45hM9jS^KeT50LU#f
A#sB~S

diff --git a/lib/pytz/zoneinfo/Portugal b/lib/pytz/zoneinfo/Portugal
index 55f01930ba92ff6852ae4745e78adb5f96c5b057..616de167b8a1c534c1c526e7bbff82f7d5da94f2 100644
GIT binary patch
delta 775
zcmd6kKS%;m9LL}Nu{6%qw9dN9z#(vPh!R>N$SI-*ms*U78lt+PxgOb+5T|d{O3j8W
zC=!~4h6ZVI$f=<rgoGdxS}LKs@6jMNw)A_v`@DO%9G}mTQdBfKWF>@PWA62hvqJSp
z{9%VC#+TK^N0BCzb-H^UQTNvUWIuONONHlXI{K()MyvE-WmV036>>P4spU-1YOWfN
zEiLfEO|1Mh^;QX_q+=hkCKS>dm56OCsM*(sG{=0u))sPW&WSO*Yv5gL_ukPCXNk(f
zC6!;!sJoJ;o#i;~x{6Sxa7wyQQluvtBYBC>au$yNUd$o(u~{j=3Cu3K7R^l!%hF=3
zhMUH(e>t<LILLD%D~Q8R&KO;nJ{&P#G}-Y>D)XCs({=i(4?Kc!3Bo4`ry#t7a0|jO
z2*)5igK%xI8fNFFk}f>I*>uY_<4)JkX3U<Apoaf~a1hc#hzB7bL;w&GK!gAh!=N4n
hL=+HVK*RwN2!lu%gu?XZU(F-JKdNQ>QHyO`Jzrpb$t(Z>

delta 707
zcmc)HF-Sr|9LMo{@AXW>SI?}}Ug;n~xHLpL6ht%@w7AsLP_#sKM7syI33hg)mSzTJ
z(IPZu4Gq#zi<8h01Pz7sAg6-rey*)S|Ksj^<MFwQbz*T}%uNWv#yrZ6yT#<O`<!Iy
z=~bHks<2F^PWNuN=ze^IW{VegZXrew5-&7AS)+$*>$DJd+efo`yQsg>Vk4PaSyq*y
zRJA_iK8+9~ZISkbn{;ePnYlU0JWB!A8S``R)F<m2{@~r=SKi}&;6Ck+``)j(|EZh{
zRCB!dCdIAGve|cbZuV!gX310wim<f-QPalMR#jd@^G;WDwK@KL3Enay7L8GZC~_o-
z9EAu|w>-bh#JC=rtJ7~eU_wEKf(r#13N{pUDELqiqF_Wp*=!>zuJwEAS=w>b6hWQA
zc$DEWutedB!W4xo3R@JuD2!1!H!H1Cc%v{!;f}%{g+GcvK!YX2HKG0cM;sfWA9E7P
A6951J

diff --git a/lib/pytz/zoneinfo/WET b/lib/pytz/zoneinfo/WET
index c27390b5b638399057d5f5c6d09ef8c81d5f01c1..616de167b8a1c534c1c526e7bbff82f7d5da94f2 100644
GIT binary patch
literal 3527
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
R#`V3u8hC~@@a9#iKLP8OCO-fG

delta 534
zcmX>u{gH2ixGW0;0|N+yKot;!*qppek|*$WO9@QAz$m5mdV-knoeAR1XD5h%-Zw$w
z@%jmpmlsTsIy`ZL^q#!}GHcce$j+HBuvvg<0b@NQ!$3ih`x)d}85sBk7=bJZ31qN_
zy9S3agu8|?FfuYu=4X{r#p+{_Zji4*G}z}I9A;jx!Ca8<LBgOA0Mo!w0MVe30MVe(
f0MVcj0nwmP0nwn40ny;l;ox*&9`vEJoL2z=mjpV|

diff --git a/lib/pytz/zoneinfo/leapseconds b/lib/pytz/zoneinfo/leapseconds
index ce150bfe..6c715cb2 100644
--- a/lib/pytz/zoneinfo/leapseconds
+++ b/lib/pytz/zoneinfo/leapseconds
@@ -69,11 +69,11 @@ Leap	2016	Dec	31	23:59:60	+	S
 # Any additional leap seconds will come after this.
 # This Expires line is commented out for now,
 # so that pre-2020a zic implementations do not reject this file.
-#Expires 2024	Dec	28	00:00:00
+#Expires 2025	Jun	28	00:00:00
 
 # POSIX timestamps for the data in this file:
-#updated 1704708379 (2024-01-08 10:06:19 UTC)
-#expires 1735344000 (2024-12-28 00:00:00 UTC)
+#updated 1720104763 (2024-07-04 14:52:43 UTC)
+#expires 1751068800 (2025-06-28 00:00:00 UTC)
 
 #	Updated through IERS Bulletin C (https://hpiers.obspm.fr/iers/bul/bulc/bulletinc.dat)
-#	File expires on 28 December 2024
+#	File expires on 28 June 2025
diff --git a/lib/pytz/zoneinfo/tzdata.zi b/lib/pytz/zoneinfo/tzdata.zi
index b5a03be7..b89326a7 100644
--- a/lib/pytz/zoneinfo/tzdata.zi
+++ b/lib/pytz/zoneinfo/tzdata.zi
@@ -1324,14 +1324,10 @@ R O 1961 1964 - May lastSu 1s 1 S
 R O 1962 1964 - S lastSu 1s 0 -
 R p 1916 o - Jun 17 23 1 S
 R p 1916 o - N 1 1 0 -
-R p 1917 o - F 28 23s 1 S
-R p 1917 1921 - O 14 23s 0 -
-R p 1918 o - Mar 1 23s 1 S
-R p 1919 o - F 28 23s 1 S
-R p 1920 o - F 29 23s 1 S
-R p 1921 o - F 28 23s 1 S
+R p 1917 1921 - Mar 1 0 1 S
+R p 1917 1921 - O 14 24 0 -
 R p 1924 o - Ap 16 23s 1 S
-R p 1924 o - O 14 23s 0 -
+R p 1924 o - O 4 23s 0 -
 R p 1926 o - Ap 17 23s 1 S
 R p 1926 1929 - O Sa>=1 23s 0 -
 R p 1927 o - Ap 9 23s 1 S
@@ -1349,8 +1345,9 @@ R p 1938 o - Mar 26 23s 1 S
 R p 1939 o - Ap 15 23s 1 S
 R p 1939 o - N 18 23s 0 -
 R p 1940 o - F 24 23s 1 S
-R p 1940 1941 - O 5 23s 0 -
+R p 1940 o - O 7 23s 0 -
 R p 1941 o - Ap 5 23s 1 S
+R p 1941 o - O 5 23s 0 -
 R p 1942 1945 - Mar Sa>=8 23s 1 S
 R p 1942 o - Ap 25 22s 2 M
 R p 1942 o - Au 15 22s 1 S
@@ -1360,16 +1357,16 @@ R p 1943 1945 - Au Sa>=25 22s 1 S
 R p 1944 1945 - Ap Sa>=21 22s 2 M
 R p 1946 o - Ap Sa>=1 23s 1 S
 R p 1946 o - O Sa>=1 23s 0 -
-R p 1947 1965 - Ap Su>=1 2s 1 S
+R p 1947 1966 - Ap Su>=1 2s 1 S
 R p 1947 1965 - O Su>=1 2s 0 -
-R p 1977 o - Mar 27 0s 1 S
-R p 1977 o - S 25 0s 0 -
-R p 1978 1979 - Ap Su>=1 0s 1 S
-R p 1978 o - O 1 0s 0 -
-R p 1979 1982 - S lastSu 1s 0 -
-R p 1980 o - Mar lastSu 0s 1 S
-R p 1981 1982 - Mar lastSu 1s 1 S
-R p 1983 o - Mar lastSu 2s 1 S
+R p 1976 o - S lastSu 1 0 -
+R p 1977 o - Mar lastSu 0s 1 S
+R p 1977 o - S lastSu 0s 0 -
+R p 1978 1980 - Ap Su>=1 1s 1 S
+R p 1978 o - O 1 1s 0 -
+R p 1979 1980 - S lastSu 1s 0 -
+R p 1981 1986 - Mar lastSu 0s 1 S
+R p 1981 1985 - S lastSu 0s 0 -
 R z 1932 o - May 21 0s 1 S
 R z 1932 1939 - O Su>=1 0s 0 -
 R z 1933 1939 - Ap Su>=2 0s 1 S
@@ -1728,7 +1725,7 @@ R Y 1972 2006 - O lastSu 2 0 S
 R Y 1987 2006 - Ap Su>=1 2 1 D
 R Yu 1965 o - Ap lastSu 0 2 DD
 R Yu 1965 o - O lastSu 2 0 S
-R m 1931 o - May 1 23 1 D
+R m 1931 o - April 30 0 1 D
 R m 1931 o - O 1 0 0 S
 R m 1939 o - F 5 0 1 D
 R m 1939 o - Jun 25 0 0 S
@@ -2096,15 +2093,15 @@ Z Africa/Algiers 0:12:12 - LMT 1891 Mar 16
 0 d WE%sT 1981 May
 1 - CET
 Z Africa/Bissau -1:2:20 - LMT 1912 Ja 1 1u
--1 - -01 1975
+-1 - %z 1975
 0 - GMT
 Z Africa/Cairo 2:5:9 - LMT 1900 O
 2 K EE%sT
 Z Africa/Casablanca -0:30:20 - LMT 1913 O 26
-0 M +00/+01 1984 Mar 16
-1 - +01 1986
-0 M +00/+01 2018 O 28 3
-1 M +01/+00
+0 M %z 1984 Mar 16
+1 - %z 1986
+0 M %z 2018 O 28 3
+1 M %z
 Z Africa/Ceuta -0:21:16 - LMT 1901 Ja 1 0u
 0 - WET 1918 May 6 23
 0 1 WEST 1918 O 7 23
@@ -2115,9 +2112,9 @@ Z Africa/Ceuta -0:21:16 - LMT 1901 Ja 1 0u
 1 - CET 1986
 1 E CE%sT
 Z Africa/El_Aaiun -0:52:48 - LMT 1934
--1 - -01 1976 Ap 14
-0 M +00/+01 2018 O 28 3
-1 M +01/+00
+-1 - %z 1976 Ap 14
+0 M %z 2018 O 28 3
+1 M %z
 Z Africa/Johannesburg 1:52 - LMT 1892 F 8
 1:30 - SAST 1903 Mar
 2 SA SAST
@@ -2132,19 +2129,19 @@ Z Africa/Khartoum 2:10:8 - LMT 1931
 Z Africa/Lagos 0:13:35 - LMT 1905 Jul
 0 - GMT 1908 Jul
 0:13:35 - LMT 1914
-0:30 - +0030 1919 S
+0:30 - %z 1919 S
 1 - WAT
-Z Africa/Maputo 2:10:20 - LMT 1903 Mar
+Z Africa/Maputo 2:10:18 - LMT 1909
 2 - CAT
 Z Africa/Monrovia -0:43:8 - LMT 1882
 -0:43:8 - MMT 1919 Mar
 -0:44:30 - MMT 1972 Ja 7
 0 - GMT
 Z Africa/Nairobi 2:27:16 - LMT 1908 May
-2:30 - +0230 1928 Jun 30 24
+2:30 - %z 1928 Jun 30 24
 3 - EAT 1930 Ja 4 24
-2:30 - +0230 1936 D 31 24
-2:45 - +0245 1942 Jul 31 24
+2:30 - %z 1936 D 31 24
+2:45 - %z 1942 Jul 31 24
 3 - EAT
 Z Africa/Ndjamena 1:0:12 - LMT 1912
 1 - WAT 1979 O 14
@@ -2168,7 +2165,7 @@ Z Africa/Tunis 0:40:44 - LMT 1881 May 12
 0:9:21 - PMT 1911 Mar 11
 1 n CE%sT
 Z Africa/Windhoek 1:8:24 - LMT 1892 F 8
-1:30 - +0130 1903 Mar
+1:30 - %z 1903 Mar
 2 - SAST 1942 S 20 2
 2 1 SAST 1943 Mar 21 2
 2 - SAST 1990 Mar 21
@@ -2191,167 +2188,166 @@ Z America/Anchorage 14:0:24 - LMT 1867 O 19 14:31:37
 -9 u Y%sT 1983 N 30
 -9 u AK%sT
 Z America/Araguaina -3:12:48 - LMT 1914
--3 B -03/-02 1990 S 17
--3 - -03 1995 S 14
--3 B -03/-02 2003 S 24
--3 - -03 2012 O 21
--3 B -03/-02 2013 S
--3 - -03
+-3 B %z 1990 S 17
+-3 - %z 1995 S 14
+-3 B %z 2003 S 24
+-3 - %z 2012 O 21
+-3 B %z 2013 S
+-3 - %z
 Z America/Argentina/Buenos_Aires -3:53:48 - LMT 1894 O 31
 -4:16:48 - CMT 1920 May
--4 - -04 1930 D
--4 A -04/-03 1969 O 5
--3 A -03/-02 1999 O 3
--4 A -04/-03 2000 Mar 3
--3 A -03/-02
+-4 - %z 1930 D
+-4 A %z 1969 O 5
+-3 A %z 1999 O 3
+-4 A %z 2000 Mar 3
+-3 A %z
 Z America/Argentina/Catamarca -4:23:8 - LMT 1894 O 31
 -4:16:48 - CMT 1920 May
--4 - -04 1930 D
--4 A -04/-03 1969 O 5
--3 A -03/-02 1991 Mar 3
--4 - -04 1991 O 20
--3 A -03/-02 1999 O 3
--4 A -04/-03 2000 Mar 3
--3 - -03 2004 Jun
--4 - -04 2004 Jun 20
--3 A -03/-02 2008 O 18
--3 - -03
+-4 - %z 1930 D
+-4 A %z 1969 O 5
+-3 A %z 1991 Mar 3
+-4 - %z 1991 O 20
+-3 A %z 1999 O 3
+-4 A %z 2000 Mar 3
+-3 - %z 2004 Jun
+-4 - %z 2004 Jun 20
+-3 A %z 2008 O 18
+-3 - %z
 Z America/Argentina/Cordoba -4:16:48 - LMT 1894 O 31
 -4:16:48 - CMT 1920 May
--4 - -04 1930 D
--4 A -04/-03 1969 O 5
--3 A -03/-02 1991 Mar 3
--4 - -04 1991 O 20
--3 A -03/-02 1999 O 3
--4 A -04/-03 2000 Mar 3
--3 A -03/-02
+-4 - %z 1930 D
+-4 A %z 1969 O 5
+-3 A %z 1991 Mar 3
+-4 - %z 1991 O 20
+-3 A %z 1999 O 3
+-4 A %z 2000 Mar 3
+-3 A %z
 Z America/Argentina/Jujuy -4:21:12 - LMT 1894 O 31
 -4:16:48 - CMT 1920 May
--4 - -04 1930 D
--4 A -04/-03 1969 O 5
--3 A -03/-02 1990 Mar 4
--4 - -04 1990 O 28
--4 1 -03 1991 Mar 17
--4 - -04 1991 O 6
--3 1 -02 1992
--3 A -03/-02 1999 O 3
--4 A -04/-03 2000 Mar 3
--3 A -03/-02 2008 O 18
--3 - -03
+-4 - %z 1930 D
+-4 A %z 1969 O 5
+-3 A %z 1990 Mar 4
+-4 - %z 1990 O 28
+-4 1 %z 1991 Mar 17
+-4 - %z 1991 O 6
+-3 1 %z 1992
+-3 A %z 1999 O 3
+-4 A %z 2000 Mar 3
+-3 A %z 2008 O 18
+-3 - %z
 Z America/Argentina/La_Rioja -4:27:24 - LMT 1894 O 31
 -4:16:48 - CMT 1920 May
--4 - -04 1930 D
--4 A -04/-03 1969 O 5
--3 A -03/-02 1991 Mar
--4 - -04 1991 May 7
--3 A -03/-02 1999 O 3
--4 A -04/-03 2000 Mar 3
--3 - -03 2004 Jun
--4 - -04 2004 Jun 20
--3 A -03/-02 2008 O 18
--3 - -03
+-4 - %z 1930 D
+-4 A %z 1969 O 5
+-3 A %z 1991 Mar
+-4 - %z 1991 May 7
+-3 A %z 1999 O 3
+-4 A %z 2000 Mar 3
+-3 - %z 2004 Jun
+-4 - %z 2004 Jun 20
+-3 A %z 2008 O 18
+-3 - %z
 Z America/Argentina/Mendoza -4:35:16 - LMT 1894 O 31
 -4:16:48 - CMT 1920 May
--4 - -04 1930 D
--4 A -04/-03 1969 O 5
--3 A -03/-02 1990 Mar 4
--4 - -04 1990 O 15
--4 1 -03 1991 Mar
--4 - -04 1991 O 15
--4 1 -03 1992 Mar
--4 - -04 1992 O 18
--3 A -03/-02 1999 O 3
--4 A -04/-03 2000 Mar 3
--3 - -03 2004 May 23
--4 - -04 2004 S 26
--3 A -03/-02 2008 O 18
--3 - -03
+-4 - %z 1930 D
+-4 A %z 1969 O 5
+-3 A %z 1990 Mar 4
+-4 - %z 1990 O 15
+-4 1 %z 1991 Mar
+-4 - %z 1991 O 15
+-4 1 %z 1992 Mar
+-4 - %z 1992 O 18
+-3 A %z 1999 O 3
+-4 A %z 2000 Mar 3
+-3 - %z 2004 May 23
+-4 - %z 2004 S 26
+-3 A %z 2008 O 18
+-3 - %z
 Z America/Argentina/Rio_Gallegos -4:36:52 - LMT 1894 O 31
 -4:16:48 - CMT 1920 May
--4 - -04 1930 D
--4 A -04/-03 1969 O 5
--3 A -03/-02 1999 O 3
--4 A -04/-03 2000 Mar 3
--3 - -03 2004 Jun
--4 - -04 2004 Jun 20
--3 A -03/-02 2008 O 18
--3 - -03
+-4 - %z 1930 D
+-4 A %z 1969 O 5
+-3 A %z 1999 O 3
+-4 A %z 2000 Mar 3
+-3 - %z 2004 Jun
+-4 - %z 2004 Jun 20
+-3 A %z 2008 O 18
+-3 - %z
 Z America/Argentina/Salta -4:21:40 - LMT 1894 O 31
 -4:16:48 - CMT 1920 May
--4 - -04 1930 D
--4 A -04/-03 1969 O 5
--3 A -03/-02 1991 Mar 3
--4 - -04 1991 O 20
--3 A -03/-02 1999 O 3
--4 A -04/-03 2000 Mar 3
--3 A -03/-02 2008 O 18
--3 - -03
+-4 - %z 1930 D
+-4 A %z 1969 O 5
+-3 A %z 1991 Mar 3
+-4 - %z 1991 O 20
+-3 A %z 1999 O 3
+-4 A %z 2000 Mar 3
+-3 A %z 2008 O 18
+-3 - %z
 Z America/Argentina/San_Juan -4:34:4 - LMT 1894 O 31
 -4:16:48 - CMT 1920 May
--4 - -04 1930 D
--4 A -04/-03 1969 O 5
--3 A -03/-02 1991 Mar
--4 - -04 1991 May 7
--3 A -03/-02 1999 O 3
--4 A -04/-03 2000 Mar 3
--3 - -03 2004 May 31
--4 - -04 2004 Jul 25
--3 A -03/-02 2008 O 18
--3 - -03
+-4 - %z 1930 D
+-4 A %z 1969 O 5
+-3 A %z 1991 Mar
+-4 - %z 1991 May 7
+-3 A %z 1999 O 3
+-4 A %z 2000 Mar 3
+-3 - %z 2004 May 31
+-4 - %z 2004 Jul 25
+-3 A %z 2008 O 18
+-3 - %z
 Z America/Argentina/San_Luis -4:25:24 - LMT 1894 O 31
 -4:16:48 - CMT 1920 May
--4 - -04 1930 D
--4 A -04/-03 1969 O 5
--3 A -03/-02 1990
--3 1 -02 1990 Mar 14
--4 - -04 1990 O 15
--4 1 -03 1991 Mar
--4 - -04 1991 Jun
--3 - -03 1999 O 3
--4 1 -03 2000 Mar 3
--3 - -03 2004 May 31
--4 - -04 2004 Jul 25
--3 A -03/-02 2008 Ja 21
--4 Sa -04/-03 2009 O 11
--3 - -03
+-4 - %z 1930 D
+-4 A %z 1969 O 5
+-3 A %z 1990
+-3 1 %z 1990 Mar 14
+-4 - %z 1990 O 15
+-4 1 %z 1991 Mar
+-4 - %z 1991 Jun
+-3 - %z 1999 O 3
+-4 1 %z 2000 Mar 3
+-3 - %z 2004 May 31
+-4 - %z 2004 Jul 25
+-3 A %z 2008 Ja 21
+-4 Sa %z 2009 O 11
+-3 - %z
 Z America/Argentina/Tucuman -4:20:52 - LMT 1894 O 31
 -4:16:48 - CMT 1920 May
--4 - -04 1930 D
--4 A -04/-03 1969 O 5
--3 A -03/-02 1991 Mar 3
--4 - -04 1991 O 20
--3 A -03/-02 1999 O 3
--4 A -04/-03 2000 Mar 3
--3 - -03 2004 Jun
--4 - -04 2004 Jun 13
--3 A -03/-02
+-4 - %z 1930 D
+-4 A %z 1969 O 5
+-3 A %z 1991 Mar 3
+-4 - %z 1991 O 20
+-3 A %z 1999 O 3
+-4 A %z 2000 Mar 3
+-3 - %z 2004 Jun
+-4 - %z 2004 Jun 13
+-3 A %z
 Z America/Argentina/Ushuaia -4:33:12 - LMT 1894 O 31
 -4:16:48 - CMT 1920 May
--4 - -04 1930 D
--4 A -04/-03 1969 O 5
--3 A -03/-02 1999 O 3
--4 A -04/-03 2000 Mar 3
--3 - -03 2004 May 30
--4 - -04 2004 Jun 20
--3 A -03/-02 2008 O 18
--3 - -03
+-4 - %z 1930 D
+-4 A %z 1969 O 5
+-3 A %z 1999 O 3
+-4 A %z 2000 Mar 3
+-3 - %z 2004 May 30
+-4 - %z 2004 Jun 20
+-3 A %z 2008 O 18
+-3 - %z
 Z America/Asuncion -3:50:40 - LMT 1890
 -3:50:40 - AMT 1931 O 10
--4 - -04 1972 O
--3 - -03 1974 Ap
--4 y -04/-03
+-4 - %z 1972 O
+-3 - %z 1974 Ap
+-4 y %z
 Z America/Bahia -2:34:4 - LMT 1914
--3 B -03/-02 2003 S 24
--3 - -03 2011 O 16
--3 B -03/-02 2012 O 21
--3 - -03
+-3 B %z 2003 S 24
+-3 - %z 2011 O 16
+-3 B %z 2012 O 21
+-3 - %z
 Z America/Bahia_Banderas -7:1 - LMT 1922 Ja 1 7u
--7 - MST 1927 Jun 10 23
+-7 - MST 1927 Jun 10
 -6 - CST 1930 N 15
 -7 m M%sT 1932 Ap
 -6 - CST 1942 Ap 24
--7 - MST 1949 Ja 14
--8 - PST 1970
+-7 - MST 1970
 -7 m M%sT 2010 Ap 4 2
 -6 m C%sT
 Z America/Barbados -3:58:29 - LMT 1911 Au 28
@@ -2359,18 +2355,18 @@ Z America/Barbados -3:58:29 - LMT 1911 Au 28
 -4 BB AST/-0330 1945
 -4 BB A%sT
 Z America/Belem -3:13:56 - LMT 1914
--3 B -03/-02 1988 S 12
--3 - -03
+-3 B %z 1988 S 12
+-3 - %z
 Z America/Belize -5:52:48 - LMT 1912 Ap
 -6 BZ %s
 Z America/Boa_Vista -4:2:40 - LMT 1914
--4 B -04/-03 1988 S 12
--4 - -04 1999 S 30
--4 B -04/-03 2000 O 15
--4 - -04
+-4 B %z 1988 S 12
+-4 - %z 1999 S 30
+-4 B %z 2000 O 15
+-4 - %z
 Z America/Bogota -4:56:16 - LMT 1884 Mar 13
 -4:56:16 - BMT 1914 N 23
--5 CO -05/-04
+-5 CO %z
 Z America/Boise -7:44:49 - LMT 1883 N 18 20u
 -8 u P%sT 1923 May 13 2
 -7 u M%sT 1974
@@ -2383,21 +2379,23 @@ Z America/Cambridge_Bay 0 - -00 1920
 -6 - CST 2001 Ap 1 3
 -7 C M%sT
 Z America/Campo_Grande -3:38:28 - LMT 1914
--4 B -04/-03
+-4 B %z
 Z America/Cancun -5:47:4 - LMT 1922 Ja 1 6u
--6 - CST 1981 D 23
+-6 - CST 1981 D 26 2
+-5 - EST 1983 Ja 4
+-6 m C%sT 1997 O 26 2
 -5 m E%sT 1998 Au 2 2
 -6 m C%sT 2015 F 1 2
 -5 - EST
 Z America/Caracas -4:27:44 - LMT 1890
 -4:27:40 - CMT 1912 F 12
--4:30 - -0430 1965
--4 - -04 2007 D 9 3
--4:30 - -0430 2016 May 1 2:30
--4 - -04
+-4:30 - %z 1965
+-4 - %z 2007 D 9 3
+-4:30 - %z 2016 May 1 2:30
+-4 - %z
 Z America/Cayenne -3:29:20 - LMT 1911 Jul
--4 - -04 1967 O
--3 - -03
+-4 - %z 1967 O
+-3 - %z
 Z America/Chicago -5:50:36 - LMT 1883 N 18 18u
 -6 u C%sT 1920
 -6 Ch C%sT 1936 Mar 1 2
@@ -2407,7 +2405,7 @@ Z America/Chicago -5:50:36 - LMT 1883 N 18 18u
 -6 Ch C%sT 1967
 -6 u C%sT
 Z America/Chihuahua -7:4:20 - LMT 1922 Ja 1 7u
--7 - MST 1927 Jun 10 23
+-7 - MST 1927 Jun 10
 -6 - CST 1930 N 15
 -7 m M%sT 1932 Ap
 -6 - CST 1996
@@ -2416,7 +2414,7 @@ Z America/Chihuahua -7:4:20 - LMT 1922 Ja 1 7u
 -7 m M%sT 2022 O 30 2
 -6 - CST
 Z America/Ciudad_Juarez -7:5:56 - LMT 1922 Ja 1 7u
--7 - MST 1927 Jun 10 23
+-7 - MST 1927 Jun 10
 -6 - CST 1930 N 15
 -7 m M%sT 1932 Ap
 -6 - CST 1996
@@ -2430,12 +2428,12 @@ Z America/Costa_Rica -5:36:13 - LMT 1890
 -5:36:13 - SJMT 1921 Ja 15
 -6 CR C%sT
 Z America/Cuiaba -3:44:20 - LMT 1914
--4 B -04/-03 2003 S 24
--4 - -04 2004 O
--4 B -04/-03
+-4 B %z 2003 S 24
+-4 - %z 2004 O
+-4 B %z
 Z America/Danmarkshavn -1:14:40 - LMT 1916 Jul 28
--3 - -03 1980 Ap 6 2
--3 E -03/-02 1996
+-3 - %z 1980 Ap 6 2
+-3 E %z 1996
 0 - GMT
 Z America/Dawson -9:17:40 - LMT 1900 Au 20
 -9 Y Y%sT 1965
@@ -2467,12 +2465,12 @@ Z America/Edmonton -7:33:52 - LMT 1906 S
 -7 Ed M%sT 1987
 -7 C M%sT
 Z America/Eirunepe -4:39:28 - LMT 1914
--5 B -05/-04 1988 S 12
--5 - -05 1993 S 28
--5 B -05/-04 1994 S 22
--5 - -05 2008 Jun 24
--4 - -04 2013 N 10
--5 - -05
+-5 B %z 1988 S 12
+-5 - %z 1993 S 28
+-5 B %z 1994 S 22
+-5 - %z 2008 Jun 24
+-4 - %z 2013 N 10
+-5 - %z
 Z America/El_Salvador -5:56:48 - LMT 1921
 -6 SV C%sT
 Z America/Fort_Nelson -8:10:47 - LMT 1884
@@ -2482,12 +2480,12 @@ Z America/Fort_Nelson -8:10:47 - LMT 1884
 -8 C P%sT 2015 Mar 8 2
 -7 - MST
 Z America/Fortaleza -2:34 - LMT 1914
--3 B -03/-02 1990 S 17
--3 - -03 1999 S 30
--3 B -03/-02 2000 O 22
--3 - -03 2001 S 13
--3 B -03/-02 2002 O
--3 - -03
+-3 B %z 1990 S 17
+-3 - %z 1999 S 30
+-3 B %z 2000 O 22
+-3 - %z 2001 S 13
+-3 B %z 2002 O
+-3 - %z
 Z America/Glace_Bay -3:59:48 - LMT 1902 Jun 15
 -4 C A%sT 1953
 -4 H A%sT 1954
@@ -2514,12 +2512,12 @@ Z America/Guatemala -6:2:4 - LMT 1918 O 5
 -6 GT C%sT
 Z America/Guayaquil -5:19:20 - LMT 1890
 -5:14 - QMT 1931
--5 EC -05/-04
+-5 EC %z
 Z America/Guyana -3:52:39 - LMT 1911 Au
--4 - -04 1915 Mar
--3:45 - -0345 1975 Au
--3 - -03 1992 Mar 29 1
--4 - -04
+-4 - %z 1915 Mar
+-3:45 - %z 1975 Au
+-3 - %z 1992 Mar 29 1
+-4 - %z
 Z America/Halifax -4:14:24 - LMT 1902 Jun 15
 -4 H A%sT 1918
 -4 C A%sT 1919
@@ -2531,12 +2529,11 @@ Z America/Havana -5:29:28 - LMT 1890
 -5:29:36 - HMT 1925 Jul 19 12
 -5 Q C%sT
 Z America/Hermosillo -7:23:52 - LMT 1922 Ja 1 7u
--7 - MST 1927 Jun 10 23
+-7 - MST 1927 Jun 10
 -6 - CST 1930 N 15
 -7 m M%sT 1932 Ap
 -6 - CST 1942 Ap 24
--7 - MST 1949 Ja 14
--8 - PST 1970
+-7 - MST 1996
 -7 m M%sT 1999
 -7 - MST
 Z America/Indiana/Indianapolis -5:44:38 - LMT 1883 N 18 18u
@@ -2644,23 +2641,23 @@ Z America/Kentucky/Monticello -5:39:24 - LMT 1883 N 18 18u
 Z America/La_Paz -4:32:36 - LMT 1890
 -4:32:36 - CMT 1931 O 15
 -4:32:36 1 BST 1932 Mar 21
--4 - -04
+-4 - %z
 Z America/Lima -5:8:12 - LMT 1890
 -5:8:36 - LMT 1908 Jul 28
--5 PE -05/-04
+-5 PE %z
 Z America/Los_Angeles -7:52:58 - LMT 1883 N 18 20u
 -8 u P%sT 1946
 -8 CA P%sT 1967
 -8 u P%sT
 Z America/Maceio -2:22:52 - LMT 1914
--3 B -03/-02 1990 S 17
--3 - -03 1995 O 13
--3 B -03/-02 1996 S 4
--3 - -03 1999 S 30
--3 B -03/-02 2000 O 22
--3 - -03 2001 S 13
--3 B -03/-02 2002 O
--3 - -03
+-3 B %z 1990 S 17
+-3 - %z 1995 O 13
+-3 B %z 1996 S 4
+-3 - %z 1999 S 30
+-3 B %z 2000 O 22
+-3 - %z 2001 S 13
+-3 B %z 2002 O
+-3 - %z
 Z America/Managua -5:45:8 - LMT 1890
 -5:45:12 - MMT 1934 Jun 23
 -6 - CST 1973 May
@@ -2671,10 +2668,10 @@ Z America/Managua -5:45:8 - LMT 1890
 -5 - EST 1997
 -6 NI C%sT
 Z America/Manaus -4:0:4 - LMT 1914
--4 B -04/-03 1988 S 12
--4 - -04 1993 S 28
--4 B -04/-03 1994 S 22
--4 - -04
+-4 B %z 1988 S 12
+-4 - %z 1993 S 28
+-4 B %z 1994 S 22
+-4 - %z
 Z America/Martinique -4:4:20 - LMT 1890
 -4:4:20 - FFMT 1911 May
 -4 - AST 1980 Ap 6
@@ -2686,12 +2683,11 @@ Z America/Matamoros -6:30 - LMT 1922 Ja 1 6u
 -6 m C%sT 2010
 -6 u C%sT
 Z America/Mazatlan -7:5:40 - LMT 1922 Ja 1 7u
--7 - MST 1927 Jun 10 23
+-7 - MST 1927 Jun 10
 -6 - CST 1930 N 15
 -7 m M%sT 1932 Ap
 -6 - CST 1942 Ap 24
--7 - MST 1949 Ja 14
--8 - PST 1970
+-7 - MST 1970
 -7 m M%sT
 Z America/Menominee -5:50:27 - LMT 1885 S 18 12
 -6 u C%sT 1946
@@ -2699,8 +2695,8 @@ Z America/Menominee -5:50:27 - LMT 1885 S 18 12
 -5 - EST 1973 Ap 29 2
 -6 u C%sT
 Z America/Merida -5:58:28 - LMT 1922 Ja 1 6u
--6 - CST 1981 D 23
--5 - EST 1982 D 2
+-6 - CST 1981 D 26 2
+-5 - EST 1982 N 2 2
 -6 m C%sT
 Z America/Metlakatla 15:13:42 - LMT 1867 O 19 15:44:55
 -8:46:18 - LMT 1900 Au 20 12
@@ -2713,7 +2709,7 @@ Z America/Metlakatla 15:13:42 - LMT 1867 O 19 15:44:55
 -8 - PST 2019 Ja 20 2
 -9 u AK%sT
 Z America/Mexico_City -6:36:36 - LMT 1922 Ja 1 7u
--7 - MST 1927 Jun 10 23
+-7 - MST 1927 Jun 10
 -6 - CST 1930 N 15
 -7 m M%sT 1932 Ap
 -6 m C%sT 2001 S 30 2
@@ -2721,8 +2717,8 @@ Z America/Mexico_City -6:36:36 - LMT 1922 Ja 1 7u
 -6 m C%sT
 Z America/Miquelon -3:44:40 - LMT 1911 Jun 15
 -4 - AST 1980 May
--3 - -03 1987
--3 C -03/-02
+-3 - %z 1987
+-3 C %z
 Z America/Moncton -4:19:8 - LMT 1883 D 9
 -5 - EST 1902 Jun 15
 -4 C A%sT 1933
@@ -2733,20 +2729,23 @@ Z America/Moncton -4:19:8 - LMT 1883 D 9
 -4 o A%sT 2007
 -4 C A%sT
 Z America/Monterrey -6:41:16 - LMT 1922 Ja 1 6u
+-7 - MST 1927 Jun 10
+-6 - CST 1930 N 15
+-7 m M%sT 1932 Ap
 -6 - CST 1988
 -6 u C%sT 1989
 -6 m C%sT
 Z America/Montevideo -3:44:51 - LMT 1908 Jun 10
 -3:44:51 - MMT 1920 May
--4 - -04 1923 O
--3:30 U -0330/-03 1942 D 14
--3 U -03/-0230 1960
--3 U -03/-02 1968
--3 U -03/-0230 1970
--3 U -03/-02 1974
--3 U -03/-0130 1974 Mar 10
--3 U -03/-0230 1974 D 22
--3 U -03/-02
+-4 - %z 1923 O
+-3:30 U %z 1942 D 14
+-3 U %z 1960
+-3 U %z 1968
+-3 U %z 1970
+-3 U %z 1974
+-3 U %z 1974 Mar 10
+-3 U %z 1974 D 22
+-3 U %z
 Z America/New_York -4:56:2 - LMT 1883 N 18 17u
 -5 u E%sT 1920
 -5 NY E%sT 1942
@@ -2763,12 +2762,12 @@ Z America/Nome 12:58:22 - LMT 1867 O 19 13:29:35
 -9 u Y%sT 1983 N 30
 -9 u AK%sT
 Z America/Noronha -2:9:40 - LMT 1914
--2 B -02/-01 1990 S 17
--2 - -02 1999 S 30
--2 B -02/-01 2000 O 15
--2 - -02 2001 S 13
--2 B -02/-01 2002 O
--2 - -02
+-2 B %z 1990 S 17
+-2 - %z 1999 S 30
+-2 B %z 2000 O 15
+-2 - %z 2001 S 13
+-2 B %z 2002 O
+-2 - %z
 Z America/North_Dakota/Beulah -6:47:7 - LMT 1883 N 18 19u
 -7 u M%sT 2010 N 7 2
 -6 u C%sT
@@ -2779,12 +2778,12 @@ Z America/North_Dakota/New_Salem -6:45:39 - LMT 1883 N 18 19u
 -7 u M%sT 2003 O 26 2
 -6 u C%sT
 Z America/Nuuk -3:26:56 - LMT 1916 Jul 28
--3 - -03 1980 Ap 6 2
--3 E -03/-02 2023 Mar 26 1u
--2 - -02 2023 O 29 1u
--2 E -02/-01
+-3 - %z 1980 Ap 6 2
+-3 E %z 2023 Mar 26 1u
+-2 - %z 2023 O 29 1u
+-2 E %z
 Z America/Ojinaga -6:57:40 - LMT 1922 Ja 1 7u
--7 - MST 1927 Jun 10 23
+-7 - MST 1927 Jun 10
 -6 - CST 1930 N 15
 -7 m M%sT 1932 Ap
 -6 - CST 1996
@@ -2800,8 +2799,8 @@ Z America/Panama -5:18:8 - LMT 1890
 Z America/Paramaribo -3:40:40 - LMT 1911
 -3:40:52 - PMT 1935
 -3:40:36 - PMT 1945 O
--3:30 - -0330 1984 O
--3 - -03
+-3:30 - %z 1984 O
+-3 - %z
 Z America/Phoenix -7:28:18 - LMT 1883 N 18 19u
 -7 u M%sT 1944 Ja 1 0:1
 -7 - MST 1944 Ap 1 0:1
@@ -2813,37 +2812,37 @@ Z America/Port-au-Prince -4:49:20 - LMT 1890
 -4:49 - PPMT 1917 Ja 24 12
 -5 HT E%sT
 Z America/Porto_Velho -4:15:36 - LMT 1914
--4 B -04/-03 1988 S 12
--4 - -04
+-4 B %z 1988 S 12
+-4 - %z
 Z America/Puerto_Rico -4:24:25 - LMT 1899 Mar 28 12
 -4 - AST 1942 May 3
 -4 u A%sT 1946
 -4 - AST
 Z America/Punta_Arenas -4:43:40 - LMT 1890
 -4:42:45 - SMT 1910 Ja 10
--5 - -05 1916 Jul
+-5 - %z 1916 Jul
 -4:42:45 - SMT 1918 S 10
--4 - -04 1919 Jul
+-4 - %z 1919 Jul
 -4:42:45 - SMT 1927 S
--5 x -05/-04 1932 S
--4 - -04 1942 Jun
--5 - -05 1942 Au
--4 - -04 1946 Au 28 24
--5 1 -04 1947 Mar 31 24
--5 - -05 1947 May 21 23
--4 x -04/-03 2016 D 4
--3 - -03
+-5 x %z 1932 S
+-4 - %z 1942 Jun
+-5 - %z 1942 Au
+-4 - %z 1946 Au 28 24
+-5 1 %z 1947 Mar 31 24
+-5 - %z 1947 May 21 23
+-4 x %z 2016 D 4
+-3 - %z
 Z America/Rankin_Inlet 0 - -00 1957
 -6 Y C%sT 2000 O 29 2
 -5 - EST 2001 Ap 1 3
 -6 C C%sT
 Z America/Recife -2:19:36 - LMT 1914
--3 B -03/-02 1990 S 17
--3 - -03 1999 S 30
--3 B -03/-02 2000 O 15
--3 - -03 2001 S 13
--3 B -03/-02 2002 O
--3 - -03
+-3 B %z 1990 S 17
+-3 - %z 1999 S 30
+-3 B %z 2000 O 15
+-3 - %z 2001 S 13
+-3 B %z 2002 O
+-3 - %z
 Z America/Regina -6:58:36 - LMT 1905 S
 -7 r M%sT 1960 Ap lastSu 2
 -6 - CST
@@ -2854,28 +2853,28 @@ Z America/Resolute 0 - -00 1947 Au 31
 -5 - EST 2007 Mar 11 3
 -6 C C%sT
 Z America/Rio_Branco -4:31:12 - LMT 1914
--5 B -05/-04 1988 S 12
--5 - -05 2008 Jun 24
--4 - -04 2013 N 10
--5 - -05
+-5 B %z 1988 S 12
+-5 - %z 2008 Jun 24
+-4 - %z 2013 N 10
+-5 - %z
 Z America/Santarem -3:38:48 - LMT 1914
--4 B -04/-03 1988 S 12
--4 - -04 2008 Jun 24
--3 - -03
+-4 B %z 1988 S 12
+-4 - %z 2008 Jun 24
+-3 - %z
 Z America/Santiago -4:42:45 - LMT 1890
 -4:42:45 - SMT 1910 Ja 10
--5 - -05 1916 Jul
+-5 - %z 1916 Jul
 -4:42:45 - SMT 1918 S 10
--4 - -04 1919 Jul
+-4 - %z 1919 Jul
 -4:42:45 - SMT 1927 S
--5 x -05/-04 1932 S
--4 - -04 1942 Jun
--5 - -05 1942 Au
--4 - -04 1946 Jul 14 24
--4 1 -03 1946 Au 28 24
--5 1 -04 1947 Mar 31 24
--5 - -05 1947 May 21 23
--4 x -04/-03
+-5 x %z 1932 S
+-4 - %z 1942 Jun
+-5 - %z 1942 Au
+-4 - %z 1946 Jul 14 24
+-4 1 %z 1946 Au 28 24
+-5 1 %z 1947 Mar 31 24
+-5 - %z 1947 May 21 23
+-4 x %z
 Z America/Santo_Domingo -4:39:36 - LMT 1890
 -4:40 - SDMT 1933 Ap 1 12
 -5 DO %s 1974 O 27
@@ -2883,14 +2882,14 @@ Z America/Santo_Domingo -4:39:36 - LMT 1890
 -5 u E%sT 2000 D 3 1
 -4 - AST
 Z America/Sao_Paulo -3:6:28 - LMT 1914
--3 B -03/-02 1963 O 23
--3 1 -02 1964
--3 B -03/-02
+-3 B %z 1963 O 23
+-3 1 %z 1964
+-3 B %z
 Z America/Scoresbysund -1:27:52 - LMT 1916 Jul 28
--2 - -02 1980 Ap 6 2
--2 c -02/-01 1981 Mar 29
--1 E -01/+00 2024 Mar 31
--2 E -02/-01
+-2 - %z 1980 Ap 6 2
+-2 c %z 1981 Mar 29
+-1 E %z 2024 Mar 31
+-2 E %z
 Z America/Sitka 14:58:47 - LMT 1867 O 19 15:30
 -9:1:13 - LMT 1900 Au 20 12
 -8 - PST 1942
@@ -2918,15 +2917,21 @@ Z America/Thule -4:35:8 - LMT 1916 Jul 28
 -4 Th A%sT
 Z America/Tijuana -7:48:4 - LMT 1922 Ja 1 7u
 -7 - MST 1924
--8 - PST 1927 Jun 10 23
+-8 - PST 1927 Jun 10
 -7 - MST 1930 N 15
 -8 - PST 1931 Ap
 -8 1 PDT 1931 S 30
 -8 - PST 1942 Ap 24
 -8 1 PWT 1945 Au 14 23u
--8 1 PPT 1945 N 12
+-8 1 PPT 1945 N 15
 -8 - PST 1948 Ap 5
 -8 1 PDT 1949 Ja 14
+-8 - PST 1950 May
+-8 1 PDT 1950 S 24
+-8 - PST 1951 Ap 29 2
+-8 1 PDT 1951 S 30 2
+-8 - PST 1952 Ap 27 2
+-8 1 PDT 1952 S 28 2
 -8 - PST 1954
 -8 CA P%sT 1961
 -8 - PST 1976
@@ -2961,31 +2966,31 @@ Z America/Yakutat 14:41:5 - LMT 1867 O 19 15:12:18
 -9 u Y%sT 1983 N 30
 -9 u AK%sT
 Z Antarctica/Casey 0 - -00 1969
-8 - +08 2009 O 18 2
-11 - +11 2010 Mar 5 2
-8 - +08 2011 O 28 2
-11 - +11 2012 F 21 17u
-8 - +08 2016 O 22
-11 - +11 2018 Mar 11 4
-8 - +08 2018 O 7 4
-11 - +11 2019 Mar 17 3
-8 - +08 2019 O 4 3
-11 - +11 2020 Mar 8 3
-8 - +08 2020 O 4 0:1
-11 - +11 2021 Mar 14
-8 - +08 2021 O 3 0:1
-11 - +11 2022 Mar 13
-8 - +08 2022 O 2 0:1
-11 - +11 2023 Mar 9 3
-8 - +08
+8 - %z 2009 O 18 2
+11 - %z 2010 Mar 5 2
+8 - %z 2011 O 28 2
+11 - %z 2012 F 21 17u
+8 - %z 2016 O 22
+11 - %z 2018 Mar 11 4
+8 - %z 2018 O 7 4
+11 - %z 2019 Mar 17 3
+8 - %z 2019 O 4 3
+11 - %z 2020 Mar 8 3
+8 - %z 2020 O 4 0:1
+11 - %z 2021 Mar 14
+8 - %z 2021 O 3 0:1
+11 - %z 2022 Mar 13
+8 - %z 2022 O 2 0:1
+11 - %z 2023 Mar 9 3
+8 - %z
 Z Antarctica/Davis 0 - -00 1957 Ja 13
-7 - +07 1964 N
+7 - %z 1964 N
 0 - -00 1969 F
-7 - +07 2009 O 18 2
-5 - +05 2010 Mar 10 20u
-7 - +07 2011 O 28 2
-5 - +05 2012 F 21 20u
-7 - +07
+7 - %z 2009 O 18 2
+5 - %z 2010 Mar 10 20u
+7 - %z 2011 O 28 2
+5 - %z 2012 F 21 20u
+7 - %z
 Z Antarctica/Macquarie 0 - -00 1899 N
 10 - AEST 1916 O 1 2
 10 1 AEDT 1917 F
@@ -2996,151 +3001,146 @@ Z Antarctica/Macquarie 0 - -00 1899 N
 10 1 AEDT 2011
 10 AT AE%sT
 Z Antarctica/Mawson 0 - -00 1954 F 13
-6 - +06 2009 O 18 2
-5 - +05
+6 - %z 2009 O 18 2
+5 - %z
 Z Antarctica/Palmer 0 - -00 1965
--4 A -04/-03 1969 O 5
--3 A -03/-02 1982 May
--4 x -04/-03 2016 D 4
--3 - -03
+-4 A %z 1969 O 5
+-3 A %z 1982 May
+-4 x %z 2016 D 4
+-3 - %z
 Z Antarctica/Rothera 0 - -00 1976 D
--3 - -03
+-3 - %z
 Z Antarctica/Troll 0 - -00 2005 F 12
 0 Tr %s
 Z Antarctica/Vostok 0 - -00 1957 D 16
-7 - +07 1994 F
+7 - %z 1994 F
 0 - -00 1994 N
-7 - +07 2023 D 18 2
-5 - +05
+7 - %z 2023 D 18 2
+5 - %z
 Z Asia/Almaty 5:7:48 - LMT 1924 May 2
-5 - +05 1930 Jun 21
-6 R +06/+07 1991 Mar 31 2s
-5 R +05/+06 1992 Ja 19 2s
-6 R +06/+07 2004 O 31 2s
-6 - +06 2024 Mar
-5 - +05
+5 - %z 1930 Jun 21
+6 R %z 1991 Mar 31 2s
+5 R %z 1992 Ja 19 2s
+6 R %z 2004 O 31 2s
+6 - %z 2024 Mar
+5 - %z
 Z Asia/Amman 2:23:44 - LMT 1931
 2 J EE%sT 2022 O 28 0s
-3 - +03
+3 - %z
 Z Asia/Anadyr 11:49:56 - LMT 1924 May 2
-12 - +12 1930 Jun 21
-13 R +13/+14 1982 Ap 1 0s
-12 R +12/+13 1991 Mar 31 2s
-11 R +11/+12 1992 Ja 19 2s
-12 R +12/+13 2010 Mar 28 2s
-11 R +11/+12 2011 Mar 27 2s
-12 - +12
+12 - %z 1930 Jun 21
+13 R %z 1982 Ap 1 0s
+12 R %z 1991 Mar 31 2s
+11 R %z 1992 Ja 19 2s
+12 R %z 2010 Mar 28 2s
+11 R %z 2011 Mar 27 2s
+12 - %z
 Z Asia/Aqtau 3:21:4 - LMT 1924 May 2
-4 - +04 1930 Jun 21
-5 - +05 1981 O
-6 - +06 1982 Ap
-5 R +05/+06 1991 Mar 31 2s
-4 R +04/+05 1992 Ja 19 2s
-5 R +05/+06 1994 S 25 2s
-4 R +04/+05 2004 O 31 2s
-5 - +05
+4 - %z 1930 Jun 21
+5 - %z 1981 O
+6 - %z 1982 Ap
+5 R %z 1991 Mar 31 2s
+4 R %z 1992 Ja 19 2s
+5 R %z 1994 S 25 2s
+4 R %z 2004 O 31 2s
+5 - %z
 Z Asia/Aqtobe 3:48:40 - LMT 1924 May 2
-4 - +04 1930 Jun 21
-5 - +05 1981 Ap
-5 1 +06 1981 O
-6 - +06 1982 Ap
-5 R +05/+06 1991 Mar 31 2s
-4 R +04/+05 1992 Ja 19 2s
-5 R +05/+06 2004 O 31 2s
-5 - +05
+4 - %z 1930 Jun 21
+5 - %z 1981 Ap
+5 1 %z 1981 O
+6 - %z 1982 Ap
+5 R %z 1991 Mar 31 2s
+4 R %z 1992 Ja 19 2s
+5 R %z 2004 O 31 2s
+5 - %z
 Z Asia/Ashgabat 3:53:32 - LMT 1924 May 2
-4 - +04 1930 Jun 21
-5 R +05/+06 1991 Mar 31 2
-4 R +04/+05 1992 Ja 19 2
-5 - +05
+4 - %z 1930 Jun 21
+5 R %z 1991 Mar 31 2
+4 R %z 1992 Ja 19 2
+5 - %z
 Z Asia/Atyrau 3:27:44 - LMT 1924 May 2
-3 - +03 1930 Jun 21
-5 - +05 1981 O
-6 - +06 1982 Ap
-5 R +05/+06 1991 Mar 31 2s
-4 R +04/+05 1992 Ja 19 2s
-5 R +05/+06 1999 Mar 28 2s
-4 R +04/+05 2004 O 31 2s
-5 - +05
+3 - %z 1930 Jun 21
+5 - %z 1981 O
+6 - %z 1982 Ap
+5 R %z 1991 Mar 31 2s
+4 R %z 1992 Ja 19 2s
+5 R %z 1999 Mar 28 2s
+4 R %z 2004 O 31 2s
+5 - %z
 Z Asia/Baghdad 2:57:40 - LMT 1890
 2:57:36 - BMT 1918
-3 - +03 1982 May
-3 IQ +03/+04
+3 - %z 1982 May
+3 IQ %z
 Z Asia/Baku 3:19:24 - LMT 1924 May 2
-3 - +03 1957 Mar
-4 R +04/+05 1991 Mar 31 2s
-3 R +03/+04 1992 S lastSu 2s
-4 - +04 1996
-4 E +04/+05 1997
-4 AZ +04/+05
+3 - %z 1957 Mar
+4 R %z 1991 Mar 31 2s
+3 R %z 1992 S lastSu 2s
+4 - %z 1996
+4 E %z 1997
+4 AZ %z
 Z Asia/Bangkok 6:42:4 - LMT 1880
 6:42:4 - BMT 1920 Ap
-7 - +07
+7 - %z
 Z Asia/Barnaul 5:35 - LMT 1919 D 10
-6 - +06 1930 Jun 21
-7 R +07/+08 1991 Mar 31 2s
-6 R +06/+07 1992 Ja 19 2s
-7 R +07/+08 1995 May 28
-6 R +06/+07 2011 Mar 27 2s
-7 - +07 2014 O 26 2s
-6 - +06 2016 Mar 27 2s
-7 - +07
+6 - %z 1930 Jun 21
+7 R %z 1991 Mar 31 2s
+6 R %z 1992 Ja 19 2s
+7 R %z 1995 May 28
+6 R %z 2011 Mar 27 2s
+7 - %z 2014 O 26 2s
+6 - %z 2016 Mar 27 2s
+7 - %z
 Z Asia/Beirut 2:22 - LMT 1880
 2 l EE%sT
 Z Asia/Bishkek 4:58:24 - LMT 1924 May 2
-5 - +05 1930 Jun 21
-6 R +06/+07 1991 Mar 31 2s
-5 R +05/+06 1991 Au 31 2
-5 KG +05/+06 2005 Au 12
-6 - +06
+5 - %z 1930 Jun 21
+6 R %z 1991 Mar 31 2s
+5 R %z 1991 Au 31 2
+5 KG %z 2005 Au 12
+6 - %z
 Z Asia/Chita 7:33:52 - LMT 1919 D 15
-8 - +08 1930 Jun 21
-9 R +09/+10 1991 Mar 31 2s
-8 R +08/+09 1992 Ja 19 2s
-9 R +09/+10 2011 Mar 27 2s
-10 - +10 2014 O 26 2s
-8 - +08 2016 Mar 27 2
-9 - +09
-Z Asia/Choibalsan 7:38 - LMT 1905 Au
-7 - +07 1978
-8 - +08 1983 Ap
-9 X +09/+10 2008 Mar 31
-8 X +08/+09
+8 - %z 1930 Jun 21
+9 R %z 1991 Mar 31 2s
+8 R %z 1992 Ja 19 2s
+9 R %z 2011 Mar 27 2s
+10 - %z 2014 O 26 2s
+8 - %z 2016 Mar 27 2
+9 - %z
 Z Asia/Colombo 5:19:24 - LMT 1880
 5:19:32 - MMT 1906
-5:30 - +0530 1942 Ja 5
-5:30 0:30 +06 1942 S
-5:30 1 +0630 1945 O 16 2
-5:30 - +0530 1996 May 25
-6:30 - +0630 1996 O 26 0:30
-6 - +06 2006 Ap 15 0:30
-5:30 - +0530
+5:30 - %z 1942 Ja 5
+5:30 0:30 %z 1942 S
+5:30 1 %z 1945 O 16 2
+5:30 - %z 1996 May 25
+6:30 - %z 1996 O 26 0:30
+6 - %z 2006 Ap 15 0:30
+5:30 - %z
 Z Asia/Damascus 2:25:12 - LMT 1920
 2 S EE%sT 2022 O 28
-3 - +03
+3 - %z
 Z Asia/Dhaka 6:1:40 - LMT 1890
 5:53:20 - HMT 1941 O
-6:30 - +0630 1942 May 15
-5:30 - +0530 1942 S
-6:30 - +0630 1951 S 30
-6 - +06 2009
-6 BD +06/+07
-Z Asia/Dili 8:22:20 - LMT 1912
-8 - +08 1942 F 21 23
-9 - +09 1976 May 3
-8 - +08 2000 S 17
-9 - +09
+6:30 - %z 1942 May 15
+5:30 - %z 1942 S
+6:30 - %z 1951 S 30
+6 - %z 2009
+6 BD %z
+Z Asia/Dili 8:22:20 - LMT 1911 D 31 16u
+8 - %z 1942 F 21 23
+9 - %z 1976 May 3
+8 - %z 2000 S 17
+9 - %z
 Z Asia/Dubai 3:41:12 - LMT 1920
-4 - +04
+4 - %z
 Z Asia/Dushanbe 4:35:12 - LMT 1924 May 2
-5 - +05 1930 Jun 21
-6 R +06/+07 1991 Mar 31 2s
-5 1 +06 1991 S 9 2s
-5 - +05
+5 - %z 1930 Jun 21
+6 R %z 1991 Mar 31 2s
+5 1 %z 1991 S 9 2s
+5 - %z
 Z Asia/Famagusta 2:15:48 - LMT 1921 N 14
 2 CY EE%sT 1998 S
 2 E EE%sT 2016 S 8
-3 - +03 2017 O 29 1u
+3 - %z 2017 O 29 1u
 2 E EE%sT
 Z Asia/Gaza 2:17:52 - LMT 1900 O
 2 Z EET/EEST 1948 May 15
@@ -3162,14 +3162,14 @@ Z Asia/Hebron 2:20:23 - LMT 1900 O
 2 P EE%sT
 Z Asia/Ho_Chi_Minh 7:6:30 - LMT 1906 Jul
 7:6:30 - PLMT 1911 May
-7 - +07 1942 D 31 23
-8 - +08 1945 Mar 14 23
-9 - +09 1945 S 1 24
-7 - +07 1947 Ap
-8 - +08 1955 Jul 1 1
-7 - +07 1959 D 31 23
-8 - +08 1975 Jun 13
-7 - +07
+7 - %z 1942 D 31 23
+8 - %z 1945 Mar 14 23
+9 - %z 1945 S 1 24
+7 - %z 1947 Ap
+8 - %z 1955 Jul 1 1
+7 - %z 1959 D 31 23
+8 - %z 1975 Jun 13
+7 - %z
 Z Asia/Hong_Kong 7:36:42 - LMT 1904 O 29 17u
 8 - HKT 1941 Jun 15 3
 8 1 HKST 1941 O 1 4
@@ -3177,96 +3177,96 @@ Z Asia/Hong_Kong 7:36:42 - LMT 1904 O 29 17u
 9 - JST 1945 N 18 2
 8 HK HK%sT
 Z Asia/Hovd 6:6:36 - LMT 1905 Au
-6 - +06 1978
-7 X +07/+08
+6 - %z 1978
+7 X %z
 Z Asia/Irkutsk 6:57:5 - LMT 1880
 6:57:5 - IMT 1920 Ja 25
-7 - +07 1930 Jun 21
-8 R +08/+09 1991 Mar 31 2s
-7 R +07/+08 1992 Ja 19 2s
-8 R +08/+09 2011 Mar 27 2s
-9 - +09 2014 O 26 2s
-8 - +08
+7 - %z 1930 Jun 21
+8 R %z 1991 Mar 31 2s
+7 R %z 1992 Ja 19 2s
+8 R %z 2011 Mar 27 2s
+9 - %z 2014 O 26 2s
+8 - %z
 Z Asia/Jakarta 7:7:12 - LMT 1867 Au 10
 7:7:12 - BMT 1923 D 31 16:40u
-7:20 - +0720 1932 N
-7:30 - +0730 1942 Mar 23
-9 - +09 1945 S 23
-7:30 - +0730 1948 May
-8 - +08 1950 May
-7:30 - +0730 1964
+7:20 - %z 1932 N
+7:30 - %z 1942 Mar 23
+9 - %z 1945 S 23
+7:30 - %z 1948 May
+8 - %z 1950 May
+7:30 - %z 1964
 7 - WIB
 Z Asia/Jayapura 9:22:48 - LMT 1932 N
-9 - +09 1944 S
-9:30 - +0930 1964
+9 - %z 1944 S
+9:30 - %z 1964
 9 - WIT
 Z Asia/Jerusalem 2:20:54 - LMT 1880
 2:20:40 - JMT 1918
 2 Z I%sT
 Z Asia/Kabul 4:36:48 - LMT 1890
-4 - +04 1945
-4:30 - +0430
+4 - %z 1945
+4:30 - %z
 Z Asia/Kamchatka 10:34:36 - LMT 1922 N 10
-11 - +11 1930 Jun 21
-12 R +12/+13 1991 Mar 31 2s
-11 R +11/+12 1992 Ja 19 2s
-12 R +12/+13 2010 Mar 28 2s
-11 R +11/+12 2011 Mar 27 2s
-12 - +12
+11 - %z 1930 Jun 21
+12 R %z 1991 Mar 31 2s
+11 R %z 1992 Ja 19 2s
+12 R %z 2010 Mar 28 2s
+11 R %z 2011 Mar 27 2s
+12 - %z
 Z Asia/Karachi 4:28:12 - LMT 1907
-5:30 - +0530 1942 S
-5:30 1 +0630 1945 O 15
-5:30 - +0530 1951 S 30
-5 - +05 1971 Mar 26
+5:30 - %z 1942 S
+5:30 1 %z 1945 O 15
+5:30 - %z 1951 S 30
+5 - %z 1971 Mar 26
 5 PK PK%sT
 Z Asia/Kathmandu 5:41:16 - LMT 1920
-5:30 - +0530 1986
-5:45 - +0545
+5:30 - %z 1986
+5:45 - %z
 Z Asia/Khandyga 9:2:13 - LMT 1919 D 15
-8 - +08 1930 Jun 21
-9 R +09/+10 1991 Mar 31 2s
-8 R +08/+09 1992 Ja 19 2s
-9 R +09/+10 2004
-10 R +10/+11 2011 Mar 27 2s
-11 - +11 2011 S 13 0s
-10 - +10 2014 O 26 2s
-9 - +09
+8 - %z 1930 Jun 21
+9 R %z 1991 Mar 31 2s
+8 R %z 1992 Ja 19 2s
+9 R %z 2004
+10 R %z 2011 Mar 27 2s
+11 - %z 2011 S 13 0s
+10 - %z 2014 O 26 2s
+9 - %z
 Z Asia/Kolkata 5:53:28 - LMT 1854 Jun 28
 5:53:20 - HMT 1870
 5:21:10 - MMT 1906
 5:30 - IST 1941 O
-5:30 1 +0630 1942 May 15
+5:30 1 %z 1942 May 15
 5:30 - IST 1942 S
-5:30 1 +0630 1945 O 15
+5:30 1 %z 1945 O 15
 5:30 - IST
 Z Asia/Krasnoyarsk 6:11:26 - LMT 1920 Ja 6
-6 - +06 1930 Jun 21
-7 R +07/+08 1991 Mar 31 2s
-6 R +06/+07 1992 Ja 19 2s
-7 R +07/+08 2011 Mar 27 2s
-8 - +08 2014 O 26 2s
-7 - +07
+6 - %z 1930 Jun 21
+7 R %z 1991 Mar 31 2s
+6 R %z 1992 Ja 19 2s
+7 R %z 2011 Mar 27 2s
+8 - %z 2014 O 26 2s
+7 - %z
 Z Asia/Kuching 7:21:20 - LMT 1926 Mar
-7:30 - +0730 1933
-8 NB +08/+0820 1942 F 16
-9 - +09 1945 S 12
-8 - +08
+7:30 - %z 1933
+8 NB %z 1942 F 16
+9 - %z 1945 S 12
+8 - %z
 Z Asia/Macau 7:34:10 - LMT 1904 O 30
 8 - CST 1941 D 21 23
-9 _ +09/+10 1945 S 30 24
+9 _ %z 1945 S 30 24
 8 _ C%sT
 Z Asia/Magadan 10:3:12 - LMT 1924 May 2
-10 - +10 1930 Jun 21
-11 R +11/+12 1991 Mar 31 2s
-10 R +10/+11 1992 Ja 19 2s
-11 R +11/+12 2011 Mar 27 2s
-12 - +12 2014 O 26 2s
-10 - +10 2016 Ap 24 2s
-11 - +11
+10 - %z 1930 Jun 21
+11 R %z 1991 Mar 31 2s
+10 R %z 1992 Ja 19 2s
+11 R %z 2011 Mar 27 2s
+12 - %z 2014 O 26 2s
+10 - %z 2016 Ap 24 2s
+11 - %z
 Z Asia/Makassar 7:57:36 - LMT 1920
 7:57:36 - MMT 1932 N
-8 - +08 1942 F 9
-9 - +09 1945 S 23
+8 - %z 1942 F 9
+9 - %z 1945 S 23
 8 - WITA
 Z Asia/Manila -15:56 - LMT 1844 D 31
 8:4 - LMT 1899 May 11
@@ -3277,45 +3277,45 @@ Z Asia/Nicosia 2:13:28 - LMT 1921 N 14
 2 CY EE%sT 1998 S
 2 E EE%sT
 Z Asia/Novokuznetsk 5:48:48 - LMT 1924 May
-6 - +06 1930 Jun 21
-7 R +07/+08 1991 Mar 31 2s
-6 R +06/+07 1992 Ja 19 2s
-7 R +07/+08 2010 Mar 28 2s
-6 R +06/+07 2011 Mar 27 2s
-7 - +07
+6 - %z 1930 Jun 21
+7 R %z 1991 Mar 31 2s
+6 R %z 1992 Ja 19 2s
+7 R %z 2010 Mar 28 2s
+6 R %z 2011 Mar 27 2s
+7 - %z
 Z Asia/Novosibirsk 5:31:40 - LMT 1919 D 14 6
-6 - +06 1930 Jun 21
-7 R +07/+08 1991 Mar 31 2s
-6 R +06/+07 1992 Ja 19 2s
-7 R +07/+08 1993 May 23
-6 R +06/+07 2011 Mar 27 2s
-7 - +07 2014 O 26 2s
-6 - +06 2016 Jul 24 2s
-7 - +07
+6 - %z 1930 Jun 21
+7 R %z 1991 Mar 31 2s
+6 R %z 1992 Ja 19 2s
+7 R %z 1993 May 23
+6 R %z 2011 Mar 27 2s
+7 - %z 2014 O 26 2s
+6 - %z 2016 Jul 24 2s
+7 - %z
 Z Asia/Omsk 4:53:30 - LMT 1919 N 14
-5 - +05 1930 Jun 21
-6 R +06/+07 1991 Mar 31 2s
-5 R +05/+06 1992 Ja 19 2s
-6 R +06/+07 2011 Mar 27 2s
-7 - +07 2014 O 26 2s
-6 - +06
+5 - %z 1930 Jun 21
+6 R %z 1991 Mar 31 2s
+5 R %z 1992 Ja 19 2s
+6 R %z 2011 Mar 27 2s
+7 - %z 2014 O 26 2s
+6 - %z
 Z Asia/Oral 3:25:24 - LMT 1924 May 2
-3 - +03 1930 Jun 21
-5 - +05 1981 Ap
-5 1 +06 1981 O
-6 - +06 1982 Ap
-5 R +05/+06 1989 Mar 26 2s
-4 R +04/+05 1992 Ja 19 2s
-5 R +05/+06 1992 Mar 29 2s
-4 R +04/+05 2004 O 31 2s
-5 - +05
+3 - %z 1930 Jun 21
+5 - %z 1981 Ap
+5 1 %z 1981 O
+6 - %z 1982 Ap
+5 R %z 1989 Mar 26 2s
+4 R %z 1992 Ja 19 2s
+5 R %z 1992 Mar 29 2s
+4 R %z 2004 O 31 2s
+5 - %z
 Z Asia/Pontianak 7:17:20 - LMT 1908 May
 7:17:20 - PMT 1932 N
-7:30 - +0730 1942 Ja 29
-9 - +09 1945 S 23
-7:30 - +0730 1948 May
-8 - +08 1950 May
-7:30 - +0730 1964
+7:30 - %z 1942 Ja 29
+9 - %z 1945 S 23
+7:30 - %z 1948 May
+8 - %z 1950 May
+7:30 - %z 1964
 8 - WITA 1988
 7 - WIB
 Z Asia/Pyongyang 8:23 - LMT 1908 Ap
@@ -3325,48 +3325,48 @@ Z Asia/Pyongyang 8:23 - LMT 1908 Ap
 8:30 - KST 2018 May 4 23:30
 9 - KST
 Z Asia/Qatar 3:26:8 - LMT 1920
-4 - +04 1972 Jun
-3 - +03
+4 - %z 1972 Jun
+3 - %z
 Z Asia/Qostanay 4:14:28 - LMT 1924 May 2
-4 - +04 1930 Jun 21
-5 - +05 1981 Ap
-5 1 +06 1981 O
-6 - +06 1982 Ap
-5 R +05/+06 1991 Mar 31 2s
-4 R +04/+05 1992 Ja 19 2s
-5 R +05/+06 2004 O 31 2s
-6 - +06 2024 Mar
-5 - +05
+4 - %z 1930 Jun 21
+5 - %z 1981 Ap
+5 1 %z 1981 O
+6 - %z 1982 Ap
+5 R %z 1991 Mar 31 2s
+4 R %z 1992 Ja 19 2s
+5 R %z 2004 O 31 2s
+6 - %z 2024 Mar
+5 - %z
 Z Asia/Qyzylorda 4:21:52 - LMT 1924 May 2
-4 - +04 1930 Jun 21
-5 - +05 1981 Ap
-5 1 +06 1981 O
-6 - +06 1982 Ap
-5 R +05/+06 1991 Mar 31 2s
-4 R +04/+05 1991 S 29 2s
-5 R +05/+06 1992 Ja 19 2s
-6 R +06/+07 1992 Mar 29 2s
-5 R +05/+06 2004 O 31 2s
-6 - +06 2018 D 21
-5 - +05
+4 - %z 1930 Jun 21
+5 - %z 1981 Ap
+5 1 %z 1981 O
+6 - %z 1982 Ap
+5 R %z 1991 Mar 31 2s
+4 R %z 1991 S 29 2s
+5 R %z 1992 Ja 19 2s
+6 R %z 1992 Mar 29 2s
+5 R %z 2004 O 31 2s
+6 - %z 2018 D 21
+5 - %z
 Z Asia/Riyadh 3:6:52 - LMT 1947 Mar 14
-3 - +03
+3 - %z
 Z Asia/Sakhalin 9:30:48 - LMT 1905 Au 23
-9 - +09 1945 Au 25
-11 R +11/+12 1991 Mar 31 2s
-10 R +10/+11 1992 Ja 19 2s
-11 R +11/+12 1997 Mar lastSu 2s
-10 R +10/+11 2011 Mar 27 2s
-11 - +11 2014 O 26 2s
-10 - +10 2016 Mar 27 2s
-11 - +11
+9 - %z 1945 Au 25
+11 R %z 1991 Mar 31 2s
+10 R %z 1992 Ja 19 2s
+11 R %z 1997 Mar lastSu 2s
+10 R %z 2011 Mar 27 2s
+11 - %z 2014 O 26 2s
+10 - %z 2016 Mar 27 2s
+11 - %z
 Z Asia/Samarkand 4:27:53 - LMT 1924 May 2
-4 - +04 1930 Jun 21
-5 - +05 1981 Ap
-5 1 +06 1981 O
-6 - +06 1982 Ap
-5 R +05/+06 1992
-5 - +05
+4 - %z 1930 Jun 21
+5 - %z 1981 Ap
+5 1 %z 1981 O
+6 - %z 1982 Ap
+5 R %z 1992
+5 - %z
 Z Asia/Seoul 8:27:52 - LMT 1908 Ap
 8:30 - KST 1912
 9 - JST 1945 S 8
@@ -3378,161 +3378,147 @@ Z Asia/Shanghai 8:5:43 - LMT 1901
 8 CN C%sT
 Z Asia/Singapore 6:55:25 - LMT 1901
 6:55:25 - SMT 1905 Jun
-7 - +07 1933
-7 0:20 +0720 1936
-7:20 - +0720 1941 S
-7:30 - +0730 1942 F 16
-9 - +09 1945 S 12
-7:30 - +0730 1981 D 31 16u
-8 - +08
+7 - %z 1933
+7 0:20 %z 1936
+7:20 - %z 1941 S
+7:30 - %z 1942 F 16
+9 - %z 1945 S 12
+7:30 - %z 1981 D 31 16u
+8 - %z
 Z Asia/Srednekolymsk 10:14:52 - LMT 1924 May 2
-10 - +10 1930 Jun 21
-11 R +11/+12 1991 Mar 31 2s
-10 R +10/+11 1992 Ja 19 2s
-11 R +11/+12 2011 Mar 27 2s
-12 - +12 2014 O 26 2s
-11 - +11
+10 - %z 1930 Jun 21
+11 R %z 1991 Mar 31 2s
+10 R %z 1992 Ja 19 2s
+11 R %z 2011 Mar 27 2s
+12 - %z 2014 O 26 2s
+11 - %z
 Z Asia/Taipei 8:6 - LMT 1896
 8 - CST 1937 O
 9 - JST 1945 S 21 1
 8 f C%sT
 Z Asia/Tashkent 4:37:11 - LMT 1924 May 2
-5 - +05 1930 Jun 21
-6 R +06/+07 1991 Mar 31 2
-5 R +05/+06 1992
-5 - +05
+5 - %z 1930 Jun 21
+6 R %z 1991 Mar 31 2
+5 R %z 1992
+5 - %z
 Z Asia/Tbilisi 2:59:11 - LMT 1880
 2:59:11 - TBMT 1924 May 2
-3 - +03 1957 Mar
-4 R +04/+05 1991 Mar 31 2s
-3 R +03/+04 1992
-3 e +03/+04 1994 S lastSu
-4 e +04/+05 1996 O lastSu
-4 1 +05 1997 Mar lastSu
-4 e +04/+05 2004 Jun 27
-3 R +03/+04 2005 Mar lastSu 2
-4 - +04
+3 - %z 1957 Mar
+4 R %z 1991 Mar 31 2s
+3 R %z 1992
+3 e %z 1994 S lastSu
+4 e %z 1996 O lastSu
+4 1 %z 1997 Mar lastSu
+4 e %z 2004 Jun 27
+3 R %z 2005 Mar lastSu 2
+4 - %z
 Z Asia/Tehran 3:25:44 - LMT 1916
 3:25:44 - TMT 1935 Jun 13
-3:30 i +0330/+0430 1977 O 20 24
-4 i +04/+05 1979
-3:30 i +0330/+0430
+3:30 i %z 1977 O 20 24
+4 i %z 1979
+3:30 i %z
 Z Asia/Thimphu 5:58:36 - LMT 1947 Au 15
-5:30 - +0530 1987 O
-6 - +06
+5:30 - %z 1987 O
+6 - %z
 Z Asia/Tokyo 9:18:59 - LMT 1887 D 31 15u
 9 JP J%sT
 Z Asia/Tomsk 5:39:51 - LMT 1919 D 22
-6 - +06 1930 Jun 21
-7 R +07/+08 1991 Mar 31 2s
-6 R +06/+07 1992 Ja 19 2s
-7 R +07/+08 2002 May 1 3
-6 R +06/+07 2011 Mar 27 2s
-7 - +07 2014 O 26 2s
-6 - +06 2016 May 29 2s
-7 - +07
+6 - %z 1930 Jun 21
+7 R %z 1991 Mar 31 2s
+6 R %z 1992 Ja 19 2s
+7 R %z 2002 May 1 3
+6 R %z 2011 Mar 27 2s
+7 - %z 2014 O 26 2s
+6 - %z 2016 May 29 2s
+7 - %z
 Z Asia/Ulaanbaatar 7:7:32 - LMT 1905 Au
-7 - +07 1978
-8 X +08/+09
+7 - %z 1978
+8 X %z
 Z Asia/Urumqi 5:50:20 - LMT 1928
-6 - +06
+6 - %z
 Z Asia/Ust-Nera 9:32:54 - LMT 1919 D 15
-8 - +08 1930 Jun 21
-9 R +09/+10 1981 Ap
-11 R +11/+12 1991 Mar 31 2s
-10 R +10/+11 1992 Ja 19 2s
-11 R +11/+12 2011 Mar 27 2s
-12 - +12 2011 S 13 0s
-11 - +11 2014 O 26 2s
-10 - +10
+8 - %z 1930 Jun 21
+9 R %z 1981 Ap
+11 R %z 1991 Mar 31 2s
+10 R %z 1992 Ja 19 2s
+11 R %z 2011 Mar 27 2s
+12 - %z 2011 S 13 0s
+11 - %z 2014 O 26 2s
+10 - %z
 Z Asia/Vladivostok 8:47:31 - LMT 1922 N 15
-9 - +09 1930 Jun 21
-10 R +10/+11 1991 Mar 31 2s
-9 R +09/+10 1992 Ja 19 2s
-10 R +10/+11 2011 Mar 27 2s
-11 - +11 2014 O 26 2s
-10 - +10
+9 - %z 1930 Jun 21
+10 R %z 1991 Mar 31 2s
+9 R %z 1992 Ja 19 2s
+10 R %z 2011 Mar 27 2s
+11 - %z 2014 O 26 2s
+10 - %z
 Z Asia/Yakutsk 8:38:58 - LMT 1919 D 15
-8 - +08 1930 Jun 21
-9 R +09/+10 1991 Mar 31 2s
-8 R +08/+09 1992 Ja 19 2s
-9 R +09/+10 2011 Mar 27 2s
-10 - +10 2014 O 26 2s
-9 - +09
+8 - %z 1930 Jun 21
+9 R %z 1991 Mar 31 2s
+8 R %z 1992 Ja 19 2s
+9 R %z 2011 Mar 27 2s
+10 - %z 2014 O 26 2s
+9 - %z
 Z Asia/Yangon 6:24:47 - LMT 1880
 6:24:47 - RMT 1920
-6:30 - +0630 1942 May
-9 - +09 1945 May 3
-6:30 - +0630
+6:30 - %z 1942 May
+9 - %z 1945 May 3
+6:30 - %z
 Z Asia/Yekaterinburg 4:2:33 - LMT 1916 Jul 3
 3:45:5 - PMT 1919 Jul 15 4
-4 - +04 1930 Jun 21
-5 R +05/+06 1991 Mar 31 2s
-4 R +04/+05 1992 Ja 19 2s
-5 R +05/+06 2011 Mar 27 2s
-6 - +06 2014 O 26 2s
-5 - +05
+4 - %z 1930 Jun 21
+5 R %z 1991 Mar 31 2s
+4 R %z 1992 Ja 19 2s
+5 R %z 2011 Mar 27 2s
+6 - %z 2014 O 26 2s
+5 - %z
 Z Asia/Yerevan 2:58 - LMT 1924 May 2
-3 - +03 1957 Mar
-4 R +04/+05 1991 Mar 31 2s
-3 R +03/+04 1995 S 24 2s
-4 - +04 1997
-4 R +04/+05 2011
-4 AM +04/+05
+3 - %z 1957 Mar
+4 R %z 1991 Mar 31 2s
+3 R %z 1995 S 24 2s
+4 - %z 1997
+4 R %z 2011
+4 AM %z
 Z Atlantic/Azores -1:42:40 - LMT 1884
 -1:54:32 - HMT 1912 Ja 1 2u
--2 p -02/-01 1942 Ap 25 22s
--2 p +00 1942 Au 15 22s
--2 p -02/-01 1943 Ap 17 22s
--2 p +00 1943 Au 28 22s
--2 p -02/-01 1944 Ap 22 22s
--2 p +00 1944 Au 26 22s
--2 p -02/-01 1945 Ap 21 22s
--2 p +00 1945 Au 25 22s
--2 p -02/-01 1966 Ap 3 2
--1 p -01/+00 1983 S 25 1s
--1 W- -01/+00 1992 S 27 1s
-0 E WE%sT 1993 Mar 28 1u
--1 E -01/+00
+-2 p %z 1966 O 2 2s
+-1 - %z 1982 Mar 28 0s
+-1 p %z 1986
+-1 E %z 1992 D 27 1s
+0 E WE%sT 1993 Jun 17 1u
+-1 E %z
 Z Atlantic/Bermuda -4:19:18 - LMT 1890
 -4:19:18 Be BMT/BST 1930 Ja 1 2
 -4 Be A%sT 1974 Ap 28 2
 -4 C A%sT 1976
 -4 u A%sT
 Z Atlantic/Canary -1:1:36 - LMT 1922 Mar
--1 - -01 1946 S 30 1
+-1 - %z 1946 S 30 1
 0 - WET 1980 Ap 6 0s
 0 1 WEST 1980 S 28 1u
 0 E WE%sT
 Z Atlantic/Cape_Verde -1:34:4 - LMT 1912 Ja 1 2u
--2 - -02 1942 S
--2 1 -01 1945 O 15
--2 - -02 1975 N 25 2
--1 - -01
+-2 - %z 1942 S
+-2 1 %z 1945 O 15
+-2 - %z 1975 N 25 2
+-1 - %z
 Z Atlantic/Faroe -0:27:4 - LMT 1908 Ja 11
 0 - WET 1981
 0 E WE%sT
 Z Atlantic/Madeira -1:7:36 - LMT 1884
 -1:7:36 - FMT 1912 Ja 1 1u
--1 p -01/+00 1942 Ap 25 22s
--1 p +01 1942 Au 15 22s
--1 p -01/+00 1943 Ap 17 22s
--1 p +01 1943 Au 28 22s
--1 p -01/+00 1944 Ap 22 22s
--1 p +01 1944 Au 26 22s
--1 p -01/+00 1945 Ap 21 22s
--1 p +01 1945 Au 25 22s
--1 p -01/+00 1966 Ap 3 2
-0 p WE%sT 1983 S 25 1s
+-1 p %z 1966 O 2 2s
+0 - WET 1982 Ap 4
+0 p WE%sT 1986 Jul 31
 0 E WE%sT
 Z Atlantic/South_Georgia -2:26:8 - LMT 1890
--2 - -02
+-2 - %z
 Z Atlantic/Stanley -3:51:24 - LMT 1890
 -3:51:24 - SMT 1912 Mar 12
--4 FK -04/-03 1983 May
--3 FK -03/-02 1985 S 15
--4 FK -04/-03 2010 S 5 2
--3 - -03
+-4 FK %z 1983 May
+-3 FK %z 1985 S 15
+-4 FK %z 2010 S 5 2
+-3 - %z
 Z Australia/Adelaide 9:14:20 - LMT 1895 F
 9 - ACST 1899 May
 9:30 AU AC%sT 1971
@@ -3550,8 +3536,8 @@ Z Australia/Darwin 8:43:20 - LMT 1895 F
 9 - ACST 1899 May
 9:30 AU AC%sT
 Z Australia/Eucla 8:35:28 - LMT 1895 D
-8:45 AU +0845/+0945 1943 Jul
-8:45 AW +0845/+0945
+8:45 AU %z 1943 Jul
+8:45 AW %z
 Z Australia/Hobart 9:49:16 - LMT 1895 S
 10 AT AE%sT 1919 O 24
 10 AU AE%sT 1967
@@ -3562,8 +3548,8 @@ Z Australia/Lindeman 9:55:56 - LMT 1895
 10 Ho AE%sT
 Z Australia/Lord_Howe 10:36:20 - LMT 1895 F
 10 - AEST 1981 Mar
-10:30 LH +1030/+1130 1985 Jul
-10:30 LH +1030/+11
+10:30 LH %z 1985 Jul
+10:30 LH %z
 Z Australia/Melbourne 9:39:52 - LMT 1895 F
 10 AU AE%sT 1971
 10 AV AE%sT
@@ -3573,52 +3559,47 @@ Z Australia/Perth 7:43:24 - LMT 1895 D
 Z Australia/Sydney 10:4:52 - LMT 1895 F
 10 AU AE%sT 1971
 10 AN AE%sT
-Z CET 1 c CE%sT
-Z CST6CDT -6 u C%sT
-Z EET 2 E EE%sT
-Z EST -5 - EST
-Z EST5EDT -5 u E%sT
 Z Etc/GMT 0 - GMT
-Z Etc/GMT+1 -1 - -01
-Z Etc/GMT+10 -10 - -10
-Z Etc/GMT+11 -11 - -11
-Z Etc/GMT+12 -12 - -12
-Z Etc/GMT+2 -2 - -02
-Z Etc/GMT+3 -3 - -03
-Z Etc/GMT+4 -4 - -04
-Z Etc/GMT+5 -5 - -05
-Z Etc/GMT+6 -6 - -06
-Z Etc/GMT+7 -7 - -07
-Z Etc/GMT+8 -8 - -08
-Z Etc/GMT+9 -9 - -09
-Z Etc/GMT-1 1 - +01
-Z Etc/GMT-10 10 - +10
-Z Etc/GMT-11 11 - +11
-Z Etc/GMT-12 12 - +12
-Z Etc/GMT-13 13 - +13
-Z Etc/GMT-14 14 - +14
-Z Etc/GMT-2 2 - +02
-Z Etc/GMT-3 3 - +03
-Z Etc/GMT-4 4 - +04
-Z Etc/GMT-5 5 - +05
-Z Etc/GMT-6 6 - +06
-Z Etc/GMT-7 7 - +07
-Z Etc/GMT-8 8 - +08
-Z Etc/GMT-9 9 - +09
+Z Etc/GMT+1 -1 - %z
+Z Etc/GMT+10 -10 - %z
+Z Etc/GMT+11 -11 - %z
+Z Etc/GMT+12 -12 - %z
+Z Etc/GMT+2 -2 - %z
+Z Etc/GMT+3 -3 - %z
+Z Etc/GMT+4 -4 - %z
+Z Etc/GMT+5 -5 - %z
+Z Etc/GMT+6 -6 - %z
+Z Etc/GMT+7 -7 - %z
+Z Etc/GMT+8 -8 - %z
+Z Etc/GMT+9 -9 - %z
+Z Etc/GMT-1 1 - %z
+Z Etc/GMT-10 10 - %z
+Z Etc/GMT-11 11 - %z
+Z Etc/GMT-12 12 - %z
+Z Etc/GMT-13 13 - %z
+Z Etc/GMT-14 14 - %z
+Z Etc/GMT-2 2 - %z
+Z Etc/GMT-3 3 - %z
+Z Etc/GMT-4 4 - %z
+Z Etc/GMT-5 5 - %z
+Z Etc/GMT-6 6 - %z
+Z Etc/GMT-7 7 - %z
+Z Etc/GMT-8 8 - %z
+Z Etc/GMT-9 9 - %z
 Z Etc/UTC 0 - UTC
 Z Europe/Andorra 0:6:4 - LMT 1901
 0 - WET 1946 S 30
 1 - CET 1985 Mar 31 2
 1 E CE%sT
 Z Europe/Astrakhan 3:12:12 - LMT 1924 May
-3 - +03 1930 Jun 21
-4 R +04/+05 1989 Mar 26 2s
-3 R +03/+04 1991 Mar 31 2s
-4 - +04 1992 Mar 29 2s
-3 R +03/+04 2011 Mar 27 2s
-4 - +04 2014 O 26 2s
-3 - +03 2016 Mar 27 2s
-4 - +04
+3 - %z 1930 Jun 21
+4 R %z 1989 Mar 26 2s
+3 R %z 1991 Mar 31 2s
+4 - %z 1992 Mar 29 2s
+3 R %z 2011 Mar 27 2s
+4 - %z 2014 O 26 2s
+3 - %z 2016 Mar 27 2s
+4 - %z
 Z Europe/Athens 1:34:52 - LMT 1895 S 14
 1:34:52 - AMT 1916 Jul 28 0:1
 2 g EE%sT 1941 Ap 30
@@ -3691,7 +3672,7 @@ Z Europe/Helsinki 1:39:49 - LMT 1878 May 31
 Z Europe/Istanbul 1:55:52 - LMT 1880
 1:56:56 - IMT 1910 O
 2 T EE%sT 1978 Jun 29
-3 T +03/+04 1984 N 1 2
+3 T %z 1984 N 1 2
 2 T EE%sT 2007
 2 E EE%sT 2011 Mar 27 1u
 2 - EET 2011 Mar 28 1u
@@ -3700,19 +3681,19 @@ Z Europe/Istanbul 1:55:52 - LMT 1880
 2 E EE%sT 2015 O 25 1u
 2 1 EEST 2015 N 8 1u
 2 E EE%sT 2016 S 7
-3 - +03
+3 - %z
 Z Europe/Kaliningrad 1:22 - LMT 1893 Ap
 1 c CE%sT 1945 Ap 10
 2 O EE%sT 1946 Ap 7
 3 R MSK/MSD 1989 Mar 26 2s
 2 R EE%sT 2011 Mar 27 2s
-3 - +03 2014 O 26 2s
+3 - %z 2014 O 26 2s
 2 - EET
 Z Europe/Kirov 3:18:48 - LMT 1919 Jul 1 0u
-3 - +03 1930 Jun 21
-4 R +04/+05 1989 Mar 26 2s
+3 - %z 1930 Jun 21
+4 R %z 1989 Mar 26 2s
 3 R MSK/MSD 1991 Mar 31 2s
-4 - +04 1992 Mar 29 2s
+4 - %z 1992 Mar 29 2s
 3 R MSK/MSD 2011 Mar 27 2s
 4 - MSK 2014 O 26 2s
 3 - MSK
@@ -3727,10 +3708,10 @@ Z Europe/Kyiv 2:2:4 - LMT 1880
 2 E EE%sT
 Z Europe/Lisbon -0:36:45 - LMT 1884
 -0:36:45 - LMT 1912 Ja 1 0u
-0 p WE%sT 1966 Ap 3 2
+0 p WE%sT 1966 O 2 2s
 1 - CET 1976 S 26 1
-0 p WE%sT 1983 S 25 1s
-0 W- WE%sT 1992 S 27 1s
+0 p WE%sT 1986
+0 E WE%sT 1992 S 27 1u
 1 E CE%sT 1996 Mar 31 1u
 0 E WE%sT
 Z Europe/London -0:1:15 - LMT 1847 D
@@ -3754,7 +3735,7 @@ Z Europe/Minsk 1:50:16 - LMT 1880
 3 R MSK/MSD 1990
 3 - MSK 1991 Mar 31 2s
 2 R EE%sT 2011 Mar 27 2s
-3 - +03
+3 - %z
 Z Europe/Moscow 2:30:17 - LMT 1880
 2:30:17 - MMT 1916 Jul 3
 2:31:19 R %s 1919 Jul 1 0u
@@ -3802,24 +3783,24 @@ Z Europe/Rome 0:49:56 - LMT 1866 D 12
 1 I CE%sT 1980
 1 E CE%sT
 Z Europe/Samara 3:20:20 - LMT 1919 Jul 1 0u
-3 - +03 1930 Jun 21
-4 - +04 1935 Ja 27
-4 R +04/+05 1989 Mar 26 2s
-3 R +03/+04 1991 Mar 31 2s
-2 R +02/+03 1991 S 29 2s
-3 - +03 1991 O 20 3
-4 R +04/+05 2010 Mar 28 2s
-3 R +03/+04 2011 Mar 27 2s
-4 - +04
+3 - %z 1930 Jun 21
+4 - %z 1935 Ja 27
+4 R %z 1989 Mar 26 2s
+3 R %z 1991 Mar 31 2s
+2 R %z 1991 S 29 2s
+3 - %z 1991 O 20 3
+4 R %z 2010 Mar 28 2s
+3 R %z 2011 Mar 27 2s
+4 - %z
 Z Europe/Saratov 3:4:18 - LMT 1919 Jul 1 0u
-3 - +03 1930 Jun 21
-4 R +04/+05 1988 Mar 27 2s
-3 R +03/+04 1991 Mar 31 2s
-4 - +04 1992 Mar 29 2s
-3 R +03/+04 2011 Mar 27 2s
-4 - +04 2014 O 26 2s
-3 - +03 2016 D 4 2s
-4 - +04
+3 - %z 1930 Jun 21
+4 R %z 1988 Mar 27 2s
+3 R %z 1991 Mar 31 2s
+4 - %z 1992 Mar 29 2s
+3 R %z 2011 Mar 27 2s
+4 - %z 2014 O 26 2s
+3 - %z 2016 D 4 2s
+4 - %z
 Z Europe/Simferopol 2:16:24 - LMT 1880
 2:16 - SMT 1924 May 2
 2 - EET 1930 Jun 21
@@ -3863,14 +3844,14 @@ Z Europe/Tirane 1:19:20 - LMT 1914
 1 q CE%sT 1984 Jul
 1 E CE%sT
 Z Europe/Ulyanovsk 3:13:36 - LMT 1919 Jul 1 0u
-3 - +03 1930 Jun 21
-4 R +04/+05 1989 Mar 26 2s
-3 R +03/+04 1991 Mar 31 2s
-2 R +02/+03 1992 Ja 19 2s
-3 R +03/+04 2011 Mar 27 2s
-4 - +04 2014 O 26 2s
-3 - +03 2016 Mar 27 2s
-4 - +04
+3 - %z 1930 Jun 21
+4 R %z 1989 Mar 26 2s
+3 R %z 1991 Mar 31 2s
+2 R %z 1992 Ja 19 2s
+3 R %z 2011 Mar 27 2s
+4 - %z 2014 O 26 2s
+3 - %z 2016 Mar 27 2s
+4 - %z
 Z Europe/Vienna 1:5:21 - LMT 1893 Ap
 1 c CE%sT 1920
 1 a CE%sT 1940 Ap 1 2s
@@ -3895,15 +3876,15 @@ Z Europe/Vilnius 1:41:16 - LMT 1880
 2 - EET 2003
 2 E EE%sT
 Z Europe/Volgograd 2:57:40 - LMT 1920 Ja 3
-3 - +03 1930 Jun 21
-4 - +04 1961 N 11
-4 R +04/+05 1988 Mar 27 2s
+3 - %z 1930 Jun 21
+4 - %z 1961 N 11
+4 R %z 1988 Mar 27 2s
 3 R MSK/MSD 1991 Mar 31 2s
-4 - +04 1992 Mar 29 2s
+4 - %z 1992 Mar 29 2s
 3 R MSK/MSD 2011 Mar 27 2s
 4 - MSK 2014 O 26 2s
 3 - MSK 2018 O 28 2s
-4 - +04 2020 D 27 2s
+4 - %z 2020 D 27 2s
 3 - MSK
 Z Europe/Warsaw 1:24 - LMT 1880
 1:24 - WMT 1915 Au 5
@@ -3919,58 +3900,53 @@ Z Europe/Zurich 0:34:8 - LMT 1853 Jul 16
 1 CH CE%sT 1981
 1 E CE%sT
 Z Factory 0 - -00
-Z HST -10 - HST
 Z Indian/Chagos 4:49:40 - LMT 1907
-5 - +05 1996
-6 - +06
+5 - %z 1996
+6 - %z
 Z Indian/Maldives 4:54 - LMT 1880
 4:54 - MMT 1960
-5 - +05
+5 - %z
 Z Indian/Mauritius 3:50 - LMT 1907
-4 MU +04/+05
-Z MET 1 c ME%sT
-Z MST -7 - MST
-Z MST7MDT -7 u M%sT
-Z PST8PDT -8 u P%sT
+4 MU %z
 Z Pacific/Apia 12:33:4 - LMT 1892 Jul 5
 -11:26:56 - LMT 1911
--11:30 - -1130 1950
--11 WS -11/-10 2011 D 29 24
-13 WS +13/+14
+-11:30 - %z 1950
+-11 WS %z 2011 D 29 24
+13 WS %z
 Z Pacific/Auckland 11:39:4 - LMT 1868 N 2
 11:30 NZ NZ%sT 1946
 12 NZ NZ%sT
 Z Pacific/Bougainville 10:22:16 - LMT 1880
 9:48:32 - PMMT 1895
-10 - +10 1942 Jul
-9 - +09 1945 Au 21
-10 - +10 2014 D 28 2
-11 - +11
+10 - %z 1942 Jul
+9 - %z 1945 Au 21
+10 - %z 2014 D 28 2
+11 - %z
 Z Pacific/Chatham 12:13:48 - LMT 1868 N 2
-12:15 - +1215 1946
-12:45 k +1245/+1345
+12:15 - %z 1946
+12:45 k %z
 Z Pacific/Easter -7:17:28 - LMT 1890
 -7:17:28 - EMT 1932 S
--7 x -07/-06 1982 Mar 14 3u
--6 x -06/-05
+-7 x %z 1982 Mar 14 3u
+-6 x %z
 Z Pacific/Efate 11:13:16 - LMT 1912 Ja 13
-11 VU +11/+12
+11 VU %z
 Z Pacific/Fakaofo -11:24:56 - LMT 1901
--11 - -11 2011 D 30
-13 - +13
+-11 - %z 2011 D 30
+13 - %z
 Z Pacific/Fiji 11:55:44 - LMT 1915 O 26
-12 FJ +12/+13
+12 FJ %z
 Z Pacific/Galapagos -5:58:24 - LMT 1931
--5 - -05 1986
--6 EC -06/-05
+-5 - %z 1986
+-6 EC %z
 Z Pacific/Gambier -8:59:48 - LMT 1912 O
--9 - -09
+-9 - %z
 Z Pacific/Guadalcanal 10:39:48 - LMT 1912 O
-11 - +11
+11 - %z
 Z Pacific/Guam -14:21 - LMT 1844 D 31
 9:39 - LMT 1901
 10 - GST 1941 D 10
-9 - +09 1944 Jul 31
+9 - %z 1944 Jul 31
 10 Gu G%sT 2000 D 23
 10 - ChST
 Z Pacific/Honolulu -10:31:26 - LMT 1896 Ja 13 12
@@ -3979,74 +3955,73 @@ Z Pacific/Honolulu -10:31:26 - LMT 1896 Ja 13 12
 -10:30 u H%sT 1947 Jun 8 2
 -10 - HST
 Z Pacific/Kanton 0 - -00 1937 Au 31
--12 - -12 1979 O
--11 - -11 1994 D 31
-13 - +13
+-12 - %z 1979 O
+-11 - %z 1994 D 31
+13 - %z
 Z Pacific/Kiritimati -10:29:20 - LMT 1901
--10:40 - -1040 1979 O
--10 - -10 1994 D 31
-14 - +14
+-10:40 - %z 1979 O
+-10 - %z 1994 D 31
+14 - %z
 Z Pacific/Kosrae -13:8:4 - LMT 1844 D 31
 10:51:56 - LMT 1901
-11 - +11 1914 O
-9 - +09 1919 F
-11 - +11 1937
-10 - +10 1941 Ap
-9 - +09 1945 Au
-11 - +11 1969 O
-12 - +12 1999
-11 - +11
+11 - %z 1914 O
+9 - %z 1919 F
+11 - %z 1937
+10 - %z 1941 Ap
+9 - %z 1945 Au
+11 - %z 1969 O
+12 - %z 1999
+11 - %z
 Z Pacific/Kwajalein 11:9:20 - LMT 1901
-11 - +11 1937
-10 - +10 1941 Ap
-9 - +09 1944 F 6
-11 - +11 1969 O
--12 - -12 1993 Au 20 24
-12 - +12
+11 - %z 1937
+10 - %z 1941 Ap
+9 - %z 1944 F 6
+11 - %z 1969 O
+-12 - %z 1993 Au 20 24
+12 - %z
 Z Pacific/Marquesas -9:18 - LMT 1912 O
--9:30 - -0930
+-9:30 - %z
 Z Pacific/Nauru 11:7:40 - LMT 1921 Ja 15
-11:30 - +1130 1942 Au 29
-9 - +09 1945 S 8
-11:30 - +1130 1979 F 10 2
-12 - +12
+11:30 - %z 1942 Au 29
+9 - %z 1945 S 8
+11:30 - %z 1979 F 10 2
+12 - %z
 Z Pacific/Niue -11:19:40 - LMT 1952 O 16
--11:20 - -1120 1964 Jul
--11 - -11
+-11:20 - %z 1964 Jul
+-11 - %z
 Z Pacific/Norfolk 11:11:52 - LMT 1901
-11:12 - +1112 1951
-11:30 - +1130 1974 O 27 2s
-11:30 1 +1230 1975 Mar 2 2s
-11:30 - +1130 2015 O 4 2s
-11 - +11 2019 Jul
-11 AN +11/+12
+11:12 - %z 1951
+11:30 - %z 1974 O 27 2s
+11:30 1 %z 1975 Mar 2 2s
+11:30 - %z 2015 O 4 2s
+11 - %z 2019 Jul
+11 AN %z
 Z Pacific/Noumea 11:5:48 - LMT 1912 Ja 13
-11 NC +11/+12
+11 NC %z
 Z Pacific/Pago_Pago 12:37:12 - LMT 1892 Jul 5
 -11:22:48 - LMT 1911
 -11 - SST
 Z Pacific/Palau -15:2:4 - LMT 1844 D 31
 8:57:56 - LMT 1901
-9 - +09
+9 - %z
 Z Pacific/Pitcairn -8:40:20 - LMT 1901
--8:30 - -0830 1998 Ap 27
--8 - -08
+-8:30 - %z 1998 Ap 27
+-8 - %z
 Z Pacific/Port_Moresby 9:48:40 - LMT 1880
 9:48:32 - PMMT 1895
-10 - +10
+10 - %z
 Z Pacific/Rarotonga 13:20:56 - LMT 1899 D 26
 -10:39:4 - LMT 1952 O 16
--10:30 - -1030 1978 N 12
--10 CK -10/-0930
+-10:30 - %z 1978 N 12
+-10 CK %z
 Z Pacific/Tahiti -9:58:16 - LMT 1912 O
--10 - -10
+-10 - %z
 Z Pacific/Tarawa 11:32:4 - LMT 1901
-12 - +12
+12 - %z
 Z Pacific/Tongatapu 12:19:12 - LMT 1945 S 10
-12:20 - +1220 1961
-13 - +13 1999
-13 TO +13/+14
-Z WET 0 E WE%sT
+12:20 - %z 1961
+13 - %z 1999
+13 TO %z
 L Etc/GMT GMT
 L Australia/Sydney Australia/ACT
 L Australia/Lord_Howe Australia/LHI
@@ -4062,6 +4037,8 @@ L America/Rio_Branco Brazil/Acre
 L America/Noronha Brazil/DeNoronha
 L America/Sao_Paulo Brazil/East
 L America/Manaus Brazil/West
+L Europe/Brussels CET
+L America/Chicago CST6CDT
 L America/Halifax Canada/Atlantic
 L America/Winnipeg Canada/Central
 L America/Toronto Canada/Eastern
@@ -4073,6 +4050,9 @@ L America/Whitehorse Canada/Yukon
 L America/Santiago Chile/Continental
 L Pacific/Easter Chile/EasterIsland
 L America/Havana Cuba
+L Europe/Athens EET
+L America/Panama EST
+L America/New_York EST5EDT
 L Africa/Cairo Egypt
 L Europe/Dublin Eire
 L Etc/GMT Etc/GMT+0
@@ -4096,6 +4076,9 @@ L America/Jamaica Jamaica
 L Asia/Tokyo Japan
 L Pacific/Kwajalein Kwajalein
 L Africa/Tripoli Libya
+L Europe/Brussels MET
+L America/Phoenix MST
+L America/Denver MST7MDT
 L America/Tijuana Mexico/BajaNorte
 L America/Mazatlan Mexico/BajaSur
 L America/Mexico_City Mexico/General
@@ -4259,6 +4242,7 @@ L America/Denver America/Shiprock
 L America/Toronto America/Thunder_Bay
 L America/Edmonton America/Yellowknife
 L Pacific/Auckland Antarctica/South_Pole
+L Asia/Ulaanbaatar Asia/Choibalsan
 L Asia/Shanghai Asia/Chongqing
 L Asia/Shanghai Asia/Harbin
 L Asia/Urumqi Asia/Kashgar
@@ -4273,6 +4257,7 @@ L Europe/Kyiv Europe/Zaporozhye
 L Pacific/Kanton Pacific/Enderbury
 L Pacific/Honolulu Pacific/Johnston
 L Pacific/Port_Moresby Pacific/Yap
+L Europe/Lisbon WET
 L Africa/Nairobi Africa/Asmera
 L America/Nuuk America/Godthab
 L Asia/Ashgabat Asia/Ashkhabad
@@ -4290,5 +4275,7 @@ L Asia/Ulaanbaatar Asia/Ulan_Bator
 L Atlantic/Faroe Atlantic/Faeroe
 L Europe/Kyiv Europe/Kiev
 L Asia/Nicosia Europe/Nicosia
+L Pacific/Honolulu HST
+L America/Los_Angeles PST8PDT
 L Pacific/Guadalcanal Pacific/Ponape
 L Pacific/Port_Moresby Pacific/Truk
diff --git a/lib/pytz/zoneinfo/zone.tab b/lib/pytz/zoneinfo/zone.tab
index 3fa9306a..bfc0b593 100644
--- a/lib/pytz/zoneinfo/zone.tab
+++ b/lib/pytz/zoneinfo/zone.tab
@@ -264,8 +264,7 @@ MK	+4159+02126	Europe/Skopje
 ML	+1239-00800	Africa/Bamako
 MM	+1647+09610	Asia/Yangon
 MN	+4755+10653	Asia/Ulaanbaatar	most of Mongolia
-MN	+4801+09139	Asia/Hovd	Bayan-Olgiy, Govi-Altai, Hovd, Uvs, Zavkhan
-MN	+4804+11430	Asia/Choibalsan	Dornod, Sukhbaatar
+MN	+4801+09139	Asia/Hovd	Bayan-Olgii, Hovd, Uvs
 MO	+221150+1133230	Asia/Macau
 MP	+1512+14545	Pacific/Saipan
 MQ	+1436-06105	America/Martinique
diff --git a/lib/pytz/zoneinfo/zone1970.tab b/lib/pytz/zoneinfo/zone1970.tab
index abd94897..7726f39a 100644
--- a/lib/pytz/zoneinfo/zone1970.tab
+++ b/lib/pytz/zoneinfo/zone1970.tab
@@ -209,8 +209,7 @@ MD	+4700+02850	Europe/Chisinau
 MH	+0905+16720	Pacific/Kwajalein	Kwajalein
 MM,CC	+1647+09610	Asia/Yangon
 MN	+4755+10653	Asia/Ulaanbaatar	most of Mongolia
-MN	+4801+09139	Asia/Hovd	Bayan-Ölgii, Govi-Altai, Hovd, Uvs, Zavkhan
-MN	+4804+11430	Asia/Choibalsan	Dornod, Sükhbaatar
+MN	+4801+09139	Asia/Hovd	Bayan-Ölgii, Hovd, Uvs
 MO	+221150+1133230	Asia/Macau
 MQ	+1436-06105	America/Martinique
 MT	+3554+01431	Europe/Malta
diff --git a/lib/pytz/zoneinfo/zonenow.tab b/lib/pytz/zoneinfo/zonenow.tab
index b6f29109..01f536b3 100644
--- a/lib/pytz/zoneinfo/zonenow.tab
+++ b/lib/pytz/zoneinfo/zonenow.tab
@@ -5,7 +5,7 @@
 # From Paul Eggert (2023-12-18):
 # This file contains a table where each row stands for a timezone
 # where civil timestamps are predicted to agree from now on.
-# This file is like zone1970.tab (see zone1970.tab's coments),
+# This file is like zone1970.tab (see zone1970.tab's comments),
 # but with the following changes:
 #
 # 1.  Each timezone corresponds to a set of clocks that are planned
@@ -123,8 +123,6 @@ XX	+1455-02331	Atlantic/Cape_Verde	Cape Verde
 #
 # -01/+00 (EU DST)
 XX	+3744-02540	Atlantic/Azores	Azores
-# -01/+00 (EU DST) until 2024-03-31; then -02/-01 (EU DST)
-XX	+7029-02158	America/Scoresbysund	Ittoqqortoormiit
 #
 # +00 - GMT
 XX	+0519-00402	Africa/Abidjan	far western Africa; Iceland ("GMT")
@@ -199,7 +197,7 @@ XX	+2518+05518	Asia/Dubai	Russia; Caucasus; Persian Gulf; Seychelles; Réunion
 XX	+3431+06912	Asia/Kabul	Afghanistan
 #
 # +05
-XX	+4120+06918	Asia/Tashkent	Russia; west Kazakhstan; Tajikistan; Turkmenistan; Uzbekistan; Maldives
+XX	+4120+06918	Asia/Tashkent	Russia; Kazakhstan; Tajikistan; Turkmenistan; Uzbekistan; Maldives
 #
 # +05 - PKT
 XX	+2452+06703	Asia/Karachi	Pakistan ("PKT")
@@ -215,8 +213,6 @@ XX	+2743+08519	Asia/Kathmandu	Nepal
 #
 # +06
 XX	+2343+09025	Asia/Dhaka	Russia; Kyrgyzstan; Bhutan; Bangladesh; Chagos
-# +06 until 2024-03-01; then +05
-XX	+4315+07657	Asia/Almaty	Kazakhstan (except western areas)
 #
 # +06:30
 XX	+1647+09610	Asia/Yangon	Myanmar; Cocos
diff --git a/requirements.txt b/requirements.txt
index 64daed44..6775d4c4 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -33,7 +33,7 @@ PyJWT==2.9.0
 pyparsing==3.1.4
 python-dateutil==2.9.0.post0
 python-twitter==3.5
-pytz==2024.1
+pytz==2024.2
 requests==2.32.3
 requests-oauthlib==2.0.0
 rumps==0.4.0; platform_system == "Darwin"

From bf07912711bef3274a3393e89855238f77c6565d Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 16 Nov 2024 14:50:57 -0800
Subject: [PATCH 669/743] Bump idna from 3.7 to 3.10 (#2400)

* Bump idna from 3.7 to 3.10

Bumps [idna](https://github.com/kjd/idna) from 3.7 to 3.10.
- [Release notes](https://github.com/kjd/idna/releases)
- [Changelog](https://github.com/kjd/idna/blob/master/HISTORY.rst)
- [Commits](https://github.com/kjd/idna/compare/v3.7...v3.10)

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

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

* Update idna==3.10

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/idna/__init__.py     |     3 +-
 lib/idna/codec.py        |    58 +-
 lib/idna/compat.py       |    10 +-
 lib/idna/core.py         |   280 +-
 lib/idna/idnadata.py     |  7076 ++++++++--------
 lib/idna/intranges.py    |    11 +-
 lib/idna/package_data.py |     3 +-
 lib/idna/uts46data.py    | 16439 +++++++++++++++++++------------------
 requirements.txt         |     2 +-
 9 files changed, 12007 insertions(+), 11875 deletions(-)

diff --git a/lib/idna/__init__.py b/lib/idna/__init__.py
index a40eeafc..cfdc030a 100644
--- a/lib/idna/__init__.py
+++ b/lib/idna/__init__.py
@@ -1,4 +1,3 @@
-from .package_data import __version__
 from .core import (
     IDNABidiError,
     IDNAError,
@@ -20,8 +19,10 @@ from .core import (
     valid_string_length,
 )
 from .intranges import intranges_contain
+from .package_data import __version__
 
 __all__ = [
+    "__version__",
     "IDNABidiError",
     "IDNAError",
     "InvalidCodepoint",
diff --git a/lib/idna/codec.py b/lib/idna/codec.py
index c855a4de..913abfd6 100644
--- a/lib/idna/codec.py
+++ b/lib/idna/codec.py
@@ -1,49 +1,51 @@
-from .core import encode, decode, alabel, ulabel, IDNAError
 import codecs
 import re
-from typing import Any, Tuple, Optional
+from typing import Any, Optional, Tuple
+
+from .core import IDNAError, alabel, decode, encode, ulabel
+
+_unicode_dots_re = re.compile("[\u002e\u3002\uff0e\uff61]")
 
-_unicode_dots_re = re.compile('[\u002e\u3002\uff0e\uff61]')
 
 class Codec(codecs.Codec):
-
-    def encode(self, data: str, errors: str = 'strict') -> Tuple[bytes, int]:
-        if errors != 'strict':
-            raise IDNAError('Unsupported error handling \"{}\"'.format(errors))
+    def encode(self, data: str, errors: str = "strict") -> Tuple[bytes, int]:
+        if errors != "strict":
+            raise IDNAError('Unsupported error handling "{}"'.format(errors))
 
         if not data:
             return b"", 0
 
         return encode(data), len(data)
 
-    def decode(self, data: bytes, errors: str = 'strict') -> Tuple[str, int]:
-        if errors != 'strict':
-            raise IDNAError('Unsupported error handling \"{}\"'.format(errors))
+    def decode(self, data: bytes, errors: str = "strict") -> Tuple[str, int]:
+        if errors != "strict":
+            raise IDNAError('Unsupported error handling "{}"'.format(errors))
 
         if not data:
-            return '', 0
+            return "", 0
 
         return decode(data), len(data)
 
+
 class IncrementalEncoder(codecs.BufferedIncrementalEncoder):
     def _buffer_encode(self, data: str, errors: str, final: bool) -> Tuple[bytes, int]:
-        if errors != 'strict':
-            raise IDNAError('Unsupported error handling \"{}\"'.format(errors))
+        if errors != "strict":
+            raise IDNAError('Unsupported error handling "{}"'.format(errors))
 
         if not data:
-            return b'', 0
+            return b"", 0
 
         labels = _unicode_dots_re.split(data)
-        trailing_dot = b''
+        trailing_dot = b""
         if labels:
             if not labels[-1]:
-                trailing_dot = b'.'
+                trailing_dot = b"."
                 del labels[-1]
             elif not final:
                 # Keep potentially unfinished label until the next call
                 del labels[-1]
                 if labels:
-                    trailing_dot = b'.'
+                    trailing_dot = b"."
 
         result = []
         size = 0
@@ -54,32 +56,33 @@ class IncrementalEncoder(codecs.BufferedIncrementalEncoder):
             size += len(label)
 
         # Join with U+002E
-        result_bytes = b'.'.join(result) + trailing_dot
+        result_bytes = b".".join(result) + trailing_dot
         size += len(trailing_dot)
         return result_bytes, size
 
+
 class IncrementalDecoder(codecs.BufferedIncrementalDecoder):
     def _buffer_decode(self, data: Any, errors: str, final: bool) -> Tuple[str, int]:
-        if errors != 'strict':
-            raise IDNAError('Unsupported error handling \"{}\"'.format(errors))
+        if errors != "strict":
+            raise IDNAError('Unsupported error handling "{}"'.format(errors))
 
         if not data:
-            return ('', 0)
+            return ("", 0)
 
         if not isinstance(data, str):
-            data = str(data, 'ascii')
+            data = str(data, "ascii")
 
         labels = _unicode_dots_re.split(data)
-        trailing_dot = ''
+        trailing_dot = ""
         if labels:
             if not labels[-1]:
-                trailing_dot = '.'
+                trailing_dot = "."
                 del labels[-1]
             elif not final:
                 # Keep potentially unfinished label until the next call
                 del labels[-1]
                 if labels:
-                    trailing_dot = '.'
+                    trailing_dot = "."
 
         result = []
         size = 0
@@ -89,7 +92,7 @@ class IncrementalDecoder(codecs.BufferedIncrementalDecoder):
                 size += 1
             size += len(label)
 
-        result_str = '.'.join(result) + trailing_dot
+        result_str = ".".join(result) + trailing_dot
         size += len(trailing_dot)
         return (result_str, size)
 
@@ -103,7 +106,7 @@ class StreamReader(Codec, codecs.StreamReader):
 
 
 def search_function(name: str) -> Optional[codecs.CodecInfo]:
-    if name != 'idna2008':
+    if name != "idna2008":
         return None
     return codecs.CodecInfo(
         name=name,
@@ -115,4 +118,5 @@ def search_function(name: str) -> Optional[codecs.CodecInfo]:
         streamreader=StreamReader,
     )
 
+
 codecs.register(search_function)
diff --git a/lib/idna/compat.py b/lib/idna/compat.py
index 786e6bda..1df9f2a7 100644
--- a/lib/idna/compat.py
+++ b/lib/idna/compat.py
@@ -1,13 +1,15 @@
-from .core import *
-from .codec import *
 from typing import Any, Union
 
+from .core import decode, encode
+
+
 def ToASCII(label: str) -> bytes:
     return encode(label)
 
+
 def ToUnicode(label: Union[bytes, bytearray]) -> str:
     return decode(label)
 
-def nameprep(s: Any) -> None:
-    raise NotImplementedError('IDNA 2008 does not utilise nameprep protocol')
 
+def nameprep(s: Any) -> None:
+    raise NotImplementedError("IDNA 2008 does not utilise nameprep protocol")
diff --git a/lib/idna/core.py b/lib/idna/core.py
index 0dae61ac..9115f123 100644
--- a/lib/idna/core.py
+++ b/lib/idna/core.py
@@ -1,31 +1,37 @@
-from . import idnadata
 import bisect
-import unicodedata
 import re
-from typing import Union, Optional
+import unicodedata
+from typing import Optional, Union
+
+from . import idnadata
 from .intranges import intranges_contain
 
 _virama_combining_class = 9
-_alabel_prefix = b'xn--'
-_unicode_dots_re = re.compile('[\u002e\u3002\uff0e\uff61]')
+_alabel_prefix = b"xn--"
+_unicode_dots_re = re.compile("[\u002e\u3002\uff0e\uff61]")
+
 
 class IDNAError(UnicodeError):
-    """ Base exception for all IDNA-encoding related problems """
+    """Base exception for all IDNA-encoding related problems"""
+
     pass
 
 
 class IDNABidiError(IDNAError):
-    """ Exception when bidirectional requirements are not satisfied """
+    """Exception when bidirectional requirements are not satisfied"""
+
     pass
 
 
 class InvalidCodepoint(IDNAError):
-    """ Exception when a disallowed or unallocated codepoint is used """
+    """Exception when a disallowed or unallocated codepoint is used"""
+
     pass
 
 
 class InvalidCodepointContext(IDNAError):
-    """ Exception when the codepoint is not valid in the context it is used """
+    """Exception when the codepoint is not valid in the context it is used"""
+
     pass
 
 
@@ -33,17 +39,20 @@ def _combining_class(cp: int) -> int:
     v = unicodedata.combining(chr(cp))
     if v == 0:
         if not unicodedata.name(chr(cp)):
-            raise ValueError('Unknown character in unicodedata')
+            raise ValueError("Unknown character in unicodedata")
     return v
 
+
 def _is_script(cp: str, script: str) -> bool:
     return intranges_contain(ord(cp), idnadata.scripts[script])
 
+
 def _punycode(s: str) -> bytes:
-    return s.encode('punycode')
+    return s.encode("punycode")
+
 
 def _unot(s: int) -> str:
-    return 'U+{:04X}'.format(s)
+    return "U+{:04X}".format(s)
 
 
 def valid_label_length(label: Union[bytes, str]) -> bool:
@@ -61,96 +70,106 @@ def valid_string_length(label: Union[bytes, str], trailing_dot: bool) -> bool:
 def check_bidi(label: str, check_ltr: bool = False) -> bool:
     # Bidi rules should only be applied if string contains RTL characters
     bidi_label = False
-    for (idx, cp) in enumerate(label, 1):
+    for idx, cp in enumerate(label, 1):
         direction = unicodedata.bidirectional(cp)
-        if direction == '':
+        if direction == "":
             # String likely comes from a newer version of Unicode
-            raise IDNABidiError('Unknown directionality in label {} at position {}'.format(repr(label), idx))
-        if direction in ['R', 'AL', 'AN']:
+            raise IDNABidiError("Unknown directionality in label {} at position {}".format(repr(label), idx))
+        if direction in ["R", "AL", "AN"]:
             bidi_label = True
     if not bidi_label and not check_ltr:
         return True
 
     # Bidi rule 1
     direction = unicodedata.bidirectional(label[0])
-    if direction in ['R', 'AL']:
+    if direction in ["R", "AL"]:
         rtl = True
-    elif direction == 'L':
+    elif direction == "L":
         rtl = False
     else:
-        raise IDNABidiError('First codepoint in label {} must be directionality L, R or AL'.format(repr(label)))
+        raise IDNABidiError("First codepoint in label {} must be directionality L, R or AL".format(repr(label)))
 
     valid_ending = False
-    number_type = None  # type: Optional[str]
-    for (idx, cp) in enumerate(label, 1):
+    number_type: Optional[str] = None
+    for idx, cp in enumerate(label, 1):
         direction = unicodedata.bidirectional(cp)
 
         if rtl:
             # Bidi rule 2
-            if not direction in ['R', 'AL', 'AN', 'EN', 'ES', 'CS', 'ET', 'ON', 'BN', 'NSM']:
-                raise IDNABidiError('Invalid direction for codepoint at position {} in a right-to-left label'.format(idx))
+            if direction not in [
+                "R",
+                "AL",
+                "AN",
+                "EN",
+                "ES",
+                "CS",
+                "ET",
+                "ON",
+                "BN",
+                "NSM",
+            ]:
+                raise IDNABidiError("Invalid direction for codepoint at position {} in a right-to-left label".format(idx))
             # Bidi rule 3
-            if direction in ['R', 'AL', 'EN', 'AN']:
+            if direction in ["R", "AL", "EN", "AN"]:
                 valid_ending = True
-            elif direction != 'NSM':
+            elif direction != "NSM":
                 valid_ending = False
             # Bidi rule 4
-            if direction in ['AN', 'EN']:
+            if direction in ["AN", "EN"]:
                 if not number_type:
                     number_type = direction
                 else:
                     if number_type != direction:
-                        raise IDNABidiError('Can not mix numeral types in a right-to-left label')
+                        raise IDNABidiError("Can not mix numeral types in a right-to-left label")
         else:
             # Bidi rule 5
-            if not direction in ['L', 'EN', 'ES', 'CS', 'ET', 'ON', 'BN', 'NSM']:
-                raise IDNABidiError('Invalid direction for codepoint at position {} in a left-to-right label'.format(idx))
+            if direction not in ["L", "EN", "ES", "CS", "ET", "ON", "BN", "NSM"]:
+                raise IDNABidiError("Invalid direction for codepoint at position {} in a left-to-right label".format(idx))
             # Bidi rule 6
-            if direction in ['L', 'EN']:
+            if direction in ["L", "EN"]:
                 valid_ending = True
-            elif direction != 'NSM':
+            elif direction != "NSM":
                 valid_ending = False
 
     if not valid_ending:
-        raise IDNABidiError('Label ends with illegal codepoint directionality')
+        raise IDNABidiError("Label ends with illegal codepoint directionality")
 
     return True
 
 
 def check_initial_combiner(label: str) -> bool:
-    if unicodedata.category(label[0])[0] == 'M':
-        raise IDNAError('Label begins with an illegal combining character')
+    if unicodedata.category(label[0])[0] == "M":
+        raise IDNAError("Label begins with an illegal combining character")
     return True
 
 
 def check_hyphen_ok(label: str) -> bool:
-    if label[2:4] == '--':
-        raise IDNAError('Label has disallowed hyphens in 3rd and 4th position')
-    if label[0] == '-' or label[-1] == '-':
-        raise IDNAError('Label must not start or end with a hyphen')
+    if label[2:4] == "--":
+        raise IDNAError("Label has disallowed hyphens in 3rd and 4th position")
+    if label[0] == "-" or label[-1] == "-":
+        raise IDNAError("Label must not start or end with a hyphen")
     return True
 
 
 def check_nfc(label: str) -> None:
-    if unicodedata.normalize('NFC', label) != label:
-        raise IDNAError('Label must be in Normalization Form C')
+    if unicodedata.normalize("NFC", label) != label:
+        raise IDNAError("Label must be in Normalization Form C")
 
 
 def valid_contextj(label: str, pos: int) -> bool:
     cp_value = ord(label[pos])
 
-    if cp_value == 0x200c:
-
+    if cp_value == 0x200C:
         if pos > 0:
             if _combining_class(ord(label[pos - 1])) == _virama_combining_class:
                 return True
 
         ok = False
-        for i in range(pos-1, -1, -1):
+        for i in range(pos - 1, -1, -1):
             joining_type = idnadata.joining_types.get(ord(label[i]))
-            if joining_type == ord('T'):
+            if joining_type == ord("T"):
                 continue
-            elif joining_type in [ord('L'), ord('D')]:
+            elif joining_type in [ord("L"), ord("D")]:
                 ok = True
                 break
             else:
@@ -160,63 +179,61 @@ def valid_contextj(label: str, pos: int) -> bool:
             return False
 
         ok = False
-        for i in range(pos+1, len(label)):
+        for i in range(pos + 1, len(label)):
             joining_type = idnadata.joining_types.get(ord(label[i]))
-            if joining_type == ord('T'):
+            if joining_type == ord("T"):
                 continue
-            elif joining_type in [ord('R'), ord('D')]:
+            elif joining_type in [ord("R"), ord("D")]:
                 ok = True
                 break
             else:
                 break
         return ok
 
-    if cp_value == 0x200d:
-
+    if cp_value == 0x200D:
         if pos > 0:
             if _combining_class(ord(label[pos - 1])) == _virama_combining_class:
                 return True
         return False
 
     else:
-
         return False
 
 
 def valid_contexto(label: str, pos: int, exception: bool = False) -> bool:
     cp_value = ord(label[pos])
 
-    if cp_value == 0x00b7:
-        if 0 < pos < len(label)-1:
-            if ord(label[pos - 1]) == 0x006c and ord(label[pos + 1]) == 0x006c:
+    if cp_value == 0x00B7:
+        if 0 < pos < len(label) - 1:
+            if ord(label[pos - 1]) == 0x006C and ord(label[pos + 1]) == 0x006C:
                 return True
         return False
 
     elif cp_value == 0x0375:
-        if pos < len(label)-1 and len(label) > 1:
-            return _is_script(label[pos + 1], 'Greek')
+        if pos < len(label) - 1 and len(label) > 1:
+            return _is_script(label[pos + 1], "Greek")
         return False
 
-    elif cp_value == 0x05f3 or cp_value == 0x05f4:
+    elif cp_value == 0x05F3 or cp_value == 0x05F4:
         if pos > 0:
-            return _is_script(label[pos - 1], 'Hebrew')
+            return _is_script(label[pos - 1], "Hebrew")
         return False
 
-    elif cp_value == 0x30fb:
+    elif cp_value == 0x30FB:
         for cp in label:
-            if cp == '\u30fb':
+            if cp == "\u30fb":
                 continue
-            if _is_script(cp, 'Hiragana') or _is_script(cp, 'Katakana') or _is_script(cp, 'Han'):
+            if _is_script(cp, "Hiragana") or _is_script(cp, "Katakana") or _is_script(cp, "Han"):
                 return True
         return False
 
     elif 0x660 <= cp_value <= 0x669:
         for cp in label:
-            if 0x6f0 <= ord(cp) <= 0x06f9:
+            if 0x6F0 <= ord(cp) <= 0x06F9:
                 return False
         return True
 
-    elif 0x6f0 <= cp_value <= 0x6f9:
+    elif 0x6F0 <= cp_value <= 0x6F9:
         for cp in label:
             if 0x660 <= ord(cp) <= 0x0669:
                 return False
@@ -227,37 +244,49 @@ def valid_contexto(label: str, pos: int, exception: bool = False) -> bool:
 
 def check_label(label: Union[str, bytes, bytearray]) -> None:
     if isinstance(label, (bytes, bytearray)):
-        label = label.decode('utf-8')
+        label = label.decode("utf-8")
     if len(label) == 0:
-        raise IDNAError('Empty Label')
+        raise IDNAError("Empty Label")
 
     check_nfc(label)
     check_hyphen_ok(label)
     check_initial_combiner(label)
 
-    for (pos, cp) in enumerate(label):
+    for pos, cp in enumerate(label):
         cp_value = ord(cp)
-        if intranges_contain(cp_value, idnadata.codepoint_classes['PVALID']):
+        if intranges_contain(cp_value, idnadata.codepoint_classes["PVALID"]):
             continue
-        elif intranges_contain(cp_value, idnadata.codepoint_classes['CONTEXTJ']):
-            if not valid_contextj(label, pos):
-                raise InvalidCodepointContext('Joiner {} not allowed at position {} in {}'.format(
-                    _unot(cp_value), pos+1, repr(label)))
-        elif intranges_contain(cp_value, idnadata.codepoint_classes['CONTEXTO']):
+        elif intranges_contain(cp_value, idnadata.codepoint_classes["CONTEXTJ"]):
+            try:
+                if not valid_contextj(label, pos):
+                    raise InvalidCodepointContext(
+                        "Joiner {} not allowed at position {} in {}".format(_unot(cp_value), pos + 1, repr(label))
+                    )
+            except ValueError:
+                raise IDNAError(
+                    "Unknown codepoint adjacent to joiner {} at position {} in {}".format(
+                        _unot(cp_value), pos + 1, repr(label)
+                    )
+                )
+        elif intranges_contain(cp_value, idnadata.codepoint_classes["CONTEXTO"]):
             if not valid_contexto(label, pos):
-                raise InvalidCodepointContext('Codepoint {} not allowed at position {} in {}'.format(_unot(cp_value), pos+1, repr(label)))
+                raise InvalidCodepointContext(
+                    "Codepoint {} not allowed at position {} in {}".format(_unot(cp_value), pos + 1, repr(label))
+                )
         else:
-            raise InvalidCodepoint('Codepoint {} at position {} of {} not allowed'.format(_unot(cp_value), pos+1, repr(label)))
+            raise InvalidCodepoint(
+                "Codepoint {} at position {} of {} not allowed".format(_unot(cp_value), pos + 1, repr(label))
+            )
 
     check_bidi(label)
 
 
 def alabel(label: str) -> bytes:
     try:
-        label_bytes = label.encode('ascii')
+        label_bytes = label.encode("ascii")
         ulabel(label_bytes)
         if not valid_label_length(label_bytes):
-            raise IDNAError('Label too long')
+            raise IDNAError("Label too long")
         return label_bytes
     except UnicodeEncodeError:
         pass
@@ -266,7 +295,7 @@ def alabel(label: str) -> bytes:
     label_bytes = _alabel_prefix + _punycode(label)
 
     if not valid_label_length(label_bytes):
-        raise IDNAError('Label too long')
+        raise IDNAError("Label too long")
 
     return label_bytes
 
@@ -274,7 +303,7 @@ def alabel(label: str) -> bytes:
 def ulabel(label: Union[str, bytes, bytearray]) -> str:
     if not isinstance(label, (bytes, bytearray)):
         try:
-            label_bytes = label.encode('ascii')
+            label_bytes = label.encode("ascii")
         except UnicodeEncodeError:
             check_label(label)
             return label
@@ -283,19 +312,19 @@ def ulabel(label: Union[str, bytes, bytearray]) -> str:
 
     label_bytes = label_bytes.lower()
     if label_bytes.startswith(_alabel_prefix):
-        label_bytes = label_bytes[len(_alabel_prefix):]
+        label_bytes = label_bytes[len(_alabel_prefix) :]
         if not label_bytes:
-            raise IDNAError('Malformed A-label, no Punycode eligible content found')
-        if label_bytes.decode('ascii')[-1] == '-':
-            raise IDNAError('A-label must not end with a hyphen')
+            raise IDNAError("Malformed A-label, no Punycode eligible content found")
+        if label_bytes.decode("ascii")[-1] == "-":
+            raise IDNAError("A-label must not end with a hyphen")
     else:
         check_label(label_bytes)
-        return label_bytes.decode('ascii')
+        return label_bytes.decode("ascii")
 
     try:
-        label = label_bytes.decode('punycode')
+        label = label_bytes.decode("punycode")
     except UnicodeError:
-        raise IDNAError('Invalid A-label')
+        raise IDNAError("Invalid A-label")
     check_label(label)
     return label
 
@@ -303,52 +332,60 @@ def ulabel(label: Union[str, bytes, bytearray]) -> str:
 def uts46_remap(domain: str, std3_rules: bool = True, transitional: bool = False) -> str:
     """Re-map the characters in the string according to UTS46 processing."""
     from .uts46data import uts46data
-    output = ''
+
+    output = ""
 
     for pos, char in enumerate(domain):
         code_point = ord(char)
         try:
-            uts46row = uts46data[code_point if code_point < 256 else
-                bisect.bisect_left(uts46data, (code_point, 'Z')) - 1]
+            uts46row = uts46data[code_point if code_point < 256 else bisect.bisect_left(uts46data, (code_point, "Z")) - 1]
             status = uts46row[1]
-            replacement = None  # type: Optional[str]
+            replacement: Optional[str] = None
             if len(uts46row) == 3:
                 replacement = uts46row[2]
-            if (status == 'V' or
-                    (status == 'D' and not transitional) or
-                    (status == '3' and not std3_rules and replacement is None)):
+            if (
+                status == "V"
+                or (status == "D" and not transitional)
+                or (status == "3" and not std3_rules and replacement is None)
+            ):
                 output += char
-            elif replacement is not None and (status == 'M' or
-                    (status == '3' and not std3_rules) or
-                    (status == 'D' and transitional)):
+            elif replacement is not None and (
+                status == "M" or (status == "3" and not std3_rules) or (status == "D" and transitional)
+            ):
                 output += replacement
-            elif status != 'I':
+            elif status != "I":
                 raise IndexError()
         except IndexError:
             raise InvalidCodepoint(
-                'Codepoint {} not allowed at position {} in {}'.format(
-                _unot(code_point), pos + 1, repr(domain)))
+                "Codepoint {} not allowed at position {} in {}".format(_unot(code_point), pos + 1, repr(domain))
+            )
 
-    return unicodedata.normalize('NFC', output)
+    return unicodedata.normalize("NFC", output)
 
 
-def encode(s: Union[str, bytes, bytearray], strict: bool = False, uts46: bool = False, std3_rules: bool = False, transitional: bool = False) -> bytes:
+def encode(
+    s: Union[str, bytes, bytearray],
+    strict: bool = False,
+    uts46: bool = False,
+    std3_rules: bool = False,
+    transitional: bool = False,
+) -> bytes:
     if not isinstance(s, str):
         try:
-            s = str(s, 'ascii')
+            s = str(s, "ascii")
         except UnicodeDecodeError:
-            raise IDNAError('should pass a unicode string to the function rather than a byte string.')
+            raise IDNAError("should pass a unicode string to the function rather than a byte string.")
     if uts46:
         s = uts46_remap(s, std3_rules, transitional)
     trailing_dot = False
     result = []
     if strict:
-        labels = s.split('.')
+        labels = s.split(".")
     else:
         labels = _unicode_dots_re.split(s)
-    if not labels or labels == ['']:
-        raise IDNAError('Empty domain')
-    if labels[-1] == '':
+    if not labels or labels == [""]:
+        raise IDNAError("Empty domain")
+    if labels[-1] == "":
         del labels[-1]
         trailing_dot = True
     for label in labels:
@@ -356,21 +393,26 @@ def encode(s: Union[str, bytes, bytearray], strict: bool = False, uts46: bool =
         if s:
             result.append(s)
         else:
-            raise IDNAError('Empty label')
+            raise IDNAError("Empty label")
     if trailing_dot:
-        result.append(b'')
-    s = b'.'.join(result)
+        result.append(b"")
+    s = b".".join(result)
     if not valid_string_length(s, trailing_dot):
-        raise IDNAError('Domain too long')
+        raise IDNAError("Domain too long")
     return s
 
 
-def decode(s: Union[str, bytes, bytearray], strict: bool = False, uts46: bool = False, std3_rules: bool = False) -> str:
+def decode(
+    s: Union[str, bytes, bytearray],
+    strict: bool = False,
+    uts46: bool = False,
+    std3_rules: bool = False,
+) -> str:
     try:
         if not isinstance(s, str):
-            s = str(s, 'ascii')
+            s = str(s, "ascii")
     except UnicodeDecodeError:
-        raise IDNAError('Invalid ASCII in A-label')
+        raise IDNAError("Invalid ASCII in A-label")
     if uts46:
         s = uts46_remap(s, std3_rules, False)
     trailing_dot = False
@@ -378,9 +420,9 @@ def decode(s: Union[str, bytes, bytearray], strict: bool = False, uts46: bool =
     if not strict:
         labels = _unicode_dots_re.split(s)
     else:
-        labels = s.split('.')
-    if not labels or labels == ['']:
-        raise IDNAError('Empty domain')
+        labels = s.split(".")
+    if not labels or labels == [""]:
+        raise IDNAError("Empty domain")
     if not labels[-1]:
         del labels[-1]
         trailing_dot = True
@@ -389,7 +431,7 @@ def decode(s: Union[str, bytes, bytearray], strict: bool = False, uts46: bool =
         if s:
             result.append(s)
         else:
-            raise IDNAError('Empty label')
+            raise IDNAError("Empty label")
     if trailing_dot:
-        result.append('')
-    return '.'.join(result)
+        result.append("")
+    return ".".join(result)
diff --git a/lib/idna/idnadata.py b/lib/idna/idnadata.py
index c61dcf97..4be60046 100644
--- a/lib/idna/idnadata.py
+++ b/lib/idna/idnadata.py
@@ -1,107 +1,107 @@
 # This file is automatically generated by tools/idna-data
 
-__version__ = '15.1.0'
+__version__ = "15.1.0"
 scripts = {
-    'Greek': (
+    "Greek": (
         0x37000000374,
         0x37500000378,
-        0x37a0000037e,
-        0x37f00000380,
+        0x37A0000037E,
+        0x37F00000380,
         0x38400000385,
         0x38600000387,
-        0x3880000038b,
-        0x38c0000038d,
-        0x38e000003a2,
-        0x3a3000003e2,
-        0x3f000000400,
-        0x1d2600001d2b,
-        0x1d5d00001d62,
-        0x1d6600001d6b,
-        0x1dbf00001dc0,
-        0x1f0000001f16,
-        0x1f1800001f1e,
-        0x1f2000001f46,
-        0x1f4800001f4e,
-        0x1f5000001f58,
-        0x1f5900001f5a,
-        0x1f5b00001f5c,
-        0x1f5d00001f5e,
-        0x1f5f00001f7e,
-        0x1f8000001fb5,
-        0x1fb600001fc5,
-        0x1fc600001fd4,
-        0x1fd600001fdc,
-        0x1fdd00001ff0,
-        0x1ff200001ff5,
-        0x1ff600001fff,
+        0x3880000038B,
+        0x38C0000038D,
+        0x38E000003A2,
+        0x3A3000003E2,
+        0x3F000000400,
+        0x1D2600001D2B,
+        0x1D5D00001D62,
+        0x1D6600001D6B,
+        0x1DBF00001DC0,
+        0x1F0000001F16,
+        0x1F1800001F1E,
+        0x1F2000001F46,
+        0x1F4800001F4E,
+        0x1F5000001F58,
+        0x1F5900001F5A,
+        0x1F5B00001F5C,
+        0x1F5D00001F5E,
+        0x1F5F00001F7E,
+        0x1F8000001FB5,
+        0x1FB600001FC5,
+        0x1FC600001FD4,
+        0x1FD600001FDC,
+        0x1FDD00001FF0,
+        0x1FF200001FF5,
+        0x1FF600001FFF,
         0x212600002127,
-        0xab650000ab66,
-        0x101400001018f,
-        0x101a0000101a1,
-        0x1d2000001d246,
+        0xAB650000AB66,
+        0x101400001018F,
+        0x101A0000101A1,
+        0x1D2000001D246,
     ),
-    'Han': (
-        0x2e8000002e9a,
-        0x2e9b00002ef4,
-        0x2f0000002fd6,
+    "Han": (
+        0x2E8000002E9A,
+        0x2E9B00002EF4,
+        0x2F0000002FD6,
         0x300500003006,
         0x300700003008,
-        0x30210000302a,
-        0x30380000303c,
-        0x340000004dc0,
-        0x4e000000a000,
-        0xf9000000fa6e,
-        0xfa700000fada,
-        0x16fe200016fe4,
-        0x16ff000016ff2,
-        0x200000002a6e0,
-        0x2a7000002b73a,
-        0x2b7400002b81e,
-        0x2b8200002cea2,
-        0x2ceb00002ebe1,
-        0x2ebf00002ee5e,
-        0x2f8000002fa1e,
-        0x300000003134b,
-        0x31350000323b0,
+        0x30210000302A,
+        0x30380000303C,
+        0x340000004DC0,
+        0x4E000000A000,
+        0xF9000000FA6E,
+        0xFA700000FADA,
+        0x16FE200016FE4,
+        0x16FF000016FF2,
+        0x200000002A6E0,
+        0x2A7000002B73A,
+        0x2B7400002B81E,
+        0x2B8200002CEA2,
+        0x2CEB00002EBE1,
+        0x2EBF00002EE5E,
+        0x2F8000002FA1E,
+        0x300000003134B,
+        0x31350000323B0,
     ),
-    'Hebrew': (
-        0x591000005c8,
-        0x5d0000005eb,
-        0x5ef000005f5,
-        0xfb1d0000fb37,
-        0xfb380000fb3d,
-        0xfb3e0000fb3f,
-        0xfb400000fb42,
-        0xfb430000fb45,
-        0xfb460000fb50,
+    "Hebrew": (
+        0x591000005C8,
+        0x5D0000005EB,
+        0x5EF000005F5,
+        0xFB1D0000FB37,
+        0xFB380000FB3D,
+        0xFB3E0000FB3F,
+        0xFB400000FB42,
+        0xFB430000FB45,
+        0xFB460000FB50,
     ),
-    'Hiragana': (
+    "Hiragana": (
         0x304100003097,
-        0x309d000030a0,
-        0x1b0010001b120,
-        0x1b1320001b133,
-        0x1b1500001b153,
-        0x1f2000001f201,
+        0x309D000030A0,
+        0x1B0010001B120,
+        0x1B1320001B133,
+        0x1B1500001B153,
+        0x1F2000001F201,
     ),
-    'Katakana': (
-        0x30a1000030fb,
-        0x30fd00003100,
-        0x31f000003200,
-        0x32d0000032ff,
+    "Katakana": (
+        0x30A1000030FB,
+        0x30FD00003100,
+        0x31F000003200,
+        0x32D0000032FF,
         0x330000003358,
-        0xff660000ff70,
-        0xff710000ff9e,
-        0x1aff00001aff4,
-        0x1aff50001affc,
-        0x1affd0001afff,
-        0x1b0000001b001,
-        0x1b1200001b123,
-        0x1b1550001b156,
-        0x1b1640001b168,
+        0xFF660000FF70,
+        0xFF710000FF9E,
+        0x1AFF00001AFF4,
+        0x1AFF50001AFFC,
+        0x1AFFD0001AFFF,
+        0x1B0000001B001,
+        0x1B1200001B123,
+        0x1B1550001B156,
+        0x1B1640001B168,
     ),
 }
 joining_types = {
-    0xad: 84,
+    0xAD: 84,
     0x300: 84,
     0x301: 84,
     0x302: 84,
@@ -112,12 +112,12 @@ joining_types = {
     0x307: 84,
     0x308: 84,
     0x309: 84,
-    0x30a: 84,
-    0x30b: 84,
-    0x30c: 84,
-    0x30d: 84,
-    0x30e: 84,
-    0x30f: 84,
+    0x30A: 84,
+    0x30B: 84,
+    0x30C: 84,
+    0x30D: 84,
+    0x30E: 84,
+    0x30F: 84,
     0x310: 84,
     0x311: 84,
     0x312: 84,
@@ -128,12 +128,12 @@ joining_types = {
     0x317: 84,
     0x318: 84,
     0x319: 84,
-    0x31a: 84,
-    0x31b: 84,
-    0x31c: 84,
-    0x31d: 84,
-    0x31e: 84,
-    0x31f: 84,
+    0x31A: 84,
+    0x31B: 84,
+    0x31C: 84,
+    0x31D: 84,
+    0x31E: 84,
+    0x31F: 84,
     0x320: 84,
     0x321: 84,
     0x322: 84,
@@ -144,12 +144,12 @@ joining_types = {
     0x327: 84,
     0x328: 84,
     0x329: 84,
-    0x32a: 84,
-    0x32b: 84,
-    0x32c: 84,
-    0x32d: 84,
-    0x32e: 84,
-    0x32f: 84,
+    0x32A: 84,
+    0x32B: 84,
+    0x32C: 84,
+    0x32D: 84,
+    0x32E: 84,
+    0x32F: 84,
     0x330: 84,
     0x331: 84,
     0x332: 84,
@@ -160,12 +160,12 @@ joining_types = {
     0x337: 84,
     0x338: 84,
     0x339: 84,
-    0x33a: 84,
-    0x33b: 84,
-    0x33c: 84,
-    0x33d: 84,
-    0x33e: 84,
-    0x33f: 84,
+    0x33A: 84,
+    0x33B: 84,
+    0x33C: 84,
+    0x33D: 84,
+    0x33E: 84,
+    0x33F: 84,
     0x340: 84,
     0x341: 84,
     0x342: 84,
@@ -176,12 +176,12 @@ joining_types = {
     0x347: 84,
     0x348: 84,
     0x349: 84,
-    0x34a: 84,
-    0x34b: 84,
-    0x34c: 84,
-    0x34d: 84,
-    0x34e: 84,
-    0x34f: 84,
+    0x34A: 84,
+    0x34B: 84,
+    0x34C: 84,
+    0x34D: 84,
+    0x34E: 84,
+    0x34F: 84,
     0x350: 84,
     0x351: 84,
     0x352: 84,
@@ -192,12 +192,12 @@ joining_types = {
     0x357: 84,
     0x358: 84,
     0x359: 84,
-    0x35a: 84,
-    0x35b: 84,
-    0x35c: 84,
-    0x35d: 84,
-    0x35e: 84,
-    0x35f: 84,
+    0x35A: 84,
+    0x35B: 84,
+    0x35C: 84,
+    0x35D: 84,
+    0x35E: 84,
+    0x35F: 84,
     0x360: 84,
     0x361: 84,
     0x362: 84,
@@ -208,12 +208,12 @@ joining_types = {
     0x367: 84,
     0x368: 84,
     0x369: 84,
-    0x36a: 84,
-    0x36b: 84,
-    0x36c: 84,
-    0x36d: 84,
-    0x36e: 84,
-    0x36f: 84,
+    0x36A: 84,
+    0x36B: 84,
+    0x36C: 84,
+    0x36D: 84,
+    0x36E: 84,
+    0x36F: 84,
     0x483: 84,
     0x484: 84,
     0x485: 84,
@@ -230,48 +230,48 @@ joining_types = {
     0x597: 84,
     0x598: 84,
     0x599: 84,
-    0x59a: 84,
-    0x59b: 84,
-    0x59c: 84,
-    0x59d: 84,
-    0x59e: 84,
-    0x59f: 84,
-    0x5a0: 84,
-    0x5a1: 84,
-    0x5a2: 84,
-    0x5a3: 84,
-    0x5a4: 84,
-    0x5a5: 84,
-    0x5a6: 84,
-    0x5a7: 84,
-    0x5a8: 84,
-    0x5a9: 84,
-    0x5aa: 84,
-    0x5ab: 84,
-    0x5ac: 84,
-    0x5ad: 84,
-    0x5ae: 84,
-    0x5af: 84,
-    0x5b0: 84,
-    0x5b1: 84,
-    0x5b2: 84,
-    0x5b3: 84,
-    0x5b4: 84,
-    0x5b5: 84,
-    0x5b6: 84,
-    0x5b7: 84,
-    0x5b8: 84,
-    0x5b9: 84,
-    0x5ba: 84,
-    0x5bb: 84,
-    0x5bc: 84,
-    0x5bd: 84,
-    0x5bf: 84,
-    0x5c1: 84,
-    0x5c2: 84,
-    0x5c4: 84,
-    0x5c5: 84,
-    0x5c7: 84,
+    0x59A: 84,
+    0x59B: 84,
+    0x59C: 84,
+    0x59D: 84,
+    0x59E: 84,
+    0x59F: 84,
+    0x5A0: 84,
+    0x5A1: 84,
+    0x5A2: 84,
+    0x5A3: 84,
+    0x5A4: 84,
+    0x5A5: 84,
+    0x5A6: 84,
+    0x5A7: 84,
+    0x5A8: 84,
+    0x5A9: 84,
+    0x5AA: 84,
+    0x5AB: 84,
+    0x5AC: 84,
+    0x5AD: 84,
+    0x5AE: 84,
+    0x5AF: 84,
+    0x5B0: 84,
+    0x5B1: 84,
+    0x5B2: 84,
+    0x5B3: 84,
+    0x5B4: 84,
+    0x5B5: 84,
+    0x5B6: 84,
+    0x5B7: 84,
+    0x5B8: 84,
+    0x5B9: 84,
+    0x5BA: 84,
+    0x5BB: 84,
+    0x5BC: 84,
+    0x5BD: 84,
+    0x5BF: 84,
+    0x5C1: 84,
+    0x5C2: 84,
+    0x5C4: 84,
+    0x5C5: 84,
+    0x5C7: 84,
     0x610: 84,
     0x611: 84,
     0x612: 84,
@@ -282,8 +282,8 @@ joining_types = {
     0x617: 84,
     0x618: 84,
     0x619: 84,
-    0x61a: 84,
-    0x61c: 84,
+    0x61A: 84,
+    0x61C: 84,
     0x620: 68,
     0x622: 82,
     0x623: 82,
@@ -293,12 +293,12 @@ joining_types = {
     0x627: 82,
     0x628: 68,
     0x629: 82,
-    0x62a: 68,
-    0x62b: 68,
-    0x62c: 68,
-    0x62d: 68,
-    0x62e: 68,
-    0x62f: 82,
+    0x62A: 68,
+    0x62B: 68,
+    0x62C: 68,
+    0x62D: 68,
+    0x62E: 68,
+    0x62F: 82,
     0x630: 82,
     0x631: 82,
     0x632: 82,
@@ -309,12 +309,12 @@ joining_types = {
     0x637: 68,
     0x638: 68,
     0x639: 68,
-    0x63a: 68,
-    0x63b: 68,
-    0x63c: 68,
-    0x63d: 68,
-    0x63e: 68,
-    0x63f: 68,
+    0x63A: 68,
+    0x63B: 68,
+    0x63C: 68,
+    0x63D: 68,
+    0x63E: 68,
+    0x63F: 68,
     0x640: 67,
     0x641: 68,
     0x642: 68,
@@ -325,12 +325,12 @@ joining_types = {
     0x647: 68,
     0x648: 82,
     0x649: 68,
-    0x64a: 68,
-    0x64b: 84,
-    0x64c: 84,
-    0x64d: 84,
-    0x64e: 84,
-    0x64f: 84,
+    0x64A: 68,
+    0x64B: 84,
+    0x64C: 84,
+    0x64D: 84,
+    0x64E: 84,
+    0x64F: 84,
     0x650: 84,
     0x651: 84,
     0x652: 84,
@@ -341,14 +341,14 @@ joining_types = {
     0x657: 84,
     0x658: 84,
     0x659: 84,
-    0x65a: 84,
-    0x65b: 84,
-    0x65c: 84,
-    0x65d: 84,
-    0x65e: 84,
-    0x65f: 84,
-    0x66e: 68,
-    0x66f: 68,
+    0x65A: 84,
+    0x65B: 84,
+    0x65C: 84,
+    0x65D: 84,
+    0x65E: 84,
+    0x65F: 84,
+    0x66E: 68,
+    0x66F: 68,
     0x670: 84,
     0x671: 82,
     0x672: 82,
@@ -358,12 +358,12 @@ joining_types = {
     0x677: 82,
     0x678: 68,
     0x679: 68,
-    0x67a: 68,
-    0x67b: 68,
-    0x67c: 68,
-    0x67d: 68,
-    0x67e: 68,
-    0x67f: 68,
+    0x67A: 68,
+    0x67B: 68,
+    0x67C: 68,
+    0x67D: 68,
+    0x67E: 68,
+    0x67F: 68,
     0x680: 68,
     0x681: 68,
     0x682: 68,
@@ -374,12 +374,12 @@ joining_types = {
     0x687: 68,
     0x688: 82,
     0x689: 82,
-    0x68a: 82,
-    0x68b: 82,
-    0x68c: 82,
-    0x68d: 82,
-    0x68e: 82,
-    0x68f: 82,
+    0x68A: 82,
+    0x68B: 82,
+    0x68C: 82,
+    0x68D: 82,
+    0x68E: 82,
+    0x68F: 82,
     0x690: 82,
     0x691: 82,
     0x692: 82,
@@ -390,91 +390,91 @@ joining_types = {
     0x697: 82,
     0x698: 82,
     0x699: 82,
-    0x69a: 68,
-    0x69b: 68,
-    0x69c: 68,
-    0x69d: 68,
-    0x69e: 68,
-    0x69f: 68,
-    0x6a0: 68,
-    0x6a1: 68,
-    0x6a2: 68,
-    0x6a3: 68,
-    0x6a4: 68,
-    0x6a5: 68,
-    0x6a6: 68,
-    0x6a7: 68,
-    0x6a8: 68,
-    0x6a9: 68,
-    0x6aa: 68,
-    0x6ab: 68,
-    0x6ac: 68,
-    0x6ad: 68,
-    0x6ae: 68,
-    0x6af: 68,
-    0x6b0: 68,
-    0x6b1: 68,
-    0x6b2: 68,
-    0x6b3: 68,
-    0x6b4: 68,
-    0x6b5: 68,
-    0x6b6: 68,
-    0x6b7: 68,
-    0x6b8: 68,
-    0x6b9: 68,
-    0x6ba: 68,
-    0x6bb: 68,
-    0x6bc: 68,
-    0x6bd: 68,
-    0x6be: 68,
-    0x6bf: 68,
-    0x6c0: 82,
-    0x6c1: 68,
-    0x6c2: 68,
-    0x6c3: 82,
-    0x6c4: 82,
-    0x6c5: 82,
-    0x6c6: 82,
-    0x6c7: 82,
-    0x6c8: 82,
-    0x6c9: 82,
-    0x6ca: 82,
-    0x6cb: 82,
-    0x6cc: 68,
-    0x6cd: 82,
-    0x6ce: 68,
-    0x6cf: 82,
-    0x6d0: 68,
-    0x6d1: 68,
-    0x6d2: 82,
-    0x6d3: 82,
-    0x6d5: 82,
-    0x6d6: 84,
-    0x6d7: 84,
-    0x6d8: 84,
-    0x6d9: 84,
-    0x6da: 84,
-    0x6db: 84,
-    0x6dc: 84,
-    0x6df: 84,
-    0x6e0: 84,
-    0x6e1: 84,
-    0x6e2: 84,
-    0x6e3: 84,
-    0x6e4: 84,
-    0x6e7: 84,
-    0x6e8: 84,
-    0x6ea: 84,
-    0x6eb: 84,
-    0x6ec: 84,
-    0x6ed: 84,
-    0x6ee: 82,
-    0x6ef: 82,
-    0x6fa: 68,
-    0x6fb: 68,
-    0x6fc: 68,
-    0x6ff: 68,
-    0x70f: 84,
+    0x69A: 68,
+    0x69B: 68,
+    0x69C: 68,
+    0x69D: 68,
+    0x69E: 68,
+    0x69F: 68,
+    0x6A0: 68,
+    0x6A1: 68,
+    0x6A2: 68,
+    0x6A3: 68,
+    0x6A4: 68,
+    0x6A5: 68,
+    0x6A6: 68,
+    0x6A7: 68,
+    0x6A8: 68,
+    0x6A9: 68,
+    0x6AA: 68,
+    0x6AB: 68,
+    0x6AC: 68,
+    0x6AD: 68,
+    0x6AE: 68,
+    0x6AF: 68,
+    0x6B0: 68,
+    0x6B1: 68,
+    0x6B2: 68,
+    0x6B3: 68,
+    0x6B4: 68,
+    0x6B5: 68,
+    0x6B6: 68,
+    0x6B7: 68,
+    0x6B8: 68,
+    0x6B9: 68,
+    0x6BA: 68,
+    0x6BB: 68,
+    0x6BC: 68,
+    0x6BD: 68,
+    0x6BE: 68,
+    0x6BF: 68,
+    0x6C0: 82,
+    0x6C1: 68,
+    0x6C2: 68,
+    0x6C3: 82,
+    0x6C4: 82,
+    0x6C5: 82,
+    0x6C6: 82,
+    0x6C7: 82,
+    0x6C8: 82,
+    0x6C9: 82,
+    0x6CA: 82,
+    0x6CB: 82,
+    0x6CC: 68,
+    0x6CD: 82,
+    0x6CE: 68,
+    0x6CF: 82,
+    0x6D0: 68,
+    0x6D1: 68,
+    0x6D2: 82,
+    0x6D3: 82,
+    0x6D5: 82,
+    0x6D6: 84,
+    0x6D7: 84,
+    0x6D8: 84,
+    0x6D9: 84,
+    0x6DA: 84,
+    0x6DB: 84,
+    0x6DC: 84,
+    0x6DF: 84,
+    0x6E0: 84,
+    0x6E1: 84,
+    0x6E2: 84,
+    0x6E3: 84,
+    0x6E4: 84,
+    0x6E7: 84,
+    0x6E8: 84,
+    0x6EA: 84,
+    0x6EB: 84,
+    0x6EC: 84,
+    0x6ED: 84,
+    0x6EE: 82,
+    0x6EF: 82,
+    0x6FA: 68,
+    0x6FB: 68,
+    0x6FC: 68,
+    0x6FF: 68,
+    0x70F: 84,
     0x710: 82,
     0x711: 84,
     0x712: 68,
@@ -485,12 +485,12 @@ joining_types = {
     0x717: 82,
     0x718: 82,
     0x719: 82,
-    0x71a: 68,
-    0x71b: 68,
-    0x71c: 68,
-    0x71d: 68,
-    0x71e: 82,
-    0x71f: 68,
+    0x71A: 68,
+    0x71B: 68,
+    0x71C: 68,
+    0x71D: 68,
+    0x71E: 82,
+    0x71F: 68,
     0x720: 68,
     0x721: 68,
     0x722: 68,
@@ -501,12 +501,12 @@ joining_types = {
     0x727: 68,
     0x728: 82,
     0x729: 68,
-    0x72a: 82,
-    0x72b: 68,
-    0x72c: 82,
-    0x72d: 68,
-    0x72e: 68,
-    0x72f: 82,
+    0x72A: 82,
+    0x72B: 68,
+    0x72C: 82,
+    0x72D: 68,
+    0x72E: 68,
+    0x72F: 82,
     0x730: 84,
     0x731: 84,
     0x732: 84,
@@ -517,12 +517,12 @@ joining_types = {
     0x737: 84,
     0x738: 84,
     0x739: 84,
-    0x73a: 84,
-    0x73b: 84,
-    0x73c: 84,
-    0x73d: 84,
-    0x73e: 84,
-    0x73f: 84,
+    0x73A: 84,
+    0x73B: 84,
+    0x73C: 84,
+    0x73D: 84,
+    0x73E: 84,
+    0x73F: 84,
     0x740: 84,
     0x741: 84,
     0x742: 84,
@@ -533,10 +533,10 @@ joining_types = {
     0x747: 84,
     0x748: 84,
     0x749: 84,
-    0x74a: 84,
-    0x74d: 82,
-    0x74e: 68,
-    0x74f: 68,
+    0x74A: 84,
+    0x74D: 82,
+    0x74E: 68,
+    0x74F: 68,
     0x750: 68,
     0x751: 68,
     0x752: 68,
@@ -547,12 +547,12 @@ joining_types = {
     0x757: 68,
     0x758: 68,
     0x759: 82,
-    0x75a: 82,
-    0x75b: 82,
-    0x75c: 68,
-    0x75d: 68,
-    0x75e: 68,
-    0x75f: 68,
+    0x75A: 82,
+    0x75B: 82,
+    0x75C: 68,
+    0x75D: 68,
+    0x75E: 68,
+    0x75F: 68,
     0x760: 68,
     0x761: 68,
     0x762: 68,
@@ -563,12 +563,12 @@ joining_types = {
     0x767: 68,
     0x768: 68,
     0x769: 68,
-    0x76a: 68,
-    0x76b: 82,
-    0x76c: 82,
-    0x76d: 68,
-    0x76e: 68,
-    0x76f: 68,
+    0x76A: 68,
+    0x76B: 82,
+    0x76C: 82,
+    0x76D: 68,
+    0x76E: 68,
+    0x76F: 68,
     0x770: 68,
     0x771: 82,
     0x772: 68,
@@ -579,76 +579,76 @@ joining_types = {
     0x777: 68,
     0x778: 82,
     0x779: 82,
-    0x77a: 68,
-    0x77b: 68,
-    0x77c: 68,
-    0x77d: 68,
-    0x77e: 68,
-    0x77f: 68,
-    0x7a6: 84,
-    0x7a7: 84,
-    0x7a8: 84,
-    0x7a9: 84,
-    0x7aa: 84,
-    0x7ab: 84,
-    0x7ac: 84,
-    0x7ad: 84,
-    0x7ae: 84,
-    0x7af: 84,
-    0x7b0: 84,
-    0x7ca: 68,
-    0x7cb: 68,
-    0x7cc: 68,
-    0x7cd: 68,
-    0x7ce: 68,
-    0x7cf: 68,
-    0x7d0: 68,
-    0x7d1: 68,
-    0x7d2: 68,
-    0x7d3: 68,
-    0x7d4: 68,
-    0x7d5: 68,
-    0x7d6: 68,
-    0x7d7: 68,
-    0x7d8: 68,
-    0x7d9: 68,
-    0x7da: 68,
-    0x7db: 68,
-    0x7dc: 68,
-    0x7dd: 68,
-    0x7de: 68,
-    0x7df: 68,
-    0x7e0: 68,
-    0x7e1: 68,
-    0x7e2: 68,
-    0x7e3: 68,
-    0x7e4: 68,
-    0x7e5: 68,
-    0x7e6: 68,
-    0x7e7: 68,
-    0x7e8: 68,
-    0x7e9: 68,
-    0x7ea: 68,
-    0x7eb: 84,
-    0x7ec: 84,
-    0x7ed: 84,
-    0x7ee: 84,
-    0x7ef: 84,
-    0x7f0: 84,
-    0x7f1: 84,
-    0x7f2: 84,
-    0x7f3: 84,
-    0x7fa: 67,
-    0x7fd: 84,
+    0x77A: 68,
+    0x77B: 68,
+    0x77C: 68,
+    0x77D: 68,
+    0x77E: 68,
+    0x77F: 68,
+    0x7A6: 84,
+    0x7A7: 84,
+    0x7A8: 84,
+    0x7A9: 84,
+    0x7AA: 84,
+    0x7AB: 84,
+    0x7AC: 84,
+    0x7AD: 84,
+    0x7AE: 84,
+    0x7AF: 84,
+    0x7B0: 84,
+    0x7CA: 68,
+    0x7CB: 68,
+    0x7CC: 68,
+    0x7CD: 68,
+    0x7CE: 68,
+    0x7CF: 68,
+    0x7D0: 68,
+    0x7D1: 68,
+    0x7D2: 68,
+    0x7D3: 68,
+    0x7D4: 68,
+    0x7D5: 68,
+    0x7D6: 68,
+    0x7D7: 68,
+    0x7D8: 68,
+    0x7D9: 68,
+    0x7DA: 68,
+    0x7DB: 68,
+    0x7DC: 68,
+    0x7DD: 68,
+    0x7DE: 68,
+    0x7DF: 68,
+    0x7E0: 68,
+    0x7E1: 68,
+    0x7E2: 68,
+    0x7E3: 68,
+    0x7E4: 68,
+    0x7E5: 68,
+    0x7E6: 68,
+    0x7E7: 68,
+    0x7E8: 68,
+    0x7E9: 68,
+    0x7EA: 68,
+    0x7EB: 84,
+    0x7EC: 84,
+    0x7ED: 84,
+    0x7EE: 84,
+    0x7EF: 84,
+    0x7F0: 84,
+    0x7F1: 84,
+    0x7F2: 84,
+    0x7F3: 84,
+    0x7FA: 67,
+    0x7FD: 84,
     0x816: 84,
     0x817: 84,
     0x818: 84,
     0x819: 84,
-    0x81b: 84,
-    0x81c: 84,
-    0x81d: 84,
-    0x81e: 84,
-    0x81f: 84,
+    0x81B: 84,
+    0x81C: 84,
+    0x81D: 84,
+    0x81E: 84,
+    0x81F: 84,
     0x820: 84,
     0x821: 84,
     0x822: 84,
@@ -657,10 +657,10 @@ joining_types = {
     0x826: 84,
     0x827: 84,
     0x829: 84,
-    0x82a: 84,
-    0x82b: 84,
-    0x82c: 84,
-    0x82d: 84,
+    0x82A: 84,
+    0x82B: 84,
+    0x82C: 84,
+    0x82D: 84,
     0x840: 82,
     0x841: 68,
     0x842: 68,
@@ -671,12 +671,12 @@ joining_types = {
     0x847: 82,
     0x848: 68,
     0x849: 82,
-    0x84a: 68,
-    0x84b: 68,
-    0x84c: 68,
-    0x84d: 68,
-    0x84e: 68,
-    0x84f: 68,
+    0x84A: 68,
+    0x84B: 68,
+    0x84C: 68,
+    0x84D: 68,
+    0x84E: 68,
+    0x84F: 68,
     0x850: 68,
     0x851: 68,
     0x852: 68,
@@ -687,8 +687,8 @@ joining_types = {
     0x857: 82,
     0x858: 82,
     0x859: 84,
-    0x85a: 84,
-    0x85b: 84,
+    0x85A: 84,
+    0x85B: 84,
     0x860: 68,
     0x862: 68,
     0x863: 68,
@@ -697,7 +697,7 @@ joining_types = {
     0x867: 82,
     0x868: 68,
     0x869: 82,
-    0x86a: 82,
+    0x86A: 82,
     0x870: 82,
     0x871: 82,
     0x872: 82,
@@ -708,12 +708,12 @@ joining_types = {
     0x877: 82,
     0x878: 82,
     0x879: 82,
-    0x87a: 82,
-    0x87b: 82,
-    0x87c: 82,
-    0x87d: 82,
-    0x87e: 82,
-    0x87f: 82,
+    0x87A: 82,
+    0x87B: 82,
+    0x87C: 82,
+    0x87D: 82,
+    0x87E: 82,
+    0x87F: 82,
     0x880: 82,
     0x881: 82,
     0x882: 82,
@@ -722,117 +722,117 @@ joining_types = {
     0x885: 67,
     0x886: 68,
     0x889: 68,
-    0x88a: 68,
-    0x88b: 68,
-    0x88c: 68,
-    0x88d: 68,
-    0x88e: 82,
+    0x88A: 68,
+    0x88B: 68,
+    0x88C: 68,
+    0x88D: 68,
+    0x88E: 82,
     0x898: 84,
     0x899: 84,
-    0x89a: 84,
-    0x89b: 84,
-    0x89c: 84,
-    0x89d: 84,
-    0x89e: 84,
-    0x89f: 84,
-    0x8a0: 68,
-    0x8a1: 68,
-    0x8a2: 68,
-    0x8a3: 68,
-    0x8a4: 68,
-    0x8a5: 68,
-    0x8a6: 68,
-    0x8a7: 68,
-    0x8a8: 68,
-    0x8a9: 68,
-    0x8aa: 82,
-    0x8ab: 82,
-    0x8ac: 82,
-    0x8ae: 82,
-    0x8af: 68,
-    0x8b0: 68,
-    0x8b1: 82,
-    0x8b2: 82,
-    0x8b3: 68,
-    0x8b4: 68,
-    0x8b5: 68,
-    0x8b6: 68,
-    0x8b7: 68,
-    0x8b8: 68,
-    0x8b9: 82,
-    0x8ba: 68,
-    0x8bb: 68,
-    0x8bc: 68,
-    0x8bd: 68,
-    0x8be: 68,
-    0x8bf: 68,
-    0x8c0: 68,
-    0x8c1: 68,
-    0x8c2: 68,
-    0x8c3: 68,
-    0x8c4: 68,
-    0x8c5: 68,
-    0x8c6: 68,
-    0x8c7: 68,
-    0x8c8: 68,
-    0x8ca: 84,
-    0x8cb: 84,
-    0x8cc: 84,
-    0x8cd: 84,
-    0x8ce: 84,
-    0x8cf: 84,
-    0x8d0: 84,
-    0x8d1: 84,
-    0x8d2: 84,
-    0x8d3: 84,
-    0x8d4: 84,
-    0x8d5: 84,
-    0x8d6: 84,
-    0x8d7: 84,
-    0x8d8: 84,
-    0x8d9: 84,
-    0x8da: 84,
-    0x8db: 84,
-    0x8dc: 84,
-    0x8dd: 84,
-    0x8de: 84,
-    0x8df: 84,
-    0x8e0: 84,
-    0x8e1: 84,
-    0x8e3: 84,
-    0x8e4: 84,
-    0x8e5: 84,
-    0x8e6: 84,
-    0x8e7: 84,
-    0x8e8: 84,
-    0x8e9: 84,
-    0x8ea: 84,
-    0x8eb: 84,
-    0x8ec: 84,
-    0x8ed: 84,
-    0x8ee: 84,
-    0x8ef: 84,
-    0x8f0: 84,
-    0x8f1: 84,
-    0x8f2: 84,
-    0x8f3: 84,
-    0x8f4: 84,
-    0x8f5: 84,
-    0x8f6: 84,
-    0x8f7: 84,
-    0x8f8: 84,
-    0x8f9: 84,
-    0x8fa: 84,
-    0x8fb: 84,
-    0x8fc: 84,
-    0x8fd: 84,
-    0x8fe: 84,
-    0x8ff: 84,
+    0x89A: 84,
+    0x89B: 84,
+    0x89C: 84,
+    0x89D: 84,
+    0x89E: 84,
+    0x89F: 84,
+    0x8A0: 68,
+    0x8A1: 68,
+    0x8A2: 68,
+    0x8A3: 68,
+    0x8A4: 68,
+    0x8A5: 68,
+    0x8A6: 68,
+    0x8A7: 68,
+    0x8A8: 68,
+    0x8A9: 68,
+    0x8AA: 82,
+    0x8AB: 82,
+    0x8AC: 82,
+    0x8AE: 82,
+    0x8AF: 68,
+    0x8B0: 68,
+    0x8B1: 82,
+    0x8B2: 82,
+    0x8B3: 68,
+    0x8B4: 68,
+    0x8B5: 68,
+    0x8B6: 68,
+    0x8B7: 68,
+    0x8B8: 68,
+    0x8B9: 82,
+    0x8BA: 68,
+    0x8BB: 68,
+    0x8BC: 68,
+    0x8BD: 68,
+    0x8BE: 68,
+    0x8BF: 68,
+    0x8C0: 68,
+    0x8C1: 68,
+    0x8C2: 68,
+    0x8C3: 68,
+    0x8C4: 68,
+    0x8C5: 68,
+    0x8C6: 68,
+    0x8C7: 68,
+    0x8C8: 68,
+    0x8CA: 84,
+    0x8CB: 84,
+    0x8CC: 84,
+    0x8CD: 84,
+    0x8CE: 84,
+    0x8CF: 84,
+    0x8D0: 84,
+    0x8D1: 84,
+    0x8D2: 84,
+    0x8D3: 84,
+    0x8D4: 84,
+    0x8D5: 84,
+    0x8D6: 84,
+    0x8D7: 84,
+    0x8D8: 84,
+    0x8D9: 84,
+    0x8DA: 84,
+    0x8DB: 84,
+    0x8DC: 84,
+    0x8DD: 84,
+    0x8DE: 84,
+    0x8DF: 84,
+    0x8E0: 84,
+    0x8E1: 84,
+    0x8E3: 84,
+    0x8E4: 84,
+    0x8E5: 84,
+    0x8E6: 84,
+    0x8E7: 84,
+    0x8E8: 84,
+    0x8E9: 84,
+    0x8EA: 84,
+    0x8EB: 84,
+    0x8EC: 84,
+    0x8ED: 84,
+    0x8EE: 84,
+    0x8EF: 84,
+    0x8F0: 84,
+    0x8F1: 84,
+    0x8F2: 84,
+    0x8F3: 84,
+    0x8F4: 84,
+    0x8F5: 84,
+    0x8F6: 84,
+    0x8F7: 84,
+    0x8F8: 84,
+    0x8F9: 84,
+    0x8FA: 84,
+    0x8FB: 84,
+    0x8FC: 84,
+    0x8FD: 84,
+    0x8FE: 84,
+    0x8FF: 84,
     0x900: 84,
     0x901: 84,
     0x902: 84,
-    0x93a: 84,
-    0x93c: 84,
+    0x93A: 84,
+    0x93C: 84,
     0x941: 84,
     0x942: 84,
     0x943: 84,
@@ -841,7 +841,7 @@ joining_types = {
     0x946: 84,
     0x947: 84,
     0x948: 84,
-    0x94d: 84,
+    0x94D: 84,
     0x951: 84,
     0x952: 84,
     0x953: 84,
@@ -852,215 +852,215 @@ joining_types = {
     0x962: 84,
     0x963: 84,
     0x981: 84,
-    0x9bc: 84,
-    0x9c1: 84,
-    0x9c2: 84,
-    0x9c3: 84,
-    0x9c4: 84,
-    0x9cd: 84,
-    0x9e2: 84,
-    0x9e3: 84,
-    0x9fe: 84,
-    0xa01: 84,
-    0xa02: 84,
-    0xa3c: 84,
-    0xa41: 84,
-    0xa42: 84,
-    0xa47: 84,
-    0xa48: 84,
-    0xa4b: 84,
-    0xa4c: 84,
-    0xa4d: 84,
-    0xa51: 84,
-    0xa70: 84,
-    0xa71: 84,
-    0xa75: 84,
-    0xa81: 84,
-    0xa82: 84,
-    0xabc: 84,
-    0xac1: 84,
-    0xac2: 84,
-    0xac3: 84,
-    0xac4: 84,
-    0xac5: 84,
-    0xac7: 84,
-    0xac8: 84,
-    0xacd: 84,
-    0xae2: 84,
-    0xae3: 84,
-    0xafa: 84,
-    0xafb: 84,
-    0xafc: 84,
-    0xafd: 84,
-    0xafe: 84,
-    0xaff: 84,
-    0xb01: 84,
-    0xb3c: 84,
-    0xb3f: 84,
-    0xb41: 84,
-    0xb42: 84,
-    0xb43: 84,
-    0xb44: 84,
-    0xb4d: 84,
-    0xb55: 84,
-    0xb56: 84,
-    0xb62: 84,
-    0xb63: 84,
-    0xb82: 84,
-    0xbc0: 84,
-    0xbcd: 84,
-    0xc00: 84,
-    0xc04: 84,
-    0xc3c: 84,
-    0xc3e: 84,
-    0xc3f: 84,
-    0xc40: 84,
-    0xc46: 84,
-    0xc47: 84,
-    0xc48: 84,
-    0xc4a: 84,
-    0xc4b: 84,
-    0xc4c: 84,
-    0xc4d: 84,
-    0xc55: 84,
-    0xc56: 84,
-    0xc62: 84,
-    0xc63: 84,
-    0xc81: 84,
-    0xcbc: 84,
-    0xcbf: 84,
-    0xcc6: 84,
-    0xccc: 84,
-    0xccd: 84,
-    0xce2: 84,
-    0xce3: 84,
-    0xd00: 84,
-    0xd01: 84,
-    0xd3b: 84,
-    0xd3c: 84,
-    0xd41: 84,
-    0xd42: 84,
-    0xd43: 84,
-    0xd44: 84,
-    0xd4d: 84,
-    0xd62: 84,
-    0xd63: 84,
-    0xd81: 84,
-    0xdca: 84,
-    0xdd2: 84,
-    0xdd3: 84,
-    0xdd4: 84,
-    0xdd6: 84,
-    0xe31: 84,
-    0xe34: 84,
-    0xe35: 84,
-    0xe36: 84,
-    0xe37: 84,
-    0xe38: 84,
-    0xe39: 84,
-    0xe3a: 84,
-    0xe47: 84,
-    0xe48: 84,
-    0xe49: 84,
-    0xe4a: 84,
-    0xe4b: 84,
-    0xe4c: 84,
-    0xe4d: 84,
-    0xe4e: 84,
-    0xeb1: 84,
-    0xeb4: 84,
-    0xeb5: 84,
-    0xeb6: 84,
-    0xeb7: 84,
-    0xeb8: 84,
-    0xeb9: 84,
-    0xeba: 84,
-    0xebb: 84,
-    0xebc: 84,
-    0xec8: 84,
-    0xec9: 84,
-    0xeca: 84,
-    0xecb: 84,
-    0xecc: 84,
-    0xecd: 84,
-    0xece: 84,
-    0xf18: 84,
-    0xf19: 84,
-    0xf35: 84,
-    0xf37: 84,
-    0xf39: 84,
-    0xf71: 84,
-    0xf72: 84,
-    0xf73: 84,
-    0xf74: 84,
-    0xf75: 84,
-    0xf76: 84,
-    0xf77: 84,
-    0xf78: 84,
-    0xf79: 84,
-    0xf7a: 84,
-    0xf7b: 84,
-    0xf7c: 84,
-    0xf7d: 84,
-    0xf7e: 84,
-    0xf80: 84,
-    0xf81: 84,
-    0xf82: 84,
-    0xf83: 84,
-    0xf84: 84,
-    0xf86: 84,
-    0xf87: 84,
-    0xf8d: 84,
-    0xf8e: 84,
-    0xf8f: 84,
-    0xf90: 84,
-    0xf91: 84,
-    0xf92: 84,
-    0xf93: 84,
-    0xf94: 84,
-    0xf95: 84,
-    0xf96: 84,
-    0xf97: 84,
-    0xf99: 84,
-    0xf9a: 84,
-    0xf9b: 84,
-    0xf9c: 84,
-    0xf9d: 84,
-    0xf9e: 84,
-    0xf9f: 84,
-    0xfa0: 84,
-    0xfa1: 84,
-    0xfa2: 84,
-    0xfa3: 84,
-    0xfa4: 84,
-    0xfa5: 84,
-    0xfa6: 84,
-    0xfa7: 84,
-    0xfa8: 84,
-    0xfa9: 84,
-    0xfaa: 84,
-    0xfab: 84,
-    0xfac: 84,
-    0xfad: 84,
-    0xfae: 84,
-    0xfaf: 84,
-    0xfb0: 84,
-    0xfb1: 84,
-    0xfb2: 84,
-    0xfb3: 84,
-    0xfb4: 84,
-    0xfb5: 84,
-    0xfb6: 84,
-    0xfb7: 84,
-    0xfb8: 84,
-    0xfb9: 84,
-    0xfba: 84,
-    0xfbb: 84,
-    0xfbc: 84,
-    0xfc6: 84,
-    0x102d: 84,
-    0x102e: 84,
-    0x102f: 84,
+    0x9BC: 84,
+    0x9C1: 84,
+    0x9C2: 84,
+    0x9C3: 84,
+    0x9C4: 84,
+    0x9CD: 84,
+    0x9E2: 84,
+    0x9E3: 84,
+    0x9FE: 84,
+    0xA01: 84,
+    0xA02: 84,
+    0xA3C: 84,
+    0xA41: 84,
+    0xA42: 84,
+    0xA47: 84,
+    0xA48: 84,
+    0xA4B: 84,
+    0xA4C: 84,
+    0xA4D: 84,
+    0xA51: 84,
+    0xA70: 84,
+    0xA71: 84,
+    0xA75: 84,
+    0xA81: 84,
+    0xA82: 84,
+    0xABC: 84,
+    0xAC1: 84,
+    0xAC2: 84,
+    0xAC3: 84,
+    0xAC4: 84,
+    0xAC5: 84,
+    0xAC7: 84,
+    0xAC8: 84,
+    0xACD: 84,
+    0xAE2: 84,
+    0xAE3: 84,
+    0xAFA: 84,
+    0xAFB: 84,
+    0xAFC: 84,
+    0xAFD: 84,
+    0xAFE: 84,
+    0xAFF: 84,
+    0xB01: 84,
+    0xB3C: 84,
+    0xB3F: 84,
+    0xB41: 84,
+    0xB42: 84,
+    0xB43: 84,
+    0xB44: 84,
+    0xB4D: 84,
+    0xB55: 84,
+    0xB56: 84,
+    0xB62: 84,
+    0xB63: 84,
+    0xB82: 84,
+    0xBC0: 84,
+    0xBCD: 84,
+    0xC00: 84,
+    0xC04: 84,
+    0xC3C: 84,
+    0xC3E: 84,
+    0xC3F: 84,
+    0xC40: 84,
+    0xC46: 84,
+    0xC47: 84,
+    0xC48: 84,
+    0xC4A: 84,
+    0xC4B: 84,
+    0xC4C: 84,
+    0xC4D: 84,
+    0xC55: 84,
+    0xC56: 84,
+    0xC62: 84,
+    0xC63: 84,
+    0xC81: 84,
+    0xCBC: 84,
+    0xCBF: 84,
+    0xCC6: 84,
+    0xCCC: 84,
+    0xCCD: 84,
+    0xCE2: 84,
+    0xCE3: 84,
+    0xD00: 84,
+    0xD01: 84,
+    0xD3B: 84,
+    0xD3C: 84,
+    0xD41: 84,
+    0xD42: 84,
+    0xD43: 84,
+    0xD44: 84,
+    0xD4D: 84,
+    0xD62: 84,
+    0xD63: 84,
+    0xD81: 84,
+    0xDCA: 84,
+    0xDD2: 84,
+    0xDD3: 84,
+    0xDD4: 84,
+    0xDD6: 84,
+    0xE31: 84,
+    0xE34: 84,
+    0xE35: 84,
+    0xE36: 84,
+    0xE37: 84,
+    0xE38: 84,
+    0xE39: 84,
+    0xE3A: 84,
+    0xE47: 84,
+    0xE48: 84,
+    0xE49: 84,
+    0xE4A: 84,
+    0xE4B: 84,
+    0xE4C: 84,
+    0xE4D: 84,
+    0xE4E: 84,
+    0xEB1: 84,
+    0xEB4: 84,
+    0xEB5: 84,
+    0xEB6: 84,
+    0xEB7: 84,
+    0xEB8: 84,
+    0xEB9: 84,
+    0xEBA: 84,
+    0xEBB: 84,
+    0xEBC: 84,
+    0xEC8: 84,
+    0xEC9: 84,
+    0xECA: 84,
+    0xECB: 84,
+    0xECC: 84,
+    0xECD: 84,
+    0xECE: 84,
+    0xF18: 84,
+    0xF19: 84,
+    0xF35: 84,
+    0xF37: 84,
+    0xF39: 84,
+    0xF71: 84,
+    0xF72: 84,
+    0xF73: 84,
+    0xF74: 84,
+    0xF75: 84,
+    0xF76: 84,
+    0xF77: 84,
+    0xF78: 84,
+    0xF79: 84,
+    0xF7A: 84,
+    0xF7B: 84,
+    0xF7C: 84,
+    0xF7D: 84,
+    0xF7E: 84,
+    0xF80: 84,
+    0xF81: 84,
+    0xF82: 84,
+    0xF83: 84,
+    0xF84: 84,
+    0xF86: 84,
+    0xF87: 84,
+    0xF8D: 84,
+    0xF8E: 84,
+    0xF8F: 84,
+    0xF90: 84,
+    0xF91: 84,
+    0xF92: 84,
+    0xF93: 84,
+    0xF94: 84,
+    0xF95: 84,
+    0xF96: 84,
+    0xF97: 84,
+    0xF99: 84,
+    0xF9A: 84,
+    0xF9B: 84,
+    0xF9C: 84,
+    0xF9D: 84,
+    0xF9E: 84,
+    0xF9F: 84,
+    0xFA0: 84,
+    0xFA1: 84,
+    0xFA2: 84,
+    0xFA3: 84,
+    0xFA4: 84,
+    0xFA5: 84,
+    0xFA6: 84,
+    0xFA7: 84,
+    0xFA8: 84,
+    0xFA9: 84,
+    0xFAA: 84,
+    0xFAB: 84,
+    0xFAC: 84,
+    0xFAD: 84,
+    0xFAE: 84,
+    0xFAF: 84,
+    0xFB0: 84,
+    0xFB1: 84,
+    0xFB2: 84,
+    0xFB3: 84,
+    0xFB4: 84,
+    0xFB5: 84,
+    0xFB6: 84,
+    0xFB7: 84,
+    0xFB8: 84,
+    0xFB9: 84,
+    0xFBA: 84,
+    0xFBB: 84,
+    0xFBC: 84,
+    0xFC6: 84,
+    0x102D: 84,
+    0x102E: 84,
+    0x102F: 84,
     0x1030: 84,
     0x1032: 84,
     0x1033: 84,
@@ -1069,13 +1069,13 @@ joining_types = {
     0x1036: 84,
     0x1037: 84,
     0x1039: 84,
-    0x103a: 84,
-    0x103d: 84,
-    0x103e: 84,
+    0x103A: 84,
+    0x103D: 84,
+    0x103E: 84,
     0x1058: 84,
     0x1059: 84,
-    0x105e: 84,
-    0x105f: 84,
+    0x105E: 84,
+    0x105F: 84,
     0x1060: 84,
     0x1071: 84,
     0x1072: 84,
@@ -1084,11 +1084,11 @@ joining_types = {
     0x1082: 84,
     0x1085: 84,
     0x1086: 84,
-    0x108d: 84,
-    0x109d: 84,
-    0x135d: 84,
-    0x135e: 84,
-    0x135f: 84,
+    0x108D: 84,
+    0x109D: 84,
+    0x135D: 84,
+    0x135E: 84,
+    0x135F: 84,
     0x1712: 84,
     0x1713: 84,
     0x1714: 84,
@@ -1098,34 +1098,34 @@ joining_types = {
     0x1753: 84,
     0x1772: 84,
     0x1773: 84,
-    0x17b4: 84,
-    0x17b5: 84,
-    0x17b7: 84,
-    0x17b8: 84,
-    0x17b9: 84,
-    0x17ba: 84,
-    0x17bb: 84,
-    0x17bc: 84,
-    0x17bd: 84,
-    0x17c6: 84,
-    0x17c9: 84,
-    0x17ca: 84,
-    0x17cb: 84,
-    0x17cc: 84,
-    0x17cd: 84,
-    0x17ce: 84,
-    0x17cf: 84,
-    0x17d0: 84,
-    0x17d1: 84,
-    0x17d2: 84,
-    0x17d3: 84,
-    0x17dd: 84,
+    0x17B4: 84,
+    0x17B5: 84,
+    0x17B7: 84,
+    0x17B8: 84,
+    0x17B9: 84,
+    0x17BA: 84,
+    0x17BB: 84,
+    0x17BC: 84,
+    0x17BD: 84,
+    0x17C6: 84,
+    0x17C9: 84,
+    0x17CA: 84,
+    0x17CB: 84,
+    0x17CC: 84,
+    0x17CD: 84,
+    0x17CE: 84,
+    0x17CF: 84,
+    0x17D0: 84,
+    0x17D1: 84,
+    0x17D2: 84,
+    0x17D3: 84,
+    0x17DD: 84,
     0x1807: 68,
-    0x180a: 67,
-    0x180b: 84,
-    0x180c: 84,
-    0x180d: 84,
-    0x180f: 84,
+    0x180A: 67,
+    0x180B: 84,
+    0x180C: 84,
+    0x180D: 84,
+    0x180F: 84,
     0x1820: 68,
     0x1821: 68,
     0x1822: 68,
@@ -1136,12 +1136,12 @@ joining_types = {
     0x1827: 68,
     0x1828: 68,
     0x1829: 68,
-    0x182a: 68,
-    0x182b: 68,
-    0x182c: 68,
-    0x182d: 68,
-    0x182e: 68,
-    0x182f: 68,
+    0x182A: 68,
+    0x182B: 68,
+    0x182C: 68,
+    0x182D: 68,
+    0x182E: 68,
+    0x182F: 68,
     0x1830: 68,
     0x1831: 68,
     0x1832: 68,
@@ -1152,12 +1152,12 @@ joining_types = {
     0x1837: 68,
     0x1838: 68,
     0x1839: 68,
-    0x183a: 68,
-    0x183b: 68,
-    0x183c: 68,
-    0x183d: 68,
-    0x183e: 68,
-    0x183f: 68,
+    0x183A: 68,
+    0x183B: 68,
+    0x183C: 68,
+    0x183D: 68,
+    0x183E: 68,
+    0x183F: 68,
     0x1840: 68,
     0x1841: 68,
     0x1842: 68,
@@ -1168,12 +1168,12 @@ joining_types = {
     0x1847: 68,
     0x1848: 68,
     0x1849: 68,
-    0x184a: 68,
-    0x184b: 68,
-    0x184c: 68,
-    0x184d: 68,
-    0x184e: 68,
-    0x184f: 68,
+    0x184A: 68,
+    0x184B: 68,
+    0x184C: 68,
+    0x184D: 68,
+    0x184E: 68,
+    0x184F: 68,
     0x1850: 68,
     0x1851: 68,
     0x1852: 68,
@@ -1184,12 +1184,12 @@ joining_types = {
     0x1857: 68,
     0x1858: 68,
     0x1859: 68,
-    0x185a: 68,
-    0x185b: 68,
-    0x185c: 68,
-    0x185d: 68,
-    0x185e: 68,
-    0x185f: 68,
+    0x185A: 68,
+    0x185B: 68,
+    0x185C: 68,
+    0x185D: 68,
+    0x185E: 68,
+    0x185F: 68,
     0x1860: 68,
     0x1861: 68,
     0x1862: 68,
@@ -1200,12 +1200,12 @@ joining_types = {
     0x1867: 68,
     0x1868: 68,
     0x1869: 68,
-    0x186a: 68,
-    0x186b: 68,
-    0x186c: 68,
-    0x186d: 68,
-    0x186e: 68,
-    0x186f: 68,
+    0x186A: 68,
+    0x186B: 68,
+    0x186C: 68,
+    0x186D: 68,
+    0x186E: 68,
+    0x186F: 68,
     0x1870: 68,
     0x1871: 68,
     0x1872: 68,
@@ -1220,12 +1220,12 @@ joining_types = {
     0x1887: 68,
     0x1888: 68,
     0x1889: 68,
-    0x188a: 68,
-    0x188b: 68,
-    0x188c: 68,
-    0x188d: 68,
-    0x188e: 68,
-    0x188f: 68,
+    0x188A: 68,
+    0x188B: 68,
+    0x188C: 68,
+    0x188D: 68,
+    0x188E: 68,
+    0x188F: 68,
     0x1890: 68,
     0x1891: 68,
     0x1892: 68,
@@ -1236,23 +1236,23 @@ joining_types = {
     0x1897: 68,
     0x1898: 68,
     0x1899: 68,
-    0x189a: 68,
-    0x189b: 68,
-    0x189c: 68,
-    0x189d: 68,
-    0x189e: 68,
-    0x189f: 68,
-    0x18a0: 68,
-    0x18a1: 68,
-    0x18a2: 68,
-    0x18a3: 68,
-    0x18a4: 68,
-    0x18a5: 68,
-    0x18a6: 68,
-    0x18a7: 68,
-    0x18a8: 68,
-    0x18a9: 84,
-    0x18aa: 68,
+    0x189A: 68,
+    0x189B: 68,
+    0x189C: 68,
+    0x189D: 68,
+    0x189E: 68,
+    0x189F: 68,
+    0x18A0: 68,
+    0x18A1: 68,
+    0x18A2: 68,
+    0x18A3: 68,
+    0x18A4: 68,
+    0x18A5: 68,
+    0x18A6: 68,
+    0x18A7: 68,
+    0x18A8: 68,
+    0x18A9: 84,
+    0x18AA: 68,
     0x1920: 84,
     0x1921: 84,
     0x1922: 84,
@@ -1260,712 +1260,712 @@ joining_types = {
     0x1928: 84,
     0x1932: 84,
     0x1939: 84,
-    0x193a: 84,
-    0x193b: 84,
-    0x1a17: 84,
-    0x1a18: 84,
-    0x1a1b: 84,
-    0x1a56: 84,
-    0x1a58: 84,
-    0x1a59: 84,
-    0x1a5a: 84,
-    0x1a5b: 84,
-    0x1a5c: 84,
-    0x1a5d: 84,
-    0x1a5e: 84,
-    0x1a60: 84,
-    0x1a62: 84,
-    0x1a65: 84,
-    0x1a66: 84,
-    0x1a67: 84,
-    0x1a68: 84,
-    0x1a69: 84,
-    0x1a6a: 84,
-    0x1a6b: 84,
-    0x1a6c: 84,
-    0x1a73: 84,
-    0x1a74: 84,
-    0x1a75: 84,
-    0x1a76: 84,
-    0x1a77: 84,
-    0x1a78: 84,
-    0x1a79: 84,
-    0x1a7a: 84,
-    0x1a7b: 84,
-    0x1a7c: 84,
-    0x1a7f: 84,
-    0x1ab0: 84,
-    0x1ab1: 84,
-    0x1ab2: 84,
-    0x1ab3: 84,
-    0x1ab4: 84,
-    0x1ab5: 84,
-    0x1ab6: 84,
-    0x1ab7: 84,
-    0x1ab8: 84,
-    0x1ab9: 84,
-    0x1aba: 84,
-    0x1abb: 84,
-    0x1abc: 84,
-    0x1abd: 84,
-    0x1abe: 84,
-    0x1abf: 84,
-    0x1ac0: 84,
-    0x1ac1: 84,
-    0x1ac2: 84,
-    0x1ac3: 84,
-    0x1ac4: 84,
-    0x1ac5: 84,
-    0x1ac6: 84,
-    0x1ac7: 84,
-    0x1ac8: 84,
-    0x1ac9: 84,
-    0x1aca: 84,
-    0x1acb: 84,
-    0x1acc: 84,
-    0x1acd: 84,
-    0x1ace: 84,
-    0x1b00: 84,
-    0x1b01: 84,
-    0x1b02: 84,
-    0x1b03: 84,
-    0x1b34: 84,
-    0x1b36: 84,
-    0x1b37: 84,
-    0x1b38: 84,
-    0x1b39: 84,
-    0x1b3a: 84,
-    0x1b3c: 84,
-    0x1b42: 84,
-    0x1b6b: 84,
-    0x1b6c: 84,
-    0x1b6d: 84,
-    0x1b6e: 84,
-    0x1b6f: 84,
-    0x1b70: 84,
-    0x1b71: 84,
-    0x1b72: 84,
-    0x1b73: 84,
-    0x1b80: 84,
-    0x1b81: 84,
-    0x1ba2: 84,
-    0x1ba3: 84,
-    0x1ba4: 84,
-    0x1ba5: 84,
-    0x1ba8: 84,
-    0x1ba9: 84,
-    0x1bab: 84,
-    0x1bac: 84,
-    0x1bad: 84,
-    0x1be6: 84,
-    0x1be8: 84,
-    0x1be9: 84,
-    0x1bed: 84,
-    0x1bef: 84,
-    0x1bf0: 84,
-    0x1bf1: 84,
-    0x1c2c: 84,
-    0x1c2d: 84,
-    0x1c2e: 84,
-    0x1c2f: 84,
-    0x1c30: 84,
-    0x1c31: 84,
-    0x1c32: 84,
-    0x1c33: 84,
-    0x1c36: 84,
-    0x1c37: 84,
-    0x1cd0: 84,
-    0x1cd1: 84,
-    0x1cd2: 84,
-    0x1cd4: 84,
-    0x1cd5: 84,
-    0x1cd6: 84,
-    0x1cd7: 84,
-    0x1cd8: 84,
-    0x1cd9: 84,
-    0x1cda: 84,
-    0x1cdb: 84,
-    0x1cdc: 84,
-    0x1cdd: 84,
-    0x1cde: 84,
-    0x1cdf: 84,
-    0x1ce0: 84,
-    0x1ce2: 84,
-    0x1ce3: 84,
-    0x1ce4: 84,
-    0x1ce5: 84,
-    0x1ce6: 84,
-    0x1ce7: 84,
-    0x1ce8: 84,
-    0x1ced: 84,
-    0x1cf4: 84,
-    0x1cf8: 84,
-    0x1cf9: 84,
-    0x1dc0: 84,
-    0x1dc1: 84,
-    0x1dc2: 84,
-    0x1dc3: 84,
-    0x1dc4: 84,
-    0x1dc5: 84,
-    0x1dc6: 84,
-    0x1dc7: 84,
-    0x1dc8: 84,
-    0x1dc9: 84,
-    0x1dca: 84,
-    0x1dcb: 84,
-    0x1dcc: 84,
-    0x1dcd: 84,
-    0x1dce: 84,
-    0x1dcf: 84,
-    0x1dd0: 84,
-    0x1dd1: 84,
-    0x1dd2: 84,
-    0x1dd3: 84,
-    0x1dd4: 84,
-    0x1dd5: 84,
-    0x1dd6: 84,
-    0x1dd7: 84,
-    0x1dd8: 84,
-    0x1dd9: 84,
-    0x1dda: 84,
-    0x1ddb: 84,
-    0x1ddc: 84,
-    0x1ddd: 84,
-    0x1dde: 84,
-    0x1ddf: 84,
-    0x1de0: 84,
-    0x1de1: 84,
-    0x1de2: 84,
-    0x1de3: 84,
-    0x1de4: 84,
-    0x1de5: 84,
-    0x1de6: 84,
-    0x1de7: 84,
-    0x1de8: 84,
-    0x1de9: 84,
-    0x1dea: 84,
-    0x1deb: 84,
-    0x1dec: 84,
-    0x1ded: 84,
-    0x1dee: 84,
-    0x1def: 84,
-    0x1df0: 84,
-    0x1df1: 84,
-    0x1df2: 84,
-    0x1df3: 84,
-    0x1df4: 84,
-    0x1df5: 84,
-    0x1df6: 84,
-    0x1df7: 84,
-    0x1df8: 84,
-    0x1df9: 84,
-    0x1dfa: 84,
-    0x1dfb: 84,
-    0x1dfc: 84,
-    0x1dfd: 84,
-    0x1dfe: 84,
-    0x1dff: 84,
-    0x200b: 84,
-    0x200d: 67,
-    0x200e: 84,
-    0x200f: 84,
-    0x202a: 84,
-    0x202b: 84,
-    0x202c: 84,
-    0x202d: 84,
-    0x202e: 84,
+    0x193A: 84,
+    0x193B: 84,
+    0x1A17: 84,
+    0x1A18: 84,
+    0x1A1B: 84,
+    0x1A56: 84,
+    0x1A58: 84,
+    0x1A59: 84,
+    0x1A5A: 84,
+    0x1A5B: 84,
+    0x1A5C: 84,
+    0x1A5D: 84,
+    0x1A5E: 84,
+    0x1A60: 84,
+    0x1A62: 84,
+    0x1A65: 84,
+    0x1A66: 84,
+    0x1A67: 84,
+    0x1A68: 84,
+    0x1A69: 84,
+    0x1A6A: 84,
+    0x1A6B: 84,
+    0x1A6C: 84,
+    0x1A73: 84,
+    0x1A74: 84,
+    0x1A75: 84,
+    0x1A76: 84,
+    0x1A77: 84,
+    0x1A78: 84,
+    0x1A79: 84,
+    0x1A7A: 84,
+    0x1A7B: 84,
+    0x1A7C: 84,
+    0x1A7F: 84,
+    0x1AB0: 84,
+    0x1AB1: 84,
+    0x1AB2: 84,
+    0x1AB3: 84,
+    0x1AB4: 84,
+    0x1AB5: 84,
+    0x1AB6: 84,
+    0x1AB7: 84,
+    0x1AB8: 84,
+    0x1AB9: 84,
+    0x1ABA: 84,
+    0x1ABB: 84,
+    0x1ABC: 84,
+    0x1ABD: 84,
+    0x1ABE: 84,
+    0x1ABF: 84,
+    0x1AC0: 84,
+    0x1AC1: 84,
+    0x1AC2: 84,
+    0x1AC3: 84,
+    0x1AC4: 84,
+    0x1AC5: 84,
+    0x1AC6: 84,
+    0x1AC7: 84,
+    0x1AC8: 84,
+    0x1AC9: 84,
+    0x1ACA: 84,
+    0x1ACB: 84,
+    0x1ACC: 84,
+    0x1ACD: 84,
+    0x1ACE: 84,
+    0x1B00: 84,
+    0x1B01: 84,
+    0x1B02: 84,
+    0x1B03: 84,
+    0x1B34: 84,
+    0x1B36: 84,
+    0x1B37: 84,
+    0x1B38: 84,
+    0x1B39: 84,
+    0x1B3A: 84,
+    0x1B3C: 84,
+    0x1B42: 84,
+    0x1B6B: 84,
+    0x1B6C: 84,
+    0x1B6D: 84,
+    0x1B6E: 84,
+    0x1B6F: 84,
+    0x1B70: 84,
+    0x1B71: 84,
+    0x1B72: 84,
+    0x1B73: 84,
+    0x1B80: 84,
+    0x1B81: 84,
+    0x1BA2: 84,
+    0x1BA3: 84,
+    0x1BA4: 84,
+    0x1BA5: 84,
+    0x1BA8: 84,
+    0x1BA9: 84,
+    0x1BAB: 84,
+    0x1BAC: 84,
+    0x1BAD: 84,
+    0x1BE6: 84,
+    0x1BE8: 84,
+    0x1BE9: 84,
+    0x1BED: 84,
+    0x1BEF: 84,
+    0x1BF0: 84,
+    0x1BF1: 84,
+    0x1C2C: 84,
+    0x1C2D: 84,
+    0x1C2E: 84,
+    0x1C2F: 84,
+    0x1C30: 84,
+    0x1C31: 84,
+    0x1C32: 84,
+    0x1C33: 84,
+    0x1C36: 84,
+    0x1C37: 84,
+    0x1CD0: 84,
+    0x1CD1: 84,
+    0x1CD2: 84,
+    0x1CD4: 84,
+    0x1CD5: 84,
+    0x1CD6: 84,
+    0x1CD7: 84,
+    0x1CD8: 84,
+    0x1CD9: 84,
+    0x1CDA: 84,
+    0x1CDB: 84,
+    0x1CDC: 84,
+    0x1CDD: 84,
+    0x1CDE: 84,
+    0x1CDF: 84,
+    0x1CE0: 84,
+    0x1CE2: 84,
+    0x1CE3: 84,
+    0x1CE4: 84,
+    0x1CE5: 84,
+    0x1CE6: 84,
+    0x1CE7: 84,
+    0x1CE8: 84,
+    0x1CED: 84,
+    0x1CF4: 84,
+    0x1CF8: 84,
+    0x1CF9: 84,
+    0x1DC0: 84,
+    0x1DC1: 84,
+    0x1DC2: 84,
+    0x1DC3: 84,
+    0x1DC4: 84,
+    0x1DC5: 84,
+    0x1DC6: 84,
+    0x1DC7: 84,
+    0x1DC8: 84,
+    0x1DC9: 84,
+    0x1DCA: 84,
+    0x1DCB: 84,
+    0x1DCC: 84,
+    0x1DCD: 84,
+    0x1DCE: 84,
+    0x1DCF: 84,
+    0x1DD0: 84,
+    0x1DD1: 84,
+    0x1DD2: 84,
+    0x1DD3: 84,
+    0x1DD4: 84,
+    0x1DD5: 84,
+    0x1DD6: 84,
+    0x1DD7: 84,
+    0x1DD8: 84,
+    0x1DD9: 84,
+    0x1DDA: 84,
+    0x1DDB: 84,
+    0x1DDC: 84,
+    0x1DDD: 84,
+    0x1DDE: 84,
+    0x1DDF: 84,
+    0x1DE0: 84,
+    0x1DE1: 84,
+    0x1DE2: 84,
+    0x1DE3: 84,
+    0x1DE4: 84,
+    0x1DE5: 84,
+    0x1DE6: 84,
+    0x1DE7: 84,
+    0x1DE8: 84,
+    0x1DE9: 84,
+    0x1DEA: 84,
+    0x1DEB: 84,
+    0x1DEC: 84,
+    0x1DED: 84,
+    0x1DEE: 84,
+    0x1DEF: 84,
+    0x1DF0: 84,
+    0x1DF1: 84,
+    0x1DF2: 84,
+    0x1DF3: 84,
+    0x1DF4: 84,
+    0x1DF5: 84,
+    0x1DF6: 84,
+    0x1DF7: 84,
+    0x1DF8: 84,
+    0x1DF9: 84,
+    0x1DFA: 84,
+    0x1DFB: 84,
+    0x1DFC: 84,
+    0x1DFD: 84,
+    0x1DFE: 84,
+    0x1DFF: 84,
+    0x200B: 84,
+    0x200D: 67,
+    0x200E: 84,
+    0x200F: 84,
+    0x202A: 84,
+    0x202B: 84,
+    0x202C: 84,
+    0x202D: 84,
+    0x202E: 84,
     0x2060: 84,
     0x2061: 84,
     0x2062: 84,
     0x2063: 84,
     0x2064: 84,
-    0x206a: 84,
-    0x206b: 84,
-    0x206c: 84,
-    0x206d: 84,
-    0x206e: 84,
-    0x206f: 84,
-    0x20d0: 84,
-    0x20d1: 84,
-    0x20d2: 84,
-    0x20d3: 84,
-    0x20d4: 84,
-    0x20d5: 84,
-    0x20d6: 84,
-    0x20d7: 84,
-    0x20d8: 84,
-    0x20d9: 84,
-    0x20da: 84,
-    0x20db: 84,
-    0x20dc: 84,
-    0x20dd: 84,
-    0x20de: 84,
-    0x20df: 84,
-    0x20e0: 84,
-    0x20e1: 84,
-    0x20e2: 84,
-    0x20e3: 84,
-    0x20e4: 84,
-    0x20e5: 84,
-    0x20e6: 84,
-    0x20e7: 84,
-    0x20e8: 84,
-    0x20e9: 84,
-    0x20ea: 84,
-    0x20eb: 84,
-    0x20ec: 84,
-    0x20ed: 84,
-    0x20ee: 84,
-    0x20ef: 84,
-    0x20f0: 84,
-    0x2cef: 84,
-    0x2cf0: 84,
-    0x2cf1: 84,
-    0x2d7f: 84,
-    0x2de0: 84,
-    0x2de1: 84,
-    0x2de2: 84,
-    0x2de3: 84,
-    0x2de4: 84,
-    0x2de5: 84,
-    0x2de6: 84,
-    0x2de7: 84,
-    0x2de8: 84,
-    0x2de9: 84,
-    0x2dea: 84,
-    0x2deb: 84,
-    0x2dec: 84,
-    0x2ded: 84,
-    0x2dee: 84,
-    0x2def: 84,
-    0x2df0: 84,
-    0x2df1: 84,
-    0x2df2: 84,
-    0x2df3: 84,
-    0x2df4: 84,
-    0x2df5: 84,
-    0x2df6: 84,
-    0x2df7: 84,
-    0x2df8: 84,
-    0x2df9: 84,
-    0x2dfa: 84,
-    0x2dfb: 84,
-    0x2dfc: 84,
-    0x2dfd: 84,
-    0x2dfe: 84,
-    0x2dff: 84,
-    0x302a: 84,
-    0x302b: 84,
-    0x302c: 84,
-    0x302d: 84,
+    0x206A: 84,
+    0x206B: 84,
+    0x206C: 84,
+    0x206D: 84,
+    0x206E: 84,
+    0x206F: 84,
+    0x20D0: 84,
+    0x20D1: 84,
+    0x20D2: 84,
+    0x20D3: 84,
+    0x20D4: 84,
+    0x20D5: 84,
+    0x20D6: 84,
+    0x20D7: 84,
+    0x20D8: 84,
+    0x20D9: 84,
+    0x20DA: 84,
+    0x20DB: 84,
+    0x20DC: 84,
+    0x20DD: 84,
+    0x20DE: 84,
+    0x20DF: 84,
+    0x20E0: 84,
+    0x20E1: 84,
+    0x20E2: 84,
+    0x20E3: 84,
+    0x20E4: 84,
+    0x20E5: 84,
+    0x20E6: 84,
+    0x20E7: 84,
+    0x20E8: 84,
+    0x20E9: 84,
+    0x20EA: 84,
+    0x20EB: 84,
+    0x20EC: 84,
+    0x20ED: 84,
+    0x20EE: 84,
+    0x20EF: 84,
+    0x20F0: 84,
+    0x2CEF: 84,
+    0x2CF0: 84,
+    0x2CF1: 84,
+    0x2D7F: 84,
+    0x2DE0: 84,
+    0x2DE1: 84,
+    0x2DE2: 84,
+    0x2DE3: 84,
+    0x2DE4: 84,
+    0x2DE5: 84,
+    0x2DE6: 84,
+    0x2DE7: 84,
+    0x2DE8: 84,
+    0x2DE9: 84,
+    0x2DEA: 84,
+    0x2DEB: 84,
+    0x2DEC: 84,
+    0x2DED: 84,
+    0x2DEE: 84,
+    0x2DEF: 84,
+    0x2DF0: 84,
+    0x2DF1: 84,
+    0x2DF2: 84,
+    0x2DF3: 84,
+    0x2DF4: 84,
+    0x2DF5: 84,
+    0x2DF6: 84,
+    0x2DF7: 84,
+    0x2DF8: 84,
+    0x2DF9: 84,
+    0x2DFA: 84,
+    0x2DFB: 84,
+    0x2DFC: 84,
+    0x2DFD: 84,
+    0x2DFE: 84,
+    0x2DFF: 84,
+    0x302A: 84,
+    0x302B: 84,
+    0x302C: 84,
+    0x302D: 84,
     0x3099: 84,
-    0x309a: 84,
-    0xa66f: 84,
-    0xa670: 84,
-    0xa671: 84,
-    0xa672: 84,
-    0xa674: 84,
-    0xa675: 84,
-    0xa676: 84,
-    0xa677: 84,
-    0xa678: 84,
-    0xa679: 84,
-    0xa67a: 84,
-    0xa67b: 84,
-    0xa67c: 84,
-    0xa67d: 84,
-    0xa69e: 84,
-    0xa69f: 84,
-    0xa6f0: 84,
-    0xa6f1: 84,
-    0xa802: 84,
-    0xa806: 84,
-    0xa80b: 84,
-    0xa825: 84,
-    0xa826: 84,
-    0xa82c: 84,
-    0xa840: 68,
-    0xa841: 68,
-    0xa842: 68,
-    0xa843: 68,
-    0xa844: 68,
-    0xa845: 68,
-    0xa846: 68,
-    0xa847: 68,
-    0xa848: 68,
-    0xa849: 68,
-    0xa84a: 68,
-    0xa84b: 68,
-    0xa84c: 68,
-    0xa84d: 68,
-    0xa84e: 68,
-    0xa84f: 68,
-    0xa850: 68,
-    0xa851: 68,
-    0xa852: 68,
-    0xa853: 68,
-    0xa854: 68,
-    0xa855: 68,
-    0xa856: 68,
-    0xa857: 68,
-    0xa858: 68,
-    0xa859: 68,
-    0xa85a: 68,
-    0xa85b: 68,
-    0xa85c: 68,
-    0xa85d: 68,
-    0xa85e: 68,
-    0xa85f: 68,
-    0xa860: 68,
-    0xa861: 68,
-    0xa862: 68,
-    0xa863: 68,
-    0xa864: 68,
-    0xa865: 68,
-    0xa866: 68,
-    0xa867: 68,
-    0xa868: 68,
-    0xa869: 68,
-    0xa86a: 68,
-    0xa86b: 68,
-    0xa86c: 68,
-    0xa86d: 68,
-    0xa86e: 68,
-    0xa86f: 68,
-    0xa870: 68,
-    0xa871: 68,
-    0xa872: 76,
-    0xa8c4: 84,
-    0xa8c5: 84,
-    0xa8e0: 84,
-    0xa8e1: 84,
-    0xa8e2: 84,
-    0xa8e3: 84,
-    0xa8e4: 84,
-    0xa8e5: 84,
-    0xa8e6: 84,
-    0xa8e7: 84,
-    0xa8e8: 84,
-    0xa8e9: 84,
-    0xa8ea: 84,
-    0xa8eb: 84,
-    0xa8ec: 84,
-    0xa8ed: 84,
-    0xa8ee: 84,
-    0xa8ef: 84,
-    0xa8f0: 84,
-    0xa8f1: 84,
-    0xa8ff: 84,
-    0xa926: 84,
-    0xa927: 84,
-    0xa928: 84,
-    0xa929: 84,
-    0xa92a: 84,
-    0xa92b: 84,
-    0xa92c: 84,
-    0xa92d: 84,
-    0xa947: 84,
-    0xa948: 84,
-    0xa949: 84,
-    0xa94a: 84,
-    0xa94b: 84,
-    0xa94c: 84,
-    0xa94d: 84,
-    0xa94e: 84,
-    0xa94f: 84,
-    0xa950: 84,
-    0xa951: 84,
-    0xa980: 84,
-    0xa981: 84,
-    0xa982: 84,
-    0xa9b3: 84,
-    0xa9b6: 84,
-    0xa9b7: 84,
-    0xa9b8: 84,
-    0xa9b9: 84,
-    0xa9bc: 84,
-    0xa9bd: 84,
-    0xa9e5: 84,
-    0xaa29: 84,
-    0xaa2a: 84,
-    0xaa2b: 84,
-    0xaa2c: 84,
-    0xaa2d: 84,
-    0xaa2e: 84,
-    0xaa31: 84,
-    0xaa32: 84,
-    0xaa35: 84,
-    0xaa36: 84,
-    0xaa43: 84,
-    0xaa4c: 84,
-    0xaa7c: 84,
-    0xaab0: 84,
-    0xaab2: 84,
-    0xaab3: 84,
-    0xaab4: 84,
-    0xaab7: 84,
-    0xaab8: 84,
-    0xaabe: 84,
-    0xaabf: 84,
-    0xaac1: 84,
-    0xaaec: 84,
-    0xaaed: 84,
-    0xaaf6: 84,
-    0xabe5: 84,
-    0xabe8: 84,
-    0xabed: 84,
-    0xfb1e: 84,
-    0xfe00: 84,
-    0xfe01: 84,
-    0xfe02: 84,
-    0xfe03: 84,
-    0xfe04: 84,
-    0xfe05: 84,
-    0xfe06: 84,
-    0xfe07: 84,
-    0xfe08: 84,
-    0xfe09: 84,
-    0xfe0a: 84,
-    0xfe0b: 84,
-    0xfe0c: 84,
-    0xfe0d: 84,
-    0xfe0e: 84,
-    0xfe0f: 84,
-    0xfe20: 84,
-    0xfe21: 84,
-    0xfe22: 84,
-    0xfe23: 84,
-    0xfe24: 84,
-    0xfe25: 84,
-    0xfe26: 84,
-    0xfe27: 84,
-    0xfe28: 84,
-    0xfe29: 84,
-    0xfe2a: 84,
-    0xfe2b: 84,
-    0xfe2c: 84,
-    0xfe2d: 84,
-    0xfe2e: 84,
-    0xfe2f: 84,
-    0xfeff: 84,
-    0xfff9: 84,
-    0xfffa: 84,
-    0xfffb: 84,
-    0x101fd: 84,
-    0x102e0: 84,
+    0x309A: 84,
+    0xA66F: 84,
+    0xA670: 84,
+    0xA671: 84,
+    0xA672: 84,
+    0xA674: 84,
+    0xA675: 84,
+    0xA676: 84,
+    0xA677: 84,
+    0xA678: 84,
+    0xA679: 84,
+    0xA67A: 84,
+    0xA67B: 84,
+    0xA67C: 84,
+    0xA67D: 84,
+    0xA69E: 84,
+    0xA69F: 84,
+    0xA6F0: 84,
+    0xA6F1: 84,
+    0xA802: 84,
+    0xA806: 84,
+    0xA80B: 84,
+    0xA825: 84,
+    0xA826: 84,
+    0xA82C: 84,
+    0xA840: 68,
+    0xA841: 68,
+    0xA842: 68,
+    0xA843: 68,
+    0xA844: 68,
+    0xA845: 68,
+    0xA846: 68,
+    0xA847: 68,
+    0xA848: 68,
+    0xA849: 68,
+    0xA84A: 68,
+    0xA84B: 68,
+    0xA84C: 68,
+    0xA84D: 68,
+    0xA84E: 68,
+    0xA84F: 68,
+    0xA850: 68,
+    0xA851: 68,
+    0xA852: 68,
+    0xA853: 68,
+    0xA854: 68,
+    0xA855: 68,
+    0xA856: 68,
+    0xA857: 68,
+    0xA858: 68,
+    0xA859: 68,
+    0xA85A: 68,
+    0xA85B: 68,
+    0xA85C: 68,
+    0xA85D: 68,
+    0xA85E: 68,
+    0xA85F: 68,
+    0xA860: 68,
+    0xA861: 68,
+    0xA862: 68,
+    0xA863: 68,
+    0xA864: 68,
+    0xA865: 68,
+    0xA866: 68,
+    0xA867: 68,
+    0xA868: 68,
+    0xA869: 68,
+    0xA86A: 68,
+    0xA86B: 68,
+    0xA86C: 68,
+    0xA86D: 68,
+    0xA86E: 68,
+    0xA86F: 68,
+    0xA870: 68,
+    0xA871: 68,
+    0xA872: 76,
+    0xA8C4: 84,
+    0xA8C5: 84,
+    0xA8E0: 84,
+    0xA8E1: 84,
+    0xA8E2: 84,
+    0xA8E3: 84,
+    0xA8E4: 84,
+    0xA8E5: 84,
+    0xA8E6: 84,
+    0xA8E7: 84,
+    0xA8E8: 84,
+    0xA8E9: 84,
+    0xA8EA: 84,
+    0xA8EB: 84,
+    0xA8EC: 84,
+    0xA8ED: 84,
+    0xA8EE: 84,
+    0xA8EF: 84,
+    0xA8F0: 84,
+    0xA8F1: 84,
+    0xA8FF: 84,
+    0xA926: 84,
+    0xA927: 84,
+    0xA928: 84,
+    0xA929: 84,
+    0xA92A: 84,
+    0xA92B: 84,
+    0xA92C: 84,
+    0xA92D: 84,
+    0xA947: 84,
+    0xA948: 84,
+    0xA949: 84,
+    0xA94A: 84,
+    0xA94B: 84,
+    0xA94C: 84,
+    0xA94D: 84,
+    0xA94E: 84,
+    0xA94F: 84,
+    0xA950: 84,
+    0xA951: 84,
+    0xA980: 84,
+    0xA981: 84,
+    0xA982: 84,
+    0xA9B3: 84,
+    0xA9B6: 84,
+    0xA9B7: 84,
+    0xA9B8: 84,
+    0xA9B9: 84,
+    0xA9BC: 84,
+    0xA9BD: 84,
+    0xA9E5: 84,
+    0xAA29: 84,
+    0xAA2A: 84,
+    0xAA2B: 84,
+    0xAA2C: 84,
+    0xAA2D: 84,
+    0xAA2E: 84,
+    0xAA31: 84,
+    0xAA32: 84,
+    0xAA35: 84,
+    0xAA36: 84,
+    0xAA43: 84,
+    0xAA4C: 84,
+    0xAA7C: 84,
+    0xAAB0: 84,
+    0xAAB2: 84,
+    0xAAB3: 84,
+    0xAAB4: 84,
+    0xAAB7: 84,
+    0xAAB8: 84,
+    0xAABE: 84,
+    0xAABF: 84,
+    0xAAC1: 84,
+    0xAAEC: 84,
+    0xAAED: 84,
+    0xAAF6: 84,
+    0xABE5: 84,
+    0xABE8: 84,
+    0xABED: 84,
+    0xFB1E: 84,
+    0xFE00: 84,
+    0xFE01: 84,
+    0xFE02: 84,
+    0xFE03: 84,
+    0xFE04: 84,
+    0xFE05: 84,
+    0xFE06: 84,
+    0xFE07: 84,
+    0xFE08: 84,
+    0xFE09: 84,
+    0xFE0A: 84,
+    0xFE0B: 84,
+    0xFE0C: 84,
+    0xFE0D: 84,
+    0xFE0E: 84,
+    0xFE0F: 84,
+    0xFE20: 84,
+    0xFE21: 84,
+    0xFE22: 84,
+    0xFE23: 84,
+    0xFE24: 84,
+    0xFE25: 84,
+    0xFE26: 84,
+    0xFE27: 84,
+    0xFE28: 84,
+    0xFE29: 84,
+    0xFE2A: 84,
+    0xFE2B: 84,
+    0xFE2C: 84,
+    0xFE2D: 84,
+    0xFE2E: 84,
+    0xFE2F: 84,
+    0xFEFF: 84,
+    0xFFF9: 84,
+    0xFFFA: 84,
+    0xFFFB: 84,
+    0x101FD: 84,
+    0x102E0: 84,
     0x10376: 84,
     0x10377: 84,
     0x10378: 84,
     0x10379: 84,
-    0x1037a: 84,
-    0x10a01: 84,
-    0x10a02: 84,
-    0x10a03: 84,
-    0x10a05: 84,
-    0x10a06: 84,
-    0x10a0c: 84,
-    0x10a0d: 84,
-    0x10a0e: 84,
-    0x10a0f: 84,
-    0x10a38: 84,
-    0x10a39: 84,
-    0x10a3a: 84,
-    0x10a3f: 84,
-    0x10ac0: 68,
-    0x10ac1: 68,
-    0x10ac2: 68,
-    0x10ac3: 68,
-    0x10ac4: 68,
-    0x10ac5: 82,
-    0x10ac7: 82,
-    0x10ac9: 82,
-    0x10aca: 82,
-    0x10acd: 76,
-    0x10ace: 82,
-    0x10acf: 82,
-    0x10ad0: 82,
-    0x10ad1: 82,
-    0x10ad2: 82,
-    0x10ad3: 68,
-    0x10ad4: 68,
-    0x10ad5: 68,
-    0x10ad6: 68,
-    0x10ad7: 76,
-    0x10ad8: 68,
-    0x10ad9: 68,
-    0x10ada: 68,
-    0x10adb: 68,
-    0x10adc: 68,
-    0x10add: 82,
-    0x10ade: 68,
-    0x10adf: 68,
-    0x10ae0: 68,
-    0x10ae1: 82,
-    0x10ae4: 82,
-    0x10ae5: 84,
-    0x10ae6: 84,
-    0x10aeb: 68,
-    0x10aec: 68,
-    0x10aed: 68,
-    0x10aee: 68,
-    0x10aef: 82,
-    0x10b80: 68,
-    0x10b81: 82,
-    0x10b82: 68,
-    0x10b83: 82,
-    0x10b84: 82,
-    0x10b85: 82,
-    0x10b86: 68,
-    0x10b87: 68,
-    0x10b88: 68,
-    0x10b89: 82,
-    0x10b8a: 68,
-    0x10b8b: 68,
-    0x10b8c: 82,
-    0x10b8d: 68,
-    0x10b8e: 82,
-    0x10b8f: 82,
-    0x10b90: 68,
-    0x10b91: 82,
-    0x10ba9: 82,
-    0x10baa: 82,
-    0x10bab: 82,
-    0x10bac: 82,
-    0x10bad: 68,
-    0x10bae: 68,
-    0x10d00: 76,
-    0x10d01: 68,
-    0x10d02: 68,
-    0x10d03: 68,
-    0x10d04: 68,
-    0x10d05: 68,
-    0x10d06: 68,
-    0x10d07: 68,
-    0x10d08: 68,
-    0x10d09: 68,
-    0x10d0a: 68,
-    0x10d0b: 68,
-    0x10d0c: 68,
-    0x10d0d: 68,
-    0x10d0e: 68,
-    0x10d0f: 68,
-    0x10d10: 68,
-    0x10d11: 68,
-    0x10d12: 68,
-    0x10d13: 68,
-    0x10d14: 68,
-    0x10d15: 68,
-    0x10d16: 68,
-    0x10d17: 68,
-    0x10d18: 68,
-    0x10d19: 68,
-    0x10d1a: 68,
-    0x10d1b: 68,
-    0x10d1c: 68,
-    0x10d1d: 68,
-    0x10d1e: 68,
-    0x10d1f: 68,
-    0x10d20: 68,
-    0x10d21: 68,
-    0x10d22: 82,
-    0x10d23: 68,
-    0x10d24: 84,
-    0x10d25: 84,
-    0x10d26: 84,
-    0x10d27: 84,
-    0x10eab: 84,
-    0x10eac: 84,
-    0x10efd: 84,
-    0x10efe: 84,
-    0x10eff: 84,
-    0x10f30: 68,
-    0x10f31: 68,
-    0x10f32: 68,
-    0x10f33: 82,
-    0x10f34: 68,
-    0x10f35: 68,
-    0x10f36: 68,
-    0x10f37: 68,
-    0x10f38: 68,
-    0x10f39: 68,
-    0x10f3a: 68,
-    0x10f3b: 68,
-    0x10f3c: 68,
-    0x10f3d: 68,
-    0x10f3e: 68,
-    0x10f3f: 68,
-    0x10f40: 68,
-    0x10f41: 68,
-    0x10f42: 68,
-    0x10f43: 68,
-    0x10f44: 68,
-    0x10f46: 84,
-    0x10f47: 84,
-    0x10f48: 84,
-    0x10f49: 84,
-    0x10f4a: 84,
-    0x10f4b: 84,
-    0x10f4c: 84,
-    0x10f4d: 84,
-    0x10f4e: 84,
-    0x10f4f: 84,
-    0x10f50: 84,
-    0x10f51: 68,
-    0x10f52: 68,
-    0x10f53: 68,
-    0x10f54: 82,
-    0x10f70: 68,
-    0x10f71: 68,
-    0x10f72: 68,
-    0x10f73: 68,
-    0x10f74: 82,
-    0x10f75: 82,
-    0x10f76: 68,
-    0x10f77: 68,
-    0x10f78: 68,
-    0x10f79: 68,
-    0x10f7a: 68,
-    0x10f7b: 68,
-    0x10f7c: 68,
-    0x10f7d: 68,
-    0x10f7e: 68,
-    0x10f7f: 68,
-    0x10f80: 68,
-    0x10f81: 68,
-    0x10f82: 84,
-    0x10f83: 84,
-    0x10f84: 84,
-    0x10f85: 84,
-    0x10fb0: 68,
-    0x10fb2: 68,
-    0x10fb3: 68,
-    0x10fb4: 82,
-    0x10fb5: 82,
-    0x10fb6: 82,
-    0x10fb8: 68,
-    0x10fb9: 82,
-    0x10fba: 82,
-    0x10fbb: 68,
-    0x10fbc: 68,
-    0x10fbd: 82,
-    0x10fbe: 68,
-    0x10fbf: 68,
-    0x10fc1: 68,
-    0x10fc2: 82,
-    0x10fc3: 82,
-    0x10fc4: 68,
-    0x10fc9: 82,
-    0x10fca: 68,
-    0x10fcb: 76,
+    0x1037A: 84,
+    0x10A01: 84,
+    0x10A02: 84,
+    0x10A03: 84,
+    0x10A05: 84,
+    0x10A06: 84,
+    0x10A0C: 84,
+    0x10A0D: 84,
+    0x10A0E: 84,
+    0x10A0F: 84,
+    0x10A38: 84,
+    0x10A39: 84,
+    0x10A3A: 84,
+    0x10A3F: 84,
+    0x10AC0: 68,
+    0x10AC1: 68,
+    0x10AC2: 68,
+    0x10AC3: 68,
+    0x10AC4: 68,
+    0x10AC5: 82,
+    0x10AC7: 82,
+    0x10AC9: 82,
+    0x10ACA: 82,
+    0x10ACD: 76,
+    0x10ACE: 82,
+    0x10ACF: 82,
+    0x10AD0: 82,
+    0x10AD1: 82,
+    0x10AD2: 82,
+    0x10AD3: 68,
+    0x10AD4: 68,
+    0x10AD5: 68,
+    0x10AD6: 68,
+    0x10AD7: 76,
+    0x10AD8: 68,
+    0x10AD9: 68,
+    0x10ADA: 68,
+    0x10ADB: 68,
+    0x10ADC: 68,
+    0x10ADD: 82,
+    0x10ADE: 68,
+    0x10ADF: 68,
+    0x10AE0: 68,
+    0x10AE1: 82,
+    0x10AE4: 82,
+    0x10AE5: 84,
+    0x10AE6: 84,
+    0x10AEB: 68,
+    0x10AEC: 68,
+    0x10AED: 68,
+    0x10AEE: 68,
+    0x10AEF: 82,
+    0x10B80: 68,
+    0x10B81: 82,
+    0x10B82: 68,
+    0x10B83: 82,
+    0x10B84: 82,
+    0x10B85: 82,
+    0x10B86: 68,
+    0x10B87: 68,
+    0x10B88: 68,
+    0x10B89: 82,
+    0x10B8A: 68,
+    0x10B8B: 68,
+    0x10B8C: 82,
+    0x10B8D: 68,
+    0x10B8E: 82,
+    0x10B8F: 82,
+    0x10B90: 68,
+    0x10B91: 82,
+    0x10BA9: 82,
+    0x10BAA: 82,
+    0x10BAB: 82,
+    0x10BAC: 82,
+    0x10BAD: 68,
+    0x10BAE: 68,
+    0x10D00: 76,
+    0x10D01: 68,
+    0x10D02: 68,
+    0x10D03: 68,
+    0x10D04: 68,
+    0x10D05: 68,
+    0x10D06: 68,
+    0x10D07: 68,
+    0x10D08: 68,
+    0x10D09: 68,
+    0x10D0A: 68,
+    0x10D0B: 68,
+    0x10D0C: 68,
+    0x10D0D: 68,
+    0x10D0E: 68,
+    0x10D0F: 68,
+    0x10D10: 68,
+    0x10D11: 68,
+    0x10D12: 68,
+    0x10D13: 68,
+    0x10D14: 68,
+    0x10D15: 68,
+    0x10D16: 68,
+    0x10D17: 68,
+    0x10D18: 68,
+    0x10D19: 68,
+    0x10D1A: 68,
+    0x10D1B: 68,
+    0x10D1C: 68,
+    0x10D1D: 68,
+    0x10D1E: 68,
+    0x10D1F: 68,
+    0x10D20: 68,
+    0x10D21: 68,
+    0x10D22: 82,
+    0x10D23: 68,
+    0x10D24: 84,
+    0x10D25: 84,
+    0x10D26: 84,
+    0x10D27: 84,
+    0x10EAB: 84,
+    0x10EAC: 84,
+    0x10EFD: 84,
+    0x10EFE: 84,
+    0x10EFF: 84,
+    0x10F30: 68,
+    0x10F31: 68,
+    0x10F32: 68,
+    0x10F33: 82,
+    0x10F34: 68,
+    0x10F35: 68,
+    0x10F36: 68,
+    0x10F37: 68,
+    0x10F38: 68,
+    0x10F39: 68,
+    0x10F3A: 68,
+    0x10F3B: 68,
+    0x10F3C: 68,
+    0x10F3D: 68,
+    0x10F3E: 68,
+    0x10F3F: 68,
+    0x10F40: 68,
+    0x10F41: 68,
+    0x10F42: 68,
+    0x10F43: 68,
+    0x10F44: 68,
+    0x10F46: 84,
+    0x10F47: 84,
+    0x10F48: 84,
+    0x10F49: 84,
+    0x10F4A: 84,
+    0x10F4B: 84,
+    0x10F4C: 84,
+    0x10F4D: 84,
+    0x10F4E: 84,
+    0x10F4F: 84,
+    0x10F50: 84,
+    0x10F51: 68,
+    0x10F52: 68,
+    0x10F53: 68,
+    0x10F54: 82,
+    0x10F70: 68,
+    0x10F71: 68,
+    0x10F72: 68,
+    0x10F73: 68,
+    0x10F74: 82,
+    0x10F75: 82,
+    0x10F76: 68,
+    0x10F77: 68,
+    0x10F78: 68,
+    0x10F79: 68,
+    0x10F7A: 68,
+    0x10F7B: 68,
+    0x10F7C: 68,
+    0x10F7D: 68,
+    0x10F7E: 68,
+    0x10F7F: 68,
+    0x10F80: 68,
+    0x10F81: 68,
+    0x10F82: 84,
+    0x10F83: 84,
+    0x10F84: 84,
+    0x10F85: 84,
+    0x10FB0: 68,
+    0x10FB2: 68,
+    0x10FB3: 68,
+    0x10FB4: 82,
+    0x10FB5: 82,
+    0x10FB6: 82,
+    0x10FB8: 68,
+    0x10FB9: 82,
+    0x10FBA: 82,
+    0x10FBB: 68,
+    0x10FBC: 68,
+    0x10FBD: 82,
+    0x10FBE: 68,
+    0x10FBF: 68,
+    0x10FC1: 68,
+    0x10FC2: 82,
+    0x10FC3: 82,
+    0x10FC4: 68,
+    0x10FC9: 82,
+    0x10FCA: 68,
+    0x10FCB: 76,
     0x11001: 84,
     0x11038: 84,
     0x11039: 84,
-    0x1103a: 84,
-    0x1103b: 84,
-    0x1103c: 84,
-    0x1103d: 84,
-    0x1103e: 84,
-    0x1103f: 84,
+    0x1103A: 84,
+    0x1103B: 84,
+    0x1103C: 84,
+    0x1103D: 84,
+    0x1103E: 84,
+    0x1103F: 84,
     0x11040: 84,
     0x11041: 84,
     0x11042: 84,
@@ -1976,27 +1976,27 @@ joining_types = {
     0x11070: 84,
     0x11073: 84,
     0x11074: 84,
-    0x1107f: 84,
+    0x1107F: 84,
     0x11080: 84,
     0x11081: 84,
-    0x110b3: 84,
-    0x110b4: 84,
-    0x110b5: 84,
-    0x110b6: 84,
-    0x110b9: 84,
-    0x110ba: 84,
-    0x110c2: 84,
+    0x110B3: 84,
+    0x110B4: 84,
+    0x110B5: 84,
+    0x110B6: 84,
+    0x110B9: 84,
+    0x110BA: 84,
+    0x110C2: 84,
     0x11100: 84,
     0x11101: 84,
     0x11102: 84,
     0x11127: 84,
     0x11128: 84,
     0x11129: 84,
-    0x1112a: 84,
-    0x1112b: 84,
-    0x1112d: 84,
-    0x1112e: 84,
-    0x1112f: 84,
+    0x1112A: 84,
+    0x1112B: 84,
+    0x1112D: 84,
+    0x1112E: 84,
+    0x1112F: 84,
     0x11130: 84,
     0x11131: 84,
     0x11132: 84,
@@ -2005,49 +2005,49 @@ joining_types = {
     0x11173: 84,
     0x11180: 84,
     0x11181: 84,
-    0x111b6: 84,
-    0x111b7: 84,
-    0x111b8: 84,
-    0x111b9: 84,
-    0x111ba: 84,
-    0x111bb: 84,
-    0x111bc: 84,
-    0x111bd: 84,
-    0x111be: 84,
-    0x111c9: 84,
-    0x111ca: 84,
-    0x111cb: 84,
-    0x111cc: 84,
-    0x111cf: 84,
-    0x1122f: 84,
+    0x111B6: 84,
+    0x111B7: 84,
+    0x111B8: 84,
+    0x111B9: 84,
+    0x111BA: 84,
+    0x111BB: 84,
+    0x111BC: 84,
+    0x111BD: 84,
+    0x111BE: 84,
+    0x111C9: 84,
+    0x111CA: 84,
+    0x111CB: 84,
+    0x111CC: 84,
+    0x111CF: 84,
+    0x1122F: 84,
     0x11230: 84,
     0x11231: 84,
     0x11234: 84,
     0x11236: 84,
     0x11237: 84,
-    0x1123e: 84,
+    0x1123E: 84,
     0x11241: 84,
-    0x112df: 84,
-    0x112e3: 84,
-    0x112e4: 84,
-    0x112e5: 84,
-    0x112e6: 84,
-    0x112e7: 84,
-    0x112e8: 84,
-    0x112e9: 84,
-    0x112ea: 84,
+    0x112DF: 84,
+    0x112E3: 84,
+    0x112E4: 84,
+    0x112E5: 84,
+    0x112E6: 84,
+    0x112E7: 84,
+    0x112E8: 84,
+    0x112E9: 84,
+    0x112EA: 84,
     0x11300: 84,
     0x11301: 84,
-    0x1133b: 84,
-    0x1133c: 84,
+    0x1133B: 84,
+    0x1133C: 84,
     0x11340: 84,
     0x11366: 84,
     0x11367: 84,
     0x11368: 84,
     0x11369: 84,
-    0x1136a: 84,
-    0x1136b: 84,
-    0x1136c: 84,
+    0x1136A: 84,
+    0x1136B: 84,
+    0x1136C: 84,
     0x11370: 84,
     0x11371: 84,
     0x11372: 84,
@@ -2055,38 +2055,38 @@ joining_types = {
     0x11374: 84,
     0x11438: 84,
     0x11439: 84,
-    0x1143a: 84,
-    0x1143b: 84,
-    0x1143c: 84,
-    0x1143d: 84,
-    0x1143e: 84,
-    0x1143f: 84,
+    0x1143A: 84,
+    0x1143B: 84,
+    0x1143C: 84,
+    0x1143D: 84,
+    0x1143E: 84,
+    0x1143F: 84,
     0x11442: 84,
     0x11443: 84,
     0x11444: 84,
     0x11446: 84,
-    0x1145e: 84,
-    0x114b3: 84,
-    0x114b4: 84,
-    0x114b5: 84,
-    0x114b6: 84,
-    0x114b7: 84,
-    0x114b8: 84,
-    0x114ba: 84,
-    0x114bf: 84,
-    0x114c0: 84,
-    0x114c2: 84,
-    0x114c3: 84,
-    0x115b2: 84,
-    0x115b3: 84,
-    0x115b4: 84,
-    0x115b5: 84,
-    0x115bc: 84,
-    0x115bd: 84,
-    0x115bf: 84,
-    0x115c0: 84,
-    0x115dc: 84,
-    0x115dd: 84,
+    0x1145E: 84,
+    0x114B3: 84,
+    0x114B4: 84,
+    0x114B5: 84,
+    0x114B6: 84,
+    0x114B7: 84,
+    0x114B8: 84,
+    0x114BA: 84,
+    0x114BF: 84,
+    0x114C0: 84,
+    0x114C2: 84,
+    0x114C3: 84,
+    0x115B2: 84,
+    0x115B3: 84,
+    0x115B4: 84,
+    0x115B5: 84,
+    0x115BC: 84,
+    0x115BD: 84,
+    0x115BF: 84,
+    0x115C0: 84,
+    0x115DC: 84,
+    0x115DD: 84,
     0x11633: 84,
     0x11634: 84,
     0x11635: 84,
@@ -2094,22 +2094,22 @@ joining_types = {
     0x11637: 84,
     0x11638: 84,
     0x11639: 84,
-    0x1163a: 84,
-    0x1163d: 84,
-    0x1163f: 84,
+    0x1163A: 84,
+    0x1163D: 84,
+    0x1163F: 84,
     0x11640: 84,
-    0x116ab: 84,
-    0x116ad: 84,
-    0x116b0: 84,
-    0x116b1: 84,
-    0x116b2: 84,
-    0x116b3: 84,
-    0x116b4: 84,
-    0x116b5: 84,
-    0x116b7: 84,
-    0x1171d: 84,
-    0x1171e: 84,
-    0x1171f: 84,
+    0x116AB: 84,
+    0x116AD: 84,
+    0x116B0: 84,
+    0x116B1: 84,
+    0x116B2: 84,
+    0x116B3: 84,
+    0x116B4: 84,
+    0x116B5: 84,
+    0x116B7: 84,
+    0x1171D: 84,
+    0x1171E: 84,
+    0x1171F: 84,
     0x11722: 84,
     0x11723: 84,
     0x11724: 84,
@@ -2117,9 +2117,9 @@ joining_types = {
     0x11727: 84,
     0x11728: 84,
     0x11729: 84,
-    0x1172a: 84,
-    0x1172b: 84,
-    0x1182f: 84,
+    0x1172A: 84,
+    0x1172B: 84,
+    0x1182F: 84,
     0x11830: 84,
     0x11831: 84,
     0x11832: 84,
@@ -2129,142 +2129,142 @@ joining_types = {
     0x11836: 84,
     0x11837: 84,
     0x11839: 84,
-    0x1183a: 84,
-    0x1193b: 84,
-    0x1193c: 84,
-    0x1193e: 84,
+    0x1183A: 84,
+    0x1193B: 84,
+    0x1193C: 84,
+    0x1193E: 84,
     0x11943: 84,
-    0x119d4: 84,
-    0x119d5: 84,
-    0x119d6: 84,
-    0x119d7: 84,
-    0x119da: 84,
-    0x119db: 84,
-    0x119e0: 84,
-    0x11a01: 84,
-    0x11a02: 84,
-    0x11a03: 84,
-    0x11a04: 84,
-    0x11a05: 84,
-    0x11a06: 84,
-    0x11a07: 84,
-    0x11a08: 84,
-    0x11a09: 84,
-    0x11a0a: 84,
-    0x11a33: 84,
-    0x11a34: 84,
-    0x11a35: 84,
-    0x11a36: 84,
-    0x11a37: 84,
-    0x11a38: 84,
-    0x11a3b: 84,
-    0x11a3c: 84,
-    0x11a3d: 84,
-    0x11a3e: 84,
-    0x11a47: 84,
-    0x11a51: 84,
-    0x11a52: 84,
-    0x11a53: 84,
-    0x11a54: 84,
-    0x11a55: 84,
-    0x11a56: 84,
-    0x11a59: 84,
-    0x11a5a: 84,
-    0x11a5b: 84,
-    0x11a8a: 84,
-    0x11a8b: 84,
-    0x11a8c: 84,
-    0x11a8d: 84,
-    0x11a8e: 84,
-    0x11a8f: 84,
-    0x11a90: 84,
-    0x11a91: 84,
-    0x11a92: 84,
-    0x11a93: 84,
-    0x11a94: 84,
-    0x11a95: 84,
-    0x11a96: 84,
-    0x11a98: 84,
-    0x11a99: 84,
-    0x11c30: 84,
-    0x11c31: 84,
-    0x11c32: 84,
-    0x11c33: 84,
-    0x11c34: 84,
-    0x11c35: 84,
-    0x11c36: 84,
-    0x11c38: 84,
-    0x11c39: 84,
-    0x11c3a: 84,
-    0x11c3b: 84,
-    0x11c3c: 84,
-    0x11c3d: 84,
-    0x11c3f: 84,
-    0x11c92: 84,
-    0x11c93: 84,
-    0x11c94: 84,
-    0x11c95: 84,
-    0x11c96: 84,
-    0x11c97: 84,
-    0x11c98: 84,
-    0x11c99: 84,
-    0x11c9a: 84,
-    0x11c9b: 84,
-    0x11c9c: 84,
-    0x11c9d: 84,
-    0x11c9e: 84,
-    0x11c9f: 84,
-    0x11ca0: 84,
-    0x11ca1: 84,
-    0x11ca2: 84,
-    0x11ca3: 84,
-    0x11ca4: 84,
-    0x11ca5: 84,
-    0x11ca6: 84,
-    0x11ca7: 84,
-    0x11caa: 84,
-    0x11cab: 84,
-    0x11cac: 84,
-    0x11cad: 84,
-    0x11cae: 84,
-    0x11caf: 84,
-    0x11cb0: 84,
-    0x11cb2: 84,
-    0x11cb3: 84,
-    0x11cb5: 84,
-    0x11cb6: 84,
-    0x11d31: 84,
-    0x11d32: 84,
-    0x11d33: 84,
-    0x11d34: 84,
-    0x11d35: 84,
-    0x11d36: 84,
-    0x11d3a: 84,
-    0x11d3c: 84,
-    0x11d3d: 84,
-    0x11d3f: 84,
-    0x11d40: 84,
-    0x11d41: 84,
-    0x11d42: 84,
-    0x11d43: 84,
-    0x11d44: 84,
-    0x11d45: 84,
-    0x11d47: 84,
-    0x11d90: 84,
-    0x11d91: 84,
-    0x11d95: 84,
-    0x11d97: 84,
-    0x11ef3: 84,
-    0x11ef4: 84,
-    0x11f00: 84,
-    0x11f01: 84,
-    0x11f36: 84,
-    0x11f37: 84,
-    0x11f38: 84,
-    0x11f39: 84,
-    0x11f3a: 84,
-    0x11f40: 84,
-    0x11f42: 84,
+    0x119D4: 84,
+    0x119D5: 84,
+    0x119D6: 84,
+    0x119D7: 84,
+    0x119DA: 84,
+    0x119DB: 84,
+    0x119E0: 84,
+    0x11A01: 84,
+    0x11A02: 84,
+    0x11A03: 84,
+    0x11A04: 84,
+    0x11A05: 84,
+    0x11A06: 84,
+    0x11A07: 84,
+    0x11A08: 84,
+    0x11A09: 84,
+    0x11A0A: 84,
+    0x11A33: 84,
+    0x11A34: 84,
+    0x11A35: 84,
+    0x11A36: 84,
+    0x11A37: 84,
+    0x11A38: 84,
+    0x11A3B: 84,
+    0x11A3C: 84,
+    0x11A3D: 84,
+    0x11A3E: 84,
+    0x11A47: 84,
+    0x11A51: 84,
+    0x11A52: 84,
+    0x11A53: 84,
+    0x11A54: 84,
+    0x11A55: 84,
+    0x11A56: 84,
+    0x11A59: 84,
+    0x11A5A: 84,
+    0x11A5B: 84,
+    0x11A8A: 84,
+    0x11A8B: 84,
+    0x11A8C: 84,
+    0x11A8D: 84,
+    0x11A8E: 84,
+    0x11A8F: 84,
+    0x11A90: 84,
+    0x11A91: 84,
+    0x11A92: 84,
+    0x11A93: 84,
+    0x11A94: 84,
+    0x11A95: 84,
+    0x11A96: 84,
+    0x11A98: 84,
+    0x11A99: 84,
+    0x11C30: 84,
+    0x11C31: 84,
+    0x11C32: 84,
+    0x11C33: 84,
+    0x11C34: 84,
+    0x11C35: 84,
+    0x11C36: 84,
+    0x11C38: 84,
+    0x11C39: 84,
+    0x11C3A: 84,
+    0x11C3B: 84,
+    0x11C3C: 84,
+    0x11C3D: 84,
+    0x11C3F: 84,
+    0x11C92: 84,
+    0x11C93: 84,
+    0x11C94: 84,
+    0x11C95: 84,
+    0x11C96: 84,
+    0x11C97: 84,
+    0x11C98: 84,
+    0x11C99: 84,
+    0x11C9A: 84,
+    0x11C9B: 84,
+    0x11C9C: 84,
+    0x11C9D: 84,
+    0x11C9E: 84,
+    0x11C9F: 84,
+    0x11CA0: 84,
+    0x11CA1: 84,
+    0x11CA2: 84,
+    0x11CA3: 84,
+    0x11CA4: 84,
+    0x11CA5: 84,
+    0x11CA6: 84,
+    0x11CA7: 84,
+    0x11CAA: 84,
+    0x11CAB: 84,
+    0x11CAC: 84,
+    0x11CAD: 84,
+    0x11CAE: 84,
+    0x11CAF: 84,
+    0x11CB0: 84,
+    0x11CB2: 84,
+    0x11CB3: 84,
+    0x11CB5: 84,
+    0x11CB6: 84,
+    0x11D31: 84,
+    0x11D32: 84,
+    0x11D33: 84,
+    0x11D34: 84,
+    0x11D35: 84,
+    0x11D36: 84,
+    0x11D3A: 84,
+    0x11D3C: 84,
+    0x11D3D: 84,
+    0x11D3F: 84,
+    0x11D40: 84,
+    0x11D41: 84,
+    0x11D42: 84,
+    0x11D43: 84,
+    0x11D44: 84,
+    0x11D45: 84,
+    0x11D47: 84,
+    0x11D90: 84,
+    0x11D91: 84,
+    0x11D95: 84,
+    0x11D97: 84,
+    0x11EF3: 84,
+    0x11EF4: 84,
+    0x11F00: 84,
+    0x11F01: 84,
+    0x11F36: 84,
+    0x11F37: 84,
+    0x11F38: 84,
+    0x11F39: 84,
+    0x11F3A: 84,
+    0x11F40: 84,
+    0x11F42: 84,
     0x13430: 84,
     0x13431: 84,
     0x13432: 84,
@@ -2275,1971 +2275,1969 @@ joining_types = {
     0x13437: 84,
     0x13438: 84,
     0x13439: 84,
-    0x1343a: 84,
-    0x1343b: 84,
-    0x1343c: 84,
-    0x1343d: 84,
-    0x1343e: 84,
-    0x1343f: 84,
+    0x1343A: 84,
+    0x1343B: 84,
+    0x1343C: 84,
+    0x1343D: 84,
+    0x1343E: 84,
+    0x1343F: 84,
     0x13440: 84,
     0x13447: 84,
     0x13448: 84,
     0x13449: 84,
-    0x1344a: 84,
-    0x1344b: 84,
-    0x1344c: 84,
-    0x1344d: 84,
-    0x1344e: 84,
-    0x1344f: 84,
+    0x1344A: 84,
+    0x1344B: 84,
+    0x1344C: 84,
+    0x1344D: 84,
+    0x1344E: 84,
+    0x1344F: 84,
     0x13450: 84,
     0x13451: 84,
     0x13452: 84,
     0x13453: 84,
     0x13454: 84,
     0x13455: 84,
-    0x16af0: 84,
-    0x16af1: 84,
-    0x16af2: 84,
-    0x16af3: 84,
-    0x16af4: 84,
-    0x16b30: 84,
-    0x16b31: 84,
-    0x16b32: 84,
-    0x16b33: 84,
-    0x16b34: 84,
-    0x16b35: 84,
-    0x16b36: 84,
-    0x16f4f: 84,
-    0x16f8f: 84,
-    0x16f90: 84,
-    0x16f91: 84,
-    0x16f92: 84,
-    0x16fe4: 84,
-    0x1bc9d: 84,
-    0x1bc9e: 84,
-    0x1bca0: 84,
-    0x1bca1: 84,
-    0x1bca2: 84,
-    0x1bca3: 84,
-    0x1cf00: 84,
-    0x1cf01: 84,
-    0x1cf02: 84,
-    0x1cf03: 84,
-    0x1cf04: 84,
-    0x1cf05: 84,
-    0x1cf06: 84,
-    0x1cf07: 84,
-    0x1cf08: 84,
-    0x1cf09: 84,
-    0x1cf0a: 84,
-    0x1cf0b: 84,
-    0x1cf0c: 84,
-    0x1cf0d: 84,
-    0x1cf0e: 84,
-    0x1cf0f: 84,
-    0x1cf10: 84,
-    0x1cf11: 84,
-    0x1cf12: 84,
-    0x1cf13: 84,
-    0x1cf14: 84,
-    0x1cf15: 84,
-    0x1cf16: 84,
-    0x1cf17: 84,
-    0x1cf18: 84,
-    0x1cf19: 84,
-    0x1cf1a: 84,
-    0x1cf1b: 84,
-    0x1cf1c: 84,
-    0x1cf1d: 84,
-    0x1cf1e: 84,
-    0x1cf1f: 84,
-    0x1cf20: 84,
-    0x1cf21: 84,
-    0x1cf22: 84,
-    0x1cf23: 84,
-    0x1cf24: 84,
-    0x1cf25: 84,
-    0x1cf26: 84,
-    0x1cf27: 84,
-    0x1cf28: 84,
-    0x1cf29: 84,
-    0x1cf2a: 84,
-    0x1cf2b: 84,
-    0x1cf2c: 84,
-    0x1cf2d: 84,
-    0x1cf30: 84,
-    0x1cf31: 84,
-    0x1cf32: 84,
-    0x1cf33: 84,
-    0x1cf34: 84,
-    0x1cf35: 84,
-    0x1cf36: 84,
-    0x1cf37: 84,
-    0x1cf38: 84,
-    0x1cf39: 84,
-    0x1cf3a: 84,
-    0x1cf3b: 84,
-    0x1cf3c: 84,
-    0x1cf3d: 84,
-    0x1cf3e: 84,
-    0x1cf3f: 84,
-    0x1cf40: 84,
-    0x1cf41: 84,
-    0x1cf42: 84,
-    0x1cf43: 84,
-    0x1cf44: 84,
-    0x1cf45: 84,
-    0x1cf46: 84,
-    0x1d167: 84,
-    0x1d168: 84,
-    0x1d169: 84,
-    0x1d173: 84,
-    0x1d174: 84,
-    0x1d175: 84,
-    0x1d176: 84,
-    0x1d177: 84,
-    0x1d178: 84,
-    0x1d179: 84,
-    0x1d17a: 84,
-    0x1d17b: 84,
-    0x1d17c: 84,
-    0x1d17d: 84,
-    0x1d17e: 84,
-    0x1d17f: 84,
-    0x1d180: 84,
-    0x1d181: 84,
-    0x1d182: 84,
-    0x1d185: 84,
-    0x1d186: 84,
-    0x1d187: 84,
-    0x1d188: 84,
-    0x1d189: 84,
-    0x1d18a: 84,
-    0x1d18b: 84,
-    0x1d1aa: 84,
-    0x1d1ab: 84,
-    0x1d1ac: 84,
-    0x1d1ad: 84,
-    0x1d242: 84,
-    0x1d243: 84,
-    0x1d244: 84,
-    0x1da00: 84,
-    0x1da01: 84,
-    0x1da02: 84,
-    0x1da03: 84,
-    0x1da04: 84,
-    0x1da05: 84,
-    0x1da06: 84,
-    0x1da07: 84,
-    0x1da08: 84,
-    0x1da09: 84,
-    0x1da0a: 84,
-    0x1da0b: 84,
-    0x1da0c: 84,
-    0x1da0d: 84,
-    0x1da0e: 84,
-    0x1da0f: 84,
-    0x1da10: 84,
-    0x1da11: 84,
-    0x1da12: 84,
-    0x1da13: 84,
-    0x1da14: 84,
-    0x1da15: 84,
-    0x1da16: 84,
-    0x1da17: 84,
-    0x1da18: 84,
-    0x1da19: 84,
-    0x1da1a: 84,
-    0x1da1b: 84,
-    0x1da1c: 84,
-    0x1da1d: 84,
-    0x1da1e: 84,
-    0x1da1f: 84,
-    0x1da20: 84,
-    0x1da21: 84,
-    0x1da22: 84,
-    0x1da23: 84,
-    0x1da24: 84,
-    0x1da25: 84,
-    0x1da26: 84,
-    0x1da27: 84,
-    0x1da28: 84,
-    0x1da29: 84,
-    0x1da2a: 84,
-    0x1da2b: 84,
-    0x1da2c: 84,
-    0x1da2d: 84,
-    0x1da2e: 84,
-    0x1da2f: 84,
-    0x1da30: 84,
-    0x1da31: 84,
-    0x1da32: 84,
-    0x1da33: 84,
-    0x1da34: 84,
-    0x1da35: 84,
-    0x1da36: 84,
-    0x1da3b: 84,
-    0x1da3c: 84,
-    0x1da3d: 84,
-    0x1da3e: 84,
-    0x1da3f: 84,
-    0x1da40: 84,
-    0x1da41: 84,
-    0x1da42: 84,
-    0x1da43: 84,
-    0x1da44: 84,
-    0x1da45: 84,
-    0x1da46: 84,
-    0x1da47: 84,
-    0x1da48: 84,
-    0x1da49: 84,
-    0x1da4a: 84,
-    0x1da4b: 84,
-    0x1da4c: 84,
-    0x1da4d: 84,
-    0x1da4e: 84,
-    0x1da4f: 84,
-    0x1da50: 84,
-    0x1da51: 84,
-    0x1da52: 84,
-    0x1da53: 84,
-    0x1da54: 84,
-    0x1da55: 84,
-    0x1da56: 84,
-    0x1da57: 84,
-    0x1da58: 84,
-    0x1da59: 84,
-    0x1da5a: 84,
-    0x1da5b: 84,
-    0x1da5c: 84,
-    0x1da5d: 84,
-    0x1da5e: 84,
-    0x1da5f: 84,
-    0x1da60: 84,
-    0x1da61: 84,
-    0x1da62: 84,
-    0x1da63: 84,
-    0x1da64: 84,
-    0x1da65: 84,
-    0x1da66: 84,
-    0x1da67: 84,
-    0x1da68: 84,
-    0x1da69: 84,
-    0x1da6a: 84,
-    0x1da6b: 84,
-    0x1da6c: 84,
-    0x1da75: 84,
-    0x1da84: 84,
-    0x1da9b: 84,
-    0x1da9c: 84,
-    0x1da9d: 84,
-    0x1da9e: 84,
-    0x1da9f: 84,
-    0x1daa1: 84,
-    0x1daa2: 84,
-    0x1daa3: 84,
-    0x1daa4: 84,
-    0x1daa5: 84,
-    0x1daa6: 84,
-    0x1daa7: 84,
-    0x1daa8: 84,
-    0x1daa9: 84,
-    0x1daaa: 84,
-    0x1daab: 84,
-    0x1daac: 84,
-    0x1daad: 84,
-    0x1daae: 84,
-    0x1daaf: 84,
-    0x1e000: 84,
-    0x1e001: 84,
-    0x1e002: 84,
-    0x1e003: 84,
-    0x1e004: 84,
-    0x1e005: 84,
-    0x1e006: 84,
-    0x1e008: 84,
-    0x1e009: 84,
-    0x1e00a: 84,
-    0x1e00b: 84,
-    0x1e00c: 84,
-    0x1e00d: 84,
-    0x1e00e: 84,
-    0x1e00f: 84,
-    0x1e010: 84,
-    0x1e011: 84,
-    0x1e012: 84,
-    0x1e013: 84,
-    0x1e014: 84,
-    0x1e015: 84,
-    0x1e016: 84,
-    0x1e017: 84,
-    0x1e018: 84,
-    0x1e01b: 84,
-    0x1e01c: 84,
-    0x1e01d: 84,
-    0x1e01e: 84,
-    0x1e01f: 84,
-    0x1e020: 84,
-    0x1e021: 84,
-    0x1e023: 84,
-    0x1e024: 84,
-    0x1e026: 84,
-    0x1e027: 84,
-    0x1e028: 84,
-    0x1e029: 84,
-    0x1e02a: 84,
-    0x1e08f: 84,
-    0x1e130: 84,
-    0x1e131: 84,
-    0x1e132: 84,
-    0x1e133: 84,
-    0x1e134: 84,
-    0x1e135: 84,
-    0x1e136: 84,
-    0x1e2ae: 84,
-    0x1e2ec: 84,
-    0x1e2ed: 84,
-    0x1e2ee: 84,
-    0x1e2ef: 84,
-    0x1e4ec: 84,
-    0x1e4ed: 84,
-    0x1e4ee: 84,
-    0x1e4ef: 84,
-    0x1e8d0: 84,
-    0x1e8d1: 84,
-    0x1e8d2: 84,
-    0x1e8d3: 84,
-    0x1e8d4: 84,
-    0x1e8d5: 84,
-    0x1e8d6: 84,
-    0x1e900: 68,
-    0x1e901: 68,
-    0x1e902: 68,
-    0x1e903: 68,
-    0x1e904: 68,
-    0x1e905: 68,
-    0x1e906: 68,
-    0x1e907: 68,
-    0x1e908: 68,
-    0x1e909: 68,
-    0x1e90a: 68,
-    0x1e90b: 68,
-    0x1e90c: 68,
-    0x1e90d: 68,
-    0x1e90e: 68,
-    0x1e90f: 68,
-    0x1e910: 68,
-    0x1e911: 68,
-    0x1e912: 68,
-    0x1e913: 68,
-    0x1e914: 68,
-    0x1e915: 68,
-    0x1e916: 68,
-    0x1e917: 68,
-    0x1e918: 68,
-    0x1e919: 68,
-    0x1e91a: 68,
-    0x1e91b: 68,
-    0x1e91c: 68,
-    0x1e91d: 68,
-    0x1e91e: 68,
-    0x1e91f: 68,
-    0x1e920: 68,
-    0x1e921: 68,
-    0x1e922: 68,
-    0x1e923: 68,
-    0x1e924: 68,
-    0x1e925: 68,
-    0x1e926: 68,
-    0x1e927: 68,
-    0x1e928: 68,
-    0x1e929: 68,
-    0x1e92a: 68,
-    0x1e92b: 68,
-    0x1e92c: 68,
-    0x1e92d: 68,
-    0x1e92e: 68,
-    0x1e92f: 68,
-    0x1e930: 68,
-    0x1e931: 68,
-    0x1e932: 68,
-    0x1e933: 68,
-    0x1e934: 68,
-    0x1e935: 68,
-    0x1e936: 68,
-    0x1e937: 68,
-    0x1e938: 68,
-    0x1e939: 68,
-    0x1e93a: 68,
-    0x1e93b: 68,
-    0x1e93c: 68,
-    0x1e93d: 68,
-    0x1e93e: 68,
-    0x1e93f: 68,
-    0x1e940: 68,
-    0x1e941: 68,
-    0x1e942: 68,
-    0x1e943: 68,
-    0x1e944: 84,
-    0x1e945: 84,
-    0x1e946: 84,
-    0x1e947: 84,
-    0x1e948: 84,
-    0x1e949: 84,
-    0x1e94a: 84,
-    0x1e94b: 84,
-    0xe0001: 84,
-    0xe0020: 84,
-    0xe0021: 84,
-    0xe0022: 84,
-    0xe0023: 84,
-    0xe0024: 84,
-    0xe0025: 84,
-    0xe0026: 84,
-    0xe0027: 84,
-    0xe0028: 84,
-    0xe0029: 84,
-    0xe002a: 84,
-    0xe002b: 84,
-    0xe002c: 84,
-    0xe002d: 84,
-    0xe002e: 84,
-    0xe002f: 84,
-    0xe0030: 84,
-    0xe0031: 84,
-    0xe0032: 84,
-    0xe0033: 84,
-    0xe0034: 84,
-    0xe0035: 84,
-    0xe0036: 84,
-    0xe0037: 84,
-    0xe0038: 84,
-    0xe0039: 84,
-    0xe003a: 84,
-    0xe003b: 84,
-    0xe003c: 84,
-    0xe003d: 84,
-    0xe003e: 84,
-    0xe003f: 84,
-    0xe0040: 84,
-    0xe0041: 84,
-    0xe0042: 84,
-    0xe0043: 84,
-    0xe0044: 84,
-    0xe0045: 84,
-    0xe0046: 84,
-    0xe0047: 84,
-    0xe0048: 84,
-    0xe0049: 84,
-    0xe004a: 84,
-    0xe004b: 84,
-    0xe004c: 84,
-    0xe004d: 84,
-    0xe004e: 84,
-    0xe004f: 84,
-    0xe0050: 84,
-    0xe0051: 84,
-    0xe0052: 84,
-    0xe0053: 84,
-    0xe0054: 84,
-    0xe0055: 84,
-    0xe0056: 84,
-    0xe0057: 84,
-    0xe0058: 84,
-    0xe0059: 84,
-    0xe005a: 84,
-    0xe005b: 84,
-    0xe005c: 84,
-    0xe005d: 84,
-    0xe005e: 84,
-    0xe005f: 84,
-    0xe0060: 84,
-    0xe0061: 84,
-    0xe0062: 84,
-    0xe0063: 84,
-    0xe0064: 84,
-    0xe0065: 84,
-    0xe0066: 84,
-    0xe0067: 84,
-    0xe0068: 84,
-    0xe0069: 84,
-    0xe006a: 84,
-    0xe006b: 84,
-    0xe006c: 84,
-    0xe006d: 84,
-    0xe006e: 84,
-    0xe006f: 84,
-    0xe0070: 84,
-    0xe0071: 84,
-    0xe0072: 84,
-    0xe0073: 84,
-    0xe0074: 84,
-    0xe0075: 84,
-    0xe0076: 84,
-    0xe0077: 84,
-    0xe0078: 84,
-    0xe0079: 84,
-    0xe007a: 84,
-    0xe007b: 84,
-    0xe007c: 84,
-    0xe007d: 84,
-    0xe007e: 84,
-    0xe007f: 84,
-    0xe0100: 84,
-    0xe0101: 84,
-    0xe0102: 84,
-    0xe0103: 84,
-    0xe0104: 84,
-    0xe0105: 84,
-    0xe0106: 84,
-    0xe0107: 84,
-    0xe0108: 84,
-    0xe0109: 84,
-    0xe010a: 84,
-    0xe010b: 84,
-    0xe010c: 84,
-    0xe010d: 84,
-    0xe010e: 84,
-    0xe010f: 84,
-    0xe0110: 84,
-    0xe0111: 84,
-    0xe0112: 84,
-    0xe0113: 84,
-    0xe0114: 84,
-    0xe0115: 84,
-    0xe0116: 84,
-    0xe0117: 84,
-    0xe0118: 84,
-    0xe0119: 84,
-    0xe011a: 84,
-    0xe011b: 84,
-    0xe011c: 84,
-    0xe011d: 84,
-    0xe011e: 84,
-    0xe011f: 84,
-    0xe0120: 84,
-    0xe0121: 84,
-    0xe0122: 84,
-    0xe0123: 84,
-    0xe0124: 84,
-    0xe0125: 84,
-    0xe0126: 84,
-    0xe0127: 84,
-    0xe0128: 84,
-    0xe0129: 84,
-    0xe012a: 84,
-    0xe012b: 84,
-    0xe012c: 84,
-    0xe012d: 84,
-    0xe012e: 84,
-    0xe012f: 84,
-    0xe0130: 84,
-    0xe0131: 84,
-    0xe0132: 84,
-    0xe0133: 84,
-    0xe0134: 84,
-    0xe0135: 84,
-    0xe0136: 84,
-    0xe0137: 84,
-    0xe0138: 84,
-    0xe0139: 84,
-    0xe013a: 84,
-    0xe013b: 84,
-    0xe013c: 84,
-    0xe013d: 84,
-    0xe013e: 84,
-    0xe013f: 84,
-    0xe0140: 84,
-    0xe0141: 84,
-    0xe0142: 84,
-    0xe0143: 84,
-    0xe0144: 84,
-    0xe0145: 84,
-    0xe0146: 84,
-    0xe0147: 84,
-    0xe0148: 84,
-    0xe0149: 84,
-    0xe014a: 84,
-    0xe014b: 84,
-    0xe014c: 84,
-    0xe014d: 84,
-    0xe014e: 84,
-    0xe014f: 84,
-    0xe0150: 84,
-    0xe0151: 84,
-    0xe0152: 84,
-    0xe0153: 84,
-    0xe0154: 84,
-    0xe0155: 84,
-    0xe0156: 84,
-    0xe0157: 84,
-    0xe0158: 84,
-    0xe0159: 84,
-    0xe015a: 84,
-    0xe015b: 84,
-    0xe015c: 84,
-    0xe015d: 84,
-    0xe015e: 84,
-    0xe015f: 84,
-    0xe0160: 84,
-    0xe0161: 84,
-    0xe0162: 84,
-    0xe0163: 84,
-    0xe0164: 84,
-    0xe0165: 84,
-    0xe0166: 84,
-    0xe0167: 84,
-    0xe0168: 84,
-    0xe0169: 84,
-    0xe016a: 84,
-    0xe016b: 84,
-    0xe016c: 84,
-    0xe016d: 84,
-    0xe016e: 84,
-    0xe016f: 84,
-    0xe0170: 84,
-    0xe0171: 84,
-    0xe0172: 84,
-    0xe0173: 84,
-    0xe0174: 84,
-    0xe0175: 84,
-    0xe0176: 84,
-    0xe0177: 84,
-    0xe0178: 84,
-    0xe0179: 84,
-    0xe017a: 84,
-    0xe017b: 84,
-    0xe017c: 84,
-    0xe017d: 84,
-    0xe017e: 84,
-    0xe017f: 84,
-    0xe0180: 84,
-    0xe0181: 84,
-    0xe0182: 84,
-    0xe0183: 84,
-    0xe0184: 84,
-    0xe0185: 84,
-    0xe0186: 84,
-    0xe0187: 84,
-    0xe0188: 84,
-    0xe0189: 84,
-    0xe018a: 84,
-    0xe018b: 84,
-    0xe018c: 84,
-    0xe018d: 84,
-    0xe018e: 84,
-    0xe018f: 84,
-    0xe0190: 84,
-    0xe0191: 84,
-    0xe0192: 84,
-    0xe0193: 84,
-    0xe0194: 84,
-    0xe0195: 84,
-    0xe0196: 84,
-    0xe0197: 84,
-    0xe0198: 84,
-    0xe0199: 84,
-    0xe019a: 84,
-    0xe019b: 84,
-    0xe019c: 84,
-    0xe019d: 84,
-    0xe019e: 84,
-    0xe019f: 84,
-    0xe01a0: 84,
-    0xe01a1: 84,
-    0xe01a2: 84,
-    0xe01a3: 84,
-    0xe01a4: 84,
-    0xe01a5: 84,
-    0xe01a6: 84,
-    0xe01a7: 84,
-    0xe01a8: 84,
-    0xe01a9: 84,
-    0xe01aa: 84,
-    0xe01ab: 84,
-    0xe01ac: 84,
-    0xe01ad: 84,
-    0xe01ae: 84,
-    0xe01af: 84,
-    0xe01b0: 84,
-    0xe01b1: 84,
-    0xe01b2: 84,
-    0xe01b3: 84,
-    0xe01b4: 84,
-    0xe01b5: 84,
-    0xe01b6: 84,
-    0xe01b7: 84,
-    0xe01b8: 84,
-    0xe01b9: 84,
-    0xe01ba: 84,
-    0xe01bb: 84,
-    0xe01bc: 84,
-    0xe01bd: 84,
-    0xe01be: 84,
-    0xe01bf: 84,
-    0xe01c0: 84,
-    0xe01c1: 84,
-    0xe01c2: 84,
-    0xe01c3: 84,
-    0xe01c4: 84,
-    0xe01c5: 84,
-    0xe01c6: 84,
-    0xe01c7: 84,
-    0xe01c8: 84,
-    0xe01c9: 84,
-    0xe01ca: 84,
-    0xe01cb: 84,
-    0xe01cc: 84,
-    0xe01cd: 84,
-    0xe01ce: 84,
-    0xe01cf: 84,
-    0xe01d0: 84,
-    0xe01d1: 84,
-    0xe01d2: 84,
-    0xe01d3: 84,
-    0xe01d4: 84,
-    0xe01d5: 84,
-    0xe01d6: 84,
-    0xe01d7: 84,
-    0xe01d8: 84,
-    0xe01d9: 84,
-    0xe01da: 84,
-    0xe01db: 84,
-    0xe01dc: 84,
-    0xe01dd: 84,
-    0xe01de: 84,
-    0xe01df: 84,
-    0xe01e0: 84,
-    0xe01e1: 84,
-    0xe01e2: 84,
-    0xe01e3: 84,
-    0xe01e4: 84,
-    0xe01e5: 84,
-    0xe01e6: 84,
-    0xe01e7: 84,
-    0xe01e8: 84,
-    0xe01e9: 84,
-    0xe01ea: 84,
-    0xe01eb: 84,
-    0xe01ec: 84,
-    0xe01ed: 84,
-    0xe01ee: 84,
-    0xe01ef: 84,
+    0x16AF0: 84,
+    0x16AF1: 84,
+    0x16AF2: 84,
+    0x16AF3: 84,
+    0x16AF4: 84,
+    0x16B30: 84,
+    0x16B31: 84,
+    0x16B32: 84,
+    0x16B33: 84,
+    0x16B34: 84,
+    0x16B35: 84,
+    0x16B36: 84,
+    0x16F4F: 84,
+    0x16F8F: 84,
+    0x16F90: 84,
+    0x16F91: 84,
+    0x16F92: 84,
+    0x16FE4: 84,
+    0x1BC9D: 84,
+    0x1BC9E: 84,
+    0x1BCA0: 84,
+    0x1BCA1: 84,
+    0x1BCA2: 84,
+    0x1BCA3: 84,
+    0x1CF00: 84,
+    0x1CF01: 84,
+    0x1CF02: 84,
+    0x1CF03: 84,
+    0x1CF04: 84,
+    0x1CF05: 84,
+    0x1CF06: 84,
+    0x1CF07: 84,
+    0x1CF08: 84,
+    0x1CF09: 84,
+    0x1CF0A: 84,
+    0x1CF0B: 84,
+    0x1CF0C: 84,
+    0x1CF0D: 84,
+    0x1CF0E: 84,
+    0x1CF0F: 84,
+    0x1CF10: 84,
+    0x1CF11: 84,
+    0x1CF12: 84,
+    0x1CF13: 84,
+    0x1CF14: 84,
+    0x1CF15: 84,
+    0x1CF16: 84,
+    0x1CF17: 84,
+    0x1CF18: 84,
+    0x1CF19: 84,
+    0x1CF1A: 84,
+    0x1CF1B: 84,
+    0x1CF1C: 84,
+    0x1CF1D: 84,
+    0x1CF1E: 84,
+    0x1CF1F: 84,
+    0x1CF20: 84,
+    0x1CF21: 84,
+    0x1CF22: 84,
+    0x1CF23: 84,
+    0x1CF24: 84,
+    0x1CF25: 84,
+    0x1CF26: 84,
+    0x1CF27: 84,
+    0x1CF28: 84,
+    0x1CF29: 84,
+    0x1CF2A: 84,
+    0x1CF2B: 84,
+    0x1CF2C: 84,
+    0x1CF2D: 84,
+    0x1CF30: 84,
+    0x1CF31: 84,
+    0x1CF32: 84,
+    0x1CF33: 84,
+    0x1CF34: 84,
+    0x1CF35: 84,
+    0x1CF36: 84,
+    0x1CF37: 84,
+    0x1CF38: 84,
+    0x1CF39: 84,
+    0x1CF3A: 84,
+    0x1CF3B: 84,
+    0x1CF3C: 84,
+    0x1CF3D: 84,
+    0x1CF3E: 84,
+    0x1CF3F: 84,
+    0x1CF40: 84,
+    0x1CF41: 84,
+    0x1CF42: 84,
+    0x1CF43: 84,
+    0x1CF44: 84,
+    0x1CF45: 84,
+    0x1CF46: 84,
+    0x1D167: 84,
+    0x1D168: 84,
+    0x1D169: 84,
+    0x1D173: 84,
+    0x1D174: 84,
+    0x1D175: 84,
+    0x1D176: 84,
+    0x1D177: 84,
+    0x1D178: 84,
+    0x1D179: 84,
+    0x1D17A: 84,
+    0x1D17B: 84,
+    0x1D17C: 84,
+    0x1D17D: 84,
+    0x1D17E: 84,
+    0x1D17F: 84,
+    0x1D180: 84,
+    0x1D181: 84,
+    0x1D182: 84,
+    0x1D185: 84,
+    0x1D186: 84,
+    0x1D187: 84,
+    0x1D188: 84,
+    0x1D189: 84,
+    0x1D18A: 84,
+    0x1D18B: 84,
+    0x1D1AA: 84,
+    0x1D1AB: 84,
+    0x1D1AC: 84,
+    0x1D1AD: 84,
+    0x1D242: 84,
+    0x1D243: 84,
+    0x1D244: 84,
+    0x1DA00: 84,
+    0x1DA01: 84,
+    0x1DA02: 84,
+    0x1DA03: 84,
+    0x1DA04: 84,
+    0x1DA05: 84,
+    0x1DA06: 84,
+    0x1DA07: 84,
+    0x1DA08: 84,
+    0x1DA09: 84,
+    0x1DA0A: 84,
+    0x1DA0B: 84,
+    0x1DA0C: 84,
+    0x1DA0D: 84,
+    0x1DA0E: 84,
+    0x1DA0F: 84,
+    0x1DA10: 84,
+    0x1DA11: 84,
+    0x1DA12: 84,
+    0x1DA13: 84,
+    0x1DA14: 84,
+    0x1DA15: 84,
+    0x1DA16: 84,
+    0x1DA17: 84,
+    0x1DA18: 84,
+    0x1DA19: 84,
+    0x1DA1A: 84,
+    0x1DA1B: 84,
+    0x1DA1C: 84,
+    0x1DA1D: 84,
+    0x1DA1E: 84,
+    0x1DA1F: 84,
+    0x1DA20: 84,
+    0x1DA21: 84,
+    0x1DA22: 84,
+    0x1DA23: 84,
+    0x1DA24: 84,
+    0x1DA25: 84,
+    0x1DA26: 84,
+    0x1DA27: 84,
+    0x1DA28: 84,
+    0x1DA29: 84,
+    0x1DA2A: 84,
+    0x1DA2B: 84,
+    0x1DA2C: 84,
+    0x1DA2D: 84,
+    0x1DA2E: 84,
+    0x1DA2F: 84,
+    0x1DA30: 84,
+    0x1DA31: 84,
+    0x1DA32: 84,
+    0x1DA33: 84,
+    0x1DA34: 84,
+    0x1DA35: 84,
+    0x1DA36: 84,
+    0x1DA3B: 84,
+    0x1DA3C: 84,
+    0x1DA3D: 84,
+    0x1DA3E: 84,
+    0x1DA3F: 84,
+    0x1DA40: 84,
+    0x1DA41: 84,
+    0x1DA42: 84,
+    0x1DA43: 84,
+    0x1DA44: 84,
+    0x1DA45: 84,
+    0x1DA46: 84,
+    0x1DA47: 84,
+    0x1DA48: 84,
+    0x1DA49: 84,
+    0x1DA4A: 84,
+    0x1DA4B: 84,
+    0x1DA4C: 84,
+    0x1DA4D: 84,
+    0x1DA4E: 84,
+    0x1DA4F: 84,
+    0x1DA50: 84,
+    0x1DA51: 84,
+    0x1DA52: 84,
+    0x1DA53: 84,
+    0x1DA54: 84,
+    0x1DA55: 84,
+    0x1DA56: 84,
+    0x1DA57: 84,
+    0x1DA58: 84,
+    0x1DA59: 84,
+    0x1DA5A: 84,
+    0x1DA5B: 84,
+    0x1DA5C: 84,
+    0x1DA5D: 84,
+    0x1DA5E: 84,
+    0x1DA5F: 84,
+    0x1DA60: 84,
+    0x1DA61: 84,
+    0x1DA62: 84,
+    0x1DA63: 84,
+    0x1DA64: 84,
+    0x1DA65: 84,
+    0x1DA66: 84,
+    0x1DA67: 84,
+    0x1DA68: 84,
+    0x1DA69: 84,
+    0x1DA6A: 84,
+    0x1DA6B: 84,
+    0x1DA6C: 84,
+    0x1DA75: 84,
+    0x1DA84: 84,
+    0x1DA9B: 84,
+    0x1DA9C: 84,
+    0x1DA9D: 84,
+    0x1DA9E: 84,
+    0x1DA9F: 84,
+    0x1DAA1: 84,
+    0x1DAA2: 84,
+    0x1DAA3: 84,
+    0x1DAA4: 84,
+    0x1DAA5: 84,
+    0x1DAA6: 84,
+    0x1DAA7: 84,
+    0x1DAA8: 84,
+    0x1DAA9: 84,
+    0x1DAAA: 84,
+    0x1DAAB: 84,
+    0x1DAAC: 84,
+    0x1DAAD: 84,
+    0x1DAAE: 84,
+    0x1DAAF: 84,
+    0x1E000: 84,
+    0x1E001: 84,
+    0x1E002: 84,
+    0x1E003: 84,
+    0x1E004: 84,
+    0x1E005: 84,
+    0x1E006: 84,
+    0x1E008: 84,
+    0x1E009: 84,
+    0x1E00A: 84,
+    0x1E00B: 84,
+    0x1E00C: 84,
+    0x1E00D: 84,
+    0x1E00E: 84,
+    0x1E00F: 84,
+    0x1E010: 84,
+    0x1E011: 84,
+    0x1E012: 84,
+    0x1E013: 84,
+    0x1E014: 84,
+    0x1E015: 84,
+    0x1E016: 84,
+    0x1E017: 84,
+    0x1E018: 84,
+    0x1E01B: 84,
+    0x1E01C: 84,
+    0x1E01D: 84,
+    0x1E01E: 84,
+    0x1E01F: 84,
+    0x1E020: 84,
+    0x1E021: 84,
+    0x1E023: 84,
+    0x1E024: 84,
+    0x1E026: 84,
+    0x1E027: 84,
+    0x1E028: 84,
+    0x1E029: 84,
+    0x1E02A: 84,
+    0x1E08F: 84,
+    0x1E130: 84,
+    0x1E131: 84,
+    0x1E132: 84,
+    0x1E133: 84,
+    0x1E134: 84,
+    0x1E135: 84,
+    0x1E136: 84,
+    0x1E2AE: 84,
+    0x1E2EC: 84,
+    0x1E2ED: 84,
+    0x1E2EE: 84,
+    0x1E2EF: 84,
+    0x1E4EC: 84,
+    0x1E4ED: 84,
+    0x1E4EE: 84,
+    0x1E4EF: 84,
+    0x1E8D0: 84,
+    0x1E8D1: 84,
+    0x1E8D2: 84,
+    0x1E8D3: 84,
+    0x1E8D4: 84,
+    0x1E8D5: 84,
+    0x1E8D6: 84,
+    0x1E900: 68,
+    0x1E901: 68,
+    0x1E902: 68,
+    0x1E903: 68,
+    0x1E904: 68,
+    0x1E905: 68,
+    0x1E906: 68,
+    0x1E907: 68,
+    0x1E908: 68,
+    0x1E909: 68,
+    0x1E90A: 68,
+    0x1E90B: 68,
+    0x1E90C: 68,
+    0x1E90D: 68,
+    0x1E90E: 68,
+    0x1E90F: 68,
+    0x1E910: 68,
+    0x1E911: 68,
+    0x1E912: 68,
+    0x1E913: 68,
+    0x1E914: 68,
+    0x1E915: 68,
+    0x1E916: 68,
+    0x1E917: 68,
+    0x1E918: 68,
+    0x1E919: 68,
+    0x1E91A: 68,
+    0x1E91B: 68,
+    0x1E91C: 68,
+    0x1E91D: 68,
+    0x1E91E: 68,
+    0x1E91F: 68,
+    0x1E920: 68,
+    0x1E921: 68,
+    0x1E922: 68,
+    0x1E923: 68,
+    0x1E924: 68,
+    0x1E925: 68,
+    0x1E926: 68,
+    0x1E927: 68,
+    0x1E928: 68,
+    0x1E929: 68,
+    0x1E92A: 68,
+    0x1E92B: 68,
+    0x1E92C: 68,
+    0x1E92D: 68,
+    0x1E92E: 68,
+    0x1E92F: 68,
+    0x1E930: 68,
+    0x1E931: 68,
+    0x1E932: 68,
+    0x1E933: 68,
+    0x1E934: 68,
+    0x1E935: 68,
+    0x1E936: 68,
+    0x1E937: 68,
+    0x1E938: 68,
+    0x1E939: 68,
+    0x1E93A: 68,
+    0x1E93B: 68,
+    0x1E93C: 68,
+    0x1E93D: 68,
+    0x1E93E: 68,
+    0x1E93F: 68,
+    0x1E940: 68,
+    0x1E941: 68,
+    0x1E942: 68,
+    0x1E943: 68,
+    0x1E944: 84,
+    0x1E945: 84,
+    0x1E946: 84,
+    0x1E947: 84,
+    0x1E948: 84,
+    0x1E949: 84,
+    0x1E94A: 84,
+    0x1E94B: 84,
+    0xE0001: 84,
+    0xE0020: 84,
+    0xE0021: 84,
+    0xE0022: 84,
+    0xE0023: 84,
+    0xE0024: 84,
+    0xE0025: 84,
+    0xE0026: 84,
+    0xE0027: 84,
+    0xE0028: 84,
+    0xE0029: 84,
+    0xE002A: 84,
+    0xE002B: 84,
+    0xE002C: 84,
+    0xE002D: 84,
+    0xE002E: 84,
+    0xE002F: 84,
+    0xE0030: 84,
+    0xE0031: 84,
+    0xE0032: 84,
+    0xE0033: 84,
+    0xE0034: 84,
+    0xE0035: 84,
+    0xE0036: 84,
+    0xE0037: 84,
+    0xE0038: 84,
+    0xE0039: 84,
+    0xE003A: 84,
+    0xE003B: 84,
+    0xE003C: 84,
+    0xE003D: 84,
+    0xE003E: 84,
+    0xE003F: 84,
+    0xE0040: 84,
+    0xE0041: 84,
+    0xE0042: 84,
+    0xE0043: 84,
+    0xE0044: 84,
+    0xE0045: 84,
+    0xE0046: 84,
+    0xE0047: 84,
+    0xE0048: 84,
+    0xE0049: 84,
+    0xE004A: 84,
+    0xE004B: 84,
+    0xE004C: 84,
+    0xE004D: 84,
+    0xE004E: 84,
+    0xE004F: 84,
+    0xE0050: 84,
+    0xE0051: 84,
+    0xE0052: 84,
+    0xE0053: 84,
+    0xE0054: 84,
+    0xE0055: 84,
+    0xE0056: 84,
+    0xE0057: 84,
+    0xE0058: 84,
+    0xE0059: 84,
+    0xE005A: 84,
+    0xE005B: 84,
+    0xE005C: 84,
+    0xE005D: 84,
+    0xE005E: 84,
+    0xE005F: 84,
+    0xE0060: 84,
+    0xE0061: 84,
+    0xE0062: 84,
+    0xE0063: 84,
+    0xE0064: 84,
+    0xE0065: 84,
+    0xE0066: 84,
+    0xE0067: 84,
+    0xE0068: 84,
+    0xE0069: 84,
+    0xE006A: 84,
+    0xE006B: 84,
+    0xE006C: 84,
+    0xE006D: 84,
+    0xE006E: 84,
+    0xE006F: 84,
+    0xE0070: 84,
+    0xE0071: 84,
+    0xE0072: 84,
+    0xE0073: 84,
+    0xE0074: 84,
+    0xE0075: 84,
+    0xE0076: 84,
+    0xE0077: 84,
+    0xE0078: 84,
+    0xE0079: 84,
+    0xE007A: 84,
+    0xE007B: 84,
+    0xE007C: 84,
+    0xE007D: 84,
+    0xE007E: 84,
+    0xE007F: 84,
+    0xE0100: 84,
+    0xE0101: 84,
+    0xE0102: 84,
+    0xE0103: 84,
+    0xE0104: 84,
+    0xE0105: 84,
+    0xE0106: 84,
+    0xE0107: 84,
+    0xE0108: 84,
+    0xE0109: 84,
+    0xE010A: 84,
+    0xE010B: 84,
+    0xE010C: 84,
+    0xE010D: 84,
+    0xE010E: 84,
+    0xE010F: 84,
+    0xE0110: 84,
+    0xE0111: 84,
+    0xE0112: 84,
+    0xE0113: 84,
+    0xE0114: 84,
+    0xE0115: 84,
+    0xE0116: 84,
+    0xE0117: 84,
+    0xE0118: 84,
+    0xE0119: 84,
+    0xE011A: 84,
+    0xE011B: 84,
+    0xE011C: 84,
+    0xE011D: 84,
+    0xE011E: 84,
+    0xE011F: 84,
+    0xE0120: 84,
+    0xE0121: 84,
+    0xE0122: 84,
+    0xE0123: 84,
+    0xE0124: 84,
+    0xE0125: 84,
+    0xE0126: 84,
+    0xE0127: 84,
+    0xE0128: 84,
+    0xE0129: 84,
+    0xE012A: 84,
+    0xE012B: 84,
+    0xE012C: 84,
+    0xE012D: 84,
+    0xE012E: 84,
+    0xE012F: 84,
+    0xE0130: 84,
+    0xE0131: 84,
+    0xE0132: 84,
+    0xE0133: 84,
+    0xE0134: 84,
+    0xE0135: 84,
+    0xE0136: 84,
+    0xE0137: 84,
+    0xE0138: 84,
+    0xE0139: 84,
+    0xE013A: 84,
+    0xE013B: 84,
+    0xE013C: 84,
+    0xE013D: 84,
+    0xE013E: 84,
+    0xE013F: 84,
+    0xE0140: 84,
+    0xE0141: 84,
+    0xE0142: 84,
+    0xE0143: 84,
+    0xE0144: 84,
+    0xE0145: 84,
+    0xE0146: 84,
+    0xE0147: 84,
+    0xE0148: 84,
+    0xE0149: 84,
+    0xE014A: 84,
+    0xE014B: 84,
+    0xE014C: 84,
+    0xE014D: 84,
+    0xE014E: 84,
+    0xE014F: 84,
+    0xE0150: 84,
+    0xE0151: 84,
+    0xE0152: 84,
+    0xE0153: 84,
+    0xE0154: 84,
+    0xE0155: 84,
+    0xE0156: 84,
+    0xE0157: 84,
+    0xE0158: 84,
+    0xE0159: 84,
+    0xE015A: 84,
+    0xE015B: 84,
+    0xE015C: 84,
+    0xE015D: 84,
+    0xE015E: 84,
+    0xE015F: 84,
+    0xE0160: 84,
+    0xE0161: 84,
+    0xE0162: 84,
+    0xE0163: 84,
+    0xE0164: 84,
+    0xE0165: 84,
+    0xE0166: 84,
+    0xE0167: 84,
+    0xE0168: 84,
+    0xE0169: 84,
+    0xE016A: 84,
+    0xE016B: 84,
+    0xE016C: 84,
+    0xE016D: 84,
+    0xE016E: 84,
+    0xE016F: 84,
+    0xE0170: 84,
+    0xE0171: 84,
+    0xE0172: 84,
+    0xE0173: 84,
+    0xE0174: 84,
+    0xE0175: 84,
+    0xE0176: 84,
+    0xE0177: 84,
+    0xE0178: 84,
+    0xE0179: 84,
+    0xE017A: 84,
+    0xE017B: 84,
+    0xE017C: 84,
+    0xE017D: 84,
+    0xE017E: 84,
+    0xE017F: 84,
+    0xE0180: 84,
+    0xE0181: 84,
+    0xE0182: 84,
+    0xE0183: 84,
+    0xE0184: 84,
+    0xE0185: 84,
+    0xE0186: 84,
+    0xE0187: 84,
+    0xE0188: 84,
+    0xE0189: 84,
+    0xE018A: 84,
+    0xE018B: 84,
+    0xE018C: 84,
+    0xE018D: 84,
+    0xE018E: 84,
+    0xE018F: 84,
+    0xE0190: 84,
+    0xE0191: 84,
+    0xE0192: 84,
+    0xE0193: 84,
+    0xE0194: 84,
+    0xE0195: 84,
+    0xE0196: 84,
+    0xE0197: 84,
+    0xE0198: 84,
+    0xE0199: 84,
+    0xE019A: 84,
+    0xE019B: 84,
+    0xE019C: 84,
+    0xE019D: 84,
+    0xE019E: 84,
+    0xE019F: 84,
+    0xE01A0: 84,
+    0xE01A1: 84,
+    0xE01A2: 84,
+    0xE01A3: 84,
+    0xE01A4: 84,
+    0xE01A5: 84,
+    0xE01A6: 84,
+    0xE01A7: 84,
+    0xE01A8: 84,
+    0xE01A9: 84,
+    0xE01AA: 84,
+    0xE01AB: 84,
+    0xE01AC: 84,
+    0xE01AD: 84,
+    0xE01AE: 84,
+    0xE01AF: 84,
+    0xE01B0: 84,
+    0xE01B1: 84,
+    0xE01B2: 84,
+    0xE01B3: 84,
+    0xE01B4: 84,
+    0xE01B5: 84,
+    0xE01B6: 84,
+    0xE01B7: 84,
+    0xE01B8: 84,
+    0xE01B9: 84,
+    0xE01BA: 84,
+    0xE01BB: 84,
+    0xE01BC: 84,
+    0xE01BD: 84,
+    0xE01BE: 84,
+    0xE01BF: 84,
+    0xE01C0: 84,
+    0xE01C1: 84,
+    0xE01C2: 84,
+    0xE01C3: 84,
+    0xE01C4: 84,
+    0xE01C5: 84,
+    0xE01C6: 84,
+    0xE01C7: 84,
+    0xE01C8: 84,
+    0xE01C9: 84,
+    0xE01CA: 84,
+    0xE01CB: 84,
+    0xE01CC: 84,
+    0xE01CD: 84,
+    0xE01CE: 84,
+    0xE01CF: 84,
+    0xE01D0: 84,
+    0xE01D1: 84,
+    0xE01D2: 84,
+    0xE01D3: 84,
+    0xE01D4: 84,
+    0xE01D5: 84,
+    0xE01D6: 84,
+    0xE01D7: 84,
+    0xE01D8: 84,
+    0xE01D9: 84,
+    0xE01DA: 84,
+    0xE01DB: 84,
+    0xE01DC: 84,
+    0xE01DD: 84,
+    0xE01DE: 84,
+    0xE01DF: 84,
+    0xE01E0: 84,
+    0xE01E1: 84,
+    0xE01E2: 84,
+    0xE01E3: 84,
+    0xE01E4: 84,
+    0xE01E5: 84,
+    0xE01E6: 84,
+    0xE01E7: 84,
+    0xE01E8: 84,
+    0xE01E9: 84,
+    0xE01EA: 84,
+    0xE01EB: 84,
+    0xE01EC: 84,
+    0xE01ED: 84,
+    0xE01EE: 84,
+    0xE01EF: 84,
 }
 codepoint_classes = {
-    'PVALID': (
-        0x2d0000002e,
-        0x300000003a,
-        0x610000007b,
-        0xdf000000f7,
-        0xf800000100,
+    "PVALID": (
+        0x2D0000002E,
+        0x300000003A,
+        0x610000007B,
+        0xDF000000F7,
+        0xF800000100,
         0x10100000102,
         0x10300000104,
         0x10500000106,
         0x10700000108,
-        0x1090000010a,
-        0x10b0000010c,
-        0x10d0000010e,
-        0x10f00000110,
+        0x1090000010A,
+        0x10B0000010C,
+        0x10D0000010E,
+        0x10F00000110,
         0x11100000112,
         0x11300000114,
         0x11500000116,
         0x11700000118,
-        0x1190000011a,
-        0x11b0000011c,
-        0x11d0000011e,
-        0x11f00000120,
+        0x1190000011A,
+        0x11B0000011C,
+        0x11D0000011E,
+        0x11F00000120,
         0x12100000122,
         0x12300000124,
         0x12500000126,
         0x12700000128,
-        0x1290000012a,
-        0x12b0000012c,
-        0x12d0000012e,
-        0x12f00000130,
+        0x1290000012A,
+        0x12B0000012C,
+        0x12D0000012E,
+        0x12F00000130,
         0x13100000132,
         0x13500000136,
         0x13700000139,
-        0x13a0000013b,
-        0x13c0000013d,
-        0x13e0000013f,
+        0x13A0000013B,
+        0x13C0000013D,
+        0x13E0000013F,
         0x14200000143,
         0x14400000145,
         0x14600000147,
         0x14800000149,
-        0x14b0000014c,
-        0x14d0000014e,
-        0x14f00000150,
+        0x14B0000014C,
+        0x14D0000014E,
+        0x14F00000150,
         0x15100000152,
         0x15300000154,
         0x15500000156,
         0x15700000158,
-        0x1590000015a,
-        0x15b0000015c,
-        0x15d0000015e,
-        0x15f00000160,
+        0x1590000015A,
+        0x15B0000015C,
+        0x15D0000015E,
+        0x15F00000160,
         0x16100000162,
         0x16300000164,
         0x16500000166,
         0x16700000168,
-        0x1690000016a,
-        0x16b0000016c,
-        0x16d0000016e,
-        0x16f00000170,
+        0x1690000016A,
+        0x16B0000016C,
+        0x16D0000016E,
+        0x16F00000170,
         0x17100000172,
         0x17300000174,
         0x17500000176,
         0x17700000178,
-        0x17a0000017b,
-        0x17c0000017d,
-        0x17e0000017f,
+        0x17A0000017B,
+        0x17C0000017D,
+        0x17E0000017F,
         0x18000000181,
         0x18300000184,
         0x18500000186,
         0x18800000189,
-        0x18c0000018e,
+        0x18C0000018E,
         0x19200000193,
         0x19500000196,
-        0x1990000019c,
-        0x19e0000019f,
-        0x1a1000001a2,
-        0x1a3000001a4,
-        0x1a5000001a6,
-        0x1a8000001a9,
-        0x1aa000001ac,
-        0x1ad000001ae,
-        0x1b0000001b1,
-        0x1b4000001b5,
-        0x1b6000001b7,
-        0x1b9000001bc,
-        0x1bd000001c4,
-        0x1ce000001cf,
-        0x1d0000001d1,
-        0x1d2000001d3,
-        0x1d4000001d5,
-        0x1d6000001d7,
-        0x1d8000001d9,
-        0x1da000001db,
-        0x1dc000001de,
-        0x1df000001e0,
-        0x1e1000001e2,
-        0x1e3000001e4,
-        0x1e5000001e6,
-        0x1e7000001e8,
-        0x1e9000001ea,
-        0x1eb000001ec,
-        0x1ed000001ee,
-        0x1ef000001f1,
-        0x1f5000001f6,
-        0x1f9000001fa,
-        0x1fb000001fc,
-        0x1fd000001fe,
-        0x1ff00000200,
+        0x1990000019C,
+        0x19E0000019F,
+        0x1A1000001A2,
+        0x1A3000001A4,
+        0x1A5000001A6,
+        0x1A8000001A9,
+        0x1AA000001AC,
+        0x1AD000001AE,
+        0x1B0000001B1,
+        0x1B4000001B5,
+        0x1B6000001B7,
+        0x1B9000001BC,
+        0x1BD000001C4,
+        0x1CE000001CF,
+        0x1D0000001D1,
+        0x1D2000001D3,
+        0x1D4000001D5,
+        0x1D6000001D7,
+        0x1D8000001D9,
+        0x1DA000001DB,
+        0x1DC000001DE,
+        0x1DF000001E0,
+        0x1E1000001E2,
+        0x1E3000001E4,
+        0x1E5000001E6,
+        0x1E7000001E8,
+        0x1E9000001EA,
+        0x1EB000001EC,
+        0x1ED000001EE,
+        0x1EF000001F1,
+        0x1F5000001F6,
+        0x1F9000001FA,
+        0x1FB000001FC,
+        0x1FD000001FE,
+        0x1FF00000200,
         0x20100000202,
         0x20300000204,
         0x20500000206,
         0x20700000208,
-        0x2090000020a,
-        0x20b0000020c,
-        0x20d0000020e,
-        0x20f00000210,
+        0x2090000020A,
+        0x20B0000020C,
+        0x20D0000020E,
+        0x20F00000210,
         0x21100000212,
         0x21300000214,
         0x21500000216,
         0x21700000218,
-        0x2190000021a,
-        0x21b0000021c,
-        0x21d0000021e,
-        0x21f00000220,
+        0x2190000021A,
+        0x21B0000021C,
+        0x21D0000021E,
+        0x21F00000220,
         0x22100000222,
         0x22300000224,
         0x22500000226,
         0x22700000228,
-        0x2290000022a,
-        0x22b0000022c,
-        0x22d0000022e,
-        0x22f00000230,
+        0x2290000022A,
+        0x22B0000022C,
+        0x22D0000022E,
+        0x22F00000230,
         0x23100000232,
-        0x2330000023a,
-        0x23c0000023d,
-        0x23f00000241,
+        0x2330000023A,
+        0x23C0000023D,
+        0x23F00000241,
         0x24200000243,
         0x24700000248,
-        0x2490000024a,
-        0x24b0000024c,
-        0x24d0000024e,
-        0x24f000002b0,
-        0x2b9000002c2,
-        0x2c6000002d2,
-        0x2ec000002ed,
-        0x2ee000002ef,
+        0x2490000024A,
+        0x24B0000024C,
+        0x24D0000024E,
+        0x24F000002B0,
+        0x2B9000002C2,
+        0x2C6000002D2,
+        0x2EC000002ED,
+        0x2EE000002EF,
         0x30000000340,
         0x34200000343,
-        0x3460000034f,
+        0x3460000034F,
         0x35000000370,
         0x37100000372,
         0x37300000374,
         0x37700000378,
-        0x37b0000037e,
+        0x37B0000037E,
         0x39000000391,
-        0x3ac000003cf,
-        0x3d7000003d8,
-        0x3d9000003da,
-        0x3db000003dc,
-        0x3dd000003de,
-        0x3df000003e0,
-        0x3e1000003e2,
-        0x3e3000003e4,
-        0x3e5000003e6,
-        0x3e7000003e8,
-        0x3e9000003ea,
-        0x3eb000003ec,
-        0x3ed000003ee,
-        0x3ef000003f0,
-        0x3f3000003f4,
-        0x3f8000003f9,
-        0x3fb000003fd,
+        0x3AC000003CF,
+        0x3D7000003D8,
+        0x3D9000003DA,
+        0x3DB000003DC,
+        0x3DD000003DE,
+        0x3DF000003E0,
+        0x3E1000003E2,
+        0x3E3000003E4,
+        0x3E5000003E6,
+        0x3E7000003E8,
+        0x3E9000003EA,
+        0x3EB000003EC,
+        0x3ED000003EE,
+        0x3EF000003F0,
+        0x3F3000003F4,
+        0x3F8000003F9,
+        0x3FB000003FD,
         0x43000000460,
         0x46100000462,
         0x46300000464,
         0x46500000466,
         0x46700000468,
-        0x4690000046a,
-        0x46b0000046c,
-        0x46d0000046e,
-        0x46f00000470,
+        0x4690000046A,
+        0x46B0000046C,
+        0x46D0000046E,
+        0x46F00000470,
         0x47100000472,
         0x47300000474,
         0x47500000476,
         0x47700000478,
-        0x4790000047a,
-        0x47b0000047c,
-        0x47d0000047e,
-        0x47f00000480,
+        0x4790000047A,
+        0x47B0000047C,
+        0x47D0000047E,
+        0x47F00000480,
         0x48100000482,
         0x48300000488,
-        0x48b0000048c,
-        0x48d0000048e,
-        0x48f00000490,
+        0x48B0000048C,
+        0x48D0000048E,
+        0x48F00000490,
         0x49100000492,
         0x49300000494,
         0x49500000496,
         0x49700000498,
-        0x4990000049a,
-        0x49b0000049c,
-        0x49d0000049e,
-        0x49f000004a0,
-        0x4a1000004a2,
-        0x4a3000004a4,
-        0x4a5000004a6,
-        0x4a7000004a8,
-        0x4a9000004aa,
-        0x4ab000004ac,
-        0x4ad000004ae,
-        0x4af000004b0,
-        0x4b1000004b2,
-        0x4b3000004b4,
-        0x4b5000004b6,
-        0x4b7000004b8,
-        0x4b9000004ba,
-        0x4bb000004bc,
-        0x4bd000004be,
-        0x4bf000004c0,
-        0x4c2000004c3,
-        0x4c4000004c5,
-        0x4c6000004c7,
-        0x4c8000004c9,
-        0x4ca000004cb,
-        0x4cc000004cd,
-        0x4ce000004d0,
-        0x4d1000004d2,
-        0x4d3000004d4,
-        0x4d5000004d6,
-        0x4d7000004d8,
-        0x4d9000004da,
-        0x4db000004dc,
-        0x4dd000004de,
-        0x4df000004e0,
-        0x4e1000004e2,
-        0x4e3000004e4,
-        0x4e5000004e6,
-        0x4e7000004e8,
-        0x4e9000004ea,
-        0x4eb000004ec,
-        0x4ed000004ee,
-        0x4ef000004f0,
-        0x4f1000004f2,
-        0x4f3000004f4,
-        0x4f5000004f6,
-        0x4f7000004f8,
-        0x4f9000004fa,
-        0x4fb000004fc,
-        0x4fd000004fe,
-        0x4ff00000500,
+        0x4990000049A,
+        0x49B0000049C,
+        0x49D0000049E,
+        0x49F000004A0,
+        0x4A1000004A2,
+        0x4A3000004A4,
+        0x4A5000004A6,
+        0x4A7000004A8,
+        0x4A9000004AA,
+        0x4AB000004AC,
+        0x4AD000004AE,
+        0x4AF000004B0,
+        0x4B1000004B2,
+        0x4B3000004B4,
+        0x4B5000004B6,
+        0x4B7000004B8,
+        0x4B9000004BA,
+        0x4BB000004BC,
+        0x4BD000004BE,
+        0x4BF000004C0,
+        0x4C2000004C3,
+        0x4C4000004C5,
+        0x4C6000004C7,
+        0x4C8000004C9,
+        0x4CA000004CB,
+        0x4CC000004CD,
+        0x4CE000004D0,
+        0x4D1000004D2,
+        0x4D3000004D4,
+        0x4D5000004D6,
+        0x4D7000004D8,
+        0x4D9000004DA,
+        0x4DB000004DC,
+        0x4DD000004DE,
+        0x4DF000004E0,
+        0x4E1000004E2,
+        0x4E3000004E4,
+        0x4E5000004E6,
+        0x4E7000004E8,
+        0x4E9000004EA,
+        0x4EB000004EC,
+        0x4ED000004EE,
+        0x4EF000004F0,
+        0x4F1000004F2,
+        0x4F3000004F4,
+        0x4F5000004F6,
+        0x4F7000004F8,
+        0x4F9000004FA,
+        0x4FB000004FC,
+        0x4FD000004FE,
+        0x4FF00000500,
         0x50100000502,
         0x50300000504,
         0x50500000506,
         0x50700000508,
-        0x5090000050a,
-        0x50b0000050c,
-        0x50d0000050e,
-        0x50f00000510,
+        0x5090000050A,
+        0x50B0000050C,
+        0x50D0000050E,
+        0x50F00000510,
         0x51100000512,
         0x51300000514,
         0x51500000516,
         0x51700000518,
-        0x5190000051a,
-        0x51b0000051c,
-        0x51d0000051e,
-        0x51f00000520,
+        0x5190000051A,
+        0x51B0000051C,
+        0x51D0000051E,
+        0x51F00000520,
         0x52100000522,
         0x52300000524,
         0x52500000526,
         0x52700000528,
-        0x5290000052a,
-        0x52b0000052c,
-        0x52d0000052e,
-        0x52f00000530,
-        0x5590000055a,
+        0x5290000052A,
+        0x52B0000052C,
+        0x52D0000052E,
+        0x52F00000530,
+        0x5590000055A,
         0x56000000587,
         0x58800000589,
-        0x591000005be,
-        0x5bf000005c0,
-        0x5c1000005c3,
-        0x5c4000005c6,
-        0x5c7000005c8,
-        0x5d0000005eb,
-        0x5ef000005f3,
-        0x6100000061b,
+        0x591000005BE,
+        0x5BF000005C0,
+        0x5C1000005C3,
+        0x5C4000005C6,
+        0x5C7000005C8,
+        0x5D0000005EB,
+        0x5EF000005F3,
+        0x6100000061B,
         0x62000000640,
         0x64100000660,
-        0x66e00000675,
-        0x679000006d4,
-        0x6d5000006dd,
-        0x6df000006e9,
-        0x6ea000006f0,
-        0x6fa00000700,
-        0x7100000074b,
-        0x74d000007b2,
-        0x7c0000007f6,
-        0x7fd000007fe,
-        0x8000000082e,
-        0x8400000085c,
-        0x8600000086b,
+        0x66E00000675,
+        0x679000006D4,
+        0x6D5000006DD,
+        0x6DF000006E9,
+        0x6EA000006F0,
+        0x6FA00000700,
+        0x7100000074B,
+        0x74D000007B2,
+        0x7C0000007F6,
+        0x7FD000007FE,
+        0x8000000082E,
+        0x8400000085C,
+        0x8600000086B,
         0x87000000888,
-        0x8890000088f,
-        0x898000008e2,
-        0x8e300000958,
+        0x8890000088F,
+        0x898000008E2,
+        0x8E300000958,
         0x96000000964,
         0x96600000970,
         0x97100000984,
-        0x9850000098d,
-        0x98f00000991,
-        0x993000009a9,
-        0x9aa000009b1,
-        0x9b2000009b3,
-        0x9b6000009ba,
-        0x9bc000009c5,
-        0x9c7000009c9,
-        0x9cb000009cf,
-        0x9d7000009d8,
-        0x9e0000009e4,
-        0x9e6000009f2,
-        0x9fc000009fd,
-        0x9fe000009ff,
-        0xa0100000a04,
-        0xa0500000a0b,
-        0xa0f00000a11,
-        0xa1300000a29,
-        0xa2a00000a31,
-        0xa3200000a33,
-        0xa3500000a36,
-        0xa3800000a3a,
-        0xa3c00000a3d,
-        0xa3e00000a43,
-        0xa4700000a49,
-        0xa4b00000a4e,
-        0xa5100000a52,
-        0xa5c00000a5d,
-        0xa6600000a76,
-        0xa8100000a84,
-        0xa8500000a8e,
-        0xa8f00000a92,
-        0xa9300000aa9,
-        0xaaa00000ab1,
-        0xab200000ab4,
-        0xab500000aba,
-        0xabc00000ac6,
-        0xac700000aca,
-        0xacb00000ace,
-        0xad000000ad1,
-        0xae000000ae4,
-        0xae600000af0,
-        0xaf900000b00,
-        0xb0100000b04,
-        0xb0500000b0d,
-        0xb0f00000b11,
-        0xb1300000b29,
-        0xb2a00000b31,
-        0xb3200000b34,
-        0xb3500000b3a,
-        0xb3c00000b45,
-        0xb4700000b49,
-        0xb4b00000b4e,
-        0xb5500000b58,
-        0xb5f00000b64,
-        0xb6600000b70,
-        0xb7100000b72,
-        0xb8200000b84,
-        0xb8500000b8b,
-        0xb8e00000b91,
-        0xb9200000b96,
-        0xb9900000b9b,
-        0xb9c00000b9d,
-        0xb9e00000ba0,
-        0xba300000ba5,
-        0xba800000bab,
-        0xbae00000bba,
-        0xbbe00000bc3,
-        0xbc600000bc9,
-        0xbca00000bce,
-        0xbd000000bd1,
-        0xbd700000bd8,
-        0xbe600000bf0,
-        0xc0000000c0d,
-        0xc0e00000c11,
-        0xc1200000c29,
-        0xc2a00000c3a,
-        0xc3c00000c45,
-        0xc4600000c49,
-        0xc4a00000c4e,
-        0xc5500000c57,
-        0xc5800000c5b,
-        0xc5d00000c5e,
-        0xc6000000c64,
-        0xc6600000c70,
-        0xc8000000c84,
-        0xc8500000c8d,
-        0xc8e00000c91,
-        0xc9200000ca9,
-        0xcaa00000cb4,
-        0xcb500000cba,
-        0xcbc00000cc5,
-        0xcc600000cc9,
-        0xcca00000cce,
-        0xcd500000cd7,
-        0xcdd00000cdf,
-        0xce000000ce4,
-        0xce600000cf0,
-        0xcf100000cf4,
-        0xd0000000d0d,
-        0xd0e00000d11,
-        0xd1200000d45,
-        0xd4600000d49,
-        0xd4a00000d4f,
-        0xd5400000d58,
-        0xd5f00000d64,
-        0xd6600000d70,
-        0xd7a00000d80,
-        0xd8100000d84,
-        0xd8500000d97,
-        0xd9a00000db2,
-        0xdb300000dbc,
-        0xdbd00000dbe,
-        0xdc000000dc7,
-        0xdca00000dcb,
-        0xdcf00000dd5,
-        0xdd600000dd7,
-        0xdd800000de0,
-        0xde600000df0,
-        0xdf200000df4,
-        0xe0100000e33,
-        0xe3400000e3b,
-        0xe4000000e4f,
-        0xe5000000e5a,
-        0xe8100000e83,
-        0xe8400000e85,
-        0xe8600000e8b,
-        0xe8c00000ea4,
-        0xea500000ea6,
-        0xea700000eb3,
-        0xeb400000ebe,
-        0xec000000ec5,
-        0xec600000ec7,
-        0xec800000ecf,
-        0xed000000eda,
-        0xede00000ee0,
-        0xf0000000f01,
-        0xf0b00000f0c,
-        0xf1800000f1a,
-        0xf2000000f2a,
-        0xf3500000f36,
-        0xf3700000f38,
-        0xf3900000f3a,
-        0xf3e00000f43,
-        0xf4400000f48,
-        0xf4900000f4d,
-        0xf4e00000f52,
-        0xf5300000f57,
-        0xf5800000f5c,
-        0xf5d00000f69,
-        0xf6a00000f6d,
-        0xf7100000f73,
-        0xf7400000f75,
-        0xf7a00000f81,
-        0xf8200000f85,
-        0xf8600000f93,
-        0xf9400000f98,
-        0xf9900000f9d,
-        0xf9e00000fa2,
-        0xfa300000fa7,
-        0xfa800000fac,
-        0xfad00000fb9,
-        0xfba00000fbd,
-        0xfc600000fc7,
-        0x10000000104a,
-        0x10500000109e,
-        0x10d0000010fb,
-        0x10fd00001100,
+        0x9850000098D,
+        0x98F00000991,
+        0x993000009A9,
+        0x9AA000009B1,
+        0x9B2000009B3,
+        0x9B6000009BA,
+        0x9BC000009C5,
+        0x9C7000009C9,
+        0x9CB000009CF,
+        0x9D7000009D8,
+        0x9E0000009E4,
+        0x9E6000009F2,
+        0x9FC000009FD,
+        0x9FE000009FF,
+        0xA0100000A04,
+        0xA0500000A0B,
+        0xA0F00000A11,
+        0xA1300000A29,
+        0xA2A00000A31,
+        0xA3200000A33,
+        0xA3500000A36,
+        0xA3800000A3A,
+        0xA3C00000A3D,
+        0xA3E00000A43,
+        0xA4700000A49,
+        0xA4B00000A4E,
+        0xA5100000A52,
+        0xA5C00000A5D,
+        0xA6600000A76,
+        0xA8100000A84,
+        0xA8500000A8E,
+        0xA8F00000A92,
+        0xA9300000AA9,
+        0xAAA00000AB1,
+        0xAB200000AB4,
+        0xAB500000ABA,
+        0xABC00000AC6,
+        0xAC700000ACA,
+        0xACB00000ACE,
+        0xAD000000AD1,
+        0xAE000000AE4,
+        0xAE600000AF0,
+        0xAF900000B00,
+        0xB0100000B04,
+        0xB0500000B0D,
+        0xB0F00000B11,
+        0xB1300000B29,
+        0xB2A00000B31,
+        0xB3200000B34,
+        0xB3500000B3A,
+        0xB3C00000B45,
+        0xB4700000B49,
+        0xB4B00000B4E,
+        0xB5500000B58,
+        0xB5F00000B64,
+        0xB6600000B70,
+        0xB7100000B72,
+        0xB8200000B84,
+        0xB8500000B8B,
+        0xB8E00000B91,
+        0xB9200000B96,
+        0xB9900000B9B,
+        0xB9C00000B9D,
+        0xB9E00000BA0,
+        0xBA300000BA5,
+        0xBA800000BAB,
+        0xBAE00000BBA,
+        0xBBE00000BC3,
+        0xBC600000BC9,
+        0xBCA00000BCE,
+        0xBD000000BD1,
+        0xBD700000BD8,
+        0xBE600000BF0,
+        0xC0000000C0D,
+        0xC0E00000C11,
+        0xC1200000C29,
+        0xC2A00000C3A,
+        0xC3C00000C45,
+        0xC4600000C49,
+        0xC4A00000C4E,
+        0xC5500000C57,
+        0xC5800000C5B,
+        0xC5D00000C5E,
+        0xC6000000C64,
+        0xC6600000C70,
+        0xC8000000C84,
+        0xC8500000C8D,
+        0xC8E00000C91,
+        0xC9200000CA9,
+        0xCAA00000CB4,
+        0xCB500000CBA,
+        0xCBC00000CC5,
+        0xCC600000CC9,
+        0xCCA00000CCE,
+        0xCD500000CD7,
+        0xCDD00000CDF,
+        0xCE000000CE4,
+        0xCE600000CF0,
+        0xCF100000CF4,
+        0xD0000000D0D,
+        0xD0E00000D11,
+        0xD1200000D45,
+        0xD4600000D49,
+        0xD4A00000D4F,
+        0xD5400000D58,
+        0xD5F00000D64,
+        0xD6600000D70,
+        0xD7A00000D80,
+        0xD8100000D84,
+        0xD8500000D97,
+        0xD9A00000DB2,
+        0xDB300000DBC,
+        0xDBD00000DBE,
+        0xDC000000DC7,
+        0xDCA00000DCB,
+        0xDCF00000DD5,
+        0xDD600000DD7,
+        0xDD800000DE0,
+        0xDE600000DF0,
+        0xDF200000DF4,
+        0xE0100000E33,
+        0xE3400000E3B,
+        0xE4000000E4F,
+        0xE5000000E5A,
+        0xE8100000E83,
+        0xE8400000E85,
+        0xE8600000E8B,
+        0xE8C00000EA4,
+        0xEA500000EA6,
+        0xEA700000EB3,
+        0xEB400000EBE,
+        0xEC000000EC5,
+        0xEC600000EC7,
+        0xEC800000ECF,
+        0xED000000EDA,
+        0xEDE00000EE0,
+        0xF0000000F01,
+        0xF0B00000F0C,
+        0xF1800000F1A,
+        0xF2000000F2A,
+        0xF3500000F36,
+        0xF3700000F38,
+        0xF3900000F3A,
+        0xF3E00000F43,
+        0xF4400000F48,
+        0xF4900000F4D,
+        0xF4E00000F52,
+        0xF5300000F57,
+        0xF5800000F5C,
+        0xF5D00000F69,
+        0xF6A00000F6D,
+        0xF7100000F73,
+        0xF7400000F75,
+        0xF7A00000F81,
+        0xF8200000F85,
+        0xF8600000F93,
+        0xF9400000F98,
+        0xF9900000F9D,
+        0xF9E00000FA2,
+        0xFA300000FA7,
+        0xFA800000FAC,
+        0xFAD00000FB9,
+        0xFBA00000FBD,
+        0xFC600000FC7,
+        0x10000000104A,
+        0x10500000109E,
+        0x10D0000010FB,
+        0x10FD00001100,
         0x120000001249,
-        0x124a0000124e,
+        0x124A0000124E,
         0x125000001257,
         0x125800001259,
-        0x125a0000125e,
+        0x125A0000125E,
         0x126000001289,
-        0x128a0000128e,
-        0x1290000012b1,
-        0x12b2000012b6,
-        0x12b8000012bf,
-        0x12c0000012c1,
-        0x12c2000012c6,
-        0x12c8000012d7,
-        0x12d800001311,
+        0x128A0000128E,
+        0x1290000012B1,
+        0x12B2000012B6,
+        0x12B8000012BF,
+        0x12C0000012C1,
+        0x12C2000012C6,
+        0x12C8000012D7,
+        0x12D800001311,
         0x131200001316,
-        0x13180000135b,
-        0x135d00001360,
+        0x13180000135B,
+        0x135D00001360,
         0x138000001390,
-        0x13a0000013f6,
-        0x14010000166d,
-        0x166f00001680,
-        0x16810000169b,
-        0x16a0000016eb,
-        0x16f1000016f9,
+        0x13A0000013F6,
+        0x14010000166D,
+        0x166F00001680,
+        0x16810000169B,
+        0x16A0000016EB,
+        0x16F1000016F9,
         0x170000001716,
-        0x171f00001735,
+        0x171F00001735,
         0x174000001754,
-        0x17600000176d,
-        0x176e00001771,
+        0x17600000176D,
+        0x176E00001771,
         0x177200001774,
-        0x1780000017b4,
-        0x17b6000017d4,
-        0x17d7000017d8,
-        0x17dc000017de,
-        0x17e0000017ea,
-        0x18100000181a,
+        0x1780000017B4,
+        0x17B6000017D4,
+        0x17D7000017D8,
+        0x17DC000017DE,
+        0x17E0000017EA,
+        0x18100000181A,
         0x182000001879,
-        0x1880000018ab,
-        0x18b0000018f6,
-        0x19000000191f,
-        0x19200000192c,
-        0x19300000193c,
-        0x19460000196e,
+        0x1880000018AB,
+        0x18B0000018F6,
+        0x19000000191F,
+        0x19200000192C,
+        0x19300000193C,
+        0x19460000196E,
         0x197000001975,
-        0x1980000019ac,
-        0x19b0000019ca,
-        0x19d0000019da,
-        0x1a0000001a1c,
-        0x1a2000001a5f,
-        0x1a6000001a7d,
-        0x1a7f00001a8a,
-        0x1a9000001a9a,
-        0x1aa700001aa8,
-        0x1ab000001abe,
-        0x1abf00001acf,
-        0x1b0000001b4d,
-        0x1b5000001b5a,
-        0x1b6b00001b74,
-        0x1b8000001bf4,
-        0x1c0000001c38,
-        0x1c4000001c4a,
-        0x1c4d00001c7e,
-        0x1cd000001cd3,
-        0x1cd400001cfb,
-        0x1d0000001d2c,
-        0x1d2f00001d30,
-        0x1d3b00001d3c,
-        0x1d4e00001d4f,
-        0x1d6b00001d78,
-        0x1d7900001d9b,
-        0x1dc000001e00,
-        0x1e0100001e02,
-        0x1e0300001e04,
-        0x1e0500001e06,
-        0x1e0700001e08,
-        0x1e0900001e0a,
-        0x1e0b00001e0c,
-        0x1e0d00001e0e,
-        0x1e0f00001e10,
-        0x1e1100001e12,
-        0x1e1300001e14,
-        0x1e1500001e16,
-        0x1e1700001e18,
-        0x1e1900001e1a,
-        0x1e1b00001e1c,
-        0x1e1d00001e1e,
-        0x1e1f00001e20,
-        0x1e2100001e22,
-        0x1e2300001e24,
-        0x1e2500001e26,
-        0x1e2700001e28,
-        0x1e2900001e2a,
-        0x1e2b00001e2c,
-        0x1e2d00001e2e,
-        0x1e2f00001e30,
-        0x1e3100001e32,
-        0x1e3300001e34,
-        0x1e3500001e36,
-        0x1e3700001e38,
-        0x1e3900001e3a,
-        0x1e3b00001e3c,
-        0x1e3d00001e3e,
-        0x1e3f00001e40,
-        0x1e4100001e42,
-        0x1e4300001e44,
-        0x1e4500001e46,
-        0x1e4700001e48,
-        0x1e4900001e4a,
-        0x1e4b00001e4c,
-        0x1e4d00001e4e,
-        0x1e4f00001e50,
-        0x1e5100001e52,
-        0x1e5300001e54,
-        0x1e5500001e56,
-        0x1e5700001e58,
-        0x1e5900001e5a,
-        0x1e5b00001e5c,
-        0x1e5d00001e5e,
-        0x1e5f00001e60,
-        0x1e6100001e62,
-        0x1e6300001e64,
-        0x1e6500001e66,
-        0x1e6700001e68,
-        0x1e6900001e6a,
-        0x1e6b00001e6c,
-        0x1e6d00001e6e,
-        0x1e6f00001e70,
-        0x1e7100001e72,
-        0x1e7300001e74,
-        0x1e7500001e76,
-        0x1e7700001e78,
-        0x1e7900001e7a,
-        0x1e7b00001e7c,
-        0x1e7d00001e7e,
-        0x1e7f00001e80,
-        0x1e8100001e82,
-        0x1e8300001e84,
-        0x1e8500001e86,
-        0x1e8700001e88,
-        0x1e8900001e8a,
-        0x1e8b00001e8c,
-        0x1e8d00001e8e,
-        0x1e8f00001e90,
-        0x1e9100001e92,
-        0x1e9300001e94,
-        0x1e9500001e9a,
-        0x1e9c00001e9e,
-        0x1e9f00001ea0,
-        0x1ea100001ea2,
-        0x1ea300001ea4,
-        0x1ea500001ea6,
-        0x1ea700001ea8,
-        0x1ea900001eaa,
-        0x1eab00001eac,
-        0x1ead00001eae,
-        0x1eaf00001eb0,
-        0x1eb100001eb2,
-        0x1eb300001eb4,
-        0x1eb500001eb6,
-        0x1eb700001eb8,
-        0x1eb900001eba,
-        0x1ebb00001ebc,
-        0x1ebd00001ebe,
-        0x1ebf00001ec0,
-        0x1ec100001ec2,
-        0x1ec300001ec4,
-        0x1ec500001ec6,
-        0x1ec700001ec8,
-        0x1ec900001eca,
-        0x1ecb00001ecc,
-        0x1ecd00001ece,
-        0x1ecf00001ed0,
-        0x1ed100001ed2,
-        0x1ed300001ed4,
-        0x1ed500001ed6,
-        0x1ed700001ed8,
-        0x1ed900001eda,
-        0x1edb00001edc,
-        0x1edd00001ede,
-        0x1edf00001ee0,
-        0x1ee100001ee2,
-        0x1ee300001ee4,
-        0x1ee500001ee6,
-        0x1ee700001ee8,
-        0x1ee900001eea,
-        0x1eeb00001eec,
-        0x1eed00001eee,
-        0x1eef00001ef0,
-        0x1ef100001ef2,
-        0x1ef300001ef4,
-        0x1ef500001ef6,
-        0x1ef700001ef8,
-        0x1ef900001efa,
-        0x1efb00001efc,
-        0x1efd00001efe,
-        0x1eff00001f08,
-        0x1f1000001f16,
-        0x1f2000001f28,
-        0x1f3000001f38,
-        0x1f4000001f46,
-        0x1f5000001f58,
-        0x1f6000001f68,
-        0x1f7000001f71,
-        0x1f7200001f73,
-        0x1f7400001f75,
-        0x1f7600001f77,
-        0x1f7800001f79,
-        0x1f7a00001f7b,
-        0x1f7c00001f7d,
-        0x1fb000001fb2,
-        0x1fb600001fb7,
-        0x1fc600001fc7,
-        0x1fd000001fd3,
-        0x1fd600001fd8,
-        0x1fe000001fe3,
-        0x1fe400001fe8,
-        0x1ff600001ff7,
-        0x214e0000214f,
+        0x1980000019AC,
+        0x19B0000019CA,
+        0x19D0000019DA,
+        0x1A0000001A1C,
+        0x1A2000001A5F,
+        0x1A6000001A7D,
+        0x1A7F00001A8A,
+        0x1A9000001A9A,
+        0x1AA700001AA8,
+        0x1AB000001ABE,
+        0x1ABF00001ACF,
+        0x1B0000001B4D,
+        0x1B5000001B5A,
+        0x1B6B00001B74,
+        0x1B8000001BF4,
+        0x1C0000001C38,
+        0x1C4000001C4A,
+        0x1C4D00001C7E,
+        0x1CD000001CD3,
+        0x1CD400001CFB,
+        0x1D0000001D2C,
+        0x1D2F00001D30,
+        0x1D3B00001D3C,
+        0x1D4E00001D4F,
+        0x1D6B00001D78,
+        0x1D7900001D9B,
+        0x1DC000001E00,
+        0x1E0100001E02,
+        0x1E0300001E04,
+        0x1E0500001E06,
+        0x1E0700001E08,
+        0x1E0900001E0A,
+        0x1E0B00001E0C,
+        0x1E0D00001E0E,
+        0x1E0F00001E10,
+        0x1E1100001E12,
+        0x1E1300001E14,
+        0x1E1500001E16,
+        0x1E1700001E18,
+        0x1E1900001E1A,
+        0x1E1B00001E1C,
+        0x1E1D00001E1E,
+        0x1E1F00001E20,
+        0x1E2100001E22,
+        0x1E2300001E24,
+        0x1E2500001E26,
+        0x1E2700001E28,
+        0x1E2900001E2A,
+        0x1E2B00001E2C,
+        0x1E2D00001E2E,
+        0x1E2F00001E30,
+        0x1E3100001E32,
+        0x1E3300001E34,
+        0x1E3500001E36,
+        0x1E3700001E38,
+        0x1E3900001E3A,
+        0x1E3B00001E3C,
+        0x1E3D00001E3E,
+        0x1E3F00001E40,
+        0x1E4100001E42,
+        0x1E4300001E44,
+        0x1E4500001E46,
+        0x1E4700001E48,
+        0x1E4900001E4A,
+        0x1E4B00001E4C,
+        0x1E4D00001E4E,
+        0x1E4F00001E50,
+        0x1E5100001E52,
+        0x1E5300001E54,
+        0x1E5500001E56,
+        0x1E5700001E58,
+        0x1E5900001E5A,
+        0x1E5B00001E5C,
+        0x1E5D00001E5E,
+        0x1E5F00001E60,
+        0x1E6100001E62,
+        0x1E6300001E64,
+        0x1E6500001E66,
+        0x1E6700001E68,
+        0x1E6900001E6A,
+        0x1E6B00001E6C,
+        0x1E6D00001E6E,
+        0x1E6F00001E70,
+        0x1E7100001E72,
+        0x1E7300001E74,
+        0x1E7500001E76,
+        0x1E7700001E78,
+        0x1E7900001E7A,
+        0x1E7B00001E7C,
+        0x1E7D00001E7E,
+        0x1E7F00001E80,
+        0x1E8100001E82,
+        0x1E8300001E84,
+        0x1E8500001E86,
+        0x1E8700001E88,
+        0x1E8900001E8A,
+        0x1E8B00001E8C,
+        0x1E8D00001E8E,
+        0x1E8F00001E90,
+        0x1E9100001E92,
+        0x1E9300001E94,
+        0x1E9500001E9A,
+        0x1E9C00001E9E,
+        0x1E9F00001EA0,
+        0x1EA100001EA2,
+        0x1EA300001EA4,
+        0x1EA500001EA6,
+        0x1EA700001EA8,
+        0x1EA900001EAA,
+        0x1EAB00001EAC,
+        0x1EAD00001EAE,
+        0x1EAF00001EB0,
+        0x1EB100001EB2,
+        0x1EB300001EB4,
+        0x1EB500001EB6,
+        0x1EB700001EB8,
+        0x1EB900001EBA,
+        0x1EBB00001EBC,
+        0x1EBD00001EBE,
+        0x1EBF00001EC0,
+        0x1EC100001EC2,
+        0x1EC300001EC4,
+        0x1EC500001EC6,
+        0x1EC700001EC8,
+        0x1EC900001ECA,
+        0x1ECB00001ECC,
+        0x1ECD00001ECE,
+        0x1ECF00001ED0,
+        0x1ED100001ED2,
+        0x1ED300001ED4,
+        0x1ED500001ED6,
+        0x1ED700001ED8,
+        0x1ED900001EDA,
+        0x1EDB00001EDC,
+        0x1EDD00001EDE,
+        0x1EDF00001EE0,
+        0x1EE100001EE2,
+        0x1EE300001EE4,
+        0x1EE500001EE6,
+        0x1EE700001EE8,
+        0x1EE900001EEA,
+        0x1EEB00001EEC,
+        0x1EED00001EEE,
+        0x1EEF00001EF0,
+        0x1EF100001EF2,
+        0x1EF300001EF4,
+        0x1EF500001EF6,
+        0x1EF700001EF8,
+        0x1EF900001EFA,
+        0x1EFB00001EFC,
+        0x1EFD00001EFE,
+        0x1EFF00001F08,
+        0x1F1000001F16,
+        0x1F2000001F28,
+        0x1F3000001F38,
+        0x1F4000001F46,
+        0x1F5000001F58,
+        0x1F6000001F68,
+        0x1F7000001F71,
+        0x1F7200001F73,
+        0x1F7400001F75,
+        0x1F7600001F77,
+        0x1F7800001F79,
+        0x1F7A00001F7B,
+        0x1F7C00001F7D,
+        0x1FB000001FB2,
+        0x1FB600001FB7,
+        0x1FC600001FC7,
+        0x1FD000001FD3,
+        0x1FD600001FD8,
+        0x1FE000001FE3,
+        0x1FE400001FE8,
+        0x1FF600001FF7,
+        0x214E0000214F,
         0x218400002185,
-        0x2c3000002c60,
-        0x2c6100002c62,
-        0x2c6500002c67,
-        0x2c6800002c69,
-        0x2c6a00002c6b,
-        0x2c6c00002c6d,
-        0x2c7100002c72,
-        0x2c7300002c75,
-        0x2c7600002c7c,
-        0x2c8100002c82,
-        0x2c8300002c84,
-        0x2c8500002c86,
-        0x2c8700002c88,
-        0x2c8900002c8a,
-        0x2c8b00002c8c,
-        0x2c8d00002c8e,
-        0x2c8f00002c90,
-        0x2c9100002c92,
-        0x2c9300002c94,
-        0x2c9500002c96,
-        0x2c9700002c98,
-        0x2c9900002c9a,
-        0x2c9b00002c9c,
-        0x2c9d00002c9e,
-        0x2c9f00002ca0,
-        0x2ca100002ca2,
-        0x2ca300002ca4,
-        0x2ca500002ca6,
-        0x2ca700002ca8,
-        0x2ca900002caa,
-        0x2cab00002cac,
-        0x2cad00002cae,
-        0x2caf00002cb0,
-        0x2cb100002cb2,
-        0x2cb300002cb4,
-        0x2cb500002cb6,
-        0x2cb700002cb8,
-        0x2cb900002cba,
-        0x2cbb00002cbc,
-        0x2cbd00002cbe,
-        0x2cbf00002cc0,
-        0x2cc100002cc2,
-        0x2cc300002cc4,
-        0x2cc500002cc6,
-        0x2cc700002cc8,
-        0x2cc900002cca,
-        0x2ccb00002ccc,
-        0x2ccd00002cce,
-        0x2ccf00002cd0,
-        0x2cd100002cd2,
-        0x2cd300002cd4,
-        0x2cd500002cd6,
-        0x2cd700002cd8,
-        0x2cd900002cda,
-        0x2cdb00002cdc,
-        0x2cdd00002cde,
-        0x2cdf00002ce0,
-        0x2ce100002ce2,
-        0x2ce300002ce5,
-        0x2cec00002ced,
-        0x2cee00002cf2,
-        0x2cf300002cf4,
-        0x2d0000002d26,
-        0x2d2700002d28,
-        0x2d2d00002d2e,
-        0x2d3000002d68,
-        0x2d7f00002d97,
-        0x2da000002da7,
-        0x2da800002daf,
-        0x2db000002db7,
-        0x2db800002dbf,
-        0x2dc000002dc7,
-        0x2dc800002dcf,
-        0x2dd000002dd7,
-        0x2dd800002ddf,
-        0x2de000002e00,
-        0x2e2f00002e30,
+        0x2C3000002C60,
+        0x2C6100002C62,
+        0x2C6500002C67,
+        0x2C6800002C69,
+        0x2C6A00002C6B,
+        0x2C6C00002C6D,
+        0x2C7100002C72,
+        0x2C7300002C75,
+        0x2C7600002C7C,
+        0x2C8100002C82,
+        0x2C8300002C84,
+        0x2C8500002C86,
+        0x2C8700002C88,
+        0x2C8900002C8A,
+        0x2C8B00002C8C,
+        0x2C8D00002C8E,
+        0x2C8F00002C90,
+        0x2C9100002C92,
+        0x2C9300002C94,
+        0x2C9500002C96,
+        0x2C9700002C98,
+        0x2C9900002C9A,
+        0x2C9B00002C9C,
+        0x2C9D00002C9E,
+        0x2C9F00002CA0,
+        0x2CA100002CA2,
+        0x2CA300002CA4,
+        0x2CA500002CA6,
+        0x2CA700002CA8,
+        0x2CA900002CAA,
+        0x2CAB00002CAC,
+        0x2CAD00002CAE,
+        0x2CAF00002CB0,
+        0x2CB100002CB2,
+        0x2CB300002CB4,
+        0x2CB500002CB6,
+        0x2CB700002CB8,
+        0x2CB900002CBA,
+        0x2CBB00002CBC,
+        0x2CBD00002CBE,
+        0x2CBF00002CC0,
+        0x2CC100002CC2,
+        0x2CC300002CC4,
+        0x2CC500002CC6,
+        0x2CC700002CC8,
+        0x2CC900002CCA,
+        0x2CCB00002CCC,
+        0x2CCD00002CCE,
+        0x2CCF00002CD0,
+        0x2CD100002CD2,
+        0x2CD300002CD4,
+        0x2CD500002CD6,
+        0x2CD700002CD8,
+        0x2CD900002CDA,
+        0x2CDB00002CDC,
+        0x2CDD00002CDE,
+        0x2CDF00002CE0,
+        0x2CE100002CE2,
+        0x2CE300002CE5,
+        0x2CEC00002CED,
+        0x2CEE00002CF2,
+        0x2CF300002CF4,
+        0x2D0000002D26,
+        0x2D2700002D28,
+        0x2D2D00002D2E,
+        0x2D3000002D68,
+        0x2D7F00002D97,
+        0x2DA000002DA7,
+        0x2DA800002DAF,
+        0x2DB000002DB7,
+        0x2DB800002DBF,
+        0x2DC000002DC7,
+        0x2DC800002DCF,
+        0x2DD000002DD7,
+        0x2DD800002DDF,
+        0x2DE000002E00,
+        0x2E2F00002E30,
         0x300500003008,
-        0x302a0000302e,
-        0x303c0000303d,
+        0x302A0000302E,
+        0x303C0000303D,
         0x304100003097,
-        0x30990000309b,
-        0x309d0000309f,
-        0x30a1000030fb,
-        0x30fc000030ff,
+        0x30990000309B,
+        0x309D0000309F,
+        0x30A1000030FB,
+        0x30FC000030FF,
         0x310500003130,
-        0x31a0000031c0,
-        0x31f000003200,
-        0x340000004dc0,
-        0x4e000000a48d,
-        0xa4d00000a4fe,
-        0xa5000000a60d,
-        0xa6100000a62c,
-        0xa6410000a642,
-        0xa6430000a644,
-        0xa6450000a646,
-        0xa6470000a648,
-        0xa6490000a64a,
-        0xa64b0000a64c,
-        0xa64d0000a64e,
-        0xa64f0000a650,
-        0xa6510000a652,
-        0xa6530000a654,
-        0xa6550000a656,
-        0xa6570000a658,
-        0xa6590000a65a,
-        0xa65b0000a65c,
-        0xa65d0000a65e,
-        0xa65f0000a660,
-        0xa6610000a662,
-        0xa6630000a664,
-        0xa6650000a666,
-        0xa6670000a668,
-        0xa6690000a66a,
-        0xa66b0000a66c,
-        0xa66d0000a670,
-        0xa6740000a67e,
-        0xa67f0000a680,
-        0xa6810000a682,
-        0xa6830000a684,
-        0xa6850000a686,
-        0xa6870000a688,
-        0xa6890000a68a,
-        0xa68b0000a68c,
-        0xa68d0000a68e,
-        0xa68f0000a690,
-        0xa6910000a692,
-        0xa6930000a694,
-        0xa6950000a696,
-        0xa6970000a698,
-        0xa6990000a69a,
-        0xa69b0000a69c,
-        0xa69e0000a6e6,
-        0xa6f00000a6f2,
-        0xa7170000a720,
-        0xa7230000a724,
-        0xa7250000a726,
-        0xa7270000a728,
-        0xa7290000a72a,
-        0xa72b0000a72c,
-        0xa72d0000a72e,
-        0xa72f0000a732,
-        0xa7330000a734,
-        0xa7350000a736,
-        0xa7370000a738,
-        0xa7390000a73a,
-        0xa73b0000a73c,
-        0xa73d0000a73e,
-        0xa73f0000a740,
-        0xa7410000a742,
-        0xa7430000a744,
-        0xa7450000a746,
-        0xa7470000a748,
-        0xa7490000a74a,
-        0xa74b0000a74c,
-        0xa74d0000a74e,
-        0xa74f0000a750,
-        0xa7510000a752,
-        0xa7530000a754,
-        0xa7550000a756,
-        0xa7570000a758,
-        0xa7590000a75a,
-        0xa75b0000a75c,
-        0xa75d0000a75e,
-        0xa75f0000a760,
-        0xa7610000a762,
-        0xa7630000a764,
-        0xa7650000a766,
-        0xa7670000a768,
-        0xa7690000a76a,
-        0xa76b0000a76c,
-        0xa76d0000a76e,
-        0xa76f0000a770,
-        0xa7710000a779,
-        0xa77a0000a77b,
-        0xa77c0000a77d,
-        0xa77f0000a780,
-        0xa7810000a782,
-        0xa7830000a784,
-        0xa7850000a786,
-        0xa7870000a789,
-        0xa78c0000a78d,
-        0xa78e0000a790,
-        0xa7910000a792,
-        0xa7930000a796,
-        0xa7970000a798,
-        0xa7990000a79a,
-        0xa79b0000a79c,
-        0xa79d0000a79e,
-        0xa79f0000a7a0,
-        0xa7a10000a7a2,
-        0xa7a30000a7a4,
-        0xa7a50000a7a6,
-        0xa7a70000a7a8,
-        0xa7a90000a7aa,
-        0xa7af0000a7b0,
-        0xa7b50000a7b6,
-        0xa7b70000a7b8,
-        0xa7b90000a7ba,
-        0xa7bb0000a7bc,
-        0xa7bd0000a7be,
-        0xa7bf0000a7c0,
-        0xa7c10000a7c2,
-        0xa7c30000a7c4,
-        0xa7c80000a7c9,
-        0xa7ca0000a7cb,
-        0xa7d10000a7d2,
-        0xa7d30000a7d4,
-        0xa7d50000a7d6,
-        0xa7d70000a7d8,
-        0xa7d90000a7da,
-        0xa7f60000a7f8,
-        0xa7fa0000a828,
-        0xa82c0000a82d,
-        0xa8400000a874,
-        0xa8800000a8c6,
-        0xa8d00000a8da,
-        0xa8e00000a8f8,
-        0xa8fb0000a8fc,
-        0xa8fd0000a92e,
-        0xa9300000a954,
-        0xa9800000a9c1,
-        0xa9cf0000a9da,
-        0xa9e00000a9ff,
-        0xaa000000aa37,
-        0xaa400000aa4e,
-        0xaa500000aa5a,
-        0xaa600000aa77,
-        0xaa7a0000aac3,
-        0xaadb0000aade,
-        0xaae00000aaf0,
-        0xaaf20000aaf7,
-        0xab010000ab07,
-        0xab090000ab0f,
-        0xab110000ab17,
-        0xab200000ab27,
-        0xab280000ab2f,
-        0xab300000ab5b,
-        0xab600000ab69,
-        0xabc00000abeb,
-        0xabec0000abee,
-        0xabf00000abfa,
-        0xac000000d7a4,
-        0xfa0e0000fa10,
-        0xfa110000fa12,
-        0xfa130000fa15,
-        0xfa1f0000fa20,
-        0xfa210000fa22,
-        0xfa230000fa25,
-        0xfa270000fa2a,
-        0xfb1e0000fb1f,
-        0xfe200000fe30,
-        0xfe730000fe74,
-        0x100000001000c,
-        0x1000d00010027,
-        0x100280001003b,
-        0x1003c0001003e,
-        0x1003f0001004e,
-        0x100500001005e,
-        0x10080000100fb,
-        0x101fd000101fe,
-        0x102800001029d,
-        0x102a0000102d1,
-        0x102e0000102e1,
+        0x31A0000031C0,
+        0x31F000003200,
+        0x340000004DC0,
+        0x4E000000A48D,
+        0xA4D00000A4FE,
+        0xA5000000A60D,
+        0xA6100000A62C,
+        0xA6410000A642,
+        0xA6430000A644,
+        0xA6450000A646,
+        0xA6470000A648,
+        0xA6490000A64A,
+        0xA64B0000A64C,
+        0xA64D0000A64E,
+        0xA64F0000A650,
+        0xA6510000A652,
+        0xA6530000A654,
+        0xA6550000A656,
+        0xA6570000A658,
+        0xA6590000A65A,
+        0xA65B0000A65C,
+        0xA65D0000A65E,
+        0xA65F0000A660,
+        0xA6610000A662,
+        0xA6630000A664,
+        0xA6650000A666,
+        0xA6670000A668,
+        0xA6690000A66A,
+        0xA66B0000A66C,
+        0xA66D0000A670,
+        0xA6740000A67E,
+        0xA67F0000A680,
+        0xA6810000A682,
+        0xA6830000A684,
+        0xA6850000A686,
+        0xA6870000A688,
+        0xA6890000A68A,
+        0xA68B0000A68C,
+        0xA68D0000A68E,
+        0xA68F0000A690,
+        0xA6910000A692,
+        0xA6930000A694,
+        0xA6950000A696,
+        0xA6970000A698,
+        0xA6990000A69A,
+        0xA69B0000A69C,
+        0xA69E0000A6E6,
+        0xA6F00000A6F2,
+        0xA7170000A720,
+        0xA7230000A724,
+        0xA7250000A726,
+        0xA7270000A728,
+        0xA7290000A72A,
+        0xA72B0000A72C,
+        0xA72D0000A72E,
+        0xA72F0000A732,
+        0xA7330000A734,
+        0xA7350000A736,
+        0xA7370000A738,
+        0xA7390000A73A,
+        0xA73B0000A73C,
+        0xA73D0000A73E,
+        0xA73F0000A740,
+        0xA7410000A742,
+        0xA7430000A744,
+        0xA7450000A746,
+        0xA7470000A748,
+        0xA7490000A74A,
+        0xA74B0000A74C,
+        0xA74D0000A74E,
+        0xA74F0000A750,
+        0xA7510000A752,
+        0xA7530000A754,
+        0xA7550000A756,
+        0xA7570000A758,
+        0xA7590000A75A,
+        0xA75B0000A75C,
+        0xA75D0000A75E,
+        0xA75F0000A760,
+        0xA7610000A762,
+        0xA7630000A764,
+        0xA7650000A766,
+        0xA7670000A768,
+        0xA7690000A76A,
+        0xA76B0000A76C,
+        0xA76D0000A76E,
+        0xA76F0000A770,
+        0xA7710000A779,
+        0xA77A0000A77B,
+        0xA77C0000A77D,
+        0xA77F0000A780,
+        0xA7810000A782,
+        0xA7830000A784,
+        0xA7850000A786,
+        0xA7870000A789,
+        0xA78C0000A78D,
+        0xA78E0000A790,
+        0xA7910000A792,
+        0xA7930000A796,
+        0xA7970000A798,
+        0xA7990000A79A,
+        0xA79B0000A79C,
+        0xA79D0000A79E,
+        0xA79F0000A7A0,
+        0xA7A10000A7A2,
+        0xA7A30000A7A4,
+        0xA7A50000A7A6,
+        0xA7A70000A7A8,
+        0xA7A90000A7AA,
+        0xA7AF0000A7B0,
+        0xA7B50000A7B6,
+        0xA7B70000A7B8,
+        0xA7B90000A7BA,
+        0xA7BB0000A7BC,
+        0xA7BD0000A7BE,
+        0xA7BF0000A7C0,
+        0xA7C10000A7C2,
+        0xA7C30000A7C4,
+        0xA7C80000A7C9,
+        0xA7CA0000A7CB,
+        0xA7D10000A7D2,
+        0xA7D30000A7D4,
+        0xA7D50000A7D6,
+        0xA7D70000A7D8,
+        0xA7D90000A7DA,
+        0xA7F60000A7F8,
+        0xA7FA0000A828,
+        0xA82C0000A82D,
+        0xA8400000A874,
+        0xA8800000A8C6,
+        0xA8D00000A8DA,
+        0xA8E00000A8F8,
+        0xA8FB0000A8FC,
+        0xA8FD0000A92E,
+        0xA9300000A954,
+        0xA9800000A9C1,
+        0xA9CF0000A9DA,
+        0xA9E00000A9FF,
+        0xAA000000AA37,
+        0xAA400000AA4E,
+        0xAA500000AA5A,
+        0xAA600000AA77,
+        0xAA7A0000AAC3,
+        0xAADB0000AADE,
+        0xAAE00000AAF0,
+        0xAAF20000AAF7,
+        0xAB010000AB07,
+        0xAB090000AB0F,
+        0xAB110000AB17,
+        0xAB200000AB27,
+        0xAB280000AB2F,
+        0xAB300000AB5B,
+        0xAB600000AB69,
+        0xABC00000ABEB,
+        0xABEC0000ABEE,
+        0xABF00000ABFA,
+        0xAC000000D7A4,
+        0xFA0E0000FA10,
+        0xFA110000FA12,
+        0xFA130000FA15,
+        0xFA1F0000FA20,
+        0xFA210000FA22,
+        0xFA230000FA25,
+        0xFA270000FA2A,
+        0xFB1E0000FB1F,
+        0xFE200000FE30,
+        0xFE730000FE74,
+        0x100000001000C,
+        0x1000D00010027,
+        0x100280001003B,
+        0x1003C0001003E,
+        0x1003F0001004E,
+        0x100500001005E,
+        0x10080000100FB,
+        0x101FD000101FE,
+        0x102800001029D,
+        0x102A0000102D1,
+        0x102E0000102E1,
         0x1030000010320,
-        0x1032d00010341,
-        0x103420001034a,
-        0x103500001037b,
-        0x103800001039e,
-        0x103a0000103c4,
-        0x103c8000103d0,
-        0x104280001049e,
-        0x104a0000104aa,
-        0x104d8000104fc,
+        0x1032D00010341,
+        0x103420001034A,
+        0x103500001037B,
+        0x103800001039E,
+        0x103A0000103C4,
+        0x103C8000103D0,
+        0x104280001049E,
+        0x104A0000104AA,
+        0x104D8000104FC,
         0x1050000010528,
         0x1053000010564,
-        0x10597000105a2,
-        0x105a3000105b2,
-        0x105b3000105ba,
-        0x105bb000105bd,
+        0x10597000105A2,
+        0x105A3000105B2,
+        0x105B3000105BA,
+        0x105BB000105BD,
         0x1060000010737,
         0x1074000010756,
         0x1076000010768,
         0x1078000010781,
         0x1080000010806,
         0x1080800010809,
-        0x1080a00010836,
+        0x1080A00010836,
         0x1083700010839,
-        0x1083c0001083d,
-        0x1083f00010856,
+        0x1083C0001083D,
+        0x1083F00010856,
         0x1086000010877,
-        0x108800001089f,
-        0x108e0000108f3,
-        0x108f4000108f6,
+        0x108800001089F,
+        0x108E0000108F3,
+        0x108F4000108F6,
         0x1090000010916,
-        0x109200001093a,
-        0x10980000109b8,
-        0x109be000109c0,
-        0x10a0000010a04,
-        0x10a0500010a07,
-        0x10a0c00010a14,
-        0x10a1500010a18,
-        0x10a1900010a36,
-        0x10a3800010a3b,
-        0x10a3f00010a40,
-        0x10a6000010a7d,
-        0x10a8000010a9d,
-        0x10ac000010ac8,
-        0x10ac900010ae7,
-        0x10b0000010b36,
-        0x10b4000010b56,
-        0x10b6000010b73,
-        0x10b8000010b92,
-        0x10c0000010c49,
-        0x10cc000010cf3,
-        0x10d0000010d28,
-        0x10d3000010d3a,
-        0x10e8000010eaa,
-        0x10eab00010ead,
-        0x10eb000010eb2,
-        0x10efd00010f1d,
-        0x10f2700010f28,
-        0x10f3000010f51,
-        0x10f7000010f86,
-        0x10fb000010fc5,
-        0x10fe000010ff7,
+        0x109200001093A,
+        0x10980000109B8,
+        0x109BE000109C0,
+        0x10A0000010A04,
+        0x10A0500010A07,
+        0x10A0C00010A14,
+        0x10A1500010A18,
+        0x10A1900010A36,
+        0x10A3800010A3B,
+        0x10A3F00010A40,
+        0x10A6000010A7D,
+        0x10A8000010A9D,
+        0x10AC000010AC8,
+        0x10AC900010AE7,
+        0x10B0000010B36,
+        0x10B4000010B56,
+        0x10B6000010B73,
+        0x10B8000010B92,
+        0x10C0000010C49,
+        0x10CC000010CF3,
+        0x10D0000010D28,
+        0x10D3000010D3A,
+        0x10E8000010EAA,
+        0x10EAB00010EAD,
+        0x10EB000010EB2,
+        0x10EFD00010F1D,
+        0x10F2700010F28,
+        0x10F3000010F51,
+        0x10F7000010F86,
+        0x10FB000010FC5,
+        0x10FE000010FF7,
         0x1100000011047,
         0x1106600011076,
-        0x1107f000110bb,
-        0x110c2000110c3,
-        0x110d0000110e9,
-        0x110f0000110fa,
+        0x1107F000110BB,
+        0x110C2000110C3,
+        0x110D0000110E9,
+        0x110F0000110FA,
         0x1110000011135,
         0x1113600011140,
         0x1114400011148,
         0x1115000011174,
         0x1117600011177,
-        0x11180000111c5,
-        0x111c9000111cd,
-        0x111ce000111db,
-        0x111dc000111dd,
+        0x11180000111C5,
+        0x111C9000111CD,
+        0x111CE000111DB,
+        0x111DC000111DD,
         0x1120000011212,
         0x1121300011238,
-        0x1123e00011242,
+        0x1123E00011242,
         0x1128000011287,
         0x1128800011289,
-        0x1128a0001128e,
-        0x1128f0001129e,
-        0x1129f000112a9,
-        0x112b0000112eb,
-        0x112f0000112fa,
+        0x1128A0001128E,
+        0x1128F0001129E,
+        0x1129F000112A9,
+        0x112B0000112EB,
+        0x112F0000112FA,
         0x1130000011304,
-        0x113050001130d,
-        0x1130f00011311,
+        0x113050001130D,
+        0x1130F00011311,
         0x1131300011329,
-        0x1132a00011331,
+        0x1132A00011331,
         0x1133200011334,
-        0x113350001133a,
-        0x1133b00011345,
+        0x113350001133A,
+        0x1133B00011345,
         0x1134700011349,
-        0x1134b0001134e,
+        0x1134B0001134E,
         0x1135000011351,
         0x1135700011358,
-        0x1135d00011364,
-        0x113660001136d,
+        0x1135D00011364,
+        0x113660001136D,
         0x1137000011375,
-        0x114000001144b,
-        0x114500001145a,
-        0x1145e00011462,
-        0x11480000114c6,
-        0x114c7000114c8,
-        0x114d0000114da,
-        0x11580000115b6,
-        0x115b8000115c1,
-        0x115d8000115de,
+        0x114000001144B,
+        0x114500001145A,
+        0x1145E00011462,
+        0x11480000114C6,
+        0x114C7000114C8,
+        0x114D0000114DA,
+        0x11580000115B6,
+        0x115B8000115C1,
+        0x115D8000115DE,
         0x1160000011641,
         0x1164400011645,
-        0x116500001165a,
-        0x11680000116b9,
-        0x116c0000116ca,
-        0x117000001171b,
-        0x1171d0001172c,
-        0x117300001173a,
+        0x116500001165A,
+        0x11680000116B9,
+        0x116C0000116CA,
+        0x117000001171B,
+        0x1171D0001172C,
+        0x117300001173A,
         0x1174000011747,
-        0x118000001183b,
-        0x118c0000118ea,
-        0x118ff00011907,
-        0x119090001190a,
-        0x1190c00011914,
+        0x118000001183B,
+        0x118C0000118EA,
+        0x118FF00011907,
+        0x119090001190A,
+        0x1190C00011914,
         0x1191500011917,
         0x1191800011936,
         0x1193700011939,
-        0x1193b00011944,
-        0x119500001195a,
-        0x119a0000119a8,
-        0x119aa000119d8,
-        0x119da000119e2,
-        0x119e3000119e5,
-        0x11a0000011a3f,
-        0x11a4700011a48,
-        0x11a5000011a9a,
-        0x11a9d00011a9e,
-        0x11ab000011af9,
-        0x11c0000011c09,
-        0x11c0a00011c37,
-        0x11c3800011c41,
-        0x11c5000011c5a,
-        0x11c7200011c90,
-        0x11c9200011ca8,
-        0x11ca900011cb7,
-        0x11d0000011d07,
-        0x11d0800011d0a,
-        0x11d0b00011d37,
-        0x11d3a00011d3b,
-        0x11d3c00011d3e,
-        0x11d3f00011d48,
-        0x11d5000011d5a,
-        0x11d6000011d66,
-        0x11d6700011d69,
-        0x11d6a00011d8f,
-        0x11d9000011d92,
-        0x11d9300011d99,
-        0x11da000011daa,
-        0x11ee000011ef7,
-        0x11f0000011f11,
-        0x11f1200011f3b,
-        0x11f3e00011f43,
-        0x11f5000011f5a,
-        0x11fb000011fb1,
-        0x120000001239a,
+        0x1193B00011944,
+        0x119500001195A,
+        0x119A0000119A8,
+        0x119AA000119D8,
+        0x119DA000119E2,
+        0x119E3000119E5,
+        0x11A0000011A3F,
+        0x11A4700011A48,
+        0x11A5000011A9A,
+        0x11A9D00011A9E,
+        0x11AB000011AF9,
+        0x11C0000011C09,
+        0x11C0A00011C37,
+        0x11C3800011C41,
+        0x11C5000011C5A,
+        0x11C7200011C90,
+        0x11C9200011CA8,
+        0x11CA900011CB7,
+        0x11D0000011D07,
+        0x11D0800011D0A,
+        0x11D0B00011D37,
+        0x11D3A00011D3B,
+        0x11D3C00011D3E,
+        0x11D3F00011D48,
+        0x11D5000011D5A,
+        0x11D6000011D66,
+        0x11D6700011D69,
+        0x11D6A00011D8F,
+        0x11D9000011D92,
+        0x11D9300011D99,
+        0x11DA000011DAA,
+        0x11EE000011EF7,
+        0x11F0000011F11,
+        0x11F1200011F3B,
+        0x11F3E00011F43,
+        0x11F5000011F5A,
+        0x11FB000011FB1,
+        0x120000001239A,
         0x1248000012544,
-        0x12f9000012ff1,
+        0x12F9000012FF1,
         0x1300000013430,
         0x1344000013456,
         0x1440000014647,
-        0x1680000016a39,
-        0x16a4000016a5f,
-        0x16a6000016a6a,
-        0x16a7000016abf,
-        0x16ac000016aca,
-        0x16ad000016aee,
-        0x16af000016af5,
-        0x16b0000016b37,
-        0x16b4000016b44,
-        0x16b5000016b5a,
-        0x16b6300016b78,
-        0x16b7d00016b90,
-        0x16e6000016e80,
-        0x16f0000016f4b,
-        0x16f4f00016f88,
-        0x16f8f00016fa0,
-        0x16fe000016fe2,
-        0x16fe300016fe5,
-        0x16ff000016ff2,
-        0x17000000187f8,
-        0x1880000018cd6,
-        0x18d0000018d09,
-        0x1aff00001aff4,
-        0x1aff50001affc,
-        0x1affd0001afff,
-        0x1b0000001b123,
-        0x1b1320001b133,
-        0x1b1500001b153,
-        0x1b1550001b156,
-        0x1b1640001b168,
-        0x1b1700001b2fc,
-        0x1bc000001bc6b,
-        0x1bc700001bc7d,
-        0x1bc800001bc89,
-        0x1bc900001bc9a,
-        0x1bc9d0001bc9f,
-        0x1cf000001cf2e,
-        0x1cf300001cf47,
-        0x1da000001da37,
-        0x1da3b0001da6d,
-        0x1da750001da76,
-        0x1da840001da85,
-        0x1da9b0001daa0,
-        0x1daa10001dab0,
-        0x1df000001df1f,
-        0x1df250001df2b,
-        0x1e0000001e007,
-        0x1e0080001e019,
-        0x1e01b0001e022,
-        0x1e0230001e025,
-        0x1e0260001e02b,
-        0x1e08f0001e090,
-        0x1e1000001e12d,
-        0x1e1300001e13e,
-        0x1e1400001e14a,
-        0x1e14e0001e14f,
-        0x1e2900001e2af,
-        0x1e2c00001e2fa,
-        0x1e4d00001e4fa,
-        0x1e7e00001e7e7,
-        0x1e7e80001e7ec,
-        0x1e7ed0001e7ef,
-        0x1e7f00001e7ff,
-        0x1e8000001e8c5,
-        0x1e8d00001e8d7,
-        0x1e9220001e94c,
-        0x1e9500001e95a,
-        0x200000002a6e0,
-        0x2a7000002b73a,
-        0x2b7400002b81e,
-        0x2b8200002cea2,
-        0x2ceb00002ebe1,
-        0x2ebf00002ee5e,
-        0x300000003134b,
-        0x31350000323b0,
+        0x1680000016A39,
+        0x16A4000016A5F,
+        0x16A6000016A6A,
+        0x16A7000016ABF,
+        0x16AC000016ACA,
+        0x16AD000016AEE,
+        0x16AF000016AF5,
+        0x16B0000016B37,
+        0x16B4000016B44,
+        0x16B5000016B5A,
+        0x16B6300016B78,
+        0x16B7D00016B90,
+        0x16E6000016E80,
+        0x16F0000016F4B,
+        0x16F4F00016F88,
+        0x16F8F00016FA0,
+        0x16FE000016FE2,
+        0x16FE300016FE5,
+        0x16FF000016FF2,
+        0x17000000187F8,
+        0x1880000018CD6,
+        0x18D0000018D09,
+        0x1AFF00001AFF4,
+        0x1AFF50001AFFC,
+        0x1AFFD0001AFFF,
+        0x1B0000001B123,
+        0x1B1320001B133,
+        0x1B1500001B153,
+        0x1B1550001B156,
+        0x1B1640001B168,
+        0x1B1700001B2FC,
+        0x1BC000001BC6B,
+        0x1BC700001BC7D,
+        0x1BC800001BC89,
+        0x1BC900001BC9A,
+        0x1BC9D0001BC9F,
+        0x1CF000001CF2E,
+        0x1CF300001CF47,
+        0x1DA000001DA37,
+        0x1DA3B0001DA6D,
+        0x1DA750001DA76,
+        0x1DA840001DA85,
+        0x1DA9B0001DAA0,
+        0x1DAA10001DAB0,
+        0x1DF000001DF1F,
+        0x1DF250001DF2B,
+        0x1E0000001E007,
+        0x1E0080001E019,
+        0x1E01B0001E022,
+        0x1E0230001E025,
+        0x1E0260001E02B,
+        0x1E08F0001E090,
+        0x1E1000001E12D,
+        0x1E1300001E13E,
+        0x1E1400001E14A,
+        0x1E14E0001E14F,
+        0x1E2900001E2AF,
+        0x1E2C00001E2FA,
+        0x1E4D00001E4FA,
+        0x1E7E00001E7E7,
+        0x1E7E80001E7EC,
+        0x1E7ED0001E7EF,
+        0x1E7F00001E7FF,
+        0x1E8000001E8C5,
+        0x1E8D00001E8D7,
+        0x1E9220001E94C,
+        0x1E9500001E95A,
+        0x200000002A6E0,
+        0x2A7000002B73A,
+        0x2B7400002B81E,
+        0x2B8200002CEA2,
+        0x2CEB00002EBE1,
+        0x2EBF00002EE5E,
+        0x300000003134B,
+        0x31350000323B0,
     ),
-    'CONTEXTJ': (
-        0x200c0000200e,
-    ),
-    'CONTEXTO': (
-        0xb7000000b8,
+    "CONTEXTJ": (0x200C0000200E,),
+    "CONTEXTO": (
+        0xB7000000B8,
         0x37500000376,
-        0x5f3000005f5,
-        0x6600000066a,
-        0x6f0000006fa,
-        0x30fb000030fc,
+        0x5F3000005F5,
+        0x6600000066A,
+        0x6F0000006FA,
+        0x30FB000030FC,
     ),
 }
diff --git a/lib/idna/intranges.py b/lib/idna/intranges.py
index 6a43b047..7bfaa8d8 100644
--- a/lib/idna/intranges.py
+++ b/lib/idna/intranges.py
@@ -8,6 +8,7 @@ in the original list?" in time O(log(# runs)).
 import bisect
 from typing import List, Tuple
 
+
 def intranges_from_list(list_: List[int]) -> Tuple[int, ...]:
     """Represent a list of integers as a sequence of ranges:
     ((start_0, end_0), (start_1, end_1), ...), such that the original
@@ -20,18 +21,20 @@ def intranges_from_list(list_: List[int]) -> Tuple[int, ...]:
     ranges = []
     last_write = -1
     for i in range(len(sorted_list)):
-        if i+1 < len(sorted_list):
-            if sorted_list[i] == sorted_list[i+1]-1:
+        if i + 1 < len(sorted_list):
+            if sorted_list[i] == sorted_list[i + 1] - 1:
                 continue
-        current_range = sorted_list[last_write+1:i+1]
+        current_range = sorted_list[last_write + 1 : i + 1]
         ranges.append(_encode_range(current_range[0], current_range[-1] + 1))
         last_write = i
 
     return tuple(ranges)
 
+
 def _encode_range(start: int, end: int) -> int:
     return (start << 32) | end
 
+
 def _decode_range(r: int) -> Tuple[int, int]:
     return (r >> 32), (r & ((1 << 32) - 1))
 
@@ -43,7 +46,7 @@ def intranges_contain(int_: int, ranges: Tuple[int, ...]) -> bool:
     # we could be immediately ahead of a tuple (start, end)
     # with start < int_ <= end
     if pos > 0:
-        left, right = _decode_range(ranges[pos-1])
+        left, right = _decode_range(ranges[pos - 1])
         if left <= int_ < right:
             return True
     # or we could be immediately behind a tuple (int_, end)
diff --git a/lib/idna/package_data.py b/lib/idna/package_data.py
index ed811133..514ff7e2 100644
--- a/lib/idna/package_data.py
+++ b/lib/idna/package_data.py
@@ -1,2 +1 @@
-__version__ = '3.7'
-
+__version__ = "3.10"
diff --git a/lib/idna/uts46data.py b/lib/idna/uts46data.py
index 6a1eddbf..eb894327 100644
--- a/lib/idna/uts46data.py
+++ b/lib/idna/uts46data.py
@@ -3,8515 +3,8598 @@
 
 from typing import List, Tuple, Union
 
-
 """IDNA Mapping Table from UTS46."""
 
 
-__version__ = '15.1.0'
+__version__ = "15.1.0"
+
+
 def _seg_0() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x0, '3'),
-    (0x1, '3'),
-    (0x2, '3'),
-    (0x3, '3'),
-    (0x4, '3'),
-    (0x5, '3'),
-    (0x6, '3'),
-    (0x7, '3'),
-    (0x8, '3'),
-    (0x9, '3'),
-    (0xA, '3'),
-    (0xB, '3'),
-    (0xC, '3'),
-    (0xD, '3'),
-    (0xE, '3'),
-    (0xF, '3'),
-    (0x10, '3'),
-    (0x11, '3'),
-    (0x12, '3'),
-    (0x13, '3'),
-    (0x14, '3'),
-    (0x15, '3'),
-    (0x16, '3'),
-    (0x17, '3'),
-    (0x18, '3'),
-    (0x19, '3'),
-    (0x1A, '3'),
-    (0x1B, '3'),
-    (0x1C, '3'),
-    (0x1D, '3'),
-    (0x1E, '3'),
-    (0x1F, '3'),
-    (0x20, '3'),
-    (0x21, '3'),
-    (0x22, '3'),
-    (0x23, '3'),
-    (0x24, '3'),
-    (0x25, '3'),
-    (0x26, '3'),
-    (0x27, '3'),
-    (0x28, '3'),
-    (0x29, '3'),
-    (0x2A, '3'),
-    (0x2B, '3'),
-    (0x2C, '3'),
-    (0x2D, 'V'),
-    (0x2E, 'V'),
-    (0x2F, '3'),
-    (0x30, 'V'),
-    (0x31, 'V'),
-    (0x32, 'V'),
-    (0x33, 'V'),
-    (0x34, 'V'),
-    (0x35, 'V'),
-    (0x36, 'V'),
-    (0x37, 'V'),
-    (0x38, 'V'),
-    (0x39, 'V'),
-    (0x3A, '3'),
-    (0x3B, '3'),
-    (0x3C, '3'),
-    (0x3D, '3'),
-    (0x3E, '3'),
-    (0x3F, '3'),
-    (0x40, '3'),
-    (0x41, 'M', 'a'),
-    (0x42, 'M', 'b'),
-    (0x43, 'M', 'c'),
-    (0x44, 'M', 'd'),
-    (0x45, 'M', 'e'),
-    (0x46, 'M', 'f'),
-    (0x47, 'M', 'g'),
-    (0x48, 'M', 'h'),
-    (0x49, 'M', 'i'),
-    (0x4A, 'M', 'j'),
-    (0x4B, 'M', 'k'),
-    (0x4C, 'M', 'l'),
-    (0x4D, 'M', 'm'),
-    (0x4E, 'M', 'n'),
-    (0x4F, 'M', 'o'),
-    (0x50, 'M', 'p'),
-    (0x51, 'M', 'q'),
-    (0x52, 'M', 'r'),
-    (0x53, 'M', 's'),
-    (0x54, 'M', 't'),
-    (0x55, 'M', 'u'),
-    (0x56, 'M', 'v'),
-    (0x57, 'M', 'w'),
-    (0x58, 'M', 'x'),
-    (0x59, 'M', 'y'),
-    (0x5A, 'M', 'z'),
-    (0x5B, '3'),
-    (0x5C, '3'),
-    (0x5D, '3'),
-    (0x5E, '3'),
-    (0x5F, '3'),
-    (0x60, '3'),
-    (0x61, 'V'),
-    (0x62, 'V'),
-    (0x63, 'V'),
+        (0x0, "3"),
+        (0x1, "3"),
+        (0x2, "3"),
+        (0x3, "3"),
+        (0x4, "3"),
+        (0x5, "3"),
+        (0x6, "3"),
+        (0x7, "3"),
+        (0x8, "3"),
+        (0x9, "3"),
+        (0xA, "3"),
+        (0xB, "3"),
+        (0xC, "3"),
+        (0xD, "3"),
+        (0xE, "3"),
+        (0xF, "3"),
+        (0x10, "3"),
+        (0x11, "3"),
+        (0x12, "3"),
+        (0x13, "3"),
+        (0x14, "3"),
+        (0x15, "3"),
+        (0x16, "3"),
+        (0x17, "3"),
+        (0x18, "3"),
+        (0x19, "3"),
+        (0x1A, "3"),
+        (0x1B, "3"),
+        (0x1C, "3"),
+        (0x1D, "3"),
+        (0x1E, "3"),
+        (0x1F, "3"),
+        (0x20, "3"),
+        (0x21, "3"),
+        (0x22, "3"),
+        (0x23, "3"),
+        (0x24, "3"),
+        (0x25, "3"),
+        (0x26, "3"),
+        (0x27, "3"),
+        (0x28, "3"),
+        (0x29, "3"),
+        (0x2A, "3"),
+        (0x2B, "3"),
+        (0x2C, "3"),
+        (0x2D, "V"),
+        (0x2E, "V"),
+        (0x2F, "3"),
+        (0x30, "V"),
+        (0x31, "V"),
+        (0x32, "V"),
+        (0x33, "V"),
+        (0x34, "V"),
+        (0x35, "V"),
+        (0x36, "V"),
+        (0x37, "V"),
+        (0x38, "V"),
+        (0x39, "V"),
+        (0x3A, "3"),
+        (0x3B, "3"),
+        (0x3C, "3"),
+        (0x3D, "3"),
+        (0x3E, "3"),
+        (0x3F, "3"),
+        (0x40, "3"),
+        (0x41, "M", "a"),
+        (0x42, "M", "b"),
+        (0x43, "M", "c"),
+        (0x44, "M", "d"),
+        (0x45, "M", "e"),
+        (0x46, "M", "f"),
+        (0x47, "M", "g"),
+        (0x48, "M", "h"),
+        (0x49, "M", "i"),
+        (0x4A, "M", "j"),
+        (0x4B, "M", "k"),
+        (0x4C, "M", "l"),
+        (0x4D, "M", "m"),
+        (0x4E, "M", "n"),
+        (0x4F, "M", "o"),
+        (0x50, "M", "p"),
+        (0x51, "M", "q"),
+        (0x52, "M", "r"),
+        (0x53, "M", "s"),
+        (0x54, "M", "t"),
+        (0x55, "M", "u"),
+        (0x56, "M", "v"),
+        (0x57, "M", "w"),
+        (0x58, "M", "x"),
+        (0x59, "M", "y"),
+        (0x5A, "M", "z"),
+        (0x5B, "3"),
+        (0x5C, "3"),
+        (0x5D, "3"),
+        (0x5E, "3"),
+        (0x5F, "3"),
+        (0x60, "3"),
+        (0x61, "V"),
+        (0x62, "V"),
+        (0x63, "V"),
     ]
 
+
 def _seg_1() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x64, 'V'),
-    (0x65, 'V'),
-    (0x66, 'V'),
-    (0x67, 'V'),
-    (0x68, 'V'),
-    (0x69, 'V'),
-    (0x6A, 'V'),
-    (0x6B, 'V'),
-    (0x6C, 'V'),
-    (0x6D, 'V'),
-    (0x6E, 'V'),
-    (0x6F, 'V'),
-    (0x70, 'V'),
-    (0x71, 'V'),
-    (0x72, 'V'),
-    (0x73, 'V'),
-    (0x74, 'V'),
-    (0x75, 'V'),
-    (0x76, 'V'),
-    (0x77, 'V'),
-    (0x78, 'V'),
-    (0x79, 'V'),
-    (0x7A, 'V'),
-    (0x7B, '3'),
-    (0x7C, '3'),
-    (0x7D, '3'),
-    (0x7E, '3'),
-    (0x7F, '3'),
-    (0x80, 'X'),
-    (0x81, 'X'),
-    (0x82, 'X'),
-    (0x83, 'X'),
-    (0x84, 'X'),
-    (0x85, 'X'),
-    (0x86, 'X'),
-    (0x87, 'X'),
-    (0x88, 'X'),
-    (0x89, 'X'),
-    (0x8A, 'X'),
-    (0x8B, 'X'),
-    (0x8C, 'X'),
-    (0x8D, 'X'),
-    (0x8E, 'X'),
-    (0x8F, 'X'),
-    (0x90, 'X'),
-    (0x91, 'X'),
-    (0x92, 'X'),
-    (0x93, 'X'),
-    (0x94, 'X'),
-    (0x95, 'X'),
-    (0x96, 'X'),
-    (0x97, 'X'),
-    (0x98, 'X'),
-    (0x99, 'X'),
-    (0x9A, 'X'),
-    (0x9B, 'X'),
-    (0x9C, 'X'),
-    (0x9D, 'X'),
-    (0x9E, 'X'),
-    (0x9F, 'X'),
-    (0xA0, '3', ' '),
-    (0xA1, 'V'),
-    (0xA2, 'V'),
-    (0xA3, 'V'),
-    (0xA4, 'V'),
-    (0xA5, 'V'),
-    (0xA6, 'V'),
-    (0xA7, 'V'),
-    (0xA8, '3', ' ̈'),
-    (0xA9, 'V'),
-    (0xAA, 'M', 'a'),
-    (0xAB, 'V'),
-    (0xAC, 'V'),
-    (0xAD, 'I'),
-    (0xAE, 'V'),
-    (0xAF, '3', ' ̄'),
-    (0xB0, 'V'),
-    (0xB1, 'V'),
-    (0xB2, 'M', '2'),
-    (0xB3, 'M', '3'),
-    (0xB4, '3', ' ́'),
-    (0xB5, 'M', 'μ'),
-    (0xB6, 'V'),
-    (0xB7, 'V'),
-    (0xB8, '3', ' ̧'),
-    (0xB9, 'M', '1'),
-    (0xBA, 'M', 'o'),
-    (0xBB, 'V'),
-    (0xBC, 'M', '1⁄4'),
-    (0xBD, 'M', '1⁄2'),
-    (0xBE, 'M', '3⁄4'),
-    (0xBF, 'V'),
-    (0xC0, 'M', 'à'),
-    (0xC1, 'M', 'á'),
-    (0xC2, 'M', 'â'),
-    (0xC3, 'M', 'ã'),
-    (0xC4, 'M', 'ä'),
-    (0xC5, 'M', 'å'),
-    (0xC6, 'M', 'æ'),
-    (0xC7, 'M', 'ç'),
+        (0x64, "V"),
+        (0x65, "V"),
+        (0x66, "V"),
+        (0x67, "V"),
+        (0x68, "V"),
+        (0x69, "V"),
+        (0x6A, "V"),
+        (0x6B, "V"),
+        (0x6C, "V"),
+        (0x6D, "V"),
+        (0x6E, "V"),
+        (0x6F, "V"),
+        (0x70, "V"),
+        (0x71, "V"),
+        (0x72, "V"),
+        (0x73, "V"),
+        (0x74, "V"),
+        (0x75, "V"),
+        (0x76, "V"),
+        (0x77, "V"),
+        (0x78, "V"),
+        (0x79, "V"),
+        (0x7A, "V"),
+        (0x7B, "3"),
+        (0x7C, "3"),
+        (0x7D, "3"),
+        (0x7E, "3"),
+        (0x7F, "3"),
+        (0x80, "X"),
+        (0x81, "X"),
+        (0x82, "X"),
+        (0x83, "X"),
+        (0x84, "X"),
+        (0x85, "X"),
+        (0x86, "X"),
+        (0x87, "X"),
+        (0x88, "X"),
+        (0x89, "X"),
+        (0x8A, "X"),
+        (0x8B, "X"),
+        (0x8C, "X"),
+        (0x8D, "X"),
+        (0x8E, "X"),
+        (0x8F, "X"),
+        (0x90, "X"),
+        (0x91, "X"),
+        (0x92, "X"),
+        (0x93, "X"),
+        (0x94, "X"),
+        (0x95, "X"),
+        (0x96, "X"),
+        (0x97, "X"),
+        (0x98, "X"),
+        (0x99, "X"),
+        (0x9A, "X"),
+        (0x9B, "X"),
+        (0x9C, "X"),
+        (0x9D, "X"),
+        (0x9E, "X"),
+        (0x9F, "X"),
+        (0xA0, "3", " "),
+        (0xA1, "V"),
+        (0xA2, "V"),
+        (0xA3, "V"),
+        (0xA4, "V"),
+        (0xA5, "V"),
+        (0xA6, "V"),
+        (0xA7, "V"),
+        (0xA8, "3", " ̈"),
+        (0xA9, "V"),
+        (0xAA, "M", "a"),
+        (0xAB, "V"),
+        (0xAC, "V"),
+        (0xAD, "I"),
+        (0xAE, "V"),
+        (0xAF, "3", " ̄"),
+        (0xB0, "V"),
+        (0xB1, "V"),
+        (0xB2, "M", "2"),
+        (0xB3, "M", "3"),
+        (0xB4, "3", " ́"),
+        (0xB5, "M", "μ"),
+        (0xB6, "V"),
+        (0xB7, "V"),
+        (0xB8, "3", " ̧"),
+        (0xB9, "M", "1"),
+        (0xBA, "M", "o"),
+        (0xBB, "V"),
+        (0xBC, "M", "1⁄4"),
+        (0xBD, "M", "1⁄2"),
+        (0xBE, "M", "3⁄4"),
+        (0xBF, "V"),
+        (0xC0, "M", "à"),
+        (0xC1, "M", "á"),
+        (0xC2, "M", "â"),
+        (0xC3, "M", "ã"),
+        (0xC4, "M", "ä"),
+        (0xC5, "M", "å"),
+        (0xC6, "M", "æ"),
+        (0xC7, "M", "ç"),
     ]
 
+
 def _seg_2() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0xC8, 'M', 'è'),
-    (0xC9, 'M', 'é'),
-    (0xCA, 'M', 'ê'),
-    (0xCB, 'M', 'ë'),
-    (0xCC, 'M', 'ì'),
-    (0xCD, 'M', 'í'),
-    (0xCE, 'M', 'î'),
-    (0xCF, 'M', 'ï'),
-    (0xD0, 'M', 'ð'),
-    (0xD1, 'M', 'ñ'),
-    (0xD2, 'M', 'ò'),
-    (0xD3, 'M', 'ó'),
-    (0xD4, 'M', 'ô'),
-    (0xD5, 'M', 'õ'),
-    (0xD6, 'M', 'ö'),
-    (0xD7, 'V'),
-    (0xD8, 'M', 'ø'),
-    (0xD9, 'M', 'ù'),
-    (0xDA, 'M', 'ú'),
-    (0xDB, 'M', 'û'),
-    (0xDC, 'M', 'ü'),
-    (0xDD, 'M', 'ý'),
-    (0xDE, 'M', 'þ'),
-    (0xDF, 'D', 'ss'),
-    (0xE0, 'V'),
-    (0xE1, 'V'),
-    (0xE2, 'V'),
-    (0xE3, 'V'),
-    (0xE4, 'V'),
-    (0xE5, 'V'),
-    (0xE6, 'V'),
-    (0xE7, 'V'),
-    (0xE8, 'V'),
-    (0xE9, 'V'),
-    (0xEA, 'V'),
-    (0xEB, 'V'),
-    (0xEC, 'V'),
-    (0xED, 'V'),
-    (0xEE, 'V'),
-    (0xEF, 'V'),
-    (0xF0, 'V'),
-    (0xF1, 'V'),
-    (0xF2, 'V'),
-    (0xF3, 'V'),
-    (0xF4, 'V'),
-    (0xF5, 'V'),
-    (0xF6, 'V'),
-    (0xF7, 'V'),
-    (0xF8, 'V'),
-    (0xF9, 'V'),
-    (0xFA, 'V'),
-    (0xFB, 'V'),
-    (0xFC, 'V'),
-    (0xFD, 'V'),
-    (0xFE, 'V'),
-    (0xFF, 'V'),
-    (0x100, 'M', 'ā'),
-    (0x101, 'V'),
-    (0x102, 'M', 'ă'),
-    (0x103, 'V'),
-    (0x104, 'M', 'ą'),
-    (0x105, 'V'),
-    (0x106, 'M', 'ć'),
-    (0x107, 'V'),
-    (0x108, 'M', 'ĉ'),
-    (0x109, 'V'),
-    (0x10A, 'M', 'ċ'),
-    (0x10B, 'V'),
-    (0x10C, 'M', 'č'),
-    (0x10D, 'V'),
-    (0x10E, 'M', 'ď'),
-    (0x10F, 'V'),
-    (0x110, 'M', 'đ'),
-    (0x111, 'V'),
-    (0x112, 'M', 'ē'),
-    (0x113, 'V'),
-    (0x114, 'M', 'ĕ'),
-    (0x115, 'V'),
-    (0x116, 'M', 'ė'),
-    (0x117, 'V'),
-    (0x118, 'M', 'ę'),
-    (0x119, 'V'),
-    (0x11A, 'M', 'ě'),
-    (0x11B, 'V'),
-    (0x11C, 'M', 'ĝ'),
-    (0x11D, 'V'),
-    (0x11E, 'M', 'ğ'),
-    (0x11F, 'V'),
-    (0x120, 'M', 'ġ'),
-    (0x121, 'V'),
-    (0x122, 'M', 'ģ'),
-    (0x123, 'V'),
-    (0x124, 'M', 'ĥ'),
-    (0x125, 'V'),
-    (0x126, 'M', 'ħ'),
-    (0x127, 'V'),
-    (0x128, 'M', 'ĩ'),
-    (0x129, 'V'),
-    (0x12A, 'M', 'ī'),
-    (0x12B, 'V'),
+        (0xC8, "M", "è"),
+        (0xC9, "M", "é"),
+        (0xCA, "M", "ê"),
+        (0xCB, "M", "ë"),
+        (0xCC, "M", "ì"),
+        (0xCD, "M", "í"),
+        (0xCE, "M", "î"),
+        (0xCF, "M", "ï"),
+        (0xD0, "M", "ð"),
+        (0xD1, "M", "ñ"),
+        (0xD2, "M", "ò"),
+        (0xD3, "M", "ó"),
+        (0xD4, "M", "ô"),
+        (0xD5, "M", "õ"),
+        (0xD6, "M", "ö"),
+        (0xD7, "V"),
+        (0xD8, "M", "ø"),
+        (0xD9, "M", "ù"),
+        (0xDA, "M", "ú"),
+        (0xDB, "M", "û"),
+        (0xDC, "M", "ü"),
+        (0xDD, "M", "ý"),
+        (0xDE, "M", "þ"),
+        (0xDF, "D", "ss"),
+        (0xE0, "V"),
+        (0xE1, "V"),
+        (0xE2, "V"),
+        (0xE3, "V"),
+        (0xE4, "V"),
+        (0xE5, "V"),
+        (0xE6, "V"),
+        (0xE7, "V"),
+        (0xE8, "V"),
+        (0xE9, "V"),
+        (0xEA, "V"),
+        (0xEB, "V"),
+        (0xEC, "V"),
+        (0xED, "V"),
+        (0xEE, "V"),
+        (0xEF, "V"),
+        (0xF0, "V"),
+        (0xF1, "V"),
+        (0xF2, "V"),
+        (0xF3, "V"),
+        (0xF4, "V"),
+        (0xF5, "V"),
+        (0xF6, "V"),
+        (0xF7, "V"),
+        (0xF8, "V"),
+        (0xF9, "V"),
+        (0xFA, "V"),
+        (0xFB, "V"),
+        (0xFC, "V"),
+        (0xFD, "V"),
+        (0xFE, "V"),
+        (0xFF, "V"),
+        (0x100, "M", "ā"),
+        (0x101, "V"),
+        (0x102, "M", "ă"),
+        (0x103, "V"),
+        (0x104, "M", "ą"),
+        (0x105, "V"),
+        (0x106, "M", "ć"),
+        (0x107, "V"),
+        (0x108, "M", "ĉ"),
+        (0x109, "V"),
+        (0x10A, "M", "ċ"),
+        (0x10B, "V"),
+        (0x10C, "M", "č"),
+        (0x10D, "V"),
+        (0x10E, "M", "ď"),
+        (0x10F, "V"),
+        (0x110, "M", "đ"),
+        (0x111, "V"),
+        (0x112, "M", "ē"),
+        (0x113, "V"),
+        (0x114, "M", "ĕ"),
+        (0x115, "V"),
+        (0x116, "M", "ė"),
+        (0x117, "V"),
+        (0x118, "M", "ę"),
+        (0x119, "V"),
+        (0x11A, "M", "ě"),
+        (0x11B, "V"),
+        (0x11C, "M", "ĝ"),
+        (0x11D, "V"),
+        (0x11E, "M", "ğ"),
+        (0x11F, "V"),
+        (0x120, "M", "ġ"),
+        (0x121, "V"),
+        (0x122, "M", "ģ"),
+        (0x123, "V"),
+        (0x124, "M", "ĥ"),
+        (0x125, "V"),
+        (0x126, "M", "ħ"),
+        (0x127, "V"),
+        (0x128, "M", "ĩ"),
+        (0x129, "V"),
+        (0x12A, "M", "ī"),
+        (0x12B, "V"),
     ]
 
+
 def _seg_3() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x12C, 'M', 'ĭ'),
-    (0x12D, 'V'),
-    (0x12E, 'M', 'į'),
-    (0x12F, 'V'),
-    (0x130, 'M', 'i̇'),
-    (0x131, 'V'),
-    (0x132, 'M', 'ij'),
-    (0x134, 'M', 'ĵ'),
-    (0x135, 'V'),
-    (0x136, 'M', 'ķ'),
-    (0x137, 'V'),
-    (0x139, 'M', 'ĺ'),
-    (0x13A, 'V'),
-    (0x13B, 'M', 'ļ'),
-    (0x13C, 'V'),
-    (0x13D, 'M', 'ľ'),
-    (0x13E, 'V'),
-    (0x13F, 'M', 'l·'),
-    (0x141, 'M', 'ł'),
-    (0x142, 'V'),
-    (0x143, 'M', 'ń'),
-    (0x144, 'V'),
-    (0x145, 'M', 'ņ'),
-    (0x146, 'V'),
-    (0x147, 'M', 'ň'),
-    (0x148, 'V'),
-    (0x149, 'M', 'ʼn'),
-    (0x14A, 'M', 'ŋ'),
-    (0x14B, 'V'),
-    (0x14C, 'M', 'ō'),
-    (0x14D, 'V'),
-    (0x14E, 'M', 'ŏ'),
-    (0x14F, 'V'),
-    (0x150, 'M', 'ő'),
-    (0x151, 'V'),
-    (0x152, 'M', 'œ'),
-    (0x153, 'V'),
-    (0x154, 'M', 'ŕ'),
-    (0x155, 'V'),
-    (0x156, 'M', 'ŗ'),
-    (0x157, 'V'),
-    (0x158, 'M', 'ř'),
-    (0x159, 'V'),
-    (0x15A, 'M', 'ś'),
-    (0x15B, 'V'),
-    (0x15C, 'M', 'ŝ'),
-    (0x15D, 'V'),
-    (0x15E, 'M', 'ş'),
-    (0x15F, 'V'),
-    (0x160, 'M', 'š'),
-    (0x161, 'V'),
-    (0x162, 'M', 'ţ'),
-    (0x163, 'V'),
-    (0x164, 'M', 'ť'),
-    (0x165, 'V'),
-    (0x166, 'M', 'ŧ'),
-    (0x167, 'V'),
-    (0x168, 'M', 'ũ'),
-    (0x169, 'V'),
-    (0x16A, 'M', 'ū'),
-    (0x16B, 'V'),
-    (0x16C, 'M', 'ŭ'),
-    (0x16D, 'V'),
-    (0x16E, 'M', 'ů'),
-    (0x16F, 'V'),
-    (0x170, 'M', 'ű'),
-    (0x171, 'V'),
-    (0x172, 'M', 'ų'),
-    (0x173, 'V'),
-    (0x174, 'M', 'ŵ'),
-    (0x175, 'V'),
-    (0x176, 'M', 'ŷ'),
-    (0x177, 'V'),
-    (0x178, 'M', 'ÿ'),
-    (0x179, 'M', 'ź'),
-    (0x17A, 'V'),
-    (0x17B, 'M', 'ż'),
-    (0x17C, 'V'),
-    (0x17D, 'M', 'ž'),
-    (0x17E, 'V'),
-    (0x17F, 'M', 's'),
-    (0x180, 'V'),
-    (0x181, 'M', 'ɓ'),
-    (0x182, 'M', 'ƃ'),
-    (0x183, 'V'),
-    (0x184, 'M', 'ƅ'),
-    (0x185, 'V'),
-    (0x186, 'M', 'ɔ'),
-    (0x187, 'M', 'ƈ'),
-    (0x188, 'V'),
-    (0x189, 'M', 'ɖ'),
-    (0x18A, 'M', 'ɗ'),
-    (0x18B, 'M', 'ƌ'),
-    (0x18C, 'V'),
-    (0x18E, 'M', 'ǝ'),
-    (0x18F, 'M', 'ə'),
-    (0x190, 'M', 'ɛ'),
-    (0x191, 'M', 'ƒ'),
-    (0x192, 'V'),
-    (0x193, 'M', 'ɠ'),
+        (0x12C, "M", "ĭ"),
+        (0x12D, "V"),
+        (0x12E, "M", "į"),
+        (0x12F, "V"),
+        (0x130, "M", "i̇"),
+        (0x131, "V"),
+        (0x132, "M", "ij"),
+        (0x134, "M", "ĵ"),
+        (0x135, "V"),
+        (0x136, "M", "ķ"),
+        (0x137, "V"),
+        (0x139, "M", "ĺ"),
+        (0x13A, "V"),
+        (0x13B, "M", "ļ"),
+        (0x13C, "V"),
+        (0x13D, "M", "ľ"),
+        (0x13E, "V"),
+        (0x13F, "M", "l·"),
+        (0x141, "M", "ł"),
+        (0x142, "V"),
+        (0x143, "M", "ń"),
+        (0x144, "V"),
+        (0x145, "M", "ņ"),
+        (0x146, "V"),
+        (0x147, "M", "ň"),
+        (0x148, "V"),
+        (0x149, "M", "ʼn"),
+        (0x14A, "M", "ŋ"),
+        (0x14B, "V"),
+        (0x14C, "M", "ō"),
+        (0x14D, "V"),
+        (0x14E, "M", "ŏ"),
+        (0x14F, "V"),
+        (0x150, "M", "ő"),
+        (0x151, "V"),
+        (0x152, "M", "œ"),
+        (0x153, "V"),
+        (0x154, "M", "ŕ"),
+        (0x155, "V"),
+        (0x156, "M", "ŗ"),
+        (0x157, "V"),
+        (0x158, "M", "ř"),
+        (0x159, "V"),
+        (0x15A, "M", "ś"),
+        (0x15B, "V"),
+        (0x15C, "M", "ŝ"),
+        (0x15D, "V"),
+        (0x15E, "M", "ş"),
+        (0x15F, "V"),
+        (0x160, "M", "š"),
+        (0x161, "V"),
+        (0x162, "M", "ţ"),
+        (0x163, "V"),
+        (0x164, "M", "ť"),
+        (0x165, "V"),
+        (0x166, "M", "ŧ"),
+        (0x167, "V"),
+        (0x168, "M", "ũ"),
+        (0x169, "V"),
+        (0x16A, "M", "ū"),
+        (0x16B, "V"),
+        (0x16C, "M", "ŭ"),
+        (0x16D, "V"),
+        (0x16E, "M", "ů"),
+        (0x16F, "V"),
+        (0x170, "M", "ű"),
+        (0x171, "V"),
+        (0x172, "M", "ų"),
+        (0x173, "V"),
+        (0x174, "M", "ŵ"),
+        (0x175, "V"),
+        (0x176, "M", "ŷ"),
+        (0x177, "V"),
+        (0x178, "M", "ÿ"),
+        (0x179, "M", "ź"),
+        (0x17A, "V"),
+        (0x17B, "M", "ż"),
+        (0x17C, "V"),
+        (0x17D, "M", "ž"),
+        (0x17E, "V"),
+        (0x17F, "M", "s"),
+        (0x180, "V"),
+        (0x181, "M", "ɓ"),
+        (0x182, "M", "ƃ"),
+        (0x183, "V"),
+        (0x184, "M", "ƅ"),
+        (0x185, "V"),
+        (0x186, "M", "ɔ"),
+        (0x187, "M", "ƈ"),
+        (0x188, "V"),
+        (0x189, "M", "ɖ"),
+        (0x18A, "M", "ɗ"),
+        (0x18B, "M", "ƌ"),
+        (0x18C, "V"),
+        (0x18E, "M", "ǝ"),
+        (0x18F, "M", "ə"),
+        (0x190, "M", "ɛ"),
+        (0x191, "M", "ƒ"),
+        (0x192, "V"),
+        (0x193, "M", "ɠ"),
     ]
 
+
 def _seg_4() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x194, 'M', 'ɣ'),
-    (0x195, 'V'),
-    (0x196, 'M', 'ɩ'),
-    (0x197, 'M', 'ɨ'),
-    (0x198, 'M', 'ƙ'),
-    (0x199, 'V'),
-    (0x19C, 'M', 'ɯ'),
-    (0x19D, 'M', 'ɲ'),
-    (0x19E, 'V'),
-    (0x19F, 'M', 'ɵ'),
-    (0x1A0, 'M', 'ơ'),
-    (0x1A1, 'V'),
-    (0x1A2, 'M', 'ƣ'),
-    (0x1A3, 'V'),
-    (0x1A4, 'M', 'ƥ'),
-    (0x1A5, 'V'),
-    (0x1A6, 'M', 'ʀ'),
-    (0x1A7, 'M', 'ƨ'),
-    (0x1A8, 'V'),
-    (0x1A9, 'M', 'ʃ'),
-    (0x1AA, 'V'),
-    (0x1AC, 'M', 'ƭ'),
-    (0x1AD, 'V'),
-    (0x1AE, 'M', 'ʈ'),
-    (0x1AF, 'M', 'ư'),
-    (0x1B0, 'V'),
-    (0x1B1, 'M', 'ʊ'),
-    (0x1B2, 'M', 'ʋ'),
-    (0x1B3, 'M', 'ƴ'),
-    (0x1B4, 'V'),
-    (0x1B5, 'M', 'ƶ'),
-    (0x1B6, 'V'),
-    (0x1B7, 'M', 'ʒ'),
-    (0x1B8, 'M', 'ƹ'),
-    (0x1B9, 'V'),
-    (0x1BC, 'M', 'ƽ'),
-    (0x1BD, 'V'),
-    (0x1C4, 'M', 'dž'),
-    (0x1C7, 'M', 'lj'),
-    (0x1CA, 'M', 'nj'),
-    (0x1CD, 'M', 'ǎ'),
-    (0x1CE, 'V'),
-    (0x1CF, 'M', 'ǐ'),
-    (0x1D0, 'V'),
-    (0x1D1, 'M', 'ǒ'),
-    (0x1D2, 'V'),
-    (0x1D3, 'M', 'ǔ'),
-    (0x1D4, 'V'),
-    (0x1D5, 'M', 'ǖ'),
-    (0x1D6, 'V'),
-    (0x1D7, 'M', 'ǘ'),
-    (0x1D8, 'V'),
-    (0x1D9, 'M', 'ǚ'),
-    (0x1DA, 'V'),
-    (0x1DB, 'M', 'ǜ'),
-    (0x1DC, 'V'),
-    (0x1DE, 'M', 'ǟ'),
-    (0x1DF, 'V'),
-    (0x1E0, 'M', 'ǡ'),
-    (0x1E1, 'V'),
-    (0x1E2, 'M', 'ǣ'),
-    (0x1E3, 'V'),
-    (0x1E4, 'M', 'ǥ'),
-    (0x1E5, 'V'),
-    (0x1E6, 'M', 'ǧ'),
-    (0x1E7, 'V'),
-    (0x1E8, 'M', 'ǩ'),
-    (0x1E9, 'V'),
-    (0x1EA, 'M', 'ǫ'),
-    (0x1EB, 'V'),
-    (0x1EC, 'M', 'ǭ'),
-    (0x1ED, 'V'),
-    (0x1EE, 'M', 'ǯ'),
-    (0x1EF, 'V'),
-    (0x1F1, 'M', 'dz'),
-    (0x1F4, 'M', 'ǵ'),
-    (0x1F5, 'V'),
-    (0x1F6, 'M', 'ƕ'),
-    (0x1F7, 'M', 'ƿ'),
-    (0x1F8, 'M', 'ǹ'),
-    (0x1F9, 'V'),
-    (0x1FA, 'M', 'ǻ'),
-    (0x1FB, 'V'),
-    (0x1FC, 'M', 'ǽ'),
-    (0x1FD, 'V'),
-    (0x1FE, 'M', 'ǿ'),
-    (0x1FF, 'V'),
-    (0x200, 'M', 'ȁ'),
-    (0x201, 'V'),
-    (0x202, 'M', 'ȃ'),
-    (0x203, 'V'),
-    (0x204, 'M', 'ȅ'),
-    (0x205, 'V'),
-    (0x206, 'M', 'ȇ'),
-    (0x207, 'V'),
-    (0x208, 'M', 'ȉ'),
-    (0x209, 'V'),
-    (0x20A, 'M', 'ȋ'),
-    (0x20B, 'V'),
-    (0x20C, 'M', 'ȍ'),
+        (0x194, "M", "ɣ"),
+        (0x195, "V"),
+        (0x196, "M", "ɩ"),
+        (0x197, "M", "ɨ"),
+        (0x198, "M", "ƙ"),
+        (0x199, "V"),
+        (0x19C, "M", "ɯ"),
+        (0x19D, "M", "ɲ"),
+        (0x19E, "V"),
+        (0x19F, "M", "ɵ"),
+        (0x1A0, "M", "ơ"),
+        (0x1A1, "V"),
+        (0x1A2, "M", "ƣ"),
+        (0x1A3, "V"),
+        (0x1A4, "M", "ƥ"),
+        (0x1A5, "V"),
+        (0x1A6, "M", "ʀ"),
+        (0x1A7, "M", "ƨ"),
+        (0x1A8, "V"),
+        (0x1A9, "M", "ʃ"),
+        (0x1AA, "V"),
+        (0x1AC, "M", "ƭ"),
+        (0x1AD, "V"),
+        (0x1AE, "M", "ʈ"),
+        (0x1AF, "M", "ư"),
+        (0x1B0, "V"),
+        (0x1B1, "M", "ʊ"),
+        (0x1B2, "M", "ʋ"),
+        (0x1B3, "M", "ƴ"),
+        (0x1B4, "V"),
+        (0x1B5, "M", "ƶ"),
+        (0x1B6, "V"),
+        (0x1B7, "M", "ʒ"),
+        (0x1B8, "M", "ƹ"),
+        (0x1B9, "V"),
+        (0x1BC, "M", "ƽ"),
+        (0x1BD, "V"),
+        (0x1C4, "M", "dž"),
+        (0x1C7, "M", "lj"),
+        (0x1CA, "M", "nj"),
+        (0x1CD, "M", "ǎ"),
+        (0x1CE, "V"),
+        (0x1CF, "M", "ǐ"),
+        (0x1D0, "V"),
+        (0x1D1, "M", "ǒ"),
+        (0x1D2, "V"),
+        (0x1D3, "M", "ǔ"),
+        (0x1D4, "V"),
+        (0x1D5, "M", "ǖ"),
+        (0x1D6, "V"),
+        (0x1D7, "M", "ǘ"),
+        (0x1D8, "V"),
+        (0x1D9, "M", "ǚ"),
+        (0x1DA, "V"),
+        (0x1DB, "M", "ǜ"),
+        (0x1DC, "V"),
+        (0x1DE, "M", "ǟ"),
+        (0x1DF, "V"),
+        (0x1E0, "M", "ǡ"),
+        (0x1E1, "V"),
+        (0x1E2, "M", "ǣ"),
+        (0x1E3, "V"),
+        (0x1E4, "M", "ǥ"),
+        (0x1E5, "V"),
+        (0x1E6, "M", "ǧ"),
+        (0x1E7, "V"),
+        (0x1E8, "M", "ǩ"),
+        (0x1E9, "V"),
+        (0x1EA, "M", "ǫ"),
+        (0x1EB, "V"),
+        (0x1EC, "M", "ǭ"),
+        (0x1ED, "V"),
+        (0x1EE, "M", "ǯ"),
+        (0x1EF, "V"),
+        (0x1F1, "M", "dz"),
+        (0x1F4, "M", "ǵ"),
+        (0x1F5, "V"),
+        (0x1F6, "M", "ƕ"),
+        (0x1F7, "M", "ƿ"),
+        (0x1F8, "M", "ǹ"),
+        (0x1F9, "V"),
+        (0x1FA, "M", "ǻ"),
+        (0x1FB, "V"),
+        (0x1FC, "M", "ǽ"),
+        (0x1FD, "V"),
+        (0x1FE, "M", "ǿ"),
+        (0x1FF, "V"),
+        (0x200, "M", "ȁ"),
+        (0x201, "V"),
+        (0x202, "M", "ȃ"),
+        (0x203, "V"),
+        (0x204, "M", "ȅ"),
+        (0x205, "V"),
+        (0x206, "M", "ȇ"),
+        (0x207, "V"),
+        (0x208, "M", "ȉ"),
+        (0x209, "V"),
+        (0x20A, "M", "ȋ"),
+        (0x20B, "V"),
+        (0x20C, "M", "ȍ"),
     ]
 
+
 def _seg_5() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x20D, 'V'),
-    (0x20E, 'M', 'ȏ'),
-    (0x20F, 'V'),
-    (0x210, 'M', 'ȑ'),
-    (0x211, 'V'),
-    (0x212, 'M', 'ȓ'),
-    (0x213, 'V'),
-    (0x214, 'M', 'ȕ'),
-    (0x215, 'V'),
-    (0x216, 'M', 'ȗ'),
-    (0x217, 'V'),
-    (0x218, 'M', 'ș'),
-    (0x219, 'V'),
-    (0x21A, 'M', 'ț'),
-    (0x21B, 'V'),
-    (0x21C, 'M', 'ȝ'),
-    (0x21D, 'V'),
-    (0x21E, 'M', 'ȟ'),
-    (0x21F, 'V'),
-    (0x220, 'M', 'ƞ'),
-    (0x221, 'V'),
-    (0x222, 'M', 'ȣ'),
-    (0x223, 'V'),
-    (0x224, 'M', 'ȥ'),
-    (0x225, 'V'),
-    (0x226, 'M', 'ȧ'),
-    (0x227, 'V'),
-    (0x228, 'M', 'ȩ'),
-    (0x229, 'V'),
-    (0x22A, 'M', 'ȫ'),
-    (0x22B, 'V'),
-    (0x22C, 'M', 'ȭ'),
-    (0x22D, 'V'),
-    (0x22E, 'M', 'ȯ'),
-    (0x22F, 'V'),
-    (0x230, 'M', 'ȱ'),
-    (0x231, 'V'),
-    (0x232, 'M', 'ȳ'),
-    (0x233, 'V'),
-    (0x23A, 'M', 'ⱥ'),
-    (0x23B, 'M', 'ȼ'),
-    (0x23C, 'V'),
-    (0x23D, 'M', 'ƚ'),
-    (0x23E, 'M', 'ⱦ'),
-    (0x23F, 'V'),
-    (0x241, 'M', 'ɂ'),
-    (0x242, 'V'),
-    (0x243, 'M', 'ƀ'),
-    (0x244, 'M', 'ʉ'),
-    (0x245, 'M', 'ʌ'),
-    (0x246, 'M', 'ɇ'),
-    (0x247, 'V'),
-    (0x248, 'M', 'ɉ'),
-    (0x249, 'V'),
-    (0x24A, 'M', 'ɋ'),
-    (0x24B, 'V'),
-    (0x24C, 'M', 'ɍ'),
-    (0x24D, 'V'),
-    (0x24E, 'M', 'ɏ'),
-    (0x24F, 'V'),
-    (0x2B0, 'M', 'h'),
-    (0x2B1, 'M', 'ɦ'),
-    (0x2B2, 'M', 'j'),
-    (0x2B3, 'M', 'r'),
-    (0x2B4, 'M', 'ɹ'),
-    (0x2B5, 'M', 'ɻ'),
-    (0x2B6, 'M', 'ʁ'),
-    (0x2B7, 'M', 'w'),
-    (0x2B8, 'M', 'y'),
-    (0x2B9, 'V'),
-    (0x2D8, '3', ' ̆'),
-    (0x2D9, '3', ' ̇'),
-    (0x2DA, '3', ' ̊'),
-    (0x2DB, '3', ' ̨'),
-    (0x2DC, '3', ' ̃'),
-    (0x2DD, '3', ' ̋'),
-    (0x2DE, 'V'),
-    (0x2E0, 'M', 'ɣ'),
-    (0x2E1, 'M', 'l'),
-    (0x2E2, 'M', 's'),
-    (0x2E3, 'M', 'x'),
-    (0x2E4, 'M', 'ʕ'),
-    (0x2E5, 'V'),
-    (0x340, 'M', '̀'),
-    (0x341, 'M', '́'),
-    (0x342, 'V'),
-    (0x343, 'M', '̓'),
-    (0x344, 'M', '̈́'),
-    (0x345, 'M', 'ι'),
-    (0x346, 'V'),
-    (0x34F, 'I'),
-    (0x350, 'V'),
-    (0x370, 'M', 'ͱ'),
-    (0x371, 'V'),
-    (0x372, 'M', 'ͳ'),
-    (0x373, 'V'),
-    (0x374, 'M', 'ʹ'),
-    (0x375, 'V'),
-    (0x376, 'M', 'ͷ'),
-    (0x377, 'V'),
+        (0x20D, "V"),
+        (0x20E, "M", "ȏ"),
+        (0x20F, "V"),
+        (0x210, "M", "ȑ"),
+        (0x211, "V"),
+        (0x212, "M", "ȓ"),
+        (0x213, "V"),
+        (0x214, "M", "ȕ"),
+        (0x215, "V"),
+        (0x216, "M", "ȗ"),
+        (0x217, "V"),
+        (0x218, "M", "ș"),
+        (0x219, "V"),
+        (0x21A, "M", "ț"),
+        (0x21B, "V"),
+        (0x21C, "M", "ȝ"),
+        (0x21D, "V"),
+        (0x21E, "M", "ȟ"),
+        (0x21F, "V"),
+        (0x220, "M", "ƞ"),
+        (0x221, "V"),
+        (0x222, "M", "ȣ"),
+        (0x223, "V"),
+        (0x224, "M", "ȥ"),
+        (0x225, "V"),
+        (0x226, "M", "ȧ"),
+        (0x227, "V"),
+        (0x228, "M", "ȩ"),
+        (0x229, "V"),
+        (0x22A, "M", "ȫ"),
+        (0x22B, "V"),
+        (0x22C, "M", "ȭ"),
+        (0x22D, "V"),
+        (0x22E, "M", "ȯ"),
+        (0x22F, "V"),
+        (0x230, "M", "ȱ"),
+        (0x231, "V"),
+        (0x232, "M", "ȳ"),
+        (0x233, "V"),
+        (0x23A, "M", "ⱥ"),
+        (0x23B, "M", "ȼ"),
+        (0x23C, "V"),
+        (0x23D, "M", "ƚ"),
+        (0x23E, "M", "ⱦ"),
+        (0x23F, "V"),
+        (0x241, "M", "ɂ"),
+        (0x242, "V"),
+        (0x243, "M", "ƀ"),
+        (0x244, "M", "ʉ"),
+        (0x245, "M", "ʌ"),
+        (0x246, "M", "ɇ"),
+        (0x247, "V"),
+        (0x248, "M", "ɉ"),
+        (0x249, "V"),
+        (0x24A, "M", "ɋ"),
+        (0x24B, "V"),
+        (0x24C, "M", "ɍ"),
+        (0x24D, "V"),
+        (0x24E, "M", "ɏ"),
+        (0x24F, "V"),
+        (0x2B0, "M", "h"),
+        (0x2B1, "M", "ɦ"),
+        (0x2B2, "M", "j"),
+        (0x2B3, "M", "r"),
+        (0x2B4, "M", "ɹ"),
+        (0x2B5, "M", "ɻ"),
+        (0x2B6, "M", "ʁ"),
+        (0x2B7, "M", "w"),
+        (0x2B8, "M", "y"),
+        (0x2B9, "V"),
+        (0x2D8, "3", " ̆"),
+        (0x2D9, "3", " ̇"),
+        (0x2DA, "3", " ̊"),
+        (0x2DB, "3", " ̨"),
+        (0x2DC, "3", " ̃"),
+        (0x2DD, "3", " ̋"),
+        (0x2DE, "V"),
+        (0x2E0, "M", "ɣ"),
+        (0x2E1, "M", "l"),
+        (0x2E2, "M", "s"),
+        (0x2E3, "M", "x"),
+        (0x2E4, "M", "ʕ"),
+        (0x2E5, "V"),
+        (0x340, "M", "̀"),
+        (0x341, "M", "́"),
+        (0x342, "V"),
+        (0x343, "M", "̓"),
+        (0x344, "M", "̈́"),
+        (0x345, "M", "ι"),
+        (0x346, "V"),
+        (0x34F, "I"),
+        (0x350, "V"),
+        (0x370, "M", "ͱ"),
+        (0x371, "V"),
+        (0x372, "M", "ͳ"),
+        (0x373, "V"),
+        (0x374, "M", "ʹ"),
+        (0x375, "V"),
+        (0x376, "M", "ͷ"),
+        (0x377, "V"),
     ]
 
+
 def _seg_6() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x378, 'X'),
-    (0x37A, '3', ' ι'),
-    (0x37B, 'V'),
-    (0x37E, '3', ';'),
-    (0x37F, 'M', 'ϳ'),
-    (0x380, 'X'),
-    (0x384, '3', ' ́'),
-    (0x385, '3', ' ̈́'),
-    (0x386, 'M', 'ά'),
-    (0x387, 'M', '·'),
-    (0x388, 'M', 'έ'),
-    (0x389, 'M', 'ή'),
-    (0x38A, 'M', 'ί'),
-    (0x38B, 'X'),
-    (0x38C, 'M', 'ό'),
-    (0x38D, 'X'),
-    (0x38E, 'M', 'ύ'),
-    (0x38F, 'M', 'ώ'),
-    (0x390, 'V'),
-    (0x391, 'M', 'α'),
-    (0x392, 'M', 'β'),
-    (0x393, 'M', 'γ'),
-    (0x394, 'M', 'δ'),
-    (0x395, 'M', 'ε'),
-    (0x396, 'M', 'ζ'),
-    (0x397, 'M', 'η'),
-    (0x398, 'M', 'θ'),
-    (0x399, 'M', 'ι'),
-    (0x39A, 'M', 'κ'),
-    (0x39B, 'M', 'λ'),
-    (0x39C, 'M', 'μ'),
-    (0x39D, 'M', 'ν'),
-    (0x39E, 'M', 'ξ'),
-    (0x39F, 'M', 'ο'),
-    (0x3A0, 'M', 'π'),
-    (0x3A1, 'M', 'ρ'),
-    (0x3A2, 'X'),
-    (0x3A3, 'M', 'σ'),
-    (0x3A4, 'M', 'τ'),
-    (0x3A5, 'M', 'υ'),
-    (0x3A6, 'M', 'φ'),
-    (0x3A7, 'M', 'χ'),
-    (0x3A8, 'M', 'ψ'),
-    (0x3A9, 'M', 'ω'),
-    (0x3AA, 'M', 'ϊ'),
-    (0x3AB, 'M', 'ϋ'),
-    (0x3AC, 'V'),
-    (0x3C2, 'D', 'σ'),
-    (0x3C3, 'V'),
-    (0x3CF, 'M', 'ϗ'),
-    (0x3D0, 'M', 'β'),
-    (0x3D1, 'M', 'θ'),
-    (0x3D2, 'M', 'υ'),
-    (0x3D3, 'M', 'ύ'),
-    (0x3D4, 'M', 'ϋ'),
-    (0x3D5, 'M', 'φ'),
-    (0x3D6, 'M', 'π'),
-    (0x3D7, 'V'),
-    (0x3D8, 'M', 'ϙ'),
-    (0x3D9, 'V'),
-    (0x3DA, 'M', 'ϛ'),
-    (0x3DB, 'V'),
-    (0x3DC, 'M', 'ϝ'),
-    (0x3DD, 'V'),
-    (0x3DE, 'M', 'ϟ'),
-    (0x3DF, 'V'),
-    (0x3E0, 'M', 'ϡ'),
-    (0x3E1, 'V'),
-    (0x3E2, 'M', 'ϣ'),
-    (0x3E3, 'V'),
-    (0x3E4, 'M', 'ϥ'),
-    (0x3E5, 'V'),
-    (0x3E6, 'M', 'ϧ'),
-    (0x3E7, 'V'),
-    (0x3E8, 'M', 'ϩ'),
-    (0x3E9, 'V'),
-    (0x3EA, 'M', 'ϫ'),
-    (0x3EB, 'V'),
-    (0x3EC, 'M', 'ϭ'),
-    (0x3ED, 'V'),
-    (0x3EE, 'M', 'ϯ'),
-    (0x3EF, 'V'),
-    (0x3F0, 'M', 'κ'),
-    (0x3F1, 'M', 'ρ'),
-    (0x3F2, 'M', 'σ'),
-    (0x3F3, 'V'),
-    (0x3F4, 'M', 'θ'),
-    (0x3F5, 'M', 'ε'),
-    (0x3F6, 'V'),
-    (0x3F7, 'M', 'ϸ'),
-    (0x3F8, 'V'),
-    (0x3F9, 'M', 'σ'),
-    (0x3FA, 'M', 'ϻ'),
-    (0x3FB, 'V'),
-    (0x3FD, 'M', 'ͻ'),
-    (0x3FE, 'M', 'ͼ'),
-    (0x3FF, 'M', 'ͽ'),
-    (0x400, 'M', 'ѐ'),
-    (0x401, 'M', 'ё'),
-    (0x402, 'M', 'ђ'),
+        (0x378, "X"),
+        (0x37A, "3", " ι"),
+        (0x37B, "V"),
+        (0x37E, "3", ";"),
+        (0x37F, "M", "ϳ"),
+        (0x380, "X"),
+        (0x384, "3", " ́"),
+        (0x385, "3", " ̈́"),
+        (0x386, "M", "ά"),
+        (0x387, "M", "·"),
+        (0x388, "M", "έ"),
+        (0x389, "M", "ή"),
+        (0x38A, "M", "ί"),
+        (0x38B, "X"),
+        (0x38C, "M", "ό"),
+        (0x38D, "X"),
+        (0x38E, "M", "ύ"),
+        (0x38F, "M", "ώ"),
+        (0x390, "V"),
+        (0x391, "M", "α"),
+        (0x392, "M", "β"),
+        (0x393, "M", "γ"),
+        (0x394, "M", "δ"),
+        (0x395, "M", "ε"),
+        (0x396, "M", "ζ"),
+        (0x397, "M", "η"),
+        (0x398, "M", "θ"),
+        (0x399, "M", "ι"),
+        (0x39A, "M", "κ"),
+        (0x39B, "M", "λ"),
+        (0x39C, "M", "μ"),
+        (0x39D, "M", "ν"),
+        (0x39E, "M", "ξ"),
+        (0x39F, "M", "ο"),
+        (0x3A0, "M", "π"),
+        (0x3A1, "M", "ρ"),
+        (0x3A2, "X"),
+        (0x3A3, "M", "σ"),
+        (0x3A4, "M", "τ"),
+        (0x3A5, "M", "υ"),
+        (0x3A6, "M", "φ"),
+        (0x3A7, "M", "χ"),
+        (0x3A8, "M", "ψ"),
+        (0x3A9, "M", "ω"),
+        (0x3AA, "M", "ϊ"),
+        (0x3AB, "M", "ϋ"),
+        (0x3AC, "V"),
+        (0x3C2, "D", "σ"),
+        (0x3C3, "V"),
+        (0x3CF, "M", "ϗ"),
+        (0x3D0, "M", "β"),
+        (0x3D1, "M", "θ"),
+        (0x3D2, "M", "υ"),
+        (0x3D3, "M", "ύ"),
+        (0x3D4, "M", "ϋ"),
+        (0x3D5, "M", "φ"),
+        (0x3D6, "M", "π"),
+        (0x3D7, "V"),
+        (0x3D8, "M", "ϙ"),
+        (0x3D9, "V"),
+        (0x3DA, "M", "ϛ"),
+        (0x3DB, "V"),
+        (0x3DC, "M", "ϝ"),
+        (0x3DD, "V"),
+        (0x3DE, "M", "ϟ"),
+        (0x3DF, "V"),
+        (0x3E0, "M", "ϡ"),
+        (0x3E1, "V"),
+        (0x3E2, "M", "ϣ"),
+        (0x3E3, "V"),
+        (0x3E4, "M", "ϥ"),
+        (0x3E5, "V"),
+        (0x3E6, "M", "ϧ"),
+        (0x3E7, "V"),
+        (0x3E8, "M", "ϩ"),
+        (0x3E9, "V"),
+        (0x3EA, "M", "ϫ"),
+        (0x3EB, "V"),
+        (0x3EC, "M", "ϭ"),
+        (0x3ED, "V"),
+        (0x3EE, "M", "ϯ"),
+        (0x3EF, "V"),
+        (0x3F0, "M", "κ"),
+        (0x3F1, "M", "ρ"),
+        (0x3F2, "M", "σ"),
+        (0x3F3, "V"),
+        (0x3F4, "M", "θ"),
+        (0x3F5, "M", "ε"),
+        (0x3F6, "V"),
+        (0x3F7, "M", "ϸ"),
+        (0x3F8, "V"),
+        (0x3F9, "M", "σ"),
+        (0x3FA, "M", "ϻ"),
+        (0x3FB, "V"),
+        (0x3FD, "M", "ͻ"),
+        (0x3FE, "M", "ͼ"),
+        (0x3FF, "M", "ͽ"),
+        (0x400, "M", "ѐ"),
+        (0x401, "M", "ё"),
+        (0x402, "M", "ђ"),
     ]
 
+
 def _seg_7() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x403, 'M', 'ѓ'),
-    (0x404, 'M', 'є'),
-    (0x405, 'M', 'ѕ'),
-    (0x406, 'M', 'і'),
-    (0x407, 'M', 'ї'),
-    (0x408, 'M', 'ј'),
-    (0x409, 'M', 'љ'),
-    (0x40A, 'M', 'њ'),
-    (0x40B, 'M', 'ћ'),
-    (0x40C, 'M', 'ќ'),
-    (0x40D, 'M', 'ѝ'),
-    (0x40E, 'M', 'ў'),
-    (0x40F, 'M', 'џ'),
-    (0x410, 'M', 'а'),
-    (0x411, 'M', 'б'),
-    (0x412, 'M', 'в'),
-    (0x413, 'M', 'г'),
-    (0x414, 'M', 'д'),
-    (0x415, 'M', 'е'),
-    (0x416, 'M', 'ж'),
-    (0x417, 'M', 'з'),
-    (0x418, 'M', 'и'),
-    (0x419, 'M', 'й'),
-    (0x41A, 'M', 'к'),
-    (0x41B, 'M', 'л'),
-    (0x41C, 'M', 'м'),
-    (0x41D, 'M', 'н'),
-    (0x41E, 'M', 'о'),
-    (0x41F, 'M', 'п'),
-    (0x420, 'M', 'р'),
-    (0x421, 'M', 'с'),
-    (0x422, 'M', 'т'),
-    (0x423, 'M', 'у'),
-    (0x424, 'M', 'ф'),
-    (0x425, 'M', 'х'),
-    (0x426, 'M', 'ц'),
-    (0x427, 'M', 'ч'),
-    (0x428, 'M', 'ш'),
-    (0x429, 'M', 'щ'),
-    (0x42A, 'M', 'ъ'),
-    (0x42B, 'M', 'ы'),
-    (0x42C, 'M', 'ь'),
-    (0x42D, 'M', 'э'),
-    (0x42E, 'M', 'ю'),
-    (0x42F, 'M', 'я'),
-    (0x430, 'V'),
-    (0x460, 'M', 'ѡ'),
-    (0x461, 'V'),
-    (0x462, 'M', 'ѣ'),
-    (0x463, 'V'),
-    (0x464, 'M', 'ѥ'),
-    (0x465, 'V'),
-    (0x466, 'M', 'ѧ'),
-    (0x467, 'V'),
-    (0x468, 'M', 'ѩ'),
-    (0x469, 'V'),
-    (0x46A, 'M', 'ѫ'),
-    (0x46B, 'V'),
-    (0x46C, 'M', 'ѭ'),
-    (0x46D, 'V'),
-    (0x46E, 'M', 'ѯ'),
-    (0x46F, 'V'),
-    (0x470, 'M', 'ѱ'),
-    (0x471, 'V'),
-    (0x472, 'M', 'ѳ'),
-    (0x473, 'V'),
-    (0x474, 'M', 'ѵ'),
-    (0x475, 'V'),
-    (0x476, 'M', 'ѷ'),
-    (0x477, 'V'),
-    (0x478, 'M', 'ѹ'),
-    (0x479, 'V'),
-    (0x47A, 'M', 'ѻ'),
-    (0x47B, 'V'),
-    (0x47C, 'M', 'ѽ'),
-    (0x47D, 'V'),
-    (0x47E, 'M', 'ѿ'),
-    (0x47F, 'V'),
-    (0x480, 'M', 'ҁ'),
-    (0x481, 'V'),
-    (0x48A, 'M', 'ҋ'),
-    (0x48B, 'V'),
-    (0x48C, 'M', 'ҍ'),
-    (0x48D, 'V'),
-    (0x48E, 'M', 'ҏ'),
-    (0x48F, 'V'),
-    (0x490, 'M', 'ґ'),
-    (0x491, 'V'),
-    (0x492, 'M', 'ғ'),
-    (0x493, 'V'),
-    (0x494, 'M', 'ҕ'),
-    (0x495, 'V'),
-    (0x496, 'M', 'җ'),
-    (0x497, 'V'),
-    (0x498, 'M', 'ҙ'),
-    (0x499, 'V'),
-    (0x49A, 'M', 'қ'),
-    (0x49B, 'V'),
-    (0x49C, 'M', 'ҝ'),
-    (0x49D, 'V'),
+        (0x403, "M", "ѓ"),
+        (0x404, "M", "є"),
+        (0x405, "M", "ѕ"),
+        (0x406, "M", "і"),
+        (0x407, "M", "ї"),
+        (0x408, "M", "ј"),
+        (0x409, "M", "љ"),
+        (0x40A, "M", "њ"),
+        (0x40B, "M", "ћ"),
+        (0x40C, "M", "ќ"),
+        (0x40D, "M", "ѝ"),
+        (0x40E, "M", "ў"),
+        (0x40F, "M", "џ"),
+        (0x410, "M", "а"),
+        (0x411, "M", "б"),
+        (0x412, "M", "в"),
+        (0x413, "M", "г"),
+        (0x414, "M", "д"),
+        (0x415, "M", "е"),
+        (0x416, "M", "ж"),
+        (0x417, "M", "з"),
+        (0x418, "M", "и"),
+        (0x419, "M", "й"),
+        (0x41A, "M", "к"),
+        (0x41B, "M", "л"),
+        (0x41C, "M", "м"),
+        (0x41D, "M", "н"),
+        (0x41E, "M", "о"),
+        (0x41F, "M", "п"),
+        (0x420, "M", "р"),
+        (0x421, "M", "с"),
+        (0x422, "M", "т"),
+        (0x423, "M", "у"),
+        (0x424, "M", "ф"),
+        (0x425, "M", "х"),
+        (0x426, "M", "ц"),
+        (0x427, "M", "ч"),
+        (0x428, "M", "ш"),
+        (0x429, "M", "щ"),
+        (0x42A, "M", "ъ"),
+        (0x42B, "M", "ы"),
+        (0x42C, "M", "ь"),
+        (0x42D, "M", "э"),
+        (0x42E, "M", "ю"),
+        (0x42F, "M", "я"),
+        (0x430, "V"),
+        (0x460, "M", "ѡ"),
+        (0x461, "V"),
+        (0x462, "M", "ѣ"),
+        (0x463, "V"),
+        (0x464, "M", "ѥ"),
+        (0x465, "V"),
+        (0x466, "M", "ѧ"),
+        (0x467, "V"),
+        (0x468, "M", "ѩ"),
+        (0x469, "V"),
+        (0x46A, "M", "ѫ"),
+        (0x46B, "V"),
+        (0x46C, "M", "ѭ"),
+        (0x46D, "V"),
+        (0x46E, "M", "ѯ"),
+        (0x46F, "V"),
+        (0x470, "M", "ѱ"),
+        (0x471, "V"),
+        (0x472, "M", "ѳ"),
+        (0x473, "V"),
+        (0x474, "M", "ѵ"),
+        (0x475, "V"),
+        (0x476, "M", "ѷ"),
+        (0x477, "V"),
+        (0x478, "M", "ѹ"),
+        (0x479, "V"),
+        (0x47A, "M", "ѻ"),
+        (0x47B, "V"),
+        (0x47C, "M", "ѽ"),
+        (0x47D, "V"),
+        (0x47E, "M", "ѿ"),
+        (0x47F, "V"),
+        (0x480, "M", "ҁ"),
+        (0x481, "V"),
+        (0x48A, "M", "ҋ"),
+        (0x48B, "V"),
+        (0x48C, "M", "ҍ"),
+        (0x48D, "V"),
+        (0x48E, "M", "ҏ"),
+        (0x48F, "V"),
+        (0x490, "M", "ґ"),
+        (0x491, "V"),
+        (0x492, "M", "ғ"),
+        (0x493, "V"),
+        (0x494, "M", "ҕ"),
+        (0x495, "V"),
+        (0x496, "M", "җ"),
+        (0x497, "V"),
+        (0x498, "M", "ҙ"),
+        (0x499, "V"),
+        (0x49A, "M", "қ"),
+        (0x49B, "V"),
+        (0x49C, "M", "ҝ"),
+        (0x49D, "V"),
     ]
 
+
 def _seg_8() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x49E, 'M', 'ҟ'),
-    (0x49F, 'V'),
-    (0x4A0, 'M', 'ҡ'),
-    (0x4A1, 'V'),
-    (0x4A2, 'M', 'ң'),
-    (0x4A3, 'V'),
-    (0x4A4, 'M', 'ҥ'),
-    (0x4A5, 'V'),
-    (0x4A6, 'M', 'ҧ'),
-    (0x4A7, 'V'),
-    (0x4A8, 'M', 'ҩ'),
-    (0x4A9, 'V'),
-    (0x4AA, 'M', 'ҫ'),
-    (0x4AB, 'V'),
-    (0x4AC, 'M', 'ҭ'),
-    (0x4AD, 'V'),
-    (0x4AE, 'M', 'ү'),
-    (0x4AF, 'V'),
-    (0x4B0, 'M', 'ұ'),
-    (0x4B1, 'V'),
-    (0x4B2, 'M', 'ҳ'),
-    (0x4B3, 'V'),
-    (0x4B4, 'M', 'ҵ'),
-    (0x4B5, 'V'),
-    (0x4B6, 'M', 'ҷ'),
-    (0x4B7, 'V'),
-    (0x4B8, 'M', 'ҹ'),
-    (0x4B9, 'V'),
-    (0x4BA, 'M', 'һ'),
-    (0x4BB, 'V'),
-    (0x4BC, 'M', 'ҽ'),
-    (0x4BD, 'V'),
-    (0x4BE, 'M', 'ҿ'),
-    (0x4BF, 'V'),
-    (0x4C0, 'X'),
-    (0x4C1, 'M', 'ӂ'),
-    (0x4C2, 'V'),
-    (0x4C3, 'M', 'ӄ'),
-    (0x4C4, 'V'),
-    (0x4C5, 'M', 'ӆ'),
-    (0x4C6, 'V'),
-    (0x4C7, 'M', 'ӈ'),
-    (0x4C8, 'V'),
-    (0x4C9, 'M', 'ӊ'),
-    (0x4CA, 'V'),
-    (0x4CB, 'M', 'ӌ'),
-    (0x4CC, 'V'),
-    (0x4CD, 'M', 'ӎ'),
-    (0x4CE, 'V'),
-    (0x4D0, 'M', 'ӑ'),
-    (0x4D1, 'V'),
-    (0x4D2, 'M', 'ӓ'),
-    (0x4D3, 'V'),
-    (0x4D4, 'M', 'ӕ'),
-    (0x4D5, 'V'),
-    (0x4D6, 'M', 'ӗ'),
-    (0x4D7, 'V'),
-    (0x4D8, 'M', 'ә'),
-    (0x4D9, 'V'),
-    (0x4DA, 'M', 'ӛ'),
-    (0x4DB, 'V'),
-    (0x4DC, 'M', 'ӝ'),
-    (0x4DD, 'V'),
-    (0x4DE, 'M', 'ӟ'),
-    (0x4DF, 'V'),
-    (0x4E0, 'M', 'ӡ'),
-    (0x4E1, 'V'),
-    (0x4E2, 'M', 'ӣ'),
-    (0x4E3, 'V'),
-    (0x4E4, 'M', 'ӥ'),
-    (0x4E5, 'V'),
-    (0x4E6, 'M', 'ӧ'),
-    (0x4E7, 'V'),
-    (0x4E8, 'M', 'ө'),
-    (0x4E9, 'V'),
-    (0x4EA, 'M', 'ӫ'),
-    (0x4EB, 'V'),
-    (0x4EC, 'M', 'ӭ'),
-    (0x4ED, 'V'),
-    (0x4EE, 'M', 'ӯ'),
-    (0x4EF, 'V'),
-    (0x4F0, 'M', 'ӱ'),
-    (0x4F1, 'V'),
-    (0x4F2, 'M', 'ӳ'),
-    (0x4F3, 'V'),
-    (0x4F4, 'M', 'ӵ'),
-    (0x4F5, 'V'),
-    (0x4F6, 'M', 'ӷ'),
-    (0x4F7, 'V'),
-    (0x4F8, 'M', 'ӹ'),
-    (0x4F9, 'V'),
-    (0x4FA, 'M', 'ӻ'),
-    (0x4FB, 'V'),
-    (0x4FC, 'M', 'ӽ'),
-    (0x4FD, 'V'),
-    (0x4FE, 'M', 'ӿ'),
-    (0x4FF, 'V'),
-    (0x500, 'M', 'ԁ'),
-    (0x501, 'V'),
-    (0x502, 'M', 'ԃ'),
+        (0x49E, "M", "ҟ"),
+        (0x49F, "V"),
+        (0x4A0, "M", "ҡ"),
+        (0x4A1, "V"),
+        (0x4A2, "M", "ң"),
+        (0x4A3, "V"),
+        (0x4A4, "M", "ҥ"),
+        (0x4A5, "V"),
+        (0x4A6, "M", "ҧ"),
+        (0x4A7, "V"),
+        (0x4A8, "M", "ҩ"),
+        (0x4A9, "V"),
+        (0x4AA, "M", "ҫ"),
+        (0x4AB, "V"),
+        (0x4AC, "M", "ҭ"),
+        (0x4AD, "V"),
+        (0x4AE, "M", "ү"),
+        (0x4AF, "V"),
+        (0x4B0, "M", "ұ"),
+        (0x4B1, "V"),
+        (0x4B2, "M", "ҳ"),
+        (0x4B3, "V"),
+        (0x4B4, "M", "ҵ"),
+        (0x4B5, "V"),
+        (0x4B6, "M", "ҷ"),
+        (0x4B7, "V"),
+        (0x4B8, "M", "ҹ"),
+        (0x4B9, "V"),
+        (0x4BA, "M", "һ"),
+        (0x4BB, "V"),
+        (0x4BC, "M", "ҽ"),
+        (0x4BD, "V"),
+        (0x4BE, "M", "ҿ"),
+        (0x4BF, "V"),
+        (0x4C0, "X"),
+        (0x4C1, "M", "ӂ"),
+        (0x4C2, "V"),
+        (0x4C3, "M", "ӄ"),
+        (0x4C4, "V"),
+        (0x4C5, "M", "ӆ"),
+        (0x4C6, "V"),
+        (0x4C7, "M", "ӈ"),
+        (0x4C8, "V"),
+        (0x4C9, "M", "ӊ"),
+        (0x4CA, "V"),
+        (0x4CB, "M", "ӌ"),
+        (0x4CC, "V"),
+        (0x4CD, "M", "ӎ"),
+        (0x4CE, "V"),
+        (0x4D0, "M", "ӑ"),
+        (0x4D1, "V"),
+        (0x4D2, "M", "ӓ"),
+        (0x4D3, "V"),
+        (0x4D4, "M", "ӕ"),
+        (0x4D5, "V"),
+        (0x4D6, "M", "ӗ"),
+        (0x4D7, "V"),
+        (0x4D8, "M", "ә"),
+        (0x4D9, "V"),
+        (0x4DA, "M", "ӛ"),
+        (0x4DB, "V"),
+        (0x4DC, "M", "ӝ"),
+        (0x4DD, "V"),
+        (0x4DE, "M", "ӟ"),
+        (0x4DF, "V"),
+        (0x4E0, "M", "ӡ"),
+        (0x4E1, "V"),
+        (0x4E2, "M", "ӣ"),
+        (0x4E3, "V"),
+        (0x4E4, "M", "ӥ"),
+        (0x4E5, "V"),
+        (0x4E6, "M", "ӧ"),
+        (0x4E7, "V"),
+        (0x4E8, "M", "ө"),
+        (0x4E9, "V"),
+        (0x4EA, "M", "ӫ"),
+        (0x4EB, "V"),
+        (0x4EC, "M", "ӭ"),
+        (0x4ED, "V"),
+        (0x4EE, "M", "ӯ"),
+        (0x4EF, "V"),
+        (0x4F0, "M", "ӱ"),
+        (0x4F1, "V"),
+        (0x4F2, "M", "ӳ"),
+        (0x4F3, "V"),
+        (0x4F4, "M", "ӵ"),
+        (0x4F5, "V"),
+        (0x4F6, "M", "ӷ"),
+        (0x4F7, "V"),
+        (0x4F8, "M", "ӹ"),
+        (0x4F9, "V"),
+        (0x4FA, "M", "ӻ"),
+        (0x4FB, "V"),
+        (0x4FC, "M", "ӽ"),
+        (0x4FD, "V"),
+        (0x4FE, "M", "ӿ"),
+        (0x4FF, "V"),
+        (0x500, "M", "ԁ"),
+        (0x501, "V"),
+        (0x502, "M", "ԃ"),
     ]
 
+
 def _seg_9() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x503, 'V'),
-    (0x504, 'M', 'ԅ'),
-    (0x505, 'V'),
-    (0x506, 'M', 'ԇ'),
-    (0x507, 'V'),
-    (0x508, 'M', 'ԉ'),
-    (0x509, 'V'),
-    (0x50A, 'M', 'ԋ'),
-    (0x50B, 'V'),
-    (0x50C, 'M', 'ԍ'),
-    (0x50D, 'V'),
-    (0x50E, 'M', 'ԏ'),
-    (0x50F, 'V'),
-    (0x510, 'M', 'ԑ'),
-    (0x511, 'V'),
-    (0x512, 'M', 'ԓ'),
-    (0x513, 'V'),
-    (0x514, 'M', 'ԕ'),
-    (0x515, 'V'),
-    (0x516, 'M', 'ԗ'),
-    (0x517, 'V'),
-    (0x518, 'M', 'ԙ'),
-    (0x519, 'V'),
-    (0x51A, 'M', 'ԛ'),
-    (0x51B, 'V'),
-    (0x51C, 'M', 'ԝ'),
-    (0x51D, 'V'),
-    (0x51E, 'M', 'ԟ'),
-    (0x51F, 'V'),
-    (0x520, 'M', 'ԡ'),
-    (0x521, 'V'),
-    (0x522, 'M', 'ԣ'),
-    (0x523, 'V'),
-    (0x524, 'M', 'ԥ'),
-    (0x525, 'V'),
-    (0x526, 'M', 'ԧ'),
-    (0x527, 'V'),
-    (0x528, 'M', 'ԩ'),
-    (0x529, 'V'),
-    (0x52A, 'M', 'ԫ'),
-    (0x52B, 'V'),
-    (0x52C, 'M', 'ԭ'),
-    (0x52D, 'V'),
-    (0x52E, 'M', 'ԯ'),
-    (0x52F, 'V'),
-    (0x530, 'X'),
-    (0x531, 'M', 'ա'),
-    (0x532, 'M', 'բ'),
-    (0x533, 'M', 'գ'),
-    (0x534, 'M', 'դ'),
-    (0x535, 'M', 'ե'),
-    (0x536, 'M', 'զ'),
-    (0x537, 'M', 'է'),
-    (0x538, 'M', 'ը'),
-    (0x539, 'M', 'թ'),
-    (0x53A, 'M', 'ժ'),
-    (0x53B, 'M', 'ի'),
-    (0x53C, 'M', 'լ'),
-    (0x53D, 'M', 'խ'),
-    (0x53E, 'M', 'ծ'),
-    (0x53F, 'M', 'կ'),
-    (0x540, 'M', 'հ'),
-    (0x541, 'M', 'ձ'),
-    (0x542, 'M', 'ղ'),
-    (0x543, 'M', 'ճ'),
-    (0x544, 'M', 'մ'),
-    (0x545, 'M', 'յ'),
-    (0x546, 'M', 'ն'),
-    (0x547, 'M', 'շ'),
-    (0x548, 'M', 'ո'),
-    (0x549, 'M', 'չ'),
-    (0x54A, 'M', 'պ'),
-    (0x54B, 'M', 'ջ'),
-    (0x54C, 'M', 'ռ'),
-    (0x54D, 'M', 'ս'),
-    (0x54E, 'M', 'վ'),
-    (0x54F, 'M', 'տ'),
-    (0x550, 'M', 'ր'),
-    (0x551, 'M', 'ց'),
-    (0x552, 'M', 'ւ'),
-    (0x553, 'M', 'փ'),
-    (0x554, 'M', 'ք'),
-    (0x555, 'M', 'օ'),
-    (0x556, 'M', 'ֆ'),
-    (0x557, 'X'),
-    (0x559, 'V'),
-    (0x587, 'M', 'եւ'),
-    (0x588, 'V'),
-    (0x58B, 'X'),
-    (0x58D, 'V'),
-    (0x590, 'X'),
-    (0x591, 'V'),
-    (0x5C8, 'X'),
-    (0x5D0, 'V'),
-    (0x5EB, 'X'),
-    (0x5EF, 'V'),
-    (0x5F5, 'X'),
-    (0x606, 'V'),
-    (0x61C, 'X'),
-    (0x61D, 'V'),
+        (0x503, "V"),
+        (0x504, "M", "ԅ"),
+        (0x505, "V"),
+        (0x506, "M", "ԇ"),
+        (0x507, "V"),
+        (0x508, "M", "ԉ"),
+        (0x509, "V"),
+        (0x50A, "M", "ԋ"),
+        (0x50B, "V"),
+        (0x50C, "M", "ԍ"),
+        (0x50D, "V"),
+        (0x50E, "M", "ԏ"),
+        (0x50F, "V"),
+        (0x510, "M", "ԑ"),
+        (0x511, "V"),
+        (0x512, "M", "ԓ"),
+        (0x513, "V"),
+        (0x514, "M", "ԕ"),
+        (0x515, "V"),
+        (0x516, "M", "ԗ"),
+        (0x517, "V"),
+        (0x518, "M", "ԙ"),
+        (0x519, "V"),
+        (0x51A, "M", "ԛ"),
+        (0x51B, "V"),
+        (0x51C, "M", "ԝ"),
+        (0x51D, "V"),
+        (0x51E, "M", "ԟ"),
+        (0x51F, "V"),
+        (0x520, "M", "ԡ"),
+        (0x521, "V"),
+        (0x522, "M", "ԣ"),
+        (0x523, "V"),
+        (0x524, "M", "ԥ"),
+        (0x525, "V"),
+        (0x526, "M", "ԧ"),
+        (0x527, "V"),
+        (0x528, "M", "ԩ"),
+        (0x529, "V"),
+        (0x52A, "M", "ԫ"),
+        (0x52B, "V"),
+        (0x52C, "M", "ԭ"),
+        (0x52D, "V"),
+        (0x52E, "M", "ԯ"),
+        (0x52F, "V"),
+        (0x530, "X"),
+        (0x531, "M", "ա"),
+        (0x532, "M", "բ"),
+        (0x533, "M", "գ"),
+        (0x534, "M", "դ"),
+        (0x535, "M", "ե"),
+        (0x536, "M", "զ"),
+        (0x537, "M", "է"),
+        (0x538, "M", "ը"),
+        (0x539, "M", "թ"),
+        (0x53A, "M", "ժ"),
+        (0x53B, "M", "ի"),
+        (0x53C, "M", "լ"),
+        (0x53D, "M", "խ"),
+        (0x53E, "M", "ծ"),
+        (0x53F, "M", "կ"),
+        (0x540, "M", "հ"),
+        (0x541, "M", "ձ"),
+        (0x542, "M", "ղ"),
+        (0x543, "M", "ճ"),
+        (0x544, "M", "մ"),
+        (0x545, "M", "յ"),
+        (0x546, "M", "ն"),
+        (0x547, "M", "շ"),
+        (0x548, "M", "ո"),
+        (0x549, "M", "չ"),
+        (0x54A, "M", "պ"),
+        (0x54B, "M", "ջ"),
+        (0x54C, "M", "ռ"),
+        (0x54D, "M", "ս"),
+        (0x54E, "M", "վ"),
+        (0x54F, "M", "տ"),
+        (0x550, "M", "ր"),
+        (0x551, "M", "ց"),
+        (0x552, "M", "ւ"),
+        (0x553, "M", "փ"),
+        (0x554, "M", "ք"),
+        (0x555, "M", "օ"),
+        (0x556, "M", "ֆ"),
+        (0x557, "X"),
+        (0x559, "V"),
+        (0x587, "M", "եւ"),
+        (0x588, "V"),
+        (0x58B, "X"),
+        (0x58D, "V"),
+        (0x590, "X"),
+        (0x591, "V"),
+        (0x5C8, "X"),
+        (0x5D0, "V"),
+        (0x5EB, "X"),
+        (0x5EF, "V"),
+        (0x5F5, "X"),
+        (0x606, "V"),
+        (0x61C, "X"),
+        (0x61D, "V"),
     ]
 
+
 def _seg_10() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x675, 'M', 'اٴ'),
-    (0x676, 'M', 'وٴ'),
-    (0x677, 'M', 'ۇٴ'),
-    (0x678, 'M', 'يٴ'),
-    (0x679, 'V'),
-    (0x6DD, 'X'),
-    (0x6DE, 'V'),
-    (0x70E, 'X'),
-    (0x710, 'V'),
-    (0x74B, 'X'),
-    (0x74D, 'V'),
-    (0x7B2, 'X'),
-    (0x7C0, 'V'),
-    (0x7FB, 'X'),
-    (0x7FD, 'V'),
-    (0x82E, 'X'),
-    (0x830, 'V'),
-    (0x83F, 'X'),
-    (0x840, 'V'),
-    (0x85C, 'X'),
-    (0x85E, 'V'),
-    (0x85F, 'X'),
-    (0x860, 'V'),
-    (0x86B, 'X'),
-    (0x870, 'V'),
-    (0x88F, 'X'),
-    (0x898, 'V'),
-    (0x8E2, 'X'),
-    (0x8E3, 'V'),
-    (0x958, 'M', 'क़'),
-    (0x959, 'M', 'ख़'),
-    (0x95A, 'M', 'ग़'),
-    (0x95B, 'M', 'ज़'),
-    (0x95C, 'M', 'ड़'),
-    (0x95D, 'M', 'ढ़'),
-    (0x95E, 'M', 'फ़'),
-    (0x95F, 'M', 'य़'),
-    (0x960, 'V'),
-    (0x984, 'X'),
-    (0x985, 'V'),
-    (0x98D, 'X'),
-    (0x98F, 'V'),
-    (0x991, 'X'),
-    (0x993, 'V'),
-    (0x9A9, 'X'),
-    (0x9AA, 'V'),
-    (0x9B1, 'X'),
-    (0x9B2, 'V'),
-    (0x9B3, 'X'),
-    (0x9B6, 'V'),
-    (0x9BA, 'X'),
-    (0x9BC, 'V'),
-    (0x9C5, 'X'),
-    (0x9C7, 'V'),
-    (0x9C9, 'X'),
-    (0x9CB, 'V'),
-    (0x9CF, 'X'),
-    (0x9D7, 'V'),
-    (0x9D8, 'X'),
-    (0x9DC, 'M', 'ড়'),
-    (0x9DD, 'M', 'ঢ়'),
-    (0x9DE, 'X'),
-    (0x9DF, 'M', 'য়'),
-    (0x9E0, 'V'),
-    (0x9E4, 'X'),
-    (0x9E6, 'V'),
-    (0x9FF, 'X'),
-    (0xA01, 'V'),
-    (0xA04, 'X'),
-    (0xA05, 'V'),
-    (0xA0B, 'X'),
-    (0xA0F, 'V'),
-    (0xA11, 'X'),
-    (0xA13, 'V'),
-    (0xA29, 'X'),
-    (0xA2A, 'V'),
-    (0xA31, 'X'),
-    (0xA32, 'V'),
-    (0xA33, 'M', 'ਲ਼'),
-    (0xA34, 'X'),
-    (0xA35, 'V'),
-    (0xA36, 'M', 'ਸ਼'),
-    (0xA37, 'X'),
-    (0xA38, 'V'),
-    (0xA3A, 'X'),
-    (0xA3C, 'V'),
-    (0xA3D, 'X'),
-    (0xA3E, 'V'),
-    (0xA43, 'X'),
-    (0xA47, 'V'),
-    (0xA49, 'X'),
-    (0xA4B, 'V'),
-    (0xA4E, 'X'),
-    (0xA51, 'V'),
-    (0xA52, 'X'),
-    (0xA59, 'M', 'ਖ਼'),
-    (0xA5A, 'M', 'ਗ਼'),
-    (0xA5B, 'M', 'ਜ਼'),
-    (0xA5C, 'V'),
-    (0xA5D, 'X'),
+        (0x675, "M", "اٴ"),
+        (0x676, "M", "وٴ"),
+        (0x677, "M", "ۇٴ"),
+        (0x678, "M", "يٴ"),
+        (0x679, "V"),
+        (0x6DD, "X"),
+        (0x6DE, "V"),
+        (0x70E, "X"),
+        (0x710, "V"),
+        (0x74B, "X"),
+        (0x74D, "V"),
+        (0x7B2, "X"),
+        (0x7C0, "V"),
+        (0x7FB, "X"),
+        (0x7FD, "V"),
+        (0x82E, "X"),
+        (0x830, "V"),
+        (0x83F, "X"),
+        (0x840, "V"),
+        (0x85C, "X"),
+        (0x85E, "V"),
+        (0x85F, "X"),
+        (0x860, "V"),
+        (0x86B, "X"),
+        (0x870, "V"),
+        (0x88F, "X"),
+        (0x898, "V"),
+        (0x8E2, "X"),
+        (0x8E3, "V"),
+        (0x958, "M", "क़"),
+        (0x959, "M", "ख़"),
+        (0x95A, "M", "ग़"),
+        (0x95B, "M", "ज़"),
+        (0x95C, "M", "ड़"),
+        (0x95D, "M", "ढ़"),
+        (0x95E, "M", "फ़"),
+        (0x95F, "M", "य़"),
+        (0x960, "V"),
+        (0x984, "X"),
+        (0x985, "V"),
+        (0x98D, "X"),
+        (0x98F, "V"),
+        (0x991, "X"),
+        (0x993, "V"),
+        (0x9A9, "X"),
+        (0x9AA, "V"),
+        (0x9B1, "X"),
+        (0x9B2, "V"),
+        (0x9B3, "X"),
+        (0x9B6, "V"),
+        (0x9BA, "X"),
+        (0x9BC, "V"),
+        (0x9C5, "X"),
+        (0x9C7, "V"),
+        (0x9C9, "X"),
+        (0x9CB, "V"),
+        (0x9CF, "X"),
+        (0x9D7, "V"),
+        (0x9D8, "X"),
+        (0x9DC, "M", "ড়"),
+        (0x9DD, "M", "ঢ়"),
+        (0x9DE, "X"),
+        (0x9DF, "M", "য়"),
+        (0x9E0, "V"),
+        (0x9E4, "X"),
+        (0x9E6, "V"),
+        (0x9FF, "X"),
+        (0xA01, "V"),
+        (0xA04, "X"),
+        (0xA05, "V"),
+        (0xA0B, "X"),
+        (0xA0F, "V"),
+        (0xA11, "X"),
+        (0xA13, "V"),
+        (0xA29, "X"),
+        (0xA2A, "V"),
+        (0xA31, "X"),
+        (0xA32, "V"),
+        (0xA33, "M", "ਲ਼"),
+        (0xA34, "X"),
+        (0xA35, "V"),
+        (0xA36, "M", "ਸ਼"),
+        (0xA37, "X"),
+        (0xA38, "V"),
+        (0xA3A, "X"),
+        (0xA3C, "V"),
+        (0xA3D, "X"),
+        (0xA3E, "V"),
+        (0xA43, "X"),
+        (0xA47, "V"),
+        (0xA49, "X"),
+        (0xA4B, "V"),
+        (0xA4E, "X"),
+        (0xA51, "V"),
+        (0xA52, "X"),
+        (0xA59, "M", "ਖ਼"),
+        (0xA5A, "M", "ਗ਼"),
+        (0xA5B, "M", "ਜ਼"),
+        (0xA5C, "V"),
+        (0xA5D, "X"),
     ]
 
+
 def _seg_11() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0xA5E, 'M', 'ਫ਼'),
-    (0xA5F, 'X'),
-    (0xA66, 'V'),
-    (0xA77, 'X'),
-    (0xA81, 'V'),
-    (0xA84, 'X'),
-    (0xA85, 'V'),
-    (0xA8E, 'X'),
-    (0xA8F, 'V'),
-    (0xA92, 'X'),
-    (0xA93, 'V'),
-    (0xAA9, 'X'),
-    (0xAAA, 'V'),
-    (0xAB1, 'X'),
-    (0xAB2, 'V'),
-    (0xAB4, 'X'),
-    (0xAB5, 'V'),
-    (0xABA, 'X'),
-    (0xABC, 'V'),
-    (0xAC6, 'X'),
-    (0xAC7, 'V'),
-    (0xACA, 'X'),
-    (0xACB, 'V'),
-    (0xACE, 'X'),
-    (0xAD0, 'V'),
-    (0xAD1, 'X'),
-    (0xAE0, 'V'),
-    (0xAE4, 'X'),
-    (0xAE6, 'V'),
-    (0xAF2, 'X'),
-    (0xAF9, 'V'),
-    (0xB00, 'X'),
-    (0xB01, 'V'),
-    (0xB04, 'X'),
-    (0xB05, 'V'),
-    (0xB0D, 'X'),
-    (0xB0F, 'V'),
-    (0xB11, 'X'),
-    (0xB13, 'V'),
-    (0xB29, 'X'),
-    (0xB2A, 'V'),
-    (0xB31, 'X'),
-    (0xB32, 'V'),
-    (0xB34, 'X'),
-    (0xB35, 'V'),
-    (0xB3A, 'X'),
-    (0xB3C, 'V'),
-    (0xB45, 'X'),
-    (0xB47, 'V'),
-    (0xB49, 'X'),
-    (0xB4B, 'V'),
-    (0xB4E, 'X'),
-    (0xB55, 'V'),
-    (0xB58, 'X'),
-    (0xB5C, 'M', 'ଡ଼'),
-    (0xB5D, 'M', 'ଢ଼'),
-    (0xB5E, 'X'),
-    (0xB5F, 'V'),
-    (0xB64, 'X'),
-    (0xB66, 'V'),
-    (0xB78, 'X'),
-    (0xB82, 'V'),
-    (0xB84, 'X'),
-    (0xB85, 'V'),
-    (0xB8B, 'X'),
-    (0xB8E, 'V'),
-    (0xB91, 'X'),
-    (0xB92, 'V'),
-    (0xB96, 'X'),
-    (0xB99, 'V'),
-    (0xB9B, 'X'),
-    (0xB9C, 'V'),
-    (0xB9D, 'X'),
-    (0xB9E, 'V'),
-    (0xBA0, 'X'),
-    (0xBA3, 'V'),
-    (0xBA5, 'X'),
-    (0xBA8, 'V'),
-    (0xBAB, 'X'),
-    (0xBAE, 'V'),
-    (0xBBA, 'X'),
-    (0xBBE, 'V'),
-    (0xBC3, 'X'),
-    (0xBC6, 'V'),
-    (0xBC9, 'X'),
-    (0xBCA, 'V'),
-    (0xBCE, 'X'),
-    (0xBD0, 'V'),
-    (0xBD1, 'X'),
-    (0xBD7, 'V'),
-    (0xBD8, 'X'),
-    (0xBE6, 'V'),
-    (0xBFB, 'X'),
-    (0xC00, 'V'),
-    (0xC0D, 'X'),
-    (0xC0E, 'V'),
-    (0xC11, 'X'),
-    (0xC12, 'V'),
-    (0xC29, 'X'),
-    (0xC2A, 'V'),
+        (0xA5E, "M", "ਫ਼"),
+        (0xA5F, "X"),
+        (0xA66, "V"),
+        (0xA77, "X"),
+        (0xA81, "V"),
+        (0xA84, "X"),
+        (0xA85, "V"),
+        (0xA8E, "X"),
+        (0xA8F, "V"),
+        (0xA92, "X"),
+        (0xA93, "V"),
+        (0xAA9, "X"),
+        (0xAAA, "V"),
+        (0xAB1, "X"),
+        (0xAB2, "V"),
+        (0xAB4, "X"),
+        (0xAB5, "V"),
+        (0xABA, "X"),
+        (0xABC, "V"),
+        (0xAC6, "X"),
+        (0xAC7, "V"),
+        (0xACA, "X"),
+        (0xACB, "V"),
+        (0xACE, "X"),
+        (0xAD0, "V"),
+        (0xAD1, "X"),
+        (0xAE0, "V"),
+        (0xAE4, "X"),
+        (0xAE6, "V"),
+        (0xAF2, "X"),
+        (0xAF9, "V"),
+        (0xB00, "X"),
+        (0xB01, "V"),
+        (0xB04, "X"),
+        (0xB05, "V"),
+        (0xB0D, "X"),
+        (0xB0F, "V"),
+        (0xB11, "X"),
+        (0xB13, "V"),
+        (0xB29, "X"),
+        (0xB2A, "V"),
+        (0xB31, "X"),
+        (0xB32, "V"),
+        (0xB34, "X"),
+        (0xB35, "V"),
+        (0xB3A, "X"),
+        (0xB3C, "V"),
+        (0xB45, "X"),
+        (0xB47, "V"),
+        (0xB49, "X"),
+        (0xB4B, "V"),
+        (0xB4E, "X"),
+        (0xB55, "V"),
+        (0xB58, "X"),
+        (0xB5C, "M", "ଡ଼"),
+        (0xB5D, "M", "ଢ଼"),
+        (0xB5E, "X"),
+        (0xB5F, "V"),
+        (0xB64, "X"),
+        (0xB66, "V"),
+        (0xB78, "X"),
+        (0xB82, "V"),
+        (0xB84, "X"),
+        (0xB85, "V"),
+        (0xB8B, "X"),
+        (0xB8E, "V"),
+        (0xB91, "X"),
+        (0xB92, "V"),
+        (0xB96, "X"),
+        (0xB99, "V"),
+        (0xB9B, "X"),
+        (0xB9C, "V"),
+        (0xB9D, "X"),
+        (0xB9E, "V"),
+        (0xBA0, "X"),
+        (0xBA3, "V"),
+        (0xBA5, "X"),
+        (0xBA8, "V"),
+        (0xBAB, "X"),
+        (0xBAE, "V"),
+        (0xBBA, "X"),
+        (0xBBE, "V"),
+        (0xBC3, "X"),
+        (0xBC6, "V"),
+        (0xBC9, "X"),
+        (0xBCA, "V"),
+        (0xBCE, "X"),
+        (0xBD0, "V"),
+        (0xBD1, "X"),
+        (0xBD7, "V"),
+        (0xBD8, "X"),
+        (0xBE6, "V"),
+        (0xBFB, "X"),
+        (0xC00, "V"),
+        (0xC0D, "X"),
+        (0xC0E, "V"),
+        (0xC11, "X"),
+        (0xC12, "V"),
+        (0xC29, "X"),
+        (0xC2A, "V"),
     ]
 
+
 def _seg_12() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0xC3A, 'X'),
-    (0xC3C, 'V'),
-    (0xC45, 'X'),
-    (0xC46, 'V'),
-    (0xC49, 'X'),
-    (0xC4A, 'V'),
-    (0xC4E, 'X'),
-    (0xC55, 'V'),
-    (0xC57, 'X'),
-    (0xC58, 'V'),
-    (0xC5B, 'X'),
-    (0xC5D, 'V'),
-    (0xC5E, 'X'),
-    (0xC60, 'V'),
-    (0xC64, 'X'),
-    (0xC66, 'V'),
-    (0xC70, 'X'),
-    (0xC77, 'V'),
-    (0xC8D, 'X'),
-    (0xC8E, 'V'),
-    (0xC91, 'X'),
-    (0xC92, 'V'),
-    (0xCA9, 'X'),
-    (0xCAA, 'V'),
-    (0xCB4, 'X'),
-    (0xCB5, 'V'),
-    (0xCBA, 'X'),
-    (0xCBC, 'V'),
-    (0xCC5, 'X'),
-    (0xCC6, 'V'),
-    (0xCC9, 'X'),
-    (0xCCA, 'V'),
-    (0xCCE, 'X'),
-    (0xCD5, 'V'),
-    (0xCD7, 'X'),
-    (0xCDD, 'V'),
-    (0xCDF, 'X'),
-    (0xCE0, 'V'),
-    (0xCE4, 'X'),
-    (0xCE6, 'V'),
-    (0xCF0, 'X'),
-    (0xCF1, 'V'),
-    (0xCF4, 'X'),
-    (0xD00, 'V'),
-    (0xD0D, 'X'),
-    (0xD0E, 'V'),
-    (0xD11, 'X'),
-    (0xD12, 'V'),
-    (0xD45, 'X'),
-    (0xD46, 'V'),
-    (0xD49, 'X'),
-    (0xD4A, 'V'),
-    (0xD50, 'X'),
-    (0xD54, 'V'),
-    (0xD64, 'X'),
-    (0xD66, 'V'),
-    (0xD80, 'X'),
-    (0xD81, 'V'),
-    (0xD84, 'X'),
-    (0xD85, 'V'),
-    (0xD97, 'X'),
-    (0xD9A, 'V'),
-    (0xDB2, 'X'),
-    (0xDB3, 'V'),
-    (0xDBC, 'X'),
-    (0xDBD, 'V'),
-    (0xDBE, 'X'),
-    (0xDC0, 'V'),
-    (0xDC7, 'X'),
-    (0xDCA, 'V'),
-    (0xDCB, 'X'),
-    (0xDCF, 'V'),
-    (0xDD5, 'X'),
-    (0xDD6, 'V'),
-    (0xDD7, 'X'),
-    (0xDD8, 'V'),
-    (0xDE0, 'X'),
-    (0xDE6, 'V'),
-    (0xDF0, 'X'),
-    (0xDF2, 'V'),
-    (0xDF5, 'X'),
-    (0xE01, 'V'),
-    (0xE33, 'M', 'ํา'),
-    (0xE34, 'V'),
-    (0xE3B, 'X'),
-    (0xE3F, 'V'),
-    (0xE5C, 'X'),
-    (0xE81, 'V'),
-    (0xE83, 'X'),
-    (0xE84, 'V'),
-    (0xE85, 'X'),
-    (0xE86, 'V'),
-    (0xE8B, 'X'),
-    (0xE8C, 'V'),
-    (0xEA4, 'X'),
-    (0xEA5, 'V'),
-    (0xEA6, 'X'),
-    (0xEA7, 'V'),
-    (0xEB3, 'M', 'ໍາ'),
-    (0xEB4, 'V'),
+        (0xC3A, "X"),
+        (0xC3C, "V"),
+        (0xC45, "X"),
+        (0xC46, "V"),
+        (0xC49, "X"),
+        (0xC4A, "V"),
+        (0xC4E, "X"),
+        (0xC55, "V"),
+        (0xC57, "X"),
+        (0xC58, "V"),
+        (0xC5B, "X"),
+        (0xC5D, "V"),
+        (0xC5E, "X"),
+        (0xC60, "V"),
+        (0xC64, "X"),
+        (0xC66, "V"),
+        (0xC70, "X"),
+        (0xC77, "V"),
+        (0xC8D, "X"),
+        (0xC8E, "V"),
+        (0xC91, "X"),
+        (0xC92, "V"),
+        (0xCA9, "X"),
+        (0xCAA, "V"),
+        (0xCB4, "X"),
+        (0xCB5, "V"),
+        (0xCBA, "X"),
+        (0xCBC, "V"),
+        (0xCC5, "X"),
+        (0xCC6, "V"),
+        (0xCC9, "X"),
+        (0xCCA, "V"),
+        (0xCCE, "X"),
+        (0xCD5, "V"),
+        (0xCD7, "X"),
+        (0xCDD, "V"),
+        (0xCDF, "X"),
+        (0xCE0, "V"),
+        (0xCE4, "X"),
+        (0xCE6, "V"),
+        (0xCF0, "X"),
+        (0xCF1, "V"),
+        (0xCF4, "X"),
+        (0xD00, "V"),
+        (0xD0D, "X"),
+        (0xD0E, "V"),
+        (0xD11, "X"),
+        (0xD12, "V"),
+        (0xD45, "X"),
+        (0xD46, "V"),
+        (0xD49, "X"),
+        (0xD4A, "V"),
+        (0xD50, "X"),
+        (0xD54, "V"),
+        (0xD64, "X"),
+        (0xD66, "V"),
+        (0xD80, "X"),
+        (0xD81, "V"),
+        (0xD84, "X"),
+        (0xD85, "V"),
+        (0xD97, "X"),
+        (0xD9A, "V"),
+        (0xDB2, "X"),
+        (0xDB3, "V"),
+        (0xDBC, "X"),
+        (0xDBD, "V"),
+        (0xDBE, "X"),
+        (0xDC0, "V"),
+        (0xDC7, "X"),
+        (0xDCA, "V"),
+        (0xDCB, "X"),
+        (0xDCF, "V"),
+        (0xDD5, "X"),
+        (0xDD6, "V"),
+        (0xDD7, "X"),
+        (0xDD8, "V"),
+        (0xDE0, "X"),
+        (0xDE6, "V"),
+        (0xDF0, "X"),
+        (0xDF2, "V"),
+        (0xDF5, "X"),
+        (0xE01, "V"),
+        (0xE33, "M", "ํา"),
+        (0xE34, "V"),
+        (0xE3B, "X"),
+        (0xE3F, "V"),
+        (0xE5C, "X"),
+        (0xE81, "V"),
+        (0xE83, "X"),
+        (0xE84, "V"),
+        (0xE85, "X"),
+        (0xE86, "V"),
+        (0xE8B, "X"),
+        (0xE8C, "V"),
+        (0xEA4, "X"),
+        (0xEA5, "V"),
+        (0xEA6, "X"),
+        (0xEA7, "V"),
+        (0xEB3, "M", "ໍາ"),
+        (0xEB4, "V"),
     ]
 
+
 def _seg_13() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0xEBE, 'X'),
-    (0xEC0, 'V'),
-    (0xEC5, 'X'),
-    (0xEC6, 'V'),
-    (0xEC7, 'X'),
-    (0xEC8, 'V'),
-    (0xECF, 'X'),
-    (0xED0, 'V'),
-    (0xEDA, 'X'),
-    (0xEDC, 'M', 'ຫນ'),
-    (0xEDD, 'M', 'ຫມ'),
-    (0xEDE, 'V'),
-    (0xEE0, 'X'),
-    (0xF00, 'V'),
-    (0xF0C, 'M', '་'),
-    (0xF0D, 'V'),
-    (0xF43, 'M', 'གྷ'),
-    (0xF44, 'V'),
-    (0xF48, 'X'),
-    (0xF49, 'V'),
-    (0xF4D, 'M', 'ཌྷ'),
-    (0xF4E, 'V'),
-    (0xF52, 'M', 'དྷ'),
-    (0xF53, 'V'),
-    (0xF57, 'M', 'བྷ'),
-    (0xF58, 'V'),
-    (0xF5C, 'M', 'ཛྷ'),
-    (0xF5D, 'V'),
-    (0xF69, 'M', 'ཀྵ'),
-    (0xF6A, 'V'),
-    (0xF6D, 'X'),
-    (0xF71, 'V'),
-    (0xF73, 'M', 'ཱི'),
-    (0xF74, 'V'),
-    (0xF75, 'M', 'ཱུ'),
-    (0xF76, 'M', 'ྲྀ'),
-    (0xF77, 'M', 'ྲཱྀ'),
-    (0xF78, 'M', 'ླྀ'),
-    (0xF79, 'M', 'ླཱྀ'),
-    (0xF7A, 'V'),
-    (0xF81, 'M', 'ཱྀ'),
-    (0xF82, 'V'),
-    (0xF93, 'M', 'ྒྷ'),
-    (0xF94, 'V'),
-    (0xF98, 'X'),
-    (0xF99, 'V'),
-    (0xF9D, 'M', 'ྜྷ'),
-    (0xF9E, 'V'),
-    (0xFA2, 'M', 'ྡྷ'),
-    (0xFA3, 'V'),
-    (0xFA7, 'M', 'ྦྷ'),
-    (0xFA8, 'V'),
-    (0xFAC, 'M', 'ྫྷ'),
-    (0xFAD, 'V'),
-    (0xFB9, 'M', 'ྐྵ'),
-    (0xFBA, 'V'),
-    (0xFBD, 'X'),
-    (0xFBE, 'V'),
-    (0xFCD, 'X'),
-    (0xFCE, 'V'),
-    (0xFDB, 'X'),
-    (0x1000, 'V'),
-    (0x10A0, 'X'),
-    (0x10C7, 'M', 'ⴧ'),
-    (0x10C8, 'X'),
-    (0x10CD, 'M', 'ⴭ'),
-    (0x10CE, 'X'),
-    (0x10D0, 'V'),
-    (0x10FC, 'M', 'ნ'),
-    (0x10FD, 'V'),
-    (0x115F, 'X'),
-    (0x1161, 'V'),
-    (0x1249, 'X'),
-    (0x124A, 'V'),
-    (0x124E, 'X'),
-    (0x1250, 'V'),
-    (0x1257, 'X'),
-    (0x1258, 'V'),
-    (0x1259, 'X'),
-    (0x125A, 'V'),
-    (0x125E, 'X'),
-    (0x1260, 'V'),
-    (0x1289, 'X'),
-    (0x128A, 'V'),
-    (0x128E, 'X'),
-    (0x1290, 'V'),
-    (0x12B1, 'X'),
-    (0x12B2, 'V'),
-    (0x12B6, 'X'),
-    (0x12B8, 'V'),
-    (0x12BF, 'X'),
-    (0x12C0, 'V'),
-    (0x12C1, 'X'),
-    (0x12C2, 'V'),
-    (0x12C6, 'X'),
-    (0x12C8, 'V'),
-    (0x12D7, 'X'),
-    (0x12D8, 'V'),
-    (0x1311, 'X'),
-    (0x1312, 'V'),
+        (0xEBE, "X"),
+        (0xEC0, "V"),
+        (0xEC5, "X"),
+        (0xEC6, "V"),
+        (0xEC7, "X"),
+        (0xEC8, "V"),
+        (0xECF, "X"),
+        (0xED0, "V"),
+        (0xEDA, "X"),
+        (0xEDC, "M", "ຫນ"),
+        (0xEDD, "M", "ຫມ"),
+        (0xEDE, "V"),
+        (0xEE0, "X"),
+        (0xF00, "V"),
+        (0xF0C, "M", "་"),
+        (0xF0D, "V"),
+        (0xF43, "M", "གྷ"),
+        (0xF44, "V"),
+        (0xF48, "X"),
+        (0xF49, "V"),
+        (0xF4D, "M", "ཌྷ"),
+        (0xF4E, "V"),
+        (0xF52, "M", "དྷ"),
+        (0xF53, "V"),
+        (0xF57, "M", "བྷ"),
+        (0xF58, "V"),
+        (0xF5C, "M", "ཛྷ"),
+        (0xF5D, "V"),
+        (0xF69, "M", "ཀྵ"),
+        (0xF6A, "V"),
+        (0xF6D, "X"),
+        (0xF71, "V"),
+        (0xF73, "M", "ཱི"),
+        (0xF74, "V"),
+        (0xF75, "M", "ཱུ"),
+        (0xF76, "M", "ྲྀ"),
+        (0xF77, "M", "ྲཱྀ"),
+        (0xF78, "M", "ླྀ"),
+        (0xF79, "M", "ླཱྀ"),
+        (0xF7A, "V"),
+        (0xF81, "M", "ཱྀ"),
+        (0xF82, "V"),
+        (0xF93, "M", "ྒྷ"),
+        (0xF94, "V"),
+        (0xF98, "X"),
+        (0xF99, "V"),
+        (0xF9D, "M", "ྜྷ"),
+        (0xF9E, "V"),
+        (0xFA2, "M", "ྡྷ"),
+        (0xFA3, "V"),
+        (0xFA7, "M", "ྦྷ"),
+        (0xFA8, "V"),
+        (0xFAC, "M", "ྫྷ"),
+        (0xFAD, "V"),
+        (0xFB9, "M", "ྐྵ"),
+        (0xFBA, "V"),
+        (0xFBD, "X"),
+        (0xFBE, "V"),
+        (0xFCD, "X"),
+        (0xFCE, "V"),
+        (0xFDB, "X"),
+        (0x1000, "V"),
+        (0x10A0, "X"),
+        (0x10C7, "M", "ⴧ"),
+        (0x10C8, "X"),
+        (0x10CD, "M", "ⴭ"),
+        (0x10CE, "X"),
+        (0x10D0, "V"),
+        (0x10FC, "M", "ნ"),
+        (0x10FD, "V"),
+        (0x115F, "X"),
+        (0x1161, "V"),
+        (0x1249, "X"),
+        (0x124A, "V"),
+        (0x124E, "X"),
+        (0x1250, "V"),
+        (0x1257, "X"),
+        (0x1258, "V"),
+        (0x1259, "X"),
+        (0x125A, "V"),
+        (0x125E, "X"),
+        (0x1260, "V"),
+        (0x1289, "X"),
+        (0x128A, "V"),
+        (0x128E, "X"),
+        (0x1290, "V"),
+        (0x12B1, "X"),
+        (0x12B2, "V"),
+        (0x12B6, "X"),
+        (0x12B8, "V"),
+        (0x12BF, "X"),
+        (0x12C0, "V"),
+        (0x12C1, "X"),
+        (0x12C2, "V"),
+        (0x12C6, "X"),
+        (0x12C8, "V"),
+        (0x12D7, "X"),
+        (0x12D8, "V"),
+        (0x1311, "X"),
+        (0x1312, "V"),
     ]
 
+
 def _seg_14() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x1316, 'X'),
-    (0x1318, 'V'),
-    (0x135B, 'X'),
-    (0x135D, 'V'),
-    (0x137D, 'X'),
-    (0x1380, 'V'),
-    (0x139A, 'X'),
-    (0x13A0, 'V'),
-    (0x13F6, 'X'),
-    (0x13F8, 'M', 'Ᏸ'),
-    (0x13F9, 'M', 'Ᏹ'),
-    (0x13FA, 'M', 'Ᏺ'),
-    (0x13FB, 'M', 'Ᏻ'),
-    (0x13FC, 'M', 'Ᏼ'),
-    (0x13FD, 'M', 'Ᏽ'),
-    (0x13FE, 'X'),
-    (0x1400, 'V'),
-    (0x1680, 'X'),
-    (0x1681, 'V'),
-    (0x169D, 'X'),
-    (0x16A0, 'V'),
-    (0x16F9, 'X'),
-    (0x1700, 'V'),
-    (0x1716, 'X'),
-    (0x171F, 'V'),
-    (0x1737, 'X'),
-    (0x1740, 'V'),
-    (0x1754, 'X'),
-    (0x1760, 'V'),
-    (0x176D, 'X'),
-    (0x176E, 'V'),
-    (0x1771, 'X'),
-    (0x1772, 'V'),
-    (0x1774, 'X'),
-    (0x1780, 'V'),
-    (0x17B4, 'X'),
-    (0x17B6, 'V'),
-    (0x17DE, 'X'),
-    (0x17E0, 'V'),
-    (0x17EA, 'X'),
-    (0x17F0, 'V'),
-    (0x17FA, 'X'),
-    (0x1800, 'V'),
-    (0x1806, 'X'),
-    (0x1807, 'V'),
-    (0x180B, 'I'),
-    (0x180E, 'X'),
-    (0x180F, 'I'),
-    (0x1810, 'V'),
-    (0x181A, 'X'),
-    (0x1820, 'V'),
-    (0x1879, 'X'),
-    (0x1880, 'V'),
-    (0x18AB, 'X'),
-    (0x18B0, 'V'),
-    (0x18F6, 'X'),
-    (0x1900, 'V'),
-    (0x191F, 'X'),
-    (0x1920, 'V'),
-    (0x192C, 'X'),
-    (0x1930, 'V'),
-    (0x193C, 'X'),
-    (0x1940, 'V'),
-    (0x1941, 'X'),
-    (0x1944, 'V'),
-    (0x196E, 'X'),
-    (0x1970, 'V'),
-    (0x1975, 'X'),
-    (0x1980, 'V'),
-    (0x19AC, 'X'),
-    (0x19B0, 'V'),
-    (0x19CA, 'X'),
-    (0x19D0, 'V'),
-    (0x19DB, 'X'),
-    (0x19DE, 'V'),
-    (0x1A1C, 'X'),
-    (0x1A1E, 'V'),
-    (0x1A5F, 'X'),
-    (0x1A60, 'V'),
-    (0x1A7D, 'X'),
-    (0x1A7F, 'V'),
-    (0x1A8A, 'X'),
-    (0x1A90, 'V'),
-    (0x1A9A, 'X'),
-    (0x1AA0, 'V'),
-    (0x1AAE, 'X'),
-    (0x1AB0, 'V'),
-    (0x1ACF, 'X'),
-    (0x1B00, 'V'),
-    (0x1B4D, 'X'),
-    (0x1B50, 'V'),
-    (0x1B7F, 'X'),
-    (0x1B80, 'V'),
-    (0x1BF4, 'X'),
-    (0x1BFC, 'V'),
-    (0x1C38, 'X'),
-    (0x1C3B, 'V'),
-    (0x1C4A, 'X'),
-    (0x1C4D, 'V'),
-    (0x1C80, 'M', 'в'),
+        (0x1316, "X"),
+        (0x1318, "V"),
+        (0x135B, "X"),
+        (0x135D, "V"),
+        (0x137D, "X"),
+        (0x1380, "V"),
+        (0x139A, "X"),
+        (0x13A0, "V"),
+        (0x13F6, "X"),
+        (0x13F8, "M", "Ᏸ"),
+        (0x13F9, "M", "Ᏹ"),
+        (0x13FA, "M", "Ᏺ"),
+        (0x13FB, "M", "Ᏻ"),
+        (0x13FC, "M", "Ᏼ"),
+        (0x13FD, "M", "Ᏽ"),
+        (0x13FE, "X"),
+        (0x1400, "V"),
+        (0x1680, "X"),
+        (0x1681, "V"),
+        (0x169D, "X"),
+        (0x16A0, "V"),
+        (0x16F9, "X"),
+        (0x1700, "V"),
+        (0x1716, "X"),
+        (0x171F, "V"),
+        (0x1737, "X"),
+        (0x1740, "V"),
+        (0x1754, "X"),
+        (0x1760, "V"),
+        (0x176D, "X"),
+        (0x176E, "V"),
+        (0x1771, "X"),
+        (0x1772, "V"),
+        (0x1774, "X"),
+        (0x1780, "V"),
+        (0x17B4, "X"),
+        (0x17B6, "V"),
+        (0x17DE, "X"),
+        (0x17E0, "V"),
+        (0x17EA, "X"),
+        (0x17F0, "V"),
+        (0x17FA, "X"),
+        (0x1800, "V"),
+        (0x1806, "X"),
+        (0x1807, "V"),
+        (0x180B, "I"),
+        (0x180E, "X"),
+        (0x180F, "I"),
+        (0x1810, "V"),
+        (0x181A, "X"),
+        (0x1820, "V"),
+        (0x1879, "X"),
+        (0x1880, "V"),
+        (0x18AB, "X"),
+        (0x18B0, "V"),
+        (0x18F6, "X"),
+        (0x1900, "V"),
+        (0x191F, "X"),
+        (0x1920, "V"),
+        (0x192C, "X"),
+        (0x1930, "V"),
+        (0x193C, "X"),
+        (0x1940, "V"),
+        (0x1941, "X"),
+        (0x1944, "V"),
+        (0x196E, "X"),
+        (0x1970, "V"),
+        (0x1975, "X"),
+        (0x1980, "V"),
+        (0x19AC, "X"),
+        (0x19B0, "V"),
+        (0x19CA, "X"),
+        (0x19D0, "V"),
+        (0x19DB, "X"),
+        (0x19DE, "V"),
+        (0x1A1C, "X"),
+        (0x1A1E, "V"),
+        (0x1A5F, "X"),
+        (0x1A60, "V"),
+        (0x1A7D, "X"),
+        (0x1A7F, "V"),
+        (0x1A8A, "X"),
+        (0x1A90, "V"),
+        (0x1A9A, "X"),
+        (0x1AA0, "V"),
+        (0x1AAE, "X"),
+        (0x1AB0, "V"),
+        (0x1ACF, "X"),
+        (0x1B00, "V"),
+        (0x1B4D, "X"),
+        (0x1B50, "V"),
+        (0x1B7F, "X"),
+        (0x1B80, "V"),
+        (0x1BF4, "X"),
+        (0x1BFC, "V"),
+        (0x1C38, "X"),
+        (0x1C3B, "V"),
+        (0x1C4A, "X"),
+        (0x1C4D, "V"),
+        (0x1C80, "M", "в"),
     ]
 
+
 def _seg_15() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x1C81, 'M', 'д'),
-    (0x1C82, 'M', 'о'),
-    (0x1C83, 'M', 'с'),
-    (0x1C84, 'M', 'т'),
-    (0x1C86, 'M', 'ъ'),
-    (0x1C87, 'M', 'ѣ'),
-    (0x1C88, 'M', 'ꙋ'),
-    (0x1C89, 'X'),
-    (0x1C90, 'M', 'ა'),
-    (0x1C91, 'M', 'ბ'),
-    (0x1C92, 'M', 'გ'),
-    (0x1C93, 'M', 'დ'),
-    (0x1C94, 'M', 'ე'),
-    (0x1C95, 'M', 'ვ'),
-    (0x1C96, 'M', 'ზ'),
-    (0x1C97, 'M', 'თ'),
-    (0x1C98, 'M', 'ი'),
-    (0x1C99, 'M', 'კ'),
-    (0x1C9A, 'M', 'ლ'),
-    (0x1C9B, 'M', 'მ'),
-    (0x1C9C, 'M', 'ნ'),
-    (0x1C9D, 'M', 'ო'),
-    (0x1C9E, 'M', 'პ'),
-    (0x1C9F, 'M', 'ჟ'),
-    (0x1CA0, 'M', 'რ'),
-    (0x1CA1, 'M', 'ს'),
-    (0x1CA2, 'M', 'ტ'),
-    (0x1CA3, 'M', 'უ'),
-    (0x1CA4, 'M', 'ფ'),
-    (0x1CA5, 'M', 'ქ'),
-    (0x1CA6, 'M', 'ღ'),
-    (0x1CA7, 'M', 'ყ'),
-    (0x1CA8, 'M', 'შ'),
-    (0x1CA9, 'M', 'ჩ'),
-    (0x1CAA, 'M', 'ც'),
-    (0x1CAB, 'M', 'ძ'),
-    (0x1CAC, 'M', 'წ'),
-    (0x1CAD, 'M', 'ჭ'),
-    (0x1CAE, 'M', 'ხ'),
-    (0x1CAF, 'M', 'ჯ'),
-    (0x1CB0, 'M', 'ჰ'),
-    (0x1CB1, 'M', 'ჱ'),
-    (0x1CB2, 'M', 'ჲ'),
-    (0x1CB3, 'M', 'ჳ'),
-    (0x1CB4, 'M', 'ჴ'),
-    (0x1CB5, 'M', 'ჵ'),
-    (0x1CB6, 'M', 'ჶ'),
-    (0x1CB7, 'M', 'ჷ'),
-    (0x1CB8, 'M', 'ჸ'),
-    (0x1CB9, 'M', 'ჹ'),
-    (0x1CBA, 'M', 'ჺ'),
-    (0x1CBB, 'X'),
-    (0x1CBD, 'M', 'ჽ'),
-    (0x1CBE, 'M', 'ჾ'),
-    (0x1CBF, 'M', 'ჿ'),
-    (0x1CC0, 'V'),
-    (0x1CC8, 'X'),
-    (0x1CD0, 'V'),
-    (0x1CFB, 'X'),
-    (0x1D00, 'V'),
-    (0x1D2C, 'M', 'a'),
-    (0x1D2D, 'M', 'æ'),
-    (0x1D2E, 'M', 'b'),
-    (0x1D2F, 'V'),
-    (0x1D30, 'M', 'd'),
-    (0x1D31, 'M', 'e'),
-    (0x1D32, 'M', 'ǝ'),
-    (0x1D33, 'M', 'g'),
-    (0x1D34, 'M', 'h'),
-    (0x1D35, 'M', 'i'),
-    (0x1D36, 'M', 'j'),
-    (0x1D37, 'M', 'k'),
-    (0x1D38, 'M', 'l'),
-    (0x1D39, 'M', 'm'),
-    (0x1D3A, 'M', 'n'),
-    (0x1D3B, 'V'),
-    (0x1D3C, 'M', 'o'),
-    (0x1D3D, 'M', 'ȣ'),
-    (0x1D3E, 'M', 'p'),
-    (0x1D3F, 'M', 'r'),
-    (0x1D40, 'M', 't'),
-    (0x1D41, 'M', 'u'),
-    (0x1D42, 'M', 'w'),
-    (0x1D43, 'M', 'a'),
-    (0x1D44, 'M', 'ɐ'),
-    (0x1D45, 'M', 'ɑ'),
-    (0x1D46, 'M', 'ᴂ'),
-    (0x1D47, 'M', 'b'),
-    (0x1D48, 'M', 'd'),
-    (0x1D49, 'M', 'e'),
-    (0x1D4A, 'M', 'ə'),
-    (0x1D4B, 'M', 'ɛ'),
-    (0x1D4C, 'M', 'ɜ'),
-    (0x1D4D, 'M', 'g'),
-    (0x1D4E, 'V'),
-    (0x1D4F, 'M', 'k'),
-    (0x1D50, 'M', 'm'),
-    (0x1D51, 'M', 'ŋ'),
-    (0x1D52, 'M', 'o'),
-    (0x1D53, 'M', 'ɔ'),
+        (0x1C81, "M", "д"),
+        (0x1C82, "M", "о"),
+        (0x1C83, "M", "с"),
+        (0x1C84, "M", "т"),
+        (0x1C86, "M", "ъ"),
+        (0x1C87, "M", "ѣ"),
+        (0x1C88, "M", "ꙋ"),
+        (0x1C89, "X"),
+        (0x1C90, "M", "ა"),
+        (0x1C91, "M", "ბ"),
+        (0x1C92, "M", "გ"),
+        (0x1C93, "M", "დ"),
+        (0x1C94, "M", "ე"),
+        (0x1C95, "M", "ვ"),
+        (0x1C96, "M", "ზ"),
+        (0x1C97, "M", "თ"),
+        (0x1C98, "M", "ი"),
+        (0x1C99, "M", "კ"),
+        (0x1C9A, "M", "ლ"),
+        (0x1C9B, "M", "მ"),
+        (0x1C9C, "M", "ნ"),
+        (0x1C9D, "M", "ო"),
+        (0x1C9E, "M", "პ"),
+        (0x1C9F, "M", "ჟ"),
+        (0x1CA0, "M", "რ"),
+        (0x1CA1, "M", "ს"),
+        (0x1CA2, "M", "ტ"),
+        (0x1CA3, "M", "უ"),
+        (0x1CA4, "M", "ფ"),
+        (0x1CA5, "M", "ქ"),
+        (0x1CA6, "M", "ღ"),
+        (0x1CA7, "M", "ყ"),
+        (0x1CA8, "M", "შ"),
+        (0x1CA9, "M", "ჩ"),
+        (0x1CAA, "M", "ც"),
+        (0x1CAB, "M", "ძ"),
+        (0x1CAC, "M", "წ"),
+        (0x1CAD, "M", "ჭ"),
+        (0x1CAE, "M", "ხ"),
+        (0x1CAF, "M", "ჯ"),
+        (0x1CB0, "M", "ჰ"),
+        (0x1CB1, "M", "ჱ"),
+        (0x1CB2, "M", "ჲ"),
+        (0x1CB3, "M", "ჳ"),
+        (0x1CB4, "M", "ჴ"),
+        (0x1CB5, "M", "ჵ"),
+        (0x1CB6, "M", "ჶ"),
+        (0x1CB7, "M", "ჷ"),
+        (0x1CB8, "M", "ჸ"),
+        (0x1CB9, "M", "ჹ"),
+        (0x1CBA, "M", "ჺ"),
+        (0x1CBB, "X"),
+        (0x1CBD, "M", "ჽ"),
+        (0x1CBE, "M", "ჾ"),
+        (0x1CBF, "M", "ჿ"),
+        (0x1CC0, "V"),
+        (0x1CC8, "X"),
+        (0x1CD0, "V"),
+        (0x1CFB, "X"),
+        (0x1D00, "V"),
+        (0x1D2C, "M", "a"),
+        (0x1D2D, "M", "æ"),
+        (0x1D2E, "M", "b"),
+        (0x1D2F, "V"),
+        (0x1D30, "M", "d"),
+        (0x1D31, "M", "e"),
+        (0x1D32, "M", "ǝ"),
+        (0x1D33, "M", "g"),
+        (0x1D34, "M", "h"),
+        (0x1D35, "M", "i"),
+        (0x1D36, "M", "j"),
+        (0x1D37, "M", "k"),
+        (0x1D38, "M", "l"),
+        (0x1D39, "M", "m"),
+        (0x1D3A, "M", "n"),
+        (0x1D3B, "V"),
+        (0x1D3C, "M", "o"),
+        (0x1D3D, "M", "ȣ"),
+        (0x1D3E, "M", "p"),
+        (0x1D3F, "M", "r"),
+        (0x1D40, "M", "t"),
+        (0x1D41, "M", "u"),
+        (0x1D42, "M", "w"),
+        (0x1D43, "M", "a"),
+        (0x1D44, "M", "ɐ"),
+        (0x1D45, "M", "ɑ"),
+        (0x1D46, "M", "ᴂ"),
+        (0x1D47, "M", "b"),
+        (0x1D48, "M", "d"),
+        (0x1D49, "M", "e"),
+        (0x1D4A, "M", "ə"),
+        (0x1D4B, "M", "ɛ"),
+        (0x1D4C, "M", "ɜ"),
+        (0x1D4D, "M", "g"),
+        (0x1D4E, "V"),
+        (0x1D4F, "M", "k"),
+        (0x1D50, "M", "m"),
+        (0x1D51, "M", "ŋ"),
+        (0x1D52, "M", "o"),
+        (0x1D53, "M", "ɔ"),
     ]
 
+
 def _seg_16() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x1D54, 'M', 'ᴖ'),
-    (0x1D55, 'M', 'ᴗ'),
-    (0x1D56, 'M', 'p'),
-    (0x1D57, 'M', 't'),
-    (0x1D58, 'M', 'u'),
-    (0x1D59, 'M', 'ᴝ'),
-    (0x1D5A, 'M', 'ɯ'),
-    (0x1D5B, 'M', 'v'),
-    (0x1D5C, 'M', 'ᴥ'),
-    (0x1D5D, 'M', 'β'),
-    (0x1D5E, 'M', 'γ'),
-    (0x1D5F, 'M', 'δ'),
-    (0x1D60, 'M', 'φ'),
-    (0x1D61, 'M', 'χ'),
-    (0x1D62, 'M', 'i'),
-    (0x1D63, 'M', 'r'),
-    (0x1D64, 'M', 'u'),
-    (0x1D65, 'M', 'v'),
-    (0x1D66, 'M', 'β'),
-    (0x1D67, 'M', 'γ'),
-    (0x1D68, 'M', 'ρ'),
-    (0x1D69, 'M', 'φ'),
-    (0x1D6A, 'M', 'χ'),
-    (0x1D6B, 'V'),
-    (0x1D78, 'M', 'н'),
-    (0x1D79, 'V'),
-    (0x1D9B, 'M', 'ɒ'),
-    (0x1D9C, 'M', 'c'),
-    (0x1D9D, 'M', 'ɕ'),
-    (0x1D9E, 'M', 'ð'),
-    (0x1D9F, 'M', 'ɜ'),
-    (0x1DA0, 'M', 'f'),
-    (0x1DA1, 'M', 'ɟ'),
-    (0x1DA2, 'M', 'ɡ'),
-    (0x1DA3, 'M', 'ɥ'),
-    (0x1DA4, 'M', 'ɨ'),
-    (0x1DA5, 'M', 'ɩ'),
-    (0x1DA6, 'M', 'ɪ'),
-    (0x1DA7, 'M', 'ᵻ'),
-    (0x1DA8, 'M', 'ʝ'),
-    (0x1DA9, 'M', 'ɭ'),
-    (0x1DAA, 'M', 'ᶅ'),
-    (0x1DAB, 'M', 'ʟ'),
-    (0x1DAC, 'M', 'ɱ'),
-    (0x1DAD, 'M', 'ɰ'),
-    (0x1DAE, 'M', 'ɲ'),
-    (0x1DAF, 'M', 'ɳ'),
-    (0x1DB0, 'M', 'ɴ'),
-    (0x1DB1, 'M', 'ɵ'),
-    (0x1DB2, 'M', 'ɸ'),
-    (0x1DB3, 'M', 'ʂ'),
-    (0x1DB4, 'M', 'ʃ'),
-    (0x1DB5, 'M', 'ƫ'),
-    (0x1DB6, 'M', 'ʉ'),
-    (0x1DB7, 'M', 'ʊ'),
-    (0x1DB8, 'M', 'ᴜ'),
-    (0x1DB9, 'M', 'ʋ'),
-    (0x1DBA, 'M', 'ʌ'),
-    (0x1DBB, 'M', 'z'),
-    (0x1DBC, 'M', 'ʐ'),
-    (0x1DBD, 'M', 'ʑ'),
-    (0x1DBE, 'M', 'ʒ'),
-    (0x1DBF, 'M', 'θ'),
-    (0x1DC0, 'V'),
-    (0x1E00, 'M', 'ḁ'),
-    (0x1E01, 'V'),
-    (0x1E02, 'M', 'ḃ'),
-    (0x1E03, 'V'),
-    (0x1E04, 'M', 'ḅ'),
-    (0x1E05, 'V'),
-    (0x1E06, 'M', 'ḇ'),
-    (0x1E07, 'V'),
-    (0x1E08, 'M', 'ḉ'),
-    (0x1E09, 'V'),
-    (0x1E0A, 'M', 'ḋ'),
-    (0x1E0B, 'V'),
-    (0x1E0C, 'M', 'ḍ'),
-    (0x1E0D, 'V'),
-    (0x1E0E, 'M', 'ḏ'),
-    (0x1E0F, 'V'),
-    (0x1E10, 'M', 'ḑ'),
-    (0x1E11, 'V'),
-    (0x1E12, 'M', 'ḓ'),
-    (0x1E13, 'V'),
-    (0x1E14, 'M', 'ḕ'),
-    (0x1E15, 'V'),
-    (0x1E16, 'M', 'ḗ'),
-    (0x1E17, 'V'),
-    (0x1E18, 'M', 'ḙ'),
-    (0x1E19, 'V'),
-    (0x1E1A, 'M', 'ḛ'),
-    (0x1E1B, 'V'),
-    (0x1E1C, 'M', 'ḝ'),
-    (0x1E1D, 'V'),
-    (0x1E1E, 'M', 'ḟ'),
-    (0x1E1F, 'V'),
-    (0x1E20, 'M', 'ḡ'),
-    (0x1E21, 'V'),
-    (0x1E22, 'M', 'ḣ'),
-    (0x1E23, 'V'),
+        (0x1D54, "M", "ᴖ"),
+        (0x1D55, "M", "ᴗ"),
+        (0x1D56, "M", "p"),
+        (0x1D57, "M", "t"),
+        (0x1D58, "M", "u"),
+        (0x1D59, "M", "ᴝ"),
+        (0x1D5A, "M", "ɯ"),
+        (0x1D5B, "M", "v"),
+        (0x1D5C, "M", "ᴥ"),
+        (0x1D5D, "M", "β"),
+        (0x1D5E, "M", "γ"),
+        (0x1D5F, "M", "δ"),
+        (0x1D60, "M", "φ"),
+        (0x1D61, "M", "χ"),
+        (0x1D62, "M", "i"),
+        (0x1D63, "M", "r"),
+        (0x1D64, "M", "u"),
+        (0x1D65, "M", "v"),
+        (0x1D66, "M", "β"),
+        (0x1D67, "M", "γ"),
+        (0x1D68, "M", "ρ"),
+        (0x1D69, "M", "φ"),
+        (0x1D6A, "M", "χ"),
+        (0x1D6B, "V"),
+        (0x1D78, "M", "н"),
+        (0x1D79, "V"),
+        (0x1D9B, "M", "ɒ"),
+        (0x1D9C, "M", "c"),
+        (0x1D9D, "M", "ɕ"),
+        (0x1D9E, "M", "ð"),
+        (0x1D9F, "M", "ɜ"),
+        (0x1DA0, "M", "f"),
+        (0x1DA1, "M", "ɟ"),
+        (0x1DA2, "M", "ɡ"),
+        (0x1DA3, "M", "ɥ"),
+        (0x1DA4, "M", "ɨ"),
+        (0x1DA5, "M", "ɩ"),
+        (0x1DA6, "M", "ɪ"),
+        (0x1DA7, "M", "ᵻ"),
+        (0x1DA8, "M", "ʝ"),
+        (0x1DA9, "M", "ɭ"),
+        (0x1DAA, "M", "ᶅ"),
+        (0x1DAB, "M", "ʟ"),
+        (0x1DAC, "M", "ɱ"),
+        (0x1DAD, "M", "ɰ"),
+        (0x1DAE, "M", "ɲ"),
+        (0x1DAF, "M", "ɳ"),
+        (0x1DB0, "M", "ɴ"),
+        (0x1DB1, "M", "ɵ"),
+        (0x1DB2, "M", "ɸ"),
+        (0x1DB3, "M", "ʂ"),
+        (0x1DB4, "M", "ʃ"),
+        (0x1DB5, "M", "ƫ"),
+        (0x1DB6, "M", "ʉ"),
+        (0x1DB7, "M", "ʊ"),
+        (0x1DB8, "M", "ᴜ"),
+        (0x1DB9, "M", "ʋ"),
+        (0x1DBA, "M", "ʌ"),
+        (0x1DBB, "M", "z"),
+        (0x1DBC, "M", "ʐ"),
+        (0x1DBD, "M", "ʑ"),
+        (0x1DBE, "M", "ʒ"),
+        (0x1DBF, "M", "θ"),
+        (0x1DC0, "V"),
+        (0x1E00, "M", "ḁ"),
+        (0x1E01, "V"),
+        (0x1E02, "M", "ḃ"),
+        (0x1E03, "V"),
+        (0x1E04, "M", "ḅ"),
+        (0x1E05, "V"),
+        (0x1E06, "M", "ḇ"),
+        (0x1E07, "V"),
+        (0x1E08, "M", "ḉ"),
+        (0x1E09, "V"),
+        (0x1E0A, "M", "ḋ"),
+        (0x1E0B, "V"),
+        (0x1E0C, "M", "ḍ"),
+        (0x1E0D, "V"),
+        (0x1E0E, "M", "ḏ"),
+        (0x1E0F, "V"),
+        (0x1E10, "M", "ḑ"),
+        (0x1E11, "V"),
+        (0x1E12, "M", "ḓ"),
+        (0x1E13, "V"),
+        (0x1E14, "M", "ḕ"),
+        (0x1E15, "V"),
+        (0x1E16, "M", "ḗ"),
+        (0x1E17, "V"),
+        (0x1E18, "M", "ḙ"),
+        (0x1E19, "V"),
+        (0x1E1A, "M", "ḛ"),
+        (0x1E1B, "V"),
+        (0x1E1C, "M", "ḝ"),
+        (0x1E1D, "V"),
+        (0x1E1E, "M", "ḟ"),
+        (0x1E1F, "V"),
+        (0x1E20, "M", "ḡ"),
+        (0x1E21, "V"),
+        (0x1E22, "M", "ḣ"),
+        (0x1E23, "V"),
     ]
 
+
 def _seg_17() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x1E24, 'M', 'ḥ'),
-    (0x1E25, 'V'),
-    (0x1E26, 'M', 'ḧ'),
-    (0x1E27, 'V'),
-    (0x1E28, 'M', 'ḩ'),
-    (0x1E29, 'V'),
-    (0x1E2A, 'M', 'ḫ'),
-    (0x1E2B, 'V'),
-    (0x1E2C, 'M', 'ḭ'),
-    (0x1E2D, 'V'),
-    (0x1E2E, 'M', 'ḯ'),
-    (0x1E2F, 'V'),
-    (0x1E30, 'M', 'ḱ'),
-    (0x1E31, 'V'),
-    (0x1E32, 'M', 'ḳ'),
-    (0x1E33, 'V'),
-    (0x1E34, 'M', 'ḵ'),
-    (0x1E35, 'V'),
-    (0x1E36, 'M', 'ḷ'),
-    (0x1E37, 'V'),
-    (0x1E38, 'M', 'ḹ'),
-    (0x1E39, 'V'),
-    (0x1E3A, 'M', 'ḻ'),
-    (0x1E3B, 'V'),
-    (0x1E3C, 'M', 'ḽ'),
-    (0x1E3D, 'V'),
-    (0x1E3E, 'M', 'ḿ'),
-    (0x1E3F, 'V'),
-    (0x1E40, 'M', 'ṁ'),
-    (0x1E41, 'V'),
-    (0x1E42, 'M', 'ṃ'),
-    (0x1E43, 'V'),
-    (0x1E44, 'M', 'ṅ'),
-    (0x1E45, 'V'),
-    (0x1E46, 'M', 'ṇ'),
-    (0x1E47, 'V'),
-    (0x1E48, 'M', 'ṉ'),
-    (0x1E49, 'V'),
-    (0x1E4A, 'M', 'ṋ'),
-    (0x1E4B, 'V'),
-    (0x1E4C, 'M', 'ṍ'),
-    (0x1E4D, 'V'),
-    (0x1E4E, 'M', 'ṏ'),
-    (0x1E4F, 'V'),
-    (0x1E50, 'M', 'ṑ'),
-    (0x1E51, 'V'),
-    (0x1E52, 'M', 'ṓ'),
-    (0x1E53, 'V'),
-    (0x1E54, 'M', 'ṕ'),
-    (0x1E55, 'V'),
-    (0x1E56, 'M', 'ṗ'),
-    (0x1E57, 'V'),
-    (0x1E58, 'M', 'ṙ'),
-    (0x1E59, 'V'),
-    (0x1E5A, 'M', 'ṛ'),
-    (0x1E5B, 'V'),
-    (0x1E5C, 'M', 'ṝ'),
-    (0x1E5D, 'V'),
-    (0x1E5E, 'M', 'ṟ'),
-    (0x1E5F, 'V'),
-    (0x1E60, 'M', 'ṡ'),
-    (0x1E61, 'V'),
-    (0x1E62, 'M', 'ṣ'),
-    (0x1E63, 'V'),
-    (0x1E64, 'M', 'ṥ'),
-    (0x1E65, 'V'),
-    (0x1E66, 'M', 'ṧ'),
-    (0x1E67, 'V'),
-    (0x1E68, 'M', 'ṩ'),
-    (0x1E69, 'V'),
-    (0x1E6A, 'M', 'ṫ'),
-    (0x1E6B, 'V'),
-    (0x1E6C, 'M', 'ṭ'),
-    (0x1E6D, 'V'),
-    (0x1E6E, 'M', 'ṯ'),
-    (0x1E6F, 'V'),
-    (0x1E70, 'M', 'ṱ'),
-    (0x1E71, 'V'),
-    (0x1E72, 'M', 'ṳ'),
-    (0x1E73, 'V'),
-    (0x1E74, 'M', 'ṵ'),
-    (0x1E75, 'V'),
-    (0x1E76, 'M', 'ṷ'),
-    (0x1E77, 'V'),
-    (0x1E78, 'M', 'ṹ'),
-    (0x1E79, 'V'),
-    (0x1E7A, 'M', 'ṻ'),
-    (0x1E7B, 'V'),
-    (0x1E7C, 'M', 'ṽ'),
-    (0x1E7D, 'V'),
-    (0x1E7E, 'M', 'ṿ'),
-    (0x1E7F, 'V'),
-    (0x1E80, 'M', 'ẁ'),
-    (0x1E81, 'V'),
-    (0x1E82, 'M', 'ẃ'),
-    (0x1E83, 'V'),
-    (0x1E84, 'M', 'ẅ'),
-    (0x1E85, 'V'),
-    (0x1E86, 'M', 'ẇ'),
-    (0x1E87, 'V'),
+        (0x1E24, "M", "ḥ"),
+        (0x1E25, "V"),
+        (0x1E26, "M", "ḧ"),
+        (0x1E27, "V"),
+        (0x1E28, "M", "ḩ"),
+        (0x1E29, "V"),
+        (0x1E2A, "M", "ḫ"),
+        (0x1E2B, "V"),
+        (0x1E2C, "M", "ḭ"),
+        (0x1E2D, "V"),
+        (0x1E2E, "M", "ḯ"),
+        (0x1E2F, "V"),
+        (0x1E30, "M", "ḱ"),
+        (0x1E31, "V"),
+        (0x1E32, "M", "ḳ"),
+        (0x1E33, "V"),
+        (0x1E34, "M", "ḵ"),
+        (0x1E35, "V"),
+        (0x1E36, "M", "ḷ"),
+        (0x1E37, "V"),
+        (0x1E38, "M", "ḹ"),
+        (0x1E39, "V"),
+        (0x1E3A, "M", "ḻ"),
+        (0x1E3B, "V"),
+        (0x1E3C, "M", "ḽ"),
+        (0x1E3D, "V"),
+        (0x1E3E, "M", "ḿ"),
+        (0x1E3F, "V"),
+        (0x1E40, "M", "ṁ"),
+        (0x1E41, "V"),
+        (0x1E42, "M", "ṃ"),
+        (0x1E43, "V"),
+        (0x1E44, "M", "ṅ"),
+        (0x1E45, "V"),
+        (0x1E46, "M", "ṇ"),
+        (0x1E47, "V"),
+        (0x1E48, "M", "ṉ"),
+        (0x1E49, "V"),
+        (0x1E4A, "M", "ṋ"),
+        (0x1E4B, "V"),
+        (0x1E4C, "M", "ṍ"),
+        (0x1E4D, "V"),
+        (0x1E4E, "M", "ṏ"),
+        (0x1E4F, "V"),
+        (0x1E50, "M", "ṑ"),
+        (0x1E51, "V"),
+        (0x1E52, "M", "ṓ"),
+        (0x1E53, "V"),
+        (0x1E54, "M", "ṕ"),
+        (0x1E55, "V"),
+        (0x1E56, "M", "ṗ"),
+        (0x1E57, "V"),
+        (0x1E58, "M", "ṙ"),
+        (0x1E59, "V"),
+        (0x1E5A, "M", "ṛ"),
+        (0x1E5B, "V"),
+        (0x1E5C, "M", "ṝ"),
+        (0x1E5D, "V"),
+        (0x1E5E, "M", "ṟ"),
+        (0x1E5F, "V"),
+        (0x1E60, "M", "ṡ"),
+        (0x1E61, "V"),
+        (0x1E62, "M", "ṣ"),
+        (0x1E63, "V"),
+        (0x1E64, "M", "ṥ"),
+        (0x1E65, "V"),
+        (0x1E66, "M", "ṧ"),
+        (0x1E67, "V"),
+        (0x1E68, "M", "ṩ"),
+        (0x1E69, "V"),
+        (0x1E6A, "M", "ṫ"),
+        (0x1E6B, "V"),
+        (0x1E6C, "M", "ṭ"),
+        (0x1E6D, "V"),
+        (0x1E6E, "M", "ṯ"),
+        (0x1E6F, "V"),
+        (0x1E70, "M", "ṱ"),
+        (0x1E71, "V"),
+        (0x1E72, "M", "ṳ"),
+        (0x1E73, "V"),
+        (0x1E74, "M", "ṵ"),
+        (0x1E75, "V"),
+        (0x1E76, "M", "ṷ"),
+        (0x1E77, "V"),
+        (0x1E78, "M", "ṹ"),
+        (0x1E79, "V"),
+        (0x1E7A, "M", "ṻ"),
+        (0x1E7B, "V"),
+        (0x1E7C, "M", "ṽ"),
+        (0x1E7D, "V"),
+        (0x1E7E, "M", "ṿ"),
+        (0x1E7F, "V"),
+        (0x1E80, "M", "ẁ"),
+        (0x1E81, "V"),
+        (0x1E82, "M", "ẃ"),
+        (0x1E83, "V"),
+        (0x1E84, "M", "ẅ"),
+        (0x1E85, "V"),
+        (0x1E86, "M", "ẇ"),
+        (0x1E87, "V"),
     ]
 
+
 def _seg_18() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x1E88, 'M', 'ẉ'),
-    (0x1E89, 'V'),
-    (0x1E8A, 'M', 'ẋ'),
-    (0x1E8B, 'V'),
-    (0x1E8C, 'M', 'ẍ'),
-    (0x1E8D, 'V'),
-    (0x1E8E, 'M', 'ẏ'),
-    (0x1E8F, 'V'),
-    (0x1E90, 'M', 'ẑ'),
-    (0x1E91, 'V'),
-    (0x1E92, 'M', 'ẓ'),
-    (0x1E93, 'V'),
-    (0x1E94, 'M', 'ẕ'),
-    (0x1E95, 'V'),
-    (0x1E9A, 'M', 'aʾ'),
-    (0x1E9B, 'M', 'ṡ'),
-    (0x1E9C, 'V'),
-    (0x1E9E, 'M', 'ß'),
-    (0x1E9F, 'V'),
-    (0x1EA0, 'M', 'ạ'),
-    (0x1EA1, 'V'),
-    (0x1EA2, 'M', 'ả'),
-    (0x1EA3, 'V'),
-    (0x1EA4, 'M', 'ấ'),
-    (0x1EA5, 'V'),
-    (0x1EA6, 'M', 'ầ'),
-    (0x1EA7, 'V'),
-    (0x1EA8, 'M', 'ẩ'),
-    (0x1EA9, 'V'),
-    (0x1EAA, 'M', 'ẫ'),
-    (0x1EAB, 'V'),
-    (0x1EAC, 'M', 'ậ'),
-    (0x1EAD, 'V'),
-    (0x1EAE, 'M', 'ắ'),
-    (0x1EAF, 'V'),
-    (0x1EB0, 'M', 'ằ'),
-    (0x1EB1, 'V'),
-    (0x1EB2, 'M', 'ẳ'),
-    (0x1EB3, 'V'),
-    (0x1EB4, 'M', 'ẵ'),
-    (0x1EB5, 'V'),
-    (0x1EB6, 'M', 'ặ'),
-    (0x1EB7, 'V'),
-    (0x1EB8, 'M', 'ẹ'),
-    (0x1EB9, 'V'),
-    (0x1EBA, 'M', 'ẻ'),
-    (0x1EBB, 'V'),
-    (0x1EBC, 'M', 'ẽ'),
-    (0x1EBD, 'V'),
-    (0x1EBE, 'M', 'ế'),
-    (0x1EBF, 'V'),
-    (0x1EC0, 'M', 'ề'),
-    (0x1EC1, 'V'),
-    (0x1EC2, 'M', 'ể'),
-    (0x1EC3, 'V'),
-    (0x1EC4, 'M', 'ễ'),
-    (0x1EC5, 'V'),
-    (0x1EC6, 'M', 'ệ'),
-    (0x1EC7, 'V'),
-    (0x1EC8, 'M', 'ỉ'),
-    (0x1EC9, 'V'),
-    (0x1ECA, 'M', 'ị'),
-    (0x1ECB, 'V'),
-    (0x1ECC, 'M', 'ọ'),
-    (0x1ECD, 'V'),
-    (0x1ECE, 'M', 'ỏ'),
-    (0x1ECF, 'V'),
-    (0x1ED0, 'M', 'ố'),
-    (0x1ED1, 'V'),
-    (0x1ED2, 'M', 'ồ'),
-    (0x1ED3, 'V'),
-    (0x1ED4, 'M', 'ổ'),
-    (0x1ED5, 'V'),
-    (0x1ED6, 'M', 'ỗ'),
-    (0x1ED7, 'V'),
-    (0x1ED8, 'M', 'ộ'),
-    (0x1ED9, 'V'),
-    (0x1EDA, 'M', 'ớ'),
-    (0x1EDB, 'V'),
-    (0x1EDC, 'M', 'ờ'),
-    (0x1EDD, 'V'),
-    (0x1EDE, 'M', 'ở'),
-    (0x1EDF, 'V'),
-    (0x1EE0, 'M', 'ỡ'),
-    (0x1EE1, 'V'),
-    (0x1EE2, 'M', 'ợ'),
-    (0x1EE3, 'V'),
-    (0x1EE4, 'M', 'ụ'),
-    (0x1EE5, 'V'),
-    (0x1EE6, 'M', 'ủ'),
-    (0x1EE7, 'V'),
-    (0x1EE8, 'M', 'ứ'),
-    (0x1EE9, 'V'),
-    (0x1EEA, 'M', 'ừ'),
-    (0x1EEB, 'V'),
-    (0x1EEC, 'M', 'ử'),
-    (0x1EED, 'V'),
-    (0x1EEE, 'M', 'ữ'),
-    (0x1EEF, 'V'),
-    (0x1EF0, 'M', 'ự'),
+        (0x1E88, "M", "ẉ"),
+        (0x1E89, "V"),
+        (0x1E8A, "M", "ẋ"),
+        (0x1E8B, "V"),
+        (0x1E8C, "M", "ẍ"),
+        (0x1E8D, "V"),
+        (0x1E8E, "M", "ẏ"),
+        (0x1E8F, "V"),
+        (0x1E90, "M", "ẑ"),
+        (0x1E91, "V"),
+        (0x1E92, "M", "ẓ"),
+        (0x1E93, "V"),
+        (0x1E94, "M", "ẕ"),
+        (0x1E95, "V"),
+        (0x1E9A, "M", "aʾ"),
+        (0x1E9B, "M", "ṡ"),
+        (0x1E9C, "V"),
+        (0x1E9E, "M", "ß"),
+        (0x1E9F, "V"),
+        (0x1EA0, "M", "ạ"),
+        (0x1EA1, "V"),
+        (0x1EA2, "M", "ả"),
+        (0x1EA3, "V"),
+        (0x1EA4, "M", "ấ"),
+        (0x1EA5, "V"),
+        (0x1EA6, "M", "ầ"),
+        (0x1EA7, "V"),
+        (0x1EA8, "M", "ẩ"),
+        (0x1EA9, "V"),
+        (0x1EAA, "M", "ẫ"),
+        (0x1EAB, "V"),
+        (0x1EAC, "M", "ậ"),
+        (0x1EAD, "V"),
+        (0x1EAE, "M", "ắ"),
+        (0x1EAF, "V"),
+        (0x1EB0, "M", "ằ"),
+        (0x1EB1, "V"),
+        (0x1EB2, "M", "ẳ"),
+        (0x1EB3, "V"),
+        (0x1EB4, "M", "ẵ"),
+        (0x1EB5, "V"),
+        (0x1EB6, "M", "ặ"),
+        (0x1EB7, "V"),
+        (0x1EB8, "M", "ẹ"),
+        (0x1EB9, "V"),
+        (0x1EBA, "M", "ẻ"),
+        (0x1EBB, "V"),
+        (0x1EBC, "M", "ẽ"),
+        (0x1EBD, "V"),
+        (0x1EBE, "M", "ế"),
+        (0x1EBF, "V"),
+        (0x1EC0, "M", "ề"),
+        (0x1EC1, "V"),
+        (0x1EC2, "M", "ể"),
+        (0x1EC3, "V"),
+        (0x1EC4, "M", "ễ"),
+        (0x1EC5, "V"),
+        (0x1EC6, "M", "ệ"),
+        (0x1EC7, "V"),
+        (0x1EC8, "M", "ỉ"),
+        (0x1EC9, "V"),
+        (0x1ECA, "M", "ị"),
+        (0x1ECB, "V"),
+        (0x1ECC, "M", "ọ"),
+        (0x1ECD, "V"),
+        (0x1ECE, "M", "ỏ"),
+        (0x1ECF, "V"),
+        (0x1ED0, "M", "ố"),
+        (0x1ED1, "V"),
+        (0x1ED2, "M", "ồ"),
+        (0x1ED3, "V"),
+        (0x1ED4, "M", "ổ"),
+        (0x1ED5, "V"),
+        (0x1ED6, "M", "ỗ"),
+        (0x1ED7, "V"),
+        (0x1ED8, "M", "ộ"),
+        (0x1ED9, "V"),
+        (0x1EDA, "M", "ớ"),
+        (0x1EDB, "V"),
+        (0x1EDC, "M", "ờ"),
+        (0x1EDD, "V"),
+        (0x1EDE, "M", "ở"),
+        (0x1EDF, "V"),
+        (0x1EE0, "M", "ỡ"),
+        (0x1EE1, "V"),
+        (0x1EE2, "M", "ợ"),
+        (0x1EE3, "V"),
+        (0x1EE4, "M", "ụ"),
+        (0x1EE5, "V"),
+        (0x1EE6, "M", "ủ"),
+        (0x1EE7, "V"),
+        (0x1EE8, "M", "ứ"),
+        (0x1EE9, "V"),
+        (0x1EEA, "M", "ừ"),
+        (0x1EEB, "V"),
+        (0x1EEC, "M", "ử"),
+        (0x1EED, "V"),
+        (0x1EEE, "M", "ữ"),
+        (0x1EEF, "V"),
+        (0x1EF0, "M", "ự"),
     ]
 
+
 def _seg_19() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x1EF1, 'V'),
-    (0x1EF2, 'M', 'ỳ'),
-    (0x1EF3, 'V'),
-    (0x1EF4, 'M', 'ỵ'),
-    (0x1EF5, 'V'),
-    (0x1EF6, 'M', 'ỷ'),
-    (0x1EF7, 'V'),
-    (0x1EF8, 'M', 'ỹ'),
-    (0x1EF9, 'V'),
-    (0x1EFA, 'M', 'ỻ'),
-    (0x1EFB, 'V'),
-    (0x1EFC, 'M', 'ỽ'),
-    (0x1EFD, 'V'),
-    (0x1EFE, 'M', 'ỿ'),
-    (0x1EFF, 'V'),
-    (0x1F08, 'M', 'ἀ'),
-    (0x1F09, 'M', 'ἁ'),
-    (0x1F0A, 'M', 'ἂ'),
-    (0x1F0B, 'M', 'ἃ'),
-    (0x1F0C, 'M', 'ἄ'),
-    (0x1F0D, 'M', 'ἅ'),
-    (0x1F0E, 'M', 'ἆ'),
-    (0x1F0F, 'M', 'ἇ'),
-    (0x1F10, 'V'),
-    (0x1F16, 'X'),
-    (0x1F18, 'M', 'ἐ'),
-    (0x1F19, 'M', 'ἑ'),
-    (0x1F1A, 'M', 'ἒ'),
-    (0x1F1B, 'M', 'ἓ'),
-    (0x1F1C, 'M', 'ἔ'),
-    (0x1F1D, 'M', 'ἕ'),
-    (0x1F1E, 'X'),
-    (0x1F20, 'V'),
-    (0x1F28, 'M', 'ἠ'),
-    (0x1F29, 'M', 'ἡ'),
-    (0x1F2A, 'M', 'ἢ'),
-    (0x1F2B, 'M', 'ἣ'),
-    (0x1F2C, 'M', 'ἤ'),
-    (0x1F2D, 'M', 'ἥ'),
-    (0x1F2E, 'M', 'ἦ'),
-    (0x1F2F, 'M', 'ἧ'),
-    (0x1F30, 'V'),
-    (0x1F38, 'M', 'ἰ'),
-    (0x1F39, 'M', 'ἱ'),
-    (0x1F3A, 'M', 'ἲ'),
-    (0x1F3B, 'M', 'ἳ'),
-    (0x1F3C, 'M', 'ἴ'),
-    (0x1F3D, 'M', 'ἵ'),
-    (0x1F3E, 'M', 'ἶ'),
-    (0x1F3F, 'M', 'ἷ'),
-    (0x1F40, 'V'),
-    (0x1F46, 'X'),
-    (0x1F48, 'M', 'ὀ'),
-    (0x1F49, 'M', 'ὁ'),
-    (0x1F4A, 'M', 'ὂ'),
-    (0x1F4B, 'M', 'ὃ'),
-    (0x1F4C, 'M', 'ὄ'),
-    (0x1F4D, 'M', 'ὅ'),
-    (0x1F4E, 'X'),
-    (0x1F50, 'V'),
-    (0x1F58, 'X'),
-    (0x1F59, 'M', 'ὑ'),
-    (0x1F5A, 'X'),
-    (0x1F5B, 'M', 'ὓ'),
-    (0x1F5C, 'X'),
-    (0x1F5D, 'M', 'ὕ'),
-    (0x1F5E, 'X'),
-    (0x1F5F, 'M', 'ὗ'),
-    (0x1F60, 'V'),
-    (0x1F68, 'M', 'ὠ'),
-    (0x1F69, 'M', 'ὡ'),
-    (0x1F6A, 'M', 'ὢ'),
-    (0x1F6B, 'M', 'ὣ'),
-    (0x1F6C, 'M', 'ὤ'),
-    (0x1F6D, 'M', 'ὥ'),
-    (0x1F6E, 'M', 'ὦ'),
-    (0x1F6F, 'M', 'ὧ'),
-    (0x1F70, 'V'),
-    (0x1F71, 'M', 'ά'),
-    (0x1F72, 'V'),
-    (0x1F73, 'M', 'έ'),
-    (0x1F74, 'V'),
-    (0x1F75, 'M', 'ή'),
-    (0x1F76, 'V'),
-    (0x1F77, 'M', 'ί'),
-    (0x1F78, 'V'),
-    (0x1F79, 'M', 'ό'),
-    (0x1F7A, 'V'),
-    (0x1F7B, 'M', 'ύ'),
-    (0x1F7C, 'V'),
-    (0x1F7D, 'M', 'ώ'),
-    (0x1F7E, 'X'),
-    (0x1F80, 'M', 'ἀι'),
-    (0x1F81, 'M', 'ἁι'),
-    (0x1F82, 'M', 'ἂι'),
-    (0x1F83, 'M', 'ἃι'),
-    (0x1F84, 'M', 'ἄι'),
-    (0x1F85, 'M', 'ἅι'),
-    (0x1F86, 'M', 'ἆι'),
-    (0x1F87, 'M', 'ἇι'),
+        (0x1EF1, "V"),
+        (0x1EF2, "M", "ỳ"),
+        (0x1EF3, "V"),
+        (0x1EF4, "M", "ỵ"),
+        (0x1EF5, "V"),
+        (0x1EF6, "M", "ỷ"),
+        (0x1EF7, "V"),
+        (0x1EF8, "M", "ỹ"),
+        (0x1EF9, "V"),
+        (0x1EFA, "M", "ỻ"),
+        (0x1EFB, "V"),
+        (0x1EFC, "M", "ỽ"),
+        (0x1EFD, "V"),
+        (0x1EFE, "M", "ỿ"),
+        (0x1EFF, "V"),
+        (0x1F08, "M", "ἀ"),
+        (0x1F09, "M", "ἁ"),
+        (0x1F0A, "M", "ἂ"),
+        (0x1F0B, "M", "ἃ"),
+        (0x1F0C, "M", "ἄ"),
+        (0x1F0D, "M", "ἅ"),
+        (0x1F0E, "M", "ἆ"),
+        (0x1F0F, "M", "ἇ"),
+        (0x1F10, "V"),
+        (0x1F16, "X"),
+        (0x1F18, "M", "ἐ"),
+        (0x1F19, "M", "ἑ"),
+        (0x1F1A, "M", "ἒ"),
+        (0x1F1B, "M", "ἓ"),
+        (0x1F1C, "M", "ἔ"),
+        (0x1F1D, "M", "ἕ"),
+        (0x1F1E, "X"),
+        (0x1F20, "V"),
+        (0x1F28, "M", "ἠ"),
+        (0x1F29, "M", "ἡ"),
+        (0x1F2A, "M", "ἢ"),
+        (0x1F2B, "M", "ἣ"),
+        (0x1F2C, "M", "ἤ"),
+        (0x1F2D, "M", "ἥ"),
+        (0x1F2E, "M", "ἦ"),
+        (0x1F2F, "M", "ἧ"),
+        (0x1F30, "V"),
+        (0x1F38, "M", "ἰ"),
+        (0x1F39, "M", "ἱ"),
+        (0x1F3A, "M", "ἲ"),
+        (0x1F3B, "M", "ἳ"),
+        (0x1F3C, "M", "ἴ"),
+        (0x1F3D, "M", "ἵ"),
+        (0x1F3E, "M", "ἶ"),
+        (0x1F3F, "M", "ἷ"),
+        (0x1F40, "V"),
+        (0x1F46, "X"),
+        (0x1F48, "M", "ὀ"),
+        (0x1F49, "M", "ὁ"),
+        (0x1F4A, "M", "ὂ"),
+        (0x1F4B, "M", "ὃ"),
+        (0x1F4C, "M", "ὄ"),
+        (0x1F4D, "M", "ὅ"),
+        (0x1F4E, "X"),
+        (0x1F50, "V"),
+        (0x1F58, "X"),
+        (0x1F59, "M", "ὑ"),
+        (0x1F5A, "X"),
+        (0x1F5B, "M", "ὓ"),
+        (0x1F5C, "X"),
+        (0x1F5D, "M", "ὕ"),
+        (0x1F5E, "X"),
+        (0x1F5F, "M", "ὗ"),
+        (0x1F60, "V"),
+        (0x1F68, "M", "ὠ"),
+        (0x1F69, "M", "ὡ"),
+        (0x1F6A, "M", "ὢ"),
+        (0x1F6B, "M", "ὣ"),
+        (0x1F6C, "M", "ὤ"),
+        (0x1F6D, "M", "ὥ"),
+        (0x1F6E, "M", "ὦ"),
+        (0x1F6F, "M", "ὧ"),
+        (0x1F70, "V"),
+        (0x1F71, "M", "ά"),
+        (0x1F72, "V"),
+        (0x1F73, "M", "έ"),
+        (0x1F74, "V"),
+        (0x1F75, "M", "ή"),
+        (0x1F76, "V"),
+        (0x1F77, "M", "ί"),
+        (0x1F78, "V"),
+        (0x1F79, "M", "ό"),
+        (0x1F7A, "V"),
+        (0x1F7B, "M", "ύ"),
+        (0x1F7C, "V"),
+        (0x1F7D, "M", "ώ"),
+        (0x1F7E, "X"),
+        (0x1F80, "M", "ἀι"),
+        (0x1F81, "M", "ἁι"),
+        (0x1F82, "M", "ἂι"),
+        (0x1F83, "M", "ἃι"),
+        (0x1F84, "M", "ἄι"),
+        (0x1F85, "M", "ἅι"),
+        (0x1F86, "M", "ἆι"),
+        (0x1F87, "M", "ἇι"),
     ]
 
+
 def _seg_20() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x1F88, 'M', 'ἀι'),
-    (0x1F89, 'M', 'ἁι'),
-    (0x1F8A, 'M', 'ἂι'),
-    (0x1F8B, 'M', 'ἃι'),
-    (0x1F8C, 'M', 'ἄι'),
-    (0x1F8D, 'M', 'ἅι'),
-    (0x1F8E, 'M', 'ἆι'),
-    (0x1F8F, 'M', 'ἇι'),
-    (0x1F90, 'M', 'ἠι'),
-    (0x1F91, 'M', 'ἡι'),
-    (0x1F92, 'M', 'ἢι'),
-    (0x1F93, 'M', 'ἣι'),
-    (0x1F94, 'M', 'ἤι'),
-    (0x1F95, 'M', 'ἥι'),
-    (0x1F96, 'M', 'ἦι'),
-    (0x1F97, 'M', 'ἧι'),
-    (0x1F98, 'M', 'ἠι'),
-    (0x1F99, 'M', 'ἡι'),
-    (0x1F9A, 'M', 'ἢι'),
-    (0x1F9B, 'M', 'ἣι'),
-    (0x1F9C, 'M', 'ἤι'),
-    (0x1F9D, 'M', 'ἥι'),
-    (0x1F9E, 'M', 'ἦι'),
-    (0x1F9F, 'M', 'ἧι'),
-    (0x1FA0, 'M', 'ὠι'),
-    (0x1FA1, 'M', 'ὡι'),
-    (0x1FA2, 'M', 'ὢι'),
-    (0x1FA3, 'M', 'ὣι'),
-    (0x1FA4, 'M', 'ὤι'),
-    (0x1FA5, 'M', 'ὥι'),
-    (0x1FA6, 'M', 'ὦι'),
-    (0x1FA7, 'M', 'ὧι'),
-    (0x1FA8, 'M', 'ὠι'),
-    (0x1FA9, 'M', 'ὡι'),
-    (0x1FAA, 'M', 'ὢι'),
-    (0x1FAB, 'M', 'ὣι'),
-    (0x1FAC, 'M', 'ὤι'),
-    (0x1FAD, 'M', 'ὥι'),
-    (0x1FAE, 'M', 'ὦι'),
-    (0x1FAF, 'M', 'ὧι'),
-    (0x1FB0, 'V'),
-    (0x1FB2, 'M', 'ὰι'),
-    (0x1FB3, 'M', 'αι'),
-    (0x1FB4, 'M', 'άι'),
-    (0x1FB5, 'X'),
-    (0x1FB6, 'V'),
-    (0x1FB7, 'M', 'ᾶι'),
-    (0x1FB8, 'M', 'ᾰ'),
-    (0x1FB9, 'M', 'ᾱ'),
-    (0x1FBA, 'M', 'ὰ'),
-    (0x1FBB, 'M', 'ά'),
-    (0x1FBC, 'M', 'αι'),
-    (0x1FBD, '3', ' ̓'),
-    (0x1FBE, 'M', 'ι'),
-    (0x1FBF, '3', ' ̓'),
-    (0x1FC0, '3', ' ͂'),
-    (0x1FC1, '3', ' ̈͂'),
-    (0x1FC2, 'M', 'ὴι'),
-    (0x1FC3, 'M', 'ηι'),
-    (0x1FC4, 'M', 'ήι'),
-    (0x1FC5, 'X'),
-    (0x1FC6, 'V'),
-    (0x1FC7, 'M', 'ῆι'),
-    (0x1FC8, 'M', 'ὲ'),
-    (0x1FC9, 'M', 'έ'),
-    (0x1FCA, 'M', 'ὴ'),
-    (0x1FCB, 'M', 'ή'),
-    (0x1FCC, 'M', 'ηι'),
-    (0x1FCD, '3', ' ̓̀'),
-    (0x1FCE, '3', ' ̓́'),
-    (0x1FCF, '3', ' ̓͂'),
-    (0x1FD0, 'V'),
-    (0x1FD3, 'M', 'ΐ'),
-    (0x1FD4, 'X'),
-    (0x1FD6, 'V'),
-    (0x1FD8, 'M', 'ῐ'),
-    (0x1FD9, 'M', 'ῑ'),
-    (0x1FDA, 'M', 'ὶ'),
-    (0x1FDB, 'M', 'ί'),
-    (0x1FDC, 'X'),
-    (0x1FDD, '3', ' ̔̀'),
-    (0x1FDE, '3', ' ̔́'),
-    (0x1FDF, '3', ' ̔͂'),
-    (0x1FE0, 'V'),
-    (0x1FE3, 'M', 'ΰ'),
-    (0x1FE4, 'V'),
-    (0x1FE8, 'M', 'ῠ'),
-    (0x1FE9, 'M', 'ῡ'),
-    (0x1FEA, 'M', 'ὺ'),
-    (0x1FEB, 'M', 'ύ'),
-    (0x1FEC, 'M', 'ῥ'),
-    (0x1FED, '3', ' ̈̀'),
-    (0x1FEE, '3', ' ̈́'),
-    (0x1FEF, '3', '`'),
-    (0x1FF0, 'X'),
-    (0x1FF2, 'M', 'ὼι'),
-    (0x1FF3, 'M', 'ωι'),
-    (0x1FF4, 'M', 'ώι'),
-    (0x1FF5, 'X'),
-    (0x1FF6, 'V'),
+        (0x1F88, "M", "ἀι"),
+        (0x1F89, "M", "ἁι"),
+        (0x1F8A, "M", "ἂι"),
+        (0x1F8B, "M", "ἃι"),
+        (0x1F8C, "M", "ἄι"),
+        (0x1F8D, "M", "ἅι"),
+        (0x1F8E, "M", "ἆι"),
+        (0x1F8F, "M", "ἇι"),
+        (0x1F90, "M", "ἠι"),
+        (0x1F91, "M", "ἡι"),
+        (0x1F92, "M", "ἢι"),
+        (0x1F93, "M", "ἣι"),
+        (0x1F94, "M", "ἤι"),
+        (0x1F95, "M", "ἥι"),
+        (0x1F96, "M", "ἦι"),
+        (0x1F97, "M", "ἧι"),
+        (0x1F98, "M", "ἠι"),
+        (0x1F99, "M", "ἡι"),
+        (0x1F9A, "M", "ἢι"),
+        (0x1F9B, "M", "ἣι"),
+        (0x1F9C, "M", "ἤι"),
+        (0x1F9D, "M", "ἥι"),
+        (0x1F9E, "M", "ἦι"),
+        (0x1F9F, "M", "ἧι"),
+        (0x1FA0, "M", "ὠι"),
+        (0x1FA1, "M", "ὡι"),
+        (0x1FA2, "M", "ὢι"),
+        (0x1FA3, "M", "ὣι"),
+        (0x1FA4, "M", "ὤι"),
+        (0x1FA5, "M", "ὥι"),
+        (0x1FA6, "M", "ὦι"),
+        (0x1FA7, "M", "ὧι"),
+        (0x1FA8, "M", "ὠι"),
+        (0x1FA9, "M", "ὡι"),
+        (0x1FAA, "M", "ὢι"),
+        (0x1FAB, "M", "ὣι"),
+        (0x1FAC, "M", "ὤι"),
+        (0x1FAD, "M", "ὥι"),
+        (0x1FAE, "M", "ὦι"),
+        (0x1FAF, "M", "ὧι"),
+        (0x1FB0, "V"),
+        (0x1FB2, "M", "ὰι"),
+        (0x1FB3, "M", "αι"),
+        (0x1FB4, "M", "άι"),
+        (0x1FB5, "X"),
+        (0x1FB6, "V"),
+        (0x1FB7, "M", "ᾶι"),
+        (0x1FB8, "M", "ᾰ"),
+        (0x1FB9, "M", "ᾱ"),
+        (0x1FBA, "M", "ὰ"),
+        (0x1FBB, "M", "ά"),
+        (0x1FBC, "M", "αι"),
+        (0x1FBD, "3", " ̓"),
+        (0x1FBE, "M", "ι"),
+        (0x1FBF, "3", " ̓"),
+        (0x1FC0, "3", " ͂"),
+        (0x1FC1, "3", " ̈͂"),
+        (0x1FC2, "M", "ὴι"),
+        (0x1FC3, "M", "ηι"),
+        (0x1FC4, "M", "ήι"),
+        (0x1FC5, "X"),
+        (0x1FC6, "V"),
+        (0x1FC7, "M", "ῆι"),
+        (0x1FC8, "M", "ὲ"),
+        (0x1FC9, "M", "έ"),
+        (0x1FCA, "M", "ὴ"),
+        (0x1FCB, "M", "ή"),
+        (0x1FCC, "M", "ηι"),
+        (0x1FCD, "3", " ̓̀"),
+        (0x1FCE, "3", " ̓́"),
+        (0x1FCF, "3", " ̓͂"),
+        (0x1FD0, "V"),
+        (0x1FD3, "M", "ΐ"),
+        (0x1FD4, "X"),
+        (0x1FD6, "V"),
+        (0x1FD8, "M", "ῐ"),
+        (0x1FD9, "M", "ῑ"),
+        (0x1FDA, "M", "ὶ"),
+        (0x1FDB, "M", "ί"),
+        (0x1FDC, "X"),
+        (0x1FDD, "3", " ̔̀"),
+        (0x1FDE, "3", " ̔́"),
+        (0x1FDF, "3", " ̔͂"),
+        (0x1FE0, "V"),
+        (0x1FE3, "M", "ΰ"),
+        (0x1FE4, "V"),
+        (0x1FE8, "M", "ῠ"),
+        (0x1FE9, "M", "ῡ"),
+        (0x1FEA, "M", "ὺ"),
+        (0x1FEB, "M", "ύ"),
+        (0x1FEC, "M", "ῥ"),
+        (0x1FED, "3", " ̈̀"),
+        (0x1FEE, "3", " ̈́"),
+        (0x1FEF, "3", "`"),
+        (0x1FF0, "X"),
+        (0x1FF2, "M", "ὼι"),
+        (0x1FF3, "M", "ωι"),
+        (0x1FF4, "M", "ώι"),
+        (0x1FF5, "X"),
+        (0x1FF6, "V"),
     ]
 
+
 def _seg_21() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x1FF7, 'M', 'ῶι'),
-    (0x1FF8, 'M', 'ὸ'),
-    (0x1FF9, 'M', 'ό'),
-    (0x1FFA, 'M', 'ὼ'),
-    (0x1FFB, 'M', 'ώ'),
-    (0x1FFC, 'M', 'ωι'),
-    (0x1FFD, '3', ' ́'),
-    (0x1FFE, '3', ' ̔'),
-    (0x1FFF, 'X'),
-    (0x2000, '3', ' '),
-    (0x200B, 'I'),
-    (0x200C, 'D', ''),
-    (0x200E, 'X'),
-    (0x2010, 'V'),
-    (0x2011, 'M', '‐'),
-    (0x2012, 'V'),
-    (0x2017, '3', ' ̳'),
-    (0x2018, 'V'),
-    (0x2024, 'X'),
-    (0x2027, 'V'),
-    (0x2028, 'X'),
-    (0x202F, '3', ' '),
-    (0x2030, 'V'),
-    (0x2033, 'M', '′′'),
-    (0x2034, 'M', '′′′'),
-    (0x2035, 'V'),
-    (0x2036, 'M', '‵‵'),
-    (0x2037, 'M', '‵‵‵'),
-    (0x2038, 'V'),
-    (0x203C, '3', '!!'),
-    (0x203D, 'V'),
-    (0x203E, '3', ' ̅'),
-    (0x203F, 'V'),
-    (0x2047, '3', '??'),
-    (0x2048, '3', '?!'),
-    (0x2049, '3', '!?'),
-    (0x204A, 'V'),
-    (0x2057, 'M', '′′′′'),
-    (0x2058, 'V'),
-    (0x205F, '3', ' '),
-    (0x2060, 'I'),
-    (0x2061, 'X'),
-    (0x2064, 'I'),
-    (0x2065, 'X'),
-    (0x2070, 'M', '0'),
-    (0x2071, 'M', 'i'),
-    (0x2072, 'X'),
-    (0x2074, 'M', '4'),
-    (0x2075, 'M', '5'),
-    (0x2076, 'M', '6'),
-    (0x2077, 'M', '7'),
-    (0x2078, 'M', '8'),
-    (0x2079, 'M', '9'),
-    (0x207A, '3', '+'),
-    (0x207B, 'M', '−'),
-    (0x207C, '3', '='),
-    (0x207D, '3', '('),
-    (0x207E, '3', ')'),
-    (0x207F, 'M', 'n'),
-    (0x2080, 'M', '0'),
-    (0x2081, 'M', '1'),
-    (0x2082, 'M', '2'),
-    (0x2083, 'M', '3'),
-    (0x2084, 'M', '4'),
-    (0x2085, 'M', '5'),
-    (0x2086, 'M', '6'),
-    (0x2087, 'M', '7'),
-    (0x2088, 'M', '8'),
-    (0x2089, 'M', '9'),
-    (0x208A, '3', '+'),
-    (0x208B, 'M', '−'),
-    (0x208C, '3', '='),
-    (0x208D, '3', '('),
-    (0x208E, '3', ')'),
-    (0x208F, 'X'),
-    (0x2090, 'M', 'a'),
-    (0x2091, 'M', 'e'),
-    (0x2092, 'M', 'o'),
-    (0x2093, 'M', 'x'),
-    (0x2094, 'M', 'ə'),
-    (0x2095, 'M', 'h'),
-    (0x2096, 'M', 'k'),
-    (0x2097, 'M', 'l'),
-    (0x2098, 'M', 'm'),
-    (0x2099, 'M', 'n'),
-    (0x209A, 'M', 'p'),
-    (0x209B, 'M', 's'),
-    (0x209C, 'M', 't'),
-    (0x209D, 'X'),
-    (0x20A0, 'V'),
-    (0x20A8, 'M', 'rs'),
-    (0x20A9, 'V'),
-    (0x20C1, 'X'),
-    (0x20D0, 'V'),
-    (0x20F1, 'X'),
-    (0x2100, '3', 'a/c'),
-    (0x2101, '3', 'a/s'),
-    (0x2102, 'M', 'c'),
-    (0x2103, 'M', '°c'),
-    (0x2104, 'V'),
+        (0x1FF7, "M", "ῶι"),
+        (0x1FF8, "M", "ὸ"),
+        (0x1FF9, "M", "ό"),
+        (0x1FFA, "M", "ὼ"),
+        (0x1FFB, "M", "ώ"),
+        (0x1FFC, "M", "ωι"),
+        (0x1FFD, "3", " ́"),
+        (0x1FFE, "3", " ̔"),
+        (0x1FFF, "X"),
+        (0x2000, "3", " "),
+        (0x200B, "I"),
+        (0x200C, "D", ""),
+        (0x200E, "X"),
+        (0x2010, "V"),
+        (0x2011, "M", "‐"),
+        (0x2012, "V"),
+        (0x2017, "3", " ̳"),
+        (0x2018, "V"),
+        (0x2024, "X"),
+        (0x2027, "V"),
+        (0x2028, "X"),
+        (0x202F, "3", " "),
+        (0x2030, "V"),
+        (0x2033, "M", "′′"),
+        (0x2034, "M", "′′′"),
+        (0x2035, "V"),
+        (0x2036, "M", "‵‵"),
+        (0x2037, "M", "‵‵‵"),
+        (0x2038, "V"),
+        (0x203C, "3", "!!"),
+        (0x203D, "V"),
+        (0x203E, "3", " ̅"),
+        (0x203F, "V"),
+        (0x2047, "3", "??"),
+        (0x2048, "3", "?!"),
+        (0x2049, "3", "!?"),
+        (0x204A, "V"),
+        (0x2057, "M", "′′′′"),
+        (0x2058, "V"),
+        (0x205F, "3", " "),
+        (0x2060, "I"),
+        (0x2061, "X"),
+        (0x2064, "I"),
+        (0x2065, "X"),
+        (0x2070, "M", "0"),
+        (0x2071, "M", "i"),
+        (0x2072, "X"),
+        (0x2074, "M", "4"),
+        (0x2075, "M", "5"),
+        (0x2076, "M", "6"),
+        (0x2077, "M", "7"),
+        (0x2078, "M", "8"),
+        (0x2079, "M", "9"),
+        (0x207A, "3", "+"),
+        (0x207B, "M", "−"),
+        (0x207C, "3", "="),
+        (0x207D, "3", "("),
+        (0x207E, "3", ")"),
+        (0x207F, "M", "n"),
+        (0x2080, "M", "0"),
+        (0x2081, "M", "1"),
+        (0x2082, "M", "2"),
+        (0x2083, "M", "3"),
+        (0x2084, "M", "4"),
+        (0x2085, "M", "5"),
+        (0x2086, "M", "6"),
+        (0x2087, "M", "7"),
+        (0x2088, "M", "8"),
+        (0x2089, "M", "9"),
+        (0x208A, "3", "+"),
+        (0x208B, "M", "−"),
+        (0x208C, "3", "="),
+        (0x208D, "3", "("),
+        (0x208E, "3", ")"),
+        (0x208F, "X"),
+        (0x2090, "M", "a"),
+        (0x2091, "M", "e"),
+        (0x2092, "M", "o"),
+        (0x2093, "M", "x"),
+        (0x2094, "M", "ə"),
+        (0x2095, "M", "h"),
+        (0x2096, "M", "k"),
+        (0x2097, "M", "l"),
+        (0x2098, "M", "m"),
+        (0x2099, "M", "n"),
+        (0x209A, "M", "p"),
+        (0x209B, "M", "s"),
+        (0x209C, "M", "t"),
+        (0x209D, "X"),
+        (0x20A0, "V"),
+        (0x20A8, "M", "rs"),
+        (0x20A9, "V"),
+        (0x20C1, "X"),
+        (0x20D0, "V"),
+        (0x20F1, "X"),
+        (0x2100, "3", "a/c"),
+        (0x2101, "3", "a/s"),
+        (0x2102, "M", "c"),
+        (0x2103, "M", "°c"),
+        (0x2104, "V"),
     ]
 
+
 def _seg_22() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x2105, '3', 'c/o'),
-    (0x2106, '3', 'c/u'),
-    (0x2107, 'M', 'ɛ'),
-    (0x2108, 'V'),
-    (0x2109, 'M', '°f'),
-    (0x210A, 'M', 'g'),
-    (0x210B, 'M', 'h'),
-    (0x210F, 'M', 'ħ'),
-    (0x2110, 'M', 'i'),
-    (0x2112, 'M', 'l'),
-    (0x2114, 'V'),
-    (0x2115, 'M', 'n'),
-    (0x2116, 'M', 'no'),
-    (0x2117, 'V'),
-    (0x2119, 'M', 'p'),
-    (0x211A, 'M', 'q'),
-    (0x211B, 'M', 'r'),
-    (0x211E, 'V'),
-    (0x2120, 'M', 'sm'),
-    (0x2121, 'M', 'tel'),
-    (0x2122, 'M', 'tm'),
-    (0x2123, 'V'),
-    (0x2124, 'M', 'z'),
-    (0x2125, 'V'),
-    (0x2126, 'M', 'ω'),
-    (0x2127, 'V'),
-    (0x2128, 'M', 'z'),
-    (0x2129, 'V'),
-    (0x212A, 'M', 'k'),
-    (0x212B, 'M', 'å'),
-    (0x212C, 'M', 'b'),
-    (0x212D, 'M', 'c'),
-    (0x212E, 'V'),
-    (0x212F, 'M', 'e'),
-    (0x2131, 'M', 'f'),
-    (0x2132, 'X'),
-    (0x2133, 'M', 'm'),
-    (0x2134, 'M', 'o'),
-    (0x2135, 'M', 'א'),
-    (0x2136, 'M', 'ב'),
-    (0x2137, 'M', 'ג'),
-    (0x2138, 'M', 'ד'),
-    (0x2139, 'M', 'i'),
-    (0x213A, 'V'),
-    (0x213B, 'M', 'fax'),
-    (0x213C, 'M', 'π'),
-    (0x213D, 'M', 'γ'),
-    (0x213F, 'M', 'π'),
-    (0x2140, 'M', '∑'),
-    (0x2141, 'V'),
-    (0x2145, 'M', 'd'),
-    (0x2147, 'M', 'e'),
-    (0x2148, 'M', 'i'),
-    (0x2149, 'M', 'j'),
-    (0x214A, 'V'),
-    (0x2150, 'M', '1⁄7'),
-    (0x2151, 'M', '1⁄9'),
-    (0x2152, 'M', '1⁄10'),
-    (0x2153, 'M', '1⁄3'),
-    (0x2154, 'M', '2⁄3'),
-    (0x2155, 'M', '1⁄5'),
-    (0x2156, 'M', '2⁄5'),
-    (0x2157, 'M', '3⁄5'),
-    (0x2158, 'M', '4⁄5'),
-    (0x2159, 'M', '1⁄6'),
-    (0x215A, 'M', '5⁄6'),
-    (0x215B, 'M', '1⁄8'),
-    (0x215C, 'M', '3⁄8'),
-    (0x215D, 'M', '5⁄8'),
-    (0x215E, 'M', '7⁄8'),
-    (0x215F, 'M', '1⁄'),
-    (0x2160, 'M', 'i'),
-    (0x2161, 'M', 'ii'),
-    (0x2162, 'M', 'iii'),
-    (0x2163, 'M', 'iv'),
-    (0x2164, 'M', 'v'),
-    (0x2165, 'M', 'vi'),
-    (0x2166, 'M', 'vii'),
-    (0x2167, 'M', 'viii'),
-    (0x2168, 'M', 'ix'),
-    (0x2169, 'M', 'x'),
-    (0x216A, 'M', 'xi'),
-    (0x216B, 'M', 'xii'),
-    (0x216C, 'M', 'l'),
-    (0x216D, 'M', 'c'),
-    (0x216E, 'M', 'd'),
-    (0x216F, 'M', 'm'),
-    (0x2170, 'M', 'i'),
-    (0x2171, 'M', 'ii'),
-    (0x2172, 'M', 'iii'),
-    (0x2173, 'M', 'iv'),
-    (0x2174, 'M', 'v'),
-    (0x2175, 'M', 'vi'),
-    (0x2176, 'M', 'vii'),
-    (0x2177, 'M', 'viii'),
-    (0x2178, 'M', 'ix'),
-    (0x2179, 'M', 'x'),
-    (0x217A, 'M', 'xi'),
-    (0x217B, 'M', 'xii'),
-    (0x217C, 'M', 'l'),
+        (0x2105, "3", "c/o"),
+        (0x2106, "3", "c/u"),
+        (0x2107, "M", "ɛ"),
+        (0x2108, "V"),
+        (0x2109, "M", "°f"),
+        (0x210A, "M", "g"),
+        (0x210B, "M", "h"),
+        (0x210F, "M", "ħ"),
+        (0x2110, "M", "i"),
+        (0x2112, "M", "l"),
+        (0x2114, "V"),
+        (0x2115, "M", "n"),
+        (0x2116, "M", "no"),
+        (0x2117, "V"),
+        (0x2119, "M", "p"),
+        (0x211A, "M", "q"),
+        (0x211B, "M", "r"),
+        (0x211E, "V"),
+        (0x2120, "M", "sm"),
+        (0x2121, "M", "tel"),
+        (0x2122, "M", "tm"),
+        (0x2123, "V"),
+        (0x2124, "M", "z"),
+        (0x2125, "V"),
+        (0x2126, "M", "ω"),
+        (0x2127, "V"),
+        (0x2128, "M", "z"),
+        (0x2129, "V"),
+        (0x212A, "M", "k"),
+        (0x212B, "M", "å"),
+        (0x212C, "M", "b"),
+        (0x212D, "M", "c"),
+        (0x212E, "V"),
+        (0x212F, "M", "e"),
+        (0x2131, "M", "f"),
+        (0x2132, "X"),
+        (0x2133, "M", "m"),
+        (0x2134, "M", "o"),
+        (0x2135, "M", "א"),
+        (0x2136, "M", "ב"),
+        (0x2137, "M", "ג"),
+        (0x2138, "M", "ד"),
+        (0x2139, "M", "i"),
+        (0x213A, "V"),
+        (0x213B, "M", "fax"),
+        (0x213C, "M", "π"),
+        (0x213D, "M", "γ"),
+        (0x213F, "M", "π"),
+        (0x2140, "M", "∑"),
+        (0x2141, "V"),
+        (0x2145, "M", "d"),
+        (0x2147, "M", "e"),
+        (0x2148, "M", "i"),
+        (0x2149, "M", "j"),
+        (0x214A, "V"),
+        (0x2150, "M", "1⁄7"),
+        (0x2151, "M", "1⁄9"),
+        (0x2152, "M", "1⁄10"),
+        (0x2153, "M", "1⁄3"),
+        (0x2154, "M", "2⁄3"),
+        (0x2155, "M", "1⁄5"),
+        (0x2156, "M", "2⁄5"),
+        (0x2157, "M", "3⁄5"),
+        (0x2158, "M", "4⁄5"),
+        (0x2159, "M", "1⁄6"),
+        (0x215A, "M", "5⁄6"),
+        (0x215B, "M", "1⁄8"),
+        (0x215C, "M", "3⁄8"),
+        (0x215D, "M", "5⁄8"),
+        (0x215E, "M", "7⁄8"),
+        (0x215F, "M", "1⁄"),
+        (0x2160, "M", "i"),
+        (0x2161, "M", "ii"),
+        (0x2162, "M", "iii"),
+        (0x2163, "M", "iv"),
+        (0x2164, "M", "v"),
+        (0x2165, "M", "vi"),
+        (0x2166, "M", "vii"),
+        (0x2167, "M", "viii"),
+        (0x2168, "M", "ix"),
+        (0x2169, "M", "x"),
+        (0x216A, "M", "xi"),
+        (0x216B, "M", "xii"),
+        (0x216C, "M", "l"),
+        (0x216D, "M", "c"),
+        (0x216E, "M", "d"),
+        (0x216F, "M", "m"),
+        (0x2170, "M", "i"),
+        (0x2171, "M", "ii"),
+        (0x2172, "M", "iii"),
+        (0x2173, "M", "iv"),
+        (0x2174, "M", "v"),
+        (0x2175, "M", "vi"),
+        (0x2176, "M", "vii"),
+        (0x2177, "M", "viii"),
+        (0x2178, "M", "ix"),
+        (0x2179, "M", "x"),
+        (0x217A, "M", "xi"),
+        (0x217B, "M", "xii"),
+        (0x217C, "M", "l"),
     ]
 
+
 def _seg_23() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x217D, 'M', 'c'),
-    (0x217E, 'M', 'd'),
-    (0x217F, 'M', 'm'),
-    (0x2180, 'V'),
-    (0x2183, 'X'),
-    (0x2184, 'V'),
-    (0x2189, 'M', '0⁄3'),
-    (0x218A, 'V'),
-    (0x218C, 'X'),
-    (0x2190, 'V'),
-    (0x222C, 'M', '∫∫'),
-    (0x222D, 'M', '∫∫∫'),
-    (0x222E, 'V'),
-    (0x222F, 'M', '∮∮'),
-    (0x2230, 'M', '∮∮∮'),
-    (0x2231, 'V'),
-    (0x2329, 'M', '〈'),
-    (0x232A, 'M', '〉'),
-    (0x232B, 'V'),
-    (0x2427, 'X'),
-    (0x2440, 'V'),
-    (0x244B, 'X'),
-    (0x2460, 'M', '1'),
-    (0x2461, 'M', '2'),
-    (0x2462, 'M', '3'),
-    (0x2463, 'M', '4'),
-    (0x2464, 'M', '5'),
-    (0x2465, 'M', '6'),
-    (0x2466, 'M', '7'),
-    (0x2467, 'M', '8'),
-    (0x2468, 'M', '9'),
-    (0x2469, 'M', '10'),
-    (0x246A, 'M', '11'),
-    (0x246B, 'M', '12'),
-    (0x246C, 'M', '13'),
-    (0x246D, 'M', '14'),
-    (0x246E, 'M', '15'),
-    (0x246F, 'M', '16'),
-    (0x2470, 'M', '17'),
-    (0x2471, 'M', '18'),
-    (0x2472, 'M', '19'),
-    (0x2473, 'M', '20'),
-    (0x2474, '3', '(1)'),
-    (0x2475, '3', '(2)'),
-    (0x2476, '3', '(3)'),
-    (0x2477, '3', '(4)'),
-    (0x2478, '3', '(5)'),
-    (0x2479, '3', '(6)'),
-    (0x247A, '3', '(7)'),
-    (0x247B, '3', '(8)'),
-    (0x247C, '3', '(9)'),
-    (0x247D, '3', '(10)'),
-    (0x247E, '3', '(11)'),
-    (0x247F, '3', '(12)'),
-    (0x2480, '3', '(13)'),
-    (0x2481, '3', '(14)'),
-    (0x2482, '3', '(15)'),
-    (0x2483, '3', '(16)'),
-    (0x2484, '3', '(17)'),
-    (0x2485, '3', '(18)'),
-    (0x2486, '3', '(19)'),
-    (0x2487, '3', '(20)'),
-    (0x2488, 'X'),
-    (0x249C, '3', '(a)'),
-    (0x249D, '3', '(b)'),
-    (0x249E, '3', '(c)'),
-    (0x249F, '3', '(d)'),
-    (0x24A0, '3', '(e)'),
-    (0x24A1, '3', '(f)'),
-    (0x24A2, '3', '(g)'),
-    (0x24A3, '3', '(h)'),
-    (0x24A4, '3', '(i)'),
-    (0x24A5, '3', '(j)'),
-    (0x24A6, '3', '(k)'),
-    (0x24A7, '3', '(l)'),
-    (0x24A8, '3', '(m)'),
-    (0x24A9, '3', '(n)'),
-    (0x24AA, '3', '(o)'),
-    (0x24AB, '3', '(p)'),
-    (0x24AC, '3', '(q)'),
-    (0x24AD, '3', '(r)'),
-    (0x24AE, '3', '(s)'),
-    (0x24AF, '3', '(t)'),
-    (0x24B0, '3', '(u)'),
-    (0x24B1, '3', '(v)'),
-    (0x24B2, '3', '(w)'),
-    (0x24B3, '3', '(x)'),
-    (0x24B4, '3', '(y)'),
-    (0x24B5, '3', '(z)'),
-    (0x24B6, 'M', 'a'),
-    (0x24B7, 'M', 'b'),
-    (0x24B8, 'M', 'c'),
-    (0x24B9, 'M', 'd'),
-    (0x24BA, 'M', 'e'),
-    (0x24BB, 'M', 'f'),
-    (0x24BC, 'M', 'g'),
-    (0x24BD, 'M', 'h'),
-    (0x24BE, 'M', 'i'),
-    (0x24BF, 'M', 'j'),
-    (0x24C0, 'M', 'k'),
+        (0x217D, "M", "c"),
+        (0x217E, "M", "d"),
+        (0x217F, "M", "m"),
+        (0x2180, "V"),
+        (0x2183, "X"),
+        (0x2184, "V"),
+        (0x2189, "M", "0⁄3"),
+        (0x218A, "V"),
+        (0x218C, "X"),
+        (0x2190, "V"),
+        (0x222C, "M", "∫∫"),
+        (0x222D, "M", "∫∫∫"),
+        (0x222E, "V"),
+        (0x222F, "M", "∮∮"),
+        (0x2230, "M", "∮∮∮"),
+        (0x2231, "V"),
+        (0x2329, "M", "〈"),
+        (0x232A, "M", "〉"),
+        (0x232B, "V"),
+        (0x2427, "X"),
+        (0x2440, "V"),
+        (0x244B, "X"),
+        (0x2460, "M", "1"),
+        (0x2461, "M", "2"),
+        (0x2462, "M", "3"),
+        (0x2463, "M", "4"),
+        (0x2464, "M", "5"),
+        (0x2465, "M", "6"),
+        (0x2466, "M", "7"),
+        (0x2467, "M", "8"),
+        (0x2468, "M", "9"),
+        (0x2469, "M", "10"),
+        (0x246A, "M", "11"),
+        (0x246B, "M", "12"),
+        (0x246C, "M", "13"),
+        (0x246D, "M", "14"),
+        (0x246E, "M", "15"),
+        (0x246F, "M", "16"),
+        (0x2470, "M", "17"),
+        (0x2471, "M", "18"),
+        (0x2472, "M", "19"),
+        (0x2473, "M", "20"),
+        (0x2474, "3", "(1)"),
+        (0x2475, "3", "(2)"),
+        (0x2476, "3", "(3)"),
+        (0x2477, "3", "(4)"),
+        (0x2478, "3", "(5)"),
+        (0x2479, "3", "(6)"),
+        (0x247A, "3", "(7)"),
+        (0x247B, "3", "(8)"),
+        (0x247C, "3", "(9)"),
+        (0x247D, "3", "(10)"),
+        (0x247E, "3", "(11)"),
+        (0x247F, "3", "(12)"),
+        (0x2480, "3", "(13)"),
+        (0x2481, "3", "(14)"),
+        (0x2482, "3", "(15)"),
+        (0x2483, "3", "(16)"),
+        (0x2484, "3", "(17)"),
+        (0x2485, "3", "(18)"),
+        (0x2486, "3", "(19)"),
+        (0x2487, "3", "(20)"),
+        (0x2488, "X"),
+        (0x249C, "3", "(a)"),
+        (0x249D, "3", "(b)"),
+        (0x249E, "3", "(c)"),
+        (0x249F, "3", "(d)"),
+        (0x24A0, "3", "(e)"),
+        (0x24A1, "3", "(f)"),
+        (0x24A2, "3", "(g)"),
+        (0x24A3, "3", "(h)"),
+        (0x24A4, "3", "(i)"),
+        (0x24A5, "3", "(j)"),
+        (0x24A6, "3", "(k)"),
+        (0x24A7, "3", "(l)"),
+        (0x24A8, "3", "(m)"),
+        (0x24A9, "3", "(n)"),
+        (0x24AA, "3", "(o)"),
+        (0x24AB, "3", "(p)"),
+        (0x24AC, "3", "(q)"),
+        (0x24AD, "3", "(r)"),
+        (0x24AE, "3", "(s)"),
+        (0x24AF, "3", "(t)"),
+        (0x24B0, "3", "(u)"),
+        (0x24B1, "3", "(v)"),
+        (0x24B2, "3", "(w)"),
+        (0x24B3, "3", "(x)"),
+        (0x24B4, "3", "(y)"),
+        (0x24B5, "3", "(z)"),
+        (0x24B6, "M", "a"),
+        (0x24B7, "M", "b"),
+        (0x24B8, "M", "c"),
+        (0x24B9, "M", "d"),
+        (0x24BA, "M", "e"),
+        (0x24BB, "M", "f"),
+        (0x24BC, "M", "g"),
+        (0x24BD, "M", "h"),
+        (0x24BE, "M", "i"),
+        (0x24BF, "M", "j"),
+        (0x24C0, "M", "k"),
     ]
 
+
 def _seg_24() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x24C1, 'M', 'l'),
-    (0x24C2, 'M', 'm'),
-    (0x24C3, 'M', 'n'),
-    (0x24C4, 'M', 'o'),
-    (0x24C5, 'M', 'p'),
-    (0x24C6, 'M', 'q'),
-    (0x24C7, 'M', 'r'),
-    (0x24C8, 'M', 's'),
-    (0x24C9, 'M', 't'),
-    (0x24CA, 'M', 'u'),
-    (0x24CB, 'M', 'v'),
-    (0x24CC, 'M', 'w'),
-    (0x24CD, 'M', 'x'),
-    (0x24CE, 'M', 'y'),
-    (0x24CF, 'M', 'z'),
-    (0x24D0, 'M', 'a'),
-    (0x24D1, 'M', 'b'),
-    (0x24D2, 'M', 'c'),
-    (0x24D3, 'M', 'd'),
-    (0x24D4, 'M', 'e'),
-    (0x24D5, 'M', 'f'),
-    (0x24D6, 'M', 'g'),
-    (0x24D7, 'M', 'h'),
-    (0x24D8, 'M', 'i'),
-    (0x24D9, 'M', 'j'),
-    (0x24DA, 'M', 'k'),
-    (0x24DB, 'M', 'l'),
-    (0x24DC, 'M', 'm'),
-    (0x24DD, 'M', 'n'),
-    (0x24DE, 'M', 'o'),
-    (0x24DF, 'M', 'p'),
-    (0x24E0, 'M', 'q'),
-    (0x24E1, 'M', 'r'),
-    (0x24E2, 'M', 's'),
-    (0x24E3, 'M', 't'),
-    (0x24E4, 'M', 'u'),
-    (0x24E5, 'M', 'v'),
-    (0x24E6, 'M', 'w'),
-    (0x24E7, 'M', 'x'),
-    (0x24E8, 'M', 'y'),
-    (0x24E9, 'M', 'z'),
-    (0x24EA, 'M', '0'),
-    (0x24EB, 'V'),
-    (0x2A0C, 'M', '∫∫∫∫'),
-    (0x2A0D, 'V'),
-    (0x2A74, '3', '::='),
-    (0x2A75, '3', '=='),
-    (0x2A76, '3', '==='),
-    (0x2A77, 'V'),
-    (0x2ADC, 'M', '⫝̸'),
-    (0x2ADD, 'V'),
-    (0x2B74, 'X'),
-    (0x2B76, 'V'),
-    (0x2B96, 'X'),
-    (0x2B97, 'V'),
-    (0x2C00, 'M', 'ⰰ'),
-    (0x2C01, 'M', 'ⰱ'),
-    (0x2C02, 'M', 'ⰲ'),
-    (0x2C03, 'M', 'ⰳ'),
-    (0x2C04, 'M', 'ⰴ'),
-    (0x2C05, 'M', 'ⰵ'),
-    (0x2C06, 'M', 'ⰶ'),
-    (0x2C07, 'M', 'ⰷ'),
-    (0x2C08, 'M', 'ⰸ'),
-    (0x2C09, 'M', 'ⰹ'),
-    (0x2C0A, 'M', 'ⰺ'),
-    (0x2C0B, 'M', 'ⰻ'),
-    (0x2C0C, 'M', 'ⰼ'),
-    (0x2C0D, 'M', 'ⰽ'),
-    (0x2C0E, 'M', 'ⰾ'),
-    (0x2C0F, 'M', 'ⰿ'),
-    (0x2C10, 'M', 'ⱀ'),
-    (0x2C11, 'M', 'ⱁ'),
-    (0x2C12, 'M', 'ⱂ'),
-    (0x2C13, 'M', 'ⱃ'),
-    (0x2C14, 'M', 'ⱄ'),
-    (0x2C15, 'M', 'ⱅ'),
-    (0x2C16, 'M', 'ⱆ'),
-    (0x2C17, 'M', 'ⱇ'),
-    (0x2C18, 'M', 'ⱈ'),
-    (0x2C19, 'M', 'ⱉ'),
-    (0x2C1A, 'M', 'ⱊ'),
-    (0x2C1B, 'M', 'ⱋ'),
-    (0x2C1C, 'M', 'ⱌ'),
-    (0x2C1D, 'M', 'ⱍ'),
-    (0x2C1E, 'M', 'ⱎ'),
-    (0x2C1F, 'M', 'ⱏ'),
-    (0x2C20, 'M', 'ⱐ'),
-    (0x2C21, 'M', 'ⱑ'),
-    (0x2C22, 'M', 'ⱒ'),
-    (0x2C23, 'M', 'ⱓ'),
-    (0x2C24, 'M', 'ⱔ'),
-    (0x2C25, 'M', 'ⱕ'),
-    (0x2C26, 'M', 'ⱖ'),
-    (0x2C27, 'M', 'ⱗ'),
-    (0x2C28, 'M', 'ⱘ'),
-    (0x2C29, 'M', 'ⱙ'),
-    (0x2C2A, 'M', 'ⱚ'),
-    (0x2C2B, 'M', 'ⱛ'),
-    (0x2C2C, 'M', 'ⱜ'),
+        (0x24C1, "M", "l"),
+        (0x24C2, "M", "m"),
+        (0x24C3, "M", "n"),
+        (0x24C4, "M", "o"),
+        (0x24C5, "M", "p"),
+        (0x24C6, "M", "q"),
+        (0x24C7, "M", "r"),
+        (0x24C8, "M", "s"),
+        (0x24C9, "M", "t"),
+        (0x24CA, "M", "u"),
+        (0x24CB, "M", "v"),
+        (0x24CC, "M", "w"),
+        (0x24CD, "M", "x"),
+        (0x24CE, "M", "y"),
+        (0x24CF, "M", "z"),
+        (0x24D0, "M", "a"),
+        (0x24D1, "M", "b"),
+        (0x24D2, "M", "c"),
+        (0x24D3, "M", "d"),
+        (0x24D4, "M", "e"),
+        (0x24D5, "M", "f"),
+        (0x24D6, "M", "g"),
+        (0x24D7, "M", "h"),
+        (0x24D8, "M", "i"),
+        (0x24D9, "M", "j"),
+        (0x24DA, "M", "k"),
+        (0x24DB, "M", "l"),
+        (0x24DC, "M", "m"),
+        (0x24DD, "M", "n"),
+        (0x24DE, "M", "o"),
+        (0x24DF, "M", "p"),
+        (0x24E0, "M", "q"),
+        (0x24E1, "M", "r"),
+        (0x24E2, "M", "s"),
+        (0x24E3, "M", "t"),
+        (0x24E4, "M", "u"),
+        (0x24E5, "M", "v"),
+        (0x24E6, "M", "w"),
+        (0x24E7, "M", "x"),
+        (0x24E8, "M", "y"),
+        (0x24E9, "M", "z"),
+        (0x24EA, "M", "0"),
+        (0x24EB, "V"),
+        (0x2A0C, "M", "∫∫∫∫"),
+        (0x2A0D, "V"),
+        (0x2A74, "3", "::="),
+        (0x2A75, "3", "=="),
+        (0x2A76, "3", "==="),
+        (0x2A77, "V"),
+        (0x2ADC, "M", "⫝̸"),
+        (0x2ADD, "V"),
+        (0x2B74, "X"),
+        (0x2B76, "V"),
+        (0x2B96, "X"),
+        (0x2B97, "V"),
+        (0x2C00, "M", "ⰰ"),
+        (0x2C01, "M", "ⰱ"),
+        (0x2C02, "M", "ⰲ"),
+        (0x2C03, "M", "ⰳ"),
+        (0x2C04, "M", "ⰴ"),
+        (0x2C05, "M", "ⰵ"),
+        (0x2C06, "M", "ⰶ"),
+        (0x2C07, "M", "ⰷ"),
+        (0x2C08, "M", "ⰸ"),
+        (0x2C09, "M", "ⰹ"),
+        (0x2C0A, "M", "ⰺ"),
+        (0x2C0B, "M", "ⰻ"),
+        (0x2C0C, "M", "ⰼ"),
+        (0x2C0D, "M", "ⰽ"),
+        (0x2C0E, "M", "ⰾ"),
+        (0x2C0F, "M", "ⰿ"),
+        (0x2C10, "M", "ⱀ"),
+        (0x2C11, "M", "ⱁ"),
+        (0x2C12, "M", "ⱂ"),
+        (0x2C13, "M", "ⱃ"),
+        (0x2C14, "M", "ⱄ"),
+        (0x2C15, "M", "ⱅ"),
+        (0x2C16, "M", "ⱆ"),
+        (0x2C17, "M", "ⱇ"),
+        (0x2C18, "M", "ⱈ"),
+        (0x2C19, "M", "ⱉ"),
+        (0x2C1A, "M", "ⱊ"),
+        (0x2C1B, "M", "ⱋ"),
+        (0x2C1C, "M", "ⱌ"),
+        (0x2C1D, "M", "ⱍ"),
+        (0x2C1E, "M", "ⱎ"),
+        (0x2C1F, "M", "ⱏ"),
+        (0x2C20, "M", "ⱐ"),
+        (0x2C21, "M", "ⱑ"),
+        (0x2C22, "M", "ⱒ"),
+        (0x2C23, "M", "ⱓ"),
+        (0x2C24, "M", "ⱔ"),
+        (0x2C25, "M", "ⱕ"),
+        (0x2C26, "M", "ⱖ"),
+        (0x2C27, "M", "ⱗ"),
+        (0x2C28, "M", "ⱘ"),
+        (0x2C29, "M", "ⱙ"),
+        (0x2C2A, "M", "ⱚ"),
+        (0x2C2B, "M", "ⱛ"),
+        (0x2C2C, "M", "ⱜ"),
     ]
 
+
 def _seg_25() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x2C2D, 'M', 'ⱝ'),
-    (0x2C2E, 'M', 'ⱞ'),
-    (0x2C2F, 'M', 'ⱟ'),
-    (0x2C30, 'V'),
-    (0x2C60, 'M', 'ⱡ'),
-    (0x2C61, 'V'),
-    (0x2C62, 'M', 'ɫ'),
-    (0x2C63, 'M', 'ᵽ'),
-    (0x2C64, 'M', 'ɽ'),
-    (0x2C65, 'V'),
-    (0x2C67, 'M', 'ⱨ'),
-    (0x2C68, 'V'),
-    (0x2C69, 'M', 'ⱪ'),
-    (0x2C6A, 'V'),
-    (0x2C6B, 'M', 'ⱬ'),
-    (0x2C6C, 'V'),
-    (0x2C6D, 'M', 'ɑ'),
-    (0x2C6E, 'M', 'ɱ'),
-    (0x2C6F, 'M', 'ɐ'),
-    (0x2C70, 'M', 'ɒ'),
-    (0x2C71, 'V'),
-    (0x2C72, 'M', 'ⱳ'),
-    (0x2C73, 'V'),
-    (0x2C75, 'M', 'ⱶ'),
-    (0x2C76, 'V'),
-    (0x2C7C, 'M', 'j'),
-    (0x2C7D, 'M', 'v'),
-    (0x2C7E, 'M', 'ȿ'),
-    (0x2C7F, 'M', 'ɀ'),
-    (0x2C80, 'M', 'ⲁ'),
-    (0x2C81, 'V'),
-    (0x2C82, 'M', 'ⲃ'),
-    (0x2C83, 'V'),
-    (0x2C84, 'M', 'ⲅ'),
-    (0x2C85, 'V'),
-    (0x2C86, 'M', 'ⲇ'),
-    (0x2C87, 'V'),
-    (0x2C88, 'M', 'ⲉ'),
-    (0x2C89, 'V'),
-    (0x2C8A, 'M', 'ⲋ'),
-    (0x2C8B, 'V'),
-    (0x2C8C, 'M', 'ⲍ'),
-    (0x2C8D, 'V'),
-    (0x2C8E, 'M', 'ⲏ'),
-    (0x2C8F, 'V'),
-    (0x2C90, 'M', 'ⲑ'),
-    (0x2C91, 'V'),
-    (0x2C92, 'M', 'ⲓ'),
-    (0x2C93, 'V'),
-    (0x2C94, 'M', 'ⲕ'),
-    (0x2C95, 'V'),
-    (0x2C96, 'M', 'ⲗ'),
-    (0x2C97, 'V'),
-    (0x2C98, 'M', 'ⲙ'),
-    (0x2C99, 'V'),
-    (0x2C9A, 'M', 'ⲛ'),
-    (0x2C9B, 'V'),
-    (0x2C9C, 'M', 'ⲝ'),
-    (0x2C9D, 'V'),
-    (0x2C9E, 'M', 'ⲟ'),
-    (0x2C9F, 'V'),
-    (0x2CA0, 'M', 'ⲡ'),
-    (0x2CA1, 'V'),
-    (0x2CA2, 'M', 'ⲣ'),
-    (0x2CA3, 'V'),
-    (0x2CA4, 'M', 'ⲥ'),
-    (0x2CA5, 'V'),
-    (0x2CA6, 'M', 'ⲧ'),
-    (0x2CA7, 'V'),
-    (0x2CA8, 'M', 'ⲩ'),
-    (0x2CA9, 'V'),
-    (0x2CAA, 'M', 'ⲫ'),
-    (0x2CAB, 'V'),
-    (0x2CAC, 'M', 'ⲭ'),
-    (0x2CAD, 'V'),
-    (0x2CAE, 'M', 'ⲯ'),
-    (0x2CAF, 'V'),
-    (0x2CB0, 'M', 'ⲱ'),
-    (0x2CB1, 'V'),
-    (0x2CB2, 'M', 'ⲳ'),
-    (0x2CB3, 'V'),
-    (0x2CB4, 'M', 'ⲵ'),
-    (0x2CB5, 'V'),
-    (0x2CB6, 'M', 'ⲷ'),
-    (0x2CB7, 'V'),
-    (0x2CB8, 'M', 'ⲹ'),
-    (0x2CB9, 'V'),
-    (0x2CBA, 'M', 'ⲻ'),
-    (0x2CBB, 'V'),
-    (0x2CBC, 'M', 'ⲽ'),
-    (0x2CBD, 'V'),
-    (0x2CBE, 'M', 'ⲿ'),
-    (0x2CBF, 'V'),
-    (0x2CC0, 'M', 'ⳁ'),
-    (0x2CC1, 'V'),
-    (0x2CC2, 'M', 'ⳃ'),
-    (0x2CC3, 'V'),
-    (0x2CC4, 'M', 'ⳅ'),
-    (0x2CC5, 'V'),
-    (0x2CC6, 'M', 'ⳇ'),
+        (0x2C2D, "M", "ⱝ"),
+        (0x2C2E, "M", "ⱞ"),
+        (0x2C2F, "M", "ⱟ"),
+        (0x2C30, "V"),
+        (0x2C60, "M", "ⱡ"),
+        (0x2C61, "V"),
+        (0x2C62, "M", "ɫ"),
+        (0x2C63, "M", "ᵽ"),
+        (0x2C64, "M", "ɽ"),
+        (0x2C65, "V"),
+        (0x2C67, "M", "ⱨ"),
+        (0x2C68, "V"),
+        (0x2C69, "M", "ⱪ"),
+        (0x2C6A, "V"),
+        (0x2C6B, "M", "ⱬ"),
+        (0x2C6C, "V"),
+        (0x2C6D, "M", "ɑ"),
+        (0x2C6E, "M", "ɱ"),
+        (0x2C6F, "M", "ɐ"),
+        (0x2C70, "M", "ɒ"),
+        (0x2C71, "V"),
+        (0x2C72, "M", "ⱳ"),
+        (0x2C73, "V"),
+        (0x2C75, "M", "ⱶ"),
+        (0x2C76, "V"),
+        (0x2C7C, "M", "j"),
+        (0x2C7D, "M", "v"),
+        (0x2C7E, "M", "ȿ"),
+        (0x2C7F, "M", "ɀ"),
+        (0x2C80, "M", "ⲁ"),
+        (0x2C81, "V"),
+        (0x2C82, "M", "ⲃ"),
+        (0x2C83, "V"),
+        (0x2C84, "M", "ⲅ"),
+        (0x2C85, "V"),
+        (0x2C86, "M", "ⲇ"),
+        (0x2C87, "V"),
+        (0x2C88, "M", "ⲉ"),
+        (0x2C89, "V"),
+        (0x2C8A, "M", "ⲋ"),
+        (0x2C8B, "V"),
+        (0x2C8C, "M", "ⲍ"),
+        (0x2C8D, "V"),
+        (0x2C8E, "M", "ⲏ"),
+        (0x2C8F, "V"),
+        (0x2C90, "M", "ⲑ"),
+        (0x2C91, "V"),
+        (0x2C92, "M", "ⲓ"),
+        (0x2C93, "V"),
+        (0x2C94, "M", "ⲕ"),
+        (0x2C95, "V"),
+        (0x2C96, "M", "ⲗ"),
+        (0x2C97, "V"),
+        (0x2C98, "M", "ⲙ"),
+        (0x2C99, "V"),
+        (0x2C9A, "M", "ⲛ"),
+        (0x2C9B, "V"),
+        (0x2C9C, "M", "ⲝ"),
+        (0x2C9D, "V"),
+        (0x2C9E, "M", "ⲟ"),
+        (0x2C9F, "V"),
+        (0x2CA0, "M", "ⲡ"),
+        (0x2CA1, "V"),
+        (0x2CA2, "M", "ⲣ"),
+        (0x2CA3, "V"),
+        (0x2CA4, "M", "ⲥ"),
+        (0x2CA5, "V"),
+        (0x2CA6, "M", "ⲧ"),
+        (0x2CA7, "V"),
+        (0x2CA8, "M", "ⲩ"),
+        (0x2CA9, "V"),
+        (0x2CAA, "M", "ⲫ"),
+        (0x2CAB, "V"),
+        (0x2CAC, "M", "ⲭ"),
+        (0x2CAD, "V"),
+        (0x2CAE, "M", "ⲯ"),
+        (0x2CAF, "V"),
+        (0x2CB0, "M", "ⲱ"),
+        (0x2CB1, "V"),
+        (0x2CB2, "M", "ⲳ"),
+        (0x2CB3, "V"),
+        (0x2CB4, "M", "ⲵ"),
+        (0x2CB5, "V"),
+        (0x2CB6, "M", "ⲷ"),
+        (0x2CB7, "V"),
+        (0x2CB8, "M", "ⲹ"),
+        (0x2CB9, "V"),
+        (0x2CBA, "M", "ⲻ"),
+        (0x2CBB, "V"),
+        (0x2CBC, "M", "ⲽ"),
+        (0x2CBD, "V"),
+        (0x2CBE, "M", "ⲿ"),
+        (0x2CBF, "V"),
+        (0x2CC0, "M", "ⳁ"),
+        (0x2CC1, "V"),
+        (0x2CC2, "M", "ⳃ"),
+        (0x2CC3, "V"),
+        (0x2CC4, "M", "ⳅ"),
+        (0x2CC5, "V"),
+        (0x2CC6, "M", "ⳇ"),
     ]
 
+
 def _seg_26() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x2CC7, 'V'),
-    (0x2CC8, 'M', 'ⳉ'),
-    (0x2CC9, 'V'),
-    (0x2CCA, 'M', 'ⳋ'),
-    (0x2CCB, 'V'),
-    (0x2CCC, 'M', 'ⳍ'),
-    (0x2CCD, 'V'),
-    (0x2CCE, 'M', 'ⳏ'),
-    (0x2CCF, 'V'),
-    (0x2CD0, 'M', 'ⳑ'),
-    (0x2CD1, 'V'),
-    (0x2CD2, 'M', 'ⳓ'),
-    (0x2CD3, 'V'),
-    (0x2CD4, 'M', 'ⳕ'),
-    (0x2CD5, 'V'),
-    (0x2CD6, 'M', 'ⳗ'),
-    (0x2CD7, 'V'),
-    (0x2CD8, 'M', 'ⳙ'),
-    (0x2CD9, 'V'),
-    (0x2CDA, 'M', 'ⳛ'),
-    (0x2CDB, 'V'),
-    (0x2CDC, 'M', 'ⳝ'),
-    (0x2CDD, 'V'),
-    (0x2CDE, 'M', 'ⳟ'),
-    (0x2CDF, 'V'),
-    (0x2CE0, 'M', 'ⳡ'),
-    (0x2CE1, 'V'),
-    (0x2CE2, 'M', 'ⳣ'),
-    (0x2CE3, 'V'),
-    (0x2CEB, 'M', 'ⳬ'),
-    (0x2CEC, 'V'),
-    (0x2CED, 'M', 'ⳮ'),
-    (0x2CEE, 'V'),
-    (0x2CF2, 'M', 'ⳳ'),
-    (0x2CF3, 'V'),
-    (0x2CF4, 'X'),
-    (0x2CF9, 'V'),
-    (0x2D26, 'X'),
-    (0x2D27, 'V'),
-    (0x2D28, 'X'),
-    (0x2D2D, 'V'),
-    (0x2D2E, 'X'),
-    (0x2D30, 'V'),
-    (0x2D68, 'X'),
-    (0x2D6F, 'M', 'ⵡ'),
-    (0x2D70, 'V'),
-    (0x2D71, 'X'),
-    (0x2D7F, 'V'),
-    (0x2D97, 'X'),
-    (0x2DA0, 'V'),
-    (0x2DA7, 'X'),
-    (0x2DA8, 'V'),
-    (0x2DAF, 'X'),
-    (0x2DB0, 'V'),
-    (0x2DB7, 'X'),
-    (0x2DB8, 'V'),
-    (0x2DBF, 'X'),
-    (0x2DC0, 'V'),
-    (0x2DC7, 'X'),
-    (0x2DC8, 'V'),
-    (0x2DCF, 'X'),
-    (0x2DD0, 'V'),
-    (0x2DD7, 'X'),
-    (0x2DD8, 'V'),
-    (0x2DDF, 'X'),
-    (0x2DE0, 'V'),
-    (0x2E5E, 'X'),
-    (0x2E80, 'V'),
-    (0x2E9A, 'X'),
-    (0x2E9B, 'V'),
-    (0x2E9F, 'M', '母'),
-    (0x2EA0, 'V'),
-    (0x2EF3, 'M', '龟'),
-    (0x2EF4, 'X'),
-    (0x2F00, 'M', '一'),
-    (0x2F01, 'M', '丨'),
-    (0x2F02, 'M', '丶'),
-    (0x2F03, 'M', '丿'),
-    (0x2F04, 'M', '乙'),
-    (0x2F05, 'M', '亅'),
-    (0x2F06, 'M', '二'),
-    (0x2F07, 'M', '亠'),
-    (0x2F08, 'M', '人'),
-    (0x2F09, 'M', '儿'),
-    (0x2F0A, 'M', '入'),
-    (0x2F0B, 'M', '八'),
-    (0x2F0C, 'M', '冂'),
-    (0x2F0D, 'M', '冖'),
-    (0x2F0E, 'M', '冫'),
-    (0x2F0F, 'M', '几'),
-    (0x2F10, 'M', '凵'),
-    (0x2F11, 'M', '刀'),
-    (0x2F12, 'M', '力'),
-    (0x2F13, 'M', '勹'),
-    (0x2F14, 'M', '匕'),
-    (0x2F15, 'M', '匚'),
-    (0x2F16, 'M', '匸'),
-    (0x2F17, 'M', '十'),
-    (0x2F18, 'M', '卜'),
-    (0x2F19, 'M', '卩'),
+        (0x2CC7, "V"),
+        (0x2CC8, "M", "ⳉ"),
+        (0x2CC9, "V"),
+        (0x2CCA, "M", "ⳋ"),
+        (0x2CCB, "V"),
+        (0x2CCC, "M", "ⳍ"),
+        (0x2CCD, "V"),
+        (0x2CCE, "M", "ⳏ"),
+        (0x2CCF, "V"),
+        (0x2CD0, "M", "ⳑ"),
+        (0x2CD1, "V"),
+        (0x2CD2, "M", "ⳓ"),
+        (0x2CD3, "V"),
+        (0x2CD4, "M", "ⳕ"),
+        (0x2CD5, "V"),
+        (0x2CD6, "M", "ⳗ"),
+        (0x2CD7, "V"),
+        (0x2CD8, "M", "ⳙ"),
+        (0x2CD9, "V"),
+        (0x2CDA, "M", "ⳛ"),
+        (0x2CDB, "V"),
+        (0x2CDC, "M", "ⳝ"),
+        (0x2CDD, "V"),
+        (0x2CDE, "M", "ⳟ"),
+        (0x2CDF, "V"),
+        (0x2CE0, "M", "ⳡ"),
+        (0x2CE1, "V"),
+        (0x2CE2, "M", "ⳣ"),
+        (0x2CE3, "V"),
+        (0x2CEB, "M", "ⳬ"),
+        (0x2CEC, "V"),
+        (0x2CED, "M", "ⳮ"),
+        (0x2CEE, "V"),
+        (0x2CF2, "M", "ⳳ"),
+        (0x2CF3, "V"),
+        (0x2CF4, "X"),
+        (0x2CF9, "V"),
+        (0x2D26, "X"),
+        (0x2D27, "V"),
+        (0x2D28, "X"),
+        (0x2D2D, "V"),
+        (0x2D2E, "X"),
+        (0x2D30, "V"),
+        (0x2D68, "X"),
+        (0x2D6F, "M", "ⵡ"),
+        (0x2D70, "V"),
+        (0x2D71, "X"),
+        (0x2D7F, "V"),
+        (0x2D97, "X"),
+        (0x2DA0, "V"),
+        (0x2DA7, "X"),
+        (0x2DA8, "V"),
+        (0x2DAF, "X"),
+        (0x2DB0, "V"),
+        (0x2DB7, "X"),
+        (0x2DB8, "V"),
+        (0x2DBF, "X"),
+        (0x2DC0, "V"),
+        (0x2DC7, "X"),
+        (0x2DC8, "V"),
+        (0x2DCF, "X"),
+        (0x2DD0, "V"),
+        (0x2DD7, "X"),
+        (0x2DD8, "V"),
+        (0x2DDF, "X"),
+        (0x2DE0, "V"),
+        (0x2E5E, "X"),
+        (0x2E80, "V"),
+        (0x2E9A, "X"),
+        (0x2E9B, "V"),
+        (0x2E9F, "M", "母"),
+        (0x2EA0, "V"),
+        (0x2EF3, "M", "龟"),
+        (0x2EF4, "X"),
+        (0x2F00, "M", "一"),
+        (0x2F01, "M", "丨"),
+        (0x2F02, "M", "丶"),
+        (0x2F03, "M", "丿"),
+        (0x2F04, "M", "乙"),
+        (0x2F05, "M", "亅"),
+        (0x2F06, "M", "二"),
+        (0x2F07, "M", "亠"),
+        (0x2F08, "M", "人"),
+        (0x2F09, "M", "儿"),
+        (0x2F0A, "M", "入"),
+        (0x2F0B, "M", "八"),
+        (0x2F0C, "M", "冂"),
+        (0x2F0D, "M", "冖"),
+        (0x2F0E, "M", "冫"),
+        (0x2F0F, "M", "几"),
+        (0x2F10, "M", "凵"),
+        (0x2F11, "M", "刀"),
+        (0x2F12, "M", "力"),
+        (0x2F13, "M", "勹"),
+        (0x2F14, "M", "匕"),
+        (0x2F15, "M", "匚"),
+        (0x2F16, "M", "匸"),
+        (0x2F17, "M", "十"),
+        (0x2F18, "M", "卜"),
+        (0x2F19, "M", "卩"),
     ]
 
+
 def _seg_27() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x2F1A, 'M', '厂'),
-    (0x2F1B, 'M', '厶'),
-    (0x2F1C, 'M', '又'),
-    (0x2F1D, 'M', '口'),
-    (0x2F1E, 'M', '囗'),
-    (0x2F1F, 'M', '土'),
-    (0x2F20, 'M', '士'),
-    (0x2F21, 'M', '夂'),
-    (0x2F22, 'M', '夊'),
-    (0x2F23, 'M', '夕'),
-    (0x2F24, 'M', '大'),
-    (0x2F25, 'M', '女'),
-    (0x2F26, 'M', '子'),
-    (0x2F27, 'M', '宀'),
-    (0x2F28, 'M', '寸'),
-    (0x2F29, 'M', '小'),
-    (0x2F2A, 'M', '尢'),
-    (0x2F2B, 'M', '尸'),
-    (0x2F2C, 'M', '屮'),
-    (0x2F2D, 'M', '山'),
-    (0x2F2E, 'M', '巛'),
-    (0x2F2F, 'M', '工'),
-    (0x2F30, 'M', '己'),
-    (0x2F31, 'M', '巾'),
-    (0x2F32, 'M', '干'),
-    (0x2F33, 'M', '幺'),
-    (0x2F34, 'M', '广'),
-    (0x2F35, 'M', '廴'),
-    (0x2F36, 'M', '廾'),
-    (0x2F37, 'M', '弋'),
-    (0x2F38, 'M', '弓'),
-    (0x2F39, 'M', '彐'),
-    (0x2F3A, 'M', '彡'),
-    (0x2F3B, 'M', '彳'),
-    (0x2F3C, 'M', '心'),
-    (0x2F3D, 'M', '戈'),
-    (0x2F3E, 'M', '戶'),
-    (0x2F3F, 'M', '手'),
-    (0x2F40, 'M', '支'),
-    (0x2F41, 'M', '攴'),
-    (0x2F42, 'M', '文'),
-    (0x2F43, 'M', '斗'),
-    (0x2F44, 'M', '斤'),
-    (0x2F45, 'M', '方'),
-    (0x2F46, 'M', '无'),
-    (0x2F47, 'M', '日'),
-    (0x2F48, 'M', '曰'),
-    (0x2F49, 'M', '月'),
-    (0x2F4A, 'M', '木'),
-    (0x2F4B, 'M', '欠'),
-    (0x2F4C, 'M', '止'),
-    (0x2F4D, 'M', '歹'),
-    (0x2F4E, 'M', '殳'),
-    (0x2F4F, 'M', '毋'),
-    (0x2F50, 'M', '比'),
-    (0x2F51, 'M', '毛'),
-    (0x2F52, 'M', '氏'),
-    (0x2F53, 'M', '气'),
-    (0x2F54, 'M', '水'),
-    (0x2F55, 'M', '火'),
-    (0x2F56, 'M', '爪'),
-    (0x2F57, 'M', '父'),
-    (0x2F58, 'M', '爻'),
-    (0x2F59, 'M', '爿'),
-    (0x2F5A, 'M', '片'),
-    (0x2F5B, 'M', '牙'),
-    (0x2F5C, 'M', '牛'),
-    (0x2F5D, 'M', '犬'),
-    (0x2F5E, 'M', '玄'),
-    (0x2F5F, 'M', '玉'),
-    (0x2F60, 'M', '瓜'),
-    (0x2F61, 'M', '瓦'),
-    (0x2F62, 'M', '甘'),
-    (0x2F63, 'M', '生'),
-    (0x2F64, 'M', '用'),
-    (0x2F65, 'M', '田'),
-    (0x2F66, 'M', '疋'),
-    (0x2F67, 'M', '疒'),
-    (0x2F68, 'M', '癶'),
-    (0x2F69, 'M', '白'),
-    (0x2F6A, 'M', '皮'),
-    (0x2F6B, 'M', '皿'),
-    (0x2F6C, 'M', '目'),
-    (0x2F6D, 'M', '矛'),
-    (0x2F6E, 'M', '矢'),
-    (0x2F6F, 'M', '石'),
-    (0x2F70, 'M', '示'),
-    (0x2F71, 'M', '禸'),
-    (0x2F72, 'M', '禾'),
-    (0x2F73, 'M', '穴'),
-    (0x2F74, 'M', '立'),
-    (0x2F75, 'M', '竹'),
-    (0x2F76, 'M', '米'),
-    (0x2F77, 'M', '糸'),
-    (0x2F78, 'M', '缶'),
-    (0x2F79, 'M', '网'),
-    (0x2F7A, 'M', '羊'),
-    (0x2F7B, 'M', '羽'),
-    (0x2F7C, 'M', '老'),
-    (0x2F7D, 'M', '而'),
+        (0x2F1A, "M", "厂"),
+        (0x2F1B, "M", "厶"),
+        (0x2F1C, "M", "又"),
+        (0x2F1D, "M", "口"),
+        (0x2F1E, "M", "囗"),
+        (0x2F1F, "M", "土"),
+        (0x2F20, "M", "士"),
+        (0x2F21, "M", "夂"),
+        (0x2F22, "M", "夊"),
+        (0x2F23, "M", "夕"),
+        (0x2F24, "M", "大"),
+        (0x2F25, "M", "女"),
+        (0x2F26, "M", "子"),
+        (0x2F27, "M", "宀"),
+        (0x2F28, "M", "寸"),
+        (0x2F29, "M", "小"),
+        (0x2F2A, "M", "尢"),
+        (0x2F2B, "M", "尸"),
+        (0x2F2C, "M", "屮"),
+        (0x2F2D, "M", "山"),
+        (0x2F2E, "M", "巛"),
+        (0x2F2F, "M", "工"),
+        (0x2F30, "M", "己"),
+        (0x2F31, "M", "巾"),
+        (0x2F32, "M", "干"),
+        (0x2F33, "M", "幺"),
+        (0x2F34, "M", "广"),
+        (0x2F35, "M", "廴"),
+        (0x2F36, "M", "廾"),
+        (0x2F37, "M", "弋"),
+        (0x2F38, "M", "弓"),
+        (0x2F39, "M", "彐"),
+        (0x2F3A, "M", "彡"),
+        (0x2F3B, "M", "彳"),
+        (0x2F3C, "M", "心"),
+        (0x2F3D, "M", "戈"),
+        (0x2F3E, "M", "戶"),
+        (0x2F3F, "M", "手"),
+        (0x2F40, "M", "支"),
+        (0x2F41, "M", "攴"),
+        (0x2F42, "M", "文"),
+        (0x2F43, "M", "斗"),
+        (0x2F44, "M", "斤"),
+        (0x2F45, "M", "方"),
+        (0x2F46, "M", "无"),
+        (0x2F47, "M", "日"),
+        (0x2F48, "M", "曰"),
+        (0x2F49, "M", "月"),
+        (0x2F4A, "M", "木"),
+        (0x2F4B, "M", "欠"),
+        (0x2F4C, "M", "止"),
+        (0x2F4D, "M", "歹"),
+        (0x2F4E, "M", "殳"),
+        (0x2F4F, "M", "毋"),
+        (0x2F50, "M", "比"),
+        (0x2F51, "M", "毛"),
+        (0x2F52, "M", "氏"),
+        (0x2F53, "M", "气"),
+        (0x2F54, "M", "水"),
+        (0x2F55, "M", "火"),
+        (0x2F56, "M", "爪"),
+        (0x2F57, "M", "父"),
+        (0x2F58, "M", "爻"),
+        (0x2F59, "M", "爿"),
+        (0x2F5A, "M", "片"),
+        (0x2F5B, "M", "牙"),
+        (0x2F5C, "M", "牛"),
+        (0x2F5D, "M", "犬"),
+        (0x2F5E, "M", "玄"),
+        (0x2F5F, "M", "玉"),
+        (0x2F60, "M", "瓜"),
+        (0x2F61, "M", "瓦"),
+        (0x2F62, "M", "甘"),
+        (0x2F63, "M", "生"),
+        (0x2F64, "M", "用"),
+        (0x2F65, "M", "田"),
+        (0x2F66, "M", "疋"),
+        (0x2F67, "M", "疒"),
+        (0x2F68, "M", "癶"),
+        (0x2F69, "M", "白"),
+        (0x2F6A, "M", "皮"),
+        (0x2F6B, "M", "皿"),
+        (0x2F6C, "M", "目"),
+        (0x2F6D, "M", "矛"),
+        (0x2F6E, "M", "矢"),
+        (0x2F6F, "M", "石"),
+        (0x2F70, "M", "示"),
+        (0x2F71, "M", "禸"),
+        (0x2F72, "M", "禾"),
+        (0x2F73, "M", "穴"),
+        (0x2F74, "M", "立"),
+        (0x2F75, "M", "竹"),
+        (0x2F76, "M", "米"),
+        (0x2F77, "M", "糸"),
+        (0x2F78, "M", "缶"),
+        (0x2F79, "M", "网"),
+        (0x2F7A, "M", "羊"),
+        (0x2F7B, "M", "羽"),
+        (0x2F7C, "M", "老"),
+        (0x2F7D, "M", "而"),
     ]
 
+
 def _seg_28() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x2F7E, 'M', '耒'),
-    (0x2F7F, 'M', '耳'),
-    (0x2F80, 'M', '聿'),
-    (0x2F81, 'M', '肉'),
-    (0x2F82, 'M', '臣'),
-    (0x2F83, 'M', '自'),
-    (0x2F84, 'M', '至'),
-    (0x2F85, 'M', '臼'),
-    (0x2F86, 'M', '舌'),
-    (0x2F87, 'M', '舛'),
-    (0x2F88, 'M', '舟'),
-    (0x2F89, 'M', '艮'),
-    (0x2F8A, 'M', '色'),
-    (0x2F8B, 'M', '艸'),
-    (0x2F8C, 'M', '虍'),
-    (0x2F8D, 'M', '虫'),
-    (0x2F8E, 'M', '血'),
-    (0x2F8F, 'M', '行'),
-    (0x2F90, 'M', '衣'),
-    (0x2F91, 'M', '襾'),
-    (0x2F92, 'M', '見'),
-    (0x2F93, 'M', '角'),
-    (0x2F94, 'M', '言'),
-    (0x2F95, 'M', '谷'),
-    (0x2F96, 'M', '豆'),
-    (0x2F97, 'M', '豕'),
-    (0x2F98, 'M', '豸'),
-    (0x2F99, 'M', '貝'),
-    (0x2F9A, 'M', '赤'),
-    (0x2F9B, 'M', '走'),
-    (0x2F9C, 'M', '足'),
-    (0x2F9D, 'M', '身'),
-    (0x2F9E, 'M', '車'),
-    (0x2F9F, 'M', '辛'),
-    (0x2FA0, 'M', '辰'),
-    (0x2FA1, 'M', '辵'),
-    (0x2FA2, 'M', '邑'),
-    (0x2FA3, 'M', '酉'),
-    (0x2FA4, 'M', '釆'),
-    (0x2FA5, 'M', '里'),
-    (0x2FA6, 'M', '金'),
-    (0x2FA7, 'M', '長'),
-    (0x2FA8, 'M', '門'),
-    (0x2FA9, 'M', '阜'),
-    (0x2FAA, 'M', '隶'),
-    (0x2FAB, 'M', '隹'),
-    (0x2FAC, 'M', '雨'),
-    (0x2FAD, 'M', '靑'),
-    (0x2FAE, 'M', '非'),
-    (0x2FAF, 'M', '面'),
-    (0x2FB0, 'M', '革'),
-    (0x2FB1, 'M', '韋'),
-    (0x2FB2, 'M', '韭'),
-    (0x2FB3, 'M', '音'),
-    (0x2FB4, 'M', '頁'),
-    (0x2FB5, 'M', '風'),
-    (0x2FB6, 'M', '飛'),
-    (0x2FB7, 'M', '食'),
-    (0x2FB8, 'M', '首'),
-    (0x2FB9, 'M', '香'),
-    (0x2FBA, 'M', '馬'),
-    (0x2FBB, 'M', '骨'),
-    (0x2FBC, 'M', '高'),
-    (0x2FBD, 'M', '髟'),
-    (0x2FBE, 'M', '鬥'),
-    (0x2FBF, 'M', '鬯'),
-    (0x2FC0, 'M', '鬲'),
-    (0x2FC1, 'M', '鬼'),
-    (0x2FC2, 'M', '魚'),
-    (0x2FC3, 'M', '鳥'),
-    (0x2FC4, 'M', '鹵'),
-    (0x2FC5, 'M', '鹿'),
-    (0x2FC6, 'M', '麥'),
-    (0x2FC7, 'M', '麻'),
-    (0x2FC8, 'M', '黃'),
-    (0x2FC9, 'M', '黍'),
-    (0x2FCA, 'M', '黑'),
-    (0x2FCB, 'M', '黹'),
-    (0x2FCC, 'M', '黽'),
-    (0x2FCD, 'M', '鼎'),
-    (0x2FCE, 'M', '鼓'),
-    (0x2FCF, 'M', '鼠'),
-    (0x2FD0, 'M', '鼻'),
-    (0x2FD1, 'M', '齊'),
-    (0x2FD2, 'M', '齒'),
-    (0x2FD3, 'M', '龍'),
-    (0x2FD4, 'M', '龜'),
-    (0x2FD5, 'M', '龠'),
-    (0x2FD6, 'X'),
-    (0x3000, '3', ' '),
-    (0x3001, 'V'),
-    (0x3002, 'M', '.'),
-    (0x3003, 'V'),
-    (0x3036, 'M', '〒'),
-    (0x3037, 'V'),
-    (0x3038, 'M', '十'),
-    (0x3039, 'M', '卄'),
-    (0x303A, 'M', '卅'),
-    (0x303B, 'V'),
-    (0x3040, 'X'),
+        (0x2F7E, "M", "耒"),
+        (0x2F7F, "M", "耳"),
+        (0x2F80, "M", "聿"),
+        (0x2F81, "M", "肉"),
+        (0x2F82, "M", "臣"),
+        (0x2F83, "M", "自"),
+        (0x2F84, "M", "至"),
+        (0x2F85, "M", "臼"),
+        (0x2F86, "M", "舌"),
+        (0x2F87, "M", "舛"),
+        (0x2F88, "M", "舟"),
+        (0x2F89, "M", "艮"),
+        (0x2F8A, "M", "色"),
+        (0x2F8B, "M", "艸"),
+        (0x2F8C, "M", "虍"),
+        (0x2F8D, "M", "虫"),
+        (0x2F8E, "M", "血"),
+        (0x2F8F, "M", "行"),
+        (0x2F90, "M", "衣"),
+        (0x2F91, "M", "襾"),
+        (0x2F92, "M", "見"),
+        (0x2F93, "M", "角"),
+        (0x2F94, "M", "言"),
+        (0x2F95, "M", "谷"),
+        (0x2F96, "M", "豆"),
+        (0x2F97, "M", "豕"),
+        (0x2F98, "M", "豸"),
+        (0x2F99, "M", "貝"),
+        (0x2F9A, "M", "赤"),
+        (0x2F9B, "M", "走"),
+        (0x2F9C, "M", "足"),
+        (0x2F9D, "M", "身"),
+        (0x2F9E, "M", "車"),
+        (0x2F9F, "M", "辛"),
+        (0x2FA0, "M", "辰"),
+        (0x2FA1, "M", "辵"),
+        (0x2FA2, "M", "邑"),
+        (0x2FA3, "M", "酉"),
+        (0x2FA4, "M", "釆"),
+        (0x2FA5, "M", "里"),
+        (0x2FA6, "M", "金"),
+        (0x2FA7, "M", "長"),
+        (0x2FA8, "M", "門"),
+        (0x2FA9, "M", "阜"),
+        (0x2FAA, "M", "隶"),
+        (0x2FAB, "M", "隹"),
+        (0x2FAC, "M", "雨"),
+        (0x2FAD, "M", "靑"),
+        (0x2FAE, "M", "非"),
+        (0x2FAF, "M", "面"),
+        (0x2FB0, "M", "革"),
+        (0x2FB1, "M", "韋"),
+        (0x2FB2, "M", "韭"),
+        (0x2FB3, "M", "音"),
+        (0x2FB4, "M", "頁"),
+        (0x2FB5, "M", "風"),
+        (0x2FB6, "M", "飛"),
+        (0x2FB7, "M", "食"),
+        (0x2FB8, "M", "首"),
+        (0x2FB9, "M", "香"),
+        (0x2FBA, "M", "馬"),
+        (0x2FBB, "M", "骨"),
+        (0x2FBC, "M", "高"),
+        (0x2FBD, "M", "髟"),
+        (0x2FBE, "M", "鬥"),
+        (0x2FBF, "M", "鬯"),
+        (0x2FC0, "M", "鬲"),
+        (0x2FC1, "M", "鬼"),
+        (0x2FC2, "M", "魚"),
+        (0x2FC3, "M", "鳥"),
+        (0x2FC4, "M", "鹵"),
+        (0x2FC5, "M", "鹿"),
+        (0x2FC6, "M", "麥"),
+        (0x2FC7, "M", "麻"),
+        (0x2FC8, "M", "黃"),
+        (0x2FC9, "M", "黍"),
+        (0x2FCA, "M", "黑"),
+        (0x2FCB, "M", "黹"),
+        (0x2FCC, "M", "黽"),
+        (0x2FCD, "M", "鼎"),
+        (0x2FCE, "M", "鼓"),
+        (0x2FCF, "M", "鼠"),
+        (0x2FD0, "M", "鼻"),
+        (0x2FD1, "M", "齊"),
+        (0x2FD2, "M", "齒"),
+        (0x2FD3, "M", "龍"),
+        (0x2FD4, "M", "龜"),
+        (0x2FD5, "M", "龠"),
+        (0x2FD6, "X"),
+        (0x3000, "3", " "),
+        (0x3001, "V"),
+        (0x3002, "M", "."),
+        (0x3003, "V"),
+        (0x3036, "M", "〒"),
+        (0x3037, "V"),
+        (0x3038, "M", "十"),
+        (0x3039, "M", "卄"),
+        (0x303A, "M", "卅"),
+        (0x303B, "V"),
+        (0x3040, "X"),
     ]
 
+
 def _seg_29() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x3041, 'V'),
-    (0x3097, 'X'),
-    (0x3099, 'V'),
-    (0x309B, '3', ' ゙'),
-    (0x309C, '3', ' ゚'),
-    (0x309D, 'V'),
-    (0x309F, 'M', 'より'),
-    (0x30A0, 'V'),
-    (0x30FF, 'M', 'コト'),
-    (0x3100, 'X'),
-    (0x3105, 'V'),
-    (0x3130, 'X'),
-    (0x3131, 'M', 'ᄀ'),
-    (0x3132, 'M', 'ᄁ'),
-    (0x3133, 'M', 'ᆪ'),
-    (0x3134, 'M', 'ᄂ'),
-    (0x3135, 'M', 'ᆬ'),
-    (0x3136, 'M', 'ᆭ'),
-    (0x3137, 'M', 'ᄃ'),
-    (0x3138, 'M', 'ᄄ'),
-    (0x3139, 'M', 'ᄅ'),
-    (0x313A, 'M', 'ᆰ'),
-    (0x313B, 'M', 'ᆱ'),
-    (0x313C, 'M', 'ᆲ'),
-    (0x313D, 'M', 'ᆳ'),
-    (0x313E, 'M', 'ᆴ'),
-    (0x313F, 'M', 'ᆵ'),
-    (0x3140, 'M', 'ᄚ'),
-    (0x3141, 'M', 'ᄆ'),
-    (0x3142, 'M', 'ᄇ'),
-    (0x3143, 'M', 'ᄈ'),
-    (0x3144, 'M', 'ᄡ'),
-    (0x3145, 'M', 'ᄉ'),
-    (0x3146, 'M', 'ᄊ'),
-    (0x3147, 'M', 'ᄋ'),
-    (0x3148, 'M', 'ᄌ'),
-    (0x3149, 'M', 'ᄍ'),
-    (0x314A, 'M', 'ᄎ'),
-    (0x314B, 'M', 'ᄏ'),
-    (0x314C, 'M', 'ᄐ'),
-    (0x314D, 'M', 'ᄑ'),
-    (0x314E, 'M', 'ᄒ'),
-    (0x314F, 'M', 'ᅡ'),
-    (0x3150, 'M', 'ᅢ'),
-    (0x3151, 'M', 'ᅣ'),
-    (0x3152, 'M', 'ᅤ'),
-    (0x3153, 'M', 'ᅥ'),
-    (0x3154, 'M', 'ᅦ'),
-    (0x3155, 'M', 'ᅧ'),
-    (0x3156, 'M', 'ᅨ'),
-    (0x3157, 'M', 'ᅩ'),
-    (0x3158, 'M', 'ᅪ'),
-    (0x3159, 'M', 'ᅫ'),
-    (0x315A, 'M', 'ᅬ'),
-    (0x315B, 'M', 'ᅭ'),
-    (0x315C, 'M', 'ᅮ'),
-    (0x315D, 'M', 'ᅯ'),
-    (0x315E, 'M', 'ᅰ'),
-    (0x315F, 'M', 'ᅱ'),
-    (0x3160, 'M', 'ᅲ'),
-    (0x3161, 'M', 'ᅳ'),
-    (0x3162, 'M', 'ᅴ'),
-    (0x3163, 'M', 'ᅵ'),
-    (0x3164, 'X'),
-    (0x3165, 'M', 'ᄔ'),
-    (0x3166, 'M', 'ᄕ'),
-    (0x3167, 'M', 'ᇇ'),
-    (0x3168, 'M', 'ᇈ'),
-    (0x3169, 'M', 'ᇌ'),
-    (0x316A, 'M', 'ᇎ'),
-    (0x316B, 'M', 'ᇓ'),
-    (0x316C, 'M', 'ᇗ'),
-    (0x316D, 'M', 'ᇙ'),
-    (0x316E, 'M', 'ᄜ'),
-    (0x316F, 'M', 'ᇝ'),
-    (0x3170, 'M', 'ᇟ'),
-    (0x3171, 'M', 'ᄝ'),
-    (0x3172, 'M', 'ᄞ'),
-    (0x3173, 'M', 'ᄠ'),
-    (0x3174, 'M', 'ᄢ'),
-    (0x3175, 'M', 'ᄣ'),
-    (0x3176, 'M', 'ᄧ'),
-    (0x3177, 'M', 'ᄩ'),
-    (0x3178, 'M', 'ᄫ'),
-    (0x3179, 'M', 'ᄬ'),
-    (0x317A, 'M', 'ᄭ'),
-    (0x317B, 'M', 'ᄮ'),
-    (0x317C, 'M', 'ᄯ'),
-    (0x317D, 'M', 'ᄲ'),
-    (0x317E, 'M', 'ᄶ'),
-    (0x317F, 'M', 'ᅀ'),
-    (0x3180, 'M', 'ᅇ'),
-    (0x3181, 'M', 'ᅌ'),
-    (0x3182, 'M', 'ᇱ'),
-    (0x3183, 'M', 'ᇲ'),
-    (0x3184, 'M', 'ᅗ'),
-    (0x3185, 'M', 'ᅘ'),
-    (0x3186, 'M', 'ᅙ'),
-    (0x3187, 'M', 'ᆄ'),
-    (0x3188, 'M', 'ᆅ'),
+        (0x3041, "V"),
+        (0x3097, "X"),
+        (0x3099, "V"),
+        (0x309B, "3", " ゙"),
+        (0x309C, "3", " ゚"),
+        (0x309D, "V"),
+        (0x309F, "M", "より"),
+        (0x30A0, "V"),
+        (0x30FF, "M", "コト"),
+        (0x3100, "X"),
+        (0x3105, "V"),
+        (0x3130, "X"),
+        (0x3131, "M", "ᄀ"),
+        (0x3132, "M", "ᄁ"),
+        (0x3133, "M", "ᆪ"),
+        (0x3134, "M", "ᄂ"),
+        (0x3135, "M", "ᆬ"),
+        (0x3136, "M", "ᆭ"),
+        (0x3137, "M", "ᄃ"),
+        (0x3138, "M", "ᄄ"),
+        (0x3139, "M", "ᄅ"),
+        (0x313A, "M", "ᆰ"),
+        (0x313B, "M", "ᆱ"),
+        (0x313C, "M", "ᆲ"),
+        (0x313D, "M", "ᆳ"),
+        (0x313E, "M", "ᆴ"),
+        (0x313F, "M", "ᆵ"),
+        (0x3140, "M", "ᄚ"),
+        (0x3141, "M", "ᄆ"),
+        (0x3142, "M", "ᄇ"),
+        (0x3143, "M", "ᄈ"),
+        (0x3144, "M", "ᄡ"),
+        (0x3145, "M", "ᄉ"),
+        (0x3146, "M", "ᄊ"),
+        (0x3147, "M", "ᄋ"),
+        (0x3148, "M", "ᄌ"),
+        (0x3149, "M", "ᄍ"),
+        (0x314A, "M", "ᄎ"),
+        (0x314B, "M", "ᄏ"),
+        (0x314C, "M", "ᄐ"),
+        (0x314D, "M", "ᄑ"),
+        (0x314E, "M", "ᄒ"),
+        (0x314F, "M", "ᅡ"),
+        (0x3150, "M", "ᅢ"),
+        (0x3151, "M", "ᅣ"),
+        (0x3152, "M", "ᅤ"),
+        (0x3153, "M", "ᅥ"),
+        (0x3154, "M", "ᅦ"),
+        (0x3155, "M", "ᅧ"),
+        (0x3156, "M", "ᅨ"),
+        (0x3157, "M", "ᅩ"),
+        (0x3158, "M", "ᅪ"),
+        (0x3159, "M", "ᅫ"),
+        (0x315A, "M", "ᅬ"),
+        (0x315B, "M", "ᅭ"),
+        (0x315C, "M", "ᅮ"),
+        (0x315D, "M", "ᅯ"),
+        (0x315E, "M", "ᅰ"),
+        (0x315F, "M", "ᅱ"),
+        (0x3160, "M", "ᅲ"),
+        (0x3161, "M", "ᅳ"),
+        (0x3162, "M", "ᅴ"),
+        (0x3163, "M", "ᅵ"),
+        (0x3164, "X"),
+        (0x3165, "M", "ᄔ"),
+        (0x3166, "M", "ᄕ"),
+        (0x3167, "M", "ᇇ"),
+        (0x3168, "M", "ᇈ"),
+        (0x3169, "M", "ᇌ"),
+        (0x316A, "M", "ᇎ"),
+        (0x316B, "M", "ᇓ"),
+        (0x316C, "M", "ᇗ"),
+        (0x316D, "M", "ᇙ"),
+        (0x316E, "M", "ᄜ"),
+        (0x316F, "M", "ᇝ"),
+        (0x3170, "M", "ᇟ"),
+        (0x3171, "M", "ᄝ"),
+        (0x3172, "M", "ᄞ"),
+        (0x3173, "M", "ᄠ"),
+        (0x3174, "M", "ᄢ"),
+        (0x3175, "M", "ᄣ"),
+        (0x3176, "M", "ᄧ"),
+        (0x3177, "M", "ᄩ"),
+        (0x3178, "M", "ᄫ"),
+        (0x3179, "M", "ᄬ"),
+        (0x317A, "M", "ᄭ"),
+        (0x317B, "M", "ᄮ"),
+        (0x317C, "M", "ᄯ"),
+        (0x317D, "M", "ᄲ"),
+        (0x317E, "M", "ᄶ"),
+        (0x317F, "M", "ᅀ"),
+        (0x3180, "M", "ᅇ"),
+        (0x3181, "M", "ᅌ"),
+        (0x3182, "M", "ᇱ"),
+        (0x3183, "M", "ᇲ"),
+        (0x3184, "M", "ᅗ"),
+        (0x3185, "M", "ᅘ"),
+        (0x3186, "M", "ᅙ"),
+        (0x3187, "M", "ᆄ"),
+        (0x3188, "M", "ᆅ"),
     ]
 
+
 def _seg_30() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x3189, 'M', 'ᆈ'),
-    (0x318A, 'M', 'ᆑ'),
-    (0x318B, 'M', 'ᆒ'),
-    (0x318C, 'M', 'ᆔ'),
-    (0x318D, 'M', 'ᆞ'),
-    (0x318E, 'M', 'ᆡ'),
-    (0x318F, 'X'),
-    (0x3190, 'V'),
-    (0x3192, 'M', '一'),
-    (0x3193, 'M', '二'),
-    (0x3194, 'M', '三'),
-    (0x3195, 'M', '四'),
-    (0x3196, 'M', '上'),
-    (0x3197, 'M', '中'),
-    (0x3198, 'M', '下'),
-    (0x3199, 'M', '甲'),
-    (0x319A, 'M', '乙'),
-    (0x319B, 'M', '丙'),
-    (0x319C, 'M', '丁'),
-    (0x319D, 'M', '天'),
-    (0x319E, 'M', '地'),
-    (0x319F, 'M', '人'),
-    (0x31A0, 'V'),
-    (0x31E4, 'X'),
-    (0x31F0, 'V'),
-    (0x3200, '3', '(ᄀ)'),
-    (0x3201, '3', '(ᄂ)'),
-    (0x3202, '3', '(ᄃ)'),
-    (0x3203, '3', '(ᄅ)'),
-    (0x3204, '3', '(ᄆ)'),
-    (0x3205, '3', '(ᄇ)'),
-    (0x3206, '3', '(ᄉ)'),
-    (0x3207, '3', '(ᄋ)'),
-    (0x3208, '3', '(ᄌ)'),
-    (0x3209, '3', '(ᄎ)'),
-    (0x320A, '3', '(ᄏ)'),
-    (0x320B, '3', '(ᄐ)'),
-    (0x320C, '3', '(ᄑ)'),
-    (0x320D, '3', '(ᄒ)'),
-    (0x320E, '3', '(가)'),
-    (0x320F, '3', '(나)'),
-    (0x3210, '3', '(다)'),
-    (0x3211, '3', '(라)'),
-    (0x3212, '3', '(마)'),
-    (0x3213, '3', '(바)'),
-    (0x3214, '3', '(사)'),
-    (0x3215, '3', '(아)'),
-    (0x3216, '3', '(자)'),
-    (0x3217, '3', '(차)'),
-    (0x3218, '3', '(카)'),
-    (0x3219, '3', '(타)'),
-    (0x321A, '3', '(파)'),
-    (0x321B, '3', '(하)'),
-    (0x321C, '3', '(주)'),
-    (0x321D, '3', '(오전)'),
-    (0x321E, '3', '(오후)'),
-    (0x321F, 'X'),
-    (0x3220, '3', '(一)'),
-    (0x3221, '3', '(二)'),
-    (0x3222, '3', '(三)'),
-    (0x3223, '3', '(四)'),
-    (0x3224, '3', '(五)'),
-    (0x3225, '3', '(六)'),
-    (0x3226, '3', '(七)'),
-    (0x3227, '3', '(八)'),
-    (0x3228, '3', '(九)'),
-    (0x3229, '3', '(十)'),
-    (0x322A, '3', '(月)'),
-    (0x322B, '3', '(火)'),
-    (0x322C, '3', '(水)'),
-    (0x322D, '3', '(木)'),
-    (0x322E, '3', '(金)'),
-    (0x322F, '3', '(土)'),
-    (0x3230, '3', '(日)'),
-    (0x3231, '3', '(株)'),
-    (0x3232, '3', '(有)'),
-    (0x3233, '3', '(社)'),
-    (0x3234, '3', '(名)'),
-    (0x3235, '3', '(特)'),
-    (0x3236, '3', '(財)'),
-    (0x3237, '3', '(祝)'),
-    (0x3238, '3', '(労)'),
-    (0x3239, '3', '(代)'),
-    (0x323A, '3', '(呼)'),
-    (0x323B, '3', '(学)'),
-    (0x323C, '3', '(監)'),
-    (0x323D, '3', '(企)'),
-    (0x323E, '3', '(資)'),
-    (0x323F, '3', '(協)'),
-    (0x3240, '3', '(祭)'),
-    (0x3241, '3', '(休)'),
-    (0x3242, '3', '(自)'),
-    (0x3243, '3', '(至)'),
-    (0x3244, 'M', '問'),
-    (0x3245, 'M', '幼'),
-    (0x3246, 'M', '文'),
-    (0x3247, 'M', '箏'),
-    (0x3248, 'V'),
-    (0x3250, 'M', 'pte'),
-    (0x3251, 'M', '21'),
+        (0x3189, "M", "ᆈ"),
+        (0x318A, "M", "ᆑ"),
+        (0x318B, "M", "ᆒ"),
+        (0x318C, "M", "ᆔ"),
+        (0x318D, "M", "ᆞ"),
+        (0x318E, "M", "ᆡ"),
+        (0x318F, "X"),
+        (0x3190, "V"),
+        (0x3192, "M", "一"),
+        (0x3193, "M", "二"),
+        (0x3194, "M", "三"),
+        (0x3195, "M", "四"),
+        (0x3196, "M", "上"),
+        (0x3197, "M", "中"),
+        (0x3198, "M", "下"),
+        (0x3199, "M", "甲"),
+        (0x319A, "M", "乙"),
+        (0x319B, "M", "丙"),
+        (0x319C, "M", "丁"),
+        (0x319D, "M", "天"),
+        (0x319E, "M", "地"),
+        (0x319F, "M", "人"),
+        (0x31A0, "V"),
+        (0x31E4, "X"),
+        (0x31F0, "V"),
+        (0x3200, "3", "(ᄀ)"),
+        (0x3201, "3", "(ᄂ)"),
+        (0x3202, "3", "(ᄃ)"),
+        (0x3203, "3", "(ᄅ)"),
+        (0x3204, "3", "(ᄆ)"),
+        (0x3205, "3", "(ᄇ)"),
+        (0x3206, "3", "(ᄉ)"),
+        (0x3207, "3", "(ᄋ)"),
+        (0x3208, "3", "(ᄌ)"),
+        (0x3209, "3", "(ᄎ)"),
+        (0x320A, "3", "(ᄏ)"),
+        (0x320B, "3", "(ᄐ)"),
+        (0x320C, "3", "(ᄑ)"),
+        (0x320D, "3", "(ᄒ)"),
+        (0x320E, "3", "(가)"),
+        (0x320F, "3", "(나)"),
+        (0x3210, "3", "(다)"),
+        (0x3211, "3", "(라)"),
+        (0x3212, "3", "(마)"),
+        (0x3213, "3", "(바)"),
+        (0x3214, "3", "(사)"),
+        (0x3215, "3", "(아)"),
+        (0x3216, "3", "(자)"),
+        (0x3217, "3", "(차)"),
+        (0x3218, "3", "(카)"),
+        (0x3219, "3", "(타)"),
+        (0x321A, "3", "(파)"),
+        (0x321B, "3", "(하)"),
+        (0x321C, "3", "(주)"),
+        (0x321D, "3", "(오전)"),
+        (0x321E, "3", "(오후)"),
+        (0x321F, "X"),
+        (0x3220, "3", "(一)"),
+        (0x3221, "3", "(二)"),
+        (0x3222, "3", "(三)"),
+        (0x3223, "3", "(四)"),
+        (0x3224, "3", "(五)"),
+        (0x3225, "3", "(六)"),
+        (0x3226, "3", "(七)"),
+        (0x3227, "3", "(八)"),
+        (0x3228, "3", "(九)"),
+        (0x3229, "3", "(十)"),
+        (0x322A, "3", "(月)"),
+        (0x322B, "3", "(火)"),
+        (0x322C, "3", "(水)"),
+        (0x322D, "3", "(木)"),
+        (0x322E, "3", "(金)"),
+        (0x322F, "3", "(土)"),
+        (0x3230, "3", "(日)"),
+        (0x3231, "3", "(株)"),
+        (0x3232, "3", "(有)"),
+        (0x3233, "3", "(社)"),
+        (0x3234, "3", "(名)"),
+        (0x3235, "3", "(特)"),
+        (0x3236, "3", "(財)"),
+        (0x3237, "3", "(祝)"),
+        (0x3238, "3", "(労)"),
+        (0x3239, "3", "(代)"),
+        (0x323A, "3", "(呼)"),
+        (0x323B, "3", "(学)"),
+        (0x323C, "3", "(監)"),
+        (0x323D, "3", "(企)"),
+        (0x323E, "3", "(資)"),
+        (0x323F, "3", "(協)"),
+        (0x3240, "3", "(祭)"),
+        (0x3241, "3", "(休)"),
+        (0x3242, "3", "(自)"),
+        (0x3243, "3", "(至)"),
+        (0x3244, "M", "問"),
+        (0x3245, "M", "幼"),
+        (0x3246, "M", "文"),
+        (0x3247, "M", "箏"),
+        (0x3248, "V"),
+        (0x3250, "M", "pte"),
+        (0x3251, "M", "21"),
     ]
 
+
 def _seg_31() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x3252, 'M', '22'),
-    (0x3253, 'M', '23'),
-    (0x3254, 'M', '24'),
-    (0x3255, 'M', '25'),
-    (0x3256, 'M', '26'),
-    (0x3257, 'M', '27'),
-    (0x3258, 'M', '28'),
-    (0x3259, 'M', '29'),
-    (0x325A, 'M', '30'),
-    (0x325B, 'M', '31'),
-    (0x325C, 'M', '32'),
-    (0x325D, 'M', '33'),
-    (0x325E, 'M', '34'),
-    (0x325F, 'M', '35'),
-    (0x3260, 'M', 'ᄀ'),
-    (0x3261, 'M', 'ᄂ'),
-    (0x3262, 'M', 'ᄃ'),
-    (0x3263, 'M', 'ᄅ'),
-    (0x3264, 'M', 'ᄆ'),
-    (0x3265, 'M', 'ᄇ'),
-    (0x3266, 'M', 'ᄉ'),
-    (0x3267, 'M', 'ᄋ'),
-    (0x3268, 'M', 'ᄌ'),
-    (0x3269, 'M', 'ᄎ'),
-    (0x326A, 'M', 'ᄏ'),
-    (0x326B, 'M', 'ᄐ'),
-    (0x326C, 'M', 'ᄑ'),
-    (0x326D, 'M', 'ᄒ'),
-    (0x326E, 'M', '가'),
-    (0x326F, 'M', '나'),
-    (0x3270, 'M', '다'),
-    (0x3271, 'M', '라'),
-    (0x3272, 'M', '마'),
-    (0x3273, 'M', '바'),
-    (0x3274, 'M', '사'),
-    (0x3275, 'M', '아'),
-    (0x3276, 'M', '자'),
-    (0x3277, 'M', '차'),
-    (0x3278, 'M', '카'),
-    (0x3279, 'M', '타'),
-    (0x327A, 'M', '파'),
-    (0x327B, 'M', '하'),
-    (0x327C, 'M', '참고'),
-    (0x327D, 'M', '주의'),
-    (0x327E, 'M', '우'),
-    (0x327F, 'V'),
-    (0x3280, 'M', '一'),
-    (0x3281, 'M', '二'),
-    (0x3282, 'M', '三'),
-    (0x3283, 'M', '四'),
-    (0x3284, 'M', '五'),
-    (0x3285, 'M', '六'),
-    (0x3286, 'M', '七'),
-    (0x3287, 'M', '八'),
-    (0x3288, 'M', '九'),
-    (0x3289, 'M', '十'),
-    (0x328A, 'M', '月'),
-    (0x328B, 'M', '火'),
-    (0x328C, 'M', '水'),
-    (0x328D, 'M', '木'),
-    (0x328E, 'M', '金'),
-    (0x328F, 'M', '土'),
-    (0x3290, 'M', '日'),
-    (0x3291, 'M', '株'),
-    (0x3292, 'M', '有'),
-    (0x3293, 'M', '社'),
-    (0x3294, 'M', '名'),
-    (0x3295, 'M', '特'),
-    (0x3296, 'M', '財'),
-    (0x3297, 'M', '祝'),
-    (0x3298, 'M', '労'),
-    (0x3299, 'M', '秘'),
-    (0x329A, 'M', '男'),
-    (0x329B, 'M', '女'),
-    (0x329C, 'M', '適'),
-    (0x329D, 'M', '優'),
-    (0x329E, 'M', '印'),
-    (0x329F, 'M', '注'),
-    (0x32A0, 'M', '項'),
-    (0x32A1, 'M', '休'),
-    (0x32A2, 'M', '写'),
-    (0x32A3, 'M', '正'),
-    (0x32A4, 'M', '上'),
-    (0x32A5, 'M', '中'),
-    (0x32A6, 'M', '下'),
-    (0x32A7, 'M', '左'),
-    (0x32A8, 'M', '右'),
-    (0x32A9, 'M', '医'),
-    (0x32AA, 'M', '宗'),
-    (0x32AB, 'M', '学'),
-    (0x32AC, 'M', '監'),
-    (0x32AD, 'M', '企'),
-    (0x32AE, 'M', '資'),
-    (0x32AF, 'M', '協'),
-    (0x32B0, 'M', '夜'),
-    (0x32B1, 'M', '36'),
-    (0x32B2, 'M', '37'),
-    (0x32B3, 'M', '38'),
-    (0x32B4, 'M', '39'),
-    (0x32B5, 'M', '40'),
+        (0x3252, "M", "22"),
+        (0x3253, "M", "23"),
+        (0x3254, "M", "24"),
+        (0x3255, "M", "25"),
+        (0x3256, "M", "26"),
+        (0x3257, "M", "27"),
+        (0x3258, "M", "28"),
+        (0x3259, "M", "29"),
+        (0x325A, "M", "30"),
+        (0x325B, "M", "31"),
+        (0x325C, "M", "32"),
+        (0x325D, "M", "33"),
+        (0x325E, "M", "34"),
+        (0x325F, "M", "35"),
+        (0x3260, "M", "ᄀ"),
+        (0x3261, "M", "ᄂ"),
+        (0x3262, "M", "ᄃ"),
+        (0x3263, "M", "ᄅ"),
+        (0x3264, "M", "ᄆ"),
+        (0x3265, "M", "ᄇ"),
+        (0x3266, "M", "ᄉ"),
+        (0x3267, "M", "ᄋ"),
+        (0x3268, "M", "ᄌ"),
+        (0x3269, "M", "ᄎ"),
+        (0x326A, "M", "ᄏ"),
+        (0x326B, "M", "ᄐ"),
+        (0x326C, "M", "ᄑ"),
+        (0x326D, "M", "ᄒ"),
+        (0x326E, "M", "가"),
+        (0x326F, "M", "나"),
+        (0x3270, "M", "다"),
+        (0x3271, "M", "라"),
+        (0x3272, "M", "마"),
+        (0x3273, "M", "바"),
+        (0x3274, "M", "사"),
+        (0x3275, "M", "아"),
+        (0x3276, "M", "자"),
+        (0x3277, "M", "차"),
+        (0x3278, "M", "카"),
+        (0x3279, "M", "타"),
+        (0x327A, "M", "파"),
+        (0x327B, "M", "하"),
+        (0x327C, "M", "참고"),
+        (0x327D, "M", "주의"),
+        (0x327E, "M", "우"),
+        (0x327F, "V"),
+        (0x3280, "M", "一"),
+        (0x3281, "M", "二"),
+        (0x3282, "M", "三"),
+        (0x3283, "M", "四"),
+        (0x3284, "M", "五"),
+        (0x3285, "M", "六"),
+        (0x3286, "M", "七"),
+        (0x3287, "M", "八"),
+        (0x3288, "M", "九"),
+        (0x3289, "M", "十"),
+        (0x328A, "M", "月"),
+        (0x328B, "M", "火"),
+        (0x328C, "M", "水"),
+        (0x328D, "M", "木"),
+        (0x328E, "M", "金"),
+        (0x328F, "M", "土"),
+        (0x3290, "M", "日"),
+        (0x3291, "M", "株"),
+        (0x3292, "M", "有"),
+        (0x3293, "M", "社"),
+        (0x3294, "M", "名"),
+        (0x3295, "M", "特"),
+        (0x3296, "M", "財"),
+        (0x3297, "M", "祝"),
+        (0x3298, "M", "労"),
+        (0x3299, "M", "秘"),
+        (0x329A, "M", "男"),
+        (0x329B, "M", "女"),
+        (0x329C, "M", "適"),
+        (0x329D, "M", "優"),
+        (0x329E, "M", "印"),
+        (0x329F, "M", "注"),
+        (0x32A0, "M", "項"),
+        (0x32A1, "M", "休"),
+        (0x32A2, "M", "写"),
+        (0x32A3, "M", "正"),
+        (0x32A4, "M", "上"),
+        (0x32A5, "M", "中"),
+        (0x32A6, "M", "下"),
+        (0x32A7, "M", "左"),
+        (0x32A8, "M", "右"),
+        (0x32A9, "M", "医"),
+        (0x32AA, "M", "宗"),
+        (0x32AB, "M", "学"),
+        (0x32AC, "M", "監"),
+        (0x32AD, "M", "企"),
+        (0x32AE, "M", "資"),
+        (0x32AF, "M", "協"),
+        (0x32B0, "M", "夜"),
+        (0x32B1, "M", "36"),
+        (0x32B2, "M", "37"),
+        (0x32B3, "M", "38"),
+        (0x32B4, "M", "39"),
+        (0x32B5, "M", "40"),
     ]
 
+
 def _seg_32() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x32B6, 'M', '41'),
-    (0x32B7, 'M', '42'),
-    (0x32B8, 'M', '43'),
-    (0x32B9, 'M', '44'),
-    (0x32BA, 'M', '45'),
-    (0x32BB, 'M', '46'),
-    (0x32BC, 'M', '47'),
-    (0x32BD, 'M', '48'),
-    (0x32BE, 'M', '49'),
-    (0x32BF, 'M', '50'),
-    (0x32C0, 'M', '1月'),
-    (0x32C1, 'M', '2月'),
-    (0x32C2, 'M', '3月'),
-    (0x32C3, 'M', '4月'),
-    (0x32C4, 'M', '5月'),
-    (0x32C5, 'M', '6月'),
-    (0x32C6, 'M', '7月'),
-    (0x32C7, 'M', '8月'),
-    (0x32C8, 'M', '9月'),
-    (0x32C9, 'M', '10月'),
-    (0x32CA, 'M', '11月'),
-    (0x32CB, 'M', '12月'),
-    (0x32CC, 'M', 'hg'),
-    (0x32CD, 'M', 'erg'),
-    (0x32CE, 'M', 'ev'),
-    (0x32CF, 'M', 'ltd'),
-    (0x32D0, 'M', 'ア'),
-    (0x32D1, 'M', 'イ'),
-    (0x32D2, 'M', 'ウ'),
-    (0x32D3, 'M', 'エ'),
-    (0x32D4, 'M', 'オ'),
-    (0x32D5, 'M', 'カ'),
-    (0x32D6, 'M', 'キ'),
-    (0x32D7, 'M', 'ク'),
-    (0x32D8, 'M', 'ケ'),
-    (0x32D9, 'M', 'コ'),
-    (0x32DA, 'M', 'サ'),
-    (0x32DB, 'M', 'シ'),
-    (0x32DC, 'M', 'ス'),
-    (0x32DD, 'M', 'セ'),
-    (0x32DE, 'M', 'ソ'),
-    (0x32DF, 'M', 'タ'),
-    (0x32E0, 'M', 'チ'),
-    (0x32E1, 'M', 'ツ'),
-    (0x32E2, 'M', 'テ'),
-    (0x32E3, 'M', 'ト'),
-    (0x32E4, 'M', 'ナ'),
-    (0x32E5, 'M', 'ニ'),
-    (0x32E6, 'M', 'ヌ'),
-    (0x32E7, 'M', 'ネ'),
-    (0x32E8, 'M', 'ノ'),
-    (0x32E9, 'M', 'ハ'),
-    (0x32EA, 'M', 'ヒ'),
-    (0x32EB, 'M', 'フ'),
-    (0x32EC, 'M', 'ヘ'),
-    (0x32ED, 'M', 'ホ'),
-    (0x32EE, 'M', 'マ'),
-    (0x32EF, 'M', 'ミ'),
-    (0x32F0, 'M', 'ム'),
-    (0x32F1, 'M', 'メ'),
-    (0x32F2, 'M', 'モ'),
-    (0x32F3, 'M', 'ヤ'),
-    (0x32F4, 'M', 'ユ'),
-    (0x32F5, 'M', 'ヨ'),
-    (0x32F6, 'M', 'ラ'),
-    (0x32F7, 'M', 'リ'),
-    (0x32F8, 'M', 'ル'),
-    (0x32F9, 'M', 'レ'),
-    (0x32FA, 'M', 'ロ'),
-    (0x32FB, 'M', 'ワ'),
-    (0x32FC, 'M', 'ヰ'),
-    (0x32FD, 'M', 'ヱ'),
-    (0x32FE, 'M', 'ヲ'),
-    (0x32FF, 'M', '令和'),
-    (0x3300, 'M', 'アパート'),
-    (0x3301, 'M', 'アルファ'),
-    (0x3302, 'M', 'アンペア'),
-    (0x3303, 'M', 'アール'),
-    (0x3304, 'M', 'イニング'),
-    (0x3305, 'M', 'インチ'),
-    (0x3306, 'M', 'ウォン'),
-    (0x3307, 'M', 'エスクード'),
-    (0x3308, 'M', 'エーカー'),
-    (0x3309, 'M', 'オンス'),
-    (0x330A, 'M', 'オーム'),
-    (0x330B, 'M', 'カイリ'),
-    (0x330C, 'M', 'カラット'),
-    (0x330D, 'M', 'カロリー'),
-    (0x330E, 'M', 'ガロン'),
-    (0x330F, 'M', 'ガンマ'),
-    (0x3310, 'M', 'ギガ'),
-    (0x3311, 'M', 'ギニー'),
-    (0x3312, 'M', 'キュリー'),
-    (0x3313, 'M', 'ギルダー'),
-    (0x3314, 'M', 'キロ'),
-    (0x3315, 'M', 'キログラム'),
-    (0x3316, 'M', 'キロメートル'),
-    (0x3317, 'M', 'キロワット'),
-    (0x3318, 'M', 'グラム'),
-    (0x3319, 'M', 'グラムトン'),
+        (0x32B6, "M", "41"),
+        (0x32B7, "M", "42"),
+        (0x32B8, "M", "43"),
+        (0x32B9, "M", "44"),
+        (0x32BA, "M", "45"),
+        (0x32BB, "M", "46"),
+        (0x32BC, "M", "47"),
+        (0x32BD, "M", "48"),
+        (0x32BE, "M", "49"),
+        (0x32BF, "M", "50"),
+        (0x32C0, "M", "1月"),
+        (0x32C1, "M", "2月"),
+        (0x32C2, "M", "3月"),
+        (0x32C3, "M", "4月"),
+        (0x32C4, "M", "5月"),
+        (0x32C5, "M", "6月"),
+        (0x32C6, "M", "7月"),
+        (0x32C7, "M", "8月"),
+        (0x32C8, "M", "9月"),
+        (0x32C9, "M", "10月"),
+        (0x32CA, "M", "11月"),
+        (0x32CB, "M", "12月"),
+        (0x32CC, "M", "hg"),
+        (0x32CD, "M", "erg"),
+        (0x32CE, "M", "ev"),
+        (0x32CF, "M", "ltd"),
+        (0x32D0, "M", "ア"),
+        (0x32D1, "M", "イ"),
+        (0x32D2, "M", "ウ"),
+        (0x32D3, "M", "エ"),
+        (0x32D4, "M", "オ"),
+        (0x32D5, "M", "カ"),
+        (0x32D6, "M", "キ"),
+        (0x32D7, "M", "ク"),
+        (0x32D8, "M", "ケ"),
+        (0x32D9, "M", "コ"),
+        (0x32DA, "M", "サ"),
+        (0x32DB, "M", "シ"),
+        (0x32DC, "M", "ス"),
+        (0x32DD, "M", "セ"),
+        (0x32DE, "M", "ソ"),
+        (0x32DF, "M", "タ"),
+        (0x32E0, "M", "チ"),
+        (0x32E1, "M", "ツ"),
+        (0x32E2, "M", "テ"),
+        (0x32E3, "M", "ト"),
+        (0x32E4, "M", "ナ"),
+        (0x32E5, "M", "ニ"),
+        (0x32E6, "M", "ヌ"),
+        (0x32E7, "M", "ネ"),
+        (0x32E8, "M", "ノ"),
+        (0x32E9, "M", "ハ"),
+        (0x32EA, "M", "ヒ"),
+        (0x32EB, "M", "フ"),
+        (0x32EC, "M", "ヘ"),
+        (0x32ED, "M", "ホ"),
+        (0x32EE, "M", "マ"),
+        (0x32EF, "M", "ミ"),
+        (0x32F0, "M", "ム"),
+        (0x32F1, "M", "メ"),
+        (0x32F2, "M", "モ"),
+        (0x32F3, "M", "ヤ"),
+        (0x32F4, "M", "ユ"),
+        (0x32F5, "M", "ヨ"),
+        (0x32F6, "M", "ラ"),
+        (0x32F7, "M", "リ"),
+        (0x32F8, "M", "ル"),
+        (0x32F9, "M", "レ"),
+        (0x32FA, "M", "ロ"),
+        (0x32FB, "M", "ワ"),
+        (0x32FC, "M", "ヰ"),
+        (0x32FD, "M", "ヱ"),
+        (0x32FE, "M", "ヲ"),
+        (0x32FF, "M", "令和"),
+        (0x3300, "M", "アパート"),
+        (0x3301, "M", "アルファ"),
+        (0x3302, "M", "アンペア"),
+        (0x3303, "M", "アール"),
+        (0x3304, "M", "イニング"),
+        (0x3305, "M", "インチ"),
+        (0x3306, "M", "ウォン"),
+        (0x3307, "M", "エスクード"),
+        (0x3308, "M", "エーカー"),
+        (0x3309, "M", "オンス"),
+        (0x330A, "M", "オーム"),
+        (0x330B, "M", "カイリ"),
+        (0x330C, "M", "カラット"),
+        (0x330D, "M", "カロリー"),
+        (0x330E, "M", "ガロン"),
+        (0x330F, "M", "ガンマ"),
+        (0x3310, "M", "ギガ"),
+        (0x3311, "M", "ギニー"),
+        (0x3312, "M", "キュリー"),
+        (0x3313, "M", "ギルダー"),
+        (0x3314, "M", "キロ"),
+        (0x3315, "M", "キログラム"),
+        (0x3316, "M", "キロメートル"),
+        (0x3317, "M", "キロワット"),
+        (0x3318, "M", "グラム"),
+        (0x3319, "M", "グラムトン"),
     ]
 
+
 def _seg_33() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x331A, 'M', 'クルゼイロ'),
-    (0x331B, 'M', 'クローネ'),
-    (0x331C, 'M', 'ケース'),
-    (0x331D, 'M', 'コルナ'),
-    (0x331E, 'M', 'コーポ'),
-    (0x331F, 'M', 'サイクル'),
-    (0x3320, 'M', 'サンチーム'),
-    (0x3321, 'M', 'シリング'),
-    (0x3322, 'M', 'センチ'),
-    (0x3323, 'M', 'セント'),
-    (0x3324, 'M', 'ダース'),
-    (0x3325, 'M', 'デシ'),
-    (0x3326, 'M', 'ドル'),
-    (0x3327, 'M', 'トン'),
-    (0x3328, 'M', 'ナノ'),
-    (0x3329, 'M', 'ノット'),
-    (0x332A, 'M', 'ハイツ'),
-    (0x332B, 'M', 'パーセント'),
-    (0x332C, 'M', 'パーツ'),
-    (0x332D, 'M', 'バーレル'),
-    (0x332E, 'M', 'ピアストル'),
-    (0x332F, 'M', 'ピクル'),
-    (0x3330, 'M', 'ピコ'),
-    (0x3331, 'M', 'ビル'),
-    (0x3332, 'M', 'ファラッド'),
-    (0x3333, 'M', 'フィート'),
-    (0x3334, 'M', 'ブッシェル'),
-    (0x3335, 'M', 'フラン'),
-    (0x3336, 'M', 'ヘクタール'),
-    (0x3337, 'M', 'ペソ'),
-    (0x3338, 'M', 'ペニヒ'),
-    (0x3339, 'M', 'ヘルツ'),
-    (0x333A, 'M', 'ペンス'),
-    (0x333B, 'M', 'ページ'),
-    (0x333C, 'M', 'ベータ'),
-    (0x333D, 'M', 'ポイント'),
-    (0x333E, 'M', 'ボルト'),
-    (0x333F, 'M', 'ホン'),
-    (0x3340, 'M', 'ポンド'),
-    (0x3341, 'M', 'ホール'),
-    (0x3342, 'M', 'ホーン'),
-    (0x3343, 'M', 'マイクロ'),
-    (0x3344, 'M', 'マイル'),
-    (0x3345, 'M', 'マッハ'),
-    (0x3346, 'M', 'マルク'),
-    (0x3347, 'M', 'マンション'),
-    (0x3348, 'M', 'ミクロン'),
-    (0x3349, 'M', 'ミリ'),
-    (0x334A, 'M', 'ミリバール'),
-    (0x334B, 'M', 'メガ'),
-    (0x334C, 'M', 'メガトン'),
-    (0x334D, 'M', 'メートル'),
-    (0x334E, 'M', 'ヤード'),
-    (0x334F, 'M', 'ヤール'),
-    (0x3350, 'M', 'ユアン'),
-    (0x3351, 'M', 'リットル'),
-    (0x3352, 'M', 'リラ'),
-    (0x3353, 'M', 'ルピー'),
-    (0x3354, 'M', 'ルーブル'),
-    (0x3355, 'M', 'レム'),
-    (0x3356, 'M', 'レントゲン'),
-    (0x3357, 'M', 'ワット'),
-    (0x3358, 'M', '0点'),
-    (0x3359, 'M', '1点'),
-    (0x335A, 'M', '2点'),
-    (0x335B, 'M', '3点'),
-    (0x335C, 'M', '4点'),
-    (0x335D, 'M', '5点'),
-    (0x335E, 'M', '6点'),
-    (0x335F, 'M', '7点'),
-    (0x3360, 'M', '8点'),
-    (0x3361, 'M', '9点'),
-    (0x3362, 'M', '10点'),
-    (0x3363, 'M', '11点'),
-    (0x3364, 'M', '12点'),
-    (0x3365, 'M', '13点'),
-    (0x3366, 'M', '14点'),
-    (0x3367, 'M', '15点'),
-    (0x3368, 'M', '16点'),
-    (0x3369, 'M', '17点'),
-    (0x336A, 'M', '18点'),
-    (0x336B, 'M', '19点'),
-    (0x336C, 'M', '20点'),
-    (0x336D, 'M', '21点'),
-    (0x336E, 'M', '22点'),
-    (0x336F, 'M', '23点'),
-    (0x3370, 'M', '24点'),
-    (0x3371, 'M', 'hpa'),
-    (0x3372, 'M', 'da'),
-    (0x3373, 'M', 'au'),
-    (0x3374, 'M', 'bar'),
-    (0x3375, 'M', 'ov'),
-    (0x3376, 'M', 'pc'),
-    (0x3377, 'M', 'dm'),
-    (0x3378, 'M', 'dm2'),
-    (0x3379, 'M', 'dm3'),
-    (0x337A, 'M', 'iu'),
-    (0x337B, 'M', '平成'),
-    (0x337C, 'M', '昭和'),
-    (0x337D, 'M', '大正'),
+        (0x331A, "M", "クルゼイロ"),
+        (0x331B, "M", "クローネ"),
+        (0x331C, "M", "ケース"),
+        (0x331D, "M", "コルナ"),
+        (0x331E, "M", "コーポ"),
+        (0x331F, "M", "サイクル"),
+        (0x3320, "M", "サンチーム"),
+        (0x3321, "M", "シリング"),
+        (0x3322, "M", "センチ"),
+        (0x3323, "M", "セント"),
+        (0x3324, "M", "ダース"),
+        (0x3325, "M", "デシ"),
+        (0x3326, "M", "ドル"),
+        (0x3327, "M", "トン"),
+        (0x3328, "M", "ナノ"),
+        (0x3329, "M", "ノット"),
+        (0x332A, "M", "ハイツ"),
+        (0x332B, "M", "パーセント"),
+        (0x332C, "M", "パーツ"),
+        (0x332D, "M", "バーレル"),
+        (0x332E, "M", "ピアストル"),
+        (0x332F, "M", "ピクル"),
+        (0x3330, "M", "ピコ"),
+        (0x3331, "M", "ビル"),
+        (0x3332, "M", "ファラッド"),
+        (0x3333, "M", "フィート"),
+        (0x3334, "M", "ブッシェル"),
+        (0x3335, "M", "フラン"),
+        (0x3336, "M", "ヘクタール"),
+        (0x3337, "M", "ペソ"),
+        (0x3338, "M", "ペニヒ"),
+        (0x3339, "M", "ヘルツ"),
+        (0x333A, "M", "ペンス"),
+        (0x333B, "M", "ページ"),
+        (0x333C, "M", "ベータ"),
+        (0x333D, "M", "ポイント"),
+        (0x333E, "M", "ボルト"),
+        (0x333F, "M", "ホン"),
+        (0x3340, "M", "ポンド"),
+        (0x3341, "M", "ホール"),
+        (0x3342, "M", "ホーン"),
+        (0x3343, "M", "マイクロ"),
+        (0x3344, "M", "マイル"),
+        (0x3345, "M", "マッハ"),
+        (0x3346, "M", "マルク"),
+        (0x3347, "M", "マンション"),
+        (0x3348, "M", "ミクロン"),
+        (0x3349, "M", "ミリ"),
+        (0x334A, "M", "ミリバール"),
+        (0x334B, "M", "メガ"),
+        (0x334C, "M", "メガトン"),
+        (0x334D, "M", "メートル"),
+        (0x334E, "M", "ヤード"),
+        (0x334F, "M", "ヤール"),
+        (0x3350, "M", "ユアン"),
+        (0x3351, "M", "リットル"),
+        (0x3352, "M", "リラ"),
+        (0x3353, "M", "ルピー"),
+        (0x3354, "M", "ルーブル"),
+        (0x3355, "M", "レム"),
+        (0x3356, "M", "レントゲン"),
+        (0x3357, "M", "ワット"),
+        (0x3358, "M", "0点"),
+        (0x3359, "M", "1点"),
+        (0x335A, "M", "2点"),
+        (0x335B, "M", "3点"),
+        (0x335C, "M", "4点"),
+        (0x335D, "M", "5点"),
+        (0x335E, "M", "6点"),
+        (0x335F, "M", "7点"),
+        (0x3360, "M", "8点"),
+        (0x3361, "M", "9点"),
+        (0x3362, "M", "10点"),
+        (0x3363, "M", "11点"),
+        (0x3364, "M", "12点"),
+        (0x3365, "M", "13点"),
+        (0x3366, "M", "14点"),
+        (0x3367, "M", "15点"),
+        (0x3368, "M", "16点"),
+        (0x3369, "M", "17点"),
+        (0x336A, "M", "18点"),
+        (0x336B, "M", "19点"),
+        (0x336C, "M", "20点"),
+        (0x336D, "M", "21点"),
+        (0x336E, "M", "22点"),
+        (0x336F, "M", "23点"),
+        (0x3370, "M", "24点"),
+        (0x3371, "M", "hpa"),
+        (0x3372, "M", "da"),
+        (0x3373, "M", "au"),
+        (0x3374, "M", "bar"),
+        (0x3375, "M", "ov"),
+        (0x3376, "M", "pc"),
+        (0x3377, "M", "dm"),
+        (0x3378, "M", "dm2"),
+        (0x3379, "M", "dm3"),
+        (0x337A, "M", "iu"),
+        (0x337B, "M", "平成"),
+        (0x337C, "M", "昭和"),
+        (0x337D, "M", "大正"),
     ]
 
+
 def _seg_34() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x337E, 'M', '明治'),
-    (0x337F, 'M', '株式会社'),
-    (0x3380, 'M', 'pa'),
-    (0x3381, 'M', 'na'),
-    (0x3382, 'M', 'μa'),
-    (0x3383, 'M', 'ma'),
-    (0x3384, 'M', 'ka'),
-    (0x3385, 'M', 'kb'),
-    (0x3386, 'M', 'mb'),
-    (0x3387, 'M', 'gb'),
-    (0x3388, 'M', 'cal'),
-    (0x3389, 'M', 'kcal'),
-    (0x338A, 'M', 'pf'),
-    (0x338B, 'M', 'nf'),
-    (0x338C, 'M', 'μf'),
-    (0x338D, 'M', 'μg'),
-    (0x338E, 'M', 'mg'),
-    (0x338F, 'M', 'kg'),
-    (0x3390, 'M', 'hz'),
-    (0x3391, 'M', 'khz'),
-    (0x3392, 'M', 'mhz'),
-    (0x3393, 'M', 'ghz'),
-    (0x3394, 'M', 'thz'),
-    (0x3395, 'M', 'μl'),
-    (0x3396, 'M', 'ml'),
-    (0x3397, 'M', 'dl'),
-    (0x3398, 'M', 'kl'),
-    (0x3399, 'M', 'fm'),
-    (0x339A, 'M', 'nm'),
-    (0x339B, 'M', 'μm'),
-    (0x339C, 'M', 'mm'),
-    (0x339D, 'M', 'cm'),
-    (0x339E, 'M', 'km'),
-    (0x339F, 'M', 'mm2'),
-    (0x33A0, 'M', 'cm2'),
-    (0x33A1, 'M', 'm2'),
-    (0x33A2, 'M', 'km2'),
-    (0x33A3, 'M', 'mm3'),
-    (0x33A4, 'M', 'cm3'),
-    (0x33A5, 'M', 'm3'),
-    (0x33A6, 'M', 'km3'),
-    (0x33A7, 'M', 'm∕s'),
-    (0x33A8, 'M', 'm∕s2'),
-    (0x33A9, 'M', 'pa'),
-    (0x33AA, 'M', 'kpa'),
-    (0x33AB, 'M', 'mpa'),
-    (0x33AC, 'M', 'gpa'),
-    (0x33AD, 'M', 'rad'),
-    (0x33AE, 'M', 'rad∕s'),
-    (0x33AF, 'M', 'rad∕s2'),
-    (0x33B0, 'M', 'ps'),
-    (0x33B1, 'M', 'ns'),
-    (0x33B2, 'M', 'μs'),
-    (0x33B3, 'M', 'ms'),
-    (0x33B4, 'M', 'pv'),
-    (0x33B5, 'M', 'nv'),
-    (0x33B6, 'M', 'μv'),
-    (0x33B7, 'M', 'mv'),
-    (0x33B8, 'M', 'kv'),
-    (0x33B9, 'M', 'mv'),
-    (0x33BA, 'M', 'pw'),
-    (0x33BB, 'M', 'nw'),
-    (0x33BC, 'M', 'μw'),
-    (0x33BD, 'M', 'mw'),
-    (0x33BE, 'M', 'kw'),
-    (0x33BF, 'M', 'mw'),
-    (0x33C0, 'M', 'kω'),
-    (0x33C1, 'M', 'mω'),
-    (0x33C2, 'X'),
-    (0x33C3, 'M', 'bq'),
-    (0x33C4, 'M', 'cc'),
-    (0x33C5, 'M', 'cd'),
-    (0x33C6, 'M', 'c∕kg'),
-    (0x33C7, 'X'),
-    (0x33C8, 'M', 'db'),
-    (0x33C9, 'M', 'gy'),
-    (0x33CA, 'M', 'ha'),
-    (0x33CB, 'M', 'hp'),
-    (0x33CC, 'M', 'in'),
-    (0x33CD, 'M', 'kk'),
-    (0x33CE, 'M', 'km'),
-    (0x33CF, 'M', 'kt'),
-    (0x33D0, 'M', 'lm'),
-    (0x33D1, 'M', 'ln'),
-    (0x33D2, 'M', 'log'),
-    (0x33D3, 'M', 'lx'),
-    (0x33D4, 'M', 'mb'),
-    (0x33D5, 'M', 'mil'),
-    (0x33D6, 'M', 'mol'),
-    (0x33D7, 'M', 'ph'),
-    (0x33D8, 'X'),
-    (0x33D9, 'M', 'ppm'),
-    (0x33DA, 'M', 'pr'),
-    (0x33DB, 'M', 'sr'),
-    (0x33DC, 'M', 'sv'),
-    (0x33DD, 'M', 'wb'),
-    (0x33DE, 'M', 'v∕m'),
-    (0x33DF, 'M', 'a∕m'),
-    (0x33E0, 'M', '1日'),
-    (0x33E1, 'M', '2日'),
+        (0x337E, "M", "明治"),
+        (0x337F, "M", "株式会社"),
+        (0x3380, "M", "pa"),
+        (0x3381, "M", "na"),
+        (0x3382, "M", "μa"),
+        (0x3383, "M", "ma"),
+        (0x3384, "M", "ka"),
+        (0x3385, "M", "kb"),
+        (0x3386, "M", "mb"),
+        (0x3387, "M", "gb"),
+        (0x3388, "M", "cal"),
+        (0x3389, "M", "kcal"),
+        (0x338A, "M", "pf"),
+        (0x338B, "M", "nf"),
+        (0x338C, "M", "μf"),
+        (0x338D, "M", "μg"),
+        (0x338E, "M", "mg"),
+        (0x338F, "M", "kg"),
+        (0x3390, "M", "hz"),
+        (0x3391, "M", "khz"),
+        (0x3392, "M", "mhz"),
+        (0x3393, "M", "ghz"),
+        (0x3394, "M", "thz"),
+        (0x3395, "M", "μl"),
+        (0x3396, "M", "ml"),
+        (0x3397, "M", "dl"),
+        (0x3398, "M", "kl"),
+        (0x3399, "M", "fm"),
+        (0x339A, "M", "nm"),
+        (0x339B, "M", "μm"),
+        (0x339C, "M", "mm"),
+        (0x339D, "M", "cm"),
+        (0x339E, "M", "km"),
+        (0x339F, "M", "mm2"),
+        (0x33A0, "M", "cm2"),
+        (0x33A1, "M", "m2"),
+        (0x33A2, "M", "km2"),
+        (0x33A3, "M", "mm3"),
+        (0x33A4, "M", "cm3"),
+        (0x33A5, "M", "m3"),
+        (0x33A6, "M", "km3"),
+        (0x33A7, "M", "m∕s"),
+        (0x33A8, "M", "m∕s2"),
+        (0x33A9, "M", "pa"),
+        (0x33AA, "M", "kpa"),
+        (0x33AB, "M", "mpa"),
+        (0x33AC, "M", "gpa"),
+        (0x33AD, "M", "rad"),
+        (0x33AE, "M", "rad∕s"),
+        (0x33AF, "M", "rad∕s2"),
+        (0x33B0, "M", "ps"),
+        (0x33B1, "M", "ns"),
+        (0x33B2, "M", "μs"),
+        (0x33B3, "M", "ms"),
+        (0x33B4, "M", "pv"),
+        (0x33B5, "M", "nv"),
+        (0x33B6, "M", "μv"),
+        (0x33B7, "M", "mv"),
+        (0x33B8, "M", "kv"),
+        (0x33B9, "M", "mv"),
+        (0x33BA, "M", "pw"),
+        (0x33BB, "M", "nw"),
+        (0x33BC, "M", "μw"),
+        (0x33BD, "M", "mw"),
+        (0x33BE, "M", "kw"),
+        (0x33BF, "M", "mw"),
+        (0x33C0, "M", "kω"),
+        (0x33C1, "M", "mω"),
+        (0x33C2, "X"),
+        (0x33C3, "M", "bq"),
+        (0x33C4, "M", "cc"),
+        (0x33C5, "M", "cd"),
+        (0x33C6, "M", "c∕kg"),
+        (0x33C7, "X"),
+        (0x33C8, "M", "db"),
+        (0x33C9, "M", "gy"),
+        (0x33CA, "M", "ha"),
+        (0x33CB, "M", "hp"),
+        (0x33CC, "M", "in"),
+        (0x33CD, "M", "kk"),
+        (0x33CE, "M", "km"),
+        (0x33CF, "M", "kt"),
+        (0x33D0, "M", "lm"),
+        (0x33D1, "M", "ln"),
+        (0x33D2, "M", "log"),
+        (0x33D3, "M", "lx"),
+        (0x33D4, "M", "mb"),
+        (0x33D5, "M", "mil"),
+        (0x33D6, "M", "mol"),
+        (0x33D7, "M", "ph"),
+        (0x33D8, "X"),
+        (0x33D9, "M", "ppm"),
+        (0x33DA, "M", "pr"),
+        (0x33DB, "M", "sr"),
+        (0x33DC, "M", "sv"),
+        (0x33DD, "M", "wb"),
+        (0x33DE, "M", "v∕m"),
+        (0x33DF, "M", "a∕m"),
+        (0x33E0, "M", "1日"),
+        (0x33E1, "M", "2日"),
     ]
 
+
 def _seg_35() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x33E2, 'M', '3日'),
-    (0x33E3, 'M', '4日'),
-    (0x33E4, 'M', '5日'),
-    (0x33E5, 'M', '6日'),
-    (0x33E6, 'M', '7日'),
-    (0x33E7, 'M', '8日'),
-    (0x33E8, 'M', '9日'),
-    (0x33E9, 'M', '10日'),
-    (0x33EA, 'M', '11日'),
-    (0x33EB, 'M', '12日'),
-    (0x33EC, 'M', '13日'),
-    (0x33ED, 'M', '14日'),
-    (0x33EE, 'M', '15日'),
-    (0x33EF, 'M', '16日'),
-    (0x33F0, 'M', '17日'),
-    (0x33F1, 'M', '18日'),
-    (0x33F2, 'M', '19日'),
-    (0x33F3, 'M', '20日'),
-    (0x33F4, 'M', '21日'),
-    (0x33F5, 'M', '22日'),
-    (0x33F6, 'M', '23日'),
-    (0x33F7, 'M', '24日'),
-    (0x33F8, 'M', '25日'),
-    (0x33F9, 'M', '26日'),
-    (0x33FA, 'M', '27日'),
-    (0x33FB, 'M', '28日'),
-    (0x33FC, 'M', '29日'),
-    (0x33FD, 'M', '30日'),
-    (0x33FE, 'M', '31日'),
-    (0x33FF, 'M', 'gal'),
-    (0x3400, 'V'),
-    (0xA48D, 'X'),
-    (0xA490, 'V'),
-    (0xA4C7, 'X'),
-    (0xA4D0, 'V'),
-    (0xA62C, 'X'),
-    (0xA640, 'M', 'ꙁ'),
-    (0xA641, 'V'),
-    (0xA642, 'M', 'ꙃ'),
-    (0xA643, 'V'),
-    (0xA644, 'M', 'ꙅ'),
-    (0xA645, 'V'),
-    (0xA646, 'M', 'ꙇ'),
-    (0xA647, 'V'),
-    (0xA648, 'M', 'ꙉ'),
-    (0xA649, 'V'),
-    (0xA64A, 'M', 'ꙋ'),
-    (0xA64B, 'V'),
-    (0xA64C, 'M', 'ꙍ'),
-    (0xA64D, 'V'),
-    (0xA64E, 'M', 'ꙏ'),
-    (0xA64F, 'V'),
-    (0xA650, 'M', 'ꙑ'),
-    (0xA651, 'V'),
-    (0xA652, 'M', 'ꙓ'),
-    (0xA653, 'V'),
-    (0xA654, 'M', 'ꙕ'),
-    (0xA655, 'V'),
-    (0xA656, 'M', 'ꙗ'),
-    (0xA657, 'V'),
-    (0xA658, 'M', 'ꙙ'),
-    (0xA659, 'V'),
-    (0xA65A, 'M', 'ꙛ'),
-    (0xA65B, 'V'),
-    (0xA65C, 'M', 'ꙝ'),
-    (0xA65D, 'V'),
-    (0xA65E, 'M', 'ꙟ'),
-    (0xA65F, 'V'),
-    (0xA660, 'M', 'ꙡ'),
-    (0xA661, 'V'),
-    (0xA662, 'M', 'ꙣ'),
-    (0xA663, 'V'),
-    (0xA664, 'M', 'ꙥ'),
-    (0xA665, 'V'),
-    (0xA666, 'M', 'ꙧ'),
-    (0xA667, 'V'),
-    (0xA668, 'M', 'ꙩ'),
-    (0xA669, 'V'),
-    (0xA66A, 'M', 'ꙫ'),
-    (0xA66B, 'V'),
-    (0xA66C, 'M', 'ꙭ'),
-    (0xA66D, 'V'),
-    (0xA680, 'M', 'ꚁ'),
-    (0xA681, 'V'),
-    (0xA682, 'M', 'ꚃ'),
-    (0xA683, 'V'),
-    (0xA684, 'M', 'ꚅ'),
-    (0xA685, 'V'),
-    (0xA686, 'M', 'ꚇ'),
-    (0xA687, 'V'),
-    (0xA688, 'M', 'ꚉ'),
-    (0xA689, 'V'),
-    (0xA68A, 'M', 'ꚋ'),
-    (0xA68B, 'V'),
-    (0xA68C, 'M', 'ꚍ'),
-    (0xA68D, 'V'),
-    (0xA68E, 'M', 'ꚏ'),
-    (0xA68F, 'V'),
-    (0xA690, 'M', 'ꚑ'),
-    (0xA691, 'V'),
+        (0x33E2, "M", "3日"),
+        (0x33E3, "M", "4日"),
+        (0x33E4, "M", "5日"),
+        (0x33E5, "M", "6日"),
+        (0x33E6, "M", "7日"),
+        (0x33E7, "M", "8日"),
+        (0x33E8, "M", "9日"),
+        (0x33E9, "M", "10日"),
+        (0x33EA, "M", "11日"),
+        (0x33EB, "M", "12日"),
+        (0x33EC, "M", "13日"),
+        (0x33ED, "M", "14日"),
+        (0x33EE, "M", "15日"),
+        (0x33EF, "M", "16日"),
+        (0x33F0, "M", "17日"),
+        (0x33F1, "M", "18日"),
+        (0x33F2, "M", "19日"),
+        (0x33F3, "M", "20日"),
+        (0x33F4, "M", "21日"),
+        (0x33F5, "M", "22日"),
+        (0x33F6, "M", "23日"),
+        (0x33F7, "M", "24日"),
+        (0x33F8, "M", "25日"),
+        (0x33F9, "M", "26日"),
+        (0x33FA, "M", "27日"),
+        (0x33FB, "M", "28日"),
+        (0x33FC, "M", "29日"),
+        (0x33FD, "M", "30日"),
+        (0x33FE, "M", "31日"),
+        (0x33FF, "M", "gal"),
+        (0x3400, "V"),
+        (0xA48D, "X"),
+        (0xA490, "V"),
+        (0xA4C7, "X"),
+        (0xA4D0, "V"),
+        (0xA62C, "X"),
+        (0xA640, "M", "ꙁ"),
+        (0xA641, "V"),
+        (0xA642, "M", "ꙃ"),
+        (0xA643, "V"),
+        (0xA644, "M", "ꙅ"),
+        (0xA645, "V"),
+        (0xA646, "M", "ꙇ"),
+        (0xA647, "V"),
+        (0xA648, "M", "ꙉ"),
+        (0xA649, "V"),
+        (0xA64A, "M", "ꙋ"),
+        (0xA64B, "V"),
+        (0xA64C, "M", "ꙍ"),
+        (0xA64D, "V"),
+        (0xA64E, "M", "ꙏ"),
+        (0xA64F, "V"),
+        (0xA650, "M", "ꙑ"),
+        (0xA651, "V"),
+        (0xA652, "M", "ꙓ"),
+        (0xA653, "V"),
+        (0xA654, "M", "ꙕ"),
+        (0xA655, "V"),
+        (0xA656, "M", "ꙗ"),
+        (0xA657, "V"),
+        (0xA658, "M", "ꙙ"),
+        (0xA659, "V"),
+        (0xA65A, "M", "ꙛ"),
+        (0xA65B, "V"),
+        (0xA65C, "M", "ꙝ"),
+        (0xA65D, "V"),
+        (0xA65E, "M", "ꙟ"),
+        (0xA65F, "V"),
+        (0xA660, "M", "ꙡ"),
+        (0xA661, "V"),
+        (0xA662, "M", "ꙣ"),
+        (0xA663, "V"),
+        (0xA664, "M", "ꙥ"),
+        (0xA665, "V"),
+        (0xA666, "M", "ꙧ"),
+        (0xA667, "V"),
+        (0xA668, "M", "ꙩ"),
+        (0xA669, "V"),
+        (0xA66A, "M", "ꙫ"),
+        (0xA66B, "V"),
+        (0xA66C, "M", "ꙭ"),
+        (0xA66D, "V"),
+        (0xA680, "M", "ꚁ"),
+        (0xA681, "V"),
+        (0xA682, "M", "ꚃ"),
+        (0xA683, "V"),
+        (0xA684, "M", "ꚅ"),
+        (0xA685, "V"),
+        (0xA686, "M", "ꚇ"),
+        (0xA687, "V"),
+        (0xA688, "M", "ꚉ"),
+        (0xA689, "V"),
+        (0xA68A, "M", "ꚋ"),
+        (0xA68B, "V"),
+        (0xA68C, "M", "ꚍ"),
+        (0xA68D, "V"),
+        (0xA68E, "M", "ꚏ"),
+        (0xA68F, "V"),
+        (0xA690, "M", "ꚑ"),
+        (0xA691, "V"),
     ]
 
+
 def _seg_36() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0xA692, 'M', 'ꚓ'),
-    (0xA693, 'V'),
-    (0xA694, 'M', 'ꚕ'),
-    (0xA695, 'V'),
-    (0xA696, 'M', 'ꚗ'),
-    (0xA697, 'V'),
-    (0xA698, 'M', 'ꚙ'),
-    (0xA699, 'V'),
-    (0xA69A, 'M', 'ꚛ'),
-    (0xA69B, 'V'),
-    (0xA69C, 'M', 'ъ'),
-    (0xA69D, 'M', 'ь'),
-    (0xA69E, 'V'),
-    (0xA6F8, 'X'),
-    (0xA700, 'V'),
-    (0xA722, 'M', 'ꜣ'),
-    (0xA723, 'V'),
-    (0xA724, 'M', 'ꜥ'),
-    (0xA725, 'V'),
-    (0xA726, 'M', 'ꜧ'),
-    (0xA727, 'V'),
-    (0xA728, 'M', 'ꜩ'),
-    (0xA729, 'V'),
-    (0xA72A, 'M', 'ꜫ'),
-    (0xA72B, 'V'),
-    (0xA72C, 'M', 'ꜭ'),
-    (0xA72D, 'V'),
-    (0xA72E, 'M', 'ꜯ'),
-    (0xA72F, 'V'),
-    (0xA732, 'M', 'ꜳ'),
-    (0xA733, 'V'),
-    (0xA734, 'M', 'ꜵ'),
-    (0xA735, 'V'),
-    (0xA736, 'M', 'ꜷ'),
-    (0xA737, 'V'),
-    (0xA738, 'M', 'ꜹ'),
-    (0xA739, 'V'),
-    (0xA73A, 'M', 'ꜻ'),
-    (0xA73B, 'V'),
-    (0xA73C, 'M', 'ꜽ'),
-    (0xA73D, 'V'),
-    (0xA73E, 'M', 'ꜿ'),
-    (0xA73F, 'V'),
-    (0xA740, 'M', 'ꝁ'),
-    (0xA741, 'V'),
-    (0xA742, 'M', 'ꝃ'),
-    (0xA743, 'V'),
-    (0xA744, 'M', 'ꝅ'),
-    (0xA745, 'V'),
-    (0xA746, 'M', 'ꝇ'),
-    (0xA747, 'V'),
-    (0xA748, 'M', 'ꝉ'),
-    (0xA749, 'V'),
-    (0xA74A, 'M', 'ꝋ'),
-    (0xA74B, 'V'),
-    (0xA74C, 'M', 'ꝍ'),
-    (0xA74D, 'V'),
-    (0xA74E, 'M', 'ꝏ'),
-    (0xA74F, 'V'),
-    (0xA750, 'M', 'ꝑ'),
-    (0xA751, 'V'),
-    (0xA752, 'M', 'ꝓ'),
-    (0xA753, 'V'),
-    (0xA754, 'M', 'ꝕ'),
-    (0xA755, 'V'),
-    (0xA756, 'M', 'ꝗ'),
-    (0xA757, 'V'),
-    (0xA758, 'M', 'ꝙ'),
-    (0xA759, 'V'),
-    (0xA75A, 'M', 'ꝛ'),
-    (0xA75B, 'V'),
-    (0xA75C, 'M', 'ꝝ'),
-    (0xA75D, 'V'),
-    (0xA75E, 'M', 'ꝟ'),
-    (0xA75F, 'V'),
-    (0xA760, 'M', 'ꝡ'),
-    (0xA761, 'V'),
-    (0xA762, 'M', 'ꝣ'),
-    (0xA763, 'V'),
-    (0xA764, 'M', 'ꝥ'),
-    (0xA765, 'V'),
-    (0xA766, 'M', 'ꝧ'),
-    (0xA767, 'V'),
-    (0xA768, 'M', 'ꝩ'),
-    (0xA769, 'V'),
-    (0xA76A, 'M', 'ꝫ'),
-    (0xA76B, 'V'),
-    (0xA76C, 'M', 'ꝭ'),
-    (0xA76D, 'V'),
-    (0xA76E, 'M', 'ꝯ'),
-    (0xA76F, 'V'),
-    (0xA770, 'M', 'ꝯ'),
-    (0xA771, 'V'),
-    (0xA779, 'M', 'ꝺ'),
-    (0xA77A, 'V'),
-    (0xA77B, 'M', 'ꝼ'),
-    (0xA77C, 'V'),
-    (0xA77D, 'M', 'ᵹ'),
-    (0xA77E, 'M', 'ꝿ'),
-    (0xA77F, 'V'),
+        (0xA692, "M", "ꚓ"),
+        (0xA693, "V"),
+        (0xA694, "M", "ꚕ"),
+        (0xA695, "V"),
+        (0xA696, "M", "ꚗ"),
+        (0xA697, "V"),
+        (0xA698, "M", "ꚙ"),
+        (0xA699, "V"),
+        (0xA69A, "M", "ꚛ"),
+        (0xA69B, "V"),
+        (0xA69C, "M", "ъ"),
+        (0xA69D, "M", "ь"),
+        (0xA69E, "V"),
+        (0xA6F8, "X"),
+        (0xA700, "V"),
+        (0xA722, "M", "ꜣ"),
+        (0xA723, "V"),
+        (0xA724, "M", "ꜥ"),
+        (0xA725, "V"),
+        (0xA726, "M", "ꜧ"),
+        (0xA727, "V"),
+        (0xA728, "M", "ꜩ"),
+        (0xA729, "V"),
+        (0xA72A, "M", "ꜫ"),
+        (0xA72B, "V"),
+        (0xA72C, "M", "ꜭ"),
+        (0xA72D, "V"),
+        (0xA72E, "M", "ꜯ"),
+        (0xA72F, "V"),
+        (0xA732, "M", "ꜳ"),
+        (0xA733, "V"),
+        (0xA734, "M", "ꜵ"),
+        (0xA735, "V"),
+        (0xA736, "M", "ꜷ"),
+        (0xA737, "V"),
+        (0xA738, "M", "ꜹ"),
+        (0xA739, "V"),
+        (0xA73A, "M", "ꜻ"),
+        (0xA73B, "V"),
+        (0xA73C, "M", "ꜽ"),
+        (0xA73D, "V"),
+        (0xA73E, "M", "ꜿ"),
+        (0xA73F, "V"),
+        (0xA740, "M", "ꝁ"),
+        (0xA741, "V"),
+        (0xA742, "M", "ꝃ"),
+        (0xA743, "V"),
+        (0xA744, "M", "ꝅ"),
+        (0xA745, "V"),
+        (0xA746, "M", "ꝇ"),
+        (0xA747, "V"),
+        (0xA748, "M", "ꝉ"),
+        (0xA749, "V"),
+        (0xA74A, "M", "ꝋ"),
+        (0xA74B, "V"),
+        (0xA74C, "M", "ꝍ"),
+        (0xA74D, "V"),
+        (0xA74E, "M", "ꝏ"),
+        (0xA74F, "V"),
+        (0xA750, "M", "ꝑ"),
+        (0xA751, "V"),
+        (0xA752, "M", "ꝓ"),
+        (0xA753, "V"),
+        (0xA754, "M", "ꝕ"),
+        (0xA755, "V"),
+        (0xA756, "M", "ꝗ"),
+        (0xA757, "V"),
+        (0xA758, "M", "ꝙ"),
+        (0xA759, "V"),
+        (0xA75A, "M", "ꝛ"),
+        (0xA75B, "V"),
+        (0xA75C, "M", "ꝝ"),
+        (0xA75D, "V"),
+        (0xA75E, "M", "ꝟ"),
+        (0xA75F, "V"),
+        (0xA760, "M", "ꝡ"),
+        (0xA761, "V"),
+        (0xA762, "M", "ꝣ"),
+        (0xA763, "V"),
+        (0xA764, "M", "ꝥ"),
+        (0xA765, "V"),
+        (0xA766, "M", "ꝧ"),
+        (0xA767, "V"),
+        (0xA768, "M", "ꝩ"),
+        (0xA769, "V"),
+        (0xA76A, "M", "ꝫ"),
+        (0xA76B, "V"),
+        (0xA76C, "M", "ꝭ"),
+        (0xA76D, "V"),
+        (0xA76E, "M", "ꝯ"),
+        (0xA76F, "V"),
+        (0xA770, "M", "ꝯ"),
+        (0xA771, "V"),
+        (0xA779, "M", "ꝺ"),
+        (0xA77A, "V"),
+        (0xA77B, "M", "ꝼ"),
+        (0xA77C, "V"),
+        (0xA77D, "M", "ᵹ"),
+        (0xA77E, "M", "ꝿ"),
+        (0xA77F, "V"),
     ]
 
+
 def _seg_37() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0xA780, 'M', 'ꞁ'),
-    (0xA781, 'V'),
-    (0xA782, 'M', 'ꞃ'),
-    (0xA783, 'V'),
-    (0xA784, 'M', 'ꞅ'),
-    (0xA785, 'V'),
-    (0xA786, 'M', 'ꞇ'),
-    (0xA787, 'V'),
-    (0xA78B, 'M', 'ꞌ'),
-    (0xA78C, 'V'),
-    (0xA78D, 'M', 'ɥ'),
-    (0xA78E, 'V'),
-    (0xA790, 'M', 'ꞑ'),
-    (0xA791, 'V'),
-    (0xA792, 'M', 'ꞓ'),
-    (0xA793, 'V'),
-    (0xA796, 'M', 'ꞗ'),
-    (0xA797, 'V'),
-    (0xA798, 'M', 'ꞙ'),
-    (0xA799, 'V'),
-    (0xA79A, 'M', 'ꞛ'),
-    (0xA79B, 'V'),
-    (0xA79C, 'M', 'ꞝ'),
-    (0xA79D, 'V'),
-    (0xA79E, 'M', 'ꞟ'),
-    (0xA79F, 'V'),
-    (0xA7A0, 'M', 'ꞡ'),
-    (0xA7A1, 'V'),
-    (0xA7A2, 'M', 'ꞣ'),
-    (0xA7A3, 'V'),
-    (0xA7A4, 'M', 'ꞥ'),
-    (0xA7A5, 'V'),
-    (0xA7A6, 'M', 'ꞧ'),
-    (0xA7A7, 'V'),
-    (0xA7A8, 'M', 'ꞩ'),
-    (0xA7A9, 'V'),
-    (0xA7AA, 'M', 'ɦ'),
-    (0xA7AB, 'M', 'ɜ'),
-    (0xA7AC, 'M', 'ɡ'),
-    (0xA7AD, 'M', 'ɬ'),
-    (0xA7AE, 'M', 'ɪ'),
-    (0xA7AF, 'V'),
-    (0xA7B0, 'M', 'ʞ'),
-    (0xA7B1, 'M', 'ʇ'),
-    (0xA7B2, 'M', 'ʝ'),
-    (0xA7B3, 'M', 'ꭓ'),
-    (0xA7B4, 'M', 'ꞵ'),
-    (0xA7B5, 'V'),
-    (0xA7B6, 'M', 'ꞷ'),
-    (0xA7B7, 'V'),
-    (0xA7B8, 'M', 'ꞹ'),
-    (0xA7B9, 'V'),
-    (0xA7BA, 'M', 'ꞻ'),
-    (0xA7BB, 'V'),
-    (0xA7BC, 'M', 'ꞽ'),
-    (0xA7BD, 'V'),
-    (0xA7BE, 'M', 'ꞿ'),
-    (0xA7BF, 'V'),
-    (0xA7C0, 'M', 'ꟁ'),
-    (0xA7C1, 'V'),
-    (0xA7C2, 'M', 'ꟃ'),
-    (0xA7C3, 'V'),
-    (0xA7C4, 'M', 'ꞔ'),
-    (0xA7C5, 'M', 'ʂ'),
-    (0xA7C6, 'M', 'ᶎ'),
-    (0xA7C7, 'M', 'ꟈ'),
-    (0xA7C8, 'V'),
-    (0xA7C9, 'M', 'ꟊ'),
-    (0xA7CA, 'V'),
-    (0xA7CB, 'X'),
-    (0xA7D0, 'M', 'ꟑ'),
-    (0xA7D1, 'V'),
-    (0xA7D2, 'X'),
-    (0xA7D3, 'V'),
-    (0xA7D4, 'X'),
-    (0xA7D5, 'V'),
-    (0xA7D6, 'M', 'ꟗ'),
-    (0xA7D7, 'V'),
-    (0xA7D8, 'M', 'ꟙ'),
-    (0xA7D9, 'V'),
-    (0xA7DA, 'X'),
-    (0xA7F2, 'M', 'c'),
-    (0xA7F3, 'M', 'f'),
-    (0xA7F4, 'M', 'q'),
-    (0xA7F5, 'M', 'ꟶ'),
-    (0xA7F6, 'V'),
-    (0xA7F8, 'M', 'ħ'),
-    (0xA7F9, 'M', 'œ'),
-    (0xA7FA, 'V'),
-    (0xA82D, 'X'),
-    (0xA830, 'V'),
-    (0xA83A, 'X'),
-    (0xA840, 'V'),
-    (0xA878, 'X'),
-    (0xA880, 'V'),
-    (0xA8C6, 'X'),
-    (0xA8CE, 'V'),
-    (0xA8DA, 'X'),
-    (0xA8E0, 'V'),
-    (0xA954, 'X'),
+        (0xA780, "M", "ꞁ"),
+        (0xA781, "V"),
+        (0xA782, "M", "ꞃ"),
+        (0xA783, "V"),
+        (0xA784, "M", "ꞅ"),
+        (0xA785, "V"),
+        (0xA786, "M", "ꞇ"),
+        (0xA787, "V"),
+        (0xA78B, "M", "ꞌ"),
+        (0xA78C, "V"),
+        (0xA78D, "M", "ɥ"),
+        (0xA78E, "V"),
+        (0xA790, "M", "ꞑ"),
+        (0xA791, "V"),
+        (0xA792, "M", "ꞓ"),
+        (0xA793, "V"),
+        (0xA796, "M", "ꞗ"),
+        (0xA797, "V"),
+        (0xA798, "M", "ꞙ"),
+        (0xA799, "V"),
+        (0xA79A, "M", "ꞛ"),
+        (0xA79B, "V"),
+        (0xA79C, "M", "ꞝ"),
+        (0xA79D, "V"),
+        (0xA79E, "M", "ꞟ"),
+        (0xA79F, "V"),
+        (0xA7A0, "M", "ꞡ"),
+        (0xA7A1, "V"),
+        (0xA7A2, "M", "ꞣ"),
+        (0xA7A3, "V"),
+        (0xA7A4, "M", "ꞥ"),
+        (0xA7A5, "V"),
+        (0xA7A6, "M", "ꞧ"),
+        (0xA7A7, "V"),
+        (0xA7A8, "M", "ꞩ"),
+        (0xA7A9, "V"),
+        (0xA7AA, "M", "ɦ"),
+        (0xA7AB, "M", "ɜ"),
+        (0xA7AC, "M", "ɡ"),
+        (0xA7AD, "M", "ɬ"),
+        (0xA7AE, "M", "ɪ"),
+        (0xA7AF, "V"),
+        (0xA7B0, "M", "ʞ"),
+        (0xA7B1, "M", "ʇ"),
+        (0xA7B2, "M", "ʝ"),
+        (0xA7B3, "M", "ꭓ"),
+        (0xA7B4, "M", "ꞵ"),
+        (0xA7B5, "V"),
+        (0xA7B6, "M", "ꞷ"),
+        (0xA7B7, "V"),
+        (0xA7B8, "M", "ꞹ"),
+        (0xA7B9, "V"),
+        (0xA7BA, "M", "ꞻ"),
+        (0xA7BB, "V"),
+        (0xA7BC, "M", "ꞽ"),
+        (0xA7BD, "V"),
+        (0xA7BE, "M", "ꞿ"),
+        (0xA7BF, "V"),
+        (0xA7C0, "M", "ꟁ"),
+        (0xA7C1, "V"),
+        (0xA7C2, "M", "ꟃ"),
+        (0xA7C3, "V"),
+        (0xA7C4, "M", "ꞔ"),
+        (0xA7C5, "M", "ʂ"),
+        (0xA7C6, "M", "ᶎ"),
+        (0xA7C7, "M", "ꟈ"),
+        (0xA7C8, "V"),
+        (0xA7C9, "M", "ꟊ"),
+        (0xA7CA, "V"),
+        (0xA7CB, "X"),
+        (0xA7D0, "M", "ꟑ"),
+        (0xA7D1, "V"),
+        (0xA7D2, "X"),
+        (0xA7D3, "V"),
+        (0xA7D4, "X"),
+        (0xA7D5, "V"),
+        (0xA7D6, "M", "ꟗ"),
+        (0xA7D7, "V"),
+        (0xA7D8, "M", "ꟙ"),
+        (0xA7D9, "V"),
+        (0xA7DA, "X"),
+        (0xA7F2, "M", "c"),
+        (0xA7F3, "M", "f"),
+        (0xA7F4, "M", "q"),
+        (0xA7F5, "M", "ꟶ"),
+        (0xA7F6, "V"),
+        (0xA7F8, "M", "ħ"),
+        (0xA7F9, "M", "œ"),
+        (0xA7FA, "V"),
+        (0xA82D, "X"),
+        (0xA830, "V"),
+        (0xA83A, "X"),
+        (0xA840, "V"),
+        (0xA878, "X"),
+        (0xA880, "V"),
+        (0xA8C6, "X"),
+        (0xA8CE, "V"),
+        (0xA8DA, "X"),
+        (0xA8E0, "V"),
+        (0xA954, "X"),
     ]
 
+
 def _seg_38() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0xA95F, 'V'),
-    (0xA97D, 'X'),
-    (0xA980, 'V'),
-    (0xA9CE, 'X'),
-    (0xA9CF, 'V'),
-    (0xA9DA, 'X'),
-    (0xA9DE, 'V'),
-    (0xA9FF, 'X'),
-    (0xAA00, 'V'),
-    (0xAA37, 'X'),
-    (0xAA40, 'V'),
-    (0xAA4E, 'X'),
-    (0xAA50, 'V'),
-    (0xAA5A, 'X'),
-    (0xAA5C, 'V'),
-    (0xAAC3, 'X'),
-    (0xAADB, 'V'),
-    (0xAAF7, 'X'),
-    (0xAB01, 'V'),
-    (0xAB07, 'X'),
-    (0xAB09, 'V'),
-    (0xAB0F, 'X'),
-    (0xAB11, 'V'),
-    (0xAB17, 'X'),
-    (0xAB20, 'V'),
-    (0xAB27, 'X'),
-    (0xAB28, 'V'),
-    (0xAB2F, 'X'),
-    (0xAB30, 'V'),
-    (0xAB5C, 'M', 'ꜧ'),
-    (0xAB5D, 'M', 'ꬷ'),
-    (0xAB5E, 'M', 'ɫ'),
-    (0xAB5F, 'M', 'ꭒ'),
-    (0xAB60, 'V'),
-    (0xAB69, 'M', 'ʍ'),
-    (0xAB6A, 'V'),
-    (0xAB6C, 'X'),
-    (0xAB70, 'M', 'Ꭰ'),
-    (0xAB71, 'M', 'Ꭱ'),
-    (0xAB72, 'M', 'Ꭲ'),
-    (0xAB73, 'M', 'Ꭳ'),
-    (0xAB74, 'M', 'Ꭴ'),
-    (0xAB75, 'M', 'Ꭵ'),
-    (0xAB76, 'M', 'Ꭶ'),
-    (0xAB77, 'M', 'Ꭷ'),
-    (0xAB78, 'M', 'Ꭸ'),
-    (0xAB79, 'M', 'Ꭹ'),
-    (0xAB7A, 'M', 'Ꭺ'),
-    (0xAB7B, 'M', 'Ꭻ'),
-    (0xAB7C, 'M', 'Ꭼ'),
-    (0xAB7D, 'M', 'Ꭽ'),
-    (0xAB7E, 'M', 'Ꭾ'),
-    (0xAB7F, 'M', 'Ꭿ'),
-    (0xAB80, 'M', 'Ꮀ'),
-    (0xAB81, 'M', 'Ꮁ'),
-    (0xAB82, 'M', 'Ꮂ'),
-    (0xAB83, 'M', 'Ꮃ'),
-    (0xAB84, 'M', 'Ꮄ'),
-    (0xAB85, 'M', 'Ꮅ'),
-    (0xAB86, 'M', 'Ꮆ'),
-    (0xAB87, 'M', 'Ꮇ'),
-    (0xAB88, 'M', 'Ꮈ'),
-    (0xAB89, 'M', 'Ꮉ'),
-    (0xAB8A, 'M', 'Ꮊ'),
-    (0xAB8B, 'M', 'Ꮋ'),
-    (0xAB8C, 'M', 'Ꮌ'),
-    (0xAB8D, 'M', 'Ꮍ'),
-    (0xAB8E, 'M', 'Ꮎ'),
-    (0xAB8F, 'M', 'Ꮏ'),
-    (0xAB90, 'M', 'Ꮐ'),
-    (0xAB91, 'M', 'Ꮑ'),
-    (0xAB92, 'M', 'Ꮒ'),
-    (0xAB93, 'M', 'Ꮓ'),
-    (0xAB94, 'M', 'Ꮔ'),
-    (0xAB95, 'M', 'Ꮕ'),
-    (0xAB96, 'M', 'Ꮖ'),
-    (0xAB97, 'M', 'Ꮗ'),
-    (0xAB98, 'M', 'Ꮘ'),
-    (0xAB99, 'M', 'Ꮙ'),
-    (0xAB9A, 'M', 'Ꮚ'),
-    (0xAB9B, 'M', 'Ꮛ'),
-    (0xAB9C, 'M', 'Ꮜ'),
-    (0xAB9D, 'M', 'Ꮝ'),
-    (0xAB9E, 'M', 'Ꮞ'),
-    (0xAB9F, 'M', 'Ꮟ'),
-    (0xABA0, 'M', 'Ꮠ'),
-    (0xABA1, 'M', 'Ꮡ'),
-    (0xABA2, 'M', 'Ꮢ'),
-    (0xABA3, 'M', 'Ꮣ'),
-    (0xABA4, 'M', 'Ꮤ'),
-    (0xABA5, 'M', 'Ꮥ'),
-    (0xABA6, 'M', 'Ꮦ'),
-    (0xABA7, 'M', 'Ꮧ'),
-    (0xABA8, 'M', 'Ꮨ'),
-    (0xABA9, 'M', 'Ꮩ'),
-    (0xABAA, 'M', 'Ꮪ'),
-    (0xABAB, 'M', 'Ꮫ'),
-    (0xABAC, 'M', 'Ꮬ'),
-    (0xABAD, 'M', 'Ꮭ'),
-    (0xABAE, 'M', 'Ꮮ'),
+        (0xA95F, "V"),
+        (0xA97D, "X"),
+        (0xA980, "V"),
+        (0xA9CE, "X"),
+        (0xA9CF, "V"),
+        (0xA9DA, "X"),
+        (0xA9DE, "V"),
+        (0xA9FF, "X"),
+        (0xAA00, "V"),
+        (0xAA37, "X"),
+        (0xAA40, "V"),
+        (0xAA4E, "X"),
+        (0xAA50, "V"),
+        (0xAA5A, "X"),
+        (0xAA5C, "V"),
+        (0xAAC3, "X"),
+        (0xAADB, "V"),
+        (0xAAF7, "X"),
+        (0xAB01, "V"),
+        (0xAB07, "X"),
+        (0xAB09, "V"),
+        (0xAB0F, "X"),
+        (0xAB11, "V"),
+        (0xAB17, "X"),
+        (0xAB20, "V"),
+        (0xAB27, "X"),
+        (0xAB28, "V"),
+        (0xAB2F, "X"),
+        (0xAB30, "V"),
+        (0xAB5C, "M", "ꜧ"),
+        (0xAB5D, "M", "ꬷ"),
+        (0xAB5E, "M", "ɫ"),
+        (0xAB5F, "M", "ꭒ"),
+        (0xAB60, "V"),
+        (0xAB69, "M", "ʍ"),
+        (0xAB6A, "V"),
+        (0xAB6C, "X"),
+        (0xAB70, "M", "Ꭰ"),
+        (0xAB71, "M", "Ꭱ"),
+        (0xAB72, "M", "Ꭲ"),
+        (0xAB73, "M", "Ꭳ"),
+        (0xAB74, "M", "Ꭴ"),
+        (0xAB75, "M", "Ꭵ"),
+        (0xAB76, "M", "Ꭶ"),
+        (0xAB77, "M", "Ꭷ"),
+        (0xAB78, "M", "Ꭸ"),
+        (0xAB79, "M", "Ꭹ"),
+        (0xAB7A, "M", "Ꭺ"),
+        (0xAB7B, "M", "Ꭻ"),
+        (0xAB7C, "M", "Ꭼ"),
+        (0xAB7D, "M", "Ꭽ"),
+        (0xAB7E, "M", "Ꭾ"),
+        (0xAB7F, "M", "Ꭿ"),
+        (0xAB80, "M", "Ꮀ"),
+        (0xAB81, "M", "Ꮁ"),
+        (0xAB82, "M", "Ꮂ"),
+        (0xAB83, "M", "Ꮃ"),
+        (0xAB84, "M", "Ꮄ"),
+        (0xAB85, "M", "Ꮅ"),
+        (0xAB86, "M", "Ꮆ"),
+        (0xAB87, "M", "Ꮇ"),
+        (0xAB88, "M", "Ꮈ"),
+        (0xAB89, "M", "Ꮉ"),
+        (0xAB8A, "M", "Ꮊ"),
+        (0xAB8B, "M", "Ꮋ"),
+        (0xAB8C, "M", "Ꮌ"),
+        (0xAB8D, "M", "Ꮍ"),
+        (0xAB8E, "M", "Ꮎ"),
+        (0xAB8F, "M", "Ꮏ"),
+        (0xAB90, "M", "Ꮐ"),
+        (0xAB91, "M", "Ꮑ"),
+        (0xAB92, "M", "Ꮒ"),
+        (0xAB93, "M", "Ꮓ"),
+        (0xAB94, "M", "Ꮔ"),
+        (0xAB95, "M", "Ꮕ"),
+        (0xAB96, "M", "Ꮖ"),
+        (0xAB97, "M", "Ꮗ"),
+        (0xAB98, "M", "Ꮘ"),
+        (0xAB99, "M", "Ꮙ"),
+        (0xAB9A, "M", "Ꮚ"),
+        (0xAB9B, "M", "Ꮛ"),
+        (0xAB9C, "M", "Ꮜ"),
+        (0xAB9D, "M", "Ꮝ"),
+        (0xAB9E, "M", "Ꮞ"),
+        (0xAB9F, "M", "Ꮟ"),
+        (0xABA0, "M", "Ꮠ"),
+        (0xABA1, "M", "Ꮡ"),
+        (0xABA2, "M", "Ꮢ"),
+        (0xABA3, "M", "Ꮣ"),
+        (0xABA4, "M", "Ꮤ"),
+        (0xABA5, "M", "Ꮥ"),
+        (0xABA6, "M", "Ꮦ"),
+        (0xABA7, "M", "Ꮧ"),
+        (0xABA8, "M", "Ꮨ"),
+        (0xABA9, "M", "Ꮩ"),
+        (0xABAA, "M", "Ꮪ"),
+        (0xABAB, "M", "Ꮫ"),
+        (0xABAC, "M", "Ꮬ"),
+        (0xABAD, "M", "Ꮭ"),
+        (0xABAE, "M", "Ꮮ"),
     ]
 
+
 def _seg_39() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0xABAF, 'M', 'Ꮯ'),
-    (0xABB0, 'M', 'Ꮰ'),
-    (0xABB1, 'M', 'Ꮱ'),
-    (0xABB2, 'M', 'Ꮲ'),
-    (0xABB3, 'M', 'Ꮳ'),
-    (0xABB4, 'M', 'Ꮴ'),
-    (0xABB5, 'M', 'Ꮵ'),
-    (0xABB6, 'M', 'Ꮶ'),
-    (0xABB7, 'M', 'Ꮷ'),
-    (0xABB8, 'M', 'Ꮸ'),
-    (0xABB9, 'M', 'Ꮹ'),
-    (0xABBA, 'M', 'Ꮺ'),
-    (0xABBB, 'M', 'Ꮻ'),
-    (0xABBC, 'M', 'Ꮼ'),
-    (0xABBD, 'M', 'Ꮽ'),
-    (0xABBE, 'M', 'Ꮾ'),
-    (0xABBF, 'M', 'Ꮿ'),
-    (0xABC0, 'V'),
-    (0xABEE, 'X'),
-    (0xABF0, 'V'),
-    (0xABFA, 'X'),
-    (0xAC00, 'V'),
-    (0xD7A4, 'X'),
-    (0xD7B0, 'V'),
-    (0xD7C7, 'X'),
-    (0xD7CB, 'V'),
-    (0xD7FC, 'X'),
-    (0xF900, 'M', '豈'),
-    (0xF901, 'M', '更'),
-    (0xF902, 'M', '車'),
-    (0xF903, 'M', '賈'),
-    (0xF904, 'M', '滑'),
-    (0xF905, 'M', '串'),
-    (0xF906, 'M', '句'),
-    (0xF907, 'M', '龜'),
-    (0xF909, 'M', '契'),
-    (0xF90A, 'M', '金'),
-    (0xF90B, 'M', '喇'),
-    (0xF90C, 'M', '奈'),
-    (0xF90D, 'M', '懶'),
-    (0xF90E, 'M', '癩'),
-    (0xF90F, 'M', '羅'),
-    (0xF910, 'M', '蘿'),
-    (0xF911, 'M', '螺'),
-    (0xF912, 'M', '裸'),
-    (0xF913, 'M', '邏'),
-    (0xF914, 'M', '樂'),
-    (0xF915, 'M', '洛'),
-    (0xF916, 'M', '烙'),
-    (0xF917, 'M', '珞'),
-    (0xF918, 'M', '落'),
-    (0xF919, 'M', '酪'),
-    (0xF91A, 'M', '駱'),
-    (0xF91B, 'M', '亂'),
-    (0xF91C, 'M', '卵'),
-    (0xF91D, 'M', '欄'),
-    (0xF91E, 'M', '爛'),
-    (0xF91F, 'M', '蘭'),
-    (0xF920, 'M', '鸞'),
-    (0xF921, 'M', '嵐'),
-    (0xF922, 'M', '濫'),
-    (0xF923, 'M', '藍'),
-    (0xF924, 'M', '襤'),
-    (0xF925, 'M', '拉'),
-    (0xF926, 'M', '臘'),
-    (0xF927, 'M', '蠟'),
-    (0xF928, 'M', '廊'),
-    (0xF929, 'M', '朗'),
-    (0xF92A, 'M', '浪'),
-    (0xF92B, 'M', '狼'),
-    (0xF92C, 'M', '郎'),
-    (0xF92D, 'M', '來'),
-    (0xF92E, 'M', '冷'),
-    (0xF92F, 'M', '勞'),
-    (0xF930, 'M', '擄'),
-    (0xF931, 'M', '櫓'),
-    (0xF932, 'M', '爐'),
-    (0xF933, 'M', '盧'),
-    (0xF934, 'M', '老'),
-    (0xF935, 'M', '蘆'),
-    (0xF936, 'M', '虜'),
-    (0xF937, 'M', '路'),
-    (0xF938, 'M', '露'),
-    (0xF939, 'M', '魯'),
-    (0xF93A, 'M', '鷺'),
-    (0xF93B, 'M', '碌'),
-    (0xF93C, 'M', '祿'),
-    (0xF93D, 'M', '綠'),
-    (0xF93E, 'M', '菉'),
-    (0xF93F, 'M', '錄'),
-    (0xF940, 'M', '鹿'),
-    (0xF941, 'M', '論'),
-    (0xF942, 'M', '壟'),
-    (0xF943, 'M', '弄'),
-    (0xF944, 'M', '籠'),
-    (0xF945, 'M', '聾'),
-    (0xF946, 'M', '牢'),
-    (0xF947, 'M', '磊'),
-    (0xF948, 'M', '賂'),
-    (0xF949, 'M', '雷'),
+        (0xABAF, "M", "Ꮯ"),
+        (0xABB0, "M", "Ꮰ"),
+        (0xABB1, "M", "Ꮱ"),
+        (0xABB2, "M", "Ꮲ"),
+        (0xABB3, "M", "Ꮳ"),
+        (0xABB4, "M", "Ꮴ"),
+        (0xABB5, "M", "Ꮵ"),
+        (0xABB6, "M", "Ꮶ"),
+        (0xABB7, "M", "Ꮷ"),
+        (0xABB8, "M", "Ꮸ"),
+        (0xABB9, "M", "Ꮹ"),
+        (0xABBA, "M", "Ꮺ"),
+        (0xABBB, "M", "Ꮻ"),
+        (0xABBC, "M", "Ꮼ"),
+        (0xABBD, "M", "Ꮽ"),
+        (0xABBE, "M", "Ꮾ"),
+        (0xABBF, "M", "Ꮿ"),
+        (0xABC0, "V"),
+        (0xABEE, "X"),
+        (0xABF0, "V"),
+        (0xABFA, "X"),
+        (0xAC00, "V"),
+        (0xD7A4, "X"),
+        (0xD7B0, "V"),
+        (0xD7C7, "X"),
+        (0xD7CB, "V"),
+        (0xD7FC, "X"),
+        (0xF900, "M", "豈"),
+        (0xF901, "M", "更"),
+        (0xF902, "M", "車"),
+        (0xF903, "M", "賈"),
+        (0xF904, "M", "滑"),
+        (0xF905, "M", "串"),
+        (0xF906, "M", "句"),
+        (0xF907, "M", "龜"),
+        (0xF909, "M", "契"),
+        (0xF90A, "M", "金"),
+        (0xF90B, "M", "喇"),
+        (0xF90C, "M", "奈"),
+        (0xF90D, "M", "懶"),
+        (0xF90E, "M", "癩"),
+        (0xF90F, "M", "羅"),
+        (0xF910, "M", "蘿"),
+        (0xF911, "M", "螺"),
+        (0xF912, "M", "裸"),
+        (0xF913, "M", "邏"),
+        (0xF914, "M", "樂"),
+        (0xF915, "M", "洛"),
+        (0xF916, "M", "烙"),
+        (0xF917, "M", "珞"),
+        (0xF918, "M", "落"),
+        (0xF919, "M", "酪"),
+        (0xF91A, "M", "駱"),
+        (0xF91B, "M", "亂"),
+        (0xF91C, "M", "卵"),
+        (0xF91D, "M", "欄"),
+        (0xF91E, "M", "爛"),
+        (0xF91F, "M", "蘭"),
+        (0xF920, "M", "鸞"),
+        (0xF921, "M", "嵐"),
+        (0xF922, "M", "濫"),
+        (0xF923, "M", "藍"),
+        (0xF924, "M", "襤"),
+        (0xF925, "M", "拉"),
+        (0xF926, "M", "臘"),
+        (0xF927, "M", "蠟"),
+        (0xF928, "M", "廊"),
+        (0xF929, "M", "朗"),
+        (0xF92A, "M", "浪"),
+        (0xF92B, "M", "狼"),
+        (0xF92C, "M", "郎"),
+        (0xF92D, "M", "來"),
+        (0xF92E, "M", "冷"),
+        (0xF92F, "M", "勞"),
+        (0xF930, "M", "擄"),
+        (0xF931, "M", "櫓"),
+        (0xF932, "M", "爐"),
+        (0xF933, "M", "盧"),
+        (0xF934, "M", "老"),
+        (0xF935, "M", "蘆"),
+        (0xF936, "M", "虜"),
+        (0xF937, "M", "路"),
+        (0xF938, "M", "露"),
+        (0xF939, "M", "魯"),
+        (0xF93A, "M", "鷺"),
+        (0xF93B, "M", "碌"),
+        (0xF93C, "M", "祿"),
+        (0xF93D, "M", "綠"),
+        (0xF93E, "M", "菉"),
+        (0xF93F, "M", "錄"),
+        (0xF940, "M", "鹿"),
+        (0xF941, "M", "論"),
+        (0xF942, "M", "壟"),
+        (0xF943, "M", "弄"),
+        (0xF944, "M", "籠"),
+        (0xF945, "M", "聾"),
+        (0xF946, "M", "牢"),
+        (0xF947, "M", "磊"),
+        (0xF948, "M", "賂"),
+        (0xF949, "M", "雷"),
     ]
 
+
 def _seg_40() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0xF94A, 'M', '壘'),
-    (0xF94B, 'M', '屢'),
-    (0xF94C, 'M', '樓'),
-    (0xF94D, 'M', '淚'),
-    (0xF94E, 'M', '漏'),
-    (0xF94F, 'M', '累'),
-    (0xF950, 'M', '縷'),
-    (0xF951, 'M', '陋'),
-    (0xF952, 'M', '勒'),
-    (0xF953, 'M', '肋'),
-    (0xF954, 'M', '凜'),
-    (0xF955, 'M', '凌'),
-    (0xF956, 'M', '稜'),
-    (0xF957, 'M', '綾'),
-    (0xF958, 'M', '菱'),
-    (0xF959, 'M', '陵'),
-    (0xF95A, 'M', '讀'),
-    (0xF95B, 'M', '拏'),
-    (0xF95C, 'M', '樂'),
-    (0xF95D, 'M', '諾'),
-    (0xF95E, 'M', '丹'),
-    (0xF95F, 'M', '寧'),
-    (0xF960, 'M', '怒'),
-    (0xF961, 'M', '率'),
-    (0xF962, 'M', '異'),
-    (0xF963, 'M', '北'),
-    (0xF964, 'M', '磻'),
-    (0xF965, 'M', '便'),
-    (0xF966, 'M', '復'),
-    (0xF967, 'M', '不'),
-    (0xF968, 'M', '泌'),
-    (0xF969, 'M', '數'),
-    (0xF96A, 'M', '索'),
-    (0xF96B, 'M', '參'),
-    (0xF96C, 'M', '塞'),
-    (0xF96D, 'M', '省'),
-    (0xF96E, 'M', '葉'),
-    (0xF96F, 'M', '說'),
-    (0xF970, 'M', '殺'),
-    (0xF971, 'M', '辰'),
-    (0xF972, 'M', '沈'),
-    (0xF973, 'M', '拾'),
-    (0xF974, 'M', '若'),
-    (0xF975, 'M', '掠'),
-    (0xF976, 'M', '略'),
-    (0xF977, 'M', '亮'),
-    (0xF978, 'M', '兩'),
-    (0xF979, 'M', '凉'),
-    (0xF97A, 'M', '梁'),
-    (0xF97B, 'M', '糧'),
-    (0xF97C, 'M', '良'),
-    (0xF97D, 'M', '諒'),
-    (0xF97E, 'M', '量'),
-    (0xF97F, 'M', '勵'),
-    (0xF980, 'M', '呂'),
-    (0xF981, 'M', '女'),
-    (0xF982, 'M', '廬'),
-    (0xF983, 'M', '旅'),
-    (0xF984, 'M', '濾'),
-    (0xF985, 'M', '礪'),
-    (0xF986, 'M', '閭'),
-    (0xF987, 'M', '驪'),
-    (0xF988, 'M', '麗'),
-    (0xF989, 'M', '黎'),
-    (0xF98A, 'M', '力'),
-    (0xF98B, 'M', '曆'),
-    (0xF98C, 'M', '歷'),
-    (0xF98D, 'M', '轢'),
-    (0xF98E, 'M', '年'),
-    (0xF98F, 'M', '憐'),
-    (0xF990, 'M', '戀'),
-    (0xF991, 'M', '撚'),
-    (0xF992, 'M', '漣'),
-    (0xF993, 'M', '煉'),
-    (0xF994, 'M', '璉'),
-    (0xF995, 'M', '秊'),
-    (0xF996, 'M', '練'),
-    (0xF997, 'M', '聯'),
-    (0xF998, 'M', '輦'),
-    (0xF999, 'M', '蓮'),
-    (0xF99A, 'M', '連'),
-    (0xF99B, 'M', '鍊'),
-    (0xF99C, 'M', '列'),
-    (0xF99D, 'M', '劣'),
-    (0xF99E, 'M', '咽'),
-    (0xF99F, 'M', '烈'),
-    (0xF9A0, 'M', '裂'),
-    (0xF9A1, 'M', '說'),
-    (0xF9A2, 'M', '廉'),
-    (0xF9A3, 'M', '念'),
-    (0xF9A4, 'M', '捻'),
-    (0xF9A5, 'M', '殮'),
-    (0xF9A6, 'M', '簾'),
-    (0xF9A7, 'M', '獵'),
-    (0xF9A8, 'M', '令'),
-    (0xF9A9, 'M', '囹'),
-    (0xF9AA, 'M', '寧'),
-    (0xF9AB, 'M', '嶺'),
-    (0xF9AC, 'M', '怜'),
-    (0xF9AD, 'M', '玲'),
+        (0xF94A, "M", "壘"),
+        (0xF94B, "M", "屢"),
+        (0xF94C, "M", "樓"),
+        (0xF94D, "M", "淚"),
+        (0xF94E, "M", "漏"),
+        (0xF94F, "M", "累"),
+        (0xF950, "M", "縷"),
+        (0xF951, "M", "陋"),
+        (0xF952, "M", "勒"),
+        (0xF953, "M", "肋"),
+        (0xF954, "M", "凜"),
+        (0xF955, "M", "凌"),
+        (0xF956, "M", "稜"),
+        (0xF957, "M", "綾"),
+        (0xF958, "M", "菱"),
+        (0xF959, "M", "陵"),
+        (0xF95A, "M", "讀"),
+        (0xF95B, "M", "拏"),
+        (0xF95C, "M", "樂"),
+        (0xF95D, "M", "諾"),
+        (0xF95E, "M", "丹"),
+        (0xF95F, "M", "寧"),
+        (0xF960, "M", "怒"),
+        (0xF961, "M", "率"),
+        (0xF962, "M", "異"),
+        (0xF963, "M", "北"),
+        (0xF964, "M", "磻"),
+        (0xF965, "M", "便"),
+        (0xF966, "M", "復"),
+        (0xF967, "M", "不"),
+        (0xF968, "M", "泌"),
+        (0xF969, "M", "數"),
+        (0xF96A, "M", "索"),
+        (0xF96B, "M", "參"),
+        (0xF96C, "M", "塞"),
+        (0xF96D, "M", "省"),
+        (0xF96E, "M", "葉"),
+        (0xF96F, "M", "說"),
+        (0xF970, "M", "殺"),
+        (0xF971, "M", "辰"),
+        (0xF972, "M", "沈"),
+        (0xF973, "M", "拾"),
+        (0xF974, "M", "若"),
+        (0xF975, "M", "掠"),
+        (0xF976, "M", "略"),
+        (0xF977, "M", "亮"),
+        (0xF978, "M", "兩"),
+        (0xF979, "M", "凉"),
+        (0xF97A, "M", "梁"),
+        (0xF97B, "M", "糧"),
+        (0xF97C, "M", "良"),
+        (0xF97D, "M", "諒"),
+        (0xF97E, "M", "量"),
+        (0xF97F, "M", "勵"),
+        (0xF980, "M", "呂"),
+        (0xF981, "M", "女"),
+        (0xF982, "M", "廬"),
+        (0xF983, "M", "旅"),
+        (0xF984, "M", "濾"),
+        (0xF985, "M", "礪"),
+        (0xF986, "M", "閭"),
+        (0xF987, "M", "驪"),
+        (0xF988, "M", "麗"),
+        (0xF989, "M", "黎"),
+        (0xF98A, "M", "力"),
+        (0xF98B, "M", "曆"),
+        (0xF98C, "M", "歷"),
+        (0xF98D, "M", "轢"),
+        (0xF98E, "M", "年"),
+        (0xF98F, "M", "憐"),
+        (0xF990, "M", "戀"),
+        (0xF991, "M", "撚"),
+        (0xF992, "M", "漣"),
+        (0xF993, "M", "煉"),
+        (0xF994, "M", "璉"),
+        (0xF995, "M", "秊"),
+        (0xF996, "M", "練"),
+        (0xF997, "M", "聯"),
+        (0xF998, "M", "輦"),
+        (0xF999, "M", "蓮"),
+        (0xF99A, "M", "連"),
+        (0xF99B, "M", "鍊"),
+        (0xF99C, "M", "列"),
+        (0xF99D, "M", "劣"),
+        (0xF99E, "M", "咽"),
+        (0xF99F, "M", "烈"),
+        (0xF9A0, "M", "裂"),
+        (0xF9A1, "M", "說"),
+        (0xF9A2, "M", "廉"),
+        (0xF9A3, "M", "念"),
+        (0xF9A4, "M", "捻"),
+        (0xF9A5, "M", "殮"),
+        (0xF9A6, "M", "簾"),
+        (0xF9A7, "M", "獵"),
+        (0xF9A8, "M", "令"),
+        (0xF9A9, "M", "囹"),
+        (0xF9AA, "M", "寧"),
+        (0xF9AB, "M", "嶺"),
+        (0xF9AC, "M", "怜"),
+        (0xF9AD, "M", "玲"),
     ]
 
+
 def _seg_41() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0xF9AE, 'M', '瑩'),
-    (0xF9AF, 'M', '羚'),
-    (0xF9B0, 'M', '聆'),
-    (0xF9B1, 'M', '鈴'),
-    (0xF9B2, 'M', '零'),
-    (0xF9B3, 'M', '靈'),
-    (0xF9B4, 'M', '領'),
-    (0xF9B5, 'M', '例'),
-    (0xF9B6, 'M', '禮'),
-    (0xF9B7, 'M', '醴'),
-    (0xF9B8, 'M', '隸'),
-    (0xF9B9, 'M', '惡'),
-    (0xF9BA, 'M', '了'),
-    (0xF9BB, 'M', '僚'),
-    (0xF9BC, 'M', '寮'),
-    (0xF9BD, 'M', '尿'),
-    (0xF9BE, 'M', '料'),
-    (0xF9BF, 'M', '樂'),
-    (0xF9C0, 'M', '燎'),
-    (0xF9C1, 'M', '療'),
-    (0xF9C2, 'M', '蓼'),
-    (0xF9C3, 'M', '遼'),
-    (0xF9C4, 'M', '龍'),
-    (0xF9C5, 'M', '暈'),
-    (0xF9C6, 'M', '阮'),
-    (0xF9C7, 'M', '劉'),
-    (0xF9C8, 'M', '杻'),
-    (0xF9C9, 'M', '柳'),
-    (0xF9CA, 'M', '流'),
-    (0xF9CB, 'M', '溜'),
-    (0xF9CC, 'M', '琉'),
-    (0xF9CD, 'M', '留'),
-    (0xF9CE, 'M', '硫'),
-    (0xF9CF, 'M', '紐'),
-    (0xF9D0, 'M', '類'),
-    (0xF9D1, 'M', '六'),
-    (0xF9D2, 'M', '戮'),
-    (0xF9D3, 'M', '陸'),
-    (0xF9D4, 'M', '倫'),
-    (0xF9D5, 'M', '崙'),
-    (0xF9D6, 'M', '淪'),
-    (0xF9D7, 'M', '輪'),
-    (0xF9D8, 'M', '律'),
-    (0xF9D9, 'M', '慄'),
-    (0xF9DA, 'M', '栗'),
-    (0xF9DB, 'M', '率'),
-    (0xF9DC, 'M', '隆'),
-    (0xF9DD, 'M', '利'),
-    (0xF9DE, 'M', '吏'),
-    (0xF9DF, 'M', '履'),
-    (0xF9E0, 'M', '易'),
-    (0xF9E1, 'M', '李'),
-    (0xF9E2, 'M', '梨'),
-    (0xF9E3, 'M', '泥'),
-    (0xF9E4, 'M', '理'),
-    (0xF9E5, 'M', '痢'),
-    (0xF9E6, 'M', '罹'),
-    (0xF9E7, 'M', '裏'),
-    (0xF9E8, 'M', '裡'),
-    (0xF9E9, 'M', '里'),
-    (0xF9EA, 'M', '離'),
-    (0xF9EB, 'M', '匿'),
-    (0xF9EC, 'M', '溺'),
-    (0xF9ED, 'M', '吝'),
-    (0xF9EE, 'M', '燐'),
-    (0xF9EF, 'M', '璘'),
-    (0xF9F0, 'M', '藺'),
-    (0xF9F1, 'M', '隣'),
-    (0xF9F2, 'M', '鱗'),
-    (0xF9F3, 'M', '麟'),
-    (0xF9F4, 'M', '林'),
-    (0xF9F5, 'M', '淋'),
-    (0xF9F6, 'M', '臨'),
-    (0xF9F7, 'M', '立'),
-    (0xF9F8, 'M', '笠'),
-    (0xF9F9, 'M', '粒'),
-    (0xF9FA, 'M', '狀'),
-    (0xF9FB, 'M', '炙'),
-    (0xF9FC, 'M', '識'),
-    (0xF9FD, 'M', '什'),
-    (0xF9FE, 'M', '茶'),
-    (0xF9FF, 'M', '刺'),
-    (0xFA00, 'M', '切'),
-    (0xFA01, 'M', '度'),
-    (0xFA02, 'M', '拓'),
-    (0xFA03, 'M', '糖'),
-    (0xFA04, 'M', '宅'),
-    (0xFA05, 'M', '洞'),
-    (0xFA06, 'M', '暴'),
-    (0xFA07, 'M', '輻'),
-    (0xFA08, 'M', '行'),
-    (0xFA09, 'M', '降'),
-    (0xFA0A, 'M', '見'),
-    (0xFA0B, 'M', '廓'),
-    (0xFA0C, 'M', '兀'),
-    (0xFA0D, 'M', '嗀'),
-    (0xFA0E, 'V'),
-    (0xFA10, 'M', '塚'),
-    (0xFA11, 'V'),
-    (0xFA12, 'M', '晴'),
+        (0xF9AE, "M", "瑩"),
+        (0xF9AF, "M", "羚"),
+        (0xF9B0, "M", "聆"),
+        (0xF9B1, "M", "鈴"),
+        (0xF9B2, "M", "零"),
+        (0xF9B3, "M", "靈"),
+        (0xF9B4, "M", "領"),
+        (0xF9B5, "M", "例"),
+        (0xF9B6, "M", "禮"),
+        (0xF9B7, "M", "醴"),
+        (0xF9B8, "M", "隸"),
+        (0xF9B9, "M", "惡"),
+        (0xF9BA, "M", "了"),
+        (0xF9BB, "M", "僚"),
+        (0xF9BC, "M", "寮"),
+        (0xF9BD, "M", "尿"),
+        (0xF9BE, "M", "料"),
+        (0xF9BF, "M", "樂"),
+        (0xF9C0, "M", "燎"),
+        (0xF9C1, "M", "療"),
+        (0xF9C2, "M", "蓼"),
+        (0xF9C3, "M", "遼"),
+        (0xF9C4, "M", "龍"),
+        (0xF9C5, "M", "暈"),
+        (0xF9C6, "M", "阮"),
+        (0xF9C7, "M", "劉"),
+        (0xF9C8, "M", "杻"),
+        (0xF9C9, "M", "柳"),
+        (0xF9CA, "M", "流"),
+        (0xF9CB, "M", "溜"),
+        (0xF9CC, "M", "琉"),
+        (0xF9CD, "M", "留"),
+        (0xF9CE, "M", "硫"),
+        (0xF9CF, "M", "紐"),
+        (0xF9D0, "M", "類"),
+        (0xF9D1, "M", "六"),
+        (0xF9D2, "M", "戮"),
+        (0xF9D3, "M", "陸"),
+        (0xF9D4, "M", "倫"),
+        (0xF9D5, "M", "崙"),
+        (0xF9D6, "M", "淪"),
+        (0xF9D7, "M", "輪"),
+        (0xF9D8, "M", "律"),
+        (0xF9D9, "M", "慄"),
+        (0xF9DA, "M", "栗"),
+        (0xF9DB, "M", "率"),
+        (0xF9DC, "M", "隆"),
+        (0xF9DD, "M", "利"),
+        (0xF9DE, "M", "吏"),
+        (0xF9DF, "M", "履"),
+        (0xF9E0, "M", "易"),
+        (0xF9E1, "M", "李"),
+        (0xF9E2, "M", "梨"),
+        (0xF9E3, "M", "泥"),
+        (0xF9E4, "M", "理"),
+        (0xF9E5, "M", "痢"),
+        (0xF9E6, "M", "罹"),
+        (0xF9E7, "M", "裏"),
+        (0xF9E8, "M", "裡"),
+        (0xF9E9, "M", "里"),
+        (0xF9EA, "M", "離"),
+        (0xF9EB, "M", "匿"),
+        (0xF9EC, "M", "溺"),
+        (0xF9ED, "M", "吝"),
+        (0xF9EE, "M", "燐"),
+        (0xF9EF, "M", "璘"),
+        (0xF9F0, "M", "藺"),
+        (0xF9F1, "M", "隣"),
+        (0xF9F2, "M", "鱗"),
+        (0xF9F3, "M", "麟"),
+        (0xF9F4, "M", "林"),
+        (0xF9F5, "M", "淋"),
+        (0xF9F6, "M", "臨"),
+        (0xF9F7, "M", "立"),
+        (0xF9F8, "M", "笠"),
+        (0xF9F9, "M", "粒"),
+        (0xF9FA, "M", "狀"),
+        (0xF9FB, "M", "炙"),
+        (0xF9FC, "M", "識"),
+        (0xF9FD, "M", "什"),
+        (0xF9FE, "M", "茶"),
+        (0xF9FF, "M", "刺"),
+        (0xFA00, "M", "切"),
+        (0xFA01, "M", "度"),
+        (0xFA02, "M", "拓"),
+        (0xFA03, "M", "糖"),
+        (0xFA04, "M", "宅"),
+        (0xFA05, "M", "洞"),
+        (0xFA06, "M", "暴"),
+        (0xFA07, "M", "輻"),
+        (0xFA08, "M", "行"),
+        (0xFA09, "M", "降"),
+        (0xFA0A, "M", "見"),
+        (0xFA0B, "M", "廓"),
+        (0xFA0C, "M", "兀"),
+        (0xFA0D, "M", "嗀"),
+        (0xFA0E, "V"),
+        (0xFA10, "M", "塚"),
+        (0xFA11, "V"),
+        (0xFA12, "M", "晴"),
     ]
 
+
 def _seg_42() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0xFA13, 'V'),
-    (0xFA15, 'M', '凞'),
-    (0xFA16, 'M', '猪'),
-    (0xFA17, 'M', '益'),
-    (0xFA18, 'M', '礼'),
-    (0xFA19, 'M', '神'),
-    (0xFA1A, 'M', '祥'),
-    (0xFA1B, 'M', '福'),
-    (0xFA1C, 'M', '靖'),
-    (0xFA1D, 'M', '精'),
-    (0xFA1E, 'M', '羽'),
-    (0xFA1F, 'V'),
-    (0xFA20, 'M', '蘒'),
-    (0xFA21, 'V'),
-    (0xFA22, 'M', '諸'),
-    (0xFA23, 'V'),
-    (0xFA25, 'M', '逸'),
-    (0xFA26, 'M', '都'),
-    (0xFA27, 'V'),
-    (0xFA2A, 'M', '飯'),
-    (0xFA2B, 'M', '飼'),
-    (0xFA2C, 'M', '館'),
-    (0xFA2D, 'M', '鶴'),
-    (0xFA2E, 'M', '郞'),
-    (0xFA2F, 'M', '隷'),
-    (0xFA30, 'M', '侮'),
-    (0xFA31, 'M', '僧'),
-    (0xFA32, 'M', '免'),
-    (0xFA33, 'M', '勉'),
-    (0xFA34, 'M', '勤'),
-    (0xFA35, 'M', '卑'),
-    (0xFA36, 'M', '喝'),
-    (0xFA37, 'M', '嘆'),
-    (0xFA38, 'M', '器'),
-    (0xFA39, 'M', '塀'),
-    (0xFA3A, 'M', '墨'),
-    (0xFA3B, 'M', '層'),
-    (0xFA3C, 'M', '屮'),
-    (0xFA3D, 'M', '悔'),
-    (0xFA3E, 'M', '慨'),
-    (0xFA3F, 'M', '憎'),
-    (0xFA40, 'M', '懲'),
-    (0xFA41, 'M', '敏'),
-    (0xFA42, 'M', '既'),
-    (0xFA43, 'M', '暑'),
-    (0xFA44, 'M', '梅'),
-    (0xFA45, 'M', '海'),
-    (0xFA46, 'M', '渚'),
-    (0xFA47, 'M', '漢'),
-    (0xFA48, 'M', '煮'),
-    (0xFA49, 'M', '爫'),
-    (0xFA4A, 'M', '琢'),
-    (0xFA4B, 'M', '碑'),
-    (0xFA4C, 'M', '社'),
-    (0xFA4D, 'M', '祉'),
-    (0xFA4E, 'M', '祈'),
-    (0xFA4F, 'M', '祐'),
-    (0xFA50, 'M', '祖'),
-    (0xFA51, 'M', '祝'),
-    (0xFA52, 'M', '禍'),
-    (0xFA53, 'M', '禎'),
-    (0xFA54, 'M', '穀'),
-    (0xFA55, 'M', '突'),
-    (0xFA56, 'M', '節'),
-    (0xFA57, 'M', '練'),
-    (0xFA58, 'M', '縉'),
-    (0xFA59, 'M', '繁'),
-    (0xFA5A, 'M', '署'),
-    (0xFA5B, 'M', '者'),
-    (0xFA5C, 'M', '臭'),
-    (0xFA5D, 'M', '艹'),
-    (0xFA5F, 'M', '著'),
-    (0xFA60, 'M', '褐'),
-    (0xFA61, 'M', '視'),
-    (0xFA62, 'M', '謁'),
-    (0xFA63, 'M', '謹'),
-    (0xFA64, 'M', '賓'),
-    (0xFA65, 'M', '贈'),
-    (0xFA66, 'M', '辶'),
-    (0xFA67, 'M', '逸'),
-    (0xFA68, 'M', '難'),
-    (0xFA69, 'M', '響'),
-    (0xFA6A, 'M', '頻'),
-    (0xFA6B, 'M', '恵'),
-    (0xFA6C, 'M', '𤋮'),
-    (0xFA6D, 'M', '舘'),
-    (0xFA6E, 'X'),
-    (0xFA70, 'M', '並'),
-    (0xFA71, 'M', '况'),
-    (0xFA72, 'M', '全'),
-    (0xFA73, 'M', '侀'),
-    (0xFA74, 'M', '充'),
-    (0xFA75, 'M', '冀'),
-    (0xFA76, 'M', '勇'),
-    (0xFA77, 'M', '勺'),
-    (0xFA78, 'M', '喝'),
-    (0xFA79, 'M', '啕'),
-    (0xFA7A, 'M', '喙'),
-    (0xFA7B, 'M', '嗢'),
-    (0xFA7C, 'M', '塚'),
+        (0xFA13, "V"),
+        (0xFA15, "M", "凞"),
+        (0xFA16, "M", "猪"),
+        (0xFA17, "M", "益"),
+        (0xFA18, "M", "礼"),
+        (0xFA19, "M", "神"),
+        (0xFA1A, "M", "祥"),
+        (0xFA1B, "M", "福"),
+        (0xFA1C, "M", "靖"),
+        (0xFA1D, "M", "精"),
+        (0xFA1E, "M", "羽"),
+        (0xFA1F, "V"),
+        (0xFA20, "M", "蘒"),
+        (0xFA21, "V"),
+        (0xFA22, "M", "諸"),
+        (0xFA23, "V"),
+        (0xFA25, "M", "逸"),
+        (0xFA26, "M", "都"),
+        (0xFA27, "V"),
+        (0xFA2A, "M", "飯"),
+        (0xFA2B, "M", "飼"),
+        (0xFA2C, "M", "館"),
+        (0xFA2D, "M", "鶴"),
+        (0xFA2E, "M", "郞"),
+        (0xFA2F, "M", "隷"),
+        (0xFA30, "M", "侮"),
+        (0xFA31, "M", "僧"),
+        (0xFA32, "M", "免"),
+        (0xFA33, "M", "勉"),
+        (0xFA34, "M", "勤"),
+        (0xFA35, "M", "卑"),
+        (0xFA36, "M", "喝"),
+        (0xFA37, "M", "嘆"),
+        (0xFA38, "M", "器"),
+        (0xFA39, "M", "塀"),
+        (0xFA3A, "M", "墨"),
+        (0xFA3B, "M", "層"),
+        (0xFA3C, "M", "屮"),
+        (0xFA3D, "M", "悔"),
+        (0xFA3E, "M", "慨"),
+        (0xFA3F, "M", "憎"),
+        (0xFA40, "M", "懲"),
+        (0xFA41, "M", "敏"),
+        (0xFA42, "M", "既"),
+        (0xFA43, "M", "暑"),
+        (0xFA44, "M", "梅"),
+        (0xFA45, "M", "海"),
+        (0xFA46, "M", "渚"),
+        (0xFA47, "M", "漢"),
+        (0xFA48, "M", "煮"),
+        (0xFA49, "M", "爫"),
+        (0xFA4A, "M", "琢"),
+        (0xFA4B, "M", "碑"),
+        (0xFA4C, "M", "社"),
+        (0xFA4D, "M", "祉"),
+        (0xFA4E, "M", "祈"),
+        (0xFA4F, "M", "祐"),
+        (0xFA50, "M", "祖"),
+        (0xFA51, "M", "祝"),
+        (0xFA52, "M", "禍"),
+        (0xFA53, "M", "禎"),
+        (0xFA54, "M", "穀"),
+        (0xFA55, "M", "突"),
+        (0xFA56, "M", "節"),
+        (0xFA57, "M", "練"),
+        (0xFA58, "M", "縉"),
+        (0xFA59, "M", "繁"),
+        (0xFA5A, "M", "署"),
+        (0xFA5B, "M", "者"),
+        (0xFA5C, "M", "臭"),
+        (0xFA5D, "M", "艹"),
+        (0xFA5F, "M", "著"),
+        (0xFA60, "M", "褐"),
+        (0xFA61, "M", "視"),
+        (0xFA62, "M", "謁"),
+        (0xFA63, "M", "謹"),
+        (0xFA64, "M", "賓"),
+        (0xFA65, "M", "贈"),
+        (0xFA66, "M", "辶"),
+        (0xFA67, "M", "逸"),
+        (0xFA68, "M", "難"),
+        (0xFA69, "M", "響"),
+        (0xFA6A, "M", "頻"),
+        (0xFA6B, "M", "恵"),
+        (0xFA6C, "M", "𤋮"),
+        (0xFA6D, "M", "舘"),
+        (0xFA6E, "X"),
+        (0xFA70, "M", "並"),
+        (0xFA71, "M", "况"),
+        (0xFA72, "M", "全"),
+        (0xFA73, "M", "侀"),
+        (0xFA74, "M", "充"),
+        (0xFA75, "M", "冀"),
+        (0xFA76, "M", "勇"),
+        (0xFA77, "M", "勺"),
+        (0xFA78, "M", "喝"),
+        (0xFA79, "M", "啕"),
+        (0xFA7A, "M", "喙"),
+        (0xFA7B, "M", "嗢"),
+        (0xFA7C, "M", "塚"),
     ]
 
+
 def _seg_43() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0xFA7D, 'M', '墳'),
-    (0xFA7E, 'M', '奄'),
-    (0xFA7F, 'M', '奔'),
-    (0xFA80, 'M', '婢'),
-    (0xFA81, 'M', '嬨'),
-    (0xFA82, 'M', '廒'),
-    (0xFA83, 'M', '廙'),
-    (0xFA84, 'M', '彩'),
-    (0xFA85, 'M', '徭'),
-    (0xFA86, 'M', '惘'),
-    (0xFA87, 'M', '慎'),
-    (0xFA88, 'M', '愈'),
-    (0xFA89, 'M', '憎'),
-    (0xFA8A, 'M', '慠'),
-    (0xFA8B, 'M', '懲'),
-    (0xFA8C, 'M', '戴'),
-    (0xFA8D, 'M', '揄'),
-    (0xFA8E, 'M', '搜'),
-    (0xFA8F, 'M', '摒'),
-    (0xFA90, 'M', '敖'),
-    (0xFA91, 'M', '晴'),
-    (0xFA92, 'M', '朗'),
-    (0xFA93, 'M', '望'),
-    (0xFA94, 'M', '杖'),
-    (0xFA95, 'M', '歹'),
-    (0xFA96, 'M', '殺'),
-    (0xFA97, 'M', '流'),
-    (0xFA98, 'M', '滛'),
-    (0xFA99, 'M', '滋'),
-    (0xFA9A, 'M', '漢'),
-    (0xFA9B, 'M', '瀞'),
-    (0xFA9C, 'M', '煮'),
-    (0xFA9D, 'M', '瞧'),
-    (0xFA9E, 'M', '爵'),
-    (0xFA9F, 'M', '犯'),
-    (0xFAA0, 'M', '猪'),
-    (0xFAA1, 'M', '瑱'),
-    (0xFAA2, 'M', '甆'),
-    (0xFAA3, 'M', '画'),
-    (0xFAA4, 'M', '瘝'),
-    (0xFAA5, 'M', '瘟'),
-    (0xFAA6, 'M', '益'),
-    (0xFAA7, 'M', '盛'),
-    (0xFAA8, 'M', '直'),
-    (0xFAA9, 'M', '睊'),
-    (0xFAAA, 'M', '着'),
-    (0xFAAB, 'M', '磌'),
-    (0xFAAC, 'M', '窱'),
-    (0xFAAD, 'M', '節'),
-    (0xFAAE, 'M', '类'),
-    (0xFAAF, 'M', '絛'),
-    (0xFAB0, 'M', '練'),
-    (0xFAB1, 'M', '缾'),
-    (0xFAB2, 'M', '者'),
-    (0xFAB3, 'M', '荒'),
-    (0xFAB4, 'M', '華'),
-    (0xFAB5, 'M', '蝹'),
-    (0xFAB6, 'M', '襁'),
-    (0xFAB7, 'M', '覆'),
-    (0xFAB8, 'M', '視'),
-    (0xFAB9, 'M', '調'),
-    (0xFABA, 'M', '諸'),
-    (0xFABB, 'M', '請'),
-    (0xFABC, 'M', '謁'),
-    (0xFABD, 'M', '諾'),
-    (0xFABE, 'M', '諭'),
-    (0xFABF, 'M', '謹'),
-    (0xFAC0, 'M', '變'),
-    (0xFAC1, 'M', '贈'),
-    (0xFAC2, 'M', '輸'),
-    (0xFAC3, 'M', '遲'),
-    (0xFAC4, 'M', '醙'),
-    (0xFAC5, 'M', '鉶'),
-    (0xFAC6, 'M', '陼'),
-    (0xFAC7, 'M', '難'),
-    (0xFAC8, 'M', '靖'),
-    (0xFAC9, 'M', '韛'),
-    (0xFACA, 'M', '響'),
-    (0xFACB, 'M', '頋'),
-    (0xFACC, 'M', '頻'),
-    (0xFACD, 'M', '鬒'),
-    (0xFACE, 'M', '龜'),
-    (0xFACF, 'M', '𢡊'),
-    (0xFAD0, 'M', '𢡄'),
-    (0xFAD1, 'M', '𣏕'),
-    (0xFAD2, 'M', '㮝'),
-    (0xFAD3, 'M', '䀘'),
-    (0xFAD4, 'M', '䀹'),
-    (0xFAD5, 'M', '𥉉'),
-    (0xFAD6, 'M', '𥳐'),
-    (0xFAD7, 'M', '𧻓'),
-    (0xFAD8, 'M', '齃'),
-    (0xFAD9, 'M', '龎'),
-    (0xFADA, 'X'),
-    (0xFB00, 'M', 'ff'),
-    (0xFB01, 'M', 'fi'),
-    (0xFB02, 'M', 'fl'),
-    (0xFB03, 'M', 'ffi'),
-    (0xFB04, 'M', 'ffl'),
-    (0xFB05, 'M', 'st'),
+        (0xFA7D, "M", "墳"),
+        (0xFA7E, "M", "奄"),
+        (0xFA7F, "M", "奔"),
+        (0xFA80, "M", "婢"),
+        (0xFA81, "M", "嬨"),
+        (0xFA82, "M", "廒"),
+        (0xFA83, "M", "廙"),
+        (0xFA84, "M", "彩"),
+        (0xFA85, "M", "徭"),
+        (0xFA86, "M", "惘"),
+        (0xFA87, "M", "慎"),
+        (0xFA88, "M", "愈"),
+        (0xFA89, "M", "憎"),
+        (0xFA8A, "M", "慠"),
+        (0xFA8B, "M", "懲"),
+        (0xFA8C, "M", "戴"),
+        (0xFA8D, "M", "揄"),
+        (0xFA8E, "M", "搜"),
+        (0xFA8F, "M", "摒"),
+        (0xFA90, "M", "敖"),
+        (0xFA91, "M", "晴"),
+        (0xFA92, "M", "朗"),
+        (0xFA93, "M", "望"),
+        (0xFA94, "M", "杖"),
+        (0xFA95, "M", "歹"),
+        (0xFA96, "M", "殺"),
+        (0xFA97, "M", "流"),
+        (0xFA98, "M", "滛"),
+        (0xFA99, "M", "滋"),
+        (0xFA9A, "M", "漢"),
+        (0xFA9B, "M", "瀞"),
+        (0xFA9C, "M", "煮"),
+        (0xFA9D, "M", "瞧"),
+        (0xFA9E, "M", "爵"),
+        (0xFA9F, "M", "犯"),
+        (0xFAA0, "M", "猪"),
+        (0xFAA1, "M", "瑱"),
+        (0xFAA2, "M", "甆"),
+        (0xFAA3, "M", "画"),
+        (0xFAA4, "M", "瘝"),
+        (0xFAA5, "M", "瘟"),
+        (0xFAA6, "M", "益"),
+        (0xFAA7, "M", "盛"),
+        (0xFAA8, "M", "直"),
+        (0xFAA9, "M", "睊"),
+        (0xFAAA, "M", "着"),
+        (0xFAAB, "M", "磌"),
+        (0xFAAC, "M", "窱"),
+        (0xFAAD, "M", "節"),
+        (0xFAAE, "M", "类"),
+        (0xFAAF, "M", "絛"),
+        (0xFAB0, "M", "練"),
+        (0xFAB1, "M", "缾"),
+        (0xFAB2, "M", "者"),
+        (0xFAB3, "M", "荒"),
+        (0xFAB4, "M", "華"),
+        (0xFAB5, "M", "蝹"),
+        (0xFAB6, "M", "襁"),
+        (0xFAB7, "M", "覆"),
+        (0xFAB8, "M", "視"),
+        (0xFAB9, "M", "調"),
+        (0xFABA, "M", "諸"),
+        (0xFABB, "M", "請"),
+        (0xFABC, "M", "謁"),
+        (0xFABD, "M", "諾"),
+        (0xFABE, "M", "諭"),
+        (0xFABF, "M", "謹"),
+        (0xFAC0, "M", "變"),
+        (0xFAC1, "M", "贈"),
+        (0xFAC2, "M", "輸"),
+        (0xFAC3, "M", "遲"),
+        (0xFAC4, "M", "醙"),
+        (0xFAC5, "M", "鉶"),
+        (0xFAC6, "M", "陼"),
+        (0xFAC7, "M", "難"),
+        (0xFAC8, "M", "靖"),
+        (0xFAC9, "M", "韛"),
+        (0xFACA, "M", "響"),
+        (0xFACB, "M", "頋"),
+        (0xFACC, "M", "頻"),
+        (0xFACD, "M", "鬒"),
+        (0xFACE, "M", "龜"),
+        (0xFACF, "M", "𢡊"),
+        (0xFAD0, "M", "𢡄"),
+        (0xFAD1, "M", "𣏕"),
+        (0xFAD2, "M", "㮝"),
+        (0xFAD3, "M", "䀘"),
+        (0xFAD4, "M", "䀹"),
+        (0xFAD5, "M", "𥉉"),
+        (0xFAD6, "M", "𥳐"),
+        (0xFAD7, "M", "𧻓"),
+        (0xFAD8, "M", "齃"),
+        (0xFAD9, "M", "龎"),
+        (0xFADA, "X"),
+        (0xFB00, "M", "ff"),
+        (0xFB01, "M", "fi"),
+        (0xFB02, "M", "fl"),
+        (0xFB03, "M", "ffi"),
+        (0xFB04, "M", "ffl"),
+        (0xFB05, "M", "st"),
     ]
 
+
 def _seg_44() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0xFB07, 'X'),
-    (0xFB13, 'M', 'մն'),
-    (0xFB14, 'M', 'մե'),
-    (0xFB15, 'M', 'մի'),
-    (0xFB16, 'M', 'վն'),
-    (0xFB17, 'M', 'մխ'),
-    (0xFB18, 'X'),
-    (0xFB1D, 'M', 'יִ'),
-    (0xFB1E, 'V'),
-    (0xFB1F, 'M', 'ײַ'),
-    (0xFB20, 'M', 'ע'),
-    (0xFB21, 'M', 'א'),
-    (0xFB22, 'M', 'ד'),
-    (0xFB23, 'M', 'ה'),
-    (0xFB24, 'M', 'כ'),
-    (0xFB25, 'M', 'ל'),
-    (0xFB26, 'M', 'ם'),
-    (0xFB27, 'M', 'ר'),
-    (0xFB28, 'M', 'ת'),
-    (0xFB29, '3', '+'),
-    (0xFB2A, 'M', 'שׁ'),
-    (0xFB2B, 'M', 'שׂ'),
-    (0xFB2C, 'M', 'שּׁ'),
-    (0xFB2D, 'M', 'שּׂ'),
-    (0xFB2E, 'M', 'אַ'),
-    (0xFB2F, 'M', 'אָ'),
-    (0xFB30, 'M', 'אּ'),
-    (0xFB31, 'M', 'בּ'),
-    (0xFB32, 'M', 'גּ'),
-    (0xFB33, 'M', 'דּ'),
-    (0xFB34, 'M', 'הּ'),
-    (0xFB35, 'M', 'וּ'),
-    (0xFB36, 'M', 'זּ'),
-    (0xFB37, 'X'),
-    (0xFB38, 'M', 'טּ'),
-    (0xFB39, 'M', 'יּ'),
-    (0xFB3A, 'M', 'ךּ'),
-    (0xFB3B, 'M', 'כּ'),
-    (0xFB3C, 'M', 'לּ'),
-    (0xFB3D, 'X'),
-    (0xFB3E, 'M', 'מּ'),
-    (0xFB3F, 'X'),
-    (0xFB40, 'M', 'נּ'),
-    (0xFB41, 'M', 'סּ'),
-    (0xFB42, 'X'),
-    (0xFB43, 'M', 'ףּ'),
-    (0xFB44, 'M', 'פּ'),
-    (0xFB45, 'X'),
-    (0xFB46, 'M', 'צּ'),
-    (0xFB47, 'M', 'קּ'),
-    (0xFB48, 'M', 'רּ'),
-    (0xFB49, 'M', 'שּ'),
-    (0xFB4A, 'M', 'תּ'),
-    (0xFB4B, 'M', 'וֹ'),
-    (0xFB4C, 'M', 'בֿ'),
-    (0xFB4D, 'M', 'כֿ'),
-    (0xFB4E, 'M', 'פֿ'),
-    (0xFB4F, 'M', 'אל'),
-    (0xFB50, 'M', 'ٱ'),
-    (0xFB52, 'M', 'ٻ'),
-    (0xFB56, 'M', 'پ'),
-    (0xFB5A, 'M', 'ڀ'),
-    (0xFB5E, 'M', 'ٺ'),
-    (0xFB62, 'M', 'ٿ'),
-    (0xFB66, 'M', 'ٹ'),
-    (0xFB6A, 'M', 'ڤ'),
-    (0xFB6E, 'M', 'ڦ'),
-    (0xFB72, 'M', 'ڄ'),
-    (0xFB76, 'M', 'ڃ'),
-    (0xFB7A, 'M', 'چ'),
-    (0xFB7E, 'M', 'ڇ'),
-    (0xFB82, 'M', 'ڍ'),
-    (0xFB84, 'M', 'ڌ'),
-    (0xFB86, 'M', 'ڎ'),
-    (0xFB88, 'M', 'ڈ'),
-    (0xFB8A, 'M', 'ژ'),
-    (0xFB8C, 'M', 'ڑ'),
-    (0xFB8E, 'M', 'ک'),
-    (0xFB92, 'M', 'گ'),
-    (0xFB96, 'M', 'ڳ'),
-    (0xFB9A, 'M', 'ڱ'),
-    (0xFB9E, 'M', 'ں'),
-    (0xFBA0, 'M', 'ڻ'),
-    (0xFBA4, 'M', 'ۀ'),
-    (0xFBA6, 'M', 'ہ'),
-    (0xFBAA, 'M', 'ھ'),
-    (0xFBAE, 'M', 'ے'),
-    (0xFBB0, 'M', 'ۓ'),
-    (0xFBB2, 'V'),
-    (0xFBC3, 'X'),
-    (0xFBD3, 'M', 'ڭ'),
-    (0xFBD7, 'M', 'ۇ'),
-    (0xFBD9, 'M', 'ۆ'),
-    (0xFBDB, 'M', 'ۈ'),
-    (0xFBDD, 'M', 'ۇٴ'),
-    (0xFBDE, 'M', 'ۋ'),
-    (0xFBE0, 'M', 'ۅ'),
-    (0xFBE2, 'M', 'ۉ'),
-    (0xFBE4, 'M', 'ې'),
-    (0xFBE8, 'M', 'ى'),
+        (0xFB07, "X"),
+        (0xFB13, "M", "մն"),
+        (0xFB14, "M", "մե"),
+        (0xFB15, "M", "մի"),
+        (0xFB16, "M", "վն"),
+        (0xFB17, "M", "մխ"),
+        (0xFB18, "X"),
+        (0xFB1D, "M", "יִ"),
+        (0xFB1E, "V"),
+        (0xFB1F, "M", "ײַ"),
+        (0xFB20, "M", "ע"),
+        (0xFB21, "M", "א"),
+        (0xFB22, "M", "ד"),
+        (0xFB23, "M", "ה"),
+        (0xFB24, "M", "כ"),
+        (0xFB25, "M", "ל"),
+        (0xFB26, "M", "ם"),
+        (0xFB27, "M", "ר"),
+        (0xFB28, "M", "ת"),
+        (0xFB29, "3", "+"),
+        (0xFB2A, "M", "שׁ"),
+        (0xFB2B, "M", "שׂ"),
+        (0xFB2C, "M", "שּׁ"),
+        (0xFB2D, "M", "שּׂ"),
+        (0xFB2E, "M", "אַ"),
+        (0xFB2F, "M", "אָ"),
+        (0xFB30, "M", "אּ"),
+        (0xFB31, "M", "בּ"),
+        (0xFB32, "M", "גּ"),
+        (0xFB33, "M", "דּ"),
+        (0xFB34, "M", "הּ"),
+        (0xFB35, "M", "וּ"),
+        (0xFB36, "M", "זּ"),
+        (0xFB37, "X"),
+        (0xFB38, "M", "טּ"),
+        (0xFB39, "M", "יּ"),
+        (0xFB3A, "M", "ךּ"),
+        (0xFB3B, "M", "כּ"),
+        (0xFB3C, "M", "לּ"),
+        (0xFB3D, "X"),
+        (0xFB3E, "M", "מּ"),
+        (0xFB3F, "X"),
+        (0xFB40, "M", "נּ"),
+        (0xFB41, "M", "סּ"),
+        (0xFB42, "X"),
+        (0xFB43, "M", "ףּ"),
+        (0xFB44, "M", "פּ"),
+        (0xFB45, "X"),
+        (0xFB46, "M", "צּ"),
+        (0xFB47, "M", "קּ"),
+        (0xFB48, "M", "רּ"),
+        (0xFB49, "M", "שּ"),
+        (0xFB4A, "M", "תּ"),
+        (0xFB4B, "M", "וֹ"),
+        (0xFB4C, "M", "בֿ"),
+        (0xFB4D, "M", "כֿ"),
+        (0xFB4E, "M", "פֿ"),
+        (0xFB4F, "M", "אל"),
+        (0xFB50, "M", "ٱ"),
+        (0xFB52, "M", "ٻ"),
+        (0xFB56, "M", "پ"),
+        (0xFB5A, "M", "ڀ"),
+        (0xFB5E, "M", "ٺ"),
+        (0xFB62, "M", "ٿ"),
+        (0xFB66, "M", "ٹ"),
+        (0xFB6A, "M", "ڤ"),
+        (0xFB6E, "M", "ڦ"),
+        (0xFB72, "M", "ڄ"),
+        (0xFB76, "M", "ڃ"),
+        (0xFB7A, "M", "چ"),
+        (0xFB7E, "M", "ڇ"),
+        (0xFB82, "M", "ڍ"),
+        (0xFB84, "M", "ڌ"),
+        (0xFB86, "M", "ڎ"),
+        (0xFB88, "M", "ڈ"),
+        (0xFB8A, "M", "ژ"),
+        (0xFB8C, "M", "ڑ"),
+        (0xFB8E, "M", "ک"),
+        (0xFB92, "M", "گ"),
+        (0xFB96, "M", "ڳ"),
+        (0xFB9A, "M", "ڱ"),
+        (0xFB9E, "M", "ں"),
+        (0xFBA0, "M", "ڻ"),
+        (0xFBA4, "M", "ۀ"),
+        (0xFBA6, "M", "ہ"),
+        (0xFBAA, "M", "ھ"),
+        (0xFBAE, "M", "ے"),
+        (0xFBB0, "M", "ۓ"),
+        (0xFBB2, "V"),
+        (0xFBC3, "X"),
+        (0xFBD3, "M", "ڭ"),
+        (0xFBD7, "M", "ۇ"),
+        (0xFBD9, "M", "ۆ"),
+        (0xFBDB, "M", "ۈ"),
+        (0xFBDD, "M", "ۇٴ"),
+        (0xFBDE, "M", "ۋ"),
+        (0xFBE0, "M", "ۅ"),
+        (0xFBE2, "M", "ۉ"),
+        (0xFBE4, "M", "ې"),
+        (0xFBE8, "M", "ى"),
     ]
 
+
 def _seg_45() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0xFBEA, 'M', 'ئا'),
-    (0xFBEC, 'M', 'ئە'),
-    (0xFBEE, 'M', 'ئو'),
-    (0xFBF0, 'M', 'ئۇ'),
-    (0xFBF2, 'M', 'ئۆ'),
-    (0xFBF4, 'M', 'ئۈ'),
-    (0xFBF6, 'M', 'ئې'),
-    (0xFBF9, 'M', 'ئى'),
-    (0xFBFC, 'M', 'ی'),
-    (0xFC00, 'M', 'ئج'),
-    (0xFC01, 'M', 'ئح'),
-    (0xFC02, 'M', 'ئم'),
-    (0xFC03, 'M', 'ئى'),
-    (0xFC04, 'M', 'ئي'),
-    (0xFC05, 'M', 'بج'),
-    (0xFC06, 'M', 'بح'),
-    (0xFC07, 'M', 'بخ'),
-    (0xFC08, 'M', 'بم'),
-    (0xFC09, 'M', 'بى'),
-    (0xFC0A, 'M', 'بي'),
-    (0xFC0B, 'M', 'تج'),
-    (0xFC0C, 'M', 'تح'),
-    (0xFC0D, 'M', 'تخ'),
-    (0xFC0E, 'M', 'تم'),
-    (0xFC0F, 'M', 'تى'),
-    (0xFC10, 'M', 'تي'),
-    (0xFC11, 'M', 'ثج'),
-    (0xFC12, 'M', 'ثم'),
-    (0xFC13, 'M', 'ثى'),
-    (0xFC14, 'M', 'ثي'),
-    (0xFC15, 'M', 'جح'),
-    (0xFC16, 'M', 'جم'),
-    (0xFC17, 'M', 'حج'),
-    (0xFC18, 'M', 'حم'),
-    (0xFC19, 'M', 'خج'),
-    (0xFC1A, 'M', 'خح'),
-    (0xFC1B, 'M', 'خم'),
-    (0xFC1C, 'M', 'سج'),
-    (0xFC1D, 'M', 'سح'),
-    (0xFC1E, 'M', 'سخ'),
-    (0xFC1F, 'M', 'سم'),
-    (0xFC20, 'M', 'صح'),
-    (0xFC21, 'M', 'صم'),
-    (0xFC22, 'M', 'ضج'),
-    (0xFC23, 'M', 'ضح'),
-    (0xFC24, 'M', 'ضخ'),
-    (0xFC25, 'M', 'ضم'),
-    (0xFC26, 'M', 'طح'),
-    (0xFC27, 'M', 'طم'),
-    (0xFC28, 'M', 'ظم'),
-    (0xFC29, 'M', 'عج'),
-    (0xFC2A, 'M', 'عم'),
-    (0xFC2B, 'M', 'غج'),
-    (0xFC2C, 'M', 'غم'),
-    (0xFC2D, 'M', 'فج'),
-    (0xFC2E, 'M', 'فح'),
-    (0xFC2F, 'M', 'فخ'),
-    (0xFC30, 'M', 'فم'),
-    (0xFC31, 'M', 'فى'),
-    (0xFC32, 'M', 'في'),
-    (0xFC33, 'M', 'قح'),
-    (0xFC34, 'M', 'قم'),
-    (0xFC35, 'M', 'قى'),
-    (0xFC36, 'M', 'قي'),
-    (0xFC37, 'M', 'كا'),
-    (0xFC38, 'M', 'كج'),
-    (0xFC39, 'M', 'كح'),
-    (0xFC3A, 'M', 'كخ'),
-    (0xFC3B, 'M', 'كل'),
-    (0xFC3C, 'M', 'كم'),
-    (0xFC3D, 'M', 'كى'),
-    (0xFC3E, 'M', 'كي'),
-    (0xFC3F, 'M', 'لج'),
-    (0xFC40, 'M', 'لح'),
-    (0xFC41, 'M', 'لخ'),
-    (0xFC42, 'M', 'لم'),
-    (0xFC43, 'M', 'لى'),
-    (0xFC44, 'M', 'لي'),
-    (0xFC45, 'M', 'مج'),
-    (0xFC46, 'M', 'مح'),
-    (0xFC47, 'M', 'مخ'),
-    (0xFC48, 'M', 'مم'),
-    (0xFC49, 'M', 'مى'),
-    (0xFC4A, 'M', 'مي'),
-    (0xFC4B, 'M', 'نج'),
-    (0xFC4C, 'M', 'نح'),
-    (0xFC4D, 'M', 'نخ'),
-    (0xFC4E, 'M', 'نم'),
-    (0xFC4F, 'M', 'نى'),
-    (0xFC50, 'M', 'ني'),
-    (0xFC51, 'M', 'هج'),
-    (0xFC52, 'M', 'هم'),
-    (0xFC53, 'M', 'هى'),
-    (0xFC54, 'M', 'هي'),
-    (0xFC55, 'M', 'يج'),
-    (0xFC56, 'M', 'يح'),
-    (0xFC57, 'M', 'يخ'),
-    (0xFC58, 'M', 'يم'),
-    (0xFC59, 'M', 'يى'),
-    (0xFC5A, 'M', 'يي'),
+        (0xFBEA, "M", "ئا"),
+        (0xFBEC, "M", "ئە"),
+        (0xFBEE, "M", "ئو"),
+        (0xFBF0, "M", "ئۇ"),
+        (0xFBF2, "M", "ئۆ"),
+        (0xFBF4, "M", "ئۈ"),
+        (0xFBF6, "M", "ئې"),
+        (0xFBF9, "M", "ئى"),
+        (0xFBFC, "M", "ی"),
+        (0xFC00, "M", "ئج"),
+        (0xFC01, "M", "ئح"),
+        (0xFC02, "M", "ئم"),
+        (0xFC03, "M", "ئى"),
+        (0xFC04, "M", "ئي"),
+        (0xFC05, "M", "بج"),
+        (0xFC06, "M", "بح"),
+        (0xFC07, "M", "بخ"),
+        (0xFC08, "M", "بم"),
+        (0xFC09, "M", "بى"),
+        (0xFC0A, "M", "بي"),
+        (0xFC0B, "M", "تج"),
+        (0xFC0C, "M", "تح"),
+        (0xFC0D, "M", "تخ"),
+        (0xFC0E, "M", "تم"),
+        (0xFC0F, "M", "تى"),
+        (0xFC10, "M", "تي"),
+        (0xFC11, "M", "ثج"),
+        (0xFC12, "M", "ثم"),
+        (0xFC13, "M", "ثى"),
+        (0xFC14, "M", "ثي"),
+        (0xFC15, "M", "جح"),
+        (0xFC16, "M", "جم"),
+        (0xFC17, "M", "حج"),
+        (0xFC18, "M", "حم"),
+        (0xFC19, "M", "خج"),
+        (0xFC1A, "M", "خح"),
+        (0xFC1B, "M", "خم"),
+        (0xFC1C, "M", "سج"),
+        (0xFC1D, "M", "سح"),
+        (0xFC1E, "M", "سخ"),
+        (0xFC1F, "M", "سم"),
+        (0xFC20, "M", "صح"),
+        (0xFC21, "M", "صم"),
+        (0xFC22, "M", "ضج"),
+        (0xFC23, "M", "ضح"),
+        (0xFC24, "M", "ضخ"),
+        (0xFC25, "M", "ضم"),
+        (0xFC26, "M", "طح"),
+        (0xFC27, "M", "طم"),
+        (0xFC28, "M", "ظم"),
+        (0xFC29, "M", "عج"),
+        (0xFC2A, "M", "عم"),
+        (0xFC2B, "M", "غج"),
+        (0xFC2C, "M", "غم"),
+        (0xFC2D, "M", "فج"),
+        (0xFC2E, "M", "فح"),
+        (0xFC2F, "M", "فخ"),
+        (0xFC30, "M", "فم"),
+        (0xFC31, "M", "فى"),
+        (0xFC32, "M", "في"),
+        (0xFC33, "M", "قح"),
+        (0xFC34, "M", "قم"),
+        (0xFC35, "M", "قى"),
+        (0xFC36, "M", "قي"),
+        (0xFC37, "M", "كا"),
+        (0xFC38, "M", "كج"),
+        (0xFC39, "M", "كح"),
+        (0xFC3A, "M", "كخ"),
+        (0xFC3B, "M", "كل"),
+        (0xFC3C, "M", "كم"),
+        (0xFC3D, "M", "كى"),
+        (0xFC3E, "M", "كي"),
+        (0xFC3F, "M", "لج"),
+        (0xFC40, "M", "لح"),
+        (0xFC41, "M", "لخ"),
+        (0xFC42, "M", "لم"),
+        (0xFC43, "M", "لى"),
+        (0xFC44, "M", "لي"),
+        (0xFC45, "M", "مج"),
+        (0xFC46, "M", "مح"),
+        (0xFC47, "M", "مخ"),
+        (0xFC48, "M", "مم"),
+        (0xFC49, "M", "مى"),
+        (0xFC4A, "M", "مي"),
+        (0xFC4B, "M", "نج"),
+        (0xFC4C, "M", "نح"),
+        (0xFC4D, "M", "نخ"),
+        (0xFC4E, "M", "نم"),
+        (0xFC4F, "M", "نى"),
+        (0xFC50, "M", "ني"),
+        (0xFC51, "M", "هج"),
+        (0xFC52, "M", "هم"),
+        (0xFC53, "M", "هى"),
+        (0xFC54, "M", "هي"),
+        (0xFC55, "M", "يج"),
+        (0xFC56, "M", "يح"),
+        (0xFC57, "M", "يخ"),
+        (0xFC58, "M", "يم"),
+        (0xFC59, "M", "يى"),
+        (0xFC5A, "M", "يي"),
     ]
 
+
 def _seg_46() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0xFC5B, 'M', 'ذٰ'),
-    (0xFC5C, 'M', 'رٰ'),
-    (0xFC5D, 'M', 'ىٰ'),
-    (0xFC5E, '3', ' ٌّ'),
-    (0xFC5F, '3', ' ٍّ'),
-    (0xFC60, '3', ' َّ'),
-    (0xFC61, '3', ' ُّ'),
-    (0xFC62, '3', ' ِّ'),
-    (0xFC63, '3', ' ّٰ'),
-    (0xFC64, 'M', 'ئر'),
-    (0xFC65, 'M', 'ئز'),
-    (0xFC66, 'M', 'ئم'),
-    (0xFC67, 'M', 'ئن'),
-    (0xFC68, 'M', 'ئى'),
-    (0xFC69, 'M', 'ئي'),
-    (0xFC6A, 'M', 'بر'),
-    (0xFC6B, 'M', 'بز'),
-    (0xFC6C, 'M', 'بم'),
-    (0xFC6D, 'M', 'بن'),
-    (0xFC6E, 'M', 'بى'),
-    (0xFC6F, 'M', 'بي'),
-    (0xFC70, 'M', 'تر'),
-    (0xFC71, 'M', 'تز'),
-    (0xFC72, 'M', 'تم'),
-    (0xFC73, 'M', 'تن'),
-    (0xFC74, 'M', 'تى'),
-    (0xFC75, 'M', 'تي'),
-    (0xFC76, 'M', 'ثر'),
-    (0xFC77, 'M', 'ثز'),
-    (0xFC78, 'M', 'ثم'),
-    (0xFC79, 'M', 'ثن'),
-    (0xFC7A, 'M', 'ثى'),
-    (0xFC7B, 'M', 'ثي'),
-    (0xFC7C, 'M', 'فى'),
-    (0xFC7D, 'M', 'في'),
-    (0xFC7E, 'M', 'قى'),
-    (0xFC7F, 'M', 'قي'),
-    (0xFC80, 'M', 'كا'),
-    (0xFC81, 'M', 'كل'),
-    (0xFC82, 'M', 'كم'),
-    (0xFC83, 'M', 'كى'),
-    (0xFC84, 'M', 'كي'),
-    (0xFC85, 'M', 'لم'),
-    (0xFC86, 'M', 'لى'),
-    (0xFC87, 'M', 'لي'),
-    (0xFC88, 'M', 'ما'),
-    (0xFC89, 'M', 'مم'),
-    (0xFC8A, 'M', 'نر'),
-    (0xFC8B, 'M', 'نز'),
-    (0xFC8C, 'M', 'نم'),
-    (0xFC8D, 'M', 'نن'),
-    (0xFC8E, 'M', 'نى'),
-    (0xFC8F, 'M', 'ني'),
-    (0xFC90, 'M', 'ىٰ'),
-    (0xFC91, 'M', 'ير'),
-    (0xFC92, 'M', 'يز'),
-    (0xFC93, 'M', 'يم'),
-    (0xFC94, 'M', 'ين'),
-    (0xFC95, 'M', 'يى'),
-    (0xFC96, 'M', 'يي'),
-    (0xFC97, 'M', 'ئج'),
-    (0xFC98, 'M', 'ئح'),
-    (0xFC99, 'M', 'ئخ'),
-    (0xFC9A, 'M', 'ئم'),
-    (0xFC9B, 'M', 'ئه'),
-    (0xFC9C, 'M', 'بج'),
-    (0xFC9D, 'M', 'بح'),
-    (0xFC9E, 'M', 'بخ'),
-    (0xFC9F, 'M', 'بم'),
-    (0xFCA0, 'M', 'به'),
-    (0xFCA1, 'M', 'تج'),
-    (0xFCA2, 'M', 'تح'),
-    (0xFCA3, 'M', 'تخ'),
-    (0xFCA4, 'M', 'تم'),
-    (0xFCA5, 'M', 'ته'),
-    (0xFCA6, 'M', 'ثم'),
-    (0xFCA7, 'M', 'جح'),
-    (0xFCA8, 'M', 'جم'),
-    (0xFCA9, 'M', 'حج'),
-    (0xFCAA, 'M', 'حم'),
-    (0xFCAB, 'M', 'خج'),
-    (0xFCAC, 'M', 'خم'),
-    (0xFCAD, 'M', 'سج'),
-    (0xFCAE, 'M', 'سح'),
-    (0xFCAF, 'M', 'سخ'),
-    (0xFCB0, 'M', 'سم'),
-    (0xFCB1, 'M', 'صح'),
-    (0xFCB2, 'M', 'صخ'),
-    (0xFCB3, 'M', 'صم'),
-    (0xFCB4, 'M', 'ضج'),
-    (0xFCB5, 'M', 'ضح'),
-    (0xFCB6, 'M', 'ضخ'),
-    (0xFCB7, 'M', 'ضم'),
-    (0xFCB8, 'M', 'طح'),
-    (0xFCB9, 'M', 'ظم'),
-    (0xFCBA, 'M', 'عج'),
-    (0xFCBB, 'M', 'عم'),
-    (0xFCBC, 'M', 'غج'),
-    (0xFCBD, 'M', 'غم'),
-    (0xFCBE, 'M', 'فج'),
+        (0xFC5B, "M", "ذٰ"),
+        (0xFC5C, "M", "رٰ"),
+        (0xFC5D, "M", "ىٰ"),
+        (0xFC5E, "3", " ٌّ"),
+        (0xFC5F, "3", " ٍّ"),
+        (0xFC60, "3", " َّ"),
+        (0xFC61, "3", " ُّ"),
+        (0xFC62, "3", " ِّ"),
+        (0xFC63, "3", " ّٰ"),
+        (0xFC64, "M", "ئر"),
+        (0xFC65, "M", "ئز"),
+        (0xFC66, "M", "ئم"),
+        (0xFC67, "M", "ئن"),
+        (0xFC68, "M", "ئى"),
+        (0xFC69, "M", "ئي"),
+        (0xFC6A, "M", "بر"),
+        (0xFC6B, "M", "بز"),
+        (0xFC6C, "M", "بم"),
+        (0xFC6D, "M", "بن"),
+        (0xFC6E, "M", "بى"),
+        (0xFC6F, "M", "بي"),
+        (0xFC70, "M", "تر"),
+        (0xFC71, "M", "تز"),
+        (0xFC72, "M", "تم"),
+        (0xFC73, "M", "تن"),
+        (0xFC74, "M", "تى"),
+        (0xFC75, "M", "تي"),
+        (0xFC76, "M", "ثر"),
+        (0xFC77, "M", "ثز"),
+        (0xFC78, "M", "ثم"),
+        (0xFC79, "M", "ثن"),
+        (0xFC7A, "M", "ثى"),
+        (0xFC7B, "M", "ثي"),
+        (0xFC7C, "M", "فى"),
+        (0xFC7D, "M", "في"),
+        (0xFC7E, "M", "قى"),
+        (0xFC7F, "M", "قي"),
+        (0xFC80, "M", "كا"),
+        (0xFC81, "M", "كل"),
+        (0xFC82, "M", "كم"),
+        (0xFC83, "M", "كى"),
+        (0xFC84, "M", "كي"),
+        (0xFC85, "M", "لم"),
+        (0xFC86, "M", "لى"),
+        (0xFC87, "M", "لي"),
+        (0xFC88, "M", "ما"),
+        (0xFC89, "M", "مم"),
+        (0xFC8A, "M", "نر"),
+        (0xFC8B, "M", "نز"),
+        (0xFC8C, "M", "نم"),
+        (0xFC8D, "M", "نن"),
+        (0xFC8E, "M", "نى"),
+        (0xFC8F, "M", "ني"),
+        (0xFC90, "M", "ىٰ"),
+        (0xFC91, "M", "ير"),
+        (0xFC92, "M", "يز"),
+        (0xFC93, "M", "يم"),
+        (0xFC94, "M", "ين"),
+        (0xFC95, "M", "يى"),
+        (0xFC96, "M", "يي"),
+        (0xFC97, "M", "ئج"),
+        (0xFC98, "M", "ئح"),
+        (0xFC99, "M", "ئخ"),
+        (0xFC9A, "M", "ئم"),
+        (0xFC9B, "M", "ئه"),
+        (0xFC9C, "M", "بج"),
+        (0xFC9D, "M", "بح"),
+        (0xFC9E, "M", "بخ"),
+        (0xFC9F, "M", "بم"),
+        (0xFCA0, "M", "به"),
+        (0xFCA1, "M", "تج"),
+        (0xFCA2, "M", "تح"),
+        (0xFCA3, "M", "تخ"),
+        (0xFCA4, "M", "تم"),
+        (0xFCA5, "M", "ته"),
+        (0xFCA6, "M", "ثم"),
+        (0xFCA7, "M", "جح"),
+        (0xFCA8, "M", "جم"),
+        (0xFCA9, "M", "حج"),
+        (0xFCAA, "M", "حم"),
+        (0xFCAB, "M", "خج"),
+        (0xFCAC, "M", "خم"),
+        (0xFCAD, "M", "سج"),
+        (0xFCAE, "M", "سح"),
+        (0xFCAF, "M", "سخ"),
+        (0xFCB0, "M", "سم"),
+        (0xFCB1, "M", "صح"),
+        (0xFCB2, "M", "صخ"),
+        (0xFCB3, "M", "صم"),
+        (0xFCB4, "M", "ضج"),
+        (0xFCB5, "M", "ضح"),
+        (0xFCB6, "M", "ضخ"),
+        (0xFCB7, "M", "ضم"),
+        (0xFCB8, "M", "طح"),
+        (0xFCB9, "M", "ظم"),
+        (0xFCBA, "M", "عج"),
+        (0xFCBB, "M", "عم"),
+        (0xFCBC, "M", "غج"),
+        (0xFCBD, "M", "غم"),
+        (0xFCBE, "M", "فج"),
     ]
 
+
 def _seg_47() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0xFCBF, 'M', 'فح'),
-    (0xFCC0, 'M', 'فخ'),
-    (0xFCC1, 'M', 'فم'),
-    (0xFCC2, 'M', 'قح'),
-    (0xFCC3, 'M', 'قم'),
-    (0xFCC4, 'M', 'كج'),
-    (0xFCC5, 'M', 'كح'),
-    (0xFCC6, 'M', 'كخ'),
-    (0xFCC7, 'M', 'كل'),
-    (0xFCC8, 'M', 'كم'),
-    (0xFCC9, 'M', 'لج'),
-    (0xFCCA, 'M', 'لح'),
-    (0xFCCB, 'M', 'لخ'),
-    (0xFCCC, 'M', 'لم'),
-    (0xFCCD, 'M', 'له'),
-    (0xFCCE, 'M', 'مج'),
-    (0xFCCF, 'M', 'مح'),
-    (0xFCD0, 'M', 'مخ'),
-    (0xFCD1, 'M', 'مم'),
-    (0xFCD2, 'M', 'نج'),
-    (0xFCD3, 'M', 'نح'),
-    (0xFCD4, 'M', 'نخ'),
-    (0xFCD5, 'M', 'نم'),
-    (0xFCD6, 'M', 'نه'),
-    (0xFCD7, 'M', 'هج'),
-    (0xFCD8, 'M', 'هم'),
-    (0xFCD9, 'M', 'هٰ'),
-    (0xFCDA, 'M', 'يج'),
-    (0xFCDB, 'M', 'يح'),
-    (0xFCDC, 'M', 'يخ'),
-    (0xFCDD, 'M', 'يم'),
-    (0xFCDE, 'M', 'يه'),
-    (0xFCDF, 'M', 'ئم'),
-    (0xFCE0, 'M', 'ئه'),
-    (0xFCE1, 'M', 'بم'),
-    (0xFCE2, 'M', 'به'),
-    (0xFCE3, 'M', 'تم'),
-    (0xFCE4, 'M', 'ته'),
-    (0xFCE5, 'M', 'ثم'),
-    (0xFCE6, 'M', 'ثه'),
-    (0xFCE7, 'M', 'سم'),
-    (0xFCE8, 'M', 'سه'),
-    (0xFCE9, 'M', 'شم'),
-    (0xFCEA, 'M', 'شه'),
-    (0xFCEB, 'M', 'كل'),
-    (0xFCEC, 'M', 'كم'),
-    (0xFCED, 'M', 'لم'),
-    (0xFCEE, 'M', 'نم'),
-    (0xFCEF, 'M', 'نه'),
-    (0xFCF0, 'M', 'يم'),
-    (0xFCF1, 'M', 'يه'),
-    (0xFCF2, 'M', 'ـَّ'),
-    (0xFCF3, 'M', 'ـُّ'),
-    (0xFCF4, 'M', 'ـِّ'),
-    (0xFCF5, 'M', 'طى'),
-    (0xFCF6, 'M', 'طي'),
-    (0xFCF7, 'M', 'عى'),
-    (0xFCF8, 'M', 'عي'),
-    (0xFCF9, 'M', 'غى'),
-    (0xFCFA, 'M', 'غي'),
-    (0xFCFB, 'M', 'سى'),
-    (0xFCFC, 'M', 'سي'),
-    (0xFCFD, 'M', 'شى'),
-    (0xFCFE, 'M', 'شي'),
-    (0xFCFF, 'M', 'حى'),
-    (0xFD00, 'M', 'حي'),
-    (0xFD01, 'M', 'جى'),
-    (0xFD02, 'M', 'جي'),
-    (0xFD03, 'M', 'خى'),
-    (0xFD04, 'M', 'خي'),
-    (0xFD05, 'M', 'صى'),
-    (0xFD06, 'M', 'صي'),
-    (0xFD07, 'M', 'ضى'),
-    (0xFD08, 'M', 'ضي'),
-    (0xFD09, 'M', 'شج'),
-    (0xFD0A, 'M', 'شح'),
-    (0xFD0B, 'M', 'شخ'),
-    (0xFD0C, 'M', 'شم'),
-    (0xFD0D, 'M', 'شر'),
-    (0xFD0E, 'M', 'سر'),
-    (0xFD0F, 'M', 'صر'),
-    (0xFD10, 'M', 'ضر'),
-    (0xFD11, 'M', 'طى'),
-    (0xFD12, 'M', 'طي'),
-    (0xFD13, 'M', 'عى'),
-    (0xFD14, 'M', 'عي'),
-    (0xFD15, 'M', 'غى'),
-    (0xFD16, 'M', 'غي'),
-    (0xFD17, 'M', 'سى'),
-    (0xFD18, 'M', 'سي'),
-    (0xFD19, 'M', 'شى'),
-    (0xFD1A, 'M', 'شي'),
-    (0xFD1B, 'M', 'حى'),
-    (0xFD1C, 'M', 'حي'),
-    (0xFD1D, 'M', 'جى'),
-    (0xFD1E, 'M', 'جي'),
-    (0xFD1F, 'M', 'خى'),
-    (0xFD20, 'M', 'خي'),
-    (0xFD21, 'M', 'صى'),
-    (0xFD22, 'M', 'صي'),
+        (0xFCBF, "M", "فح"),
+        (0xFCC0, "M", "فخ"),
+        (0xFCC1, "M", "فم"),
+        (0xFCC2, "M", "قح"),
+        (0xFCC3, "M", "قم"),
+        (0xFCC4, "M", "كج"),
+        (0xFCC5, "M", "كح"),
+        (0xFCC6, "M", "كخ"),
+        (0xFCC7, "M", "كل"),
+        (0xFCC8, "M", "كم"),
+        (0xFCC9, "M", "لج"),
+        (0xFCCA, "M", "لح"),
+        (0xFCCB, "M", "لخ"),
+        (0xFCCC, "M", "لم"),
+        (0xFCCD, "M", "له"),
+        (0xFCCE, "M", "مج"),
+        (0xFCCF, "M", "مح"),
+        (0xFCD0, "M", "مخ"),
+        (0xFCD1, "M", "مم"),
+        (0xFCD2, "M", "نج"),
+        (0xFCD3, "M", "نح"),
+        (0xFCD4, "M", "نخ"),
+        (0xFCD5, "M", "نم"),
+        (0xFCD6, "M", "نه"),
+        (0xFCD7, "M", "هج"),
+        (0xFCD8, "M", "هم"),
+        (0xFCD9, "M", "هٰ"),
+        (0xFCDA, "M", "يج"),
+        (0xFCDB, "M", "يح"),
+        (0xFCDC, "M", "يخ"),
+        (0xFCDD, "M", "يم"),
+        (0xFCDE, "M", "يه"),
+        (0xFCDF, "M", "ئم"),
+        (0xFCE0, "M", "ئه"),
+        (0xFCE1, "M", "بم"),
+        (0xFCE2, "M", "به"),
+        (0xFCE3, "M", "تم"),
+        (0xFCE4, "M", "ته"),
+        (0xFCE5, "M", "ثم"),
+        (0xFCE6, "M", "ثه"),
+        (0xFCE7, "M", "سم"),
+        (0xFCE8, "M", "سه"),
+        (0xFCE9, "M", "شم"),
+        (0xFCEA, "M", "شه"),
+        (0xFCEB, "M", "كل"),
+        (0xFCEC, "M", "كم"),
+        (0xFCED, "M", "لم"),
+        (0xFCEE, "M", "نم"),
+        (0xFCEF, "M", "نه"),
+        (0xFCF0, "M", "يم"),
+        (0xFCF1, "M", "يه"),
+        (0xFCF2, "M", "ـَّ"),
+        (0xFCF3, "M", "ـُّ"),
+        (0xFCF4, "M", "ـِّ"),
+        (0xFCF5, "M", "طى"),
+        (0xFCF6, "M", "طي"),
+        (0xFCF7, "M", "عى"),
+        (0xFCF8, "M", "عي"),
+        (0xFCF9, "M", "غى"),
+        (0xFCFA, "M", "غي"),
+        (0xFCFB, "M", "سى"),
+        (0xFCFC, "M", "سي"),
+        (0xFCFD, "M", "شى"),
+        (0xFCFE, "M", "شي"),
+        (0xFCFF, "M", "حى"),
+        (0xFD00, "M", "حي"),
+        (0xFD01, "M", "جى"),
+        (0xFD02, "M", "جي"),
+        (0xFD03, "M", "خى"),
+        (0xFD04, "M", "خي"),
+        (0xFD05, "M", "صى"),
+        (0xFD06, "M", "صي"),
+        (0xFD07, "M", "ضى"),
+        (0xFD08, "M", "ضي"),
+        (0xFD09, "M", "شج"),
+        (0xFD0A, "M", "شح"),
+        (0xFD0B, "M", "شخ"),
+        (0xFD0C, "M", "شم"),
+        (0xFD0D, "M", "شر"),
+        (0xFD0E, "M", "سر"),
+        (0xFD0F, "M", "صر"),
+        (0xFD10, "M", "ضر"),
+        (0xFD11, "M", "طى"),
+        (0xFD12, "M", "طي"),
+        (0xFD13, "M", "عى"),
+        (0xFD14, "M", "عي"),
+        (0xFD15, "M", "غى"),
+        (0xFD16, "M", "غي"),
+        (0xFD17, "M", "سى"),
+        (0xFD18, "M", "سي"),
+        (0xFD19, "M", "شى"),
+        (0xFD1A, "M", "شي"),
+        (0xFD1B, "M", "حى"),
+        (0xFD1C, "M", "حي"),
+        (0xFD1D, "M", "جى"),
+        (0xFD1E, "M", "جي"),
+        (0xFD1F, "M", "خى"),
+        (0xFD20, "M", "خي"),
+        (0xFD21, "M", "صى"),
+        (0xFD22, "M", "صي"),
     ]
 
+
 def _seg_48() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0xFD23, 'M', 'ضى'),
-    (0xFD24, 'M', 'ضي'),
-    (0xFD25, 'M', 'شج'),
-    (0xFD26, 'M', 'شح'),
-    (0xFD27, 'M', 'شخ'),
-    (0xFD28, 'M', 'شم'),
-    (0xFD29, 'M', 'شر'),
-    (0xFD2A, 'M', 'سر'),
-    (0xFD2B, 'M', 'صر'),
-    (0xFD2C, 'M', 'ضر'),
-    (0xFD2D, 'M', 'شج'),
-    (0xFD2E, 'M', 'شح'),
-    (0xFD2F, 'M', 'شخ'),
-    (0xFD30, 'M', 'شم'),
-    (0xFD31, 'M', 'سه'),
-    (0xFD32, 'M', 'شه'),
-    (0xFD33, 'M', 'طم'),
-    (0xFD34, 'M', 'سج'),
-    (0xFD35, 'M', 'سح'),
-    (0xFD36, 'M', 'سخ'),
-    (0xFD37, 'M', 'شج'),
-    (0xFD38, 'M', 'شح'),
-    (0xFD39, 'M', 'شخ'),
-    (0xFD3A, 'M', 'طم'),
-    (0xFD3B, 'M', 'ظم'),
-    (0xFD3C, 'M', 'اً'),
-    (0xFD3E, 'V'),
-    (0xFD50, 'M', 'تجم'),
-    (0xFD51, 'M', 'تحج'),
-    (0xFD53, 'M', 'تحم'),
-    (0xFD54, 'M', 'تخم'),
-    (0xFD55, 'M', 'تمج'),
-    (0xFD56, 'M', 'تمح'),
-    (0xFD57, 'M', 'تمخ'),
-    (0xFD58, 'M', 'جمح'),
-    (0xFD5A, 'M', 'حمي'),
-    (0xFD5B, 'M', 'حمى'),
-    (0xFD5C, 'M', 'سحج'),
-    (0xFD5D, 'M', 'سجح'),
-    (0xFD5E, 'M', 'سجى'),
-    (0xFD5F, 'M', 'سمح'),
-    (0xFD61, 'M', 'سمج'),
-    (0xFD62, 'M', 'سمم'),
-    (0xFD64, 'M', 'صحح'),
-    (0xFD66, 'M', 'صمم'),
-    (0xFD67, 'M', 'شحم'),
-    (0xFD69, 'M', 'شجي'),
-    (0xFD6A, 'M', 'شمخ'),
-    (0xFD6C, 'M', 'شمم'),
-    (0xFD6E, 'M', 'ضحى'),
-    (0xFD6F, 'M', 'ضخم'),
-    (0xFD71, 'M', 'طمح'),
-    (0xFD73, 'M', 'طمم'),
-    (0xFD74, 'M', 'طمي'),
-    (0xFD75, 'M', 'عجم'),
-    (0xFD76, 'M', 'عمم'),
-    (0xFD78, 'M', 'عمى'),
-    (0xFD79, 'M', 'غمم'),
-    (0xFD7A, 'M', 'غمي'),
-    (0xFD7B, 'M', 'غمى'),
-    (0xFD7C, 'M', 'فخم'),
-    (0xFD7E, 'M', 'قمح'),
-    (0xFD7F, 'M', 'قمم'),
-    (0xFD80, 'M', 'لحم'),
-    (0xFD81, 'M', 'لحي'),
-    (0xFD82, 'M', 'لحى'),
-    (0xFD83, 'M', 'لجج'),
-    (0xFD85, 'M', 'لخم'),
-    (0xFD87, 'M', 'لمح'),
-    (0xFD89, 'M', 'محج'),
-    (0xFD8A, 'M', 'محم'),
-    (0xFD8B, 'M', 'محي'),
-    (0xFD8C, 'M', 'مجح'),
-    (0xFD8D, 'M', 'مجم'),
-    (0xFD8E, 'M', 'مخج'),
-    (0xFD8F, 'M', 'مخم'),
-    (0xFD90, 'X'),
-    (0xFD92, 'M', 'مجخ'),
-    (0xFD93, 'M', 'همج'),
-    (0xFD94, 'M', 'همم'),
-    (0xFD95, 'M', 'نحم'),
-    (0xFD96, 'M', 'نحى'),
-    (0xFD97, 'M', 'نجم'),
-    (0xFD99, 'M', 'نجى'),
-    (0xFD9A, 'M', 'نمي'),
-    (0xFD9B, 'M', 'نمى'),
-    (0xFD9C, 'M', 'يمم'),
-    (0xFD9E, 'M', 'بخي'),
-    (0xFD9F, 'M', 'تجي'),
-    (0xFDA0, 'M', 'تجى'),
-    (0xFDA1, 'M', 'تخي'),
-    (0xFDA2, 'M', 'تخى'),
-    (0xFDA3, 'M', 'تمي'),
-    (0xFDA4, 'M', 'تمى'),
-    (0xFDA5, 'M', 'جمي'),
-    (0xFDA6, 'M', 'جحى'),
-    (0xFDA7, 'M', 'جمى'),
-    (0xFDA8, 'M', 'سخى'),
-    (0xFDA9, 'M', 'صحي'),
-    (0xFDAA, 'M', 'شحي'),
+        (0xFD23, "M", "ضى"),
+        (0xFD24, "M", "ضي"),
+        (0xFD25, "M", "شج"),
+        (0xFD26, "M", "شح"),
+        (0xFD27, "M", "شخ"),
+        (0xFD28, "M", "شم"),
+        (0xFD29, "M", "شر"),
+        (0xFD2A, "M", "سر"),
+        (0xFD2B, "M", "صر"),
+        (0xFD2C, "M", "ضر"),
+        (0xFD2D, "M", "شج"),
+        (0xFD2E, "M", "شح"),
+        (0xFD2F, "M", "شخ"),
+        (0xFD30, "M", "شم"),
+        (0xFD31, "M", "سه"),
+        (0xFD32, "M", "شه"),
+        (0xFD33, "M", "طم"),
+        (0xFD34, "M", "سج"),
+        (0xFD35, "M", "سح"),
+        (0xFD36, "M", "سخ"),
+        (0xFD37, "M", "شج"),
+        (0xFD38, "M", "شح"),
+        (0xFD39, "M", "شخ"),
+        (0xFD3A, "M", "طم"),
+        (0xFD3B, "M", "ظم"),
+        (0xFD3C, "M", "اً"),
+        (0xFD3E, "V"),
+        (0xFD50, "M", "تجم"),
+        (0xFD51, "M", "تحج"),
+        (0xFD53, "M", "تحم"),
+        (0xFD54, "M", "تخم"),
+        (0xFD55, "M", "تمج"),
+        (0xFD56, "M", "تمح"),
+        (0xFD57, "M", "تمخ"),
+        (0xFD58, "M", "جمح"),
+        (0xFD5A, "M", "حمي"),
+        (0xFD5B, "M", "حمى"),
+        (0xFD5C, "M", "سحج"),
+        (0xFD5D, "M", "سجح"),
+        (0xFD5E, "M", "سجى"),
+        (0xFD5F, "M", "سمح"),
+        (0xFD61, "M", "سمج"),
+        (0xFD62, "M", "سمم"),
+        (0xFD64, "M", "صحح"),
+        (0xFD66, "M", "صمم"),
+        (0xFD67, "M", "شحم"),
+        (0xFD69, "M", "شجي"),
+        (0xFD6A, "M", "شمخ"),
+        (0xFD6C, "M", "شمم"),
+        (0xFD6E, "M", "ضحى"),
+        (0xFD6F, "M", "ضخم"),
+        (0xFD71, "M", "طمح"),
+        (0xFD73, "M", "طمم"),
+        (0xFD74, "M", "طمي"),
+        (0xFD75, "M", "عجم"),
+        (0xFD76, "M", "عمم"),
+        (0xFD78, "M", "عمى"),
+        (0xFD79, "M", "غمم"),
+        (0xFD7A, "M", "غمي"),
+        (0xFD7B, "M", "غمى"),
+        (0xFD7C, "M", "فخم"),
+        (0xFD7E, "M", "قمح"),
+        (0xFD7F, "M", "قمم"),
+        (0xFD80, "M", "لحم"),
+        (0xFD81, "M", "لحي"),
+        (0xFD82, "M", "لحى"),
+        (0xFD83, "M", "لجج"),
+        (0xFD85, "M", "لخم"),
+        (0xFD87, "M", "لمح"),
+        (0xFD89, "M", "محج"),
+        (0xFD8A, "M", "محم"),
+        (0xFD8B, "M", "محي"),
+        (0xFD8C, "M", "مجح"),
+        (0xFD8D, "M", "مجم"),
+        (0xFD8E, "M", "مخج"),
+        (0xFD8F, "M", "مخم"),
+        (0xFD90, "X"),
+        (0xFD92, "M", "مجخ"),
+        (0xFD93, "M", "همج"),
+        (0xFD94, "M", "همم"),
+        (0xFD95, "M", "نحم"),
+        (0xFD96, "M", "نحى"),
+        (0xFD97, "M", "نجم"),
+        (0xFD99, "M", "نجى"),
+        (0xFD9A, "M", "نمي"),
+        (0xFD9B, "M", "نمى"),
+        (0xFD9C, "M", "يمم"),
+        (0xFD9E, "M", "بخي"),
+        (0xFD9F, "M", "تجي"),
+        (0xFDA0, "M", "تجى"),
+        (0xFDA1, "M", "تخي"),
+        (0xFDA2, "M", "تخى"),
+        (0xFDA3, "M", "تمي"),
+        (0xFDA4, "M", "تمى"),
+        (0xFDA5, "M", "جمي"),
+        (0xFDA6, "M", "جحى"),
+        (0xFDA7, "M", "جمى"),
+        (0xFDA8, "M", "سخى"),
+        (0xFDA9, "M", "صحي"),
+        (0xFDAA, "M", "شحي"),
     ]
 
+
 def _seg_49() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0xFDAB, 'M', 'ضحي'),
-    (0xFDAC, 'M', 'لجي'),
-    (0xFDAD, 'M', 'لمي'),
-    (0xFDAE, 'M', 'يحي'),
-    (0xFDAF, 'M', 'يجي'),
-    (0xFDB0, 'M', 'يمي'),
-    (0xFDB1, 'M', 'ممي'),
-    (0xFDB2, 'M', 'قمي'),
-    (0xFDB3, 'M', 'نحي'),
-    (0xFDB4, 'M', 'قمح'),
-    (0xFDB5, 'M', 'لحم'),
-    (0xFDB6, 'M', 'عمي'),
-    (0xFDB7, 'M', 'كمي'),
-    (0xFDB8, 'M', 'نجح'),
-    (0xFDB9, 'M', 'مخي'),
-    (0xFDBA, 'M', 'لجم'),
-    (0xFDBB, 'M', 'كمم'),
-    (0xFDBC, 'M', 'لجم'),
-    (0xFDBD, 'M', 'نجح'),
-    (0xFDBE, 'M', 'جحي'),
-    (0xFDBF, 'M', 'حجي'),
-    (0xFDC0, 'M', 'مجي'),
-    (0xFDC1, 'M', 'فمي'),
-    (0xFDC2, 'M', 'بحي'),
-    (0xFDC3, 'M', 'كمم'),
-    (0xFDC4, 'M', 'عجم'),
-    (0xFDC5, 'M', 'صمم'),
-    (0xFDC6, 'M', 'سخي'),
-    (0xFDC7, 'M', 'نجي'),
-    (0xFDC8, 'X'),
-    (0xFDCF, 'V'),
-    (0xFDD0, 'X'),
-    (0xFDF0, 'M', 'صلے'),
-    (0xFDF1, 'M', 'قلے'),
-    (0xFDF2, 'M', 'الله'),
-    (0xFDF3, 'M', 'اكبر'),
-    (0xFDF4, 'M', 'محمد'),
-    (0xFDF5, 'M', 'صلعم'),
-    (0xFDF6, 'M', 'رسول'),
-    (0xFDF7, 'M', 'عليه'),
-    (0xFDF8, 'M', 'وسلم'),
-    (0xFDF9, 'M', 'صلى'),
-    (0xFDFA, '3', 'صلى الله عليه وسلم'),
-    (0xFDFB, '3', 'جل جلاله'),
-    (0xFDFC, 'M', 'ریال'),
-    (0xFDFD, 'V'),
-    (0xFE00, 'I'),
-    (0xFE10, '3', ','),
-    (0xFE11, 'M', '、'),
-    (0xFE12, 'X'),
-    (0xFE13, '3', ':'),
-    (0xFE14, '3', ';'),
-    (0xFE15, '3', '!'),
-    (0xFE16, '3', '?'),
-    (0xFE17, 'M', '〖'),
-    (0xFE18, 'M', '〗'),
-    (0xFE19, 'X'),
-    (0xFE20, 'V'),
-    (0xFE30, 'X'),
-    (0xFE31, 'M', '—'),
-    (0xFE32, 'M', '–'),
-    (0xFE33, '3', '_'),
-    (0xFE35, '3', '('),
-    (0xFE36, '3', ')'),
-    (0xFE37, '3', '{'),
-    (0xFE38, '3', '}'),
-    (0xFE39, 'M', '〔'),
-    (0xFE3A, 'M', '〕'),
-    (0xFE3B, 'M', '【'),
-    (0xFE3C, 'M', '】'),
-    (0xFE3D, 'M', '《'),
-    (0xFE3E, 'M', '》'),
-    (0xFE3F, 'M', '〈'),
-    (0xFE40, 'M', '〉'),
-    (0xFE41, 'M', '「'),
-    (0xFE42, 'M', '」'),
-    (0xFE43, 'M', '『'),
-    (0xFE44, 'M', '』'),
-    (0xFE45, 'V'),
-    (0xFE47, '3', '['),
-    (0xFE48, '3', ']'),
-    (0xFE49, '3', ' ̅'),
-    (0xFE4D, '3', '_'),
-    (0xFE50, '3', ','),
-    (0xFE51, 'M', '、'),
-    (0xFE52, 'X'),
-    (0xFE54, '3', ';'),
-    (0xFE55, '3', ':'),
-    (0xFE56, '3', '?'),
-    (0xFE57, '3', '!'),
-    (0xFE58, 'M', '—'),
-    (0xFE59, '3', '('),
-    (0xFE5A, '3', ')'),
-    (0xFE5B, '3', '{'),
-    (0xFE5C, '3', '}'),
-    (0xFE5D, 'M', '〔'),
-    (0xFE5E, 'M', '〕'),
-    (0xFE5F, '3', '#'),
-    (0xFE60, '3', '&'),
-    (0xFE61, '3', '*'),
+        (0xFDAB, "M", "ضحي"),
+        (0xFDAC, "M", "لجي"),
+        (0xFDAD, "M", "لمي"),
+        (0xFDAE, "M", "يحي"),
+        (0xFDAF, "M", "يجي"),
+        (0xFDB0, "M", "يمي"),
+        (0xFDB1, "M", "ممي"),
+        (0xFDB2, "M", "قمي"),
+        (0xFDB3, "M", "نحي"),
+        (0xFDB4, "M", "قمح"),
+        (0xFDB5, "M", "لحم"),
+        (0xFDB6, "M", "عمي"),
+        (0xFDB7, "M", "كمي"),
+        (0xFDB8, "M", "نجح"),
+        (0xFDB9, "M", "مخي"),
+        (0xFDBA, "M", "لجم"),
+        (0xFDBB, "M", "كمم"),
+        (0xFDBC, "M", "لجم"),
+        (0xFDBD, "M", "نجح"),
+        (0xFDBE, "M", "جحي"),
+        (0xFDBF, "M", "حجي"),
+        (0xFDC0, "M", "مجي"),
+        (0xFDC1, "M", "فمي"),
+        (0xFDC2, "M", "بحي"),
+        (0xFDC3, "M", "كمم"),
+        (0xFDC4, "M", "عجم"),
+        (0xFDC5, "M", "صمم"),
+        (0xFDC6, "M", "سخي"),
+        (0xFDC7, "M", "نجي"),
+        (0xFDC8, "X"),
+        (0xFDCF, "V"),
+        (0xFDD0, "X"),
+        (0xFDF0, "M", "صلے"),
+        (0xFDF1, "M", "قلے"),
+        (0xFDF2, "M", "الله"),
+        (0xFDF3, "M", "اكبر"),
+        (0xFDF4, "M", "محمد"),
+        (0xFDF5, "M", "صلعم"),
+        (0xFDF6, "M", "رسول"),
+        (0xFDF7, "M", "عليه"),
+        (0xFDF8, "M", "وسلم"),
+        (0xFDF9, "M", "صلى"),
+        (0xFDFA, "3", "صلى الله عليه وسلم"),
+        (0xFDFB, "3", "جل جلاله"),
+        (0xFDFC, "M", "ریال"),
+        (0xFDFD, "V"),
+        (0xFE00, "I"),
+        (0xFE10, "3", ","),
+        (0xFE11, "M", "、"),
+        (0xFE12, "X"),
+        (0xFE13, "3", ":"),
+        (0xFE14, "3", ";"),
+        (0xFE15, "3", "!"),
+        (0xFE16, "3", "?"),
+        (0xFE17, "M", "〖"),
+        (0xFE18, "M", "〗"),
+        (0xFE19, "X"),
+        (0xFE20, "V"),
+        (0xFE30, "X"),
+        (0xFE31, "M", "—"),
+        (0xFE32, "M", "–"),
+        (0xFE33, "3", "_"),
+        (0xFE35, "3", "("),
+        (0xFE36, "3", ")"),
+        (0xFE37, "3", "{"),
+        (0xFE38, "3", "}"),
+        (0xFE39, "M", "〔"),
+        (0xFE3A, "M", "〕"),
+        (0xFE3B, "M", "【"),
+        (0xFE3C, "M", "】"),
+        (0xFE3D, "M", "《"),
+        (0xFE3E, "M", "》"),
+        (0xFE3F, "M", "〈"),
+        (0xFE40, "M", "〉"),
+        (0xFE41, "M", "「"),
+        (0xFE42, "M", "」"),
+        (0xFE43, "M", "『"),
+        (0xFE44, "M", "』"),
+        (0xFE45, "V"),
+        (0xFE47, "3", "["),
+        (0xFE48, "3", "]"),
+        (0xFE49, "3", " ̅"),
+        (0xFE4D, "3", "_"),
+        (0xFE50, "3", ","),
+        (0xFE51, "M", "、"),
+        (0xFE52, "X"),
+        (0xFE54, "3", ";"),
+        (0xFE55, "3", ":"),
+        (0xFE56, "3", "?"),
+        (0xFE57, "3", "!"),
+        (0xFE58, "M", "—"),
+        (0xFE59, "3", "("),
+        (0xFE5A, "3", ")"),
+        (0xFE5B, "3", "{"),
+        (0xFE5C, "3", "}"),
+        (0xFE5D, "M", "〔"),
+        (0xFE5E, "M", "〕"),
+        (0xFE5F, "3", "#"),
+        (0xFE60, "3", "&"),
+        (0xFE61, "3", "*"),
     ]
 
+
 def _seg_50() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0xFE62, '3', '+'),
-    (0xFE63, 'M', '-'),
-    (0xFE64, '3', '<'),
-    (0xFE65, '3', '>'),
-    (0xFE66, '3', '='),
-    (0xFE67, 'X'),
-    (0xFE68, '3', '\\'),
-    (0xFE69, '3', '$'),
-    (0xFE6A, '3', '%'),
-    (0xFE6B, '3', '@'),
-    (0xFE6C, 'X'),
-    (0xFE70, '3', ' ً'),
-    (0xFE71, 'M', 'ـً'),
-    (0xFE72, '3', ' ٌ'),
-    (0xFE73, 'V'),
-    (0xFE74, '3', ' ٍ'),
-    (0xFE75, 'X'),
-    (0xFE76, '3', ' َ'),
-    (0xFE77, 'M', 'ـَ'),
-    (0xFE78, '3', ' ُ'),
-    (0xFE79, 'M', 'ـُ'),
-    (0xFE7A, '3', ' ِ'),
-    (0xFE7B, 'M', 'ـِ'),
-    (0xFE7C, '3', ' ّ'),
-    (0xFE7D, 'M', 'ـّ'),
-    (0xFE7E, '3', ' ْ'),
-    (0xFE7F, 'M', 'ـْ'),
-    (0xFE80, 'M', 'ء'),
-    (0xFE81, 'M', 'آ'),
-    (0xFE83, 'M', 'أ'),
-    (0xFE85, 'M', 'ؤ'),
-    (0xFE87, 'M', 'إ'),
-    (0xFE89, 'M', 'ئ'),
-    (0xFE8D, 'M', 'ا'),
-    (0xFE8F, 'M', 'ب'),
-    (0xFE93, 'M', 'ة'),
-    (0xFE95, 'M', 'ت'),
-    (0xFE99, 'M', 'ث'),
-    (0xFE9D, 'M', 'ج'),
-    (0xFEA1, 'M', 'ح'),
-    (0xFEA5, 'M', 'خ'),
-    (0xFEA9, 'M', 'د'),
-    (0xFEAB, 'M', 'ذ'),
-    (0xFEAD, 'M', 'ر'),
-    (0xFEAF, 'M', 'ز'),
-    (0xFEB1, 'M', 'س'),
-    (0xFEB5, 'M', 'ش'),
-    (0xFEB9, 'M', 'ص'),
-    (0xFEBD, 'M', 'ض'),
-    (0xFEC1, 'M', 'ط'),
-    (0xFEC5, 'M', 'ظ'),
-    (0xFEC9, 'M', 'ع'),
-    (0xFECD, 'M', 'غ'),
-    (0xFED1, 'M', 'ف'),
-    (0xFED5, 'M', 'ق'),
-    (0xFED9, 'M', 'ك'),
-    (0xFEDD, 'M', 'ل'),
-    (0xFEE1, 'M', 'م'),
-    (0xFEE5, 'M', 'ن'),
-    (0xFEE9, 'M', 'ه'),
-    (0xFEED, 'M', 'و'),
-    (0xFEEF, 'M', 'ى'),
-    (0xFEF1, 'M', 'ي'),
-    (0xFEF5, 'M', 'لآ'),
-    (0xFEF7, 'M', 'لأ'),
-    (0xFEF9, 'M', 'لإ'),
-    (0xFEFB, 'M', 'لا'),
-    (0xFEFD, 'X'),
-    (0xFEFF, 'I'),
-    (0xFF00, 'X'),
-    (0xFF01, '3', '!'),
-    (0xFF02, '3', '"'),
-    (0xFF03, '3', '#'),
-    (0xFF04, '3', '$'),
-    (0xFF05, '3', '%'),
-    (0xFF06, '3', '&'),
-    (0xFF07, '3', '\''),
-    (0xFF08, '3', '('),
-    (0xFF09, '3', ')'),
-    (0xFF0A, '3', '*'),
-    (0xFF0B, '3', '+'),
-    (0xFF0C, '3', ','),
-    (0xFF0D, 'M', '-'),
-    (0xFF0E, 'M', '.'),
-    (0xFF0F, '3', '/'),
-    (0xFF10, 'M', '0'),
-    (0xFF11, 'M', '1'),
-    (0xFF12, 'M', '2'),
-    (0xFF13, 'M', '3'),
-    (0xFF14, 'M', '4'),
-    (0xFF15, 'M', '5'),
-    (0xFF16, 'M', '6'),
-    (0xFF17, 'M', '7'),
-    (0xFF18, 'M', '8'),
-    (0xFF19, 'M', '9'),
-    (0xFF1A, '3', ':'),
-    (0xFF1B, '3', ';'),
-    (0xFF1C, '3', '<'),
-    (0xFF1D, '3', '='),
-    (0xFF1E, '3', '>'),
+        (0xFE62, "3", "+"),
+        (0xFE63, "M", "-"),
+        (0xFE64, "3", "<"),
+        (0xFE65, "3", ">"),
+        (0xFE66, "3", "="),
+        (0xFE67, "X"),
+        (0xFE68, "3", "\\"),
+        (0xFE69, "3", "$"),
+        (0xFE6A, "3", "%"),
+        (0xFE6B, "3", "@"),
+        (0xFE6C, "X"),
+        (0xFE70, "3", " ً"),
+        (0xFE71, "M", "ـً"),
+        (0xFE72, "3", " ٌ"),
+        (0xFE73, "V"),
+        (0xFE74, "3", " ٍ"),
+        (0xFE75, "X"),
+        (0xFE76, "3", " َ"),
+        (0xFE77, "M", "ـَ"),
+        (0xFE78, "3", " ُ"),
+        (0xFE79, "M", "ـُ"),
+        (0xFE7A, "3", " ِ"),
+        (0xFE7B, "M", "ـِ"),
+        (0xFE7C, "3", " ّ"),
+        (0xFE7D, "M", "ـّ"),
+        (0xFE7E, "3", " ْ"),
+        (0xFE7F, "M", "ـْ"),
+        (0xFE80, "M", "ء"),
+        (0xFE81, "M", "آ"),
+        (0xFE83, "M", "أ"),
+        (0xFE85, "M", "ؤ"),
+        (0xFE87, "M", "إ"),
+        (0xFE89, "M", "ئ"),
+        (0xFE8D, "M", "ا"),
+        (0xFE8F, "M", "ب"),
+        (0xFE93, "M", "ة"),
+        (0xFE95, "M", "ت"),
+        (0xFE99, "M", "ث"),
+        (0xFE9D, "M", "ج"),
+        (0xFEA1, "M", "ح"),
+        (0xFEA5, "M", "خ"),
+        (0xFEA9, "M", "د"),
+        (0xFEAB, "M", "ذ"),
+        (0xFEAD, "M", "ر"),
+        (0xFEAF, "M", "ز"),
+        (0xFEB1, "M", "س"),
+        (0xFEB5, "M", "ش"),
+        (0xFEB9, "M", "ص"),
+        (0xFEBD, "M", "ض"),
+        (0xFEC1, "M", "ط"),
+        (0xFEC5, "M", "ظ"),
+        (0xFEC9, "M", "ع"),
+        (0xFECD, "M", "غ"),
+        (0xFED1, "M", "ف"),
+        (0xFED5, "M", "ق"),
+        (0xFED9, "M", "ك"),
+        (0xFEDD, "M", "ل"),
+        (0xFEE1, "M", "م"),
+        (0xFEE5, "M", "ن"),
+        (0xFEE9, "M", "ه"),
+        (0xFEED, "M", "و"),
+        (0xFEEF, "M", "ى"),
+        (0xFEF1, "M", "ي"),
+        (0xFEF5, "M", "لآ"),
+        (0xFEF7, "M", "لأ"),
+        (0xFEF9, "M", "لإ"),
+        (0xFEFB, "M", "لا"),
+        (0xFEFD, "X"),
+        (0xFEFF, "I"),
+        (0xFF00, "X"),
+        (0xFF01, "3", "!"),
+        (0xFF02, "3", '"'),
+        (0xFF03, "3", "#"),
+        (0xFF04, "3", "$"),
+        (0xFF05, "3", "%"),
+        (0xFF06, "3", "&"),
+        (0xFF07, "3", "'"),
+        (0xFF08, "3", "("),
+        (0xFF09, "3", ")"),
+        (0xFF0A, "3", "*"),
+        (0xFF0B, "3", "+"),
+        (0xFF0C, "3", ","),
+        (0xFF0D, "M", "-"),
+        (0xFF0E, "M", "."),
+        (0xFF0F, "3", "/"),
+        (0xFF10, "M", "0"),
+        (0xFF11, "M", "1"),
+        (0xFF12, "M", "2"),
+        (0xFF13, "M", "3"),
+        (0xFF14, "M", "4"),
+        (0xFF15, "M", "5"),
+        (0xFF16, "M", "6"),
+        (0xFF17, "M", "7"),
+        (0xFF18, "M", "8"),
+        (0xFF19, "M", "9"),
+        (0xFF1A, "3", ":"),
+        (0xFF1B, "3", ";"),
+        (0xFF1C, "3", "<"),
+        (0xFF1D, "3", "="),
+        (0xFF1E, "3", ">"),
     ]
 
+
 def _seg_51() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0xFF1F, '3', '?'),
-    (0xFF20, '3', '@'),
-    (0xFF21, 'M', 'a'),
-    (0xFF22, 'M', 'b'),
-    (0xFF23, 'M', 'c'),
-    (0xFF24, 'M', 'd'),
-    (0xFF25, 'M', 'e'),
-    (0xFF26, 'M', 'f'),
-    (0xFF27, 'M', 'g'),
-    (0xFF28, 'M', 'h'),
-    (0xFF29, 'M', 'i'),
-    (0xFF2A, 'M', 'j'),
-    (0xFF2B, 'M', 'k'),
-    (0xFF2C, 'M', 'l'),
-    (0xFF2D, 'M', 'm'),
-    (0xFF2E, 'M', 'n'),
-    (0xFF2F, 'M', 'o'),
-    (0xFF30, 'M', 'p'),
-    (0xFF31, 'M', 'q'),
-    (0xFF32, 'M', 'r'),
-    (0xFF33, 'M', 's'),
-    (0xFF34, 'M', 't'),
-    (0xFF35, 'M', 'u'),
-    (0xFF36, 'M', 'v'),
-    (0xFF37, 'M', 'w'),
-    (0xFF38, 'M', 'x'),
-    (0xFF39, 'M', 'y'),
-    (0xFF3A, 'M', 'z'),
-    (0xFF3B, '3', '['),
-    (0xFF3C, '3', '\\'),
-    (0xFF3D, '3', ']'),
-    (0xFF3E, '3', '^'),
-    (0xFF3F, '3', '_'),
-    (0xFF40, '3', '`'),
-    (0xFF41, 'M', 'a'),
-    (0xFF42, 'M', 'b'),
-    (0xFF43, 'M', 'c'),
-    (0xFF44, 'M', 'd'),
-    (0xFF45, 'M', 'e'),
-    (0xFF46, 'M', 'f'),
-    (0xFF47, 'M', 'g'),
-    (0xFF48, 'M', 'h'),
-    (0xFF49, 'M', 'i'),
-    (0xFF4A, 'M', 'j'),
-    (0xFF4B, 'M', 'k'),
-    (0xFF4C, 'M', 'l'),
-    (0xFF4D, 'M', 'm'),
-    (0xFF4E, 'M', 'n'),
-    (0xFF4F, 'M', 'o'),
-    (0xFF50, 'M', 'p'),
-    (0xFF51, 'M', 'q'),
-    (0xFF52, 'M', 'r'),
-    (0xFF53, 'M', 's'),
-    (0xFF54, 'M', 't'),
-    (0xFF55, 'M', 'u'),
-    (0xFF56, 'M', 'v'),
-    (0xFF57, 'M', 'w'),
-    (0xFF58, 'M', 'x'),
-    (0xFF59, 'M', 'y'),
-    (0xFF5A, 'M', 'z'),
-    (0xFF5B, '3', '{'),
-    (0xFF5C, '3', '|'),
-    (0xFF5D, '3', '}'),
-    (0xFF5E, '3', '~'),
-    (0xFF5F, 'M', '⦅'),
-    (0xFF60, 'M', '⦆'),
-    (0xFF61, 'M', '.'),
-    (0xFF62, 'M', '「'),
-    (0xFF63, 'M', '」'),
-    (0xFF64, 'M', '、'),
-    (0xFF65, 'M', '・'),
-    (0xFF66, 'M', 'ヲ'),
-    (0xFF67, 'M', 'ァ'),
-    (0xFF68, 'M', 'ィ'),
-    (0xFF69, 'M', 'ゥ'),
-    (0xFF6A, 'M', 'ェ'),
-    (0xFF6B, 'M', 'ォ'),
-    (0xFF6C, 'M', 'ャ'),
-    (0xFF6D, 'M', 'ュ'),
-    (0xFF6E, 'M', 'ョ'),
-    (0xFF6F, 'M', 'ッ'),
-    (0xFF70, 'M', 'ー'),
-    (0xFF71, 'M', 'ア'),
-    (0xFF72, 'M', 'イ'),
-    (0xFF73, 'M', 'ウ'),
-    (0xFF74, 'M', 'エ'),
-    (0xFF75, 'M', 'オ'),
-    (0xFF76, 'M', 'カ'),
-    (0xFF77, 'M', 'キ'),
-    (0xFF78, 'M', 'ク'),
-    (0xFF79, 'M', 'ケ'),
-    (0xFF7A, 'M', 'コ'),
-    (0xFF7B, 'M', 'サ'),
-    (0xFF7C, 'M', 'シ'),
-    (0xFF7D, 'M', 'ス'),
-    (0xFF7E, 'M', 'セ'),
-    (0xFF7F, 'M', 'ソ'),
-    (0xFF80, 'M', 'タ'),
-    (0xFF81, 'M', 'チ'),
-    (0xFF82, 'M', 'ツ'),
+        (0xFF1F, "3", "?"),
+        (0xFF20, "3", "@"),
+        (0xFF21, "M", "a"),
+        (0xFF22, "M", "b"),
+        (0xFF23, "M", "c"),
+        (0xFF24, "M", "d"),
+        (0xFF25, "M", "e"),
+        (0xFF26, "M", "f"),
+        (0xFF27, "M", "g"),
+        (0xFF28, "M", "h"),
+        (0xFF29, "M", "i"),
+        (0xFF2A, "M", "j"),
+        (0xFF2B, "M", "k"),
+        (0xFF2C, "M", "l"),
+        (0xFF2D, "M", "m"),
+        (0xFF2E, "M", "n"),
+        (0xFF2F, "M", "o"),
+        (0xFF30, "M", "p"),
+        (0xFF31, "M", "q"),
+        (0xFF32, "M", "r"),
+        (0xFF33, "M", "s"),
+        (0xFF34, "M", "t"),
+        (0xFF35, "M", "u"),
+        (0xFF36, "M", "v"),
+        (0xFF37, "M", "w"),
+        (0xFF38, "M", "x"),
+        (0xFF39, "M", "y"),
+        (0xFF3A, "M", "z"),
+        (0xFF3B, "3", "["),
+        (0xFF3C, "3", "\\"),
+        (0xFF3D, "3", "]"),
+        (0xFF3E, "3", "^"),
+        (0xFF3F, "3", "_"),
+        (0xFF40, "3", "`"),
+        (0xFF41, "M", "a"),
+        (0xFF42, "M", "b"),
+        (0xFF43, "M", "c"),
+        (0xFF44, "M", "d"),
+        (0xFF45, "M", "e"),
+        (0xFF46, "M", "f"),
+        (0xFF47, "M", "g"),
+        (0xFF48, "M", "h"),
+        (0xFF49, "M", "i"),
+        (0xFF4A, "M", "j"),
+        (0xFF4B, "M", "k"),
+        (0xFF4C, "M", "l"),
+        (0xFF4D, "M", "m"),
+        (0xFF4E, "M", "n"),
+        (0xFF4F, "M", "o"),
+        (0xFF50, "M", "p"),
+        (0xFF51, "M", "q"),
+        (0xFF52, "M", "r"),
+        (0xFF53, "M", "s"),
+        (0xFF54, "M", "t"),
+        (0xFF55, "M", "u"),
+        (0xFF56, "M", "v"),
+        (0xFF57, "M", "w"),
+        (0xFF58, "M", "x"),
+        (0xFF59, "M", "y"),
+        (0xFF5A, "M", "z"),
+        (0xFF5B, "3", "{"),
+        (0xFF5C, "3", "|"),
+        (0xFF5D, "3", "}"),
+        (0xFF5E, "3", "~"),
+        (0xFF5F, "M", "⦅"),
+        (0xFF60, "M", "⦆"),
+        (0xFF61, "M", "."),
+        (0xFF62, "M", "「"),
+        (0xFF63, "M", "」"),
+        (0xFF64, "M", "、"),
+        (0xFF65, "M", "・"),
+        (0xFF66, "M", "ヲ"),
+        (0xFF67, "M", "ァ"),
+        (0xFF68, "M", "ィ"),
+        (0xFF69, "M", "ゥ"),
+        (0xFF6A, "M", "ェ"),
+        (0xFF6B, "M", "ォ"),
+        (0xFF6C, "M", "ャ"),
+        (0xFF6D, "M", "ュ"),
+        (0xFF6E, "M", "ョ"),
+        (0xFF6F, "M", "ッ"),
+        (0xFF70, "M", "ー"),
+        (0xFF71, "M", "ア"),
+        (0xFF72, "M", "イ"),
+        (0xFF73, "M", "ウ"),
+        (0xFF74, "M", "エ"),
+        (0xFF75, "M", "オ"),
+        (0xFF76, "M", "カ"),
+        (0xFF77, "M", "キ"),
+        (0xFF78, "M", "ク"),
+        (0xFF79, "M", "ケ"),
+        (0xFF7A, "M", "コ"),
+        (0xFF7B, "M", "サ"),
+        (0xFF7C, "M", "シ"),
+        (0xFF7D, "M", "ス"),
+        (0xFF7E, "M", "セ"),
+        (0xFF7F, "M", "ソ"),
+        (0xFF80, "M", "タ"),
+        (0xFF81, "M", "チ"),
+        (0xFF82, "M", "ツ"),
     ]
 
+
 def _seg_52() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0xFF83, 'M', 'テ'),
-    (0xFF84, 'M', 'ト'),
-    (0xFF85, 'M', 'ナ'),
-    (0xFF86, 'M', 'ニ'),
-    (0xFF87, 'M', 'ヌ'),
-    (0xFF88, 'M', 'ネ'),
-    (0xFF89, 'M', 'ノ'),
-    (0xFF8A, 'M', 'ハ'),
-    (0xFF8B, 'M', 'ヒ'),
-    (0xFF8C, 'M', 'フ'),
-    (0xFF8D, 'M', 'ヘ'),
-    (0xFF8E, 'M', 'ホ'),
-    (0xFF8F, 'M', 'マ'),
-    (0xFF90, 'M', 'ミ'),
-    (0xFF91, 'M', 'ム'),
-    (0xFF92, 'M', 'メ'),
-    (0xFF93, 'M', 'モ'),
-    (0xFF94, 'M', 'ヤ'),
-    (0xFF95, 'M', 'ユ'),
-    (0xFF96, 'M', 'ヨ'),
-    (0xFF97, 'M', 'ラ'),
-    (0xFF98, 'M', 'リ'),
-    (0xFF99, 'M', 'ル'),
-    (0xFF9A, 'M', 'レ'),
-    (0xFF9B, 'M', 'ロ'),
-    (0xFF9C, 'M', 'ワ'),
-    (0xFF9D, 'M', 'ン'),
-    (0xFF9E, 'M', '゙'),
-    (0xFF9F, 'M', '゚'),
-    (0xFFA0, 'X'),
-    (0xFFA1, 'M', 'ᄀ'),
-    (0xFFA2, 'M', 'ᄁ'),
-    (0xFFA3, 'M', 'ᆪ'),
-    (0xFFA4, 'M', 'ᄂ'),
-    (0xFFA5, 'M', 'ᆬ'),
-    (0xFFA6, 'M', 'ᆭ'),
-    (0xFFA7, 'M', 'ᄃ'),
-    (0xFFA8, 'M', 'ᄄ'),
-    (0xFFA9, 'M', 'ᄅ'),
-    (0xFFAA, 'M', 'ᆰ'),
-    (0xFFAB, 'M', 'ᆱ'),
-    (0xFFAC, 'M', 'ᆲ'),
-    (0xFFAD, 'M', 'ᆳ'),
-    (0xFFAE, 'M', 'ᆴ'),
-    (0xFFAF, 'M', 'ᆵ'),
-    (0xFFB0, 'M', 'ᄚ'),
-    (0xFFB1, 'M', 'ᄆ'),
-    (0xFFB2, 'M', 'ᄇ'),
-    (0xFFB3, 'M', 'ᄈ'),
-    (0xFFB4, 'M', 'ᄡ'),
-    (0xFFB5, 'M', 'ᄉ'),
-    (0xFFB6, 'M', 'ᄊ'),
-    (0xFFB7, 'M', 'ᄋ'),
-    (0xFFB8, 'M', 'ᄌ'),
-    (0xFFB9, 'M', 'ᄍ'),
-    (0xFFBA, 'M', 'ᄎ'),
-    (0xFFBB, 'M', 'ᄏ'),
-    (0xFFBC, 'M', 'ᄐ'),
-    (0xFFBD, 'M', 'ᄑ'),
-    (0xFFBE, 'M', 'ᄒ'),
-    (0xFFBF, 'X'),
-    (0xFFC2, 'M', 'ᅡ'),
-    (0xFFC3, 'M', 'ᅢ'),
-    (0xFFC4, 'M', 'ᅣ'),
-    (0xFFC5, 'M', 'ᅤ'),
-    (0xFFC6, 'M', 'ᅥ'),
-    (0xFFC7, 'M', 'ᅦ'),
-    (0xFFC8, 'X'),
-    (0xFFCA, 'M', 'ᅧ'),
-    (0xFFCB, 'M', 'ᅨ'),
-    (0xFFCC, 'M', 'ᅩ'),
-    (0xFFCD, 'M', 'ᅪ'),
-    (0xFFCE, 'M', 'ᅫ'),
-    (0xFFCF, 'M', 'ᅬ'),
-    (0xFFD0, 'X'),
-    (0xFFD2, 'M', 'ᅭ'),
-    (0xFFD3, 'M', 'ᅮ'),
-    (0xFFD4, 'M', 'ᅯ'),
-    (0xFFD5, 'M', 'ᅰ'),
-    (0xFFD6, 'M', 'ᅱ'),
-    (0xFFD7, 'M', 'ᅲ'),
-    (0xFFD8, 'X'),
-    (0xFFDA, 'M', 'ᅳ'),
-    (0xFFDB, 'M', 'ᅴ'),
-    (0xFFDC, 'M', 'ᅵ'),
-    (0xFFDD, 'X'),
-    (0xFFE0, 'M', '¢'),
-    (0xFFE1, 'M', '£'),
-    (0xFFE2, 'M', '¬'),
-    (0xFFE3, '3', ' ̄'),
-    (0xFFE4, 'M', '¦'),
-    (0xFFE5, 'M', '¥'),
-    (0xFFE6, 'M', '₩'),
-    (0xFFE7, 'X'),
-    (0xFFE8, 'M', '│'),
-    (0xFFE9, 'M', '←'),
-    (0xFFEA, 'M', '↑'),
-    (0xFFEB, 'M', '→'),
-    (0xFFEC, 'M', '↓'),
-    (0xFFED, 'M', '■'),
+        (0xFF83, "M", "テ"),
+        (0xFF84, "M", "ト"),
+        (0xFF85, "M", "ナ"),
+        (0xFF86, "M", "ニ"),
+        (0xFF87, "M", "ヌ"),
+        (0xFF88, "M", "ネ"),
+        (0xFF89, "M", "ノ"),
+        (0xFF8A, "M", "ハ"),
+        (0xFF8B, "M", "ヒ"),
+        (0xFF8C, "M", "フ"),
+        (0xFF8D, "M", "ヘ"),
+        (0xFF8E, "M", "ホ"),
+        (0xFF8F, "M", "マ"),
+        (0xFF90, "M", "ミ"),
+        (0xFF91, "M", "ム"),
+        (0xFF92, "M", "メ"),
+        (0xFF93, "M", "モ"),
+        (0xFF94, "M", "ヤ"),
+        (0xFF95, "M", "ユ"),
+        (0xFF96, "M", "ヨ"),
+        (0xFF97, "M", "ラ"),
+        (0xFF98, "M", "リ"),
+        (0xFF99, "M", "ル"),
+        (0xFF9A, "M", "レ"),
+        (0xFF9B, "M", "ロ"),
+        (0xFF9C, "M", "ワ"),
+        (0xFF9D, "M", "ン"),
+        (0xFF9E, "M", "゙"),
+        (0xFF9F, "M", "゚"),
+        (0xFFA0, "X"),
+        (0xFFA1, "M", "ᄀ"),
+        (0xFFA2, "M", "ᄁ"),
+        (0xFFA3, "M", "ᆪ"),
+        (0xFFA4, "M", "ᄂ"),
+        (0xFFA5, "M", "ᆬ"),
+        (0xFFA6, "M", "ᆭ"),
+        (0xFFA7, "M", "ᄃ"),
+        (0xFFA8, "M", "ᄄ"),
+        (0xFFA9, "M", "ᄅ"),
+        (0xFFAA, "M", "ᆰ"),
+        (0xFFAB, "M", "ᆱ"),
+        (0xFFAC, "M", "ᆲ"),
+        (0xFFAD, "M", "ᆳ"),
+        (0xFFAE, "M", "ᆴ"),
+        (0xFFAF, "M", "ᆵ"),
+        (0xFFB0, "M", "ᄚ"),
+        (0xFFB1, "M", "ᄆ"),
+        (0xFFB2, "M", "ᄇ"),
+        (0xFFB3, "M", "ᄈ"),
+        (0xFFB4, "M", "ᄡ"),
+        (0xFFB5, "M", "ᄉ"),
+        (0xFFB6, "M", "ᄊ"),
+        (0xFFB7, "M", "ᄋ"),
+        (0xFFB8, "M", "ᄌ"),
+        (0xFFB9, "M", "ᄍ"),
+        (0xFFBA, "M", "ᄎ"),
+        (0xFFBB, "M", "ᄏ"),
+        (0xFFBC, "M", "ᄐ"),
+        (0xFFBD, "M", "ᄑ"),
+        (0xFFBE, "M", "ᄒ"),
+        (0xFFBF, "X"),
+        (0xFFC2, "M", "ᅡ"),
+        (0xFFC3, "M", "ᅢ"),
+        (0xFFC4, "M", "ᅣ"),
+        (0xFFC5, "M", "ᅤ"),
+        (0xFFC6, "M", "ᅥ"),
+        (0xFFC7, "M", "ᅦ"),
+        (0xFFC8, "X"),
+        (0xFFCA, "M", "ᅧ"),
+        (0xFFCB, "M", "ᅨ"),
+        (0xFFCC, "M", "ᅩ"),
+        (0xFFCD, "M", "ᅪ"),
+        (0xFFCE, "M", "ᅫ"),
+        (0xFFCF, "M", "ᅬ"),
+        (0xFFD0, "X"),
+        (0xFFD2, "M", "ᅭ"),
+        (0xFFD3, "M", "ᅮ"),
+        (0xFFD4, "M", "ᅯ"),
+        (0xFFD5, "M", "ᅰ"),
+        (0xFFD6, "M", "ᅱ"),
+        (0xFFD7, "M", "ᅲ"),
+        (0xFFD8, "X"),
+        (0xFFDA, "M", "ᅳ"),
+        (0xFFDB, "M", "ᅴ"),
+        (0xFFDC, "M", "ᅵ"),
+        (0xFFDD, "X"),
+        (0xFFE0, "M", "¢"),
+        (0xFFE1, "M", "£"),
+        (0xFFE2, "M", "¬"),
+        (0xFFE3, "3", " ̄"),
+        (0xFFE4, "M", "¦"),
+        (0xFFE5, "M", "¥"),
+        (0xFFE6, "M", "₩"),
+        (0xFFE7, "X"),
+        (0xFFE8, "M", "│"),
+        (0xFFE9, "M", "←"),
+        (0xFFEA, "M", "↑"),
+        (0xFFEB, "M", "→"),
+        (0xFFEC, "M", "↓"),
+        (0xFFED, "M", "■"),
     ]
 
+
 def _seg_53() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0xFFEE, 'M', '○'),
-    (0xFFEF, 'X'),
-    (0x10000, 'V'),
-    (0x1000C, 'X'),
-    (0x1000D, 'V'),
-    (0x10027, 'X'),
-    (0x10028, 'V'),
-    (0x1003B, 'X'),
-    (0x1003C, 'V'),
-    (0x1003E, 'X'),
-    (0x1003F, 'V'),
-    (0x1004E, 'X'),
-    (0x10050, 'V'),
-    (0x1005E, 'X'),
-    (0x10080, 'V'),
-    (0x100FB, 'X'),
-    (0x10100, 'V'),
-    (0x10103, 'X'),
-    (0x10107, 'V'),
-    (0x10134, 'X'),
-    (0x10137, 'V'),
-    (0x1018F, 'X'),
-    (0x10190, 'V'),
-    (0x1019D, 'X'),
-    (0x101A0, 'V'),
-    (0x101A1, 'X'),
-    (0x101D0, 'V'),
-    (0x101FE, 'X'),
-    (0x10280, 'V'),
-    (0x1029D, 'X'),
-    (0x102A0, 'V'),
-    (0x102D1, 'X'),
-    (0x102E0, 'V'),
-    (0x102FC, 'X'),
-    (0x10300, 'V'),
-    (0x10324, 'X'),
-    (0x1032D, 'V'),
-    (0x1034B, 'X'),
-    (0x10350, 'V'),
-    (0x1037B, 'X'),
-    (0x10380, 'V'),
-    (0x1039E, 'X'),
-    (0x1039F, 'V'),
-    (0x103C4, 'X'),
-    (0x103C8, 'V'),
-    (0x103D6, 'X'),
-    (0x10400, 'M', '𐐨'),
-    (0x10401, 'M', '𐐩'),
-    (0x10402, 'M', '𐐪'),
-    (0x10403, 'M', '𐐫'),
-    (0x10404, 'M', '𐐬'),
-    (0x10405, 'M', '𐐭'),
-    (0x10406, 'M', '𐐮'),
-    (0x10407, 'M', '𐐯'),
-    (0x10408, 'M', '𐐰'),
-    (0x10409, 'M', '𐐱'),
-    (0x1040A, 'M', '𐐲'),
-    (0x1040B, 'M', '𐐳'),
-    (0x1040C, 'M', '𐐴'),
-    (0x1040D, 'M', '𐐵'),
-    (0x1040E, 'M', '𐐶'),
-    (0x1040F, 'M', '𐐷'),
-    (0x10410, 'M', '𐐸'),
-    (0x10411, 'M', '𐐹'),
-    (0x10412, 'M', '𐐺'),
-    (0x10413, 'M', '𐐻'),
-    (0x10414, 'M', '𐐼'),
-    (0x10415, 'M', '𐐽'),
-    (0x10416, 'M', '𐐾'),
-    (0x10417, 'M', '𐐿'),
-    (0x10418, 'M', '𐑀'),
-    (0x10419, 'M', '𐑁'),
-    (0x1041A, 'M', '𐑂'),
-    (0x1041B, 'M', '𐑃'),
-    (0x1041C, 'M', '𐑄'),
-    (0x1041D, 'M', '𐑅'),
-    (0x1041E, 'M', '𐑆'),
-    (0x1041F, 'M', '𐑇'),
-    (0x10420, 'M', '𐑈'),
-    (0x10421, 'M', '𐑉'),
-    (0x10422, 'M', '𐑊'),
-    (0x10423, 'M', '𐑋'),
-    (0x10424, 'M', '𐑌'),
-    (0x10425, 'M', '𐑍'),
-    (0x10426, 'M', '𐑎'),
-    (0x10427, 'M', '𐑏'),
-    (0x10428, 'V'),
-    (0x1049E, 'X'),
-    (0x104A0, 'V'),
-    (0x104AA, 'X'),
-    (0x104B0, 'M', '𐓘'),
-    (0x104B1, 'M', '𐓙'),
-    (0x104B2, 'M', '𐓚'),
-    (0x104B3, 'M', '𐓛'),
-    (0x104B4, 'M', '𐓜'),
-    (0x104B5, 'M', '𐓝'),
-    (0x104B6, 'M', '𐓞'),
-    (0x104B7, 'M', '𐓟'),
-    (0x104B8, 'M', '𐓠'),
-    (0x104B9, 'M', '𐓡'),
+        (0xFFEE, "M", "○"),
+        (0xFFEF, "X"),
+        (0x10000, "V"),
+        (0x1000C, "X"),
+        (0x1000D, "V"),
+        (0x10027, "X"),
+        (0x10028, "V"),
+        (0x1003B, "X"),
+        (0x1003C, "V"),
+        (0x1003E, "X"),
+        (0x1003F, "V"),
+        (0x1004E, "X"),
+        (0x10050, "V"),
+        (0x1005E, "X"),
+        (0x10080, "V"),
+        (0x100FB, "X"),
+        (0x10100, "V"),
+        (0x10103, "X"),
+        (0x10107, "V"),
+        (0x10134, "X"),
+        (0x10137, "V"),
+        (0x1018F, "X"),
+        (0x10190, "V"),
+        (0x1019D, "X"),
+        (0x101A0, "V"),
+        (0x101A1, "X"),
+        (0x101D0, "V"),
+        (0x101FE, "X"),
+        (0x10280, "V"),
+        (0x1029D, "X"),
+        (0x102A0, "V"),
+        (0x102D1, "X"),
+        (0x102E0, "V"),
+        (0x102FC, "X"),
+        (0x10300, "V"),
+        (0x10324, "X"),
+        (0x1032D, "V"),
+        (0x1034B, "X"),
+        (0x10350, "V"),
+        (0x1037B, "X"),
+        (0x10380, "V"),
+        (0x1039E, "X"),
+        (0x1039F, "V"),
+        (0x103C4, "X"),
+        (0x103C8, "V"),
+        (0x103D6, "X"),
+        (0x10400, "M", "𐐨"),
+        (0x10401, "M", "𐐩"),
+        (0x10402, "M", "𐐪"),
+        (0x10403, "M", "𐐫"),
+        (0x10404, "M", "𐐬"),
+        (0x10405, "M", "𐐭"),
+        (0x10406, "M", "𐐮"),
+        (0x10407, "M", "𐐯"),
+        (0x10408, "M", "𐐰"),
+        (0x10409, "M", "𐐱"),
+        (0x1040A, "M", "𐐲"),
+        (0x1040B, "M", "𐐳"),
+        (0x1040C, "M", "𐐴"),
+        (0x1040D, "M", "𐐵"),
+        (0x1040E, "M", "𐐶"),
+        (0x1040F, "M", "𐐷"),
+        (0x10410, "M", "𐐸"),
+        (0x10411, "M", "𐐹"),
+        (0x10412, "M", "𐐺"),
+        (0x10413, "M", "𐐻"),
+        (0x10414, "M", "𐐼"),
+        (0x10415, "M", "𐐽"),
+        (0x10416, "M", "𐐾"),
+        (0x10417, "M", "𐐿"),
+        (0x10418, "M", "𐑀"),
+        (0x10419, "M", "𐑁"),
+        (0x1041A, "M", "𐑂"),
+        (0x1041B, "M", "𐑃"),
+        (0x1041C, "M", "𐑄"),
+        (0x1041D, "M", "𐑅"),
+        (0x1041E, "M", "𐑆"),
+        (0x1041F, "M", "𐑇"),
+        (0x10420, "M", "𐑈"),
+        (0x10421, "M", "𐑉"),
+        (0x10422, "M", "𐑊"),
+        (0x10423, "M", "𐑋"),
+        (0x10424, "M", "𐑌"),
+        (0x10425, "M", "𐑍"),
+        (0x10426, "M", "𐑎"),
+        (0x10427, "M", "𐑏"),
+        (0x10428, "V"),
+        (0x1049E, "X"),
+        (0x104A0, "V"),
+        (0x104AA, "X"),
+        (0x104B0, "M", "𐓘"),
+        (0x104B1, "M", "𐓙"),
+        (0x104B2, "M", "𐓚"),
+        (0x104B3, "M", "𐓛"),
+        (0x104B4, "M", "𐓜"),
+        (0x104B5, "M", "𐓝"),
+        (0x104B6, "M", "𐓞"),
+        (0x104B7, "M", "𐓟"),
+        (0x104B8, "M", "𐓠"),
+        (0x104B9, "M", "𐓡"),
     ]
 
+
 def _seg_54() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x104BA, 'M', '𐓢'),
-    (0x104BB, 'M', '𐓣'),
-    (0x104BC, 'M', '𐓤'),
-    (0x104BD, 'M', '𐓥'),
-    (0x104BE, 'M', '𐓦'),
-    (0x104BF, 'M', '𐓧'),
-    (0x104C0, 'M', '𐓨'),
-    (0x104C1, 'M', '𐓩'),
-    (0x104C2, 'M', '𐓪'),
-    (0x104C3, 'M', '𐓫'),
-    (0x104C4, 'M', '𐓬'),
-    (0x104C5, 'M', '𐓭'),
-    (0x104C6, 'M', '𐓮'),
-    (0x104C7, 'M', '𐓯'),
-    (0x104C8, 'M', '𐓰'),
-    (0x104C9, 'M', '𐓱'),
-    (0x104CA, 'M', '𐓲'),
-    (0x104CB, 'M', '𐓳'),
-    (0x104CC, 'M', '𐓴'),
-    (0x104CD, 'M', '𐓵'),
-    (0x104CE, 'M', '𐓶'),
-    (0x104CF, 'M', '𐓷'),
-    (0x104D0, 'M', '𐓸'),
-    (0x104D1, 'M', '𐓹'),
-    (0x104D2, 'M', '𐓺'),
-    (0x104D3, 'M', '𐓻'),
-    (0x104D4, 'X'),
-    (0x104D8, 'V'),
-    (0x104FC, 'X'),
-    (0x10500, 'V'),
-    (0x10528, 'X'),
-    (0x10530, 'V'),
-    (0x10564, 'X'),
-    (0x1056F, 'V'),
-    (0x10570, 'M', '𐖗'),
-    (0x10571, 'M', '𐖘'),
-    (0x10572, 'M', '𐖙'),
-    (0x10573, 'M', '𐖚'),
-    (0x10574, 'M', '𐖛'),
-    (0x10575, 'M', '𐖜'),
-    (0x10576, 'M', '𐖝'),
-    (0x10577, 'M', '𐖞'),
-    (0x10578, 'M', '𐖟'),
-    (0x10579, 'M', '𐖠'),
-    (0x1057A, 'M', '𐖡'),
-    (0x1057B, 'X'),
-    (0x1057C, 'M', '𐖣'),
-    (0x1057D, 'M', '𐖤'),
-    (0x1057E, 'M', '𐖥'),
-    (0x1057F, 'M', '𐖦'),
-    (0x10580, 'M', '𐖧'),
-    (0x10581, 'M', '𐖨'),
-    (0x10582, 'M', '𐖩'),
-    (0x10583, 'M', '𐖪'),
-    (0x10584, 'M', '𐖫'),
-    (0x10585, 'M', '𐖬'),
-    (0x10586, 'M', '𐖭'),
-    (0x10587, 'M', '𐖮'),
-    (0x10588, 'M', '𐖯'),
-    (0x10589, 'M', '𐖰'),
-    (0x1058A, 'M', '𐖱'),
-    (0x1058B, 'X'),
-    (0x1058C, 'M', '𐖳'),
-    (0x1058D, 'M', '𐖴'),
-    (0x1058E, 'M', '𐖵'),
-    (0x1058F, 'M', '𐖶'),
-    (0x10590, 'M', '𐖷'),
-    (0x10591, 'M', '𐖸'),
-    (0x10592, 'M', '𐖹'),
-    (0x10593, 'X'),
-    (0x10594, 'M', '𐖻'),
-    (0x10595, 'M', '𐖼'),
-    (0x10596, 'X'),
-    (0x10597, 'V'),
-    (0x105A2, 'X'),
-    (0x105A3, 'V'),
-    (0x105B2, 'X'),
-    (0x105B3, 'V'),
-    (0x105BA, 'X'),
-    (0x105BB, 'V'),
-    (0x105BD, 'X'),
-    (0x10600, 'V'),
-    (0x10737, 'X'),
-    (0x10740, 'V'),
-    (0x10756, 'X'),
-    (0x10760, 'V'),
-    (0x10768, 'X'),
-    (0x10780, 'V'),
-    (0x10781, 'M', 'ː'),
-    (0x10782, 'M', 'ˑ'),
-    (0x10783, 'M', 'æ'),
-    (0x10784, 'M', 'ʙ'),
-    (0x10785, 'M', 'ɓ'),
-    (0x10786, 'X'),
-    (0x10787, 'M', 'ʣ'),
-    (0x10788, 'M', 'ꭦ'),
-    (0x10789, 'M', 'ʥ'),
-    (0x1078A, 'M', 'ʤ'),
-    (0x1078B, 'M', 'ɖ'),
-    (0x1078C, 'M', 'ɗ'),
+        (0x104BA, "M", "𐓢"),
+        (0x104BB, "M", "𐓣"),
+        (0x104BC, "M", "𐓤"),
+        (0x104BD, "M", "𐓥"),
+        (0x104BE, "M", "𐓦"),
+        (0x104BF, "M", "𐓧"),
+        (0x104C0, "M", "𐓨"),
+        (0x104C1, "M", "𐓩"),
+        (0x104C2, "M", "𐓪"),
+        (0x104C3, "M", "𐓫"),
+        (0x104C4, "M", "𐓬"),
+        (0x104C5, "M", "𐓭"),
+        (0x104C6, "M", "𐓮"),
+        (0x104C7, "M", "𐓯"),
+        (0x104C8, "M", "𐓰"),
+        (0x104C9, "M", "𐓱"),
+        (0x104CA, "M", "𐓲"),
+        (0x104CB, "M", "𐓳"),
+        (0x104CC, "M", "𐓴"),
+        (0x104CD, "M", "𐓵"),
+        (0x104CE, "M", "𐓶"),
+        (0x104CF, "M", "𐓷"),
+        (0x104D0, "M", "𐓸"),
+        (0x104D1, "M", "𐓹"),
+        (0x104D2, "M", "𐓺"),
+        (0x104D3, "M", "𐓻"),
+        (0x104D4, "X"),
+        (0x104D8, "V"),
+        (0x104FC, "X"),
+        (0x10500, "V"),
+        (0x10528, "X"),
+        (0x10530, "V"),
+        (0x10564, "X"),
+        (0x1056F, "V"),
+        (0x10570, "M", "𐖗"),
+        (0x10571, "M", "𐖘"),
+        (0x10572, "M", "𐖙"),
+        (0x10573, "M", "𐖚"),
+        (0x10574, "M", "𐖛"),
+        (0x10575, "M", "𐖜"),
+        (0x10576, "M", "𐖝"),
+        (0x10577, "M", "𐖞"),
+        (0x10578, "M", "𐖟"),
+        (0x10579, "M", "𐖠"),
+        (0x1057A, "M", "𐖡"),
+        (0x1057B, "X"),
+        (0x1057C, "M", "𐖣"),
+        (0x1057D, "M", "𐖤"),
+        (0x1057E, "M", "𐖥"),
+        (0x1057F, "M", "𐖦"),
+        (0x10580, "M", "𐖧"),
+        (0x10581, "M", "𐖨"),
+        (0x10582, "M", "𐖩"),
+        (0x10583, "M", "𐖪"),
+        (0x10584, "M", "𐖫"),
+        (0x10585, "M", "𐖬"),
+        (0x10586, "M", "𐖭"),
+        (0x10587, "M", "𐖮"),
+        (0x10588, "M", "𐖯"),
+        (0x10589, "M", "𐖰"),
+        (0x1058A, "M", "𐖱"),
+        (0x1058B, "X"),
+        (0x1058C, "M", "𐖳"),
+        (0x1058D, "M", "𐖴"),
+        (0x1058E, "M", "𐖵"),
+        (0x1058F, "M", "𐖶"),
+        (0x10590, "M", "𐖷"),
+        (0x10591, "M", "𐖸"),
+        (0x10592, "M", "𐖹"),
+        (0x10593, "X"),
+        (0x10594, "M", "𐖻"),
+        (0x10595, "M", "𐖼"),
+        (0x10596, "X"),
+        (0x10597, "V"),
+        (0x105A2, "X"),
+        (0x105A3, "V"),
+        (0x105B2, "X"),
+        (0x105B3, "V"),
+        (0x105BA, "X"),
+        (0x105BB, "V"),
+        (0x105BD, "X"),
+        (0x10600, "V"),
+        (0x10737, "X"),
+        (0x10740, "V"),
+        (0x10756, "X"),
+        (0x10760, "V"),
+        (0x10768, "X"),
+        (0x10780, "V"),
+        (0x10781, "M", "ː"),
+        (0x10782, "M", "ˑ"),
+        (0x10783, "M", "æ"),
+        (0x10784, "M", "ʙ"),
+        (0x10785, "M", "ɓ"),
+        (0x10786, "X"),
+        (0x10787, "M", "ʣ"),
+        (0x10788, "M", "ꭦ"),
+        (0x10789, "M", "ʥ"),
+        (0x1078A, "M", "ʤ"),
+        (0x1078B, "M", "ɖ"),
+        (0x1078C, "M", "ɗ"),
     ]
 
+
 def _seg_55() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x1078D, 'M', 'ᶑ'),
-    (0x1078E, 'M', 'ɘ'),
-    (0x1078F, 'M', 'ɞ'),
-    (0x10790, 'M', 'ʩ'),
-    (0x10791, 'M', 'ɤ'),
-    (0x10792, 'M', 'ɢ'),
-    (0x10793, 'M', 'ɠ'),
-    (0x10794, 'M', 'ʛ'),
-    (0x10795, 'M', 'ħ'),
-    (0x10796, 'M', 'ʜ'),
-    (0x10797, 'M', 'ɧ'),
-    (0x10798, 'M', 'ʄ'),
-    (0x10799, 'M', 'ʪ'),
-    (0x1079A, 'M', 'ʫ'),
-    (0x1079B, 'M', 'ɬ'),
-    (0x1079C, 'M', '𝼄'),
-    (0x1079D, 'M', 'ꞎ'),
-    (0x1079E, 'M', 'ɮ'),
-    (0x1079F, 'M', '𝼅'),
-    (0x107A0, 'M', 'ʎ'),
-    (0x107A1, 'M', '𝼆'),
-    (0x107A2, 'M', 'ø'),
-    (0x107A3, 'M', 'ɶ'),
-    (0x107A4, 'M', 'ɷ'),
-    (0x107A5, 'M', 'q'),
-    (0x107A6, 'M', 'ɺ'),
-    (0x107A7, 'M', '𝼈'),
-    (0x107A8, 'M', 'ɽ'),
-    (0x107A9, 'M', 'ɾ'),
-    (0x107AA, 'M', 'ʀ'),
-    (0x107AB, 'M', 'ʨ'),
-    (0x107AC, 'M', 'ʦ'),
-    (0x107AD, 'M', 'ꭧ'),
-    (0x107AE, 'M', 'ʧ'),
-    (0x107AF, 'M', 'ʈ'),
-    (0x107B0, 'M', 'ⱱ'),
-    (0x107B1, 'X'),
-    (0x107B2, 'M', 'ʏ'),
-    (0x107B3, 'M', 'ʡ'),
-    (0x107B4, 'M', 'ʢ'),
-    (0x107B5, 'M', 'ʘ'),
-    (0x107B6, 'M', 'ǀ'),
-    (0x107B7, 'M', 'ǁ'),
-    (0x107B8, 'M', 'ǂ'),
-    (0x107B9, 'M', '𝼊'),
-    (0x107BA, 'M', '𝼞'),
-    (0x107BB, 'X'),
-    (0x10800, 'V'),
-    (0x10806, 'X'),
-    (0x10808, 'V'),
-    (0x10809, 'X'),
-    (0x1080A, 'V'),
-    (0x10836, 'X'),
-    (0x10837, 'V'),
-    (0x10839, 'X'),
-    (0x1083C, 'V'),
-    (0x1083D, 'X'),
-    (0x1083F, 'V'),
-    (0x10856, 'X'),
-    (0x10857, 'V'),
-    (0x1089F, 'X'),
-    (0x108A7, 'V'),
-    (0x108B0, 'X'),
-    (0x108E0, 'V'),
-    (0x108F3, 'X'),
-    (0x108F4, 'V'),
-    (0x108F6, 'X'),
-    (0x108FB, 'V'),
-    (0x1091C, 'X'),
-    (0x1091F, 'V'),
-    (0x1093A, 'X'),
-    (0x1093F, 'V'),
-    (0x10940, 'X'),
-    (0x10980, 'V'),
-    (0x109B8, 'X'),
-    (0x109BC, 'V'),
-    (0x109D0, 'X'),
-    (0x109D2, 'V'),
-    (0x10A04, 'X'),
-    (0x10A05, 'V'),
-    (0x10A07, 'X'),
-    (0x10A0C, 'V'),
-    (0x10A14, 'X'),
-    (0x10A15, 'V'),
-    (0x10A18, 'X'),
-    (0x10A19, 'V'),
-    (0x10A36, 'X'),
-    (0x10A38, 'V'),
-    (0x10A3B, 'X'),
-    (0x10A3F, 'V'),
-    (0x10A49, 'X'),
-    (0x10A50, 'V'),
-    (0x10A59, 'X'),
-    (0x10A60, 'V'),
-    (0x10AA0, 'X'),
-    (0x10AC0, 'V'),
-    (0x10AE7, 'X'),
-    (0x10AEB, 'V'),
-    (0x10AF7, 'X'),
-    (0x10B00, 'V'),
+        (0x1078D, "M", "ᶑ"),
+        (0x1078E, "M", "ɘ"),
+        (0x1078F, "M", "ɞ"),
+        (0x10790, "M", "ʩ"),
+        (0x10791, "M", "ɤ"),
+        (0x10792, "M", "ɢ"),
+        (0x10793, "M", "ɠ"),
+        (0x10794, "M", "ʛ"),
+        (0x10795, "M", "ħ"),
+        (0x10796, "M", "ʜ"),
+        (0x10797, "M", "ɧ"),
+        (0x10798, "M", "ʄ"),
+        (0x10799, "M", "ʪ"),
+        (0x1079A, "M", "ʫ"),
+        (0x1079B, "M", "ɬ"),
+        (0x1079C, "M", "𝼄"),
+        (0x1079D, "M", "ꞎ"),
+        (0x1079E, "M", "ɮ"),
+        (0x1079F, "M", "𝼅"),
+        (0x107A0, "M", "ʎ"),
+        (0x107A1, "M", "𝼆"),
+        (0x107A2, "M", "ø"),
+        (0x107A3, "M", "ɶ"),
+        (0x107A4, "M", "ɷ"),
+        (0x107A5, "M", "q"),
+        (0x107A6, "M", "ɺ"),
+        (0x107A7, "M", "𝼈"),
+        (0x107A8, "M", "ɽ"),
+        (0x107A9, "M", "ɾ"),
+        (0x107AA, "M", "ʀ"),
+        (0x107AB, "M", "ʨ"),
+        (0x107AC, "M", "ʦ"),
+        (0x107AD, "M", "ꭧ"),
+        (0x107AE, "M", "ʧ"),
+        (0x107AF, "M", "ʈ"),
+        (0x107B0, "M", "ⱱ"),
+        (0x107B1, "X"),
+        (0x107B2, "M", "ʏ"),
+        (0x107B3, "M", "ʡ"),
+        (0x107B4, "M", "ʢ"),
+        (0x107B5, "M", "ʘ"),
+        (0x107B6, "M", "ǀ"),
+        (0x107B7, "M", "ǁ"),
+        (0x107B8, "M", "ǂ"),
+        (0x107B9, "M", "𝼊"),
+        (0x107BA, "M", "𝼞"),
+        (0x107BB, "X"),
+        (0x10800, "V"),
+        (0x10806, "X"),
+        (0x10808, "V"),
+        (0x10809, "X"),
+        (0x1080A, "V"),
+        (0x10836, "X"),
+        (0x10837, "V"),
+        (0x10839, "X"),
+        (0x1083C, "V"),
+        (0x1083D, "X"),
+        (0x1083F, "V"),
+        (0x10856, "X"),
+        (0x10857, "V"),
+        (0x1089F, "X"),
+        (0x108A7, "V"),
+        (0x108B0, "X"),
+        (0x108E0, "V"),
+        (0x108F3, "X"),
+        (0x108F4, "V"),
+        (0x108F6, "X"),
+        (0x108FB, "V"),
+        (0x1091C, "X"),
+        (0x1091F, "V"),
+        (0x1093A, "X"),
+        (0x1093F, "V"),
+        (0x10940, "X"),
+        (0x10980, "V"),
+        (0x109B8, "X"),
+        (0x109BC, "V"),
+        (0x109D0, "X"),
+        (0x109D2, "V"),
+        (0x10A04, "X"),
+        (0x10A05, "V"),
+        (0x10A07, "X"),
+        (0x10A0C, "V"),
+        (0x10A14, "X"),
+        (0x10A15, "V"),
+        (0x10A18, "X"),
+        (0x10A19, "V"),
+        (0x10A36, "X"),
+        (0x10A38, "V"),
+        (0x10A3B, "X"),
+        (0x10A3F, "V"),
+        (0x10A49, "X"),
+        (0x10A50, "V"),
+        (0x10A59, "X"),
+        (0x10A60, "V"),
+        (0x10AA0, "X"),
+        (0x10AC0, "V"),
+        (0x10AE7, "X"),
+        (0x10AEB, "V"),
+        (0x10AF7, "X"),
+        (0x10B00, "V"),
     ]
 
+
 def _seg_56() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x10B36, 'X'),
-    (0x10B39, 'V'),
-    (0x10B56, 'X'),
-    (0x10B58, 'V'),
-    (0x10B73, 'X'),
-    (0x10B78, 'V'),
-    (0x10B92, 'X'),
-    (0x10B99, 'V'),
-    (0x10B9D, 'X'),
-    (0x10BA9, 'V'),
-    (0x10BB0, 'X'),
-    (0x10C00, 'V'),
-    (0x10C49, 'X'),
-    (0x10C80, 'M', '𐳀'),
-    (0x10C81, 'M', '𐳁'),
-    (0x10C82, 'M', '𐳂'),
-    (0x10C83, 'M', '𐳃'),
-    (0x10C84, 'M', '𐳄'),
-    (0x10C85, 'M', '𐳅'),
-    (0x10C86, 'M', '𐳆'),
-    (0x10C87, 'M', '𐳇'),
-    (0x10C88, 'M', '𐳈'),
-    (0x10C89, 'M', '𐳉'),
-    (0x10C8A, 'M', '𐳊'),
-    (0x10C8B, 'M', '𐳋'),
-    (0x10C8C, 'M', '𐳌'),
-    (0x10C8D, 'M', '𐳍'),
-    (0x10C8E, 'M', '𐳎'),
-    (0x10C8F, 'M', '𐳏'),
-    (0x10C90, 'M', '𐳐'),
-    (0x10C91, 'M', '𐳑'),
-    (0x10C92, 'M', '𐳒'),
-    (0x10C93, 'M', '𐳓'),
-    (0x10C94, 'M', '𐳔'),
-    (0x10C95, 'M', '𐳕'),
-    (0x10C96, 'M', '𐳖'),
-    (0x10C97, 'M', '𐳗'),
-    (0x10C98, 'M', '𐳘'),
-    (0x10C99, 'M', '𐳙'),
-    (0x10C9A, 'M', '𐳚'),
-    (0x10C9B, 'M', '𐳛'),
-    (0x10C9C, 'M', '𐳜'),
-    (0x10C9D, 'M', '𐳝'),
-    (0x10C9E, 'M', '𐳞'),
-    (0x10C9F, 'M', '𐳟'),
-    (0x10CA0, 'M', '𐳠'),
-    (0x10CA1, 'M', '𐳡'),
-    (0x10CA2, 'M', '𐳢'),
-    (0x10CA3, 'M', '𐳣'),
-    (0x10CA4, 'M', '𐳤'),
-    (0x10CA5, 'M', '𐳥'),
-    (0x10CA6, 'M', '𐳦'),
-    (0x10CA7, 'M', '𐳧'),
-    (0x10CA8, 'M', '𐳨'),
-    (0x10CA9, 'M', '𐳩'),
-    (0x10CAA, 'M', '𐳪'),
-    (0x10CAB, 'M', '𐳫'),
-    (0x10CAC, 'M', '𐳬'),
-    (0x10CAD, 'M', '𐳭'),
-    (0x10CAE, 'M', '𐳮'),
-    (0x10CAF, 'M', '𐳯'),
-    (0x10CB0, 'M', '𐳰'),
-    (0x10CB1, 'M', '𐳱'),
-    (0x10CB2, 'M', '𐳲'),
-    (0x10CB3, 'X'),
-    (0x10CC0, 'V'),
-    (0x10CF3, 'X'),
-    (0x10CFA, 'V'),
-    (0x10D28, 'X'),
-    (0x10D30, 'V'),
-    (0x10D3A, 'X'),
-    (0x10E60, 'V'),
-    (0x10E7F, 'X'),
-    (0x10E80, 'V'),
-    (0x10EAA, 'X'),
-    (0x10EAB, 'V'),
-    (0x10EAE, 'X'),
-    (0x10EB0, 'V'),
-    (0x10EB2, 'X'),
-    (0x10EFD, 'V'),
-    (0x10F28, 'X'),
-    (0x10F30, 'V'),
-    (0x10F5A, 'X'),
-    (0x10F70, 'V'),
-    (0x10F8A, 'X'),
-    (0x10FB0, 'V'),
-    (0x10FCC, 'X'),
-    (0x10FE0, 'V'),
-    (0x10FF7, 'X'),
-    (0x11000, 'V'),
-    (0x1104E, 'X'),
-    (0x11052, 'V'),
-    (0x11076, 'X'),
-    (0x1107F, 'V'),
-    (0x110BD, 'X'),
-    (0x110BE, 'V'),
-    (0x110C3, 'X'),
-    (0x110D0, 'V'),
-    (0x110E9, 'X'),
-    (0x110F0, 'V'),
+        (0x10B36, "X"),
+        (0x10B39, "V"),
+        (0x10B56, "X"),
+        (0x10B58, "V"),
+        (0x10B73, "X"),
+        (0x10B78, "V"),
+        (0x10B92, "X"),
+        (0x10B99, "V"),
+        (0x10B9D, "X"),
+        (0x10BA9, "V"),
+        (0x10BB0, "X"),
+        (0x10C00, "V"),
+        (0x10C49, "X"),
+        (0x10C80, "M", "𐳀"),
+        (0x10C81, "M", "𐳁"),
+        (0x10C82, "M", "𐳂"),
+        (0x10C83, "M", "𐳃"),
+        (0x10C84, "M", "𐳄"),
+        (0x10C85, "M", "𐳅"),
+        (0x10C86, "M", "𐳆"),
+        (0x10C87, "M", "𐳇"),
+        (0x10C88, "M", "𐳈"),
+        (0x10C89, "M", "𐳉"),
+        (0x10C8A, "M", "𐳊"),
+        (0x10C8B, "M", "𐳋"),
+        (0x10C8C, "M", "𐳌"),
+        (0x10C8D, "M", "𐳍"),
+        (0x10C8E, "M", "𐳎"),
+        (0x10C8F, "M", "𐳏"),
+        (0x10C90, "M", "𐳐"),
+        (0x10C91, "M", "𐳑"),
+        (0x10C92, "M", "𐳒"),
+        (0x10C93, "M", "𐳓"),
+        (0x10C94, "M", "𐳔"),
+        (0x10C95, "M", "𐳕"),
+        (0x10C96, "M", "𐳖"),
+        (0x10C97, "M", "𐳗"),
+        (0x10C98, "M", "𐳘"),
+        (0x10C99, "M", "𐳙"),
+        (0x10C9A, "M", "𐳚"),
+        (0x10C9B, "M", "𐳛"),
+        (0x10C9C, "M", "𐳜"),
+        (0x10C9D, "M", "𐳝"),
+        (0x10C9E, "M", "𐳞"),
+        (0x10C9F, "M", "𐳟"),
+        (0x10CA0, "M", "𐳠"),
+        (0x10CA1, "M", "𐳡"),
+        (0x10CA2, "M", "𐳢"),
+        (0x10CA3, "M", "𐳣"),
+        (0x10CA4, "M", "𐳤"),
+        (0x10CA5, "M", "𐳥"),
+        (0x10CA6, "M", "𐳦"),
+        (0x10CA7, "M", "𐳧"),
+        (0x10CA8, "M", "𐳨"),
+        (0x10CA9, "M", "𐳩"),
+        (0x10CAA, "M", "𐳪"),
+        (0x10CAB, "M", "𐳫"),
+        (0x10CAC, "M", "𐳬"),
+        (0x10CAD, "M", "𐳭"),
+        (0x10CAE, "M", "𐳮"),
+        (0x10CAF, "M", "𐳯"),
+        (0x10CB0, "M", "𐳰"),
+        (0x10CB1, "M", "𐳱"),
+        (0x10CB2, "M", "𐳲"),
+        (0x10CB3, "X"),
+        (0x10CC0, "V"),
+        (0x10CF3, "X"),
+        (0x10CFA, "V"),
+        (0x10D28, "X"),
+        (0x10D30, "V"),
+        (0x10D3A, "X"),
+        (0x10E60, "V"),
+        (0x10E7F, "X"),
+        (0x10E80, "V"),
+        (0x10EAA, "X"),
+        (0x10EAB, "V"),
+        (0x10EAE, "X"),
+        (0x10EB0, "V"),
+        (0x10EB2, "X"),
+        (0x10EFD, "V"),
+        (0x10F28, "X"),
+        (0x10F30, "V"),
+        (0x10F5A, "X"),
+        (0x10F70, "V"),
+        (0x10F8A, "X"),
+        (0x10FB0, "V"),
+        (0x10FCC, "X"),
+        (0x10FE0, "V"),
+        (0x10FF7, "X"),
+        (0x11000, "V"),
+        (0x1104E, "X"),
+        (0x11052, "V"),
+        (0x11076, "X"),
+        (0x1107F, "V"),
+        (0x110BD, "X"),
+        (0x110BE, "V"),
+        (0x110C3, "X"),
+        (0x110D0, "V"),
+        (0x110E9, "X"),
+        (0x110F0, "V"),
     ]
 
+
 def _seg_57() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x110FA, 'X'),
-    (0x11100, 'V'),
-    (0x11135, 'X'),
-    (0x11136, 'V'),
-    (0x11148, 'X'),
-    (0x11150, 'V'),
-    (0x11177, 'X'),
-    (0x11180, 'V'),
-    (0x111E0, 'X'),
-    (0x111E1, 'V'),
-    (0x111F5, 'X'),
-    (0x11200, 'V'),
-    (0x11212, 'X'),
-    (0x11213, 'V'),
-    (0x11242, 'X'),
-    (0x11280, 'V'),
-    (0x11287, 'X'),
-    (0x11288, 'V'),
-    (0x11289, 'X'),
-    (0x1128A, 'V'),
-    (0x1128E, 'X'),
-    (0x1128F, 'V'),
-    (0x1129E, 'X'),
-    (0x1129F, 'V'),
-    (0x112AA, 'X'),
-    (0x112B0, 'V'),
-    (0x112EB, 'X'),
-    (0x112F0, 'V'),
-    (0x112FA, 'X'),
-    (0x11300, 'V'),
-    (0x11304, 'X'),
-    (0x11305, 'V'),
-    (0x1130D, 'X'),
-    (0x1130F, 'V'),
-    (0x11311, 'X'),
-    (0x11313, 'V'),
-    (0x11329, 'X'),
-    (0x1132A, 'V'),
-    (0x11331, 'X'),
-    (0x11332, 'V'),
-    (0x11334, 'X'),
-    (0x11335, 'V'),
-    (0x1133A, 'X'),
-    (0x1133B, 'V'),
-    (0x11345, 'X'),
-    (0x11347, 'V'),
-    (0x11349, 'X'),
-    (0x1134B, 'V'),
-    (0x1134E, 'X'),
-    (0x11350, 'V'),
-    (0x11351, 'X'),
-    (0x11357, 'V'),
-    (0x11358, 'X'),
-    (0x1135D, 'V'),
-    (0x11364, 'X'),
-    (0x11366, 'V'),
-    (0x1136D, 'X'),
-    (0x11370, 'V'),
-    (0x11375, 'X'),
-    (0x11400, 'V'),
-    (0x1145C, 'X'),
-    (0x1145D, 'V'),
-    (0x11462, 'X'),
-    (0x11480, 'V'),
-    (0x114C8, 'X'),
-    (0x114D0, 'V'),
-    (0x114DA, 'X'),
-    (0x11580, 'V'),
-    (0x115B6, 'X'),
-    (0x115B8, 'V'),
-    (0x115DE, 'X'),
-    (0x11600, 'V'),
-    (0x11645, 'X'),
-    (0x11650, 'V'),
-    (0x1165A, 'X'),
-    (0x11660, 'V'),
-    (0x1166D, 'X'),
-    (0x11680, 'V'),
-    (0x116BA, 'X'),
-    (0x116C0, 'V'),
-    (0x116CA, 'X'),
-    (0x11700, 'V'),
-    (0x1171B, 'X'),
-    (0x1171D, 'V'),
-    (0x1172C, 'X'),
-    (0x11730, 'V'),
-    (0x11747, 'X'),
-    (0x11800, 'V'),
-    (0x1183C, 'X'),
-    (0x118A0, 'M', '𑣀'),
-    (0x118A1, 'M', '𑣁'),
-    (0x118A2, 'M', '𑣂'),
-    (0x118A3, 'M', '𑣃'),
-    (0x118A4, 'M', '𑣄'),
-    (0x118A5, 'M', '𑣅'),
-    (0x118A6, 'M', '𑣆'),
-    (0x118A7, 'M', '𑣇'),
-    (0x118A8, 'M', '𑣈'),
-    (0x118A9, 'M', '𑣉'),
-    (0x118AA, 'M', '𑣊'),
+        (0x110FA, "X"),
+        (0x11100, "V"),
+        (0x11135, "X"),
+        (0x11136, "V"),
+        (0x11148, "X"),
+        (0x11150, "V"),
+        (0x11177, "X"),
+        (0x11180, "V"),
+        (0x111E0, "X"),
+        (0x111E1, "V"),
+        (0x111F5, "X"),
+        (0x11200, "V"),
+        (0x11212, "X"),
+        (0x11213, "V"),
+        (0x11242, "X"),
+        (0x11280, "V"),
+        (0x11287, "X"),
+        (0x11288, "V"),
+        (0x11289, "X"),
+        (0x1128A, "V"),
+        (0x1128E, "X"),
+        (0x1128F, "V"),
+        (0x1129E, "X"),
+        (0x1129F, "V"),
+        (0x112AA, "X"),
+        (0x112B0, "V"),
+        (0x112EB, "X"),
+        (0x112F0, "V"),
+        (0x112FA, "X"),
+        (0x11300, "V"),
+        (0x11304, "X"),
+        (0x11305, "V"),
+        (0x1130D, "X"),
+        (0x1130F, "V"),
+        (0x11311, "X"),
+        (0x11313, "V"),
+        (0x11329, "X"),
+        (0x1132A, "V"),
+        (0x11331, "X"),
+        (0x11332, "V"),
+        (0x11334, "X"),
+        (0x11335, "V"),
+        (0x1133A, "X"),
+        (0x1133B, "V"),
+        (0x11345, "X"),
+        (0x11347, "V"),
+        (0x11349, "X"),
+        (0x1134B, "V"),
+        (0x1134E, "X"),
+        (0x11350, "V"),
+        (0x11351, "X"),
+        (0x11357, "V"),
+        (0x11358, "X"),
+        (0x1135D, "V"),
+        (0x11364, "X"),
+        (0x11366, "V"),
+        (0x1136D, "X"),
+        (0x11370, "V"),
+        (0x11375, "X"),
+        (0x11400, "V"),
+        (0x1145C, "X"),
+        (0x1145D, "V"),
+        (0x11462, "X"),
+        (0x11480, "V"),
+        (0x114C8, "X"),
+        (0x114D0, "V"),
+        (0x114DA, "X"),
+        (0x11580, "V"),
+        (0x115B6, "X"),
+        (0x115B8, "V"),
+        (0x115DE, "X"),
+        (0x11600, "V"),
+        (0x11645, "X"),
+        (0x11650, "V"),
+        (0x1165A, "X"),
+        (0x11660, "V"),
+        (0x1166D, "X"),
+        (0x11680, "V"),
+        (0x116BA, "X"),
+        (0x116C0, "V"),
+        (0x116CA, "X"),
+        (0x11700, "V"),
+        (0x1171B, "X"),
+        (0x1171D, "V"),
+        (0x1172C, "X"),
+        (0x11730, "V"),
+        (0x11747, "X"),
+        (0x11800, "V"),
+        (0x1183C, "X"),
+        (0x118A0, "M", "𑣀"),
+        (0x118A1, "M", "𑣁"),
+        (0x118A2, "M", "𑣂"),
+        (0x118A3, "M", "𑣃"),
+        (0x118A4, "M", "𑣄"),
+        (0x118A5, "M", "𑣅"),
+        (0x118A6, "M", "𑣆"),
+        (0x118A7, "M", "𑣇"),
+        (0x118A8, "M", "𑣈"),
+        (0x118A9, "M", "𑣉"),
+        (0x118AA, "M", "𑣊"),
     ]
 
+
 def _seg_58() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x118AB, 'M', '𑣋'),
-    (0x118AC, 'M', '𑣌'),
-    (0x118AD, 'M', '𑣍'),
-    (0x118AE, 'M', '𑣎'),
-    (0x118AF, 'M', '𑣏'),
-    (0x118B0, 'M', '𑣐'),
-    (0x118B1, 'M', '𑣑'),
-    (0x118B2, 'M', '𑣒'),
-    (0x118B3, 'M', '𑣓'),
-    (0x118B4, 'M', '𑣔'),
-    (0x118B5, 'M', '𑣕'),
-    (0x118B6, 'M', '𑣖'),
-    (0x118B7, 'M', '𑣗'),
-    (0x118B8, 'M', '𑣘'),
-    (0x118B9, 'M', '𑣙'),
-    (0x118BA, 'M', '𑣚'),
-    (0x118BB, 'M', '𑣛'),
-    (0x118BC, 'M', '𑣜'),
-    (0x118BD, 'M', '𑣝'),
-    (0x118BE, 'M', '𑣞'),
-    (0x118BF, 'M', '𑣟'),
-    (0x118C0, 'V'),
-    (0x118F3, 'X'),
-    (0x118FF, 'V'),
-    (0x11907, 'X'),
-    (0x11909, 'V'),
-    (0x1190A, 'X'),
-    (0x1190C, 'V'),
-    (0x11914, 'X'),
-    (0x11915, 'V'),
-    (0x11917, 'X'),
-    (0x11918, 'V'),
-    (0x11936, 'X'),
-    (0x11937, 'V'),
-    (0x11939, 'X'),
-    (0x1193B, 'V'),
-    (0x11947, 'X'),
-    (0x11950, 'V'),
-    (0x1195A, 'X'),
-    (0x119A0, 'V'),
-    (0x119A8, 'X'),
-    (0x119AA, 'V'),
-    (0x119D8, 'X'),
-    (0x119DA, 'V'),
-    (0x119E5, 'X'),
-    (0x11A00, 'V'),
-    (0x11A48, 'X'),
-    (0x11A50, 'V'),
-    (0x11AA3, 'X'),
-    (0x11AB0, 'V'),
-    (0x11AF9, 'X'),
-    (0x11B00, 'V'),
-    (0x11B0A, 'X'),
-    (0x11C00, 'V'),
-    (0x11C09, 'X'),
-    (0x11C0A, 'V'),
-    (0x11C37, 'X'),
-    (0x11C38, 'V'),
-    (0x11C46, 'X'),
-    (0x11C50, 'V'),
-    (0x11C6D, 'X'),
-    (0x11C70, 'V'),
-    (0x11C90, 'X'),
-    (0x11C92, 'V'),
-    (0x11CA8, 'X'),
-    (0x11CA9, 'V'),
-    (0x11CB7, 'X'),
-    (0x11D00, 'V'),
-    (0x11D07, 'X'),
-    (0x11D08, 'V'),
-    (0x11D0A, 'X'),
-    (0x11D0B, 'V'),
-    (0x11D37, 'X'),
-    (0x11D3A, 'V'),
-    (0x11D3B, 'X'),
-    (0x11D3C, 'V'),
-    (0x11D3E, 'X'),
-    (0x11D3F, 'V'),
-    (0x11D48, 'X'),
-    (0x11D50, 'V'),
-    (0x11D5A, 'X'),
-    (0x11D60, 'V'),
-    (0x11D66, 'X'),
-    (0x11D67, 'V'),
-    (0x11D69, 'X'),
-    (0x11D6A, 'V'),
-    (0x11D8F, 'X'),
-    (0x11D90, 'V'),
-    (0x11D92, 'X'),
-    (0x11D93, 'V'),
-    (0x11D99, 'X'),
-    (0x11DA0, 'V'),
-    (0x11DAA, 'X'),
-    (0x11EE0, 'V'),
-    (0x11EF9, 'X'),
-    (0x11F00, 'V'),
-    (0x11F11, 'X'),
-    (0x11F12, 'V'),
-    (0x11F3B, 'X'),
-    (0x11F3E, 'V'),
+        (0x118AB, "M", "𑣋"),
+        (0x118AC, "M", "𑣌"),
+        (0x118AD, "M", "𑣍"),
+        (0x118AE, "M", "𑣎"),
+        (0x118AF, "M", "𑣏"),
+        (0x118B0, "M", "𑣐"),
+        (0x118B1, "M", "𑣑"),
+        (0x118B2, "M", "𑣒"),
+        (0x118B3, "M", "𑣓"),
+        (0x118B4, "M", "𑣔"),
+        (0x118B5, "M", "𑣕"),
+        (0x118B6, "M", "𑣖"),
+        (0x118B7, "M", "𑣗"),
+        (0x118B8, "M", "𑣘"),
+        (0x118B9, "M", "𑣙"),
+        (0x118BA, "M", "𑣚"),
+        (0x118BB, "M", "𑣛"),
+        (0x118BC, "M", "𑣜"),
+        (0x118BD, "M", "𑣝"),
+        (0x118BE, "M", "𑣞"),
+        (0x118BF, "M", "𑣟"),
+        (0x118C0, "V"),
+        (0x118F3, "X"),
+        (0x118FF, "V"),
+        (0x11907, "X"),
+        (0x11909, "V"),
+        (0x1190A, "X"),
+        (0x1190C, "V"),
+        (0x11914, "X"),
+        (0x11915, "V"),
+        (0x11917, "X"),
+        (0x11918, "V"),
+        (0x11936, "X"),
+        (0x11937, "V"),
+        (0x11939, "X"),
+        (0x1193B, "V"),
+        (0x11947, "X"),
+        (0x11950, "V"),
+        (0x1195A, "X"),
+        (0x119A0, "V"),
+        (0x119A8, "X"),
+        (0x119AA, "V"),
+        (0x119D8, "X"),
+        (0x119DA, "V"),
+        (0x119E5, "X"),
+        (0x11A00, "V"),
+        (0x11A48, "X"),
+        (0x11A50, "V"),
+        (0x11AA3, "X"),
+        (0x11AB0, "V"),
+        (0x11AF9, "X"),
+        (0x11B00, "V"),
+        (0x11B0A, "X"),
+        (0x11C00, "V"),
+        (0x11C09, "X"),
+        (0x11C0A, "V"),
+        (0x11C37, "X"),
+        (0x11C38, "V"),
+        (0x11C46, "X"),
+        (0x11C50, "V"),
+        (0x11C6D, "X"),
+        (0x11C70, "V"),
+        (0x11C90, "X"),
+        (0x11C92, "V"),
+        (0x11CA8, "X"),
+        (0x11CA9, "V"),
+        (0x11CB7, "X"),
+        (0x11D00, "V"),
+        (0x11D07, "X"),
+        (0x11D08, "V"),
+        (0x11D0A, "X"),
+        (0x11D0B, "V"),
+        (0x11D37, "X"),
+        (0x11D3A, "V"),
+        (0x11D3B, "X"),
+        (0x11D3C, "V"),
+        (0x11D3E, "X"),
+        (0x11D3F, "V"),
+        (0x11D48, "X"),
+        (0x11D50, "V"),
+        (0x11D5A, "X"),
+        (0x11D60, "V"),
+        (0x11D66, "X"),
+        (0x11D67, "V"),
+        (0x11D69, "X"),
+        (0x11D6A, "V"),
+        (0x11D8F, "X"),
+        (0x11D90, "V"),
+        (0x11D92, "X"),
+        (0x11D93, "V"),
+        (0x11D99, "X"),
+        (0x11DA0, "V"),
+        (0x11DAA, "X"),
+        (0x11EE0, "V"),
+        (0x11EF9, "X"),
+        (0x11F00, "V"),
+        (0x11F11, "X"),
+        (0x11F12, "V"),
+        (0x11F3B, "X"),
+        (0x11F3E, "V"),
     ]
 
+
 def _seg_59() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x11F5A, 'X'),
-    (0x11FB0, 'V'),
-    (0x11FB1, 'X'),
-    (0x11FC0, 'V'),
-    (0x11FF2, 'X'),
-    (0x11FFF, 'V'),
-    (0x1239A, 'X'),
-    (0x12400, 'V'),
-    (0x1246F, 'X'),
-    (0x12470, 'V'),
-    (0x12475, 'X'),
-    (0x12480, 'V'),
-    (0x12544, 'X'),
-    (0x12F90, 'V'),
-    (0x12FF3, 'X'),
-    (0x13000, 'V'),
-    (0x13430, 'X'),
-    (0x13440, 'V'),
-    (0x13456, 'X'),
-    (0x14400, 'V'),
-    (0x14647, 'X'),
-    (0x16800, 'V'),
-    (0x16A39, 'X'),
-    (0x16A40, 'V'),
-    (0x16A5F, 'X'),
-    (0x16A60, 'V'),
-    (0x16A6A, 'X'),
-    (0x16A6E, 'V'),
-    (0x16ABF, 'X'),
-    (0x16AC0, 'V'),
-    (0x16ACA, 'X'),
-    (0x16AD0, 'V'),
-    (0x16AEE, 'X'),
-    (0x16AF0, 'V'),
-    (0x16AF6, 'X'),
-    (0x16B00, 'V'),
-    (0x16B46, 'X'),
-    (0x16B50, 'V'),
-    (0x16B5A, 'X'),
-    (0x16B5B, 'V'),
-    (0x16B62, 'X'),
-    (0x16B63, 'V'),
-    (0x16B78, 'X'),
-    (0x16B7D, 'V'),
-    (0x16B90, 'X'),
-    (0x16E40, 'M', '𖹠'),
-    (0x16E41, 'M', '𖹡'),
-    (0x16E42, 'M', '𖹢'),
-    (0x16E43, 'M', '𖹣'),
-    (0x16E44, 'M', '𖹤'),
-    (0x16E45, 'M', '𖹥'),
-    (0x16E46, 'M', '𖹦'),
-    (0x16E47, 'M', '𖹧'),
-    (0x16E48, 'M', '𖹨'),
-    (0x16E49, 'M', '𖹩'),
-    (0x16E4A, 'M', '𖹪'),
-    (0x16E4B, 'M', '𖹫'),
-    (0x16E4C, 'M', '𖹬'),
-    (0x16E4D, 'M', '𖹭'),
-    (0x16E4E, 'M', '𖹮'),
-    (0x16E4F, 'M', '𖹯'),
-    (0x16E50, 'M', '𖹰'),
-    (0x16E51, 'M', '𖹱'),
-    (0x16E52, 'M', '𖹲'),
-    (0x16E53, 'M', '𖹳'),
-    (0x16E54, 'M', '𖹴'),
-    (0x16E55, 'M', '𖹵'),
-    (0x16E56, 'M', '𖹶'),
-    (0x16E57, 'M', '𖹷'),
-    (0x16E58, 'M', '𖹸'),
-    (0x16E59, 'M', '𖹹'),
-    (0x16E5A, 'M', '𖹺'),
-    (0x16E5B, 'M', '𖹻'),
-    (0x16E5C, 'M', '𖹼'),
-    (0x16E5D, 'M', '𖹽'),
-    (0x16E5E, 'M', '𖹾'),
-    (0x16E5F, 'M', '𖹿'),
-    (0x16E60, 'V'),
-    (0x16E9B, 'X'),
-    (0x16F00, 'V'),
-    (0x16F4B, 'X'),
-    (0x16F4F, 'V'),
-    (0x16F88, 'X'),
-    (0x16F8F, 'V'),
-    (0x16FA0, 'X'),
-    (0x16FE0, 'V'),
-    (0x16FE5, 'X'),
-    (0x16FF0, 'V'),
-    (0x16FF2, 'X'),
-    (0x17000, 'V'),
-    (0x187F8, 'X'),
-    (0x18800, 'V'),
-    (0x18CD6, 'X'),
-    (0x18D00, 'V'),
-    (0x18D09, 'X'),
-    (0x1AFF0, 'V'),
-    (0x1AFF4, 'X'),
-    (0x1AFF5, 'V'),
-    (0x1AFFC, 'X'),
-    (0x1AFFD, 'V'),
+        (0x11F5A, "X"),
+        (0x11FB0, "V"),
+        (0x11FB1, "X"),
+        (0x11FC0, "V"),
+        (0x11FF2, "X"),
+        (0x11FFF, "V"),
+        (0x1239A, "X"),
+        (0x12400, "V"),
+        (0x1246F, "X"),
+        (0x12470, "V"),
+        (0x12475, "X"),
+        (0x12480, "V"),
+        (0x12544, "X"),
+        (0x12F90, "V"),
+        (0x12FF3, "X"),
+        (0x13000, "V"),
+        (0x13430, "X"),
+        (0x13440, "V"),
+        (0x13456, "X"),
+        (0x14400, "V"),
+        (0x14647, "X"),
+        (0x16800, "V"),
+        (0x16A39, "X"),
+        (0x16A40, "V"),
+        (0x16A5F, "X"),
+        (0x16A60, "V"),
+        (0x16A6A, "X"),
+        (0x16A6E, "V"),
+        (0x16ABF, "X"),
+        (0x16AC0, "V"),
+        (0x16ACA, "X"),
+        (0x16AD0, "V"),
+        (0x16AEE, "X"),
+        (0x16AF0, "V"),
+        (0x16AF6, "X"),
+        (0x16B00, "V"),
+        (0x16B46, "X"),
+        (0x16B50, "V"),
+        (0x16B5A, "X"),
+        (0x16B5B, "V"),
+        (0x16B62, "X"),
+        (0x16B63, "V"),
+        (0x16B78, "X"),
+        (0x16B7D, "V"),
+        (0x16B90, "X"),
+        (0x16E40, "M", "𖹠"),
+        (0x16E41, "M", "𖹡"),
+        (0x16E42, "M", "𖹢"),
+        (0x16E43, "M", "𖹣"),
+        (0x16E44, "M", "𖹤"),
+        (0x16E45, "M", "𖹥"),
+        (0x16E46, "M", "𖹦"),
+        (0x16E47, "M", "𖹧"),
+        (0x16E48, "M", "𖹨"),
+        (0x16E49, "M", "𖹩"),
+        (0x16E4A, "M", "𖹪"),
+        (0x16E4B, "M", "𖹫"),
+        (0x16E4C, "M", "𖹬"),
+        (0x16E4D, "M", "𖹭"),
+        (0x16E4E, "M", "𖹮"),
+        (0x16E4F, "M", "𖹯"),
+        (0x16E50, "M", "𖹰"),
+        (0x16E51, "M", "𖹱"),
+        (0x16E52, "M", "𖹲"),
+        (0x16E53, "M", "𖹳"),
+        (0x16E54, "M", "𖹴"),
+        (0x16E55, "M", "𖹵"),
+        (0x16E56, "M", "𖹶"),
+        (0x16E57, "M", "𖹷"),
+        (0x16E58, "M", "𖹸"),
+        (0x16E59, "M", "𖹹"),
+        (0x16E5A, "M", "𖹺"),
+        (0x16E5B, "M", "𖹻"),
+        (0x16E5C, "M", "𖹼"),
+        (0x16E5D, "M", "𖹽"),
+        (0x16E5E, "M", "𖹾"),
+        (0x16E5F, "M", "𖹿"),
+        (0x16E60, "V"),
+        (0x16E9B, "X"),
+        (0x16F00, "V"),
+        (0x16F4B, "X"),
+        (0x16F4F, "V"),
+        (0x16F88, "X"),
+        (0x16F8F, "V"),
+        (0x16FA0, "X"),
+        (0x16FE0, "V"),
+        (0x16FE5, "X"),
+        (0x16FF0, "V"),
+        (0x16FF2, "X"),
+        (0x17000, "V"),
+        (0x187F8, "X"),
+        (0x18800, "V"),
+        (0x18CD6, "X"),
+        (0x18D00, "V"),
+        (0x18D09, "X"),
+        (0x1AFF0, "V"),
+        (0x1AFF4, "X"),
+        (0x1AFF5, "V"),
+        (0x1AFFC, "X"),
+        (0x1AFFD, "V"),
     ]
 
+
 def _seg_60() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x1AFFF, 'X'),
-    (0x1B000, 'V'),
-    (0x1B123, 'X'),
-    (0x1B132, 'V'),
-    (0x1B133, 'X'),
-    (0x1B150, 'V'),
-    (0x1B153, 'X'),
-    (0x1B155, 'V'),
-    (0x1B156, 'X'),
-    (0x1B164, 'V'),
-    (0x1B168, 'X'),
-    (0x1B170, 'V'),
-    (0x1B2FC, 'X'),
-    (0x1BC00, 'V'),
-    (0x1BC6B, 'X'),
-    (0x1BC70, 'V'),
-    (0x1BC7D, 'X'),
-    (0x1BC80, 'V'),
-    (0x1BC89, 'X'),
-    (0x1BC90, 'V'),
-    (0x1BC9A, 'X'),
-    (0x1BC9C, 'V'),
-    (0x1BCA0, 'I'),
-    (0x1BCA4, 'X'),
-    (0x1CF00, 'V'),
-    (0x1CF2E, 'X'),
-    (0x1CF30, 'V'),
-    (0x1CF47, 'X'),
-    (0x1CF50, 'V'),
-    (0x1CFC4, 'X'),
-    (0x1D000, 'V'),
-    (0x1D0F6, 'X'),
-    (0x1D100, 'V'),
-    (0x1D127, 'X'),
-    (0x1D129, 'V'),
-    (0x1D15E, 'M', '𝅗𝅥'),
-    (0x1D15F, 'M', '𝅘𝅥'),
-    (0x1D160, 'M', '𝅘𝅥𝅮'),
-    (0x1D161, 'M', '𝅘𝅥𝅯'),
-    (0x1D162, 'M', '𝅘𝅥𝅰'),
-    (0x1D163, 'M', '𝅘𝅥𝅱'),
-    (0x1D164, 'M', '𝅘𝅥𝅲'),
-    (0x1D165, 'V'),
-    (0x1D173, 'X'),
-    (0x1D17B, 'V'),
-    (0x1D1BB, 'M', '𝆹𝅥'),
-    (0x1D1BC, 'M', '𝆺𝅥'),
-    (0x1D1BD, 'M', '𝆹𝅥𝅮'),
-    (0x1D1BE, 'M', '𝆺𝅥𝅮'),
-    (0x1D1BF, 'M', '𝆹𝅥𝅯'),
-    (0x1D1C0, 'M', '𝆺𝅥𝅯'),
-    (0x1D1C1, 'V'),
-    (0x1D1EB, 'X'),
-    (0x1D200, 'V'),
-    (0x1D246, 'X'),
-    (0x1D2C0, 'V'),
-    (0x1D2D4, 'X'),
-    (0x1D2E0, 'V'),
-    (0x1D2F4, 'X'),
-    (0x1D300, 'V'),
-    (0x1D357, 'X'),
-    (0x1D360, 'V'),
-    (0x1D379, 'X'),
-    (0x1D400, 'M', 'a'),
-    (0x1D401, 'M', 'b'),
-    (0x1D402, 'M', 'c'),
-    (0x1D403, 'M', 'd'),
-    (0x1D404, 'M', 'e'),
-    (0x1D405, 'M', 'f'),
-    (0x1D406, 'M', 'g'),
-    (0x1D407, 'M', 'h'),
-    (0x1D408, 'M', 'i'),
-    (0x1D409, 'M', 'j'),
-    (0x1D40A, 'M', 'k'),
-    (0x1D40B, 'M', 'l'),
-    (0x1D40C, 'M', 'm'),
-    (0x1D40D, 'M', 'n'),
-    (0x1D40E, 'M', 'o'),
-    (0x1D40F, 'M', 'p'),
-    (0x1D410, 'M', 'q'),
-    (0x1D411, 'M', 'r'),
-    (0x1D412, 'M', 's'),
-    (0x1D413, 'M', 't'),
-    (0x1D414, 'M', 'u'),
-    (0x1D415, 'M', 'v'),
-    (0x1D416, 'M', 'w'),
-    (0x1D417, 'M', 'x'),
-    (0x1D418, 'M', 'y'),
-    (0x1D419, 'M', 'z'),
-    (0x1D41A, 'M', 'a'),
-    (0x1D41B, 'M', 'b'),
-    (0x1D41C, 'M', 'c'),
-    (0x1D41D, 'M', 'd'),
-    (0x1D41E, 'M', 'e'),
-    (0x1D41F, 'M', 'f'),
-    (0x1D420, 'M', 'g'),
-    (0x1D421, 'M', 'h'),
-    (0x1D422, 'M', 'i'),
-    (0x1D423, 'M', 'j'),
-    (0x1D424, 'M', 'k'),
+        (0x1AFFF, "X"),
+        (0x1B000, "V"),
+        (0x1B123, "X"),
+        (0x1B132, "V"),
+        (0x1B133, "X"),
+        (0x1B150, "V"),
+        (0x1B153, "X"),
+        (0x1B155, "V"),
+        (0x1B156, "X"),
+        (0x1B164, "V"),
+        (0x1B168, "X"),
+        (0x1B170, "V"),
+        (0x1B2FC, "X"),
+        (0x1BC00, "V"),
+        (0x1BC6B, "X"),
+        (0x1BC70, "V"),
+        (0x1BC7D, "X"),
+        (0x1BC80, "V"),
+        (0x1BC89, "X"),
+        (0x1BC90, "V"),
+        (0x1BC9A, "X"),
+        (0x1BC9C, "V"),
+        (0x1BCA0, "I"),
+        (0x1BCA4, "X"),
+        (0x1CF00, "V"),
+        (0x1CF2E, "X"),
+        (0x1CF30, "V"),
+        (0x1CF47, "X"),
+        (0x1CF50, "V"),
+        (0x1CFC4, "X"),
+        (0x1D000, "V"),
+        (0x1D0F6, "X"),
+        (0x1D100, "V"),
+        (0x1D127, "X"),
+        (0x1D129, "V"),
+        (0x1D15E, "M", "𝅗𝅥"),
+        (0x1D15F, "M", "𝅘𝅥"),
+        (0x1D160, "M", "𝅘𝅥𝅮"),
+        (0x1D161, "M", "𝅘𝅥𝅯"),
+        (0x1D162, "M", "𝅘𝅥𝅰"),
+        (0x1D163, "M", "𝅘𝅥𝅱"),
+        (0x1D164, "M", "𝅘𝅥𝅲"),
+        (0x1D165, "V"),
+        (0x1D173, "X"),
+        (0x1D17B, "V"),
+        (0x1D1BB, "M", "𝆹𝅥"),
+        (0x1D1BC, "M", "𝆺𝅥"),
+        (0x1D1BD, "M", "𝆹𝅥𝅮"),
+        (0x1D1BE, "M", "𝆺𝅥𝅮"),
+        (0x1D1BF, "M", "𝆹𝅥𝅯"),
+        (0x1D1C0, "M", "𝆺𝅥𝅯"),
+        (0x1D1C1, "V"),
+        (0x1D1EB, "X"),
+        (0x1D200, "V"),
+        (0x1D246, "X"),
+        (0x1D2C0, "V"),
+        (0x1D2D4, "X"),
+        (0x1D2E0, "V"),
+        (0x1D2F4, "X"),
+        (0x1D300, "V"),
+        (0x1D357, "X"),
+        (0x1D360, "V"),
+        (0x1D379, "X"),
+        (0x1D400, "M", "a"),
+        (0x1D401, "M", "b"),
+        (0x1D402, "M", "c"),
+        (0x1D403, "M", "d"),
+        (0x1D404, "M", "e"),
+        (0x1D405, "M", "f"),
+        (0x1D406, "M", "g"),
+        (0x1D407, "M", "h"),
+        (0x1D408, "M", "i"),
+        (0x1D409, "M", "j"),
+        (0x1D40A, "M", "k"),
+        (0x1D40B, "M", "l"),
+        (0x1D40C, "M", "m"),
+        (0x1D40D, "M", "n"),
+        (0x1D40E, "M", "o"),
+        (0x1D40F, "M", "p"),
+        (0x1D410, "M", "q"),
+        (0x1D411, "M", "r"),
+        (0x1D412, "M", "s"),
+        (0x1D413, "M", "t"),
+        (0x1D414, "M", "u"),
+        (0x1D415, "M", "v"),
+        (0x1D416, "M", "w"),
+        (0x1D417, "M", "x"),
+        (0x1D418, "M", "y"),
+        (0x1D419, "M", "z"),
+        (0x1D41A, "M", "a"),
+        (0x1D41B, "M", "b"),
+        (0x1D41C, "M", "c"),
+        (0x1D41D, "M", "d"),
+        (0x1D41E, "M", "e"),
+        (0x1D41F, "M", "f"),
+        (0x1D420, "M", "g"),
+        (0x1D421, "M", "h"),
+        (0x1D422, "M", "i"),
+        (0x1D423, "M", "j"),
+        (0x1D424, "M", "k"),
     ]
 
+
 def _seg_61() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x1D425, 'M', 'l'),
-    (0x1D426, 'M', 'm'),
-    (0x1D427, 'M', 'n'),
-    (0x1D428, 'M', 'o'),
-    (0x1D429, 'M', 'p'),
-    (0x1D42A, 'M', 'q'),
-    (0x1D42B, 'M', 'r'),
-    (0x1D42C, 'M', 's'),
-    (0x1D42D, 'M', 't'),
-    (0x1D42E, 'M', 'u'),
-    (0x1D42F, 'M', 'v'),
-    (0x1D430, 'M', 'w'),
-    (0x1D431, 'M', 'x'),
-    (0x1D432, 'M', 'y'),
-    (0x1D433, 'M', 'z'),
-    (0x1D434, 'M', 'a'),
-    (0x1D435, 'M', 'b'),
-    (0x1D436, 'M', 'c'),
-    (0x1D437, 'M', 'd'),
-    (0x1D438, 'M', 'e'),
-    (0x1D439, 'M', 'f'),
-    (0x1D43A, 'M', 'g'),
-    (0x1D43B, 'M', 'h'),
-    (0x1D43C, 'M', 'i'),
-    (0x1D43D, 'M', 'j'),
-    (0x1D43E, 'M', 'k'),
-    (0x1D43F, 'M', 'l'),
-    (0x1D440, 'M', 'm'),
-    (0x1D441, 'M', 'n'),
-    (0x1D442, 'M', 'o'),
-    (0x1D443, 'M', 'p'),
-    (0x1D444, 'M', 'q'),
-    (0x1D445, 'M', 'r'),
-    (0x1D446, 'M', 's'),
-    (0x1D447, 'M', 't'),
-    (0x1D448, 'M', 'u'),
-    (0x1D449, 'M', 'v'),
-    (0x1D44A, 'M', 'w'),
-    (0x1D44B, 'M', 'x'),
-    (0x1D44C, 'M', 'y'),
-    (0x1D44D, 'M', 'z'),
-    (0x1D44E, 'M', 'a'),
-    (0x1D44F, 'M', 'b'),
-    (0x1D450, 'M', 'c'),
-    (0x1D451, 'M', 'd'),
-    (0x1D452, 'M', 'e'),
-    (0x1D453, 'M', 'f'),
-    (0x1D454, 'M', 'g'),
-    (0x1D455, 'X'),
-    (0x1D456, 'M', 'i'),
-    (0x1D457, 'M', 'j'),
-    (0x1D458, 'M', 'k'),
-    (0x1D459, 'M', 'l'),
-    (0x1D45A, 'M', 'm'),
-    (0x1D45B, 'M', 'n'),
-    (0x1D45C, 'M', 'o'),
-    (0x1D45D, 'M', 'p'),
-    (0x1D45E, 'M', 'q'),
-    (0x1D45F, 'M', 'r'),
-    (0x1D460, 'M', 's'),
-    (0x1D461, 'M', 't'),
-    (0x1D462, 'M', 'u'),
-    (0x1D463, 'M', 'v'),
-    (0x1D464, 'M', 'w'),
-    (0x1D465, 'M', 'x'),
-    (0x1D466, 'M', 'y'),
-    (0x1D467, 'M', 'z'),
-    (0x1D468, 'M', 'a'),
-    (0x1D469, 'M', 'b'),
-    (0x1D46A, 'M', 'c'),
-    (0x1D46B, 'M', 'd'),
-    (0x1D46C, 'M', 'e'),
-    (0x1D46D, 'M', 'f'),
-    (0x1D46E, 'M', 'g'),
-    (0x1D46F, 'M', 'h'),
-    (0x1D470, 'M', 'i'),
-    (0x1D471, 'M', 'j'),
-    (0x1D472, 'M', 'k'),
-    (0x1D473, 'M', 'l'),
-    (0x1D474, 'M', 'm'),
-    (0x1D475, 'M', 'n'),
-    (0x1D476, 'M', 'o'),
-    (0x1D477, 'M', 'p'),
-    (0x1D478, 'M', 'q'),
-    (0x1D479, 'M', 'r'),
-    (0x1D47A, 'M', 's'),
-    (0x1D47B, 'M', 't'),
-    (0x1D47C, 'M', 'u'),
-    (0x1D47D, 'M', 'v'),
-    (0x1D47E, 'M', 'w'),
-    (0x1D47F, 'M', 'x'),
-    (0x1D480, 'M', 'y'),
-    (0x1D481, 'M', 'z'),
-    (0x1D482, 'M', 'a'),
-    (0x1D483, 'M', 'b'),
-    (0x1D484, 'M', 'c'),
-    (0x1D485, 'M', 'd'),
-    (0x1D486, 'M', 'e'),
-    (0x1D487, 'M', 'f'),
-    (0x1D488, 'M', 'g'),
+        (0x1D425, "M", "l"),
+        (0x1D426, "M", "m"),
+        (0x1D427, "M", "n"),
+        (0x1D428, "M", "o"),
+        (0x1D429, "M", "p"),
+        (0x1D42A, "M", "q"),
+        (0x1D42B, "M", "r"),
+        (0x1D42C, "M", "s"),
+        (0x1D42D, "M", "t"),
+        (0x1D42E, "M", "u"),
+        (0x1D42F, "M", "v"),
+        (0x1D430, "M", "w"),
+        (0x1D431, "M", "x"),
+        (0x1D432, "M", "y"),
+        (0x1D433, "M", "z"),
+        (0x1D434, "M", "a"),
+        (0x1D435, "M", "b"),
+        (0x1D436, "M", "c"),
+        (0x1D437, "M", "d"),
+        (0x1D438, "M", "e"),
+        (0x1D439, "M", "f"),
+        (0x1D43A, "M", "g"),
+        (0x1D43B, "M", "h"),
+        (0x1D43C, "M", "i"),
+        (0x1D43D, "M", "j"),
+        (0x1D43E, "M", "k"),
+        (0x1D43F, "M", "l"),
+        (0x1D440, "M", "m"),
+        (0x1D441, "M", "n"),
+        (0x1D442, "M", "o"),
+        (0x1D443, "M", "p"),
+        (0x1D444, "M", "q"),
+        (0x1D445, "M", "r"),
+        (0x1D446, "M", "s"),
+        (0x1D447, "M", "t"),
+        (0x1D448, "M", "u"),
+        (0x1D449, "M", "v"),
+        (0x1D44A, "M", "w"),
+        (0x1D44B, "M", "x"),
+        (0x1D44C, "M", "y"),
+        (0x1D44D, "M", "z"),
+        (0x1D44E, "M", "a"),
+        (0x1D44F, "M", "b"),
+        (0x1D450, "M", "c"),
+        (0x1D451, "M", "d"),
+        (0x1D452, "M", "e"),
+        (0x1D453, "M", "f"),
+        (0x1D454, "M", "g"),
+        (0x1D455, "X"),
+        (0x1D456, "M", "i"),
+        (0x1D457, "M", "j"),
+        (0x1D458, "M", "k"),
+        (0x1D459, "M", "l"),
+        (0x1D45A, "M", "m"),
+        (0x1D45B, "M", "n"),
+        (0x1D45C, "M", "o"),
+        (0x1D45D, "M", "p"),
+        (0x1D45E, "M", "q"),
+        (0x1D45F, "M", "r"),
+        (0x1D460, "M", "s"),
+        (0x1D461, "M", "t"),
+        (0x1D462, "M", "u"),
+        (0x1D463, "M", "v"),
+        (0x1D464, "M", "w"),
+        (0x1D465, "M", "x"),
+        (0x1D466, "M", "y"),
+        (0x1D467, "M", "z"),
+        (0x1D468, "M", "a"),
+        (0x1D469, "M", "b"),
+        (0x1D46A, "M", "c"),
+        (0x1D46B, "M", "d"),
+        (0x1D46C, "M", "e"),
+        (0x1D46D, "M", "f"),
+        (0x1D46E, "M", "g"),
+        (0x1D46F, "M", "h"),
+        (0x1D470, "M", "i"),
+        (0x1D471, "M", "j"),
+        (0x1D472, "M", "k"),
+        (0x1D473, "M", "l"),
+        (0x1D474, "M", "m"),
+        (0x1D475, "M", "n"),
+        (0x1D476, "M", "o"),
+        (0x1D477, "M", "p"),
+        (0x1D478, "M", "q"),
+        (0x1D479, "M", "r"),
+        (0x1D47A, "M", "s"),
+        (0x1D47B, "M", "t"),
+        (0x1D47C, "M", "u"),
+        (0x1D47D, "M", "v"),
+        (0x1D47E, "M", "w"),
+        (0x1D47F, "M", "x"),
+        (0x1D480, "M", "y"),
+        (0x1D481, "M", "z"),
+        (0x1D482, "M", "a"),
+        (0x1D483, "M", "b"),
+        (0x1D484, "M", "c"),
+        (0x1D485, "M", "d"),
+        (0x1D486, "M", "e"),
+        (0x1D487, "M", "f"),
+        (0x1D488, "M", "g"),
     ]
 
+
 def _seg_62() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x1D489, 'M', 'h'),
-    (0x1D48A, 'M', 'i'),
-    (0x1D48B, 'M', 'j'),
-    (0x1D48C, 'M', 'k'),
-    (0x1D48D, 'M', 'l'),
-    (0x1D48E, 'M', 'm'),
-    (0x1D48F, 'M', 'n'),
-    (0x1D490, 'M', 'o'),
-    (0x1D491, 'M', 'p'),
-    (0x1D492, 'M', 'q'),
-    (0x1D493, 'M', 'r'),
-    (0x1D494, 'M', 's'),
-    (0x1D495, 'M', 't'),
-    (0x1D496, 'M', 'u'),
-    (0x1D497, 'M', 'v'),
-    (0x1D498, 'M', 'w'),
-    (0x1D499, 'M', 'x'),
-    (0x1D49A, 'M', 'y'),
-    (0x1D49B, 'M', 'z'),
-    (0x1D49C, 'M', 'a'),
-    (0x1D49D, 'X'),
-    (0x1D49E, 'M', 'c'),
-    (0x1D49F, 'M', 'd'),
-    (0x1D4A0, 'X'),
-    (0x1D4A2, 'M', 'g'),
-    (0x1D4A3, 'X'),
-    (0x1D4A5, 'M', 'j'),
-    (0x1D4A6, 'M', 'k'),
-    (0x1D4A7, 'X'),
-    (0x1D4A9, 'M', 'n'),
-    (0x1D4AA, 'M', 'o'),
-    (0x1D4AB, 'M', 'p'),
-    (0x1D4AC, 'M', 'q'),
-    (0x1D4AD, 'X'),
-    (0x1D4AE, 'M', 's'),
-    (0x1D4AF, 'M', 't'),
-    (0x1D4B0, 'M', 'u'),
-    (0x1D4B1, 'M', 'v'),
-    (0x1D4B2, 'M', 'w'),
-    (0x1D4B3, 'M', 'x'),
-    (0x1D4B4, 'M', 'y'),
-    (0x1D4B5, 'M', 'z'),
-    (0x1D4B6, 'M', 'a'),
-    (0x1D4B7, 'M', 'b'),
-    (0x1D4B8, 'M', 'c'),
-    (0x1D4B9, 'M', 'd'),
-    (0x1D4BA, 'X'),
-    (0x1D4BB, 'M', 'f'),
-    (0x1D4BC, 'X'),
-    (0x1D4BD, 'M', 'h'),
-    (0x1D4BE, 'M', 'i'),
-    (0x1D4BF, 'M', 'j'),
-    (0x1D4C0, 'M', 'k'),
-    (0x1D4C1, 'M', 'l'),
-    (0x1D4C2, 'M', 'm'),
-    (0x1D4C3, 'M', 'n'),
-    (0x1D4C4, 'X'),
-    (0x1D4C5, 'M', 'p'),
-    (0x1D4C6, 'M', 'q'),
-    (0x1D4C7, 'M', 'r'),
-    (0x1D4C8, 'M', 's'),
-    (0x1D4C9, 'M', 't'),
-    (0x1D4CA, 'M', 'u'),
-    (0x1D4CB, 'M', 'v'),
-    (0x1D4CC, 'M', 'w'),
-    (0x1D4CD, 'M', 'x'),
-    (0x1D4CE, 'M', 'y'),
-    (0x1D4CF, 'M', 'z'),
-    (0x1D4D0, 'M', 'a'),
-    (0x1D4D1, 'M', 'b'),
-    (0x1D4D2, 'M', 'c'),
-    (0x1D4D3, 'M', 'd'),
-    (0x1D4D4, 'M', 'e'),
-    (0x1D4D5, 'M', 'f'),
-    (0x1D4D6, 'M', 'g'),
-    (0x1D4D7, 'M', 'h'),
-    (0x1D4D8, 'M', 'i'),
-    (0x1D4D9, 'M', 'j'),
-    (0x1D4DA, 'M', 'k'),
-    (0x1D4DB, 'M', 'l'),
-    (0x1D4DC, 'M', 'm'),
-    (0x1D4DD, 'M', 'n'),
-    (0x1D4DE, 'M', 'o'),
-    (0x1D4DF, 'M', 'p'),
-    (0x1D4E0, 'M', 'q'),
-    (0x1D4E1, 'M', 'r'),
-    (0x1D4E2, 'M', 's'),
-    (0x1D4E3, 'M', 't'),
-    (0x1D4E4, 'M', 'u'),
-    (0x1D4E5, 'M', 'v'),
-    (0x1D4E6, 'M', 'w'),
-    (0x1D4E7, 'M', 'x'),
-    (0x1D4E8, 'M', 'y'),
-    (0x1D4E9, 'M', 'z'),
-    (0x1D4EA, 'M', 'a'),
-    (0x1D4EB, 'M', 'b'),
-    (0x1D4EC, 'M', 'c'),
-    (0x1D4ED, 'M', 'd'),
-    (0x1D4EE, 'M', 'e'),
-    (0x1D4EF, 'M', 'f'),
+        (0x1D489, "M", "h"),
+        (0x1D48A, "M", "i"),
+        (0x1D48B, "M", "j"),
+        (0x1D48C, "M", "k"),
+        (0x1D48D, "M", "l"),
+        (0x1D48E, "M", "m"),
+        (0x1D48F, "M", "n"),
+        (0x1D490, "M", "o"),
+        (0x1D491, "M", "p"),
+        (0x1D492, "M", "q"),
+        (0x1D493, "M", "r"),
+        (0x1D494, "M", "s"),
+        (0x1D495, "M", "t"),
+        (0x1D496, "M", "u"),
+        (0x1D497, "M", "v"),
+        (0x1D498, "M", "w"),
+        (0x1D499, "M", "x"),
+        (0x1D49A, "M", "y"),
+        (0x1D49B, "M", "z"),
+        (0x1D49C, "M", "a"),
+        (0x1D49D, "X"),
+        (0x1D49E, "M", "c"),
+        (0x1D49F, "M", "d"),
+        (0x1D4A0, "X"),
+        (0x1D4A2, "M", "g"),
+        (0x1D4A3, "X"),
+        (0x1D4A5, "M", "j"),
+        (0x1D4A6, "M", "k"),
+        (0x1D4A7, "X"),
+        (0x1D4A9, "M", "n"),
+        (0x1D4AA, "M", "o"),
+        (0x1D4AB, "M", "p"),
+        (0x1D4AC, "M", "q"),
+        (0x1D4AD, "X"),
+        (0x1D4AE, "M", "s"),
+        (0x1D4AF, "M", "t"),
+        (0x1D4B0, "M", "u"),
+        (0x1D4B1, "M", "v"),
+        (0x1D4B2, "M", "w"),
+        (0x1D4B3, "M", "x"),
+        (0x1D4B4, "M", "y"),
+        (0x1D4B5, "M", "z"),
+        (0x1D4B6, "M", "a"),
+        (0x1D4B7, "M", "b"),
+        (0x1D4B8, "M", "c"),
+        (0x1D4B9, "M", "d"),
+        (0x1D4BA, "X"),
+        (0x1D4BB, "M", "f"),
+        (0x1D4BC, "X"),
+        (0x1D4BD, "M", "h"),
+        (0x1D4BE, "M", "i"),
+        (0x1D4BF, "M", "j"),
+        (0x1D4C0, "M", "k"),
+        (0x1D4C1, "M", "l"),
+        (0x1D4C2, "M", "m"),
+        (0x1D4C3, "M", "n"),
+        (0x1D4C4, "X"),
+        (0x1D4C5, "M", "p"),
+        (0x1D4C6, "M", "q"),
+        (0x1D4C7, "M", "r"),
+        (0x1D4C8, "M", "s"),
+        (0x1D4C9, "M", "t"),
+        (0x1D4CA, "M", "u"),
+        (0x1D4CB, "M", "v"),
+        (0x1D4CC, "M", "w"),
+        (0x1D4CD, "M", "x"),
+        (0x1D4CE, "M", "y"),
+        (0x1D4CF, "M", "z"),
+        (0x1D4D0, "M", "a"),
+        (0x1D4D1, "M", "b"),
+        (0x1D4D2, "M", "c"),
+        (0x1D4D3, "M", "d"),
+        (0x1D4D4, "M", "e"),
+        (0x1D4D5, "M", "f"),
+        (0x1D4D6, "M", "g"),
+        (0x1D4D7, "M", "h"),
+        (0x1D4D8, "M", "i"),
+        (0x1D4D9, "M", "j"),
+        (0x1D4DA, "M", "k"),
+        (0x1D4DB, "M", "l"),
+        (0x1D4DC, "M", "m"),
+        (0x1D4DD, "M", "n"),
+        (0x1D4DE, "M", "o"),
+        (0x1D4DF, "M", "p"),
+        (0x1D4E0, "M", "q"),
+        (0x1D4E1, "M", "r"),
+        (0x1D4E2, "M", "s"),
+        (0x1D4E3, "M", "t"),
+        (0x1D4E4, "M", "u"),
+        (0x1D4E5, "M", "v"),
+        (0x1D4E6, "M", "w"),
+        (0x1D4E7, "M", "x"),
+        (0x1D4E8, "M", "y"),
+        (0x1D4E9, "M", "z"),
+        (0x1D4EA, "M", "a"),
+        (0x1D4EB, "M", "b"),
+        (0x1D4EC, "M", "c"),
+        (0x1D4ED, "M", "d"),
+        (0x1D4EE, "M", "e"),
+        (0x1D4EF, "M", "f"),
     ]
 
+
 def _seg_63() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x1D4F0, 'M', 'g'),
-    (0x1D4F1, 'M', 'h'),
-    (0x1D4F2, 'M', 'i'),
-    (0x1D4F3, 'M', 'j'),
-    (0x1D4F4, 'M', 'k'),
-    (0x1D4F5, 'M', 'l'),
-    (0x1D4F6, 'M', 'm'),
-    (0x1D4F7, 'M', 'n'),
-    (0x1D4F8, 'M', 'o'),
-    (0x1D4F9, 'M', 'p'),
-    (0x1D4FA, 'M', 'q'),
-    (0x1D4FB, 'M', 'r'),
-    (0x1D4FC, 'M', 's'),
-    (0x1D4FD, 'M', 't'),
-    (0x1D4FE, 'M', 'u'),
-    (0x1D4FF, 'M', 'v'),
-    (0x1D500, 'M', 'w'),
-    (0x1D501, 'M', 'x'),
-    (0x1D502, 'M', 'y'),
-    (0x1D503, 'M', 'z'),
-    (0x1D504, 'M', 'a'),
-    (0x1D505, 'M', 'b'),
-    (0x1D506, 'X'),
-    (0x1D507, 'M', 'd'),
-    (0x1D508, 'M', 'e'),
-    (0x1D509, 'M', 'f'),
-    (0x1D50A, 'M', 'g'),
-    (0x1D50B, 'X'),
-    (0x1D50D, 'M', 'j'),
-    (0x1D50E, 'M', 'k'),
-    (0x1D50F, 'M', 'l'),
-    (0x1D510, 'M', 'm'),
-    (0x1D511, 'M', 'n'),
-    (0x1D512, 'M', 'o'),
-    (0x1D513, 'M', 'p'),
-    (0x1D514, 'M', 'q'),
-    (0x1D515, 'X'),
-    (0x1D516, 'M', 's'),
-    (0x1D517, 'M', 't'),
-    (0x1D518, 'M', 'u'),
-    (0x1D519, 'M', 'v'),
-    (0x1D51A, 'M', 'w'),
-    (0x1D51B, 'M', 'x'),
-    (0x1D51C, 'M', 'y'),
-    (0x1D51D, 'X'),
-    (0x1D51E, 'M', 'a'),
-    (0x1D51F, 'M', 'b'),
-    (0x1D520, 'M', 'c'),
-    (0x1D521, 'M', 'd'),
-    (0x1D522, 'M', 'e'),
-    (0x1D523, 'M', 'f'),
-    (0x1D524, 'M', 'g'),
-    (0x1D525, 'M', 'h'),
-    (0x1D526, 'M', 'i'),
-    (0x1D527, 'M', 'j'),
-    (0x1D528, 'M', 'k'),
-    (0x1D529, 'M', 'l'),
-    (0x1D52A, 'M', 'm'),
-    (0x1D52B, 'M', 'n'),
-    (0x1D52C, 'M', 'o'),
-    (0x1D52D, 'M', 'p'),
-    (0x1D52E, 'M', 'q'),
-    (0x1D52F, 'M', 'r'),
-    (0x1D530, 'M', 's'),
-    (0x1D531, 'M', 't'),
-    (0x1D532, 'M', 'u'),
-    (0x1D533, 'M', 'v'),
-    (0x1D534, 'M', 'w'),
-    (0x1D535, 'M', 'x'),
-    (0x1D536, 'M', 'y'),
-    (0x1D537, 'M', 'z'),
-    (0x1D538, 'M', 'a'),
-    (0x1D539, 'M', 'b'),
-    (0x1D53A, 'X'),
-    (0x1D53B, 'M', 'd'),
-    (0x1D53C, 'M', 'e'),
-    (0x1D53D, 'M', 'f'),
-    (0x1D53E, 'M', 'g'),
-    (0x1D53F, 'X'),
-    (0x1D540, 'M', 'i'),
-    (0x1D541, 'M', 'j'),
-    (0x1D542, 'M', 'k'),
-    (0x1D543, 'M', 'l'),
-    (0x1D544, 'M', 'm'),
-    (0x1D545, 'X'),
-    (0x1D546, 'M', 'o'),
-    (0x1D547, 'X'),
-    (0x1D54A, 'M', 's'),
-    (0x1D54B, 'M', 't'),
-    (0x1D54C, 'M', 'u'),
-    (0x1D54D, 'M', 'v'),
-    (0x1D54E, 'M', 'w'),
-    (0x1D54F, 'M', 'x'),
-    (0x1D550, 'M', 'y'),
-    (0x1D551, 'X'),
-    (0x1D552, 'M', 'a'),
-    (0x1D553, 'M', 'b'),
-    (0x1D554, 'M', 'c'),
-    (0x1D555, 'M', 'd'),
-    (0x1D556, 'M', 'e'),
+        (0x1D4F0, "M", "g"),
+        (0x1D4F1, "M", "h"),
+        (0x1D4F2, "M", "i"),
+        (0x1D4F3, "M", "j"),
+        (0x1D4F4, "M", "k"),
+        (0x1D4F5, "M", "l"),
+        (0x1D4F6, "M", "m"),
+        (0x1D4F7, "M", "n"),
+        (0x1D4F8, "M", "o"),
+        (0x1D4F9, "M", "p"),
+        (0x1D4FA, "M", "q"),
+        (0x1D4FB, "M", "r"),
+        (0x1D4FC, "M", "s"),
+        (0x1D4FD, "M", "t"),
+        (0x1D4FE, "M", "u"),
+        (0x1D4FF, "M", "v"),
+        (0x1D500, "M", "w"),
+        (0x1D501, "M", "x"),
+        (0x1D502, "M", "y"),
+        (0x1D503, "M", "z"),
+        (0x1D504, "M", "a"),
+        (0x1D505, "M", "b"),
+        (0x1D506, "X"),
+        (0x1D507, "M", "d"),
+        (0x1D508, "M", "e"),
+        (0x1D509, "M", "f"),
+        (0x1D50A, "M", "g"),
+        (0x1D50B, "X"),
+        (0x1D50D, "M", "j"),
+        (0x1D50E, "M", "k"),
+        (0x1D50F, "M", "l"),
+        (0x1D510, "M", "m"),
+        (0x1D511, "M", "n"),
+        (0x1D512, "M", "o"),
+        (0x1D513, "M", "p"),
+        (0x1D514, "M", "q"),
+        (0x1D515, "X"),
+        (0x1D516, "M", "s"),
+        (0x1D517, "M", "t"),
+        (0x1D518, "M", "u"),
+        (0x1D519, "M", "v"),
+        (0x1D51A, "M", "w"),
+        (0x1D51B, "M", "x"),
+        (0x1D51C, "M", "y"),
+        (0x1D51D, "X"),
+        (0x1D51E, "M", "a"),
+        (0x1D51F, "M", "b"),
+        (0x1D520, "M", "c"),
+        (0x1D521, "M", "d"),
+        (0x1D522, "M", "e"),
+        (0x1D523, "M", "f"),
+        (0x1D524, "M", "g"),
+        (0x1D525, "M", "h"),
+        (0x1D526, "M", "i"),
+        (0x1D527, "M", "j"),
+        (0x1D528, "M", "k"),
+        (0x1D529, "M", "l"),
+        (0x1D52A, "M", "m"),
+        (0x1D52B, "M", "n"),
+        (0x1D52C, "M", "o"),
+        (0x1D52D, "M", "p"),
+        (0x1D52E, "M", "q"),
+        (0x1D52F, "M", "r"),
+        (0x1D530, "M", "s"),
+        (0x1D531, "M", "t"),
+        (0x1D532, "M", "u"),
+        (0x1D533, "M", "v"),
+        (0x1D534, "M", "w"),
+        (0x1D535, "M", "x"),
+        (0x1D536, "M", "y"),
+        (0x1D537, "M", "z"),
+        (0x1D538, "M", "a"),
+        (0x1D539, "M", "b"),
+        (0x1D53A, "X"),
+        (0x1D53B, "M", "d"),
+        (0x1D53C, "M", "e"),
+        (0x1D53D, "M", "f"),
+        (0x1D53E, "M", "g"),
+        (0x1D53F, "X"),
+        (0x1D540, "M", "i"),
+        (0x1D541, "M", "j"),
+        (0x1D542, "M", "k"),
+        (0x1D543, "M", "l"),
+        (0x1D544, "M", "m"),
+        (0x1D545, "X"),
+        (0x1D546, "M", "o"),
+        (0x1D547, "X"),
+        (0x1D54A, "M", "s"),
+        (0x1D54B, "M", "t"),
+        (0x1D54C, "M", "u"),
+        (0x1D54D, "M", "v"),
+        (0x1D54E, "M", "w"),
+        (0x1D54F, "M", "x"),
+        (0x1D550, "M", "y"),
+        (0x1D551, "X"),
+        (0x1D552, "M", "a"),
+        (0x1D553, "M", "b"),
+        (0x1D554, "M", "c"),
+        (0x1D555, "M", "d"),
+        (0x1D556, "M", "e"),
     ]
 
+
 def _seg_64() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x1D557, 'M', 'f'),
-    (0x1D558, 'M', 'g'),
-    (0x1D559, 'M', 'h'),
-    (0x1D55A, 'M', 'i'),
-    (0x1D55B, 'M', 'j'),
-    (0x1D55C, 'M', 'k'),
-    (0x1D55D, 'M', 'l'),
-    (0x1D55E, 'M', 'm'),
-    (0x1D55F, 'M', 'n'),
-    (0x1D560, 'M', 'o'),
-    (0x1D561, 'M', 'p'),
-    (0x1D562, 'M', 'q'),
-    (0x1D563, 'M', 'r'),
-    (0x1D564, 'M', 's'),
-    (0x1D565, 'M', 't'),
-    (0x1D566, 'M', 'u'),
-    (0x1D567, 'M', 'v'),
-    (0x1D568, 'M', 'w'),
-    (0x1D569, 'M', 'x'),
-    (0x1D56A, 'M', 'y'),
-    (0x1D56B, 'M', 'z'),
-    (0x1D56C, 'M', 'a'),
-    (0x1D56D, 'M', 'b'),
-    (0x1D56E, 'M', 'c'),
-    (0x1D56F, 'M', 'd'),
-    (0x1D570, 'M', 'e'),
-    (0x1D571, 'M', 'f'),
-    (0x1D572, 'M', 'g'),
-    (0x1D573, 'M', 'h'),
-    (0x1D574, 'M', 'i'),
-    (0x1D575, 'M', 'j'),
-    (0x1D576, 'M', 'k'),
-    (0x1D577, 'M', 'l'),
-    (0x1D578, 'M', 'm'),
-    (0x1D579, 'M', 'n'),
-    (0x1D57A, 'M', 'o'),
-    (0x1D57B, 'M', 'p'),
-    (0x1D57C, 'M', 'q'),
-    (0x1D57D, 'M', 'r'),
-    (0x1D57E, 'M', 's'),
-    (0x1D57F, 'M', 't'),
-    (0x1D580, 'M', 'u'),
-    (0x1D581, 'M', 'v'),
-    (0x1D582, 'M', 'w'),
-    (0x1D583, 'M', 'x'),
-    (0x1D584, 'M', 'y'),
-    (0x1D585, 'M', 'z'),
-    (0x1D586, 'M', 'a'),
-    (0x1D587, 'M', 'b'),
-    (0x1D588, 'M', 'c'),
-    (0x1D589, 'M', 'd'),
-    (0x1D58A, 'M', 'e'),
-    (0x1D58B, 'M', 'f'),
-    (0x1D58C, 'M', 'g'),
-    (0x1D58D, 'M', 'h'),
-    (0x1D58E, 'M', 'i'),
-    (0x1D58F, 'M', 'j'),
-    (0x1D590, 'M', 'k'),
-    (0x1D591, 'M', 'l'),
-    (0x1D592, 'M', 'm'),
-    (0x1D593, 'M', 'n'),
-    (0x1D594, 'M', 'o'),
-    (0x1D595, 'M', 'p'),
-    (0x1D596, 'M', 'q'),
-    (0x1D597, 'M', 'r'),
-    (0x1D598, 'M', 's'),
-    (0x1D599, 'M', 't'),
-    (0x1D59A, 'M', 'u'),
-    (0x1D59B, 'M', 'v'),
-    (0x1D59C, 'M', 'w'),
-    (0x1D59D, 'M', 'x'),
-    (0x1D59E, 'M', 'y'),
-    (0x1D59F, 'M', 'z'),
-    (0x1D5A0, 'M', 'a'),
-    (0x1D5A1, 'M', 'b'),
-    (0x1D5A2, 'M', 'c'),
-    (0x1D5A3, 'M', 'd'),
-    (0x1D5A4, 'M', 'e'),
-    (0x1D5A5, 'M', 'f'),
-    (0x1D5A6, 'M', 'g'),
-    (0x1D5A7, 'M', 'h'),
-    (0x1D5A8, 'M', 'i'),
-    (0x1D5A9, 'M', 'j'),
-    (0x1D5AA, 'M', 'k'),
-    (0x1D5AB, 'M', 'l'),
-    (0x1D5AC, 'M', 'm'),
-    (0x1D5AD, 'M', 'n'),
-    (0x1D5AE, 'M', 'o'),
-    (0x1D5AF, 'M', 'p'),
-    (0x1D5B0, 'M', 'q'),
-    (0x1D5B1, 'M', 'r'),
-    (0x1D5B2, 'M', 's'),
-    (0x1D5B3, 'M', 't'),
-    (0x1D5B4, 'M', 'u'),
-    (0x1D5B5, 'M', 'v'),
-    (0x1D5B6, 'M', 'w'),
-    (0x1D5B7, 'M', 'x'),
-    (0x1D5B8, 'M', 'y'),
-    (0x1D5B9, 'M', 'z'),
-    (0x1D5BA, 'M', 'a'),
+        (0x1D557, "M", "f"),
+        (0x1D558, "M", "g"),
+        (0x1D559, "M", "h"),
+        (0x1D55A, "M", "i"),
+        (0x1D55B, "M", "j"),
+        (0x1D55C, "M", "k"),
+        (0x1D55D, "M", "l"),
+        (0x1D55E, "M", "m"),
+        (0x1D55F, "M", "n"),
+        (0x1D560, "M", "o"),
+        (0x1D561, "M", "p"),
+        (0x1D562, "M", "q"),
+        (0x1D563, "M", "r"),
+        (0x1D564, "M", "s"),
+        (0x1D565, "M", "t"),
+        (0x1D566, "M", "u"),
+        (0x1D567, "M", "v"),
+        (0x1D568, "M", "w"),
+        (0x1D569, "M", "x"),
+        (0x1D56A, "M", "y"),
+        (0x1D56B, "M", "z"),
+        (0x1D56C, "M", "a"),
+        (0x1D56D, "M", "b"),
+        (0x1D56E, "M", "c"),
+        (0x1D56F, "M", "d"),
+        (0x1D570, "M", "e"),
+        (0x1D571, "M", "f"),
+        (0x1D572, "M", "g"),
+        (0x1D573, "M", "h"),
+        (0x1D574, "M", "i"),
+        (0x1D575, "M", "j"),
+        (0x1D576, "M", "k"),
+        (0x1D577, "M", "l"),
+        (0x1D578, "M", "m"),
+        (0x1D579, "M", "n"),
+        (0x1D57A, "M", "o"),
+        (0x1D57B, "M", "p"),
+        (0x1D57C, "M", "q"),
+        (0x1D57D, "M", "r"),
+        (0x1D57E, "M", "s"),
+        (0x1D57F, "M", "t"),
+        (0x1D580, "M", "u"),
+        (0x1D581, "M", "v"),
+        (0x1D582, "M", "w"),
+        (0x1D583, "M", "x"),
+        (0x1D584, "M", "y"),
+        (0x1D585, "M", "z"),
+        (0x1D586, "M", "a"),
+        (0x1D587, "M", "b"),
+        (0x1D588, "M", "c"),
+        (0x1D589, "M", "d"),
+        (0x1D58A, "M", "e"),
+        (0x1D58B, "M", "f"),
+        (0x1D58C, "M", "g"),
+        (0x1D58D, "M", "h"),
+        (0x1D58E, "M", "i"),
+        (0x1D58F, "M", "j"),
+        (0x1D590, "M", "k"),
+        (0x1D591, "M", "l"),
+        (0x1D592, "M", "m"),
+        (0x1D593, "M", "n"),
+        (0x1D594, "M", "o"),
+        (0x1D595, "M", "p"),
+        (0x1D596, "M", "q"),
+        (0x1D597, "M", "r"),
+        (0x1D598, "M", "s"),
+        (0x1D599, "M", "t"),
+        (0x1D59A, "M", "u"),
+        (0x1D59B, "M", "v"),
+        (0x1D59C, "M", "w"),
+        (0x1D59D, "M", "x"),
+        (0x1D59E, "M", "y"),
+        (0x1D59F, "M", "z"),
+        (0x1D5A0, "M", "a"),
+        (0x1D5A1, "M", "b"),
+        (0x1D5A2, "M", "c"),
+        (0x1D5A3, "M", "d"),
+        (0x1D5A4, "M", "e"),
+        (0x1D5A5, "M", "f"),
+        (0x1D5A6, "M", "g"),
+        (0x1D5A7, "M", "h"),
+        (0x1D5A8, "M", "i"),
+        (0x1D5A9, "M", "j"),
+        (0x1D5AA, "M", "k"),
+        (0x1D5AB, "M", "l"),
+        (0x1D5AC, "M", "m"),
+        (0x1D5AD, "M", "n"),
+        (0x1D5AE, "M", "o"),
+        (0x1D5AF, "M", "p"),
+        (0x1D5B0, "M", "q"),
+        (0x1D5B1, "M", "r"),
+        (0x1D5B2, "M", "s"),
+        (0x1D5B3, "M", "t"),
+        (0x1D5B4, "M", "u"),
+        (0x1D5B5, "M", "v"),
+        (0x1D5B6, "M", "w"),
+        (0x1D5B7, "M", "x"),
+        (0x1D5B8, "M", "y"),
+        (0x1D5B9, "M", "z"),
+        (0x1D5BA, "M", "a"),
     ]
 
+
 def _seg_65() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x1D5BB, 'M', 'b'),
-    (0x1D5BC, 'M', 'c'),
-    (0x1D5BD, 'M', 'd'),
-    (0x1D5BE, 'M', 'e'),
-    (0x1D5BF, 'M', 'f'),
-    (0x1D5C0, 'M', 'g'),
-    (0x1D5C1, 'M', 'h'),
-    (0x1D5C2, 'M', 'i'),
-    (0x1D5C3, 'M', 'j'),
-    (0x1D5C4, 'M', 'k'),
-    (0x1D5C5, 'M', 'l'),
-    (0x1D5C6, 'M', 'm'),
-    (0x1D5C7, 'M', 'n'),
-    (0x1D5C8, 'M', 'o'),
-    (0x1D5C9, 'M', 'p'),
-    (0x1D5CA, 'M', 'q'),
-    (0x1D5CB, 'M', 'r'),
-    (0x1D5CC, 'M', 's'),
-    (0x1D5CD, 'M', 't'),
-    (0x1D5CE, 'M', 'u'),
-    (0x1D5CF, 'M', 'v'),
-    (0x1D5D0, 'M', 'w'),
-    (0x1D5D1, 'M', 'x'),
-    (0x1D5D2, 'M', 'y'),
-    (0x1D5D3, 'M', 'z'),
-    (0x1D5D4, 'M', 'a'),
-    (0x1D5D5, 'M', 'b'),
-    (0x1D5D6, 'M', 'c'),
-    (0x1D5D7, 'M', 'd'),
-    (0x1D5D8, 'M', 'e'),
-    (0x1D5D9, 'M', 'f'),
-    (0x1D5DA, 'M', 'g'),
-    (0x1D5DB, 'M', 'h'),
-    (0x1D5DC, 'M', 'i'),
-    (0x1D5DD, 'M', 'j'),
-    (0x1D5DE, 'M', 'k'),
-    (0x1D5DF, 'M', 'l'),
-    (0x1D5E0, 'M', 'm'),
-    (0x1D5E1, 'M', 'n'),
-    (0x1D5E2, 'M', 'o'),
-    (0x1D5E3, 'M', 'p'),
-    (0x1D5E4, 'M', 'q'),
-    (0x1D5E5, 'M', 'r'),
-    (0x1D5E6, 'M', 's'),
-    (0x1D5E7, 'M', 't'),
-    (0x1D5E8, 'M', 'u'),
-    (0x1D5E9, 'M', 'v'),
-    (0x1D5EA, 'M', 'w'),
-    (0x1D5EB, 'M', 'x'),
-    (0x1D5EC, 'M', 'y'),
-    (0x1D5ED, 'M', 'z'),
-    (0x1D5EE, 'M', 'a'),
-    (0x1D5EF, 'M', 'b'),
-    (0x1D5F0, 'M', 'c'),
-    (0x1D5F1, 'M', 'd'),
-    (0x1D5F2, 'M', 'e'),
-    (0x1D5F3, 'M', 'f'),
-    (0x1D5F4, 'M', 'g'),
-    (0x1D5F5, 'M', 'h'),
-    (0x1D5F6, 'M', 'i'),
-    (0x1D5F7, 'M', 'j'),
-    (0x1D5F8, 'M', 'k'),
-    (0x1D5F9, 'M', 'l'),
-    (0x1D5FA, 'M', 'm'),
-    (0x1D5FB, 'M', 'n'),
-    (0x1D5FC, 'M', 'o'),
-    (0x1D5FD, 'M', 'p'),
-    (0x1D5FE, 'M', 'q'),
-    (0x1D5FF, 'M', 'r'),
-    (0x1D600, 'M', 's'),
-    (0x1D601, 'M', 't'),
-    (0x1D602, 'M', 'u'),
-    (0x1D603, 'M', 'v'),
-    (0x1D604, 'M', 'w'),
-    (0x1D605, 'M', 'x'),
-    (0x1D606, 'M', 'y'),
-    (0x1D607, 'M', 'z'),
-    (0x1D608, 'M', 'a'),
-    (0x1D609, 'M', 'b'),
-    (0x1D60A, 'M', 'c'),
-    (0x1D60B, 'M', 'd'),
-    (0x1D60C, 'M', 'e'),
-    (0x1D60D, 'M', 'f'),
-    (0x1D60E, 'M', 'g'),
-    (0x1D60F, 'M', 'h'),
-    (0x1D610, 'M', 'i'),
-    (0x1D611, 'M', 'j'),
-    (0x1D612, 'M', 'k'),
-    (0x1D613, 'M', 'l'),
-    (0x1D614, 'M', 'm'),
-    (0x1D615, 'M', 'n'),
-    (0x1D616, 'M', 'o'),
-    (0x1D617, 'M', 'p'),
-    (0x1D618, 'M', 'q'),
-    (0x1D619, 'M', 'r'),
-    (0x1D61A, 'M', 's'),
-    (0x1D61B, 'M', 't'),
-    (0x1D61C, 'M', 'u'),
-    (0x1D61D, 'M', 'v'),
-    (0x1D61E, 'M', 'w'),
+        (0x1D5BB, "M", "b"),
+        (0x1D5BC, "M", "c"),
+        (0x1D5BD, "M", "d"),
+        (0x1D5BE, "M", "e"),
+        (0x1D5BF, "M", "f"),
+        (0x1D5C0, "M", "g"),
+        (0x1D5C1, "M", "h"),
+        (0x1D5C2, "M", "i"),
+        (0x1D5C3, "M", "j"),
+        (0x1D5C4, "M", "k"),
+        (0x1D5C5, "M", "l"),
+        (0x1D5C6, "M", "m"),
+        (0x1D5C7, "M", "n"),
+        (0x1D5C8, "M", "o"),
+        (0x1D5C9, "M", "p"),
+        (0x1D5CA, "M", "q"),
+        (0x1D5CB, "M", "r"),
+        (0x1D5CC, "M", "s"),
+        (0x1D5CD, "M", "t"),
+        (0x1D5CE, "M", "u"),
+        (0x1D5CF, "M", "v"),
+        (0x1D5D0, "M", "w"),
+        (0x1D5D1, "M", "x"),
+        (0x1D5D2, "M", "y"),
+        (0x1D5D3, "M", "z"),
+        (0x1D5D4, "M", "a"),
+        (0x1D5D5, "M", "b"),
+        (0x1D5D6, "M", "c"),
+        (0x1D5D7, "M", "d"),
+        (0x1D5D8, "M", "e"),
+        (0x1D5D9, "M", "f"),
+        (0x1D5DA, "M", "g"),
+        (0x1D5DB, "M", "h"),
+        (0x1D5DC, "M", "i"),
+        (0x1D5DD, "M", "j"),
+        (0x1D5DE, "M", "k"),
+        (0x1D5DF, "M", "l"),
+        (0x1D5E0, "M", "m"),
+        (0x1D5E1, "M", "n"),
+        (0x1D5E2, "M", "o"),
+        (0x1D5E3, "M", "p"),
+        (0x1D5E4, "M", "q"),
+        (0x1D5E5, "M", "r"),
+        (0x1D5E6, "M", "s"),
+        (0x1D5E7, "M", "t"),
+        (0x1D5E8, "M", "u"),
+        (0x1D5E9, "M", "v"),
+        (0x1D5EA, "M", "w"),
+        (0x1D5EB, "M", "x"),
+        (0x1D5EC, "M", "y"),
+        (0x1D5ED, "M", "z"),
+        (0x1D5EE, "M", "a"),
+        (0x1D5EF, "M", "b"),
+        (0x1D5F0, "M", "c"),
+        (0x1D5F1, "M", "d"),
+        (0x1D5F2, "M", "e"),
+        (0x1D5F3, "M", "f"),
+        (0x1D5F4, "M", "g"),
+        (0x1D5F5, "M", "h"),
+        (0x1D5F6, "M", "i"),
+        (0x1D5F7, "M", "j"),
+        (0x1D5F8, "M", "k"),
+        (0x1D5F9, "M", "l"),
+        (0x1D5FA, "M", "m"),
+        (0x1D5FB, "M", "n"),
+        (0x1D5FC, "M", "o"),
+        (0x1D5FD, "M", "p"),
+        (0x1D5FE, "M", "q"),
+        (0x1D5FF, "M", "r"),
+        (0x1D600, "M", "s"),
+        (0x1D601, "M", "t"),
+        (0x1D602, "M", "u"),
+        (0x1D603, "M", "v"),
+        (0x1D604, "M", "w"),
+        (0x1D605, "M", "x"),
+        (0x1D606, "M", "y"),
+        (0x1D607, "M", "z"),
+        (0x1D608, "M", "a"),
+        (0x1D609, "M", "b"),
+        (0x1D60A, "M", "c"),
+        (0x1D60B, "M", "d"),
+        (0x1D60C, "M", "e"),
+        (0x1D60D, "M", "f"),
+        (0x1D60E, "M", "g"),
+        (0x1D60F, "M", "h"),
+        (0x1D610, "M", "i"),
+        (0x1D611, "M", "j"),
+        (0x1D612, "M", "k"),
+        (0x1D613, "M", "l"),
+        (0x1D614, "M", "m"),
+        (0x1D615, "M", "n"),
+        (0x1D616, "M", "o"),
+        (0x1D617, "M", "p"),
+        (0x1D618, "M", "q"),
+        (0x1D619, "M", "r"),
+        (0x1D61A, "M", "s"),
+        (0x1D61B, "M", "t"),
+        (0x1D61C, "M", "u"),
+        (0x1D61D, "M", "v"),
+        (0x1D61E, "M", "w"),
     ]
 
+
 def _seg_66() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x1D61F, 'M', 'x'),
-    (0x1D620, 'M', 'y'),
-    (0x1D621, 'M', 'z'),
-    (0x1D622, 'M', 'a'),
-    (0x1D623, 'M', 'b'),
-    (0x1D624, 'M', 'c'),
-    (0x1D625, 'M', 'd'),
-    (0x1D626, 'M', 'e'),
-    (0x1D627, 'M', 'f'),
-    (0x1D628, 'M', 'g'),
-    (0x1D629, 'M', 'h'),
-    (0x1D62A, 'M', 'i'),
-    (0x1D62B, 'M', 'j'),
-    (0x1D62C, 'M', 'k'),
-    (0x1D62D, 'M', 'l'),
-    (0x1D62E, 'M', 'm'),
-    (0x1D62F, 'M', 'n'),
-    (0x1D630, 'M', 'o'),
-    (0x1D631, 'M', 'p'),
-    (0x1D632, 'M', 'q'),
-    (0x1D633, 'M', 'r'),
-    (0x1D634, 'M', 's'),
-    (0x1D635, 'M', 't'),
-    (0x1D636, 'M', 'u'),
-    (0x1D637, 'M', 'v'),
-    (0x1D638, 'M', 'w'),
-    (0x1D639, 'M', 'x'),
-    (0x1D63A, 'M', 'y'),
-    (0x1D63B, 'M', 'z'),
-    (0x1D63C, 'M', 'a'),
-    (0x1D63D, 'M', 'b'),
-    (0x1D63E, 'M', 'c'),
-    (0x1D63F, 'M', 'd'),
-    (0x1D640, 'M', 'e'),
-    (0x1D641, 'M', 'f'),
-    (0x1D642, 'M', 'g'),
-    (0x1D643, 'M', 'h'),
-    (0x1D644, 'M', 'i'),
-    (0x1D645, 'M', 'j'),
-    (0x1D646, 'M', 'k'),
-    (0x1D647, 'M', 'l'),
-    (0x1D648, 'M', 'm'),
-    (0x1D649, 'M', 'n'),
-    (0x1D64A, 'M', 'o'),
-    (0x1D64B, 'M', 'p'),
-    (0x1D64C, 'M', 'q'),
-    (0x1D64D, 'M', 'r'),
-    (0x1D64E, 'M', 's'),
-    (0x1D64F, 'M', 't'),
-    (0x1D650, 'M', 'u'),
-    (0x1D651, 'M', 'v'),
-    (0x1D652, 'M', 'w'),
-    (0x1D653, 'M', 'x'),
-    (0x1D654, 'M', 'y'),
-    (0x1D655, 'M', 'z'),
-    (0x1D656, 'M', 'a'),
-    (0x1D657, 'M', 'b'),
-    (0x1D658, 'M', 'c'),
-    (0x1D659, 'M', 'd'),
-    (0x1D65A, 'M', 'e'),
-    (0x1D65B, 'M', 'f'),
-    (0x1D65C, 'M', 'g'),
-    (0x1D65D, 'M', 'h'),
-    (0x1D65E, 'M', 'i'),
-    (0x1D65F, 'M', 'j'),
-    (0x1D660, 'M', 'k'),
-    (0x1D661, 'M', 'l'),
-    (0x1D662, 'M', 'm'),
-    (0x1D663, 'M', 'n'),
-    (0x1D664, 'M', 'o'),
-    (0x1D665, 'M', 'p'),
-    (0x1D666, 'M', 'q'),
-    (0x1D667, 'M', 'r'),
-    (0x1D668, 'M', 's'),
-    (0x1D669, 'M', 't'),
-    (0x1D66A, 'M', 'u'),
-    (0x1D66B, 'M', 'v'),
-    (0x1D66C, 'M', 'w'),
-    (0x1D66D, 'M', 'x'),
-    (0x1D66E, 'M', 'y'),
-    (0x1D66F, 'M', 'z'),
-    (0x1D670, 'M', 'a'),
-    (0x1D671, 'M', 'b'),
-    (0x1D672, 'M', 'c'),
-    (0x1D673, 'M', 'd'),
-    (0x1D674, 'M', 'e'),
-    (0x1D675, 'M', 'f'),
-    (0x1D676, 'M', 'g'),
-    (0x1D677, 'M', 'h'),
-    (0x1D678, 'M', 'i'),
-    (0x1D679, 'M', 'j'),
-    (0x1D67A, 'M', 'k'),
-    (0x1D67B, 'M', 'l'),
-    (0x1D67C, 'M', 'm'),
-    (0x1D67D, 'M', 'n'),
-    (0x1D67E, 'M', 'o'),
-    (0x1D67F, 'M', 'p'),
-    (0x1D680, 'M', 'q'),
-    (0x1D681, 'M', 'r'),
-    (0x1D682, 'M', 's'),
+        (0x1D61F, "M", "x"),
+        (0x1D620, "M", "y"),
+        (0x1D621, "M", "z"),
+        (0x1D622, "M", "a"),
+        (0x1D623, "M", "b"),
+        (0x1D624, "M", "c"),
+        (0x1D625, "M", "d"),
+        (0x1D626, "M", "e"),
+        (0x1D627, "M", "f"),
+        (0x1D628, "M", "g"),
+        (0x1D629, "M", "h"),
+        (0x1D62A, "M", "i"),
+        (0x1D62B, "M", "j"),
+        (0x1D62C, "M", "k"),
+        (0x1D62D, "M", "l"),
+        (0x1D62E, "M", "m"),
+        (0x1D62F, "M", "n"),
+        (0x1D630, "M", "o"),
+        (0x1D631, "M", "p"),
+        (0x1D632, "M", "q"),
+        (0x1D633, "M", "r"),
+        (0x1D634, "M", "s"),
+        (0x1D635, "M", "t"),
+        (0x1D636, "M", "u"),
+        (0x1D637, "M", "v"),
+        (0x1D638, "M", "w"),
+        (0x1D639, "M", "x"),
+        (0x1D63A, "M", "y"),
+        (0x1D63B, "M", "z"),
+        (0x1D63C, "M", "a"),
+        (0x1D63D, "M", "b"),
+        (0x1D63E, "M", "c"),
+        (0x1D63F, "M", "d"),
+        (0x1D640, "M", "e"),
+        (0x1D641, "M", "f"),
+        (0x1D642, "M", "g"),
+        (0x1D643, "M", "h"),
+        (0x1D644, "M", "i"),
+        (0x1D645, "M", "j"),
+        (0x1D646, "M", "k"),
+        (0x1D647, "M", "l"),
+        (0x1D648, "M", "m"),
+        (0x1D649, "M", "n"),
+        (0x1D64A, "M", "o"),
+        (0x1D64B, "M", "p"),
+        (0x1D64C, "M", "q"),
+        (0x1D64D, "M", "r"),
+        (0x1D64E, "M", "s"),
+        (0x1D64F, "M", "t"),
+        (0x1D650, "M", "u"),
+        (0x1D651, "M", "v"),
+        (0x1D652, "M", "w"),
+        (0x1D653, "M", "x"),
+        (0x1D654, "M", "y"),
+        (0x1D655, "M", "z"),
+        (0x1D656, "M", "a"),
+        (0x1D657, "M", "b"),
+        (0x1D658, "M", "c"),
+        (0x1D659, "M", "d"),
+        (0x1D65A, "M", "e"),
+        (0x1D65B, "M", "f"),
+        (0x1D65C, "M", "g"),
+        (0x1D65D, "M", "h"),
+        (0x1D65E, "M", "i"),
+        (0x1D65F, "M", "j"),
+        (0x1D660, "M", "k"),
+        (0x1D661, "M", "l"),
+        (0x1D662, "M", "m"),
+        (0x1D663, "M", "n"),
+        (0x1D664, "M", "o"),
+        (0x1D665, "M", "p"),
+        (0x1D666, "M", "q"),
+        (0x1D667, "M", "r"),
+        (0x1D668, "M", "s"),
+        (0x1D669, "M", "t"),
+        (0x1D66A, "M", "u"),
+        (0x1D66B, "M", "v"),
+        (0x1D66C, "M", "w"),
+        (0x1D66D, "M", "x"),
+        (0x1D66E, "M", "y"),
+        (0x1D66F, "M", "z"),
+        (0x1D670, "M", "a"),
+        (0x1D671, "M", "b"),
+        (0x1D672, "M", "c"),
+        (0x1D673, "M", "d"),
+        (0x1D674, "M", "e"),
+        (0x1D675, "M", "f"),
+        (0x1D676, "M", "g"),
+        (0x1D677, "M", "h"),
+        (0x1D678, "M", "i"),
+        (0x1D679, "M", "j"),
+        (0x1D67A, "M", "k"),
+        (0x1D67B, "M", "l"),
+        (0x1D67C, "M", "m"),
+        (0x1D67D, "M", "n"),
+        (0x1D67E, "M", "o"),
+        (0x1D67F, "M", "p"),
+        (0x1D680, "M", "q"),
+        (0x1D681, "M", "r"),
+        (0x1D682, "M", "s"),
     ]
 
+
 def _seg_67() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x1D683, 'M', 't'),
-    (0x1D684, 'M', 'u'),
-    (0x1D685, 'M', 'v'),
-    (0x1D686, 'M', 'w'),
-    (0x1D687, 'M', 'x'),
-    (0x1D688, 'M', 'y'),
-    (0x1D689, 'M', 'z'),
-    (0x1D68A, 'M', 'a'),
-    (0x1D68B, 'M', 'b'),
-    (0x1D68C, 'M', 'c'),
-    (0x1D68D, 'M', 'd'),
-    (0x1D68E, 'M', 'e'),
-    (0x1D68F, 'M', 'f'),
-    (0x1D690, 'M', 'g'),
-    (0x1D691, 'M', 'h'),
-    (0x1D692, 'M', 'i'),
-    (0x1D693, 'M', 'j'),
-    (0x1D694, 'M', 'k'),
-    (0x1D695, 'M', 'l'),
-    (0x1D696, 'M', 'm'),
-    (0x1D697, 'M', 'n'),
-    (0x1D698, 'M', 'o'),
-    (0x1D699, 'M', 'p'),
-    (0x1D69A, 'M', 'q'),
-    (0x1D69B, 'M', 'r'),
-    (0x1D69C, 'M', 's'),
-    (0x1D69D, 'M', 't'),
-    (0x1D69E, 'M', 'u'),
-    (0x1D69F, 'M', 'v'),
-    (0x1D6A0, 'M', 'w'),
-    (0x1D6A1, 'M', 'x'),
-    (0x1D6A2, 'M', 'y'),
-    (0x1D6A3, 'M', 'z'),
-    (0x1D6A4, 'M', 'ı'),
-    (0x1D6A5, 'M', 'ȷ'),
-    (0x1D6A6, 'X'),
-    (0x1D6A8, 'M', 'α'),
-    (0x1D6A9, 'M', 'β'),
-    (0x1D6AA, 'M', 'γ'),
-    (0x1D6AB, 'M', 'δ'),
-    (0x1D6AC, 'M', 'ε'),
-    (0x1D6AD, 'M', 'ζ'),
-    (0x1D6AE, 'M', 'η'),
-    (0x1D6AF, 'M', 'θ'),
-    (0x1D6B0, 'M', 'ι'),
-    (0x1D6B1, 'M', 'κ'),
-    (0x1D6B2, 'M', 'λ'),
-    (0x1D6B3, 'M', 'μ'),
-    (0x1D6B4, 'M', 'ν'),
-    (0x1D6B5, 'M', 'ξ'),
-    (0x1D6B6, 'M', 'ο'),
-    (0x1D6B7, 'M', 'π'),
-    (0x1D6B8, 'M', 'ρ'),
-    (0x1D6B9, 'M', 'θ'),
-    (0x1D6BA, 'M', 'σ'),
-    (0x1D6BB, 'M', 'τ'),
-    (0x1D6BC, 'M', 'υ'),
-    (0x1D6BD, 'M', 'φ'),
-    (0x1D6BE, 'M', 'χ'),
-    (0x1D6BF, 'M', 'ψ'),
-    (0x1D6C0, 'M', 'ω'),
-    (0x1D6C1, 'M', '∇'),
-    (0x1D6C2, 'M', 'α'),
-    (0x1D6C3, 'M', 'β'),
-    (0x1D6C4, 'M', 'γ'),
-    (0x1D6C5, 'M', 'δ'),
-    (0x1D6C6, 'M', 'ε'),
-    (0x1D6C7, 'M', 'ζ'),
-    (0x1D6C8, 'M', 'η'),
-    (0x1D6C9, 'M', 'θ'),
-    (0x1D6CA, 'M', 'ι'),
-    (0x1D6CB, 'M', 'κ'),
-    (0x1D6CC, 'M', 'λ'),
-    (0x1D6CD, 'M', 'μ'),
-    (0x1D6CE, 'M', 'ν'),
-    (0x1D6CF, 'M', 'ξ'),
-    (0x1D6D0, 'M', 'ο'),
-    (0x1D6D1, 'M', 'π'),
-    (0x1D6D2, 'M', 'ρ'),
-    (0x1D6D3, 'M', 'σ'),
-    (0x1D6D5, 'M', 'τ'),
-    (0x1D6D6, 'M', 'υ'),
-    (0x1D6D7, 'M', 'φ'),
-    (0x1D6D8, 'M', 'χ'),
-    (0x1D6D9, 'M', 'ψ'),
-    (0x1D6DA, 'M', 'ω'),
-    (0x1D6DB, 'M', '∂'),
-    (0x1D6DC, 'M', 'ε'),
-    (0x1D6DD, 'M', 'θ'),
-    (0x1D6DE, 'M', 'κ'),
-    (0x1D6DF, 'M', 'φ'),
-    (0x1D6E0, 'M', 'ρ'),
-    (0x1D6E1, 'M', 'π'),
-    (0x1D6E2, 'M', 'α'),
-    (0x1D6E3, 'M', 'β'),
-    (0x1D6E4, 'M', 'γ'),
-    (0x1D6E5, 'M', 'δ'),
-    (0x1D6E6, 'M', 'ε'),
-    (0x1D6E7, 'M', 'ζ'),
-    (0x1D6E8, 'M', 'η'),
+        (0x1D683, "M", "t"),
+        (0x1D684, "M", "u"),
+        (0x1D685, "M", "v"),
+        (0x1D686, "M", "w"),
+        (0x1D687, "M", "x"),
+        (0x1D688, "M", "y"),
+        (0x1D689, "M", "z"),
+        (0x1D68A, "M", "a"),
+        (0x1D68B, "M", "b"),
+        (0x1D68C, "M", "c"),
+        (0x1D68D, "M", "d"),
+        (0x1D68E, "M", "e"),
+        (0x1D68F, "M", "f"),
+        (0x1D690, "M", "g"),
+        (0x1D691, "M", "h"),
+        (0x1D692, "M", "i"),
+        (0x1D693, "M", "j"),
+        (0x1D694, "M", "k"),
+        (0x1D695, "M", "l"),
+        (0x1D696, "M", "m"),
+        (0x1D697, "M", "n"),
+        (0x1D698, "M", "o"),
+        (0x1D699, "M", "p"),
+        (0x1D69A, "M", "q"),
+        (0x1D69B, "M", "r"),
+        (0x1D69C, "M", "s"),
+        (0x1D69D, "M", "t"),
+        (0x1D69E, "M", "u"),
+        (0x1D69F, "M", "v"),
+        (0x1D6A0, "M", "w"),
+        (0x1D6A1, "M", "x"),
+        (0x1D6A2, "M", "y"),
+        (0x1D6A3, "M", "z"),
+        (0x1D6A4, "M", "ı"),
+        (0x1D6A5, "M", "ȷ"),
+        (0x1D6A6, "X"),
+        (0x1D6A8, "M", "α"),
+        (0x1D6A9, "M", "β"),
+        (0x1D6AA, "M", "γ"),
+        (0x1D6AB, "M", "δ"),
+        (0x1D6AC, "M", "ε"),
+        (0x1D6AD, "M", "ζ"),
+        (0x1D6AE, "M", "η"),
+        (0x1D6AF, "M", "θ"),
+        (0x1D6B0, "M", "ι"),
+        (0x1D6B1, "M", "κ"),
+        (0x1D6B2, "M", "λ"),
+        (0x1D6B3, "M", "μ"),
+        (0x1D6B4, "M", "ν"),
+        (0x1D6B5, "M", "ξ"),
+        (0x1D6B6, "M", "ο"),
+        (0x1D6B7, "M", "π"),
+        (0x1D6B8, "M", "ρ"),
+        (0x1D6B9, "M", "θ"),
+        (0x1D6BA, "M", "σ"),
+        (0x1D6BB, "M", "τ"),
+        (0x1D6BC, "M", "υ"),
+        (0x1D6BD, "M", "φ"),
+        (0x1D6BE, "M", "χ"),
+        (0x1D6BF, "M", "ψ"),
+        (0x1D6C0, "M", "ω"),
+        (0x1D6C1, "M", "∇"),
+        (0x1D6C2, "M", "α"),
+        (0x1D6C3, "M", "β"),
+        (0x1D6C4, "M", "γ"),
+        (0x1D6C5, "M", "δ"),
+        (0x1D6C6, "M", "ε"),
+        (0x1D6C7, "M", "ζ"),
+        (0x1D6C8, "M", "η"),
+        (0x1D6C9, "M", "θ"),
+        (0x1D6CA, "M", "ι"),
+        (0x1D6CB, "M", "κ"),
+        (0x1D6CC, "M", "λ"),
+        (0x1D6CD, "M", "μ"),
+        (0x1D6CE, "M", "ν"),
+        (0x1D6CF, "M", "ξ"),
+        (0x1D6D0, "M", "ο"),
+        (0x1D6D1, "M", "π"),
+        (0x1D6D2, "M", "ρ"),
+        (0x1D6D3, "M", "σ"),
+        (0x1D6D5, "M", "τ"),
+        (0x1D6D6, "M", "υ"),
+        (0x1D6D7, "M", "φ"),
+        (0x1D6D8, "M", "χ"),
+        (0x1D6D9, "M", "ψ"),
+        (0x1D6DA, "M", "ω"),
+        (0x1D6DB, "M", "∂"),
+        (0x1D6DC, "M", "ε"),
+        (0x1D6DD, "M", "θ"),
+        (0x1D6DE, "M", "κ"),
+        (0x1D6DF, "M", "φ"),
+        (0x1D6E0, "M", "ρ"),
+        (0x1D6E1, "M", "π"),
+        (0x1D6E2, "M", "α"),
+        (0x1D6E3, "M", "β"),
+        (0x1D6E4, "M", "γ"),
+        (0x1D6E5, "M", "δ"),
+        (0x1D6E6, "M", "ε"),
+        (0x1D6E7, "M", "ζ"),
+        (0x1D6E8, "M", "η"),
     ]
 
+
 def _seg_68() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x1D6E9, 'M', 'θ'),
-    (0x1D6EA, 'M', 'ι'),
-    (0x1D6EB, 'M', 'κ'),
-    (0x1D6EC, 'M', 'λ'),
-    (0x1D6ED, 'M', 'μ'),
-    (0x1D6EE, 'M', 'ν'),
-    (0x1D6EF, 'M', 'ξ'),
-    (0x1D6F0, 'M', 'ο'),
-    (0x1D6F1, 'M', 'π'),
-    (0x1D6F2, 'M', 'ρ'),
-    (0x1D6F3, 'M', 'θ'),
-    (0x1D6F4, 'M', 'σ'),
-    (0x1D6F5, 'M', 'τ'),
-    (0x1D6F6, 'M', 'υ'),
-    (0x1D6F7, 'M', 'φ'),
-    (0x1D6F8, 'M', 'χ'),
-    (0x1D6F9, 'M', 'ψ'),
-    (0x1D6FA, 'M', 'ω'),
-    (0x1D6FB, 'M', '∇'),
-    (0x1D6FC, 'M', 'α'),
-    (0x1D6FD, 'M', 'β'),
-    (0x1D6FE, 'M', 'γ'),
-    (0x1D6FF, 'M', 'δ'),
-    (0x1D700, 'M', 'ε'),
-    (0x1D701, 'M', 'ζ'),
-    (0x1D702, 'M', 'η'),
-    (0x1D703, 'M', 'θ'),
-    (0x1D704, 'M', 'ι'),
-    (0x1D705, 'M', 'κ'),
-    (0x1D706, 'M', 'λ'),
-    (0x1D707, 'M', 'μ'),
-    (0x1D708, 'M', 'ν'),
-    (0x1D709, 'M', 'ξ'),
-    (0x1D70A, 'M', 'ο'),
-    (0x1D70B, 'M', 'π'),
-    (0x1D70C, 'M', 'ρ'),
-    (0x1D70D, 'M', 'σ'),
-    (0x1D70F, 'M', 'τ'),
-    (0x1D710, 'M', 'υ'),
-    (0x1D711, 'M', 'φ'),
-    (0x1D712, 'M', 'χ'),
-    (0x1D713, 'M', 'ψ'),
-    (0x1D714, 'M', 'ω'),
-    (0x1D715, 'M', '∂'),
-    (0x1D716, 'M', 'ε'),
-    (0x1D717, 'M', 'θ'),
-    (0x1D718, 'M', 'κ'),
-    (0x1D719, 'M', 'φ'),
-    (0x1D71A, 'M', 'ρ'),
-    (0x1D71B, 'M', 'π'),
-    (0x1D71C, 'M', 'α'),
-    (0x1D71D, 'M', 'β'),
-    (0x1D71E, 'M', 'γ'),
-    (0x1D71F, 'M', 'δ'),
-    (0x1D720, 'M', 'ε'),
-    (0x1D721, 'M', 'ζ'),
-    (0x1D722, 'M', 'η'),
-    (0x1D723, 'M', 'θ'),
-    (0x1D724, 'M', 'ι'),
-    (0x1D725, 'M', 'κ'),
-    (0x1D726, 'M', 'λ'),
-    (0x1D727, 'M', 'μ'),
-    (0x1D728, 'M', 'ν'),
-    (0x1D729, 'M', 'ξ'),
-    (0x1D72A, 'M', 'ο'),
-    (0x1D72B, 'M', 'π'),
-    (0x1D72C, 'M', 'ρ'),
-    (0x1D72D, 'M', 'θ'),
-    (0x1D72E, 'M', 'σ'),
-    (0x1D72F, 'M', 'τ'),
-    (0x1D730, 'M', 'υ'),
-    (0x1D731, 'M', 'φ'),
-    (0x1D732, 'M', 'χ'),
-    (0x1D733, 'M', 'ψ'),
-    (0x1D734, 'M', 'ω'),
-    (0x1D735, 'M', '∇'),
-    (0x1D736, 'M', 'α'),
-    (0x1D737, 'M', 'β'),
-    (0x1D738, 'M', 'γ'),
-    (0x1D739, 'M', 'δ'),
-    (0x1D73A, 'M', 'ε'),
-    (0x1D73B, 'M', 'ζ'),
-    (0x1D73C, 'M', 'η'),
-    (0x1D73D, 'M', 'θ'),
-    (0x1D73E, 'M', 'ι'),
-    (0x1D73F, 'M', 'κ'),
-    (0x1D740, 'M', 'λ'),
-    (0x1D741, 'M', 'μ'),
-    (0x1D742, 'M', 'ν'),
-    (0x1D743, 'M', 'ξ'),
-    (0x1D744, 'M', 'ο'),
-    (0x1D745, 'M', 'π'),
-    (0x1D746, 'M', 'ρ'),
-    (0x1D747, 'M', 'σ'),
-    (0x1D749, 'M', 'τ'),
-    (0x1D74A, 'M', 'υ'),
-    (0x1D74B, 'M', 'φ'),
-    (0x1D74C, 'M', 'χ'),
-    (0x1D74D, 'M', 'ψ'),
-    (0x1D74E, 'M', 'ω'),
+        (0x1D6E9, "M", "θ"),
+        (0x1D6EA, "M", "ι"),
+        (0x1D6EB, "M", "κ"),
+        (0x1D6EC, "M", "λ"),
+        (0x1D6ED, "M", "μ"),
+        (0x1D6EE, "M", "ν"),
+        (0x1D6EF, "M", "ξ"),
+        (0x1D6F0, "M", "ο"),
+        (0x1D6F1, "M", "π"),
+        (0x1D6F2, "M", "ρ"),
+        (0x1D6F3, "M", "θ"),
+        (0x1D6F4, "M", "σ"),
+        (0x1D6F5, "M", "τ"),
+        (0x1D6F6, "M", "υ"),
+        (0x1D6F7, "M", "φ"),
+        (0x1D6F8, "M", "χ"),
+        (0x1D6F9, "M", "ψ"),
+        (0x1D6FA, "M", "ω"),
+        (0x1D6FB, "M", "∇"),
+        (0x1D6FC, "M", "α"),
+        (0x1D6FD, "M", "β"),
+        (0x1D6FE, "M", "γ"),
+        (0x1D6FF, "M", "δ"),
+        (0x1D700, "M", "ε"),
+        (0x1D701, "M", "ζ"),
+        (0x1D702, "M", "η"),
+        (0x1D703, "M", "θ"),
+        (0x1D704, "M", "ι"),
+        (0x1D705, "M", "κ"),
+        (0x1D706, "M", "λ"),
+        (0x1D707, "M", "μ"),
+        (0x1D708, "M", "ν"),
+        (0x1D709, "M", "ξ"),
+        (0x1D70A, "M", "ο"),
+        (0x1D70B, "M", "π"),
+        (0x1D70C, "M", "ρ"),
+        (0x1D70D, "M", "σ"),
+        (0x1D70F, "M", "τ"),
+        (0x1D710, "M", "υ"),
+        (0x1D711, "M", "φ"),
+        (0x1D712, "M", "χ"),
+        (0x1D713, "M", "ψ"),
+        (0x1D714, "M", "ω"),
+        (0x1D715, "M", "∂"),
+        (0x1D716, "M", "ε"),
+        (0x1D717, "M", "θ"),
+        (0x1D718, "M", "κ"),
+        (0x1D719, "M", "φ"),
+        (0x1D71A, "M", "ρ"),
+        (0x1D71B, "M", "π"),
+        (0x1D71C, "M", "α"),
+        (0x1D71D, "M", "β"),
+        (0x1D71E, "M", "γ"),
+        (0x1D71F, "M", "δ"),
+        (0x1D720, "M", "ε"),
+        (0x1D721, "M", "ζ"),
+        (0x1D722, "M", "η"),
+        (0x1D723, "M", "θ"),
+        (0x1D724, "M", "ι"),
+        (0x1D725, "M", "κ"),
+        (0x1D726, "M", "λ"),
+        (0x1D727, "M", "μ"),
+        (0x1D728, "M", "ν"),
+        (0x1D729, "M", "ξ"),
+        (0x1D72A, "M", "ο"),
+        (0x1D72B, "M", "π"),
+        (0x1D72C, "M", "ρ"),
+        (0x1D72D, "M", "θ"),
+        (0x1D72E, "M", "σ"),
+        (0x1D72F, "M", "τ"),
+        (0x1D730, "M", "υ"),
+        (0x1D731, "M", "φ"),
+        (0x1D732, "M", "χ"),
+        (0x1D733, "M", "ψ"),
+        (0x1D734, "M", "ω"),
+        (0x1D735, "M", "∇"),
+        (0x1D736, "M", "α"),
+        (0x1D737, "M", "β"),
+        (0x1D738, "M", "γ"),
+        (0x1D739, "M", "δ"),
+        (0x1D73A, "M", "ε"),
+        (0x1D73B, "M", "ζ"),
+        (0x1D73C, "M", "η"),
+        (0x1D73D, "M", "θ"),
+        (0x1D73E, "M", "ι"),
+        (0x1D73F, "M", "κ"),
+        (0x1D740, "M", "λ"),
+        (0x1D741, "M", "μ"),
+        (0x1D742, "M", "ν"),
+        (0x1D743, "M", "ξ"),
+        (0x1D744, "M", "ο"),
+        (0x1D745, "M", "π"),
+        (0x1D746, "M", "ρ"),
+        (0x1D747, "M", "σ"),
+        (0x1D749, "M", "τ"),
+        (0x1D74A, "M", "υ"),
+        (0x1D74B, "M", "φ"),
+        (0x1D74C, "M", "χ"),
+        (0x1D74D, "M", "ψ"),
+        (0x1D74E, "M", "ω"),
     ]
 
+
 def _seg_69() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x1D74F, 'M', '∂'),
-    (0x1D750, 'M', 'ε'),
-    (0x1D751, 'M', 'θ'),
-    (0x1D752, 'M', 'κ'),
-    (0x1D753, 'M', 'φ'),
-    (0x1D754, 'M', 'ρ'),
-    (0x1D755, 'M', 'π'),
-    (0x1D756, 'M', 'α'),
-    (0x1D757, 'M', 'β'),
-    (0x1D758, 'M', 'γ'),
-    (0x1D759, 'M', 'δ'),
-    (0x1D75A, 'M', 'ε'),
-    (0x1D75B, 'M', 'ζ'),
-    (0x1D75C, 'M', 'η'),
-    (0x1D75D, 'M', 'θ'),
-    (0x1D75E, 'M', 'ι'),
-    (0x1D75F, 'M', 'κ'),
-    (0x1D760, 'M', 'λ'),
-    (0x1D761, 'M', 'μ'),
-    (0x1D762, 'M', 'ν'),
-    (0x1D763, 'M', 'ξ'),
-    (0x1D764, 'M', 'ο'),
-    (0x1D765, 'M', 'π'),
-    (0x1D766, 'M', 'ρ'),
-    (0x1D767, 'M', 'θ'),
-    (0x1D768, 'M', 'σ'),
-    (0x1D769, 'M', 'τ'),
-    (0x1D76A, 'M', 'υ'),
-    (0x1D76B, 'M', 'φ'),
-    (0x1D76C, 'M', 'χ'),
-    (0x1D76D, 'M', 'ψ'),
-    (0x1D76E, 'M', 'ω'),
-    (0x1D76F, 'M', '∇'),
-    (0x1D770, 'M', 'α'),
-    (0x1D771, 'M', 'β'),
-    (0x1D772, 'M', 'γ'),
-    (0x1D773, 'M', 'δ'),
-    (0x1D774, 'M', 'ε'),
-    (0x1D775, 'M', 'ζ'),
-    (0x1D776, 'M', 'η'),
-    (0x1D777, 'M', 'θ'),
-    (0x1D778, 'M', 'ι'),
-    (0x1D779, 'M', 'κ'),
-    (0x1D77A, 'M', 'λ'),
-    (0x1D77B, 'M', 'μ'),
-    (0x1D77C, 'M', 'ν'),
-    (0x1D77D, 'M', 'ξ'),
-    (0x1D77E, 'M', 'ο'),
-    (0x1D77F, 'M', 'π'),
-    (0x1D780, 'M', 'ρ'),
-    (0x1D781, 'M', 'σ'),
-    (0x1D783, 'M', 'τ'),
-    (0x1D784, 'M', 'υ'),
-    (0x1D785, 'M', 'φ'),
-    (0x1D786, 'M', 'χ'),
-    (0x1D787, 'M', 'ψ'),
-    (0x1D788, 'M', 'ω'),
-    (0x1D789, 'M', '∂'),
-    (0x1D78A, 'M', 'ε'),
-    (0x1D78B, 'M', 'θ'),
-    (0x1D78C, 'M', 'κ'),
-    (0x1D78D, 'M', 'φ'),
-    (0x1D78E, 'M', 'ρ'),
-    (0x1D78F, 'M', 'π'),
-    (0x1D790, 'M', 'α'),
-    (0x1D791, 'M', 'β'),
-    (0x1D792, 'M', 'γ'),
-    (0x1D793, 'M', 'δ'),
-    (0x1D794, 'M', 'ε'),
-    (0x1D795, 'M', 'ζ'),
-    (0x1D796, 'M', 'η'),
-    (0x1D797, 'M', 'θ'),
-    (0x1D798, 'M', 'ι'),
-    (0x1D799, 'M', 'κ'),
-    (0x1D79A, 'M', 'λ'),
-    (0x1D79B, 'M', 'μ'),
-    (0x1D79C, 'M', 'ν'),
-    (0x1D79D, 'M', 'ξ'),
-    (0x1D79E, 'M', 'ο'),
-    (0x1D79F, 'M', 'π'),
-    (0x1D7A0, 'M', 'ρ'),
-    (0x1D7A1, 'M', 'θ'),
-    (0x1D7A2, 'M', 'σ'),
-    (0x1D7A3, 'M', 'τ'),
-    (0x1D7A4, 'M', 'υ'),
-    (0x1D7A5, 'M', 'φ'),
-    (0x1D7A6, 'M', 'χ'),
-    (0x1D7A7, 'M', 'ψ'),
-    (0x1D7A8, 'M', 'ω'),
-    (0x1D7A9, 'M', '∇'),
-    (0x1D7AA, 'M', 'α'),
-    (0x1D7AB, 'M', 'β'),
-    (0x1D7AC, 'M', 'γ'),
-    (0x1D7AD, 'M', 'δ'),
-    (0x1D7AE, 'M', 'ε'),
-    (0x1D7AF, 'M', 'ζ'),
-    (0x1D7B0, 'M', 'η'),
-    (0x1D7B1, 'M', 'θ'),
-    (0x1D7B2, 'M', 'ι'),
-    (0x1D7B3, 'M', 'κ'),
+        (0x1D74F, "M", "∂"),
+        (0x1D750, "M", "ε"),
+        (0x1D751, "M", "θ"),
+        (0x1D752, "M", "κ"),
+        (0x1D753, "M", "φ"),
+        (0x1D754, "M", "ρ"),
+        (0x1D755, "M", "π"),
+        (0x1D756, "M", "α"),
+        (0x1D757, "M", "β"),
+        (0x1D758, "M", "γ"),
+        (0x1D759, "M", "δ"),
+        (0x1D75A, "M", "ε"),
+        (0x1D75B, "M", "ζ"),
+        (0x1D75C, "M", "η"),
+        (0x1D75D, "M", "θ"),
+        (0x1D75E, "M", "ι"),
+        (0x1D75F, "M", "κ"),
+        (0x1D760, "M", "λ"),
+        (0x1D761, "M", "μ"),
+        (0x1D762, "M", "ν"),
+        (0x1D763, "M", "ξ"),
+        (0x1D764, "M", "ο"),
+        (0x1D765, "M", "π"),
+        (0x1D766, "M", "ρ"),
+        (0x1D767, "M", "θ"),
+        (0x1D768, "M", "σ"),
+        (0x1D769, "M", "τ"),
+        (0x1D76A, "M", "υ"),
+        (0x1D76B, "M", "φ"),
+        (0x1D76C, "M", "χ"),
+        (0x1D76D, "M", "ψ"),
+        (0x1D76E, "M", "ω"),
+        (0x1D76F, "M", "∇"),
+        (0x1D770, "M", "α"),
+        (0x1D771, "M", "β"),
+        (0x1D772, "M", "γ"),
+        (0x1D773, "M", "δ"),
+        (0x1D774, "M", "ε"),
+        (0x1D775, "M", "ζ"),
+        (0x1D776, "M", "η"),
+        (0x1D777, "M", "θ"),
+        (0x1D778, "M", "ι"),
+        (0x1D779, "M", "κ"),
+        (0x1D77A, "M", "λ"),
+        (0x1D77B, "M", "μ"),
+        (0x1D77C, "M", "ν"),
+        (0x1D77D, "M", "ξ"),
+        (0x1D77E, "M", "ο"),
+        (0x1D77F, "M", "π"),
+        (0x1D780, "M", "ρ"),
+        (0x1D781, "M", "σ"),
+        (0x1D783, "M", "τ"),
+        (0x1D784, "M", "υ"),
+        (0x1D785, "M", "φ"),
+        (0x1D786, "M", "χ"),
+        (0x1D787, "M", "ψ"),
+        (0x1D788, "M", "ω"),
+        (0x1D789, "M", "∂"),
+        (0x1D78A, "M", "ε"),
+        (0x1D78B, "M", "θ"),
+        (0x1D78C, "M", "κ"),
+        (0x1D78D, "M", "φ"),
+        (0x1D78E, "M", "ρ"),
+        (0x1D78F, "M", "π"),
+        (0x1D790, "M", "α"),
+        (0x1D791, "M", "β"),
+        (0x1D792, "M", "γ"),
+        (0x1D793, "M", "δ"),
+        (0x1D794, "M", "ε"),
+        (0x1D795, "M", "ζ"),
+        (0x1D796, "M", "η"),
+        (0x1D797, "M", "θ"),
+        (0x1D798, "M", "ι"),
+        (0x1D799, "M", "κ"),
+        (0x1D79A, "M", "λ"),
+        (0x1D79B, "M", "μ"),
+        (0x1D79C, "M", "ν"),
+        (0x1D79D, "M", "ξ"),
+        (0x1D79E, "M", "ο"),
+        (0x1D79F, "M", "π"),
+        (0x1D7A0, "M", "ρ"),
+        (0x1D7A1, "M", "θ"),
+        (0x1D7A2, "M", "σ"),
+        (0x1D7A3, "M", "τ"),
+        (0x1D7A4, "M", "υ"),
+        (0x1D7A5, "M", "φ"),
+        (0x1D7A6, "M", "χ"),
+        (0x1D7A7, "M", "ψ"),
+        (0x1D7A8, "M", "ω"),
+        (0x1D7A9, "M", "∇"),
+        (0x1D7AA, "M", "α"),
+        (0x1D7AB, "M", "β"),
+        (0x1D7AC, "M", "γ"),
+        (0x1D7AD, "M", "δ"),
+        (0x1D7AE, "M", "ε"),
+        (0x1D7AF, "M", "ζ"),
+        (0x1D7B0, "M", "η"),
+        (0x1D7B1, "M", "θ"),
+        (0x1D7B2, "M", "ι"),
+        (0x1D7B3, "M", "κ"),
     ]
 
+
 def _seg_70() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x1D7B4, 'M', 'λ'),
-    (0x1D7B5, 'M', 'μ'),
-    (0x1D7B6, 'M', 'ν'),
-    (0x1D7B7, 'M', 'ξ'),
-    (0x1D7B8, 'M', 'ο'),
-    (0x1D7B9, 'M', 'π'),
-    (0x1D7BA, 'M', 'ρ'),
-    (0x1D7BB, 'M', 'σ'),
-    (0x1D7BD, 'M', 'τ'),
-    (0x1D7BE, 'M', 'υ'),
-    (0x1D7BF, 'M', 'φ'),
-    (0x1D7C0, 'M', 'χ'),
-    (0x1D7C1, 'M', 'ψ'),
-    (0x1D7C2, 'M', 'ω'),
-    (0x1D7C3, 'M', '∂'),
-    (0x1D7C4, 'M', 'ε'),
-    (0x1D7C5, 'M', 'θ'),
-    (0x1D7C6, 'M', 'κ'),
-    (0x1D7C7, 'M', 'φ'),
-    (0x1D7C8, 'M', 'ρ'),
-    (0x1D7C9, 'M', 'π'),
-    (0x1D7CA, 'M', 'ϝ'),
-    (0x1D7CC, 'X'),
-    (0x1D7CE, 'M', '0'),
-    (0x1D7CF, 'M', '1'),
-    (0x1D7D0, 'M', '2'),
-    (0x1D7D1, 'M', '3'),
-    (0x1D7D2, 'M', '4'),
-    (0x1D7D3, 'M', '5'),
-    (0x1D7D4, 'M', '6'),
-    (0x1D7D5, 'M', '7'),
-    (0x1D7D6, 'M', '8'),
-    (0x1D7D7, 'M', '9'),
-    (0x1D7D8, 'M', '0'),
-    (0x1D7D9, 'M', '1'),
-    (0x1D7DA, 'M', '2'),
-    (0x1D7DB, 'M', '3'),
-    (0x1D7DC, 'M', '4'),
-    (0x1D7DD, 'M', '5'),
-    (0x1D7DE, 'M', '6'),
-    (0x1D7DF, 'M', '7'),
-    (0x1D7E0, 'M', '8'),
-    (0x1D7E1, 'M', '9'),
-    (0x1D7E2, 'M', '0'),
-    (0x1D7E3, 'M', '1'),
-    (0x1D7E4, 'M', '2'),
-    (0x1D7E5, 'M', '3'),
-    (0x1D7E6, 'M', '4'),
-    (0x1D7E7, 'M', '5'),
-    (0x1D7E8, 'M', '6'),
-    (0x1D7E9, 'M', '7'),
-    (0x1D7EA, 'M', '8'),
-    (0x1D7EB, 'M', '9'),
-    (0x1D7EC, 'M', '0'),
-    (0x1D7ED, 'M', '1'),
-    (0x1D7EE, 'M', '2'),
-    (0x1D7EF, 'M', '3'),
-    (0x1D7F0, 'M', '4'),
-    (0x1D7F1, 'M', '5'),
-    (0x1D7F2, 'M', '6'),
-    (0x1D7F3, 'M', '7'),
-    (0x1D7F4, 'M', '8'),
-    (0x1D7F5, 'M', '9'),
-    (0x1D7F6, 'M', '0'),
-    (0x1D7F7, 'M', '1'),
-    (0x1D7F8, 'M', '2'),
-    (0x1D7F9, 'M', '3'),
-    (0x1D7FA, 'M', '4'),
-    (0x1D7FB, 'M', '5'),
-    (0x1D7FC, 'M', '6'),
-    (0x1D7FD, 'M', '7'),
-    (0x1D7FE, 'M', '8'),
-    (0x1D7FF, 'M', '9'),
-    (0x1D800, 'V'),
-    (0x1DA8C, 'X'),
-    (0x1DA9B, 'V'),
-    (0x1DAA0, 'X'),
-    (0x1DAA1, 'V'),
-    (0x1DAB0, 'X'),
-    (0x1DF00, 'V'),
-    (0x1DF1F, 'X'),
-    (0x1DF25, 'V'),
-    (0x1DF2B, 'X'),
-    (0x1E000, 'V'),
-    (0x1E007, 'X'),
-    (0x1E008, 'V'),
-    (0x1E019, 'X'),
-    (0x1E01B, 'V'),
-    (0x1E022, 'X'),
-    (0x1E023, 'V'),
-    (0x1E025, 'X'),
-    (0x1E026, 'V'),
-    (0x1E02B, 'X'),
-    (0x1E030, 'M', 'а'),
-    (0x1E031, 'M', 'б'),
-    (0x1E032, 'M', 'в'),
-    (0x1E033, 'M', 'г'),
-    (0x1E034, 'M', 'д'),
-    (0x1E035, 'M', 'е'),
-    (0x1E036, 'M', 'ж'),
+        (0x1D7B4, "M", "λ"),
+        (0x1D7B5, "M", "μ"),
+        (0x1D7B6, "M", "ν"),
+        (0x1D7B7, "M", "ξ"),
+        (0x1D7B8, "M", "ο"),
+        (0x1D7B9, "M", "π"),
+        (0x1D7BA, "M", "ρ"),
+        (0x1D7BB, "M", "σ"),
+        (0x1D7BD, "M", "τ"),
+        (0x1D7BE, "M", "υ"),
+        (0x1D7BF, "M", "φ"),
+        (0x1D7C0, "M", "χ"),
+        (0x1D7C1, "M", "ψ"),
+        (0x1D7C2, "M", "ω"),
+        (0x1D7C3, "M", "∂"),
+        (0x1D7C4, "M", "ε"),
+        (0x1D7C5, "M", "θ"),
+        (0x1D7C6, "M", "κ"),
+        (0x1D7C7, "M", "φ"),
+        (0x1D7C8, "M", "ρ"),
+        (0x1D7C9, "M", "π"),
+        (0x1D7CA, "M", "ϝ"),
+        (0x1D7CC, "X"),
+        (0x1D7CE, "M", "0"),
+        (0x1D7CF, "M", "1"),
+        (0x1D7D0, "M", "2"),
+        (0x1D7D1, "M", "3"),
+        (0x1D7D2, "M", "4"),
+        (0x1D7D3, "M", "5"),
+        (0x1D7D4, "M", "6"),
+        (0x1D7D5, "M", "7"),
+        (0x1D7D6, "M", "8"),
+        (0x1D7D7, "M", "9"),
+        (0x1D7D8, "M", "0"),
+        (0x1D7D9, "M", "1"),
+        (0x1D7DA, "M", "2"),
+        (0x1D7DB, "M", "3"),
+        (0x1D7DC, "M", "4"),
+        (0x1D7DD, "M", "5"),
+        (0x1D7DE, "M", "6"),
+        (0x1D7DF, "M", "7"),
+        (0x1D7E0, "M", "8"),
+        (0x1D7E1, "M", "9"),
+        (0x1D7E2, "M", "0"),
+        (0x1D7E3, "M", "1"),
+        (0x1D7E4, "M", "2"),
+        (0x1D7E5, "M", "3"),
+        (0x1D7E6, "M", "4"),
+        (0x1D7E7, "M", "5"),
+        (0x1D7E8, "M", "6"),
+        (0x1D7E9, "M", "7"),
+        (0x1D7EA, "M", "8"),
+        (0x1D7EB, "M", "9"),
+        (0x1D7EC, "M", "0"),
+        (0x1D7ED, "M", "1"),
+        (0x1D7EE, "M", "2"),
+        (0x1D7EF, "M", "3"),
+        (0x1D7F0, "M", "4"),
+        (0x1D7F1, "M", "5"),
+        (0x1D7F2, "M", "6"),
+        (0x1D7F3, "M", "7"),
+        (0x1D7F4, "M", "8"),
+        (0x1D7F5, "M", "9"),
+        (0x1D7F6, "M", "0"),
+        (0x1D7F7, "M", "1"),
+        (0x1D7F8, "M", "2"),
+        (0x1D7F9, "M", "3"),
+        (0x1D7FA, "M", "4"),
+        (0x1D7FB, "M", "5"),
+        (0x1D7FC, "M", "6"),
+        (0x1D7FD, "M", "7"),
+        (0x1D7FE, "M", "8"),
+        (0x1D7FF, "M", "9"),
+        (0x1D800, "V"),
+        (0x1DA8C, "X"),
+        (0x1DA9B, "V"),
+        (0x1DAA0, "X"),
+        (0x1DAA1, "V"),
+        (0x1DAB0, "X"),
+        (0x1DF00, "V"),
+        (0x1DF1F, "X"),
+        (0x1DF25, "V"),
+        (0x1DF2B, "X"),
+        (0x1E000, "V"),
+        (0x1E007, "X"),
+        (0x1E008, "V"),
+        (0x1E019, "X"),
+        (0x1E01B, "V"),
+        (0x1E022, "X"),
+        (0x1E023, "V"),
+        (0x1E025, "X"),
+        (0x1E026, "V"),
+        (0x1E02B, "X"),
+        (0x1E030, "M", "а"),
+        (0x1E031, "M", "б"),
+        (0x1E032, "M", "в"),
+        (0x1E033, "M", "г"),
+        (0x1E034, "M", "д"),
+        (0x1E035, "M", "е"),
+        (0x1E036, "M", "ж"),
     ]
 
+
 def _seg_71() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x1E037, 'M', 'з'),
-    (0x1E038, 'M', 'и'),
-    (0x1E039, 'M', 'к'),
-    (0x1E03A, 'M', 'л'),
-    (0x1E03B, 'M', 'м'),
-    (0x1E03C, 'M', 'о'),
-    (0x1E03D, 'M', 'п'),
-    (0x1E03E, 'M', 'р'),
-    (0x1E03F, 'M', 'с'),
-    (0x1E040, 'M', 'т'),
-    (0x1E041, 'M', 'у'),
-    (0x1E042, 'M', 'ф'),
-    (0x1E043, 'M', 'х'),
-    (0x1E044, 'M', 'ц'),
-    (0x1E045, 'M', 'ч'),
-    (0x1E046, 'M', 'ш'),
-    (0x1E047, 'M', 'ы'),
-    (0x1E048, 'M', 'э'),
-    (0x1E049, 'M', 'ю'),
-    (0x1E04A, 'M', 'ꚉ'),
-    (0x1E04B, 'M', 'ә'),
-    (0x1E04C, 'M', 'і'),
-    (0x1E04D, 'M', 'ј'),
-    (0x1E04E, 'M', 'ө'),
-    (0x1E04F, 'M', 'ү'),
-    (0x1E050, 'M', 'ӏ'),
-    (0x1E051, 'M', 'а'),
-    (0x1E052, 'M', 'б'),
-    (0x1E053, 'M', 'в'),
-    (0x1E054, 'M', 'г'),
-    (0x1E055, 'M', 'д'),
-    (0x1E056, 'M', 'е'),
-    (0x1E057, 'M', 'ж'),
-    (0x1E058, 'M', 'з'),
-    (0x1E059, 'M', 'и'),
-    (0x1E05A, 'M', 'к'),
-    (0x1E05B, 'M', 'л'),
-    (0x1E05C, 'M', 'о'),
-    (0x1E05D, 'M', 'п'),
-    (0x1E05E, 'M', 'с'),
-    (0x1E05F, 'M', 'у'),
-    (0x1E060, 'M', 'ф'),
-    (0x1E061, 'M', 'х'),
-    (0x1E062, 'M', 'ц'),
-    (0x1E063, 'M', 'ч'),
-    (0x1E064, 'M', 'ш'),
-    (0x1E065, 'M', 'ъ'),
-    (0x1E066, 'M', 'ы'),
-    (0x1E067, 'M', 'ґ'),
-    (0x1E068, 'M', 'і'),
-    (0x1E069, 'M', 'ѕ'),
-    (0x1E06A, 'M', 'џ'),
-    (0x1E06B, 'M', 'ҫ'),
-    (0x1E06C, 'M', 'ꙑ'),
-    (0x1E06D, 'M', 'ұ'),
-    (0x1E06E, 'X'),
-    (0x1E08F, 'V'),
-    (0x1E090, 'X'),
-    (0x1E100, 'V'),
-    (0x1E12D, 'X'),
-    (0x1E130, 'V'),
-    (0x1E13E, 'X'),
-    (0x1E140, 'V'),
-    (0x1E14A, 'X'),
-    (0x1E14E, 'V'),
-    (0x1E150, 'X'),
-    (0x1E290, 'V'),
-    (0x1E2AF, 'X'),
-    (0x1E2C0, 'V'),
-    (0x1E2FA, 'X'),
-    (0x1E2FF, 'V'),
-    (0x1E300, 'X'),
-    (0x1E4D0, 'V'),
-    (0x1E4FA, 'X'),
-    (0x1E7E0, 'V'),
-    (0x1E7E7, 'X'),
-    (0x1E7E8, 'V'),
-    (0x1E7EC, 'X'),
-    (0x1E7ED, 'V'),
-    (0x1E7EF, 'X'),
-    (0x1E7F0, 'V'),
-    (0x1E7FF, 'X'),
-    (0x1E800, 'V'),
-    (0x1E8C5, 'X'),
-    (0x1E8C7, 'V'),
-    (0x1E8D7, 'X'),
-    (0x1E900, 'M', '𞤢'),
-    (0x1E901, 'M', '𞤣'),
-    (0x1E902, 'M', '𞤤'),
-    (0x1E903, 'M', '𞤥'),
-    (0x1E904, 'M', '𞤦'),
-    (0x1E905, 'M', '𞤧'),
-    (0x1E906, 'M', '𞤨'),
-    (0x1E907, 'M', '𞤩'),
-    (0x1E908, 'M', '𞤪'),
-    (0x1E909, 'M', '𞤫'),
-    (0x1E90A, 'M', '𞤬'),
-    (0x1E90B, 'M', '𞤭'),
-    (0x1E90C, 'M', '𞤮'),
-    (0x1E90D, 'M', '𞤯'),
+        (0x1E037, "M", "з"),
+        (0x1E038, "M", "и"),
+        (0x1E039, "M", "к"),
+        (0x1E03A, "M", "л"),
+        (0x1E03B, "M", "м"),
+        (0x1E03C, "M", "о"),
+        (0x1E03D, "M", "п"),
+        (0x1E03E, "M", "р"),
+        (0x1E03F, "M", "с"),
+        (0x1E040, "M", "т"),
+        (0x1E041, "M", "у"),
+        (0x1E042, "M", "ф"),
+        (0x1E043, "M", "х"),
+        (0x1E044, "M", "ц"),
+        (0x1E045, "M", "ч"),
+        (0x1E046, "M", "ш"),
+        (0x1E047, "M", "ы"),
+        (0x1E048, "M", "э"),
+        (0x1E049, "M", "ю"),
+        (0x1E04A, "M", "ꚉ"),
+        (0x1E04B, "M", "ә"),
+        (0x1E04C, "M", "і"),
+        (0x1E04D, "M", "ј"),
+        (0x1E04E, "M", "ө"),
+        (0x1E04F, "M", "ү"),
+        (0x1E050, "M", "ӏ"),
+        (0x1E051, "M", "а"),
+        (0x1E052, "M", "б"),
+        (0x1E053, "M", "в"),
+        (0x1E054, "M", "г"),
+        (0x1E055, "M", "д"),
+        (0x1E056, "M", "е"),
+        (0x1E057, "M", "ж"),
+        (0x1E058, "M", "з"),
+        (0x1E059, "M", "и"),
+        (0x1E05A, "M", "к"),
+        (0x1E05B, "M", "л"),
+        (0x1E05C, "M", "о"),
+        (0x1E05D, "M", "п"),
+        (0x1E05E, "M", "с"),
+        (0x1E05F, "M", "у"),
+        (0x1E060, "M", "ф"),
+        (0x1E061, "M", "х"),
+        (0x1E062, "M", "ц"),
+        (0x1E063, "M", "ч"),
+        (0x1E064, "M", "ш"),
+        (0x1E065, "M", "ъ"),
+        (0x1E066, "M", "ы"),
+        (0x1E067, "M", "ґ"),
+        (0x1E068, "M", "і"),
+        (0x1E069, "M", "ѕ"),
+        (0x1E06A, "M", "џ"),
+        (0x1E06B, "M", "ҫ"),
+        (0x1E06C, "M", "ꙑ"),
+        (0x1E06D, "M", "ұ"),
+        (0x1E06E, "X"),
+        (0x1E08F, "V"),
+        (0x1E090, "X"),
+        (0x1E100, "V"),
+        (0x1E12D, "X"),
+        (0x1E130, "V"),
+        (0x1E13E, "X"),
+        (0x1E140, "V"),
+        (0x1E14A, "X"),
+        (0x1E14E, "V"),
+        (0x1E150, "X"),
+        (0x1E290, "V"),
+        (0x1E2AF, "X"),
+        (0x1E2C0, "V"),
+        (0x1E2FA, "X"),
+        (0x1E2FF, "V"),
+        (0x1E300, "X"),
+        (0x1E4D0, "V"),
+        (0x1E4FA, "X"),
+        (0x1E7E0, "V"),
+        (0x1E7E7, "X"),
+        (0x1E7E8, "V"),
+        (0x1E7EC, "X"),
+        (0x1E7ED, "V"),
+        (0x1E7EF, "X"),
+        (0x1E7F0, "V"),
+        (0x1E7FF, "X"),
+        (0x1E800, "V"),
+        (0x1E8C5, "X"),
+        (0x1E8C7, "V"),
+        (0x1E8D7, "X"),
+        (0x1E900, "M", "𞤢"),
+        (0x1E901, "M", "𞤣"),
+        (0x1E902, "M", "𞤤"),
+        (0x1E903, "M", "𞤥"),
+        (0x1E904, "M", "𞤦"),
+        (0x1E905, "M", "𞤧"),
+        (0x1E906, "M", "𞤨"),
+        (0x1E907, "M", "𞤩"),
+        (0x1E908, "M", "𞤪"),
+        (0x1E909, "M", "𞤫"),
+        (0x1E90A, "M", "𞤬"),
+        (0x1E90B, "M", "𞤭"),
+        (0x1E90C, "M", "𞤮"),
+        (0x1E90D, "M", "𞤯"),
     ]
 
+
 def _seg_72() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x1E90E, 'M', '𞤰'),
-    (0x1E90F, 'M', '𞤱'),
-    (0x1E910, 'M', '𞤲'),
-    (0x1E911, 'M', '𞤳'),
-    (0x1E912, 'M', '𞤴'),
-    (0x1E913, 'M', '𞤵'),
-    (0x1E914, 'M', '𞤶'),
-    (0x1E915, 'M', '𞤷'),
-    (0x1E916, 'M', '𞤸'),
-    (0x1E917, 'M', '𞤹'),
-    (0x1E918, 'M', '𞤺'),
-    (0x1E919, 'M', '𞤻'),
-    (0x1E91A, 'M', '𞤼'),
-    (0x1E91B, 'M', '𞤽'),
-    (0x1E91C, 'M', '𞤾'),
-    (0x1E91D, 'M', '𞤿'),
-    (0x1E91E, 'M', '𞥀'),
-    (0x1E91F, 'M', '𞥁'),
-    (0x1E920, 'M', '𞥂'),
-    (0x1E921, 'M', '𞥃'),
-    (0x1E922, 'V'),
-    (0x1E94C, 'X'),
-    (0x1E950, 'V'),
-    (0x1E95A, 'X'),
-    (0x1E95E, 'V'),
-    (0x1E960, 'X'),
-    (0x1EC71, 'V'),
-    (0x1ECB5, 'X'),
-    (0x1ED01, 'V'),
-    (0x1ED3E, 'X'),
-    (0x1EE00, 'M', 'ا'),
-    (0x1EE01, 'M', 'ب'),
-    (0x1EE02, 'M', 'ج'),
-    (0x1EE03, 'M', 'د'),
-    (0x1EE04, 'X'),
-    (0x1EE05, 'M', 'و'),
-    (0x1EE06, 'M', 'ز'),
-    (0x1EE07, 'M', 'ح'),
-    (0x1EE08, 'M', 'ط'),
-    (0x1EE09, 'M', 'ي'),
-    (0x1EE0A, 'M', 'ك'),
-    (0x1EE0B, 'M', 'ل'),
-    (0x1EE0C, 'M', 'م'),
-    (0x1EE0D, 'M', 'ن'),
-    (0x1EE0E, 'M', 'س'),
-    (0x1EE0F, 'M', 'ع'),
-    (0x1EE10, 'M', 'ف'),
-    (0x1EE11, 'M', 'ص'),
-    (0x1EE12, 'M', 'ق'),
-    (0x1EE13, 'M', 'ر'),
-    (0x1EE14, 'M', 'ش'),
-    (0x1EE15, 'M', 'ت'),
-    (0x1EE16, 'M', 'ث'),
-    (0x1EE17, 'M', 'خ'),
-    (0x1EE18, 'M', 'ذ'),
-    (0x1EE19, 'M', 'ض'),
-    (0x1EE1A, 'M', 'ظ'),
-    (0x1EE1B, 'M', 'غ'),
-    (0x1EE1C, 'M', 'ٮ'),
-    (0x1EE1D, 'M', 'ں'),
-    (0x1EE1E, 'M', 'ڡ'),
-    (0x1EE1F, 'M', 'ٯ'),
-    (0x1EE20, 'X'),
-    (0x1EE21, 'M', 'ب'),
-    (0x1EE22, 'M', 'ج'),
-    (0x1EE23, 'X'),
-    (0x1EE24, 'M', 'ه'),
-    (0x1EE25, 'X'),
-    (0x1EE27, 'M', 'ح'),
-    (0x1EE28, 'X'),
-    (0x1EE29, 'M', 'ي'),
-    (0x1EE2A, 'M', 'ك'),
-    (0x1EE2B, 'M', 'ل'),
-    (0x1EE2C, 'M', 'م'),
-    (0x1EE2D, 'M', 'ن'),
-    (0x1EE2E, 'M', 'س'),
-    (0x1EE2F, 'M', 'ع'),
-    (0x1EE30, 'M', 'ف'),
-    (0x1EE31, 'M', 'ص'),
-    (0x1EE32, 'M', 'ق'),
-    (0x1EE33, 'X'),
-    (0x1EE34, 'M', 'ش'),
-    (0x1EE35, 'M', 'ت'),
-    (0x1EE36, 'M', 'ث'),
-    (0x1EE37, 'M', 'خ'),
-    (0x1EE38, 'X'),
-    (0x1EE39, 'M', 'ض'),
-    (0x1EE3A, 'X'),
-    (0x1EE3B, 'M', 'غ'),
-    (0x1EE3C, 'X'),
-    (0x1EE42, 'M', 'ج'),
-    (0x1EE43, 'X'),
-    (0x1EE47, 'M', 'ح'),
-    (0x1EE48, 'X'),
-    (0x1EE49, 'M', 'ي'),
-    (0x1EE4A, 'X'),
-    (0x1EE4B, 'M', 'ل'),
-    (0x1EE4C, 'X'),
-    (0x1EE4D, 'M', 'ن'),
-    (0x1EE4E, 'M', 'س'),
+        (0x1E90E, "M", "𞤰"),
+        (0x1E90F, "M", "𞤱"),
+        (0x1E910, "M", "𞤲"),
+        (0x1E911, "M", "𞤳"),
+        (0x1E912, "M", "𞤴"),
+        (0x1E913, "M", "𞤵"),
+        (0x1E914, "M", "𞤶"),
+        (0x1E915, "M", "𞤷"),
+        (0x1E916, "M", "𞤸"),
+        (0x1E917, "M", "𞤹"),
+        (0x1E918, "M", "𞤺"),
+        (0x1E919, "M", "𞤻"),
+        (0x1E91A, "M", "𞤼"),
+        (0x1E91B, "M", "𞤽"),
+        (0x1E91C, "M", "𞤾"),
+        (0x1E91D, "M", "𞤿"),
+        (0x1E91E, "M", "𞥀"),
+        (0x1E91F, "M", "𞥁"),
+        (0x1E920, "M", "𞥂"),
+        (0x1E921, "M", "𞥃"),
+        (0x1E922, "V"),
+        (0x1E94C, "X"),
+        (0x1E950, "V"),
+        (0x1E95A, "X"),
+        (0x1E95E, "V"),
+        (0x1E960, "X"),
+        (0x1EC71, "V"),
+        (0x1ECB5, "X"),
+        (0x1ED01, "V"),
+        (0x1ED3E, "X"),
+        (0x1EE00, "M", "ا"),
+        (0x1EE01, "M", "ب"),
+        (0x1EE02, "M", "ج"),
+        (0x1EE03, "M", "د"),
+        (0x1EE04, "X"),
+        (0x1EE05, "M", "و"),
+        (0x1EE06, "M", "ز"),
+        (0x1EE07, "M", "ح"),
+        (0x1EE08, "M", "ط"),
+        (0x1EE09, "M", "ي"),
+        (0x1EE0A, "M", "ك"),
+        (0x1EE0B, "M", "ل"),
+        (0x1EE0C, "M", "م"),
+        (0x1EE0D, "M", "ن"),
+        (0x1EE0E, "M", "س"),
+        (0x1EE0F, "M", "ع"),
+        (0x1EE10, "M", "ف"),
+        (0x1EE11, "M", "ص"),
+        (0x1EE12, "M", "ق"),
+        (0x1EE13, "M", "ر"),
+        (0x1EE14, "M", "ش"),
+        (0x1EE15, "M", "ت"),
+        (0x1EE16, "M", "ث"),
+        (0x1EE17, "M", "خ"),
+        (0x1EE18, "M", "ذ"),
+        (0x1EE19, "M", "ض"),
+        (0x1EE1A, "M", "ظ"),
+        (0x1EE1B, "M", "غ"),
+        (0x1EE1C, "M", "ٮ"),
+        (0x1EE1D, "M", "ں"),
+        (0x1EE1E, "M", "ڡ"),
+        (0x1EE1F, "M", "ٯ"),
+        (0x1EE20, "X"),
+        (0x1EE21, "M", "ب"),
+        (0x1EE22, "M", "ج"),
+        (0x1EE23, "X"),
+        (0x1EE24, "M", "ه"),
+        (0x1EE25, "X"),
+        (0x1EE27, "M", "ح"),
+        (0x1EE28, "X"),
+        (0x1EE29, "M", "ي"),
+        (0x1EE2A, "M", "ك"),
+        (0x1EE2B, "M", "ل"),
+        (0x1EE2C, "M", "م"),
+        (0x1EE2D, "M", "ن"),
+        (0x1EE2E, "M", "س"),
+        (0x1EE2F, "M", "ع"),
+        (0x1EE30, "M", "ف"),
+        (0x1EE31, "M", "ص"),
+        (0x1EE32, "M", "ق"),
+        (0x1EE33, "X"),
+        (0x1EE34, "M", "ش"),
+        (0x1EE35, "M", "ت"),
+        (0x1EE36, "M", "ث"),
+        (0x1EE37, "M", "خ"),
+        (0x1EE38, "X"),
+        (0x1EE39, "M", "ض"),
+        (0x1EE3A, "X"),
+        (0x1EE3B, "M", "غ"),
+        (0x1EE3C, "X"),
+        (0x1EE42, "M", "ج"),
+        (0x1EE43, "X"),
+        (0x1EE47, "M", "ح"),
+        (0x1EE48, "X"),
+        (0x1EE49, "M", "ي"),
+        (0x1EE4A, "X"),
+        (0x1EE4B, "M", "ل"),
+        (0x1EE4C, "X"),
+        (0x1EE4D, "M", "ن"),
+        (0x1EE4E, "M", "س"),
     ]
 
+
 def _seg_73() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x1EE4F, 'M', 'ع'),
-    (0x1EE50, 'X'),
-    (0x1EE51, 'M', 'ص'),
-    (0x1EE52, 'M', 'ق'),
-    (0x1EE53, 'X'),
-    (0x1EE54, 'M', 'ش'),
-    (0x1EE55, 'X'),
-    (0x1EE57, 'M', 'خ'),
-    (0x1EE58, 'X'),
-    (0x1EE59, 'M', 'ض'),
-    (0x1EE5A, 'X'),
-    (0x1EE5B, 'M', 'غ'),
-    (0x1EE5C, 'X'),
-    (0x1EE5D, 'M', 'ں'),
-    (0x1EE5E, 'X'),
-    (0x1EE5F, 'M', 'ٯ'),
-    (0x1EE60, 'X'),
-    (0x1EE61, 'M', 'ب'),
-    (0x1EE62, 'M', 'ج'),
-    (0x1EE63, 'X'),
-    (0x1EE64, 'M', 'ه'),
-    (0x1EE65, 'X'),
-    (0x1EE67, 'M', 'ح'),
-    (0x1EE68, 'M', 'ط'),
-    (0x1EE69, 'M', 'ي'),
-    (0x1EE6A, 'M', 'ك'),
-    (0x1EE6B, 'X'),
-    (0x1EE6C, 'M', 'م'),
-    (0x1EE6D, 'M', 'ن'),
-    (0x1EE6E, 'M', 'س'),
-    (0x1EE6F, 'M', 'ع'),
-    (0x1EE70, 'M', 'ف'),
-    (0x1EE71, 'M', 'ص'),
-    (0x1EE72, 'M', 'ق'),
-    (0x1EE73, 'X'),
-    (0x1EE74, 'M', 'ش'),
-    (0x1EE75, 'M', 'ت'),
-    (0x1EE76, 'M', 'ث'),
-    (0x1EE77, 'M', 'خ'),
-    (0x1EE78, 'X'),
-    (0x1EE79, 'M', 'ض'),
-    (0x1EE7A, 'M', 'ظ'),
-    (0x1EE7B, 'M', 'غ'),
-    (0x1EE7C, 'M', 'ٮ'),
-    (0x1EE7D, 'X'),
-    (0x1EE7E, 'M', 'ڡ'),
-    (0x1EE7F, 'X'),
-    (0x1EE80, 'M', 'ا'),
-    (0x1EE81, 'M', 'ب'),
-    (0x1EE82, 'M', 'ج'),
-    (0x1EE83, 'M', 'د'),
-    (0x1EE84, 'M', 'ه'),
-    (0x1EE85, 'M', 'و'),
-    (0x1EE86, 'M', 'ز'),
-    (0x1EE87, 'M', 'ح'),
-    (0x1EE88, 'M', 'ط'),
-    (0x1EE89, 'M', 'ي'),
-    (0x1EE8A, 'X'),
-    (0x1EE8B, 'M', 'ل'),
-    (0x1EE8C, 'M', 'م'),
-    (0x1EE8D, 'M', 'ن'),
-    (0x1EE8E, 'M', 'س'),
-    (0x1EE8F, 'M', 'ع'),
-    (0x1EE90, 'M', 'ف'),
-    (0x1EE91, 'M', 'ص'),
-    (0x1EE92, 'M', 'ق'),
-    (0x1EE93, 'M', 'ر'),
-    (0x1EE94, 'M', 'ش'),
-    (0x1EE95, 'M', 'ت'),
-    (0x1EE96, 'M', 'ث'),
-    (0x1EE97, 'M', 'خ'),
-    (0x1EE98, 'M', 'ذ'),
-    (0x1EE99, 'M', 'ض'),
-    (0x1EE9A, 'M', 'ظ'),
-    (0x1EE9B, 'M', 'غ'),
-    (0x1EE9C, 'X'),
-    (0x1EEA1, 'M', 'ب'),
-    (0x1EEA2, 'M', 'ج'),
-    (0x1EEA3, 'M', 'د'),
-    (0x1EEA4, 'X'),
-    (0x1EEA5, 'M', 'و'),
-    (0x1EEA6, 'M', 'ز'),
-    (0x1EEA7, 'M', 'ح'),
-    (0x1EEA8, 'M', 'ط'),
-    (0x1EEA9, 'M', 'ي'),
-    (0x1EEAA, 'X'),
-    (0x1EEAB, 'M', 'ل'),
-    (0x1EEAC, 'M', 'م'),
-    (0x1EEAD, 'M', 'ن'),
-    (0x1EEAE, 'M', 'س'),
-    (0x1EEAF, 'M', 'ع'),
-    (0x1EEB0, 'M', 'ف'),
-    (0x1EEB1, 'M', 'ص'),
-    (0x1EEB2, 'M', 'ق'),
-    (0x1EEB3, 'M', 'ر'),
-    (0x1EEB4, 'M', 'ش'),
-    (0x1EEB5, 'M', 'ت'),
-    (0x1EEB6, 'M', 'ث'),
-    (0x1EEB7, 'M', 'خ'),
-    (0x1EEB8, 'M', 'ذ'),
+        (0x1EE4F, "M", "ع"),
+        (0x1EE50, "X"),
+        (0x1EE51, "M", "ص"),
+        (0x1EE52, "M", "ق"),
+        (0x1EE53, "X"),
+        (0x1EE54, "M", "ش"),
+        (0x1EE55, "X"),
+        (0x1EE57, "M", "خ"),
+        (0x1EE58, "X"),
+        (0x1EE59, "M", "ض"),
+        (0x1EE5A, "X"),
+        (0x1EE5B, "M", "غ"),
+        (0x1EE5C, "X"),
+        (0x1EE5D, "M", "ں"),
+        (0x1EE5E, "X"),
+        (0x1EE5F, "M", "ٯ"),
+        (0x1EE60, "X"),
+        (0x1EE61, "M", "ب"),
+        (0x1EE62, "M", "ج"),
+        (0x1EE63, "X"),
+        (0x1EE64, "M", "ه"),
+        (0x1EE65, "X"),
+        (0x1EE67, "M", "ح"),
+        (0x1EE68, "M", "ط"),
+        (0x1EE69, "M", "ي"),
+        (0x1EE6A, "M", "ك"),
+        (0x1EE6B, "X"),
+        (0x1EE6C, "M", "م"),
+        (0x1EE6D, "M", "ن"),
+        (0x1EE6E, "M", "س"),
+        (0x1EE6F, "M", "ع"),
+        (0x1EE70, "M", "ف"),
+        (0x1EE71, "M", "ص"),
+        (0x1EE72, "M", "ق"),
+        (0x1EE73, "X"),
+        (0x1EE74, "M", "ش"),
+        (0x1EE75, "M", "ت"),
+        (0x1EE76, "M", "ث"),
+        (0x1EE77, "M", "خ"),
+        (0x1EE78, "X"),
+        (0x1EE79, "M", "ض"),
+        (0x1EE7A, "M", "ظ"),
+        (0x1EE7B, "M", "غ"),
+        (0x1EE7C, "M", "ٮ"),
+        (0x1EE7D, "X"),
+        (0x1EE7E, "M", "ڡ"),
+        (0x1EE7F, "X"),
+        (0x1EE80, "M", "ا"),
+        (0x1EE81, "M", "ب"),
+        (0x1EE82, "M", "ج"),
+        (0x1EE83, "M", "د"),
+        (0x1EE84, "M", "ه"),
+        (0x1EE85, "M", "و"),
+        (0x1EE86, "M", "ز"),
+        (0x1EE87, "M", "ح"),
+        (0x1EE88, "M", "ط"),
+        (0x1EE89, "M", "ي"),
+        (0x1EE8A, "X"),
+        (0x1EE8B, "M", "ل"),
+        (0x1EE8C, "M", "م"),
+        (0x1EE8D, "M", "ن"),
+        (0x1EE8E, "M", "س"),
+        (0x1EE8F, "M", "ع"),
+        (0x1EE90, "M", "ف"),
+        (0x1EE91, "M", "ص"),
+        (0x1EE92, "M", "ق"),
+        (0x1EE93, "M", "ر"),
+        (0x1EE94, "M", "ش"),
+        (0x1EE95, "M", "ت"),
+        (0x1EE96, "M", "ث"),
+        (0x1EE97, "M", "خ"),
+        (0x1EE98, "M", "ذ"),
+        (0x1EE99, "M", "ض"),
+        (0x1EE9A, "M", "ظ"),
+        (0x1EE9B, "M", "غ"),
+        (0x1EE9C, "X"),
+        (0x1EEA1, "M", "ب"),
+        (0x1EEA2, "M", "ج"),
+        (0x1EEA3, "M", "د"),
+        (0x1EEA4, "X"),
+        (0x1EEA5, "M", "و"),
+        (0x1EEA6, "M", "ز"),
+        (0x1EEA7, "M", "ح"),
+        (0x1EEA8, "M", "ط"),
+        (0x1EEA9, "M", "ي"),
+        (0x1EEAA, "X"),
+        (0x1EEAB, "M", "ل"),
+        (0x1EEAC, "M", "م"),
+        (0x1EEAD, "M", "ن"),
+        (0x1EEAE, "M", "س"),
+        (0x1EEAF, "M", "ع"),
+        (0x1EEB0, "M", "ف"),
+        (0x1EEB1, "M", "ص"),
+        (0x1EEB2, "M", "ق"),
+        (0x1EEB3, "M", "ر"),
+        (0x1EEB4, "M", "ش"),
+        (0x1EEB5, "M", "ت"),
+        (0x1EEB6, "M", "ث"),
+        (0x1EEB7, "M", "خ"),
+        (0x1EEB8, "M", "ذ"),
     ]
 
+
 def _seg_74() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x1EEB9, 'M', 'ض'),
-    (0x1EEBA, 'M', 'ظ'),
-    (0x1EEBB, 'M', 'غ'),
-    (0x1EEBC, 'X'),
-    (0x1EEF0, 'V'),
-    (0x1EEF2, 'X'),
-    (0x1F000, 'V'),
-    (0x1F02C, 'X'),
-    (0x1F030, 'V'),
-    (0x1F094, 'X'),
-    (0x1F0A0, 'V'),
-    (0x1F0AF, 'X'),
-    (0x1F0B1, 'V'),
-    (0x1F0C0, 'X'),
-    (0x1F0C1, 'V'),
-    (0x1F0D0, 'X'),
-    (0x1F0D1, 'V'),
-    (0x1F0F6, 'X'),
-    (0x1F101, '3', '0,'),
-    (0x1F102, '3', '1,'),
-    (0x1F103, '3', '2,'),
-    (0x1F104, '3', '3,'),
-    (0x1F105, '3', '4,'),
-    (0x1F106, '3', '5,'),
-    (0x1F107, '3', '6,'),
-    (0x1F108, '3', '7,'),
-    (0x1F109, '3', '8,'),
-    (0x1F10A, '3', '9,'),
-    (0x1F10B, 'V'),
-    (0x1F110, '3', '(a)'),
-    (0x1F111, '3', '(b)'),
-    (0x1F112, '3', '(c)'),
-    (0x1F113, '3', '(d)'),
-    (0x1F114, '3', '(e)'),
-    (0x1F115, '3', '(f)'),
-    (0x1F116, '3', '(g)'),
-    (0x1F117, '3', '(h)'),
-    (0x1F118, '3', '(i)'),
-    (0x1F119, '3', '(j)'),
-    (0x1F11A, '3', '(k)'),
-    (0x1F11B, '3', '(l)'),
-    (0x1F11C, '3', '(m)'),
-    (0x1F11D, '3', '(n)'),
-    (0x1F11E, '3', '(o)'),
-    (0x1F11F, '3', '(p)'),
-    (0x1F120, '3', '(q)'),
-    (0x1F121, '3', '(r)'),
-    (0x1F122, '3', '(s)'),
-    (0x1F123, '3', '(t)'),
-    (0x1F124, '3', '(u)'),
-    (0x1F125, '3', '(v)'),
-    (0x1F126, '3', '(w)'),
-    (0x1F127, '3', '(x)'),
-    (0x1F128, '3', '(y)'),
-    (0x1F129, '3', '(z)'),
-    (0x1F12A, 'M', '〔s〕'),
-    (0x1F12B, 'M', 'c'),
-    (0x1F12C, 'M', 'r'),
-    (0x1F12D, 'M', 'cd'),
-    (0x1F12E, 'M', 'wz'),
-    (0x1F12F, 'V'),
-    (0x1F130, 'M', 'a'),
-    (0x1F131, 'M', 'b'),
-    (0x1F132, 'M', 'c'),
-    (0x1F133, 'M', 'd'),
-    (0x1F134, 'M', 'e'),
-    (0x1F135, 'M', 'f'),
-    (0x1F136, 'M', 'g'),
-    (0x1F137, 'M', 'h'),
-    (0x1F138, 'M', 'i'),
-    (0x1F139, 'M', 'j'),
-    (0x1F13A, 'M', 'k'),
-    (0x1F13B, 'M', 'l'),
-    (0x1F13C, 'M', 'm'),
-    (0x1F13D, 'M', 'n'),
-    (0x1F13E, 'M', 'o'),
-    (0x1F13F, 'M', 'p'),
-    (0x1F140, 'M', 'q'),
-    (0x1F141, 'M', 'r'),
-    (0x1F142, 'M', 's'),
-    (0x1F143, 'M', 't'),
-    (0x1F144, 'M', 'u'),
-    (0x1F145, 'M', 'v'),
-    (0x1F146, 'M', 'w'),
-    (0x1F147, 'M', 'x'),
-    (0x1F148, 'M', 'y'),
-    (0x1F149, 'M', 'z'),
-    (0x1F14A, 'M', 'hv'),
-    (0x1F14B, 'M', 'mv'),
-    (0x1F14C, 'M', 'sd'),
-    (0x1F14D, 'M', 'ss'),
-    (0x1F14E, 'M', 'ppv'),
-    (0x1F14F, 'M', 'wc'),
-    (0x1F150, 'V'),
-    (0x1F16A, 'M', 'mc'),
-    (0x1F16B, 'M', 'md'),
-    (0x1F16C, 'M', 'mr'),
-    (0x1F16D, 'V'),
-    (0x1F190, 'M', 'dj'),
-    (0x1F191, 'V'),
+        (0x1EEB9, "M", "ض"),
+        (0x1EEBA, "M", "ظ"),
+        (0x1EEBB, "M", "غ"),
+        (0x1EEBC, "X"),
+        (0x1EEF0, "V"),
+        (0x1EEF2, "X"),
+        (0x1F000, "V"),
+        (0x1F02C, "X"),
+        (0x1F030, "V"),
+        (0x1F094, "X"),
+        (0x1F0A0, "V"),
+        (0x1F0AF, "X"),
+        (0x1F0B1, "V"),
+        (0x1F0C0, "X"),
+        (0x1F0C1, "V"),
+        (0x1F0D0, "X"),
+        (0x1F0D1, "V"),
+        (0x1F0F6, "X"),
+        (0x1F101, "3", "0,"),
+        (0x1F102, "3", "1,"),
+        (0x1F103, "3", "2,"),
+        (0x1F104, "3", "3,"),
+        (0x1F105, "3", "4,"),
+        (0x1F106, "3", "5,"),
+        (0x1F107, "3", "6,"),
+        (0x1F108, "3", "7,"),
+        (0x1F109, "3", "8,"),
+        (0x1F10A, "3", "9,"),
+        (0x1F10B, "V"),
+        (0x1F110, "3", "(a)"),
+        (0x1F111, "3", "(b)"),
+        (0x1F112, "3", "(c)"),
+        (0x1F113, "3", "(d)"),
+        (0x1F114, "3", "(e)"),
+        (0x1F115, "3", "(f)"),
+        (0x1F116, "3", "(g)"),
+        (0x1F117, "3", "(h)"),
+        (0x1F118, "3", "(i)"),
+        (0x1F119, "3", "(j)"),
+        (0x1F11A, "3", "(k)"),
+        (0x1F11B, "3", "(l)"),
+        (0x1F11C, "3", "(m)"),
+        (0x1F11D, "3", "(n)"),
+        (0x1F11E, "3", "(o)"),
+        (0x1F11F, "3", "(p)"),
+        (0x1F120, "3", "(q)"),
+        (0x1F121, "3", "(r)"),
+        (0x1F122, "3", "(s)"),
+        (0x1F123, "3", "(t)"),
+        (0x1F124, "3", "(u)"),
+        (0x1F125, "3", "(v)"),
+        (0x1F126, "3", "(w)"),
+        (0x1F127, "3", "(x)"),
+        (0x1F128, "3", "(y)"),
+        (0x1F129, "3", "(z)"),
+        (0x1F12A, "M", "〔s〕"),
+        (0x1F12B, "M", "c"),
+        (0x1F12C, "M", "r"),
+        (0x1F12D, "M", "cd"),
+        (0x1F12E, "M", "wz"),
+        (0x1F12F, "V"),
+        (0x1F130, "M", "a"),
+        (0x1F131, "M", "b"),
+        (0x1F132, "M", "c"),
+        (0x1F133, "M", "d"),
+        (0x1F134, "M", "e"),
+        (0x1F135, "M", "f"),
+        (0x1F136, "M", "g"),
+        (0x1F137, "M", "h"),
+        (0x1F138, "M", "i"),
+        (0x1F139, "M", "j"),
+        (0x1F13A, "M", "k"),
+        (0x1F13B, "M", "l"),
+        (0x1F13C, "M", "m"),
+        (0x1F13D, "M", "n"),
+        (0x1F13E, "M", "o"),
+        (0x1F13F, "M", "p"),
+        (0x1F140, "M", "q"),
+        (0x1F141, "M", "r"),
+        (0x1F142, "M", "s"),
+        (0x1F143, "M", "t"),
+        (0x1F144, "M", "u"),
+        (0x1F145, "M", "v"),
+        (0x1F146, "M", "w"),
+        (0x1F147, "M", "x"),
+        (0x1F148, "M", "y"),
+        (0x1F149, "M", "z"),
+        (0x1F14A, "M", "hv"),
+        (0x1F14B, "M", "mv"),
+        (0x1F14C, "M", "sd"),
+        (0x1F14D, "M", "ss"),
+        (0x1F14E, "M", "ppv"),
+        (0x1F14F, "M", "wc"),
+        (0x1F150, "V"),
+        (0x1F16A, "M", "mc"),
+        (0x1F16B, "M", "md"),
+        (0x1F16C, "M", "mr"),
+        (0x1F16D, "V"),
+        (0x1F190, "M", "dj"),
+        (0x1F191, "V"),
     ]
 
+
 def _seg_75() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x1F1AE, 'X'),
-    (0x1F1E6, 'V'),
-    (0x1F200, 'M', 'ほか'),
-    (0x1F201, 'M', 'ココ'),
-    (0x1F202, 'M', 'サ'),
-    (0x1F203, 'X'),
-    (0x1F210, 'M', '手'),
-    (0x1F211, 'M', '字'),
-    (0x1F212, 'M', '双'),
-    (0x1F213, 'M', 'デ'),
-    (0x1F214, 'M', '二'),
-    (0x1F215, 'M', '多'),
-    (0x1F216, 'M', '解'),
-    (0x1F217, 'M', '天'),
-    (0x1F218, 'M', '交'),
-    (0x1F219, 'M', '映'),
-    (0x1F21A, 'M', '無'),
-    (0x1F21B, 'M', '料'),
-    (0x1F21C, 'M', '前'),
-    (0x1F21D, 'M', '後'),
-    (0x1F21E, 'M', '再'),
-    (0x1F21F, 'M', '新'),
-    (0x1F220, 'M', '初'),
-    (0x1F221, 'M', '終'),
-    (0x1F222, 'M', '生'),
-    (0x1F223, 'M', '販'),
-    (0x1F224, 'M', '声'),
-    (0x1F225, 'M', '吹'),
-    (0x1F226, 'M', '演'),
-    (0x1F227, 'M', '投'),
-    (0x1F228, 'M', '捕'),
-    (0x1F229, 'M', '一'),
-    (0x1F22A, 'M', '三'),
-    (0x1F22B, 'M', '遊'),
-    (0x1F22C, 'M', '左'),
-    (0x1F22D, 'M', '中'),
-    (0x1F22E, 'M', '右'),
-    (0x1F22F, 'M', '指'),
-    (0x1F230, 'M', '走'),
-    (0x1F231, 'M', '打'),
-    (0x1F232, 'M', '禁'),
-    (0x1F233, 'M', '空'),
-    (0x1F234, 'M', '合'),
-    (0x1F235, 'M', '満'),
-    (0x1F236, 'M', '有'),
-    (0x1F237, 'M', '月'),
-    (0x1F238, 'M', '申'),
-    (0x1F239, 'M', '割'),
-    (0x1F23A, 'M', '営'),
-    (0x1F23B, 'M', '配'),
-    (0x1F23C, 'X'),
-    (0x1F240, 'M', '〔本〕'),
-    (0x1F241, 'M', '〔三〕'),
-    (0x1F242, 'M', '〔二〕'),
-    (0x1F243, 'M', '〔安〕'),
-    (0x1F244, 'M', '〔点〕'),
-    (0x1F245, 'M', '〔打〕'),
-    (0x1F246, 'M', '〔盗〕'),
-    (0x1F247, 'M', '〔勝〕'),
-    (0x1F248, 'M', '〔敗〕'),
-    (0x1F249, 'X'),
-    (0x1F250, 'M', '得'),
-    (0x1F251, 'M', '可'),
-    (0x1F252, 'X'),
-    (0x1F260, 'V'),
-    (0x1F266, 'X'),
-    (0x1F300, 'V'),
-    (0x1F6D8, 'X'),
-    (0x1F6DC, 'V'),
-    (0x1F6ED, 'X'),
-    (0x1F6F0, 'V'),
-    (0x1F6FD, 'X'),
-    (0x1F700, 'V'),
-    (0x1F777, 'X'),
-    (0x1F77B, 'V'),
-    (0x1F7DA, 'X'),
-    (0x1F7E0, 'V'),
-    (0x1F7EC, 'X'),
-    (0x1F7F0, 'V'),
-    (0x1F7F1, 'X'),
-    (0x1F800, 'V'),
-    (0x1F80C, 'X'),
-    (0x1F810, 'V'),
-    (0x1F848, 'X'),
-    (0x1F850, 'V'),
-    (0x1F85A, 'X'),
-    (0x1F860, 'V'),
-    (0x1F888, 'X'),
-    (0x1F890, 'V'),
-    (0x1F8AE, 'X'),
-    (0x1F8B0, 'V'),
-    (0x1F8B2, 'X'),
-    (0x1F900, 'V'),
-    (0x1FA54, 'X'),
-    (0x1FA60, 'V'),
-    (0x1FA6E, 'X'),
-    (0x1FA70, 'V'),
-    (0x1FA7D, 'X'),
-    (0x1FA80, 'V'),
-    (0x1FA89, 'X'),
+        (0x1F1AE, "X"),
+        (0x1F1E6, "V"),
+        (0x1F200, "M", "ほか"),
+        (0x1F201, "M", "ココ"),
+        (0x1F202, "M", "サ"),
+        (0x1F203, "X"),
+        (0x1F210, "M", "手"),
+        (0x1F211, "M", "字"),
+        (0x1F212, "M", "双"),
+        (0x1F213, "M", "デ"),
+        (0x1F214, "M", "二"),
+        (0x1F215, "M", "多"),
+        (0x1F216, "M", "解"),
+        (0x1F217, "M", "天"),
+        (0x1F218, "M", "交"),
+        (0x1F219, "M", "映"),
+        (0x1F21A, "M", "無"),
+        (0x1F21B, "M", "料"),
+        (0x1F21C, "M", "前"),
+        (0x1F21D, "M", "後"),
+        (0x1F21E, "M", "再"),
+        (0x1F21F, "M", "新"),
+        (0x1F220, "M", "初"),
+        (0x1F221, "M", "終"),
+        (0x1F222, "M", "生"),
+        (0x1F223, "M", "販"),
+        (0x1F224, "M", "声"),
+        (0x1F225, "M", "吹"),
+        (0x1F226, "M", "演"),
+        (0x1F227, "M", "投"),
+        (0x1F228, "M", "捕"),
+        (0x1F229, "M", "一"),
+        (0x1F22A, "M", "三"),
+        (0x1F22B, "M", "遊"),
+        (0x1F22C, "M", "左"),
+        (0x1F22D, "M", "中"),
+        (0x1F22E, "M", "右"),
+        (0x1F22F, "M", "指"),
+        (0x1F230, "M", "走"),
+        (0x1F231, "M", "打"),
+        (0x1F232, "M", "禁"),
+        (0x1F233, "M", "空"),
+        (0x1F234, "M", "合"),
+        (0x1F235, "M", "満"),
+        (0x1F236, "M", "有"),
+        (0x1F237, "M", "月"),
+        (0x1F238, "M", "申"),
+        (0x1F239, "M", "割"),
+        (0x1F23A, "M", "営"),
+        (0x1F23B, "M", "配"),
+        (0x1F23C, "X"),
+        (0x1F240, "M", "〔本〕"),
+        (0x1F241, "M", "〔三〕"),
+        (0x1F242, "M", "〔二〕"),
+        (0x1F243, "M", "〔安〕"),
+        (0x1F244, "M", "〔点〕"),
+        (0x1F245, "M", "〔打〕"),
+        (0x1F246, "M", "〔盗〕"),
+        (0x1F247, "M", "〔勝〕"),
+        (0x1F248, "M", "〔敗〕"),
+        (0x1F249, "X"),
+        (0x1F250, "M", "得"),
+        (0x1F251, "M", "可"),
+        (0x1F252, "X"),
+        (0x1F260, "V"),
+        (0x1F266, "X"),
+        (0x1F300, "V"),
+        (0x1F6D8, "X"),
+        (0x1F6DC, "V"),
+        (0x1F6ED, "X"),
+        (0x1F6F0, "V"),
+        (0x1F6FD, "X"),
+        (0x1F700, "V"),
+        (0x1F777, "X"),
+        (0x1F77B, "V"),
+        (0x1F7DA, "X"),
+        (0x1F7E0, "V"),
+        (0x1F7EC, "X"),
+        (0x1F7F0, "V"),
+        (0x1F7F1, "X"),
+        (0x1F800, "V"),
+        (0x1F80C, "X"),
+        (0x1F810, "V"),
+        (0x1F848, "X"),
+        (0x1F850, "V"),
+        (0x1F85A, "X"),
+        (0x1F860, "V"),
+        (0x1F888, "X"),
+        (0x1F890, "V"),
+        (0x1F8AE, "X"),
+        (0x1F8B0, "V"),
+        (0x1F8B2, "X"),
+        (0x1F900, "V"),
+        (0x1FA54, "X"),
+        (0x1FA60, "V"),
+        (0x1FA6E, "X"),
+        (0x1FA70, "V"),
+        (0x1FA7D, "X"),
+        (0x1FA80, "V"),
+        (0x1FA89, "X"),
     ]
 
+
 def _seg_76() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x1FA90, 'V'),
-    (0x1FABE, 'X'),
-    (0x1FABF, 'V'),
-    (0x1FAC6, 'X'),
-    (0x1FACE, 'V'),
-    (0x1FADC, 'X'),
-    (0x1FAE0, 'V'),
-    (0x1FAE9, 'X'),
-    (0x1FAF0, 'V'),
-    (0x1FAF9, 'X'),
-    (0x1FB00, 'V'),
-    (0x1FB93, 'X'),
-    (0x1FB94, 'V'),
-    (0x1FBCB, 'X'),
-    (0x1FBF0, 'M', '0'),
-    (0x1FBF1, 'M', '1'),
-    (0x1FBF2, 'M', '2'),
-    (0x1FBF3, 'M', '3'),
-    (0x1FBF4, 'M', '4'),
-    (0x1FBF5, 'M', '5'),
-    (0x1FBF6, 'M', '6'),
-    (0x1FBF7, 'M', '7'),
-    (0x1FBF8, 'M', '8'),
-    (0x1FBF9, 'M', '9'),
-    (0x1FBFA, 'X'),
-    (0x20000, 'V'),
-    (0x2A6E0, 'X'),
-    (0x2A700, 'V'),
-    (0x2B73A, 'X'),
-    (0x2B740, 'V'),
-    (0x2B81E, 'X'),
-    (0x2B820, 'V'),
-    (0x2CEA2, 'X'),
-    (0x2CEB0, 'V'),
-    (0x2EBE1, 'X'),
-    (0x2EBF0, 'V'),
-    (0x2EE5E, 'X'),
-    (0x2F800, 'M', '丽'),
-    (0x2F801, 'M', '丸'),
-    (0x2F802, 'M', '乁'),
-    (0x2F803, 'M', '𠄢'),
-    (0x2F804, 'M', '你'),
-    (0x2F805, 'M', '侮'),
-    (0x2F806, 'M', '侻'),
-    (0x2F807, 'M', '倂'),
-    (0x2F808, 'M', '偺'),
-    (0x2F809, 'M', '備'),
-    (0x2F80A, 'M', '僧'),
-    (0x2F80B, 'M', '像'),
-    (0x2F80C, 'M', '㒞'),
-    (0x2F80D, 'M', '𠘺'),
-    (0x2F80E, 'M', '免'),
-    (0x2F80F, 'M', '兔'),
-    (0x2F810, 'M', '兤'),
-    (0x2F811, 'M', '具'),
-    (0x2F812, 'M', '𠔜'),
-    (0x2F813, 'M', '㒹'),
-    (0x2F814, 'M', '內'),
-    (0x2F815, 'M', '再'),
-    (0x2F816, 'M', '𠕋'),
-    (0x2F817, 'M', '冗'),
-    (0x2F818, 'M', '冤'),
-    (0x2F819, 'M', '仌'),
-    (0x2F81A, 'M', '冬'),
-    (0x2F81B, 'M', '况'),
-    (0x2F81C, 'M', '𩇟'),
-    (0x2F81D, 'M', '凵'),
-    (0x2F81E, 'M', '刃'),
-    (0x2F81F, 'M', '㓟'),
-    (0x2F820, 'M', '刻'),
-    (0x2F821, 'M', '剆'),
-    (0x2F822, 'M', '割'),
-    (0x2F823, 'M', '剷'),
-    (0x2F824, 'M', '㔕'),
-    (0x2F825, 'M', '勇'),
-    (0x2F826, 'M', '勉'),
-    (0x2F827, 'M', '勤'),
-    (0x2F828, 'M', '勺'),
-    (0x2F829, 'M', '包'),
-    (0x2F82A, 'M', '匆'),
-    (0x2F82B, 'M', '北'),
-    (0x2F82C, 'M', '卉'),
-    (0x2F82D, 'M', '卑'),
-    (0x2F82E, 'M', '博'),
-    (0x2F82F, 'M', '即'),
-    (0x2F830, 'M', '卽'),
-    (0x2F831, 'M', '卿'),
-    (0x2F834, 'M', '𠨬'),
-    (0x2F835, 'M', '灰'),
-    (0x2F836, 'M', '及'),
-    (0x2F837, 'M', '叟'),
-    (0x2F838, 'M', '𠭣'),
-    (0x2F839, 'M', '叫'),
-    (0x2F83A, 'M', '叱'),
-    (0x2F83B, 'M', '吆'),
-    (0x2F83C, 'M', '咞'),
-    (0x2F83D, 'M', '吸'),
-    (0x2F83E, 'M', '呈'),
-    (0x2F83F, 'M', '周'),
-    (0x2F840, 'M', '咢'),
+        (0x1FA90, "V"),
+        (0x1FABE, "X"),
+        (0x1FABF, "V"),
+        (0x1FAC6, "X"),
+        (0x1FACE, "V"),
+        (0x1FADC, "X"),
+        (0x1FAE0, "V"),
+        (0x1FAE9, "X"),
+        (0x1FAF0, "V"),
+        (0x1FAF9, "X"),
+        (0x1FB00, "V"),
+        (0x1FB93, "X"),
+        (0x1FB94, "V"),
+        (0x1FBCB, "X"),
+        (0x1FBF0, "M", "0"),
+        (0x1FBF1, "M", "1"),
+        (0x1FBF2, "M", "2"),
+        (0x1FBF3, "M", "3"),
+        (0x1FBF4, "M", "4"),
+        (0x1FBF5, "M", "5"),
+        (0x1FBF6, "M", "6"),
+        (0x1FBF7, "M", "7"),
+        (0x1FBF8, "M", "8"),
+        (0x1FBF9, "M", "9"),
+        (0x1FBFA, "X"),
+        (0x20000, "V"),
+        (0x2A6E0, "X"),
+        (0x2A700, "V"),
+        (0x2B73A, "X"),
+        (0x2B740, "V"),
+        (0x2B81E, "X"),
+        (0x2B820, "V"),
+        (0x2CEA2, "X"),
+        (0x2CEB0, "V"),
+        (0x2EBE1, "X"),
+        (0x2EBF0, "V"),
+        (0x2EE5E, "X"),
+        (0x2F800, "M", "丽"),
+        (0x2F801, "M", "丸"),
+        (0x2F802, "M", "乁"),
+        (0x2F803, "M", "𠄢"),
+        (0x2F804, "M", "你"),
+        (0x2F805, "M", "侮"),
+        (0x2F806, "M", "侻"),
+        (0x2F807, "M", "倂"),
+        (0x2F808, "M", "偺"),
+        (0x2F809, "M", "備"),
+        (0x2F80A, "M", "僧"),
+        (0x2F80B, "M", "像"),
+        (0x2F80C, "M", "㒞"),
+        (0x2F80D, "M", "𠘺"),
+        (0x2F80E, "M", "免"),
+        (0x2F80F, "M", "兔"),
+        (0x2F810, "M", "兤"),
+        (0x2F811, "M", "具"),
+        (0x2F812, "M", "𠔜"),
+        (0x2F813, "M", "㒹"),
+        (0x2F814, "M", "內"),
+        (0x2F815, "M", "再"),
+        (0x2F816, "M", "𠕋"),
+        (0x2F817, "M", "冗"),
+        (0x2F818, "M", "冤"),
+        (0x2F819, "M", "仌"),
+        (0x2F81A, "M", "冬"),
+        (0x2F81B, "M", "况"),
+        (0x2F81C, "M", "𩇟"),
+        (0x2F81D, "M", "凵"),
+        (0x2F81E, "M", "刃"),
+        (0x2F81F, "M", "㓟"),
+        (0x2F820, "M", "刻"),
+        (0x2F821, "M", "剆"),
+        (0x2F822, "M", "割"),
+        (0x2F823, "M", "剷"),
+        (0x2F824, "M", "㔕"),
+        (0x2F825, "M", "勇"),
+        (0x2F826, "M", "勉"),
+        (0x2F827, "M", "勤"),
+        (0x2F828, "M", "勺"),
+        (0x2F829, "M", "包"),
+        (0x2F82A, "M", "匆"),
+        (0x2F82B, "M", "北"),
+        (0x2F82C, "M", "卉"),
+        (0x2F82D, "M", "卑"),
+        (0x2F82E, "M", "博"),
+        (0x2F82F, "M", "即"),
+        (0x2F830, "M", "卽"),
+        (0x2F831, "M", "卿"),
+        (0x2F834, "M", "𠨬"),
+        (0x2F835, "M", "灰"),
+        (0x2F836, "M", "及"),
+        (0x2F837, "M", "叟"),
+        (0x2F838, "M", "𠭣"),
+        (0x2F839, "M", "叫"),
+        (0x2F83A, "M", "叱"),
+        (0x2F83B, "M", "吆"),
+        (0x2F83C, "M", "咞"),
+        (0x2F83D, "M", "吸"),
+        (0x2F83E, "M", "呈"),
+        (0x2F83F, "M", "周"),
+        (0x2F840, "M", "咢"),
     ]
 
+
 def _seg_77() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x2F841, 'M', '哶'),
-    (0x2F842, 'M', '唐'),
-    (0x2F843, 'M', '啓'),
-    (0x2F844, 'M', '啣'),
-    (0x2F845, 'M', '善'),
-    (0x2F847, 'M', '喙'),
-    (0x2F848, 'M', '喫'),
-    (0x2F849, 'M', '喳'),
-    (0x2F84A, 'M', '嗂'),
-    (0x2F84B, 'M', '圖'),
-    (0x2F84C, 'M', '嘆'),
-    (0x2F84D, 'M', '圗'),
-    (0x2F84E, 'M', '噑'),
-    (0x2F84F, 'M', '噴'),
-    (0x2F850, 'M', '切'),
-    (0x2F851, 'M', '壮'),
-    (0x2F852, 'M', '城'),
-    (0x2F853, 'M', '埴'),
-    (0x2F854, 'M', '堍'),
-    (0x2F855, 'M', '型'),
-    (0x2F856, 'M', '堲'),
-    (0x2F857, 'M', '報'),
-    (0x2F858, 'M', '墬'),
-    (0x2F859, 'M', '𡓤'),
-    (0x2F85A, 'M', '売'),
-    (0x2F85B, 'M', '壷'),
-    (0x2F85C, 'M', '夆'),
-    (0x2F85D, 'M', '多'),
-    (0x2F85E, 'M', '夢'),
-    (0x2F85F, 'M', '奢'),
-    (0x2F860, 'M', '𡚨'),
-    (0x2F861, 'M', '𡛪'),
-    (0x2F862, 'M', '姬'),
-    (0x2F863, 'M', '娛'),
-    (0x2F864, 'M', '娧'),
-    (0x2F865, 'M', '姘'),
-    (0x2F866, 'M', '婦'),
-    (0x2F867, 'M', '㛮'),
-    (0x2F868, 'X'),
-    (0x2F869, 'M', '嬈'),
-    (0x2F86A, 'M', '嬾'),
-    (0x2F86C, 'M', '𡧈'),
-    (0x2F86D, 'M', '寃'),
-    (0x2F86E, 'M', '寘'),
-    (0x2F86F, 'M', '寧'),
-    (0x2F870, 'M', '寳'),
-    (0x2F871, 'M', '𡬘'),
-    (0x2F872, 'M', '寿'),
-    (0x2F873, 'M', '将'),
-    (0x2F874, 'X'),
-    (0x2F875, 'M', '尢'),
-    (0x2F876, 'M', '㞁'),
-    (0x2F877, 'M', '屠'),
-    (0x2F878, 'M', '屮'),
-    (0x2F879, 'M', '峀'),
-    (0x2F87A, 'M', '岍'),
-    (0x2F87B, 'M', '𡷤'),
-    (0x2F87C, 'M', '嵃'),
-    (0x2F87D, 'M', '𡷦'),
-    (0x2F87E, 'M', '嵮'),
-    (0x2F87F, 'M', '嵫'),
-    (0x2F880, 'M', '嵼'),
-    (0x2F881, 'M', '巡'),
-    (0x2F882, 'M', '巢'),
-    (0x2F883, 'M', '㠯'),
-    (0x2F884, 'M', '巽'),
-    (0x2F885, 'M', '帨'),
-    (0x2F886, 'M', '帽'),
-    (0x2F887, 'M', '幩'),
-    (0x2F888, 'M', '㡢'),
-    (0x2F889, 'M', '𢆃'),
-    (0x2F88A, 'M', '㡼'),
-    (0x2F88B, 'M', '庰'),
-    (0x2F88C, 'M', '庳'),
-    (0x2F88D, 'M', '庶'),
-    (0x2F88E, 'M', '廊'),
-    (0x2F88F, 'M', '𪎒'),
-    (0x2F890, 'M', '廾'),
-    (0x2F891, 'M', '𢌱'),
-    (0x2F893, 'M', '舁'),
-    (0x2F894, 'M', '弢'),
-    (0x2F896, 'M', '㣇'),
-    (0x2F897, 'M', '𣊸'),
-    (0x2F898, 'M', '𦇚'),
-    (0x2F899, 'M', '形'),
-    (0x2F89A, 'M', '彫'),
-    (0x2F89B, 'M', '㣣'),
-    (0x2F89C, 'M', '徚'),
-    (0x2F89D, 'M', '忍'),
-    (0x2F89E, 'M', '志'),
-    (0x2F89F, 'M', '忹'),
-    (0x2F8A0, 'M', '悁'),
-    (0x2F8A1, 'M', '㤺'),
-    (0x2F8A2, 'M', '㤜'),
-    (0x2F8A3, 'M', '悔'),
-    (0x2F8A4, 'M', '𢛔'),
-    (0x2F8A5, 'M', '惇'),
-    (0x2F8A6, 'M', '慈'),
-    (0x2F8A7, 'M', '慌'),
-    (0x2F8A8, 'M', '慎'),
+        (0x2F841, "M", "哶"),
+        (0x2F842, "M", "唐"),
+        (0x2F843, "M", "啓"),
+        (0x2F844, "M", "啣"),
+        (0x2F845, "M", "善"),
+        (0x2F847, "M", "喙"),
+        (0x2F848, "M", "喫"),
+        (0x2F849, "M", "喳"),
+        (0x2F84A, "M", "嗂"),
+        (0x2F84B, "M", "圖"),
+        (0x2F84C, "M", "嘆"),
+        (0x2F84D, "M", "圗"),
+        (0x2F84E, "M", "噑"),
+        (0x2F84F, "M", "噴"),
+        (0x2F850, "M", "切"),
+        (0x2F851, "M", "壮"),
+        (0x2F852, "M", "城"),
+        (0x2F853, "M", "埴"),
+        (0x2F854, "M", "堍"),
+        (0x2F855, "M", "型"),
+        (0x2F856, "M", "堲"),
+        (0x2F857, "M", "報"),
+        (0x2F858, "M", "墬"),
+        (0x2F859, "M", "𡓤"),
+        (0x2F85A, "M", "売"),
+        (0x2F85B, "M", "壷"),
+        (0x2F85C, "M", "夆"),
+        (0x2F85D, "M", "多"),
+        (0x2F85E, "M", "夢"),
+        (0x2F85F, "M", "奢"),
+        (0x2F860, "M", "𡚨"),
+        (0x2F861, "M", "𡛪"),
+        (0x2F862, "M", "姬"),
+        (0x2F863, "M", "娛"),
+        (0x2F864, "M", "娧"),
+        (0x2F865, "M", "姘"),
+        (0x2F866, "M", "婦"),
+        (0x2F867, "M", "㛮"),
+        (0x2F868, "X"),
+        (0x2F869, "M", "嬈"),
+        (0x2F86A, "M", "嬾"),
+        (0x2F86C, "M", "𡧈"),
+        (0x2F86D, "M", "寃"),
+        (0x2F86E, "M", "寘"),
+        (0x2F86F, "M", "寧"),
+        (0x2F870, "M", "寳"),
+        (0x2F871, "M", "𡬘"),
+        (0x2F872, "M", "寿"),
+        (0x2F873, "M", "将"),
+        (0x2F874, "X"),
+        (0x2F875, "M", "尢"),
+        (0x2F876, "M", "㞁"),
+        (0x2F877, "M", "屠"),
+        (0x2F878, "M", "屮"),
+        (0x2F879, "M", "峀"),
+        (0x2F87A, "M", "岍"),
+        (0x2F87B, "M", "𡷤"),
+        (0x2F87C, "M", "嵃"),
+        (0x2F87D, "M", "𡷦"),
+        (0x2F87E, "M", "嵮"),
+        (0x2F87F, "M", "嵫"),
+        (0x2F880, "M", "嵼"),
+        (0x2F881, "M", "巡"),
+        (0x2F882, "M", "巢"),
+        (0x2F883, "M", "㠯"),
+        (0x2F884, "M", "巽"),
+        (0x2F885, "M", "帨"),
+        (0x2F886, "M", "帽"),
+        (0x2F887, "M", "幩"),
+        (0x2F888, "M", "㡢"),
+        (0x2F889, "M", "𢆃"),
+        (0x2F88A, "M", "㡼"),
+        (0x2F88B, "M", "庰"),
+        (0x2F88C, "M", "庳"),
+        (0x2F88D, "M", "庶"),
+        (0x2F88E, "M", "廊"),
+        (0x2F88F, "M", "𪎒"),
+        (0x2F890, "M", "廾"),
+        (0x2F891, "M", "𢌱"),
+        (0x2F893, "M", "舁"),
+        (0x2F894, "M", "弢"),
+        (0x2F896, "M", "㣇"),
+        (0x2F897, "M", "𣊸"),
+        (0x2F898, "M", "𦇚"),
+        (0x2F899, "M", "形"),
+        (0x2F89A, "M", "彫"),
+        (0x2F89B, "M", "㣣"),
+        (0x2F89C, "M", "徚"),
+        (0x2F89D, "M", "忍"),
+        (0x2F89E, "M", "志"),
+        (0x2F89F, "M", "忹"),
+        (0x2F8A0, "M", "悁"),
+        (0x2F8A1, "M", "㤺"),
+        (0x2F8A2, "M", "㤜"),
+        (0x2F8A3, "M", "悔"),
+        (0x2F8A4, "M", "𢛔"),
+        (0x2F8A5, "M", "惇"),
+        (0x2F8A6, "M", "慈"),
+        (0x2F8A7, "M", "慌"),
+        (0x2F8A8, "M", "慎"),
     ]
 
+
 def _seg_78() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x2F8A9, 'M', '慌'),
-    (0x2F8AA, 'M', '慺'),
-    (0x2F8AB, 'M', '憎'),
-    (0x2F8AC, 'M', '憲'),
-    (0x2F8AD, 'M', '憤'),
-    (0x2F8AE, 'M', '憯'),
-    (0x2F8AF, 'M', '懞'),
-    (0x2F8B0, 'M', '懲'),
-    (0x2F8B1, 'M', '懶'),
-    (0x2F8B2, 'M', '成'),
-    (0x2F8B3, 'M', '戛'),
-    (0x2F8B4, 'M', '扝'),
-    (0x2F8B5, 'M', '抱'),
-    (0x2F8B6, 'M', '拔'),
-    (0x2F8B7, 'M', '捐'),
-    (0x2F8B8, 'M', '𢬌'),
-    (0x2F8B9, 'M', '挽'),
-    (0x2F8BA, 'M', '拼'),
-    (0x2F8BB, 'M', '捨'),
-    (0x2F8BC, 'M', '掃'),
-    (0x2F8BD, 'M', '揤'),
-    (0x2F8BE, 'M', '𢯱'),
-    (0x2F8BF, 'M', '搢'),
-    (0x2F8C0, 'M', '揅'),
-    (0x2F8C1, 'M', '掩'),
-    (0x2F8C2, 'M', '㨮'),
-    (0x2F8C3, 'M', '摩'),
-    (0x2F8C4, 'M', '摾'),
-    (0x2F8C5, 'M', '撝'),
-    (0x2F8C6, 'M', '摷'),
-    (0x2F8C7, 'M', '㩬'),
-    (0x2F8C8, 'M', '敏'),
-    (0x2F8C9, 'M', '敬'),
-    (0x2F8CA, 'M', '𣀊'),
-    (0x2F8CB, 'M', '旣'),
-    (0x2F8CC, 'M', '書'),
-    (0x2F8CD, 'M', '晉'),
-    (0x2F8CE, 'M', '㬙'),
-    (0x2F8CF, 'M', '暑'),
-    (0x2F8D0, 'M', '㬈'),
-    (0x2F8D1, 'M', '㫤'),
-    (0x2F8D2, 'M', '冒'),
-    (0x2F8D3, 'M', '冕'),
-    (0x2F8D4, 'M', '最'),
-    (0x2F8D5, 'M', '暜'),
-    (0x2F8D6, 'M', '肭'),
-    (0x2F8D7, 'M', '䏙'),
-    (0x2F8D8, 'M', '朗'),
-    (0x2F8D9, 'M', '望'),
-    (0x2F8DA, 'M', '朡'),
-    (0x2F8DB, 'M', '杞'),
-    (0x2F8DC, 'M', '杓'),
-    (0x2F8DD, 'M', '𣏃'),
-    (0x2F8DE, 'M', '㭉'),
-    (0x2F8DF, 'M', '柺'),
-    (0x2F8E0, 'M', '枅'),
-    (0x2F8E1, 'M', '桒'),
-    (0x2F8E2, 'M', '梅'),
-    (0x2F8E3, 'M', '𣑭'),
-    (0x2F8E4, 'M', '梎'),
-    (0x2F8E5, 'M', '栟'),
-    (0x2F8E6, 'M', '椔'),
-    (0x2F8E7, 'M', '㮝'),
-    (0x2F8E8, 'M', '楂'),
-    (0x2F8E9, 'M', '榣'),
-    (0x2F8EA, 'M', '槪'),
-    (0x2F8EB, 'M', '檨'),
-    (0x2F8EC, 'M', '𣚣'),
-    (0x2F8ED, 'M', '櫛'),
-    (0x2F8EE, 'M', '㰘'),
-    (0x2F8EF, 'M', '次'),
-    (0x2F8F0, 'M', '𣢧'),
-    (0x2F8F1, 'M', '歔'),
-    (0x2F8F2, 'M', '㱎'),
-    (0x2F8F3, 'M', '歲'),
-    (0x2F8F4, 'M', '殟'),
-    (0x2F8F5, 'M', '殺'),
-    (0x2F8F6, 'M', '殻'),
-    (0x2F8F7, 'M', '𣪍'),
-    (0x2F8F8, 'M', '𡴋'),
-    (0x2F8F9, 'M', '𣫺'),
-    (0x2F8FA, 'M', '汎'),
-    (0x2F8FB, 'M', '𣲼'),
-    (0x2F8FC, 'M', '沿'),
-    (0x2F8FD, 'M', '泍'),
-    (0x2F8FE, 'M', '汧'),
-    (0x2F8FF, 'M', '洖'),
-    (0x2F900, 'M', '派'),
-    (0x2F901, 'M', '海'),
-    (0x2F902, 'M', '流'),
-    (0x2F903, 'M', '浩'),
-    (0x2F904, 'M', '浸'),
-    (0x2F905, 'M', '涅'),
-    (0x2F906, 'M', '𣴞'),
-    (0x2F907, 'M', '洴'),
-    (0x2F908, 'M', '港'),
-    (0x2F909, 'M', '湮'),
-    (0x2F90A, 'M', '㴳'),
-    (0x2F90B, 'M', '滋'),
-    (0x2F90C, 'M', '滇'),
+        (0x2F8A9, "M", "慌"),
+        (0x2F8AA, "M", "慺"),
+        (0x2F8AB, "M", "憎"),
+        (0x2F8AC, "M", "憲"),
+        (0x2F8AD, "M", "憤"),
+        (0x2F8AE, "M", "憯"),
+        (0x2F8AF, "M", "懞"),
+        (0x2F8B0, "M", "懲"),
+        (0x2F8B1, "M", "懶"),
+        (0x2F8B2, "M", "成"),
+        (0x2F8B3, "M", "戛"),
+        (0x2F8B4, "M", "扝"),
+        (0x2F8B5, "M", "抱"),
+        (0x2F8B6, "M", "拔"),
+        (0x2F8B7, "M", "捐"),
+        (0x2F8B8, "M", "𢬌"),
+        (0x2F8B9, "M", "挽"),
+        (0x2F8BA, "M", "拼"),
+        (0x2F8BB, "M", "捨"),
+        (0x2F8BC, "M", "掃"),
+        (0x2F8BD, "M", "揤"),
+        (0x2F8BE, "M", "𢯱"),
+        (0x2F8BF, "M", "搢"),
+        (0x2F8C0, "M", "揅"),
+        (0x2F8C1, "M", "掩"),
+        (0x2F8C2, "M", "㨮"),
+        (0x2F8C3, "M", "摩"),
+        (0x2F8C4, "M", "摾"),
+        (0x2F8C5, "M", "撝"),
+        (0x2F8C6, "M", "摷"),
+        (0x2F8C7, "M", "㩬"),
+        (0x2F8C8, "M", "敏"),
+        (0x2F8C9, "M", "敬"),
+        (0x2F8CA, "M", "𣀊"),
+        (0x2F8CB, "M", "旣"),
+        (0x2F8CC, "M", "書"),
+        (0x2F8CD, "M", "晉"),
+        (0x2F8CE, "M", "㬙"),
+        (0x2F8CF, "M", "暑"),
+        (0x2F8D0, "M", "㬈"),
+        (0x2F8D1, "M", "㫤"),
+        (0x2F8D2, "M", "冒"),
+        (0x2F8D3, "M", "冕"),
+        (0x2F8D4, "M", "最"),
+        (0x2F8D5, "M", "暜"),
+        (0x2F8D6, "M", "肭"),
+        (0x2F8D7, "M", "䏙"),
+        (0x2F8D8, "M", "朗"),
+        (0x2F8D9, "M", "望"),
+        (0x2F8DA, "M", "朡"),
+        (0x2F8DB, "M", "杞"),
+        (0x2F8DC, "M", "杓"),
+        (0x2F8DD, "M", "𣏃"),
+        (0x2F8DE, "M", "㭉"),
+        (0x2F8DF, "M", "柺"),
+        (0x2F8E0, "M", "枅"),
+        (0x2F8E1, "M", "桒"),
+        (0x2F8E2, "M", "梅"),
+        (0x2F8E3, "M", "𣑭"),
+        (0x2F8E4, "M", "梎"),
+        (0x2F8E5, "M", "栟"),
+        (0x2F8E6, "M", "椔"),
+        (0x2F8E7, "M", "㮝"),
+        (0x2F8E8, "M", "楂"),
+        (0x2F8E9, "M", "榣"),
+        (0x2F8EA, "M", "槪"),
+        (0x2F8EB, "M", "檨"),
+        (0x2F8EC, "M", "𣚣"),
+        (0x2F8ED, "M", "櫛"),
+        (0x2F8EE, "M", "㰘"),
+        (0x2F8EF, "M", "次"),
+        (0x2F8F0, "M", "𣢧"),
+        (0x2F8F1, "M", "歔"),
+        (0x2F8F2, "M", "㱎"),
+        (0x2F8F3, "M", "歲"),
+        (0x2F8F4, "M", "殟"),
+        (0x2F8F5, "M", "殺"),
+        (0x2F8F6, "M", "殻"),
+        (0x2F8F7, "M", "𣪍"),
+        (0x2F8F8, "M", "𡴋"),
+        (0x2F8F9, "M", "𣫺"),
+        (0x2F8FA, "M", "汎"),
+        (0x2F8FB, "M", "𣲼"),
+        (0x2F8FC, "M", "沿"),
+        (0x2F8FD, "M", "泍"),
+        (0x2F8FE, "M", "汧"),
+        (0x2F8FF, "M", "洖"),
+        (0x2F900, "M", "派"),
+        (0x2F901, "M", "海"),
+        (0x2F902, "M", "流"),
+        (0x2F903, "M", "浩"),
+        (0x2F904, "M", "浸"),
+        (0x2F905, "M", "涅"),
+        (0x2F906, "M", "𣴞"),
+        (0x2F907, "M", "洴"),
+        (0x2F908, "M", "港"),
+        (0x2F909, "M", "湮"),
+        (0x2F90A, "M", "㴳"),
+        (0x2F90B, "M", "滋"),
+        (0x2F90C, "M", "滇"),
     ]
 
+
 def _seg_79() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x2F90D, 'M', '𣻑'),
-    (0x2F90E, 'M', '淹'),
-    (0x2F90F, 'M', '潮'),
-    (0x2F910, 'M', '𣽞'),
-    (0x2F911, 'M', '𣾎'),
-    (0x2F912, 'M', '濆'),
-    (0x2F913, 'M', '瀹'),
-    (0x2F914, 'M', '瀞'),
-    (0x2F915, 'M', '瀛'),
-    (0x2F916, 'M', '㶖'),
-    (0x2F917, 'M', '灊'),
-    (0x2F918, 'M', '災'),
-    (0x2F919, 'M', '灷'),
-    (0x2F91A, 'M', '炭'),
-    (0x2F91B, 'M', '𠔥'),
-    (0x2F91C, 'M', '煅'),
-    (0x2F91D, 'M', '𤉣'),
-    (0x2F91E, 'M', '熜'),
-    (0x2F91F, 'X'),
-    (0x2F920, 'M', '爨'),
-    (0x2F921, 'M', '爵'),
-    (0x2F922, 'M', '牐'),
-    (0x2F923, 'M', '𤘈'),
-    (0x2F924, 'M', '犀'),
-    (0x2F925, 'M', '犕'),
-    (0x2F926, 'M', '𤜵'),
-    (0x2F927, 'M', '𤠔'),
-    (0x2F928, 'M', '獺'),
-    (0x2F929, 'M', '王'),
-    (0x2F92A, 'M', '㺬'),
-    (0x2F92B, 'M', '玥'),
-    (0x2F92C, 'M', '㺸'),
-    (0x2F92E, 'M', '瑇'),
-    (0x2F92F, 'M', '瑜'),
-    (0x2F930, 'M', '瑱'),
-    (0x2F931, 'M', '璅'),
-    (0x2F932, 'M', '瓊'),
-    (0x2F933, 'M', '㼛'),
-    (0x2F934, 'M', '甤'),
-    (0x2F935, 'M', '𤰶'),
-    (0x2F936, 'M', '甾'),
-    (0x2F937, 'M', '𤲒'),
-    (0x2F938, 'M', '異'),
-    (0x2F939, 'M', '𢆟'),
-    (0x2F93A, 'M', '瘐'),
-    (0x2F93B, 'M', '𤾡'),
-    (0x2F93C, 'M', '𤾸'),
-    (0x2F93D, 'M', '𥁄'),
-    (0x2F93E, 'M', '㿼'),
-    (0x2F93F, 'M', '䀈'),
-    (0x2F940, 'M', '直'),
-    (0x2F941, 'M', '𥃳'),
-    (0x2F942, 'M', '𥃲'),
-    (0x2F943, 'M', '𥄙'),
-    (0x2F944, 'M', '𥄳'),
-    (0x2F945, 'M', '眞'),
-    (0x2F946, 'M', '真'),
-    (0x2F948, 'M', '睊'),
-    (0x2F949, 'M', '䀹'),
-    (0x2F94A, 'M', '瞋'),
-    (0x2F94B, 'M', '䁆'),
-    (0x2F94C, 'M', '䂖'),
-    (0x2F94D, 'M', '𥐝'),
-    (0x2F94E, 'M', '硎'),
-    (0x2F94F, 'M', '碌'),
-    (0x2F950, 'M', '磌'),
-    (0x2F951, 'M', '䃣'),
-    (0x2F952, 'M', '𥘦'),
-    (0x2F953, 'M', '祖'),
-    (0x2F954, 'M', '𥚚'),
-    (0x2F955, 'M', '𥛅'),
-    (0x2F956, 'M', '福'),
-    (0x2F957, 'M', '秫'),
-    (0x2F958, 'M', '䄯'),
-    (0x2F959, 'M', '穀'),
-    (0x2F95A, 'M', '穊'),
-    (0x2F95B, 'M', '穏'),
-    (0x2F95C, 'M', '𥥼'),
-    (0x2F95D, 'M', '𥪧'),
-    (0x2F95F, 'X'),
-    (0x2F960, 'M', '䈂'),
-    (0x2F961, 'M', '𥮫'),
-    (0x2F962, 'M', '篆'),
-    (0x2F963, 'M', '築'),
-    (0x2F964, 'M', '䈧'),
-    (0x2F965, 'M', '𥲀'),
-    (0x2F966, 'M', '糒'),
-    (0x2F967, 'M', '䊠'),
-    (0x2F968, 'M', '糨'),
-    (0x2F969, 'M', '糣'),
-    (0x2F96A, 'M', '紀'),
-    (0x2F96B, 'M', '𥾆'),
-    (0x2F96C, 'M', '絣'),
-    (0x2F96D, 'M', '䌁'),
-    (0x2F96E, 'M', '緇'),
-    (0x2F96F, 'M', '縂'),
-    (0x2F970, 'M', '繅'),
-    (0x2F971, 'M', '䌴'),
-    (0x2F972, 'M', '𦈨'),
-    (0x2F973, 'M', '𦉇'),
+        (0x2F90D, "M", "𣻑"),
+        (0x2F90E, "M", "淹"),
+        (0x2F90F, "M", "潮"),
+        (0x2F910, "M", "𣽞"),
+        (0x2F911, "M", "𣾎"),
+        (0x2F912, "M", "濆"),
+        (0x2F913, "M", "瀹"),
+        (0x2F914, "M", "瀞"),
+        (0x2F915, "M", "瀛"),
+        (0x2F916, "M", "㶖"),
+        (0x2F917, "M", "灊"),
+        (0x2F918, "M", "災"),
+        (0x2F919, "M", "灷"),
+        (0x2F91A, "M", "炭"),
+        (0x2F91B, "M", "𠔥"),
+        (0x2F91C, "M", "煅"),
+        (0x2F91D, "M", "𤉣"),
+        (0x2F91E, "M", "熜"),
+        (0x2F91F, "X"),
+        (0x2F920, "M", "爨"),
+        (0x2F921, "M", "爵"),
+        (0x2F922, "M", "牐"),
+        (0x2F923, "M", "𤘈"),
+        (0x2F924, "M", "犀"),
+        (0x2F925, "M", "犕"),
+        (0x2F926, "M", "𤜵"),
+        (0x2F927, "M", "𤠔"),
+        (0x2F928, "M", "獺"),
+        (0x2F929, "M", "王"),
+        (0x2F92A, "M", "㺬"),
+        (0x2F92B, "M", "玥"),
+        (0x2F92C, "M", "㺸"),
+        (0x2F92E, "M", "瑇"),
+        (0x2F92F, "M", "瑜"),
+        (0x2F930, "M", "瑱"),
+        (0x2F931, "M", "璅"),
+        (0x2F932, "M", "瓊"),
+        (0x2F933, "M", "㼛"),
+        (0x2F934, "M", "甤"),
+        (0x2F935, "M", "𤰶"),
+        (0x2F936, "M", "甾"),
+        (0x2F937, "M", "𤲒"),
+        (0x2F938, "M", "異"),
+        (0x2F939, "M", "𢆟"),
+        (0x2F93A, "M", "瘐"),
+        (0x2F93B, "M", "𤾡"),
+        (0x2F93C, "M", "𤾸"),
+        (0x2F93D, "M", "𥁄"),
+        (0x2F93E, "M", "㿼"),
+        (0x2F93F, "M", "䀈"),
+        (0x2F940, "M", "直"),
+        (0x2F941, "M", "𥃳"),
+        (0x2F942, "M", "𥃲"),
+        (0x2F943, "M", "𥄙"),
+        (0x2F944, "M", "𥄳"),
+        (0x2F945, "M", "眞"),
+        (0x2F946, "M", "真"),
+        (0x2F948, "M", "睊"),
+        (0x2F949, "M", "䀹"),
+        (0x2F94A, "M", "瞋"),
+        (0x2F94B, "M", "䁆"),
+        (0x2F94C, "M", "䂖"),
+        (0x2F94D, "M", "𥐝"),
+        (0x2F94E, "M", "硎"),
+        (0x2F94F, "M", "碌"),
+        (0x2F950, "M", "磌"),
+        (0x2F951, "M", "䃣"),
+        (0x2F952, "M", "𥘦"),
+        (0x2F953, "M", "祖"),
+        (0x2F954, "M", "𥚚"),
+        (0x2F955, "M", "𥛅"),
+        (0x2F956, "M", "福"),
+        (0x2F957, "M", "秫"),
+        (0x2F958, "M", "䄯"),
+        (0x2F959, "M", "穀"),
+        (0x2F95A, "M", "穊"),
+        (0x2F95B, "M", "穏"),
+        (0x2F95C, "M", "𥥼"),
+        (0x2F95D, "M", "𥪧"),
+        (0x2F95F, "X"),
+        (0x2F960, "M", "䈂"),
+        (0x2F961, "M", "𥮫"),
+        (0x2F962, "M", "篆"),
+        (0x2F963, "M", "築"),
+        (0x2F964, "M", "䈧"),
+        (0x2F965, "M", "𥲀"),
+        (0x2F966, "M", "糒"),
+        (0x2F967, "M", "䊠"),
+        (0x2F968, "M", "糨"),
+        (0x2F969, "M", "糣"),
+        (0x2F96A, "M", "紀"),
+        (0x2F96B, "M", "𥾆"),
+        (0x2F96C, "M", "絣"),
+        (0x2F96D, "M", "䌁"),
+        (0x2F96E, "M", "緇"),
+        (0x2F96F, "M", "縂"),
+        (0x2F970, "M", "繅"),
+        (0x2F971, "M", "䌴"),
+        (0x2F972, "M", "𦈨"),
+        (0x2F973, "M", "𦉇"),
     ]
 
+
 def _seg_80() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x2F974, 'M', '䍙'),
-    (0x2F975, 'M', '𦋙'),
-    (0x2F976, 'M', '罺'),
-    (0x2F977, 'M', '𦌾'),
-    (0x2F978, 'M', '羕'),
-    (0x2F979, 'M', '翺'),
-    (0x2F97A, 'M', '者'),
-    (0x2F97B, 'M', '𦓚'),
-    (0x2F97C, 'M', '𦔣'),
-    (0x2F97D, 'M', '聠'),
-    (0x2F97E, 'M', '𦖨'),
-    (0x2F97F, 'M', '聰'),
-    (0x2F980, 'M', '𣍟'),
-    (0x2F981, 'M', '䏕'),
-    (0x2F982, 'M', '育'),
-    (0x2F983, 'M', '脃'),
-    (0x2F984, 'M', '䐋'),
-    (0x2F985, 'M', '脾'),
-    (0x2F986, 'M', '媵'),
-    (0x2F987, 'M', '𦞧'),
-    (0x2F988, 'M', '𦞵'),
-    (0x2F989, 'M', '𣎓'),
-    (0x2F98A, 'M', '𣎜'),
-    (0x2F98B, 'M', '舁'),
-    (0x2F98C, 'M', '舄'),
-    (0x2F98D, 'M', '辞'),
-    (0x2F98E, 'M', '䑫'),
-    (0x2F98F, 'M', '芑'),
-    (0x2F990, 'M', '芋'),
-    (0x2F991, 'M', '芝'),
-    (0x2F992, 'M', '劳'),
-    (0x2F993, 'M', '花'),
-    (0x2F994, 'M', '芳'),
-    (0x2F995, 'M', '芽'),
-    (0x2F996, 'M', '苦'),
-    (0x2F997, 'M', '𦬼'),
-    (0x2F998, 'M', '若'),
-    (0x2F999, 'M', '茝'),
-    (0x2F99A, 'M', '荣'),
-    (0x2F99B, 'M', '莭'),
-    (0x2F99C, 'M', '茣'),
-    (0x2F99D, 'M', '莽'),
-    (0x2F99E, 'M', '菧'),
-    (0x2F99F, 'M', '著'),
-    (0x2F9A0, 'M', '荓'),
-    (0x2F9A1, 'M', '菊'),
-    (0x2F9A2, 'M', '菌'),
-    (0x2F9A3, 'M', '菜'),
-    (0x2F9A4, 'M', '𦰶'),
-    (0x2F9A5, 'M', '𦵫'),
-    (0x2F9A6, 'M', '𦳕'),
-    (0x2F9A7, 'M', '䔫'),
-    (0x2F9A8, 'M', '蓱'),
-    (0x2F9A9, 'M', '蓳'),
-    (0x2F9AA, 'M', '蔖'),
-    (0x2F9AB, 'M', '𧏊'),
-    (0x2F9AC, 'M', '蕤'),
-    (0x2F9AD, 'M', '𦼬'),
-    (0x2F9AE, 'M', '䕝'),
-    (0x2F9AF, 'M', '䕡'),
-    (0x2F9B0, 'M', '𦾱'),
-    (0x2F9B1, 'M', '𧃒'),
-    (0x2F9B2, 'M', '䕫'),
-    (0x2F9B3, 'M', '虐'),
-    (0x2F9B4, 'M', '虜'),
-    (0x2F9B5, 'M', '虧'),
-    (0x2F9B6, 'M', '虩'),
-    (0x2F9B7, 'M', '蚩'),
-    (0x2F9B8, 'M', '蚈'),
-    (0x2F9B9, 'M', '蜎'),
-    (0x2F9BA, 'M', '蛢'),
-    (0x2F9BB, 'M', '蝹'),
-    (0x2F9BC, 'M', '蜨'),
-    (0x2F9BD, 'M', '蝫'),
-    (0x2F9BE, 'M', '螆'),
-    (0x2F9BF, 'X'),
-    (0x2F9C0, 'M', '蟡'),
-    (0x2F9C1, 'M', '蠁'),
-    (0x2F9C2, 'M', '䗹'),
-    (0x2F9C3, 'M', '衠'),
-    (0x2F9C4, 'M', '衣'),
-    (0x2F9C5, 'M', '𧙧'),
-    (0x2F9C6, 'M', '裗'),
-    (0x2F9C7, 'M', '裞'),
-    (0x2F9C8, 'M', '䘵'),
-    (0x2F9C9, 'M', '裺'),
-    (0x2F9CA, 'M', '㒻'),
-    (0x2F9CB, 'M', '𧢮'),
-    (0x2F9CC, 'M', '𧥦'),
-    (0x2F9CD, 'M', '䚾'),
-    (0x2F9CE, 'M', '䛇'),
-    (0x2F9CF, 'M', '誠'),
-    (0x2F9D0, 'M', '諭'),
-    (0x2F9D1, 'M', '變'),
-    (0x2F9D2, 'M', '豕'),
-    (0x2F9D3, 'M', '𧲨'),
-    (0x2F9D4, 'M', '貫'),
-    (0x2F9D5, 'M', '賁'),
-    (0x2F9D6, 'M', '贛'),
-    (0x2F9D7, 'M', '起'),
+        (0x2F974, "M", "䍙"),
+        (0x2F975, "M", "𦋙"),
+        (0x2F976, "M", "罺"),
+        (0x2F977, "M", "𦌾"),
+        (0x2F978, "M", "羕"),
+        (0x2F979, "M", "翺"),
+        (0x2F97A, "M", "者"),
+        (0x2F97B, "M", "𦓚"),
+        (0x2F97C, "M", "𦔣"),
+        (0x2F97D, "M", "聠"),
+        (0x2F97E, "M", "𦖨"),
+        (0x2F97F, "M", "聰"),
+        (0x2F980, "M", "𣍟"),
+        (0x2F981, "M", "䏕"),
+        (0x2F982, "M", "育"),
+        (0x2F983, "M", "脃"),
+        (0x2F984, "M", "䐋"),
+        (0x2F985, "M", "脾"),
+        (0x2F986, "M", "媵"),
+        (0x2F987, "M", "𦞧"),
+        (0x2F988, "M", "𦞵"),
+        (0x2F989, "M", "𣎓"),
+        (0x2F98A, "M", "𣎜"),
+        (0x2F98B, "M", "舁"),
+        (0x2F98C, "M", "舄"),
+        (0x2F98D, "M", "辞"),
+        (0x2F98E, "M", "䑫"),
+        (0x2F98F, "M", "芑"),
+        (0x2F990, "M", "芋"),
+        (0x2F991, "M", "芝"),
+        (0x2F992, "M", "劳"),
+        (0x2F993, "M", "花"),
+        (0x2F994, "M", "芳"),
+        (0x2F995, "M", "芽"),
+        (0x2F996, "M", "苦"),
+        (0x2F997, "M", "𦬼"),
+        (0x2F998, "M", "若"),
+        (0x2F999, "M", "茝"),
+        (0x2F99A, "M", "荣"),
+        (0x2F99B, "M", "莭"),
+        (0x2F99C, "M", "茣"),
+        (0x2F99D, "M", "莽"),
+        (0x2F99E, "M", "菧"),
+        (0x2F99F, "M", "著"),
+        (0x2F9A0, "M", "荓"),
+        (0x2F9A1, "M", "菊"),
+        (0x2F9A2, "M", "菌"),
+        (0x2F9A3, "M", "菜"),
+        (0x2F9A4, "M", "𦰶"),
+        (0x2F9A5, "M", "𦵫"),
+        (0x2F9A6, "M", "𦳕"),
+        (0x2F9A7, "M", "䔫"),
+        (0x2F9A8, "M", "蓱"),
+        (0x2F9A9, "M", "蓳"),
+        (0x2F9AA, "M", "蔖"),
+        (0x2F9AB, "M", "𧏊"),
+        (0x2F9AC, "M", "蕤"),
+        (0x2F9AD, "M", "𦼬"),
+        (0x2F9AE, "M", "䕝"),
+        (0x2F9AF, "M", "䕡"),
+        (0x2F9B0, "M", "𦾱"),
+        (0x2F9B1, "M", "𧃒"),
+        (0x2F9B2, "M", "䕫"),
+        (0x2F9B3, "M", "虐"),
+        (0x2F9B4, "M", "虜"),
+        (0x2F9B5, "M", "虧"),
+        (0x2F9B6, "M", "虩"),
+        (0x2F9B7, "M", "蚩"),
+        (0x2F9B8, "M", "蚈"),
+        (0x2F9B9, "M", "蜎"),
+        (0x2F9BA, "M", "蛢"),
+        (0x2F9BB, "M", "蝹"),
+        (0x2F9BC, "M", "蜨"),
+        (0x2F9BD, "M", "蝫"),
+        (0x2F9BE, "M", "螆"),
+        (0x2F9BF, "X"),
+        (0x2F9C0, "M", "蟡"),
+        (0x2F9C1, "M", "蠁"),
+        (0x2F9C2, "M", "䗹"),
+        (0x2F9C3, "M", "衠"),
+        (0x2F9C4, "M", "衣"),
+        (0x2F9C5, "M", "𧙧"),
+        (0x2F9C6, "M", "裗"),
+        (0x2F9C7, "M", "裞"),
+        (0x2F9C8, "M", "䘵"),
+        (0x2F9C9, "M", "裺"),
+        (0x2F9CA, "M", "㒻"),
+        (0x2F9CB, "M", "𧢮"),
+        (0x2F9CC, "M", "𧥦"),
+        (0x2F9CD, "M", "䚾"),
+        (0x2F9CE, "M", "䛇"),
+        (0x2F9CF, "M", "誠"),
+        (0x2F9D0, "M", "諭"),
+        (0x2F9D1, "M", "變"),
+        (0x2F9D2, "M", "豕"),
+        (0x2F9D3, "M", "𧲨"),
+        (0x2F9D4, "M", "貫"),
+        (0x2F9D5, "M", "賁"),
+        (0x2F9D6, "M", "贛"),
+        (0x2F9D7, "M", "起"),
     ]
 
+
 def _seg_81() -> List[Union[Tuple[int, str], Tuple[int, str, str]]]:
     return [
-    (0x2F9D8, 'M', '𧼯'),
-    (0x2F9D9, 'M', '𠠄'),
-    (0x2F9DA, 'M', '跋'),
-    (0x2F9DB, 'M', '趼'),
-    (0x2F9DC, 'M', '跰'),
-    (0x2F9DD, 'M', '𠣞'),
-    (0x2F9DE, 'M', '軔'),
-    (0x2F9DF, 'M', '輸'),
-    (0x2F9E0, 'M', '𨗒'),
-    (0x2F9E1, 'M', '𨗭'),
-    (0x2F9E2, 'M', '邔'),
-    (0x2F9E3, 'M', '郱'),
-    (0x2F9E4, 'M', '鄑'),
-    (0x2F9E5, 'M', '𨜮'),
-    (0x2F9E6, 'M', '鄛'),
-    (0x2F9E7, 'M', '鈸'),
-    (0x2F9E8, 'M', '鋗'),
-    (0x2F9E9, 'M', '鋘'),
-    (0x2F9EA, 'M', '鉼'),
-    (0x2F9EB, 'M', '鏹'),
-    (0x2F9EC, 'M', '鐕'),
-    (0x2F9ED, 'M', '𨯺'),
-    (0x2F9EE, 'M', '開'),
-    (0x2F9EF, 'M', '䦕'),
-    (0x2F9F0, 'M', '閷'),
-    (0x2F9F1, 'M', '𨵷'),
-    (0x2F9F2, 'M', '䧦'),
-    (0x2F9F3, 'M', '雃'),
-    (0x2F9F4, 'M', '嶲'),
-    (0x2F9F5, 'M', '霣'),
-    (0x2F9F6, 'M', '𩅅'),
-    (0x2F9F7, 'M', '𩈚'),
-    (0x2F9F8, 'M', '䩮'),
-    (0x2F9F9, 'M', '䩶'),
-    (0x2F9FA, 'M', '韠'),
-    (0x2F9FB, 'M', '𩐊'),
-    (0x2F9FC, 'M', '䪲'),
-    (0x2F9FD, 'M', '𩒖'),
-    (0x2F9FE, 'M', '頋'),
-    (0x2FA00, 'M', '頩'),
-    (0x2FA01, 'M', '𩖶'),
-    (0x2FA02, 'M', '飢'),
-    (0x2FA03, 'M', '䬳'),
-    (0x2FA04, 'M', '餩'),
-    (0x2FA05, 'M', '馧'),
-    (0x2FA06, 'M', '駂'),
-    (0x2FA07, 'M', '駾'),
-    (0x2FA08, 'M', '䯎'),
-    (0x2FA09, 'M', '𩬰'),
-    (0x2FA0A, 'M', '鬒'),
-    (0x2FA0B, 'M', '鱀'),
-    (0x2FA0C, 'M', '鳽'),
-    (0x2FA0D, 'M', '䳎'),
-    (0x2FA0E, 'M', '䳭'),
-    (0x2FA0F, 'M', '鵧'),
-    (0x2FA10, 'M', '𪃎'),
-    (0x2FA11, 'M', '䳸'),
-    (0x2FA12, 'M', '𪄅'),
-    (0x2FA13, 'M', '𪈎'),
-    (0x2FA14, 'M', '𪊑'),
-    (0x2FA15, 'M', '麻'),
-    (0x2FA16, 'M', '䵖'),
-    (0x2FA17, 'M', '黹'),
-    (0x2FA18, 'M', '黾'),
-    (0x2FA19, 'M', '鼅'),
-    (0x2FA1A, 'M', '鼏'),
-    (0x2FA1B, 'M', '鼖'),
-    (0x2FA1C, 'M', '鼻'),
-    (0x2FA1D, 'M', '𪘀'),
-    (0x2FA1E, 'X'),
-    (0x30000, 'V'),
-    (0x3134B, 'X'),
-    (0x31350, 'V'),
-    (0x323B0, 'X'),
-    (0xE0100, 'I'),
-    (0xE01F0, 'X'),
+        (0x2F9D8, "M", "𧼯"),
+        (0x2F9D9, "M", "𠠄"),
+        (0x2F9DA, "M", "跋"),
+        (0x2F9DB, "M", "趼"),
+        (0x2F9DC, "M", "跰"),
+        (0x2F9DD, "M", "𠣞"),
+        (0x2F9DE, "M", "軔"),
+        (0x2F9DF, "M", "輸"),
+        (0x2F9E0, "M", "𨗒"),
+        (0x2F9E1, "M", "𨗭"),
+        (0x2F9E2, "M", "邔"),
+        (0x2F9E3, "M", "郱"),
+        (0x2F9E4, "M", "鄑"),
+        (0x2F9E5, "M", "𨜮"),
+        (0x2F9E6, "M", "鄛"),
+        (0x2F9E7, "M", "鈸"),
+        (0x2F9E8, "M", "鋗"),
+        (0x2F9E9, "M", "鋘"),
+        (0x2F9EA, "M", "鉼"),
+        (0x2F9EB, "M", "鏹"),
+        (0x2F9EC, "M", "鐕"),
+        (0x2F9ED, "M", "𨯺"),
+        (0x2F9EE, "M", "開"),
+        (0x2F9EF, "M", "䦕"),
+        (0x2F9F0, "M", "閷"),
+        (0x2F9F1, "M", "𨵷"),
+        (0x2F9F2, "M", "䧦"),
+        (0x2F9F3, "M", "雃"),
+        (0x2F9F4, "M", "嶲"),
+        (0x2F9F5, "M", "霣"),
+        (0x2F9F6, "M", "𩅅"),
+        (0x2F9F7, "M", "𩈚"),
+        (0x2F9F8, "M", "䩮"),
+        (0x2F9F9, "M", "䩶"),
+        (0x2F9FA, "M", "韠"),
+        (0x2F9FB, "M", "𩐊"),
+        (0x2F9FC, "M", "䪲"),
+        (0x2F9FD, "M", "𩒖"),
+        (0x2F9FE, "M", "頋"),
+        (0x2FA00, "M", "頩"),
+        (0x2FA01, "M", "𩖶"),
+        (0x2FA02, "M", "飢"),
+        (0x2FA03, "M", "䬳"),
+        (0x2FA04, "M", "餩"),
+        (0x2FA05, "M", "馧"),
+        (0x2FA06, "M", "駂"),
+        (0x2FA07, "M", "駾"),
+        (0x2FA08, "M", "䯎"),
+        (0x2FA09, "M", "𩬰"),
+        (0x2FA0A, "M", "鬒"),
+        (0x2FA0B, "M", "鱀"),
+        (0x2FA0C, "M", "鳽"),
+        (0x2FA0D, "M", "䳎"),
+        (0x2FA0E, "M", "䳭"),
+        (0x2FA0F, "M", "鵧"),
+        (0x2FA10, "M", "𪃎"),
+        (0x2FA11, "M", "䳸"),
+        (0x2FA12, "M", "𪄅"),
+        (0x2FA13, "M", "𪈎"),
+        (0x2FA14, "M", "𪊑"),
+        (0x2FA15, "M", "麻"),
+        (0x2FA16, "M", "䵖"),
+        (0x2FA17, "M", "黹"),
+        (0x2FA18, "M", "黾"),
+        (0x2FA19, "M", "鼅"),
+        (0x2FA1A, "M", "鼏"),
+        (0x2FA1B, "M", "鼖"),
+        (0x2FA1C, "M", "鼻"),
+        (0x2FA1D, "M", "𪘀"),
+        (0x2FA1E, "X"),
+        (0x30000, "V"),
+        (0x3134B, "X"),
+        (0x31350, "V"),
+        (0x323B0, "X"),
+        (0xE0100, "I"),
+        (0xE01F0, "X"),
     ]
 
+
 uts46data = tuple(
     _seg_0()
     + _seg_1()
diff --git a/requirements.txt b/requirements.txt
index 6775d4c4..9834d3ef 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -15,7 +15,7 @@ ga4mp==2.0.4
 gntp==1.0.3
 html5lib==1.1
 httpagentparser==1.9.5
-idna==3.7
+idna==3.10
 importlib-metadata==8.5.0
 importlib-resources==6.4.5
 git+https://github.com/Tautulli/ipwhois.git@master#egg=ipwhois

From 025e8bcf58b320805baca8d74e2ab9afd4c04281 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 16 Nov 2024 14:51:10 -0800
Subject: [PATCH 670/743] Bump platformdirs from 4.2.2 to 4.3.6 (#2403)

* Bump platformdirs from 4.2.2 to 4.3.6

Bumps [platformdirs](https://github.com/tox-dev/platformdirs) from 4.2.2 to 4.3.6.
- [Release notes](https://github.com/tox-dev/platformdirs/releases)
- [Changelog](https://github.com/tox-dev/platformdirs/blob/main/CHANGES.rst)
- [Commits](https://github.com/tox-dev/platformdirs/compare/4.2.2...4.3.6)

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

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

* Update platformdirs==4.3.6

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/platformdirs/__init__.py | 24 ++++++++++++++----------
 lib/platformdirs/android.py  |  2 +-
 lib/platformdirs/api.py      |  6 ++++++
 lib/platformdirs/macos.py    | 14 ++++++++++++++
 lib/platformdirs/unix.py     |  6 ------
 lib/platformdirs/version.py  |  4 ++--
 requirements.txt             |  2 +-
 7 files changed, 38 insertions(+), 20 deletions(-)

diff --git a/lib/platformdirs/__init__.py b/lib/platformdirs/__init__.py
index 3f7d9490..afe8351d 100644
--- a/lib/platformdirs/__init__.py
+++ b/lib/platformdirs/__init__.py
@@ -19,18 +19,18 @@ if TYPE_CHECKING:
     from pathlib import Path
     from typing import Literal
 
+if sys.platform == "win32":
+    from platformdirs.windows import Windows as _Result
+elif sys.platform == "darwin":
+    from platformdirs.macos import MacOS as _Result
+else:
+    from platformdirs.unix import Unix as _Result
+
 
 def _set_platform_dir_class() -> type[PlatformDirsABC]:
-    if sys.platform == "win32":
-        from platformdirs.windows import Windows as Result  # noqa: PLC0415
-    elif sys.platform == "darwin":
-        from platformdirs.macos import MacOS as Result  # noqa: PLC0415
-    else:
-        from platformdirs.unix import Unix as Result  # noqa: PLC0415
-
     if os.getenv("ANDROID_DATA") == "/data" and os.getenv("ANDROID_ROOT") == "/system":
         if os.getenv("SHELL") or os.getenv("PREFIX"):
-            return Result
+            return _Result
 
         from platformdirs.android import _android_folder  # noqa: PLC0415
 
@@ -39,10 +39,14 @@ def _set_platform_dir_class() -> type[PlatformDirsABC]:
 
             return Android  # return to avoid redefinition of a result
 
-    return Result
+    return _Result
 
 
-PlatformDirs = _set_platform_dir_class()  #: Currently active platform
+if TYPE_CHECKING:
+    # Work around mypy issue: https://github.com/python/mypy/issues/10962
+    PlatformDirs = _Result
+else:
+    PlatformDirs = _set_platform_dir_class()  #: Currently active platform
 AppDirs = PlatformDirs  #: Backwards compatibility with appdirs
 
 
diff --git a/lib/platformdirs/android.py b/lib/platformdirs/android.py
index afd3141c..7004a852 100644
--- a/lib/platformdirs/android.py
+++ b/lib/platformdirs/android.py
@@ -117,7 +117,7 @@ class Android(PlatformDirsABC):
 
 
 @lru_cache(maxsize=1)
-def _android_folder() -> str | None:  # noqa: C901, PLR0912
+def _android_folder() -> str | None:  # noqa: C901
     """:return: base folder for the Android OS or None if it cannot be found"""
     result: str | None = None
     # type checker isn't happy with our "import android", just don't do this when type checking see
diff --git a/lib/platformdirs/api.py b/lib/platformdirs/api.py
index c50caa64..18d660e4 100644
--- a/lib/platformdirs/api.py
+++ b/lib/platformdirs/api.py
@@ -91,6 +91,12 @@ class PlatformDirsABC(ABC):  # noqa: PLR0904
         if self.ensure_exists:
             Path(path).mkdir(parents=True, exist_ok=True)
 
+    def _first_item_as_path_if_multipath(self, directory: str) -> Path:
+        if self.multipath:
+            # If multipath is True, the first path is returned.
+            directory = directory.split(os.pathsep)[0]
+        return Path(directory)
+
     @property
     @abstractmethod
     def user_data_dir(self) -> str:
diff --git a/lib/platformdirs/macos.py b/lib/platformdirs/macos.py
index eb1ba5df..e4b0391a 100644
--- a/lib/platformdirs/macos.py
+++ b/lib/platformdirs/macos.py
@@ -4,9 +4,13 @@ from __future__ import annotations
 
 import os.path
 import sys
+from typing import TYPE_CHECKING
 
 from .api import PlatformDirsABC
 
+if TYPE_CHECKING:
+    from pathlib import Path
+
 
 class MacOS(PlatformDirsABC):
     """
@@ -42,6 +46,11 @@ class MacOS(PlatformDirsABC):
             return os.pathsep.join(path_list)
         return path_list[0]
 
+    @property
+    def site_data_path(self) -> Path:
+        """:return: data path shared by users. Only return the first item, even if ``multipath`` is set to ``True``"""
+        return self._first_item_as_path_if_multipath(self.site_data_dir)
+
     @property
     def user_config_dir(self) -> str:
         """:return: config directory tied to the user, same as `user_data_dir`"""
@@ -74,6 +83,11 @@ class MacOS(PlatformDirsABC):
             return os.pathsep.join(path_list)
         return path_list[0]
 
+    @property
+    def site_cache_path(self) -> Path:
+        """:return: cache path shared by users. Only return the first item, even if ``multipath`` is set to ``True``"""
+        return self._first_item_as_path_if_multipath(self.site_cache_dir)
+
     @property
     def user_state_dir(self) -> str:
         """:return: state directory tied to the user, same as `user_data_dir`"""
diff --git a/lib/platformdirs/unix.py b/lib/platformdirs/unix.py
index 9500ade6..f1942e92 100644
--- a/lib/platformdirs/unix.py
+++ b/lib/platformdirs/unix.py
@@ -218,12 +218,6 @@ class Unix(PlatformDirsABC):  # noqa: PLR0904
         """:return: cache path shared by users. Only return the first item, even if ``multipath`` is set to ``True``"""
         return self._first_item_as_path_if_multipath(self.site_cache_dir)
 
-    def _first_item_as_path_if_multipath(self, directory: str) -> Path:
-        if self.multipath:
-            # If multipath is True, the first path is returned.
-            directory = directory.split(os.pathsep)[0]
-        return Path(directory)
-
     def iter_config_dirs(self) -> Iterator[str]:
         """:yield: all user and site configuration directories."""
         yield self.user_config_dir
diff --git a/lib/platformdirs/version.py b/lib/platformdirs/version.py
index 6483ddce..afb49243 100644
--- a/lib/platformdirs/version.py
+++ b/lib/platformdirs/version.py
@@ -12,5 +12,5 @@ __version__: str
 __version_tuple__: VERSION_TUPLE
 version_tuple: VERSION_TUPLE
 
-__version__ = version = '4.2.2'
-__version_tuple__ = version_tuple = (4, 2, 2)
+__version__ = version = '4.3.6'
+__version_tuple__ = version_tuple = (4, 3, 6)
diff --git a/requirements.txt b/requirements.txt
index 9834d3ef..86e315d4 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -25,7 +25,7 @@ MarkupSafe==2.1.5
 musicbrainzngs==0.7.1
 packaging==24.1
 paho-mqtt==2.1.0
-platformdirs==4.2.2
+platformdirs==4.3.6
 plexapi==4.15.16
 portend==3.2.0
 profilehooks==1.12.0

From fc2c7cc871bbd169e1fa73736136e76ec7c11844 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 16 Nov 2024 14:51:22 -0800
Subject: [PATCH 671/743] Bump tzdata from 2024.1 to 2024.2 (#2409)

* Bump tzdata from 2024.1 to 2024.2

Bumps [tzdata](https://github.com/python/tzdata) from 2024.1 to 2024.2.
- [Release notes](https://github.com/python/tzdata/releases)
- [Changelog](https://github.com/python/tzdata/blob/master/NEWS.md)
- [Commits](https://github.com/python/tzdata/compare/2024.1...2024.2)

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

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

* Update tzdata==2024.2

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/tzdata/__init__.py                     |    4 +-
 lib/tzdata/zoneinfo/Africa/Blantyre        |  Bin 131 -> 131 bytes
 lib/tzdata/zoneinfo/Africa/Bujumbura       |  Bin 131 -> 131 bytes
 lib/tzdata/zoneinfo/Africa/Gaborone        |  Bin 131 -> 131 bytes
 lib/tzdata/zoneinfo/Africa/Harare          |  Bin 131 -> 131 bytes
 lib/tzdata/zoneinfo/Africa/Kigali          |  Bin 131 -> 131 bytes
 lib/tzdata/zoneinfo/Africa/Lubumbashi      |  Bin 131 -> 131 bytes
 lib/tzdata/zoneinfo/Africa/Lusaka          |  Bin 131 -> 131 bytes
 lib/tzdata/zoneinfo/Africa/Maputo          |  Bin 131 -> 131 bytes
 lib/tzdata/zoneinfo/America/Bahia_Banderas |  Bin 728 -> 700 bytes
 lib/tzdata/zoneinfo/America/Cancun         |  Bin 529 -> 538 bytes
 lib/tzdata/zoneinfo/America/Chihuahua      |  Bin 691 -> 691 bytes
 lib/tzdata/zoneinfo/America/Ciudad_Juarez  |  Bin 718 -> 718 bytes
 lib/tzdata/zoneinfo/America/Ensenada       |  Bin 1025 -> 1079 bytes
 lib/tzdata/zoneinfo/America/Hermosillo     |  Bin 286 -> 258 bytes
 lib/tzdata/zoneinfo/America/Mazatlan       |  Bin 718 -> 690 bytes
 lib/tzdata/zoneinfo/America/Merida         |  Bin 654 -> 654 bytes
 lib/tzdata/zoneinfo/America/Mexico_City    |  Bin 773 -> 773 bytes
 lib/tzdata/zoneinfo/America/Monterrey      |  Bin 644 -> 709 bytes
 lib/tzdata/zoneinfo/America/Ojinaga        |  Bin 718 -> 718 bytes
 lib/tzdata/zoneinfo/America/Santa_Isabel   |  Bin 1025 -> 1079 bytes
 lib/tzdata/zoneinfo/America/Tijuana        |  Bin 1025 -> 1079 bytes
 lib/tzdata/zoneinfo/Asia/Choibalsan        |  Bin 619 -> 594 bytes
 lib/tzdata/zoneinfo/Asia/Dili              |  Bin 170 -> 170 bytes
 lib/tzdata/zoneinfo/Atlantic/Azores        |  Bin 1453 -> 1401 bytes
 lib/tzdata/zoneinfo/Atlantic/Madeira       |  Bin 1453 -> 1372 bytes
 lib/tzdata/zoneinfo/CET                    |  Bin 621 -> 1103 bytes
 lib/tzdata/zoneinfo/CST6CDT                |  Bin 951 -> 1754 bytes
 lib/tzdata/zoneinfo/EET                    |  Bin 497 -> 682 bytes
 lib/tzdata/zoneinfo/EST                    |  Bin 111 -> 149 bytes
 lib/tzdata/zoneinfo/EST5EDT                |  Bin 951 -> 1744 bytes
 lib/tzdata/zoneinfo/Europe/Lisbon          |  Bin 1454 -> 1463 bytes
 lib/tzdata/zoneinfo/HST                    |  Bin 112 -> 221 bytes
 lib/tzdata/zoneinfo/MET                    |  Bin 621 -> 1103 bytes
 lib/tzdata/zoneinfo/MST                    |  Bin 111 -> 240 bytes
 lib/tzdata/zoneinfo/MST7MDT                |  Bin 951 -> 1042 bytes
 lib/tzdata/zoneinfo/Mexico/BajaNorte       |  Bin 1025 -> 1079 bytes
 lib/tzdata/zoneinfo/Mexico/BajaSur         |  Bin 718 -> 690 bytes
 lib/tzdata/zoneinfo/Mexico/General         |  Bin 773 -> 773 bytes
 lib/tzdata/zoneinfo/PST8PDT                |  Bin 951 -> 1294 bytes
 lib/tzdata/zoneinfo/Portugal               |  Bin 1454 -> 1463 bytes
 lib/tzdata/zoneinfo/WET                    |  Bin 494 -> 1463 bytes
 lib/tzdata/zoneinfo/leapseconds            |    8 +-
 lib/tzdata/zoneinfo/tzdata.zi              | 1653 ++++++++++----------
 lib/tzdata/zoneinfo/zone.tab               |    3 +-
 lib/tzdata/zoneinfo/zone1970.tab           |    3 +-
 lib/tzdata/zoneinfo/zonenow.tab            |    8 +-
 lib/tzdata/zones                           |   24 +-
 requirements.txt                           |    2 +-
 49 files changed, 843 insertions(+), 862 deletions(-)

diff --git a/lib/tzdata/__init__.py b/lib/tzdata/__init__.py
index b319ed55..e558a8a5 100644
--- a/lib/tzdata/__init__.py
+++ b/lib/tzdata/__init__.py
@@ -1,6 +1,6 @@
 # IANA versions like 2020a are not valid PEP 440 identifiers; the recommended
 # way to translate the version is to use YYYY.n where `n` is a 0-based index.
-__version__ = "2024.1"
+__version__ = "2024.2"
 
 # This exposes the original IANA version number.
-IANA_VERSION = "2024a"
+IANA_VERSION = "2024b"
diff --git a/lib/tzdata/zoneinfo/Africa/Blantyre b/lib/tzdata/zoneinfo/Africa/Blantyre
index 651e5cf67a54ea3c729780cc8991407dd2a8a841..581bb0e08b616a433d422ccb8f958cbebdae1770 100644
GIT binary patch
delta 39
rcmZo>Y-XI0tkCOpwTzL0L9UAd2xJr(SbTg#7@QqL7`T9ht`QdiyLt#O

delta 39
rcmZo>Y-XI0tkC3k^a~>cgIo^-5XdMnu=x0fFgQDgFmM40T_Y|4$1Dh#

diff --git a/lib/tzdata/zoneinfo/Africa/Bujumbura b/lib/tzdata/zoneinfo/Africa/Bujumbura
index 651e5cf67a54ea3c729780cc8991407dd2a8a841..581bb0e08b616a433d422ccb8f958cbebdae1770 100644
GIT binary patch
delta 39
rcmZo>Y-XI0tkCOpwTzL0L9UAd2xJr(SbTg#7@QqL7`T9ht`QdiyLt#O

delta 39
rcmZo>Y-XI0tkC3k^a~>cgIo^-5XdMnu=x0fFgQDgFmM40T_Y|4$1Dh#

diff --git a/lib/tzdata/zoneinfo/Africa/Gaborone b/lib/tzdata/zoneinfo/Africa/Gaborone
index 651e5cf67a54ea3c729780cc8991407dd2a8a841..581bb0e08b616a433d422ccb8f958cbebdae1770 100644
GIT binary patch
delta 39
rcmZo>Y-XI0tkCOpwTzL0L9UAd2xJr(SbTg#7@QqL7`T9ht`QdiyLt#O

delta 39
rcmZo>Y-XI0tkC3k^a~>cgIo^-5XdMnu=x0fFgQDgFmM40T_Y|4$1Dh#

diff --git a/lib/tzdata/zoneinfo/Africa/Harare b/lib/tzdata/zoneinfo/Africa/Harare
index 651e5cf67a54ea3c729780cc8991407dd2a8a841..581bb0e08b616a433d422ccb8f958cbebdae1770 100644
GIT binary patch
delta 39
rcmZo>Y-XI0tkCOpwTzL0L9UAd2xJr(SbTg#7@QqL7`T9ht`QdiyLt#O

delta 39
rcmZo>Y-XI0tkC3k^a~>cgIo^-5XdMnu=x0fFgQDgFmM40T_Y|4$1Dh#

diff --git a/lib/tzdata/zoneinfo/Africa/Kigali b/lib/tzdata/zoneinfo/Africa/Kigali
index 651e5cf67a54ea3c729780cc8991407dd2a8a841..581bb0e08b616a433d422ccb8f958cbebdae1770 100644
GIT binary patch
delta 39
rcmZo>Y-XI0tkCOpwTzL0L9UAd2xJr(SbTg#7@QqL7`T9ht`QdiyLt#O

delta 39
rcmZo>Y-XI0tkC3k^a~>cgIo^-5XdMnu=x0fFgQDgFmM40T_Y|4$1Dh#

diff --git a/lib/tzdata/zoneinfo/Africa/Lubumbashi b/lib/tzdata/zoneinfo/Africa/Lubumbashi
index 651e5cf67a54ea3c729780cc8991407dd2a8a841..581bb0e08b616a433d422ccb8f958cbebdae1770 100644
GIT binary patch
delta 39
rcmZo>Y-XI0tkCOpwTzL0L9UAd2xJr(SbTg#7@QqL7`T9ht`QdiyLt#O

delta 39
rcmZo>Y-XI0tkC3k^a~>cgIo^-5XdMnu=x0fFgQDgFmM40T_Y|4$1Dh#

diff --git a/lib/tzdata/zoneinfo/Africa/Lusaka b/lib/tzdata/zoneinfo/Africa/Lusaka
index 651e5cf67a54ea3c729780cc8991407dd2a8a841..581bb0e08b616a433d422ccb8f958cbebdae1770 100644
GIT binary patch
delta 39
rcmZo>Y-XI0tkCOpwTzL0L9UAd2xJr(SbTg#7@QqL7`T9ht`QdiyLt#O

delta 39
rcmZo>Y-XI0tkC3k^a~>cgIo^-5XdMnu=x0fFgQDgFmM40T_Y|4$1Dh#

diff --git a/lib/tzdata/zoneinfo/Africa/Maputo b/lib/tzdata/zoneinfo/Africa/Maputo
index 651e5cf67a54ea3c729780cc8991407dd2a8a841..581bb0e08b616a433d422ccb8f958cbebdae1770 100644
GIT binary patch
delta 39
rcmZo>Y-XI0tkCOpwTzL0L9UAd2xJr(SbTg#7@QqL7`T9ht`QdiyLt#O

delta 39
rcmZo>Y-XI0tkC3k^a~>cgIo^-5XdMnu=x0fFgQDgFmM40T_Y|4$1Dh#

diff --git a/lib/tzdata/zoneinfo/America/Bahia_Banderas b/lib/tzdata/zoneinfo/America/Bahia_Banderas
index 48faea2ecefa7dca89c7b2f5e0bfec6b47becf69..882400bd33bdc23fc75b092a01ea935b02431715 100644
GIT binary patch
delta 144
zcmcb?x`%Z_n5HcQ0|P4%i~I+IrQ2Q<favufwZZhZw6Fvaf4ie?!Nhurjmx()PEKNy
z3SnksVZsIf|DPMezyKsCFtGgpzj^@!2Z&_k`Tu|C21WrN-w+1h;1C99Aog_u(m>1w
I<d|^*05^L!L;wH)

delta 175
zcmdnPdV_UBn5I1g0|OfnOZ*3drQ2Q<favv~@*aTbZE0Z%AbPv=rG$y~5&|Ihjfq=6
z0M!FQLBq!B+Zh>ICI>P}PEKHAiD6~J1^@q_8^XW<BquPi{Qtjt0Rsn!WaRn(zrTS2
iXzb1nj3Pe1Aq>93Aq>ty?CTQ35CCEWX)d6E85aP+v_zBu

diff --git a/lib/tzdata/zoneinfo/America/Cancun b/lib/tzdata/zoneinfo/America/Cancun
index 640b259fd0f87a34f03554cf34b4346cffd5ef22..3110cdfd6e6f4ccd889447657dff43560d5aaee0 100644
GIT binary patch
delta 175
zcmbQpGK*zGn4>lW0|P4%i~I+IrQ2>L0ND&;UC%%igGBk63n1Dsy$nP#7!`9AfM{d)
z2oS|!67;HIW4|I}5)&gcBQp~VkRSk={{LUMf`Q@x|J4f^SpNUtxq*QLL^AUH|9|`d
aqkxZZ2!nHQ2!ksSJG%gBAm##cOt}E>Nh+cM

delta 166
zcmbQmGLdCMn57m20|P4%i~I+IrQ2>L0ND&;ZCAmxVS4%p5Z|ci7npDC?g{3b1l>v4
zI9-u3k(mhuSr`dH=KufKtzcmI|9|xY2A2Q-j~`&<`2T<B1_mAw$td9C8^Yim9Kzu0
P0>nVt8Ax*h8KztSxScCj

diff --git a/lib/tzdata/zoneinfo/America/Chihuahua b/lib/tzdata/zoneinfo/America/Chihuahua
index 5e0a54f00468f11913f12aaab341b1fabd9aded6..f65bb1c9310447737822ad026470d5092ce87678 100644
GIT binary patch
delta 30
icmdnYx|wxCj_^nAg8x9UEiEhoL~nPrE!bFZ!UO;Xk`Unl

delta 30
icmdnYx|wxCj_{|v2mgU!TUuBGh~DmeDPd#12@?Pp*Ag56

diff --git a/lib/tzdata/zoneinfo/America/Ciudad_Juarez b/lib/tzdata/zoneinfo/America/Ciudad_Juarez
index f636ee643fe49a583fb2db3ff8408c341a06e8d3..5f865ea808b57d97634d4331fc5fce84349ded36 100644
GIT binary patch
delta 30
icmX@ddX9BMj_^nAg8x9UEiEhoL~nPrE!bG^&jbJq<`FUg

delta 30
icmX@ddX9BMj_{|v2mgU!TUuBGh~DmeDPd#1KNA2RD-vx0

diff --git a/lib/tzdata/zoneinfo/America/Ensenada b/lib/tzdata/zoneinfo/America/Ensenada
index 42087af4cceb049f1395cabaaa85b7c39253ed97..18d0d14afc1cdf37c8f3607181e3f72211da99e9 100644
GIT binary patch
delta 98
zcmZqV*v>H_j4@?mxGeKW%Z7>Ny3TXgefSRq*QFyFK=h4?TfqF=4D4Y3?E}SN{+)Z9
k7l7pNu3R$#MBm#t70kci**9V1_ODEn3z*p^uVD@a0Q@;YIRF3v

delta 46
zcmdna(a13&j4^IvxGeLhnhz7pb%kf{D)<is*QFyFK=h4?TRv=j{*`I+Bj!*58j%^R

diff --git a/lib/tzdata/zoneinfo/America/Hermosillo b/lib/tzdata/zoneinfo/America/Hermosillo
index 5c92e2967e7cc5a0e3567ed0321f15b8b3a6b6f8..ba7b14760d47d1e10241e78e976f0093ada6551b 100644
GIT binary patch
delta 80
zcmbQo)WkF)Op}*^fq?~x1^xrU(rqsaK=k^L+F*KHT37;zzunQcU}C+*#O3A_AIORM
X_=Yg}28S>>1F^452m=?8W6lKtAqpea

delta 109
zcmZo-n#VLDOp~91fq@l>Mg9Z9(rqsaK=k@gc@IGJwzRMW5WU^`Qo_V~2>}rM#>6cj
wfa-yupkd;4b4HelXXO?C|L<>L5b*I0VekzOVQ>awUzZSu03gi;6foxk0Ny|`ApigX

diff --git a/lib/tzdata/zoneinfo/America/Mazatlan b/lib/tzdata/zoneinfo/America/Mazatlan
index 97d4d36c137fce3b89da84ba2b27dc17a86a15cb..5aa6039ea4cb36077f048782b54c6275c25e86b3 100644
GIT binary patch
delta 86
zcmX@dx`}l{n5HcQ0|N^X3;YLyrQ2Q<favufwZZhZw6Fvaf4ie?!Nhurjmx()PEKMn
dnLLF_O3cSMguypBguxkzeO*ErxPTmUE&ww-CF=kH

delta 119
zcmdnQdX9BMn5I1g0|P4%i~I+IrQ2Q<favv~@*aTbZE0Z%AbPv=rG$y~5&|Ihjfq=6
z0M!FQLBq!B+Zh>ICI>PZPflQBncTu8q458Ie*=Snk8cQrZ*T~MGZ6c_gfIjEX)d6E
GITrvCBs3lX

diff --git a/lib/tzdata/zoneinfo/America/Merida b/lib/tzdata/zoneinfo/America/Merida
index e5de1131dc48e5d652c7bd6a77be22a2e9b500cc..e5c7d8cc2d2a986374f35561d8b629110b481a66 100644
GIT binary patch
delta 22
bcmeBU?PHyg!`=0a0R$veZWU}S7iR(hOfd#!

delta 22
ccmeBU?PHyg!`*f@fdL34e7plTmWwk108Ir3DF6Tf

diff --git a/lib/tzdata/zoneinfo/America/Mexico_City b/lib/tzdata/zoneinfo/America/Mexico_City
index 80a415c70ca3d94aa25bbc1e90f3ed169943a704..18112346129a885b5d5fa27109682b63784f72c0 100644
GIT binary patch
delta 30
icmZo=Yh{~|Bm7aj;6D&-OAAW?(c2wu3pUobF#!Pk^AOnp

delta 30
icmZo=Yh{~|Bm61v!G9pwmKK%(qPII=O4wN6#smNkM-mhO

diff --git a/lib/tzdata/zoneinfo/America/Monterrey b/lib/tzdata/zoneinfo/America/Monterrey
index a5822e2c626ae1927cb2dfc201c9561430cdd581..c1e05464513a451ab3cc49452e39da2b04e01de0 100644
GIT binary patch
delta 184
zcmZo+J<2*E%+ij5fq@l>Mg9Z9(rvdAK=k^L+65qbTUr>HzunOm%-_Ld2IlYh+xB5&
z`eDXmW=19!GU5OK3%@Wh{Qp090t3tc|Em`;aDYfgp8x-MZeSGf@eN_{4Gv*&24Y_q
MAPvM^K#my~05)+!8vp<R

delta 119
zcmX@g+QK>^Owf{nfq@x_dHw^z(rvdAHufK8jACLW2mb%R@CyUO|NpBOFtGgpzjFg4
UhmUUvgL5ztyM!=s0U2go0Q_Pa2><{9

diff --git a/lib/tzdata/zoneinfo/America/Ojinaga b/lib/tzdata/zoneinfo/America/Ojinaga
index f7e40c08185080d9594d56add6a5c7c5874d0332..1dd08b1cafd4b36ce963bdc42a075665fa723b54 100644
GIT binary patch
delta 30
icmX@ddX9BMj_^nAg8x9UEiEhoL~nPrE!bG^&jbJq<`FUg

delta 30
icmX@ddX9BMj_{|v2mgU!TUuBGh~DmeDPd#1KNA2RD-vx0

diff --git a/lib/tzdata/zoneinfo/America/Santa_Isabel b/lib/tzdata/zoneinfo/America/Santa_Isabel
index 42087af4cceb049f1395cabaaa85b7c39253ed97..18d0d14afc1cdf37c8f3607181e3f72211da99e9 100644
GIT binary patch
delta 98
zcmZqV*v>H_j4@?mxGeKW%Z7>Ny3TXgefSRq*QFyFK=h4?TfqF=4D4Y3?E}SN{+)Z9
k7l7pNu3R$#MBm#t70kci**9V1_ODEn3z*p^uVD@a0Q@;YIRF3v

delta 46
zcmdna(a13&j4^IvxGeLhnhz7pb%kf{D)<is*QFyFK=h4?TRv=j{*`I+Bj!*58j%^R

diff --git a/lib/tzdata/zoneinfo/America/Tijuana b/lib/tzdata/zoneinfo/America/Tijuana
index 42087af4cceb049f1395cabaaa85b7c39253ed97..18d0d14afc1cdf37c8f3607181e3f72211da99e9 100644
GIT binary patch
delta 98
zcmZqV*v>H_j4@?mxGeKW%Z7>Ny3TXgefSRq*QFyFK=h4?TfqF=4D4Y3?E}SN{+)Z9
k7l7pNu3R$#MBm#t70kci**9V1_ODEn3z*p^uVD@a0Q@;YIRF3v

delta 46
zcmdna(a13&j4^IvxGeLhnhz7pb%kf{D)<is*QFyFK=h4?TRv=j{*`I+Bj!*58j%^R

diff --git a/lib/tzdata/zoneinfo/Asia/Choibalsan b/lib/tzdata/zoneinfo/Asia/Choibalsan
index 0a948c2eaca30cde2963c330144215ba52d67c5e..6f5d3a15abbe48b8a4dc72aadc88c416160a56a6 100644
GIT binary patch
literal 594
zcmWHE%1kq2AP5+NDnJ+nLI`UCnaBdf0{?-a?eaSxkUoCyI}<>(#LE*6AX@U)pAR5f
z>Wps#h?d@CPynK3*625YXxTYJV7^?BAeb*-{RPZd$o>rGD@I=f^Od}>g89nUJHUJu
z?d@Q`s`M-{UyXYvn6J*V?E?c4sDIf8q8K!u%mDK>ugn1RwT@JQ`Py5mz<ix0F<`##
zlo&8yuf-0`*DtXH^9@oIz<k5ls0NULk*{q5h&HyhX#mkCy7FMYsjM8BZ^p|A=3Bko
zyZ|I`y=Bb=5N)$$^#TxWJEafIw`=JI^X*Ftz<h_4d@$cJBnZrRatQ?UolQ)@d>0jC
zFyB=+P=EmlLPckR`C+Vy1t5Od*BUTC{Hb#RBQq0;kbxn^1Y}B50Vqc6CNOd^FcdT}
a@c8(KFlZZ?1F<C#TQG3h07*Mt3oZbPsA3NQ

literal 619
zcma*fyGw#$6vy#nX+#QH6m+wzW@TPdD@*OB(NH$og(66iAZ&OCx1t;*s2m)eqQb$b
zq|vc4$f2#KXmH5FrG#p(=luSGIuD2M`+?_q{VSUrR{C>f;s!5||L-R@ajimZ-H(|4
zhqoSnSFL<ba2txbD7W$HJ<n~rAD6hzH=XO;mg^2!b0UXZ<K=MM_AA^TF2EhDIk<E7
z4(@VhV6EW_)-}iBZsifImtW>djQ;DQ#O--G%yWAm58%GrE!dC^!~N-b*qHRerkDjb
zN6fG#R0|KR%}FH2>NBr%ZEh26H`c&|8Z|tm`h-V|=Lx>&%$`NLuJkGFPDbIe*d9C{
z3BnVh06gjU!c$%k?6G&lUabzE)_90#<|9+$F4P~VxQmK_gnsY9O9hW4E0dT1|CA}j
xAqp?^Z-NrZiKHl16742PMHElT)ch?|&H4OfundcJh#eurfQ71DLSsfp)h})}XzBm}

diff --git a/lib/tzdata/zoneinfo/Asia/Dili b/lib/tzdata/zoneinfo/Asia/Dili
index bb7be9f3a47112bffcb2f33f70810819b5c2b726..22e705ca1ab1218e9f36b9f4f607258389853c8b 100644
GIT binary patch
delta 12
TcmZ3*xQcN?Dw7<;#B^r>8D#^f

delta 12
TcmZ3*xQcN?DwD*KiRsP&99INo

diff --git a/lib/tzdata/zoneinfo/Atlantic/Azores b/lib/tzdata/zoneinfo/Atlantic/Azores
index e6e2616e98b161a60546d26fcc49d90c45d92f38..cda1c1d225ae261ae433579e56d94a84ae2acd38 100644
GIT binary patch
delta 403
zcmZ3>{gZ1#7-uU30|N&T%TA0}ixgk*9|-22oIe3X&#UuR0MYYTT^0b*3*zg*@(X*|
z!19Znn8EzTdEH?C5@mC+`lbH+!RlABaf8KIJ+GN~?;I2JyUptuZ!*?{jQaUF_yEvS
z265)I6TtN6ePCMR@p>>Vd3gbtmO4BUOiS<CD*#d_vt}KbmYp*nOw0950Mqg{jbK_K
zrwB|d#w3GjC7%#5t!(28rd4#z0>KPb8FetN#v=iy)mfb<fGkk|Y67M;o~nXr&8uQy
zTI(n~nAW!CQvj*c-tq&?*O5OYFu9*)iX;;&3s%TJ*_l;OiBEu01f-2Y(#JQ1!2^hO
W4Ge+Uh(X)HfFay9IAn4Mt11AMFMdY=

delta 456
zcmey#wU&EA7-tUy0|Pq{OH7Pci{zZ}9|-22oDZhw)%Stv`KvAqfW#NX7l8Q-d)UDA
zBFC>_dU0Mim|mi+DF9Np)PFyiUd6@@7GL#c^~8JUm>9h`uVcK)SP!&}fp@m10Ep)6
zmIBlKEv^$le1Q@(FfEv(4yJ`d)E0omg<Uwod=V24Fke*pCzuu!eg&q*nQuer&u752
z#N*Q&7=S?X@;WeI>hOFpExqS-y#i32L1xV!FfBW0Etr<;nFprjYx=>oLQVsiR*WeG
z(@H)`U|QKG7)-0^xPWO@8B;K=#-j$N)mZ}<FaUx2S0^y7@zfYhYhG0W(^^NlM8OR0
uEk7nq4riI7z{-LjPG(`%6K7yx5b^O1VekNAT?0cPHe%2=Fqj;|stN#gl!I*m

diff --git a/lib/tzdata/zoneinfo/Atlantic/Madeira b/lib/tzdata/zoneinfo/Atlantic/Madeira
index cf965c3f9274923cc8410311741b0e30b06339bb..21e84571ee1694758dd244ed0702fbae962648e6 100644
GIT binary patch
delta 255
zcmZ3>eTQp87-RFqaNVf6oD=>7!Q7J*8$k5DI$Hq{J%80v1`xd<z5p!0u=@vCev#u>
zFn@7gEttPVSre>&ssBc>`c<rd!Q!i)=S{qKj*0of=5>rW83RB@{e0}YfdL4_d47Q?
z2Jz1u8bGwf<Aq>a^714wEp@mVOiS-s50qtKkXf?;Ov}!h2&UzFniw|Av#>BSGEFvM
zm1bsRWt;5Hs-Oy#6k%ZC6JV6^@eN^c17d9h0|s3KLm+L)5bhcR#KDs%u*w1e)4gnN

delta 330
zcmcb^wU&EA7-P@GaNVdmzZ?Do!Q7J*!SuZP1~5H;)lmkJ_=5N(Fn?k94=}yR@i~}Y
zoL38`mncg!fYdGZ-w38xvHk^%ulh1~;=OZBjJBKCG2UdXX8;1;+0r12fv=kfO!K#x
zH-H!dB^qE_Fhvqf3x!Bb0Er7b{|56#jDLaoqROwqw3zT6FfGn}7D9jC2c{(+?_B`W
zCwX}Rm@jpBBAAxmvsY38Bq6hA9hjD#GapRL^-K`he4Uwvaq>eJ$;lsBxPX{-@-G$z
oRXzbm5s(fBNgv-31~(wqHZWk&H82Fyh794Z!686mvOTLT0BqcO*#H0l

diff --git a/lib/tzdata/zoneinfo/CET b/lib/tzdata/zoneinfo/CET
index 546748d6eace6007bc1239dbe2bd5c324623ca56..31973271d2f87f7e9df4e8b0a1481f09a9e5407d 100644
GIT binary patch
literal 1103
zcmb8t{Yz6(7zgk>-LhoqO>@p^wOVUsb1!a_h#+h32XiZ-QDS9*B1JEZAyHA0FetGf
zW&{eewrsjAon_86r)6eal=d>U96^wjMNn1*(l2(O@BRSmT+aF2?{l7e;9jn^^iX9k
zGw<MW9W-fJ=YOP<Yg@og$s9L!b-({a9{n6<$cBQ#bEHcsx54q~4B0s8cam4U0eH37
z3EhtRn4_~A+V>o2o*}QD?X!_hsubkwr_9i6sD{mDGVHg=4ah!)3*N})!PbN`F~8|;
zbk5D`{m8f86vMXA7TEsO2mL-7?C|WcQUC4p0^~b2hheA9?4kNydnfEFR>44Fsg&y7
z8W#Cp?s3?Y{4?g<6zu&z2JcVQN~yo^?GG3Xe}Mfx5jfzk@zDN*h5+(IS0)@hQ4b#-
zya0zvPQu5V)gI~}-mnMx$;Lq#Dw#k%6kP<v+cHppK3&98|43`PlN@a_BEPt#hcAzn
zq5jG)LVmqHA30K&k33c+bJBmZ*jo;hY9%b?WQPfvt;&N-DikoqDu$_+0+#xg>i!_7
z$-Y8S>N}VoKN9oT02EJkz>J6oN`~rSX0V^7bF$j}a9N`pF2Cr6D^6EK=@C0zxwjmy
zGFzc+lL@X?=0SOu0<IB?p+aDE()o(tdbswZ9IhJ|!R+A#xV~!^D!pG|&gCdnIi5jv
zRS;?_+M#yeB+HA7=i`bK{QDJq;y+e~;Y;WZxRp;b3mGPfWrW-}lk!-)=cSn~R%R<V
icblw?5pyR6Zb{@~j@HQCDlIydL8Vbzv>H;aOZ*G`0?%at

delta 136
zcmX@l@s?#mn4l>G0|OHfbN&Z{**xM26YF(YPH+}Zn9R?lD%7MZ0204gBnGB0`8jM3
hW3pm&XJ8})GVlp7ure^nC@?ZOy9S2<iOGg6asV)+93ub#

diff --git a/lib/tzdata/zoneinfo/CST6CDT b/lib/tzdata/zoneinfo/CST6CDT
index d9315580584f6ad8f741781fab24d7af992c5df8..b016880653929aa40dd5ac0e82e4094a9d787cdf 100644
GIT binary patch
literal 1754
zcmb``YfzL`7{Kwv{UQjZBm$vHxgogR;v%kz!4Ba>SgseW(IHKuX<|#1ai+m_B26cw
zG{@}1#anoxMK?ksVMQVaYbHU74c!*9l`v%$Qv}*=&;OI(^h4*J^FHVIT+aLH)vPF3
z8!zs=T$~+p%cZ&hh~C-e>D<8%=UVAzuavR;P_$0Qitp}fWvtvX5m$ZIi}#%^5;DL4
z-8(iJ52!n-A6#w1hZdWte-*Tc{_2EATx~Z{KQie{e8jvPA06I=k2MwJnyx(jb$Kq<
z8`5!Y$y|K=i&Z-L-4prCwK5vsS%AOEOvQCCN8oQ2VYpu9flqqcaYN`8++elfMh|x(
z?`dpn!QWrD;!}FFP3D_g+i`Q55gS)@<I}Y&`ddmrz-Mwwskg3q6aNsi7Pn<@*U5W+
z40sl|&wc~9kG#r!hyU}qqbC!eecz5dBW~f&JRjz|)(;DL&-t{g_`;G4xO@7~_}9dG
z+#~eZ6towcEFa_F>~%Uh-)mflFPit@ONT$w%DlO0BmRBc+t^b667DO|;Qo?%_>Zh4
ze0k+G{O2;2P0m|0RYJxq$>DfF5sv?wBJiM>z=OB@@l|U-{=2&sUu$c{*PHva@}42R
zMJJ=J;tak~)`D+tI*5l058zv?w&H(sw&2_I3-Fzo*YL=b@7d%%cLNsUQSW>_I+8DB
zerzBMkN0HZf7_$5{bUq&RQucH|0F*3C%9}K!mh<b*zGMptvtBrP0-2cvFJMXOuL4?
zVt>J2I~3R_@C5d$*)Q9Luk8~&!Lp0GpQ+X+^Zv&5cw)m&9B_E2OpCz1Mfjm@Mfl;3
zOYx+FrFe2~3J%Ij!H>)d!BZkbaPW*|tvpQi9>*cBQ*p@6V4X~a_Ko4NbEEjt)0c4g
z@r!s`RWqKxAwaf^$2M2t8B1>9h}Tcq<l*teF8sv83OqBY4l8DD#tQp6olHdfuEvpO
z1D-Xg#!*eXadg)!TG=<dycjDD891gS7su|JiR1D&$Tktb&KoCWF2_&3IEWJ!sW>VA
zC!FjRhEqZZZ1Rv|wc|Ns9XPekg6H-g!z%r_PA29xeu$qgGvoQ6YjIkk5icm+p_P5l
z<m|)gYYK5jOet1pynxli^}^NV0Uoz|dfYwk!GjF{uRRV&&3X9~H`KbgI~+$Vg||El
xKQe*5CqI|15$PGuy;vjE&Yix@xff}KuQQS4EJSA~DC3o}(b;iv$~a}L?|+gw5kdd}

delta 176
zcmcb`yPbVP7-s|n0|N^X3rtK`5kB4Vui-xsTvGm00HzZ;H~TSnGSxFOFfuSP0|_d_
n|NmDnU|{+Gf9D291~AD1CV8A)LKvKbfjAt9141SrWRnB{8}BD_

diff --git a/lib/tzdata/zoneinfo/EET b/lib/tzdata/zoneinfo/EET
index 378919ea113105881f9ade477d91692f6ac263b9..231bf9c3b713e3676dbd8f3ced867973c601e104 100644
GIT binary patch
delta 344
zcmey!yoz-~SiLy|0|OfnOZ^9e68jl0AbNI#VgrcYS@ZG%m_D}t0*F5ODH+T^C9om@
z#6R=gTL46#UFGuuM4wwE0hT{MIkN!7zb`y50Zeb_3IN){!1*RF0Yr04e1Xtsz1D&F
z3_N@1gK6F+p$#AgUr#KU=5H|v(*jw41VG|~Db*i9v{2A0FfHuXlmOz37#|9lIR9ro
zGZQltD+?<Nh$bE~Fo@ZJOaYQC3=CQZj2sLMG71d5Kz9f*2!hy*qCUPM430qT>KY6p
XLKvLE7|7uQ@^p<r;yRP>F$x0!Dray?

delta 146
zcmZ3*`jL4;n5Q}e0|OHfa{@5~?~>#RAeygRN&rOjx444&0wrc(S};W&ObdlbfN5c0
q7Xgqu5#wJICd)Jav}9l;3NpwjFt9Q(Xc;gvxVi?10Ex+6ObP(|bP{U-

diff --git a/lib/tzdata/zoneinfo/EST b/lib/tzdata/zoneinfo/EST
index 3ae969114563a5d7a1df96237c38a10df92baf56..9154643f4c9189998392afb8a93e2e2eb9eaecf5 100644
GIT binary patch
delta 69
zcmd0w$~Ym+o{52hff<N-{sTc~yP5!q?*5Yaf|2R}|E&cK3_wzXf#v`Iof{Z9e0)O~
QoPpRiID~-<NSJZ~0Q8v~cmMzZ

delta 30
kcmbQrm_H$Gq5_L3BLf2i%m4p7H!v``28S?k0SQws0Eg-bLjV8(

diff --git a/lib/tzdata/zoneinfo/EST5EDT b/lib/tzdata/zoneinfo/EST5EDT
index 50c95e0cb07692f2a177a505041a10f284cf0a60..2b6c2eea14df07392729ae9f5712a44ec4f02bae 100644
GIT binary patch
literal 1744
zcmb8vc~FdD90%~HLuD)FSXb_AZECl}O63S8VJF8nxh5}Dn&pq)VT2iS6v+%R8pbh8
zbU9ZSR%{`w$+%iaIr5f-h*vpM?0TNB|CxR}&wlswdw;)Y|Jv0o(ys6$|1BFj!450U
z|5x;MtP4H8th8e6#JwzaIfHnX$F6+fSRUU&;LO8!;S+K7@X6%&0(+jd@;sca%Ej}X
z`IRE;=StJyJpZ$Bo+TUer+e;!PuHfxXIgpqtWgV}GtYz1>t@0F!m;p$ByTwX=v<!N
zUl2c&V_CS-A1(^_f{T|(;fu0v@TK4%@MQ-PHh9#)hQ=zm#QvMe?kO=9!B-oe!q@Z<
z1lBi}8{pFP0=O*e2z)&u1HO^63BDPb2$#n$g>NYrz$W!Zp51fXEeNjgj)5!MqB+*D
zbPa(ks{`RXJ4Lu^_}9P5bzslDwn1d`k3wF;kE2ZRlOd(>Q&k>ZO)}vc=`OfNNQR$T
za(TA@yetlWQJV(8JhhEu{aWKH_*GggEa=p5opw50pQMCeM~sFWV!Fd`q7?$$Zw&Vq
zS-uT$hu_KE;P<^-;3kJJaMSlk@P|e-{PD>}xY<+;e=0R|?4Hm1DxRfytQh{1UIe#n
zJ_xra9Du(r-2i`!Tn~SrycqtWTm-j`UMH}7e!5M7+npA|?QIK0*6(;14F9SQf`3;G
zge{i`z}8%=Kz}2I9JGimY*On4mbU8z*p9bw%=X-Go@JLg0>{!J<Q44ba|3qV-4E{S
zo&|S3mw|nWxC3?;w&S@=%?W|faxII8yBShow^PZOcR#cO?w%G0_t-E4?x_ujdoA>Y
zr4e$tcc2U0NA3*w9VX`pt$t3;aDQ88xPOa;XMK;lW_ZBEkMO|j_u)bL_u#>q`S6fL
zg8iXe_rt@Y>fzxl^#Y+aLRAiroVgDkCC!0lo@-#4<tESO<dP^@UYiYjHU+?AjH$4f
zS;NsW;;qxdio$WQGHDj<v%fFw8y_#SIltBIuzz?2Ja*m-SS1?+kMlFa0gkTlc#mfS
zp*6noGaT4)6%H~zgoB^!;0gLqJe!+XvIU-${s5kQWH}s?PykO!+04-~GBq*-o))_d
z4pk<?VWHFDu+}`$)~1s$JNr&9boLAWId8RI(Gf!b%F1l)tyaSY;)KsGcz2(z){wAJ
gdgjv;P0t(+kx-~;(@X8I@KgABseOGFz6u}7AFmWIC;$Ke

delta 176
zcmcb>yPbVP7-s|n0|N^X3rtK`5kB4Vq2NCdTvGl5p%Z>@_G9j3s%K<iWME<j5>$r&
m|L@$u!1Dk9@dJzuV3Gq&^0>N$Ft`Q-aX1hMgiPMfCJ6wP1}L!r

diff --git a/lib/tzdata/zoneinfo/Europe/Lisbon b/lib/tzdata/zoneinfo/Europe/Lisbon
index f0c70b690660ce4ebf469a7016f9b8343eb20ea6..7e9aae727b2b660e7f5e383121f445daf033a9c5 100644
GIT binary patch
delta 268
zcmZ3-y`6hP7-QeWaJ|Ui4gY~)?#bo?5IwI>p8-VAU$yN6h+Yt%1eRae{R%9<$niOt
zzc?=+%wM7`4OYL@e-T*yD%SU4@m0^`C*C{9#C&P<I>wuf>>#6lJ~p4+#w=g&I)MQQ
z1WL@nv|x%lm=+3=0Mo+0E&?EV5#wKAzNqru1`uCN_#BuPXWkE?KW_lj5|0;xY01lz
sz_iriW-u+iXFUT5$gEiare)_$1k-YxRan>=nHX6nUtm#~?8BM_04&vT?EnA(

delta 263
zcmdnay^ecA7-R3maJ|U41^<Cy?#X5_J+Hn9OwV7n?E^@BL3{|9zp(oim|o;~6HG78
z%Lmg-lzBdY)GhU21g2N9z6Xo1`qDS?-Z>^l{mttbZ!%8qXO^osZ(sldff5ZcEtnz+
zriDTzCV<3+oqvP*BF4YKd{O1sU|LN04wx2aJ`15g?*r2kkM}MB>65&?0L+&<JP}Mw
o@7XH=5|>%C4ou6=nGdGrHtVpkGcvMFc4QTq{D6gLawuyO0KblIwEzGB

diff --git a/lib/tzdata/zoneinfo/HST b/lib/tzdata/zoneinfo/HST
index 160a53e045c872be729de80a522bb8b6f6ddee91..40e3d492e6c22c30041c31f159d4fe0ee9451c03 100644
GIT binary patch
literal 221
zcmWHE%1kq2AP5+NDnJ+nLI`VN2P$I&Vv+wqQ1YN)ABf(~>g)lg6$>Lk^yyC96CnDM
z@|OZIo#<%+qObNAdoVIFGP5wU{{NrD#J~U~BN$lz|F6nm<N%XAU{c`!|KbD&79Zab
X29IDMb^+pWAPxv&-~tL58gKysKlwyC

delta 31
lcmcc1STG@Mq5_K;BLf2i%m4qy2@DJ#!66J>K*G>~3jmQE2q^#n

diff --git a/lib/tzdata/zoneinfo/MET b/lib/tzdata/zoneinfo/MET
index 6f0558c3b6f4ab18385bc549894cc16098eade75..31973271d2f87f7e9df4e8b0a1481f09a9e5407d 100644
GIT binary patch
literal 1103
zcmb8t{Yz6(7zgk>-LhoqO>@p^wOVUsb1!a_h#+h32XiZ-QDS9*B1JEZAyHA0FetGf
zW&{eewrsjAon_86r)6eal=d>U96^wjMNn1*(l2(O@BRSmT+aF2?{l7e;9jn^^iX9k
zGw<MW9W-fJ=YOP<Yg@og$s9L!b-({a9{n6<$cBQ#bEHcsx54q~4B0s8cam4U0eH37
z3EhtRn4_~A+V>o2o*}QD?X!_hsubkwr_9i6sD{mDGVHg=4ah!)3*N})!PbN`F~8|;
zbk5D`{m8f86vMXA7TEsO2mL-7?C|WcQUC4p0^~b2hheA9?4kNydnfEFR>44Fsg&y7
z8W#Cp?s3?Y{4?g<6zu&z2JcVQN~yo^?GG3Xe}Mfx5jfzk@zDN*h5+(IS0)@hQ4b#-
zya0zvPQu5V)gI~}-mnMx$;Lq#Dw#k%6kP<v+cHppK3&98|43`PlN@a_BEPt#hcAzn
zq5jG)LVmqHA30K&k33c+bJBmZ*jo;hY9%b?WQPfvt;&N-DikoqDu$_+0+#xg>i!_7
z$-Y8S>N}VoKN9oT02EJkz>J6oN`~rSX0V^7bF$j}a9N`pF2Cr6D^6EK=@C0zxwjmy
zGFzc+lL@X?=0SOu0<IB?p+aDE()o(tdbswZ9IhJ|!R+A#xV~!^D!pG|&gCdnIi5jv
zRS;?_+M#yeB+HA7=i`bK{QDJq;y+e~;Y;WZxRp;b3mGPfWrW-}lk!-)=cSn~R%R<V
icblw?5pyR6Zb{@~j@HQCDlIydL8Vbzv>H;aOZ*G`0?%at

delta 162
zcmX@l@s?#mn4l>G0|OHfbN&Z{**xM26YF(YPH+}Zn9R?lD%7MZ0204gBnGB0`8jM3
zW3pmQWnd%&GVlp7ure^nC@?bkx(0^;i4X=ZAfamr;_CPs>zV2q==d5MfM|VVE&yj+
BA-(_r

diff --git a/lib/tzdata/zoneinfo/MST b/lib/tzdata/zoneinfo/MST
index a0953d1e791eaddbec13d086f7c4588738297606..c2bd2f949b248b835c98216b4dc66f9f6eb0265e 100644
GIT binary patch
literal 240
zcmWHE%1kq2AP5+NDnJ+nLI`W&1}b9#VuAla5XZu^0YuMRW;Fps&)?170HPPP$$<F_
zXT1dTPj~Ww`RB#&%Yfw1_di_&qAxT`f%(6FlnQ|Ozh6W!FfjrlGY~Q|{r^Ah9RtJv
l|Em`;vi$!)cLD<kn9bwk8^Yl00>r^U93H~J1!S0W0RTV0SUUg!

delta 30
kcmeysm_H$Gq5_L3BLf2i%m4p#ConMh28S?k0SR+10FUShbN~PV

diff --git a/lib/tzdata/zoneinfo/MST7MDT b/lib/tzdata/zoneinfo/MST7MDT
index 137867c8bf5b2df2e55e8c0c84ecc7deafc3ba79..09e54e5c7c5bb2384e37626d4b985cfad29ed29b 100644
GIT binary patch
delta 227
zcmdnaK8a&Om|!9U0|P4%i~I+II2N7_6XR8+7p4B20OBuhVPgQ%OI#m-`AhnjO{|lZ
z{;ppJ=Kj!_0+#;C9|7k7;walVt&^#qi4h8!S>Q~V5LM{^|L0C&09w6z0V4~LJ%ND(
S%;o`;0xUkhAq<oInKb~RE=L0Z

delta 175
zcmbQlv7LQF7-s|n0|N^X3rtK`5kB3?GvPlFTvGm00HzZqHs0%Gs%K<iWME<j5>$r&
m|IeMk!1Dk9>IIApV3Gq&^7y)hF!%-oaX1hMgiQX)EC~RTXC}h{

diff --git a/lib/tzdata/zoneinfo/Mexico/BajaNorte b/lib/tzdata/zoneinfo/Mexico/BajaNorte
index 42087af4cceb049f1395cabaaa85b7c39253ed97..18d0d14afc1cdf37c8f3607181e3f72211da99e9 100644
GIT binary patch
delta 98
zcmZqV*v>H_j4@?mxGeKW%Z7>Ny3TXgefSRq*QFyFK=h4?TfqF=4D4Y3?E}SN{+)Z9
k7l7pNu3R$#MBm#t70kci**9V1_ODEn3z*p^uVD@a0Q@;YIRF3v

delta 46
zcmdna(a13&j4^IvxGeLhnhz7pb%kf{D)<is*QFyFK=h4?TRv=j{*`I+Bj!*58j%^R

diff --git a/lib/tzdata/zoneinfo/Mexico/BajaSur b/lib/tzdata/zoneinfo/Mexico/BajaSur
index 97d4d36c137fce3b89da84ba2b27dc17a86a15cb..5aa6039ea4cb36077f048782b54c6275c25e86b3 100644
GIT binary patch
delta 86
zcmX@dx`}l{n5HcQ0|N^X3;YLyrQ2Q<favufwZZhZw6Fvaf4ie?!Nhurjmx()PEKMn
dnLLF_O3cSMguypBguxkzeO*ErxPTmUE&ww-CF=kH

delta 119
zcmdnQdX9BMn5I1g0|P4%i~I+IrQ2Q<favv~@*aTbZE0Z%AbPv=rG$y~5&|Ihjfq=6
z0M!FQLBq!B+Zh>ICI>PZPflQBncTu8q458Ie*=Snk8cQrZ*T~MGZ6c_gfIjEX)d6E
GITrvCBs3lX

diff --git a/lib/tzdata/zoneinfo/Mexico/General b/lib/tzdata/zoneinfo/Mexico/General
index 80a415c70ca3d94aa25bbc1e90f3ed169943a704..18112346129a885b5d5fa27109682b63784f72c0 100644
GIT binary patch
delta 30
icmZo=Yh{~|Bm7aj;6D&-OAAW?(c2wu3pUobF#!Pk^AOnp

delta 30
icmZo=Yh{~|Bm61v!G9pwmKK%(qPII=O4wN6#smNkM-mhO

diff --git a/lib/tzdata/zoneinfo/PST8PDT b/lib/tzdata/zoneinfo/PST8PDT
index fde4833f6be38b0d3627ec08d861e25e789fddb4..aaf07787ad92b65eadae63b64bba290f9f961507 100644
GIT binary patch
delta 482
zcmdna-p4f|Ot6-Lfq@l>Mg9Xp9E;R}iSah|*Z!5nfcQ5W)=mJ?xBeXl)3*;y5CHM-
z+*=Cf-(9%|OyAqr4yNyS_JQdK^D@Eo!^{FO{ix0xOh5Jv0@F|8biwpfO%pKv%-u@>
zWbSjJKoDL3|Ao2^Sm4DcV=(=Soex4^5(U$*pM3z+Z#I4h({GPm0@Lp%-UQR{*T0(p
zGVnv;ZZQ92{{=ArQ~g0O{W*UVnEn#K7)*clp8}@8*|!2|+5i8)>z9EAerPNb02%a?
zKLX7E#nG~HS|?LI6C)5Zvw$fOldkape}#!^3=IGO&z-=?^8bH-0|N(`%>yO{e0)O~
JCigRI003g({P_R?

delta 156
zcmeC<+Ri>9j5C6Pfq?~x1tzB3Y(C7`!c@=5z{tSF3?!%w|NrlAU|{+Gf9?cE1~AD1
XCV2u}LKp&qfjAt9141T$Wsw8`b4nPl

diff --git a/lib/tzdata/zoneinfo/Portugal b/lib/tzdata/zoneinfo/Portugal
index f0c70b690660ce4ebf469a7016f9b8343eb20ea6..7e9aae727b2b660e7f5e383121f445daf033a9c5 100644
GIT binary patch
delta 268
zcmZ3-y`6hP7-QeWaJ|Ui4gY~)?#bo?5IwI>p8-VAU$yN6h+Yt%1eRae{R%9<$niOt
zzc?=+%wM7`4OYL@e-T*yD%SU4@m0^`C*C{9#C&P<I>wuf>>#6lJ~p4+#w=g&I)MQQ
z1WL@nv|x%lm=+3=0Mo+0E&?EV5#wKAzNqru1`uCN_#BuPXWkE?KW_lj5|0;xY01lz
sz_iriW-u+iXFUT5$gEiare)_$1k-YxRan>=nHX6nUtm#~?8BM_04&vT?EnA(

delta 263
zcmdnay^ecA7-R3maJ|U41^<Cy?#X5_J+Hn9OwV7n?E^@BL3{|9zp(oim|o;~6HG78
z%Lmg-lzBdY)GhU21g2N9z6Xo1`qDS?-Z>^l{mttbZ!%8qXO^osZ(sldff5ZcEtnz+
zriDTzCV<3+oqvP*BF4YKd{O1sU|LN04wx2aJ`15g?*r2kkM}MB>65&?0L+&<JP}Mw
o@7XH=5|>%C4ou6=nGdGrHtVpkGcvMFc4QTq{D6gLawuyO0KblIwEzGB

diff --git a/lib/tzdata/zoneinfo/WET b/lib/tzdata/zoneinfo/WET
index 423c6c203a508a162f86fbe44822b78213b575ff..7e9aae727b2b660e7f5e383121f445daf033a9c5 100644
GIT binary patch
literal 1463
zcma*mdoWZ{90%~bu{BtaC}F8(lSr&bN>kI6G#R8}8#GCSkxFI6)HF>awim{rG!4pH
zjAkS6&?xfAD}+?!6(J%k38{3?_x{s=+&gDK=lA=bb9VRctnlb5e@kk~i$$*>gIvO;
zx5UuPR?>sJNMFZybM%Pu!!cpRB*(Ks@NX^Z<m3hTpgscqhgZ!hlBY<Y%7|ibALOY~
zW5^|YM^LAoJC8b@&&B!-7YWu&*^}r?N4!yI*Jr{fnS7Wdc0rzdlZ`s>_8FKTWPpA_
z@GV$)SRNKzI>8dvI>yCPSUM?%Wp%|e@;RTEJc2J$ywNYeABnmmQ3hXL3WSvbUa-pJ
z5Uk$A4kG(&b_h_v+IbJwdSszr+t~-}<=Pmhc(7r>M@IHF7P&Hxr}dNib(kY#H}gE2
z60DIoRXLs@d2_G?d2>xU&S?qNMBb8h68$%>BF2nV<gLOv<gL*T=(kz=GhSzYuXfLB
z<Zm5{V25ohkG#)2<4X8my8wPrNN1c+fSsc^U{~iw__00!c9(j>o_vv*oYN}_g?;h<
zus_@#ehNMa2YhVdpsNY|ypIcqEIDvk{|_AD8uQ3`UzBth7nI=W*l#%2H37di^uqCH
zEpS3w0ly{Y!O2JolwH09r%sFDci$W_Ie*$s41d_g!5OP?_>+GD&T9C<Ik_W@(+A-E
z;C3<npP@L9O$d~75*MmOaiFTmK9)?>LTun_KO?9v)Pfq$`_)Lk#_AX9wfvqiQfq27
z!*z1yjMKSLYcLgRx5q=BstCv}%c01nn<a*N$#HOfbS%!_aOE201qMU?W4_S9NeKD7
z?BPaJ8)&F&1UGTCpb^_HmK<m_V+}VC8A9U@O=wcH3T`Q!gQn@DaO>SJXeMfe<{@QJ
z;Fk?8ygJpW6|Cjoa`f8&$8vYdFSSsfjhnT&IO|Kksfrp)o=7RsPnE|~CLKy0b4@2_
nA?0rGMqbFED?55(M>>jhOF%MHXDhR9W&(2yQ)deSnJNAQHdoT(

delta 178
zcmdna{f>D;n4~%b0|OHfa{@5~?~>#RAeygRN?`JGW;3tXV6K?(9WX7<d=^4~-Up^7
z9<K+}l9v~NX{o~#!L;<Ay#gR(WY(+$)3S5s3rtpLSz*P<KpX^VW(7J!fRQ2GH8=!F
JOrFIm3jjUo9n=5-

diff --git a/lib/tzdata/zoneinfo/leapseconds b/lib/tzdata/zoneinfo/leapseconds
index ce150bfe..6c715cb2 100644
--- a/lib/tzdata/zoneinfo/leapseconds
+++ b/lib/tzdata/zoneinfo/leapseconds
@@ -69,11 +69,11 @@ Leap	2016	Dec	31	23:59:60	+	S
 # Any additional leap seconds will come after this.
 # This Expires line is commented out for now,
 # so that pre-2020a zic implementations do not reject this file.
-#Expires 2024	Dec	28	00:00:00
+#Expires 2025	Jun	28	00:00:00
 
 # POSIX timestamps for the data in this file:
-#updated 1704708379 (2024-01-08 10:06:19 UTC)
-#expires 1735344000 (2024-12-28 00:00:00 UTC)
+#updated 1720104763 (2024-07-04 14:52:43 UTC)
+#expires 1751068800 (2025-06-28 00:00:00 UTC)
 
 #	Updated through IERS Bulletin C (https://hpiers.obspm.fr/iers/bul/bulc/bulletinc.dat)
-#	File expires on 28 December 2024
+#	File expires on 28 June 2025
diff --git a/lib/tzdata/zoneinfo/tzdata.zi b/lib/tzdata/zoneinfo/tzdata.zi
index be1c4085..62e78bb8 100644
--- a/lib/tzdata/zoneinfo/tzdata.zi
+++ b/lib/tzdata/zoneinfo/tzdata.zi
@@ -1,4 +1,4 @@
-# version 2024a
+# version 2024b
 # This zic input file is in the public domain.
 R d 1916 o - Jun 14 23s 1 S
 R d 1916 1919 - O Su>=1 23s 0 -
@@ -1324,14 +1324,10 @@ R O 1961 1964 - May lastSu 1s 1 S
 R O 1962 1964 - S lastSu 1s 0 -
 R p 1916 o - Jun 17 23 1 S
 R p 1916 o - N 1 1 0 -
-R p 1917 o - F 28 23s 1 S
-R p 1917 1921 - O 14 23s 0 -
-R p 1918 o - Mar 1 23s 1 S
-R p 1919 o - F 28 23s 1 S
-R p 1920 o - F 29 23s 1 S
-R p 1921 o - F 28 23s 1 S
+R p 1917 1921 - Mar 1 0 1 S
+R p 1917 1921 - O 14 24 0 -
 R p 1924 o - Ap 16 23s 1 S
-R p 1924 o - O 14 23s 0 -
+R p 1924 o - O 4 23s 0 -
 R p 1926 o - Ap 17 23s 1 S
 R p 1926 1929 - O Sa>=1 23s 0 -
 R p 1927 o - Ap 9 23s 1 S
@@ -1349,8 +1345,9 @@ R p 1938 o - Mar 26 23s 1 S
 R p 1939 o - Ap 15 23s 1 S
 R p 1939 o - N 18 23s 0 -
 R p 1940 o - F 24 23s 1 S
-R p 1940 1941 - O 5 23s 0 -
+R p 1940 o - O 7 23s 0 -
 R p 1941 o - Ap 5 23s 1 S
+R p 1941 o - O 5 23s 0 -
 R p 1942 1945 - Mar Sa>=8 23s 1 S
 R p 1942 o - Ap 25 22s 2 M
 R p 1942 o - Au 15 22s 1 S
@@ -1360,16 +1357,16 @@ R p 1943 1945 - Au Sa>=25 22s 1 S
 R p 1944 1945 - Ap Sa>=21 22s 2 M
 R p 1946 o - Ap Sa>=1 23s 1 S
 R p 1946 o - O Sa>=1 23s 0 -
-R p 1947 1965 - Ap Su>=1 2s 1 S
+R p 1947 1966 - Ap Su>=1 2s 1 S
 R p 1947 1965 - O Su>=1 2s 0 -
-R p 1977 o - Mar 27 0s 1 S
-R p 1977 o - S 25 0s 0 -
-R p 1978 1979 - Ap Su>=1 0s 1 S
-R p 1978 o - O 1 0s 0 -
-R p 1979 1982 - S lastSu 1s 0 -
-R p 1980 o - Mar lastSu 0s 1 S
-R p 1981 1982 - Mar lastSu 1s 1 S
-R p 1983 o - Mar lastSu 2s 1 S
+R p 1976 o - S lastSu 1 0 -
+R p 1977 o - Mar lastSu 0s 1 S
+R p 1977 o - S lastSu 0s 0 -
+R p 1978 1980 - Ap Su>=1 1s 1 S
+R p 1978 o - O 1 1s 0 -
+R p 1979 1980 - S lastSu 1s 0 -
+R p 1981 1986 - Mar lastSu 0s 1 S
+R p 1981 1985 - S lastSu 0s 0 -
 R z 1932 o - May 21 0s 1 S
 R z 1932 1939 - O Su>=1 0s 0 -
 R z 1933 1939 - Ap Su>=2 0s 1 S
@@ -1728,7 +1725,7 @@ R Y 1972 2006 - O lastSu 2 0 S
 R Y 1987 2006 - Ap Su>=1 2 1 D
 R Yu 1965 o - Ap lastSu 0 2 DD
 R Yu 1965 o - O lastSu 2 0 S
-R m 1931 o - May 1 23 1 D
+R m 1931 o - April 30 0 1 D
 R m 1931 o - O 1 0 0 S
 R m 1939 o - F 5 0 1 D
 R m 1939 o - Jun 25 0 0 S
@@ -2096,15 +2093,15 @@ Z Africa/Algiers 0:12:12 - LMT 1891 Mar 16
 0 d WE%sT 1981 May
 1 - CET
 Z Africa/Bissau -1:2:20 - LMT 1912 Ja 1 1u
--1 - -01 1975
+-1 - %z 1975
 0 - GMT
 Z Africa/Cairo 2:5:9 - LMT 1900 O
 2 K EE%sT
 Z Africa/Casablanca -0:30:20 - LMT 1913 O 26
-0 M +00/+01 1984 Mar 16
-1 - +01 1986
-0 M +00/+01 2018 O 28 3
-1 M +01/+00
+0 M %z 1984 Mar 16
+1 - %z 1986
+0 M %z 2018 O 28 3
+1 M %z
 Z Africa/Ceuta -0:21:16 - LMT 1901 Ja 1 0u
 0 - WET 1918 May 6 23
 0 1 WEST 1918 O 7 23
@@ -2115,9 +2112,9 @@ Z Africa/Ceuta -0:21:16 - LMT 1901 Ja 1 0u
 1 - CET 1986
 1 E CE%sT
 Z Africa/El_Aaiun -0:52:48 - LMT 1934
--1 - -01 1976 Ap 14
-0 M +00/+01 2018 O 28 3
-1 M +01/+00
+-1 - %z 1976 Ap 14
+0 M %z 2018 O 28 3
+1 M %z
 Z Africa/Johannesburg 1:52 - LMT 1892 F 8
 1:30 - SAST 1903 Mar
 2 SA SAST
@@ -2132,19 +2129,19 @@ Z Africa/Khartoum 2:10:8 - LMT 1931
 Z Africa/Lagos 0:13:35 - LMT 1905 Jul
 0 - GMT 1908 Jul
 0:13:35 - LMT 1914
-0:30 - +0030 1919 S
+0:30 - %z 1919 S
 1 - WAT
-Z Africa/Maputo 2:10:20 - LMT 1903 Mar
+Z Africa/Maputo 2:10:18 - LMT 1909
 2 - CAT
 Z Africa/Monrovia -0:43:8 - LMT 1882
 -0:43:8 - MMT 1919 Mar
 -0:44:30 - MMT 1972 Ja 7
 0 - GMT
 Z Africa/Nairobi 2:27:16 - LMT 1908 May
-2:30 - +0230 1928 Jun 30 24
+2:30 - %z 1928 Jun 30 24
 3 - EAT 1930 Ja 4 24
-2:30 - +0230 1936 D 31 24
-2:45 - +0245 1942 Jul 31 24
+2:30 - %z 1936 D 31 24
+2:45 - %z 1942 Jul 31 24
 3 - EAT
 Z Africa/Ndjamena 1:0:12 - LMT 1912
 1 - WAT 1979 O 14
@@ -2168,7 +2165,7 @@ Z Africa/Tunis 0:40:44 - LMT 1881 May 12
 0:9:21 - PMT 1911 Mar 11
 1 n CE%sT
 Z Africa/Windhoek 1:8:24 - LMT 1892 F 8
-1:30 - +0130 1903 Mar
+1:30 - %z 1903 Mar
 2 - SAST 1942 S 20 2
 2 1 SAST 1943 Mar 21 2
 2 - SAST 1990 Mar 21
@@ -2191,167 +2188,166 @@ Z America/Anchorage 14:0:24 - LMT 1867 O 19 14:31:37
 -9 u Y%sT 1983 N 30
 -9 u AK%sT
 Z America/Araguaina -3:12:48 - LMT 1914
--3 B -03/-02 1990 S 17
--3 - -03 1995 S 14
--3 B -03/-02 2003 S 24
--3 - -03 2012 O 21
--3 B -03/-02 2013 S
--3 - -03
+-3 B %z 1990 S 17
+-3 - %z 1995 S 14
+-3 B %z 2003 S 24
+-3 - %z 2012 O 21
+-3 B %z 2013 S
+-3 - %z
 Z America/Argentina/Buenos_Aires -3:53:48 - LMT 1894 O 31
 -4:16:48 - CMT 1920 May
--4 - -04 1930 D
--4 A -04/-03 1969 O 5
--3 A -03/-02 1999 O 3
--4 A -04/-03 2000 Mar 3
--3 A -03/-02
+-4 - %z 1930 D
+-4 A %z 1969 O 5
+-3 A %z 1999 O 3
+-4 A %z 2000 Mar 3
+-3 A %z
 Z America/Argentina/Catamarca -4:23:8 - LMT 1894 O 31
 -4:16:48 - CMT 1920 May
--4 - -04 1930 D
--4 A -04/-03 1969 O 5
--3 A -03/-02 1991 Mar 3
--4 - -04 1991 O 20
--3 A -03/-02 1999 O 3
--4 A -04/-03 2000 Mar 3
--3 - -03 2004 Jun
--4 - -04 2004 Jun 20
--3 A -03/-02 2008 O 18
--3 - -03
+-4 - %z 1930 D
+-4 A %z 1969 O 5
+-3 A %z 1991 Mar 3
+-4 - %z 1991 O 20
+-3 A %z 1999 O 3
+-4 A %z 2000 Mar 3
+-3 - %z 2004 Jun
+-4 - %z 2004 Jun 20
+-3 A %z 2008 O 18
+-3 - %z
 Z America/Argentina/Cordoba -4:16:48 - LMT 1894 O 31
 -4:16:48 - CMT 1920 May
--4 - -04 1930 D
--4 A -04/-03 1969 O 5
--3 A -03/-02 1991 Mar 3
--4 - -04 1991 O 20
--3 A -03/-02 1999 O 3
--4 A -04/-03 2000 Mar 3
--3 A -03/-02
+-4 - %z 1930 D
+-4 A %z 1969 O 5
+-3 A %z 1991 Mar 3
+-4 - %z 1991 O 20
+-3 A %z 1999 O 3
+-4 A %z 2000 Mar 3
+-3 A %z
 Z America/Argentina/Jujuy -4:21:12 - LMT 1894 O 31
 -4:16:48 - CMT 1920 May
--4 - -04 1930 D
--4 A -04/-03 1969 O 5
--3 A -03/-02 1990 Mar 4
--4 - -04 1990 O 28
--4 1 -03 1991 Mar 17
--4 - -04 1991 O 6
--3 1 -02 1992
--3 A -03/-02 1999 O 3
--4 A -04/-03 2000 Mar 3
--3 A -03/-02 2008 O 18
--3 - -03
+-4 - %z 1930 D
+-4 A %z 1969 O 5
+-3 A %z 1990 Mar 4
+-4 - %z 1990 O 28
+-4 1 %z 1991 Mar 17
+-4 - %z 1991 O 6
+-3 1 %z 1992
+-3 A %z 1999 O 3
+-4 A %z 2000 Mar 3
+-3 A %z 2008 O 18
+-3 - %z
 Z America/Argentina/La_Rioja -4:27:24 - LMT 1894 O 31
 -4:16:48 - CMT 1920 May
--4 - -04 1930 D
--4 A -04/-03 1969 O 5
--3 A -03/-02 1991 Mar
--4 - -04 1991 May 7
--3 A -03/-02 1999 O 3
--4 A -04/-03 2000 Mar 3
--3 - -03 2004 Jun
--4 - -04 2004 Jun 20
--3 A -03/-02 2008 O 18
--3 - -03
+-4 - %z 1930 D
+-4 A %z 1969 O 5
+-3 A %z 1991 Mar
+-4 - %z 1991 May 7
+-3 A %z 1999 O 3
+-4 A %z 2000 Mar 3
+-3 - %z 2004 Jun
+-4 - %z 2004 Jun 20
+-3 A %z 2008 O 18
+-3 - %z
 Z America/Argentina/Mendoza -4:35:16 - LMT 1894 O 31
 -4:16:48 - CMT 1920 May
--4 - -04 1930 D
--4 A -04/-03 1969 O 5
--3 A -03/-02 1990 Mar 4
--4 - -04 1990 O 15
--4 1 -03 1991 Mar
--4 - -04 1991 O 15
--4 1 -03 1992 Mar
--4 - -04 1992 O 18
--3 A -03/-02 1999 O 3
--4 A -04/-03 2000 Mar 3
--3 - -03 2004 May 23
--4 - -04 2004 S 26
--3 A -03/-02 2008 O 18
--3 - -03
+-4 - %z 1930 D
+-4 A %z 1969 O 5
+-3 A %z 1990 Mar 4
+-4 - %z 1990 O 15
+-4 1 %z 1991 Mar
+-4 - %z 1991 O 15
+-4 1 %z 1992 Mar
+-4 - %z 1992 O 18
+-3 A %z 1999 O 3
+-4 A %z 2000 Mar 3
+-3 - %z 2004 May 23
+-4 - %z 2004 S 26
+-3 A %z 2008 O 18
+-3 - %z
 Z America/Argentina/Rio_Gallegos -4:36:52 - LMT 1894 O 31
 -4:16:48 - CMT 1920 May
--4 - -04 1930 D
--4 A -04/-03 1969 O 5
--3 A -03/-02 1999 O 3
--4 A -04/-03 2000 Mar 3
--3 - -03 2004 Jun
--4 - -04 2004 Jun 20
--3 A -03/-02 2008 O 18
--3 - -03
+-4 - %z 1930 D
+-4 A %z 1969 O 5
+-3 A %z 1999 O 3
+-4 A %z 2000 Mar 3
+-3 - %z 2004 Jun
+-4 - %z 2004 Jun 20
+-3 A %z 2008 O 18
+-3 - %z
 Z America/Argentina/Salta -4:21:40 - LMT 1894 O 31
 -4:16:48 - CMT 1920 May
--4 - -04 1930 D
--4 A -04/-03 1969 O 5
--3 A -03/-02 1991 Mar 3
--4 - -04 1991 O 20
--3 A -03/-02 1999 O 3
--4 A -04/-03 2000 Mar 3
--3 A -03/-02 2008 O 18
--3 - -03
+-4 - %z 1930 D
+-4 A %z 1969 O 5
+-3 A %z 1991 Mar 3
+-4 - %z 1991 O 20
+-3 A %z 1999 O 3
+-4 A %z 2000 Mar 3
+-3 A %z 2008 O 18
+-3 - %z
 Z America/Argentina/San_Juan -4:34:4 - LMT 1894 O 31
 -4:16:48 - CMT 1920 May
--4 - -04 1930 D
--4 A -04/-03 1969 O 5
--3 A -03/-02 1991 Mar
--4 - -04 1991 May 7
--3 A -03/-02 1999 O 3
--4 A -04/-03 2000 Mar 3
--3 - -03 2004 May 31
--4 - -04 2004 Jul 25
--3 A -03/-02 2008 O 18
--3 - -03
+-4 - %z 1930 D
+-4 A %z 1969 O 5
+-3 A %z 1991 Mar
+-4 - %z 1991 May 7
+-3 A %z 1999 O 3
+-4 A %z 2000 Mar 3
+-3 - %z 2004 May 31
+-4 - %z 2004 Jul 25
+-3 A %z 2008 O 18
+-3 - %z
 Z America/Argentina/San_Luis -4:25:24 - LMT 1894 O 31
 -4:16:48 - CMT 1920 May
--4 - -04 1930 D
--4 A -04/-03 1969 O 5
--3 A -03/-02 1990
--3 1 -02 1990 Mar 14
--4 - -04 1990 O 15
--4 1 -03 1991 Mar
--4 - -04 1991 Jun
--3 - -03 1999 O 3
--4 1 -03 2000 Mar 3
--3 - -03 2004 May 31
--4 - -04 2004 Jul 25
--3 A -03/-02 2008 Ja 21
--4 Sa -04/-03 2009 O 11
--3 - -03
+-4 - %z 1930 D
+-4 A %z 1969 O 5
+-3 A %z 1990
+-3 1 %z 1990 Mar 14
+-4 - %z 1990 O 15
+-4 1 %z 1991 Mar
+-4 - %z 1991 Jun
+-3 - %z 1999 O 3
+-4 1 %z 2000 Mar 3
+-3 - %z 2004 May 31
+-4 - %z 2004 Jul 25
+-3 A %z 2008 Ja 21
+-4 Sa %z 2009 O 11
+-3 - %z
 Z America/Argentina/Tucuman -4:20:52 - LMT 1894 O 31
 -4:16:48 - CMT 1920 May
--4 - -04 1930 D
--4 A -04/-03 1969 O 5
--3 A -03/-02 1991 Mar 3
--4 - -04 1991 O 20
--3 A -03/-02 1999 O 3
--4 A -04/-03 2000 Mar 3
--3 - -03 2004 Jun
--4 - -04 2004 Jun 13
--3 A -03/-02
+-4 - %z 1930 D
+-4 A %z 1969 O 5
+-3 A %z 1991 Mar 3
+-4 - %z 1991 O 20
+-3 A %z 1999 O 3
+-4 A %z 2000 Mar 3
+-3 - %z 2004 Jun
+-4 - %z 2004 Jun 13
+-3 A %z
 Z America/Argentina/Ushuaia -4:33:12 - LMT 1894 O 31
 -4:16:48 - CMT 1920 May
--4 - -04 1930 D
--4 A -04/-03 1969 O 5
--3 A -03/-02 1999 O 3
--4 A -04/-03 2000 Mar 3
--3 - -03 2004 May 30
--4 - -04 2004 Jun 20
--3 A -03/-02 2008 O 18
--3 - -03
+-4 - %z 1930 D
+-4 A %z 1969 O 5
+-3 A %z 1999 O 3
+-4 A %z 2000 Mar 3
+-3 - %z 2004 May 30
+-4 - %z 2004 Jun 20
+-3 A %z 2008 O 18
+-3 - %z
 Z America/Asuncion -3:50:40 - LMT 1890
 -3:50:40 - AMT 1931 O 10
--4 - -04 1972 O
--3 - -03 1974 Ap
--4 y -04/-03
+-4 - %z 1972 O
+-3 - %z 1974 Ap
+-4 y %z
 Z America/Bahia -2:34:4 - LMT 1914
--3 B -03/-02 2003 S 24
--3 - -03 2011 O 16
--3 B -03/-02 2012 O 21
--3 - -03
+-3 B %z 2003 S 24
+-3 - %z 2011 O 16
+-3 B %z 2012 O 21
+-3 - %z
 Z America/Bahia_Banderas -7:1 - LMT 1922 Ja 1 7u
--7 - MST 1927 Jun 10 23
+-7 - MST 1927 Jun 10
 -6 - CST 1930 N 15
 -7 m M%sT 1932 Ap
 -6 - CST 1942 Ap 24
--7 - MST 1949 Ja 14
--8 - PST 1970
+-7 - MST 1970
 -7 m M%sT 2010 Ap 4 2
 -6 m C%sT
 Z America/Barbados -3:58:29 - LMT 1911 Au 28
@@ -2359,18 +2355,18 @@ Z America/Barbados -3:58:29 - LMT 1911 Au 28
 -4 BB AST/-0330 1945
 -4 BB A%sT
 Z America/Belem -3:13:56 - LMT 1914
--3 B -03/-02 1988 S 12
--3 - -03
+-3 B %z 1988 S 12
+-3 - %z
 Z America/Belize -5:52:48 - LMT 1912 Ap
 -6 BZ %s
 Z America/Boa_Vista -4:2:40 - LMT 1914
--4 B -04/-03 1988 S 12
--4 - -04 1999 S 30
--4 B -04/-03 2000 O 15
--4 - -04
+-4 B %z 1988 S 12
+-4 - %z 1999 S 30
+-4 B %z 2000 O 15
+-4 - %z
 Z America/Bogota -4:56:16 - LMT 1884 Mar 13
 -4:56:16 - BMT 1914 N 23
--5 CO -05/-04
+-5 CO %z
 Z America/Boise -7:44:49 - LMT 1883 N 18 20u
 -8 u P%sT 1923 May 13 2
 -7 u M%sT 1974
@@ -2383,21 +2379,23 @@ Z America/Cambridge_Bay 0 - -00 1920
 -6 - CST 2001 Ap 1 3
 -7 C M%sT
 Z America/Campo_Grande -3:38:28 - LMT 1914
--4 B -04/-03
+-4 B %z
 Z America/Cancun -5:47:4 - LMT 1922 Ja 1 6u
--6 - CST 1981 D 23
+-6 - CST 1981 D 26 2
+-5 - EST 1983 Ja 4
+-6 m C%sT 1997 O 26 2
 -5 m E%sT 1998 Au 2 2
 -6 m C%sT 2015 F 1 2
 -5 - EST
 Z America/Caracas -4:27:44 - LMT 1890
 -4:27:40 - CMT 1912 F 12
--4:30 - -0430 1965
--4 - -04 2007 D 9 3
--4:30 - -0430 2016 May 1 2:30
--4 - -04
+-4:30 - %z 1965
+-4 - %z 2007 D 9 3
+-4:30 - %z 2016 May 1 2:30
+-4 - %z
 Z America/Cayenne -3:29:20 - LMT 1911 Jul
--4 - -04 1967 O
--3 - -03
+-4 - %z 1967 O
+-3 - %z
 Z America/Chicago -5:50:36 - LMT 1883 N 18 18u
 -6 u C%sT 1920
 -6 Ch C%sT 1936 Mar 1 2
@@ -2407,7 +2405,7 @@ Z America/Chicago -5:50:36 - LMT 1883 N 18 18u
 -6 Ch C%sT 1967
 -6 u C%sT
 Z America/Chihuahua -7:4:20 - LMT 1922 Ja 1 7u
--7 - MST 1927 Jun 10 23
+-7 - MST 1927 Jun 10
 -6 - CST 1930 N 15
 -7 m M%sT 1932 Ap
 -6 - CST 1996
@@ -2416,7 +2414,7 @@ Z America/Chihuahua -7:4:20 - LMT 1922 Ja 1 7u
 -7 m M%sT 2022 O 30 2
 -6 - CST
 Z America/Ciudad_Juarez -7:5:56 - LMT 1922 Ja 1 7u
--7 - MST 1927 Jun 10 23
+-7 - MST 1927 Jun 10
 -6 - CST 1930 N 15
 -7 m M%sT 1932 Ap
 -6 - CST 1996
@@ -2430,12 +2428,12 @@ Z America/Costa_Rica -5:36:13 - LMT 1890
 -5:36:13 - SJMT 1921 Ja 15
 -6 CR C%sT
 Z America/Cuiaba -3:44:20 - LMT 1914
--4 B -04/-03 2003 S 24
--4 - -04 2004 O
--4 B -04/-03
+-4 B %z 2003 S 24
+-4 - %z 2004 O
+-4 B %z
 Z America/Danmarkshavn -1:14:40 - LMT 1916 Jul 28
--3 - -03 1980 Ap 6 2
--3 E -03/-02 1996
+-3 - %z 1980 Ap 6 2
+-3 E %z 1996
 0 - GMT
 Z America/Dawson -9:17:40 - LMT 1900 Au 20
 -9 Y Y%sT 1965
@@ -2467,12 +2465,12 @@ Z America/Edmonton -7:33:52 - LMT 1906 S
 -7 Ed M%sT 1987
 -7 C M%sT
 Z America/Eirunepe -4:39:28 - LMT 1914
--5 B -05/-04 1988 S 12
--5 - -05 1993 S 28
--5 B -05/-04 1994 S 22
--5 - -05 2008 Jun 24
--4 - -04 2013 N 10
--5 - -05
+-5 B %z 1988 S 12
+-5 - %z 1993 S 28
+-5 B %z 1994 S 22
+-5 - %z 2008 Jun 24
+-4 - %z 2013 N 10
+-5 - %z
 Z America/El_Salvador -5:56:48 - LMT 1921
 -6 SV C%sT
 Z America/Fort_Nelson -8:10:47 - LMT 1884
@@ -2482,12 +2480,12 @@ Z America/Fort_Nelson -8:10:47 - LMT 1884
 -8 C P%sT 2015 Mar 8 2
 -7 - MST
 Z America/Fortaleza -2:34 - LMT 1914
--3 B -03/-02 1990 S 17
--3 - -03 1999 S 30
--3 B -03/-02 2000 O 22
--3 - -03 2001 S 13
--3 B -03/-02 2002 O
--3 - -03
+-3 B %z 1990 S 17
+-3 - %z 1999 S 30
+-3 B %z 2000 O 22
+-3 - %z 2001 S 13
+-3 B %z 2002 O
+-3 - %z
 Z America/Glace_Bay -3:59:48 - LMT 1902 Jun 15
 -4 C A%sT 1953
 -4 H A%sT 1954
@@ -2514,12 +2512,12 @@ Z America/Guatemala -6:2:4 - LMT 1918 O 5
 -6 GT C%sT
 Z America/Guayaquil -5:19:20 - LMT 1890
 -5:14 - QMT 1931
--5 EC -05/-04
+-5 EC %z
 Z America/Guyana -3:52:39 - LMT 1911 Au
--4 - -04 1915 Mar
--3:45 - -0345 1975 Au
--3 - -03 1992 Mar 29 1
--4 - -04
+-4 - %z 1915 Mar
+-3:45 - %z 1975 Au
+-3 - %z 1992 Mar 29 1
+-4 - %z
 Z America/Halifax -4:14:24 - LMT 1902 Jun 15
 -4 H A%sT 1918
 -4 C A%sT 1919
@@ -2531,12 +2529,11 @@ Z America/Havana -5:29:28 - LMT 1890
 -5:29:36 - HMT 1925 Jul 19 12
 -5 Q C%sT
 Z America/Hermosillo -7:23:52 - LMT 1922 Ja 1 7u
--7 - MST 1927 Jun 10 23
+-7 - MST 1927 Jun 10
 -6 - CST 1930 N 15
 -7 m M%sT 1932 Ap
 -6 - CST 1942 Ap 24
--7 - MST 1949 Ja 14
--8 - PST 1970
+-7 - MST 1996
 -7 m M%sT 1999
 -7 - MST
 Z America/Indiana/Indianapolis -5:44:38 - LMT 1883 N 18 18u
@@ -2644,23 +2641,23 @@ Z America/Kentucky/Monticello -5:39:24 - LMT 1883 N 18 18u
 Z America/La_Paz -4:32:36 - LMT 1890
 -4:32:36 - CMT 1931 O 15
 -4:32:36 1 BST 1932 Mar 21
--4 - -04
+-4 - %z
 Z America/Lima -5:8:12 - LMT 1890
 -5:8:36 - LMT 1908 Jul 28
--5 PE -05/-04
+-5 PE %z
 Z America/Los_Angeles -7:52:58 - LMT 1883 N 18 20u
 -8 u P%sT 1946
 -8 CA P%sT 1967
 -8 u P%sT
 Z America/Maceio -2:22:52 - LMT 1914
--3 B -03/-02 1990 S 17
--3 - -03 1995 O 13
--3 B -03/-02 1996 S 4
--3 - -03 1999 S 30
--3 B -03/-02 2000 O 22
--3 - -03 2001 S 13
--3 B -03/-02 2002 O
--3 - -03
+-3 B %z 1990 S 17
+-3 - %z 1995 O 13
+-3 B %z 1996 S 4
+-3 - %z 1999 S 30
+-3 B %z 2000 O 22
+-3 - %z 2001 S 13
+-3 B %z 2002 O
+-3 - %z
 Z America/Managua -5:45:8 - LMT 1890
 -5:45:12 - MMT 1934 Jun 23
 -6 - CST 1973 May
@@ -2671,10 +2668,10 @@ Z America/Managua -5:45:8 - LMT 1890
 -5 - EST 1997
 -6 NI C%sT
 Z America/Manaus -4:0:4 - LMT 1914
--4 B -04/-03 1988 S 12
--4 - -04 1993 S 28
--4 B -04/-03 1994 S 22
--4 - -04
+-4 B %z 1988 S 12
+-4 - %z 1993 S 28
+-4 B %z 1994 S 22
+-4 - %z
 Z America/Martinique -4:4:20 - LMT 1890
 -4:4:20 - FFMT 1911 May
 -4 - AST 1980 Ap 6
@@ -2686,12 +2683,11 @@ Z America/Matamoros -6:30 - LMT 1922 Ja 1 6u
 -6 m C%sT 2010
 -6 u C%sT
 Z America/Mazatlan -7:5:40 - LMT 1922 Ja 1 7u
--7 - MST 1927 Jun 10 23
+-7 - MST 1927 Jun 10
 -6 - CST 1930 N 15
 -7 m M%sT 1932 Ap
 -6 - CST 1942 Ap 24
--7 - MST 1949 Ja 14
--8 - PST 1970
+-7 - MST 1970
 -7 m M%sT
 Z America/Menominee -5:50:27 - LMT 1885 S 18 12
 -6 u C%sT 1946
@@ -2699,8 +2695,8 @@ Z America/Menominee -5:50:27 - LMT 1885 S 18 12
 -5 - EST 1973 Ap 29 2
 -6 u C%sT
 Z America/Merida -5:58:28 - LMT 1922 Ja 1 6u
--6 - CST 1981 D 23
--5 - EST 1982 D 2
+-6 - CST 1981 D 26 2
+-5 - EST 1982 N 2 2
 -6 m C%sT
 Z America/Metlakatla 15:13:42 - LMT 1867 O 19 15:44:55
 -8:46:18 - LMT 1900 Au 20 12
@@ -2713,7 +2709,7 @@ Z America/Metlakatla 15:13:42 - LMT 1867 O 19 15:44:55
 -8 - PST 2019 Ja 20 2
 -9 u AK%sT
 Z America/Mexico_City -6:36:36 - LMT 1922 Ja 1 7u
--7 - MST 1927 Jun 10 23
+-7 - MST 1927 Jun 10
 -6 - CST 1930 N 15
 -7 m M%sT 1932 Ap
 -6 m C%sT 2001 S 30 2
@@ -2721,8 +2717,8 @@ Z America/Mexico_City -6:36:36 - LMT 1922 Ja 1 7u
 -6 m C%sT
 Z America/Miquelon -3:44:40 - LMT 1911 Jun 15
 -4 - AST 1980 May
--3 - -03 1987
--3 C -03/-02
+-3 - %z 1987
+-3 C %z
 Z America/Moncton -4:19:8 - LMT 1883 D 9
 -5 - EST 1902 Jun 15
 -4 C A%sT 1933
@@ -2733,20 +2729,23 @@ Z America/Moncton -4:19:8 - LMT 1883 D 9
 -4 o A%sT 2007
 -4 C A%sT
 Z America/Monterrey -6:41:16 - LMT 1922 Ja 1 6u
+-7 - MST 1927 Jun 10
+-6 - CST 1930 N 15
+-7 m M%sT 1932 Ap
 -6 - CST 1988
 -6 u C%sT 1989
 -6 m C%sT
 Z America/Montevideo -3:44:51 - LMT 1908 Jun 10
 -3:44:51 - MMT 1920 May
--4 - -04 1923 O
--3:30 U -0330/-03 1942 D 14
--3 U -03/-0230 1960
--3 U -03/-02 1968
--3 U -03/-0230 1970
--3 U -03/-02 1974
--3 U -03/-0130 1974 Mar 10
--3 U -03/-0230 1974 D 22
--3 U -03/-02
+-4 - %z 1923 O
+-3:30 U %z 1942 D 14
+-3 U %z 1960
+-3 U %z 1968
+-3 U %z 1970
+-3 U %z 1974
+-3 U %z 1974 Mar 10
+-3 U %z 1974 D 22
+-3 U %z
 Z America/New_York -4:56:2 - LMT 1883 N 18 17u
 -5 u E%sT 1920
 -5 NY E%sT 1942
@@ -2763,12 +2762,12 @@ Z America/Nome 12:58:22 - LMT 1867 O 19 13:29:35
 -9 u Y%sT 1983 N 30
 -9 u AK%sT
 Z America/Noronha -2:9:40 - LMT 1914
--2 B -02/-01 1990 S 17
--2 - -02 1999 S 30
--2 B -02/-01 2000 O 15
--2 - -02 2001 S 13
--2 B -02/-01 2002 O
--2 - -02
+-2 B %z 1990 S 17
+-2 - %z 1999 S 30
+-2 B %z 2000 O 15
+-2 - %z 2001 S 13
+-2 B %z 2002 O
+-2 - %z
 Z America/North_Dakota/Beulah -6:47:7 - LMT 1883 N 18 19u
 -7 u M%sT 2010 N 7 2
 -6 u C%sT
@@ -2779,12 +2778,12 @@ Z America/North_Dakota/New_Salem -6:45:39 - LMT 1883 N 18 19u
 -7 u M%sT 2003 O 26 2
 -6 u C%sT
 Z America/Nuuk -3:26:56 - LMT 1916 Jul 28
--3 - -03 1980 Ap 6 2
--3 E -03/-02 2023 Mar 26 1u
--2 - -02 2023 O 29 1u
--2 E -02/-01
+-3 - %z 1980 Ap 6 2
+-3 E %z 2023 Mar 26 1u
+-2 - %z 2023 O 29 1u
+-2 E %z
 Z America/Ojinaga -6:57:40 - LMT 1922 Ja 1 7u
--7 - MST 1927 Jun 10 23
+-7 - MST 1927 Jun 10
 -6 - CST 1930 N 15
 -7 m M%sT 1932 Ap
 -6 - CST 1996
@@ -2800,8 +2799,8 @@ Z America/Panama -5:18:8 - LMT 1890
 Z America/Paramaribo -3:40:40 - LMT 1911
 -3:40:52 - PMT 1935
 -3:40:36 - PMT 1945 O
--3:30 - -0330 1984 O
--3 - -03
+-3:30 - %z 1984 O
+-3 - %z
 Z America/Phoenix -7:28:18 - LMT 1883 N 18 19u
 -7 u M%sT 1944 Ja 1 0:1
 -7 - MST 1944 Ap 1 0:1
@@ -2813,37 +2812,37 @@ Z America/Port-au-Prince -4:49:20 - LMT 1890
 -4:49 - PPMT 1917 Ja 24 12
 -5 HT E%sT
 Z America/Porto_Velho -4:15:36 - LMT 1914
--4 B -04/-03 1988 S 12
--4 - -04
+-4 B %z 1988 S 12
+-4 - %z
 Z America/Puerto_Rico -4:24:25 - LMT 1899 Mar 28 12
 -4 - AST 1942 May 3
 -4 u A%sT 1946
 -4 - AST
 Z America/Punta_Arenas -4:43:40 - LMT 1890
 -4:42:45 - SMT 1910 Ja 10
--5 - -05 1916 Jul
+-5 - %z 1916 Jul
 -4:42:45 - SMT 1918 S 10
--4 - -04 1919 Jul
+-4 - %z 1919 Jul
 -4:42:45 - SMT 1927 S
--5 x -05/-04 1932 S
--4 - -04 1942 Jun
--5 - -05 1942 Au
--4 - -04 1946 Au 28 24
--5 1 -04 1947 Mar 31 24
--5 - -05 1947 May 21 23
--4 x -04/-03 2016 D 4
--3 - -03
+-5 x %z 1932 S
+-4 - %z 1942 Jun
+-5 - %z 1942 Au
+-4 - %z 1946 Au 28 24
+-5 1 %z 1947 Mar 31 24
+-5 - %z 1947 May 21 23
+-4 x %z 2016 D 4
+-3 - %z
 Z America/Rankin_Inlet 0 - -00 1957
 -6 Y C%sT 2000 O 29 2
 -5 - EST 2001 Ap 1 3
 -6 C C%sT
 Z America/Recife -2:19:36 - LMT 1914
--3 B -03/-02 1990 S 17
--3 - -03 1999 S 30
--3 B -03/-02 2000 O 15
--3 - -03 2001 S 13
--3 B -03/-02 2002 O
--3 - -03
+-3 B %z 1990 S 17
+-3 - %z 1999 S 30
+-3 B %z 2000 O 15
+-3 - %z 2001 S 13
+-3 B %z 2002 O
+-3 - %z
 Z America/Regina -6:58:36 - LMT 1905 S
 -7 r M%sT 1960 Ap lastSu 2
 -6 - CST
@@ -2854,28 +2853,28 @@ Z America/Resolute 0 - -00 1947 Au 31
 -5 - EST 2007 Mar 11 3
 -6 C C%sT
 Z America/Rio_Branco -4:31:12 - LMT 1914
--5 B -05/-04 1988 S 12
--5 - -05 2008 Jun 24
--4 - -04 2013 N 10
--5 - -05
+-5 B %z 1988 S 12
+-5 - %z 2008 Jun 24
+-4 - %z 2013 N 10
+-5 - %z
 Z America/Santarem -3:38:48 - LMT 1914
--4 B -04/-03 1988 S 12
--4 - -04 2008 Jun 24
--3 - -03
+-4 B %z 1988 S 12
+-4 - %z 2008 Jun 24
+-3 - %z
 Z America/Santiago -4:42:45 - LMT 1890
 -4:42:45 - SMT 1910 Ja 10
--5 - -05 1916 Jul
+-5 - %z 1916 Jul
 -4:42:45 - SMT 1918 S 10
--4 - -04 1919 Jul
+-4 - %z 1919 Jul
 -4:42:45 - SMT 1927 S
--5 x -05/-04 1932 S
--4 - -04 1942 Jun
--5 - -05 1942 Au
--4 - -04 1946 Jul 14 24
--4 1 -03 1946 Au 28 24
--5 1 -04 1947 Mar 31 24
--5 - -05 1947 May 21 23
--4 x -04/-03
+-5 x %z 1932 S
+-4 - %z 1942 Jun
+-5 - %z 1942 Au
+-4 - %z 1946 Jul 14 24
+-4 1 %z 1946 Au 28 24
+-5 1 %z 1947 Mar 31 24
+-5 - %z 1947 May 21 23
+-4 x %z
 Z America/Santo_Domingo -4:39:36 - LMT 1890
 -4:40 - SDMT 1933 Ap 1 12
 -5 DO %s 1974 O 27
@@ -2883,14 +2882,14 @@ Z America/Santo_Domingo -4:39:36 - LMT 1890
 -5 u E%sT 2000 D 3 1
 -4 - AST
 Z America/Sao_Paulo -3:6:28 - LMT 1914
--3 B -03/-02 1963 O 23
--3 1 -02 1964
--3 B -03/-02
+-3 B %z 1963 O 23
+-3 1 %z 1964
+-3 B %z
 Z America/Scoresbysund -1:27:52 - LMT 1916 Jul 28
--2 - -02 1980 Ap 6 2
--2 c -02/-01 1981 Mar 29
--1 E -01/+00 2024 Mar 31
--2 E -02/-01
+-2 - %z 1980 Ap 6 2
+-2 c %z 1981 Mar 29
+-1 E %z 2024 Mar 31
+-2 E %z
 Z America/Sitka 14:58:47 - LMT 1867 O 19 15:30
 -9:1:13 - LMT 1900 Au 20 12
 -8 - PST 1942
@@ -2918,15 +2917,21 @@ Z America/Thule -4:35:8 - LMT 1916 Jul 28
 -4 Th A%sT
 Z America/Tijuana -7:48:4 - LMT 1922 Ja 1 7u
 -7 - MST 1924
--8 - PST 1927 Jun 10 23
+-8 - PST 1927 Jun 10
 -7 - MST 1930 N 15
 -8 - PST 1931 Ap
 -8 1 PDT 1931 S 30
 -8 - PST 1942 Ap 24
 -8 1 PWT 1945 Au 14 23u
--8 1 PPT 1945 N 12
+-8 1 PPT 1945 N 15
 -8 - PST 1948 Ap 5
 -8 1 PDT 1949 Ja 14
+-8 - PST 1950 May
+-8 1 PDT 1950 S 24
+-8 - PST 1951 Ap 29 2
+-8 1 PDT 1951 S 30 2
+-8 - PST 1952 Ap 27 2
+-8 1 PDT 1952 S 28 2
 -8 - PST 1954
 -8 CA P%sT 1961
 -8 - PST 1976
@@ -2961,31 +2966,31 @@ Z America/Yakutat 14:41:5 - LMT 1867 O 19 15:12:18
 -9 u Y%sT 1983 N 30
 -9 u AK%sT
 Z Antarctica/Casey 0 - -00 1969
-8 - +08 2009 O 18 2
-11 - +11 2010 Mar 5 2
-8 - +08 2011 O 28 2
-11 - +11 2012 F 21 17u
-8 - +08 2016 O 22
-11 - +11 2018 Mar 11 4
-8 - +08 2018 O 7 4
-11 - +11 2019 Mar 17 3
-8 - +08 2019 O 4 3
-11 - +11 2020 Mar 8 3
-8 - +08 2020 O 4 0:1
-11 - +11 2021 Mar 14
-8 - +08 2021 O 3 0:1
-11 - +11 2022 Mar 13
-8 - +08 2022 O 2 0:1
-11 - +11 2023 Mar 9 3
-8 - +08
+8 - %z 2009 O 18 2
+11 - %z 2010 Mar 5 2
+8 - %z 2011 O 28 2
+11 - %z 2012 F 21 17u
+8 - %z 2016 O 22
+11 - %z 2018 Mar 11 4
+8 - %z 2018 O 7 4
+11 - %z 2019 Mar 17 3
+8 - %z 2019 O 4 3
+11 - %z 2020 Mar 8 3
+8 - %z 2020 O 4 0:1
+11 - %z 2021 Mar 14
+8 - %z 2021 O 3 0:1
+11 - %z 2022 Mar 13
+8 - %z 2022 O 2 0:1
+11 - %z 2023 Mar 9 3
+8 - %z
 Z Antarctica/Davis 0 - -00 1957 Ja 13
-7 - +07 1964 N
+7 - %z 1964 N
 0 - -00 1969 F
-7 - +07 2009 O 18 2
-5 - +05 2010 Mar 10 20u
-7 - +07 2011 O 28 2
-5 - +05 2012 F 21 20u
-7 - +07
+7 - %z 2009 O 18 2
+5 - %z 2010 Mar 10 20u
+7 - %z 2011 O 28 2
+5 - %z 2012 F 21 20u
+7 - %z
 Z Antarctica/Macquarie 0 - -00 1899 N
 10 - AEST 1916 O 1 2
 10 1 AEDT 1917 F
@@ -2996,151 +3001,146 @@ Z Antarctica/Macquarie 0 - -00 1899 N
 10 1 AEDT 2011
 10 AT AE%sT
 Z Antarctica/Mawson 0 - -00 1954 F 13
-6 - +06 2009 O 18 2
-5 - +05
+6 - %z 2009 O 18 2
+5 - %z
 Z Antarctica/Palmer 0 - -00 1965
--4 A -04/-03 1969 O 5
--3 A -03/-02 1982 May
--4 x -04/-03 2016 D 4
--3 - -03
+-4 A %z 1969 O 5
+-3 A %z 1982 May
+-4 x %z 2016 D 4
+-3 - %z
 Z Antarctica/Rothera 0 - -00 1976 D
--3 - -03
+-3 - %z
 Z Antarctica/Troll 0 - -00 2005 F 12
 0 Tr %s
 Z Antarctica/Vostok 0 - -00 1957 D 16
-7 - +07 1994 F
+7 - %z 1994 F
 0 - -00 1994 N
-7 - +07 2023 D 18 2
-5 - +05
+7 - %z 2023 D 18 2
+5 - %z
 Z Asia/Almaty 5:7:48 - LMT 1924 May 2
-5 - +05 1930 Jun 21
-6 R +06/+07 1991 Mar 31 2s
-5 R +05/+06 1992 Ja 19 2s
-6 R +06/+07 2004 O 31 2s
-6 - +06 2024 Mar
-5 - +05
+5 - %z 1930 Jun 21
+6 R %z 1991 Mar 31 2s
+5 R %z 1992 Ja 19 2s
+6 R %z 2004 O 31 2s
+6 - %z 2024 Mar
+5 - %z
 Z Asia/Amman 2:23:44 - LMT 1931
 2 J EE%sT 2022 O 28 0s
-3 - +03
+3 - %z
 Z Asia/Anadyr 11:49:56 - LMT 1924 May 2
-12 - +12 1930 Jun 21
-13 R +13/+14 1982 Ap 1 0s
-12 R +12/+13 1991 Mar 31 2s
-11 R +11/+12 1992 Ja 19 2s
-12 R +12/+13 2010 Mar 28 2s
-11 R +11/+12 2011 Mar 27 2s
-12 - +12
+12 - %z 1930 Jun 21
+13 R %z 1982 Ap 1 0s
+12 R %z 1991 Mar 31 2s
+11 R %z 1992 Ja 19 2s
+12 R %z 2010 Mar 28 2s
+11 R %z 2011 Mar 27 2s
+12 - %z
 Z Asia/Aqtau 3:21:4 - LMT 1924 May 2
-4 - +04 1930 Jun 21
-5 - +05 1981 O
-6 - +06 1982 Ap
-5 R +05/+06 1991 Mar 31 2s
-4 R +04/+05 1992 Ja 19 2s
-5 R +05/+06 1994 S 25 2s
-4 R +04/+05 2004 O 31 2s
-5 - +05
+4 - %z 1930 Jun 21
+5 - %z 1981 O
+6 - %z 1982 Ap
+5 R %z 1991 Mar 31 2s
+4 R %z 1992 Ja 19 2s
+5 R %z 1994 S 25 2s
+4 R %z 2004 O 31 2s
+5 - %z
 Z Asia/Aqtobe 3:48:40 - LMT 1924 May 2
-4 - +04 1930 Jun 21
-5 - +05 1981 Ap
-5 1 +06 1981 O
-6 - +06 1982 Ap
-5 R +05/+06 1991 Mar 31 2s
-4 R +04/+05 1992 Ja 19 2s
-5 R +05/+06 2004 O 31 2s
-5 - +05
+4 - %z 1930 Jun 21
+5 - %z 1981 Ap
+5 1 %z 1981 O
+6 - %z 1982 Ap
+5 R %z 1991 Mar 31 2s
+4 R %z 1992 Ja 19 2s
+5 R %z 2004 O 31 2s
+5 - %z
 Z Asia/Ashgabat 3:53:32 - LMT 1924 May 2
-4 - +04 1930 Jun 21
-5 R +05/+06 1991 Mar 31 2
-4 R +04/+05 1992 Ja 19 2
-5 - +05
+4 - %z 1930 Jun 21
+5 R %z 1991 Mar 31 2
+4 R %z 1992 Ja 19 2
+5 - %z
 Z Asia/Atyrau 3:27:44 - LMT 1924 May 2
-3 - +03 1930 Jun 21
-5 - +05 1981 O
-6 - +06 1982 Ap
-5 R +05/+06 1991 Mar 31 2s
-4 R +04/+05 1992 Ja 19 2s
-5 R +05/+06 1999 Mar 28 2s
-4 R +04/+05 2004 O 31 2s
-5 - +05
+3 - %z 1930 Jun 21
+5 - %z 1981 O
+6 - %z 1982 Ap
+5 R %z 1991 Mar 31 2s
+4 R %z 1992 Ja 19 2s
+5 R %z 1999 Mar 28 2s
+4 R %z 2004 O 31 2s
+5 - %z
 Z Asia/Baghdad 2:57:40 - LMT 1890
 2:57:36 - BMT 1918
-3 - +03 1982 May
-3 IQ +03/+04
+3 - %z 1982 May
+3 IQ %z
 Z Asia/Baku 3:19:24 - LMT 1924 May 2
-3 - +03 1957 Mar
-4 R +04/+05 1991 Mar 31 2s
-3 R +03/+04 1992 S lastSu 2s
-4 - +04 1996
-4 E +04/+05 1997
-4 AZ +04/+05
+3 - %z 1957 Mar
+4 R %z 1991 Mar 31 2s
+3 R %z 1992 S lastSu 2s
+4 - %z 1996
+4 E %z 1997
+4 AZ %z
 Z Asia/Bangkok 6:42:4 - LMT 1880
 6:42:4 - BMT 1920 Ap
-7 - +07
+7 - %z
 Z Asia/Barnaul 5:35 - LMT 1919 D 10
-6 - +06 1930 Jun 21
-7 R +07/+08 1991 Mar 31 2s
-6 R +06/+07 1992 Ja 19 2s
-7 R +07/+08 1995 May 28
-6 R +06/+07 2011 Mar 27 2s
-7 - +07 2014 O 26 2s
-6 - +06 2016 Mar 27 2s
-7 - +07
+6 - %z 1930 Jun 21
+7 R %z 1991 Mar 31 2s
+6 R %z 1992 Ja 19 2s
+7 R %z 1995 May 28
+6 R %z 2011 Mar 27 2s
+7 - %z 2014 O 26 2s
+6 - %z 2016 Mar 27 2s
+7 - %z
 Z Asia/Beirut 2:22 - LMT 1880
 2 l EE%sT
 Z Asia/Bishkek 4:58:24 - LMT 1924 May 2
-5 - +05 1930 Jun 21
-6 R +06/+07 1991 Mar 31 2s
-5 R +05/+06 1991 Au 31 2
-5 KG +05/+06 2005 Au 12
-6 - +06
+5 - %z 1930 Jun 21
+6 R %z 1991 Mar 31 2s
+5 R %z 1991 Au 31 2
+5 KG %z 2005 Au 12
+6 - %z
 Z Asia/Chita 7:33:52 - LMT 1919 D 15
-8 - +08 1930 Jun 21
-9 R +09/+10 1991 Mar 31 2s
-8 R +08/+09 1992 Ja 19 2s
-9 R +09/+10 2011 Mar 27 2s
-10 - +10 2014 O 26 2s
-8 - +08 2016 Mar 27 2
-9 - +09
-Z Asia/Choibalsan 7:38 - LMT 1905 Au
-7 - +07 1978
-8 - +08 1983 Ap
-9 X +09/+10 2008 Mar 31
-8 X +08/+09
+8 - %z 1930 Jun 21
+9 R %z 1991 Mar 31 2s
+8 R %z 1992 Ja 19 2s
+9 R %z 2011 Mar 27 2s
+10 - %z 2014 O 26 2s
+8 - %z 2016 Mar 27 2
+9 - %z
 Z Asia/Colombo 5:19:24 - LMT 1880
 5:19:32 - MMT 1906
-5:30 - +0530 1942 Ja 5
-5:30 0:30 +06 1942 S
-5:30 1 +0630 1945 O 16 2
-5:30 - +0530 1996 May 25
-6:30 - +0630 1996 O 26 0:30
-6 - +06 2006 Ap 15 0:30
-5:30 - +0530
+5:30 - %z 1942 Ja 5
+5:30 0:30 %z 1942 S
+5:30 1 %z 1945 O 16 2
+5:30 - %z 1996 May 25
+6:30 - %z 1996 O 26 0:30
+6 - %z 2006 Ap 15 0:30
+5:30 - %z
 Z Asia/Damascus 2:25:12 - LMT 1920
 2 S EE%sT 2022 O 28
-3 - +03
+3 - %z
 Z Asia/Dhaka 6:1:40 - LMT 1890
 5:53:20 - HMT 1941 O
-6:30 - +0630 1942 May 15
-5:30 - +0530 1942 S
-6:30 - +0630 1951 S 30
-6 - +06 2009
-6 BD +06/+07
-Z Asia/Dili 8:22:20 - LMT 1912
-8 - +08 1942 F 21 23
-9 - +09 1976 May 3
-8 - +08 2000 S 17
-9 - +09
+6:30 - %z 1942 May 15
+5:30 - %z 1942 S
+6:30 - %z 1951 S 30
+6 - %z 2009
+6 BD %z
+Z Asia/Dili 8:22:20 - LMT 1911 D 31 16u
+8 - %z 1942 F 21 23
+9 - %z 1976 May 3
+8 - %z 2000 S 17
+9 - %z
 Z Asia/Dubai 3:41:12 - LMT 1920
-4 - +04
+4 - %z
 Z Asia/Dushanbe 4:35:12 - LMT 1924 May 2
-5 - +05 1930 Jun 21
-6 R +06/+07 1991 Mar 31 2s
-5 1 +06 1991 S 9 2s
-5 - +05
+5 - %z 1930 Jun 21
+6 R %z 1991 Mar 31 2s
+5 1 %z 1991 S 9 2s
+5 - %z
 Z Asia/Famagusta 2:15:48 - LMT 1921 N 14
 2 CY EE%sT 1998 S
 2 E EE%sT 2016 S 8
-3 - +03 2017 O 29 1u
+3 - %z 2017 O 29 1u
 2 E EE%sT
 Z Asia/Gaza 2:17:52 - LMT 1900 O
 2 Z EET/EEST 1948 May 15
@@ -3162,14 +3162,14 @@ Z Asia/Hebron 2:20:23 - LMT 1900 O
 2 P EE%sT
 Z Asia/Ho_Chi_Minh 7:6:30 - LMT 1906 Jul
 7:6:30 - PLMT 1911 May
-7 - +07 1942 D 31 23
-8 - +08 1945 Mar 14 23
-9 - +09 1945 S 1 24
-7 - +07 1947 Ap
-8 - +08 1955 Jul 1 1
-7 - +07 1959 D 31 23
-8 - +08 1975 Jun 13
-7 - +07
+7 - %z 1942 D 31 23
+8 - %z 1945 Mar 14 23
+9 - %z 1945 S 1 24
+7 - %z 1947 Ap
+8 - %z 1955 Jul 1 1
+7 - %z 1959 D 31 23
+8 - %z 1975 Jun 13
+7 - %z
 Z Asia/Hong_Kong 7:36:42 - LMT 1904 O 29 17u
 8 - HKT 1941 Jun 15 3
 8 1 HKST 1941 O 1 4
@@ -3177,96 +3177,96 @@ Z Asia/Hong_Kong 7:36:42 - LMT 1904 O 29 17u
 9 - JST 1945 N 18 2
 8 HK HK%sT
 Z Asia/Hovd 6:6:36 - LMT 1905 Au
-6 - +06 1978
-7 X +07/+08
+6 - %z 1978
+7 X %z
 Z Asia/Irkutsk 6:57:5 - LMT 1880
 6:57:5 - IMT 1920 Ja 25
-7 - +07 1930 Jun 21
-8 R +08/+09 1991 Mar 31 2s
-7 R +07/+08 1992 Ja 19 2s
-8 R +08/+09 2011 Mar 27 2s
-9 - +09 2014 O 26 2s
-8 - +08
+7 - %z 1930 Jun 21
+8 R %z 1991 Mar 31 2s
+7 R %z 1992 Ja 19 2s
+8 R %z 2011 Mar 27 2s
+9 - %z 2014 O 26 2s
+8 - %z
 Z Asia/Jakarta 7:7:12 - LMT 1867 Au 10
 7:7:12 - BMT 1923 D 31 16:40u
-7:20 - +0720 1932 N
-7:30 - +0730 1942 Mar 23
-9 - +09 1945 S 23
-7:30 - +0730 1948 May
-8 - +08 1950 May
-7:30 - +0730 1964
+7:20 - %z 1932 N
+7:30 - %z 1942 Mar 23
+9 - %z 1945 S 23
+7:30 - %z 1948 May
+8 - %z 1950 May
+7:30 - %z 1964
 7 - WIB
 Z Asia/Jayapura 9:22:48 - LMT 1932 N
-9 - +09 1944 S
-9:30 - +0930 1964
+9 - %z 1944 S
+9:30 - %z 1964
 9 - WIT
 Z Asia/Jerusalem 2:20:54 - LMT 1880
 2:20:40 - JMT 1918
 2 Z I%sT
 Z Asia/Kabul 4:36:48 - LMT 1890
-4 - +04 1945
-4:30 - +0430
+4 - %z 1945
+4:30 - %z
 Z Asia/Kamchatka 10:34:36 - LMT 1922 N 10
-11 - +11 1930 Jun 21
-12 R +12/+13 1991 Mar 31 2s
-11 R +11/+12 1992 Ja 19 2s
-12 R +12/+13 2010 Mar 28 2s
-11 R +11/+12 2011 Mar 27 2s
-12 - +12
+11 - %z 1930 Jun 21
+12 R %z 1991 Mar 31 2s
+11 R %z 1992 Ja 19 2s
+12 R %z 2010 Mar 28 2s
+11 R %z 2011 Mar 27 2s
+12 - %z
 Z Asia/Karachi 4:28:12 - LMT 1907
-5:30 - +0530 1942 S
-5:30 1 +0630 1945 O 15
-5:30 - +0530 1951 S 30
-5 - +05 1971 Mar 26
+5:30 - %z 1942 S
+5:30 1 %z 1945 O 15
+5:30 - %z 1951 S 30
+5 - %z 1971 Mar 26
 5 PK PK%sT
 Z Asia/Kathmandu 5:41:16 - LMT 1920
-5:30 - +0530 1986
-5:45 - +0545
+5:30 - %z 1986
+5:45 - %z
 Z Asia/Khandyga 9:2:13 - LMT 1919 D 15
-8 - +08 1930 Jun 21
-9 R +09/+10 1991 Mar 31 2s
-8 R +08/+09 1992 Ja 19 2s
-9 R +09/+10 2004
-10 R +10/+11 2011 Mar 27 2s
-11 - +11 2011 S 13 0s
-10 - +10 2014 O 26 2s
-9 - +09
+8 - %z 1930 Jun 21
+9 R %z 1991 Mar 31 2s
+8 R %z 1992 Ja 19 2s
+9 R %z 2004
+10 R %z 2011 Mar 27 2s
+11 - %z 2011 S 13 0s
+10 - %z 2014 O 26 2s
+9 - %z
 Z Asia/Kolkata 5:53:28 - LMT 1854 Jun 28
 5:53:20 - HMT 1870
 5:21:10 - MMT 1906
 5:30 - IST 1941 O
-5:30 1 +0630 1942 May 15
+5:30 1 %z 1942 May 15
 5:30 - IST 1942 S
-5:30 1 +0630 1945 O 15
+5:30 1 %z 1945 O 15
 5:30 - IST
 Z Asia/Krasnoyarsk 6:11:26 - LMT 1920 Ja 6
-6 - +06 1930 Jun 21
-7 R +07/+08 1991 Mar 31 2s
-6 R +06/+07 1992 Ja 19 2s
-7 R +07/+08 2011 Mar 27 2s
-8 - +08 2014 O 26 2s
-7 - +07
+6 - %z 1930 Jun 21
+7 R %z 1991 Mar 31 2s
+6 R %z 1992 Ja 19 2s
+7 R %z 2011 Mar 27 2s
+8 - %z 2014 O 26 2s
+7 - %z
 Z Asia/Kuching 7:21:20 - LMT 1926 Mar
-7:30 - +0730 1933
-8 NB +08/+0820 1942 F 16
-9 - +09 1945 S 12
-8 - +08
+7:30 - %z 1933
+8 NB %z 1942 F 16
+9 - %z 1945 S 12
+8 - %z
 Z Asia/Macau 7:34:10 - LMT 1904 O 30
 8 - CST 1941 D 21 23
-9 _ +09/+10 1945 S 30 24
+9 _ %z 1945 S 30 24
 8 _ C%sT
 Z Asia/Magadan 10:3:12 - LMT 1924 May 2
-10 - +10 1930 Jun 21
-11 R +11/+12 1991 Mar 31 2s
-10 R +10/+11 1992 Ja 19 2s
-11 R +11/+12 2011 Mar 27 2s
-12 - +12 2014 O 26 2s
-10 - +10 2016 Ap 24 2s
-11 - +11
+10 - %z 1930 Jun 21
+11 R %z 1991 Mar 31 2s
+10 R %z 1992 Ja 19 2s
+11 R %z 2011 Mar 27 2s
+12 - %z 2014 O 26 2s
+10 - %z 2016 Ap 24 2s
+11 - %z
 Z Asia/Makassar 7:57:36 - LMT 1920
 7:57:36 - MMT 1932 N
-8 - +08 1942 F 9
-9 - +09 1945 S 23
+8 - %z 1942 F 9
+9 - %z 1945 S 23
 8 - WITA
 Z Asia/Manila -15:56 - LMT 1844 D 31
 8:4 - LMT 1899 May 11
@@ -3277,45 +3277,45 @@ Z Asia/Nicosia 2:13:28 - LMT 1921 N 14
 2 CY EE%sT 1998 S
 2 E EE%sT
 Z Asia/Novokuznetsk 5:48:48 - LMT 1924 May
-6 - +06 1930 Jun 21
-7 R +07/+08 1991 Mar 31 2s
-6 R +06/+07 1992 Ja 19 2s
-7 R +07/+08 2010 Mar 28 2s
-6 R +06/+07 2011 Mar 27 2s
-7 - +07
+6 - %z 1930 Jun 21
+7 R %z 1991 Mar 31 2s
+6 R %z 1992 Ja 19 2s
+7 R %z 2010 Mar 28 2s
+6 R %z 2011 Mar 27 2s
+7 - %z
 Z Asia/Novosibirsk 5:31:40 - LMT 1919 D 14 6
-6 - +06 1930 Jun 21
-7 R +07/+08 1991 Mar 31 2s
-6 R +06/+07 1992 Ja 19 2s
-7 R +07/+08 1993 May 23
-6 R +06/+07 2011 Mar 27 2s
-7 - +07 2014 O 26 2s
-6 - +06 2016 Jul 24 2s
-7 - +07
+6 - %z 1930 Jun 21
+7 R %z 1991 Mar 31 2s
+6 R %z 1992 Ja 19 2s
+7 R %z 1993 May 23
+6 R %z 2011 Mar 27 2s
+7 - %z 2014 O 26 2s
+6 - %z 2016 Jul 24 2s
+7 - %z
 Z Asia/Omsk 4:53:30 - LMT 1919 N 14
-5 - +05 1930 Jun 21
-6 R +06/+07 1991 Mar 31 2s
-5 R +05/+06 1992 Ja 19 2s
-6 R +06/+07 2011 Mar 27 2s
-7 - +07 2014 O 26 2s
-6 - +06
+5 - %z 1930 Jun 21
+6 R %z 1991 Mar 31 2s
+5 R %z 1992 Ja 19 2s
+6 R %z 2011 Mar 27 2s
+7 - %z 2014 O 26 2s
+6 - %z
 Z Asia/Oral 3:25:24 - LMT 1924 May 2
-3 - +03 1930 Jun 21
-5 - +05 1981 Ap
-5 1 +06 1981 O
-6 - +06 1982 Ap
-5 R +05/+06 1989 Mar 26 2s
-4 R +04/+05 1992 Ja 19 2s
-5 R +05/+06 1992 Mar 29 2s
-4 R +04/+05 2004 O 31 2s
-5 - +05
+3 - %z 1930 Jun 21
+5 - %z 1981 Ap
+5 1 %z 1981 O
+6 - %z 1982 Ap
+5 R %z 1989 Mar 26 2s
+4 R %z 1992 Ja 19 2s
+5 R %z 1992 Mar 29 2s
+4 R %z 2004 O 31 2s
+5 - %z
 Z Asia/Pontianak 7:17:20 - LMT 1908 May
 7:17:20 - PMT 1932 N
-7:30 - +0730 1942 Ja 29
-9 - +09 1945 S 23
-7:30 - +0730 1948 May
-8 - +08 1950 May
-7:30 - +0730 1964
+7:30 - %z 1942 Ja 29
+9 - %z 1945 S 23
+7:30 - %z 1948 May
+8 - %z 1950 May
+7:30 - %z 1964
 8 - WITA 1988
 7 - WIB
 Z Asia/Pyongyang 8:23 - LMT 1908 Ap
@@ -3325,48 +3325,48 @@ Z Asia/Pyongyang 8:23 - LMT 1908 Ap
 8:30 - KST 2018 May 4 23:30
 9 - KST
 Z Asia/Qatar 3:26:8 - LMT 1920
-4 - +04 1972 Jun
-3 - +03
+4 - %z 1972 Jun
+3 - %z
 Z Asia/Qostanay 4:14:28 - LMT 1924 May 2
-4 - +04 1930 Jun 21
-5 - +05 1981 Ap
-5 1 +06 1981 O
-6 - +06 1982 Ap
-5 R +05/+06 1991 Mar 31 2s
-4 R +04/+05 1992 Ja 19 2s
-5 R +05/+06 2004 O 31 2s
-6 - +06 2024 Mar
-5 - +05
+4 - %z 1930 Jun 21
+5 - %z 1981 Ap
+5 1 %z 1981 O
+6 - %z 1982 Ap
+5 R %z 1991 Mar 31 2s
+4 R %z 1992 Ja 19 2s
+5 R %z 2004 O 31 2s
+6 - %z 2024 Mar
+5 - %z
 Z Asia/Qyzylorda 4:21:52 - LMT 1924 May 2
-4 - +04 1930 Jun 21
-5 - +05 1981 Ap
-5 1 +06 1981 O
-6 - +06 1982 Ap
-5 R +05/+06 1991 Mar 31 2s
-4 R +04/+05 1991 S 29 2s
-5 R +05/+06 1992 Ja 19 2s
-6 R +06/+07 1992 Mar 29 2s
-5 R +05/+06 2004 O 31 2s
-6 - +06 2018 D 21
-5 - +05
+4 - %z 1930 Jun 21
+5 - %z 1981 Ap
+5 1 %z 1981 O
+6 - %z 1982 Ap
+5 R %z 1991 Mar 31 2s
+4 R %z 1991 S 29 2s
+5 R %z 1992 Ja 19 2s
+6 R %z 1992 Mar 29 2s
+5 R %z 2004 O 31 2s
+6 - %z 2018 D 21
+5 - %z
 Z Asia/Riyadh 3:6:52 - LMT 1947 Mar 14
-3 - +03
+3 - %z
 Z Asia/Sakhalin 9:30:48 - LMT 1905 Au 23
-9 - +09 1945 Au 25
-11 R +11/+12 1991 Mar 31 2s
-10 R +10/+11 1992 Ja 19 2s
-11 R +11/+12 1997 Mar lastSu 2s
-10 R +10/+11 2011 Mar 27 2s
-11 - +11 2014 O 26 2s
-10 - +10 2016 Mar 27 2s
-11 - +11
+9 - %z 1945 Au 25
+11 R %z 1991 Mar 31 2s
+10 R %z 1992 Ja 19 2s
+11 R %z 1997 Mar lastSu 2s
+10 R %z 2011 Mar 27 2s
+11 - %z 2014 O 26 2s
+10 - %z 2016 Mar 27 2s
+11 - %z
 Z Asia/Samarkand 4:27:53 - LMT 1924 May 2
-4 - +04 1930 Jun 21
-5 - +05 1981 Ap
-5 1 +06 1981 O
-6 - +06 1982 Ap
-5 R +05/+06 1992
-5 - +05
+4 - %z 1930 Jun 21
+5 - %z 1981 Ap
+5 1 %z 1981 O
+6 - %z 1982 Ap
+5 R %z 1992
+5 - %z
 Z Asia/Seoul 8:27:52 - LMT 1908 Ap
 8:30 - KST 1912
 9 - JST 1945 S 8
@@ -3378,161 +3378,147 @@ Z Asia/Shanghai 8:5:43 - LMT 1901
 8 CN C%sT
 Z Asia/Singapore 6:55:25 - LMT 1901
 6:55:25 - SMT 1905 Jun
-7 - +07 1933
-7 0:20 +0720 1936
-7:20 - +0720 1941 S
-7:30 - +0730 1942 F 16
-9 - +09 1945 S 12
-7:30 - +0730 1981 D 31 16u
-8 - +08
+7 - %z 1933
+7 0:20 %z 1936
+7:20 - %z 1941 S
+7:30 - %z 1942 F 16
+9 - %z 1945 S 12
+7:30 - %z 1981 D 31 16u
+8 - %z
 Z Asia/Srednekolymsk 10:14:52 - LMT 1924 May 2
-10 - +10 1930 Jun 21
-11 R +11/+12 1991 Mar 31 2s
-10 R +10/+11 1992 Ja 19 2s
-11 R +11/+12 2011 Mar 27 2s
-12 - +12 2014 O 26 2s
-11 - +11
+10 - %z 1930 Jun 21
+11 R %z 1991 Mar 31 2s
+10 R %z 1992 Ja 19 2s
+11 R %z 2011 Mar 27 2s
+12 - %z 2014 O 26 2s
+11 - %z
 Z Asia/Taipei 8:6 - LMT 1896
 8 - CST 1937 O
 9 - JST 1945 S 21 1
 8 f C%sT
 Z Asia/Tashkent 4:37:11 - LMT 1924 May 2
-5 - +05 1930 Jun 21
-6 R +06/+07 1991 Mar 31 2
-5 R +05/+06 1992
-5 - +05
+5 - %z 1930 Jun 21
+6 R %z 1991 Mar 31 2
+5 R %z 1992
+5 - %z
 Z Asia/Tbilisi 2:59:11 - LMT 1880
 2:59:11 - TBMT 1924 May 2
-3 - +03 1957 Mar
-4 R +04/+05 1991 Mar 31 2s
-3 R +03/+04 1992
-3 e +03/+04 1994 S lastSu
-4 e +04/+05 1996 O lastSu
-4 1 +05 1997 Mar lastSu
-4 e +04/+05 2004 Jun 27
-3 R +03/+04 2005 Mar lastSu 2
-4 - +04
+3 - %z 1957 Mar
+4 R %z 1991 Mar 31 2s
+3 R %z 1992
+3 e %z 1994 S lastSu
+4 e %z 1996 O lastSu
+4 1 %z 1997 Mar lastSu
+4 e %z 2004 Jun 27
+3 R %z 2005 Mar lastSu 2
+4 - %z
 Z Asia/Tehran 3:25:44 - LMT 1916
 3:25:44 - TMT 1935 Jun 13
-3:30 i +0330/+0430 1977 O 20 24
-4 i +04/+05 1979
-3:30 i +0330/+0430
+3:30 i %z 1977 O 20 24
+4 i %z 1979
+3:30 i %z
 Z Asia/Thimphu 5:58:36 - LMT 1947 Au 15
-5:30 - +0530 1987 O
-6 - +06
+5:30 - %z 1987 O
+6 - %z
 Z Asia/Tokyo 9:18:59 - LMT 1887 D 31 15u
 9 JP J%sT
 Z Asia/Tomsk 5:39:51 - LMT 1919 D 22
-6 - +06 1930 Jun 21
-7 R +07/+08 1991 Mar 31 2s
-6 R +06/+07 1992 Ja 19 2s
-7 R +07/+08 2002 May 1 3
-6 R +06/+07 2011 Mar 27 2s
-7 - +07 2014 O 26 2s
-6 - +06 2016 May 29 2s
-7 - +07
+6 - %z 1930 Jun 21
+7 R %z 1991 Mar 31 2s
+6 R %z 1992 Ja 19 2s
+7 R %z 2002 May 1 3
+6 R %z 2011 Mar 27 2s
+7 - %z 2014 O 26 2s
+6 - %z 2016 May 29 2s
+7 - %z
 Z Asia/Ulaanbaatar 7:7:32 - LMT 1905 Au
-7 - +07 1978
-8 X +08/+09
+7 - %z 1978
+8 X %z
 Z Asia/Urumqi 5:50:20 - LMT 1928
-6 - +06
+6 - %z
 Z Asia/Ust-Nera 9:32:54 - LMT 1919 D 15
-8 - +08 1930 Jun 21
-9 R +09/+10 1981 Ap
-11 R +11/+12 1991 Mar 31 2s
-10 R +10/+11 1992 Ja 19 2s
-11 R +11/+12 2011 Mar 27 2s
-12 - +12 2011 S 13 0s
-11 - +11 2014 O 26 2s
-10 - +10
+8 - %z 1930 Jun 21
+9 R %z 1981 Ap
+11 R %z 1991 Mar 31 2s
+10 R %z 1992 Ja 19 2s
+11 R %z 2011 Mar 27 2s
+12 - %z 2011 S 13 0s
+11 - %z 2014 O 26 2s
+10 - %z
 Z Asia/Vladivostok 8:47:31 - LMT 1922 N 15
-9 - +09 1930 Jun 21
-10 R +10/+11 1991 Mar 31 2s
-9 R +09/+10 1992 Ja 19 2s
-10 R +10/+11 2011 Mar 27 2s
-11 - +11 2014 O 26 2s
-10 - +10
+9 - %z 1930 Jun 21
+10 R %z 1991 Mar 31 2s
+9 R %z 1992 Ja 19 2s
+10 R %z 2011 Mar 27 2s
+11 - %z 2014 O 26 2s
+10 - %z
 Z Asia/Yakutsk 8:38:58 - LMT 1919 D 15
-8 - +08 1930 Jun 21
-9 R +09/+10 1991 Mar 31 2s
-8 R +08/+09 1992 Ja 19 2s
-9 R +09/+10 2011 Mar 27 2s
-10 - +10 2014 O 26 2s
-9 - +09
+8 - %z 1930 Jun 21
+9 R %z 1991 Mar 31 2s
+8 R %z 1992 Ja 19 2s
+9 R %z 2011 Mar 27 2s
+10 - %z 2014 O 26 2s
+9 - %z
 Z Asia/Yangon 6:24:47 - LMT 1880
 6:24:47 - RMT 1920
-6:30 - +0630 1942 May
-9 - +09 1945 May 3
-6:30 - +0630
+6:30 - %z 1942 May
+9 - %z 1945 May 3
+6:30 - %z
 Z Asia/Yekaterinburg 4:2:33 - LMT 1916 Jul 3
 3:45:5 - PMT 1919 Jul 15 4
-4 - +04 1930 Jun 21
-5 R +05/+06 1991 Mar 31 2s
-4 R +04/+05 1992 Ja 19 2s
-5 R +05/+06 2011 Mar 27 2s
-6 - +06 2014 O 26 2s
-5 - +05
+4 - %z 1930 Jun 21
+5 R %z 1991 Mar 31 2s
+4 R %z 1992 Ja 19 2s
+5 R %z 2011 Mar 27 2s
+6 - %z 2014 O 26 2s
+5 - %z
 Z Asia/Yerevan 2:58 - LMT 1924 May 2
-3 - +03 1957 Mar
-4 R +04/+05 1991 Mar 31 2s
-3 R +03/+04 1995 S 24 2s
-4 - +04 1997
-4 R +04/+05 2011
-4 AM +04/+05
+3 - %z 1957 Mar
+4 R %z 1991 Mar 31 2s
+3 R %z 1995 S 24 2s
+4 - %z 1997
+4 R %z 2011
+4 AM %z
 Z Atlantic/Azores -1:42:40 - LMT 1884
 -1:54:32 - HMT 1912 Ja 1 2u
--2 p -02/-01 1942 Ap 25 22s
--2 p +00 1942 Au 15 22s
--2 p -02/-01 1943 Ap 17 22s
--2 p +00 1943 Au 28 22s
--2 p -02/-01 1944 Ap 22 22s
--2 p +00 1944 Au 26 22s
--2 p -02/-01 1945 Ap 21 22s
--2 p +00 1945 Au 25 22s
--2 p -02/-01 1966 Ap 3 2
--1 p -01/+00 1983 S 25 1s
--1 W- -01/+00 1992 S 27 1s
-0 E WE%sT 1993 Mar 28 1u
--1 E -01/+00
+-2 p %z 1966 O 2 2s
+-1 - %z 1982 Mar 28 0s
+-1 p %z 1986
+-1 E %z 1992 D 27 1s
+0 E WE%sT 1993 Jun 17 1u
+-1 E %z
 Z Atlantic/Bermuda -4:19:18 - LMT 1890
 -4:19:18 Be BMT/BST 1930 Ja 1 2
 -4 Be A%sT 1974 Ap 28 2
 -4 C A%sT 1976
 -4 u A%sT
 Z Atlantic/Canary -1:1:36 - LMT 1922 Mar
--1 - -01 1946 S 30 1
+-1 - %z 1946 S 30 1
 0 - WET 1980 Ap 6 0s
 0 1 WEST 1980 S 28 1u
 0 E WE%sT
 Z Atlantic/Cape_Verde -1:34:4 - LMT 1912 Ja 1 2u
--2 - -02 1942 S
--2 1 -01 1945 O 15
--2 - -02 1975 N 25 2
--1 - -01
+-2 - %z 1942 S
+-2 1 %z 1945 O 15
+-2 - %z 1975 N 25 2
+-1 - %z
 Z Atlantic/Faroe -0:27:4 - LMT 1908 Ja 11
 0 - WET 1981
 0 E WE%sT
 Z Atlantic/Madeira -1:7:36 - LMT 1884
 -1:7:36 - FMT 1912 Ja 1 1u
--1 p -01/+00 1942 Ap 25 22s
--1 p +01 1942 Au 15 22s
--1 p -01/+00 1943 Ap 17 22s
--1 p +01 1943 Au 28 22s
--1 p -01/+00 1944 Ap 22 22s
--1 p +01 1944 Au 26 22s
--1 p -01/+00 1945 Ap 21 22s
--1 p +01 1945 Au 25 22s
--1 p -01/+00 1966 Ap 3 2
-0 p WE%sT 1983 S 25 1s
+-1 p %z 1966 O 2 2s
+0 - WET 1982 Ap 4
+0 p WE%sT 1986 Jul 31
 0 E WE%sT
 Z Atlantic/South_Georgia -2:26:8 - LMT 1890
--2 - -02
+-2 - %z
 Z Atlantic/Stanley -3:51:24 - LMT 1890
 -3:51:24 - SMT 1912 Mar 12
--4 FK -04/-03 1983 May
--3 FK -03/-02 1985 S 15
--4 FK -04/-03 2010 S 5 2
--3 - -03
+-4 FK %z 1983 May
+-3 FK %z 1985 S 15
+-4 FK %z 2010 S 5 2
+-3 - %z
 Z Australia/Adelaide 9:14:20 - LMT 1895 F
 9 - ACST 1899 May
 9:30 AU AC%sT 1971
@@ -3550,8 +3536,8 @@ Z Australia/Darwin 8:43:20 - LMT 1895 F
 9 - ACST 1899 May
 9:30 AU AC%sT
 Z Australia/Eucla 8:35:28 - LMT 1895 D
-8:45 AU +0845/+0945 1943 Jul
-8:45 AW +0845/+0945
+8:45 AU %z 1943 Jul
+8:45 AW %z
 Z Australia/Hobart 9:49:16 - LMT 1895 S
 10 AT AE%sT 1919 O 24
 10 AU AE%sT 1967
@@ -3562,8 +3548,8 @@ Z Australia/Lindeman 9:55:56 - LMT 1895
 10 Ho AE%sT
 Z Australia/Lord_Howe 10:36:20 - LMT 1895 F
 10 - AEST 1981 Mar
-10:30 LH +1030/+1130 1985 Jul
-10:30 LH +1030/+11
+10:30 LH %z 1985 Jul
+10:30 LH %z
 Z Australia/Melbourne 9:39:52 - LMT 1895 F
 10 AU AE%sT 1971
 10 AV AE%sT
@@ -3573,52 +3559,47 @@ Z Australia/Perth 7:43:24 - LMT 1895 D
 Z Australia/Sydney 10:4:52 - LMT 1895 F
 10 AU AE%sT 1971
 10 AN AE%sT
-Z CET 1 c CE%sT
-Z CST6CDT -6 u C%sT
-Z EET 2 E EE%sT
-Z EST -5 - EST
-Z EST5EDT -5 u E%sT
 Z Etc/GMT 0 - GMT
-Z Etc/GMT+1 -1 - -01
-Z Etc/GMT+10 -10 - -10
-Z Etc/GMT+11 -11 - -11
-Z Etc/GMT+12 -12 - -12
-Z Etc/GMT+2 -2 - -02
-Z Etc/GMT+3 -3 - -03
-Z Etc/GMT+4 -4 - -04
-Z Etc/GMT+5 -5 - -05
-Z Etc/GMT+6 -6 - -06
-Z Etc/GMT+7 -7 - -07
-Z Etc/GMT+8 -8 - -08
-Z Etc/GMT+9 -9 - -09
-Z Etc/GMT-1 1 - +01
-Z Etc/GMT-10 10 - +10
-Z Etc/GMT-11 11 - +11
-Z Etc/GMT-12 12 - +12
-Z Etc/GMT-13 13 - +13
-Z Etc/GMT-14 14 - +14
-Z Etc/GMT-2 2 - +02
-Z Etc/GMT-3 3 - +03
-Z Etc/GMT-4 4 - +04
-Z Etc/GMT-5 5 - +05
-Z Etc/GMT-6 6 - +06
-Z Etc/GMT-7 7 - +07
-Z Etc/GMT-8 8 - +08
-Z Etc/GMT-9 9 - +09
+Z Etc/GMT+1 -1 - %z
+Z Etc/GMT+10 -10 - %z
+Z Etc/GMT+11 -11 - %z
+Z Etc/GMT+12 -12 - %z
+Z Etc/GMT+2 -2 - %z
+Z Etc/GMT+3 -3 - %z
+Z Etc/GMT+4 -4 - %z
+Z Etc/GMT+5 -5 - %z
+Z Etc/GMT+6 -6 - %z
+Z Etc/GMT+7 -7 - %z
+Z Etc/GMT+8 -8 - %z
+Z Etc/GMT+9 -9 - %z
+Z Etc/GMT-1 1 - %z
+Z Etc/GMT-10 10 - %z
+Z Etc/GMT-11 11 - %z
+Z Etc/GMT-12 12 - %z
+Z Etc/GMT-13 13 - %z
+Z Etc/GMT-14 14 - %z
+Z Etc/GMT-2 2 - %z
+Z Etc/GMT-3 3 - %z
+Z Etc/GMT-4 4 - %z
+Z Etc/GMT-5 5 - %z
+Z Etc/GMT-6 6 - %z
+Z Etc/GMT-7 7 - %z
+Z Etc/GMT-8 8 - %z
+Z Etc/GMT-9 9 - %z
 Z Etc/UTC 0 - UTC
 Z Europe/Andorra 0:6:4 - LMT 1901
 0 - WET 1946 S 30
 1 - CET 1985 Mar 31 2
 1 E CE%sT
 Z Europe/Astrakhan 3:12:12 - LMT 1924 May
-3 - +03 1930 Jun 21
-4 R +04/+05 1989 Mar 26 2s
-3 R +03/+04 1991 Mar 31 2s
-4 - +04 1992 Mar 29 2s
-3 R +03/+04 2011 Mar 27 2s
-4 - +04 2014 O 26 2s
-3 - +03 2016 Mar 27 2s
-4 - +04
+3 - %z 1930 Jun 21
+4 R %z 1989 Mar 26 2s
+3 R %z 1991 Mar 31 2s
+4 - %z 1992 Mar 29 2s
+3 R %z 2011 Mar 27 2s
+4 - %z 2014 O 26 2s
+3 - %z 2016 Mar 27 2s
+4 - %z
 Z Europe/Athens 1:34:52 - LMT 1895 S 14
 1:34:52 - AMT 1916 Jul 28 0:1
 2 g EE%sT 1941 Ap 30
@@ -3691,7 +3672,7 @@ Z Europe/Helsinki 1:39:49 - LMT 1878 May 31
 Z Europe/Istanbul 1:55:52 - LMT 1880
 1:56:56 - IMT 1910 O
 2 T EE%sT 1978 Jun 29
-3 T +03/+04 1984 N 1 2
+3 T %z 1984 N 1 2
 2 T EE%sT 2007
 2 E EE%sT 2011 Mar 27 1u
 2 - EET 2011 Mar 28 1u
@@ -3700,19 +3681,19 @@ Z Europe/Istanbul 1:55:52 - LMT 1880
 2 E EE%sT 2015 O 25 1u
 2 1 EEST 2015 N 8 1u
 2 E EE%sT 2016 S 7
-3 - +03
+3 - %z
 Z Europe/Kaliningrad 1:22 - LMT 1893 Ap
 1 c CE%sT 1945 Ap 10
 2 O EE%sT 1946 Ap 7
 3 R MSK/MSD 1989 Mar 26 2s
 2 R EE%sT 2011 Mar 27 2s
-3 - +03 2014 O 26 2s
+3 - %z 2014 O 26 2s
 2 - EET
 Z Europe/Kirov 3:18:48 - LMT 1919 Jul 1 0u
-3 - +03 1930 Jun 21
-4 R +04/+05 1989 Mar 26 2s
+3 - %z 1930 Jun 21
+4 R %z 1989 Mar 26 2s
 3 R MSK/MSD 1991 Mar 31 2s
-4 - +04 1992 Mar 29 2s
+4 - %z 1992 Mar 29 2s
 3 R MSK/MSD 2011 Mar 27 2s
 4 - MSK 2014 O 26 2s
 3 - MSK
@@ -3727,10 +3708,10 @@ Z Europe/Kyiv 2:2:4 - LMT 1880
 2 E EE%sT
 Z Europe/Lisbon -0:36:45 - LMT 1884
 -0:36:45 - LMT 1912 Ja 1 0u
-0 p WE%sT 1966 Ap 3 2
+0 p WE%sT 1966 O 2 2s
 1 - CET 1976 S 26 1
-0 p WE%sT 1983 S 25 1s
-0 W- WE%sT 1992 S 27 1s
+0 p WE%sT 1986
+0 E WE%sT 1992 S 27 1u
 1 E CE%sT 1996 Mar 31 1u
 0 E WE%sT
 Z Europe/London -0:1:15 - LMT 1847 D
@@ -3754,7 +3735,7 @@ Z Europe/Minsk 1:50:16 - LMT 1880
 3 R MSK/MSD 1990
 3 - MSK 1991 Mar 31 2s
 2 R EE%sT 2011 Mar 27 2s
-3 - +03
+3 - %z
 Z Europe/Moscow 2:30:17 - LMT 1880
 2:30:17 - MMT 1916 Jul 3
 2:31:19 R %s 1919 Jul 1 0u
@@ -3802,24 +3783,24 @@ Z Europe/Rome 0:49:56 - LMT 1866 D 12
 1 I CE%sT 1980
 1 E CE%sT
 Z Europe/Samara 3:20:20 - LMT 1919 Jul 1 0u
-3 - +03 1930 Jun 21
-4 - +04 1935 Ja 27
-4 R +04/+05 1989 Mar 26 2s
-3 R +03/+04 1991 Mar 31 2s
-2 R +02/+03 1991 S 29 2s
-3 - +03 1991 O 20 3
-4 R +04/+05 2010 Mar 28 2s
-3 R +03/+04 2011 Mar 27 2s
-4 - +04
+3 - %z 1930 Jun 21
+4 - %z 1935 Ja 27
+4 R %z 1989 Mar 26 2s
+3 R %z 1991 Mar 31 2s
+2 R %z 1991 S 29 2s
+3 - %z 1991 O 20 3
+4 R %z 2010 Mar 28 2s
+3 R %z 2011 Mar 27 2s
+4 - %z
 Z Europe/Saratov 3:4:18 - LMT 1919 Jul 1 0u
-3 - +03 1930 Jun 21
-4 R +04/+05 1988 Mar 27 2s
-3 R +03/+04 1991 Mar 31 2s
-4 - +04 1992 Mar 29 2s
-3 R +03/+04 2011 Mar 27 2s
-4 - +04 2014 O 26 2s
-3 - +03 2016 D 4 2s
-4 - +04
+3 - %z 1930 Jun 21
+4 R %z 1988 Mar 27 2s
+3 R %z 1991 Mar 31 2s
+4 - %z 1992 Mar 29 2s
+3 R %z 2011 Mar 27 2s
+4 - %z 2014 O 26 2s
+3 - %z 2016 D 4 2s
+4 - %z
 Z Europe/Simferopol 2:16:24 - LMT 1880
 2:16 - SMT 1924 May 2
 2 - EET 1930 Jun 21
@@ -3863,14 +3844,14 @@ Z Europe/Tirane 1:19:20 - LMT 1914
 1 q CE%sT 1984 Jul
 1 E CE%sT
 Z Europe/Ulyanovsk 3:13:36 - LMT 1919 Jul 1 0u
-3 - +03 1930 Jun 21
-4 R +04/+05 1989 Mar 26 2s
-3 R +03/+04 1991 Mar 31 2s
-2 R +02/+03 1992 Ja 19 2s
-3 R +03/+04 2011 Mar 27 2s
-4 - +04 2014 O 26 2s
-3 - +03 2016 Mar 27 2s
-4 - +04
+3 - %z 1930 Jun 21
+4 R %z 1989 Mar 26 2s
+3 R %z 1991 Mar 31 2s
+2 R %z 1992 Ja 19 2s
+3 R %z 2011 Mar 27 2s
+4 - %z 2014 O 26 2s
+3 - %z 2016 Mar 27 2s
+4 - %z
 Z Europe/Vienna 1:5:21 - LMT 1893 Ap
 1 c CE%sT 1920
 1 a CE%sT 1940 Ap 1 2s
@@ -3895,15 +3876,15 @@ Z Europe/Vilnius 1:41:16 - LMT 1880
 2 - EET 2003
 2 E EE%sT
 Z Europe/Volgograd 2:57:40 - LMT 1920 Ja 3
-3 - +03 1930 Jun 21
-4 - +04 1961 N 11
-4 R +04/+05 1988 Mar 27 2s
+3 - %z 1930 Jun 21
+4 - %z 1961 N 11
+4 R %z 1988 Mar 27 2s
 3 R MSK/MSD 1991 Mar 31 2s
-4 - +04 1992 Mar 29 2s
+4 - %z 1992 Mar 29 2s
 3 R MSK/MSD 2011 Mar 27 2s
 4 - MSK 2014 O 26 2s
 3 - MSK 2018 O 28 2s
-4 - +04 2020 D 27 2s
+4 - %z 2020 D 27 2s
 3 - MSK
 Z Europe/Warsaw 1:24 - LMT 1880
 1:24 - WMT 1915 Au 5
@@ -3919,58 +3900,53 @@ Z Europe/Zurich 0:34:8 - LMT 1853 Jul 16
 1 CH CE%sT 1981
 1 E CE%sT
 Z Factory 0 - -00
-Z HST -10 - HST
 Z Indian/Chagos 4:49:40 - LMT 1907
-5 - +05 1996
-6 - +06
+5 - %z 1996
+6 - %z
 Z Indian/Maldives 4:54 - LMT 1880
 4:54 - MMT 1960
-5 - +05
+5 - %z
 Z Indian/Mauritius 3:50 - LMT 1907
-4 MU +04/+05
-Z MET 1 c ME%sT
-Z MST -7 - MST
-Z MST7MDT -7 u M%sT
-Z PST8PDT -8 u P%sT
+4 MU %z
 Z Pacific/Apia 12:33:4 - LMT 1892 Jul 5
 -11:26:56 - LMT 1911
--11:30 - -1130 1950
--11 WS -11/-10 2011 D 29 24
-13 WS +13/+14
+-11:30 - %z 1950
+-11 WS %z 2011 D 29 24
+13 WS %z
 Z Pacific/Auckland 11:39:4 - LMT 1868 N 2
 11:30 NZ NZ%sT 1946
 12 NZ NZ%sT
 Z Pacific/Bougainville 10:22:16 - LMT 1880
 9:48:32 - PMMT 1895
-10 - +10 1942 Jul
-9 - +09 1945 Au 21
-10 - +10 2014 D 28 2
-11 - +11
+10 - %z 1942 Jul
+9 - %z 1945 Au 21
+10 - %z 2014 D 28 2
+11 - %z
 Z Pacific/Chatham 12:13:48 - LMT 1868 N 2
-12:15 - +1215 1946
-12:45 k +1245/+1345
+12:15 - %z 1946
+12:45 k %z
 Z Pacific/Easter -7:17:28 - LMT 1890
 -7:17:28 - EMT 1932 S
--7 x -07/-06 1982 Mar 14 3u
--6 x -06/-05
+-7 x %z 1982 Mar 14 3u
+-6 x %z
 Z Pacific/Efate 11:13:16 - LMT 1912 Ja 13
-11 VU +11/+12
+11 VU %z
 Z Pacific/Fakaofo -11:24:56 - LMT 1901
--11 - -11 2011 D 30
-13 - +13
+-11 - %z 2011 D 30
+13 - %z
 Z Pacific/Fiji 11:55:44 - LMT 1915 O 26
-12 FJ +12/+13
+12 FJ %z
 Z Pacific/Galapagos -5:58:24 - LMT 1931
--5 - -05 1986
--6 EC -06/-05
+-5 - %z 1986
+-6 EC %z
 Z Pacific/Gambier -8:59:48 - LMT 1912 O
--9 - -09
+-9 - %z
 Z Pacific/Guadalcanal 10:39:48 - LMT 1912 O
-11 - +11
+11 - %z
 Z Pacific/Guam -14:21 - LMT 1844 D 31
 9:39 - LMT 1901
 10 - GST 1941 D 10
-9 - +09 1944 Jul 31
+9 - %z 1944 Jul 31
 10 Gu G%sT 2000 D 23
 10 - ChST
 Z Pacific/Honolulu -10:31:26 - LMT 1896 Ja 13 12
@@ -3979,74 +3955,73 @@ Z Pacific/Honolulu -10:31:26 - LMT 1896 Ja 13 12
 -10:30 u H%sT 1947 Jun 8 2
 -10 - HST
 Z Pacific/Kanton 0 - -00 1937 Au 31
--12 - -12 1979 O
--11 - -11 1994 D 31
-13 - +13
+-12 - %z 1979 O
+-11 - %z 1994 D 31
+13 - %z
 Z Pacific/Kiritimati -10:29:20 - LMT 1901
--10:40 - -1040 1979 O
--10 - -10 1994 D 31
-14 - +14
+-10:40 - %z 1979 O
+-10 - %z 1994 D 31
+14 - %z
 Z Pacific/Kosrae -13:8:4 - LMT 1844 D 31
 10:51:56 - LMT 1901
-11 - +11 1914 O
-9 - +09 1919 F
-11 - +11 1937
-10 - +10 1941 Ap
-9 - +09 1945 Au
-11 - +11 1969 O
-12 - +12 1999
-11 - +11
+11 - %z 1914 O
+9 - %z 1919 F
+11 - %z 1937
+10 - %z 1941 Ap
+9 - %z 1945 Au
+11 - %z 1969 O
+12 - %z 1999
+11 - %z
 Z Pacific/Kwajalein 11:9:20 - LMT 1901
-11 - +11 1937
-10 - +10 1941 Ap
-9 - +09 1944 F 6
-11 - +11 1969 O
--12 - -12 1993 Au 20 24
-12 - +12
+11 - %z 1937
+10 - %z 1941 Ap
+9 - %z 1944 F 6
+11 - %z 1969 O
+-12 - %z 1993 Au 20 24
+12 - %z
 Z Pacific/Marquesas -9:18 - LMT 1912 O
--9:30 - -0930
+-9:30 - %z
 Z Pacific/Nauru 11:7:40 - LMT 1921 Ja 15
-11:30 - +1130 1942 Au 29
-9 - +09 1945 S 8
-11:30 - +1130 1979 F 10 2
-12 - +12
+11:30 - %z 1942 Au 29
+9 - %z 1945 S 8
+11:30 - %z 1979 F 10 2
+12 - %z
 Z Pacific/Niue -11:19:40 - LMT 1952 O 16
--11:20 - -1120 1964 Jul
--11 - -11
+-11:20 - %z 1964 Jul
+-11 - %z
 Z Pacific/Norfolk 11:11:52 - LMT 1901
-11:12 - +1112 1951
-11:30 - +1130 1974 O 27 2s
-11:30 1 +1230 1975 Mar 2 2s
-11:30 - +1130 2015 O 4 2s
-11 - +11 2019 Jul
-11 AN +11/+12
+11:12 - %z 1951
+11:30 - %z 1974 O 27 2s
+11:30 1 %z 1975 Mar 2 2s
+11:30 - %z 2015 O 4 2s
+11 - %z 2019 Jul
+11 AN %z
 Z Pacific/Noumea 11:5:48 - LMT 1912 Ja 13
-11 NC +11/+12
+11 NC %z
 Z Pacific/Pago_Pago 12:37:12 - LMT 1892 Jul 5
 -11:22:48 - LMT 1911
 -11 - SST
 Z Pacific/Palau -15:2:4 - LMT 1844 D 31
 8:57:56 - LMT 1901
-9 - +09
+9 - %z
 Z Pacific/Pitcairn -8:40:20 - LMT 1901
--8:30 - -0830 1998 Ap 27
--8 - -08
+-8:30 - %z 1998 Ap 27
+-8 - %z
 Z Pacific/Port_Moresby 9:48:40 - LMT 1880
 9:48:32 - PMMT 1895
-10 - +10
+10 - %z
 Z Pacific/Rarotonga 13:20:56 - LMT 1899 D 26
 -10:39:4 - LMT 1952 O 16
--10:30 - -1030 1978 N 12
--10 CK -10/-0930
+-10:30 - %z 1978 N 12
+-10 CK %z
 Z Pacific/Tahiti -9:58:16 - LMT 1912 O
--10 - -10
+-10 - %z
 Z Pacific/Tarawa 11:32:4 - LMT 1901
-12 - +12
+12 - %z
 Z Pacific/Tongatapu 12:19:12 - LMT 1945 S 10
-12:20 - +1220 1961
-13 - +13 1999
-13 TO +13/+14
-Z WET 0 E WE%sT
+12:20 - %z 1961
+13 - %z 1999
+13 TO %z
 L Etc/GMT GMT
 L Australia/Sydney Australia/ACT
 L Australia/Lord_Howe Australia/LHI
@@ -4062,6 +4037,8 @@ L America/Rio_Branco Brazil/Acre
 L America/Noronha Brazil/DeNoronha
 L America/Sao_Paulo Brazil/East
 L America/Manaus Brazil/West
+L Europe/Brussels CET
+L America/Chicago CST6CDT
 L America/Halifax Canada/Atlantic
 L America/Winnipeg Canada/Central
 L America/Toronto Canada/Eastern
@@ -4073,6 +4050,9 @@ L America/Whitehorse Canada/Yukon
 L America/Santiago Chile/Continental
 L Pacific/Easter Chile/EasterIsland
 L America/Havana Cuba
+L Europe/Athens EET
+L America/Panama EST
+L America/New_York EST5EDT
 L Africa/Cairo Egypt
 L Europe/Dublin Eire
 L Etc/GMT Etc/GMT+0
@@ -4096,6 +4076,9 @@ L America/Jamaica Jamaica
 L Asia/Tokyo Japan
 L Pacific/Kwajalein Kwajalein
 L Africa/Tripoli Libya
+L Europe/Brussels MET
+L America/Phoenix MST
+L America/Denver MST7MDT
 L America/Tijuana Mexico/BajaNorte
 L America/Mazatlan Mexico/BajaSur
 L America/Mexico_City Mexico/General
@@ -4259,6 +4242,7 @@ L America/Denver America/Shiprock
 L America/Toronto America/Thunder_Bay
 L America/Edmonton America/Yellowknife
 L Pacific/Auckland Antarctica/South_Pole
+L Asia/Ulaanbaatar Asia/Choibalsan
 L Asia/Shanghai Asia/Chongqing
 L Asia/Shanghai Asia/Harbin
 L Asia/Urumqi Asia/Kashgar
@@ -4273,6 +4257,7 @@ L Europe/Kyiv Europe/Zaporozhye
 L Pacific/Kanton Pacific/Enderbury
 L Pacific/Honolulu Pacific/Johnston
 L Pacific/Port_Moresby Pacific/Yap
+L Europe/Lisbon WET
 L Africa/Nairobi Africa/Asmera
 L America/Nuuk America/Godthab
 L Asia/Ashgabat Asia/Ashkhabad
@@ -4290,5 +4275,7 @@ L Asia/Ulaanbaatar Asia/Ulan_Bator
 L Atlantic/Faroe Atlantic/Faeroe
 L Europe/Kyiv Europe/Kiev
 L Asia/Nicosia Europe/Nicosia
+L Pacific/Honolulu HST
+L America/Los_Angeles PST8PDT
 L Pacific/Guadalcanal Pacific/Ponape
 L Pacific/Port_Moresby Pacific/Truk
diff --git a/lib/tzdata/zoneinfo/zone.tab b/lib/tzdata/zoneinfo/zone.tab
index 3fa9306a..bfc0b593 100644
--- a/lib/tzdata/zoneinfo/zone.tab
+++ b/lib/tzdata/zoneinfo/zone.tab
@@ -264,8 +264,7 @@ MK	+4159+02126	Europe/Skopje
 ML	+1239-00800	Africa/Bamako
 MM	+1647+09610	Asia/Yangon
 MN	+4755+10653	Asia/Ulaanbaatar	most of Mongolia
-MN	+4801+09139	Asia/Hovd	Bayan-Olgiy, Govi-Altai, Hovd, Uvs, Zavkhan
-MN	+4804+11430	Asia/Choibalsan	Dornod, Sukhbaatar
+MN	+4801+09139	Asia/Hovd	Bayan-Olgii, Hovd, Uvs
 MO	+221150+1133230	Asia/Macau
 MP	+1512+14545	Pacific/Saipan
 MQ	+1436-06105	America/Martinique
diff --git a/lib/tzdata/zoneinfo/zone1970.tab b/lib/tzdata/zoneinfo/zone1970.tab
index abd94897..7726f39a 100644
--- a/lib/tzdata/zoneinfo/zone1970.tab
+++ b/lib/tzdata/zoneinfo/zone1970.tab
@@ -209,8 +209,7 @@ MD	+4700+02850	Europe/Chisinau
 MH	+0905+16720	Pacific/Kwajalein	Kwajalein
 MM,CC	+1647+09610	Asia/Yangon
 MN	+4755+10653	Asia/Ulaanbaatar	most of Mongolia
-MN	+4801+09139	Asia/Hovd	Bayan-Ölgii, Govi-Altai, Hovd, Uvs, Zavkhan
-MN	+4804+11430	Asia/Choibalsan	Dornod, Sükhbaatar
+MN	+4801+09139	Asia/Hovd	Bayan-Ölgii, Hovd, Uvs
 MO	+221150+1133230	Asia/Macau
 MQ	+1436-06105	America/Martinique
 MT	+3554+01431	Europe/Malta
diff --git a/lib/tzdata/zoneinfo/zonenow.tab b/lib/tzdata/zoneinfo/zonenow.tab
index b6f29109..01f536b3 100644
--- a/lib/tzdata/zoneinfo/zonenow.tab
+++ b/lib/tzdata/zoneinfo/zonenow.tab
@@ -5,7 +5,7 @@
 # From Paul Eggert (2023-12-18):
 # This file contains a table where each row stands for a timezone
 # where civil timestamps are predicted to agree from now on.
-# This file is like zone1970.tab (see zone1970.tab's coments),
+# This file is like zone1970.tab (see zone1970.tab's comments),
 # but with the following changes:
 #
 # 1.  Each timezone corresponds to a set of clocks that are planned
@@ -123,8 +123,6 @@ XX	+1455-02331	Atlantic/Cape_Verde	Cape Verde
 #
 # -01/+00 (EU DST)
 XX	+3744-02540	Atlantic/Azores	Azores
-# -01/+00 (EU DST) until 2024-03-31; then -02/-01 (EU DST)
-XX	+7029-02158	America/Scoresbysund	Ittoqqortoormiit
 #
 # +00 - GMT
 XX	+0519-00402	Africa/Abidjan	far western Africa; Iceland ("GMT")
@@ -199,7 +197,7 @@ XX	+2518+05518	Asia/Dubai	Russia; Caucasus; Persian Gulf; Seychelles; Réunion
 XX	+3431+06912	Asia/Kabul	Afghanistan
 #
 # +05
-XX	+4120+06918	Asia/Tashkent	Russia; west Kazakhstan; Tajikistan; Turkmenistan; Uzbekistan; Maldives
+XX	+4120+06918	Asia/Tashkent	Russia; Kazakhstan; Tajikistan; Turkmenistan; Uzbekistan; Maldives
 #
 # +05 - PKT
 XX	+2452+06703	Asia/Karachi	Pakistan ("PKT")
@@ -215,8 +213,6 @@ XX	+2743+08519	Asia/Kathmandu	Nepal
 #
 # +06
 XX	+2343+09025	Asia/Dhaka	Russia; Kyrgyzstan; Bhutan; Bangladesh; Chagos
-# +06 until 2024-03-01; then +05
-XX	+4315+07657	Asia/Almaty	Kazakhstan (except western areas)
 #
 # +06:30
 XX	+1647+09610	Asia/Yangon	Myanmar; Cocos
diff --git a/lib/tzdata/zones b/lib/tzdata/zones
index b054f010..3c4a951d 100644
--- a/lib/tzdata/zones
+++ b/lib/tzdata/zones
@@ -159,7 +159,6 @@ Asia/Barnaul
 Asia/Beirut
 Asia/Bishkek
 Asia/Chita
-Asia/Choibalsan
 Asia/Colombo
 Asia/Damascus
 Asia/Dhaka
@@ -239,11 +238,6 @@ Australia/Lord_Howe
 Australia/Melbourne
 Australia/Perth
 Australia/Sydney
-CET
-CST6CDT
-EET
-EST
-EST5EDT
 Etc/GMT
 Etc/GMT+1
 Etc/GMT+10
@@ -311,14 +305,9 @@ Europe/Volgograd
 Europe/Warsaw
 Europe/Zurich
 Factory
-HST
 Indian/Chagos
 Indian/Maldives
 Indian/Mauritius
-MET
-MST
-MST7MDT
-PST8PDT
 Pacific/Apia
 Pacific/Auckland
 Pacific/Bougainville
@@ -349,7 +338,6 @@ Pacific/Rarotonga
 Pacific/Tahiti
 Pacific/Tarawa
 Pacific/Tongatapu
-WET
 GMT
 Australia/ACT
 Australia/LHI
@@ -365,6 +353,8 @@ Brazil/Acre
 Brazil/DeNoronha
 Brazil/East
 Brazil/West
+CET
+CST6CDT
 Canada/Atlantic
 Canada/Central
 Canada/Eastern
@@ -376,6 +366,9 @@ Canada/Yukon
 Chile/Continental
 Chile/EasterIsland
 Cuba
+EET
+EST
+EST5EDT
 Egypt
 Eire
 Etc/GMT+0
@@ -399,6 +392,9 @@ Jamaica
 Japan
 Kwajalein
 Libya
+MET
+MST
+MST7MDT
 Mexico/BajaNorte
 Mexico/BajaSur
 Mexico/General
@@ -562,6 +558,7 @@ America/Shiprock
 America/Thunder_Bay
 America/Yellowknife
 Antarctica/South_Pole
+Asia/Choibalsan
 Asia/Chongqing
 Asia/Harbin
 Asia/Kashgar
@@ -576,6 +573,7 @@ Europe/Zaporozhye
 Pacific/Enderbury
 Pacific/Johnston
 Pacific/Yap
+WET
 Africa/Asmera
 America/Godthab
 Asia/Ashkhabad
@@ -593,5 +591,7 @@ Asia/Ulan_Bator
 Atlantic/Faeroe
 Europe/Kiev
 Europe/Nicosia
+HST
+PST8PDT
 Pacific/Ponape
 Pacific/Truk
diff --git a/requirements.txt b/requirements.txt
index 86e315d4..83488ae2 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -41,7 +41,7 @@ simplejson==3.19.3
 six==1.16.0
 tempora==5.7.0
 tokenize-rt==6.0.0
-tzdata==2024.1
+tzdata==2024.2
 tzlocal==5.0.1
 urllib3<2
 webencodings==0.5.1

From 86abd130b00669cdfaf19e58e252461d799fde8a Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 16 Nov 2024 14:51:34 -0800
Subject: [PATCH 672/743] Bump profilehooks from 1.12.0 to 1.13.0 (#2414)

* Bump profilehooks from 1.12.0 to 1.13.0

Bumps [profilehooks](https://github.com/mgedmin/profilehooks) from 1.12.0 to 1.13.0.
- [Changelog](https://github.com/mgedmin/profilehooks/blob/master/CHANGES.rst)
- [Commits](https://github.com/mgedmin/profilehooks/compare/1.12.0...1.13.0)

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

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

* Update profilehooks==1.13.0

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/profilehooks.py | 261 +++++---------------------------------------
 requirements.txt    |   2 +-
 2 files changed, 31 insertions(+), 232 deletions(-)

diff --git a/lib/profilehooks.py b/lib/profilehooks.py
index 14ac6020..64c34382 100644
--- a/lib/profilehooks.py
+++ b/lib/profilehooks.py
@@ -39,28 +39,12 @@ instead of a detailed (but costly) profile.
 
 Caveats
 
-  A thread on python-dev convinced me that hotshot produces bogus numbers.
-  See https://mail.python.org/pipermail/python-dev/2005-November/058264.html
-
   I don't know what will happen if a decorated function will try to call
   another decorated function.  All decorators probably need to explicitly
   support nested profiling (currently TraceFuncCoverage is the only one
-  that supports this, while HotShotFuncProfile has support for recursive
-  functions.)
+  that supports this.)
 
-  Profiling with hotshot creates temporary files (*.prof for profiling,
-  *.cprof for coverage) in the current directory.  These files are not
-  cleaned up.  Exception: when you specify a filename to the profile
-  decorator (to store the pstats.Stats object for later inspection),
-  the temporary file will be the filename you specified with '.raw'
-  appended at the end.
-
-  Coverage analysis with hotshot seems to miss some executions resulting
-  in lower line counts and some lines errorneously marked as never
-  executed.  For this reason coverage analysis now uses trace.py which is
-  slower, but more accurate.
-
-Copyright (c) 2004--2020 Marius Gedminas <marius@gedmin.as>
+Copyright (c) 2004--2023 Marius Gedminas <marius@gedmin.as>
 Copyright (c) 2007 Hanno Schlichting
 Copyright (c) 2008 Florian Schulze
 
@@ -86,47 +70,21 @@ Released under the MIT licence since December 2006:
 
 (Previously it was distributed under the GNU General Public Licence.)
 """
-from __future__ import print_function
-
-__author__ = "Marius Gedminas <marius@gedmin.as>"
-__copyright__ = "Copyright 2004-2020 Marius Gedminas and contributors"
-__license__ = "MIT"
-__version__ = '1.12.0'
-__date__ = "2020-08-20"
-
 import atexit
-
+import dis
 import functools
 import inspect
 import logging
 import os
+import pstats
 import re
 import sys
-
-# For profiling
-from profile import Profile
-import pstats
-
-# For timecall
 import timeit
-
-# For hotshot profiling (inaccurate!)
-try:
-    import hotshot
-    import hotshot.stats
-except ImportError:
-    hotshot = None
-
-# For trace.py coverage
-import trace
-import dis
 import token
 import tokenize
+import trace
+from profile import Profile
 
-# For hotshot coverage (inaccurate!; uses undocumented APIs; might break)
-if hotshot is not None:
-    import _hotshot
-    import hotshot.log
 
 # For cProfile profiling (best)
 try:
@@ -134,28 +92,22 @@ try:
 except ImportError:
     cProfile = None
 
+
+__author__ = "Marius Gedminas <marius@gedmin.as>"
+__copyright__ = "Copyright 2004-2020 Marius Gedminas and contributors"
+__license__ = "MIT"
+__version__ = '1.13.0'
+__date__ = "2024-10-09"
+
+
 # registry of available profilers
 AVAILABLE_PROFILERS = {}
 
-__all__ = ['coverage', 'coverage_with_hotshot', 'profile', 'timecall']
-
-
-# Use tokenize.open() on Python >= 3.2, fall back to open() on Python 2
-tokenize_open = getattr(tokenize, 'open', open)
-
-
-def _unwrap(fn):
-    # inspect.unwrap() doesn't exist on Python 2
-    if not hasattr(fn, '__wrapped__'):
-        return fn
-    else:
-        # intentionally using recursion here instead of a while loop to
-        # make cycles fail with a recursion error instead of looping forever.
-        return _unwrap(fn.__wrapped__)
+__all__ = ['coverage', 'profile', 'timecall']
 
 
 def _identify(fn):
-    fn = _unwrap(fn)
+    fn = inspect.unwrap(fn)
     funcname = fn.__name__
     filename = fn.__code__.co_filename
     lineno = fn.__code__.co_firstlineno
@@ -168,7 +120,7 @@ def _is_file_like(o):
 
 def profile(fn=None, skip=0, filename=None, immediate=False, dirs=False,
             sort=None, entries=40,
-            profiler=('cProfile', 'profile', 'hotshot'),
+            profiler=('cProfile', 'profile'),
             stdout=True):
     """Mark `fn` for profiling.
 
@@ -205,7 +157,7 @@ def profile(fn=None, skip=0, filename=None, immediate=False, dirs=False,
 
     `profiler` can be used to select the preferred profiler, or specify a
     sequence of them, in order of preference.  The default is ('cProfile'.
-    'profile', 'hotshot').
+    'profile').
 
     If `filename` is specified, the profile stats will be stored in the
     named file.  You can load them with pstats.Stats(filename) or use a
@@ -279,26 +231,7 @@ def coverage(fn):
             ...
 
     """
-    fp = TraceFuncCoverage(fn)  # or HotShotFuncCoverage
-    # We cannot return fp or fp.__call__ directly as that would break method
-    # definitions, instead we need to return a plain function.
-
-    @functools.wraps(fn)
-    def new_fn(*args, **kw):
-        return fp(*args, **kw)
-    return new_fn
-
-
-def coverage_with_hotshot(fn):
-    """Mark `fn` for line coverage analysis.
-
-    Uses the 'hotshot' module for fast coverage analysis.
-
-    BUG: Produces inaccurate results.
-
-    See the docstring of `coverage` for usage examples.
-    """
-    fp = HotShotFuncCoverage(fn)
+    fp = TraceFuncCoverage(fn)
     # We cannot return fp or fp.__call__ directly as that would break method
     # definitions, instead we need to return a plain function.
 
@@ -424,148 +357,8 @@ if cProfile is not None:
     AVAILABLE_PROFILERS['cProfile'] = CProfileFuncProfile
 
 
-if hotshot is not None:
-
-    class HotShotFuncProfile(FuncProfile):
-        """Profiler for a function (uses hotshot)."""
-
-        # This flag is shared between all instances
-        in_profiler = False
-
-        def __init__(self, fn, skip=0, filename=None, immediate=False,
-                     dirs=False, sort=None, entries=40, stdout=True):
-            """Creates a profiler for a function.
-
-            Every profiler has its own log file (the name of which is derived
-            from the function name).
-
-            HotShotFuncProfile registers an atexit handler that prints
-            profiling information to sys.stderr when the program terminates.
-
-            The log file is not removed and remains there to clutter the
-            current working directory.
-            """
-            if filename:
-                self.logfilename = filename + ".raw"
-            else:
-                self.logfilename = "%s.%d.prof" % (fn.__name__, os.getpid())
-            super(HotShotFuncProfile, self).__init__(
-                fn, skip=skip, filename=filename, immediate=immediate,
-                dirs=dirs, sort=sort, entries=entries, stdout=stdout)
-
-        def __call__(self, *args, **kw):
-            """Profile a singe call to the function."""
-            self.ncalls += 1
-            if self.skip > 0:
-                self.skip -= 1
-                self.skipped += 1
-                return self.fn(*args, **kw)
-            if HotShotFuncProfile.in_profiler:
-                # handle recursive calls
-                return self.fn(*args, **kw)
-            if self.profiler is None:
-                self.profiler = hotshot.Profile(self.logfilename)
-            try:
-                HotShotFuncProfile.in_profiler = True
-                return self.profiler.runcall(self.fn, *args, **kw)
-            finally:
-                HotShotFuncProfile.in_profiler = False
-                if self.immediate:
-                    self.print_stats()
-                    self.reset_stats()
-
-        def print_stats(self):
-            if self.profiler is None:
-                self.stats = pstats.Stats(Profile())
-            else:
-                self.profiler.close()
-                self.stats = hotshot.stats.load(self.logfilename)
-            super(HotShotFuncProfile, self).print_stats()
-
-        def reset_stats(self):
-            self.profiler = None
-            self.ncalls = 0
-            self.skipped = 0
-
-    AVAILABLE_PROFILERS['hotshot'] = HotShotFuncProfile
-
-    class HotShotFuncCoverage:
-        """Coverage analysis for a function (uses _hotshot).
-
-        HotShot coverage is reportedly faster than trace.py, but it appears to
-        have problems with exceptions; also line counts in coverage reports
-        are generally lower from line counts produced by TraceFuncCoverage.
-        Is this my bug, or is it a problem with _hotshot?
-        """
-
-        def __init__(self, fn):
-            """Creates a profiler for a function.
-
-            Every profiler has its own log file (the name of which is derived
-            from the function name).
-
-            HotShotFuncCoverage registers an atexit handler that prints
-            profiling information to sys.stderr when the program terminates.
-
-            The log file is not removed and remains there to clutter the
-            current working directory.
-            """
-            self.fn = fn
-            self.logfilename = "%s.%d.cprof" % (fn.__name__, os.getpid())
-            self.profiler = _hotshot.coverage(self.logfilename)
-            self.ncalls = 0
-            atexit.register(self.atexit)
-
-        def __call__(self, *args, **kw):
-            """Profile a singe call to the function."""
-            self.ncalls += 1
-            old_trace = sys.gettrace()
-            try:
-                return self.profiler.runcall(self.fn, args, kw)
-            finally:  # pragma: nocover
-                sys.settrace(old_trace)
-
-        def atexit(self):
-            """Stop profiling and print profile information to sys.stderr.
-
-            This function is registered as an atexit hook.
-            """
-            self.profiler.close()
-            funcname, filename, lineno = _identify(self.fn)
-            print("")
-            print("*** COVERAGE RESULTS ***")
-            print("%s (%s:%s)" % (funcname, filename, lineno))
-            print("function called %d times" % self.ncalls)
-            print("")
-            fs = FuncSource(self.fn)
-            reader = hotshot.log.LogReader(self.logfilename)
-            for what, (filename, lineno, funcname), tdelta in reader:
-                if filename != fs.filename:
-                    continue
-                if what == hotshot.log.LINE:
-                    fs.mark(lineno)
-                if what == hotshot.log.ENTER:
-                    # hotshot gives us the line number of the function
-                    # definition and never gives us a LINE event for the first
-                    # statement in a function, so if we didn't perform this
-                    # mapping, the first statement would be marked as never
-                    # executed
-                    if lineno == fs.firstlineno:
-                        lineno = fs.firstcodelineno
-                    fs.mark(lineno)
-            reader.close()
-            print(fs)
-            never_executed = fs.count_never_executed()
-            if never_executed:
-                print("%d lines were not executed." % never_executed)
-
-
 class TraceFuncCoverage:
-    """Coverage analysis for a function (uses trace module).
-
-    HotShot coverage analysis is reportedly faster, but it appears to have
-    problems with exceptions.
-    """
+    """Coverage analysis for a function (uses trace module)."""
 
     # Shared between all instances so that nested calls work
     tracer = trace.Trace(count=True, trace=False,
@@ -646,13 +439,19 @@ class FuncSource:
 
     def find_source_lines(self):
         """Mark all executable source lines in fn as executed 0 times."""
-        if self.filename is None:
+        if self.filename is None:  # pragma: nocover
+            # I don't know how to make inspect.getsourcefile() return None in
+            # our test suite, but I've looked at its source and I know that it
+            # can do so.
             return
         strs = self._find_docstrings(self.filename)
         lines = {
             ln
-            for off, ln in dis.findlinestarts(_unwrap(self.fn).__code__)
-            if ln not in strs
+            for off, ln in dis.findlinestarts(inspect.unwrap(self.fn).__code__)
+            # skipping firstlineno because Python 3.11 adds a 'RESUME' opcode
+            # attributed to the `def` line, but then trace.py never sees it
+            # getting executed
+            if ln is not None and ln not in strs and ln != self.firstlineno
         }
         for lineno in lines:
             self.sourcelines.setdefault(lineno, 0)
@@ -667,7 +466,7 @@ class FuncSource:
         # Python 3.2 and removed in 3.6.
         strs = set()
         prev = token.INDENT  # so module docstring is detected as docstring
-        with tokenize_open(filename) as f:
+        with tokenize.open(filename) as f:
             tokens = tokenize.generate_tokens(f.readline)
             for ttype, tstr, start, end, line in tokens:
                 if ttype == token.STRING and prev == token.INDENT:
diff --git a/requirements.txt b/requirements.txt
index 83488ae2..f2768e54 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -28,7 +28,7 @@ paho-mqtt==2.1.0
 platformdirs==4.3.6
 plexapi==4.15.16
 portend==3.2.0
-profilehooks==1.12.0
+profilehooks==1.13.0
 PyJWT==2.9.0
 pyparsing==3.1.4
 python-dateutil==2.9.0.post0

From af752e0accd02b162cd628420b52acb97c680774 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 16 Nov 2024 14:51:45 -0800
Subject: [PATCH 673/743] Bump xmltodict from 0.13.0 to 0.14.2 (#2418)

* Bump xmltodict from 0.13.0 to 0.14.2

Bumps [xmltodict](https://github.com/martinblech/xmltodict) from 0.13.0 to 0.14.2.
- [Changelog](https://github.com/martinblech/xmltodict/blob/master/CHANGELOG.md)
- [Commits](https://github.com/martinblech/xmltodict/compare/v0.13.0...v0.14.2)

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

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

* Update xmltodict==0.14.2

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/xmltodict.py | 66 ++++++++++++++++--------------------------------
 requirements.txt |  2 +-
 2 files changed, 23 insertions(+), 45 deletions(-)

diff --git a/lib/xmltodict.py b/lib/xmltodict.py
index ca760aa6..098f6276 100644
--- a/lib/xmltodict.py
+++ b/lib/xmltodict.py
@@ -1,19 +1,10 @@
 #!/usr/bin/env python
 "Makes working with XML feel like you are working with JSON"
 
-try:
-    from defusedexpat import pyexpat as expat
-except ImportError:
-    from xml.parsers import expat
+from xml.parsers import expat
 from xml.sax.saxutils import XMLGenerator
 from xml.sax.xmlreader import AttributesImpl
-try:  # pragma no cover
-    from cStringIO import StringIO
-except ImportError:  # pragma no cover
-    try:
-        from StringIO import StringIO
-    except ImportError:
-        from io import StringIO
+from io import StringIO
 
 _dict = dict
 import platform
@@ -22,17 +13,8 @@ if tuple(map(int, platform.python_version_tuple()[:2])) < (3, 7):
 
 from inspect import isgenerator
 
-try:  # pragma no cover
-    _basestring = basestring
-except NameError:  # pragma no cover
-    _basestring = str
-try:  # pragma no cover
-    _unicode = unicode
-except NameError:  # pragma no cover
-    _unicode = str
-
 __author__ = 'Martin Blech'
-__version__ = '0.13.0'
+__version__ = "0.14.2"
 __license__ = 'MIT'
 
 
@@ -40,7 +22,7 @@ class ParsingInterrupted(Exception):
     pass
 
 
-class _DictSAXHandler(object):
+class _DictSAXHandler:
     def __init__(self,
                  item_depth=0,
                  item_callback=lambda *args: True,
@@ -107,7 +89,7 @@ class _DictSAXHandler(object):
             attrs['xmlns'] = self.namespace_declarations
             self.namespace_declarations = self.dict_constructor()
         self.path.append((name, attrs or None))
-        if len(self.path) > self.item_depth:
+        if len(self.path) >= self.item_depth:
             self.stack.append((self.item, self.data))
             if self.xml_attribs:
                 attr_entries = []
@@ -135,7 +117,7 @@ class _DictSAXHandler(object):
 
             should_continue = self.item_callback(self.path, item)
             if not should_continue:
-                raise ParsingInterrupted()
+                raise ParsingInterrupted
         if self.stack:
             data = (None if not self.data
                     else self.cdata_separator.join(self.data))
@@ -335,9 +317,8 @@ def parse(xml_input, encoding=None, expat=expat, process_namespaces=False,
     """
     handler = _DictSAXHandler(namespace_separator=namespace_separator,
                               **kwargs)
-    if isinstance(xml_input, _unicode):
-        if not encoding:
-            encoding = 'utf-8'
+    if isinstance(xml_input, str):
+        encoding = encoding or 'utf-8'
         xml_input = xml_input.encode(encoding)
     if not process_namespaces:
         namespace_separator = None
@@ -372,8 +353,8 @@ def parse(xml_input, encoding=None, expat=expat, process_namespaces=False,
         parser.ParseFile(xml_input)
     elif isgenerator(xml_input):
         for chunk in xml_input:
-            parser.Parse(chunk,False)
-        parser.Parse(b'',True)
+            parser.Parse(chunk, False)
+        parser.Parse(b'', True)
     else:
         parser.Parse(xml_input, True)
     return handler.item
@@ -412,9 +393,7 @@ def _emit(key, value, content_handler,
         if result is None:
             return
         key, value = result
-    if (not hasattr(value, '__iter__')
-            or isinstance(value, _basestring)
-            or isinstance(value, dict)):
+    if not hasattr(value, '__iter__') or isinstance(value, (str, dict)):
         value = [value]
     for index, v in enumerate(value):
         if full_document and depth == 0 and index > 0:
@@ -422,16 +401,13 @@ def _emit(key, value, content_handler,
         if v is None:
             v = _dict()
         elif isinstance(v, bool):
-            if v:
-                v = _unicode('true')
-            else:
-                v = _unicode('false')
-        elif not isinstance(v, dict):
-            if expand_iter and hasattr(v, '__iter__') and not isinstance(v, _basestring):
+            v = 'true' if v else 'false'
+        elif not isinstance(v, (dict, str)):
+            if expand_iter and hasattr(v, '__iter__'):
                 v = _dict(((expand_iter, v),))
             else:
-                v = _unicode(v)
-        if isinstance(v, _basestring):
+                v = str(v)
+        if isinstance(v, str):
             v = _dict(((cdata_key, v),))
         cdata = None
         attrs = _dict()
@@ -445,14 +421,16 @@ def _emit(key, value, content_handler,
                                         attr_prefix)
                 if ik == '@xmlns' and isinstance(iv, dict):
                     for k, v in iv.items():
-                        attr = 'xmlns{}'.format(':{}'.format(k) if k else '')
-                        attrs[attr] = _unicode(v)
+                        attr = 'xmlns{}'.format(f':{k}' if k else '')
+                        attrs[attr] = str(v)
                     continue
-                if not isinstance(iv, _unicode):
-                    iv = _unicode(iv)
+                if not isinstance(iv, str):
+                    iv = str(iv)
                 attrs[ik[len(attr_prefix):]] = iv
                 continue
             children.append((ik, iv))
+        if isinstance(indent, int):
+            indent = ' ' * indent
         if pretty:
             content_handler.ignorableWhitespace(depth * indent)
         content_handler.startElement(key, AttributesImpl(attrs))
diff --git a/requirements.txt b/requirements.txt
index f2768e54..92f7474e 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -46,7 +46,7 @@ tzlocal==5.0.1
 urllib3<2
 webencodings==0.5.1
 websocket-client==1.8.0
-xmltodict==0.13.0
+xmltodict==0.14.2
 zipp==3.19.2
 
 # configobj==5.1.0

From 9289ead9967b84f5cee1ee5d22554490f39e23fc Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 16 Nov 2024 14:51:58 -0800
Subject: [PATCH 674/743] Bump mako from 1.3.5 to 1.3.6 (#2423)

* Bump mako from 1.3.5 to 1.3.6

Bumps [mako](https://github.com/sqlalchemy/mako) from 1.3.5 to 1.3.6.
- [Release notes](https://github.com/sqlalchemy/mako/releases)
- [Changelog](https://github.com/sqlalchemy/mako/blob/main/CHANGES)
- [Commits](https://github.com/sqlalchemy/mako/commits)

---
updated-dependencies:
- dependency-name: mako
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

* Update mako==1.3.6

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/mako/__init__.py         |   2 +-
 lib/mako/lexer.py            |   2 +-
 lib/markupsafe/__init__.py   | 355 +++++++++++++++++++++--------------
 lib/markupsafe/_native.py    |  61 +-----
 lib/markupsafe/_speedups.c   | 158 +++-------------
 lib/markupsafe/_speedups.pyi |  10 +-
 requirements.txt             |   2 +-
 7 files changed, 237 insertions(+), 353 deletions(-)

diff --git a/lib/mako/__init__.py b/lib/mako/__init__.py
index 0ac3dd68..d7223f7c 100644
--- a/lib/mako/__init__.py
+++ b/lib/mako/__init__.py
@@ -5,4 +5,4 @@
 # the MIT License: http://www.opensource.org/licenses/mit-license.php
 
 
-__version__ = "1.3.5"
+__version__ = "1.3.6"
diff --git a/lib/mako/lexer.py b/lib/mako/lexer.py
index 9d1f5f30..b4a76a45 100644
--- a/lib/mako/lexer.py
+++ b/lib/mako/lexer.py
@@ -375,7 +375,7 @@ class Lexer:
                  |
                  (?=\${)      # an expression
                  |
-                 (?=</?[%&])  # a substitution or block or call start or end
+                 (?=</?%)  # a substitution or block or call start or end
                               # - don't consume
                  |
                  (\\\r?\n)    # an escaped newline  - throw away
diff --git a/lib/markupsafe/__init__.py b/lib/markupsafe/__init__.py
index b40f24c6..fee8dc7a 100644
--- a/lib/markupsafe/__init__.py
+++ b/lib/markupsafe/__init__.py
@@ -1,29 +1,84 @@
-import functools
+from __future__ import annotations
+
+import collections.abc as cabc
 import string
-import sys
 import typing as t
 
+try:
+    from ._speedups import _escape_inner
+except ImportError:
+    from ._native import _escape_inner
+
 if t.TYPE_CHECKING:
     import typing_extensions as te
 
-    class HasHTML(te.Protocol):
-        def __html__(self) -> str:
-            pass
 
-    _P = te.ParamSpec("_P")
+class _HasHTML(t.Protocol):
+    def __html__(self, /) -> str: ...
 
 
-__version__ = "2.1.5"
+class _TPEscape(t.Protocol):
+    def __call__(self, s: t.Any, /) -> Markup: ...
 
 
-def _simple_escaping_wrapper(func: "t.Callable[_P, str]") -> "t.Callable[_P, Markup]":
-    @functools.wraps(func)
-    def wrapped(self: "Markup", *args: "_P.args", **kwargs: "_P.kwargs") -> "Markup":
-        arg_list = _escape_argspec(list(args), enumerate(args), self.escape)
-        _escape_argspec(kwargs, kwargs.items(), self.escape)
-        return self.__class__(func(self, *arg_list, **kwargs))  # type: ignore[arg-type]
+def escape(s: t.Any, /) -> Markup:
+    """Replace the characters ``&``, ``<``, ``>``, ``'``, and ``"`` in
+    the string with HTML-safe sequences. Use this if you need to display
+    text that might contain such characters in HTML.
 
-    return wrapped  # type: ignore[return-value]
+    If the object has an ``__html__`` method, it is called and the
+    return value is assumed to already be safe for HTML.
+
+    :param s: An object to be converted to a string and escaped.
+    :return: A :class:`Markup` string with the escaped text.
+    """
+    # If the object is already a plain string, skip __html__ check and string
+    # conversion. This is the most common use case.
+    # Use type(s) instead of s.__class__ because a proxy object may be reporting
+    # the __class__ of the proxied value.
+    if type(s) is str:
+        return Markup(_escape_inner(s))
+
+    if hasattr(s, "__html__"):
+        return Markup(s.__html__())
+
+    return Markup(_escape_inner(str(s)))
+
+
+def escape_silent(s: t.Any | None, /) -> Markup:
+    """Like :func:`escape` but treats ``None`` as the empty string.
+    Useful with optional values, as otherwise you get the string
+    ``'None'`` when the value is ``None``.
+
+    >>> escape(None)
+    Markup('None')
+    >>> escape_silent(None)
+    Markup('')
+    """
+    if s is None:
+        return Markup()
+
+    return escape(s)
+
+
+def soft_str(s: t.Any, /) -> str:
+    """Convert an object to a string if it isn't already. This preserves
+    a :class:`Markup` string rather than converting it back to a basic
+    string, so it will still be marked as safe and won't be escaped
+    again.
+
+    >>> value = escape("<User 1>")
+    >>> value
+    Markup('&lt;User 1&gt;')
+    >>> escape(str(value))
+    Markup('&amp;lt;User 1&amp;gt;')
+    >>> escape(soft_str(value))
+    Markup('&lt;User 1&gt;')
+    """
+    if not isinstance(s, str):
+        return str(s)
+
+    return s
 
 
 class Markup(str):
@@ -65,82 +120,72 @@ class Markup(str):
     __slots__ = ()
 
     def __new__(
-        cls, base: t.Any = "", encoding: t.Optional[str] = None, errors: str = "strict"
-    ) -> "te.Self":
-        if hasattr(base, "__html__"):
-            base = base.__html__()
+        cls, object: t.Any = "", encoding: str | None = None, errors: str = "strict"
+    ) -> te.Self:
+        if hasattr(object, "__html__"):
+            object = object.__html__()
 
         if encoding is None:
-            return super().__new__(cls, base)
+            return super().__new__(cls, object)
 
-        return super().__new__(cls, base, encoding, errors)
+        return super().__new__(cls, object, encoding, errors)
 
-    def __html__(self) -> "te.Self":
+    def __html__(self, /) -> te.Self:
         return self
 
-    def __add__(self, other: t.Union[str, "HasHTML"]) -> "te.Self":
-        if isinstance(other, str) or hasattr(other, "__html__"):
-            return self.__class__(super().__add__(self.escape(other)))
+    def __add__(self, value: str | _HasHTML, /) -> te.Self:
+        if isinstance(value, str) or hasattr(value, "__html__"):
+            return self.__class__(super().__add__(self.escape(value)))
 
         return NotImplemented
 
-    def __radd__(self, other: t.Union[str, "HasHTML"]) -> "te.Self":
-        if isinstance(other, str) or hasattr(other, "__html__"):
-            return self.escape(other).__add__(self)
+    def __radd__(self, value: str | _HasHTML, /) -> te.Self:
+        if isinstance(value, str) or hasattr(value, "__html__"):
+            return self.escape(value).__add__(self)
 
         return NotImplemented
 
-    def __mul__(self, num: "te.SupportsIndex") -> "te.Self":
-        if isinstance(num, int):
-            return self.__class__(super().__mul__(num))
+    def __mul__(self, value: t.SupportsIndex, /) -> te.Self:
+        return self.__class__(super().__mul__(value))
 
-        return NotImplemented
+    def __rmul__(self, value: t.SupportsIndex, /) -> te.Self:
+        return self.__class__(super().__mul__(value))
 
-    __rmul__ = __mul__
-
-    def __mod__(self, arg: t.Any) -> "te.Self":
-        if isinstance(arg, tuple):
+    def __mod__(self, value: t.Any, /) -> te.Self:
+        if isinstance(value, tuple):
             # a tuple of arguments, each wrapped
-            arg = tuple(_MarkupEscapeHelper(x, self.escape) for x in arg)
-        elif hasattr(type(arg), "__getitem__") and not isinstance(arg, str):
+            value = tuple(_MarkupEscapeHelper(x, self.escape) for x in value)
+        elif hasattr(type(value), "__getitem__") and not isinstance(value, str):
             # a mapping of arguments, wrapped
-            arg = _MarkupEscapeHelper(arg, self.escape)
+            value = _MarkupEscapeHelper(value, self.escape)
         else:
             # a single argument, wrapped with the helper and a tuple
-            arg = (_MarkupEscapeHelper(arg, self.escape),)
+            value = (_MarkupEscapeHelper(value, self.escape),)
 
-        return self.__class__(super().__mod__(arg))
+        return self.__class__(super().__mod__(value))
 
-    def __repr__(self) -> str:
+    def __repr__(self, /) -> str:
         return f"{self.__class__.__name__}({super().__repr__()})"
 
-    def join(self, seq: t.Iterable[t.Union[str, "HasHTML"]]) -> "te.Self":
-        return self.__class__(super().join(map(self.escape, seq)))
-
-    join.__doc__ = str.join.__doc__
+    def join(self, iterable: cabc.Iterable[str | _HasHTML], /) -> te.Self:
+        return self.__class__(super().join(map(self.escape, iterable)))
 
     def split(  # type: ignore[override]
-        self, sep: t.Optional[str] = None, maxsplit: int = -1
-    ) -> t.List["te.Self"]:
+        self, /, sep: str | None = None, maxsplit: t.SupportsIndex = -1
+    ) -> list[te.Self]:
         return [self.__class__(v) for v in super().split(sep, maxsplit)]
 
-    split.__doc__ = str.split.__doc__
-
     def rsplit(  # type: ignore[override]
-        self, sep: t.Optional[str] = None, maxsplit: int = -1
-    ) -> t.List["te.Self"]:
+        self, /, sep: str | None = None, maxsplit: t.SupportsIndex = -1
+    ) -> list[te.Self]:
         return [self.__class__(v) for v in super().rsplit(sep, maxsplit)]
 
-    rsplit.__doc__ = str.rsplit.__doc__
-
     def splitlines(  # type: ignore[override]
-        self, keepends: bool = False
-    ) -> t.List["te.Self"]:
+        self, /, keepends: bool = False
+    ) -> list[te.Self]:
         return [self.__class__(v) for v in super().splitlines(keepends)]
 
-    splitlines.__doc__ = str.splitlines.__doc__
-
-    def unescape(self) -> str:
+    def unescape(self, /) -> str:
         """Convert escaped markup back into a text string. This replaces
         HTML entities with the characters they represent.
 
@@ -151,7 +196,7 @@ class Markup(str):
 
         return unescape(str(self))
 
-    def striptags(self) -> str:
+    def striptags(self, /) -> str:
         """:meth:`unescape` the markup, remove tags, and normalize
         whitespace to single spaces.
 
@@ -163,31 +208,17 @@ class Markup(str):
         # Look for comments then tags separately. Otherwise, a comment that
         # contains a tag would end early, leaving some of the comment behind.
 
-        while True:
-            # keep finding comment start marks
-            start = value.find("<!--")
-
-            if start == -1:
-                break
-
+        # keep finding comment start marks
+        while (start := value.find("<!--")) != -1:
             # find a comment end mark beyond the start, otherwise stop
-            end = value.find("-->", start)
-
-            if end == -1:
+            if (end := value.find("-->", start)) == -1:
                 break
 
             value = f"{value[:start]}{value[end + 3:]}"
 
         # remove tags using the same method
-        while True:
-            start = value.find("<")
-
-            if start == -1:
-                break
-
-            end = value.find(">", start)
-
-            if end == -1:
+        while (start := value.find("<")) != -1:
+            if (end := value.find(">", start)) == -1:
                 break
 
             value = f"{value[:start]}{value[end + 1:]}"
@@ -197,7 +228,7 @@ class Markup(str):
         return self.__class__(value).unescape()
 
     @classmethod
-    def escape(cls, s: t.Any) -> "te.Self":
+    def escape(cls, s: t.Any, /) -> te.Self:
         """Escape a string. Calls :func:`escape` and ensures that for
         subclasses the correct type is returned.
         """
@@ -208,49 +239,90 @@ class Markup(str):
 
         return rv  # type: ignore[return-value]
 
-    __getitem__ = _simple_escaping_wrapper(str.__getitem__)
-    capitalize = _simple_escaping_wrapper(str.capitalize)
-    title = _simple_escaping_wrapper(str.title)
-    lower = _simple_escaping_wrapper(str.lower)
-    upper = _simple_escaping_wrapper(str.upper)
-    replace = _simple_escaping_wrapper(str.replace)
-    ljust = _simple_escaping_wrapper(str.ljust)
-    rjust = _simple_escaping_wrapper(str.rjust)
-    lstrip = _simple_escaping_wrapper(str.lstrip)
-    rstrip = _simple_escaping_wrapper(str.rstrip)
-    center = _simple_escaping_wrapper(str.center)
-    strip = _simple_escaping_wrapper(str.strip)
-    translate = _simple_escaping_wrapper(str.translate)
-    expandtabs = _simple_escaping_wrapper(str.expandtabs)
-    swapcase = _simple_escaping_wrapper(str.swapcase)
-    zfill = _simple_escaping_wrapper(str.zfill)
-    casefold = _simple_escaping_wrapper(str.casefold)
+    def __getitem__(self, key: t.SupportsIndex | slice, /) -> te.Self:
+        return self.__class__(super().__getitem__(key))
 
-    if sys.version_info >= (3, 9):
-        removeprefix = _simple_escaping_wrapper(str.removeprefix)
-        removesuffix = _simple_escaping_wrapper(str.removesuffix)
+    def capitalize(self, /) -> te.Self:
+        return self.__class__(super().capitalize())
 
-    def partition(self, sep: str) -> t.Tuple["te.Self", "te.Self", "te.Self"]:
-        l, s, r = super().partition(self.escape(sep))
+    def title(self, /) -> te.Self:
+        return self.__class__(super().title())
+
+    def lower(self, /) -> te.Self:
+        return self.__class__(super().lower())
+
+    def upper(self, /) -> te.Self:
+        return self.__class__(super().upper())
+
+    def replace(self, old: str, new: str, count: t.SupportsIndex = -1, /) -> te.Self:
+        return self.__class__(super().replace(old, self.escape(new), count))
+
+    def ljust(self, width: t.SupportsIndex, fillchar: str = " ", /) -> te.Self:
+        return self.__class__(super().ljust(width, self.escape(fillchar)))
+
+    def rjust(self, width: t.SupportsIndex, fillchar: str = " ", /) -> te.Self:
+        return self.__class__(super().rjust(width, self.escape(fillchar)))
+
+    def lstrip(self, chars: str | None = None, /) -> te.Self:
+        return self.__class__(super().lstrip(chars))
+
+    def rstrip(self, chars: str | None = None, /) -> te.Self:
+        return self.__class__(super().rstrip(chars))
+
+    def center(self, width: t.SupportsIndex, fillchar: str = " ", /) -> te.Self:
+        return self.__class__(super().center(width, self.escape(fillchar)))
+
+    def strip(self, chars: str | None = None, /) -> te.Self:
+        return self.__class__(super().strip(chars))
+
+    def translate(
+        self,
+        table: cabc.Mapping[int, str | int | None],  # type: ignore[override]
+        /,
+    ) -> str:
+        return self.__class__(super().translate(table))
+
+    def expandtabs(self, /, tabsize: t.SupportsIndex = 8) -> te.Self:
+        return self.__class__(super().expandtabs(tabsize))
+
+    def swapcase(self, /) -> te.Self:
+        return self.__class__(super().swapcase())
+
+    def zfill(self, width: t.SupportsIndex, /) -> te.Self:
+        return self.__class__(super().zfill(width))
+
+    def casefold(self, /) -> te.Self:
+        return self.__class__(super().casefold())
+
+    def removeprefix(self, prefix: str, /) -> te.Self:
+        return self.__class__(super().removeprefix(prefix))
+
+    def removesuffix(self, suffix: str) -> te.Self:
+        return self.__class__(super().removesuffix(suffix))
+
+    def partition(self, sep: str, /) -> tuple[te.Self, te.Self, te.Self]:
+        left, sep, right = super().partition(sep)
         cls = self.__class__
-        return cls(l), cls(s), cls(r)
+        return cls(left), cls(sep), cls(right)
 
-    def rpartition(self, sep: str) -> t.Tuple["te.Self", "te.Self", "te.Self"]:
-        l, s, r = super().rpartition(self.escape(sep))
+    def rpartition(self, sep: str, /) -> tuple[te.Self, te.Self, te.Self]:
+        left, sep, right = super().rpartition(sep)
         cls = self.__class__
-        return cls(l), cls(s), cls(r)
+        return cls(left), cls(sep), cls(right)
 
-    def format(self, *args: t.Any, **kwargs: t.Any) -> "te.Self":
+    def format(self, *args: t.Any, **kwargs: t.Any) -> te.Self:
         formatter = EscapeFormatter(self.escape)
         return self.__class__(formatter.vformat(self, args, kwargs))
 
-    def format_map(  # type: ignore[override]
-        self, map: t.Mapping[str, t.Any]
-    ) -> "te.Self":
+    def format_map(
+        self,
+        mapping: cabc.Mapping[str, t.Any],  # type: ignore[override]
+        /,
+    ) -> te.Self:
         formatter = EscapeFormatter(self.escape)
-        return self.__class__(formatter.vformat(self, (), map))
+        return self.__class__(formatter.vformat(self, (), mapping))
 
-    def __html_format__(self, format_spec: str) -> "te.Self":
+    def __html_format__(self, format_spec: str, /) -> te.Self:
         if format_spec:
             raise ValueError("Unsupported format specification for Markup.")
 
@@ -260,8 +332,8 @@ class Markup(str):
 class EscapeFormatter(string.Formatter):
     __slots__ = ("escape",)
 
-    def __init__(self, escape: t.Callable[[t.Any], Markup]) -> None:
-        self.escape = escape
+    def __init__(self, escape: _TPEscape) -> None:
+        self.escape: _TPEscape = escape
         super().__init__()
 
     def format_field(self, value: t.Any, format_spec: str) -> str:
@@ -278,55 +350,46 @@ class EscapeFormatter(string.Formatter):
         else:
             # We need to make sure the format spec is str here as
             # otherwise the wrong callback methods are invoked.
-            rv = string.Formatter.format_field(self, value, str(format_spec))
+            rv = super().format_field(value, str(format_spec))
         return str(self.escape(rv))
 
 
-_ListOrDict = t.TypeVar("_ListOrDict", list, dict)
-
-
-def _escape_argspec(
-    obj: _ListOrDict, iterable: t.Iterable[t.Any], escape: t.Callable[[t.Any], Markup]
-) -> _ListOrDict:
-    """Helper for various string-wrapped functions."""
-    for key, value in iterable:
-        if isinstance(value, str) or hasattr(value, "__html__"):
-            obj[key] = escape(value)
-
-    return obj
-
-
 class _MarkupEscapeHelper:
     """Helper for :meth:`Markup.__mod__`."""
 
     __slots__ = ("obj", "escape")
 
-    def __init__(self, obj: t.Any, escape: t.Callable[[t.Any], Markup]) -> None:
-        self.obj = obj
-        self.escape = escape
+    def __init__(self, obj: t.Any, escape: _TPEscape) -> None:
+        self.obj: t.Any = obj
+        self.escape: _TPEscape = escape
 
-    def __getitem__(self, item: t.Any) -> "te.Self":
-        return self.__class__(self.obj[item], self.escape)
+    def __getitem__(self, key: t.Any, /) -> te.Self:
+        return self.__class__(self.obj[key], self.escape)
 
-    def __str__(self) -> str:
+    def __str__(self, /) -> str:
         return str(self.escape(self.obj))
 
-    def __repr__(self) -> str:
+    def __repr__(self, /) -> str:
         return str(self.escape(repr(self.obj)))
 
-    def __int__(self) -> int:
+    def __int__(self, /) -> int:
         return int(self.obj)
 
-    def __float__(self) -> float:
+    def __float__(self, /) -> float:
         return float(self.obj)
 
 
-# circular import
-try:
-    from ._speedups import escape as escape
-    from ._speedups import escape_silent as escape_silent
-    from ._speedups import soft_str as soft_str
-except ImportError:
-    from ._native import escape as escape
-    from ._native import escape_silent as escape_silent  # noqa: F401
-    from ._native import soft_str as soft_str  # noqa: F401
+def __getattr__(name: str) -> t.Any:
+    if name == "__version__":
+        import importlib.metadata
+        import warnings
+
+        warnings.warn(
+            "The '__version__' attribute is deprecated and will be removed in"
+            " MarkupSafe 3.1. Use feature detection, or"
+            ' `importlib.metadata.version("markupsafe")`, instead.',
+            stacklevel=2,
+        )
+        return importlib.metadata.version("markupsafe")
+
+    raise AttributeError(name)
diff --git a/lib/markupsafe/_native.py b/lib/markupsafe/_native.py
index 8117b271..088b3bca 100644
--- a/lib/markupsafe/_native.py
+++ b/lib/markupsafe/_native.py
@@ -1,63 +1,8 @@
-import typing as t
-
-from . import Markup
-
-
-def escape(s: t.Any) -> Markup:
-    """Replace the characters ``&``, ``<``, ``>``, ``'``, and ``"`` in
-    the string with HTML-safe sequences. Use this if you need to display
-    text that might contain such characters in HTML.
-
-    If the object has an ``__html__`` method, it is called and the
-    return value is assumed to already be safe for HTML.
-
-    :param s: An object to be converted to a string and escaped.
-    :return: A :class:`Markup` string with the escaped text.
-    """
-    if hasattr(s, "__html__"):
-        return Markup(s.__html__())
-
-    return Markup(
-        str(s)
-        .replace("&", "&amp;")
+def _escape_inner(s: str, /) -> str:
+    return (
+        s.replace("&", "&amp;")
         .replace(">", "&gt;")
         .replace("<", "&lt;")
         .replace("'", "&#39;")
         .replace('"', "&#34;")
     )
-
-
-def escape_silent(s: t.Optional[t.Any]) -> Markup:
-    """Like :func:`escape` but treats ``None`` as the empty string.
-    Useful with optional values, as otherwise you get the string
-    ``'None'`` when the value is ``None``.
-
-    >>> escape(None)
-    Markup('None')
-    >>> escape_silent(None)
-    Markup('')
-    """
-    if s is None:
-        return Markup()
-
-    return escape(s)
-
-
-def soft_str(s: t.Any) -> str:
-    """Convert an object to a string if it isn't already. This preserves
-    a :class:`Markup` string rather than converting it back to a basic
-    string, so it will still be marked as safe and won't be escaped
-    again.
-
-    >>> value = escape("<User 1>")
-    >>> value
-    Markup('&lt;User 1&gt;')
-    >>> escape(str(value))
-    Markup('&amp;lt;User 1&amp;gt;')
-    >>> escape(soft_str(value))
-    Markup('&lt;User 1&gt;')
-    """
-    if not isinstance(s, str):
-        return str(s)
-
-    return s
diff --git a/lib/markupsafe/_speedups.c b/lib/markupsafe/_speedups.c
index 3c463fb8..09dd57ca 100644
--- a/lib/markupsafe/_speedups.c
+++ b/lib/markupsafe/_speedups.c
@@ -1,22 +1,5 @@
 #include <Python.h>
 
-static PyObject* markup;
-
-static int
-init_constants(void)
-{
-	PyObject *module;
-
-	/* import markup type so that we can mark the return value */
-	module = PyImport_ImportModule("markupsafe");
-	if (!module)
-		return 0;
-	markup = PyObject_GetAttrString(module, "Markup");
-	Py_DECREF(module);
-
-	return 1;
-}
-
 #define GET_DELTA(inp, inp_end, delta) \
 	while (inp < inp_end) { \
 		switch (*inp++) { \
@@ -166,135 +149,29 @@ escape_unicode_kind4(PyUnicodeObject *in)
 }
 
 static PyObject*
-escape_unicode(PyUnicodeObject *in)
+escape_unicode(PyObject *self, PyObject *s)
 {
-	if (PyUnicode_READY(in))
+	if (!PyUnicode_Check(s))
 		return NULL;
 
-	switch (PyUnicode_KIND(in)) {
+    // This check is no longer needed in Python 3.12.
+	if (PyUnicode_READY(s))
+		return NULL;
+
+	switch (PyUnicode_KIND(s)) {
 	case PyUnicode_1BYTE_KIND:
-		return escape_unicode_kind1(in);
+		return escape_unicode_kind1((PyUnicodeObject*) s);
 	case PyUnicode_2BYTE_KIND:
-		return escape_unicode_kind2(in);
+		return escape_unicode_kind2((PyUnicodeObject*) s);
 	case PyUnicode_4BYTE_KIND:
-		return escape_unicode_kind4(in);
+		return escape_unicode_kind4((PyUnicodeObject*) s);
 	}
 	assert(0);  /* shouldn't happen */
 	return NULL;
 }
 
-static PyObject*
-escape(PyObject *self, PyObject *text)
-{
-	static PyObject *id_html;
-	PyObject *s = NULL, *rv = NULL, *html;
-
-	if (id_html == NULL) {
-		id_html = PyUnicode_InternFromString("__html__");
-		if (id_html == NULL) {
-			return NULL;
-		}
-	}
-
-	/* we don't have to escape integers, bools or floats */
-	if (PyLong_CheckExact(text) ||
-		PyFloat_CheckExact(text) || PyBool_Check(text) ||
-		text == Py_None)
-		return PyObject_CallFunctionObjArgs(markup, text, NULL);
-
-	/* if the object has an __html__ method that performs the escaping */
-	html = PyObject_GetAttr(text ,id_html);
-	if (html) {
-		s = PyObject_CallObject(html, NULL);
-		Py_DECREF(html);
-		if (s == NULL) {
-			return NULL;
-		}
-		/* Convert to Markup object */
-		rv = PyObject_CallFunctionObjArgs(markup, (PyObject*)s, NULL);
-		Py_DECREF(s);
-		return rv;
-	}
-
-	/* otherwise make the object unicode if it isn't, then escape */
-	PyErr_Clear();
-	if (!PyUnicode_Check(text)) {
-		PyObject *unicode = PyObject_Str(text);
-		if (!unicode)
-			return NULL;
-		s = escape_unicode((PyUnicodeObject*)unicode);
-		Py_DECREF(unicode);
-	}
-	else
-		s = escape_unicode((PyUnicodeObject*)text);
-
-	/* convert the unicode string into a markup object. */
-	rv = PyObject_CallFunctionObjArgs(markup, (PyObject*)s, NULL);
-	Py_DECREF(s);
-	return rv;
-}
-
-
-static PyObject*
-escape_silent(PyObject *self, PyObject *text)
-{
-	if (text != Py_None)
-		return escape(self, text);
-	return PyObject_CallFunctionObjArgs(markup, NULL);
-}
-
-
-static PyObject*
-soft_str(PyObject *self, PyObject *s)
-{
-	if (!PyUnicode_Check(s))
-		return PyObject_Str(s);
-	Py_INCREF(s);
-	return s;
-}
-
-
 static PyMethodDef module_methods[] = {
-	{
-		"escape",
-		(PyCFunction)escape,
-		METH_O,
-		"Replace the characters ``&``, ``<``, ``>``, ``'``, and ``\"`` in"
-		" the string with HTML-safe sequences. Use this if you need to display"
-		" text that might contain such characters in HTML.\n\n"
-		"If the object has an ``__html__`` method, it is called and the"
-		" return value is assumed to already be safe for HTML.\n\n"
-		":param s: An object to be converted to a string and escaped.\n"
-		":return: A :class:`Markup` string with the escaped text.\n"
-	},
-	{
-		"escape_silent",
-		(PyCFunction)escape_silent,
-		METH_O,
-		"Like :func:`escape` but treats ``None`` as the empty string."
-		" Useful with optional values, as otherwise you get the string"
-		" ``'None'`` when the value is ``None``.\n\n"
-		">>> escape(None)\n"
-		"Markup('None')\n"
-		">>> escape_silent(None)\n"
-		"Markup('')\n"
-	},
-	{
-		"soft_str",
-		(PyCFunction)soft_str,
-		METH_O,
-		"Convert an object to a string if it isn't already. This preserves"
-		" a :class:`Markup` string rather than converting it back to a basic"
-		" string, so it will still be marked as safe and won't be escaped"
-		" again.\n\n"
-		">>> value = escape(\"<User 1>\")\n"
-		">>> value\n"
-		"Markup('&lt;User 1&gt;')\n"
-		">>> escape(str(value))\n"
-		"Markup('&amp;lt;User 1&amp;gt;')\n"
-		">>> escape(soft_str(value))\n"
-		"Markup('&lt;User 1&gt;')\n"
-	},
+	{"_escape_inner", (PyCFunction)escape_unicode, METH_O, NULL},
 	{NULL, NULL, 0, NULL}  /* Sentinel */
 };
 
@@ -313,8 +190,15 @@ static struct PyModuleDef module_definition = {
 PyMODINIT_FUNC
 PyInit__speedups(void)
 {
-	if (!init_constants())
-		return NULL;
+	PyObject *m = PyModule_Create(&module_definition);
 
-	return PyModule_Create(&module_definition);
+	if (m == NULL) {
+		return NULL;
+	}
+
+	#ifdef Py_GIL_DISABLED
+	PyUnstable_Module_SetGIL(m, Py_MOD_GIL_NOT_USED);
+	#endif
+
+	return m;
 }
diff --git a/lib/markupsafe/_speedups.pyi b/lib/markupsafe/_speedups.pyi
index f673240f..8c888585 100644
--- a/lib/markupsafe/_speedups.pyi
+++ b/lib/markupsafe/_speedups.pyi
@@ -1,9 +1 @@
-from typing import Any
-from typing import Optional
-
-from . import Markup
-
-def escape(s: Any) -> Markup: ...
-def escape_silent(s: Optional[Any]) -> Markup: ...
-def soft_str(s: Any) -> str: ...
-def soft_unicode(s: Any) -> str: ...
+def _escape_inner(s: str, /) -> str: ...
diff --git a/requirements.txt b/requirements.txt
index 92f7474e..ae5649d4 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -20,7 +20,7 @@ importlib-metadata==8.5.0
 importlib-resources==6.4.5
 git+https://github.com/Tautulli/ipwhois.git@master#egg=ipwhois
 IPy==1.01
-Mako==1.3.5
+Mako==1.3.6
 MarkupSafe==2.1.5
 musicbrainzngs==0.7.1
 packaging==24.1

From d9a87f9726f8d717e174343915610a56291e399d Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 16 Nov 2024 14:52:11 -0800
Subject: [PATCH 675/743] Bump packaging from 24.1 to 24.2 (#2428)

* Bump packaging from 24.1 to 24.2

Bumps [packaging](https://github.com/pypa/packaging) from 24.1 to 24.2.
- [Release notes](https://github.com/pypa/packaging/releases)
- [Changelog](https://github.com/pypa/packaging/blob/main/CHANGELOG.rst)
- [Commits](https://github.com/pypa/packaging/compare/24.1...24.2)

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

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

* Update packaging==24.2

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/packaging/__init__.py          |   4 +-
 lib/packaging/_elffile.py          |   8 +-
 lib/packaging/_manylinux.py        |   1 +
 lib/packaging/licenses/__init__.py | 145 ++++++
 lib/packaging/licenses/_spdx.py    | 759 +++++++++++++++++++++++++++++
 lib/packaging/markers.py           |  24 +-
 lib/packaging/metadata.py          | 107 +++-
 lib/packaging/specifiers.py        |  27 +-
 lib/packaging/tags.py              | 107 ++--
 lib/packaging/utils.py             |  85 ++--
 lib/packaging/version.py           |  33 +-
 requirements.txt                   |   2 +-
 12 files changed, 1170 insertions(+), 132 deletions(-)
 create mode 100644 lib/packaging/licenses/__init__.py
 create mode 100644 lib/packaging/licenses/_spdx.py

diff --git a/lib/packaging/__init__.py b/lib/packaging/__init__.py
index 9ba41d83..d79f73c5 100644
--- a/lib/packaging/__init__.py
+++ b/lib/packaging/__init__.py
@@ -6,10 +6,10 @@ __title__ = "packaging"
 __summary__ = "Core utilities for Python packages"
 __uri__ = "https://github.com/pypa/packaging"
 
-__version__ = "24.1"
+__version__ = "24.2"
 
 __author__ = "Donald Stufft and individual contributors"
 __email__ = "donald@stufft.io"
 
 __license__ = "BSD-2-Clause or Apache-2.0"
-__copyright__ = "2014 %s" % __author__
+__copyright__ = f"2014 {__author__}"
diff --git a/lib/packaging/_elffile.py b/lib/packaging/_elffile.py
index f7a02180..25f4282c 100644
--- a/lib/packaging/_elffile.py
+++ b/lib/packaging/_elffile.py
@@ -48,8 +48,8 @@ class ELFFile:
 
         try:
             ident = self._read("16B")
-        except struct.error:
-            raise ELFInvalid("unable to parse identification")
+        except struct.error as e:
+            raise ELFInvalid("unable to parse identification") from e
         magic = bytes(ident[:4])
         if magic != b"\x7fELF":
             raise ELFInvalid(f"invalid magic: {magic!r}")
@@ -67,11 +67,11 @@ class ELFFile:
                 (2, 1): ("<HHIQQQIHHH", "<IIQQQQQQ", (0, 2, 5)),  # 64-bit LSB.
                 (2, 2): (">HHIQQQIHHH", ">IIQQQQQQ", (0, 2, 5)),  # 64-bit MSB.
             }[(self.capacity, self.encoding)]
-        except KeyError:
+        except KeyError as e:
             raise ELFInvalid(
                 f"unrecognized capacity ({self.capacity}) or "
                 f"encoding ({self.encoding})"
-            )
+            ) from e
 
         try:
             (
diff --git a/lib/packaging/_manylinux.py b/lib/packaging/_manylinux.py
index 08f651fb..61339a6f 100644
--- a/lib/packaging/_manylinux.py
+++ b/lib/packaging/_manylinux.py
@@ -164,6 +164,7 @@ def _parse_glibc_version(version_str: str) -> tuple[int, int]:
             f"Expected glibc version with 2 components major.minor,"
             f" got: {version_str}",
             RuntimeWarning,
+            stacklevel=2,
         )
         return -1, -1
     return int(m.group("major")), int(m.group("minor"))
diff --git a/lib/packaging/licenses/__init__.py b/lib/packaging/licenses/__init__.py
new file mode 100644
index 00000000..569156d6
--- /dev/null
+++ b/lib/packaging/licenses/__init__.py
@@ -0,0 +1,145 @@
+#######################################################################################
+#
+# Adapted from:
+#  https://github.com/pypa/hatch/blob/5352e44/backend/src/hatchling/licenses/parse.py
+#
+# MIT License
+#
+# Copyright (c) 2017-present Ofek Lev <oss@ofek.dev>
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy of this
+# software and associated documentation files (the "Software"), to deal in the Software
+# without restriction, including without limitation the rights to use, copy, modify,
+# merge, publish, distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to the following
+# conditions:
+#
+# The above copyright notice and this permission notice shall be included in all copies
+# or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
+# INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
+# PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+# HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF
+# CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE
+# OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+#
+#
+# With additional allowance of arbitrary `LicenseRef-` identifiers, not just
+# `LicenseRef-Public-Domain` and `LicenseRef-Proprietary`.
+#
+#######################################################################################
+from __future__ import annotations
+
+import re
+from typing import NewType, cast
+
+from packaging.licenses._spdx import EXCEPTIONS, LICENSES
+
+__all__ = [
+    "NormalizedLicenseExpression",
+    "InvalidLicenseExpression",
+    "canonicalize_license_expression",
+]
+
+license_ref_allowed = re.compile("^[A-Za-z0-9.-]*$")
+
+NormalizedLicenseExpression = NewType("NormalizedLicenseExpression", str)
+
+
+class InvalidLicenseExpression(ValueError):
+    """Raised when a license-expression string is invalid
+
+    >>> canonicalize_license_expression("invalid")
+    Traceback (most recent call last):
+        ...
+    packaging.licenses.InvalidLicenseExpression: Invalid license expression: 'invalid'
+    """
+
+
+def canonicalize_license_expression(
+    raw_license_expression: str,
+) -> NormalizedLicenseExpression:
+    if not raw_license_expression:
+        message = f"Invalid license expression: {raw_license_expression!r}"
+        raise InvalidLicenseExpression(message)
+
+    # Pad any parentheses so tokenization can be achieved by merely splitting on
+    # whitespace.
+    license_expression = raw_license_expression.replace("(", " ( ").replace(")", " ) ")
+    licenseref_prefix = "LicenseRef-"
+    license_refs = {
+        ref.lower(): "LicenseRef-" + ref[len(licenseref_prefix) :]
+        for ref in license_expression.split()
+        if ref.lower().startswith(licenseref_prefix.lower())
+    }
+
+    # Normalize to lower case so we can look up licenses/exceptions
+    # and so boolean operators are Python-compatible.
+    license_expression = license_expression.lower()
+
+    tokens = license_expression.split()
+
+    # Rather than implementing boolean logic, we create an expression that Python can
+    # parse. Everything that is not involved with the grammar itself is treated as
+    # `False` and the expression should evaluate as such.
+    python_tokens = []
+    for token in tokens:
+        if token not in {"or", "and", "with", "(", ")"}:
+            python_tokens.append("False")
+        elif token == "with":
+            python_tokens.append("or")
+        elif token == "(" and python_tokens and python_tokens[-1] not in {"or", "and"}:
+            message = f"Invalid license expression: {raw_license_expression!r}"
+            raise InvalidLicenseExpression(message)
+        else:
+            python_tokens.append(token)
+
+    python_expression = " ".join(python_tokens)
+    try:
+        invalid = eval(python_expression, globals(), locals())
+    except Exception:
+        invalid = True
+
+    if invalid is not False:
+        message = f"Invalid license expression: {raw_license_expression!r}"
+        raise InvalidLicenseExpression(message) from None
+
+    # Take a final pass to check for unknown licenses/exceptions.
+    normalized_tokens = []
+    for token in tokens:
+        if token in {"or", "and", "with", "(", ")"}:
+            normalized_tokens.append(token.upper())
+            continue
+
+        if normalized_tokens and normalized_tokens[-1] == "WITH":
+            if token not in EXCEPTIONS:
+                message = f"Unknown license exception: {token!r}"
+                raise InvalidLicenseExpression(message)
+
+            normalized_tokens.append(EXCEPTIONS[token]["id"])
+        else:
+            if token.endswith("+"):
+                final_token = token[:-1]
+                suffix = "+"
+            else:
+                final_token = token
+                suffix = ""
+
+            if final_token.startswith("licenseref-"):
+                if not license_ref_allowed.match(final_token):
+                    message = f"Invalid licenseref: {final_token!r}"
+                    raise InvalidLicenseExpression(message)
+                normalized_tokens.append(license_refs[final_token] + suffix)
+            else:
+                if final_token not in LICENSES:
+                    message = f"Unknown license: {final_token!r}"
+                    raise InvalidLicenseExpression(message)
+                normalized_tokens.append(LICENSES[final_token]["id"] + suffix)
+
+    normalized_expression = " ".join(normalized_tokens)
+
+    return cast(
+        NormalizedLicenseExpression,
+        normalized_expression.replace("( ", "(").replace(" )", ")"),
+    )
diff --git a/lib/packaging/licenses/_spdx.py b/lib/packaging/licenses/_spdx.py
new file mode 100644
index 00000000..eac22276
--- /dev/null
+++ b/lib/packaging/licenses/_spdx.py
@@ -0,0 +1,759 @@
+
+from __future__ import annotations
+
+from typing import TypedDict
+
+class SPDXLicense(TypedDict):
+    id: str
+    deprecated: bool
+
+class SPDXException(TypedDict):
+    id: str
+    deprecated: bool
+
+
+VERSION = '3.25.0'
+
+LICENSES: dict[str, SPDXLicense] = {
+    '0bsd': {'id': '0BSD', 'deprecated': False},
+    '3d-slicer-1.0': {'id': '3D-Slicer-1.0', 'deprecated': False},
+    'aal': {'id': 'AAL', 'deprecated': False},
+    'abstyles': {'id': 'Abstyles', 'deprecated': False},
+    'adacore-doc': {'id': 'AdaCore-doc', 'deprecated': False},
+    'adobe-2006': {'id': 'Adobe-2006', 'deprecated': False},
+    'adobe-display-postscript': {'id': 'Adobe-Display-PostScript', 'deprecated': False},
+    'adobe-glyph': {'id': 'Adobe-Glyph', 'deprecated': False},
+    'adobe-utopia': {'id': 'Adobe-Utopia', 'deprecated': False},
+    'adsl': {'id': 'ADSL', 'deprecated': False},
+    'afl-1.1': {'id': 'AFL-1.1', 'deprecated': False},
+    'afl-1.2': {'id': 'AFL-1.2', 'deprecated': False},
+    'afl-2.0': {'id': 'AFL-2.0', 'deprecated': False},
+    'afl-2.1': {'id': 'AFL-2.1', 'deprecated': False},
+    'afl-3.0': {'id': 'AFL-3.0', 'deprecated': False},
+    'afmparse': {'id': 'Afmparse', 'deprecated': False},
+    'agpl-1.0': {'id': 'AGPL-1.0', 'deprecated': True},
+    'agpl-1.0-only': {'id': 'AGPL-1.0-only', 'deprecated': False},
+    'agpl-1.0-or-later': {'id': 'AGPL-1.0-or-later', 'deprecated': False},
+    'agpl-3.0': {'id': 'AGPL-3.0', 'deprecated': True},
+    'agpl-3.0-only': {'id': 'AGPL-3.0-only', 'deprecated': False},
+    'agpl-3.0-or-later': {'id': 'AGPL-3.0-or-later', 'deprecated': False},
+    'aladdin': {'id': 'Aladdin', 'deprecated': False},
+    'amd-newlib': {'id': 'AMD-newlib', 'deprecated': False},
+    'amdplpa': {'id': 'AMDPLPA', 'deprecated': False},
+    'aml': {'id': 'AML', 'deprecated': False},
+    'aml-glslang': {'id': 'AML-glslang', 'deprecated': False},
+    'ampas': {'id': 'AMPAS', 'deprecated': False},
+    'antlr-pd': {'id': 'ANTLR-PD', 'deprecated': False},
+    'antlr-pd-fallback': {'id': 'ANTLR-PD-fallback', 'deprecated': False},
+    'any-osi': {'id': 'any-OSI', 'deprecated': False},
+    'apache-1.0': {'id': 'Apache-1.0', 'deprecated': False},
+    'apache-1.1': {'id': 'Apache-1.1', 'deprecated': False},
+    'apache-2.0': {'id': 'Apache-2.0', 'deprecated': False},
+    'apafml': {'id': 'APAFML', 'deprecated': False},
+    'apl-1.0': {'id': 'APL-1.0', 'deprecated': False},
+    'app-s2p': {'id': 'App-s2p', 'deprecated': False},
+    'apsl-1.0': {'id': 'APSL-1.0', 'deprecated': False},
+    'apsl-1.1': {'id': 'APSL-1.1', 'deprecated': False},
+    'apsl-1.2': {'id': 'APSL-1.2', 'deprecated': False},
+    'apsl-2.0': {'id': 'APSL-2.0', 'deprecated': False},
+    'arphic-1999': {'id': 'Arphic-1999', 'deprecated': False},
+    'artistic-1.0': {'id': 'Artistic-1.0', 'deprecated': False},
+    'artistic-1.0-cl8': {'id': 'Artistic-1.0-cl8', 'deprecated': False},
+    'artistic-1.0-perl': {'id': 'Artistic-1.0-Perl', 'deprecated': False},
+    'artistic-2.0': {'id': 'Artistic-2.0', 'deprecated': False},
+    'aswf-digital-assets-1.0': {'id': 'ASWF-Digital-Assets-1.0', 'deprecated': False},
+    'aswf-digital-assets-1.1': {'id': 'ASWF-Digital-Assets-1.1', 'deprecated': False},
+    'baekmuk': {'id': 'Baekmuk', 'deprecated': False},
+    'bahyph': {'id': 'Bahyph', 'deprecated': False},
+    'barr': {'id': 'Barr', 'deprecated': False},
+    'bcrypt-solar-designer': {'id': 'bcrypt-Solar-Designer', 'deprecated': False},
+    'beerware': {'id': 'Beerware', 'deprecated': False},
+    'bitstream-charter': {'id': 'Bitstream-Charter', 'deprecated': False},
+    'bitstream-vera': {'id': 'Bitstream-Vera', 'deprecated': False},
+    'bittorrent-1.0': {'id': 'BitTorrent-1.0', 'deprecated': False},
+    'bittorrent-1.1': {'id': 'BitTorrent-1.1', 'deprecated': False},
+    'blessing': {'id': 'blessing', 'deprecated': False},
+    'blueoak-1.0.0': {'id': 'BlueOak-1.0.0', 'deprecated': False},
+    'boehm-gc': {'id': 'Boehm-GC', 'deprecated': False},
+    'borceux': {'id': 'Borceux', 'deprecated': False},
+    'brian-gladman-2-clause': {'id': 'Brian-Gladman-2-Clause', 'deprecated': False},
+    'brian-gladman-3-clause': {'id': 'Brian-Gladman-3-Clause', 'deprecated': False},
+    'bsd-1-clause': {'id': 'BSD-1-Clause', 'deprecated': False},
+    'bsd-2-clause': {'id': 'BSD-2-Clause', 'deprecated': False},
+    'bsd-2-clause-darwin': {'id': 'BSD-2-Clause-Darwin', 'deprecated': False},
+    'bsd-2-clause-first-lines': {'id': 'BSD-2-Clause-first-lines', 'deprecated': False},
+    'bsd-2-clause-freebsd': {'id': 'BSD-2-Clause-FreeBSD', 'deprecated': True},
+    'bsd-2-clause-netbsd': {'id': 'BSD-2-Clause-NetBSD', 'deprecated': True},
+    'bsd-2-clause-patent': {'id': 'BSD-2-Clause-Patent', 'deprecated': False},
+    'bsd-2-clause-views': {'id': 'BSD-2-Clause-Views', 'deprecated': False},
+    'bsd-3-clause': {'id': 'BSD-3-Clause', 'deprecated': False},
+    'bsd-3-clause-acpica': {'id': 'BSD-3-Clause-acpica', 'deprecated': False},
+    'bsd-3-clause-attribution': {'id': 'BSD-3-Clause-Attribution', 'deprecated': False},
+    'bsd-3-clause-clear': {'id': 'BSD-3-Clause-Clear', 'deprecated': False},
+    'bsd-3-clause-flex': {'id': 'BSD-3-Clause-flex', 'deprecated': False},
+    'bsd-3-clause-hp': {'id': 'BSD-3-Clause-HP', 'deprecated': False},
+    'bsd-3-clause-lbnl': {'id': 'BSD-3-Clause-LBNL', 'deprecated': False},
+    'bsd-3-clause-modification': {'id': 'BSD-3-Clause-Modification', 'deprecated': False},
+    'bsd-3-clause-no-military-license': {'id': 'BSD-3-Clause-No-Military-License', 'deprecated': False},
+    'bsd-3-clause-no-nuclear-license': {'id': 'BSD-3-Clause-No-Nuclear-License', 'deprecated': False},
+    'bsd-3-clause-no-nuclear-license-2014': {'id': 'BSD-3-Clause-No-Nuclear-License-2014', 'deprecated': False},
+    'bsd-3-clause-no-nuclear-warranty': {'id': 'BSD-3-Clause-No-Nuclear-Warranty', 'deprecated': False},
+    'bsd-3-clause-open-mpi': {'id': 'BSD-3-Clause-Open-MPI', 'deprecated': False},
+    'bsd-3-clause-sun': {'id': 'BSD-3-Clause-Sun', 'deprecated': False},
+    'bsd-4-clause': {'id': 'BSD-4-Clause', 'deprecated': False},
+    'bsd-4-clause-shortened': {'id': 'BSD-4-Clause-Shortened', 'deprecated': False},
+    'bsd-4-clause-uc': {'id': 'BSD-4-Clause-UC', 'deprecated': False},
+    'bsd-4.3reno': {'id': 'BSD-4.3RENO', 'deprecated': False},
+    'bsd-4.3tahoe': {'id': 'BSD-4.3TAHOE', 'deprecated': False},
+    'bsd-advertising-acknowledgement': {'id': 'BSD-Advertising-Acknowledgement', 'deprecated': False},
+    'bsd-attribution-hpnd-disclaimer': {'id': 'BSD-Attribution-HPND-disclaimer', 'deprecated': False},
+    'bsd-inferno-nettverk': {'id': 'BSD-Inferno-Nettverk', 'deprecated': False},
+    'bsd-protection': {'id': 'BSD-Protection', 'deprecated': False},
+    'bsd-source-beginning-file': {'id': 'BSD-Source-beginning-file', 'deprecated': False},
+    'bsd-source-code': {'id': 'BSD-Source-Code', 'deprecated': False},
+    'bsd-systemics': {'id': 'BSD-Systemics', 'deprecated': False},
+    'bsd-systemics-w3works': {'id': 'BSD-Systemics-W3Works', 'deprecated': False},
+    'bsl-1.0': {'id': 'BSL-1.0', 'deprecated': False},
+    'busl-1.1': {'id': 'BUSL-1.1', 'deprecated': False},
+    'bzip2-1.0.5': {'id': 'bzip2-1.0.5', 'deprecated': True},
+    'bzip2-1.0.6': {'id': 'bzip2-1.0.6', 'deprecated': False},
+    'c-uda-1.0': {'id': 'C-UDA-1.0', 'deprecated': False},
+    'cal-1.0': {'id': 'CAL-1.0', 'deprecated': False},
+    'cal-1.0-combined-work-exception': {'id': 'CAL-1.0-Combined-Work-Exception', 'deprecated': False},
+    'caldera': {'id': 'Caldera', 'deprecated': False},
+    'caldera-no-preamble': {'id': 'Caldera-no-preamble', 'deprecated': False},
+    'catharon': {'id': 'Catharon', 'deprecated': False},
+    'catosl-1.1': {'id': 'CATOSL-1.1', 'deprecated': False},
+    'cc-by-1.0': {'id': 'CC-BY-1.0', 'deprecated': False},
+    'cc-by-2.0': {'id': 'CC-BY-2.0', 'deprecated': False},
+    'cc-by-2.5': {'id': 'CC-BY-2.5', 'deprecated': False},
+    'cc-by-2.5-au': {'id': 'CC-BY-2.5-AU', 'deprecated': False},
+    'cc-by-3.0': {'id': 'CC-BY-3.0', 'deprecated': False},
+    'cc-by-3.0-at': {'id': 'CC-BY-3.0-AT', 'deprecated': False},
+    'cc-by-3.0-au': {'id': 'CC-BY-3.0-AU', 'deprecated': False},
+    'cc-by-3.0-de': {'id': 'CC-BY-3.0-DE', 'deprecated': False},
+    'cc-by-3.0-igo': {'id': 'CC-BY-3.0-IGO', 'deprecated': False},
+    'cc-by-3.0-nl': {'id': 'CC-BY-3.0-NL', 'deprecated': False},
+    'cc-by-3.0-us': {'id': 'CC-BY-3.0-US', 'deprecated': False},
+    'cc-by-4.0': {'id': 'CC-BY-4.0', 'deprecated': False},
+    'cc-by-nc-1.0': {'id': 'CC-BY-NC-1.0', 'deprecated': False},
+    'cc-by-nc-2.0': {'id': 'CC-BY-NC-2.0', 'deprecated': False},
+    'cc-by-nc-2.5': {'id': 'CC-BY-NC-2.5', 'deprecated': False},
+    'cc-by-nc-3.0': {'id': 'CC-BY-NC-3.0', 'deprecated': False},
+    'cc-by-nc-3.0-de': {'id': 'CC-BY-NC-3.0-DE', 'deprecated': False},
+    'cc-by-nc-4.0': {'id': 'CC-BY-NC-4.0', 'deprecated': False},
+    'cc-by-nc-nd-1.0': {'id': 'CC-BY-NC-ND-1.0', 'deprecated': False},
+    'cc-by-nc-nd-2.0': {'id': 'CC-BY-NC-ND-2.0', 'deprecated': False},
+    'cc-by-nc-nd-2.5': {'id': 'CC-BY-NC-ND-2.5', 'deprecated': False},
+    'cc-by-nc-nd-3.0': {'id': 'CC-BY-NC-ND-3.0', 'deprecated': False},
+    'cc-by-nc-nd-3.0-de': {'id': 'CC-BY-NC-ND-3.0-DE', 'deprecated': False},
+    'cc-by-nc-nd-3.0-igo': {'id': 'CC-BY-NC-ND-3.0-IGO', 'deprecated': False},
+    'cc-by-nc-nd-4.0': {'id': 'CC-BY-NC-ND-4.0', 'deprecated': False},
+    'cc-by-nc-sa-1.0': {'id': 'CC-BY-NC-SA-1.0', 'deprecated': False},
+    'cc-by-nc-sa-2.0': {'id': 'CC-BY-NC-SA-2.0', 'deprecated': False},
+    'cc-by-nc-sa-2.0-de': {'id': 'CC-BY-NC-SA-2.0-DE', 'deprecated': False},
+    'cc-by-nc-sa-2.0-fr': {'id': 'CC-BY-NC-SA-2.0-FR', 'deprecated': False},
+    'cc-by-nc-sa-2.0-uk': {'id': 'CC-BY-NC-SA-2.0-UK', 'deprecated': False},
+    'cc-by-nc-sa-2.5': {'id': 'CC-BY-NC-SA-2.5', 'deprecated': False},
+    'cc-by-nc-sa-3.0': {'id': 'CC-BY-NC-SA-3.0', 'deprecated': False},
+    'cc-by-nc-sa-3.0-de': {'id': 'CC-BY-NC-SA-3.0-DE', 'deprecated': False},
+    'cc-by-nc-sa-3.0-igo': {'id': 'CC-BY-NC-SA-3.0-IGO', 'deprecated': False},
+    'cc-by-nc-sa-4.0': {'id': 'CC-BY-NC-SA-4.0', 'deprecated': False},
+    'cc-by-nd-1.0': {'id': 'CC-BY-ND-1.0', 'deprecated': False},
+    'cc-by-nd-2.0': {'id': 'CC-BY-ND-2.0', 'deprecated': False},
+    'cc-by-nd-2.5': {'id': 'CC-BY-ND-2.5', 'deprecated': False},
+    'cc-by-nd-3.0': {'id': 'CC-BY-ND-3.0', 'deprecated': False},
+    'cc-by-nd-3.0-de': {'id': 'CC-BY-ND-3.0-DE', 'deprecated': False},
+    'cc-by-nd-4.0': {'id': 'CC-BY-ND-4.0', 'deprecated': False},
+    'cc-by-sa-1.0': {'id': 'CC-BY-SA-1.0', 'deprecated': False},
+    'cc-by-sa-2.0': {'id': 'CC-BY-SA-2.0', 'deprecated': False},
+    'cc-by-sa-2.0-uk': {'id': 'CC-BY-SA-2.0-UK', 'deprecated': False},
+    'cc-by-sa-2.1-jp': {'id': 'CC-BY-SA-2.1-JP', 'deprecated': False},
+    'cc-by-sa-2.5': {'id': 'CC-BY-SA-2.5', 'deprecated': False},
+    'cc-by-sa-3.0': {'id': 'CC-BY-SA-3.0', 'deprecated': False},
+    'cc-by-sa-3.0-at': {'id': 'CC-BY-SA-3.0-AT', 'deprecated': False},
+    'cc-by-sa-3.0-de': {'id': 'CC-BY-SA-3.0-DE', 'deprecated': False},
+    'cc-by-sa-3.0-igo': {'id': 'CC-BY-SA-3.0-IGO', 'deprecated': False},
+    'cc-by-sa-4.0': {'id': 'CC-BY-SA-4.0', 'deprecated': False},
+    'cc-pddc': {'id': 'CC-PDDC', 'deprecated': False},
+    'cc0-1.0': {'id': 'CC0-1.0', 'deprecated': False},
+    'cddl-1.0': {'id': 'CDDL-1.0', 'deprecated': False},
+    'cddl-1.1': {'id': 'CDDL-1.1', 'deprecated': False},
+    'cdl-1.0': {'id': 'CDL-1.0', 'deprecated': False},
+    'cdla-permissive-1.0': {'id': 'CDLA-Permissive-1.0', 'deprecated': False},
+    'cdla-permissive-2.0': {'id': 'CDLA-Permissive-2.0', 'deprecated': False},
+    'cdla-sharing-1.0': {'id': 'CDLA-Sharing-1.0', 'deprecated': False},
+    'cecill-1.0': {'id': 'CECILL-1.0', 'deprecated': False},
+    'cecill-1.1': {'id': 'CECILL-1.1', 'deprecated': False},
+    'cecill-2.0': {'id': 'CECILL-2.0', 'deprecated': False},
+    'cecill-2.1': {'id': 'CECILL-2.1', 'deprecated': False},
+    'cecill-b': {'id': 'CECILL-B', 'deprecated': False},
+    'cecill-c': {'id': 'CECILL-C', 'deprecated': False},
+    'cern-ohl-1.1': {'id': 'CERN-OHL-1.1', 'deprecated': False},
+    'cern-ohl-1.2': {'id': 'CERN-OHL-1.2', 'deprecated': False},
+    'cern-ohl-p-2.0': {'id': 'CERN-OHL-P-2.0', 'deprecated': False},
+    'cern-ohl-s-2.0': {'id': 'CERN-OHL-S-2.0', 'deprecated': False},
+    'cern-ohl-w-2.0': {'id': 'CERN-OHL-W-2.0', 'deprecated': False},
+    'cfitsio': {'id': 'CFITSIO', 'deprecated': False},
+    'check-cvs': {'id': 'check-cvs', 'deprecated': False},
+    'checkmk': {'id': 'checkmk', 'deprecated': False},
+    'clartistic': {'id': 'ClArtistic', 'deprecated': False},
+    'clips': {'id': 'Clips', 'deprecated': False},
+    'cmu-mach': {'id': 'CMU-Mach', 'deprecated': False},
+    'cmu-mach-nodoc': {'id': 'CMU-Mach-nodoc', 'deprecated': False},
+    'cnri-jython': {'id': 'CNRI-Jython', 'deprecated': False},
+    'cnri-python': {'id': 'CNRI-Python', 'deprecated': False},
+    'cnri-python-gpl-compatible': {'id': 'CNRI-Python-GPL-Compatible', 'deprecated': False},
+    'coil-1.0': {'id': 'COIL-1.0', 'deprecated': False},
+    'community-spec-1.0': {'id': 'Community-Spec-1.0', 'deprecated': False},
+    'condor-1.1': {'id': 'Condor-1.1', 'deprecated': False},
+    'copyleft-next-0.3.0': {'id': 'copyleft-next-0.3.0', 'deprecated': False},
+    'copyleft-next-0.3.1': {'id': 'copyleft-next-0.3.1', 'deprecated': False},
+    'cornell-lossless-jpeg': {'id': 'Cornell-Lossless-JPEG', 'deprecated': False},
+    'cpal-1.0': {'id': 'CPAL-1.0', 'deprecated': False},
+    'cpl-1.0': {'id': 'CPL-1.0', 'deprecated': False},
+    'cpol-1.02': {'id': 'CPOL-1.02', 'deprecated': False},
+    'cronyx': {'id': 'Cronyx', 'deprecated': False},
+    'crossword': {'id': 'Crossword', 'deprecated': False},
+    'crystalstacker': {'id': 'CrystalStacker', 'deprecated': False},
+    'cua-opl-1.0': {'id': 'CUA-OPL-1.0', 'deprecated': False},
+    'cube': {'id': 'Cube', 'deprecated': False},
+    'curl': {'id': 'curl', 'deprecated': False},
+    'cve-tou': {'id': 'cve-tou', 'deprecated': False},
+    'd-fsl-1.0': {'id': 'D-FSL-1.0', 'deprecated': False},
+    'dec-3-clause': {'id': 'DEC-3-Clause', 'deprecated': False},
+    'diffmark': {'id': 'diffmark', 'deprecated': False},
+    'dl-de-by-2.0': {'id': 'DL-DE-BY-2.0', 'deprecated': False},
+    'dl-de-zero-2.0': {'id': 'DL-DE-ZERO-2.0', 'deprecated': False},
+    'doc': {'id': 'DOC', 'deprecated': False},
+    'docbook-schema': {'id': 'DocBook-Schema', 'deprecated': False},
+    'docbook-xml': {'id': 'DocBook-XML', 'deprecated': False},
+    'dotseqn': {'id': 'Dotseqn', 'deprecated': False},
+    'drl-1.0': {'id': 'DRL-1.0', 'deprecated': False},
+    'drl-1.1': {'id': 'DRL-1.1', 'deprecated': False},
+    'dsdp': {'id': 'DSDP', 'deprecated': False},
+    'dtoa': {'id': 'dtoa', 'deprecated': False},
+    'dvipdfm': {'id': 'dvipdfm', 'deprecated': False},
+    'ecl-1.0': {'id': 'ECL-1.0', 'deprecated': False},
+    'ecl-2.0': {'id': 'ECL-2.0', 'deprecated': False},
+    'ecos-2.0': {'id': 'eCos-2.0', 'deprecated': True},
+    'efl-1.0': {'id': 'EFL-1.0', 'deprecated': False},
+    'efl-2.0': {'id': 'EFL-2.0', 'deprecated': False},
+    'egenix': {'id': 'eGenix', 'deprecated': False},
+    'elastic-2.0': {'id': 'Elastic-2.0', 'deprecated': False},
+    'entessa': {'id': 'Entessa', 'deprecated': False},
+    'epics': {'id': 'EPICS', 'deprecated': False},
+    'epl-1.0': {'id': 'EPL-1.0', 'deprecated': False},
+    'epl-2.0': {'id': 'EPL-2.0', 'deprecated': False},
+    'erlpl-1.1': {'id': 'ErlPL-1.1', 'deprecated': False},
+    'etalab-2.0': {'id': 'etalab-2.0', 'deprecated': False},
+    'eudatagrid': {'id': 'EUDatagrid', 'deprecated': False},
+    'eupl-1.0': {'id': 'EUPL-1.0', 'deprecated': False},
+    'eupl-1.1': {'id': 'EUPL-1.1', 'deprecated': False},
+    'eupl-1.2': {'id': 'EUPL-1.2', 'deprecated': False},
+    'eurosym': {'id': 'Eurosym', 'deprecated': False},
+    'fair': {'id': 'Fair', 'deprecated': False},
+    'fbm': {'id': 'FBM', 'deprecated': False},
+    'fdk-aac': {'id': 'FDK-AAC', 'deprecated': False},
+    'ferguson-twofish': {'id': 'Ferguson-Twofish', 'deprecated': False},
+    'frameworx-1.0': {'id': 'Frameworx-1.0', 'deprecated': False},
+    'freebsd-doc': {'id': 'FreeBSD-DOC', 'deprecated': False},
+    'freeimage': {'id': 'FreeImage', 'deprecated': False},
+    'fsfap': {'id': 'FSFAP', 'deprecated': False},
+    'fsfap-no-warranty-disclaimer': {'id': 'FSFAP-no-warranty-disclaimer', 'deprecated': False},
+    'fsful': {'id': 'FSFUL', 'deprecated': False},
+    'fsfullr': {'id': 'FSFULLR', 'deprecated': False},
+    'fsfullrwd': {'id': 'FSFULLRWD', 'deprecated': False},
+    'ftl': {'id': 'FTL', 'deprecated': False},
+    'furuseth': {'id': 'Furuseth', 'deprecated': False},
+    'fwlw': {'id': 'fwlw', 'deprecated': False},
+    'gcr-docs': {'id': 'GCR-docs', 'deprecated': False},
+    'gd': {'id': 'GD', 'deprecated': False},
+    'gfdl-1.1': {'id': 'GFDL-1.1', 'deprecated': True},
+    'gfdl-1.1-invariants-only': {'id': 'GFDL-1.1-invariants-only', 'deprecated': False},
+    'gfdl-1.1-invariants-or-later': {'id': 'GFDL-1.1-invariants-or-later', 'deprecated': False},
+    'gfdl-1.1-no-invariants-only': {'id': 'GFDL-1.1-no-invariants-only', 'deprecated': False},
+    'gfdl-1.1-no-invariants-or-later': {'id': 'GFDL-1.1-no-invariants-or-later', 'deprecated': False},
+    'gfdl-1.1-only': {'id': 'GFDL-1.1-only', 'deprecated': False},
+    'gfdl-1.1-or-later': {'id': 'GFDL-1.1-or-later', 'deprecated': False},
+    'gfdl-1.2': {'id': 'GFDL-1.2', 'deprecated': True},
+    'gfdl-1.2-invariants-only': {'id': 'GFDL-1.2-invariants-only', 'deprecated': False},
+    'gfdl-1.2-invariants-or-later': {'id': 'GFDL-1.2-invariants-or-later', 'deprecated': False},
+    'gfdl-1.2-no-invariants-only': {'id': 'GFDL-1.2-no-invariants-only', 'deprecated': False},
+    'gfdl-1.2-no-invariants-or-later': {'id': 'GFDL-1.2-no-invariants-or-later', 'deprecated': False},
+    'gfdl-1.2-only': {'id': 'GFDL-1.2-only', 'deprecated': False},
+    'gfdl-1.2-or-later': {'id': 'GFDL-1.2-or-later', 'deprecated': False},
+    'gfdl-1.3': {'id': 'GFDL-1.3', 'deprecated': True},
+    'gfdl-1.3-invariants-only': {'id': 'GFDL-1.3-invariants-only', 'deprecated': False},
+    'gfdl-1.3-invariants-or-later': {'id': 'GFDL-1.3-invariants-or-later', 'deprecated': False},
+    'gfdl-1.3-no-invariants-only': {'id': 'GFDL-1.3-no-invariants-only', 'deprecated': False},
+    'gfdl-1.3-no-invariants-or-later': {'id': 'GFDL-1.3-no-invariants-or-later', 'deprecated': False},
+    'gfdl-1.3-only': {'id': 'GFDL-1.3-only', 'deprecated': False},
+    'gfdl-1.3-or-later': {'id': 'GFDL-1.3-or-later', 'deprecated': False},
+    'giftware': {'id': 'Giftware', 'deprecated': False},
+    'gl2ps': {'id': 'GL2PS', 'deprecated': False},
+    'glide': {'id': 'Glide', 'deprecated': False},
+    'glulxe': {'id': 'Glulxe', 'deprecated': False},
+    'glwtpl': {'id': 'GLWTPL', 'deprecated': False},
+    'gnuplot': {'id': 'gnuplot', 'deprecated': False},
+    'gpl-1.0': {'id': 'GPL-1.0', 'deprecated': True},
+    'gpl-1.0+': {'id': 'GPL-1.0+', 'deprecated': True},
+    'gpl-1.0-only': {'id': 'GPL-1.0-only', 'deprecated': False},
+    'gpl-1.0-or-later': {'id': 'GPL-1.0-or-later', 'deprecated': False},
+    'gpl-2.0': {'id': 'GPL-2.0', 'deprecated': True},
+    'gpl-2.0+': {'id': 'GPL-2.0+', 'deprecated': True},
+    'gpl-2.0-only': {'id': 'GPL-2.0-only', 'deprecated': False},
+    'gpl-2.0-or-later': {'id': 'GPL-2.0-or-later', 'deprecated': False},
+    'gpl-2.0-with-autoconf-exception': {'id': 'GPL-2.0-with-autoconf-exception', 'deprecated': True},
+    'gpl-2.0-with-bison-exception': {'id': 'GPL-2.0-with-bison-exception', 'deprecated': True},
+    'gpl-2.0-with-classpath-exception': {'id': 'GPL-2.0-with-classpath-exception', 'deprecated': True},
+    'gpl-2.0-with-font-exception': {'id': 'GPL-2.0-with-font-exception', 'deprecated': True},
+    'gpl-2.0-with-gcc-exception': {'id': 'GPL-2.0-with-GCC-exception', 'deprecated': True},
+    'gpl-3.0': {'id': 'GPL-3.0', 'deprecated': True},
+    'gpl-3.0+': {'id': 'GPL-3.0+', 'deprecated': True},
+    'gpl-3.0-only': {'id': 'GPL-3.0-only', 'deprecated': False},
+    'gpl-3.0-or-later': {'id': 'GPL-3.0-or-later', 'deprecated': False},
+    'gpl-3.0-with-autoconf-exception': {'id': 'GPL-3.0-with-autoconf-exception', 'deprecated': True},
+    'gpl-3.0-with-gcc-exception': {'id': 'GPL-3.0-with-GCC-exception', 'deprecated': True},
+    'graphics-gems': {'id': 'Graphics-Gems', 'deprecated': False},
+    'gsoap-1.3b': {'id': 'gSOAP-1.3b', 'deprecated': False},
+    'gtkbook': {'id': 'gtkbook', 'deprecated': False},
+    'gutmann': {'id': 'Gutmann', 'deprecated': False},
+    'haskellreport': {'id': 'HaskellReport', 'deprecated': False},
+    'hdparm': {'id': 'hdparm', 'deprecated': False},
+    'hidapi': {'id': 'HIDAPI', 'deprecated': False},
+    'hippocratic-2.1': {'id': 'Hippocratic-2.1', 'deprecated': False},
+    'hp-1986': {'id': 'HP-1986', 'deprecated': False},
+    'hp-1989': {'id': 'HP-1989', 'deprecated': False},
+    'hpnd': {'id': 'HPND', 'deprecated': False},
+    'hpnd-dec': {'id': 'HPND-DEC', 'deprecated': False},
+    'hpnd-doc': {'id': 'HPND-doc', 'deprecated': False},
+    'hpnd-doc-sell': {'id': 'HPND-doc-sell', 'deprecated': False},
+    'hpnd-export-us': {'id': 'HPND-export-US', 'deprecated': False},
+    'hpnd-export-us-acknowledgement': {'id': 'HPND-export-US-acknowledgement', 'deprecated': False},
+    'hpnd-export-us-modify': {'id': 'HPND-export-US-modify', 'deprecated': False},
+    'hpnd-export2-us': {'id': 'HPND-export2-US', 'deprecated': False},
+    'hpnd-fenneberg-livingston': {'id': 'HPND-Fenneberg-Livingston', 'deprecated': False},
+    'hpnd-inria-imag': {'id': 'HPND-INRIA-IMAG', 'deprecated': False},
+    'hpnd-intel': {'id': 'HPND-Intel', 'deprecated': False},
+    'hpnd-kevlin-henney': {'id': 'HPND-Kevlin-Henney', 'deprecated': False},
+    'hpnd-markus-kuhn': {'id': 'HPND-Markus-Kuhn', 'deprecated': False},
+    'hpnd-merchantability-variant': {'id': 'HPND-merchantability-variant', 'deprecated': False},
+    'hpnd-mit-disclaimer': {'id': 'HPND-MIT-disclaimer', 'deprecated': False},
+    'hpnd-netrek': {'id': 'HPND-Netrek', 'deprecated': False},
+    'hpnd-pbmplus': {'id': 'HPND-Pbmplus', 'deprecated': False},
+    'hpnd-sell-mit-disclaimer-xserver': {'id': 'HPND-sell-MIT-disclaimer-xserver', 'deprecated': False},
+    'hpnd-sell-regexpr': {'id': 'HPND-sell-regexpr', 'deprecated': False},
+    'hpnd-sell-variant': {'id': 'HPND-sell-variant', 'deprecated': False},
+    'hpnd-sell-variant-mit-disclaimer': {'id': 'HPND-sell-variant-MIT-disclaimer', 'deprecated': False},
+    'hpnd-sell-variant-mit-disclaimer-rev': {'id': 'HPND-sell-variant-MIT-disclaimer-rev', 'deprecated': False},
+    'hpnd-uc': {'id': 'HPND-UC', 'deprecated': False},
+    'hpnd-uc-export-us': {'id': 'HPND-UC-export-US', 'deprecated': False},
+    'htmltidy': {'id': 'HTMLTIDY', 'deprecated': False},
+    'ibm-pibs': {'id': 'IBM-pibs', 'deprecated': False},
+    'icu': {'id': 'ICU', 'deprecated': False},
+    'iec-code-components-eula': {'id': 'IEC-Code-Components-EULA', 'deprecated': False},
+    'ijg': {'id': 'IJG', 'deprecated': False},
+    'ijg-short': {'id': 'IJG-short', 'deprecated': False},
+    'imagemagick': {'id': 'ImageMagick', 'deprecated': False},
+    'imatix': {'id': 'iMatix', 'deprecated': False},
+    'imlib2': {'id': 'Imlib2', 'deprecated': False},
+    'info-zip': {'id': 'Info-ZIP', 'deprecated': False},
+    'inner-net-2.0': {'id': 'Inner-Net-2.0', 'deprecated': False},
+    'intel': {'id': 'Intel', 'deprecated': False},
+    'intel-acpi': {'id': 'Intel-ACPI', 'deprecated': False},
+    'interbase-1.0': {'id': 'Interbase-1.0', 'deprecated': False},
+    'ipa': {'id': 'IPA', 'deprecated': False},
+    'ipl-1.0': {'id': 'IPL-1.0', 'deprecated': False},
+    'isc': {'id': 'ISC', 'deprecated': False},
+    'isc-veillard': {'id': 'ISC-Veillard', 'deprecated': False},
+    'jam': {'id': 'Jam', 'deprecated': False},
+    'jasper-2.0': {'id': 'JasPer-2.0', 'deprecated': False},
+    'jpl-image': {'id': 'JPL-image', 'deprecated': False},
+    'jpnic': {'id': 'JPNIC', 'deprecated': False},
+    'json': {'id': 'JSON', 'deprecated': False},
+    'kastrup': {'id': 'Kastrup', 'deprecated': False},
+    'kazlib': {'id': 'Kazlib', 'deprecated': False},
+    'knuth-ctan': {'id': 'Knuth-CTAN', 'deprecated': False},
+    'lal-1.2': {'id': 'LAL-1.2', 'deprecated': False},
+    'lal-1.3': {'id': 'LAL-1.3', 'deprecated': False},
+    'latex2e': {'id': 'Latex2e', 'deprecated': False},
+    'latex2e-translated-notice': {'id': 'Latex2e-translated-notice', 'deprecated': False},
+    'leptonica': {'id': 'Leptonica', 'deprecated': False},
+    'lgpl-2.0': {'id': 'LGPL-2.0', 'deprecated': True},
+    'lgpl-2.0+': {'id': 'LGPL-2.0+', 'deprecated': True},
+    'lgpl-2.0-only': {'id': 'LGPL-2.0-only', 'deprecated': False},
+    'lgpl-2.0-or-later': {'id': 'LGPL-2.0-or-later', 'deprecated': False},
+    'lgpl-2.1': {'id': 'LGPL-2.1', 'deprecated': True},
+    'lgpl-2.1+': {'id': 'LGPL-2.1+', 'deprecated': True},
+    'lgpl-2.1-only': {'id': 'LGPL-2.1-only', 'deprecated': False},
+    'lgpl-2.1-or-later': {'id': 'LGPL-2.1-or-later', 'deprecated': False},
+    'lgpl-3.0': {'id': 'LGPL-3.0', 'deprecated': True},
+    'lgpl-3.0+': {'id': 'LGPL-3.0+', 'deprecated': True},
+    'lgpl-3.0-only': {'id': 'LGPL-3.0-only', 'deprecated': False},
+    'lgpl-3.0-or-later': {'id': 'LGPL-3.0-or-later', 'deprecated': False},
+    'lgpllr': {'id': 'LGPLLR', 'deprecated': False},
+    'libpng': {'id': 'Libpng', 'deprecated': False},
+    'libpng-2.0': {'id': 'libpng-2.0', 'deprecated': False},
+    'libselinux-1.0': {'id': 'libselinux-1.0', 'deprecated': False},
+    'libtiff': {'id': 'libtiff', 'deprecated': False},
+    'libutil-david-nugent': {'id': 'libutil-David-Nugent', 'deprecated': False},
+    'liliq-p-1.1': {'id': 'LiLiQ-P-1.1', 'deprecated': False},
+    'liliq-r-1.1': {'id': 'LiLiQ-R-1.1', 'deprecated': False},
+    'liliq-rplus-1.1': {'id': 'LiLiQ-Rplus-1.1', 'deprecated': False},
+    'linux-man-pages-1-para': {'id': 'Linux-man-pages-1-para', 'deprecated': False},
+    'linux-man-pages-copyleft': {'id': 'Linux-man-pages-copyleft', 'deprecated': False},
+    'linux-man-pages-copyleft-2-para': {'id': 'Linux-man-pages-copyleft-2-para', 'deprecated': False},
+    'linux-man-pages-copyleft-var': {'id': 'Linux-man-pages-copyleft-var', 'deprecated': False},
+    'linux-openib': {'id': 'Linux-OpenIB', 'deprecated': False},
+    'loop': {'id': 'LOOP', 'deprecated': False},
+    'lpd-document': {'id': 'LPD-document', 'deprecated': False},
+    'lpl-1.0': {'id': 'LPL-1.0', 'deprecated': False},
+    'lpl-1.02': {'id': 'LPL-1.02', 'deprecated': False},
+    'lppl-1.0': {'id': 'LPPL-1.0', 'deprecated': False},
+    'lppl-1.1': {'id': 'LPPL-1.1', 'deprecated': False},
+    'lppl-1.2': {'id': 'LPPL-1.2', 'deprecated': False},
+    'lppl-1.3a': {'id': 'LPPL-1.3a', 'deprecated': False},
+    'lppl-1.3c': {'id': 'LPPL-1.3c', 'deprecated': False},
+    'lsof': {'id': 'lsof', 'deprecated': False},
+    'lucida-bitmap-fonts': {'id': 'Lucida-Bitmap-Fonts', 'deprecated': False},
+    'lzma-sdk-9.11-to-9.20': {'id': 'LZMA-SDK-9.11-to-9.20', 'deprecated': False},
+    'lzma-sdk-9.22': {'id': 'LZMA-SDK-9.22', 'deprecated': False},
+    'mackerras-3-clause': {'id': 'Mackerras-3-Clause', 'deprecated': False},
+    'mackerras-3-clause-acknowledgment': {'id': 'Mackerras-3-Clause-acknowledgment', 'deprecated': False},
+    'magaz': {'id': 'magaz', 'deprecated': False},
+    'mailprio': {'id': 'mailprio', 'deprecated': False},
+    'makeindex': {'id': 'MakeIndex', 'deprecated': False},
+    'martin-birgmeier': {'id': 'Martin-Birgmeier', 'deprecated': False},
+    'mcphee-slideshow': {'id': 'McPhee-slideshow', 'deprecated': False},
+    'metamail': {'id': 'metamail', 'deprecated': False},
+    'minpack': {'id': 'Minpack', 'deprecated': False},
+    'miros': {'id': 'MirOS', 'deprecated': False},
+    'mit': {'id': 'MIT', 'deprecated': False},
+    'mit-0': {'id': 'MIT-0', 'deprecated': False},
+    'mit-advertising': {'id': 'MIT-advertising', 'deprecated': False},
+    'mit-cmu': {'id': 'MIT-CMU', 'deprecated': False},
+    'mit-enna': {'id': 'MIT-enna', 'deprecated': False},
+    'mit-feh': {'id': 'MIT-feh', 'deprecated': False},
+    'mit-festival': {'id': 'MIT-Festival', 'deprecated': False},
+    'mit-khronos-old': {'id': 'MIT-Khronos-old', 'deprecated': False},
+    'mit-modern-variant': {'id': 'MIT-Modern-Variant', 'deprecated': False},
+    'mit-open-group': {'id': 'MIT-open-group', 'deprecated': False},
+    'mit-testregex': {'id': 'MIT-testregex', 'deprecated': False},
+    'mit-wu': {'id': 'MIT-Wu', 'deprecated': False},
+    'mitnfa': {'id': 'MITNFA', 'deprecated': False},
+    'mmixware': {'id': 'MMIXware', 'deprecated': False},
+    'motosoto': {'id': 'Motosoto', 'deprecated': False},
+    'mpeg-ssg': {'id': 'MPEG-SSG', 'deprecated': False},
+    'mpi-permissive': {'id': 'mpi-permissive', 'deprecated': False},
+    'mpich2': {'id': 'mpich2', 'deprecated': False},
+    'mpl-1.0': {'id': 'MPL-1.0', 'deprecated': False},
+    'mpl-1.1': {'id': 'MPL-1.1', 'deprecated': False},
+    'mpl-2.0': {'id': 'MPL-2.0', 'deprecated': False},
+    'mpl-2.0-no-copyleft-exception': {'id': 'MPL-2.0-no-copyleft-exception', 'deprecated': False},
+    'mplus': {'id': 'mplus', 'deprecated': False},
+    'ms-lpl': {'id': 'MS-LPL', 'deprecated': False},
+    'ms-pl': {'id': 'MS-PL', 'deprecated': False},
+    'ms-rl': {'id': 'MS-RL', 'deprecated': False},
+    'mtll': {'id': 'MTLL', 'deprecated': False},
+    'mulanpsl-1.0': {'id': 'MulanPSL-1.0', 'deprecated': False},
+    'mulanpsl-2.0': {'id': 'MulanPSL-2.0', 'deprecated': False},
+    'multics': {'id': 'Multics', 'deprecated': False},
+    'mup': {'id': 'Mup', 'deprecated': False},
+    'naist-2003': {'id': 'NAIST-2003', 'deprecated': False},
+    'nasa-1.3': {'id': 'NASA-1.3', 'deprecated': False},
+    'naumen': {'id': 'Naumen', 'deprecated': False},
+    'nbpl-1.0': {'id': 'NBPL-1.0', 'deprecated': False},
+    'ncbi-pd': {'id': 'NCBI-PD', 'deprecated': False},
+    'ncgl-uk-2.0': {'id': 'NCGL-UK-2.0', 'deprecated': False},
+    'ncl': {'id': 'NCL', 'deprecated': False},
+    'ncsa': {'id': 'NCSA', 'deprecated': False},
+    'net-snmp': {'id': 'Net-SNMP', 'deprecated': True},
+    'netcdf': {'id': 'NetCDF', 'deprecated': False},
+    'newsletr': {'id': 'Newsletr', 'deprecated': False},
+    'ngpl': {'id': 'NGPL', 'deprecated': False},
+    'nicta-1.0': {'id': 'NICTA-1.0', 'deprecated': False},
+    'nist-pd': {'id': 'NIST-PD', 'deprecated': False},
+    'nist-pd-fallback': {'id': 'NIST-PD-fallback', 'deprecated': False},
+    'nist-software': {'id': 'NIST-Software', 'deprecated': False},
+    'nlod-1.0': {'id': 'NLOD-1.0', 'deprecated': False},
+    'nlod-2.0': {'id': 'NLOD-2.0', 'deprecated': False},
+    'nlpl': {'id': 'NLPL', 'deprecated': False},
+    'nokia': {'id': 'Nokia', 'deprecated': False},
+    'nosl': {'id': 'NOSL', 'deprecated': False},
+    'noweb': {'id': 'Noweb', 'deprecated': False},
+    'npl-1.0': {'id': 'NPL-1.0', 'deprecated': False},
+    'npl-1.1': {'id': 'NPL-1.1', 'deprecated': False},
+    'nposl-3.0': {'id': 'NPOSL-3.0', 'deprecated': False},
+    'nrl': {'id': 'NRL', 'deprecated': False},
+    'ntp': {'id': 'NTP', 'deprecated': False},
+    'ntp-0': {'id': 'NTP-0', 'deprecated': False},
+    'nunit': {'id': 'Nunit', 'deprecated': True},
+    'o-uda-1.0': {'id': 'O-UDA-1.0', 'deprecated': False},
+    'oar': {'id': 'OAR', 'deprecated': False},
+    'occt-pl': {'id': 'OCCT-PL', 'deprecated': False},
+    'oclc-2.0': {'id': 'OCLC-2.0', 'deprecated': False},
+    'odbl-1.0': {'id': 'ODbL-1.0', 'deprecated': False},
+    'odc-by-1.0': {'id': 'ODC-By-1.0', 'deprecated': False},
+    'offis': {'id': 'OFFIS', 'deprecated': False},
+    'ofl-1.0': {'id': 'OFL-1.0', 'deprecated': False},
+    'ofl-1.0-no-rfn': {'id': 'OFL-1.0-no-RFN', 'deprecated': False},
+    'ofl-1.0-rfn': {'id': 'OFL-1.0-RFN', 'deprecated': False},
+    'ofl-1.1': {'id': 'OFL-1.1', 'deprecated': False},
+    'ofl-1.1-no-rfn': {'id': 'OFL-1.1-no-RFN', 'deprecated': False},
+    'ofl-1.1-rfn': {'id': 'OFL-1.1-RFN', 'deprecated': False},
+    'ogc-1.0': {'id': 'OGC-1.0', 'deprecated': False},
+    'ogdl-taiwan-1.0': {'id': 'OGDL-Taiwan-1.0', 'deprecated': False},
+    'ogl-canada-2.0': {'id': 'OGL-Canada-2.0', 'deprecated': False},
+    'ogl-uk-1.0': {'id': 'OGL-UK-1.0', 'deprecated': False},
+    'ogl-uk-2.0': {'id': 'OGL-UK-2.0', 'deprecated': False},
+    'ogl-uk-3.0': {'id': 'OGL-UK-3.0', 'deprecated': False},
+    'ogtsl': {'id': 'OGTSL', 'deprecated': False},
+    'oldap-1.1': {'id': 'OLDAP-1.1', 'deprecated': False},
+    'oldap-1.2': {'id': 'OLDAP-1.2', 'deprecated': False},
+    'oldap-1.3': {'id': 'OLDAP-1.3', 'deprecated': False},
+    'oldap-1.4': {'id': 'OLDAP-1.4', 'deprecated': False},
+    'oldap-2.0': {'id': 'OLDAP-2.0', 'deprecated': False},
+    'oldap-2.0.1': {'id': 'OLDAP-2.0.1', 'deprecated': False},
+    'oldap-2.1': {'id': 'OLDAP-2.1', 'deprecated': False},
+    'oldap-2.2': {'id': 'OLDAP-2.2', 'deprecated': False},
+    'oldap-2.2.1': {'id': 'OLDAP-2.2.1', 'deprecated': False},
+    'oldap-2.2.2': {'id': 'OLDAP-2.2.2', 'deprecated': False},
+    'oldap-2.3': {'id': 'OLDAP-2.3', 'deprecated': False},
+    'oldap-2.4': {'id': 'OLDAP-2.4', 'deprecated': False},
+    'oldap-2.5': {'id': 'OLDAP-2.5', 'deprecated': False},
+    'oldap-2.6': {'id': 'OLDAP-2.6', 'deprecated': False},
+    'oldap-2.7': {'id': 'OLDAP-2.7', 'deprecated': False},
+    'oldap-2.8': {'id': 'OLDAP-2.8', 'deprecated': False},
+    'olfl-1.3': {'id': 'OLFL-1.3', 'deprecated': False},
+    'oml': {'id': 'OML', 'deprecated': False},
+    'openpbs-2.3': {'id': 'OpenPBS-2.3', 'deprecated': False},
+    'openssl': {'id': 'OpenSSL', 'deprecated': False},
+    'openssl-standalone': {'id': 'OpenSSL-standalone', 'deprecated': False},
+    'openvision': {'id': 'OpenVision', 'deprecated': False},
+    'opl-1.0': {'id': 'OPL-1.0', 'deprecated': False},
+    'opl-uk-3.0': {'id': 'OPL-UK-3.0', 'deprecated': False},
+    'opubl-1.0': {'id': 'OPUBL-1.0', 'deprecated': False},
+    'oset-pl-2.1': {'id': 'OSET-PL-2.1', 'deprecated': False},
+    'osl-1.0': {'id': 'OSL-1.0', 'deprecated': False},
+    'osl-1.1': {'id': 'OSL-1.1', 'deprecated': False},
+    'osl-2.0': {'id': 'OSL-2.0', 'deprecated': False},
+    'osl-2.1': {'id': 'OSL-2.1', 'deprecated': False},
+    'osl-3.0': {'id': 'OSL-3.0', 'deprecated': False},
+    'padl': {'id': 'PADL', 'deprecated': False},
+    'parity-6.0.0': {'id': 'Parity-6.0.0', 'deprecated': False},
+    'parity-7.0.0': {'id': 'Parity-7.0.0', 'deprecated': False},
+    'pddl-1.0': {'id': 'PDDL-1.0', 'deprecated': False},
+    'php-3.0': {'id': 'PHP-3.0', 'deprecated': False},
+    'php-3.01': {'id': 'PHP-3.01', 'deprecated': False},
+    'pixar': {'id': 'Pixar', 'deprecated': False},
+    'pkgconf': {'id': 'pkgconf', 'deprecated': False},
+    'plexus': {'id': 'Plexus', 'deprecated': False},
+    'pnmstitch': {'id': 'pnmstitch', 'deprecated': False},
+    'polyform-noncommercial-1.0.0': {'id': 'PolyForm-Noncommercial-1.0.0', 'deprecated': False},
+    'polyform-small-business-1.0.0': {'id': 'PolyForm-Small-Business-1.0.0', 'deprecated': False},
+    'postgresql': {'id': 'PostgreSQL', 'deprecated': False},
+    'ppl': {'id': 'PPL', 'deprecated': False},
+    'psf-2.0': {'id': 'PSF-2.0', 'deprecated': False},
+    'psfrag': {'id': 'psfrag', 'deprecated': False},
+    'psutils': {'id': 'psutils', 'deprecated': False},
+    'python-2.0': {'id': 'Python-2.0', 'deprecated': False},
+    'python-2.0.1': {'id': 'Python-2.0.1', 'deprecated': False},
+    'python-ldap': {'id': 'python-ldap', 'deprecated': False},
+    'qhull': {'id': 'Qhull', 'deprecated': False},
+    'qpl-1.0': {'id': 'QPL-1.0', 'deprecated': False},
+    'qpl-1.0-inria-2004': {'id': 'QPL-1.0-INRIA-2004', 'deprecated': False},
+    'radvd': {'id': 'radvd', 'deprecated': False},
+    'rdisc': {'id': 'Rdisc', 'deprecated': False},
+    'rhecos-1.1': {'id': 'RHeCos-1.1', 'deprecated': False},
+    'rpl-1.1': {'id': 'RPL-1.1', 'deprecated': False},
+    'rpl-1.5': {'id': 'RPL-1.5', 'deprecated': False},
+    'rpsl-1.0': {'id': 'RPSL-1.0', 'deprecated': False},
+    'rsa-md': {'id': 'RSA-MD', 'deprecated': False},
+    'rscpl': {'id': 'RSCPL', 'deprecated': False},
+    'ruby': {'id': 'Ruby', 'deprecated': False},
+    'ruby-pty': {'id': 'Ruby-pty', 'deprecated': False},
+    'sax-pd': {'id': 'SAX-PD', 'deprecated': False},
+    'sax-pd-2.0': {'id': 'SAX-PD-2.0', 'deprecated': False},
+    'saxpath': {'id': 'Saxpath', 'deprecated': False},
+    'scea': {'id': 'SCEA', 'deprecated': False},
+    'schemereport': {'id': 'SchemeReport', 'deprecated': False},
+    'sendmail': {'id': 'Sendmail', 'deprecated': False},
+    'sendmail-8.23': {'id': 'Sendmail-8.23', 'deprecated': False},
+    'sgi-b-1.0': {'id': 'SGI-B-1.0', 'deprecated': False},
+    'sgi-b-1.1': {'id': 'SGI-B-1.1', 'deprecated': False},
+    'sgi-b-2.0': {'id': 'SGI-B-2.0', 'deprecated': False},
+    'sgi-opengl': {'id': 'SGI-OpenGL', 'deprecated': False},
+    'sgp4': {'id': 'SGP4', 'deprecated': False},
+    'shl-0.5': {'id': 'SHL-0.5', 'deprecated': False},
+    'shl-0.51': {'id': 'SHL-0.51', 'deprecated': False},
+    'simpl-2.0': {'id': 'SimPL-2.0', 'deprecated': False},
+    'sissl': {'id': 'SISSL', 'deprecated': False},
+    'sissl-1.2': {'id': 'SISSL-1.2', 'deprecated': False},
+    'sl': {'id': 'SL', 'deprecated': False},
+    'sleepycat': {'id': 'Sleepycat', 'deprecated': False},
+    'smlnj': {'id': 'SMLNJ', 'deprecated': False},
+    'smppl': {'id': 'SMPPL', 'deprecated': False},
+    'snia': {'id': 'SNIA', 'deprecated': False},
+    'snprintf': {'id': 'snprintf', 'deprecated': False},
+    'softsurfer': {'id': 'softSurfer', 'deprecated': False},
+    'soundex': {'id': 'Soundex', 'deprecated': False},
+    'spencer-86': {'id': 'Spencer-86', 'deprecated': False},
+    'spencer-94': {'id': 'Spencer-94', 'deprecated': False},
+    'spencer-99': {'id': 'Spencer-99', 'deprecated': False},
+    'spl-1.0': {'id': 'SPL-1.0', 'deprecated': False},
+    'ssh-keyscan': {'id': 'ssh-keyscan', 'deprecated': False},
+    'ssh-openssh': {'id': 'SSH-OpenSSH', 'deprecated': False},
+    'ssh-short': {'id': 'SSH-short', 'deprecated': False},
+    'ssleay-standalone': {'id': 'SSLeay-standalone', 'deprecated': False},
+    'sspl-1.0': {'id': 'SSPL-1.0', 'deprecated': False},
+    'standardml-nj': {'id': 'StandardML-NJ', 'deprecated': True},
+    'sugarcrm-1.1.3': {'id': 'SugarCRM-1.1.3', 'deprecated': False},
+    'sun-ppp': {'id': 'Sun-PPP', 'deprecated': False},
+    'sun-ppp-2000': {'id': 'Sun-PPP-2000', 'deprecated': False},
+    'sunpro': {'id': 'SunPro', 'deprecated': False},
+    'swl': {'id': 'SWL', 'deprecated': False},
+    'swrule': {'id': 'swrule', 'deprecated': False},
+    'symlinks': {'id': 'Symlinks', 'deprecated': False},
+    'tapr-ohl-1.0': {'id': 'TAPR-OHL-1.0', 'deprecated': False},
+    'tcl': {'id': 'TCL', 'deprecated': False},
+    'tcp-wrappers': {'id': 'TCP-wrappers', 'deprecated': False},
+    'termreadkey': {'id': 'TermReadKey', 'deprecated': False},
+    'tgppl-1.0': {'id': 'TGPPL-1.0', 'deprecated': False},
+    'threeparttable': {'id': 'threeparttable', 'deprecated': False},
+    'tmate': {'id': 'TMate', 'deprecated': False},
+    'torque-1.1': {'id': 'TORQUE-1.1', 'deprecated': False},
+    'tosl': {'id': 'TOSL', 'deprecated': False},
+    'tpdl': {'id': 'TPDL', 'deprecated': False},
+    'tpl-1.0': {'id': 'TPL-1.0', 'deprecated': False},
+    'ttwl': {'id': 'TTWL', 'deprecated': False},
+    'ttyp0': {'id': 'TTYP0', 'deprecated': False},
+    'tu-berlin-1.0': {'id': 'TU-Berlin-1.0', 'deprecated': False},
+    'tu-berlin-2.0': {'id': 'TU-Berlin-2.0', 'deprecated': False},
+    'ubuntu-font-1.0': {'id': 'Ubuntu-font-1.0', 'deprecated': False},
+    'ucar': {'id': 'UCAR', 'deprecated': False},
+    'ucl-1.0': {'id': 'UCL-1.0', 'deprecated': False},
+    'ulem': {'id': 'ulem', 'deprecated': False},
+    'umich-merit': {'id': 'UMich-Merit', 'deprecated': False},
+    'unicode-3.0': {'id': 'Unicode-3.0', 'deprecated': False},
+    'unicode-dfs-2015': {'id': 'Unicode-DFS-2015', 'deprecated': False},
+    'unicode-dfs-2016': {'id': 'Unicode-DFS-2016', 'deprecated': False},
+    'unicode-tou': {'id': 'Unicode-TOU', 'deprecated': False},
+    'unixcrypt': {'id': 'UnixCrypt', 'deprecated': False},
+    'unlicense': {'id': 'Unlicense', 'deprecated': False},
+    'upl-1.0': {'id': 'UPL-1.0', 'deprecated': False},
+    'urt-rle': {'id': 'URT-RLE', 'deprecated': False},
+    'vim': {'id': 'Vim', 'deprecated': False},
+    'vostrom': {'id': 'VOSTROM', 'deprecated': False},
+    'vsl-1.0': {'id': 'VSL-1.0', 'deprecated': False},
+    'w3c': {'id': 'W3C', 'deprecated': False},
+    'w3c-19980720': {'id': 'W3C-19980720', 'deprecated': False},
+    'w3c-20150513': {'id': 'W3C-20150513', 'deprecated': False},
+    'w3m': {'id': 'w3m', 'deprecated': False},
+    'watcom-1.0': {'id': 'Watcom-1.0', 'deprecated': False},
+    'widget-workshop': {'id': 'Widget-Workshop', 'deprecated': False},
+    'wsuipa': {'id': 'Wsuipa', 'deprecated': False},
+    'wtfpl': {'id': 'WTFPL', 'deprecated': False},
+    'wxwindows': {'id': 'wxWindows', 'deprecated': True},
+    'x11': {'id': 'X11', 'deprecated': False},
+    'x11-distribute-modifications-variant': {'id': 'X11-distribute-modifications-variant', 'deprecated': False},
+    'x11-swapped': {'id': 'X11-swapped', 'deprecated': False},
+    'xdebug-1.03': {'id': 'Xdebug-1.03', 'deprecated': False},
+    'xerox': {'id': 'Xerox', 'deprecated': False},
+    'xfig': {'id': 'Xfig', 'deprecated': False},
+    'xfree86-1.1': {'id': 'XFree86-1.1', 'deprecated': False},
+    'xinetd': {'id': 'xinetd', 'deprecated': False},
+    'xkeyboard-config-zinoviev': {'id': 'xkeyboard-config-Zinoviev', 'deprecated': False},
+    'xlock': {'id': 'xlock', 'deprecated': False},
+    'xnet': {'id': 'Xnet', 'deprecated': False},
+    'xpp': {'id': 'xpp', 'deprecated': False},
+    'xskat': {'id': 'XSkat', 'deprecated': False},
+    'xzoom': {'id': 'xzoom', 'deprecated': False},
+    'ypl-1.0': {'id': 'YPL-1.0', 'deprecated': False},
+    'ypl-1.1': {'id': 'YPL-1.1', 'deprecated': False},
+    'zed': {'id': 'Zed', 'deprecated': False},
+    'zeeff': {'id': 'Zeeff', 'deprecated': False},
+    'zend-2.0': {'id': 'Zend-2.0', 'deprecated': False},
+    'zimbra-1.3': {'id': 'Zimbra-1.3', 'deprecated': False},
+    'zimbra-1.4': {'id': 'Zimbra-1.4', 'deprecated': False},
+    'zlib': {'id': 'Zlib', 'deprecated': False},
+    'zlib-acknowledgement': {'id': 'zlib-acknowledgement', 'deprecated': False},
+    'zpl-1.1': {'id': 'ZPL-1.1', 'deprecated': False},
+    'zpl-2.0': {'id': 'ZPL-2.0', 'deprecated': False},
+    'zpl-2.1': {'id': 'ZPL-2.1', 'deprecated': False},
+}
+
+EXCEPTIONS: dict[str, SPDXException] = {
+    '389-exception': {'id': '389-exception', 'deprecated': False},
+    'asterisk-exception': {'id': 'Asterisk-exception', 'deprecated': False},
+    'asterisk-linking-protocols-exception': {'id': 'Asterisk-linking-protocols-exception', 'deprecated': False},
+    'autoconf-exception-2.0': {'id': 'Autoconf-exception-2.0', 'deprecated': False},
+    'autoconf-exception-3.0': {'id': 'Autoconf-exception-3.0', 'deprecated': False},
+    'autoconf-exception-generic': {'id': 'Autoconf-exception-generic', 'deprecated': False},
+    'autoconf-exception-generic-3.0': {'id': 'Autoconf-exception-generic-3.0', 'deprecated': False},
+    'autoconf-exception-macro': {'id': 'Autoconf-exception-macro', 'deprecated': False},
+    'bison-exception-1.24': {'id': 'Bison-exception-1.24', 'deprecated': False},
+    'bison-exception-2.2': {'id': 'Bison-exception-2.2', 'deprecated': False},
+    'bootloader-exception': {'id': 'Bootloader-exception', 'deprecated': False},
+    'classpath-exception-2.0': {'id': 'Classpath-exception-2.0', 'deprecated': False},
+    'clisp-exception-2.0': {'id': 'CLISP-exception-2.0', 'deprecated': False},
+    'cryptsetup-openssl-exception': {'id': 'cryptsetup-OpenSSL-exception', 'deprecated': False},
+    'digirule-foss-exception': {'id': 'DigiRule-FOSS-exception', 'deprecated': False},
+    'ecos-exception-2.0': {'id': 'eCos-exception-2.0', 'deprecated': False},
+    'erlang-otp-linking-exception': {'id': 'erlang-otp-linking-exception', 'deprecated': False},
+    'fawkes-runtime-exception': {'id': 'Fawkes-Runtime-exception', 'deprecated': False},
+    'fltk-exception': {'id': 'FLTK-exception', 'deprecated': False},
+    'fmt-exception': {'id': 'fmt-exception', 'deprecated': False},
+    'font-exception-2.0': {'id': 'Font-exception-2.0', 'deprecated': False},
+    'freertos-exception-2.0': {'id': 'freertos-exception-2.0', 'deprecated': False},
+    'gcc-exception-2.0': {'id': 'GCC-exception-2.0', 'deprecated': False},
+    'gcc-exception-2.0-note': {'id': 'GCC-exception-2.0-note', 'deprecated': False},
+    'gcc-exception-3.1': {'id': 'GCC-exception-3.1', 'deprecated': False},
+    'gmsh-exception': {'id': 'Gmsh-exception', 'deprecated': False},
+    'gnat-exception': {'id': 'GNAT-exception', 'deprecated': False},
+    'gnome-examples-exception': {'id': 'GNOME-examples-exception', 'deprecated': False},
+    'gnu-compiler-exception': {'id': 'GNU-compiler-exception', 'deprecated': False},
+    'gnu-javamail-exception': {'id': 'gnu-javamail-exception', 'deprecated': False},
+    'gpl-3.0-interface-exception': {'id': 'GPL-3.0-interface-exception', 'deprecated': False},
+    'gpl-3.0-linking-exception': {'id': 'GPL-3.0-linking-exception', 'deprecated': False},
+    'gpl-3.0-linking-source-exception': {'id': 'GPL-3.0-linking-source-exception', 'deprecated': False},
+    'gpl-cc-1.0': {'id': 'GPL-CC-1.0', 'deprecated': False},
+    'gstreamer-exception-2005': {'id': 'GStreamer-exception-2005', 'deprecated': False},
+    'gstreamer-exception-2008': {'id': 'GStreamer-exception-2008', 'deprecated': False},
+    'i2p-gpl-java-exception': {'id': 'i2p-gpl-java-exception', 'deprecated': False},
+    'kicad-libraries-exception': {'id': 'KiCad-libraries-exception', 'deprecated': False},
+    'lgpl-3.0-linking-exception': {'id': 'LGPL-3.0-linking-exception', 'deprecated': False},
+    'libpri-openh323-exception': {'id': 'libpri-OpenH323-exception', 'deprecated': False},
+    'libtool-exception': {'id': 'Libtool-exception', 'deprecated': False},
+    'linux-syscall-note': {'id': 'Linux-syscall-note', 'deprecated': False},
+    'llgpl': {'id': 'LLGPL', 'deprecated': False},
+    'llvm-exception': {'id': 'LLVM-exception', 'deprecated': False},
+    'lzma-exception': {'id': 'LZMA-exception', 'deprecated': False},
+    'mif-exception': {'id': 'mif-exception', 'deprecated': False},
+    'nokia-qt-exception-1.1': {'id': 'Nokia-Qt-exception-1.1', 'deprecated': True},
+    'ocaml-lgpl-linking-exception': {'id': 'OCaml-LGPL-linking-exception', 'deprecated': False},
+    'occt-exception-1.0': {'id': 'OCCT-exception-1.0', 'deprecated': False},
+    'openjdk-assembly-exception-1.0': {'id': 'OpenJDK-assembly-exception-1.0', 'deprecated': False},
+    'openvpn-openssl-exception': {'id': 'openvpn-openssl-exception', 'deprecated': False},
+    'pcre2-exception': {'id': 'PCRE2-exception', 'deprecated': False},
+    'ps-or-pdf-font-exception-20170817': {'id': 'PS-or-PDF-font-exception-20170817', 'deprecated': False},
+    'qpl-1.0-inria-2004-exception': {'id': 'QPL-1.0-INRIA-2004-exception', 'deprecated': False},
+    'qt-gpl-exception-1.0': {'id': 'Qt-GPL-exception-1.0', 'deprecated': False},
+    'qt-lgpl-exception-1.1': {'id': 'Qt-LGPL-exception-1.1', 'deprecated': False},
+    'qwt-exception-1.0': {'id': 'Qwt-exception-1.0', 'deprecated': False},
+    'romic-exception': {'id': 'romic-exception', 'deprecated': False},
+    'rrdtool-floss-exception-2.0': {'id': 'RRDtool-FLOSS-exception-2.0', 'deprecated': False},
+    'sane-exception': {'id': 'SANE-exception', 'deprecated': False},
+    'shl-2.0': {'id': 'SHL-2.0', 'deprecated': False},
+    'shl-2.1': {'id': 'SHL-2.1', 'deprecated': False},
+    'stunnel-exception': {'id': 'stunnel-exception', 'deprecated': False},
+    'swi-exception': {'id': 'SWI-exception', 'deprecated': False},
+    'swift-exception': {'id': 'Swift-exception', 'deprecated': False},
+    'texinfo-exception': {'id': 'Texinfo-exception', 'deprecated': False},
+    'u-boot-exception-2.0': {'id': 'u-boot-exception-2.0', 'deprecated': False},
+    'ubdl-exception': {'id': 'UBDL-exception', 'deprecated': False},
+    'universal-foss-exception-1.0': {'id': 'Universal-FOSS-exception-1.0', 'deprecated': False},
+    'vsftpd-openssl-exception': {'id': 'vsftpd-openssl-exception', 'deprecated': False},
+    'wxwindows-exception-3.1': {'id': 'WxWindows-exception-3.1', 'deprecated': False},
+    'x11vnc-openssl-exception': {'id': 'x11vnc-openssl-exception', 'deprecated': False},
+}
diff --git a/lib/packaging/markers.py b/lib/packaging/markers.py
index 7ac7bb69..fb7f49cf 100644
--- a/lib/packaging/markers.py
+++ b/lib/packaging/markers.py
@@ -18,9 +18,9 @@ from .utils import canonicalize_name
 
 __all__ = [
     "InvalidMarker",
+    "Marker",
     "UndefinedComparison",
     "UndefinedEnvironmentName",
-    "Marker",
     "default_environment",
 ]
 
@@ -232,7 +232,7 @@ def _evaluate_markers(markers: MarkerList, environment: dict[str, str]) -> bool:
 
 
 def format_full_version(info: sys._version_info) -> str:
-    version = "{0.major}.{0.minor}.{0.micro}".format(info)
+    version = f"{info.major}.{info.minor}.{info.micro}"
     kind = info.releaselevel
     if kind != "final":
         version += kind[0] + str(info.serial)
@@ -309,12 +309,6 @@ class Marker:
         """
         current_environment = cast("dict[str, str]", default_environment())
         current_environment["extra"] = ""
-        # Work around platform.python_version() returning something that is not PEP 440
-        # compliant for non-tagged Python builds. We preserve default_environment()'s
-        # behavior of returning platform.python_version() verbatim, and leave it to the
-        # caller to provide a syntactically valid version if they want to override it.
-        if current_environment["python_full_version"].endswith("+"):
-            current_environment["python_full_version"] += "local"
         if environment is not None:
             current_environment.update(environment)
             # The API used to allow setting extra to None. We need to handle this
@@ -322,4 +316,16 @@ class Marker:
             if current_environment["extra"] is None:
                 current_environment["extra"] = ""
 
-        return _evaluate_markers(self._markers, current_environment)
+        return _evaluate_markers(
+            self._markers, _repair_python_full_version(current_environment)
+        )
+
+
+def _repair_python_full_version(env: dict[str, str]) -> dict[str, str]:
+    """
+    Work around platform.python_version() returning something that is not PEP 440
+    compliant for non-tagged Python builds.
+    """
+    if env["python_full_version"].endswith("+"):
+        env["python_full_version"] += "local"
+    return env
diff --git a/lib/packaging/metadata.py b/lib/packaging/metadata.py
index eb8dc844..721f411c 100644
--- a/lib/packaging/metadata.py
+++ b/lib/packaging/metadata.py
@@ -5,6 +5,8 @@ import email.header
 import email.message
 import email.parser
 import email.policy
+import pathlib
+import sys
 import typing
 from typing import (
     Any,
@@ -15,15 +17,16 @@ from typing import (
     cast,
 )
 
-from . import requirements, specifiers, utils
+from . import licenses, requirements, specifiers, utils
 from . import version as version_module
+from .licenses import NormalizedLicenseExpression
 
 T = typing.TypeVar("T")
 
 
-try:
-    ExceptionGroup
-except NameError:  # pragma: no cover
+if sys.version_info >= (3, 11):  # pragma: no cover
+    ExceptionGroup = ExceptionGroup
+else:  # pragma: no cover
 
     class ExceptionGroup(Exception):
         """A minimal implementation of :external:exc:`ExceptionGroup` from Python 3.11.
@@ -42,9 +45,6 @@ except NameError:  # pragma: no cover
         def __repr__(self) -> str:
             return f"{self.__class__.__name__}({self.message!r}, {self.exceptions!r})"
 
-else:  # pragma: no cover
-    ExceptionGroup = ExceptionGroup
-
 
 class InvalidMetadata(ValueError):
     """A metadata field contains invalid data."""
@@ -128,6 +128,10 @@ class RawMetadata(TypedDict, total=False):
     # No new fields were added in PEP 685, just some edge case were
     # tightened up to provide better interoptability.
 
+    # Metadata 2.4 - PEP 639
+    license_expression: str
+    license_files: list[str]
+
 
 _STRING_FIELDS = {
     "author",
@@ -137,6 +141,7 @@ _STRING_FIELDS = {
     "download_url",
     "home_page",
     "license",
+    "license_expression",
     "maintainer",
     "maintainer_email",
     "metadata_version",
@@ -149,6 +154,7 @@ _STRING_FIELDS = {
 _LIST_FIELDS = {
     "classifiers",
     "dynamic",
+    "license_files",
     "obsoletes",
     "obsoletes_dist",
     "platforms",
@@ -167,7 +173,7 @@ _DICT_FIELDS = {
 
 
 def _parse_keywords(data: str) -> list[str]:
-    """Split a string of comma-separate keyboards into a list of keywords."""
+    """Split a string of comma-separated keywords into a list of keywords."""
     return [k.strip() for k in data.split(",")]
 
 
@@ -216,16 +222,18 @@ def _get_payload(msg: email.message.Message, source: bytes | str) -> str:
     # If our source is a str, then our caller has managed encodings for us,
     # and we don't need to deal with it.
     if isinstance(source, str):
-        payload: str = msg.get_payload()
+        payload = msg.get_payload()
+        assert isinstance(payload, str)
         return payload
     # If our source is a bytes, then we're managing the encoding and we need
     # to deal with it.
     else:
-        bpayload: bytes = msg.get_payload(decode=True)
+        bpayload = msg.get_payload(decode=True)
+        assert isinstance(bpayload, bytes)
         try:
             return bpayload.decode("utf8", "strict")
-        except UnicodeDecodeError:
-            raise ValueError("payload in an invalid encoding")
+        except UnicodeDecodeError as exc:
+            raise ValueError("payload in an invalid encoding") from exc
 
 
 # The various parse_FORMAT functions here are intended to be as lenient as
@@ -251,6 +259,8 @@ _EMAIL_TO_RAW_MAPPING = {
     "home-page": "home_page",
     "keywords": "keywords",
     "license": "license",
+    "license-expression": "license_expression",
+    "license-file": "license_files",
     "maintainer": "maintainer",
     "maintainer-email": "maintainer_email",
     "metadata-version": "metadata_version",
@@ -426,7 +436,7 @@ def parse_email(data: bytes | str) -> tuple[RawMetadata, dict[str, list[str]]]:
         payload = _get_payload(parsed, data)
     except ValueError:
         unparsed.setdefault("description", []).append(
-            parsed.get_payload(decode=isinstance(data, bytes))
+            parsed.get_payload(decode=isinstance(data, bytes))  # type: ignore[call-overload]
         )
     else:
         if payload:
@@ -453,8 +463,8 @@ _NOT_FOUND = object()
 
 
 # Keep the two values in sync.
-_VALID_METADATA_VERSIONS = ["1.0", "1.1", "1.2", "2.1", "2.2", "2.3"]
-_MetadataVersion = Literal["1.0", "1.1", "1.2", "2.1", "2.2", "2.3"]
+_VALID_METADATA_VERSIONS = ["1.0", "1.1", "1.2", "2.1", "2.2", "2.3", "2.4"]
+_MetadataVersion = Literal["1.0", "1.1", "1.2", "2.1", "2.2", "2.3", "2.4"]
 
 _REQUIRED_ATTRS = frozenset(["metadata_version", "name", "version"])
 
@@ -535,7 +545,7 @@ class _Validator(Generic[T]):
         except utils.InvalidName as exc:
             raise self._invalid_metadata(
                 f"{value!r} is invalid for {{field}}", cause=exc
-            )
+            ) from exc
         else:
             return value
 
@@ -547,7 +557,7 @@ class _Validator(Generic[T]):
         except version_module.InvalidVersion as exc:
             raise self._invalid_metadata(
                 f"{value!r} is invalid for {{field}}", cause=exc
-            )
+            ) from exc
 
     def _process_summary(self, value: str) -> str:
         """Check the field contains no newlines."""
@@ -591,10 +601,12 @@ class _Validator(Generic[T]):
         for dynamic_field in map(str.lower, value):
             if dynamic_field in {"name", "version", "metadata-version"}:
                 raise self._invalid_metadata(
-                    f"{value!r} is not allowed as a dynamic field"
+                    f"{dynamic_field!r} is not allowed as a dynamic field"
                 )
             elif dynamic_field not in _EMAIL_TO_RAW_MAPPING:
-                raise self._invalid_metadata(f"{value!r} is not a valid dynamic field")
+                raise self._invalid_metadata(
+                    f"{dynamic_field!r} is not a valid dynamic field"
+                )
         return list(map(str.lower, value))
 
     def _process_provides_extra(
@@ -608,7 +620,7 @@ class _Validator(Generic[T]):
         except utils.InvalidName as exc:
             raise self._invalid_metadata(
                 f"{name!r} is invalid for {{field}}", cause=exc
-            )
+            ) from exc
         else:
             return normalized_names
 
@@ -618,7 +630,7 @@ class _Validator(Generic[T]):
         except specifiers.InvalidSpecifier as exc:
             raise self._invalid_metadata(
                 f"{value!r} is invalid for {{field}}", cause=exc
-            )
+            ) from exc
 
     def _process_requires_dist(
         self,
@@ -629,10 +641,49 @@ class _Validator(Generic[T]):
             for req in value:
                 reqs.append(requirements.Requirement(req))
         except requirements.InvalidRequirement as exc:
-            raise self._invalid_metadata(f"{req!r} is invalid for {{field}}", cause=exc)
+            raise self._invalid_metadata(
+                f"{req!r} is invalid for {{field}}", cause=exc
+            ) from exc
         else:
             return reqs
 
+    def _process_license_expression(
+        self, value: str
+    ) -> NormalizedLicenseExpression | None:
+        try:
+            return licenses.canonicalize_license_expression(value)
+        except ValueError as exc:
+            raise self._invalid_metadata(
+                f"{value!r} is invalid for {{field}}", cause=exc
+            ) from exc
+
+    def _process_license_files(self, value: list[str]) -> list[str]:
+        paths = []
+        for path in value:
+            if ".." in path:
+                raise self._invalid_metadata(
+                    f"{path!r} is invalid for {{field}}, "
+                    "parent directory indicators are not allowed"
+                )
+            if "*" in path:
+                raise self._invalid_metadata(
+                    f"{path!r} is invalid for {{field}}, paths must be resolved"
+                )
+            if (
+                pathlib.PurePosixPath(path).is_absolute()
+                or pathlib.PureWindowsPath(path).is_absolute()
+            ):
+                raise self._invalid_metadata(
+                    f"{path!r} is invalid for {{field}}, paths must be relative"
+                )
+            if pathlib.PureWindowsPath(path).as_posix() != path:
+                raise self._invalid_metadata(
+                    f"{path!r} is invalid for {{field}}, "
+                    "paths must use '/' delimiter"
+                )
+            paths.append(path)
+        return paths
+
 
 class Metadata:
     """Representation of distribution metadata.
@@ -688,8 +739,8 @@ class Metadata:
                             field = _RAW_TO_EMAIL_MAPPING[key]
                             exc = InvalidMetadata(
                                 field,
-                                "{field} introduced in metadata version "
-                                "{field_metadata_version}, not {metadata_version}",
+                                f"{field} introduced in metadata version "
+                                f"{field_metadata_version}, not {metadata_version}",
                             )
                             exceptions.append(exc)
                             continue
@@ -733,6 +784,8 @@ class Metadata:
     metadata_version: _Validator[_MetadataVersion] = _Validator()
     """:external:ref:`core-metadata-metadata-version`
     (required; validated to be a valid metadata version)"""
+    # `name` is not normalized/typed to NormalizedName so as to provide access to
+    # the original/raw name.
     name: _Validator[str] = _Validator()
     """:external:ref:`core-metadata-name`
     (required; validated using :func:`~packaging.utils.canonicalize_name` and its
@@ -770,6 +823,12 @@ class Metadata:
     """:external:ref:`core-metadata-maintainer-email`"""
     license: _Validator[str | None] = _Validator()
     """:external:ref:`core-metadata-license`"""
+    license_expression: _Validator[NormalizedLicenseExpression | None] = _Validator(
+        added="2.4"
+    )
+    """:external:ref:`core-metadata-license-expression`"""
+    license_files: _Validator[list[str] | None] = _Validator(added="2.4")
+    """:external:ref:`core-metadata-license-file`"""
     classifiers: _Validator[list[str] | None] = _Validator(added="1.1")
     """:external:ref:`core-metadata-classifier`"""
     requires_dist: _Validator[list[requirements.Requirement] | None] = _Validator(
diff --git a/lib/packaging/specifiers.py b/lib/packaging/specifiers.py
index 2fa75f7a..b30926af 100644
--- a/lib/packaging/specifiers.py
+++ b/lib/packaging/specifiers.py
@@ -234,7 +234,7 @@ class Specifier(BaseSpecifier):
         """
         match = self._regex.search(spec)
         if not match:
-            raise InvalidSpecifier(f"Invalid specifier: '{spec}'")
+            raise InvalidSpecifier(f"Invalid specifier: {spec!r}")
 
         self._spec: tuple[str, str] = (
             match.group("operator").strip(),
@@ -256,7 +256,7 @@ class Specifier(BaseSpecifier):
         # operators, and if they are if they are including an explicit
         # prerelease.
         operator, version = self._spec
-        if operator in ["==", ">=", "<=", "~=", "==="]:
+        if operator in ["==", ">=", "<=", "~=", "===", ">", "<"]:
             # The == specifier can include a trailing .*, if it does we
             # want to remove before parsing.
             if operator == "==" and version.endswith(".*"):
@@ -694,12 +694,18 @@ class SpecifierSet(BaseSpecifier):
     specifiers (``>=3.0,!=3.1``), or no specifier at all.
     """
 
-    def __init__(self, specifiers: str = "", prereleases: bool | None = None) -> None:
+    def __init__(
+        self,
+        specifiers: str | Iterable[Specifier] = "",
+        prereleases: bool | None = None,
+    ) -> None:
         """Initialize a SpecifierSet instance.
 
         :param specifiers:
             The string representation of a specifier or a comma-separated list of
             specifiers which will be parsed and normalized before use.
+            May also be an iterable of ``Specifier`` instances, which will be used
+            as is.
         :param prereleases:
             This tells the SpecifierSet if it should accept prerelease versions if
             applicable or not. The default of ``None`` will autodetect it from the
@@ -710,12 +716,17 @@ class SpecifierSet(BaseSpecifier):
             raised.
         """
 
-        # Split on `,` to break each individual specifier into it's own item, and
-        # strip each item to remove leading/trailing whitespace.
-        split_specifiers = [s.strip() for s in specifiers.split(",") if s.strip()]
+        if isinstance(specifiers, str):
+            # Split on `,` to break each individual specifier into its own item, and
+            # strip each item to remove leading/trailing whitespace.
+            split_specifiers = [s.strip() for s in specifiers.split(",") if s.strip()]
 
-        # Make each individual specifier a Specifier and save in a frozen set for later.
-        self._specs = frozenset(map(Specifier, split_specifiers))
+            # Make each individual specifier a Specifier and save in a frozen set
+            # for later.
+            self._specs = frozenset(map(Specifier, split_specifiers))
+        else:
+            # Save the supplied specifiers in a frozen set.
+            self._specs = frozenset(specifiers)
 
         # Store our prereleases value so we can use it later to determine if
         # we accept prereleases or not.
diff --git a/lib/packaging/tags.py b/lib/packaging/tags.py
index 6667d299..f5903402 100644
--- a/lib/packaging/tags.py
+++ b/lib/packaging/tags.py
@@ -25,7 +25,7 @@ from . import _manylinux, _musllinux
 logger = logging.getLogger(__name__)
 
 PythonVersion = Sequence[int]
-MacVersion = Tuple[int, int]
+AppleVersion = Tuple[int, int]
 
 INTERPRETER_SHORT_NAMES: dict[str, str] = {
     "python": "py",  # Generic.
@@ -47,7 +47,7 @@ class Tag:
     is also supported.
     """
 
-    __slots__ = ["_interpreter", "_abi", "_platform", "_hash"]
+    __slots__ = ["_abi", "_hash", "_interpreter", "_platform"]
 
     def __init__(self, interpreter: str, abi: str, platform: str) -> None:
         self._interpreter = interpreter.lower()
@@ -235,9 +235,8 @@ def cpython_tags(
     if use_abi3:
         for minor_version in range(python_version[1] - 1, 1, -1):
             for platform_ in platforms:
-                interpreter = "cp{version}".format(
-                    version=_version_nodot((python_version[0], minor_version))
-                )
+                version = _version_nodot((python_version[0], minor_version))
+                interpreter = f"cp{version}"
                 yield Tag(interpreter, "abi3", platform_)
 
 
@@ -363,7 +362,7 @@ def _mac_arch(arch: str, is_32bit: bool = _32_BIT_INTERPRETER) -> str:
     return "i386"
 
 
-def _mac_binary_formats(version: MacVersion, cpu_arch: str) -> list[str]:
+def _mac_binary_formats(version: AppleVersion, cpu_arch: str) -> list[str]:
     formats = [cpu_arch]
     if cpu_arch == "x86_64":
         if version < (10, 4):
@@ -396,7 +395,7 @@ def _mac_binary_formats(version: MacVersion, cpu_arch: str) -> list[str]:
 
 
 def mac_platforms(
-    version: MacVersion | None = None, arch: str | None = None
+    version: AppleVersion | None = None, arch: str | None = None
 ) -> Iterator[str]:
     """
     Yields the platform tags for a macOS system.
@@ -408,7 +407,7 @@ def mac_platforms(
     """
     version_str, _, cpu_arch = platform.mac_ver()
     if version is None:
-        version = cast("MacVersion", tuple(map(int, version_str.split(".")[:2])))
+        version = cast("AppleVersion", tuple(map(int, version_str.split(".")[:2])))
         if version == (10, 16):
             # When built against an older macOS SDK, Python will report macOS 10.16
             # instead of the real version.
@@ -424,7 +423,7 @@ def mac_platforms(
                 stdout=subprocess.PIPE,
                 text=True,
             ).stdout
-            version = cast("MacVersion", tuple(map(int, version_str.split(".")[:2])))
+            version = cast("AppleVersion", tuple(map(int, version_str.split(".")[:2])))
     else:
         version = version
     if arch is None:
@@ -435,24 +434,22 @@ def mac_platforms(
     if (10, 0) <= version and version < (11, 0):
         # Prior to Mac OS 11, each yearly release of Mac OS bumped the
         # "minor" version number.  The major version was always 10.
+        major_version = 10
         for minor_version in range(version[1], -1, -1):
-            compat_version = 10, minor_version
+            compat_version = major_version, minor_version
             binary_formats = _mac_binary_formats(compat_version, arch)
             for binary_format in binary_formats:
-                yield "macosx_{major}_{minor}_{binary_format}".format(
-                    major=10, minor=minor_version, binary_format=binary_format
-                )
+                yield f"macosx_{major_version}_{minor_version}_{binary_format}"
 
     if version >= (11, 0):
         # Starting with Mac OS 11, each yearly release bumps the major version
         # number.   The minor versions are now the midyear updates.
+        minor_version = 0
         for major_version in range(version[0], 10, -1):
-            compat_version = major_version, 0
+            compat_version = major_version, minor_version
             binary_formats = _mac_binary_formats(compat_version, arch)
             for binary_format in binary_formats:
-                yield "macosx_{major}_{minor}_{binary_format}".format(
-                    major=major_version, minor=0, binary_format=binary_format
-                )
+                yield f"macosx_{major_version}_{minor_version}_{binary_format}"
 
     if version >= (11, 0):
         # Mac OS 11 on x86_64 is compatible with binaries from previous releases.
@@ -462,25 +459,75 @@ def mac_platforms(
         # However, the "universal2" binary format can have a
         # macOS version earlier than 11.0 when the x86_64 part of the binary supports
         # that version of macOS.
+        major_version = 10
         if arch == "x86_64":
             for minor_version in range(16, 3, -1):
-                compat_version = 10, minor_version
+                compat_version = major_version, minor_version
                 binary_formats = _mac_binary_formats(compat_version, arch)
                 for binary_format in binary_formats:
-                    yield "macosx_{major}_{minor}_{binary_format}".format(
-                        major=compat_version[0],
-                        minor=compat_version[1],
-                        binary_format=binary_format,
-                    )
+                    yield f"macosx_{major_version}_{minor_version}_{binary_format}"
         else:
             for minor_version in range(16, 3, -1):
-                compat_version = 10, minor_version
+                compat_version = major_version, minor_version
                 binary_format = "universal2"
-                yield "macosx_{major}_{minor}_{binary_format}".format(
-                    major=compat_version[0],
-                    minor=compat_version[1],
-                    binary_format=binary_format,
-                )
+                yield f"macosx_{major_version}_{minor_version}_{binary_format}"
+
+
+def ios_platforms(
+    version: AppleVersion | None = None, multiarch: str | None = None
+) -> Iterator[str]:
+    """
+    Yields the platform tags for an iOS system.
+
+    :param version: A two-item tuple specifying the iOS version to generate
+        platform tags for. Defaults to the current iOS version.
+    :param multiarch: The CPU architecture+ABI to generate platform tags for -
+        (the value used by `sys.implementation._multiarch` e.g.,
+        `arm64_iphoneos` or `x84_64_iphonesimulator`). Defaults to the current
+        multiarch value.
+    """
+    if version is None:
+        # if iOS is the current platform, ios_ver *must* be defined. However,
+        # it won't exist for CPython versions before 3.13, which causes a mypy
+        # error.
+        _, release, _, _ = platform.ios_ver()  # type: ignore[attr-defined, unused-ignore]
+        version = cast("AppleVersion", tuple(map(int, release.split(".")[:2])))
+
+    if multiarch is None:
+        multiarch = sys.implementation._multiarch
+    multiarch = multiarch.replace("-", "_")
+
+    ios_platform_template = "ios_{major}_{minor}_{multiarch}"
+
+    # Consider any iOS major.minor version from the version requested, down to
+    # 12.0. 12.0 is the first iOS version that is known to have enough features
+    # to support CPython. Consider every possible minor release up to X.9. There
+    # highest the minor has ever gone is 8 (14.8 and 15.8) but having some extra
+    # candidates that won't ever match doesn't really hurt, and it saves us from
+    # having to keep an explicit list of known iOS versions in the code. Return
+    # the results descending order of version number.
+
+    # If the requested major version is less than 12, there won't be any matches.
+    if version[0] < 12:
+        return
+
+    # Consider the actual X.Y version that was requested.
+    yield ios_platform_template.format(
+        major=version[0], minor=version[1], multiarch=multiarch
+    )
+
+    # Consider every minor version from X.0 to the minor version prior to the
+    # version requested by the platform.
+    for minor in range(version[1] - 1, -1, -1):
+        yield ios_platform_template.format(
+            major=version[0], minor=minor, multiarch=multiarch
+        )
+
+    for major in range(version[0] - 1, 11, -1):
+        for minor in range(9, -1, -1):
+            yield ios_platform_template.format(
+                major=major, minor=minor, multiarch=multiarch
+            )
 
 
 def _linux_platforms(is_32bit: bool = _32_BIT_INTERPRETER) -> Iterator[str]:
@@ -512,6 +559,8 @@ def platform_tags() -> Iterator[str]:
     """
     if platform.system() == "Darwin":
         return mac_platforms()
+    elif platform.system() == "iOS":
+        return ios_platforms()
     elif platform.system() == "Linux":
         return _linux_platforms()
     else:
diff --git a/lib/packaging/utils.py b/lib/packaging/utils.py
index d33da5bb..23450953 100644
--- a/lib/packaging/utils.py
+++ b/lib/packaging/utils.py
@@ -4,11 +4,12 @@
 
 from __future__ import annotations
 
+import functools
 import re
 from typing import NewType, Tuple, Union, cast
 
 from .tags import Tag, parse_tag
-from .version import InvalidVersion, Version
+from .version import InvalidVersion, Version, _TrimmedRelease
 
 BuildTag = Union[Tuple[()], Tuple[int, str]]
 NormalizedName = NewType("NormalizedName", str)
@@ -54,52 +55,40 @@ def is_normalized_name(name: str) -> bool:
     return _normalized_regex.match(name) is not None
 
 
+@functools.singledispatch
 def canonicalize_version(
     version: Version | str, *, strip_trailing_zero: bool = True
 ) -> str:
     """
-    This is very similar to Version.__str__, but has one subtle difference
-    with the way it handles the release segment.
+    Return a canonical form of a version as a string.
+
+    >>> canonicalize_version('1.0.1')
+    '1.0.1'
+
+    Per PEP 625, versions may have multiple canonical forms, differing
+    only by trailing zeros.
+
+    >>> canonicalize_version('1.0.0')
+    '1'
+    >>> canonicalize_version('1.0.0', strip_trailing_zero=False)
+    '1.0.0'
+
+    Invalid versions are returned unaltered.
+
+    >>> canonicalize_version('foo bar baz')
+    'foo bar baz'
     """
-    if isinstance(version, str):
-        try:
-            parsed = Version(version)
-        except InvalidVersion:
-            # Legacy versions cannot be normalized
-            return version
-    else:
-        parsed = version
+    return str(_TrimmedRelease(str(version)) if strip_trailing_zero else version)
 
-    parts = []
 
-    # Epoch
-    if parsed.epoch != 0:
-        parts.append(f"{parsed.epoch}!")
-
-    # Release segment
-    release_segment = ".".join(str(x) for x in parsed.release)
-    if strip_trailing_zero:
-        # NB: This strips trailing '.0's to normalize
-        release_segment = re.sub(r"(\.0)+$", "", release_segment)
-    parts.append(release_segment)
-
-    # Pre-release
-    if parsed.pre is not None:
-        parts.append("".join(str(x) for x in parsed.pre))
-
-    # Post-release
-    if parsed.post is not None:
-        parts.append(f".post{parsed.post}")
-
-    # Development release
-    if parsed.dev is not None:
-        parts.append(f".dev{parsed.dev}")
-
-    # Local version segment
-    if parsed.local is not None:
-        parts.append(f"+{parsed.local}")
-
-    return "".join(parts)
+@canonicalize_version.register
+def _(version: str, *, strip_trailing_zero: bool = True) -> str:
+    try:
+        parsed = Version(version)
+    except InvalidVersion:
+        # Legacy versions cannot be normalized
+        return version
+    return canonicalize_version(parsed, strip_trailing_zero=strip_trailing_zero)
 
 
 def parse_wheel_filename(
@@ -107,28 +96,28 @@ def parse_wheel_filename(
 ) -> tuple[NormalizedName, Version, BuildTag, frozenset[Tag]]:
     if not filename.endswith(".whl"):
         raise InvalidWheelFilename(
-            f"Invalid wheel filename (extension must be '.whl'): {filename}"
+            f"Invalid wheel filename (extension must be '.whl'): {filename!r}"
         )
 
     filename = filename[:-4]
     dashes = filename.count("-")
     if dashes not in (4, 5):
         raise InvalidWheelFilename(
-            f"Invalid wheel filename (wrong number of parts): {filename}"
+            f"Invalid wheel filename (wrong number of parts): {filename!r}"
         )
 
     parts = filename.split("-", dashes - 2)
     name_part = parts[0]
     # See PEP 427 for the rules on escaping the project name.
     if "__" in name_part or re.match(r"^[\w\d._]*$", name_part, re.UNICODE) is None:
-        raise InvalidWheelFilename(f"Invalid project name: {filename}")
+        raise InvalidWheelFilename(f"Invalid project name: {filename!r}")
     name = canonicalize_name(name_part)
 
     try:
         version = Version(parts[1])
     except InvalidVersion as e:
         raise InvalidWheelFilename(
-            f"Invalid wheel filename (invalid version): {filename}"
+            f"Invalid wheel filename (invalid version): {filename!r}"
         ) from e
 
     if dashes == 5:
@@ -136,7 +125,7 @@ def parse_wheel_filename(
         build_match = _build_tag_regex.match(build_part)
         if build_match is None:
             raise InvalidWheelFilename(
-                f"Invalid build number: {build_part} in '{filename}'"
+                f"Invalid build number: {build_part} in {filename!r}"
             )
         build = cast(BuildTag, (int(build_match.group(1)), build_match.group(2)))
     else:
@@ -153,14 +142,14 @@ def parse_sdist_filename(filename: str) -> tuple[NormalizedName, Version]:
     else:
         raise InvalidSdistFilename(
             f"Invalid sdist filename (extension must be '.tar.gz' or '.zip'):"
-            f" {filename}"
+            f" {filename!r}"
         )
 
     # We are requiring a PEP 440 version, which cannot contain dashes,
     # so we split on the last dash.
     name_part, sep, version_part = file_stem.rpartition("-")
     if not sep:
-        raise InvalidSdistFilename(f"Invalid sdist filename: {filename}")
+        raise InvalidSdistFilename(f"Invalid sdist filename: {filename!r}")
 
     name = canonicalize_name(name_part)
 
@@ -168,7 +157,7 @@ def parse_sdist_filename(filename: str) -> tuple[NormalizedName, Version]:
         version = Version(version_part)
     except InvalidVersion as e:
         raise InvalidSdistFilename(
-            f"Invalid sdist filename (invalid version): {filename}"
+            f"Invalid sdist filename (invalid version): {filename!r}"
         ) from e
 
     return (name, version)
diff --git a/lib/packaging/version.py b/lib/packaging/version.py
index 46bc2613..c9bbda20 100644
--- a/lib/packaging/version.py
+++ b/lib/packaging/version.py
@@ -15,7 +15,7 @@ from typing import Any, Callable, NamedTuple, SupportsInt, Tuple, Union
 
 from ._structures import Infinity, InfinityType, NegativeInfinity, NegativeInfinityType
 
-__all__ = ["VERSION_PATTERN", "parse", "Version", "InvalidVersion"]
+__all__ = ["VERSION_PATTERN", "InvalidVersion", "Version", "parse"]
 
 LocalType = Tuple[Union[int, str], ...]
 
@@ -199,7 +199,7 @@ class Version(_BaseVersion):
         # Validate the version and parse it into pieces
         match = self._regex.search(version)
         if not match:
-            raise InvalidVersion(f"Invalid version: '{version}'")
+            raise InvalidVersion(f"Invalid version: {version!r}")
 
         # Store the parsed out pieces of the version
         self._version = _Version(
@@ -232,7 +232,7 @@ class Version(_BaseVersion):
         return f"<Version('{self}')>"
 
     def __str__(self) -> str:
-        """A string representation of the version that can be rounded-tripped.
+        """A string representation of the version that can be round-tripped.
 
         >>> str(Version("1.0a5"))
         '1.0a5'
@@ -350,8 +350,8 @@ class Version(_BaseVersion):
         '1.2.3'
         >>> Version("1.2.3+abc").public
         '1.2.3'
-        >>> Version("1.2.3+abc.dev1").public
-        '1.2.3'
+        >>> Version("1!1.2.3dev1+abc").public
+        '1!1.2.3.dev1'
         """
         return str(self).split("+", 1)[0]
 
@@ -363,7 +363,7 @@ class Version(_BaseVersion):
         '1.2.3'
         >>> Version("1.2.3+abc").base_version
         '1.2.3'
-        >>> Version("1!1.2.3+abc.dev1").base_version
+        >>> Version("1!1.2.3dev1+abc").base_version
         '1!1.2.3'
 
         The "base version" is the public version of the project without any pre or post
@@ -451,6 +451,23 @@ class Version(_BaseVersion):
         return self.release[2] if len(self.release) >= 3 else 0
 
 
+class _TrimmedRelease(Version):
+    @property
+    def release(self) -> tuple[int, ...]:
+        """
+        Release segment without any trailing zeros.
+
+        >>> _TrimmedRelease('1.0.0').release
+        (1,)
+        >>> _TrimmedRelease('0.0').release
+        (0,)
+        """
+        rel = super().release
+        nonzeros = (index for index, val in enumerate(rel) if val)
+        last_nonzero = max(nonzeros, default=0)
+        return rel[: last_nonzero + 1]
+
+
 def _parse_letter_version(
     letter: str | None, number: str | bytes | SupportsInt | None
 ) -> tuple[str, int] | None:
@@ -476,7 +493,9 @@ def _parse_letter_version(
             letter = "post"
 
         return letter, int(number)
-    if not letter and number:
+
+    assert not letter
+    if number:
         # We assume if we are given a number, but we are not given a letter
         # then this is using the implicit post release syntax (e.g. 1.0-1)
         letter = "post"
diff --git a/requirements.txt b/requirements.txt
index ae5649d4..89a67b60 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -23,7 +23,7 @@ IPy==1.01
 Mako==1.3.6
 MarkupSafe==2.1.5
 musicbrainzngs==0.7.1
-packaging==24.1
+packaging==24.2
 paho-mqtt==2.1.0
 platformdirs==4.3.6
 plexapi==4.15.16

From 84be60cb3608009c56f54f85b777a6c26a0d3856 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 16 Nov 2024 14:53:33 -0800
Subject: [PATCH 676/743] Bump pywin32 from 306 to 308 (#2417)

Bumps [pywin32](https://github.com/mhammond/pywin32) from 306 to 308.
- [Release notes](https://github.com/mhammond/pywin32/releases)
- [Changelog](https://github.com/mhammond/pywin32/blob/main/CHANGES.txt)
- [Commits](https://github.com/mhammond/pywin32/commits)

---
updated-dependencies:
- dependency-name: pywin32
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 package/requirements-package.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index 7e3c7a1c..aec6264e 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -8,4 +8,4 @@ pyopenssl==24.2.1
 pyobjc-core==10.3.1; platform_system == "Darwin"
 pyobjc-framework-Cocoa==10.3.1; platform_system == "Darwin"
 
-pywin32==306; platform_system == "Windows"
+pywin32==308; platform_system == "Windows"

From 599e52de6a037855b2534e970441c74d9793980e Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 16 Nov 2024 14:53:44 -0800
Subject: [PATCH 677/743] Bump cryptography from 43.0.0 to 43.0.3 (#2421)

Bumps [cryptography](https://github.com/pyca/cryptography) from 43.0.0 to 43.0.3.
- [Changelog](https://github.com/pyca/cryptography/blob/main/CHANGELOG.rst)
- [Commits](https://github.com/pyca/cryptography/compare/43.0.0...43.0.3)

---
updated-dependencies:
- dependency-name: cryptography
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 package/requirements-package.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index aec6264e..c72398de 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -1,5 +1,5 @@
 apscheduler==3.10.1
-cryptography==43.0.0
+cryptography==43.0.3
 importlib-metadata==8.5.0
 importlib-resources==6.4.5
 pyinstaller==6.8.0

From ddb4f6131b637eb309038c5452d8b288f37b4e62 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 16 Nov 2024 15:02:52 -0800
Subject: [PATCH 678/743] Bump pyinstaller from 6.8.0 to 6.11.1 (#2431)

Bumps [pyinstaller](https://github.com/pyinstaller/pyinstaller) from 6.8.0 to 6.11.1.
- [Release notes](https://github.com/pyinstaller/pyinstaller/releases)
- [Changelog](https://github.com/pyinstaller/pyinstaller/blob/develop/doc/CHANGES.rst)
- [Commits](https://github.com/pyinstaller/pyinstaller/compare/v6.8.0...v6.11.1)

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

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 package/requirements-package.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index c72398de..141b1a27 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -2,7 +2,7 @@ apscheduler==3.10.1
 cryptography==43.0.3
 importlib-metadata==8.5.0
 importlib-resources==6.4.5
-pyinstaller==6.8.0
+pyinstaller==6.11.1
 pyopenssl==24.2.1
 
 pyobjc-core==10.3.1; platform_system == "Darwin"

From 86d775a5860d968d99ee3dfa515c1277aa44745d Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 14 Nov 2024 12:05:28 -0800
Subject: [PATCH 679/743] Update OneSignal API calls

---
 plexpy/mobile_app.py | 3 +--
 plexpy/notifiers.py  | 6 +++---
 2 files changed, 4 insertions(+), 5 deletions(-)

diff --git a/plexpy/mobile_app.py b/plexpy/mobile_app.py
index 4d1267a1..f3c835c3 100644
--- a/plexpy/mobile_app.py
+++ b/plexpy/mobile_app.py
@@ -198,11 +198,10 @@ def validate_onesignal_id(onesignal_id):
         return 2
 
     headers = {'Content-Type': 'application/json'}
-    params = {'app_id': _ONESIGNAL_APP_ID}
 
     logger.info("Tautulli MobileApp :: Validating OneSignal ID")
     try:
-        r = requests.get('https://onesignal.com/api/v1/players/{}'.format(onesignal_id), headers=headers, params=params)
+        r = requests.get(f'https://api.onesignal.com/apps/{_ONESIGNAL_APP_ID}/subscriptions/{onesignal_id}/user/identity', headers=headers)
         status_code = r.status_code
         logger.info("Tautulli MobileApp :: OneSignal ID validation returned status code %s", status_code)
         return int(status_code == 200)
diff --git a/plexpy/notifiers.py b/plexpy/notifiers.py
index eb63df33..2029aa01 100644
--- a/plexpy/notifiers.py
+++ b/plexpy/notifiers.py
@@ -4044,7 +4044,7 @@ class TAUTULLIREMOTEAPP(Notifier):
             #logger.debug("Salt (base64): {}".format(base64.b64encode(salt)))
 
             payload = {'app_id': mobile_app._ONESIGNAL_APP_ID,
-                       'include_player_ids': [device['onesignal_id']],
+                       'include_subscription_ids': [device['onesignal_id']],
                        'contents': {'en': 'Tautulli Notification'},
                        'data': {'encrypted': True,
                                 'version': 2,
@@ -4059,7 +4059,7 @@ class TAUTULLIREMOTEAPP(Notifier):
                         "Install the library to encrypt the notifications.")
 
             payload = {'app_id': mobile_app._ONESIGNAL_APP_ID,
-                       'include_player_ids': [device['onesignal_id']],
+                       'include_subscription_ids': [device['onesignal_id']],
                        'contents': {'en': 'Tautulli Notification'},
                        'data': {'encrypted': False,
                                 'plain_text': plaintext_data,
@@ -4070,7 +4070,7 @@ class TAUTULLIREMOTEAPP(Notifier):
 
         headers = {'Content-Type': 'application/json'}
 
-        return self.make_request('https://onesignal.com/api/v1/notifications', headers=headers, json=payload)
+        return self.make_request('https://api.onesignal.com/notifications', headers=headers, json=payload)
 
     def get_devices(self):
         db = database.MonitorDatabase()

From d9f38f9390f41045a812b5fa58c95a15dff7221c Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 14 Nov 2024 12:22:52 -0800
Subject: [PATCH 680/743] Fix artist title for fixing metadata match

Fixes #2429
---
 plexpy/pmsconnect.py | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/plexpy/pmsconnect.py b/plexpy/pmsconnect.py
index fa36219f..4826d3d6 100644
--- a/plexpy/pmsconnect.py
+++ b/plexpy/pmsconnect.py
@@ -3148,6 +3148,7 @@ class PmsConnect(object):
         if media_type == 'season' or media_type == 'album':
             try:
                 metadata = self.get_metadata_details(rating_key=rating_key)
+                title = metadata['parent_title']
                 rating_key = metadata['parent_rating_key']
                 section_id = metadata['section_id']
                 library_name = metadata['library_name']
@@ -3158,6 +3159,7 @@ class PmsConnect(object):
         elif media_type == 'episode' or media_type == 'track':
             try:
                 metadata = self.get_metadata_details(rating_key=rating_key)
+                title = metadata['grandparent_title']
                 rating_key = metadata['grandparent_rating_key']
                 section_id = metadata['section_id']
                 library_name = metadata['library_name']
@@ -3165,9 +3167,10 @@ class PmsConnect(object):
                 logger.warn("Tautulli Pmsconnect :: Unable to get grandparent_rating_key for get_rating_keys_list: %s." % e)
                 return {}
 
-        elif media_type == 'artist':
+        elif media_type == 'show' or media_type == 'artist':
             try:
                 metadata = self.get_metadata_details(rating_key=rating_key)
+                title = metadata['title']
                 section_id = metadata['section_id']
                 library_name = metadata['library_name']
             except Exception as e:
@@ -3197,8 +3200,6 @@ class PmsConnect(object):
                 if a.getAttribute('size') == '0':
                     return {}
 
-            title = helpers.get_xml_attr(a, 'title2')
-
             if a.getElementsByTagName('Directory'):
                 parents_metadata = a.getElementsByTagName('Directory')
             else:

From 5b47cebdc7011c8718c2dc4312cbe2726ef0c30e Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 16 Nov 2024 15:21:41 -0800
Subject: [PATCH 681/743] Bump minimum Python version to 3.9

---
 README.md | 2 +-
 start.sh  | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index a6a3e4e4..1f24741e 100644
--- a/README.md
+++ b/README.md
@@ -36,7 +36,7 @@ and [PlexWatchWeb](https://github.com/ecleese/plexWatchWeb).
 [![Docker Stars][badge-docker-stars]][DockerHub]
 [![Downloads][badge-downloads]][Releases Latest]
 
-[badge-python]: https://img.shields.io/badge/python->=3.8-blue?style=flat-square
+[badge-python]: https://img.shields.io/badge/python->=3.9-blue?style=flat-square
 [badge-docker-pulls]: https://img.shields.io/docker/pulls/tautulli/tautulli?style=flat-square
 [badge-docker-stars]: https://img.shields.io/docker/stars/tautulli/tautulli?style=flat-square
 [badge-downloads]: https://img.shields.io/github/downloads/Tautulli/Tautulli/total?style=flat-square
diff --git a/start.sh b/start.sh
index a9970df7..8896ac87 100755
--- a/start.sh
+++ b/start.sh
@@ -12,7 +12,7 @@ if [[ "$TAUTULLI_DOCKER" == "True" ]]; then
     echo "Running Tautulli using user tautulli (uid=$(id -u tautulli)) and group tautulli (gid=$(id -g tautulli))"
     exec gosu tautulli "$@"
 else
-    python_versions=("python3.11" "python3.10" "python3.9" "python3.8" "python3" "python")
+    python_versions=("python3.11" "python3.10" "python3.9" "python3" "python")
     for cmd in "${python_versions[@]}"; do
         if command -v "$cmd" >/dev/null; then
             echo "Starting Tautulli with $cmd."

From afc29604cc8c63b6087bdf45b830c1892dd088e4 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 19 Nov 2024 09:34:12 -0800
Subject: [PATCH 682/743] Bump zipp==3.21.0

Closes #2433
---
 lib/zipp.py      | 312 -----------------------------------------------
 requirements.txt |   2 +-
 2 files changed, 1 insertion(+), 313 deletions(-)
 delete mode 100644 lib/zipp.py

diff --git a/lib/zipp.py b/lib/zipp.py
deleted file mode 100644
index 52c82a0e..00000000
--- a/lib/zipp.py
+++ /dev/null
@@ -1,312 +0,0 @@
-import io
-import posixpath
-import zipfile
-import itertools
-import contextlib
-import pathlib
-
-
-__all__ = ['Path']
-
-
-def _parents(path):
-    """
-    Given a path with elements separated by
-    posixpath.sep, generate all parents of that path.
-
-    >>> list(_parents('b/d'))
-    ['b']
-    >>> list(_parents('/b/d/'))
-    ['/b']
-    >>> list(_parents('b/d/f/'))
-    ['b/d', 'b']
-    >>> list(_parents('b'))
-    []
-    >>> list(_parents(''))
-    []
-    """
-    return itertools.islice(_ancestry(path), 1, None)
-
-
-def _ancestry(path):
-    """
-    Given a path with elements separated by
-    posixpath.sep, generate all elements of that path
-
-    >>> list(_ancestry('b/d'))
-    ['b/d', 'b']
-    >>> list(_ancestry('/b/d/'))
-    ['/b/d', '/b']
-    >>> list(_ancestry('b/d/f/'))
-    ['b/d/f', 'b/d', 'b']
-    >>> list(_ancestry('b'))
-    ['b']
-    >>> list(_ancestry(''))
-    []
-    """
-    path = path.rstrip(posixpath.sep)
-    while path and path != posixpath.sep:
-        yield path
-        path, tail = posixpath.split(path)
-
-
-_dedupe = dict.fromkeys
-"""Deduplicate an iterable in original order"""
-
-
-def _difference(minuend, subtrahend):
-    """
-    Return items in minuend not in subtrahend, retaining order
-    with O(1) lookup.
-    """
-    return itertools.filterfalse(set(subtrahend).__contains__, minuend)
-
-
-class CompleteDirs(zipfile.ZipFile):
-    """
-    A ZipFile subclass that ensures that implied directories
-    are always included in the namelist.
-    """
-
-    @staticmethod
-    def _implied_dirs(names):
-        parents = itertools.chain.from_iterable(map(_parents, names))
-        as_dirs = (p + posixpath.sep for p in parents)
-        return _dedupe(_difference(as_dirs, names))
-
-    def namelist(self):
-        names = super(CompleteDirs, self).namelist()
-        return names + list(self._implied_dirs(names))
-
-    def _name_set(self):
-        return set(self.namelist())
-
-    def resolve_dir(self, name):
-        """
-        If the name represents a directory, return that name
-        as a directory (with the trailing slash).
-        """
-        names = self._name_set()
-        dirname = name + '/'
-        dir_match = name not in names and dirname in names
-        return dirname if dir_match else name
-
-    @classmethod
-    def make(cls, source):
-        """
-        Given a source (filename or zipfile), return an
-        appropriate CompleteDirs subclass.
-        """
-        if isinstance(source, CompleteDirs):
-            return source
-
-        if not isinstance(source, zipfile.ZipFile):
-            return cls(source)
-
-        # Only allow for FastLookup when supplied zipfile is read-only
-        if 'r' not in source.mode:
-            cls = CompleteDirs
-
-        source.__class__ = cls
-        return source
-
-
-class FastLookup(CompleteDirs):
-    """
-    ZipFile subclass to ensure implicit
-    dirs exist and are resolved rapidly.
-    """
-
-    def namelist(self):
-        with contextlib.suppress(AttributeError):
-            return self.__names
-        self.__names = super(FastLookup, self).namelist()
-        return self.__names
-
-    def _name_set(self):
-        with contextlib.suppress(AttributeError):
-            return self.__lookup
-        self.__lookup = super(FastLookup, self)._name_set()
-        return self.__lookup
-
-
-class Path:
-    """
-    A pathlib-compatible interface for zip files.
-
-    Consider a zip file with this structure::
-
-        .
-        ├── a.txt
-        └── b
-            ├── c.txt
-            └── d
-                └── e.txt
-
-    >>> data = io.BytesIO()
-    >>> zf = zipfile.ZipFile(data, 'w')
-    >>> zf.writestr('a.txt', 'content of a')
-    >>> zf.writestr('b/c.txt', 'content of c')
-    >>> zf.writestr('b/d/e.txt', 'content of e')
-    >>> zf.filename = 'mem/abcde.zip'
-
-    Path accepts the zipfile object itself or a filename
-
-    >>> root = Path(zf)
-
-    From there, several path operations are available.
-
-    Directory iteration (including the zip file itself):
-
-    >>> a, b = root.iterdir()
-    >>> a
-    Path('mem/abcde.zip', 'a.txt')
-    >>> b
-    Path('mem/abcde.zip', 'b/')
-
-    name property:
-
-    >>> b.name
-    'b'
-
-    join with divide operator:
-
-    >>> c = b / 'c.txt'
-    >>> c
-    Path('mem/abcde.zip', 'b/c.txt')
-    >>> c.name
-    'c.txt'
-
-    Read text:
-
-    >>> c.read_text()
-    'content of c'
-
-    existence:
-
-    >>> c.exists()
-    True
-    >>> (b / 'missing.txt').exists()
-    False
-
-    Coercion to string:
-
-    >>> import os
-    >>> str(c).replace(os.sep, posixpath.sep)
-    'mem/abcde.zip/b/c.txt'
-
-    At the root, ``name``, ``filename``, and ``parent``
-    resolve to the zipfile. Note these attributes are not
-    valid and will raise a ``ValueError`` if the zipfile
-    has no filename.
-
-    >>> root.name
-    'abcde.zip'
-    >>> str(root.filename).replace(os.sep, posixpath.sep)
-    'mem/abcde.zip'
-    >>> str(root.parent)
-    'mem'
-    """
-
-    __repr = "{self.__class__.__name__}({self.root.filename!r}, {self.at!r})"
-
-    def __init__(self, root, at=""):
-        """
-        Construct a Path from a ZipFile or filename.
-
-        Note: When the source is an existing ZipFile object,
-        its type (__class__) will be mutated to a
-        specialized type. If the caller wishes to retain the
-        original type, the caller should either create a
-        separate ZipFile object or pass a filename.
-        """
-        self.root = FastLookup.make(root)
-        self.at = at
-
-    def open(self, mode='r', *args, pwd=None, **kwargs):
-        """
-        Open this entry as text or binary following the semantics
-        of ``pathlib.Path.open()`` by passing arguments through
-        to io.TextIOWrapper().
-        """
-        if self.is_dir():
-            raise IsADirectoryError(self)
-        zip_mode = mode[0]
-        if not self.exists() and zip_mode == 'r':
-            raise FileNotFoundError(self)
-        stream = self.root.open(self.at, zip_mode, pwd=pwd)
-        if 'b' in mode:
-            if args or kwargs:
-                raise ValueError("encoding args invalid for binary operation")
-            return stream
-        return io.TextIOWrapper(stream, *args, **kwargs)
-
-    @property
-    def name(self):
-        return pathlib.Path(self.at).name or self.filename.name
-
-    @property
-    def suffix(self):
-        return pathlib.Path(self.at).suffix or self.filename.suffix
-
-    @property
-    def suffixes(self):
-        return pathlib.Path(self.at).suffixes or self.filename.suffixes
-
-    @property
-    def stem(self):
-        return pathlib.Path(self.at).stem or self.filename.stem
-
-    @property
-    def filename(self):
-        return pathlib.Path(self.root.filename).joinpath(self.at)
-
-    def read_text(self, *args, **kwargs):
-        with self.open('r', *args, **kwargs) as strm:
-            return strm.read()
-
-    def read_bytes(self):
-        with self.open('rb') as strm:
-            return strm.read()
-
-    def _is_child(self, path):
-        return posixpath.dirname(path.at.rstrip("/")) == self.at.rstrip("/")
-
-    def _next(self, at):
-        return self.__class__(self.root, at)
-
-    def is_dir(self):
-        return not self.at or self.at.endswith("/")
-
-    def is_file(self):
-        return self.exists() and not self.is_dir()
-
-    def exists(self):
-        return self.at in self.root._name_set()
-
-    def iterdir(self):
-        if not self.is_dir():
-            raise ValueError("Can't listdir a file")
-        subs = map(self._next, self.root.namelist())
-        return filter(self._is_child, subs)
-
-    def __str__(self):
-        return posixpath.join(self.root.filename, self.at)
-
-    def __repr__(self):
-        return self.__repr.format(self=self)
-
-    def joinpath(self, *other):
-        next = posixpath.join(self.at, *other)
-        return self._next(self.root.resolve_dir(next))
-
-    __truediv__ = joinpath
-
-    @property
-    def parent(self):
-        if not self.at:
-            return self.filename.parent
-        parent_at = posixpath.dirname(self.at.rstrip('/'))
-        if parent_at:
-            parent_at += '/'
-        return self._next(parent_at)
diff --git a/requirements.txt b/requirements.txt
index 89a67b60..ab31d952 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -47,7 +47,7 @@ urllib3<2
 webencodings==0.5.1
 websocket-client==1.8.0
 xmltodict==0.14.2
-zipp==3.19.2
+zipp==3.21.0
 
 # configobj==5.1.0
 # sgmllib3k==1.0.0

From 85b63fb61a79215923428d47e620e92aa3cf9516 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 19 Nov 2024 09:34:34 -0800
Subject: [PATCH 683/743] Remove backports.zoneinfo

---
 lib/backports/zoneinfo/__init__.py  |  49 --
 lib/backports/zoneinfo/__init__.pyi |  45 --
 lib/backports/zoneinfo/_common.py   | 171 -------
 lib/backports/zoneinfo/_tzpath.py   | 207 --------
 lib/backports/zoneinfo/_version.py  |   1 -
 lib/backports/zoneinfo/_zoneinfo.py | 754 ----------------------------
 lib/backports/zoneinfo/py.typed     |   0
 requirements.txt                    |   1 -
 8 files changed, 1228 deletions(-)
 delete mode 100644 lib/backports/zoneinfo/__init__.py
 delete mode 100644 lib/backports/zoneinfo/__init__.pyi
 delete mode 100644 lib/backports/zoneinfo/_common.py
 delete mode 100644 lib/backports/zoneinfo/_tzpath.py
 delete mode 100644 lib/backports/zoneinfo/_version.py
 delete mode 100644 lib/backports/zoneinfo/_zoneinfo.py
 delete mode 100644 lib/backports/zoneinfo/py.typed

diff --git a/lib/backports/zoneinfo/__init__.py b/lib/backports/zoneinfo/__init__.py
deleted file mode 100644
index 861fc48e..00000000
--- a/lib/backports/zoneinfo/__init__.py
+++ /dev/null
@@ -1,49 +0,0 @@
-__all__ = [
-    "ZoneInfo",
-    "reset_tzpath",
-    "available_timezones",
-    "TZPATH",
-    "ZoneInfoNotFoundError",
-    "InvalidTZPathWarning",
-]
-import sys
-
-from . import _tzpath
-from ._common import ZoneInfoNotFoundError
-from ._version import __version__
-
-try:
-    from ._czoneinfo import ZoneInfo
-except ImportError:  # pragma: nocover
-    from ._zoneinfo import ZoneInfo
-
-reset_tzpath = _tzpath.reset_tzpath
-available_timezones = _tzpath.available_timezones
-InvalidTZPathWarning = _tzpath.InvalidTZPathWarning
-
-if sys.version_info < (3, 7):
-    # Module-level __getattr__ was added in Python 3.7, so instead of lazily
-    # populating TZPATH on every access, we will register a callback with
-    # reset_tzpath to update the top-level tuple.
-    TZPATH = _tzpath.TZPATH
-
-    def _tzpath_callback(new_tzpath):
-        global TZPATH
-        TZPATH = new_tzpath
-
-    _tzpath.TZPATH_CALLBACKS.append(_tzpath_callback)
-    del _tzpath_callback
-
-else:
-
-    def __getattr__(name):
-        if name == "TZPATH":
-            return _tzpath.TZPATH
-        else:
-            raise AttributeError(
-                f"module {__name__!r} has no attribute {name!r}"
-            )
-
-
-def __dir__():
-    return sorted(list(globals()) + ["TZPATH"])
diff --git a/lib/backports/zoneinfo/__init__.pyi b/lib/backports/zoneinfo/__init__.pyi
deleted file mode 100644
index 6e56abf2..00000000
--- a/lib/backports/zoneinfo/__init__.pyi
+++ /dev/null
@@ -1,45 +0,0 @@
-import os
-import typing
-from datetime import datetime, tzinfo
-from typing import (
-    Any,
-    Iterable,
-    Optional,
-    Protocol,
-    Sequence,
-    Set,
-    Type,
-    Union,
-)
-
-_T = typing.TypeVar("_T", bound="ZoneInfo")
-
-class _IOBytes(Protocol):
-    def read(self, __size: int) -> bytes: ...
-    def seek(self, __size: int, __whence: int = ...) -> Any: ...
-
-class ZoneInfo(tzinfo):
-    @property
-    def key(self) -> str: ...
-    def __init__(self, key: str) -> None: ...
-    @classmethod
-    def no_cache(cls: Type[_T], key: str) -> _T: ...
-    @classmethod
-    def from_file(
-        cls: Type[_T], __fobj: _IOBytes, key: Optional[str] = ...
-    ) -> _T: ...
-    @classmethod
-    def clear_cache(cls, *, only_keys: Iterable[str] = ...) -> None: ...
-
-# Note: Both here and in clear_cache, the types allow the use of `str` where
-# a sequence of strings is required. This should be remedied if a solution
-# to this typing bug is found: https://github.com/python/typing/issues/256
-def reset_tzpath(
-    to: Optional[Sequence[Union[os.PathLike, str]]] = ...
-) -> None: ...
-def available_timezones() -> Set[str]: ...
-
-TZPATH: Sequence[str]
-
-class ZoneInfoNotFoundError(KeyError): ...
-class InvalidTZPathWarning(RuntimeWarning): ...
diff --git a/lib/backports/zoneinfo/_common.py b/lib/backports/zoneinfo/_common.py
deleted file mode 100644
index 27a6ab02..00000000
--- a/lib/backports/zoneinfo/_common.py
+++ /dev/null
@@ -1,171 +0,0 @@
-import struct
-
-
-def load_tzdata(key):
-    try:
-        import importlib.resources as importlib_resources
-    except ImportError:
-        import importlib_resources
-
-    components = key.split("/")
-    package_name = ".".join(["tzdata.zoneinfo"] + components[:-1])
-    resource_name = components[-1]
-
-    try:
-        return importlib_resources.open_binary(package_name, resource_name)
-    except (ImportError, FileNotFoundError, UnicodeEncodeError):
-        # There are three types of exception that can be raised that all amount
-        # to "we cannot find this key":
-        #
-        # ImportError: If package_name doesn't exist (e.g. if tzdata is not
-        #   installed, or if there's an error in the folder name like
-        #   Amrica/New_York)
-        # FileNotFoundError: If resource_name doesn't exist in the package
-        #   (e.g. Europe/Krasnoy)
-        # UnicodeEncodeError: If package_name or resource_name are not UTF-8,
-        #   such as keys containing a surrogate character.
-        raise ZoneInfoNotFoundError(f"No time zone found with key {key}")
-
-
-def load_data(fobj):
-    header = _TZifHeader.from_file(fobj)
-
-    if header.version == 1:
-        time_size = 4
-        time_type = "l"
-    else:
-        # Version 2+ has 64-bit integer transition times
-        time_size = 8
-        time_type = "q"
-
-        # Version 2+ also starts with a Version 1 header and data, which
-        # we need to skip now
-        skip_bytes = (
-            header.timecnt * 5  # Transition times and types
-            + header.typecnt * 6  # Local time type records
-            + header.charcnt  # Time zone designations
-            + header.leapcnt * 8  # Leap second records
-            + header.isstdcnt  # Standard/wall indicators
-            + header.isutcnt  # UT/local indicators
-        )
-
-        fobj.seek(skip_bytes, 1)
-
-        # Now we need to read the second header, which is not the same
-        # as the first
-        header = _TZifHeader.from_file(fobj)
-
-    typecnt = header.typecnt
-    timecnt = header.timecnt
-    charcnt = header.charcnt
-
-    # The data portion starts with timecnt transitions and indices
-    if timecnt:
-        trans_list_utc = struct.unpack(
-            f">{timecnt}{time_type}", fobj.read(timecnt * time_size)
-        )
-        trans_idx = struct.unpack(f">{timecnt}B", fobj.read(timecnt))
-    else:
-        trans_list_utc = ()
-        trans_idx = ()
-
-    # Read the ttinfo struct, (utoff, isdst, abbrind)
-    if typecnt:
-        utcoff, isdst, abbrind = zip(
-            *(struct.unpack(">lbb", fobj.read(6)) for i in range(typecnt))
-        )
-    else:
-        utcoff = ()
-        isdst = ()
-        abbrind = ()
-
-    # Now read the abbreviations. They are null-terminated strings, indexed
-    # not by position in the array but by position in the unsplit
-    # abbreviation string. I suppose this makes more sense in C, which uses
-    # null to terminate the strings, but it's inconvenient here...
-    abbr_vals = {}
-    abbr_chars = fobj.read(charcnt)
-
-    def get_abbr(idx):
-        # Gets a string starting at idx and running until the next \x00
-        #
-        # We cannot pre-populate abbr_vals by splitting on \x00 because there
-        # are some zones that use subsets of longer abbreviations, like so:
-        #
-        #  LMT\x00AHST\x00HDT\x00
-        #
-        # Where the idx to abbr mapping should be:
-        #
-        # {0: "LMT", 4: "AHST", 5: "HST", 9: "HDT"}
-        if idx not in abbr_vals:
-            span_end = abbr_chars.find(b"\x00", idx)
-            abbr_vals[idx] = abbr_chars[idx:span_end].decode()
-
-        return abbr_vals[idx]
-
-    abbr = tuple(get_abbr(idx) for idx in abbrind)
-
-    # The remainder of the file consists of leap seconds (currently unused) and
-    # the standard/wall and ut/local indicators, which are metadata we don't need.
-    # In version 2 files, we need to skip the unnecessary data to get at the TZ string:
-    if header.version >= 2:
-        # Each leap second record has size (time_size + 4)
-        skip_bytes = header.isutcnt + header.isstdcnt + header.leapcnt * 12
-        fobj.seek(skip_bytes, 1)
-
-        c = fobj.read(1)  # Should be \n
-        assert c == b"\n", c
-
-        tz_bytes = b""
-        while True:
-            c = fobj.read(1)
-            if c == b"\n":
-                break
-            tz_bytes += c
-
-        tz_str = tz_bytes
-    else:
-        tz_str = None
-
-    return trans_idx, trans_list_utc, utcoff, isdst, abbr, tz_str
-
-
-class _TZifHeader:
-    __slots__ = [
-        "version",
-        "isutcnt",
-        "isstdcnt",
-        "leapcnt",
-        "timecnt",
-        "typecnt",
-        "charcnt",
-    ]
-
-    def __init__(self, *args):
-        assert len(self.__slots__) == len(args)
-        for attr, val in zip(self.__slots__, args):
-            setattr(self, attr, val)
-
-    @classmethod
-    def from_file(cls, stream):
-        # The header starts with a 4-byte "magic" value
-        if stream.read(4) != b"TZif":
-            raise ValueError("Invalid TZif file: magic not found")
-
-        _version = stream.read(1)
-        if _version == b"\x00":
-            version = 1
-        else:
-            version = int(_version)
-        stream.read(15)
-
-        args = (version,)
-
-        # Slots are defined in the order that the bytes are arranged
-        args = args + struct.unpack(">6l", stream.read(24))
-
-        return cls(*args)
-
-
-class ZoneInfoNotFoundError(KeyError):
-    """Exception raised when a ZoneInfo key is not found."""
diff --git a/lib/backports/zoneinfo/_tzpath.py b/lib/backports/zoneinfo/_tzpath.py
deleted file mode 100644
index 9baaf6bc..00000000
--- a/lib/backports/zoneinfo/_tzpath.py
+++ /dev/null
@@ -1,207 +0,0 @@
-import os
-import sys
-
-PY36 = sys.version_info < (3, 7)
-
-
-def reset_tzpath(to=None):
-    global TZPATH
-
-    tzpaths = to
-    if tzpaths is not None:
-        if isinstance(tzpaths, (str, bytes)):
-            raise TypeError(
-                f"tzpaths must be a list or tuple, "
-                + f"not {type(tzpaths)}: {tzpaths!r}"
-            )
-
-        if not all(map(os.path.isabs, tzpaths)):
-            raise ValueError(_get_invalid_paths_message(tzpaths))
-        base_tzpath = tzpaths
-    else:
-        env_var = os.environ.get("PYTHONTZPATH", None)
-        if env_var is not None:
-            base_tzpath = _parse_python_tzpath(env_var)
-        elif sys.platform != "win32":
-            base_tzpath = [
-                "/usr/share/zoneinfo",
-                "/usr/lib/zoneinfo",
-                "/usr/share/lib/zoneinfo",
-                "/etc/zoneinfo",
-            ]
-
-            base_tzpath.sort(key=lambda x: not os.path.exists(x))
-        else:
-            base_tzpath = ()
-
-    TZPATH = tuple(base_tzpath)
-
-    if TZPATH_CALLBACKS:
-        for callback in TZPATH_CALLBACKS:
-            callback(TZPATH)
-
-
-def _parse_python_tzpath(env_var):
-    if not env_var:
-        return ()
-
-    raw_tzpath = env_var.split(os.pathsep)
-    new_tzpath = tuple(filter(os.path.isabs, raw_tzpath))
-
-    # If anything has been filtered out, we will warn about it
-    if len(new_tzpath) != len(raw_tzpath):
-        import warnings
-
-        msg = _get_invalid_paths_message(raw_tzpath)
-
-        warnings.warn(
-            "Invalid paths specified in PYTHONTZPATH environment variable."
-            + msg,
-            InvalidTZPathWarning,
-        )
-
-    return new_tzpath
-
-
-def _get_invalid_paths_message(tzpaths):
-    invalid_paths = (path for path in tzpaths if not os.path.isabs(path))
-
-    prefix = "\n    "
-    indented_str = prefix + prefix.join(invalid_paths)
-
-    return (
-        "Paths should be absolute but found the following relative paths:"
-        + indented_str
-    )
-
-
-if sys.version_info < (3, 8):
-
-    def _isfile(path):
-        # bpo-33721: In Python 3.8 non-UTF8 paths return False rather than
-        # raising an error. See https://bugs.python.org/issue33721
-        try:
-            return os.path.isfile(path)
-        except ValueError:
-            return False
-
-
-else:
-    _isfile = os.path.isfile
-
-
-def find_tzfile(key):
-    """Retrieve the path to a TZif file from a key."""
-    _validate_tzfile_path(key)
-    for search_path in TZPATH:
-        filepath = os.path.join(search_path, key)
-        if _isfile(filepath):
-            return filepath
-
-    return None
-
-
-_TEST_PATH = os.path.normpath(os.path.join("_", "_"))[:-1]
-
-
-def _validate_tzfile_path(path, _base=_TEST_PATH):
-    if os.path.isabs(path):
-        raise ValueError(
-            f"ZoneInfo keys may not be absolute paths, got: {path}"
-        )
-
-    # We only care about the kinds of path normalizations that would change the
-    # length of the key - e.g. a/../b -> a/b, or a/b/ -> a/b. On Windows,
-    # normpath will also change from a/b to a\b, but that would still preserve
-    # the length.
-    new_path = os.path.normpath(path)
-    if len(new_path) != len(path):
-        raise ValueError(
-            f"ZoneInfo keys must be normalized relative paths, got: {path}"
-        )
-
-    resolved = os.path.normpath(os.path.join(_base, new_path))
-    if not resolved.startswith(_base):
-        raise ValueError(
-            f"ZoneInfo keys must refer to subdirectories of TZPATH, got: {path}"
-        )
-
-
-del _TEST_PATH
-
-
-def available_timezones():
-    """Returns a set containing all available time zones.
-
-    .. caution::
-
-        This may attempt to open a large number of files, since the best way to
-        determine if a given file on the time zone search path is to open it
-        and check for the "magic string" at the beginning.
-    """
-    try:
-        from importlib import resources
-    except ImportError:
-        import importlib_resources as resources
-
-    valid_zones = set()
-
-    # Start with loading from the tzdata package if it exists: this has a
-    # pre-assembled list of zones that only requires opening one file.
-    try:
-        with resources.open_text("tzdata", "zones") as f:
-            for zone in f:
-                zone = zone.strip()
-                if zone:
-                    valid_zones.add(zone)
-    except (ImportError, FileNotFoundError):
-        pass
-
-    def valid_key(fpath):
-        try:
-            with open(fpath, "rb") as f:
-                return f.read(4) == b"TZif"
-        except Exception:  # pragma: nocover
-            return False
-
-    for tz_root in TZPATH:
-        if not os.path.exists(tz_root):
-            continue
-
-        for root, dirnames, files in os.walk(tz_root):
-            if root == tz_root:
-                # right/ and posix/ are special directories and shouldn't be
-                # included in the output of available zones
-                if "right" in dirnames:
-                    dirnames.remove("right")
-                if "posix" in dirnames:
-                    dirnames.remove("posix")
-
-            for file in files:
-                fpath = os.path.join(root, file)
-
-                key = os.path.relpath(fpath, start=tz_root)
-                if os.sep != "/":  # pragma: nocover
-                    key = key.replace(os.sep, "/")
-
-                if not key or key in valid_zones:
-                    continue
-
-                if valid_key(fpath):
-                    valid_zones.add(key)
-
-    if "posixrules" in valid_zones:
-        # posixrules is a special symlink-only time zone where it exists, it
-        # should not be included in the output
-        valid_zones.remove("posixrules")
-
-    return valid_zones
-
-
-class InvalidTZPathWarning(RuntimeWarning):
-    """Warning raised if an invalid path is specified in PYTHONTZPATH."""
-
-
-TZPATH = ()
-TZPATH_CALLBACKS = []
-reset_tzpath()
diff --git a/lib/backports/zoneinfo/_version.py b/lib/backports/zoneinfo/_version.py
deleted file mode 100644
index 3ced3581..00000000
--- a/lib/backports/zoneinfo/_version.py
+++ /dev/null
@@ -1 +0,0 @@
-__version__ = "0.2.1"
diff --git a/lib/backports/zoneinfo/_zoneinfo.py b/lib/backports/zoneinfo/_zoneinfo.py
deleted file mode 100644
index c15a5534..00000000
--- a/lib/backports/zoneinfo/_zoneinfo.py
+++ /dev/null
@@ -1,754 +0,0 @@
-import bisect
-import calendar
-import collections
-import functools
-import re
-import weakref
-from datetime import datetime, timedelta, tzinfo
-
-from . import _common, _tzpath
-
-EPOCH = datetime(1970, 1, 1)
-EPOCHORDINAL = datetime(1970, 1, 1).toordinal()
-
-# It is relatively expensive to construct new timedelta objects, and in most
-# cases we're looking at the same deltas, like integer numbers of hours, etc.
-# To improve speed and memory use, we'll keep a dictionary with references
-# to the ones we've already used so far.
-#
-# Loading every time zone in the 2020a version of the time zone database
-# requires 447 timedeltas, which requires approximately the amount of space
-# that ZoneInfo("America/New_York") with 236 transitions takes up, so we will
-# set the cache size to 512 so that in the common case we always get cache
-# hits, but specifically crafted ZoneInfo objects don't leak arbitrary amounts
-# of memory.
-@functools.lru_cache(maxsize=512)
-def _load_timedelta(seconds):
-    return timedelta(seconds=seconds)
-
-
-class ZoneInfo(tzinfo):
-    _strong_cache_size = 8
-    _strong_cache = collections.OrderedDict()
-    _weak_cache = weakref.WeakValueDictionary()
-    __module__ = "backports.zoneinfo"
-
-    def __init_subclass__(cls):
-        cls._strong_cache = collections.OrderedDict()
-        cls._weak_cache = weakref.WeakValueDictionary()
-
-    def __new__(cls, key):
-        instance = cls._weak_cache.get(key, None)
-        if instance is None:
-            instance = cls._weak_cache.setdefault(key, cls._new_instance(key))
-            instance._from_cache = True
-
-        # Update the "strong" cache
-        cls._strong_cache[key] = cls._strong_cache.pop(key, instance)
-
-        if len(cls._strong_cache) > cls._strong_cache_size:
-            cls._strong_cache.popitem(last=False)
-
-        return instance
-
-    @classmethod
-    def no_cache(cls, key):
-        obj = cls._new_instance(key)
-        obj._from_cache = False
-
-        return obj
-
-    @classmethod
-    def _new_instance(cls, key):
-        obj = super().__new__(cls)
-        obj._key = key
-        obj._file_path = obj._find_tzfile(key)
-
-        if obj._file_path is not None:
-            file_obj = open(obj._file_path, "rb")
-        else:
-            file_obj = _common.load_tzdata(key)
-
-        with file_obj as f:
-            obj._load_file(f)
-
-        return obj
-
-    @classmethod
-    def from_file(cls, fobj, key=None):
-        obj = super().__new__(cls)
-        obj._key = key
-        obj._file_path = None
-        obj._load_file(fobj)
-        obj._file_repr = repr(fobj)
-
-        # Disable pickling for objects created from files
-        obj.__reduce__ = obj._file_reduce
-
-        return obj
-
-    @classmethod
-    def clear_cache(cls, *, only_keys=None):
-        if only_keys is not None:
-            for key in only_keys:
-                cls._weak_cache.pop(key, None)
-                cls._strong_cache.pop(key, None)
-
-        else:
-            cls._weak_cache.clear()
-            cls._strong_cache.clear()
-
-    @property
-    def key(self):
-        return self._key
-
-    def utcoffset(self, dt):
-        return self._find_trans(dt).utcoff
-
-    def dst(self, dt):
-        return self._find_trans(dt).dstoff
-
-    def tzname(self, dt):
-        return self._find_trans(dt).tzname
-
-    def fromutc(self, dt):
-        """Convert from datetime in UTC to datetime in local time"""
-
-        if not isinstance(dt, datetime):
-            raise TypeError("fromutc() requires a datetime argument")
-        if dt.tzinfo is not self:
-            raise ValueError("dt.tzinfo is not self")
-
-        timestamp = self._get_local_timestamp(dt)
-        num_trans = len(self._trans_utc)
-
-        if num_trans >= 1 and timestamp < self._trans_utc[0]:
-            tti = self._tti_before
-            fold = 0
-        elif (
-            num_trans == 0 or timestamp > self._trans_utc[-1]
-        ) and not isinstance(self._tz_after, _ttinfo):
-            tti, fold = self._tz_after.get_trans_info_fromutc(
-                timestamp, dt.year
-            )
-        elif num_trans == 0:
-            tti = self._tz_after
-            fold = 0
-        else:
-            idx = bisect.bisect_right(self._trans_utc, timestamp)
-
-            if num_trans > 1 and timestamp >= self._trans_utc[1]:
-                tti_prev, tti = self._ttinfos[idx - 2 : idx]
-            elif timestamp > self._trans_utc[-1]:
-                tti_prev = self._ttinfos[-1]
-                tti = self._tz_after
-            else:
-                tti_prev = self._tti_before
-                tti = self._ttinfos[0]
-
-            # Detect fold
-            shift = tti_prev.utcoff - tti.utcoff
-            fold = shift.total_seconds() > timestamp - self._trans_utc[idx - 1]
-        dt += tti.utcoff
-        if fold:
-            return dt.replace(fold=1)
-        else:
-            return dt
-
-    def _find_trans(self, dt):
-        if dt is None:
-            if self._fixed_offset:
-                return self._tz_after
-            else:
-                return _NO_TTINFO
-
-        ts = self._get_local_timestamp(dt)
-
-        lt = self._trans_local[dt.fold]
-
-        num_trans = len(lt)
-
-        if num_trans and ts < lt[0]:
-            return self._tti_before
-        elif not num_trans or ts > lt[-1]:
-            if isinstance(self._tz_after, _TZStr):
-                return self._tz_after.get_trans_info(ts, dt.year, dt.fold)
-            else:
-                return self._tz_after
-        else:
-            # idx is the transition that occurs after this timestamp, so we
-            # subtract off 1 to get the current ttinfo
-            idx = bisect.bisect_right(lt, ts) - 1
-            assert idx >= 0
-            return self._ttinfos[idx]
-
-    def _get_local_timestamp(self, dt):
-        return (
-            (dt.toordinal() - EPOCHORDINAL) * 86400
-            + dt.hour * 3600
-            + dt.minute * 60
-            + dt.second
-        )
-
-    def __str__(self):
-        if self._key is not None:
-            return f"{self._key}"
-        else:
-            return repr(self)
-
-    def __repr__(self):
-        if self._key is not None:
-            return f"{self.__class__.__name__}(key={self._key!r})"
-        else:
-            return f"{self.__class__.__name__}.from_file({self._file_repr})"
-
-    def __reduce__(self):
-        return (self.__class__._unpickle, (self._key, self._from_cache))
-
-    def _file_reduce(self):
-        import pickle
-
-        raise pickle.PicklingError(
-            "Cannot pickle a ZoneInfo file created from a file stream."
-        )
-
-    @classmethod
-    def _unpickle(cls, key, from_cache):
-        if from_cache:
-            return cls(key)
-        else:
-            return cls.no_cache(key)
-
-    def _find_tzfile(self, key):
-        return _tzpath.find_tzfile(key)
-
-    def _load_file(self, fobj):
-        # Retrieve all the data as it exists in the zoneinfo file
-        trans_idx, trans_utc, utcoff, isdst, abbr, tz_str = _common.load_data(
-            fobj
-        )
-
-        # Infer the DST offsets (needed for .dst()) from the data
-        dstoff = self._utcoff_to_dstoff(trans_idx, utcoff, isdst)
-
-        # Convert all the transition times (UTC) into "seconds since 1970-01-01 local time"
-        trans_local = self._ts_to_local(trans_idx, trans_utc, utcoff)
-
-        # Construct `_ttinfo` objects for each transition in the file
-        _ttinfo_list = [
-            _ttinfo(
-                _load_timedelta(utcoffset), _load_timedelta(dstoffset), tzname
-            )
-            for utcoffset, dstoffset, tzname in zip(utcoff, dstoff, abbr)
-        ]
-
-        self._trans_utc = trans_utc
-        self._trans_local = trans_local
-        self._ttinfos = [_ttinfo_list[idx] for idx in trans_idx]
-
-        # Find the first non-DST transition
-        for i in range(len(isdst)):
-            if not isdst[i]:
-                self._tti_before = _ttinfo_list[i]
-                break
-        else:
-            if self._ttinfos:
-                self._tti_before = self._ttinfos[0]
-            else:
-                self._tti_before = None
-
-        # Set the "fallback" time zone
-        if tz_str is not None and tz_str != b"":
-            self._tz_after = _parse_tz_str(tz_str.decode())
-        else:
-            if not self._ttinfos and not _ttinfo_list:
-                raise ValueError("No time zone information found.")
-
-            if self._ttinfos:
-                self._tz_after = self._ttinfos[-1]
-            else:
-                self._tz_after = _ttinfo_list[-1]
-
-        # Determine if this is a "fixed offset" zone, meaning that the output
-        # of the utcoffset, dst and tzname functions does not depend on the
-        # specific datetime passed.
-        #
-        # We make three simplifying assumptions here:
-        #
-        # 1. If _tz_after is not a _ttinfo, it has transitions that might
-        #    actually occur (it is possible to construct TZ strings that
-        #    specify STD and DST but no transitions ever occur, such as
-        #    AAA0BBB,0/0,J365/25).
-        # 2. If _ttinfo_list contains more than one _ttinfo object, the objects
-        #    represent different offsets.
-        # 3. _ttinfo_list contains no unused _ttinfos (in which case an
-        #    otherwise fixed-offset zone with extra _ttinfos defined may
-        #    appear to *not* be a fixed offset zone).
-        #
-        # Violations to these assumptions would be fairly exotic, and exotic
-        # zones should almost certainly not be used with datetime.time (the
-        # only thing that would be affected by this).
-        if len(_ttinfo_list) > 1 or not isinstance(self._tz_after, _ttinfo):
-            self._fixed_offset = False
-        elif not _ttinfo_list:
-            self._fixed_offset = True
-        else:
-            self._fixed_offset = _ttinfo_list[0] == self._tz_after
-
-    @staticmethod
-    def _utcoff_to_dstoff(trans_idx, utcoffsets, isdsts):
-        # Now we must transform our ttis and abbrs into `_ttinfo` objects,
-        # but there is an issue: .dst() must return a timedelta with the
-        # difference between utcoffset() and the "standard" offset, but
-        # the "base offset" and "DST offset" are not encoded in the file;
-        # we can infer what they are from the isdst flag, but it is not
-        # sufficient to to just look at the last standard offset, because
-        # occasionally countries will shift both DST offset and base offset.
-
-        typecnt = len(isdsts)
-        dstoffs = [0] * typecnt  # Provisionally assign all to 0.
-        dst_cnt = sum(isdsts)
-        dst_found = 0
-
-        for i in range(1, len(trans_idx)):
-            if dst_cnt == dst_found:
-                break
-
-            idx = trans_idx[i]
-
-            dst = isdsts[idx]
-
-            # We're only going to look at daylight saving time
-            if not dst:
-                continue
-
-            # Skip any offsets that have already been assigned
-            if dstoffs[idx] != 0:
-                continue
-
-            dstoff = 0
-            utcoff = utcoffsets[idx]
-
-            comp_idx = trans_idx[i - 1]
-
-            if not isdsts[comp_idx]:
-                dstoff = utcoff - utcoffsets[comp_idx]
-
-            if not dstoff and idx < (typecnt - 1):
-                comp_idx = trans_idx[i + 1]
-
-                # If the following transition is also DST and we couldn't
-                # find the DST offset by this point, we're going ot have to
-                # skip it and hope this transition gets assigned later
-                if isdsts[comp_idx]:
-                    continue
-
-                dstoff = utcoff - utcoffsets[comp_idx]
-
-            if dstoff:
-                dst_found += 1
-                dstoffs[idx] = dstoff
-        else:
-            # If we didn't find a valid value for a given index, we'll end up
-            # with dstoff = 0 for something where `isdst=1`. This is obviously
-            # wrong - one hour will be a much better guess than 0
-            for idx in range(typecnt):
-                if not dstoffs[idx] and isdsts[idx]:
-                    dstoffs[idx] = 3600
-
-        return dstoffs
-
-    @staticmethod
-    def _ts_to_local(trans_idx, trans_list_utc, utcoffsets):
-        """Generate number of seconds since 1970 *in the local time*.
-
-        This is necessary to easily find the transition times in local time"""
-        if not trans_list_utc:
-            return [[], []]
-
-        # Start with the timestamps and modify in-place
-        trans_list_wall = [list(trans_list_utc), list(trans_list_utc)]
-
-        if len(utcoffsets) > 1:
-            offset_0 = utcoffsets[0]
-            offset_1 = utcoffsets[trans_idx[0]]
-            if offset_1 > offset_0:
-                offset_1, offset_0 = offset_0, offset_1
-        else:
-            offset_0 = offset_1 = utcoffsets[0]
-
-        trans_list_wall[0][0] += offset_0
-        trans_list_wall[1][0] += offset_1
-
-        for i in range(1, len(trans_idx)):
-            offset_0 = utcoffsets[trans_idx[i - 1]]
-            offset_1 = utcoffsets[trans_idx[i]]
-
-            if offset_1 > offset_0:
-                offset_1, offset_0 = offset_0, offset_1
-
-            trans_list_wall[0][i] += offset_0
-            trans_list_wall[1][i] += offset_1
-
-        return trans_list_wall
-
-
-class _ttinfo:
-    __slots__ = ["utcoff", "dstoff", "tzname"]
-
-    def __init__(self, utcoff, dstoff, tzname):
-        self.utcoff = utcoff
-        self.dstoff = dstoff
-        self.tzname = tzname
-
-    def __eq__(self, other):
-        return (
-            self.utcoff == other.utcoff
-            and self.dstoff == other.dstoff
-            and self.tzname == other.tzname
-        )
-
-    def __repr__(self):  # pragma: nocover
-        return (
-            f"{self.__class__.__name__}"
-            + f"({self.utcoff}, {self.dstoff}, {self.tzname})"
-        )
-
-
-_NO_TTINFO = _ttinfo(None, None, None)
-
-
-class _TZStr:
-    __slots__ = (
-        "std",
-        "dst",
-        "start",
-        "end",
-        "get_trans_info",
-        "get_trans_info_fromutc",
-        "dst_diff",
-    )
-
-    def __init__(
-        self, std_abbr, std_offset, dst_abbr, dst_offset, start=None, end=None
-    ):
-        self.dst_diff = dst_offset - std_offset
-        std_offset = _load_timedelta(std_offset)
-        self.std = _ttinfo(
-            utcoff=std_offset, dstoff=_load_timedelta(0), tzname=std_abbr
-        )
-
-        self.start = start
-        self.end = end
-
-        dst_offset = _load_timedelta(dst_offset)
-        delta = _load_timedelta(self.dst_diff)
-        self.dst = _ttinfo(utcoff=dst_offset, dstoff=delta, tzname=dst_abbr)
-
-        # These are assertions because the constructor should only be called
-        # by functions that would fail before passing start or end
-        assert start is not None, "No transition start specified"
-        assert end is not None, "No transition end specified"
-
-        self.get_trans_info = self._get_trans_info
-        self.get_trans_info_fromutc = self._get_trans_info_fromutc
-
-    def transitions(self, year):
-        start = self.start.year_to_epoch(year)
-        end = self.end.year_to_epoch(year)
-        return start, end
-
-    def _get_trans_info(self, ts, year, fold):
-        """Get the information about the current transition - tti"""
-        start, end = self.transitions(year)
-
-        # With fold = 0, the period (denominated in local time) with the
-        # smaller offset starts at the end of the gap and ends at the end of
-        # the fold; with fold = 1, it runs from the start of the gap to the
-        # beginning of the fold.
-        #
-        # So in order to determine the DST boundaries we need to know both
-        # the fold and whether DST is positive or negative (rare), and it
-        # turns out that this boils down to fold XOR is_positive.
-        if fold == (self.dst_diff >= 0):
-            end -= self.dst_diff
-        else:
-            start += self.dst_diff
-
-        if start < end:
-            isdst = start <= ts < end
-        else:
-            isdst = not (end <= ts < start)
-
-        return self.dst if isdst else self.std
-
-    def _get_trans_info_fromutc(self, ts, year):
-        start, end = self.transitions(year)
-        start -= self.std.utcoff.total_seconds()
-        end -= self.dst.utcoff.total_seconds()
-
-        if start < end:
-            isdst = start <= ts < end
-        else:
-            isdst = not (end <= ts < start)
-
-        # For positive DST, the ambiguous period is one dst_diff after the end
-        # of DST; for negative DST, the ambiguous period is one dst_diff before
-        # the start of DST.
-        if self.dst_diff > 0:
-            ambig_start = end
-            ambig_end = end + self.dst_diff
-        else:
-            ambig_start = start
-            ambig_end = start - self.dst_diff
-
-        fold = ambig_start <= ts < ambig_end
-
-        return (self.dst if isdst else self.std, fold)
-
-
-def _post_epoch_days_before_year(year):
-    """Get the number of days between 1970-01-01 and YEAR-01-01"""
-    y = year - 1
-    return y * 365 + y // 4 - y // 100 + y // 400 - EPOCHORDINAL
-
-
-class _DayOffset:
-    __slots__ = ["d", "julian", "hour", "minute", "second"]
-
-    def __init__(self, d, julian, hour=2, minute=0, second=0):
-        if not (0 + julian) <= d <= 365:
-            min_day = 0 + julian
-            raise ValueError(f"d must be in [{min_day}, 365], not: {d}")
-
-        self.d = d
-        self.julian = julian
-        self.hour = hour
-        self.minute = minute
-        self.second = second
-
-    def year_to_epoch(self, year):
-        days_before_year = _post_epoch_days_before_year(year)
-
-        d = self.d
-        if self.julian and d >= 59 and calendar.isleap(year):
-            d += 1
-
-        epoch = (days_before_year + d) * 86400
-        epoch += self.hour * 3600 + self.minute * 60 + self.second
-
-        return epoch
-
-
-class _CalendarOffset:
-    __slots__ = ["m", "w", "d", "hour", "minute", "second"]
-
-    _DAYS_BEFORE_MONTH = (
-        -1,
-        0,
-        31,
-        59,
-        90,
-        120,
-        151,
-        181,
-        212,
-        243,
-        273,
-        304,
-        334,
-    )
-
-    def __init__(self, m, w, d, hour=2, minute=0, second=0):
-        if not 0 < m <= 12:
-            raise ValueError("m must be in (0, 12]")
-
-        if not 0 < w <= 5:
-            raise ValueError("w must be in (0, 5]")
-
-        if not 0 <= d <= 6:
-            raise ValueError("d must be in [0, 6]")
-
-        self.m = m
-        self.w = w
-        self.d = d
-        self.hour = hour
-        self.minute = minute
-        self.second = second
-
-    @classmethod
-    def _ymd2ord(cls, year, month, day):
-        return (
-            _post_epoch_days_before_year(year)
-            + cls._DAYS_BEFORE_MONTH[month]
-            + (month > 2 and calendar.isleap(year))
-            + day
-        )
-
-    # TODO: These are not actually epoch dates as they are expressed in local time
-    def year_to_epoch(self, year):
-        """Calculates the datetime of the occurrence from the year"""
-        # We know year and month, we need to convert w, d into day of month
-        #
-        # Week 1 is the first week in which day `d` (where 0 = Sunday) appears.
-        # Week 5 represents the last occurrence of day `d`, so we need to know
-        # the range of the month.
-        first_day, days_in_month = calendar.monthrange(year, self.m)
-
-        # This equation seems magical, so I'll break it down:
-        # 1. calendar says 0 = Monday, POSIX says 0 = Sunday
-        #    so we need first_day + 1 to get 1 = Monday -> 7 = Sunday,
-        #    which is still equivalent because this math is mod 7
-        # 2. Get first day - desired day mod 7: -1 % 7 = 6, so we don't need
-        #    to do anything to adjust negative numbers.
-        # 3. Add 1 because month days are a 1-based index.
-        month_day = (self.d - (first_day + 1)) % 7 + 1
-
-        # Now use a 0-based index version of `w` to calculate the w-th
-        # occurrence of `d`
-        month_day += (self.w - 1) * 7
-
-        # month_day will only be > days_in_month if w was 5, and `w` means
-        # "last occurrence of `d`", so now we just check if we over-shot the
-        # end of the month and if so knock off 1 week.
-        if month_day > days_in_month:
-            month_day -= 7
-
-        ordinal = self._ymd2ord(year, self.m, month_day)
-        epoch = ordinal * 86400
-        epoch += self.hour * 3600 + self.minute * 60 + self.second
-        return epoch
-
-
-def _parse_tz_str(tz_str):
-    # The tz string has the format:
-    #
-    # std[offset[dst[offset],start[/time],end[/time]]]
-    #
-    # std and dst must be 3 or more characters long and must not contain
-    # a leading colon, embedded digits, commas, nor a plus or minus signs;
-    # The spaces between "std" and "offset" are only for display and are
-    # not actually present in the string.
-    #
-    # The format of the offset is ``[+|-]hh[:mm[:ss]]``
-
-    offset_str, *start_end_str = tz_str.split(",", 1)
-
-    # fmt: off
-    parser_re = re.compile(
-        r"(?P<std>[^<0-9:.+-]+|<[a-zA-Z0-9+\-]+>)" +
-        r"((?P<stdoff>[+-]?\d{1,2}(:\d{2}(:\d{2})?)?)" +
-            r"((?P<dst>[^0-9:.+-]+|<[a-zA-Z0-9+\-]+>)" +
-                r"((?P<dstoff>[+-]?\d{1,2}(:\d{2}(:\d{2})?)?))?" +
-            r")?" + # dst
-        r")?$" # stdoff
-    )
-    # fmt: on
-
-    m = parser_re.match(offset_str)
-
-    if m is None:
-        raise ValueError(f"{tz_str} is not a valid TZ string")
-
-    std_abbr = m.group("std")
-    dst_abbr = m.group("dst")
-    dst_offset = None
-
-    std_abbr = std_abbr.strip("<>")
-
-    if dst_abbr:
-        dst_abbr = dst_abbr.strip("<>")
-
-    std_offset = m.group("stdoff")
-    if std_offset:
-        try:
-            std_offset = _parse_tz_delta(std_offset)
-        except ValueError as e:
-            raise ValueError(f"Invalid STD offset in {tz_str}") from e
-    else:
-        std_offset = 0
-
-    if dst_abbr is not None:
-        dst_offset = m.group("dstoff")
-        if dst_offset:
-            try:
-                dst_offset = _parse_tz_delta(dst_offset)
-            except ValueError as e:
-                raise ValueError(f"Invalid DST offset in {tz_str}") from e
-        else:
-            dst_offset = std_offset + 3600
-
-        if not start_end_str:
-            raise ValueError(f"Missing transition rules: {tz_str}")
-
-        start_end_strs = start_end_str[0].split(",", 1)
-        try:
-            start, end = (_parse_dst_start_end(x) for x in start_end_strs)
-        except ValueError as e:
-            raise ValueError(f"Invalid TZ string: {tz_str}") from e
-
-        return _TZStr(std_abbr, std_offset, dst_abbr, dst_offset, start, end)
-    elif start_end_str:
-        raise ValueError(f"Transition rule present without DST: {tz_str}")
-    else:
-        # This is a static ttinfo, don't return _TZStr
-        return _ttinfo(
-            _load_timedelta(std_offset), _load_timedelta(0), std_abbr
-        )
-
-
-def _parse_dst_start_end(dststr):
-    date, *time = dststr.split("/")
-    if date[0] == "M":
-        n_is_julian = False
-        m = re.match(r"M(\d{1,2})\.(\d).(\d)$", date)
-        if m is None:
-            raise ValueError(f"Invalid dst start/end date: {dststr}")
-        date_offset = tuple(map(int, m.groups()))
-        offset = _CalendarOffset(*date_offset)
-    else:
-        if date[0] == "J":
-            n_is_julian = True
-            date = date[1:]
-        else:
-            n_is_julian = False
-
-        doy = int(date)
-        offset = _DayOffset(doy, n_is_julian)
-
-    if time:
-        time_components = list(map(int, time[0].split(":")))
-        n_components = len(time_components)
-        if n_components < 3:
-            time_components.extend([0] * (3 - n_components))
-        offset.hour, offset.minute, offset.second = time_components
-
-    return offset
-
-
-def _parse_tz_delta(tz_delta):
-    match = re.match(
-        r"(?P<sign>[+-])?(?P<h>\d{1,2})(:(?P<m>\d{2})(:(?P<s>\d{2}))?)?",
-        tz_delta,
-    )
-    # Anything passed to this function should already have hit an equivalent
-    # regular expression to find the section to parse.
-    assert match is not None, tz_delta
-
-    h, m, s = (
-        int(v) if v is not None else 0
-        for v in map(match.group, ("h", "m", "s"))
-    )
-
-    total = h * 3600 + m * 60 + s
-
-    if not -86400 < total < 86400:
-        raise ValueError(
-            "Offset must be strictly between -24h and +24h:" + tz_delta
-        )
-
-    # Yes, +5 maps to an offset of -5h
-    if match.group("sign") != "-":
-        total *= -1
-
-    return total
diff --git a/lib/backports/zoneinfo/py.typed b/lib/backports/zoneinfo/py.typed
deleted file mode 100644
index e69de29b..00000000
diff --git a/requirements.txt b/requirements.txt
index ab31d952..2d7d5a9b 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,6 +1,5 @@
 apscheduler==3.10.1
 arrow==1.3.0
-backports.zoneinfo==0.2.1;python_version<"3.9"
 beautifulsoup4==4.12.3
 bleach==6.1.0
 certifi==2024.8.30

From baf926e5db82eafa5fbf4e80ab325528cffa8491 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 19 Nov 2024 09:59:40 -0800
Subject: [PATCH 684/743] Bump markupsafe from 2.1.5 to 3.0.2 (#2435)

Bumps [markupsafe](https://github.com/pallets/markupsafe) from 2.1.5 to 3.0.2.
- [Release notes](https://github.com/pallets/markupsafe/releases)
- [Changelog](https://github.com/pallets/markupsafe/blob/main/CHANGES.rst)
- [Commits](https://github.com/pallets/markupsafe/compare/2.1.5...3.0.2)

---
updated-dependencies:
- dependency-name: markupsafe
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements.txt b/requirements.txt
index 2d7d5a9b..e91d999f 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -20,7 +20,7 @@ importlib-resources==6.4.5
 git+https://github.com/Tautulli/ipwhois.git@master#egg=ipwhois
 IPy==1.01
 Mako==1.3.6
-MarkupSafe==2.1.5
+MarkupSafe==3.0.2
 musicbrainzngs==0.7.1
 packaging==24.2
 paho-mqtt==2.1.0

From 2fe3f039cc8f39cd7365be9c2e037345ac8db55b Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 19 Nov 2024 09:59:58 -0800
Subject: [PATCH 685/743] Bump tokenize-rt from 6.0.0 to 6.1.0 (#2436)

* Bump tokenize-rt from 6.0.0 to 6.1.0

Bumps [tokenize-rt](https://github.com/asottile/tokenize-rt) from 6.0.0 to 6.1.0.
- [Commits](https://github.com/asottile/tokenize-rt/compare/v6.0.0...v6.1.0)

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

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

* Update tokenize-rt==6.1.0

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/tokenize_rt.py | 24 ++++++++++++++++++------
 requirements.txt   |  2 +-
 2 files changed, 19 insertions(+), 7 deletions(-)

diff --git a/lib/tokenize_rt.py b/lib/tokenize_rt.py
index 9f12e01f..f909ead7 100644
--- a/lib/tokenize_rt.py
+++ b/lib/tokenize_rt.py
@@ -6,11 +6,11 @@ import keyword
 import re
 import sys
 import tokenize
-from typing import Generator
-from typing import Iterable
+from collections.abc import Generator
+from collections.abc import Iterable
+from collections.abc import Sequence
+from re import Pattern
 from typing import NamedTuple
-from typing import Pattern
-from typing import Sequence
 
 # this is a performance hack.  see https://bugs.python.org/issue43014
 if (  # pragma: no branch
@@ -47,6 +47,16 @@ class Token(NamedTuple):
 _string_re = re.compile('^([^\'"]*)(.*)$', re.DOTALL)
 _escaped_nl_re = re.compile(r'\\(\n|\r\n|\r)')
 
+NAMED_UNICODE_RE = re.compile(r'(?<!\\)(?:\\\\)*(\\N\{[^}]+\})')
+
+
+def curly_escape(s: str) -> str:
+    parts = NAMED_UNICODE_RE.split(s)
+    return ''.join(
+        part.replace('{', '{{').replace('}', '}}') if i % 2 == 0 else part
+        for i, part in enumerate(parts)
+    )
+
 
 def _re_partition(regex: Pattern[str], s: str) -> tuple[str, str, str]:
     match = regex.search(s)
@@ -101,8 +111,10 @@ def src_to_tokens(src: str) -> list[Token]:
         tok_name = tokenize.tok_name[tok_type]
 
         if tok_name == 'FSTRING_MIDDLE':  # pragma: >=3.12 cover
-            ecol += tok_text.count('{') + tok_text.count('}')
-            tok_text = tok_text.replace('{', '{{').replace('}', '}}')
+            if '{' in tok_text or '}' in tok_text:
+                new_tok_text = curly_escape(tok_text)
+                ecol += len(new_tok_text) - len(tok_text)
+                tok_text = new_tok_text
 
         tokens.append(Token(tok_name, tok_text, sline, end_offset))
         last_line, last_col = eline, ecol
diff --git a/requirements.txt b/requirements.txt
index e91d999f..01bdd50d 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -39,7 +39,7 @@ rumps==0.4.0; platform_system == "Darwin"
 simplejson==3.19.3
 six==1.16.0
 tempora==5.7.0
-tokenize-rt==6.0.0
+tokenize-rt==6.1.0
 tzdata==2024.2
 tzlocal==5.0.1
 urllib3<2

From be2e63e7e0e2cae014801f63fb9766f01dd09645 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 19 Nov 2024 10:00:11 -0800
Subject: [PATCH 686/743] Bump pyparsing from 3.1.4 to 3.2.0 (#2437)

* Bump pyparsing from 3.1.4 to 3.2.0

Bumps [pyparsing](https://github.com/pyparsing/pyparsing) from 3.1.4 to 3.2.0.
- [Release notes](https://github.com/pyparsing/pyparsing/releases)
- [Changelog](https://github.com/pyparsing/pyparsing/blob/master/CHANGES)
- [Commits](https://github.com/pyparsing/pyparsing/compare/3.1.4...3.2.0)

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

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

* Update pyparsing==3.2.0

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/pyparsing/__init__.py         |  13 +-
 lib/pyparsing/core.py             | 403 ++++++++++++++++++------------
 lib/pyparsing/diagram/__init__.py |  99 ++++----
 lib/pyparsing/exceptions.py       |  85 ++++---
 lib/pyparsing/helpers.py          |  62 ++---
 lib/pyparsing/results.py          |  70 ++++--
 lib/pyparsing/testing.py          |  39 ++-
 lib/pyparsing/unicode.py          |  10 +-
 lib/pyparsing/util.py             | 214 ++++++++++++----
 requirements.txt                  |   2 +-
 10 files changed, 624 insertions(+), 373 deletions(-)

diff --git a/lib/pyparsing/__init__.py b/lib/pyparsing/__init__.py
index a440cfbe..543ceb62 100644
--- a/lib/pyparsing/__init__.py
+++ b/lib/pyparsing/__init__.py
@@ -120,8 +120,8 @@ class version_info(NamedTuple):
         return f"{__name__}.{type(self).__name__}({', '.join('{}={!r}'.format(*nv) for nv in zip(self._fields, self))})"
 
 
-__version_info__ = version_info(3, 1, 4, "final", 1)
-__version_time__ = "25 Aug 2024 14:40 UTC"
+__version_info__ = version_info(3, 2, 0, "final", 1)
+__version_time__ = "13 Oct 2024 09:46 UTC"
 __version__ = __version_info__.__version__
 __versionTime__ = __version_time__
 __author__ = "Paul McGuire <ptmcg.gm+pyparsing@gmail.com>"
@@ -131,9 +131,9 @@ from .exceptions import *
 from .actions import *
 from .core import __diag__, __compat__
 from .results import *
-from .core import *  # type: ignore[misc, assignment]
+from .core import *
 from .core import _builtin_exprs as core_builtin_exprs
-from .helpers import *  # type: ignore[misc, assignment]
+from .helpers import *
 from .helpers import _builtin_exprs as helper_builtin_exprs
 
 from .unicode import unicode_set, UnicodeRangeList, pyparsing_unicode as unicode
@@ -147,9 +147,9 @@ from .common import (
 if "pyparsing_unicode" not in globals():
     pyparsing_unicode = unicode  # type: ignore[misc]
 if "pyparsing_common" not in globals():
-    pyparsing_common = common  # type: ignore[misc]
+    pyparsing_common = common
 if "pyparsing_test" not in globals():
-    pyparsing_test = testing  # type: ignore[misc]
+    pyparsing_test = testing
 
 core_builtin_exprs += common_builtin_exprs + helper_builtin_exprs
 
@@ -208,6 +208,7 @@ __all__ = [
     "StringEnd",
     "StringStart",
     "Suppress",
+    "Tag",
     "Token",
     "TokenConverter",
     "White",
diff --git a/lib/pyparsing/core.py b/lib/pyparsing/core.py
index cbe73c98..4f43c3bf 100644
--- a/lib/pyparsing/core.py
+++ b/lib/pyparsing/core.py
@@ -1,7 +1,9 @@
 #
 # core.py
 #
+from __future__ import annotations
 
+import collections.abc
 from collections import deque
 import os
 import typing
@@ -9,12 +11,9 @@ from typing import (
     Any,
     Callable,
     Generator,
-    List,
     NamedTuple,
     Sequence,
-    Set,
     TextIO,
-    Tuple,
     Union,
     cast,
 )
@@ -51,12 +50,7 @@ from .results import ParseResults, _ParseResultsWithOffset
 from .unicode import pyparsing_unicode
 
 _MAX_INT = sys.maxsize
-str_type: Tuple[type, ...] = (str, bytes)
-
-if sys.version_info >= (3, 7):
-    _RePattern = re.Pattern
-else:
-    _RePattern = typing.Pattern
+str_type: tuple[type, ...] = (str, bytes)
 
 #
 # Copyright (c) 2003-2022  Paul T. McGuire
@@ -81,18 +75,7 @@ else:
 # SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 #
 
-
-if sys.version_info >= (3, 8):
-    from functools import cached_property
-else:
-
-    class cached_property:
-        def __init__(self, func):
-            self._func = func
-
-        def __get__(self, instance, owner=None):
-            ret = instance.__dict__[self._func.__name__] = self._func(instance)
-            return ret
+from functools import cached_property
 
 
 class __compat__(__config_flags):
@@ -230,7 +213,7 @@ _single_arg_builtins = {
 # fmt: on
 
 _generatorType = types.GeneratorType
-ParseImplReturnType = Tuple[int, Any]
+ParseImplReturnType = tuple[int, Any]
 PostParseReturnType = Union[ParseResults, Sequence[ParseResults]]
 ParseAction = Union[
     Callable[[], Any],
@@ -260,12 +243,26 @@ hexnums: str = nums + "ABCDEFabcdef"
 alphanums: str = alphas + nums
 printables: str = "".join([c for c in string.printable if c not in string.whitespace])
 
+
+class _ParseActionIndexError(Exception):
+    """
+    Internal wrapper around IndexError so that IndexErrors raised inside
+    parse actions aren't misinterpreted as IndexErrors raised inside
+    ParserElement parseImpl methods.
+    """
+
+    def __init__(self, msg: str, exc: BaseException):
+        self.msg: str = msg
+        self.exc: BaseException = exc
+
+
 _trim_arity_call_line: traceback.StackSummary = None  # type: ignore[assignment]
+pa_call_line_synth = ()
 
 
 def _trim_arity(func, max_limit=3):
     """decorator to trim function calls to match the arity of the target"""
-    global _trim_arity_call_line
+    global _trim_arity_call_line, pa_call_line_synth
 
     if func in _single_arg_builtins:
         return lambda s, l, t: func(t)
@@ -280,8 +277,8 @@ def _trim_arity(func, max_limit=3):
     LINE_DIFF = 9
     # IF ANY CODE CHANGES, EVEN JUST COMMENTS OR BLANK LINES, BETWEEN THE NEXT LINE AND
     # THE CALL TO FUNC INSIDE WRAPPER, LINE_DIFF MUST BE MODIFIED!!!!
-    _trim_arity_call_line = (_trim_arity_call_line or traceback.extract_stack(limit=2)[-1])
-    pa_call_line_synth = (_trim_arity_call_line[0], _trim_arity_call_line[1] + LINE_DIFF)
+    _trim_arity_call_line = _trim_arity_call_line or traceback.extract_stack(limit=2)[-1]
+    pa_call_line_synth = pa_call_line_synth or (_trim_arity_call_line[0], _trim_arity_call_line[1] + LINE_DIFF)
 
     def wrapper(*args):
         nonlocal found_arity, limit
@@ -311,6 +308,11 @@ def _trim_arity(func, max_limit=3):
                             continue
 
                     raise
+            except IndexError as ie:
+                # wrap IndexErrors inside a _ParseActionIndexError
+                raise _ParseActionIndexError(
+                    "IndexError raised in parse action", ie
+                ).with_traceback(None)
     # fmt: on
 
     # copy func name to wrapper for sensible debug output
@@ -351,7 +353,7 @@ def condition_as_parse_action(
 
 
 def _default_start_debug_action(
-    instring: str, loc: int, expr: "ParserElement", cache_hit: bool = False
+    instring: str, loc: int, expr: ParserElement, cache_hit: bool = False
 ):
     cache_hit_str = "*" if cache_hit else ""
     print(
@@ -367,7 +369,7 @@ def _default_success_debug_action(
     instring: str,
     startloc: int,
     endloc: int,
-    expr: "ParserElement",
+    expr: ParserElement,
     toks: ParseResults,
     cache_hit: bool = False,
 ):
@@ -378,7 +380,7 @@ def _default_success_debug_action(
 def _default_exception_debug_action(
     instring: str,
     loc: int,
-    expr: "ParserElement",
+    expr: ParserElement,
     exc: Exception,
     cache_hit: bool = False,
 ):
@@ -443,7 +445,7 @@ class ParserElement(ABC):
     @classmethod
     def using_each(cls, seq, **class_kwargs):
         """
-        Yields a sequence of class(obj, **class_kwargs) for obj in seq.
+        Yields a sequence of ``class(obj, **class_kwargs)`` for obj in seq.
 
         Example::
 
@@ -458,7 +460,7 @@ class ParserElement(ABC):
         debug_fail: typing.Optional[DebugExceptionAction]
 
     def __init__(self, savelist: bool = False):
-        self.parseAction: List[ParseAction] = list()
+        self.parseAction: list[ParseAction] = list()
         self.failAction: typing.Optional[ParseFailAction] = None
         self.customName: str = None  # type: ignore[assignment]
         self._defaultName: typing.Optional[str] = None
@@ -470,7 +472,7 @@ class ParserElement(ABC):
         # used when checking for left-recursion
         self.mayReturnEmpty = False
         self.keepTabs = False
-        self.ignoreExprs: List["ParserElement"] = list()
+        self.ignoreExprs: list[ParserElement] = list()
         self.debug = False
         self.streamlined = False
         # optimize exception handling for subclasses that don't advance parse index
@@ -483,9 +485,9 @@ class ParserElement(ABC):
         # avoid redundant calls to preParse
         self.callPreparse = True
         self.callDuringTry = False
-        self.suppress_warnings_: List[Diagnostics] = []
+        self.suppress_warnings_: list[Diagnostics] = []
 
-    def suppress_warning(self, warning_type: Diagnostics) -> "ParserElement":
+    def suppress_warning(self, warning_type: Diagnostics) -> ParserElement:
         """
         Suppress warnings emitted for a particular diagnostic on this expression.
 
@@ -518,7 +520,7 @@ class ParserElement(ABC):
             to_visit.extend(cur.recurse())
             yield cur
 
-    def copy(self) -> "ParserElement":
+    def copy(self) -> ParserElement:
         """
         Make a copy of this :class:`ParserElement`.  Useful for defining
         different parse actions for the same parsing pattern, using copies of
@@ -549,7 +551,7 @@ class ParserElement(ABC):
 
     def set_results_name(
         self, name: str, list_all_matches: bool = False, *, listAllMatches: bool = False
-    ) -> "ParserElement":
+    ) -> ParserElement:
         """
         Define name for referencing matching tokens as a nested attribute
         of the returned parse results.
@@ -581,7 +583,7 @@ class ParserElement(ABC):
         listAllMatches = listAllMatches or list_all_matches
         return self._setResultsName(name, listAllMatches)
 
-    def _setResultsName(self, name, list_all_matches=False) -> "ParserElement":
+    def _setResultsName(self, name, list_all_matches=False) -> ParserElement:
         if name is None:
             return self
         newself = self.copy()
@@ -592,7 +594,7 @@ class ParserElement(ABC):
         newself.modalResults = not list_all_matches
         return newself
 
-    def set_break(self, break_flag: bool = True) -> "ParserElement":
+    def set_break(self, break_flag: bool = True) -> ParserElement:
         """
         Method to invoke the Python pdb debugger when this element is
         about to be parsed. Set ``break_flag`` to ``True`` to enable, ``False`` to
@@ -602,19 +604,17 @@ class ParserElement(ABC):
             _parseMethod = self._parse
 
             def breaker(instring, loc, do_actions=True, callPreParse=True):
-                import pdb
-
-                # this call to pdb.set_trace() is intentional, not a checkin error
-                pdb.set_trace()
+                # this call to breakpoint() is intentional, not a checkin error
+                breakpoint()
                 return _parseMethod(instring, loc, do_actions, callPreParse)
 
             breaker._originalParseMethod = _parseMethod  # type: ignore [attr-defined]
-            self._parse = breaker  # type: ignore [assignment]
+            self._parse = breaker  # type: ignore [method-assign]
         elif hasattr(self._parse, "_originalParseMethod"):
-            self._parse = self._parse._originalParseMethod  # type: ignore [attr-defined, assignment]
+            self._parse = self._parse._originalParseMethod  # type: ignore [method-assign]
         return self
 
-    def set_parse_action(self, *fns: ParseAction, **kwargs: Any) -> "ParserElement":
+    def set_parse_action(self, *fns: ParseAction, **kwargs: Any) -> ParserElement:
         """
         Define one or more actions to perform when successfully matching parse element definition.
 
@@ -702,7 +702,7 @@ class ParserElement(ABC):
 
         return self
 
-    def add_parse_action(self, *fns: ParseAction, **kwargs: Any) -> "ParserElement":
+    def add_parse_action(self, *fns: ParseAction, **kwargs: Any) -> ParserElement:
         """
         Add one or more parse actions to expression's list of parse actions. See :class:`set_parse_action`.
 
@@ -714,7 +714,7 @@ class ParserElement(ABC):
         )
         return self
 
-    def add_condition(self, *fns: ParseCondition, **kwargs: Any) -> "ParserElement":
+    def add_condition(self, *fns: ParseCondition, **kwargs: Any) -> ParserElement:
         """Add a boolean predicate function to expression's list of parse actions. See
         :class:`set_parse_action` for function call signatures. Unlike ``set_parse_action``,
         functions passed to ``add_condition`` need to return boolean success/fail of the condition.
@@ -751,7 +751,7 @@ class ParserElement(ABC):
         )
         return self
 
-    def set_fail_action(self, fn: ParseFailAction) -> "ParserElement":
+    def set_fail_action(self, fn: ParseFailAction) -> ParserElement:
         """
         Define action to perform if parsing fails at this expression.
         Fail acton fn is a callable function that takes the arguments
@@ -809,8 +809,7 @@ class ParserElement(ABC):
     # @profile
     def _parseNoCache(
         self, instring, loc, do_actions=True, callPreParse=True
-    ) -> Tuple[int, ParseResults]:
-        TRY, MATCH, FAIL = 0, 1, 2
+    ) -> tuple[int, ParseResults]:
         debugging = self.debug  # and do_actions)
         len_instring = len(instring)
 
@@ -934,25 +933,42 @@ class ParserElement(ABC):
 
     # cache for left-recursion in Forward references
     recursion_lock = RLock()
-    recursion_memos: typing.Dict[
-        Tuple[int, "Forward", bool], Tuple[int, Union[ParseResults, Exception]]
+    recursion_memos: collections.abc.MutableMapping[
+        tuple[int, Forward, bool], tuple[int, Union[ParseResults, Exception]]
     ] = {}
 
-    class _CacheType(dict):
+    class _CacheType(typing.Protocol):
         """
-        class to help type checking
+        Class to be used for packrat and left-recursion cacheing of results
+        and exceptions.
         """
 
         not_in_cache: bool
 
-        def get(self, *args): ...
+        def get(self, *args) -> typing.Any: ...
 
-        def set(self, *args): ...
+        def set(self, *args) -> None: ...
 
-    # argument cache for optimizing repeated calls when backtracking through recursive expressions
-    packrat_cache = (
-        _CacheType()
-    )  # set later by enable_packrat(); this is here so that reset_cache() doesn't fail
+        def clear(self) -> None: ...
+
+    class NullCache(dict):
+        """
+        A null cache type for initialization of the packrat_cache class variable.
+        If/when enable_packrat() is called, this null cache will be replaced by a
+        proper _CacheType class instance.
+        """
+
+        not_in_cache: bool = True
+
+        def get(self, *args) -> typing.Any: ...
+
+        def set(self, *args) -> None: ...
+
+        def clear(self) -> None: ...
+
+    # class-level argument cache for optimizing repeated calls when backtracking
+    # through recursive expressions
+    packrat_cache: _CacheType = NullCache()
     packrat_cache_lock = RLock()
     packrat_cache_stats = [0, 0]
 
@@ -960,9 +976,8 @@ class ParserElement(ABC):
     # we can cache these arguments and save ourselves the trouble of re-parsing the contained expression
     def _parseCache(
         self, instring, loc, do_actions=True, callPreParse=True
-    ) -> Tuple[int, ParseResults]:
+    ) -> tuple[int, ParseResults]:
         HIT, MISS = 0, 1
-        TRY, MATCH, FAIL = 0, 1, 2
         lookup = (self, instring, loc, callPreParse, do_actions)
         with ParserElement.packrat_cache_lock:
             cache = ParserElement.packrat_cache
@@ -995,7 +1010,7 @@ class ParserElement(ABC):
                             pass
                     raise value
 
-                value = cast(Tuple[int, ParseResults, int], value)
+                value = cast(tuple[int, ParseResults, int], value)
                 loc_, result, endloc = value[0], value[1].copy(), value[2]
                 if self.debug and self.debugActions.debug_match:
                     try:
@@ -1075,7 +1090,7 @@ class ParserElement(ABC):
         elif ParserElement._packratEnabled:
             raise RuntimeError("Packrat and Bounded Recursion are not compatible")
         if cache_size_limit is None:
-            ParserElement.recursion_memos = _UnboundedMemo()  # type: ignore[assignment]
+            ParserElement.recursion_memos = _UnboundedMemo()
         elif cache_size_limit > 0:
             ParserElement.recursion_memos = _LRUMemo(capacity=cache_size_limit)  # type: ignore[assignment]
         else:
@@ -1128,7 +1143,7 @@ class ParserElement(ABC):
         if cache_size_limit is None:
             ParserElement.packrat_cache = _UnboundedCache()
         else:
-            ParserElement.packrat_cache = _FifoCache(cache_size_limit)  # type: ignore[assignment]
+            ParserElement.packrat_cache = _FifoCache(cache_size_limit)
         ParserElement._parse = ParserElement._parseCache
 
     def parse_string(
@@ -1191,12 +1206,14 @@ class ParserElement(ABC):
                 loc = self.preParse(instring, loc)
                 se = Empty() + StringEnd().set_debug(False)
                 se._parse(instring, loc)
+        except _ParseActionIndexError as pa_exc:
+            raise pa_exc.exc
         except ParseBaseException as exc:
             if ParserElement.verbose_stacktrace:
                 raise
-            else:
-                # catch and re-raise exception from here, clearing out pyparsing internal stack trace
-                raise exc.with_traceback(None)
+
+            # catch and re-raise exception from here, clearing out pyparsing internal stack trace
+            raise exc.with_traceback(None)
         else:
             return tokens
 
@@ -1205,10 +1222,11 @@ class ParserElement(ABC):
         instring: str,
         max_matches: int = _MAX_INT,
         overlap: bool = False,
+        always_skip_whitespace=True,
         *,
         debug: bool = False,
         maxMatches: int = _MAX_INT,
-    ) -> Generator[Tuple[ParseResults, int, int], None, None]:
+    ) -> Generator[tuple[ParseResults, int, int], None, None]:
         """
         Scan the input string for expression matches.  Each match will return the
         matching tokens, start location, and end location.  May be called with optional
@@ -1249,7 +1267,13 @@ class ParserElement(ABC):
             instring = str(instring).expandtabs()
         instrlen = len(instring)
         loc = 0
-        preparseFn = self.preParse
+        if always_skip_whitespace:
+            preparser = Empty()
+            preparser.ignoreExprs = self.ignoreExprs
+            preparser.whiteChars = self.whiteChars
+            preparseFn = preparser.preParse
+        else:
+            preparseFn = self.preParse
         parseFn = self._parse
         ParserElement.resetCache()
         matches = 0
@@ -1311,14 +1335,15 @@ class ParserElement(ABC):
 
             Now Is The Winter Of Our Discontent Made Glorious Summer By This Sun Of York.
         """
-        out: List[str] = []
+        out: list[str] = []
         lastE = 0
         # force preservation of <TAB>s, to minimize unwanted transformation of string, and to
         # keep string locs straight between transform_string and scan_string
         self.keepTabs = True
         try:
             for t, s, e in self.scan_string(instring, debug=debug):
-                out.append(instring[lastE:s])
+                if s > lastE:
+                    out.append(instring[lastE:s])
                 lastE = e
 
                 if not t:
@@ -1372,7 +1397,12 @@ class ParserElement(ABC):
         maxMatches = min(maxMatches, max_matches)
         try:
             return ParseResults(
-                [t for t, s, e in self.scan_string(instring, maxMatches, debug=debug)]
+                [
+                    t
+                    for t, s, e in self.scan_string(
+                        instring, maxMatches, always_skip_whitespace=False, debug=debug
+                    )
+                ]
             )
         except ParseBaseException as exc:
             if ParserElement.verbose_stacktrace:
@@ -1413,7 +1443,7 @@ class ParserElement(ABC):
             last = e
         yield instring[last:]
 
-    def __add__(self, other) -> "ParserElement":
+    def __add__(self, other) -> ParserElement:
         """
         Implementation of ``+`` operator - returns :class:`And`. Adding strings to a :class:`ParserElement`
         converts them to :class:`Literal`\\ s by default.
@@ -1449,7 +1479,7 @@ class ParserElement(ABC):
             return NotImplemented
         return And([self, other])
 
-    def __radd__(self, other) -> "ParserElement":
+    def __radd__(self, other) -> ParserElement:
         """
         Implementation of ``+`` operator when left operand is not a :class:`ParserElement`
         """
@@ -1462,7 +1492,7 @@ class ParserElement(ABC):
             return NotImplemented
         return other + self
 
-    def __sub__(self, other) -> "ParserElement":
+    def __sub__(self, other) -> ParserElement:
         """
         Implementation of ``-`` operator, returns :class:`And` with error stop
         """
@@ -1472,7 +1502,7 @@ class ParserElement(ABC):
             return NotImplemented
         return self + And._ErrorStop() + other
 
-    def __rsub__(self, other) -> "ParserElement":
+    def __rsub__(self, other) -> ParserElement:
         """
         Implementation of ``-`` operator when left operand is not a :class:`ParserElement`
         """
@@ -1482,7 +1512,7 @@ class ParserElement(ABC):
             return NotImplemented
         return other - self
 
-    def __mul__(self, other) -> "ParserElement":
+    def __mul__(self, other) -> ParserElement:
         """
         Implementation of ``*`` operator, allows use of ``expr * 3`` in place of
         ``expr + expr + expr``.  Expressions may also be multiplied by a 2-integer
@@ -1562,10 +1592,10 @@ class ParserElement(ABC):
                 ret = And([self] * minElements)
         return ret
 
-    def __rmul__(self, other) -> "ParserElement":
+    def __rmul__(self, other) -> ParserElement:
         return self.__mul__(other)
 
-    def __or__(self, other) -> "ParserElement":
+    def __or__(self, other) -> ParserElement:
         """
         Implementation of ``|`` operator - returns :class:`MatchFirst`
         """
@@ -1581,7 +1611,7 @@ class ParserElement(ABC):
             return NotImplemented
         return MatchFirst([self, other])
 
-    def __ror__(self, other) -> "ParserElement":
+    def __ror__(self, other) -> ParserElement:
         """
         Implementation of ``|`` operator when left operand is not a :class:`ParserElement`
         """
@@ -1591,7 +1621,7 @@ class ParserElement(ABC):
             return NotImplemented
         return other | self
 
-    def __xor__(self, other) -> "ParserElement":
+    def __xor__(self, other) -> ParserElement:
         """
         Implementation of ``^`` operator - returns :class:`Or`
         """
@@ -1601,7 +1631,7 @@ class ParserElement(ABC):
             return NotImplemented
         return Or([self, other])
 
-    def __rxor__(self, other) -> "ParserElement":
+    def __rxor__(self, other) -> ParserElement:
         """
         Implementation of ``^`` operator when left operand is not a :class:`ParserElement`
         """
@@ -1611,7 +1641,7 @@ class ParserElement(ABC):
             return NotImplemented
         return other ^ self
 
-    def __and__(self, other) -> "ParserElement":
+    def __and__(self, other) -> ParserElement:
         """
         Implementation of ``&`` operator - returns :class:`Each`
         """
@@ -1621,7 +1651,7 @@ class ParserElement(ABC):
             return NotImplemented
         return Each([self, other])
 
-    def __rand__(self, other) -> "ParserElement":
+    def __rand__(self, other) -> ParserElement:
         """
         Implementation of ``&`` operator when left operand is not a :class:`ParserElement`
         """
@@ -1631,7 +1661,7 @@ class ParserElement(ABC):
             return NotImplemented
         return other & self
 
-    def __invert__(self) -> "ParserElement":
+    def __invert__(self) -> ParserElement:
         """
         Implementation of ``~`` operator - returns :class:`NotAny`
         """
@@ -1701,7 +1731,7 @@ class ParserElement(ABC):
 
         return ret
 
-    def __call__(self, name: typing.Optional[str] = None) -> "ParserElement":
+    def __call__(self, name: typing.Optional[str] = None) -> ParserElement:
         """
         Shortcut for :class:`set_results_name`, with ``list_all_matches=False``.
 
@@ -1721,14 +1751,14 @@ class ParserElement(ABC):
 
         return self.copy()
 
-    def suppress(self) -> "ParserElement":
+    def suppress(self) -> ParserElement:
         """
         Suppresses the output of this :class:`ParserElement`; useful to keep punctuation from
         cluttering up returned output.
         """
         return Suppress(self)
 
-    def ignore_whitespace(self, recursive: bool = True) -> "ParserElement":
+    def ignore_whitespace(self, recursive: bool = True) -> ParserElement:
         """
         Enables the skipping of whitespace before matching the characters in the
         :class:`ParserElement`'s defined pattern.
@@ -1738,7 +1768,7 @@ class ParserElement(ABC):
         self.skipWhitespace = True
         return self
 
-    def leave_whitespace(self, recursive: bool = True) -> "ParserElement":
+    def leave_whitespace(self, recursive: bool = True) -> ParserElement:
         """
         Disables the skipping of whitespace before matching the characters in the
         :class:`ParserElement`'s defined pattern.  This is normally only used internally by
@@ -1750,8 +1780,8 @@ class ParserElement(ABC):
         return self
 
     def set_whitespace_chars(
-        self, chars: Union[Set[str], str], copy_defaults: bool = False
-    ) -> "ParserElement":
+        self, chars: Union[set[str], str], copy_defaults: bool = False
+    ) -> ParserElement:
         """
         Overrides the default whitespace chars
         """
@@ -1760,7 +1790,7 @@ class ParserElement(ABC):
         self.copyDefaultWhiteChars = copy_defaults
         return self
 
-    def parse_with_tabs(self) -> "ParserElement":
+    def parse_with_tabs(self) -> ParserElement:
         """
         Overrides default behavior to expand ``<TAB>`` s to spaces before parsing the input string.
         Must be called before ``parse_string`` when the input grammar contains elements that
@@ -1769,7 +1799,7 @@ class ParserElement(ABC):
         self.keepTabs = True
         return self
 
-    def ignore(self, other: "ParserElement") -> "ParserElement":
+    def ignore(self, other: ParserElement) -> ParserElement:
         """
         Define expression to be ignored (e.g., comments) while doing pattern
         matching; may be called repeatedly, to define multiple comment or other
@@ -1800,7 +1830,7 @@ class ParserElement(ABC):
         start_action: DebugStartAction,
         success_action: DebugSuccessAction,
         exception_action: DebugExceptionAction,
-    ) -> "ParserElement":
+    ) -> ParserElement:
         """
         Customize display of debugging messages while doing pattern matching:
 
@@ -1821,7 +1851,7 @@ class ParserElement(ABC):
         self.debug = True
         return self
 
-    def set_debug(self, flag: bool = True, recurse: bool = False) -> "ParserElement":
+    def set_debug(self, flag: bool = True, recurse: bool = False) -> ParserElement:
         """
         Enable display of debugging messages while doing pattern matching.
         Set ``flag`` to ``True`` to enable, ``False`` to disable.
@@ -1886,7 +1916,7 @@ class ParserElement(ABC):
         Child classes must define this method, which defines how the ``default_name`` is set.
         """
 
-    def set_name(self, name: typing.Optional[str]) -> "ParserElement":
+    def set_name(self, name: typing.Optional[str]) -> ParserElement:
         """
         Define name for this expression, makes debugging and exception messages clearer. If
         `__diag__.enable_debug_on_named_expressions` is set to True, setting a name will also
@@ -1903,7 +1933,7 @@ class ParserElement(ABC):
             integer.set_name("integer")
             integer.parse_string("ABC")  # -> Exception: Expected integer (at char 0), (line:1, col:1)
         """
-        self.customName = name
+        self.customName = name  # type: ignore[assignment]
         self.errmsg = f"Expected {str(self)}"
 
         if __diag__.enable_debug_on_named_expressions:
@@ -1926,12 +1956,12 @@ class ParserElement(ABC):
     def __repr__(self) -> str:
         return str(self)
 
-    def streamline(self) -> "ParserElement":
+    def streamline(self) -> ParserElement:
         self.streamlined = True
         self._defaultName = None
         return self
 
-    def recurse(self) -> List["ParserElement"]:
+    def recurse(self) -> list[ParserElement]:
         return []
 
     def _checkRecursion(self, parseElementList):
@@ -2018,9 +2048,9 @@ class ParserElement(ABC):
 
     def run_tests(
         self,
-        tests: Union[str, List[str]],
+        tests: Union[str, list[str]],
         parse_all: bool = True,
-        comment: typing.Optional[Union["ParserElement", str]] = "#",
+        comment: typing.Optional[Union[ParserElement, str]] = "#",
         full_dump: bool = True,
         print_results: bool = True,
         failure_tests: bool = False,
@@ -2037,7 +2067,7 @@ class ParserElement(ABC):
         postParse: typing.Optional[
             Callable[[str, ParseResults], typing.Optional[str]]
         ] = None,
-    ) -> Tuple[bool, List[Tuple[str, Union[ParseResults, Exception]]]]:
+    ) -> tuple[bool, list[tuple[str, Union[ParseResults, Exception]]]]:
         """
         Execute the parse expression on a series of test strings, showing each
         test, the parsed results or where the parse failed. Quick and easy way to
@@ -2155,8 +2185,8 @@ class ParserElement(ABC):
         print_ = file.write
 
         result: Union[ParseResults, Exception]
-        allResults: List[Tuple[str, Union[ParseResults, Exception]]] = []
-        comments: List[str] = []
+        allResults: list[tuple[str, Union[ParseResults, Exception]]] = []
+        comments: list[str] = []
         success = True
         NL = Literal(r"\n").add_parse_action(replace_with("\n")).ignore(quoted_string)
         BOM = "\ufeff"
@@ -2187,7 +2217,18 @@ class ParserElement(ABC):
                 success = success and failureTests
                 result = pe
             except Exception as exc:
-                out.append(f"FAIL-EXCEPTION: {type(exc).__name__}: {exc}")
+                tag = "FAIL-EXCEPTION"
+
+                # see if this exception was raised in a parse action
+                tb = exc.__traceback__
+                it = iter(traceback.walk_tb(tb))
+                for f, line in it:
+                    if (f.f_code.co_filename, line) == pa_call_line_synth:
+                        next_f = next(it)[0]
+                        tag += f" (raised in parse action {next_f.f_code.co_name!r})"
+                        break
+
+                out.append(f"{tag}: {type(exc).__name__}: {exc}")
                 if ParserElement.verbose_stacktrace:
                     out.extend(traceback.format_tb(exc.__traceback__))
                 success = success and failureTests
@@ -2323,7 +2364,7 @@ class _PendingSkip(ParserElement):
     def _generateDefaultName(self) -> str:
         return str(self.anchor + Empty()).replace("Empty", "...")
 
-    def __add__(self, other) -> "ParserElement":
+    def __add__(self, other) -> ParserElement:
         skipper = SkipTo(other).set_name("...")("_skipped*")
         if self.must_skip:
 
@@ -2505,9 +2546,8 @@ class Keyword(Token):
         match_string = matchString or match_string
         self.match = match_string
         self.matchLen = len(match_string)
-        try:
-            self.firstMatchChar = match_string[0]
-        except IndexError:
+        self.firstMatchChar = match_string[:1]
+        if not self.firstMatchChar:
             raise ValueError("null string passed to Keyword; use Empty() instead")
         self.errmsg = f"Expected {type(self).__name__} {self.name}"
         self.mayReturnEmpty = False
@@ -2522,7 +2562,7 @@ class Keyword(Token):
         return repr(self.match)
 
     def parseImpl(self, instring, loc, do_actions=True) -> ParseImplReturnType:
-        errmsg = self.errmsg
+        errmsg = self.errmsg or ""
         errloc = loc
         if self.caseless:
             if instring[loc : loc + self.matchLen].upper() == self.caselessmatch:
@@ -2900,7 +2940,7 @@ class Word(Token):
                 self.re = None  # type: ignore[assignment]
             else:
                 self.re_match = self.re.match
-                self.parseImpl = self.parseImpl_regex  # type: ignore[assignment]
+                self.parseImpl = self.parseImpl_regex  # type: ignore[method-assign]
 
     def _generateDefaultName(self) -> str:
         def charsAsStr(s):
@@ -3040,48 +3080,65 @@ class Regex(Token):
 
             self._re = None
             self.reString = self.pattern = pattern
-            self.flags = flags
 
         elif hasattr(pattern, "pattern") and hasattr(pattern, "match"):
             self._re = pattern
             self.pattern = self.reString = pattern.pattern
-            self.flags = flags
+
+        elif callable(pattern):
+            # defer creating this pattern until we really need it
+            self.pattern = pattern
+            self._re = None
 
         else:
             raise TypeError(
-                "Regex may only be constructed with a string or a compiled RE object"
+                "Regex may only be constructed with a string or a compiled RE object,"
+                " or a callable that takes no arguments and returns a string or a"
+                " compiled RE object"
             )
 
+        self.flags = flags
         self.errmsg = f"Expected {self.name}"
         self.mayIndexError = False
         self.asGroupList = asGroupList
         self.asMatch = asMatch
         if self.asGroupList:
-            self.parseImpl = self.parseImplAsGroupList  # type: ignore [assignment]
+            self.parseImpl = self.parseImplAsGroupList  # type: ignore [method-assign]
         if self.asMatch:
-            self.parseImpl = self.parseImplAsMatch  # type: ignore [assignment]
+            self.parseImpl = self.parseImplAsMatch  # type: ignore [method-assign]
 
     @cached_property
-    def re(self) -> _RePattern:
+    def re(self) -> re.Pattern:
         if self._re:
             return self._re
 
+        if callable(self.pattern):
+            # replace self.pattern with the string returned by calling self.pattern()
+            self.pattern = cast(Callable[[], str], self.pattern)()
+
+            # see if we got a compiled RE back instead of a str - if so, we're done
+            if hasattr(self.pattern, "pattern") and hasattr(self.pattern, "match"):
+                self._re = cast(re.Pattern[str], self.pattern)
+                self.pattern = self.reString = self._re.pattern
+                return self._re
+
         try:
-            return re.compile(self.pattern, self.flags)
+            self._re = re.compile(self.pattern, self.flags)
+            return self._re
         except re.error:
             raise ValueError(f"invalid pattern ({self.pattern!r}) passed to Regex")
 
     @cached_property
-    def re_match(self) -> Callable[[str], Any]:
+    def re_match(self) -> Callable[[str, int], Any]:
         return self.re.match
 
     @cached_property
-    def mayReturnEmpty(self) -> bool:
-        return self.re_match("") is not None
+    def mayReturnEmpty(self) -> bool:  # type: ignore[override]
+        return self.re_match("", 0) is not None
 
     def _generateDefaultName(self) -> str:
-        unescaped = self.pattern.replace("\\\\", "\\")
-        return f"Re:({unescaped!r})"
+        unescaped = repr(self.pattern).replace("\\\\", "\\")
+        return f"Re:({unescaped})"
 
     def parseImpl(self, instring, loc, do_actions=True) -> ParseImplReturnType:
         result = self.re_match(instring, loc)
@@ -3243,7 +3300,7 @@ class QuotedString(Token):
 
         # fmt: off
         # build up re pattern for the content between the quote delimiters
-        inner_pattern: List[str] = []
+        inner_pattern: list[str] = []
 
         if esc_quote:
             inner_pattern.append(rf"(?:{re.escape(esc_quote)})")
@@ -3287,6 +3344,7 @@ class QuotedString(Token):
             if self.convert_whitespace_escapes:
                 self.unquote_scan_re = re.compile(
                     rf"({'|'.join(re.escape(k) for k in self.ws_map)})"
+                    rf"|(\\[0-7]{3}|\\0|\\x[0-9a-fA-F]{2}|\\u[0-9a-fA-F]{4})"
                     rf"|({re.escape(self.esc_char)}.)"
                     rf"|(\n|.)",
                     flags=self.re_flags,
@@ -3333,6 +3391,16 @@ class QuotedString(Token):
         loc = result.end()
         ret = result.group()
 
+        def convert_escaped_numerics(s: str) -> str:
+            if s == "0":
+                return "\0"
+            if s.isdigit() and len(s) == 3:
+                return chr(int(s, base=8))
+            elif s.startswith(("u", "x")):
+                return chr(int(s[1:], base=16))
+            else:
+                return s
+
         if self.unquote_results:
             # strip off quotes
             ret = ret[self.quote_char_len : -self.end_quote_char_len]
@@ -3346,10 +3414,13 @@ class QuotedString(Token):
                     ret = "".join(
                         # match group 1 matches \t, \n, etc.
                         self.ws_map[match.group(1)] if match.group(1)
-                        # match group 2 matches escaped characters
-                        else match.group(2)[-1] if match.group(2)
-                        # match group 3 matches any character
-                        else match.group(3)
+                        # match group 2 matches escaped octal, null, hex, and Unicode
+                        # sequences
+                        else convert_escaped_numerics(match.group(2)[1:]) if match.group(2)
+                        # match group 3 matches escaped characters
+                        else match.group(3)[-1] if match.group(3)
+                        # match group 4 matches any character
+                        else match.group(4)
                         for match in self.unquote_scan_re.finditer(ret)
                     )
                 else:
@@ -3754,6 +3825,7 @@ class Tag(Token):
         ['Hello,', 'World', '!']
         - enthusiastic: True
     """
+
     def __init__(self, tag_name: str, value: Any = True):
         super().__init__()
         self.mayReturnEmpty = True
@@ -3777,7 +3849,7 @@ class ParseExpression(ParserElement):
 
     def __init__(self, exprs: typing.Iterable[ParserElement], savelist: bool = False):
         super().__init__(savelist)
-        self.exprs: List[ParserElement]
+        self.exprs: list[ParserElement]
         if isinstance(exprs, _generatorType):
             exprs = list(exprs)
 
@@ -3801,7 +3873,7 @@ class ParseExpression(ParserElement):
                 self.exprs = [exprs]
         self.callPreparse = False
 
-    def recurse(self) -> List[ParserElement]:
+    def recurse(self) -> list[ParserElement]:
         return self.exprs[:]
 
     def append(self, other) -> ParserElement:
@@ -3943,7 +4015,7 @@ class ParseExpression(ParserElement):
 
 class And(ParseExpression):
     """
-    Requires all given :class:`ParseExpression` s to be found in the given order.
+    Requires all given :class:`ParserElement` s to be found in the given order.
     Expressions may be separated by whitespace.
     May be constructed using the ``'+'`` operator.
     May also be constructed using the ``'-'`` operator, which will
@@ -3970,9 +4042,9 @@ class And(ParseExpression):
     def __init__(
         self, exprs_arg: typing.Iterable[ParserElement], savelist: bool = True
     ):
-        exprs: List[ParserElement] = list(exprs_arg)
+        exprs: list[ParserElement] = list(exprs_arg)
         if exprs and Ellipsis in exprs:
-            tmp: List[ParserElement] = []
+            tmp: list[ParserElement] = []
             for i, expr in enumerate(exprs):
                 if expr is not Ellipsis:
                     tmp.append(expr)
@@ -4104,7 +4176,7 @@ class And(ParseExpression):
 
 
 class Or(ParseExpression):
-    """Requires that at least one :class:`ParseExpression` is found. If
+    """Requires that at least one :class:`ParserElement` is found. If
     two expressions match, the expression that matches the longest
     string will be used. May be constructed using the ``'^'``
     operator.
@@ -4144,8 +4216,8 @@ class Or(ParseExpression):
     def parseImpl(self, instring, loc, do_actions=True) -> ParseImplReturnType:
         maxExcLoc = -1
         maxException = None
-        matches: List[Tuple[int, ParserElement]] = []
-        fatals: List[ParseFatalException] = []
+        matches: list[tuple[int, ParserElement]] = []
+        fatals: list[ParseFatalException] = []
         if all(e.callPreparse for e in self.exprs):
             loc = self.preParse(instring, loc)
         for e in self.exprs:
@@ -4184,7 +4256,7 @@ class Or(ParseExpression):
                 best_expr = matches[0][1]
                 return best_expr._parse(instring, loc, do_actions)
 
-            longest = -1, None
+            longest: tuple[int, typing.Optional[ParseResults]] = -1, None
             for loc1, expr1 in matches:
                 if loc1 <= longest[0]:
                     # already have a longer match than this one will deliver, we are done
@@ -4219,7 +4291,7 @@ class Or(ParseExpression):
             # infer from this check that all alternatives failed at the current position
             # so emit this collective error message instead of any single error message
             if maxExcLoc == loc:
-                maxException.msg = self.errmsg
+                maxException.msg = self.errmsg or ""
             raise maxException
 
         raise ParseException(instring, loc, "no defined alternatives to match", self)
@@ -4259,7 +4331,7 @@ class Or(ParseExpression):
 
 
 class MatchFirst(ParseExpression):
-    """Requires that at least one :class:`ParseExpression` is found. If
+    """Requires that at least one :class:`ParserElement` is found. If
     more than one expression matches, the first one listed is the one that will
     match. May be constructed using the ``'|'`` operator.
 
@@ -4326,7 +4398,7 @@ class MatchFirst(ParseExpression):
             # infer from this check that all alternatives failed at the current position
             # so emit this collective error message instead of any individual error message
             if maxExcLoc == loc:
-                maxException.msg = self.errmsg
+                maxException.msg = self.errmsg or ""
             raise maxException
 
         raise ParseException(instring, loc, "no defined alternatives to match", self)
@@ -4366,7 +4438,7 @@ class MatchFirst(ParseExpression):
 
 
 class Each(ParseExpression):
-    """Requires all given :class:`ParseExpression` s to be found, but in
+    """Requires all given :class:`ParserElement` s to be found, but in
     any order. Expressions may be separated by whitespace.
 
     May be constructed using the ``'&'`` operator.
@@ -4480,11 +4552,11 @@ class Each(ParseExpression):
         tmpReqd = self.required[:]
         tmpOpt = self.optionals[:]
         multis = self.multioptionals[:]
-        matchOrder: List[ParserElement] = []
+        matchOrder: list[ParserElement] = []
 
         keepMatching = True
-        failed: List[ParserElement] = []
-        fatals: List[ParseFatalException] = []
+        failed: list[ParserElement] = []
+        fatals: list[ParseFatalException] = []
         while keepMatching:
             tmpExprs = tmpReqd + tmpOpt + multis
             failed.clear()
@@ -4567,7 +4639,7 @@ class ParseElementEnhance(ParserElement):
             self.callPreparse = expr.callPreparse
             self.ignoreExprs.extend(expr.ignoreExprs)
 
-    def recurse(self) -> List[ParserElement]:
+    def recurse(self) -> list[ParserElement]:
         return [self.expr] if self.expr is not None else []
 
     def parseImpl(self, instring, loc, do_actions=True):
@@ -4579,7 +4651,10 @@ class ParseElementEnhance(ParserElement):
         except ParseSyntaxException:
             raise
         except ParseBaseException as pbe:
-            if not isinstance(self, Forward) or self.customName is not None:
+            pbe.pstr = pbe.pstr or instring
+            pbe.loc = pbe.loc or loc
+            pbe.parser_element = pbe.parser_element or self
+            if not isinstance(self, Forward) and self.customName is not None:
                 if self.errmsg:
                     pbe.msg = self.errmsg
             raise
@@ -4704,7 +4779,7 @@ class IndentedBlock(ParseElementEnhance):
         if self._grouped:
             wrapper = Group
         else:
-            wrapper = lambda expr: expr
+            wrapper = lambda expr: expr  # type: ignore[misc, assignment]
         return (wrapper(block) + Optional(trailing_undent)).parseImpl(
             instring, anchor_loc, do_actions
         )
@@ -4830,9 +4905,7 @@ class PrecededBy(ParseElementEnhance):
 
     """
 
-    def __init__(
-        self, expr: Union[ParserElement, str], retreat: typing.Optional[int] = None
-    ):
+    def __init__(self, expr: Union[ParserElement, str], retreat: int = 0):
         super().__init__(expr)
         self.expr = self.expr().leave_whitespace()
         self.mayReturnEmpty = True
@@ -4859,7 +4932,7 @@ class PrecededBy(ParseElementEnhance):
     def parseImpl(self, instring, loc=0, do_actions=True) -> ParseImplReturnType:
         if self.exact:
             if loc < self.retreat:
-                raise ParseException(instring, loc, self.errmsg)
+                raise ParseException(instring, loc, self.errmsg, self)
             start = loc - self.retreat
             _, ret = self.expr._parse(instring, start)
             return loc, ret
@@ -4867,7 +4940,7 @@ class PrecededBy(ParseElementEnhance):
         # retreat specified a maximum lookbehind window, iterate
         test_expr = self.expr + StringEnd()
         instring_slice = instring[max(0, loc - self.retreat) : loc]
-        last_expr = ParseException(instring, loc, self.errmsg)
+        last_expr: ParseBaseException = ParseException(instring, loc, self.errmsg, self)
 
         for offset in range(1, min(loc, self.retreat + 1) + 1):
             try:
@@ -5236,7 +5309,9 @@ class Opt(ParseElementEnhance):
     def parseImpl(self, instring, loc, do_actions=True) -> ParseImplReturnType:
         self_expr = self.expr
         try:
-            loc, tokens = self_expr._parse(instring, loc, do_actions, callPreParse=False)
+            loc, tokens = self_expr._parse(
+                instring, loc, do_actions, callPreParse=False
+            )
         except (ParseException, IndexError):
             default_value = self.defaultValue
             if default_value is not self.__optionalNotMatched:
@@ -5244,9 +5319,9 @@ class Opt(ParseElementEnhance):
                     tokens = ParseResults([default_value])
                     tokens[self_expr.resultsName] = default_value
                 else:
-                    tokens = [default_value]
+                    tokens = [default_value]  # type: ignore[assignment]
             else:
-                tokens = []
+                tokens = []  # type: ignore[assignment]
         return loc, tokens
 
     def _generateDefaultName(self) -> str:
@@ -5446,7 +5521,7 @@ class Forward(ParseElementEnhance):
         super().__init__(other, savelist=False)  # type: ignore[arg-type]
         self.lshift_line = None
 
-    def __lshift__(self, other) -> "Forward":
+    def __lshift__(self, other) -> Forward:
         if hasattr(self, "caller_frame"):
             del self.caller_frame
         if isinstance(other, str_type):
@@ -5468,13 +5543,13 @@ class Forward(ParseElementEnhance):
         self.lshift_line = traceback.extract_stack(limit=2)[-2]  # type: ignore[assignment]
         return self
 
-    def __ilshift__(self, other) -> "Forward":
+    def __ilshift__(self, other) -> Forward:
         if not isinstance(other, ParserElement):
             return NotImplemented
 
         return self << other
 
-    def __or__(self, other) -> "ParserElement":
+    def __or__(self, other) -> ParserElement:
         caller_line = traceback.extract_stack(limit=2)[-2]
         if (
             __diag__.warn_on_match_first_with_lshift_operator
@@ -5585,9 +5660,9 @@ class Forward(ParseElementEnhance):
                             # in case the action did backtrack
                             prev_loc, prev_result = memo[peek_key] = memo[act_key]
                             del memo[peek_key], memo[act_key]
-                            return prev_loc, prev_result.copy()
+                            return prev_loc, copy.copy(prev_result)
                         del memo[peek_key]
-                        return prev_loc, prev_peek.copy()
+                        return prev_loc, copy.copy(prev_peek)
                     # the match did get better: see if we can improve further
                     if do_actions:
                         try:
@@ -5675,7 +5750,7 @@ class Forward(ParseElementEnhance):
 
 class TokenConverter(ParseElementEnhance):
     """
-    Abstract subclass of :class:`ParseExpression`, for converting parsed results.
+    Abstract subclass of :class:`ParseElementEnhance`, for converting parsed results.
     """
 
     def __init__(self, expr: Union[ParserElement, str], savelist=False):
@@ -5900,13 +5975,13 @@ class Suppress(TokenConverter):
             expr = _PendingSkip(NoMatch())
         super().__init__(expr)
 
-    def __add__(self, other) -> "ParserElement":
+    def __add__(self, other) -> ParserElement:
         if isinstance(self.expr, _PendingSkip):
             return Suppress(SkipTo(other)) + other
 
         return super().__add__(other)
 
-    def __sub__(self, other) -> "ParserElement":
+    def __sub__(self, other) -> ParserElement:
         if isinstance(self.expr, _PendingSkip):
             return Suppress(SkipTo(other)) - other
 
@@ -6131,7 +6206,7 @@ punc8bit = srange(r"[\0xa1-\0xbf\0xd7\0xf7]")
 
 # build list of built-in expressions, for future reference if a global default value
 # gets updated
-_builtin_exprs: List[ParserElement] = [
+_builtin_exprs: list[ParserElement] = [
     v for v in vars().values() if isinstance(v, ParserElement)
 ]
 
diff --git a/lib/pyparsing/diagram/__init__.py b/lib/pyparsing/diagram/__init__.py
index 3275adaf..7926f2c3 100644
--- a/lib/pyparsing/diagram/__init__.py
+++ b/lib/pyparsing/diagram/__init__.py
@@ -1,20 +1,20 @@
 # mypy: ignore-errors
+from __future__ import annotations
+
 import railroad
 import pyparsing
+import dataclasses
 import typing
 from typing import (
-    List,
-    NamedTuple,
     Generic,
     TypeVar,
-    Dict,
     Callable,
-    Set,
     Iterable,
 )
 from jinja2 import Template
 from io import StringIO
 import inspect
+import re
 
 
 jinja2_template_source = """\
@@ -55,14 +55,23 @@ jinja2_template_source = """\
 
 template = Template(jinja2_template_source)
 
-# Note: ideally this would be a dataclass, but we're supporting Python 3.5+ so we can't do this yet
-NamedDiagram = NamedTuple(
-    "NamedDiagram",
-    [("name", str), ("diagram", typing.Optional[railroad.DiagramItem]), ("index", int)],
-)
-"""
-A simple structure for associating a name with a railroad diagram
-"""
+
+def _collapse_verbose_regex(regex_str: str) -> str:
+    collapsed = pyparsing.Regex(r"#.*").suppress().transform_string(regex_str)
+    collapsed = re.sub(r"\s*\n\s*", "", collapsed)
+    return collapsed
+
+
+@dataclasses.dataclass
+class NamedDiagram:
+    """
+    A simple structure for associating a name with a railroad diagram
+    """
+
+    name: str
+    index: int
+    diagram: railroad.DiagramItem = None
+
 
 T = TypeVar("T")
 
@@ -108,7 +117,7 @@ class EditablePartial(Generic[T]):
         self.kwargs = kwargs
 
     @classmethod
-    def from_call(cls, func: Callable[..., T], *args, **kwargs) -> "EditablePartial[T]":
+    def from_call(cls, func: Callable[..., T], *args, **kwargs) -> EditablePartial[T]:
         """
         If you call this function in the same way that you would call the constructor, it will store the arguments
         as you expect. For example EditablePartial.from_call(Fraction, 1, 3)() == Fraction(1, 3)
@@ -135,7 +144,7 @@ class EditablePartial(Generic[T]):
         return self.func(*args, **kwargs)
 
 
-def railroad_to_html(diagrams: List[NamedDiagram], embed=False, **kwargs) -> str:
+def railroad_to_html(diagrams: list[NamedDiagram], embed=False, **kwargs) -> str:
     """
     Given a list of NamedDiagram, produce a single HTML string that visualises those diagrams
     :params kwargs: kwargs to be passed in to the template
@@ -158,7 +167,7 @@ def railroad_to_html(diagrams: List[NamedDiagram], embed=False, **kwargs) -> str
     return template.render(diagrams=data, embed=embed, **kwargs)
 
 
-def resolve_partial(partial: "EditablePartial[T]") -> T:
+def resolve_partial(partial: EditablePartial[T]) -> T:
     """
     Recursively resolves a collection of Partials into whatever type they are
     """
@@ -180,7 +189,7 @@ def to_railroad(
     vertical: int = 3,
     show_results_names: bool = False,
     show_groups: bool = False,
-) -> List[NamedDiagram]:
+) -> list[NamedDiagram]:
     """
     Convert a pyparsing element tree into a list of diagrams. This is the recommended entrypoint to diagram
     creation if you want to access the Railroad tree before it is converted to HTML
@@ -244,40 +253,31 @@ def _should_vertical(
         return len(_visible_exprs(exprs)) >= specification
 
 
+@dataclasses.dataclass
 class ElementState:
     """
     State recorded for an individual pyparsing Element
     """
 
-    # Note: this should be a dataclass, but we have to support Python 3.5
-    def __init__(
-        self,
-        element: pyparsing.ParserElement,
-        converted: EditablePartial,
-        parent: EditablePartial,
-        number: int,
-        name: str = None,
-        parent_index: typing.Optional[int] = None,
-    ):
-        #: The pyparsing element that this represents
-        self.element: pyparsing.ParserElement = element
-        #: The name of the element
-        self.name: typing.Optional[str] = name
-        #: The output Railroad element in an unconverted state
-        self.converted: EditablePartial = converted
-        #: The parent Railroad element, which we store so that we can extract this if it's duplicated
-        self.parent: EditablePartial = parent
-        #: The order in which we found this element, used for sorting diagrams if this is extracted into a diagram
-        self.number: int = number
-        #: The index of this inside its parent
-        self.parent_index: typing.Optional[int] = parent_index
-        #: If true, we should extract this out into a subdiagram
-        self.extract: bool = False
-        #: If true, all of this element's children have been filled out
-        self.complete: bool = False
+    #: The pyparsing element that this represents
+    element: pyparsing.ParserElement
+    #: The output Railroad element in an unconverted state
+    converted: EditablePartial
+    #: The parent Railroad element, which we store so that we can extract this if it's duplicated
+    parent: EditablePartial
+    #: The order in which we found this element, used for sorting diagrams if this is extracted into a diagram
+    number: int
+    #: The name of the element
+    name: str = None
+    #: The index of this inside its parent
+    parent_index: typing.Optional[int] = None
+    #: If true, we should extract this out into a subdiagram
+    extract: bool = False
+    #: If true, all of this element's children have been filled out
+    complete: bool = False
 
     def mark_for_extraction(
-        self, el_id: int, state: "ConverterState", name: str = None, force: bool = False
+        self, el_id: int, state: ConverterState, name: str = None, force: bool = False
     ):
         """
         Called when this instance has been seen twice, and thus should eventually be extracted into a sub-diagram
@@ -313,16 +313,16 @@ class ConverterState:
 
     def __init__(self, diagram_kwargs: typing.Optional[dict] = None):
         #: A dictionary mapping ParserElements to state relating to them
-        self._element_diagram_states: Dict[int, ElementState] = {}
+        self._element_diagram_states: dict[int, ElementState] = {}
         #: A dictionary mapping ParserElement IDs to subdiagrams generated from them
-        self.diagrams: Dict[int, EditablePartial[NamedDiagram]] = {}
+        self.diagrams: dict[int, EditablePartial[NamedDiagram]] = {}
         #: The index of the next unnamed element
         self.unnamed_index: int = 1
         #: The index of the next element. This is used for sorting
         self.index: int = 0
         #: Shared kwargs that are used to customize the construction of diagrams
         self.diagram_kwargs: dict = diagram_kwargs or {}
-        self.extracted_diagram_names: Set[str] = set()
+        self.extracted_diagram_names: set[str] = set()
 
     def __setitem__(self, key: int, value: ElementState):
         self._element_diagram_states[key] = value
@@ -513,7 +513,7 @@ def _to_diagram_element(
 
     # If the element isn't worth extracting, we always treat it as the first time we say it
     if _worth_extracting(element):
-        if el_id in lookup:
+        if el_id in lookup and lookup[el_id].name is not None:
             # If we've seen this element exactly once before, we are only just now finding out that it's a duplicate,
             # so we have to extract it into a new diagram.
             looked_up = lookup[el_id]
@@ -618,6 +618,11 @@ def _to_diagram_element(
         ret = EditablePartial.from_call(railroad.Sequence, items=[])
     elif len(exprs) > 0 and not element_results_name:
         ret = EditablePartial.from_call(railroad.Group, item="", label=name)
+    elif isinstance(element, pyparsing.Regex):
+        patt = _collapse_verbose_regex(element.pattern)
+        element.pattern = patt
+        element._defaultName = None
+        ret = EditablePartial.from_call(railroad.Terminal, element.defaultName)
     elif len(exprs) > 0:
         ret = EditablePartial.from_call(railroad.Sequence, items=[])
     else:
diff --git a/lib/pyparsing/exceptions.py b/lib/pyparsing/exceptions.py
index 8db34f19..57a1579d 100644
--- a/lib/pyparsing/exceptions.py
+++ b/lib/pyparsing/exceptions.py
@@ -1,17 +1,20 @@
 # exceptions.py
+from __future__ import annotations
 
+import copy
 import re
 import sys
 import typing
+from functools import cached_property
 
+from .unicode import pyparsing_unicode as ppu
 from .util import (
+    _collapse_string_to_ranges,
     col,
     line,
     lineno,
-    _collapse_string_to_ranges,
     replaced_by_pep8,
 )
-from .unicode import pyparsing_unicode as ppu
 
 
 class _ExceptionWordUnicodeSet(
@@ -31,7 +34,7 @@ class ParseBaseException(Exception):
     msg: str
     pstr: str
     parser_element: typing.Any  # "ParserElement"
-    args: typing.Tuple[str, int, typing.Optional[str]]
+    args: tuple[str, int, typing.Optional[str]]
 
     __slots__ = (
         "loc",
@@ -50,18 +53,17 @@ class ParseBaseException(Exception):
         msg: typing.Optional[str] = None,
         elem=None,
     ):
-        self.loc = loc
         if msg is None:
-            self.msg = pstr
-            self.pstr = ""
-        else:
-            self.msg = msg
-            self.pstr = pstr
+            msg, pstr = pstr, ""
+
+        self.loc = loc
+        self.msg = msg
+        self.pstr = pstr
         self.parser_element = elem
         self.args = (pstr, loc, msg)
 
     @staticmethod
-    def explain_exception(exc, depth=16):
+    def explain_exception(exc: Exception, depth: int = 16) -> str:
         """
         Method to take an exception and translate the Python internal traceback into a list
         of the pyparsing expressions that caused the exception to be raised.
@@ -82,17 +84,17 @@ class ParseBaseException(Exception):
 
         if depth is None:
             depth = sys.getrecursionlimit()
-        ret = []
+        ret: list[str] = []
         if isinstance(exc, ParseBaseException):
             ret.append(exc.line)
             ret.append(f"{' ' * (exc.column - 1)}^")
         ret.append(f"{type(exc).__name__}: {exc}")
 
-        if depth <= 0:
+        if depth <= 0 or exc.__traceback__ is None:
             return "\n".join(ret)
 
         callers = inspect.getinnerframes(exc.__traceback__, context=depth)
-        seen = set()
+        seen: set[int] = set()
         for ff in callers[-depth:]:
             frm = ff[0]
 
@@ -125,41 +127,58 @@ class ParseBaseException(Exception):
         return "\n".join(ret)
 
     @classmethod
-    def _from_exception(cls, pe):
+    def _from_exception(cls, pe) -> ParseBaseException:
         """
         internal factory method to simplify creating one type of ParseException
         from another - avoids having __init__ signature conflicts among subclasses
         """
         return cls(pe.pstr, pe.loc, pe.msg, pe.parser_element)
 
-    @property
+    @cached_property
     def line(self) -> str:
         """
         Return the line of text where the exception occurred.
         """
         return line(self.loc, self.pstr)
 
-    @property
+    @cached_property
     def lineno(self) -> int:
         """
         Return the 1-based line number of text where the exception occurred.
         """
         return lineno(self.loc, self.pstr)
 
-    @property
+    @cached_property
     def col(self) -> int:
         """
         Return the 1-based column on the line of text where the exception occurred.
         """
         return col(self.loc, self.pstr)
 
-    @property
+    @cached_property
     def column(self) -> int:
         """
         Return the 1-based column on the line of text where the exception occurred.
         """
         return col(self.loc, self.pstr)
 
+    @cached_property
+    def found(self) -> str:
+        if not self.pstr:
+            return ""
+
+        if self.loc >= len(self.pstr):
+            return "end of text"
+
+        # pull out next word at error location
+        found_match = _exception_word_extractor.match(self.pstr, self.loc)
+        if found_match is not None:
+            found_text = found_match.group(0)
+        else:
+            found_text = self.pstr[self.loc : self.loc + 1]
+
+        return repr(found_text).replace(r"\\", "\\")
+
     # pre-PEP8 compatibility
     @property
     def parserElement(self):
@@ -169,21 +188,15 @@ class ParseBaseException(Exception):
     def parserElement(self, elem):
         self.parser_element = elem
 
+    def copy(self):
+        return copy.copy(self)
+
+    def formatted_message(self) -> str:
+        found_phrase = f", found {self.found}" if self.found else ""
+        return f"{self.msg}{found_phrase}  (at char {self.loc}), (line:{self.lineno}, col:{self.column})"
+
     def __str__(self) -> str:
-        if self.pstr:
-            if self.loc >= len(self.pstr):
-                foundstr = ", found end of text"
-            else:
-                # pull out next word at error location
-                found_match = _exception_word_extractor.match(self.pstr, self.loc)
-                if found_match is not None:
-                    found = found_match.group(0)
-                else:
-                    found = self.pstr[self.loc : self.loc + 1]
-                foundstr = (", found %r" % found).replace(r"\\", "\\")
-        else:
-            foundstr = ""
-        return f"{self.msg}{foundstr}  (at char {self.loc}), (line:{self.lineno}, col:{self.column})"
+        return self.formatted_message()
 
     def __repr__(self):
         return str(self)
@@ -199,12 +212,10 @@ class ParseBaseException(Exception):
         line_str = self.line
         line_column = self.column - 1
         if markerString:
-            line_str = "".join(
-                (line_str[:line_column], markerString, line_str[line_column:])
-            )
+            line_str = f"{line_str[:line_column]}{markerString}{line_str[line_column:]}"
         return line_str.strip()
 
-    def explain(self, depth=16) -> str:
+    def explain(self, depth: int = 16) -> str:
         """
         Method to translate the Python internal traceback into a list
         of the pyparsing expressions that caused the exception to be raised.
@@ -292,6 +303,8 @@ class RecursiveGrammarException(Exception):
     Exception thrown by :class:`ParserElement.validate` if the
     grammar could be left-recursive; parser may need to enable
     left recursion using :class:`ParserElement.enable_left_recursion<ParserElement.enable_left_recursion>`
+
+    Deprecated: only used by deprecated method ParserElement.validate.
     """
 
     def __init__(self, parseElementList):
diff --git a/lib/pyparsing/helpers.py b/lib/pyparsing/helpers.py
index d5d14a08..d2bd05f3 100644
--- a/lib/pyparsing/helpers.py
+++ b/lib/pyparsing/helpers.py
@@ -1,5 +1,6 @@
 # helpers.py
 import html.entities
+import operator
 import re
 import sys
 import typing
@@ -10,6 +11,7 @@ from .util import (
     _bslash,
     _flatten,
     _escape_regex_range_chars,
+    make_compressed_re,
     replaced_by_pep8,
 )
 
@@ -203,15 +205,15 @@ def one_of(
         )
 
     if caseless:
-        isequal = lambda a, b: a.upper() == b.upper()
+        is_equal = lambda a, b: a.upper() == b.upper()
         masks = lambda a, b: b.upper().startswith(a.upper())
-        parseElementClass = CaselessKeyword if asKeyword else CaselessLiteral
+        parse_element_class = CaselessKeyword if asKeyword else CaselessLiteral
     else:
-        isequal = lambda a, b: a == b
+        is_equal = operator.eq
         masks = lambda a, b: b.startswith(a)
-        parseElementClass = Keyword if asKeyword else Literal
+        parse_element_class = Keyword if asKeyword else Literal
 
-    symbols: List[str] = []
+    symbols: list[str]
     if isinstance(strs, str_type):
         strs = typing.cast(str, strs)
         symbols = strs.split()
@@ -224,20 +226,19 @@ def one_of(
 
     # reorder given symbols to take care to avoid masking longer choices with shorter ones
     # (but only if the given symbols are not just single characters)
-    if any(len(sym) > 1 for sym in symbols):
-        i = 0
-        while i < len(symbols) - 1:
-            cur = symbols[i]
-            for j, other in enumerate(symbols[i + 1 :]):
-                if isequal(other, cur):
-                    del symbols[i + j + 1]
-                    break
-                if masks(cur, other):
-                    del symbols[i + j + 1]
-                    symbols.insert(i, other)
-                    break
-            else:
-                i += 1
+    i = 0
+    while i < len(symbols) - 1:
+        cur = symbols[i]
+        for j, other in enumerate(symbols[i + 1 :]):
+            if is_equal(other, cur):
+                del symbols[i + j + 1]
+                break
+            if len(other) > len(cur) and masks(cur, other):
+                del symbols[i + j + 1]
+                symbols.insert(i, other)
+                break
+        else:
+            i += 1
 
     if useRegex:
         re_flags: int = re.IGNORECASE if caseless else 0
@@ -269,7 +270,7 @@ def one_of(
             )
 
     # last resort, just use MatchFirst
-    return MatchFirst(parseElementClass(sym) for sym in symbols).set_name(
+    return MatchFirst(parse_element_class(sym) for sym in symbols).set_name(
         " | ".join(symbols)
     )
 
@@ -602,7 +603,7 @@ def _makeTags(tagStr, xml, suppress_LT=Suppress("<"), suppress_GT=Suppress(">"))
 
 def make_html_tags(
     tag_str: Union[str, ParserElement]
-) -> Tuple[ParserElement, ParserElement]:
+) -> tuple[ParserElement, ParserElement]:
     """Helper to construct opening and closing tag expressions for HTML,
     given a tag name. Matches tags in either upper or lower case,
     attributes with namespaces and with quoted or unquoted values.
@@ -629,7 +630,7 @@ def make_html_tags(
 
 def make_xml_tags(
     tag_str: Union[str, ParserElement]
-) -> Tuple[ParserElement, ParserElement]:
+) -> tuple[ParserElement, ParserElement]:
     """Helper to construct opening and closing tag expressions for XML,
     given a tag name. Matches tags only in the given upper/lower case.
 
@@ -645,9 +646,12 @@ any_open_tag, any_close_tag = make_html_tags(
 )
 
 _htmlEntityMap = {k.rstrip(";"): v for k, v in html.entities.html5.items()}
-common_html_entity = Regex("&(?P<entity>" + "|".join(_htmlEntityMap) + ");").set_name(
-    "common HTML entity"
+_most_common_entities = "nbsp lt gt amp quot apos cent pound euro copy".replace(
+    " ", "|"
 )
+common_html_entity = Regex(
+    lambda: f"&(?P<entity>{_most_common_entities}|{make_compressed_re(_htmlEntityMap)});"
+).set_name("common HTML entity")
 
 
 def replace_html_entity(s, l, t):
@@ -664,16 +668,16 @@ class OpAssoc(Enum):
 
 
 InfixNotationOperatorArgType = Union[
-    ParserElement, str, Tuple[Union[ParserElement, str], Union[ParserElement, str]]
+    ParserElement, str, tuple[Union[ParserElement, str], Union[ParserElement, str]]
 ]
 InfixNotationOperatorSpec = Union[
-    Tuple[
+    tuple[
         InfixNotationOperatorArgType,
         int,
         OpAssoc,
         typing.Optional[ParseAction],
     ],
-    Tuple[
+    tuple[
         InfixNotationOperatorArgType,
         int,
         OpAssoc,
@@ -683,7 +687,7 @@ InfixNotationOperatorSpec = Union[
 
 def infix_notation(
     base_expr: ParserElement,
-    op_list: List[InfixNotationOperatorSpec],
+    op_list: list[InfixNotationOperatorSpec],
     lpar: Union[str, ParserElement] = Suppress("("),
     rpar: Union[str, ParserElement] = Suppress(")"),
 ) -> ParserElement:
@@ -1032,7 +1036,7 @@ python_style_comment = Regex(r"#.*").set_name("Python style comment")
 
 # build list of built-in expressions, for future reference if a global default value
 # gets updated
-_builtin_exprs: List[ParserElement] = [
+_builtin_exprs: list[ParserElement] = [
     v for v in vars().values() if isinstance(v, ParserElement)
 ]
 
diff --git a/lib/pyparsing/results.py b/lib/pyparsing/results.py
index 3bb7c948..24584783 100644
--- a/lib/pyparsing/results.py
+++ b/lib/pyparsing/results.py
@@ -1,4 +1,7 @@
 # results.py
+from __future__ import annotations
+
+import collections
 from collections.abc import (
     MutableMapping,
     Mapping,
@@ -7,21 +10,21 @@ from collections.abc import (
     Iterable,
 )
 import pprint
-from typing import Tuple, Any, Dict, Set, List
+from typing import Any
 
 from .util import replaced_by_pep8
 
 
-str_type: Tuple[type, ...] = (str, bytes)
+str_type: tuple[type, ...] = (str, bytes)
 _generator_type = type((_ for _ in ()))
 
 
 class _ParseResultsWithOffset:
-    tup: Tuple["ParseResults", int]
+    tup: tuple[ParseResults, int]
     __slots__ = ["tup"]
 
-    def __init__(self, p1: "ParseResults", p2: int):
-        self.tup: Tuple[ParseResults, int] = (p1, p2)
+    def __init__(self, p1: ParseResults, p2: int):
+        self.tup: tuple[ParseResults, int] = (p1, p2)
 
     def __getitem__(self, i):
         return self.tup[i]
@@ -79,14 +82,14 @@ class ParseResults:
         - year: '1999'
     """
 
-    _null_values: Tuple[Any, ...] = (None, [], ())
+    _null_values: tuple[Any, ...] = (None, [], ())
 
     _name: str
-    _parent: "ParseResults"
-    _all_names: Set[str]
+    _parent: ParseResults
+    _all_names: set[str]
     _modal: bool
-    _toklist: List[Any]
-    _tokdict: Dict[str, Any]
+    _toklist: list[Any]
+    _tokdict: dict[str, Any]
 
     __slots__ = (
         "_name",
@@ -172,8 +175,8 @@ class ParseResults:
     # constructor as small and fast as possible
     def __init__(
         self, toklist=None, name=None, asList=True, modal=True, isinstance=isinstance
-    ):
-        self._tokdict: Dict[str, _ParseResultsWithOffset]
+    ) -> None:
+        self._tokdict: dict[str, _ParseResultsWithOffset]
         self._modal = modal
 
         if name is None or name == "":
@@ -226,7 +229,7 @@ class ParseResults:
             self._toklist[k] = v
             sub = v
         else:
-            self._tokdict[k] = self._tokdict.get(k, list()) + [
+            self._tokdict[k] = self._tokdict.get(k, []) + [
                 _ParseResultsWithOffset(v, 0)
             ]
             sub = v
@@ -443,12 +446,12 @@ class ParseResults:
                 raise AttributeError(name)
             return ""
 
-    def __add__(self, other: "ParseResults") -> "ParseResults":
+    def __add__(self, other: ParseResults) -> ParseResults:
         ret = self.copy()
         ret += other
         return ret
 
-    def __iadd__(self, other: "ParseResults") -> "ParseResults":
+    def __iadd__(self, other: ParseResults) -> ParseResults:
         if not other:
             return self
 
@@ -470,7 +473,7 @@ class ParseResults:
         self._all_names |= other._all_names
         return self
 
-    def __radd__(self, other) -> "ParseResults":
+    def __radd__(self, other) -> ParseResults:
         if isinstance(other, int) and other == 0:
             # useful for merging many ParseResults using sum() builtin
             return self.copy()
@@ -504,9 +507,10 @@ class ParseResults:
                 out.append(str(item))
         return out
 
-    def as_list(self) -> list:
+    def as_list(self, *, flatten: bool = False) -> list:
         """
         Returns the parse results as a nested list of matching tokens, all converted to strings.
+        If flatten is True, all the nesting levels in the returned list are collapsed.
 
         Example::
 
@@ -519,10 +523,22 @@ class ParseResults:
             result_list = result.as_list()
             print(type(result_list), result_list) # -> <class 'list'> ['sldkj', 'lsdkj', 'sldkj']
         """
-        return [
-            res.as_list() if isinstance(res, ParseResults) else res
-            for res in self._toklist
-        ]
+        def flattened(pr):
+            to_visit = collections.deque([*self])
+            while to_visit:
+                to_do = to_visit.popleft()
+                if isinstance(to_do, ParseResults):
+                    to_visit.extendleft(to_do[::-1])
+                else:
+                    yield to_do
+
+        if flatten:
+            return [*flattened(self)]
+        else:
+            return [
+                res.as_list() if isinstance(res, ParseResults) else res
+                for res in self._toklist
+            ]
 
     def as_dict(self) -> dict:
         """
@@ -553,7 +569,7 @@ class ParseResults:
 
         return dict((k, to_item(v)) for k, v in self.items())
 
-    def copy(self) -> "ParseResults":
+    def copy(self) -> ParseResults:
         """
         Returns a new shallow copy of a :class:`ParseResults` object. `ParseResults`
         items contained within the source are shared with the copy. Use
@@ -567,7 +583,7 @@ class ParseResults:
         ret._name = self._name
         return ret
 
-    def deepcopy(self) -> "ParseResults":
+    def deepcopy(self) -> ParseResults:
         """
         Returns a new deep copy of a :class:`ParseResults` object.
         """
@@ -584,11 +600,11 @@ class ParseResults:
                     dest[k] = v.deepcopy() if isinstance(v, ParseResults) else v
             elif isinstance(obj, Iterable):
                 ret._toklist[i] = type(obj)(
-                    v.deepcopy() if isinstance(v, ParseResults) else v for v in obj
+                    v.deepcopy() if isinstance(v, ParseResults) else v for v in obj  # type: ignore[call-arg]
                 )
         return ret
 
-    def get_name(self) -> str:
+    def get_name(self) -> str | None:
         r"""
         Returns the results name for this token expression. Useful when several
         different expressions might match at a particular location.
@@ -616,7 +632,7 @@ class ParseResults:
         if self._name:
             return self._name
         elif self._parent:
-            par: "ParseResults" = self._parent
+            par: ParseResults = self._parent
             parent_tokdict_items = par._tokdict.items()
             return next(
                 (
@@ -761,7 +777,7 @@ class ParseResults:
         return dir(type(self)) + list(self.keys())
 
     @classmethod
-    def from_dict(cls, other, name=None) -> "ParseResults":
+    def from_dict(cls, other, name=None) -> ParseResults:
         """
         Helper classmethod to construct a ``ParseResults`` from a ``dict``, preserving the
         name-value relations as results names. If an optional ``name`` argument is
diff --git a/lib/pyparsing/testing.py b/lib/pyparsing/testing.py
index 5654d47d..836b2f86 100644
--- a/lib/pyparsing/testing.py
+++ b/lib/pyparsing/testing.py
@@ -257,10 +257,14 @@ class pyparsing_test:
         eol_mark: str = "|",
         mark_spaces: typing.Optional[str] = None,
         mark_control: typing.Optional[str] = None,
+        *,
+        indent: typing.Union[str, int] = "",
+        base_1: bool = True,
     ) -> str:
         """
         Helpful method for debugging a parser - prints a string with line and column numbers.
-        (Line and column numbers are 1-based.)
+        (Line and column numbers are 1-based by default - if debugging a parse action,
+        pass base_1=False, to correspond to the loc value passed to the parse action.)
 
         :param s: tuple(bool, str - string to be printed with line and column numbers
         :param start_line: int - (optional) starting line number in s to print (default=1)
@@ -273,11 +277,18 @@ class pyparsing_test:
                                  - "unicode" - replaces control chars with Unicode symbols, such as "␍" and "␊"
                                  - any single character string - replace control characters with given string
                                  - None (default) - string is displayed as-is
+        :param indent: str | int - (optional) string to indent with line and column numbers; if an int
+                                   is passed, converted to " " * indent
+        :param base_1: bool - (optional) whether to label string using base 1; if False, string will be
+                              labeled based at 0 (default=True)
 
         :return: str - input string with leading line numbers and column number headers
         """
         if expand_tabs:
             s = s.expandtabs()
+        if isinstance(indent, int):
+            indent = " " * indent
+        indent = indent.expandtabs()
         if mark_control is not None:
             mark_control = typing.cast(str, mark_control)
             if mark_control == "unicode":
@@ -300,46 +311,52 @@ class pyparsing_test:
             else:
                 s = s.replace(" ", mark_spaces)
         if start_line is None:
-            start_line = 1
+            start_line = 0
         if end_line is None:
             end_line = len(s)
         end_line = min(end_line, len(s))
-        start_line = min(max(1, start_line), end_line)
+        start_line = min(max(0, start_line), end_line)
 
         if mark_control != "unicode":
-            s_lines = s.splitlines()[start_line - 1 : end_line]
+            s_lines = s.splitlines()[start_line - base_1 : end_line]
         else:
-            s_lines = [line + "␊" for line in s.split("␊")[start_line - 1 : end_line]]
+            s_lines = [
+                line + "␊" for line in s.split("␊")[start_line - base_1 : end_line]
+            ]
         if not s_lines:
             return ""
 
         lineno_width = len(str(end_line))
         max_line_len = max(len(line) for line in s_lines)
-        lead = " " * (lineno_width + 1)
+        lead = indent + " " * (lineno_width + 1)
         if max_line_len >= 99:
             header0 = (
                 lead
+                + ("" if base_1 else " ")
                 + "".join(
                     f"{' ' * 99}{(i + 1) % 100}"
-                    for i in range(max(max_line_len // 100, 1))
+                    for i in range(1 if base_1 else 0, max(max_line_len // 100, 1))
                 )
                 + "\n"
             )
         else:
             header0 = ""
         header1 = (
-            header0
+            ("" if base_1 else " ")
             + lead
             + "".join(f"         {(i + 1) % 10}" for i in range(-(-max_line_len // 10)))
             + "\n"
         )
-        header2 = lead + "1234567890" * (-(-max_line_len // 10)) + "\n"
+        digits = "1234567890"
+        header2 = (
+            lead + ("" if base_1 else "0") + digits * (-(-max_line_len // 10)) + "\n"
+        )
         return (
             header1
             + header2
             + "\n".join(
-                f"{i:{lineno_width}d}:{line}{eol_mark}"
-                for i, line in enumerate(s_lines, start=start_line)
+                f"{indent}{i:{lineno_width}d}:{line}{eol_mark}"
+                for i, line in enumerate(s_lines, start=start_line + base_1)
             )
             + "\n"
         )
diff --git a/lib/pyparsing/unicode.py b/lib/pyparsing/unicode.py
index 0e3e0657..066486c2 100644
--- a/lib/pyparsing/unicode.py
+++ b/lib/pyparsing/unicode.py
@@ -2,7 +2,7 @@
 
 import sys
 from itertools import filterfalse
-from typing import List, Tuple, Union
+from typing import Union
 
 
 class _lazyclassproperty:
@@ -25,7 +25,7 @@ class _lazyclassproperty:
         return cls._intern[attrname]
 
 
-UnicodeRangeList = List[Union[Tuple[int, int], Tuple[int]]]
+UnicodeRangeList = list[Union[tuple[int, int], tuple[int]]]
 
 
 class unicode_set:
@@ -53,9 +53,9 @@ class unicode_set:
     _ranges: UnicodeRangeList = []
 
     @_lazyclassproperty
-    def _chars_for_ranges(cls) -> List[str]:
-        ret: List[int] = []
-        for cc in cls.__mro__:
+    def _chars_for_ranges(cls) -> list[str]:
+        ret: list[int] = []
+        for cc in cls.__mro__:  # type: ignore[attr-defined]
             if cc is unicode_set:
                 break
             for rr in getattr(cc, "_ranges", ()):
diff --git a/lib/pyparsing/util.py b/lib/pyparsing/util.py
index 94837fea..1487019c 100644
--- a/lib/pyparsing/util.py
+++ b/lib/pyparsing/util.py
@@ -1,11 +1,11 @@
 # util.py
-import inspect
-import warnings
-import types
-import collections
-import itertools
+import contextlib
 from functools import lru_cache, wraps
-from typing import Callable, List, Union, Iterable, TypeVar, cast
+import inspect
+import itertools
+import types
+from typing import Callable, Union, Iterable, TypeVar, cast
+import warnings
 
 _bslash = chr(92)
 C = TypeVar("C", bound=Callable)
@@ -14,8 +14,8 @@ C = TypeVar("C", bound=Callable)
 class __config_flags:
     """Internal class for defining compatibility and debugging flags"""
 
-    _all_names: List[str] = []
-    _fixed_names: List[str] = []
+    _all_names: list[str] = []
+    _fixed_names: list[str] = []
     _type_desc = "configuration"
 
     @classmethod
@@ -100,27 +100,24 @@ class _UnboundedCache:
 
 class _FifoCache:
     def __init__(self, size):
-        self.not_in_cache = not_in_cache = object()
         cache = {}
-        keyring = [object()] * size
+        self.size = size
+        self.not_in_cache = not_in_cache = object()
         cache_get = cache.get
         cache_pop = cache.pop
-        keyiter = itertools.cycle(range(size))
 
         def get(_, key):
             return cache_get(key, not_in_cache)
 
         def set_(_, key, value):
             cache[key] = value
-            i = next(keyiter)
-            cache_pop(keyring[i], None)
-            keyring[i] = key
+            while len(cache) > size:
+                # pop oldest element in cache by getting the first key
+                cache_pop(next(iter(cache)))
 
         def clear(_):
             cache.clear()
-            keyring[:] = [object()] * size
 
-        self.size = size
         self.get = types.MethodType(get, self)
         self.set = types.MethodType(set_, self)
         self.clear = types.MethodType(clear, self)
@@ -137,13 +134,13 @@ class LRUMemo:
     def __init__(self, capacity):
         self._capacity = capacity
         self._active = {}
-        self._memory = collections.OrderedDict()
+        self._memory = {}
 
     def __getitem__(self, key):
         try:
             return self._active[key]
         except KeyError:
-            self._memory.move_to_end(key)
+            self._memory[key] = self._memory.pop(key)
             return self._memory[key]
 
     def __setitem__(self, key, value):
@@ -156,8 +153,9 @@ class LRUMemo:
         except KeyError:
             pass
         else:
-            while len(self._memory) >= self._capacity:
-                self._memory.popitem(last=False)
+            oldest_keys = list(self._memory)[: -(self._capacity + 1)]
+            for key_to_delete in oldest_keys:
+                self._memory.pop(key_to_delete)
             self._memory[key] = value
 
     def clear(self):
@@ -183,60 +181,182 @@ def _escape_regex_range_chars(s: str) -> str:
     return str(s)
 
 
+class _GroupConsecutive:
+    """
+    Used as a callable `key` for itertools.groupby to group
+    characters that are consecutive:
+        itertools.groupby("abcdejkmpqrs", key=IsConsecutive())
+        yields:
+            (0, iter(['a', 'b', 'c', 'd', 'e']))
+            (1, iter(['j', 'k']))
+            (2, iter(['m']))
+            (3, iter(['p', 'q', 'r', 's']))
+    """
+    def __init__(self):
+        self.prev = 0
+        self.counter = itertools.count()
+        self.value = -1
+
+    def __call__(self, char: str) -> int:
+        c_int = ord(char)
+        self.prev, prev = c_int, self.prev
+        if c_int - prev > 1:
+            self.value = next(self.counter)
+        return self.value
+
+
 def _collapse_string_to_ranges(
     s: Union[str, Iterable[str]], re_escape: bool = True
 ) -> str:
-    def is_consecutive(c):
-        c_int = ord(c)
-        is_consecutive.prev, prev = c_int, is_consecutive.prev
-        if c_int - prev > 1:
-            is_consecutive.value = next(is_consecutive.counter)
-        return is_consecutive.value
+    r"""
+    Take a string or list of single-character strings, and return
+    a string of the consecutive characters in that string collapsed
+    into groups, as might be used in a regular expression '[a-z]'
+    character set:
+        'a' -> 'a' -> '[a]'
+        'bc' -> 'bc' -> '[bc]'
+        'defgh' -> 'd-h' -> '[d-h]'
+        'fdgeh' -> 'd-h' -> '[d-h]'
+        'jklnpqrtu' -> 'j-lnp-rtu' -> '[j-lnp-rtu]'
+    Duplicates get collapsed out:
+        'aaa' -> 'a' -> '[a]'
+        'bcbccb' -> 'bc' -> '[bc]'
+        'defghhgf' -> 'd-h' -> '[d-h]'
+        'jklnpqrjjjtu' -> 'j-lnp-rtu' -> '[j-lnp-rtu]'
+    Spaces are preserved:
+        'ab c' -> ' a-c' -> '[ a-c]'
+    Characters that are significant when defining regex ranges
+    get escaped:
+        'acde[]-' -> r'\-\[\]ac-e' -> r'[\-\[\]ac-e]'
+    """
 
-    is_consecutive.prev = 0  # type: ignore [attr-defined]
-    is_consecutive.counter = itertools.count()  # type: ignore [attr-defined]
-    is_consecutive.value = -1  # type: ignore [attr-defined]
+    # Developer notes:
+    # - Do not optimize this code assuming that the given input string
+    #   or internal lists will be short (such as in loading generators into
+    #   lists to make it easier to find the last element); this method is also
+    #   used to generate regex ranges for character sets in the pyparsing.unicode
+    #   classes, and these can be _very_ long lists of strings
 
-    def escape_re_range_char(c):
+    def escape_re_range_char(c: str) -> str:
         return "\\" + c if c in r"\^-][" else c
 
-    def no_escape_re_range_char(c):
+    def no_escape_re_range_char(c: str) -> str:
         return c
 
     if not re_escape:
         escape_re_range_char = no_escape_re_range_char
 
     ret = []
-    s = "".join(sorted(set(s)))
-    if len(s) > 3:
-        for _, chars in itertools.groupby(s, key=is_consecutive):
+
+    # reduce input string to remove duplicates, and put in sorted order
+    s_chars: list[str] = sorted(set(s))
+
+    if len(s_chars) > 2:
+        # find groups of characters that are consecutive (can be collapsed
+        # down to "<first>-<last>")
+        for _, chars in itertools.groupby(s_chars, key=_GroupConsecutive()):
+            # _ is unimportant, is just used to identify groups
+            # chars is an iterator of one or more consecutive characters
+            # that comprise the current group
             first = last = next(chars)
-            last = collections.deque(
-                itertools.chain(iter([last]), chars), maxlen=1
-            ).pop()
+            with contextlib.suppress(ValueError):
+                *_, last = chars
+
             if first == last:
+                # there was only a single char in this group
                 ret.append(escape_re_range_char(first))
+
+            elif last == chr(ord(first) + 1):
+                # there were only 2 characters in this group
+                #   'a','b' -> 'ab'
+                ret.append(f"{escape_re_range_char(first)}{escape_re_range_char(last)}")
+
             else:
-                sep = "" if ord(last) == ord(first) + 1 else "-"
+                # there were > 2 characters in this group, make into a range
+                #   'c','d','e' -> 'c-e'
                 ret.append(
-                    f"{escape_re_range_char(first)}{sep}{escape_re_range_char(last)}"
+                    f"{escape_re_range_char(first)}-{escape_re_range_char(last)}"
                 )
     else:
-        ret = [escape_re_range_char(c) for c in s]
+        # only 1 or 2 chars were given to form into groups
+        #   'a' -> ['a']
+        #   'bc' -> ['b', 'c']
+        #   'dg' -> ['d', 'g']
+        # no need to list them with "-", just return as a list
+        # (after escaping)
+        ret = [escape_re_range_char(c) for c in s_chars]
 
     return "".join(ret)
 
 
-def _flatten(ll: list) -> list:
+def _flatten(ll: Iterable) -> list:
     ret = []
-    for i in ll:
-        if isinstance(i, list):
-            ret.extend(_flatten(i))
+    to_visit = [*ll]
+    while to_visit:
+        i = to_visit.pop(0)
+        if isinstance(i, Iterable) and not isinstance(i, str):
+            to_visit[:0] = i
         else:
             ret.append(i)
     return ret
 
 
+def make_compressed_re(
+    word_list: Iterable[str], max_level: int = 2, _level: int = 1
+) -> str:
+    """
+    Create a regular expression string from a list of words, collapsing by common
+    prefixes and optional suffixes.
+
+    Calls itself recursively to build nested sublists for each group of suffixes
+    that have a shared prefix.
+    """
+
+    def get_suffixes_from_common_prefixes(namelist: list[str]):
+        if len(namelist) > 1:
+            for prefix, suffixes in itertools.groupby(namelist, key=lambda s: s[:1]):
+                yield prefix, sorted([s[1:] for s in suffixes], key=len, reverse=True)
+        else:
+            yield namelist[0][0], [namelist[0][1:]]
+
+    if max_level == 0:
+        return "|".join(sorted(word_list, key=len, reverse=True))
+
+    ret = []
+    sep = ""
+    for initial, suffixes in get_suffixes_from_common_prefixes(sorted(word_list)):
+        ret.append(sep)
+        sep = "|"
+
+        trailing = ""
+        if "" in suffixes:
+            trailing = "?"
+            suffixes.remove("")
+
+        if len(suffixes) > 1:
+            if all(len(s) == 1 for s in suffixes):
+                ret.append(f"{initial}[{''.join(suffixes)}]{trailing}")
+            else:
+                if _level < max_level:
+                    suffix_re = make_compressed_re(
+                        sorted(suffixes), max_level, _level + 1
+                    )
+                    ret.append(f"{initial}({suffix_re}){trailing}")
+                else:
+                    suffixes.sort(key=len, reverse=True)
+                    ret.append(f"{initial}({'|'.join(suffixes)}){trailing}")
+        else:
+            if suffixes:
+                suffix = suffixes[0]
+                if len(suffix) > 1 and trailing:
+                    ret.append(f"{initial}({suffix}){trailing}")
+                else:
+                    ret.append(f"{initial}{suffix}{trailing}")
+            else:
+                ret.append(initial)
+    return "".join(ret)
+
+
 def replaced_by_pep8(compat_name: str, fn: C) -> C:
     # In a future version, uncomment the code in the internal _inner() functions
     # to begin emitting DeprecationWarnings.
@@ -268,10 +388,10 @@ def replaced_by_pep8(compat_name: str, fn: C) -> C:
     _inner.__name__ = compat_name
     _inner.__annotations__ = fn.__annotations__
     if isinstance(fn, types.FunctionType):
-        _inner.__kwdefaults__ = fn.__kwdefaults__
+        _inner.__kwdefaults__ = fn.__kwdefaults__  # type: ignore [attr-defined]
     elif isinstance(fn, type) and hasattr(fn, "__init__"):
-        _inner.__kwdefaults__ = fn.__init__.__kwdefaults__
+        _inner.__kwdefaults__ = fn.__init__.__kwdefaults__  # type: ignore [misc,attr-defined]
     else:
-        _inner.__kwdefaults__ = None
+        _inner.__kwdefaults__ = None  # type: ignore [attr-defined]
     _inner.__qualname__ = fn.__qualname__
     return cast(C, _inner)
diff --git a/requirements.txt b/requirements.txt
index 01bdd50d..f3a1cad8 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -29,7 +29,7 @@ plexapi==4.15.16
 portend==3.2.0
 profilehooks==1.13.0
 PyJWT==2.9.0
-pyparsing==3.1.4
+pyparsing==3.2.0
 python-dateutil==2.9.0.post0
 python-twitter==3.5
 pytz==2024.2

From eb2c372d8240983d2bfcc98b62ce05dff4f4de51 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 19 Nov 2024 10:00:24 -0800
Subject: [PATCH 687/743] Bump bleach from 6.1.0 to 6.2.0 (#2438)

* Bump bleach from 6.1.0 to 6.2.0

Bumps [bleach](https://github.com/mozilla/bleach) from 6.1.0 to 6.2.0.
- [Changelog](https://github.com/mozilla/bleach/blob/main/CHANGES)
- [Commits](https://github.com/mozilla/bleach/compare/v6.1.0...v6.2.0)

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

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

* Update bleach==6.2.0

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/bleach/__init__.py                        |  4 ++--
 lib/bleach/_vendor/html5lib/_inputstream.py   |  4 ++--
 lib/bleach/_vendor/html5lib/_tokenizer.py     |  2 +-
 lib/bleach/_vendor/html5lib/_trie/py.py       |  2 +-
 lib/bleach/_vendor/html5lib/_utils.py         |  2 +-
 lib/bleach/_vendor/html5lib/filters/lint.py   |  2 +-
 .../_vendor/html5lib/filters/sanitizer.py     |  2 +-
 lib/bleach/_vendor/html5lib/html5parser.py    |  4 ++--
 lib/bleach/_vendor/html5lib/serializer.py     |  2 +-
 .../_vendor/html5lib/treebuilders/base.py     |  2 +-
 .../_vendor/html5lib/treebuilders/etree.py    |  2 +-
 .../html5lib/treebuilders/etree_lxml.py       |  2 +-
 .../_vendor/html5lib/treewalkers/etree.py     |  2 +-
 .../html5lib/treewalkers/etree_lxml.py        |  2 +-
 lib/bleach/_vendor/vendor_install.sh          |  4 ++++
 lib/bleach/html5lib_shim.py                   | 15 ++++++++++++---
 lib/bleach/six_shim.py                        | 19 +++++++++++++++++++
 requirements.txt                              |  2 +-
 18 files changed, 53 insertions(+), 21 deletions(-)
 create mode 100644 lib/bleach/six_shim.py

diff --git a/lib/bleach/__init__.py b/lib/bleach/__init__.py
index 12e93b4d..942987d9 100644
--- a/lib/bleach/__init__.py
+++ b/lib/bleach/__init__.py
@@ -11,9 +11,9 @@ from bleach.sanitizer import (
 
 
 # yyyymmdd
-__releasedate__ = "20231006"
+__releasedate__ = "20241029"
 # x.y.z or x.y.z.dev0 -- semver
-__version__ = "6.1.0"
+__version__ = "6.2.0"
 
 
 __all__ = ["clean", "linkify"]
diff --git a/lib/bleach/_vendor/html5lib/_inputstream.py b/lib/bleach/_vendor/html5lib/_inputstream.py
index 0207dd21..09762517 100644
--- a/lib/bleach/_vendor/html5lib/_inputstream.py
+++ b/lib/bleach/_vendor/html5lib/_inputstream.py
@@ -1,7 +1,7 @@
 from __future__ import absolute_import, division, unicode_literals
 
-from six import text_type
-from six.moves import http_client, urllib
+from bleach.six_shim import text_type
+from bleach.six_shim import http_client, urllib
 
 import codecs
 import re
diff --git a/lib/bleach/_vendor/html5lib/_tokenizer.py b/lib/bleach/_vendor/html5lib/_tokenizer.py
index 4748a197..d8848016 100644
--- a/lib/bleach/_vendor/html5lib/_tokenizer.py
+++ b/lib/bleach/_vendor/html5lib/_tokenizer.py
@@ -1,6 +1,6 @@
 from __future__ import absolute_import, division, unicode_literals
 
-from six import unichr as chr
+from bleach.six_shim import unichr as chr
 
 from collections import deque, OrderedDict
 from sys import version_info
diff --git a/lib/bleach/_vendor/html5lib/_trie/py.py b/lib/bleach/_vendor/html5lib/_trie/py.py
index c2ba3da7..56f66bd5 100644
--- a/lib/bleach/_vendor/html5lib/_trie/py.py
+++ b/lib/bleach/_vendor/html5lib/_trie/py.py
@@ -1,5 +1,5 @@
 from __future__ import absolute_import, division, unicode_literals
-from six import text_type
+from bleach.six_shim import text_type
 
 from bisect import bisect_left
 
diff --git a/lib/bleach/_vendor/html5lib/_utils.py b/lib/bleach/_vendor/html5lib/_utils.py
index 9ea57942..635bb024 100644
--- a/lib/bleach/_vendor/html5lib/_utils.py
+++ b/lib/bleach/_vendor/html5lib/_utils.py
@@ -7,7 +7,7 @@ try:
 except ImportError:
     from collections import Mapping
 
-from six import text_type, PY3
+from bleach.six_shim import text_type, PY3
 
 if PY3:
     import xml.etree.ElementTree as default_etree
diff --git a/lib/bleach/_vendor/html5lib/filters/lint.py b/lib/bleach/_vendor/html5lib/filters/lint.py
index acd4d7a2..1340d972 100644
--- a/lib/bleach/_vendor/html5lib/filters/lint.py
+++ b/lib/bleach/_vendor/html5lib/filters/lint.py
@@ -1,6 +1,6 @@
 from __future__ import absolute_import, division, unicode_literals
 
-from six import text_type
+from bleach.six_shim import text_type
 
 from . import base
 from ..constants import namespaces, voidElements
diff --git a/lib/bleach/_vendor/html5lib/filters/sanitizer.py b/lib/bleach/_vendor/html5lib/filters/sanitizer.py
index 70ef9066..5c31e974 100644
--- a/lib/bleach/_vendor/html5lib/filters/sanitizer.py
+++ b/lib/bleach/_vendor/html5lib/filters/sanitizer.py
@@ -12,7 +12,7 @@ import re
 import warnings
 from xml.sax.saxutils import escape, unescape
 
-from six.moves import urllib_parse as urlparse
+from bleach.six_shim import urllib_parse as urlparse
 
 from . import base
 from ..constants import namespaces, prefixes
diff --git a/lib/bleach/_vendor/html5lib/html5parser.py b/lib/bleach/_vendor/html5lib/html5parser.py
index 74d829d9..5427b7dd 100644
--- a/lib/bleach/_vendor/html5lib/html5parser.py
+++ b/lib/bleach/_vendor/html5lib/html5parser.py
@@ -1,5 +1,5 @@
 from __future__ import absolute_import, division, unicode_literals
-from six import with_metaclass, viewkeys
+from bleach.six_shim import viewkeys
 
 import types
 
@@ -423,7 +423,7 @@ def getPhases(debug):
             return type
 
     # pylint:disable=unused-argument
-    class Phase(with_metaclass(getMetaclass(debug, log))):
+    class Phase(metaclass=getMetaclass(debug, log)):
         """Base class for helper object that implements each phase of processing
         """
         __slots__ = ("parser", "tree", "__startTagCache", "__endTagCache")
diff --git a/lib/bleach/_vendor/html5lib/serializer.py b/lib/bleach/_vendor/html5lib/serializer.py
index c66df683..5666f49a 100644
--- a/lib/bleach/_vendor/html5lib/serializer.py
+++ b/lib/bleach/_vendor/html5lib/serializer.py
@@ -1,5 +1,5 @@
 from __future__ import absolute_import, division, unicode_literals
-from six import text_type
+from bleach.six_shim import text_type
 
 import re
 
diff --git a/lib/bleach/_vendor/html5lib/treebuilders/base.py b/lib/bleach/_vendor/html5lib/treebuilders/base.py
index e4a3d710..2869da00 100644
--- a/lib/bleach/_vendor/html5lib/treebuilders/base.py
+++ b/lib/bleach/_vendor/html5lib/treebuilders/base.py
@@ -1,5 +1,5 @@
 from __future__ import absolute_import, division, unicode_literals
-from six import text_type
+from bleach.six_shim import text_type
 
 from ..constants import scopingElements, tableInsertModeElements, namespaces
 
diff --git a/lib/bleach/_vendor/html5lib/treebuilders/etree.py b/lib/bleach/_vendor/html5lib/treebuilders/etree.py
index 086bed4e..5ccfc4d6 100644
--- a/lib/bleach/_vendor/html5lib/treebuilders/etree.py
+++ b/lib/bleach/_vendor/html5lib/treebuilders/etree.py
@@ -1,7 +1,7 @@
 from __future__ import absolute_import, division, unicode_literals
 # pylint:disable=protected-access
 
-from six import text_type
+from bleach.six_shim import text_type
 
 import re
 
diff --git a/lib/bleach/_vendor/html5lib/treebuilders/etree_lxml.py b/lib/bleach/_vendor/html5lib/treebuilders/etree_lxml.py
index e73de61a..f4622322 100644
--- a/lib/bleach/_vendor/html5lib/treebuilders/etree_lxml.py
+++ b/lib/bleach/_vendor/html5lib/treebuilders/etree_lxml.py
@@ -28,7 +28,7 @@ from . import etree as etree_builders
 from .. import _ihatexml
 
 import lxml.etree as etree
-from six import PY3, binary_type
+from bleach.six_shim import PY3, binary_type
 
 
 fullTree = True
diff --git a/lib/bleach/_vendor/html5lib/treewalkers/etree.py b/lib/bleach/_vendor/html5lib/treewalkers/etree.py
index 44653372..a9d9450c 100644
--- a/lib/bleach/_vendor/html5lib/treewalkers/etree.py
+++ b/lib/bleach/_vendor/html5lib/treewalkers/etree.py
@@ -3,7 +3,7 @@ from __future__ import absolute_import, division, unicode_literals
 from collections import OrderedDict
 import re
 
-from six import string_types
+from bleach.six_shim import string_types
 
 from . import base
 from .._utils import moduleFactoryFactory
diff --git a/lib/bleach/_vendor/html5lib/treewalkers/etree_lxml.py b/lib/bleach/_vendor/html5lib/treewalkers/etree_lxml.py
index a614ac5b..ef42163b 100644
--- a/lib/bleach/_vendor/html5lib/treewalkers/etree_lxml.py
+++ b/lib/bleach/_vendor/html5lib/treewalkers/etree_lxml.py
@@ -1,5 +1,5 @@
 from __future__ import absolute_import, division, unicode_literals
-from six import text_type
+from bleach.six_shim import text_type
 
 from collections import OrderedDict
 
diff --git a/lib/bleach/_vendor/vendor_install.sh b/lib/bleach/_vendor/vendor_install.sh
index 6e61c348..6c896ee4 100644
--- a/lib/bleach/_vendor/vendor_install.sh
+++ b/lib/bleach/_vendor/vendor_install.sh
@@ -7,8 +7,12 @@ set -o pipefail
 BLEACH_VENDOR_DIR=${BLEACH_VENDOR_DIR:-"."}
 DEST=${DEST:-"."}
 
+# Install with no dependencies
 pip install --no-binary all --no-compile --no-deps -r "${BLEACH_VENDOR_DIR}/vendor.txt" --target "${DEST}"
 
+# Apply patches
+(cd "${DEST}" && patch -p2 < 01_html5lib_six.patch)
+
 # install Python 3.6.14 urllib.urlparse for #536
 curl --proto '=https' --tlsv1.2 -o "${DEST}/parse.py" https://raw.githubusercontent.com/python/cpython/v3.6.14/Lib/urllib/parse.py
 (cd "${DEST}" && sha256sum parse.py > parse.py.SHA256SUM)
diff --git a/lib/bleach/html5lib_shim.py b/lib/bleach/html5lib_shim.py
index ca1cc8c8..f083db75 100644
--- a/lib/bleach/html5lib_shim.py
+++ b/lib/bleach/html5lib_shim.py
@@ -396,16 +396,25 @@ class BleachHTMLTokenizer(HTMLTokenizer):
                 # name that abruptly ends, but we should treat that like
                 # character data
                 yield {"type": TAG_TOKEN_TYPE_CHARACTERS, "data": self.stream.get_tag()}
+
             elif last_error_token["data"] in (
+                "duplicate-attribute",
                 "eof-in-attribute-name",
                 "eof-in-attribute-value-no-quotes",
+                "expected-end-of-tag-but-got-eof",
             ):
                 # Handle the case where the text being parsed ends with <
-                # followed by a series of characters and then space and then
-                # more characters. It's treated as a tag name followed by an
+                # followed by characters and then space and then:
+                #
+                # * more characters
+                # * more characters repeated with a space between (e.g. "abc abc")
+                # * more characters and then a space and then an EOF (e.g. "abc def ")
+                #
+                # These cases are treated as a tag name followed by an
                 # attribute that abruptly ends, but we should treat that like
-                # character data.
+                # character data instead.
                 yield {"type": TAG_TOKEN_TYPE_CHARACTERS, "data": self.stream.get_tag()}
+
             else:
                 yield last_error_token
 
diff --git a/lib/bleach/six_shim.py b/lib/bleach/six_shim.py
new file mode 100644
index 00000000..7db96011
--- /dev/null
+++ b/lib/bleach/six_shim.py
@@ -0,0 +1,19 @@
+"""
+Replacement module for what html5lib uses six for.
+"""
+
+import http.client
+import operator
+import urllib
+
+
+PY3 = True
+binary_type = bytes
+string_types = (str,)
+text_type = str
+unichr = chr
+viewkeys = operator.methodcaller("keys")
+
+http_client = http.client
+urllib = urllib
+urllib_parse = urllib.parse
diff --git a/requirements.txt b/requirements.txt
index f3a1cad8..abee3abd 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,7 +1,7 @@
 apscheduler==3.10.1
 arrow==1.3.0
 beautifulsoup4==4.12.3
-bleach==6.1.0
+bleach==6.2.0
 certifi==2024.8.30
 cheroot==10.0.1
 cherrypy==18.10.0

From 0836fb902c9d5e1c63c7a2225a5b055884038b15 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 19 Nov 2024 10:00:37 -0800
Subject: [PATCH 688/743] Bump plexapi from 4.15.16 to 4.16.0 (#2439)

* Bump plexapi from 4.15.16 to 4.16.0

Bumps [plexapi](https://github.com/pkkid/python-plexapi) from 4.15.16 to 4.16.0.
- [Release notes](https://github.com/pkkid/python-plexapi/releases)
- [Commits](https://github.com/pkkid/python-plexapi/compare/4.15.16...4.16.0)

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

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

* Update plexapi==4.16.0

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/charset_normalizer/api.py          | 78 ++++++++++++++++++++------
 lib/charset_normalizer/cli/__main__.py | 36 ++++++++++--
 lib/charset_normalizer/constant.py     |  2 +
 lib/charset_normalizer/legacy.py       | 15 ++++-
 lib/charset_normalizer/md.py           | 19 ++++++-
 lib/charset_normalizer/models.py       | 35 +++++++++---
 lib/charset_normalizer/version.py      |  2 +-
 lib/plexapi/audio.py                   |  2 +
 lib/plexapi/base.py                    |  4 +-
 lib/plexapi/collection.py              |  2 +
 lib/plexapi/const.py                   |  4 +-
 lib/plexapi/library.py                 |  2 +-
 lib/plexapi/media.py                   | 29 ++++++++++
 lib/plexapi/mixins.py                  | 62 ++++++++++++++++++++
 lib/plexapi/myplex.py                  |  4 +-
 lib/plexapi/photo.py                   |  4 ++
 lib/plexapi/playlist.py                | 14 +++++
 lib/plexapi/utils.py                   |  2 +
 lib/plexapi/video.py                   | 18 +++++-
 requirements.txt                       |  2 +-
 20 files changed, 287 insertions(+), 49 deletions(-)

diff --git a/lib/charset_normalizer/api.py b/lib/charset_normalizer/api.py
index 0ba08e3a..e3f2283b 100644
--- a/lib/charset_normalizer/api.py
+++ b/lib/charset_normalizer/api.py
@@ -159,6 +159,8 @@ def from_bytes(
 
     results: CharsetMatches = CharsetMatches()
 
+    early_stop_results: CharsetMatches = CharsetMatches()
+
     sig_encoding, sig_payload = identify_sig_or_bom(sequences)
 
     if sig_encoding is not None:
@@ -221,16 +223,20 @@ def from_bytes(
         try:
             if is_too_large_sequence and is_multi_byte_decoder is False:
                 str(
-                    sequences[: int(50e4)]
-                    if strip_sig_or_bom is False
-                    else sequences[len(sig_payload) : int(50e4)],
+                    (
+                        sequences[: int(50e4)]
+                        if strip_sig_or_bom is False
+                        else sequences[len(sig_payload) : int(50e4)]
+                    ),
                     encoding=encoding_iana,
                 )
             else:
                 decoded_payload = str(
-                    sequences
-                    if strip_sig_or_bom is False
-                    else sequences[len(sig_payload) :],
+                    (
+                        sequences
+                        if strip_sig_or_bom is False
+                        else sequences[len(sig_payload) :]
+                    ),
                     encoding=encoding_iana,
                 )
         except (UnicodeDecodeError, LookupError) as e:
@@ -367,7 +373,13 @@ def from_bytes(
                 and not lazy_str_hard_failure
             ):
                 fallback_entry = CharsetMatch(
-                    sequences, encoding_iana, threshold, False, [], decoded_payload
+                    sequences,
+                    encoding_iana,
+                    threshold,
+                    False,
+                    [],
+                    decoded_payload,
+                    preemptive_declaration=specified_encoding,
                 )
                 if encoding_iana == specified_encoding:
                     fallback_specified = fallback_entry
@@ -421,28 +433,58 @@ def from_bytes(
                 ),
             )
 
-        results.append(
-            CharsetMatch(
-                sequences,
-                encoding_iana,
-                mean_mess_ratio,
-                bom_or_sig_available,
-                cd_ratios_merged,
-                decoded_payload,
-            )
+        current_match = CharsetMatch(
+            sequences,
+            encoding_iana,
+            mean_mess_ratio,
+            bom_or_sig_available,
+            cd_ratios_merged,
+            (
+                decoded_payload
+                if (
+                    is_too_large_sequence is False
+                    or encoding_iana in [specified_encoding, "ascii", "utf_8"]
+                )
+                else None
+            ),
+            preemptive_declaration=specified_encoding,
         )
 
+        results.append(current_match)
+
         if (
             encoding_iana in [specified_encoding, "ascii", "utf_8"]
             and mean_mess_ratio < 0.1
         ):
+            # If md says nothing to worry about, then... stop immediately!
+            if mean_mess_ratio == 0.0:
+                logger.debug(
+                    "Encoding detection: %s is most likely the one.",
+                    current_match.encoding,
+                )
+                if explain:
+                    logger.removeHandler(explain_handler)
+                    logger.setLevel(previous_logger_level)
+                return CharsetMatches([current_match])
+
+            early_stop_results.append(current_match)
+
+        if (
+            len(early_stop_results)
+            and (specified_encoding is None or specified_encoding in tested)
+            and "ascii" in tested
+            and "utf_8" in tested
+        ):
+            probable_result: CharsetMatch = early_stop_results.best()  # type: ignore[assignment]
             logger.debug(
-                "Encoding detection: %s is most likely the one.", encoding_iana
+                "Encoding detection: %s is most likely the one.",
+                probable_result.encoding,
             )
             if explain:
                 logger.removeHandler(explain_handler)
                 logger.setLevel(previous_logger_level)
-            return CharsetMatches([results[encoding_iana]])
+
+            return CharsetMatches([probable_result])
 
         if encoding_iana == sig_encoding:
             logger.debug(
diff --git a/lib/charset_normalizer/cli/__main__.py b/lib/charset_normalizer/cli/__main__.py
index f4bcbaac..e7edd0fc 100644
--- a/lib/charset_normalizer/cli/__main__.py
+++ b/lib/charset_normalizer/cli/__main__.py
@@ -109,6 +109,14 @@ def cli_detect(argv: Optional[List[str]] = None) -> int:
         dest="force",
         help="Replace file without asking if you are sure, use this flag with caution.",
     )
+    parser.add_argument(
+        "-i",
+        "--no-preemptive",
+        action="store_true",
+        default=False,
+        dest="no_preemptive",
+        help="Disable looking at a charset declaration to hint the detector.",
+    )
     parser.add_argument(
         "-t",
         "--threshold",
@@ -133,21 +141,35 @@ def cli_detect(argv: Optional[List[str]] = None) -> int:
     args = parser.parse_args(argv)
 
     if args.replace is True and args.normalize is False:
+        if args.files:
+            for my_file in args.files:
+                my_file.close()
         print("Use --replace in addition of --normalize only.", file=sys.stderr)
         return 1
 
     if args.force is True and args.replace is False:
+        if args.files:
+            for my_file in args.files:
+                my_file.close()
         print("Use --force in addition of --replace only.", file=sys.stderr)
         return 1
 
     if args.threshold < 0.0 or args.threshold > 1.0:
+        if args.files:
+            for my_file in args.files:
+                my_file.close()
         print("--threshold VALUE should be between 0. AND 1.", file=sys.stderr)
         return 1
 
     x_ = []
 
     for my_file in args.files:
-        matches = from_fp(my_file, threshold=args.threshold, explain=args.verbose)
+        matches = from_fp(
+            my_file,
+            threshold=args.threshold,
+            explain=args.verbose,
+            preemptive_behaviour=args.no_preemptive is False,
+        )
 
         best_guess = matches.best()
 
@@ -155,9 +177,11 @@ def cli_detect(argv: Optional[List[str]] = None) -> int:
             print(
                 'Unable to identify originating encoding for "{}". {}'.format(
                     my_file.name,
-                    "Maybe try increasing maximum amount of chaos."
-                    if args.threshold < 1.0
-                    else "",
+                    (
+                        "Maybe try increasing maximum amount of chaos."
+                        if args.threshold < 1.0
+                        else ""
+                    ),
                 ),
                 file=sys.stderr,
             )
@@ -258,8 +282,8 @@ def cli_detect(argv: Optional[List[str]] = None) -> int:
                 try:
                     x_[0].unicode_path = join(dir_path, ".".join(o_))
 
-                    with open(x_[0].unicode_path, "w", encoding="utf-8") as fp:
-                        fp.write(str(best_guess))
+                    with open(x_[0].unicode_path, "wb") as fp:
+                        fp.write(best_guess.output())
                 except IOError as e:
                     print(str(e), file=sys.stderr)
                     if my_file.closed is False:
diff --git a/lib/charset_normalizer/constant.py b/lib/charset_normalizer/constant.py
index 86349046..f8f2a811 100644
--- a/lib/charset_normalizer/constant.py
+++ b/lib/charset_normalizer/constant.py
@@ -544,6 +544,8 @@ COMMON_SAFE_ASCII_CHARACTERS: Set[str] = {
     "|",
     '"',
     "-",
+    "(",
+    ")",
 }
 
 
diff --git a/lib/charset_normalizer/legacy.py b/lib/charset_normalizer/legacy.py
index 43aad21a..3f6d4907 100644
--- a/lib/charset_normalizer/legacy.py
+++ b/lib/charset_normalizer/legacy.py
@@ -1,13 +1,24 @@
-from typing import Any, Dict, Optional, Union
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any, Optional
 from warnings import warn
 
 from .api import from_bytes
 from .constant import CHARDET_CORRESPONDENCE
 
+# TODO: remove this check when dropping Python 3.7 support
+if TYPE_CHECKING:
+    from typing_extensions import TypedDict
+
+    class ResultDict(TypedDict):
+        encoding: Optional[str]
+        language: str
+        confidence: Optional[float]
+
 
 def detect(
     byte_str: bytes, should_rename_legacy: bool = False, **kwargs: Any
-) -> Dict[str, Optional[Union[str, float]]]:
+) -> ResultDict:
     """
     chardet legacy method
     Detect the encoding of the given byte string. It should be mostly backward-compatible.
diff --git a/lib/charset_normalizer/md.py b/lib/charset_normalizer/md.py
index 77897aae..d834db0e 100644
--- a/lib/charset_normalizer/md.py
+++ b/lib/charset_normalizer/md.py
@@ -236,7 +236,7 @@ class SuspiciousRange(MessDetectorPlugin):
 
     @property
     def ratio(self) -> float:
-        if self._character_count <= 24:
+        if self._character_count <= 13:
             return 0.0
 
         ratio_of_suspicious_range_usage: float = (
@@ -260,6 +260,7 @@ class SuperWeirdWordPlugin(MessDetectorPlugin):
 
         self._buffer: str = ""
         self._buffer_accent_count: int = 0
+        self._buffer_glyph_count: int = 0
 
     def eligible(self, character: str) -> bool:
         return True
@@ -279,6 +280,14 @@ class SuperWeirdWordPlugin(MessDetectorPlugin):
                 and is_thai(character) is False
             ):
                 self._foreign_long_watch = True
+            if (
+                is_cjk(character)
+                or is_hangul(character)
+                or is_katakana(character)
+                or is_hiragana(character)
+                or is_thai(character)
+            ):
+                self._buffer_glyph_count += 1
             return
         if not self._buffer:
             return
@@ -291,17 +300,20 @@ class SuperWeirdWordPlugin(MessDetectorPlugin):
             self._character_count += buffer_length
 
             if buffer_length >= 4:
-                if self._buffer_accent_count / buffer_length > 0.34:
+                if self._buffer_accent_count / buffer_length >= 0.5:
                     self._is_current_word_bad = True
                 # Word/Buffer ending with an upper case accentuated letter are so rare,
                 # that we will consider them all as suspicious. Same weight as foreign_long suspicious.
-                if (
+                elif (
                     is_accentuated(self._buffer[-1])
                     and self._buffer[-1].isupper()
                     and all(_.isupper() for _ in self._buffer) is False
                 ):
                     self._foreign_long_count += 1
                     self._is_current_word_bad = True
+                elif self._buffer_glyph_count == 1:
+                    self._is_current_word_bad = True
+                    self._foreign_long_count += 1
             if buffer_length >= 24 and self._foreign_long_watch:
                 camel_case_dst = [
                     i
@@ -325,6 +337,7 @@ class SuperWeirdWordPlugin(MessDetectorPlugin):
             self._foreign_long_watch = False
             self._buffer = ""
             self._buffer_accent_count = 0
+            self._buffer_glyph_count = 0
         elif (
             character not in {"<", ">", "-", "=", "~", "|", "_"}
             and character.isdigit() is False
diff --git a/lib/charset_normalizer/models.py b/lib/charset_normalizer/models.py
index a760b9c5..6f6b86b3 100644
--- a/lib/charset_normalizer/models.py
+++ b/lib/charset_normalizer/models.py
@@ -1,9 +1,10 @@
 from encodings.aliases import aliases
 from hashlib import sha256
 from json import dumps
+from re import sub
 from typing import Any, Dict, Iterator, List, Optional, Tuple, Union
 
-from .constant import TOO_BIG_SEQUENCE
+from .constant import RE_POSSIBLE_ENCODING_INDICATION, TOO_BIG_SEQUENCE
 from .utils import iana_name, is_multi_byte_encoding, unicode_range
 
 
@@ -16,6 +17,7 @@ class CharsetMatch:
         has_sig_or_bom: bool,
         languages: "CoherenceMatches",
         decoded_payload: Optional[str] = None,
+        preemptive_declaration: Optional[str] = None,
     ):
         self._payload: bytes = payload
 
@@ -33,13 +35,13 @@ class CharsetMatch:
 
         self._string: Optional[str] = decoded_payload
 
+        self._preemptive_declaration: Optional[str] = preemptive_declaration
+
     def __eq__(self, other: object) -> bool:
         if not isinstance(other, CharsetMatch):
-            raise TypeError(
-                "__eq__ cannot be invoked on {} and {}.".format(
-                    str(other.__class__), str(self.__class__)
-                )
-            )
+            if isinstance(other, str):
+                return iana_name(other) == self.encoding
+            return False
         return self.encoding == other.encoding and self.fingerprint == other.fingerprint
 
     def __lt__(self, other: object) -> bool:
@@ -210,7 +212,24 @@ class CharsetMatch:
         """
         if self._output_encoding is None or self._output_encoding != encoding:
             self._output_encoding = encoding
-            self._output_payload = str(self).encode(encoding, "replace")
+            decoded_string = str(self)
+            if (
+                self._preemptive_declaration is not None
+                and self._preemptive_declaration.lower()
+                not in ["utf-8", "utf8", "utf_8"]
+            ):
+                patched_header = sub(
+                    RE_POSSIBLE_ENCODING_INDICATION,
+                    lambda m: m.string[m.span()[0] : m.span()[1]].replace(
+                        m.groups()[0], iana_name(self._output_encoding)  # type: ignore[arg-type]
+                    ),
+                    decoded_string[:8192],
+                    1,
+                )
+
+                decoded_string = patched_header + decoded_string[8192:]
+
+            self._output_payload = decoded_string.encode(encoding, "replace")
 
         return self._output_payload  # type: ignore
 
@@ -266,7 +285,7 @@ class CharsetMatches:
                 )
             )
         # We should disable the submatch factoring when the input file is too heavy (conserve RAM usage)
-        if len(item.raw) <= TOO_BIG_SEQUENCE:
+        if len(item.raw) < TOO_BIG_SEQUENCE:
             for match in self._results:
                 if match.fingerprint == item.fingerprint and match.chaos == item.chaos:
                     match.add_submatch(item)
diff --git a/lib/charset_normalizer/version.py b/lib/charset_normalizer/version.py
index 5a4da4ff..699990ee 100644
--- a/lib/charset_normalizer/version.py
+++ b/lib/charset_normalizer/version.py
@@ -2,5 +2,5 @@
 Expose version
 """
 
-__version__ = "3.3.2"
+__version__ = "3.4.0"
 VERSION = __version__.split(".")
diff --git a/lib/plexapi/audio.py b/lib/plexapi/audio.py
index 686073a3..05d38a9c 100644
--- a/lib/plexapi/audio.py
+++ b/lib/plexapi/audio.py
@@ -33,6 +33,7 @@ class Audio(PlexPartialObject, PlayedUnplayedMixin):
             distance (float): Sonic Distance of the item from the seed item.
             fields (List<:class:`~plexapi.media.Field`>): List of field objects.
             guid (str): Plex GUID for the artist, album, or track (plex://artist/5d07bcb0403c64029053ac4c).
+            images (List<:class:`~plexapi.media.Image`>): List of image objects.
             index (int): Plex index number (often the track number).
             key (str): API URL (/library/metadata/<ratingkey>).
             lastRatedAt (datetime): Datetime the item was last rated.
@@ -65,6 +66,7 @@ class Audio(PlexPartialObject, PlayedUnplayedMixin):
         self.distance = utils.cast(float, data.attrib.get('distance'))
         self.fields = self.findItems(data, media.Field)
         self.guid = data.attrib.get('guid')
+        self.images = self.findItems(data, media.Image)
         self.index = utils.cast(int, data.attrib.get('index'))
         self.key = data.attrib.get('key', '')
         self.lastRatedAt = utils.toDatetime(data.attrib.get('lastRatedAt'))
diff --git a/lib/plexapi/base.py b/lib/plexapi/base.py
index a7fa82ee..675ac5d9 100644
--- a/lib/plexapi/base.py
+++ b/lib/plexapi/base.py
@@ -17,7 +17,7 @@ PlexObjectT = TypeVar("PlexObjectT", bound='PlexObject')
 MediaContainerT = TypeVar("MediaContainerT", bound="MediaContainer")
 
 USER_DONT_RELOAD_FOR_KEYS = set()
-_DONT_RELOAD_FOR_KEYS = {'key'}
+_DONT_RELOAD_FOR_KEYS = {'key', 'sourceURI'}
 OPERATORS = {
     'exact': lambda v, q: v == q,
     'iexact': lambda v, q: v.lower() == q.lower(),
@@ -71,7 +71,7 @@ class PlexObject:
         self._details_key = self._buildDetailsKey()
 
     def __repr__(self):
-        uid = self._clean(self.firstAttr('_baseurl', 'ratingKey', 'id', 'key', 'playQueueID', 'uri'))
+        uid = self._clean(self.firstAttr('_baseurl', 'ratingKey', 'id', 'key', 'playQueueID', 'uri', 'type'))
         name = self._clean(self.firstAttr('title', 'name', 'username', 'product', 'tag', 'value'))
         return f"<{':'.join([p for p in [self.__class__.__name__, uid, name] if p])}>"
 
diff --git a/lib/plexapi/collection.py b/lib/plexapi/collection.py
index 1c3ba3f7..63ea8373 100644
--- a/lib/plexapi/collection.py
+++ b/lib/plexapi/collection.py
@@ -39,6 +39,7 @@ class Collection(
             contentRating (str) Content rating (PG-13; NR; TV-G).
             fields (List<:class:`~plexapi.media.Field`>): List of field objects.
             guid (str): Plex GUID for the collection (collection://XXXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXX).
+            images (List<:class:`~plexapi.media.Image`>): List of image objects.
             index (int): Plex index number for the collection.
             key (str): API URL (/library/metadata/<ratingkey>).
             labels (List<:class:`~plexapi.media.Label`>): List of label objects.
@@ -82,6 +83,7 @@ class Collection(
         self.contentRating = data.attrib.get('contentRating')
         self.fields = self.findItems(data, media.Field)
         self.guid = data.attrib.get('guid')
+        self.images = self.findItems(data, media.Image)
         self.index = utils.cast(int, data.attrib.get('index'))
         self.key = data.attrib.get('key', '').replace('/children', '')  # FIX_BUG_50
         self.labels = self.findItems(data, media.Label)
diff --git a/lib/plexapi/const.py b/lib/plexapi/const.py
index 130555ad..93f7e034 100644
--- a/lib/plexapi/const.py
+++ b/lib/plexapi/const.py
@@ -3,7 +3,7 @@
 
 # Library version
 MAJOR_VERSION = 4
-MINOR_VERSION = 15
-PATCH_VERSION = 16
+MINOR_VERSION = 16
+PATCH_VERSION = 0
 __short_version__ = f"{MAJOR_VERSION}.{MINOR_VERSION}"
 __version__ = f"{__short_version__}.{PATCH_VERSION}"
diff --git a/lib/plexapi/library.py b/lib/plexapi/library.py
index 6913b829..93801a1d 100644
--- a/lib/plexapi/library.py
+++ b/lib/plexapi/library.py
@@ -1740,7 +1740,7 @@ class LibrarySection(PlexObject):
 
     def _edit(self, items=None, **kwargs):
         """ Actually edit multiple objects. """
-        if isinstance(self._edits, dict):
+        if isinstance(self._edits, dict) and items is None:
             self._edits.update(kwargs)
             return self
 
diff --git a/lib/plexapi/media.py b/lib/plexapi/media.py
index 2f76d722..9c6e3115 100644
--- a/lib/plexapi/media.py
+++ b/lib/plexapi/media.py
@@ -26,6 +26,7 @@ class Media(PlexObject):
             height (int): The height of the media in pixels (ex: 256).
             id (int): The unique ID for this media on the server.
             has64bitOffsets (bool): True if video has 64 bit offsets.
+            hasVoiceActivity (bool): True if video has voice activity analyzed.
             optimizedForStreaming (bool): True if video is optimized for streaming.
             parts (List<:class:`~plexapi.media.MediaPart`>): List of media part objects.
             proxyType (int): Equals 42 for optimized versions.
@@ -61,6 +62,7 @@ class Media(PlexObject):
         self.height = utils.cast(int, data.attrib.get('height'))
         self.id = utils.cast(int, data.attrib.get('id'))
         self.has64bitOffsets = utils.cast(bool, data.attrib.get('has64bitOffsets'))
+        self.hasVoiceActivity = utils.cast(bool, data.attrib.get('hasVoiceActivity', '0'))
         self.optimizedForStreaming = utils.cast(bool, data.attrib.get('optimizedForStreaming'))
         self.parts = self.findItems(data, MediaPart)
         self.proxyType = utils.cast(int, data.attrib.get('proxyType'))
@@ -441,6 +443,7 @@ class SubtitleStream(MediaPartStream):
         Attributes:
             TAG (str): 'Stream'
             STREAMTYPE (int): 3
+            canAutoSync (bool): True if the subtitle stream can be auto synced.
             container (str): The container of the subtitle stream.
             forced (bool): True if this is a forced subtitle.
             format (str): The format of the subtitle stream (ex: srt).
@@ -459,6 +462,7 @@ class SubtitleStream(MediaPartStream):
     def _loadData(self, data):
         """ Load attribute values from Plex XML response. """
         super(SubtitleStream, self)._loadData(data)
+        self.canAutoSync = utils.cast(bool, data.attrib.get('canAutoSync'))
         self.container = data.attrib.get('container')
         self.forced = utils.cast(bool, data.attrib.get('forced', '0'))
         self.format = data.attrib.get('format')
@@ -954,6 +958,26 @@ class Guid(PlexObject):
         self.id = data.attrib.get('id')
 
 
+@utils.registerPlexObject
+class Image(PlexObject):
+    """ Represents a single Image media tag.
+
+        Attributes:
+            TAG (str): 'Image'
+            alt (str): The alt text for the image.
+            type (str): The type of image (e.g. coverPoster, background, snapshot).
+            url (str): The API URL (/library/metadata/<ratingKey>/thumb/<thumbid>).
+    """
+    TAG = 'Image'
+
+    def _loadData(self, data):
+        """ Load attribute values from Plex XML response. """
+        self._data = data
+        self.alt = data.attrib.get('alt')
+        self.type = data.attrib.get('type')
+        self.url = data.attrib.get('url')
+
+
 @utils.registerPlexObject
 class Rating(PlexObject):
     """ Represents a single Rating media tag.
@@ -1074,6 +1098,11 @@ class Art(BaseResource):
     TAG = 'Photo'
 
 
+class Logo(BaseResource):
+    """ Represents a single Logo object. """
+    TAG = 'Photo'
+
+
 class Poster(BaseResource):
     """ Represents a single Poster object. """
     TAG = 'Photo'
diff --git a/lib/plexapi/mixins.py b/lib/plexapi/mixins.py
index bdf4607e..95f785fc 100644
--- a/lib/plexapi/mixins.py
+++ b/lib/plexapi/mixins.py
@@ -403,6 +403,63 @@ class ArtMixin(ArtUrlMixin, ArtLockMixin):
         return self
 
 
+class LogoUrlMixin:
+    """ Mixin for Plex objects that can have a logo url. """
+
+    @property
+    def logoUrl(self):
+        """ Return the logo url for the Plex object. """
+        image = next((i for i in self.images if i.type == 'clearLogo'), None)
+        return self._server.url(image.url, includeToken=True) if image else None
+
+
+class LogoLockMixin:
+    """ Mixin for Plex objects that can have a locked logo. """
+
+    def lockLogo(self):
+        """ Lock the logo for a Plex object. """
+        raise NotImplementedError('Logo cannot be locked through the API.')
+
+    def unlockLogo(self):
+        """ Unlock the logo for a Plex object. """
+        raise NotImplementedError('Logo cannot be unlocked through the API.')
+
+
+class LogoMixin(LogoUrlMixin, LogoLockMixin):
+    """ Mixin for Plex objects that can have logos. """
+
+    def logos(self):
+        """ Returns list of available :class:`~plexapi.media.Logo` objects. """
+        return self.fetchItems(f'/library/metadata/{self.ratingKey}/clearLogos', cls=media.Logo)
+
+    def uploadLogo(self, url=None, filepath=None):
+        """ Upload a logo from a url or filepath.
+
+            Parameters:
+                url (str): The full URL to the image to upload.
+                filepath (str): The full file path the the image to upload or file-like object.
+        """
+        if url:
+            key = f'/library/metadata/{self.ratingKey}/clearLogos?url={quote_plus(url)}'
+            self._server.query(key, method=self._server._session.post)
+        elif filepath:
+            key = f'/library/metadata/{self.ratingKey}/clearLogos'
+            data = openOrRead(filepath)
+            self._server.query(key, method=self._server._session.post, data=data)
+        return self
+
+    def setLogo(self, logo):
+        """ Set the logo for a Plex object.
+
+            Raises:
+                :exc:`~plexapi.exceptions.NotImplementedError`: Logo cannot be set through the API.
+        """
+        raise NotImplementedError(
+            'Logo cannot be set through the API. '
+            'Re-upload the logo using "uploadLogo" to set it.'
+        )
+
+
 class PosterUrlMixin:
     """ Mixin for Plex objects that can have a poster url. """
 
@@ -513,6 +570,11 @@ class ThemeMixin(ThemeUrlMixin, ThemeLockMixin):
         return self
 
     def setTheme(self, theme):
+        """ Set the theme for a Plex object.
+
+            Raises:
+                :exc:`~plexapi.exceptions.NotImplementedError`: Themes cannot be set through the API.
+        """
         raise NotImplementedError(
             'Themes cannot be set through the API. '
             'Re-upload the theme using "uploadTheme" to set it.'
diff --git a/lib/plexapi/myplex.py b/lib/plexapi/myplex.py
index 24e32e6b..448a2649 100644
--- a/lib/plexapi/myplex.py
+++ b/lib/plexapi/myplex.py
@@ -283,10 +283,10 @@ class MyPlexAccount(PlexObject):
         """ Returns the :class:`~plexapi.myplex.MyPlexResource` that matches the name specified.
 
             Parameters:
-                name (str): Name to match against.
+                name (str): Name  or machine identifier to match against.
         """
         for resource in self.resources():
-            if resource.name.lower() == name.lower():
+            if resource.name.lower() == name.lower() or resource.clientIdentifier == name:
                 return resource
         raise NotFound(f'Unable to find resource {name}')
 
diff --git a/lib/plexapi/photo.py b/lib/plexapi/photo.py
index c68b3613..4347f31a 100644
--- a/lib/plexapi/photo.py
+++ b/lib/plexapi/photo.py
@@ -30,6 +30,7 @@ class Photoalbum(
             composite (str): URL to composite image (/library/metadata/<ratingKey>/composite/<compositeid>)
             fields (List<:class:`~plexapi.media.Field`>): List of field objects.
             guid (str): Plex GUID for the photo album (local://229674).
+            images (List<:class:`~plexapi.media.Image`>): List of image objects.
             index (sting): Plex index number for the photo album.
             key (str): API URL (/library/metadata/<ratingkey>).
             lastRatedAt (datetime): Datetime the photo album was last rated.
@@ -57,6 +58,7 @@ class Photoalbum(
         self.composite = data.attrib.get('composite')
         self.fields = self.findItems(data, media.Field)
         self.guid = data.attrib.get('guid')
+        self.images = self.findItems(data, media.Image)
         self.index = utils.cast(int, data.attrib.get('index'))
         self.key = data.attrib.get('key', '').replace('/children', '')  # FIX_BUG_50
         self.lastRatedAt = utils.toDatetime(data.attrib.get('lastRatedAt'))
@@ -164,6 +166,7 @@ class Photo(
             createdAtTZOffset (int): Unknown (-25200).
             fields (List<:class:`~plexapi.media.Field`>): List of field objects.
             guid (str): Plex GUID for the photo (com.plexapp.agents.none://231714?lang=xn).
+            images (List<:class:`~plexapi.media.Image`>): List of image objects.
             index (sting): Plex index number for the photo.
             key (str): API URL (/library/metadata/<ratingkey>).
             lastRatedAt (datetime): Datetime the photo was last rated.
@@ -204,6 +207,7 @@ class Photo(
         self.createdAtTZOffset = utils.cast(int, data.attrib.get('createdAtTZOffset'))
         self.fields = self.findItems(data, media.Field)
         self.guid = data.attrib.get('guid')
+        self.images = self.findItems(data, media.Image)
         self.index = utils.cast(int, data.attrib.get('index'))
         self.key = data.attrib.get('key', '')
         self.lastRatedAt = utils.toDatetime(data.attrib.get('lastRatedAt'))
diff --git a/lib/plexapi/playlist.py b/lib/plexapi/playlist.py
index dda3bdf5..e2c4da63 100644
--- a/lib/plexapi/playlist.py
+++ b/lib/plexapi/playlist.py
@@ -190,6 +190,20 @@ class Playlist(
         if self._items is None:
             key = f'{self.key}/items'
             items = self.fetchItems(key)
+
+            # Cache server connections to avoid reconnecting for each item
+            _servers = {}
+            for item in items:
+                if item.sourceURI:
+                    serverID = item.sourceURI.split('/')[2]
+                    if serverID not in _servers:
+                        try:
+                            _servers[serverID] = self._server.myPlexAccount().resource(serverID).connect()
+                        except NotFound:
+                            # Override the server connection with None if the server is not found
+                            _servers[serverID] = None
+                    item._server = _servers[serverID]
+
             self._items = items
         return self._items
 
diff --git a/lib/plexapi/utils.py b/lib/plexapi/utils.py
index 549afc5b..dd1cfc9c 100644
--- a/lib/plexapi/utils.py
+++ b/lib/plexapi/utils.py
@@ -90,6 +90,8 @@ TAGTYPES = {
     'theme': 317,
     'studio': 318,
     'network': 319,
+    'showOrdering': 322,
+    'clearLogo': 323,
     'place': 400,
 }
 REVERSETAGTYPES = {v: k for k, v in TAGTYPES.items()}
diff --git a/lib/plexapi/video.py b/lib/plexapi/video.py
index 15755415..6e811aa4 100644
--- a/lib/plexapi/video.py
+++ b/lib/plexapi/video.py
@@ -9,7 +9,7 @@ from plexapi.base import Playable, PlexPartialObject, PlexHistory, PlexSession
 from plexapi.exceptions import BadRequest
 from plexapi.mixins import (
     AdvancedSettingsMixin, SplitMergeMixin, UnmatchMatchMixin, ExtrasMixin, HubsMixin, PlayedUnplayedMixin, RatingMixin,
-    ArtUrlMixin, ArtMixin, PosterUrlMixin, PosterMixin, ThemeUrlMixin, ThemeMixin,
+    ArtUrlMixin, ArtMixin, LogoMixin, PosterUrlMixin, PosterMixin, ThemeUrlMixin, ThemeMixin,
     MovieEditMixins, ShowEditMixins, SeasonEditMixins, EpisodeEditMixins,
     WatchlistMixin
 )
@@ -26,6 +26,7 @@ class Video(PlexPartialObject, PlayedUnplayedMixin):
             artBlurHash (str): BlurHash string for artwork image.
             fields (List<:class:`~plexapi.media.Field`>): List of field objects.
             guid (str): Plex GUID for the movie, show, season, episode, or clip (plex://movie/5d776b59ad5437001f79c6f8).
+            images (List<:class:`~plexapi.media.Image`>): List of image objects.
             key (str): API URL (/library/metadata/<ratingkey>).
             lastRatedAt (datetime): Datetime the item was last rated.
             lastViewedAt (datetime): Datetime the item was last played.
@@ -53,6 +54,7 @@ class Video(PlexPartialObject, PlayedUnplayedMixin):
         self.artBlurHash = data.attrib.get('artBlurHash')
         self.fields = self.findItems(data, media.Field)
         self.guid = data.attrib.get('guid')
+        self.images = self.findItems(data, media.Image)
         self.key = data.attrib.get('key', '')
         self.lastRatedAt = utils.toDatetime(data.attrib.get('lastRatedAt'))
         self.lastViewedAt = utils.toDatetime(data.attrib.get('lastViewedAt'))
@@ -332,7 +334,7 @@ class Video(PlexPartialObject, PlayedUnplayedMixin):
 class Movie(
     Video, Playable,
     AdvancedSettingsMixin, SplitMergeMixin, UnmatchMatchMixin, ExtrasMixin, HubsMixin, RatingMixin,
-    ArtMixin, PosterMixin, ThemeMixin,
+    ArtMixin, LogoMixin, PosterMixin, ThemeMixin,
     MovieEditMixins,
     WatchlistMixin
 ):
@@ -447,6 +449,11 @@ class Movie(
         """ Returns True if the movie has a credits marker. """
         return any(marker.type == 'credits' for marker in self.markers)
 
+    @property
+    def hasVoiceActivity(self):
+        """ Returns True if any of the media has voice activity analyzed. """
+        return any(media.hasVoiceActivity for media in self.media)
+
     @property
     def hasPreviewThumbnails(self):
         """ Returns True if any of the media parts has generated preview (BIF) thumbnails. """
@@ -489,7 +496,7 @@ class Movie(
 class Show(
     Video,
     AdvancedSettingsMixin, SplitMergeMixin, UnmatchMatchMixin, ExtrasMixin, HubsMixin, RatingMixin,
-    ArtMixin, PosterMixin, ThemeMixin,
+    ArtMixin, LogoMixin, PosterMixin, ThemeMixin,
     ShowEditMixins,
     WatchlistMixin
 ):
@@ -1077,6 +1084,11 @@ class Episode(
         """ Returns True if the episode has a credits marker. """
         return any(marker.type == 'credits' for marker in self.markers)
 
+    @property
+    def hasVoiceActivity(self):
+        """ Returns True if any of the media has voice activity analyzed. """
+        return any(media.hasVoiceActivity for media in self.media)
+
     @property
     def hasPreviewThumbnails(self):
         """ Returns True if any of the media parts has generated preview (BIF) thumbnails. """
diff --git a/requirements.txt b/requirements.txt
index abee3abd..cfd8b7e5 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -25,7 +25,7 @@ musicbrainzngs==0.7.1
 packaging==24.2
 paho-mqtt==2.1.0
 platformdirs==4.3.6
-plexapi==4.15.16
+plexapi==4.16.0
 portend==3.2.0
 profilehooks==1.13.0
 PyJWT==2.9.0

From feca713b76af848359b477daa73929304b35fd8c Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 19 Nov 2024 10:00:50 -0800
Subject: [PATCH 689/743] Bump dnspython from 2.6.1 to 2.7.0 (#2440)

* Bump dnspython from 2.6.1 to 2.7.0

Bumps [dnspython](https://github.com/rthalley/dnspython) from 2.6.1 to 2.7.0.
- [Release notes](https://github.com/rthalley/dnspython/releases)
- [Changelog](https://github.com/rthalley/dnspython/blob/main/doc/whatsnew.rst)
- [Commits](https://github.com/rthalley/dnspython/compare/v2.6.1...v2.7.0)

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

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

* Update dnspython==2.7.0

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/dns/_asyncbackend.py        |   7 +-
 lib/dns/_asyncio_backend.py     |   8 +-
 lib/dns/_features.py            |   9 +-
 lib/dns/_trio_backend.py        |  17 +-
 lib/dns/asyncquery.py           | 451 ++++++++++++++++----------
 lib/dns/dnssec.py               |  38 ++-
 lib/dns/dnssecalgs/__init__.py  |   3 +-
 lib/dns/dnssecalgs/base.py      |   7 +-
 lib/dns/dnssecalgs/dsa.py       |   7 +-
 lib/dns/dnssecalgs/ecdsa.py     |  12 +-
 lib/dns/dnssecalgs/eddsa.py     |   7 +-
 lib/dns/dnssecalgs/rsa.py       |   7 +-
 lib/dns/edns.py                 |  72 ++++-
 lib/dns/exception.py            |   2 +-
 lib/dns/grange.py               |   2 +-
 lib/dns/ipv6.py                 |   4 +-
 lib/dns/message.py              | 111 +++++--
 lib/dns/name.py                 |   5 +-
 lib/dns/nameserver.py           |   4 +
 lib/dns/query.py                | 545 ++++++++++++++++++--------------
 lib/dns/quic/__init__.py        |   5 +
 lib/dns/quic/_asyncio.py        |  75 +++--
 lib/dns/quic/_common.py         | 127 +++++++-
 lib/dns/quic/_sync.py           |  99 ++++--
 lib/dns/quic/_trio.py           |  54 +++-
 lib/dns/rdata.py                |  57 +++-
 lib/dns/rdataset.py             |  10 +-
 lib/dns/rdatatype.py            |   6 +-
 lib/dns/rdtypes/ANY/GPOS.py     |   5 +-
 lib/dns/rdtypes/ANY/HINFO.py    |   4 +-
 lib/dns/rdtypes/ANY/HIP.py      |   2 +-
 lib/dns/rdtypes/ANY/ISDN.py     |   7 +-
 lib/dns/rdtypes/ANY/LOC.py      |  13 +-
 lib/dns/rdtypes/ANY/NSEC.py     |   2 +-
 lib/dns/rdtypes/ANY/RESINFO.py  |  24 ++
 lib/dns/rdtypes/ANY/RP.py       |   2 +-
 lib/dns/rdtypes/ANY/TKEY.py     |   2 +-
 lib/dns/rdtypes/ANY/WALLET.py   |   9 +
 lib/dns/rdtypes/ANY/X25.py      |   2 +-
 lib/dns/rdtypes/ANY/__init__.py |   2 +
 lib/dns/rdtypes/CH/A.py         |   2 +-
 lib/dns/rdtypes/IN/NSAP.py      |   2 +-
 lib/dns/rdtypes/euibase.py      |   8 +-
 lib/dns/rdtypes/svcbbase.py     |  32 ++
 lib/dns/rdtypes/txtbase.py      |   4 +-
 lib/dns/rdtypes/util.py         |   2 +-
 lib/dns/resolver.py             |  39 ++-
 lib/dns/set.py                  |  11 +-
 lib/dns/tokenizer.py            |   2 +-
 lib/dns/transaction.py          |   4 +-
 lib/dns/ttl.py                  |   2 +-
 lib/dns/version.py              |   4 +-
 lib/dns/win32util.py            |  40 +--
 lib/dns/xfr.py                  |   2 +-
 lib/dns/zonefile.py             |  66 ++--
 requirements.txt                |   2 +-
 56 files changed, 1382 insertions(+), 665 deletions(-)
 create mode 100644 lib/dns/rdtypes/ANY/RESINFO.py
 create mode 100644 lib/dns/rdtypes/ANY/WALLET.py

diff --git a/lib/dns/_asyncbackend.py b/lib/dns/_asyncbackend.py
index 49f14fed..f6760fd0 100644
--- a/lib/dns/_asyncbackend.py
+++ b/lib/dns/_asyncbackend.py
@@ -26,6 +26,10 @@ class NullContext:
 
 
 class Socket:  # pragma: no cover
+    def __init__(self, family: int, type: int):
+        self.family = family
+        self.type = type
+
     async def close(self):
         pass
 
@@ -46,9 +50,6 @@ class Socket:  # pragma: no cover
 
 
 class DatagramSocket(Socket):  # pragma: no cover
-    def __init__(self, family: int):
-        self.family = family
-
     async def sendto(self, what, destination, timeout):
         raise NotImplementedError
 
diff --git a/lib/dns/_asyncio_backend.py b/lib/dns/_asyncio_backend.py
index 9d9ed369..6ab168de 100644
--- a/lib/dns/_asyncio_backend.py
+++ b/lib/dns/_asyncio_backend.py
@@ -42,7 +42,7 @@ class _DatagramProtocol:
             if exc is None:
                 # EOF we triggered.  Is there a better way to do this?
                 try:
-                    raise EOFError
+                    raise EOFError("EOF")
                 except EOFError as e:
                     self.recvfrom.set_exception(e)
             else:
@@ -64,7 +64,7 @@ async def _maybe_wait_for(awaitable, timeout):
 
 class DatagramSocket(dns._asyncbackend.DatagramSocket):
     def __init__(self, family, transport, protocol):
-        super().__init__(family)
+        super().__init__(family, socket.SOCK_DGRAM)
         self.transport = transport
         self.protocol = protocol
 
@@ -99,7 +99,7 @@ class DatagramSocket(dns._asyncbackend.DatagramSocket):
 
 class StreamSocket(dns._asyncbackend.StreamSocket):
     def __init__(self, af, reader, writer):
-        self.family = af
+        super().__init__(af, socket.SOCK_STREAM)
         self.reader = reader
         self.writer = writer
 
@@ -197,7 +197,7 @@ if dns._features.have("doh"):
             family=socket.AF_UNSPEC,
             **kwargs,
         ):
-            if resolver is None:
+            if resolver is None and bootstrap_address is None:
                 # pylint: disable=import-outside-toplevel,redefined-outer-name
                 import dns.asyncresolver
 
diff --git a/lib/dns/_features.py b/lib/dns/_features.py
index 03ccaa77..fa6d4955 100644
--- a/lib/dns/_features.py
+++ b/lib/dns/_features.py
@@ -32,6 +32,9 @@ def _version_check(
     package, minimum = requirement.split(">=")
     try:
         version = importlib.metadata.version(package)
+        # This shouldn't happen, but it apparently can.
+        if version is None:
+            return False
     except Exception:
         return False
     t_version = _tuple_from_text(version)
@@ -82,10 +85,10 @@ def force(feature: str, enabled: bool) -> None:
 
 _requirements: Dict[str, List[str]] = {
     ### BEGIN generated requirements
-    "dnssec": ["cryptography>=41"],
+    "dnssec": ["cryptography>=43"],
     "doh": ["httpcore>=1.0.0", "httpx>=0.26.0", "h2>=4.1.0"],
-    "doq": ["aioquic>=0.9.25"],
-    "idna": ["idna>=3.6"],
+    "doq": ["aioquic>=1.0.0"],
+    "idna": ["idna>=3.7"],
     "trio": ["trio>=0.23"],
     "wmi": ["wmi>=1.5.1"],
     ### END generated requirements
diff --git a/lib/dns/_trio_backend.py b/lib/dns/_trio_backend.py
index 398e3276..0ed904dd 100644
--- a/lib/dns/_trio_backend.py
+++ b/lib/dns/_trio_backend.py
@@ -30,13 +30,16 @@ _lltuple = dns.inet.low_level_address_tuple
 
 
 class DatagramSocket(dns._asyncbackend.DatagramSocket):
-    def __init__(self, socket):
-        super().__init__(socket.family)
-        self.socket = socket
+    def __init__(self, sock):
+        super().__init__(sock.family, socket.SOCK_DGRAM)
+        self.socket = sock
 
     async def sendto(self, what, destination, timeout):
         with _maybe_timeout(timeout):
-            return await self.socket.sendto(what, destination)
+            if destination is None:
+                return await self.socket.send(what)
+            else:
+                return await self.socket.sendto(what, destination)
         raise dns.exception.Timeout(
             timeout=timeout
         )  # pragma: no cover  lgtm[py/unreachable-statement]
@@ -61,7 +64,7 @@ class DatagramSocket(dns._asyncbackend.DatagramSocket):
 
 class StreamSocket(dns._asyncbackend.StreamSocket):
     def __init__(self, family, stream, tls=False):
-        self.family = family
+        super().__init__(family, socket.SOCK_STREAM)
         self.stream = stream
         self.tls = tls
 
@@ -171,7 +174,7 @@ if dns._features.have("doh"):
             family=socket.AF_UNSPEC,
             **kwargs,
         ):
-            if resolver is None:
+            if resolver is None and bootstrap_address is None:
                 # pylint: disable=import-outside-toplevel,redefined-outer-name
                 import dns.asyncresolver
 
@@ -205,7 +208,7 @@ class Backend(dns._asyncbackend.Backend):
         try:
             if source:
                 await s.bind(_lltuple(source, af))
-            if socktype == socket.SOCK_STREAM:
+            if socktype == socket.SOCK_STREAM or destination is not None:
                 connected = False
                 with _maybe_timeout(timeout):
                     await s.connect(_lltuple(destination, af))
diff --git a/lib/dns/asyncquery.py b/lib/dns/asyncquery.py
index 4d9ab9ae..efad0fd7 100644
--- a/lib/dns/asyncquery.py
+++ b/lib/dns/asyncquery.py
@@ -19,10 +19,12 @@
 
 import base64
 import contextlib
+import random
 import socket
 import struct
 import time
-from typing import Any, Dict, Optional, Tuple, Union
+import urllib.parse
+from typing import Any, Dict, Optional, Tuple, Union, cast
 
 import dns.asyncbackend
 import dns.exception
@@ -37,9 +39,11 @@ import dns.transaction
 from dns._asyncbackend import NullContext
 from dns.query import (
     BadResponse,
+    HTTPVersion,
     NoDOH,
     NoDOQ,
     UDPMode,
+    _check_status,
     _compute_times,
     _make_dot_ssl_context,
     _matches_destination,
@@ -338,7 +342,7 @@ async def _read_exactly(sock, count, expiration):
     while count > 0:
         n = await sock.recv(count, _timeout(expiration))
         if n == b"":
-            raise EOFError
+            raise EOFError("EOF")
         count = count - len(n)
         s = s + n
     return s
@@ -500,6 +504,20 @@ async def tls(
         return response
 
 
+def _maybe_get_resolver(
+    resolver: Optional["dns.asyncresolver.Resolver"],
+) -> "dns.asyncresolver.Resolver":
+    # We need a separate method for this to avoid overriding the global
+    # variable "dns" with the as-yet undefined local variable "dns"
+    # in https().
+    if resolver is None:
+        # pylint: disable=import-outside-toplevel,redefined-outer-name
+        import dns.asyncresolver
+
+        resolver = dns.asyncresolver.Resolver()
+    return resolver
+
+
 async def https(
     q: dns.message.Message,
     where: str,
@@ -515,7 +533,8 @@ async def https(
     verify: Union[bool, str] = True,
     bootstrap_address: Optional[str] = None,
     resolver: Optional["dns.asyncresolver.Resolver"] = None,
-    family: Optional[int] = socket.AF_UNSPEC,
+    family: int = socket.AF_UNSPEC,
+    http_version: HTTPVersion = HTTPVersion.DEFAULT,
 ) -> dns.message.Message:
     """Return the response obtained after sending a query via DNS-over-HTTPS.
 
@@ -529,26 +548,65 @@ async def https(
     parameters, exceptions, and return type of this method.
     """
 
-    if not have_doh:
-        raise NoDOH  # pragma: no cover
-    if client and not isinstance(client, httpx.AsyncClient):
-        raise ValueError("session parameter must be an httpx.AsyncClient")
-
-    wire = q.to_wire()
     try:
         af = dns.inet.af_for_address(where)
     except ValueError:
         af = None
-    transport = None
-    headers = {"accept": "application/dns-message"}
     if af is not None and dns.inet.is_address(where):
         if af == socket.AF_INET:
-            url = "https://{}:{}{}".format(where, port, path)
+            url = f"https://{where}:{port}{path}"
         elif af == socket.AF_INET6:
-            url = "https://[{}]:{}{}".format(where, port, path)
+            url = f"https://[{where}]:{port}{path}"
     else:
         url = where
 
+    extensions = {}
+    if bootstrap_address is None:
+        # pylint: disable=possibly-used-before-assignment
+        parsed = urllib.parse.urlparse(url)
+        if parsed.hostname is None:
+            raise ValueError("no hostname in URL")
+        if dns.inet.is_address(parsed.hostname):
+            bootstrap_address = parsed.hostname
+            extensions["sni_hostname"] = parsed.hostname
+        if parsed.port is not None:
+            port = parsed.port
+
+    if http_version == HTTPVersion.H3 or (
+        http_version == HTTPVersion.DEFAULT and not have_doh
+    ):
+        if bootstrap_address is None:
+            resolver = _maybe_get_resolver(resolver)
+            assert parsed.hostname is not None  # for mypy
+            answers = await resolver.resolve_name(parsed.hostname, family)
+            bootstrap_address = random.choice(list(answers.addresses()))
+        return await _http3(
+            q,
+            bootstrap_address,
+            url,
+            timeout,
+            port,
+            source,
+            source_port,
+            one_rr_per_rrset,
+            ignore_trailing,
+            verify=verify,
+            post=post,
+        )
+
+    if not have_doh:
+        raise NoDOH  # pragma: no cover
+    # pylint: disable=possibly-used-before-assignment
+    if client and not isinstance(client, httpx.AsyncClient):
+        raise ValueError("session parameter must be an httpx.AsyncClient")
+    # pylint: enable=possibly-used-before-assignment
+
+    wire = q.to_wire()
+    headers = {"accept": "application/dns-message"}
+
+    h1 = http_version in (HTTPVersion.H1, HTTPVersion.DEFAULT)
+    h2 = http_version in (HTTPVersion.H2, HTTPVersion.DEFAULT)
+
     backend = dns.asyncbackend.get_default_backend()
 
     if source is None:
@@ -557,24 +615,23 @@ async def https(
     else:
         local_address = source
         local_port = source_port
-    transport = backend.get_transport_class()(
-        local_address=local_address,
-        http1=True,
-        http2=True,
-        verify=verify,
-        local_port=local_port,
-        bootstrap_address=bootstrap_address,
-        resolver=resolver,
-        family=family,
-    )
 
     if client:
         cm: contextlib.AbstractAsyncContextManager = NullContext(client)
     else:
-        cm = httpx.AsyncClient(
-            http1=True, http2=True, verify=verify, transport=transport
+        transport = backend.get_transport_class()(
+            local_address=local_address,
+            http1=h1,
+            http2=h2,
+            verify=verify,
+            local_port=local_port,
+            bootstrap_address=bootstrap_address,
+            resolver=resolver,
+            family=family,
         )
 
+        cm = httpx.AsyncClient(http1=h1, http2=h2, verify=verify, transport=transport)
+
     async with cm as the_client:
         # see https://tools.ietf.org/html/rfc8484#section-4.1.1 for DoH
         # GET and POST examples
@@ -586,23 +643,33 @@ async def https(
                 }
             )
             response = await backend.wait_for(
-                the_client.post(url, headers=headers, content=wire), timeout
+                the_client.post(
+                    url,
+                    headers=headers,
+                    content=wire,
+                    extensions=extensions,
+                ),
+                timeout,
             )
         else:
             wire = base64.urlsafe_b64encode(wire).rstrip(b"=")
             twire = wire.decode()  # httpx does a repr() if we give it bytes
             response = await backend.wait_for(
-                the_client.get(url, headers=headers, params={"dns": twire}), timeout
+                the_client.get(
+                    url,
+                    headers=headers,
+                    params={"dns": twire},
+                    extensions=extensions,
+                ),
+                timeout,
             )
 
     # see https://tools.ietf.org/html/rfc8484#section-4.2.1 for info about DoH
     # status codes
     if response.status_code < 200 or response.status_code > 299:
         raise ValueError(
-            "{} responded with status code {}"
-            "\nResponse body: {!r}".format(
-                where, response.status_code, response.content
-            )
+            f"{where} responded with status code {response.status_code}"
+            f"\nResponse body: {response.content!r}"
         )
     r = dns.message.from_wire(
         response.content,
@@ -617,6 +684,181 @@ async def https(
     return r
 
 
+async def _http3(
+    q: dns.message.Message,
+    where: str,
+    url: str,
+    timeout: Optional[float] = None,
+    port: int = 853,
+    source: Optional[str] = None,
+    source_port: int = 0,
+    one_rr_per_rrset: bool = False,
+    ignore_trailing: bool = False,
+    verify: Union[bool, str] = True,
+    backend: Optional[dns.asyncbackend.Backend] = None,
+    hostname: Optional[str] = None,
+    post: bool = True,
+) -> dns.message.Message:
+    if not dns.quic.have_quic:
+        raise NoDOH("DNS-over-HTTP3 is not available.")  # pragma: no cover
+
+    url_parts = urllib.parse.urlparse(url)
+    hostname = url_parts.hostname
+    if url_parts.port is not None:
+        port = url_parts.port
+
+    q.id = 0
+    wire = q.to_wire()
+    (cfactory, mfactory) = dns.quic.factories_for_backend(backend)
+
+    async with cfactory() as context:
+        async with mfactory(
+            context, verify_mode=verify, server_name=hostname, h3=True
+        ) as the_manager:
+            the_connection = the_manager.connect(where, port, source, source_port)
+            (start, expiration) = _compute_times(timeout)
+            stream = await the_connection.make_stream(timeout)
+            async with stream:
+                # note that send_h3() does not need await
+                stream.send_h3(url, wire, post)
+                wire = await stream.receive(_remaining(expiration))
+                _check_status(stream.headers(), where, wire)
+            finish = time.time()
+        r = dns.message.from_wire(
+            wire,
+            keyring=q.keyring,
+            request_mac=q.request_mac,
+            one_rr_per_rrset=one_rr_per_rrset,
+            ignore_trailing=ignore_trailing,
+        )
+    r.time = max(finish - start, 0.0)
+    if not q.is_response(r):
+        raise BadResponse
+    return r
+
+
+async def quic(
+    q: dns.message.Message,
+    where: str,
+    timeout: Optional[float] = None,
+    port: int = 853,
+    source: Optional[str] = None,
+    source_port: int = 0,
+    one_rr_per_rrset: bool = False,
+    ignore_trailing: bool = False,
+    connection: Optional[dns.quic.AsyncQuicConnection] = None,
+    verify: Union[bool, str] = True,
+    backend: Optional[dns.asyncbackend.Backend] = None,
+    hostname: Optional[str] = None,
+    server_hostname: Optional[str] = None,
+) -> dns.message.Message:
+    """Return the response obtained after sending an asynchronous query via
+    DNS-over-QUIC.
+
+    *backend*, a ``dns.asyncbackend.Backend``, or ``None``.  If ``None``,
+    the default, then dnspython will use the default backend.
+
+    See :py:func:`dns.query.quic()` for the documentation of the other
+    parameters, exceptions, and return type of this method.
+    """
+
+    if not dns.quic.have_quic:
+        raise NoDOQ("DNS-over-QUIC is not available.")  # pragma: no cover
+
+    if server_hostname is not None and hostname is None:
+        hostname = server_hostname
+
+    q.id = 0
+    wire = q.to_wire()
+    the_connection: dns.quic.AsyncQuicConnection
+    if connection:
+        cfactory = dns.quic.null_factory
+        mfactory = dns.quic.null_factory
+        the_connection = connection
+    else:
+        (cfactory, mfactory) = dns.quic.factories_for_backend(backend)
+
+    async with cfactory() as context:
+        async with mfactory(
+            context,
+            verify_mode=verify,
+            server_name=server_hostname,
+        ) as the_manager:
+            if not connection:
+                the_connection = the_manager.connect(where, port, source, source_port)
+            (start, expiration) = _compute_times(timeout)
+            stream = await the_connection.make_stream(timeout)
+            async with stream:
+                await stream.send(wire, True)
+                wire = await stream.receive(_remaining(expiration))
+            finish = time.time()
+        r = dns.message.from_wire(
+            wire,
+            keyring=q.keyring,
+            request_mac=q.request_mac,
+            one_rr_per_rrset=one_rr_per_rrset,
+            ignore_trailing=ignore_trailing,
+        )
+    r.time = max(finish - start, 0.0)
+    if not q.is_response(r):
+        raise BadResponse
+    return r
+
+
+async def _inbound_xfr(
+    txn_manager: dns.transaction.TransactionManager,
+    s: dns.asyncbackend.Socket,
+    query: dns.message.Message,
+    serial: Optional[int],
+    timeout: Optional[float],
+    expiration: float,
+) -> Any:
+    """Given a socket, does the zone transfer."""
+    rdtype = query.question[0].rdtype
+    is_ixfr = rdtype == dns.rdatatype.IXFR
+    origin = txn_manager.from_wire_origin()
+    wire = query.to_wire()
+    is_udp = s.type == socket.SOCK_DGRAM
+    if is_udp:
+        udp_sock = cast(dns.asyncbackend.DatagramSocket, s)
+        await udp_sock.sendto(wire, None, _timeout(expiration))
+    else:
+        tcp_sock = cast(dns.asyncbackend.StreamSocket, s)
+        tcpmsg = struct.pack("!H", len(wire)) + wire
+        await tcp_sock.sendall(tcpmsg, expiration)
+    with dns.xfr.Inbound(txn_manager, rdtype, serial, is_udp) as inbound:
+        done = False
+        tsig_ctx = None
+        while not done:
+            (_, mexpiration) = _compute_times(timeout)
+            if mexpiration is None or (
+                expiration is not None and mexpiration > expiration
+            ):
+                mexpiration = expiration
+            if is_udp:
+                timeout = _timeout(mexpiration)
+                (rwire, _) = await udp_sock.recvfrom(65535, timeout)
+            else:
+                ldata = await _read_exactly(tcp_sock, 2, mexpiration)
+                (l,) = struct.unpack("!H", ldata)
+                rwire = await _read_exactly(tcp_sock, l, mexpiration)
+            r = dns.message.from_wire(
+                rwire,
+                keyring=query.keyring,
+                request_mac=query.mac,
+                xfr=True,
+                origin=origin,
+                tsig_ctx=tsig_ctx,
+                multi=(not is_udp),
+                one_rr_per_rrset=is_ixfr,
+            )
+            done = inbound.process_message(r)
+            yield r
+            tsig_ctx = r.tsig_ctx
+        if query.keyring and not r.had_tsig:
+            raise dns.exception.FormError("missing TSIG")
+
+
 async def inbound_xfr(
     where: str,
     txn_manager: dns.transaction.TransactionManager,
@@ -642,139 +884,30 @@ async def inbound_xfr(
         (query, serial) = dns.xfr.make_query(txn_manager)
     else:
         serial = dns.xfr.extract_serial_from_query(query)
-    rdtype = query.question[0].rdtype
-    is_ixfr = rdtype == dns.rdatatype.IXFR
-    origin = txn_manager.from_wire_origin()
-    wire = query.to_wire()
     af = dns.inet.af_for_address(where)
     stuple = _source_tuple(af, source, source_port)
     dtuple = (where, port)
+    if not backend:
+        backend = dns.asyncbackend.get_default_backend()
     (_, expiration) = _compute_times(lifetime)
-    retry = True
-    while retry:
-        retry = False
-        if is_ixfr and udp_mode != UDPMode.NEVER:
-            sock_type = socket.SOCK_DGRAM
-            is_udp = True
-        else:
-            sock_type = socket.SOCK_STREAM
-            is_udp = False
-        if not backend:
-            backend = dns.asyncbackend.get_default_backend()
+    if query.question[0].rdtype == dns.rdatatype.IXFR and udp_mode != UDPMode.NEVER:
         s = await backend.make_socket(
-            af, sock_type, 0, stuple, dtuple, _timeout(expiration)
+            af, socket.SOCK_DGRAM, 0, stuple, dtuple, _timeout(expiration)
         )
         async with s:
-            if is_udp:
-                await s.sendto(wire, dtuple, _timeout(expiration))
-            else:
-                tcpmsg = struct.pack("!H", len(wire)) + wire
-                await s.sendall(tcpmsg, expiration)
-            with dns.xfr.Inbound(txn_manager, rdtype, serial, is_udp) as inbound:
-                done = False
-                tsig_ctx = None
-                while not done:
-                    (_, mexpiration) = _compute_times(timeout)
-                    if mexpiration is None or (
-                        expiration is not None and mexpiration > expiration
-                    ):
-                        mexpiration = expiration
-                    if is_udp:
-                        destination = _lltuple((where, port), af)
-                        while True:
-                            timeout = _timeout(mexpiration)
-                            (rwire, from_address) = await s.recvfrom(65535, timeout)
-                            if _matches_destination(
-                                af, from_address, destination, True
-                            ):
-                                break
-                    else:
-                        ldata = await _read_exactly(s, 2, mexpiration)
-                        (l,) = struct.unpack("!H", ldata)
-                        rwire = await _read_exactly(s, l, mexpiration)
-                    is_ixfr = rdtype == dns.rdatatype.IXFR
-                    r = dns.message.from_wire(
-                        rwire,
-                        keyring=query.keyring,
-                        request_mac=query.mac,
-                        xfr=True,
-                        origin=origin,
-                        tsig_ctx=tsig_ctx,
-                        multi=(not is_udp),
-                        one_rr_per_rrset=is_ixfr,
-                    )
-                    try:
-                        done = inbound.process_message(r)
-                    except dns.xfr.UseTCP:
-                        assert is_udp  # should not happen if we used TCP!
-                        if udp_mode == UDPMode.ONLY:
-                            raise
-                        done = True
-                        retry = True
-                        udp_mode = UDPMode.NEVER
-                        continue
-                    tsig_ctx = r.tsig_ctx
-                if not retry and query.keyring and not r.had_tsig:
-                    raise dns.exception.FormError("missing TSIG")
+            try:
+                async for _ in _inbound_xfr(
+                    txn_manager, s, query, serial, timeout, expiration
+                ):
+                    pass
+                return
+            except dns.xfr.UseTCP:
+                if udp_mode == UDPMode.ONLY:
+                    raise
 
-
-async def quic(
-    q: dns.message.Message,
-    where: str,
-    timeout: Optional[float] = None,
-    port: int = 853,
-    source: Optional[str] = None,
-    source_port: int = 0,
-    one_rr_per_rrset: bool = False,
-    ignore_trailing: bool = False,
-    connection: Optional[dns.quic.AsyncQuicConnection] = None,
-    verify: Union[bool, str] = True,
-    backend: Optional[dns.asyncbackend.Backend] = None,
-    server_hostname: Optional[str] = None,
-) -> dns.message.Message:
-    """Return the response obtained after sending an asynchronous query via
-    DNS-over-QUIC.
-
-    *backend*, a ``dns.asyncbackend.Backend``, or ``None``.  If ``None``,
-    the default, then dnspython will use the default backend.
-
-    See :py:func:`dns.query.quic()` for the documentation of the other
-    parameters, exceptions, and return type of this method.
-    """
-
-    if not dns.quic.have_quic:
-        raise NoDOQ("DNS-over-QUIC is not available.")  # pragma: no cover
-
-    q.id = 0
-    wire = q.to_wire()
-    the_connection: dns.quic.AsyncQuicConnection
-    if connection:
-        cfactory = dns.quic.null_factory
-        mfactory = dns.quic.null_factory
-        the_connection = connection
-    else:
-        (cfactory, mfactory) = dns.quic.factories_for_backend(backend)
-
-    async with cfactory() as context:
-        async with mfactory(
-            context, verify_mode=verify, server_name=server_hostname
-        ) as the_manager:
-            if not connection:
-                the_connection = the_manager.connect(where, port, source, source_port)
-            (start, expiration) = _compute_times(timeout)
-            stream = await the_connection.make_stream(timeout)
-            async with stream:
-                await stream.send(wire, True)
-                wire = await stream.receive(_remaining(expiration))
-            finish = time.time()
-        r = dns.message.from_wire(
-            wire,
-            keyring=q.keyring,
-            request_mac=q.request_mac,
-            one_rr_per_rrset=one_rr_per_rrset,
-            ignore_trailing=ignore_trailing,
-        )
-    r.time = max(finish - start, 0.0)
-    if not q.is_response(r):
-        raise BadResponse
-    return r
+    s = await backend.make_socket(
+        af, socket.SOCK_STREAM, 0, stuple, dtuple, _timeout(expiration)
+    )
+    async with s:
+        async for _ in _inbound_xfr(txn_manager, s, query, serial, timeout, expiration):
+            pass
diff --git a/lib/dns/dnssec.py b/lib/dns/dnssec.py
index e49c3b79..b69d0a12 100644
--- a/lib/dns/dnssec.py
+++ b/lib/dns/dnssec.py
@@ -118,6 +118,7 @@ def key_id(key: Union[DNSKEY, CDNSKEY]) -> int:
     """
 
     rdata = key.to_wire()
+    assert rdata is not None  # for mypy
     if key.algorithm == Algorithm.RSAMD5:
         return (rdata[-3] << 8) + rdata[-2]
     else:
@@ -224,7 +225,7 @@ def make_ds(
         if isinstance(algorithm, str):
             algorithm = DSDigest[algorithm.upper()]
     except Exception:
-        raise UnsupportedAlgorithm('unsupported algorithm "%s"' % algorithm)
+        raise UnsupportedAlgorithm(f'unsupported algorithm "{algorithm}"')
     if validating:
         check = policy.ok_to_validate_ds
     else:
@@ -240,14 +241,15 @@ def make_ds(
     elif algorithm == DSDigest.SHA384:
         dshash = hashlib.sha384()
     else:
-        raise UnsupportedAlgorithm('unsupported algorithm "%s"' % algorithm)
+        raise UnsupportedAlgorithm(f'unsupported algorithm "{algorithm}"')
 
     if isinstance(name, str):
         name = dns.name.from_text(name, origin)
     wire = name.canonicalize().to_wire()
-    assert wire is not None
+    kwire = key.to_wire(origin=origin)
+    assert wire is not None and kwire is not None  # for mypy
     dshash.update(wire)
-    dshash.update(key.to_wire(origin=origin))
+    dshash.update(kwire)
     digest = dshash.digest()
 
     dsrdata = struct.pack("!HBB", key_id(key), key.algorithm, algorithm) + digest
@@ -323,6 +325,7 @@ def _get_rrname_rdataset(
 
 
 def _validate_signature(sig: bytes, data: bytes, key: DNSKEY) -> None:
+    # pylint: disable=possibly-used-before-assignment
     public_cls = get_algorithm_cls_from_dnskey(key).public_cls
     try:
         public_key = public_cls.from_dnskey(key)
@@ -387,6 +390,7 @@ def _validate_rrsig(
 
     data = _make_rrsig_signature_data(rrset, rrsig, origin)
 
+    # pylint: disable=possibly-used-before-assignment
     for candidate_key in candidate_keys:
         if not policy.ok_to_validate(candidate_key):
             continue
@@ -484,6 +488,7 @@ def _sign(
     verify: bool = False,
     policy: Optional[Policy] = None,
     origin: Optional[dns.name.Name] = None,
+    deterministic: bool = True,
 ) -> RRSIG:
     """Sign RRset using private key.
 
@@ -523,6 +528,10 @@ def _sign(
     names in the rrset (including its owner name) must be absolute; otherwise the
     specified origin will be used to make names absolute when signing.
 
+    *deterministic*, a ``bool``. If ``True``, the default, use deterministic
+    (reproducible) signatures when supported by the algorithm used for signing.
+    Currently, this only affects ECDSA.
+
     Raises ``DeniedByPolicy`` if the signature is denied by policy.
     """
 
@@ -580,6 +589,7 @@ def _sign(
 
     data = dns.dnssec._make_rrsig_signature_data(rrset, rrsig_template, origin)
 
+    # pylint: disable=possibly-used-before-assignment
     if isinstance(private_key, GenericPrivateKey):
         signing_key = private_key
     else:
@@ -589,7 +599,7 @@ def _sign(
         except UnsupportedAlgorithm:
             raise TypeError("Unsupported key algorithm")
 
-    signature = signing_key.sign(data, verify)
+    signature = signing_key.sign(data, verify, deterministic)
 
     return cast(RRSIG, rrsig_template.replace(signature=signature))
 
@@ -629,7 +639,9 @@ def _make_rrsig_signature_data(
     rrname, rdataset = _get_rrname_rdataset(rrset)
 
     data = b""
-    data += rrsig.to_wire(origin=signer)[:18]
+    wire = rrsig.to_wire(origin=signer)
+    assert wire is not None  # for mypy
+    data += wire[:18]
     data += rrsig.signer.to_digestable(signer)
 
     # Derelativize the name before considering labels.
@@ -686,6 +698,7 @@ def _make_dnskey(
 
     algorithm = Algorithm.make(algorithm)
 
+    # pylint: disable=possibly-used-before-assignment
     if isinstance(public_key, GenericPublicKey):
         return public_key.to_dnskey(flags=flags, protocol=protocol)
     else:
@@ -832,7 +845,7 @@ def make_ds_rdataset(
             if isinstance(algorithm, str):
                 algorithm = DSDigest[algorithm.upper()]
         except Exception:
-            raise UnsupportedAlgorithm('unsupported algorithm "%s"' % algorithm)
+            raise UnsupportedAlgorithm(f'unsupported algorithm "{algorithm}"')
         _algorithms.add(algorithm)
 
     if rdataset.rdtype == dns.rdatatype.CDS:
@@ -950,6 +963,7 @@ def default_rrset_signer(
     lifetime: Optional[int] = None,
     policy: Optional[Policy] = None,
     origin: Optional[dns.name.Name] = None,
+    deterministic: bool = True,
 ) -> None:
     """Default RRset signer"""
 
@@ -975,6 +989,7 @@ def default_rrset_signer(
             signer=signer,
             policy=policy,
             origin=origin,
+            deterministic=deterministic,
         )
         txn.add(rrset.name, rrset.ttl, rrsig)
 
@@ -991,6 +1006,7 @@ def sign_zone(
     nsec3: Optional[NSEC3PARAM] = None,
     rrset_signer: Optional[RRsetSigner] = None,
     policy: Optional[Policy] = None,
+    deterministic: bool = True,
 ) -> None:
     """Sign zone.
 
@@ -1030,6 +1046,10 @@ def sign_zone(
     function requires two arguments: transaction and RRset. If the not specified,
     ``dns.dnssec.default_rrset_signer`` will be used.
 
+    *deterministic*, a ``bool``. If ``True``, the default, use deterministic
+    (reproducible) signatures when supported by the algorithm used for signing.
+    Currently, this only affects ECDSA.
+
     Returns ``None``.
     """
 
@@ -1056,6 +1076,9 @@ def sign_zone(
     else:
         cm = zone.writer()
 
+    if zone.origin is None:
+        raise ValueError("no zone origin")
+
     with cm as _txn:
         if add_dnskey:
             if dnskey_ttl is None:
@@ -1081,6 +1104,7 @@ def sign_zone(
                 lifetime=lifetime,
                 policy=policy,
                 origin=zone.origin,
+                deterministic=deterministic,
             )
             return _sign_zone_nsec(zone, _txn, _rrset_signer)
 
diff --git a/lib/dns/dnssecalgs/__init__.py b/lib/dns/dnssecalgs/__init__.py
index 3d9181a7..602367e3 100644
--- a/lib/dns/dnssecalgs/__init__.py
+++ b/lib/dns/dnssecalgs/__init__.py
@@ -26,6 +26,7 @@ AlgorithmPrefix = Optional[Union[bytes, dns.name.Name]]
 
 algorithms: Dict[Tuple[Algorithm, AlgorithmPrefix], Type[GenericPrivateKey]] = {}
 if _have_cryptography:
+    # pylint: disable=possibly-used-before-assignment
     algorithms.update(
         {
             (Algorithm.RSAMD5, None): PrivateRSAMD5,
@@ -59,7 +60,7 @@ def get_algorithm_cls(
     if cls:
         return cls
     raise UnsupportedAlgorithm(
-        'algorithm "%s" not supported by dnspython' % Algorithm.to_text(algorithm)
+        f'algorithm "{Algorithm.to_text(algorithm)}" not supported by dnspython'
     )
 
 
diff --git a/lib/dns/dnssecalgs/base.py b/lib/dns/dnssecalgs/base.py
index e990575a..752ee480 100644
--- a/lib/dns/dnssecalgs/base.py
+++ b/lib/dns/dnssecalgs/base.py
@@ -65,7 +65,12 @@ class GenericPrivateKey(ABC):
         pass
 
     @abstractmethod
-    def sign(self, data: bytes, verify: bool = False) -> bytes:
+    def sign(
+        self,
+        data: bytes,
+        verify: bool = False,
+        deterministic: bool = True,
+    ) -> bytes:
         """Sign DNSSEC data"""
 
     @abstractmethod
diff --git a/lib/dns/dnssecalgs/dsa.py b/lib/dns/dnssecalgs/dsa.py
index 0fe4690d..adca3def 100644
--- a/lib/dns/dnssecalgs/dsa.py
+++ b/lib/dns/dnssecalgs/dsa.py
@@ -68,7 +68,12 @@ class PrivateDSA(CryptographyPrivateKey):
     key_cls = dsa.DSAPrivateKey
     public_cls = PublicDSA
 
-    def sign(self, data: bytes, verify: bool = False) -> bytes:
+    def sign(
+        self,
+        data: bytes,
+        verify: bool = False,
+        deterministic: bool = True,
+    ) -> bytes:
         """Sign using a private key per RFC 2536, section 3."""
         public_dsa_key = self.key.public_key()
         if public_dsa_key.key_size > 1024:
diff --git a/lib/dns/dnssecalgs/ecdsa.py b/lib/dns/dnssecalgs/ecdsa.py
index a31d79f2..86d5764c 100644
--- a/lib/dns/dnssecalgs/ecdsa.py
+++ b/lib/dns/dnssecalgs/ecdsa.py
@@ -47,9 +47,17 @@ class PrivateECDSA(CryptographyPrivateKey):
     key_cls = ec.EllipticCurvePrivateKey
     public_cls = PublicECDSA
 
-    def sign(self, data: bytes, verify: bool = False) -> bytes:
+    def sign(
+        self,
+        data: bytes,
+        verify: bool = False,
+        deterministic: bool = True,
+    ) -> bytes:
         """Sign using a private key per RFC 6605, section 4."""
-        der_signature = self.key.sign(data, ec.ECDSA(self.public_cls.chosen_hash))
+        algorithm = ec.ECDSA(
+            self.public_cls.chosen_hash, deterministic_signing=deterministic
+        )
+        der_signature = self.key.sign(data, algorithm)
         dsa_r, dsa_s = utils.decode_dss_signature(der_signature)
         signature = int.to_bytes(
             dsa_r, length=self.public_cls.octets, byteorder="big"
diff --git a/lib/dns/dnssecalgs/eddsa.py b/lib/dns/dnssecalgs/eddsa.py
index 70505342..604bcbfe 100644
--- a/lib/dns/dnssecalgs/eddsa.py
+++ b/lib/dns/dnssecalgs/eddsa.py
@@ -29,7 +29,12 @@ class PublicEDDSA(CryptographyPublicKey):
 class PrivateEDDSA(CryptographyPrivateKey):
     public_cls: Type[PublicEDDSA]
 
-    def sign(self, data: bytes, verify: bool = False) -> bytes:
+    def sign(
+        self,
+        data: bytes,
+        verify: bool = False,
+        deterministic: bool = True,
+    ) -> bytes:
         """Sign using a private key per RFC 8080, section 4."""
         signature = self.key.sign(data)
         if verify:
diff --git a/lib/dns/dnssecalgs/rsa.py b/lib/dns/dnssecalgs/rsa.py
index e95dcf1d..27537aad 100644
--- a/lib/dns/dnssecalgs/rsa.py
+++ b/lib/dns/dnssecalgs/rsa.py
@@ -56,7 +56,12 @@ class PrivateRSA(CryptographyPrivateKey):
     public_cls = PublicRSA
     default_public_exponent = 65537
 
-    def sign(self, data: bytes, verify: bool = False) -> bytes:
+    def sign(
+        self,
+        data: bytes,
+        verify: bool = False,
+        deterministic: bool = True,
+    ) -> bytes:
         """Sign using a private key per RFC 3110, section 3."""
         signature = self.key.sign(data, padding.PKCS1v15(), self.public_cls.chosen_hash)
         if verify:
diff --git a/lib/dns/edns.py b/lib/dns/edns.py
index 776e5eeb..f7d9ff99 100644
--- a/lib/dns/edns.py
+++ b/lib/dns/edns.py
@@ -52,6 +52,8 @@ class OptionType(dns.enum.IntEnum):
     CHAIN = 13
     #: EDE (extended-dns-error)
     EDE = 15
+    #: REPORTCHANNEL
+    REPORTCHANNEL = 18
 
     @classmethod
     def _maximum(cls):
@@ -222,7 +224,7 @@ class ECSOption(Option):  # lgtm[py/missing-equals]
             self.addrdata = self.addrdata[:-1] + last
 
     def to_text(self) -> str:
-        return "ECS {}/{} scope/{}".format(self.address, self.srclen, self.scopelen)
+        return f"ECS {self.address}/{self.srclen} scope/{self.scopelen}"
 
     @staticmethod
     def from_text(text: str) -> Option:
@@ -255,10 +257,10 @@ class ECSOption(Option):  # lgtm[py/missing-equals]
             ecs_text = tokens[0]
         elif len(tokens) == 2:
             if tokens[0] != optional_prefix:
-                raise ValueError('could not parse ECS from "{}"'.format(text))
+                raise ValueError(f'could not parse ECS from "{text}"')
             ecs_text = tokens[1]
         else:
-            raise ValueError('could not parse ECS from "{}"'.format(text))
+            raise ValueError(f'could not parse ECS from "{text}"')
         n_slashes = ecs_text.count("/")
         if n_slashes == 1:
             address, tsrclen = ecs_text.split("/")
@@ -266,18 +268,16 @@ class ECSOption(Option):  # lgtm[py/missing-equals]
         elif n_slashes == 2:
             address, tsrclen, tscope = ecs_text.split("/")
         else:
-            raise ValueError('could not parse ECS from "{}"'.format(text))
+            raise ValueError(f'could not parse ECS from "{text}"')
         try:
             scope = int(tscope)
         except ValueError:
-            raise ValueError(
-                "invalid scope " + '"{}": scope must be an integer'.format(tscope)
-            )
+            raise ValueError("invalid scope " + f'"{tscope}": scope must be an integer')
         try:
             srclen = int(tsrclen)
         except ValueError:
             raise ValueError(
-                "invalid srclen " + '"{}": srclen must be an integer'.format(tsrclen)
+                "invalid srclen " + f'"{tsrclen}": srclen must be an integer'
             )
         return ECSOption(address, srclen, scope)
 
@@ -430,10 +430,65 @@ class NSIDOption(Option):
         return cls(parser.get_remaining())
 
 
+class CookieOption(Option):
+    def __init__(self, client: bytes, server: bytes):
+        super().__init__(dns.edns.OptionType.COOKIE)
+        self.client = client
+        self.server = server
+        if len(client) != 8:
+            raise ValueError("client cookie must be 8 bytes")
+        if len(server) != 0 and (len(server) < 8 or len(server) > 32):
+            raise ValueError("server cookie must be empty or between 8 and 32 bytes")
+
+    def to_wire(self, file: Any = None) -> Optional[bytes]:
+        if file:
+            file.write(self.client)
+            if len(self.server) > 0:
+                file.write(self.server)
+            return None
+        else:
+            return self.client + self.server
+
+    def to_text(self) -> str:
+        client = binascii.hexlify(self.client).decode()
+        if len(self.server) > 0:
+            server = binascii.hexlify(self.server).decode()
+        else:
+            server = ""
+        return f"COOKIE {client}{server}"
+
+    @classmethod
+    def from_wire_parser(
+        cls, otype: Union[OptionType, str], parser: dns.wire.Parser
+    ) -> Option:
+        return cls(parser.get_bytes(8), parser.get_remaining())
+
+
+class ReportChannelOption(Option):
+    # RFC 9567
+    def __init__(self, agent_domain: dns.name.Name):
+        super().__init__(OptionType.REPORTCHANNEL)
+        self.agent_domain = agent_domain
+
+    def to_wire(self, file: Any = None) -> Optional[bytes]:
+        return self.agent_domain.to_wire(file)
+
+    def to_text(self) -> str:
+        return "REPORTCHANNEL " + self.agent_domain.to_text()
+
+    @classmethod
+    def from_wire_parser(
+        cls, otype: Union[OptionType, str], parser: dns.wire.Parser
+    ) -> Option:
+        return cls(parser.get_name())
+
+
 _type_to_class: Dict[OptionType, Any] = {
     OptionType.ECS: ECSOption,
     OptionType.EDE: EDEOption,
     OptionType.NSID: NSIDOption,
+    OptionType.COOKIE: CookieOption,
+    OptionType.REPORTCHANNEL: ReportChannelOption,
 }
 
 
@@ -512,5 +567,6 @@ KEEPALIVE = OptionType.KEEPALIVE
 PADDING = OptionType.PADDING
 CHAIN = OptionType.CHAIN
 EDE = OptionType.EDE
+REPORTCHANNEL = OptionType.REPORTCHANNEL
 
 ### END generated OptionType constants
diff --git a/lib/dns/exception.py b/lib/dns/exception.py
index 6982373d..223f2d68 100644
--- a/lib/dns/exception.py
+++ b/lib/dns/exception.py
@@ -81,7 +81,7 @@ class DNSException(Exception):
         if kwargs:
             assert (
                 set(kwargs.keys()) == self.supp_kwargs
-            ), "following set of keyword args is required: %s" % (self.supp_kwargs)
+            ), f"following set of keyword args is required: {self.supp_kwargs}"
         return kwargs
 
     def _fmt_kwargs(self, **kwargs):
diff --git a/lib/dns/grange.py b/lib/dns/grange.py
index 3a52278f..a967ca41 100644
--- a/lib/dns/grange.py
+++ b/lib/dns/grange.py
@@ -54,7 +54,7 @@ def from_text(text: str) -> Tuple[int, int, int]:
         elif c.isdigit():
             cur += c
         else:
-            raise dns.exception.SyntaxError("Could not parse %s" % (c))
+            raise dns.exception.SyntaxError(f"Could not parse {c}")
 
     if state == 0:
         raise dns.exception.SyntaxError("no stop value specified")
diff --git a/lib/dns/ipv6.py b/lib/dns/ipv6.py
index 44a10639..4dd1d1ca 100644
--- a/lib/dns/ipv6.py
+++ b/lib/dns/ipv6.py
@@ -143,9 +143,7 @@ def inet_aton(text: Union[str, bytes], ignore_scope: bool = False) -> bytes:
     if m is not None:
         b = dns.ipv4.inet_aton(m.group(2))
         btext = (
-            "{}:{:02x}{:02x}:{:02x}{:02x}".format(
-                m.group(1).decode(), b[0], b[1], b[2], b[3]
-            )
+            f"{m.group(1).decode()}:{b[0]:02x}{b[1]:02x}:{b[2]:02x}{b[3]:02x}"
         ).encode()
     #
     # Try to turn '::<whatever>' into ':<whatever>'; if no match try to
diff --git a/lib/dns/message.py b/lib/dns/message.py
index 44cacbd9..e978a0a2 100644
--- a/lib/dns/message.py
+++ b/lib/dns/message.py
@@ -18,9 +18,10 @@
 """DNS Messages"""
 
 import contextlib
+import enum
 import io
 import time
-from typing import Any, Dict, List, Optional, Tuple, Union
+from typing import Any, Dict, List, Optional, Tuple, Union, cast
 
 import dns.edns
 import dns.entropy
@@ -161,6 +162,7 @@ class Message:
         self.index: IndexType = {}
         self.errors: List[MessageError] = []
         self.time = 0.0
+        self.wire: Optional[bytes] = None
 
     @property
     def question(self) -> List[dns.rrset.RRset]:
@@ -220,16 +222,16 @@ class Message:
 
         s = io.StringIO()
         s.write("id %d\n" % self.id)
-        s.write("opcode %s\n" % dns.opcode.to_text(self.opcode()))
-        s.write("rcode %s\n" % dns.rcode.to_text(self.rcode()))
-        s.write("flags %s\n" % dns.flags.to_text(self.flags))
+        s.write(f"opcode {dns.opcode.to_text(self.opcode())}\n")
+        s.write(f"rcode {dns.rcode.to_text(self.rcode())}\n")
+        s.write(f"flags {dns.flags.to_text(self.flags)}\n")
         if self.edns >= 0:
-            s.write("edns %s\n" % self.edns)
+            s.write(f"edns {self.edns}\n")
             if self.ednsflags != 0:
-                s.write("eflags %s\n" % dns.flags.edns_to_text(self.ednsflags))
+                s.write(f"eflags {dns.flags.edns_to_text(self.ednsflags)}\n")
             s.write("payload %d\n" % self.payload)
         for opt in self.options:
-            s.write("option %s\n" % opt.to_text())
+            s.write(f"option {opt.to_text()}\n")
         for name, which in self._section_enum.__members__.items():
             s.write(f";{name}\n")
             for rrset in self.section_from_number(which):
@@ -645,6 +647,7 @@ class Message:
             if multi:
                 self.tsig_ctx = ctx
         wire = r.get_wire()
+        self.wire = wire
         if prepend_length:
             wire = len(wire).to_bytes(2, "big") + wire
         return wire
@@ -912,6 +915,14 @@ class Message:
         self.flags &= 0x87FF
         self.flags |= dns.opcode.to_flags(opcode)
 
+    def get_options(self, otype: dns.edns.OptionType) -> List[dns.edns.Option]:
+        """Return the list of options of the specified type."""
+        return [option for option in self.options if option.otype == otype]
+
+    def extended_errors(self) -> List[dns.edns.EDEOption]:
+        """Return the list of Extended DNS Error (EDE) options in the message"""
+        return cast(List[dns.edns.EDEOption], self.get_options(dns.edns.OptionType.EDE))
+
     def _get_one_rr_per_rrset(self, value):
         # What the caller picked is fine.
         return value
@@ -1192,9 +1203,9 @@ class _WireReader:
                 if rdtype == dns.rdatatype.OPT:
                     self.message.opt = dns.rrset.from_rdata(name, ttl, rd)
                 elif rdtype == dns.rdatatype.TSIG:
-                    if self.keyring is None:
+                    if self.keyring is None or self.keyring is True:
                         raise UnknownTSIGKey("got signed message without keyring")
-                    if isinstance(self.keyring, dict):
+                    elif isinstance(self.keyring, dict):
                         key = self.keyring.get(absolute_name)
                         if isinstance(key, bytes):
                             key = dns.tsig.Key(absolute_name, key, rd.algorithm)
@@ -1203,19 +1214,20 @@ class _WireReader:
                     else:
                         key = self.keyring
                     if key is None:
-                        raise UnknownTSIGKey("key '%s' unknown" % name)
-                    self.message.keyring = key
-                    self.message.tsig_ctx = dns.tsig.validate(
-                        self.parser.wire,
-                        key,
-                        absolute_name,
-                        rd,
-                        int(time.time()),
-                        self.message.request_mac,
-                        rr_start,
-                        self.message.tsig_ctx,
-                        self.multi,
-                    )
+                        raise UnknownTSIGKey(f"key '{name}' unknown")
+                    if key:
+                        self.message.keyring = key
+                        self.message.tsig_ctx = dns.tsig.validate(
+                            self.parser.wire,
+                            key,
+                            absolute_name,
+                            rd,
+                            int(time.time()),
+                            self.message.request_mac,
+                            rr_start,
+                            self.message.tsig_ctx,
+                            self.multi,
+                        )
                     self.message.tsig = dns.rrset.from_rdata(absolute_name, 0, rd)
                 else:
                     rrset = self.message.find_rrset(
@@ -1251,6 +1263,7 @@ class _WireReader:
         factory = _message_factory_from_opcode(dns.opcode.from_flags(flags))
         self.message = factory(id=id)
         self.message.flags = dns.flags.Flag(flags)
+        self.message.wire = self.parser.wire
         self.initialize_message(self.message)
         self.one_rr_per_rrset = self.message._get_one_rr_per_rrset(
             self.one_rr_per_rrset
@@ -1290,8 +1303,10 @@ def from_wire(
 ) -> Message:
     """Convert a DNS wire format message into a message object.
 
-    *keyring*, a ``dns.tsig.Key`` or ``dict``, the key or keyring to use if the message
-    is signed.
+    *keyring*, a ``dns.tsig.Key``, ``dict``, ``bool``, or ``None``, the key or keyring
+    to use if the message is signed.  If ``None`` or ``True``, then trying to decode
+    a message with a TSIG will fail as it cannot be validated.  If ``False``, then
+    TSIG validation is disabled.
 
     *request_mac*, a ``bytes`` or ``None``.  If the message is a response to a
     TSIG-signed request, *request_mac* should be set to the MAC of that request.
@@ -1811,6 +1826,16 @@ def make_query(
     return m
 
 
+class CopyMode(enum.Enum):
+    """
+    How should sections be copied when making an update response?
+    """
+
+    NOTHING = 0
+    QUESTION = 1
+    EVERYTHING = 2
+
+
 def make_response(
     query: Message,
     recursion_available: bool = False,
@@ -1818,13 +1843,14 @@ def make_response(
     fudge: int = 300,
     tsig_error: int = 0,
     pad: Optional[int] = None,
+    copy_mode: Optional[CopyMode] = None,
 ) -> Message:
     """Make a message which is a response for the specified query.
     The message returned is really a response skeleton; it has all of the infrastructure
     required of a response, but none of the content.
 
-    The response's question section is a shallow copy of the query's question section,
-    so the query's question RRsets should not be changed.
+    Response section(s) which are copied are shallow copies of the matching section(s)
+    in the query, so the query's RRsets should not be changed.
 
     *query*, a ``dns.message.Message``, the query to respond to.
 
@@ -1837,25 +1863,44 @@ def make_response(
     *tsig_error*, an ``int``, the TSIG error.
 
     *pad*, a non-negative ``int`` or ``None``.  If 0, the default, do not pad; otherwise
-    if not ``None`` add padding bytes to make the message size a multiple of *pad*.
-    Note that if padding is non-zero, an EDNS PADDING option will always be added to the
+    if not ``None`` add padding bytes to make the message size a multiple of *pad*. Note
+    that if padding is non-zero, an EDNS PADDING option will always be added to the
     message.  If ``None``, add padding following RFC 8467, namely if the request is
     padded, pad the response to 468 otherwise do not pad.
 
+    *copy_mode*, a ``dns.message.CopyMode`` or ``None``, determines how sections are
+    copied.  The default, ``None`` copies sections according to the default for the
+    message's opcode, which is currently ``dns.message.CopyMode.QUESTION`` for all
+    opcodes.   ``dns.message.CopyMode.QUESTION`` copies only the question section.
+    ``dns.message.CopyMode.EVERYTHING`` copies all sections other than OPT or TSIG
+    records, which are created appropriately if needed. ``dns.message.CopyMode.NOTHING``
+    copies no sections; note that this mode is for server testing purposes and is
+    otherwise not recommended for use.  In particular, ``dns.message.is_response()``
+    will be ``False`` if you create a response this way and the rcode is not
+    ``FORMERR``, ``SERVFAIL``, ``NOTIMP``, or ``REFUSED``.
+
     Returns a ``dns.message.Message`` object whose specific class is appropriate for the
-    query.  For example, if query is a ``dns.update.UpdateMessage``, response will be
-    too.
+    query.  For example, if query is a ``dns.update.UpdateMessage``, the response will
+    be one too.
     """
 
     if query.flags & dns.flags.QR:
         raise dns.exception.FormError("specified query message is not a query")
-    factory = _message_factory_from_opcode(query.opcode())
+    opcode = query.opcode()
+    factory = _message_factory_from_opcode(opcode)
     response = factory(id=query.id)
     response.flags = dns.flags.QR | (query.flags & dns.flags.RD)
     if recursion_available:
         response.flags |= dns.flags.RA
-    response.set_opcode(query.opcode())
-    response.question = list(query.question)
+    response.set_opcode(opcode)
+    if copy_mode is None:
+        copy_mode = CopyMode.QUESTION
+    if copy_mode != CopyMode.NOTHING:
+        response.question = list(query.question)
+    if copy_mode == CopyMode.EVERYTHING:
+        response.answer = list(query.answer)
+        response.authority = list(query.authority)
+        response.additional = list(query.additional)
     if query.edns >= 0:
         if pad is None:
             # Set response padding per RFC 8467
diff --git a/lib/dns/name.py b/lib/dns/name.py
index 22ccb392..f79f0d0f 100644
--- a/lib/dns/name.py
+++ b/lib/dns/name.py
@@ -59,11 +59,11 @@ class NameRelation(dns.enum.IntEnum):
 
     @classmethod
     def _maximum(cls):
-        return cls.COMMONANCESTOR
+        return cls.COMMONANCESTOR  # pragma: no cover
 
     @classmethod
     def _short_name(cls):
-        return cls.__name__
+        return cls.__name__  # pragma: no cover
 
 
 # Backwards compatibility
@@ -277,6 +277,7 @@ class IDNA2008Codec(IDNACodec):
             raise NoIDNA2008
         try:
             if self.uts_46:
+                # pylint: disable=possibly-used-before-assignment
                 label = idna.uts46_remap(label, False, self.transitional)
             return idna.alabel(label)
         except idna.IDNAError as e:
diff --git a/lib/dns/nameserver.py b/lib/dns/nameserver.py
index 5dbb4e8b..b02a239b 100644
--- a/lib/dns/nameserver.py
+++ b/lib/dns/nameserver.py
@@ -168,12 +168,14 @@ class DoHNameserver(Nameserver):
         bootstrap_address: Optional[str] = None,
         verify: Union[bool, str] = True,
         want_get: bool = False,
+        http_version: dns.query.HTTPVersion = dns.query.HTTPVersion.DEFAULT,
     ):
         super().__init__()
         self.url = url
         self.bootstrap_address = bootstrap_address
         self.verify = verify
         self.want_get = want_get
+        self.http_version = http_version
 
     def kind(self):
         return "DoH"
@@ -214,6 +216,7 @@ class DoHNameserver(Nameserver):
             ignore_trailing=ignore_trailing,
             verify=self.verify,
             post=(not self.want_get),
+            http_version=self.http_version,
         )
 
     async def async_query(
@@ -238,6 +241,7 @@ class DoHNameserver(Nameserver):
             ignore_trailing=ignore_trailing,
             verify=self.verify,
             post=(not self.want_get),
+            http_version=self.http_version,
         )
 
 
diff --git a/lib/dns/query.py b/lib/dns/query.py
index f0ee9161..0d8a977a 100644
--- a/lib/dns/query.py
+++ b/lib/dns/query.py
@@ -23,11 +23,13 @@ import enum
 import errno
 import os
 import os.path
+import random
 import selectors
 import socket
 import struct
 import time
-from typing import Any, Dict, Optional, Tuple, Union
+import urllib.parse
+from typing import Any, Dict, Optional, Tuple, Union, cast
 
 import dns._features
 import dns.exception
@@ -129,7 +131,7 @@ if _have_httpx:
             family=socket.AF_UNSPEC,
             **kwargs,
         ):
-            if resolver is None:
+            if resolver is None and bootstrap_address is None:
                 # pylint: disable=import-outside-toplevel,redefined-outer-name
                 import dns.resolver
 
@@ -217,7 +219,7 @@ def _wait_for(fd, readable, writable, _, expiration):
 
     if readable and isinstance(fd, ssl.SSLSocket) and fd.pending() > 0:
         return True
-    sel = _selector_class()
+    sel = selectors.DefaultSelector()
     events = 0
     if readable:
         events |= selectors.EVENT_READ
@@ -235,26 +237,6 @@ def _wait_for(fd, readable, writable, _, expiration):
         raise dns.exception.Timeout
 
 
-def _set_selector_class(selector_class):
-    # Internal API. Do not use.
-
-    global _selector_class
-
-    _selector_class = selector_class
-
-
-if hasattr(selectors, "PollSelector"):
-    # Prefer poll() on platforms that support it because it has no
-    # limits on the maximum value of a file descriptor (plus it will
-    # be more efficient for high values).
-    #
-    # We ignore typing here as we can't say _selector_class is Any
-    # on python < 3.8 due to a bug.
-    _selector_class = selectors.PollSelector  # type: ignore
-else:
-    _selector_class = selectors.SelectSelector  # type: ignore
-
-
 def _wait_for_readable(s, expiration):
     _wait_for(s, True, False, True, expiration)
 
@@ -355,6 +337,36 @@ def _make_socket(af, type, source, ssl_context=None, server_hostname=None):
         raise
 
 
+def _maybe_get_resolver(
+    resolver: Optional["dns.resolver.Resolver"],
+) -> "dns.resolver.Resolver":
+    # We need a separate method for this to avoid overriding the global
+    # variable "dns" with the as-yet undefined local variable "dns"
+    # in https().
+    if resolver is None:
+        # pylint: disable=import-outside-toplevel,redefined-outer-name
+        import dns.resolver
+
+        resolver = dns.resolver.Resolver()
+    return resolver
+
+
+class HTTPVersion(enum.IntEnum):
+    """Which version of HTTP should be used?
+
+    DEFAULT will select the first version from the list [2, 1.1, 3] that
+    is available.
+    """
+
+    DEFAULT = 0
+    HTTP_1 = 1
+    H1 = 1
+    HTTP_2 = 2
+    H2 = 2
+    HTTP_3 = 3
+    H3 = 3
+
+
 def https(
     q: dns.message.Message,
     where: str,
@@ -370,7 +382,8 @@ def https(
     bootstrap_address: Optional[str] = None,
     verify: Union[bool, str] = True,
     resolver: Optional["dns.resolver.Resolver"] = None,
-    family: Optional[int] = socket.AF_UNSPEC,
+    family: int = socket.AF_UNSPEC,
+    http_version: HTTPVersion = HTTPVersion.DEFAULT,
 ) -> dns.message.Message:
     """Return the response obtained after sending a query via DNS-over-HTTPS.
 
@@ -420,27 +433,66 @@ def https(
     *family*, an ``int``, the address family.  If socket.AF_UNSPEC (the default), both A
     and AAAA records will be retrieved.
 
+    *http_version*, a ``dns.query.HTTPVersion``, indicating which HTTP version to use.
+
     Returns a ``dns.message.Message``.
     """
 
+    (af, _, the_source) = _destination_and_source(
+        where, port, source, source_port, False
+    )
+    if af is not None and dns.inet.is_address(where):
+        if af == socket.AF_INET:
+            url = f"https://{where}:{port}{path}"
+        elif af == socket.AF_INET6:
+            url = f"https://[{where}]:{port}{path}"
+    else:
+        url = where
+
+    extensions = {}
+    if bootstrap_address is None:
+        # pylint: disable=possibly-used-before-assignment
+        parsed = urllib.parse.urlparse(url)
+        if parsed.hostname is None:
+            raise ValueError("no hostname in URL")
+        if dns.inet.is_address(parsed.hostname):
+            bootstrap_address = parsed.hostname
+            extensions["sni_hostname"] = parsed.hostname
+        if parsed.port is not None:
+            port = parsed.port
+
+    if http_version == HTTPVersion.H3 or (
+        http_version == HTTPVersion.DEFAULT and not have_doh
+    ):
+        if bootstrap_address is None:
+            resolver = _maybe_get_resolver(resolver)
+            assert parsed.hostname is not None  # for mypy
+            answers = resolver.resolve_name(parsed.hostname, family)
+            bootstrap_address = random.choice(list(answers.addresses()))
+        return _http3(
+            q,
+            bootstrap_address,
+            url,
+            timeout,
+            port,
+            source,
+            source_port,
+            one_rr_per_rrset,
+            ignore_trailing,
+            verify=verify,
+            post=post,
+        )
+
     if not have_doh:
         raise NoDOH  # pragma: no cover
     if session and not isinstance(session, httpx.Client):
         raise ValueError("session parameter must be an httpx.Client")
 
     wire = q.to_wire()
-    (af, _, the_source) = _destination_and_source(
-        where, port, source, source_port, False
-    )
-    transport = None
     headers = {"accept": "application/dns-message"}
-    if af is not None and dns.inet.is_address(where):
-        if af == socket.AF_INET:
-            url = "https://{}:{}{}".format(where, port, path)
-        elif af == socket.AF_INET6:
-            url = "https://[{}]:{}{}".format(where, port, path)
-    else:
-        url = where
+
+    h1 = http_version in (HTTPVersion.H1, HTTPVersion.DEFAULT)
+    h2 = http_version in (HTTPVersion.H2, HTTPVersion.DEFAULT)
 
     # set source port and source address
 
@@ -450,21 +502,22 @@ def https(
     else:
         local_address = the_source[0]
         local_port = the_source[1]
-    transport = _HTTPTransport(
-        local_address=local_address,
-        http1=True,
-        http2=True,
-        verify=verify,
-        local_port=local_port,
-        bootstrap_address=bootstrap_address,
-        resolver=resolver,
-        family=family,
-    )
 
     if session:
         cm: contextlib.AbstractContextManager = contextlib.nullcontext(session)
     else:
-        cm = httpx.Client(http1=True, http2=True, verify=verify, transport=transport)
+        transport = _HTTPTransport(
+            local_address=local_address,
+            http1=h1,
+            http2=h2,
+            verify=verify,
+            local_port=local_port,
+            bootstrap_address=bootstrap_address,
+            resolver=resolver,
+            family=family,
+        )
+
+        cm = httpx.Client(http1=h1, http2=h2, verify=verify, transport=transport)
     with cm as session:
         # see https://tools.ietf.org/html/rfc8484#section-4.1.1 for DoH
         # GET and POST examples
@@ -475,20 +528,30 @@ def https(
                     "content-length": str(len(wire)),
                 }
             )
-            response = session.post(url, headers=headers, content=wire, timeout=timeout)
+            response = session.post(
+                url,
+                headers=headers,
+                content=wire,
+                timeout=timeout,
+                extensions=extensions,
+            )
         else:
             wire = base64.urlsafe_b64encode(wire).rstrip(b"=")
             twire = wire.decode()  # httpx does a repr() if we give it bytes
             response = session.get(
-                url, headers=headers, timeout=timeout, params={"dns": twire}
+                url,
+                headers=headers,
+                timeout=timeout,
+                params={"dns": twire},
+                extensions=extensions,
             )
 
     # see https://tools.ietf.org/html/rfc8484#section-4.2.1 for info about DoH
     # status codes
     if response.status_code < 200 or response.status_code > 299:
         raise ValueError(
-            "{} responded with status code {}"
-            "\nResponse body: {}".format(where, response.status_code, response.content)
+            f"{where} responded with status code {response.status_code}"
+            f"\nResponse body: {response.content}"
         )
     r = dns.message.from_wire(
         response.content,
@@ -503,6 +566,81 @@ def https(
     return r
 
 
+def _find_header(headers: dns.quic.Headers, name: bytes) -> bytes:
+    if headers is None:
+        raise KeyError
+    for header, value in headers:
+        if header == name:
+            return value
+    raise KeyError
+
+
+def _check_status(headers: dns.quic.Headers, peer: str, wire: bytes) -> None:
+    value = _find_header(headers, b":status")
+    if value is None:
+        raise SyntaxError("no :status header in response")
+    status = int(value)
+    if status < 0:
+        raise SyntaxError("status is negative")
+    if status < 200 or status > 299:
+        error = ""
+        if len(wire) > 0:
+            try:
+                error = ": " + wire.decode()
+            except Exception:
+                pass
+        raise ValueError(f"{peer} responded with status code {status}{error}")
+
+
+def _http3(
+    q: dns.message.Message,
+    where: str,
+    url: str,
+    timeout: Optional[float] = None,
+    port: int = 853,
+    source: Optional[str] = None,
+    source_port: int = 0,
+    one_rr_per_rrset: bool = False,
+    ignore_trailing: bool = False,
+    verify: Union[bool, str] = True,
+    hostname: Optional[str] = None,
+    post: bool = True,
+) -> dns.message.Message:
+    if not dns.quic.have_quic:
+        raise NoDOH("DNS-over-HTTP3 is not available.")  # pragma: no cover
+
+    url_parts = urllib.parse.urlparse(url)
+    hostname = url_parts.hostname
+    if url_parts.port is not None:
+        port = url_parts.port
+
+    q.id = 0
+    wire = q.to_wire()
+    manager = dns.quic.SyncQuicManager(
+        verify_mode=verify, server_name=hostname, h3=True
+    )
+
+    with manager:
+        connection = manager.connect(where, port, source, source_port)
+        (start, expiration) = _compute_times(timeout)
+        with connection.make_stream(timeout) as stream:
+            stream.send_h3(url, wire, post)
+            wire = stream.receive(_remaining(expiration))
+            _check_status(stream.headers(), where, wire)
+        finish = time.time()
+    r = dns.message.from_wire(
+        wire,
+        keyring=q.keyring,
+        request_mac=q.request_mac,
+        one_rr_per_rrset=one_rr_per_rrset,
+        ignore_trailing=ignore_trailing,
+    )
+    r.time = max(finish - start, 0.0)
+    if not q.is_response(r):
+        raise BadResponse
+    return r
+
+
 def _udp_recv(sock, max_size, expiration):
     """Reads a datagram from the socket.
     A Timeout exception will be raised if the operation is not completed
@@ -855,7 +993,7 @@ def _net_read(sock, count, expiration):
         try:
             n = sock.recv(count)
             if n == b"":
-                raise EOFError
+                raise EOFError("EOF")
             count -= len(n)
             s += n
         except (BlockingIOError, ssl.SSLWantReadError):
@@ -1023,6 +1161,7 @@ def tcp(
         cm = _make_socket(af, socket.SOCK_STREAM, source)
     with cm as s:
         if not sock:
+            # pylint: disable=possibly-used-before-assignment
             _connect(s, destination, expiration)
         send_tcp(s, wire, expiration)
         (r, received_time) = receive_tcp(
@@ -1188,6 +1327,7 @@ def quic(
     ignore_trailing: bool = False,
     connection: Optional[dns.quic.SyncQuicConnection] = None,
     verify: Union[bool, str] = True,
+    hostname: Optional[str] = None,
     server_hostname: Optional[str] = None,
 ) -> dns.message.Message:
     """Return the response obtained after sending a query via DNS-over-QUIC.
@@ -1212,17 +1352,21 @@ def quic(
     *ignore_trailing*, a ``bool``. If ``True``, ignore trailing junk at end of the
     received message.
 
-    *connection*, a ``dns.quic.SyncQuicConnection``.  If provided, the
-    connection to use to send the query.
+    *connection*, a ``dns.quic.SyncQuicConnection``.  If provided, the connection to use
+    to send the query.
 
     *verify*, a ``bool`` or ``str``.  If a ``True``, then TLS certificate verification
     of the server is done using the default CA bundle; if ``False``, then no
     verification is done; if a `str` then it specifies the path to a certificate file or
     directory which will be used for verification.
 
-    *server_hostname*, a ``str`` containing the server's hostname.  The
-    default is ``None``, which means that no hostname is known, and if an
-    SSL context is created, hostname checking will be disabled.
+    *hostname*, a ``str`` containing the server's hostname or ``None``.  The default is
+    ``None``, which means that no hostname is known, and if an SSL context is created,
+    hostname checking will be disabled.  This value is ignored if *url* is not
+    ``None``.
+
+    *server_hostname*, a ``str`` or ``None``.  This item is for backwards compatibility
+    only, and has the same meaning as *hostname*.
 
     Returns a ``dns.message.Message``.
     """
@@ -1230,6 +1374,9 @@ def quic(
     if not dns.quic.have_quic:
         raise NoDOQ("DNS-over-QUIC is not available.")  # pragma: no cover
 
+    if server_hostname is not None and hostname is None:
+        hostname = server_hostname
+
     q.id = 0
     wire = q.to_wire()
     the_connection: dns.quic.SyncQuicConnection
@@ -1238,9 +1385,7 @@ def quic(
         manager: contextlib.AbstractContextManager = contextlib.nullcontext(None)
         the_connection = connection
     else:
-        manager = dns.quic.SyncQuicManager(
-            verify_mode=verify, server_name=server_hostname
-        )
+        manager = dns.quic.SyncQuicManager(verify_mode=verify, server_name=hostname)
         the_manager = manager  # for type checking happiness
 
     with manager:
@@ -1264,6 +1409,70 @@ def quic(
     return r
 
 
+class UDPMode(enum.IntEnum):
+    """How should UDP be used in an IXFR from :py:func:`inbound_xfr()`?
+
+    NEVER means "never use UDP; always use TCP"
+    TRY_FIRST means "try to use UDP but fall back to TCP if needed"
+    ONLY means "raise ``dns.xfr.UseTCP`` if trying UDP does not succeed"
+    """
+
+    NEVER = 0
+    TRY_FIRST = 1
+    ONLY = 2
+
+
+def _inbound_xfr(
+    txn_manager: dns.transaction.TransactionManager,
+    s: socket.socket,
+    query: dns.message.Message,
+    serial: Optional[int],
+    timeout: Optional[float],
+    expiration: float,
+) -> Any:
+    """Given a socket, does the zone transfer."""
+    rdtype = query.question[0].rdtype
+    is_ixfr = rdtype == dns.rdatatype.IXFR
+    origin = txn_manager.from_wire_origin()
+    wire = query.to_wire()
+    is_udp = s.type == socket.SOCK_DGRAM
+    if is_udp:
+        _udp_send(s, wire, None, expiration)
+    else:
+        tcpmsg = struct.pack("!H", len(wire)) + wire
+        _net_write(s, tcpmsg, expiration)
+    with dns.xfr.Inbound(txn_manager, rdtype, serial, is_udp) as inbound:
+        done = False
+        tsig_ctx = None
+        while not done:
+            (_, mexpiration) = _compute_times(timeout)
+            if mexpiration is None or (
+                expiration is not None and mexpiration > expiration
+            ):
+                mexpiration = expiration
+            if is_udp:
+                (rwire, _) = _udp_recv(s, 65535, mexpiration)
+            else:
+                ldata = _net_read(s, 2, mexpiration)
+                (l,) = struct.unpack("!H", ldata)
+                rwire = _net_read(s, l, mexpiration)
+            r = dns.message.from_wire(
+                rwire,
+                keyring=query.keyring,
+                request_mac=query.mac,
+                xfr=True,
+                origin=origin,
+                tsig_ctx=tsig_ctx,
+                multi=(not is_udp),
+                one_rr_per_rrset=is_ixfr,
+            )
+            done = inbound.process_message(r)
+            yield r
+            tsig_ctx = r.tsig_ctx
+        if query.keyring and not r.had_tsig:
+            raise dns.exception.FormError("missing TSIG")
+
+
 def xfr(
     where: str,
     zone: Union[dns.name.Name, str],
@@ -1333,134 +1542,52 @@ def xfr(
     Returns a generator of ``dns.message.Message`` objects.
     """
 
+    class DummyTransactionManager(dns.transaction.TransactionManager):
+        def __init__(self, origin, relativize):
+            self.info = (origin, relativize, dns.name.empty if relativize else origin)
+
+        def origin_information(self):
+            return self.info
+
+        def get_class(self) -> dns.rdataclass.RdataClass:
+            raise NotImplementedError  # pragma: no cover
+
+        def reader(self):
+            raise NotImplementedError  # pragma: no cover
+
+        def writer(self, replacement: bool = False) -> dns.transaction.Transaction:
+            class DummyTransaction:
+                def nop(self, *args, **kw):
+                    pass
+
+                def __getattr__(self, _):
+                    return self.nop
+
+            return cast(dns.transaction.Transaction, DummyTransaction())
+
     if isinstance(zone, str):
         zone = dns.name.from_text(zone)
     rdtype = dns.rdatatype.RdataType.make(rdtype)
     q = dns.message.make_query(zone, rdtype, rdclass)
     if rdtype == dns.rdatatype.IXFR:
-        rrset = dns.rrset.from_text(zone, 0, "IN", "SOA", ". . %u 0 0 0 0" % serial)
-        q.authority.append(rrset)
+        rrset = q.find_rrset(
+            q.authority, zone, dns.rdataclass.IN, dns.rdatatype.SOA, create=True
+        )
+        soa = dns.rdata.from_text("IN", "SOA", ". . %u 0 0 0 0" % serial)
+        rrset.add(soa, 0)
     if keyring is not None:
         q.use_tsig(keyring, keyname, algorithm=keyalgorithm)
-    wire = q.to_wire()
     (af, destination, source) = _destination_and_source(
         where, port, source, source_port
     )
+    (_, expiration) = _compute_times(lifetime)
+    tm = DummyTransactionManager(zone, relativize)
     if use_udp and rdtype != dns.rdatatype.IXFR:
         raise ValueError("cannot do a UDP AXFR")
     sock_type = socket.SOCK_DGRAM if use_udp else socket.SOCK_STREAM
     with _make_socket(af, sock_type, source) as s:
-        (_, expiration) = _compute_times(lifetime)
         _connect(s, destination, expiration)
-        l = len(wire)
-        if use_udp:
-            _udp_send(s, wire, None, expiration)
-        else:
-            tcpmsg = struct.pack("!H", l) + wire
-            _net_write(s, tcpmsg, expiration)
-        done = False
-        delete_mode = True
-        expecting_SOA = False
-        soa_rrset = None
-        if relativize:
-            origin = zone
-            oname = dns.name.empty
-        else:
-            origin = None
-            oname = zone
-        tsig_ctx = None
-        while not done:
-            (_, mexpiration) = _compute_times(timeout)
-            if mexpiration is None or (
-                expiration is not None and mexpiration > expiration
-            ):
-                mexpiration = expiration
-            if use_udp:
-                (wire, _) = _udp_recv(s, 65535, mexpiration)
-            else:
-                ldata = _net_read(s, 2, mexpiration)
-                (l,) = struct.unpack("!H", ldata)
-                wire = _net_read(s, l, mexpiration)
-            is_ixfr = rdtype == dns.rdatatype.IXFR
-            r = dns.message.from_wire(
-                wire,
-                keyring=q.keyring,
-                request_mac=q.mac,
-                xfr=True,
-                origin=origin,
-                tsig_ctx=tsig_ctx,
-                multi=True,
-                one_rr_per_rrset=is_ixfr,
-            )
-            rcode = r.rcode()
-            if rcode != dns.rcode.NOERROR:
-                raise TransferError(rcode)
-            tsig_ctx = r.tsig_ctx
-            answer_index = 0
-            if soa_rrset is None:
-                if not r.answer or r.answer[0].name != oname:
-                    raise dns.exception.FormError("No answer or RRset not for qname")
-                rrset = r.answer[0]
-                if rrset.rdtype != dns.rdatatype.SOA:
-                    raise dns.exception.FormError("first RRset is not an SOA")
-                answer_index = 1
-                soa_rrset = rrset.copy()
-                if rdtype == dns.rdatatype.IXFR:
-                    if dns.serial.Serial(soa_rrset[0].serial) <= serial:
-                        #
-                        # We're already up-to-date.
-                        #
-                        done = True
-                    else:
-                        expecting_SOA = True
-            #
-            # Process SOAs in the answer section (other than the initial
-            # SOA in the first message).
-            #
-            for rrset in r.answer[answer_index:]:
-                if done:
-                    raise dns.exception.FormError("answers after final SOA")
-                if rrset.rdtype == dns.rdatatype.SOA and rrset.name == oname:
-                    if expecting_SOA:
-                        if rrset[0].serial != serial:
-                            raise dns.exception.FormError("IXFR base serial mismatch")
-                        expecting_SOA = False
-                    elif rdtype == dns.rdatatype.IXFR:
-                        delete_mode = not delete_mode
-                    #
-                    # If this SOA RRset is equal to the first we saw then we're
-                    # finished. If this is an IXFR we also check that we're
-                    # seeing the record in the expected part of the response.
-                    #
-                    if rrset == soa_rrset and (
-                        rdtype == dns.rdatatype.AXFR
-                        or (rdtype == dns.rdatatype.IXFR and delete_mode)
-                    ):
-                        done = True
-                elif expecting_SOA:
-                    #
-                    # We made an IXFR request and are expecting another
-                    # SOA RR, but saw something else, so this must be an
-                    # AXFR response.
-                    #
-                    rdtype = dns.rdatatype.AXFR
-                    expecting_SOA = False
-            if done and q.keyring and not r.had_tsig:
-                raise dns.exception.FormError("missing TSIG")
-            yield r
-
-
-class UDPMode(enum.IntEnum):
-    """How should UDP be used in an IXFR from :py:func:`inbound_xfr()`?
-
-    NEVER means "never use UDP; always use TCP"
-    TRY_FIRST means "try to use UDP but fall back to TCP if needed"
-    ONLY means "raise ``dns.xfr.UseTCP`` if trying UDP does not succeed"
-    """
-
-    NEVER = 0
-    TRY_FIRST = 1
-    ONLY = 2
+        yield from _inbound_xfr(tm, s, q, serial, timeout, expiration)
 
 
 def inbound_xfr(
@@ -1514,65 +1641,25 @@ def inbound_xfr(
         (query, serial) = dns.xfr.make_query(txn_manager)
     else:
         serial = dns.xfr.extract_serial_from_query(query)
-    rdtype = query.question[0].rdtype
-    is_ixfr = rdtype == dns.rdatatype.IXFR
-    origin = txn_manager.from_wire_origin()
-    wire = query.to_wire()
+
     (af, destination, source) = _destination_and_source(
         where, port, source, source_port
     )
     (_, expiration) = _compute_times(lifetime)
-    retry = True
-    while retry:
-        retry = False
-        if is_ixfr and udp_mode != UDPMode.NEVER:
-            sock_type = socket.SOCK_DGRAM
-            is_udp = True
-        else:
-            sock_type = socket.SOCK_STREAM
-            is_udp = False
-        with _make_socket(af, sock_type, source) as s:
+    if query.question[0].rdtype == dns.rdatatype.IXFR and udp_mode != UDPMode.NEVER:
+        with _make_socket(af, socket.SOCK_DGRAM, source) as s:
             _connect(s, destination, expiration)
-            if is_udp:
-                _udp_send(s, wire, None, expiration)
-            else:
-                tcpmsg = struct.pack("!H", len(wire)) + wire
-                _net_write(s, tcpmsg, expiration)
-            with dns.xfr.Inbound(txn_manager, rdtype, serial, is_udp) as inbound:
-                done = False
-                tsig_ctx = None
-                while not done:
-                    (_, mexpiration) = _compute_times(timeout)
-                    if mexpiration is None or (
-                        expiration is not None and mexpiration > expiration
-                    ):
-                        mexpiration = expiration
-                    if is_udp:
-                        (rwire, _) = _udp_recv(s, 65535, mexpiration)
-                    else:
-                        ldata = _net_read(s, 2, mexpiration)
-                        (l,) = struct.unpack("!H", ldata)
-                        rwire = _net_read(s, l, mexpiration)
-                    r = dns.message.from_wire(
-                        rwire,
-                        keyring=query.keyring,
-                        request_mac=query.mac,
-                        xfr=True,
-                        origin=origin,
-                        tsig_ctx=tsig_ctx,
-                        multi=(not is_udp),
-                        one_rr_per_rrset=is_ixfr,
-                    )
-                    try:
-                        done = inbound.process_message(r)
-                    except dns.xfr.UseTCP:
-                        assert is_udp  # should not happen if we used TCP!
-                        if udp_mode == UDPMode.ONLY:
-                            raise
-                        done = True
-                        retry = True
-                        udp_mode = UDPMode.NEVER
-                        continue
-                    tsig_ctx = r.tsig_ctx
-                if not retry and query.keyring and not r.had_tsig:
-                    raise dns.exception.FormError("missing TSIG")
+            try:
+                for _ in _inbound_xfr(
+                    txn_manager, s, query, serial, timeout, expiration
+                ):
+                    pass
+                return
+            except dns.xfr.UseTCP:
+                if udp_mode == UDPMode.ONLY:
+                    raise
+
+    with _make_socket(af, socket.SOCK_STREAM, source) as s:
+        _connect(s, destination, expiration)
+        for _ in _inbound_xfr(txn_manager, s, query, serial, timeout, expiration):
+            pass
diff --git a/lib/dns/quic/__init__.py b/lib/dns/quic/__init__.py
index 20aff345..0750e729 100644
--- a/lib/dns/quic/__init__.py
+++ b/lib/dns/quic/__init__.py
@@ -1,5 +1,7 @@
 # Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license
 
+from typing import List, Tuple
+
 import dns._features
 import dns.asyncbackend
 
@@ -73,3 +75,6 @@ else:  # pragma: no cover
     class SyncQuicConnection:  # type: ignore
         def make_stream(self) -> Any:
             raise NotImplementedError
+
+
+Headers = List[Tuple[bytes, bytes]]
diff --git a/lib/dns/quic/_asyncio.py b/lib/dns/quic/_asyncio.py
index 0f44331f..f87515da 100644
--- a/lib/dns/quic/_asyncio.py
+++ b/lib/dns/quic/_asyncio.py
@@ -43,12 +43,26 @@ class AsyncioQuicStream(BaseQuicStream):
                 raise dns.exception.Timeout
             self._expecting = 0
 
+    async def wait_for_end(self, expiration):
+        while True:
+            timeout = self._timeout_from_expiration(expiration)
+            if self._buffer.seen_end():
+                return
+            try:
+                await asyncio.wait_for(self._wait_for_wake_up(), timeout)
+            except TimeoutError:
+                raise dns.exception.Timeout
+
     async def receive(self, timeout=None):
         expiration = self._expiration_from_timeout(timeout)
-        await self.wait_for(2, expiration)
-        (size,) = struct.unpack("!H", self._buffer.get(2))
-        await self.wait_for(size, expiration)
-        return self._buffer.get(size)
+        if self._connection.is_h3():
+            await self.wait_for_end(expiration)
+            return self._buffer.get_all()
+        else:
+            await self.wait_for(2, expiration)
+            (size,) = struct.unpack("!H", self._buffer.get(2))
+            await self.wait_for(size, expiration)
+            return self._buffer.get(size)
 
     async def send(self, datagram, is_end=False):
         data = self._encapsulate(datagram)
@@ -83,6 +97,7 @@ class AsyncioQuicConnection(AsyncQuicConnection):
         self._wake_timer = asyncio.Condition()
         self._receiver_task = None
         self._sender_task = None
+        self._wake_pending = False
 
     async def _receiver(self):
         try:
@@ -104,19 +119,24 @@ class AsyncioQuicConnection(AsyncQuicConnection):
                     self._connection.receive_datagram(datagram, address, time.time())
                     # Wake up the timer in case the sender is sleeping, as there may be
                     # stuff to send now.
-                    async with self._wake_timer:
-                        self._wake_timer.notify_all()
+                    await self._wakeup()
         except Exception:
             pass
         finally:
             self._done = True
-            async with self._wake_timer:
-                self._wake_timer.notify_all()
+            await self._wakeup()
             self._handshake_complete.set()
 
+    async def _wakeup(self):
+        self._wake_pending = True
+        async with self._wake_timer:
+            self._wake_timer.notify_all()
+
     async def _wait_for_wake_timer(self):
         async with self._wake_timer:
-            await self._wake_timer.wait()
+            if not self._wake_pending:
+                await self._wake_timer.wait()
+        self._wake_pending = False
 
     async def _sender(self):
         await self._socket_created.wait()
@@ -140,9 +160,28 @@ class AsyncioQuicConnection(AsyncQuicConnection):
             if event is None:
                 return
             if isinstance(event, aioquic.quic.events.StreamDataReceived):
-                stream = self._streams.get(event.stream_id)
-                if stream:
-                    await stream._add_input(event.data, event.end_stream)
+                if self.is_h3():
+                    h3_events = self._h3_conn.handle_event(event)
+                    for h3_event in h3_events:
+                        if isinstance(h3_event, aioquic.h3.events.HeadersReceived):
+                            stream = self._streams.get(event.stream_id)
+                            if stream:
+                                if stream._headers is None:
+                                    stream._headers = h3_event.headers
+                                elif stream._trailers is None:
+                                    stream._trailers = h3_event.headers
+                                if h3_event.stream_ended:
+                                    await stream._add_input(b"", True)
+                        elif isinstance(h3_event, aioquic.h3.events.DataReceived):
+                            stream = self._streams.get(event.stream_id)
+                            if stream:
+                                await stream._add_input(
+                                    h3_event.data, h3_event.stream_ended
+                                )
+                else:
+                    stream = self._streams.get(event.stream_id)
+                    if stream:
+                        await stream._add_input(event.data, event.end_stream)
             elif isinstance(event, aioquic.quic.events.HandshakeCompleted):
                 self._handshake_complete.set()
             elif isinstance(event, aioquic.quic.events.ConnectionTerminated):
@@ -161,8 +200,7 @@ class AsyncioQuicConnection(AsyncQuicConnection):
 
     async def write(self, stream, data, is_end=False):
         self._connection.send_stream_data(stream, data, is_end)
-        async with self._wake_timer:
-            self._wake_timer.notify_all()
+        await self._wakeup()
 
     def run(self):
         if self._closed:
@@ -189,8 +227,7 @@ class AsyncioQuicConnection(AsyncQuicConnection):
             self._connection.close()
             # sender might be blocked on this, so set it
             self._socket_created.set()
-            async with self._wake_timer:
-                self._wake_timer.notify_all()
+            await self._wakeup()
             try:
                 await self._receiver_task
             except asyncio.CancelledError:
@@ -203,8 +240,10 @@ class AsyncioQuicConnection(AsyncQuicConnection):
 
 
 class AsyncioQuicManager(AsyncQuicManager):
-    def __init__(self, conf=None, verify_mode=ssl.CERT_REQUIRED, server_name=None):
-        super().__init__(conf, verify_mode, AsyncioQuicConnection, server_name)
+    def __init__(
+        self, conf=None, verify_mode=ssl.CERT_REQUIRED, server_name=None, h3=False
+    ):
+        super().__init__(conf, verify_mode, AsyncioQuicConnection, server_name, h3)
 
     def connect(
         self, address, port=853, source=None, source_port=0, want_session_ticket=True
diff --git a/lib/dns/quic/_common.py b/lib/dns/quic/_common.py
index 0eacc691..ce575b03 100644
--- a/lib/dns/quic/_common.py
+++ b/lib/dns/quic/_common.py
@@ -1,12 +1,16 @@
 # Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license
 
+import base64
 import copy
 import functools
 import socket
 import struct
 import time
+import urllib
 from typing import Any, Optional
 
+import aioquic.h3.connection  # type: ignore
+import aioquic.h3.events  # type: ignore
 import aioquic.quic.configuration  # type: ignore
 import aioquic.quic.connection  # type: ignore
 
@@ -51,6 +55,12 @@ class Buffer:
         self._buffer = self._buffer[amount:]
         return data
 
+    def get_all(self):
+        assert self.seen_end()
+        data = self._buffer
+        self._buffer = b""
+        return data
+
 
 class BaseQuicStream:
     def __init__(self, connection, stream_id):
@@ -58,10 +68,18 @@ class BaseQuicStream:
         self._stream_id = stream_id
         self._buffer = Buffer()
         self._expecting = 0
+        self._headers = None
+        self._trailers = None
 
     def id(self):
         return self._stream_id
 
+    def headers(self):
+        return self._headers
+
+    def trailers(self):
+        return self._trailers
+
     def _expiration_from_timeout(self, timeout):
         if timeout is not None:
             expiration = time.time() + timeout
@@ -77,16 +95,51 @@ class BaseQuicStream:
         return timeout
 
     # Subclass must implement receive() as sync / async and which returns a message
-    # or raises UnexpectedEOF.
+    # or raises.
+
+    # Subclass must implement send() as sync / async and which takes a message and
+    # an EOF indicator.
+
+    def send_h3(self, url, datagram, post=True):
+        if not self._connection.is_h3():
+            raise SyntaxError("cannot send H3 to a non-H3 connection")
+        url_parts = urllib.parse.urlparse(url)
+        path = url_parts.path.encode()
+        if post:
+            method = b"POST"
+        else:
+            method = b"GET"
+            path += b"?dns=" + base64.urlsafe_b64encode(datagram).rstrip(b"=")
+        headers = [
+            (b":method", method),
+            (b":scheme", url_parts.scheme.encode()),
+            (b":authority", url_parts.netloc.encode()),
+            (b":path", path),
+            (b"accept", b"application/dns-message"),
+        ]
+        if post:
+            headers.extend(
+                [
+                    (b"content-type", b"application/dns-message"),
+                    (b"content-length", str(len(datagram)).encode()),
+                ]
+            )
+        self._connection.send_headers(self._stream_id, headers, not post)
+        if post:
+            self._connection.send_data(self._stream_id, datagram, True)
 
     def _encapsulate(self, datagram):
+        if self._connection.is_h3():
+            return datagram
         l = len(datagram)
         return struct.pack("!H", l) + datagram
 
     def _common_add_input(self, data, is_end):
         self._buffer.put(data, is_end)
         try:
-            return self._expecting > 0 and self._buffer.have(self._expecting)
+            return (
+                self._expecting > 0 and self._buffer.have(self._expecting)
+            ) or self._buffer.seen_end
         except UnexpectedEOF:
             return True
 
@@ -97,7 +150,13 @@ class BaseQuicStream:
 
 class BaseQuicConnection:
     def __init__(
-        self, connection, address, port, source=None, source_port=0, manager=None
+        self,
+        connection,
+        address,
+        port,
+        source=None,
+        source_port=0,
+        manager=None,
     ):
         self._done = False
         self._connection = connection
@@ -106,6 +165,10 @@ class BaseQuicConnection:
         self._closed = False
         self._manager = manager
         self._streams = {}
+        if manager.is_h3():
+            self._h3_conn = aioquic.h3.connection.H3Connection(connection, False)
+        else:
+            self._h3_conn = None
         self._af = dns.inet.af_for_address(address)
         self._peer = dns.inet.low_level_address_tuple((address, port))
         if source is None and source_port != 0:
@@ -120,9 +183,18 @@ class BaseQuicConnection:
         else:
             self._source = None
 
+    def is_h3(self):
+        return self._h3_conn is not None
+
     def close_stream(self, stream_id):
         del self._streams[stream_id]
 
+    def send_headers(self, stream_id, headers, is_end=False):
+        self._h3_conn.send_headers(stream_id, headers, is_end)
+
+    def send_data(self, stream_id, data, is_end=False):
+        self._h3_conn.send_data(stream_id, data, is_end)
+
     def _get_timer_values(self, closed_is_special=True):
         now = time.time()
         expiration = self._connection.get_timer()
@@ -148,17 +220,25 @@ class AsyncQuicConnection(BaseQuicConnection):
 
 
 class BaseQuicManager:
-    def __init__(self, conf, verify_mode, connection_factory, server_name=None):
+    def __init__(
+        self, conf, verify_mode, connection_factory, server_name=None, h3=False
+    ):
         self._connections = {}
         self._connection_factory = connection_factory
         self._session_tickets = {}
+        self._tokens = {}
+        self._h3 = h3
         if conf is None:
             verify_path = None
             if isinstance(verify_mode, str):
                 verify_path = verify_mode
                 verify_mode = True
+            if h3:
+                alpn_protocols = ["h3"]
+            else:
+                alpn_protocols = ["doq", "doq-i03"]
             conf = aioquic.quic.configuration.QuicConfiguration(
-                alpn_protocols=["doq", "doq-i03"],
+                alpn_protocols=alpn_protocols,
                 verify_mode=verify_mode,
                 server_name=server_name,
             )
@@ -167,7 +247,13 @@ class BaseQuicManager:
         self._conf = conf
 
     def _connect(
-        self, address, port=853, source=None, source_port=0, want_session_ticket=True
+        self,
+        address,
+        port=853,
+        source=None,
+        source_port=0,
+        want_session_ticket=True,
+        want_token=True,
     ):
         connection = self._connections.get((address, port))
         if connection is not None:
@@ -189,9 +275,24 @@ class BaseQuicManager:
             )
         else:
             session_ticket_handler = None
+        if want_token:
+            try:
+                token = self._tokens.pop((address, port))
+                # We found a token, so make a configuration that uses it.
+                conf = copy.copy(conf)
+                conf.token = token
+            except KeyError:
+                # No token
+                pass
+            # Whether or not we found a token, we want a handler to save # one.
+            token_handler = functools.partial(self.save_token, address, port)
+        else:
+            token_handler = None
+
         qconn = aioquic.quic.connection.QuicConnection(
             configuration=conf,
             session_ticket_handler=session_ticket_handler,
+            token_handler=token_handler,
         )
         lladdress = dns.inet.low_level_address_tuple((address, port))
         qconn.connect(lladdress, time.time())
@@ -207,6 +308,9 @@ class BaseQuicManager:
         except KeyError:
             pass
 
+    def is_h3(self):
+        return self._h3
+
     def save_session_ticket(self, address, port, ticket):
         # We rely on dictionaries keys() being in insertion order here.  We
         # can't just popitem() as that would be LIFO which is the opposite of
@@ -218,6 +322,17 @@ class BaseQuicManager:
                 del self._session_tickets[key]
         self._session_tickets[(address, port)] = ticket
 
+    def save_token(self, address, port, token):
+        # We rely on dictionaries keys() being in insertion order here.  We
+        # can't just popitem() as that would be LIFO which is the opposite of
+        # what we want.
+        l = len(self._tokens)
+        if l >= MAX_SESSION_TICKETS:
+            keys_to_delete = list(self._tokens.keys())[0:SESSIONS_TO_DELETE]
+            for key in keys_to_delete:
+                del self._tokens[key]
+        self._tokens[(address, port)] = token
+
 
 class AsyncQuicManager(BaseQuicManager):
     def connect(self, address, port=853, source=None, source_port=0):
diff --git a/lib/dns/quic/_sync.py b/lib/dns/quic/_sync.py
index 120cb5f3..473d1f48 100644
--- a/lib/dns/quic/_sync.py
+++ b/lib/dns/quic/_sync.py
@@ -21,11 +21,9 @@ from dns.quic._common import (
     UnexpectedEOF,
 )
 
-# Avoid circularity with dns.query
-if hasattr(selectors, "PollSelector"):
-    _selector_class = selectors.PollSelector  # type: ignore
-else:
-    _selector_class = selectors.SelectSelector  # type: ignore
+# Function used to create a socket.  Can be overridden if needed in special
+# situations.
+socket_factory = socket.socket
 
 
 class SyncQuicStream(BaseQuicStream):
@@ -46,14 +44,29 @@ class SyncQuicStream(BaseQuicStream):
                     raise dns.exception.Timeout
             self._expecting = 0
 
+    def wait_for_end(self, expiration):
+        while True:
+            timeout = self._timeout_from_expiration(expiration)
+            with self._lock:
+                if self._buffer.seen_end():
+                    return
+            with self._wake_up:
+                if not self._wake_up.wait(timeout):
+                    raise dns.exception.Timeout
+
     def receive(self, timeout=None):
         expiration = self._expiration_from_timeout(timeout)
-        self.wait_for(2, expiration)
-        with self._lock:
-            (size,) = struct.unpack("!H", self._buffer.get(2))
-        self.wait_for(size, expiration)
-        with self._lock:
-            return self._buffer.get(size)
+        if self._connection.is_h3():
+            self.wait_for_end(expiration)
+            with self._lock:
+                return self._buffer.get_all()
+        else:
+            self.wait_for(2, expiration)
+            with self._lock:
+                (size,) = struct.unpack("!H", self._buffer.get(2))
+            self.wait_for(size, expiration)
+            with self._lock:
+                return self._buffer.get(size)
 
     def send(self, datagram, is_end=False):
         data = self._encapsulate(datagram)
@@ -81,7 +94,7 @@ class SyncQuicStream(BaseQuicStream):
 class SyncQuicConnection(BaseQuicConnection):
     def __init__(self, connection, address, port, source, source_port, manager):
         super().__init__(connection, address, port, source, source_port, manager)
-        self._socket = socket.socket(self._af, socket.SOCK_DGRAM, 0)
+        self._socket = socket_factory(self._af, socket.SOCK_DGRAM, 0)
         if self._source is not None:
             try:
                 self._socket.bind(
@@ -118,7 +131,7 @@ class SyncQuicConnection(BaseQuicConnection):
 
     def _worker(self):
         try:
-            sel = _selector_class()
+            sel = selectors.DefaultSelector()
             sel.register(self._socket, selectors.EVENT_READ, self._read)
             sel.register(self._receive_wakeup, selectors.EVENT_READ, self._drain_wakeup)
             while not self._done:
@@ -140,6 +153,7 @@ class SyncQuicConnection(BaseQuicConnection):
         finally:
             with self._lock:
                 self._done = True
+            self._socket.close()
             # Ensure anyone waiting for this gets woken up.
             self._handshake_complete.set()
 
@@ -150,10 +164,29 @@ class SyncQuicConnection(BaseQuicConnection):
             if event is None:
                 return
             if isinstance(event, aioquic.quic.events.StreamDataReceived):
-                with self._lock:
-                    stream = self._streams.get(event.stream_id)
-                if stream:
-                    stream._add_input(event.data, event.end_stream)
+                if self.is_h3():
+                    h3_events = self._h3_conn.handle_event(event)
+                    for h3_event in h3_events:
+                        if isinstance(h3_event, aioquic.h3.events.HeadersReceived):
+                            with self._lock:
+                                stream = self._streams.get(event.stream_id)
+                            if stream:
+                                if stream._headers is None:
+                                    stream._headers = h3_event.headers
+                                elif stream._trailers is None:
+                                    stream._trailers = h3_event.headers
+                                if h3_event.stream_ended:
+                                    stream._add_input(b"", True)
+                        elif isinstance(h3_event, aioquic.h3.events.DataReceived):
+                            with self._lock:
+                                stream = self._streams.get(event.stream_id)
+                            if stream:
+                                stream._add_input(h3_event.data, h3_event.stream_ended)
+                else:
+                    with self._lock:
+                        stream = self._streams.get(event.stream_id)
+                    if stream:
+                        stream._add_input(event.data, event.end_stream)
             elif isinstance(event, aioquic.quic.events.HandshakeCompleted):
                 self._handshake_complete.set()
             elif isinstance(event, aioquic.quic.events.ConnectionTerminated):
@@ -170,6 +203,18 @@ class SyncQuicConnection(BaseQuicConnection):
             self._connection.send_stream_data(stream, data, is_end)
         self._send_wakeup.send(b"\x01")
 
+    def send_headers(self, stream_id, headers, is_end=False):
+        with self._lock:
+            super().send_headers(stream_id, headers, is_end)
+        if is_end:
+            self._send_wakeup.send(b"\x01")
+
+    def send_data(self, stream_id, data, is_end=False):
+        with self._lock:
+            super().send_data(stream_id, data, is_end)
+        if is_end:
+            self._send_wakeup.send(b"\x01")
+
     def run(self):
         if self._closed:
             return
@@ -203,16 +248,24 @@ class SyncQuicConnection(BaseQuicConnection):
 
 
 class SyncQuicManager(BaseQuicManager):
-    def __init__(self, conf=None, verify_mode=ssl.CERT_REQUIRED, server_name=None):
-        super().__init__(conf, verify_mode, SyncQuicConnection, server_name)
+    def __init__(
+        self, conf=None, verify_mode=ssl.CERT_REQUIRED, server_name=None, h3=False
+    ):
+        super().__init__(conf, verify_mode, SyncQuicConnection, server_name, h3)
         self._lock = threading.Lock()
 
     def connect(
-        self, address, port=853, source=None, source_port=0, want_session_ticket=True
+        self,
+        address,
+        port=853,
+        source=None,
+        source_port=0,
+        want_session_ticket=True,
+        want_token=True,
     ):
         with self._lock:
             (connection, start) = self._connect(
-                address, port, source, source_port, want_session_ticket
+                address, port, source, source_port, want_session_ticket, want_token
             )
             if start:
                 connection.run()
@@ -226,6 +279,10 @@ class SyncQuicManager(BaseQuicManager):
         with self._lock:
             super().save_session_ticket(address, port, ticket)
 
+    def save_token(self, address, port, token):
+        with self._lock:
+            super().save_token(address, port, token)
+
     def __enter__(self):
         return self
 
diff --git a/lib/dns/quic/_trio.py b/lib/dns/quic/_trio.py
index 35e36b98..ae79f369 100644
--- a/lib/dns/quic/_trio.py
+++ b/lib/dns/quic/_trio.py
@@ -36,16 +36,27 @@ class TrioQuicStream(BaseQuicStream):
                 await self._wake_up.wait()
             self._expecting = 0
 
+    async def wait_for_end(self):
+        while True:
+            if self._buffer.seen_end():
+                return
+            async with self._wake_up:
+                await self._wake_up.wait()
+
     async def receive(self, timeout=None):
         if timeout is None:
             context = NullContext(None)
         else:
             context = trio.move_on_after(timeout)
         with context:
-            await self.wait_for(2)
-            (size,) = struct.unpack("!H", self._buffer.get(2))
-            await self.wait_for(size)
-            return self._buffer.get(size)
+            if self._connection.is_h3():
+                await self.wait_for_end()
+                return self._buffer.get_all()
+            else:
+                await self.wait_for(2)
+                (size,) = struct.unpack("!H", self._buffer.get(2))
+                await self.wait_for(size)
+                return self._buffer.get(size)
         raise dns.exception.Timeout
 
     async def send(self, datagram, is_end=False):
@@ -115,6 +126,7 @@ class TrioQuicConnection(AsyncQuicConnection):
                     await self._socket.send(datagram)
         finally:
             self._done = True
+            self._socket.close()
             self._handshake_complete.set()
 
     async def _handle_events(self):
@@ -124,9 +136,28 @@ class TrioQuicConnection(AsyncQuicConnection):
             if event is None:
                 return
             if isinstance(event, aioquic.quic.events.StreamDataReceived):
-                stream = self._streams.get(event.stream_id)
-                if stream:
-                    await stream._add_input(event.data, event.end_stream)
+                if self.is_h3():
+                    h3_events = self._h3_conn.handle_event(event)
+                    for h3_event in h3_events:
+                        if isinstance(h3_event, aioquic.h3.events.HeadersReceived):
+                            stream = self._streams.get(event.stream_id)
+                            if stream:
+                                if stream._headers is None:
+                                    stream._headers = h3_event.headers
+                                elif stream._trailers is None:
+                                    stream._trailers = h3_event.headers
+                                if h3_event.stream_ended:
+                                    await stream._add_input(b"", True)
+                        elif isinstance(h3_event, aioquic.h3.events.DataReceived):
+                            stream = self._streams.get(event.stream_id)
+                            if stream:
+                                await stream._add_input(
+                                    h3_event.data, h3_event.stream_ended
+                                )
+                else:
+                    stream = self._streams.get(event.stream_id)
+                    if stream:
+                        await stream._add_input(event.data, event.end_stream)
             elif isinstance(event, aioquic.quic.events.HandshakeCompleted):
                 self._handshake_complete.set()
             elif isinstance(event, aioquic.quic.events.ConnectionTerminated):
@@ -183,9 +214,14 @@ class TrioQuicConnection(AsyncQuicConnection):
 
 class TrioQuicManager(AsyncQuicManager):
     def __init__(
-        self, nursery, conf=None, verify_mode=ssl.CERT_REQUIRED, server_name=None
+        self,
+        nursery,
+        conf=None,
+        verify_mode=ssl.CERT_REQUIRED,
+        server_name=None,
+        h3=False,
     ):
-        super().__init__(conf, verify_mode, TrioQuicConnection, server_name)
+        super().__init__(conf, verify_mode, TrioQuicConnection, server_name, h3)
         self._nursery = nursery
 
     def connect(
diff --git a/lib/dns/rdata.py b/lib/dns/rdata.py
index 024fd8f6..8099c26a 100644
--- a/lib/dns/rdata.py
+++ b/lib/dns/rdata.py
@@ -214,7 +214,7 @@ class Rdata:
         compress: Optional[dns.name.CompressType] = None,
         origin: Optional[dns.name.Name] = None,
         canonicalize: bool = False,
-    ) -> bytes:
+    ) -> None:
         raise NotImplementedError  # pragma: no cover
 
     def to_wire(
@@ -223,14 +223,19 @@ class Rdata:
         compress: Optional[dns.name.CompressType] = None,
         origin: Optional[dns.name.Name] = None,
         canonicalize: bool = False,
-    ) -> bytes:
+    ) -> Optional[bytes]:
         """Convert an rdata to wire format.
 
-        Returns a ``bytes`` or ``None``.
+        Returns a ``bytes`` if no output file was specified, or ``None`` otherwise.
         """
 
         if file:
-            return self._to_wire(file, compress, origin, canonicalize)
+            # We call _to_wire() and then return None explicitly instead of
+            # of just returning the None from _to_wire() as mypy's func-returns-value
+            # unhelpfully errors out with "error: "_to_wire" of "Rdata" does not return
+            # a value (it only ever returns None)"
+            self._to_wire(file, compress, origin, canonicalize)
+            return None
         else:
             f = io.BytesIO()
             self._to_wire(f, compress, origin, canonicalize)
@@ -253,8 +258,9 @@ class Rdata:
 
         Returns a ``bytes``.
         """
-
-        return self.to_wire(origin=origin, canonicalize=True)
+        wire = self.to_wire(origin=origin, canonicalize=True)
+        assert wire is not None  # for mypy
+        return wire
 
     def __repr__(self):
         covers = self.covers()
@@ -434,15 +440,11 @@ class Rdata:
                 continue
             if key not in parameters:
                 raise AttributeError(
-                    "'{}' object has no attribute '{}'".format(
-                        self.__class__.__name__, key
-                    )
+                    f"'{self.__class__.__name__}' object has no attribute '{key}'"
                 )
             if key in ("rdclass", "rdtype"):
                 raise AttributeError(
-                    "Cannot overwrite '{}' attribute '{}'".format(
-                        self.__class__.__name__, key
-                    )
+                    f"Cannot overwrite '{self.__class__.__name__}' attribute '{key}'"
                 )
 
         # Construct the parameter list.  For each field, use the value in
@@ -646,13 +648,14 @@ _rdata_classes: Dict[Tuple[dns.rdataclass.RdataClass, dns.rdatatype.RdataType],
     {}
 )
 _module_prefix = "dns.rdtypes"
+_dynamic_load_allowed = True
 
 
-def get_rdata_class(rdclass, rdtype):
+def get_rdata_class(rdclass, rdtype, use_generic=True):
     cls = _rdata_classes.get((rdclass, rdtype))
     if not cls:
         cls = _rdata_classes.get((dns.rdatatype.ANY, rdtype))
-        if not cls:
+        if not cls and _dynamic_load_allowed:
             rdclass_text = dns.rdataclass.to_text(rdclass)
             rdtype_text = dns.rdatatype.to_text(rdtype)
             rdtype_text = rdtype_text.replace("-", "_")
@@ -670,12 +673,36 @@ def get_rdata_class(rdclass, rdtype):
                     _rdata_classes[(rdclass, rdtype)] = cls
                 except ImportError:
                     pass
-    if not cls:
+    if not cls and use_generic:
         cls = GenericRdata
         _rdata_classes[(rdclass, rdtype)] = cls
     return cls
 
 
+def load_all_types(disable_dynamic_load=True):
+    """Load all rdata types for which dnspython has a non-generic implementation.
+
+    Normally dnspython loads DNS rdatatype implementations on demand, but in some
+    specialized cases loading all types at an application-controlled time is preferred.
+
+    If *disable_dynamic_load*, a ``bool``, is ``True`` then dnspython will not attempt
+    to use its dynamic loading mechanism if an unknown type is subsequently encountered,
+    and will simply use the ``GenericRdata`` class.
+    """
+    # Load class IN and ANY types.
+    for rdtype in dns.rdatatype.RdataType:
+        get_rdata_class(dns.rdataclass.IN, rdtype, False)
+    # Load the one non-ANY implementation we have in CH.  Everything
+    # else in CH is an ANY type, and we'll discover those on demand but won't
+    # have to import anything.
+    get_rdata_class(dns.rdataclass.CH, dns.rdatatype.A, False)
+    if disable_dynamic_load:
+        # Now disable dynamic loading so any subsequent unknown type immediately becomes
+        # GenericRdata without a load attempt.
+        global _dynamic_load_allowed
+        _dynamic_load_allowed = False
+
+
 def from_text(
     rdclass: Union[dns.rdataclass.RdataClass, str],
     rdtype: Union[dns.rdatatype.RdataType, str],
diff --git a/lib/dns/rdataset.py b/lib/dns/rdataset.py
index 8bff58d7..39cab236 100644
--- a/lib/dns/rdataset.py
+++ b/lib/dns/rdataset.py
@@ -160,7 +160,7 @@ class Rdataset(dns.set.Set):
                 return s[:100] + "..."
             return s
 
-        return "[%s]" % ", ".join("<%s>" % maybe_truncate(str(rr)) for rr in self)
+        return "[" + ", ".join(f"<{maybe_truncate(str(rr))}>" for rr in self) + "]"
 
     def __repr__(self):
         if self.covers == 0:
@@ -248,12 +248,8 @@ class Rdataset(dns.set.Set):
             # (which is meaningless anyway).
             #
             s.write(
-                "{}{}{} {}\n".format(
-                    ntext,
-                    pad,
-                    dns.rdataclass.to_text(rdclass),
-                    dns.rdatatype.to_text(self.rdtype),
-                )
+                f"{ntext}{pad}{dns.rdataclass.to_text(rdclass)} "
+                f"{dns.rdatatype.to_text(self.rdtype)}\n"
             )
         else:
             for rd in self:
diff --git a/lib/dns/rdatatype.py b/lib/dns/rdatatype.py
index e6c58186..aa9e561c 100644
--- a/lib/dns/rdatatype.py
+++ b/lib/dns/rdatatype.py
@@ -105,6 +105,8 @@ class RdataType(dns.enum.IntEnum):
     CAA = 257
     AVC = 258
     AMTRELAY = 260
+    RESINFO = 261
+    WALLET = 262
     TA = 32768
     DLV = 32769
 
@@ -125,7 +127,7 @@ class RdataType(dns.enum.IntEnum):
         if text.find("-") >= 0:
             try:
                 return cls[text.replace("-", "_")]
-            except KeyError:
+            except KeyError:  # pragma: no cover
                 pass
         return _registered_by_text.get(text)
 
@@ -326,6 +328,8 @@ URI = RdataType.URI
 CAA = RdataType.CAA
 AVC = RdataType.AVC
 AMTRELAY = RdataType.AMTRELAY
+RESINFO = RdataType.RESINFO
+WALLET = RdataType.WALLET
 TA = RdataType.TA
 DLV = RdataType.DLV
 
diff --git a/lib/dns/rdtypes/ANY/GPOS.py b/lib/dns/rdtypes/ANY/GPOS.py
index 312338f9..d79f4a06 100644
--- a/lib/dns/rdtypes/ANY/GPOS.py
+++ b/lib/dns/rdtypes/ANY/GPOS.py
@@ -75,8 +75,9 @@ class GPOS(dns.rdata.Rdata):
             raise dns.exception.FormError("bad longitude")
 
     def to_text(self, origin=None, relativize=True, **kw):
-        return "{} {} {}".format(
-            self.latitude.decode(), self.longitude.decode(), self.altitude.decode()
+        return (
+            f"{self.latitude.decode()} {self.longitude.decode()} "
+            f"{self.altitude.decode()}"
         )
 
     @classmethod
diff --git a/lib/dns/rdtypes/ANY/HINFO.py b/lib/dns/rdtypes/ANY/HINFO.py
index c2c45de0..06ad3487 100644
--- a/lib/dns/rdtypes/ANY/HINFO.py
+++ b/lib/dns/rdtypes/ANY/HINFO.py
@@ -37,9 +37,7 @@ class HINFO(dns.rdata.Rdata):
         self.os = self._as_bytes(os, True, 255)
 
     def to_text(self, origin=None, relativize=True, **kw):
-        return '"{}" "{}"'.format(
-            dns.rdata._escapify(self.cpu), dns.rdata._escapify(self.os)
-        )
+        return f'"{dns.rdata._escapify(self.cpu)}" "{dns.rdata._escapify(self.os)}"'
 
     @classmethod
     def from_text(
diff --git a/lib/dns/rdtypes/ANY/HIP.py b/lib/dns/rdtypes/ANY/HIP.py
index 91669139..f3157da7 100644
--- a/lib/dns/rdtypes/ANY/HIP.py
+++ b/lib/dns/rdtypes/ANY/HIP.py
@@ -48,7 +48,7 @@ class HIP(dns.rdata.Rdata):
         for server in self.servers:
             servers.append(server.choose_relativity(origin, relativize))
         if len(servers) > 0:
-            text += " " + " ".join((x.to_unicode() for x in servers))
+            text += " " + " ".join(x.to_unicode() for x in servers)
         return "%u %s %s%s" % (self.algorithm, hit, key, text)
 
     @classmethod
diff --git a/lib/dns/rdtypes/ANY/ISDN.py b/lib/dns/rdtypes/ANY/ISDN.py
index fb01eab3..6428a0a8 100644
--- a/lib/dns/rdtypes/ANY/ISDN.py
+++ b/lib/dns/rdtypes/ANY/ISDN.py
@@ -38,11 +38,12 @@ class ISDN(dns.rdata.Rdata):
 
     def to_text(self, origin=None, relativize=True, **kw):
         if self.subaddress:
-            return '"{}" "{}"'.format(
-                dns.rdata._escapify(self.address), dns.rdata._escapify(self.subaddress)
+            return (
+                f'"{dns.rdata._escapify(self.address)}" '
+                f'"{dns.rdata._escapify(self.subaddress)}"'
             )
         else:
-            return '"%s"' % dns.rdata._escapify(self.address)
+            return f'"{dns.rdata._escapify(self.address)}"'
 
     @classmethod
     def from_text(
diff --git a/lib/dns/rdtypes/ANY/LOC.py b/lib/dns/rdtypes/ANY/LOC.py
index a36a2c10..1153cf03 100644
--- a/lib/dns/rdtypes/ANY/LOC.py
+++ b/lib/dns/rdtypes/ANY/LOC.py
@@ -44,7 +44,7 @@ def _exponent_of(what, desc):
             exp = i - 1
             break
     if exp is None or exp < 0:
-        raise dns.exception.SyntaxError("%s value out of bounds" % desc)
+        raise dns.exception.SyntaxError(f"{desc} value out of bounds")
     return exp
 
 
@@ -83,10 +83,10 @@ def _encode_size(what, desc):
 def _decode_size(what, desc):
     exponent = what & 0x0F
     if exponent > 9:
-        raise dns.exception.FormError("bad %s exponent" % desc)
+        raise dns.exception.FormError(f"bad {desc} exponent")
     base = (what & 0xF0) >> 4
     if base > 9:
-        raise dns.exception.FormError("bad %s base" % desc)
+        raise dns.exception.FormError(f"bad {desc} base")
     return base * pow(10, exponent)
 
 
@@ -184,10 +184,9 @@ class LOC(dns.rdata.Rdata):
             or self.horizontal_precision != _default_hprec
             or self.vertical_precision != _default_vprec
         ):
-            text += " {:0.2f}m {:0.2f}m {:0.2f}m".format(
-                self.size / 100.0,
-                self.horizontal_precision / 100.0,
-                self.vertical_precision / 100.0,
+            text += (
+                f" {self.size / 100.0:0.2f}m {self.horizontal_precision / 100.0:0.2f}m"
+                f" {self.vertical_precision / 100.0:0.2f}m"
             )
         return text
 
diff --git a/lib/dns/rdtypes/ANY/NSEC.py b/lib/dns/rdtypes/ANY/NSEC.py
index 340525a6..3c78b722 100644
--- a/lib/dns/rdtypes/ANY/NSEC.py
+++ b/lib/dns/rdtypes/ANY/NSEC.py
@@ -44,7 +44,7 @@ class NSEC(dns.rdata.Rdata):
     def to_text(self, origin=None, relativize=True, **kw):
         next = self.next.choose_relativity(origin, relativize)
         text = Bitmap(self.windows).to_text()
-        return "{}{}".format(next, text)
+        return f"{next}{text}"
 
     @classmethod
     def from_text(
diff --git a/lib/dns/rdtypes/ANY/RESINFO.py b/lib/dns/rdtypes/ANY/RESINFO.py
new file mode 100644
index 00000000..76c8ea2a
--- /dev/null
+++ b/lib/dns/rdtypes/ANY/RESINFO.py
@@ -0,0 +1,24 @@
+# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license
+
+# Copyright (C) 2003-2007, 2009-2011 Nominum, Inc.
+#
+# Permission to use, copy, modify, and distribute this software and its
+# documentation for any purpose with or without fee is hereby granted,
+# provided that the above copyright notice and this permission notice
+# appear in all copies.
+#
+# THE SOFTWARE IS PROVIDED "AS IS" AND NOMINUM DISCLAIMS ALL WARRANTIES
+# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL NOMINUM BE LIABLE FOR
+# ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+# WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+# ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
+# OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+import dns.immutable
+import dns.rdtypes.txtbase
+
+
+@dns.immutable.immutable
+class RESINFO(dns.rdtypes.txtbase.TXTBase):
+    """RESINFO record"""
diff --git a/lib/dns/rdtypes/ANY/RP.py b/lib/dns/rdtypes/ANY/RP.py
index 9b74549d..a66cfc50 100644
--- a/lib/dns/rdtypes/ANY/RP.py
+++ b/lib/dns/rdtypes/ANY/RP.py
@@ -37,7 +37,7 @@ class RP(dns.rdata.Rdata):
     def to_text(self, origin=None, relativize=True, **kw):
         mbox = self.mbox.choose_relativity(origin, relativize)
         txt = self.txt.choose_relativity(origin, relativize)
-        return "{} {}".format(str(mbox), str(txt))
+        return f"{str(mbox)} {str(txt)}"
 
     @classmethod
     def from_text(
diff --git a/lib/dns/rdtypes/ANY/TKEY.py b/lib/dns/rdtypes/ANY/TKEY.py
index 5b490b82..75f62249 100644
--- a/lib/dns/rdtypes/ANY/TKEY.py
+++ b/lib/dns/rdtypes/ANY/TKEY.py
@@ -69,7 +69,7 @@ class TKEY(dns.rdata.Rdata):
             dns.rdata._base64ify(self.key, 0),
         )
         if len(self.other) > 0:
-            text += " %s" % (dns.rdata._base64ify(self.other, 0))
+            text += f" {dns.rdata._base64ify(self.other, 0)}"
 
         return text
 
diff --git a/lib/dns/rdtypes/ANY/WALLET.py b/lib/dns/rdtypes/ANY/WALLET.py
new file mode 100644
index 00000000..ff464763
--- /dev/null
+++ b/lib/dns/rdtypes/ANY/WALLET.py
@@ -0,0 +1,9 @@
+# Copyright (C) Dnspython Contributors, see LICENSE for text of ISC license
+
+import dns.immutable
+import dns.rdtypes.txtbase
+
+
+@dns.immutable.immutable
+class WALLET(dns.rdtypes.txtbase.TXTBase):
+    """WALLET record"""
diff --git a/lib/dns/rdtypes/ANY/X25.py b/lib/dns/rdtypes/ANY/X25.py
index 8375611d..2436ddb6 100644
--- a/lib/dns/rdtypes/ANY/X25.py
+++ b/lib/dns/rdtypes/ANY/X25.py
@@ -36,7 +36,7 @@ class X25(dns.rdata.Rdata):
         self.address = self._as_bytes(address, True, 255)
 
     def to_text(self, origin=None, relativize=True, **kw):
-        return '"%s"' % dns.rdata._escapify(self.address)
+        return f'"{dns.rdata._escapify(self.address)}"'
 
     @classmethod
     def from_text(
diff --git a/lib/dns/rdtypes/ANY/__init__.py b/lib/dns/rdtypes/ANY/__init__.py
index 3824a0a0..647b215b 100644
--- a/lib/dns/rdtypes/ANY/__init__.py
+++ b/lib/dns/rdtypes/ANY/__init__.py
@@ -51,6 +51,7 @@ __all__ = [
     "OPENPGPKEY",
     "OPT",
     "PTR",
+    "RESINFO",
     "RP",
     "RRSIG",
     "RT",
@@ -63,6 +64,7 @@ __all__ = [
     "TSIG",
     "TXT",
     "URI",
+    "WALLET",
     "X25",
     "ZONEMD",
 ]
diff --git a/lib/dns/rdtypes/CH/A.py b/lib/dns/rdtypes/CH/A.py
index 583a88ac..832e8d3a 100644
--- a/lib/dns/rdtypes/CH/A.py
+++ b/lib/dns/rdtypes/CH/A.py
@@ -37,7 +37,7 @@ class A(dns.rdata.Rdata):
 
     def to_text(self, origin=None, relativize=True, **kw):
         domain = self.domain.choose_relativity(origin, relativize)
-        return "%s %o" % (domain, self.address)
+        return f"{domain} {self.address:o}"
 
     @classmethod
     def from_text(
diff --git a/lib/dns/rdtypes/IN/NSAP.py b/lib/dns/rdtypes/IN/NSAP.py
index a4854b3f..d55edb73 100644
--- a/lib/dns/rdtypes/IN/NSAP.py
+++ b/lib/dns/rdtypes/IN/NSAP.py
@@ -36,7 +36,7 @@ class NSAP(dns.rdata.Rdata):
         self.address = self._as_bytes(address)
 
     def to_text(self, origin=None, relativize=True, **kw):
-        return "0x%s" % binascii.hexlify(self.address).decode()
+        return f"0x{binascii.hexlify(self.address).decode()}"
 
     @classmethod
     def from_text(
diff --git a/lib/dns/rdtypes/euibase.py b/lib/dns/rdtypes/euibase.py
index 751087b4..a39c166b 100644
--- a/lib/dns/rdtypes/euibase.py
+++ b/lib/dns/rdtypes/euibase.py
@@ -36,7 +36,7 @@ class EUIBase(dns.rdata.Rdata):
         self.eui = self._as_bytes(eui)
         if len(self.eui) != self.byte_len:
             raise dns.exception.FormError(
-                "EUI%s rdata has to have %s bytes" % (self.byte_len * 8, self.byte_len)
+                f"EUI{self.byte_len * 8} rdata has to have {self.byte_len} bytes"
             )
 
     def to_text(self, origin=None, relativize=True, **kw):
@@ -49,16 +49,16 @@ class EUIBase(dns.rdata.Rdata):
         text = tok.get_string()
         if len(text) != cls.text_len:
             raise dns.exception.SyntaxError(
-                "Input text must have %s characters" % cls.text_len
+                f"Input text must have {cls.text_len} characters"
             )
         for i in range(2, cls.byte_len * 3 - 1, 3):
             if text[i] != "-":
-                raise dns.exception.SyntaxError("Dash expected at position %s" % i)
+                raise dns.exception.SyntaxError(f"Dash expected at position {i}")
         text = text.replace("-", "")
         try:
             data = binascii.unhexlify(text.encode())
         except (ValueError, TypeError) as ex:
-            raise dns.exception.SyntaxError("Hex decoding error: %s" % str(ex))
+            raise dns.exception.SyntaxError(f"Hex decoding error: {str(ex)}")
         return cls(rdclass, rdtype, data)
 
     def _to_wire(self, file, compress=None, origin=None, canonicalize=False):
diff --git a/lib/dns/rdtypes/svcbbase.py b/lib/dns/rdtypes/svcbbase.py
index 05652413..a2b15b92 100644
--- a/lib/dns/rdtypes/svcbbase.py
+++ b/lib/dns/rdtypes/svcbbase.py
@@ -35,6 +35,7 @@ class ParamKey(dns.enum.IntEnum):
     ECH = 5
     IPV6HINT = 6
     DOHPATH = 7
+    OHTTP = 8
 
     @classmethod
     def _maximum(cls):
@@ -396,6 +397,36 @@ class ECHParam(Param):
         file.write(self.ech)
 
 
+@dns.immutable.immutable
+class OHTTPParam(Param):
+    # We don't ever expect to instantiate this class, but we need
+    # a from_value() and a from_wire_parser(), so we just return None
+    # from the class methods when things are OK.
+
+    @classmethod
+    def emptiness(cls):
+        return Emptiness.ALWAYS
+
+    @classmethod
+    def from_value(cls, value):
+        if value is None or value == "":
+            return None
+        else:
+            raise ValueError("ohttp with non-empty value")
+
+    def to_text(self):
+        raise NotImplementedError  # pragma: no cover
+
+    @classmethod
+    def from_wire_parser(cls, parser, origin=None):  # pylint: disable=W0613
+        if parser.remaining() != 0:
+            raise dns.exception.FormError
+        return None
+
+    def to_wire(self, file, origin=None):  # pylint: disable=W0613
+        raise NotImplementedError  # pragma: no cover
+
+
 _class_for_key = {
     ParamKey.MANDATORY: MandatoryParam,
     ParamKey.ALPN: ALPNParam,
@@ -404,6 +435,7 @@ _class_for_key = {
     ParamKey.IPV4HINT: IPv4HintParam,
     ParamKey.ECH: ECHParam,
     ParamKey.IPV6HINT: IPv6HintParam,
+    ParamKey.OHTTP: OHTTPParam,
 }
 
 
diff --git a/lib/dns/rdtypes/txtbase.py b/lib/dns/rdtypes/txtbase.py
index 44d6df57..73db6d9e 100644
--- a/lib/dns/rdtypes/txtbase.py
+++ b/lib/dns/rdtypes/txtbase.py
@@ -50,6 +50,8 @@ class TXTBase(dns.rdata.Rdata):
         self.strings: Tuple[bytes] = self._as_tuple(
             strings, lambda x: self._as_bytes(x, True, 255)
         )
+        if len(self.strings) == 0:
+            raise ValueError("the list of strings must not be empty")
 
     def to_text(
         self,
@@ -60,7 +62,7 @@ class TXTBase(dns.rdata.Rdata):
         txt = ""
         prefix = ""
         for s in self.strings:
-            txt += '{}"{}"'.format(prefix, dns.rdata._escapify(s))
+            txt += f'{prefix}"{dns.rdata._escapify(s)}"'
             prefix = " "
         return txt
 
diff --git a/lib/dns/rdtypes/util.py b/lib/dns/rdtypes/util.py
index 54908fdc..653a0bf2 100644
--- a/lib/dns/rdtypes/util.py
+++ b/lib/dns/rdtypes/util.py
@@ -231,7 +231,7 @@ def weighted_processing_order(iterable):
         total = sum(rdata._processing_weight() or _no_weight for rdata in rdatas)
         while len(rdatas) > 1:
             r = random.uniform(0, total)
-            for n, rdata in enumerate(rdatas):
+            for n, rdata in enumerate(rdatas):  # noqa: B007
                 weight = rdata._processing_weight() or _no_weight
                 if weight > r:
                     break
diff --git a/lib/dns/resolver.py b/lib/dns/resolver.py
index f08f824d..3ba76e31 100644
--- a/lib/dns/resolver.py
+++ b/lib/dns/resolver.py
@@ -36,6 +36,7 @@ import dns.ipv4
 import dns.ipv6
 import dns.message
 import dns.name
+import dns.rdata
 import dns.nameserver
 import dns.query
 import dns.rcode
@@ -45,7 +46,7 @@ import dns.rdtypes.svcbbase
 import dns.reversename
 import dns.tsig
 
-if sys.platform == "win32":
+if sys.platform == "win32":  # pragma: no cover
     import dns.win32util
 
 
@@ -83,7 +84,7 @@ class NXDOMAIN(dns.exception.DNSException):
         else:
             msg = "The DNS query name does not exist"
         qnames = ", ".join(map(str, qnames))
-        return "{}: {}".format(msg, qnames)
+        return f"{msg}: {qnames}"
 
     @property
     def canonical_name(self):
@@ -96,7 +97,7 @@ class NXDOMAIN(dns.exception.DNSException):
                 cname = response.canonical_name()
                 if cname != qname:
                     return cname
-            except Exception:
+            except Exception:  # pragma: no cover
                 # We can just eat this exception as it means there was
                 # something wrong with the response.
                 pass
@@ -154,7 +155,7 @@ def _errors_to_text(errors: List[ErrorTuple]) -> List[str]:
     """Turn a resolution errors trace into a list of text."""
     texts = []
     for err in errors:
-        texts.append("Server {} answered {}".format(err[0], err[3]))
+        texts.append(f"Server {err[0]} answered {err[3]}")
     return texts
 
 
@@ -162,7 +163,7 @@ class LifetimeTimeout(dns.exception.Timeout):
     """The resolution lifetime expired."""
 
     msg = "The resolution lifetime expired."
-    fmt = "%s after {timeout:.3f} seconds: {errors}" % msg[:-1]
+    fmt = f"{msg[:-1]} after {{timeout:.3f}} seconds: {{errors}}"
     supp_kwargs = {"timeout", "errors"}
 
     # We do this as otherwise mypy complains about unexpected keyword argument
@@ -211,7 +212,7 @@ class NoNameservers(dns.exception.DNSException):
     """
 
     msg = "All nameservers failed to answer the query."
-    fmt = "%s {query}: {errors}" % msg[:-1]
+    fmt = f"{msg[:-1]} {{query}}: {{errors}}"
     supp_kwargs = {"request", "errors"}
 
     # We do this as otherwise mypy complains about unexpected keyword argument
@@ -297,7 +298,7 @@ class Answer:
     def __len__(self) -> int:
         return self.rrset and len(self.rrset) or 0
 
-    def __iter__(self):
+    def __iter__(self) -> Iterator[dns.rdata.Rdata]:
         return self.rrset and iter(self.rrset) or iter(tuple())
 
     def __getitem__(self, i):
@@ -334,7 +335,7 @@ class HostAnswers(Answers):
             answers[dns.rdatatype.A] = v4
         return answers
 
-    # Returns pairs of (address, family) from this result, potentiallys
+    # Returns pairs of (address, family) from this result, potentially
     # filtering by address family.
     def addresses_and_families(
         self, family: int = socket.AF_UNSPEC
@@ -347,7 +348,7 @@ class HostAnswers(Answers):
             answer = self.get(dns.rdatatype.AAAA)
         elif family == socket.AF_INET:
             answer = self.get(dns.rdatatype.A)
-        else:
+        else:  # pragma: no cover
             raise NotImplementedError(f"unknown address family {family}")
         if answer:
             for rdata in answer:
@@ -938,7 +939,7 @@ class BaseResolver:
 
         self.reset()
         if configure:
-            if sys.platform == "win32":
+            if sys.platform == "win32":  # pragma: no cover
                 self.read_registry()
             elif filename:
                 self.read_resolv_conf(filename)
@@ -947,7 +948,7 @@ class BaseResolver:
         """Reset all resolver configuration to the defaults."""
 
         self.domain = dns.name.Name(dns.name.from_text(socket.gethostname())[1:])
-        if len(self.domain) == 0:
+        if len(self.domain) == 0:  # pragma: no cover
             self.domain = dns.name.root
         self._nameservers = []
         self.nameserver_ports = {}
@@ -1040,7 +1041,7 @@ class BaseResolver:
         # setter logic, with additonal checking and enrichment.
         self.nameservers = nameservers
 
-    def read_registry(self) -> None:
+    def read_registry(self) -> None:  # pragma: no cover
         """Extract resolver configuration from the Windows registry."""
         try:
             info = dns.win32util.get_dns_info()  # type: ignore
@@ -1205,9 +1206,7 @@ class BaseResolver:
                 enriched_nameservers.append(enriched_nameserver)
         else:
             raise ValueError(
-                "nameservers must be a list or tuple (not a {})".format(
-                    type(nameservers)
-                )
+                f"nameservers must be a list or tuple (not a {type(nameservers)})"
             )
         return enriched_nameservers
 
@@ -1431,7 +1430,7 @@ class Resolver(BaseResolver):
         elif family == socket.AF_INET6:
             v6 = self.resolve(name, dns.rdatatype.AAAA, **modified_kwargs)
             return HostAnswers.make(v6=v6)
-        elif family != socket.AF_UNSPEC:
+        elif family != socket.AF_UNSPEC:  # pragma: no cover
             raise NotImplementedError(f"unknown address family {family}")
 
         raise_on_no_answer = modified_kwargs.pop("raise_on_no_answer", True)
@@ -1515,7 +1514,7 @@ class Resolver(BaseResolver):
             nameservers = dns._ddr._get_nameservers_sync(answer, timeout)
             if len(nameservers) > 0:
                 self.nameservers = nameservers
-        except Exception:
+        except Exception:  # pragma: no cover
             pass
 
 
@@ -1640,7 +1639,7 @@ def canonical_name(name: Union[dns.name.Name, str]) -> dns.name.Name:
     return get_default_resolver().canonical_name(name)
 
 
-def try_ddr(lifetime: float = 5.0) -> None:
+def try_ddr(lifetime: float = 5.0) -> None:  # pragma: no cover
     """Try to update the default resolver's nameservers using Discovery of Designated
     Resolvers (DDR).  If successful, the resolver will subsequently use
     DNS-over-HTTPS or DNS-over-TLS for future queries.
@@ -1926,7 +1925,7 @@ def _getnameinfo(sockaddr, flags=0):
         family = socket.AF_INET
     tuples = _getaddrinfo(host, port, family, socket.SOCK_STREAM, socket.SOL_TCP, 0)
     if len(tuples) > 1:
-        raise socket.error("sockaddr resolved to multiple addresses")
+        raise OSError("sockaddr resolved to multiple addresses")
     addr = tuples[0][4][0]
     if flags & socket.NI_DGRAM:
         pname = "udp"
@@ -1961,7 +1960,7 @@ def _getfqdn(name=None):
         (name, _, _) = _gethostbyaddr(name)
         # Python's version checks aliases too, but our gethostbyname
         # ignores them, so we do so here as well.
-    except Exception:
+    except Exception:  # pragma: no cover
         pass
     return name
 
diff --git a/lib/dns/set.py b/lib/dns/set.py
index f0fb0d50..ae8f0dd5 100644
--- a/lib/dns/set.py
+++ b/lib/dns/set.py
@@ -21,10 +21,11 @@ import itertools
 class Set:
     """A simple set class.
 
-    This class was originally used to deal with sets being missing in
-    ancient versions of python, but dnspython will continue to use it
-    as these sets are based on lists and are thus indexable, and this
-    ability is widely used in dnspython applications.
+    This class was originally used to deal with python not having a set class, and
+    originally the class used lists in its implementation.  The ordered and indexable
+    nature of RRsets and Rdatasets is unfortunately widely used in dnspython
+    applications, so for backwards compatibility sets continue to be a custom class, now
+    based on an ordered dictionary.
     """
 
     __slots__ = ["items"]
@@ -43,7 +44,7 @@ class Set:
                 self.add(item)  # lgtm[py/init-calls-subclass]
 
     def __repr__(self):
-        return "dns.set.Set(%s)" % repr(list(self.items.keys()))
+        return f"dns.set.Set({repr(list(self.items.keys()))})"  # pragma: no cover
 
     def add(self, item):
         """Add an item to the set."""
diff --git a/lib/dns/tokenizer.py b/lib/dns/tokenizer.py
index 454cac4a..ab205bc3 100644
--- a/lib/dns/tokenizer.py
+++ b/lib/dns/tokenizer.py
@@ -528,7 +528,7 @@ class Tokenizer:
         if value < 0 or value > 65535:
             if base == 8:
                 raise dns.exception.SyntaxError(
-                    "%o is not an octal unsigned 16-bit integer" % value
+                    f"{value:o} is not an octal unsigned 16-bit integer"
                 )
             else:
                 raise dns.exception.SyntaxError(
diff --git a/lib/dns/transaction.py b/lib/dns/transaction.py
index 84e54f7d..aa2e1160 100644
--- a/lib/dns/transaction.py
+++ b/lib/dns/transaction.py
@@ -486,7 +486,7 @@ class Transaction:
                         if exact:
                             raise DeleteNotExact(f"{method}: missing rdataset")
                     else:
-                        self._delete_rdataset(name, rdtype, covers)
+                        self._checked_delete_rdataset(name, rdtype, covers)
                     return
                 else:
                     rdataset = self._rdataset_from_args(method, True, args)
@@ -529,8 +529,6 @@ class Transaction:
 
     def _end(self, commit):
         self._check_ended()
-        if self._ended:
-            raise AlreadyEnded
         try:
             self._end_transaction(commit)
         finally:
diff --git a/lib/dns/ttl.py b/lib/dns/ttl.py
index 264b0338..b9a99fe3 100644
--- a/lib/dns/ttl.py
+++ b/lib/dns/ttl.py
@@ -73,7 +73,7 @@ def from_text(text: str) -> int:
                 elif c == "s":
                     total += current
                 else:
-                    raise BadTTL("unknown unit '%s'" % c)
+                    raise BadTTL(f"unknown unit '{c}'")
                 current = 0
                 need_digit = True
         if not current == 0:
diff --git a/lib/dns/version.py b/lib/dns/version.py
index 251f2583..9ed2ce19 100644
--- a/lib/dns/version.py
+++ b/lib/dns/version.py
@@ -20,9 +20,9 @@
 #: MAJOR
 MAJOR = 2
 #: MINOR
-MINOR = 6
+MINOR = 7
 #: MICRO
-MICRO = 1
+MICRO = 0
 #: RELEASELEVEL
 RELEASELEVEL = 0x0F
 #: SERIAL
diff --git a/lib/dns/win32util.py b/lib/dns/win32util.py
index aaa7e93e..9ed3f11b 100644
--- a/lib/dns/win32util.py
+++ b/lib/dns/win32util.py
@@ -13,8 +13,8 @@ if sys.platform == "win32":
 
     # Keep pylint quiet on non-windows.
     try:
-        WindowsError is None  # pylint: disable=used-before-assignment
-    except KeyError:
+        _ = WindowsError  # pylint: disable=used-before-assignment
+    except NameError:
         WindowsError = Exception
 
     if dns._features.have("wmi"):
@@ -44,6 +44,7 @@ if sys.platform == "win32":
     if _have_wmi:
 
         class _WMIGetter(threading.Thread):
+            # pylint: disable=possibly-used-before-assignment
             def __init__(self):
                 super().__init__()
                 self.info = DnsInfo()
@@ -82,32 +83,21 @@ if sys.platform == "win32":
         def __init__(self):
             self.info = DnsInfo()
 
-        def _determine_split_char(self, entry):
-            #
-            # The windows registry irritatingly changes the list element
-            # delimiter in between ' ' and ',' (and vice-versa) in various
-            # versions of windows.
-            #
-            if entry.find(" ") >= 0:
-                split_char = " "
-            elif entry.find(",") >= 0:
-                split_char = ","
-            else:
-                # probably a singleton; treat as a space-separated list.
-                split_char = " "
-            return split_char
+        def _split(self, text):
+            # The windows registry has used both " " and "," as a delimiter, and while
+            # it is currently using "," in Windows 10 and later, updates can seemingly
+            # leave a space in too, e.g. "a, b".  So we just convert all commas to
+            # spaces, and use split() in its default configuration, which splits on
+            # all whitespace and ignores empty strings.
+            return text.replace(",", " ").split()
 
         def _config_nameservers(self, nameservers):
-            split_char = self._determine_split_char(nameservers)
-            ns_list = nameservers.split(split_char)
-            for ns in ns_list:
+            for ns in self._split(nameservers):
                 if ns not in self.info.nameservers:
                     self.info.nameservers.append(ns)
 
         def _config_search(self, search):
-            split_char = self._determine_split_char(search)
-            search_list = search.split(split_char)
-            for s in search_list:
+            for s in self._split(search):
                 s = _config_domain(s)
                 if s not in self.info.search:
                     self.info.search.append(s)
@@ -164,7 +154,7 @@ if sys.platform == "win32":
                     lm,
                     r"SYSTEM\CurrentControlSet\Control\Network"
                     r"\{4D36E972-E325-11CE-BFC1-08002BE10318}"
-                    r"\%s\Connection" % guid,
+                    rf"\{guid}\Connection",
                 )
 
                 try:
@@ -177,7 +167,7 @@ if sys.platform == "win32":
                         raise ValueError  # pragma: no cover
 
                     device_key = winreg.OpenKey(
-                        lm, r"SYSTEM\CurrentControlSet\Enum\%s" % pnp_id
+                        lm, rf"SYSTEM\CurrentControlSet\Enum\{pnp_id}"
                     )
 
                     try:
@@ -232,7 +222,7 @@ if sys.platform == "win32":
                                 self._config_fromkey(key, False)
                             finally:
                                 key.Close()
-                        except EnvironmentError:
+                        except OSError:
                             break
                 finally:
                     interfaces.Close()
diff --git a/lib/dns/xfr.py b/lib/dns/xfr.py
index dd247d33..520aa32d 100644
--- a/lib/dns/xfr.py
+++ b/lib/dns/xfr.py
@@ -33,7 +33,7 @@ class TransferError(dns.exception.DNSException):
     """A zone transfer response got a non-zero rcode."""
 
     def __init__(self, rcode):
-        message = "Zone transfer error: %s" % dns.rcode.to_text(rcode)
+        message = f"Zone transfer error: {dns.rcode.to_text(rcode)}"
         super().__init__(message)
         self.rcode = rcode
 
diff --git a/lib/dns/zonefile.py b/lib/dns/zonefile.py
index af064e73..d74510b2 100644
--- a/lib/dns/zonefile.py
+++ b/lib/dns/zonefile.py
@@ -230,7 +230,7 @@ class Reader:
             try:
                 rdtype = dns.rdatatype.from_text(token.value)
             except Exception:
-                raise dns.exception.SyntaxError("unknown rdatatype '%s'" % token.value)
+                raise dns.exception.SyntaxError(f"unknown rdatatype '{token.value}'")
 
         try:
             rd = dns.rdata.from_text(
@@ -251,9 +251,7 @@ class Reader:
             # We convert them to syntax errors so that we can emit
             # helpful filename:line info.
             (ty, va) = sys.exc_info()[:2]
-            raise dns.exception.SyntaxError(
-                "caught exception {}: {}".format(str(ty), str(va))
-            )
+            raise dns.exception.SyntaxError(f"caught exception {str(ty)}: {str(va)}")
 
         if not self.default_ttl_known and rdtype == dns.rdatatype.SOA:
             # The pre-RFC2308 and pre-BIND9 behavior inherits the zone default
@@ -281,41 +279,41 @@ class Reader:
         # Sometimes there are modifiers in the hostname. These come after
         # the dollar sign. They are in the form: ${offset[,width[,base]]}.
         # Make names
+        mod = ""
+        sign = "+"
+        offset = "0"
+        width = "0"
+        base = "d"
         g1 = is_generate1.match(side)
         if g1:
             mod, sign, offset, width, base = g1.groups()
             if sign == "":
                 sign = "+"
-        g2 = is_generate2.match(side)
-        if g2:
-            mod, sign, offset = g2.groups()
-            if sign == "":
-                sign = "+"
-            width = 0
-            base = "d"
-        g3 = is_generate3.match(side)
-        if g3:
-            mod, sign, offset, width = g3.groups()
-            if sign == "":
-                sign = "+"
-            base = "d"
+        else:
+            g2 = is_generate2.match(side)
+            if g2:
+                mod, sign, offset = g2.groups()
+                if sign == "":
+                    sign = "+"
+                width = "0"
+                base = "d"
+            else:
+                g3 = is_generate3.match(side)
+                if g3:
+                    mod, sign, offset, width = g3.groups()
+                    if sign == "":
+                        sign = "+"
+                    base = "d"
 
-        if not (g1 or g2 or g3):
-            mod = ""
-            sign = "+"
-            offset = 0
-            width = 0
-            base = "d"
-
-        offset = int(offset)
-        width = int(width)
+        ioffset = int(offset)
+        iwidth = int(width)
 
         if sign not in ["+", "-"]:
-            raise dns.exception.SyntaxError("invalid offset sign %s" % sign)
+            raise dns.exception.SyntaxError(f"invalid offset sign {sign}")
         if base not in ["d", "o", "x", "X", "n", "N"]:
-            raise dns.exception.SyntaxError("invalid type %s" % base)
+            raise dns.exception.SyntaxError(f"invalid type {base}")
 
-        return mod, sign, offset, width, base
+        return mod, sign, ioffset, iwidth, base
 
     def _generate_line(self):
         # range lhs [ttl] [class] type rhs [ comment ]
@@ -377,7 +375,7 @@ class Reader:
             if not token.is_identifier():
                 raise dns.exception.SyntaxError
         except Exception:
-            raise dns.exception.SyntaxError("unknown rdatatype '%s'" % token.value)
+            raise dns.exception.SyntaxError(f"unknown rdatatype '{token.value}'")
 
         # rhs (required)
         rhs = token.value
@@ -412,8 +410,8 @@ class Reader:
             lzfindex = _format_index(lindex, lbase, lwidth)
             rzfindex = _format_index(rindex, rbase, rwidth)
 
-            name = lhs.replace("$%s" % (lmod), lzfindex)
-            rdata = rhs.replace("$%s" % (rmod), rzfindex)
+            name = lhs.replace(f"${lmod}", lzfindex)
+            rdata = rhs.replace(f"${rmod}", rzfindex)
 
             self.last_name = dns.name.from_text(
                 name, self.current_origin, self.tok.idna_codec
@@ -445,7 +443,7 @@ class Reader:
                 # helpful filename:line info.
                 (ty, va) = sys.exc_info()[:2]
                 raise dns.exception.SyntaxError(
-                    "caught exception %s: %s" % (str(ty), str(va))
+                    f"caught exception {str(ty)}: {str(va)}"
                 )
 
             self.txn.add(name, ttl, rd)
@@ -528,7 +526,7 @@ class Reader:
                                 self.default_ttl_known,
                             )
                         )
-                        self.current_file = open(filename, "r")
+                        self.current_file = open(filename)
                         self.tok = dns.tokenizer.Tokenizer(self.current_file, filename)
                         self.current_origin = new_origin
                     elif c == "$GENERATE":
diff --git a/requirements.txt b/requirements.txt
index cfd8b7e5..9413a3f6 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -7,7 +7,7 @@ cheroot==10.0.1
 cherrypy==18.10.0
 cloudinary==1.41.0
 distro==1.9.0
-dnspython==2.6.1
+dnspython==2.7.0
 facebook-sdk==3.1.0
 future==1.0.0
 ga4mp==2.0.4

From dd9a35df51234dbb19ff7f55d6ff788f4242171a Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 19 Nov 2024 10:01:27 -0800
Subject: [PATCH 690/743] Bump pyjwt from 2.9.0 to 2.10.0 (#2441)

* Bump pyjwt from 2.9.0 to 2.10.0

Bumps [pyjwt](https://github.com/jpadilla/pyjwt) from 2.9.0 to 2.10.0.
- [Release notes](https://github.com/jpadilla/pyjwt/releases)
- [Changelog](https://github.com/jpadilla/pyjwt/blob/master/CHANGELOG.rst)
- [Commits](https://github.com/jpadilla/pyjwt/compare/2.9.0...2.10.0)

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

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

* Update pyjwt==2.10.0

---------

Signed-off-by: dependabot[bot] <support@github.com>
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/jwt/__init__.py    |  5 ++-
 lib/jwt/algorithms.py  | 47 ++++++++++++++-------
 lib/jwt/api_jws.py     | 27 ++++++++----
 lib/jwt/api_jwt.py     | 94 +++++++++++++++++++++++++++++++++---------
 lib/jwt/exceptions.py  |  8 ++++
 lib/jwt/help.py        |  5 ++-
 lib/jwt/jwks_client.py |  6 ++-
 lib/jwt/utils.py       | 17 ++++----
 requirements.txt       |  2 +-
 9 files changed, 152 insertions(+), 59 deletions(-)

diff --git a/lib/jwt/__init__.py b/lib/jwt/__init__.py
index b7a258d7..9d4b6744 100644
--- a/lib/jwt/__init__.py
+++ b/lib/jwt/__init__.py
@@ -6,7 +6,7 @@ from .api_jws import (
     register_algorithm,
     unregister_algorithm,
 )
-from .api_jwt import PyJWT, decode, encode
+from .api_jwt import PyJWT, decode, decode_complete, encode
 from .exceptions import (
     DecodeError,
     ExpiredSignatureError,
@@ -27,7 +27,7 @@ from .exceptions import (
 )
 from .jwks_client import PyJWKClient
 
-__version__ = "2.9.0"
+__version__ = "2.10.0"
 
 __title__ = "PyJWT"
 __description__ = "JSON Web Token implementation in Python"
@@ -49,6 +49,7 @@ __all__ = [
     "PyJWK",
     "PyJWKSet",
     "decode",
+    "decode_complete",
     "encode",
     "get_unverified_header",
     "register_algorithm",
diff --git a/lib/jwt/algorithms.py b/lib/jwt/algorithms.py
index 9be50b20..ccb1500f 100644
--- a/lib/jwt/algorithms.py
+++ b/lib/jwt/algorithms.py
@@ -297,7 +297,7 @@ class HMACAlgorithm(Algorithm):
             else:
                 raise ValueError
         except ValueError:
-            raise InvalidKeyError("Key is not valid JSON")
+            raise InvalidKeyError("Key is not valid JSON") from None
 
         if obj.get("kty") != "oct":
             raise InvalidKeyError("Not an HMAC key")
@@ -346,7 +346,9 @@ if has_crypto:
                 try:
                     return cast(RSAPublicKey, load_pem_public_key(key_bytes))
                 except (ValueError, UnsupportedAlgorithm):
-                    raise InvalidKeyError("Could not parse the provided public key.")
+                    raise InvalidKeyError(
+                        "Could not parse the provided public key."
+                    ) from None
 
         @overload
         @staticmethod
@@ -409,10 +411,10 @@ if has_crypto:
                 else:
                     raise ValueError
             except ValueError:
-                raise InvalidKeyError("Key is not valid JSON")
+                raise InvalidKeyError("Key is not valid JSON") from None
 
             if obj.get("kty") != "RSA":
-                raise InvalidKeyError("Not an RSA key")
+                raise InvalidKeyError("Not an RSA key") from None
 
             if "d" in obj and "e" in obj and "n" in obj:
                 # Private key
@@ -428,7 +430,7 @@ if has_crypto:
                 if any_props_found and not all(props_found):
                     raise InvalidKeyError(
                         "RSA key must include all parameters if any are present besides d"
-                    )
+                    ) from None
 
                 public_numbers = RSAPublicNumbers(
                     from_base64url_uint(obj["e"]),
@@ -520,7 +522,7 @@ if has_crypto:
             ):
                 raise InvalidKeyError(
                     "Expecting a EllipticCurvePrivateKey/EllipticCurvePublicKey. Wrong key provided for ECDSA algorithms"
-                )
+                ) from None
 
             return crypto_key
 
@@ -581,13 +583,20 @@ if has_crypto:
             obj: dict[str, Any] = {
                 "kty": "EC",
                 "crv": crv,
-                "x": to_base64url_uint(public_numbers.x).decode(),
-                "y": to_base64url_uint(public_numbers.y).decode(),
+                "x": to_base64url_uint(
+                    public_numbers.x,
+                    bit_length=key_obj.curve.key_size,
+                ).decode(),
+                "y": to_base64url_uint(
+                    public_numbers.y,
+                    bit_length=key_obj.curve.key_size,
+                ).decode(),
             }
 
             if isinstance(key_obj, EllipticCurvePrivateKey):
                 obj["d"] = to_base64url_uint(
-                    key_obj.private_numbers().private_value
+                    key_obj.private_numbers().private_value,
+                    bit_length=key_obj.curve.key_size,
                 ).decode()
 
             if as_dict:
@@ -605,13 +614,13 @@ if has_crypto:
                 else:
                     raise ValueError
             except ValueError:
-                raise InvalidKeyError("Key is not valid JSON")
+                raise InvalidKeyError("Key is not valid JSON") from None
 
             if obj.get("kty") != "EC":
-                raise InvalidKeyError("Not an Elliptic curve key")
+                raise InvalidKeyError("Not an Elliptic curve key") from None
 
             if "x" not in obj or "y" not in obj:
-                raise InvalidKeyError("Not an Elliptic curve key")
+                raise InvalidKeyError("Not an Elliptic curve key") from None
 
             x = base64url_decode(obj.get("x"))
             y = base64url_decode(obj.get("y"))
@@ -623,17 +632,23 @@ if has_crypto:
                 if len(x) == len(y) == 32:
                     curve_obj = SECP256R1()
                 else:
-                    raise InvalidKeyError("Coords should be 32 bytes for curve P-256")
+                    raise InvalidKeyError(
+                        "Coords should be 32 bytes for curve P-256"
+                    ) from None
             elif curve == "P-384":
                 if len(x) == len(y) == 48:
                     curve_obj = SECP384R1()
                 else:
-                    raise InvalidKeyError("Coords should be 48 bytes for curve P-384")
+                    raise InvalidKeyError(
+                        "Coords should be 48 bytes for curve P-384"
+                    ) from None
             elif curve == "P-521":
                 if len(x) == len(y) == 66:
                     curve_obj = SECP521R1()
                 else:
-                    raise InvalidKeyError("Coords should be 66 bytes for curve P-521")
+                    raise InvalidKeyError(
+                        "Coords should be 66 bytes for curve P-521"
+                    ) from None
             elif curve == "secp256k1":
                 if len(x) == len(y) == 32:
                     curve_obj = SECP256K1()
@@ -834,7 +849,7 @@ if has_crypto:
                 else:
                     raise ValueError
             except ValueError:
-                raise InvalidKeyError("Key is not valid JSON")
+                raise InvalidKeyError("Key is not valid JSON") from None
 
             if obj.get("kty") != "OKP":
                 raise InvalidKeyError("Not an Octet Key Pair")
diff --git a/lib/jwt/api_jws.py b/lib/jwt/api_jws.py
index 5822ebf6..654ee0b7 100644
--- a/lib/jwt/api_jws.py
+++ b/lib/jwt/api_jws.py
@@ -3,6 +3,7 @@ from __future__ import annotations
 import binascii
 import json
 import warnings
+from collections.abc import Sequence
 from typing import TYPE_CHECKING, Any
 
 from .algorithms import (
@@ -30,7 +31,7 @@ class PyJWS:
 
     def __init__(
         self,
-        algorithms: list[str] | None = None,
+        algorithms: Sequence[str] | None = None,
         options: dict[str, Any] | None = None,
     ) -> None:
         self._algorithms = get_default_algorithms()
@@ -104,8 +105,8 @@ class PyJWS:
     def encode(
         self,
         payload: bytes,
-        key: AllowedPrivateKeys | str | bytes,
-        algorithm: str | None = "HS256",
+        key: AllowedPrivateKeys | PyJWK | str | bytes,
+        algorithm: str | None = None,
         headers: dict[str, Any] | None = None,
         json_encoder: type[json.JSONEncoder] | None = None,
         is_payload_detached: bool = False,
@@ -114,7 +115,13 @@ class PyJWS:
         segments = []
 
         # declare a new var to narrow the type for type checkers
-        algorithm_: str = algorithm if algorithm is not None else "none"
+        if algorithm is None:
+            if isinstance(key, PyJWK):
+                algorithm_ = key.algorithm_name
+            else:
+                algorithm_ = "HS256"
+        else:
+            algorithm_ = algorithm
 
         # Prefer headers values if present to function parameters.
         if headers:
@@ -158,6 +165,8 @@ class PyJWS:
         signing_input = b".".join(segments)
 
         alg_obj = self.get_algorithm_by_name(algorithm_)
+        if isinstance(key, PyJWK):
+            key = key.key
         key = alg_obj.prepare_key(key)
         signature = alg_obj.sign(signing_input, key)
 
@@ -174,7 +183,7 @@ class PyJWS:
         self,
         jwt: str | bytes,
         key: AllowedPublicKeys | PyJWK | str | bytes = "",
-        algorithms: list[str] | None = None,
+        algorithms: Sequence[str] | None = None,
         options: dict[str, Any] | None = None,
         detached_payload: bytes | None = None,
         **kwargs,
@@ -185,6 +194,7 @@ class PyJWS:
                 "and will be removed in pyjwt version 3. "
                 f"Unsupported kwargs: {tuple(kwargs.keys())}",
                 RemovedInPyjwt3Warning,
+                stacklevel=2,
             )
         if options is None:
             options = {}
@@ -219,7 +229,7 @@ class PyJWS:
         self,
         jwt: str | bytes,
         key: AllowedPublicKeys | PyJWK | str | bytes = "",
-        algorithms: list[str] | None = None,
+        algorithms: Sequence[str] | None = None,
         options: dict[str, Any] | None = None,
         detached_payload: bytes | None = None,
         **kwargs,
@@ -230,6 +240,7 @@ class PyJWS:
                 "and will be removed in pyjwt version 3. "
                 f"Unsupported kwargs: {tuple(kwargs.keys())}",
                 RemovedInPyjwt3Warning,
+                stacklevel=2,
             )
         decoded = self.decode_complete(
             jwt, key, algorithms, options, detached_payload=detached_payload
@@ -291,14 +302,14 @@ class PyJWS:
         header: dict[str, Any],
         signature: bytes,
         key: AllowedPublicKeys | PyJWK | str | bytes = "",
-        algorithms: list[str] | None = None,
+        algorithms: Sequence[str] | None = None,
     ) -> None:
         if algorithms is None and isinstance(key, PyJWK):
             algorithms = [key.algorithm_name]
         try:
             alg = header["alg"]
         except KeyError:
-            raise InvalidAlgorithmError("Algorithm not specified")
+            raise InvalidAlgorithmError("Algorithm not specified") from None
 
         if not alg or (algorithms is not None and alg not in algorithms):
             raise InvalidAlgorithmError("The specified alg value is not allowed")
diff --git a/lib/jwt/api_jwt.py b/lib/jwt/api_jwt.py
index 7a07c336..fa4d5e6f 100644
--- a/lib/jwt/api_jwt.py
+++ b/lib/jwt/api_jwt.py
@@ -3,9 +3,9 @@ from __future__ import annotations
 import json
 import warnings
 from calendar import timegm
-from collections.abc import Iterable
+from collections.abc import Iterable, Sequence
 from datetime import datetime, timedelta, timezone
-from typing import TYPE_CHECKING, Any, List
+from typing import TYPE_CHECKING, Any
 
 from . import api_jws
 from .exceptions import (
@@ -15,6 +15,8 @@ from .exceptions import (
     InvalidAudienceError,
     InvalidIssuedAtError,
     InvalidIssuerError,
+    InvalidJTIError,
+    InvalidSubjectError,
     MissingRequiredClaimError,
 )
 from .warnings import RemovedInPyjwt3Warning
@@ -39,14 +41,16 @@ class PyJWT:
             "verify_iat": True,
             "verify_aud": True,
             "verify_iss": True,
+            "verify_sub": True,
+            "verify_jti": True,
             "require": [],
         }
 
     def encode(
         self,
         payload: dict[str, Any],
-        key: AllowedPrivateKeys | str | bytes,
-        algorithm: str | None = "HS256",
+        key: AllowedPrivateKeys | PyJWK | str | bytes,
+        algorithm: str | None = None,
         headers: dict[str, Any] | None = None,
         json_encoder: type[json.JSONEncoder] | None = None,
         sort_headers: bool = True,
@@ -102,7 +106,7 @@ class PyJWT:
         self,
         jwt: str | bytes,
         key: AllowedPublicKeys | PyJWK | str | bytes = "",
-        algorithms: list[str] | None = None,
+        algorithms: Sequence[str] | None = None,
         options: dict[str, Any] | None = None,
         # deprecated arg, remove in pyjwt3
         verify: bool | None = None,
@@ -111,7 +115,8 @@ class PyJWT:
         # passthrough arguments to _validate_claims
         # consider putting in options
         audience: str | Iterable[str] | None = None,
-        issuer: str | List[str] | None = None,
+        issuer: str | Sequence[str] | None = None,
+        subject: str | None = None,
         leeway: float | timedelta = 0,
         # kwargs
         **kwargs: Any,
@@ -122,6 +127,7 @@ class PyJWT:
                 "and will be removed in pyjwt version 3. "
                 f"Unsupported kwargs: {tuple(kwargs.keys())}",
                 RemovedInPyjwt3Warning,
+                stacklevel=2,
             )
         options = dict(options or {})  # shallow-copy or initialize an empty dict
         options.setdefault("verify_signature", True)
@@ -135,6 +141,7 @@ class PyJWT:
                 "The equivalent is setting `verify_signature` to False in the `options` dictionary. "
                 "This invocation has a mismatch between the kwarg and the option entry.",
                 category=DeprecationWarning,
+                stacklevel=2,
             )
 
         if not options["verify_signature"]:
@@ -143,11 +150,8 @@ class PyJWT:
             options.setdefault("verify_iat", False)
             options.setdefault("verify_aud", False)
             options.setdefault("verify_iss", False)
-
-        if options["verify_signature"] and not algorithms:
-            raise DecodeError(
-                'It is required that you pass in a value for the "algorithms" argument when calling decode().'
-            )
+            options.setdefault("verify_sub", False)
+            options.setdefault("verify_jti", False)
 
         decoded = api_jws.decode_complete(
             jwt,
@@ -161,7 +165,12 @@ class PyJWT:
 
         merged_options = {**self.options, **options}
         self._validate_claims(
-            payload, merged_options, audience=audience, issuer=issuer, leeway=leeway
+            payload,
+            merged_options,
+            audience=audience,
+            issuer=issuer,
+            leeway=leeway,
+            subject=subject,
         )
 
         decoded["payload"] = payload
@@ -178,7 +187,7 @@ class PyJWT:
         try:
             payload = json.loads(decoded["payload"])
         except ValueError as e:
-            raise DecodeError(f"Invalid payload string: {e}")
+            raise DecodeError(f"Invalid payload string: {e}") from e
         if not isinstance(payload, dict):
             raise DecodeError("Invalid payload string: must be a json object")
         return payload
@@ -187,7 +196,7 @@ class PyJWT:
         self,
         jwt: str | bytes,
         key: AllowedPublicKeys | PyJWK | str | bytes = "",
-        algorithms: list[str] | None = None,
+        algorithms: Sequence[str] | None = None,
         options: dict[str, Any] | None = None,
         # deprecated arg, remove in pyjwt3
         verify: bool | None = None,
@@ -196,7 +205,8 @@ class PyJWT:
         # passthrough arguments to _validate_claims
         # consider putting in options
         audience: str | Iterable[str] | None = None,
-        issuer: str | List[str] | None = None,
+        subject: str | None = None,
+        issuer: str | Sequence[str] | None = None,
         leeway: float | timedelta = 0,
         # kwargs
         **kwargs: Any,
@@ -207,6 +217,7 @@ class PyJWT:
                 "and will be removed in pyjwt version 3. "
                 f"Unsupported kwargs: {tuple(kwargs.keys())}",
                 RemovedInPyjwt3Warning,
+                stacklevel=2,
             )
         decoded = self.decode_complete(
             jwt,
@@ -216,6 +227,7 @@ class PyJWT:
             verify=verify,
             detached_payload=detached_payload,
             audience=audience,
+            subject=subject,
             issuer=issuer,
             leeway=leeway,
         )
@@ -227,6 +239,7 @@ class PyJWT:
         options: dict[str, Any],
         audience=None,
         issuer=None,
+        subject: str | None = None,
         leeway: float | timedelta = 0,
     ) -> None:
         if isinstance(leeway, timedelta):
@@ -256,6 +269,12 @@ class PyJWT:
                 payload, audience, strict=options.get("strict_aud", False)
             )
 
+        if options["verify_sub"]:
+            self._validate_sub(payload, subject)
+
+        if options["verify_jti"]:
+            self._validate_jti(payload)
+
     def _validate_required_claims(
         self,
         payload: dict[str, Any],
@@ -265,6 +284,39 @@ class PyJWT:
             if payload.get(claim) is None:
                 raise MissingRequiredClaimError(claim)
 
+    def _validate_sub(self, payload: dict[str, Any], subject=None) -> None:
+        """
+        Checks whether "sub" if in the payload is valid ot not.
+        This is an Optional claim
+
+        :param payload(dict): The payload which needs to be validated
+        :param subject(str): The subject of the token
+        """
+
+        if "sub" not in payload:
+            return
+
+        if not isinstance(payload["sub"], str):
+            raise InvalidSubjectError("Subject must be a string")
+
+        if subject is not None:
+            if payload.get("sub") != subject:
+                raise InvalidSubjectError("Invalid subject")
+
+    def _validate_jti(self, payload: dict[str, Any]) -> None:
+        """
+        Checks whether "jti" if in the payload is valid ot not
+        This is an Optional claim
+
+        :param payload(dict): The payload which needs to be validated
+        """
+
+        if "jti" not in payload:
+            return
+
+        if not isinstance(payload.get("jti"), str):
+            raise InvalidJTIError("JWT ID must be a string")
+
     def _validate_iat(
         self,
         payload: dict[str, Any],
@@ -274,7 +326,9 @@ class PyJWT:
         try:
             iat = int(payload["iat"])
         except ValueError:
-            raise InvalidIssuedAtError("Issued At claim (iat) must be an integer.")
+            raise InvalidIssuedAtError(
+                "Issued At claim (iat) must be an integer."
+            ) from None
         if iat > (now + leeway):
             raise ImmatureSignatureError("The token is not yet valid (iat)")
 
@@ -287,7 +341,7 @@ class PyJWT:
         try:
             nbf = int(payload["nbf"])
         except ValueError:
-            raise DecodeError("Not Before claim (nbf) must be an integer.")
+            raise DecodeError("Not Before claim (nbf) must be an integer.") from None
 
         if nbf > (now + leeway):
             raise ImmatureSignatureError("The token is not yet valid (nbf)")
@@ -301,7 +355,9 @@ class PyJWT:
         try:
             exp = int(payload["exp"])
         except ValueError:
-            raise DecodeError("Expiration Time claim (exp) must be an integer.")
+            raise DecodeError(
+                "Expiration Time claim (exp) must be an integer."
+            ) from None
 
         if exp <= (now - leeway):
             raise ExpiredSignatureError("Signature has expired")
@@ -363,7 +419,7 @@ class PyJWT:
         if "iss" not in payload:
             raise MissingRequiredClaimError("iss")
 
-        if isinstance(issuer, list):
+        if isinstance(issuer, Sequence):
             if payload["iss"] not in issuer:
                 raise InvalidIssuerError("Invalid issuer")
         else:
diff --git a/lib/jwt/exceptions.py b/lib/jwt/exceptions.py
index 0d985882..9b45ae48 100644
--- a/lib/jwt/exceptions.py
+++ b/lib/jwt/exceptions.py
@@ -72,3 +72,11 @@ class PyJWKClientError(PyJWTError):
 
 class PyJWKClientConnectionError(PyJWKClientError):
     pass
+
+
+class InvalidSubjectError(InvalidTokenError):
+    pass
+
+
+class InvalidJTIError(InvalidTokenError):
+    pass
diff --git a/lib/jwt/help.py b/lib/jwt/help.py
index 80b0ca56..8e1c2286 100644
--- a/lib/jwt/help.py
+++ b/lib/jwt/help.py
@@ -39,7 +39,10 @@ def info() -> Dict[str, Dict[str, str]]:
         )
         if pypy_version_info.releaselevel != "final":
             implementation_version = "".join(
-                [implementation_version, pypy_version_info.releaselevel]
+                [
+                    implementation_version,
+                    pypy_version_info.releaselevel,
+                ]
             )
     else:
         implementation_version = "Unknown"
diff --git a/lib/jwt/jwks_client.py b/lib/jwt/jwks_client.py
index f19b10ac..9a8992ca 100644
--- a/lib/jwt/jwks_client.py
+++ b/lib/jwt/jwks_client.py
@@ -45,7 +45,9 @@ class PyJWKClient:
         if cache_keys:
             # Cache signing keys
             # Ignore mypy (https://github.com/python/mypy/issues/2427)
-            self.get_signing_key = lru_cache(maxsize=max_cached_keys)(self.get_signing_key)  # type: ignore
+            self.get_signing_key = lru_cache(maxsize=max_cached_keys)(
+                self.get_signing_key
+            )  # type: ignore
 
     def fetch_data(self) -> Any:
         jwk_set: Any = None
@@ -58,7 +60,7 @@ class PyJWKClient:
         except (URLError, TimeoutError) as e:
             raise PyJWKClientConnectionError(
                 f'Fail to fetch data from the url, err: "{e}"'
-            )
+            ) from e
         else:
             return jwk_set
         finally:
diff --git a/lib/jwt/utils.py b/lib/jwt/utils.py
index d469139b..56e89bb7 100644
--- a/lib/jwt/utils.py
+++ b/lib/jwt/utils.py
@@ -1,7 +1,7 @@
 import base64
 import binascii
 import re
-from typing import Union
+from typing import Optional, Union
 
 try:
     from cryptography.hazmat.primitives.asymmetric.ec import EllipticCurve
@@ -37,11 +37,11 @@ def base64url_encode(input: bytes) -> bytes:
     return base64.urlsafe_b64encode(input).replace(b"=", b"")
 
 
-def to_base64url_uint(val: int) -> bytes:
+def to_base64url_uint(val: int, *, bit_length: Optional[int] = None) -> bytes:
     if val < 0:
         raise ValueError("Must be a positive integer")
 
-    int_bytes = bytes_from_int(val)
+    int_bytes = bytes_from_int(val, bit_length=bit_length)
 
     if len(int_bytes) == 0:
         int_bytes = b"\x00"
@@ -63,13 +63,10 @@ def bytes_to_number(string: bytes) -> int:
     return int(binascii.b2a_hex(string), 16)
 
 
-def bytes_from_int(val: int) -> bytes:
-    remaining = val
-    byte_length = 0
-
-    while remaining != 0:
-        remaining >>= 8
-        byte_length += 1
+def bytes_from_int(val: int, *, bit_length: Optional[int] = None) -> bytes:
+    if bit_length is None:
+        bit_length = val.bit_length()
+    byte_length = (bit_length + 7) // 8
 
     return val.to_bytes(byte_length, "big", signed=False)
 
diff --git a/requirements.txt b/requirements.txt
index 9413a3f6..e6a85bdb 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -28,7 +28,7 @@ platformdirs==4.3.6
 plexapi==4.16.0
 portend==3.2.0
 profilehooks==1.13.0
-PyJWT==2.9.0
+PyJWT==2.10.0
 pyparsing==3.2.0
 python-dateutil==2.9.0.post0
 python-twitter==3.5

From ea66f6713b8a38dcb75f708b4d6726bb6ffd05e6 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 19 Nov 2024 10:08:37 -0800
Subject: [PATCH 691/743] Add hasVoiceActivity to exporter fields

---
 plexpy/exporter.py | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/plexpy/exporter.py b/plexpy/exporter.py
index 08ea1176..d22d52e3 100644
--- a/plexpy/exporter.py
+++ b/plexpy/exporter.py
@@ -191,6 +191,7 @@ class Export(object):
                 },
                 'hasCreditsMarker': None,
                 'hasPreviewThumbnails': None,
+                'hasVoiceActivity': None,
                 'key': None,
                 'labels': {
                     'id': None,
@@ -223,6 +224,7 @@ class Export(object):
                     'id': None,
                     'isOptimizedVersion': None,
                     'has64bitOffsets': None,
+                    'hasVoiceActivity': None,
                     'optimizedForStreaming': None,
                     'proxyType': None,
                     'target': None,
@@ -334,6 +336,7 @@ class Export(object):
                             'streamIdentifier': None
                         },
                         'subtitleStreams': {
+                            'canAutoSync': None,
                             'codec': None,
                             'default': None,
                             'displayTitle': None,
@@ -601,6 +604,7 @@ class Export(object):
                 'hasCreditsMarker': None,
                 'hasIntroMarker': None,
                 'hasPreviewThumbnails': None,
+                'hasVoiceActivity': None,
                 'index': None,
                 'key': None,
                 'labels': {
@@ -633,6 +637,7 @@ class Export(object):
                     'id': None,
                     'isOptimizedVersion': None,
                     'has64bitOffsets': None,
+                    'hasVoiceActivity': None,
                     'optimizedForStreaming': None,
                     'proxyType': None,
                     'target': None,
@@ -744,6 +749,7 @@ class Export(object):
                             'streamIdentifier': None
                         },
                         'subtitleStreams': {
+                            'canAutoSync': None,
                             'codec': None,
                             'default': None,
                             'displayTitle': None,
@@ -1341,7 +1347,7 @@ class Export(object):
                 3: [
                     'art', 'thumb', 'key', 'chapterSource',
                     'chapters.tag', 'chapters.index', 'chapters.start', 'chapters.end', 'chapters.thumb',
-                    'updatedAt', 'lastViewedAt', 'viewCount', 'lastRatedAt', 'hasPreviewThumbnails'
+                    'updatedAt', 'lastViewedAt', 'viewCount', 'lastRatedAt', 'hasPreviewThumbnails', 'hasVoiceActivity'
                 ],
                 9: self._get_all_metadata_attrs(_media_type)
             }
@@ -1454,7 +1460,7 @@ class Export(object):
                 3: [
                     'art', 'thumb', 'key', 'chapterSource',
                     'chapters.tag', 'chapters.index', 'chapters.start', 'chapters.end', 'chapters.thumb',
-                    'updatedAt', 'lastViewedAt', 'viewCount', 'lastRatedAt', 'hasPreviewThumbnails',
+                    'updatedAt', 'lastViewedAt', 'viewCount', 'lastRatedAt', 'hasPreviewThumbnails', 'hasVoiceActivity',
                     'parentThumb', 'parentKey',
                     'grandparentArt', 'grandparentThumb', 'grandparentTheme', 'grandparentKey'
                 ],

From 5c38de0dfb0a7bd7978d87b7910209f711bd2b03 Mon Sep 17 00:00:00 2001
From: Castle <7586648+MythodeaLoL@users.noreply.github.com>
Date: Tue, 19 Nov 2024 15:12:00 -0300
Subject: [PATCH 692/743] Allow Telegram blockquote expandable (#2427)

* Allow Telegram blockquote expandable

Blockquote is not yet supported, this feature adds support along with expandable functionality.

* Add support for tg-emoji in Telegram HTML

---------

Co-authored-by: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
---
 plexpy/notification_handler.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/plexpy/notification_handler.py b/plexpy/notification_handler.py
index e981b17b..4afd8638 100644
--- a/plexpy/notification_handler.py
+++ b/plexpy/notification_handler.py
@@ -1454,8 +1454,11 @@ def strip_tag(data, agent_id=None):
                      's': [], 'strike': [], 'del': [],
                      'span': ['class'], 'tg-spoiler': [],
                      'a': ['href'],
+                     'tg-emoji': ['emoji-id'],
                      'code': ['class'],
-                     'pre': []}
+                     'pre': [],
+                     'blockquote': ['expandable'],
+        }
         data = bleach.clean(data, tags=whitelist.keys(), attributes=whitelist, strip=True)
 
     elif agent_id in (10, 14, 20, 25):

From 9c473c6528d43bcf14eded46597f8fe86496d0a7 Mon Sep 17 00:00:00 2001
From: peagravel <peagravel@proton.me>
Date: Tue, 19 Nov 2024 15:14:45 -0300
Subject: [PATCH 693/743] Add friendly name to the top bar of config modals
 (#2432)

---
 data/interfaces/default/mobile_device_config.html | 2 +-
 data/interfaces/default/newsletter_config.html    | 2 +-
 data/interfaces/default/notifier_config.html      | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/data/interfaces/default/mobile_device_config.html b/data/interfaces/default/mobile_device_config.html
index 705ad568..78080603 100644
--- a/data/interfaces/default/mobile_device_config.html
+++ b/data/interfaces/default/mobile_device_config.html
@@ -3,7 +3,7 @@
     <div class="modal-content">
         <div class="modal-header">
             <button type="button" class="close" data-dismiss="modal" aria-hidden="true"><i class="fa fa-remove"></i></button>
-            <h4 class="modal-title" id="mobile-device-config-modal-header">${device['device_name']} Settings &nbsp;<small><span class="device_id">(Device ID: ${device['id']})</span></small></h4>
+            <h4 class="modal-title" id="mobile-device-config-modal-header">${device['device_name']} Settings &nbsp;<small><span class="device_id">(Device ID: ${device['id']}${' - ' + device['friendly_name'] if device['friendly_name'] else ''})</span></small></h4>
         </div>
         <div class="modal-body">
             <div class="container-fluid">
diff --git a/data/interfaces/default/newsletter_config.html b/data/interfaces/default/newsletter_config.html
index 3c1c68ee..2e46c998 100644
--- a/data/interfaces/default/newsletter_config.html
+++ b/data/interfaces/default/newsletter_config.html
@@ -13,7 +13,7 @@
     <div class="modal-content">
         <div class="modal-header">
             <button type="button" class="close" data-dismiss="modal" aria-hidden="true"><i class="fa fa-remove"></i></button>
-            <h4 class="modal-title" id="newsletter-config-modal-header">${newsletter['agent_label']} Newsletter Settings &nbsp;<small><span class="newsletter_id">(Newsletter ID: ${newsletter['id']})</span></small></h4>
+            <h4 class="modal-title" id="newsletter-config-modal-header">${newsletter['agent_label']} Newsletter Settings &nbsp;<small><span class="newsletter_id">(Newsletter ID: ${newsletter['id']}${' - ' + newsletter['friendly_name'] if newsletter['friendly_name'] else ''})</span></small></h4>
         </div>
         <div class="modal-body">
             <div class="container-fluid">
diff --git a/data/interfaces/default/notifier_config.html b/data/interfaces/default/notifier_config.html
index f023491f..ff7e1d03 100644
--- a/data/interfaces/default/notifier_config.html
+++ b/data/interfaces/default/notifier_config.html
@@ -12,7 +12,7 @@
     <div class="modal-content">
         <div class="modal-header">
             <button type="button" class="close" data-dismiss="modal" aria-hidden="true"><i class="fa fa-remove"></i></button>
-            <h4 class="modal-title" id="notifier-config-modal-header">${notifier['agent_label']} Settings &nbsp;<small><span class="notifier_id">(Notifier ID: ${notifier['id']})</span></small></h4>
+            <h4 class="modal-title" id="notifier-config-modal-header">${notifier['agent_label']} Settings &nbsp;<small><span class="notifier_id">(Notifier ID: ${notifier['id']}${' - ' + notifier['friendly_name'] if notifier['friendly_name'] else ''})</span></small></h4>
         </div>
         <div class="modal-body">
             <div class="container-fluid">

From 6e6fe1fb65f9111d54d79f50613e6d7e877d7084 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 19 Nov 2024 10:36:34 -0800
Subject: [PATCH 694/743] Add slugs to metadata details

---
 plexpy/pmsconnect.py | 33 +++++++++++++++++++++++++++++++++
 plexpy/webserve.py   |  3 +++
 2 files changed, 36 insertions(+)

diff --git a/plexpy/pmsconnect.py b/plexpy/pmsconnect.py
index 4826d3d6..2575d2da 100644
--- a/plexpy/pmsconnect.py
+++ b/plexpy/pmsconnect.py
@@ -823,6 +823,9 @@ class PmsConnect(object):
                         'original_title': helpers.get_xml_attr(metadata_main, 'originalTitle'),
                         'sort_title': helpers.get_xml_attr(metadata_main, 'titleSort'),
                         'edition_title': helpers.get_xml_attr(metadata_main, 'editionTitle'),
+                        'slug': helpers.get_xml_attr(metadata_main, 'slug'),
+                        'parent_slug': helpers.get_xml_attr(metadata_main, 'parentSlug'),
+                        'grandparent_slug': helpers.get_xml_attr(metadata_main, 'grandparentSlug'),
                         'media_index': helpers.get_xml_attr(metadata_main, 'index'),
                         'parent_media_index': helpers.get_xml_attr(metadata_main, 'parentIndex'),
                         'studio': helpers.get_xml_attr(metadata_main, 'studio'),
@@ -883,6 +886,9 @@ class PmsConnect(object):
                         'original_title': helpers.get_xml_attr(metadata_main, 'originalTitle'),
                         'sort_title': helpers.get_xml_attr(metadata_main, 'titleSort'),
                         'edition_title': helpers.get_xml_attr(metadata_main, 'editionTitle'),
+                        'slug': helpers.get_xml_attr(metadata_main, 'slug'),
+                        'parent_slug': helpers.get_xml_attr(metadata_main, 'parentSlug'),
+                        'grandparent_slug': helpers.get_xml_attr(metadata_main, 'grandparentSlug'),
                         'media_index': helpers.get_xml_attr(metadata_main, 'index'),
                         'parent_media_index': helpers.get_xml_attr(metadata_main, 'parentIndex'),
                         'studio': helpers.get_xml_attr(metadata_main, 'studio'),
@@ -949,6 +955,9 @@ class PmsConnect(object):
                         'original_title': helpers.get_xml_attr(metadata_main, 'originalTitle'),
                         'sort_title': helpers.get_xml_attr(metadata_main, 'titleSort'),
                         'edition_title': helpers.get_xml_attr(metadata_main, 'editionTitle'),
+                        'slug': helpers.get_xml_attr(metadata_main, 'slug'),
+                        'parent_slug': helpers.get_xml_attr(metadata_main, 'parentSlug'),
+                        'grandparent_slug': helpers.get_xml_attr(metadata_main, 'grandparentSlug'),
                         'media_index': helpers.get_xml_attr(metadata_main, 'index'),
                         'parent_media_index': helpers.get_xml_attr(metadata_main, 'parentIndex'),
                         'studio': show_details.get('studio', ''),
@@ -1032,6 +1041,9 @@ class PmsConnect(object):
                         'original_title': helpers.get_xml_attr(metadata_main, 'originalTitle'),
                         'sort_title': helpers.get_xml_attr(metadata_main, 'titleSort'),
                         'edition_title': helpers.get_xml_attr(metadata_main, 'editionTitle'),
+                        'slug': helpers.get_xml_attr(metadata_main, 'slug'),
+                        'parent_slug': helpers.get_xml_attr(metadata_main, 'parentSlug'),
+                        'grandparent_slug': helpers.get_xml_attr(metadata_main, 'grandparentSlug'),
                         'media_index': helpers.get_xml_attr(metadata_main, 'index'),
                         'parent_media_index': parent_media_index,
                         'studio': show_details.get('studio', ''),
@@ -1088,6 +1100,9 @@ class PmsConnect(object):
                         'original_title': helpers.get_xml_attr(metadata_main, 'originalTitle'),
                         'sort_title': helpers.get_xml_attr(metadata_main, 'titleSort'),
                         'edition_title': helpers.get_xml_attr(metadata_main, 'editionTitle'),
+                        'slug': helpers.get_xml_attr(metadata_main, 'slug'),
+                        'parent_slug': helpers.get_xml_attr(metadata_main, 'parentSlug'),
+                        'grandparent_slug': helpers.get_xml_attr(metadata_main, 'grandparentSlug'),
                         'media_index': helpers.get_xml_attr(metadata_main, 'index'),
                         'parent_media_index': helpers.get_xml_attr(metadata_main, 'parentIndex'),
                         'studio': helpers.get_xml_attr(metadata_main, 'studio'),
@@ -1145,6 +1160,9 @@ class PmsConnect(object):
                         'original_title': helpers.get_xml_attr(metadata_main, 'originalTitle'),
                         'sort_title': helpers.get_xml_attr(metadata_main, 'titleSort'),
                         'edition_title': helpers.get_xml_attr(metadata_main, 'editionTitle'),
+                        'slug': helpers.get_xml_attr(metadata_main, 'slug'),
+                        'parent_slug': helpers.get_xml_attr(metadata_main, 'parentSlug'),
+                        'grandparent_slug': helpers.get_xml_attr(metadata_main, 'grandparentSlug'),
                         'media_index': helpers.get_xml_attr(metadata_main, 'index'),
                         'parent_media_index': helpers.get_xml_attr(metadata_main, 'parentIndex'),
                         'studio': helpers.get_xml_attr(metadata_main, 'studio'),
@@ -1205,6 +1223,9 @@ class PmsConnect(object):
                         'original_title': helpers.get_xml_attr(metadata_main, 'originalTitle'),
                         'sort_title': helpers.get_xml_attr(metadata_main, 'titleSort'),
                         'edition_title': helpers.get_xml_attr(metadata_main, 'editionTitle'),
+                        'slug': helpers.get_xml_attr(metadata_main, 'slug'),
+                        'parent_slug': helpers.get_xml_attr(metadata_main, 'parentSlug'),
+                        'grandparent_slug': helpers.get_xml_attr(metadata_main, 'grandparentSlug'),
                         'media_index': helpers.get_xml_attr(metadata_main, 'index'),
                         'parent_media_index': helpers.get_xml_attr(metadata_main, 'parentIndex'),
                         'studio': helpers.get_xml_attr(metadata_main, 'studio'),
@@ -1261,6 +1282,9 @@ class PmsConnect(object):
                         'original_title': helpers.get_xml_attr(metadata_main, 'originalTitle'),
                         'sort_title': helpers.get_xml_attr(metadata_main, 'titleSort'),
                         'edition_title': helpers.get_xml_attr(metadata_main, 'editionTitle'),
+                        'slug': helpers.get_xml_attr(metadata_main, 'slug'),
+                        'parent_slug': helpers.get_xml_attr(metadata_main, 'parentSlug'),
+                        'grandparent_slug': helpers.get_xml_attr(metadata_main, 'grandparentSlug'),
                         'media_index': helpers.get_xml_attr(metadata_main, 'index'),
                         'parent_media_index': helpers.get_xml_attr(metadata_main, 'parentIndex'),
                         'studio': helpers.get_xml_attr(metadata_main, 'studio'),
@@ -1318,6 +1342,9 @@ class PmsConnect(object):
                         'original_title': helpers.get_xml_attr(metadata_main, 'originalTitle'),
                         'sort_title': helpers.get_xml_attr(metadata_main, 'titleSort'),
                         'edition_title': helpers.get_xml_attr(metadata_main, 'editionTitle'),
+                        'slug': helpers.get_xml_attr(metadata_main, 'slug'),
+                        'parent_slug': helpers.get_xml_attr(metadata_main, 'parentSlug'),
+                        'grandparent_slug': helpers.get_xml_attr(metadata_main, 'grandparentSlug'),
                         'media_index': helpers.get_xml_attr(metadata_main, 'index'),
                         'parent_media_index': helpers.get_xml_attr(metadata_main, 'parentIndex'),
                         'studio': helpers.get_xml_attr(metadata_main, 'studio'),
@@ -1375,6 +1402,9 @@ class PmsConnect(object):
                         'original_title': helpers.get_xml_attr(metadata_main, 'originalTitle'),
                         'sort_title': helpers.get_xml_attr(metadata_main, 'titleSort'),
                         'edition_title': helpers.get_xml_attr(metadata_main, 'editionTitle'),
+                        'slug': helpers.get_xml_attr(metadata_main, 'slug'),
+                        'parent_slug': helpers.get_xml_attr(metadata_main, 'parentSlug'),
+                        'grandparent_slug': helpers.get_xml_attr(metadata_main, 'grandparentSlug'),
                         'media_index': helpers.get_xml_attr(metadata_main, 'index'),
                         'parent_media_index': helpers.get_xml_attr(metadata_main, 'parentIndex'),
                         'studio': helpers.get_xml_attr(metadata_main, 'studio'),
@@ -1454,6 +1484,9 @@ class PmsConnect(object):
                         'original_title': helpers.get_xml_attr(metadata_main, 'originalTitle'),
                         'sort_title': helpers.get_xml_attr(metadata_main, 'titleSort'),
                         'edition_title': helpers.get_xml_attr(metadata_main, 'editionTitle'),
+                        'slug': helpers.get_xml_attr(metadata_main, 'slug'),
+                        'parent_slug': helpers.get_xml_attr(metadata_main, 'parentSlug'),
+                        'grandparent_slug': helpers.get_xml_attr(metadata_main, 'grandparentSlug'),
                         'media_index': helpers.get_xml_attr(metadata_main, 'index'),
                         'parent_media_index': helpers.get_xml_attr(metadata_main, 'parentIndex'),
                         'studio': helpers.get_xml_attr(metadata_main, 'studio'),
diff --git a/plexpy/webserve.py b/plexpy/webserve.py
index 150bc18d..18521cab 100644
--- a/plexpy/webserve.py
+++ b/plexpy/webserve.py
@@ -5352,6 +5352,7 @@ class WebInterface(object):
                          "tvdb://121361"
                      ],
                      "grandparent_rating_key": "1219",
+                     "grandparent_slug": "game-of-thrones",
                      "grandparent_thumb": "/library/metadata/1219/thumb/1462175063",
                      "grandparent_title": "Game of Thrones",
                      "grandparent_year": "2011",
@@ -5484,6 +5485,7 @@ class WebInterface(object):
                      ],
                      "parent_media_index": "6",
                      "parent_rating_key": "153036",
+                     "parent_slug": "game-of-thrones",
                      "parent_thumb": "/library/metadata/153036/thumb/1462175062",
                      "parent_title": "Season 6",
                      "parent_year": "2016",
@@ -5491,6 +5493,7 @@ class WebInterface(object):
                      "rating_image": "",
                      "rating_key": "153037",
                      "section_id": "2",
+                     "slug": "game-of-thrones",
                      "sort_title": "Red Woman",
                      "studio": "Revolution Sun Studios",
                      "summary": "The fate of Jon Snow is revealed. Daenerys meets a strong man. Cersei sees her daughter once again.",

From b9cb7102c44badcbbb0812126e3849b86e715a03 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Tue, 19 Nov 2024 10:58:55 -0800
Subject: [PATCH 695/743] Add plex_slug and plex_watch_url to nofication
 parameters

---
 plexpy/common.py               |  2 ++
 plexpy/notification_handler.py | 14 ++++++++++++++
 2 files changed, 16 insertions(+)

diff --git a/plexpy/common.py b/plexpy/common.py
index 59c8aeaa..d55674ea 100644
--- a/plexpy/common.py
+++ b/plexpy/common.py
@@ -557,6 +557,8 @@ NOTIFICATION_PARAMETERS = [
              {'name': 'Poster URL', 'type': 'str', 'value': 'poster_url', 'description': 'A URL for the movie, TV show, or album poster.'},
              {'name': 'Plex ID', 'type': 'str', 'value': 'plex_id', 'description': 'The Plex ID for the item.', 'example': 'e.g. 5d7769a9594b2b001e6a6b7e'},
              {'name': 'Plex URL', 'type': 'str', 'value': 'plex_url', 'description': 'The Plex URL to your server for the item.'},
+             {'name': 'Plex Slug', 'type': 'str', 'value': 'plex_slug', 'description': 'The Plex URL slug for the item.'},
+             {'name': 'Plex Watch URL', 'type': 'str', 'value': 'plex_watch_url', 'description': 'The Plex URL to watch.plex.tv for the item.'},
              {'name': 'IMDB ID', 'type': 'str', 'value': 'imdb_id', 'description': 'The IMDB ID for the movie or TV show.', 'example': 'e.g. tt2488496'},
              {'name': 'IMDB URL', 'type': 'str', 'value': 'imdb_url', 'description': 'The IMDB URL for the movie or TV show.'},
              {'name': 'TVDB ID', 'type': 'int', 'value': 'thetvdb_id', 'description': 'The TVDB ID for the movie or TV show.', 'example': 'e.g. 121361'},
diff --git a/plexpy/notification_handler.py b/plexpy/notification_handler.py
index 4afd8638..56ac9df6 100644
--- a/plexpy/notification_handler.py
+++ b/plexpy/notification_handler.py
@@ -824,16 +824,19 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
         poster_thumb = notify_params['thumb']
         poster_key = notify_params['rating_key']
         poster_title = notify_params['title']
+        plex_slug = notify_params['slug']
     elif notify_params['media_type'] in ('season', 'album'):
         poster_thumb = notify_params['thumb'] or notify_params['parent_thumb']
         poster_key = notify_params['rating_key']
         poster_title = '%s - %s' % (notify_params['parent_title'],
                                     notify_params['title'])
+        plex_slug = notify_params['parent_slug']
     elif notify_params['media_type'] in ('episode', 'track'):
         poster_thumb = notify_params['parent_thumb'] or notify_params['grandparent_thumb']
         poster_key = notify_params['parent_rating_key']
         poster_title = '%s - %s' % (notify_params['grandparent_title'],
                                     notify_params['parent_title'])
+        plex_slug = notify_params['grandparent_slug']
     elif notify_params['media_type'] == 'clip':
         if notify_params['extra_type']:
             poster_thumb = notify_params['art'].replace('/art', '/thumb') or notify_params['thumb']
@@ -841,10 +844,19 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
             poster_thumb = notify_params['parent_thumb'] or notify_params['thumb']
         poster_key = notify_params['rating_key']
         poster_title = notify_params['title']
+        plex_slug = notify_params['slug']
     else:
         poster_thumb = ''
         poster_key = ''
         poster_title = ''
+        plex_slug = ''
+
+    if notify_params['media_type'] == 'movie':
+        plex_watch_url = f'https://watch.plex.tv/movie/{plex_slug}'
+    elif notify_params['media_type'] in ('show', 'season', 'episode'):
+        plex_watch_url = f'https://watch.plex.tv/show/{plex_slug}'
+    else:
+        plex_watch_url = ''
 
     img_service = helpers.get_img_service(include_self=True)
     fallback = 'poster-live' if notify_params['live'] else 'poster'
@@ -1154,6 +1166,8 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
         'poster_url': notify_params['poster_url'],
         'plex_id': notify_params['plex_id'],
         'plex_url': notify_params['plex_url'],
+        'plex_slug': plex_slug,
+        'plex_watch_url': plex_watch_url,
         'imdb_id': notify_params['imdb_id'],
         'imdb_url': notify_params['imdb_url'],
         'thetvdb_id': notify_params['thetvdb_id'],

From ca0e1c321d264e8d86a6594ea7fc4ca3a426dc9d Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 24 Nov 2024 14:17:35 -0800
Subject: [PATCH 696/743] Convert CustomArrow to string in newsletter raw json

---
 plexpy/newsletters.py | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/plexpy/newsletters.py b/plexpy/newsletters.py
index b49077a2..c44b505f 100644
--- a/plexpy/newsletters.py
+++ b/plexpy/newsletters.py
@@ -459,8 +459,12 @@ class Newsletter(object):
 
         self.retrieve_data()
 
+        # Convert CustomArrow to string
+        from plexpy.notification_handler import CustomArrow
+        parameters = {k: str(v) if isinstance(v, CustomArrow) else v for k, v in self.parameters.items()}
+
         return {'title': self.NAME,
-                'parameters': self.parameters,
+                'parameters': parameters,
                 'data': self.data}
 
     def generate_newsletter(self, preview=False):

From 62a05712f8b272734c6d722f15dd14cf6c450720 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 24 Nov 2024 14:55:51 -0800
Subject: [PATCH 697/743] Add logos to exporter

---
 data/interfaces/default/export_modal.html     | 21 +++++
 .../default/js/tables/export_table.js         |  6 +-
 plexpy/__init__.py                            | 11 ++-
 plexpy/exporter.py                            | 83 +++++++++++++------
 plexpy/webserve.py                            |  7 +-
 5 files changed, 95 insertions(+), 33 deletions(-)

diff --git a/data/interfaces/default/export_modal.html b/data/interfaces/default/export_modal.html
index b91d31f1..390ee268 100644
--- a/data/interfaces/default/export_modal.html
+++ b/data/interfaces/default/export_modal.html
@@ -20,6 +20,7 @@ DOCUMENTATION :: END
     export = exporter.Export()
     thumb_media_types = ', '.join([export.PLURAL_MEDIA_TYPES[k] for k, v in export.MEDIA_TYPES.items() if v[0]])
     art_media_types = ', '.join([export.PLURAL_MEDIA_TYPES[k] for k, v in export.MEDIA_TYPES.items() if v[1]])
+    logo_media_types = ', '.join([export.PLURAL_MEDIA_TYPES[k] for k, v in export.MEDIA_TYPES.items() if v[2]])
 %>
 <div class="modal-dialog" role="document">
     <div class="modal-content">
@@ -144,6 +145,22 @@ DOCUMENTATION :: END
                         Select the level to export background artwork image files.<br>Note: Only applies to ${art_media_types}.
                     </p>
                 </div>
+                <div class="form-group">
+                    <label for="export_logo_level">Logo Image Export Level</label>
+                    <div class="row">
+                        <div class="col-md-12">
+                            <select class="form-control" id="export_logo_level" name="export_logo_level">
+                                <option value="0" selected>Level 0 - None / Custom</option>
+                                <option value="1">Level 1 - Uploaded and Selected Logos Only</option>
+                                <option value="2">Level 2 - Selected and Locked Logos Only</option>
+                                <option value="9">Level 9 - All Selected Logos</option>
+                            </select>
+                        </div>
+                    </div>
+                    <p class="help-block">
+                        Select the level to export logo image files.<br>Note: Only applies to ${logo_media_types}.
+                    </p>
+                </div>
                 <p class="help-block">
                     Warning: Exporting images may take a long time! Images will be saved to a folder alongside the data file.
                 </p>
@@ -231,6 +248,7 @@ DOCUMENTATION :: END
             $('#export_media_info_level').prop('disabled', true);
             $("#export_thumb_level").prop('disabled', true);
             $("#export_art_level").prop('disabled', true);
+            $("#export_logo_level").prop('disabled', true);
             export_custom_metadata_fields.disable();
             export_custom_media_info_fields.disable();
         } else {
@@ -238,6 +256,7 @@ DOCUMENTATION :: END
             $('#export_media_info_level').prop('disabled', false);
             $("#export_thumb_level").prop('disabled', false);
             $("#export_art_level").prop('disabled', false);
+            $("#export_logo_level").prop('disabled', false);
             export_custom_metadata_fields.enable();
             export_custom_media_info_fields.enable();
         }
@@ -252,6 +271,7 @@ DOCUMENTATION :: END
         var file_format = $('#export_file_format option:selected').val();
         var thumb_level = $("#export_thumb_level option:selected").val();
         var art_level = $("#export_art_level option:selected").val();
+        var logo_level = $("#export_logo_level option:selected").val();
         var custom_fields = [
             $('#export_custom_metadata_fields').val(),
             $('#export_custom_media_info_fields').val()
@@ -270,6 +290,7 @@ DOCUMENTATION :: END
                 file_format: file_format,
                 thumb_level: thumb_level,
                 art_level: art_level,
+                logo_level: logo_level,
                 custom_fields: custom_fields,
                 export_type: export_type,
                 individual_files: individual_files
diff --git a/data/interfaces/default/js/tables/export_table.js b/data/interfaces/default/js/tables/export_table.js
index 44fe4e13..1d8a7b43 100644
--- a/data/interfaces/default/js/tables/export_table.js
+++ b/data/interfaces/default/js/tables/export_table.js
@@ -100,7 +100,7 @@ export_table_options = {
             "createdCell": function (td, cellData, rowData, row, col) {
                 if (cellData !== '') {
                     var images = '';
-                    if (rowData['thumb_level'] || rowData['art_level']) {
+                    if (rowData['thumb_level'] || rowData['art_level'] || rowData['logo_level']) {
                         images = ' + images';
                     }
                     $(td).html(cellData + images);
@@ -161,14 +161,14 @@ export_table_options = {
                 if (cellData === 1 && rowData['exists']) {
                     var tooltip_title = '';
                     var icon = '';
-                    if (rowData['thumb_level'] || rowData['art_level'] || rowData['individual_files']) {
+                    if (rowData['thumb_level'] || rowData['art_level'] || rowData['logo_level'] || rowData['individual_files']) {
                         tooltip_title = 'Zip Archive';
                         icon = 'fa-file-archive';
                     } else {
                         tooltip_title = rowData['file_format'].toUpperCase() + ' File';
                         icon = 'fa-file-download';
                     }
-                    var icon = (rowData['thumb_level'] || rowData['art_level'] || rowData['individual_files']) ? 'fa-file-archive' : 'fa-file-download';
+                    var icon = (rowData['thumb_level'] || rowData['art_level'] || rowData['logo_level'] || rowData['individual_files']) ? 'fa-file-archive' : 'fa-file-download';
                     $(td).html('<button class="btn btn-xs btn-success pull-left" data-id="' + rowData['export_id'] + '"><span data-toggle="tooltip" data-placement="left"  title="' + tooltip_title + '"><i class="fa ' + icon + ' fa-fw"></i> Download</span></button>');
                 } else if (cellData === 0) {
                     var percent = Math.min(getPercent(rowData['exported_items'], rowData['total_items']), 99)
diff --git a/plexpy/__init__.py b/plexpy/__init__.py
index 0c782752..cafc0127 100644
--- a/plexpy/__init__.py
+++ b/plexpy/__init__.py
@@ -845,7 +845,7 @@ def dbcheck():
         "timestamp INTEGER, section_id INTEGER, user_id INTEGER, rating_key INTEGER, media_type TEXT, "
         "title TEXT, file_format TEXT, "
         "metadata_level INTEGER, media_info_level INTEGER, "
-        "thumb_level INTEGER DEFAULT 0, art_level INTEGER DEFAULT 0, "
+        "thumb_level INTEGER DEFAULT 0, art_level INTEGER DEFAULT 0, logo_level INTEGER DEFAULT 0, "
         "custom_fields TEXT, individual_files INTEGER DEFAULT 0, "
         "file_size INTEGER DEFAULT 0, complete INTEGER DEFAULT 0, "
         "exported_items INTEGER DEFAULT 0, total_items INTEGER DEFAULT 0)"
@@ -2589,6 +2589,15 @@ def dbcheck():
             "ALTER TABLE exports ADD COLUMN total_items INTEGER DEFAULT 0"
         )
 
+    # Upgrade exports table from earlier versions
+    try:
+        c_db.execute("SELECT logo_level FROM exports")
+    except sqlite3.OperationalError:
+        logger.debug("Altering database. Updating database table exports.")
+        c_db.execute(
+            "ALTER TABLE exports ADD COLUMN logo_level INTEGER DEFAULT 0"
+        )
+
     # Fix unique constraints
     try:
         c_db.execute("DELETE FROM tvmaze_lookup "
diff --git a/plexpy/exporter.py b/plexpy/exporter.py
index d22d52e3..053dd3bc 100644
--- a/plexpy/exporter.py
+++ b/plexpy/exporter.py
@@ -36,20 +36,20 @@ from plexpy.plex import Plex
 
 
 class Export(object):
-    # True/False for allowed (thumb, art) image export
+    # True/False for allowed (thumb, art, logo) image export
     MEDIA_TYPES = {
-        'movie': (True, True),
-        'show': (True, True),
-        'season': (True, True),
-        'episode': (False, False),
-        'artist': (True, True),
-        'album': (True, True),
-        'track': (False, False),
-        'photoalbum': (False, False),
-        'photo': (False, False),
-        'clip': (False, False),
-        'collection': (True, True),
-        'playlist': (True, True)
+        'movie': (True, True, True),
+        'show': (True, True, True),
+        'season': (True, True, False),
+        'episode': (False, False, False),
+        'artist': (True, True, False),
+        'album': (True, True, False),
+        'track': (False, False, False),
+        'photoalbum': (False, False, False),
+        'photo': (False, False, False),
+        'clip': (False, False, False),
+        'collection': (True, True, False),
+        'playlist': (True, True, False)
     }
     PLURAL_MEDIA_TYPES = {
         'movie': 'movies',
@@ -96,7 +96,7 @@ class Export(object):
 
     def __init__(self, section_id=None, user_id=None, rating_key=None, file_format='csv',
                  metadata_level=1, media_info_level=1,
-                 thumb_level=0, art_level=0,
+                 thumb_level=0, art_level=0, logo_level=0,
                  custom_fields='', export_type='all', individual_files=False):
         self.section_id = helpers.cast_to_int(section_id) or None
         self.user_id = helpers.cast_to_int(user_id) or None
@@ -106,6 +106,7 @@ class Export(object):
         self.media_info_level = helpers.cast_to_int(media_info_level)
         self.thumb_level = helpers.cast_to_int(thumb_level)
         self.art_level = helpers.cast_to_int(art_level)
+        self.logo_level = helpers.cast_to_int(logo_level)
         self.custom_fields = custom_fields.replace(' ', '')
         self._custom_fields = {}
         self.export_type = str(export_type).lower() or 'all'
@@ -124,6 +125,7 @@ class Export(object):
         self.file_size = 0
         self.exported_thumb = False
         self.exported_art = False
+        self.exported_logo = False
         self._reload_check_files = False
 
         self.total_items = 0
@@ -136,6 +138,7 @@ class Export(object):
             self.media_info_level = 1
             self.thumb_level = 0
             self.art_level = 0
+            self.logo_level = 0
             self.custom_fields = ''
 
     def return_attrs(self, media_type, flatten=False):
@@ -204,6 +207,9 @@ class Export(object):
                 'librarySectionKey': None,
                 'librarySectionTitle': None,
                 'locations': None,
+                'logo': lambda o: next((i.url for i in o.images if i.type == 'clearLogo'), None),
+                'logoFile': lambda o: self.get_image(o, 'logo'),
+                'logoProvider': lambda o: self.get_image_provider(o, 'logo'),
                 'markers': {
                     'end': None,
                     'final': None,
@@ -454,6 +460,9 @@ class Export(object):
                 'librarySectionKey': None,
                 'librarySectionTitle': None,
                 'locations': None,
+                'logo': lambda o: next((i.url for i in o.images if i.type == 'clearLogo'), None),
+                'logoFile': lambda o: self.get_image(o, 'logo'),
+                'logoProvider': lambda o: self.get_image_provider(o, 'logo'),
                 'metadataDirectory': None,
                 'network': None,
                 'originallyAvailableAt': partial(helpers.datetime_to_iso, to_date=True),
@@ -1779,6 +1788,8 @@ class Export(object):
             msg = "Export called with invalid thumb_level '{}'.".format(self.thumb_level)
         elif self.art_level not in self.IMAGE_LEVELS:
             msg = "Export called with invalid art_level '{}'.".format(self.art_level)
+        elif self.logo_level not in self.IMAGE_LEVELS:
+            msg = "Export called with invalid logo_level '{}'.".format(self.logo_level)
         elif self.file_format not in self.FILE_FORMATS:
             msg = "Export called with invalid file_format '{}'.".format(self.file_format)
         elif self.export_type not in self.EXPORT_TYPES:
@@ -1806,10 +1817,10 @@ class Export(object):
         if self.rating_key:
             logger.debug(
                 "Tautulli Exporter :: Export called with rating_key %s, "
-                "metadata_level %d, media_info_level %d, thumb_level %s, art_level %s, "
+                "metadata_level %d, media_info_level %d, thumb_level %s, art_level %s, logo_level %s, "
                 "file_format %s",
                 self.rating_key, self.metadata_level, self.media_info_level,
-                self.thumb_level, self.art_level, self.file_format)
+                self.thumb_level, self.art_level, self.logo_level, self.file_format)
 
             self.obj = plex.get_item(self.rating_key)
             self.media_type = self._media_type(self.obj)
@@ -1825,10 +1836,10 @@ class Export(object):
         elif self.user_id:
             logger.debug(
                 "Tautulli Exporter :: Export called with user_id %s, "
-                "metadata_level %d, media_info_level %d, thumb_level %s, art_level %s, "
+                "metadata_level %d, media_info_level %d, thumb_level %s, art_level %s, logo_level %s, "
                 "export_type %s, file_format %s",
                 self.user_id, self.metadata_level, self.media_info_level,
-                self.thumb_level, self.art_level, self.export_type, self.file_format)
+                self.thumb_level, self.art_level, self.logo_level, self.export_type, self.file_format)
 
             self.obj = plex.PlexServer
             self.media_type = self.export_type
@@ -1838,10 +1849,10 @@ class Export(object):
         elif self.section_id:
             logger.debug(
                 "Tautulli Exporter :: Export called with section_id %s, "
-                "metadata_level %d, media_info_level %d, thumb_level %s, art_level %s, "
+                "metadata_level %d, media_info_level %d, thumb_level %s, art_level %s, logo_level %s, "
                 "export_type %s, file_format %s",
                 self.section_id, self.metadata_level, self.media_info_level,
-                self.thumb_level, self.art_level, self.export_type, self.file_format)
+                self.thumb_level, self.art_level, self.logo_level, self.export_type, self.file_format)
 
             self.obj = plex.get_library(self.section_id)
             if self.export_type == 'all':
@@ -1865,6 +1876,8 @@ class Export(object):
             self.thumb_level = 0
         if not self.MEDIA_TYPES[self.media_type][1]:
             self.art_level = 0
+        if not self.MEDIA_TYPES[self.media_type][2]:
+            self.logo_level = 0
 
         self._process_custom_fields()
 
@@ -1898,6 +1911,7 @@ class Export(object):
             'media_info_level': self.media_info_level,
             'thumb_level': self.thumb_level,
             'art_level': self.art_level,
+            'logo_level': self.logo_level,
             'custom_fields': self.custom_fields,
             'individual_files': self.individual_files
         }
@@ -1922,6 +1936,7 @@ class Export(object):
         values = {
             'thumb_level': self.thumb_level,
             'art_level': self.art_level,
+            'logo_level': self.logo_level,
             'complete': complete,
             'file_size': self.file_size
         }
@@ -1977,6 +1992,7 @@ class Export(object):
 
             self.thumb_level = self.thumb_level or 10 if self.exported_thumb else 0
             self.art_level = self.art_level or 10 if self.exported_art else 0
+            self.logo_level = self.logo_level or 10 if self.exported_logo else 0
 
             self.file_size += sum(item.file_size for item in items)
 
@@ -2043,6 +2059,8 @@ class Export(object):
                 self.exported_thumb = True
             elif any(f.endswith('.art.jpg') for f in files):
                 self.exported_art = True
+            elif any(f.endswith('.logo.jpg') for f in files):
+                self.exported_logo = True
 
     def _media_type(self, obj):
         return 'photoalbum' if self.is_photoalbum(obj) else obj.type
@@ -2114,7 +2132,7 @@ class Export(object):
         return media_type, field
 
     def _get_all_metadata_attrs(self, media_type):
-        exclude_attrs = ('locations', 'media', 'artFile', 'thumbFile')
+        exclude_attrs = ('locations', 'media', 'artFile', 'thumbFile', 'logoFile')
         all_attrs = self.return_attrs(media_type)
         return [attr for attr in all_attrs if attr not in exclude_attrs]
 
@@ -2139,6 +2157,9 @@ class Export(object):
         if self.art_level:
             if 'artFile' in media_attrs and self.MEDIA_TYPES[media_type][1]:
                 export_attrs_set.add('artFile')
+        if self.logo_level:
+            if 'logoFile' in media_attrs and self.MEDIA_TYPES[media_type][2]:
+                export_attrs_set.add('logoFile')
 
         if media_type in self._custom_fields:
             export_attrs_set.update(self._custom_fields[media_type])
@@ -2264,6 +2285,10 @@ class Export(object):
             if not hasattr(item, '_arts'):
                 item._arts = item.arts()
             return getattr(item, '_arts', [])
+        elif image == 'logo':
+            if not hasattr(item, '_logos'):
+                item._logos = item.logos()
+            return getattr(item, '_logos', [])
         else:
             if not hasattr(item, '_posters'):
                 item._posters = item.posters()
@@ -2278,13 +2303,13 @@ class Export(object):
         rating_key = item.ratingKey
 
         export_image = True
-        if self.thumb_level == 1 or self.art_level == 1:
+        if self.thumb_level == 1 or self.art_level == 1 or self.logo_level == 1:
             selected = self._get_selected_image(item, image)
             export_image = selected and selected.ratingKey.startswith('upload://')
-        elif self.thumb_level == 2 or self.art_level == 2:
+        elif self.thumb_level == 2 or self.art_level == 2 or self.logo_level == 2:
             export_image = any(field.locked and field.name == image
                                for field in item.fields)
-        elif self.thumb_level == 9 or self.art_level == 9:
+        elif self.thumb_level == 9 or self.art_level == 9 or self.logo_level == 9:
             export_image = True
 
         if not export_image and image + 'File' in self._custom_fields.get(media_type, set()):
@@ -2298,6 +2323,8 @@ class Export(object):
             image_url = item.thumbUrl
         elif image == 'art':
             image_url = item.artUrl
+        elif image == 'logo':
+            image_url = item.logoUrl
 
         if not image_url:
             return
@@ -2350,7 +2377,7 @@ class ExportObject(Export):
 
 def get_export(export_id):
     db = database.MonitorDatabase()
-    result = db.select_single("SELECT timestamp, title, file_format, thumb_level, art_level, "
+    result = db.select_single("SELECT timestamp, title, file_format, thumb_level, art_level, logo_level, "
                               "individual_files, complete "
                               "FROM exports WHERE id = ?",
                               [export_id])
@@ -2442,6 +2469,7 @@ def get_export_datatable(section_id=None, user_id=None, rating_key=None, kwargs=
                "exports.media_info_level",
                "exports.thumb_level",
                "exports.art_level",
+               "exports.logo_level",
                "exports.custom_fields",
                "exports.individual_files",
                "exports.file_size",
@@ -2487,6 +2515,7 @@ def get_export_datatable(section_id=None, user_id=None, rating_key=None, kwargs=
                'media_info_level': item['media_info_level'],
                'thumb_level': item['thumb_level'],
                'art_level': item['art_level'],
+               'logo_level': item['logo_level'],
                'custom_fields': item['custom_fields'],
                'individual_files': item['individual_files'],
                'file_size': item['file_size'],
@@ -2634,7 +2663,7 @@ def build_export_docs():
 
     sections = []
 
-    for media_type, (thumb, art) in export.MEDIA_TYPES.items():
+    for media_type, (thumb, art, logo) in export.MEDIA_TYPES.items():
         if media_type == 'photoalbum':
             section_title = 'Photo Albums'
         else:
@@ -2648,7 +2677,7 @@ def build_export_docs():
         # Metadata Fields table
         table_rows = []
         for attr, level in sorted(metadata_levels_map.items(), key=helpers.sort_attrs):
-            if thumb and attr == 'thumbFile' or art and attr == 'artFile':
+            if thumb and attr == 'thumbFile' or art and attr == 'artFile' or logo and attr == 'logoFile':
                 text = 'Refer to [Image Exports](#image-export)'
                 row = {
                     'attr': attr,
diff --git a/plexpy/webserve.py b/plexpy/webserve.py
index 18521cab..6ea9aa63 100644
--- a/plexpy/webserve.py
+++ b/plexpy/webserve.py
@@ -6966,6 +6966,7 @@ class WebInterface(object):
                           "file_size": 57793562,
                           "filename": null,
                           "individual_files": 1,
+                          "logo_level": 0,
                           "media_info_level": 1,
                           "media_type": "collection",
                           "media_type_title": "Collection",
@@ -7061,7 +7062,7 @@ class WebInterface(object):
     @addtoapi()
     def export_metadata(self, section_id=None, user_id=None, rating_key=None, file_format='csv',
                         metadata_level=1, media_info_level=1,
-                        thumb_level=0, art_level=0,
+                        thumb_level=0, art_level=0, logo_level=0,
                         custom_fields='', export_type='all', individual_files=False, **kwargs):
         """ Export library or media metadata to a file
 
@@ -7077,6 +7078,7 @@ class WebInterface(object):
                 media_info_level (int):    The level of media info to export (default 1)
                 thumb_level (int):         The level of poster/cover images to export (default 0)
                 art_level (int):           The level of background artwork images to export (default 0)
+                logo_level (int):          The level of logo images to export (default 0)
                 custom_fields (str):       Comma separated list of custom fields to export
                                            in addition to the export level selected
                 export_type (str):         'collection' or 'playlist' for library/user export,
@@ -7097,6 +7099,7 @@ class WebInterface(object):
                                  media_info_level=media_info_level,
                                  thumb_level=thumb_level,
                                  art_level=art_level,
+                                 logo_level=logo_level,
                                  custom_fields=custom_fields,
                                  export_type=export_type,
                                  individual_files=individual_files).export()
@@ -7186,7 +7189,7 @@ class WebInterface(object):
         result = exporter.get_export(export_id=export_id)
 
         if result and result['complete'] == 1 and result['exists']:
-            if result['thumb_level'] or result['art_level'] or result['individual_files']:
+            if result['thumb_level'] or result['art_level'] or result['logo_level'] or result['individual_files']:
                 directory = exporter.format_export_directory(result['title'], result['timestamp'])
                 dirpath = exporter.get_export_dirpath(directory)
                 zip_filename = '{}.zip'.format(directory)

From 78864d7a97ab94d433f5eca205897f2b10be455b Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 24 Nov 2024 14:57:29 -0800
Subject: [PATCH 698/743] v2.15.0

---
 CHANGELOG.md      | 24 ++++++++++++++++++++++++
 plexpy/version.py |  2 +-
 2 files changed, 25 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 26dda362..abd3f8d4 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,29 @@
 # Changelog
 
+## v2.15.0 (2024-11-24)
+
+* Notes:
+  * Support for Python 3.8 has been dropped. The minimum Python version is now 3.9.
+* Notifications:
+  * New: Allow Telegram blockquote and tg-emoji HTML tags. (Thanks @MythodeaLoL) (#2427)
+  * New: Added Plex slug and Plex Watch URL notification parameters. (#2420)
+  * Change: Update OneSignal API calls to use the new API endpoint for Tautulli Remote App notifications.
+* Newsletters:
+  * Fix: Dumping custom dates in raw newsletter json.
+* History:
+  * Fix: Unable to fix match for artists. (#2429)
+* Exporter:
+  * New: Added movie and episode hasVoiceActivity attribute to exporter fields.
+  * New: Added subtitle canAutoSync attribute to exporter fields.
+  * New: Added logos to the exporter fields.
+* UI:
+  * New: Add friendly name to the top bar of config modals. (Thanks @peagravel) (#2432)
+* API:
+  * New: Added plex slugs to metadata in the get_metadata API command.
+* Other:
+  * Fix: Tautulli failing to start with Python 3.13. (#2426)
+
+
 ## v2.14.6 (2024-10-12)
 
 * Newsletters:
diff --git a/plexpy/version.py b/plexpy/version.py
index 08fcf9e3..ae1d3273 100644
--- a/plexpy/version.py
+++ b/plexpy/version.py
@@ -16,4 +16,4 @@
 #  along with Tautulli.  If not, see <http://www.gnu.org/licenses/>.
 
 PLEXPY_BRANCH = "master"
-PLEXPY_RELEASE_VERSION = "v2.14.6"
\ No newline at end of file
+PLEXPY_RELEASE_VERSION = "v2.15.0"
\ No newline at end of file

From 37ef098718b819cc4c1a08b19b5e9cab69bdf80a Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 28 Nov 2024 16:36:03 -0800
Subject: [PATCH 699/743] Flip docker container healthcheck https first

---
 Dockerfile | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Dockerfile b/Dockerfile
index 7a52841f..8d8c324b 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -25,4 +25,4 @@ CMD [ "python", "Tautulli.py", "--datadir", "/config" ]
 ENTRYPOINT [ "./start.sh" ]
 
 EXPOSE 8181
-HEALTHCHECK --start-period=90s CMD curl -ILfSs http://localhost:8181/status > /dev/null || curl -ILfkSs https://localhost:8181/status > /dev/null || exit 1
+HEALTHCHECK --start-period=90s CMD curl -ILfks https://localhost:8181/status > /dev/null || curl -ILfs http://localhost:8181/status > /dev/null || exit 1

From b7c4f2eefe40c3f6b147e07cc3d83de120094fdc Mon Sep 17 00:00:00 2001
From: chrisdecker08 <62341865+chrisdecker08@users.noreply.github.com>
Date: Sat, 14 Dec 2024 15:24:08 -0500
Subject: [PATCH 700/743] detect HDR transcodes via colorTrc attribute (#2466)

---
 plexpy/pmsconnect.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/plexpy/pmsconnect.py b/plexpy/pmsconnect.py
index 2575d2da..46cd143e 100644
--- a/plexpy/pmsconnect.py
+++ b/plexpy/pmsconnect.py
@@ -3386,10 +3386,10 @@ class PmsConnect(object):
     def get_dynamic_range(stream):
         extended_display_title = helpers.get_xml_attr(stream, 'extendedDisplayTitle')
         bit_depth = helpers.cast_to_int(helpers.get_xml_attr(stream, 'bitDepth'))
-        color_space = helpers.get_xml_attr(stream, 'colorSpace')
+        color_trc = helpers.get_xml_attr(stream, 'colorTrc')
         DOVI_profile = helpers.get_xml_attr(stream, 'DOVIProfile')
 
-        HDR = bool(bit_depth > 8 and 'bt2020' in color_space)
+        HDR = bool(bit_depth > 8 and (color_trc == 'smpte2084' or color_trc == 'arib-std-b67'))
         DV = bool(DOVI_profile)
 
         if not HDR and not DV:

From 63fe386057bc315bc97e3cecf622c21ad9f6e6fd Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 9 Jan 2025 09:13:57 -0800
Subject: [PATCH 701/743] Disable basic auth for /newsletter and /image
 endpoints

Fixes #2472
---
 plexpy/webstart.py | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/plexpy/webstart.py b/plexpy/webstart.py
index 8a6edc6e..1f3fb7ed 100644
--- a/plexpy/webstart.py
+++ b/plexpy/webstart.py
@@ -171,6 +171,12 @@ def initialize(options):
         '/status': {
             'tools.auth_basic.on': False
         },
+        '/newsletter': {
+            'tools.auth_basic.on': False
+        },
+        '/image': {
+            'tools.auth_basic.on': False
+        },
         '/interfaces': {
             'tools.staticdir.on': True,
             'tools.staticdir.dir': "interfaces",

From 8f03e276178896130759da2d8f6367d77e63ae29 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 9 Jan 2025 09:57:58 -0800
Subject: [PATCH 702/743] Add VirusTotal scan to installer build CI

---
 .github/workflows/publish-installers.yml | 18 ++++++++++++++++++
 .github/workflows/submit-winget.yml      | 13 +++++++++++++
 2 files changed, 31 insertions(+)

diff --git a/.github/workflows/publish-installers.yml b/.github/workflows/publish-installers.yml
index e3f7fe85..b4a66960 100644
--- a/.github/workflows/publish-installers.yml
+++ b/.github/workflows/publish-installers.yml
@@ -100,6 +100,24 @@ jobs:
           name: Tautulli-${{ matrix.os }}-installer
           path: Tautulli-${{ matrix.os }}-${{ steps.get_version.outputs.RELEASE_VERSION }}-${{ matrix.arch }}.${{ matrix.ext }}
 
+  virus-total:
+    name: VirusTotal Scan
+    needs: build-installer
+    if: needs.build-installer.result == 'success' && !contains(github.event.head_commit.message, '[skip ci]')
+    runs-on: ubuntu-latest
+    steps:
+      - name: Download Installers
+        if: needs.build-installer.result == 'success'
+        uses: actions/download-artifact@v4
+
+      - name: Upload to VirusTotal
+        uses: crazy-max/ghaction-virustotal@v4
+        with:
+          vt_api_key: ${{ secrets.VT_API_KEY }}
+          files: |
+            Tautulli-windows-installer/Tautulli-windows-*-x64.exe
+            Tautulli-macos-installer/Tautulli-macos-*-universal.pkg
+
   release:
     name: Release Installers
     needs: build-installer
diff --git a/.github/workflows/submit-winget.yml b/.github/workflows/submit-winget.yml
index aa1c4dec..e4b0303f 100644
--- a/.github/workflows/submit-winget.yml
+++ b/.github/workflows/submit-winget.yml
@@ -23,3 +23,16 @@ jobs:
           # getting latest wingetcreate file
           iwr https://aka.ms/wingetcreate/latest -OutFile wingetcreate.exe
           .\wingetcreate.exe update $wingetPackage -s -v $version -u $installerUrl -t $gitToken
+
+  virus-total:
+    name: VirusTotal Scan
+    runs-on: ubuntu-latest
+    steps:
+      - name: Upload to VirusTotal
+        uses: crazy-max/ghaction-virustotal@v4
+        with:
+          vt_api_key: ${{ secrets.VT_API_KEY }}
+          update_release_body: true
+          files: |
+            .exe$
+            .pkg$

From f9b3631745db0e3918d5d8e0614a0783af8cf227 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 9 Jan 2025 10:14:37 -0800
Subject: [PATCH 703/743] Bump pyjwt from 2.10.0 to 2.10.1 (#2445)

Bumps [pyjwt](https://github.com/jpadilla/pyjwt) from 2.10.0 to 2.10.1.
- [Release notes](https://github.com/jpadilla/pyjwt/releases)
- [Changelog](https://github.com/jpadilla/pyjwt/blob/master/CHANGELOG.rst)
- [Commits](https://github.com/jpadilla/pyjwt/compare/2.10.0...2.10.1)

---
updated-dependencies:
- dependency-name: pyjwt
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements.txt b/requirements.txt
index e6a85bdb..e05608bc 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -28,7 +28,7 @@ platformdirs==4.3.6
 plexapi==4.16.0
 portend==3.2.0
 profilehooks==1.13.0
-PyJWT==2.10.0
+PyJWT==2.10.1
 pyparsing==3.2.0
 python-dateutil==2.9.0.post0
 python-twitter==3.5

From 85e9237608dda60c0f1985d9537cac8432fba247 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 9 Jan 2025 10:16:47 -0800
Subject: [PATCH 704/743] Update pyjwt==2.10.1

---
 lib/jwt/__init__.py | 2 +-
 lib/jwt/api_jwt.py  | 6 +++---
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/lib/jwt/__init__.py b/lib/jwt/__init__.py
index 9d4b6744..457a4e35 100644
--- a/lib/jwt/__init__.py
+++ b/lib/jwt/__init__.py
@@ -27,7 +27,7 @@ from .exceptions import (
 )
 from .jwks_client import PyJWKClient
 
-__version__ = "2.10.0"
+__version__ = "2.10.1"
 
 __title__ = "PyJWT"
 __description__ = "JSON Web Token implementation in Python"
diff --git a/lib/jwt/api_jwt.py b/lib/jwt/api_jwt.py
index fa4d5e6f..3a201436 100644
--- a/lib/jwt/api_jwt.py
+++ b/lib/jwt/api_jwt.py
@@ -419,11 +419,11 @@ class PyJWT:
         if "iss" not in payload:
             raise MissingRequiredClaimError("iss")
 
-        if isinstance(issuer, Sequence):
-            if payload["iss"] not in issuer:
+        if isinstance(issuer, str):
+            if payload["iss"] != issuer:
                 raise InvalidIssuerError("Invalid issuer")
         else:
-            if payload["iss"] != issuer:
+            if payload["iss"] not in issuer:
                 raise InvalidIssuerError("Invalid issuer")
 
 

From 078c293bd78781cd9dbfe3f4e4102e08698349a5 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 9 Jan 2025 10:45:29 -0800
Subject: [PATCH 705/743] Update plexapi=4.16.1

---
 lib/plexapi/const.py | 2 +-
 lib/plexapi/sonos.py | 5 +++--
 lib/plexapi/video.py | 4 ++--
 requirements.txt     | 2 +-
 4 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/lib/plexapi/const.py b/lib/plexapi/const.py
index 93f7e034..bc3e81aa 100644
--- a/lib/plexapi/const.py
+++ b/lib/plexapi/const.py
@@ -4,6 +4,6 @@
 # Library version
 MAJOR_VERSION = 4
 MINOR_VERSION = 16
-PATCH_VERSION = 0
+PATCH_VERSION = 1
 __short_version__ = f"{MAJOR_VERSION}.{MINOR_VERSION}"
 __version__ = f"{__short_version__}.{PATCH_VERSION}"
diff --git a/lib/plexapi/sonos.py b/lib/plexapi/sonos.py
index 14f83d31..8f1295f4 100644
--- a/lib/plexapi/sonos.py
+++ b/lib/plexapi/sonos.py
@@ -1,7 +1,7 @@
 # -*- coding: utf-8 -*-
 import requests
 
-from plexapi import CONFIG, X_PLEX_IDENTIFIER
+from plexapi import CONFIG, X_PLEX_IDENTIFIER, TIMEOUT
 from plexapi.client import PlexClient
 from plexapi.exceptions import BadRequest
 from plexapi.playqueue import PlayQueue
@@ -46,7 +46,7 @@ class PlexSonosClient(PlexClient):
             _session (obj): Requests session object used to access this client.
     """
 
-    def __init__(self, account, data):
+    def __init__(self, account, data, timeout=None):
         self._data = data
         self.deviceClass = data.attrib.get("deviceClass")
         self.machineIdentifier = data.attrib.get("machineIdentifier")
@@ -66,6 +66,7 @@ class PlexSonosClient(PlexClient):
         self._last_call = 0
         self._proxyThroughServer = False
         self._showSecrets = CONFIG.get("log.show_secrets", "").lower() == "true"
+        self._timeout = timeout or TIMEOUT
 
     def playMedia(self, media, offset=0, **params):
 
diff --git a/lib/plexapi/video.py b/lib/plexapi/video.py
index 6e811aa4..9e4201b8 100644
--- a/lib/plexapi/video.py
+++ b/lib/plexapi/video.py
@@ -716,7 +716,7 @@ class Show(
 class Season(
     Video,
     AdvancedSettingsMixin, ExtrasMixin, RatingMixin,
-    ArtMixin, PosterMixin, ThemeUrlMixin,
+    ArtMixin, LogoMixin, PosterMixin, ThemeUrlMixin,
     SeasonEditMixins
 ):
     """ Represents a single Season.
@@ -883,7 +883,7 @@ class Season(
 class Episode(
     Video, Playable,
     ExtrasMixin, RatingMixin,
-    ArtMixin, PosterMixin, ThemeUrlMixin,
+    ArtMixin, LogoMixin, PosterMixin, ThemeUrlMixin,
     EpisodeEditMixins
 ):
     """ Represents a single Episode.
diff --git a/requirements.txt b/requirements.txt
index e05608bc..0bd14208 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -25,7 +25,7 @@ musicbrainzngs==0.7.1
 packaging==24.2
 paho-mqtt==2.1.0
 platformdirs==4.3.6
-plexapi==4.16.0
+plexapi==4.16.1
 portend==3.2.0
 profilehooks==1.13.0
 PyJWT==2.10.1

From 67fa4ca6453eb3db5e8a44d53560b56bd70d7a86 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 9 Jan 2025 10:45:49 -0800
Subject: [PATCH 706/743] Add logos to season and episode exports

---
 plexpy/exporter.py | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/plexpy/exporter.py b/plexpy/exporter.py
index 053dd3bc..18c20a4e 100644
--- a/plexpy/exporter.py
+++ b/plexpy/exporter.py
@@ -40,8 +40,8 @@ class Export(object):
     MEDIA_TYPES = {
         'movie': (True, True, True),
         'show': (True, True, True),
-        'season': (True, True, False),
-        'episode': (False, False, False),
+        'season': (True, True, True),
+        'episode': (False, False, True),
         'artist': (True, True, False),
         'album': (True, True, False),
         'track': (False, False, False),
@@ -533,6 +533,9 @@ class Export(object):
                 'librarySectionID': None,
                 'librarySectionKey': None,
                 'librarySectionTitle': None,
+                'logo': lambda o: next((i.url for i in o.images if i.type == 'clearLogo'), None),
+                'logoFile': lambda o: self.get_image(o, 'logo'),
+                'logoProvider': lambda o: self.get_image_provider(o, 'logo'),
                 'metadataDirectory': None,
                 'parentGuid': None,
                 'parentIndex': None,
@@ -626,6 +629,9 @@ class Export(object):
                 'librarySectionKey': None,
                 'librarySectionTitle': None,
                 'locations': None,
+                'logo': lambda o: next((i.url for i in o.images if i.type == 'clearLogo'), None),
+                'logoFile': lambda o: self.get_image(o, 'logo'),
+                'logoProvider': lambda o: self.get_image_provider(o, 'logo'),
                 'markers': {
                     'end': None,
                     'final': None,

From 0a4730625ccc9c119c823a4e6a33314976b3b709 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 9 Jan 2025 15:12:49 -0800
Subject: [PATCH 707/743] Update copyright year

---
 package/Tautulli.nsi | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package/Tautulli.nsi b/package/Tautulli.nsi
index ad09846c..7232c23f 100644
--- a/package/Tautulli.nsi
+++ b/package/Tautulli.nsi
@@ -7,7 +7,7 @@
 !define APP_NAME "Tautulli"
 !define COMP_NAME "Tautulli"
 !define WEB_SITE "https://tautulli.com"
-!define COPYRIGHT "Tautulli © 2020"
+!define COPYRIGHT "Tautulli © 2025"
 !define DESCRIPTION "Monitor your Plex Media Server"
 !define APP_ICON "..\dist\Tautulli\data\interfaces\default\images\logo-circle.ico"
 !define LICENSE_TXT "..\dist\Tautulli\LICENSE"

From 65dc466c07f51e85542635e674ab0e9a09c7f91f Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 9 Jan 2025 15:13:20 -0800
Subject: [PATCH 708/743] Add Github token to release virus scan

---
 .github/workflows/submit-winget.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.github/workflows/submit-winget.yml b/.github/workflows/submit-winget.yml
index e4b0303f..5385c1c3 100644
--- a/.github/workflows/submit-winget.yml
+++ b/.github/workflows/submit-winget.yml
@@ -32,6 +32,7 @@ jobs:
         uses: crazy-max/ghaction-virustotal@v4
         with:
           vt_api_key: ${{ secrets.VT_API_KEY }}
+          github_token: ${{ secrets.GHACTIONS_TOKEN }}
           update_release_body: true
           files: |
             .exe$

From a96fd23d72f5aa3042d6f9a55d8051653ff6f0b8 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 11 Jan 2025 15:27:24 -0800
Subject: [PATCH 709/743] v2.15.1

---
 CHANGELOG.md      | 12 ++++++++++++
 plexpy/version.py |  2 +-
 2 files changed, 13 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index abd3f8d4..5d5524c4 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,17 @@
 # Changelog
 
+## v2.15.1 (2025-01-11)
+
+* Activity:
+  * Fix: Detection of HDR transcodes. (Thanks @chrisdecker08) (#2412, #2466)
+* Newsletters:
+  * Fix: Disable basic authentication for /newsletter and /image endpoints. (#2472)
+* Exporter:
+  * New: Added logos to season and episode exports.
+* Other:
+  * Fix Docker container https health check.
+
+
 ## v2.15.0 (2024-11-24)
 
 * Notes:
diff --git a/plexpy/version.py b/plexpy/version.py
index ae1d3273..b08e42da 100644
--- a/plexpy/version.py
+++ b/plexpy/version.py
@@ -16,4 +16,4 @@
 #  along with Tautulli.  If not, see <http://www.gnu.org/licenses/>.
 
 PLEXPY_BRANCH = "master"
-PLEXPY_RELEASE_VERSION = "v2.15.0"
\ No newline at end of file
+PLEXPY_RELEASE_VERSION = "v2.15.1"
\ No newline at end of file

From 2ed603f2886caa301ae11701fc7358374183766e Mon Sep 17 00:00:00 2001
From: luzpaz <luzpaz@users.noreply.github.com>
Date: Sun, 16 Mar 2025 15:25:29 -0400
Subject: [PATCH 710/743] Fix typos (#2520)

Found via codespell
---
 README.md                      |  2 +-
 Tautulli.py                    |  2 +-
 plexpy/activity_pinger.py      |  2 +-
 plexpy/config.py               |  2 +-
 plexpy/datatables.py           |  2 +-
 plexpy/mobile_app.py           |  2 +-
 plexpy/notification_handler.py |  4 ++--
 plexpy/notifiers.py            |  2 +-
 plexpy/webauth.py              |  2 +-
 plexpy/webserve.py             | 12 ++++++------
 10 files changed, 16 insertions(+), 16 deletions(-)

diff --git a/README.md b/README.md
index 1f24741e..37829290 100644
--- a/README.md
+++ b/README.md
@@ -129,7 +129,7 @@ This is free software under the GPL v3 open source license. Feel free to do with
 but any modification must be open sourced. A copy of the license is included.
 
 This software includes Highsoft software libraries which you may freely distribute for 
-non-commercial use. Commerical users must licence this software, for more information visit
+non-commercial use. Commercial users must licence this software, for more information visit
 https://shop.highsoft.com/faq/non-commercial#non-commercial-redistribution.
 
 
diff --git a/Tautulli.py b/Tautulli.py
index 200cd39d..b3cf4736 100755
--- a/Tautulli.py
+++ b/Tautulli.py
@@ -129,7 +129,7 @@ def main():
     if args.quiet:
         plexpy.QUIET = True
 
-    # Do an intial setup of the logger.
+    # Do an initial setup of the logger.
     # Require verbose for pre-initilization to see critical errors
     logger.initLogger(console=not plexpy.QUIET, log_dir=False, verbose=True)
 
diff --git a/plexpy/activity_pinger.py b/plexpy/activity_pinger.py
index 9e8487fb..22688027 100644
--- a/plexpy/activity_pinger.py
+++ b/plexpy/activity_pinger.py
@@ -173,7 +173,7 @@ def check_active_sessions(ws_request=False):
                     row_id = monitor_process.write_session_history(session=stream)
 
                     if row_id:
-                        # If session is written to the databaase successfully, remove the session from the session table
+                        # If session is written to the database successfully, remove the session from the session table
                         logger.debug("Tautulli Monitor :: Removing sessionKey %s ratingKey %s from session queue"
                                      % (stream['session_key'], stream['rating_key']))
                         monitor_process.delete_session(row_id=row_id)
diff --git a/plexpy/config.py b/plexpy/config.py
index c41e3b59..3e9862ff 100644
--- a/plexpy/config.py
+++ b/plexpy/config.py
@@ -568,7 +568,7 @@ class Config(object):
 
     def _upgrade(self):
         """
-        Upgrades config file from previous verisions and bumps up config version
+        Upgrades config file from previous versions and bumps up config version
         """
         if self.CONFIG_VERSION == 0:
             self.CONFIG_VERSION = 1
diff --git a/plexpy/datatables.py b/plexpy/datatables.py
index 68c76c57..0cc94760 100644
--- a/plexpy/datatables.py
+++ b/plexpy/datatables.py
@@ -283,7 +283,7 @@ def extract_columns(columns=None, match_columns=None):
     columns_string = columns_string.rstrip(', ')
 
     # We return a dict of the column params
-    # column_string is a comma seperated list of the exact column variables received.
+    # column_string is a comma separated list of the exact column variables received.
     # column_literal is the text before the "as" if we have an "as". Usually a function.
     # column_named is the text after the "as", if we have an "as". Any table prefix is also stripped off.
     #   We use this to match with columns received from the Datatables request.
diff --git a/plexpy/mobile_app.py b/plexpy/mobile_app.py
index f3c835c3..8ba075d5 100644
--- a/plexpy/mobile_app.py
+++ b/plexpy/mobile_app.py
@@ -132,7 +132,7 @@ def set_mobile_device_config(mobile_device_id=None, **kwargs):
     if str(mobile_device_id).isdigit():
         mobile_device_id = int(mobile_device_id)
     else:
-        logger.error("Tautulli MobileApp :: Unable to set exisiting mobile device: invalid mobile_device_id %s." % mobile_device_id)
+        logger.error("Tautulli MobileApp :: Unable to set existing mobile device: invalid mobile_device_id %s." % mobile_device_id)
         return False
 
     keys = {'id': mobile_device_id}
diff --git a/plexpy/notification_handler.py b/plexpy/notification_handler.py
index 56ac9df6..ada7dcfb 100644
--- a/plexpy/notification_handler.py
+++ b/plexpy/notification_handler.py
@@ -955,7 +955,7 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
     now_iso = now.isocalendar()
 
     available_params = {
-        # Global paramaters
+        # Global parameters
         'tautulli_version': common.RELEASE,
         'tautulli_remote': plexpy.CONFIG.GIT_REMOTE,
         'tautulli_branch': plexpy.CONFIG.GIT_BRANCH,
@@ -1267,7 +1267,7 @@ def build_server_notify_params(notify_action=None, **kwargs):
     now_iso = now.isocalendar()
 
     available_params = {
-        # Global paramaters
+        # Global parameters
         'tautulli_version': common.RELEASE,
         'tautulli_remote': plexpy.CONFIG.GIT_REMOTE,
         'tautulli_branch': plexpy.CONFIG.GIT_BRANCH,
diff --git a/plexpy/notifiers.py b/plexpy/notifiers.py
index 2029aa01..b44caf82 100644
--- a/plexpy/notifiers.py
+++ b/plexpy/notifiers.py
@@ -4055,7 +4055,7 @@ class TAUTULLIREMOTEAPP(Notifier):
                        }
         else:
             logger.warn("Tautulli Notifiers :: Cryptography library is missing. "
-                        "Tautulli Remote app notifications will be sent unecrypted. "
+                        "Tautulli Remote app notifications will be sent unencrypted. "
                         "Install the library to encrypt the notifications.")
 
             payload = {'app_id': mobile_app._ONESIGNAL_APP_ID,
diff --git a/plexpy/webauth.py b/plexpy/webauth.py
index 05c81a81..c4b83ab7 100644
--- a/plexpy/webauth.py
+++ b/plexpy/webauth.py
@@ -50,7 +50,7 @@ def plex_user_login(token=None, headers=None):
     user_token = None
     user_id = None
 
-    # Try to login to Plex.tv to check if the user has a vaild account
+    # Try to login to Plex.tv to check if the user has a valid account
     if token:
         plex_tv = PlexTV(token=token, headers=headers)
         plex_user = plex_tv.get_plex_account_details()
diff --git a/plexpy/webserve.py b/plexpy/webserve.py
index 6ea9aa63..0349e6e8 100644
--- a/plexpy/webserve.py
+++ b/plexpy/webserve.py
@@ -608,7 +608,7 @@ class WebInterface(object):
             status_message = ''
         else:
             result = None
-            status_message = 'An error occured.'
+            status_message = 'An error occurred.'
 
         return serve_template(template_name="edit_library.html", title="Edit Library",
                               data=result, server_id=plexpy.CONFIG.PMS_IDENTIFIER, status_message=status_message)
@@ -1347,7 +1347,7 @@ class WebInterface(object):
             status_message = ''
         else:
             result = None
-            status_message = 'An error occured.'
+            status_message = 'An error occurred.'
 
         return serve_template(template_name="edit_user.html", title="Edit User", data=result, status_message=status_message)
 
@@ -1365,7 +1365,7 @@ class WebInterface(object):
                 keep_history (int):         0 or 1
                 allow_guest (int):          0 or 1
 
-            Optional paramters:
+            Optional parameters:
                 None
 
             Returns:
@@ -3031,7 +3031,7 @@ class WebInterface(object):
         """ Delete the Tautulli notification logs.
 
             ```
-            Required paramters:
+            Required parameters:
                 None
 
             Optional parameters:
@@ -3056,7 +3056,7 @@ class WebInterface(object):
         """ Delete the Tautulli newsletter logs.
 
             ```
-            Required paramters:
+            Required parameters:
                 None
 
             Optional parameters:
@@ -3081,7 +3081,7 @@ class WebInterface(object):
         """ Delete the Tautulli login logs.
 
             ```
-            Required paramters:
+            Required parameters:
                 None
 
             Optional parameters:

From f23d3eb81c5057633eb104963d50ccccf14a2ade Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 11 Jan 2025 15:42:15 -0800
Subject: [PATCH 711/743] Fix changelog username

---
 CHANGELOG.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 5d5524c4..7ce76873 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -3,7 +3,7 @@
 ## v2.15.1 (2025-01-11)
 
 * Activity:
-  * Fix: Detection of HDR transcodes. (Thanks @chrisdecker08) (#2412, #2466)
+  * Fix: Detection of HDR transcodes. (Thanks @cdecker08) (#2412, #2466)
 * Newsletters:
   * Fix: Disable basic authentication for /newsletter and /image endpoints. (#2472)
 * Exporter:

From c70381c3ff4dec8d62d7e35be811ae93a139f05a Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Thu, 23 Jan 2025 13:30:45 -0800
Subject: [PATCH 712/743] Fix ntfy notifications not sending if provider link
 is blank

---
 plexpy/notifiers.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/plexpy/notifiers.py b/plexpy/notifiers.py
index b44caf82..5f231a17 100644
--- a/plexpy/notifiers.py
+++ b/plexpy/notifiers.py
@@ -2667,7 +2667,8 @@ class NTFY(Notifier):
 
                 provider_name = pretty_metadata.get_provider_name(provider)
                 provider_link = pretty_metadata.get_provider_link(provider)
-                actions.append(f"view, View on {provider_name}, {provider_link}, clear=true")
+                if provider_link:
+                    actions.append(f"view, View on {provider_name}, {provider_link}, clear=true")
 
             if self.config['incl_pmslink']:
                 plex_url = pretty_metadata.get_plex_url()

From 0879b848b970ab05e67ea843bca49f607a8b0a5e Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 24 Jan 2025 10:54:15 -0800
Subject: [PATCH 713/743] Add link to library page from activity card media
 type icon

---
 .../default/current_activity_instance.html    | 31 ++++++++++++-------
 1 file changed, 19 insertions(+), 12 deletions(-)

diff --git a/data/interfaces/default/current_activity_instance.html b/data/interfaces/default/current_activity_instance.html
index fcc1b592..b1b7c3aa 100644
--- a/data/interfaces/default/current_activity_instance.html
+++ b/data/interfaces/default/current_activity_instance.html
@@ -74,6 +74,7 @@ DOCUMENTATION :: END
     parent_href = page('info', data['parent_rating_key'])
     grandparent_href = page('info', data['grandparent_rating_key'])
     user_href = page('user', data['user_id']) if data['user_id'] else '#'
+    library_href = page('library', data['section_id'])
     season = short_season(data['parent_title'])
 %>
 <div class="dashboard-activity-instance" id="activity-instance-${sk}" data-key="${sk}" data-id="${data['session_id']}"
@@ -463,21 +464,27 @@ DOCUMENTATION :: END
         <div class="dashboard-activity-metadata-subtitle-container">
             % if data['live']:
             <div id="media-type-${sk}" class="dashboard-activity-metadata-media_type-icon" title="Live TV">
-                <i class="fa fa-fw fa-broadcast-tower"></i>&nbsp;
+                <a href="${library_href}">
+                    <i class="fa fa-fw fa-broadcast-tower"></i>
+                </a>&nbsp;
             </div>
             % elif data['channel_stream'] == 0:
             <div id="media-type-${sk}" class="dashboard-activity-metadata-media_type-icon" title="${data['media_type'].capitalize()}">
-                % if data['media_type'] == 'movie':
-                <i class="fa fa-fw fa-film"></i>&nbsp;
-                % elif data['media_type'] == 'episode':
-                <i class="fa fa-fw fa-television"></i>&nbsp;
-                % elif data['media_type'] == 'track':
-                <i class="fa fa-fw fa-music"></i>&nbsp;
-                % elif data['media_type'] == 'photo':
-                <i class="fa fa-fw fa-picture-o"></i>&nbsp;
-                % elif data['media_type'] == 'clip':
-                <i class="fa fa-fw fa-video-camera"></i>&nbsp;
-                % endif
+                <a href="${library_href}">
+                    % if data['media_type'] == 'movie':
+                    <i class="fa fa-fw fa-film"></i>
+                    % elif data['media_type'] == 'episode':
+                    <i class="fa fa-fw fa-television"></i>
+                    % elif data['media_type'] == 'track':
+                    <i class="fa fa-fw fa-music"></i>
+                    % elif data['media_type'] == 'photo':
+                    <i class="fa fa-fw fa-picture-o"></i>
+                    % elif data['media_type'] == 'clip':
+                    <i class="fa fa-fw fa-video-camera"></i>
+                    % else:
+                    <i class="fa fa-fw fa-question-circle"></i>
+                    % endif
+                </a>&nbsp;
             </div>
             % else:
             <div id="media-type-${sk}" class="dashboard-activity-metadata-media_type-icon" title="Channel">

From 53e5f89725b7a174f2e2afb2b6134f60de1348ea Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Wed, 12 Mar 2025 21:39:36 -0700
Subject: [PATCH 714/743] Add audio profile notification parameters

---
 plexpy/common.py               | 2 ++
 plexpy/notification_handler.py | 2 ++
 plexpy/pmsconnect.py           | 2 ++
 plexpy/webserve.py             | 1 +
 4 files changed, 7 insertions(+)

diff --git a/plexpy/common.py b/plexpy/common.py
index d55674ea..d057cee9 100644
--- a/plexpy/common.py
+++ b/plexpy/common.py
@@ -476,6 +476,7 @@ NOTIFICATION_PARAMETERS = [
              {'name': 'Stream Audio Sample Rate', 'type': 'int', 'value': 'stream_audio_sample_rate', 'description': 'The audio sample rate (in Hz) of the stream.'},
              {'name': 'Stream Audio Language', 'type': 'str', 'value': 'stream_audio_language', 'description': 'The audio language of the stream.'},
              {'name': 'Stream Audio Language Code', 'type': 'str', 'value': 'stream_audio_language_code', 'description': 'The audio language code of the stream.'},
+             {'name': 'Stream Audio Profile', 'type': 'str', 'value': 'stream_audio_profile', 'description': 'The audio profile of the stream.'},
              {'name': 'Stream Subtitle Codec', 'type': 'str', 'value': 'stream_subtitle_codec', 'description': 'The subtitle codec of the stream.'},
              {'name': 'Stream Subtitle Container', 'type': 'str', 'value': 'stream_subtitle_container', 'description': 'The subtitle container of the stream.'},
              {'name': 'Stream Subtitle Format', 'type': 'str', 'value': 'stream_subtitle_format', 'description': 'The subtitle format of the stream.'},
@@ -606,6 +607,7 @@ NOTIFICATION_PARAMETERS = [
              {'name': 'Audio Sample Rate', 'type': 'int', 'value': 'audio_sample_rate', 'description': 'The audio sample rate (in Hz) of the original media.'},
              {'name': 'Audio Language', 'type': 'str', 'value': 'audio_language', 'description': 'The audio language of the original media.'},
              {'name': 'Audio Language Code', 'type': 'str', 'value': 'audio_language_code', 'description': 'The audio language code of the original media.'},
+             {'name': 'Audio Profile', 'type': 'str', 'value': 'audio_profile', 'description': 'The audio profile of the original media.'},
              {'name': 'Subtitle Codec', 'type': 'str', 'value': 'subtitle_codec', 'description': 'The subtitle codec of the original media.'},
              {'name': 'Subtitle Container', 'type': 'str', 'value': 'subtitle_container', 'description': 'The subtitle container of the original media.'},
              {'name': 'Subtitle Format', 'type': 'str', 'value': 'subtitle_format', 'description': 'The subtitle format of the original media.'},
diff --git a/plexpy/notification_handler.py b/plexpy/notification_handler.py
index ada7dcfb..15d34e0b 100644
--- a/plexpy/notification_handler.py
+++ b/plexpy/notification_handler.py
@@ -1082,6 +1082,7 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
         'stream_audio_sample_rate': notify_params['stream_audio_sample_rate'],
         'stream_audio_language': notify_params['stream_audio_language'],
         'stream_audio_language_code': notify_params['stream_audio_language_code'],
+        'stream_audio_profile': notify_params['stream_audio_profile'],
         'stream_subtitle_codec': notify_params['stream_subtitle_codec'],
         'stream_subtitle_container': notify_params['stream_subtitle_container'],
         'stream_subtitle_format': notify_params['stream_subtitle_format'],
@@ -1215,6 +1216,7 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
         'audio_sample_rate': notify_params['audio_sample_rate'],
         'audio_language': notify_params['audio_language'],
         'audio_language_code': notify_params['audio_language_code'],
+        'audio_profile': notify_params['audio_profile'],
         'subtitle_codec': notify_params['subtitle_codec'],
         'subtitle_container': notify_params['subtitle_container'],
         'subtitle_format': notify_params['subtitle_format'],
diff --git a/plexpy/pmsconnect.py b/plexpy/pmsconnect.py
index 46cd143e..ed115897 100644
--- a/plexpy/pmsconnect.py
+++ b/plexpy/pmsconnect.py
@@ -2096,6 +2096,7 @@ class PmsConnect(object):
                              'stream_audio_channel_layout_': stream_audio_channel_layouts_,
                              'stream_audio_language': helpers.get_xml_attr(audio_stream_info, 'language'),
                              'stream_audio_language_code': helpers.get_xml_attr(audio_stream_info, 'languageCode'),
+                             'stream_audio_profile': helpers.get_xml_attr(audio_stream_info, 'profile'),
                              'stream_audio_decision': helpers.get_xml_attr(audio_stream_info, 'decision') or 'direct play'
                              }
         else:
@@ -2108,6 +2109,7 @@ class PmsConnect(object):
                              'stream_audio_channel_layout_': '',
                              'stream_audio_language': '',
                              'stream_audio_language_code': '',
+                             'stream_audio_profile': '',
                              'stream_audio_decision': ''
                              }
 
diff --git a/plexpy/webserve.py b/plexpy/webserve.py
index 0349e6e8..3f8890cc 100644
--- a/plexpy/webserve.py
+++ b/plexpy/webserve.py
@@ -5921,6 +5921,7 @@ class WebInterface(object):
                              "stream_audio_decision": "direct play",
                              "stream_audio_language": "",
                              "stream_audio_language_code": "",
+                             "stream_audio_profile": "",
                              "stream_audio_sample_rate": "48000",
                              "stream_bitrate": "10617",
                              "stream_container": "mkv",

From e4d181ba5b7eeca08a488d358004fd65dbd82ab0 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Wed, 12 Mar 2025 21:40:38 -0700
Subject: [PATCH 715/743] Add PATCH method for webhooks

---
 plexpy/notifiers.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/plexpy/notifiers.py b/plexpy/notifiers.py
index 5f231a17..e12fa58f 100644
--- a/plexpy/notifiers.py
+++ b/plexpy/notifiers.py
@@ -4461,7 +4461,8 @@ class WEBHOOK(Notifier):
                           'select_options': {'GET': 'GET',
                                              'POST': 'POST',
                                              'PUT': 'PUT',
-                                             'DELETE': 'DELETE'}
+                                             'DELETE': 'DELETE',
+                                             'PATCH': 'PATCH'}
                           }
                          ]
 

From b3aa29c677bfeb6e29c63e5e28b3c59579d75cb6 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 23 Mar 2025 16:05:01 -0700
Subject: [PATCH 716/743] Swap source and stream columns in steam info modal

---
 data/interfaces/default/css/tautulli.css |  4 ++
 data/interfaces/default/stream_data.html | 81 ++++++++++++++++--------
 2 files changed, 60 insertions(+), 25 deletions(-)

diff --git a/data/interfaces/default/css/tautulli.css b/data/interfaces/default/css/tautulli.css
index 2835488d..5cb5d6bf 100644
--- a/data/interfaces/default/css/tautulli.css
+++ b/data/interfaces/default/css/tautulli.css
@@ -4325,6 +4325,10 @@ a:hover .overlay-refresh-image:hover {
 .stream-info tr:nth-child(even) td {
     background-color: rgba(255,255,255,0.010);
 }
+.stream-info td:nth-child(3),
+.stream-info th:nth-child(3) {
+    width: 25px;
+}
 .number-input {
     margin: 0 !important;
     width: 55px !important;
diff --git a/data/interfaces/default/stream_data.html b/data/interfaces/default/stream_data.html
index 9e42189b..a40bc54a 100644
--- a/data/interfaces/default/stream_data.html
+++ b/data/interfaces/default/stream_data.html
@@ -68,14 +68,14 @@ DOCUMENTATION :: END
             <table class="stream-info" style="margin-top: 0;">
                 <thead>
                     <tr>
-                        <th>
-                        </th>
-                        <th class="heading">
-                            Stream Details
-                        </th>
+                        <th></th>
                         <th class="heading">
                             Source Details
                         </th>
+                        <th><i class="fa fa-long-arrow-right"></i></th>
+                        <th class="heading">
+                            Stream Details
+                        </th>
                     </tr>
                 </thead>
             </table>
@@ -85,38 +85,46 @@ DOCUMENTATION :: END
                         <th>
                             Media
                         </th>
+                        <th></th>
+                        <th></th>
+                        <th></th>
                     </tr>
                 </thead>
                 <tbody>
                     <tr>
                         <td>Bitrate</td>
-                        <td>${data['stream_bitrate']} ${'kbps' if data['stream_bitrate'] else ''}</td>
                         <td>${data['bitrate']} ${'kbps' if data['bitrate'] else ''}</td>
+                        <td><i class="fa fa-long-arrow-right"></i></td>
+                        <td>${data['stream_bitrate']} ${'kbps' if data['stream_bitrate'] else ''}</td>
                     </tr>
                     % if data['media_type'] != 'track':
                     <tr>
                         <td>Resolution</td>
-                        <td>${data['stream_video_full_resolution']}</td>
                         <td>${data['video_full_resolution']}</td>
+                        <td><i class="fa fa-long-arrow-right"></i></td>
+                        <td>${data['stream_video_full_resolution']}</td>
                     </tr>
                     % endif
                     <tr>
                         <td>Quality</td>
-                        <td>${data['quality_profile']}</td>
                         <td>-</td>
+                        <td></td>
+                        <td>${data['quality_profile']}</td>
                     </tr>
                     % if data['optimized_version'] == 1:
                     <tr>
                         <td>Optimized Version</td>
-                        <td>-</td>
                         <td>${data['optimized_version_profile']}<br>(${data['optimized_version_title']})</td>
+                        <td></td>
+                        <td>-</td>
                     </tr>
                     % endif
                     % if data['synced_version'] == 1:
                     <tr>
                         <td>Synced Version</td>
-                        <td>-</td>
                         <td>${data['synced_version_profile']}</td>
+                        <td></td>
+                        <td>-</td>
                     </tr>
                     % endif
                 </tbody>
@@ -127,6 +135,8 @@ DOCUMENTATION :: END
                         <th>
                             Container
                         </th>
+                        <th></th>
+                        <th></th>
                         <th>
                             ${data['stream_container_decision']}
                         </th>
@@ -135,8 +145,9 @@ DOCUMENTATION :: END
                 <tbody>
                     <tr>
                         <td>Container</td>
-                        <td>${data['stream_container'].upper()}</td>
                         <td>${data['container'].upper()}</td>
+                        <td><i class="fa fa-long-arrow-right"></i></td>
+                        <td>${data['stream_container'].upper()}</td>
                     </tr>
                 </tbody>
             </table>
@@ -147,6 +158,8 @@ DOCUMENTATION :: END
                         <th>
                             Video
                         </th>
+                        <th></th>
+                        <th></th>
                         <th>
                             ${data['stream_video_decision']}
                         </th>
@@ -155,38 +168,45 @@ DOCUMENTATION :: END
                 <tbody>
                     <tr>
                         <td>Codec</td>
-                        <td>${data['stream_video_codec'].upper()} ${'(HW)' if data['transcode_hw_encoding'] else ''}</td>
                         <td>${data['video_codec'].upper()} ${'(HW)' if data['transcode_hw_decoding'] else ''}</td>
+                        <td><i class="fa fa-long-arrow-right"></i></td>
+                        <td>${data['stream_video_codec'].upper()} ${'(HW)' if data['transcode_hw_encoding'] else ''}</td>
                     </tr>
                     <tr>
                         <td>Bitrate</td>
-                        <td>${data['stream_video_bitrate']} ${'kbps' if data['stream_video_bitrate'] else ''}</td>
                         <td>${data['video_bitrate']} ${'kbps' if data['video_bitrate'] else ''}</td>
+                        <td><i class="fa fa-long-arrow-right"></i></td>
+                        <td>${data['stream_video_bitrate']} ${'kbps' if data['stream_video_bitrate'] else ''}</td>
                     </tr>
                     <tr>
                         <td>Width</td>
-                        <td>${data['stream_video_width']}</td>
                         <td>${data['video_width']}</td>
+                        <td><i class="fa fa-long-arrow-right"></i></td>
+                        <td>${data['stream_video_width']}</td>
                     </tr>
                     <tr>
                         <td>Height</td>
-                        <td>${data['stream_video_height']}</td>
                         <td>${data['video_height']}</td>
+                        <td><i class="fa fa-long-arrow-right"></i></td>
+                        <td>${data['stream_video_height']}</td>
                     </tr>
                     <tr>
                         <td>Framerate</td>
-                        <td>${data['stream_video_framerate']}</td>
                         <td>${data['video_framerate']}</td>
+                        <td><i class="fa fa-long-arrow-right"></i></td>
+                        <td>${data['stream_video_framerate']}</td>
                     </tr>
                     <tr>
                         <td>Dynamic Range</td>
-                        <td>${data['stream_video_dynamic_range']}</td>
                         <td>${data['video_dynamic_range']}</td>
+                        <td><i class="fa fa-long-arrow-right"></i></td>
+                        <td>${data['stream_video_dynamic_range']}</td>
                     </tr>
                     <tr>
                         <td>Aspect Ratio</td>
-                        <td>-</td>
                         <td>${data['aspect_ratio']}</td>
+                        <td></td>
+                        <td>-</td>
                     </tr>
                 </tbody>
             </table>
@@ -197,6 +217,8 @@ DOCUMENTATION :: END
                         <th>
                             Audio
                         </th>
+                        <th></th>
+                        <th></th>
                         <th>
                             ${data['stream_audio_decision']}
                         </th>
@@ -205,23 +227,27 @@ DOCUMENTATION :: END
                 <tbody>
                     <tr>
                         <td>Codec</td>
-                        <td>${AUDIO_CODEC_OVERRIDES.get(data['stream_audio_codec'], data['stream_audio_codec'].upper())}</td>
                         <td>${AUDIO_CODEC_OVERRIDES.get(data['audio_codec'], data['audio_codec'].upper())}</td>
+                        <td><i class="fa fa-long-arrow-right"></i></td>
+                        <td>${AUDIO_CODEC_OVERRIDES.get(data['stream_audio_codec'], data['stream_audio_codec'].upper())}</td>
                     </tr>
                     <tr>
                         <td>Bitrate</td>
-                        <td>${data['stream_audio_bitrate']} ${'kbps' if data['stream_audio_bitrate'] else ''}</td>
                         <td>${data['audio_bitrate']} ${'kbps' if data['audio_bitrate'] else ''}</td>
+                        <td><i class="fa fa-long-arrow-right"></i></td>
+                        <td>${data['stream_audio_bitrate']} ${'kbps' if data['stream_audio_bitrate'] else ''}</td>
                     </tr>
                     <tr>
                         <td>Channels</td>
-                        <td>${data['stream_audio_channels']}</td>
                         <td>${data['audio_channels']}</td>
+                        <td><i class="fa fa-long-arrow-right"></i></td>
+                        <td>${data['stream_audio_channels']}</td>
                     </tr>
                     <tr>
                         <td>Language</td>
-                        <td>-</td>
                         <td>${data['audio_language'] or 'Unknown'}</td>
+                        <td></td>
+                        <td>-</td>
                     </tr>
 
                 </tbody>
@@ -233,6 +259,8 @@ DOCUMENTATION :: END
                         <th>
                             Subtitles
                         </th>
+                        <th></th>
+                        <th></th>
                         <th>
                             ${'direct play' if data['stream_subtitle_decision'] not in ('transcode', 'copy', 'burn') else data['stream_subtitle_decision']}
                         </th>
@@ -241,19 +269,22 @@ DOCUMENTATION :: END
                 <tbody>
                     <tr>
                         <td>Codec</td>
-                        <td>${data['stream_subtitle_codec'].upper() or '-'}</td>
                         <td>${data['subtitle_codec'].upper()}</td>
+                        <td><i class="fa fa-long-arrow-right"></i></td>
+                        <td>${data['stream_subtitle_codec'].upper() or '-'}</td>
                     </tr>
                     <tr>
                         <td>Language</td>
-                        <td>-</td>
                         <td>${data['subtitle_language'] or 'Unknown'}</td>
+                        <td></td>
+                        <td>-</td>
                     </tr>
                     % if data['subtitle_forced']:
                     <tr>
                         <td>Forced</td>
-                        <td>-</td>
                         <td>${bool(data['subtitle_forced'])}</td>
+                        <td></td>
+                        <td>-</td>
                     </tr>
                     % endif
                 </tbody>

From cfc7b817b3fd092330192176e37186f82e110b7e Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 23 Mar 2025 16:19:54 -0700
Subject: [PATCH 717/743] Downgrade pyinstaller to 6.10.0

---
 package/requirements-package.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index 141b1a27..b6ad6d6f 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -2,7 +2,7 @@ apscheduler==3.10.1
 cryptography==43.0.3
 importlib-metadata==8.5.0
 importlib-resources==6.4.5
-pyinstaller==6.11.1
+pyinstaller==6.10.0
 pyopenssl==24.2.1
 
 pyobjc-core==10.3.1; platform_system == "Darwin"

From 09c28e434dd46b954a7149a0200d41c0a3d28a7e Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 23 Mar 2025 18:12:08 -0700
Subject: [PATCH 718/743] Check Pushover attachment under 5MB limit

Fixes #2396
---
 plexpy/notifiers.py | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/plexpy/notifiers.py b/plexpy/notifiers.py
index e12fa58f..21002dd2 100644
--- a/plexpy/notifiers.py
+++ b/plexpy/notifiers.py
@@ -3391,8 +3391,11 @@ class PUSHOVER(Notifier):
 
             image = pretty_metadata.get_image()
             if image:
-                files = {'attachment': image}
-                headers = {}
+                if len(image[1]) <= 5242880:  # 5MB max attachment size
+                    files = {'attachment': image}
+                    headers = {}
+                else:
+                    logger.warn("Tautulli Notifiers :: Image size exceeds 5MB limit for {name}.".format(name=self.NAME))
 
         return self.make_request('https://api.pushover.net/1/messages.json', headers=headers, data=data, files=files)
 

From ad2ec0e2bfd74bb22b5912dba6f75fa3345ad52d Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 23 Mar 2025 19:44:10 -0700
Subject: [PATCH 719/743] Fix CherryPy CORS response headers

Fixes #2279
---
 lib/cherrypy_cors/__init__.py | 255 ++++++++++++++++++++++++++++++++++
 plexpy/webstart.py            |   5 +-
 requirements.txt              |   1 +
 3 files changed, 260 insertions(+), 1 deletion(-)
 create mode 100644 lib/cherrypy_cors/__init__.py

diff --git a/lib/cherrypy_cors/__init__.py b/lib/cherrypy_cors/__init__.py
new file mode 100644
index 00000000..54003451
--- /dev/null
+++ b/lib/cherrypy_cors/__init__.py
@@ -0,0 +1,255 @@
+import re
+
+import cherrypy
+from cherrypy.lib import set_vary_header
+import httpagentparser
+
+
+CORS_ALLOW_METHODS = 'Access-Control-Allow-Methods'
+CORS_ALLOW_ORIGIN = 'Access-Control-Allow-Origin'
+CORS_ALLOW_CREDENTIALS = 'Access-Control-Allow-Credentials'
+CORS_EXPOSE_HEADERS = 'Access-Control-Expose-Headers'
+CORS_REQUEST_METHOD = 'Access-Control-Request-Method'
+CORS_REQUEST_HEADERS = 'Access-Control-Request-Headers'
+CORS_MAX_AGE = 'Access-Control-Max-Age'
+CORS_ALLOW_HEADERS = 'Access-Control-Allow-Headers'
+PUBLIC_ORIGIN = '*'
+
+
+def expose(allow_credentials=False, expose_headers=None, origins=None):
+    """Adds CORS support to the resource.
+
+    If the resource is allowed to be exposed, the value of the
+    `Access-Control-Allow-Origin`_ header in the response will echo
+    the `Origin`_ request header, and `Origin` will be
+    appended to the `Vary`_ response header.
+
+    :param allow_credentials: Use credentials to make cookies work
+                              (see `Access-Control-Allow-Credentials`_).
+    :type allow_credentials: bool
+    :param expose_headers: List of headers clients will be able to access
+                           (see `Access-Control-Expose-Headers`_).
+    :type expose_headers: list or None
+    :param origins: List of allowed origins clients must reference.
+    :type origins: list or None
+
+    :returns: Whether the resource is being exposed.
+    :rtype: bool
+
+    - Configuration example:
+
+        .. code-block:: python
+
+            config = {
+                '/static': {
+                    'tools.staticdir.on': True,
+                    'cors.expose.on': True,
+                }
+            }
+    - Decorator example:
+
+        .. code-block:: python
+
+            @cherrypy_cors.tools.expose()
+            def DELETE(self):
+                self._delete()
+
+    """
+    if _get_cors().expose(allow_credentials, expose_headers, origins):
+        _safe_caching_headers()
+        return True
+    return False
+
+
+def expose_public(expose_headers=None):
+    """Adds CORS support to the resource from any origin.
+
+    If the resource is allowed to be exposed, the value of the
+    `Access-Control-Allow-Origin`_ header in the response will be `*`.
+
+    :param expose_headers: List of headers clients will be able to access
+                           (see `Access-Control-Expose-Headers`_).
+    :type expose_headers: list or None
+
+    :rtype: None
+    """
+    _get_cors().expose_public(expose_headers)
+
+
+def preflight(
+    allowed_methods,
+    allowed_headers=None,
+    allow_credentials=False,
+    max_age=None,
+    origins=None,
+):
+    """Adds CORS `preflight`_ support to a `HTTP OPTIONS` request.
+
+    :param allowed_methods: List of supported `HTTP` methods
+                            (see `Access-Control-Allow-Methods`_).
+    :type allowed_methods: list or None
+    :param allowed_headers: List of supported `HTTP` headers
+                            (see `Access-Control-Allow-Headers`_).
+    :type allowed_headers: list or None
+    :param allow_credentials: Use credentials to make cookies work
+                              (see `Access-Control-Allow-Credentials`_).
+    :type allow_credentials: bool
+    :param max_age: Seconds to cache the preflight request
+                    (see `Access-Control-Max-Age`_).
+    :type max_age: int
+    :param origins: List of allowed origins clients must reference.
+    :type origins: list or None
+
+    :returns: Whether the preflight is allowed.
+    :rtype: bool
+
+    - Used as a decorator with the `Method Dispatcher`_
+
+        .. code-block:: python
+
+                @cherrypy_cors.tools.preflight(
+                    allowed_methods=["GET", "DELETE", "PUT"])
+                def OPTIONS(self):
+                    pass
+
+    - Function call with the `Object Dispatcher`_
+
+        .. code-block:: python
+
+                @cherrypy.expose
+                @cherrypy.tools.allow(
+                    methods=["GET", "DELETE", "PUT", "OPTIONS"])
+                def thing(self):
+                    if cherrypy.request.method == "OPTIONS":
+                        cherrypy_cors.preflight(
+                            allowed_methods=["GET", "DELETE", "PUT"])
+                    else:
+                        self._do_other_things()
+
+    """
+    if _get_cors().preflight(
+        allowed_methods, allowed_headers, allow_credentials, max_age, origins
+    ):
+        _safe_caching_headers()
+        return True
+    return False
+
+
+def install():
+    """Install the toolbox such that it's available in all applications."""
+    cherrypy._cptree.Application.toolboxes.update(cors=tools)
+
+
+class CORS:
+    """A generic CORS handler."""
+
+    def __init__(self, req_headers, resp_headers):
+        self.req_headers = req_headers
+        self.resp_headers = resp_headers
+
+    def expose(self, allow_credentials, expose_headers, origins):
+        if self._is_valid_origin(origins):
+            self._add_origin_and_credentials_headers(allow_credentials)
+            self._add_expose_headers(expose_headers)
+            return True
+        return False
+
+    def expose_public(self, expose_headers):
+        self._add_public_origin()
+        self._add_expose_headers(expose_headers)
+
+    def preflight(
+        self, allowed_methods, allowed_headers, allow_credentials, max_age, origins
+    ):
+        if self._is_valid_preflight_request(allowed_headers, allowed_methods, origins):
+            self._add_origin_and_credentials_headers(allow_credentials)
+            self._add_prefligt_headers(allowed_methods, max_age)
+            return True
+        return False
+
+    @property
+    def origin(self):
+        return self.req_headers.get('Origin')
+
+    def _is_valid_origin(self, origins):
+        if origins is None:
+            origins = [self.origin]
+        origins = map(self._make_regex, origins)
+        return self.origin is not None and any(
+            origin.match(self.origin) for origin in origins
+        )
+
+    @staticmethod
+    def _make_regex(pattern):
+        if isinstance(pattern, str):
+            pattern = re.compile(re.escape(pattern) + '$')
+        return pattern
+
+    def _add_origin_and_credentials_headers(self, allow_credentials):
+        self.resp_headers[CORS_ALLOW_ORIGIN] = self.origin
+        if allow_credentials:
+            self.resp_headers[CORS_ALLOW_CREDENTIALS] = 'true'
+
+    def _add_public_origin(self):
+        self.resp_headers[CORS_ALLOW_ORIGIN] = PUBLIC_ORIGIN
+
+    def _add_expose_headers(self, expose_headers):
+        if expose_headers:
+            self.resp_headers[CORS_EXPOSE_HEADERS] = expose_headers
+
+    @property
+    def requested_method(self):
+        return self.req_headers.get(CORS_REQUEST_METHOD)
+
+    @property
+    def requested_headers(self):
+        return self.req_headers.get(CORS_REQUEST_HEADERS)
+
+    def _has_valid_method(self, allowed_methods):
+        return self.requested_method and self.requested_method in allowed_methods
+
+    def _valid_headers(self, allowed_headers):
+        if self.requested_headers and allowed_headers:
+            for header in self.requested_headers.split(','):
+                if header.strip() not in allowed_headers:
+                    return False
+        return True
+
+    def _is_valid_preflight_request(self, allowed_headers, allowed_methods, origins):
+        return (
+            self._is_valid_origin(origins)
+            and self._has_valid_method(allowed_methods)
+            and self._valid_headers(allowed_headers)
+        )
+
+    def _add_prefligt_headers(self, allowed_methods, max_age):
+        rh = self.resp_headers
+        rh[CORS_ALLOW_METHODS] = ', '.join(allowed_methods)
+        if max_age:
+            rh[CORS_MAX_AGE] = max_age
+        if self.requested_headers:
+            rh[CORS_ALLOW_HEADERS] = self.requested_headers
+
+
+def _get_cors():
+    return CORS(cherrypy.serving.request.headers, cherrypy.serving.response.headers)
+
+
+def _safe_caching_headers():
+    """Adds `Origin`_ to the `Vary`_ header to ensure caching works properly.
+
+    Except in IE because it will disable caching completely. The caching
+    strategy in that case is out of the scope of this library.
+    https://blogs.msdn.microsoft.com/ieinternals/2009/06/17/vary-with-care/
+    """
+    uah = cherrypy.serving.request.headers.get('User-Agent', '')
+    ua = httpagentparser.detect(uah)
+    IE = 'Microsoft Internet Explorer'
+    if ua.get('browser', {}).get('name') != IE:
+        set_vary_header(cherrypy.serving.response, "Origin")
+
+
+tools = cherrypy._cptools.Toolbox("cors")
+tools.expose = cherrypy.Tool('before_handler', expose)
+tools.expose_public = cherrypy.Tool('before_handler', expose_public)
+tools.preflight = cherrypy.Tool('before_handler', preflight)
diff --git a/plexpy/webstart.py b/plexpy/webstart.py
index 1f3fb7ed..323c7e8e 100644
--- a/plexpy/webstart.py
+++ b/plexpy/webstart.py
@@ -21,6 +21,7 @@ import sys
 
 import cheroot.errors
 import cherrypy
+import cherrypy_cors
 
 import plexpy
 from plexpy import logger
@@ -62,6 +63,7 @@ def restart():
 
 
 def initialize(options):
+    cherrypy_cors.install()
 
     # HTTPS stuff stolen from sickbeard
     enable_https = options['enable_https']
@@ -91,7 +93,8 @@ def initialize(options):
         'server.socket_timeout': 60,
         'tools.encode.on': True,
         'tools.encode.encoding': 'utf-8',
-        'tools.decode.on': True
+        'tools.decode.on': True,
+        'cors.expose.on': True,
     }
 
     if plexpy.DEV:
diff --git a/requirements.txt b/requirements.txt
index 0bd14208..120b01ac 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -5,6 +5,7 @@ bleach==6.2.0
 certifi==2024.8.30
 cheroot==10.0.1
 cherrypy==18.10.0
+cherrypy-cors==1.7.0
 cloudinary==1.41.0
 distro==1.9.0
 dnspython==2.7.0

From 68dc095c835efd3e53e4bedc071cc66024541f22 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 23 Mar 2025 20:10:43 -0700
Subject: [PATCH 720/743] Do not redirect API requests to login page

Fixes #2490
---
 plexpy/webauth.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/plexpy/webauth.py b/plexpy/webauth.py
index c4b83ab7..67658d15 100644
--- a/plexpy/webauth.py
+++ b/plexpy/webauth.py
@@ -176,7 +176,10 @@ def check_auth(*args, **kwargs):
                     raise cherrypy.HTTPRedirect(plexpy.HTTP_ROOT)
 
         else:
-            redirect_uri = cherrypy.request.wsgi_environ['REQUEST_URI']
+            if cherrypy.request.headers.get('X-Requested-With') == 'XMLHttpRequest':
+                raise cherrypy.HTTPError(401)
+            
+            redirect_uri = cherrypy.request.path_info
             if redirect_uri:
                 redirect_uri = '?redirect_uri=' + quote(redirect_uri)
 

From 3e784c7495f5f7ccd0c358e4c1583af3a996ece3 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 23 Mar 2025 20:41:30 -0700
Subject: [PATCH 721/743] Check stream watched status before stopped status

Fixes #2506
---
 plexpy/activity_handler.py | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/plexpy/activity_handler.py b/plexpy/activity_handler.py
index 2758133b..8c10b922 100644
--- a/plexpy/activity_handler.py
+++ b/plexpy/activity_handler.py
@@ -314,6 +314,10 @@ class ActivityHandler(object):
             if self.metadata:
                 this_guid = self.metadata['guid']
 
+        # Check for stream offset notifications
+        self.check_markers()
+        self.check_watched()
+
         # Make sure the same item is being played
         if (self.rating_key == last_rating_key
                 or self.rating_key == last_rating_key_websocket
@@ -354,10 +358,6 @@ class ActivityHandler(object):
             self.on_stop(force_stop=True)
             self.on_start()
 
-        # Check for stream offset notifications
-        self.check_markers()
-        self.check_watched()
-    
     def check_markers(self):
         # Monitor if the stream has reached the intro or credit marker offsets
         self.get_metadata()

From 99e575383cc631a45a756354b62488051000b31f Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 24 Mar 2025 14:04:46 -0700
Subject: [PATCH 722/743] Bump pyopenssl from 24.2.1 to 25.0.0 (#2482)

Bumps [pyopenssl](https://github.com/pyca/pyopenssl) from 24.2.1 to 25.0.0.
- [Changelog](https://github.com/pyca/pyopenssl/blob/main/CHANGELOG.rst)
- [Commits](https://github.com/pyca/pyopenssl/compare/24.2.1...25.0.0)

---
updated-dependencies:
- dependency-name: pyopenssl
  dependency-type: direct:production
  update-type: version-update:semver-major
...

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

[skip ci]
---
 package/requirements-package.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index b6ad6d6f..785428a4 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -3,7 +3,7 @@ cryptography==43.0.3
 importlib-metadata==8.5.0
 importlib-resources==6.4.5
 pyinstaller==6.10.0
-pyopenssl==24.2.1
+pyopenssl==25.0.0
 
 pyobjc-core==10.3.1; platform_system == "Darwin"
 pyobjc-framework-Cocoa==10.3.1; platform_system == "Darwin"

From 74786f0ed1563fbcc1b254e48a8f30e421830b16 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Mon, 24 Mar 2025 14:05:05 -0700
Subject: [PATCH 723/743] Bump cryptography from 43.0.3 to 44.0.2 (#2519)

Bumps [cryptography](https://github.com/pyca/cryptography) from 43.0.3 to 44.0.2.
- [Changelog](https://github.com/pyca/cryptography/blob/main/CHANGELOG.rst)
- [Commits](https://github.com/pyca/cryptography/compare/43.0.3...44.0.2)

---
updated-dependencies:
- dependency-name: cryptography
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 package/requirements-package.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package/requirements-package.txt b/package/requirements-package.txt
index 785428a4..5837f631 100644
--- a/package/requirements-package.txt
+++ b/package/requirements-package.txt
@@ -1,5 +1,5 @@
 apscheduler==3.10.1
-cryptography==43.0.3
+cryptography==44.0.2
 importlib-metadata==8.5.0
 importlib-resources==6.4.5
 pyinstaller==6.10.0

From a876e006d6a8f0f1283629ef69a5651973a4503d Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 23 Mar 2025 21:29:18 -0700
Subject: [PATCH 724/743] Fix Trakt URL redirect to media page

Fixes #2513
---
 plexpy/notification_handler.py | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/plexpy/notification_handler.py b/plexpy/notification_handler.py
index 15d34e0b..0e30d6e2 100644
--- a/plexpy/notification_handler.py
+++ b/plexpy/notification_handler.py
@@ -684,23 +684,23 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
         thetvdb_media_type = 'movie' if notify_params['media_type'] == 'movie' else 'series'
         notify_params['thetvdb_id'] = notify_params['thetvdb_id'] or notify_params['guid'].split('thetvdb://')[1].split('/')[0].split('?')[0]
         notify_params['thetvdb_url'] = f'https://thetvdb.com/dereferrer/{thetvdb_media_type}/{notify_params["thetvdb_id"]}'
-        notify_params['trakt_url'] = 'https://trakt.tv/search/tvdb/' + notify_params['thetvdb_id'] + '?type=show'
+        notify_params['trakt_url'] = 'https://trakt.tv/search/tvdb/' + notify_params['thetvdb_id'] + '?id_type=show'
 
     elif 'thetvdbdvdorder://' in notify_params['guid']:
         notify_params['thetvdb_id'] = notify_params['guid'].split('thetvdbdvdorder://')[1].split('/')[0].split('?')[0]
         notify_params['thetvdb_url'] = f'https://thetvdb.com/dereferrer/series/{notify_params["thetvdb_id"]}'
-        notify_params['trakt_url'] = 'https://trakt.tv/search/tvdb/' + notify_params['thetvdb_id'] + '?type=show'
+        notify_params['trakt_url'] = 'https://trakt.tv/search/tvdb/' + notify_params['thetvdb_id'] + '?id_type=show'
 
     if 'themoviedb://' in notify_params['guid'] or notify_params['themoviedb_id']:
         if notify_params['media_type'] == 'movie':
             notify_params['themoviedb_id'] = notify_params['themoviedb_id'] or notify_params['guid'].split('themoviedb://')[1].split('?')[0]
             notify_params['themoviedb_url'] = 'https://www.themoviedb.org/movie/' + notify_params['themoviedb_id']
-            notify_params['trakt_url'] = 'https://trakt.tv/search/tmdb/' + notify_params['themoviedb_id'] + '?type=movie'
+            notify_params['trakt_url'] = 'https://trakt.tv/search/tmdb/' + notify_params['themoviedb_id'] + '?id_type=movie'
 
         elif notify_params['media_type'] in ('show', 'season', 'episode'):
             notify_params['themoviedb_id'] = notify_params['themoviedb_id'] or notify_params['guid'].split('themoviedb://')[1].split('/')[0].split('?')[0]
             notify_params['themoviedb_url'] = 'https://www.themoviedb.org/tv/' + notify_params['themoviedb_id']
-            notify_params['trakt_url'] = 'https://trakt.tv/search/tmdb/' + notify_params['themoviedb_id'] + '?type=show'
+            notify_params['trakt_url'] = 'https://trakt.tv/search/tmdb/' + notify_params['themoviedb_id'] + '?id_type=show'
 
     if 'lastfm://' in notify_params['guid']:
         notify_params['lastfm_id'] = '/'.join(notify_params['guid'].split('lastfm://')[1].split('?')[0].split('/')[:2])
@@ -765,7 +765,7 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
             if themoviedb_info.get('imdb_id'):
                 notify_params['imdb_url'] = 'https://www.imdb.com/title/' + themoviedb_info['imdb_id']
             if themoviedb_info.get('themoviedb_id'):
-                notify_params['trakt_url'] = 'https://trakt.tv/search/tmdb/{}?type={}'.format(
+                notify_params['trakt_url'] = 'https://trakt.tv/search/tmdb/{}?id_type={}'.format(
                     notify_params['themoviedb_id'], 'show' if lookup_media_type == 'tv' else 'movie')
 
     # Get TVmaze info (for tv shows only)
@@ -790,7 +790,7 @@ def build_media_notify_params(notify_action=None, session=None, timeline=None, m
 
             if tvmaze_info.get('thetvdb_id'):
                 notify_params['thetvdb_url'] = f'https://thetvdb.com/dereferrer/series/{tvmaze_info["thetvdb_id"]}'
-                notify_params['trakt_url'] = 'https://trakt.tv/search/tvdb/{}' + str(notify_params['thetvdb_id']) + '?type=show'
+                notify_params['trakt_url'] = 'https://trakt.tv/search/tvdb/{}' + str(notify_params['thetvdb_id']) + '?id_type=show'
             if tvmaze_info.get('imdb_id'):
                 notify_params['imdb_url'] = 'https://www.imdb.com/title/' + tvmaze_info['imdb_id']
                 notify_params['trakt_url'] = 'https://trakt.tv/search/imdb/' + notify_params['imdb_id']

From 24dd403a72d8e8f1db853e37ed0725e4a55770c9 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 24 Mar 2025 09:25:32 -0700
Subject: [PATCH 725/743] Activity card only link to library if section_id
 available

---
 data/interfaces/default/current_activity_instance.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/data/interfaces/default/current_activity_instance.html b/data/interfaces/default/current_activity_instance.html
index b1b7c3aa..64d6f25e 100644
--- a/data/interfaces/default/current_activity_instance.html
+++ b/data/interfaces/default/current_activity_instance.html
@@ -74,7 +74,7 @@ DOCUMENTATION :: END
     parent_href = page('info', data['parent_rating_key'])
     grandparent_href = page('info', data['grandparent_rating_key'])
     user_href = page('user', data['user_id']) if data['user_id'] else '#'
-    library_href = page('library', data['section_id'])
+    library_href = page('library', data['section_id']) if data['section_id'] else '#'
     season = short_season(data['parent_title'])
 %>
 <div class="dashboard-activity-instance" id="activity-instance-${sk}" data-key="${sk}" data-id="${data['session_id']}"

From e6c0a12dd5df8ac947fff04e9b458955b2eba506 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 30 Mar 2025 20:30:01 -0700
Subject: [PATCH 726/743] Add stream count to tab title on homepage

Closes #2517
---
 data/interfaces/default/index.html | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/data/interfaces/default/index.html b/data/interfaces/default/index.html
index 582ac93f..ca95be42 100644
--- a/data/interfaces/default/index.html
+++ b/data/interfaces/default/index.html
@@ -298,6 +298,8 @@
 
     $('#currentActivityHeader-bandwidth-tooltip').tooltip({ container: 'body', placement: 'right', delay: 50 });
 
+    var title = document.title;
+
     function getCurrentActivity() {
         activity_ready = false;
 
@@ -368,6 +370,8 @@
 
                     $('#currentActivityHeader').show();
 
+                    document.title = stream_count + ' stream' + (stream_count > 1 ? 's' : '') + ' | ' + title;
+
                     sessions.forEach(function (session) {
                         var s = (typeof Proxy === "function") ? new Proxy(session, defaultHandler) : session;
                         var key = s.session_key;
@@ -600,6 +604,8 @@
                 } else {
                     $('#currentActivityHeader').hide();
                     $('#currentActivity').html('<div id="dashboard-no-activity" class="text-muted">Nothing is currently being played.</div>');
+
+                    document.title = title;
                 }
 
                 activity_ready = true;

From d2a14ea6c020aefe12bc47b9e38946981a6774b1 Mon Sep 17 00:00:00 2001
From: Tom Niget <zippedfire@free.fr>
Date: Sun, 13 Apr 2025 00:58:28 +0200
Subject: [PATCH 727/743] Add hidden-by-default Total curve to the daily stream
 graph (#2497)

* Add hidden-by-default Total curve to the daily stream graph

* Update curve color

Co-authored-by: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>

---------

Co-authored-by: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
---
 data/interfaces/default/graphs.html | 7 ++++++-
 plexpy/graphs.py                    | 6 ++++++
 2 files changed, 12 insertions(+), 1 deletion(-)

diff --git a/data/interfaces/default/graphs.html b/data/interfaces/default/graphs.html
index 15a96a69..006d7ee9 100644
--- a/data/interfaces/default/graphs.html
+++ b/data/interfaces/default/graphs.html
@@ -301,6 +301,10 @@
             return obj;
         }, {});
 
+        if (!("Total" in chart_visibility)) {
+            chart_visibility["Total"] = false;
+        }
+
         return data_series.map(function(s) {
             var obj = Object.assign({}, s);
             obj.visible = (chart_visibility[s.name] !== false);
@@ -327,7 +331,8 @@
             'Direct Play': '#E5A00D',
             'Direct Stream': '#FFFFFF',
             'Transcode': '#F06464',
-            'Max. Concurrent Streams': '#96C83C'
+            'Max. Concurrent Streams': '#96C83C',
+            'Total': '#96C83C'
         };
         var series_colors = [];
         $.each(data_series, function(index, series) {
diff --git a/plexpy/graphs.py b/plexpy/graphs.py
index 70122aee..771b4eaf 100644
--- a/plexpy/graphs.py
+++ b/plexpy/graphs.py
@@ -138,6 +138,12 @@ class Graphs(object):
         if libraries.has_library_type('live'):
             series_output.append(series_4_output)
 
+        if len(series_output) > 0:
+            series_total = [sum(x) for x in zip(*[x['data'] for x in series_output])]
+            series_total_output = {'name': 'Total',
+                                   'data': series_total}
+            series_output.append(series_total_output)
+
         output = {'categories': categories,
                   'series': series_output}
         return output

From 76f6a2da6b3b394765203b7317cd97e7701a3067 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 12 Apr 2025 16:02:46 -0700
Subject: [PATCH 728/743] v2.15.2

---
 CHANGELOG.md      | 25 ++++++++++++++++++++++++-
 plexpy/version.py |  2 +-
 2 files changed, 25 insertions(+), 2 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 7ce76873..0cfe9f2c 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,28 @@
 # Changelog
 
+## v2.15.2 (2025-04-12)
+
+* Activity:
+  * New: Added link to library by clicking media type icon.
+  * New: Added stream count to tab title on homepage. (#2517)
+* History:
+  * Fix: Check stream watched status before stream stopped status. (#2506)
+* Notifications:
+  * Fix: ntfy notifications failing to send if provider link is blank.
+  * Fix: Check Pushover notification attachment is under 5MB limit. (#2396)
+  * Fix: Track URLs redirecting to the correct media page. (#2513)
+  * New: Added audio profile notification parameters.
+  * New: Added PATCH method for Webhook notifications.
+* Graphs:
+  * New: Added Total line to daily streams graph. (Thanks @zdimension) (#2497)
+* UI:
+  * Fix: Do not redirect API requests to the login page. (#2490)
+  * Change: Swap source and stream columns in stream info modal.
+* Other:
+  * Fix: Various typos. (Thanks @luzpaz) (#2520)
+  * Fix: CherryPy CORS response header not being set correctly. (#2279)
+
+
 ## v2.15.1 (2025-01-11)
 
 * Activity:
@@ -9,7 +32,7 @@
 * Exporter:
   * New: Added logos to season and episode exports.
 * Other:
-  * Fix Docker container https health check.
+  * Fix: Docker container https health check.
 
 
 ## v2.15.0 (2024-11-24)
diff --git a/plexpy/version.py b/plexpy/version.py
index b08e42da..a2a92f99 100644
--- a/plexpy/version.py
+++ b/plexpy/version.py
@@ -16,4 +16,4 @@
 #  along with Tautulli.  If not, see <http://www.gnu.org/licenses/>.
 
 PLEXPY_BRANCH = "master"
-PLEXPY_RELEASE_VERSION = "v2.15.1"
\ No newline at end of file
+PLEXPY_RELEASE_VERSION = "v2.15.2"
\ No newline at end of file

From 889026b092f9716238f8bfd8e99bc1b859a9611f Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 12 Apr 2025 16:56:10 -0700
Subject: [PATCH 729/743] Add auto sync winget fork to workflow

---
 .github/workflows/submit-winget.yml | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/.github/workflows/submit-winget.yml b/.github/workflows/submit-winget.yml
index 5385c1c3..efa6cee7 100644
--- a/.github/workflows/submit-winget.yml
+++ b/.github/workflows/submit-winget.yml
@@ -11,6 +11,11 @@ jobs:
     runs-on: windows-latest
     if: ${{ !github.event.release.prerelease }}
     steps:
+      - name: Sync Winget Fork
+        run: gh repo sync ${{ secrets.WINGET_USERNAME }}/winget-pkgs -b master
+        env:
+          GH_TOKEN: ${{ secrets.WINGET_TOKEN }}
+
       - name: Submit package to Windows Package Manager Community Repository
         run: |
           $wingetPackage = "Tautulli.Tautulli"

From e735294e1c14f380b73a853f6e25686aa133baff Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Fri, 18 Apr 2025 18:21:27 -0700
Subject: [PATCH 730/743] Uppercase ZIP archive export download tooltip

---
 data/interfaces/default/js/tables/export_table.js | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/data/interfaces/default/js/tables/export_table.js b/data/interfaces/default/js/tables/export_table.js
index 1d8a7b43..c0f6cf2f 100644
--- a/data/interfaces/default/js/tables/export_table.js
+++ b/data/interfaces/default/js/tables/export_table.js
@@ -162,7 +162,7 @@ export_table_options = {
                     var tooltip_title = '';
                     var icon = '';
                     if (rowData['thumb_level'] || rowData['art_level'] || rowData['logo_level'] || rowData['individual_files']) {
-                        tooltip_title = 'Zip Archive';
+                        tooltip_title = 'ZIP Archive';
                         icon = 'fa-file-archive';
                     } else {
                         tooltip_title = rowData['file_format'].toUpperCase() + ' File';

From cc88cffc1fd20b3bc1d558128e7aa5cf5cfbf4b7 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 3 May 2025 16:08:17 -0700
Subject: [PATCH 731/743] Fix retrieving history for collections/playlists with
 over 1000 items

---
 plexpy/datatables.py | 17 ++++++++++-------
 plexpy/webserve.py   |  8 ++++----
 2 files changed, 14 insertions(+), 11 deletions(-)

diff --git a/plexpy/datatables.py b/plexpy/datatables.py
index 0cc94760..49dedacc 100644
--- a/plexpy/datatables.py
+++ b/plexpy/datatables.py
@@ -144,14 +144,17 @@ def build_custom_where(custom_where=[]):
         and_or = ' OR ' if w[0].endswith('OR') else ' AND '
         w[0] = w[0].rstrip(' OR')
 
-        if isinstance(w[1], (list, tuple)) and len(w[1]):
+        if w[0].endswith(' IN') and isinstance(w[1], (list, tuple)) and len(w[1]):
+            c_where += w[0] + '(' + ','.join(['?'] * len(w[1])) + ')' + and_or
+            args += w[1]
+        elif isinstance(w[1], (list, tuple)) and len(w[1]):
             c_where += '('
             for w_ in w[1]:
                 if w_ is None:
                     c_where += w[0] + ' IS NULL'
-                elif str(w_).startswith('LIKE '):
-                    c_where += w[0] + ' LIKE ?'
-                    args.append(w_[5:])
+                elif w[0].endswith(' LIKE'):
+                    c_where += w[0] + ' ?'
+                    args.append(w_)
                 elif w[0].endswith('<') or w[0].endswith('>'):
                     c_where += w[0] + '= ?'
                     args.append(w_)
@@ -163,9 +166,9 @@ def build_custom_where(custom_where=[]):
         else:
             if w[1] is None:
                 c_where += w[0] + ' IS NULL'
-            elif str(w[1]).startswith('LIKE '):
-                c_where += w[0] + ' LIKE ?'
-                args.append(w[1][5:])
+            elif w[0].endswith(' LIKE'):
+                c_where += w[0] + ' ?'
+                args.append(w[1])
             elif w[0].endswith('<') or w[0].endswith('>'):
                 c_where += w[0] + '= ?'
                 args.append(w[1])
diff --git a/plexpy/webserve.py b/plexpy/webserve.py
index 3f8890cc..c402092f 100644
--- a/plexpy/webserve.py
+++ b/plexpy/webserve.py
@@ -1978,9 +1978,9 @@ class WebInterface(object):
                 pms_connect = pmsconnect.PmsConnect()
                 result = pms_connect.get_item_children(rating_key=kwargs.pop('rating_key'), media_type=kwargs.pop('media_type'))
                 rating_keys = [child['rating_key'] for child in result['children_list']]
-                custom_where.append(['session_history_metadata.rating_key OR', rating_keys])
-                custom_where.append(['session_history_metadata.parent_rating_key OR', rating_keys])
-                custom_where.append(['session_history_metadata.grandparent_rating_key OR', rating_keys])
+                custom_where.append(['session_history_metadata.rating_key IN OR', rating_keys])
+                custom_where.append(['session_history_metadata.parent_rating_key IN OR', rating_keys])
+                custom_where.append(['session_history_metadata.grandparent_rating_key IN OR', rating_keys])
             else:
                 rating_key = helpers.split_strip(kwargs.pop('rating_key', ''))
                 if rating_key:
@@ -2024,7 +2024,7 @@ class WebInterface(object):
         if 'guid' in kwargs:
             guid = helpers.split_strip(kwargs.pop('guid', '').split('?')[0])
             if guid:
-                custom_where.append(['session_history_metadata.guid', ['LIKE ' + g + '%' for g in guid]])
+                custom_where.append(['session_history_metadata.guid LIKE', [f"{g}%" for g in guid]])
 
         data_factory = datafactory.DataFactory()
         history = data_factory.get_datatables_history(kwargs=kwargs, custom_where=custom_where,

From ff5edc06fe7d7e161005dfb6809b173631fc1984 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 10 May 2025 15:56:52 -0700
Subject: [PATCH 732/743] Update crypto donation

---
 data/interfaces/default/base.html        | 50 +++++++++++++++++++++++-
 data/interfaces/default/css/tautulli.css | 22 ++++++++++-
 data/interfaces/default/settings.html    |  1 -
 3 files changed, 69 insertions(+), 4 deletions(-)

diff --git a/data/interfaces/default/base.html b/data/interfaces/default/base.html
index 5ff448b8..d6c9f859 100644
--- a/data/interfaces/default/base.html
+++ b/data/interfaces/default/base.html
@@ -234,7 +234,7 @@ ${next.modalIncludes()}
                     <li><a href="#patreon-donation" role="tab" data-toggle="tab">Patreon</a></li>
                     <li><a href="#stripe-donation" role="tab" data-toggle="tab">Stripe</a></li>
                     <li><a href="#paypal-donation" role="tab" data-toggle="tab">PayPal</a></li>
-                    <li><a href="#crypto-donation" role="tab" data-toggle="tab">Crypto</a></li>
+                    <li><a href="#crypto-donation" role="tab" data-toggle="tab" id="crypto-donation-tab">Crypto</a></li>
                 </ul>
                 <div class="tab-content">
                     <div role="tabpanel" class="tab-pane active" id="github-donation" style="text-align: center">
@@ -283,7 +283,16 @@ ${next.modalIncludes()}
                     </div>
                     <div role="tabpanel" class="tab-pane" id="crypto-donation" style="text-align: center">
                         <p>
-                            Click the button below to continue to Coinbase.
+                            Select a cryptocurrency.
+                        </p>
+                        <select class="form-control" id="crypto-select"></select>
+                        <div id="crypto-qrcode"></div>
+                        <div id="crypto-address" class="form-group">
+                            <label>Address:</label>
+                            <span class="inline-pre" id="crypto-address-value"></span>
+                        </div>
+                        <p>
+                            Or click the button below to continue to Coinbase.
                         </p>
                         <a href="${anon_url('https://commerce.coinbase.com/checkout/8a9fa08c-8a38-409e-9220-868124c4ba0c')}" target="_blank" rel="noreferrer" class="donate-with-crypto">
                             <span>Donate with Crypto</span>
@@ -331,6 +340,7 @@ ${next.modalIncludes()}
 <script src="${http_root}js/blurhash_pure_js_port.min.js"></script>
 <script src="${http_root}js/script.js${cache_param}"></script>
 <script src="${http_root}js/ajaxNotifications.js"></script>
+<script src="${http_root}js/kjua.min.js"></script>
 <script>
     % if _session['user_group'] == 'admin':
     $('body').on('click', '#updateDismiss', function() {
@@ -404,6 +414,42 @@ ${next.modalIncludes()}
         checkUpdate(function () { $('#nav-update').html('<i class="fa fa-fw fa-arrow-alt-circle-up"></i> Check for Updates'); });
     });
 
+    $('#crypto-donation-tab').one('shown.bs.tab', function (e) {
+        $.ajax({
+            url: 'https://tautulli.com/donate/crypto-addresses.json',
+            type: 'GET',
+            dataType: 'json',
+            cache: false,
+            async: true,
+            success: function (data) {
+                $('#crypto-select').empty().append('<option selected disabled>Select Cryptocurrency</option>');
+                $.each(data, function (index, crypto) {
+                    $('<option/>', {
+                        text: crypto.name + ' (' + crypto.symbol + ')',
+                        value: crypto.address
+                    }).appendTo('#crypto-select');
+                });
+            },
+            error: function () {
+                $('#crypto-select').empty().append('<option selected disabled>Error: Unable to load addresses</option>');
+            }
+        });
+    });
+
+    $('#crypto-select').change(function() {
+        var address = $(this).val();
+        $('#crypto-qrcode').empty().kjua({
+            text: address,
+            render: 'canvas',
+            ecLevel: 'H',
+            size: 256,
+            fill: '#000',
+            back: '#eee'
+        }).show();
+        $('#crypto-address-value').text(address);
+        $('#crypto-address').show();
+    })
+
     % endif
 
     $('.dropdown-toggle').click(function (e) {
diff --git a/data/interfaces/default/css/tautulli.css b/data/interfaces/default/css/tautulli.css
index 5cb5d6bf..ceb9b91c 100644
--- a/data/interfaces/default/css/tautulli.css
+++ b/data/interfaces/default/css/tautulli.css
@@ -4575,12 +4575,32 @@ a.donate-with-crypto::after {
     top: 0;
     left: 0;
 }
+#crypto-select {
+    width: 280px;
+    margin: 15px auto;
+}
+#crypto-qrcode {
+    width: 258px;
+    padding: 0;
+    margin: 15px auto;
+    line-height: 0;
+    text-align: center;
+    background-color: #eee;
+    border: 1px solid #ccc;
+    border-radius: 4px;
+    display: none;
+}
+#crypto-address {
+    margin: 15px auto;
+    text-align: center;
+    display: none;
+}
 
 #api_qr_code {
     width: 100%;
     padding: 0;
     margin: 0 0 10px;
-    line-height: 1;
+    line-height: 0;
     text-align: center;
     background-color: #eee;
     border: 1px solid #ccc;
diff --git a/data/interfaces/default/settings.html b/data/interfaces/default/settings.html
index 562a53af..9a25151e 100644
--- a/data/interfaces/default/settings.html
+++ b/data/interfaces/default/settings.html
@@ -2155,7 +2155,6 @@ Rating: {rating}/10   --> Rating: /10
 <script src="${http_root}js/parsley.min.js"></script>
 <script src="${http_root}js/Sortable.min.js"></script>
 <script src="${http_root}js/jquery.inputaffix.min.js"></script>
-<script src="${http_root}js/kjua.min.js"></script>
 <script>
     function getConfigurationTable() {
         $.ajax({

From 3cb71f94a3b9590bc809d8fc087095b53f2afa8a Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Sat, 10 May 2025 16:10:03 -0700
Subject: [PATCH 733/743] Bump plexapi from 4.16.1 to 4.17.0 (#2538)

Bumps [plexapi](https://github.com/pushingkarmaorg/python-plexapi) from 4.16.1 to 4.17.0.
- [Release notes](https://github.com/pushingkarmaorg/python-plexapi/releases)
- [Commits](https://github.com/pushingkarmaorg/python-plexapi/compare/4.16.1...4.17.0)

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

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[skip ci]
---
 requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements.txt b/requirements.txt
index 120b01ac..a34ae985 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -26,7 +26,7 @@ musicbrainzngs==0.7.1
 packaging==24.2
 paho-mqtt==2.1.0
 platformdirs==4.3.6
-plexapi==4.16.1
+plexapi==4.17.0
 portend==3.2.0
 profilehooks==1.13.0
 PyJWT==2.10.1

From f6bffe1850d4c05d491ebb440289c7de6343ed33 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 10 May 2025 16:13:23 -0700
Subject: [PATCH 734/743] Update plexapi==4.17.0

---
 lib/certifi/__init__.py                |   2 +-
 lib/certifi/cacert.pem                 | 497 ++++++-------------------
 lib/charset_normalizer/__init__.py     |   4 +-
 lib/charset_normalizer/__main__.py     |   2 +
 lib/charset_normalizer/api.py          |  60 +--
 lib/charset_normalizer/cd.py           |  68 ++--
 lib/charset_normalizer/cli/__init__.py |   2 +
 lib/charset_normalizer/cli/__main__.py |  75 +++-
 lib/charset_normalizer/constant.py     |  44 ++-
 lib/charset_normalizer/legacy.py       |   9 +-
 lib/charset_normalizer/md.py           |  81 ++--
 lib/charset_normalizer/models.py       |  79 ++--
 lib/charset_normalizer/utils.py        |  81 ++--
 lib/charset_normalizer/version.py      |   4 +-
 lib/plexapi/audio.py                   | 133 +++++--
 lib/plexapi/base.py                    | 129 +++++--
 lib/plexapi/client.py                  |  10 +-
 lib/plexapi/collection.py              |  51 ++-
 lib/plexapi/const.py                   |   4 +-
 lib/plexapi/library.py                 | 256 ++++++++-----
 lib/plexapi/media.py                   |  66 ++--
 lib/plexapi/myplex.py                  |  66 ++--
 lib/plexapi/photo.py                   |  32 +-
 lib/plexapi/playlist.py                |  93 ++---
 lib/plexapi/playqueue.py               |  19 +-
 lib/plexapi/server.py                  |  65 ++--
 lib/plexapi/settings.py                |   3 +-
 lib/plexapi/sonos.py                   |   1 -
 lib/plexapi/sync.py                    |   4 +-
 lib/plexapi/utils.py                   |  13 +-
 lib/plexapi/video.py                   | 235 +++++++++---
 requirements.txt                       |   2 +-
 32 files changed, 1224 insertions(+), 966 deletions(-)

diff --git a/lib/certifi/__init__.py b/lib/certifi/__init__.py
index f61d77fa..bf83fa93 100644
--- a/lib/certifi/__init__.py
+++ b/lib/certifi/__init__.py
@@ -1,4 +1,4 @@
 from .core import contents, where
 
 __all__ = ["contents", "where"]
-__version__ = "2024.08.30"
+__version__ = "2025.04.26"
diff --git a/lib/certifi/cacert.pem b/lib/certifi/cacert.pem
index 3c165a1b..b1d0cfd8 100644
--- a/lib/certifi/cacert.pem
+++ b/lib/certifi/cacert.pem
@@ -1,95 +1,4 @@
 
-# Issuer: CN=GlobalSign Root CA O=GlobalSign nv-sa OU=Root CA
-# Subject: CN=GlobalSign Root CA O=GlobalSign nv-sa OU=Root CA
-# Label: "GlobalSign Root CA"
-# Serial: 4835703278459707669005204
-# MD5 Fingerprint: 3e:45:52:15:09:51:92:e1:b7:5d:37:9f:b1:87:29:8a
-# SHA1 Fingerprint: b1:bc:96:8b:d4:f4:9d:62:2a:a8:9a:81:f2:15:01:52:a4:1d:82:9c
-# SHA256 Fingerprint: eb:d4:10:40:e4:bb:3e:c7:42:c9:e3:81:d3:1e:f2:a4:1a:48:b6:68:5c:96:e7:ce:f3:c1:df:6c:d4:33:1c:99
------BEGIN CERTIFICATE-----
-MIIDdTCCAl2gAwIBAgILBAAAAAABFUtaw5QwDQYJKoZIhvcNAQEFBQAwVzELMAkG
-A1UEBhMCQkUxGTAXBgNVBAoTEEdsb2JhbFNpZ24gbnYtc2ExEDAOBgNVBAsTB1Jv
-b3QgQ0ExGzAZBgNVBAMTEkdsb2JhbFNpZ24gUm9vdCBDQTAeFw05ODA5MDExMjAw
-MDBaFw0yODAxMjgxMjAwMDBaMFcxCzAJBgNVBAYTAkJFMRkwFwYDVQQKExBHbG9i
-YWxTaWduIG52LXNhMRAwDgYDVQQLEwdSb290IENBMRswGQYDVQQDExJHbG9iYWxT
-aWduIFJvb3QgQ0EwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDaDuaZ
-jc6j40+Kfvvxi4Mla+pIH/EqsLmVEQS98GPR4mdmzxzdzxtIK+6NiY6arymAZavp
-xy0Sy6scTHAHoT0KMM0VjU/43dSMUBUc71DuxC73/OlS8pF94G3VNTCOXkNz8kHp
-1Wrjsok6Vjk4bwY8iGlbKk3Fp1S4bInMm/k8yuX9ifUSPJJ4ltbcdG6TRGHRjcdG
-snUOhugZitVtbNV4FpWi6cgKOOvyJBNPc1STE4U6G7weNLWLBYy5d4ux2x8gkasJ
-U26Qzns3dLlwR5EiUWMWea6xrkEmCMgZK9FGqkjWZCrXgzT/LCrBbBlDSgeF59N8
-9iFo7+ryUp9/k5DPAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIBBjAPBgNVHRMBAf8E
-BTADAQH/MB0GA1UdDgQWBBRge2YaRQ2XyolQL30EzTSo//z9SzANBgkqhkiG9w0B
-AQUFAAOCAQEA1nPnfE920I2/7LqivjTFKDK1fPxsnCwrvQmeU79rXqoRSLblCKOz
-yj1hTdNGCbM+w6DjY1Ub8rrvrTnhQ7k4o+YviiY776BQVvnGCv04zcQLcFGUl5gE
-38NflNUVyRRBnMRddWQVDf9VMOyGj/8N7yy5Y0b2qvzfvGn9LhJIZJrglfCm7ymP
-AbEVtQwdpf5pLGkkeB6zpxxxYu7KyJesF12KwvhHhm4qxFYxldBniYUr+WymXUad
-DKqC5JlR3XC321Y9YeRq4VzW9v493kHMB65jUr9TU/Qr6cf9tveCX4XSQRjbgbME
-HMUfpIBvFSDJ3gyICh3WZlXi/EjJKSZp4A==
------END CERTIFICATE-----
-
-# Issuer: CN=Entrust.net Certification Authority (2048) O=Entrust.net OU=www.entrust.net/CPS_2048 incorp. by ref. (limits liab.)/(c) 1999 Entrust.net Limited
-# Subject: CN=Entrust.net Certification Authority (2048) O=Entrust.net OU=www.entrust.net/CPS_2048 incorp. by ref. (limits liab.)/(c) 1999 Entrust.net Limited
-# Label: "Entrust.net Premium 2048 Secure Server CA"
-# Serial: 946069240
-# MD5 Fingerprint: ee:29:31:bc:32:7e:9a:e6:e8:b5:f7:51:b4:34:71:90
-# SHA1 Fingerprint: 50:30:06:09:1d:97:d4:f5:ae:39:f7:cb:e7:92:7d:7d:65:2d:34:31
-# SHA256 Fingerprint: 6d:c4:71:72:e0:1c:bc:b0:bf:62:58:0d:89:5f:e2:b8:ac:9a:d4:f8:73:80:1e:0c:10:b9:c8:37:d2:1e:b1:77
------BEGIN CERTIFICATE-----
-MIIEKjCCAxKgAwIBAgIEOGPe+DANBgkqhkiG9w0BAQUFADCBtDEUMBIGA1UEChML
-RW50cnVzdC5uZXQxQDA+BgNVBAsUN3d3dy5lbnRydXN0Lm5ldC9DUFNfMjA0OCBp
-bmNvcnAuIGJ5IHJlZi4gKGxpbWl0cyBsaWFiLikxJTAjBgNVBAsTHChjKSAxOTk5
-IEVudHJ1c3QubmV0IExpbWl0ZWQxMzAxBgNVBAMTKkVudHJ1c3QubmV0IENlcnRp
-ZmljYXRpb24gQXV0aG9yaXR5ICgyMDQ4KTAeFw05OTEyMjQxNzUwNTFaFw0yOTA3
-MjQxNDE1MTJaMIG0MRQwEgYDVQQKEwtFbnRydXN0Lm5ldDFAMD4GA1UECxQ3d3d3
-LmVudHJ1c3QubmV0L0NQU18yMDQ4IGluY29ycC4gYnkgcmVmLiAobGltaXRzIGxp
-YWIuKTElMCMGA1UECxMcKGMpIDE5OTkgRW50cnVzdC5uZXQgTGltaXRlZDEzMDEG
-A1UEAxMqRW50cnVzdC5uZXQgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkgKDIwNDgp
-MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEArU1LqRKGsuqjIAcVFmQq
-K0vRvwtKTY7tgHalZ7d4QMBzQshowNtTK91euHaYNZOLGp18EzoOH1u3Hs/lJBQe
-sYGpjX24zGtLA/ECDNyrpUAkAH90lKGdCCmziAv1h3edVc3kw37XamSrhRSGlVuX
-MlBvPci6Zgzj/L24ScF2iUkZ/cCovYmjZy/Gn7xxGWC4LeksyZB2ZnuU4q941mVT
-XTzWnLLPKQP5L6RQstRIzgUyVYr9smRMDuSYB3Xbf9+5CFVghTAp+XtIpGmG4zU/
-HoZdenoVve8AjhUiVBcAkCaTvA5JaJG/+EfTnZVCwQ5N328mz8MYIWJmQ3DW1cAH
-4QIDAQABo0IwQDAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAdBgNV
-HQ4EFgQUVeSB0RGAvtiJuQijMfmhJAkWuXAwDQYJKoZIhvcNAQEFBQADggEBADub
-j1abMOdTmXx6eadNl9cZlZD7Bh/KM3xGY4+WZiT6QBshJ8rmcnPyT/4xmf3IDExo
-U8aAghOY+rat2l098c5u9hURlIIM7j+VrxGrD9cv3h8Dj1csHsm7mhpElesYT6Yf
-zX1XEC+bBAlahLVu2B064dae0Wx5XnkcFMXj0EyTO2U87d89vqbllRrDtRnDvV5b
-u/8j72gZyxKTJ1wDLW8w0B62GqzeWvfRqqgnpv55gcR5mTNXuhKwqeBCbJPKVt7+
-bYQLCIt+jerXmCHG8+c8eS9enNFMFY3h7CI3zJpDC5fcgJCNs2ebb0gIFVbPv/Er
-fF6adulZkMV8gzURZVE=
------END CERTIFICATE-----
-
-# Issuer: CN=Baltimore CyberTrust Root O=Baltimore OU=CyberTrust
-# Subject: CN=Baltimore CyberTrust Root O=Baltimore OU=CyberTrust
-# Label: "Baltimore CyberTrust Root"
-# Serial: 33554617
-# MD5 Fingerprint: ac:b6:94:a5:9c:17:e0:d7:91:52:9b:b1:97:06:a6:e4
-# SHA1 Fingerprint: d4:de:20:d0:5e:66:fc:53:fe:1a:50:88:2c:78:db:28:52:ca:e4:74
-# SHA256 Fingerprint: 16:af:57:a9:f6:76:b0:ab:12:60:95:aa:5e:ba:de:f2:2a:b3:11:19:d6:44:ac:95:cd:4b:93:db:f3:f2:6a:eb
------BEGIN CERTIFICATE-----
-MIIDdzCCAl+gAwIBAgIEAgAAuTANBgkqhkiG9w0BAQUFADBaMQswCQYDVQQGEwJJ
-RTESMBAGA1UEChMJQmFsdGltb3JlMRMwEQYDVQQLEwpDeWJlclRydXN0MSIwIAYD
-VQQDExlCYWx0aW1vcmUgQ3liZXJUcnVzdCBSb290MB4XDTAwMDUxMjE4NDYwMFoX
-DTI1MDUxMjIzNTkwMFowWjELMAkGA1UEBhMCSUUxEjAQBgNVBAoTCUJhbHRpbW9y
-ZTETMBEGA1UECxMKQ3liZXJUcnVzdDEiMCAGA1UEAxMZQmFsdGltb3JlIEN5YmVy
-VHJ1c3QgUm9vdDCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAKMEuyKr
-mD1X6CZymrV51Cni4eiVgLGw41uOKymaZN+hXe2wCQVt2yguzmKiYv60iNoS6zjr
-IZ3AQSsBUnuId9Mcj8e6uYi1agnnc+gRQKfRzMpijS3ljwumUNKoUMMo6vWrJYeK
-mpYcqWe4PwzV9/lSEy/CG9VwcPCPwBLKBsua4dnKM3p31vjsufFoREJIE9LAwqSu
-XmD+tqYF/LTdB1kC1FkYmGP1pWPgkAx9XbIGevOF6uvUA65ehD5f/xXtabz5OTZy
-dc93Uk3zyZAsuT3lySNTPx8kmCFcB5kpvcY67Oduhjprl3RjM71oGDHweI12v/ye
-jl0qhqdNkNwnGjkCAwEAAaNFMEMwHQYDVR0OBBYEFOWdWTCCR1jMrPoIVDaGezq1
-BE3wMBIGA1UdEwEB/wQIMAYBAf8CAQMwDgYDVR0PAQH/BAQDAgEGMA0GCSqGSIb3
-DQEBBQUAA4IBAQCFDF2O5G9RaEIFoN27TyclhAO992T9Ldcw46QQF+vaKSm2eT92
-9hkTI7gQCvlYpNRhcL0EYWoSihfVCr3FvDB81ukMJY2GQE/szKN+OMY3EU/t3Wgx
-jkzSswF07r51XgdIGn9w/xZchMB5hbgF/X++ZRGjD8ACtPhSNzkE1akxehi/oCr0
-Epn3o0WC4zxe9Z2etciefC7IpJ5OCBRLbf1wbWsaY71k5h+3zvDyny67G7fyUIhz
-ksLi4xaNmjICq44Y3ekQEe5+NauQrz4wlHrQMz2nZQ/1/I6eYs9HRCwBXbsdtTLS
-R9I4LtD+gdwyah617jzV/OeBHRnDJELqYzmp
------END CERTIFICATE-----
-
 # Issuer: CN=Entrust Root Certification Authority O=Entrust, Inc. OU=www.entrust.net/CPS is incorporated by reference/(c) 2006 Entrust, Inc.
 # Subject: CN=Entrust Root Certification Authority O=Entrust, Inc. OU=www.entrust.net/CPS is incorporated by reference/(c) 2006 Entrust, Inc.
 # Label: "Entrust Root Certification Authority"
@@ -125,39 +34,6 @@ eu6FSqdQgPCnXEqULl8FmTxSQeDNtGPPAUO6nIPcj2A781q0tHuu2guQOHXvgR1m
 0vdXcDazv/wor3ElhVsT/h5/WrQ8
 -----END CERTIFICATE-----
 
-# Issuer: CN=AAA Certificate Services O=Comodo CA Limited
-# Subject: CN=AAA Certificate Services O=Comodo CA Limited
-# Label: "Comodo AAA Services root"
-# Serial: 1
-# MD5 Fingerprint: 49:79:04:b0:eb:87:19:ac:47:b0:bc:11:51:9b:74:d0
-# SHA1 Fingerprint: d1:eb:23:a4:6d:17:d6:8f:d9:25:64:c2:f1:f1:60:17:64:d8:e3:49
-# SHA256 Fingerprint: d7:a7:a0:fb:5d:7e:27:31:d7:71:e9:48:4e:bc:de:f7:1d:5f:0c:3e:0a:29:48:78:2b:c8:3e:e0:ea:69:9e:f4
------BEGIN CERTIFICATE-----
-MIIEMjCCAxqgAwIBAgIBATANBgkqhkiG9w0BAQUFADB7MQswCQYDVQQGEwJHQjEb
-MBkGA1UECAwSR3JlYXRlciBNYW5jaGVzdGVyMRAwDgYDVQQHDAdTYWxmb3JkMRow
-GAYDVQQKDBFDb21vZG8gQ0EgTGltaXRlZDEhMB8GA1UEAwwYQUFBIENlcnRpZmlj
-YXRlIFNlcnZpY2VzMB4XDTA0MDEwMTAwMDAwMFoXDTI4MTIzMTIzNTk1OVowezEL
-MAkGA1UEBhMCR0IxGzAZBgNVBAgMEkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4GA1UE
-BwwHU2FsZm9yZDEaMBgGA1UECgwRQ29tb2RvIENBIExpbWl0ZWQxITAfBgNVBAMM
-GEFBQSBDZXJ0aWZpY2F0ZSBTZXJ2aWNlczCCASIwDQYJKoZIhvcNAQEBBQADggEP
-ADCCAQoCggEBAL5AnfRu4ep2hxxNRUSOvkbIgwadwSr+GB+O5AL686tdUIoWMQua
-BtDFcCLNSS1UY8y2bmhGC1Pqy0wkwLxyTurxFa70VJoSCsN6sjNg4tqJVfMiWPPe
-3M/vg4aijJRPn2jymJBGhCfHdr/jzDUsi14HZGWCwEiwqJH5YZ92IFCokcdmtet4
-YgNW8IoaE+oxox6gmf049vYnMlhvB/VruPsUK6+3qszWY19zjNoFmag4qMsXeDZR
-rOme9Hg6jc8P2ULimAyrL58OAd7vn5lJ8S3frHRNG5i1R8XlKdH5kBjHYpy+g8cm
-ez6KJcfA3Z3mNWgQIJ2P2N7Sw4ScDV7oL8kCAwEAAaOBwDCBvTAdBgNVHQ4EFgQU
-oBEKIz6W8Qfs4q8p74Klf9AwpLQwDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQF
-MAMBAf8wewYDVR0fBHQwcjA4oDagNIYyaHR0cDovL2NybC5jb21vZG9jYS5jb20v
-QUFBQ2VydGlmaWNhdGVTZXJ2aWNlcy5jcmwwNqA0oDKGMGh0dHA6Ly9jcmwuY29t
-b2RvLm5ldC9BQUFDZXJ0aWZpY2F0ZVNlcnZpY2VzLmNybDANBgkqhkiG9w0BAQUF
-AAOCAQEACFb8AvCb6P+k+tZ7xkSAzk/ExfYAWMymtrwUSWgEdujm7l3sAg9g1o1Q
-GE8mTgHj5rCl7r+8dFRBv/38ErjHT1r0iWAFf2C3BUrz9vHCv8S5dIa2LX1rzNLz
-Rt0vxuBqw8M0Ayx9lt1awg6nCpnBBYurDC/zXDrPbDdVCYfeU0BsWO/8tqtlbgT2
-G9w84FoVxp7Z8VlIMCFlA2zs6SFz7JsDoeA3raAVGI/6ugLOpyypEBMs1OUIJqsi
-l2D4kF501KKaU73yqWjgom7C12yxow+ev+to51byrvLjKzg6CYG1a4XXvi3tPxq3
-smPi9WIsgtRqAEFQ8TmDn5XpNpaYbg==
------END CERTIFICATE-----
-
 # Issuer: CN=QuoVadis Root CA 2 O=QuoVadis Limited
 # Subject: CN=QuoVadis Root CA 2 O=QuoVadis Limited
 # Label: "QuoVadis Root CA 2"
@@ -245,103 +121,6 @@ mJlglFwjz1onl14LBQaTNx47aTbrqZ5hHY8y2o4M1nQ+ewkk2gF3R8Q7zTSMmfXK
 4SVhM7JZG+Ju1zdXtg2pEto=
 -----END CERTIFICATE-----
 
-# Issuer: CN=XRamp Global Certification Authority O=XRamp Security Services Inc OU=www.xrampsecurity.com
-# Subject: CN=XRamp Global Certification Authority O=XRamp Security Services Inc OU=www.xrampsecurity.com
-# Label: "XRamp Global CA Root"
-# Serial: 107108908803651509692980124233745014957
-# MD5 Fingerprint: a1:0b:44:b3:ca:10:d8:00:6e:9d:0f:d8:0f:92:0a:d1
-# SHA1 Fingerprint: b8:01:86:d1:eb:9c:86:a5:41:04:cf:30:54:f3:4c:52:b7:e5:58:c6
-# SHA256 Fingerprint: ce:cd:dc:90:50:99:d8:da:df:c5:b1:d2:09:b7:37:cb:e2:c1:8c:fb:2c:10:c0:ff:0b:cf:0d:32:86:fc:1a:a2
------BEGIN CERTIFICATE-----
-MIIEMDCCAxigAwIBAgIQUJRs7Bjq1ZxN1ZfvdY+grTANBgkqhkiG9w0BAQUFADCB
-gjELMAkGA1UEBhMCVVMxHjAcBgNVBAsTFXd3dy54cmFtcHNlY3VyaXR5LmNvbTEk
-MCIGA1UEChMbWFJhbXAgU2VjdXJpdHkgU2VydmljZXMgSW5jMS0wKwYDVQQDEyRY
-UmFtcCBHbG9iYWwgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMDQxMTAxMTcx
-NDA0WhcNMzUwMTAxMDUzNzE5WjCBgjELMAkGA1UEBhMCVVMxHjAcBgNVBAsTFXd3
-dy54cmFtcHNlY3VyaXR5LmNvbTEkMCIGA1UEChMbWFJhbXAgU2VjdXJpdHkgU2Vy
-dmljZXMgSW5jMS0wKwYDVQQDEyRYUmFtcCBHbG9iYWwgQ2VydGlmaWNhdGlvbiBB
-dXRob3JpdHkwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCYJB69FbS6
-38eMpSe2OAtp87ZOqCwuIR1cRN8hXX4jdP5efrRKt6atH67gBhbim1vZZ3RrXYCP
-KZ2GG9mcDZhtdhAoWORlsH9KmHmf4MMxfoArtYzAQDsRhtDLooY2YKTVMIJt2W7Q
-DxIEM5dfT2Fa8OT5kavnHTu86M/0ay00fOJIYRyO82FEzG+gSqmUsE3a56k0enI4
-qEHMPJQRfevIpoy3hsvKMzvZPTeL+3o+hiznc9cKV6xkmxnr9A8ECIqsAxcZZPRa
-JSKNNCyy9mgdEm3Tih4U2sSPpuIjhdV6Db1q4Ons7Be7QhtnqiXtRYMh/MHJfNVi
-PvryxS3T/dRlAgMBAAGjgZ8wgZwwEwYJKwYBBAGCNxQCBAYeBABDAEEwCwYDVR0P
-BAQDAgGGMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFMZPoj0GY4QJnM5i5ASs
-jVy16bYbMDYGA1UdHwQvMC0wK6ApoCeGJWh0dHA6Ly9jcmwueHJhbXBzZWN1cml0
-eS5jb20vWEdDQS5jcmwwEAYJKwYBBAGCNxUBBAMCAQEwDQYJKoZIhvcNAQEFBQAD
-ggEBAJEVOQMBG2f7Shz5CmBbodpNl2L5JFMn14JkTpAuw0kbK5rc/Kh4ZzXxHfAR
-vbdI4xD2Dd8/0sm2qlWkSLoC295ZLhVbO50WfUfXN+pfTXYSNrsf16GBBEYgoyxt
-qZ4Bfj8pzgCT3/3JknOJiWSe5yvkHJEs0rnOfc5vMZnT5r7SHpDwCRR5XCOrTdLa
-IR9NmXmd4c8nnxCbHIgNsIpkQTG4DmyQJKSbXHGPurt+HBvbaoAPIbzp26a3QPSy
-i6mx5O+aGtA9aZnuqCij4Tyz8LIRnM98QObd50N9otg6tamN8jSZxNQQ4Qb9CYQQ
-O+7ETPTsJ3xCwnR8gooJybQDJbw=
------END CERTIFICATE-----
-
-# Issuer: O=The Go Daddy Group, Inc. OU=Go Daddy Class 2 Certification Authority
-# Subject: O=The Go Daddy Group, Inc. OU=Go Daddy Class 2 Certification Authority
-# Label: "Go Daddy Class 2 CA"
-# Serial: 0
-# MD5 Fingerprint: 91:de:06:25:ab:da:fd:32:17:0c:bb:25:17:2a:84:67
-# SHA1 Fingerprint: 27:96:ba:e6:3f:18:01:e2:77:26:1b:a0:d7:77:70:02:8f:20:ee:e4
-# SHA256 Fingerprint: c3:84:6b:f2:4b:9e:93:ca:64:27:4c:0e:c6:7c:1e:cc:5e:02:4f:fc:ac:d2:d7:40:19:35:0e:81:fe:54:6a:e4
------BEGIN CERTIFICATE-----
-MIIEADCCAuigAwIBAgIBADANBgkqhkiG9w0BAQUFADBjMQswCQYDVQQGEwJVUzEh
-MB8GA1UEChMYVGhlIEdvIERhZGR5IEdyb3VwLCBJbmMuMTEwLwYDVQQLEyhHbyBE
-YWRkeSBDbGFzcyAyIENlcnRpZmljYXRpb24gQXV0aG9yaXR5MB4XDTA0MDYyOTE3
-MDYyMFoXDTM0MDYyOTE3MDYyMFowYzELMAkGA1UEBhMCVVMxITAfBgNVBAoTGFRo
-ZSBHbyBEYWRkeSBHcm91cCwgSW5jLjExMC8GA1UECxMoR28gRGFkZHkgQ2xhc3Mg
-MiBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTCCASAwDQYJKoZIhvcNAQEBBQADggEN
-ADCCAQgCggEBAN6d1+pXGEmhW+vXX0iG6r7d/+TvZxz0ZWizV3GgXne77ZtJ6XCA
-PVYYYwhv2vLM0D9/AlQiVBDYsoHUwHU9S3/Hd8M+eKsaA7Ugay9qK7HFiH7Eux6w
-wdhFJ2+qN1j3hybX2C32qRe3H3I2TqYXP2WYktsqbl2i/ojgC95/5Y0V4evLOtXi
-EqITLdiOr18SPaAIBQi2XKVlOARFmR6jYGB0xUGlcmIbYsUfb18aQr4CUWWoriMY
-avx4A6lNf4DD+qta/KFApMoZFv6yyO9ecw3ud72a9nmYvLEHZ6IVDd2gWMZEewo+
-YihfukEHU1jPEX44dMX4/7VpkI+EdOqXG68CAQOjgcAwgb0wHQYDVR0OBBYEFNLE
-sNKR1EwRcbNhyz2h/t2oatTjMIGNBgNVHSMEgYUwgYKAFNLEsNKR1EwRcbNhyz2h
-/t2oatTjoWekZTBjMQswCQYDVQQGEwJVUzEhMB8GA1UEChMYVGhlIEdvIERhZGR5
-IEdyb3VwLCBJbmMuMTEwLwYDVQQLEyhHbyBEYWRkeSBDbGFzcyAyIENlcnRpZmlj
-YXRpb24gQXV0aG9yaXR5ggEAMAwGA1UdEwQFMAMBAf8wDQYJKoZIhvcNAQEFBQAD
-ggEBADJL87LKPpH8EsahB4yOd6AzBhRckB4Y9wimPQoZ+YeAEW5p5JYXMP80kWNy
-OO7MHAGjHZQopDH2esRU1/blMVgDoszOYtuURXO1v0XJJLXVggKtI3lpjbi2Tc7P
-TMozI+gciKqdi0FuFskg5YmezTvacPd+mSYgFFQlq25zheabIZ0KbIIOqPjCDPoQ
-HmyW74cNxA9hi63ugyuV+I6ShHI56yDqg+2DzZduCLzrTia2cyvk0/ZM/iZx4mER
-dEr/VxqHD3VILs9RaRegAhJhldXRQLIQTO7ErBBDpqWeCtWVYpoNz4iCxTIM5Cuf
-ReYNnyicsbkqWletNw+vHX/bvZ8=
------END CERTIFICATE-----
-
-# Issuer: O=Starfield Technologies, Inc. OU=Starfield Class 2 Certification Authority
-# Subject: O=Starfield Technologies, Inc. OU=Starfield Class 2 Certification Authority
-# Label: "Starfield Class 2 CA"
-# Serial: 0
-# MD5 Fingerprint: 32:4a:4b:bb:c8:63:69:9b:be:74:9a:c6:dd:1d:46:24
-# SHA1 Fingerprint: ad:7e:1c:28:b0:64:ef:8f:60:03:40:20:14:c3:d0:e3:37:0e:b5:8a
-# SHA256 Fingerprint: 14:65:fa:20:53:97:b8:76:fa:a6:f0:a9:95:8e:55:90:e4:0f:cc:7f:aa:4f:b7:c2:c8:67:75:21:fb:5f:b6:58
------BEGIN CERTIFICATE-----
-MIIEDzCCAvegAwIBAgIBADANBgkqhkiG9w0BAQUFADBoMQswCQYDVQQGEwJVUzEl
-MCMGA1UEChMcU3RhcmZpZWxkIFRlY2hub2xvZ2llcywgSW5jLjEyMDAGA1UECxMp
-U3RhcmZpZWxkIENsYXNzIDIgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMDQw
-NjI5MTczOTE2WhcNMzQwNjI5MTczOTE2WjBoMQswCQYDVQQGEwJVUzElMCMGA1UE
-ChMcU3RhcmZpZWxkIFRlY2hub2xvZ2llcywgSW5jLjEyMDAGA1UECxMpU3RhcmZp
-ZWxkIENsYXNzIDIgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwggEgMA0GCSqGSIb3
-DQEBAQUAA4IBDQAwggEIAoIBAQC3Msj+6XGmBIWtDBFk385N78gDGIc/oav7PKaf
-8MOh2tTYbitTkPskpD6E8J7oX+zlJ0T1KKY/e97gKvDIr1MvnsoFAZMej2YcOadN
-+lq2cwQlZut3f+dZxkqZJRRU6ybH838Z1TBwj6+wRir/resp7defqgSHo9T5iaU0
-X9tDkYI22WY8sbi5gv2cOj4QyDvvBmVmepsZGD3/cVE8MC5fvj13c7JdBmzDI1aa
-K4UmkhynArPkPw2vCHmCuDY96pzTNbO8acr1zJ3o/WSNF4Azbl5KXZnJHoe0nRrA
-1W4TNSNe35tfPe/W93bC6j67eA0cQmdrBNj41tpvi/JEoAGrAgEDo4HFMIHCMB0G
-A1UdDgQWBBS/X7fRzt0fhvRbVazc1xDCDqmI5zCBkgYDVR0jBIGKMIGHgBS/X7fR
-zt0fhvRbVazc1xDCDqmI56FspGowaDELMAkGA1UEBhMCVVMxJTAjBgNVBAoTHFN0
-YXJmaWVsZCBUZWNobm9sb2dpZXMsIEluYy4xMjAwBgNVBAsTKVN0YXJmaWVsZCBD
-bGFzcyAyIENlcnRpZmljYXRpb24gQXV0aG9yaXR5ggEAMAwGA1UdEwQFMAMBAf8w
-DQYJKoZIhvcNAQEFBQADggEBAAWdP4id0ckaVaGsafPzWdqbAYcaT1epoXkJKtv3
-L7IezMdeatiDh6GX70k1PncGQVhiv45YuApnP+yz3SFmH8lU+nLMPUxA2IGvd56D
-eruix/U0F47ZEUD0/CwqTRV/p2JdLiXTAAsgGh1o+Re49L2L7ShZ3U0WixeDyLJl
-xy16paq8U4Zt3VekyvggQQto8PT7dL5WXXp59fkdheMtlb71cZBDzI0fmgAKhynp
-VSJYACPq4xJDKVtHCN2MQWplBqjlIapBtJUhlbl90TSrE9atvNziPTnNvT51cKEY
-WQPJIrSPnNVeKtelttQKbfi3QBFGmh95DmK/D5fs4C8fF5Q=
------END CERTIFICATE-----
-
 # Issuer: CN=DigiCert Assured ID Root CA O=DigiCert Inc OU=www.digicert.com
 # Subject: CN=DigiCert Assured ID Root CA O=DigiCert Inc OU=www.digicert.com
 # Label: "DigiCert Assured ID Root CA"
@@ -474,47 +253,6 @@ ZMEBnunKoGqYDs/YYPIvSbjkQuE4NRb0yG5P94FW6LqjviOvrv1vA+ACOzB2+htt
 Qc8Bsem4yWb02ybzOqR08kkkW8mw0FfB+j564ZfJ
 -----END CERTIFICATE-----
 
-# Issuer: CN=SwissSign Silver CA - G2 O=SwissSign AG
-# Subject: CN=SwissSign Silver CA - G2 O=SwissSign AG
-# Label: "SwissSign Silver CA - G2"
-# Serial: 5700383053117599563
-# MD5 Fingerprint: e0:06:a1:c9:7d:cf:c9:fc:0d:c0:56:75:96:d8:62:13
-# SHA1 Fingerprint: 9b:aa:e5:9f:56:ee:21:cb:43:5a:be:25:93:df:a7:f0:40:d1:1d:cb
-# SHA256 Fingerprint: be:6c:4d:a2:bb:b9:ba:59:b6:f3:93:97:68:37:42:46:c3:c0:05:99:3f:a9:8f:02:0d:1d:ed:be:d4:8a:81:d5
------BEGIN CERTIFICATE-----
-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
------END CERTIFICATE-----
-
 # Issuer: CN=SecureTrust CA O=SecureTrust Corporation
 # Subject: CN=SecureTrust CA O=SecureTrust Corporation
 # Label: "SecureTrust CA"
@@ -763,35 +501,6 @@ uLjbvrW5KfnaNwUASZQDhETnv0Mxz3WLJdH0pmT1kvarBes96aULNmLazAZfNou2
 XjG4Kvte9nHfRCaexOYNkbQudZWAUWpLMKawYqGT8ZvYzsRjdT9ZR7E=
 -----END CERTIFICATE-----
 
-# Issuer: CN=SecureSign RootCA11 O=Japan Certification Services, Inc.
-# Subject: CN=SecureSign RootCA11 O=Japan Certification Services, Inc.
-# Label: "SecureSign RootCA11"
-# Serial: 1
-# MD5 Fingerprint: b7:52:74:e2:92:b4:80:93:f2:75:e4:cc:d7:f2:ea:26
-# SHA1 Fingerprint: 3b:c4:9f:48:f8:f3:73:a0:9c:1e:bd:f8:5b:b1:c3:65:c7:d8:11:b3
-# SHA256 Fingerprint: bf:0f:ee:fb:9e:3a:58:1a:d5:f9:e9:db:75:89:98:57:43:d2:61:08:5c:4d:31:4f:6f:5d:72:59:aa:42:16:12
------BEGIN CERTIFICATE-----
-MIIDbTCCAlWgAwIBAgIBATANBgkqhkiG9w0BAQUFADBYMQswCQYDVQQGEwJKUDEr
-MCkGA1UEChMiSmFwYW4gQ2VydGlmaWNhdGlvbiBTZXJ2aWNlcywgSW5jLjEcMBoG
-A1UEAxMTU2VjdXJlU2lnbiBSb290Q0ExMTAeFw0wOTA0MDgwNDU2NDdaFw0yOTA0
-MDgwNDU2NDdaMFgxCzAJBgNVBAYTAkpQMSswKQYDVQQKEyJKYXBhbiBDZXJ0aWZp
-Y2F0aW9uIFNlcnZpY2VzLCBJbmMuMRwwGgYDVQQDExNTZWN1cmVTaWduIFJvb3RD
-QTExMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA/XeqpRyQBTvLTJsz
-i1oURaTnkBbR31fSIRCkF/3frNYfp+TbfPfs37gD2pRY/V1yfIw/XwFndBWW4wI8
-h9uuywGOwvNmxoVF9ALGOrVisq/6nL+k5tSAMJjzDbaTj6nU2DbysPyKyiyhFTOV
-MdrAG/LuYpmGYz+/3ZMqg6h2uRMft85OQoWPIucuGvKVCbIFtUROd6EgvanyTgp9
-UK31BQ1FT0Zx/Sg+U/sE2C3XZR1KG/rPO7AxmjVuyIsG0wCR8pQIZUyxNAYAeoni
-8McDWc/V1uinMrPmmECGxc0nEovMe863ETxiYAcjPitAbpSACW22s293bzUIUPsC
-h8U+iQIDAQABo0IwQDAdBgNVHQ4EFgQUW/hNT7KlhtQ60vFjmqC+CfZXt94wDgYD
-VR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcNAQEFBQADggEB
-AKChOBZmLqdWHyGcBvod7bkixTgm2E5P7KN/ed5GIaGHd48HCJqypMWvDzKYC3xm
-KbabfSVSSUOrTC4rbnpwrxYO4wJs+0LmGJ1F2FXI6Dvd5+H0LgscNFxsWEr7jIhQ
-X5Ucv+2rIrVls4W6ng+4reV6G4pQOh29Dbx7VFALuUKvVaAYga1lme++5Jy/xIWr
-QbJUb9wlze144o4MjQlJ3WN7WmmWAiGovVJZ6X01y8hSyn+B/tlr0/cR7SXf+Of5
-pPpyl4RTDaXQMhhRdlkUbA/r7F+AjHVDg8OFmP9Mni0N5HeDk061lgeLKBObjBmN
-QSdJQO7e5iNEOdyhIta6A/I=
------END CERTIFICATE-----
-
 # Issuer: CN=Microsec e-Szigno Root CA 2009 O=Microsec Ltd.
 # Subject: CN=Microsec e-Szigno Root CA 2009 O=Microsec Ltd.
 # Label: "Microsec e-Szigno Root CA 2009"
@@ -3100,50 +2809,6 @@ LJstxabArahH9CdMOA0uG0k7UvToiIMrVCjU8jVStDKDYmlkDJGcn5fqdBb9HxEG
 mpv0
 -----END CERTIFICATE-----
 
-# Issuer: CN=Entrust Root Certification Authority - G4 O=Entrust, Inc. OU=See www.entrust.net/legal-terms/(c) 2015 Entrust, Inc. - for authorized use only
-# Subject: CN=Entrust Root Certification Authority - G4 O=Entrust, Inc. OU=See www.entrust.net/legal-terms/(c) 2015 Entrust, Inc. - for authorized use only
-# Label: "Entrust Root Certification Authority - G4"
-# Serial: 289383649854506086828220374796556676440
-# MD5 Fingerprint: 89:53:f1:83:23:b7:7c:8e:05:f1:8c:71:38:4e:1f:88
-# SHA1 Fingerprint: 14:88:4e:86:26:37:b0:26:af:59:62:5c:40:77:ec:35:29:ba:96:01
-# SHA256 Fingerprint: db:35:17:d1:f6:73:2a:2d:5a:b9:7c:53:3e:c7:07:79:ee:32:70:a6:2f:b4:ac:42:38:37:24:60:e6:f0:1e:88
------BEGIN CERTIFICATE-----
-MIIGSzCCBDOgAwIBAgIRANm1Q3+vqTkPAAAAAFVlrVgwDQYJKoZIhvcNAQELBQAw
-gb4xCzAJBgNVBAYTAlVTMRYwFAYDVQQKEw1FbnRydXN0LCBJbmMuMSgwJgYDVQQL
-Ex9TZWUgd3d3LmVudHJ1c3QubmV0L2xlZ2FsLXRlcm1zMTkwNwYDVQQLEzAoYykg
-MjAxNSBFbnRydXN0LCBJbmMuIC0gZm9yIGF1dGhvcml6ZWQgdXNlIG9ubHkxMjAw
-BgNVBAMTKUVudHJ1c3QgUm9vdCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eSAtIEc0
-MB4XDTE1MDUyNzExMTExNloXDTM3MTIyNzExNDExNlowgb4xCzAJBgNVBAYTAlVT
-MRYwFAYDVQQKEw1FbnRydXN0LCBJbmMuMSgwJgYDVQQLEx9TZWUgd3d3LmVudHJ1
-c3QubmV0L2xlZ2FsLXRlcm1zMTkwNwYDVQQLEzAoYykgMjAxNSBFbnRydXN0LCBJ
-bmMuIC0gZm9yIGF1dGhvcml6ZWQgdXNlIG9ubHkxMjAwBgNVBAMTKUVudHJ1c3Qg
-Um9vdCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eSAtIEc0MIICIjANBgkqhkiG9w0B
-AQEFAAOCAg8AMIICCgKCAgEAsewsQu7i0TD/pZJH4i3DumSXbcr3DbVZwbPLqGgZ
-2K+EbTBwXX7zLtJTmeH+H17ZSK9dE43b/2MzTdMAArzE+NEGCJR5WIoV3imz/f3E
-T+iq4qA7ec2/a0My3dl0ELn39GjUu9CH1apLiipvKgS1sqbHoHrmSKvS0VnM1n4j
-5pds8ELl3FFLFUHtSUrJ3hCX1nbB76W1NhSXNdh4IjVS70O92yfbYVaCNNzLiGAM
-C1rlLAHGVK/XqsEQe9IFWrhAnoanw5CGAlZSCXqc0ieCU0plUmr1POeo8pyvi73T
-DtTUXm6Hnmo9RR3RXRv06QqsYJn7ibT/mCzPfB3pAqoEmh643IhuJbNsZvc8kPNX
-wbMv9W3y+8qh+CmdRouzavbmZwe+LGcKKh9asj5XxNMhIWNlUpEbsZmOeX7m640A
-2Vqq6nPopIICR5b+W45UYaPrL0swsIsjdXJ8ITzI9vF01Bx7owVV7rtNOzK+mndm
-nqxpkCIHH2E6lr7lmk/MBTwoWdPBDFSoWWG9yHJM6Nyfh3+9nEg2XpWjDrk4JFX8
-dWbrAuMINClKxuMrLzOg2qOGpRKX/YAr2hRC45K9PvJdXmd0LhyIRyk0X+IyqJwl
-N4y6mACXi0mWHv0liqzc2thddG5msP9E36EYxr5ILzeUePiVSj9/E15dWf10hkNj
-c0kCAwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYD
-VR0OBBYEFJ84xFYjwznooHFs6FRM5Og6sb9nMA0GCSqGSIb3DQEBCwUAA4ICAQAS
-5UKme4sPDORGpbZgQIeMJX6tuGguW8ZAdjwD+MlZ9POrYs4QjbRaZIxowLByQzTS
-Gwv2LFPSypBLhmb8qoMi9IsabyZIrHZ3CL/FmFz0Jomee8O5ZDIBf9PD3Vht7LGr
-hFV0d4QEJ1JrhkzO3bll/9bGXp+aEJlLdWr+aumXIOTkdnrG0CSqkM0gkLpHZPt/
-B7NTeLUKYvJzQ85BK4FqLoUWlFPUa19yIqtRLULVAJyZv967lDtX/Zr1hstWO1uI
-AeV8KEsD+UmDfLJ/fOPtjqF/YFOOVZ1QNBIPt5d7bIdKROf1beyAN/BYGW5KaHbw
-H5Lk6rWS02FREAutp9lfx1/cH6NcjKF+m7ee01ZvZl4HliDtC3T7Zk6LERXpgUl+
-b7DUUH8i119lAg2m9IUe2K4GS0qn0jFmwvjO5QimpAKWRGhXxNUzzxkvFMSUHHuk
-2fCfDrGA4tGeEWSpiBE6doLlYsKA2KSD7ZPvfC+QsDJMlhVoSFLUmQjAJOgc47Ol
-IQ6SwJAfzyBfyjs4x7dtOvPmRLgOMWuIjnDrnBdSqEGULoe256YSxXXfW8AKbnuk
-5F6G+TaU33fD6Q3AOfF5u0aOq0NZJ7cguyPpVkAh7DE9ZapD8j3fcEThuk0mEDuY
-n/PIjhs4ViFqUZPTkcpG2om3PVODLAgfi49T3f+sHw==
------END CERTIFICATE-----
-
 # Issuer: CN=Microsoft ECC Root Certificate Authority 2017 O=Microsoft Corporation
 # Subject: CN=Microsoft ECC Root Certificate Authority 2017 O=Microsoft Corporation
 # Label: "Microsoft ECC Root Certificate Authority 2017"
@@ -3485,6 +3150,46 @@ DgQWBBQxCpCPtsad0kRLgLWi5h+xEk8blTAKBggqhkjOPQQDAwNoADBlAjEA31SQ
 +RHUjE7AwWHCFUyqqx0LMV87HOIAl0Qx5v5zli/altP+CAezNIm8BZ/3Hobui3A=
 -----END CERTIFICATE-----
 
+# Issuer: CN=GLOBALTRUST 2020 O=e-commerce monitoring GmbH
+# Subject: CN=GLOBALTRUST 2020 O=e-commerce monitoring GmbH
+# Label: "GLOBALTRUST 2020"
+# Serial: 109160994242082918454945253
+# MD5 Fingerprint: 8a:c7:6f:cb:6d:e3:cc:a2:f1:7c:83:fa:0e:78:d7:e8
+# SHA1 Fingerprint: d0:67:c1:13:51:01:0c:aa:d0:c7:6a:65:37:31:16:26:4f:53:71:a2
+# SHA256 Fingerprint: 9a:29:6a:51:82:d1:d4:51:a2:e3:7f:43:9b:74:da:af:a2:67:52:33:29:f9:0f:9a:0d:20:07:c3:34:e2:3c:9a
+-----BEGIN CERTIFICATE-----
+MIIFgjCCA2qgAwIBAgILWku9WvtPilv6ZeUwDQYJKoZIhvcNAQELBQAwTTELMAkG
+A1UEBhMCQVQxIzAhBgNVBAoTGmUtY29tbWVyY2UgbW9uaXRvcmluZyBHbWJIMRkw
+FwYDVQQDExBHTE9CQUxUUlVTVCAyMDIwMB4XDTIwMDIxMDAwMDAwMFoXDTQwMDYx
+MDAwMDAwMFowTTELMAkGA1UEBhMCQVQxIzAhBgNVBAoTGmUtY29tbWVyY2UgbW9u
+aXRvcmluZyBHbWJIMRkwFwYDVQQDExBHTE9CQUxUUlVTVCAyMDIwMIICIjANBgkq
+hkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAri5WrRsc7/aVj6B3GyvTY4+ETUWiD59b
+RatZe1E0+eyLinjF3WuvvcTfk0Uev5E4C64OFudBc/jbu9G4UeDLgztzOG53ig9Z
+YybNpyrOVPu44sB8R85gfD+yc/LAGbaKkoc1DZAoouQVBGM+uq/ufF7MpotQsjj3
+QWPKzv9pj2gOlTblzLmMCcpL3TGQlsjMH/1WljTbjhzqLL6FLmPdqqmV0/0plRPw
+yJiT2S0WR5ARg6I6IqIoV6Lr/sCMKKCmfecqQjuCgGOlYx8ZzHyyZqjC0203b+J+
+BlHZRYQfEs4kUmSFC0iAToexIiIwquuuvuAC4EDosEKAA1GqtH6qRNdDYfOiaxaJ
+SaSjpCuKAsR49GiKweR6NrFvG5Ybd0mN1MkGco/PU+PcF4UgStyYJ9ORJitHHmkH
+r96i5OTUawuzXnzUJIBHKWk7buis/UDr2O1xcSvy6Fgd60GXIsUf1DnQJ4+H4xj0
+4KlGDfV0OoIu0G4skaMxXDtG6nsEEFZegB31pWXogvziB4xiRfUg3kZwhqG8k9Me
+dKZssCz3AwyIDMvUclOGvGBG85hqwvG/Q/lwIHfKN0F5VVJjjVsSn8VoxIidrPIw
+q7ejMZdnrY8XD2zHc+0klGvIg5rQmjdJBKuxFshsSUktq6HQjJLyQUp5ISXbY9e2
+nKd+Qmn7OmMCAwEAAaNjMGEwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMC
+AQYwHQYDVR0OBBYEFNwuH9FhN3nkq9XVsxJxaD1qaJwiMB8GA1UdIwQYMBaAFNwu
+H9FhN3nkq9XVsxJxaD1qaJwiMA0GCSqGSIb3DQEBCwUAA4ICAQCR8EICaEDuw2jA
+VC/f7GLDw56KoDEoqoOOpFaWEhCGVrqXctJUMHytGdUdaG/7FELYjQ7ztdGl4wJC
+XtzoRlgHNQIw4Lx0SsFDKv/bGtCwr2zD/cuz9X9tAy5ZVp0tLTWMstZDFyySCstd
+6IwPS3BD0IL/qMy/pJTAvoe9iuOTe8aPmxadJ2W8esVCgmxcB9CpwYhgROmYhRZf
++I/KARDOJcP5YBugxZfD0yyIMaK9MOzQ0MAS8cE54+X1+NZK3TTN+2/BT+MAi1bi
+kvcoskJ3ciNnxz8RFbLEAwW+uxF7Cr+obuf/WEPPm2eggAe2HcqtbepBEX4tdJP7
+wry+UUTF72glJ4DjyKDUEuzZpTcdN3y0kcra1LGWge9oXHYQSa9+pTeAsRxSvTOB
+TI/53WXZFM2KJVj04sWDpQmQ1GwUY7VA3+vA/MRYfg0UFodUJ25W5HCEuGwyEn6C
+MUO+1918oa2u1qsgEu8KwxCMSZY13At1XrFP1U80DhEgB3VDRemjEdqso5nCtnkn
+4rnvyOL2NSl6dPrFf4IFYqYK6miyeUcGbvJXqBUzxvd4Sj1Ce2t+/vdG6tHrju+I
+aFvowdlxfv1k7/9nR4hYJS8+hge9+6jlgqispdNpQ80xiEmEU5LAsTkbOYMBMMTy
+qfrQA71yN2BWHzZ8vTmR9W0Nv3vXkg==
+-----END CERTIFICATE-----
+
 # Issuer: CN=ANF Secure Server Root CA O=ANF Autoridad de Certificacion OU=ANF CA Raiz
 # Subject: CN=ANF Secure Server Root CA O=ANF Autoridad de Certificacion OU=ANF CA Raiz
 # Label: "ANF Secure Server Root CA"
@@ -4214,46 +3919,6 @@ ut6Dacpps6kFtZaSF4fC0urQe87YQVt8rgIwRt7qy12a7DLCZRawTDBcMPPaTnOG
 BtjOiQRINzf43TNRnXCve1XYAS59BWQOhriR
 -----END CERTIFICATE-----
 
-# Issuer: CN=Security Communication RootCA3 O=SECOM Trust Systems CO.,LTD.
-# Subject: CN=Security Communication RootCA3 O=SECOM Trust Systems CO.,LTD.
-# Label: "Security Communication RootCA3"
-# Serial: 16247922307909811815
-# MD5 Fingerprint: 1c:9a:16:ff:9e:5c:e0:4d:8a:14:01:f4:35:5d:29:26
-# SHA1 Fingerprint: c3:03:c8:22:74:92:e5:61:a2:9c:5f:79:91:2b:1e:44:13:91:30:3a
-# SHA256 Fingerprint: 24:a5:5c:2a:b0:51:44:2d:06:17:76:65:41:23:9a:4a:d0:32:d7:c5:51:75:aa:34:ff:de:2f:bc:4f:5c:52:94
------BEGIN CERTIFICATE-----
-MIIFfzCCA2egAwIBAgIJAOF8N0D9G/5nMA0GCSqGSIb3DQEBDAUAMF0xCzAJBgNV
-BAYTAkpQMSUwIwYDVQQKExxTRUNPTSBUcnVzdCBTeXN0ZW1zIENPLixMVEQuMScw
-JQYDVQQDEx5TZWN1cml0eSBDb21tdW5pY2F0aW9uIFJvb3RDQTMwHhcNMTYwNjE2
-MDYxNzE2WhcNMzgwMTE4MDYxNzE2WjBdMQswCQYDVQQGEwJKUDElMCMGA1UEChMc
-U0VDT00gVHJ1c3QgU3lzdGVtcyBDTy4sTFRELjEnMCUGA1UEAxMeU2VjdXJpdHkg
-Q29tbXVuaWNhdGlvbiBSb290Q0EzMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC
-CgKCAgEA48lySfcw3gl8qUCBWNO0Ot26YQ+TUG5pPDXC7ltzkBtnTCHsXzW7OT4r
-CmDvu20rhvtxosis5FaU+cmvsXLUIKx00rgVrVH+hXShuRD+BYD5UpOzQD11EKzA
-lrenfna84xtSGc4RHwsENPXY9Wk8d/Nk9A2qhd7gCVAEF5aEt8iKvE1y/By7z/MG
-TfmfZPd+pmaGNXHIEYBMwXFAWB6+oHP2/D5Q4eAvJj1+XCO1eXDe+uDRpdYMQXF7
-9+qMHIjH7Iv10S9VlkZ8WjtYO/u62C21Jdp6Ts9EriGmnpjKIG58u4iFW/vAEGK7
-8vknR+/RiTlDxN/e4UG/VHMgly1s2vPUB6PmudhvrvyMGS7TZ2crldtYXLVqAvO4
-g160a75BflcJdURQVc1aEWEhCmHCqYj9E7wtiS/NYeCVvsq1e+F7NGcLH7YMx3we
-GVPKp7FKFSBWFHA9K4IsD50VHUeAR/94mQ4xr28+j+2GaR57GIgUssL8gjMunEst
-+3A7caoreyYn8xrC3PsXuKHqy6C0rtOUfnrQq8PsOC0RLoi/1D+tEjtCrI8Cbn3M
-0V9hvqG8OmpI6iZVIhZdXw3/JzOfGAN0iltSIEdrRU0id4xVJ/CvHozJgyJUt5rQ
-T9nO/NkuHJYosQLTA70lUhw0Zk8jq/R3gpYd0VcwCBEF/VfR2ccCAwEAAaNCMEAw
-HQYDVR0OBBYEFGQUfPxYchamCik0FW8qy7z8r6irMA4GA1UdDwEB/wQEAwIBBjAP
-BgNVHRMBAf8EBTADAQH/MA0GCSqGSIb3DQEBDAUAA4ICAQDcAiMI4u8hOscNtybS
-YpOnpSNyByCCYN8Y11StaSWSntkUz5m5UoHPrmyKO1o5yGwBQ8IibQLwYs1OY0PA
-FNr0Y/Dq9HHuTofjcan0yVflLl8cebsjqodEV+m9NU1Bu0soo5iyG9kLFwfl9+qd
-9XbXv8S2gVj/yP9kaWJ5rW4OH3/uHWnlt3Jxs/6lATWUVCvAUm2PVcTJ0rjLyjQI
-UYWg9by0F1jqClx6vWPGOi//lkkZhOpn2ASxYfQAW0q3nHE3GYV5v4GwxxMOdnE+
-OoAGrgYWp421wsTL/0ClXI2lyTrtcoHKXJg80jQDdwj98ClZXSEIx2C/pHF7uNke
-gr4Jr2VvKKu/S7XuPghHJ6APbw+LP6yVGPO5DtxnVW5inkYO0QR4ynKudtml+LLf
-iAlhi+8kTtFZP1rUPcmTPCtk9YENFpb3ksP+MW/oKjJ0DvRMmEoYDjBU1cXrvMUV
-nuiZIesnKwkK2/HmcBhWuwzkvvnoEKQTkrgc4NtnHVMDpCKn3F2SEDzq//wbEBrD
-2NCcnWXL0CsnMQMeNuE9dnUM/0Umud1RvCPHX9jYhxBAEg09ODfnRDwYwFMJZI//
-1ZqmfHAuc1Uh6N//g7kdPjIe1qZ9LPFm6Vwdp6POXiUyK+OVrCoHzrQoeIY8Laad
-TdJ0MN1kURXbg4NR16/9M51NZg==
------END CERTIFICATE-----
-
 # Issuer: CN=Security Communication ECC RootCA1 O=SECOM Trust Systems CO.,LTD.
 # Subject: CN=Security Communication ECC RootCA1 O=SECOM Trust Systems CO.,LTD.
 # Label: "Security Communication ECC RootCA1"
@@ -4927,3 +4592,85 @@ Af8wDgYDVR0PAQH/BAQDAgEGMB0GA1UdDgQWBBTrQciu/NWeUUj1vYv0hyCTQSvT
 4P9mLQlO4E/0BdGF9jVg3PVys0Z9AjBEmEYagoUeYWmJSwdLZrWeqrqgHkHZAXQ6
 bkU6iYAZezKYVWOr62Nuk22rGwlgMU4=
 -----END CERTIFICATE-----
+
+# Issuer: CN=D-TRUST BR Root CA 2 2023 O=D-Trust GmbH
+# Subject: CN=D-TRUST BR Root CA 2 2023 O=D-Trust GmbH
+# Label: "D-TRUST BR Root CA 2 2023"
+# Serial: 153168538924886464690566649552453098598
+# MD5 Fingerprint: e1:09:ed:d3:60:d4:56:1b:47:1f:b7:0c:5f:1b:5f:85
+# SHA1 Fingerprint: 2d:b0:70:ee:71:94:af:69:68:17:db:79:ce:58:9f:a0:6b:96:f7:87
+# SHA256 Fingerprint: 05:52:e6:f8:3f:df:65:e8:fa:96:70:e6:66:df:28:a4:e2:13:40:b5:10:cb:e5:25:66:f9:7c:4f:b9:4b:2b:d1
+-----BEGIN CERTIFICATE-----
+MIIFqTCCA5GgAwIBAgIQczswBEhb2U14LnNLyaHcZjANBgkqhkiG9w0BAQ0FADBI
+MQswCQYDVQQGEwJERTEVMBMGA1UEChMMRC1UcnVzdCBHbWJIMSIwIAYDVQQDExlE
+LVRSVVNUIEJSIFJvb3QgQ0EgMiAyMDIzMB4XDTIzMDUwOTA4NTYzMVoXDTM4MDUw
+OTA4NTYzMFowSDELMAkGA1UEBhMCREUxFTATBgNVBAoTDEQtVHJ1c3QgR21iSDEi
+MCAGA1UEAxMZRC1UUlVTVCBCUiBSb290IENBIDIgMjAyMzCCAiIwDQYJKoZIhvcN
+AQEBBQADggIPADCCAgoCggIBAK7/CVmRgApKaOYkP7in5Mg6CjoWzckjYaCTcfKr
+i3OPoGdlYNJUa2NRb0kz4HIHE304zQaSBylSa053bATTlfrdTIzZXcFhfUvnKLNE
+gXtRr90zsWh81k5M/itoucpmacTsXld/9w3HnDY25QdgrMBM6ghs7wZ8T1soegj8
+k12b9py0i4a6Ibn08OhZWiihNIQaJZG2tY/vsvmA+vk9PBFy2OMvhnbFeSzBqZCT
+Rphny4NqoFAjpzv2gTng7fC5v2Xx2Mt6++9zA84A9H3X4F07ZrjcjrqDy4d2A/wl
+2ecjbwb9Z/Pg/4S8R7+1FhhGaRTMBffb00msa8yr5LULQyReS2tNZ9/WtT5PeB+U
+cSTq3nD88ZP+npNa5JRal1QMNXtfbO4AHyTsA7oC9Xb0n9Sa7YUsOCIvx9gvdhFP
+/Wxc6PWOJ4d/GUohR5AdeY0cW/jPSoXk7bNbjb7EZChdQcRurDhaTyN0dKkSw/bS
+uREVMweR2Ds3OmMwBtHFIjYoYiMQ4EbMl6zWK11kJNXuHA7e+whadSr2Y23OC0K+
+0bpwHJwh5Q8xaRfX/Aq03u2AnMuStIv13lmiWAmlY0cL4UEyNEHZmrHZqLAbWt4N
+DfTisl01gLmB1IRpkQLLddCNxbU9CZEJjxShFHR5PtbJFR2kWVki3PaKRT08EtY+
+XTIvAgMBAAGjgY4wgYswDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUZ5Dw1t61
+GNVGKX5cq/ieCLxklRAwDgYDVR0PAQH/BAQDAgEGMEkGA1UdHwRCMEAwPqA8oDqG
+OGh0dHA6Ly9jcmwuZC10cnVzdC5uZXQvY3JsL2QtdHJ1c3RfYnJfcm9vdF9jYV8y
+XzIwMjMuY3JsMA0GCSqGSIb3DQEBDQUAA4ICAQA097N3U9swFrktpSHxQCF16+tI
+FoE9c+CeJyrrd6kTpGoKWloUMz1oH4Guaf2Mn2VsNELZLdB/eBaxOqwjMa1ef67n
+riv6uvw8l5VAk1/DLQOj7aRvU9f6QA4w9QAgLABMjDu0ox+2v5Eyq6+SmNMW5tTR
+VFxDWy6u71cqqLRvpO8NVhTaIasgdp4D/Ca4nj8+AybmTNudX0KEPUUDAxxZiMrc
+LmEkWqTqJwtzEr5SswrPMhfiHocaFpVIbVrg0M8JkiZmkdijYQ6qgYF/6FKC0ULn
+4B0Y+qSFNueG4A3rvNTJ1jxD8V1Jbn6Bm2m1iWKPiFLY1/4nwSPFyysCu7Ff/vtD
+hQNGvl3GyiEm/9cCnnRK3PgTFbGBVzbLZVzRHTF36SXDw7IyN9XxmAnkbWOACKsG
+koHU6XCPpz+y7YaMgmo1yEJagtFSGkUPFaUA8JR7ZSdXOUPPfH/mvTWze/EZTN46
+ls/pdu4D58JDUjxqgejBWoC9EV2Ta/vH5mQ/u2kc6d0li690yVRAysuTEwrt+2aS
+Ecr1wPrYg1UDfNPFIkZ1cGt5SAYqgpq/5usWDiJFAbzdNpQ0qTUmiteXue4Icr80
+knCDgKs4qllo3UCkGJCy89UDyibK79XH4I9TjvAA46jtn/mtd+ArY0+ew+43u3gJ
+hJ65bvspmZDogNOfJA==
+-----END CERTIFICATE-----
+
+# Issuer: CN=D-TRUST EV Root CA 2 2023 O=D-Trust GmbH
+# Subject: CN=D-TRUST EV Root CA 2 2023 O=D-Trust GmbH
+# Label: "D-TRUST EV Root CA 2 2023"
+# Serial: 139766439402180512324132425437959641711
+# MD5 Fingerprint: 96:b4:78:09:f0:09:cb:77:eb:bb:1b:4d:6f:36:bc:b6
+# SHA1 Fingerprint: a5:5b:d8:47:6c:8f:19:f7:4c:f4:6d:6b:b6:c2:79:82:22:df:54:8b
+# SHA256 Fingerprint: 8e:82:21:b2:e7:d4:00:78:36:a1:67:2f:0d:cc:29:9c:33:bc:07:d3:16:f1:32:fa:1a:20:6d:58:71:50:f1:ce
+-----BEGIN CERTIFICATE-----
+MIIFqTCCA5GgAwIBAgIQaSYJfoBLTKCnjHhiU19abzANBgkqhkiG9w0BAQ0FADBI
+MQswCQYDVQQGEwJERTEVMBMGA1UEChMMRC1UcnVzdCBHbWJIMSIwIAYDVQQDExlE
+LVRSVVNUIEVWIFJvb3QgQ0EgMiAyMDIzMB4XDTIzMDUwOTA5MTAzM1oXDTM4MDUw
+OTA5MTAzMlowSDELMAkGA1UEBhMCREUxFTATBgNVBAoTDEQtVHJ1c3QgR21iSDEi
+MCAGA1UEAxMZRC1UUlVTVCBFViBSb290IENBIDIgMjAyMzCCAiIwDQYJKoZIhvcN
+AQEBBQADggIPADCCAgoCggIBANiOo4mAC7JXUtypU0w3uX9jFxPvp1sjW2l1sJkK
+F8GLxNuo4MwxusLyzV3pt/gdr2rElYfXR8mV2IIEUD2BCP/kPbOx1sWy/YgJ25yE
+7CUXFId/MHibaljJtnMoPDT3mfd/06b4HEV8rSyMlD/YZxBTfiLNTiVR8CUkNRFe
+EMbsh2aJgWi6zCudR3Mfvc2RpHJqnKIbGKBv7FD0fUDCqDDPvXPIEysQEx6Lmqg6
+lHPTGGkKSv/BAQP/eX+1SH977ugpbzZMlWGG2Pmic4ruri+W7mjNPU0oQvlFKzIb
+RlUWaqZLKfm7lVa/Rh3sHZMdwGWyH6FDrlaeoLGPaxK3YG14C8qKXO0elg6DpkiV
+jTujIcSuWMYAsoS0I6SWhjW42J7YrDRJmGOVxcttSEfi8i4YHtAxq9107PncjLgc
+jmgjutDzUNzPZY9zOjLHfP7KgiJPvo5iR2blzYfi6NUPGJ/lBHJLRjwQ8kTCZFZx
+TnXonMkmdMV9WdEKWw9t/p51HBjGGjp82A0EzM23RWV6sY+4roRIPrN6TagD4uJ+
+ARZZaBhDM7DS3LAaQzXupdqpRlyuhoFBAUp0JuyfBr/CBTdkdXgpaP3F9ev+R/nk
+hbDhezGdpn9yo7nELC7MmVcOIQxFAZRl62UJxmMiCzNJkkg8/M3OsD6Onov4/knF
+NXJHAgMBAAGjgY4wgYswDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUqvyREBuH
+kV8Wub9PS5FeAByxMoAwDgYDVR0PAQH/BAQDAgEGMEkGA1UdHwRCMEAwPqA8oDqG
+OGh0dHA6Ly9jcmwuZC10cnVzdC5uZXQvY3JsL2QtdHJ1c3RfZXZfcm9vdF9jYV8y
+XzIwMjMuY3JsMA0GCSqGSIb3DQEBDQUAA4ICAQCTy6UfmRHsmg1fLBWTxj++EI14
+QvBukEdHjqOSMo1wj/Zbjb6JzkcBahsgIIlbyIIQbODnmaprxiqgYzWRaoUlrRc4
+pZt+UPJ26oUFKidBK7GB0aL2QHWpDsvxVUjY7NHss+jOFKE17MJeNRqrphYBBo7q
+3C+jisosketSjl8MmxfPy3MHGcRqwnNU73xDUmPBEcrCRbH0O1P1aa4846XerOhU
+t7KR/aypH/KH5BfGSah82ApB9PI+53c0BFLd6IHyTS9URZ0V4U/M5d40VxDJI3IX
+cI1QcB9WbMy5/zpaT2N6w25lBx2Eof+pDGOJbbJAiDnXH3dotfyc1dZnaVuodNv8
+ifYbMvekJKZ2t0dT741Jj6m2g1qllpBFYfXeA08mD6iL8AOWsKwV0HFaanuU5nCT
+2vFp4LJiTZ6P/4mdm13NRemUAiKN4DV/6PEEeXFsVIP4M7kFMhtYVRFP0OUnR3Hs
+7dpn1mKmS00PaaLJvOwiS5THaJQXfuKOKD62xur1NGyfN4gHONuGcfrNlUhDbqNP
+gofXNJhuS5N5YHVpD/Aa1VP6IQzCP+k/HxiMkl14p3ZnGbuy6n/pcAlWVqOwDAst
+Nl7F6cTVg8uGF5csbBNvh1qvSaYd2804BC5f4ko1Di1L+KIkBI3Y4WNeApI02phh
+XBxvWHZks/wCuPWdCg==
+-----END CERTIFICATE-----
diff --git a/lib/charset_normalizer/__init__.py b/lib/charset_normalizer/__init__.py
index 55991fc3..0d3a3799 100644
--- a/lib/charset_normalizer/__init__.py
+++ b/lib/charset_normalizer/__init__.py
@@ -1,4 +1,3 @@
-# -*- coding: utf-8 -*-
 """
 Charset-Normalizer
 ~~~~~~~~~~~~~~
@@ -19,6 +18,9 @@ at <https://github.com/Ousret/charset_normalizer>.
 :copyright: (c) 2021 by Ahmed TAHRI
 :license: MIT, see LICENSE for more details.
 """
+
+from __future__ import annotations
+
 import logging
 
 from .api import from_bytes, from_fp, from_path, is_binary
diff --git a/lib/charset_normalizer/__main__.py b/lib/charset_normalizer/__main__.py
index beae2ef7..e0e76f7b 100644
--- a/lib/charset_normalizer/__main__.py
+++ b/lib/charset_normalizer/__main__.py
@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 from .cli import cli_detect
 
 if __name__ == "__main__":
diff --git a/lib/charset_normalizer/api.py b/lib/charset_normalizer/api.py
index e3f2283b..2c8c0618 100644
--- a/lib/charset_normalizer/api.py
+++ b/lib/charset_normalizer/api.py
@@ -1,6 +1,8 @@
+from __future__ import annotations
+
 import logging
 from os import PathLike
-from typing import BinaryIO, List, Optional, Set, Union
+from typing import BinaryIO
 
 from .cd import (
     coherence_ratio,
@@ -21,8 +23,6 @@ from .utils import (
     should_strip_sig_or_bom,
 )
 
-# Will most likely be controversial
-# logging.addLevelName(TRACE, "TRACE")
 logger = logging.getLogger("charset_normalizer")
 explain_handler = logging.StreamHandler()
 explain_handler.setFormatter(
@@ -31,12 +31,12 @@ explain_handler.setFormatter(
 
 
 def from_bytes(
-    sequences: Union[bytes, bytearray],
+    sequences: bytes | bytearray,
     steps: int = 5,
     chunk_size: int = 512,
     threshold: float = 0.2,
-    cp_isolation: Optional[List[str]] = None,
-    cp_exclusion: Optional[List[str]] = None,
+    cp_isolation: list[str] | None = None,
+    cp_exclusion: list[str] | None = None,
     preemptive_behaviour: bool = True,
     explain: bool = False,
     language_threshold: float = 0.1,
@@ -62,7 +62,7 @@ def from_bytes(
 
     if not isinstance(sequences, (bytearray, bytes)):
         raise TypeError(
-            "Expected object of type bytes or bytearray, got: {0}".format(
+            "Expected object of type bytes or bytearray, got: {}".format(
                 type(sequences)
             )
         )
@@ -76,7 +76,7 @@ def from_bytes(
 
     if length == 0:
         logger.debug("Encoding detection on empty bytes, assuming utf_8 intention.")
-        if explain:
+        if explain:  # Defensive: ensure exit path clean handler
             logger.removeHandler(explain_handler)
             logger.setLevel(previous_logger_level or logging.WARNING)
         return CharsetMatches([CharsetMatch(sequences, "utf_8", 0.0, False, [], "")])
@@ -135,9 +135,9 @@ def from_bytes(
             ),
         )
 
-    prioritized_encodings: List[str] = []
+    prioritized_encodings: list[str] = []
 
-    specified_encoding: Optional[str] = (
+    specified_encoding: str | None = (
         any_specified_encoding(sequences) if preemptive_behaviour else None
     )
 
@@ -149,13 +149,13 @@ def from_bytes(
             specified_encoding,
         )
 
-    tested: Set[str] = set()
-    tested_but_hard_failure: List[str] = []
-    tested_but_soft_failure: List[str] = []
+    tested: set[str] = set()
+    tested_but_hard_failure: list[str] = []
+    tested_but_soft_failure: list[str] = []
 
-    fallback_ascii: Optional[CharsetMatch] = None
-    fallback_u8: Optional[CharsetMatch] = None
-    fallback_specified: Optional[CharsetMatch] = None
+    fallback_ascii: CharsetMatch | None = None
+    fallback_u8: CharsetMatch | None = None
+    fallback_specified: CharsetMatch | None = None
 
     results: CharsetMatches = CharsetMatches()
 
@@ -189,7 +189,7 @@ def from_bytes(
 
         tested.add(encoding_iana)
 
-        decoded_payload: Optional[str] = None
+        decoded_payload: str | None = None
         bom_or_sig_available: bool = sig_encoding == encoding_iana
         strip_sig_or_bom: bool = bom_or_sig_available and should_strip_sig_or_bom(
             encoding_iana
@@ -292,7 +292,7 @@ def from_bytes(
         early_stop_count: int = 0
         lazy_str_hard_failure = False
 
-        md_chunks: List[str] = []
+        md_chunks: list[str] = []
         md_ratios = []
 
         try:
@@ -397,7 +397,7 @@ def from_bytes(
         )
 
         if not is_multi_byte_decoder:
-            target_languages: List[str] = encoding_languages(encoding_iana)
+            target_languages: list[str] = encoding_languages(encoding_iana)
         else:
             target_languages = mb_encoding_languages(encoding_iana)
 
@@ -462,7 +462,7 @@ def from_bytes(
                     "Encoding detection: %s is most likely the one.",
                     current_match.encoding,
                 )
-                if explain:
+                if explain:  # Defensive: ensure exit path clean handler
                     logger.removeHandler(explain_handler)
                     logger.setLevel(previous_logger_level)
                 return CharsetMatches([current_match])
@@ -480,7 +480,7 @@ def from_bytes(
                 "Encoding detection: %s is most likely the one.",
                 probable_result.encoding,
             )
-            if explain:
+            if explain:  # Defensive: ensure exit path clean handler
                 logger.removeHandler(explain_handler)
                 logger.setLevel(previous_logger_level)
 
@@ -492,7 +492,7 @@ def from_bytes(
                 "the beginning of the sequence.",
                 encoding_iana,
             )
-            if explain:
+            if explain:  # Defensive: ensure exit path clean handler
                 logger.removeHandler(explain_handler)
                 logger.setLevel(previous_logger_level)
             return CharsetMatches([results[encoding_iana]])
@@ -546,8 +546,8 @@ def from_fp(
     steps: int = 5,
     chunk_size: int = 512,
     threshold: float = 0.20,
-    cp_isolation: Optional[List[str]] = None,
-    cp_exclusion: Optional[List[str]] = None,
+    cp_isolation: list[str] | None = None,
+    cp_exclusion: list[str] | None = None,
     preemptive_behaviour: bool = True,
     explain: bool = False,
     language_threshold: float = 0.1,
@@ -572,12 +572,12 @@ def from_fp(
 
 
 def from_path(
-    path: Union[str, bytes, PathLike],  # type: ignore[type-arg]
+    path: str | bytes | PathLike,  # type: ignore[type-arg]
     steps: int = 5,
     chunk_size: int = 512,
     threshold: float = 0.20,
-    cp_isolation: Optional[List[str]] = None,
-    cp_exclusion: Optional[List[str]] = None,
+    cp_isolation: list[str] | None = None,
+    cp_exclusion: list[str] | None = None,
     preemptive_behaviour: bool = True,
     explain: bool = False,
     language_threshold: float = 0.1,
@@ -603,12 +603,12 @@ def from_path(
 
 
 def is_binary(
-    fp_or_path_or_payload: Union[PathLike, str, BinaryIO, bytes],  # type: ignore[type-arg]
+    fp_or_path_or_payload: PathLike | str | BinaryIO | bytes,  # type: ignore[type-arg]
     steps: int = 5,
     chunk_size: int = 512,
     threshold: float = 0.20,
-    cp_isolation: Optional[List[str]] = None,
-    cp_exclusion: Optional[List[str]] = None,
+    cp_isolation: list[str] | None = None,
+    cp_exclusion: list[str] | None = None,
     preemptive_behaviour: bool = True,
     explain: bool = False,
     language_threshold: float = 0.1,
diff --git a/lib/charset_normalizer/cd.py b/lib/charset_normalizer/cd.py
index 4ea6760c..71a3ed51 100644
--- a/lib/charset_normalizer/cd.py
+++ b/lib/charset_normalizer/cd.py
@@ -1,8 +1,10 @@
+from __future__ import annotations
+
 import importlib
 from codecs import IncrementalDecoder
 from collections import Counter
 from functools import lru_cache
-from typing import Counter as TypeCounter, Dict, List, Optional, Tuple
+from typing import Counter as TypeCounter
 
 from .constant import (
     FREQUENCIES,
@@ -22,26 +24,24 @@ from .utils import (
 )
 
 
-def encoding_unicode_range(iana_name: str) -> List[str]:
+def encoding_unicode_range(iana_name: str) -> list[str]:
     """
     Return associated unicode ranges in a single byte code page.
     """
     if is_multi_byte_encoding(iana_name):
-        raise IOError("Function not supported on multi-byte code page")
+        raise OSError("Function not supported on multi-byte code page")
 
-    decoder = importlib.import_module(
-        "encodings.{}".format(iana_name)
-    ).IncrementalDecoder
+    decoder = importlib.import_module(f"encodings.{iana_name}").IncrementalDecoder
 
     p: IncrementalDecoder = decoder(errors="ignore")
-    seen_ranges: Dict[str, int] = {}
+    seen_ranges: dict[str, int] = {}
     character_count: int = 0
 
     for i in range(0x40, 0xFF):
         chunk: str = p.decode(bytes([i]))
 
         if chunk:
-            character_range: Optional[str] = unicode_range(chunk)
+            character_range: str | None = unicode_range(chunk)
 
             if character_range is None:
                 continue
@@ -61,11 +61,11 @@ def encoding_unicode_range(iana_name: str) -> List[str]:
     )
 
 
-def unicode_range_languages(primary_range: str) -> List[str]:
+def unicode_range_languages(primary_range: str) -> list[str]:
     """
     Return inferred languages used with a unicode range.
     """
-    languages: List[str] = []
+    languages: list[str] = []
 
     for language, characters in FREQUENCIES.items():
         for character in characters:
@@ -77,13 +77,13 @@ def unicode_range_languages(primary_range: str) -> List[str]:
 
 
 @lru_cache()
-def encoding_languages(iana_name: str) -> List[str]:
+def encoding_languages(iana_name: str) -> list[str]:
     """
     Single-byte encoding language association. Some code page are heavily linked to particular language(s).
     This function does the correspondence.
     """
-    unicode_ranges: List[str] = encoding_unicode_range(iana_name)
-    primary_range: Optional[str] = None
+    unicode_ranges: list[str] = encoding_unicode_range(iana_name)
+    primary_range: str | None = None
 
     for specified_range in unicode_ranges:
         if "Latin" not in specified_range:
@@ -97,7 +97,7 @@ def encoding_languages(iana_name: str) -> List[str]:
 
 
 @lru_cache()
-def mb_encoding_languages(iana_name: str) -> List[str]:
+def mb_encoding_languages(iana_name: str) -> list[str]:
     """
     Multi-byte encoding language association. Some code page are heavily linked to particular language(s).
     This function does the correspondence.
@@ -118,7 +118,7 @@ def mb_encoding_languages(iana_name: str) -> List[str]:
 
 
 @lru_cache(maxsize=LANGUAGE_SUPPORTED_COUNT)
-def get_target_features(language: str) -> Tuple[bool, bool]:
+def get_target_features(language: str) -> tuple[bool, bool]:
     """
     Determine main aspects from a supported language if it contains accents and if is pure Latin.
     """
@@ -135,12 +135,12 @@ def get_target_features(language: str) -> Tuple[bool, bool]:
 
 
 def alphabet_languages(
-    characters: List[str], ignore_non_latin: bool = False
-) -> List[str]:
+    characters: list[str], ignore_non_latin: bool = False
+) -> list[str]:
     """
     Return associated languages associated to given characters.
     """
-    languages: List[Tuple[str, float]] = []
+    languages: list[tuple[str, float]] = []
 
     source_have_accents = any(is_accentuated(character) for character in characters)
 
@@ -170,7 +170,7 @@ def alphabet_languages(
 
 
 def characters_popularity_compare(
-    language: str, ordered_characters: List[str]
+    language: str, ordered_characters: list[str]
 ) -> float:
     """
     Determine if a ordered characters list (by occurrence from most appearance to rarest) match a particular language.
@@ -178,7 +178,7 @@ def characters_popularity_compare(
     Beware that is function is not strict on the match in order to ease the detection. (Meaning close match is 1.)
     """
     if language not in FREQUENCIES:
-        raise ValueError("{} not available".format(language))
+        raise ValueError(f"{language} not available")
 
     character_approved_count: int = 0
     FREQUENCIES_language_set = set(FREQUENCIES[language])
@@ -214,14 +214,14 @@ def characters_popularity_compare(
             character_approved_count += 1
             continue
 
-        characters_before_source: List[str] = FREQUENCIES[language][
+        characters_before_source: list[str] = FREQUENCIES[language][
             0:character_rank_in_language
         ]
-        characters_after_source: List[str] = FREQUENCIES[language][
+        characters_after_source: list[str] = FREQUENCIES[language][
             character_rank_in_language:
         ]
-        characters_before: List[str] = ordered_characters[0:character_rank]
-        characters_after: List[str] = ordered_characters[character_rank:]
+        characters_before: list[str] = ordered_characters[0:character_rank]
+        characters_after: list[str] = ordered_characters[character_rank:]
 
         before_match_count: int = len(
             set(characters_before) & set(characters_before_source)
@@ -249,24 +249,24 @@ def characters_popularity_compare(
     return character_approved_count / len(ordered_characters)
 
 
-def alpha_unicode_split(decoded_sequence: str) -> List[str]:
+def alpha_unicode_split(decoded_sequence: str) -> list[str]:
     """
     Given a decoded text sequence, return a list of str. Unicode range / alphabet separation.
     Ex. a text containing English/Latin with a bit a Hebrew will return two items in the resulting list;
     One containing the latin letters and the other hebrew.
     """
-    layers: Dict[str, str] = {}
+    layers: dict[str, str] = {}
 
     for character in decoded_sequence:
         if character.isalpha() is False:
             continue
 
-        character_range: Optional[str] = unicode_range(character)
+        character_range: str | None = unicode_range(character)
 
         if character_range is None:
             continue
 
-        layer_target_range: Optional[str] = None
+        layer_target_range: str | None = None
 
         for discovered_range in layers:
             if (
@@ -288,12 +288,12 @@ def alpha_unicode_split(decoded_sequence: str) -> List[str]:
     return list(layers.values())
 
 
-def merge_coherence_ratios(results: List[CoherenceMatches]) -> CoherenceMatches:
+def merge_coherence_ratios(results: list[CoherenceMatches]) -> CoherenceMatches:
     """
     This function merge results previously given by the function coherence_ratio.
     The return type is the same as coherence_ratio.
     """
-    per_language_ratios: Dict[str, List[float]] = {}
+    per_language_ratios: dict[str, list[float]] = {}
     for result in results:
         for sub_result in result:
             language, ratio = sub_result
@@ -321,7 +321,7 @@ def filter_alt_coherence_matches(results: CoherenceMatches) -> CoherenceMatches:
     We shall NOT return "English—" in CoherenceMatches because it is an alternative
     of "English". This function only keeps the best match and remove the em-dash in it.
     """
-    index_results: Dict[str, List[float]] = dict()
+    index_results: dict[str, list[float]] = dict()
 
     for result in results:
         language, ratio = result
@@ -345,14 +345,14 @@ def filter_alt_coherence_matches(results: CoherenceMatches) -> CoherenceMatches:
 
 @lru_cache(maxsize=2048)
 def coherence_ratio(
-    decoded_sequence: str, threshold: float = 0.1, lg_inclusion: Optional[str] = None
+    decoded_sequence: str, threshold: float = 0.1, lg_inclusion: str | None = None
 ) -> CoherenceMatches:
     """
     Detect ANY language that can be identified in given sequence. The sequence will be analysed by layers.
     A layer = Character extraction by alphabets/ranges.
     """
 
-    results: List[Tuple[str, float]] = []
+    results: list[tuple[str, float]] = []
     ignore_non_latin: bool = False
 
     sufficient_match_count: int = 0
@@ -371,7 +371,7 @@ def coherence_ratio(
         if character_count <= TOO_SMALL_SEQUENCE:
             continue
 
-        popular_character_ordered: List[str] = [c for c, o in most_common]
+        popular_character_ordered: list[str] = [c for c, o in most_common]
 
         for language in lg_inclusion_list or alphabet_languages(
             popular_character_ordered, ignore_non_latin
diff --git a/lib/charset_normalizer/cli/__init__.py b/lib/charset_normalizer/cli/__init__.py
index d95fedfe..543a5a4d 100644
--- a/lib/charset_normalizer/cli/__init__.py
+++ b/lib/charset_normalizer/cli/__init__.py
@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 from .__main__ import cli_detect, query_yes_no
 
 __all__ = (
diff --git a/lib/charset_normalizer/cli/__main__.py b/lib/charset_normalizer/cli/__main__.py
index e7edd0fc..cb64156a 100644
--- a/lib/charset_normalizer/cli/__main__.py
+++ b/lib/charset_normalizer/cli/__main__.py
@@ -1,9 +1,11 @@
+from __future__ import annotations
+
 import argparse
 import sys
+import typing
 from json import dumps
 from os.path import abspath, basename, dirname, join, realpath
 from platform import python_version
-from typing import List, Optional
 from unicodedata import unidata_version
 
 import charset_normalizer.md as md_module
@@ -42,10 +44,69 @@ def query_yes_no(question: str, default: str = "yes") -> bool:
         elif choice in valid:
             return valid[choice]
         else:
-            sys.stdout.write("Please respond with 'yes' or 'no' " "(or 'y' or 'n').\n")
+            sys.stdout.write("Please respond with 'yes' or 'no' (or 'y' or 'n').\n")
 
 
-def cli_detect(argv: Optional[List[str]] = None) -> int:
+class FileType:
+    """Factory for creating file object types
+
+    Instances of FileType are typically passed as type= arguments to the
+    ArgumentParser add_argument() method.
+
+    Keyword Arguments:
+        - mode -- A string indicating how the file is to be opened. Accepts the
+            same values as the builtin open() function.
+        - bufsize -- The file's desired buffer size. Accepts the same values as
+            the builtin open() function.
+        - encoding -- The file's encoding. Accepts the same values as the
+            builtin open() function.
+        - errors -- A string indicating how encoding and decoding errors are to
+            be handled. Accepts the same value as the builtin open() function.
+
+    Backported from CPython 3.12
+    """
+
+    def __init__(
+        self,
+        mode: str = "r",
+        bufsize: int = -1,
+        encoding: str | None = None,
+        errors: str | None = None,
+    ):
+        self._mode = mode
+        self._bufsize = bufsize
+        self._encoding = encoding
+        self._errors = errors
+
+    def __call__(self, string: str) -> typing.IO:  # type: ignore[type-arg]
+        # the special argument "-" means sys.std{in,out}
+        if string == "-":
+            if "r" in self._mode:
+                return sys.stdin.buffer if "b" in self._mode else sys.stdin
+            elif any(c in self._mode for c in "wax"):
+                return sys.stdout.buffer if "b" in self._mode else sys.stdout
+            else:
+                msg = f'argument "-" with mode {self._mode}'
+                raise ValueError(msg)
+
+        # all other arguments are used as file names
+        try:
+            return open(string, self._mode, self._bufsize, self._encoding, self._errors)
+        except OSError as e:
+            message = f"can't open '{string}': {e}"
+            raise argparse.ArgumentTypeError(message)
+
+    def __repr__(self) -> str:
+        args = self._mode, self._bufsize
+        kwargs = [("encoding", self._encoding), ("errors", self._errors)]
+        args_str = ", ".join(
+            [repr(arg) for arg in args if arg != -1]
+            + [f"{kw}={arg!r}" for kw, arg in kwargs if arg is not None]
+        )
+        return f"{type(self).__name__}({args_str})"
+
+
+def cli_detect(argv: list[str] | None = None) -> int:
     """
     CLI assistant using ARGV and ArgumentParser
     :param argv:
@@ -58,7 +119,7 @@ def cli_detect(argv: Optional[List[str]] = None) -> int:
     )
 
     parser.add_argument(
-        "files", type=argparse.FileType("rb"), nargs="+", help="File(s) to be analysed"
+        "files", type=FileType("rb"), nargs="+", help="File(s) to be analysed"
     )
     parser.add_argument(
         "-v",
@@ -124,7 +185,7 @@ def cli_detect(argv: Optional[List[str]] = None) -> int:
         default=0.2,
         type=float,
         dest="threshold",
-        help="Define a custom maximum amount of chaos allowed in decoded content. 0. <= chaos <= 1.",
+        help="Define a custom maximum amount of noise allowed in decoded content. 0. <= noise <= 1.",
     )
     parser.add_argument(
         "--version",
@@ -259,7 +320,7 @@ def cli_detect(argv: Optional[List[str]] = None) -> int:
                 dir_path = dirname(realpath(my_file.name))
                 file_name = basename(realpath(my_file.name))
 
-                o_: List[str] = file_name.split(".")
+                o_: list[str] = file_name.split(".")
 
                 if args.replace is False:
                     o_.insert(-1, best_guess.encoding)
@@ -284,7 +345,7 @@ def cli_detect(argv: Optional[List[str]] = None) -> int:
 
                     with open(x_[0].unicode_path, "wb") as fp:
                         fp.write(best_guess.output())
-                except IOError as e:
+                except OSError as e:
                     print(str(e), file=sys.stderr)
                     if my_file.closed is False:
                         my_file.close()
diff --git a/lib/charset_normalizer/constant.py b/lib/charset_normalizer/constant.py
index f8f2a811..cc71a019 100644
--- a/lib/charset_normalizer/constant.py
+++ b/lib/charset_normalizer/constant.py
@@ -1,11 +1,12 @@
-# -*- coding: utf-8 -*-
+from __future__ import annotations
+
 from codecs import BOM_UTF8, BOM_UTF16_BE, BOM_UTF16_LE, BOM_UTF32_BE, BOM_UTF32_LE
 from encodings.aliases import aliases
-from re import IGNORECASE, compile as re_compile
-from typing import Dict, List, Set, Union
+from re import IGNORECASE
+from re import compile as re_compile
 
 # Contain for each eligible encoding a list of/item bytes SIG/BOM
-ENCODING_MARKS: Dict[str, Union[bytes, List[bytes]]] = {
+ENCODING_MARKS: dict[str, bytes | list[bytes]] = {
     "utf_8": BOM_UTF8,
     "utf_7": [
         b"\x2b\x2f\x76\x38",
@@ -25,7 +26,7 @@ TOO_BIG_SEQUENCE: int = int(10e6)
 UTF8_MAXIMAL_ALLOCATION: int = 1_112_064
 
 # Up-to-date Unicode ucd/15.0.0
-UNICODE_RANGES_COMBINED: Dict[str, range] = {
+UNICODE_RANGES_COMBINED: dict[str, range] = {
     "Control character": range(32),
     "Basic Latin": range(32, 128),
     "Latin-1 Supplement": range(128, 256),
@@ -357,7 +358,7 @@ UNICODE_RANGES_COMBINED: Dict[str, range] = {
 }
 
 
-UNICODE_SECONDARY_RANGE_KEYWORD: List[str] = [
+UNICODE_SECONDARY_RANGE_KEYWORD: list[str] = [
     "Supplement",
     "Extended",
     "Extensions",
@@ -392,7 +393,7 @@ IANA_NO_ALIASES = [
     "koi8_u",
 ]
 
-IANA_SUPPORTED: List[str] = sorted(
+IANA_SUPPORTED: list[str] = sorted(
     filter(
         lambda x: x.endswith("_codec") is False
         and x not in {"rot_13", "tactis", "mbcs"},
@@ -403,7 +404,7 @@ IANA_SUPPORTED: List[str] = sorted(
 IANA_SUPPORTED_COUNT: int = len(IANA_SUPPORTED)
 
 # pre-computed code page that are similar using the function cp_similarity.
-IANA_SUPPORTED_SIMILAR: Dict[str, List[str]] = {
+IANA_SUPPORTED_SIMILAR: dict[str, list[str]] = {
     "cp037": ["cp1026", "cp1140", "cp273", "cp500"],
     "cp1026": ["cp037", "cp1140", "cp273", "cp500"],
     "cp1125": ["cp866"],
@@ -492,7 +493,7 @@ IANA_SUPPORTED_SIMILAR: Dict[str, List[str]] = {
 }
 
 
-CHARDET_CORRESPONDENCE: Dict[str, str] = {
+CHARDET_CORRESPONDENCE: dict[str, str] = {
     "iso2022_kr": "ISO-2022-KR",
     "iso2022_jp": "ISO-2022-JP",
     "euc_kr": "EUC-KR",
@@ -528,7 +529,7 @@ CHARDET_CORRESPONDENCE: Dict[str, str] = {
 }
 
 
-COMMON_SAFE_ASCII_CHARACTERS: Set[str] = {
+COMMON_SAFE_ASCII_CHARACTERS: set[str] = {
     "<",
     ">",
     "=",
@@ -548,9 +549,26 @@ COMMON_SAFE_ASCII_CHARACTERS: Set[str] = {
     ")",
 }
 
+# Sample character sets — replace with full lists if needed
+COMMON_CHINESE_CHARACTERS = "的一是在不了有和人这中大为上个国我以要他时来用们生到作地于出就分对成会可主发年动同工也能下过子说产种面而方后多定行学法所民得经十三之进着等部度家电力里如水化高自二理起小物现实加量都两体制机当使点从业本去把性好应开它合还因由其些然前外天政四日那社义事平形相全表间样与关各重新线内数正心反你明看原又么利比或但质气第向道命此变条只没结解问意建月公无系军很情者最立代想已通并提直题党程展五果料象员革位入常文总次品式活设及管特件长求老头基资边流路级少图山统接知较将组见计别她手角期根论运农指几九区强放决西被干做必战先回则任取据处队南给色光门即保治北造百规热领七海口东导器压志世金增争济阶油思术极交受联什认六共权收证改清己美再采转更单风切打白教速花带安场身车例真务具万每目至达走积示议声报斗完类八离华名确才科张信马节话米整空元况今集温传土许步群广石记需段研界拉林律叫且究观越织装影算低持音众书布复容儿须际商非验连断深难近矿千周委素技备半办青省列习响约支般史感劳便团往酸历市克何除消构府太准精值号率族维划选标写存候毛亲快效斯院查江型眼王按格养易置派层片始却专状育厂京识适属圆包火住调满县局照参红细引听该铁价严龙飞"
 
-KO_NAMES: Set[str] = {"johab", "cp949", "euc_kr"}
-ZH_NAMES: Set[str] = {"big5", "cp950", "big5hkscs", "hz"}
+COMMON_JAPANESE_CHARACTERS = "日一国年大十二本中長出三時行見月分後前生五間上東四今金九入学高円子外八六下来気小七山話女北午百書先名川千水半男西電校語土木聞食車何南万毎白天母火右読友左休父雨"
+
+COMMON_KOREAN_CHARACTERS = "一二三四五六七八九十百千萬上下左右中人女子大小山川日月火水木金土父母天地國名年時文校學生"
+
+# Combine all into a set
+COMMON_CJK_CHARACTERS = set(
+    "".join(
+        [
+            COMMON_CHINESE_CHARACTERS,
+            COMMON_JAPANESE_CHARACTERS,
+            COMMON_KOREAN_CHARACTERS,
+        ]
+    )
+)
+
+KO_NAMES: set[str] = {"johab", "cp949", "euc_kr"}
+ZH_NAMES: set[str] = {"big5", "cp950", "big5hkscs", "hz"}
 
 # Logging LEVEL below DEBUG
 TRACE: int = 5
@@ -558,7 +576,7 @@ TRACE: int = 5
 
 # Language label that contain the em dash "—"
 # character are to be considered alternative seq to origin
-FREQUENCIES: Dict[str, List[str]] = {
+FREQUENCIES: dict[str, list[str]] = {
     "English": [
         "e",
         "a",
diff --git a/lib/charset_normalizer/legacy.py b/lib/charset_normalizer/legacy.py
index 3f6d4907..e221beca 100644
--- a/lib/charset_normalizer/legacy.py
+++ b/lib/charset_normalizer/legacy.py
@@ -1,6 +1,6 @@
 from __future__ import annotations
 
-from typing import TYPE_CHECKING, Any, Optional
+from typing import TYPE_CHECKING, Any
 from warnings import warn
 
 from .api import from_bytes
@@ -11,9 +11,9 @@ if TYPE_CHECKING:
     from typing_extensions import TypedDict
 
     class ResultDict(TypedDict):
-        encoding: Optional[str]
+        encoding: str | None
         language: str
-        confidence: Optional[float]
+        confidence: float | None
 
 
 def detect(
@@ -37,8 +37,7 @@ def detect(
 
     if not isinstance(byte_str, (bytearray, bytes)):
         raise TypeError(  # pragma: nocover
-            "Expected object of type bytes or bytearray, got: "
-            "{0}".format(type(byte_str))
+            f"Expected object of type bytes or bytearray, got: {type(byte_str)}"
         )
 
     if isinstance(byte_str, bytearray):
diff --git a/lib/charset_normalizer/md.py b/lib/charset_normalizer/md.py
index d834db0e..12ce024b 100644
--- a/lib/charset_normalizer/md.py
+++ b/lib/charset_normalizer/md.py
@@ -1,6 +1,7 @@
+from __future__ import annotations
+
 from functools import lru_cache
 from logging import getLogger
-from typing import List, Optional
 
 from .constant import (
     COMMON_SAFE_ASCII_CHARACTERS,
@@ -25,6 +26,7 @@ from .utils import (
     is_unprintable,
     remove_accent,
     unicode_range,
+    is_cjk_uncommon,
 )
 
 
@@ -68,7 +70,7 @@ class TooManySymbolOrPunctuationPlugin(MessDetectorPlugin):
         self._symbol_count: int = 0
         self._character_count: int = 0
 
-        self._last_printable_char: Optional[str] = None
+        self._last_printable_char: str | None = None
         self._frenzy_symbol_in_word: bool = False
 
     def eligible(self, character: str) -> bool:
@@ -92,7 +94,7 @@ class TooManySymbolOrPunctuationPlugin(MessDetectorPlugin):
 
         self._last_printable_char = character
 
-    def reset(self) -> None:  # pragma: no cover
+    def reset(self) -> None:  # Abstract
         self._punctuation_count = 0
         self._character_count = 0
         self._symbol_count = 0
@@ -123,7 +125,7 @@ class TooManyAccentuatedPlugin(MessDetectorPlugin):
         if is_accentuated(character):
             self._accentuated_count += 1
 
-    def reset(self) -> None:  # pragma: no cover
+    def reset(self) -> None:  # Abstract
         self._character_count = 0
         self._accentuated_count = 0
 
@@ -149,7 +151,7 @@ class UnprintablePlugin(MessDetectorPlugin):
             self._unprintable_count += 1
         self._character_count += 1
 
-    def reset(self) -> None:  # pragma: no cover
+    def reset(self) -> None:  # Abstract
         self._unprintable_count = 0
 
     @property
@@ -165,7 +167,7 @@ class SuspiciousDuplicateAccentPlugin(MessDetectorPlugin):
         self._successive_count: int = 0
         self._character_count: int = 0
 
-        self._last_latin_character: Optional[str] = None
+        self._last_latin_character: str | None = None
 
     def eligible(self, character: str) -> bool:
         return character.isalpha() and is_latin(character)
@@ -184,7 +186,7 @@ class SuspiciousDuplicateAccentPlugin(MessDetectorPlugin):
                 self._successive_count += 1
         self._last_latin_character = character
 
-    def reset(self) -> None:  # pragma: no cover
+    def reset(self) -> None:  # Abstract
         self._successive_count = 0
         self._character_count = 0
         self._last_latin_character = None
@@ -201,7 +203,7 @@ class SuspiciousRange(MessDetectorPlugin):
     def __init__(self) -> None:
         self._suspicious_successive_range_count: int = 0
         self._character_count: int = 0
-        self._last_printable_seen: Optional[str] = None
+        self._last_printable_seen: str | None = None
 
     def eligible(self, character: str) -> bool:
         return character.isprintable()
@@ -221,15 +223,15 @@ class SuspiciousRange(MessDetectorPlugin):
             self._last_printable_seen = character
             return
 
-        unicode_range_a: Optional[str] = unicode_range(self._last_printable_seen)
-        unicode_range_b: Optional[str] = unicode_range(character)
+        unicode_range_a: str | None = unicode_range(self._last_printable_seen)
+        unicode_range_b: str | None = unicode_range(character)
 
         if is_suspiciously_successive_range(unicode_range_a, unicode_range_b):
             self._suspicious_successive_range_count += 1
 
         self._last_printable_seen = character
 
-    def reset(self) -> None:  # pragma: no cover
+    def reset(self) -> None:  # Abstract
         self._character_count = 0
         self._suspicious_successive_range_count = 0
         self._last_printable_seen = None
@@ -346,7 +348,7 @@ class SuperWeirdWordPlugin(MessDetectorPlugin):
             self._is_current_word_bad = True
             self._buffer += character
 
-    def reset(self) -> None:  # pragma: no cover
+    def reset(self) -> None:  # Abstract
         self._buffer = ""
         self._is_current_word_bad = False
         self._foreign_long_watch = False
@@ -364,35 +366,39 @@ class SuperWeirdWordPlugin(MessDetectorPlugin):
         return self._bad_character_count / self._character_count
 
 
-class CjkInvalidStopPlugin(MessDetectorPlugin):
+class CjkUncommonPlugin(MessDetectorPlugin):
     """
-    GB(Chinese) based encoding often render the stop incorrectly when the content does not fit and
-    can be easily detected. Searching for the overuse of '丅' and '丄'.
+    Detect messy CJK text that probably means nothing.
     """
 
     def __init__(self) -> None:
-        self._wrong_stop_count: int = 0
-        self._cjk_character_count: int = 0
+        self._character_count: int = 0
+        self._uncommon_count: int = 0
 
     def eligible(self, character: str) -> bool:
-        return True
+        return is_cjk(character)
 
     def feed(self, character: str) -> None:
-        if character in {"丅", "丄"}:
-            self._wrong_stop_count += 1
-            return
-        if is_cjk(character):
-            self._cjk_character_count += 1
+        self._character_count += 1
 
-    def reset(self) -> None:  # pragma: no cover
-        self._wrong_stop_count = 0
-        self._cjk_character_count = 0
+        if is_cjk_uncommon(character):
+            self._uncommon_count += 1
+            return
+
+    def reset(self) -> None:  # Abstract
+        self._character_count = 0
+        self._uncommon_count = 0
 
     @property
     def ratio(self) -> float:
-        if self._cjk_character_count < 16:
+        if self._character_count < 8:
             return 0.0
-        return self._wrong_stop_count / self._cjk_character_count
+
+        uncommon_form_usage: float = self._uncommon_count / self._character_count
+
+        # we can be pretty sure it's garbage when uncommon characters are widely
+        # used. otherwise it could just be traditional chinese for example.
+        return uncommon_form_usage / 10 if uncommon_form_usage > 0.5 else 0.0
 
 
 class ArchaicUpperLowerPlugin(MessDetectorPlugin):
@@ -406,7 +412,7 @@ class ArchaicUpperLowerPlugin(MessDetectorPlugin):
 
         self._character_count: int = 0
 
-        self._last_alpha_seen: Optional[str] = None
+        self._last_alpha_seen: str | None = None
         self._current_ascii_only: bool = True
 
     def eligible(self, character: str) -> bool:
@@ -454,7 +460,7 @@ class ArchaicUpperLowerPlugin(MessDetectorPlugin):
         self._character_count_since_last_sep += 1
         self._last_alpha_seen = character
 
-    def reset(self) -> None:  # pragma: no cover
+    def reset(self) -> None:  # Abstract
         self._character_count = 0
         self._character_count_since_last_sep = 0
         self._successive_upper_lower_count = 0
@@ -476,7 +482,7 @@ class ArabicIsolatedFormPlugin(MessDetectorPlugin):
         self._character_count: int = 0
         self._isolated_form_count: int = 0
 
-    def reset(self) -> None:  # pragma: no cover
+    def reset(self) -> None:  # Abstract
         self._character_count = 0
         self._isolated_form_count = 0
 
@@ -501,7 +507,7 @@ class ArabicIsolatedFormPlugin(MessDetectorPlugin):
 
 @lru_cache(maxsize=1024)
 def is_suspiciously_successive_range(
-    unicode_range_a: Optional[str], unicode_range_b: Optional[str]
+    unicode_range_a: str | None, unicode_range_b: str | None
 ) -> bool:
     """
     Determine if two Unicode range seen next to each other can be considered as suspicious.
@@ -525,9 +531,10 @@ def is_suspiciously_successive_range(
     ):
         return False
 
-    keywords_range_a, keywords_range_b = unicode_range_a.split(
-        " "
-    ), unicode_range_b.split(" ")
+    keywords_range_a, keywords_range_b = (
+        unicode_range_a.split(" "),
+        unicode_range_b.split(" "),
+    )
 
     for el in keywords_range_a:
         if el in UNICODE_SECONDARY_RANGE_KEYWORD:
@@ -580,7 +587,7 @@ def mess_ratio(
     Compute a mess ratio given a decoded bytes sequence. The maximum threshold does stop the computation earlier.
     """
 
-    detectors: List[MessDetectorPlugin] = [
+    detectors: list[MessDetectorPlugin] = [
         md_class() for md_class in MessDetectorPlugin.__subclasses__()
     ]
 
@@ -622,7 +629,7 @@ def mess_ratio(
             logger.log(TRACE, f"Starting with: {decoded_sequence[:16]}")
             logger.log(TRACE, f"Ending with: {decoded_sequence[-16::]}")
 
-        for dt in detectors:  # pragma: nocover
+        for dt in detectors:
             logger.log(TRACE, f"{dt.__class__}: {dt.ratio}")
 
     return round(mean_mess_ratio, 3)
diff --git a/lib/charset_normalizer/models.py b/lib/charset_normalizer/models.py
index 6f6b86b3..1042758f 100644
--- a/lib/charset_normalizer/models.py
+++ b/lib/charset_normalizer/models.py
@@ -1,8 +1,10 @@
+from __future__ import annotations
+
 from encodings.aliases import aliases
 from hashlib import sha256
 from json import dumps
 from re import sub
-from typing import Any, Dict, Iterator, List, Optional, Tuple, Union
+from typing import Any, Iterator, List, Tuple
 
 from .constant import RE_POSSIBLE_ENCODING_INDICATION, TOO_BIG_SEQUENCE
 from .utils import iana_name, is_multi_byte_encoding, unicode_range
@@ -15,9 +17,9 @@ class CharsetMatch:
         guessed_encoding: str,
         mean_mess_ratio: float,
         has_sig_or_bom: bool,
-        languages: "CoherenceMatches",
-        decoded_payload: Optional[str] = None,
-        preemptive_declaration: Optional[str] = None,
+        languages: CoherenceMatches,
+        decoded_payload: str | None = None,
+        preemptive_declaration: str | None = None,
     ):
         self._payload: bytes = payload
 
@@ -25,17 +27,17 @@ class CharsetMatch:
         self._mean_mess_ratio: float = mean_mess_ratio
         self._languages: CoherenceMatches = languages
         self._has_sig_or_bom: bool = has_sig_or_bom
-        self._unicode_ranges: Optional[List[str]] = None
+        self._unicode_ranges: list[str] | None = None
 
-        self._leaves: List[CharsetMatch] = []
+        self._leaves: list[CharsetMatch] = []
         self._mean_coherence_ratio: float = 0.0
 
-        self._output_payload: Optional[bytes] = None
-        self._output_encoding: Optional[str] = None
+        self._output_payload: bytes | None = None
+        self._output_encoding: str | None = None
 
-        self._string: Optional[str] = decoded_payload
+        self._string: str | None = decoded_payload
 
-        self._preemptive_declaration: Optional[str] = preemptive_declaration
+        self._preemptive_declaration: str | None = preemptive_declaration
 
     def __eq__(self, other: object) -> bool:
         if not isinstance(other, CharsetMatch):
@@ -77,9 +79,9 @@ class CharsetMatch:
         return self._string
 
     def __repr__(self) -> str:
-        return "<CharsetMatch '{}' bytes({})>".format(self.encoding, self.fingerprint)
+        return f"<CharsetMatch '{self.encoding}' bytes({self.fingerprint})>"
 
-    def add_submatch(self, other: "CharsetMatch") -> None:
+    def add_submatch(self, other: CharsetMatch) -> None:
         if not isinstance(other, CharsetMatch) or other == self:
             raise ValueError(
                 "Unable to add instance <{}> as a submatch of a CharsetMatch".format(
@@ -95,11 +97,11 @@ class CharsetMatch:
         return self._encoding
 
     @property
-    def encoding_aliases(self) -> List[str]:
+    def encoding_aliases(self) -> list[str]:
         """
         Encoding name are known by many name, using this could help when searching for IBM855 when it's listed as CP855.
         """
-        also_known_as: List[str] = []
+        also_known_as: list[str] = []
         for u, p in aliases.items():
             if self.encoding == u:
                 also_known_as.append(p)
@@ -116,7 +118,7 @@ class CharsetMatch:
         return self._has_sig_or_bom
 
     @property
-    def languages(self) -> List[str]:
+    def languages(self) -> list[str]:
         """
         Return the complete list of possible languages found in decoded sequence.
         Usually not really useful. Returned list may be empty even if 'language' property return something != 'Unknown'.
@@ -177,7 +179,7 @@ class CharsetMatch:
         return self._payload
 
     @property
-    def submatch(self) -> List["CharsetMatch"]:
+    def submatch(self) -> list[CharsetMatch]:
         return self._leaves
 
     @property
@@ -185,19 +187,17 @@ class CharsetMatch:
         return len(self._leaves) > 0
 
     @property
-    def alphabets(self) -> List[str]:
+    def alphabets(self) -> list[str]:
         if self._unicode_ranges is not None:
             return self._unicode_ranges
         # list detected ranges
-        detected_ranges: List[Optional[str]] = [
-            unicode_range(char) for char in str(self)
-        ]
+        detected_ranges: list[str | None] = [unicode_range(char) for char in str(self)]
         # filter and sort
         self._unicode_ranges = sorted(list({r for r in detected_ranges if r}))
         return self._unicode_ranges
 
     @property
-    def could_be_from_charset(self) -> List[str]:
+    def could_be_from_charset(self) -> list[str]:
         """
         The complete list of encoding that output the exact SAME str result and therefore could be the originating
         encoding.
@@ -221,10 +221,11 @@ class CharsetMatch:
                 patched_header = sub(
                     RE_POSSIBLE_ENCODING_INDICATION,
                     lambda m: m.string[m.span()[0] : m.span()[1]].replace(
-                        m.groups()[0], iana_name(self._output_encoding)  # type: ignore[arg-type]
+                        m.groups()[0],
+                        iana_name(self._output_encoding).replace("_", "-"),  # type: ignore[arg-type]
                     ),
                     decoded_string[:8192],
-                    1,
+                    count=1,
                 )
 
                 decoded_string = patched_header + decoded_string[8192:]
@@ -247,13 +248,13 @@ class CharsetMatches:
     Act like a list(iterable) but does not implements all related methods.
     """
 
-    def __init__(self, results: Optional[List[CharsetMatch]] = None):
-        self._results: List[CharsetMatch] = sorted(results) if results else []
+    def __init__(self, results: list[CharsetMatch] | None = None):
+        self._results: list[CharsetMatch] = sorted(results) if results else []
 
     def __iter__(self) -> Iterator[CharsetMatch]:
         yield from self._results
 
-    def __getitem__(self, item: Union[int, str]) -> CharsetMatch:
+    def __getitem__(self, item: int | str) -> CharsetMatch:
         """
         Retrieve a single item either by its position or encoding name (alias may be used here).
         Raise KeyError upon invalid index or encoding not present in results.
@@ -293,7 +294,7 @@ class CharsetMatches:
         self._results.append(item)
         self._results = sorted(self._results)
 
-    def best(self) -> Optional["CharsetMatch"]:
+    def best(self) -> CharsetMatch | None:
         """
         Simply return the first match. Strict equivalent to matches[0].
         """
@@ -301,7 +302,7 @@ class CharsetMatches:
             return None
         return self._results[0]
 
-    def first(self) -> Optional["CharsetMatch"]:
+    def first(self) -> CharsetMatch | None:
         """
         Redundant method, call the method best(). Kept for BC reasons.
         """
@@ -316,31 +317,31 @@ class CliDetectionResult:
     def __init__(
         self,
         path: str,
-        encoding: Optional[str],
-        encoding_aliases: List[str],
-        alternative_encodings: List[str],
+        encoding: str | None,
+        encoding_aliases: list[str],
+        alternative_encodings: list[str],
         language: str,
-        alphabets: List[str],
+        alphabets: list[str],
         has_sig_or_bom: bool,
         chaos: float,
         coherence: float,
-        unicode_path: Optional[str],
+        unicode_path: str | None,
         is_preferred: bool,
     ):
         self.path: str = path
-        self.unicode_path: Optional[str] = unicode_path
-        self.encoding: Optional[str] = encoding
-        self.encoding_aliases: List[str] = encoding_aliases
-        self.alternative_encodings: List[str] = alternative_encodings
+        self.unicode_path: str | None = unicode_path
+        self.encoding: str | None = encoding
+        self.encoding_aliases: list[str] = encoding_aliases
+        self.alternative_encodings: list[str] = alternative_encodings
         self.language: str = language
-        self.alphabets: List[str] = alphabets
+        self.alphabets: list[str] = alphabets
         self.has_sig_or_bom: bool = has_sig_or_bom
         self.chaos: float = chaos
         self.coherence: float = coherence
         self.is_preferred: bool = is_preferred
 
     @property
-    def __dict__(self) -> Dict[str, Any]:  # type: ignore
+    def __dict__(self) -> dict[str, Any]:  # type: ignore
         return {
             "path": self.path,
             "encoding": self.encoding,
diff --git a/lib/charset_normalizer/utils.py b/lib/charset_normalizer/utils.py
index e5cbbf4c..6bf0384c 100644
--- a/lib/charset_normalizer/utils.py
+++ b/lib/charset_normalizer/utils.py
@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import importlib
 import logging
 import unicodedata
@@ -5,9 +7,11 @@ from codecs import IncrementalDecoder
 from encodings.aliases import aliases
 from functools import lru_cache
 from re import findall
-from typing import Generator, List, Optional, Set, Tuple, Union
+from typing import Generator
 
-from _multibytecodec import MultibyteIncrementalDecoder
+from _multibytecodec import (  # type: ignore[import-not-found,import]
+    MultibyteIncrementalDecoder,
+)
 
 from .constant import (
     ENCODING_MARKS,
@@ -16,6 +20,7 @@ from .constant import (
     UNICODE_RANGES_COMBINED,
     UNICODE_SECONDARY_RANGE_KEYWORD,
     UTF8_MAXIMAL_ALLOCATION,
+    COMMON_CJK_CHARACTERS,
 )
 
 
@@ -23,7 +28,7 @@ from .constant import (
 def is_accentuated(character: str) -> bool:
     try:
         description: str = unicodedata.name(character)
-    except ValueError:
+    except ValueError:  # Defensive: unicode database outdated?
         return False
     return (
         "WITH GRAVE" in description
@@ -43,13 +48,13 @@ def remove_accent(character: str) -> str:
     if not decomposed:
         return character
 
-    codes: List[str] = decomposed.split(" ")
+    codes: list[str] = decomposed.split(" ")
 
     return chr(int(codes[0], 16))
 
 
 @lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION)
-def unicode_range(character: str) -> Optional[str]:
+def unicode_range(character: str) -> str | None:
     """
     Retrieve the Unicode range official name from a single character.
     """
@@ -66,7 +71,7 @@ def unicode_range(character: str) -> Optional[str]:
 def is_latin(character: str) -> bool:
     try:
         description: str = unicodedata.name(character)
-    except ValueError:
+    except ValueError:  # Defensive: unicode database outdated?
         return False
     return "LATIN" in description
 
@@ -78,7 +83,7 @@ def is_punctuation(character: str) -> bool:
     if "P" in character_category:
         return True
 
-    character_range: Optional[str] = unicode_range(character)
+    character_range: str | None = unicode_range(character)
 
     if character_range is None:
         return False
@@ -93,7 +98,7 @@ def is_symbol(character: str) -> bool:
     if "S" in character_category or "N" in character_category:
         return True
 
-    character_range: Optional[str] = unicode_range(character)
+    character_range: str | None = unicode_range(character)
 
     if character_range is None:
         return False
@@ -103,7 +108,7 @@ def is_symbol(character: str) -> bool:
 
 @lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION)
 def is_emoticon(character: str) -> bool:
-    character_range: Optional[str] = unicode_range(character)
+    character_range: str | None = unicode_range(character)
 
     if character_range is None:
         return False
@@ -130,7 +135,7 @@ def is_case_variable(character: str) -> bool:
 def is_cjk(character: str) -> bool:
     try:
         character_name = unicodedata.name(character)
-    except ValueError:
+    except ValueError:  # Defensive: unicode database outdated?
         return False
 
     return "CJK" in character_name
@@ -140,7 +145,7 @@ def is_cjk(character: str) -> bool:
 def is_hiragana(character: str) -> bool:
     try:
         character_name = unicodedata.name(character)
-    except ValueError:
+    except ValueError:  # Defensive: unicode database outdated?
         return False
 
     return "HIRAGANA" in character_name
@@ -150,7 +155,7 @@ def is_hiragana(character: str) -> bool:
 def is_katakana(character: str) -> bool:
     try:
         character_name = unicodedata.name(character)
-    except ValueError:
+    except ValueError:  # Defensive: unicode database outdated?
         return False
 
     return "KATAKANA" in character_name
@@ -160,7 +165,7 @@ def is_katakana(character: str) -> bool:
 def is_hangul(character: str) -> bool:
     try:
         character_name = unicodedata.name(character)
-    except ValueError:
+    except ValueError:  # Defensive: unicode database outdated?
         return False
 
     return "HANGUL" in character_name
@@ -170,7 +175,7 @@ def is_hangul(character: str) -> bool:
 def is_thai(character: str) -> bool:
     try:
         character_name = unicodedata.name(character)
-    except ValueError:
+    except ValueError:  # Defensive: unicode database outdated?
         return False
 
     return "THAI" in character_name
@@ -180,7 +185,7 @@ def is_thai(character: str) -> bool:
 def is_arabic(character: str) -> bool:
     try:
         character_name = unicodedata.name(character)
-    except ValueError:
+    except ValueError:  # Defensive: unicode database outdated?
         return False
 
     return "ARABIC" in character_name
@@ -190,12 +195,17 @@ def is_arabic(character: str) -> bool:
 def is_arabic_isolated_form(character: str) -> bool:
     try:
         character_name = unicodedata.name(character)
-    except ValueError:
+    except ValueError:  # Defensive: unicode database outdated?
         return False
 
     return "ARABIC" in character_name and "ISOLATED FORM" in character_name
 
 
+@lru_cache(maxsize=UTF8_MAXIMAL_ALLOCATION)
+def is_cjk_uncommon(character: str) -> bool:
+    return character not in COMMON_CJK_CHARACTERS
+
+
 @lru_cache(maxsize=len(UNICODE_RANGES_COMBINED))
 def is_unicode_range_secondary(range_name: str) -> bool:
     return any(keyword in range_name for keyword in UNICODE_SECONDARY_RANGE_KEYWORD)
@@ -206,13 +216,13 @@ def is_unprintable(character: str) -> bool:
     return (
         character.isspace() is False  # includes \n \t \r \v
         and character.isprintable() is False
-        and character != "\x1A"  # Why? Its the ASCII substitute character.
+        and character != "\x1a"  # Why? Its the ASCII substitute character.
         and character != "\ufeff"  # bug discovered in Python,
         # Zero Width No-Break Space located in 	Arabic Presentation Forms-B, Unicode 1.1 not acknowledged as space.
     )
 
 
-def any_specified_encoding(sequence: bytes, search_zone: int = 8192) -> Optional[str]:
+def any_specified_encoding(sequence: bytes, search_zone: int = 8192) -> str | None:
     """
     Extract using ASCII-only decoder any specified encoding in the first n-bytes.
     """
@@ -221,7 +231,7 @@ def any_specified_encoding(sequence: bytes, search_zone: int = 8192) -> Optional
 
     seq_len: int = len(sequence)
 
-    results: List[str] = findall(
+    results: list[str] = findall(
         RE_POSSIBLE_ENCODING_INDICATION,
         sequence[: min(seq_len, search_zone)].decode("ascii", errors="ignore"),
     )
@@ -260,18 +270,18 @@ def is_multi_byte_encoding(name: str) -> bool:
         "utf_32_be",
         "utf_7",
     } or issubclass(
-        importlib.import_module("encodings.{}".format(name)).IncrementalDecoder,
+        importlib.import_module(f"encodings.{name}").IncrementalDecoder,
         MultibyteIncrementalDecoder,
     )
 
 
-def identify_sig_or_bom(sequence: bytes) -> Tuple[Optional[str], bytes]:
+def identify_sig_or_bom(sequence: bytes) -> tuple[str | None, bytes]:
     """
     Identify and extract SIG/BOM in given sequence.
     """
 
     for iana_encoding in ENCODING_MARKS:
-        marks: Union[bytes, List[bytes]] = ENCODING_MARKS[iana_encoding]
+        marks: bytes | list[bytes] = ENCODING_MARKS[iana_encoding]
 
         if isinstance(marks, bytes):
             marks = [marks]
@@ -288,6 +298,7 @@ def should_strip_sig_or_bom(iana_encoding: str) -> bool:
 
 
 def iana_name(cp_name: str, strict: bool = True) -> str:
+    """Returns the Python normalized encoding name (Not the IANA official name)."""
     cp_name = cp_name.lower().replace("-", "_")
 
     encoding_alias: str
@@ -298,35 +309,17 @@ def iana_name(cp_name: str, strict: bool = True) -> str:
             return encoding_iana
 
     if strict:
-        raise ValueError("Unable to retrieve IANA for '{}'".format(cp_name))
+        raise ValueError(f"Unable to retrieve IANA for '{cp_name}'")
 
     return cp_name
 
 
-def range_scan(decoded_sequence: str) -> List[str]:
-    ranges: Set[str] = set()
-
-    for character in decoded_sequence:
-        character_range: Optional[str] = unicode_range(character)
-
-        if character_range is None:
-            continue
-
-        ranges.add(character_range)
-
-    return list(ranges)
-
-
 def cp_similarity(iana_name_a: str, iana_name_b: str) -> float:
     if is_multi_byte_encoding(iana_name_a) or is_multi_byte_encoding(iana_name_b):
         return 0.0
 
-    decoder_a = importlib.import_module(
-        "encodings.{}".format(iana_name_a)
-    ).IncrementalDecoder
-    decoder_b = importlib.import_module(
-        "encodings.{}".format(iana_name_b)
-    ).IncrementalDecoder
+    decoder_a = importlib.import_module(f"encodings.{iana_name_a}").IncrementalDecoder
+    decoder_b = importlib.import_module(f"encodings.{iana_name_b}").IncrementalDecoder
 
     id_a: IncrementalDecoder = decoder_a(errors="ignore")
     id_b: IncrementalDecoder = decoder_b(errors="ignore")
@@ -374,7 +367,7 @@ def cut_sequence_chunks(
     strip_sig_or_bom: bool,
     sig_payload: bytes,
     is_multi_byte_decoder: bool,
-    decoded_payload: Optional[str] = None,
+    decoded_payload: str | None = None,
 ) -> Generator[str, None, None]:
     if decoded_payload and is_multi_byte_decoder is False:
         for i in offsets:
diff --git a/lib/charset_normalizer/version.py b/lib/charset_normalizer/version.py
index 699990ee..e5687e3c 100644
--- a/lib/charset_normalizer/version.py
+++ b/lib/charset_normalizer/version.py
@@ -2,5 +2,7 @@
 Expose version
 """
 
-__version__ = "3.4.0"
+from __future__ import annotations
+
+__version__ = "3.4.2"
 VERSION = __version__.split(".")
diff --git a/lib/plexapi/audio.py b/lib/plexapi/audio.py
index 05d38a9c..3bc6f514 100644
--- a/lib/plexapi/audio.py
+++ b/lib/plexapi/audio.py
@@ -8,7 +8,7 @@ from urllib.parse import quote_plus
 from typing import Any, Dict, List, Optional, TypeVar
 
 from plexapi import media, utils
-from plexapi.base import Playable, PlexPartialObject, PlexHistory, PlexSession
+from plexapi.base import Playable, PlexPartialObject, PlexHistory, PlexSession, cached_data_property
 from plexapi.exceptions import BadRequest
 from plexapi.mixins import (
     AdvancedSettingsMixin, SplitMergeMixin, UnmatchMatchMixin, ExtrasMixin, HubsMixin, PlayedUnplayedMixin, RatingMixin,
@@ -59,14 +59,11 @@ class Audio(PlexPartialObject, PlayedUnplayedMixin):
 
     def _loadData(self, data):
         """ Load attribute values from Plex XML response. """
-        self._data = data
         self.addedAt = utils.toDatetime(data.attrib.get('addedAt'))
         self.art = data.attrib.get('art')
         self.artBlurHash = data.attrib.get('artBlurHash')
         self.distance = utils.cast(float, data.attrib.get('distance'))
-        self.fields = self.findItems(data, media.Field)
         self.guid = data.attrib.get('guid')
-        self.images = self.findItems(data, media.Image)
         self.index = utils.cast(int, data.attrib.get('index'))
         self.key = data.attrib.get('key', '')
         self.lastRatedAt = utils.toDatetime(data.attrib.get('lastRatedAt'))
@@ -75,7 +72,6 @@ class Audio(PlexPartialObject, PlayedUnplayedMixin):
         self.librarySectionKey = data.attrib.get('librarySectionKey')
         self.librarySectionTitle = data.attrib.get('librarySectionTitle')
         self.listType = 'audio'
-        self.moods = self.findItems(data, media.Mood)
         self.musicAnalysisVersion = utils.cast(int, data.attrib.get('musicAnalysisVersion'))
         self.ratingKey = utils.cast(int, data.attrib.get('ratingKey'))
         self.summary = data.attrib.get('summary')
@@ -88,6 +84,18 @@ class Audio(PlexPartialObject, PlayedUnplayedMixin):
         self.userRating = utils.cast(float, data.attrib.get('userRating'))
         self.viewCount = utils.cast(int, data.attrib.get('viewCount', 0))
 
+    @cached_data_property
+    def fields(self):
+        return self.findItems(self._data, media.Field)
+
+    @cached_data_property
+    def images(self):
+        return self.findItems(self._data, media.Image)
+
+    @cached_data_property
+    def moods(self):
+        return self.findItems(self._data, media.Mood)
+
     def url(self, part):
         """ Returns the full URL for the audio item. Typically used for getting a specific track. """
         return self._server.url(part, includeToken=True) if part else None
@@ -205,18 +213,45 @@ class Artist(
         Audio._loadData(self, data)
         self.albumSort = utils.cast(int, data.attrib.get('albumSort', '-1'))
         self.audienceRating = utils.cast(float, data.attrib.get('audienceRating'))
-        self.collections = self.findItems(data, media.Collection)
-        self.countries = self.findItems(data, media.Country)
-        self.genres = self.findItems(data, media.Genre)
-        self.guids = self.findItems(data, media.Guid)
         self.key = self.key.replace('/children', '')  # FIX_BUG_50
-        self.labels = self.findItems(data, media.Label)
-        self.locations = self.listAttrs(data, 'path', etag='Location')
         self.rating = utils.cast(float, data.attrib.get('rating'))
-        self.similar = self.findItems(data, media.Similar)
-        self.styles = self.findItems(data, media.Style)
         self.theme = data.attrib.get('theme')
-        self.ultraBlurColors = self.findItem(data, media.UltraBlurColors)
+
+    @cached_data_property
+    def collections(self):
+        return self.findItems(self._data, media.Collection)
+
+    @cached_data_property
+    def countries(self):
+        return self.findItems(self._data, media.Country)
+
+    @cached_data_property
+    def genres(self):
+        return self.findItems(self._data, media.Genre)
+
+    @cached_data_property
+    def guids(self):
+        return self.findItems(self._data, media.Guid)
+
+    @cached_data_property
+    def labels(self):
+        return self.findItems(self._data, media.Label)
+
+    @cached_data_property
+    def locations(self):
+        return self.listAttrs(self._data, 'path', etag='Location')
+
+    @cached_data_property
+    def similar(self):
+        return self.findItems(self._data, media.Similar)
+
+    @cached_data_property
+    def styles(self):
+        return self.findItems(self._data, media.Style)
+
+    @cached_data_property
+    def ultraBlurColors(self):
+        return self.findItem(self._data, media.UltraBlurColors)
 
     def __iter__(self):
         for album in self.albums():
@@ -355,12 +390,7 @@ class Album(
         """ Load attribute values from Plex XML response. """
         Audio._loadData(self, data)
         self.audienceRating = utils.cast(float, data.attrib.get('audienceRating'))
-        self.collections = self.findItems(data, media.Collection)
-        self.formats = self.findItems(data, media.Format)
-        self.genres = self.findItems(data, media.Genre)
-        self.guids = self.findItems(data, media.Guid)
         self.key = self.key.replace('/children', '')  # FIX_BUG_50
-        self.labels = self.findItems(data, media.Label)
         self.leafCount = utils.cast(int, data.attrib.get('leafCount'))
         self.loudnessAnalysisVersion = utils.cast(int, data.attrib.get('loudnessAnalysisVersion'))
         self.originallyAvailableAt = utils.toDatetime(data.attrib.get('originallyAvailableAt'), '%Y-%m-%d')
@@ -372,12 +402,41 @@ class Album(
         self.parentTitle = data.attrib.get('parentTitle')
         self.rating = utils.cast(float, data.attrib.get('rating'))
         self.studio = data.attrib.get('studio')
-        self.styles = self.findItems(data, media.Style)
-        self.subformats = self.findItems(data, media.Subformat)
-        self.ultraBlurColors = self.findItem(data, media.UltraBlurColors)
         self.viewedLeafCount = utils.cast(int, data.attrib.get('viewedLeafCount'))
         self.year = utils.cast(int, data.attrib.get('year'))
 
+    @cached_data_property
+    def collections(self):
+        return self.findItems(self._data, media.Collection)
+
+    @cached_data_property
+    def formats(self):
+        return self.findItems(self._data, media.Format)
+
+    @cached_data_property
+    def genres(self):
+        return self.findItems(self._data, media.Genre)
+
+    @cached_data_property
+    def guids(self):
+        return self.findItems(self._data, media.Guid)
+
+    @cached_data_property
+    def labels(self):
+        return self.findItems(self._data, media.Label)
+
+    @cached_data_property
+    def styles(self):
+        return self.findItems(self._data, media.Style)
+
+    @cached_data_property
+    def subformats(self):
+        return self.findItems(self._data, media.Subformat)
+
+    @cached_data_property
+    def ultraBlurColors(self):
+        return self.findItem(self._data, media.UltraBlurColors)
+
     def __iter__(self):
         for track in self.tracks():
             yield track
@@ -495,11 +554,8 @@ class Track(
         Audio._loadData(self, data)
         Playable._loadData(self, data)
         self.audienceRating = utils.cast(float, data.attrib.get('audienceRating'))
-        self.chapters = self.findItems(data, media.Chapter)
         self.chapterSource = data.attrib.get('chapterSource')
-        self.collections = self.findItems(data, media.Collection)
         self.duration = utils.cast(int, data.attrib.get('duration'))
-        self.genres = self.findItems(data, media.Genre)
         self.grandparentArt = data.attrib.get('grandparentArt')
         self.grandparentGuid = data.attrib.get('grandparentGuid')
         self.grandparentKey = data.attrib.get('grandparentKey')
@@ -507,9 +563,6 @@ class Track(
         self.grandparentTheme = data.attrib.get('grandparentTheme')
         self.grandparentThumb = data.attrib.get('grandparentThumb')
         self.grandparentTitle = data.attrib.get('grandparentTitle')
-        self.guids = self.findItems(data, media.Guid)
-        self.labels = self.findItems(data, media.Label)
-        self.media = self.findItems(data, media.Media)
         self.originalTitle = data.attrib.get('originalTitle')
         self.parentGuid = data.attrib.get('parentGuid')
         self.parentIndex = utils.cast(int, data.attrib.get('parentIndex'))
@@ -525,6 +578,30 @@ class Track(
         self.viewOffset = utils.cast(int, data.attrib.get('viewOffset', 0))
         self.year = utils.cast(int, data.attrib.get('year'))
 
+    @cached_data_property
+    def chapters(self):
+        return self.findItems(self._data, media.Chapter)
+
+    @cached_data_property
+    def collections(self):
+        return self.findItems(self._data, media.Collection)
+
+    @cached_data_property
+    def genres(self):
+        return self.findItems(self._data, media.Genre)
+
+    @cached_data_property
+    def guids(self):
+        return self.findItems(self._data, media.Guid)
+
+    @cached_data_property
+    def labels(self):
+        return self.findItems(self._data, media.Label)
+
+    @cached_data_property
+    def media(self):
+        return self.findItems(self._data, media.Media)
+
     @property
     def locations(self):
         """ This does not exist in plex xml response but is added to have a common
diff --git a/lib/plexapi/base.py b/lib/plexapi/base.py
index 675ac5d9..fc519bb1 100644
--- a/lib/plexapi/base.py
+++ b/lib/plexapi/base.py
@@ -39,7 +39,42 @@ OPERATORS = {
 }
 
 
-class PlexObject:
+class cached_data_property(cached_property):
+    """Caching for PlexObject data properties.
+
+    This decorator creates properties that cache their values with
+    automatic invalidation on data changes.
+    """
+
+    def __set_name__(self, owner, name):
+        """Register the annotated property in the parent class's _cached_data_properties set."""
+        super().__set_name__(owner, name)
+        if not hasattr(owner, '_cached_data_properties'):
+            owner._cached_data_properties = set()
+        owner._cached_data_properties.add(name)
+
+
+class PlexObjectMeta(type):
+    """Metaclass for PlexObject to handle cached_data_properties."""
+    def __new__(mcs, name, bases, attrs):
+        cached_data_props = set()
+
+        # Merge all _cached_data_properties from parent classes
+        for base in bases:
+            if hasattr(base, '_cached_data_properties'):
+                cached_data_props.update(base._cached_data_properties)
+
+        # Find all properties annotated with cached_data_property in the current class
+        for attr_name, attr_value in attrs.items():
+            if isinstance(attr_value, cached_data_property):
+                cached_data_props.add(attr_name)
+
+        attrs['_cached_data_properties'] = cached_data_props
+
+        return super().__new__(mcs, name, bases, attrs)
+
+
+class PlexObject(metaclass=PlexObjectMeta):
     """ Base class for all Plex objects.
 
         Parameters:
@@ -387,7 +422,7 @@ class PlexObject:
         return results
 
     def reload(self, key=None, **kwargs):
-        """ Reload the data for this object from self.key.
+        """ Reload the data for this object.
 
             Parameters:
                 key (string, optional): Override the key to reload.
@@ -435,7 +470,7 @@ class PlexObject:
         self._initpath = key
         data = self._server.query(key)
         self._overwriteNone = _overwriteNone
-        self._loadData(data[0])
+        self._invalidateCacheAndLoadData(data[0])
         self._overwriteNone = True
         return self
 
@@ -497,9 +532,35 @@ class PlexObject:
             return float(value)
         return value
 
+    def _invalidateCacheAndLoadData(self, data):
+        """Load attribute values from Plex XML response and invalidate cached properties."""
+        old_data_id = id(getattr(self, '_data', None))
+        self._data = data
+
+        # If the data's object ID has changed, invalidate cached properties
+        if id(data) != old_data_id:
+            self._invalidateCachedProperties()
+
+        self._loadData(data)
+
+    def _invalidateCachedProperties(self):
+        """Invalidate all cached data property values."""
+        cached_props = getattr(self.__class__, '_cached_data_properties', set())
+
+        for prop_name in cached_props:
+            if prop_name in self.__dict__:
+                del self.__dict__[prop_name]
+
     def _loadData(self, data):
+        """ Load attribute values from Plex XML response. """
         raise NotImplementedError('Abstract method not implemented.')
 
+    def _findAndLoadElem(self, data, **kwargs):
+        """ Find and load the first element in the data that matches the specified attributes. """
+        for elem in data:
+            if self._checkAttrs(elem, **kwargs):
+                self._invalidateCacheAndLoadData(elem)
+
     @property
     def _searchType(self):
         return self.TYPE
@@ -754,7 +815,7 @@ class PlexPartialObject(PlexObject):
 
 
 class Playable:
-    """ This is a general place to store functions specific to media that is Playable.
+    """ This is a mixin to store functions specific to media that is Playable.
         Things were getting mixed up a bit when dealing with Shows, Season, Artists,
         Albums which are all not playable.
 
@@ -764,6 +825,7 @@ class Playable:
     """
 
     def _loadData(self, data):
+        """ Load attribute values from Plex XML response. """
         self.playlistItemID = utils.cast(int, data.attrib.get('playlistItemID'))    # playlist
         self.playQueueItemID = utils.cast(int, data.attrib.get('playQueueItemID'))  # playqueue
 
@@ -931,8 +993,8 @@ class Playable:
         return self
 
 
-class PlexSession(object):
-    """ This is a general place to store functions specific to media that is a Plex Session.
+class PlexSession:
+    """ This is a mixin to store functions specific to media that is a Plex Session.
 
         Attributes:
             live (bool): True if this is a live tv session.
@@ -945,23 +1007,44 @@ class PlexSession(object):
     """
 
     def _loadData(self, data):
+        """ Load attribute values from Plex XML response. """
         self.live = utils.cast(bool, data.attrib.get('live', '0'))
-        self.player = self.findItem(data, etag='Player')
-        self.session = self.findItem(data, etag='Session')
         self.sessionKey = utils.cast(int, data.attrib.get('sessionKey'))
-        self.transcodeSession = self.findItem(data, etag='TranscodeSession')
 
         user = data.find('User')
         self._username = user.attrib.get('title')
         self._userId = utils.cast(int, user.attrib.get('id'))
 
         # For backwards compatibility
-        self.players = [self.player] if self.player else []
-        self.sessions = [self.session] if self.session else []
-        self.transcodeSessions = [self.transcodeSession] if self.transcodeSession else []
         self.usernames = [self._username] if self._username else []
+        # `players`, `sessions`, and `transcodeSessions` are returned with properties
+        # to support lazy loading. See PR #1510
 
-    @cached_property
+    @cached_data_property
+    def player(self):
+        return self.findItem(self._data, etag='Player')
+
+    @cached_data_property
+    def session(self):
+        return self.findItem(self._data, etag='Session')
+
+    @cached_data_property
+    def transcodeSession(self):
+        return self.findItem(self._data, etag='TranscodeSession')
+
+    @property
+    def players(self):
+        return [self.player] if self.player else []
+
+    @property
+    def sessions(self):
+        return [self.session] if self.session else []
+
+    @property
+    def transcodeSessions(self):
+        return [self.transcodeSession] if self.transcodeSession else []
+
+    @cached_data_property
     def user(self):
         """ Returns the :class:`~plexapi.myplex.MyPlexAccount` object (for admin)
             or :class:`~plexapi.myplex.MyPlexUser` object (for users) for this session.
@@ -978,18 +1061,11 @@ class PlexSession(object):
         """
         return self._reload()
 
-    def _reload(self, _autoReload=False, **kwargs):
-        """ Perform the actual reload. """
-        # Do not auto reload sessions
-        if _autoReload:
-            return self
-
+    def _reload(self, **kwargs):
+        """ Reload the data for the session. """
         key = self._initpath
         data = self._server.query(key)
-        for elem in data:
-            if elem.attrib.get('sessionKey') == str(self.sessionKey):
-                self._loadData(elem)
-                break
+        self._findAndLoadElem(data, sessionKey=str(self.sessionKey))
         return self
 
     def source(self):
@@ -1010,8 +1086,8 @@ class PlexSession(object):
         return self._server.query(key, params=params)
 
 
-class PlexHistory(object):
-    """ This is a general place to store functions specific to media that is a Plex history item.
+class PlexHistory:
+    """ This is a mixin to store functions specific to media that is a Plex history item.
 
         Attributes:
             accountID (int): The associated :class:`~plexapi.server.SystemAccount` ID.
@@ -1021,6 +1097,7 @@ class PlexHistory(object):
     """
 
     def _loadData(self, data):
+        """ Load attribute values from Plex XML response. """
         self.accountID = utils.cast(int, data.attrib.get('accountID'))
         self.deviceID = utils.cast(int, data.attrib.get('deviceID'))
         self.historyKey = data.attrib.get('historyKey')
@@ -1124,7 +1201,7 @@ class MediaContainer(
                 setattr(self, key, getattr(__iterable, key))
 
     def _loadData(self, data):
-        self._data = data
+        """ Load attribute values from Plex XML response. """
         self.allowSync = utils.cast(int, data.attrib.get('allowSync'))
         self.augmentationKey = data.attrib.get('augmentationKey')
         self.identifier = data.attrib.get('identifier')
diff --git a/lib/plexapi/client.py b/lib/plexapi/client.py
index 3d89e3dc..9a904b40 100644
--- a/lib/plexapi/client.py
+++ b/lib/plexapi/client.py
@@ -115,7 +115,7 @@ class PlexClient(PlexObject):
                 )
         else:
             client = data[0]
-        self._loadData(client)
+        self._invalidateCacheAndLoadData(client)
         return self
 
     def reload(self):
@@ -124,7 +124,6 @@ class PlexClient(PlexObject):
 
     def _loadData(self, data):
         """ Load attribute values from Plex XML response. """
-        self._data = data
         self.deviceClass = data.attrib.get('deviceClass')
         self.machineIdentifier = data.attrib.get('machineIdentifier')
         self.product = data.attrib.get('product')
@@ -197,8 +196,7 @@ class PlexClient(PlexObject):
                 raise NotFound(message)
             else:
                 raise BadRequest(message)
-        data = utils.cleanXMLString(response.text).encode('utf8')
-        return ElementTree.fromstring(data) if data.strip() else None
+        return utils.parseXMLString(response.text)
 
     def sendCommand(self, command, proxy=None, **params):
         """ Convenience wrapper around :func:`~plexapi.client.PlexClient.query` to more easily
@@ -222,7 +220,7 @@ class PlexClient(PlexObject):
         proxy = self._proxyThroughServer if proxy is None else proxy
         query = self._server.query if proxy else self.query
 
-        # Workaround for ptp. See https://github.com/pkkid/python-plexapi/issues/244
+        # Workaround for ptp. See https://github.com/pushingkarmaorg/python-plexapi/issues/244
         t = time.time()
         if command == 'timeline/poll':
             self._last_call = t
@@ -606,7 +604,7 @@ class ClientTimeline(PlexObject):
     key = 'timeline/poll'
 
     def _loadData(self, data):
-        self._data = data
+        """ Load attribute values from Plex XML response. """
         self.address = data.attrib.get('address')
         self.audioStreamId = utils.cast(int, data.attrib.get('audioStreamId'))
         self.autoPlay = utils.cast(bool, data.attrib.get('autoPlay'))
diff --git a/lib/plexapi/collection.py b/lib/plexapi/collection.py
index 63ea8373..308604a0 100644
--- a/lib/plexapi/collection.py
+++ b/lib/plexapi/collection.py
@@ -3,7 +3,7 @@ from pathlib import Path
 from urllib.parse import quote_plus
 
 from plexapi import media, utils
-from plexapi.base import PlexPartialObject
+from plexapi.base import PlexPartialObject, cached_data_property
 from plexapi.exceptions import BadRequest, NotFound, Unsupported
 from plexapi.library import LibrarySection, ManagedHub
 from plexapi.mixins import (
@@ -69,7 +69,7 @@ class Collection(
     TYPE = 'collection'
 
     def _loadData(self, data):
-        self._data = data
+        """ Load attribute values from Plex XML response. """
         self.addedAt = utils.toDatetime(data.attrib.get('addedAt'))
         self.art = data.attrib.get('art')
         self.artBlurHash = data.attrib.get('artBlurHash')
@@ -81,12 +81,9 @@ class Collection(
         self.collectionSort = utils.cast(int, data.attrib.get('collectionSort', '0'))
         self.content = data.attrib.get('content')
         self.contentRating = data.attrib.get('contentRating')
-        self.fields = self.findItems(data, media.Field)
         self.guid = data.attrib.get('guid')
-        self.images = self.findItems(data, media.Image)
         self.index = utils.cast(int, data.attrib.get('index'))
         self.key = data.attrib.get('key', '').replace('/children', '')  # FIX_BUG_50
-        self.labels = self.findItems(data, media.Label)
         self.lastRatedAt = utils.toDatetime(data.attrib.get('lastRatedAt'))
         self.librarySectionID = utils.cast(int, data.attrib.get('librarySectionID'))
         self.librarySectionKey = data.attrib.get('librarySectionKey')
@@ -105,12 +102,24 @@ class Collection(
         self.title = data.attrib.get('title')
         self.titleSort = data.attrib.get('titleSort', self.title)
         self.type = data.attrib.get('type')
-        self.ultraBlurColors = self.findItem(data, media.UltraBlurColors)
         self.updatedAt = utils.toDatetime(data.attrib.get('updatedAt'))
         self.userRating = utils.cast(float, data.attrib.get('userRating'))
-        self._items = None  # cache for self.items
-        self._section = None  # cache for self.section
-        self._filters = None  # cache for self.filters
+
+    @cached_data_property
+    def fields(self):
+        return self.findItems(self._data, media.Field)
+
+    @cached_data_property
+    def images(self):
+        return self.findItems(self._data, media.Image)
+
+    @cached_data_property
+    def labels(self):
+        return self.findItems(self._data, media.Label)
+
+    @cached_data_property
+    def ultraBlurColors(self):
+        return self.findItem(self._data, media.UltraBlurColors)
 
     def __len__(self):  # pragma: no cover
         return len(self.items())
@@ -162,20 +171,26 @@ class Collection(
     def children(self):
         return self.items()
 
+    @cached_data_property
+    def _filters(self):
+        """ Cache for filters. """
+        return self._parseFilters(self.content)
+
     def filters(self):
         """ Returns the search filter dict for smart collection.
             The filter dict be passed back into :func:`~plexapi.library.LibrarySection.search`
             to get the list of items.
         """
-        if self.smart and self._filters is None:
-            self._filters = self._parseFilters(self.content)
         return self._filters
 
+    @cached_data_property
+    def _section(self):
+        """ Cache for section. """
+        return super(Collection, self).section()
+
     def section(self):
         """ Returns the :class:`~plexapi.library.LibrarySection` this collection belongs to.
         """
-        if self._section is None:
-            self._section = super(Collection, self).section()
         return self._section
 
     def item(self, title):
@@ -192,12 +207,14 @@ class Collection(
                 return item
         raise NotFound(f'Item with title "{title}" not found in the collection')
 
+    @cached_data_property
+    def _items(self):
+        """ Cache for the items. """
+        key = f'{self.key}/children'
+        return self.fetchItems(key)
+
     def items(self):
         """ Returns a list of all items in the collection. """
-        if self._items is None:
-            key = f'{self.key}/children'
-            items = self.fetchItems(key)
-            self._items = items
         return self._items
 
     def visibility(self):
diff --git a/lib/plexapi/const.py b/lib/plexapi/const.py
index bc3e81aa..5b88be9c 100644
--- a/lib/plexapi/const.py
+++ b/lib/plexapi/const.py
@@ -3,7 +3,7 @@
 
 # Library version
 MAJOR_VERSION = 4
-MINOR_VERSION = 16
-PATCH_VERSION = 1
+MINOR_VERSION = 17
+PATCH_VERSION = 0
 __short_version__ = f"{MAJOR_VERSION}.{MINOR_VERSION}"
 __version__ = f"{__short_version__}.{PATCH_VERSION}"
diff --git a/lib/plexapi/library.py b/lib/plexapi/library.py
index 93801a1d..5d54b6a8 100644
--- a/lib/plexapi/library.py
+++ b/lib/plexapi/library.py
@@ -6,11 +6,10 @@ from typing import Any, TYPE_CHECKING
 import warnings
 from collections import defaultdict
 from datetime import datetime
-from functools import cached_property
 from urllib.parse import parse_qs, quote_plus, urlencode, urlparse
 
 from plexapi import log, media, utils
-from plexapi.base import OPERATORS, PlexObject
+from plexapi.base import OPERATORS, PlexObject, cached_data_property
 from plexapi.exceptions import BadRequest, NotFound
 from plexapi.mixins import (
     MovieEditMixins, ShowEditMixins, SeasonEditMixins, EpisodeEditMixins,
@@ -39,14 +38,13 @@ class Library(PlexObject):
     key = '/library'
 
     def _loadData(self, data):
-        self._data = data
+        """ Load attribute values from Plex XML response. """
         self.identifier = data.attrib.get('identifier')
         self.mediaTagVersion = data.attrib.get('mediaTagVersion')
         self.title1 = data.attrib.get('title1')
         self.title2 = data.attrib.get('title2')
-        self._sectionsByID = {}  # cached sections by key
-        self._sectionsByTitle = {}  # cached sections by title
 
+    @cached_data_property
     def _loadSections(self):
         """ Loads and caches all the library sections. """
         key = '/library/sections'
@@ -64,15 +62,23 @@ class Library(PlexObject):
             sectionsByID[section.key] = section
             sectionsByTitle[section.title.lower().strip()].append(section)
 
-        self._sectionsByID = sectionsByID
-        self._sectionsByTitle = dict(sectionsByTitle)
+        return sectionsByID, dict(sectionsByTitle)
+
+    @property
+    def _sectionsByID(self):
+        """ Returns a dictionary of all library sections by ID. """
+        return self._loadSections[0]
+
+    @property
+    def _sectionsByTitle(self):
+        """ Returns a dictionary of all library sections by title. """
+        return self._loadSections[1]
 
     def sections(self):
         """ Returns a list of all media sections in this library. Library sections may be any of
             :class:`~plexapi.library.MovieSection`, :class:`~plexapi.library.ShowSection`,
             :class:`~plexapi.library.MusicSection`, :class:`~plexapi.library.PhotoSection`.
         """
-        self._loadSections()
         return list(self._sectionsByID.values())
 
     def section(self, title):
@@ -87,8 +93,6 @@ class Library(PlexObject):
                 :exc:`~plexapi.exceptions.NotFound`: The library section title is not found on the server.
         """
         normalized_title = title.lower().strip()
-        if not self._sectionsByTitle or normalized_title not in self._sectionsByTitle:
-            self._loadSections()
         try:
             sections = self._sectionsByTitle[normalized_title]
         except KeyError:
@@ -110,8 +114,6 @@ class Library(PlexObject):
             Raises:
                 :exc:`~plexapi.exceptions.NotFound`: The library section ID is not found on the server.
         """
-        if not self._sectionsByID or sectionID not in self._sectionsByID:
-            self._loadSections()
         try:
             return self._sectionsByID[sectionID]
         except KeyError:
@@ -385,7 +387,9 @@ class Library(PlexObject):
         if kwargs:
             prefs_params = {f'prefs[{k}]': v for k, v in kwargs.items()}
             part += f'&{urlencode(prefs_params)}'
-        return self._server.query(part, method=self._server._session.post)
+        data = self._server.query(part, method=self._server._session.post)
+        self._invalidateCachedProperties()
+        return data
 
     def history(self, maxresults=None, mindate=None):
         """ Get Play History for all library Sections for the owner.
@@ -432,7 +436,7 @@ class LibrarySection(PlexObject):
     """
 
     def _loadData(self, data):
-        self._data = data
+        """ Load attribute values from Plex XML response. """
         self.agent = data.attrib.get('agent')
         self.allowSync = utils.cast(bool, data.attrib.get('allowSync'))
         self.art = data.attrib.get('art')
@@ -441,7 +445,6 @@ class LibrarySection(PlexObject):
         self.filters = utils.cast(bool, data.attrib.get('filters'))
         self.key = utils.cast(int, data.attrib.get('key'))
         self.language = data.attrib.get('language')
-        self.locations = self.listAttrs(data, 'path', etag='Location')
         self.refreshing = utils.cast(bool, data.attrib.get('refreshing'))
         self.scanner = data.attrib.get('scanner')
         self.thumb = data.attrib.get('thumb')
@@ -449,14 +452,12 @@ class LibrarySection(PlexObject):
         self.type = data.attrib.get('type')
         self.updatedAt = utils.toDatetime(data.attrib.get('updatedAt'))
         self.uuid = data.attrib.get('uuid')
-        # Private attrs as we don't want a reload.
-        self._filterTypes = None
-        self._fieldTypes = None
-        self._totalViewSize = None
-        self._totalDuration = None
-        self._totalStorage = None
 
-    @cached_property
+    @cached_data_property
+    def locations(self):
+        return self.listAttrs(self._data, 'path', etag='Location')
+
+    @cached_data_property
     def totalSize(self):
         """ Returns the total number of items in the library for the default library type. """
         return self.totalViewSize(includeCollections=False)
@@ -464,16 +465,12 @@ class LibrarySection(PlexObject):
     @property
     def totalDuration(self):
         """ Returns the total duration (in milliseconds) of items in the library. """
-        if self._totalDuration is None:
-            self._getTotalDurationStorage()
-        return self._totalDuration
+        return self._getTotalDurationStorage[0]
 
     @property
     def totalStorage(self):
         """ Returns the total storage (in bytes) of items in the library. """
-        if self._totalStorage is None:
-            self._getTotalDurationStorage()
-        return self._totalStorage
+        return self._getTotalDurationStorage[1]
 
     def __getattribute__(self, attr):
         # Intercept to call EditFieldMixin and EditTagMixin methods
@@ -489,6 +486,7 @@ class LibrarySection(PlexObject):
                 )
         return value
 
+    @cached_data_property
     def _getTotalDurationStorage(self):
         """ Queries the Plex server for the total library duration and storage and caches the values. """
         data = self._server.query('/media/providers?includeStorage=1')
@@ -499,8 +497,10 @@ class LibrarySection(PlexObject):
         )
         directory = next(iter(data.findall(xpath)), None)
         if directory:
-            self._totalDuration = utils.cast(int, directory.attrib.get('durationTotal'))
-            self._totalStorage = utils.cast(int, directory.attrib.get('storageTotal'))
+            totalDuration = utils.cast(int, directory.attrib.get('durationTotal'))
+            totalStorage = utils.cast(int, directory.attrib.get('storageTotal'))
+            return totalDuration, totalStorage
+        return None, None
 
     def totalViewSize(self, libtype=None, includeCollections=True):
         """ Returns the total number of items in the library for a specified libtype.
@@ -531,18 +531,20 @@ class LibrarySection(PlexObject):
     def delete(self):
         """ Delete a library section. """
         try:
-            return self._server.query(f'/library/sections/{self.key}', method=self._server._session.delete)
+            data = self._server.query(f'/library/sections/{self.key}', method=self._server._session.delete)
+            self._server.library._invalidateCachedProperties()
+            return data
         except BadRequest:  # pragma: no cover
             msg = f'Failed to delete library {self.key}'
             msg += 'You may need to allow this permission in your Plex settings.'
             log.error(msg)
             raise
 
-    def reload(self):
+    def _reload(self, **kwargs):
         """ Reload the data for the library section. """
-        self._server.library._loadSections()
-        newLibrary = self._server.library.sectionByID(self.key)
-        self.__dict__.update(newLibrary.__dict__)
+        key = self._initpath
+        data = self._server.query(key)
+        self._findAndLoadElem(data, key=str(self.key))
         return self
 
     def edit(self, agent=None, **kwargs):
@@ -871,6 +873,7 @@ class LibrarySection(PlexObject):
         self._server.query(key, method=self._server._session.delete)
         return self
 
+    @cached_data_property
     def _loadFilters(self):
         """ Retrieves and caches the list of :class:`~plexapi.library.FilteringType` and
             list of :class:`~plexapi.library.FilteringFieldType` for this library section.
@@ -880,23 +883,23 @@ class LibrarySection(PlexObject):
 
         key = _key.format(key=self.key, filter='all')
         data = self._server.query(key)
-        self._filterTypes = self.findItems(data, FilteringType, rtag='Meta')
-        self._fieldTypes = self.findItems(data, FilteringFieldType, rtag='Meta')
+        filterTypes = self.findItems(data, FilteringType, rtag='Meta')
+        fieldTypes = self.findItems(data, FilteringFieldType, rtag='Meta')
 
         if self.TYPE != 'photo':  # No collections for photo library
             key = _key.format(key=self.key, filter='collections')
             data = self._server.query(key)
-            self._filterTypes.extend(self.findItems(data, FilteringType, rtag='Meta'))
+            filterTypes.extend(self.findItems(data, FilteringType, rtag='Meta'))
 
         # Manually add guid field type, only allowing "is" operator
         guidFieldType = '<FieldType type="guid"><Operator key="=" title="is"/></FieldType>'
-        self._fieldTypes.append(self._manuallyLoadXML(guidFieldType, FilteringFieldType))
+        fieldTypes.append(self._manuallyLoadXML(guidFieldType, FilteringFieldType))
+
+        return filterTypes, fieldTypes
 
     def filterTypes(self):
         """ Returns a list of available :class:`~plexapi.library.FilteringType` for this library section. """
-        if self._filterTypes is None:
-            self._loadFilters()
-        return self._filterTypes
+        return self._loadFilters[0]
 
     def getFilterType(self, libtype=None):
         """ Returns a :class:`~plexapi.library.FilteringType` for a specified libtype.
@@ -918,9 +921,7 @@ class LibrarySection(PlexObject):
 
     def fieldTypes(self):
         """ Returns a list of available :class:`~plexapi.library.FilteringFieldType` for this library section. """
-        if self._fieldTypes is None:
-            self._loadFilters()
-        return self._fieldTypes
+        return self._loadFilters[1]
 
     def getFieldType(self, fieldType):
         """ Returns a :class:`~plexapi.library.FilteringFieldType` for a specified fieldType.
@@ -1969,7 +1970,7 @@ class MusicSection(LibrarySection, ArtistEditMixins, AlbumEditMixins, TrackEditM
 
     def stations(self):
         """ Returns a list of :class:`~plexapi.playlist.Playlist` stations in this section. """
-        return next((hub.items for hub in self.hubs() if hub.context == 'hub.music.stations'), None)
+        return next((hub._partialItems for hub in self.hubs() if hub.context == 'hub.music.stations'), None)
 
     def searchArtists(self, **kwargs):
         """ Search for an artist. See :func:`~plexapi.library.LibrarySection.search` for usage. """
@@ -2165,7 +2166,6 @@ class LibraryTimeline(PlexObject):
 
     def _loadData(self, data):
         """ Load attribute values from Plex XML response. """
-        self._data = data
         self.size = utils.cast(int, data.attrib.get('size'))
         self.allowSync = utils.cast(bool, data.attrib.get('allowSync'))
         self.art = data.attrib.get('art')
@@ -2194,7 +2194,6 @@ class Location(PlexObject):
 
     def _loadData(self, data):
         """ Load attribute values from Plex XML response. """
-        self._data = data
         self.id = utils.cast(int, data.attrib.get('id'))
         self.path = data.attrib.get('path')
 
@@ -2208,9 +2207,10 @@ class Hub(PlexObject):
             context (str): The context of the hub.
             hubKey (str): API URL for these specific hub items.
             hubIdentifier (str): The identifier of the hub.
-            items (list): List of items in the hub.
+            items (list): List of items in the hub (automatically loads all items if more is True).
             key (str): API URL for the hub.
-            more (bool): True if there are more items to load (call reload() to fetch all items).
+            random (bool): True if the items in the hub are randomized.
+            more (bool): True if there are more items to load (call items to fetch all items).
             size (int): The number of items in the hub.
             style (str): The style of the hub.
             title (str): The title of the hub.
@@ -2220,36 +2220,57 @@ class Hub(PlexObject):
 
     def _loadData(self, data):
         """ Load attribute values from Plex XML response. """
-        self._data = data
         self.context = data.attrib.get('context')
         self.hubKey = data.attrib.get('hubKey')
         self.hubIdentifier = data.attrib.get('hubIdentifier')
-        self.items = self.findItems(data)
         self.key = data.attrib.get('key')
         self.more = utils.cast(bool, data.attrib.get('more'))
+        self.random = utils.cast(bool, data.attrib.get('random', '0'))
         self.size = utils.cast(int, data.attrib.get('size'))
         self.style = data.attrib.get('style')
         self.title = data.attrib.get('title')
         self.type = data.attrib.get('type')
-        self._section = None  # cache for self.section
 
     def __len__(self):
         return self.size
 
-    def reload(self):
-        """ Reloads the hub to fetch all items in the hub. """
-        if self.more and self.key:
-            self.items = self.fetchItems(self.key)
+    @cached_data_property
+    def _partialItems(self):
+        """ Cache for partial items. """
+        return self.findItems(self._data)
+
+    @cached_data_property
+    def _items(self):
+        """ Cache for items. """
+        if self.more and self.key:  # If there are more items to load, fetch them
+            items = self.fetchItems(self.key)
             self.more = False
-            self.size = len(self.items)
+            self.size = len(items)
+            return items
+        # Otherwise, all the data is in the initial _data XML response
+        return self._partialItems
+
+    def items(self):
+        """ Returns a list of all items in the hub. """
+        return self._items
+
+    @cached_data_property
+    def _section(self):
+        """ Cache for section. """
+        return self._server.library.sectionByID(self.librarySectionID)
 
     def section(self):
         """ Returns the :class:`~plexapi.library.LibrarySection` this hub belongs to.
         """
-        if self._section is None:
-            self._section = self._server.library.sectionByID(self.librarySectionID)
         return self._section
 
+    def _reload(self, **kwargs):
+        """ Reload the data for the hub. """
+        key = self._initpath
+        data = self._server.query(key)
+        self._findAndLoadElem(data, hubIdentifier=self.hubIdentifier)
+        return self
+
 
 class LibraryMediaTag(PlexObject):
     """ Base class of library media tags.
@@ -2279,7 +2300,6 @@ class LibraryMediaTag(PlexObject):
 
     def _loadData(self, data):
         """ Load attribute values from Plex XML response. """
-        self._data = data
         self.count = utils.cast(int, data.attrib.get('count'))
         self.filter = data.attrib.get('filter')
         self.id = utils.cast(int, data.attrib.get('id'))
@@ -2668,22 +2688,25 @@ class FilteringType(PlexObject):
         return f"<{':'.join([p for p in [self.__class__.__name__, _type] if p])}>"
 
     def _loadData(self, data):
-        self._data = data
+        """ Load attribute values from Plex XML response. """
         self.active = utils.cast(bool, data.attrib.get('active', '0'))
-        self.fields = self.findItems(data, FilteringField)
-        self.filters = self.findItems(data, FilteringFilter)
         self.key = data.attrib.get('key')
-        self.sorts = self.findItems(data, FilteringSort)
         self.title = data.attrib.get('title')
         self.type = data.attrib.get('type')
 
         self._librarySectionID = self._parent().key
 
-        # Add additional manual filters, sorts, and fields which are available
-        # but not exposed on the Plex server
-        self.filters += self._manualFilters()
-        self.sorts += self._manualSorts()
-        self.fields += self._manualFields()
+    @cached_data_property
+    def fields(self):
+        return self.findItems(self._data, FilteringField) + self._manualFields()
+
+    @cached_data_property
+    def filters(self):
+        return self.findItems(self._data, FilteringFilter) + self._manualFilters()
+
+    @cached_data_property
+    def sorts(self):
+        return self.findItems(self._data, FilteringSort) + self._manualSorts()
 
     def _manualFilters(self):
         """ Manually add additional filters which are available
@@ -2863,7 +2886,7 @@ class FilteringFilter(PlexObject):
     TAG = 'Filter'
 
     def _loadData(self, data):
-        self._data = data
+        """ Load attribute values from Plex XML response. """
         self.filter = data.attrib.get('filter')
         self.filterType = data.attrib.get('filterType')
         self.key = data.attrib.get('key')
@@ -2889,7 +2912,6 @@ class FilteringSort(PlexObject):
 
     def _loadData(self, data):
         """ Load attribute values from Plex XML response. """
-        self._data = data
         self.active = utils.cast(bool, data.attrib.get('active', '0'))
         self.activeDirection = data.attrib.get('activeDirection')
         self.default = data.attrib.get('default')
@@ -2914,7 +2936,6 @@ class FilteringField(PlexObject):
 
     def _loadData(self, data):
         """ Load attribute values from Plex XML response. """
-        self._data = data
         self.key = data.attrib.get('key')
         self.title = data.attrib.get('title')
         self.type = data.attrib.get('type')
@@ -2937,9 +2958,11 @@ class FilteringFieldType(PlexObject):
 
     def _loadData(self, data):
         """ Load attribute values from Plex XML response. """
-        self._data = data
         self.type = data.attrib.get('type')
-        self.operators = self.findItems(data, FilteringOperator)
+
+    @cached_data_property
+    def operators(self):
+        return self.findItems(self._data, FilteringOperator)
 
 
 class FilteringOperator(PlexObject):
@@ -2976,7 +2999,6 @@ class FilterChoice(PlexObject):
 
     def _loadData(self, data):
         """ Load attribute values from Plex XML response. """
-        self._data = data
         self.fastKey = data.attrib.get('fastKey')
         self.key = data.attrib.get('key')
         self.thumb = data.attrib.get('thumb')
@@ -3006,7 +3028,6 @@ class ManagedHub(PlexObject):
 
     def _loadData(self, data):
         """ Load attribute values from Plex XML response. """
-        self._data = data
         self.deletable = utils.cast(bool, data.attrib.get('deletable', True))
         self.homeVisibility = data.attrib.get('homeVisibility', 'none')
         self.identifier = data.attrib.get('identifier')
@@ -3020,11 +3041,11 @@ class ManagedHub(PlexObject):
         parent = self._parent()
         self.librarySectionID = parent.key if isinstance(parent, LibrarySection) else parent.librarySectionID
 
-    def reload(self):
+    def _reload(self, **kwargs):
         """ Reload the data for this managed hub. """
         key = f'/hubs/sections/{self.librarySectionID}/manage'
-        hub = self.fetchItem(key, self.__class__, identifier=self.identifier)
-        self.__dict__.update(hub.__dict__)
+        data = self._server.query(key)
+        self._findAndLoadElem(data, identifier=self.identifier)
         return self
 
     def move(self, after=None):
@@ -3170,7 +3191,6 @@ class FirstCharacter(PlexObject):
 
     def _loadData(self, data):
         """ Load attribute values from Plex XML response. """
-        self._data = data
         self.key = data.attrib.get('key')
         self.size = data.attrib.get('size')
         self.title = data.attrib.get('title')
@@ -3191,6 +3211,7 @@ class Path(PlexObject):
     TAG = 'Path'
 
     def _loadData(self, data):
+        """ Load attribute values from Plex XML response. """
         self.home = utils.cast(bool, data.attrib.get('home'))
         self.key = data.attrib.get('key')
         self.network = utils.cast(bool, data.attrib.get('network'))
@@ -3220,6 +3241,7 @@ class File(PlexObject):
     TAG = 'File'
 
     def _loadData(self, data):
+        """ Load attribute values from Plex XML response. """
         self.key = data.attrib.get('key')
         self.path = data.attrib.get('path')
         self.title = data.attrib.get('title')
@@ -3268,41 +3290,83 @@ class Common(PlexObject):
     TAG = 'Common'
 
     def _loadData(self, data):
-        self._data = data
-        self.collections = self.findItems(data, media.Collection)
+        """ Load attribute values from Plex XML response. """
         self.contentRating = data.attrib.get('contentRating')
-        self.countries = self.findItems(data, media.Country)
-        self.directors = self.findItems(data, media.Director)
         self.editionTitle = data.attrib.get('editionTitle')
-        self.fields = self.findItems(data, media.Field)
-        self.genres = self.findItems(data, media.Genre)
         self.grandparentRatingKey = utils.cast(int, data.attrib.get('grandparentRatingKey'))
         self.grandparentTitle = data.attrib.get('grandparentTitle')
         self.guid = data.attrib.get('guid')
-        self.guids = self.findItems(data, media.Guid)
         self.index = utils.cast(int, data.attrib.get('index'))
         self.key = data.attrib.get('key')
-        self.labels = self.findItems(data, media.Label)
         self.mixedFields = data.attrib.get('mixedFields').split(',')
-        self.moods = self.findItems(data, media.Mood)
         self.originallyAvailableAt = utils.toDatetime(data.attrib.get('originallyAvailableAt'))
         self.parentRatingKey = utils.cast(int, data.attrib.get('parentRatingKey'))
         self.parentTitle = data.attrib.get('parentTitle')
-        self.producers = self.findItems(data, media.Producer)
         self.ratingKey = utils.cast(int, data.attrib.get('ratingKey'))
-        self.ratings = self.findItems(data, media.Rating)
-        self.roles = self.findItems(data, media.Role)
         self.studio = data.attrib.get('studio')
-        self.styles = self.findItems(data, media.Style)
         self.summary = data.attrib.get('summary')
         self.tagline = data.attrib.get('tagline')
-        self.tags = self.findItems(data, media.Tag)
         self.title = data.attrib.get('title')
         self.titleSort = data.attrib.get('titleSort')
         self.type = data.attrib.get('type')
-        self.writers = self.findItems(data, media.Writer)
         self.year = utils.cast(int, data.attrib.get('year'))
 
+    @cached_data_property
+    def collections(self):
+        return self.findItems(self._data, media.Collection)
+
+    @cached_data_property
+    def countries(self):
+        return self.findItems(self._data, media.Country)
+
+    @cached_data_property
+    def directors(self):
+        return self.findItems(self._data, media.Director)
+
+    @cached_data_property
+    def fields(self):
+        return self.findItems(self._data, media.Field)
+
+    @cached_data_property
+    def genres(self):
+        return self.findItems(self._data, media.Genre)
+
+    @cached_data_property
+    def guids(self):
+        return self.findItems(self._data, media.Guid)
+
+    @cached_data_property
+    def labels(self):
+        return self.findItems(self._data, media.Label)
+
+    @cached_data_property
+    def moods(self):
+        return self.findItems(self._data, media.Mood)
+
+    @cached_data_property
+    def producers(self):
+        return self.findItems(self._data, media.Producer)
+
+    @cached_data_property
+    def ratings(self):
+        return self.findItems(self._data, media.Rating)
+
+    @cached_data_property
+    def roles(self):
+        return self.findItems(self._data, media.Role)
+
+    @cached_data_property
+    def styles(self):
+        return self.findItems(self._data, media.Style)
+
+    @cached_data_property
+    def tags(self):
+        return self.findItems(self._data, media.Tag)
+
+    @cached_data_property
+    def writers(self):
+        return self.findItems(self._data, media.Writer)
+
     def __repr__(self):
         return '<%s:%s:%s>' % (
             self.__class__.__name__,
diff --git a/lib/plexapi/media.py b/lib/plexapi/media.py
index 9c6e3115..c1530959 100644
--- a/lib/plexapi/media.py
+++ b/lib/plexapi/media.py
@@ -1,10 +1,10 @@
 # -*- coding: utf-8 -*-
-import xml
 from pathlib import Path
 from urllib.parse import quote_plus
+from xml.etree import ElementTree
 
 from plexapi import log, settings, utils
-from plexapi.base import PlexObject
+from plexapi.base import PlexObject, cached_data_property
 from plexapi.exceptions import BadRequest
 from plexapi.utils import deprecated
 
@@ -51,7 +51,6 @@ class Media(PlexObject):
 
     def _loadData(self, data):
         """ Load attribute values from Plex XML response. """
-        self._data = data
         self.aspectRatio = utils.cast(float, data.attrib.get('aspectRatio'))
         self.audioChannels = utils.cast(int, data.attrib.get('audioChannels'))
         self.audioCodec = data.attrib.get('audioCodec')
@@ -64,7 +63,6 @@ class Media(PlexObject):
         self.has64bitOffsets = utils.cast(bool, data.attrib.get('has64bitOffsets'))
         self.hasVoiceActivity = utils.cast(bool, data.attrib.get('hasVoiceActivity', '0'))
         self.optimizedForStreaming = utils.cast(bool, data.attrib.get('optimizedForStreaming'))
-        self.parts = self.findItems(data, MediaPart)
         self.proxyType = utils.cast(int, data.attrib.get('proxyType'))
         self.selected = utils.cast(bool, data.attrib.get('selected'))
         self.target = data.attrib.get('target')
@@ -87,6 +85,10 @@ class Media(PlexObject):
         parent = self._parent()
         self._parentKey = parent.key
 
+    @cached_data_property
+    def parts(self):
+        return self.findItems(self._data, MediaPart)
+
     @property
     def isOptimizedVersion(self):
         """ Returns True if the media is a Plex optimized version. """
@@ -138,7 +140,6 @@ class MediaPart(PlexObject):
 
     def _loadData(self, data):
         """ Load attribute values from Plex XML response. """
-        self._data = data
         self.accessible = utils.cast(bool, data.attrib.get('accessible'))
         self.audioProfile = data.attrib.get('audioProfile')
         self.container = data.attrib.get('container')
@@ -268,7 +269,6 @@ class MediaPartStream(PlexObject):
 
     def _loadData(self, data):
         """ Load attribute values from Plex XML response. """
-        self._data = data
         self.bitrate = utils.cast(int, data.attrib.get('bitrate'))
         self.codec = data.attrib.get('codec')
         self.decision = data.attrib.get('decision')
@@ -386,6 +386,7 @@ class AudioStream(MediaPartStream):
             profile (str): The profile of the audio stream.
             samplingRate (int): The sampling rate of the audio stream (ex: xxx)
             streamIdentifier (int): The stream identifier of the audio stream.
+            visualImpaired (bool): True if this is a visually impaired (AD) audio stream.
 
             Track_only_attributes: The following attributes are only available for tracks.
 
@@ -413,6 +414,7 @@ class AudioStream(MediaPartStream):
         self.profile = data.attrib.get('profile')
         self.samplingRate = utils.cast(int, data.attrib.get('samplingRate'))
         self.streamIdentifier = utils.cast(int, data.attrib.get('streamIdentifier'))
+        self.visualImpaired = utils.cast(bool, data.attrib.get('visualImpaired', '0'))
 
         # Track only attributes
         self.albumGain = utils.cast(float, data.attrib.get('albumGain'))
@@ -523,6 +525,7 @@ class Session(PlexObject):
     TAG = 'Session'
 
     def _loadData(self, data):
+        """ Load attribute values from Plex XML response. """
         self.id = data.attrib.get('id')
         self.bandwidth = utils.cast(int, data.attrib.get('bandwidth'))
         self.location = data.attrib.get('location')
@@ -569,7 +572,6 @@ class TranscodeSession(PlexObject):
 
     def _loadData(self, data):
         """ Load attribute values from Plex XML response. """
-        self._data = data
         self.audioChannels = utils.cast(int, data.attrib.get('audioChannels'))
         self.audioCodec = data.attrib.get('audioCodec')
         self.audioDecision = data.attrib.get('audioDecision')
@@ -610,7 +612,7 @@ class TranscodeJob(PlexObject):
     TAG = 'TranscodeJob'
 
     def _loadData(self, data):
-        self._data = data
+        """ Load attribute values from Plex XML response. """
         self.generatorID = data.attrib.get('generatorID')
         self.key = data.attrib.get('key')
         self.progress = data.attrib.get('progress')
@@ -629,7 +631,7 @@ class Optimized(PlexObject):
     TAG = 'Item'
 
     def _loadData(self, data):
-        self._data = data
+        """ Load attribute values from Plex XML response. """
         self.id = data.attrib.get('id')
         self.composite = data.attrib.get('composite')
         self.title = data.attrib.get('title')
@@ -667,7 +669,7 @@ class Conversion(PlexObject):
     TAG = 'Video'
 
     def _loadData(self, data):
-        self._data = data
+        """ Load attribute values from Plex XML response. """
         self.addedAt = data.attrib.get('addedAt')
         self.art = data.attrib.get('art')
         self.chapterSource = data.attrib.get('chapterSource')
@@ -743,7 +745,6 @@ class MediaTag(PlexObject):
 
     def _loadData(self, data):
         """ Load attribute values from Plex XML response. """
-        self._data = data
         self.filter = data.attrib.get('filter')
         self.id = utils.cast(int, data.attrib.get('id'))
         self.key = data.attrib.get('key')
@@ -954,7 +955,6 @@ class Guid(PlexObject):
 
     def _loadData(self, data):
         """ Load attribute values from Plex XML response. """
-        self._data = data
         self.id = data.attrib.get('id')
 
 
@@ -972,7 +972,6 @@ class Image(PlexObject):
 
     def _loadData(self, data):
         """ Load attribute values from Plex XML response. """
-        self._data = data
         self.alt = data.attrib.get('alt')
         self.type = data.attrib.get('type')
         self.url = data.attrib.get('url')
@@ -994,7 +993,6 @@ class Rating(PlexObject):
 
     def _loadData(self, data):
         """ Load attribute values from Plex XML response. """
-        self._data = data
         self.image = data.attrib.get('image')
         self.type = data.attrib.get('type')
         self.value = utils.cast(float, data.attrib.get('value'))
@@ -1017,7 +1015,7 @@ class Review(PlexObject):
     TAG = 'Review'
 
     def _loadData(self, data):
-        self._data = data
+        """ Load attribute values from Plex XML response. """
         self.filter = data.attrib.get('filter')
         self.id = utils.cast(int, data.attrib.get('id', 0))
         self.image = data.attrib.get('image')
@@ -1042,7 +1040,6 @@ class UltraBlurColors(PlexObject):
 
     def _loadData(self, data):
         """ Load attribute values from Plex XML response. """
-        self._data = data
         self.bottomLeft = data.attrib.get('bottomLeft')
         self.bottomRight = data.attrib.get('bottomRight')
         self.topLeft = data.attrib.get('topLeft')
@@ -1063,7 +1060,7 @@ class BaseResource(PlexObject):
     """
 
     def _loadData(self, data):
-        self._data = data
+        """ Load attribute values from Plex XML response. """
         self.key = data.attrib.get('key')
         self.provider = data.attrib.get('provider')
         self.ratingKey = data.attrib.get('ratingKey')
@@ -1075,7 +1072,7 @@ class BaseResource(PlexObject):
         data = f'{key}?url={quote_plus(self.ratingKey)}'
         try:
             self._server.query(data, method=self._server._session.put)
-        except xml.etree.ElementTree.ParseError:
+        except ElementTree.ParseError:
             pass
 
     @property
@@ -1138,7 +1135,7 @@ class Chapter(PlexObject):
         return f"<{':'.join([self.__class__.__name__, name, offsets])}>"
 
     def _loadData(self, data):
-        self._data = data
+        """ Load attribute values from Plex XML response. """
         self.end = utils.cast(int, data.attrib.get('endTimeOffset'))
         self.filter = data.attrib.get('filter')
         self.id = utils.cast(int, data.attrib.get('id', 0))
@@ -1172,7 +1169,7 @@ class Marker(PlexObject):
         return f"<{':'.join([self.__class__.__name__, name, offsets])}>"
 
     def _loadData(self, data):
-        self._data = data
+        """ Load attribute values from Plex XML response. """
         self.end = utils.cast(int, data.attrib.get('endTimeOffset'))
         self.final = utils.cast(bool, data.attrib.get('final'))
         self.id = utils.cast(int, data.attrib.get('id'))
@@ -1206,7 +1203,7 @@ class Field(PlexObject):
     TAG = 'Field'
 
     def _loadData(self, data):
-        self._data = data
+        """ Load attribute values from Plex XML response. """
         self.locked = utils.cast(bool, data.attrib.get('locked'))
         self.name = data.attrib.get('name')
 
@@ -1226,7 +1223,7 @@ class SearchResult(PlexObject):
         return f"<{':'.join([p for p in [self.__class__.__name__, name, score] if p])}>"
 
     def _loadData(self, data):
-        self._data = data
+        """ Load attribute values from Plex XML response. """
         self.guid = data.attrib.get('guid')
         self.lifespanEnded = data.attrib.get('lifespanEnded')
         self.name = data.attrib.get('name')
@@ -1248,7 +1245,7 @@ class Agent(PlexObject):
         return f"<{':'.join([p for p in [self.__class__.__name__, uid] if p])}>"
 
     def _loadData(self, data):
-        self._data = data
+        """ Load attribute values from Plex XML response. """
         self.hasAttribution = data.attrib.get('hasAttribution')
         self.hasPrefs = data.attrib.get('hasPrefs')
         self.identifier = data.attrib.get('identifier')
@@ -1256,12 +1253,17 @@ class Agent(PlexObject):
         self.primary = data.attrib.get('primary')
         self.shortIdentifier = self.identifier.rsplit('.', 1)[1]
 
+    @cached_data_property
+    def languageCodes(self):
         if 'mediaType' in self._initpath:
-            self.languageCodes = self.listAttrs(data, 'code', etag='Language')
-            self.mediaTypes = []
-        else:
-            self.languageCodes = []
-            self.mediaTypes = self.findItems(data, cls=AgentMediaType)
+            return self.listAttrs(self._data, 'code', etag='Language')
+        return []
+
+    @cached_data_property
+    def mediaTypes(self):
+        if 'mediaType' not in self._initpath:
+            return self.findItems(self._data, cls=AgentMediaType)
+        return []
 
     @property
     @deprecated('use "languageCodes" instead')
@@ -1291,10 +1293,14 @@ class AgentMediaType(Agent):
         return f"<{':'.join([p for p in [self.__class__.__name__, uid] if p])}>"
 
     def _loadData(self, data):
-        self.languageCodes = self.listAttrs(data, 'code', etag='Language')
+        """ Load attribute values from Plex XML response. """
         self.mediaType = utils.cast(int, data.attrib.get('mediaType'))
         self.name = data.attrib.get('name')
 
+    @cached_data_property
+    def languageCodes(self):
+        return self.listAttrs(self._data, 'code', etag='Language')
+
     @property
     @deprecated('use "languageCodes" instead')
     def languageCode(self):
@@ -1325,7 +1331,7 @@ class Availability(PlexObject):
         return f'<{self.__class__.__name__}:{self.platform}:{self.offerType}>'
 
     def _loadData(self, data):
-        self._data = data
+        """ Load attribute values from Plex XML response. """
         self.country = data.attrib.get('country')
         self.offerType = data.attrib.get('offerType')
         self.platform = data.attrib.get('platform')
diff --git a/lib/plexapi/myplex.py b/lib/plexapi/myplex.py
index 448a2649..411d5618 100644
--- a/lib/plexapi/myplex.py
+++ b/lib/plexapi/myplex.py
@@ -4,13 +4,12 @@ import html
 import threading
 import time
 from urllib.parse import parse_qsl, urlencode, urlsplit, urlunsplit
-from xml.etree import ElementTree
 
 import requests
 
 from plexapi import (BASE_HEADERS, CONFIG, TIMEOUT, X_PLEX_ENABLE_FAST_CONNECT, X_PLEX_IDENTIFIER,
                      log, logfilter, utils)
-from plexapi.base import PlexObject
+from plexapi.base import PlexObject, cached_data_property
 from plexapi.client import PlexClient
 from plexapi.exceptions import BadRequest, NotFound, Unauthorized, TwoFactorRequired
 from plexapi.library import LibrarySection
@@ -144,7 +143,6 @@ class MyPlexAccount(PlexObject):
 
     def _loadData(self, data):
         """ Load attribute values from Plex XML response. """
-        self._data = data
         self._token = logfilter.add_secret(data.attrib.get('authToken'))
         self._webhooks = []
 
@@ -185,7 +183,6 @@ class MyPlexAccount(PlexObject):
         subscription = data.find('subscription')
         self.subscriptionActive = utils.cast(bool, subscription.attrib.get('active'))
         self.subscriptionDescription = data.attrib.get('subscriptionDescription')
-        self.subscriptionFeatures = self.listAttrs(subscription, 'id', rtag='features', etag='feature')
         self.subscriptionPaymentService = subscription.attrib.get('paymentService')
         self.subscriptionPlan = subscription.attrib.get('plan')
         self.subscriptionStatus = subscription.attrib.get('status')
@@ -201,21 +198,31 @@ class MyPlexAccount(PlexObject):
         self.profileDefaultSubtitleAccessibility = utils.cast(int, profile.attrib.get('defaultSubtitleAccessibility'))
         self.profileDefaultSubtitleForces = utils.cast(int, profile.attrib.get('defaultSubtitleForces'))
 
-        self.entitlements = self.listAttrs(data, 'id', rtag='entitlements', etag='entitlement')
-        self.roles = self.listAttrs(data, 'id', rtag='roles', etag='role')
-
         # TODO: Fetch missing MyPlexAccount services
         self.services = None
 
+    @cached_data_property
+    def subscriptionFeatures(self):
+        subscription = self._data.find('subscription')
+        return self.listAttrs(subscription, 'id', rtag='features', etag='feature')
+
+    @cached_data_property
+    def entitlements(self):
+        return self.listAttrs(self._data, 'id', rtag='entitlements', etag='entitlement')
+
+    @cached_data_property
+    def roles(self):
+        return self.listAttrs(self._data, 'id', rtag='roles', etag='role')
+
     @property
     def authenticationToken(self):
         """ Returns the authentication token for the account. Alias for ``authToken``. """
         return self.authToken
 
-    def _reload(self, key=None, **kwargs):
+    def _reload(self, **kwargs):
         """ Perform the actual reload. """
         data = self.query(self.key)
-        self._loadData(data)
+        self._invalidateCacheAndLoadData(data)
         return self
 
     def _headers(self, **kwargs):
@@ -250,8 +257,7 @@ class MyPlexAccount(PlexObject):
             return response.json()
         elif 'text/plain' in response.headers.get('Content-Type', ''):
             return response.text.strip()
-        data = utils.cleanXMLString(response.text).encode('utf8')
-        return ElementTree.fromstring(data) if data.strip() else None
+        return utils.parseXMLString(response.text)
 
     def ping(self):
         """ Ping the Plex.tv API.
@@ -1206,7 +1212,6 @@ class MyPlexUser(PlexObject):
 
     def _loadData(self, data):
         """ Load attribute values from Plex XML response. """
-        self._data = data
         self.friend = self._initpath == self.key
         self.allowCameraUpload = utils.cast(bool, data.attrib.get('allowCameraUpload'))
         self.allowChannels = utils.cast(bool, data.attrib.get('allowChannels'))
@@ -1225,10 +1230,13 @@ class MyPlexUser(PlexObject):
         self.thumb = data.attrib.get('thumb')
         self.title = data.attrib.get('title', '')
         self.username = data.attrib.get('username', '')
-        self.servers = self.findItems(data, MyPlexServerShare)
         for server in self.servers:
             server.accountID = self.id
 
+    @cached_data_property
+    def servers(self):
+        return self.findItems(self._data, MyPlexServerShare)
+
     def get_token(self, machineIdentifier):
         try:
             for item in self._server.query(self._server.FRIENDINVITE.format(machineId=machineIdentifier)):
@@ -1283,7 +1291,6 @@ class MyPlexInvite(PlexObject):
 
     def _loadData(self, data):
         """ Load attribute values from Plex XML response. """
-        self._data = data
         self.createdAt = utils.toDatetime(data.attrib.get('createdAt'))
         self.email = data.attrib.get('email')
         self.friend = utils.cast(bool, data.attrib.get('friend'))
@@ -1291,12 +1298,15 @@ class MyPlexInvite(PlexObject):
         self.home = utils.cast(bool, data.attrib.get('home'))
         self.id = utils.cast(int, data.attrib.get('id'))
         self.server = utils.cast(bool, data.attrib.get('server'))
-        self.servers = self.findItems(data, MyPlexServerShare)
         self.thumb = data.attrib.get('thumb')
         self.username = data.attrib.get('username', '')
         for server in self.servers:
             server.accountID = self.id
 
+    @cached_data_property
+    def servers(self):
+        return self.findItems(self._data, MyPlexServerShare)
+
 
 class Section(PlexObject):
     """ This refers to a shared section. The raw xml for the data presented here
@@ -1314,7 +1324,7 @@ class Section(PlexObject):
     TAG = 'Section'
 
     def _loadData(self, data):
-        self._data = data
+        """ Load attribute values from Plex XML response. """
         self.id = utils.cast(int, data.attrib.get('id'))
         self.key = utils.cast(int, data.attrib.get('key'))
         self.shared = utils.cast(bool, data.attrib.get('shared', '0'))
@@ -1353,7 +1363,6 @@ class MyPlexServerShare(PlexObject):
 
     def _loadData(self, data):
         """ Load attribute values from Plex XML response. """
-        self._data = data
         self.id = utils.cast(int, data.attrib.get('id'))
         self.accountID = utils.cast(int, data.attrib.get('accountID'))
         self.serverId = utils.cast(int, data.attrib.get('serverId'))
@@ -1437,10 +1446,9 @@ class MyPlexResource(PlexObject):
     DEFAULT_SCHEME_ORDER = ['https', 'http']
 
     def _loadData(self, data):
-        self._data = data
+        """ Load attribute values from Plex XML response. """
         self.accessToken = logfilter.add_secret(data.attrib.get('accessToken'))
         self.clientIdentifier = data.attrib.get('clientIdentifier')
-        self.connections = self.findItems(data, ResourceConnection, rtag='connections')
         self.createdAt = utils.toDatetime(data.attrib.get('createdAt'), "%Y-%m-%dT%H:%M:%SZ")
         self.device = data.attrib.get('device')
         self.dnsRebindingProtection = utils.cast(bool, data.attrib.get('dnsRebindingProtection'))
@@ -1462,6 +1470,10 @@ class MyPlexResource(PlexObject):
         self.sourceTitle = data.attrib.get('sourceTitle')
         self.synced = utils.cast(bool, data.attrib.get('synced'))
 
+    @cached_data_property
+    def connections(self):
+        return self.findItems(self._data, ResourceConnection, rtag='connections')
+
     def preferred_connections(
         self,
         ssl=None,
@@ -1555,7 +1567,7 @@ class ResourceConnection(PlexObject):
     TAG = 'connection'
 
     def _loadData(self, data):
-        self._data = data
+        """ Load attribute values from Plex XML response. """
         self.address = data.attrib.get('address')
         self.ipv6 = utils.cast(bool, data.attrib.get('IPv6'))
         self.local = utils.cast(bool, data.attrib.get('local'))
@@ -1598,7 +1610,7 @@ class MyPlexDevice(PlexObject):
     key = 'https://plex.tv/devices.xml'
 
     def _loadData(self, data):
-        self._data = data
+        """ Load attribute values from Plex XML response. """
         self.name = data.attrib.get('name')
         self.publicAddress = data.attrib.get('publicAddress')
         self.product = data.attrib.get('product')
@@ -1617,7 +1629,10 @@ class MyPlexDevice(PlexObject):
         self.screenDensity = data.attrib.get('screenDensity')
         self.createdAt = utils.toDatetime(data.attrib.get('createdAt'))
         self.lastSeenAt = utils.toDatetime(data.attrib.get('lastSeenAt'))
-        self.connections = self.listAttrs(data, 'uri', etag='Connection')
+
+    @cached_data_property
+    def connections(self):
+        return self.listAttrs(self._data, 'uri', etag='Connection')
 
     def connect(self, timeout=None):
         """ Returns a new :class:`~plexapi.client.PlexClient` or :class:`~plexapi.server.PlexServer`
@@ -1879,8 +1894,7 @@ class MyPlexPinLogin:
             codename = codes.get(response.status_code)[0]
             errtext = response.text.replace('\n', ' ')
             raise BadRequest(f'({response.status_code}) {codename} {response.url}; {errtext}')
-        data = response.text.encode('utf8')
-        return ElementTree.fromstring(data) if data.strip() else None
+        return utils.parseXMLString(response.text)
 
 
 def _connect(cls, url, token, session, timeout, results, i, job_is_done_event=None):
@@ -1939,6 +1953,7 @@ class AccountOptOut(PlexObject):
     CHOICES = {'opt_in', 'opt_out', 'opt_out_managed'}
 
     def _loadData(self, data):
+        """ Load attribute values from Plex XML response. """
         self.key = data.attrib.get('key')
         self.value = data.attrib.get('value')
 
@@ -1997,6 +2012,7 @@ class UserState(PlexObject):
         return f'<{self.__class__.__name__}:{self.ratingKey}>'
 
     def _loadData(self, data):
+        """ Load attribute values from Plex XML response. """
         self.lastViewedAt = utils.toDatetime(data.attrib.get('lastViewedAt'))
         self.ratingKey = data.attrib.get('ratingKey')
         self.type = data.attrib.get('type')
@@ -2026,7 +2042,7 @@ class GeoLocation(PlexObject):
     TAG = 'location'
 
     def _loadData(self, data):
-        self._data = data
+        """ Load attribute values from Plex XML response. """
         self.city = data.attrib.get('city')
         self.code = data.attrib.get('code')
         self.continentCode = data.attrib.get('continent_code')
diff --git a/lib/plexapi/photo.py b/lib/plexapi/photo.py
index 4347f31a..e7c7239e 100644
--- a/lib/plexapi/photo.py
+++ b/lib/plexapi/photo.py
@@ -4,7 +4,7 @@ from pathlib import Path
 from urllib.parse import quote_plus
 
 from plexapi import media, utils, video
-from plexapi.base import Playable, PlexPartialObject, PlexSession
+from plexapi.base import Playable, PlexPartialObject, PlexSession, cached_data_property
 from plexapi.exceptions import BadRequest
 from plexapi.mixins import (
     RatingMixin,
@@ -56,9 +56,7 @@ class Photoalbum(
         self.addedAt = utils.toDatetime(data.attrib.get('addedAt'))
         self.art = data.attrib.get('art')
         self.composite = data.attrib.get('composite')
-        self.fields = self.findItems(data, media.Field)
         self.guid = data.attrib.get('guid')
-        self.images = self.findItems(data, media.Image)
         self.index = utils.cast(int, data.attrib.get('index'))
         self.key = data.attrib.get('key', '').replace('/children', '')  # FIX_BUG_50
         self.lastRatedAt = utils.toDatetime(data.attrib.get('lastRatedAt'))
@@ -75,6 +73,14 @@ class Photoalbum(
         self.updatedAt = utils.toDatetime(data.attrib.get('updatedAt'))
         self.userRating = utils.cast(float, data.attrib.get('userRating'))
 
+    @cached_data_property
+    def fields(self):
+        return self.findItems(self._data, media.Field)
+
+    @cached_data_property
+    def images(self):
+        return self.findItems(self._data, media.Image)
+
     def album(self, title):
         """ Returns the :class:`~plexapi.photo.Photoalbum` that matches the specified title.
 
@@ -205,9 +211,7 @@ class Photo(
         self.addedAt = utils.toDatetime(data.attrib.get('addedAt'))
         self.createdAtAccuracy = data.attrib.get('createdAtAccuracy')
         self.createdAtTZOffset = utils.cast(int, data.attrib.get('createdAtTZOffset'))
-        self.fields = self.findItems(data, media.Field)
         self.guid = data.attrib.get('guid')
-        self.images = self.findItems(data, media.Image)
         self.index = utils.cast(int, data.attrib.get('index'))
         self.key = data.attrib.get('key', '')
         self.lastRatedAt = utils.toDatetime(data.attrib.get('lastRatedAt'))
@@ -215,7 +219,6 @@ class Photo(
         self.librarySectionKey = data.attrib.get('librarySectionKey')
         self.librarySectionTitle = data.attrib.get('librarySectionTitle')
         self.listType = 'photo'
-        self.media = self.findItems(data, media.Media)
         self.originallyAvailableAt = utils.toDatetime(data.attrib.get('originallyAvailableAt'), '%Y-%m-%d')
         self.parentGuid = data.attrib.get('parentGuid')
         self.parentIndex = utils.cast(int, data.attrib.get('parentIndex'))
@@ -226,7 +229,6 @@ class Photo(
         self.ratingKey = utils.cast(int, data.attrib.get('ratingKey'))
         self.sourceURI = data.attrib.get('source')  # remote playlist item
         self.summary = data.attrib.get('summary')
-        self.tags = self.findItems(data, media.Tag)
         self.thumb = data.attrib.get('thumb')
         self.title = data.attrib.get('title')
         self.titleSort = data.attrib.get('titleSort', self.title)
@@ -235,6 +237,22 @@ class Photo(
         self.userRating = utils.cast(float, data.attrib.get('userRating'))
         self.year = utils.cast(int, data.attrib.get('year'))
 
+    @cached_data_property
+    def fields(self):
+        return self.findItems(self._data, media.Field)
+
+    @cached_data_property
+    def images(self):
+        return self.findItems(self._data, media.Image)
+
+    @cached_data_property
+    def media(self):
+        return self.findItems(self._data, media.Media)
+
+    @cached_data_property
+    def tags(self):
+        return self.findItems(self._data, media.Tag)
+
     def _prettyfilename(self):
         """ Returns a filename for use in download. """
         if self.parentTitle:
diff --git a/lib/plexapi/playlist.py b/lib/plexapi/playlist.py
index e2c4da63..0fc79bf5 100644
--- a/lib/plexapi/playlist.py
+++ b/lib/plexapi/playlist.py
@@ -5,7 +5,7 @@ from pathlib import Path
 from urllib.parse import quote_plus, unquote
 
 from plexapi import media, utils
-from plexapi.base import Playable, PlexPartialObject
+from plexapi.base import Playable, PlexPartialObject, cached_data_property
 from plexapi.exceptions import BadRequest, NotFound, Unsupported
 from plexapi.library import LibrarySection, MusicSection
 from plexapi.mixins import SmartFilterMixin, ArtMixin, PosterMixin, PlaylistEditMixins
@@ -60,7 +60,6 @@ class Playlist(
         self.content = data.attrib.get('content')
         self.duration = utils.cast(int, data.attrib.get('duration'))
         self.durationInSeconds = utils.cast(int, data.attrib.get('durationInSeconds'))
-        self.fields = self.findItems(data, media.Field)
         self.guid = data.attrib.get('guid')
         self.icon = data.attrib.get('icon')
         self.key = data.attrib.get('key', '').replace('/items', '')  # FIX_BUG_50
@@ -77,9 +76,10 @@ class Playlist(
         self.titleSort = data.attrib.get('titleSort', self.title)
         self.type = data.attrib.get('type')
         self.updatedAt = utils.toDatetime(data.attrib.get('updatedAt'))
-        self._items = None  # cache for self.items
-        self._section = None  # cache for self.section
-        self._filters = None  # cache for self.filters
+
+    @cached_data_property
+    def fields(self):
+        return self.findItems(self._data, media.Field)
 
     def __len__(self):  # pragma: no cover
         return len(self.items())
@@ -133,15 +133,36 @@ class Playlist(
                 return _item.playlistItemID
         raise NotFound(f'Item with title "{item.title}" not found in the playlist')
 
+    @cached_data_property
+    def _filters(self):
+        """ Cache for filters. """
+        return self._parseFilters(self.content)
+
     def filters(self):
         """ Returns the search filter dict for smart playlist.
             The filter dict be passed back into :func:`~plexapi.library.LibrarySection.search`
             to get the list of items.
         """
-        if self.smart and self._filters is None:
-            self._filters = self._parseFilters(self.content)
         return self._filters
 
+    @cached_data_property
+    def _section(self):
+        """ Cache for section. """
+        if not self.smart:
+            raise BadRequest('Regular playlists are not associated with a library.')
+
+        # Try to parse the library section from the content URI string
+        match = re.search(r'/library/sections/(\d+)/all', unquote(self.content or ''))
+        if match:
+            sectionKey = int(match.group(1))
+            return self._server.library.sectionByID(sectionKey)
+
+        # Try to get the library section from the first item in the playlist
+        if self.items():
+            return self.items()[0].section()
+
+        raise Unsupported('Unable to determine the library section')
+
     def section(self):
         """ Returns the :class:`~plexapi.library.LibrarySection` this smart playlist belongs to.
 
@@ -149,24 +170,6 @@ class Playlist(
                 :class:`plexapi.exceptions.BadRequest`: When trying to get the section for a regular playlist.
                 :class:`plexapi.exceptions.Unsupported`: When unable to determine the library section.
         """
-        if not self.smart:
-            raise BadRequest('Regular playlists are not associated with a library.')
-
-        if self._section is None:
-            # Try to parse the library section from the content URI string
-            match = re.search(r'/library/sections/(\d+)/all', unquote(self.content or ''))
-            if match:
-                sectionKey = int(match.group(1))
-                self._section = self._server.library.sectionByID(sectionKey)
-                return self._section
-
-            # Try to get the library section from the first item in the playlist
-            if self.items():
-                self._section = self.items()[0].section()
-                return self._section
-
-            raise Unsupported('Unable to determine the library section')
-
         return self._section
 
     def item(self, title):
@@ -183,28 +186,32 @@ class Playlist(
                 return item
         raise NotFound(f'Item with title "{title}" not found in the playlist')
 
-    def items(self):
-        """ Returns a list of all items in the playlist. """
+    @cached_data_property
+    def _items(self):
+        """ Cache for items. """
         if self.radio:
             return []
-        if self._items is None:
-            key = f'{self.key}/items'
-            items = self.fetchItems(key)
 
-            # Cache server connections to avoid reconnecting for each item
-            _servers = {}
-            for item in items:
-                if item.sourceURI:
-                    serverID = item.sourceURI.split('/')[2]
-                    if serverID not in _servers:
-                        try:
-                            _servers[serverID] = self._server.myPlexAccount().resource(serverID).connect()
-                        except NotFound:
-                            # Override the server connection with None if the server is not found
-                            _servers[serverID] = None
-                    item._server = _servers[serverID]
+        key = f'{self.key}/items'
+        items = self.fetchItems(key)
 
-            self._items = items
+        # Cache server connections to avoid reconnecting for each item
+        _servers = {}
+        for item in items:
+            if item.sourceURI:
+                serverID = item.sourceURI.split('/')[2]
+                if serverID not in _servers:
+                    try:
+                        _servers[serverID] = self._server.myPlexAccount().resource(serverID).connect()
+                    except NotFound:
+                        # Override the server connection with None if the server is not found
+                        _servers[serverID] = None
+                item._server = _servers[serverID]
+
+        return items
+
+    def items(self):
+        """ Returns a list of all items in the playlist. """
         return self._items
 
     def get(self, title):
diff --git a/lib/plexapi/playqueue.py b/lib/plexapi/playqueue.py
index 9835c0dd..8875ef07 100644
--- a/lib/plexapi/playqueue.py
+++ b/lib/plexapi/playqueue.py
@@ -2,7 +2,7 @@
 from urllib.parse import quote_plus
 
 from plexapi import utils
-from plexapi.base import PlexObject
+from plexapi.base import PlexObject, cached_data_property
 from plexapi.exceptions import BadRequest
 
 
@@ -36,7 +36,7 @@ class PlayQueue(PlexObject):
     TYPE = "playqueue"
 
     def _loadData(self, data):
-        self._data = data
+        """ Load attribute values from Plex XML response. """
         self.identifier = data.attrib.get("identifier")
         self.mediaTagPrefix = data.attrib.get("mediaTagPrefix")
         self.mediaTagVersion = utils.cast(int, data.attrib.get("mediaTagVersion"))
@@ -62,9 +62,12 @@ class PlayQueue(PlexObject):
         )
         self.playQueueVersion = utils.cast(int, data.attrib.get("playQueueVersion"))
         self.size = utils.cast(int, data.attrib.get("size", 0))
-        self.items = self.findItems(data)
         self.selectedItem = self[self.playQueueSelectedItemOffset]
 
+    @cached_data_property
+    def items(self):
+        return self.findItems(self._data)
+
     def __getitem__(self, key):
         if not self.items:
             return None
@@ -254,7 +257,7 @@ class PlayQueue(PlexObject):
 
         path = f"/playQueues/{self.playQueueID}{utils.joinArgs(args)}"
         data = self._server.query(path, method=self._server._session.put)
-        self._loadData(data)
+        self._invalidateCacheAndLoadData(data)
         return self
 
     def moveItem(self, item, after=None, refresh=True):
@@ -283,7 +286,7 @@ class PlayQueue(PlexObject):
 
         path = f"/playQueues/{self.playQueueID}/items/{item.playQueueItemID}/move{utils.joinArgs(args)}"
         data = self._server.query(path, method=self._server._session.put)
-        self._loadData(data)
+        self._invalidateCacheAndLoadData(data)
         return self
 
     def removeItem(self, item, refresh=True):
@@ -301,19 +304,19 @@ class PlayQueue(PlexObject):
 
         path = f"/playQueues/{self.playQueueID}/items/{item.playQueueItemID}"
         data = self._server.query(path, method=self._server._session.delete)
-        self._loadData(data)
+        self._invalidateCacheAndLoadData(data)
         return self
 
     def clear(self):
         """Remove all items from the PlayQueue."""
         path = f"/playQueues/{self.playQueueID}/items"
         data = self._server.query(path, method=self._server._session.delete)
-        self._loadData(data)
+        self._invalidateCacheAndLoadData(data)
         return self
 
     def refresh(self):
         """Refresh the PlayQueue from the Plex server."""
         path = f"/playQueues/{self.playQueueID}"
         data = self._server.query(path, method=self._server._session.get)
-        self._loadData(data)
+        self._invalidateCacheAndLoadData(data)
         return self
diff --git a/lib/plexapi/server.py b/lib/plexapi/server.py
index 8cd110d8..239036c4 100644
--- a/lib/plexapi/server.py
+++ b/lib/plexapi/server.py
@@ -1,15 +1,13 @@
 # -*- coding: utf-8 -*-
 import os
-from functools import cached_property
 from urllib.parse import urlencode
-from xml.etree import ElementTree
 
 import requests
 
 from plexapi import BASE_HEADERS, CONFIG, TIMEOUT, log, logfilter
 from plexapi import utils
 from plexapi.alert import AlertListener
-from plexapi.base import PlexObject
+from plexapi.base import PlexObject, cached_data_property
 from plexapi.client import PlexClient
 from plexapi.collection import Collection
 from plexapi.exceptions import BadRequest, NotFound, Unauthorized
@@ -110,15 +108,11 @@ class PlexServer(PlexObject):
         self._showSecrets = CONFIG.get('log.show_secrets', '').lower() == 'true'
         self._session = session or requests.Session()
         self._timeout = timeout or TIMEOUT
-        self._myPlexAccount = None   # cached myPlexAccount
-        self._systemAccounts = None   # cached list of SystemAccount
-        self._systemDevices = None   # cached list of SystemDevice
         data = self.query(self.key, timeout=self._timeout)
         super(PlexServer, self).__init__(self, data, self.key)
 
     def _loadData(self, data):
         """ Load attribute values from Plex XML response. """
-        self._data = data
         self.allowCameraUpload = utils.cast(bool, data.attrib.get('allowCameraUpload'))
         self.allowChannelAccess = utils.cast(bool, data.attrib.get('allowChannelAccess'))
         self.allowMediaDeletion = utils.cast(bool, data.attrib.get('allowMediaDeletion'))
@@ -172,7 +166,7 @@ class PlexServer(PlexObject):
     def _uriRoot(self):
         return f'server://{self.machineIdentifier}/com.plexapp.plugins.library'
 
-    @cached_property
+    @cached_data_property
     def library(self):
         """ Library to browse or search your media. """
         try:
@@ -183,7 +177,7 @@ class PlexServer(PlexObject):
             data = self.query('/library/sections/')
         return Library(self, data)
 
-    @cached_property
+    @cached_data_property
     def settings(self):
         """ Returns a list of all server settings. """
         data = self.query(Settings.key)
@@ -276,11 +270,14 @@ class PlexServer(PlexObject):
             timeout = self._timeout
         return PlexServer(self._baseurl, token=userToken, session=session, timeout=timeout)
 
+    @cached_data_property
+    def _systemAccounts(self):
+        """ Cache for systemAccounts. """
+        key = '/accounts'
+        return self.fetchItems(key, SystemAccount)
+
     def systemAccounts(self):
         """ Returns a list of :class:`~plexapi.server.SystemAccount` objects this server contains. """
-        if self._systemAccounts is None:
-            key = '/accounts'
-            self._systemAccounts = self.fetchItems(key, SystemAccount)
         return self._systemAccounts
 
     def systemAccount(self, accountID):
@@ -294,11 +291,14 @@ class PlexServer(PlexObject):
         except StopIteration:
             raise NotFound(f'Unknown account with accountID={accountID}') from None
 
+    @cached_data_property
+    def _systemDevices(self):
+        """ Cache for systemDevices. """
+        key = '/devices'
+        return self.fetchItems(key, SystemDevice)
+
     def systemDevices(self):
         """ Returns a list of :class:`~plexapi.server.SystemDevice` objects this server contains. """
-        if self._systemDevices is None:
-            key = '/devices'
-            self._systemDevices = self.fetchItems(key, SystemDevice)
         return self._systemDevices
 
     def systemDevice(self, deviceID):
@@ -312,21 +312,24 @@ class PlexServer(PlexObject):
         except StopIteration:
             raise NotFound(f'Unknown device with deviceID={deviceID}') from None
 
+    @cached_data_property
+    def _myPlexAccount(self):
+        """ Cache for myPlexAccount. """
+        from plexapi.myplex import MyPlexAccount
+        return MyPlexAccount(token=self._token, session=self._session)
+
     def myPlexAccount(self):
         """ Returns a :class:`~plexapi.myplex.MyPlexAccount` object using the same
             token to access this server. If you are not the owner of this PlexServer
             you're likely to receive an authentication error calling this.
         """
-        if self._myPlexAccount is None:
-            from plexapi.myplex import MyPlexAccount
-            self._myPlexAccount = MyPlexAccount(token=self._token, session=self._session)
         return self._myPlexAccount
 
     def _myPlexClientPorts(self):
         """ Sometimes the PlexServer does not properly advertise port numbers required
             to connect. This attempts to look up device port number from plex.tv.
             See issue #126: Make PlexServer.clients() more user friendly.
-              https://github.com/pkkid/python-plexapi/issues/126
+              https://github.com/pushingkarmaorg/python-plexapi/issues/126
         """
         try:
             ports = {}
@@ -768,8 +771,7 @@ class PlexServer(PlexObject):
                 raise NotFound(message)
             else:
                 raise BadRequest(message)
-        data = utils.cleanXMLString(response.text).encode('utf8')
-        return ElementTree.fromstring(data) if data.strip() else None
+        return utils.parseXMLString(response.text)
 
     def search(self, query, mediatype=None, limit=None, sectionId=None):
         """ Returns a list of media items or filter categories from the resulting
@@ -804,9 +806,9 @@ class PlexServer(PlexObject):
         for hub in self.fetchItems(key, Hub):
             if mediatype:
                 if hub.type == mediatype:
-                    return hub.items
+                    return hub._partialItems
             else:
-                results += hub.items
+                results += hub._partialItems
         return results
 
     def continueWatching(self):
@@ -1093,7 +1095,7 @@ class Account(PlexObject):
     key = '/myplex/account'
 
     def _loadData(self, data):
-        self._data = data
+        """ Load attribute values from Plex XML response. """
         self.authToken = data.attrib.get('authToken')
         self.username = data.attrib.get('username')
         self.mappingState = data.attrib.get('mappingState')
@@ -1114,7 +1116,7 @@ class Activity(PlexObject):
     key = '/activities'
 
     def _loadData(self, data):
-        self._data = data
+        """ Load attribute values from Plex XML response. """
         self.cancellable = utils.cast(bool, data.attrib.get('cancellable'))
         self.progress = utils.cast(int, data.attrib.get('progress'))
         self.title = data.attrib.get('title')
@@ -1129,6 +1131,7 @@ class Release(PlexObject):
     key = '/updater/status'
 
     def _loadData(self, data):
+        """ Load attribute values from Plex XML response. """
         self.download_key = data.attrib.get('key')
         self.version = data.attrib.get('version')
         self.added = data.attrib.get('added')
@@ -1154,7 +1157,7 @@ class SystemAccount(PlexObject):
     TAG = 'Account'
 
     def _loadData(self, data):
-        self._data = data
+        """ Load attribute values from Plex XML response. """
         self.autoSelectAudio = utils.cast(bool, data.attrib.get('autoSelectAudio'))
         self.defaultAudioLanguage = data.attrib.get('defaultAudioLanguage')
         self.defaultSubtitleLanguage = data.attrib.get('defaultSubtitleLanguage')
@@ -1183,7 +1186,7 @@ class SystemDevice(PlexObject):
     TAG = 'Device'
 
     def _loadData(self, data):
-        self._data = data
+        """ Load attribute values from Plex XML response. """
         self.clientIdentifier = data.attrib.get('clientIdentifier')
         self.createdAt = utils.toDatetime(data.attrib.get('createdAt'))
         self.id = utils.cast(int, data.attrib.get('id'))
@@ -1209,7 +1212,7 @@ class StatisticsBandwidth(PlexObject):
     TAG = 'StatisticsBandwidth'
 
     def _loadData(self, data):
-        self._data = data
+        """ Load attribute values from Plex XML response. """
         self.accountID = utils.cast(int, data.attrib.get('accountID'))
         self.at = utils.toDatetime(data.attrib.get('at'))
         self.bytes = utils.cast(int, data.attrib.get('bytes'))
@@ -1251,7 +1254,7 @@ class StatisticsResources(PlexObject):
     TAG = 'StatisticsResources'
 
     def _loadData(self, data):
-        self._data = data
+        """ Load attribute values from Plex XML response. """
         self.at = utils.toDatetime(data.attrib.get('at'))
         self.hostCpuUtilization = utils.cast(float, data.attrib.get('hostCpuUtilization'))
         self.hostMemoryUtilization = utils.cast(float, data.attrib.get('hostMemoryUtilization'))
@@ -1279,7 +1282,7 @@ class ButlerTask(PlexObject):
     TAG = 'ButlerTask'
 
     def _loadData(self, data):
-        self._data = data
+        """ Load attribute values from Plex XML response. """
         self.description = data.attrib.get('description')
         self.enabled = utils.cast(bool, data.attrib.get('enabled'))
         self.interval = utils.cast(int, data.attrib.get('interval'))
@@ -1301,7 +1304,7 @@ class Identity(PlexObject):
         return f"<{self.__class__.__name__}:{self.machineIdentifier}>"
 
     def _loadData(self, data):
-        self._data = data
+        """ Load attribute values from Plex XML response. """
         self.claimed = utils.cast(bool, data.attrib.get('claimed'))
         self.machineIdentifier = data.attrib.get('machineIdentifier')
         self.version = data.attrib.get('version')
diff --git a/lib/plexapi/settings.py b/lib/plexapi/settings.py
index c191e368..4e016e32 100644
--- a/lib/plexapi/settings.py
+++ b/lib/plexapi/settings.py
@@ -34,11 +34,10 @@ class Settings(PlexObject):
 
     def _loadData(self, data):
         """ Load attribute values from Plex XML response. """
-        self._data = data
         for elem in data:
             id = utils.lowerFirst(elem.attrib['id'])
             if id in self._settings:
-                self._settings[id]._loadData(elem)
+                self._settings[id]._invalidateCacheAndLoadData(elem)
                 continue
             self._settings[id] = Setting(self._server, elem, self._initpath)
 
diff --git a/lib/plexapi/sonos.py b/lib/plexapi/sonos.py
index 8f1295f4..1b61fd56 100644
--- a/lib/plexapi/sonos.py
+++ b/lib/plexapi/sonos.py
@@ -47,7 +47,6 @@ class PlexSonosClient(PlexClient):
     """
 
     def __init__(self, account, data, timeout=None):
-        self._data = data
         self.deviceClass = data.attrib.get("deviceClass")
         self.machineIdentifier = data.attrib.get("machineIdentifier")
         self.product = data.attrib.get("product")
diff --git a/lib/plexapi/sync.py b/lib/plexapi/sync.py
index f57e89d9..3b00653d 100644
--- a/lib/plexapi/sync.py
+++ b/lib/plexapi/sync.py
@@ -63,7 +63,7 @@ class SyncItem(PlexObject):
         self.clientIdentifier = clientIdentifier
 
     def _loadData(self, data):
-        self._data = data
+        """ Load attribute values from Plex XML response. """
         self.id = plexapi.utils.cast(int, data.attrib.get('id'))
         self.version = plexapi.utils.cast(int, data.attrib.get('version'))
         self.rootTitle = data.attrib.get('rootTitle')
@@ -118,7 +118,7 @@ class SyncList(PlexObject):
     TAG = 'SyncList'
 
     def _loadData(self, data):
-        self._data = data
+        """ Load attribute values from Plex XML response. """
         self.clientId = data.attrib.get('clientIdentifier')
         self.items = []
 
diff --git a/lib/plexapi/utils.py b/lib/plexapi/utils.py
index dd1cfc9c..bbff6a8e 100644
--- a/lib/plexapi/utils.py
+++ b/lib/plexapi/utils.py
@@ -17,12 +17,12 @@ from getpass import getpass
 from hashlib import sha1
 from threading import Event, Thread
 from urllib.parse import quote
+from xml.etree import ElementTree
 
 import requests
 from requests.status_codes import _codes as codes
 
 from plexapi.exceptions import BadRequest, NotFound, Unauthorized
-
 try:
     from tqdm import tqdm
 except ImportError:
@@ -718,3 +718,14 @@ _illegal_XML_re = re.compile(fr'[{"".join(_illegal_XML_ranges)}]')
 
 def cleanXMLString(s):
     return _illegal_XML_re.sub('', s)
+
+
+def parseXMLString(s: str):
+    """ Parse an XML string and return an ElementTree object. """
+    if not s.strip():
+        return None
+    try:  # Attempt to parse the string as-is without cleaning (which is expensive)
+        return ElementTree.fromstring(s.encode('utf-8'))
+    except ElementTree.ParseError:  # If it fails, clean the string and try again
+        cleaned_s = cleanXMLString(s).encode('utf-8')
+        return ElementTree.fromstring(cleaned_s) if cleaned_s.strip() else None
diff --git a/lib/plexapi/video.py b/lib/plexapi/video.py
index 9e4201b8..597bbca7 100644
--- a/lib/plexapi/video.py
+++ b/lib/plexapi/video.py
@@ -1,11 +1,10 @@
 # -*- coding: utf-8 -*-
 import os
-from functools import cached_property
 from pathlib import Path
 from urllib.parse import quote_plus
 
 from plexapi import media, utils
-from plexapi.base import Playable, PlexPartialObject, PlexHistory, PlexSession
+from plexapi.base import Playable, PlexPartialObject, PlexHistory, PlexSession, cached_data_property
 from plexapi.exceptions import BadRequest
 from plexapi.mixins import (
     AdvancedSettingsMixin, SplitMergeMixin, UnmatchMatchMixin, ExtrasMixin, HubsMixin, PlayedUnplayedMixin, RatingMixin,
@@ -48,13 +47,10 @@ class Video(PlexPartialObject, PlayedUnplayedMixin):
 
     def _loadData(self, data):
         """ Load attribute values from Plex XML response. """
-        self._data = data
         self.addedAt = utils.toDatetime(data.attrib.get('addedAt'))
         self.art = data.attrib.get('art')
         self.artBlurHash = data.attrib.get('artBlurHash')
-        self.fields = self.findItems(data, media.Field)
         self.guid = data.attrib.get('guid')
-        self.images = self.findItems(data, media.Image)
         self.key = data.attrib.get('key', '')
         self.lastRatedAt = utils.toDatetime(data.attrib.get('lastRatedAt'))
         self.lastViewedAt = utils.toDatetime(data.attrib.get('lastViewedAt'))
@@ -73,6 +69,14 @@ class Video(PlexPartialObject, PlayedUnplayedMixin):
         self.userRating = utils.cast(float, data.attrib.get('userRating'))
         self.viewCount = utils.cast(int, data.attrib.get('viewCount', 0))
 
+    @cached_data_property
+    def fields(self):
+        return self.findItems(self._data, media.Field)
+
+    @cached_data_property
+    def images(self):
+        return self.findItems(self._data, media.Image)
+
     def url(self, part):
         """ Returns the full url for something. Typically used for getting a specific image. """
         return self._server.url(part, includeToken=True) if part else None
@@ -394,41 +398,86 @@ class Movie(
         Playable._loadData(self, data)
         self.audienceRating = utils.cast(float, data.attrib.get('audienceRating'))
         self.audienceRatingImage = data.attrib.get('audienceRatingImage')
-        self.chapters = self.findItems(data, media.Chapter)
         self.chapterSource = data.attrib.get('chapterSource')
-        self.collections = self.findItems(data, media.Collection)
         self.contentRating = data.attrib.get('contentRating')
-        self.countries = self.findItems(data, media.Country)
-        self.directors = self.findItems(data, media.Director)
         self.duration = utils.cast(int, data.attrib.get('duration'))
         self.editionTitle = data.attrib.get('editionTitle')
         self.enableCreditsMarkerGeneration = utils.cast(int, data.attrib.get('enableCreditsMarkerGeneration', '-1'))
-        self.genres = self.findItems(data, media.Genre)
-        self.guids = self.findItems(data, media.Guid)
-        self.labels = self.findItems(data, media.Label)
         self.languageOverride = data.attrib.get('languageOverride')
-        self.markers = self.findItems(data, media.Marker)
-        self.media = self.findItems(data, media.Media)
         self.originallyAvailableAt = utils.toDatetime(data.attrib.get('originallyAvailableAt'), '%Y-%m-%d')
         self.originalTitle = data.attrib.get('originalTitle')
         self.primaryExtraKey = data.attrib.get('primaryExtraKey')
-        self.producers = self.findItems(data, media.Producer)
         self.rating = utils.cast(float, data.attrib.get('rating'))
         self.ratingImage = data.attrib.get('ratingImage')
-        self.ratings = self.findItems(data, media.Rating)
-        self.roles = self.findItems(data, media.Role)
         self.slug = data.attrib.get('slug')
-        self.similar = self.findItems(data, media.Similar)
         self.sourceURI = data.attrib.get('source')  # remote playlist item
         self.studio = data.attrib.get('studio')
         self.tagline = data.attrib.get('tagline')
         self.theme = data.attrib.get('theme')
-        self.ultraBlurColors = self.findItem(data, media.UltraBlurColors)
         self.useOriginalTitle = utils.cast(int, data.attrib.get('useOriginalTitle', '-1'))
         self.viewOffset = utils.cast(int, data.attrib.get('viewOffset', 0))
-        self.writers = self.findItems(data, media.Writer)
         self.year = utils.cast(int, data.attrib.get('year'))
 
+    @cached_data_property
+    def chapters(self):
+        return self.findItems(self._data, media.Chapter)
+
+    @cached_data_property
+    def collections(self):
+        return self.findItems(self._data, media.Collection)
+
+    @cached_data_property
+    def countries(self):
+        return self.findItems(self._data, media.Country)
+
+    @cached_data_property
+    def directors(self):
+        return self.findItems(self._data, media.Director)
+
+    @cached_data_property
+    def genres(self):
+        return self.findItems(self._data, media.Genre)
+
+    @cached_data_property
+    def guids(self):
+        return self.findItems(self._data, media.Guid)
+
+    @cached_data_property
+    def labels(self):
+        return self.findItems(self._data, media.Label)
+
+    @cached_data_property
+    def markers(self):
+        return self.findItems(self._data, media.Marker)
+
+    @cached_data_property
+    def media(self):
+        return self.findItems(self._data, media.Media)
+
+    @cached_data_property
+    def producers(self):
+        return self.findItems(self._data, media.Producer)
+
+    @cached_data_property
+    def ratings(self):
+        return self.findItems(self._data, media.Rating)
+
+    @cached_data_property
+    def roles(self):
+        return self.findItems(self._data, media.Role)
+
+    @cached_data_property
+    def similar(self):
+        return self.findItems(self._data, media.Similar)
+
+    @cached_data_property
+    def ultraBlurColors(self):
+        return self.findItem(self._data, media.UltraBlurColors)
+
+    @cached_data_property
+    def writers(self):
+        return self.findItems(self._data, media.Writer)
+
     @property
     def actors(self):
         """ Alias to self.roles. """
@@ -573,40 +622,67 @@ class Show(
         self.autoDeletionItemPolicyWatchedLibrary = utils.cast(
             int, data.attrib.get('autoDeletionItemPolicyWatchedLibrary', '0'))
         self.childCount = utils.cast(int, data.attrib.get('childCount'))
-        self.collections = self.findItems(data, media.Collection)
         self.contentRating = data.attrib.get('contentRating')
         self.duration = utils.cast(int, data.attrib.get('duration'))
         self.enableCreditsMarkerGeneration = utils.cast(int, data.attrib.get('enableCreditsMarkerGeneration', '-1'))
         self.episodeSort = utils.cast(int, data.attrib.get('episodeSort', '-1'))
         self.flattenSeasons = utils.cast(int, data.attrib.get('flattenSeasons', '-1'))
-        self.genres = self.findItems(data, media.Genre)
-        self.guids = self.findItems(data, media.Guid)
         self.index = utils.cast(int, data.attrib.get('index'))
         self.key = self.key.replace('/children', '')  # FIX_BUG_50
-        self.labels = self.findItems(data, media.Label)
         self.languageOverride = data.attrib.get('languageOverride')
         self.leafCount = utils.cast(int, data.attrib.get('leafCount'))
-        self.locations = self.listAttrs(data, 'path', etag='Location')
         self.network = data.attrib.get('network')
         self.originallyAvailableAt = utils.toDatetime(data.attrib.get('originallyAvailableAt'), '%Y-%m-%d')
         self.originalTitle = data.attrib.get('originalTitle')
         self.rating = utils.cast(float, data.attrib.get('rating'))
-        self.ratings = self.findItems(data, media.Rating)
-        self.roles = self.findItems(data, media.Role)
         self.seasonCount = utils.cast(int, data.attrib.get('seasonCount', self.childCount))
         self.showOrdering = data.attrib.get('showOrdering')
-        self.similar = self.findItems(data, media.Similar)
         self.slug = data.attrib.get('slug')
         self.studio = data.attrib.get('studio')
         self.subtitleLanguage = data.attrib.get('subtitleLanguage', '')
         self.subtitleMode = utils.cast(int, data.attrib.get('subtitleMode', '-1'))
         self.tagline = data.attrib.get('tagline')
         self.theme = data.attrib.get('theme')
-        self.ultraBlurColors = self.findItem(data, media.UltraBlurColors)
         self.useOriginalTitle = utils.cast(int, data.attrib.get('useOriginalTitle', '-1'))
         self.viewedLeafCount = utils.cast(int, data.attrib.get('viewedLeafCount'))
         self.year = utils.cast(int, data.attrib.get('year'))
 
+    @cached_data_property
+    def collections(self):
+        return self.findItems(self._data, media.Collection)
+
+    @cached_data_property
+    def genres(self):
+        return self.findItems(self._data, media.Genre)
+
+    @cached_data_property
+    def guids(self):
+        return self.findItems(self._data, media.Guid)
+
+    @cached_data_property
+    def labels(self):
+        return self.findItems(self._data, media.Label)
+
+    @cached_data_property
+    def locations(self):
+        return self.listAttrs(self._data, 'path', etag='Location')
+
+    @cached_data_property
+    def ratings(self):
+        return self.findItems(self._data, media.Rating)
+
+    @cached_data_property
+    def roles(self):
+        return self.findItems(self._data, media.Role)
+
+    @cached_data_property
+    def similar(self):
+        return self.findItems(self._data, media.Similar)
+
+    @cached_data_property
+    def ultraBlurColors(self):
+        return self.findItem(self._data, media.UltraBlurColors)
+
     def __iter__(self):
         for season in self.seasons():
             yield season
@@ -759,11 +835,8 @@ class Season(
         Video._loadData(self, data)
         self.audienceRating = utils.cast(float, data.attrib.get('audienceRating'))
         self.audioLanguage = data.attrib.get('audioLanguage', '')
-        self.collections = self.findItems(data, media.Collection)
-        self.guids = self.findItems(data, media.Guid)
         self.index = utils.cast(int, data.attrib.get('index'))
         self.key = self.key.replace('/children', '')  # FIX_BUG_50
-        self.labels = self.findItems(data, media.Label)
         self.leafCount = utils.cast(int, data.attrib.get('leafCount'))
         self.parentGuid = data.attrib.get('parentGuid')
         self.parentIndex = utils.cast(int, data.attrib.get('parentIndex'))
@@ -775,13 +848,31 @@ class Season(
         self.parentThumb = data.attrib.get('parentThumb')
         self.parentTitle = data.attrib.get('parentTitle')
         self.rating = utils.cast(float, data.attrib.get('rating'))
-        self.ratings = self.findItems(data, media.Rating)
         self.subtitleLanguage = data.attrib.get('subtitleLanguage', '')
         self.subtitleMode = utils.cast(int, data.attrib.get('subtitleMode', '-1'))
-        self.ultraBlurColors = self.findItem(data, media.UltraBlurColors)
         self.viewedLeafCount = utils.cast(int, data.attrib.get('viewedLeafCount'))
         self.year = utils.cast(int, data.attrib.get('year'))
 
+    @cached_data_property
+    def collections(self):
+        return self.findItems(self._data, media.Collection)
+
+    @cached_data_property
+    def guids(self):
+        return self.findItems(self._data, media.Guid)
+
+    @cached_data_property
+    def labels(self):
+        return self.findItems(self._data, media.Label)
+
+    @cached_data_property
+    def ratings(self):
+        return self.findItems(self._data, media.Rating)
+
+    @cached_data_property
+    def ultraBlurColors(self):
+        return self.findItem(self._data, media.UltraBlurColors)
+
     def __iter__(self):
         for episode in self.episodes():
             yield episode
@@ -942,11 +1033,8 @@ class Episode(
         Playable._loadData(self, data)
         self.audienceRating = utils.cast(float, data.attrib.get('audienceRating'))
         self.audienceRatingImage = data.attrib.get('audienceRatingImage')
-        self.chapters = self.findItems(data, media.Chapter)
         self.chapterSource = data.attrib.get('chapterSource')
-        self.collections = self.findItems(data, media.Collection)
         self.contentRating = data.attrib.get('contentRating')
-        self.directors = self.findItems(data, media.Director)
         self.duration = utils.cast(int, data.attrib.get('duration'))
         self.grandparentArt = data.attrib.get('grandparentArt')
         self.grandparentGuid = data.attrib.get('grandparentGuid')
@@ -956,25 +1044,16 @@ class Episode(
         self.grandparentTheme = data.attrib.get('grandparentTheme')
         self.grandparentThumb = data.attrib.get('grandparentThumb')
         self.grandparentTitle = data.attrib.get('grandparentTitle')
-        self.guids = self.findItems(data, media.Guid)
         self.index = utils.cast(int, data.attrib.get('index'))
-        self.labels = self.findItems(data, media.Label)
-        self.markers = self.findItems(data, media.Marker)
-        self.media = self.findItems(data, media.Media)
         self.originallyAvailableAt = utils.toDatetime(data.attrib.get('originallyAvailableAt'), '%Y-%m-%d')
         self.parentGuid = data.attrib.get('parentGuid')
         self.parentIndex = utils.cast(int, data.attrib.get('parentIndex'))
         self.parentTitle = data.attrib.get('parentTitle')
         self.parentYear = utils.cast(int, data.attrib.get('parentYear'))
-        self.producers = self.findItems(data, media.Producer)
         self.rating = utils.cast(float, data.attrib.get('rating'))
-        self.ratings = self.findItems(data, media.Rating)
-        self.roles = self.findItems(data, media.Role)
         self.skipParent = utils.cast(bool, data.attrib.get('skipParent', '0'))
         self.sourceURI = data.attrib.get('source')  # remote playlist item
-        self.ultraBlurColors = self.findItem(data, media.UltraBlurColors)
         self.viewOffset = utils.cast(int, data.attrib.get('viewOffset', 0))
-        self.writers = self.findItems(data, media.Writer)
         self.year = utils.cast(int, data.attrib.get('year'))
 
         # If seasons are hidden, parentKey and parentRatingKey are missing from the XML response.
@@ -984,7 +1063,55 @@ class Episode(
         self._parentRatingKey = utils.cast(int, data.attrib.get('parentRatingKey'))
         self._parentThumb = data.attrib.get('parentThumb')
 
-    @cached_property
+    @cached_data_property
+    def chapters(self):
+        return self.findItems(self._data, media.Chapter)
+
+    @cached_data_property
+    def collections(self):
+        return self.findItems(self._data, media.Collection)
+
+    @cached_data_property
+    def directors(self):
+        return self.findItems(self._data, media.Director)
+
+    @cached_data_property
+    def guids(self):
+        return self.findItems(self._data, media.Guid)
+
+    @cached_data_property
+    def labels(self):
+        return self.findItems(self._data, media.Label)
+
+    @cached_data_property
+    def markers(self):
+        return self.findItems(self._data, media.Marker)
+
+    @cached_data_property
+    def media(self):
+        return self.findItems(self._data, media.Media)
+
+    @cached_data_property
+    def producers(self):
+        return self.findItems(self._data, media.Producer)
+
+    @cached_data_property
+    def ratings(self):
+        return self.findItems(self._data, media.Rating)
+
+    @cached_data_property
+    def roles(self):
+        return self.findItems(self._data, media.Role)
+
+    @cached_data_property
+    def writers(self):
+        return self.findItems(self._data, media.Writer)
+
+    @cached_data_property
+    def ultraBlurColors(self):
+        return self.findItem(self._data, media.UltraBlurColors)
+
+    @cached_data_property
     def parentKey(self):
         """ Returns the parentKey. Refer to the Episode attributes. """
         if self._parentKey:
@@ -993,7 +1120,7 @@ class Episode(
             return f'/library/metadata/{self.parentRatingKey}'
         return None
 
-    @cached_property
+    @cached_data_property
     def parentRatingKey(self):
         """ Returns the parentRatingKey. Refer to the Episode attributes. """
         if self._parentRatingKey is not None:
@@ -1006,7 +1133,7 @@ class Episode(
             return self._season.ratingKey
         return None
 
-    @cached_property
+    @cached_data_property
     def parentThumb(self):
         """ Returns the parentThumb. Refer to the Episode attributes. """
         if self._parentThumb:
@@ -1015,7 +1142,7 @@ class Episode(
             return self._season.thumb
         return None
 
-    @cached_property
+    @cached_data_property
     def _season(self):
         """ Returns the :class:`~plexapi.video.Season` object by querying for the show's children. """
         if self.grandparentKey and self.parentIndex is not None:
@@ -1055,7 +1182,7 @@ class Episode(
         """ Returns the episode number. """
         return self.index
 
-    @cached_property
+    @cached_data_property
     def seasonNumber(self):
         """ Returns the episode's season number. """
         if isinstance(self.parentIndex, int):
@@ -1149,12 +1276,10 @@ class Clip(
         """ Load attribute values from Plex XML response. """
         Video._loadData(self, data)
         Playable._loadData(self, data)
-        self._data = data
         self.addedAt = utils.toDatetime(data.attrib.get('addedAt'))
         self.duration = utils.cast(int, data.attrib.get('duration'))
         self.extraType = utils.cast(int, data.attrib.get('extraType'))
         self.index = utils.cast(int, data.attrib.get('index'))
-        self.media = self.findItems(data, media.Media)
         self.originallyAvailableAt = utils.toDatetime(
             data.attrib.get('originallyAvailableAt'), '%Y-%m-%d')
         self.skipDetails = utils.cast(int, data.attrib.get('skipDetails'))
@@ -1163,6 +1288,10 @@ class Clip(
         self.viewOffset = utils.cast(int, data.attrib.get('viewOffset', 0))
         self.year = utils.cast(int, data.attrib.get('year'))
 
+    @cached_data_property
+    def media(self):
+        return self.findItems(self._data, media.Media)
+
     @property
     def locations(self):
         """ This does not exist in plex xml response but is added to have a common
diff --git a/requirements.txt b/requirements.txt
index a34ae985..bb47f167 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -2,7 +2,7 @@ apscheduler==3.10.1
 arrow==1.3.0
 beautifulsoup4==4.12.3
 bleach==6.2.0
-certifi==2024.8.30
+certifi==2025.04.26
 cheroot==10.0.1
 cherrypy==18.10.0
 cherrypy-cors==1.7.0

From c4f8a811902160b2752eb4f3c424be6350cb0846 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 10 May 2025 16:24:36 -0700
Subject: [PATCH 735/743] Add hearingImpaired and visualImparied to exporter
 fields

* `hearingImpaired` for `SubtitleStreams`
* `visualImpaired` for `AudioStreams`
---
 plexpy/exporter.py | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)

diff --git a/plexpy/exporter.py b/plexpy/exporter.py
index 18c20a4e..2733321e 100644
--- a/plexpy/exporter.py
+++ b/plexpy/exporter.py
@@ -339,7 +339,8 @@ class Export(object):
                             'duration': None,
                             'profile': None,
                             'samplingRate': None,
-                            'streamIdentifier': None
+                            'streamIdentifier': None,
+                            'visualImpaired': None
                         },
                         'subtitleStreams': {
                             'canAutoSync': None,
@@ -362,6 +363,8 @@ class Export(object):
                             'forced': None,
                             'format': None,
                             'headerCompression': None,
+                            'hearingImpaired': None,
+                            'perfectMatch': None,
                             'providerTitle': None,
                             'score': None,
                             'sourceKey': None,
@@ -761,7 +764,8 @@ class Export(object):
                             'duration': None,
                             'profile': None,
                             'samplingRate': None,
-                            'streamIdentifier': None
+                            'streamIdentifier': None,
+                            'visualImpaired': None
                         },
                         'subtitleStreams': {
                             'canAutoSync': None,
@@ -784,6 +788,8 @@ class Export(object):
                             'forced': None,
                             'format': None,
                             'headerCompression': None,
+                            'hearingImpaired': None,
+                            'perfectMatch': None,
                             'providerTitle': None,
                             'score': None,
                             'sourceKey': None,
@@ -1098,7 +1104,9 @@ class Export(object):
                             'peak': None,
                             'profile': None,
                             'samplingRate': None,
-                            'startRamp': None
+                            'startRamp': None,
+                            'streamIdentifier': None,
+                            'visualImpaired': None
                         },
                         'lyricStreams': {
                             'codec': None,

From 43fc7eebfeb820b7113e7cd4642f29158a75a6e3 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 10 May 2025 16:26:12 -0700
Subject: [PATCH 736/743] Update is_hdr helper function

---
 plexpy/exporter.py   | 2 +-
 plexpy/helpers.py    | 4 ++--
 plexpy/pmsconnect.py | 2 +-
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/plexpy/exporter.py b/plexpy/exporter.py
index 2733321e..b1e07de2 100644
--- a/plexpy/exporter.py
+++ b/plexpy/exporter.py
@@ -729,7 +729,7 @@ class Export(object):
                             'frameRate': None,
                             'frameRateMode': None,
                             'hasScalingMatrix': None,
-                            'hdr': lambda o: helpers.is_hdr(getattr(o, 'bitDepth', 0), getattr(o, 'colorSpace', '')),
+                            'hdr': lambda o: helpers.is_hdr(getattr(o, 'bitDepth', 0), getattr(o, 'colorTrc', '')),
                             'height': None,
                             'level': None,
                             'pixelAspectRatio': None,
diff --git a/plexpy/helpers.py b/plexpy/helpers.py
index fdb79830..ddf100d1 100644
--- a/plexpy/helpers.py
+++ b/plexpy/helpers.py
@@ -1483,9 +1483,9 @@ def move_to_front(l, value):
     return l
 
 
-def is_hdr(bit_depth, color_space):
+def is_hdr(bit_depth, color_trc):
     bit_depth = cast_to_int(bit_depth)
-    return bit_depth > 8 and color_space == 'bt2020nc'
+    return bit_depth > 8 and (color_trc == 'smpte2084' or color_trc == 'arib-std-b67')
 
 
 def version_to_tuple(version):
diff --git a/plexpy/pmsconnect.py b/plexpy/pmsconnect.py
index ed115897..ac23ce82 100644
--- a/plexpy/pmsconnect.py
+++ b/plexpy/pmsconnect.py
@@ -3391,7 +3391,7 @@ class PmsConnect(object):
         color_trc = helpers.get_xml_attr(stream, 'colorTrc')
         DOVI_profile = helpers.get_xml_attr(stream, 'DOVIProfile')
 
-        HDR = bool(bit_depth > 8 and (color_trc == 'smpte2084' or color_trc == 'arib-std-b67'))
+        HDR = helpers.is_hdr(bit_depth, color_trc)
         DV = bool(DOVI_profile)
 
         if not HDR and not DV:

From 9a6253d775fdc405fd3a5506e4ae34a8b782a1f7 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sat, 10 May 2025 16:28:32 -0700
Subject: [PATCH 737/743] Enable jquery.scrollbar on macosx and webkit

Fixes #2221

Ref: gromo/jquery.scrollbar#134
---
 data/interfaces/default/js/jquery.scrollbar.min.js | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/data/interfaces/default/js/jquery.scrollbar.min.js b/data/interfaces/default/js/jquery.scrollbar.min.js
index 5a86f9ad..cf9d8935 100644
--- a/data/interfaces/default/js/jquery.scrollbar.min.js
+++ b/data/interfaces/default/js/jquery.scrollbar.min.js
@@ -13,4 +13,4 @@
  * @url https://github.com/gromo/jquery.scrollbar/
  *
  */
-!function(a,b){"function"==typeof define&&define.amd?define(["jquery"],b):b("undefined"!=typeof exports?require("jquery"):a.jQuery)}(this,function(a){"use strict";function h(b){if(c.webkit&&!b)return{height:0,width:0};if(!c.data.outer){var d={border:"none","box-sizing":"content-box",height:"200px",margin:"0",padding:"0",width:"200px"};c.data.inner=a("<div>").css(a.extend({},d)),c.data.outer=a("<div>").css(a.extend({left:"-1000px",overflow:"scroll",position:"absolute",top:"-1000px"},d)).append(c.data.inner).appendTo("body")}return c.data.outer.scrollLeft(1e3).scrollTop(1e3),{height:Math.ceil(c.data.outer.offset().top-c.data.inner.offset().top||0),width:Math.ceil(c.data.outer.offset().left-c.data.inner.offset().left||0)}}function i(){var a=h(!0);return!(a.height||a.width)}function j(a){var b=a.originalEvent;return(!b.axis||b.axis!==b.HORIZONTAL_AXIS)&&!b.wheelDeltaX}var b=!1,c={data:{index:0,name:"scrollbar"},firefox:/firefox/i.test(navigator.userAgent),macosx:/mac/i.test(navigator.platform),msedge:/edge\/\d+/i.test(navigator.userAgent),msie:/(msie|trident)/i.test(navigator.userAgent),mobile:/android|webos|iphone|ipad|ipod|blackberry/i.test(navigator.userAgent),overlay:null,scroll:null,scrolls:[],webkit:/webkit/i.test(navigator.userAgent)&&!/edge\/\d+/i.test(navigator.userAgent)};c.scrolls.add=function(a){this.remove(a).push(a)},c.scrolls.remove=function(b){for(;a.inArray(b,this)>=0;)this.splice(a.inArray(b,this),1);return this};var d={autoScrollSize:!0,autoUpdate:!0,debug:!1,disableBodyScroll:!1,duration:200,ignoreMobile:!1,ignoreOverlay:!1,isRtl:!1,scrollStep:30,showArrows:!1,stepScrolling:!0,scrollx:null,scrolly:null,onDestroy:null,onFallback:null,onInit:null,onScroll:null,onUpdate:null},e=function(b){c.scroll||(c.overlay=i(),c.scroll=h(),g(),a(window).resize(function(){var a=!1;if(c.scroll&&(c.scroll.height||c.scroll.width)){var b=h();b.height===c.scroll.height&&b.width===c.scroll.width||(c.scroll=b,a=!0)}g(a)})),this.container=b,this.namespace=".scrollbar_"+c.data.index++,this.options=a.extend({},d,window.jQueryScrollbarOptions||{}),this.scrollTo=null,this.scrollx={},this.scrolly={},b.data(c.data.name,this),c.scrolls.add(this)};e.prototype={destroy:function(){if(this.wrapper){this.container.removeData(c.data.name),c.scrolls.remove(this);var b=this.container.scrollLeft(),d=this.container.scrollTop();this.container.insertBefore(this.wrapper).css({height:"",margin:"","max-height":""}).removeClass("scroll-content scroll-scrollx_visible scroll-scrolly_visible").off(this.namespace).scrollLeft(b).scrollTop(d),this.scrollx.scroll.removeClass("scroll-scrollx_visible").find("div").addBack().off(this.namespace),this.scrolly.scroll.removeClass("scroll-scrolly_visible").find("div").addBack().off(this.namespace),this.wrapper.remove(),a(document).add("body").off(this.namespace),a.isFunction(this.options.onDestroy)&&this.options.onDestroy.apply(this,[this.container])}},init:function(b){var d=this,e=this.container,f=this.containerWrapper||e,g=this.namespace,h=a.extend(this.options,b||{}),i={x:this.scrollx,y:this.scrolly},k=this.wrapper,l={},m={scrollLeft:e.scrollLeft(),scrollTop:e.scrollTop()};if(c.mobile&&h.ignoreMobile||c.overlay&&h.ignoreOverlay||c.macosx&&!c.webkit)return a.isFunction(h.onFallback)&&h.onFallback.apply(this,[e]),!1;if(k)l={height:"auto","margin-bottom":c.scroll.height*-1+"px","max-height":""},l[h.isRtl?"margin-left":"margin-right"]=c.scroll.width*-1+"px",f.css(l);else{if(this.wrapper=k=a("<div>").addClass("scroll-wrapper").addClass(e.attr("class")).css("position","absolute"===e.css("position")?"absolute":"relative").insertBefore(e).append(e),h.isRtl&&k.addClass("scroll--rtl"),e.is("textarea")&&(this.containerWrapper=f=a("<div>").insertBefore(e).append(e),k.addClass("scroll-textarea")),l={height:"auto","margin-bottom":c.scroll.height*-1+"px","max-height":""},l[h.isRtl?"margin-left":"margin-right"]=c.scroll.width*-1+"px",f.addClass("scroll-content").css(l),e.on("scroll"+g,function(b){var f=e.scrollLeft(),g=e.scrollTop();if(h.isRtl)switch(!0){case c.firefox:f=Math.abs(f);case c.msedge||c.msie:f=e[0].scrollWidth-e[0].clientWidth-f}a.isFunction(h.onScroll)&&h.onScroll.call(d,{maxScroll:i.y.maxScrollOffset,scroll:g,size:i.y.size,visible:i.y.visible},{maxScroll:i.x.maxScrollOffset,scroll:f,size:i.x.size,visible:i.x.visible}),i.x.isVisible&&i.x.scroll.bar.css("left",f*i.x.kx+"px"),i.y.isVisible&&i.y.scroll.bar.css("top",g*i.y.kx+"px")}),k.on("scroll"+g,function(){k.scrollTop(0).scrollLeft(0)}),h.disableBodyScroll){var n=function(a){j(a)?i.y.isVisible&&i.y.mousewheel(a):i.x.isVisible&&i.x.mousewheel(a)};k.on("MozMousePixelScroll"+g,n),k.on("mousewheel"+g,n),c.mobile&&k.on("touchstart"+g,function(b){var c=b.originalEvent.touches&&b.originalEvent.touches[0]||b,d={pageX:c.pageX,pageY:c.pageY},f={left:e.scrollLeft(),top:e.scrollTop()};a(document).on("touchmove"+g,function(a){var b=a.originalEvent.targetTouches&&a.originalEvent.targetTouches[0]||a;e.scrollLeft(f.left+d.pageX-b.pageX),e.scrollTop(f.top+d.pageY-b.pageY),a.preventDefault()}),a(document).on("touchend"+g,function(){a(document).off(g)})})}a.isFunction(h.onInit)&&h.onInit.apply(this,[e])}a.each(i,function(b,f){var k=null,l=1,m="x"===b?"scrollLeft":"scrollTop",n=h.scrollStep,o=function(){var a=e[m]();e[m](a+n),1==l&&a+n>=p&&(a=e[m]()),l==-1&&a+n<=p&&(a=e[m]()),e[m]()==a&&k&&k()},p=0;f.scroll||(f.scroll=d._getScroll(h["scroll"+b]).addClass("scroll-"+b),h.showArrows&&f.scroll.addClass("scroll-element_arrows_visible"),f.mousewheel=function(a){if(!f.isVisible||"x"===b&&j(a))return!0;if("y"===b&&!j(a))return i.x.mousewheel(a),!0;var c=a.originalEvent.wheelDelta*-1||a.originalEvent.detail,g=f.size-f.visible-f.offset;return c||("x"===b&&a.originalEvent.deltaX?c=40*a.originalEvent.deltaX:"y"===b&&a.originalEvent.deltaY&&(c=40*a.originalEvent.deltaY)),(c>0&&p<g||c<0&&p>0)&&(p+=c,p<0&&(p=0),p>g&&(p=g),d.scrollTo=d.scrollTo||{},d.scrollTo[m]=p,setTimeout(function(){d.scrollTo&&(e.stop().animate(d.scrollTo,240,"linear",function(){p=e[m]()}),d.scrollTo=null)},1)),a.preventDefault(),!1},f.scroll.on("MozMousePixelScroll"+g,f.mousewheel).on("mousewheel"+g,f.mousewheel).on("mouseenter"+g,function(){p=e[m]()}),f.scroll.find(".scroll-arrow, .scroll-element_track").on("mousedown"+g,function(g){if(1!=g.which)return!0;l=1;var i={eventOffset:g["x"===b?"pageX":"pageY"],maxScrollValue:f.size-f.visible-f.offset,scrollbarOffset:f.scroll.bar.offset()["x"===b?"left":"top"],scrollbarSize:f.scroll.bar["x"===b?"outerWidth":"outerHeight"]()},j=0,q=0;if(a(this).hasClass("scroll-arrow")){if(l=a(this).hasClass("scroll-arrow_more")?1:-1,n=h.scrollStep*l,p=l>0?i.maxScrollValue:0,h.isRtl)switch(!0){case c.firefox:p=l>0?0:i.maxScrollValue*-1;break;case c.msie||c.msedge:}}else l=i.eventOffset>i.scrollbarOffset+i.scrollbarSize?1:i.eventOffset<i.scrollbarOffset?-1:0,"x"===b&&h.isRtl&&(c.msie||c.msedge)&&(l*=-1),n=Math.round(.75*f.visible)*l,p=i.eventOffset-i.scrollbarOffset-(h.stepScrolling?1==l?i.scrollbarSize:0:Math.round(i.scrollbarSize/2)),p=e[m]()+p/f.kx;return d.scrollTo=d.scrollTo||{},d.scrollTo[m]=h.stepScrolling?e[m]()+n:p,h.stepScrolling&&(k=function(){p=e[m](),clearInterval(q),clearTimeout(j),j=0,q=0},j=setTimeout(function(){q=setInterval(o,40)},h.duration+100)),setTimeout(function(){d.scrollTo&&(e.animate(d.scrollTo,h.duration),d.scrollTo=null)},1),d._handleMouseDown(k,g)}),f.scroll.bar.on("mousedown"+g,function(i){if(1!=i.which)return!0;var j=i["x"===b?"pageX":"pageY"],k=e[m]();return f.scroll.addClass("scroll-draggable"),a(document).on("mousemove"+g,function(a){var d=parseInt((a["x"===b?"pageX":"pageY"]-j)/f.kx,10);"x"===b&&h.isRtl&&(c.msie||c.msedge)&&(d*=-1),e[m](k+d)}),d._handleMouseDown(function(){f.scroll.removeClass("scroll-draggable"),p=e[m]()},i)}))}),a.each(i,function(a,b){var c="scroll-scroll"+a+"_visible",d="x"==a?i.y:i.x;b.scroll.removeClass(c),d.scroll.removeClass(c),f.removeClass(c)}),a.each(i,function(b,c){a.extend(c,"x"==b?{offset:parseInt(e.css("left"),10)||0,size:e.prop("scrollWidth"),visible:k.width()}:{offset:parseInt(e.css("top"),10)||0,size:e.prop("scrollHeight"),visible:k.height()})}),this._updateScroll("x",this.scrollx),this._updateScroll("y",this.scrolly),a.isFunction(h.onUpdate)&&h.onUpdate.apply(this,[e]),a.each(i,function(a,b){var c="x"===a?"left":"top",d="x"===a?"outerWidth":"outerHeight",f="x"===a?"width":"height",g=parseInt(e.css(c),10)||0,i=b.size,j=b.visible+g,k=b.scroll.size[d]()+(parseInt(b.scroll.size.css(c),10)||0);h.autoScrollSize&&(b.scrollbarSize=parseInt(k*j/i,10),b.scroll.bar.css(f,b.scrollbarSize+"px")),b.scrollbarSize=b.scroll.bar[d](),b.kx=(k-b.scrollbarSize)/(i-j)||1,b.maxScrollOffset=i-j}),e.scrollLeft(m.scrollLeft).scrollTop(m.scrollTop).trigger("scroll")},_getScroll:function(b){var c={advanced:['<div class="scroll-element">','<div class="scroll-element_corner"></div>','<div class="scroll-arrow scroll-arrow_less"></div>','<div class="scroll-arrow scroll-arrow_more"></div>','<div class="scroll-element_outer">','<div class="scroll-element_size"></div>','<div class="scroll-element_inner-wrapper">','<div class="scroll-element_inner scroll-element_track">','<div class="scroll-element_inner-bottom"></div>',"</div>","</div>",'<div class="scroll-bar">','<div class="scroll-bar_body">','<div class="scroll-bar_body-inner"></div>',"</div>",'<div class="scroll-bar_bottom"></div>','<div class="scroll-bar_center"></div>',"</div>","</div>","</div>"].join(""),simple:['<div class="scroll-element">','<div class="scroll-element_outer">','<div class="scroll-element_size"></div>','<div class="scroll-element_track"></div>','<div class="scroll-bar"></div>',"</div>","</div>"].join("")};return c[b]&&(b=c[b]),b||(b=c.simple),b="string"==typeof b?a(b).appendTo(this.wrapper):a(b),a.extend(b,{bar:b.find(".scroll-bar"),size:b.find(".scroll-element_size"),track:b.find(".scroll-element_track")}),b},_handleMouseDown:function(b,c){var d=this.namespace;return a(document).on("blur"+d,function(){a(document).add("body").off(d),b&&b()}),a(document).on("dragstart"+d,function(a){return a.preventDefault(),!1}),a(document).on("mouseup"+d,function(){a(document).add("body").off(d),b&&b()}),a("body").on("selectstart"+d,function(a){return a.preventDefault(),!1}),c&&c.preventDefault(),!1},_updateScroll:function(b,d){var e=this.container,f=this.containerWrapper||e,g="scroll-scroll"+b+"_visible",h="x"===b?this.scrolly:this.scrollx,i=parseInt(this.container.css("x"===b?"left":"top"),10)||0,j=this.wrapper,k=d.size,l=d.visible+i;d.isVisible=k-l>1,d.isVisible?(d.scroll.addClass(g),h.scroll.addClass(g),f.addClass(g)):(d.scroll.removeClass(g),h.scroll.removeClass(g),f.removeClass(g)),"y"===b&&(e.is("textarea")||k<l?f.css({height:l+c.scroll.height+"px","max-height":"none"}):f.css({"max-height":l+c.scroll.height+"px"})),d.size==e.prop("scrollWidth")&&h.size==e.prop("scrollHeight")&&d.visible==j.width()&&h.visible==j.height()&&d.offset==(parseInt(e.css("left"),10)||0)&&h.offset==(parseInt(e.css("top"),10)||0)||(a.extend(this.scrollx,{offset:parseInt(e.css("left"),10)||0,size:e.prop("scrollWidth"),visible:j.width()}),a.extend(this.scrolly,{offset:parseInt(e.css("top"),10)||0,size:this.container.prop("scrollHeight"),visible:j.height()}),this._updateScroll("x"===b?"y":"x",h))}};var f=e;a.fn.scrollbar=function(b,d){return"string"!=typeof b&&(d=b,b="init"),"undefined"==typeof d&&(d=[]),a.isArray(d)||(d=[d]),this.not("body, .scroll-wrapper").each(function(){var e=a(this),g=e.data(c.data.name);(g||"init"===b)&&(g||(g=new f(e)),g[b]&&g[b].apply(g,d))}),this},a.fn.scrollbar.options=d;var g=function(){var a=0,d=0;return function(e){var f,h,i,j,k,l,m;for(f=0;f<c.scrolls.length;f++)j=c.scrolls[f],h=j.container,i=j.options,k=j.wrapper,l=j.scrollx,m=j.scrolly,(e||i.autoUpdate&&k&&k.is(":visible")&&(h.prop("scrollWidth")!=l.size||h.prop("scrollHeight")!=m.size||k.width()!=l.visible||k.height()!=m.visible))&&(j.init(),i.debug&&(window.console&&console.log({scrollHeight:h.prop("scrollHeight")+":"+j.scrolly.size,scrollWidth:h.prop("scrollWidth")+":"+j.scrollx.size,visibleHeight:k.height()+":"+j.scrolly.visible,visibleWidth:k.width()+":"+j.scrollx.visible},!0),d++));b&&d>10?(window.console&&console.log("Scroll updates exceed 10"),g=function(){}):(clearTimeout(a),a=setTimeout(g,300))}}();window.angular&&!function(a){a.module("jQueryScrollbar",[]).provider("jQueryScrollbar",function(){var b=d;return{setOptions:function(c){a.extend(b,c)},$get:function(){return{options:a.copy(b)}}}}).directive("jqueryScrollbar",["jQueryScrollbar","$parse",function(a,b){return{restrict:"AC",link:function(c,d,e){var f=b(e.jqueryScrollbar),g=f(c);d.scrollbar(g||a.options).on("$destroy",function(){d.scrollbar("destroy")})}}}])}(window.angular)});
\ No newline at end of file
+!function(a,b){"function"==typeof define&&define.amd?define(["jquery"],b):b("undefined"!=typeof exports?require("jquery"):a.jQuery)}(this,function(a){"use strict";function h(b){if(c.webkit&&!b)return{height:0,width:0};if(!c.data.outer){var d={border:"none","box-sizing":"content-box",height:"200px",margin:"0",padding:"0",width:"200px"};c.data.inner=a("<div>").css(a.extend({},d)),c.data.outer=a("<div>").css(a.extend({left:"-1000px",overflow:"scroll",position:"absolute",top:"-1000px"},d)).append(c.data.inner).appendTo("body")}return c.data.outer.scrollLeft(1e3).scrollTop(1e3),{height:Math.ceil(c.data.outer.offset().top-c.data.inner.offset().top||0),width:Math.ceil(c.data.outer.offset().left-c.data.inner.offset().left||0)}}function i(){var a=h(!0);return!(a.height||a.width)}function j(a){var b=a.originalEvent;return(!b.axis||b.axis!==b.HORIZONTAL_AXIS)&&!b.wheelDeltaX}var b=!1,c={data:{index:0,name:"scrollbar"},firefox:/firefox/i.test(navigator.userAgent),macosx:/mac/i.test(navigator.platform),msedge:/edge\/\d+/i.test(navigator.userAgent),msie:/(msie|trident)/i.test(navigator.userAgent),mobile:/android|webos|iphone|ipad|ipod|blackberry/i.test(navigator.userAgent),overlay:null,scroll:null,scrolls:[],webkit:/webkit/i.test(navigator.userAgent)&&!/edge\/\d+/i.test(navigator.userAgent)};c.scrolls.add=function(a){this.remove(a).push(a)},c.scrolls.remove=function(b){for(;a.inArray(b,this)>=0;)this.splice(a.inArray(b,this),1);return this};var d={autoScrollSize:!0,autoUpdate:!0,debug:!1,disableBodyScroll:!1,duration:200,ignoreMobile:!1,ignoreOverlay:!1,isRtl:!1,scrollStep:30,showArrows:!1,stepScrolling:!0,scrollx:null,scrolly:null,onDestroy:null,onFallback:null,onInit:null,onScroll:null,onUpdate:null},e=function(b){c.scroll||(c.overlay=i(),c.scroll=h(),g(),a(window).resize(function(){var a=!1;if(c.scroll&&(c.scroll.height||c.scroll.width)){var b=h();b.height===c.scroll.height&&b.width===c.scroll.width||(c.scroll=b,a=!0)}g(a)})),this.container=b,this.namespace=".scrollbar_"+c.data.index++,this.options=a.extend({},d,window.jQueryScrollbarOptions||{}),this.scrollTo=null,this.scrollx={},this.scrolly={},b.data(c.data.name,this),c.scrolls.add(this)};e.prototype={destroy:function(){if(this.wrapper){this.container.removeData(c.data.name),c.scrolls.remove(this);var b=this.container.scrollLeft(),d=this.container.scrollTop();this.container.insertBefore(this.wrapper).css({height:"",margin:"","max-height":""}).removeClass("scroll-content scroll-scrollx_visible scroll-scrolly_visible").off(this.namespace).scrollLeft(b).scrollTop(d),this.scrollx.scroll.removeClass("scroll-scrollx_visible").find("div").addBack().off(this.namespace),this.scrolly.scroll.removeClass("scroll-scrolly_visible").find("div").addBack().off(this.namespace),this.wrapper.remove(),a(document).add("body").off(this.namespace),a.isFunction(this.options.onDestroy)&&this.options.onDestroy.apply(this,[this.container])}},init:function(b){var d=this,e=this.container,f=this.containerWrapper||e,g=this.namespace,h=a.extend(this.options,b||{}),i={x:this.scrollx,y:this.scrolly},k=this.wrapper,l={},m={scrollLeft:e.scrollLeft(),scrollTop:e.scrollTop()};if(c.mobile&&h.ignoreMobile||c.overlay&&h.ignoreOverlay)return a.isFunction(h.onFallback)&&h.onFallback.apply(this,[e]),!1;if(k)l={height:"auto","margin-bottom":c.scroll.height*-1+"px","max-height":""},l[h.isRtl?"margin-left":"margin-right"]=c.scroll.width*-1+"px",f.css(l);else{if(this.wrapper=k=a("<div>").addClass("scroll-wrapper").addClass(e.attr("class")).css("position","absolute"===e.css("position")?"absolute":"relative").insertBefore(e).append(e),h.isRtl&&k.addClass("scroll--rtl"),e.is("textarea")&&(this.containerWrapper=f=a("<div>").insertBefore(e).append(e),k.addClass("scroll-textarea")),l={height:"auto","margin-bottom":c.scroll.height*-1+"px","max-height":""},l[h.isRtl?"margin-left":"margin-right"]=c.scroll.width*-1+"px",f.addClass("scroll-content").css(l),e.on("scroll"+g,function(b){var f=e.scrollLeft(),g=e.scrollTop();if(h.isRtl)switch(!0){case c.firefox:f=Math.abs(f);case c.msedge||c.msie:f=e[0].scrollWidth-e[0].clientWidth-f}a.isFunction(h.onScroll)&&h.onScroll.call(d,{maxScroll:i.y.maxScrollOffset,scroll:g,size:i.y.size,visible:i.y.visible},{maxScroll:i.x.maxScrollOffset,scroll:f,size:i.x.size,visible:i.x.visible}),i.x.isVisible&&i.x.scroll.bar.css("left",f*i.x.kx+"px"),i.y.isVisible&&i.y.scroll.bar.css("top",g*i.y.kx+"px")}),k.on("scroll"+g,function(){k.scrollTop(0).scrollLeft(0)}),h.disableBodyScroll){var n=function(a){j(a)?i.y.isVisible&&i.y.mousewheel(a):i.x.isVisible&&i.x.mousewheel(a)};k.on("MozMousePixelScroll"+g,n),k.on("mousewheel"+g,n),c.mobile&&k.on("touchstart"+g,function(b){var c=b.originalEvent.touches&&b.originalEvent.touches[0]||b,d={pageX:c.pageX,pageY:c.pageY},f={left:e.scrollLeft(),top:e.scrollTop()};a(document).on("touchmove"+g,function(a){var b=a.originalEvent.targetTouches&&a.originalEvent.targetTouches[0]||a;e.scrollLeft(f.left+d.pageX-b.pageX),e.scrollTop(f.top+d.pageY-b.pageY),a.preventDefault()}),a(document).on("touchend"+g,function(){a(document).off(g)})})}a.isFunction(h.onInit)&&h.onInit.apply(this,[e])}a.each(i,function(b,f){var k=null,l=1,m="x"===b?"scrollLeft":"scrollTop",n=h.scrollStep,o=function(){var a=e[m]();e[m](a+n),1==l&&a+n>=p&&(a=e[m]()),l==-1&&a+n<=p&&(a=e[m]()),e[m]()==a&&k&&k()},p=0;f.scroll||(f.scroll=d._getScroll(h["scroll"+b]).addClass("scroll-"+b),h.showArrows&&f.scroll.addClass("scroll-element_arrows_visible"),f.mousewheel=function(a){if(!f.isVisible||"x"===b&&j(a))return!0;if("y"===b&&!j(a))return i.x.mousewheel(a),!0;var c=a.originalEvent.wheelDelta*-1||a.originalEvent.detail,g=f.size-f.visible-f.offset;return c||("x"===b&&a.originalEvent.deltaX?c=40*a.originalEvent.deltaX:"y"===b&&a.originalEvent.deltaY&&(c=40*a.originalEvent.deltaY)),(c>0&&p<g||c<0&&p>0)&&(p+=c,p<0&&(p=0),p>g&&(p=g),d.scrollTo=d.scrollTo||{},d.scrollTo[m]=p,setTimeout(function(){d.scrollTo&&(e.stop().animate(d.scrollTo,240,"linear",function(){p=e[m]()}),d.scrollTo=null)},1)),a.preventDefault(),!1},f.scroll.on("MozMousePixelScroll"+g,f.mousewheel).on("mousewheel"+g,f.mousewheel).on("mouseenter"+g,function(){p=e[m]()}),f.scroll.find(".scroll-arrow, .scroll-element_track").on("mousedown"+g,function(g){if(1!=g.which)return!0;l=1;var i={eventOffset:g["x"===b?"pageX":"pageY"],maxScrollValue:f.size-f.visible-f.offset,scrollbarOffset:f.scroll.bar.offset()["x"===b?"left":"top"],scrollbarSize:f.scroll.bar["x"===b?"outerWidth":"outerHeight"]()},j=0,q=0;if(a(this).hasClass("scroll-arrow")){if(l=a(this).hasClass("scroll-arrow_more")?1:-1,n=h.scrollStep*l,p=l>0?i.maxScrollValue:0,h.isRtl)switch(!0){case c.firefox:p=l>0?0:i.maxScrollValue*-1;break;case c.msie||c.msedge:}}else l=i.eventOffset>i.scrollbarOffset+i.scrollbarSize?1:i.eventOffset<i.scrollbarOffset?-1:0,"x"===b&&h.isRtl&&(c.msie||c.msedge)&&(l*=-1),n=Math.round(.75*f.visible)*l,p=i.eventOffset-i.scrollbarOffset-(h.stepScrolling?1==l?i.scrollbarSize:0:Math.round(i.scrollbarSize/2)),p=e[m]()+p/f.kx;return d.scrollTo=d.scrollTo||{},d.scrollTo[m]=h.stepScrolling?e[m]()+n:p,h.stepScrolling&&(k=function(){p=e[m](),clearInterval(q),clearTimeout(j),j=0,q=0},j=setTimeout(function(){q=setInterval(o,40)},h.duration+100)),setTimeout(function(){d.scrollTo&&(e.animate(d.scrollTo,h.duration),d.scrollTo=null)},1),d._handleMouseDown(k,g)}),f.scroll.bar.on("mousedown"+g,function(i){if(1!=i.which)return!0;var j=i["x"===b?"pageX":"pageY"],k=e[m]();return f.scroll.addClass("scroll-draggable"),a(document).on("mousemove"+g,function(a){var d=parseInt((a["x"===b?"pageX":"pageY"]-j)/f.kx,10);"x"===b&&h.isRtl&&(c.msie||c.msedge)&&(d*=-1),e[m](k+d)}),d._handleMouseDown(function(){f.scroll.removeClass("scroll-draggable"),p=e[m]()},i)}))}),a.each(i,function(a,b){var c="scroll-scroll"+a+"_visible",d="x"==a?i.y:i.x;b.scroll.removeClass(c),d.scroll.removeClass(c),f.removeClass(c)}),a.each(i,function(b,c){a.extend(c,"x"==b?{offset:parseInt(e.css("left"),10)||0,size:e.prop("scrollWidth"),visible:k.width()}:{offset:parseInt(e.css("top"),10)||0,size:e.prop("scrollHeight"),visible:k.height()})}),this._updateScroll("x",this.scrollx),this._updateScroll("y",this.scrolly),a.isFunction(h.onUpdate)&&h.onUpdate.apply(this,[e]),a.each(i,function(a,b){var c="x"===a?"left":"top",d="x"===a?"outerWidth":"outerHeight",f="x"===a?"width":"height",g=parseInt(e.css(c),10)||0,i=b.size,j=b.visible+g,k=b.scroll.size[d]()+(parseInt(b.scroll.size.css(c),10)||0);h.autoScrollSize&&(b.scrollbarSize=parseInt(k*j/i,10),b.scroll.bar.css(f,b.scrollbarSize+"px")),b.scrollbarSize=b.scroll.bar[d](),b.kx=(k-b.scrollbarSize)/(i-j)||1,b.maxScrollOffset=i-j}),e.scrollLeft(m.scrollLeft).scrollTop(m.scrollTop).trigger("scroll")},_getScroll:function(b){var c={advanced:['<div class="scroll-element">','<div class="scroll-element_corner"></div>','<div class="scroll-arrow scroll-arrow_less"></div>','<div class="scroll-arrow scroll-arrow_more"></div>','<div class="scroll-element_outer">','<div class="scroll-element_size"></div>','<div class="scroll-element_inner-wrapper">','<div class="scroll-element_inner scroll-element_track">','<div class="scroll-element_inner-bottom"></div>',"</div>","</div>",'<div class="scroll-bar">','<div class="scroll-bar_body">','<div class="scroll-bar_body-inner"></div>',"</div>",'<div class="scroll-bar_bottom"></div>','<div class="scroll-bar_center"></div>',"</div>","</div>","</div>"].join(""),simple:['<div class="scroll-element">','<div class="scroll-element_outer">','<div class="scroll-element_size"></div>','<div class="scroll-element_track"></div>','<div class="scroll-bar"></div>',"</div>","</div>"].join("")};return c[b]&&(b=c[b]),b||(b=c.simple),b="string"==typeof b?a(b).appendTo(this.wrapper):a(b),a.extend(b,{bar:b.find(".scroll-bar"),size:b.find(".scroll-element_size"),track:b.find(".scroll-element_track")}),b},_handleMouseDown:function(b,c){var d=this.namespace;return a(document).on("blur"+d,function(){a(document).add("body").off(d),b&&b()}),a(document).on("dragstart"+d,function(a){return a.preventDefault(),!1}),a(document).on("mouseup"+d,function(){a(document).add("body").off(d),b&&b()}),a("body").on("selectstart"+d,function(a){return a.preventDefault(),!1}),c&&c.preventDefault(),!1},_updateScroll:function(b,d){var e=this.container,f=this.containerWrapper||e,g="scroll-scroll"+b+"_visible",h="x"===b?this.scrolly:this.scrollx,i=parseInt(this.container.css("x"===b?"left":"top"),10)||0,j=this.wrapper,k=d.size,l=d.visible+i;d.isVisible=k-l>1,d.isVisible?(d.scroll.addClass(g),h.scroll.addClass(g),f.addClass(g)):(d.scroll.removeClass(g),h.scroll.removeClass(g),f.removeClass(g)),"y"===b&&(e.is("textarea")||k<l?f.css({height:l+c.scroll.height+"px","max-height":"none"}):f.css({"max-height":l+c.scroll.height+"px"})),d.size==e.prop("scrollWidth")&&h.size==e.prop("scrollHeight")&&d.visible==j.width()&&h.visible==j.height()&&d.offset==(parseInt(e.css("left"),10)||0)&&h.offset==(parseInt(e.css("top"),10)||0)||(a.extend(this.scrollx,{offset:parseInt(e.css("left"),10)||0,size:e.prop("scrollWidth"),visible:j.width()}),a.extend(this.scrolly,{offset:parseInt(e.css("top"),10)||0,size:this.container.prop("scrollHeight"),visible:j.height()}),this._updateScroll("x"===b?"y":"x",h))}};var f=e;a.fn.scrollbar=function(b,d){return"string"!=typeof b&&(d=b,b="init"),"undefined"==typeof d&&(d=[]),a.isArray(d)||(d=[d]),this.not("body, .scroll-wrapper").each(function(){var e=a(this),g=e.data(c.data.name);(g||"init"===b)&&(g||(g=new f(e)),g[b]&&g[b].apply(g,d))}),this},a.fn.scrollbar.options=d;var g=function(){var a=0,d=0;return function(e){var f,h,i,j,k,l,m;for(f=0;f<c.scrolls.length;f++)j=c.scrolls[f],h=j.container,i=j.options,k=j.wrapper,l=j.scrollx,m=j.scrolly,(e||i.autoUpdate&&k&&k.is(":visible")&&(h.prop("scrollWidth")!=l.size||h.prop("scrollHeight")!=m.size||k.width()!=l.visible||k.height()!=m.visible))&&(j.init(),i.debug&&(window.console&&console.log({scrollHeight:h.prop("scrollHeight")+":"+j.scrolly.size,scrollWidth:h.prop("scrollWidth")+":"+j.scrollx.size,visibleHeight:k.height()+":"+j.scrolly.visible,visibleWidth:k.width()+":"+j.scrollx.visible},!0),d++));b&&d>10?(window.console&&console.log("Scroll updates exceed 10"),g=function(){}):(clearTimeout(a),a=setTimeout(g,300))}}();window.angular&&!function(a){a.module("jQueryScrollbar",[]).provider("jQueryScrollbar",function(){var b=d;return{setOptions:function(c){a.extend(b,c)},$get:function(){return{options:a.copy(b)}}}}).directive("jqueryScrollbar",["jQueryScrollbar","$parse",function(a,b){return{restrict:"AC",link:function(c,d,e){var f=b(e.jqueryScrollbar),g=f(c);d.scrollbar(g||a.options).on("$destroy",function(){d.scrollbar("destroy")})}}}])}(window.angular)});
\ No newline at end of file

From 5921a7d83fbf9a452478b93639d1e844b3191fe0 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Mon, 14 Jul 2025 19:54:45 -0700
Subject: [PATCH 738/743] Fix rounding of minutes in global stats play duration

---
 data/interfaces/default/js/script.js | 19 +++----------------
 1 file changed, 3 insertions(+), 16 deletions(-)

diff --git a/data/interfaces/default/js/script.js b/data/interfaces/default/js/script.js
index 5d75c69d..9f2a92eb 100644
--- a/data/interfaces/default/js/script.js
+++ b/data/interfaces/default/js/script.js
@@ -288,23 +288,10 @@ function isPrivateIP(ip_address) {
 }
 
 function humanTime(seconds) {
-    var d = Math.floor(moment.duration(seconds, 'seconds').asDays());
-    var h = Math.floor(moment.duration((seconds % 86400), 'seconds').asHours());
-    var m = Math.round(moment.duration(((seconds % 86400) % 3600), 'seconds').asMinutes());
-
-    var text = '';
-    if (d > 0) {
-        text = '<h3>' + d + '</h3><p> day' + ((d > 1) ? 's' : '') + '</p>'
-             + '<h3>' + h + '</h3><p> hr' + ((h > 1) ? 's' : '') + '</p>'
-             + '<h3>' + m + '</h3><p> min' + ((m > 1) ? 's' : '') + '</p>';
-    } else if (h > 0) {
-        text = '<h3>' + h + '</h3><p> hr' + ((h > 1) ? 's' : '') + '</p>'
-             + '<h3>' + m + '</h3><p> min' + ((m > 1) ? 's' : '') + '</p>';
-    } else {
-        text = '<h3>' + m + '</h3><p> min' + ((m > 1) ? 's' : '') + '</p>';
+    if (seconds > 0) {
+        return humanDuration(seconds * 1000).replaceAll(/(\d+) (\w+)/g, '<h3>$1</h3><p>$2</p>')
     }
-
-    return text
+    return "<h3>0</h3><p>mins</p>";
 }
 
 String.prototype.toProperCase = function () {

From d46710962cebc05e257c41454ac8e15d9933828a Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 3 Aug 2025 09:35:06 -0700
Subject: [PATCH 739/743] Add ability to return svg files using pms_image_proxy

---
 plexpy/api2.py     | 1 -
 plexpy/webserve.py | 7 ++++++-
 2 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/plexpy/api2.py b/plexpy/api2.py
index 9cc36b49..b4328f96 100644
--- a/plexpy/api2.py
+++ b/plexpy/api2.py
@@ -675,7 +675,6 @@ General optional parameters:
 
         elif self._api_cmd == 'pms_image_proxy':
             if 'return_hash' not in self._api_kwargs:
-                cherrypy.response.headers['Content-Type'] = 'image/jpeg'
                 return out['response']['data']
 
         elif self._api_cmd == 'get_geoip_lookup':
diff --git a/plexpy/webserve.py b/plexpy/webserve.py
index c402092f..4aa3bd67 100644
--- a/plexpy/webserve.py
+++ b/plexpy/webserve.py
@@ -4753,7 +4753,12 @@ class WebInterface(object):
 
         if isinstance(img, str) and img.startswith('interfaces/default/images'):
             fp = os.path.join(plexpy.PROG_DIR, 'data', img)
-            return serve_file(path=fp, content_type='image/png')
+            ext = img.rsplit(".", 1)[-1]
+            if ext == 'svg':
+                content_type = 'image/svg+xml'
+            else:
+                content_type = 'image/{}'.format(ext)
+            return serve_file(path=fp, content_type=content_type)
 
         if not img and not rating_key:
             if fallback in common.DEFAULT_IMAGES:

From b8589513c18564f11f014704a1b939f149b4511e Mon Sep 17 00:00:00 2001
From: Tom Niget <zippedfire@free.fr>
Date: Sun, 3 Aug 2025 18:42:44 +0200
Subject: [PATCH 740/743] Remove duplicate "Total" entry in graph tooltips
 (#2534)

---
 data/interfaces/default/graphs.html | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/data/interfaces/default/graphs.html b/data/interfaces/default/graphs.html
index 006d7ee9..7201c35f 100644
--- a/data/interfaces/default/graphs.html
+++ b/data/interfaces/default/graphs.html
@@ -760,6 +760,7 @@
                     if (this.points.length > 1) {
                         var total = 0;
                         $.each(this.points, function(i, point) {
+                            if (point.series.name === 'Total') return;
                             s += '<br/>'+point.series.name+': '+point.y;
                             total += point.y;
                         });
@@ -786,6 +787,7 @@
                     if (this.points.length > 1) {
                         var total = 0;
                         $.each(this.points, function(i, point) {
+                            if (point.series.name === 'Total') return;
                             s += '<br/>'+point.series.name+': '+moment.duration(point.y, 'hours').format('D [days] H [hrs] m [mins]');
                             total += point.y;
                         });

From 5ecd570f95552e4e2c0c7b18ef8e12f26dc021ef Mon Sep 17 00:00:00 2001
From: Komu Wairagu <komuw05@gmail.com>
Date: Sun, 3 Aug 2025 19:42:58 +0300
Subject: [PATCH 741/743] Allow users to set config values through environment
 variables. (#2543)

* - Allow users to set config values through environment variables.
- Fixes: https://github.com/Tautulli/Tautulli/issues/2309

* Prefix environment variables with `TAUTULLI_`
For: https://github.com/Tautulli/Tautulli/issues/2309

* Update handling Tautulli environment variables

* Add log message when environment variable not saved to config

---------

Co-authored-by: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
---
 plexpy/config.py | 57 ++++++++++++++++++++++++++++++++++--------------
 1 file changed, 41 insertions(+), 16 deletions(-)

diff --git a/plexpy/config.py b/plexpy/config.py
index 3e9862ff..2c4fa8b4 100644
--- a/plexpy/config.py
+++ b/plexpy/config.py
@@ -479,20 +479,48 @@ class Config(object):
         """ Check if INI section exists, if not create it """
         if section not in self._config:
             self._config[section] = {}
-            return True
-        else:
-            return False
 
-    def check_setting(self, key):
-        """ Cast any value in the config to the right type or use the default """
-        key, definition_type, section, ini_key, default = self._define(key)
+    def check_setting(self, name):
+        """ Check if INI key exists, if not create it """
+        key, definition_type, section, ini_key, default = self._define(name)
         self.check_section(section)
+        value = self._config[section].get(ini_key, default)
+        self._config[section][ini_key] = self._cast_setting(definition_type, value, default)
+    
+    def get_setting(self, name):
+        """ Get the value of a setting, either from the config file or environment variable """
+        key, definition_type, section, ini_key, default = self._define(name)
+        # Check if the key is in the environment variables
+        value = self._from_env(key)
+        if not value:
+            # If not, check if the key is in the config file
+            value = self._config[section].get(ini_key, default)
+        return self._cast_setting(definition_type, value, default)
+    
+    def set_setting(self, name, value):
+        """ Set the value of a setting in the config file """
+        key, definition_type, section, ini_key, default = self._define(name)
+        # Check if the key is in the environment variables
+        env_value = self._from_env(key)
+        if env_value:
+            logger.warn("Tautulli Config :: '%s' set by environment variable. Setting not saved to config.", key)
+            return
+
+        # If not, set the value in the config file
+        self._config[section][ini_key] = self._cast_setting(definition_type, value, default)
+        return self._config[section][ini_key]
+    
+    def _from_env(self, key):
+        """ Get key from environment variables, if it exists """
+        env_key = f"TAUTULLI_{key}"
+        return os.environ.get(env_key)
+    
+    def _cast_setting(self, definition_type, value, default=None):
+        """ Cast the value to the correct type, or use the default if it fails """
         try:
-            my_val = definition_type(self._config[section][ini_key])
+            return definition_type(value)
         except Exception:
-            my_val = definition_type(default)
-            self._config[section][ini_key] = my_val
-        return my_val
+            return definition_type(default)
 
     def write(self):
         """ Make a copy of the stored config and write it to the configured file """
@@ -533,7 +561,7 @@ class Config(object):
         if not re.match(r'[A-Z0-9_]+$', name):
             return super(Config, self).__getattr__(name)
         else:
-            return self.check_setting(name)
+            return self.get_setting(name)
 
     def __setattr__(self, name, value):
         """
@@ -544,9 +572,7 @@ class Config(object):
             super(Config, self).__setattr__(name, value)
             return value
         else:
-            key, definition_type, section, ini_key, default = self._define(name)
-            self._config[section][ini_key] = definition_type(value)
-            return self._config[section][ini_key]
+            return self.set_setting(name, value)
 
     def __delattr__(self, name):
         """
@@ -563,8 +589,7 @@ class Config(object):
         Given a big bunch of key value pairs, apply them to the ini.
         """
         for name, value in kwargs.items():
-            key, definition_type, section, ini_key, default = self._define(name)
-            self._config[section][ini_key] = definition_type(value)
+            self.__setattr__(name.upper(), value)
 
     def _upgrade(self):
         """

From 443eb8da155d98a314c7fd462f1e1831e996e546 Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 3 Aug 2025 10:09:49 -0700
Subject: [PATCH 742/743] Disable browser autocomplete in notification and
 newsletter configs

Fixes #2557
---
 .../interfaces/default/newsletter_config.html | 52 +++++++++----------
 data/interfaces/default/notifier_config.html  | 42 +++++++--------
 2 files changed, 47 insertions(+), 47 deletions(-)

diff --git a/data/interfaces/default/newsletter_config.html b/data/interfaces/default/newsletter_config.html
index 2e46c998..f6ae70c3 100644
--- a/data/interfaces/default/newsletter_config.html
+++ b/data/interfaces/default/newsletter_config.html
@@ -32,7 +32,7 @@
                                 <div class="col-md-12">
                                     <div class="checkbox" style="margin-bottom: 20px;">
                                         <label>
-                                            <input type="checkbox" data-id="active_value" class="checkboxes" value="1" ${checked(newsletter['active'])}> Enable the Newsletter
+                                            <input type="checkbox" data-id="active_value" class="checkboxes" value="1" autocomplete="off" ${checked(newsletter['active'])}> Enable the Newsletter
                                         </label>
                                         <input type="hidden" id="active_value" name="active" value="${newsletter['active']}">
                                     </div>
@@ -40,11 +40,11 @@
                                         <label for="custom_cron">Schedule</label>
                                         <div class="row">
                                             <div class="col-md-12">
-                                                <select class="form-control" id="custom_cron" name="newsletter_config_custom_cron">
+                                                <select class="form-control" id="custom_cron" name="newsletter_config_custom_cron" autocomplete="off">
                                                     <option value="0" ${'selected' if newsletter['config']['custom_cron'] == 0 else ''}>Simple</option>
                                                     <option value="1" ${'selected' if newsletter['config']['custom_cron'] == 1 else ''}>Custom</option>
                                                 </select>
-                                                <input type="text" id="cron_value" name="cron" value="${newsletter['cron']}" />
+                                                <input type="text" id="cron_value" name="cron" value="${newsletter['cron']}" autocomplete="off" />
                                                 <div id="cron-widget"></div>
                                             </div>
                                         </div>
@@ -62,8 +62,8 @@
                                             <div class="col-md-5">
                                                 <div class="input-group newsletter-time_frame">
                                                     <span class="input-group-addon form-control btn-dark inactive">Last</span>
-                                                    <input type="number" class="form-control" id="newsletter_config_time_frame" name="newsletter_config_time_frame" value="${newsletter['config']['time_frame']}">
-                                                    <select class="form-control" id="newsletter_config_time_frame_units" name="newsletter_config_time_frame_units">
+                                                    <input type="number" class="form-control" id="newsletter_config_time_frame" name="newsletter_config_time_frame" value="${newsletter['config']['time_frame']}" autocomplete="off">
+                                                    <select class="form-control" id="newsletter_config_time_frame_units" name="newsletter_config_time_frame_units" autocomplete="off">
                                                         <option value="months" ${'selected' if newsletter['config']['time_frame_units'] == 'months' else ''}>months</option>
                                                         <option value="days" ${'selected' if newsletter['config']['time_frame_units'] == 'days' else ''}>days</option>
                                                         <option value="hours" ${'selected' if newsletter['config']['time_frame_units'] == 'hours' else ''}>hours</option>
@@ -88,7 +88,7 @@
                                         <label for="${item['name']}">${item['label']}</label>
                                         <div class="row">
                                             <div class="col-md-12">
-                                                <input type="${item['input_type']}" class="form-control" id="${item['name']}" name="${item['name']}" value="${item['value']}" size="30" ${'readonly' if item.get('readonly') else ''}>
+                                                <input type="${item['input_type']}" class="form-control" id="${item['name']}" name="${item['name']}" value="${item['value']}" size="30" autocomplete="off" ${'readonly' if item.get('readonly') else ''}>
                                             </div>
                                         </div>
                                         <p class="help-block">${item['description'] | n}</p>
@@ -98,7 +98,7 @@
                                         <label for="${item['name']}">${item['label']}</label>
                                         <div class="row">
                                             <div class="col-md-3">
-                                                <input type="${item['input_type']}" class="form-control" id="${item['name']}" name="${item['name']}" value="${item['value']}" size="30">
+                                                <input type="${item['input_type']}" class="form-control" id="${item['name']}" name="${item['name']}" value="${item['value']}" size="30" autocomplete="off">
                                             </div>
                                         </div>
                                         <p class="help-block">${item['description'] | n}</p>
@@ -116,7 +116,7 @@
                                     % elif item['input_type'] == 'checkbox':
                                     <div class="checkbox">
                                         <label>
-                                            <input type="checkbox" data-id="${item['name']}" class="checkboxes" value="1" ${checked(item['value'])}> ${item['label']}
+                                            <input type="checkbox" data-id="${item['name']}" class="checkboxes" value="1" autocomplete="off" ${checked(item['value'])}> ${item['label']}
                                         </label>
                                         <p class="help-block">${item['description'] | n}</p>
                                         <input type="hidden" id="${item['name']}" name="${item['name']}" value="${item['value']}">
@@ -126,7 +126,7 @@
                                         <label for="${item['name']}">${item['label']}</label>
                                         <div class="row">
                                             <div class="col-md-12">
-                                                <select class="form-control" id="${item['name']}" name="${item['name']}">
+                                                <select class="form-control" id="${item['name']}" name="${item['name']}" autocomplete="off">
                                                     % for key, value in sorted(item['select_options'].items()):
                                                     % if key == item['value']:
                                                     <option value="${key}" selected>${value}</option>
@@ -144,7 +144,7 @@
                                         <label for="${item['name']}">${item['label']}</label>
                                         <div class="row">
                                             <div class="col-md-12">
-                                                <select class="form-control" id="${item['name']}" name="${item['name']}">
+                                                <select class="form-control" id="${item['name']}" name="${item['name']}" autocomplete="off">
                                                     % if item['select_all']:
                                                     <option value="select-all">Select All</option>
                                                     <option value="remove-all">Remove All</option>
@@ -178,7 +178,7 @@
                                         <label for="id_name">Unique ID Name</label>
                                         <div class="row">
                                             <div class="col-md-12">
-                                                <input type="text" class="form-control" id="id_name" name="id_name" value="${newsletter['id_name']}" size="30">
+                                                <input type="text" class="form-control" id="id_name" name="id_name" value="${newsletter['id_name']}" size="30" autocomplete="off">
                                             </div>
                                         </div>
                                         <p class="help-block">
@@ -191,7 +191,7 @@
                                         <label for="friendly_name">Description</label>
                                         <div class="row">
                                             <div class="col-md-12">
-                                                <input type="text" class="form-control" id="friendly_name" name="friendly_name" value="${newsletter['friendly_name']}" size="30">
+                                                <input type="text" class="form-control" id="friendly_name" name="friendly_name" value="${newsletter['friendly_name']}" size="30" autocomplete="off">
                                             </div>
                                         </div>
                                         <p class="help-block">Optional: Enter a description to help identify this newsletter in the newsletters list.</p>
@@ -205,7 +205,7 @@
                                     <label>Saving</label>
                                     <div class="checkbox">
                                         <label>
-                                            <input type="checkbox" id="newsletter_config_save_only_checkbox" data-id="newsletter_config_save_only" class="checkboxes" value="1" ${checked(newsletter['config']['save_only'])}> Save HTML File Only
+                                            <input type="checkbox" id="newsletter_config_save_only_checkbox" data-id="newsletter_config_save_only" class="checkboxes" value="1" autocomplete="off" ${checked(newsletter['config']['save_only'])}> Save HTML File Only
                                         </label>
                                         <p class="help-block">Enable to save the newsletter HTML file without sending it to any notification agent.</p>
                                         <input type="hidden" id="newsletter_config_save_only" name="newsletter_config_save_only" value="${newsletter['config']['save_only']}">
@@ -214,7 +214,7 @@
                                         <label for="newsletter_config_filename">HTML File Name</label>
                                         <div class="row">
                                             <div class="col-md-12">
-                                                <input type="text" class="form-control" id="newsletter_config_filename" name="newsletter_config_filename" value="${newsletter['config']['filename']}" size="30">
+                                                <input type="text" class="form-control" id="newsletter_config_filename" name="newsletter_config_filename" value="${newsletter['config']['filename']}" size="30" autocomplete="off">
                                             </div>
                                         </div>
                                         <p class="help-block">Optional: Enter the file name to use when saving the newsletter (ending with <span class="inline-pre">.html</span>). You may use any of the <a href="#newsletter-text-sub-modal" data-toggle="modal">newsletter text parameters</a>. Leave blank for default.</p>
@@ -224,7 +224,7 @@
                                     <label>Sending</label>
                                     <div class="checkbox">
                                         <label>
-                                            <input type="checkbox" id="newsletter_config_formatted_checkbox" data-id="newsletter_config_formatted" class="checkboxes" value="1" ${checked(newsletter['config']['formatted'])}> Send Newsletter as an HTML Formatted Email
+                                            <input type="checkbox" id="newsletter_config_formatted_checkbox" data-id="newsletter_config_formatted" class="checkboxes" value="1" autocomplete="off" ${checked(newsletter['config']['formatted'])}> Send Newsletter as an HTML Formatted Email
                                         </label>
                                         <p class="help-block">Enable to send the newsletter as an HTML formatted Email. Disable to only send a subject and body message to a different notification agent.</p>
                                         <input type="hidden" id="newsletter_config_formatted" name="newsletter_config_formatted" value="${newsletter['config']['formatted']}">
@@ -232,7 +232,7 @@
                                     <div class="form-group" id="email_notifier_select">
                                         <div class="checkbox">
                                             <label>
-                                                <input type="checkbox" id="newsletter_config_threaded_checkbox" data-id="newsletter_config_threaded" class="checkboxes" value="1" ${checked(newsletter['config']['threaded'])}> Enable Grouped Email Thread
+                                                <input type="checkbox" id="newsletter_config_threaded_checkbox" data-id="newsletter_config_threaded" class="checkboxes" value="1" autocomplete="off" ${checked(newsletter['config']['threaded'])}> Enable Grouped Email Thread
                                             </label>
                                             <p class="help-block">Enable to group this newsletter together in a single Email thread. Disable to send a new Email for each newsletter.</p>
                                             <input type="hidden" id="newsletter_config_threaded" name="newsletter_config_threaded" value="${newsletter['config']['threaded']}">
@@ -240,7 +240,7 @@
                                         <label for="newsletter_email_notifier_id">Email Notification Agent</label>
                                         <div class="row">
                                             <div class="col-md-12">
-                                                <select class="form-control" id="newsletter_email_notifier_id" name="newsletter_email_notifier_id">
+                                                <select class="form-control" id="newsletter_email_notifier_id" name="newsletter_email_notifier_id" autocomplete="off">
                                                     % for notifier in email_notifiers:
                                                     <% selected = 'selected' if notifier['id'] == newsletter['email_config']['notifier_id'] else '' %>
                                                     % if notifier['friendly_name']:
@@ -263,7 +263,7 @@
                                         <label for="newsletter_config_notifier_id">Notification Agent</label>
                                         <div class="row">
                                             <div class="col-md-12">
-                                                <select class="form-control" id="newsletter_config_notifier_id" name="newsletter_config_notifier_id">
+                                                <select class="form-control" id="newsletter_config_notifier_id" name="newsletter_config_notifier_id" autocomplete="off">
                                                     % for notifier in other_notifiers:
                                                     <% selected = 'selected' if notifier['id'] == newsletter['config']['notifier_id'] else '' %>
                                                     % if notifier['friendly_name']:
@@ -294,7 +294,7 @@
                                             <label for="${item['name']}">${item['label']}</label>
                                             <div class="row">
                                                 <div class="col-md-12">
-                                                    <input type="${item['input_type']}" class="form-control" id="${item['name']}" name="${item['name']}" value="${item['value']}" size="30" ${'readonly' if item.get('readonly') else ''}>
+                                                    <input type="${item['input_type']}" class="form-control" id="${item['name']}" name="${item['name']}" value="${item['value']}" size="30" autocomplete="off" ${'readonly' if item.get('readonly') else ''}>
                                                 </div>
                                             </div>
                                             <p class="help-block">${item['description'] | n}</p>
@@ -304,7 +304,7 @@
                                             <label for="${item['name']}">${item['label']}</label>
                                             <div class="row">
                                                 <div class="col-md-3">
-                                                    <input type="${item['input_type']}" class="form-control" id="${item['name']}" name="${item['name']}" value="${item['value']}" size="30">
+                                                    <input type="${item['input_type']}" class="form-control" id="${item['name']}" name="${item['name']}" value="${item['value']}" size="30" autocomplete="off">
                                                 </div>
                                             </div>
                                             <p class="help-block">${item['description'] | n}</p>
@@ -322,7 +322,7 @@
                                         % elif item['input_type'] == 'checkbox' and item['name'] != 'newsletter_email_html_support':
                                         <div class="checkbox">
                                             <label>
-                                                <input type="checkbox" data-id="${item['name']}" class="checkboxes" value="1" ${checked(item['value'])}> ${item['label']}
+                                                <input type="checkbox" data-id="${item['name']}" class="checkboxes" value="1" autocomplete="off" ${checked(item['value'])}> ${item['label']}
                                             </label>
                                             <p class="help-block">${item['description'] | n}</p>
                                             <input type="hidden" id="${item['name']}" name="${item['name']}" value="${item['value']}">
@@ -332,7 +332,7 @@
                                             <label for="${item['name']}">${item['label']}</label>
                                             <div class="row">
                                                 <div class="col-md-12">
-                                                    <select class="form-control" id="${item['name']}" name="${item['name']}">
+                                                    <select class="form-control" id="${item['name']}" name="${item['name']}" autocomplete="off">
                                                         % for key, value in sorted(item['select_options'].items()):
                                                         % if isinstance(value, list):
                                                         <optgroup label="${key}">
@@ -354,7 +354,7 @@
                                             <label for="${item['name']}">${item['label']}</label>
                                             <div class="row">
                                                 <div class="col-md-12">
-                                                    <select class="form-control" id="${item['name']}" name="${item['name']}">
+                                                    <select class="form-control" id="${item['name']}" name="${item['name']}" autocomplete="off">
                                                         <option value="select-all">Select All</option>
                                                         <option value="remove-all">Remove All</option>
                                                         % if isinstance(item['select_options'], dict):
@@ -399,7 +399,7 @@
                                         <label for="subject">Subject</label>
                                         <div class="row">
                                             <div class="col-md-12">
-                                                <input type="text" class="form-control" id="subject" name="subject" value="${newsletter['subject']}" size="30">
+                                                <input type="text" class="form-control" id="subject" name="subject" value="${newsletter['subject']}" size="30" autocomplete="off">
                                             </div>
                                         </div>
                                         <p class="help-block">
@@ -410,7 +410,7 @@
                                         <label for="body">Body</label>
                                         <div class="row">
                                             <div class="col-md-12">
-                                                <textarea class="form-control"  id="body" name="body" data-autoresize>${newsletter['body']}</textarea>
+                                                <textarea class="form-control"  id="body" name="body" autocomplete="off" data-autoresize>${newsletter['body']}</textarea>
                                             </div>
                                         </div>
                                         <p class="help-block">
@@ -421,7 +421,7 @@
                                         <label for="message">Message</label>
                                         <div class="row">
                                             <div class="col-md-12">
-                                                <textarea class="form-control"  id="message" name="message" data-autoresize>${newsletter['message']}</textarea>
+                                                <textarea class="form-control"  id="message" name="message" autocomplete="off" data-autoresize>${newsletter['message']}</textarea>
                                             </div>
                                         </div>
                                         <p class="help-block">
diff --git a/data/interfaces/default/notifier_config.html b/data/interfaces/default/notifier_config.html
index ff7e1d03..febace9a 100644
--- a/data/interfaces/default/notifier_config.html
+++ b/data/interfaces/default/notifier_config.html
@@ -51,13 +51,13 @@
                                             <div class="col-md-12">
                                                 % if notifier['agent_name'] == 'scripts' and item['name'] == 'scripts_script_folder':
                                                 <div class="input-group">
-                                                    <input type="${item['input_type']}" class="form-control" id="${item['name']}" name="${item['name']}" value="${item['value']}" size="30" ${'readonly' if item.get('readonly') else ''}>
+                                                    <input type="${item['input_type']}" class="form-control" id="${item['name']}" name="${item['name']}" value="${item['value']}" size="30" autocomplete="off" ${'readonly' if item.get('readonly') else ''}>
                                                     <span class="input-group-btn">
                                                         <button class="btn btn-form" type="button" id="${item['name']}_browse" data-toggle="browse" data-filter=".folderonly" data-target="#${item['name']}">Browse</button>
                                                     </span>
                                                 </div>
                                                 % else:
-                                                <input type="${item['input_type']}" class="form-control" id="${item['name']}" name="${item['name']}" value="${item['value']}" size="30" ${'readonly' if item.get('readonly') else ''}>
+                                                <input type="${item['input_type']}" class="form-control" id="${item['name']}" name="${item['name']}" value="${item['value']}" size="30" autocomplete="off" ${'readonly' if item.get('readonly') else ''}>
                                                 % endif
                                             </div>
                                         </div>
@@ -72,7 +72,7 @@
                                                     <span class="input-group-btn">
                                                         <button class="btn btn-form reveal-token" type="button"><i class="fa fa-eye-slash"></i></button>
                                                     </span>
-                                                    <input type="password" class="form-control" id="${item['name']}" name="${item['name']}" value="${item['value']}" size="30" ${'readonly' if item.get('readonly') else ''}>
+                                                    <input type="password" class="form-control" id="${item['name']}" name="${item['name']}" value="${item['value']}" size="30" autocomplete="off" ${'readonly' if item.get('readonly') else ''}>
                                                 </div>
                                             </div>
                                         </div>
@@ -83,7 +83,7 @@
                                         <label for="${item['name']}">${item['label']}</label>
                                         <div class="row">
                                             <div class="col-md-3">
-                                                <input type="${item['input_type']}" class="form-control" id="${item['name']}" name="${item['name']}" value="${item['value']}" size="30">
+                                                <input type="${item['input_type']}" class="form-control" id="${item['name']}" name="${item['name']}" value="${item['value']}" size="30" autocomplete="off">
                                             </div>
                                         </div>
                                         <p class="help-block">${item['description'] | n}</p>
@@ -101,7 +101,7 @@
                                     % elif item['input_type'] == 'checkbox':
                                     <div class="checkbox">
                                         <label>
-                                            <input type="checkbox" data-id="${item['name']}" class="checkboxes" value="1" ${checked(item['value'])}> ${item['label']}
+                                            <input type="checkbox" data-id="${item['name']}" class="checkboxes" value="1" autocomplete="off" ${checked(item['value'])}> ${item['label']}
                                         </label>
                                         <p class="help-block">${item['description'] | n}</p>
                                         <input type="hidden" id="${item['name']}" name="${item['name']}" value="${item['value']}">
@@ -111,7 +111,7 @@
                                         <label for="${item['name']}">${item['label']}</label>
                                         <div class="row">
                                             <div class="col-md-12">
-                                                <select class="form-control" id="${item['name']}" name="${item['name']}">
+                                                <select class="form-control" id="${item['name']}" name="${item['name']}" autocomplete="off">
                                                     % for key, value in sorted(item['select_options'].items()):
                                                     % if isinstance(value, list):
                                                     <optgroup label="${key}">
@@ -133,7 +133,7 @@
                                         <label for="${item['name']}">${item['label']}</label>
                                         <div class="row">
                                             <div class="col-md-12">
-                                                <select class="form-control" id="${item['name']}" name="${item['name']}">
+                                                <select class="form-control" id="${item['name']}" name="${item['name']}" autocomplete="off">
                                                     % if item['select_all']:
                                                     <option value="select-all">Select All</option>
                                                     <option value="remove-all">Remove All</option>
@@ -167,7 +167,7 @@
                                         <label for="friendly_name">Description</label>
                                         <div class="row">
                                             <div class="col-md-12">
-                                                <input type="text" class="form-control" id="friendly_name" name="friendly_name" value="${notifier['friendly_name']}" size="30">
+                                                <input type="text" class="form-control" id="friendly_name" name="friendly_name" value="${notifier['friendly_name']}" size="30" autocomplete="off">
                                             </div>
                                         </div>
                                         <p class="help-block">Optional: Enter a description to help identify this agent in the notification agents list.</p>
@@ -185,7 +185,7 @@
                                     % for action in available_notification_actions:
                                     <div class="checkbox">
                                         <label>
-                                            <input type="checkbox" data-id="${action['name']}" class="checkboxes" value="1" ${checked(notifier['actions'][action['name']])}> ${action['label']}
+                                            <input type="checkbox" data-id="${action['name']}" class="checkboxes" value="1" autocomplete="off" ${checked(notifier['actions'][action['name']])}> ${action['label']}
                                         </label>
                                         <p class="help-block">${action['description'] | n}</p>
                                         <input type="hidden" id="${action['name']}" name="${action['name']}" value="${notifier['actions'][action['name']]}">
@@ -208,7 +208,7 @@
 
                             <div class="form-group">
                                 <label for="custom_conditions_logic">Condition Logic</label>
-                                <input type="text" class="form-control" name="custom_conditions_logic" id="custom_conditions_logic" value="${notifier['custom_conditions_logic']}" />
+                                <input type="text" class="form-control" name="custom_conditions_logic" id="custom_conditions_logic" value="${notifier['custom_conditions_logic']}" autocomplete="off" />
                                 <div id="custom_conditions_logic_error" class="alert alert-danger" role="alert" style="padding-top: 5px; padding-bottom: 5px; margin: 0; display: none;"><i class="fa fa-exclamation-triangle" style="color: #a94442;"></i> <span></span></div>
                                 <p class="help-block">
                                     Optional: Enter custom logic to use when evaluating the conditions (e.g. <span class="inline-pre">{1} and ({2} or {3})</span>).
@@ -254,7 +254,7 @@
                                         <li>
                                             <div class="form-group">
                                                 <label for="${action['name']}_subject">Script Arguments</label>
-                                                <input class="form-control" type="text" id="${action['name']}_subject" name="${action['name']}_subject" value="${notifier['notify_text'][action['name']]['subject']}" data-parsley-trigger="change" required>
+                                                <input class="form-control" type="text" id="${action['name']}_subject" name="${action['name']}_subject" value="${notifier['notify_text'][action['name']]['subject']}" autocomplete="off" data-parsley-trigger="change" required>
                                                 <p class="help-block">Set custom arguments passed to the script.</p>
                                             </div>
                                             <div class="form-group">
@@ -280,12 +280,12 @@
                                         <li>
                                             <div class="form-group">
                                                 <label for="${action['name']}_subject">JSON Headers</label>
-                                                <textarea class="form-control" id="${action['name']}_subject" name="${action['name']}_subject" data-parsley-trigger="change" data-autoresize required>${notifier['notify_text'][action['name']]['subject']}</textarea>
+                                                <textarea class="form-control" id="${action['name']}_subject" name="${action['name']}_subject" data-parsley-trigger="change" autocomplete="off" data-autoresize required>${notifier['notify_text'][action['name']]['subject']}</textarea>
                                                 <p class="help-block">Set custom JSON headers.</p>
                                             </div>
                                             <div class="form-group">
                                                 <label for="${action['name']}_body">JSON Data</label>
-                                                <textarea class="form-control" id="${action['name']}_body" name="${action['name']}_body" data-parsley-trigger="change" data-autoresize required>${notifier['notify_text'][action['name']]['body']}</textarea>
+                                                <textarea class="form-control" id="${action['name']}_body" name="${action['name']}_body" data-parsley-trigger="change" autocomplete="off" data-autoresize required>${notifier['notify_text'][action['name']]['body']}</textarea>
                                                 <p class="help-block">Set custom JSON data.</p>
                                             </div>
                                             <div class="form-group">
@@ -311,12 +311,12 @@
                                         <li>
                                             <div class="form-group">
                                                 <label for="${action['name']}_subject">Subject Line</label>
-                                                <input class="form-control" type="text" id="${action['name']}_subject" name="${action['name']}_subject" value="${notifier['notify_text'][action['name']]['subject']}" data-parsley-trigger="change" required>
+                                                <input class="form-control" type="text" id="${action['name']}_subject" name="${action['name']}_subject" value="${notifier['notify_text'][action['name']]['subject']}" autocomplete="off" data-parsley-trigger="change" required>
                                                 <p class="help-block">Set a custom subject line.</p>
                                             </div>
                                             <div class="form-group">
                                                 <label for="${action['name']}_body">Message Body</label>
-                                                <textarea class="form-control" id="${action['name']}_body" name="${action['name']}_body" data-parsley-trigger="change" data-autoresize required>${notifier['notify_text'][action['name']]['body']}</textarea>
+                                                <textarea class="form-control" id="${action['name']}_body" name="${action['name']}_body" data-parsley-trigger="change" autocomplete="off" data-autoresize required>${notifier['notify_text'][action['name']]['body']}</textarea>
                                                 <p class="help-block">Set a custom body.</p>
                                             </div>
                                             <div class="form-group">
@@ -347,7 +347,7 @@
                                 <label for="test_script">Script</label>
                                 <div class="row">
                                     <div class="col-md-12">
-                                        <select class="form-control" id="test_script" name="test_script">
+                                        <select class="form-control" id="test_script" name="test_script" autocomplete="off">
                                             % for key, value in sorted(notifier['config_options'][2]['select_options'].items()):
                                             <option value="${key}">${value}</option>
                                             % endfor
@@ -360,7 +360,7 @@
                                 <label for="test_script_args">Script Arguments</label>
                                 <div class="row">
                                     <div class="col-md-12">
-                                        <input class="form-control" type="text" id="test_script_args" name="test_script_args" value="">
+                                        <input class="form-control" type="text" id="test_script_args" name="test_script_args" value="" autocomplete="off">
                                     </div>
                                 </div>
                                 <p class="help-block">Set custom arguments passed to the script.</p>
@@ -370,7 +370,7 @@
                                 <label for="test_subject">JSON Headers</label>
                                 <div class="row">
                                     <div class="col-md-12">
-                                        <textarea class="form-control" id="test_subject" name="test_subject" data-autoresize></textarea>
+                                        <textarea class="form-control" id="test_subject" name="test_subject" autocomplete="off" data-autoresize></textarea>
                                     </div>
                                 </div>
                                 <p class="help-block">Set custom JSON headers sent to the webhook.</p>
@@ -379,7 +379,7 @@
                                 <label for="test_body">JSON Data</label>
                                 <div class="row">
                                     <div class="col-md-12">
-                                        <textarea class="form-control" id="test_body" name="test_body" data-autoresize></textarea>
+                                        <textarea class="form-control" id="test_body" name="test_body" autocomplete="off" data-autoresize></textarea>
                                     </div>
                                 </div>
                                 <p class="help-block">Set custom JSON data sent to the webhook.</p>
@@ -389,7 +389,7 @@
                                 <label for="test_subject">Subject Line</label>
                                 <div class="row">
                                     <div class="col-md-12">
-                                        <input class="form-control" type="text" id="test_subject" name="test_subject" value="Tautulli">
+                                        <input class="form-control" type="text" id="test_subject" name="test_subject" value="Tautulli" autocomplete="off">
                                     </div>
                                 </div>
                                 <p class="help-block">Set a custom subject line.</p>
@@ -398,7 +398,7 @@
                                 <label for="test_body">Message Body</label>
                                 <div class="row">
                                     <div class="col-md-12">
-                                        <textarea class="form-control" id="test_body" name="test_body" data-autoresize>Test Notification</textarea>
+                                        <textarea class="form-control" id="test_body" name="test_body" autocomplete="off" data-autoresize>Test Notification</textarea>
                                     </div>
                                 </div>
                                 <p class="help-block">Set a custom body.</p>

From 1144bba580fff1fbb220e104b9e66be78482842b Mon Sep 17 00:00:00 2001
From: JonnyWong16 <9099342+JonnyWong16@users.noreply.github.com>
Date: Sun, 3 Aug 2025 10:17:15 -0700
Subject: [PATCH 743/743] v2.15.3

---
 CHANGELOG.md      | 17 +++++++++++++++++
 plexpy/version.py |  2 +-
 2 files changed, 18 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 0cfe9f2c..b349b355 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,22 @@
 # Changelog
 
+## v2.15.3 (2025-08-03)
+
+* Exporter:
+  * New: Added hearingImpaired for subtitles and visualImpaired for audio attributes to exporter fields.
+* Graphs:
+  * Fix: Remove duplicate "Total" entry in graph tooltips. (Thanks @zdimension) (#2534)
+* UI:
+  * Fix: Failing to retrieve collections / playlists with over 1000 items.
+  * Fix: Scrollbar not showing on macosx and webkit browsers. (#2221)
+  * Fix: Incorrect rounding of minutes in global stats play duration.
+  * Fix: Disable browser autocomplete for notification agent and newsletter agent configurations. (#2557)
+* API:
+  * New: Added ability to return svg files using pms_image_proxy API command.
+* Other:
+  * New: Added ability to set config values using environment variables. (Thanks @komuw) (#2309, #2543)
+
+
 ## v2.15.2 (2025-04-12)
 
 * Activity:
diff --git a/plexpy/version.py b/plexpy/version.py
index a2a92f99..31e6b18d 100644
--- a/plexpy/version.py
+++ b/plexpy/version.py
@@ -16,4 +16,4 @@
 #  along with Tautulli.  If not, see <http://www.gnu.org/licenses/>.
 
 PLEXPY_BRANCH = "master"
-PLEXPY_RELEASE_VERSION = "v2.15.2"
\ No newline at end of file
+PLEXPY_RELEASE_VERSION = "v2.15.3"
\ No newline at end of file